diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000000..1312090792
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,2 @@
+* text=auto
+*.sh text eol=lf
\ No newline at end of file
diff --git a/.github/ISSUE_TEMPLATE/a-general-issue.yml b/.github/ISSUE_TEMPLATE/a-general-issue.yml
new file mode 100644
index 0000000000..8f16dadda9
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/a-general-issue.yml
@@ -0,0 +1,13 @@
+name: "General feedback"
+description: Provide general feedback about the Entity Framework docs or a specific article.
+body:
+  - type: markdown
+    attributes:
+      value: "Describe the issue or suggestion. NOTE: If your issue is about a specific article, it's best to submit your feedback by clicking the 'Open a documentation issue' link in the 'EntityFramework feedback' box at the end of the article."
+  - type: input
+    id: topic
+    attributes:
+      label: Issue or suggestion
+      description: Describe the issue
+    validations:
+      required: true
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 0000000000..cb0bbd34d0
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,8 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Entity Framework product feedback
+    url: https://github.com/dotnet/efcore/issues
+    about: Log Entity Framework product feedback here
+  - name: learn.microsoft.com site feedback
+    url: https://github.com/MicrosoftDocs/feedback/issues/new/choose
+    about: Log general learn.microsoft.com site issues here
diff --git a/.github/ISSUE_TEMPLATE/z-customer-feedback.yml b/.github/ISSUE_TEMPLATE/z-customer-feedback.yml
new file mode 100644
index 0000000000..c54cdd6bca
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/z-customer-feedback.yml
@@ -0,0 +1,64 @@
+name: Learn feedback control.
+description: |
+  ⛔ This template is hooked into the feedback control on the bottom of every page on the live site. It automatically fills in several fields for you. Don't use for other purposes. ⛔
+body:
+  - type: markdown
+    attributes:
+      value: "## Issue information"
+  - type: markdown
+    attributes:
+      value: Select the issue type, and describe the issue in the text box below. Add as much detail as needed to help us resolve the issue.
+  - type: dropdown
+    id: issue-type
+    attributes:
+      label: Type of issue
+      options:
+        - Typo
+        - Code doesn't work
+        - Missing information
+        - Outdated article
+        - Other (describe below)
+    validations:
+      required: true
+  - type: textarea
+    id: feedback
+    validations:
+      required: true
+    attributes:
+      label: Description
+  - type: markdown
+    attributes:
+      value: "## 🚧 Article information 🚧"
+  - type: markdown
+    attributes:
+      value: "*Don't modify the following fields*. They are automatically filled in for you. Doing so will disconnect your issue from the affected article. *Don't edit them*."
+  - type: input
+    id: pageUrl
+    validations:
+      required: true
+    attributes:
+      label: Page URL
+  - type: input
+    id: contentSourceUrl
+    validations:
+      required: true
+    attributes:
+      label: Content source URL
+  - type: input
+    id: documentVersionIndependentId
+    validations:
+      required: true
+    attributes:
+      label: Document Version Independent Id
+  - type: input
+    id: platformId
+    validations:
+      required: true
+    attributes:
+      label: Platform Id
+  - type: input
+    id: author
+    validations:
+      required: true
+    attributes:
+      label: Article author
diff --git a/.github/agents/docs-generator.agent.md b/.github/agents/docs-generator.agent.md
new file mode 100644
index 0000000000..e1170eba9d
--- /dev/null
+++ b/.github/agents/docs-generator.agent.md
@@ -0,0 +1,36 @@
+---
+name: EF Documentation Generator
+description: This agent creates documentation PRs in the EF documentation site when new features are implemented in EF Core.
+disable-model-invocation: true
+---
+
+# Document new EF features
+
+Given an EF issue by the user, this custom agent generates documentation for features introduced in that issue and submits a PR to the EF docs repo (dotnet/EntityFramework.Docs).
+
+## Target branch
+
+* The EF repo has automation to automatically add a label indicating in which preview/rc the feature has been completed; the label is applied to the issue (not PR), and has the form `preview-3` or `rc-2` with the number adjusted.
+* The docs repo should have a corresponding branch, containing documentation to be published live when that preview/rc is published.
+* When the workflow is launched, check the issue, find the preview/rc label, and submit the PR against the corresponding branch in the doc repo (dotnet/EntityFramework.Docs).
+* If the label is missing, abort and post a comment to the triggering issue.
+
+## Writing the documentation
+
+* Fully read the conversation history of the issue, as well as any linked PRs or relevant issues linked from it, to gain good context on the feature, APIs introduced, etc.
+* Add documentation in the appropriate section of the docs, depending on what the feature is.
+* Fully document the feature, but keep it brief - do not add edge-case, non-important documentation in the name of exhaustivity that wouldn't be relevant to the majority of users.
+* Before the new documentation, add the following note (adjusting for the major version):
+
+```
+> [!NOTE]
+> This feature is being introduced in EF Core 11, which is currently in preview.
+```
+
+* Find the "what's new" page for the latest major release (typically `core/what-is-new/ef-core-11.0`, adjusting for the version), and add a **brief** section on the feature - just the minimum needed to make the user understand what it's about; include a minimal code sample as well if relevant. At the bottom, add a line such as "For more information on X, see the documentation" linking to the full docs added above, in case the user wants to dive deeper.
+* For both the full docs and the what's new documentation, do not simply create a new section; first check to see if there's an existing section that already covers related/similar functionality; if there is, either merge the new content into it or place the new section next to it.
+* If the issue adds a function translation, add the appropriate entry (or entries) in the provider's functions page. Do not add functions entries for LINQ operators (e.g. `Contains`).
+
+## Additional instructions
+
+* The commit in the resulting PR should have a title of the form "Document X", where X is the name of the feature as it appears in the title of the originating issue. If the title is too long for a git commit, make it shorter. The commit body should be of the form "Document Y", where Y is a link to the originating issue.
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
new file mode 100644
index 0000000000..75da7b3edd
--- /dev/null
+++ b/.github/copilot-instructions.md
@@ -0,0 +1,153 @@
+# Copilot Instructions for EntityFramework.Docs
+
+## Repository Overview
+
+This repository contains the **Entity Framework Core (EF Core) and Entity Framework 6 (EF6) documentation** published at <https://learn.microsoft.com/ef/>. It is a **documentation-focused repository** with markdown documentation files and C# code samples.
+
+**Key Technologies:**
+- **Documentation**: Markdown, DocFX, Microsoft Learn publishing platform
+- **Samples**: Latest public release of .NET, C#, Entity Framework Core/EF6, SQL Server, SQLite, Cosmos DB
+
+## Critical Build & Validation Instructions
+
+### Prerequisites
+- **.NET SDK** (latest public release) is required (check with `dotnet --version`)
+- **Node.js** for markdown linting (check with `node --version`)
+
+### Markdown Linting (ALWAYS RUN BEFORE COMMITTING)
+
+**Command:**
+```bash
+npm i -g markdownlint-cli
+markdownlint "**/*.md" -i "entity-framework/ef6/"
+```
+
+**Configuration:** `.markdownlint.json` at repo root
+**Key Rules:** MD046 (fenced code blocks), MD025 (single H1 with front matter)
+**CI Workflow:** `.github/workflows/markdownlint.yml` runs on all PRs with markdown changes
+**IMPORTANT:** EF6 documentation (`entity-framework/ef6/`) is excluded from linting
+
+### Building Code Samples
+
+**Location:** All samples are in `samples/` directory
+- `samples/core/` - EF Core samples
+- `samples/end2end/PlanetaryDocs/` - Complete end-to-end Blazor application
+
+Samples are standard .NET projects. Build them with:
+```bash
+cd samples/end2end/PlanetaryDocs
+dotnet build
+```
+
+Or build all core samples:
+```bash
+cd samples/core
+dotnet build
+```
+
+**CI Workflow:** `.github/workflows/build-samples.yml` runs on PRs to `live` branch with changes to `samples/`
+
+## Repository Structure
+
+### Documentation
+```
+entity-framework/
+├── docfx.json           # DocFX configuration
+├── core/                # EF Core documentation
+├── ef6/                 # EF6 documentation (excluded from markdownlint)
+├── efcore-and-ef6/      # Comparison and porting guides
+└── breadcrumb/          # Navigation breadcrumbs
+```
+
+### Configuration Files
+- `.markdownlint.json` - Markdown linting rules
+- `.openpublishing.publish.config.json` - Microsoft Learn publishing config
+- `.openpublishing.redirection.json` - URL redirections (update when renaming/moving files)
+- `.github/workflows/markdownlint.yml` - Markdown lint CI
+- `.github/workflows/build-samples.yml` - Sample build CI
+
+### Samples
+```
+samples/
+├── core/                # EF Core samples
+│   ├── Samples.sln      # Solution with all core samples
+│   └── .editorconfig    # Code style rules
+└── end2end/
+    └── PlanetaryDocs/   # Complete Blazor app
+```
+
+## Making Changes
+
+### Documentation Changes
+
+**File Format:** DocFX-flavored Markdown (DFM), superset of GitHub-flavored Markdown (GFM)
+**Style Guide:** <https://learn.microsoft.com/contribute/dotnet/dotnet-style-guide>
+
+**Code Snippet Syntax:**
+- Reference external code files (preferred): `[!code-csharp[Main](../../../samples/core/saving/Program.cs)]`
+- With C# region (always prefer over line ranges): `[!code-csharp[Main](../../../samples/core/saving/Program.cs?name=snippet_Example)]`
+- With highlighting: `[!code-csharp[Main](../../../samples/core/saving/Program.cs?highlight=1-3,10)]`
+
+**Static Content:** Images and files in `_static/` folders within each documentation area
+
+**ALWAYS:**
+1. Ensure code snippets reference actual sample files in `samples/` directory
+2. Run `markdownlint "**/*.md" -i "entity-framework/ef6/"` before committing
+3. Match folder structure: docs in `entity-framework/core/` align with samples in `samples/core/`
+4. When referencing an API, use docfx `<xref>` rather than code fencing to link to the API documentation
+5. When adding, removing or renaming pages, update the `entity-framework/toc.yml` file to make the changes appear in the doc site's table of contents
+6. If renaming or moving files, update `.openpublishing.redirection.json` to add redirects from old URLs
+
+### Sample Code Changes
+
+**ALWAYS:**
+1. Ensure samples build successfully: `cd samples/end2end/PlanetaryDocs && dotnet build`
+2. Follow existing code style (see `samples/core/.editorconfig`)
+3. Use C# regions (`#region snippet_Name`) for code referenced in documentation
+4. When editing samples, verify that documentation referencing those samples still uses correct line numbers for highlighting
+
+**Common Sample Patterns:**
+- Console applications showing specific EF Core features
+- Each sample folder typically has one `.csproj` file
+- Samples use in-memory SQLite or SQL Server LocalDB
+
+## Testing Documentation Locally with DocFX
+
+**DocFX** creates a locally hosted version of the documentation site (without Microsoft Learn styling).
+
+**Requirements:**
+- Windows: .NET Framework + DocFX tool
+- macOS/Linux: Mono + DocFX
+
+**Commands (not regularly used for PRs):**
+```bash
+# Download DocFX from https://github.com/dotnet/docfx/releases
+# Add to PATH, then from repo root:
+docfx entity-framework/docfx.json -t default --serve
+# View at http://localhost:8080
+```
+
+**Note:** DocFX is optional for most contributions. Focus on markdown linting and sample builds.
+
+## Common Pitfalls & Solutions
+
+**Problem:** `samples/core/Samples.sln` build fails with "Resource temporarily unavailable" NuGet errors
+**Solution:** This is a transient network issue with Azure DevOps preview package feeds. Retry the build. If persistent, build individual sample projects instead of the full solution.
+
+**Problem:** Markdownlint errors on legitimate markdown
+**Solution:** Check `.markdownlint.json` for disabled rules. Some rules (MD028, MD033, MD036, MD041) are intentionally disabled for documentation needs.
+
+**Problem:** Code snippet not rendering in documentation
+**Solution:** Verify the referenced file path is correct relative to the .md file location. Ensure C# region names match exactly (case-sensitive).
+
+**Problem:** Changes to EF6 docs trigger linting warnings
+**Solution:** EF6 docs (`entity-framework/ef6/`) are excluded from linting. This is intentional due to legacy content.
+
+## Trust These Instructions
+
+These instructions have been validated by running actual builds, tests, and linting on the repository. Only perform additional exploration if:
+- Information is incomplete or unclear
+- Instructions are found to be incorrect
+- You need details about a specific undocumented area
+
+For quick fixes (typos, grammar), simple markdown edits without building samples are acceptable.
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
new file mode 100644
index 0000000000..a1827c2b49
--- /dev/null
+++ b/.github/dependabot.yml
@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: nuget
+    directory: /
+    schedule:
+      interval: weekly
diff --git a/.github/workflows/build-samples.yml b/.github/workflows/build-samples.yml
new file mode 100644
index 0000000000..50bfd5fd7d
--- /dev/null
+++ b/.github/workflows/build-samples.yml
@@ -0,0 +1,37 @@
+name: Build Samples
+
+on:
+  push:
+    branches: [live]
+    paths:
+      - "samples/core/**"
+      - "samples/end2end/**"
+      - ".github/workflows/build-samples.yml"
+  pull_request:
+    branches: [live]
+    paths:
+      - "samples/core/**"
+      - "samples/end2end/**"
+      - ".github/workflows/build-samples.yml"
+
+jobs:
+  build:
+    runs-on: ubuntu-24.04
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup .NET 10.0 SDK
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: 10.0.x
+          include-prerelease: true
+
+      - name: Build samples
+        working-directory: samples/core
+        run: dotnet build
+
+      - name: Build planetary docs sample
+        working-directory: samples/end2end/PlanetaryDocs
+        run: dotnet build
diff --git a/.github/workflows/markdownlint-problem-matcher.json b/.github/workflows/markdownlint-problem-matcher.json
new file mode 100644
index 0000000000..f0741f6b90
--- /dev/null
+++ b/.github/workflows/markdownlint-problem-matcher.json
@@ -0,0 +1,17 @@
+{
+    "problemMatcher": [
+        {
+            "owner": "markdownlint",
+            "pattern": [
+                {
+                    "regexp": "^([^:]*):(\\d+):?(\\d+)?\\s([\\w-\\/]*)\\s(.*)$",
+                    "file": 1,
+                    "line": 2,
+                    "column": 3,
+                    "code": 4,
+                    "message": 5
+                }
+            ]
+        }
+    ]
+}
diff --git a/.github/workflows/markdownlint.yml b/.github/workflows/markdownlint.yml
new file mode 100644
index 0000000000..a09d3a0bf7
--- /dev/null
+++ b/.github/workflows/markdownlint.yml
@@ -0,0 +1,34 @@
+name: Markdownlint
+
+on:
+  push:
+    paths:
+      - "entity-framework/**/*.md"
+      - "!entity-framework/ef6/**"
+      - ".markdownlint.json"
+      - ".github/workflows/markdownlint.yml"
+      - ".github/workflows/markdownlint-problem-matcher.json"
+  pull_request:
+    paths:
+      - "**/*.md"
+      - "!entity-framework/ef6/**"
+      - ".markdownlint.json"
+      - ".github/workflows/markdownlint.yml"
+      - ".github/workflows/markdownlint-problem-matcher.json"
+
+jobs:
+  lint:
+    runs-on: ubuntu-24.04
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Use Node.js
+      uses: actions/setup-node@v1
+      with:
+        node-version: 20.x
+
+    - name: Run Markdownlint
+      run: |
+        echo "::add-matcher::.github/workflows/markdownlint-problem-matcher.json"
+        npm i -g markdownlint-cli
+        markdownlint "entity-framework/**/*.md" -i "entity-framework/ef6/"
diff --git a/.gitignore b/.gitignore
index ce4647f4d8..a9f1104c3e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,17 +1,25 @@
-docs/_build/
-
 ## Ignore Visual Studio temporary files, build results, and
 ## files generated by popular Visual Studio add-ons.
+##
+## Get latest from https://github.com/github/gitignore/blob/master/VisualStudio.gitignore
 
 # User-specific files
+*.rsuser
 *.suo
 *.user
 *.userosscache
 *.sln.docstates
 
+# SQLite databases
+*.sqlite
+*.db
+
 # User-specific files (MonoDevelop/Xamarin Studio)
 *.userprefs
 
+# Mono auto generated files
+mono_crash.*
+
 # Build results
 [Dd]ebug/
 [Dd]ebugPublic/
@@ -19,35 +27,63 @@ docs/_build/
 [Rr]eleases/
 x64/
 x86/
-build/
+[Ww][Ii][Nn]32/
+[Aa][Rr][Mm]/
+[Aa][Rr][Mm]64/
 bld/
 [Bb]in/
 [Oo]bj/
+[Oo]ut/
+[Ll]og/
+[Ll]ogs/
 
-# Visual Studo 2015 cache/options directory
+# Visual Studio 2015/2017 cache/options directory
 .vs/
+# Uncomment if you have tasks that create the project's static files in wwwroot
+#wwwroot/
+
+# Visual Studio 2017 auto generated files
+Generated\ Files/
 
 # MSTest test Results
 [Tt]est[Rr]esult*/
 [Bb]uild[Ll]og.*
 
-# NUNIT
+# NUnit
 *.VisualState.xml
 TestResult.xml
+nunit-*.xml
 
 # Build Results of an ATL Project
 [Dd]ebugPS/
 [Rr]eleasePS/
 dlldata.c
 
+# Benchmark Results
+BenchmarkDotNet.Artifacts/
+
+# .NET Core
+project.lock.json
+project.fragment.lock.json
+artifacts/
+
+# ASP.NET Scaffolding
+ScaffoldingReadMe.txt
+
+# StyleCop
+StyleCopReport.xml
+
+# Files built by Visual Studio
 *_i.c
 *_p.c
-*_i.h
+*_h.h
 *.ilk
 *.meta
 *.obj
+*.iobj
 *.pch
 *.pdb
+*.ipdb
 *.pgc
 *.pgd
 *.rsp
@@ -57,6 +93,7 @@ dlldata.c
 *.tlh
 *.tmp
 *.tmp_proj
+*_wpftmp.csproj
 *.log
 *.vspscc
 *.vssscc
@@ -72,14 +109,21 @@ _Chutzpah*
 ipch/
 *.aps
 *.ncb
+*.opendb
 *.opensdf
 *.sdf
 *.cachefile
+*.VC.db
+*.VC.VC.opendb
 
 # Visual Studio profiler
 *.psess
 *.vsp
 *.vspx
+*.sap
+
+# Visual Studio Trace Files
+*.e2e
 
 # TFS 2012 Local Workspace
 $tf/
@@ -92,18 +136,29 @@ _ReSharper*/
 *.[Rr]e[Ss]harper
 *.DotSettings.user
 
-# JustCode is a .NET coding addin-in
-.JustCode
-
 # TeamCity is a build add-in
 _TeamCity*
 
 # DotCover is a Code Coverage Tool
 *.dotCover
 
+# AxoCover is a Code Coverage Tool
+.axoCover/*
+!.axoCover/settings.json
+
+# Coverlet is a free, cross platform Code Coverage Tool
+coverage*.json
+coverage*.xml
+coverage*.info
+
+# Visual Studio code coverage results
+*.coverage
+*.coveragexml
+
 # NCrunch
 _NCrunch_*
 .*crunch*.local.xml
+nCrunchTemp_*
 
 # MightyMoose
 *.mm.*
@@ -131,39 +186,71 @@ publish/
 # Publish Web Output
 *.[Pp]ublish.xml
 *.azurePubxml
-# TODO: Comment the next line if you want to checkin your web deploy settings 
+# Note: Comment the next line if you want to checkin your web deploy settings,
 # but database connection strings (with potential passwords) will be unencrypted
 *.pubxml
 *.publishproj
 
+# Microsoft Azure Web App publish settings. Comment the next line if you want to
+# checkin your Azure Web App publish settings, but sensitive information contained
+# in these scripts will be unencrypted
+PublishScripts/
+
 # NuGet Packages
 *.nupkg
+# NuGet Symbol Packages
+*.snupkg
 # The packages folder can be ignored because of Package Restore
-**/packages/*
+**/[Pp]ackages/*
 # except build/, which is used as an MSBuild target.
-!**/packages/build/
+!**/[Pp]ackages/build/
 # Uncomment if necessary however generally it will be regenerated when needed
-#!**/packages/repositories.config
+#!**/[Pp]ackages/repositories.config
+# NuGet v3's project.json files produces more ignorable files
+*.nuget.props
+*.nuget.targets
 
-# Windows Azure Build Output
+# Microsoft Azure Build Output
 csx/
 *.build.csdef
 
-# Windows Store app package directory
+# Microsoft Azure Emulator
+ecf/
+rcf/
+
+# Windows Store app package directories and files
 AppPackages/
+BundleArtifacts/
+Package.StoreAssociation.xml
+_pkginfo.txt
+*.appx
+*.appxbundle
+*.appxupload
+
+# Visual Studio cache files
+# files ending in .cache can be ignored
+*.[Cc]ache
+# but keep track of directories ending in .cache
+!?*.[Cc]ache/
 
 # Others
-*.[Cc]ache
 ClientBin/
-[Ss]tyle[Cc]op.*
 ~$*
 *~
 *.dbmdl
 *.dbproj.schemaview
+*.jfm
 *.pfx
 *.publishsettings
-node_modules/
-bower_components/
+orleans.codegen.cs
+
+# Including strong name files can present a security risk
+# (https://github.com/github/gitignore/pull/2483#issue-259490424)
+#*.snk
+
+# Since there are multiple workflows, uncomment next line to ignore bower_components
+# (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)
+#bower_components/
 
 # RIA/Silverlight projects
 Generated_Code/
@@ -175,21 +262,32 @@ _UpgradeReport_Files/
 Backup*/
 UpgradeLog*.XML
 UpgradeLog*.htm
+ServiceFabricBackup/
+*.rptproj.bak
 
 # SQL Server files
 *.mdf
 *.ldf
+*.ndf
 
 # Business Intelligence projects
 *.rdl.data
 *.bim.layout
 *.bim_*.settings
+*.rptproj.rsuser
+*- [Bb]ackup.rdl
+*- [Bb]ackup ([0-9]).rdl
+*- [Bb]ackup ([0-9][0-9]).rdl
 
 # Microsoft Fakes
 FakesAssemblies/
 
+# GhostDoc plugin setting file
+*.GhostDoc.xml
+
 # Node.js Tools for Visual Studio
 .ntvs_analysis.dat
+node_modules/
 
 # Visual Studio 6 build log
 *.plg
@@ -197,8 +295,78 @@ FakesAssemblies/
 # Visual Studio 6 workspace options file
 *.opt
 
-samples/MigratingFromMvc5/NewMvc6Project/src/NewMvc6Project/wwwroot/lib/
-samples/AngularSample/src/AngularSample/wwwroot/lib
-project.lock.json
-samples/WebApplication1/src/WebApplication1/wwwroot/lib/
-**/sample/**/wwwroot/lib/
+# Visual Studio 6 auto-generated workspace file (contains which files were open etc.)
+*.vbw
+
+# Visual Studio LightSwitch build output
+**/*.HTMLClient/GeneratedArtifacts
+**/*.DesktopClient/GeneratedArtifacts
+**/*.DesktopClient/ModelManifest.xml
+**/*.Server/GeneratedArtifacts
+**/*.Server/ModelManifest.xml
+_Pvt_Extensions
+
+# Paket dependency manager
+.paket/paket.exe
+paket-files/
+
+# FAKE - F# Make
+.fake/
+
+# CodeRush personal settings
+.cr/personal
+
+# Python Tools for Visual Studio (PTVS)
+__pycache__/
+*.pyc
+
+# Cake - Uncomment if you are using it
+# tools/**
+# !tools/packages.config
+
+# Tabs Studio
+*.tss
+
+# Telerik's JustMock configuration file
+*.jmconfig
+
+# BizTalk build output
+*.btp.cs
+*.btm.cs
+*.odx.cs
+*.xsd.cs
+
+# OpenCover UI analysis results
+OpenCover/
+
+# Azure Stream Analytics local run output
+ASALocalRun/
+
+# MSBuild Binary and Structured Log
+*.binlog
+
+# NVidia Nsight GPU debugger configuration file
+*.nvuser
+
+# MFractors (Xamarin productivity tool) working folder
+.mfractor/
+
+# Local History for Visual Studio
+.localhistory/
+
+# BeatPulse healthcheck temp database
+healthchecksdb
+
+# Backup folder for Package Reference Convert tool in Visual Studio 2017
+MigrationBackup/
+
+# Ionide (cross platform F# VS Code tools) working folder
+.ionide/
+
+# Fody - auto-generated XML schema
+FodyWeavers.xsd
+
+# Rider
+.idea/
+
+.DS_Store
\ No newline at end of file
diff --git a/.markdownlint.json b/.markdownlint.json
new file mode 100644
index 0000000000..680c31e768
--- /dev/null
+++ b/.markdownlint.json
@@ -0,0 +1,20 @@
+{
+    "default": true,
+    "MD002": false,
+    "MD013": false,
+    "MD024": false,
+    "MD025": { "front_matter_title": "" },
+    "MD028": false,
+    "MD033": false,
+    "MD036": false,
+    "MD041": false,
+    "MD046": {
+        "style": "fenced"
+    },
+    "MD051": false,
+    "MD055": false,
+    "MD056": false,
+    "MD059": false,
+    "MD060": false,
+    "DOCSMD010": false
+}
diff --git a/.openpublishing.publish.config.json b/.openpublishing.publish.config.json
new file mode 100644
index 0000000000..32b57e9f0f
--- /dev/null
+++ b/.openpublishing.publish.config.json
@@ -0,0 +1,66 @@
+{
+  "build_entry_point": "docs",
+  "docsets_to_publish": [
+    {
+      "docset_name": "ef",
+      "build_source_folder": "entity-framework",
+      "build_output_subfolder": "ef",
+      "locale": "en-us",
+      "xref_query_tags": [
+        "/dotnet",
+        "/ef",
+        "/aspnet"
+      ],
+      "open_to_public_contributors": true,
+      "type_mapping": {
+        "Conceptual": "Content",
+        "ManagedReference": "Content",
+        "RestApi": "Content"
+      },
+      "template_folder": "_themes",
+      "version": 0
+    }
+  ],
+  "notification_subscribers": [
+    "efdatateam@microsoft.com"
+  ],
+  "sync_notification_subscribers": [],
+  "branches_to_filter": [],
+  "git_repository_branch_open_to_public_contributors": "main",
+  "need_preview_pull_request": true,
+  "need_pr_comments": false,
+  "dependent_repositories": [
+    {
+      "path_to_root": "_themes",
+      "url": "https://github.com/Microsoft/templates.docs.msft",
+      "branch": "main",
+      "branch_mapping": {}
+    },
+    {
+      "path_to_root": "_themes.pdf",
+      "url": "https://github.com/Microsoft/templates.docs.msft.pdf",
+      "branch": "main",
+      "branch_mapping": {}
+    }
+  ],
+  "branch_target_mapping": {
+    "live": [
+      "Publish",
+      "Pdf"
+    ],
+    "main": [
+      "Publish",
+      "Pdf"
+    ]
+  },
+  "targets": {
+    "Pdf": {
+      "template_folder": "_themes.pdf"
+    }
+  },
+  "docs_build_engine": {},
+  "skip_source_output_uploading": false,
+  "need_generate_pdf_url_template": true,
+  "contribution_branch_mappings": {},
+  "need_generate_intellisense": false
+}
\ No newline at end of file
diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json
new file mode 100644
index 0000000000..175082dbbf
--- /dev/null
+++ b/.openpublishing.redirection.json
@@ -0,0 +1,499 @@
+{
+    "redirections": [
+        {
+            "source_path": "entity-framework/efcore-and-ef6/choosing.md",
+            "redirect_url": "/ef/efcore-and-ef6/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/efcore-and-ef6/features.md",
+            "redirect_url": "/ef/efcore-and-ef6/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/providers/devart/index.md",
+            "redirect_url": "/ef/core/providers/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/providers/firebird-community/index.md",
+            "redirect_url": "/ef/core/providers/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/providers/ibm/index.md",
+            "redirect_url": "/ef/core/providers/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/providers/my-cat/index.md",
+            "redirect_url": "/ef/core/providers/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/providers/mysql/index.md",
+            "redirect_url": "/ef/core/providers/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/providers/npgsql/index.md",
+            "redirect_url": "/ef/core/providers/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/providers/oracle/index.md",
+            "redirect_url": "/ef/core/providers/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/providers/pomelo/index.md",
+            "redirect_url": "/ef/core/providers/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/providers/sql-compact/index.md",
+            "redirect_url": "/ef/core/providers/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/extensions/neinlinq.md",
+            "redirect_url": "/ef/core/extensions/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/extensions/unitofwork.md",
+            "redirect_url": "/ef/core/extensions/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/extensions/dynamiclinq.md",
+            "redirect_url": "/ef/core/extensions/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/extensions/autohistory.md",
+            "redirect_url": "/ef/core/extensions/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/extensions/linqkit.md",
+            "redirect_url": "/ef/core/extensions/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/extensions/efcore-practices.md",
+            "redirect_url": "/ef/core/extensions/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/extensions/entityframeworkcore-typedoriginalvalues.md",
+            "redirect_url": "/ef/core/extensions/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/extensions/entityframeworkcore-primarykey.md",
+            "redirect_url": "/ef/core/extensions/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/extensions/entityframeworkcore-rx.md",
+            "redirect_url": "/ef/core/extensions/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/extensions/entityframeworkcore-triggers.md",
+            "redirect_url": "/ef/core/extensions/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/extensions/entityframeworkcore-detached.md",
+            "redirect_url": "/ef/core/extensions/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/extensions/geco.md",
+            "redirect_url": "/ef/core/extensions/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/extensions/efsecondlevelcache-core.md",
+            "redirect_url": "/ef/core/extensions/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/extensions/devart-entity-developer.md.md",
+            "redirect_url": "/ef/core/extensions/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/extensions/llbl-gen-pro.md",
+            "redirect_url": "/ef/core/extensions/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/modeling/query-types.md",
+            "redirect_url": "/ef/core/modeling/keyless-entity-types",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/ef6/what-is-new/roadmap.md",
+            "redirect_url": "/ef/ef6/what-is-new/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/get-started/aspnetcore/existing-db.md",
+            "redirect_url": "/aspnet/core/data/ef-rp/intro",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/get-started/aspnetcore/index.md",
+            "redirect_url": "/aspnet/core/data/ef-rp/intro",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/get-started/aspnetcore/new-db.md",
+            "redirect_url": "/aspnet/core/data/ef-rp/intro",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/get-started/full-dotnet/existing-db.md",
+            "redirect_url": "/ef/core/get-started/overview/first-app",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/get-started/full-dotnet/index.md",
+            "redirect_url": "/ef/core/get-started/overview/first-app",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/get-started/full-dotnet/new-db.md",
+            "redirect_url": "/ef/core/get-started/overview/first-app",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/get-started/netcore/index.md",
+            "redirect_url": "/ef/core/get-started/overview/first-app",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/get-started/netcore/new-db-sqlite.md",
+            "redirect_url": "/ef/core/get-started/overview/first-app",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/get-started/uwp/getting-started.md",
+            "redirect_url": "/ef/core/get-started/overview/first-app",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/get-started/uwp/index.md",
+            "redirect_url": "/ef/core/get-started/overview/first-app",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/get-started/xamarin.md",
+            "redirect_url": "/previous-versions/xamarin/xamarin-forms/data-cloud/data/entity-framework",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/what-is-new/roadmap.md",
+            "redirect_url": "/ef/core/what-is-new/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/what-is-new/ef-core-3.0/features.md",
+            "redirect_url": "/ef/core/what-is-new/ef-core-3.0/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/ef6/fundamentals/index.md",
+            "redirect_url": "/ef/ef6/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/ef6/resources/index.md",
+            "redirect_url": "/ef/ef6/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/efcore-and-ef6/porting/ensure-requirements.md",
+            "redirect_url": "/ef/efcore-and-ef6/porting/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/querying/basic.md",
+            "redirect_url": "/ef/core/querying/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/querying/overview.md",
+            "redirect_url": "/ef/core/querying/how-query-works",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/modeling/included-types.md",
+            "redirect_url": "/ef/core/modeling/entity-types",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/modeling/relational/tables.md",
+            "redirect_url": "/ef/core/modeling/entity-types",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/modeling/relational/default-schema.md",
+            "redirect_url": "/ef/core/modeling/entity-types#table-schema",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/modeling/included-properties.md",
+            "redirect_url": "/ef/core/modeling/entity-properties",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/modeling/max-length.md",
+            "redirect_url": "/ef/core/modeling/entity-properties#maximum-length",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/modeling/required-optional.md",
+            "redirect_url": "/ef/core/modeling/entity-properties#required-and-optional-properties",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/modeling/relational/columns.md",
+            "redirect_url": "/ef/core/modeling/entity-properties#column-names",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/modeling/relational/data-types.md",
+            "redirect_url": "/ef/core/modeling/entity-properties#column-data-types",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/modeling/alternate-keys.md",
+            "redirect_url": "/ef/core/modeling/keys#alternate-keys",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/modeling/relational/primary-keys.md",
+            "redirect_url": "/ef/core/modeling/keys",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/modeling/relational/indexes.md",
+            "redirect_url": "/ef/core/modeling/indexes",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/modeling/relational/fk-constraints.md",
+            "redirect_url": "/ef/core/modeling/relationships#foreign-key-constraint-name",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/modeling/relational/unique-constraints.md",
+            "redirect_url": "/ef/core/modeling/keys",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/modeling/relational/sequences.md",
+            "redirect_url": "/ef/core/modeling/sequences",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/modeling/relational/default-values.md",
+            "redirect_url": "/ef/core/modeling/generated-properties#default-values",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/modeling/relational/computed-columns.md",
+            "redirect_url": "/ef/core/modeling/generated-properties#computed-columns",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/modeling/relational/inheritance.md",
+            "redirect_url": "/ef/core/modeling/inheritance",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/querying/async.md",
+            "redirect_url": "/ef/core/miscellaneous/async",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/saving/async.md",
+            "redirect_url": "/ef/core/miscellaneous/async",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/modeling/relational/index.md",
+            "redirect_url": "/ef/core/modeling/",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/what-is-new/ef-core-3.0/index.md",
+            "redirect_url": "/ef/core/what-is-new/ef-core-3.x",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/what-is-new/ef-core-3.0/breaking-changes.md",
+            "redirect_url": "/ef/core/what-is-new/ef-core-3.x/breaking-changes",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/miscellaneous/1x-2x-upgrade.md",
+            "redirect_url": "/ef/core/what-is-new/ef-core-2.0/upgrade",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/miscellaneous/rc1-rc2-upgrade.md",
+            "redirect_url": "/ef/core/what-is-new",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/miscellaneous/rc2-rtm-upgrade.md",
+            "redirect_url": "/ef/core/what-is-new",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/miscellaneous/cli/dbcontext-creation.md",
+            "redirect_url": "/ef/core/cli/dbcontext-creation",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/miscellaneous/cli/dotnet.md",
+            "redirect_url": "/ef/core/cli/dotnet",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/miscellaneous/cli/index.md",
+            "redirect_url": "/ef/core/cli/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/miscellaneous/cli/powershell.md",
+            "redirect_url": "/ef/core/cli/powershell",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/miscellaneous/cli/services.md",
+            "redirect_url": "/ef/core/cli/services",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/get-started/index.md",
+            "redirect_url": "/ef/core/get-started/overview/first-app",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/miscellaneous/events/index.md",
+            "redirect_url": "/ef/core/logging-events-diagnostics/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/miscellaneous/logging.md",
+            "redirect_url": "/ef/core/logging-events-diagnostics/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/miscellaneous/events/simple-logging.md",
+            "redirect_url": "/ef/core/logging-events-diagnostics/simple-logging",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/platforms/index.md",
+            "redirect_url": "/ef/core/miscellaneous/platforms",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/miscellaneous/testing/in-memory.md",
+            "redirect_url": "/ef/core/testing/in-memory",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/miscellaneous/testing/index.md",
+            "redirect_url": "/ef/core/testing/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/miscellaneous/testing/sharing-databases.md",
+            "redirect_url": "/ef/core/testing/sharing-databases",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/miscellaneous/testing/sqlite.md",
+            "redirect_url": "/ef/core/testing/sqlite",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/miscellaneous/testing/testing-sample.md",
+            "redirect_url": "/ef/core/testing/testing-sample",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/miscellaneous/configuring-dbcontext.md",
+            "redirect_url": "/ef/core/dbcontext-configuration/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/miscellaneous/context-pooling.md",
+            "redirect_url": "/ef/core/performance/advanced-performance-topics#dbcontext-pooling",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/saving/explicit-values-generated-properties.md",
+            "redirect_url": "/ef/core/modeling/generated-properties#overriding-values",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/testing/testing-sample.md",
+            "redirect_url": "/ef/core/testing/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/testing/sharing-databases.md",
+            "redirect_url": "/ef/core/testing/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/testing/sqlite.md",
+            "redirect_url": "/ef/core/testing/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/testing/in-memory.md",
+            "redirect_url": "/ef/core/testing/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/managing-schemas/scaffolding.md",
+            "redirect_url": "/ef/core/managing-schemas/scaffolding/index",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/querying/raw-sql.md",
+            "redirect_url": "/ef/core/querying/sql-queries",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/modeling/concurrency.md",
+            "redirect_url": "/ef/core/saving/concurrency",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/logging-events-diagnostics/event-counters.md",
+            "redirect_url": "/ef/core/logging-events-diagnostics/metrics",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/providers/cosmos/functions.md",
+            "redirect_url": "/ef/core/providers/cosmos/querying",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "entity-framework/core/providers/sql-server/azure-sql-database.md",
+            "redirect_url": "/ef/core/providers/sql-server/misc",
+            "redirect_document_id": false
+        }        
+    ]
+}
diff --git a/.vscode/extensions.json b/.vscode/extensions.json
new file mode 100644
index 0000000000..809e4c4a40
--- /dev/null
+++ b/.vscode/extensions.json
@@ -0,0 +1,5 @@
+{
+	"recommendations": [
+		"docsmsft.docs-authoring-pack"
+	]
+}
diff --git a/.vscode/settings.json b/.vscode/settings.json
new file mode 100644
index 0000000000..e582f44ff1
--- /dev/null
+++ b/.vscode/settings.json
@@ -0,0 +1,40 @@
+{
+    "markdown.docsetLanguages": [
+        ".NET Core CLI",
+        "C#",
+        "JSON",
+        "PowerShell",
+        "SQL",
+        "VB.NET",
+        "XAML",
+        "XML"
+    ],
+    "cSpell.words": [
+        "dbcontext",
+        "denormalization",
+        "idempotency",
+        "LINQ",
+        "mitigations",
+        "navigations",
+        "overridable",
+        "parameterizable",
+        "parameterless",
+        "pluralizer",
+        "queryable",
+        "requiredness",
+        "resultset",
+        "resultsets",
+        "roundtrips",
+        "savepoint",
+        "savepoints",
+        "serializable",
+        "subquery",
+        "walkthrough"
+    ],
+    "markdownlint.config": {
+        "MD028": false,
+        "MD025": {
+            "front_matter_title": ""
+        }
+    }
+}
diff --git a/CODE-OF-CONDUCT.md b/CODE-OF-CONDUCT.md
new file mode 100644
index 0000000000..775f221c98
--- /dev/null
+++ b/CODE-OF-CONDUCT.md
@@ -0,0 +1,6 @@
+# Code of Conduct
+
+This project has adopted the code of conduct defined by the Contributor Covenant
+to clarify expected behavior in our community.
+
+For more information, see the [.NET Foundation Code of Conduct](https://dotnetfoundation.org/code-of-conduct).
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 4dc541abe9..adb47345e7 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,11 +1,99 @@
-Contributing
-============
+# Contributing to the Entity Framework documentation
 
-Information on contributing to this repo is in the [Contributing Guide](https://github.com/aspnet/Home/blob/dev/CONTRIBUTING.md) in the Home repo.
+The process of contributing articles and code samples to the Entity Framework documentation is explained below. Contributions can be as simple as typo corrections or as complex as new articles.
 
-The documentation is built using [Sphinx](http://sphinx-doc.org) and [reStructuredText](http://sphinx-doc.org/rest.html), and then hosted by [ReadTheDocs](http://aspnet.readthedocs.org).
+## How to make a simple correction or suggestion
 
-This project shares the same process as the ASP.NET 5 project for building and contrbituing documentation. Please review the following resources from the ASP.NET 5 project:
+Articles are stored as Markdown files in this repository. To make a simple change to the content of a Markdown file, click the **Edit** link in the upper right corner of the browser window. You might need to expand the **options** bar to see the **Edit** link. Follow the directions to create a pull request (PR). The EF team will review the PR and accept it or suggest changes.
 
-* [Building and contributing documentation](https://github.com/aspnet/Docs/blob/master/CONTRIBUTING.md)
-* [Style guide](http://docs.asp.net/en/latest/contribute/style-guide.html)
+## How to make a more complex submission
+
+You'll need a basic understanding of [Git and GitHub.com](https://guides.github.com/activities/hello-world/).
+
+* Open an [issue](https://github.com/dotnet/EntityFramework.Docs/issues/new) describing what you want to do, such as change an existing article or create a new one. Wait for approval from the EF team before you invest much time.
+* Fork the [dotnet/EntityFramework.Docs](https://github.com/dotnet/EntityFramework.Docs/) repo and create a branch for your changes.
+* Submit a pull request (PR) to main with your changes.
+* Respond to PR feedback.
+
+## Markdown syntax
+
+Articles are written in [DocFx-flavored Markdown (DFM)](http://dotnet.github.io/docfx/spec/docfx_flavored_markdown.html), a superset of [GitHub-flavored Markdown (GFM)](https://guides.github.com/features/mastering-markdown/). For examples of DFM syntax and metadata for UI features commonly used in the EF documentation, see [Metadata and Markdown Template](https://learn.microsoft.com/contribute/dotnet/dotnet-style-guide).
+
+## Folder structure conventions
+
+Images and other static content are stored in an `_static` folder within each area/folder of the site.
+
+Code samples are stored in the `samples` root folder. They are organized into a folder structure that mimics the documentation structure (found under the `entity-framework` root folder).
+
+## Code snippets
+
+Articles frequently contain code snippets to illustrate points. DFM lets you copy code into the Markdown file or refer to a separate code file. Whenever possible, use separate code files to minimize the chance of errors in the code. The code files should be stored in the repo using the folder structure described above for sample projects.
+
+Here are some examples of [DFM code snippet syntax](http://dotnet.github.io/docfx/spec/docfx_flavored_markdown.html#code-snippet).
+
+To render an entire code file as a snippet:
+
+```none
+[!code-csharp[Main](../../../samples/core/saving/Program.cs)]
+```
+
+To render a portion of a file as a snippet by using line numbers:
+
+```none
+[!code-csharp[Main](../../../samples/core/saving/Program.cs?range=1-10]
+```
+
+For C# snippets, you can reference a [C# region](https://msdn.microsoft.com/library/9a1ybwek.aspx). Use regions rather than line numbers. Line numbers in a code file tend to change and get out of sync with line number references in Markdown. C# regions can be nested. If you reference the outer region, the inner `#region` and `#endregion` directives are not rendered in a snippet.
+
+To render a C# region named "snippet_Example":
+
+```none
+[!code-csharp[Main](../../../samples/core/saving/Program.cs?name=snippet_Example)]
+```
+
+To highlight selected lines in a rendered snippet (usually renders as yellow background color):
+
+```none
+[!code-csharp[Main](../../../samples/core/saving/Program.cs?name=snippet_Example&highlight=1-3,10,20-25)]
+```
+
+## Test your changes with DocFX
+
+Test your changes with the [DocFX command-line tool](https://dotnet.github.io/docfx/tutorial/docfx_getting_started.html#2-use-docfx-as-a-command-line-tool), which creates a locally hosted version of the site. DocFX doesn't render style and site extensions created for Microsoft Learn.
+
+DocFX requires the .NET Framework on Windows, or Mono for Linux or macOS.
+
+### Windows instructions
+
+* Download and unzip *docfx.zip* from [DocFX releases](https://github.com/dotnet/docfx/releases).
+* Add DocFX to your PATH.
+* In a command-line window, navigate to the cloned repository (which contains the *docfx.json* file) and run the following command:
+
+   ```console
+   docfx -t default --serve
+   ```
+
+* In a browser, navigate to `http://localhost:8080`.
+
+### Mono instructions
+
+* Install Mono via Homebrew - `brew install mono`.
+* Download the [latest version of DocFX](https://github.com/dotnet/docfx/releases/tag/v2.7.2).
+* Extract to `\bin\docfx`.
+* Create an alias for **docfx**:
+
+  ```console
+  function docfx {
+    mono $HOME/bin/docfx/docfx.exe
+  }
+
+  function docfx-serve {
+    mono $HOME/bin/docfx/docfx.exe serve _site
+  }
+  ```
+
+* Run **docfx** in the cloned repository to build the site, and **docfx-serve** to view the site at `http://localhost:8080`.
+
+## Voice and tone
+
+Our goal is to write documentation that is easily understandable by the widest possible audience. To that end we have established guidelines for writing style that we ask our contributors to follow. For more information, see [Voice and tone guidelines](https://learn.microsoft.com/contribute/dotnet/dotnet-voice-tone).
diff --git a/LICENSE b/LICENSE
index 0bdc1962b6..a2c95fc155 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,12 +1,395 @@
-Copyright (c) .NET Foundation. All rights reserved.
+Attribution 4.0 International
 
-Licensed under the Apache License, Version 2.0 (the "License"); you may not use
-these files except in compliance with the License. You may obtain a copy of the
-License at
+=======================================================================
 
-http://www.apache.org/licenses/LICENSE-2.0
+Creative Commons Corporation ("Creative Commons") is not a law firm and
+does not provide legal services or legal advice. Distribution of
+Creative Commons public licenses does not create a lawyer-client or
+other relationship. Creative Commons makes its licenses and related
+information available on an "as-is" basis. Creative Commons gives no
+warranties regarding its licenses, any material licensed under their
+terms and conditions, or any related information. Creative Commons
+disclaims all liability for damages resulting from their use to the
+fullest extent possible.
 
-Unless required by applicable law or agreed to in writing, software distributed
-under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
-CONDITIONS OF ANY KIND, either express or implied. See the License for the
-specific language governing permissions and limitations under the License.
+Using Creative Commons Public Licenses
+
+Creative Commons public licenses provide a standard set of terms and
+conditions that creators and other rights holders may use to share
+original works of authorship and other material subject to copyright
+and certain other rights specified in the public license below. The
+following considerations are for informational purposes only, are not
+exhaustive, and do not form part of our licenses.
+
+     Considerations for licensors: Our public licenses are
+     intended for use by those authorized to give the public
+     permission to use material in ways otherwise restricted by
+     copyright and certain other rights. Our licenses are
+     irrevocable. Licensors should read and understand the terms
+     and conditions of the license they choose before applying it.
+     Licensors should also secure all rights necessary before
+     applying our licenses so that the public can reuse the
+     material as expected. Licensors should clearly mark any
+     material not subject to the license. This includes other CC-
+     licensed material, or material used under an exception or
+     limitation to copyright. More considerations for licensors:
+	wiki.creativecommons.org/Considerations_for_licensors
+
+     Considerations for the public: By using one of our public
+     licenses, a licensor grants the public permission to use the
+     licensed material under specified terms and conditions. If
+     the licensor's permission is not necessary for any reason--for
+     example, because of any applicable exception or limitation to
+     copyright--then that use is not regulated by the license. Our
+     licenses grant only permissions under copyright and certain
+     other rights that a licensor has authority to grant. Use of
+     the licensed material may still be restricted for other
+     reasons, including because others have copyright or other
+     rights in the material. A licensor may make special requests,
+     such as asking that all changes be marked or described.
+     Although not required by our licenses, you are encouraged to
+     respect those requests where reasonable. More_considerations
+     for the public: 
+	wiki.creativecommons.org/Considerations_for_licensees
+
+=======================================================================
+
+Creative Commons Attribution 4.0 International Public License
+
+By exercising the Licensed Rights (defined below), You accept and agree
+to be bound by the terms and conditions of this Creative Commons
+Attribution 4.0 International Public License ("Public License"). To the
+extent this Public License may be interpreted as a contract, You are
+granted the Licensed Rights in consideration of Your acceptance of
+these terms and conditions, and the Licensor grants You such rights in
+consideration of benefits the Licensor receives from making the
+Licensed Material available under these terms and conditions.
+
+
+Section 1 -- Definitions.
+
+  a. Adapted Material means material subject to Copyright and Similar
+     Rights that is derived from or based upon the Licensed Material
+     and in which the Licensed Material is translated, altered,
+     arranged, transformed, or otherwise modified in a manner requiring
+     permission under the Copyright and Similar Rights held by the
+     Licensor. For purposes of this Public License, where the Licensed
+     Material is a musical work, performance, or sound recording,
+     Adapted Material is always produced where the Licensed Material is
+     synched in timed relation with a moving image.
+
+  b. Adapter's License means the license You apply to Your Copyright
+     and Similar Rights in Your contributions to Adapted Material in
+     accordance with the terms and conditions of this Public License.
+
+  c. Copyright and Similar Rights means copyright and/or similar rights
+     closely related to copyright including, without limitation,
+     performance, broadcast, sound recording, and Sui Generis Database
+     Rights, without regard to how the rights are labeled or
+     categorized. For purposes of this Public License, the rights
+     specified in Section 2(b)(1)-(2) are not Copyright and Similar
+     Rights.
+
+  d. Effective Technological Measures means those measures that, in the
+     absence of proper authority, may not be circumvented under laws
+     fulfilling obligations under Article 11 of the WIPO Copyright
+     Treaty adopted on December 20, 1996, and/or similar international
+     agreements.
+
+  e. Exceptions and Limitations means fair use, fair dealing, and/or
+     any other exception or limitation to Copyright and Similar Rights
+     that applies to Your use of the Licensed Material.
+
+  f. Licensed Material means the artistic or literary work, database,
+     or other material to which the Licensor applied this Public
+     License.
+
+  g. Licensed Rights means the rights granted to You subject to the
+     terms and conditions of this Public License, which are limited to
+     all Copyright and Similar Rights that apply to Your use of the
+     Licensed Material and that the Licensor has authority to license.
+
+  h. Licensor means the individual(s) or entity(ies) granting rights
+     under this Public License.
+
+  i. Share means to provide material to the public by any means or
+     process that requires permission under the Licensed Rights, such
+     as reproduction, public display, public performance, distribution,
+     dissemination, communication, or importation, and to make material
+     available to the public including in ways that members of the
+     public may access the material from a place and at a time
+     individually chosen by them.
+
+  j. Sui Generis Database Rights means rights other than copyright
+     resulting from Directive 96/9/EC of the European Parliament and of
+     the Council of 11 March 1996 on the legal protection of databases,
+     as amended and/or succeeded, as well as other essentially
+     equivalent rights anywhere in the world.
+
+  k. You means the individual or entity exercising the Licensed Rights
+     under this Public License. Your has a corresponding meaning.
+
+
+Section 2 -- Scope.
+
+  a. License grant.
+
+       1. Subject to the terms and conditions of this Public License,
+          the Licensor hereby grants You a worldwide, royalty-free,
+          non-sublicensable, non-exclusive, irrevocable license to
+          exercise the Licensed Rights in the Licensed Material to:
+
+            a. reproduce and Share the Licensed Material, in whole or
+               in part; and
+
+            b. produce, reproduce, and Share Adapted Material.
+
+       2. Exceptions and Limitations. For the avoidance of doubt, where
+          Exceptions and Limitations apply to Your use, this Public
+          License does not apply, and You do not need to comply with
+          its terms and conditions.
+
+       3. Term. The term of this Public License is specified in Section
+          6(a).
+
+       4. Media and formats; technical modifications allowed. The
+          Licensor authorizes You to exercise the Licensed Rights in
+          all media and formats whether now known or hereafter created,
+          and to make technical modifications necessary to do so. The
+          Licensor waives and/or agrees not to assert any right or
+          authority to forbid You from making technical modifications
+          necessary to exercise the Licensed Rights, including
+          technical modifications necessary to circumvent Effective
+          Technological Measures. For purposes of this Public License,
+          simply making modifications authorized by this Section 2(a)
+          (4) never produces Adapted Material.
+
+       5. Downstream recipients.
+
+            a. Offer from the Licensor -- Licensed Material. Every
+               recipient of the Licensed Material automatically
+               receives an offer from the Licensor to exercise the
+               Licensed Rights under the terms and conditions of this
+               Public License.
+
+            b. No downstream restrictions. You may not offer or impose
+               any additional or different terms or conditions on, or
+               apply any Effective Technological Measures to, the
+               Licensed Material if doing so restricts exercise of the
+               Licensed Rights by any recipient of the Licensed
+               Material.
+
+       6. No endorsement. Nothing in this Public License constitutes or
+          may be construed as permission to assert or imply that You
+          are, or that Your use of the Licensed Material is, connected
+          with, or sponsored, endorsed, or granted official status by,
+          the Licensor or others designated to receive attribution as
+          provided in Section 3(a)(1)(A)(i).
+
+  b. Other rights.
+
+       1. Moral rights, such as the right of integrity, are not
+          licensed under this Public License, nor are publicity,
+          privacy, and/or other similar personality rights; however, to
+          the extent possible, the Licensor waives and/or agrees not to
+          assert any such rights held by the Licensor to the limited
+          extent necessary to allow You to exercise the Licensed
+          Rights, but not otherwise.
+
+       2. Patent and trademark rights are not licensed under this
+          Public License.
+
+       3. To the extent possible, the Licensor waives any right to
+          collect royalties from You for the exercise of the Licensed
+          Rights, whether directly or through a collecting society
+          under any voluntary or waivable statutory or compulsory
+          licensing scheme. In all other cases the Licensor expressly
+          reserves any right to collect such royalties.
+
+
+Section 3 -- License Conditions.
+
+Your exercise of the Licensed Rights is expressly made subject to the
+following conditions.
+
+  a. Attribution.
+
+       1. If You Share the Licensed Material (including in modified
+          form), You must:
+
+            a. retain the following if it is supplied by the Licensor
+               with the Licensed Material:
+
+                 i. identification of the creator(s) of the Licensed
+                    Material and any others designated to receive
+                    attribution, in any reasonable manner requested by
+                    the Licensor (including by pseudonym if
+                    designated);
+
+                ii. a copyright notice;
+
+               iii. a notice that refers to this Public License;
+
+                iv. a notice that refers to the disclaimer of
+                    warranties;
+
+                 v. a URI or hyperlink to the Licensed Material to the
+                    extent reasonably practicable;
+
+            b. indicate if You modified the Licensed Material and
+               retain an indication of any previous modifications; and
+
+            c. indicate the Licensed Material is licensed under this
+               Public License, and include the text of, or the URI or
+               hyperlink to, this Public License.
+
+       2. You may satisfy the conditions in Section 3(a)(1) in any
+          reasonable manner based on the medium, means, and context in
+          which You Share the Licensed Material. For example, it may be
+          reasonable to satisfy the conditions by providing a URI or
+          hyperlink to a resource that includes the required
+          information.
+
+       3. If requested by the Licensor, You must remove any of the
+          information required by Section 3(a)(1)(A) to the extent
+          reasonably practicable.
+
+       4. If You Share Adapted Material You produce, the Adapter's
+          License You apply must not prevent recipients of the Adapted
+          Material from complying with this Public License.
+
+
+Section 4 -- Sui Generis Database Rights.
+
+Where the Licensed Rights include Sui Generis Database Rights that
+apply to Your use of the Licensed Material:
+
+  a. for the avoidance of doubt, Section 2(a)(1) grants You the right
+     to extract, reuse, reproduce, and Share all or a substantial
+     portion of the contents of the database;
+
+  b. if You include all or a substantial portion of the database
+     contents in a database in which You have Sui Generis Database
+     Rights, then the database in which You have Sui Generis Database
+     Rights (but not its individual contents) is Adapted Material; and
+
+  c. You must comply with the conditions in Section 3(a) if You Share
+     all or a substantial portion of the contents of the database.
+
+For the avoidance of doubt, this Section 4 supplements and does not
+replace Your obligations under this Public License where the Licensed
+Rights include other Copyright and Similar Rights.
+
+
+Section 5 -- Disclaimer of Warranties and Limitation of Liability.
+
+  a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE
+     EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS
+     AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF
+     ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS,
+     IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION,
+     WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR
+     PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS,
+     ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT
+     KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT
+     ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU.
+
+  b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE
+     TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,
+     NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT,
+     INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES,
+     COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR
+     USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN
+     ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR
+     DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR
+     IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.
+
+  c. The disclaimer of warranties and limitation of liability provided
+     above shall be interpreted in a manner that, to the extent
+     possible, most closely approximates an absolute disclaimer and
+     waiver of all liability.
+
+
+Section 6 -- Term and Termination.
+
+  a. This Public License applies for the term of the Copyright and
+     Similar Rights licensed here. However, if You fail to comply with
+     this Public License, then Your rights under this Public License
+     terminate automatically.
+
+  b. Where Your right to use the Licensed Material has terminated under
+     Section 6(a), it reinstates:
+
+       1. automatically as of the date the violation is cured, provided
+          it is cured within 30 days of Your discovery of the
+          violation; or
+
+       2. upon express reinstatement by the Licensor.
+
+     For the avoidance of doubt, this Section 6(b) does not affect any
+     right the Licensor may have to seek remedies for Your violations
+     of this Public License.
+
+  c. For the avoidance of doubt, the Licensor may also offer the
+     Licensed Material under separate terms or conditions or stop
+     distributing the Licensed Material at any time; however, doing so
+     will not terminate this Public License.
+
+  d. Sections 1, 5, 6, 7, and 8 survive termination of this Public
+     License.
+
+
+Section 7 -- Other Terms and Conditions.
+
+  a. The Licensor shall not be bound by any additional or different
+     terms or conditions communicated by You unless expressly agreed.
+
+  b. Any arrangements, understandings, or agreements regarding the
+     Licensed Material not stated herein are separate from and
+     independent of the terms and conditions of this Public License.
+
+
+Section 8 -- Interpretation.
+
+  a. For the avoidance of doubt, this Public License does not, and
+     shall not be interpreted to, reduce, limit, restrict, or impose
+     conditions on any use of the Licensed Material that could lawfully
+     be made without permission under this Public License.
+
+  b. To the extent possible, if any provision of this Public License is
+     deemed unenforceable, it shall be automatically reformed to the
+     minimum extent necessary to make it enforceable. If the provision
+     cannot be reformed, it shall be severed from this Public License
+     without affecting the enforceability of the remaining terms and
+     conditions.
+
+  c. No term or condition of this Public License will be waived and no
+     failure to comply consented to unless expressly agreed to by the
+     Licensor.
+
+  d. Nothing in this Public License constitutes or may be interpreted
+     as a limitation upon, or waiver of, any privileges and immunities
+     that apply to the Licensor or You, including from the legal
+     processes of any jurisdiction or authority.
+
+
+=======================================================================
+
+Creative Commons is not a party to its public
+licenses. Notwithstanding, Creative Commons may elect to apply one of
+its public licenses to material it publishes and in those instances
+will be considered the “Licensor.” The text of the Creative Commons
+public licenses is dedicated to the public domain under the CC0 Public
+Domain Dedication. Except for the limited purpose of indicating that
+material is shared under a Creative Commons public license or as
+otherwise permitted by the Creative Commons policies published at
+creativecommons.org/policies, Creative Commons does not authorize the
+use of the trademark "Creative Commons" or any other trademark or logo
+of Creative Commons without its prior written consent including,
+without limitation, in connection with any unauthorized modifications
+to any of its public licenses or any other arrangements,
+understandings, or agreements concerning use of licensed material. For
+the avoidance of doubt, this paragraph does not form part of the
+public licenses.
+
+Creative Commons may be contacted at creativecommons.org.
\ No newline at end of file
diff --git a/LICENSE-CODE b/LICENSE-CODE
new file mode 100644
index 0000000000..b17b032a43
--- /dev/null
+++ b/LICENSE-CODE
@@ -0,0 +1,17 @@
+The MIT License (MIT)
+Copyright (c) Microsoft Corporation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and 
+associated documentation files (the "Software"), to deal in the Software without restriction, 
+including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, 
+and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, 
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial 
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT 
+NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. 
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, 
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
\ No newline at end of file
diff --git a/README.md b/README.md
index 5a04ecebc5..3037b8163e 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,30 @@
-Entity Framework Docs
-=====================
+# Entity Framework Docs
 
-This project provides the source for [ef.readthedocs.org](http://ef.readthedocs.org/).
+This project contains the source for EF Core and EF6 documentation published at [Entity Framework documentation](https://learn.microsoft.com/ef/).
 
-**We accept pull requests!** However, before submitting a pull request, please [read the CONTRIBUTING guidelines](CONTRIBUTING.md), which include information on how to build the docs locally, as well as style and organizational guidance.
\ No newline at end of file
+Documentation issues for both EF Core and EF6 should be filed in this repo. Product issues (bugs) should be filed in the [EF Core repo](https://github.com/dotnet/efcore) or the [EF6 repo](https://github.com/dotnet/ef6) as appropriate.
+
+**We accept pull requests!**
+
+## Fixing typos/spelling/grammar/etc
+
+Consider sending a pull request rather than filing an issue. This can be done entirely from the web:
+
+* From upper right corner of the document, select the pen icon:
+  ![image](https://user-images.githubusercontent.com/3605364/93646907-e75ef680-f9a2-11ea-847a-c5c3839f3aa8.png)
+
+  Note: You might need to make the browser window wider to see the pen icon.
+
+* Click on the edit button (✏️) to edit in your web browser
+
+![image](https://user-images.githubusercontent.com/1430078/64454321-85856480-d09f-11e9-85a6-1c93bc6611e2.png)
+
+* When done, add a title and description, then use the **Create a new branch and start a pull request.** option.
+
+![image](https://user-images.githubusercontent.com/1430078/64454455-dac17600-d09f-11e9-922b-0346117011f5.png)
+
+Note that you can also clone this repo and do a GitHub PR in the normal way.
+
+## Making more substantial changes
+
+Pull requests for more substantial changes are also encouraged. However, before submitting a pull request, please [read the CONTRIBUTING guidelines](CONTRIBUTING.md), which include information on how to build the docs locally, as well as style and organizational guidance.
diff --git a/ThirdPartyNotices b/ThirdPartyNotices
new file mode 100644
index 0000000000..25ca6dcd63
--- /dev/null
+++ b/ThirdPartyNotices
@@ -0,0 +1,15 @@
+##Legal Notices
+Microsoft and any contributors grant you a license to the Microsoft documentation and other content
+in this repository under the [Creative Commons Attribution 4.0 International Public License](https://creativecommons.org/licenses/by/4.0/legalcode),
+see the [LICENSE](LICENSE) file, and grant you a license to any code in the repository under the [MIT License](https://opensource.org/licenses/MIT), see the
+[LICENSE-CODE](LICENSE-CODE) file.
+
+Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation
+may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries.
+The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks.
+Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.
+
+Privacy information can be found at https://privacy.microsoft.com/
+
+Microsoft and any contributors reserve all others rights, whether under their respective copyrights, patents,
+or trademarks, whether by implication, estoppel or otherwise.
\ No newline at end of file
diff --git a/docs/Makefile b/docs/Makefile
deleted file mode 100644
index 68d95d4a1d..0000000000
--- a/docs/Makefile
+++ /dev/null
@@ -1,192 +0,0 @@
-# Makefile for Sphinx documentation
-#
-
-# You can set these variables from the command line.
-SPHINXOPTS    =
-SPHINXBUILD   = sphinx-build
-PAPER         =
-BUILDDIR      = _build
-
-# User-friendly check for sphinx-build
-ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)
-$(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/)
-endif
-
-# Internal variables.
-PAPEROPT_a4     = -D latex_paper_size=a4
-PAPEROPT_letter = -D latex_paper_size=letter
-ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
-# the i18n builder cannot share the environment and doctrees with the others
-I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
-
-.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest coverage gettext
-
-help:
-	@echo "Please use \`make <target>' where <target> is one of"
-	@echo "  html       to make standalone HTML files"
-	@echo "  dirhtml    to make HTML files named index.html in directories"
-	@echo "  singlehtml to make a single large HTML file"
-	@echo "  pickle     to make pickle files"
-	@echo "  json       to make JSON files"
-	@echo "  htmlhelp   to make HTML files and a HTML help project"
-	@echo "  qthelp     to make HTML files and a qthelp project"
-	@echo "  applehelp  to make an Apple Help Book"
-	@echo "  devhelp    to make HTML files and a Devhelp project"
-	@echo "  epub       to make an epub"
-	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
-	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
-	@echo "  latexpdfja to make LaTeX files and run them through platex/dvipdfmx"
-	@echo "  text       to make text files"
-	@echo "  man        to make manual pages"
-	@echo "  texinfo    to make Texinfo files"
-	@echo "  info       to make Texinfo files and run them through makeinfo"
-	@echo "  gettext    to make PO message catalogs"
-	@echo "  changes    to make an overview of all changed/added/deprecated items"
-	@echo "  xml        to make Docutils-native XML files"
-	@echo "  pseudoxml  to make pseudoxml-XML files for display purposes"
-	@echo "  linkcheck  to check all external links for integrity"
-	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
-	@echo "  coverage   to run coverage check of the documentation (if enabled)"
-
-clean:
-	rm -rf $(BUILDDIR)/*
-
-html:
-	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
-	@echo
-	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
-
-dirhtml:
-	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
-	@echo
-	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
-
-singlehtml:
-	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
-	@echo
-	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
-
-pickle:
-	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
-	@echo
-	@echo "Build finished; now you can process the pickle files."
-
-json:
-	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
-	@echo
-	@echo "Build finished; now you can process the JSON files."
-
-htmlhelp:
-	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
-	@echo
-	@echo "Build finished; now you can run HTML Help Workshop with the" \
-	      ".hhp project file in $(BUILDDIR)/htmlhelp."
-
-qthelp:
-	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
-	@echo
-	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
-	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
-	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/EntityFramework.qhcp"
-	@echo "To view the help file:"
-	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/EntityFramework.qhc"
-
-applehelp:
-	$(SPHINXBUILD) -b applehelp $(ALLSPHINXOPTS) $(BUILDDIR)/applehelp
-	@echo
-	@echo "Build finished. The help book is in $(BUILDDIR)/applehelp."
-	@echo "N.B. You won't be able to view it unless you put it in" \
-	      "~/Library/Documentation/Help or install it in your application" \
-	      "bundle."
-
-devhelp:
-	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
-	@echo
-	@echo "Build finished."
-	@echo "To view the help file:"
-	@echo "# mkdir -p $$HOME/.local/share/devhelp/EntityFramework"
-	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/EntityFramework"
-	@echo "# devhelp"
-
-epub:
-	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
-	@echo
-	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
-
-latex:
-	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
-	@echo
-	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
-	@echo "Run \`make' in that directory to run these through (pdf)latex" \
-	      "(use \`make latexpdf' here to do that automatically)."
-
-latexpdf:
-	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
-	@echo "Running LaTeX files through pdflatex..."
-	$(MAKE) -C $(BUILDDIR)/latex all-pdf
-	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
-
-latexpdfja:
-	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
-	@echo "Running LaTeX files through platex and dvipdfmx..."
-	$(MAKE) -C $(BUILDDIR)/latex all-pdf-ja
-	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
-
-text:
-	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
-	@echo
-	@echo "Build finished. The text files are in $(BUILDDIR)/text."
-
-man:
-	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
-	@echo
-	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
-
-texinfo:
-	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
-	@echo
-	@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
-	@echo "Run \`make' in that directory to run these through makeinfo" \
-	      "(use \`make info' here to do that automatically)."
-
-info:
-	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
-	@echo "Running Texinfo files through makeinfo..."
-	make -C $(BUILDDIR)/texinfo info
-	@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
-
-gettext:
-	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
-	@echo
-	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
-
-changes:
-	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
-	@echo
-	@echo "The overview file is in $(BUILDDIR)/changes."
-
-linkcheck:
-	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
-	@echo
-	@echo "Link check complete; look for any errors in the above output " \
-	      "or in $(BUILDDIR)/linkcheck/output.txt."
-
-doctest:
-	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
-	@echo "Testing of doctests in the sources finished, look at the " \
-	      "results in $(BUILDDIR)/doctest/output.txt."
-
-coverage:
-	$(SPHINXBUILD) -b coverage $(ALLSPHINXOPTS) $(BUILDDIR)/coverage
-	@echo "Testing of coverage in the sources finished, look at the " \
-	      "results in $(BUILDDIR)/coverage/python.txt."
-
-xml:
-	$(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml
-	@echo
-	@echo "Build finished. The XML files are in $(BUILDDIR)/xml."
-
-pseudoxml:
-	$(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml
-	@echo
-	@echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."
diff --git a/docs/conf.py b/docs/conf.py
deleted file mode 100644
index 7d1413c494..0000000000
--- a/docs/conf.py
+++ /dev/null
@@ -1,302 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-#
-# Entity Framework documentation build configuration file, created by
-# sphinx-quickstart on Thu May 28 14:14:28 2015.
-#
-# This file is execfile()d with the current directory set to its
-# containing dir.
-#
-# Note that not all possible configuration values are present in this
-# autogenerated file.
-#
-# All configuration values have a default; values that are commented out
-# serve to show the default.
-
-import sys
-import os
-import shlex
-
-# If extensions (or modules to document with autodoc) are in another directory,
-# add these directories to sys.path here. If the directory is relative to the
-# documentation root, use os.path.abspath to make it absolute, like shown here.
-#sys.path.insert(0, os.path.abspath('.'))
-
-# -- General configuration ------------------------------------------------
-
-# If your documentation needs a minimal Sphinx version, state it here.
-#needs_sphinx = '1.0'
-
-# Add any Sphinx extension module names here, as strings. They can be
-# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
-# ones.
-extensions = []
-
-# Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
-
-# The suffix(es) of source filenames.
-# You can specify multiple suffix as a list of string:
-# source_suffix = ['.rst', '.md']
-source_suffix = '.rst'
-
-# The encoding of source files.
-#source_encoding = 'utf-8-sig'
-
-# The master toctree document.
-master_doc = 'index'
-
-# General information about the project.
-project = 'Entity Framework'
-copyright = '2015 Microsoft'
-author = 'Microsoft'
-
-# The version info for the project you're documenting, acts as replacement for
-# |version| and |release|, also used in various other places throughout the
-# built documents.
-#
-# The short X.Y version.
-version = '7.0.0'
-# The full version, including alpha/beta/rc tags.
-release = '7.0.0'
-
-# The language for content autogenerated by Sphinx. Refer to documentation
-# for a list of supported languages.
-#
-# This is also used if you do content translation via gettext catalogs.
-# Usually you set "language" from the command line for these cases.
-language = None
-
-# There are two options for replacing |today|: either, you set today to some
-# non-false value, then it is used:
-#today = ''
-# Else, today_fmt is used as the format for a strftime call.
-#today_fmt = '%B %d, %Y'
-
-# List of patterns, relative to source directory, that match files and
-# directories to ignore when looking for source files.
-exclude_patterns = ['_build','**/sample']
-
-# The reST default role (used for this markup: `text`) to use for all
-# documents.
-#default_role = None
-
-# If true, '()' will be appended to :func: etc. cross-reference text.
-#add_function_parentheses = True
-
-# If true, the current module name will be prepended to all description
-# unit titles (such as .. function::).
-#add_module_names = True
-
-# If true, sectionauthor and moduleauthor directives will be shown in the
-# output. They are ignored by default.
-#show_authors = False
-
-# The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'sphinx'
-
-# A list of ignored prefixes for module index sorting.
-#modindex_common_prefix = []
-
-# If true, keep warnings as "system message" paragraphs in the built documents.
-#keep_warnings = False
-
-# If true, `todo` and `todoList` produce output, else they produce nothing.
-todo_include_todos = False
-
-rst_prolog = """
-
-.. include:: /global-header.txt
-"""
-
-# -- Options for HTML output ----------------------------------------------
-
-# The theme to use for HTML and HTML Help pages.  See the documentation for
-# a list of builtin themes.
-
-# This allows sphinx_rtd_theme to work locally
-on_rtd = os.environ.get('READTHEDOCS', None) == 'True'
-
-if not on_rtd:
-	import sphinx_rtd_theme
-	html_theme = 'sphinx_rtd_theme'
-	html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
-
-def setup(app):
-	app.add_stylesheet('custom.css')
-	app.add_javascript('wedc.js')
-
-#html_theme = 'default'
-
-# Theme options are theme-specific and customize the look and feel of a theme
-# further.  For a list of options available for each theme, see the
-# documentation.
-#html_theme_options = {}
-
-# Add any paths that contain custom themes here, relative to this directory.
-#html_theme_path = []
-
-# The name for this set of Sphinx documents.  If None, it defaults to
-# "<project> v<release> documentation".
-#html_title = None
-
-# A shorter title for the navigation bar.  Default is the same as html_title.
-#html_short_title = None
-
-# The name of an image file (relative to this directory) to place at the top
-# of the sidebar.
-#html_logo = None
-
-# The name of an image file (within the static path) to use as favicon of the
-# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
-# pixels large.
-#html_favicon = None
-
-# Add any paths that contain custom static files (such as style sheets) here,
-# relative to this directory. They are copied after the builtin static files,
-# so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
-
-# Add any extra paths that contain custom files (such as robots.txt or
-# .htaccess) here, relative to this directory. These files are copied
-# directly to the root of the documentation.
-#html_extra_path = []
-
-# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
-# using the given strftime format.
-html_last_updated_fmt = '%b %d, %Y'
-
-# If true, SmartyPants will be used to convert quotes and dashes to
-# typographically correct entities.
-#html_use_smartypants = True
-
-# Custom sidebar templates, maps document names to template names.
-#html_sidebars = {}
-
-# Additional templates that should be rendered to pages, maps page names to
-# template names.
-#html_additional_pages = {}
-
-# If false, no module index is generated.
-#html_domain_indices = True
-
-# If false, no index is generated.
-#html_use_index = True
-
-# If true, the index is split into individual pages for each letter.
-#html_split_index = False
-
-# If true, links to the reST sources are added to the pages.
-#html_show_sourcelink = True
-
-# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
-#html_show_sphinx = True
-
-# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
-#html_show_copyright = True
-
-# If true, an OpenSearch description file will be output, and all pages will
-# contain a <link> tag referring to it.  The value of this option must be the
-# base URL from which the finished HTML is served.
-#html_use_opensearch = ''
-
-# This is the file name suffix for HTML files (e.g. ".xhtml").
-#html_file_suffix = None
-
-# Language to be used for generating the HTML full-text search index.
-# Sphinx supports the following languages:
-#   'da', 'de', 'en', 'es', 'fi', 'fr', 'h', 'it', 'ja'
-#   'nl', 'no', 'pt', 'ro', 'r', 'sv', 'tr'
-#html_search_language = 'en'
-
-# A dictionary with options for the search language support, empty by default.
-# Now only 'ja' uses this config value
-#html_search_options = {'type': 'default'}
-
-# The name of a javascript file (relative to the configuration directory) that
-# implements a search results scorer. If empty, the default will be used.
-#html_search_scorer = 'scorer.js'
-
-# Output file base name for HTML help builder.
-htmlhelp_basename = 'EntityFrameworkdoc'
-
-# -- Options for LaTeX output ---------------------------------------------
-
-latex_elements = {
-# The paper size ('letterpaper' or 'a4paper').
-#'papersize': 'letterpaper',
-
-# The font size ('10pt', '11pt' or '12pt').
-#'pointsize': '10pt',
-
-# Additional stuff for the LaTeX preamble.
-#'preamble': '',
-
-# Latex figure (float) alignment
-#'figure_align': 'htbp',
-}
-
-# Grouping the document tree into LaTeX files. List of tuples
-# (source start file, target name, title,
-#  author, documentclass [howto, manual, or own class]).
-latex_documents = [
-  (master_doc, 'EntityFramework.tex', 'Entity Framework Documentation',
-   'Microsoft', 'manual'),
-]
-
-# The name of an image file (relative to this directory) to place at the top of
-# the title page.
-#latex_logo = None
-
-# For "manual" documents, if this is true, then toplevel headings are parts,
-# not chapters.
-#latex_use_parts = False
-
-# If true, show page references after internal links.
-#latex_show_pagerefs = False
-
-# If true, show URL addresses after external links.
-#latex_show_urls = False
-
-# Documents to append as an appendix to all manuals.
-#latex_appendices = []
-
-# If false, no module index is generated.
-#latex_domain_indices = True
-
-
-# -- Options for manual page output ---------------------------------------
-
-# One entry per manual page. List of tuples
-# (source start file, name, description, authors, manual section).
-man_pages = [
-    (master_doc, 'entityframework', 'Entity Framework Documentation',
-     [author], 1)
-]
-
-# If true, show URL addresses after external links.
-#man_show_urls = False
-
-
-# -- Options for Texinfo output -------------------------------------------
-
-# Grouping the document tree into Texinfo files. List of tuples
-# (source start file, target name, title, author,
-#  dir menu entry, description, category)
-texinfo_documents = [
-  (master_doc, 'EntityFramework', 'Entity Framework Documentation',
-   author, 'EntityFramework', 'One line description of project.',
-   'Miscellaneous'),
-]
-
-# Documents to append as an appendix to all manuals.
-#texinfo_appendices = []
-
-# If false, no module index is generated.
-#texinfo_domain_indices = True
-
-# How to display URL addresses: 'footnote', 'no', or 'inline'.
-#texinfo_show_urls = 'footnote'
-
-# If true, do not generate a @detailmenu in the "Top" node's menu.
-#texinfo_no_detailmenu = False
diff --git a/docs/getting-started/aspnet5.rst b/docs/getting-started/aspnet5.rst
deleted file mode 100644
index b3d0407804..0000000000
--- a/docs/getting-started/aspnet5.rst
+++ /dev/null
@@ -1,190 +0,0 @@
-.. include:: /stub-topic.txt
-
-Getting Started on ASP.NET 5
-============================
-
-In this walkthrough, you will build an ASP.NET 5 MVC application that performs basic data access using Entity Framework.
-
-In this article:
-	- `Create a new project`_
-	- `Install Entity Framework`_
-	- `Create your model`_
-	- `Register your context with dependency injection`_
-	- `Create your database`_
-	- `Create a controller`_
-	- `Create views`_
-	- `Run the application`_
-
-`View this article's samples on GitHub <https://github.com/aspnet/EntityFramework.Docs/tree/master/docs/getting-started/aspnet5/sample>`_.
-
-.. note::
-    This walkthrough uses EF 7.0.0-beta7 which is the latest pre-release available on NuGet.org.
-
-    You can find nightly builds of the EF7 code base hosted on https://www.myget.org/F/aspnetvnext/api/v2/ but the code base is rapidly changing and we do not maintain up-to-date documentation for getting started.
-
-Prerequisites
--------------
-
-The following items are required to complete this walkthrough:
-    - Visual Studio 2015
-
-Create a new project
---------------------
-
-    - Open Visual Studio 2015
-    - :menuselection:`File --> New --> Project...`
-    - From the left menu select :menuselection:`Templates --> Visual C# --> Web`
-    - Select the **ASP.NET Web Application** project template
-    - Ensure you are targeting .NET 4.5.1 or later
-    - Enter **EFGetStarted.AspNet5** as the name and click **OK**
-
-When the **New ASP.NET Project** dialog appears:
-    - Under **ASP.NET 5 Preview Templates** select **Web Application**
-    - Ensure that **Authentication** is set to **No Authentication**
-    - Click **OK**
-
-.. caution::
-    If you use **Individual User Accounts** instead of **None** for **Authentication** then an Entity Framework model will be added to your project in `Models\\IdentityModel.cs`.
-
-    Using the techniques you will learn in this walkthrough, you can chose to add a second model, or extend this existing model to contain your entity classes.
-
-Install Entity Framework
-----------------------------------------
-To use EF7 you install the package for the database provider(s) you want to target. This walkthrough uses SQL Server. For a list of available providers see :doc:`/providers/index`.
-
-    - :menuselection:`Tools --> NuGet Package Manager --> Package Manager Console`
-    - Run ``Install-Package EntityFramework.SqlServer –Pre``
-
-.. note::
-    In ASP.NET 5 projects the ``Install-Package`` will complete quickly and the package installation will occur in the background. You will see **(Restoring...)** appear next to **References** in **Solution Explorer** while the install occurs.
-
-Later in this walkthrough we will also be using some Entity Framework commands to maintain the database. So we will install the commands package as well.
-
-    - Run ``Install-Package EntityFramework.Commands –Pre``
-    - Open **project.json**
-    - Locate the ``commands`` section and add the ``ef`` command as shown below
-
-.. literalinclude:: aspnet5/sample/src/EFGetStarted.AspNet5/project.json
-        :language: json
-        :linenos:
-        :lines: 21-24
-        :emphasize-lines: 3
-
-Create your model
------------------
-
-Now it's time to define a context and entity classes that make up your model.
-    - Right-click on the project in **Solution Explorer** and select :menuselection:`Add --> New Folder`
-    - Enter **Models** as the name of the folder
-    - Right-click on the **Models** folder and select :menuselection:`Add --> New Item...`
-    - From the left menu select :menuselection:`Installed --> Server-side`
-    - Select the **Class** item template
-    - Enter **BloggingModel.cs** as the name and click **OK**
-    - Replace the contents of the file with the following code
-
-.. literalinclude:: aspnet5/sample/src/EFGetStarted.AspNet5/Models/BloggingModel.cs
-        :language: c#
-        :linenos:
-
-Register your context with dependency injection
------------------------------------------------
-
-The concept of dependency injection is central to ASP.NET 5. Services (such as our ``BloggingContext``) are registered with dependency injection during application startup. Components that require these services (such as our MVC controllers) are then provided these services via constructor parameters or properties.
-
-.. tip::
-    For more information on dependency injection see the `Dependency Injection <http://docs.asp.net/en/latest/fundamentals/dependency-injection.html>`_ article on the ASP.NET site.
-
-In order for our MVC controllers to make use of ``BloggingContext`` we are going to register it as a service.
-    - Open **Startup.cs**
-    - Add the following ``using`` statements at the start of the file
-
-.. literalinclude:: aspnet5/sample/src/EFGetStarted.AspNet5/Startup.cs
-        :language: c#
-        :linenos:
-        :lines: 11-12
-
-Now we can use the ``AddDbContext`` method to register it as a service.
-    - Locate the ``ConfigureServices`` method
-    - Add the lines that are highlighted in the following code
-
-.. literalinclude:: aspnet5/sample/src/EFGetStarted.AspNet5/Startup.cs
-        :language: c#
-        :linenos:
-        :lines: 29-38
-        :emphasize-lines: 4-8
-
-Create your database
---------------------
-
-.. caution::
-
-    The migrations experience in ASP.NET 5 is still a work-in-progress. The following steps are overly complex and will be simplified by the time we reach a stable release.
-
-Now that you have a model, you can use migrations to create a database for you.
-    - Open a command prompt (**Windows Key + R**, type **cmd**, click **OK**)
-    - Use the ``cd`` command to navigate to the project directory
-    - Run ``dnvm use 1.0.0-beta7``
-    - Run ``dnx ef migrations add MyFirstMigration`` to scaffold a migration to create the initial set of tables for your model.
-    - Run ``dnx ef database update`` to apply the new migration to the database. Because your database doesn't exist yet, it will be created for you before the migration is applied.
-
-.. tip::
-    If you make future changes to your model, you can use the ``dnx ef migrations add`` command to scaffold a new migration to apply the corresponding changes to the database. Once you have checked the scaffolded code (and made any required changes), you can use the ``dnx database update`` command to apply the changes to the database.
-
-Create a controller
--------------------
-
-Next, we'll add an MVC controller that will use EF to query and save data.
-	- Right-click on the **Controllers** folder in **Solution Explorer** and select :menuselection:`Add --> New Item...`
-	- From the left menu select :menuselection:`Installed --> Server-side`
-	- Select the **Class** item template
-	- Enter **BlogsController.cs** as the name and click **OK**
-	- Replace the contents of the file with the following code
-
-.. literalinclude:: aspnet5/sample/src/EFGetStarted.AspNet5/Controllers/BlogsController.cs
-        :language: c#
-        :linenos:
-
-You'll notice that the controller takes a ``BlogContext`` as a constructor parameter. ASP.NET dependency injection will take care of passing an instance of ``BlogContext`` into your controller.
-
-The controller contains an ``Index`` action, which displays all blogs in the database, and a ``Create`` action, which inserts a new blogs into the database.
-
-Create views
-------------
-
-Now that we have a controller it's time to add the views that will make up the user interface.
-
-We'll start with the view for our ``Index`` action, that displays all blogs.
-	- Right-click on the **Views** folder in **Solution Explorer** and select :menuselection:`Add --> New Folder`
-	- Enter **Blogs** as the name of the folder
-	- Right-click on the **Blogs** folder and select :menuselection:`Add --> New Item...`
-	- From the left menu select :menuselection:`Installed --> Server-side`
-	- Select the **MVC View Page** item template
-	- Enter **Index.cshtml** as the name and click **OK**
-	- Replace the contents of the file with the following code
-
-.. literalinclude:: aspnet5/sample/src/EFGetStarted.AspNet5/Views/Blogs/Index.cshtml
-        :linenos:
-
-We'll also add a view for the ``Create`` action, which allows the user to enter details for a new blog.
-	- Right-click on the **Blogs** folder and select :menuselection:`Add --> New Item...`
-	- From the left menu select :menuselection:`Installed --> ASP.NET 5`
-	- Select the **MVC View Page** item template
-	- Enter **Create.cshtml** as the name and click **OK**
-	- Replace the contents of the file with the following code
-
-.. literalinclude:: aspnet5/sample/src/EFGetStarted.AspNet5/Views/Blogs/Create.cshtml
-        :linenos:
-
-Run the application
--------------------
-
-You can now run the application to see it in action.
-	- :menuselection:`Debug --> Start Without Debugging`
-	- The application will build and open in a web browser
-	- Navigate to **/Blogs**
-	- Click **Create New**
-	- Enter a **Url** for the new blog and click **Create**
-
-.. image:: aspnet5/_static/create.png
-
-.. image:: aspnet5/_static/index.png
diff --git a/docs/getting-started/aspnet5/_static/create.png b/docs/getting-started/aspnet5/_static/create.png
deleted file mode 100644
index 42eaea412c..0000000000
Binary files a/docs/getting-started/aspnet5/_static/create.png and /dev/null differ
diff --git a/docs/getting-started/aspnet5/_static/index.png b/docs/getting-started/aspnet5/_static/index.png
deleted file mode 100644
index 3483fd2403..0000000000
Binary files a/docs/getting-started/aspnet5/_static/index.png and /dev/null differ
diff --git a/docs/getting-started/aspnet5/sample/EFGetStarted.AspNet5.sln b/docs/getting-started/aspnet5/sample/EFGetStarted.AspNet5.sln
deleted file mode 100644
index b5355566c3..0000000000
--- a/docs/getting-started/aspnet5/sample/EFGetStarted.AspNet5.sln
+++ /dev/null
@@ -1,33 +0,0 @@
-
-Microsoft Visual Studio Solution File, Format Version 12.00
-# Visual Studio 14
-VisualStudioVersion = 14.0.23107.0
-MinimumVisualStudioVersion = 10.0.40219.1
-Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{48735D53-CA9D-4B9F-B590-F6F175B5FA28}"
-EndProject
-Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{890A434D-BFFA-4516-A347-73F15C6E93EB}"
-	ProjectSection(SolutionItems) = preProject
-		global.json = global.json
-		NuGet.Config = NuGet.Config
-	EndProjectSection
-EndProject
-Project("{8BB2217D-0F2D-49D1-97BC-3654ED321F3B}") = "EFGetStarted.AspNet5", "src\EFGetStarted.AspNet5\EFGetStarted.AspNet5.xproj", "{07452B55-732D-4B25-B5BE-D28CB342770F}"
-EndProject
-Global
-	GlobalSection(SolutionConfigurationPlatforms) = preSolution
-		Debug|Any CPU = Debug|Any CPU
-		Release|Any CPU = Release|Any CPU
-	EndGlobalSection
-	GlobalSection(ProjectConfigurationPlatforms) = postSolution
-		{07452B55-732D-4B25-B5BE-D28CB342770F}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{07452B55-732D-4B25-B5BE-D28CB342770F}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{07452B55-732D-4B25-B5BE-D28CB342770F}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{07452B55-732D-4B25-B5BE-D28CB342770F}.Release|Any CPU.Build.0 = Release|Any CPU
-	EndGlobalSection
-	GlobalSection(SolutionProperties) = preSolution
-		HideSolutionNode = FALSE
-	EndGlobalSection
-	GlobalSection(NestedProjects) = preSolution
-		{07452B55-732D-4B25-B5BE-D28CB342770F} = {48735D53-CA9D-4B9F-B590-F6F175B5FA28}
-	EndGlobalSection
-EndGlobal
diff --git a/docs/getting-started/aspnet5/sample/NuGet.Config b/docs/getting-started/aspnet5/sample/NuGet.Config
deleted file mode 100644
index 95143bd09a..0000000000
--- a/docs/getting-started/aspnet5/sample/NuGet.Config
+++ /dev/null
@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<configuration>
-  <packageSources>
-    <!--To inherit the global NuGet package sources remove the <clear/> line below -->
-    <clear />
-    <add key="api.nuget.org" value="https://api.nuget.org/v3/index.json" />
-  </packageSources>
-</configuration>
diff --git a/docs/getting-started/aspnet5/sample/global.json b/docs/getting-started/aspnet5/sample/global.json
deleted file mode 100644
index 05eea2c171..0000000000
--- a/docs/getting-started/aspnet5/sample/global.json
+++ /dev/null
@@ -1,6 +0,0 @@
-{
-  "projects": [ "src", "test" ],
-  "sdk": {
-    "version": "1.0.0-beta7"
-  }
-}
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/.bowerrc b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/.bowerrc
deleted file mode 100644
index 6406626abf..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/.bowerrc
+++ /dev/null
@@ -1,3 +0,0 @@
-{
-  "directory": "wwwroot/lib"
-}
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Controllers/BlogsController.cs b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Controllers/BlogsController.cs
deleted file mode 100644
index a33085b851..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Controllers/BlogsController.cs
+++ /dev/null
@@ -1,41 +0,0 @@
-using EFGetStarted.AspNet5.Models;
-using Microsoft.AspNet.Mvc;
-using System.Linq;
-
-namespace EFGetStarted.AspNet5.Controllers
-{
-    public class BlogsController : Controller
-    {
-        private BloggingContext _context;
-
-        public BlogsController(BloggingContext context)
-        {
-            _context = context;
-        }
-
-        public IActionResult Index()
-        {
-            return View(_context.Blogs.ToList());
-        }
-
-        public IActionResult Create()
-        {
-            return View();
-        }
-
-        [HttpPost]
-        [ValidateAntiForgeryToken]
-        public IActionResult Create(Blog blog)
-        {
-            if (ModelState.IsValid)
-            {
-                _context.Blogs.Add(blog);
-                _context.SaveChanges();
-                return RedirectToAction("Index");
-            }
-
-            return View(blog);
-        }
-
-    }
-}
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Controllers/HomeController.cs b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Controllers/HomeController.cs
deleted file mode 100644
index 2a22815dee..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Controllers/HomeController.cs
+++ /dev/null
@@ -1,35 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Threading.Tasks;
-using Microsoft.AspNet.Mvc;
-
-namespace EFGetStarted.AspNet5.Controllers
-{
-    public class HomeController : Controller
-    {
-        public IActionResult Index()
-        {
-            return View();
-        }
-
-        public IActionResult About()
-        {
-            ViewData["Message"] = "Your application description page.";
-
-            return View();
-        }
-
-        public IActionResult Contact()
-        {
-            ViewData["Message"] = "Your contact page.";
-
-            return View();
-        }
-
-        public IActionResult Error()
-        {
-            return View("~/Views/Shared/Error.cshtml");
-        }
-    }
-}
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/EFGetStarted.AspNet5.xproj b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/EFGetStarted.AspNet5.xproj
deleted file mode 100644
index ee79b5f29b..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/EFGetStarted.AspNet5.xproj
+++ /dev/null
@@ -1,19 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<Project ToolsVersion="14.0" DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
-  <PropertyGroup>
-    <VisualStudioVersion Condition="'$(VisualStudioVersion)' == ''">14.0</VisualStudioVersion>
-    <VSToolsPath Condition="'$(VSToolsPath)' == ''">$(MSBuildExtensionsPath32)\Microsoft\VisualStudio\v$(VisualStudioVersion)</VSToolsPath>
-  </PropertyGroup>
-  <Import Project="$(VSToolsPath)\DNX\Microsoft.DNX.Props" Condition="'$(VSToolsPath)' != ''" />
-  <PropertyGroup Label="Globals">
-    <ProjectGuid>07452b55-732d-4b25-b5be-d28cb342770f</ProjectGuid>
-    <RootNamespace>EFGetStarted.AspNet5</RootNamespace>
-    <BaseIntermediateOutputPath Condition="'$(BaseIntermediateOutputPath)'=='' ">..\..\artifacts\obj\$(MSBuildProjectName)</BaseIntermediateOutputPath>
-    <OutputPath Condition="'$(OutputPath)'=='' ">..\..\artifacts\bin\$(MSBuildProjectName)\</OutputPath>
-  </PropertyGroup>
-  <PropertyGroup>
-    <SchemaVersion>2.0</SchemaVersion>
-    <DevelopmentServerPort>46829</DevelopmentServerPort>
-  </PropertyGroup>
-  <Import Project="$(VSToolsPath)\DNX\Microsoft.DNX.targets" Condition="'$(VSToolsPath)' != ''" />
-</Project>
\ No newline at end of file
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Migrations/20150610230331_MyFirstMigration.Designer.cs b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Migrations/20150610230331_MyFirstMigration.Designer.cs
deleted file mode 100644
index 4e4a802c23..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Migrations/20150610230331_MyFirstMigration.Designer.cs
+++ /dev/null
@@ -1,58 +0,0 @@
-using System;
-using Microsoft.Data.Entity;
-using Microsoft.Data.Entity.Infrastructure;
-using Microsoft.Data.Entity.Metadata;
-using Microsoft.Data.Entity.Migrations;
-using EFGetStarted.AspNet5.Models;
-using Microsoft.Data.Entity.SqlServer.Metadata;
-
-namespace EFGetStarted.AspNet5.Migrations
-{
-    [DbContext(typeof(BloggingContext))]
-    partial class MyFirstMigration
-    {
-        public override string Id
-        {
-            get { return "20150610230331_MyFirstMigration"; }
-        }
-
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-            modelBuilder
-                .Annotation("ProductVersion", "7.0.0-beta7-15540")
-                .Annotation("SqlServer:ValueGenerationStrategy", SqlServerIdentityStrategy.IdentityColumn);
-
-            modelBuilder.Entity("EFGetStarted.AspNet5.Models.Blog", b =>
-                {
-                    b.Property<int>("BlogId")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Url")
-                        .Required();
-
-                    b.Key("BlogId");
-                });
-
-            modelBuilder.Entity("EFGetStarted.AspNet5.Models.Post", b =>
-                {
-                    b.Property<int>("PostId")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BlogId");
-
-                    b.Property<string>("Content");
-
-                    b.Property<string>("Title");
-
-                    b.Key("PostId");
-                });
-
-            modelBuilder.Entity("EFGetStarted.AspNet5.Models.Post", b =>
-                {
-                    b.Reference("EFGetStarted.AspNet5.Models.Blog")
-                        .InverseCollection()
-                        .ForeignKey("BlogId");
-                });
-        }
-    }
-}
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Migrations/20150610230331_MyFirstMigration.cs b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Migrations/20150610230331_MyFirstMigration.cs
deleted file mode 100644
index 9c991b0f12..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Migrations/20150610230331_MyFirstMigration.cs
+++ /dev/null
@@ -1,51 +0,0 @@
-using System;
-using System.Collections.Generic;
-using Microsoft.Data.Entity.Migrations;
-using Microsoft.Data.Entity.SqlServer.Metadata;
-
-namespace EFGetStarted.AspNet5.Migrations
-{
-    public partial class MyFirstMigration : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.CreateTable(
-                name: "Blog",
-                columns: table => new
-                {
-                    BlogId = table.Column<int>(isNullable: false)
-                        .Annotation("SqlServer:ValueGenerationStrategy", SqlServerIdentityStrategy.IdentityColumn),
-                    Url = table.Column<string>(isNullable: false)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_Blog", x => x.BlogId);
-                });
-            migrationBuilder.CreateTable(
-                name: "Post",
-                columns: table => new
-                {
-                    PostId = table.Column<int>(isNullable: false)
-                        .Annotation("SqlServer:ValueGenerationStrategy", SqlServerIdentityStrategy.IdentityColumn),
-                    BlogId = table.Column<int>(isNullable: false),
-                    Content = table.Column<string>(isNullable: true),
-                    Title = table.Column<string>(isNullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_Post", x => x.PostId);
-                    table.ForeignKey(
-                        name: "FK_Post_Blog_BlogId",
-                        column: x => x.BlogId,
-                        principalTable: "Blog",
-                        principalColumn: "BlogId");
-                });
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropTable("Post");
-            migrationBuilder.DropTable("Blog");
-        }
-    }
-}
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Migrations/BloggingContextModelSnapshot.cs b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Migrations/BloggingContextModelSnapshot.cs
deleted file mode 100644
index cca0cedc94..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Migrations/BloggingContextModelSnapshot.cs
+++ /dev/null
@@ -1,53 +0,0 @@
-using System;
-using Microsoft.Data.Entity;
-using Microsoft.Data.Entity.Infrastructure;
-using Microsoft.Data.Entity.Metadata;
-using Microsoft.Data.Entity.Migrations;
-using EFGetStarted.AspNet5.Models;
-using Microsoft.Data.Entity.SqlServer.Metadata;
-
-namespace EFGetStarted.AspNet5.Migrations
-{
-    [DbContext(typeof(BloggingContext))]
-    partial class BloggingContextModelSnapshot : ModelSnapshot
-    {
-        protected override void BuildModel(ModelBuilder modelBuilder)
-        {
-            modelBuilder
-                .Annotation("ProductVersion", "7.0.0-beta7-15540")
-                .Annotation("SqlServer:ValueGenerationStrategy", SqlServerIdentityStrategy.IdentityColumn);
-
-            modelBuilder.Entity("EFGetStarted.AspNet5.Models.Blog", b =>
-                {
-                    b.Property<int>("BlogId")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Url")
-                        .Required();
-
-                    b.Key("BlogId");
-                });
-
-            modelBuilder.Entity("EFGetStarted.AspNet5.Models.Post", b =>
-                {
-                    b.Property<int>("PostId")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BlogId");
-
-                    b.Property<string>("Content");
-
-                    b.Property<string>("Title");
-
-                    b.Key("PostId");
-                });
-
-            modelBuilder.Entity("EFGetStarted.AspNet5.Models.Post", b =>
-                {
-                    b.Reference("EFGetStarted.AspNet5.Models.Blog")
-                        .InverseCollection()
-                        .ForeignKey("BlogId");
-                });
-        }
-    }
-}
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Models/BloggingModel.cs b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Models/BloggingModel.cs
deleted file mode 100644
index b912e09705..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Models/BloggingModel.cs
+++ /dev/null
@@ -1,37 +0,0 @@
-using Microsoft.Data.Entity;
-using System.Collections.Generic;
-
-namespace EFGetStarted.AspNet5.Models
-{
-    public class BloggingContext : DbContext
-    {
-        public DbSet<Blog> Blogs { get; set; }
-        public DbSet<Post> Posts { get; set; }
-
-        protected override void OnModelCreating(ModelBuilder modelBuilder)
-        {
-            // Make Blog.Url required
-            modelBuilder.Entity<Blog>()
-                .Property(b => b.Url)
-                .Required();
-        }
-    }
-
-    public class Blog
-    {
-        public int BlogId { get; set; }
-        public string Url { get; set; }
-
-        public List<Post> Posts { get; set; }
-    }
-
-    public class Post
-    {
-        public int PostId { get; set; }
-        public string Title { get; set; }
-        public string Content { get; set; }
-
-        public int BlogId { get; set; }
-        public Blog Blog { get; set; }
-    }
-}
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Project_Readme.html b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Project_Readme.html
deleted file mode 100644
index 2cd7a71d28..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Project_Readme.html
+++ /dev/null
@@ -1,203 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="utf-8" />
-    <title>Welcome to ASP.NET 5</title>
-    <style>
-        html {
-            background: #f1f1f1;
-            height: 100%;
-        }
-
-        body {
-            background: #fff;
-            color: #505050;
-            font: 14px 'Segoe UI', tahoma, arial, helvetica, sans-serif;
-            margin: 1%;
-            min-height: 95.5%;
-            border: 1px solid silver;
-            position: relative;
-        }
-
-        #header {
-            padding: 0;
-        }
-
-            #header h1 {
-                font-size: 44px;
-                font-weight: normal;
-                margin: 0;
-                padding: 10px 30px 10px 30px;
-            }
-
-            #header span {
-                margin: 0;
-                padding: 0 30px;
-                display: block;
-            }
-
-            #header p {
-                font-size: 20px;
-                color: #fff;
-                background: #007acc;
-                padding: 0 30px;
-                line-height: 50px;
-                margin-top: 25px;
-
-            }
-
-                #header p a {
-                    color: #fff;
-                    text-decoration: underline;
-                    font-weight: bold;
-                    padding-right: 35px;
-                    background: no-repeat right bottom url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABcAAAAWCAMAAAAcqPc3AAAANlBMVEUAAAAAeswfitI9mthXp91us+KCvuaTx+mjz+2x1u+83PLH4vTR5/ba7Pjj8Pns9fv1+v3////wy3dWAAAAAXRSTlMAQObYZgAAAHxJREFUeNp9kVcSwCAIRMHUYoH7XzaxOxJ9P8oyQ1uIqNPwh3s2aLmIM2YtqrLcQIeQEylhuCeUOlhgve5yoBCfWmlnlgkN4H8ykbpaE7gR03AbUHiwoOxUH9Xp+ubd41p1HF3mBPrfC87BHeTdaB3ceeKL9HGpcvX9zu6+DdMWT9KQPvYAAAAASUVORK5CYII=);
-                }
-
-        #main {
-            padding: 5px 30px;
-            clear: both;
-        }
-
-        .section {
-            width: 21.7%;
-            float: left;
-            margin: 0 0 0 4%;
-        }
-
-            .section h2 {
-                font-size: 13px;
-                text-transform: uppercase;
-                margin: 0;
-                border-bottom: 1px solid silver;
-                padding-bottom: 12px;
-                margin-bottom: 8px;
-            }
-
-            .section.first {
-                margin-left: 0;
-            }
-
-                .section.first h2 {
-                    font-size: 24px;
-                    text-transform: none;
-                    margin-bottom: 25px;
-                    border: none;
-                }
-
-                .section.first li {
-                    border-top: 1px solid silver;
-                    padding: 8px 0;
-                }
-
-            .section.last {
-                margin-right: 0;
-            }
-
-        ul {
-            list-style: none;
-            padding: 0;
-            margin: 0;
-            line-height: 20px;
-        }
-
-        li {
-            padding: 4px 0;
-        }
-
-        a {
-            color: #267cb2;
-            text-decoration: none;
-        }
-
-            a:hover {
-                text-decoration: underline;
-            }
-
-        #footer {
-            clear: both;
-            padding-top: 50px;
-        }
-
-            #footer p {
-                position: absolute;
-                bottom: 10px;
-            }
-    </style>
-</head>
-<body>
-
-    <div id="header">
-        <h1>Welcome to ASP.NET 5 Preview</h1>
-        <span>
-            We've made some big updates in this release, so it’s <b>important</b> that you spend
-            a few minutes to learn what’s new.
-            <br /><br />
-            ASP.NET 5 has been rearchitected to make it <b>lean</b> and <b>composable</b>. It's fully
-            <b>open source</b> and available on <a href="http://go.microsoft.com/fwlink/?LinkID=517854">GitHub</a>.
-            <br />
-            Your new project automatically takes advantage of modern client-side utilities
-            like <a href="http://go.microsoft.com/fwlink/?LinkId=518004">Bower</a> and <a href="http://go.microsoft.com/fwlink/?LinkId=518005">npm</a>
-            (to add client-side libraries) and <a href="http://go.microsoft.com/fwlink/?LinkId=518007">Gulp</a> (for client-side build and automation tasks).
-
-            <br /><br />
-            We hope you enjoy the new capabilities in ASP.NET 5 and Visual Studio 2015.
-            <br />
-            The ASP.NET Team
-        </span>
-        <p>You've created a new ASP.NET 5 project. <a href="http://go.microsoft.com/fwlink/?LinkId=518016">Learn what's new</a></p>
-    </div>
-
-    <div id="main">
-        <div class="section first">
-            <h2>This application consists of:</h2>
-            <ul>
-                <li>Sample pages using ASP.NET MVC 6</li>
-                <li><a href="http://go.microsoft.com/fwlink/?LinkId=518007">Gulp</a> and <a href="http://go.microsoft.com/fwlink/?LinkId=518004">Bower</a> for managing client-side resources</li>
-                <li>Theming using <a href="http://go.microsoft.com/fwlink/?LinkID=398939">Bootstrap</a></li>
-            </ul>
-        </div>
-
-        <div class="section">
-            <h2>New concepts</h2>
-            <ul>
-                <li><a href="http://go.microsoft.com/fwlink/?LinkId=518008">The 'wwwroot' explained</a></li>
-                <li><a href="http://go.microsoft.com/fwlink/?LinkId=518012">Configuration in ASP.NET 5</a></li>
-                <li><a href="http://go.microsoft.com/fwlink/?LinkId=518013">Dependency Injection</a></li>
-                <li><a href="http://go.microsoft.com/fwlink/?LinkId=518014">Razor TagHelpers</a></li>
-                <li><a href="http://go.microsoft.com/fwlink/?LinkID=517849">Manage client tasks using Gulp</a></li>
-                <li><a href="http://go.microsoft.com/fwlink/?LinkID=517850">Develop on different platforms</a></li>
-            </ul>
-        </div>
-
-        <div class="section">
-            <h2>Customize app</h2>
-            <ul>
-                <li><a href="http://go.microsoft.com/fwlink/?LinkID=398600">Add Controllers and Views</a></li>
-                <li><a href="http://go.microsoft.com/fwlink/?LinkID=398602">Add Data using EntityFramework</a></li>
-                <li><a href="http://go.microsoft.com/fwlink/?LinkID=398603">Add Authentication using Identity</a></li>
-                <li><a href="http://go.microsoft.com/fwlink/?LinkID=398606">Add real time support using SignalR</a></li>
-                <li><a href="http://go.microsoft.com/fwlink/?LinkID=398604">Add Class library</a></li>
-                <li><a href="http://go.microsoft.com/fwlink/?LinkId=518009">Add Web APIs with MVC 6</a></li>
-                <li><a href="http://go.microsoft.com/fwlink/?LinkID=517848">Add client packages using Bower</a></li>
-            </ul>
-        </div>
-
-        <div class="section last">
-            <h2>Deploy</h2>
-            <ul>
-                <li><a href="http://go.microsoft.com/fwlink/?LinkID=517851">Run your app locally</a></li>
-                <li><a href="http://go.microsoft.com/fwlink/?LinkID=517852">Run your app on ASP.NET Core 5</a></li>
-                <li><a href="http://go.microsoft.com/fwlink/?LinkID=517853">Run commands in your project.json</a></li>
-                <li><a href="http://go.microsoft.com/fwlink/?LinkID=398609">Publish to Microsoft Azure Web Sites</a></li>
-                <li><a href="http://go.microsoft.com/fwlink/?LinkId=518019">Publish to the file system</a></li>
-            </ul>
-        </div>
-
-        <div id="footer">
-            <p>We would love to hear your <a href="http://go.microsoft.com/fwlink/?LinkId=518015">feedback</a></p>
-        </div>
-    </div>
-
-</body>
-</html>
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Startup.cs b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Startup.cs
deleted file mode 100644
index ce6648c8a0..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Startup.cs
+++ /dev/null
@@ -1,83 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Threading.Tasks;
-using Microsoft.AspNet.Builder;
-using Microsoft.AspNet.Hosting;
-using Microsoft.Dnx.Runtime;
-using Microsoft.Framework.Configuration;
-using Microsoft.Framework.DependencyInjection;
-using Microsoft.Framework.Logging;
-using Microsoft.Data.Entity;
-using EFGetStarted.AspNet5.Models;
-
-namespace EFGetStarted.AspNet5
-{
-    public class Startup
-    {
-        public Startup(IHostingEnvironment env, IApplicationEnvironment appEnv)
-        {
-            // Setup configuration sources.
-            var builder = new ConfigurationBuilder(appEnv.ApplicationBasePath)
-                .AddJsonFile("config.json")
-                .AddEnvironmentVariables();
-            Configuration = builder.Build();
-        }
-
-        public IConfigurationRoot Configuration { get; set; }
-
-        // This method gets called by the runtime.
-        public void ConfigureServices(IServiceCollection services)
-        {
-            var connection = @"Server=(localdb)\mssqllocaldb;Database=EFGetStarted.AspNet5;Trusted_Connection=True;";
-
-            services.AddEntityFramework()
-                .AddSqlServer()
-                .AddDbContext<BloggingContext>(options => options.UseSqlServer(connection));
-
-            // Add MVC services to the services container.
-            services.AddMvc();
-
-            // Uncomment the following line to add Web API services which makes it easier to port Web API 2 controllers.
-            // You will also need to add the Microsoft.AspNet.Mvc.WebApiCompatShim package to the 'dependencies' section of project.json.
-            // services.AddWebApiConventions();
-        }
-
-        // Configure is called after ConfigureServices is called.
-        public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
-        {
-            loggerFactory.MinimumLevel = LogLevel.Information;
-            loggerFactory.AddConsole();
-            loggerFactory.AddDebug();
-
-            // Configure the HTTP request pipeline.
-
-            // Add the following to the request pipeline only in development environment.
-            if (env.IsDevelopment())
-            {
-                app.UseBrowserLink();
-                app.UseErrorPage();
-            }
-            else
-            {
-                // Add Error handling middleware which catches all application specific errors and
-                // send the request to the following path or controller action.
-                app.UseErrorHandler("/Home/Error");
-            }
-
-            // Add static files to the request pipeline.
-            app.UseStaticFiles();
-
-            // Add MVC to the request pipeline.
-            app.UseMvc(routes =>
-            {
-                routes.MapRoute(
-                    name: "default",
-                    template: "{controller=Home}/{action=Index}/{id?}");
-
-                // Uncomment the following line to add a route for porting Web API 2 controllers.
-                // routes.MapWebApiRoute("DefaultApi", "api/{controller}/{id?}");
-            });
-        }
-    }
-}
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/Blogs/Create.cshtml b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/Blogs/Create.cshtml
deleted file mode 100644
index 7ff32d465a..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/Blogs/Create.cshtml
+++ /dev/null
@@ -1,30 +0,0 @@
-@model EFGetStarted.AspNet5.Models.Blog
-
-@{
-    ViewBag.Title = "New Blog";
-}
-
-<h2>New Blog</h2>
-
-@using (Html.BeginForm())
-{
-    @Html.AntiForgeryToken()
-
-    <div class="form-horizontal">
-        @Html.ValidationSummary(true, "", new { @class = "text-danger" })
-        <div class="form-group">
-            @Html.LabelFor(model => model.Url, htmlAttributes: new { @class = "control-label col-md-2" })
-            <div class="col-md-10">
-                @Html.EditorFor(model => model.Url, new { htmlAttributes = new { @class = "form-control" } })
-                @Html.ValidationMessageFor(model => model.Url, "", new { @class = "text-danger" })
-            </div>
-        </div>
-        <div class="form-group">
-            <div class="col-md-offset-2 col-md-10">
-                <input type="submit" value="Create" class="btn btn-default" />
-            </div>
-        </div>
-    </div>
-}
-
-
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/Blogs/Index.cshtml b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/Blogs/Index.cshtml
deleted file mode 100644
index 80681698dd..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/Blogs/Index.cshtml
+++ /dev/null
@@ -1,30 +0,0 @@
-@model IEnumerable<EFGetStarted.AspNet5.Models.Blog>
-
-@{
-    ViewBag.Title = "Blogs";
-}
-
-<h2>Blogs</h2>
-
-<p>
-    @Html.ActionLink("Create New", "Create")
-</p>
-
-<table class="table">
-    <tr>
-        <th>Id</th>
-        <th>Url</th>
-    </tr>
-
-    @foreach (var item in Model)
-    {
-        <tr>
-            <td>
-                @Html.DisplayFor(modelItem => item.BlogId)
-            </td>
-            <td>
-                @Html.DisplayFor(modelItem => item.Url)
-            </td>
-        </tr>
-    }
-</table>
\ No newline at end of file
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/Home/About.cshtml b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/Home/About.cshtml
deleted file mode 100644
index a443e8b561..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/Home/About.cshtml
+++ /dev/null
@@ -1,7 +0,0 @@
-@{
-    ViewData["Title"] = "About";
-}
-<h2>@ViewData["Title"].</h2>
-<h3>@ViewData["Message"]</h3>
-
-<p>Use this area to provide additional information.</p>
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/Home/Contact.cshtml b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/Home/Contact.cshtml
deleted file mode 100644
index 9d10bf9082..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/Home/Contact.cshtml
+++ /dev/null
@@ -1,17 +0,0 @@
-@{
-    ViewData["Title"] = "Contact";
-}
-<h2>@ViewData["Title"].</h2>
-<h3>@ViewData["Message"]</h3>
-
-<address>
-    One Microsoft Way<br />
-    Redmond, WA 98052-6399<br />
-    <abbr title="Phone">P:</abbr>
-    425.555.0100
-</address>
-
-<address>
-    <strong>Support:</strong> <a href="mailto:Support@example.com">Support@example.com</a><br />
-    <strong>Marketing:</strong> <a href="mailto:Marketing@example.com">Marketing@example.com</a>
-</address>
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/Home/Index.cshtml b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/Home/Index.cshtml
deleted file mode 100644
index fb48af9978..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/Home/Index.cshtml
+++ /dev/null
@@ -1,104 +0,0 @@
-@{
-    ViewData["Title"] = "Home Page";
-}
-
-<div id="myCarousel" class="carousel slide" data-ride="carousel" data-interval="6000">
-    <ol class="carousel-indicators">
-        <li data-target="#myCarousel" data-slide-to="0" class="active"></li>
-        <li data-target="#myCarousel" data-slide-to="1"></li>
-        <li data-target="#myCarousel" data-slide-to="2"></li>
-        <li data-target="#myCarousel" data-slide-to="3"></li>
-    </ol>
-    <div class="carousel-inner" role="listbox">
-        <div class="item active">
-            <img src="~/images/ASP-NET-Banners-01.png" alt="ASP.NET" class="img-responsive" />
-            <div class="container">
-                <div class="carousel-caption">
-                    <p>
-                        Learn how to build ASP.NET apps that can run anywhere.
-                        <a class="btn btn-default btn-default" href="http://go.microsoft.com/fwlink/?LinkID=525028&clcid=0x409">
-                            Learn More
-                        </a>
-                    </p>
-                </div>
-            </div>
-        </div>
-        <div class="item">
-            <img src="~/images/Banner-02-VS.png" alt="Visual Studio" class="img-responsive" />
-            <div class="container">
-                <div class="carousel-caption">
-                    <p>
-                        There are powerful new features in Visual Studio for building modern web apps.
-                        <a class="btn btn-default btn-default" href="http://go.microsoft.com/fwlink/?LinkID=525030&clcid=0x409">
-                            Learn More
-                        </a>
-                    </p>
-                </div>
-            </div>
-        </div>
-        <div class="item">
-            <img src="~/images/ASP-NET-Banners-02.png" alt="Package Management" class="img-responsive" />
-            <div class="container">
-                <div class="carousel-caption">
-                    <p>
-                        Bring in libraries from NuGet, Bower, and npm, and automate tasks using Grunt or Gulp.
-                        <a class="btn btn-default btn-default" href="http://go.microsoft.com/fwlink/?LinkID=525029&clcid=0x409">
-                            Learn More
-                        </a>
-                    </p>
-                </div>
-            </div>
-        </div>
-        <div class="item">
-            <img src="~/images/Banner-01-Azure.png" alt="Microsoft Azure" class="img-responsive" />
-            <div class="container">
-                <div class="carousel-caption">
-                    <p>
-                        Learn how Microsoft's Azure cloud platform allows you to build, deploy, and scale web apps.
-                        <a class="btn btn-default btn-default" href="http://go.microsoft.com/fwlink/?LinkID=525027&clcid=0x409">
-                            Learn More
-                        </a>
-                    </p>
-                </div>
-            </div>
-        </div>
-    </div>
-</div>
-
-<div class="row">
-    <div class="col-md-3">
-        <h2>Application uses</h2>
-        <ul>
-            <li>Sample pages using ASP.NET 5 (MVC 6)</li>
-            <li><a href="http://go.microsoft.com/fwlink/?LinkId=518007">Gulp</a> and <a href="http://go.microsoft.com/fwlink/?LinkId=518004">Bower</a> for managing client-side resources</li>
-            <li>Theming using <a href="http://go.microsoft.com/fwlink/?LinkID=398939">Bootstrap</a></li>
-        </ul>
-    </div>
-    <div class="col-md-3">
-        <h2>New concepts</h2>
-        <ul>
-            <li><a href="http://go.microsoft.com/fwlink/?LinkId=518008">Conceptual overview of ASP.NET 5</a></li>
-            <li><a href="http://go.microsoft.com/fwlink/?LinkId=518008">Fundamentals in ASP.NET 5</a></li>
-            <li><a href="http://go.microsoft.com/fwlink/?LinkID=517849">Client-Side Development using npm, Bower and Gulp</a></li>
-            <li><a href="http://go.microsoft.com/fwlink/?LinkID=517850">Develop on different platforms</a></li>
-        </ul>
-    </div>
-    <div class="col-md-3">
-        <h2>Customize app</h2>
-        <ul>
-            <li><a href="http://go.microsoft.com/fwlink/?LinkID=398600">Add Controllers and Views</a></li>
-            <li><a href="http://go.microsoft.com/fwlink/?LinkID=398602">Add Data using EntityFramework</a></li>
-            <li><a href="http://go.microsoft.com/fwlink/?LinkID=398603">Add Authentication using Identity</a></li>
-            <li><a href="http://go.microsoft.com/fwlink/?LinkID=517848">Manage client-side packages using Bower/ Gulp</a></li>
-        </ul>
-    </div>
-    <div class="col-md-3">
-        <h2>Deploy</h2>
-        <ul>
-            <li><a href="http://go.microsoft.com/fwlink/?LinkID=517851">Run your app locally</a></li>
-            <li><a href="http://go.microsoft.com/fwlink/?LinkID=517852">Run your app on .NET Core</a></li>
-            <li><a href="http://go.microsoft.com/fwlink/?LinkID=517853">Run commands in your app</a></li>
-            <li><a href="http://go.microsoft.com/fwlink/?LinkID=398609">Publish to Microsoft Azure Web Apps</a></li>
-        </ul>
-    </div>
-</div>
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/Shared/Error.cshtml b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/Shared/Error.cshtml
deleted file mode 100644
index f2ee8e491d..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/Shared/Error.cshtml
+++ /dev/null
@@ -1,6 +0,0 @@
-@{
-    ViewData["Title"] = "Error";
-}
-
-<h1 class="text-danger">Error.</h1>
-<h2 class="text-danger">An error occurred while processing your request.</h2>
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/Shared/_Layout.cshtml b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/Shared/_Layout.cshtml
deleted file mode 100644
index 3af6b17689..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/Shared/_Layout.cshtml
+++ /dev/null
@@ -1,80 +0,0 @@
-<!DOCTYPE html>
-<html>
-    <head>
-        <meta charset="utf-8" />
-        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-        <title>@ViewData["Title"] - EFGetStarted.AspNet5</title>
-
-        <environment names="Development">
-            <link rel="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.css" />
-            <link rel="stylesheet" href="~/lib/bootstrap-touch-carousel/dist/css/bootstrap-touch-carousel.css" />
-            <link rel="stylesheet" href="~/css/site.css" />
-        </environment>
-        <environment names="Staging,Production">
-            <link rel="stylesheet" href="https://ajax.aspnetcdn.com/ajax/bootstrap/3.0.0/css/bootstrap.min.css"
-                  asp-fallback-href="~/lib/bootstrap/dist/css/bootstrap.min.css"
-                  asp-fallback-test-class="hidden" asp-fallback-test-property="visibility" asp-fallback-test-value="hidden" />
-            <link rel="stylesheet" href="https://ajax.aspnetcdn.com/ajax/bootstrap-touch-carousel/0.8.0/css/bootstrap-touch-carousel.css"
-                  asp-fallback-href="~/lib/bootstrap-touch-carousel/css/bootstrap-touch-carousel.css"
-                  asp-fallback-test-class="carousel-caption" asp-fallback-test-property="display" asp-fallback-test-value="none" />
-            <link rel="stylesheet" href="~/css/site.css" asp-append-version="true" />
-        </environment>
-    </head>
-    <body>
-        <div class="navbar navbar-inverse navbar-fixed-top">
-            <div class="container">
-                <div class="navbar-header">
-                    <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
-                        <span class="icon-bar"></span>
-                        <span class="icon-bar"></span>
-                        <span class="icon-bar"></span>
-                    </button>
-                    <a asp-controller="Home" asp-action="Index" class="navbar-brand">EFGetStarted.AspNet5</a>
-                </div>
-                <div class="navbar-collapse collapse">
-                    <ul class="nav navbar-nav">
-                        <li><a asp-controller="Home" asp-action="Index">Home</a></li>
-                        <li><a asp-controller="Home" asp-action="About">About</a></li>
-                        <li><a asp-controller="Home" asp-action="Contact">Contact</a></li>
-                    </ul>
-                </div>
-            </div>
-        </div>
-        <div class="container body-content">
-            @RenderBody()
-            <hr />
-            <footer>
-                <p>&copy; 2015 - EFGetStarted.AspNet5</p>
-            </footer>
-        </div>
-
-        <environment names="Development">
-            <script src="~/lib/jquery/dist/jquery.js"></script>
-            <script src="~/lib/bootstrap/dist/js/bootstrap.js"></script>
-            <script src="~/lib/hammer.js/hammer.js"></script>
-            <script src="~/lib/bootstrap-touch-carousel/dist/js/bootstrap-touch-carousel.js"></script>
-            <script src="~/js/site.js" asp-append-version="true"></script>
-        </environment>
-        <environment names="Staging,Production">
-            <script src="https://ajax.aspnetcdn.com/ajax/jquery/jquery-2.1.4.min.js"
-                    asp-fallback-src="~/lib/jquery/dist/jquery.min.js"
-                    asp-fallback-test="window.jQuery">
-            </script>
-            <script src="https://ajax.aspnetcdn.com/ajax/bootstrap/3.0.0/bootstrap.min.js"
-                    asp-fallback-src="~/lib/bootstrap/dist/js/bootstrap.min.js"
-                    asp-fallback-test="window.jQuery && window.jQuery.fn && window.jQuery.fn.modal">
-            </script>
-            <script src="https://ajax.aspnetcdn.com/ajax/hammer.js/2.0.4/hammer.min.js"
-                    asp-fallback-src="~/lib/hammer.js/hammer.js"
-                    asp-fallback-test="window.Hammer">
-            </script>
-            <script src="https://ajax.aspnetcdn.com/ajax/bootstrap-touch-carousel/0.8.0/js/bootstrap-touch-carousel.js"
-                    asp-fallback-src="~/lib/bootstrap-touch-carousel/dist/js/bootstrap-touch-carousel.js"
-                    asp-fallback-test="window.Hammer && window.Hammer.Instance">
-            </script>
-            <script src="~/js/site.js" asp-append-version="true"></script>
-        </environment>
-
-        @RenderSection("scripts", required: false)
-    </body>
-</html>
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/_ViewImports.cshtml b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/_ViewImports.cshtml
deleted file mode 100644
index 0aec87b6d4..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/_ViewImports.cshtml
+++ /dev/null
@@ -1,2 +0,0 @@
-@using EFGetStarted.AspNet5
-@addTagHelper "*, Microsoft.AspNet.Mvc.TagHelpers"
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/_ViewStart.cshtml b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/_ViewStart.cshtml
deleted file mode 100644
index 6e88aa3262..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/Views/_ViewStart.cshtml
+++ /dev/null
@@ -1,3 +0,0 @@
-@{
-    Layout = "_Layout";
-}
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/bower.json b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/bower.json
deleted file mode 100644
index 64bdb4f02e..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/bower.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
-  "name": "ASP.NET",
-  "private": true,
-  "dependencies": {
-    "bootstrap": "3.0.0",
-    "bootstrap-touch-carousel": "0.8.0",
-    "hammer.js": "2.0.4",
-    "jquery": "2.1.4",
-    "jquery-validation": "1.11.1",
-    "jquery-validation-unobtrusive": "3.2.2"
-  }
-}
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/config.json b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/config.json
deleted file mode 100644
index 69a88e3b65..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/config.json
+++ /dev/null
@@ -1 +0,0 @@
-{}
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/gulpfile.js b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/gulpfile.js
deleted file mode 100644
index 8b9226ddaa..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/gulpfile.js
+++ /dev/null
@@ -1,45 +0,0 @@
-/// <binding Clean='clean' />
-
-var gulp = require("gulp"),
-    rimraf = require("rimraf"),
-    concat = require("gulp-concat"),
-    cssmin = require("gulp-cssmin"),
-    uglify = require("gulp-uglify"),
-    project = require("./project.json");
-
-var paths = {
-    webroot: "./" + project.webroot + "/"
-};
-
-paths.js = paths.webroot + "js/**/*.js";
-paths.minJs = paths.webroot + "js/**/*.min.js";
-paths.css = paths.webroot + "css/**/*.css";
-paths.minCss = paths.webroot + "css/**/*.min.css";
-paths.concatJsDest = paths.webroot + "js/site.min.js";
-paths.concatCssDest = paths.webroot + "css/site.min.css";
-
-gulp.task("clean:js", function (cb) {
-    rimraf(paths.concatJsDest, cb);
-});
-
-gulp.task("clean:css", function (cb) {
-    rimraf(paths.concatCssDest, cb);
-});
-
-gulp.task("clean", ["clean:js", "clean:css"]);
-
-gulp.task("min:js", function () {
-    gulp.src([paths.js, "!" + paths.minJs], { base: "." })
-        .pipe(concat(paths.concatJsDest))
-        .pipe(uglify())
-        .pipe(gulp.dest("."));
-});
-
-gulp.task("min:css", function () {
-    gulp.src([paths.css, "!" + paths.minCss])
-        .pipe(concat(paths.concatCssDest))
-        .pipe(cssmin())
-        .pipe(gulp.dest("."));
-});
-
-gulp.task("min", ["min:js", "min:css"]);
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/hosting.ini b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/hosting.ini
deleted file mode 100644
index 126132d474..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/hosting.ini
+++ /dev/null
@@ -1,2 +0,0 @@
-server=Microsoft.AspNet.Server.WebListener
-server.urls=http://localhost:5000
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/package.json b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/package.json
deleted file mode 100644
index 2d2c56d61d..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/package.json
+++ /dev/null
@@ -1,11 +0,0 @@
-{
-  "name": "ASP.NET",
-  "version": "0.0.0",
-  "devDependencies": {
-    "gulp": "3.8.11",
-    "gulp-concat": "2.5.2",
-    "gulp-cssmin": "0.1.7",
-    "gulp-uglify": "1.2.0",
-    "rimraf": "2.2.8"
-  }
-}
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/project.json b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/project.json
deleted file mode 100644
index 095f5cdc9d..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/project.json
+++ /dev/null
@@ -1,47 +0,0 @@
-{
-  "webroot": "wwwroot",
-  "version": "1.0.0-*",
-
-  "dependencies": {
-    "EntityFramework.Commands": "7.0.0-beta7",
-    "EntityFramework.SqlServer": "7.0.0-beta7",
-    "Microsoft.AspNet.Diagnostics": "1.0.0-beta7",
-    "Microsoft.AspNet.Mvc": "6.0.0-beta7",
-    "Microsoft.AspNet.Mvc.TagHelpers": "6.0.0-beta7",
-    "Microsoft.AspNet.Server.IIS": "1.0.0-beta7",
-    "Microsoft.AspNet.Server.WebListener": "1.0.0-beta7",
-    "Microsoft.AspNet.StaticFiles": "1.0.0-beta7",
-    "Microsoft.AspNet.Tooling.Razor": "1.0.0-beta7",
-    "Microsoft.Framework.Configuration.Json": "1.0.0-beta7",
-    "Microsoft.Framework.Logging": "1.0.0-beta7",
-    "Microsoft.Framework.Logging.Console": "1.0.0-beta7",
-    "Microsoft.Framework.Logging.Debug": "1.0.0-beta7",
-    "Microsoft.VisualStudio.Web.BrowserLink.Loader": "14.0.0-beta7"
-  },
-
-  "commands": {
-    "web": "Microsoft.AspNet.Hosting --config hosting.ini",
-    "ef": "EntityFramework.Commands"
-  },
-
-  "frameworks": {
-    "dnx451": { },
-    "dnxcore50": { }
-  },
-
-  "exclude": [
-    "wwwroot",
-    "node_modules",
-    "bower_components"
-  ],
-  "publishExclude": [
-    "node_modules",
-    "bower_components",
-    "**.xproj",
-    "**.user",
-    "**.vspscc"
-  ],
-  "scripts": {
-    "prepublish": [ "npm install", "bower install", "gulp clean", "gulp min" ]
-  }
-}
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/_references.js b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/_references.js
deleted file mode 100644
index 555e65891c..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/_references.js
+++ /dev/null
@@ -1,9 +0,0 @@
-/// <autosync enabled="true" />
-/// <reference path="../gulpfile.js" />
-/// <reference path="lib/jquery-validation-unobtrusive/jquery.validate.unobtrusive.js" />
-/// <reference path="lib/jquery-validation/jquery.validate.js" />
-/// <reference path="lib/jquery/dist/jquery.js" />
-/// <reference path="lib/hammer.js/hammer.js" />
-/// <reference path="lib/bootstrap/dist/js/bootstrap.js" />
-/// <reference path="lib/bootstrap-touch-carousel/dist/js/bootstrap-touch-carousel.js" />
-/// <reference path="js/site.js" />
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/css/site.css b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/css/site.css
deleted file mode 100644
index db09436e96..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/css/site.css
+++ /dev/null
@@ -1,34 +0,0 @@
-body {
-    padding-top: 50px;
-    padding-bottom: 20px;
-}
-
-/* Wrapping element */
-/* Set some basic padding to keep content from hitting the edges */
-.body-content {
-    padding-left: 15px;
-    padding-right: 15px;
-}
-
-/* Set widths on the form inputs since otherwise they're 100% wide */
-input,
-select,
-textarea {
-    max-width: 280px;
-}
-
-/* Carousel */
-.carousel-caption {
-    z-index: 10 !important;
-}
-
-    .carousel-caption p {
-        font-size: 20px;
-        line-height: 1.4;
-    }
-
-@media (min-width: 768px) {
-    .carousel-caption {
-        z-index: 10 !important;
-    }
-}
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/images/ASP-NET-Banners-01.png b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/images/ASP-NET-Banners-01.png
deleted file mode 100644
index ad3c267c7d..0000000000
Binary files a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/images/ASP-NET-Banners-01.png and /dev/null differ
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/images/ASP-NET-Banners-02.png b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/images/ASP-NET-Banners-02.png
deleted file mode 100644
index 16c37fc55f..0000000000
Binary files a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/images/ASP-NET-Banners-02.png and /dev/null differ
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/images/Banner-01-Azure.png b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/images/Banner-01-Azure.png
deleted file mode 100644
index 59fb923e05..0000000000
Binary files a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/images/Banner-01-Azure.png and /dev/null differ
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/images/Banner-02-VS.png b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/images/Banner-02-VS.png
deleted file mode 100644
index c9f461137e..0000000000
Binary files a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/images/Banner-02-VS.png and /dev/null differ
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/js/site.js b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/js/site.js
deleted file mode 100644
index 82ecce7b4a..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/js/site.js
+++ /dev/null
@@ -1 +0,0 @@
-// Write your Javascript code.
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/web.config b/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/web.config
deleted file mode 100644
index 8e3f2a69d7..0000000000
--- a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/web.config
+++ /dev/null
@@ -1,11 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<configuration>
-  <system.webServer>
-    <handlers>
-      <remove name="ExtensionlessUrlHandler-Integrated-4.0" />
-      <remove name="OPTIONSVerbHandler" />
-      <remove name="TRACEVerbHandler" />
-      <add name="ExtensionlessUrlHandler-Integrated-4.0" path="*." verb="*" type="System.Web.Handlers.TransferRequestHandler" preCondition="integratedMode,runtimeVersionv4.0" />
-    </handlers>
-  </system.webServer>
-</configuration>
diff --git a/docs/getting-started/full-dotnet.rst b/docs/getting-started/full-dotnet.rst
deleted file mode 100644
index 9e54287bd9..0000000000
--- a/docs/getting-started/full-dotnet.rst
+++ /dev/null
@@ -1,99 +0,0 @@
-.. include:: /stub-topic.txt
-
-Getting Started on Full .NET (Console, WinForms, WPF, etc.)
-===========================================================
-
-In this walkthrough, you will build a console application that performs basic data access using Entity Framework.
-
-In this article:
-	- `Ensure NuGet 2.8.6 or later`_
-	- `Create a new project`_
-	- `Install Entity Framework`_
-	- `Create your model`_
-	- `Create your database`_
-	- `Use your model`_
-
-`View this article's samples on GitHub <https://github.com/aspnet/EntityFramework.Docs/tree/master/docs/getting-started/full-dotnet/sample>`_.
-
-.. note::
-    This walkthrough uses EF 7.0.0-beta7 which is the latest pre-release available on NuGet.org.
-
-    You can find nightly builds of the EF7 code base hosted on https://www.myget.org/F/aspnetvnext/api/v2/ but the code base is rapidly changing and we do not maintain up-to-date documentation for getting started.
-
-Ensure NuGet 2.8.6 or later
----------------------------
-
-Installing EF7 requires NuGet 2.8.6 (or higher). Make sure you restart Visual Studio after installing the update.
-
-- **Visual Studio 2015** - No updates needed, a compatible version of NuGet is included.
-- **Visual Studio 2013** - `Install the latest NuGet for VS2013 <https://visualstudiogallery.msdn.microsoft.com/4ec1526c-4a8c-4a84-b702-b21a8f5293ca>`_.
-- **Visual Studio 2012** - `Install the latest NuGet for VS2012 <https://visualstudiogallery.msdn.microsoft.com/27077b70-9dad-4c64-adcf-c7cf6bc9970c>`_.
-
-.. note::
-    NuGet version numbers can be confusing, while the required release is branded 2.8.6 the product version of the extension is 2.8.60610.xxx.
-
-Create a new project
---------------------
-
-* Open Visual Studio (this walkthrough uses 2015 but you can use any version from 2012 onwards)
-* :menuselection:`File --> New --> Project...`
-* From the left menu select :menuselection:`Templates --> Visual C# --> Windows`
-* Select the **Console Application** project template
-* Ensure you are targeting .NET 4.5 or later
-* Give the project a name and click **OK**
-
-Install Entity Framework
-----------------------------------------
-To use EF7 you install the package for the database provider(s) you want to target. This walkthrough uses SQL Server. For a list of available providers see :doc:`/providers/index`.
-
-* :menuselection:`Tools --> NuGet Package Manager --> Package Manager Console`
-* Run ``Install-Package EntityFramework.SqlServer –Pre``
-
-Later in this walkthrough we will also be using some Entity Framework commands to maintain the database. So we will install the commands package as well.
-
-* Run ``Install-Package EntityFramework.Commands –Pre``
-
-Create your model
------------------
-
-Now it's time to define a context and entity classes that make up your model.
-
-* :menuselection:`Project --> Add Class...`
-* Enter *Model.cs* as the name and click **OK**
-* Replace the contents of the file with the following code
-
-.. note:: Notice the ``OnConfiguring`` method (new in EF7) that is used to specify the provider to use and, optionally, other configuration too.
-
-.. literalinclude:: full-dotnet/sample/EFGetStarted.ConsoleApp/Model.cs
-        :language: c#
-        :linenos:
-
-Create your database
---------------------
-
-Now that you have a model, you can use migrations to create a database for you.
-
-* :menuselection:`Tools –> NuGet Package Manager –> Package Manager Console`
-* Run ``Add-Migration MyFirstMigration`` to scaffold a migration to create the initial set of tables for your model.
-* Run ``Update-Database`` to apply the new migration to the database. Because your database doesn't exist yet, it will be created for you before the migration is applied.
-
-.. tip::
-    If you make future changes to your model, you can use the ``Add-Migration`` command to scaffold a new migration to apply the corresponding changes to the database. Once you have checked the scaffolded code (and made any required changes), you can use the ``Update-Database`` command to apply the changes to the database.
-
-Use your model
---------------
-
-You can now use your model to perform data access.
-
-* Open *Program.cs*
-* Replace the contents of the file with the following code
-
-.. literalinclude:: full-dotnet/sample/EFGetStarted.ConsoleApp/Program.cs
-        :language: c#
-        :linenos:
-
-* :menuselection:`Debug --> Start Without Debugging`
-
-You will see that one blog is saved to the database and then the details of all blogs are printed to the console.
-
-.. image:: full-dotnet/_static/console.png
diff --git a/docs/getting-started/full-dotnet/_static/console.png b/docs/getting-started/full-dotnet/_static/console.png
deleted file mode 100644
index b9fb66616e..0000000000
Binary files a/docs/getting-started/full-dotnet/_static/console.png and /dev/null differ
diff --git a/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp.sln b/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp.sln
deleted file mode 100644
index 0cce1b63c2..0000000000
--- a/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp.sln
+++ /dev/null
@@ -1,22 +0,0 @@
-
-Microsoft Visual Studio Solution File, Format Version 12.00
-# Visual Studio 14
-VisualStudioVersion = 14.0.23107.0
-MinimumVisualStudioVersion = 10.0.40219.1
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "EFGetStarted.ConsoleApp", "EFGetStarted.ConsoleApp\EFGetStarted.ConsoleApp.csproj", "{6C164835-C07D-46D1-AB0B-62E108449484}"
-EndProject
-Global
-	GlobalSection(SolutionConfigurationPlatforms) = preSolution
-		Debug|Any CPU = Debug|Any CPU
-		Release|Any CPU = Release|Any CPU
-	EndGlobalSection
-	GlobalSection(ProjectConfigurationPlatforms) = postSolution
-		{6C164835-C07D-46D1-AB0B-62E108449484}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{6C164835-C07D-46D1-AB0B-62E108449484}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{6C164835-C07D-46D1-AB0B-62E108449484}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{6C164835-C07D-46D1-AB0B-62E108449484}.Release|Any CPU.Build.0 = Release|Any CPU
-	EndGlobalSection
-	GlobalSection(SolutionProperties) = preSolution
-		HideSolutionNode = FALSE
-	EndGlobalSection
-EndGlobal
diff --git a/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/App.config b/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/App.config
deleted file mode 100644
index 32417e8705..0000000000
--- a/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/App.config
+++ /dev/null
@@ -1,18 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<configuration>
-    <startup> 
-        <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6" />
-    </startup>
-  <runtime>
-    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
-      <dependentAssembly>
-        <assemblyIdentity name="System.Collections.Immutable" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
-        <bindingRedirect oldVersion="0.0.0.0-1.1.37.0" newVersion="1.1.37.0" />
-      </dependentAssembly>
-      <dependentAssembly>
-        <assemblyIdentity name="System.Threading" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
-        <bindingRedirect oldVersion="0.0.0.0-4.0.10.0" newVersion="4.0.10.0" />
-      </dependentAssembly>
-    </assemblyBinding>
-  </runtime>
-</configuration>
diff --git a/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/EFGetStarted.ConsoleApp.csproj b/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/EFGetStarted.ConsoleApp.csproj
deleted file mode 100644
index 7171ca3b92..0000000000
--- a/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/EFGetStarted.ConsoleApp.csproj
+++ /dev/null
@@ -1,166 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<Project ToolsVersion="14.0" DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
-  <Import Project="$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props" Condition="Exists('$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props')" />
-  <PropertyGroup>
-    <Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>
-    <Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>
-    <ProjectGuid>{6C164835-C07D-46D1-AB0B-62E108449484}</ProjectGuid>
-    <OutputType>Exe</OutputType>
-    <AppDesignerFolder>Properties</AppDesignerFolder>
-    <RootNamespace>EFGetStarted.ConsoleApp</RootNamespace>
-    <AssemblyName>EFGetStarted.ConsoleApp</AssemblyName>
-    <TargetFrameworkVersion>v4.6</TargetFrameworkVersion>
-    <FileAlignment>512</FileAlignment>
-    <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
-  </PropertyGroup>
-  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
-    <PlatformTarget>AnyCPU</PlatformTarget>
-    <DebugSymbols>true</DebugSymbols>
-    <DebugType>full</DebugType>
-    <Optimize>false</Optimize>
-    <OutputPath>bin\Debug\</OutputPath>
-    <DefineConstants>DEBUG;TRACE</DefineConstants>
-    <ErrorReport>prompt</ErrorReport>
-    <WarningLevel>4</WarningLevel>
-  </PropertyGroup>
-  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
-    <PlatformTarget>AnyCPU</PlatformTarget>
-    <DebugType>pdbonly</DebugType>
-    <Optimize>true</Optimize>
-    <OutputPath>bin\Release\</OutputPath>
-    <DefineConstants>TRACE</DefineConstants>
-    <ErrorReport>prompt</ErrorReport>
-    <WarningLevel>4</WarningLevel>
-  </PropertyGroup>
-  <ItemGroup>
-    <Reference Include="EntityFramework.Commands, Version=7.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\EntityFramework.Commands.7.0.0-beta7\lib\net45\EntityFramework.Commands.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="EntityFramework.Core, Version=7.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\EntityFramework.Core.7.0.0-beta7\lib\net45\EntityFramework.Core.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="EntityFramework.Relational, Version=7.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\EntityFramework.Relational.7.0.0-beta7\lib\net45\EntityFramework.Relational.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="EntityFramework.Relational.Design, Version=7.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\EntityFramework.Relational.Design.7.0.0-beta7\lib\net45\EntityFramework.Relational.Design.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="EntityFramework.SqlServer, Version=7.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\EntityFramework.SqlServer.7.0.0-beta7\lib\net45\EntityFramework.SqlServer.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Microsoft.AspNet.Razor, Version=4.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\Microsoft.AspNet.Razor.4.0.0-beta7\lib\net45\Microsoft.AspNet.Razor.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Microsoft.CodeAnalysis, Version=1.1.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL">
-      <HintPath>..\packages\Microsoft.CodeAnalysis.Common.1.1.0-beta1-20150812-01\lib\net45\Microsoft.CodeAnalysis.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Microsoft.CodeAnalysis.CSharp, Version=1.1.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL">
-      <HintPath>..\packages\Microsoft.CodeAnalysis.CSharp.1.1.0-beta1-20150812-01\lib\net45\Microsoft.CodeAnalysis.CSharp.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Microsoft.Framework.Caching.Abstractions, Version=1.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\Microsoft.Framework.Caching.Abstractions.1.0.0-beta7\lib\net45\Microsoft.Framework.Caching.Abstractions.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Microsoft.Framework.Caching.Memory, Version=1.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\Microsoft.Framework.Caching.Memory.1.0.0-beta7\lib\net45\Microsoft.Framework.Caching.Memory.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Microsoft.Framework.Configuration, Version=1.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\Microsoft.Framework.Configuration.1.0.0-beta7\lib\net45\Microsoft.Framework.Configuration.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Microsoft.Framework.Configuration.Abstractions, Version=1.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\Microsoft.Framework.Configuration.Abstractions.1.0.0-beta7\lib\net45\Microsoft.Framework.Configuration.Abstractions.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Microsoft.Framework.Configuration.Binder, Version=1.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\Microsoft.Framework.Configuration.Binder.1.0.0-beta7\lib\net45\Microsoft.Framework.Configuration.Binder.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Microsoft.Framework.DependencyInjection, Version=1.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\Microsoft.Framework.DependencyInjection.1.0.0-beta7\lib\net45\Microsoft.Framework.DependencyInjection.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Microsoft.Framework.DependencyInjection.Abstractions, Version=1.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\Microsoft.Framework.DependencyInjection.Abstractions.1.0.0-beta7\lib\net45\Microsoft.Framework.DependencyInjection.Abstractions.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Microsoft.Framework.Logging, Version=1.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\Microsoft.Framework.Logging.1.0.0-beta7\lib\net45\Microsoft.Framework.Logging.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Microsoft.Framework.Logging.Abstractions, Version=1.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\Microsoft.Framework.Logging.Abstractions.1.0.0-beta7\lib\net45\Microsoft.Framework.Logging.Abstractions.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Microsoft.Framework.OptionsModel, Version=1.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\Microsoft.Framework.OptionsModel.1.0.0-beta7\lib\net45\Microsoft.Framework.OptionsModel.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Remotion.Linq, Version=2.0.0.0, Culture=neutral, PublicKeyToken=fee00910d6e5f53b, processorArchitecture=MSIL">
-      <HintPath>..\packages\Remotion.Linq.2.0.0-beta-002\lib\net45\Remotion.Linq.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="System" />
-    <Reference Include="System.Collections.Concurrent" />
-    <Reference Include="System.Collections.Immutable, Version=1.1.37.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a, processorArchitecture=MSIL">
-      <HintPath>..\packages\System.Collections.Immutable.1.1.37-beta-23109\lib\dotnet\System.Collections.Immutable.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="System.ComponentModel.DataAnnotations" />
-    <Reference Include="System.Core" />
-    <Reference Include="System.Interactive.Async, Version=1.2.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL">
-      <HintPath>..\packages\Ix-Async.1.2.5\lib\net45\System.Interactive.Async.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="System.Reflection.Metadata, Version=1.1.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a, processorArchitecture=MSIL">
-      <HintPath>..\packages\System.Reflection.Metadata.1.1.0-alpha-00009\lib\portable-net45+win8\System.Reflection.Metadata.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="System.Threading, Version=4.0.10.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a, processorArchitecture=MSIL">
-      <HintPath>..\packages\System.Threading.4.0.10-beta-22605\lib\net45\System.Threading.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="System.Transactions" />
-    <Reference Include="System.Xml.Linq" />
-    <Reference Include="System.Data.DataSetExtensions" />
-    <Reference Include="Microsoft.CSharp" />
-    <Reference Include="System.Data" />
-    <Reference Include="System.Net.Http" />
-    <Reference Include="System.Xml" />
-  </ItemGroup>
-  <ItemGroup>
-    <Compile Include="Migrations\20150630215833_MyFirstMigration.cs" />
-    <Compile Include="Migrations\20150630215833_MyFirstMigration.designer.cs">
-      <DependentUpon>20150630215833_MyFirstMigration.cs</DependentUpon>
-    </Compile>
-    <Compile Include="Migrations\BloggingContextModelSnapshot.cs" />
-    <Compile Include="Model.cs" />
-    <Compile Include="Program.cs" />
-    <Compile Include="Properties\AssemblyInfo.cs" />
-  </ItemGroup>
-  <ItemGroup>
-    <None Include="App.config" />
-    <None Include="packages.config" />
-  </ItemGroup>
-  <ItemGroup>
-    <Analyzer Include="..\packages\Microsoft.CodeAnalysis.Analyzers.1.1.0-beta1-20150812-01\analyzers\dotnet\cs\Microsoft.CodeAnalysis.Analyzers.dll" />
-    <Analyzer Include="..\packages\Microsoft.CodeAnalysis.Analyzers.1.1.0-beta1-20150812-01\analyzers\dotnet\cs\Microsoft.CodeAnalysis.CSharp.Analyzers.dll" />
-  </ItemGroup>
-  <Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />
-  <!-- To modify your build process, add your task inside one of the targets below and uncomment it.
-       Other similar extension points exist, see Microsoft.Common.targets.
-  <Target Name="BeforeBuild">
-  </Target>
-  <Target Name="AfterBuild">
-  </Target>
-  -->
-</Project>
\ No newline at end of file
diff --git a/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/Migrations/20150630215833_MyFirstMigration.Designer.cs b/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/Migrations/20150630215833_MyFirstMigration.Designer.cs
deleted file mode 100644
index 48776cd78c..0000000000
--- a/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/Migrations/20150630215833_MyFirstMigration.Designer.cs
+++ /dev/null
@@ -1,58 +0,0 @@
-using System;
-using Microsoft.Data.Entity;
-using Microsoft.Data.Entity.Infrastructure;
-using Microsoft.Data.Entity.Metadata;
-using Microsoft.Data.Entity.Migrations;
-using EFGetStarted.ConsoleApp;
-using Microsoft.Data.Entity.SqlServer.Metadata;
-
-namespace EFGetStarted.ConsoleApp.Migrations
-{
-    [DbContext(typeof(BloggingContext))]
-    partial class MyFirstMigration
-    {
-        public override string Id
-        {
-            get { return "20150630215833_MyFirstMigration"; }
-        }
-
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-            modelBuilder
-                .Annotation("ProductVersion", "7.0.0-beta7-15540")
-                .Annotation("SqlServer:ValueGenerationStrategy", SqlServerIdentityStrategy.IdentityColumn);
-
-            modelBuilder.Entity("EFGetStarted.ConsoleApp.Blog", b =>
-                {
-                    b.Property<int>("BlogId")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Url")
-                        .Required();
-
-                    b.Key("BlogId");
-                });
-
-            modelBuilder.Entity("EFGetStarted.ConsoleApp.Post", b =>
-                {
-                    b.Property<int>("PostId")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BlogId");
-
-                    b.Property<string>("Content");
-
-                    b.Property<string>("Title");
-
-                    b.Key("PostId");
-                });
-
-            modelBuilder.Entity("EFGetStarted.ConsoleApp.Post", b =>
-                {
-                    b.Reference("EFGetStarted.ConsoleApp.Blog")
-                        .InverseCollection()
-                        .ForeignKey("BlogId");
-                });
-        }
-    }
-}
diff --git a/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/Migrations/20150630215833_MyFirstMigration.cs b/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/Migrations/20150630215833_MyFirstMigration.cs
deleted file mode 100644
index 68a6fecf64..0000000000
--- a/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/Migrations/20150630215833_MyFirstMigration.cs
+++ /dev/null
@@ -1,51 +0,0 @@
-using System;
-using System.Collections.Generic;
-using Microsoft.Data.Entity.Migrations;
-using Microsoft.Data.Entity.SqlServer.Metadata;
-
-namespace EFGetStarted.ConsoleApp.Migrations
-{
-    public partial class MyFirstMigration : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.CreateTable(
-                name: "Blog",
-                columns: table => new
-                {
-                    BlogId = table.Column<int>(isNullable: false)
-                        .Annotation("SqlServer:ValueGenerationStrategy", SqlServerIdentityStrategy.IdentityColumn),
-                    Url = table.Column<string>(isNullable: false)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_Blog", x => x.BlogId);
-                });
-            migrationBuilder.CreateTable(
-                name: "Post",
-                columns: table => new
-                {
-                    PostId = table.Column<int>(isNullable: false)
-                        .Annotation("SqlServer:ValueGenerationStrategy", SqlServerIdentityStrategy.IdentityColumn),
-                    BlogId = table.Column<int>(isNullable: false),
-                    Content = table.Column<string>(isNullable: true),
-                    Title = table.Column<string>(isNullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_Post", x => x.PostId);
-                    table.ForeignKey(
-                        name: "FK_Post_Blog_BlogId",
-                        column: x => x.BlogId,
-                        principalTable: "Blog",
-                        principalColumn: "BlogId");
-                });
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropTable("Post");
-            migrationBuilder.DropTable("Blog");
-        }
-    }
-}
diff --git a/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/Migrations/BloggingContextModelSnapshot.cs b/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/Migrations/BloggingContextModelSnapshot.cs
deleted file mode 100644
index b6ba6a68fa..0000000000
--- a/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/Migrations/BloggingContextModelSnapshot.cs
+++ /dev/null
@@ -1,53 +0,0 @@
-using System;
-using Microsoft.Data.Entity;
-using Microsoft.Data.Entity.Infrastructure;
-using Microsoft.Data.Entity.Metadata;
-using Microsoft.Data.Entity.Migrations;
-using EFGetStarted.ConsoleApp;
-using Microsoft.Data.Entity.SqlServer.Metadata;
-
-namespace EFGetStarted.ConsoleApp.Migrations
-{
-    [DbContext(typeof(BloggingContext))]
-    partial class BloggingContextModelSnapshot : ModelSnapshot
-    {
-        protected override void BuildModel(ModelBuilder modelBuilder)
-        {
-            modelBuilder
-                .Annotation("ProductVersion", "7.0.0-beta7-15540")
-                .Annotation("SqlServer:ValueGenerationStrategy", SqlServerIdentityStrategy.IdentityColumn);
-
-            modelBuilder.Entity("EFGetStarted.ConsoleApp.Blog", b =>
-                {
-                    b.Property<int>("BlogId")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Url")
-                        .Required();
-
-                    b.Key("BlogId");
-                });
-
-            modelBuilder.Entity("EFGetStarted.ConsoleApp.Post", b =>
-                {
-                    b.Property<int>("PostId")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BlogId");
-
-                    b.Property<string>("Content");
-
-                    b.Property<string>("Title");
-
-                    b.Key("PostId");
-                });
-
-            modelBuilder.Entity("EFGetStarted.ConsoleApp.Post", b =>
-                {
-                    b.Reference("EFGetStarted.ConsoleApp.Blog")
-                        .InverseCollection()
-                        .ForeignKey("BlogId");
-                });
-        }
-    }
-}
diff --git a/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/Model.cs b/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/Model.cs
deleted file mode 100644
index 5ddeb656f0..0000000000
--- a/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/Model.cs
+++ /dev/null
@@ -1,49 +0,0 @@
-using Microsoft.Data.Entity;
-using System.Collections.Generic;
-
-namespace EFGetStarted.ConsoleApp
-{
-    public class BloggingContext : DbContext
-    {
-        public DbSet<Blog> Blogs { get; set; }
-        public DbSet<Post> Posts { get; set; }
-
-        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
-        {
-            // Visual Studio 2015 | Use the LocalDb 12 instance created by Visual Studio
-            optionsBuilder.UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFGetStarted.ConsoleApp;Trusted_Connection=True;");
-
-            // Visual Studio 2013 | Use the LocalDb 11 instance created by Visual Studio
-            // optionsBuilder.UseSqlServer(@"Server=(localdb)\v11.0;Database=EFGetStarted.ConsoleApp;Trusted_Connection=True;");
-
-            // Visual Studio 2012 | Use the SQL Express instance created by Visual Studio
-            // optionsBuilder.UseSqlServer(@"Server=.\SQLEXPRESS;Database=EFGetStarted.ConsoleApp;Trusted_Connection=True;");
-        }
-
-        protected override void OnModelCreating(ModelBuilder modelBuilder)
-        {
-            // Make Blog.Url required
-            modelBuilder.Entity<Blog>()
-                .Property(b => b.Url)
-                .Required();
-        }
-    }
-
-    public class Blog
-    {
-        public int BlogId { get; set; }
-        public string Url { get; set; }
-
-        public List<Post> Posts { get; set; }
-    }
-
-    public class Post
-    {
-        public int PostId { get; set; }
-        public string Title { get; set; }
-        public string Content { get; set; }
-
-        public int BlogId { get; set; }
-        public Blog Blog { get; set; }
-    }
-}
diff --git a/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/Program.cs b/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/Program.cs
deleted file mode 100644
index c9adfd84b6..0000000000
--- a/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/Program.cs
+++ /dev/null
@@ -1,24 +0,0 @@
-using System;
-
-namespace EFGetStarted.ConsoleApp
-{
-    class Program
-    {
-        static void Main(string[] args)
-        {
-            using (var db = new BloggingContext())
-            {
-                db.Blogs.Add(new Blog { Url = "http://blogs.msdn.com/adonet" });
-                var count = db.SaveChanges();
-                Console.WriteLine("{0} records saved to database", count);
-
-                Console.WriteLine();
-                Console.WriteLine("All blogs in database:");
-                foreach (var blog in db.Blogs)
-                {
-                    Console.WriteLine(" - {0}", blog.Url);
-                }
-            }
-        }
-    }
-}
diff --git a/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/Properties/AssemblyInfo.cs b/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/Properties/AssemblyInfo.cs
deleted file mode 100644
index 87b6a5e768..0000000000
--- a/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/Properties/AssemblyInfo.cs
+++ /dev/null
@@ -1,36 +0,0 @@
-using System.Reflection;
-using System.Runtime.CompilerServices;
-using System.Runtime.InteropServices;
-
-// General Information about an assembly is controlled through the following 
-// set of attributes. Change these attribute values to modify the information
-// associated with an assembly.
-[assembly: AssemblyTitle("EFGetStarted.ConsoleApp")]
-[assembly: AssemblyDescription("")]
-[assembly: AssemblyConfiguration("")]
-[assembly: AssemblyCompany("")]
-[assembly: AssemblyProduct("EFGetStarted.ConsoleApp")]
-[assembly: AssemblyCopyright("Copyright ©  2015")]
-[assembly: AssemblyTrademark("")]
-[assembly: AssemblyCulture("")]
-
-// Setting ComVisible to false makes the types in this assembly not visible 
-// to COM components.  If you need to access a type in this assembly from 
-// COM, set the ComVisible attribute to true on that type.
-[assembly: ComVisible(false)]
-
-// The following GUID is for the ID of the typelib if this project is exposed to COM
-[assembly: Guid("6c164835-c07d-46d1-ab0b-62e108449484")]
-
-// Version information for an assembly consists of the following four values:
-//
-//      Major Version
-//      Minor Version 
-//      Build Number
-//      Revision
-//
-// You can specify all the values or you can default the Build and Revision Numbers 
-// by using the '*' as shown below:
-// [assembly: AssemblyVersion("1.0.*")]
-[assembly: AssemblyVersion("1.0.0.0")]
-[assembly: AssemblyFileVersion("1.0.0.0")]
diff --git a/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/packages.config b/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/packages.config
deleted file mode 100644
index 2b4978be26..0000000000
--- a/docs/getting-started/full-dotnet/sample/EFGetStarted.ConsoleApp/packages.config
+++ /dev/null
@@ -1,35 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<packages>
-  <package id="EntityFramework.Commands" version="7.0.0-beta7" targetFramework="net46" />
-  <package id="EntityFramework.Core" version="7.0.0-beta7" targetFramework="net46" />
-  <package id="EntityFramework.Relational" version="7.0.0-beta7" targetFramework="net46" />
-  <package id="EntityFramework.Relational.Design" version="7.0.0-beta7" targetFramework="net46" />
-  <package id="EntityFramework.SqlServer" version="7.0.0-beta7" targetFramework="net46" />
-  <package id="Ix-Async" version="1.2.5" targetFramework="net46" />
-  <package id="Microsoft.AspNet.Razor" version="4.0.0-beta7" targetFramework="net46" />
-  <package id="Microsoft.CodeAnalysis.Analyzers" version="1.1.0-beta1-20150812-01" targetFramework="net46" />
-  <package id="Microsoft.CodeAnalysis.Common" version="1.1.0-beta1-20150812-01" targetFramework="net46" />
-  <package id="Microsoft.CodeAnalysis.CSharp" version="1.1.0-beta1-20150812-01" targetFramework="net46" />
-  <package id="Microsoft.Framework.Caching.Abstractions" version="1.0.0-beta7" targetFramework="net46" />
-  <package id="Microsoft.Framework.Caching.Memory" version="1.0.0-beta7" targetFramework="net46" />
-  <package id="Microsoft.Framework.Configuration" version="1.0.0-beta7" targetFramework="net46" />
-  <package id="Microsoft.Framework.Configuration.Abstractions" version="1.0.0-beta7" targetFramework="net46" />
-  <package id="Microsoft.Framework.Configuration.Binder" version="1.0.0-beta7" targetFramework="net46" />
-  <package id="Microsoft.Framework.DependencyInjection" version="1.0.0-beta7" targetFramework="net46" />
-  <package id="Microsoft.Framework.DependencyInjection.Abstractions" version="1.0.0-beta7" targetFramework="net46" />
-  <package id="Microsoft.Framework.Logging" version="1.0.0-beta7" targetFramework="net46" />
-  <package id="Microsoft.Framework.Logging.Abstractions" version="1.0.0-beta7" targetFramework="net46" />
-  <package id="Microsoft.Framework.OptionsModel" version="1.0.0-beta7" targetFramework="net46" />
-  <package id="Remotion.Linq" version="2.0.0-beta-002" targetFramework="net46" />
-  <package id="System.Collections" version="4.0.0-beta-23109" targetFramework="net46" />
-  <package id="System.Collections.Immutable" version="1.1.37-beta-23109" targetFramework="net46" />
-  <package id="System.Diagnostics.Debug" version="4.0.0-beta-23109" targetFramework="net46" />
-  <package id="System.Globalization" version="4.0.0-beta-23109" targetFramework="net46" />
-  <package id="System.Linq" version="4.0.0-beta-23109" targetFramework="net46" />
-  <package id="System.Reflection.Metadata" version="1.1.0-alpha-00009" targetFramework="net46" />
-  <package id="System.Resources.ResourceManager" version="4.0.0-beta-23109" targetFramework="net46" />
-  <package id="System.Runtime" version="4.0.0-beta-23109" targetFramework="net46" />
-  <package id="System.Runtime.Extensions" version="4.0.0-beta-23109" targetFramework="net46" />
-  <package id="System.Threading" version="4.0.10-beta-22605" targetFramework="net46" />
-  <package id="System.Threading.Tasks" version="4.0.0-beta-23019" targetFramework="net46" />
-</packages>
\ No newline at end of file
diff --git a/docs/getting-started/index.rst b/docs/getting-started/index.rst
deleted file mode 100644
index 716debbc73..0000000000
--- a/docs/getting-started/index.rst
+++ /dev/null
@@ -1,11 +0,0 @@
-Getting Started
-===============
-
-.. toctree::
-    :titlesonly:
-
-    full-dotnet
-    aspnet5
-    uwp
-    osx
-    linux
\ No newline at end of file
diff --git a/docs/getting-started/linux.rst b/docs/getting-started/linux.rst
deleted file mode 100644
index 3e72a862cf..0000000000
--- a/docs/getting-started/linux.rst
+++ /dev/null
@@ -1,76 +0,0 @@
-Getting Started on Linux
-====================================
-
-This walkthrough will create a simple console application using ASP.NET 5 and
-the SQLite provider.
-
-.. note::
-    This article was written for beta 7 of ASP.NET and EF7.
-
-    You can find nightly builds of the EF7 code base hosted on https://www.myget.org/F/aspnetvnext/api/v2/ but the code base is rapidly changing and we do not maintain up-to-date documentation for getting started.
-
-
-.. contents:: `In this article:`
-    :depth: 1
-    :local:
-
-.. note:: `View this article's samples on GitHub <https://github.com/aspnet/EntityFramework.Docs/tree/master/docs/getting-started/x-plat/sample>`_.
-
-
-Prerequisites
--------------
-
-Minimum system requirements
- - Mono 4.0.2
- - Ubuntu, Debian or one of their derivatives
-
-.. caution::
-    **Known Issues**
-
-    .. include:: x-plat/issues.rst
-
-
-Install ASP.NET 5
------------------
-
-A summary of steps to install ASP.NET 5 are included below. For a more up-to-date guide, follow the steps for `Installing ASP.NET 5 on Linux <http://docs.asp.net/en/latest/getting-started/installing-on-linux.html>`_. This will ensure you meet the following requirements.
-
-The following steps will install `dnvm <https://github.com/aspnet/home#running-an-application>`_, a command-line tool for installing the .NET Execution environment.
-
- - Install the required libraries
-
-    .. code-block:: console
-
-        ~ $ sudo apt-get install libunwind8 libssl-dev unzip
-
- - Install mono.
-
-    .. code-block:: console
-
-        ~ $ sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF
-        ~ $ echo "deb http://download.mono-project.com/repo/debian wheezy main" | sudo tee /etc/apt/sources.list.d/mono-xamarin.list
-        ~ $ sudo apt-get update
-        ~ $ sudo apt-get install mono-complete
-
- - Import required certificates for Nuget
-
-    .. code-block:: console
-
-        ~ $ mozroots --import --sync
-
- - Run the dnvm
-
-    .. code-block:: console
-
-        ~ $ curl -sSL https://raw.githubusercontent.com/aspnet/Home/dev/dnvminstall.sh | DNX_BRANCH=dev sh && source ~/.dnx/dnvm/dnvm.sh
-
- - Verify dnvm has the latest version
-
-    .. code-block:: console
-
-        ~ $ dnvm upgrade
-
-If you have trouble installing dnvm, consult this `Getting Started guide <http://dotnet.github.io/core/getting-started/>`_.
-
-
-.. include:: x-plat/guide.rst
diff --git a/docs/getting-started/osx.rst b/docs/getting-started/osx.rst
deleted file mode 100644
index ed51267291..0000000000
--- a/docs/getting-started/osx.rst
+++ /dev/null
@@ -1,61 +0,0 @@
-Getting Started on OSX
-======================
-
-This walkthrough will create a simple console application using ASP.NET 5 and
-the SQLite provider.
-
-.. note::
-    This article was written for OS X Mavericks or newer. It uses beta 7 of ASP.NET and EF7.
-
-    You can find nightly builds of the EF7 code base hosted on https://www.myget.org/F/aspnetvnext/api/v2/ but the code base is rapidly changing and we do not maintain up-to-date documentation for getting started.
-
-
-.. contents:: `In this article:`
-    :depth: 1
-    :local:
-
-.. note:: `View this article's samples on GitHub <https://github.com/aspnet/EntityFramework.Docs/tree/master/docs/getting-started/x-plat/sample>`_.
-
-
-Prerequisites
--------------
-
-Minimum system requirements
- - Mono 4.0.2
- - OS X Mavericks
-
-.. caution::
-    **Known Issues**
-
-    .. include:: x-plat/issues.rst
-
-Install ASP.NET 5
------------------
-
-A summary of steps to install ASP.NET 5 are included below. For a more up-to-date guide, follow the steps for `Installing ASP.NET 5 on Mac OS X <http://docs.asp.net/en/latest/getting-started/installing-on-mac.html>`_. This will ensure you meet the following requirements.
-
-The following steps will install `dnvm <https://github.com/aspnet/home#running-an-application>`_, a command-line tool for installing the .NET Execution environment.
-
- - Install `Homebrew <http://brew.sh>`_
- - Use brew to install Mono
-
-    .. code-block:: console
-
-        ~ $ brew install mono
-
- - Run the dnvm
-
-    .. code-block:: console
-
-        ~ $ curl -sSL https://raw.githubusercontent.com/aspnet/Home/dev/dnvminstall.sh | DNX_BRANCH=dev sh && source ~/.dnx/dnvm/dnvm.sh
-
- - Verify dnvm has the latest version
-
-    .. code-block:: console
-
-        ~ $ dnvm upgrade
-
-If you have trouble installing dnvm, consult this `Getting Started guide <http://dotnet.github.io/core/getting-started/>`_.
-
-
-.. include:: x-plat/guide.rst
diff --git a/docs/getting-started/uwp.rst b/docs/getting-started/uwp.rst
deleted file mode 100644
index 63b88d48d1..0000000000
--- a/docs/getting-started/uwp.rst
+++ /dev/null
@@ -1,151 +0,0 @@
-Getting Started on Universal Windows Platform
-=============================================
-
-In this walkthrough, you will build a Universal Windows Platform (UWP) application that performs basic data access against a local SQLite database using Entity Framework.
-
-.. caution::
-    **Pre-releases of EF7 can be used on UWP but there are a number of known issues that you need to workaround. Look out for caution boxes (such as this one) that provide details of required workarounds.**
-
-    We'll be working to address these issues in upcoming releases. In fact, some of them are already fixed in our working code base.
-
-In this article:
-	- `Prerequisites`_
-	- `Create a new project`_
-	- `Install Entity Framework`_
-	- `Create your model`_
-	- `Create your database`_
-	- `Use your model`_
-
-`View this article's samples on GitHub <https://github.com/aspnet/EntityFramework.Docs/tree/master/docs/getting-started/uwp/sample>`_.
-
-.. caution::
-    **This walkthrough uses EF 7.0.0-beta6. Version 7.0.0-beta7 is available on NuGet.org, but some issues prevent it from being installed in a UWP application.**
-
-    You can find nightly builds of the EF7 code base hosted on https://www.myget.org/F/aspnetvnext/api/v2/ but the code base is rapidly changing and we do not maintain up-to-date documentation for getting started.
-
-Prerequisites
--------------
-
-The following items are required to complete this walkthrough:
-    - Windows 10 RTM
-    - Visual Studio 2015 RTM with Window 10 Developer Tools
-
-.. tip::
-    If you already have Visual Studio 2015 RTM installed without the Windows 10 Developer Tools, you can add these tools to your existing Visual Studio installation. You can `run the installer <http://go.microsoft.com/fwlink/?LinkID=619615>`_, or open **Programs and Features** from **Control Panel**, select **Visual Studio** and click **Change**. Then in setup, click **Modify** and select the **Tools for Universal Windows Apps**.
-
-
-Create a new project
---------------------
-
-* Open Visual Studio 2015
-* :menuselection:`File --> New --> Project...`
-* From the left menu select :menuselection:`Templates --> Visual C# --> Windows --> Universal`
-* Select the **Blank App (Universal Windows)** project template
-* Give the project a name and click **OK**
-
-Install Entity Framework
-----------------------------------------
-To use EF7 you install the package for the database provider(s) you want to target. This walkthrough uses SQLite. For a list of available providers see :doc:`/providers/index`.
-
-* :menuselection:`Tools --> NuGet Package Manager --> Package Manager Console`
-* Run ``Install-Package EntityFramework.SQLite –Version 7.0.0-beta6``
-
-Later in this walkthrough we will also be using some Entity Framework commands to maintain the database. So we will install the commands package as well.
-
-* Run ``Install-Package EntityFramework.Commands –Version 7.0.0-beta6``
-* Run ``Install-Package Microsoft.CodeAnalysis.CSharp –Version 1.0.0``
-
-.. caution::
-    **Note that the commands explicitly install EF 7.0.0-beta6.** Version 7.0.0-beta7 is available on NuGet.org, but some issues prevent it from being installed in a UWP application.
-
-    Needing to install the **Microsoft.CodeAnalysis.CSharp** package is a workaround for an issue in Beta 6. This will not be required in later releases.
-
-Create your model
------------------
-
-Now it's time to define a context and entity classes that make up your model.
-
-* :menuselection:`Project --> Add Class...`
-* Enter *Model.cs* as the name and click **OK**
-* Replace the contents of the file with the following code
-
-.. caution::
-    The ``try``/``catch`` code to set ``databaseFilePath`` is a temporary workaround to enable migrations to be added at design time. When the application runs, ``databaseFilePath`` will always be under ``ApplicationData.Current.LocalFolder.Path``. However, that API can not be called when migrations creates the context at design time in Visual Studio. The database is never accessed when adding migrations, so we just return a relative file path that will never be used.
-
-.. note::
-    Notice the ``OnConfiguring`` method (new in EF7) that is used to specify the provider to use and, optionally, other configuration too.
-
-.. literalinclude:: uwp/sample/EFGetStarted.UWP/Model.cs
-    :language: c#
-    :linenos:
-
-Create your database
---------------------
-
-Now that you have a model, you can use migrations to create a database for you.
-
-* :menuselection:`Build -> Build Solution`
-* :menuselection:`Tools –> NuGet Package Manager –> Package Manager Console`
-* Run ``Add-Migration MyFirstMigration`` to scaffold a migration to create the initial set of tables for your model.
-
-.. caution::
-    Notice that you need to manually build the solution before running the ``Add-Migration`` command. The command does invoke the build operation on the project, but we are currently investigating why this does not result in the correct assemblies being outputted.
-
-.. caution::
-    Due to a bug in the migration scaffolder in Beta6 you will need to manually edit the generated migration.
-
-    Remove (or comment out) the two calls to ``.Annotation("Sqlite:Autoincrement", true)`` as highlighted in the following code listing
-
-    .. literalinclude:: uwp/sample/EFGetStarted.UWP/Migrations/20150729201928_MyFirstMigration.cs
-        :language: c#
-        :linenos:
-        :lines: 10-31
-        :emphasize-lines: 7-8,19-20
-
-Since we want the database to be created on the device that the app runs on, we will add some code to apply any pending migrations to the local database on application startup. The first time that the app runs, this will take care of creating the local database for us.
-
-* Right-click on **App.xaml** in **Solution Explorer** and select **View Code**
-* Add the highlighted lines of code from the following listing
-
-.. literalinclude:: uwp/sample/EFGetStarted.UWP/App.xaml.cs
-        :language: c#
-        :linenos:
-        :lines: 1-25
-        :emphasize-lines: 2,21-24
-
-.. tip::
-    If you make future changes to your model, you can use the ``Add-Migration`` command to scaffold a new migration to apply the corresponding changes to the database. Any pending migrations will be applied to the local database on each device when the application starts.
-
-Use your model
---------------
-
-You can now use your model to perform data access.
-
-* Open *MainPage.xaml*
-* Add the page load handler and UI content highlighted below
-
-.. literalinclude:: uwp/sample/EFGetStarted.UWP/MainPage.xaml
-        :language: c#
-        :linenos:
-        :emphasize-lines: 9,12-22
-
-Now we'll add code to wire up the UI with the database
-
-* Right-click **MainPage.xaml** in **Solution Explorer** and select **View Code**
-* Add the highlighted code from the following listing
-
-.. literalinclude:: uwp/sample/EFGetStarted.UWP/MainPage.xaml.cs
-        :language: c#
-        :linenos:
-        :lines: 23-49
-        :emphasize-lines: 8-26
-
-You can now run the application to see it in action.
-
-* :menuselection:`Debug --> Start Without Debugging`
-* The application will build and launch
-* Enter a URL and click the **Add** button
-
-.. image:: uwp/_static/create.png
-
-.. image:: uwp/_static/list.png
diff --git a/docs/getting-started/uwp/_static/create.png b/docs/getting-started/uwp/_static/create.png
deleted file mode 100644
index f87adce635..0000000000
Binary files a/docs/getting-started/uwp/_static/create.png and /dev/null differ
diff --git a/docs/getting-started/uwp/_static/list.png b/docs/getting-started/uwp/_static/list.png
deleted file mode 100644
index b7ada8e969..0000000000
Binary files a/docs/getting-started/uwp/_static/list.png and /dev/null differ
diff --git a/docs/getting-started/uwp/sample/EFGetStarted.UWP.sln b/docs/getting-started/uwp/sample/EFGetStarted.UWP.sln
deleted file mode 100644
index 3674f30ec0..0000000000
--- a/docs/getting-started/uwp/sample/EFGetStarted.UWP.sln
+++ /dev/null
@@ -1,40 +0,0 @@
-
-Microsoft Visual Studio Solution File, Format Version 12.00
-# Visual Studio 14
-VisualStudioVersion = 14.0.23107.0
-MinimumVisualStudioVersion = 10.0.40219.1
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "EFGetStarted.UWP", "EFGetStarted.UWP\EFGetStarted.UWP.csproj", "{AB09F21A-1935-4AEE-B3CF-A987416EE495}"
-EndProject
-Global
-	GlobalSection(SolutionConfigurationPlatforms) = preSolution
-		Debug|ARM = Debug|ARM
-		Debug|x64 = Debug|x64
-		Debug|x86 = Debug|x86
-		Release|ARM = Release|ARM
-		Release|x64 = Release|x64
-		Release|x86 = Release|x86
-	EndGlobalSection
-	GlobalSection(ProjectConfigurationPlatforms) = postSolution
-		{AB09F21A-1935-4AEE-B3CF-A987416EE495}.Debug|ARM.ActiveCfg = Debug|ARM
-		{AB09F21A-1935-4AEE-B3CF-A987416EE495}.Debug|ARM.Build.0 = Debug|ARM
-		{AB09F21A-1935-4AEE-B3CF-A987416EE495}.Debug|ARM.Deploy.0 = Debug|ARM
-		{AB09F21A-1935-4AEE-B3CF-A987416EE495}.Debug|x64.ActiveCfg = Debug|x64
-		{AB09F21A-1935-4AEE-B3CF-A987416EE495}.Debug|x64.Build.0 = Debug|x64
-		{AB09F21A-1935-4AEE-B3CF-A987416EE495}.Debug|x64.Deploy.0 = Debug|x64
-		{AB09F21A-1935-4AEE-B3CF-A987416EE495}.Debug|x86.ActiveCfg = Debug|x86
-		{AB09F21A-1935-4AEE-B3CF-A987416EE495}.Debug|x86.Build.0 = Debug|x86
-		{AB09F21A-1935-4AEE-B3CF-A987416EE495}.Debug|x86.Deploy.0 = Debug|x86
-		{AB09F21A-1935-4AEE-B3CF-A987416EE495}.Release|ARM.ActiveCfg = Release|ARM
-		{AB09F21A-1935-4AEE-B3CF-A987416EE495}.Release|ARM.Build.0 = Release|ARM
-		{AB09F21A-1935-4AEE-B3CF-A987416EE495}.Release|ARM.Deploy.0 = Release|ARM
-		{AB09F21A-1935-4AEE-B3CF-A987416EE495}.Release|x64.ActiveCfg = Release|x64
-		{AB09F21A-1935-4AEE-B3CF-A987416EE495}.Release|x64.Build.0 = Release|x64
-		{AB09F21A-1935-4AEE-B3CF-A987416EE495}.Release|x64.Deploy.0 = Release|x64
-		{AB09F21A-1935-4AEE-B3CF-A987416EE495}.Release|x86.ActiveCfg = Release|x86
-		{AB09F21A-1935-4AEE-B3CF-A987416EE495}.Release|x86.Build.0 = Release|x86
-		{AB09F21A-1935-4AEE-B3CF-A987416EE495}.Release|x86.Deploy.0 = Release|x86
-	EndGlobalSection
-	GlobalSection(SolutionProperties) = preSolution
-		HideSolutionNode = FALSE
-	EndGlobalSection
-EndGlobal
diff --git a/docs/getting-started/uwp/sample/EFGetStarted.UWP/App.xaml b/docs/getting-started/uwp/sample/EFGetStarted.UWP/App.xaml
deleted file mode 100644
index 0b6669f4e4..0000000000
--- a/docs/getting-started/uwp/sample/EFGetStarted.UWP/App.xaml
+++ /dev/null
@@ -1,8 +0,0 @@
-<Application
-    x:Class="EFGetStarted.UWP.App"
-    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
-    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
-    xmlns:local="using:EFGetStarted.UWP"
-    RequestedTheme="Light">
-
-</Application>
diff --git a/docs/getting-started/uwp/sample/EFGetStarted.UWP/App.xaml.cs b/docs/getting-started/uwp/sample/EFGetStarted.UWP/App.xaml.cs
deleted file mode 100644
index fffd4c3940..0000000000
--- a/docs/getting-started/uwp/sample/EFGetStarted.UWP/App.xaml.cs
+++ /dev/null
@@ -1,97 +0,0 @@
-using System;
-using Microsoft.Data.Entity;
-using Windows.ApplicationModel;
-using Windows.ApplicationModel.Activation;
-using Windows.UI.Xaml;
-using Windows.UI.Xaml.Controls;
-using Windows.UI.Xaml.Navigation;
-
-namespace EFGetStarted.UWP
-{
-    sealed partial class App : Application
-    {
-        public App()
-        {
-            Microsoft.ApplicationInsights.WindowsAppInitializer.InitializeAsync(
-                Microsoft.ApplicationInsights.WindowsCollectors.Metadata |
-                Microsoft.ApplicationInsights.WindowsCollectors.Session);
-            this.InitializeComponent();
-            this.Suspending += OnSuspending;
-
-            using (var db = new BloggingContext())
-            {
-                db.Database.ApplyMigrations();
-            }
-        }
-
-        /// <summary>
-        /// Invoked when the application is launched normally by the end user.  Other entry points
-        /// will be used such as when the application is launched to open a specific file.
-        /// </summary>
-        /// <param name="e">Details about the launch request and process.</param>
-        protected override void OnLaunched(LaunchActivatedEventArgs e)
-        {
-
-#if DEBUG
-            if (System.Diagnostics.Debugger.IsAttached)
-            {
-                this.DebugSettings.EnableFrameRateCounter = true;
-            }
-#endif
-
-            Frame rootFrame = Window.Current.Content as Frame;
-
-            // Do not repeat app initialization when the Window already has content,
-            // just ensure that the window is active
-            if (rootFrame == null)
-            {
-                // Create a Frame to act as the navigation context and navigate to the first page
-                rootFrame = new Frame();
-
-                rootFrame.NavigationFailed += OnNavigationFailed;
-
-                if (e.PreviousExecutionState == ApplicationExecutionState.Terminated)
-                {
-                    //TODO: Load state from previously suspended application
-                }
-
-                // Place the frame in the current Window
-                Window.Current.Content = rootFrame;
-            }
-
-            if (rootFrame.Content == null)
-            {
-                // When the navigation stack isn't restored navigate to the first page,
-                // configuring the new page by passing required information as a navigation
-                // parameter
-                rootFrame.Navigate(typeof(MainPage), e.Arguments);
-            }
-            // Ensure the current window is active
-            Window.Current.Activate();
-        }
-
-        /// <summary>
-        /// Invoked when Navigation to a certain page fails
-        /// </summary>
-        /// <param name="sender">The Frame which failed navigation</param>
-        /// <param name="e">Details about the navigation failure</param>
-        void OnNavigationFailed(object sender, NavigationFailedEventArgs e)
-        {
-            throw new Exception("Failed to load Page " + e.SourcePageType.FullName);
-        }
-
-        /// <summary>
-        /// Invoked when application execution is being suspended.  Application state is saved
-        /// without knowing whether the application will be terminated or resumed with the contents
-        /// of memory still intact.
-        /// </summary>
-        /// <param name="sender">The source of the suspend request.</param>
-        /// <param name="e">Details about the suspend request.</param>
-        private void OnSuspending(object sender, SuspendingEventArgs e)
-        {
-            var deferral = e.SuspendingOperation.GetDeferral();
-            //TODO: Save application state and stop any background activity
-            deferral.Complete();
-        }
-    }
-}
diff --git a/docs/getting-started/uwp/sample/EFGetStarted.UWP/ApplicationInsights.config b/docs/getting-started/uwp/sample/EFGetStarted.UWP/ApplicationInsights.config
deleted file mode 100644
index cb2a232da3..0000000000
--- a/docs/getting-started/uwp/sample/EFGetStarted.UWP/ApplicationInsights.config
+++ /dev/null
@@ -1,3 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<ApplicationInsights xmlns = "http://schemas.microsoft.com/ApplicationInsights/2013/Settings">
-</ApplicationInsights>
diff --git a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Assets/LockScreenLogo.scale-200.png b/docs/getting-started/uwp/sample/EFGetStarted.UWP/Assets/LockScreenLogo.scale-200.png
deleted file mode 100644
index 735f57adb5..0000000000
Binary files a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Assets/LockScreenLogo.scale-200.png and /dev/null differ
diff --git a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Assets/SplashScreen.scale-200.png b/docs/getting-started/uwp/sample/EFGetStarted.UWP/Assets/SplashScreen.scale-200.png
deleted file mode 100644
index 023e7f1fed..0000000000
Binary files a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Assets/SplashScreen.scale-200.png and /dev/null differ
diff --git a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Assets/Square150x150Logo.scale-200.png b/docs/getting-started/uwp/sample/EFGetStarted.UWP/Assets/Square150x150Logo.scale-200.png
deleted file mode 100644
index af49fec1a5..0000000000
Binary files a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Assets/Square150x150Logo.scale-200.png and /dev/null differ
diff --git a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Assets/Square44x44Logo.scale-200.png b/docs/getting-started/uwp/sample/EFGetStarted.UWP/Assets/Square44x44Logo.scale-200.png
deleted file mode 100644
index ce342a2ec8..0000000000
Binary files a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Assets/Square44x44Logo.scale-200.png and /dev/null differ
diff --git a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Assets/Square44x44Logo.targetsize-24_altform-unplated.png b/docs/getting-started/uwp/sample/EFGetStarted.UWP/Assets/Square44x44Logo.targetsize-24_altform-unplated.png
deleted file mode 100644
index f6c02ce97e..0000000000
Binary files a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Assets/Square44x44Logo.targetsize-24_altform-unplated.png and /dev/null differ
diff --git a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Assets/StoreLogo.png b/docs/getting-started/uwp/sample/EFGetStarted.UWP/Assets/StoreLogo.png
deleted file mode 100644
index 7385b56c0e..0000000000
Binary files a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Assets/StoreLogo.png and /dev/null differ
diff --git a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Assets/Wide310x150Logo.scale-200.png b/docs/getting-started/uwp/sample/EFGetStarted.UWP/Assets/Wide310x150Logo.scale-200.png
deleted file mode 100644
index 288995b397..0000000000
Binary files a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Assets/Wide310x150Logo.scale-200.png and /dev/null differ
diff --git a/docs/getting-started/uwp/sample/EFGetStarted.UWP/EFGetStarted.UWP.csproj b/docs/getting-started/uwp/sample/EFGetStarted.UWP/EFGetStarted.UWP.csproj
deleted file mode 100644
index 4878227594..0000000000
--- a/docs/getting-started/uwp/sample/EFGetStarted.UWP/EFGetStarted.UWP.csproj
+++ /dev/null
@@ -1,150 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<Project ToolsVersion="14.0" DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
-  <Import Project="$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props" Condition="Exists('$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props')" />
-  <PropertyGroup>
-    <Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>
-    <Platform Condition=" '$(Platform)' == '' ">x86</Platform>
-    <ProjectGuid>{AB09F21A-1935-4AEE-B3CF-A987416EE495}</ProjectGuid>
-    <OutputType>AppContainerExe</OutputType>
-    <AppDesignerFolder>Properties</AppDesignerFolder>
-    <RootNamespace>EFGetStarted.UWP</RootNamespace>
-    <AssemblyName>EFGetStarted.UWP</AssemblyName>
-    <DefaultLanguage>en-US</DefaultLanguage>
-    <TargetPlatformIdentifier>UAP</TargetPlatformIdentifier>
-    <TargetPlatformVersion>10.0.10240.0</TargetPlatformVersion>
-    <TargetPlatformMinVersion>10.0.10240.0</TargetPlatformMinVersion>
-    <MinimumVisualStudioVersion>14</MinimumVisualStudioVersion>
-    <EnableDotNetNativeCompatibleProfile>true</EnableDotNetNativeCompatibleProfile>
-    <FileAlignment>512</FileAlignment>
-    <ProjectTypeGuids>{A5A43C5B-DE2A-4C0C-9213-0A381AF9435A};{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}</ProjectTypeGuids>
-    <PackageCertificateKeyFile>EFGetStarted.UWP_TemporaryKey.pfx</PackageCertificateKeyFile>
-  </PropertyGroup>
-  <PropertyGroup Condition="'$(Configuration)|$(Platform)' == 'Debug|ARM'">
-    <DebugSymbols>true</DebugSymbols>
-    <OutputPath>bin\ARM\Debug\</OutputPath>
-    <DefineConstants>DEBUG;TRACE;NETFX_CORE;WINDOWS_UWP</DefineConstants>
-    <NoWarn>;2008</NoWarn>
-    <DebugType>full</DebugType>
-    <PlatformTarget>ARM</PlatformTarget>
-    <UseVSHostingProcess>false</UseVSHostingProcess>
-    <ErrorReport>prompt</ErrorReport>
-    <Prefer32Bit>true</Prefer32Bit>
-  </PropertyGroup>
-  <PropertyGroup Condition="'$(Configuration)|$(Platform)' == 'Release|ARM'">
-    <OutputPath>bin\ARM\Release\</OutputPath>
-    <DefineConstants>TRACE;NETFX_CORE;WINDOWS_UWP</DefineConstants>
-    <Optimize>true</Optimize>
-    <NoWarn>;2008</NoWarn>
-    <DebugType>pdbonly</DebugType>
-    <PlatformTarget>ARM</PlatformTarget>
-    <UseVSHostingProcess>false</UseVSHostingProcess>
-    <ErrorReport>prompt</ErrorReport>
-    <Prefer32Bit>true</Prefer32Bit>
-    <UseDotNetNativeToolchain>true</UseDotNetNativeToolchain>
-  </PropertyGroup>
-  <PropertyGroup Condition="'$(Configuration)|$(Platform)' == 'Debug|x64'">
-    <DebugSymbols>true</DebugSymbols>
-    <OutputPath>bin\x64\Debug\</OutputPath>
-    <DefineConstants>DEBUG;TRACE;NETFX_CORE;WINDOWS_UWP</DefineConstants>
-    <NoWarn>;2008</NoWarn>
-    <DebugType>full</DebugType>
-    <PlatformTarget>x64</PlatformTarget>
-    <UseVSHostingProcess>false</UseVSHostingProcess>
-    <ErrorReport>prompt</ErrorReport>
-    <Prefer32Bit>true</Prefer32Bit>
-  </PropertyGroup>
-  <PropertyGroup Condition="'$(Configuration)|$(Platform)' == 'Release|x64'">
-    <OutputPath>bin\x64\Release\</OutputPath>
-    <DefineConstants>TRACE;NETFX_CORE;WINDOWS_UWP</DefineConstants>
-    <Optimize>true</Optimize>
-    <NoWarn>;2008</NoWarn>
-    <DebugType>pdbonly</DebugType>
-    <PlatformTarget>x64</PlatformTarget>
-    <UseVSHostingProcess>false</UseVSHostingProcess>
-    <ErrorReport>prompt</ErrorReport>
-    <Prefer32Bit>true</Prefer32Bit>
-    <UseDotNetNativeToolchain>true</UseDotNetNativeToolchain>
-  </PropertyGroup>
-  <PropertyGroup Condition="'$(Configuration)|$(Platform)' == 'Debug|x86'">
-    <DebugSymbols>true</DebugSymbols>
-    <OutputPath>bin\x86\Debug\</OutputPath>
-    <DefineConstants>DEBUG;TRACE;NETFX_CORE;WINDOWS_UWP</DefineConstants>
-    <NoWarn>;2008</NoWarn>
-    <DebugType>full</DebugType>
-    <PlatformTarget>x86</PlatformTarget>
-    <UseVSHostingProcess>false</UseVSHostingProcess>
-    <ErrorReport>prompt</ErrorReport>
-    <Prefer32Bit>true</Prefer32Bit>
-  </PropertyGroup>
-  <PropertyGroup Condition="'$(Configuration)|$(Platform)' == 'Release|x86'">
-    <OutputPath>bin\x86\Release\</OutputPath>
-    <DefineConstants>TRACE;NETFX_CORE;WINDOWS_UWP</DefineConstants>
-    <Optimize>true</Optimize>
-    <NoWarn>;2008</NoWarn>
-    <DebugType>pdbonly</DebugType>
-    <PlatformTarget>x86</PlatformTarget>
-    <UseVSHostingProcess>false</UseVSHostingProcess>
-    <ErrorReport>prompt</ErrorReport>
-    <Prefer32Bit>true</Prefer32Bit>
-    <UseDotNetNativeToolchain>true</UseDotNetNativeToolchain>
-  </PropertyGroup>
-  <ItemGroup>
-    <!-- A reference to the entire .Net Framework and Windows SDK are automatically included -->
-    <Content Include="ApplicationInsights.config">
-      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
-    </Content>
-    <None Include="project.json" />
-  </ItemGroup>
-  <ItemGroup>
-    <Compile Include="App.xaml.cs">
-      <DependentUpon>App.xaml</DependentUpon>
-    </Compile>
-    <Compile Include="MainPage.xaml.cs">
-      <DependentUpon>MainPage.xaml</DependentUpon>
-    </Compile>
-    <Compile Include="Migrations\20150729201928_MyFirstMigration.cs" />
-    <Compile Include="Migrations\20150729201928_MyFirstMigration.designer.cs">
-      <DependentUpon>20150729201928_MyFirstMigration.cs</DependentUpon>
-    </Compile>
-    <Compile Include="Migrations\BloggingContextModelSnapshot.cs" />
-    <Compile Include="Model.cs" />
-    <Compile Include="Properties\AssemblyInfo.cs" />
-  </ItemGroup>
-  <ItemGroup>
-    <AppxManifest Include="Package.appxmanifest">
-      <SubType>Designer</SubType>
-    </AppxManifest>
-    <None Include="EFGetStarted.UWP_TemporaryKey.pfx" />
-  </ItemGroup>
-  <ItemGroup>
-    <Content Include="Properties\Default.rd.xml" />
-    <Content Include="Assets\LockScreenLogo.scale-200.png" />
-    <Content Include="Assets\SplashScreen.scale-200.png" />
-    <Content Include="Assets\Square150x150Logo.scale-200.png" />
-    <Content Include="Assets\Square44x44Logo.scale-200.png" />
-    <Content Include="Assets\Square44x44Logo.targetsize-24_altform-unplated.png" />
-    <Content Include="Assets\StoreLogo.png" />
-    <Content Include="Assets\Wide310x150Logo.scale-200.png" />
-  </ItemGroup>
-  <ItemGroup>
-    <ApplicationDefinition Include="App.xaml">
-      <Generator>MSBuild:Compile</Generator>
-      <SubType>Designer</SubType>
-    </ApplicationDefinition>
-    <Page Include="MainPage.xaml">
-      <Generator>MSBuild:Compile</Generator>
-      <SubType>Designer</SubType>
-    </Page>
-  </ItemGroup>
-  <PropertyGroup Condition=" '$(VisualStudioVersion)' == '' or '$(VisualStudioVersion)' &lt; '14.0' ">
-    <VisualStudioVersion>14.0</VisualStudioVersion>
-  </PropertyGroup>
-  <Import Project="$(MSBuildExtensionsPath)\Microsoft\WindowsXaml\v$(VisualStudioVersion)\Microsoft.Windows.UI.Xaml.CSharp.targets" />
-  <!-- To modify your build process, add your task inside one of the targets below and uncomment it. 
-       Other similar extension points exist, see Microsoft.Common.targets.
-  <Target Name="BeforeBuild">
-  </Target>
-  <Target Name="AfterBuild">
-  </Target>
-  -->
-</Project>
\ No newline at end of file
diff --git a/docs/getting-started/uwp/sample/EFGetStarted.UWP/EFGetStarted.UWP.nuget.targets b/docs/getting-started/uwp/sample/EFGetStarted.UWP/EFGetStarted.UWP.nuget.targets
deleted file mode 100644
index f4df15b835..0000000000
--- a/docs/getting-started/uwp/sample/EFGetStarted.UWP/EFGetStarted.UWP.nuget.targets
+++ /dev/null
@@ -1,9 +0,0 @@
-<?xml version="1.0" encoding="utf-8" standalone="no"?>
-<Project ToolsVersion="14.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
-  <PropertyGroup Condition="'$(NuGetPackageRoot)' == ''">
-    <NuGetPackageRoot>C:\Users\rowmil\.nuget\packages\</NuGetPackageRoot>
-  </PropertyGroup>
-  <ImportGroup>
-    <Import Project="$(NuGetPackageRoot)\EntityFramework.Commands\7.0.0-beta6\build\netcore50\EntityFramework.Commands.targets" Condition="Exists('$(NuGetPackageRoot)\EntityFramework.Commands\7.0.0-beta6\build\netcore50\EntityFramework.Commands.targets')" />
-  </ImportGroup>
-</Project>
\ No newline at end of file
diff --git a/docs/getting-started/uwp/sample/EFGetStarted.UWP/MainPage.xaml b/docs/getting-started/uwp/sample/EFGetStarted.UWP/MainPage.xaml
deleted file mode 100644
index 9f2908ec8f..0000000000
--- a/docs/getting-started/uwp/sample/EFGetStarted.UWP/MainPage.xaml
+++ /dev/null
@@ -1,24 +0,0 @@
-<Page
-    x:Class="EFGetStarted.UWP.MainPage"
-    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
-    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
-    xmlns:local="using:EFGetStarted.UWP"
-    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
-    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
-    mc:Ignorable="d"
-    Loaded="Page_Loaded">
-
-    <Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
-        <StackPanel>
-            <TextBox Name="NewBlogUrl"></TextBox>
-            <Button Click="Add_Click">Add</Button>
-            <ListView Name="Blogs">
-                <ListView.ItemTemplate>
-                    <DataTemplate>
-                        <TextBlock Text="{Binding Url}" />
-                    </DataTemplate>
-                </ListView.ItemTemplate>
-            </ListView>
-        </StackPanel>
-    </Grid>
-</Page>
diff --git a/docs/getting-started/uwp/sample/EFGetStarted.UWP/MainPage.xaml.cs b/docs/getting-started/uwp/sample/EFGetStarted.UWP/MainPage.xaml.cs
deleted file mode 100644
index c5e65e888d..0000000000
--- a/docs/getting-started/uwp/sample/EFGetStarted.UWP/MainPage.xaml.cs
+++ /dev/null
@@ -1,50 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.IO;
-using System.Linq;
-using System.Runtime.InteropServices.WindowsRuntime;
-using Windows.Foundation;
-using Windows.Foundation.Collections;
-using Windows.UI.Xaml;
-using Windows.UI.Xaml.Controls;
-using Windows.UI.Xaml.Controls.Primitives;
-using Windows.UI.Xaml.Data;
-using Windows.UI.Xaml.Input;
-using Windows.UI.Xaml.Media;
-using Windows.UI.Xaml.Navigation;
-
-// The Blank Page item template is documented at http://go.microsoft.com/fwlink/?LinkId=402352&clcid=0x409
-
-namespace EFGetStarted.UWP
-{
-    /// <summary>
-    /// An empty page that can be used on its own or navigated to within a Frame.
-    /// </summary>
-    public sealed partial class MainPage : Page
-    {
-        public MainPage()
-        {
-            this.InitializeComponent();
-        }
-
-        private void Page_Loaded(object sender, RoutedEventArgs e)
-        {
-            using (var db = new BloggingContext())
-            {
-                Blogs.ItemsSource = db.Blogs.ToList();
-            }
-        }
-
-        private void Add_Click(object sender, RoutedEventArgs e)
-        {
-            using (var db = new BloggingContext())
-            {
-                var blog = new Blog { Url = NewBlogUrl.Text };
-                db.Blogs.Add(blog);
-                db.SaveChanges();
-
-                Blogs.ItemsSource = db.Blogs.ToList();
-            }
-        }
-    }
-}
diff --git a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Migrations/20150729201928_MyFirstMigration.cs b/docs/getting-started/uwp/sample/EFGetStarted.UWP/Migrations/20150729201928_MyFirstMigration.cs
deleted file mode 100644
index ed1c60224c..0000000000
--- a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Migrations/20150729201928_MyFirstMigration.cs
+++ /dev/null
@@ -1,51 +0,0 @@
-using System.Collections.Generic;
-using Microsoft.Data.Entity.Migrations;
-using Microsoft.Data.Entity.Migrations.Builders;
-using Microsoft.Data.Entity.Migrations.Operations;
-
-namespace EFGetStartedUWPMigrations
-{
-    public partial class MyFirstMigration : Migration
-    {
-        public override void Up(MigrationBuilder migration)
-        {
-            migration.CreateTable(
-                name: "Blog",
-                columns: table => new
-                {
-                    BlogId = table.Column(type: "INTEGER", nullable: false), // <- Add this comma
-                        //.Annotation("Sqlite:Autoincrement", "true"), // <- Remove or comment this line
-                    Url = table.Column(type: "TEXT", nullable: false)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_Blog", x => x.BlogId);
-                });
-            migration.CreateTable(
-                name: "Post",
-                columns: table => new
-                {
-                    PostId = table.Column(type: "INTEGER", nullable: false), // <- Add this comma
-                        //.Annotation("Sqlite:Autoincrement", "true"), // <- Remove or comment this line
-                    BlogId = table.Column(type: "INTEGER", nullable: false),
-                    Content = table.Column(type: "TEXT", nullable: true),
-                    Title = table.Column(type: "TEXT", nullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_Post", x => x.PostId);
-                    table.ForeignKey(
-                        name: "FK_Post_Blog_BlogId",
-                        columns: x => x.BlogId,
-                        referencedTable: "Blog",
-                        referencedColumn: "BlogId");
-                });
-        }
-
-        public override void Down(MigrationBuilder migration)
-        {
-            migration.DropTable("Post");
-            migration.DropTable("Blog");
-        }
-    }
-}
diff --git a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Migrations/20150729201928_MyFirstMigration.designer.cs b/docs/getting-started/uwp/sample/EFGetStarted.UWP/Migrations/20150729201928_MyFirstMigration.designer.cs
deleted file mode 100644
index 595f2d3e50..0000000000
--- a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Migrations/20150729201928_MyFirstMigration.designer.cs
+++ /dev/null
@@ -1,60 +0,0 @@
-using System;
-using Microsoft.Data.Entity;
-using Microsoft.Data.Entity.Metadata;
-using Microsoft.Data.Entity.Migrations.Infrastructure;
-using EFGetStarted.UWP;
-
-namespace EFGetStartedUWPMigrations
-{
-    [ContextType(typeof(BloggingContext))]
-    partial class MyFirstMigration
-    {
-        public override string Id
-        {
-            get { return "20150729201928_MyFirstMigration"; }
-        }
-
-        public override string ProductVersion
-        {
-            get { return "7.0.0-beta6-13815"; }
-        }
-
-        public override void BuildTargetModel(ModelBuilder builder)
-        {
-            builder
-                .Annotation("ProductVersion", "7.0.0-beta6-13815");
-
-            builder.Entity("EFGetStarted.UWP.Blog", b =>
-                {
-                    b.Property<int>("BlogId")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Url")
-                        .Required();
-
-                    b.Key("BlogId");
-                });
-
-            builder.Entity("EFGetStarted.UWP.Post", b =>
-                {
-                    b.Property<int>("PostId")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BlogId");
-
-                    b.Property<string>("Content");
-
-                    b.Property<string>("Title");
-
-                    b.Key("PostId");
-                });
-
-            builder.Entity("EFGetStarted.UWP.Post", b =>
-                {
-                    b.Reference("EFGetStarted.UWP.Blog")
-                        .InverseCollection()
-                        .ForeignKey("BlogId");
-                });
-        }
-    }
-}
diff --git a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Migrations/BloggingContextModelSnapshot.cs b/docs/getting-started/uwp/sample/EFGetStarted.UWP/Migrations/BloggingContextModelSnapshot.cs
deleted file mode 100644
index fad819670e..0000000000
--- a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Migrations/BloggingContextModelSnapshot.cs
+++ /dev/null
@@ -1,50 +0,0 @@
-using System;
-using Microsoft.Data.Entity;
-using Microsoft.Data.Entity.Metadata;
-using Microsoft.Data.Entity.Migrations.Infrastructure;
-using EFGetStarted.UWP;
-
-namespace EFGetStartedUWPMigrations
-{
-    [ContextType(typeof(BloggingContext))]
-    partial class BloggingContextModelSnapshot : ModelSnapshot
-    {
-        public override void BuildModel(ModelBuilder builder)
-        {
-            builder
-                .Annotation("ProductVersion", "7.0.0-beta6-13815");
-
-            builder.Entity("EFGetStarted.UWP.Blog", b =>
-                {
-                    b.Property<int>("BlogId")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Url")
-                        .Required();
-
-                    b.Key("BlogId");
-                });
-
-            builder.Entity("EFGetStarted.UWP.Post", b =>
-                {
-                    b.Property<int>("PostId")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BlogId");
-
-                    b.Property<string>("Content");
-
-                    b.Property<string>("Title");
-
-                    b.Key("PostId");
-                });
-
-            builder.Entity("EFGetStarted.UWP.Post", b =>
-                {
-                    b.Reference("EFGetStarted.UWP.Blog")
-                        .InverseCollection()
-                        .ForeignKey("BlogId");
-                });
-        }
-    }
-}
diff --git a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Model.cs b/docs/getting-started/uwp/sample/EFGetStarted.UWP/Model.cs
deleted file mode 100644
index 9230a49f15..0000000000
--- a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Model.cs
+++ /dev/null
@@ -1,53 +0,0 @@
-using Microsoft.Data.Entity;
-using System;
-using System.Collections.Generic;
-using System.IO;
-using Windows.Storage;
-
-namespace EFGetStarted.UWP
-{
-    public class BloggingContext : DbContext
-    {
-        public DbSet<Blog> Blogs { get; set; }
-        public DbSet<Post> Posts { get; set; }
-
-        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
-        {
-            string databaseFilePath = "Blogging2.db";
-            try
-            {
-                databaseFilePath = Path.Combine(ApplicationData.Current.LocalFolder.Path, databaseFilePath);
-            }
-            catch (InvalidOperationException)
-            { }
-
-            optionsBuilder.UseSqlite($"Data source={databaseFilePath}");
-        }
-
-        protected override void OnModelCreating(ModelBuilder modelBuilder)
-        {
-            // Make Blog.Url required
-            modelBuilder.Entity<Blog>()
-                .Property(b => b.Url)
-                .Required();
-        }
-    }
-
-    public class Blog
-    {
-        public int BlogId { get; set; }
-        public string Url { get; set; }
-
-        public List<Post> Posts { get; set; }
-    }
-
-    public class Post
-    {
-        public int PostId { get; set; }
-        public string Title { get; set; }
-        public string Content { get; set; }
-
-        public int BlogId { get; set; }
-        public Blog Blog { get; set; }
-    }
-}
\ No newline at end of file
diff --git a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Package.appxmanifest b/docs/getting-started/uwp/sample/EFGetStarted.UWP/Package.appxmanifest
deleted file mode 100644
index 134bfe6f82..0000000000
--- a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Package.appxmanifest
+++ /dev/null
@@ -1,49 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-
-<Package
-  xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
-  xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
-  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
-  IgnorableNamespaces="uap mp">
-
-  <Identity
-    Name="caf8dc64-dc7e-40ff-b027-18e8168f1956"
-    Publisher="CN=rowmil"
-    Version="1.0.0.0" />
-
-  <mp:PhoneIdentity PhoneProductId="caf8dc64-dc7e-40ff-b027-18e8168f1956" PhonePublisherId="00000000-0000-0000-0000-000000000000"/>
-
-  <Properties>
-    <DisplayName>EFGetStarted.UWP</DisplayName>
-    <PublisherDisplayName>rowmil</PublisherDisplayName>
-    <Logo>Assets\StoreLogo.png</Logo>
-  </Properties>
-
-  <Dependencies>
-    <TargetDeviceFamily Name="Windows.Universal" MinVersion="10.0.0.0" MaxVersionTested="10.0.0.0" />
-  </Dependencies>
-
-  <Resources>
-    <Resource Language="x-generate"/>
-  </Resources>
-
-  <Applications>
-    <Application Id="App"
-      Executable="$targetnametoken$.exe"
-      EntryPoint="EFGetStarted.UWP.App">
-      <uap:VisualElements
-        DisplayName="EFGetStarted.UWP"
-        Square150x150Logo="Assets\Square150x150Logo.png"
-        Square44x44Logo="Assets\Square44x44Logo.png"
-        Description="EFGetStarted.UWP"
-        BackgroundColor="transparent">
-        <uap:DefaultTile Wide310x150Logo="Assets\Wide310x150Logo.png"/>
-        <uap:SplashScreen Image="Assets\SplashScreen.png" />
-      </uap:VisualElements>
-    </Application>
-  </Applications>
-
-  <Capabilities>
-    <Capability Name="internetClient" />
-  </Capabilities>
-</Package>
\ No newline at end of file
diff --git a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Properties/AssemblyInfo.cs b/docs/getting-started/uwp/sample/EFGetStarted.UWP/Properties/AssemblyInfo.cs
deleted file mode 100644
index 354aa0a32e..0000000000
--- a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Properties/AssemblyInfo.cs
+++ /dev/null
@@ -1,29 +0,0 @@
-using System.Reflection;
-using System.Runtime.CompilerServices;
-using System.Runtime.InteropServices;
-
-// General Information about an assembly is controlled through the following 
-// set of attributes. Change these attribute values to modify the information
-// associated with an assembly.
-[assembly: AssemblyTitle("EFGetStarted.UWP")]
-[assembly: AssemblyDescription("")]
-[assembly: AssemblyConfiguration("")]
-[assembly: AssemblyCompany("")]
-[assembly: AssemblyProduct("EFGetStarted.UWP")]
-[assembly: AssemblyCopyright("Copyright ©  2015")]
-[assembly: AssemblyTrademark("")]
-[assembly: AssemblyCulture("")]
-
-// Version information for an assembly consists of the following four values:
-//
-//      Major Version
-//      Minor Version 
-//      Build Number
-//      Revision
-//
-// You can specify all the values or you can default the Build and Revision Numbers 
-// by using the '*' as shown below:
-// [assembly: AssemblyVersion("1.0.*")]
-[assembly: AssemblyVersion("1.0.0.0")]
-[assembly: AssemblyFileVersion("1.0.0.0")]
-[assembly: ComVisible(false)]
\ No newline at end of file
diff --git a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Properties/Default.rd.xml b/docs/getting-started/uwp/sample/EFGetStarted.UWP/Properties/Default.rd.xml
deleted file mode 100644
index 80a960ce32..0000000000
--- a/docs/getting-started/uwp/sample/EFGetStarted.UWP/Properties/Default.rd.xml
+++ /dev/null
@@ -1,31 +0,0 @@
-<!--
-    This file contains Runtime Directives used by .NET Native. The defaults here are suitable for most
-    developers. However, you can modify these parameters to modify the behavior of the .NET Native
-    optimizer.
-
-    Runtime Directives are documented at http://go.microsoft.com/fwlink/?LinkID=391919
-
-    To fully enable reflection for App1.MyClass and all of its public/private members
-    <Type Name="App1.MyClass" Dynamic="Required All"/>
-
-    To enable dynamic creation of the specific instantiation of AppClass<T> over System.Int32
-    <TypeInstantiation Name="App1.AppClass" Arguments="System.Int32" Activate="Required Public" />
-
-    Using the Namespace directive to apply reflection policy to all the types in a particular namespace
-    <Namespace Name="DataClasses.ViewModels" Seralize="All" />
--->
-
-<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">
-  <Application>
-    <!--
-      An Assembly element with Name="*Application*" applies to all assemblies in
-      the application package. The asterisks are not wildcards.
-    -->
-    <Assembly Name="*Application*" Dynamic="Required All" />
-    
-    
-    <!-- Add your application specific runtime directives here. -->
-
-
-  </Application>
-</Directives>
\ No newline at end of file
diff --git a/docs/getting-started/uwp/sample/EFGetStarted.UWP/project.json b/docs/getting-started/uwp/sample/EFGetStarted.UWP/project.json
deleted file mode 100644
index b79ed2e0b0..0000000000
--- a/docs/getting-started/uwp/sample/EFGetStarted.UWP/project.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-  "dependencies": {
-    "EntityFramework.Commands": "7.0.0-beta6",
-    "EntityFramework.SQLite": "7.0.0-beta6",
-    "Microsoft.ApplicationInsights": "1.0.0",
-    "Microsoft.ApplicationInsights.PersistenceChannel": "1.0.0",
-    "Microsoft.ApplicationInsights.WindowsApps": "1.0.0",
-    "Microsoft.CodeAnalysis.CSharp": "1.0.0",
-    "Microsoft.NETCore.UniversalWindowsPlatform": "5.0.0"
-  },
-  "frameworks": {
-    "uap10.0": {}
-  },
-  "runtimes": {
-    "win10-arm": {},
-    "win10-arm-aot": {},
-    "win10-x86": {},
-    "win10-x86-aot": {},
-    "win10-x64": {},
-    "win10-x64-aot": {}
-  }
-}
\ No newline at end of file
diff --git a/docs/getting-started/x-plat/guide.rst b/docs/getting-started/x-plat/guide.rst
deleted file mode 100644
index a115c9abb8..0000000000
--- a/docs/getting-started/x-plat/guide.rst
+++ /dev/null
@@ -1,193 +0,0 @@
-Create a new project
---------------------
- - Create a new folder ``ConsoleApp/`` for your project. All files for the project should be contained in this folder.
-
-    .. code-block:: console
-
-        ~ $ mkdir ConsoleApp
-        ~ $ cd ConsoleApp/
-
- - Create a new file ``project.json`` with the following contents
-
-    .. literalinclude:: x-plat/sample/src/ConsoleApp/project.json
-            :language: json
-            :linenos:
-
- - Execute the following command to install the packages required for this project, including EntityFramework 7 and all its dependencies.
-
-    .. code-block:: console
-
-        ~/ConsoleApp/ $ dnu restore
-
- - Create a new file named ``Program.cs``. Add the following contents to
-
-    .. code-block:: c#
-        :linenos:
-
-        // Program.cs
-        using System;
-
-        namespace ConsoleApp
-        {
-            public class Program
-            {
-                public void Main(string[] args)
-                {
-                    Console.WriteLine("Hello dnx!");
-                }
-            }
-        }
-
-To verify that this project has all dependencies and packages installed, perform the following steps:
-
- - Verify execution of the program works by running ``dnx run``.
-
-    .. code-block:: console
-
-        ~/ConsoleApp/ $ dnx run
-        Hello dnx!
-
- - Verify that Entity Framework is installed by running ``dnx ef``.
-
-    .. code-block:: console
-
-        ~/ConsoleApp/ $ dnx ef
-
-                             _/\__
-                       ---==/    \\
-                 ___  ___   |.    \|\
-                | __|| __|  |  )   \\\
-                | _| | _|   \_/ |  //|\\
-                |___||_|       /   \\\/\\
-
-        Entity Framework Commands 7.0.0-beta7-15540
-
-        Usage: ef [options] [command]
-
-        Options:
-          --version     Show version information
-          -?|-h|--help  Show help information
-
-        Commands:
-          database    Commands to manage your database
-          dbcontext   Commands to manage your DbContext types
-          migrations  Commands to manage your migrations
-
-        Use "ef [command] --help" for more information about a command.
-
-
-Create your model
------------------
-
-With this new project, you are ready to begin using Entity Framework.
-We will create a simple console application that allows us to write a
-blog post from the command line.
-
- - Create a new file called ``Model.cs``
-    All classes in follow steps will be added to this file.
-
-        .. literalinclude:: x-plat/sample/src/ConsoleApp/Model.cs
-            :language: c#
-            :linenos:
-            :lines: 1-8
-
- - Add a new class to represent the SQLite database.
-    We will call this ``BloggingContext``. Note that to configure this for SQLite, we must call ``UseSqlite()`` with a connection string pointing to the \*.db file.
-    Note that we are making the path relative to the application path, rather than the current working directory of the invoking process.
-
-        .. literalinclude:: x-plat/sample/src/ConsoleApp/Model.cs
-            :language: c#
-            :linenos:
-            :lines: 9-21
-            :emphasize-lines: 1, 10
-
- - Add classes to represent tables.
-    Note that we will be using foreign keys to associate many posts to one blog.
-
-        .. literalinclude:: x-plat/sample/src/ConsoleApp/Model.cs
-            :language: c#
-            :linenos:
-            :lines: 22-39
-
- - To make sure the files are correct, you can compile the project on the command line by running ``dnu build --quiet``
-
-    .. code-block:: console
-        :emphasize-lines: 4-6
-
-        ~/ConsoleApp/ $ dnu build --quiet
-        Microsoft .NET Development Utility Mono-x86-1.0.0-beta6
-
-        Build succeeded.
-            0 Warning(s)
-            0 Error(s)
-
-        Total build time elapsed: 00:00:01.9609581
-        Total projects built: 1
-
-Create your database
---------------------
-
-We can now use Entity Framework commands to create and manage the schema of our database.
-
- - Create the first migration.
-    Execute the command below to generate your first migration.
-    This will find our context and models, and generate a migration for us in a folder named ``Migrations/``
-
-    .. code-block:: console
-
-        ~/ConsoleApp/ $ dnx ef migrations add MyFirstMigration
-
- - Apply the migrations.
-    You can now begin using the existing migration to create the database file and creates the tables.
-
-    .. code-block:: console
-
-        ~/ConsoleApp/ $ dnx ef database update
-
-    This should create a new file, ``blog.db`` which contains two empty tables.
-
-Use your model
---------------
-
-Now that we have configured our model and created the database schema, we can use BloggingContext to create, update, and delete objects.
-
-.. literalinclude:: x-plat/sample/src/ConsoleApp/Program.cs
-    :language: c#
-    :linenos:
-
-Start your app
---------------
-
-Run the application from the command line.
-
-    .. code-block:: console
-
-        ~/ConsoleApp/ $ dnx run
-        1 records saved to database
-
-        All blogs in database:
-          - http://blogs.msdn.com/adonet
-
-After adding the new post, you can verify the data has been added by inspecting the SQLite database file, ``blog.db``.
-
-
-Workarounds
------------
-
-This demo was written for beta 7, which has bugs in it. The following workarounds will make this sample project work for beta 7.
-
-Add a Startup class to your project
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-When generating migrations, you may see this error message:
-
-.. code-block:: console
-
-    System.InvalidOperationException: A type named 'StartupProduction' or 'Startup' could not be found in assembly 'ConsoleApp'.
-
-To get around this, add the following into your project.
-
-.. literalinclude:: x-plat/sample/src/ConsoleApp/Program.cs
-    :linenos:
-    :language: c#
-    :lines: 25-30
diff --git a/docs/getting-started/x-plat/issues.rst b/docs/getting-started/x-plat/issues.rst
deleted file mode 100644
index a24585690f..0000000000
--- a/docs/getting-started/x-plat/issues.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-- Bugs in Mono 4.0.2 may cause Entity Framework to crash when using async methods. This is resolved with `Mono 4.2.0 <http://www.mono-project.com/docs/about-mono/releases/4.2.0/>`_, which is available as an alpha release (at time of writing).
-- Migrations on SQLite do not support more complex schema changes due to limitations in SQLite itself.
-
-- Bugs in beta 7. See `Workarounds`_.
-    - Migrations requires that you have a "Startup" class in your project. `Issue #2357 <https://github.com/aspnet/EntityFramework/issues/2357>`_.
diff --git a/docs/getting-started/x-plat/sample/.gitignore b/docs/getting-started/x-plat/sample/.gitignore
deleted file mode 100644
index c97c3bb7ae..0000000000
--- a/docs/getting-started/x-plat/sample/.gitignore
+++ /dev/null
@@ -1,4 +0,0 @@
-.DS_Store
-Thumbs.db
-project.lock.json
-*.db
diff --git a/docs/getting-started/x-plat/sample/global.json b/docs/getting-started/x-plat/sample/global.json
deleted file mode 100644
index 2948c23c09..0000000000
--- a/docs/getting-started/x-plat/sample/global.json
+++ /dev/null
@@ -1,6 +0,0 @@
-{
-    "projects": [ "src" ],
-    "sdk": {
-        "version": "1.0.0-beta7"
-    }
-}
diff --git a/docs/getting-started/x-plat/sample/src/ConsoleApp/Migrations/20150901220808_MyFirstMigration.Designer.cs b/docs/getting-started/x-plat/sample/src/ConsoleApp/Migrations/20150901220808_MyFirstMigration.Designer.cs
deleted file mode 100644
index 5da775d32e..0000000000
--- a/docs/getting-started/x-plat/sample/src/ConsoleApp/Migrations/20150901220808_MyFirstMigration.Designer.cs
+++ /dev/null
@@ -1,57 +0,0 @@
-using System;
-using Microsoft.Data.Entity;
-using Microsoft.Data.Entity.Infrastructure;
-using Microsoft.Data.Entity.Metadata;
-using Microsoft.Data.Entity.Migrations;
-using ConsoleApp;
-
-namespace ConsoleApp.Migrations
-{
-    [DbContext(typeof(BloggingContext))]
-    partial class MyFirstMigration
-    {
-        public override string Id
-        {
-            get { return "20150901220808_MyFirstMigration"; }
-        }
-
-        protected override void BuildTargetModel(ModelBuilder modelBuilder)
-        {
-            modelBuilder
-                .Annotation("ProductVersion", "7.0.0-beta7-15540");
-
-            modelBuilder.Entity("ConsoleApp.Blog", b =>
-                {
-                    b.Property<int>("BlogId")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("Url");
-
-                    b.Key("BlogId");
-                });
-
-            modelBuilder.Entity("ConsoleApp.Post", b =>
-                {
-                    b.Property<int>("PostId")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BlogId");
-
-                    b.Property<string>("Content");
-
-                    b.Property<string>("Title");
-
-                    b.Key("PostId");
-                });
-
-            modelBuilder.Entity("ConsoleApp.Post", b =>
-                {
-                    b.Reference("ConsoleApp.Blog")
-                        .InverseCollection()
-                        .ForeignKey("BlogId");
-                });
-        }
-    }
-}
diff --git a/docs/getting-started/x-plat/sample/src/ConsoleApp/Migrations/20150901220808_MyFirstMigration.cs b/docs/getting-started/x-plat/sample/src/ConsoleApp/Migrations/20150901220808_MyFirstMigration.cs
deleted file mode 100644
index 2976ae1d64..0000000000
--- a/docs/getting-started/x-plat/sample/src/ConsoleApp/Migrations/20150901220808_MyFirstMigration.cs
+++ /dev/null
@@ -1,51 +0,0 @@
-using System;
-using System.Collections.Generic;
-using Microsoft.Data.Entity.Migrations;
-
-namespace ConsoleApp.Migrations
-{
-    public partial class MyFirstMigration : Migration
-    {
-        protected override void Up(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.CreateTable(
-                name: "Blog",
-                columns: table => new
-                {
-                    BlogId = table.Column<int>(isNullable: false)
-                        .Annotation("Sqlite:Autoincrement", true),
-                    Name = table.Column<string>(isNullable: true),
-                    Url = table.Column<string>(isNullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_Blog", x => x.BlogId);
-                });
-            migrationBuilder.CreateTable(
-                name: "Post",
-                columns: table => new
-                {
-                    PostId = table.Column<int>(isNullable: false)
-                        .Annotation("Sqlite:Autoincrement", true),
-                    BlogId = table.Column<int>(isNullable: false),
-                    Content = table.Column<string>(isNullable: true),
-                    Title = table.Column<string>(isNullable: true)
-                },
-                constraints: table =>
-                {
-                    table.PrimaryKey("PK_Post", x => x.PostId);
-                    table.ForeignKey(
-                        name: "FK_Post_Blog_BlogId",
-                        column: x => x.BlogId,
-                        principalTable: "Blog",
-                        principalColumn: "BlogId");
-                });
-        }
-
-        protected override void Down(MigrationBuilder migrationBuilder)
-        {
-            migrationBuilder.DropTable("Post");
-            migrationBuilder.DropTable("Blog");
-        }
-    }
-}
diff --git a/docs/getting-started/x-plat/sample/src/ConsoleApp/Migrations/BloggingContextModelSnapshot.cs b/docs/getting-started/x-plat/sample/src/ConsoleApp/Migrations/BloggingContextModelSnapshot.cs
deleted file mode 100644
index bfa1b3f718..0000000000
--- a/docs/getting-started/x-plat/sample/src/ConsoleApp/Migrations/BloggingContextModelSnapshot.cs
+++ /dev/null
@@ -1,52 +0,0 @@
-using System;
-using Microsoft.Data.Entity;
-using Microsoft.Data.Entity.Infrastructure;
-using Microsoft.Data.Entity.Metadata;
-using Microsoft.Data.Entity.Migrations;
-using ConsoleApp;
-
-namespace ConsoleApp.Migrations
-{
-    [DbContext(typeof(BloggingContext))]
-    partial class BloggingContextModelSnapshot : ModelSnapshot
-    {
-        protected override void BuildModel(ModelBuilder modelBuilder)
-        {
-            modelBuilder
-                .Annotation("ProductVersion", "7.0.0-beta7-15540");
-
-            modelBuilder.Entity("ConsoleApp.Blog", b =>
-                {
-                    b.Property<int>("BlogId")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<string>("Name");
-
-                    b.Property<string>("Url");
-
-                    b.Key("BlogId");
-                });
-
-            modelBuilder.Entity("ConsoleApp.Post", b =>
-                {
-                    b.Property<int>("PostId")
-                        .ValueGeneratedOnAdd();
-
-                    b.Property<int>("BlogId");
-
-                    b.Property<string>("Content");
-
-                    b.Property<string>("Title");
-
-                    b.Key("PostId");
-                });
-
-            modelBuilder.Entity("ConsoleApp.Post", b =>
-                {
-                    b.Reference("ConsoleApp.Blog")
-                        .InverseCollection()
-                        .ForeignKey("BlogId");
-                });
-        }
-    }
-}
diff --git a/docs/getting-started/x-plat/sample/src/ConsoleApp/Model.cs b/docs/getting-started/x-plat/sample/src/ConsoleApp/Model.cs
deleted file mode 100644
index 4a0c086322..0000000000
--- a/docs/getting-started/x-plat/sample/src/ConsoleApp/Model.cs
+++ /dev/null
@@ -1,40 +0,0 @@
-using System.Collections.Generic;
-using Microsoft.Data.Entity;
-using Microsoft.Dnx.Runtime;
-using Microsoft.Dnx.Runtime.Infrastructure;
-using Microsoft.Framework.DependencyInjection;
-
-namespace ConsoleApp
-{
-    public class BloggingContext : DbContext
-    {
-        public DbSet<Blog> Blogs { get; set; }
-        public DbSet<Post> Posts { get; set; }
-
-        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
-        {
-            var appEnv = CallContextServiceLocator.Locator.ServiceProvider
-                            .GetRequiredService<IApplicationEnvironment>();
-            optionsBuilder.UseSqlite($"Data Source={ appEnv.ApplicationBasePath }/blog.db");
-        }
-    }
-
-    public class Blog
-    {
-        public int BlogId { get; set; }
-        public string Url { get; set; }
-        public string Name { get; set; }
-
-        public List<Post> Posts { get; set; }
-    }
-
-    public class Post
-    {
-        public int PostId { get; set; }
-        public string Title { get; set; }
-        public string Content { get; set; }
-
-        public int BlogId { get; set; }
-        public Blog Blog { get; set; }
-    }
-}
diff --git a/docs/getting-started/x-plat/sample/src/ConsoleApp/Program.cs b/docs/getting-started/x-plat/sample/src/ConsoleApp/Program.cs
deleted file mode 100644
index 6d4f3940c7..0000000000
--- a/docs/getting-started/x-plat/sample/src/ConsoleApp/Program.cs
+++ /dev/null
@@ -1,31 +0,0 @@
-using System;
-
-namespace ConsoleApp
-{
-    public class Program
-    {
-        public void Main(string[] args)
-        {
-            using (var db = new BloggingContext())
-            {
-                db.Blogs.Add(new Blog { Url = "http://blogs.msdn.com/adonet" });
-                var count = db.SaveChanges();
-                Console.WriteLine("{0} records saved to database", count);
-
-                Console.WriteLine();
-                Console.WriteLine("All blogs in database:");
-                foreach (var blog in db.Blogs)
-                {
-                    Console.WriteLine(" - {0}", blog.Url);
-                }
-            }
-        }
-    }
-
-    // TODO: Remove. Will be unnecessary when bug #2357 fixed
-    // See https://github.com/aspnet/EntityFramework/issues/2357
-    public class Startup
-    {
-        public void Configure() { }
-    }
-}
diff --git a/docs/getting-started/x-plat/sample/src/ConsoleApp/project.json b/docs/getting-started/x-plat/sample/src/ConsoleApp/project.json
deleted file mode 100644
index 65c9b670da..0000000000
--- a/docs/getting-started/x-plat/sample/src/ConsoleApp/project.json
+++ /dev/null
@@ -1,19 +0,0 @@
-{
-    "dependencies": {
-        "EntityFramework.Sqlite": "7.0.0-beta7",
-        "EntityFramework.Commands": "7.0.0-beta7",
-        "Microsoft.Dnx.Runtime.Abstractions": "1.0.0-beta7"
-    },
-    "commands": {
-        "run": "ConsoleApp",
-        "ef": "EntityFramework.Commands"
-    },
-    "frameworks": {
-        "dnx451": { },
-        "dnxcore50": {
-            "dependencies": {
-                "System.Console": "4.0.0-beta-*"
-            }
-        }
-    }
-}
diff --git a/docs/global-header.txt b/docs/global-header.txt
deleted file mode 100644
index 5940ccaf40..0000000000
--- a/docs/global-header.txt
+++ /dev/null
@@ -1,2 +0,0 @@
-.. caution::
-    This documentation is for EF7 onwards. For EF6.x and earlier release see http://msdn.com/data/ef.
diff --git a/docs/index.rst b/docs/index.rst
deleted file mode 100644
index 499e8faaa8..0000000000
--- a/docs/index.rst
+++ /dev/null
@@ -1,17 +0,0 @@
-Entity Framework Documentation
-==============================
-
-.. include:: stub-overview.txt
-
-.. toctree::
-    :titlesonly:
-
-    getting-started/index
-    providers/index
-    modeling/index
-
-Contribute
-----------
-
-**We accept pull requests!** But you're more likely to have yours accepted if you follow the `guidelines for contributing <https://github.com/aspnet/EntityFramework.Docs/blob/master/CONTRIBUTING.md>`_.
-
diff --git a/docs/make.bat b/docs/make.bat
deleted file mode 100644
index 46e043d37f..0000000000
--- a/docs/make.bat
+++ /dev/null
@@ -1,263 +0,0 @@
-@ECHO OFF
-
-REM Command file for Sphinx documentation
-
-if "%SPHINXBUILD%" == "" (
-	set SPHINXBUILD=sphinx-build
-)
-set BUILDDIR=_build
-set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% .
-set I18NSPHINXOPTS=%SPHINXOPTS% .
-if NOT "%PAPER%" == "" (
-	set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS%
-	set I18NSPHINXOPTS=-D latex_paper_size=%PAPER% %I18NSPHINXOPTS%
-)
-
-if "%1" == "" goto help
-
-if "%1" == "help" (
-	:help
-	echo.Please use `make ^<target^>` where ^<target^> is one of
-	echo.  html       to make standalone HTML files
-	echo.  dirhtml    to make HTML files named index.html in directories
-	echo.  singlehtml to make a single large HTML file
-	echo.  pickle     to make pickle files
-	echo.  json       to make JSON files
-	echo.  htmlhelp   to make HTML files and a HTML help project
-	echo.  qthelp     to make HTML files and a qthelp project
-	echo.  devhelp    to make HTML files and a Devhelp project
-	echo.  epub       to make an epub
-	echo.  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter
-	echo.  text       to make text files
-	echo.  man        to make manual pages
-	echo.  texinfo    to make Texinfo files
-	echo.  gettext    to make PO message catalogs
-	echo.  changes    to make an overview over all changed/added/deprecated items
-	echo.  xml        to make Docutils-native XML files
-	echo.  pseudoxml  to make pseudoxml-XML files for display purposes
-	echo.  linkcheck  to check all external links for integrity
-	echo.  doctest    to run all doctests embedded in the documentation if enabled
-	echo.  coverage   to run coverage check of the documentation if enabled
-	goto end
-)
-
-if "%1" == "clean" (
-	for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i
-	del /q /s %BUILDDIR%\*
-	goto end
-)
-
-
-REM Check if sphinx-build is available and fallback to Python version if any
-%SPHINXBUILD% 2> nul
-if errorlevel 9009 goto sphinx_python
-goto sphinx_ok
-
-:sphinx_python
-
-set SPHINXBUILD=python -m sphinx.__init__
-%SPHINXBUILD% 2> nul
-if errorlevel 9009 (
-	echo.
-	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
-	echo.installed, then set the SPHINXBUILD environment variable to point
-	echo.to the full path of the 'sphinx-build' executable. Alternatively you
-	echo.may add the Sphinx directory to PATH.
-	echo.
-	echo.If you don't have Sphinx installed, grab it from
-	echo.http://sphinx-doc.org/
-	exit /b 1
-)
-
-:sphinx_ok
-
-
-if "%1" == "html" (
-	%SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The HTML pages are in %BUILDDIR%/html.
-	goto end
-)
-
-if "%1" == "dirhtml" (
-	%SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml.
-	goto end
-)
-
-if "%1" == "singlehtml" (
-	%SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml.
-	goto end
-)
-
-if "%1" == "pickle" (
-	%SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can process the pickle files.
-	goto end
-)
-
-if "%1" == "json" (
-	%SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can process the JSON files.
-	goto end
-)
-
-if "%1" == "htmlhelp" (
-	%SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can run HTML Help Workshop with the ^
-.hhp project file in %BUILDDIR%/htmlhelp.
-	goto end
-)
-
-if "%1" == "qthelp" (
-	%SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can run "qcollectiongenerator" with the ^
-.qhcp project file in %BUILDDIR%/qthelp, like this:
-	echo.^> qcollectiongenerator %BUILDDIR%\qthelp\EntityFramework.qhcp
-	echo.To view the help file:
-	echo.^> assistant -collectionFile %BUILDDIR%\qthelp\EntityFramework.ghc
-	goto end
-)
-
-if "%1" == "devhelp" (
-	%SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished.
-	goto end
-)
-
-if "%1" == "epub" (
-	%SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The epub file is in %BUILDDIR%/epub.
-	goto end
-)
-
-if "%1" == "latex" (
-	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; the LaTeX files are in %BUILDDIR%/latex.
-	goto end
-)
-
-if "%1" == "latexpdf" (
-	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
-	cd %BUILDDIR%/latex
-	make all-pdf
-	cd %~dp0
-	echo.
-	echo.Build finished; the PDF files are in %BUILDDIR%/latex.
-	goto end
-)
-
-if "%1" == "latexpdfja" (
-	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
-	cd %BUILDDIR%/latex
-	make all-pdf-ja
-	cd %~dp0
-	echo.
-	echo.Build finished; the PDF files are in %BUILDDIR%/latex.
-	goto end
-)
-
-if "%1" == "text" (
-	%SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The text files are in %BUILDDIR%/text.
-	goto end
-)
-
-if "%1" == "man" (
-	%SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The manual pages are in %BUILDDIR%/man.
-	goto end
-)
-
-if "%1" == "texinfo" (
-	%SPHINXBUILD% -b texinfo %ALLSPHINXOPTS% %BUILDDIR%/texinfo
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The Texinfo files are in %BUILDDIR%/texinfo.
-	goto end
-)
-
-if "%1" == "gettext" (
-	%SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The message catalogs are in %BUILDDIR%/locale.
-	goto end
-)
-
-if "%1" == "changes" (
-	%SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.The overview file is in %BUILDDIR%/changes.
-	goto end
-)
-
-if "%1" == "linkcheck" (
-	%SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Link check complete; look for any errors in the above output ^
-or in %BUILDDIR%/linkcheck/output.txt.
-	goto end
-)
-
-if "%1" == "doctest" (
-	%SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Testing of doctests in the sources finished, look at the ^
-results in %BUILDDIR%/doctest/output.txt.
-	goto end
-)
-
-if "%1" == "coverage" (
-	%SPHINXBUILD% -b coverage %ALLSPHINXOPTS% %BUILDDIR%/coverage
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Testing of coverage in the sources finished, look at the ^
-results in %BUILDDIR%/coverage/python.txt.
-	goto end
-)
-
-if "%1" == "xml" (
-	%SPHINXBUILD% -b xml %ALLSPHINXOPTS% %BUILDDIR%/xml
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The XML files are in %BUILDDIR%/xml.
-	goto end
-)
-
-if "%1" == "pseudoxml" (
-	%SPHINXBUILD% -b pseudoxml %ALLSPHINXOPTS% %BUILDDIR%/pseudoxml
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The pseudo-XML files are in %BUILDDIR%/pseudoxml.
-	goto end
-)
-
-:end
diff --git a/docs/modeling/configuring.rst b/docs/modeling/configuring.rst
deleted file mode 100644
index 4ff3f7ef13..0000000000
--- a/docs/modeling/configuring.rst
+++ /dev/null
@@ -1,295 +0,0 @@
-Configuring Your Model
-======================
-
-Entity Framework uses a set of :doc:`default-conventions` to build a model based on the shape of your entity classes. You can specify additional configuration to supplement and/or override what was discovered by convention.
-
-.. note::
-    This article covers configuration that can be applied to a model targeting any data store and that which can be applied when targeting any relational database.
-    Providers may also enable configuration that is specific to a particular data store. For documentation on provider specific configuration see the the :doc:`/providers/index` section.
-
-In this article:
-    - `Methods of configuration`_
-        - `Fluent API`_
-        - `Data Annotations`_
-    - `Keys`_
-    - `Indexes`_
-    - `Required`_
-    - `Generated Properties (Identity, Computed, Store Defaults, etc.)`_
-    - `Maximum Length`_
-    - `Concurrency Tokens`_
-    - `Ignoring Types and Properties`_
-    - `Relational database configuration`_
-        - `Relational table`_
-        - `Relational column`_
-        - `Relational data type`_
-
-`View this article's samples on GitHub <https://github.com/aspnet/EntityFramework.Docs/tree/master/docs/modeling/configuring/sample>`_.
-
-.. note::
-    This article uses EF 7.0.0-beta7 which is the latest pre-release available on NuGet.org.
-
-    You can find nightly builds of the EF7 code base hosted on https://www.myget.org/F/aspnetvnext/api/v2/ but the code base is rapidly changing and we do not maintain up-to-date documentation for getting started.
-
-Methods of configuration
-------------------------
-
-Fluent API
-^^^^^^^^^^
-
-You can override the ``OnModelCreating`` method in your derived context and use the ``ModelBuilder`` API to configure your model. This is the most powerful method of configuration and allows configuration to be specified without modifying your entity classes.
-
-.. literalinclude:: configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Required.cs
-        :language: c#
-        :lines: 5-15
-        :emphasize-lines: 5-10
-        :linenos:
-
-Data Annotations
-^^^^^^^^^^^^^^^^
-
-.. caution::
-    Data Annotations are not yet fully implemented in Entity Framework 7. You can still add annotations to your entity classes so that they are used by other frameworks (such as ASP.NET MVC), but Entity Framework will not process these annotations. You can track `support for Data Annotations on GitHub <https://github.com/aspnet/EntityFramework/issues/107>`_.
-
-Keys
-----
-
-A key serves as the primary unique identifier for each entity instance. When using a relational database this maps to the concept of a *primary key*.
-
-The following fragment shows how to configure a single property to be the key of an entity. In this case ``LicensePlate`` is the primary key of ``Car`` but will not have been detected by the default conventions.
-
-.. literalinclude:: configuring/sample/EFModeling.Configuring.FluentAPI/Samples/KeySingle.cs
-        :language: c#
-        :lines: 5-22
-        :emphasize-lines: 7-8
-        :linenos:
-
-Building on the previous example, let's say that the primary key of ``Car`` is made up of two properties (``State`` and ``LicensePlate``).
-
-.. literalinclude:: configuring/sample/EFModeling.Configuring.FluentAPI/Samples/KeyComposite.cs
-        :language: c#
-        :lines: 5-23
-        :emphasize-lines: 7-8
-        :linenos:
-
-Indexes
--------
-
-Indexes are a common concept across many data stores. While their implementation in the data store may vary, they are used to make lookups based on a column (or set of columns) more efficient.
-
-The following code shows how to specify an index on a single property. By default, indexes are non-unique.
-
-.. literalinclude:: configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Index.cs
-        :language: c#
-        :lines: 5-20
-        :emphasize-lines: 7-8
-        :linenos:
-
-You can also specify that an idex should be unique, meaning that no two entities can have the same value(s) for the given property(s).
-
-.. literalinclude:: configuring/sample/EFModeling.Configuring.FluentAPI/Samples/IndexUnique.cs
-        :language: c#
-        :lines: 11-13
-        :emphasize-lines: 3
-        :linenos:
-
-You can also specify an index over more than one column.
-
-.. literalinclude:: configuring/sample/EFModeling.Configuring.FluentAPI/Samples/IndexComposite.cs
-        :language: c#
-        :lines: 5-21
-        :emphasize-lines: 7-8
-        :linenos:
-
-Required
---------
-
-By default, a property whose type can contain null will be configured as optional (i.e. CLR *reference types* such as ``string``, ``int?``, ``byte[]``, etc.). However, these properties can be configured to be required.
-
-.. literalinclude:: configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Required.cs
-        :language: c#
-        :lines: 5-21
-        :emphasize-lines: 7-9
-        :linenos:
-
-.. note::
-    A property whose type can not contain null can not be configured as optional (i.e. CLR *value types* such as ``int``, ``bool``, ``decimal``, etc.).
-
-Generated Properties (Identity, Computed, Store Defaults, etc.)
----------------------------------------------------------------
-
-.. note::
-    **Sentinel Values**
-
-    EF uses a "sentinel value" to detect whether a value has been specified or not. By default the sentinel value is the CLR default for the property type (``null`` for ``string``, ``0`` for ``int``, etc.).
-
-    If the property is assigned something other than the sentinel value, then EF will attempt to save the specified value to the database **regardless of the value generation strategy that is configured**.
-
-    You can change the sentinel value for a given property. The most common case for doing this is a property that does not use value generation where you want to be able to save a record with the default sentinel value. For example, if you want to be able to save the value `0` for an integer primary key, you would need to change the sentinel value to something other than `0`.
-
-    .. literalinclude:: configuring/sample/EFModeling.Configuring.FluentAPI/Samples/SentinelValue.cs
-            :language: c#
-            :lines: 9-16
-            :emphasize-lines: 7
-            :linenos:
-
-There are three value generation patterns that can be used for properties.
-
-No value generation
-^^^^^^^^^^^^^^^^^^^
-
-No value generation means that you will always supply a valid value to be saved to the database.
-
-.. literalinclude:: configuring/sample/EFModeling.Configuring.FluentAPI/Samples/ValueGeneratedNever.cs
-        :language: c#
-        :lines: 5-22
-        :emphasize-lines: 7-9
-        :linenos:
-
-Value generated on add
-^^^^^^^^^^^^^^^^^^^^^^
-
-Value generated on add means that if you don't specify a value one will be generated for you. This value may be generated client side by EF, or in the database.
-
-.. literalinclude:: configuring/sample/EFModeling.Configuring.FluentAPI/Samples/ValueGeneratedOnAdd.cs
-        :language: c#
-        :lines: 5-22
-        :emphasize-lines: 7-9
-        :linenos:
-
-Value generated on add or update
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Value generated on add or update means that a new value is generated every time the record is saved (insert or update).
-
-.. literalinclude:: configuring/sample/EFModeling.Configuring.FluentAPI/Samples/ValueGeneratedOnAddOrUpdate.cs
-        :language: c#
-        :lines: 6-24
-        :emphasize-lines: 7-9
-        :linenos:
-
-Maximum Length
---------------
-
-Configuring a maximum length provides a hint to the data store about the appropriate data type to use for a given property.
-
-The following code allows the store to choose an appropraite data type for ``Blog.Url`` based on the fact it should only ever contain 500 characters. When targetting SQL Server this would result in the ``nvarchar(500)`` data type being used.
-
-.. literalinclude:: configuring/sample/EFModeling.Configuring.FluentAPI/Samples/MaxLength.cs
-        :language: c#
-        :lines: 5-21
-        :emphasize-lines: 7-9
-        :linenos:
-
-.. note::
-    Entity Framework does not do any validation of maximum length before passing data to the provider. It is up to the provider or data store to validate if appropriate.
-
-    For example, when targetting SQL Server, exceding the maximum length will result in an exception as the data type of the underlying column will not allow excess data to be stored.
-
-Concurrency Tokens
-------------------
-
-If a property is configured as a concurrency token then EF will check that no other user has modified that value in the database when saving changes to that record. EF uses an optimistic concurrency pattern, meaning it will assume the value has not changed and try to save the data, but throw if it finds the value has been changed.
-
-For example we may want to configure ``SocialSecurityNumber`` on ``Person`` to be a concurrency token. This means that if one user tries to save some changes to a Person, but another user has changed the ``SocialSecurityNumber`` then an exception will be thrown. This may be desirable so that our application can prompt the user to ensure this record still represents the same actual person before saving their changes.
-
-.. literalinclude:: configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Concurrency.cs
-        :language: c#
-        :lines: 5-22
-        :emphasize-lines: 7-9
-        :linenos:
-
-How concurrency tokens work in EF
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Data stores can enforce concurrency tokens by checking that any record being updated or deleted still has the same value for the concurrency token that was assigned when the context originally loaded the data from the database.
-
-For example, relational database achieve this by including the concurrency token in the ``WHERE`` clause of any ``UPDATE`` or ``DELETE`` commands and checking the number of rows that were affected. If the concurrency token still matches then one row will be updated. If the value in the database has changed, then no rows are updated.
-
-.. code-block:: sql
-
-    UPDATE [Person] SET [Name] = @p1
-    WHERE [PersonId] = @p0 AND [SocialSecurityNumber] = @p2;
-
-Ignoring Types and Properties
------------------------------
-
-EF uses conventions to discover the types and properties that should be included in your model. Including a type or property in your model means that it will be saved to and queried from the database.
-
-Ignore a type
-^^^^^^^^^^^^^
-
-The following code shows how to ignore an entire type from your model.
-
-.. literalinclude:: configuring/sample/EFModeling.Configuring.FluentAPI/Samples/IgnoreType.cs
-        :language: c#
-        :lines: 6-22
-        :emphasize-lines: 7
-        :linenos:
-
-Ignore a property
-^^^^^^^^^^^^^^^^^
-
-The following code shows how to ignore a property from a type.
-
-.. literalinclude:: configuring/sample/EFModeling.Configuring.FluentAPI/Samples/IgnoreProperty.cs
-        :language: c#
-        :lines: 6-23
-        :emphasize-lines: 7-8
-        :linenos:
-
-Relational database configuration
----------------------------------
-
-The configuration in this section is applicable to relational databases in general. The extension methods shown here will become available when you install a relational database provider (due to the shared *EntityFramework.Relational* package).
-
-.. note::
-    Not all relational database will support all configuration shown here. For example, SQLite does not support the concept of schemas.
-
-Relational table
-^^^^^^^^^^^^^^^^
-
-The following code maps the ``Blog`` class to a ``blogs`` table in the database.
-
-.. literalinclude:: configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Relational/Table.cs
-        :language: c#
-        :lines: 5-20
-        :emphasize-lines: 7-8
-        :linenos:
-
-You can also specify a schema that the table belongs to.
-
-.. literalinclude:: configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Relational/TableAndSchema.cs
-        :language: c#
-        :lines: 11-12
-        :emphasize-lines: 2
-        :linenos:
-
-Relational column
-^^^^^^^^^^^^^^^^^
-
-The following code maps the ``Blog.BlogId`` property to a ``blog_id`` column in the database.
-
-.. literalinclude:: configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Relational/Column.cs
-        :language: c#
-        :lines: 5-21
-        :emphasize-lines: 7-9
-        :linenos:
-
-Relational data type
-^^^^^^^^^^^^^^^^^^^^
-
-The following code specifies that the column for ``Blog.Url`` should use the ``varchar(200)`` datatype.
-
-.. literalinclude:: configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Relational/DataType.cs
-        :language: c#
-        :lines: 5-21
-        :emphasize-lines: 7-9
-        :linenos:
-
-If you are targetting more than one relational provider with the same model then you probably want to specify a data type for each provider rather than a global one to be used for all relational providers.
-
-.. literalinclude:: configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Relational/DataTypeForProvider.cs
-        :language: c#
-        :lines: 11-13
-        :emphasize-lines: 3
-        :linenos:
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/App.config b/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/App.config
deleted file mode 100644
index a243592125..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/App.config
+++ /dev/null
@@ -1,34 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<configuration>
-    <startup> 
-        <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6" />
-    </startup>
-  <runtime>
-    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
-      <dependentAssembly>
-        <assemblyIdentity name="System.Collections" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
-        <bindingRedirect oldVersion="0.0.0.0-4.0.10.0" newVersion="4.0.10.0" />
-      </dependentAssembly>
-      <dependentAssembly>
-        <assemblyIdentity name="System.Diagnostics.Debug" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
-        <bindingRedirect oldVersion="0.0.0.0-4.0.10.0" newVersion="4.0.10.0" />
-      </dependentAssembly>
-      <dependentAssembly>
-        <assemblyIdentity name="System.Runtime.Extensions" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
-        <bindingRedirect oldVersion="0.0.0.0-4.0.10.0" newVersion="4.0.10.0" />
-      </dependentAssembly>
-      <dependentAssembly>
-        <assemblyIdentity name="System.Threading" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
-        <bindingRedirect oldVersion="0.0.0.0-4.0.10.0" newVersion="4.0.10.0" />
-      </dependentAssembly>
-      <dependentAssembly>
-        <assemblyIdentity name="System.Globalization" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
-        <bindingRedirect oldVersion="0.0.0.0-4.0.10.0" newVersion="4.0.10.0" />
-      </dependentAssembly>
-      <dependentAssembly>
-        <assemblyIdentity name="System.Collections.Immutable" publicKeyToken="b03f5f7f11d50a3a" culture="neutral" />
-        <bindingRedirect oldVersion="0.0.0.0-1.1.37.0" newVersion="1.1.37.0" />
-      </dependentAssembly>
-    </assemblyBinding>
-  </runtime>
-</configuration>
\ No newline at end of file
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/EFModeling.Configuring.FluentAPI.csproj b/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/EFModeling.Configuring.FluentAPI.csproj
deleted file mode 100644
index 59cb4a92a5..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/EFModeling.Configuring.FluentAPI.csproj
+++ /dev/null
@@ -1,147 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<Project ToolsVersion="14.0" DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
-  <Import Project="$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props" Condition="Exists('$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props')" />
-  <PropertyGroup>
-    <Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>
-    <Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>
-    <ProjectGuid>{20E1786B-FA14-4470-8B90-62A0C197E54D}</ProjectGuid>
-    <OutputType>Exe</OutputType>
-    <AppDesignerFolder>Properties</AppDesignerFolder>
-    <RootNamespace>EFModeling.Configuring.FluentAPI</RootNamespace>
-    <AssemblyName>EFModeling.Configuring.FluentAPI</AssemblyName>
-    <TargetFrameworkVersion>v4.6</TargetFrameworkVersion>
-    <FileAlignment>512</FileAlignment>
-    <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
-  </PropertyGroup>
-  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
-    <PlatformTarget>AnyCPU</PlatformTarget>
-    <DebugSymbols>true</DebugSymbols>
-    <DebugType>full</DebugType>
-    <Optimize>false</Optimize>
-    <OutputPath>bin\Debug\</OutputPath>
-    <DefineConstants>DEBUG;TRACE</DefineConstants>
-    <ErrorReport>prompt</ErrorReport>
-    <WarningLevel>4</WarningLevel>
-  </PropertyGroup>
-  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
-    <PlatformTarget>AnyCPU</PlatformTarget>
-    <DebugType>pdbonly</DebugType>
-    <Optimize>true</Optimize>
-    <OutputPath>bin\Release\</OutputPath>
-    <DefineConstants>TRACE</DefineConstants>
-    <ErrorReport>prompt</ErrorReport>
-    <WarningLevel>4</WarningLevel>
-  </PropertyGroup>
-  <ItemGroup>
-    <Reference Include="EntityFramework.Core, Version=7.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\EntityFramework.Core.7.0.0-beta7\lib\net45\EntityFramework.Core.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="EntityFramework.Relational, Version=7.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\EntityFramework.Relational.7.0.0-beta7\lib\net45\EntityFramework.Relational.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="EntityFramework.SqlServer, Version=7.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\EntityFramework.SqlServer.7.0.0-beta7\lib\net45\EntityFramework.SqlServer.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Microsoft.Framework.Caching.Abstractions, Version=1.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\Microsoft.Framework.Caching.Abstractions.1.0.0-beta7\lib\net45\Microsoft.Framework.Caching.Abstractions.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Microsoft.Framework.Caching.Memory, Version=1.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\Microsoft.Framework.Caching.Memory.1.0.0-beta7\lib\net45\Microsoft.Framework.Caching.Memory.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Microsoft.Framework.Configuration, Version=1.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\Microsoft.Framework.Configuration.1.0.0-beta7\lib\net45\Microsoft.Framework.Configuration.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Microsoft.Framework.Configuration.Abstractions, Version=1.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\Microsoft.Framework.Configuration.Abstractions.1.0.0-beta7\lib\net45\Microsoft.Framework.Configuration.Abstractions.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Microsoft.Framework.Configuration.Binder, Version=1.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\Microsoft.Framework.Configuration.Binder.1.0.0-beta7\lib\net45\Microsoft.Framework.Configuration.Binder.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Microsoft.Framework.DependencyInjection, Version=1.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\Microsoft.Framework.DependencyInjection.1.0.0-beta7\lib\net45\Microsoft.Framework.DependencyInjection.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Microsoft.Framework.DependencyInjection.Abstractions, Version=1.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\Microsoft.Framework.DependencyInjection.Abstractions.1.0.0-beta7\lib\net45\Microsoft.Framework.DependencyInjection.Abstractions.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Microsoft.Framework.Logging, Version=1.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\Microsoft.Framework.Logging.1.0.0-beta7\lib\net45\Microsoft.Framework.Logging.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Microsoft.Framework.Logging.Abstractions, Version=1.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\Microsoft.Framework.Logging.Abstractions.1.0.0-beta7\lib\net45\Microsoft.Framework.Logging.Abstractions.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Microsoft.Framework.OptionsModel, Version=1.0.0.0, Culture=neutral, processorArchitecture=MSIL">
-      <HintPath>..\packages\Microsoft.Framework.OptionsModel.1.0.0-beta7\lib\net45\Microsoft.Framework.OptionsModel.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="Remotion.Linq, Version=2.0.0.0, Culture=neutral, PublicKeyToken=fee00910d6e5f53b, processorArchitecture=MSIL">
-      <HintPath>..\packages\Remotion.Linq.2.0.0-beta-002\lib\net45\Remotion.Linq.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="System" />
-    <Reference Include="System.Collections.Concurrent" />
-    <Reference Include="System.Collections.Immutable, Version=1.1.37.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a, processorArchitecture=MSIL">
-      <HintPath>..\packages\System.Collections.Immutable.1.1.37-beta-23019\lib\dotnet\System.Collections.Immutable.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="System.ComponentModel.DataAnnotations" />
-    <Reference Include="System.Core" />
-    <Reference Include="System.Interactive.Async, Version=1.2.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL">
-      <HintPath>..\packages\Ix-Async.1.2.5\lib\net45\System.Interactive.Async.dll</HintPath>
-      <Private>True</Private>
-    </Reference>
-    <Reference Include="System.Transactions" />
-    <Reference Include="System.Xml.Linq" />
-    <Reference Include="System.Data.DataSetExtensions" />
-    <Reference Include="Microsoft.CSharp" />
-    <Reference Include="System.Data" />
-    <Reference Include="System.Net.Http" />
-    <Reference Include="System.Xml" />
-  </ItemGroup>
-  <ItemGroup>
-    <Compile Include="Samples\IgnoreProperty.cs" />
-    <Compile Include="Samples\IndexComposite.cs" />
-    <Compile Include="Samples\IndexUnique.cs" />
-    <Compile Include="Samples\KeyComposite.cs" />
-    <Compile Include="Samples\Index.cs" />
-    <Compile Include="Samples\Concurrency.cs" />
-    <Compile Include="Samples\MaxLength.cs" />
-    <Compile Include="Samples\IgnoreType.cs" />
-    <Compile Include="Samples\Relational\DataTypeForProvider.cs" />
-    <Compile Include="Samples\SentinelValue.cs" />
-    <Compile Include="Samples\ValueGeneratedOnAddOrUpdate.cs" />
-    <Compile Include="Samples\ValueGeneratedOnAdd.cs" />
-    <Compile Include="Samples\ValueGeneratedNever.cs" />
-    <Compile Include="Samples\Relational\DataType.cs" />
-    <Compile Include="Samples\Relational\Column.cs" />
-    <Compile Include="Samples\Relational\TableAndSchema.cs" />
-    <Compile Include="Samples\Relational\Table.cs" />
-    <Compile Include="Samples\Required.cs" />
-    <Compile Include="Samples\KeySingle.cs" />
-    <Compile Include="Program.cs" />
-    <Compile Include="Properties\AssemblyInfo.cs" />
-  </ItemGroup>
-  <ItemGroup>
-    <None Include="App.config" />
-    <None Include="packages.config" />
-  </ItemGroup>
-  <Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />
-  <!-- To modify your build process, add your task inside one of the targets below and uncomment it. 
-       Other similar extension points exist, see Microsoft.Common.targets.
-  <Target Name="BeforeBuild">
-  </Target>
-  <Target Name="AfterBuild">
-  </Target>
-  -->
-</Project>
\ No newline at end of file
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Program.cs b/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Program.cs
deleted file mode 100644
index 3154b93f00..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Program.cs
+++ /dev/null
@@ -1,16 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace EFModeling.Configuring.FluentAPI
-{
-    class Program
-    {
-        static void Main(string[] args)
-        {
-           
-        }
-    }
-}
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Properties/AssemblyInfo.cs b/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Properties/AssemblyInfo.cs
deleted file mode 100644
index 42e53efb80..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Properties/AssemblyInfo.cs
+++ /dev/null
@@ -1,36 +0,0 @@
-using System.Reflection;
-using System.Runtime.CompilerServices;
-using System.Runtime.InteropServices;
-
-// General Information about an assembly is controlled through the following 
-// set of attributes. Change these attribute values to modify the information
-// associated with an assembly.
-[assembly: AssemblyTitle("EFModeling.Configuring.FluentAPI")]
-[assembly: AssemblyDescription("")]
-[assembly: AssemblyConfiguration("")]
-[assembly: AssemblyCompany("")]
-[assembly: AssemblyProduct("EFModeling.Configuring.FluentAPI")]
-[assembly: AssemblyCopyright("Copyright ©  2015")]
-[assembly: AssemblyTrademark("")]
-[assembly: AssemblyCulture("")]
-
-// Setting ComVisible to false makes the types in this assembly not visible 
-// to COM components.  If you need to access a type in this assembly from 
-// COM, set the ComVisible attribute to true on that type.
-[assembly: ComVisible(false)]
-
-// The following GUID is for the ID of the typelib if this project is exposed to COM
-[assembly: Guid("20e1786b-fa14-4470-8b90-62a0c197e54d")]
-
-// Version information for an assembly consists of the following four values:
-//
-//      Major Version
-//      Minor Version 
-//      Build Number
-//      Revision
-//
-// You can specify all the values or you can default the Build and Revision Numbers 
-// by using the '*' as shown below:
-// [assembly: AssemblyVersion("1.0.*")]
-[assembly: AssemblyVersion("1.0.0.0")]
-[assembly: AssemblyFileVersion("1.0.0.0")]
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Concurrency.cs b/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Concurrency.cs
deleted file mode 100644
index da560ae51d..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Concurrency.cs
+++ /dev/null
@@ -1,23 +0,0 @@
-using Microsoft.Data.Entity;
-
-namespace EFModeling.Configuring.FluentAPI.Samples.Concurrency
-{
-    class MyContext : DbContext
-    {
-        public DbSet<Person> People { get; set; }
-
-        protected override void OnModelCreating(ModelBuilder modelBuilder)
-        {
-            modelBuilder.Entity<Person>()
-                .Property(p => p.SocialSecurityNumber)
-                .ConcurrencyToken();
-        }
-    }
-
-    public class Person
-    {
-        public int PersonId { get; set; }
-        public string SocialSecurityNumber { get; set; }
-        public string Name { get; set; }
-    }
-}
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/IgnoreProperty.cs b/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/IgnoreProperty.cs
deleted file mode 100644
index a675d84882..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/IgnoreProperty.cs
+++ /dev/null
@@ -1,24 +0,0 @@
-using Microsoft.Data.Entity;
-using System;
-
-namespace EFModeling.Configuring.FluentAPI.Samples.IgnoreProperty
-{
-    class MyContext : DbContext
-    {
-        public DbSet<Blog> Blogs { get; set; }
-
-        protected override void OnModelCreating(ModelBuilder modelBuilder)
-        {
-            modelBuilder.Entity<Blog>()
-                .Ignore(b => b.LoadedFromDatabase);
-        }
-    }
-
-    public class Blog
-    {
-        public int BlogId { get; set; }
-        public string Url { get; set; }
-
-        public DateTime LoadedFromDatabase { get; set; }
-    }
-}
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/IgnoreType.cs b/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/IgnoreType.cs
deleted file mode 100644
index fb4129e1b8..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/IgnoreType.cs
+++ /dev/null
@@ -1,28 +0,0 @@
-using Microsoft.Data.Entity;
-using System;
-
-namespace EFModeling.Configuring.FluentAPI.Samples.IgnoreType
-{
-    class MyContext : DbContext
-    {
-        public DbSet<Blog> Blogs { get; set; }
-
-        protected override void OnModelCreating(ModelBuilder modelBuilder)
-        {
-            modelBuilder.Ignore<BlogMetadata>();
-        }
-    }
-
-    public class Blog
-    {
-        public int BlogId { get; set; }
-        public string Url { get; set; }
-
-        public BlogMetadata Metadata { get; set; }
-    }
-
-    public class BlogMetadata
-    {
-        public DateTime LoadedFromDatabase { get; set; }
-    }
-}
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Index.cs b/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Index.cs
deleted file mode 100644
index 8719d647df..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Index.cs
+++ /dev/null
@@ -1,21 +0,0 @@
-using Microsoft.Data.Entity;
-
-namespace EFModeling.Configuring.FluentAPI.Samples.Index
-{
-    class MyContext : DbContext
-    {
-        public DbSet<Blog> Blogs { get; set; }
-
-        protected override void OnModelCreating(ModelBuilder modelBuilder)
-        {
-            modelBuilder.Entity<Blog>()
-                .Index(b => b.Url);
-        }
-    }
-
-    public class Blog
-    {
-        public int BlogId { get; set; }
-        public string Url { get; set; }
-    }
-}
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/IndexComposite.cs b/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/IndexComposite.cs
deleted file mode 100644
index 7383893b16..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/IndexComposite.cs
+++ /dev/null
@@ -1,22 +0,0 @@
-using Microsoft.Data.Entity;
-
-namespace EFModeling.Configuring.FluentAPI.Samples.IndexComposite
-{
-    class MyContext : DbContext
-    {
-        public DbSet<Person> People { get; set; }
-
-        protected override void OnModelCreating(ModelBuilder modelBuilder)
-        {
-            modelBuilder.Entity<Person>()
-                .Index(p => new { p.FirstName, p.LastName });
-        }
-    }
-
-    public class Person
-    {
-        public int PersonId { get; set; }
-        public string FirstName { get; set; }
-        public string LastName { get; set; }
-    }
-}
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/IndexUnique.cs b/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/IndexUnique.cs
deleted file mode 100644
index adab5954c4..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/IndexUnique.cs
+++ /dev/null
@@ -1,22 +0,0 @@
-using Microsoft.Data.Entity;
-
-namespace EFModeling.Configuring.FluentAPI.Samples.IndexUnique
-{
-    class MyContext : DbContext
-    {
-        public DbSet<Blog> Blogs { get; set; }
-
-        protected override void OnModelCreating(ModelBuilder modelBuilder)
-        {
-            modelBuilder.Entity<Blog>()
-                .Index(b => b.Url)
-                .Unique();
-        }
-    }
-
-    public class Blog
-    {
-        public int BlogId { get; set; }
-        public string Url { get; set; }
-    }
-}
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/KeyComposite.cs b/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/KeyComposite.cs
deleted file mode 100644
index f7a1c74404..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/KeyComposite.cs
+++ /dev/null
@@ -1,24 +0,0 @@
-using Microsoft.Data.Entity;
-
-namespace EFModeling.Configuring.FluentAPI.Samples.KeyComposite
-{
-    class MyContext : DbContext
-    {
-        public DbSet<Car> Cars { get; set; }
-
-        protected override void OnModelCreating(ModelBuilder modelBuilder)
-        {
-            modelBuilder.Entity<Car>()
-                .Key(c => new { c.State, c.LicensePlate });
-        }
-    }
-
-    class Car
-    {
-        public string State { get; set; }
-        public string LicensePlate { get; set; }
-
-        public string Make { get; set; }
-        public string Model { get; set; }
-    }
-}
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/KeySingle.cs b/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/KeySingle.cs
deleted file mode 100644
index 6a411c669d..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/KeySingle.cs
+++ /dev/null
@@ -1,23 +0,0 @@
-using Microsoft.Data.Entity;
-
-namespace EFModeling.Configuring.FluentAPI.Samples.KeySingle
-{
-    class MyContext : DbContext
-    {
-        public DbSet<Car> Cars { get; set; }
-
-        protected override void OnModelCreating(ModelBuilder modelBuilder)
-        {
-            modelBuilder.Entity<Car>()
-                .Key(c => c.LicensePlate);
-        }
-    }
-
-    class Car
-    {
-        public string LicensePlate { get; set; }
-
-        public string Make { get; set; }
-        public string Model { get; set; }
-    }
-}
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/MaxLength.cs b/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/MaxLength.cs
deleted file mode 100644
index b4884bc36a..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/MaxLength.cs
+++ /dev/null
@@ -1,22 +0,0 @@
-using Microsoft.Data.Entity;
-
-namespace EFModeling.Configuring.FluentAPI.Samples.MaxLength
-{
-    class MyContext : DbContext
-    {
-        public DbSet<Blog> Blogs { get; set; }
-
-        protected override void OnModelCreating(ModelBuilder modelBuilder)
-        {
-            modelBuilder.Entity<Blog>()
-                .Property(b => b.Url)
-                .MaxLength(500);
-        }
-    }
-
-    public class Blog
-    {
-        public int BlogId { get; set; }
-        public string Url { get; set; }
-    }
-}
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Relational/Column.cs b/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Relational/Column.cs
deleted file mode 100644
index 914d0d1627..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Relational/Column.cs
+++ /dev/null
@@ -1,22 +0,0 @@
-using Microsoft.Data.Entity;
-
-namespace EFModeling.Configuring.FluentAPI.Samples.Relational.Column
-{
-    class MyContext : DbContext
-    {
-        public DbSet<Blog> Blogs { get; set; }
-
-        protected override void OnModelCreating(ModelBuilder modelBuilder)
-        {
-            modelBuilder.Entity<Blog>()
-                .Property(b => b.BlogId)
-                .HasColumnName("blog_id");
-        }
-    }
-
-    public class Blog
-    {
-        public int BlogId { get; set; }
-        public string Url { get; set; }
-    }
-}
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Relational/DataType.cs b/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Relational/DataType.cs
deleted file mode 100644
index 141db2224f..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Relational/DataType.cs
+++ /dev/null
@@ -1,22 +0,0 @@
-using Microsoft.Data.Entity;
-
-namespace EFModeling.Configuring.FluentAPI.Samples.Relational.DataType
-{
-    class MyContext : DbContext
-    {
-        public DbSet<Blog> Blogs { get; set; }
-
-        protected override void OnModelCreating(ModelBuilder modelBuilder)
-        {
-            modelBuilder.Entity<Blog>()
-                .Property(b => b.Url)
-                .HasColumnType("varchar(200)");
-        }
-    }
-
-    public class Blog
-    {
-        public int BlogId { get; set; }
-        public string Url { get; set; }
-    }
-}
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Relational/DataTypeForProvider.cs b/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Relational/DataTypeForProvider.cs
deleted file mode 100644
index 2daedbdecb..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Relational/DataTypeForProvider.cs
+++ /dev/null
@@ -1,22 +0,0 @@
-using Microsoft.Data.Entity;
-
-namespace EFModeling.Configuring.FluentAPI.Samples.Relational.DataTypeForProvider
-{
-    class MyContext : DbContext
-    {
-        public DbSet<Blog> Blogs { get; set; }
-
-        protected override void OnModelCreating(ModelBuilder modelBuilder)
-        {
-            modelBuilder.Entity<Blog>()
-                .Property(b => b.Url)
-                .HasSqlServerColumnType("varchar(200)");
-        }
-    }
-
-    public class Blog
-    {
-        public int BlogId { get; set; }
-        public string Url { get; set; }
-    }
-}
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Relational/Table.cs b/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Relational/Table.cs
deleted file mode 100644
index ee29bd7ed2..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Relational/Table.cs
+++ /dev/null
@@ -1,21 +0,0 @@
-using Microsoft.Data.Entity;
-
-namespace EFModeling.Configuring.FluentAPI.Samples.Relational.Table
-{
-    class MyContext : DbContext
-    {
-        public DbSet<Blog> Blogs { get; set; }
-
-        protected override void OnModelCreating(ModelBuilder modelBuilder)
-        {
-            modelBuilder.Entity<Blog>()
-                .ToTable("blogs");
-        }
-    }
-
-    public class Blog
-    {
-        public int BlogId { get; set; }
-        public string Url { get; set; }
-    }
-}
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Relational/TableAndSchema.cs b/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Relational/TableAndSchema.cs
deleted file mode 100644
index a0d859cc63..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Relational/TableAndSchema.cs
+++ /dev/null
@@ -1,21 +0,0 @@
-using Microsoft.Data.Entity;
-
-namespace EFModeling.Configuring.FluentAPI.Samples.Relational.TableAndSchema
-{
-    class MyContext : DbContext
-    {
-        public DbSet<Blog> Blogs { get; set; }
-
-        protected override void OnModelCreating(ModelBuilder modelBuilder)
-        {
-            modelBuilder.Entity<Blog>()
-                .ToTable("blogs", schema: "blogging");
-        }
-    }
-
-    public class Blog
-    {
-        public int BlogId { get; set; }
-        public string Url { get; set; }
-    }
-}
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Required.cs b/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Required.cs
deleted file mode 100644
index 040266573e..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/Required.cs
+++ /dev/null
@@ -1,22 +0,0 @@
-using Microsoft.Data.Entity;
-
-namespace EFModeling.Configuring.FluentAPI.Samples.Required
-{
-    class MyContext : DbContext
-    {
-        public DbSet<Blog> Blogs { get; set; }
-
-        protected override void OnModelCreating(ModelBuilder modelBuilder)
-        {
-            modelBuilder.Entity<Blog>()
-                .Property(b => b.Url)
-                .Required();
-        }
-    }
-
-    public class Blog
-    {
-        public int BlogId { get; set; }
-        public string Url { get; set; }
-    }
-}
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/SentinelValue.cs b/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/SentinelValue.cs
deleted file mode 100644
index 1cbfcf7713..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/SentinelValue.cs
+++ /dev/null
@@ -1,24 +0,0 @@
-using Microsoft.Data.Entity;
-
-namespace EFModeling.Configuring.FluentAPI.Samples.SentinelValue
-{
-    class MyContext : DbContext
-    {
-        public DbSet<Blog> Blogs { get; set; }
-
-        protected override void OnModelCreating(ModelBuilder modelBuilder)
-        {
-            // Note there is no Fluent API for sentinel value in Beta6
-            //      so we must drop down to metadata
-            modelBuilder.Entity<Blog>()
-                .Property(b => b.BlogId)
-                .Metadata.SentinelValue = -1;
-        }
-    }
-
-    public class Blog
-    {
-        public int BlogId { get; set; }
-        public string Url { get; set; }
-    }
-}
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/ValueGeneratedNever.cs b/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/ValueGeneratedNever.cs
deleted file mode 100644
index f5b94161f3..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/ValueGeneratedNever.cs
+++ /dev/null
@@ -1,22 +0,0 @@
-using Microsoft.Data.Entity;
-
-namespace EFModeling.Configuring.FluentAPI.Samples.NoIdentity
-{
-    class MyContext : DbContext
-    {
-        public DbSet<Blog> Blogs { get; set; }
-
-        protected override void OnModelCreating(ModelBuilder modelBuilder)
-        {
-            modelBuilder.Entity<Blog>()
-                .Property(b => b.BlogId)
-                .ValueGeneratedNever();
-        }
-    }
-
-    public class Blog
-    {
-        public int BlogId { get; set; }
-        public string Url { get; set; }
-    }
-}
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/ValueGeneratedOnAdd.cs b/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/ValueGeneratedOnAdd.cs
deleted file mode 100644
index d9ac5f4030..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/ValueGeneratedOnAdd.cs
+++ /dev/null
@@ -1,22 +0,0 @@
-using Microsoft.Data.Entity;
-
-namespace EFModeling.Configuring.FluentAPI.Samples.ValueGeneratedOnAdd
-{
-    class MyContext : DbContext
-    {
-        public DbSet<Blog> Blogs { get; set; }
-
-        protected override void OnModelCreating(ModelBuilder modelBuilder)
-        {
-            modelBuilder.Entity<Blog>()
-                .Property(b => b.BlogId)
-                .ValueGeneratedOnAdd();
-        }
-    }
-
-    public class Blog
-    {
-        public int BlogId { get; set; }
-        public string Url { get; set; }
-    }
-}
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/ValueGeneratedOnAddOrUpdate.cs b/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/ValueGeneratedOnAddOrUpdate.cs
deleted file mode 100644
index 8bfe9cb0ce..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/Samples/ValueGeneratedOnAddOrUpdate.cs
+++ /dev/null
@@ -1,24 +0,0 @@
-using Microsoft.Data.Entity;
-using System;
-
-namespace EFModeling.Configuring.FluentAPI.Samples.ValueGeneratedOnAddOrUpdate
-{
-    class MyContext : DbContext
-    {
-        public DbSet<Blog> Blogs { get; set; }
-
-        protected override void OnModelCreating(ModelBuilder modelBuilder)
-        {
-            modelBuilder.Entity<Blog>()
-                .Property(b => b.LastUpdated)
-                .ValueGeneratedOnAddOrUpdate();
-        }
-    }
-
-    public class Blog
-    {
-        public int BlogId { get; set; }
-        public string Url { get; set; }
-        public DateTime LastUpdated { get; set; }
-    }
-}
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/packages.config b/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/packages.config
deleted file mode 100644
index 987b3afde5..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.FluentAPI/packages.config
+++ /dev/null
@@ -1,27 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<packages>
-  <package id="EntityFramework.Core" version="7.0.0-beta7" targetFramework="net46" />
-  <package id="EntityFramework.Relational" version="7.0.0-beta7" targetFramework="net46" />
-  <package id="EntityFramework.SqlServer" version="7.0.0-beta7" targetFramework="net46" />
-  <package id="Ix-Async" version="1.2.5" targetFramework="net46" />
-  <package id="Microsoft.Framework.Caching.Abstractions" version="1.0.0-beta7" targetFramework="net46" />
-  <package id="Microsoft.Framework.Caching.Memory" version="1.0.0-beta7" targetFramework="net46" />
-  <package id="Microsoft.Framework.Configuration" version="1.0.0-beta7" targetFramework="net46" />
-  <package id="Microsoft.Framework.Configuration.Abstractions" version="1.0.0-beta7" targetFramework="net46" />
-  <package id="Microsoft.Framework.Configuration.Binder" version="1.0.0-beta7" targetFramework="net46" />
-  <package id="Microsoft.Framework.DependencyInjection" version="1.0.0-beta7" targetFramework="net46" />
-  <package id="Microsoft.Framework.DependencyInjection.Abstractions" version="1.0.0-beta7" targetFramework="net46" />
-  <package id="Microsoft.Framework.Logging" version="1.0.0-beta7" targetFramework="net46" />
-  <package id="Microsoft.Framework.Logging.Abstractions" version="1.0.0-beta7" targetFramework="net46" />
-  <package id="Microsoft.Framework.OptionsModel" version="1.0.0-beta7" targetFramework="net46" />
-  <package id="Remotion.Linq" version="2.0.0-beta-002" targetFramework="net46" />
-  <package id="System.Collections" version="4.0.0-beta-23019" targetFramework="net46" />
-  <package id="System.Collections.Immutable" version="1.1.37-beta-23019" targetFramework="net46" />
-  <package id="System.Diagnostics.Debug" version="4.0.0-beta-23019" targetFramework="net46" />
-  <package id="System.Globalization" version="4.0.0-beta-23019" targetFramework="net46" />
-  <package id="System.Linq" version="4.0.0-beta-23019" targetFramework="net46" />
-  <package id="System.Resources.ResourceManager" version="4.0.0-beta-23019" targetFramework="net46" />
-  <package id="System.Runtime" version="4.0.0-beta-23019" targetFramework="net46" />
-  <package id="System.Runtime.Extensions" version="4.0.0-beta-23019" targetFramework="net46" />
-  <package id="System.Threading" version="4.0.0-beta-23019" targetFramework="net46" />
-</packages>
\ No newline at end of file
diff --git a/docs/modeling/configuring/sample/EFModeling.Configuring.sln b/docs/modeling/configuring/sample/EFModeling.Configuring.sln
deleted file mode 100644
index 6dcdca1854..0000000000
--- a/docs/modeling/configuring/sample/EFModeling.Configuring.sln
+++ /dev/null
@@ -1,22 +0,0 @@
-
-Microsoft Visual Studio Solution File, Format Version 12.00
-# Visual Studio 14
-VisualStudioVersion = 14.0.22823.1
-MinimumVisualStudioVersion = 10.0.40219.1
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "EFModeling.Configuring.FluentAPI", "EFModeling.Configuring.FluentAPI\EFModeling.Configuring.FluentAPI.csproj", "{20E1786B-FA14-4470-8B90-62A0C197E54D}"
-EndProject
-Global
-	GlobalSection(SolutionConfigurationPlatforms) = preSolution
-		Debug|Any CPU = Debug|Any CPU
-		Release|Any CPU = Release|Any CPU
-	EndGlobalSection
-	GlobalSection(ProjectConfigurationPlatforms) = postSolution
-		{20E1786B-FA14-4470-8B90-62A0C197E54D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{20E1786B-FA14-4470-8B90-62A0C197E54D}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{20E1786B-FA14-4470-8B90-62A0C197E54D}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{20E1786B-FA14-4470-8B90-62A0C197E54D}.Release|Any CPU.Build.0 = Release|Any CPU
-	EndGlobalSection
-	GlobalSection(SolutionProperties) = preSolution
-		HideSolutionNode = FALSE
-	EndGlobalSection
-EndGlobal
diff --git a/docs/modeling/default-conventions.rst b/docs/modeling/default-conventions.rst
deleted file mode 100644
index bc510813a6..0000000000
--- a/docs/modeling/default-conventions.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-.. include:: /stub-topic.txt
-
-|stub-icon| Default Conventions
-===============================
-
-.. include:: /stub-notice.txt
-
-.. _issue: https://github.com/aspnet/EntityFramework.Docs/issues/10
diff --git a/docs/modeling/index.rst b/docs/modeling/index.rst
deleted file mode 100644
index 2a19f4dbd8..0000000000
--- a/docs/modeling/index.rst
+++ /dev/null
@@ -1,14 +0,0 @@
-.. include:: /stub-topic.txt
-
-|stub-icon| Modeling
-==================== 
-
-.. include:: /stub-notice.txt
-
-.. _issue: https://github.com/aspnet/EntityFramework.Docs/issues/11
-
-.. toctree::
-    :titlesonly:
-
-    default-conventions
-    configuring
diff --git a/docs/providers/index.rst b/docs/providers/index.rst
deleted file mode 100644
index 1854fd790d..0000000000
--- a/docs/providers/index.rst
+++ /dev/null
@@ -1,95 +0,0 @@
-Database Providers
-==================
-
-The following providers are either available or being developed:
- - `EntityFramework.SqlServer`_
- - `EntityFramework.SQLite`_
- - `EntityFramework.InMemory`_
- - `EntityFramework.SqlServerCompact40`_
- - `EntityFramework.SqlServerCompact35`_
- - `EntityFramework.Npgsql`_
-
-EntityFramework.SqlServer
--------------------------
-
-**Database Engine:** Microsoft SQL Server (2008 onwards)
-
-**Platforms:** Full .NET (4.5 onwards), DNX/ASP.NET 5 (dnx451 and dnxcore50), Mono (4.2.0 onwards)
-
-.. caution::
-    Using this provider on Mono will make use of the Mono SQL Client implementation, which has a number of known issues. For example, it does not support secure connections (SSL).
-
-**Status:** `Pre-release EntityFramework.SqlServer package on NuGet.org <https://www.nuget.org/packages/EntityFramework.SqlServer>`_ that supports the latest EF7 pre-release
-
-**Project Site:** `EntityFramework GitHub project <https://github.com/aspnet/EntityFramework>`_
-
-**Getting Started:** See :doc:`/getting-started/full-dotnet` or :doc:`/getting-started/aspnet5` for a walkthrough that uses this provider. The `UnicornStore <https://github.com/rowanmiller/UnicornStore/tree/master/UnicornStore>`_ sample application also uses this provider.
-
-
-EntityFramework.SQLite
-----------------------
-
-**Database Engine:** SQLite (3.7 onwards)
-
-**Platforms:** Full .NET (4.5 onwards), DNX/ASP.NET 5 (dnx451 and dnxcore50), Mono (4.2.0 onwards), UWP coming soon
-
-**Status:** `Pre-release EntityFramework.SQLite package on NuGet.org <https://www.nuget.org/packages/EntityFramework.SQLite>`_ that supports the latest EF7 pre-release
-
-**Project Site:** `EntityFramework GitHub project <https://github.com/aspnet/EntityFramework>`_
-
-**Getting Started:** See :doc:`/getting-started/linux` or :doc:`/getting-started/osx` for a walkthrough that uses this provider
-
-
-EntityFramework.InMemory
-------------------------
-
-**Database Engine:** Built-in in-memory database (designed for testing purposes only)
-
-**Platforms:** Full .NET (4.5 onwards), DNX/ASP.NET 5 (dnx451 and dnxcore50), Mono (4.2.0 onwards), UWP coming soon
-
-**Status:** `Pre-release EntityFramework.InMemory package on NuGet.org <https://www.nuget.org/packages/EntityFramework.InMemory>`_ that supports the latest EF7 pre-release
-
-**Project Site:** `EntityFramework GitHub project <https://github.com/aspnet/EntityFramework>`_
-
-**Getting Started:** See the `tests for the UnicornStore sample application <https://github.com/rowanmiller/UnicornStore/blob/master/UnicornStore/src/UnicornStore.Tests/Controllers/ShippingControllerTests.cs>`_ for an example of using this provider.
-
-
-EntityFramework.SqlServerCompact40
-----------------------------------
-
-**Database Engine:** SQL Server Compact Edition 4.0
-
-**Platforms:** Full .NET (4.5 onwards), DNX/ASP.NET 5 (dnx451 only)
-
-**Status:** `Pre-release EntityFramework.SqlServerCompact40 package on NuGet.org <https://www.nuget.org/packages/EntityFramework.SqlServerCompact40>`_ that supports the latest EF7 pre-release
-
-**Project Site:** `ErikEJ/EntityFramework7.SqlServerCompact GitHub Project <https://github.com/ErikEJ/EntityFramework7.SqlServerCompact>`_
-
-**Getting Started:** See the `documentation for this project <https://github.com/ErikEJ/EntityFramework7.SqlServerCompact/wiki/Using-EF7-with-SQL-Server-Compact-in-Traditional-.NET-Applications>`_
-
-EntityFramework.SqlServerCompact35
-----------------------------------
-
-**Database Engine:** SQL Server Compact Edition 3.5
-
-**Platforms:** Full .NET (4.5 onwards), DNX/ASP.NET 5 (dnx451 only)
-
-**Status:** `Pre-release EntityFramework.SqlServerCompact35 package on NuGet.org <https://www.nuget.org/packages/EntityFramework.SqlServerCompact35>`_ that supports the latest EF7 pre-release
-
-**Project Site:** `ErikEJ/EntityFramework7.SqlServerCompact GitHub Project <https://github.com/ErikEJ/EntityFramework7.SqlServerCompact>`_
-
-**Getting Started:** See the `documentation for this project <https://github.com/ErikEJ/EntityFramework7.SqlServerCompact/wiki/Using-EF7-with-SQL-Server-Compact-in-Traditional-.NET-Applications>`_
-
-
-EntityFramework.Npgsql
-----------------------
-
-**Database Engine:** PostgreSql
-
-**Platforms:** Full .NET (4.5 onwards), DNX/ASP.NET 5 (dnx451 only), Mono (4.2.0 onwards)
-
-**Status:** Under active development. No official pre-release on NuGet.org yet.
-
-**Project Site:** `Npgsql.org <http://www.npgsql.org>`_
-
-**Getting Started:** Some `early documentation on using nightly builds <http://www.npgsql.org/doc/ef7.html>`_ is available.
diff --git a/docs/stub-notice.txt b/docs/stub-notice.txt
deleted file mode 100644
index e28d1b81d4..0000000000
--- a/docs/stub-notice.txt
+++ /dev/null
@@ -1,2 +0,0 @@
-.. note::
-    This topic hasn't been written yet! You can track the status of this issue_ through our public GitHub issue tracker. Learn how you can `contribute <https://github.com/aspnet/EntityFramework.Docs/blob/master/CONTRIBUTING.md>`_ on GitHub.
\ No newline at end of file
diff --git a/docs/stub-overview.txt b/docs/stub-overview.txt
deleted file mode 100644
index d1e96e3ce9..0000000000
--- a/docs/stub-overview.txt
+++ /dev/null
@@ -1,4 +0,0 @@
-.. include:: stub-topic.txt
-
-.. note::
-    This documentation is a work in progress. Topics marked with a |stub-icon| are placeholders that have not been written yet. You can track the status of these topics through our public documentation `issue tracker <https://github.com/aspnet/EntityFramework.Docs/issues>`_. Learn how you can `contribute <https://github.com/aspnet/EntityFramework.Docs/blob/master/CONTRIBUTING.md>`_ on GitHub.
\ No newline at end of file
diff --git a/docs/stub-topic.txt b/docs/stub-topic.txt
deleted file mode 100644
index 954b7f6b7c..0000000000
--- a/docs/stub-topic.txt
+++ /dev/null
@@ -1,3 +0,0 @@
-.. |stub-icon| unicode:: U+1F527
-
-
diff --git a/entity-framework/breadcrumb/toc.yml b/entity-framework/breadcrumb/toc.yml
new file mode 100644
index 0000000000..8d87c76cb0
--- /dev/null
+++ b/entity-framework/breadcrumb/toc.yml
@@ -0,0 +1,14 @@
+- name: .NET
+  tocHref: /ef/
+  topicHref: /dotnet/index
+  items:
+  - name: Entity Framework
+    tocHref: /ef/
+    topicHref: /ef/index
+    items:
+    - name: Entity Framework Core
+      tocHref: /ef/core/
+      topicHref: /ef/core/index
+    - name: Entity Framework 6
+      tocHref: /ef/ef6/
+      topicHref: /ef/ef6/index
diff --git a/entity-framework/core/change-tracking/_static/debug-view.png b/entity-framework/core/change-tracking/_static/debug-view.png
new file mode 100644
index 0000000000..9170eac0d4
Binary files /dev/null and b/entity-framework/core/change-tracking/_static/debug-view.png differ
diff --git a/entity-framework/core/change-tracking/change-detection.md b/entity-framework/core/change-tracking/change-detection.md
new file mode 100644
index 0000000000..53fc30ddfe
--- /dev/null
+++ b/entity-framework/core/change-tracking/change-detection.md
@@ -0,0 +1,420 @@
+---
+title: Change Detection and Notifications - EF Core
+description: Detecting property and relationship changes using DetectChanges or notifications
+author: SamMonoRT
+ms.date: 12/30/2020
+uid: core/change-tracking/change-detection
+---
+
+# Change Detection and Notifications
+
+Each <xref:Microsoft.EntityFrameworkCore.DbContext> instance tracks changes made to entities. These tracked entities in turn drive the changes to the database when <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*> is called. This is covered in [Change Tracking in EF Core](xref:core/change-tracking/index), and this document assumes that entity states and the basics of Entity Framework Core (EF Core) change tracking are understood.
+
+Tracking property and relationship changes requires that the DbContext is able to detect these changes. This document covers how this detection happens, as well as how to use property notifications or change-tracking proxies to force immediate detection of changes.
+
+> [!TIP]
+> You can run and debug into all the code in this document by [downloading the sample code from GitHub](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/ChangeTracking/ChangeDetectionAndNotifications).
+
+## Snapshot change tracking
+
+By default, EF Core creates a snapshot of every entity's property values when it is first tracked by a DbContext instance. The values stored in this snapshot are then compared against the current values of the entity in order to determine which property values have changed.
+
+This detection of changes happens when SaveChanges is called to ensure all changed values are detected before sending updates to the database. However, the detection of changes also happens at other times to ensure the application is working with up-to-date tracking information. Detection of changes can be forced at any time by calling <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.DetectChanges?displayProperty=nameWithType>.
+
+### When change detection is needed
+
+Detection of changes is needed when a property or navigation has been changed _without using EF Core to make this change_. For example, consider loading blogs and posts and then making changes to these entities:
+
+<!--
+        using var context = new BlogsContext();
+        var blog = context.Blogs.Include(e => e.Posts).First(e => e.Name == ".NET Blog");
+
+        // Change a property value
+        blog.Name = ".NET Blog (Updated!)";
+
+        // Add a new entity to a navigation
+        blog.Posts.Add(new Post
+        {
+            Title = "What’s next for System.Text.Json?",
+            Content = ".NET 5.0 was released recently and has come with many..."
+        });
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+        context.ChangeTracker.DetectChanges();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+-->
+[!code-csharp[Snapshot_change_tracking_1](../../../samples/core/ChangeTracking/ChangeDetectionAndNotifications/SnapshotSamples.cs?name=Snapshot_change_tracking_1)]
+
+Looking at the [change tracker debug view](xref:core/change-tracking/debug-views) before calling <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.DetectChanges?displayProperty=nameWithType> shows that the changes made have not been detected and hence are not reflected in the entity states and modified property data:
+
+```output
+Blog {Id: 1} Unchanged
+  Id: 1 PK
+  Name: '.NET Blog (Updated!)' Originally '.NET Blog'
+  Posts: [{Id: 1}, {Id: 2}, <not found>]
+Post {Id: 1} Unchanged
+  Id: 1 PK
+  BlogId: 1 FK
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...'
+  Title: 'Announcing the Release of EF Core 5.0'
+  Blog: {Id: 1}
+Post {Id: 2} Unchanged
+  Id: 2 PK
+  BlogId: 1 FK
+  Content: 'F# 5 is the latest version of F#, the functional programming...'
+  Title: 'Announcing F# 5'
+  Blog: {Id: 1}
+```
+
+Specifically, the state of the blog entry is still `Unchanged`, and the new post does not appear as a tracked entity. (The astute will notice properties report their new values, even though these changes have not yet been detected by EF Core. This is because the debug view is reading current values directly from the entity instance.)
+
+Contrast this with the debug view after calling DetectChanges:
+
+```output
+Blog {Id: 1} Modified
+  Id: 1 PK
+  Name: '.NET Blog (Updated!)' Modified Originally '.NET Blog'
+  Posts: [{Id: 1}, {Id: 2}, {Id: -2147482643}]
+Post {Id: -2147482643} Added
+  Id: -2147482643 PK Temporary
+  BlogId: 1 FK
+  Content: '.NET 5.0 was released recently and has come with many...'
+  Title: 'What's next for System.Text.Json?'
+  Blog: {Id: 1}
+Post {Id: 1} Unchanged
+  Id: 1 PK
+  BlogId: 1 FK
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...'
+  Title: 'Announcing the Release of EF Core 5.0'
+  Blog: {Id: 1}
+Post {Id: 2} Unchanged
+  Id: 2 PK
+  BlogId: 1 FK
+  Content: 'F# 5 is the latest version of F#, the functional programming...'
+  Title: 'Announcing F# 5'
+  Blog: {Id: 1}
+```
+
+Now the blog is correctly marked as `Modified` and the new post has been detected and is tracked as `Added`.
+
+At the start of this section we stated that detecting changes is needed when not _using EF Core to make the change_. This is what is happening in the code above. That is, the changes to the property and navigation are made _directly on the entity instances_, and not by using any EF Core methods.
+
+Contrast this to the following code which modifies the entities in the same way, but this time using EF Core methods:
+
+<!--
+        using var context = new BlogsContext();
+        var blog = context.Blogs.Include(e => e.Posts).First(e => e.Name == ".NET Blog");
+
+        // Change a property value
+        context.Entry(blog).Property(e => e.Name).CurrentValue = ".NET Blog (Updated!)";
+
+        // Add a new entity to the DbContext
+        context.Add(
+            new Post
+            {
+                Blog = blog,
+                Title = "What’s next for System.Text.Json?",
+                Content = ".NET 5.0 was released recently and has come with many..."
+            });
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+-->
+[!code-csharp[Snapshot_change_tracking_2](../../../samples/core/ChangeTracking/ChangeDetectionAndNotifications/SnapshotSamples.cs?name=Snapshot_change_tracking_2)]
+
+In this case the change tracker debug view shows that all entity states and property modifications are known, even though detection of changes has not happened. This is because <xref:Microsoft.EntityFrameworkCore.ChangeTracking.PropertyEntry.CurrentValue?displayProperty=nameWithType> is an EF Core method, which means that EF Core immediately knows about the change made by this method. Likewise, calling <xref:Microsoft.EntityFrameworkCore.DbContext.Add*?displayProperty=nameWithType> allows EF Core to immediately know about the new entity and track it appropriately.
+
+> [!TIP]
+> Don't attempt to avoid detecting changes by always using EF Core methods to make entity changes. Doing so is often more cumbersome and performs less well than making changes to entities in the normal way. The intention of this document is to inform as to when detecting changes is needed and when it is not. The intention is not to encourage avoidance of change detection.
+
+### Methods that automatically detect changes
+
+<xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.DetectChanges> is called automatically by methods where doing so is likely to impact the results. These methods are:
+
+- <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*?displayProperty=nameWithType> and <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChangesAsync*?displayProperty=nameWithType>, to ensure that all changes are detected before updating the database.
+- <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.Entries?displayProperty=nameWithType> and <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.Entries``1?displayProperty=nameWithType>, to ensure entity states and modified properties are up-to-date.
+- <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.HasChanges?displayProperty=nameWithType>, to ensure that the result is accurate.
+- <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.CascadeChanges?displayProperty=nameWithType>, to ensure correct entity states for principal/parent entities before cascading.
+- <xref:Microsoft.EntityFrameworkCore.DbSet`1.Local?displayProperty=nameWithType>, to ensure that the tracked graph is up-to-date.
+
+There are also some places where detection of changes happens on only a single entity instance, rather than on the entire graph of tracked entities. These places are:
+
+- When using <xref:System.Data.Entity.DbContext.Entry*?displayProperty=nameWithType>, to ensure that the entity's state and modified properties are up-to-date.
+- When using <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry> methods such as `Property`, `Collection`, `Reference` or `Member` to ensure property modifications, current values, etc. are up-to-date.
+- When a dependent/child entity is going to be deleted because a required relationship has been severed. This detects when an entity should not be deleted because it has been re-parented.
+
+Local detection of changes for a single entity can be triggered explicitly by calling <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry.DetectChanges?displayProperty=nameWithType>.
+
+> [!NOTE]
+> Local detect changes can miss some changes that a full detection would find. This happens when cascading actions resulting from undetected changes to other entities have an impact on the entity in question. In such situations the application may need to force a full scan of all entities by explicitly calling <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.DetectChanges?displayProperty=nameWithType>.
+
+### Disabling automatic change detection
+
+The performance of detecting changes is not a bottleneck for most applications. However, detecting changes can become a performance problem for some applications that track thousands of entities. (The exact number will dependent on many things, such as the number of properties in the entity.) For this reason the automatic detection of changes can be disabled using <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.AutoDetectChangesEnabled?displayProperty=nameWithType>. For example, consider processing join entities in a many-to-many relationship with payloads:
+
+<!--
+        public override int SaveChanges()
+        {
+            foreach (var entityEntry in ChangeTracker.Entries<PostTag>()) // Detects changes automatically
+            {
+                if (entityEntry.State == EntityState.Added)
+                {
+                    entityEntry.Entity.TaggedBy = "ajcvickers";
+                    entityEntry.Entity.TaggedOn = DateTime.Now;
+                }
+            }
+
+            try
+            {
+                ChangeTracker.AutoDetectChangesEnabled = false;
+                return base.SaveChanges(); // Avoid automatically detecting changes again here
+            }
+            finally
+            {
+                ChangeTracker.AutoDetectChangesEnabled = true;
+            }
+        }
+-->
+[!code-csharp[SaveChanges](../../../samples/core/ChangeTracking/ChangeDetectionAndNotifications/SnapshotSamples.cs?name=SaveChanges)]
+
+As we know from the previous section, both <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.Entries%60`1?displayProperty=nameWithType> and <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*?displayProperty=nameWithType> automatically detect changes. However, after calling Entries, the code does not then make any entity or property state changes. (Setting normal property values on Added entities does not cause any state changes.) The code therefore disables unnecessary automatic change detection when calling down into the base SaveChanges method. The code also makes use of a try/finally block to ensure that the default setting is restored even if SaveChanges fails.
+
+> [!TIP]
+> Do not assume that your code must disable automatic change detection to perform well. This is only needed when profiling an application tracking many entities indicates that performance of change detection is an issue.
+
+### Detecting changes and value conversions
+
+To use snapshot change tracking with an entity type, EF Core must be able to:
+
+- Make a snapshot of each property value when the entity is tracked
+- Compare this value to the current value of the property
+- Generate a hash code for the value
+
+This is handled automatically by EF Core for types that can be directly mapped to the database. However, when a [value converter is used to map a property](xref:core/modeling/value-conversions), then that converter must specify how to perform these actions. This is achieved with a value comparer, and is described in detail in the [Value Comparers](xref:core/modeling/value-comparers) documentation.
+
+## Notification entities
+
+Snapshot change tracking is recommended for most applications. However, applications that track many entities and/or make many changes to those entities may benefit from implementing entities that automatically notify EF Core when their property and navigation values change. These are known as "notification entities".
+
+### Implementing notification entities
+
+Notification entities make use of the <xref:System.ComponentModel.INotifyPropertyChanging> and <xref:System.ComponentModel.INotifyPropertyChanged> interfaces, which are part of the .NET base class library (BCL). These interfaces define events that must be fired before and after changing a property value. For example:
+
+<!--
+    public class Blog : INotifyPropertyChanging, INotifyPropertyChanged
+    {
+        public event PropertyChangingEventHandler PropertyChanging;
+        public event PropertyChangedEventHandler PropertyChanged;
+
+        private int _id;
+        public int Id
+        {
+            get => _id;
+            set
+            {
+                PropertyChanging?.Invoke(this, new PropertyChangingEventArgs(nameof(Id)));
+                _id = value;
+                PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nameof(Id)));
+            }
+        }
+
+        private string _name;
+        public string Name
+        {
+            get => _name;
+            set
+            {
+                PropertyChanging?.Invoke(this, new PropertyChangingEventArgs(nameof(Name)));
+                _name = value;
+                PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nameof(Name)));
+            }
+        }
+
+        public IList<Post> Posts { get; } = new ObservableCollection<Post>();
+    }
+-->
+[!code-csharp[Model](../../../samples/core/ChangeTracking/ChangeDetectionAndNotifications/NotificationEntitiesSamples.cs?name=Model)]
+
+In addition, any collection navigations must implement `INotifyCollectionChanged`; in the example above this is satisfied by using an <xref:System.Collections.ObjectModel.ObservableCollection`1> of posts. EF Core also ships with an <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ObservableHashSet`1> implementation that has more efficient lookups at the expense of stable ordering.
+
+Most of this notification code is typically moved into an unmapped base class. For example:
+
+<!--
+    public class Blog : NotifyingEntity
+    {
+        private int _id;
+        public int Id
+        {
+            get => _id;
+            set => SetWithNotify(value, out _id);
+        }
+
+        private string _name;
+        public string Name
+        {
+            get => _name;
+            set => SetWithNotify(value, out _name);
+        }
+
+        public IList<Post> Posts { get; } = new ObservableCollection<Post>();
+    }
+
+    public abstract class NotifyingEntity : INotifyPropertyChanging, INotifyPropertyChanged
+    {
+        protected void SetWithNotify<T>(T value, out T field, [CallerMemberName] string propertyName = "")
+        {
+            NotifyChanging(propertyName);
+            field = value;
+            NotifyChanged(propertyName);
+        }
+
+        public event PropertyChangingEventHandler PropertyChanging;
+        public event PropertyChangedEventHandler PropertyChanged;
+
+        private void NotifyChanged(string propertyName)
+            => PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
+
+        private void NotifyChanging(string propertyName)
+            => PropertyChanging?.Invoke(this, new PropertyChangingEventArgs(propertyName));
+    }
+-->
+[!code-csharp[Model](../../../samples/core/ChangeTracking/ChangeDetectionAndNotifications/NotificationWithBaseSamples.cs?name=Model)]
+
+### Configuring notification entities
+
+There is no way for EF Core to validate that `INotifyPropertyChanging` or `INotifyPropertyChanged` are fully implemented for use with EF Core. In particular, some uses of these interfaces do so with notifications only on certain properties, rather than on all properties (including navigations) as required by EF Core. For this reason, EF Core does not automatically hook into these events.
+
+Instead, EF Core must be configured to use these notification entities. This is usually done for all entity types by calling <xref:Microsoft.EntityFrameworkCore.ModelBuilder.HasChangeTrackingStrategy*?displayProperty=nameWithType>. For example:
+
+<!--
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.HasChangeTrackingStrategy(ChangeTrackingStrategy.ChangingAndChangedNotifications);
+        }
+-->
+[!code-csharp[OnModelCreating](../../../samples/core/ChangeTracking/ChangeDetectionAndNotifications/NotificationWithBaseSamples.cs?name=OnModelCreating)]
+
+(The strategy can also be set differently for different entity types using <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.EntityTypeBuilder.HasChangeTrackingStrategy*?displayProperty=nameWithType>, but this is usually counterproductive since DetectChanges is still required for those types that are not notification entities.)
+
+Full notification change tracking requires that both `INotifyPropertyChanging` and `INotifyPropertyChanged` are implemented. This allows original values to be saved just before the property value is changed, avoiding the need for EF Core to create a snapshot when tracking the entity. Entity types that implement only `INotifyPropertyChanged` can also be used with EF Core. In this case, EF still creates a snapshot when tracking an entity to keep track of original values, but then uses the notifications to detect changes immediately, rather than needing DetectChanges to be called.
+
+The different <xref:Microsoft.EntityFrameworkCore.ChangeTrackingStrategy> values are summarized in the following table.
+
+| ChangeTrackingStrategy                              | Interfaces needed                                      | Needs DetectChanges | Snapshots original values
+|:----------------------------------------------------|--------------------------------------------------------|---------------------|--------------------------
+| Snapshot                                            | None                                                   | Yes                 | Yes
+| ChangedNotifications                                | INotifyPropertyChanged                                 | No                  | Yes
+| ChangingAndChangedNotifications                     | INotifyPropertyChanged and INotifyPropertyChanging     | No                  | No
+| ChangingAndChangedNotificationsWithOriginalValues   | INotifyPropertyChanged and INotifyPropertyChanging     | No                  | Yes
+
+### Using notification entities
+
+Notification entities behave like any other entities, except that making changes to the entity instances do not require a call to <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.DetectChanges?displayProperty=nameWithType> to detect these changes. For example:
+
+<!--
+            using var context = new BlogsContext();
+            var blog = context.Blogs.Include(e => e.Posts).First(e => e.Name == ".NET Blog");
+
+            // Change a property value
+            blog.Name = ".NET Blog (Updated!)";
+
+            // Add a new entity to a navigation
+            blog.Posts.Add(new Post
+            {
+                Title = "What’s next for System.Text.Json?",
+                Content = ".NET 5.0 was released recently and has come with many..."
+            });
+
+            Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+-->
+[!code-csharp[Notification_entities_2](../../../samples/core/ChangeTracking/ChangeDetectionAndNotifications/NotificationWithBaseSamples.cs?name=Notification_entities_2)]
+
+With normal entities, the [change tracker debug view](xref:core/change-tracking/debug-views) showed that these changes were not detected until DetectChanges was called. Looking at the debug view when notification entities are used shows that these changes have been detected immediately:
+
+```output
+Blog {Id: 1} Modified
+  Id: 1 PK
+  Name: '.NET Blog (Updated!)' Modified
+  Posts: [{Id: 1}, {Id: 2}, {Id: -2147482643}]
+Post {Id: -2147482643} Added
+  Id: -2147482643 PK Temporary
+  BlogId: 1 FK
+  Content: '.NET 5.0 was released recently and has come with many...'
+  Title: 'What's next for System.Text.Json?'
+  Blog: {Id: 1}
+Post {Id: 1} Unchanged
+  Id: 1 PK
+  BlogId: 1 FK
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...'
+  Title: 'Announcing the Release of EF Core 5.0'
+  Blog: {Id: 1}
+Post {Id: 2} Unchanged
+  Id: 2 PK
+  BlogId: 1 FK
+  Content: 'F# 5 is the latest version of F#, the functional programming...'
+  Title: 'Announcing F# 5'
+  Blog: {Id: 1}
+```
+
+## Change-tracking proxies
+
+EF Core can dynamically generate proxy types that implement <xref:System.ComponentModel.INotifyPropertyChanging> and <xref:System.ComponentModel.INotifyPropertyChanged>. This requires installing the [Microsoft.EntityFrameworkCore.Proxies](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Proxies/) NuGet package, and enabling change-tracking proxies with <xref:Microsoft.EntityFrameworkCore.ProxiesExtensions.UseChangeTrackingProxies*> For example:
+
+<!--
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder.UseChangeTrackingProxies();
+-->
+[!code-csharp[OnConfiguring](../../../samples/core/ChangeTracking/ChangeDetectionAndNotifications/ChangeTrackingProxiesSamples.cs?name=OnConfiguring)]
+
+Creating a dynamic proxy involves creating a new, dynamic .NET type (using the [Castle.Core](https://www.nuget.org/packages/Castle.Core/) proxies implementation), which inherits from the entity type and then overrides all property setters. Entity types for proxies must therefore be types that can be inherited from and must have properties that can be overridden. Also, collection navigations created explicitly must implement <xref:System.Collections.Specialized.INotifyCollectionChanged> For example:
+
+<!--
+    public class Blog
+    {
+        public virtual int Id { get; set; }
+        public virtual string Name { get; set; }
+
+        public virtual IList<Post> Posts { get; } = new ObservableCollection<Post>();
+    }
+
+    public class Post
+    {
+        public virtual int Id { get; set; }
+        public virtual string Title { get; set; }
+        public virtual string Content { get; set; }
+
+        public virtual int BlogId { get; set; }
+        public virtual Blog Blog { get; set; }
+    }
+-->
+[!code-csharp[Model](../../../samples/core/ChangeTracking/ChangeDetectionAndNotifications/ChangeTrackingProxiesSamples.cs?name=Model)]
+
+One significant downside to change-tracking proxies is that EF Core must always track instances of the proxy, never instances of the underlying entity type. This is because instances of the underlying entity type will not generate notifications, which means changes made to these entities will be missed.
+
+EF Core creates proxy instances automatically when querying the database, so this downside is generally limited to tracking new entity instances. These instances must be created using the <xref:Microsoft.EntityFrameworkCore.ProxiesExtensions.CreateProxy*> extension methods, and **not** in the normal way using `new`. This means the code from the previous examples must now make use of `CreateProxy`:
+
+<!--
+            using var context = new BlogsContext();
+            var blog = context.Blogs.Include(e => e.Posts).First(e => e.Name == ".NET Blog");
+
+            // Change a property value
+            blog.Name = ".NET Blog (Updated!)";
+
+            // Add a new entity to a navigation
+            blog.Posts.Add(
+                context.CreateProxy<Post>(
+                    p =>
+                        {
+                            p.Title = "What’s next for System.Text.Json?";
+                            p.Content = ".NET 5.0 was released recently and has come with many...";
+                        }));
+
+            Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+-->
+[!code-csharp[Change_tracking_proxies_1](../../../samples/core/ChangeTracking/ChangeDetectionAndNotifications/ChangeTrackingProxiesSamples.cs?name=Change_tracking_proxies_1)]
+
+## Change tracking events
+
+EF Core fires the <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.Tracked?displayProperty=nameWithType> event when an entity is tracked for the first time. Future entity state changes result in <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.StateChanged?displayProperty=nameWithType> events. See [.NET Events in EF Core](xref:core/logging-events-diagnostics/events) for more information.
+
+> [!NOTE]
+> The `StateChanged` event is not fired when an entity is first tracked, even though the state has changed from `Detached` to one of the other states. Make sure to listen for both `StateChanged` and `Tracked` events to get all relevant notifications.
diff --git a/entity-framework/core/change-tracking/debug-views.md b/entity-framework/core/change-tracking/debug-views.md
new file mode 100644
index 0000000000..d73ccceefc
--- /dev/null
+++ b/entity-framework/core/change-tracking/debug-views.md
@@ -0,0 +1,327 @@
+---
+title: Change Tracker Debugging - EF Core
+description: Using the ChangeTracker DebugView and log messages to debug EF Core change tracking
+author: SamMonoRT
+ms.date: 12/30/2020
+uid: core/change-tracking/debug-views
+---
+
+# Change Tracker Debugging
+
+The Entity Framework Core (EF Core) change tracker generates two kinds of output to help with debugging:
+
+- The <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.DebugView*?displayProperty=nameWithType> provides a human-readable view of all entities being tracked
+- Debug-level log messages are generated when the change tracker detects state and fixes up relationships
+
+> [!TIP]
+> This document assumes that entity states and the basics of EF Core change tracking are understood. See [Change Tracking in EF Core](xref:core/change-tracking/index) for more information on these topics.
+
+> [!TIP]
+> You can run and debug into all the code in this document by [downloading the sample code from GitHub](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/ChangeTracking/ChangeTrackerDebugging).
+
+## Change tracker debug view
+
+The change tracker debug view can be accessed in the debugger of your IDE. For example, with Visual Studio:
+
+![Accessing the change tracker debug view from the Visual Studio debugger](_static/debug-view.png)
+
+It can also be accessed directly from code, for example to send the debug view to the console:
+
+<!--
+        Console.WriteLine(context.ChangeTracker.DebugView.ShortView);
+-->
+[!code-csharp[Change_tracker_debug_view_1b](../../../samples/core/ChangeTracking/ChangeTrackerDebugging/Samples.cs?name=Change_tracker_debug_view_1b)]
+
+The debug view has a short form and a long form. The short form shows tracked entities, their state, and key values. The long form also includes all property and navigation values and state.
+
+### The short view
+
+Let's look at a debug view example using the model shown at the end of this document. First, we will track some entities and put them in some different states, just so we have good change tracking data to view:
+
+<!--
+        using var context = new BlogsContext();
+
+        var blogs = context.Blogs
+            .Include(e => e.Posts).ThenInclude(e => e.Tags)
+            .Include(e => e.Assets)
+            .ToList();
+
+        // Mark something Added
+        blogs[0].Posts.Add(
+            new Post
+            {
+                Title = "What’s next for System.Text.Json?",
+                Content = ".NET 5.0 was released recently and has come with many new features and..."
+            });
+
+        // Mark something Deleted
+        blogs[1].Posts.Remove(blogs[1].Posts[1]);
+
+        // Make something Modified
+        blogs[0].Name = ".NET Blog (All new!)";
+
+        context.ChangeTracker.DetectChanges();
+-->
+[!code-csharp[Change_tracker_debug_view_1a](../../../samples/core/ChangeTracking/ChangeTrackerDebugging/Samples.cs?name=Change_tracker_debug_view_1a)]
+
+Printing the short view at this point, as shown above, results in the following output:
+
+```output
+Blog {Id: 1} Modified AK {AssetsId: ed727978-1ffe-4709-baee-73913e8e44a0}
+Blog {Id: 2} Unchanged AK {AssetsId: 3a54b880-2b9d-486b-9403-dc2e52d36d65}
+BlogAssets {Id: 3a54b880-2b9d-486b-9403-dc2e52d36d65} Unchanged FK {Id: 3a54b880-2b9d-486b-9403-dc2e52d36d65}
+BlogAssets {Id: ed727978-1ffe-4709-baee-73913e8e44a0} Unchanged FK {Id: ed727978-1ffe-4709-baee-73913e8e44a0}
+Post {Id: -2147482643} Added FK {BlogId: 1}
+Post {Id: 1} Unchanged FK {BlogId: 1}
+Post {Id: 2} Unchanged FK {BlogId: 1}
+Post {Id: 3} Unchanged FK {BlogId: 2}
+Post {Id: 4} Deleted FK {BlogId: 2}
+PostTag (Dictionary<string, object>) {PostsId: 1, TagsId: 1} Unchanged FK {PostsId: 1} FK {TagsId: 1}
+PostTag (Dictionary<string, object>) {PostsId: 1, TagsId: 3} Unchanged FK {PostsId: 1} FK {TagsId: 3}
+PostTag (Dictionary<string, object>) {PostsId: 2, TagsId: 1} Unchanged FK {PostsId: 2} FK {TagsId: 1}
+PostTag (Dictionary<string, object>) {PostsId: 3, TagsId: 2} Unchanged FK {PostsId: 3} FK {TagsId: 2}
+PostTag (Dictionary<string, object>) {PostsId: 4, TagsId: 2} Deleted FK {PostsId: 4} FK {TagsId: 2}
+Tag {Id: 1} Unchanged
+Tag {Id: 2} Unchanged
+Tag {Id: 3} Unchanged
+```
+
+Notice:
+
+- Each tracked entity is listed with its primary key (PK) value. For example, `Blog {Id: 1}`.
+- If the entity is a shared-type entity type, then it's CLR type is also shown. For example, `PostTag (Dictionary<string, object>)`.
+- The <xref:Microsoft.EntityFrameworkCore.EntityState> is shown next. This will be one of `Unchanged`, `Added`, `Modified`, or `Deleted`.
+- Values for any alternate keys (AKs) are shown next. For example, `AK {AssetsId: ed727978-1ffe-4709-baee-73913e8e44a0}`.
+- Finally, values for any foreign keys (FKs) are shown. For example, `FK {PostsId: 4} FK {TagsId: 2}`.
+
+### The long view
+
+The long view can be sent to the console in the same way as the short view:
+
+<!--
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+-->
+[!code-csharp[Change_tracker_debug_view_1c](../../../samples/core/ChangeTracking/ChangeTrackerDebugging/Samples.cs?name=Change_tracker_debug_view_1c)]
+
+The output for the same state as the short view above is:
+
+```output
+Blog {Id: 1} Modified
+  Id: 1 PK
+  AssetsId: 'ed727978-1ffe-4709-baee-73913e8e44a0' AK
+  Name: '.NET Blog (All new!)' Modified Originally '.NET Blog'
+  Assets: {Id: ed727978-1ffe-4709-baee-73913e8e44a0}
+  Posts: [{Id: 1}, {Id: 2}, {Id: -2147482643}]
+Blog {Id: 2} Unchanged
+  Id: 2 PK
+  AssetsId: '3a54b880-2b9d-486b-9403-dc2e52d36d65' AK
+  Name: 'Visual Studio Blog'
+  Assets: {Id: 3a54b880-2b9d-486b-9403-dc2e52d36d65}
+  Posts: [{Id: 3}]
+BlogAssets {Id: 3a54b880-2b9d-486b-9403-dc2e52d36d65} Unchanged
+  Id: '3a54b880-2b9d-486b-9403-dc2e52d36d65' PK FK
+  Banner: <null>
+  Blog: {Id: 2}
+BlogAssets {Id: ed727978-1ffe-4709-baee-73913e8e44a0} Unchanged
+  Id: 'ed727978-1ffe-4709-baee-73913e8e44a0' PK FK
+  Banner: <null>
+  Blog: {Id: 1}
+Post {Id: -2147482643} Added
+  Id: -2147482643 PK Temporary
+  BlogId: 1 FK
+  Content: '.NET 5.0 was released recently and has come with many new fe...'
+  Title: 'What's next for System.Text.Json?'
+  Blog: {Id: 1}
+  Tags: []
+Post {Id: 1} Unchanged
+  Id: 1 PK
+  BlogId: 1 FK
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...'
+  Title: 'Announcing the Release of EF Core 5.0'
+  Blog: {Id: 1}
+  Tags: [{Id: 1}, {Id: 3}]
+Post {Id: 2} Unchanged
+  Id: 2 PK
+  BlogId: 1 FK
+  Content: 'F# 5 is the latest version of F#, the functional programming...'
+  Title: 'Announcing F# 5'
+  Blog: {Id: 1}
+  Tags: [{Id: 1}]
+Post {Id: 3} Unchanged
+  Id: 3 PK
+  BlogId: 2 FK
+  Content: 'If you are focused on squeezing out the last bits of perform...'
+  Title: 'Disassembly improvements for optimized managed debugging'
+  Blog: {Id: 2}
+  Tags: [{Id: 2}]
+Post {Id: 4} Deleted
+  Id: 4 PK
+  BlogId: 2 FK
+  Content: 'Examine when database queries were executed and measure how ...'
+  Title: 'Database Profiling with Visual Studio'
+  Blog: <null>
+  Tags: [{Id: 2}]
+PostTag (Dictionary<string, object>) {PostsId: 1, TagsId: 1} Unchanged
+  PostsId: 1 PK FK
+  TagsId: 1 PK FK
+PostTag (Dictionary<string, object>) {PostsId: 1, TagsId: 3} Unchanged
+  PostsId: 1 PK FK
+  TagsId: 3 PK FK
+PostTag (Dictionary<string, object>) {PostsId: 2, TagsId: 1} Unchanged
+  PostsId: 2 PK FK
+  TagsId: 1 PK FK
+PostTag (Dictionary<string, object>) {PostsId: 3, TagsId: 2} Unchanged
+  PostsId: 3 PK FK
+  TagsId: 2 PK FK
+PostTag (Dictionary<string, object>) {PostsId: 4, TagsId: 2} Deleted
+  PostsId: 4 PK FK
+  TagsId: 2 PK FK
+Tag {Id: 1} Unchanged
+  Id: 1 PK
+  Text: '.NET'
+  Posts: [{Id: 1}, {Id: 2}]
+Tag {Id: 2} Unchanged
+  Id: 2 PK
+  Text: 'Visual Studio'
+  Posts: [{Id: 3}, {Id: 4}]
+Tag {Id: 3} Unchanged
+  Id: 3 PK
+  Text: 'EF Core'
+  Posts: [{Id: 1}]
+```
+
+Each tracked entity and its state is shown as before. However, the long view also shows property and navigation values.
+
+#### Property values
+
+For each property, the long view shows whether or not the property is part of a primary key (PK), alternate key (AK), or foreign key (FK). For example:
+
+- `Blog.Id` is a primary key property: `Id: 1 PK`
+- `Blog.AssetsId` is an alternate key property: `AssetsId: 'ed727978-1ffe-4709-baee-73913e8e44a0' AK`
+- `Post.BlogId` is a foreign key property: `BlogId: 2 FK`
+- `BlogAssets.Id` is both a primary key and a foreign key property: `Id: '3a54b880-2b9d-486b-9403-dc2e52d36d65' PK FK`
+
+Property values that have been modified are marked as such, and the original value of the property is also shown. For example, `Name: '.NET Blog (All new!)' Modified Originally '.NET Blog'`.
+
+Finally, `Added` entities with temporary key values indicate that the value is temporary. For example, `Id: -2147482643 PK Temporary`.
+
+#### Navigation values
+
+Navigation values are displayed using the primary key values of the entities that the navigations reference. For example, in the output above, post 3 is related to blog 2. This means that the `Post.Blog` navigation points to the `Blog` instance with ID 2. This is shown as `Blog: {Id: 2}`.
+
+The same thing happens for collection navigations, except that in this case there can be multiple related entities. For example, the collection navigation `Blog.Posts` contains three entities, with key values 1, 2, and -2147482643 respectively. This is shown as `[{Id: 1}, {Id: 2}, {Id: -2147482643}]`.
+
+## Change tracker logging
+
+The change tracker logs messages at the `Debug` <xref:Microsoft.Extensions.Logging.LogLevel> whenever it [detects property or navigation changes](xref:core/change-tracking/debug-views). For example, when <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.DetectChanges?displayProperty=nameWithType> is called in the code at the top of this document and [debug logging is enabled](xref:core/logging-events-diagnostics/index), then the following logs are generated:
+
+```output
+dbug: 12/30/2020 13:52:44.815 CoreEventId.DetectChangesStarting[10800] (Microsoft.EntityFrameworkCore.ChangeTracking)
+      DetectChanges starting for 'BlogsContext'.
+dbug: 12/30/2020 13:52:44.818 CoreEventId.PropertyChangeDetected[10802] (Microsoft.EntityFrameworkCore.ChangeTracking)
+      The unchanged property 'Blog.Name' was detected as changed from '.NET Blog' to '.NET Blog (All new!)' and will be marked as modified for entity with key '{Id: 1}'.
+dbug: 12/30/2020 13:52:44.820 CoreEventId.StateChanged[10807] (Microsoft.EntityFrameworkCore.ChangeTracking)
+      The 'Blog' entity with key '{Id: 1}' tracked by 'BlogsContext' changed state from 'Unchanged' to 'Modified'.
+dbug: 12/30/2020 13:52:44.821 CoreEventId.CollectionChangeDetected[10804] (Microsoft.EntityFrameworkCore.ChangeTracking)
+      1 entities were added and 0 entities were removed from navigation 'Blog.Posts' on entity with key '{Id: 1}'.
+dbug: 12/30/2020 13:52:44.822 CoreEventId.ValueGenerated[10808] (Microsoft.EntityFrameworkCore.ChangeTracking)
+      'BlogsContext' generated temporary value '-2147482638' for the property 'Id.Post'.
+dbug: 12/30/2020 13:52:44.822 CoreEventId.StartedTracking[10806] (Microsoft.EntityFrameworkCore.ChangeTracking)
+      Context 'BlogsContext' started tracking 'Post' entity with key '{Id: -2147482638}'.
+dbug: 12/30/2020 13:52:44.827 CoreEventId.CollectionChangeDetected[10804] (Microsoft.EntityFrameworkCore.ChangeTracking)
+      0 entities were added and 1 entities were removed from navigation 'Blog.Posts' on entity with key '{Id: 2}'.
+dbug: 12/30/2020 13:52:44.827 CoreEventId.StateChanged[10807] (Microsoft.EntityFrameworkCore.ChangeTracking)
+      The 'Post' entity with key '{Id: 4}' tracked by 'BlogsContext' changed state from 'Unchanged' to 'Modified'.
+dbug: 12/30/2020 13:52:44.829 CoreEventId.CascadeDeleteOrphan[10003] (Microsoft.EntityFrameworkCore.Update)
+      An entity of type 'Post' with key '{Id: 4}' changed to 'Deleted' state due to severed required relationship to its parent entity of type 'Blog'.
+dbug: 12/30/2020 13:52:44.829 CoreEventId.StateChanged[10807] (Microsoft.EntityFrameworkCore.ChangeTracking)
+      The 'Post' entity with key '{Id: 4}' tracked by 'BlogsContext' changed state from 'Modified' to 'Deleted'.
+dbug: 12/30/2020 13:52:44.829 CoreEventId.CollectionChangeDetected[10804] (Microsoft.EntityFrameworkCore.ChangeTracking)
+      0 entities were added and 1 entities were removed from navigation 'Blog.Posts' on entity with key '{Id: 2}'.
+dbug: 12/30/2020 13:52:44.831 CoreEventId.CascadeDelete[10002] (Microsoft.EntityFrameworkCore.Update)
+      A cascade state change of an entity of type 'PostTag' with key '{PostsId: 4, TagsId: 2}' to 'Deleted' occurred due to the deletion of its parent entity of type 'Post' with key '{Id: 4}'.
+dbug: 12/30/2020 13:52:44.831 CoreEventId.StateChanged[10807] (Microsoft.EntityFrameworkCore.ChangeTracking)
+      The 'PostTag' entity with key '{PostsId: 4, TagsId: 2}' tracked by 'BlogsContext' changed state from 'Unchanged' to 'Deleted'.
+dbug: 12/30/2020 13:52:44.831 CoreEventId.DetectChangesCompleted[10801] (Microsoft.EntityFrameworkCore.ChangeTracking)
+      DetectChanges completed for 'BlogsContext'.
+```
+
+The following table summaries the change tracker logging messages:
+
+| Event ID                                                                                                               | Description
+|:-----------------------------------------------------------------------------------------------------------------------|----
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.CoreEventId.DetectChangesStarting?displayProperty=nameWithType>        | <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.DetectChanges> is starting
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.CoreEventId.DetectChangesCompleted?displayProperty=nameWithType>       | <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.DetectChanges> has completed
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.CoreEventId.PropertyChangeDetected?displayProperty=nameWithType>       | A normal property value has changed
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.CoreEventId.ForeignKeyChangeDetected?displayProperty=nameWithType>     | A foreign key property value has changed
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.CoreEventId.CollectionChangeDetected?displayProperty=nameWithType>     | A non-skip collection navigation has had related entities added or removed.
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.CoreEventId.ReferenceChangeDetected?displayProperty=nameWithType>      | A reference navigation has been changed to point to another entity, or set to null
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.CoreEventId.StartedTracking?displayProperty=nameWithType>              | EF Core started tracking an entity
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.CoreEventId.StateChanged?displayProperty=nameWithType>                 | The <xref:Microsoft.EntityFrameworkCore.EntityState> of an entity has changed
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.CoreEventId.ValueGenerated?displayProperty=nameWithType>               | A value was generated for a property
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.CoreEventId.SkipCollectionChangeDetected?displayProperty=nameWithType> | A skip collection navigation has had related entities added or removed
+
+## The model
+
+The model used for the examples above contains the following entity types:
+
+<!--
+public class Blog
+{
+    public int Id { get; set; } // Primary key
+    public Guid AssetsId { get; set; } // Alternate key
+    public string Name { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>(); // Collection navigation
+    public BlogAssets Assets { get; set; } // Reference navigation
+}
+
+public class BlogAssets
+{
+    public Guid Id { get; set; } // Primary key and foreign key
+    public byte[] Banner { get; set; }
+
+    public Blog Blog { get; set; } // Reference navigation
+}
+
+public class Post
+{
+    public int Id { get; set; } // Primary key
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int BlogId { get; set; } // Foreign key
+    public Blog Blog { get; set; } // Reference navigation
+
+    public IList<Tag> Tags { get; } = new List<Tag>(); // Skip collection navigation
+}
+
+public class Tag
+{
+    public int Id { get; set; } // Primary key
+    public string Text { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>(); // Skip collection navigation
+}
+-->
+[!code-csharp[Model](../../../samples/core/ChangeTracking/ChangeTrackerDebugging/Samples.cs?name=Model)]
+
+The model is mostly configured by convention, with just a few lines in OnModelCreating:
+
+<!--
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder
+            .Entity<Blog>()
+            .Property(e => e.AssetsId)
+            .ValueGeneratedOnAdd();
+
+        modelBuilder
+            .Entity<BlogAssets>()
+            .HasOne(e => e.Blog)
+            .WithOne(e => e.Assets)
+            .HasForeignKey<BlogAssets>(e => e.Id)
+            .HasPrincipalKey<Blog>(e => e.AssetsId);
+    }
+-->
+[!code-csharp[OnModelCreating](../../../samples/core/ChangeTracking/ChangeTrackerDebugging/Samples.cs?name=OnModelCreating)]
diff --git a/entity-framework/core/change-tracking/entity-entries.md b/entity-framework/core/change-tracking/entity-entries.md
new file mode 100644
index 0000000000..8dd8c89e25
--- /dev/null
+++ b/entity-framework/core/change-tracking/entity-entries.md
@@ -0,0 +1,598 @@
+---
+title: Accessing Tracked Entities - EF Core
+description: Using EntityEntry, DbContext.Entries, and DbSet.Local to access tracked entities
+author: SamMonoRT
+ms.date: 12/30/2020
+uid: core/change-tracking/entity-entries
+---
+
+# Accessing Tracked Entities
+
+There are four main APIs for accessing entities tracked by a <xref:Microsoft.EntityFrameworkCore.DbContext>:
+
+- <xref:Microsoft.EntityFrameworkCore.DbContext.Entry*?displayProperty=nameWithType> returns an <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry`1> instance for a given entity instance.
+- <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.Entries*?displayProperty=nameWithType> returns <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry`1> instances for all tracked entities, or for all tracked entities of a given type.
+- <xref:Microsoft.EntityFrameworkCore.DbContext.Find*?displayProperty=nameWithType>, <xref:Microsoft.EntityFrameworkCore.DbContext.FindAsync*?displayProperty=nameWithType>, <xref:Microsoft.EntityFrameworkCore.DbSet`1.Find*?displayProperty=nameWithType>, and <xref:Microsoft.EntityFrameworkCore.DbSet`1.FindAsync*?displayProperty=nameWithType> find a single entity by primary key, first looking in tracked entities, and then querying the database if needed.
+- <xref:Microsoft.EntityFrameworkCore.DbSet`1.Local?displayProperty=nameWithType> returns actual entities (not EntityEntry instances) for entities of the entity type represented by the DbSet.
+
+Each of these is described in more detail in the sections below.
+
+> [!TIP]
+> This document assumes that entity states and the basics of EF Core change tracking are understood. See [Change Tracking in EF Core](xref:core/change-tracking/index) for more information on these topics.
+
+> [!TIP]
+> You can run and debug into all the code in this document by [downloading the sample code from GitHub](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/ChangeTracking/AccessingTrackedEntities).
+
+## Using DbContext.Entry and EntityEntry instances
+
+For each tracked entity, Entity Framework Core (EF Core) keeps track of:
+
+- The overall state of the entity. This is one of `Unchanged`, `Modified`, `Added`, or `Deleted`; see [Change Tracking in EF Core](xref:core/change-tracking/index) for more information.
+- The relationships between tracked entities. For example, the blog to which a post belongs.
+- The "current values" of properties.
+- The "original values" of properties, when this information is available. Original values are the property values that existed when entity was queried from the database.
+- Which property values have been modified since they were queried.
+- Other information about property values, such as whether or not the value is [temporary](xref:core/change-tracking/miscellaneous#temporary-values).
+
+Passing an entity instance to <xref:System.Data.Entity.DbContext.Entry*?displayProperty=nameWithType> results in an <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry`1> providing access to this information for the given entity. For example:
+
+<!--
+        using var context = new BlogsContext();
+
+        var blog = context.Blogs.Single(e => e.Id == 1);
+        var entityEntry = context.Entry(blog);
+
+-->
+[!code-csharp[Using_DbContext_Entry_and_EntityEntry_instances_1](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Using_DbContext_Entry_and_EntityEntry_instances_1)]
+
+The following sections show how to use an EntityEntry to access and manipulate entity state, as well as the state of the entity's properties and navigations.
+
+### Working with the entity
+
+The most common use of <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry`1> is to access the current <xref:Microsoft.EntityFrameworkCore.EntityState> of an entity. For example:
+
+<!--
+        var currentState = context.Entry(blog).State;
+        if (currentState == EntityState.Unchanged)
+        {
+            context.Entry(blog).State = EntityState.Modified;
+        }
+-->
+[!code-csharp[Work_with_the_entity_1](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Work_with_the_entity_1)]
+
+The Entry method can also be used on entities that are not yet tracked. This _does not start tracking the entity_; the state of the entity is still `Detached`. However, the returned EntityEntry can then be used to change the entity state, at which point the entity will become tracked in the given state. For example, the following code will start tracking a Blog instance as `Added`:
+
+<!--
+        var newBlog = new Blog();
+        Debug.Assert(context.Entry(newBlog).State == EntityState.Detached);
+
+        context.Entry(newBlog).State = EntityState.Added;
+        Debug.Assert(context.Entry(newBlog).State == EntityState.Added);
+-->
+[!code-csharp[Work_with_the_entity_2](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Work_with_the_entity_2)]
+
+> [!TIP]
+> Unlike in EF6, setting the state of an individual entity will not cause all connected entities to be tracked. This makes setting the state this way a lower-level operation than calling `Add`, `Attach`, or `Update`, which operate on an entire graph of entities.
+
+The following table summarizes ways to use an EntityEntry to work with an entire entity:
+
+| EntityEntry member                                                                                         | Description
+|:-----------------------------------------------------------------------------------------------------------|----------------------
+| <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry.State?displayProperty=nameWithType>         | Gets and sets the <xref:Microsoft.EntityFrameworkCore.EntityState> of the entity.
+| <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry.Entity?displayProperty=nameWithType>        | Gets the entity instance.
+| <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry.Context?displayProperty=nameWithType>       | The <xref:Microsoft.EntityFrameworkCore.DbContext> that is tracking this entity.
+| <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry.Metadata?displayProperty=nameWithType>      | <xref:Microsoft.EntityFrameworkCore.Metadata.IEntityType> metadata for the type of entity.
+| <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry.IsKeySet?displayProperty=nameWithType>      | Whether or not the entity has had its key value set.
+| <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry.Reload?displayProperty=nameWithType>        | Overwrites property values with values read from the database.
+| <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry.DetectChanges?displayProperty=nameWithType> | Forces detection of changes for this entity only; see [Change Detection and Notifications](xref:core/change-tracking/change-detection).
+
+### Working with a single property
+
+Several overloads of <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry`1.Property*?displayProperty=nameWithType> allow access to information about an individual property of an entity. For example, using a strongly-typed, fluent-like API:
+
+<!--
+            PropertyEntry<Blog, string> propertyEntry = context.Entry(blog).Property(e => e.Name);
+-->
+[!code-csharp[Work_with_a_single_property_1a](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Work_with_a_single_property_1a)]
+
+The property name can instead be passed as a string. For example:
+
+<!--
+            PropertyEntry<Blog, string> propertyEntry = context.Entry(blog).Property<string>("Name");
+-->
+[!code-csharp[Work_with_a_single_property_1b](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Work_with_a_single_property_1b)]
+
+The returned <xref:Microsoft.EntityFrameworkCore.ChangeTracking.PropertyEntry`2> can then be used to access information about the property. For example, it can be used to get and set the current value of the property on this entity:
+
+<!--
+            string currentValue = context.Entry(blog).Property(e => e.Name).CurrentValue;
+            context.Entry(blog).Property(e => e.Name).CurrentValue = "1unicorn2";
+-->
+[!code-csharp[Work_with_a_single_property_1d](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Work_with_a_single_property_1d)]
+
+Both of the Property methods used above return a strongly-typed generic <xref:Microsoft.EntityFrameworkCore.ChangeTracking.PropertyEntry`2> instance. Using this generic type is preferred because it allows access to property values without [boxing value types](/dotnet/csharp/programming-guide/types/boxing-and-unboxing). However, if the type of entity or property is not known at compile-time, then a non-generic <xref:Microsoft.EntityFrameworkCore.ChangeTracking.PropertyEntry> can be obtained instead:
+
+<!--
+            var propertyEntry = context.Entry(blog).Property("Name");
+-->
+[!code-csharp[Work_with_a_single_property_1c](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Work_with_a_single_property_1c)]
+
+This allows access to property information for any property regardless of its type, at the expense of boxing value types. For example:
+
+<!--
+            object blog = context.Blogs.Single(e => e.Id == 1);
+
+            object currentValue = context.Entry(blog).Property("Name").CurrentValue;
+            context.Entry(blog).Property("Name").CurrentValue = "1unicorn2";
+-->
+[!code-csharp[Work_with_a_single_property_1e](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Work_with_a_single_property_1e)]
+
+The following table summarizes property information exposed by PropertyEntry:
+
+| PropertyEntry member                               | Description
+|:-------------------------------------------------|----------------------
+| <xref:Microsoft.EntityFrameworkCore.ChangeTracking.PropertyEntry`2.CurrentValue?displayProperty=nameWithType>  | Gets and sets the current value of the property.
+| <xref:Microsoft.EntityFrameworkCore.ChangeTracking.PropertyEntry`2.OriginalValue?displayProperty=nameWithType> | Gets and sets the original value of the property, if available.
+| <xref:Microsoft.EntityFrameworkCore.ChangeTracking.PropertyEntry`2.EntityEntry?displayProperty=nameWithType>   | A back reference to the <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry`1> for the entity.
+| <xref:Microsoft.EntityFrameworkCore.ChangeTracking.PropertyEntry.Metadata?displayProperty=nameWithType>          | <xref:Microsoft.EntityFrameworkCore.Metadata.IProperty> metadata for the property.
+| <xref:Microsoft.EntityFrameworkCore.ChangeTracking.PropertyEntry.IsModified?displayProperty=nameWithType>        | Indicates whether this property is marked as modified, and allows this state to be changed.
+| <xref:Microsoft.EntityFrameworkCore.ChangeTracking.PropertyEntry.IsTemporary?displayProperty=nameWithType>       | Indicates whether this property is marked as [temporary](xref:core/change-tracking/miscellaneous#temporary-values#temporary-values), and allows this state to be changed.
+
+Notes:
+
+- The original value of a property is the value that the property had when the entity was queried from the database. However, original values are not available if the entity was disconnected and then explicitly attached to another DbContext, for example with `Attach` or `Update`. In this case, the original value returned will be the same as the current value.
+- <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*> will only update properties marked as modified. Set <xref:Microsoft.EntityFrameworkCore.ChangeTracking.PropertyEntry.IsModified> to true to force EF Core to update a given property value, or set it to false to prevent EF Core from updating the property value.
+- [Temporary values](xref:core/change-tracking/miscellaneous) are typically generated by EF Core [value generators](xref:core/modeling/generated-properties). Setting the current value of a property will replace the temporary value with the given value and mark the property as not temporary. Set <xref:Microsoft.EntityFrameworkCore.ChangeTracking.PropertyEntry.IsTemporary> to true to force a value to be temporary even after it has been explicitly set.
+
+### Working with a single navigation
+
+Several overloads of <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry`1.Reference*?displayProperty=nameWithType>, <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry`1.Collection*?displayProperty=nameWithType>, and <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry.Navigation*?displayProperty=nameWithType> allow access to information about an individual navigation.
+
+Reference navigations to a single related entity are accessed through the <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry`1.Reference*> methods. Reference navigations point to the "one" sides of one-to-many relationships, and both sides of one-to-one relationships. For example:
+
+<!--
+        ReferenceEntry<Post, Blog> referenceEntry1 = context.Entry(post).Reference(e => e.Blog);
+        ReferenceEntry<Post, Blog> referenceEntry2 = context.Entry(post).Reference<Blog>("Blog");
+        ReferenceEntry referenceEntry3 = context.Entry(post).Reference("Blog");
+-->
+[!code-csharp[Work_with_a_single_navigation_1](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Work_with_a_single_navigation_1)]
+
+Navigations can also be collections of related entities when used for the "many" sides of one-to-many and many-to-many relationships. The <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry`1.Collection*> methods are used to access collection navigations. For example:
+
+<!--
+        CollectionEntry<Blog, Post> collectionEntry1 = context.Entry(blog).Collection(e => e.Posts);
+        CollectionEntry<Blog, Post> collectionEntry2 = context.Entry(blog).Collection<Post>("Posts");
+        CollectionEntry collectionEntry3 = context.Entry(blog).Collection("Posts");
+-->
+[!code-csharp[Work_with_a_single_navigation_2a](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Work_with_a_single_navigation_2a)]
+
+Some operations are common for all navigations. These can be accessed for both reference and collection navigations using the <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry.Navigation*?displayProperty=nameWithType> method. Note that only non-generic access is available when accessing all navigations together. For example:
+
+<!--
+        NavigationEntry navigationEntry = context.Entry(blog).Navigation("Posts");
+-->
+[!code-csharp[Work_with_a_single_navigation_2b](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Work_with_a_single_navigation_2b)]
+
+The following table summarizes ways to use <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ReferenceEntry`2>, <xref:Microsoft.EntityFrameworkCore.ChangeTracking.CollectionEntry`2>, and <xref:Microsoft.EntityFrameworkCore.ChangeTracking.NavigationEntry>:
+
+| NavigationEntry member                                                                                    | Description
+|:----------------------------------------------------------------------------------------------------------|----------------------
+| <xref:Microsoft.EntityFrameworkCore.ChangeTracking.MemberEntry.CurrentValue?displayProperty=nameWithType> | Gets and sets the current value of the navigation. This is the entire collection for collection navigations.
+| <xref:Microsoft.EntityFrameworkCore.ChangeTracking.NavigationEntry.Metadata?displayProperty=nameWithType> | <xref:Microsoft.EntityFrameworkCore.Metadata.INavigationBase> metadata for the navigation.
+| <xref:Microsoft.EntityFrameworkCore.ChangeTracking.NavigationEntry.IsLoaded?displayProperty=nameWithType> | Gets or sets a value indicating whether the related entity or collection has been fully loaded from the database.
+| <xref:Microsoft.EntityFrameworkCore.ChangeTracking.NavigationEntry.Load?displayProperty=nameWithType>     | Loads the related entity or collection from the database; see [Explicit Loading of Related Data](xref:core/querying/related-data/explicit).
+| <xref:Microsoft.EntityFrameworkCore.ChangeTracking.NavigationEntry.Query?displayProperty=nameWithType>    | The query EF Core would use to load this navigation as an `IQueryable` that can be further composed; see [Explicit Loading of Related Data](xref:core/querying/related-data/explicit).
+
+### Working with all properties of an entity
+
+<xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry.Properties?displayProperty=nameWithType> returns an <xref:System.Collections.Generic.IEnumerable`1> of <xref:Microsoft.EntityFrameworkCore.ChangeTracking.PropertyEntry> for every property of the entity. This can be used to perform an action for every property of the entity. For example, to set any DateTime property to `DateTime.Now`:
+
+<!--
+        foreach (var propertyEntry in context.Entry(blog).Properties)
+        {
+            if (propertyEntry.Metadata.ClrType == typeof(DateTime))
+            {
+                propertyEntry.CurrentValue = DateTime.Now;
+            }
+        }
+-->
+[!code-csharp[Work_with_all_properties_of_an_entity_1](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Work_with_all_properties_of_an_entity_1)]
+
+In addition, EntityEntry contains several methods to get and set all property values at the same time. These methods use the <xref:Microsoft.EntityFrameworkCore.ChangeTracking.PropertyValues> class, which represents a collection of properties and their values. PropertyValues can be obtained for current or original values, or for the values as currently stored in the database. For example:
+
+<!--
+        var currentValues = context.Entry(blog).CurrentValues;
+        var originalValues = context.Entry(blog).OriginalValues;
+        var databaseValues = context.Entry(blog).GetDatabaseValues();
+-->
+[!code-csharp[Work_with_all_properties_of_an_entity_2a](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Work_with_all_properties_of_an_entity_2a)]
+
+These PropertyValues objects are not very useful on their own. However, they can be combined to perform common operations needed when manipulating entities. This is useful when working with data transfer objects and when resolving [optimistic concurrency conflicts](xref:core/saving/concurrency). The following sections show some examples.
+
+#### Setting current or original values from an entity or DTO
+
+The current or original values of an entity can be updated by copying values from another object. For example, consider a `BlogDto` data transfer object (DTO) with the same properties as the entity type:
+
+<!--
+public class BlogDto
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+}
+-->
+[!code-csharp[BlogDto](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=BlogDto)]
+
+This can be used to set the current values of a tracked entity using <xref:Microsoft.EntityFrameworkCore.ChangeTracking.PropertyValues.SetValues*?displayProperty=nameWithType>:
+
+<!--
+        var blogDto = new BlogDto { Id = 1, Name = "1unicorn2" };
+
+        context.Entry(blog).CurrentValues.SetValues(blogDto);
+-->
+[!code-csharp[Work_with_all_properties_of_an_entity_2b](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Work_with_all_properties_of_an_entity_2b)]
+
+This technique is sometimes used when updating an entity with values obtained from a service call or a client in an n-tier application. Note that the object used does not have to be of the same type as the entity so long as it has properties whose names match those of the entity. In the example above, an instance of the DTO `BlogDto` is used to set the current values of a tracked `Blog` entity.
+
+Note that properties will only be marked as modified if the value set differs from the current value.
+
+#### Setting current or original values from a dictionary
+
+The previous example set values from an entity or DTO instance. The same behavior is available when property values are stored as name/value pairs in a dictionary. For example:
+
+<!--
+        var blogDictionary = new Dictionary<string, object>
+        {
+            ["Id"] = 1,
+            ["Name"] = "1unicorn2"
+        };
+
+        context.Entry(blog).CurrentValues.SetValues(blogDictionary);
+-->
+[!code-csharp[Work_with_all_properties_of_an_entity_2d](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Work_with_all_properties_of_an_entity_2d)]
+
+#### Setting current or original values from the database
+
+The current or original values of an entity can be updated with the latest values from the database by calling <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry.GetDatabaseValues> or <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry.GetDatabaseValuesAsync*> and using the returned object to set current or original values, or both. For example:
+
+<!--
+        var databaseValues = context.Entry(blog).GetDatabaseValues();
+        context.Entry(blog).CurrentValues.SetValues(databaseValues);
+        context.Entry(blog).OriginalValues.SetValues(databaseValues);
+-->
+[!code-csharp[Work_with_all_properties_of_an_entity_2c](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Work_with_all_properties_of_an_entity_2c)]
+
+#### Creating a cloned object containing current, original, or database values
+
+The PropertyValues object returned from CurrentValues, OriginalValues, or GetDatabaseValues can be used to create a clone of the entity using <xref:Microsoft.EntityFrameworkCore.ChangeTracking.PropertyValues.ToObject?displayProperty=nameWithType>. For example:
+
+<!--
+var clonedBlog = context.Entry(blog).GetDatabaseValues().ToObject();
+-->
+[!code-csharp[Work_with_all_properties_of_an_entity_2e](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Work_with_all_properties_of_an_entity_2e)]
+
+Note that `ToObject` returns a new instance that is not tracked by the DbContext. The returned object also does not have any relationships set to other entities.
+
+The cloned object can be useful for resolving issues related to concurrent updates to the database, especially when data binding to objects of a certain type. See [optimistic concurrency](xref:core/saving/concurrency) for more information.
+
+### Working with all navigations of an entity
+
+<xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry.Navigations?displayProperty=nameWithType> returns an <xref:System.Collections.Generic.IEnumerable`1> of <xref:Microsoft.EntityFrameworkCore.ChangeTracking.NavigationEntry> for every navigation of the entity. <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry.References?displayProperty=nameWithType> and <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry.Collections?displayProperty=nameWithType> do the same thing, but restricted to reference or collection navigations respectively. This can be used to perform an action for every navigation of the entity. For example, to force loading of all related entities:
+
+<!--
+        foreach (var navigationEntry in context.Entry(blog).Navigations)
+        {
+            navigationEntry.Load();
+        }
+-->
+[!code-csharp[Work_with_all_navigations_of_an_entity_1](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Work_with_all_navigations_of_an_entity_1)]
+
+### Working with all members of an entity
+
+Regular properties and navigation properties have different state and behavior. It is therefore common to process navigations and non-navigations separately, as shown in the sections above. However, sometimes it can be useful to do something with any member of the entity, regardless of whether it is a regular property or navigation. <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry.Member*?displayProperty=nameWithType> and <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry.Members?displayProperty=nameWithType> are provided for this purpose. For example:
+
+<!--
+        foreach (var memberEntry in context.Entry(blog).Members)
+        {
+            Console.WriteLine(
+                $"Member {memberEntry.Metadata.Name} is of type {memberEntry.Metadata.ClrType.ShortDisplayName()} and has value {memberEntry.CurrentValue}");
+        }
+-->
+[!code-csharp[Work_with_all_members_of_an_entity_1](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Work_with_all_members_of_an_entity_1)]
+
+Running this code on a blog from the sample generates the following output:
+
+```output
+Member Id is of type int and has value 1
+Member Name is of type string and has value .NET Blog
+Member Posts is of type IList<Post> and has value System.Collections.Generic.List`1[Post]
+```
+
+> [!TIP]
+> The [change tracker debug view](xref:core/change-tracking/debug-views) shows information like this. The debug view for the entire change tracker is generated from the individual <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry.DebugView?displayProperty=nameWithType> of each tracked entity.
+
+## Find and FindAsync
+
+<xref:Microsoft.EntityFrameworkCore.DbContext.Find*?displayProperty=nameWithType>, <xref:Microsoft.EntityFrameworkCore.DbContext.FindAsync*?displayProperty=nameWithType>, <xref:Microsoft.EntityFrameworkCore.DbSet`1.Find*?displayProperty=nameWithType>, and <xref:Microsoft.EntityFrameworkCore.DbSet`1.FindAsync*?displayProperty=nameWithType> are designed for efficient lookup of a single entity when its primary key is known. Find first checks if the entity is already tracked, and if so returns the entity immediately. A database query is only made if the entity is not tracked locally. For example, consider this code that calls Find twice for the same entity:
+
+<!--
+        using var context = new BlogsContext();
+
+        Console.WriteLine("First call to Find...");
+        var blog1 = context.Blogs.Find(1);
+
+        Console.WriteLine($"...found blog {blog1.Name}");
+
+        Console.WriteLine();
+        Console.WriteLine("Second call to Find...");
+        var blog2 = context.Blogs.Find(1);
+        Debug.Assert(blog1 == blog2);
+
+        Console.WriteLine("...returned the same instance without executing a query.");
+-->
+[!code-csharp[Find_and_FindAsync_1](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Find_and_FindAsync_1)]
+
+The output from this code (including EF Core logging) when using SQLite is:
+
+```output
+First call to Find...
+info: 12/29/2020 07:45:53.682 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed DbCommand (1ms) [Parameters=[@__p_0='1' (DbType = String)], CommandType='Text', CommandTimeout='30']
+      SELECT "b"."Id", "b"."Name"
+      FROM "Blogs" AS "b"
+      WHERE "b"."Id" = @__p_0
+      LIMIT 1
+...found blog .NET Blog
+
+Second call to Find...
+...returned the same instance without executing a query.
+```
+
+Notice that the first call does not find the entity locally and so executes a database query. Conversely, the second call returns the same instance without querying the database because it is already being tracked.
+
+Find returns null if an entity with the given key is not tracked locally and does not exist in the database.
+
+### Composite keys
+
+Find can also be used with composite keys. For example, consider an `OrderLine` entity with a composite key consisting of the order ID and the product ID:
+
+<!--
+public class OrderLine
+{
+    public int OrderId { get; set; }
+    public int ProductId { get; set; }
+
+    //...
+}
+-->
+[!code-csharp[OrderLine](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=OrderLine)]
+
+The composite key must be configured in <xref:Microsoft.EntityFrameworkCore.DbContext.OnModelCreating*?displayProperty=nameWithType> to define the key parts _and their order_. For example:
+
+<!--
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder
+            .Entity<OrderLine>()
+            .HasKey(e => new { e.OrderId, e.ProductId });
+    }
+-->
+[!code-csharp[OnModelCreating](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=OnModelCreating)]
+
+Notice that `OrderId` is the first part of the key and `ProductId` is the second part of the key. This order must be used when passing key values to Find. For example:
+
+<!--
+        var orderline = context.OrderLines.Find(orderId, productId);
+-->
+[!code-csharp[Find_and_FindAsync_2](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Find_and_FindAsync_2)]
+
+## Using ChangeTracker.Entries to access all tracked entities
+
+So far we have accessed only a single <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry> at a time. <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.Entries?displayProperty=nameWithType> returns an EntityEntry for every entity currently tracked by the DbContext. For example:
+
+<!--
+        using var context = new BlogsContext();
+        var blogs = context.Blogs.Include(e => e.Posts).ToList();
+
+        foreach (var entityEntry in context.ChangeTracker.Entries())
+        {
+            Console.WriteLine($"Found {entityEntry.Metadata.Name} entity with ID {entityEntry.Property("Id").CurrentValue}");
+        }
+-->
+[!code-csharp[Using_ChangeTracker_Entries_to_access_all_tracked_entities_1a](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Using_ChangeTracker_Entries_to_access_all_tracked_entities_1a)]
+
+This code generates the following output:
+
+```output
+Found Blog entity with ID 1
+Found Post entity with ID 1
+Found Post entity with ID 2
+```
+
+Notice that entries for both blogs and posts are returned. The results can instead be filtered to a specific entity type using the <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.Entries%60`1?displayProperty=nameWithType> generic overload:
+
+<!--
+        foreach (var entityEntry in context.ChangeTracker.Entries<Post>())
+        {
+            Console.WriteLine(
+                $"Found {entityEntry.Metadata.Name} entity with ID {entityEntry.Property(e => e.Id).CurrentValue}");
+        }
+-->
+[!code-csharp[Using_ChangeTracker_Entries_to_access_all_tracked_entities_1b](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Using_ChangeTracker_Entries_to_access_all_tracked_entities_1b)]
+
+The output from this code shows that only posts are returned:
+
+```output
+Found Post entity with ID 1
+Found Post entity with ID 2
+```
+
+Also, using the generic overload returns generic <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry`1> instances. This is what allows that fluent-like access to the `Id` property in this example.
+
+The generic type used for filtering does not have to be a mapped entity type; an unmapped base type or interface can be used instead. For example, if all the entity types in the model implement an interface defining their key property:
+
+<!--
+public interface IEntityWithKey
+{
+    int Id { get; set; }
+}
+-->
+[!code-csharp[IEntityWithKey](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=IEntityWithKey)]
+
+Then this interface can be used to work with the key of any tracked entity in a strongly-typed manner. For example:
+
+<!--
+        foreach (var entityEntry in context.ChangeTracker.Entries<IEntityWithKey>())
+        {
+            Console.WriteLine(
+                $"Found {entityEntry.Metadata.Name} entity with ID {entityEntry.Property(e => e.Id).CurrentValue}");
+        }
+-->
+[!code-csharp[Using_ChangeTracker_Entries_to_access_all_tracked_entities_1c](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Using_ChangeTracker_Entries_to_access_all_tracked_entities_1c)]
+
+## Using DbSet.Local to query tracked entities
+
+EF Core queries are always executed on the database, and only return entities that have been saved to the database. <xref:Microsoft.EntityFrameworkCore.DbSet`1.Local?displayProperty=nameWithType> provides a mechanism to query the DbContext for local, tracked entities.
+
+Since `DbSet.Local` is used to query tracked entities, it is typical to load entities into the DbContext and then work with those loaded entities. This is especially true for data binding, but can also be useful in other situations. For example, in the following code the database is first queried for all blogs and posts. The <xref:Microsoft.EntityFrameworkCore.EntityFrameworkQueryableExtensions.Load*> extension method is used to execute this query with the results tracked by the context without being returned directly to the application. (Using `ToList` or similar has the same effect but with the overhead of creating the returned list, which is not needed here.) The example then uses `DbSet.Local` to access the locally tracked entities:
+
+<!--
+        using var context = new BlogsContext();
+
+        context.Blogs.Include(e => e.Posts).Load();
+
+        foreach (var blog in context.Blogs.Local)
+        {
+            Console.WriteLine($"Blog: {blog.Name}");
+        }
+
+        foreach (var post in context.Posts.Local)
+        {
+            Console.WriteLine($"Post: {post.Title}");
+        }
+-->
+[!code-csharp[Using_DbSet_Local_to_query_tracked_entities_1](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Using_DbSet_Local_to_query_tracked_entities_1)]
+
+Notice that, unlike <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.Entries?displayProperty=nameWithType>, `DbSet.Local` returns entity instances directly. An EntityEntry can, of course, always be obtained for the returned entity by calling <xref:System.Data.Entity.DbContext.Entry*?displayProperty=nameWithType>.
+
+### The local view
+
+<xref:Microsoft.EntityFrameworkCore.DbSet`1.Local?displayProperty=nameWithType> returns a view of locally tracked entities that reflects the current <xref:Microsoft.EntityFrameworkCore.EntityState> of those entities. Specifically, this means that:
+
+- `Added` entities are included. Note that this is not the case for normal EF Core queries, since `Added` entities do not yet exist in the database and so are therefore never returned by a database query.
+- `Deleted` entities are excluded. Note that this is again not the case for normal EF Core queries, since `Deleted` entities still exist in the database and so _are_ returned by database queries.
+
+All of this means that `DbSet.Local` is a view over the data that reflects the current conceptual state of the entity graph, with `Added` entities included and `Deleted` entities excluded. This matches what database state is expected to be after SaveChanges is called.
+
+This is typically the ideal view for data binding, since it presents to the user the data as they understand it based on the changes made by the application.
+
+The following code demonstrates this by marking one post as `Deleted` and then adding a new post, marking it as `Added`:
+
+<!--
+        using var context = new BlogsContext();
+
+        var posts = context.Posts.Include(e => e.Blog).ToList();
+
+        Console.WriteLine("Local view after loading posts:");
+
+        foreach (var post in context.Posts.Local)
+        {
+            Console.WriteLine($"  Post: {post.Title}");
+        }
+
+        context.Remove(posts[1]);
+
+        context.Add(new Post
+        {
+            Title = "What’s next for System.Text.Json?",
+            Content = ".NET 5.0 was released recently and has come with many...",
+            Blog = posts[0].Blog
+        });
+
+        Console.WriteLine("Local view after adding and deleting posts:");
+
+        foreach (var post in context.Posts.Local)
+        {
+            Console.WriteLine($"  Post: {post.Title}");
+        }
+-->
+[!code-csharp[Using_DbSet_Local_to_query_tracked_entities_2](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Using_DbSet_Local_to_query_tracked_entities_2)]
+
+The output from this code is:
+
+```output
+Local view after loading posts:
+  Post: Announcing the Release of EF Core 5.0
+  Post: Announcing F# 5
+  Post: Announcing .NET 5.0
+Local view after adding and deleting posts:
+  Post: What’s next for System.Text.Json?
+  Post: Announcing the Release of EF Core 5.0
+  Post: Announcing .NET 5.0
+```
+
+Notice that the deleted post is removed from the local view, and the added post is included.
+
+### Using Local to add and remove entities
+
+<xref:Microsoft.EntityFrameworkCore.DbSet`1.Local?displayProperty=nameWithType> returns an instance of <xref:Microsoft.EntityFrameworkCore.ChangeTracking.LocalView`1>. This is an implementation of <xref:System.Collections.Generic.ICollection`1> that generates and responds to notifications when entities are added and removed from the collection. (This is the same concept as <xref:System.Collections.ObjectModel.ObservableCollection`1>, but implemented as a projection over existing EF Core change tracking entries, rather than as an independent collection.)
+
+The local view's notifications are hooked into DbContext change tracking such that the local view stays in sync with the DbContext. Specifically:
+
+- Adding a new entity to `DbSet.Local` causes it to be tracked by the DbContext, typically in the `Added` state. (If the entity already has a generated key value, then it is tracked as `Unchanged` instead.)
+- Removing an entity from `DbSet.Local` causes it to be marked as `Deleted`.
+- An entity that becomes tracked by the DbContext will automatically appear in the `DbSet.Local` collection. For example, executing a query to bring in more entities automatically causes the local view to be updated.
+- An entity that is marked as `Deleted` will be removed from the local collection automatically.
+
+This means the local view can be used to manipulate tracked entities simply by adding and removing from the collection. For example, let's modify the previous example code to add and remove posts from the local collection:
+
+<!--
+        using var context = new BlogsContext();
+
+        var posts = context.Posts.Include(e => e.Blog).ToList();
+
+        Console.WriteLine("Local view after loading posts:");
+
+        foreach (var post in context.Posts.Local)
+        {
+            Console.WriteLine($"  Post: {post.Title}");
+        }
+
+        context.Posts.Local.Remove(posts[1]);
+
+        context.Posts.Local.Add(new Post
+        {
+            Title = "What’s next for System.Text.Json?",
+            Content = ".NET 5.0 was released recently and has come with many...",
+            Blog = posts[0].Blog
+        });
+
+        Console.WriteLine("Local view after adding and deleting posts:");
+
+        foreach (var post in context.Posts.Local)
+        {
+            Console.WriteLine($"  Post: {post.Title}");
+        }
+-->
+[!code-csharp[Using_DbSet_Local_to_query_tracked_entities_3](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Using_DbSet_Local_to_query_tracked_entities_3)]
+
+The output remains unchanged from the previous example because changes made to the local view are synced with the DbContext.
+
+### Using the local view for Windows Forms or WPF data binding
+
+<xref:Microsoft.EntityFrameworkCore.DbSet`1.Local?displayProperty=nameWithType> forms the basis for data binding to EF Core entities. However, both Windows Forms and WPF work best when used with the specific type of notifying collection that they expect. The local view supports creating these specific collection types:
+
+- <xref:Microsoft.EntityFrameworkCore.ChangeTracking.LocalView`1.ToObservableCollection?displayProperty=nameWithType> returns an <xref:System.Collections.ObjectModel.ObservableCollection`1> for WPF data binding.
+- <xref:Microsoft.EntityFrameworkCore.ChangeTracking.LocalView`1.ToBindingList?displayProperty=nameWithType> returns a <xref:System.ComponentModel.BindingList`1> for Windows Forms data binding.
+
+For example:
+
+<!--
+        ObservableCollection<Post> observableCollection = context.Posts.Local.ToObservableCollection();
+        BindingList<Post> bindingList = context.Posts.Local.ToBindingList();
+-->
+[!code-csharp[Using_DbSet_Local_to_query_tracked_entities_4](../../../samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs?name=Using_DbSet_Local_to_query_tracked_entities_4)]
+
+See [Get Started with WPF](xref:core/get-started/wpf) for more information on WPF data binding with EF Core, and [Get Started with Windows Forms](xref:core/get-started/winforms) for more information on Windows Forms data binding with EF Core.
+
+> [!TIP]
+> The local view for a given DbSet instance is created lazily when first accessed and then cached. LocalView creation itself is fast and it does not use significant memory. However, it does call [DetectChanges](xref:core/change-tracking/change-detection), which can be slow for large numbers of entities. The collections created by `ToObservableCollection` and `ToBindingList` are also created lazily and then cached. Both of these methods create new collections, which can be slow and use a lot of memory when thousands of entities are involved.
diff --git a/entity-framework/core/change-tracking/explicit-tracking.md b/entity-framework/core/change-tracking/explicit-tracking.md
new file mode 100644
index 0000000000..4fb359d737
--- /dev/null
+++ b/entity-framework/core/change-tracking/explicit-tracking.md
@@ -0,0 +1,958 @@
+---
+title: Explicitly Tracking Entities - EF Core
+description: Explicitly tracking entities with DbContext using Add, Attach, Update, and Remove
+author: SamMonoRT
+ms.date: 12/30/2020
+uid: core/change-tracking/explicit-tracking
+---
+
+# Explicitly Tracking Entities
+
+Each <xref:Microsoft.EntityFrameworkCore.DbContext> instance tracks changes made to entities. These tracked entities in turn drive the changes to the database when <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*> is called.
+
+Entity Framework Core (EF Core) change tracking works best when the same <xref:Microsoft.EntityFrameworkCore.DbContext> instance is used to both query for entities and update them by calling <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*>. This is because EF Core automatically tracks the state of queried entities and then detects any changes made to these entities when SaveChanges is called. This approach is covered in [Change Tracking in EF Core](xref:core/change-tracking/index).
+
+> [!TIP]
+> This document assumes that entity states and the basics of EF Core change tracking are understood. See [Change Tracking in EF Core](xref:core/change-tracking/index) for more information on these topics.
+
+> [!TIP]
+> You can run and debug into all the code in this document by [downloading the sample code from GitHub](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/ChangeTracking/ChangeTrackingInEFCore).
+
+## Introduction
+
+Entities can be explicitly "attached" to a <xref:Microsoft.EntityFrameworkCore.DbContext> such that the context then tracks those entities. This is primarily useful when:
+
+1. Creating new entities that will be inserted into the database.
+2. Re-attaching disconnected entities that were previously queried by a _different_ DbContext instance.
+
+The first of these will be needed by most applications, and is primarily handled by the <xref:Microsoft.EntityFrameworkCore.DbContext.Add*?displayProperty=nameWithType> methods.
+
+The second is only needed by applications that change entities or their relationships **_while the entities are not being tracked_**. For example, a web application may send entities to the web client where the user makes changes and sends the entities back. These entities are referred to as "disconnected" since they were originally queried from a DbContext, but were then disconnected from that context when sent to the client.
+
+The web application must now re-attach these entities so that they are again tracked and indicate the changes that have been made such that <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*> can make appropriate updates to the database. This is primarily handled by the <xref:Microsoft.EntityFrameworkCore.DbContext.Attach*?displayProperty=nameWithType> and <xref:Microsoft.EntityFrameworkCore.DbContext.Update*?displayProperty=nameWithType> methods.
+
+> [!TIP]
+> Attaching entities to the _same DbContext instance_ that they were queried from should not normally be needed. Do not routinely perform a no-tracking query and then attach the returned entities to the same context. This will be slower than using a tracking query, and may also result in issues such as missing shadow property values, making it harder to get right.
+
+### Generated versus explicit key values
+
+By default, integer and GUID [key properties](xref:core/modeling/keys) are configured to use [automatically generated key values](xref:core/modeling/generated-properties). This has a **major advantage for change tracking: an unset key value indicates that the entity is "new"**. By "new", we mean that it has not yet been inserted into the database.
+
+Two models are used in the following sections. The first is configured to **not** use generated key values:
+
+<!--
+    public class Blog
+    {
+        [DatabaseGenerated(DatabaseGeneratedOption.None)]
+        public int Id { get; set; }
+
+        public string Name { get; set; }
+
+        public IList<Post> Posts { get; } = new List<Post>();
+    }
+
+    public class Post
+    {
+        [DatabaseGenerated(DatabaseGeneratedOption.None)]
+        public int Id { get; set; }
+
+        public string Title { get; set; }
+        public string Content { get; set; }
+
+        public int? BlogId { get; set; }
+        public Blog Blog { get; set; }
+    }
+-->
+[!code-csharp[Model](../../../samples/core/ChangeTracking/ChangeTrackingInEFCore/ExplicitKeysSamples.cs?name=Model)]
+
+Non-generated (i.e. explicitly set) key values are shown first in each example because everything is very explicit and easy to follow. This is then followed by an example where generated key values are used:
+
+<!--
+public class Blog
+{
+    public int Id { get; set; }
+
+    public string Name { get; set; }
+
+    public ICollection<Post> Posts { get; } = new List<Post>();
+}
+
+public class Post
+{
+    public int Id { get; set; }
+
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int? BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
+-->
+[!code-csharp[Model](../../../samples/core/ChangeTracking/ChangeTrackingInEFCore/GeneratedKeysSamples.cs?name=Model)]
+
+Notice that the key properties in this model need no additional configuration here since using generated key values is the [default for simple integer keys](xref:core/modeling/generated-properties).
+
+## Inserting new entities
+
+### Explicit key values
+
+An entity must be tracked in the `Added` state to be inserted by <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*>. Entities are typically put in the Added state by calling one of <xref:Microsoft.EntityFrameworkCore.DbContext.Add*?displayProperty=nameWithType>, <xref:Microsoft.EntityFrameworkCore.DbContext.AddRange*?displayProperty=nameWithType>, <xref:Microsoft.EntityFrameworkCore.DbContext.AddAsync*?displayProperty=nameWithType>, <xref:Microsoft.EntityFrameworkCore.DbContext.AddRangeAsync*?displayProperty=nameWithType>, or the equivalent methods on <xref:Microsoft.EntityFrameworkCore.DbSet`1>.
+
+> [!TIP]
+> These methods all work in the same way in the context of change tracking. See [Additional Change Tracking Features](xref:core/change-tracking/miscellaneous) for more information.
+
+For example, to start tracking a new blog:
+
+<!--
+            context.Add(
+                new Blog
+                {
+                    Id = 1,
+                    Name = ".NET Blog",
+                });
+-->
+[!code-csharp[Inserting_new_entities_1](../../../samples/core/ChangeTracking/ChangeTrackingInEFCore/ExplicitKeysSamples.cs?name=Inserting_new_entities_1)]
+
+Inspecting the [change tracker debug view](xref:core/change-tracking/debug-views) following this call shows that the context is tracking the new entity in the `Added` state:
+
+```output
+Blog {Id: 1} Added
+  Id: 1 PK
+  Name: '.NET Blog'
+  Posts: []
+```
+
+However, the Add methods don't just work on an individual entity. They actually start tracking an _entire graph of related entities_, putting them all to the `Added` state. For example, to insert a new blog and associated new posts:
+
+<!--
+            context.Add(
+                new Blog
+                {
+                    Id = 1,
+                    Name = ".NET Blog",
+                    Posts =
+                    {
+                        new Post
+                        {
+                            Id = 1,
+                            Title = "Announcing the Release of EF Core 5.0",
+                            Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                        },
+                        new Post
+                        {
+                            Id = 2,
+                            Title = "Announcing F# 5",
+                            Content = "F# 5 is the latest version of F#, the functional programming language..."
+                        }
+                    }
+                });
+-->
+[!code-csharp[Inserting_new_entities_2](../../../samples/core/ChangeTracking/ChangeTrackingInEFCore/ExplicitKeysSamples.cs?name=Inserting_new_entities_2)]
+
+The context is now tracking all these entities as `Added`:
+
+```output
+Blog {Id: 1} Added
+  Id: 1 PK
+  Name: '.NET Blog'
+  Posts: [{Id: 1}, {Id: 2}]
+Post {Id: 1} Added
+  Id: 1 PK
+  BlogId: 1 FK
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...'
+  Title: 'Announcing the Release of EF Core 5.0'
+  Blog: {Id: 1}
+Post {Id: 2} Added
+  Id: 2 PK
+  BlogId: 1 FK
+  Content: 'F# 5 is the latest version of F#, the functional programming...'
+  Title: 'Announcing F# 5'
+  Blog: {Id: 1}
+```
+
+Notice that explicit values have been set for the `Id` key properties in the examples above. This is because the model here has been configured to use explicitly set key values, rather than automatically generated key values. When not using generated keys, the key properties must be explicitly set _before_ calling `Add`. These key values are then inserted when SaveChanges is called. For example, when using SQLite:
+
+```sql
+-- Executed DbCommand (0ms) [Parameters=[@p0='1' (DbType = String), @p1='.NET Blog' (Size = 9)], CommandType='Text', CommandTimeout='30']
+INSERT INTO "Blogs" ("Id", "Name")
+VALUES (@p0, @p1);
+
+-- Executed DbCommand (0ms) [Parameters=[@p2='1' (DbType = String), @p3='1' (DbType = String), @p4='Announcing the release of EF Core 5.0, a full featured cross-platform...' (Size = 72), @p5='Announcing the Release of EF Core 5.0' (Size = 37)], CommandType='Text', CommandTimeout='30']
+INSERT INTO "Posts" ("Id", "BlogId", "Content", "Title")
+VALUES (@p2, @p3, @p4, @p5);
+
+-- Executed DbCommand (0ms) [Parameters=[@p0='2' (DbType = String), @p1='1' (DbType = String), @p2='F# 5 is the latest version of F#, the functional programming language...' (Size = 72), @p3='Announcing F# 5' (Size = 15)], CommandType='Text', CommandTimeout='30']
+INSERT INTO "Posts" ("Id", "BlogId", "Content", "Title")
+VALUES (@p0, @p1, @p2, @p3);
+```
+
+All of these entities are tracked in the `Unchanged` state after SaveChanges completes, since these entities now exist in the database:
+
+```output
+Blog {Id: 1} Unchanged
+  Id: 1 PK
+  Name: '.NET Blog'
+  Posts: [{Id: 1}, {Id: 2}]
+Post {Id: 1} Unchanged
+  Id: 1 PK
+  BlogId: 1 FK
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...'
+  Title: 'Announcing the Release of EF Core 5.0'
+  Blog: {Id: 1}
+Post {Id: 2} Unchanged
+  Id: 2 PK
+  BlogId: 1 FK
+  Content: 'F# 5 is the latest version of F#, the functional programming...'
+  Title: 'Announcing F# 5'
+  Blog: {Id: 1}
+```
+
+### Generated key values
+
+As mentioned above, integer and GUID [key properties](xref:core/modeling/keys) are configured to use [automatically generated key values](xref:core/modeling/generated-properties) by default. This means that the application _must not set any key value explicitly_. For example, to insert a new blog and posts all with generated key values:
+
+<!--
+            context.Add(
+                new Blog
+                {
+                    Name = ".NET Blog",
+                    Posts =
+                    {
+                        new Post
+                        {
+                            Title = "Announcing the Release of EF Core 5.0",
+                            Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                        },
+                        new Post
+                        {
+                            Title = "Announcing F# 5",
+                            Content = "F# 5 is the latest version of F#, the functional programming language..."
+                        }
+                    }
+                });
+-->
+[!code-csharp[Inserting_new_entities_3](../../../samples/core/ChangeTracking/ChangeTrackingInEFCore/GeneratedKeysSamples.cs?name=Inserting_new_entities_3)]
+
+As with explicit key values, the context is now tracking all these entities as `Added`:
+
+```output
+Blog {Id: -2147482644} Added
+  Id: -2147482644 PK Temporary
+  Name: '.NET Blog'
+  Posts: [{Id: -2147482637}, {Id: -2147482636}]
+Post {Id: -2147482637} Added
+  Id: -2147482637 PK Temporary
+  BlogId: -2147482644 FK Temporary
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...'
+  Title: 'Announcing the Release of EF Core 5.0'
+  Blog: {Id: -2147482644}
+Post {Id: -2147482636} Added
+  Id: -2147482636 PK Temporary
+  BlogId: -2147482644 FK Temporary
+  Content: 'F# 5 is the latest version of F#, the functional programming...'
+  Title: 'Announcing F# 5'
+  Blog: {Id: -2147482644}
+```
+
+Notice in this case that [temporary key values](xref:core/change-tracking/miscellaneous#temporary-values) have been generated for each entity. These values are used by EF Core until SaveChanges is called, at which point real key values are read back from the database. For example, when using SQLite:
+
+```sql
+-- Executed DbCommand (0ms) [Parameters=[@p0='.NET Blog' (Size = 9)], CommandType='Text', CommandTimeout='30']
+INSERT INTO "Blogs" ("Name")
+VALUES (@p0);
+SELECT "Id"
+FROM "Blogs"
+WHERE changes() = 1 AND "rowid" = last_insert_rowid();
+
+-- Executed DbCommand (0ms) [Parameters=[@p1='1' (DbType = String), @p2='Announcing the release of EF Core 5.0, a full featured cross-platform...' (Size = 72), @p3='Announcing the Release of EF Core 5.0' (Size = 37)], CommandType='Text', CommandTimeout='30']
+INSERT INTO "Posts" ("BlogId", "Content", "Title")
+VALUES (@p1, @p2, @p3);
+SELECT "Id"
+FROM "Posts"
+WHERE changes() = 1 AND "rowid" = last_insert_rowid();
+
+-- Executed DbCommand (0ms) [Parameters=[@p0='1' (DbType = String), @p1='F# 5 is the latest version of F#, the functional programming language...' (Size = 72), @p2='Announcing F# 5' (Size = 15)], CommandType='Text', CommandTimeout='30']
+INSERT INTO "Posts" ("BlogId", "Content", "Title")
+VALUES (@p0, @p1, @p2);
+SELECT "Id"
+FROM "Posts"
+WHERE changes() = 1 AND "rowid" = last_insert_rowid();
+```
+
+After SaveChanges completes, all of the entities have been updated with their real key values and are tracked in the `Unchanged` state since they now match the state in the database:
+
+```output
+Blog {Id: 1} Unchanged
+  Id: 1 PK
+  Name: '.NET Blog'
+  Posts: [{Id: 1}, {Id: 2}]
+Post {Id: 1} Unchanged
+  Id: 1 PK
+  BlogId: 1 FK
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...'
+  Title: 'Announcing the Release of EF Core 5.0'
+  Blog: {Id: 1}
+Post {Id: 2} Unchanged
+  Id: 2 PK
+  BlogId: 1 FK
+  Content: 'F# 5 is the latest version of F#, the functional programming...'
+  Title: 'Announcing F# 5'
+  Blog: {Id: 1}
+```
+
+This is exactly the same end-state as the previous example that used explicit key values.
+
+> [!TIP]
+> An explicit key value can still be set even when using generated key values. EF Core will then attempt to insert using this key value. Some database configurations, including SQL Server with Identity columns, do not support such inserts and will throw ([see these docs for a workaround](xref:core/providers/sql-server/value-generation#inserting-explicit-values-into-identity-columns)).
+
+## Attaching existing entities
+
+### Explicit key values
+
+Entities returned from queries are tracked in the `Unchanged` state. The `Unchanged` state means that the entity has not been modified since it was queried. A disconnected entity, perhaps returned from a web client in an HTTP request, can be put into this state using either <xref:Microsoft.EntityFrameworkCore.DbContext.Attach*?displayProperty=nameWithType>, <xref:Microsoft.EntityFrameworkCore.DbContext.AttachRange*?displayProperty=nameWithType>, or the equivalent methods on <xref:Microsoft.EntityFrameworkCore.DbSet`1>. For example, to start tracking an existing blog:
+
+<!--
+            context.Attach(
+                new Blog
+                {
+                    Id = 1,
+                    Name = ".NET Blog",
+                });
+-->
+[!code-csharp[Attaching_existing_entities_1](../../../samples/core/ChangeTracking/ChangeTrackingInEFCore/ExplicitKeysSamples.cs?name=Attaching_existing_entities_1)]
+
+> [!NOTE]
+> The examples here are creating entities explicitly with `new` for simplicity. Normally the entity instances will have come from another source, such as being deserialized from a client, or being created from data in an HTTP Post.
+
+Inspecting the [change tracker debug view](xref:core/change-tracking/debug-views) following this call shows that the entity is tracked in the `Unchanged` state:
+
+```output
+Blog {Id: 1} Unchanged
+  Id: 1 PK
+  Name: '.NET Blog'
+  Posts: []
+```
+
+Just like `Add`, `Attach` actually sets an entire graph of connected entities to the `Unchanged` state. For example, to attach an existing blog and associated existing posts:
+
+<!--
+            context.Attach(
+                new Blog
+                {
+                    Id = 1,
+                    Name = ".NET Blog",
+                    Posts =
+                    {
+                        new Post
+                        {
+                            Id = 1,
+                            Title = "Announcing the Release of EF Core 5.0",
+                            Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                        },
+                        new Post
+                        {
+                            Id = 2,
+                            Title = "Announcing F# 5",
+                            Content = "F# 5 is the latest version of F#, the functional programming language..."
+                        }
+                    }
+                });
+-->
+[!code-csharp[Attaching_existing_entities_2](../../../samples/core/ChangeTracking/ChangeTrackingInEFCore/ExplicitKeysSamples.cs?name=Attaching_existing_entities_2)]
+
+The context is now tracking all these entities as `Unchanged`:
+
+```output
+Blog {Id: 1} Unchanged
+  Id: 1 PK
+  Name: '.NET Blog'
+  Posts: [{Id: 1}, {Id: 2}]
+Post {Id: 1} Unchanged
+  Id: 1 PK
+  BlogId: 1 FK
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...'
+  Title: 'Announcing the Release of EF Core 5.0'
+  Blog: {Id: 1}
+Post {Id: 2} Unchanged
+  Id: 2 PK
+  BlogId: 1 FK
+  Content: 'F# 5 is the latest version of F#, the functional programming...'
+  Title: 'Announcing F# 5'
+  Blog: {Id: 1}
+```
+
+Calling SaveChanges at this point will have no effect. All the entities are marked as `Unchanged`, so there is nothing to update in the database.
+
+### Generated key values
+
+As mentioned above, integer and GUID [key properties](xref:core/modeling/keys) are configured to use [automatically generated key values](xref:core/modeling/generated-properties) by default. This has a major advantage when working with disconnected entities: an unset key value indicates that the entity has not yet been inserted into the database. This allows the change tracker to automatically detect new entities and put them in the `Added` state. For example, consider attaching this graph of a blog and posts:
+
+<!--
+            context.Attach(
+                new Blog
+                {
+                    Id = 1,
+                    Name = ".NET Blog",
+                    Posts =
+                    {
+                        new Post
+                        {
+                            Id = 1,
+                            Title = "Announcing the Release of EF Core 5.0",
+                            Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                        },
+                        new Post
+                        {
+                            Id = 2,
+                            Title = "Announcing F# 5",
+                            Content = "F# 5 is the latest version of F#, the functional programming language..."
+                        },
+                        new Post
+                        {
+                            Title = "Announcing .NET 5.0",
+                            Content = ".NET 5.0 includes many enhancements, including single file applications, more..."
+                        },
+                    }
+                });
+-->
+[!code-csharp[Attaching_existing_entities_3](../../../samples/core/ChangeTracking/ChangeTrackingInEFCore/GeneratedKeysSamples.cs?name=Attaching_existing_entities_3)]
+
+The blog has a key value of 1, indicating that it already exists in the database. Two of the posts also have key values set, but the third does not. EF Core will see this key value as 0, the CLR default for an integer. This results in EF Core marking the new entity as `Added` instead of `Unchanged`:
+
+```output
+Blog {Id: 1} Unchanged
+  Id: 1 PK
+  Name: '.NET Blog'
+  Posts: [{Id: 1}, {Id: 2}, {Id: -2147482636}]
+Post {Id: -2147482636} Added
+  Id: -2147482636 PK Temporary
+  BlogId: 1 FK
+  Content: '.NET 5.0 includes many enhancements, including single file a...'
+  Title: 'Announcing .NET 5.0'
+  Blog: {Id: 1}
+Post {Id: 1} Unchanged
+  Id: 1 PK
+  BlogId: 1 FK
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...'
+  Title: 'Announcing the Release of EF Core 5.0'
+  Blog: {Id: 1}
+Post {Id: 2} Unchanged
+  Id: 2 PK
+  BlogId: 1 FK
+  Content: 'F# 5 is the latest version of F#, the functional programming...'
+```
+
+Calling SaveChanges at this point does nothing with the `Unchanged` entities, but inserts the new entity into the database. For example, when using SQLite:
+
+```sql
+-- Executed DbCommand (0ms) [Parameters=[@p0='1' (DbType = String), @p1='.NET 5.0 includes many enhancements, including single file applications, more...' (Size = 80), @p2='Announcing .NET 5.0' (Size = 19)], CommandType='Text', CommandTimeout='30']
+INSERT INTO "Posts" ("BlogId", "Content", "Title")
+VALUES (@p0, @p1, @p2);
+SELECT "Id"
+FROM "Posts"
+WHERE changes() = 1 AND "rowid" = last_insert_rowid();
+```
+
+The important point to notice here is that, with generated key values, EF Core is able to **automatically distinguish new from existing entities in a disconnected graph**. In a nutshell, when using generated keys, EF Core will always insert an entity when that entity has no key value set.
+
+## Updating existing entities
+
+### Explicit key values
+
+<xref:Microsoft.EntityFrameworkCore.DbContext.Update*?displayProperty=nameWithType>, <xref:Microsoft.EntityFrameworkCore.DbContext.UpdateRange*?displayProperty=nameWithType>, and the equivalent methods on <xref:Microsoft.EntityFrameworkCore.DbSet`1> behave exactly as the `Attach` methods described above, except that entities are put into the `Modified` instead of the `Unchanged` state. For example, to start tracking an existing blog as `Modified`:
+
+<!--
+            context.Update(
+                new Blog
+                {
+                    Id = 1,
+                    Name = ".NET Blog",
+                });
+-->
+[!code-csharp[Updating_existing_entities_1](../../../samples/core/ChangeTracking/ChangeTrackingInEFCore/ExplicitKeysSamples.cs?name=Updating_existing_entities_1)]
+
+Inspecting the [change tracker debug view](xref:core/change-tracking/debug-views) following this call shows that the context is tracking this entity in the `Modified` state:
+
+```output
+Blog {Id: 1} Modified
+  Id: 1 PK
+  Name: '.NET Blog' Modified
+  Posts: []
+```
+
+Just like with `Add` and `Attach`, `Update` actually marks an _entire graph_ of related entities as `Modified`. For example, to attach an existing blog and associated existing posts as `Modified`:
+
+<!--
+            context.Update(
+                new Blog
+                {
+                    Id = 1,
+                    Name = ".NET Blog",
+                    Posts =
+                    {
+                        new Post
+                        {
+                            Id = 1,
+                            Title = "Announcing the Release of EF Core 5.0",
+                            Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                        },
+                        new Post
+                        {
+                            Id = 2,
+                            Title = "Announcing F# 5",
+                            Content = "F# 5 is the latest version of F#, the functional programming language..."
+                        }
+                    }
+                });
+-->
+[!code-csharp[Updating_existing_entities_2](../../../samples/core/ChangeTracking/ChangeTrackingInEFCore/ExplicitKeysSamples.cs?name=Updating_existing_entities_2)]
+
+The context is now tracking all these entities as `Modified`:
+
+```output
+Blog {Id: 1} Modified
+  Id: 1 PK
+  Name: '.NET Blog' Modified
+  Posts: [{Id: 1}, {Id: 2}]
+Post {Id: 1} Modified
+  Id: 1 PK
+  BlogId: 1 FK Modified Originally <null>
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...' Modified
+  Title: 'Announcing the Release of EF Core 5.0' Modified
+  Blog: {Id: 1}
+Post {Id: 2} Modified
+  Id: 2 PK
+  BlogId: 1 FK Modified Originally <null>
+  Content: 'F# 5 is the latest version of F#, the functional programming...' Modified
+  Title: 'Announcing F# 5' Modified
+  Blog: {Id: 1}
+```
+
+Calling SaveChanges at this point will cause updates to be sent to the database for all these entities. For example, when using SQLite:
+
+```sql
+-- Executed DbCommand (0ms) [Parameters=[@p1='1' (DbType = String), @p0='.NET Blog' (Size = 9)], CommandType='Text', CommandTimeout='30']
+UPDATE "Blogs" SET "Name" = @p0
+WHERE "Id" = @p1;
+SELECT changes();
+
+-- Executed DbCommand (0ms) [Parameters=[@p3='1' (DbType = String), @p0='1' (DbType = String), @p1='Announcing the release of EF Core 5.0, a full featured cross-platform...' (Size = 72), @p2='Announcing the Release of EF Core 5.0' (Size = 37)], CommandType='Text', CommandTimeout='30']
+UPDATE "Posts" SET "BlogId" = @p0, "Content" = @p1, "Title" = @p2
+WHERE "Id" = @p3;
+SELECT changes();
+
+-- Executed DbCommand (0ms) [Parameters=[@p3='2' (DbType = String), @p0='1' (DbType = String), @p1='F# 5 is the latest version of F#, the functional programming language...' (Size = 72), @p2='Announcing F# 5' (Size = 15)], CommandType='Text', CommandTimeout='30']
+UPDATE "Posts" SET "BlogId" = @p0, "Content" = @p1, "Title" = @p2
+WHERE "Id" = @p3;
+SELECT changes();
+```
+
+### Generated key values
+
+As with `Attach`, generated key values have the same major benefit for `Update`: an unset key value indicates that the entity is new and has not yet been inserted into the database. As with `Attach`, this allows the DbContext to automatically detect new entities and put them in the `Added` state. For example, consider calling `Update` with this graph of a blog and posts:
+
+<!--
+            context.Update(
+                new Blog
+                {
+                    Id = 1,
+                    Name = ".NET Blog",
+                    Posts =
+                    {
+                        new Post
+                        {
+                            Id = 1,
+                            Title = "Announcing the Release of EF Core 5.0",
+                            Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                        },
+                        new Post
+                        {
+                            Id = 2,
+                            Title = "Announcing F# 5",
+                            Content = "F# 5 is the latest version of F#, the functional programming language..."
+                        }
+                    }
+                });
+-->
+[!code-csharp[Updating_existing_entities_3](../../../samples/core/ChangeTracking/ChangeTrackingInEFCore/GeneratedKeysSamples.cs?name=Updating_existing_entities_3)]
+
+As with the `Attach` example, the post with no key value is detected as new and set to the `Added` state. The other entities are marked as `Modified`:
+
+```output
+Blog {Id: 1} Modified
+  Id: 1 PK
+  Name: '.NET Blog' Modified
+  Posts: [{Id: 1}, {Id: 2}, {Id: -2147482633}]
+Post {Id: -2147482633} Added
+  Id: -2147482633 PK Temporary
+  BlogId: 1 FK
+  Content: '.NET 5.0 includes many enhancements, including single file a...'
+  Title: 'Announcing .NET 5.0'
+  Blog: {Id: 1}
+Post {Id: 1} Modified
+  Id: 1 PK
+  BlogId: 1 FK Modified Originally <null>
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...' Modified
+  Title: 'Announcing the Release of EF Core 5.0' Modified
+  Blog: {Id: 1}
+Post {Id: 2} Modified
+  Id: 2 PK
+  BlogId: 1 FK Modified Originally <null>
+  Content: 'F# 5 is the latest version of F#, the functional programming...' Modified
+  Title: 'Announcing F# 5' Modified
+  Blog: {Id: 1}
+```
+
+Calling `SaveChanges` at this point will cause updates to be sent to the database for all the existing entities, while the new entity is inserted. For example, when using SQLite:
+
+```sql
+-- Executed DbCommand (0ms) [Parameters=[@p1='1' (DbType = String), @p0='.NET Blog' (Size = 9)], CommandType='Text', CommandTimeout='30']
+UPDATE "Blogs" SET "Name" = @p0
+WHERE "Id" = @p1;
+SELECT changes();
+
+-- Executed DbCommand (0ms) [Parameters=[@p3='1' (DbType = String), @p0='1' (DbType = String), @p1='Announcing the release of EF Core 5.0, a full featured cross-platform...' (Size = 72), @p2='Announcing the Release of EF Core 5.0' (Size = 37)], CommandType='Text', CommandTimeout='30']
+UPDATE "Posts" SET "BlogId" = @p0, "Content" = @p1, "Title" = @p2
+WHERE "Id" = @p3;
+SELECT changes();
+
+-- Executed DbCommand (0ms) [Parameters=[@p3='2' (DbType = String), @p0='1' (DbType = String), @p1='F# 5 is the latest version of F#, the functional programming language...' (Size = 72), @p2='Announcing F# 5' (Size = 15)], CommandType='Text', CommandTimeout='30']
+UPDATE "Posts" SET "BlogId" = @p0, "Content" = @p1, "Title" = @p2
+WHERE "Id" = @p3;
+SELECT changes();
+
+-- Executed DbCommand (0ms) [Parameters=[@p0='1' (DbType = String), @p1='.NET 5.0 includes many enhancements, including single file applications, more...' (Size = 80), @p2='Announcing .NET 5.0' (Size = 19)], CommandType='Text', CommandTimeout='30']
+INSERT INTO "Posts" ("BlogId", "Content", "Title")
+VALUES (@p0, @p1, @p2);
+SELECT "Id"
+FROM "Posts"
+WHERE changes() = 1 AND "rowid" = last_insert_rowid();
+```
+
+This is a very easy way to generate updates and inserts from a disconnected graph. However, it results in updates or inserts being sent to the database for every property of every tracked entity, even when some property values may not have been changed. Don't be too scared by this; for many applications with small graphs, this can be an easy and pragmatic way of generating updates. That being said, other more complex patterns can sometimes result in more efficient updates, as described in [Identity Resolution in EF Core](xref:core/change-tracking/identity-resolution).
+
+## Deleting existing entities
+
+For an entity to be deleted by SaveChanges it must be tracked in the `Deleted` state. Entities are typically put in the `Deleted` state by calling one of <xref:Microsoft.EntityFrameworkCore.DbContext.Remove*?displayProperty=nameWithType>, <xref:Microsoft.EntityFrameworkCore.DbContext.RemoveRange*?displayProperty=nameWithType>, or the equivalent methods on <xref:Microsoft.EntityFrameworkCore.DbSet`1>. For example, to mark an existing post as `Deleted`:
+
+<!--
+            context.Remove(
+                new Post
+                {
+                    Id = 2
+                });
+-->
+[!code-csharp[Deleting_existing_entities_1](../../../samples/core/ChangeTracking/ChangeTrackingInEFCore/ExplicitKeysSamples.cs?name=Deleting_existing_entities_1)]
+
+Inspecting the [change tracker debug view](xref:core/change-tracking/debug-views) following this call shows that the context is tracking the entity in the `Deleted` state:
+
+```output
+Post {Id: 2} Deleted
+  Id: 2 PK
+  BlogId: <null> FK
+  Content: <null>
+  Title: <null>
+  Blog: <null>
+```
+
+This entity will be deleted when SaveChanges is called. For example, when using SQLite:
+
+```sql
+-- Executed DbCommand (0ms) [Parameters=[@p0='2' (DbType = String)], CommandType='Text', CommandTimeout='30']
+DELETE FROM "Posts"
+WHERE "Id" = @p0;
+SELECT changes();
+```
+
+After SaveChanges completes, the deleted entity is detached from the DbContext since it no longer exists in the database. The debug view is therefore empty because no entities are being tracked.
+
+## Deleting dependent/child entities
+
+Deleting dependent/child entities from a graph is more straightforward than deleting principal/parent entities. See the next section and [Changing Foreign Keys and Navigations](xref:core/change-tracking/relationship-changes) for more information.
+
+It is unusual to call `Remove` on an entity created with `new`. Further, unlike `Add`, `Attach` and `Update`, it is uncommon to call `Remove` on an entity that isn't already tracked in the `Unchanged` or `Modified` state. Instead it is typical to track a single entity or graph of related entities, and then call `Remove` on the entities that should be deleted. This graph of tracked entities is typically created by either:
+
+1. Running a query for the entities
+2. Using the `Attach` or `Update` methods on a graph of disconnected entities, as described in the preceding sections.
+
+For example, the code in the previous section is more likely to obtain a post from a client and then do something like this:
+
+<!--
+            context.Attach(post);
+            context.Remove(post);
+-->
+[!code-csharp[Deleting_dependent_child_entities_1](../../../samples/core/ChangeTracking/ChangeTrackingInEFCore/ExplicitKeysSamples.cs?name=Deleting_dependent_child_entities_1)]
+
+This behaves exactly the same way as the previous example, since calling `Remove` on an un-tracked entity causes it to first be attached and then marked as `Deleted`.
+
+In more realistic examples, a graph of entities is first attached, and then some of those entities are marked as deleted. For example:
+
+<!--
+            // Attach a blog and associated posts
+            context.Attach(blog);
+
+            // Mark one post as Deleted
+            context.Remove(blog.Posts[1]);
+-->
+[!code-csharp[Deleting_dependent_child_entities_2](../../../samples/core/ChangeTracking/ChangeTrackingInEFCore/ExplicitKeysSamples.cs?name=Deleting_dependent_child_entities_2)]
+
+All entities are marked as `Unchanged`, except the one on which `Remove` was called:
+
+```output
+Blog {Id: 1} Unchanged
+  Id: 1 PK
+  Name: '.NET Blog'
+  Posts: [{Id: 1}, {Id: 2}]
+Post {Id: 1} Unchanged
+  Id: 1 PK
+  BlogId: 1 FK
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...'
+  Title: 'Announcing the Release of EF Core 5.0'
+  Blog: {Id: 1}
+Post {Id: 2} Deleted
+  Id: 2 PK
+  BlogId: 1 FK
+  Content: 'F# 5 is the latest version of F#, the functional programming...'
+  Title: 'Announcing F# 5'
+  Blog: {Id: 1}
+```
+
+This entity will be deleted when SaveChanges is called. For example, when using SQLite:
+
+```sql
+-- Executed DbCommand (0ms) [Parameters=[@p0='2' (DbType = String)], CommandType='Text', CommandTimeout='30']
+DELETE FROM "Posts"
+WHERE "Id" = @p0;
+SELECT changes();
+```
+
+After SaveChanges completes, the deleted entity is detached from the DbContext since it no longer exists in the database. Other entities remain in the `Unchanged` state:
+
+```output
+Blog {Id: 1} Unchanged
+  Id: 1 PK
+  Name: '.NET Blog'
+  Posts: [{Id: 1}]
+Post {Id: 1} Unchanged
+  Id: 1 PK
+  BlogId: 1 FK
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...'
+  Title: 'Announcing the Release of EF Core 5.0'
+  Blog: {Id: 1}
+```
+
+## Deleting principal/parent entities
+
+Each relationship that connects two entity types has a principal or parent end, and a dependent or child end. The dependent/child entity is the one with the foreign key property. In a one-to-many relationship, the principal/parent is on the "one" side, and the dependent/child is on the "many" side. See [Relationships](xref:core/modeling/relationships) for more information.
+
+In the preceding examples we were deleting a post, which is a dependent/child entity in the blog-posts one-to-many relationship. This is relatively straightforward since removal of a dependent/child entity does not have any impact on other entities. On the other hand, deleting a principal/parent entity must also impact any dependent/child entities. Not doing so would leave a foreign key value referencing a primary key value that no longer exists. This is an invalid model state and results in a referential constraint error in most databases.
+
+This invalid model state can be handled in two ways:
+
+1. Setting FK values to null. This indicates that the dependents/children are no longer related to any principal/parent. This is the default for optional relationships where the foreign key must be nullable. Setting the FK to null is not valid for required relationships, where the foreign key is typically non-nullable.
+2. Deleting the dependents/children. This is the default for required relationships, and is also valid for optional relationships.
+
+See [Changing Foreign Keys and Navigations](xref:core/change-tracking/relationship-changes) for detailed information on change tracking and relationships.
+
+### Optional relationships
+
+The `Post.BlogId` foreign key property is nullable in the model we have been using. This means the relationship is optional, and hence the default behavior of EF Core is to set `BlogId` foreign key properties to null when the blog is deleted. For example:
+
+<!--
+            // Attach a blog and associated posts
+            context.Attach(blog);
+
+            // Mark one post as Deleted
+            context.Remove(blog.Posts[1]);
+-->
+[!code-csharp[Deleting_principal_parent_entities_1](../../../samples/core/ChangeTracking/ChangeTrackingInEFCore/ExplicitKeysSamples.cs?name=Deleting_principal_parent_entities_1)]
+
+Inspecting the [change tracker debug view](xref:core/change-tracking/debug-views) following the call to `Remove` shows that, as expected, the blog is now marked as `Deleted`:
+
+```output
+Blog {Id: 1} Deleted
+  Id: 1 PK
+  Name: '.NET Blog'
+  Posts: [{Id: 1}, {Id: 2}]
+Post {Id: 1} Modified
+  Id: 1 PK
+  BlogId: <null> FK Modified Originally 1
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...'
+  Title: 'Announcing the Release of EF Core 5.0'
+  Blog: <null>
+Post {Id: 2} Modified
+  Id: 2 PK
+  BlogId: <null> FK Modified Originally 1
+  Content: 'F# 5 is the latest version of F#, the functional programming...'
+  Title: 'Announcing F# 5'
+  Blog: <null>
+```
+
+More interestingly, all the related posts are now marked as `Modified`. This is because the foreign key property in each entity has been set to null. Calling SaveChanges updates the foreign key value for each post to null in the database, before then deleting the blog:
+
+```sql
+-- Executed DbCommand (0ms) [Parameters=[@p1='1' (DbType = String), @p0=NULL], CommandType='Text', CommandTimeout='30']
+UPDATE "Posts" SET "BlogId" = @p0
+WHERE "Id" = @p1;
+SELECT changes();
+
+-- Executed DbCommand (0ms) [Parameters=[@p1='2' (DbType = String), @p0=NULL], CommandType='Text', CommandTimeout='30']
+UPDATE "Posts" SET "BlogId" = @p0
+WHERE "Id" = @p1;
+SELECT changes();
+
+-- Executed DbCommand (0ms) [Parameters=[@p2='1' (DbType = String)], CommandType='Text', CommandTimeout='30']
+DELETE FROM "Blogs"
+WHERE "Id" = @p2;
+SELECT changes();
+```
+
+After SaveChanges completes, the deleted entity is detached from the DbContext since it no longer exists in the database. Other entities are now marked as `Unchanged` with null foreign key values, which matches the state of the database:
+
+```output
+Post {Id: 1} Unchanged
+  Id: 1 PK
+  BlogId: <null> FK
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...'
+  Title: 'Announcing the Release of EF Core 5.0'
+  Blog: <null>
+Post {Id: 2} Unchanged
+  Id: 2 PK
+  BlogId: <null> FK
+  Content: 'F# 5 is the latest version of F#, the functional programming...'
+  Title: 'Announcing F# 5'
+  Blog: <null>
+```
+
+### Required relationships
+
+If the `Post.BlogId` foreign key property is non-nullable, then the relationship between blogs and posts becomes "required". In this situation, EF Core will, by default, delete dependent/child entities when the principal/parent is deleted. For example, deleting a blog with related posts as in the previous example:
+
+<!--
+            // Attach a blog and associated posts
+            context.Attach(blog);
+
+            // Mark one post as Deleted
+            context.Remove(blog.Posts[1]);
+-->
+[!code-csharp[Deleting_principal_parent_entities_1](../../../samples/core/ChangeTracking/ChangeTrackingInEFCore/ExplicitKeysRequiredSamples.cs?name=Deleting_principal_parent_entities_1)]
+
+Inspecting the [change tracker debug view](xref:core/change-tracking/debug-views) following the call to `Remove` shows that, as expected, the blog is again marked as `Deleted`:
+
+```output
+Blog {Id: 1} Deleted
+  Id: 1 PK
+  Name: '.NET Blog'
+  Posts: [{Id: 1}, {Id: 2}]
+Post {Id: 1} Deleted
+  Id: 1 PK
+  BlogId: 1 FK
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...'
+  Title: 'Announcing the Release of EF Core 5.0'
+  Blog: {Id: 1}
+Post {Id: 2} Deleted
+  Id: 2 PK
+  BlogId: 1 FK
+  Content: 'F# 5 is the latest version of F#, the functional programming...'
+  Title: 'Announcing F# 5'
+  Blog: {Id: 1}
+```
+
+More interestingly in this case is that all related posts have also been marked as `Deleted`. Calling SaveChanges causes the blog and all related posts to be deleted from the database:
+
+```sql
+-- Executed DbCommand (0ms) [Parameters=[@p0='1' (DbType = String)], CommandType='Text', CommandTimeout='30']
+DELETE FROM "Posts"
+WHERE "Id" = @p0;
+SELECT changes();
+
+-- Executed DbCommand (0ms) [Parameters=[@p0='2' (DbType = String)], CommandType='Text', CommandTimeout='30']
+DELETE FROM "Posts"
+WHERE "Id" = @p0;
+SELECT changes();
+
+-- Executed DbCommand (0ms) [Parameters=[@p1='1' (DbType = String)], CommandType='Text', CommandTimeout='30']
+DELETE FROM "Blogs"
+WHERE "Id" = @p1;
+```
+
+After SaveChanges completes, all the deleted entities are detached from the DbContext since they no longer exist in the database. Output from the debug view is therefore empty.
+
+> [!NOTE]
+> This document only scratches the surface on working with relationships in EF Core. See [Relationships](xref:core/modeling/relationships) for more information on modeling relationships, and [Changing Foreign Keys and Navigations](xref:core/change-tracking/relationship-changes) for more information on updating/deleting dependent/child entities when calling SaveChanges.
+
+## Custom tracking with TrackGraph
+
+<xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.TrackGraph*?displayProperty=nameWithType> works like `Add`, `Attach` and `Update` except that it generates a callback for every entity instance before tracking it. This allows custom logic to be used when determining how to track individual entities in a graph.
+
+For example, consider the rule EF Core uses when tracking entities with generated key values: if the key value is zero, then the entity is new and should be inserted. Let's extend this rule to say if the key value is negative, then the entity should be deleted. This allows us to change the primary key values in entities of a disconnected graph to mark deleted entities:
+
+<!--
+            blog.Posts.Add(
+                new Post
+                {
+                    Title = "Announcing .NET 5.0",
+                    Content = ".NET 5.0 includes many enhancements, including single file applications, more..."
+                }
+            );
+
+            var toDelete = blog.Posts.Single(e => e.Title == "Announcing F# 5");
+            toDelete.Id = -toDelete.Id;
+-->
+[!code-csharp[Custom_tracking_with_TrackGraph_1a](../../../samples/core/ChangeTracking/ChangeTrackingInEFCore/GeneratedKeysSamples.cs?name=Custom_tracking_with_TrackGraph_1a)]
+
+This disconnected graph can then be tracked using TrackGraph:
+
+<!--
+        public static void UpdateBlog(Blog blog)
+        {
+            using var context = new BlogsContext();
+
+            context.ChangeTracker.TrackGraph(
+                blog, node =>
+                    {
+                        var propertyEntry = node.Entry.Property("Id");
+                        var keyValue = (int)propertyEntry.CurrentValue;
+
+                        if (keyValue == 0)
+                        {
+                            node.Entry.State = EntityState.Added;
+                        }
+                        else if (keyValue < 0)
+                        {
+                            propertyEntry.CurrentValue = -keyValue;
+                            node.Entry.State = EntityState.Deleted;
+                        }
+                        else
+                        {
+                            node.Entry.State = EntityState.Modified;
+                        }
+
+                        Console.WriteLine($"Tracking {node.Entry.Metadata.DisplayName()} with key value {keyValue} as {node.Entry.State}");
+
+                    });
+
+            context.SaveChanges();
+        }
+-->
+[!code-csharp[Custom_tracking_with_TrackGraph_1b](../../../samples/core/ChangeTracking/ChangeTrackingInEFCore/GeneratedKeysSamples.cs?name=Custom_tracking_with_TrackGraph_1b)]
+
+For each entity in the graph, the code above checks the primary key value _before tracking the entity_. For unset (zero) key values, the code does what EF Core would normally do. That is, if the key is not set, then the entity is marked as `Added`. If the key is set and the value is non-negative, then the entity is marked as `Modified`. However, if a negative key value is found, then its real, non-negative value is restored and the entity is tracked as `Deleted`.
+
+The output from running this code is:
+
+```output
+Tracking Blog with key value 1 as Modified
+Tracking Post with key value 1 as Modified
+Tracking Post with key value -2 as Deleted
+Tracking Post with key value 0 as Added
+```
+
+> [!NOTE]
+> For simplicity, this code assumes each entity has an integer primary key property called `Id`. This could be codified into an abstract base class or interface. Alternately, the primary key property or properties could be obtained from the <xref:Microsoft.EntityFrameworkCore.Metadata.IEntityType> metadata such that this code would work with any type of entity.
+
+TrackGraph has two overloads. In the simple overload used above, EF Core determines when to stop traversing the graph. Specifically, it stops visiting new related entities from a given entity when that entity is either already tracked, or when the callback does not start tracking the entity.
+
+The advanced overload, <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.TrackGraph%60`1(System.Object,%60%600,System.Func{Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntryGraphNode{%60%600},System.Boolean})?displayProperty=nameWithType>, has a callback that returns a bool. If the callback returns false, then graph traversal stops, otherwise it continues. Care must be taken to avoid infinite loops when using this overload.
+
+The advanced overload also allows state to be supplied to TrackGraph and this state is then passed to each callback.
diff --git a/entity-framework/core/change-tracking/identity-resolution.md b/entity-framework/core/change-tracking/identity-resolution.md
new file mode 100644
index 0000000000..c13c304174
--- /dev/null
+++ b/entity-framework/core/change-tracking/identity-resolution.md
@@ -0,0 +1,665 @@
+---
+title: Identity Resolution - EF Core
+description: Resolving multiple entity instances into a single instance using primary key values
+author: SamMonoRT
+ms.date: 12/30/2020
+uid: core/change-tracking/identity-resolution
+---
+
+# Identity Resolution in EF Core
+
+A <xref:Microsoft.EntityFrameworkCore.DbContext> can only track one entity instance with any given primary key value. This means multiple instances of an entity with the same key value must be resolved to a single instance. This is called "identity resolution". Identity resolution ensures Entity Framework Core (EF Core) is tracking a consistent graph with no ambiguities about the relationships or property values of the entities.
+
+> [!TIP]
+> This document assumes that entity states and the basics of EF Core change tracking are understood. See [Change Tracking in EF Core](xref:core/change-tracking/index) for more information on these topics.
+
+> [!TIP]
+> You can run and debug into all the code in this document by [downloading the sample code from GitHub](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/ChangeTracking/IdentityResolutionInEFCore).
+
+## Introduction
+
+The following code queries for an entity and then attempts to attach a different instance with the same primary key value:
+
+<!--
+            using var context = new BlogsContext();
+
+            var blogA = context.Blogs.Single(e => e.Id == 1);
+            var blogB = new Blog { Id = 1, Name = ".NET Blog (All new!)" };
+
+            try
+            {
+                context.Update(blogB); // This will throw
+            }
+            catch (Exception e)
+            {
+                Console.WriteLine(e);
+            }
+-->
+[!code-csharp[Identity_Resolution_in_EF_Core_1](../../../samples/core/ChangeTracking/IdentityResolutionInEFCore/IdentityResolutionSamples.cs?name=Identity_Resolution_in_EF_Core_1)]
+
+Running this code results in the following exception:
+
+> System.InvalidOperationException: The instance of entity type 'Blog' cannot be tracked because another instance with the key value '{Id: 1}' is already being tracked. When attaching existing entities, ensure that only one entity instance with a given key value is attached.
+
+EF Core requires a single instance because:
+
+- Property values may be different between multiple instances. When updating the database, EF Core needs to know which property values to use.
+- Relationships with other entities may be different between multiple instances. For example, "blogA" may be related to a different collection of posts than "blogB".
+
+The exception above is commonly encountered in these situations:
+
+- When attempting to update an entity
+- When attempting to track a serialized graph of entities
+- When failing to set a key value that is not automatically generated
+- When reusing a DbContext instance for multiple units-of-work
+
+Each of these situations is discussed in the following sections.
+
+## Updating an entity
+
+There are several different approaches to update an entity with new values, as covered in [Change Tracking in EF Core](xref:core/change-tracking/index) and [Explicitly Tracking Entities](xref:core/change-tracking/explicit-tracking). These approaches are outlined below in the context of identity resolution. An important point to notice is that each of the approaches use either a query or a call to one of `Update` or `Attach`, but **_never both_**.
+
+### Call Update
+
+Often the entity to update does not come from a query on the DbContext that we are going to use for SaveChanges. For example, in a web application, an entity instance may be created from the information in a POST request. The simplest way to handle this is to use <xref:Microsoft.EntityFrameworkCore.DbContext.Update*?displayProperty=nameWithType> or <xref:Microsoft.EntityFrameworkCore.DbSet`1.Update*?displayProperty=nameWithType>. For example:
+
+<!--
+    public static void UpdateFromHttpPost1(Blog blog)
+    {
+        using var context = new BlogsContext();
+
+        context.Update(blog);
+
+        context.SaveChanges();
+    }
+-->
+[!code-csharp[Updating_an_entity_1](../../../samples/core/ChangeTracking/IdentityResolutionInEFCore/IdentityResolutionSamples.cs?name=Updating_an_entity_1)]
+
+In this case:
+
+- Only a single instance of the entity is created.
+- The entity instance is **not** queried from the database as part of making the update.
+- All property values will be updated in the database, regardless of whether they have actually changed or not.
+- One database round-trip is made.
+
+### Query then apply changes
+
+Usually it is not known which property values have actually been changed when an entity is created from information in a POST request or similar. Often it is fine to just update all values in the database, as we did in the previous example. However, if the application is handling many entities and only a small number of those have actual changes, then it may be useful to limit the updates sent. This can be achieved by executing a query to track the entities as they currently exist in the database, and then applying changes to these tracked entities. For example:
+
+<!--
+    public static void UpdateFromHttpPost2(Blog blog)
+    {
+        using var context = new BlogsContext();
+
+        var trackedBlog = context.Blogs.Find(blog.Id);
+
+        trackedBlog.Name = blog.Name;
+        trackedBlog.Summary = blog.Summary;
+
+        context.SaveChanges();
+    }
+-->
+[!code-csharp[Updating_an_entity_2](../../../samples/core/ChangeTracking/IdentityResolutionInEFCore/IdentityResolutionSamples.cs?name=Updating_an_entity_2)]
+
+In this case:
+
+- Only a single instance of the entity is tracked; the one that is returned from the database by the `Find` query.
+- `Update`, `Attach`, etc. are **not** used.
+- Only property values that have actually changed are updated in the database.
+- Two database round-trips are made.
+
+EF Core has some helpers for transferring property values like this. For example, <xref:Microsoft.EntityFrameworkCore.ChangeTracking.PropertyValues.SetValues*?displayProperty=nameWithType> will copy all the values from the given object and set them on the tracked object:
+
+<!--
+    public static void UpdateFromHttpPost3(Blog blog)
+    {
+        using var context = new BlogsContext();
+
+        var trackedBlog = context.Blogs.Find(blog.Id);
+
+        context.Entry(trackedBlog).CurrentValues.SetValues(blog);
+
+        context.SaveChanges();
+    }
+-->
+[!code-csharp[Updating_an_entity_3](../../../samples/core/ChangeTracking/IdentityResolutionInEFCore/IdentityResolutionSamples.cs?name=Updating_an_entity_3)]
+
+`SetValues` accepts various object types, including data transfer objects (DTOs) with property names that match the properties of the entity type. For example:
+
+<!--
+    public static void UpdateFromHttpPost4(BlogDto dto)
+    {
+        using var context = new BlogsContext();
+
+        var trackedBlog = context.Blogs.Find(dto.Id);
+
+        context.Entry(trackedBlog).CurrentValues.SetValues(dto);
+
+        context.SaveChanges();
+    }
+-->
+[!code-csharp[Updating_an_entity_4](../../../samples/core/ChangeTracking/IdentityResolutionInEFCore/IdentityResolutionSamples.cs?name=Updating_an_entity_4)]
+
+Or a dictionary with name/value entries for the property values:
+
+<!--
+    public static void UpdateFromHttpPost5(Dictionary<string, object> propertyValues)
+    {
+        using var context = new BlogsContext();
+
+        var trackedBlog = context.Blogs.Find(propertyValues["Id"]);
+
+        context.Entry(trackedBlog).CurrentValues.SetValues(propertyValues);
+
+        context.SaveChanges();
+    }
+-->
+[!code-csharp[Updating_an_entity_5](../../../samples/core/ChangeTracking/IdentityResolutionInEFCore/IdentityResolutionSamples.cs?name=Updating_an_entity_5)]
+
+See [Accessing tracked entities](xref:core/change-tracking/entity-entries) for more information on working with property values like this.
+
+### Use original values
+
+So far each approach has either executed a query before making the update, or updated all property values regardless of whether or not they have changed. To update only values that have changed without querying as part of the update requires specific information about which property values have changed. A common way to get this information is to send back both the current and original values in the HTTP Post or similar. For example:
+
+<!--
+    public static void UpdateFromHttpPost6(Blog blog, Dictionary<string, object> originalValues)
+    {
+        using var context = new BlogsContext();
+
+        context.Attach(blog);
+        context.Entry(blog).OriginalValues.SetValues(originalValues);
+
+        context.SaveChanges();
+    }
+-->
+[!code-csharp[Updating_an_entity_6](../../../samples/core/ChangeTracking/IdentityResolutionInEFCore/IdentityResolutionSamples.cs?name=Updating_an_entity_6)]
+
+In this code the entity with modified values is first attached. This causes EF Core to track the entity in the `Unchanged` state; that is, with no property values marked as modified. The dictionary of original values is then applied to this tracked entity. This will mark as modified properties with different current and original values. Properties that have the same current and original values will not be marked as modified.
+
+In this case:
+
+- Only a single instance of the entity is tracked, using Attach.
+- The entity instance is **not** queried from the database as part of making the update.
+- Applying the original values ensures that only property values that have actually changed are updated in the database.
+- One database round-trip is made.
+
+As with the examples in the previous section, the original values do not have to be passed as a dictionary; an entity instance or DTO will also work.
+
+> [!TIP]
+> While this approach has appealing characteristics, it does require sending the entity's original values to and from the web client. Carefully consider whether this extra complexity is worth the benefits; for many applications one of the simpler approaches is more pragmatic.
+
+## Attaching a serialized graph
+
+EF Core works with graphs of entities connected via foreign keys and navigation properties, as described in [Changing Foreign Keys and Navigations](xref:core/change-tracking/relationship-changes). If these graphs are created outside of EF Core using, for example, from a JSON file, then they can have multiple instances of the same entity. These duplicates need to be resolved into single instances before the graph can be tracked.
+
+### Graphs with no duplicates
+
+Before going any further it is important to recognize that:
+
+- Serializers often have options for handling loops and duplicate instances in the graph.
+- The choice of object used as the graph root can often help reduce or remove duplicates.
+
+If possible, use serialization options and choose roots that do not result in duplicates. For example, the following code uses [Json.NET](https://www.nuget.org/packages/Newtonsoft.Json/) to serialize a list of blogs each with its associated posts:
+
+<!--
+            using var context = new BlogsContext();
+
+            var blogs = context.Blogs.Include(e => e.Posts).ToList();
+
+            var serialized = JsonConvert.SerializeObject(
+                blogs,
+                new JsonSerializerSettings
+                {
+                    ReferenceLoopHandling = ReferenceLoopHandling.Ignore,
+                    Formatting = Formatting.Indented
+                });
+
+            Console.WriteLine(serialized);
+-->
+[!code-csharp[Attaching_a_serialized_graph_1a](../../../samples/core/ChangeTracking/IdentityResolutionInEFCore/SerializedGraphExamples.cs?name=Attaching_a_serialized_graph_1a)]
+
+The JSON generated from this code is:
+
+```json
+[
+  {
+    "Id": 1,
+    "Name": ".NET Blog",
+    "Summary": "Posts about .NET",
+    "Posts": [
+      {
+        "Id": 1,
+        "Title": "Announcing the Release of EF Core 5.0",
+        "Content": "Announcing the release of EF Core 5.0, a full featured cross-platform...",
+        "BlogId": 1
+      },
+      {
+        "Id": 2,
+        "Title": "Announcing F# 5",
+        "Content": "F# 5 is the latest version of F#, the functional programming language...",
+        "BlogId": 1
+      }
+    ]
+  },
+  {
+    "Id": 2,
+    "Name": "Visual Studio Blog",
+    "Summary": "Posts about Visual Studio",
+    "Posts": [
+      {
+        "Id": 3,
+        "Title": "Disassembly improvements for optimized managed debugging",
+        "Content": "If you are focused on squeezing out the last bits of performance for your .NET service or...",
+        "BlogId": 2
+      },
+      {
+        "Id": 4,
+        "Title": "Database Profiling with Visual Studio",
+        "Content": "Examine when database queries were executed and measure how long the take using...",
+        "BlogId": 2
+      }
+    ]
+  }
+]
+```
+
+Notice that there are no duplicate blogs or posts in the JSON. This means that simple calls to `Update` will work to update these entities in the database:
+
+<!--
+        public static void UpdateBlogsFromJson(string json)
+        {
+            using var context = new BlogsContext();
+
+            var blogs = JsonConvert.DeserializeObject<List<Blog>>(json);
+
+            foreach (var blog in blogs)
+            {
+                context.Update(blog);
+            }
+
+            context.SaveChanges();
+        }
+-->
+[!code-csharp[Attaching_a_serialized_graph_1b](../../../samples/core/ChangeTracking/IdentityResolutionInEFCore/SerializedGraphExamples.cs?name=Attaching_a_serialized_graph_1b)]
+
+### Handling duplicates
+
+The code in the previous example serialized each blog with its associated posts. If this is changed to serialize each post with its associated blog, then duplicates are introduced into the serialized JSON. For example:
+
+<!--
+            using var context = new BlogsContext();
+
+            var posts = context.Posts.Include(e => e.Blog).ToList();
+
+            var serialized = JsonConvert.SerializeObject(
+                posts,
+                new JsonSerializerSettings
+                {
+                    ReferenceLoopHandling = ReferenceLoopHandling.Ignore,
+                    Formatting = Formatting.Indented
+                });
+
+            Console.WriteLine(serialized);
+-->
+[!code-csharp[Attaching_a_serialized_graph_2](../../../samples/core/ChangeTracking/IdentityResolutionInEFCore/SerializedGraphExamples.cs?name=Attaching_a_serialized_graph_2)]
+
+The serialized JSON now looks like this:
+
+```json
+[
+  {
+    "Id": 1,
+    "Title": "Announcing the Release of EF Core 5.0",
+    "Content": "Announcing the release of EF Core 5.0, a full featured cross-platform...",
+    "BlogId": 1,
+    "Blog": {
+      "Id": 1,
+      "Name": ".NET Blog",
+      "Summary": "Posts about .NET",
+      "Posts": [
+        {
+          "Id": 2,
+          "Title": "Announcing F# 5",
+          "Content": "F# 5 is the latest version of F#, the functional programming language...",
+          "BlogId": 1
+        }
+      ]
+    }
+  },
+  {
+    "Id": 2,
+    "Title": "Announcing F# 5",
+    "Content": "F# 5 is the latest version of F#, the functional programming language...",
+    "BlogId": 1,
+    "Blog": {
+      "Id": 1,
+      "Name": ".NET Blog",
+      "Summary": "Posts about .NET",
+      "Posts": [
+        {
+          "Id": 1,
+          "Title": "Announcing the Release of EF Core 5.0",
+          "Content": "Announcing the release of EF Core 5.0, a full featured cross-platform...",
+          "BlogId": 1
+        }
+      ]
+    }
+  },
+  {
+    "Id": 3,
+    "Title": "Disassembly improvements for optimized managed debugging",
+    "Content": "If you are focused on squeezing out the last bits of performance for your .NET service or...",
+    "BlogId": 2,
+    "Blog": {
+      "Id": 2,
+      "Name": "Visual Studio Blog",
+      "Summary": "Posts about Visual Studio",
+      "Posts": [
+        {
+          "Id": 4,
+          "Title": "Database Profiling with Visual Studio",
+          "Content": "Examine when database queries were executed and measure how long the take using...",
+          "BlogId": 2
+        }
+      ]
+    }
+  },
+  {
+    "Id": 4,
+    "Title": "Database Profiling with Visual Studio",
+    "Content": "Examine when database queries were executed and measure how long the take using...",
+    "BlogId": 2,
+    "Blog": {
+      "Id": 2,
+      "Name": "Visual Studio Blog",
+      "Summary": "Posts about Visual Studio",
+      "Posts": [
+        {
+          "Id": 3,
+          "Title": "Disassembly improvements for optimized managed debugging",
+          "Content": "If you are focused on squeezing out the last bits of performance for your .NET service or...",
+          "BlogId": 2
+        }
+      ]
+    }
+  }
+]
+```
+
+Notice that the graph now includes multiple Blog instances with the same key value, as well as multiple Post instances with the same key value. Attempting to track this graph like we did in the previous example will throw:
+
+> System.InvalidOperationException: The instance of entity type 'Post' cannot be tracked because another instance with the key value '{Id: 2}' is already being tracked. When attaching existing entities, ensure that only one entity instance with a given key value is attached.
+
+We can fix this in two ways:
+
+- Use JSON serialization options that preserve references
+- Perform identity resolution while the graph is being tracked
+
+#### Preserve references
+
+Json.NET provides the `PreserveReferencesHandling` option to handle this. For example:
+
+<!--
+            var serialized = JsonConvert.SerializeObject(
+                posts,
+                new JsonSerializerSettings
+                {
+                    PreserveReferencesHandling = PreserveReferencesHandling.All,
+                    Formatting = Formatting.Indented
+                });
+-->
+[!code-csharp[Attaching_a_serialized_graph_3](../../../samples/core/ChangeTracking/IdentityResolutionInEFCore/SerializedGraphExamples.cs?name=Attaching_a_serialized_graph_3)]
+
+The resulting JSON now looks like this:
+
+```json
+{
+  "$id": "1",
+  "$values": [
+    {
+      "$id": "2",
+      "Id": 1,
+      "Title": "Announcing the Release of EF Core 5.0",
+      "Content": "Announcing the release of EF Core 5.0, a full featured cross-platform...",
+      "BlogId": 1,
+      "Blog": {
+        "$id": "3",
+        "Id": 1,
+        "Name": ".NET Blog",
+        "Summary": "Posts about .NET",
+        "Posts": [
+          {
+            "$ref": "2"
+          },
+          {
+            "$id": "4",
+            "Id": 2,
+            "Title": "Announcing F# 5",
+            "Content": "F# 5 is the latest version of F#, the functional programming language...",
+            "BlogId": 1,
+            "Blog": {
+              "$ref": "3"
+            }
+          }
+        ]
+      }
+    },
+    {
+      "$ref": "4"
+    },
+    {
+      "$id": "5",
+      "Id": 3,
+      "Title": "Disassembly improvements for optimized managed debugging",
+      "Content": "If you are focused on squeezing out the last bits of performance for your .NET service or...",
+      "BlogId": 2,
+      "Blog": {
+        "$id": "6",
+        "Id": 2,
+        "Name": "Visual Studio Blog",
+        "Summary": "Posts about Visual Studio",
+        "Posts": [
+          {
+            "$ref": "5"
+          },
+          {
+            "$id": "7",
+            "Id": 4,
+            "Title": "Database Profiling with Visual Studio",
+            "Content": "Examine when database queries were executed and measure how long the take using...",
+            "BlogId": 2,
+            "Blog": {
+              "$ref": "6"
+            }
+          }
+        ]
+      }
+    },
+    {
+      "$ref": "7"
+    }
+  ]
+}
+```
+
+Notice that this JSON has replaced duplicates with references like `"$ref": "5"` that refer to the already existing instance in the graph. This graph can again be tracked using the simple calls to `Update`, as shown above.
+
+The <xref:System.Text.Json> support in the .NET base class libraries (BCL) has a similar option which produces the same result. For example:
+
+<!--
+            var serialized = System.Text.Json.JsonSerializer.Serialize(posts, new System.Text.Json.JsonSerializerOptions
+            {
+                ReferenceHandler = ReferenceHandler.Preserve,
+                WriteIndented = true
+            });
+-->
+[!code-csharp[Attaching_a_serialized_graph_4](../../../samples/core/ChangeTracking/IdentityResolutionInEFCore/SerializedGraphExamples.cs?name=Attaching_a_serialized_graph_4)]
+
+#### Resolve duplicates
+
+If it is not possible to eliminate duplicates in the serialization process, then <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.TrackGraph*?displayProperty=nameWithType> provides a way to handle this. TrackGraph works like `Add`, `Attach` and `Update` except that it generates a callback for every entity instance before tracking it. This callback can be used to either track the entity or ignore it. For example:
+
+<!--
+        public static void UpdatePostsFromJsonWithIdentityResolution(string json)
+        {
+            using var context = new BlogsContext();
+
+            var posts = JsonConvert.DeserializeObject<List<Post>>(json);
+
+            foreach (var post in posts)
+            {
+                context.ChangeTracker.TrackGraph(
+                    post, node =>
+                        {
+                            var keyValue = node.Entry.Property("Id").CurrentValue;
+                            var entityType = node.Entry.Metadata;
+
+                            var existingEntity = node.Entry.Context.ChangeTracker.Entries()
+                                .FirstOrDefault(
+                                    e => Equals(e.Metadata, entityType)
+                                         && Equals(e.Property("Id").CurrentValue, keyValue));
+
+                            if (existingEntity == null)
+                            {
+                                Console.WriteLine($"Tracking {entityType} entity with key value {keyValue}");
+
+                                node.Entry.State = EntityState.Modified;
+                            }
+                            else
+                            {
+                                Console.WriteLine($"Discarding duplicate {entityType} entity with key value {keyValue}");
+                            }
+                        });
+            }
+
+            context.SaveChanges();
+        }
+-->
+[!code-csharp[Attaching_a_serialized_graph_5](../../../samples/core/ChangeTracking/IdentityResolutionInEFCore/SerializedGraphExamples.cs?name=Attaching_a_serialized_graph_5)]
+
+For each entity in the graph, this code will:
+
+- Find the entity type and key value of the entity
+- Lookup the entity with this key in the change tracker
+  - If the entity is found, then no further action is taken as the entity is a duplicate
+  - If the entity is not found, then it is tracked by setting the state to `Modified`
+
+The output from running this code is:
+
+```output
+Tracking EntityType: Post entity with key value 1
+Tracking EntityType: Blog entity with key value 1
+Tracking EntityType: Post entity with key value 2
+Discarding duplicate EntityType: Post entity with key value 2
+Tracking EntityType: Post entity with key value 3
+Tracking EntityType: Blog entity with key value 2
+Tracking EntityType: Post entity with key value 4
+Discarding duplicate EntityType: Post entity with key value 4
+```
+
+> [!IMPORTANT]
+> This code **assumes that all duplicates are identical**. This makes it safe to arbitrarily choose one of the duplicates to track while discarding the others. If the duplicates can differ, then the code will need to decide how to determine which one to use, and how to combine property and navigation values together.
+
+> [!NOTE]
+> For simplicity, this code assumes each entity has a primary key property called `Id`. This could be codified into an abstract base class or interface. Alternately, the primary key property or properties could be obtained from the <xref:Microsoft.EntityFrameworkCore.Metadata.IEntityType> metadata such that this code would work with any type of entity.
+
+## Failing to set key values
+
+Entity types are often configured to use [automatically generated key values](xref:core/modeling/generated-properties). This is the default for integer and GUID properties of non-composite keys. However, if the entity type is not configured to use automatically generated key values, then an explicit key value must be set before tracking the entity. For example, using the following entity type:
+
+<!--
+    public class Pet
+    {
+        [DatabaseGenerated(DatabaseGeneratedOption.None)]
+        public int Id { get; set; }
+
+        public string Name { get; set; }
+    }
+-->
+[!code-csharp[Pet](../../../samples/core/ChangeTracking/IdentityResolutionInEFCore/IdentityResolutionSamples.cs?name=Pet)]
+
+Consider code that attempts to track two new entity instances without setting key values:
+
+<!--
+            using var context = new BlogsContext();
+
+            context.Add(new Pet { Name = "Smokey" });
+
+            try
+            {
+                context.Add(new Pet { Name = "Clippy" }); // This will throw
+            }
+            catch (Exception e)
+            {
+                Console.WriteLine(e);
+            }
+-->
+[!code-csharp[Failing_to_set_key_values_1](../../../samples/core/ChangeTracking/IdentityResolutionInEFCore/IdentityResolutionSamples.cs?name=Failing_to_set_key_values_1)]
+
+This code will throw:
+
+> System.InvalidOperationException: The instance of entity type 'Pet' cannot be tracked because another instance with the key value '{Id: 0}' is already being tracked. When attaching existing entities, ensure that only one entity instance with a given key value is attached.
+
+The fix for this is to either to set key values explicitly or configure the key property to use generated key values. See [Generated Values](xref:core/modeling/generated-properties) for more information.
+
+## Overusing a single DbContext instance
+
+<xref:Microsoft.EntityFrameworkCore.DbContext> is designed to represent a short-lived unit-of-work, as described in [DbContext Initialization and Configuration](xref:core/dbcontext-configuration/index), and elaborated on in [Change Tracking in EF Core](xref:core/change-tracking/index). Not following this guidance makes it easy to run into situations where an attempt is made to track multiple instances of the same entity. Common examples are:
+
+- Using the same DbContext instance to both set up test state and then execute the test. This often results in the DbContext still tracking one entity instance from test setup, while then attempting to attach a new instance in the test proper. Instead, use a different DbContext instance for setting up test state and the test code proper.
+- Using a shared DbContext instance in a repository or similar code. Instead, make sure your repository uses a single DbContext instance for each unit-of-work.
+
+## Identity resolution and queries
+
+Identity resolution happens automatically when entities are tracked from a query. This means that if an entity instance with a given key value is already tracked, then this existing tracked instance is used instead of creating a new instance. This has an important consequence: if the data has changed in the database, then this will not be reflected in the results of the query. This is a good reason to use a new DbContext instance for each unit-of-work, as described in [DbContext Initialization and Configuration](xref:core/dbcontext-configuration/index), and elaborated on in [Change Tracking in EF Core](xref:core/change-tracking/index).
+
+> [!IMPORTANT]
+> It is important to understand that EF Core always executes a LINQ query on a DbSet against the database and only returns results based on what is in the database. However, for a tracking query, if the entities returned are already tracked, then the tracked instances are used instead of creating instances from the data in the database.
+
+<xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry.Reload> or <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry.GetDatabaseValues> can be used when tracked entities need to be refreshed with the latest data from the database. See [Accessing Tracked Entities](xref:core/change-tracking/entity-entries) for more information.
+
+In contrast to tracking queries, no-tracking queries do not perform identity resolution. This means that no-tracking queries can return duplicates just like in the JSON serialization case described earlier. This is usually not an issue if the query results are going to be serialized and sent to the client.
+
+> [!TIP]
+> Do not routinely perform a no-tracking query and then attach the returned entities to the same context. This will be both slower and harder to get right than using a tracking query.
+
+No-tracking queries do not perform identity resolution because doing so impacts the performance of streaming a large number of entities from a query. This is because identity resolution requires keeping track of each instance returned so that it can be used instead of later creating a duplicate.
+
+No-tracking queries can be forced to perform identity resolution by using <xref:Microsoft.EntityFrameworkCore.EntityFrameworkQueryableExtensions.AsNoTrackingWithIdentityResolution%60`1(System.Linq.IQueryable{%60%600})>. The query will then keep track of returned instances (without tracking them in the normal way) and ensure no duplicates are created in the query results.
+
+## Overriding object equality
+
+EF Core uses [reference equality](/dotnet/csharp/programming-guide/statements-expressions-operators/equality-comparisons) when comparing entity instances. This is the case even if the entity types override <xref:System.Object.Equals(System.Object)?displayProperty=nameWithType> or otherwise change object equality. However, there is one place where overriding equality can impact EF Core behavior: when collection navigations use the overridden equality instead of reference equality, and hence report multiple instances as the same.
+
+Because of this it is recommended that overriding entity equality should be avoided. If it is used, then make sure to create collection navigations that force reference equality. For example, create an equality comparer that uses reference equality:
+
+<!--
+    public sealed class ReferenceEqualityComparer : IEqualityComparer<object>
+    {
+        private ReferenceEqualityComparer()
+        {
+        }
+
+        public static ReferenceEqualityComparer Instance { get; } = new ReferenceEqualityComparer();
+
+        bool IEqualityComparer<object>.Equals(object x, object y) => x == y;
+
+        int IEqualityComparer<object>.GetHashCode(object obj) => RuntimeHelpers.GetHashCode(obj);
+    }
+-->
+[!code-csharp[ReferenceEqualityComparer](../../../samples/core/ChangeTracking/IdentityResolutionInEFCore/ReferenceEqualityComparer.cs?name=ReferenceEqualityComparer)]
+
+(Starting with .NET 5, this is included in the BCL as <xref:System.Collections.Generic.ReferenceEqualityComparer>.)
+
+This comparer can then be used when creating collection navigations. For example:
+
+<!--
+        public ICollection<Order> Orders { get; set; }
+            = new HashSet<Order>(ReferenceEqualityComparer.Instance);
+-->
+[!code-csharp[OrdersCollection](../../../samples/core/ChangeTracking/IdentityResolutionInEFCore/IdentityResolutionSamples.cs?name=OrdersCollection)]
+
+### Comparing key properties
+
+In addition to equality comparisons, key values also need to be ordered. This is important for avoiding deadlocks when updating multiple entities in a single call to SaveChanges. All types used for primary, alternate, or foreign key properties, as well as those used for unique indexes, must implement <xref:System.IComparable`1> and <xref:System.IEquatable`1>. Types normally used as keys (int, Guid, string, etc.) already support these interfaces. Custom key types may add these interfaces.
diff --git a/entity-framework/core/change-tracking/index.md b/entity-framework/core/change-tracking/index.md
new file mode 100644
index 0000000000..b83a717308
--- /dev/null
+++ b/entity-framework/core/change-tracking/index.md
@@ -0,0 +1,268 @@
+---
+title: Change Tracking - EF Core
+description: Overview of change tracking for EF Core
+author: SamMonoRT
+ms.date: 12/30/2020
+uid: core/change-tracking/index
+---
+
+# Change Tracking in EF Core
+
+Each <xref:Microsoft.EntityFrameworkCore.DbContext> instance tracks changes made to entities. These tracked entities in turn drive the changes to the database when <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*> is called.
+
+This document presents an overview of Entity Framework Core (EF Core) change tracking and how it relates to queries and updates.
+
+> [!TIP]
+> You can run and debug into all the code in this document by [downloading the sample code from GitHub](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/ChangeTracking/ChangeTrackingInEFCore).
+
+## How to track entities
+
+Entity instances become tracked when they are:
+
+- Returned from a query executed against the database
+- Explicitly attached to the DbContext by `Add`, `Attach`, `Update`, or similar methods
+- Detected as new entities connected to existing tracked entities
+
+Entity instances are no longer tracked when:
+
+- The DbContext is disposed
+- The change tracker is cleared
+- The entities are explicitly detached
+
+DbContext is designed to represent a short-lived unit-of-work, as described in [DbContext Initialization and Configuration](xref:core/dbcontext-configuration/index). This means that disposing the DbContext is _the normal way_ to stop tracking entities. In other words, the lifetime of a DbContext should be:
+
+1. Create the DbContext instance
+2. Track some entities
+3. Make some changes to the entities
+4. Call SaveChanges to update the database
+5. Dispose the DbContext instance
+
+> [!TIP]
+> It is not necessary to clear the change tracker or explicitly detach entity instances when taking this approach. However, if you do need to detach entities, then calling <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.Clear*?displayProperty=nameWithType> is more efficient than detaching entities one-by-one.
+
+## Entity states
+
+Every entity is associated with a given <xref:Microsoft.EntityFrameworkCore.EntityState>:
+
+- `Detached` entities are not being tracked by the <xref:Microsoft.EntityFrameworkCore.DbContext>.
+- `Added` entities are new and have not yet been inserted into the database. This means they will be inserted when <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*> is called.
+- `Unchanged` entities have _not_ been changed since they were queried from the database. All entities returned from queries are initially in this state.
+- `Modified` entities have been changed since they were queried from the database. This means they will be updated when SaveChanges is called.
+- `Deleted` entities exist in the database, but are marked to be deleted when SaveChanges is called.
+
+EF Core tracks changes at the property level. For example, if only a single property value is modified, then a database update will change only that value. However, properties can only be marked as modified when the entity itself is in the Modified state. (Or, from an alternate perspective, the Modified state means that at least one property value has been marked as modified.)
+
+The following table summarizes the different states:
+
+| Entity state     | Tracked by DbContext | Exists in database | Properties modified | Action on SaveChanges
+|:-----------------|----------------------|--------------------|---------------------|-----------------------
+| `Detached`       | No                   | -                  | -                   | -
+| `Added`          | Yes                  | No                 | -                   | Insert
+| `Unchanged`      | Yes                  | Yes                | No                  | -
+| `Modified`       | Yes                  | Yes                | Yes                 | Update
+| `Deleted`        | Yes                  | Yes                | -                   | Delete
+
+> [!NOTE]
+> This text uses relational database terms for clarity. NoSQL databases typically support similar operations but possibly with different names. Consult your database provider documentation for more information.
+
+## Tracking from queries
+
+EF Core change tracking works best when the same <xref:Microsoft.EntityFrameworkCore.DbContext> instance is used to both query for entities and update them by calling <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*>. This is because EF Core automatically tracks the state of queried entities and then detects any changes made to these entities when SaveChanges is called.
+
+This approach has several advantages over [explicitly tracking entity instances](xref:core/change-tracking/explicit-tracking):
+
+- It is simple. Entity states rarely need to be manipulated explicitly--EF Core takes care of state changes.
+- Updates are limited to only those values that have actually changed.
+- The values of [shadow properties](xref:core/modeling/shadow-properties) are preserved and used as needed. This is especially relevant when foreign keys are stored in shadow state.
+- The original values of properties are preserved automatically and used for efficient updates.
+
+## Simple query and update
+
+For example, consider a simple blog/posts model:
+
+<!--
+public class Blog
+{
+    public int Id { get; set; }
+
+    public string Name { get; set; }
+
+    public ICollection<Post> Posts { get; } = new List<Post>();
+}
+
+public class Post
+{
+    public int Id { get; set; }
+
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int? BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
+-->
+[!code-csharp[Model](../../../samples/core/ChangeTracking/ChangeTrackingInEFCore/GeneratedKeysSamples.cs?name=Model)]
+
+We can use this model to query for blogs and posts and then make some updates to the database:
+
+<!--
+            using var context = new BlogsContext();
+
+            var blog = context.Blogs.Include(e => e.Posts).First(e => e.Name == ".NET Blog");
+
+            blog.Name = ".NET Blog (Updated!)";
+
+            foreach (var post in blog.Posts.Where(e => !e.Title.Contains("5.0")))
+            {
+                post.Title = post.Title.Replace("5", "5.0");
+            }
+
+            context.SaveChanges();
+-->
+[!code-csharp[Simple_query_and_update_1](../../../samples/core/ChangeTracking/ChangeTrackingInEFCore/GeneratedKeysSamples.cs?name=Simple_query_and_update_1)]
+
+Calling SaveChanges results in the following database updates, using SQLite as an example database:
+
+```sql
+-- Executed DbCommand (0ms) [Parameters=[@p1='1' (DbType = String), @p0='.NET Blog (Updated!)' (Size = 20)], CommandType='Text', CommandTimeout='30']
+UPDATE "Blogs" SET "Name" = @p0
+WHERE "Id" = @p1;
+SELECT changes();
+
+-- Executed DbCommand (0ms) [Parameters=[@p1='2' (DbType = String), @p0='Announcing F# 5.0' (Size = 17)], CommandType='Text', CommandTimeout='30']
+UPDATE "Posts" SET "Title" = @p0
+WHERE "Id" = @p1;
+SELECT changes();
+```
+
+The [change tracker debug view](xref:core/change-tracking/debug-views) is a great way to visualize which entities are being tracked and what their states are. For example, inserting the following code into the sample above before calling SaveChanges:
+
+<!--
+                context.ChangeTracker.DetectChanges();
+                Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+-->
+[!code-csharp[Simple_query_and_update_2](../../../samples/core/ChangeTracking/ChangeTrackingInEFCore/GeneratedKeysSamples.cs?name=Simple_query_and_update_2)]
+
+Generates the following output:
+
+```output
+Blog {Id: 1} Modified
+  Id: 1 PK
+  Name: '.NET Blog (Updated!)' Modified Originally '.NET Blog'
+  Posts: [{Id: 1}, {Id: 2}, {Id: 3}]
+Post {Id: 1} Unchanged
+  Id: 1 PK
+  BlogId: 1 FK
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...'
+  Title: 'Announcing the Release of EF Core 5.0'
+  Blog: {Id: 1}
+Post {Id: 2} Modified
+  Id: 2 PK
+  BlogId: 1 FK
+  Content: 'F# 5 is the latest version of F#, the functional programming...'
+  Title: 'Announcing F# 5.0' Modified Originally 'Announcing F# 5'
+  Blog: {Id: 1}
+```
+
+Notice specifically:
+
+- The `Blog.Name` property is marked as modified (`Name: '.NET Blog (Updated!)' Modified Originally '.NET Blog'`), and this results in the blog being in the `Modified` state.
+- The `Post.Title` property of post 2 is marked as modified (`Title: 'Announcing F# 5.0' Modified Originally 'Announcing F# 5'`), and this results in this post being in the `Modified` state.
+- The other property values of post 2 have not changed and are therefore not marked as modified. This is why these values are not included in the database update.
+- The other post was not modified in any way. This is why it is still in the `Unchanged` state and is not included in the database update.
+
+## Query then insert, update, and delete
+
+Updates like those in the previous example can be combined with inserts and deletes in the same unit-of-work. For example:
+
+<!--
+            using var context = new BlogsContext();
+
+            var blog = context.Blogs.Include(e => e.Posts).First(e => e.Name == ".NET Blog");
+
+            // Modify property values
+            blog.Name = ".NET Blog (Updated!)";
+
+            // Insert a new Post
+            blog.Posts.Add(new Post
+            {
+                Title = "What’s next for System.Text.Json?",
+                Content = ".NET 5.0 was released recently and has come with many..."
+            });
+
+            // Mark an existing Post as Deleted
+            var postToDelete = blog.Posts.Single(e => e.Title == "Announcing F# 5");
+            context.Remove(postToDelete);
+
+            context.ChangeTracker.DetectChanges();
+            Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+            context.SaveChanges();
+-->
+[!code-csharp[Query_then_insert_update_and_delete_1](../../../samples/core/ChangeTracking/ChangeTrackingInEFCore/GeneratedKeysSamples.cs?name=Query_then_insert_update_and_delete_1)]
+
+In this example:
+
+- A blog and related posts are queried from the database and tracked
+- The `Blog.Name` property is changed
+- A new post is added to the collection of existing posts for the blog
+- An existing post is marked for deletion by calling <xref:Microsoft.EntityFrameworkCore.DbContext.Remove*?displayProperty=nameWithType>
+
+Looking again at the [change tracker debug view](xref:core/change-tracking/debug-views) before calling SaveChanges shows how EF Core is tracking these changes:
+
+```output
+Blog {Id: 1} Modified
+  Id: 1 PK
+  Name: '.NET Blog (Updated!)' Modified Originally '.NET Blog'
+  Posts: [{Id: 1}, {Id: 2}, {Id: 3}, {Id: -2147482638}]
+Post {Id: -2147482638} Added
+  Id: -2147482638 PK Temporary
+  BlogId: 1 FK
+  Content: '.NET 5.0 was released recently and has come with many...'
+  Title: 'What's next for System.Text.Json?'
+  Blog: {Id: 1}
+Post {Id: 1} Unchanged
+  Id: 1 PK
+  BlogId: 1 FK
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...'
+  Title: 'Announcing the Release of EF Core 5.0'
+  Blog: {Id: 1}
+Post {Id: 2} Deleted
+  Id: 2 PK
+  BlogId: 1 FK
+  Content: 'F# 5 is the latest version of F#, the functional programming...'
+  Title: 'Announcing F# 5'
+  Blog: {Id: 1}
+```
+
+Notice that:
+
+- The blog is marked as `Modified`. This will generate a database update.
+- Post 2 is marked as `Deleted`. This will generate a database delete.
+- A new post with a temporary ID is associated with blog 1 and is marked as `Added`. This will generate a database insert.
+
+This results in the following database commands (using SQLite) when SaveChanges is called:
+
+```sql
+-- Executed DbCommand (0ms) [Parameters=[@p1='1' (DbType = String), @p0='.NET Blog (Updated!)' (Size = 20)], CommandType='Text', CommandTimeout='30']
+UPDATE "Blogs" SET "Name" = @p0
+WHERE "Id" = @p1;
+SELECT changes();
+
+-- Executed DbCommand (0ms) [Parameters=[@p0='2' (DbType = String)], CommandType='Text', CommandTimeout='30']
+DELETE FROM "Posts"
+WHERE "Id" = @p0;
+SELECT changes();
+
+-- Executed DbCommand (0ms) [Parameters=[@p0='1' (DbType = String), @p1='.NET 5.0 was released recently and has come with many...' (Size = 56), @p2='What's next for System.Text.Json?' (Size = 33)], CommandType='Text', CommandTimeout='30']
+INSERT INTO "Posts" ("BlogId", "Content", "Title")
+VALUES (@p0, @p1, @p2);
+SELECT "Id"
+FROM "Posts"
+WHERE changes() = 1 AND "rowid" = last_insert_rowid();
+```
+
+See [Explicitly Tracking Entities](xref:core/change-tracking/explicit-tracking) for more information on inserting and deleting entities. See [Change Detection and Notifications](xref:core/change-tracking/change-detection) for more information on how EF Core automatically detects changes like this.
+
+> [!TIP]
+> Call <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.HasChanges?displayProperty=nameWithType> to determine whether any changes have been made that will cause SaveChanges to make updates to the database. If HasChanges return false, then SaveChanges will be a no-op.
diff --git a/entity-framework/core/change-tracking/miscellaneous.md b/entity-framework/core/change-tracking/miscellaneous.md
new file mode 100644
index 0000000000..25289c34f7
--- /dev/null
+++ b/entity-framework/core/change-tracking/miscellaneous.md
@@ -0,0 +1,506 @@
+---
+title: Additional Change Tracking Features - EF Core
+description: Miscellaneous features and scenarios involving EF Core change tracking
+author: SamMonoRT
+ms.date: 11/15/2021
+uid: core/change-tracking/miscellaneous
+---
+
+# Additional Change Tracking Features
+
+This document covers miscellaneous features and scenarios involving change tracking.
+
+> [!TIP]
+> This document assumes that entity states and the basics of EF Core change tracking are understood. See [Change Tracking in EF Core](xref:core/change-tracking/index) for more information on these topics.
+
+> [!TIP]
+> You can run and debug into all the code in this document by [downloading the sample code from GitHub](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/ChangeTracking/AdditionalChangeTrackingFeatures).
+
+## `Add` versus `AddAsync`
+
+Entity Framework Core (EF Core) provides async methods whenever using that method may result in a database interaction. Synchronous methods are also provided to avoid overhead when using databases that do not support high performance asynchronous access.
+
+<xref:Microsoft.EntityFrameworkCore.DbContext.Add*?displayProperty=nameWithType> and <xref:Microsoft.EntityFrameworkCore.DbSet`1.Add*?displayProperty=nameWithType> do not normally access the database, since these methods inherently just start tracking entities. However, some forms of value generation _may_ access the database in order to generate a key value. The only value generator that does this and ships with EF Core is <xref:Microsoft.EntityFrameworkCore.ValueGeneration.HiLoValueGenerator`1>. Using this generator is uncommon; it is never configured by default. This means that the vast majority of applications should use `Add`, and not `AddAsync`.
+
+Other similar methods like `Update`, `Attach`, and `Remove` do not have async overloads because they never generate new key values, and hence never need to access the database.
+
+## `AddRange`, `UpdateRange`, `AttachRange`, and `RemoveRange`
+
+<xref:Microsoft.EntityFrameworkCore.DbSet`1> and <xref:Microsoft.EntityFrameworkCore.DbContext> provide alternate versions of `Add`, `Update`, `Attach`, and `Remove` that accept multiple instances in a single call. These methods are <xref:Microsoft.EntityFrameworkCore.DbSet`1.AddRange*>, <xref:Microsoft.EntityFrameworkCore.DbSet`1.UpdateRange*>, <xref:Microsoft.EntityFrameworkCore.DbSet`1.AttachRange*>, and <xref:Microsoft.EntityFrameworkCore.DbSet`1.RemoveRange*> respectively.
+
+These methods are provided as a convenience. Using a "range" method has the same functionality as multiple calls to the equivalent non-range method. There is no significant performance difference between the two approaches.
+
+> [!NOTE]
+> This is different from EF6, where `AddRange` and `Add` both automatically called `DetectChanges`, but calling `Add` multiple times caused DetectChanges to be called multiple times instead of once. This made `AddRange` more efficient in EF6. In EF Core, neither of these methods automatically call `DetectChanges`.
+
+## DbContext versus DbSet methods
+
+Many methods, including `Add`, `Update`, `Attach`, and `Remove`, have implementations on both <xref:Microsoft.EntityFrameworkCore.DbSet`1> and <xref:Microsoft.EntityFrameworkCore.DbContext>. These methods have _exactly the same behavior_ for normal entity types. This is because the CLR type of the entity is mapped onto one and only one entity type in the EF Core model. Therefore, the CLR type fully defines where the entity fits in the model, and so the DbSet to use can be determined implicitly.
+
+The exception to this rule is when using shared-type entity types, which are primarily used for many-to-many join entities. When using a shared-type entity type, a DbSet must first be created for the EF Core model type that is being used. Methods like `Add`, `Update`, `Attach`, and `Remove` can then be used on the DbSet without any ambiguity as to which EF Core model type is being used.
+
+Shared-type entity types are used by default for the join entities in many-to-many relationships. A shared-type entity type can also be explicitly configured for use in a many-to-many relationship. For example, the code below configures `Dictionary<string, int>` as a join entity type:
+
+<!--
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder
+                .SharedTypeEntity<Dictionary<string, int>>(
+                    "PostTag",
+                    b =>
+                        {
+                            b.IndexerProperty<int>("TagId");
+                            b.IndexerProperty<int>("PostId");
+                        });
+
+            modelBuilder.Entity<Post>()
+                .HasMany(p => p.Tags)
+                .WithMany(p => p.Posts)
+                .UsingEntity<Dictionary<string, int>>(
+                    "PostTag",
+                    j => j.HasOne<Tag>().WithMany(),
+                    j => j.HasOne<Post>().WithMany());
+        }
+-->
+[!code-csharp[OnModelCreating](../../../samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/Samples.cs?name=OnModelCreating)]
+
+[Changing Foreign Keys and Navigations](xref:core/change-tracking/relationship-changes) shows how to associate two entities by tracking a new join entity instance. The code below does this for the `Dictionary<string, int>` shared-type entity type used for the join entity:
+
+<!--
+            using var context = new BlogsContext();
+
+            var post = context.Posts.Single(e => e.Id == 3);
+            var tag = context.Tags.Single(e => e.Id == 1);
+
+            var joinEntitySet = context.Set<Dictionary<string, int>>("PostTag");
+            var joinEntity = new Dictionary<string, int>
+            {
+                ["PostId"] = post.Id,
+                ["TagId"] = tag.Id
+            };
+            joinEntitySet.Add(joinEntity);
+
+            Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+            context.SaveChanges();
+-->
+[!code-csharp[DbContext_versus_DbSet_methods_1](../../../samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/Samples.cs?name=DbContext_versus_DbSet_methods_1)]
+
+Notice that <xref:Microsoft.EntityFrameworkCore.DbContext.Set%60`1(System.String)?displayProperty=nameWithType> is used to create a DbSet for the `PostTag` entity type. This DbSet can then be used to call `Add` with the new join entity instance.
+
+> [!IMPORTANT]
+> The CLR type used for join entity types by convention may change in future releases to improve performance. Do not depend on any specific join entity type unless it has been explicitly configured as is done for `Dictionary<string, int>` in the code above.
+
+## Property versus field access
+
+Access to entity properties uses the backing field of the property by default. This is efficient and avoids triggering side effects from calling property getters and setters. For example, this is how lazy-loading is able to avoid triggering infinite loops. See [Backing Fields](xref:core/modeling/backing-field) for more information on configuring backing fields in the model.
+
+Sometimes it may be desirable for EF Core to generate side-effects when it modifies property values. For example, when data binding to entities, setting a property may generate notifications to the U.I. which do not happen when setting the field directly. This can be achieved by changing the <xref:Microsoft.EntityFrameworkCore.PropertyAccessMode> for:
+
+- All entity types in the model using <xref:Microsoft.EntityFrameworkCore.ModelBuilder.UsePropertyAccessMode*?displayProperty=nameWithType>
+- All properties and navigations of a specific entity type using <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.EntityTypeBuilder`1.UsePropertyAccessMode*?displayProperty=nameWithType>
+- A specific property using <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder.UsePropertyAccessMode*?displayProperty=nameWithType>
+- A specific navigation using <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.NavigationBuilder.UsePropertyAccessMode*?displayProperty=nameWithType>
+
+Property access modes `Field` and `PreferField` will cause EF Core to access the property value through its backing field. Likewise, `Property` and `PreferProperty` will cause EF Core to access the property value through its getter and setter.
+
+If `Field` or `Property` are used and EF Core cannot access the value through the field or property getter/setter respectively, then EF Core will throw an exception. This ensures EF Core is always using field/property access when you think it is.
+
+On the other hand, the `PreferField` and `PreferProperty` modes will fall back to using the property or backing field respectively if it is not possible to use the preferred access. `PreferField` is the default. This means EF Core will use fields whenever it can, but will not fail if a property must be accessed through its getter or setter instead.
+
+`FieldDuringConstruction` and `PreferFieldDuringConstruction` configure EF Core to use of backing fields _only when creating entity instances_. This allows queries to be executed without getter and setter side effects, while later property changes by EF Core will cause these side effects.
+
+The different property access modes are summarized in the following table:
+
+| PropertyAccessMode              | Preference | Preference creating entities | Fallback | Fallback creating entities
+|:--------------------------------|------------|------------------------------|----------|---------------------------
+| `Field`                         | Field      | Field                        | Throws   | Throws
+| `Property`                      | Property   | Property                     | Throws   | Throws
+| `PreferField`                   | Field      | Field                        | Property | Property
+| `PreferProperty`                | Property   | Property                     | Field    | Field
+| `FieldDuringConstruction`       | Property   | Field                        | Field    | Throws
+| `PreferFieldDuringConstruction` | Property   | Field                        | Field    | Property
+
+## Temporary values
+
+EF Core creates temporary key values when tracking new entities that will have real key values generated by the database when SaveChanges is called. See [Change Tracking in EF Core](xref:core/change-tracking/index) for an overview of how these temporary values are used.
+
+### Accessing temporary values
+
+Temporary values are stored in the change tracker and not set onto entity instances directly. However, these temporary values _are_ exposed when using the various mechanisms for [Accessing Tracked Entities](xref:core/change-tracking/entity-entries). For example, the following code accesses a temporary value using <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry.CurrentValues*?displayProperty=nameWithType>:
+
+<!--
+        using var context = new BlogsContext();
+
+        var blog = new Blog { Name = ".NET Blog" };
+
+        context.Add(blog);
+
+        Console.WriteLine($"Blog.Id set on entity is {blog.Id}");
+        Console.WriteLine($"Blog.Id tracked by EF is {context.Entry(blog).Property(e => e.Id).CurrentValue}");
+-->
+[!code-csharp[Temporary_values_1](../../../samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/Samples.cs?name=Temporary_values_1)]
+
+The output from this code is:
+
+```output
+Blog.Id set on entity is 0
+Blog.Id tracked by EF is -2147482643
+```
+
+<xref:Microsoft.EntityFrameworkCore.ChangeTracking.PropertyEntry.IsTemporary*?displayProperty=nameWithType> can be used to check for temporary values.
+
+### Manipulating temporary values
+
+It is sometimes useful to explicitly work with temporary values. For example, a collection of new entities might be created on a web client and then serialized back to the server. Foreign key values are one way to set up relationships between these entities. The following code uses this approach to associate a graph of new entities by foreign key, while still allowing real key values to be generated when SaveChanges is called.
+
+<!--
+            var blogs = new List<Blog>
+            {
+                new Blog { Id = -1, Name = ".NET Blog" },
+                new Blog { Id = -2, Name = "Visual Studio Blog" }
+            };
+
+            var posts = new List<Post>()
+            {
+                new Post
+                {
+                    Id = -1,
+                    BlogId = -1,
+                    Title = "Announcing the Release of EF Core 5.0",
+                    Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                },
+                new Post
+                {
+                    Id = -2,
+                    BlogId = -2,
+                    Title = "Disassembly improvements for optimized managed debugging",
+                    Content = "If you are focused on squeezing out the last bits of performance for your .NET service or..."
+                }
+            };
+
+            using var context = new BlogsContext();
+
+            foreach (var blog in blogs)
+            {
+                context.Add(blog).Property(e => e.Id).IsTemporary = true;
+            }
+
+            foreach (var post in posts)
+            {
+                context.Add(post).Property(e => e.Id).IsTemporary = true;
+            }
+
+            Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+            context.SaveChanges();
+
+            Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+-->
+[!code-csharp[Temporary_values_2](../../../samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/Samples.cs?name=Temporary_values_2)]
+
+Notice that:
+
+- Negative numbers are used as temporary key values; this is not required, but is a common convention to prevent key clashes.
+- The `Post.BlogId` FK property is assigned the same negative value as the PK of the associated blog.
+- The PK values are marked as temporary by setting <xref:Microsoft.EntityFrameworkCore.ChangeTracking.PropertyEntry.IsTemporary*> after each entity is tracked. This is necessary because any key value supplied by the application is assumed to be a real key value.
+
+Looking at the [change tracker debug view](xref:core/change-tracking/debug-views) before calling SaveChanges shows that the PK values are marked as temporary and posts are associated with the correct blogs, including fixup of navigations:
+
+```output
+Blog {Id: -2} Added
+  Id: -2 PK Temporary
+  Name: 'Visual Studio Blog'
+  Posts: [{Id: -2}]
+Blog {Id: -1} Added
+  Id: -1 PK Temporary
+  Name: '.NET Blog'
+  Posts: [{Id: -1}]
+Post {Id: -2} Added
+  Id: -2 PK Temporary
+  BlogId: -2 FK
+  Content: 'If you are focused on squeezing out the last bits of perform...'
+  Title: 'Disassembly improvements for optimized managed debugging'
+  Blog: {Id: -2}
+  Tags: []
+Post {Id: -1} Added
+  Id: -1 PK Temporary
+  BlogId: -1 FK
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...'
+  Title: 'Announcing the Release of EF Core 5.0'
+  Blog: {Id: -1}
+```
+
+After calling <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*>, these temporary values have been replaced by real values generated by the database:
+
+```output
+Blog {Id: 1} Unchanged
+  Id: 1 PK
+  Name: '.NET Blog'
+  Posts: [{Id: 1}]
+Blog {Id: 2} Unchanged
+  Id: 2 PK
+  Name: 'Visual Studio Blog'
+  Posts: [{Id: 2}]
+Post {Id: 1} Unchanged
+  Id: 1 PK
+  BlogId: 1 FK
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...'
+  Title: 'Announcing the Release of EF Core 5.0'
+  Blog: {Id: 1}
+  Tags: []
+Post {Id: 2} Unchanged
+  Id: 2 PK
+  BlogId: 2 FK
+  Content: 'If you are focused on squeezing out the last bits of perform...'
+  Title: 'Disassembly improvements for optimized managed debugging'
+  Blog: {Id: 2}
+  Tags: []
+```
+
+## Working with default values
+
+EF Core allows a property to get its default value from the database when <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*> is called. Like with generated key values, EF Core will only use a default from the database if no value has been explicitly set. For example, consider the following entity type:
+
+<!--
+    public class Token
+    {
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public DateTime ValidFrom { get; set; }
+    }
+-->
+[!code-csharp[Token](../../../samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/DefaultValueSamples.cs?name=Token)]
+
+The `ValidFrom` property is configured to get a default value from the database:
+
+<!--
+        modelBuilder
+            .Entity<Token>()
+            .Property(e => e.ValidFrom)
+            .HasDefaultValueSql("CURRENT_TIMESTAMP");
+-->
+[!code-csharp[OnModelCreating_Token](../../../samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/DefaultValueSamples.cs?name=OnModelCreating_Token)]
+
+When inserting an entity of this type, EF Core will let the database generate the value unless an explicit value has been set instead. For example:
+
+<!--
+            using var context = new BlogsContext();
+
+            context.AddRange(
+                new Token { Name = "A" },
+                new Token { Name = "B", ValidFrom = new DateTime(1111, 11, 11, 11, 11, 11)});
+
+            context.SaveChanges();
+
+            Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+-->
+[!code-csharp[Working_with_default_values_1](../../../samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/DefaultValueSamples.cs?name=Working_with_default_values_1)]
+
+Looking at the [change tracker debug view](xref:core/change-tracking/debug-views) shows that the first token had `ValidFrom` generated by the database, while the second token used the value explicitly set:
+
+```output
+Token {Id: 1} Unchanged
+  Id: 1 PK
+  Name: 'A'
+  ValidFrom: '12/30/2020 6:36:06 PM'
+Token {Id: 2} Unchanged
+  Id: 2 PK
+  Name: 'B'
+  ValidFrom: '11/11/1111 11:11:11 AM'
+```
+
+> [!NOTE]
+> Using database default values requires that the database column has a default value constraint configured. This is done automatically by EF Core migrations when using <xref:Microsoft.EntityFrameworkCore.RelationalPropertyBuilderExtensions.HasDefaultValueSql*> or <xref:Microsoft.EntityFrameworkCore.RelationalPropertyBuilderExtensions.HasDefaultValue*>. Make sure to create the default constraint on the column in some other way when not using EF Core migrations.
+
+### Using nullable properties
+
+EF Core is able to determine whether or not a property has been set by comparing the property value to the CLR default for the that type. This works well in most cases, but means that the CLR default cannot be explicitly inserted into the database. For example, consider an entity with an integer property:
+
+<!--
+public class Foo1
+{
+    public int Id { get; set; }
+    public int Count { get; set; }
+}
+-->
+[!code-csharp[Foo1](../../../samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/DefaultValueSamples.cs?name=Foo1)]
+
+Where that property is configured to have a database default of -1:
+
+<!--
+        modelBuilder
+            .Entity<Foo1>()
+            .Property(e => e.Count)
+            .HasDefaultValue(-1);
+-->
+[!code-csharp[OnModelCreating_Foo1](../../../samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/DefaultValueSamples.cs?name=OnModelCreating_Foo1)]
+
+The intention is that the default of -1 will be used whenever an explicit value is not set. However, setting the value to 0 (the CLR default for integers) is indistinguishable to EF Core from not setting any value, this means that it is not possible to insert 0 for this property. For example:
+
+<!--
+        using var context = new BlogsContext();
+
+        var fooA = new Foo1 { Count = 10 };
+        var fooB = new Foo1 { Count = 0 };
+        var fooC = new Foo1 { };
+
+        context.AddRange(fooA, fooB, fooC);
+        context.SaveChanges();
+
+        Debug.Assert(fooA.Count == 10);
+        Debug.Assert(fooB.Count == -1); // Not what we want!
+        Debug.Assert(fooC.Count == -1);
+-->
+[!code-csharp[Working_with_default_values_2](../../../samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/DefaultValueSamples.cs?name=Working_with_default_values_2)]
+
+Notice that the instance where `Count` was explicitly set to 0 is still gets the default value from the database, which is not what we intended. An easy way to deal with this is to make the `Count` property nullable:
+
+<!--
+public class Foo2
+{
+    public int Id { get; set; }
+    public int? Count { get; set; }
+}
+-->
+[!code-csharp[Foo2](../../../samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/DefaultValueSamples.cs?name=Foo2)]
+
+This makes the CLR default null, instead of 0, which means 0 will now be inserted when explicitly set:
+
+<!--
+        using var context = new BlogsContext();
+
+        var fooA = new Foo2 { Count = 10 };
+        var fooB = new Foo2 { Count = 0 };
+        var fooC = new Foo2 { };
+
+        context.AddRange(fooA, fooB, fooC);
+        context.SaveChanges();
+
+        Debug.Assert(fooA.Count == 10);
+        Debug.Assert(fooB.Count == 0);
+        Debug.Assert(fooC.Count == -1);
+-->
+[!code-csharp[Working_with_default_values_3](../../../samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/DefaultValueSamples.cs?name=Working_with_default_values_3)]
+
+### Using nullable backing fields
+
+The problem with making the property nullable that it may not be conceptually nullable in the domain model. Forcing the property to be nullable therefore compromises the model.
+
+The property can be left non-nullable, with only the backing field being nullable. For example:
+
+<!--
+public class Foo3
+{
+    public int Id { get; set; }
+
+    private int? _count;
+    public int Count
+    {
+        get => _count ?? -1;
+        set => _count = value;
+    }
+}
+-->
+[!code-csharp[Foo3](../../../samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/DefaultValueSamples.cs?name=Foo3)]
+
+This allows the CLR default (0) to be inserted if the property is explicitly set to 0, while not needing to expose the property as nullable in the domain model. For example:
+
+<!--
+            using var context = new BlogsContext();
+
+            var fooA = new Foo3 { Count = 10 };
+            var fooB = new Foo3 { Count = 0 };
+            var fooC = new Foo3 { };
+
+            context.AddRange(fooA, fooB, fooC);
+            context.SaveChanges();
+
+            Debug.Assert(fooA.Count == 10);
+            Debug.Assert(fooB.Count == 0);
+            Debug.Assert(fooC.Count == -1);
+-->
+[!code-csharp[Working_with_default_values_4](../../../samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/DefaultValueSamples.cs?name=Working_with_default_values_4)]
+
+#### Nullable backing fields for bool properties
+
+This pattern is especially useful when using bool properties with store-generated defaults. Since the CLR default for `bool` is "false", it means that "false" cannot be inserted explicitly using the normal pattern. For example, consider a `User` entity type:
+
+<!--
+public class User
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+
+    private bool? _isAuthorized;
+    public bool IsAuthorized
+    {
+        get => _isAuthorized ?? true;
+        set => _isAuthorized = value;
+    }
+}
+-->
+[!code-csharp[User](../../../samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/DefaultValueSamples.cs?name=User)]
+
+The `IsAuthorized` property is configured with a database default value of "true":
+
+<!--
+        modelBuilder
+            .Entity<User>()
+            .Property(e => e.IsAuthorized)
+            .HasDefaultValue(true);
+-->
+[!code-csharp[OnModelCreating_User](../../../samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/DefaultValueSamples.cs?name=OnModelCreating_User)]
+
+The `IsAuthorized` property can be set to "true" or "false" explicitly before inserting, or can be left unset in which case the database default will be used:
+
+<!--
+        using var context = new BlogsContext();
+
+        var userA = new User { Name = "Mac" };
+        var userB = new User { Name = "Alice", IsAuthorized = true };
+        var userC = new User { Name = "Baxter", IsAuthorized = false }; // Always deny Baxter access!
+
+        context.AddRange(userA, userB, userC);
+
+        context.SaveChanges();
+-->
+[!code-csharp[Working_with_default_values_5](../../../samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/DefaultValueSamples.cs?name=Working_with_default_values_5)]
+
+The output from SaveChanges when using SQLite shows that the database default is used for Mac, while explicit values are set for Alice and Baxter:
+
+```sql
+-- Executed DbCommand (0ms) [Parameters=[@p0='Mac' (Size = 3)], CommandType='Text', CommandTimeout='30']
+INSERT INTO "User" ("Name")
+VALUES (@p0);
+SELECT "Id", "IsAuthorized"
+FROM "User"
+WHERE changes() = 1 AND "rowid" = last_insert_rowid();
+
+-- Executed DbCommand (0ms) [Parameters=[@p0='True' (DbType = String), @p1='Alice' (Size = 5)], CommandType='Text', CommandTimeout='30']
+INSERT INTO "User" ("IsAuthorized", "Name")
+VALUES (@p0, @p1);
+SELECT "Id"
+FROM "User"
+WHERE changes() = 1 AND "rowid" = last_insert_rowid();
+
+-- Executed DbCommand (0ms) [Parameters=[@p0='False' (DbType = String), @p1='Baxter' (Size = 6)], CommandType='Text', CommandTimeout='30']
+INSERT INTO "User" ("IsAuthorized", "Name")
+VALUES (@p0, @p1);
+SELECT "Id"
+FROM "User"
+WHERE changes() = 1 AND "rowid" = last_insert_rowid();
+```
+
+### Schema defaults only
+
+Sometimes it is useful to have defaults in the database schema created by EF Core migrations without EF Core ever using these values for inserts. This can be achieved by configuring the property as <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder.ValueGeneratedNever*?displayProperty=nameWithType> For example:
+
+<!--
+        modelBuilder
+            .Entity<Bar>()
+            .Property(e => e.Count)
+            .HasDefaultValue(-1)
+            .ValueGeneratedNever();
+-->
+[!code-csharp[OnModelCreating_Bar](../../../samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/DefaultValueSamples.cs?name=OnModelCreating_Bar)]
diff --git a/entity-framework/core/change-tracking/relationship-changes.md b/entity-framework/core/change-tracking/relationship-changes.md
new file mode 100644
index 0000000000..01ab9ad361
--- /dev/null
+++ b/entity-framework/core/change-tracking/relationship-changes.md
@@ -0,0 +1,1177 @@
+---
+title: Changing Foreign Keys and Navigations - EF Core
+description: How to change relationships between entities by manipulating foreign keys and navigations
+author: SamMonoRT
+ms.date: 12/30/2020
+uid: core/change-tracking/relationship-changes
+---
+
+# Changing Foreign Keys and Navigations
+
+## Overview of foreign keys and navigations
+
+Relationships in an Entity Framework Core (EF Core) model are represented using foreign keys (FKs). An FK consists of one or more properties on the dependent or child entity in the relationship. This dependent/child entity is associated with a given principal/parent entity when the values of the foreign key properties on the dependent/child match the values of the alternate or primary key (PK) properties on the principal/parent.
+
+Foreign keys are a good way to store and manipulate relationships in the database, but are not very friendly when working with multiple related entities in application code. Therefore, most EF Core models also layer "navigations" over the FK representation. Navigations form C#/.NET references between entity instances that reflect the associations found by matching foreign key values to primary or alternate key values.
+
+Navigations can be used on both sides of the relationship, on one side only, or not at all, leaving only the FK property. The FK property can be hidden by making it a [shadow property](xref:core/modeling/shadow-properties). See [Relationships](xref:core/modeling/relationships) for more information on modelling relationships.
+
+> [!TIP]
+> This document assumes that entity states and the basics of EF Core change tracking are understood. See [Change Tracking in EF Core](xref:core/change-tracking/index) for more information on these topics.
+
+> [!TIP]
+> You can run and debug into all the code in this document by [downloading the sample code from GitHub](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/ChangeTracking/ChangingFKsAndNavigations).
+
+### Example model
+
+The following model contains four entity types with relationships between them. The comments in the code indicate which properties are foreign keys, primary keys, and navigations.
+
+<!--
+public class Blog
+{
+    public int Id { get; set; } // Primary key
+    public string Name { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>(); // Collection navigation
+    public BlogAssets Assets { get; set; } // Reference navigation
+}
+
+public class BlogAssets
+{
+    public int Id { get; set; } // Primary key
+    public byte[] Banner { get; set; }
+
+    public int BlogId { get; set; } // Foreign key
+    public Blog Blog { get; set; } // Reference navigation
+}
+
+public class Post
+{
+    public int Id { get; set; } // Primary key
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int? BlogId { get; set; } // Foreign key
+    public Blog Blog { get; set; } // Reference navigation
+
+    public IList<Tag> Tags { get; } = new List<Tag>(); // Skip collection navigation
+}
+
+public class Tag
+{
+    public int Id { get; set; } // Primary key
+    public string Text { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>(); // Skip collection navigation
+}
+-->
+[!code-csharp[Model](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/OptionalRelationshipsSamples.cs?name=Model)]
+
+The three relationships in this model are:
+
+- Each blog can have many posts (one-to-many):
+  - `Blog` is the principal/parent.
+  - `Post` is the dependent/child. It contains the FK property `Post.BlogId`, the value of which must match the `Blog.Id` PK value of the related blog.
+  - `Post.Blog` is a reference navigation from a post to the associated blog. `Post.Blog` is the inverse navigation for `Blog.Posts`.
+  - `Blog.Posts` is a collection navigation from a blog to all the associated posts. `Blog.Posts` is the inverse navigation for `Post.Blog`.
+- Each blog can have one assets (one-to-one):
+  - `Blog` is the principal/parent.
+  - `BlogAssets` is the dependent/child. It contains the FK property `BlogAssets.BlogId`, the value of which must match the `Blog.Id` PK value of the related blog.
+  - `BlogAssets.Blog` is a reference navigation from the assets to the associated blog. `BlogAssets.Blog` is the inverse navigation for `Blog.Assets`.
+  - `Blog.Assets` is a reference navigation from the blog to the associated assets. `Blog.Assets` is the inverse navigation for `BlogAssets.Blog`.
+- Each post can have many tags and each tag can have many posts (many-to-many):
+  - Many-to-many relationships are a further layer over two one-to-many relationships. Many-to-many relationships are covered later in this document.
+  - `Post.Tags` is a collection navigation from a post to all the associated tags. `Post.Tags` is the inverse navigation for `Tag.Posts`.
+  - `Tag.Posts` is a collection navigation from a tag to all the associated posts. `Tag.Posts` is the inverse navigation for `Post.Tags`.
+
+See [Relationships](xref:core/modeling/relationships) for more information on how to model and configure relationships.
+
+## Relationship fixup
+
+EF Core keeps navigations in alignment with foreign key values and vice versa. That is, if a foreign key value changes such that it now refers to a different principal/parent entity, then the navigations are updated to reflect this change. Likewise, if a navigation is changed, then the foreign key values of the entities involved are updated to reflect this change. This is called "relationship fixup".
+
+### Fixup by query
+
+Fixup first occurs when entities are queried from the database. The database has only foreign key values, so when EF Core creates an entity instance from the database it uses the foreign key values to set reference navigations and add entities to collection navigations as appropriate. For example, consider a query for blogs and its associated posts and assets:
+
+<!--
+        using var context = new BlogsContext();
+
+        var blogs = context.Blogs
+            .Include(e => e.Posts)
+            .Include(e => e.Assets)
+            .ToList();
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+-->
+[!code-csharp[Relationship_fixup_1](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/OptionalRelationshipsSamples.cs?name=Relationship_fixup_1)]
+
+For each blog, EF Core will first create a `Blog` instance. Then, as each post is loaded from the database its `Post.Blog` reference navigation is set to point to the associated blog. Likewise, the post is added to the `Blog.Posts` collection navigation. The same thing happens with `BlogAssets`, except in this case both navigations are references. The `Blog.Assets` navigation is set to point to the assets instance, and the `BlogAsserts.Blog` navigation is set to point to the blog instance.
+
+Looking at the [change tracker debug view](xref:core/change-tracking/debug-views) after this query shows two blogs, each with one assets and two posts being tracked:
+
+```output
+Blog {Id: 1} Unchanged
+  Id: 1 PK
+  Name: '.NET Blog'
+  Assets: {Id: 1}
+  Posts: [{Id: 1}, {Id: 2}]
+Blog {Id: 2} Unchanged
+  Id: 2 PK
+  Name: 'Visual Studio Blog'
+  Assets: {Id: 2}
+  Posts: [{Id: 3}, {Id: 4}]
+BlogAssets {Id: 1} Unchanged
+  Id: 1 PK
+  Banner: <null>
+  BlogId: 1 FK
+  Blog: {Id: 1}
+BlogAssets {Id: 2} Unchanged
+  Id: 2 PK
+  Banner: <null>
+  BlogId: 2 FK
+  Blog: {Id: 2}
+Post {Id: 1} Unchanged
+  Id: 1 PK
+  BlogId: 1 FK
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...'
+  Title: 'Announcing the Release of EF Core 5.0'
+  Blog: {Id: 1}
+  Tags: []
+Post {Id: 2} Unchanged
+  Id: 2 PK
+  BlogId: 1 FK
+  Content: 'F# 5 is the latest version of F#, the functional programming...'
+  Title: 'Announcing F# 5'
+  Blog: {Id: 1}
+  Tags: []
+Post {Id: 3} Unchanged
+  Id: 3 PK
+  BlogId: 2 FK
+  Content: 'If you are focused on squeezing out the last bits of perform...'
+  Title: 'Disassembly improvements for optimized managed debugging'
+  Blog: {Id: 2}
+  Tags: []
+Post {Id: 4} Unchanged
+  Id: 4 PK
+  BlogId: 2 FK
+  Content: 'Examine when database queries were executed and measure how ...'
+  Title: 'Database Profiling with Visual Studio'
+  Blog: {Id: 2}
+  Tags: []
+```
+
+The debug view shows both key values and navigations. Navigations are shown using the primary key values of the related entities. For example, `Posts: [{Id: 1}, {Id: 2}]` in the output above indicates that the `Blog.Posts` collection navigation contains two related posts with primary keys 1 and 2 respectively. Similarly, for each post associated with the first blog, the `Blog: {Id: 1}` line indicates that the `Post.Blog` navigation references the Blog with primary key 1.
+
+### Fixup to locally tracked entities
+
+Relationship fixup also happens between entities returned from a tracking query and entities already tracked by the DbContext. For example, consider executing three separate queries for blogs, posts, and assets:
+
+<!--
+        using var context = new BlogsContext();
+
+        var blogs = context.Blogs.ToList();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        var assets = context.Assets.ToList();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        var posts = context.Posts.ToList();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+-->
+[!code-csharp[Relationship_fixup_2](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/OptionalRelationshipsSamples.cs?name=Relationship_fixup_2)]
+Looking again at the debug views, after the first query only the two blogs are tracked:
+
+```output
+Blog {Id: 1} Unchanged
+  Id: 1 PK
+  Name: '.NET Blog'
+  Assets: <null>
+  Posts: []
+Blog {Id: 2} Unchanged
+  Id: 2 PK
+  Name: 'Visual Studio Blog'
+  Assets: <null>
+  Posts: []
+```
+
+The `Blog.Assets` reference navigations are null, and the `Blog.Posts` collection navigations are empty because no associated entities are currently being tracked by the context.
+
+After the second query, the `Blogs.Assets` reference navigations have been fixed up to point to the newly tracked `BlogAsset` instances. Likewise, the `BlogAssets.Blog` reference navigations are set to point to the appropriate already tracked `Blog` instance.
+
+```output
+Blog {Id: 1} Unchanged
+  Id: 1 PK
+  Name: '.NET Blog'
+  Assets: {Id: 1}
+  Posts: []
+Blog {Id: 2} Unchanged
+  Id: 2 PK
+  Name: 'Visual Studio Blog'
+  Assets: {Id: 2}
+  Posts: []
+BlogAssets {Id: 1} Unchanged
+  Id: 1 PK
+  Banner: <null>
+  BlogId: 1 FK
+  Blog: {Id: 1}
+BlogAssets {Id: 2} Unchanged
+  Id: 2 PK
+  Banner: <null>
+  BlogId: 2 FK
+  Blog: {Id: 2}
+```
+
+Finally, after the third query, the `Blog.Posts` collection navigations now contain all related posts, and the `Post.Blog` references point to the appropriate `Blog` instance:
+
+```output
+Blog {Id: 1} Unchanged
+  Id: 1 PK
+  Name: '.NET Blog'
+  Assets: {Id: 1}
+  Posts: [{Id: 1}, {Id: 2}]
+Blog {Id: 2} Unchanged
+  Id: 2 PK
+  Name: 'Visual Studio Blog'
+  Assets: {Id: 2}
+  Posts: [{Id: 3}, {Id: 4}]
+BlogAssets {Id: 1} Unchanged
+  Id: 1 PK
+  Banner: <null>
+  BlogId: 1 FK
+  Blog: {Id: 1}
+BlogAssets {Id: 2} Unchanged
+  Id: 2 PK
+  Banner: <null>
+  BlogId: 2 FK
+  Blog: {Id: 2}
+Post {Id: 1} Unchanged
+  Id: 1 PK
+  BlogId: 1 FK
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...'
+  Title: 'Announcing the Release of EF Core 5.0'
+  Blog: {Id: 1}
+  Tags: []
+Post {Id: 2} Unchanged
+  Id: 2 PK
+  BlogId: 1 FK
+  Content: 'F# 5 is the latest version of F#, the functional programming...'
+  Title: 'Announcing F# 5'
+  Blog: {Id: 1}
+  Tags: []
+Post {Id: 3} Unchanged
+  Id: 3 PK
+  BlogId: 2 FK
+  Content: 'If you are focused on squeezing out the last bits of perform...'
+  Title: 'Disassembly improvements for optimized managed debugging'
+  Blog: {Id: 2}
+  Tags: []
+Post {Id: 4} Unchanged
+  Id: 4 PK
+  BlogId: 2 FK
+  Content: 'Examine when database queries were executed and measure how ...'
+  Title: 'Database Profiling with Visual Studio'
+  Blog: {Id: 2}
+  Tags: []
+```
+
+This is the same end-state as was achieved with the original single query, since EF Core fixed up navigations as entities were tracked, even when coming from multiple different queries.
+
+> [!NOTE]
+> Fixup never causes more data to be returned from the database. It only connects entities that are already returned by the query or already tracked by the DbContext. See [Identity Resolution in EF Core](xref:core/change-tracking/identity-resolution) for information about handling duplicates when serializing entities.
+
+## Changing relationships using navigations
+
+The easiest way to change the relationship between two entities is by manipulating a navigation, while leaving EF Core to fixup the inverse navigation and FK values appropriately. This can be done by:
+
+- Adding or removing an entity from a collection navigation.
+- Changing a reference navigation to point to a different entity, or setting it to null.
+
+### Adding or removing from collection navigations
+
+For example, let's move one of the posts from the Visual Studio blog to the .NET blog. This requires first loading the blogs and posts, and then moving the post from the navigation collection on one blog to the navigation collection on the other blog:
+
+<!--
+        using var context = new BlogsContext();
+
+        var dotNetBlog = context.Blogs.Include(e => e.Posts).Single(e => e.Name == ".NET Blog");
+        var vsBlog = context.Blogs.Include(e => e.Posts).Single(e => e.Name == "Visual Studio Blog");
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        var post = vsBlog.Posts.Single(e => e.Title.StartsWith("Disassembly improvements"));
+        vsBlog.Posts.Remove(post);
+        dotNetBlog.Posts.Add(post);
+
+        context.ChangeTracker.DetectChanges();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        context.SaveChanges();
+-->
+[!code-csharp[Changing_relationships_using_navigations_1](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/OptionalRelationshipsSamples.cs?name=Changing_relationships_using_navigations_1)]
+
+> [!TIP]
+> A call to <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.DetectChanges?displayProperty=nameWithType> is needed here because accessing the debug view does not cause [automatic detection of changes](xref:core/change-tracking/change-detection).
+
+This is the debug view printed after running the code above:
+
+```output
+Blog {Id: 1} Unchanged
+  Id: 1 PK
+  Name: '.NET Blog'
+  Assets: <null>
+  Posts: [{Id: 1}, {Id: 2}, {Id: 3}]
+Blog {Id: 2} Unchanged
+  Id: 2 PK
+  Name: 'Visual Studio Blog'
+  Assets: <null>
+  Posts: [{Id: 4}]
+Post {Id: 1} Unchanged
+  Id: 1 PK
+  BlogId: 1 FK
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...'
+  Title: 'Announcing the Release of EF Core 5.0'
+  Blog: {Id: 1}
+  Tags: []
+Post {Id: 2} Unchanged
+  Id: 2 PK
+  BlogId: 1 FK
+  Content: 'F# 5 is the latest version of F#, the functional programming...'
+  Title: 'Announcing F# 5'
+  Blog: {Id: 1}
+  Tags: []
+Post {Id: 3} Modified
+  Id: 3 PK
+  BlogId: 1 FK Modified Originally 2
+  Content: 'If you are focused on squeezing out the last bits of perform...'
+  Title: 'Disassembly improvements for optimized managed debugging'
+  Blog: {Id: 1}
+  Tags: []
+Post {Id: 4} Unchanged
+  Id: 4 PK
+  BlogId: 2 FK
+  Content: 'Examine when database queries were executed and measure how ...'
+  Title: 'Database Profiling with Visual Studio'
+  Blog: {Id: 2}
+  Tags: []
+```
+
+The `Blog.Posts` navigation on the .NET Blog now has three posts (`Posts: [{Id: 1}, {Id: 2}, {Id: 3}]`). Likewise, the `Blog.Posts` navigation on the Visual Studio blog only has one post (`Posts: [{Id: 4}]`). This is to be expected since the code explicitly changed these collections.
+
+More interestingly, even though the code did not explicitly change the `Post.Blog` navigation, it has been fixed-up to point to the Visual Studio blog (`Blog: {Id: 1}`). Also, the `Post.BlogId` foreign key value has been updated to match the primary key value of the .NET blog. This change to the FK value is then persisted to the database when SaveChanges is called:
+
+```sql
+-- Executed DbCommand (0ms) [Parameters=[@p1='3' (DbType = String), @p0='1' (Nullable = true) (DbType = String)], CommandType='Text', CommandTimeout='30']
+UPDATE "Posts" SET "BlogId" = @p0
+WHERE "Id" = @p1;
+SELECT changes();
+```
+
+### Changing reference navigations
+
+In the previous example, a post was moved from one blog to another by manipulating the collection navigation of posts on each blog. The same thing can be achieved by instead changing the `Post.Blog` reference navigation to point to the new blog. For example:
+
+<!--
+        var post = vsBlog.Posts.Single(e => e.Title.StartsWith("Disassembly improvements"));
+        post.Blog = dotNetBlog;
+-->
+[!code-csharp[Changing_relationships_using_navigations_2](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/OptionalRelationshipsSamples.cs?name=Changing_relationships_using_navigations_2)]
+
+The debug view after this change is _exactly the same_ as it was in the previous example. This is because EF Core detected the reference navigation change and then fixed up the collection navigations and FK value to match.
+
+## Changing relationships using foreign key values
+
+In the previous section, relationships were manipulated by navigations leaving foreign key values to be updated automatically. This is the recommended way to manipulate relationships in EF Core. However, it is also possible to manipulate FK values directly. For example, we can move a post from one blog to another by changing the `Post.BlogId` foreign key value:
+
+<!--
+        var post = vsBlog.Posts.Single(e => e.Title.StartsWith("Disassembly improvements"));
+        post.BlogId = dotNetBlog.Id;
+-->
+[!code-csharp[Changing_relationships_using_foreign_key_values_1](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/OptionalRelationshipsSamples.cs?name=Changing_relationships_using_foreign_key_values_1)]
+
+Notice how this is very similar to changing the reference navigation, as shown in the previous example.
+
+The debug view after this change is again _exactly the same_ as was the case for the previous two examples. This is because EF Core detected the FK value change and then fixed up both the reference and collection navigations to match.
+
+> [!TIP]
+> Do not write code to manipulate all navigations and FK values each time a relationship changes. Such code is more complicated and must ensure consistent changes to foreign keys and navigations in every case. If possible, just manipulate a single navigation, or maybe both navigations. If needed, just manipulate FK values. Avoid manipulating both navigations and FK values.
+
+## Fixup for added or deleted entities
+
+### Adding to a collection navigation
+
+EF Core performs the following actions when it [detects](xref:core/change-tracking/change-detection) that a new dependent/child entity has been added to a collection navigation:
+
+- If the entity is not tracked, then it is tracked. (The entity will usually be in the `Added` state. However, if the entity type is configured to use generated keys and the primary key value is set, then the entity is tracked in the `Unchanged` state.)
+- If the entity is associated with a different principal/parent, then that relationship is severed.
+- The entity becomes associated with the principal/parent that owns the collection navigation.
+- Navigations and foreign key values are fixed up for all entities involved.
+
+Based on this we can see that to move a post from one blog to another we don't actually need to remove it from the old collection navigation before adding it to the new one. So the code from the example above can be changed from:
+
+<!--
+        var post = vsBlog.Posts.Single(e => e.Title.StartsWith("Disassembly improvements"));
+        vsBlog.Posts.Remove(post);
+        dotNetBlog.Posts.Add(post);
+-->
+[!code-csharp[Fixup_for_added_or_deleted_entities_1](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/OptionalRelationshipsSamples.cs?name=Fixup_for_added_or_deleted_entities_1)]
+
+To:
+
+<!--
+        var post = vsBlog.Posts.Single(e => e.Title.StartsWith("Disassembly improvements"));
+        dotNetBlog.Posts.Add(post);
+-->
+[!code-csharp[Fixup_for_added_or_deleted_entities_2](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/OptionalRelationshipsSamples.cs?name=Fixup_for_added_or_deleted_entities_2)]
+
+EF Core sees that the post has been added to a new blog and automatically removes it from the collection on the first blog.
+
+### Removing from a collection navigation
+
+Removing a dependent/child entity from the collection navigation of the principal/parent causes severing of the relationship to that principal/parent. What happens next depends on whether the relationship is optional or required.
+
+#### Optional relationships
+
+By default for optional relationships, the foreign key value is set to null. This means that the dependent/child is no longer associated with _any_ principal/parent. For example, let's load a blog and posts and then remove one of the posts from the `Blog.Posts` collection navigation:
+
+<!--
+        var post = dotNetBlog.Posts.Single(e => e.Title == "Announcing F# 5");
+        dotNetBlog.Posts.Remove(post);
+-->
+[!code-csharp[Fixup_for_added_or_deleted_entities_3](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/OptionalRelationshipsSamples.cs?name=Fixup_for_added_or_deleted_entities_3)]
+
+Looking at the [change tracking debug view](xref:core/change-tracking/debug-views) after this change shows that:
+
+- The `Post.BlogId` FK has been set to null (`BlogId: <null> FK Modified Originally 1`)
+- The `Post.Blog` reference navigation has been set to null (`Blog: <null>`)
+- The post has been removed from `Blog.Posts` collection navigation (`Posts: [{Id: 1}]`)
+
+```output
+Blog {Id: 1} Unchanged
+  Id: 1 PK
+  Name: '.NET Blog'
+  Assets: <null>
+  Posts: [{Id: 1}]
+Post {Id: 1} Unchanged
+  Id: 1 PK
+  BlogId: 1 FK
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...'
+  Title: 'Announcing the Release of EF Core 5.0'
+  Blog: {Id: 1}
+  Tags: []
+Post {Id: 2} Modified
+  Id: 2 PK
+  BlogId: <null> FK Modified Originally 1
+  Content: 'F# 5 is the latest version of F#, the functional programming...'
+  Title: 'Announcing F# 5'
+  Blog: <null>
+  Tags: []
+```
+
+Notice that the post is _not_ marked as `Deleted`. It is marked as `Modified` so that the FK value in the database will be set to null when SaveChanges is called.
+
+#### Required relationships
+
+Setting the FK value to null is not allowed (and is usually not possible) for required relationships. Therefore, severing a required relationship means that the dependent/child entity must be either re-parented to a new principal/parent, or removed from the database when SaveChanges is called to avoid a referential constraint violation. This is known as "deleting orphans", and is the default behavior in EF Core for required relationships.
+
+For example, let's change the relationship between blog and posts to be required and then run the same code as in the previous example:
+
+<!--
+        var post = dotNetBlog.Posts.Single(e => e.Title == "Announcing F# 5");
+        dotNetBlog.Posts.Remove(post);
+-->
+[!code-csharp[Fixup_for_added_or_deleted_entities_4](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/RequiredRelationshipsSamples.cs?name=Fixup_for_added_or_deleted_entities_4)]
+
+Looking at the debug view after this change shows that:
+
+- The post has been marked as `Deleted` such that it will be deleted from the database when SaveChanges is called.
+- The `Post.Blog` reference navigation has been set to null (`Blog: <null>`).
+- The post has been removed from `Blog.Posts` collection navigation (`Posts: [{Id: 1}]`).
+
+```output
+Blog {Id: 1} Unchanged
+  Id: 1 PK
+  Name: '.NET Blog'
+  Assets: <null>
+  Posts: [{Id: 1}]
+Post {Id: 1} Unchanged
+  Id: 1 PK
+  BlogId: 1 FK
+  Content: 'Announcing the release of EF Core 5.0, a full featured cross...'
+  Title: 'Announcing the Release of EF Core 5.0'
+  Blog: {Id: 1}
+  Tags: []
+Post {Id: 2} Deleted
+  Id: 2 PK
+  BlogId: 1 FK
+  Content: 'F# 5 is the latest version of F#, the functional programming...'
+  Title: 'Announcing F# 5'
+  Blog: <null>
+  Tags: []
+```
+
+Notice that the `Post.BlogId` remains unchanged since for a required relationship it cannot be set to null.
+
+Calling SaveChanges results in the orphaned post being deleted:
+
+```sql
+-- Executed DbCommand (0ms) [Parameters=[@p0='2' (DbType = String)], CommandType='Text', CommandTimeout='30']
+DELETE FROM "Posts"
+WHERE "Id" = @p0;
+SELECT changes();
+```
+
+#### Delete orphans timing and re-parenting
+
+By default, marking orphans as `Deleted` happens as soon as the relationship change is [detected](xref:core/change-tracking/change-detection). However, this process can be delayed until SaveChanges is actually called. This can be useful to avoid making orphans of entities that have been removed from one principal/parent, but will be re-parented with a new principal/parent before SaveChanges is called. <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.DeleteOrphansTiming?displayProperty=nameWithType> is used to set this timing. For example:
+
+<!--
+        context.ChangeTracker.DeleteOrphansTiming = CascadeTiming.OnSaveChanges;
+
+        var post = vsBlog.Posts.Single(e => e.Title.StartsWith("Disassembly improvements"));
+        vsBlog.Posts.Remove(post);
+
+        context.ChangeTracker.DetectChanges();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        dotNetBlog.Posts.Add(post);
+
+        context.ChangeTracker.DetectChanges();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        context.SaveChanges();
+-->
+[!code-csharp[Fixup_for_added_or_deleted_entities_5](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/RequiredRelationshipsSamples.cs?name=Fixup_for_added_or_deleted_entities_5)]
+
+After removing the post from the first collection the object is not marked as `Deleted` as it was in the previous example. Instead, EF Core is tracking that the relationship is severed _even though this is a required relationship_. (The FK value is considered null by EF Core even though it cannot really be null because the type is not nullable. This is known as a "conceptual null".)
+
+```output
+Post {Id: 3} Modified
+  Id: 3 PK
+  BlogId: <null> FK Modified Originally 2
+  Content: 'If you are focused on squeezing out the last bits of perform...'
+  Title: 'Disassembly improvements for optimized managed debugging'
+  Blog: <null>
+  Tags: []
+```
+
+Calling SaveChanges at this time would result in the orphaned post being deleted. However, if as in the example above, post is associated with a new blog before SaveChanges is called, then it will be fixed up appropriately to that new blog and is no longer considered an orphan:
+
+```output
+Post {Id: 3} Modified
+  Id: 3 PK
+  BlogId: 1 FK Modified Originally 2
+  Content: 'If you are focused on squeezing out the last bits of perform...'
+  Title: 'Disassembly improvements for optimized managed debugging'
+  Blog: {Id: 1}
+  Tags: []
+```
+
+SaveChanges called at this point will update the post in the database rather than deleting it.
+
+It is also possible to turn off automatic deletion of orphans. This will result in an exception if SaveChanges is called while an orphan is being tracked. For example, this code:
+
+<!--
+                var dotNetBlog = context.Blogs.Include(e => e.Posts).Single(e => e.Name == ".NET Blog");
+
+                context.ChangeTracker.DeleteOrphansTiming = CascadeTiming.Never;
+
+                var post = dotNetBlog.Posts.Single(e => e.Title == "Announcing F# 5");
+                dotNetBlog.Posts.Remove(post);
+
+                context.SaveChanges(); // Throws
+-->
+[!code-csharp[Fixup_for_added_or_deleted_entities_6](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/RequiredRelationshipsSamples.cs?name=Fixup_for_added_or_deleted_entities_6)]
+
+Will throw this exception:
+
+> System.InvalidOperationException: The association between entities 'Blog' and 'Post' with the key value '{BlogId: 1}' has been severed, but the relationship is either marked as required or is implicitly required because the foreign key is not nullable. If the dependent/child entity should be deleted when a required relationship is severed, configure the relationship to use cascade deletes.
+
+Deletion of orphans, as well as cascade deletes, can be forced at any time by calling <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.CascadeChanges?displayProperty=nameWithType>. Combining this with setting the delete orphan timing to `Never` will ensure orphans are never deleted unless EF Core is explicitly instructed to do so.
+
+### Changing a reference navigation
+
+Changing the reference navigation of a one-to-many relationship has the same effect as changing the collection navigation on the other end of the relationship. Setting the reference navigation of dependent/child to null is equivalent to removing the entity from the collection navigation of the principal/parent. All fixup and database changes happen as described in the previous section, including making the entity an orphan if the relationship is required.
+
+#### Optional one-to-one relationships
+
+For one-to-one relationships, changing a reference navigation causes any previous relationship to be severed. For optional relationships, this means that the FK value on the previously related dependent/child is set to null. For example:
+
+<!--
+        using var context = new BlogsContext();
+
+        var dotNetBlog = context.Blogs.Include(e => e.Assets).Single(e => e.Name == ".NET Blog");
+        dotNetBlog.Assets = new BlogAssets();
+
+        context.ChangeTracker.DetectChanges();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        context.SaveChanges();
+-->
+[!code-csharp[Fixup_for_added_or_deleted_entities_7](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/OptionalRelationshipsSamples.cs?name=Fixup_for_added_or_deleted_entities_7)]
+
+The debug view before calling SaveChanges shows that the new assets has replaced the existing assets, which is now marked as `Modified` with a null `BlogAssets.BlogId` FK value:
+
+```output
+Blog {Id: 1} Unchanged
+  Id: 1 PK
+  Name: '.NET Blog'
+  Assets: {Id: -2147482629}
+  Posts: []
+BlogAssets {Id: -2147482629} Added
+  Id: -2147482629 PK Temporary
+  Banner: <null>
+  BlogId: 1 FK
+  Blog: {Id: 1}
+BlogAssets {Id: 1} Modified
+  Id: 1 PK
+  Banner: <null>
+  BlogId: <null> FK Modified Originally 1
+  Blog: <null>
+```
+
+This results in an update and an insert when SaveChanges is called:
+
+```sql
+-- Executed DbCommand (0ms) [Parameters=[@p1='1' (DbType = String), @p0=NULL], CommandType='Text', CommandTimeout='30']
+UPDATE "Assets" SET "BlogId" = @p0
+WHERE "Id" = @p1;
+SELECT changes();
+
+-- Executed DbCommand (0ms) [Parameters=[@p2=NULL, @p3='1' (Nullable = true) (DbType = String)], CommandType='Text', CommandTimeout='30']
+INSERT INTO "Assets" ("Banner", "BlogId")
+VALUES (@p2, @p3);
+SELECT "Id"
+FROM "Assets"
+WHERE changes() = 1 AND "rowid" = last_insert_rowid();
+```
+
+#### Required one-to-one relationships
+
+Running the same code as in the previous example, but this time with a required one-to-one relationship, shows that the previously associated `BlogAssets` is now marked as `Deleted`, since it becomes an orphan when the new `BlogAssets` takes its place:
+
+```output
+Blog {Id: 1} Unchanged
+  Id: 1 PK
+  Name: '.NET Blog'
+  Assets: {Id: -2147482639}
+  Posts: []
+BlogAssets {Id: -2147482639} Added
+  Id: -2147482639 PK Temporary
+  Banner: <null>
+  BlogId: 1 FK
+  Blog: {Id: 1}
+BlogAssets {Id: 1} Deleted
+  Id: 1 PK
+  Banner: <null>
+  BlogId: 1 FK
+  Blog: <null>
+```
+
+This then results in a delete and an insert when SaveChanges is called:
+
+```sql
+-- Executed DbCommand (0ms) [Parameters=[@p0='1' (DbType = String)], CommandType='Text', CommandTimeout='30']
+DELETE FROM "Assets"
+WHERE "Id" = @p0;
+SELECT changes();
+
+-- Executed DbCommand (0ms) [Parameters=[@p1=NULL, @p2='1' (DbType = String)], CommandType='Text', CommandTimeout='30']
+INSERT INTO "Assets" ("Banner", "BlogId")
+VALUES (@p1, @p2);
+SELECT "Id"
+FROM "Assets"
+WHERE changes() = 1 AND "rowid" = last_insert_rowid();
+```
+
+The timing of marking orphans as deleted can be changed in the same way as shown for collection navigations and has the same effects.
+
+### Deleting an entity
+
+#### Optional relationships
+
+When an entity is marked as `Deleted`, for example by calling <xref:Microsoft.EntityFrameworkCore.DbContext.Remove*?displayProperty=nameWithType>, then references to the deleted entity are removed from the navigations of other entities. For optional relationships, the FK values in dependent entities are set to null.
+
+For example, let's mark the Visual Studio blog as `Deleted`:
+
+<!--
+        using var context = new BlogsContext();
+
+        var vsBlog = context.Blogs
+            .Include(e => e.Posts)
+            .Include(e => e.Assets)
+            .Single(e => e.Name == "Visual Studio Blog");
+
+        context.Remove(vsBlog);
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        context.SaveChanges();
+-->
+[!code-csharp[Deleting_an_entity_1](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/OptionalRelationshipsSamples.cs?name=Deleting_an_entity_1)]
+
+Looking at the [change tracker debug view](xref:core/change-tracking/debug-views) before calling SaveChanges shows:
+
+```output
+Blog {Id: 2} Deleted
+  Id: 2 PK
+  Name: 'Visual Studio Blog'
+  Assets: {Id: 2}
+  Posts: [{Id: 3}, {Id: 4}]
+BlogAssets {Id: 2} Modified
+  Id: 2 PK
+  Banner: <null>
+  BlogId: <null> FK Modified Originally 2
+  Blog: <null>
+Post {Id: 3} Modified
+  Id: 3 PK
+  BlogId: <null> FK Modified Originally 2
+  Content: 'If you are focused on squeezing out the last bits of perform...'
+  Title: 'Disassembly improvements for optimized managed debugging'
+  Blog: <null>
+  Tags: []
+Post {Id: 4} Modified
+  Id: 4 PK
+  BlogId: <null> FK Modified Originally 2
+  Content: 'Examine when database queries were executed and measure how ...'
+  Title: 'Database Profiling with Visual Studio'
+  Blog: <null>
+  Tags: []
+```
+
+Notice that:
+
+- The blog is marked as `Deleted`.
+- The assets related to the deleted blog has a null FK value (`BlogId: <null> FK Modified Originally 2`) and a null reference navigation (`Blog: <null>`)
+- Each post related to the deleted blog has a null FK value (`BlogId: <null> FK Modified Originally 2`) and a null reference navigation (`Blog: <null>`)
+
+#### Required relationships
+
+The fixup behavior for required relationships is the same as for optional relationships except that the dependent/child entities are marked as `Deleted` since they cannot exist without a principal/parent and must be removed from the database when SaveChanges is called to avoid a referential constraint exception. This is known as "cascade delete", and is the default behavior in EF Core for required relationships. For example, running the same code as in the previous example but with a required relationship results in the following debug view before SaveChanges is called:
+
+```output
+Blog {Id: 2} Deleted
+  Id: 2 PK
+  Name: 'Visual Studio Blog'
+  Assets: {Id: 2}
+  Posts: [{Id: 3}, {Id: 4}]
+BlogAssets {Id: 2} Deleted
+  Id: 2 PK
+  Banner: <null>
+  BlogId: 2 FK
+  Blog: {Id: 2}
+Post {Id: 3} Deleted
+  Id: 3 PK
+  BlogId: 2 FK
+  Content: 'If you are focused on squeezing out the last bits of perform...'
+  Title: 'Disassembly improvements for optimized managed debugging'
+  Blog: {Id: 2}
+  Tags: []
+Post {Id: 4} Deleted
+  Id: 4 PK
+  BlogId: 2 FK
+  Content: 'Examine when database queries were executed and measure how ...'
+  Title: 'Database Profiling with Visual Studio'
+  Blog: {Id: 2}
+  Tags: []
+```
+
+As expected, the dependents/children are now marked as `Deleted`. However, notice that the navigations on the deleted entities have _not_ changed. This may seem strange, but it avoids completely shredding a deleted graph of entities by clearing all navigations. That is, the blog, asset, and posts still form a graph of entities even after having been deleted. This makes it much easier to un-delete a graph of entities than was the case in EF6 where the graph was shredded.
+
+#### Cascade delete timing and re-parenting
+
+By default, cascade delete happens as soon as the parent/principal is marked as `Deleted`. This is the same as for deleting orphans, as described previously. As with deleting orphans, this process can be delayed until SaveChanges is called, or even disabled entirely, by setting <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.CascadeDeleteTiming?displayProperty=nameWithType> appropriately. This is useful in the same way as it is for deleting orphans, including for re-parenting children/dependents after deletion of a principal/parent.
+
+Cascade deletes, as well as deleting orphans, can be forced at any time by calling <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.CascadeChanges?displayProperty=nameWithType>. Combining this with setting the cascade delete timing to `Never` will ensure cascade deletes never happen unless EF Core is explicitly instructed to do so.
+
+> [!TIP]
+> Cascade delete and deleting orphans are closely related. Both result in deleting dependent/child entities when the relationship to their required principal/parent is severed. For cascade delete, this severing happens because the principal/parent is itself deleted. For orphans, the principal/parent entity still exists, but is no longer related to the dependent/child entities.
+
+## Many-to-many relationships
+
+Many-to-many relationships in EF Core are implemented using a join entity. Each side of the many-to-many relationship is related to this join entity with a one-to-many relationship. This join entity can be explicitly defined and mapped, or it can be created implicitly and hidden. In both cases the underlying behavior is the same. We will look at this underlying behavior first to understand how tracking of many-to-many relationships works.
+
+### How many-to-many relationships work
+
+Consider this EF Core model that creates a many-to-many relationship between posts and tags using an explicitly defined join entity type:
+
+<!--
+    public class Post
+    {
+        public int Id { get; set; }
+        public string Title { get; set; }
+        public string Content { get; set; }
+
+        public int? BlogId { get; set; }
+        public Blog Blog { get; set; }
+
+        public IList<PostTag> PostTags { get; } = new List<PostTag>(); // Collection navigation
+    }
+
+    public class Tag
+    {
+        public int Id { get; set; }
+        public string Text { get; set; }
+
+        public IList<PostTag> PostTags { get; } = new List<PostTag>(); // Collection navigation
+    }
+
+    public class PostTag
+    {
+        public int PostId { get; set; } // First part of composite PK; FK to Post
+        public int TagId { get; set; } // Second part of composite PK; FK to Tag
+
+        public Post Post { get; set; } // Reference navigation
+        public Tag Tag { get; set; } // Reference navigation
+    }
+    -->
+[!code-csharp[Model](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntitySamples.cs?name=Model)]
+
+Notice that the `PostTag` join entity type contains two foreign key properties. In this model, for a post to be related to a tag, there must be a PostTag join entity where the `PostTag.PostId` foreign key value matches the `Post.Id` primary key value, and where the `PostTag.TagId` foreign key value matches the `Tag.Id` primary key value. For example:
+
+<!--
+            using var context = new BlogsContext();
+
+            var post = context.Posts.Single(e => e.Id == 3);
+            var tag = context.Tags.Single(e => e.Id == 1);
+
+            context.Add(new PostTag { PostId = post.Id, TagId = tag.Id });
+
+            Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+-->
+[!code-csharp[Many_to_many_relationships_1](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntitySamples.cs?name=Many_to_many_relationships_1)]
+
+Looking at the [change tracker debug view](xref:core/change-tracking/debug-views) after running this code shows that the post and tag are related by the new `PostTag` join entity:
+
+```output
+Post {Id: 3} Unchanged
+  Id: 3 PK
+  BlogId: 2 FK
+  Content: 'If you are focused on squeezing out the last bits of perform...'
+  Title: 'Disassembly improvements for optimized managed debugging'
+  Blog: <null>
+  PostTags: [{PostId: 3, TagId: 1}]
+PostTag {PostId: 3, TagId: 1} Added
+  PostId: 3 PK FK
+  TagId: 1 PK FK
+  Post: {Id: 3}
+  Tag: {Id: 1}
+Tag {Id: 1} Unchanged
+  Id: 1 PK
+  Text: '.NET'
+  PostTags: [{PostId: 3, TagId: 1}]
+```
+
+Notice that the collection navigations on `Post` and `Tag` have been fixed up, as have the reference navigations on `PostTag`. These relationships can be manipulated by navigations instead of FK values, just as in all the preceding examples. For example, the code above can be modified to add the relationship by setting the reference navigations on the join entity:
+
+<!--
+            context.Add(new PostTag { Post = post, Tag = tag });
+-->
+[!code-csharp[Many_to_many_relationships_2](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntitySamples.cs?name=Many_to_many_relationships_2)]
+
+This results in exactly the same change to FKs and navigations as in the previous example.
+
+### Skip navigations
+
+Manipulating the join table manually can be cumbersome. Many-to-many relationships can be manipulated directly using special collection navigations that "skip over" the join entity. For example, two skip navigations can be added to the model above; one from Post to Tags, and the other from Tag to Posts:
+
+<!--
+    public class Post
+    {
+        public int Id { get; set; }
+        public string Title { get; set; }
+        public string Content { get; set; }
+
+        public int? BlogId { get; set; }
+        public Blog Blog { get; set; }
+
+        public IList<Tag> Tags { get; } = new List<Tag>(); // Skip collection navigation
+        public IList<PostTag> PostTags { get; } = new List<PostTag>(); // Collection navigation
+    }
+
+    public class Tag
+    {
+        public int Id { get; set; }
+        public string Text { get; set; }
+
+        public IList<Post> Posts { get; } = new List<Post>(); // Skip collection navigation
+        public IList<PostTag> PostTags { get; } = new List<PostTag>(); // Collection navigation
+    }
+
+    public class PostTag
+    {
+        public int PostId { get; set; } // First part of composite PK; FK to Post
+        public int TagId { get; set; } // Second part of composite PK; FK to Tag
+
+        public Post Post { get; set; } // Reference navigation
+        public Tag Tag { get; set; } // Reference navigation
+    }
+-->
+[!code-csharp[Model](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntityAndSkipsSamples.cs?name=Model)]
+
+This many-to-many relationship requires the following configuration to ensure the skip navigations and normal navigations are all used for the same many-to-many relationship:
+
+<!--
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Post>()
+                .HasMany(p => p.Tags)
+                .WithMany(p => p.Posts)
+                .UsingEntity<PostTag>(
+                    j => j.HasOne(t => t.Tag).WithMany(p => p.PostTags),
+                    j => j.HasOne(t => t.Post).WithMany(p => p.PostTags));
+        }
+-->
+[!code-csharp[OnModelCreating](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntityAndSkipsSamples.cs?name=OnModelCreating)]
+
+See [Relationships](xref:core/modeling/relationships) for more information on mapping many-to-many relationships.
+
+Skip navigations look and behave like normal collection navigations. However, the way they work with foreign key values is different. Let's associate a post with a tag, but this time using a skip navigation:
+
+<!--
+            using var context = new BlogsContext();
+
+            var post = context.Posts.Single(e => e.Id == 3);
+            var tag = context.Tags.Single(e => e.Id == 1);
+
+            post.Tags.Add(tag);
+
+            context.ChangeTracker.DetectChanges();
+            Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+-->
+[!code-csharp[Many_to_many_relationships_3](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntityAndSkipsSamples.cs?name=Many_to_many_relationships_3)]
+
+Notice that this code doesn't use the join entity. It instead just adds an entity to a navigation collection in the same way as would be done if this were a one-to-many relationship. The resulting debug view is essentially the same as before:
+
+```output
+Post {Id: 3} Unchanged
+  Id: 3 PK
+  BlogId: 2 FK
+  Content: 'If you are focused on squeezing out the last bits of perform...'
+  Title: 'Disassembly improvements for optimized managed debugging'
+  Blog: <null>
+  PostTags: [{PostId: 3, TagId: 1}]
+  Tags: [{Id: 1}]
+PostTag {PostId: 3, TagId: 1} Added
+  PostId: 3 PK FK
+  TagId: 1 PK FK
+  Post: {Id: 3}
+  Tag: {Id: 1}
+Tag {Id: 1} Unchanged
+  Id: 1 PK
+  Text: '.NET'
+  PostTags: [{PostId: 3, TagId: 1}]
+  Posts: [{Id: 3}]
+```
+
+Notice that an instance of the `PostTag` join entity was created automatically with FK values set to the PK values of the tag and post that are now associated. All the normal reference and collection navigations have been fixed up to match these FK values. Also, since this model contains skip navigations, these have also been fixed up. Specifically, even though we added the tag to the `Post.Tags` skip navigation, the `Tag.Posts` inverse skip navigation on the other side of this relationship has also been fixed up to contain the associated post.
+
+It is worth noting that the underlying many-to-many relationships can still be manipulated directly even when skip navigations have been layered on top. For example, the tag and Post could be associated as we did before introducing skip navigations:
+
+<!--
+            context.Add(new PostTag { Post = post, Tag = tag });
+-->
+[!code-csharp[Many_to_many_relationships_4](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntityAndSkipsSamples.cs?name=Many_to_many_relationships_4)]
+
+Or using FK values:
+
+<!--
+            context.Add(new PostTag { PostId = post.Id, TagId = tag.Id });
+-->
+[!code-csharp[Many_to_many_relationships_5](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntityAndSkipsSamples.cs?name=Many_to_many_relationships_5)]
+
+This will still result in the skip navigations being fixed up correctly, resulting in the same debug view output as in the previous example.
+
+### Skip navigations only
+
+In the previous section we added skip navigations _in addition to_ fully defining the two underlying one-to-many relationships. This is useful to illustrate what happens to FK values, but is often unnecessary. Instead, the many-to-many relationship can be defined using _only skip navigations_. This is how the many-to-many relationship is defined in the model at the very top of this document. Using this model, we can again associate a Post and a Tag by adding a post to the `Tag.Posts` skip navigation (or, alternately, adding a tag to the `Post.Tags` skip navigation):
+
+<!--
+            using var context = new BlogsContext();
+
+            var post = context.Posts.Single(e => e.Id == 3);
+            var tag = context.Tags.Single(e => e.Id == 1);
+
+            post.Tags.Add(tag);
+
+            context.ChangeTracker.DetectChanges();
+            Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+-->
+[!code-csharp[Many_to_many_relationships_6](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/OptionalRelationshipsSamples.cs?name=Many_to_many_relationships_6)]
+
+Looking at the debug view after making this change reveals that EF Core has created an instance of `Dictionary<string, object>` to represent the join entity. This join entity contains both `PostsId` and `TagsId` foreign key properties which have been set to match the PK values of the post and tag that are associated.
+
+```output
+Post {Id: 3} Unchanged
+  Id: 3 PK
+  BlogId: 2 FK
+  Content: 'If you are focused on squeezing out the last bits of perform...'
+  Title: 'Disassembly improvements for optimized managed debugging'
+  Blog: <null>
+  Tags: [{Id: 1}]
+Tag {Id: 1} Unchanged
+  Id: 1 PK
+  Text: '.NET'
+  Posts: [{Id: 3}]
+PostTag (Dictionary<string, object>) {PostsId: 3, TagsId: 1} Added
+  PostsId: 3 PK FK
+  TagsId: 1 PK FK
+```
+
+See [Relationships](xref:core/modeling/relationships) for more information about implicit join entities and the use of `Dictionary<string, object>` entity types.
+
+> [!IMPORTANT]
+> The CLR type used for join entity types by convention may change in future releases to improve performance. Do not depend on the join type being `Dictionary<string, object>` unless this has been explicitly configured.
+
+### Join entities with payloads
+
+So far all the examples have used a join entity type (whether explicit or implicit) that contains only the two foreign key properties needed for the many-to-many relationship. Neither of these FK values need to be explicitly set by the application when manipulating relationships because their values come from the primary key properties of the related entities. This allows EF Core to create instances of the join entity without missing data.
+
+#### Payloads with generated values
+
+EF Core supports adding additional properties to the join entity type. This is known as giving the join entity a "payload". For example, let's add `TaggedOn` property to the `PostTag` join entity:
+
+<!--
+    public class PostTag
+    {
+        public int PostId { get; set; } // Foreign key to Post
+        public int TagId { get; set; } // Foreign key to Tag
+
+        public DateTime TaggedOn { get; set; } // Payload
+    }
+-->
+[!code-csharp[Model](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntityWithPayloadSamples.cs?name=Model)]
+
+This payload property will not be set when EF Core creates a join entity instance. The most common way to deal with this is to use payload properties with automatically generated values. For example, the `TaggedOn` property can be configured to use a store-generated timestamp when each new entity is inserted:
+
+<!--
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Post>()
+                .HasMany(p => p.Tags)
+                .WithMany(p => p.Posts)
+                .UsingEntity<PostTag>(
+                    j => j.HasOne<Tag>().WithMany(),
+                    j => j.HasOne<Post>().WithMany(),
+                    j => j.Property(e => e.TaggedOn).HasDefaultValueSql("CURRENT_TIMESTAMP"));
+        }
+-->
+[!code-csharp[OnModelCreating](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntityWithPayloadSamples.cs?name=OnModelCreating)]
+
+A post can now be tagged in the same way as before:
+
+<!--
+            using var context = new BlogsContext();
+
+            var post = context.Posts.Single(e => e.Id == 3);
+            var tag = context.Tags.Single(e => e.Id == 1);
+
+            post.Tags.Add(tag);
+
+            context.SaveChanges();
+
+            Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+-->
+[!code-csharp[Many_to_many_relationships_7](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntityWithPayloadSamples.cs?name=Many_to_many_relationships_7)]
+
+Looking at the [change tracker debug view](xref:core/change-tracking/debug-views) after calling SaveChanges shows that the payload property has been set appropriately:
+
+```output
+Post {Id: 3} Unchanged
+  Id: 3 PK
+  BlogId: 2 FK
+  Content: 'If you are focused on squeezing out the last bits of perform...'
+  Title: 'Disassembly improvements for optimized managed debugging'
+  Blog: <null>
+  Tags: [{Id: 1}]
+PostTag {PostId: 3, TagId: 1} Unchanged
+  PostId: 3 PK FK
+  TagId: 1 PK FK
+  TaggedOn: '12/29/2020 8:13:21 PM'
+Tag {Id: 1} Unchanged
+  Id: 1 PK
+  Text: '.NET'
+  Posts: [{Id: 3}]
+```
+
+#### Explicitly setting payload values
+
+Following on from the previous example, let's add a payload property that does not use an automatically generated value:
+
+<!--
+    public class PostTag
+    {
+        public int PostId { get; set; } // First part of composite PK; FK to Post
+        public int TagId { get; set; } // Second part of composite PK; FK to Tag
+
+        public DateTime TaggedOn { get; set; } // Auto-generated payload property
+        public string TaggedBy { get; set; } // Not-generated payload property
+    }
+-->
+[!code-csharp[Model](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntityWithStringPayloadSamples.cs?name=Model)]
+
+A post can now be tagged in the same way as before, and the join entity will still be created automatically. This entity can then be accessed using one of the mechanisms described in [Accessing Tracked Entities](xref:core/change-tracking/entity-entries). For example, the code below uses <xref:Microsoft.EntityFrameworkCore.DbSet`1.Find*?displayProperty=nameWithType> to access the join entity instance:
+
+<!--
+            using var context = new BlogsContext();
+
+            var post = context.Posts.Single(e => e.Id == 3);
+            var tag = context.Tags.Single(e => e.Id == 1);
+
+            post.Tags.Add(tag);
+
+            context.ChangeTracker.DetectChanges();
+
+            var joinEntity = context.Set<PostTag>().Find(post.Id, tag.Id);
+
+            joinEntity.TaggedBy = "ajcvickers";
+
+            context.SaveChanges();
+
+            Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+-->
+[!code-csharp[Many_to_many_relationships_8](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntityWithStringPayloadSamples.cs?name=Many_to_many_relationships_8)]
+
+Once the join entity has been located it can be manipulated in the normal way--in this example, to set the `TaggedBy` payload property before calling SaveChanges.
+
+> [!NOTE]
+> Note that a call to <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.DetectChanges?displayProperty=nameWithType> is required here to give EF Core a chance to detect the navigation property change and create the join entity instance before `Find` is used. See [Change Detection and Notifications](xref:core/change-tracking/change-detection) for more information.
+
+Alternately, the join entity can be created explicitly to associate a post with a tag. For example:
+
+<!--
+            using var context = new BlogsContext();
+
+            var post = context.Posts.Single(e => e.Id == 3);
+            var tag = context.Tags.Single(e => e.Id == 1);
+
+            context.Add(new PostTag()
+            {
+                PostId = post.Id,
+                TagId = tag.Id,
+                TaggedBy = "ajcvickers"
+            });
+
+            context.SaveChanges();
+
+            Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+-->
+[!code-csharp[Many_to_many_relationships_9](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntityWithStringPayloadSamples.cs?name=Many_to_many_relationships_9)]
+
+Finally, another way to set payload data is by either overriding <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*> or using the <xref:Microsoft.EntityFrameworkCore.DbContext.SavingChanges?displayProperty=nameWithType> event to process entities before updating the database. For example:
+
+<!--
+        public override int SaveChanges()
+        {
+            foreach (var entityEntry in ChangeTracker.Entries<PostTag>())
+            {
+                if (entityEntry.State == EntityState.Added)
+                {
+                    entityEntry.Entity.TaggedBy = "ajcvickers";
+                }
+            }
+
+            return base.SaveChanges();
+        }
+-->
+[!code-csharp[SaveChanges](../../../samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntityWithStringPayloadSamples.cs?name=SaveChanges)]
diff --git a/entity-framework/core/cli/dbcontext-creation.md b/entity-framework/core/cli/dbcontext-creation.md
new file mode 100644
index 0000000000..ff70bff66a
--- /dev/null
+++ b/entity-framework/core/cli/dbcontext-creation.md
@@ -0,0 +1,67 @@
+---
+title: Design-time DbContext Creation - EF Core
+description: Strategies for creating a design-time DbContext with Entity Framework Core
+author: SamMonoRT
+ms.date: 10/27/2020
+uid: core/cli/dbcontext-creation
+---
+# Design-time DbContext Creation
+
+Some of the EF Core Tools commands (for example, the [Migrations][1] commands) require a derived `DbContext` instance to be created at design time in order to gather details about the application's entity types and how they map to a database schema. In most cases, it is desirable that the `DbContext` thereby created is configured in a similar way to how it would be [configured at run time][2].
+
+There are various ways the tools try to create the `DbContext`:
+
+## From application services
+
+If your startup project uses the [ASP.NET Core Web Host][3] or [.NET Core Generic Host][4], the tools try to obtain the DbContext object from the application's service provider.
+
+The tools first try to obtain the service provider by invoking `Program.CreateHostBuilder()`, calling `Build()`, then accessing the `Services` property.
+
+[!code-csharp[Main](../../../samples/core/Miscellaneous/CommandLine/ApplicationService.cs#ApplicationService)]
+
+> [!NOTE]
+> When you create a new ASP.NET Core application, this hook is included by default.
+
+The `DbContext` itself and any dependencies in its constructor need to be registered as services in the application's service provider. This can be easily achieved by having [a constructor on the `DbContext` that takes an instance of `DbContextOptions<TContext>` as an argument][5] and using the [`AddDbContext<TContext>` method][6].
+
+## Using a constructor with no parameters
+
+If the DbContext can't be obtained from the application service provider, the tools look for the derived `DbContext` type inside the project. Then they try to create an instance using a constructor with no parameters. This can be the default constructor if the `DbContext` is configured using the [`OnConfiguring`][7] method.
+
+## From a design-time factory
+
+You can also tell the tools how to create your DbContext by implementing the <xref:Microsoft.EntityFrameworkCore.Design.IDesignTimeDbContextFactory`1?displayProperty=nameWithType> interface: If a class implementing this interface is found in either the same project as the derived `DbContext` or in the application's startup project, the tools bypass the other ways of creating the DbContext and use the design-time factory instead.
+
+[!code-csharp[Main](../../../samples/core/Miscellaneous/CommandLine/BloggingContextFactory.cs#BloggingContextFactory)]
+
+A design-time factory can be especially useful if you need to configure the `DbContext` differently for design time than at run time, if the `DbContext` constructor takes additional parameters are not registered in DI, if you are not using DI at all, or if for some reason you prefer not to have a `CreateHostBuilder` method in your ASP.NET Core application's `Main` class.
+
+## Args
+
+Both <xref:Microsoft.EntityFrameworkCore.Design.IDesignTimeDbContextFactory`1.CreateDbContext*?displayProperty=nameWithType> and `Program.CreateHostBuilder` accept command line arguments.
+
+You can specify these arguments from the tools:
+
+### [.NET CLI](#tab/dotnet-core-cli)
+
+```dotnetcli
+dotnet ef database update -- --environment Production
+```
+
+The `--` token directs `dotnet ef` to treat everything that follows as an argument and not try to parse them as options. Any extra arguments not used by `dotnet ef` are forwarded to the app.
+
+### [Visual Studio](#tab/vs)
+
+```powershell
+Update-Database -Args '--environment Production'
+```
+
+***
+
+  [1]: xref:core/managing-schemas/migrations/index
+  [2]: xref:core/dbcontext-configuration/index
+  [3]: /aspnet/core/fundamentals/host/web-host
+  [4]: /aspnet/core/fundamentals/host/generic-host
+  [5]: xref:core/dbcontext-configuration/index#constructor-argument
+  [6]: xref:core/dbcontext-configuration/index#using-dbcontext-with-dependency-injection
+  [7]: xref:core/dbcontext-configuration/index#onconfiguring
diff --git a/entity-framework/core/cli/dotnet.md b/entity-framework/core/cli/dotnet.md
new file mode 100644
index 0000000000..4d28cf8cb0
--- /dev/null
+++ b/entity-framework/core/cli/dotnet.md
@@ -0,0 +1,393 @@
+---
+title: EF Core tools reference (.NET CLI) - EF Core
+description: Reference guide for the Entity Framework Core .NET CLI tools
+author: SamMonoRT
+ms.date: 11/08/2024
+uid: core/cli/dotnet
+---
+
+# Entity Framework Core tools reference - .NET CLI
+
+The command-line interface (CLI) tools for Entity Framework Core perform design-time development tasks. For example, they create [migrations](/aspnet/core/data/ef-mvc/migrations), apply migrations, and generate code for a model based on an existing database. The commands are an extension to the cross-platform [dotnet](/dotnet/core/tools) command, which is part of the [.NET SDK](https://www.microsoft.com/net/core). These tools work with .NET projects.
+
+When using Visual Studio, consider using the [Package Manager Console tools](xref:core/cli/powershell) instead of the CLI tools. Package Manager Console tools automatically:
+
+* Works with the current project selected in the **Package Manager Console** without requiring that you manually switch directories.
+* Opens files generated by a command after the command is completed.
+* Provides tab completion of commands, parameters, project names, context types, and migration names.
+
+## Installing the tools
+
+`dotnet ef` can be installed as either a global or local tool. Most developers prefer installing `dotnet ef` as a global tool using the following command:
+
+```dotnetcli
+dotnet tool install --global dotnet-ef
+```
+
+To use it as a local tool, restore the dependencies of a project that declares it as a tooling dependency using a [tool manifest file](/dotnet/core/tools/global-tools#install-a-local-tool).
+
+Update the tool using the following command:
+
+```dotnetcli
+dotnet tool update --global dotnet-ef
+```
+
+Before you can use the tools on a specific project, you'll need to add the `Microsoft.EntityFrameworkCore.Design` package to it.
+
+```dotnetcli
+dotnet add package Microsoft.EntityFrameworkCore.Design
+```
+
+### Verify installation
+
+Run the following commands to verify that EF Core CLI tools are correctly installed:
+
+  ```dotnetcli
+  dotnet ef
+  ```
+
+The output from the command identifies the version of the tools in use:
+
+```output
+
+                     _/\__
+               ---==/    \\
+         ___  ___   |.    \|\
+        | __|| __|  |  )   \\\
+        | _| | _|   \_/ |  //|\\
+        |___||_|       /   \\\/\\
+
+Entity Framework Core .NET Command-line Tools 2.1.3-rtm-32065
+
+<Usage documentation follows, not shown.>
+```
+
+## Update the tools
+
+Use `dotnet tool update --global dotnet-ef` to update the global tools to the latest available version. If you have the tools installed locally in your project use `dotnet tool update dotnet-ef`. Install a specific version by appending `--version <VERSION>` to your command. See the [Update](/dotnet/core/tools/dotnet-tool-update) section of the dotnet tool documentation for more details.
+
+## Using the tools
+
+Before using the tools, you might have to create a startup project or set the environment.
+
+### Target project and startup project
+
+The commands refer to a *project* and a *startup project*.
+
+* The *project* is also known as the *target project* because it's where the commands add or remove files. By default, the project in the current directory is the target project. You can specify a different project as target project by using the <nobr>`--project`</nobr> option.
+
+* The *startup project* is the one that the tools build and run. The tools have to execute application code at design time to get information about the project, such as the database connection string and the configuration of the model. By default, the project in the current directory is the startup project. You can specify a different project as startup project by using the <nobr>`--startup-project`</nobr> option.
+
+The startup project and target project are often the same project. A typical scenario where they are separate projects is when:
+
+* The EF Core context and entity classes are in a .NET class library.
+* A .NET console app or web app references the class library.
+
+It's also possible to [put migrations code in a class library separate from the EF Core context](xref:core/managing-schemas/migrations/projects).
+
+### Other target frameworks
+
+The CLI tools work with .NET projects and .NET Framework projects. Apps that have the EF Core model in a .NET Standard class library might not have a .NET or .NET Framework project. For example, this is true of Xamarin and Universal Windows Platform apps. In such cases, you can create a .NET console app project whose only purpose is to act as startup project for the tools. The project can be a dummy project with no real code &mdash; it is only needed to provide a target for the tooling.
+
+> [!IMPORTANT]
+> Xamarin.Android, Xamarin.iOS, Xamarin.Mac are now integrated directly into .NET (starting with .NET 6) as .NET for Android, .NET for iOS, and .NET for macOS. If you're building with these project types today, they should be upgraded to .NET SDK-style projects for continued support. For more information about upgrading Xamarin projects to .NET, see the [Upgrade from Xamarin to .NET & .NET MAUI](/dotnet/maui/migration) documentation.
+
+Why is a dummy project required? As mentioned earlier, the tools have to execute application code at design time. To do that, they need to use the .NET runtime. When the EF Core model is in a project that targets .NET or .NET Framework, the EF Core tools borrow the runtime from the project. They can't do that if the EF Core model is in a .NET Standard class library. The .NET Standard is not an actual .NET implementation; it's a specification of a set of APIs that .NET implementations must support. Therefore .NET Standard is not sufficient for the EF Core tools to execute application code. The dummy project you create to use as startup project provides a concrete target platform into which the tools can load the .NET Standard class library.
+
+### ASP.NET Core environment
+
+You can specify [the environment](/aspnet/core/fundamentals/environments) for ASP.NET Core projects on the command-line. This and any additional arguments are passed into Program.CreateHostBuilder.
+
+```dotnetcli
+dotnet ef database update -- --environment Production
+```
+
+> [!TIP]
+> The `--` token directs `dotnet ef` to treat everything that follows as an argument and not try to parse them as options. Any extra arguments not used by `dotnet ef` are forwarded to the app.
+
+## Common options
+
+| Option                                         | Short             | Description                                                                                                                                                                                                                                                   |
+|:-----------------------------------------------|:------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| <nobr>`--json`</nobr>                          |                   | Show JSON output.                                                                                                                                                                                                                                             |
+| <nobr>`--context <DBCONTEXT>`</nobr>           | <nobr>`-c`</nobr> | The `DbContext` class to use. Class name only or fully qualified with namespaces.  If this option is omitted, EF Core will find the context class. If there are multiple context classes, this option is required.                                            |
+| <nobr>`--project <PROJECT>`</nobr>             | `-p`              | Relative path to the project folder of the target project.  Default value is the current folder.                                                                                                                                                              |
+| <nobr>`--startup-project <PROJECT>`</nobr>     | `-s`              | Relative path to the project folder of the startup project. Default value is the current folder.                                                                                                                                                              |
+| <nobr>`--framework <FRAMEWORK>`</nobr>         |                   | The [Target Framework Moniker](/dotnet/standard/frameworks#supported-target-framework-versions) for the [target framework](/dotnet/standard/frameworks).  Use when the project file specifies multiple target frameworks, and you want to select one of them. |
+| <nobr>`--configuration <CONFIGURATION>`</nobr> |                   | The build configuration, for example: `Debug` or `Release`.                                                                                                                                                                                                   |
+| <nobr>`--runtime <IDENTIFIER>`</nobr>          |                   | The identifier of the target runtime to restore packages for. For a list of Runtime Identifiers (RIDs), see the [RID catalog](/dotnet/core/rid-catalog).                                                                                                      |
+| <nobr>`--no-build`</nobr>                      |                   | Don't build the project. Intended to be used when the build is up-to-date.                                                                                                                                                                                    |
+| <nobr>`--help`</nobr>                          | `-h`              | Show help information.                                                                                                                                                                                                                                        |
+| <nobr>`--verbose`</nobr>                       | `-v`              | Show verbose output.                                                                                                                                                                                                                                          |
+| <nobr>`--no-color`</nobr>                      |                   | Don't colorize output.                                                                                                                                                                                                                                        |
+| <nobr>`--prefix-output`</nobr>                 |                   | Prefix output with level.                                                                                                                                                                                                                                     |
+
+Any additional arguments are passed to the application.
+
+## `dotnet ef database drop`
+
+Deletes the database.
+
+Options:
+
+| Option                                    | Short             | Description                                                                                                                     |
+|:------------------------------------------|:------------------|:--------------------------------------------------------------------------------------------------------------------------------|
+| <nobr>`--force`</nobr>                    | <nobr>`-f`</nobr> | Don't confirm.                                                                                                                  |
+| <nobr>`--dry-run`</nobr>                  |                   | Show which database would be dropped, but don't drop it.                                                                        |
+| <nobr>`--connection <CONNECTION>`</nobr>  |                   | The connection string to the database. Defaults to the one specified in `AddDbContext` or `OnConfiguring`. Added in EF Core 11. |
+
+The [common options](#common-options) are listed above.
+
+## `dotnet ef database update`
+
+Updates the database to the last migration or to a specified migration.
+
+Arguments:
+
+| Argument                   | Description                                                                                                                                                                                                                                                     |
+|:---------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| <nobr>`<MIGRATION>`</nobr> | The target migration. Migrations may be identified by name or by ID. The number 0 is a special case that means *before the first migration* and causes all migrations to be reverted. If no migration is specified, the command defaults to the last migration. |
+
+Options:
+
+| Option                                    | Description                                                                                                                      |
+|:------------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------|
+|  <nobr>`--connection <CONNECTION>`</nobr> | The connection string to the database. Defaults to the one specified in `AddDbContext` or `OnConfiguring`. |
+
+The [common options](#common-options) are listed above.
+
+The following examples update the database to a specified migration. The first uses the migration name and the second uses the migration ID and a specified connection:
+
+```dotnetcli
+dotnet ef database update InitialCreate
+dotnet ef database update 20180904195021_InitialCreate --connection your_connection_string
+```
+
+## `dotnet ef dbcontext info`
+
+Gets information about a `DbContext` type.
+
+The [common options](#common-options) are listed above.
+
+## `dotnet ef dbcontext list`
+
+Lists available `DbContext` types.
+
+The [common options](#common-options) are listed above.
+
+<a name="optimize"></a>
+
+## `dotnet ef dbcontext optimize`
+
+Generates a compiled version of the model used by the `DbContext` and precompiles queries.
+
+See [Compiled models](xref:core/performance/advanced-performance-topics#compiled-models) for more information.
+
+Options:
+
+| Option                                               | Short | Description                                                                                                                                                                    |
+|:-----------------------------------------------------|:------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| <nobr>`--output-dir <PATH>`</nobr>       | `-o`              | The directory to put files in. Paths are relative to the project directory.                                                                                       |
+| <nobr>`--namespace <NAMESPACE>`</nobr>   | `-n`              | The namespace to use for all generated classes. Defaults to generated from the root namespace and the output directory plus `CompiledModels`.                                  |
+| <nobr>`--suffix <SUFFIX>`</nobr>         |                   | The suffix to attach to the name of all the generated files. E.g. `.g` could be used to indicate that these files contain generated code                                            |
+| <nobr>`--no-scaffold`</nobr>             |                   | Don't generate a compiled model. This is used when the compiled model has already been generated.                                                                       |
+| <nobr>`--precompile-queries`</nobr>      |                   | Generate precompiled queries. This is required for NativeAOT compilation if the target project contains any queries                                                           |
+| <nobr>`--nativeaot`</nobr>               |                   | Generate additional code in the compiled model required for NativeAOT compilation and precompiled queries                                                           |
+
+> [!NOTE]
+> NativeAOT support and precompiled queries are considered experimental in EF 9 and could change dramatically in the next release.
+
+The [common options](#common-options) are listed above.
+
+The following example uses the default settings and works if there is only one `DbContext` in the project:
+
+```dotnetcli
+dotnet ef dbcontext optimize
+```
+
+The following example optimizes the model for the context with the specified name and places it in a separate folder and namespace:
+
+```dotnetcli
+dotnet ef dbcontext optimize -o Models -n BlogModels -c BlogContext
+```
+
+## `dotnet ef dbcontext scaffold`
+
+Generates code for a `DbContext` and entity types for a database. In order for this command to generate an entity type, the database table must have a primary key.
+
+Arguments:
+
+| Argument                    | Description                                                                                                                                                                                                             |
+|:----------------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| <nobr>`<CONNECTION>`</nobr> | The connection string to the database. For ASP.NET Core 2.x projects, the value can be *name=\<name of connection string>*. In that case the name comes from the configuration sources that are set up for the project. |
+| `<PROVIDER>`                | The provider to use. Typically this is the name of the NuGet package, for example: `Microsoft.EntityFrameworkCore.SqlServer`.                                                                                           |
+
+Options:
+
+| Option                                         | Short             | Description                                                                                                                                                                                                                                                                                                                             |
+|:-----------------------------------------------|:------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| <nobr>`--data-annotations`</nobr>              | <nobr>`-d`</nobr> | Use attributes to configure the model (where possible). If this option is omitted, only the fluent API is used.                                                                                                                                                                                                                         |
+| <nobr>`--context <NAME>`</nobr>                | `-c`              | The name of the `DbContext` class to generate.                                                                                                                                                                                                                                                                                          |
+| <nobr>`--context-dir <PATH>`</nobr>            |                   | The directory to put the `DbContext` class file in. Paths are relative to the project directory. Namespaces are derived from the folder names.                                                                                                                                                                                          |
+| <nobr>`--context-namespace <NAMESPACE>`</nobr> |                   | The namespace to use for the generated `DbContext` class. Note: overrides `--namespace`.                                                                                                                                                                                                                                                |
+| <nobr>`--force`</nobr>                         | `-f`              | Overwrite existing files.                                                                                                                                                                                                                                                                                                               |
+| <nobr>`--output-dir <PATH>`</nobr>             | `-o`              | The directory to put entity class files in. Paths are relative to the project directory.                                                                                                                                                                                                                                                |
+| <nobr>`--namespace <NAMESPACE>`</nobr>         | `-n`              | The namespace to use for all generated classes. Defaults to generated from the root namespace and the output directory.                                                                                                                                                                                                                 |
+| <nobr>`--schema <SCHEMA_NAME>...`</nobr>       |                   | The schemas of tables and views to generate entity types for. To specify multiple schemas, repeat `--schema` for each one. If this option is omitted, all schemas are included. If this option is used, then all tables and views in the schemas will be included in the model, even if they are not explicitly included using --table. |
+| <nobr>`--table <TABLE_NAME>...`</nobr>         | `-t`              | The tables and views to generate entity types for. To specify multiple tables, repeat `-t` or `--table` for each one. Tables or views in a specific schema can be included using the 'schema.table' or 'schema.view' format. If this option is omitted, all tables and views are included.                                              |
+| <nobr>`--use-database-names`</nobr>            |                   | Use table, view, sequence, and column names exactly as they appear in the database. If this option is omitted, database names are changed to more closely conform to C# name style conventions.                                                                                                                                         |
+| <nobr>`--no-onconfiguring`</nobr>              |                   | Suppresses generation of the `OnConfiguring` method in the generated `DbContext` class.                                                                                                                                                                                                                                                 |
+| <nobr>`--no-pluralize`</nobr>                  |                   | Don't use the pluralizer.                                                                                                                                                                                                                                                                                                               |
+
+The [common options](#common-options) are listed above.
+
+The following example scaffolds all schemas and tables and puts the new files in the *Models* folder.
+
+```dotnetcli
+dotnet ef dbcontext scaffold "Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;" Microsoft.EntityFrameworkCore.SqlServer -o Models
+```
+
+The following example scaffolds only selected tables and creates the context in a separate folder with a specified name and namespace:
+
+```dotnetcli
+dotnet ef dbcontext scaffold "Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;" Microsoft.EntityFrameworkCore.SqlServer -o Models -t Blog -t Post --context-dir Context -c BlogContext --context-namespace New.Namespace
+```
+
+The following example reads the connection string from the project's configuration set using the [Secret Manager tool](/aspnet/core/security/app-secrets#secret-manager).
+
+```dotnetcli
+dotnet user-secrets set ConnectionStrings:Blogging "Data Source=(localdb)\MSSQLLocalDB;Initial Catalog=Blogging"
+dotnet ef dbcontext scaffold Name=ConnectionStrings:Blogging Microsoft.EntityFrameworkCore.SqlServer
+```
+
+The following example skips scaffolding an `OnConfiguring` method. This can be useful when you want to configure the DbContext outside of the class. For example, ASP.NET Core apps typically configure it in Startup.ConfigureServices.
+
+```dotnetcli
+dotnet ef dbcontext scaffold "Server=(localdb)\mssqllocaldb;Database=Blogging;Integrated Security=true;" Microsoft.EntityFrameworkCore.SqlServer --no-onconfiguring
+```
+
+## `dotnet ef dbcontext script`
+
+Generates a SQL script from the DbContext. Bypasses any migrations.
+
+Options:
+
+| Option                         | Short             | Description                      |
+| ------------------------------ | ----------------- | -------------------------------- |
+| <nobr>`--output <FILE>`</nobr> | <nobr>`-o`</nobr> | The file to write the result to. |
+
+The [common options](#common-options) are listed above.
+
+## `dotnet ef migrations add`
+
+Adds a new migration.
+
+Arguments:
+
+| Argument              | Description                |
+|:----------------------|:---------------------------|
+| <nobr>`<NAME>`</nobr> | The name of the migration. |
+
+Options:
+
+| Option                                 | Short             | Description                                                                                                            |
+|:---------------------------------------|:------------------|:-----------------------------------------------------------------------------------------------------------------------|
+| <nobr>`--output-dir <PATH>`</nobr>     | <nobr>`-o`</nobr> | The directory use to output the files. Paths are relative to the target project directory. Defaults to "Migrations".   |
+| <nobr>`--namespace <NAMESPACE>`</nobr> | `-n`              | The namespace to use for the generated classes. Defaults to generated from the output directory.  |
+
+The [common options](#common-options) are listed above.
+
+## `dotnet ef migrations bundle`
+
+Creates an executable to update the database.
+
+Options:
+
+Option                                               | Short             | Description
+---------------------------------------------------- | ----------------- | -----------
+`--output <FILE>`                                    | <nobr>`-o`</nobr> | The path of executable file to create.
+`--force`                                            | `-f`              | Overwrite existing files.
+`--self-contained`                                   |                   | Also bundle the .NET runtime so it doesn't need to be installed on the machine.
+<nobr>`--target-runtime <RUNTIME_IDENTIFIER>`</nobr> | `-r`              | The target runtime to bundle for.
+
+The [common options](#common-options) are listed above.
+
+## `dotnet ef migrations has-pending-model-changes`
+
+> [!NOTE]
+> This command was added in EF Core 8.0.
+
+Checks if any changes have been made to the model since the last migration.
+
+Options:
+
+The [common options](#common-options) are listed above.
+
+## `dotnet ef migrations list`
+
+Lists available migrations.
+
+Options:
+
+| Option                                   | Description                                                                                                                  |
+| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| <nobr>`--connection <CONNECTION>`</nobr> | The connection string to the database. Defaults to the one specified in AddDbContext or OnConfiguring. |
+| <nobr>`--no-connect`</nobr>              | Don't connect to the database.                                                                          |
+
+The [common options](#common-options) are listed above.
+
+## `dotnet ef migrations remove`
+
+Removes the last migration, rolling back the code changes that were done for the latest migration.
+
+Options:
+
+| Option                                   | Short             | Description                                                                                          |
+|:-----------------------------------------|:------------------|:-----------------------------------------------------------------------------------------------------|
+| <nobr>`--force`</nobr>                   | <nobr>`-f`</nobr> | Revert the latest migration, rolling back both code and database changes that were done for the latest migration. Continues to roll back only the code changes if an error occurs while connecting to the database. |
+| <nobr>`--connection <CONNECTION>`</nobr> |                   | The connection string to the database. Defaults to the one specified in `AddDbContext` or `OnConfiguring`. Added in EF Core 11. |
+| <nobr>`--offline`</nobr>                 |                   | Remove the migration without connecting to the database. Added in EF Core 11.                        |
+
+The [common options](#common-options) are listed above.
+
+> [!NOTE]
+> The `--offline` and `--force` options cannot be used together, since `--force` requires a database connection to check if the migration has been applied before reverting it.
+
+## `dotnet ef migrations script`
+
+Generates a SQL script from migrations.
+
+Arguments:
+
+| Argument              | Description                                                                                                                                                   |
+|:----------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| <nobr>`<FROM>`</nobr> | The starting migration. Migrations may be identified by name or by ID. The number 0 is a special case that means *before the first migration*. Defaults to 0. |
+| <nobr>`<TO>`</nobr>   | The ending migration. Defaults to the last migration.                                                                                                         |
+
+Options:
+
+| Option                           | Short             | Description                                                        |
+|:---------------------------------|:------------------|:-------------------------------------------------------------------|
+| <nobr>`--output <FILE>`</nobr>   | <nobr>`-o`</nobr> | The file to write the script to.                                   |
+| <nobr>`--idempotent`</nobr>      | `-i`              | Generate a script that can be used on a database at any migration. |
+| <nobr>`--no-transactions`</nobr> |                   | Don't generate SQL transaction statements.   |
+
+The [common options](#common-options) are listed above.
+
+The following example creates a script for the InitialCreate migration:
+
+```dotnetcli
+dotnet ef migrations script 0 InitialCreate
+```
+
+The following example creates a script for all migrations after the InitialCreate migration.
+
+```dotnetcli
+dotnet ef migrations script 20180904195021_InitialCreate
+```
+
+## Additional resources
+
+* [Migrations](xref:core/managing-schemas/migrations/index)
+* [Reverse Engineering](xref:core/managing-schemas/scaffolding)
+* [Compiled models](xref:core/performance/advanced-performance-topics#compiled-models)
diff --git a/entity-framework/core/cli/index.md b/entity-framework/core/cli/index.md
new file mode 100644
index 0000000000..95d1d226c7
--- /dev/null
+++ b/entity-framework/core/cli/index.md
@@ -0,0 +1,22 @@
+---
+title: Entity Framework Core tools reference - EF Core
+description: Reference guide for the Entity Framework Core CLI tool and the Visual Studio Package Manager Console
+author: SamMonoRT
+ms.date: 09/19/2018
+uid: core/cli/index
+---
+
+# Entity Framework Core tools reference
+
+The Entity Framework Core tools help with design-time development tasks. They're primarily used to manage Migrations and to scaffold a `DbContext` and entity types by reverse engineering the schema of a database.
+
+Either of the following tools can be installed, as both tools expose the same functionality:
+
+* The [EF Core Package Manager Console tools](xref:core/cli/powershell) run in the [Package Manager Console](/nuget/tools/package-manager-console) in Visual Studio. We recommend using these tools if you are developing in Visual Studio as they provide a more integrated experience.
+
+* The [EF Core .NET command-line interface (CLI) tools](xref:core/cli/dotnet) are an extension to the cross-platform [.NET CLI tools](/dotnet/core/tools/). These tools require a .NET SDK project (one with `Sdk="Microsoft.NET.Sdk"` or similar in the project file).
+
+## Next steps
+
+* [EF Core Package Manager Console tools reference](xref:core/cli/powershell)
+* [EF Core .NET CLI tools reference](xref:core/cli/dotnet)
diff --git a/entity-framework/core/cli/msbuild.md b/entity-framework/core/cli/msbuild.md
new file mode 100644
index 0000000000..7302fa5904
--- /dev/null
+++ b/entity-framework/core/cli/msbuild.md
@@ -0,0 +1,53 @@
+---
+title: EF Core MSBuild tasks - EF Core
+description: Reference guide for the Entity Framework Core .NET MSBuild tasks
+author: AndriySvyryd
+ms.date: 03/04/2026
+uid: core/cli/msbuild
+---
+
+# Entity Framework Core MSBuild integration
+
+Starting with EF 9, you can use an MSBuild task to generate the compiled model and precompiled queries automatically either when the project is built or when it's published. This is mainly intended to be used with NativeAOT publishing.
+
+> [!WARNING]
+> NativeAOT support and the MSBuild integration are experimental features, and are not yet suited for production use.
+
+## Installing the tasks
+
+To get started, install the [Microsoft.EntityFrameworkCore.Tasks](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Tasks) NuGet package. For example:
+
+```dotnetcli
+dotnet add package Microsoft.EntityFrameworkCore.Tasks
+```
+
+> [!NOTE]
+> **Every** project that needs to be compiled with generated files should reference the NuGet package, it is not transitive by default.
+
+## Using the tasks
+
+If the project specifies `<PublishAot>true</PublishAot>` then by default the MSBuild task will generate a compiled model and precompiled queries during publishing. Otherwise, you can set the following properties to control the generation behavior:
+
+| MSBuild property   | Description                                                                                                                                                                                                     |
+|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| EFOptimizeContext  | Set to `true` to enable MSBuild integration. **EF Core 9-10 only; removed in EF Core 11.** |
+| EFScaffoldModelStage | Set to `publish`, `build` or `none` to indicate at which stage the compiled model will be generated. Defaults to `publish`.                        |
+| EFPrecompileQueriesStage | Set to `publish`, `build` or `none` to indicate at which stage the precompiled queries will be generated. Defaults to `publish`.                        |
+| DbContextName      | The derived `DbContext` class to use. Class name only or fully qualified with namespaces. If this option is omitted, EF Core will perform generation for all context classes in the project. |
+| EFTargetNamespace  | The namespace to use for all generated classes. If this option is omitted, EF Core will use `$(RootNamespace)`.                      |
+| EFOutputDir        | The folder to put the generated files before the project is compiled. If this option is omitted, EF Core will use `$(IntermediateOutputPath)`.                      |
+| EFNullable        | Whether nullable reference types will be used in the generated code. If this option is omitted, EF Core will use `$(Nullable)`.                      |
+
+> [!NOTE]
+> Starting with EF Core 11, the `EFOptimizeContext` property has been [removed](xref:core/what-is-new/ef-core-11.0/breaking-changes#ef-optimize-context-removed). The `EFScaffoldModelStage` and `EFPrecompileQueriesStage` properties now work independently and don't require an additional enablement flag.
+
+## Limitations
+
+* When using the integration during the `publish` stage also set the rid in the startup project (e.g. \<RuntimeIdentifier\>win-x64\</RuntimeIdentifier\>)
+* A different startup project cannot be specified when using this approach as it would introduce an inverse build dependency. This means that the context project needs to be autosuficient in terms of configuration, so if your app normally configures the context using a host builder in a different project you'd need to [implement _IDesignTimeDbContextFactory&lt;TContext&gt;_](xref:core/cli/dbcontext-creation#from-a-design-time-factory) in the context project.
+* Since the project needs to be compilable before the compiled model is generated this approach doesn't support partial method implementations for customization of the compiled model.
+* Currently, this will always generate additional code in the compiled model that's required for NativeAOT. If you are not planning to enable NativeAOT then [generate the compiled model using the CLI tools](xref:core/cli/dotnet#optimize).
+
+## Additional resources
+
+* [Compiled models](xref:core/performance/advanced-performance-topics#compiled-models)
diff --git a/entity-framework/core/cli/powershell.md b/entity-framework/core/cli/powershell.md
new file mode 100644
index 0000000000..8868bcd962
--- /dev/null
+++ b/entity-framework/core/cli/powershell.md
@@ -0,0 +1,342 @@
+---
+title: EF Core tools reference (Package Manager Console) - EF Core
+description: Reference guide for the Entity Framework Core Visual Studio Package Manager Console
+author: SamMonoRT
+ms.date: 11/08/2024
+uid: core/cli/powershell
+ms.custom: sfi-ropc-nochange
+---
+# Entity Framework Core tools reference - Package Manager Console in Visual Studio
+
+The Package Manager Console (PMC) tools for Entity Framework Core perform design-time development tasks. For example, they create [migrations](/aspnet/core/data/ef-mvc/migrations), apply migrations, and generate code for a model based on an existing database. The commands run inside of Visual Studio using the [Package Manager Console](/nuget/tools/package-manager-console). These tools work with both .NET Framework and .NET projects.
+
+If you aren't using Visual Studio, we recommend the [EF Core Command-line Tools](xref:core/cli/dotnet) instead. The .NET CLI tools are cross-platform and run inside a command prompt.
+
+[!INCLUDE [managed-identities-test-non-production](~/core/includes/managed-identities-test-non-production.md)]
+
+## Install the tools
+
+Install the Package Manager Console tools by running the following command in **Package Manager Console**:
+
+```powershell
+Install-Package Microsoft.EntityFrameworkCore.Tools
+```
+
+Update the tools by running the following command in **Package Manager Console**.
+
+```powershell
+Update-Package Microsoft.EntityFrameworkCore.Tools
+```
+
+### Verify the installation
+
+Verify that the tools are installed by running this command:
+
+```powershell
+Get-Help about_EntityFrameworkCore
+```
+
+The output looks like this (it doesn't tell you which version of the tools you're using):
+
+```output
+
+                     _/\__
+               ---==/    \\
+         ___  ___   |.    \|\
+        | __|| __|  |  )   \\\
+        | _| | _|   \_/ |  //|\\
+        |___||_|       /   \\\/\\
+
+TOPIC
+    about_EntityFrameworkCore
+
+SHORT DESCRIPTION
+    Provides information about the Entity Framework Core Package Manager Console Tools.
+
+<A list of available commands follows, omitted here.>
+```
+
+## Use the tools
+
+Before using the tools:
+
+* Understand the difference between target and startup project.
+* Learn how to use the tools with .NET Standard class libraries.
+* For ASP.NET Core projects, set the environment.
+
+### Target and startup project
+
+The commands refer to a *project* and a *startup project*.
+
+* The *project* is also known as the *target project* because it's where the commands add or remove files. By default, the **Default project** selected in **Package Manager Console** is the target project. You can specify a different project as target project by using the <nobr>`-Project`</nobr> parameter.
+
+* The *startup project* is the one that the tools build and run. The tools have to execute application code at design time to get information about the project, such as the database connection string and the configuration of the model. By default, the **Startup Project** in **Solution Explorer** is the startup project. You can specify a different project as startup project by using the <nobr>`-StartupProject`</nobr> parameter.
+
+The startup project and target project are often the same project. A typical scenario where they are separate projects is when:
+
+* The EF Core context and entity classes are in a .NET class library.
+* A .NET console app or web app references the class library.
+
+It's also possible to [put migrations code in a class library separate from the EF Core context](xref:core/managing-schemas/migrations/projects).
+
+### Other target frameworks
+
+The Package Manager Console tools work with .NET or .NET Framework projects. Apps that have the EF Core model in a .NET Standard class library might not have a .NET or .NET Framework project. For example, this is true of Xamarin and Universal Windows Platform apps. In such cases, you can create a .NET or .NET Framework console app project whose only purpose is to act as startup project for the tools. The project can be a dummy project with no real code &mdash; it is only needed to provide a target for the tooling.
+
+> [!IMPORTANT]
+> Xamarin.Android, Xamarin.iOS, Xamarin.Mac are now integrated directly into .NET (starting with .NET 6) as .NET for Android, .NET for iOS, and .NET for macOS. If you're building with these project types today, they should be upgraded to .NET SDK-style projects for continued support. For more information about upgrading Xamarin projects to .NET, see the [Upgrade from Xamarin to .NET & .NET MAUI](/dotnet/maui/migration) documentation.
+
+Why is a dummy project required? As mentioned earlier, the tools have to execute application code at design time. To do that, they need to use the .NET or .NET Framework runtime. When the EF Core model is in a project that targets .NET or .NET Framework, the EF Core tools borrow the runtime from the project. They can't do that if the EF Core model is in a .NET Standard class library. The .NET Standard is not an actual .NET implementation; it's a specification of a set of APIs that .NET implementations must support. Therefore .NET Standard is not sufficient for the EF Core tools to execute application code. The dummy project you create to use as startup project provides a concrete target platform into which the tools can load the .NET Standard class library.
+
+### ASP.NET Core environment
+
+You can specify [the environment](/aspnet/core/fundamentals/environments) for ASP.NET Core projects on the command-line. This and any additional arguments are passed into Program.CreateHostBuilder.
+
+```powershell
+Update-Database -Args '--environment Production'
+```
+
+## Common parameters
+
+The following table shows parameters that are common to all of the EF Core commands:
+
+| Parameter                 | Description                                                                                                                                                                                                          |
+|:--------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| <nobr>`-Context <String>`</nobr>        | The `DbContext` class to use. Class name only or fully qualified with namespaces.  If this parameter is omitted, EF Core finds the context class. If there are multiple context classes, this parameter is required. |
+| <nobr>`-Project <String>`</nobr>        | The target project. If this parameter is omitted, the **Default project** for **Package Manager Console** is used as the target project.                                                                             |
+| <nobr>`-StartupProject <String>`</nobr> | The startup project. If this parameter is omitted, the **Startup project** in **Solution properties** is used as the target project.                                                                                 |
+| <nobr>`-Args <String>`</nobr>           | Arguments passed to the application.                                                                                                                                                           |
+| `-Verbose`                              | Show verbose output.                                                                                                                                                                                                 |
+
+To show help information about a command, use PowerShell's `Get-Help` command.
+
+> [!TIP]
+> The `Context`, `Project`, and `StartupProject` parameters support tab-expansion.
+
+## Add-Migration
+
+Adds a new migration.
+
+Parameters:
+
+| Parameter                          | Description                                                                                                             |
+|:-----------------------------------|:------------------------------------------------------------------------------------------------------------------------|
+| <nobr>`-Name <String>`</nobr>      | The name of the migration. This is a positional parameter and is required.                                              |
+| <nobr>`-OutputDir <String>`</nobr> | The directory use to output the files. Paths are relative to the target project directory. Defaults to "Migrations". |
+| <nobr>`-Namespace <String>`</nobr> | The namespace to use for the generated classes. Defaults to generated from the output directory.  |
+
+The [common parameters](#common-parameters) are listed above.
+
+## Bundle-Migration
+
+Creates an executable to update the database.
+
+Parameters:
+
+Parameter                              | Description
+-------------------------------------- | -----------
+`-Output <String>`                     | The path of executable file to create.
+`-Force`                               | Overwrite existing files.
+`-SelfContained`                       | Also bundle the .NET runtime so it doesn't need to be installed on the machine.
+<nobr>`-TargetRuntime <String>`</nobr> | The target runtime to bundle for.
+`-Framework <String>`                  | The target framework. Defaults to the first one in the project.
+
+The [common parameters](#common-parameters) are listed above.
+
+## Drop-Database
+
+Drops the database.
+
+Parameters:
+
+| Parameter                           | Description                                                                                                                     |
+|:------------------------------------|:--------------------------------------------------------------------------------------------------------------------------------|
+| <nobr>`-WhatIf`</nobr>              | Show which database would be dropped, but don't drop it.                                                                        |
+| <nobr>`-Connection <String>`</nobr> | The connection string to the database. Defaults to the one specified in `AddDbContext` or `OnConfiguring`. Added in EF Core 11. |
+
+The [common parameters](#common-parameters) are listed above.
+
+## Get-DbContext
+
+Lists and gets information about available `DbContext` types.
+
+The [common parameters](#common-parameters) are listed above.
+
+## Get-Migration
+
+Lists available migrations.
+
+Parameters:
+
+| Parameter                           | Description                                                                                            |
+| ----------------------------------- | ------------------------------------------------------------------------------------------------------ |
+| <nobr>`-Connection <String>`</nobr> | The connection string to the database. Defaults to the one specified in AddDbContext or OnConfiguring. |
+| <nobr>`-NoConnect`</nobr>           | Don't connect to the database.                                                                         |
+
+The [common parameters](#common-parameters) are listed above.
+
+## Optimize-DbContext
+
+Generates a compiled version of the model used by the `DbContext`.
+
+See [Compiled models](xref:core/performance/advanced-performance-topics#compiled-models) for more information.
+
+Parameters:
+
+| Parameter                           | Description                                                                                                                                                                                                                                                             |
+|:------------------------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| <nobr>`-OutputDir <String>`</nobr>  | The directory to put files in. Paths are relative to the project directory.                                                                                                                                                                                             |
+| <nobr>`-Namespace <String>`</nobr>  | The namespace to use for all generated classes. Defaults to generated from the root namespace and the output directory plus `CompiledModels`.                                                                                                                           |
+
+The [common parameters](#common-parameters) are listed above.
+
+> [!NOTE]
+> The PMC tools currently don't support generating code required for NativeAOT compilation and precompiled queries.
+
+The following example uses the defaults and works if there is only one `DbContext` in the project:
+
+```powershell
+Optimize-DbContext
+```
+
+The following example optimizes the model for the context with the specified name and places it in a separate folder and namespace:
+
+```powershell
+Optimize-DbContext -OutputDir Models -Namespace BlogModels -Context BlogContext
+```
+
+## Remove-Migration
+
+Removes the last migration (rolls back the code changes that were done for the migration).
+
+Parameters:
+
+| Parameter                           | Description                                                                                                  |
+|:------------------------------------|:-------------------------------------------------------------------------------------------------------------|
+| <nobr>`-Force`</nobr>               | Revert the migration (roll back the changes that were applied to the database).                              |
+| <nobr>`-Connection <String>`</nobr> | The connection string to the database. Defaults to the one specified in `AddDbContext` or `OnConfiguring`. Added in EF Core 11. |
+| <nobr>`-Offline`</nobr>             | Remove the migration without connecting to the database. Added in EF Core 11.                                |
+
+The [common parameters](#common-parameters) are listed above.
+
+> [!NOTE]
+> The `-Offline` and `-Force` parameters cannot be used together, since `-Force` requires a database connection to check if the migration has been applied before reverting it.
+
+## Scaffold-DbContext
+
+Generates code for a `DbContext` and entity types for a database. In order for `Scaffold-DbContext` to generate an entity type, the database table must have a primary key.
+
+Parameters:
+
+| Parameter                                 | Description                                                                                                                                                                                                                                                                  |
+|:------------------------------------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| <nobr>`-Connection <String>`</nobr>       | The connection string to the database. The value can be *name=\<name of connection string>*. In that case the name comes from the [configuration sources](xref:core/miscellaneous/connection-strings#aspnet-core) that are set up for the project. This is a positional parameter and is required.      |
+| <nobr>`-Provider <String>`</nobr>         | The provider to use. Typically this is the name of the NuGet package, for example: `Microsoft.EntityFrameworkCore.SqlServer`. This is a positional parameter and is required.                                                                                                |
+| <nobr>`-OutputDir <String>`</nobr>        | The directory to put entity class files in. Paths are relative to the project directory.                                                                                                                                                                                     |
+| <nobr>`-ContextDir <String>`</nobr>       | The directory to put the `DbContext` file in. Paths are relative to the project directory.                                                                                                                                                                                   |
+| <nobr>`-Namespace <String>`</nobr>        | The namespace to use for all generated classes. Defaults to generated from the root namespace and the output directory.                                                                                                                                                      |
+| <nobr>`-ContextNamespace <String>`</nobr> | The namespace to use for the generated `DbContext` class. Note: overrides `-Namespace`.                                                                                                                                                                                      |
+| <nobr>`-Context <String>`</nobr>          | The name of the `DbContext` class to generate.                                                                                                                                                                                                                               |
+| <nobr>`-Schemas <String[]>`</nobr>        | The schemas of tables and views to generate entity types for. If this parameter is omitted, all schemas are included. If this option is used, then all tables and views in the schemas will be included in the model, even if they are not explicitly included using -Table. |
+| <nobr>`-Tables <String[]>`</nobr>         | The tables and views to generate entity types for. Tables or views in a specific schema can be included using the 'schema.table' or 'schema.view' format. If this parameter is omitted, all tables and views are included.                                                   |
+| <nobr>`-DataAnnotations`</nobr>           | Use attributes to configure the model (where possible). If this parameter is omitted, only the fluent API is used.                                                                                                                                                           |
+| <nobr>`-UseDatabaseNames`</nobr>          | Use table, view, sequence, and column names exactly as they appear in the database. If this parameter is omitted, database names are changed to more closely conform to C# name style conventions.                                                                           |
+| <nobr>`-Force`</nobr>                     | Overwrite existing files.                                                                                                                                                                                                                                                    |
+| <nobr>`-NoOnConfiguring`</nobr>           | Don't generate `DbContext.OnConfiguring`.                                                                                                                                                                                                                                    |
+| <nobr>`-NoPluralize`</nobr>               | Don't use the pluralizer.                                                                                                                                                                                                                                                    |
+
+The [common parameters](#common-parameters) are listed above.
+
+Example:
+
+```powershell
+Scaffold-DbContext "Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;" Microsoft.EntityFrameworkCore.SqlServer -OutputDir Models
+```
+
+Example that scaffolds only selected tables and creates the context in a separate folder with a specified name and namespace:
+
+```powershell
+Scaffold-DbContext "Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;" Microsoft.EntityFrameworkCore.SqlServer -OutputDir Models -Tables "Blog","Post" -ContextDir Context -Context BlogContext -ContextNamespace New.Namespace
+```
+
+The following example [reads the connection string using Configuration](xref:core/miscellaneous/connection-strings#aspnet-core).
+
+```powershell
+Scaffold-DbContext "Name=ConnectionStrings:Blogging" Microsoft.EntityFrameworkCore.SqlServer
+```
+
+## Script-DbContext
+
+Generates a SQL script from the DbContext. Bypasses any migrations.
+
+Parameters:
+
+| Parameter                       | Description                      |
+| ------------------------------- | -------------------------------- |
+| <nobr>`-Output <String>`</nobr> | The file to write the result to. |
+
+The [common parameters](#common-parameters) are listed above.
+
+## Script-Migration
+
+Generates a SQL script that applies all of the changes from one selected migration to another selected migration.
+
+Parameters:
+
+| Parameter                    | Description                                                                                                                                                                                                                |
+|:------------------------------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| <nobr>`-From <String>`</nobr>   | The starting migration. Migrations may be identified by name or by ID. The number 0 is a special case that means *before the first migration*. Defaults to 0.                                                              |
+| <nobr>`-To <String>`</nobr>     | The ending migration. Defaults to the last migration.                                                                                                                                                                      |
+| <nobr>`-Idempotent`</nobr>      | Generate a script that can be used on a database at any migration.                                                                                                                                                         |
+| <nobr>`-NoTransactions`</nobr>  | Don't generate SQL transaction statements.                                                                                                                                                           |
+| <nobr>`-Output <String>`</nobr> | The file to write the result to. IF this parameter is omitted, the file is created with a generated name in the same folder as the app's runtime files are created, for example: */obj/Debug/netcoreapp2.1/ghbkztfz.sql/*. |
+
+The [common parameters](#common-parameters) are listed above.
+
+> [!TIP]
+> The `To`, `From`, and `Output` parameters support tab-expansion.
+
+The following example creates a script for the InitialCreate migration (from a database without any migrations), using the migration name.
+
+```powershell
+Script-Migration 0 InitialCreate
+```
+
+The following example creates a script for all migrations after the InitialCreate migration, using the migration ID.
+
+```powershell
+Script-Migration 20180904195021_InitialCreate
+```
+
+## Update-Database
+
+Updates the database to the last migration or to a specified migration.
+
+| Parameter                           | Description                                                                                                                                                                                                                                                     |
+|:------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| <nobr>`-Migration <String>`</nobr>  | The target migration. Migrations may be identified by name or by ID. The number 0 is a special case that means *before the first migration* and causes all migrations to be reverted. If no migration is specified, the command defaults to the last migration. |
+| <nobr>`-Connection <String>`</nobr> | The connection string to the database. Defaults to the one specified in `AddDbContext` or `OnConfiguring`.                                                                                                                                |
+
+The [common parameters](#common-parameters) are listed above.
+
+> [!TIP]
+> The `Migration` parameter supports tab-expansion.
+
+The following example reverts all migrations.
+
+```powershell
+Update-Database 0
+```
+
+The following examples update the database to a specified migration. The first uses the migration name and the second uses the migration ID and a specified connection:
+
+```powershell
+Update-Database InitialCreate
+Update-Database 20180904195021_InitialCreate -Connection your_connection_string
+```
+
+## Additional resources
+
+* [Migrations](xref:core/managing-schemas/migrations/index)
+* [Reverse Engineering](xref:core/managing-schemas/scaffolding)
+* [Compiled models](xref:core/performance/advanced-performance-topics#compiled-models)
diff --git a/entity-framework/core/cli/services.md b/entity-framework/core/cli/services.md
new file mode 100644
index 0000000000..dbb3b66be0
--- /dev/null
+++ b/entity-framework/core/cli/services.md
@@ -0,0 +1,62 @@
+---
+title: Design-time services - EF Core
+description: Information on Entity Framework Core design-time services
+author: SamMonoRT
+ms.date: 01/17/2025
+uid: core/cli/services
+---
+# Design-time services
+
+Some services used by the tools are only used at design time. These services are managed separately from EF Core's runtime services to prevent them from being deployed with your app. To override one of these services (for example the service to generate migration files), add an implementation of `IDesignTimeServices` to your startup project.
+
+[!code-csharp[Main](../../../samples/core/Miscellaneous/CommandLine/DesignTimeServices.cs#DesignTimeServices)]
+
+## Referencing Microsoft.EntityFrameworkCore.Design
+
+Microsoft.EntityFrameworkCore.Design is a DevelopmentDependency package. This means that the dependency won't flow transitively into other projects, and that you cannot, by default, reference its types.
+
+In order to reference its types and override design-time services, update the PackageReference item's metadata in your project file.
+
+```xml
+<PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="9.0.0">
+  <PrivateAssets>all</PrivateAssets>
+  <!-- Remove IncludeAssets to allow compiling against the assembly -->
+  <!--<IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>-->
+</PackageReference>
+```
+
+If the package is being referenced transitively via Microsoft.EntityFrameworkCore.Tools, you will need to add an explicit PackageReference to the package and change its metadata.
+
+## List of services
+
+The following is a list of the design-time services.
+
+Service                                                                              | Description
+------------------------------------------------------------------------------------ | -----------
+<xref:Microsoft.EntityFrameworkCore.Design.IAnnotationCodeGenerator>                 | Generates the code for corresponding model annotations.
+<xref:Microsoft.EntityFrameworkCore.Design.ICSharpHelper>                            | Helps with generating C# code.
+<xref:Microsoft.EntityFrameworkCore.Design.IPluralizer>                              | Pluralizes and singularizes words.
+<xref:Microsoft.EntityFrameworkCore.Migrations.Design.ICSharpMigrationOperationGenerator>       | Generates C# code for migration operations.
+<xref:Microsoft.EntityFrameworkCore.Migrations.Design.ICSharpSnapshotGenerator>                 | Generates C# code for model snapshots.
+<xref:Microsoft.EntityFrameworkCore.Migrations.Design.IMigrationsCodeGenerator>      | Generates code for a migration.
+<xref:Microsoft.EntityFrameworkCore.Migrations.Design.IMigrationsCodeGeneratorSelector> | Selects the appropriate migrations code generator.
+<xref:Microsoft.EntityFrameworkCore.Migrations.Design.IMigrationsScaffolder>         | The main class for managing migration files.
+<xref:Microsoft.EntityFrameworkCore.Scaffolding.ICompiledModelCodeGenerator>         | Generates code for compiled model metadata.
+<xref:Microsoft.EntityFrameworkCore.Scaffolding.ICompiledModelCodeGeneratorSelector> | Selects the appropriate compiled model code generator.
+<xref:Microsoft.EntityFrameworkCore.Scaffolding.ICompiledModelScaffolder>            | The main class for scaffolding compiled models.
+<xref:Microsoft.EntityFrameworkCore.Scaffolding.IDatabaseModelFactory>               | Creates a database model from a database.
+<xref:Microsoft.EntityFrameworkCore.Scaffolding.IModelCodeGenerator>                 | Generates code for a model.
+<xref:Microsoft.EntityFrameworkCore.Scaffolding.IModelCodeGeneratorSelector>         | Selects the appropriate model code generator.
+<xref:Microsoft.EntityFrameworkCore.Scaffolding.IProviderConfigurationCodeGenerator> | Generates OnConfiguring code.
+<xref:Microsoft.EntityFrameworkCore.Scaffolding.IReverseEngineerScaffolder>          | The main class for scaffolding reverse engineered models.
+<xref:Microsoft.EntityFrameworkCore.Scaffolding.IScaffoldingModelFactory>            | Creates a model from a database model.
+<xref:Microsoft.EntityFrameworkCore.Query.IPrecompiledQueryCodeGenerator>            | Generates code for precompiled queries.
+<xref:Microsoft.EntityFrameworkCore.Query.IPrecompiledQueryCodeGeneratorSelector>    | Selects the appropriate precompiled query code generator.
+
+## Using services
+
+These services can also be useful for creating your own tools. For example, when you want to automate part of your design-time workflow.
+
+You can build a service provider containing these services using the AddEntityFrameworkDesignTimeServices and AddDbContextDesignTimeServices extension methods.
+
+[!code-csharp[](../../../samples/core/Miscellaneous/CommandLine/CustomTools.cs#CustomTools)]
diff --git a/entity-framework/core/dbcontext-configuration/index.md b/entity-framework/core/dbcontext-configuration/index.md
new file mode 100644
index 0000000000..0993a99b11
--- /dev/null
+++ b/entity-framework/core/dbcontext-configuration/index.md
@@ -0,0 +1,504 @@
+---
+title: DbContext Lifetime, Configuration, and Initialization - EF Core
+description: Patterns for creating and managing DbContext instances with or without dependency injection
+author: SamMonoRT
+ms.date: 09/30/2025
+uid: core/dbcontext-configuration/index
+ms.custom: sfi-ropc-nochange
+---
+
+# DbContext Lifetime, Configuration, and Initialization
+
+This article shows basic patterns for initialization and configuration of a <xref:Microsoft.EntityFrameworkCore.DbContext> instance.
+
+[!INCLUDE [managed-identities-test-non-production](~/core/includes/managed-identities-test-non-production.md)]
+
+## The DbContext lifetime
+
+The lifetime of a `DbContext` begins when the instance is created and ends when the instance is [disposed](/dotnet/standard/garbage-collection/unmanaged). A `DbContext` instance is designed to be used for a _single_ [unit-of-work](https://www.martinfowler.com/eaaCatalog/unitOfWork.html). This means that the lifetime of a `DbContext` instance is usually very short.
+
+> [!TIP]
+> To quote Martin Fowler from the link above, "A Unit of Work keeps track of everything you do during a business transaction that can affect the database. When you're done, it figures out everything that needs to be done to alter the database as a result of your work."
+
+A typical unit-of-work when using Entity Framework Core (EF Core) involves:
+
+- Creation of a `DbContext` instance
+- Tracking of entity instances by the context. Entities become tracked by
+  - Being [returned from a query](xref:core/querying/tracking)
+  - Being [added or attached to the context](xref:core/saving/disconnected-entities)
+- Changes are made to the tracked entities as needed to implement the business rule
+- <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*> or <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChangesAsync*> is called. EF Core detects the changes made and writes them to the database.
+- The `DbContext` instance is disposed
+
+> [!IMPORTANT]
+>
+> - It is important to dispose the <xref:Microsoft.EntityFrameworkCore.DbContext> after use. This ensures any:
+>   - Unmanaged resources are freed.
+>   - Events or other hooks are unregistered. Unregistering prevents memory leaks when the instance remains referenced.
+> - [DbContext is **Not thread-safe**](#avoiding-dbcontext-threading-issues). Don't share contexts between threads. Make sure to [await](/dotnet/csharp/language-reference/operators/await) all async calls before continuing to use the context instance.
+> - An <xref:System.InvalidOperationException> thrown by EF Core code can put the context into an unrecoverable state. Such exceptions indicate a program error and are not designed to be recovered from.
+
+## DbContext in dependency injection for ASP.NET Core
+
+In many web applications, each HTTP request corresponds to a single unit-of-work. This makes tying the context lifetime to that of the request a good default for web applications.
+
+ASP.NET Core applications are [configured using dependency injection](/aspnet/core/fundamentals/startup). EF Core can be added to this configuration using <xref:Microsoft.Extensions.DependencyInjection.EntityFrameworkServiceCollectionExtensions.AddDbContext*> in `Program.cs`. For example:
+
+<!--
+        public void ConfigureServices(IServiceCollection services)
+        {
+            services.AddControllers();
+
+            services.AddDbContext<ApplicationDbContext>(
+                options => options.UseSqlServer("name=DefaultConnection"));
+        }
+-->
+
+[!code-csharp[snippet_1](../../../samples/core/Miscellaneous/ConfiguringDbContext/WebApp9/Program9.cs?name=snippet_1)]
+
+The preceding code registers `ApplicationDbContext`, a subclass of `DbContext`, as a scoped service in the ASP.NET Core app service provider. The service provider is also known as the dependency injection container. The context is configured to use the SQL Server database provider and reads the connection string from [ASP.NET Core configuration](xref:core/miscellaneous/connection-strings#aspnet-core).
+
+The `ApplicationDbContext` class must expose a public constructor with a `DbContextOptions<ApplicationDbContext>` parameter. This is how context configuration from `AddDbContext` is passed to the `DbContext`. For example:
+
+<!--
+    public class ApplicationDbContext : DbContext
+    {
+        public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options)
+            : base(options)
+        {
+        }
+    }
+-->
+
+[!code-csharp[ApplicationDbContext](../../../samples/core/Miscellaneous/ConfiguringDbContext/WebApp/ApplicationDbContext.cs?name=ApplicationDbContext)]
+
+`ApplicationDbContext` can be used in ASP.NET Core controllers or other services through constructor injection:
+
+<!--
+    public class MyController
+    {
+        private readonly ApplicationDbContext _context;
+
+        public MyController(ApplicationDbContext context)
+        {
+            _context = context;
+        }
+    }
+-->
+[!code-csharp[MyController](../../../samples/core/Miscellaneous/ConfiguringDbContext/WebApp/Controllers/MyController.cs?name=MyController)]
+
+The final result is an `ApplicationDbContext` instance created for each request and passed to the controller to perform a unit-of-work before being disposed when the request ends.
+
+Read further in this article to learn more about configuration options. See [Dependency injection in ASP.NET Core](/aspnet/core/fundamentals/dependency-injection) for more information.
+
+## Basic DbContext initialization with 'new'
+
+`DbContext` instances can be constructed with `new` in C#. Configuration can be performed by overriding the `OnConfiguring` method, or by passing options to the constructor. For example:
+
+<!--
+    public class ApplicationDbContext : DbContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder.UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Test");
+        }
+    }
+-->
+[!code-csharp[ApplicationDbContext](../../../samples/core/Miscellaneous/ConfiguringDbContext/WithNew/ApplicationDbContext.cs?name=ApplicationDbContext)]
+
+This pattern also makes it easy to pass configuration like the connection string via the `DbContext` constructor. For example:
+
+<!--
+    public class ApplicationDbContext : DbContext
+    {
+        private readonly string _connectionString;
+
+        public ApplicationDbContext(string connectionString)
+        {
+            _connectionString = connectionString;
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder.UseSqlServer(_connectionString);
+        }
+    }
+-->
+[!code-csharp[ApplicationDbContext](../../../samples/core/Miscellaneous/ConfiguringDbContext/WithNewAndArgs/ApplicationDbContext.cs?name=ApplicationDbContext)]
+
+Alternately, `DbContextOptionsBuilder` can be used to create a `DbContextOptions` object that is then passed to the `DbContext` constructor. This allows a `DbContext` configured for dependency injection to also be constructed explicitly. For example, when using `ApplicationDbContext` defined for ASP.NET Core web apps above:
+
+<!--
+    public class ApplicationDbContext : DbContext
+    {
+        public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options)
+            : base(options)
+        {
+        }
+    }
+-->
+[!code-csharp[ApplicationDbContext](../../../samples/core/Miscellaneous/ConfiguringDbContext/WebApp/ApplicationDbContext.cs?name=ApplicationDbContext)]
+
+The `DbContextOptions` can be created and the constructor can be called explicitly:
+
+<!--
+            var contextOptions = new DbContextOptionsBuilder<ApplicationDbContext>()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Test")
+                .Options;
+
+            using var context = new ApplicationDbContext(contextOptions);
+-->
+[!code-csharp[UseNewForWebApp](../../../samples/core/Miscellaneous/ConfiguringDbContext/WebApp/UseNewForWebApp.cs?name=UseNewForWebApp)]
+
+## Use a DbContext factory
+
+Some application types (e.g. [ASP.NET Core Blazor](/aspnet/core/blazor/)) use dependency injection but do not create a service scope that aligns with the desired `DbContext` lifetime. Even where such an alignment does exist, the application may need to perform multiple units-of-work within this scope. For example, multiple units-of-work within a single HTTP request.
+
+In these cases, <xref:Microsoft.Extensions.DependencyInjection.EntityFrameworkServiceCollectionExtensions.AddDbContextFactory*> can be used to register a factory for creation of `DbContext` instances. For example:
+
+<!--
+        public void ConfigureServices(IServiceCollection services)
+        {
+            services.AddDbContextFactory<ApplicationDbContext>(options =>
+                options.UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Test"));
+        }
+-->
+[!code-csharp[ConfigureServices](../../../samples/core/Miscellaneous/ConfiguringDbContext/WithContextFactory/FactoryServicesExample.cs?name=ConfigureServices)]
+
+The `ApplicationDbContext` class must expose a public constructor with a `DbContextOptions<ApplicationDbContext>` parameter. This is the same pattern as used in the traditional ASP.NET Core section above.
+
+<!--
+    public class ApplicationDbContext : DbContext
+    {
+        public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options)
+            : base(options)
+        {
+        }
+    }
+-->
+[!code-csharp[ApplicationDbContext](../../../samples/core/Miscellaneous/ConfiguringDbContext/WebApp/ApplicationDbContext.cs?name=ApplicationDbContext)]
+
+The `DbContextFactory` factory can then be used in other services through constructor injection. For example:
+
+<!--
+        private readonly IDbContextFactory<ApplicationDbContext> _contextFactory;
+
+        public MyController(IDbContextFactory<ApplicationDbContext> contextFactory)
+        {
+            _contextFactory = contextFactory;
+        }
+-->
+[!code-csharp[Construct](../../../samples/core/Miscellaneous/ConfiguringDbContext/WithContextFactory/MyController.cs?name=Construct)]
+
+The injected factory can then be used to construct DbContext instances in the service code. For example:
+
+<!--
+        public void DoSomething()
+        {
+            using (var context = _contextFactory.CreateDbContext())
+            {
+                // ...
+            }
+        }
+-->
+[!code-csharp[DoSomething](../../../samples/core/Miscellaneous/ConfiguringDbContext/WithContextFactory/MyController.cs?name=DoSomething)]
+
+Notice that the `DbContext` instances created in this way are **not** managed by the application's service provider and therefore must be disposed by the application.
+
+See [ASP.NET Core Blazor Server with Entity Framework Core](/aspnet/core/blazor/blazor-server-ef-core) for more information on using EF Core with Blazor.
+
+## DbContextOptions
+
+The starting point for all `DbContext` configuration is <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder>. There are three ways to get this builder:
+
+- In `AddDbContext` and related methods
+- In `OnConfiguring`
+- Constructed explicitly with `new`
+
+Examples of each of these are shown in the preceding sections. The same configuration can be applied regardless of where the builder comes from. In addition, `OnConfiguring` is always called regardless of how the context is constructed. This means `OnConfiguring` can be used to perform additional configuration even when `AddDbContext` is being used.
+
+### Configuring the database provider
+
+Each `DbContext` instance must be configured to use one and only one database provider. (Different instances of a `DbContext` subtype can be used with different database providers, but a single instance must only use one.) A database provider is configured using a specific `Use*` call. For example, to use the SQL Server database provider:
+
+<!--
+    public class ApplicationDbContext : DbContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder.UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Test");
+        }
+    }
+-->
+[!code-csharp[ApplicationDbContext](../../../samples/core/Miscellaneous/ConfiguringDbContext/WithNew/ApplicationDbContext.cs?name=ApplicationDbContext)]
+
+These `Use*` methods are extension methods implemented by the database provider. This means that the database provider NuGet package must be installed before the extension method can be used.
+
+> [!TIP]
+> EF Core database providers make extensive use of [extension methods](/dotnet/csharp/programming-guide/classes-and-structs/extension-methods). If the compiler indicates that a method cannot be found, then make sure that the provider's NuGet package is installed and that you have `using Microsoft.EntityFrameworkCore;` in your code.
+
+The following table contains examples for common database providers.
+
+| Database system            | Example configuration                        | NuGet package                                                                                                      |
+|:---------------------------|----------------------------------------------|--------------------------------------------------------------------------------------------------------------------|
+| SQL Server or Azure SQL    | `.UseSqlServer(connectionString)`            | [Microsoft.EntityFrameworkCore.SqlServer](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.SqlServer/) |
+| Azure Cosmos DB            | `.UseCosmos(connectionString, databaseName)` | [Microsoft.EntityFrameworkCore.Cosmos](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Cosmos/)       |
+| SQLite                     | `.UseSqlite(connectionString)`               | [Microsoft.EntityFrameworkCore.Sqlite](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Sqlite/)       |
+| EF Core in-memory database | `.UseInMemoryDatabase(databaseName)`         | [Microsoft.EntityFrameworkCore.InMemory](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.InMemory/)   |
+| PostgreSQL*                | `.UseNpgsql(connectionString)`               | [Npgsql.EntityFrameworkCore.PostgreSQL](https://www.nuget.org/packages/Npgsql.EntityFrameworkCore.PostgreSQL/)     |
+| MySQL/MariaDB*             | `.UseMySql(connectionString)`                | [Pomelo.EntityFrameworkCore.MySql](https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql/)               |
+| Oracle*                    | `.UseOracle(connectionString)`               | [Oracle.EntityFrameworkCore](https://www.nuget.org/packages/Oracle.EntityFrameworkCore/)                           |
+
+*These database providers are not shipped by Microsoft. See [Database Providers](xref:core/providers/index) for more information about database providers.
+
+> [!WARNING]
+> The EF Core in-memory database is not designed for production use. In addition, it may not be the best choice even for testing. See [Testing Code That Uses EF Core](xref:core/testing/index) for more information.
+
+See [Connection Strings](xref:core/miscellaneous/connection-strings) for more information on using connection strings with EF Core.
+
+Optional configuration specific to the database provider is performed in an additional provider-specific builder. For example, using <xref:Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder.EnableRetryOnFailure*> to configure retries for connection resiliency when connecting to Azure SQL:
+
+<!--
+    public class ApplicationDbContext : DbContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .UseSqlServer(
+                    @"Server=(localdb)\mssqllocaldb;Database=Test",
+                    providerOptions =>
+                        {
+                            providerOptions.EnableRetryOnFailure();
+                        });
+        }
+    }
+-->
+[!code-csharp[ApplicationDbContext](../../../samples/core/Miscellaneous/ConfiguringDbContext/AdditionalProviderConfiguration/ApplicationDbContext.cs?name=ApplicationDbContext)]
+
+> [!TIP]
+> The same database provider is used for SQL Server and Azure SQL. However, it is recommended that [connection resiliency](xref:core/miscellaneous/connection-resiliency) be used when connecting to SQL Azure.
+
+See [Database Providers](xref:core/providers/index) for more information on provider-specific configuration.
+
+### Other DbContext configuration
+
+Other `DbContext` configuration can be chained either before or after (it makes no difference which) the `Use*` call. For example, to turn on sensitive-data logging:
+
+<!--
+    public class ApplicationDbContext : DbContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Test");
+        }
+    }
+-->
+[!code-csharp[ApplicationDbContext](../../../samples/core/Miscellaneous/ConfiguringDbContext/AdditionalConfiguration/ApplicationDbContext.cs?name=ApplicationDbContext)]
+
+The following table contains examples of common methods called on `DbContextOptionsBuilder`.
+
+| DbContextOptionsBuilder method                                                             | What it does                                                | Learn more
+|:-------------------------------------------------------------------------------------------|-------------------------------------------------------------|--------------
+| <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseQueryTrackingBehavior*>   | Sets the default tracking behavior for queries              | [Query Tracking Behavior](xref:core/querying/tracking)
+| <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.LogTo*>                      | A simple way to get EF Core logs                            | [Logging, Events, and Diagnostics](xref:core/logging-events-diagnostics/index)
+| <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseLoggerFactory*>           | Registers an `Microsoft.Extensions.Logging` factory         | [Logging, Events, and Diagnostics](xref:core/logging-events-diagnostics/index)
+| <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.EnableSensitiveDataLogging*> | Includes application data in exceptions and logging         | [Logging, Events, and Diagnostics](xref:core/logging-events-diagnostics/index)
+| <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.EnableDetailedErrors*>       | More detailed query errors (at the expense of performance)  | [Logging, Events, and Diagnostics](xref:core/logging-events-diagnostics/index)
+| <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.ConfigureWarnings*>          | Ignore or throw for warnings and other events               | [Logging, Events, and Diagnostics](xref:core/logging-events-diagnostics/index)
+| <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.AddInterceptors*>            | Registers EF Core interceptors                              | [Logging, Events, and Diagnostics](xref:core/logging-events-diagnostics/index)
+| <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.EnableServiceProviderCaching*> | Controls caching of the internal service provider          | [Service Provider Caching](xref:core/testing/advanced-topics#service-provider-caching)
+| <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseMemoryCache*>             | Configures the memory cache used by EF Core                | [Memory Cache Integration](xref:core/performance/advanced-performance-topics#memory-cache-integration)
+| <xref:Microsoft.EntityFrameworkCore.ProxiesExtensions.UseLazyLoadingProxies*>            | Use dynamic proxies for lazy-loading                        | [Lazy Loading](xref:core/querying/related-data/lazy)
+| <xref:Microsoft.EntityFrameworkCore.ProxiesExtensions.UseChangeTrackingProxies*>         | Use dynamic proxies for change-tracking                     | Coming soon...
+
+> [!NOTE]
+> <xref:Microsoft.EntityFrameworkCore.ProxiesExtensions.UseLazyLoadingProxies*> and <xref:Microsoft.EntityFrameworkCore.ProxiesExtensions.UseChangeTrackingProxies*> are extension methods from the [Microsoft.EntityFrameworkCore.Proxies](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Proxies/) NuGet package. This kind of ".UseSomething()" call is the recommended way to configure and/or use EF Core extensions contained in other packages.
+
+### `DbContextOptions` versus `DbContextOptions<TContext>`
+
+Most `DbContext` subclasses that accept a `DbContextOptions` should use the [generic](/dotnet/csharp/programming-guide/generics/) `DbContextOptions<TContext>` variation. For example:
+
+<!--
+    public sealed class SealedApplicationDbContext : DbContext
+    {
+        public SealedApplicationDbContext(DbContextOptions<SealedApplicationDbContext> contextOptions)
+            : base(contextOptions)
+        {
+        }
+    }
+-->
+[!code-csharp[SealedApplicationDbContext](../../../samples/core/Miscellaneous/ConfiguringDbContext/InheritDbContext/ApplicationDbContext.cs?name=SealedApplicationDbContext)]
+
+This ensures that the correct options for the specific `DbContext` subtype are resolved from dependency injection, even when multiple `DbContext` subtypes are registered.
+
+> [!TIP]
+> Your DbContext does not need to be sealed, but sealing is best practice to do so for classes not designed to be inherited from.
+
+However, if the `DbContext` subtype is itself intended to be inherited from, then it should expose a protected constructor taking a non-generic `DbContextOptions`. For example:
+
+<!--
+    public abstract class ApplicationDbContextBase : DbContext
+    {
+        protected ApplicationDbContextBase(DbContextOptions contextOptions)
+            : base(contextOptions)
+        {
+        }
+    }
+-->
+[!code-csharp[ApplicationDbContextBase](../../../samples/core/Miscellaneous/ConfiguringDbContext/InheritDbContext/ApplicationDbContext.cs?name=ApplicationDbContextBase)]
+
+This allows multiple concrete subclasses to call this base constructor using their different generic `DbContextOptions<TContext>` instances. For example:
+
+<!--
+    public sealed class ApplicationDbContext1 : ApplicationDbContextBase
+    {
+        public ApplicationDbContext1(DbContextOptions<ApplicationDbContext1> contextOptions)
+            : base(contextOptions)
+        {
+        }
+    }
+
+    public sealed class ApplicationDbContext2 : ApplicationDbContextBase
+    {
+        public ApplicationDbContext2(DbContextOptions<ApplicationDbContext2> contextOptions)
+            : base(contextOptions)
+        {
+        }
+    }
+-->
+[!code-csharp[ApplicationDbContext12](../../../samples/core/Miscellaneous/ConfiguringDbContext/InheritDbContext/ApplicationDbContext.cs?name=ApplicationDbContext12)]
+
+Notice that this is exactly the same pattern as when inheriting from `DbContext` directly. That is, the `DbContext` constructor itself accepts a non-generic `DbContextOptions` for this reason.
+
+A `DbContext` subclass intended to be both instantiated and inherited from should expose both forms of constructor. For example:
+
+<!--
+    public class ApplicationDbContext : DbContext
+    {
+        public ApplicationDbContext(DbContextOptions<ApplicationDbContext> contextOptions)
+            : base(contextOptions)
+        {
+        }
+
+        protected ApplicationDbContext(DbContextOptions contextOptions)
+            : base(contextOptions)
+        {
+        }
+    }
+-->
+[!code-csharp[ApplicationDbContext](../../../samples/core/Miscellaneous/ConfiguringDbContext/InheritDbContext/ApplicationDbContext.cs?name=ApplicationDbContext)]
+
+## Design-time DbContext configuration
+
+EF Core design-time tools such as those for [EF Core migrations](xref:core/managing-schemas/migrations/index) need to be able to discover and create a working instance of a `DbContext` type in order to gather details about the application's entity types and how they map to a database schema. This process can be automatic as long as the tool can easily create the `DbContext` in such a way that it will be configured similarly to how it would be configured at run-time.
+
+While any pattern that provides the necessary configuration information to the `DbContext` can work at run-time, tools that require using a `DbContext` at design-time can only work with a limited number of patterns. These are covered in more detail in [Design-Time Context Creation](xref:core/cli/dbcontext-creation).
+
+## Avoiding DbContext threading issues
+
+Entity Framework Core does not support multiple parallel operations being run on the same `DbContext` instance. This includes both parallel execution of async queries and any explicit concurrent use from multiple threads. Therefore, always `await` async calls immediately, or use separate `DbContext` instances for operations that execute in parallel.
+
+When EF Core detects an attempt to use a `DbContext` instance concurrently, you'll see an `InvalidOperationException` with a message like this:
+
+> A second operation started on this context before a previous operation completed. This is usually caused by different threads using the same instance of DbContext, however instance members are not guaranteed to be thread safe.
+
+When concurrent access goes undetected, it can result in undefined behavior, application crashes and data corruption.
+
+There are common mistakes that can inadvertently cause concurrent access on the same `DbContext` instance:
+
+### Asynchronous operation pitfalls
+
+Asynchronous methods enable EF Core to initiate operations that access the database in a non-blocking way. But if a caller does not await the completion of one of these methods, and proceeds to perform other operations on the `DbContext`, the state of the `DbContext` can be, (and very likely will be) corrupted.
+
+Always await EF Core asynchronous methods immediately.
+
+### Implicitly sharing DbContext instances via dependency injection
+
+The [`AddDbContext`](/dotnet/api/microsoft.extensions.dependencyinjection.entityframeworkservicecollectionextensions.adddbcontext) extension method registers `DbContext` types with a [scoped lifetime](/aspnet/core/fundamentals/dependency-injection#service-lifetimes) by default.
+
+This is safe from concurrent access issues in most ASP.NET Core applications because there is only one thread executing each client request at a given time, and because each request gets a separate dependency injection scope (and therefore a separate `DbContext` instance). For Blazor Server hosting model, one logical request is used for maintaining the Blazor user circuit, and thus only one scoped DbContext instance is available per user circuit if the default injection scope is used.
+
+Any code that explicitly executes multiple threads in parallel should ensure that `DbContext` instances aren't ever accessed concurrently.
+
+Using dependency injection, this can be achieved by either registering the context as scoped, and creating scopes (using `IServiceScopeFactory`) for each thread, or by registering the `DbContext` as transient (using the overload of `AddDbContext` which takes a `ServiceLifetime` parameter).
+
+<a name="configuredbcontext"></a>
+
+## ConfigureDbContext for configuration composition
+
+> [!NOTE]
+> This section covers intermediate-level usage of EF Core primarily intended for reusable libraries and components. Most applications should use the `AddDbContextFactory` pattern described earlier in this article.
+
+Starting with EF Core 9.0, you can use <xref:Microsoft.Extensions.DependencyInjection.EntityFrameworkServiceCollectionExtensions.ConfigureDbContext*> to apply additional configuration to a `DbContext` either before or after the `AddDbContext` call. This is particularly useful for composing non-conflicting configuration in reusable components or tests.
+
+### Basic ConfigureDbContext usage
+
+`ConfigureDbContext` allows you to add configuration in a reusable library or component without replacing the entire provider configuration:
+
+<!--
+        var services = new ServiceCollection();
+
+        services.ConfigureDbContext<BlogContext>(options =>
+            options.EnableSensitiveDataLogging()
+                   .EnableDetailedErrors());
+
+        services.AddDbContext<BlogContext>(options =>
+            options.UseInMemoryDatabase("BasicExample"));
+
+        var serviceProvider = services.BuildServiceProvider();
+-->
+[!code-csharp[BasicConfigureDbContext](../../../samples/core/Miscellaneous/ConfiguringDbContext/ConfigureDbContextSample.cs?name=BasicConfigureDbContext)]
+
+### Provider-specific configuration without connection strings
+
+To apply provider-specific configuration you can use provider-specific configuration methods without supplying the connection string. The SQL Server provider also includes `ConfigureSqlEngine` for this case. See [SQL Server-specific batching behavior](xref:core/providers/sql-server/misc#configuresqlengine) for more information.
+
+<!--
+        var services = new ServiceCollection();
+
+        services.ConfigureDbContext<BlogContext>(options =>
+            options.UseSqlServer(sqlOptions => 
+                sqlOptions.EnableRetryOnFailure()));
+
+        services.AddDbContext<BlogContext>(options =>
+            options.UseSqlServer("connectionString"));
+
+        var serviceProvider = services.BuildServiceProvider();
+-->
+[!code-csharp[ProviderSpecificConfiguration](../../../samples/core/Miscellaneous/ConfiguringDbContext/ConfigureDbContextSample.cs?name=ProviderSpecificConfiguration)]
+
+### ConfigureDbContext and AddDbContext precedence
+
+When both `ConfigureDbContext` and `AddDbContext` are used, or when multiple calls to these methods are made, the configuration is applied in the order the methods are called, with later calls taking precedence for conflicting options.
+
+For non-conflicting options (like adding logging, interceptors, or other settings), all configurations are composed together:
+
+<!--
+        var services = new ServiceCollection();
+
+        services.ConfigureDbContext<BlogContext>(options =>
+            options.LogTo(Console.WriteLine));
+
+        services.AddDbContext<BlogContext>(options =>
+            options.UseInMemoryDatabase("CompositionExample"));
+
+        services.ConfigureDbContext<BlogContext>(options =>
+            options.EnableSensitiveDataLogging());
+
+        var serviceProvider = services.BuildServiceProvider();
+-->
+[!code-csharp[ConfigurationComposition](../../../samples/core/Miscellaneous/ConfiguringDbContext/ConfigureDbContextSample.cs?name=ConfigurationComposition)]
+
+For conflicting options, the last configuration wins. See [breaking changes in EF Core 8.0](xref:core/what-is-new/ef-core-8.0/breaking-changes#AddDbContext) for more information about this behavior change.
+
+> [!NOTE]
+> Configuring a different provider will not remove the previous provider configuration. This can lead to errors when creating the context. To completely replace the provider, you need to remove the context registration and re-add it, or create a new service collection.
+
+<!-- See also [Using Dependency Injection](TODO) for advanced dependency injection configuration with EF Core. -->
+
+## More reading
+
+- Read [Dependency Injection](/aspnet/core/fundamentals/dependency-injection) to learn more about using DI.
+- Read [Testing](xref:core/testing/index) for more information.
diff --git a/entity-framework/core/extensions/index.md b/entity-framework/core/extensions/index.md
new file mode 100644
index 0000000000..846940f9ec
--- /dev/null
+++ b/entity-framework/core/extensions/index.md
@@ -0,0 +1,472 @@
+---
+title: Tools & Extensions - EF Core
+description: External tools and extensions for Entity Framework Core
+author: ErikEJ
+ms.date: 09/30/2025
+uid: core/extensions/index
+---
+
+# EF Core Tools & Extensions
+
+These tools and extensions provide additional functionality for Entity Framework Core.
+
+> [!IMPORTANT]
+> Extensions are built by a variety of sources and aren't maintained as part of the Entity Framework Core project. When considering a third party extension, be sure to evaluate its quality, licensing, compatibility, support, etc. to ensure it meets your requirements. In particular, an extension built for an older version of EF Core may need updating before it will work with the latest versions.
+
+## Tools
+
+### EF Core Power Tools
+
+EF Core Power Tools is a Visual Studio extension that exposes various EF Core design-time tasks in a simple user interface. It includes reverse engineering of DbContext and entity classes from existing databases and [SQL Server DACPACs](/sql/relational-databases/data-tier-applications/data-tier-applications), and model visualizations and diagrams. For EF Core: 8-10.
+
+[GitHub wiki](https://github.com/ErikEJ/EFCorePowerTools/wiki)
+
+### EF Core Power Tools CLI
+
+EF Core Power Tools CLI is a .NET global command line tool. It enables advanced reverse engineering of DbContext and entity classes from existing databases and [SQL Server DACPACs](/sql/relational-databases/data-tier-applications/data-tier-applications). For EF Core: 8-10.
+
+[NuGet](https://www.nuget.org/packages/ErikEJ.EFCorePowerTools.Cli/#readme-body-tab)
+
+### LLBLGen Pro
+
+LLBLGen Pro is an entity modeling solution with support for Entity Framework and Entity Framework Core. It lets you easily define your entity model and map it to your database, using database first or model first, so you can get started writing queries right away. For EF Core: 2-9.
+
+[Website](https://www.llblgen.com/)
+
+### Devart Entity Developer
+
+Entity Developer is a powerful O/RM designer for ADO.NET Entity Framework, NHibernate, LinqConnect, Telerik Data Access, and LINQ to SQL. It supports designing EF Core models visually, using model first or database first approaches, and C# or Visual Basic code generation. For EF Core: 2-9.
+
+[Website](https://www.devart.com/entitydeveloper/)
+
+### DevMagic EF Core Sidekick
+
+EF Core Sidekick is a Visual Studio extension that enhances the power of auto code generation in Visual Studio. It provides a set of tools and templates for generating EF Core entities and derived DbContext from existing database, and then generating services and REST APIs from the entities. For EF Core: 6-9.
+
+[Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=devmagic.efsidekick) |
+[Website](https://www.devmagic.com/)
+
+### Entity Framework Visual Editor
+
+Entity Framework Visual Editor is a Visual Studio extension that adds an O/RM designer for visual design of EF 6, and EF Core classes. Code is generated using T4 templates so can be customized to suit any needs. It supports inheritance, unidirectional and bidirectional associations, enumerations, and the ability to color-code your classes and add text blocks to explain potentially arcane parts of your design. For EF Core: 2-8.
+
+[Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=michaelsawczyn.EFDesigner2022)
+
+### efmig
+
+efmig is a multi-platform GUI application that speeds up daily development when working with Entity Framework Core. It covers the most popular use cases such as migration code and script generation with simple, one-click interface. For EF Core: 2-8.
+
+[GitHub repository](https://github.com/stil/efmig)
+
+### EFCore.Visualizer
+
+With Entity Framework Core query plan debugger visualizer, you can view the query plan of your queries directly inside Visual Studio. Currently, the visualizer supports SQL Server and PostgreSQL. For EF Core: 7-8.
+
+[Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=GiorgiDalakishvili.EFCoreVisualizer)
+
+## Extensions
+
+### EFCoreSecondLevelCacheInterceptor
+
+Second level caching is a query cache. The results of EF commands will be stored in the cache, so that the same EF commands will retrieve their data from the cache rather than executing them against the database again. For EF Core: 3-8.
+
+[GitHub repository](https://github.com/VahidN/EFCoreSecondLevelCacheInterceptor) | [NuGet](https://www.nuget.org/packages/EFCoreSecondLevelCacheInterceptor)
+
+### EntityFrameworkCore.Scaffolding.Handlebars
+
+Allows customization of classes reverse engineered from an existing database using the Entity Framework Core tool chain with Handlebars templates. For EF Core: 2-8.
+
+[GitHub repository](https://github.com/TrackableEntities/EntityFrameworkCore.Scaffolding.Handlebars) | [NuGet](https://www.nuget.org/packages/EntityFrameworkCore.Scaffolding.Handlebars)
+
+### NeinLinq.EntityFrameworkCore
+
+NeinLinq extends LINQ providers such as Entity Framework to enable reusing functions, rewriting queries, and building dynamic queries using translatable predicates and selectors. For EF Core: 3-8.
+
+[GitHub repository](https://github.com/axelheer/nein-linq) | [NuGet](https://www.nuget.org/packages/NeinLinq.EntityFrameworkCore)
+
+### EFCore.BulkExtensions
+
+EF Core extensions for Bulk operations (Insert, Update, Delete). For EF Core: 2-8.
+
+[GitHub repository](https://github.com/borisdj/EFCore.BulkExtensions) | [NuGet](https://www.nuget.org/packages/EFCore.BulkExtensions)
+
+### Bricelam.EntityFrameworkCore.Pluralizer
+
+Adds design-time pluralization. For EF Core: 2-9.
+
+[GitHub repository](https://github.com/bricelam/EFCore.Pluralizer) | [NuGet](https://www.nuget.org/packages/Bricelam.EntityFrameworkCore.Pluralizer)
+
+### Verify.EntityFramework
+
+Extends [Verify](https://github.com/VerifyTests/Verify) to allow snapshot testing with Entity Framework. For EF Core: 3-8.
+
+[GitHub repository](https://github.com/VerifyTests/Verify.EntityFramework) | [NuGet](https://www.nuget.org/packages/Verify.EntityFramework)
+
+### LocalDb
+
+Provides a wrapper around [SQL Server Express LocalDB](/sql/database-engine/configure-windows/sql-server-express-localdb) to simplify running tests against Entity Framework.
+
+[GitHub repository](https://github.com/SimonCropp/LocalDb) | [NuGet](https://www.nuget.org/packages/EfLocalDb)
+
+### EfCore.InMemory.Transactions
+
+Seamless transaction support for EF Core InMemory provider. Eliminates "transactions with isolation level are not supported" errors in tests without changing production code. Provides safe extension methods and NoOpDbContextTransaction for UnitOfWork patterns. For EF Core: 8-10.
+
+[GitHub repository](https://github.com/ShadyNagy/EfCore.InMemory.Transactions) | [NuGet](https://www.nuget.org/packages/EfCore.InMemory.Transactions)
+
+### EntityFrameworkCore.Projectables
+
+Flexible projection magic for EF Core. Use properties, methods, and extension methods in your query without client evaluation. For EF Core: 3-6, 8.
+
+[GitHub repository](https://github.com/koenbeuk/EntityFrameworkCore.Projectables) | [NuGet](https://www.nuget.org/packages/EntityFrameworkCore.Projectables)
+
+### Entity Framework Plus
+
+Extends your DbContext with features such as: Include Filter, Auditing, Caching, Query Future, Batch Delete, Batch Update, and more. For EF Core: 2-10.
+
+[Website](https://entityframework-plus.net/) | [GitHub repository](https://github.com/zzzprojects/EntityFramework-Plus) | [NuGet](https://www.nuget.org/packages/Z.EntityFramework.Plus.EFCore)
+
+### Entity Framework Extensions
+
+Extends your DbContext with high-performance bulk operations: BulkSaveChanges, BulkInsert, BulkUpdate, BulkDelete, BulkMerge, and more. For EF Core: 2-10.
+
+[Website](https://entityframework-extensions.net/) | [NuGet](https://www.nuget.org/packages/Z.EntityFramework.Extensions.EFCore/)
+
+### Expressionify
+
+Add support for calling extension methods in LINQ lambdas. For EF Core: 3-9.
+
+[GitHub repository](https://github.com/ClaveConsulting/Expressionify) | [NuGet](https://www.nuget.org/packages/Clave.Expressionify)
+
+### EntityLinq
+
+Alternative (not MS based) Language Integrated Query (LINQ) technology for relational databases. It allows you to use C# to write strongly typed SQL queries. For EF Core: 3-8.
+
+- Full C# support for query creation: multiple statements inside lambda, variables, functions, etc.
+- No semantic gap with SQL. EntityLinq declares SQL statements (like `SELECT`, `FROM`, `WHERE`) as first class C# methods, combining familiar syntax with intellisense, type safety and refactoring.
+
+As a result SQL becomes just "another" class library exposing its API locally, literally *"Language Integrated SQL"*.
+
+[Website](https://entitylinq.com/) | [NuGet](https://www.nuget.org/packages/Streamx.Linq.SQL.EFCore)
+
+### EFCore.NamingConventions
+
+This will automatically make all your table and column names have snake_case, all UPPER or all lower case naming. For EF Core: 3-9.
+
+[GitHub repository](https://github.com/efcore/EFCore.NamingConventions) | [NuGet](https://www.nuget.org/packages/EFCore.NamingConventions)
+
+### EFCore.CheckConstraints
+
+This plugin allows you to opt into some check constraints - just activate it and they'll automatically get created for you. For EF Core: 5-9.
+
+[GitHub repository](https://github.com/efcore/EFCore.CheckConstraints) | [NuGet](https://www.nuget.org/packages/EFCore.CheckConstraints)
+
+### SimplerSoftware.EntityFrameworkCore.SqlServer.NodaTime
+
+Adds native support to EntityFrameworkCore for SQL Server for the NodaTime types. For EF Core: 3-9.
+
+[GitHub repository](https://github.com/StevenRasmussen/EFCore.SqlServer.NodaTime) | [NuGet](https://www.nuget.org/packages/SimplerSoftware.EntityFrameworkCore.SqlServer.NodaTime)
+
+### linq2db.EntityFrameworkCore
+
+Alternative translator of LINQ queries to SQL expressions. For EF Core: 2-8.
+
+Includes support for advanced SQL features such as CTEs, bulk copy, table hints, windowed functions, temporary tables, and database-side create/update/delete operations.
+
+[GitHub repository](https://github.com/linq2db/linq2db.EntityFrameworkCore) | [NuGet](https://www.nuget.org/packages/linq2db.EntityFrameworkCore)
+
+### EntityFrameworkCore.ConfigurationManager
+
+Extends EF Core to resolve connection strings from App.config. For EF Core: 3-9.
+
+[GitHub repository](https://github.com/efcore/EFCore.ConfigurationManager) | [NuGet](https://www.nuget.org/packages/EntityFrameworkCore.ConfigurationManager)
+
+### Detached Mapper
+
+A DTO-Entity mapper with composition/aggregation handling (similar to GraphDiff). For EF Core: 3-8.
+
+[GitHub repository](https://github.com/leonardoporro/Detached-Mapper) | [NuGet](https://www.nuget.org/packages/Detached.Mappers.EntityFramework)
+
+### EntityFrameworkCore.Sqlite.NodaTime
+
+Adds support for [NodaTime](https://nodatime.org) types when using [SQLite](https://sqlite.org). For EF Core: 5-9.
+
+[GitHub repository](https://github.com/khellang/EFCore.Sqlite.NodaTime) | [NuGet](https://www.nuget.org/packages/EntityFrameworkCore.Sqlite.NodaTime)
+
+### ErikEJ.EntityFrameworkCore.SqlServer.Dacpac
+
+Enables reverse engineering an EF Core model from a SQL Server data-tier application package (.dacpac). For EF Core: 6-9.
+
+[GitHub repository](https://github.com/ErikEJ/EFCorePowerTools/tree/master/src/GUI/ErikEJ.EntityFrameworkCore.SqlServer.Dacpac) | [NuGet](https://www.nuget.org/packages/ErikEJ.EntityFrameworkCore.SqlServer.Dacpac)
+
+### ErikEJ.EntityFrameworkCore.DgmlBuilder
+
+Generate DGML (Graph) content that visualizes your DbContext. Adds the AsDgml() extension method to the DbContext class. For EF Core: 6-9.
+
+[GitHub repository](https://github.com/ErikEJ/EFCorePowerTools/tree/master/src/GUI/ErikEJ.EntityFrameworkCore.DgmlBuilder) | [NuGet](https://www.nuget.org/packages/ErikEJ.EntityFrameworkCore.DgmlBuilder)
+
+### EntityFramework.Exceptions
+
+When using Entity Framework Core all database exceptions are wrapped in DbUpdateException. EntityFramework.Exceptions handles all the database-specific details to find which constraint was violated and allows you to use typed exceptions such as `UniqueConstraintException`, `CannotInsertNullException`, `MaxLengthExceededException`, `NumericOverflowException`, `ReferenceConstraintException` when your query violates database constraints.
+
+Supports SQL Server, Postgres, MySql, SQLite and Oracle. For EF Core: 3-8.
+
+[GitHub Repository](https://github.com/Giorgi/EntityFramework.Exceptions)
+
+### EntityFrameworkCore.VisualBasic
+
+Adds VB design-time support to EF Core. For EF Core: 5-8.
+
+[GitHub repository](https://github.com/efcore/EFCore.VisualBasic) | [NuGet](https://www.nuget.org/packages/EntityFrameworkCore.VisualBasic)
+
+### Laraue.EfCoreTriggers
+
+Fluent API to declare triggers in `Context.OnModelCreating` which are later built into migrations. Providers to Postgres, MySQL, SQL Server and SQLite. For EF Core: 5-8.
+
+[GitHub repository](https://github.com/win7user10/Laraue.EfCoreTriggers) | [NuGet](https://www.nuget.org/packages/Laraue.EfCoreTriggers.Common)
+
+### EntityCloner.Microsoft.EntityFrameworkCore
+
+Cloning entities using EF Core configuration. You can use the `Include` method to specify related data to be cloned. For EF Core: 5-8.
+
+[GitHub repository](https://github.com/HenkKin/EntityCloner.Microsoft.EntityFrameworkCore) | [NuGet](https://www.nuget.org/packages/EntityCloner.Microsoft.EntityFrameworkCore)
+
+### Zomp EF Core Extensions
+
+Provides window (analytics) functions and binary functions for EF Core. Providers: SQL Server, SQLite, PostgreSQL. For EF Core: 6-8.
+
+[GitHub repository](https://github.com/zompinc/efcore-extensions) | [NuGet](https://www.nuget.org/packages/Zomp.EFCore.WindowFunctions.SqlServer)
+
+### Entity Framework Ruler
+
+Adds design-time customization of the reverse engineered model including:
+
+- Class, property and navigation naming
+- Skipping the scaffolding of any schema, table, or column.
+- Overriding property types, especially for enums.
+- EF6 EDMX support, providing a smooth 3-step upgrade path from EF6 to EF Core.
+
+For EF Core: 6-8.
+
+[GitHub repository](https://github.com/R4ND3LL/EntityFrameworkRuler/) | [CLI Tool NuGet](https://www.nuget.org/packages/EntityFrameworkRuler/) | [Design NuGet](https://www.nuget.org/packages/EntityFrameworkRuler.Design/)
+
+### Microsoft.EntityFrameworkCore.DynamicLinq
+
+The Dynamic LINQ library let you execute query with dynamic string and provide some utilities methods such as ParseLambda, Parse, and CreateClass. For EF Core: 2-10.
+
+[Website](https://dynamic-linq.net/) | [GitHub repository](https://github.com/zzzprojects/System.Linq.Dynamic.Core) | [NuGet](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.DynamicLinq)
+
+### EfCoreNexus.Framework
+
+EfCoreNexus helps integrating the entity framework core into blazor apps. Via reflection it adds the entity classes automatically and provides you with basic crud functionality for them without writing additional code. For EF Core: 8.
+
+[GitHub repository](https://github.com/thliborius/EfCoreNexus) | [NuGet](https://www.nuget.org/packages/EfCoreNexus.Framework/)
+
+### Reconciler
+
+Update an entity graph in store to a given one by inserting, updating and removing the respective entities. For EF Core: 6-7.
+
+[GitHub repository](https://github.com/jtheisen/reconciler)
+
+### AutoCompute
+
+Persisted computed properties in EF Core that update automatically on save changes. For EF Core: 8.
+
+[GitHub repository](https://github.com/lucaslorentz/auto-compute) | [NuGet](https://www.nuget.org/packages/LLL.AutoCompute.EFCore)
+
+### EntityFramework.OrderBy
+
+Applies default ordering to Entity Framework queries based on fluent configuration, ensuring consistent and deterministic query results. Supports nested collections in `.Include()` expressions, multi-column ordering, and automatic database index creation for ordering columns.
+
+[GitHub repository](https://github.com/SimonCropp/EntityFramework.OrderBy) | [NuGet](https://www.nuget.org/packages/EfOrderBy)
+
+### EntityFrameworkCore.AuditInterceptor
+
+A library that provides seamless auditing capabilities for Entity Framework Core. It automatically tracks entity changes including who made the changes and when they were made. The library integrates with .NET Dependency Injection and supports various auditing scenarios through a simple configuration process. For EF Core: 6-8.
+
+[GitHub repository](https://github.com/ShadyNagy/EntityFrameworkCore.AuditInterceptor) | [NuGet](https://www.nuget.org/packages/EntityFrameworkCore.AuditInterceptor)
+
+### PhenX.EntityFrameworkCore.BulkInsert
+
+A high-performance bulk insert extension for Entity Framework Core. Supports SQL Server, PostgreSQL, SQLite, MySQL and Oracle. For EF Core: 8-9.
+
+[Website](https://phenx.github.io/PhenX.EntityFrameworkCore.BulkInsert/) | [GitHub repository](https://github.com/PhenX/PhenX.EntityFrameworkCore.BulkInsert)
+
+### SanderTenBrinke.EntityFrameworkCore.Extensions.SqlServer.DataMasking
+
+This package focuses on adding data masking support for SQL Server to EF Core. For EF Core: 8-9.
+
+[GitHub repository](https://github.com/sander1095/EntityFrameworkCore.Extensions.SqlServer.DataMasking) | [NuGet](https://www.nuget.org/packages/SanderTenBrinke.EntityFrameworkCore.Extensions.SqlServer.DataMasking)
+
+### EFCommenter
+
+All xml summaries of entities, properties, and enums will be added as comments on the corresponding database tables and columns. For EF Core: 9.
+
+[GitHub repository](https://github.com/roohial57/DotNetComponent_EFCommenter) | [NuGet](https://www.nuget.org/packages/EFCommenter)
+
+## API Integrations
+
+These packages are designed to integrate directly with EF Core to expose various APIs.
+
+### Aspire
+
+Enhance the local development experience by simplifying the management of your cloud-native app's configuration and interconnections. For EF Core: 8-10.
+
+[Website](https://aspire.dev) | [GitHub repository](https://github.com/dotnet/aspire) | [NuGet](https://www.nuget.org/profiles/aspire)
+
+### HotChocolate
+
+Build your own GraphQL endpoint on top of any resource.
+
+[GitHub repository](https://github.com/ChilliCream/hotchocolate) | [NuGet](https://www.nuget.org/packages/HotChocolate)
+
+### GraphQL.EntityFramework
+
+Add Entity Framework `IQueryable` support to GraphQL. For EF Core: 6-8.
+
+[GitHub repository](https://github.com/SimonCropp/GraphQL.EntityFramework) | [NuGet](https://www.nuget.org/packages/GraphQL.EntityFramework/)
+
+### EntityGraphQL
+
+GraphQL server with tight EntityFramework integration. For EF Core: 5-8.
+
+[GitHub repository](https://github.com/EntityGraphQL/EntityGraphQL) | [NuGet](https://www.nuget.org/packages/EntityGraphQL)
+
+### OData
+
+A standard for implementing REST APIs with specifications for discovery, filtering, sorting, projections, navigations, bulk operations, and more.
+
+[GitHub repository](https://github.com/OData) | [NuGet](https://www.nuget.org/packages/Microsoft.OData.Core/)
+
+## Extensions for unsupported EF Core versions
+
+### EntityFrameworkCore.SqlServer.HierarchyId
+
+> [!NOTE]
+> The SQL Server hierarchyid data type is supported directly within EF Core as of [EF Core 8](/ef/core/what-is-new/ef-core-8.0/whatsnew#hierarchyid-in-net-and-ef-core).
+
+Adds hierarchyid support to the SQL Server EF Core provider. For EF Core: 3-7.
+
+[GitHub repository](https://github.com/efcore/EFCore.SqlServer.HierarchyId) | [NuGet](https://www.nuget.org/packages/EntityFrameworkCore.SqlServer.HierarchyId)
+
+### EntityFrameworkCore.FSharp
+
+Adds F# design-time support to EF Core. For EF Core: 5-6.
+
+[GitHub repository](https://github.com/efcore/EFCore.FSharp) | [NuGet](https://www.nuget.org/packages/EntityFrameworkCore.FSharp)
+
+### EntityFrameworkCore.Triggered
+
+Triggers for EF Core. Respond to changes in your DbContext before and after they are committed to the database. Triggers are fully asynchronous and support dependency injection, inheritance, cascading and more. For EF Core: 3-6.
+
+[GitHub repository](https://github.com/koenbeuk/EntityFrameworkCore.Triggered) | [NuGet](https://www.nuget.org/packages/EntityFrameworkCore.Triggered)
+
+### Microsoft.EntityFrameworkCore.AutoHistory
+
+A plugin library that enables automatically recording the data changes performed by EF Core into a history table. For EF Core: 2-6.
+
+[GitHub repository](https://github.com/Arch/AutoHistory) | [NuGet](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.AutoHistory)
+
+### ErikEJ.EntityFrameworkCore.SqlServer.SqlQuery
+
+> [!NOTE]
+> Raw SQL queries against unmapped types is supported directly within EF Core as of [EF Core 8](/ef/core/what-is-new/ef-core-8.0/whatsnew#raw-sql-queries-for-unmapped-types).
+
+Provides the `SqlQueryAsync<T>` and `SqlQueryValueAsync<T>` methods to help you populate arbitrary classes or a list of primitive types from a raw SQL query. For EF Core: 6-7.
+
+[GitHub repository](https://github.com/ErikEJ/EFCorePowerTools/tree/master/src/GUI/ErikEJ.EntityFrameworkCore.6.SqlServer.SqlQuery) | [NuGet](https://www.nuget.org/packages/ErikEJ.EntityFrameworkCore.SqlServer.SqlQuery)
+
+### ErikEJ.EntityFrameworkCore.SqlServer.DateOnlyTimeOnly
+
+> [!NOTE]
+> SQL Server `DateOnly` and `TimeOnly` mapping is supported directly within EF Core as of [EF Core 8](/ef/core/what-is-new/ef-core-8.0/whatsnew#dateonlytimeonly-supported-on-sql-server).
+
+Use the `DateOnly` and `TimeOnly` .NET types with the EF Core SQL Server provider. For EF Core: 6-7.
+
+[GitHub repository](https://github.com/ErikEJ/EFCore.SqlServer.DateOnlyTimeOnly) | [NuGet](https://www.nuget.org/packages/ErikEJ.EntityFrameworkCore.SqlServer.DateOnlyTimeOnly)
+
+### nHydrate ORM for Entity Framework
+
+An O/RM that creates strongly-typed, extendable classes for Entity Framework. The generated code is Entity Framework Core. There is no difference. This is not a replacement for EF or a custom O/RM. It is a visual, modeling layer that allows a team to manage complex database schemas. It works well with SCM software like Git, allowing multi-user access to your model with minimal conflicts. The installer tracks model changes and creates upgrade scripts. For EF Core: 3.
+
+[Github repository](https://github.com/nHydrate/nHydrate)
+
+### Microsoft.EntityFrameworkCore.UnitOfWork
+
+A plugin for Microsoft.EntityFrameworkCore to support repository, unit of work patterns, and multiple databases with distributed transaction supported. For EF Core: 2-3.
+
+[GitHub repository](https://github.com/Arch/UnitOfWork)
+
+### Toolbelt.EntityFrameworkCore.IndexAttribute
+
+Revival of [Index] attribute (with extension for model building). For EF Core: 2-5.
+
+[GitHub repository](https://github.com/jsakamoto/EntityFrameworkCore.IndexAttribute) | [NuGet](https://www.nuget.org/packages/Toolbelt.EntityFrameworkCore.IndexAttribute)
+
+### EfCoreTemporalTable
+
+> [!NOTE]
+> SQL Server temporal tables are supported directly within EF Core as of [EF Core 6](/ef/core/what-is-new/ef-core-6.0/whatsnew#sql-server-temporal-tables).
+
+Easily perform temporal queries on your favorite database using introduced extension methods: `AsTemporalAll()`, `AsTemporalAsOf(date)`, `AsTemporalFrom(startDate, endDate)`, `AsTemporalBetween(startDate, endDate)`, `AsTemporalContained(startDate, endDate)`. For EF Core: 3-5.
+
+[GitHub repository](https://github.com/glautrou/EfCoreTemporalTable) | [NuGet](https://www.nuget.org/packages/EfCoreTemporalTable)
+
+### EntityFrameworkCore.TemporalTables
+
+> [!NOTE]
+> SQL Server temporal tables are supported directly within EF Core as of [EF Core 6](/ef/core/what-is-new/ef-core-6.0/whatsnew#sql-server-temporal-tables).
+
+Extension library for Entity Framework Core which allows developers who use SQL Server to easily use temporal tables. For EF Core: 2-5.
+
+[GitHub repository](https://github.com/findulov/EntityFrameworkCore.TemporalTables) | [NuGet](https://www.nuget.org/packages/EntityFrameworkCore.TemporalTables)
+
+### Dabble.EntityFrameworkCore.Temporal.Query
+
+> [!NOTE]
+> SQL Server temporal tables are supported directly within EF Core as of [EF Core 6](/ef/core/what-is-new/ef-core-6.0/whatsnew#sql-server-temporal-tables).
+
+LINQ extensions to Entity Framework Core 3.1 to support Microsoft SQL Server Temporal Table Querying. For EF Core: 3.
+
+[GitHub repository](https://github.com/Adam-Langley/efcore-temporal-query) | [NuGet](https://www.nuget.org/packages/Dabble.EntityFrameworkCore.Temporal.Query)
+
+### EntityFrameworkCore.NCache
+
+NCache Entity Framework Core Provider is a distributed second level cache provider for caching query results. The distributed architecture of NCache makes it more scalable and highly available. For EF Core: 2-3.
+
+[Website](https://www.alachisoft.com/ncache/ef-core-cache.html) | [NuGet](https://www.nuget.org/packages/EntityFrameworkCore.NCache)
+
+### Ramses
+
+Life cycle hooks (for SaveChanges). For EF Core: 2-3.
+
+[GitHub repository](https://github.com/JValck/Ramses) | [NuGet](https://www.nuget.org/packages/Ramses)
+
+### EntityFrameworkCore.Extensions
+
+An extension library for Dynamic Data Masking (SQL Server) and MigrationBuilder and ModelBuilder extensions. For EF Core: 5.
+
+An updated fork for the data masking feature can be found at [EntityFrameworkCore.Extensions.SqlServer.DataMasking](https://github.com/sander1095/EntityFrameworkCore.Extensions.SqlServer.DataMasking)
+
+[GitHub repository](https://github.com/nikitasavinov/EntityFrameworkCore.Extensions) | [NuGet](https://www.nuget.org/packages/EntityFrameworkCore.Extensions)
+
+### EFCore.SoftDelete
+
+An implementation for soft deleting entities. For EF Core: 3-6.
+
+[GitHub repository](https://github.com/AshkanAbd/efCoreSoftDeletes) | [NuGet](https://www.nuget.org/packages/EFCore.SoftDelete)
+
+### Ainoraz.EFCore.IncludeBuilder
+
+Extension for EF Core that provides alternative `Include` syntax in order to better support the following scenarios:
+
+- Loading multiple entities on the same level (siblings).
+- Writing extension methods that are independent of nesting level.
+
+For EF Core: 6-7.
+
+### LessCode.EFCore.StronglyTypedId
+
+A source generator that can generate strongly-typed-id classes automatically for entities. For EF Core: 7.
+
+[GitHub repository](https://github.com/yangzhongke/LessCode.EFCore.StronglyTypedId)
diff --git a/entity-framework/core/get-started/_static/winforms-add-class.png b/entity-framework/core/get-started/_static/winforms-add-class.png
new file mode 100644
index 0000000000..b22464beb1
Binary files /dev/null and b/entity-framework/core/get-started/_static/winforms-add-class.png differ
diff --git a/entity-framework/core/get-started/_static/winforms-add-new-object-data-source.png b/entity-framework/core/get-started/_static/winforms-add-new-object-data-source.png
new file mode 100644
index 0000000000..8d01e68af2
Binary files /dev/null and b/entity-framework/core/get-started/_static/winforms-add-new-object-data-source.png differ
diff --git a/entity-framework/core/get-started/_static/winforms-after-save.png b/entity-framework/core/get-started/_static/winforms-after-save.png
new file mode 100644
index 0000000000..1e78eac31d
Binary files /dev/null and b/entity-framework/core/get-started/_static/winforms-after-save.png differ
diff --git a/entity-framework/core/get-started/_static/winforms-before-save.png b/entity-framework/core/get-started/_static/winforms-before-save.png
new file mode 100644
index 0000000000..56e1c08433
Binary files /dev/null and b/entity-framework/core/get-started/_static/winforms-before-save.png differ
diff --git a/entity-framework/core/get-started/_static/winforms-categoryid-read-only.png b/entity-framework/core/get-started/_static/winforms-categoryid-read-only.png
new file mode 100644
index 0000000000..1677aa98bf
Binary files /dev/null and b/entity-framework/core/get-started/_static/winforms-categoryid-read-only.png differ
diff --git a/entity-framework/core/get-started/_static/winforms-choose-category-type.png b/entity-framework/core/get-started/_static/winforms-choose-category-type.png
new file mode 100644
index 0000000000..918dabd809
Binary files /dev/null and b/entity-framework/core/get-started/_static/winforms-choose-category-type.png differ
diff --git a/entity-framework/core/get-started/_static/winforms-choose-category.png b/entity-framework/core/get-started/_static/winforms-choose-category.png
new file mode 100644
index 0000000000..99156f5c82
Binary files /dev/null and b/entity-framework/core/get-started/_static/winforms-choose-category.png differ
diff --git a/entity-framework/core/get-started/_static/winforms-choose-products.png b/entity-framework/core/get-started/_static/winforms-choose-products.png
new file mode 100644
index 0000000000..68d8b2215d
Binary files /dev/null and b/entity-framework/core/get-started/_static/winforms-choose-products.png differ
diff --git a/entity-framework/core/get-started/_static/winforms-datagrid-view.png b/entity-framework/core/get-started/_static/winforms-datagrid-view.png
new file mode 100644
index 0000000000..43765f03af
Binary files /dev/null and b/entity-framework/core/get-started/_static/winforms-datagrid-view.png differ
diff --git a/entity-framework/core/get-started/_static/winforms-design-binding-picker.png b/entity-framework/core/get-started/_static/winforms-design-binding-picker.png
new file mode 100644
index 0000000000..e0ca46a4ff
Binary files /dev/null and b/entity-framework/core/get-started/_static/winforms-design-binding-picker.png differ
diff --git a/entity-framework/core/get-started/_static/winforms-edit-columns.png b/entity-framework/core/get-started/_static/winforms-edit-columns.png
new file mode 100644
index 0000000000..dacb4775f8
Binary files /dev/null and b/entity-framework/core/get-started/_static/winforms-edit-columns.png differ
diff --git a/entity-framework/core/get-started/_static/winforms-first-run.png b/entity-framework/core/get-started/_static/winforms-first-run.png
new file mode 100644
index 0000000000..b0a3d231f4
Binary files /dev/null and b/entity-framework/core/get-started/_static/winforms-first-run.png differ
diff --git a/entity-framework/core/get-started/_static/winforms-form-layout.png b/entity-framework/core/get-started/_static/winforms-form-layout.png
new file mode 100644
index 0000000000..c688d28666
Binary files /dev/null and b/entity-framework/core/get-started/_static/winforms-form-layout.png differ
diff --git a/entity-framework/core/get-started/_static/winforms-install-package.png b/entity-framework/core/get-started/_static/winforms-install-package.png
new file mode 100644
index 0000000000..5518995976
Binary files /dev/null and b/entity-framework/core/get-started/_static/winforms-install-package.png differ
diff --git a/entity-framework/core/get-started/_static/winforms-mainform.png b/entity-framework/core/get-started/_static/winforms-mainform.png
new file mode 100644
index 0000000000..17126d90cb
Binary files /dev/null and b/entity-framework/core/get-started/_static/winforms-mainform.png differ
diff --git a/entity-framework/core/get-started/_static/winforms-manage-nuget.png b/entity-framework/core/get-started/_static/winforms-manage-nuget.png
new file mode 100644
index 0000000000..44c52f10b7
Binary files /dev/null and b/entity-framework/core/get-started/_static/winforms-manage-nuget.png differ
diff --git a/entity-framework/core/get-started/_static/winforms-new-project.png b/entity-framework/core/get-started/_static/winforms-new-project.png
new file mode 100644
index 0000000000..ca542b473c
Binary files /dev/null and b/entity-framework/core/get-started/_static/winforms-new-project.png differ
diff --git a/entity-framework/core/get-started/_static/winforms-product-columns.png b/entity-framework/core/get-started/_static/winforms-product-columns.png
new file mode 100644
index 0000000000..7139eda215
Binary files /dev/null and b/entity-framework/core/get-started/_static/winforms-product-columns.png differ
diff --git a/entity-framework/core/get-started/_static/winforms-products-and-categories.png b/entity-framework/core/get-started/_static/winforms-products-and-categories.png
new file mode 100644
index 0000000000..c5dae116c1
Binary files /dev/null and b/entity-framework/core/get-started/_static/winforms-products-and-categories.png differ
diff --git a/entity-framework/core/get-started/_static/winforms-products-are-loaded.png b/entity-framework/core/get-started/_static/winforms-products-are-loaded.png
new file mode 100644
index 0000000000..de5f4f5a87
Binary files /dev/null and b/entity-framework/core/get-started/_static/winforms-products-are-loaded.png differ
diff --git a/entity-framework/core/get-started/_static/winforms-save-click-event.png b/entity-framework/core/get-started/_static/winforms-save-click-event.png
new file mode 100644
index 0000000000..93d6d1392f
Binary files /dev/null and b/entity-framework/core/get-started/_static/winforms-save-click-event.png differ
diff --git a/entity-framework/core/get-started/_static/winforms-selection-changed-event.png b/entity-framework/core/get-started/_static/winforms-selection-changed-event.png
new file mode 100644
index 0000000000..851c39af27
Binary files /dev/null and b/entity-framework/core/get-started/_static/winforms-selection-changed-event.png differ
diff --git a/entity-framework/core/get-started/_static/winforms-view-code.png b/entity-framework/core/get-started/_static/winforms-view-code.png
new file mode 100644
index 0000000000..d378f8ff37
Binary files /dev/null and b/entity-framework/core/get-started/_static/winforms-view-code.png differ
diff --git a/entity-framework/core/get-started/_static/wpf-tutorial-app.jpg b/entity-framework/core/get-started/_static/wpf-tutorial-app.jpg
new file mode 100644
index 0000000000..2a4c791fcf
Binary files /dev/null and b/entity-framework/core/get-started/_static/wpf-tutorial-app.jpg differ
diff --git a/entity-framework/core/get-started/_static/wpf-tutorial-designer.jpg b/entity-framework/core/get-started/_static/wpf-tutorial-designer.jpg
new file mode 100644
index 0000000000..190451c939
Binary files /dev/null and b/entity-framework/core/get-started/_static/wpf-tutorial-designer.jpg differ
diff --git a/entity-framework/core/get-started/_static/wpf-tutorial-loaded.jpg b/entity-framework/core/get-started/_static/wpf-tutorial-loaded.jpg
new file mode 100644
index 0000000000..09f0b30140
Binary files /dev/null and b/entity-framework/core/get-started/_static/wpf-tutorial-loaded.jpg differ
diff --git a/entity-framework/core/get-started/_static/wpf-tutorial-nuget.jpg b/entity-framework/core/get-started/_static/wpf-tutorial-nuget.jpg
new file mode 100644
index 0000000000..84742dd5d2
Binary files /dev/null and b/entity-framework/core/get-started/_static/wpf-tutorial-nuget.jpg differ
diff --git a/entity-framework/core/get-started/_static/wpf-tutorial-sqlite.jpg b/entity-framework/core/get-started/_static/wpf-tutorial-sqlite.jpg
new file mode 100644
index 0000000000..d330a7b07e
Binary files /dev/null and b/entity-framework/core/get-started/_static/wpf-tutorial-sqlite.jpg differ
diff --git a/entity-framework/core/get-started/overview/WhatIsEFCore.md.stub b/entity-framework/core/get-started/overview/WhatIsEFCore.md.stub
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/entity-framework/core/get-started/overview/first-app.md b/entity-framework/core/get-started/overview/first-app.md
new file mode 100644
index 0000000000..e68a22c606
--- /dev/null
+++ b/entity-framework/core/get-started/overview/first-app.md
@@ -0,0 +1,151 @@
+---
+title: Getting Started - EF Core
+description: Getting started tutorial for Entity Framework Core
+author: rick-anderson
+ms.date: 09/17/2019
+uid: core/get-started/overview/first-app
+---
+
+# Getting Started with EF Core
+
+In this tutorial, you create a .NET console app that performs data access against a SQLite database using Entity Framework Core.
+
+You can follow the tutorial by using Visual Studio on Windows, or by using the .NET CLI on Windows, macOS, or Linux.
+
+[View this article's sample on GitHub](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/GetStarted).
+
+## Prerequisites
+
+Install the following software:
+
+### [.NET CLI](#tab/netcore-cli)
+
+* [.NET SDK](https://dotnet.microsoft.com/en-us/download).
+
+### [Visual Studio](#tab/visual-studio)
+
+* [Visual Studio 2022 version 17.4 or later](https://www.visualstudio.com/downloads/) with this workload:
+  * **.NET desktop development** (under **Desktop && Mobile**)
+
+---
+
+## Create a new project
+
+### [.NET CLI](#tab/netcore-cli)
+
+```dotnetcli
+dotnet new console -o EFGetStarted
+cd EFGetStarted
+```
+
+### [Visual Studio](#tab/visual-studio)
+
+* Open Visual Studio
+* Click **New project**
+* Select **Console App** with the **C#** tag and click **Next**
+* Enter **EFGetStarted** for the name and click **Create**
+
+---
+
+## Install Entity Framework Core
+
+To install EF Core, you install the package for the EF Core database provider(s) you want to target. This tutorial uses SQLite because it runs on all platforms that .NET supports. For a list of available providers, see [Database Providers](xref:core/providers/index).
+
+### [.NET CLI](#tab/netcore-cli)
+
+```dotnetcli
+dotnet add package Microsoft.EntityFrameworkCore.Sqlite
+```
+
+### [Visual Studio](#tab/visual-studio)
+
+* **Tools > NuGet Package Manager > Package Manager Console**
+* Run the following commands:
+
+  ```powershell
+  Install-Package Microsoft.EntityFrameworkCore.Sqlite
+  ```
+
+Tip: You can also install packages by right-clicking on the project and selecting **Manage NuGet Packages**
+
+---
+
+## Create the model
+
+Define a context class and entity classes that make up the model.
+
+### [.NET CLI](#tab/netcore-cli)
+
+* In the project directory, create **Model.cs** with the following code
+
+### [Visual Studio](#tab/visual-studio)
+
+* Right-click on the project and select **Add > Class**
+* Enter **Model.cs** as the name and click **Add**
+* Replace the contents of the file with the following code
+
+---
+
+[!code-csharp[Main](../../../../samples/core/GetStarted/Model.cs)]
+
+EF Core can also [reverse engineer](xref:core/managing-schemas/scaffolding) a model from an existing database.
+
+Tip: This application intentionally keeps things simple for clarity. [Connection strings](xref:core/miscellaneous/connection-strings) should not be stored in the code for production applications. You may also want to split each C# class into its own file.
+
+## Create the database
+
+The following steps use [migrations](xref:core/managing-schemas/migrations/index) to create a database.
+
+### [.NET CLI](#tab/netcore-cli)
+
+* Run the following commands:
+
+  ```dotnetcli
+  dotnet tool install --global dotnet-ef
+  dotnet add package Microsoft.EntityFrameworkCore.Design
+  dotnet ef migrations add InitialCreate
+  dotnet ef database update
+  ```
+
+  This installs [dotnet ef](xref:core/cli/dotnet) and the design package which is required to run the command on a project. The `migrations` command scaffolds a migration to create the initial set of tables for the model. The `database update` command creates the database and applies the new migration to it.
+
+### [Visual Studio](#tab/visual-studio)
+
+* Run the following commands in **Package Manager Console (PMC)**
+
+  ```powershell
+  Install-Package Microsoft.EntityFrameworkCore.Tools
+  Add-Migration InitialCreate
+  Update-Database
+  ```
+
+  This installs the [PMC tools for EF Core](xref:core/cli/powershell). The `Add-Migration` command scaffolds a migration to create the initial set of tables for the model. The `Update-Database` command creates the database and applies the new migration to it.
+
+---
+
+## Create, read, update & delete
+
+* Open *Program.cs* and replace the contents with the following code:
+
+  [!code-csharp[Main](../../../../samples/core/GetStarted/Program.cs)]
+
+## Run the app
+
+### [.NET CLI](#tab/netcore-cli)
+
+```dotnetcli
+dotnet run
+```
+
+### [Visual Studio](#tab/visual-studio)
+
+**Debug > Start Without Debugging**
+
+---
+
+## Next steps
+
+* Follow the [ASP.NET Core Tutorial](/aspnet/core/data/ef-rp/intro) to use EF Core in a web app
+* Learn more about [LINQ query expressions](/dotnet/csharp/programming-guide/concepts/linq/basic-linq-query-operations)
+* [Configure your model](xref:core/modeling/index) to specify things like [required](xref:core/modeling/entity-properties#required-and-optional-properties) and [maximum length](xref:core/modeling/entity-properties#maximum-length)
+* Use [Migrations](xref:core/managing-schemas/migrations/index) to update the database schema after changing your model
diff --git a/entity-framework/core/get-started/overview/install.md b/entity-framework/core/get-started/overview/install.md
new file mode 100644
index 0000000000..5c5bcbfc7a
--- /dev/null
+++ b/entity-framework/core/get-started/overview/install.md
@@ -0,0 +1,110 @@
+---
+title: Installing Entity Framework Core - EF Core
+description: Installation instructions for Entity Framework Core
+author: SamMonoRT
+ms.date: 03/23/2023
+uid: core/get-started/overview/install
+---
+# Installing Entity Framework Core
+
+## Prerequisites
+
+* EF requires the most recent [.NET SDK](https://dotnet.microsoft.com/en-us/download).
+  * At runtime, EF Core requires a recent version of .NET. See [_EF Core releases_](xref:core/what-is-new/index) to find the minimal .NET version needed for the version of EF Core that you want to use.
+
+* You can use EF Core to develop applications on Windows using Visual Studio. The latest version of [Visual Studio](https://visualstudio.microsoft.com/vs) is recommended.
+
+## Get Entity Framework Core
+
+EF Core is shipped as [NuGet packages](https://www.nuget.org/). To add EF Core to an application, install the NuGet package for the database provider you want to use. See [_Providers_](xref:core/providers/index) for a list of the database providers available.
+
+To install or update NuGet packages, you can use the .NET command-line interface (CLI), the Visual Studio Package Manager Dialog, or the Visual Studio Package Manager Console.
+
+### .NET CLI
+
+* Use the following .NET CLI command from the operating system's command line to install or update the EF Core SQL Server provider:
+
+  ```dotnetcli
+  dotnet add package Microsoft.EntityFrameworkCore.SqlServer
+  ```
+
+* You can indicate a specific version in the `dotnet add package` command, using the `-v` modifier. For example, to install EF Core 6.0.14 packages, append `-v 6.0.14` to the command.
+
+For more information, see [.NET command-line interface (CLI) tools](/dotnet/core/tools/).
+
+### Visual Studio NuGet Package Manager Dialog
+
+* From the Visual Studio menu, select **Project > Manage NuGet Packages**
+
+* Click on the **Browse** or the **Updates** tab
+
+* To install or update the SQL Server provider, select the `Microsoft.EntityFrameworkCore.SqlServer` package, and confirm.
+
+For more information, see [NuGet Package Manager Dialog](/nuget/tools/package-manager-ui).
+
+### Visual Studio NuGet Package Manager Console
+
+* From the Visual Studio menu, select **Tools > NuGet Package Manager > Package Manager Console**
+
+* To install the SQL Server provider, run the following command in the Package Manager Console:
+
+  ```powershell
+  Install-Package Microsoft.EntityFrameworkCore.SqlServer
+  ```
+
+* To update the provider, use the `Update-Package` command.
+
+* To specify a specific version, use the `-Version` modifier. For example, to install EF Core 6.0.14 packages, append `-Version 6.0.14` to the commands
+
+For more information, see [Package Manager Console](/nuget/tools/package-manager-console).
+
+## Get the Entity Framework Core tools
+
+You can install tools to carry out EF Core-related tasks in your project, like creating and applying database migrations, or creating an EF Core model based on an existing database.
+
+Two sets of tools are available:
+
+* The [.NET command-line interface (CLI) tools](xref:core/cli/dotnet) can be used on Windows, Linux, or macOS. These commands begin with `dotnet ef`.
+
+* The [Package Manager Console (PMC) tools](xref:core/cli/powershell) run in Visual Studio on Windows. These commands start with a verb, for example `Add-Migration`, `Update-Database`.
+
+<a name="cli"></a>
+
+### Get the .NET CLI tools
+
+.NET CLI tools require the .NET SDK, mentioned earlier in [Prerequisites](#prerequisites).
+
+* `dotnet ef` must be installed as a global or local tool. Most developers prefer installing `dotnet ef` as a global tool using the following command:
+
+  ```dotnetcli
+  dotnet tool install --global dotnet-ef
+  ```
+
+  `dotnet ef` can also be used as a local tool. To use it as a local tool, restore the dependencies of a project that declares it as a tooling dependency using a [tool manifest file](/dotnet/core/tools/global-tools#install-a-local-tool).
+
+* To update the tools, use the `dotnet tool update` command.
+
+* Install the latest `Microsoft.EntityFrameworkCore.Design` package.
+
+  ```dotnetcli
+  dotnet add package Microsoft.EntityFrameworkCore.Design
+  ```
+
+> [!IMPORTANT]
+> Always use the version of the tools package that matches the major version of the runtime packages.
+
+### Get the Package Manager Console tools
+
+To get the Package Manager Console tools for EF Core, install the `Microsoft.EntityFrameworkCore.Tools` package. For example, from Visual Studio:
+
+```powershell
+Install-Package Microsoft.EntityFrameworkCore.Tools
+```
+
+## Upgrading to the latest EF Core
+
+* Any time we release a new version of EF Core, we also release a new version of the providers that are part of the EF Core project, like [Microsoft.EntityFrameworkCore.SqlServer](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.SqlServer), [Microsoft.EntityFrameworkCore.Sqlite](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Sqlite), [Microsoft.EntityFrameworkCore.Cosmos](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Cosmos), and [Microsoft.EntityFrameworkCore.InMemory](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.InMemory). You can just upgrade to the new version of the provider to get all the improvements.
+
+* If you need to update an application that is using a third-party database provider, always check for an update of the provider that is compatible with the version of EF Core you want to use. For example, database providers for version 1.0 are not compatible with version 2.0 of the EF Core runtime, and so on.
+
+* Third-party providers for EF Core usually don't release patch versions alongside the EF Core runtime. To upgrade an application that uses a third-party provider to a patch version of EF Core, you may need to add a direct reference to individual EF Core runtime components, most notably [Microsoft.EntityFrameworkCore](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore/), and [Microsoft.EntityFrameworkCore.Relational](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Relational/).
diff --git a/entity-framework/core/get-started/winforms.md b/entity-framework/core/get-started/winforms.md
new file mode 100644
index 0000000000..3e339dbada
--- /dev/null
+++ b/entity-framework/core/get-started/winforms.md
@@ -0,0 +1,318 @@
+---
+title: Get Started with Windows Forms - EF Core
+description: Getting started tutorial for using Windows Forms (WinForms) with Entity Framework Core
+author: SamMonoRT
+ms.date: 08/04/2021
+uid: core/get-started/winforms
+---
+
+# Getting Started with Windows Forms
+
+This step-by-step walkthrough shows how to build a simple Windows Forms (WinForms) application backed by a SQLite database. The application uses Entity Framework Core (EF Core) to load data from the database, track changes made to that data, and persist those changes back to the database.
+
+The screen shots and code listings in this walkthrough are taken from Visual Studio 2022 17.3.0.
+
+> [!TIP]
+> You can view this article's [sample on GitHub](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/WinForms).
+
+## Prerequisites
+
+You need to have Visual Studio 2022 17.3 or later installed with the **.NET desktop workload** selected to complete this walkthrough. For more information about installing the latest version of Visual Studio, see [Install Visual Studio](/visualstudio/install/install-visual-studio).
+
+## Create the Application
+
+1. Open Visual Studio
+2. On the start window, choose **Create new project**.
+3. Choose **Windows Forms App** and then choose **Next**.
+
+   ![Create a new Windows Forms project](_static/winforms-new-project.png)
+
+4. At the next screen, give the project a name, for example, **GetStartedWinForms**, and choose **Next**.
+5. At the next screen, choose the .NET version to use. This walkthrough was created with .NET 7, but it should also work with later versions.
+6. Choose **Create**.
+
+## Install the EF Core NuGet packages
+
+1. Right-click on the solution and choose **Manage NuGet Packages for Solution...**
+
+   ![Manage NuGet Packages for Solution](_static/winforms-manage-nuget.png)
+
+2. Choose the **Browse** tab and search for "Microsoft.EntityFrameworkCore.Sqlite".
+3. Select the **Microsoft.EntityFrameworkCore.Sqlite** package.
+4. Check the project **GetStartedWinForms** in the right pane.
+5. Choose the latest version. To use a pre-release version, make sure that the **Include prerelease** box is checked.
+6. Click **Install**
+
+   ![Install the Microsoft.EntityFrameworkCore.Sqlite package](_static/winforms-install-package.png)
+
+> [!NOTE]
+> The **Microsoft.EntityFrameworkCore.Sqlite** is the "database provider" package for using EF Core with a SQLite database. Similar packages are available for other database systems. Installing a database provider package automatically brings in all the dependencies needed to use EF Core with that database system. This includes the **Microsoft.EntityFrameworkCore** base package.
+
+## Define a Model
+
+In this walkthrough we will implement a model using "Code First". This means that EF Core will create the database tables and schema based on the C# classes you define. See [Managing Database Schemas](xref:core/managing-schemas/index) to see how to use an existing database instead.
+
+1. Right-click on project and choose **Add**, then **Class...** to add a new class.
+
+   ![Add new class](_static/winforms-add-class.png)
+
+2. Use the filename `Product.cs` and replace the code for the class with:
+
+   [!code-csharp[](../../../samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/Product.cs)]
+
+3. Repeat to create `Category.cs` with the following code:
+
+   [!code-csharp[](../../../samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/Category.cs)]
+
+The `Products` property on the `Category` class and the `Category` property on the `Product` class are called "navigations". In EF Core, navigations define a relationship between two entity types. In this case, the `Product.Category` navigation references the category to which a given product belongs. Likewise, the `Category.Products` collection navigation contains all the products for a given category.
+
+> [!TIP]
+> When using Windows Forms, the `ObservableCollectionListSource`, which implements `IListSource`, can be used for collection navigations. This is not necessary, but does improve the two-way data binding experience.
+
+## Define the DbContext
+
+In EF Core, a class derived from `DbContext` is used to configure entity types in a model and act as a session for interacting with the database. In the simplest case, a `DbContext` class:
+
+- Contains `DbSet` properties for each entity type in the model.
+- Overrides the `OnConfiguring` method to configure the database provider and connection string to use. See [Configuring a DbContext](xref:core/dbcontext-configuration/index) for more information.
+
+In this case, the DbContext class also overrides the `OnModelCreating` method to provide some sample data for the application.
+
+Add a new `ProductsContext.cs` class to the project with the following code:
+
+[!code-csharp[](../../../samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/ProductsContext.cs)]
+
+Make sure to **build the solution** at this point.
+
+## Adding controls to the form
+
+The application will show a list of categories and a list of products. When a category is selected in the first list, then the second list will change to show products for that category. These lists can be modified to add, remove, or edit products and categories, and these changes can be saved to the SQLite database by clicking a **Save** button.
+
+1. Change the name of the main form from `Form1` to `MainForm`.
+
+   ![Rename Form1 to MainForm](_static/winforms-mainform.png)
+
+2. And change the title to "Products and Categories".
+
+   ![Title MainForm as "Products and Categories"](_static/winforms-products-and-categories.png)
+
+3. Using the **Toolbox**, add two `DataGridView` controls, arranged next to each other.
+
+   ![Add DataGridView](_static/winforms-datagrid-view.png)
+
+4. In the **Properties** for the first `DataGridView`, change the **Name** to `dataGridViewCategories`.
+5. In the **Properties** for the second `DataGridView`, change the **Name** to `dataGridViewProducts`.
+6. Also using the **Toolbox**, add a `Button` control.
+7. Name the button `buttonSave` and give it the text "Save". The form should look something this this:
+
+   ![Form layout](_static/winforms-form-layout.png)
+
+## Data binding
+
+The next step is to connect the `Product` and `Category` types from the model to the `DataGridView` controls. This will bind the data loaded by EF Core to the controls, such that the entities tracked by EF Core are kept in sync with those displayed in the controls.
+
+1. Click the **Designer Action Glyph** on the first `DataGridView`. This is the tiny button at the top-right corner of the control.
+
+   ![The Designer Action Glyph](_static/winforms-design-binding-picker.png)
+
+2. This opens the _Action List_, from which the drop-down for **Chose Data Source** can be accessed. We haven't created a data source yet, so go to the bottom and choose **Add new Object Data Source...**.
+
+   ![Add new Object Data Source](_static/winforms-add-new-object-data-source.png)
+
+3. Choose **Category** to create an object data source for categories, and click **OK**.
+
+   ![Choose Category data source type](_static/winforms-choose-category-type.png)
+
+   > [!TIP]
+   > If no data source types appear here, then make sure that `Product.cs`, `Category.cs` and `ProductsContext.cs` have been added to the project _**and the solution has been built**_.
+
+4. Now the **Choose Data Source** drop-down contains the object data source we just created. Expand **Other Data Sources**, then **Project Data Sources**, and choose **Category**.
+
+   ![Choose Category data source](_static/winforms-choose-category.png)
+
+   The second `DataGridView` will be bound to products. However, rather than binding to the top-level `Product` type, it will instead be bound to the `Products` navigation from the `Category` binding of the first `DataGridView`. This means that when a category is selected in the first view, the products for that category will automatically be used in the second view.
+
+5. Using the **Designer Action Glyph** on the second `DataGridView`, choose **Choose Data Source**, then expand the `categoryBindingSource` and choose `Products`.
+
+   ![Choose Products data source](_static/winforms-choose-products.png)
+
+## Configuring what is displayed
+
+By default, a column is created in the `DataGridView` for every property of the bound types. Also, the values for each of these properties can be edited by the user. However, some values, such as the primary key values, are conceptually read-only, and so should not be edited. Also, some properties, such as the `CategoryId` foreign key property and the `Category` navigation are not useful to the user, and so should be hidden.
+
+> [!TIP]
+> It is common to hide primary key properties in a real application. They are left visible here to make it easy to see what EF Core is doing behind the scenes.
+
+1. Right-click on the first `DataGridView` and choose **Edit Columns...**.
+
+   ![Edit DataGridView columns](_static/winforms-edit-columns.png)
+
+2. Make the `CategoryId` column, which represents the primary key, read-only, and click **OK**.
+
+   ![Make CategoryId column read-only](_static/winforms-categoryid-read-only.png)
+
+3. Right-click on the second `DataGridView` and choose **Edit Columns...**. Make the `ProductId` column read-only, and remove the `CategoryId` and `Category` columns, then click **OK**.
+
+   ![Make ProductId column read-only and remove CategoryId and Category columns](_static/winforms-product-columns.png)
+
+## Connecting to EF Core
+
+The application now needs a small amount of code to connect EF Core to the data-bound controls.
+
+1. Open the `MainForm` code by right-clicking on the file and choosing **View Code**.
+
+   ![View Code](_static/winforms-view-code.png)
+
+2. Add a private field to hold the `DbContext` for the session, and add overrides for the `OnLoad` and `OnClosing` methods. The code should look like this:
+
+```csharp
+using Microsoft.EntityFrameworkCore;
+using System.ComponentModel;
+
+namespace GetStartedWinForms
+{
+    public partial class MainForm : Form
+    {
+        private ProductsContext? dbContext;
+
+        public MainForm()
+        {
+            InitializeComponent();
+        }
+
+        protected override void OnLoad(EventArgs e)
+        {
+            base.OnLoad(e);
+
+            this.dbContext = new ProductsContext();
+
+            // Uncomment the line below to start fresh with a new database.
+            // this.dbContext.Database.EnsureDeleted();
+            this.dbContext.Database.EnsureCreated();
+
+            this.dbContext.Categories.Load();
+
+            this.categoryBindingSource.DataSource = dbContext.Categories.Local.ToBindingList();
+        }
+
+        protected override void OnClosing(CancelEventArgs e)
+        {
+            base.OnClosing(e);
+
+            this.dbContext?.Dispose();
+            this.dbContext = null;
+        }
+    }
+}
+```
+
+The `OnLoad` method is called when the form is loaded. At this time
+
+- An instance of the `ProductsContext` is created that will be used to load and track changes to products and categories displayed by the application.
+- `EnsureCreated` is called on the `DbContext` to create the SQLite database if it does not already exist. This is a quick way to create a database when prototyping or testing applications. However, if the model changes, then the database will need to be deleted so that it can be created again. (The `EnsureDeleted` line can be un-commented to easily delete and re-create the database when the application is run.) You may instead wish to use [EF Core Migrations](xref:core/managing-schemas/migrations/index) to modify and update the database schema without losing any data.
+- `EnsureCreated` will also populate the new database with the data defined in the `ProductsContext.OnModelCreating` method.
+- The `Load` extension method is used to load all the categories from database into the `DbContext`. These entities will now be tracked by the `DbContext`, which will detect any changes made when the categories are edited by the user.
+- The `categoryBindingSource.DataSource` property is initialized to the categories that are being tracked by the `DbContext`. This is done by calling `Local.ToBindingList()` on the `Categories` `DbSet` property. `Local` provides access to a local view of the tracked categories, with events hooked up to ensure the local data stays in sync with the displayed data, and vice versa. `ToBindingList()` exposes this data as an `IBindingList`, which is understood by Windows Forms data binding.
+
+The `OnClosing` method is called when the form is closed. At this time, the `DbContext` is disposed, which ensures any database resources will be freed, and the `dbContext` field is set to null so that it cannot be used again.
+
+## Populating the Products view
+
+If the application is started at this point, then it should look something like this:
+
+![Fist run of the application](_static/winforms-first-run.png)
+
+Notice that the categories have been loaded from the database, but the products table remains empty. Also, the **Save** button does not work.
+
+To populate the products table, EF Core needs to load products from the database for the selected category. To achieve this:
+
+1. In the designer for the main form, select the `DataGridView` for categories.
+2. In the **Properties** for the `DataGridView`, choose the events (the lightning button), and double click the **SelectionChanged** event.
+
+   ![Add the SelectionChanged event](_static/winforms-selection-changed-event.png)
+
+   This will create stub in the main form code for an event to be fired whenever the category selection changes.  
+
+3. Fill in the code for the event:
+
+```csharp
+private void dataGridViewCategories_SelectionChanged(object sender, EventArgs e)
+{
+    if (this.dbContext != null)
+    {
+        var category = (Category)this.dataGridViewCategories.CurrentRow.DataBoundItem;
+
+        if (category != null)
+        {
+            this.dbContext.Entry(category).Collection(e => e.Products).Load();
+        }
+    }
+}
+```
+
+In this code, if there is an active (non-null) `DbContext` session, then we obtain the `Category` instance bound to the currently selected row of the `DataViewGrid`. (This may be `null` if the final row in the view is selected, which is used to create new categories.) If there is a selected category, then the `DbContext` is instructed to load the products associated with that category. This is done by:
+
+- Getting an `EntityEntry` for the `Category` instance (`dbContext.Entry(category)`)
+- Letting EF Core know that we want to operate on the `Products` collection navigation of that `Category` (`.Collection(e => e.Products)`)
+- And finally telling EF Core that we want to load that collection of products from the database (`.Load();`)
+
+> [!TIP]
+> When `Load` is called, EF Core will only access the database to load the products if they have not already been loaded.
+
+If the application is now run again, then it should load the appropriate products whenever a category is selected:
+
+![Products are loaded](_static/winforms-products-are-loaded.png)
+
+## Saving changes
+
+Finally, the **Save** button can be connected to EF Core so that any changes made to the products and categories are saved to the database.
+
+1. In the designer for the main form, select the **Save** button.
+2. In the **Properties** for the `Button`, choose the events (the lightning button), and double click the **Click** event.
+
+   ![Add the Click event for Save](_static/winforms-save-click-event.png)
+
+3. Fill in the code for the event:
+
+```csharp
+private void buttonSave_Click(object sender, EventArgs e)
+{
+    this.dbContext!.SaveChanges();
+
+    this.dataGridViewCategories.Refresh();
+    this.dataGridViewProducts.Refresh();
+}
+```
+
+This code calls `SaveChanges` on the `DbContext`, which saves any changes made to the SQLite database. If no changes were made, then this is a no-op, and no database call is made. After saving, the `DataGridView` controls are refreshed. This is because EF Core reads generated primary key values for any new products and categories from the database. Calling `Refresh` updates the display with these generated values.
+
+## The final application
+
+Here is the full code for the main form:
+
+[!code-csharp[](../../../samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/Form1.cs)]
+
+The application can now be run, and products and categories can be added, deleted, and edited. Notice that if the **Save** button is clicked before closing the application, then any changes made will be stored in the database and re-loaded when the application is re-started. If **Save** is not clicked, then any changes are lost when the application is re-started.
+
+> [!TIP]
+> A new category or product can be added to a `DataViewControl` using the empty row at the bottom of the control. A row can be deleted by selecting it and pressing the **Del** key.
+
+**Before saving**
+
+![The running application before clicking Save](_static/winforms-before-save.png)
+
+**After saving**
+
+![The running application after clicking Save](_static/winforms-after-save.png)
+
+Notice that the primary key values for the added category and products are populated when **Save** is clicked.
+
+## Learn more
+
+- [Configuring a DbContext](xref:core/dbcontext-configuration/index)
+- [Creating and configuring a model](xref:core/modeling/index)
+- [Managing Database Schemas](xref:core/managing-schemas/index)
+- [Querying Data](xref:core/querying/index)
+- [Change Tracking](xref:core/change-tracking/index)
+- [Saving Data](xref:core/saving/index)
+- [Databinding with the OOP Windows Forms Designer](https://devblogs.microsoft.com/dotnet/databinding-with-the-oop-windows-forms-designer/)
diff --git a/entity-framework/core/get-started/wpf.md b/entity-framework/core/get-started/wpf.md
new file mode 100644
index 0000000000..9b5c5ffa26
--- /dev/null
+++ b/entity-framework/core/get-started/wpf.md
@@ -0,0 +1,170 @@
+---
+title: Get Started with WPF - EF Core
+description: Getting started tutorial for using WPF with Entity Framework Core
+author: jeremylikness
+ms.author: jeliknes
+ms.date: 07/24/2020
+uid: core/get-started/wpf
+---
+# Getting Started with WPF
+
+This step-by-step walkthrough shows how to bind POCO types to WPF controls in a "main-detail" form. The application uses the Entity Framework APIs to populate objects with data from the database, track changes, and persist data to the database.
+
+The model defines two types that participate in one-to-many relationship: **Category** (principal\\main) and **Product** (dependent\\detail). The WPF data-binding framework enables navigation between related objects: selecting rows in the master view causes the detail view to update with the corresponding child data.
+
+The screen shots and code listings in this walkthrough are taken from Visual Studio 2019 16.6.5.
+
+> [!TIP]
+> You can view this article's [sample on GitHub](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/WPF).
+
+## Pre-Requisites
+
+You need to have Visual Studio 2019 16.3 or later installed with the **.NET desktop workload** selected to complete this walkthrough. For more information about installing the latest version of Visual Studio, see [Install Visual Studio](/visualstudio/install/install-visual-studio).
+
+## Create the Application
+
+1. Open Visual Studio
+2. On the start window, choose **Create new project**.
+3. Search for "WPF," choose **WPF App (.NET)** and then choose **Next**.
+4. At the next screen, give the project a name, for example, **GetStartedWPF**, and choose **Create.**
+
+## Install the Entity Framework NuGet packages
+
+1. Right-click on the solution and choose **Manage NuGet Packages for Solution...**
+
+    ![Manage NuGet Packages](_static/wpf-tutorial-nuget.jpg)
+
+1. Type `entityframeworkcore.sqlite` in the search box.
+1. Select the **Microsoft.EntityFrameworkCore.Sqlite** package.
+1. Check the project in the right pane and click **Install**
+
+    ![Sqlite Package](_static/wpf-tutorial-sqlite.jpg)
+
+1. Repeat the steps to search for `entityframeworkcore.proxies` and install **Microsoft.EntityFrameworkCore.Proxies**.
+
+> [!NOTE]
+> When you installed the Sqlite package, it automatically pulled down the related **Microsoft.EntityFrameworkCore** base package. The **Microsoft.EntityFrameworkCore.Proxies** package provides support for "lazy-loading" data. This means when you have entities with child entities, only the parents are fetched on the initial load. The proxies detect when an attempt to access the child entities is made and automatically loads them on demand.
+
+## Define a Model
+
+In this walkthrough you will implement a model using "code first." This means that EF Core will create the database tables and schema based on the C# classes you define.
+
+Add a new class. Give it the name: `Product.cs` and populate it like this:
+
+**`Product.cs`**
+
+[!code-csharp[](../../../samples/core/WPF/GetStartedWPF/GetStartedWPF/Product.cs)]
+
+Next, add a class named `Category.cs` and populate it with the following code:
+
+**`Category.cs`**
+
+[!code-csharp[](../../../samples/core/WPF/GetStartedWPF/GetStartedWPF/Category.cs)]
+
+The **Products** property on the **Category** class and **Category** property on the **Product** class are navigation properties. In Entity Framework, navigation properties provide a way to navigate a relationship between two entity types.
+
+In addition to defining entities, you need to define a class that derives from DbContext and exposes DbSet&lt;TEntity&gt; properties. The DbSet&lt;TEntity&gt; properties let the context know which types you want to include in the model.
+
+An instance of the DbContext derived type manages the entity objects during run time, which includes populating objects with data from a database, change tracking, and persisting data to the database.
+
+Add a new `ProductContext.cs` class to the project with the following definition:
+
+**`ProductContext.cs`**
+
+[!code-csharp[](../../../samples/core/WPF/GetStartedWPF/GetStartedWPF/ProductContext.cs)]
+
+* The `DbSet` informs EF Core what C# entities should be mapped to the database.
+* There are a variety of ways to configure the EF Core `DbContext`. You can read about them in: [Configuring a DbContext](xref:core/dbcontext-configuration/index).
+* This example uses the `OnConfiguring` override to specify a Sqlite data file.
+* The `UseLazyLoadingProxies` call tells EF Core to implement lazy-loading, so child entities are automatically loaded when accessed from the parent.
+
+Press **CTRL+SHIFT+B** or navigate to **Build &gt; Build Solution** to compile the project.
+
+> [!TIP]
+> Learn about the different was to keep your database and EF Core models in sync: [Managing Database Schemas](xref:core/managing-schemas/index).
+
+## Lazy Loading
+
+The **Products** property on the **Category** class and **Category** property on the **Product** class are navigation properties. In Entity Framework Core, navigation properties provide a way to navigate a relationship between two entity types.
+
+EF Core gives you an option of loading related entities from the database automatically the first time you access the navigation property. With this type of loading (called lazy loading), be aware that the first time you access each navigation property a separate query will be executed against the database if the contents are not already in the context.
+
+When using "Plain Old C# Object" (POCO) entity types, EF Core achieves lazy loading by creating instances of derived proxy types during runtime and then overriding virtual properties in your classes to add the loading hook. To get lazy loading of related objects, you must declare navigation property getters as **public** and **virtual** (**Overridable** in Visual Basic), and your class must not be **sealed** (**NotOverridable** in Visual Basic). When using Database First, navigation properties are automatically made virtual to enable lazy loading.
+
+## Bind Object to Controls
+
+Add the classes that are defined in the model as data sources for this WPF application.
+
+1. Double-click **MainWindow.xaml** in Solution Explorer to open the main form
+1. Choose the **XAML** tab to edit the XAML.
+1. Immediately after the opening `Window` tag, add the following sources to connect to the EF Core entities.
+
+    [!code-xaml[](../../../samples/core/WPF/GetStartedWPF/GetStartedWPF/MainWindow.xaml?range=1-13&highlight=9-13)]
+
+1. This sets up source for the "parent" categories, and second source for the "detail" products.
+1. Next, add the following markup to your XAML after the opening `Grid` tag.
+
+    [!code-xaml[](../../../samples/core/WPF/GetStartedWPF/GetStartedWPF/MainWindow.xaml?range=15-26)]
+
+1. Note that the `CategoryId` is set to `ReadOnly` because it is assigned by the database and cannot be changed.
+
+## Adding a Details Grid
+
+Now that the grid exists to display categories, the details grid can be added to show products. Add this inside the
+`Grid` element, after the categories `DataGrid` element.  
+
+**`MainWindow.xaml`**
+
+[!code-xaml[](../../../samples/core/WPF/GetStartedWPF/GetStartedWPF/MainWindow.xaml?range=27-40)]
+
+Finally, add a `Save` button and wire in the click event to `Button_Click`.
+
+[!code-xaml[](../../../samples/core/WPF/GetStartedWPF/GetStartedWPF/MainWindow.xaml?range=41-42)]
+
+Your design view should look like this:
+
+![Screenshot of WPF Designer](_static/wpf-tutorial-designer.jpg)
+
+## Add Code that Handles Data Interaction
+
+It's time to add some event handlers to the main window.
+
+1. In the XAML window, click on the **&lt;Window&gt;** element, to select the main window.
+1. In the **Properties** window choose **Events** at the top right, then double-click the text box to right of the **Loaded** label.
+
+    ![Main Window Properties](_static/wpf-tutorial-loaded.jpg)
+
+This brings you to the code behind for the form, we'll now edit the code to use the `ProductContext` to perform data access. Update the code as shown below.
+
+The code declares a long-running instance of `ProductContext`. The `ProductContext` object is used to query and save data to the database. The `Dispose()` method on the `ProductContext` instance is then called from the overridden `OnClosing` method. The code comments explain what each step does.
+
+**`MainWindow.xaml.cs`**
+
+[!code-csharp[](../../../samples/core/WPF/GetStartedWPF/GetStartedWPF/MainWindow.xaml.cs)]
+
+> [!NOTE]
+> The code uses a call to `EnsureCreated()` to build the database on the first run. This is acceptable for demos, but in production apps you should look at [migrations](xref:core/managing-schemas/migrations/index) to manage your schema. The code also executes synchronously because it uses a local SQLite database. For production scenarios that typically involve a remote server, consider using the asynchronous versions of the `Load` and `SaveChanges` methods.
+
+## Test the WPF Application
+
+Compile and run the application by pressing **F5** or choosing **Debug &gt; Start Debugging**. The database should be automatically created with a file named `products.db`. Enter a category name and hit enter, then add products to the lower grid. Click save and watch the grid refresh with the database provided ids. Highlight a row and hit **Delete** to remove the row. The entity will be deleted when you click **Save**.
+
+![Running application](_static/wpf-tutorial-app.jpg)
+
+## Property Change Notification
+
+This example relies on four steps to synchronize the entities with the UI.
+
+1. The initial call `_context.Categories.Load()` loads the categories data.
+1. The lazy-loading proxies load the dependent products data.
+1. EF Core's built-in change tracking makes the necessary modifications to entities, including insertions and deletions, when `_context.SaveChanges()` is called.
+1. The calls to `DataGridView.Items.Refresh()` force a reload with the newly generated ids.
+
+This works for our getting started sample, but you may require additional code for other scenarios. WPF controls render the UI by reading the fields and properties on your entities. When you edit a value in the user interface (UI), that value is passed to your entity. When you change the value of a property directly on your entity, such as loading it from the database, WPF will not immediately reflect the changes in the UI. The rendering engine must be notified of the changes. The project did this by manually calling `Refresh()`. An easy way to automate this notification is by implementing the [INotifyPropertyChanged](/dotnet/api/system.componentmodel.inotifypropertychanged) interface. WPF components will automatically detect the interface and register for change events. The entity is responsible for raising these events.
+
+> [!TIP]
+> To learn more about how to handle changes, read: [How to implement property change notification](/dotnet/framework/wpf/data/how-to-implement-property-change-notification).
+
+## Next Steps
+
+Learn more about [Configuring a DbContext](xref:core/dbcontext-configuration/index).
diff --git a/entity-framework/core/includes/managed-identities-test-non-production.md b/entity-framework/core/includes/managed-identities-test-non-production.md
new file mode 100644
index 0000000000..dedfb45f35
--- /dev/null
+++ b/entity-framework/core/includes/managed-identities-test-non-production.md
@@ -0,0 +1,10 @@
+---
+description: A local database that doesn't require the user to be authenticated
+author: rick-anderson
+ms.author: wpickett
+ms.date: 10/23/2024
+ms.topic: include
+title: an include file
+---
+> [!WARNING]
+> This article uses a local database that doesn't require the user to be authenticated. Production apps should use the most secure authentication flow available. For more information on authentication for deployed test and production apps, see [Secure authentication flows](/aspnet/core/security/#secure-authentication-flows).
diff --git a/entity-framework/core/index.md b/entity-framework/core/index.md
new file mode 100644
index 0000000000..c6482c1d05
--- /dev/null
+++ b/entity-framework/core/index.md
@@ -0,0 +1,61 @@
+---
+title: Overview of Entity Framework Core - EF Core
+description: General introductory overview of Entity Framework Core
+author: SamMonoRT
+ms.date: 9/20/2020
+uid: core/index
+---
+
+# Entity Framework Core
+
+Entity Framework (EF) Core is a lightweight, extensible, [open source](https://github.com/dotnet/efcore) and cross-platform version of the popular Entity Framework data access technology.
+
+EF Core can serve as an object-relational mapper (O/RM), which:
+
+* Enables .NET developers to work with a database using .NET objects.
+* Eliminates the need for most of the data-access code that typically needs to be written.
+
+EF Core supports many database engines, see [Database Providers](xref:core/providers/index) for details.
+
+## The model
+
+With EF Core, data access is performed using a model. A model is made up of entity classes and a context object that represents a session with the database. The context object allows querying and saving data. For more information, see [Creating a Model](xref:core/modeling/index).
+
+EF supports the following model development approaches:
+
+* Generate a model from an existing database.
+* Hand-code a model to match the database.
+* Once a model is created, use [EF Migrations](xref:core/managing-schemas/migrations/index) to create a database from the model. Migrations allow evolving the database as the model changes.
+
+[!code-csharp[Main](../../samples/core/Intro/Model.cs)]
+
+## Querying
+
+Instances of your entity classes are retrieved from the database using [Language Integrated Query (LINQ)](/dotnet/csharp/programming-guide/concepts/linq/). For more information, see [Querying Data](xref:core/querying/index).
+
+[!code-csharp[Main](../../samples/core/Intro/Program.cs#Querying)]
+
+## Saving data
+
+Data is created, deleted, and modified in the database using instances of your entity classes. See [Saving Data](xref:core/saving/index) to learn more.
+
+[!code-csharp[Main](../../samples/core/Intro/Program.cs#SavingData)]
+
+## EF O/RM considerations
+
+While EF Core is good at abstracting many programming details, there are some best practices applicable to any O/RM that help to avoid common pitfalls in production apps:
+
+* Intermediate-level knowledge or higher of the underlying database server is essential to architect, debug, profile, and migrate data in high performance production apps. For example, knowledge of primary and foreign keys, constraints, indexes, normalization, DML and DDL statements, data types, profiling, etc.
+* Functional and integration testing:  It's important to replicate the production environment as closely as possible to:
+  * Find issues in the app that only show up when using a specific version or edition of the database server.
+  * Catch breaking changes when upgrading EF Core and other dependencies. For example, adding or upgrading frameworks like ASP.NET Core, OData, or AutoMapper. These dependencies can affect EF Core in unexpected ways.
+* Performance and stress testing with representative loads. The naïve usage of some features doesn't scale well. For example, multiple collections Includes, heavy use of lazy loading, conditional queries on non-indexed columns, massive updates and inserts with store-generated values, lack of concurrency handling, large models, inadequate cache policy.
+* Security review: For example, handling of connection strings and other secrets, database permissions for non-deployment operation, input validation for raw SQL, encryption for sensitive data. See [Secure authentication flows](/aspnet/core/security/#secure-authentication-flows) for secure configuration and authentication flow.
+* Make sure logging and diagnostics are sufficient and usable. For example, appropriate logging configuration, query tags, and Application Insights.
+* Error recovery. Prepare contingencies for common failure scenarios such as version rollback, fallback servers, scale-out and load balancing, DoS mitigation, and data backups.
+* Application deployment and migration. Plan out how migrations are going to be applied during deployment; doing it at application start can suffer from concurrency issues and requires higher permissions than necessary for normal operation. Use staging to facilitate recovery from fatal errors during migration. For more information, see [Applying Migrations](xref:core/managing-schemas/migrations/applying).
+* Detailed examination and testing of generated migrations. Migrations should be thoroughly tested before being applied to production data. The shape of the schema and the column types cannot be easily changed once the tables contain production data. For example, on SQL Server, `nvarchar(max)` and `decimal(18, 2)` are rarely the best types for columns mapped to string and decimal properties, but those are the defaults that EF uses because it doesn't have knowledge of your specific scenario.
+
+## Next steps
+
+For introductory tutorials, see [Getting Started with Entity Framework Core](xref:core/get-started/overview/first-app).
diff --git a/entity-framework/core/learn-more/community-standups.md b/entity-framework/core/learn-more/community-standups.md
new file mode 100644
index 0000000000..d53d04be43
--- /dev/null
+++ b/entity-framework/core/learn-more/community-standups.md
@@ -0,0 +1,2012 @@
+---
+title: .NET Data Community Standups
+description: Details and links for each episode of the .NET Data Community Standup
+author: SamMonoRT
+ms.date: 02/23/2024
+uid: core/learn-more/community-standups
+---
+
+# .NET Data Community Standups
+
+The .NET Data Community Standups are live-streamed monthly (roughly) on Thursday (usually) to YouTube, Twitch, Facebook, and X. This is your opportunity to interact with the .NET Data team and community. All past episodes are [available on YouTube](https://aka.ms/efstandups) and are listed below with links to content from the shows.
+
+## Summary
+
+| Date         | Area                  | Title                                                                                    |
+|--------------|-----------------------|------------------------------------------------------------------------------------------|
+| Mar 19, 2026 | DevArt                | [How dotConnect + Entity Developer simplify your workflow](#Mar19_2026)                  |
+| Feb 12, 2026 | AI                    | [Adam tells us about Microsoft.Extensions.DataIngestion](#Feb12_2026)                    |
+| Nov 20, 2025 | Release               | [EF 10 release celebration 🎉](#Nov20_2025)                                              |
+| Oct 16, 2025 | Migrations            | [Jeremy Miller shares his view on migrations and Marten](#Oct16_2025)                    |
+| Sep 18, 2025 | ORMs                  | [Jiri and Nick talk about experience with Dapper and EF Core](#Sep18_2025)               |
+| Aug 21, 2025 | ORMs                  | [Learning about jOOQ with Lukas Eder](#Aug21_2025)                                       |
+| Jul 17, 2025 | Couchbase             | [Couchbase has an EF Core provider](#Jul17_2025)                                         |
+| Jun 19, 2025 | Vector databases      | [Microsoft.Extensions.VectorData - Access Vector databases in AI apps](#Jun19_2025)      |
+| May 14, 2025 | Azure SQL             | [Azure SQL vector search with Davide Mauri](#May14_2025)                                 |
+| Apr 24, 2025 | EF Core               | [Jiri and Shay talk about EF Core testing and Maurycy corrects them](#Apr24_2025)        |
+| Mar 19, 2025 | EF Core               | [Stop using Entity Framework as a DTO provider!](#Mar19_2025)                            |
+| Mar 6, 2025  | Chroma                | [Using Chroma vector database from .NET](#Mar06_2025)                                    |
+| Jan 22, 2025 | Tips                  | [Context pooling, FromSql and compiled queries](#Jan22_2025)                             |
+| Nov 20, 2024 | Release               | [EF Core 9: Release extravaganza](#Nov20_2024)                                           |
+| Jun 26, 2024 | SQL schemas           | [Improve your SQL schema and scripts with .NET based static code analysis](#June26_2024) |
+| May 15, 2024 | Firebird              | [Harnessing the Power of Firebird in .NET](#May15_2024)                                  |
+| Apr 17, 2024 | EF Core mapping       | [All about EF Core property mapping](#Apr17_2024)                                        |
+| Mar 20, 2024 | GraphQL               | [Distributed Applications with Hot Chocolate 14, Aspire, and EF Core](#Mar20_2024)       |
+| Mar 6, 2024  | Value generation      | [EF Core keys and value generation](#value-generation)                                   |
+| Feb 21, 2024 | SQL translation       | [Window and binary functions using Zomp EF Core extensions](#window-functions)           |
+| Feb 7, 2024  | Database concurrency  | [Database concurrency and EF Core: Beyond optimistic concurrency](#concurrency3)         |
+| Jan 24, 2024 | Database concurrency  | [Database concurrency and EF Core: ASP.NET and Blazor](#concurrency2)                    |
+| Jan 10, 2024 | Database concurrency  | [Database concurrency and EF Core](#concurrency1)                                        |
+| Nov 29, 2023 | New features          | [A tour of what's new in EF8](#new8)                                                     |
+| Oct 18, 2023 | Document databases    | [Introducing the MongoDB provider for EF Core](#mongo)                                   |
+| Oct 4, 2023  | New features          | [Size doesn't matter: Smaller features in EF8](#smaller)                                 |
+| Sep 20, 2023 | Complex types/DDD     | [Complex types as value objects in EF8](#complextypes)                                   |
+| Jun 14, 2023 | SQLite                | [Synchronizing data between the cloud and the client (using SQLite)](#zumero)            |
+| May 31, 2023 | Power Tools           | [New CLI edition of EF Core Power Tools](#power-tools)                                   |
+| May 17, 2023 | Primitive collections | [Collections of primitive values in EF Core](#primitive-collections)                     |
+| Apr 19, 2023 | EF internals          | [EF Core Internals - Model Building](#internals-models)                                  |
+| Mar 22, 2023 | HierarchyId           | [Using hierarchical data in SQL Server and PostgreSQL with EF Core](#hierarchyid)        |
+| Mar 8, 2023  | EF internals          | [EF Core internals: IQueryable, LINQ and the EF Core query pipeline](#internals-query)   |
+| Feb 22, 2023 | MySQL                 | [MySQL and .NET: MySqlConnector and the Pomelo EF Core Provider](#mysql)                 |
+| Feb 8, 2023  | SQLite                | [SQLite with .NET and EF Core](#sqlite)                                                  |
+| Jan 11, 2023 | FAQ                   | [Entity Framework Core FAQs](#faq)                                                       |
+| Dec 14, 2022 | EF Core plans         | [The Plan for Entity Framework Core 8](#plan8)                                           |
+| Nov 16, 2022 | New features          | [A Whirlwind Tour of EF7](#new-ef7)                                                      |
+| Nov 7, 2022  | Model building        | [EF7 Custom Model Conventions](#conventions)                                             |
+| Oct 19, 2022 | Bulk updates          | [New EF Core 7.0 APIs (Bulk Update)](#bulkcud)                                           |
+| Oct 5, 2022  | JSON mapping          | [JSON Columns](#json)                                                                    |
+| Sep 21, 2022 | Azure Mobile Apps     | [Azure Mobile Apps and offline sync](#offline-sync)                                      |
+| Aug 24, 2022 | SQL translation       | [New aggregate function support in EF Core 7](#ef7aggs)                                  |
+| Aug 10, 2022 | WCF                   | [CoreWCF: Roadmap and Q&A](#wcf)                                                         |
+| Jul 27, 2022 | ADO.NET               | [DbDataSource, a new System.Data abstraction](#dbdatasource)                             |
+| Jul 13, 2022 | EF Interceptors       | [Intercept this EF7 Preview 6 Event](#ef7interceptors)                                   |
+| Jun 29, 2022 | EF internals          | [DbContext Configuration and Lifetime - EF Core Architecture Part 2](#lifetimes)         |
+| Jun 15, 2022 | TPH/TPT/TPC           | [TPH, TPT, and TPC Inheritance mapping with EF Core](#inheritance)                       |
+| Jun 1, 2022  | EF internals          | [EF Core Architecture: Internal Dependency Injection](#internal-di)                      |
+| May 18, 2022 | Testing               | [Testing EF Core Apps (part 2)](#testing2)                                               |
+| May 4, 2022  | Pagination            | [Database Pagination](#pagination)                                                       |
+| Apr 20, 2022 | SaveChanges           | [Performance Improvements to the EF7 Update Pipeline](#update-perf)                      |
+| Apr 6, 2022  | Scaffolding           | [Database-first with T4 Templates in EF7: Early look](#t4)                               |
+| Mar 9, 2022  | GraphQL/OData         | [GraphQL and OData: An In-Depth Discussion](#graphql-odata)                              |
+| Feb 23, 2022 | Entity Framework      | [Celebrating 20 Years of .NET: Entity Framework](#20years)                               |
+| Feb 9, 2022  | Versioning            | [Software version and "stuff"](#stuff)                                                   |
+| Jan 26, 2022 | Testing               | [Testing EF Core Apps](#testing1)                                                        |
+| Jan 12, 2022 | EF Core plans         | [The EF7 Plan](#ef7plan)                                                                 |
+| Dec 1, 2021  | GraphQL               | [Hot Chocolate 12 and GraphQL 2021](#hotchoc12)                                          |
+| Nov 17, 2021 | New features          | [Make History and Explore the Cosmos, an EF Core 6 Retrospective](#retro6)               |
+| Nov 3, 2021  | Noda Time             | [Noda Time](#nodatime)                                                                   |
+| Oct 6, 2021  | Temporal tables       | [SQL Server Temporal Tables and EF Core 6](#temporal)                                    |
+| Oct 20, 2021 | Docs                  | [EF Core and ASP.NET Core from the ASP.NET documentation team](#aspnet)                  |
+| Sep 22, 2021 | PostgreSQL            | [PostgreSQL and EF Core](#npgsql)                                                        |
+| Aug 25, 2021 | Dapper                | [Dapper](#dapper)                                                                        |
+| Aug 11, 2021 | SQL translation       | [EF Core's Global Query Filter](#query-filters)                                          |
+| Jul 28, 2021 | OData                 | [OData](#odata)                                                                          |
+| Jul 14, 2021 | SQL translation       | [Visualizing database query plans](#query-plans)                                         |
+| Jun 16, 2021 | Azure Cosmos DB       | [Azure Cosmos DB and EF Core](#cosmos6)                                                  |
+| Jun 2, 2021  | Model building        | [Introducing EF Core Compiled Models](#compiled-models)                                  |
+| May 19, 2021 | GraphQL               | [Building Modern Apps with GraphQL](#graphql1)                                           |
+| May 5, 2021  | Triggers              | [Triggers for EF Core](#triggers)                                                        |
+| Apr 21, 2021 | Open source           | [Open Source Contributions: How to Add a Feature to EF Core](#contributing)              |
+| Apr 7, 2021  | Azure SQL             | [Azure SQL for Cloud-Born Applications and Developers](#davide)                          |
+| Mar 24, 2021 | EF Core Power Tools   | [EF Core Power Tools: the New Batch](#newbatch)                                          |
+| Mar 10, 2021 | AMA                   | [Julie Lerman and EF Core Ask Me Anything (AMA)](#julie)                                 |
+| Feb 24, 2021 | Performance           | [Performance Tuning an EF Core App](#jonp1)                                              |
+| Feb 10, 2021 | Exception handling    | [Typed Exceptions for Entity Framework Core](#typed-exceptions)                          |
+| Jan 27, 2021 | Database projects     | [Introducing MSBuild.Sdk.SqlProj](#sqlproj)                                              |
+| Jan 13, 2021 | Survey                | [EF Core 6.0 Survey Results](#survey)                                                    |
+| Dec 2, 2020  | LLBLGen Pro           | [LLBLGen designer and .NET data history](#frans)                                         |
+| Nov 18, 2020 | New features          | [Special EF Core 5.0 Community Panel](#efcore5)                                          |
+| Oct 28, 2020 | Collations            | [EF Core 5.0 Collations](#collations)                                                    |
+| Oct 14, 2020 | Azure Cosmos DB       | [Cosmos DB: Repository Pattern .NET Wrapper SDK](#repository)                            |
+| Sep 20, 2020 | Spatial types         | [Geographic Data with NetTopologySuite](#geo-nts)                                        |
+| Sep 16, 2020 | Migrations            | [What's New with Migrations in EF Core 5.0](#migrations5)                                |
+| Sep 2, 2020  | Offline sync          | [Sync your database with DotMim.Sync](#dotmin-sync)                                      |
+| Aug 19, 2020 | Many-to-many          | [Many-to-Many in EF Core 5.0](#many-to-many)                                             |
+| Aug 5, 2020  | EF in-depth           | [EF Core In Depth Video Series](#depth)                                                  |
+| Jul 22, 2020 | Scaffolding           | [Using Scaffolding with Handlebars](#handlebars)                                         |
+| Jun 24, 2020 | Blazor                | [EF Core in Blazor](#blazor)                                                             |
+| Jun 10, 2020 | EF Core Power Tools   | [EF Core Power Tools](#power-tools1)                                                     |
+| May 6, 2020  | Welcome!              | [Introducing the EF Core Community Standup](#one)                                        |
+
+## 2026
+
+<a name="Mar19_2026"></a>
+
+### Mar 19: [How dotConnect + Entity Developer simplify your workflow](https://www.youtube.com/live/2QX2qHvGbCE?si=xikIyOFYi3eTXLVx)
+
+Join us for a show where DevArt will show us how dotConnect and Entity Developer simplify your workflow in .NET development.
+
+Featuring:
+
+- [Yurii Hryhoriev](https://www.linkedin.com/in/yuriihryhoriev) (Special guest)
+- [Jiri Cincura](https://www.tabsoverspaces.com/) (Host)
+
+Links:
+
+- [dotConnect](https://www.devart.com/dotconnect/)
+- [Entity Developer](https://www.devart.com/entitydeveloper/)
+
+<a name="Feb12_2026"></a>
+
+### Feb 12: [Adam tells us about Microsoft.Extensions.DataIngestion](https://www.youtube.com/live/pQivzi4n6jM?si=Ms9H0O3Mgw147hhj)
+
+Microsoft.Extensions.DataIngestion is new addition into Microsoft.Extensions collection and this one touches databases and AI. Exciting. Adam Sitnik, who worked on implementation, tells us what's what and maybe some behind the scenes.
+
+Featuring:
+
+- [Adam Sitnik](https://github.com/adamsitnik) (Special guest)
+- [Jiri Cincura](https://www.tabsoverspaces.com/) (Host)
+
+Links:
+
+- [Introducing Data Ingestion Building Blocks (Preview)](https://devblogs.microsoft.com/dotnet/introducing-data-ingestion-building-blocks-preview/)
+- [dotnet/extensions GitHub](https://github.com/dotnet/extensions)
+- Template: `Microsoft.Extensions.AI.Templates`
+
+## 2025
+
+<a name="Nov20_2025"></a>
+
+### Nov 20: [EF 10 release celebration 🎉](https://www.youtube.com/live/3Aqd_arD6Vo?si=dWGNOSEnw1G2frfc)
+
+Join the EF team to celebrate EF 10 release, ask questions and get juicy behind the scenes stories. 😉
+
+Featuring:
+
+- [Andriy Svyryd](https://github.com/AndriySvyryd) (Special guest)
+- [Shay Rojansky](https://www.roji.org/) (Special guest)
+- [Jiri Cincura](https://www.tabsoverspaces.com/) (Special guest)
+- [Sam Patel](https://github.com/SamMonoRT) (Special guest)
+
+<a name="Oct16_2025"></a>
+
+### Oct 16: [Jeremy Miller shares his view on migrations and Marten](https://www.youtube.com/live/_ICoF0utyt4?si=Mrcy0WbQ8f74dOXE)
+
+Join the .NET Data Community team as we welcome Jeremy Miller, developer of Marten, to share his insights on database migrations and the evolving capabilities of Marten.
+
+Featuring:
+
+- [Jeremy Miller](https://jeremydmiller.com/) (Special guest)
+- [Jiri Cincura](https://www.tabsoverspaces.com/) (Host)
+
+Links:
+
+- [Bluesky post](https://bsky.app/profile/jeremydmiller.bsky.social/post/3lp7m2renvk2u)
+- [Marten](https://martendb.io/)
+- [Wolverine](https://wolverinefx.io/)
+- [JasperFX](https://jasperfx.net/)
+- [Sable](https://bloomberg.github.io/sable/)
+
+<a name="Sep18_2025"></a>
+
+### Sep 18: [Jiri and Nick talk about experience with Dapper and EF Core](https://www.youtube.com/live/ppaf8CZjRkI?si=dcJ9vJAaJPJ8thuC)
+
+Join Jiri and Nick as they share their hands-on experiences working with Dapper and Entity Framework Core in real-world .NET projects. They'll compare the strengths and trade-offs of each approach. Expect practical insights, tips, and honest reflections on when and why to choose one over the other.
+
+Featuring:
+
+- [Nick Cosentino](https://www.devleader.ca/) (Special guest)
+- [Jiri Cincura](https://www.tabsoverspaces.com/) (Host)
+
+Links:
+
+- [Bluesky post](https://bsky.app/profile/devleader.ca/post/3liumptsj7l2b)
+- [StronglyTypedId](https://github.com/andrewlock/StronglyTypedId)
+- [Dev Leader YouTube Channel](https://www.youtube.com/@devleader)
+- [Code Commute YouTube Channel](https://www.youtube.com/@codecommute)
+- [All Nick's Links](https://linktr.ee/devleader)
+
+<a name="Aug21_2025"></a>
+
+### Aug 21: [Learning about jOOQ with Lukas Eder](https://www.youtube.com/live/EbFqlYPvAE4?si=O2ifWoBfxNSS5zL9)
+
+Join us for another community standup where we welcome Lukas Eder, author of jOOQ, to show us what it can do, and what inspiration we can get for EF from it.
+
+Featuring:
+
+- [Lukas Eder](https://blog.jooq.org/author/lukaseder/) (Special guest)
+- [Jiri Cincura](https://www.tabsoverspaces.com/) (Host)
+- [Shay Rojansky](https://www.roji.org/) (Host)
+
+Links:
+
+- [jOOQ](https://www.jooq.org/)
+
+<a name="Jul17_2025"></a>
+
+### Jul 17: [Couchbase has an EF Core provider](https://www.youtube.com/live/0UDFJvMg5Wc?si=lnIptXlNblaplGOC)
+
+Couchbase recently released their provider for EF Core. Let's chat with the team about Couchbase, the provider and challenges fitting Couchbase concepts into EF Core's world.
+
+Featuring:
+
+- [Couchbase Team](https://www.couchbase.com/) (Special guest)
+- [Jiri Cincura](https://www.tabsoverspaces.com/) (Host)
+
+Links:
+
+- [Couchbase Capella](https://cloud.couchbase.com/sign-up)
+
+<a name="Jun19_2025"></a>
+
+### Jun 19: [Microsoft.Extensions.VectorData - Access Vector databases in AI apps](https://www.youtube.com/live/BB_jMqqfay8?si=FnweRmkypwoB8Px8)
+
+Join us for another .NET Data Community Standup where Shay tells us about Microsoft.Extensions.VectorData.
+
+Featuring:
+
+- [Shay Rojansky](https://www.roji.org/) (Host)
+- [Jiri Cincura](https://www.tabsoverspaces.com/) (Host)
+
+Links:
+
+- Docs: [Out-of-the-box Vector Store connectors](/semantic-kernel/concepts/vector-store-connectors/out-of-the-box-connectors)
+
+<a name="May14_2025"></a>
+
+### May 14: [Azure SQL vector search with Davide Mauri](https://www.youtube.com/live/RksCLw2OU_M?si=7NjaVS4dB2L0iGl7)
+
+We welcome Davide Mauri, Principal Product Manager at Microsoft, to explore the exciting new vector search capabilities in Azure SQL. With the rise of AI-powered applications and semantic search, vector databases are more relevant than ever. In this session, Davide will demonstrate how Azure SQL is evolving to meet these modern needs with integrated vector search features.
+
+Featuring:
+
+- [Davide Mauri](https://www.davidemauri.it/) (Special guest)
+- [Jiri Cincura](https://www.tabsoverspaces.com/) (Host)
+- [Shay Rojansky](https://www.roji.org/) (Host)
+
+Links:
+
+- <https://azuresql.dev>
+- <https://ai.awesome.azuresql.dev/>
+- <https://github.com/Azure-Samples/azure-sql-db-vector-search/tree/main/Hybrid-Search>
+- <https://github.com/Azure-Samples/azure-sql-db-chat-sk>
+
+<a name="Apr24_2025"></a>
+
+### Apr 24: [Jiri and Shay talk about EF Core testing and Maurycy corrects them](https://www.youtube.com/live/FV5e3-5IOuw?si=QetyyWOSW1xYJ2LS)
+
+Jiri and Shay talk about how we test whole EF Core and Maurycy corrects them, because they have it wrong.
+
+Featuring:
+
+- [Maurycy Markowski](https://github.com/maumar) (Special guest)
+- [Jiri Cincura](https://www.tabsoverspaces.com/) (Host)
+- [Shay Rojansky](https://www.roji.org/) (Host)
+
+Links:
+
+- Demo: <https://github.com/ChrisKlug/efcore-dto-demo>
+
+<a name="Mar19_2025"></a>
+
+### March 19: [Stop using Entity Framework as a DTO provider!](https://www.youtube.com/live/zlxhZhVu1O8?si=LbzOSpO3PUTN18Sf)
+
+Chris Klug has some opinions about Entity Framework and wants you to know about them…
+
+Featuring:
+
+- [Chris Klug](https://www.fearofoblivion.com/) (Special guest)
+- [Jiri Cincura](https://www.tabsoverspaces.com/) (Host)
+- [Shay Rojansky](https://www.roji.org/) (Host)
+
+Links:
+
+- Demo: <https://github.com/ChrisKlug/efcore-dto-demo>
+
+<a name="Mar06_2025"></a>
+
+### March 6: [Using Chroma vector database from .NET](https://www.youtube.com/live/Nj0vYJ9HVGk?si=fZG7B4dl7YlR4Saj)
+
+Join Jiri as he talks about Chroma vector database and fresh new library for .NET that you can use to interact with Chroma.
+
+Featuring:
+
+- [Jiri Cincura](https://www.tabsoverspaces.com/) (Host)
+- [Shay Rojansky](https://www.roji.org/) (Host)
+
+<a name="Jan22_2025"></a>
+
+### January 22: [Context pooling, FromSql and compiled queries](https://www.youtube.com/live/lAP2nlA6ijw?si=jq7XhqVwmLi_Yt7c)
+
+Join us for another .NET Data Community Standup with Chris Woodruff where he talks about context pooling, FromSql and compiled queries.
+
+Featuring:
+
+- [Chris Woodruff](https://woodruff.dev/) (Special guest)
+- [Jiri Cincura](https://www.tabsoverspaces.com/) (Host)
+- [Shay Rojansky](https://www.roji.org/) (Host)
+
+## 2024
+
+<a name="Nov20_2024"></a>
+
+### November 20: [EF Core 9: Release extravaganza](https://www.youtube.com/live/wG8D5HJMzjA?si=239r9dKJhBxilQ2e)
+
+EF Core 9 was just released. Join us in this special session talking with industry experts about all topic EF Core.
+
+Featuring:
+
+- [Erik Ejlskov Jensen](https://erikej.github.io) (Special guest)
+- [Julie Lerman](https://thedatafarm.com/) (Special guest)
+- [Jiri Cincura](https://github.com/cincuranet) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+<a name="June26_2024"></a>
+
+### June 26: [Improve your SQL schema and scripts with .NET based static code analysis](https://www.youtube.com/live/yIOFMHzaKGs?si=YuvPQNKpKomd0wue)
+
+By harnessing the power of the .NET DacFX framework and the related .NET T-SQL parser, you can improve the quality of your database schema and scripts with static T-SQL analysis.
+
+[@ErikEJ](https://github.com/ErikEJ) has recently revived this 15-year-old technology with support for .NET 6 and later, and has brought a number of third-party rules back from the grave.
+
+In this EF Core community standup we will have a closer look - from generation of a simple HTML report with findings to managing and creating your own analyzer rules using modern .NET.
+
+Featuring:
+
+- [Erik Ejlskov Jensen](https://github.com/ErikEJ) (Special guest)
+- [Jiri Cincura](https://github.com/cincuranet) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Blog: [How to: Code analyze your SQL Server T-SQL scripts in Visual Studio](https://erikej.github.io/dacfx/codeanalysis/sqlserver/2024/04/02/dacfx-codeanalysis.html)
+- Blog: [Create a Custom Static Code Analysis Rule for Azure SQL Database / SQL Server with .NET](https://erikej.github.io/dacfx/dotnet/2024/04/04/dacfx-rules.html)
+- Product: [EF Core Power Tools - Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=ErikEJ.EFCorePowerTools&ssr=false#overview)
+
+<a name="May15_2024"></a>
+
+### May 15: [Harnessing the Power of Firebird in .NET](https://www.youtube.com/live/ouGIWUtzxRQ?si=qtZ1xqKjKe_E1MhI)
+
+In this community talk, we delve into the integration of Firebird, an open-source SQL relational database management system, with .NET, a free, cross-platform, open-source developer platform. This session aims to provide an understanding of how these two powerful technologies can be combined to create robust, scalable, and efficient applications.
+
+This talk is designed for developers of all levels interested in expanding their knowledge on database management and .NET development. Whether you're a seasoned developer or a beginner looking to broaden your skill set, this talk will provide valuable insights into the effective use of Firebird with .NET.
+
+Join us for this enlightening session and discover how you can harness the power of Firebird in .NET to take your applications to the next level.
+
+Featuring:
+
+- [Jiri Cincura](https://github.com/cincuranet) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Product: [Firebird](https://firebirdsql.org/)
+- NuGet: [FirebirdSql.Data.FirebirdClient](https://www.nuget.org/packages/FirebirdSql.Data.FirebirdClient)
+- Blog: [FbNetExternalEngine](https://www.tabsoverspaces.com/tools/fb-net-external-engine)
+- Tool used in the stream: [Database.NET](https://fishcodelib.com/database.htm)
+- Docs: [What's new in EF9, with runnable samples](https://aka.ms/ef9-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="Apr17_2024"></a>
+
+### Apr 17: [All about EF Core property mapping](https://www.youtube.com/live/ouGIWUtzxRQ?si=qtZ1xqKjKe_E1MhI)
+
+In this episode, Arthur Vickers and Jiri Cincura from the EF team discuss everything about mapping properties in EF Core. We’ll look at:
+
+- The differences between properties and navigations.
+- How EF decides to map a property, and whether it is mapped to a nullable column, has a max length defined, etc.
+- When backing fields are used, and mapping fields directly.
+- Shadow properties.
+- Indexer properties.
+
+And if we get time, we’ll look at how value converters influence all this!
+
+Featuring:
+
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Jiri Cincura](https://github.com/cincuranet) (Host)
+
+Links:
+
+- GitHub: [Code from the standup](https://github.com/ajcvickers/PropertyMapping)
+- Docs: [What's new in EF9, with runnable samples](https://aka.ms/ef9-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="Mar20_2024"></a>
+
+### Mar 20: [Building Distributed Applications with Hot Chocolate 14, Aspire, and Entity Framework](https://www.youtube.com/live/JjT9pg6oGsE?si=jFykuE06ZFeHGEDJ)
+
+Building and debugging distributed systems challenges developers to balance complexity with the need for simplicity. Ideally, we aim for the simplicity of a monolith while benefiting from microservices' scalability and isolation. In todays meetup we will have an early look at what we are doing with Hot Chocolate 14 to integrate well with Aspire and bridge this gap, offering an approach that combines microservices' advantages with the ease of a monolith for our consumers. Also we will have a look at a lot of the new feature around Hot Chocolate 14 that will make it so much easier to build layered services with entity framework. Do not worry! We will start slow with just the simplest of services accessing a database and then go all the way in.
+
+Featuring:
+
+- [Michael Staib](https://github.com/michaelstaib) (Special guest)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+- [Jiri Cincura](https://github.com/cincuranet) (Host)
+
+Links:
+
+- Product: [Hot Chocolate for GraphQL](https://chillicream.com/docs/hotchocolate)
+- Docs: [Hot Chocolate and Entity Framework Core](https://chillicream.com/docs/hotchocolate/integrations/entity-framework)
+
+<a name="value-generation"></a>
+
+### Mar 6: [EF Core keys and value generation](https://www.youtube.com/live/_eNPkrTuLvE?si=RuZUFoLqF2QnwbvF)
+
+In this episode, Arthur and members of the EF Team will explore generated property values and how value generation interacts with keys in the model. We will look at fully client-side value generation, as well as how to use identity columns, database sequences, or a hi-lo pattern for server-side generation. In addition, we’ll investigate how generated key values impact EF Core change tracking by determining if an entity will go into the `Added` state or not. And finally, if we have time, we’ll look at special considerations for TPC mapping, and customizations such as setting before and after save behaviors, and sentinel values.
+
+Featuring:
+
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- GitHub: [Code from the standup](https://github.com/ajcvickers/Keys)
+- Docs: [What's new in EF9, with runnable samples](https://aka.ms/ef9-new)
+- Docs: [What's new in EF8, with runnable samples](https://aka.ms/ef8-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="window-functions"></a>
+
+### February 21: [Window and binary functions using Zomp EF Core extensions](https://www.youtube.com/live/Z9SkvUuU9Sc?si=xX3rRG3Xr3R9Zj5o)
+
+Window functions are one of the most powerful features of SQL. Did you know that you can use Window Functions in EF Core today instead of writing raw SQL? Victor Irzak joins Shay and Arthur to explore real use cases of window functions with EF Core.
+
+Featuring:
+
+- [Victor Irzak](https://github.com/virzak) (Special guest)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- GutHub: [Zomp EF Core Extensions](https://github.com/zompinc/efcore-extensions)
+- NuGet:
+  - [Zomp.EFCore.WindowFunctions.SqlServer](https://www.nuget.org/packages/Zomp.EFCore.WindowFunctions.SqlServer)
+  - [Zomp.EFCore.WindowFunctions.Npgsql](https://www.nuget.org/packages/Zomp.EFCore.WindowFunctions.Npgsql)
+  - [Zomp.EFCore.WindowFunctions.Sqlite](https://www.nuget.org/packages/Zomp.EFCore.WindowFunctions.Sqlite)
+- Blog: [EF8 release post on the .NET Blog](https://aka.ms/ef8)
+- Docs: [What's new in EF8, with runnable samples](https://aka.ms/ef8-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="concurrency3"></a>
+
+### February 7: [Database concurrency and EF Core: Beyond optimistic concurrency](https://www.youtube.com/live/0eVTR5up2RY?si=pttR5NJ85_NWozhj)
+
+In the 3rd installment of our series on concurrency, we'll dive deep into SQL isolation levels, how they work (and work differently!) across SQL Server and PostgreSQL. We'll hopefully learn a bit about how database locks, snapshots and isolation levels work together to bring some sanity into the world of concurrency.
+
+Featuring:
+
+- [Shay Rojansky](https://github.com/roji) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+
+Links:
+
+- Blog: [SQL Server Isolation Levels : A Series](https://sqlperformance.com/2014/07/t-sql-queries/isolation-levels)
+- Blog: [Transaction isolation in PostgreSQL](https://www.postgresql.org/docs/current/transaction-iso.html)
+- Blog: [EF8 release post on the .NET Blog](https://aka.ms/ef8)
+- Docs: [What's new in EF8, with runnable samples](https://aka.ms/ef8-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="concurrency2"></a>
+
+### January 24: [Database concurrency and EF Core: ASP.NET and Blazor](https://www.youtube.com/live/xVyYrtetDeA?si=Bx2s44mk_ayUnAzx)
+
+In the last episode, we dug deep into the underpinnings of optimistic concurrency handling in EF Core. In this episode, we continue that journey to cover disconnected scenarios. That is, where the entity travels to a client and then back to the server before being updated in the database. We’ll look at the different patterns for doing updates like this in ASP.NET Core and Blazor apps and see how concurrency tokens work with each of these. We’ll also look at how `ExecuteUpdate` can be used with concurrency tokens, and take a look at ETag concurrency in Azure Cosmos DB.
+
+Featuring:
+
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Docs: [Handling Concurrency Conflicts](xref:core/saving/concurrency)
+- Blog: [EF8 release post on the .NET Blog](https://aka.ms/ef8)
+- Docs: [What's new in EF8, with runnable samples](https://aka.ms/ef8-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="concurrency1"></a>
+
+### January 10: [Database concurrency and EF Core](https://www.youtube.com/live/YfIM-gfJe4c?si=ZQNxpGEULZt3L43I)
+
+What happens when one user is reading a record while another user is updating it? What if both users try to update the same record at the same time? In this episode of the .NET Data Community Standup, Shay and Arthur take a look at how different database isolation levels impact concurrency and performance, and then extend this to optimistic concurrency patterns supported by Entity Framework Core. This includes both manual concurrency tokens and automatic concurrency tokens like SQL Server’s “rowversion”. We’ll also dig into what happens in disconnected scenarios, and when to use the original value as opposed to the current value of the concurrency token. Finally, we’ll look at how EF Core handles optimistic concurrency with ETags when using a document database like Azure Cosmos DB.
+
+Featuring:
+
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Docs: [Handling Concurrency Conflicts](xref:core/saving/concurrency)
+- Blog: [EF8 release post on the .NET Blog](https://aka.ms/ef8)
+- Docs: [What's new in EF8, with runnable samples](https://aka.ms/ef8-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+## 2023
+
+<a name="new8"></a>
+
+### November 29: [A tour of what's new in EF8](https://www.youtube.com/live/5HapqzoxJ60?si=DXxh9jo8X16-rETm)
+
+Arthur and Shay from the EF team are joined by members of the community to demo some of the key new features available now in Entity Framework Core 8. For example:
+
+- Primitive collections
+- Complex types
+- HierarchyId in .NET and EF Core
+- Raw SQL queries for unmapped types
+- Lazy-loading enhancements
+- Lookup tracked entities by PK/AK/FK
+- DateOnly/TimeOnly supported on SQL Server
+- Sentinel values and database defaults
+
+Featuring:
+
+- [Erik Ejlskov Jensen](https://github.com/ErikEJ) (Special guest)
+- [Julie Lerman](https://github.com/julielerman) (Special guest)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Alumnus)
+- [Diego Vega](https://github.com/divega) (Alumnus)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+- [Brice Lambson](https://github.com/bricelam) (Host)
+
+Links:
+
+- Blog: [EF8 release post on the .NET Blog](https://aka.ms/ef8)
+- Docs: [What's new in EF8, with runnable samples](https://aka.ms/ef8-new)
+- Video: [Entity Framework Core 8: Improved JSON, queryable collections, and more… | .NET Conf 2023](https://aka.ms/ef8-dotnetconf)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="mongo"></a>
+
+### October 18: [Introducing the MongoDB provider for EF Core](https://www.youtube.com/live/Zat-ferrjro?si=UKIgjsB5RpnEqJUo)
+
+In this episode of the .NET Data Community Standup, we talk to the engineers from MongoDB who have just released the first preview of an official EF Core provider. The EF team has collaborated closely with MongoDB on this provider, which now joins the Cosmos provider as flagship document database providers for EF Core. We will demo the provider, talk about what it can and cannot do, and of course answer all your questions!
+
+Featuring:
+
+- [James Kovacs](https://github.com/JamesKovacs) (Special guest)
+- [Damien Guard](https://github.com/damieng) (Special guest)
+- [Patrick Gilfether](https://www.linkedin.com/in/patrick-gilfether) (Special guest)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Blog: [MongoDB Provider for Entity Framework Core Now Available in Public Preview](https://www.mongodb.com/blog/post/mongodb-provider-entity-framework-core-now-available-public-preview)
+- Blog: [Trying out MongoDB with EF Core using Testcontainers](https://devblogs.microsoft.com/dotnet/efcore-mongodb/)
+- Docs: [What's new in EF8, with runnable samples](https://aka.ms/ef8-new)
+- Video: [Entity Framework Core 8: Improved JSON, queryable collections, and more… | .NET Conf 2023](https://aka.ms/ef8-dotnetconf)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="smaller"></a>
+
+### October 4: [Size doesn't matter: Smaller features in EF8](https://www.youtube.com/live/GGDv_p4LAL8?si=WfswHDLiYnMMe4Hm)
+
+In addition to the big features such as primitive collections and complex types, EF8 contains many smaller features and minor improvements. In this session, Arthur and Shay from the EF team will take a look at a few of these smaller features, including:
+
+- Sentinels to control when the database generates a value
+- Massive performance improvements for IN and EXISTS in LINQ queries
+- DateOnly/TimeOnly on SQL Server
+- Raw SQL queries for unmapped types
+- More flexible ExecuteUpdate
+- Numeric SQL rowversion properties
+- Cleaner SQL through parentheses elimination
+
+Featuring:
+
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Docs: [What's new in EF8, with runnable samples](https://aka.ms/ef8-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="complextypes"></a>
+
+### September 20: [Complex types as value objects in EF8](https://www.youtube.com/live/H-soJYqWSds?si=tJzm-uqLL0ZJnsUh)
+
+The Entity Framework team returns with new community standups after a summer break heads-down working on EF8. In this session, we’ll look at the new “complex types” feature in EF8. Complex types do not have a key or any identity outside of the object’s value, but can still be deconstructed by property to map to different columns in the database. This allows either reference or value types to be used as DDD value objects with much better fidelity than when owned types are used. We’ll show examples of using complex types and talk about and answer your questions on the behavioral differences between entity types, owned entity types, complex types, and primitive types.
+
+Featuring:
+
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Docs: [Unicode and UTF-8 in SQL Server with EF Core](xref:core/providers/sql-server/columns#unicode-and-utf-8)
+- Docs: [What's new in EF8, with runnable samples](https://aka.ms/ef8-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="zumero"></a>
+
+### June 14: [Synchronizing data between the cloud and the client (using SQLite)](https://www.youtube.com/live/QTvFiiST-r4?si=9SOUVhwz75VplWad)
+
+In this session, we'll invite Eric Sink to discuss a solution for keeping a synchronized copy of the DB (using SQLite) on the client, rather than asking data for the cloud every time. This is helpful for mobile scenarios where the connectivity may be poor, but the "rep and sync" approach can reduce the time the user spends waiting on the network.  Local writes are fast, sync happens in the background. We'll explore how this can be done efficiently, how to deal with conflict resolution, and other data sync-related concerns.
+Featuring:
+
+- [Eric Sink](https://github.com/ericsink) (Special guest)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Product: [Zumero](https://www.zumero.com/)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="power-tools"></a>
+
+### May 31: [New CLI edition of EF Core Power Tools](https://www.youtube.com/live/vGvBAoP3nVY?si=VhwBYYdc0F3OSgOu)
+
+In today's standup, Erik will demonstrate the new CLI edition of EF Core Power Tools and show how he used a number of community NuGet packages to improve the user experience when creating a CLI tool.
+
+Featuring:
+
+- [Erik Ejlskov Jensen](https://github.com/ErikEJ) (Special guest)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Brice Lambson](https://github.com/bricelam) (Host)
+
+Links:
+
+- Visual Studio Marketplace: [EF Core Power Tools](https://marketplace.visualstudio.com/items?itemName=ErikEJ.EFCorePowerTools&ssr=false#review-details)
+- GitHub: [ErikEJ/EFCorePowerTools](https://github.com/ErikEJ/EFCorePowerTools)
+- Docs: [What's new in EF8, with runnable samples](https://aka.ms/ef8-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="primitive-collections"></a>
+
+### May 17: [Collections of primitive values in EF Core](https://www.youtube.com/live/AUS2OZjsA2I?si=V8hR14VyBtHuvbmp)
+
+In this episode of the .NET Data Community Standup, the .NET Data Access team dive into new support for collections of primitive values, just released in EF Core 8 Preview 4. Collections of a primitive type can now be used as properties of an entity type and will be mapped to a JSON column in the relational database. In addition, parameters of primitive values can be passed to the database. In either case, the native JSON processing capabilities of the database are then used to exact and manipulate the primitive values, just as if they were in a table. This opens up powerful query possibilities, as well as optimizations to common problems such as translating queries that use Contains.
+
+Featuring:
+
+- [Shay Rojansky](https://github.com/roji) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+
+Links:
+
+- Docs: [What's new in EF8, with runnable samples](https://aka.ms/ef8-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="internals-models"></a>
+
+### Apr 19: [EF Core Internals – Model Building](https://www.youtube.com/live/FYz0rAxQkC8?si=GsLuBBByuQbMurYP)
+
+In this session, the .NET Data Access team will dig into the EF Core internals for building a model. EF models are built using a combination of three mechanisms: conventions, mapping attributes, and the model builder API. We will explain each of these mechanisms and show how they interact. We’ll also cover how models are cached, and ways in which that caching can be controlled. And, as always, we’ll answer your questions live!
+Featuring:
+
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Docs: [What's new in EF8, with runnable samples](https://aka.ms/ef8-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="hierarchyid"></a>
+
+### Mar 22: [Using hierarchical data in SQL Server and PostgreSQL with EF Core](https://www.youtube.com/live/pmnHGWYpCfg?si=h_v40tZ7NEw_wZ6W)
+
+Join the .NET Data Access Team to learn about mapping hierarchical data structures to relational databases using EF Core. We’ll look at “hierarchyid” on SQL Server/Azure SQL and “ltree” on PostgresSQL, and show how to map tree structures such as a family tree, file system, or organization structure. EF Core can then be used to write LINQ queries against the hierarchy to find ancestors and descendants in various ways, as well as perform manipulation of subtrees for updates. And, as always, we’ll be here to answer your questions!
+
+Featuring:
+
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+- [Brice Lambson](https://github.com/bricelam) (Host)
+
+Links:
+
+- GitHub: [ajcvickers/HierarchySample](https://github.com/ajcvickers/HierarchySample)
+- Docs: [What's new in EF8, with runnable samples](https://aka.ms/ef8-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="internals-query"></a>
+
+### Mar 8: [EF Core internals: IQueryable, LINQ and the EF Core query pipeline](https://www.youtube.com/live/1Ld3dtnTrMw?si=xWhbADioxqquACBi)
+
+In this standup, we'll dive deep under the hood to see how EF Core processes LINQ queries, translates them to SQL and executes them on your database. We'll introduce key concepts such as IQueryable and LINQ providers, and see how EF Core uses caching to make your querying lightning-fast. Join us to understand how the magic works!
+
+Featuring:
+
+- [Shay Rojansky](https://github.com/roji) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+
+Links:
+
+- Docs: [What's new in EF8, with runnable samples](https://aka.ms/ef8-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="mysql"></a>
+
+### Feb 22: [MySQL and .NET: MySqlConnector and the Pomelo EF Core Provider](https://www.youtube.com/live/XSEYNocnzlI?si=WdBnhu_kDewO1TbN)
+
+This week, we'll be hosting Bradley Grainger and Laurents Meyer, authors of the open-source MySQL ADO.NET driver and of the Pomelo EF Core provider. Both these components work together to provide a 1st-class MySQL data access experience in .NET. We'll discuss some of the specifities of MySQL as a database, what it's like to work on open source data projects in .NET, and whatever else comes to mind!
+
+Featuring:
+
+- [Bradley Grainger](https://github.com/bgrainger) (Special guest)
+- [Laurents Meyer](https://github.com/lauxjpn) (Special guest)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+- [Jiachen Jiang](https://github.com/jcjiang) (Host)
+
+Links:
+
+- GitHub:
+  - [Pomelo.EntityFrameworkCore.MySql](https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql)
+  - [MySqlConnector](https://github.com/mysql-net/MySqlConnector)
+- NuGet:
+  - [Pomelo.EntityFrameworkCore.MySql](https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql/)
+  - [Pomelo.EntityFrameworkCore.MySql.Json.Microsoft](https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql.Json.Microsoft/)
+  - [Pomelo.EntityFrameworkCore.MySql.Json.Newtonsoft](https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql.Json.Newtonsoft/)
+  - [Pomelo.EntityFrameworkCore.MySql.Json.NetTopologySuite](https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql.NetTopologySuite/)
+  - [MySqlConnector](https://www.nuget.org/packages/MySqlConnector/)
+- Docs: [What's new in EF8, with runnable samples](https://aka.ms/ef8-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="sqlite"></a>
+
+### Feb 8: [SQLite with .NET and EF Core](https://www.youtube.com/live/n3Tt0F4g4is?si=aKzl5sr13mSo8DkC)
+
+This week, Eric Sink (creator of SQLitePCL.raw) and Brice Lambson (creator of Microsoft.Data.Sqlite) join the .NET Data Access Team to discuss everything SQLite on .NET. We’ll start down low digging into different ways to get the SQLite native binaries using Eric’s packages. Then we’ll move up the stack to look at the basics of SQLite on .NET with Brice’s ADO.NET provider. Going higher still, we’ll look at how to get the most from SQLite with the EF Core provider. And, as always, we’ll be there to answer any questions you have about SQLite on .NET.
+
+Featuring:
+
+- [Eric Sink](https://github.com/ericsink) (Special guest)
+- [Brice Lambson](https://github.com/bricelam) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+
+Links:
+
+- GitHub:
+  - [SQLitePCL.raw](https://github.com/ericsink/SQLitePCL.raw)
+  - [Microsoft.Data.Sqlite](https://github.com/dotnet/efcore) (Contained in the EF Core repo.)
+- NuGet:
+  - [SQLitePCLRaw.bundle_e_sqlite3](https://www.nuget.org/packages/SQLitePCLRaw.bundle_e_sqlite3)
+  - [Other SQLitePCLRaw packages](https://www.nuget.org/profiles/SQLitePCLRaw)
+  - [Microsoft.Data.Sqlite](https://www.nuget.org/packages/Microsoft.Data.Sqlite)
+  - [Microsoft.Data.Sqlite.Core](https://www.nuget.org/packages/Microsoft.Data.Sqlite.Core)
+- Docs: [What's new in EF8, with runnable samples](https://aka.ms/ef8-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="faq"></a>
+
+### Jan 11: [Entity Framework Core FAQs](https://www.youtube.com/live/2MZNbPT8Q2E?si=TvG40n04AanO9vxj)
+
+Join the Microsoft .NET Data team to get answers to many frequently asked questions about EF Core. For example:
+
+- What's the difference between EF Core and EF6?
+- What NuGet packages to I need to install to use EF Core?
+- Should I always use no-tracking queries?
+- Why does EF Core sometimes ignore Includes?
+- What's wrong with using owned types for value objects?
+- Should I create a repository over EF Core?
+- Why does the in-memory database not work in my tests?
+- How do I call stored procedures from EF Core?
+- How do I see the SQL for a LINQ query?
+
+Featuring:
+
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+- [Jiachen Jiang](https://github.com/jcjiang) (Host)
+
+Links:
+
+- Docs: [What's new in EF7, with runnable samples](https://aka.ms/ef7-new)
+- Docs: [EF8 plan](https://aka.ms/ef8-plan)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+## 2022
+
+<a name="plan8"></a>
+
+### Dec 14: [The Plan for Entity Framework Core 8](https://www.youtube.com/live/-zoXAeDfNBY?si=Pr6ucas7j58gIyql)
+
+The plan has been published for EF Core 8 and other data access work in .NET 8. This includes work in five major themes:
+
+- Highly requested features
+- Cloud native and devices
+- Performance
+- Visual tooling
+- Developer experience
+
+Join the .NET Data Team for a discussion of what’s in and what’s out, and to get your questions answered.
+
+Featuring:
+
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+- [Jiachen Jiang](https://github.com/jcjiang) (Host)
+
+Links:
+
+- Docs: [What's new in EF7, with runnable samples](https://aka.ms/ef7-new)
+- Docs: [EF8 plan](https://aka.ms/ef8-plan)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="new-ef7"></a>
+
+### Nov 16: [A Whirlwind Tour of EF7](https://www.youtube.com/live/FAQH1H9K6ng?si=tVAkyQSE2mrXX7nO)
+
+Join the .NET Data team as we take a whirlwind tour through new features of EF Core 7.0 (EF7). This includes JSON columns, bulk updates, TPC mapping, and more!
+
+Featuring:
+
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Docs: [What's new in EF7, with runnable samples](https://aka.ms/ef7-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="conventions"></a>
+
+### Nov 7: [EF7 Custom Model Conventions](https://www.youtube.com/live/6apfe1L1FhY?si=g6NuYVtFmLCy9a6i)
+
+EF Core uses a metadata "model" to describe how the application's entity types are mapped to the underlying database. This model is built using a set of around 60 "conventions". The model built by conventions can then be customized using mapping attributes (aka "data annotations") and/or calls to the DbModelBuilder API in OnModelCreating. EF7 allows applications to remove or modify existing conventions, as well as create new conventions. Join us for this .NET Data Community Standup to learn how to take advantage of custom model building conventions in your EF Core 7.0 applications.
+
+Featuring:
+
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+- [Jiachen Jiang](https://github.com/jcjiang) (Host)
+
+Links:
+
+- Docs: [What's new in EF7, with runnable samples](https://aka.ms/ef7-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+- Docs: [Model Bulk Configuration](xref:core/modeling/bulk-configuration)
+
+<a name="bulkcud"></a>
+
+### Oct 19: [New EF Core 7.0 APIs (Bulk Update)](https://www.youtube.com/live/rrKhbiXydKs?si=S5nUIdSerRg8Vqtp)
+
+EF Core 7.0 introduces the ExecuteUpdate and ExecuteDelete APIs, which allow you to easily use LINQ to express a database update or delete operation. These APIs can be far more efficient for applying changes to multiple rows based on a condition, e.g. “delete rows which have InActive set to true” (AKA bulk update scenarios). But in some scenarios, they also allow you to express changes over a single row in a much more succinct and simple way, simplifying your code. ExecuteUpdate and ExecuteDelete completely bypass EF’s change tracking and execute immediately, as opposed to when SaveChanges is called. Tune in to learn more and to explore the new possibilities that these new APIs bring!
+
+Featuring:
+
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+- [Jiachen Jiang](https://github.com/jcjiang) (Host)
+
+Links:
+
+- Docs: [What's new in EF7, with runnable samples](https://aka.ms/ef7-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+- Docs: [ExecuteUpdate and ExecuteDelete](xref:core/saving/execute-insert-update-delete)
+
+<a name="json"></a>
+
+### Oct 5: [JSON Columns](https://www.youtube.com/live/0W2vcYMoJ8g?si=NKwrjgz569kQHM_J)
+
+JSON columns allow relational databases to directly store documents while retaining the overall relational structure of the data. EF7 contains provider-agnostic support for JSON columns, with an implementation for SQL Server.  The JSON in these columns can queried using LINQ, allowing filtering and sorting by the elements of the documents, as well as projection of elements out of the documents into results. In addition, EF7 supports element-level change tracking of the documents and partial updates for only the changed elements when SaveChanges is called.
+
+Featuring:
+
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+- [Jiachen Jiang](https://github.com/jcjiang) (Host)
+
+Links:
+
+- Docs: [What's new in EF7, with runnable samples](https://aka.ms/ef7-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="offline-sync"></a>
+
+### Sep 21: [Azure Mobile Apps and offline sync](https://www.youtube.com/live/FbV4VWf7PfQ?si=x2arUB7YLRS79d3E)
+
+Learn how Azure Mobile Apps provides the tools and libraries you need to easily synchronize data between an Entity Framework Core-backed Web API and your mobile or desktop app.
+
+Featuring:
+
+- [Adrian Hall](https://github.com/adrianhall) (Special guest)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Product: [About Azure Mobile Apps](/azure/developer/mobile-apps/azure-mobile-apps/overview)
+- Blog: [Adrian Hall's Blog](https://adrianhall.github.io/)
+- Docs: [What's new in EF7, with runnable samples](https://aka.ms/ef7-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="ef7aggs"></a>
+
+### Aug 24: [New aggregate function support in EF Core 7](https://www.youtube.com/live/IfaURw5D1Qg?si=DbxZ6xflfnds9CN0)
+
+Aggregate functions such as COUNT, MAX or AVG compute a single value from multiple rows. EF7 adds support for custom provider aggregate functions, adding support for many new translations. In this episode of the .NET Data Community Standup, we’ll explore these new translations across different EF providers, and see what they could mean for more efficient data loading from the database. We’ll also go into some tricky design problems and under the hood query translation details which the team discussed while working on this feature.
+
+Featuring:
+
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+- [Jiachen Jiang](https://github.com/jcjiang) (Host)
+
+Links:
+
+- Docs: [What's new in EF7, with runnable samples](https://aka.ms/ef7-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="wcf"></a>
+
+### Aug 10: [CoreWCF: Roadmap and Q&A](https://www.youtube.com/live/OvaYdycmb-U?si=ucnqZXAoXDSCMZqE)
+
+CoreWCF is a port of the service side of Windows Communication Foundation (WCF) to .NET. The goal of this project is to enable existing WCF services to move to .NET. The CoreWCF team recently conducted a survey and will be talking about some of  the responses, answering questions, and sharing insights into their roadmap for the future.
+
+Featuring:
+
+- [Matt Connew](https://github.com/mconnew) (Special guest)
+- [Mike Rousos](https://github.com/HongGit) (Special guest)
+- [Sam Spencer](https://devblogs.microsoft.com/dotnet/author/samsp/) (Special guest)
+- [Hong Li](https://github.com/HongGit) (Special guest)
+- [Heather Arbon](https://github.com/HeathAr) (Special guest)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- GitHub: [CoreWCF](https://github.com/CoreWCF/CoreWCF)
+
+<a name="dbdatasource"></a>
+
+### Jul 27: [DbDataSource, a new System.Data abstraction](https://www.youtube.com/live/vRUtHeUpU44?si=jm73JkMidEcZHJZj)
+
+In this episode of the .NET data community standup, we'll explore DbDataSource, a new abstraction being introduced to System.Data in .NET 7.0. DbDataSource unlocks easier integration of ADO.NET drivers with dependency injection, better management of advanced driver configuration, helps performance and more. Tune in to see improvements at the lower levels of the .NET data stack.
+
+Featuring:
+
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Docs: [What's new in EF7, with runnable samples](https://aka.ms/ef7-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="ef7interceptors"></a>
+
+### Jul 13: [Intercept this EF7 Preview 6 Event](https://www.youtube.com/live/EJs3sSetr2Q?si=V-NxDGrPLPAsV-3f)
+
+EF7 includes a variety of new interceptors and events, as well as many improvements to the existing lifecycle hooks. In this session, Arthur and others from the .NET Data team will dive into this new functionality, including examples for intercepting materialization of entities, query expression trees, identity resolution when tracking, and optimistic concurrency violations. Join us for a fun-packed ride into the world of modifying EF behavior through interception with code galore!
+
+Featuring:
+
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Blog: [Announcing Entity Framework Core 7 Preview 6: Performance Edition](https://devblogs.microsoft.com/dotnet/announcing-ef-core-7-preview6-performance-optimizations/)
+- Docs: [What's new in EF7, with runnable samples](https://aka.ms/ef7-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="lifetimes"></a>
+
+### Jun 29: [DbContext Configuration and Lifetime - EF Core Architecture Part 2](https://www.youtube.com/live/NPgFlqXPbK8?si=k1HbnuniXaivGlAS)
+
+Arthur and others from the EF Team continue their deep dive into the architecture of Entity Framework Core. This is a code-driven discussion looking at how and why things are designed and implemented the way they are. In this session, we look at the initialization and configuration of a DbContext instance, including selection of the provider, creating DbSet instances, reading DbContextOptions, and DbContext pooling.
+
+Featuring:
+
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Docs: [DbContext Lifetime, Configuration, and Initialization](xref:core/dbcontext-configuration/index)
+- Docs: [DbContext pooling](xref:core/performance/advanced-performance-topics#dbcontext-pooling)
+- Docs: [What's new in EF7, with runnable samples](https://aka.ms/ef7-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="inheritance"></a>
+
+### Jun 15: [TPH, TPT, and TPC Inheritance mapping with EF Core](https://www.youtube.com/live/HaL6DKW1mrg?si=s82taQNe2QUlZHOA)
+
+Type inheritance hierarchies as used in object-oriented programming do not map naturally to relational database schemas. In this live stream, we will look at different strategies for inheritance mapping when using EF Core with a relational database. This includes table-per-hierarchy (TPH) mapping, table-per-type (TPT) mapping, and table-per-concrete type (TPC) mapping, which is new in EF Core 7.0 preview 5. We will look at the consequences of the mapping on the generated SQL and consider the performance and storage implications. This will result in some guidance as to when each strategy should be used.
+
+Featuring:
+
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Blog: [Announcing Entity Framework 7 Preview 5](https://devblogs.microsoft.com/dotnet/announcing-ef7-preview5/)
+- Docs: [Inheritance](xref:core/modeling/inheritance)
+- Docs: [What's new in EF7, with runnable samples](https://aka.ms/ef7-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="internal-di"></a>
+
+### Jun 1: [EF Core Architecture: Internal Dependency Injection](https://www.youtube.com/live/pYhe-Mt0HzI?si=SF8S0NSQnpTS4zBO)
+
+Join Arthur Vickers and others from the EF Team as we start a deep dive into the architecture of Entity Framework Core. This won’t be a formal talk, but rather a free-form discussion driven by the code where we look how and why things are designed and implemented the way they are. This week, we’ll start with the use of dependency injection (D.I.) and the “internal service provider.” This is the backbone of how EF Core works as a service-oriented architecture, where the core code, database providers, and plugins all implement services that work together to provide EF’s functionality.
+
+Featuring:
+
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Docs: [What's new in EF7, with runnable samples](https://aka.ms/ef7-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="testing2"></a>
+
+### May 18: [Testing EF Core Apps (part 2)](https://www.youtube.com/live/4JQUJk8muCc?si=U81q0c5gEwdpe-dN)
+
+In this second part of testing EF Core Apps, guest Jon P Smith will focus on the actual code and approaches that you need to test applications using EF Core and will address some key "pain points."
+
+Featuring:
+
+- [Jon P Smith](https://github.com/JonPSmith) (Special guest)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Blog: [New features for testing your Entity Framework Core 5 and above](https://www.thereformedprogrammer.net/new-features-for-unit-testing-your-entity-framework-core-5-code/)
+- Docs: [Testing against your production database system](xref:core/testing/testing-with-the-database)
+- GitHub: [JonPSmith/EfCore.TestSupport](https://github.com/JonPSmith/EfCore.TestSupport)
+- Blog: [Announcing Entity Framework 7 Preview 4](https://devblogs.microsoft.com/dotnet/announcing-entity-framework-7-preview-4/)
+- Docs: [What's new in EF7, with runnable samples](https://aka.ms/ef7-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="pagination"></a>
+
+### May 4: [Database Pagination](https://www.youtube.com/live/DIKH-q-gJNU?si=0TuIPGEEI25ve4i9)
+
+Lots of data? Time to page it. But what's the best approach? TAKE, SKIP, and OFFSET? What about keyset pagination? Join the .NET Data team when we page the author of "keyset pagination for EF Core" Mohammed Rahhal to discuss paging and answer your questions live.
+
+Featuring:
+
+- [Mohammad Rahhal](https://github.com/mrahhal) (Special guest)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- GitHub: [mrahhal/MR.EntityFrameworkCore.KeysetPagination](https://github.com/mrahhal/MR.EntityFrameworkCore.KeysetPagination)
+- GitHub: [mrahhal/MR.AspNetCore.Pagination](https://github.com/mrahhal/MR.AspNetCore.Pagination)
+- Blog: [Pagination Done the Right Way](https://www.slideshare.net/MarkusWinand/p2d2-pagination-done-the-postgresql-way)
+- Blog: [We need tool support for keyset pagination](https://use-the-index-luke.com/no-offset)
+- Docs: [Pagination](xref:core/querying/pagination)
+- Docs: [What's new in EF7, with runnable samples](https://aka.ms/ef7-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="update-perf"></a>
+
+### Apr 20: [Performance Improvements to the EF7 Update Pipeline](https://www.youtube.com/live/EXbuRVqxn2o?si=tL_J_GCbMi1fFPrb)
+
+Join the Entity Framework team as they review optimizations to the update pipeline to improve performance. Come prepared with your EF7 questions as we plan to spend time in Q&A to answer your questions live.
+
+Featuring:
+
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Docs: [What's new in EF7, with runnable samples](https://aka.ms/ef7-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="t4"></a>
+
+### Apr 6: [Database-first with T4 Templates in EF7: Early look](https://www.youtube.com/live/x2nh1vZBsHE?si=JA7iA1PoiDid5lzm)
+
+Prefer null setters? Property initializers? Constructor initialization? What about auto-generating database diagrams that render in markdown using Mermaid? Learn how to take control of your database scaffolding in this early look at an EF7 feature that's hot off the press
+
+Featuring:
+
+- [Brice Lambson](https://github.com/bricelam) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+
+Links:
+
+- Docs: [Code Generation and T4 Text Templates](/visualstudio/modeling/code-generation-and-t4-text-templates)
+- GitHub: [mono/t4](https://github.com/mono/t4)
+- GitHub: [JeremyLikness/MvpSummitTaskList](https://github.com/JeremyLikness/MvpSummitTaskList/)
+- Docs: [What's new in EF7, with runnable samples](https://aka.ms/ef7-new)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="graphql-odata"></a>
+
+### Mar 9: [GraphQL and OData: An In-Depth Discussion](https://www.youtube.com/live/t7nkdORzed4?si=-2ov3X6DfuhVokWT)
+
+The creator of the GraphQL library HotChocolate, Michael Staib, and Microsoft engineer and OData expert Hassan Habib discuss the various capabilities of GraphQL and OData and how they empower developers to go beyond REST.
+
+Featuring:
+
+- [Michael Staib](https://github.com/michaelstaib) (Special guest)
+- [Hassan Rezk Habib](https://github.com/hassanhabib) (Special guest)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Product: [OData - the best way to REST](https://www.odata.org/)
+- Product: [Hot Chocolate - Introduction](https://chillicream.com/docs/hotchocolate/v13)
+- Blog: [The Future of OData NxT (Neo)](https://devblogs.microsoft.com/odata/the-future-of-odata-odata-nxt/)
+- Docs: [The Planetary Docs Sample](xref:core/providers/cosmos/planetary-docs-sample)
+- Docs: [Multi-tenancy](xref:core/miscellaneous/multitenancy)
+
+<a name="20years"></a>
+
+### Feb 23: [Celebrating 20 Years of .NET: Entity Framework](https://www.youtube.com/live/kiPHP0KuSzM?si=IbVA62S4yn57meAF)
+
+As .NET celebrates its 20th birthday, Entity Framework approaches its 10-year anniversary of going open source. The Entity Framework team will celebrate these milestones by inviting back the engineers and program managers who helped shipped previous versions to share their stories, demos, and anecdotes. Join Tim Laverty, Rowan Miller, Danny Simmons, Diego Vega, and more for this special edition of the .NET Data community standup.
+
+Featuring:
+
+- [Danny Simmons](https://github.com/simmdan) (Alumnus)
+- [Rowan Miller](https://github.com/rowanmiller/) (Alumnus)
+- [Julie Lerman](https://github.com/julielerman) (Special guest)
+- [Diego Vega](https://github.com/divega) (Alumnus)
+- [Andrew Peters](https://github.com/anpete) (Alumnus)
+- [Tim Laverty](https://github.com/timlaverty) (Alumnus)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Historic links:
+  - [The ADO.NET Entity Framework Overview](/previous-versions/aa697427(v=vs.80))
+  - [ADO.NET vNext: The Entity Framework, LINQ and more](/archive/blogs/dataaccess/ado-net-vnext-the-entity-framework-linq-and-more)
+  - [Entity Framework Vote of No Confidence Signatories](https://efvote.wufoo.com/reports/entity-framework-vote-of-no-confidence-signatories/#public)
+  - [DP Advisory Council](/archive/blogs/dsimmons/dp-advisory-council)
+  - [RTM is Finally Here!](/archive/blogs/adonet/rtm-is-finally-here)
+  - [Update on LINQ to SQL and LINQ to Entities Roadmap](/archive/blogs/adonet/update-on-linq-to-sql-and-linq-to-entities-roadmap)
+  - [Simple Code First with Entity Framework 4 - Magic Unicorn Feature CTP 4](https://www.hanselman.com/blog/simple-code-first-with-entity-framework-4-magic-unicorn-feature-ctp-4)
+  - [Entity Framework and Open Source](/archive/blogs/adonet/entity-framework-and-open-source)
+  - [Introducing ADO.NET Entity Framework](https://www.codemag.com/article/0711051/Introducing-ADO.NET-Entity-Framework)
+  - [Code First Databases with Entity Framework (Magic Unicorn Edition)](https://hanselminutes.com/223/code-first-databases-with-entity-framework-magic-unicorn-edition)
+  - [Visual Studio 2008 and .NET Framework 3.5 Service Pack 1 Beta](https://weblogs.asp.net/scottgu/visual-studio-2008-and-net-framework-3-5-service-pack-1-beta)
+  - [EF5 Released](/archive/blogs/adonet/ef5-released)
+  - [EF6 RTM Available](/archive/blogs/adonet/ef6-rtm-available)
+  - [EF7 - New Platforms, New Data Stores](/archive/blogs/adonet/ef7-new-platforms-new-data-stores)
+  - [ASP.NET 5 is dead - Introducing ASP.NET Core 1.0 and .NET Core 1.0](https://www.hanselman.com/blog/aspnet-5-is-dead-introducing-aspnet-core-10-and-net-core-10)
+  - [Announcing Entity Framework Core 1.0](https://devblogs.microsoft.com/dotnet/entity-framework-core-1-0-0-available/)
+  - [Announcing Entity Framework Core 2.0](https://devblogs.microsoft.com/dotnet/announcing-entity-framework-core-2-0/)
+  - [Announcing Entity Framework Core 3.0 and Entity Framework 6.3 General Availability](https://devblogs.microsoft.com/dotnet/announcing-ef-core-3-0-and-ef-6-3-general-availability/)
+  - [Announcing the Release of EF Core 5.0](https://devblogs.microsoft.com/dotnet/announcing-the-release-of-ef-core-5-0/)
+  - [Get to Know EF Core 6](https://devblogs.microsoft.com/dotnet/get-to-know-ef-core-6/)
+  - [Announcing Entity Framework 7 Preview 1](https://devblogs.microsoft.com/dotnet/announcing-entity-framework-7-preview-1/)
+
+<a name="stuff"></a>
+
+### Feb 9: [Software version and "stuff"](https://www.youtube.com/live/Os7Rpm3LBkE?si=g9uwjlSvNdAYVatk)
+
+Join the .NET Data team and Jon Skeet in a discussion around software versioning, issues with versioning in .NET, and… stuff. Who knows what topics may come up? Join us live to find out and have your questions answered in real time.
+
+Featuring:
+
+- [Jon Skeet](https://github.com/jskeet/) (Special guest)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Jon Skeet's blog:
+  - [WHY I DON’T START VERSIONS AT 0.X ANY MORE](https://codeblog.jonskeet.uk/2019/10/20/why-i-dont-start-versions-at-0-x-any-more/)
+  - [OPTIONS FOR .NET’S VERSIONING ISSUES](https://codeblog.jonskeet.uk/2019/10/25/options-for-nets-versioning-issues/)
+  - [VERSIONING LIMITATIONS IN .NET](https://codeblog.jonskeet.uk/2019/06/30/versioning-limitations-in-net/)
+- Docs: [What's new in EF Core 6, with runnable samples](xref:core/what-is-new/ef-core-6.0/whatsnew)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="testing1"></a>
+
+### Jan 26: [Testing EF Core Apps](https://www.youtube.com/live/KO2aFuLqGkc?si=ivF7Ma9vIEplxaKW)
+
+What’s the best way to run automated tests on an application that uses Entity Framework Core? Jon P Smith, author of the book “Entity Framework Core in Action” covers three ways to create automated tests for your code and looks at the EF Core test “pain points” and how to get around them.
+
+Featuring:
+
+- [Jon P Smith](https://github.com/JonPSmith) (Special guest)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Blog: [New features for testing your Entity Framework Core 5 and above](https://www.thereformedprogrammer.net/new-features-for-unit-testing-your-entity-framework-core-5-code/)
+- Blog: [Using PostgreSQL in dev: Part 1 – Installing PostgreSQL on Windows](https://www.thereformedprogrammer.net/using-postgresql-in-development-part-1-installing-postgresql-on-windows/)
+- Blog: [Using PostgreSQL in dev: Part 2 – Testing against a PostgreSQL database](https://www.thereformedprogrammer.net/using-postgresql-in-dev-part-2-testing-against-a-postgresql-database/)
+- GitHub: [JonPSmith/EfCore.TestSupport](https://github.com/JonPSmith/EfCore.TestSupport)
+- Docs: [Testing EF Core Applications](xref:core/testing/index)
+- Video: [Unicorns Kickin': The EF Core rap official video.](https://youtu.be/QoIky9WQ9Dg?si=nqINdARz6KTtQ16M)
+- Video: [20 GOTO 10: A cautionary tale about using the GOTO statement.](https://youtu.be/qd85U5mVWgo?si=RG9zhrZqcmRlhVOl)
+- Blog: [What's new in EF Core 6, with runnable samples](xref:core/what-is-new/ef-core-6.0/whatsnew)
+- Blog: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="ef7plan"></a>
+
+### Jan 12: [The EF7 Plan](https://www.youtube.com/live/nU-mtUtbHV4?si=j5YTFfxudv0DOIPh)
+
+The plan for EF7 has been published. In this episode, the EF Core/.NET Data team will review the details of the plan and answer live questions about the roadmap.
+
+Featuring:
+
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+- [Brice Lambson](https://github.com/bricelam) (Host)
+
+Links:
+
+- [Announcing the Plan for EF7](https://devblogs.microsoft.com/dotnet/announcing-the-plan-for-ef7/)
+- [Plan for Entity Framework Core 7.0](xref:core/what-is-new/ef-core-7.0/plan)
+- [Port from EF6 to EF Core](xref:efcore-and-ef6/porting/index)
+- [What's new in EF Core 6, with runnable samples](xref:core/what-is-new/ef-core-6.0/whatsnew)
+- [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+## 2021
+
+<a name="hotchoc12"></a>
+
+### Dec 1: [Hot Chocolate 12 and GraphQL 2021](https://www.youtube.com/live/3_4nt2QQSeE?si=WT7ecz52hz-SP4Rr)
+
+Hot Chocolate 12 allows for more schema-building options with deeper integrations into EF core. Hot Chocolate has already implemented the new GraphQL October 2021 spec, and we will explore the new capabilities. We now support the complete stream and defer spec and will look into these new data fetching capabilities.
+
+Featuring:
+
+- [Michael Staib](https://github.com/michaelstaib) (Special guest)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Product: [Hot Chocolate for GraphQL](https://chillicream.com/docs/hotchocolate/v12)
+- Docs: [Hot Chocolate and Entity Framework Core](https://chillicream.com/docs/hotchocolate/v12/integrations/entity-framework)
+- Blog: [Get to Know EF Core 6](https://devblogs.microsoft.com/dotnet/get-to-know-ef-core-6/)
+- Docs: [What's new in EF Core 6, with runnable samples](xref:core/what-is-new/ef-core-6.0/whatsnew)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="retro6"></a>
+
+### Nov 17: [Make History and Explore the Cosmos, an EF Core 6 Retrospective](https://www.youtube.com/live/cx6IUURncgk?si=CqKbnHztzd-Pv91l)
+
+EF Core 6 has been released with a long list of features from performance improvements, temporal tables support, CI/CD-friendly migration bundles, compiled models, query improvements, enhanced Azure Cosmos DB capabilities and much more. Join the EF Core team and our community panelists as we review what's new, share the EF Core 6 story and answer your questions live.
+
+Featuring:
+
+- [Julie Lerman](https://github.com/julielerman) (Special guest)
+- [Jon P Smith](https://github.com/JonPSmith) (Special guest)
+- [Erik Ejlskov Jensen](https://github.com/ErikEJ) (Special guest)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Video: [New Blazor WebAssembly capabilities in .NET 6](https://www.youtube.com/watch?v=kesUNeBZ1Os)
+- Video: [Modern data APIs with EF Core and GraphQL](https://www.youtube.com/watch?v=GBvTRcV4PVA)
+- Blog: [Updating your ASP.NET Core / EF Core application to NET 6](https://www.thereformedprogrammer.net/updating-your-asp-net-core-ef-core-application-to-net-6/)
+- Video: [Entity Framework Community Standup - Introducing EF Core Compiled Models](https://www.youtube.com/watch?v=XdhX3iLXAPk)
+- Video: [Entity Framework Community Standup - SQL Server Temporal Tables and EF Core 6](https://www.youtube.com/watch?v=2aCgKM41NFw)
+- Blog: [Taking the EF Core Azure Cosmos DB Provider for a Test Drive](https://devblogs.microsoft.com/dotnet/taking-the-ef-core-azure-cosmos-db-provider-for-a-test-drive/)
+- Video: [EF Core 6 and Azure Cosmos DB](https://www.youtube.com/watch?v=zQC9D00pr6I)
+- Video: [What's New in EF Core 6](https://youtu.be/_1fJeW4F3ts?si=5GJh-NSqIyyIfRQd)
+- Docs: [What's new in EF Core 6, with runnable samples](xref:core/what-is-new/ef-core-6.0/whatsnew)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="nodatime"></a>
+
+### Nov 3: [Noda Time](https://www.youtube.com/live/ZLJLfImuFqM?si=bv_mbh2qzAeICfFG)
+
+Noda Time is an alternative date and time API for .NET. It helps you to think about your data more clearly, and express operations on that data more precisely.
+
+Featuring:
+
+- [Jon Skeet](https://github.com/jskeet/) (Special guest)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Blog: [Noda Time](https://blog.nodatime.org/2011/08/what-wrong-with-datetime-anyway.html)
+- Blog: [STORING UTC IS NOT A SILVER BULLET](https://codeblog.jonskeet.uk/2019/03/27/storing-utc-is-not-a-silver-bullet/)
+- Product: [nodatime.org](https://nodatime.org/)
+- GitHub: [nodatime/nodatime](https://github.com/nodatime/nodatime)
+- Blog: [Date/Time Mapping with NodaTime in Npgsql](https://www.npgsql.org/efcore/mapping/nodatime.html?tabs=with-datasource)
+- GitHub: [StevenRasmussen/EFCore.SqlServer.NodaTime](https://github.com/StevenRasmussen/EFCore.SqlServer.NodaTime)
+- GitHub: [khellang/EFCore.Sqlite.NodaTime](https://github.com/khellang/EFCore.Sqlite.NodaTime)
+- Docs: [What's new in EF Core 6, with runnable samples](xref:core/what-is-new/ef-core-6.0/whatsnew)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="temporal"></a>
+
+### Oct 6: [SQL Server Temporal Tables and EF Core 6](https://www.youtube.com/live/2aCgKM41NFw?si=q__izjX1qL0GHyqe)
+
+Learn about the new support in EF Core 6 for temporal tables, including creating them from migrations, transforming existing tables into temporal tables, querying historical data and point-in-time restore.
+
+Featuring:
+
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+
+Links:
+
+- GitHub: [ajcvickers/TemporalTables](https://github.com/ajcvickers/TemporalTables)
+- Docs: [What's new in EF Core 6, with runnable samples](xref:core/what-is-new/ef-core-6.0/whatsnew)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="aspnet"></a>
+
+### Oct 20: [EF Core and ASP.NET Core from the ASP.NET documentation team](https://www.youtube.com/live/2wdJ0xjGF2o?si=V7pOPwty_8Oi1i36)
+
+Back to the basics: EF Core and ASP.NET Core from the documentation team.
+
+Featuring:
+
+- [Rick Anderson](https://github.com/Rick-Anderson) (Special guest)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Docs: [Razor Pages with Entity Framework Core in ASP.NET Core - Tutorial](/aspnet/core/data/ef-rp/intro)
+- Docs: [ASP.NET Core MVC with EF Core - Tutorial](/aspnet/core/data/ef-mvc)
+- Blog: [Prime your flux capacitor: SQL Server temporal tables in EF Core 6.0](https://devblogs.microsoft.com/dotnet/prime-your-flux-capacitor-sql-server-temporal-tables-in-ef-core-6-0/)
+- Docs: [What's new in EF Core 6, with runnable samples](xref:core/what-is-new/ef-core-6.0/whatsnew)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="npgsql"></a>
+
+### Sep 22: [PostgreSQL and EF Core](https://www.youtube.com/live/Ya_cmZRwACM?si=FSx9ajf5fXrwz5t7)
+
+PostgreSQL has some advanced capabilities not usually found in other relational databases. In this session we'll go over some of them, and see how EF Core makes these accessible.
+
+Featuring:
+
+- [Shay Rojansky](https://github.com/roji) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Brice Lambson](https://github.com/bricelam) (Host)
+
+Links:
+
+- Product: [Npgsql Entity Framework Core Provider](https://www.npgsql.org/efcore/index.html)
+- Docs: [What's new in EF Core 6, with runnable samples](xref:core/what-is-new/ef-core-6.0/whatsnew)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="dapper"></a>
+
+### Aug 25: [Dapper](https://www.youtube.com/live/txiQar6PqvA?si=wIEFckHrk2RD2z4z)
+
+Dapper maintainers and key contributors Nick and Marc will show people the glorious power of Dapper and everything it can do, so they are fully informed and can choose something much better, like EF Core (their words).
+
+Featuring:
+
+- [Marc Gravell](https://github.com/mgravell)
+- [Nick Craver](https://github.com/NickCraver)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- GitHub: [JeremyLikness/EFCosmosQuickstart](https://github.com/JeremyLikness/EFCosmosQuickstart)
+- GitHub: [DapperLib/Dapper](https://github.com/DapperLib/Dapper)
+- GitHub: [DapperLib/DapperAOT](https://github.com/DapperLib/DapperAOT)
+- Product: [Dapper](https://dapperlib.github.io/Dapper/)
+- GitHub: [SqlServer.Core: Performance-oriented SQL Server .NET driver](https://github.com/dotnet/datalab/issues/6)
+- Blog: [Is the era of reflection-heavy C# libraries at an end?](https://blog.marcgravell.com/2021/05/is-era-of-reflection-heavy-c-libraries.html)
+- Blog: [.NET Core, .NET 5; the exodus of .NET Framework?](https://blog.marcgravell.com/2020/01/net-core-net-5-exodus-of-net-framework.html)
+- Docs: [What's new in EF Core 6, with runnable samples](xref:core/what-is-new/ef-core-6.0/whatsnew)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="query-filters"></a>
+
+### Aug 11: [EF Core's Global Query Filter](https://www.youtube.com/live/Uy0c_DKGM-U?si=5iLoEM8ZdKjXXjdY)
+
+Why do customers want "soft delete"? What's a good practice for handling multi-tenancy in EF Core apps? The reformed programmer, Jon P. Smith, shares how to use a powerful tool in the EF Core platform, global query filters, to handle scenarios like "soft delete."
+
+Featuring:
+
+- [Jon P Smith](https://github.com/JonPSmith) (Special guest)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Docs: [Global Query Filters](xref:core/querying/filters)
+- Blog: [EF Core In depth – Soft deleting data with Global Query Filters](https://www.thereformedprogrammer.net/ef-core-in-depth-soft-deleting-data-with-global-query-filters/)
+- Blog: [Introducing the EfCore.SoftDeleteServices library to automate soft deletes](https://www.thereformedprogrammer.net/introducing-the-efcore-softdeleteservices-library-to-automate-soft-deletes/)
+- Blog: [Part 2: Handling data authorization in ASP.NET Core and Entity Framework Core](https://www.thereformedprogrammer.net/part-2-handling-data-authorization-asp-net-core-and-entity-framework-core/)
+- Blog: [Part 4: Building a robust and secure data authorization with EF Core](https://www.thereformedprogrammer.net/part-4-building-a-robust-and-secure-data-authorization-with-ef-core/)
+- Docs: [What's new in EF Core 6, with runnable samples](xref:core/what-is-new/ef-core-6.0/whatsnew)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="odata"></a>
+
+### Jul 28: [OData](https://www.youtube.com/live/Q3Ove-2Uh94?si=VPRzsiqO-S9nD5bs)
+
+OData is one of the best protocols out there to supercharge your ASP.NET Core APIs with so many capabilities such as shaping, filtering, batching and ordering the data on the fly - it executes it's queries on the server which tremendously improves the performance on client side. Hassan talks all things OData on the Community Standup.
+
+Featuring:
+
+- [Hassan Rezk Habib](https://github.com/hassanhabib) (Special guest)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Blog: [Up & Running w/ OData in ASP.NET 6](https://devblogs.microsoft.com/odata/up-running-w-odata-in-asp-net-6/)
+- GitHub: [OData NxT - The Future of OData (Project Proposal)](https://github.com/OData/OData.Neo/issues/4)
+- Video: [Enabling OData in ASP.NET 6.0](https://www.youtube.com/watch?v=w0Tj0VIUCtA)
+- Video: [OData NxT 002: OData Queries Deep Dive](https://youtu.be/6AvFqhkALmg?si=KY5_pauTt_weCMRN)
+- Docs: [What's new in EF Core 6, with runnable samples](xref:core/what-is-new/ef-core-6.0/whatsnew)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="query-plans"></a>
+
+### Jul 14: [Visualizing database query plans](https://www.youtube.com/live/Zhy5antRDJk?si=avlq-ll147UyRcIt)
+
+Learn what a query plan is, how to view EF Core query plan in LINQPad, find missing indexes, and improve performance of your queries.
+
+Featuring:
+
+- [Giorgi Dalakishvili](https://github.com/Giorgi)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- GitHub: [Giorgi/LINQPad.QueryPlanVisualizer](https://github.com/Giorgi/LINQPad.QueryPlanVisualizer)
+- GitHub: [dalibo/pev2](https://github.com/dalibo/pev2/)
+- GitHub: [JustinPealing/html-query-plan](https://github.com/JustinPealing/html-query-plan)
+- Docs: [SQL Server: Execution plan overview](/sql/relational-databases/performance/execution-plans)
+- Docs: [SQL Server: Logical and physical showplan operator reference](/sql/relational-databases/showplan-logical-and-physical-operators-reference)
+- Docs: [SQL Server: Statistics](/sql/relational-databases/statistics/statistics)
+- Blog: [Announcing Entity Framework Core 6.0 Preview 6: Configure Conventions](https://devblogs.microsoft.com/dotnet/announcing-entity-framework-core-6-0-preview-6-configure-conventions/)
+- Docs: [What's new in EF Core 6, with runnable samples](xref:core/what-is-new/ef-core-6.0/whatsnew)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="cosmos6"></a>
+
+### Jun 16: [Azure Cosmos DB and EF Core](https://www.youtube.com/live/nEqH_XfCfho?si=rq5L2ciDW37atihz)
+
+EF Core may be an object relational mapper, but it also can ditch the relational and connect directly to the Azure Cosmos DB NoSQL engine. In this standup, the team will discuss the rationale behind a Cosmos DB provider, show code examples, discuss the major differences between SQL and NoSQL data and share the roadmap for future enhancements to the Azure Cosmos DB provider.
+
+Featuring:
+
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- GitHub: [JeremyLikness/PlanetaryDocs](https://github.com/JeremyLikness/PlanetaryDocs)
+- Docs: [What's new in EF Core 6, with runnable samples](xref:core/what-is-new/ef-core-6.0/whatsnew)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="compiled-models"></a>
+
+### Jun 2: [Introducing EF Core Compiled Models](https://www.youtube.com/live/XdhX3iLXAPk?si=DzUmXMMLWFh8XSXv)
+
+EF Core creates an internal model for entity types and their database mappings. This model is typically built once when the application starts. Starting with EF Core 6.0, it is now possible to instead build this model at compile time. This can reduce startup time by up to 67% for large models. Join us for this Community Standup, where the team will introduce compiled models and demo their use.
+
+Featuring:
+
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+- [Andriy Svyryd](https://github.com/AndriySvyryd) (Host)
+
+Links:
+
+- GitHub: [Reduce EF Core application startup time via compiled models](https://github.com/dotnet/efcore/issues/1906)
+- Docs: [What's new in EF Core 6, with runnable samples](xref:core/what-is-new/ef-core-6.0/whatsnew)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="graphql1"></a>
+
+### May 19: [Building Modern Apps with GraphQL](https://www.youtube.com/live/4k3WzW2ZdXs?si=DXqIxVNNlbMILNeT)
+
+GraphQL is a great way to expose data whether you expose your business layer in a much richer way or just map your data models to get started quickly. GraphQL gives backend engineers the tools to mold the service layer without compromises and lets the frontend engineer decide what data he or she needs to build that awesome application. Learn the what, why, and see how to build apps with GraphQL.
+
+Featuring:
+
+- [Michael Staib](https://github.com/michaelstaib) (Special guest)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Interview: [Deep Diving into EF Core: Q&A with Jeremy Likness](https://www.infoq.com/articles/deep-diving-ef-core-jeremy-likness/)
+- Book: [Entity Framework Core in Action, Second Edition](https://www.manning.com/books/entity-framework-core-in-action-second-edition)
+- Blog: [Azure Cosmos DB With EF Core on Blazor Server](https://blog.jeremylikness.com/blog/azure-cosmos-db-with-ef-core-on-blazor-server/)
+- GitHub: [ChilliCream/graphql-platform](https://github.com/ChilliCream/graphql-platform)
+- Product: [Hot Chocolate - Introduction](https://chillicream.com/docs/hotchocolate/v13)
+- Docs: [What's new in EF Core 6, with runnable samples](xref:core/what-is-new/ef-core-6.0/whatsnew)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="triggers"></a>
+
+### May 5: [Triggers for EF Core](https://www.youtube.com/live/Gjys0Yebobk?si=JcRRypyCPZxjho0k)
+
+Guest Koen Bekkenutte will introduce us to the EFCore.Triggered project and discuss its advantages and how it differs from domain events and database triggers. See how it is implemented and how the project uses EF Core's ChangeTracker and SaveChanges interception. As always, the EF Core team and Koen will be responding to live Q&A.
+
+Featuring:
+
+- [Koen](https://github.com/koenbeuk)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Blog: [Multi-tenancy with EF Core in Blazor Server Apps](https://blog.jeremylikness.com/blog/multitenancy-with-ef-core-in-blazor-server-apps/)
+- Blog: [Triggers for Entity Framework Core](https://onthedrift.com/posts/efcore-triggered-part1/)
+- GitHub: [koenbeuk/EntityFrameworkCore.Triggered](https://github.com/koenbeuk/EntityFrameworkCore.Triggered)
+- Docs: [What's new in EF Core 6, with runnable samples](xref:core/what-is-new/ef-core-6.0/whatsnew)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="contributing"></a>
+
+### Apr 21: [Open Source Contributions: How to Add a Feature to EF Core](https://www.youtube.com/live/9OMxy1wal1s?si=WSH5zxI8L23WLoy7)
+
+Do you want to contribute to EF Core but are uncertain where to begin? We’re here to help! In this episode of the EF Core Community Standup, we will add an EF Core feature live. We’ll go through everything from forking the repo, adding the code and related tests, and generating the pull request. Learn how the codebase is organized, how to build and how to run tests and receive answers to your questions in real time direct from the team that brings you magic unicorns!
+
+Featuring:
+
+- [Erik Ejlskov Jensen](https://github.com/ErikEJ) (Special guest)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Blog: [Entity Framework Core 5 — Table-per-Type and Table-per-Hierarchy](https://henriquesd.medium.com/entity-framework-core-5-table-per-type-and-table-per-hierarchy-215ff85e4ae8)
+- Blog: [Integration testing with EF Core, part 1](https://dev.to/maxx_don/integration-testing-with-ef-core-part-1-1l40)
+- Blog: [Look ma, no passwords - using Entity Framework Core with Azure Managed Identity, App Service/Functions and Azure SQL DB](https://erikej.github.io/efcore/azure/2021/04/20/efcore-managed-identity.html)
+- Docs: [What's new in EF Core 6, with runnable samples](xref:core/what-is-new/ef-core-6.0/whatsnew)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="davide"></a>
+
+### Apr 7: [Azure SQL for Cloud-Born Applications and Developers](https://www.youtube.com/live/GhIhwCafilk?si=gyyq5PgHv-qf8UV0)
+
+Join Davide Mauri and the EF Core team for an interactive discussion about how Azure SQL helps cloud developers create cloud native solutions. From simple REST APIs to scalable backends, Azure SQL provides the required flexibility, scalability, and features to simplify the developer's life. Davide will cover topics ranging from JSON support and CI/CD to column-store, geospatial and graph models.
+
+Featuring:
+
+- [Davide Mauri](https://github.com/yorek) (Special guest)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+
+Links:
+
+- Docs: [Connection Resiliency](xref:core/miscellaneous/connection-resiliency)
+- Docs: [What's new in EF Core 6, with runnable samples](xref:core/what-is-new/ef-core-6.0/whatsnew)
+- Book: [Practical Azure SQL Database for Modern Developers: Building Applications in the Microsoft Cloud](https://www.amazon.com/Practical-Azure-Database-Modern-Developers/dp/1484263693/)
+- GitHub: [yorek/azure-sql-db-samples](https://github.com/yorek/azure-sql-db-samples)
+- GitHub: [azure-samples/azure-sql-db-dynamic-schema](https://github.com/azure-samples/azure-sql-db-dynamic-schema)
+- Product: [TodoMVC](https://todomvc.com/)
+- Product: [Todo-Backend](https://www.todobackend.com/)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="newbatch"></a>
+
+### Mar 24: [EF Core Power Tools: the New Batch](https://www.youtube.com/live/3-Izu_qLDqY?si=Tx1Cbwvtq_GI_dmG)
+
+Learn how to take advantage of the new advanced features recently added to EF Core Power Tools: - reverse engineer .dacpac files, renaming of tables, columns and even navigations, excluding columns, working with multiple DbContexts in the same project, map spatial columns and SQL Server stored procedures. The session will also include a look under the hood of EF Core Power Tools reverse engineering.
+
+Featuring:
+
+- [Erik Ejlskov Jensen](https://github.com/ErikEJ) (Special guest)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- GitHub: [ErikEJ/EFCorePowerTools](https://github.com/ErikEJ/EFCorePowerTools)
+- Docs: [What's new in EF Core 6, with runnable samples](xref:core/what-is-new/ef-core-6.0/whatsnew)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="julie"></a>
+
+### Mar 10: [Julie Lerman and EF Core Ask Me Anything (AMA)](https://www.youtube.com/live/oZVsZrFKp48?si=OqUUNoea5R5ds5rg)
+
+Julie Lerman is an independent authority and community luminary for Entity Framework. She has been programming for nearly 30 years and has been an independent consultant since 1989. Julie is one of 150 Microsoft Regional Directors worldwide and has been awarded Microsoft MVP annually since 2003. Join Julie and the EF Core team for an "ask me anything" session: your questions answered in real-time!
+
+Featuring:
+
+- [Julie Lerman](https://github.com/julielerman) (Special guest)
+- [Erik Ejlskov Jensen](https://github.com/ErikEJ) (Special guest)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Product: [The Data Farm is Julie Lerman](https://thedatafarm.com/)
+- Videos: [Julie Lerman on Pluralsight](https://www.pluralsight.com/authors/julie-lerman)
+- Docs: [What's new in EF Core 6, with runnable samples](xref:core/what-is-new/ef-core-6.0/whatsnew)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="jonp1"></a>
+
+### Feb 24: [Performance Tuning an EF Core App](https://www.youtube.com/live/VgNFFEqwZPU?si=3XQwMvO5kWMemi7T)
+
+Guest Jon P Smith shows how he built a demo e-commerce book selling site that uses EF Core. He started with 700 books then scaled through 100,000 books to ½ million books. At each stage he compares the performance of each improvement, and the extra work to get that performance.
+
+Featuring:
+
+- [Jon P Smith](https://github.com/JonPSmith) (Special guest)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Docs: [Introduction to Performance](xref:core/miscellaneous/performance/index)
+- Blog: [Entity Framework Core 5 – Pitfalls To Avoid and Ideas to Try](https://blog.jetbrains.com/dotnet/2021/02/24/entity-framework-core-5-pitfalls-to-avoid-and-ideas-to-try/)
+- Blog: [Five levels of performance tuning for an EF Core query](https://www.thereformedprogrammer.net/five-levels-of-performance-tuning-for-an-ef-core-query/)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="typed-exceptions"></a>
+
+### Feb 10: [Typed Exceptions for Entity Framework Core](https://www.youtube.com/live/aUl5QfswNU4?si=zbglNkNEElISaVpb)
+
+When using Entity Framework Core for data access all database exceptions are wrapped in DbUpdateException. If you need to know whether the exception was caused by a unique constraint, the value being too long, or the value missing for a required column, you need to dig into the concrete DbException subclass instance and check the error number to determine the exact cause. In this episode, learn how EntityFramework.Exceptions handles all the database-specific details and allows you to use typed exceptions for Entity Framework Core when your query violates database constraints.
+
+Featuring:
+
+- [Giorgi Dalakishvili](https://github.com/Giorgi) (Special guest)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- GitHub: [Giorgi/EntityFramework.Exceptions](https://github.com/Giorgi/EntityFramework.Exceptions)
+- Docs: [The Plan for Entity Framework Core 6.0](https://devblogs.microsoft.com/dotnet/the-plan-for-entity-framework-core-6-0/)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="sqlproj"></a>
+
+### Jan 27: [Introducing MSBuild.Sdk.SqlProj](https://www.youtube.com/live/lmHU1zD2mvA?si=75sWlZjkLDbakuzG)
+
+MSBuild.Sdk.SqlProj is a new open source project that allows you to build SQL Server Database Projects (.sqlproj) using the new SDK-style projects cross-platform without the need to have Visual Studio installed. Jonathan will show why you would use it, how you can get started and walk you through its various features. He'll also show how you can contribute to the project.
+
+Featuring:
+
+- [Jonathan Mezach](https://github.com/jmezach) (Special guest)
+- [Erik Ejlskov Jensen](https://github.com/ErikEJ) (Special guest)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Blog: [Preview: The SQLite Llibrary as a .NET assembly](https://ericsink.com/entries/sqlite_llama_preview.html)
+- GitHub: [rr-wfm/MSBuild.Sdk.SqlProj](https://github.com/rr-wfm/MSBuild.Sdk.SqlProj)
+- Blog: [How to update a database’s schema without using EF Core’s migrate feature](https://www.thereformedprogrammer.net/how-to-update-a-databases-schema-without-using-ef-cores-migrate-feature/)
+- Docs: [The Plan for Entity Framework Core 6.0](https://devblogs.microsoft.com/dotnet/the-plan-for-entity-framework-core-6-0/)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="survey"></a>
+
+### Jan 13: [EF Core 6.0 Survey Results](https://www.youtube.com/live/IiAS61uVDqE?si=EPu3HUNiThsWm88f)
+
+We asked, and you listened! Nearly 4,000 developers responded to the EF Core 2020 survey. In this edition of the community standup, senior program manager Jeremy Likness will review the survey results and discuss how they impact the plan for EF Core 6.0. The team will be available to answer your questions live.
+
+Featuring:
+
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Blog: [HotChocolate: Introduction to GraphQL for ASP.NET Core (Part 1)](https://dev.to/jioophoenix/hotchocolate-introduction-to-graphql-for-asp-net-core-part-1-2e27)
+- Blog: [Entity Framework Core Spotify data seed generator](https://driesdeboosere.dev/blog/entity-framework-core-spotify-data-seed-generator/#spotify-seed-data-generator-manual)
+- Blog: [Entity Framework Core 5 free resources](https://erikej.github.io/efcore/2021/01/05/efcore-5-resources.html)
+- Blog: [Announcing the Release of EF Core 5.0](https://devblogs.microsoft.com/dotnet/announcing-the-release-of-ef-core-5-0/)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+## 2020
+
+<a name="frans"></a>
+
+### Dec 2: [LLBLGen designer and .NET data history](https://www.youtube.com/live/notUk3yR0mc?si=mUHTlgHjXwCxAW1Z)
+
+In this episode we welcome guest Frans Bouma, who will show us how to graphically model a domain for any .NET ORM with the LLBLGen Pro designer. Frans is also a venerable .NET data and SqlServer figure, so we will chat a lot about history and what's it's been like to make a commercial ORM in the Microsoft world.
+
+Featuring:
+
+- [Frans Bouma](https://github.com/FransBouma) (Special guest)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Product: [LLBLGen Pro](https://www.llblgen.com/)
+- Docs: [Announcing the Release of EF Core 5.0](https://devblogs.microsoft.com/dotnet/announcing-the-release-of-ef-core-5-0/)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="efcore5"></a>
+
+### Nov 18: [Special EF Core 5.0 Community Panel](https://www.youtube.com/live/AkqRn2vr1lc?si=uAgpUza2w2k6HChb)
+
+In this special edition of the EF Core Community Standup, we celebrate the release of EF Core 5.0 with a community panel. We'll welcome Entity Framework luminaries Diego Vega, Erik E Jensen, Jon P Smith and Julie Lerman to discuss their favorite features and answer your questions live.
+
+Featuring:
+
+- [Erik Ejlskov Jensen](https://github.com/ErikEJ) (Special guest)
+- [Julie Lerman](https://github.com/julielerman) (Special guest)
+- [Jon P Smith](https://github.com/JonPSmith) (Special guest)
+- [Diego Vega](https://github.com/divega) (Alumnus)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+- [Brice Lambson](https://github.com/bricelam) (Host)
+
+Links:
+
+- Docs: [Announcing the Release of EF Core 5.0](https://devblogs.microsoft.com/dotnet/announcing-the-release-of-ef-core-5-0/)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="collations"></a>
+
+### Oct 28: [EF Core 5.0 Collations](https://www.youtube.com/live/OgMhLVa_VfA?si=bhjMpN1l_N9RYYYN)
+
+In this community standup, we'll be showing new features around case sensitivity and collations in 5.0. We'll also provide a glimpse into how these features were designed, and what considerations and constraints guide the EF team - performance, cross-database support, usability and more. Come see how we design EF features under the hood!
+
+Featuring:
+
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Docs: [Collations and Case Sensitivity](xref: core/miscellaneous/collations-and-case-sensitivity)
+- Video: [Using Entity Framework Core with Azure SQL DB and Azure Cosmos DB | Azure Friday](https://www.youtube.com/watch?v=FFgS_k_Muk8)
+- Blog: [Using Azure Identity with Azure SQL, Graph, and Entity Framework](https://devblogs.microsoft.com/azure-sdk/azure-identity-with-sql-graph-ef/)
+- Blog: [The Curious Case of Commands and Cancellation](https://www.roji.org/db-commands-and-cancellation)
+- Blog: [Setting the command timeout with the latest .NET SqlClient](https://erikej.github.io/sqlclient/2020/10/26/sqlclient-commandtimeout-preview.html)
+- Blog: [Help Us Plan EF Core 6.0](https://devblogs.microsoft.com/dotnet/help-us-plan-ef-core-6-0/)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="repository"></a>
+
+### Oct 14: [Cosmos DB: Repository Pattern .NET Wrapper SDK](https://www.youtube.com/live/Ejbgqq8vETM?si=kyCTJenwpGqQVtFC)
+
+In this episode, fellow .NET TV host David Pine will join Jeremy Likness to discuss his Cosmos DB Repository pattern .NET SDK. The SDK aims to simplify the Cosmos DB .NET SDK by abstracting away some of the complexities, exposing an elegant API surface area, and providing C.R.U.D. operations through the IRepository interface.
+
+As always, the EF Core team will be available to answer questions live.
+
+Featuring:
+
+- [David Pine](https://github.com/IEvangelist) (Special guest)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+- [Brice Lambson](https://github.com/bricelam) (Host)
+
+Links:
+
+- Video: [The .NET Docs Show: Data & .NET](https://dev.to/dotnet/the-net-docs-show-data-net-1n42)
+- Blog: [Announcing Entity Framework Core (EF Core) 5 RC2](https://devblogs.microsoft.com/dotnet/announcing-entity-framework-core-ef-core-5-rc2/)
+- Blog: [Azure Cosmos DB Repository .NET SDK v.1.0.4](https://devblogs.microsoft.com/cosmosdb/azure-cosmos-db-repository-net-sdk-v-1-0-4/)
+- GitHub: [IEvangelist/azure-cosmos-dotnet-repository](https://github.com/IEvangelist/azure-cosmos-dotnet-repository)
+- GitHub: [IEvangelist/DotNetDocs.Show](https://github.com/IEvangelist/DotNetDocs.Show)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="geo-nts"></a>
+
+### Sep 30: [Geographic Data with NetTopologySuite](https://www.youtube.com/live/IHslY5rrxD0?si=QpNNSZql1UsydmHz)
+
+Joe Amenta joins us to discuss how to add spatial data to your applications to open a world of new relationships between data. He will demonstrate the "status quote" for querying spatial data from .NET and demo integrations with NetTopologSuite and EF Core.
+
+Featuring:
+
+- [Joe Amenta](https://github.com/airbreather) (Special guest)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Brice Lambson](https://github.com/bricelam) (Host)
+
+Links:
+
+- GitHub: [NetTopologySuite](https://github.com/NetTopologySuite)
+- Blog: [Run EF Core Queries on SQL Server From Blazor WebAssembly](https://blog.jeremylikness.com/blog/run-efcore-queries-against-sql-from-blazor-webassembly/)
+- Docs: [NetTopologySuite](https://nettopologysuite.github.io/NetTopologySuite/api/NetTopologySuite.html)
+- GitHub: [locationtech/jts](https://github.com/locationtech/jts)
+- Blog: [Microsoft.Data.Sqlite 5.0](https://www.bricelam.net/2020/09/23/microsoft-data-sqlite-5-0.html)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="migrations5"></a>
+
+### Sep 16: [What's New with Migrations in EF Core 5.0](https://www.youtube.com/live/mSsGERmrhnE?si=mw1jCDxDbERDrfAi)
+
+The Entity Framework Core team focused on major improvements to migrations for the EF Core 5.0 release. Learn about what's new and explore different migrations scenarios in this demo-heavy session. As always, the team will be standing by live to answer your questions!
+
+Featuring:
+
+- [Brice Lambson](https://github.com/bricelam) (Host)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Blog: [Oracle EF Core 3.1 Production Release](https://medium.com/oracledevs/oracle-ef-core-3-1-production-release-9e470eaf3d03)
+- Blog: [Announcing Entity Framework Core (EFCore) 5.0 RC1](https://devblogs.microsoft.com/dotnet/announcing-entity-framework-core-efcore-5-0-rc1/)
+- Docs: [Migrations Overview](xref: core/managing-schemas/migrations/index)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="dotmin-sync"></a>
+
+### Sep 2: [Sync your database with DotMim.Sync](https://www.youtube.com/live/_SHryJiblRo?si=rmlPMxFWPRYHXDvX)
+
+The maintainer of open source software solution DotMim.Sync joins the EF Core team to discuss how the project helps keep local relational databases in sync.
+
+Featuring:
+
+- [Sébastien Pertus](https://github.com/Mimetis) (Special guest)
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+- [Brice Lambson](https://github.com/bricelam) (Host)
+
+Links:
+
+- GitHub: [Mimetis/Dotmim.Sync](https://github.com/Mimetis/Dotmim.Sync)
+- Blog: [Big Plans for Big Data and .NET for Spark](https://devblogs.microsoft.com/dotnet/big-plans-for-big-data-and-net-for-spark/)
+- Blog: [Tree Structure in EF Core: How to configure a self-referencing table and use it](https://habr.com/en/articles/516596/)
+- Blog: [Using a Full Framework SQL Server Project in a .NET core project build.](https://shawtyds.wordpress.com/2020/08/26/using-a-full-framework-sql-server-project-in-a-net-core-project-build/)
+- Blog: [Announcing Entity Framework Core (EF Core) 5.0 Preview 8](https://devblogs.microsoft.com/dotnet/announcing-entity-framework-core-ef-core-5-0-preview-8/)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="many-to-many"></a>
+
+### Aug 19: [Many-to-Many in EF Core 5.0](https://www.youtube.com/live/W1sxepfIMRM?si=JSBiCbeA3jM0tSz8)
+
+Join the team as they explore the latest many-to-many mapping features implemented for EF Core 5.0 including skip navigations and more!
+
+Featuring:
+
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Brice Lambson](https://github.com/bricelam) (Host)
+- [Smit Patel](https://github.com/smitpatel) (Host)
+
+Links:
+
+- Blog: [Announcing Entity Framework Core (EF Core) 5.0 Preview 8](https://devblogs.microsoft.com/dotnet/announcing-entity-framework-core-ef-core-5-0-preview-8/)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="depth"></a>
+
+### Aug 5: [EF Core In Depth Video Series](https://www.youtube.com/live/b-zTazj2vuI?si=A9lCvvHva3AomWe7)
+
+Join members from the .NET teams for our community standup covering great community contributions for Framework, .NET, Languages, CLI, MSBuild, and more.
+
+Featuring:
+
+- [Philip Japikse](https://github.com/skimedic) (Special guest)
+- [Robert Green](https://dotnet.microsoft.com/en-us/live/vs-toolbox) (Special guest)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+- [Smit Patel](https://github.com/smitpatel) (Host)
+
+Links:
+
+- Video: [Entity Framework Core In-Depth](/shows/visual-studio-toolbox/entity-framework-core-in-depth-part-1)
+- Video: [The Intersection of Microservices, Domain-Driven Design and Entity Framework Core](https://www.youtube.com/watch?v=DG8Qe7TJiIE)
+- GitHub: [julielerman/dotnetconfms2020](https://github.com/julielerman/dotnetconfms2020)
+- Blog: [How to call stored procedures with OUTPUT parameters with FromSqlRaw in EF Core](https://erikej.github.io/efcore/2020/08/03/ef-core-call-stored-procedures-out-parameters.html)
+- Docs: [Getting Started with WPF](xref:core/get-started/wpf)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="handlebars"></a>
+
+### Jul 22: [Using Scaffolding with Handlebars](https://www.youtube.com/live/6Ux7EpgiWXE?si=78XhoFrViXVkMXOL)
+
+Join members from the .NET teams for our community standup covering great community contributions for Framework, .NET, Languages, CLI, MSBuild, and more.
+
+Featuring:
+
+- [Anthony Sneed](https://github.com/tonysneed) (Special guest)
+- [Brice Lambson](https://github.com/bricelam) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- GitHib: [fiseni/QuerySpecification](https://github.com/fiseni/QuerySpecification)
+- GitHub: [matteobortolazzo/couchdb-net](https://github.com/matteobortolazzo/couchdb-net)
+- Blog: [All in One with OData $Batch](https://devblogs.microsoft.com/odata/all-in-one-with-odata-batch/)
+- Blog: [Azure Cosmos DB - SQL API Geo-Replication Using EF Core](https://www.c-sharpcorner.com/article/azure-cosmos-db-sql-api-geo-replication-using-ef-core-part-three/)
+- Blog: [Announcing Entity Framework Core EF Core 5.0 Preview 7](https://devblogs.microsoft.com/dotnet/announcing-entity-framework-core-ef-core-5-0-preview-7/)
+- GitHub: [TrackableEntities/EntityFrameworkCore.Scaffolding.Handlebars](https://github.com/TrackableEntities/EntityFrameworkCore.Scaffolding.Handlebars)
+- Blog: [Tony Sneed's Blog](https://blog.tonysneed.com/2018/05/27/customize-ef-core-scaffolding-with-handlebars-templates/)
+- GitHub: [ErikEJ/EFCorePowerTools](https://github.com/ErikEJ/EFCorePowerTools/wiki)
+- GitHub: [TrackableEntities/ef-core-community-handlebars](https://github.com/TrackableEntities/ef-core-community-handlebars)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="blazor"></a>
+
+### Jun 24: [EF Core in Blazor](https://www.youtube.com/live/HNJYIqeBLQc?si=xvEObLRdY37_0L87)
+
+Join members from the .NET teams for our community standup covering great community contributions for Framework, .NET, Languages, CLI, MSBuild, and more.
+
+Featuring:
+
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+- [Brice Lambson](https://github.com/bricelam) (Host)
+
+Links:
+
+- Blog: [EF Core In depth – what happens when EF Core writes to the database?](https://www.thereformedprogrammer.net/ef-core-in-depth-what-happens-when-ef-core-writes-to-the-database/)
+- Blog: [Build a Blazor WebAssembly Line of Business App Part 1: Intro and Data Access](https://blog.jeremylikness.com/blog/build-a-blazor-webassembly-line-of-business-app/)
+- GitHub: [JeremyLikness/BlazorWasmEFCoreExample](https://github.com/JeremyLikness/BlazorWasmEFCoreExample)
+- GitHub: [JeremyLikness/BlazorServerEFCoreExample](https://github.com/JeremyLikness/BlazorServerEFCoreExample)
+- GitHub: [JeremyLikness/AzureBlazorCosmosWasm](https://github.com/JeremyLikness/AzureBlazorCosmosWasm)
+- Video: [Entity Framework Core In-Depth](/shows/visual-studio-toolbox/entity-framework-core-in-depth-part-1)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="power-tools1"></a>
+
+### Jun 10: [EF Core Power Tools](https://www.youtube.com/live/OWuP_qOYwsk?si=VoSGWW6CfR8-x46P)
+
+Join members from the .NET teams for our community standup covering great community contributions for Framework, .NET, Languages, CLI, MSBuild, and more.
+
+Featuring:
+
+- [Erik Ejlskov Jensen](https://github.com/ErikEJ) (Special guest)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+
+Links:
+
+- Blog: [Azure AD Secured Serverless Cosmos DB from Blazor WebAssembly](https://blog.jeremylikness.com/blog/azure-ad-secured-serverless-cosmosdb-from-blazor-webassembly/)
+- Blog: [HANDLING CONCURRENCY - AGGREGATE PATTERN AND EF CORE](https://www.kamilgrzybek.com/blog/posts/handling-concurrency-aggregate-pattern-ef-core)
+- Blog: [Announcing Entity Framework Core 5.0 Preview 4](https://devblogs.microsoft.com/dotnet/announcing-entity-framework-core-5-0-preview-4/)
+- Visual Studio Marketplace: [EF Core Power Tools](https://marketplace.visualstudio.com/items?itemName=ErikEJ.EFCorePowerTools)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
+
+<a name="one"></a>
+
+### May 6: [Introducing the EF Core Community Standup](https://www.youtube.com/live/j1sGgfCxhp0?si=VQBMex-9-me9JhAB)
+
+Join members from the .NET teams for our community standup covering great community contributions for Framework, .NET, Languages, CLI, MSBuild, and more.
+
+Featuring:
+
+- [Jeremy Likness](https://github.com/JeremyLikness) (Host)
+- [Arthur Vickers](https://github.com/ajcvickers) (Host)
+- [Shay Rojansky](https://github.com/roji) (Host)
+- [Andriy Svyryd](https://github.com/AndriySvyryd) (Host)
+- [lajones](https://github.com/lajones) (Host)
+- [Josh Lane](https://github.com/jplane) (Special guest)
+
+Links:
+
+- Blog: [Entity Framework Core 3.0: A Foundation for the Future](https://www.codemag.com/article/1911062)
+- Blog: [Event-driven integration #2 - Inferring events from EF Core changes](https://blog.codingmilitia.com/2020/04/20/aspnet-041-from-zero-to-overkill-event-driven-integration-inferring-events-from-efcore-changes/)
+- Blog: [Logging in EF Core](https://www.tektutorialshub.com/entity-framework-core/logging-in-ef-core/)
+- Blog: [How to Query SQL Server XML data type Columns in Entity Framework Core 3.x](https://www.robkennedy.com/2020/04/30/how-query-sql-server-xml-data-type-columns-in-entity-framework-core-3-x/)
+- Blog: [How to pass a dynamic/variable list of values as SqlParameters with FromSqlRaw in EF Core](https://erikej.github.io/efcore/sqlserver/2020/04/20/use-dynamic-sqlparameters-with-fromsql.html)
+- Blog: [Generate Entity Framework Core classes from a SQL Server database project - .dacpac file](https://erikej.github.io/efcore/sqlserver/2020/04/13/generate-efcore-classes-from-a-sql-server-database-project.html)
+- Blog: [Entity Framework Core 5 vs SQLBulkCopy](https://www.michalbialecki.com/2020/05/03/entity-framework-core-5-vs-sqlbulkcopy-2/)
+- Blog: [Microsoft, UPS and health care companies create app so you can donate masks to hospitals](https://eu.usatoday.com/story/money/2020/04/14/ups-microsoft-effort-lets-you-donate-masks-hospitals-need/2981932001/)
+- Blog: [Announcing Entity Framework Core 5.0 Preview 3](https://devblogs.microsoft.com/dotnet/announcing-entity-framework-core-5-0-preview-3/)
+- Docs: [EF Core daily builds](https://aka.ms/ef-daily-builds)
diff --git a/entity-framework/core/logging-events-diagnostics/debug-views.md.stub b/entity-framework/core/logging-events-diagnostics/debug-views.md.stub
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/entity-framework/core/logging-events-diagnostics/diagnostic-listeners.md b/entity-framework/core/logging-events-diagnostics/diagnostic-listeners.md
new file mode 100644
index 0000000000..a05ac400a6
--- /dev/null
+++ b/entity-framework/core/logging-events-diagnostics/diagnostic-listeners.md
@@ -0,0 +1,152 @@
+---
+title: Using diagnostic listeners - EF Core
+description: Using DiagnosticListener for global consumption of EF Core diagnostics
+author: SamMonoRT
+ms.date: 10/16/2020
+uid: core/logging-events-diagnostics/diagnostic-listeners
+ms.custom: sfi-ropc-nochange
+---
+
+# Using Diagnostic Listeners in EF Core
+
+> [!TIP]
+> You can [download this article's sample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/DiagnosticListeners) from GitHub.
+
+Diagnostic listeners allow listening for any EF Core event that occurs in the current .NET process. The <xref:System.Diagnostics.DiagnosticListener> class is a part of a [common mechanism across .NET](https://github.com/dotnet/runtime/blob/main/src/libraries/System.Diagnostics.DiagnosticSource/src/DiagnosticSourceUsersGuide.md) for obtaining diagnostic information from running applications.
+
+Diagnostic listeners are not suitable for getting events from a single DbContext instance. EF Core [interceptors](xref:core/logging-events-diagnostics/interceptors) provide access to the same events with per-context registration.
+
+Diagnostic listeners are not designed for logging. Consider using [simple logging](xref:core/logging-events-diagnostics/simple-logging) or [Microsoft.Extensions.Logging](xref:core/logging-events-diagnostics/extensions-logging) for logging.
+
+## Example: Observing diagnostic events
+
+Resolving EF Core events is a two-step process. First, an [observer](/dotnet/standard/events/observer-design-pattern) for `DiagnosticListener` itself must be created:
+
+<!--
+public class DiagnosticObserver : IObserver<DiagnosticListener>
+{
+    public void OnCompleted()
+        => throw new NotImplementedException();
+
+    public void OnError(Exception error)
+        => throw new NotImplementedException();
+
+    public void OnNext(DiagnosticListener value)
+    {
+        if (value.Name == DbLoggerCategory.Name) // "Microsoft.EntityFrameworkCore"
+        {
+            value.Subscribe(new KeyValueObserver());
+        }
+    }
+}
+-->
+[!code-csharp[DiagnosticObserver](../../../samples/core/Miscellaneous/DiagnosticListeners/Program.cs?name=DiagnosticObserver)]
+
+The `OnNext` method looks for the DiagnosticListener that comes from EF Core. This listener has the name "Microsoft.EntityFrameworkCore", which can be obtained from the <xref:Microsoft.EntityFrameworkCore.DbLoggerCategory> class as shown.
+
+This observer must then be registered globally, for example in the application's `Main` method:
+
+<!--
+        DiagnosticListener.AllListeners.Subscribe(new DiagnosticObserver());
+-->
+[!code-csharp[RegisterDiagnosticListener](../../../samples/core/Miscellaneous/DiagnosticListeners/Program.cs?name=RegisterDiagnosticListener)]
+
+Second, once the EF Core DiagnosticListener is found, a new key-value observer is created to subscribe to the actual EF Core events. For example:
+
+<!--
+public class KeyValueObserver : IObserver<KeyValuePair<string, object>>
+{
+    public void OnCompleted()
+        => throw new NotImplementedException();
+
+    public void OnError(Exception error)
+        => throw new NotImplementedException();
+
+    public void OnNext(KeyValuePair<string, object> value)
+    {
+        if (value.Key == CoreEventId.ContextInitialized.Name)
+        {
+            var payload = (ContextInitializedEventData)value.Value;
+            Console.WriteLine($"EF is initializing {payload.Context.GetType().Name} ");
+        }
+
+        if (value.Key == RelationalEventId.ConnectionOpening.Name)
+        {
+            var payload = (ConnectionEventData)value.Value;
+            Console.WriteLine($"EF is opening a connection to {payload.Connection.ConnectionString} ");
+        }
+    }
+}
+-->
+[!code-csharp[KeyValueObserver](../../../samples/core/Miscellaneous/DiagnosticListeners/Program.cs?name=KeyValueObserver)]
+
+The `OnNext` method is this time called with a key/value pair for each EF Core event. The key is the name of the event, which can be obtained from one of:
+
+* <xref:Microsoft.EntityFrameworkCore.Diagnostics.CoreEventId> for events common to all EF Core database providers
+* <xref:Microsoft.EntityFrameworkCore.Diagnostics.RelationalEventId> for events common to all relational database providers
+* A similar class for events specific to the current database provider. For example, <xref:Microsoft.EntityFrameworkCore.Diagnostics.SqlServerEventId> for the SQL Server provider.
+
+The value of the key/value pair is a payload type specific to the event. The type of payload to expect is documented on each event defined in these event classes.
+
+For example, the code above handles the <xref:Microsoft.EntityFrameworkCore.Diagnostics.CoreEventId.ContextInitialized> and the <xref:Microsoft.EntityFrameworkCore.Diagnostics.RelationalEventId.ConnectionOpening> events. For the first of these, the payload is <xref:Microsoft.EntityFrameworkCore.Diagnostics.ContextInitializedEventData>. For the second, it is <xref:Microsoft.EntityFrameworkCore.Diagnostics.ConnectionEventData>.
+
+> [!TIP]
+> ToString is overridden in every EF Core event data class to generate the equivalent log message for the event. For example, calling `ContextInitializedEventData.ToString` generates "Entity Framework Core 5.0.0 initialized 'BlogsContext' using provider 'Microsoft.EntityFrameworkCore.Sqlite' with options: None".
+
+The [sample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/DiagnosticListeners) contains a simple console application that makes changes to the blogging database and prints out the diagnostic events encountered.
+
+<!--
+    public static void Main()
+    {
+        #region RegisterDiagnosticListener
+        DiagnosticListener.AllListeners.Subscribe(new DiagnosticObserver());
+        #endregion
+
+        using (var context = new BlogsContext())
+        {
+            context.Database.EnsureDeleted();
+            context.Database.EnsureCreated();
+
+            context.Add(
+                new Blog
+                {
+                    Name = "EF Blog",
+                    Posts =
+                    {
+                        new Post { Title = "EF Core 3.1!" },
+                        new Post { Title = "EF Core 5.0!" }
+                    }
+                });
+
+            context.SaveChanges();
+        }
+
+        using (var context = new BlogsContext())
+        {
+            var blog = context.Blogs.Include(e => e.Posts).Single();
+
+            blog.Name = "EF Core Blog";
+            context.Remove(blog.Posts.First());
+            blog.Posts.Add(new Post { Title = "EF Core 6.0!" });
+
+            context.SaveChanges();
+        }
+        #endregion
+    }
+-->
+[!code-csharp[Program](../../../samples/core/Miscellaneous/DiagnosticListeners/Program.cs?name=Program)]
+
+The output from this code shows the events detected:
+
+```output
+EF is initializing BlogsContext
+EF is opening a connection to Data Source=blogs.db;Mode=ReadOnly
+EF is opening a connection to DataSource=blogs.db
+EF is opening a connection to Data Source=blogs.db;Mode=ReadOnly
+EF is opening a connection to DataSource=blogs.db
+EF is opening a connection to DataSource=blogs.db
+EF is opening a connection to DataSource=blogs.db
+EF is initializing BlogsContext
+EF is opening a connection to DataSource=blogs.db
+EF is opening a connection to DataSource=blogs.db
+```
diff --git a/entity-framework/core/logging-events-diagnostics/events.md b/entity-framework/core/logging-events-diagnostics/events.md
new file mode 100644
index 0000000000..7613921dd0
--- /dev/null
+++ b/entity-framework/core/logging-events-diagnostics/events.md
@@ -0,0 +1,133 @@
+---
+title: .NET events - EF Core
+description: .NET events defined by EF Core
+author: SamMonoRT
+ms.date: 10/15/2020
+uid: core/logging-events-diagnostics/events
+---
+
+# .NET Events in EF Core
+
+> [!TIP]
+> You can [download the events sample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/Events) from GitHub.
+
+Entity Framework Core (EF Core) exposes [.NET events](/dotnet/standard/events/) to act as callbacks when certain things happen in the EF Core code. Events are simpler than [interceptors](xref:core/logging-events-diagnostics/interceptors) and allow more flexible registration. However, they are sync only and so cannot perform non-blocking async I/O.
+
+Events are registered per `DbContext` instance. Use a [diagnostic listener](xref:core/logging-events-diagnostics/diagnostic-listeners) to get the same information but for all DbContext instances in the process.
+
+## Events raised by EF Core
+
+The following events are raised by EF Core:
+
+| Event | When raised
+|:------|-------
+| <xref:Microsoft.EntityFrameworkCore.DbContext.SavingChanges?displayProperty=nameWithType> | At the start of <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*> or <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChangesAsync*>
+| <xref:Microsoft.EntityFrameworkCore.DbContext.SavedChanges?displayProperty=nameWithType> | At the end of a successful <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*> or <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChangesAsync*>
+| <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChangesFailed?displayProperty=nameWithType> | At the end of a failed <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*> or <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChangesAsync*>
+| <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.Tracked?displayProperty=nameWithType> | When an entity is tracked by the context
+| <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.StateChanged?displayProperty=nameWithType> | When a tracked entity changes its state
+
+### Example: Timestamp state changes
+
+Each entity tracked by a DbContext has an <xref:Microsoft.EntityFrameworkCore.EntityState>. For example, the `Added` state indicates that the entity will be inserted into the database.
+
+This example uses the <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.Tracked> and <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.StateChanged> events to detect when an entity changes state. It then stamps the entity with the current time indicating when this change happened. This results in timestamps indicating when the entity was inserted, deleted, and/or last updated.
+
+The entity types in this example implement an interface that defines the timestamp properties:
+
+<!--
+public interface IHasTimestamps
+{
+    DateTime? Added { get; set; }
+    DateTime? Deleted { get; set; }
+    DateTime? Modified { get; set; }
+}
+-->
+[!code-csharp[IHasTimestamps](../../../samples/core/Miscellaneous/Events/Program.cs?name=IHasTimestamps)]
+
+A method on the application's DbContext can then set timestamps for any entity that implements this interface:
+
+<!--
+    private static void UpdateTimestamps(object sender, EntityEntryEventArgs e)
+    {
+        if (e.Entry.Entity is IHasTimestamps entityWithTimestamps)
+        {
+            switch (e.Entry.State)
+            {
+                case EntityState.Deleted:
+                    entityWithTimestamps.Deleted = DateTime.UtcNow;
+                    Console.WriteLine($"Stamped for delete: {e.Entry.Entity}");
+                    break;
+                case EntityState.Modified:
+                    entityWithTimestamps.Modified = DateTime.UtcNow;
+                    Console.WriteLine($"Stamped for update: {e.Entry.Entity}");
+                    break;
+                case EntityState.Added:
+                    entityWithTimestamps.Added = DateTime.UtcNow;
+                    Console.WriteLine($"Stamped for insert: {e.Entry.Entity}");
+                    break;
+            }
+        }
+    }
+-->
+[!code-csharp[UpdateTimestamps](../../../samples/core/Miscellaneous/Events/Program.cs?name=UpdateTimestamps)]
+
+This method has the appropriate signature to use as an event handler for both the `Tracked` and `StateChanged` events. The handler is registered for both events in the DbContext constructor. Note that events can be attached to a DbContext at any time; it is not required that this happen in the context constructor.
+
+<!--
+    public BlogsContext()
+    {
+        ChangeTracker.StateChanged += UpdateTimestamps;
+        ChangeTracker.Tracked += UpdateTimestamps;
+    }
+-->
+[!code-csharp[ContextConstructor](../../../samples/core/Miscellaneous/Events/Program.cs?name=ContextConstructor)]
+
+Both events are needed because new entities fire `Tracked` events when they are first tracked. `StateChanged` events are only fired for entities that change state while they are _already_ being tracked.
+
+The [sample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/Events) for this example contains a simple console application that makes changes to the blogging database:
+
+<!--
+        using (var context = new BlogsContext())
+        {
+            context.Database.EnsureDeleted();
+            context.Database.EnsureCreated();
+
+            context.Add(
+                new Blog
+                {
+                    Id = 1,
+                    Name = "EF Blog",
+                    Posts =
+                    {
+                        new Post { Id = 1, Title = "EF Core 3.1!" },
+                        new Post { Id = 2, Title = "EF Core 5.0!" }
+                    }
+                });
+
+            context.SaveChanges();
+        }
+
+        using (var context = new BlogsContext())
+        {
+            var blog = context.Blogs.Include(e => e.Posts).Single();
+
+            blog.Name = "EF Core Blog";
+            context.Remove(blog.Posts.First());
+            blog.Posts.Add(new Post { Id = 3, Title = "EF Core 6.0!" });
+
+            context.SaveChanges();
+        }
+-->
+[!code-csharp[Demonstration](../../../samples/core/Miscellaneous/Events/Program.cs?name=Demonstration)]
+
+The output from this code shows the state changes happening and the timestamps being applied:
+
+```output
+Stamped for insert: Blog 1 Added on: 10/15/2020 11:01:26 PM
+Stamped for insert: Post 1 Added on: 10/15/2020 11:01:26 PM
+Stamped for insert: Post 2 Added on: 10/15/2020 11:01:26 PM
+Stamped for delete: Post 1 Added on: 10/15/2020 11:01:26 PM Deleted on: 10/15/2020 11:01:26 PM
+Stamped for update: Blog 1 Added on: 10/15/2020 11:01:26 PM Modified on: 10/15/2020 11:01:26 PM
+Stamped for insert: Post 3 Added on: 10/15/2020 11:01:26 PM
+```
diff --git a/entity-framework/core/logging-events-diagnostics/extensions-logging.md b/entity-framework/core/logging-events-diagnostics/extensions-logging.md
new file mode 100644
index 0000000000..c18ebea30a
--- /dev/null
+++ b/entity-framework/core/logging-events-diagnostics/extensions-logging.md
@@ -0,0 +1,125 @@
+---
+title: Using Microsoft.Extensions.Logging - EF Core
+description: Logging from EF Core using Microsoft.Extensions.Logging in ASP.NET Core and other application types
+author: SamMonoRT
+ms.date: 10/15/2020
+uid: core/logging-events-diagnostics/extensions-logging
+---
+
+# Using Microsoft.Extensions.Logging in EF Core
+
+[Microsoft.Extensions.Logging](/dotnet/core/extensions/logging) is an extensible logging mechanism with plug-in providers for many common logging systems. Both Microsoft-supplied plug-ins (e.g [Microsoft.Extensions.Logging.Console](https://www.nuget.org/packages/Microsoft.Extensions.Logging.Console/)) and third-party plug-ins (e.g. [Serilog.Extensions.Logging](https://www.nuget.org/packages/Serilog.Extensions.Logging/)) are available as NuGet packages.
+
+Entity Framework Core (EF Core) fully integrates with `Microsoft.Extensions.Logging`. However, consider using [simple logging](xref:core/logging-events-diagnostics/simple-logging) for a simpler way to log, especially for applications that don't use dependency injection.
+
+## ASP.NET Core applications
+
+`Microsoft.Extensions.Logging` is [used by default in ASP.NET Core applications](/aspnet/core/fundamentals/logging). Calling <xref:Microsoft.Extensions.DependencyInjection.EntityFrameworkServiceCollectionExtensions.AddDbContext*> or <xref:Microsoft.Extensions.DependencyInjection.EntityFrameworkServiceCollectionExtensions.AddDbContextPool*> makes EF Core automatically use the logging setup configured via the regular ASP.NET mechanism.
+
+## Other application types
+
+Other application types can use the [GenericHost](/dotnet/core/extensions/generic-host) to get the same dependency injection patterns as are used in ASP.NET Core. <xref:Microsoft.Extensions.DependencyInjection.EntityFrameworkServiceCollectionExtensions.AddDbContext*> or <xref:Microsoft.Extensions.DependencyInjection.EntityFrameworkServiceCollectionExtensions.AddDbContextPool*> can then be used just like in ASP.NET Core applications.
+
+`Microsoft.Extensions.Logging` can also be used for applications that don't use dependency injection, although [simple logging](xref:core/logging-events-diagnostics/simple-logging) can be easier to set up.
+
+`Microsoft.Extensions.Logging` requires creation of a <xref:Microsoft.Extensions.Logging.LoggerFactory>. This factory should be stored as a static/global instance somewhere and used each time a DbContext is created. For example, it is common to store the logger factory as a static property on the DbContext.
+
+<!--
+        public static readonly ILoggerFactory MyLoggerFactory
+            = LoggerFactory.Create(builder => { builder.AddConsole(); });
+-->
+[!code-csharp[Main](../../../samples/core/Miscellaneous/Logging/Logging/BloggingContext.cs#DefineLoggerFactory)]
+
+This singleton/global instance should then be registered with EF Core on the <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder>. For example:
+
+<!--
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .UseLoggerFactory(MyLoggerFactory)
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFLogging;ConnectRetryCount=0");
+-->
+[!code-csharp[Main](../../../samples/core/Miscellaneous/Logging/Logging/BloggingContext.cs#RegisterLoggerFactory)]
+
+## Getting detailed messages
+
+> [!TIP]
+> OnConfiguring is still called when AddDbContext is used or a DbContextOptions instance is passed to the DbContext constructor. This makes it the ideal place to apply context configuration regardless of how the DbContext is constructed.
+
+### Sensitive data
+
+By default, EF Core will not include the values of any data in exception messages. This is because such data may be confidential, and could be revealed in production use if an exception is not handled.
+
+However, knowing data values, especially for keys, can be very helpful when debugging. This can be enabled in EF Core by calling <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.EnableSensitiveDataLogging>. For example:
+
+<!--
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder.EnableSensitiveDataLogging();
+-->
+[!code-csharp[EnableSensitiveDataLogging](../../../samples/core/Miscellaneous/Logging/Logging/BloggingContext.cs?name=EnableSensitiveDataLogging)]
+
+### Detailed query exceptions
+
+For performance reasons, EF Core does not wrap each call to read a value from the database provider in a try-catch block. However, this sometimes results in exceptions that are hard to diagnose, especially when the database returns a NULL when not allowed by the model.
+
+Turning on <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.EnableDetailedErrors*> will cause EF to introduce these try-catch blocks and thereby provide more detailed errors. For example:
+
+<!--
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder.EnableDetailedErrors();
+-->
+[!code-csharp[EnableDetailedErrors](../../../samples/core/Miscellaneous/Logging/Logging/BloggingContext.cs?name=EnableDetailedErrors)]
+
+## Configuration for specific messages
+
+The EF Core <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.ConfigureWarnings*> API allows applications to change what happens when a specific event is encountered. This can be used to:
+
+* Change the log level at which the event is logged
+* Skip logging the event altogether
+* Throw an exception when the event occurs
+
+### Changing the log level for an event
+
+Sometimes it can be useful to change the pre-defined log level for an event. For example, this can be used to promote two additional events from `LogLevel.Debug` to `LogLevel.Information`:
+
+<!--
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .ConfigureWarnings(b => b.Log(
+                    (RelationalEventId.ConnectionOpened, LogLevel.Information),
+                    (RelationalEventId.ConnectionClosed, LogLevel.Information)));
+-->
+[!code-csharp[ChangeLogLevel](../../../samples/core/Miscellaneous/Logging/Logging/BloggingContext.cs?name=ChangeLogLevel)]
+
+### Suppress logging an event
+
+In a similar way, an individual event can be suppressed from logging. This is particularly useful for ignoring a warning that has been reviewed and understood. For example:
+
+<!--
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .ConfigureWarnings(b => b.Ignore(CoreEventId.DetachedLazyLoadingWarning));
+-->
+[!code-csharp[SuppressMessage](../../../samples/core/Miscellaneous/Logging/Logging/BloggingContext.cs?name=SuppressMessage)]
+
+### Throw for an event
+
+Finally, EF Core can be configured to throw for a given event. This is particularly useful for changing a warning into an error. (Indeed, this was the original purpose of `ConfigureWarnings` method, hence the name.) For example:
+
+<!--
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .ConfigureWarnings(b => b.Throw(RelationalEventId.QueryPossibleUnintendedUseOfEqualsWarning));
+-->
+[!code-csharp[ThrowForEvent](../../../samples/core/Miscellaneous/Logging/Logging/BloggingContext.cs?name=ThrowForEvent)]
+
+## Filtering and other configuration
+
+See [Logging in .NET](/dotnet/core/extensions/logging) for guidance on log filtering and other configuration.
+
+EF Core logging events are defined in one of:
+
+* <xref:Microsoft.EntityFrameworkCore.Diagnostics.CoreEventId> for events common to all EF Core database providers
+* <xref:Microsoft.EntityFrameworkCore.Diagnostics.RelationalEventId> for events common to all relational database providers
+* A similar class for events specific to the current database provider. For example, <xref:Microsoft.EntityFrameworkCore.Diagnostics.SqlServerEventId> for the SQL Server provider.
+
+These definitions contain the event IDs, log level, and category for each event, as used by `Microsoft.Extensions.Logging`.
diff --git a/entity-framework/core/logging-events-diagnostics/index.md b/entity-framework/core/logging-events-diagnostics/index.md
new file mode 100644
index 0000000000..2ef9b108ed
--- /dev/null
+++ b/entity-framework/core/logging-events-diagnostics/index.md
@@ -0,0 +1,73 @@
+---
+title: Overview of logging and interception - EF Core
+description: Overview of logging, events, interceptors, and diagnostics for EF Core
+author: SamMonoRT
+ms.date: 11/15/2021
+uid: core/logging-events-diagnostics/index
+---
+
+# Overview of Logging and Interception
+
+Entity Framework Core (EF Core) contains several mechanisms for generating logs, responding to events, and obtaining diagnostics. Each of these is tailored to different situations, and it is important to select the best mechanism for the task in hand, even when multiple mechanisms could work. For example, a database interceptor could be used to log SQL, but this is better handled by one of the mechanisms tailored to logging. This page presents an overview of each of these mechanisms and describes when each should be used.
+
+## Quick reference
+
+The table below provides a quick reference for the differences between the mechanisms described here.
+
+| Mechanism |  Async | Scope | Registered | Intended use
+|:----------|--------|-------|------------|-------------
+| Simple Logging | No | Per context | Context configuration | Development-time logging
+| Microsoft.Extensions.Logging | No | Per context* | D.I. or context configuration | Production logging
+| Events | No | Per context | Any time | Reacting to EF events
+| Interceptors | Yes | Per context | Context configuration | Manipulating EF operations
+| Diagnostics listeners | No | Process | Globally | Application diagnostics
+
+*Typically `Microsoft.Extensions.Logging` is configured per-application via dependency injection. However, at the EF level, each context _can_ be configured with a different logger if needed.
+
+## Simple logging
+
+EF Core logs can be accessed from any type of application through the use of <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.LogTo*> when [configuring a DbContext instance](xref:core/dbcontext-configuration/index). This configuration is commonly done in an override of <xref:Microsoft.EntityFrameworkCore.DbContext.OnConfiguring*?displayProperty=nameWithType>. For example:
+
+<!--
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.LogTo(Console.WriteLine);
+-->
+[!code-csharp[LogToConsole](../../../samples/core/Miscellaneous/Logging/SimpleLogging/Program.cs?name=LogToConsole)]
+
+This concept is similar to <xref:System.Data.Entity.Database.Log?displayProperty=nameWithType> in EF6.
+
+See [Simple Logging](xref:core/logging-events-diagnostics/simple-logging) for more information.
+
+## Microsoft.Extensions.Logging
+
+[Microsoft.Extensions.Logging](/dotnet/core/extensions/logging) is an extensible logging mechanism with plug-in providers for many common logging systems. EF Core fully integrates with `Microsoft.Extensions.Logging` and this form of logging is used by default for ASP.NET Core applications.
+
+See [Using Microsoft.Extensions.Logging in EF Core](xref:core/logging-events-diagnostics/extensions-logging) for more information.
+
+## Events
+
+EF Core exposes [.NET events](/dotnet/standard/events/) to act as callbacks when certain things happen in the EF Core code. Events are simpler than interceptors and allow more flexible registration. However, they are sync only and so cannot perform non-blocking async I/O.
+
+Events are registered per DbContext instance and this registration can be done at any time. Use a [diagnostic listener](xref:core/logging-events-diagnostics/diagnostic-listeners) to get the same information but for all DbContext instances in the process.
+
+See [.NET Events in EF Core](xref:core/logging-events-diagnostics/events) for more information.
+
+## Interception
+
+EF Core interceptors enable interception, modification, and/or suppression of EF Core operations. This includes low-level database operations such as executing a command, as well as higher-level operations, such as calls to SaveChanges.
+
+Interceptors are different from logging and diagnostics in that they allow modification or suppression of the operation being intercepted. [Simple logging](xref:core/logging-events-diagnostics/simple-logging) or [Microsoft.Extensions.Logging](xref:core/logging-events-diagnostics/extensions-logging) are better choices for logging.
+
+Interceptors are registered per DbContext instance when the context is configured. Use a [diagnostic listener](xref:core/logging-events-diagnostics/diagnostic-listeners) to get the same information but for all DbContext instances in the process.
+
+See [Interception](xref:core/logging-events-diagnostics/interceptors) for more information.
+
+## Diagnostic listeners
+
+Diagnostic listeners allow listening for any EF Core event that occurs in the current .NET process.
+
+Diagnostic listeners are not suitable for getting events from a single DbContext instance. EF Core interceptors provide access to the same events with per-context registration.
+
+Diagnostic listeners are not designed for logging. [Simple logging](xref:core/logging-events-diagnostics/simple-logging) or [Microsoft.Extensions.Logging](xref:core/logging-events-diagnostics/extensions-logging) are better choices for logging.
+
+See [Using diagnostic listeners in EF Core](xref:core/logging-events-diagnostics/diagnostic-listeners) for more information.
diff --git a/entity-framework/core/logging-events-diagnostics/interceptors.md b/entity-framework/core/logging-events-diagnostics/interceptors.md
new file mode 100644
index 0000000000..46bc091a44
--- /dev/null
+++ b/entity-framework/core/logging-events-diagnostics/interceptors.md
@@ -0,0 +1,1352 @@
+---
+title: Interceptors - EF Core
+description: Interception for database operations and other events
+author: SamMonoRT
+ms.date: 02/26/2026
+uid: core/logging-events-diagnostics/interceptors
+ms.custom: sfi-ropc-nochange
+---
+
+# Interceptors
+
+Entity Framework Core (EF Core) interceptors enable interception, modification, and/or suppression of EF Core operations. This includes low-level database operations such as executing a command, as well as higher-level operations, such as calls to SaveChanges.
+
+Interceptors are different from logging and diagnostics in that they allow modification or suppression of the operation being intercepted. [Simple logging](xref:core/logging-events-diagnostics/simple-logging) or [Microsoft.Extensions.Logging](xref:core/logging-events-diagnostics/extensions-logging) are better choices for logging.
+
+Interceptors are registered per DbContext instance when the context is configured. Use a [diagnostic listener](xref:core/logging-events-diagnostics/diagnostic-listeners) to get the same information but for all DbContext instances in the process.
+
+## Available interceptors
+
+The following table shows the available interceptor interfaces:
+
+| Interceptor                                                                     | Operations intercepted                                                                                                                                                     | [Singleton](#singleton-interceptors) |
+|:--------------------------------------------------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:--------------------------------------:|
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.IDbCommandInterceptor>          | Creating commands</br>Executing commands</br>Command failures</br>Disposing the command's DbDataReader                                                                     | No                                     |
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.IDbConnectionInterceptor>       | Opening and closing connections</br>Creating connections</br>Connection failures                                                                                            | No                                     |
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.IDbTransactionInterceptor>      | Creating transactions</br>Using existing transactions</br>Committing transactions</br>Rolling back transactions</br>Creating and using savepoints</br>Transaction failures | No                                     |
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.ISaveChangesInterceptor>        | SavingChanges/SavedChanges</br>SaveChangesFailed</br>Optimistic concurrency handling                                                                                       | No                                     |
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.IMaterializationInterceptor>    | Creating, initializing, and finalizing entity instances from query results                                                                                                  | Yes                                    |
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.IQueryExpressionInterceptor>    | Modifying the LINQ expression tree before a query is compiled                                                                                                               | Yes                                    |
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.IIdentityResolutionInterceptor> | Resolving identity conflicts when tracking entities                                                                                                                         | Yes                                    |
+
+## Registering interceptors
+
+Interceptors are registered using <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.AddInterceptors*> when [configuring a DbContext instance](xref:core/dbcontext-configuration/index). This is commonly done in an override of <xref:Microsoft.EntityFrameworkCore.DbContext.OnConfiguring*?displayProperty=nameWithType>. For example:
+
+<!--
+public class ExampleContext : BlogsContext
+{
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.AddInterceptors(new TaggedQueryCommandInterceptor());
+}
+-->
+[!code-csharp[RegisterInterceptor](../../../samples/core/Miscellaneous/CommandInterception/Program.cs?name=RegisterInterceptor)]
+
+Alternately, `AddInterceptors` can be called as part of <xref:Microsoft.Extensions.DependencyInjection.EntityFrameworkServiceCollectionExtensions.AddDbContext*> or when creating a <xref:Microsoft.EntityFrameworkCore.DbContextOptions> instance to pass to the DbContext constructor.
+
+> [!TIP]
+> OnConfiguring is still called when AddDbContext is used or a DbContextOptions instance is passed to the DbContext constructor. This makes it the ideal place to apply context configuration regardless of how the DbContext is constructed.
+
+Interceptors are often stateless, which means that a single interceptor instance can be used for all DbContext instances. For example:
+
+<!--
+public class TaggedQueryCommandInterceptorContext : BlogsContext
+{
+    private static readonly TaggedQueryCommandInterceptor _interceptor
+        = new TaggedQueryCommandInterceptor();
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.AddInterceptors(_interceptor);
+}
+-->
+[!code-csharp[RegisterStatelessInterceptor](../../../samples/core/Miscellaneous/CommandInterception/Program.cs?name=RegisterStatelessInterceptor)]
+
+Every interceptor instance must implement one or more interface derived from <xref:Microsoft.EntityFrameworkCore.Diagnostics.IInterceptor>. Each instance should only be registered once even if it implements multiple interception interfaces; EF Core will route events for each interface as appropriate.
+
+### Singleton interceptors
+
+Some interceptors implement <xref:Microsoft.EntityFrameworkCore.Diagnostics.ISingletonInterceptor> (see table above); these interceptors are registered as singleton services in EF Core's internal service provider, meaning a single instance is shared across all `DbContext` instances that use the same service provider.
+
+Because singleton interceptors become part of EF Core's internal service configuration, each distinct interceptor instance causes a new internal service provider to be built. Passing a **new instance** of a singleton interceptor each time a `DbContext` is configured--for example, in `AddDbContext`--will eventually trigger a `ManyServiceProvidersCreatedWarning` and degrade performance.
+
+> [!WARNING]
+> Always reuse the same singleton interceptor instance for all `DbContext` instances. Do not create a new instance each time the context is configured.
+
+For example, the following is **incorrect** because a new interceptor instance is created for each context configuration:
+
+```csharp
+// Don't do this! A new instance each time causes a new internal service provider to be built.
+services.AddDbContext<CustomerContext>(
+    b => b.UseSqlServer(connectionString)
+          .AddInterceptors(new MyMaterializationInterceptor()));
+```
+
+Instead, reuse the same instance:
+
+```csharp
+// Correct: reuse a single interceptor instance
+var interceptor = new MyMaterializationInterceptor();
+services.AddDbContext<CustomerContext>(
+    b => b.UseSqlServer(connectionString)
+          .AddInterceptors(interceptor));
+```
+
+Or use a static field:
+
+```csharp
+public class CustomerContext : DbContext
+{
+    private static readonly MyMaterializationInterceptor _interceptor = new();
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.AddInterceptors(_interceptor);
+}
+```
+
+Because these interceptors are singletons, they must be thread-safe. They should generally not hold mutable state. If you need to access scoped services (such as the current `DbContext`), use the <xref:Microsoft.EntityFrameworkCore.Diagnostics.MaterializationInterceptionData.Context> or similar properties on the event data passed to each interceptor method.
+
+## Database interception
+
+> [!NOTE]
+> Database interception is only available for relational database providers.
+
+Low-level database interception is split into the three interfaces shown in the following table.
+
+| Interceptor                                                            | Database operations intercepted
+|:-----------------------------------------------------------------------|-------------------------------------------------
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.IDbCommandInterceptor> | Creating commands</br>Executing commands</br>Command failures</br>Disposing the command's DbDataReader
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.IDbConnectionInterceptor> | Opening and closing connections</br>Creating connections</br>Connection failures
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.IDbTransactionInterceptor> | Creating transactions</br>Using existing transactions</br>Committing transactions</br>Rolling back transactions</br>Creating and using savepoints</br>Transaction failures
+
+The base classes <xref:Microsoft.EntityFrameworkCore.Diagnostics.DbCommandInterceptor>, <xref:Microsoft.EntityFrameworkCore.Diagnostics.DbConnectionInterceptor>, and <xref:Microsoft.EntityFrameworkCore.Diagnostics.DbTransactionInterceptor> contain no-op implementations for each method in the corresponding interface. Use the base classes to avoid the need to implement unused interception methods.
+
+The methods on each interceptor type come in pairs, with the first being called before the database operation is started, and the second after the operation has completed. For example, <xref:Microsoft.EntityFrameworkCore.Diagnostics.DbCommandInterceptor.ReaderExecuting*?displayProperty=nameWithType> is called before a query is executed, and <xref:Microsoft.EntityFrameworkCore.Diagnostics.DbCommandInterceptor.ReaderExecuted*?displayProperty=nameWithType> is called after query has been sent to the database.
+
+Each pair of methods have both sync and async variations. This allows for asynchronous I/O, such as requesting an access token, to happen as part of intercepting an async database operation.
+
+### Example: Command interception to add query hints
+
+> [!TIP]
+> You can [download the command interceptor sample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/CommandInterception) from GitHub.
+
+An <xref:Microsoft.EntityFrameworkCore.Diagnostics.IDbCommandInterceptor> can be used to modify SQL before it is sent to the database. This example shows how to modify the SQL to include a query hint.
+
+Often, the trickiest part of the interception is determining when the command corresponds to the query that needs to be modified. Parsing the SQL is one option, but tends to be fragile. Another option is to use [EF Core query tags](xref:core/querying/tags) to tag each query that should be modified. For example:
+
+<!--
+            var blogs1 = context.Blogs.TagWith("Use hint: robust plan").ToList();
+-->
+[!code-csharp[TaggedQuery](../../../samples/core/Miscellaneous/CommandInterception/Program.cs?name=TaggedQuery)]
+
+This tag can then be detected in the interceptor as it will always be included as a comment in the first line of the command text. On detecting the tag, the query SQL is modified to add the appropriate hint:
+
+<!--
+public class TaggedQueryCommandInterceptor : DbCommandInterceptor
+{
+    public override InterceptionResult<DbDataReader> ReaderExecuting(
+        DbCommand command,
+        CommandEventData eventData,
+        InterceptionResult<DbDataReader> result)
+    {
+        ManipulateCommand(command);
+
+        return result;
+    }
+
+    public override ValueTask<InterceptionResult<DbDataReader>> ReaderExecutingAsync(
+        DbCommand command,
+        CommandEventData eventData,
+        InterceptionResult<DbDataReader> result,
+        CancellationToken cancellationToken = default)
+    {
+        ManipulateCommand(command);
+
+        return ValueTask.FromResult(result);
+    }
+
+    private static void ManipulateCommand(DbCommand command)
+    {
+        if (command.CommandText.StartsWith("-- Use hint: robust plan", StringComparison.Ordinal))
+        {
+            command.CommandText += " OPTION (ROBUST PLAN)";
+        }
+    }
+}
+-->
+[!code-csharp[TaggedQueryCommandInterceptor](../../../samples/core/Miscellaneous/CommandInterception/TaggedQueryCommandInterceptor.cs?name=TaggedQueryCommandInterceptor)]
+
+Notice:
+
+* The interceptor inherits from <xref:Microsoft.EntityFrameworkCore.Diagnostics.DbCommandInterceptor> to avoid having to implement every method in the interceptor interface.
+* The interceptor implements both sync and async methods. This ensures that the same query hint is applied to sync and async queries.
+* The interceptor implements the `Executing` methods which are called by EF Core with the generated SQL _before_ it is sent to the database. Contrast this with the `Executed` methods, which are called after the database call has returned.
+
+Running the code in this example generates the following when a query is tagged:
+
+```sql
+-- Use hint: robust plan
+
+SELECT [b].[Id], [b].[Name]
+FROM [Blogs] AS [b] OPTION (ROBUST PLAN)
+```
+
+On the other hand, when a query is not tagged, then it is sent to the database unmodified:
+
+```sql
+SELECT [b].[Id], [b].[Name]
+FROM [Blogs] AS [b]
+```
+
+### Example: Connection interception for SQL Azure authentication using AAD
+
+> [!TIP]
+> You can [download the connection interceptor sample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/ConnectionInterception) from GitHub.
+
+An <xref:Microsoft.EntityFrameworkCore.Diagnostics.IDbConnectionInterceptor> can be used to manipulate the <xref:System.Data.Common.DbConnection> before it is used to connect to the database. This can be used to obtain an Azure Active Directory (AAD) access token. For example:
+
+<!--
+public class AadAuthenticationInterceptor : DbConnectionInterceptor
+{
+    public override InterceptionResult ConnectionOpening(
+        DbConnection connection,
+        ConnectionEventData eventData,
+        InterceptionResult result)
+        => throw new InvalidOperationException("Open connections asynchronously when using AAD authentication.");
+
+    public override async ValueTask<InterceptionResult> ConnectionOpeningAsync(
+        DbConnection connection,
+        ConnectionEventData eventData,
+        InterceptionResult result,
+        CancellationToken cancellationToken = default)
+    {
+        var sqlConnection = (SqlConnection)connection;
+
+        var provider = new AzureServiceTokenProvider();
+        // Note: in some situations the access token may not be cached automatically the Azure Token Provider.
+        // Depending on the kind of token requested, you may need to implement your own caching here.
+        sqlConnection.AccessToken = await provider.GetAccessTokenAsync("https://database.windows.net/", null, cancellationToken);
+
+        return result;
+    }
+}
+-->
+[!code-csharp[AadAuthenticationInterceptor](../../../samples/core/Miscellaneous/ConnectionInterception/AadAuthenticationInterceptor.cs?name=AadAuthenticationInterceptor)]
+
+> [!TIP]
+> [Microsoft.Data.SqlClient](https://www.nuget.org/packages/Microsoft.Data.SqlClient/) now supports AAD authentication via connection string. See <xref:Microsoft.Data.SqlClient.SqlAuthenticationMethod> for more information.
+
+> [!WARNING]
+> Notice that the interceptor throws if a sync call is made to open the connection. This is because there is no non-async method to obtain the access token and there is [no universal and simple way to call an async method from non-async context without risking deadlock](https://devblogs.microsoft.com/dotnet/configureawait-faq/).
+
+> [!WARNING]
+> in some situations the access token may not be cached automatically the Azure Token Provider. Depending on the kind of token requested, you may need to implement your own caching here.
+
+### Example: Lazy initialization of a connection string
+
+Connection strings are often static assets read from a configuration file. These can easily be passed to `UseSqlServer` or similar when configuring a `DbContext`. However, sometimes the connection string can change for each context instance. For example, each tenant in a multi-tenant system may have a different connection string.
+
+An <xref:Microsoft.EntityFrameworkCore.Diagnostics.IDbConnectionInterceptor> can be used to handle dynamic connections and connection strings. This starts with the ability to configure the `DbContext` without any connection string. For example:
+
+```csharp
+services.AddDbContext<CustomerContext>(
+    b => b.UseSqlServer());
+```
+
+One of the `IDbConnectionInterceptor` methods can then be implemented to configure the connection before it is used. `ConnectionOpeningAsync` is a good choice, since it can perform an async operation to obtain the connection string, find an access token, and so on. For example, imagine a service scoped to the current request that understands the current tenant:
+
+```csharp
+services.AddScoped<ITenantConnectionStringFactory, TestTenantConnectionStringFactory>();
+```
+
+> [!WARNING]
+> Performing an asynchronous lookup for a connection string, access token, or similar every time it is needed can be very slow. Consider caching these things and only refreshing the cached string or token periodically. For example, access tokens can often be used for a significant period of time before needing to be refreshed.
+
+This can be injected into each `DbContext` instance using constructor injection:
+
+```csharp
+public class CustomerContext : DbContext
+{
+    private readonly ITenantConnectionStringFactory _connectionStringFactory;
+
+    public CustomerContext(
+        DbContextOptions<CustomerContext> options,
+        ITenantConnectionStringFactory connectionStringFactory)
+        : base(options)
+    {
+        _connectionStringFactory = connectionStringFactory;
+    }
+
+    // ...
+}
+```
+
+This service is then used when constructing the interceptor implementation for the context:
+
+```csharp
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    => optionsBuilder.AddInterceptors(
+        new ConnectionStringInitializationInterceptor(_connectionStringFactory));
+```
+
+Finally, the interceptor uses this service to obtain the connection string asynchronously and set it the first time that the connection is used:
+
+```csharp
+public class ConnectionStringInitializationInterceptor : DbConnectionInterceptor
+{
+    private readonly ITenantConnectionStringFactory _connectionStringFactory;
+
+    public ConnectionStringInitializationInterceptor(ITenantConnectionStringFactory connectionStringFactory)
+    {
+        _connectionStringFactory = connectionStringFactory;
+    }
+
+    public override InterceptionResult ConnectionOpening(
+        DbConnection connection,
+        ConnectionEventData eventData,
+        InterceptionResult result)
+        => throw new NotSupportedException("Synchronous connections not supported.");
+
+    public override async ValueTask<InterceptionResult> ConnectionOpeningAsync(
+        DbConnection connection, ConnectionEventData eventData, InterceptionResult result,
+        CancellationToken cancellationToken = new())
+    {
+        if (string.IsNullOrEmpty(connection.ConnectionString))
+        {
+            connection.ConnectionString = (await _connectionStringFactory.GetConnectionStringAsync(cancellationToken));
+        }
+
+        return result;
+    }
+}
+```
+
+> [!NOTE]
+> The connection string is only obtained the first time that a connection is used. After that, the connection string stored on the `DbConnection` will be used without looking up a new connection string.
+
+> [!TIP]
+> This interceptor overrides the non-async `ConnectionOpening` method to throw since the service to get the connection string must be called from an async code path.
+
+### Example: Advanced command interception for caching
+
+> [!TIP]
+> You can [download the advanced command interceptor sample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/CachingInterception) from GitHub.
+
+EF Core interceptors can:
+
+* Tell EF Core to suppress executing the operation being intercepted
+* Change the result of the operation reported back to EF Core
+
+This example shows an interceptor that uses these features to behave like a primitive second-level cache. Cached query results are returned for a specific query, avoiding a database roundtrip.
+
+> [!WARNING]
+> Take care when changing the EF Core default behavior in this way. EF Core may behave in unexpected ways if it gets an abnormal result that it cannot process correctly. Also, this example demonstrates interceptor concepts; it is not intended as a template for a robust second-level cache implementation.
+
+In this example, the application frequently executes a query to obtain the most recent "daily message":
+
+<!--
+        async Task<string> GetDailyMessage(DailyMessageContext context)
+            => (await context.DailyMessages.TagWith("Get_Daily_Message").OrderBy(e => e.Id).LastAsync()).Message;
+-->
+[!code-csharp[GetDailyMessage](../../../samples/core/Miscellaneous/CachingInterception/Program.cs?name=GetDailyMessage)]
+
+This query is [tagged](xref:core/querying/tags) so that it can be easily detected in the interceptor. The idea is to only query the database for a new message once every day. At other times the application will use a cached result. (The sample uses delay of 10 seconds in the sample to simulate a new day.)
+
+#### Interceptor state
+
+This interceptor is stateful: it stores the ID and message text of the most recent daily message queried, plus the time when that query was executed. Because of this state we also need a [lock](/dotnet/csharp/language-reference/keywords/lock-statement) since the caching requires that same interceptor must be used by multiple context instances.
+
+<!--
+    private readonly object _lock = new object();
+    private int _id;
+    private string _message;
+    private DateTime _queriedAt;
+-->
+[!code-csharp[InterceptorState](../../../samples/core/Miscellaneous/CachingInterception/CachingCommandInterceptor.cs?name=InterceptorState)]
+
+#### Before execution
+
+In the `Executing` method (i.e. before making a database call), the interceptor detects the tagged query and then checks if there is a cached result. If such a result is found, then the query is suppressed and cached results are used instead.
+
+<!--
+    public override ValueTask<InterceptionResult<DbDataReader>> ReaderExecutingAsync(
+        DbCommand command,
+        CommandEventData eventData,
+        InterceptionResult<DbDataReader> result,
+        CancellationToken cancellationToken = default)
+    {
+        if (command.CommandText.StartsWith("-- Get_Daily_Message", StringComparison.Ordinal))
+        {
+            lock (_lock)
+            {
+                if (_message != null
+                    && DateTime.UtcNow < _queriedAt + new TimeSpan(0, 0, 10))
+                {
+                    command.CommandText = "-- Get_Daily_Message: Skipping DB call; using cache.";
+                    result = InterceptionResult<DbDataReader>.SuppressWithResult(new CachedDailyMessageDataReader(_id, _message));
+                }
+            }
+        }
+
+        return new ValueTask<InterceptionResult<DbDataReader>>(result);
+    }
+-->
+[!code-csharp[ReaderExecutingAsync](../../../samples/core/Miscellaneous/CachingInterception/CachingCommandInterceptor.cs?name=ReaderExecutingAsync)]
+
+Notice how the code calls <xref:Microsoft.EntityFrameworkCore.Diagnostics.InterceptionResult`1.SuppressWithResult*?displayProperty=nameWithType> and passes a replacement <xref:System.Data.Common.DbDataReader> containing the cached data. This InterceptionResult is then returned, causing suppression of query execution. The replacement reader is instead used by EF Core as the results of the query.
+
+This interceptor also manipulates the command text. This manipulation is not required, but improves clarity in log messages. The command text does not need to be valid SQL since the query is now not going to be executed.
+
+#### After execution
+
+If no cached message is available, or if it has expired, then the code above does not suppress the result. EF Core will therefore execute the query as normal. It will then return to the interceptor's `Executed` method after execution. At this point if the result is not already a cached reader, then the new message ID and string is extracted from the real reader and cached ready for the next use of this query.
+
+<!--
+    public override async ValueTask<DbDataReader> ReaderExecutedAsync(
+        DbCommand command,
+        CommandExecutedEventData eventData,
+        DbDataReader result,
+        CancellationToken cancellationToken = default)
+    {
+        if (command.CommandText.StartsWith("-- Get_Daily_Message", StringComparison.Ordinal)
+            && !(result is CachedDailyMessageDataReader))
+        {
+            try
+            {
+                await result.ReadAsync(cancellationToken);
+
+                lock (_lock)
+                {
+                    _id = result.GetInt32(0);
+                    _message = result.GetString(1);
+                    _queriedAt = DateTime.UtcNow;
+                    return new CachedDailyMessageDataReader(_id, message);
+                }
+            }
+            finally
+            {
+                await result.DisposeAsync();
+            }
+        }
+
+        return result;
+    }
+-->
+[!code-csharp[ReaderExecutedAsync](../../../samples/core/Miscellaneous/CachingInterception/CachingCommandInterceptor.cs?name=ReaderExecutedAsync)]
+
+#### Demonstration
+
+The [caching interceptor sample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/CachingInterception) contains a simple console application that queries for daily messages to test the caching:
+
+<!--
+        // 1. Initialize the database with some daily messages.
+        using (var context = new DailyMessageContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            context.AddRange(
+                new DailyMessage { Message = "Remember: All builds are GA; no builds are RTM." },
+                new DailyMessage { Message = "Keep calm and drink tea" });
+
+            await context.SaveChangesAsync();
+        }
+
+        // 2. Query for the most recent daily message. It will be cached for 10 seconds.
+        using (var context = new DailyMessageContext())
+        {
+            Console.WriteLine(await GetDailyMessage(context));
+        }
+
+        // 3. Insert a new daily message.
+        using (var context = new DailyMessageContext())
+        {
+            context.Add(new DailyMessage { Message = "Free beer for unicorns" });
+
+            await context.SaveChangesAsync();
+        }
+
+        // 4. Cached message is used until cache expires.
+        using (var context = new DailyMessageContext())
+        {
+            Console.WriteLine(await GetDailyMessage(context));
+        }
+
+        // 5. Pretend it's the next day.
+        Thread.Sleep(10000);
+
+        // 6. Cache is expired, so the last message will noe be queried again.
+        using (var context = new DailyMessageContext())
+        {
+            Console.WriteLine(await GetDailyMessage(context));
+        }
+
+        #region GetDailyMessage
+        async Task<string> GetDailyMessage(DailyMessageContext context)
+            => (await context.DailyMessages.TagWith("Get_Daily_Message").OrderBy(e => e.Id).LastAsync()).Message;
+        #endregion
+-->
+[!code-csharp[Main](../../../samples/core/Miscellaneous/CachingInterception/Program.cs?name=Main)]
+
+This results in the following output:
+
+```output
+info: 10/15/2020 12:32:11.801 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed DbCommand (0ms) [Parameters=[], CommandType='Text', CommandTimeout='30']
+      -- Get_Daily_Message
+
+      SELECT "d"."Id", "d"."Message"
+      FROM "DailyMessages" AS "d"
+      ORDER BY "d"."Id" DESC
+      LIMIT 1
+
+Keep calm and drink tea
+
+info: 10/15/2020 12:32:11.821 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed DbCommand (0ms) [Parameters=[@p0='Free beer for unicorns' (Size = 22)], CommandType='Text', CommandTimeout='30']
+      INSERT INTO "DailyMessages" ("Message")
+      VALUES (@p0);
+      SELECT "Id"
+      FROM "DailyMessages"
+      WHERE changes() = 1 AND "rowid" = last_insert_rowid();
+
+info: 10/15/2020 12:32:11.826 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed DbCommand (0ms) [Parameters=[], CommandType='Text', CommandTimeout='30']
+      -- Get_Daily_Message: Skipping DB call; using cache.
+
+Keep calm and drink tea
+
+info: 10/15/2020 12:32:21.833 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed DbCommand (0ms) [Parameters=[], CommandType='Text', CommandTimeout='30']
+      -- Get_Daily_Message
+
+      SELECT "d"."Id", "d"."Message"
+      FROM "DailyMessages" AS "d"
+      ORDER BY "d"."Id" DESC
+      LIMIT 1
+
+Free beer for unicorns
+```
+
+Notice from the log output that the application continues to use the cached message until the timeout expires, at which point the database is queried again for any new message.
+
+### Example: Logging SQL Server query statistics
+
+This example shows two interceptors that work together to send SQL Server query statistics to the application log. To generate the statistics, we need an <xref:Microsoft.EntityFrameworkCore.Diagnostics.IDbCommandInterceptor> to do two things.
+
+First, the interceptor will prefix commands with `SET STATISTICS IO ON`, which tells SQL Server to send statistics to the client after a result set has been consumed:
+
+```csharp
+public override ValueTask<InterceptionResult<DbDataReader>> ReaderExecutingAsync(
+    DbCommand command,
+    CommandEventData eventData,
+    InterceptionResult<DbDataReader> result,
+    CancellationToken cancellationToken = default)
+{
+    command.CommandText = "SET STATISTICS IO ON;" + Environment.NewLine + command.CommandText;
+
+    return new(result);
+}
+```
+
+Second, the interceptor will implement the `DataReaderClosingAsync` method, which is called after the <xref:System.Data.Common.DbDataReader> has finished consuming results, but _before_ it has been closed. When SQL Server is sending statistics, it puts them in a second result on the reader, so at this point the interceptor reads that result by calling `NextResultAsync` which populates statistics onto the connection.
+
+```csharp
+public override async ValueTask<InterceptionResult> DataReaderClosingAsync(
+    DbCommand command,
+    DataReaderClosingEventData eventData,
+    InterceptionResult result)
+{
+    await eventData.DataReader.NextResultAsync();
+
+    return result;
+}
+```
+
+The second interceptor is needed to obtain the statistics from the connection and write them out to the application's logger. For this, we'll use an <xref:Microsoft.EntityFrameworkCore.Diagnostics.IDbConnectionInterceptor>, implementing the `ConnectionCreated` method. `ConnectionCreated` is called immediately after EF Core has created a connection, and so can be used to perform additional configuration of that connection. In this case, the interceptor obtains an `ILogger` and then hooks into the <xref:Microsoft.Data.SqlClient.SqlConnection.InfoMessage?displayProperty=nameWithType> event to log the messages.
+
+```csharp
+public override DbConnection ConnectionCreated(ConnectionCreatedEventData eventData, DbConnection result)
+{
+    var logger = eventData.Context!.GetService<ILoggerFactory>().CreateLogger("InfoMessageLogger");
+    ((SqlConnection)eventData.Connection).InfoMessage += (_, args) =>
+    {
+        logger.LogInformation(1, args.Message);
+    };
+    return result;
+}
+```
+
+> [!IMPORTANT]
+> The `ConnectionCreating` and `ConnectionCreated` methods are only called when EF Core creates a `DbConnection`. They will not be called if the application creates the `DbConnection` and passes it to EF Core.
+
+### Filtering by command source
+
+The <xref:Microsoft.EntityFrameworkCore.Diagnostics.CommandEventData> supplied to diagnostics sources and interceptors contains a <xref:Microsoft.EntityFrameworkCore.Diagnostics.CommandSource> property indicating which part of EF was responsible for creating the command. This can be used as a filter in the interceptor. For example, we may want an interceptor that only applies to commands that come from `SaveChanges`:
+
+```csharp
+public class CommandSourceInterceptor : DbCommandInterceptor
+{
+    public override InterceptionResult<DbDataReader> ReaderExecuting(
+        DbCommand command, CommandEventData eventData, InterceptionResult<DbDataReader> result)
+    {
+        if (eventData.CommandSource == CommandSource.SaveChanges)
+        {
+            Console.WriteLine($"Saving changes for {eventData.Context!.GetType().Name}:");
+            Console.WriteLine();
+            Console.WriteLine(command.CommandText);
+        }
+
+        return result;
+    }
+}
+```
+
+## SaveChanges interception
+
+> [!TIP]
+> You can [download the SaveChanges interceptor sample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/SaveChangesInterception) from GitHub.
+
+<xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*> and <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChangesAsync*> interception points are defined by the <xref:Microsoft.EntityFrameworkCore.Diagnostics.ISaveChangesInterceptor> interface. As for other interceptors, the <xref:Microsoft.EntityFrameworkCore.Diagnostics.SaveChangesInterceptor> base class with no-op methods is provided as a convenience.
+
+> [!TIP]
+> Interceptors are powerful. However, in many cases it may be easier to override the SaveChanges method or use the [.NET events for SaveChanges](xref:core/logging-events-diagnostics/events) exposed on DbContext.
+
+### Example: SaveChanges interception for auditing
+
+SaveChanges can be intercepted to create an independent audit record of the changes made.
+
+> [!NOTE]
+> This is not intended to be a robust auditing solution. Rather it is a simplistic example used to demonstrate the features of interception.
+
+#### The application context
+
+The [sample for auditing](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/SaveChangesInterception) uses a simple DbContext with blogs and posts.
+
+<!--
+public class BlogsContext : DbContext
+{
+    private readonly AuditingInterceptor _auditingInterceptor = new AuditingInterceptor("DataSource=audit.db");
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .AddInterceptors(_auditingInterceptor)
+            .UseSqlite("DataSource=blogs.db");
+
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+public class Blog
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+
+    public ICollection<Post> Posts { get; } = new List<Post>();
+}
+
+public class Post
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+
+    public Blog Blog { get; set; }
+}
+-->
+[!code-csharp[BlogsContext](../../../samples/core/Miscellaneous/SaveChangesInterception/BlogsContext.cs?name=BlogsContext)]
+
+Notice that a new instance of the interceptor is registered for each DbContext instance. This is because the auditing interceptor contains state linked to the current context instance.
+
+#### The audit context
+
+The sample also contains a second DbContext and model used for the auditing database.
+
+<!--
+public class AuditContext : DbContext
+{
+    private readonly string _connectionString;
+
+    public AuditContext(string connectionString)
+    {
+        _connectionString = connectionString;
+    }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.UseSqlite(_connectionString);
+
+    public DbSet<SaveChangesAudit> SaveChangesAudits { get; set; }
+}
+
+public class SaveChangesAudit
+{
+    public int Id { get; set; }
+    public Guid AuditId { get; set; }
+    public DateTime StartTime { get; set; }
+    public DateTime EndTime { get; set; }
+    public bool Succeeded { get; set; }
+    public string ErrorMessage { get; set; }
+
+    public ICollection<EntityAudit> Entities { get; } = new List<EntityAudit>();
+}
+
+public class EntityAudit
+{
+    public int Id { get; set; }
+    public EntityState State { get; set; }
+    public string AuditMessage { get; set; }
+
+    public SaveChangesAudit SaveChangesAudit { get; set; }
+}
+-->
+[!code-csharp[AuditContext](../../../samples/core/Miscellaneous/SaveChangesInterception/AuditContext.cs?name=AuditContext)]
+
+#### The interceptor
+
+The general idea for auditing with the interceptor is:
+
+* An audit message is created at the beginning of SaveChanges and is written to the auditing database
+* SaveChanges is allowed to continue
+* If SaveChanges succeeds, then the audit message is updated to indicate success
+* If SaveChanges fails, then the audit message is updated to indicate the failure
+
+The first stage is handled before any changes are sent to the database using overrides of <xref:Microsoft.EntityFrameworkCore.Diagnostics.ISaveChangesInterceptor.SavingChanges*?displayProperty=nameWithType> and <xref:Microsoft.EntityFrameworkCore.Diagnostics.ISaveChangesInterceptor.SavingChangesAsync*?displayProperty=nameWithType>.
+
+<!--
+    public async ValueTask<InterceptionResult<int>> SavingChangesAsync(
+        DbContextEventData eventData,
+        InterceptionResult<int> result,
+        CancellationToken cancellationToken = default)
+    {
+        _audit = CreateAudit(eventData.Context);
+
+        using (var auditContext = new AuditContext(_connectionString))
+        {
+            auditContext.Add(_audit);
+            await auditContext.SaveChangesAsync();
+        }
+
+        return result;
+    }
+
+    public InterceptionResult<int> SavingChanges(
+        DbContextEventData eventData,
+        InterceptionResult<int> result)
+    {
+        _audit = CreateAudit(eventData.Context);
+
+        using (var auditContext = new AuditContext(_connectionString))
+        {
+            auditContext.Add(_audit);
+            auditContext.SaveChanges();
+        }
+
+        return result;
+    }
+-->
+[!code-csharp[SavingChanges](../../../samples/core/Miscellaneous/SaveChangesInterception/AuditingInterceptor.cs?name=SavingChanges)]
+
+Overriding both sync and async methods ensures that auditing will happen regardless of whether `SaveChanges` or `SaveChangesAsync` are called. Notice also that the async overload is itself able to perform non-blocking async I/O to the auditing database. You may wish to throw from the sync `SavingChanges` method to ensure that all database I/O is async. This then requires that the application always calls `SaveChangesAsync` and never `SaveChanges`.
+
+#### The audit message
+
+Every interceptor method has an `eventData` parameter providing contextual information about the event being intercepted. In this case the current application DbContext is included in the event data, which is then used to create an audit message.
+
+<!--
+    private static SaveChangesAudit CreateAudit(DbContext context)
+    {
+        context.ChangeTracker.DetectChanges();
+
+        var audit = new SaveChangesAudit
+        {
+            AuditId = Guid.NewGuid(),
+            StartTime = DateTime.UtcNow
+        };
+
+        foreach (var entry in context.ChangeTracker.Entries())
+        {
+            var auditMessage = entry.State switch
+            {
+                EntityState.Deleted => CreateDeletedMessage(entry),
+                EntityState.Modified => CreateModifiedMessage(entry),
+                EntityState.Added => CreateAddedMessage(entry),
+                _ => null
+            };
+
+            if (auditMessage != null)
+            {
+                audit.Entities.Add(new EntityAudit { State = entry.State, AuditMessage = auditMessage });
+            }
+        }
+
+        return audit;
+
+        string CreateAddedMessage(EntityEntry entry)
+            => entry.Properties.Aggregate(
+                $"Inserting {entry.Metadata.DisplayName()} with ",
+                (auditString, property) => auditString + $"{property.Metadata.Name}: '{property.CurrentValue}' ");
+
+        string CreateModifiedMessage(EntityEntry entry)
+            => entry.Properties.Where(property => property.IsModified || property.Metadata.IsPrimaryKey()).Aggregate(
+                $"Updating {entry.Metadata.DisplayName()} with ",
+                (auditString, property) => auditString + $"{property.Metadata.Name}: '{property.CurrentValue}' ");
+
+        string CreateDeletedMessage(EntityEntry entry)
+            => entry.Properties.Where(property => property.Metadata.IsPrimaryKey()).Aggregate(
+                $"Deleting {entry.Metadata.DisplayName()} with ",
+                (auditString, property) => auditString + $"{property.Metadata.Name}: '{property.CurrentValue}' ");
+    }
+-->
+[!code-csharp[CreateAudit](../../../samples/core/Miscellaneous/SaveChangesInterception/AuditingInterceptor.cs?name=CreateAudit)]
+
+The result is a `SaveChangesAudit` entity with a collection of `EntityAudit` entities, one for each insert, update, or delete. The interceptor then inserts these entities into the audit database.
+
+> [!TIP]
+> ToString is overridden in every EF Core event data class to generate the equivalent log message for the event. For example, calling `ContextInitializedEventData.ToString` generates "Entity Framework Core 5.0.0 initialized 'BlogsContext' using provider 'Microsoft.EntityFrameworkCore.Sqlite' with options: None".
+
+#### Detecting success
+
+The audit entity is stored on the interceptor so that it can be accessed again once SaveChanges either succeeds or fails. For success, <xref:Microsoft.EntityFrameworkCore.Diagnostics.ISaveChangesInterceptor.SavedChanges*?displayProperty=nameWithType> or <xref:Microsoft.EntityFrameworkCore.Diagnostics.ISaveChangesInterceptor.SavedChangesAsync*?displayProperty=nameWithType> is called.
+
+<!--
+    public int SavedChanges(SaveChangesCompletedEventData eventData, int result)
+    {
+        using (var auditContext = new AuditContext(_connectionString))
+        {
+            auditContext.Attach(_audit);
+            _audit.Succeeded = true;
+            _audit.EndTime = DateTime.UtcNow;
+
+            auditContext.SaveChanges();
+        }
+
+        return result;
+    }
+
+    public async ValueTask<int> SavedChangesAsync(
+        SaveChangesCompletedEventData eventData,
+        int result,
+        CancellationToken cancellationToken = new CancellationToken())
+    {
+        using (var auditContext = new AuditContext(_connectionString))
+        {
+            auditContext.Attach(_audit);
+            _audit.Succeeded = true;
+            _audit.EndTime = DateTime.UtcNow;
+
+            await auditContext.SaveChangesAsync(cancellationToken);
+        }
+
+        return result;
+    }
+-->
+[!code-csharp[SavedChanges](../../../samples/core/Miscellaneous/SaveChangesInterception/AuditingInterceptor.cs?name=SavedChanges)]
+
+The audit entity is attached to the audit context, since it already exists in the database and needs to be updated. We then set `Succeeded` and `EndTime`, which marks these properties as modified so SaveChanges will send an update to the audit database.
+
+#### Detecting failure
+
+Failure is handled in much the same way as success, but in the <xref:Microsoft.EntityFrameworkCore.Diagnostics.ISaveChangesInterceptor.SaveChangesFailed*?displayProperty=nameWithType> or <xref:Microsoft.EntityFrameworkCore.Diagnostics.ISaveChangesInterceptor.SaveChangesFailedAsync*?displayProperty=nameWithType> method. The event data contains the exception that was thrown.
+
+<!--
+    public void SaveChangesFailed(DbContextErrorEventData eventData)
+    {
+        using (var auditContext = new AuditContext(_connectionString))
+        {
+            auditContext.Attach(_audit);
+            _audit.Succeeded = false;
+            _audit.EndTime = DateTime.UtcNow;
+            _audit.ErrorMessage = eventData.Exception.Message;
+
+            auditContext.SaveChanges();
+        }
+    }
+
+    public async Task SaveChangesFailedAsync(
+        DbContextErrorEventData eventData,
+        CancellationToken cancellationToken = new CancellationToken())
+    {
+        using (var auditContext = new AuditContext(_connectionString))
+        {
+            auditContext.Attach(_audit);
+            _audit.Succeeded = false;
+            _audit.EndTime = DateTime.UtcNow;
+            _audit.ErrorMessage = eventData.Exception.InnerException?.Message;
+
+            await auditContext.SaveChangesAsync(cancellationToken);
+        }
+    }
+-->
+[!code-csharp[SaveChangesFailed](../../../samples/core/Miscellaneous/SaveChangesInterception/AuditingInterceptor.cs?name=SaveChangesFailed)]
+
+#### Demonstration
+
+The [auditing sample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/SaveChangesInterception) contains a simple console application that makes changes to the blogging database and then shows the auditing that was created.
+
+<!--
+        // Insert, update, and delete some entities
+
+        using (var context = new BlogsContext())
+        {
+            context.Add(
+                new Blog
+                {
+                    Name = "EF Blog",
+                    Posts =
+                    {
+                        new Post { Title = "EF Core 3.1!" },
+                        new Post { Title = "EF Core 5.0!" }
+                    }
+                });
+
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new BlogsContext())
+        {
+            var blog = context.Blogs.Include(e => e.Posts).Single();
+
+            blog.Name = "EF Core Blog";
+            context.Remove(blog.Posts.First());
+            blog.Posts.Add(new Post { Title = "EF Core 6.0!" });
+
+            context.SaveChanges();
+        }
+
+        // Do an insert that will fail
+
+        using (var context = new BlogsContext())
+        {
+            try
+            {
+                context.Add(new Post { Id = 3, Title = "EF Core 3.1!" });
+
+                await context.SaveChangesAsync();
+            }
+            catch (DbUpdateException)
+            {
+            }
+        }
+
+        // Look at the audit trail
+
+        using (var context = new AuditContext("DataSource=audit.db"))
+        {
+            foreach (var audit in context.SaveChangesAudits.Include(e => e.Entities).ToList())
+            {
+                Console.WriteLine(
+                    $"Audit {audit.AuditId} from {audit.StartTime} to {audit.EndTime} was{(audit.Succeeded ? "" : " not")} successful.");
+
+                foreach (var entity in audit.Entities)
+                {
+                    Console.WriteLine($"  {entity.AuditMessage}");
+                }
+
+                if (!audit.Succeeded)
+                {
+                    Console.WriteLine($"  Error: {audit.ErrorMessage}");
+                }
+            }
+        }
+-->
+[!code-csharp[Program](../../../samples/core/Miscellaneous/SaveChangesInterception/Program.cs?name=Program)]
+
+The result shows the contents of the auditing database:
+
+```output
+Audit 52e94327-1767-4046-a3ca-4c6b1eecbca6 from 10/14/2020 9:10:17 PM to 10/14/2020 9:10:17 PM was successful.
+  Inserting Blog with Id: '-2147482647' Name: 'EF Blog'
+  Inserting Post with Id: '-2147482647' BlogId: '-2147482647' Title: 'EF Core 3.1!'
+  Inserting Post with Id: '-2147482646' BlogId: '-2147482647' Title: 'EF Core 5.0!'
+Audit 8450f57a-5030-4211-a534-eb66b8da7040 from 10/14/2020 9:10:17 PM to 10/14/2020 9:10:17 PM was successful.
+  Inserting Post with Id: '-2147482645' BlogId: '1' Title: 'EF Core 6.0!'
+  Updating Blog with Id: '1' Name: 'EF Core Blog'
+  Deleting Post with Id: '1'
+Audit 201fef4d-66a7-43ad-b9b6-b57e9d3f37b3 from 10/14/2020 9:10:17 PM to 10/14/2020 9:10:17 PM was not successful.
+  Inserting Post with Id: '3' BlogId: '' Title: 'EF Core 3.1!'
+  Error: SQLite Error 19: 'UNIQUE constraint failed: Post.Id'.
+```
+
+### Example: Optimistic concurrency interception
+
+EF Core supports the [optimistic concurrency pattern](xref:core/saving/concurrency) by checking that the number of rows actually affected by an update or delete is the same as the number of rows expected to be affected. This is often coupled with a concurrency token; that is, a column value that will only match its expected value if the row has not been updated since the expected value was read.
+
+EF signals a violation of optimistic concurrency by throwing a <xref:Microsoft.EntityFrameworkCore.DbUpdateConcurrencyException>. <xref:Microsoft.EntityFrameworkCore.Diagnostics.ISaveChangesInterceptor> has methods `ThrowingConcurrencyException` and `ThrowingConcurrencyExceptionAsync` that are called before the `DbUpdateConcurrencyException` is thrown. These interception points allow the exception to be suppressed, possibly coupled with async database changes to resolve the violation.
+
+For example, if two requests attempt to delete the same entity at almost the same time, then the second delete may fail because the row in the database no longer exists. This may be fine--the end result is that the entity has been deleted anyway. The following interceptor demonstrates how this can be done:
+
+```csharp
+public class SuppressDeleteConcurrencyInterceptor : ISaveChangesInterceptor
+{
+    public InterceptionResult ThrowingConcurrencyException(
+        ConcurrencyExceptionEventData eventData,
+        InterceptionResult result)
+    {
+        if (eventData.Entries.All(e => e.State == EntityState.Deleted))
+        {
+            Console.WriteLine("Suppressing Concurrency violation for command:");
+            Console.WriteLine(((RelationalConcurrencyExceptionEventData)eventData).Command.CommandText);
+
+            return InterceptionResult.Suppress();
+        }
+
+        return result;
+    }
+
+    public ValueTask<InterceptionResult> ThrowingConcurrencyExceptionAsync(
+        ConcurrencyExceptionEventData eventData,
+        InterceptionResult result,
+        CancellationToken cancellationToken = default)
+        => new(ThrowingConcurrencyException(eventData, result));
+}
+```
+
+There are several things worth noting about this interceptor:
+
+* Both the synchronous and asynchronous interception methods are implemented. This is important if the application may call either `SaveChanges` or `SaveChangesAsync`. However, if all application code is async, then only `ThrowingConcurrencyExceptionAsync` needs to be implemented. Likewise, if the application never uses asynchronous database methods, then only `ThrowingConcurrencyException` needs to be implemented. This is generally true for all interceptors with sync and async methods.
+* The interceptor has access to <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry> objects for the entities being saved. In this case, this is used to check whether or not the concurrency violation is happening for a delete operation.
+* If the application is using a relational database provider, then the <xref:Microsoft.EntityFrameworkCore.Diagnostics.ConcurrencyExceptionEventData> object can be cast to a <xref:Microsoft.EntityFrameworkCore.Diagnostics.RelationalConcurrencyExceptionEventData> object. This provides additional, relational-specific information about the database operation being performed. In this case, the relational command text is printed to the console.
+* Returning `InterceptionResult.Suppress()` tells EF Core to suppress the action it was about to take--in this case, throwing the `DbUpdateConcurrencyException`. This ability to _change the behavior of EF Core_, rather than just observing what EF Core is doing, is one of the most powerful features of interceptors.
+
+## Materialization interception
+
+<xref:Microsoft.EntityFrameworkCore.Diagnostics.IMaterializationInterceptor> supports interception before and after an entity instance is created, and before and after properties of that instance are initialized. The interceptor can change or replace the entity instance at each point. This allows:
+
+* Setting unmapped properties or calling methods needed for validation, computed values, or flags.
+* Using a factory to create instances.
+* Creating a different entity instance than EF would normally create, such as an instance from a cache, or of a proxy type.
+* Injecting services into an entity instance.
+
+> [!NOTE]
+> `IMaterializationInterceptor` is a singleton interceptor, meaning a single instance is shared between all `DbContext` instances.
+
+### Example: Simple actions on entity creation
+
+Imagine that we want to keep track of the time that an entity was retrieved from the database, perhaps so it can be displayed to a user editing the data. To accomplish this, we first define an interface:
+
+```csharp
+public interface IHasRetrieved
+{
+    DateTime Retrieved { get; set; }
+}
+```
+
+Using an interface is common with interceptors since it allows the same interceptor to work with many different entity types. For example:
+
+```csharp
+public class Customer : IHasRetrieved
+{
+    public int Id { get; set; }
+    public string Name { get; set; } = null!;
+    public string? PhoneNumber { get; set; }
+
+    [NotMapped]
+    public DateTime Retrieved { get; set; }
+}
+```
+
+Notice that the `[NotMapped]` attribute is used to indicate that this property is used only while working with the entity, and should not be persisted to the database.
+
+The interceptor must then implement the appropriate method from `IMaterializationInterceptor` and set the time retrieved:
+
+```csharp
+public class SetRetrievedInterceptor : IMaterializationInterceptor
+{
+    public object InitializedInstance(MaterializationInterceptionData materializationData, object instance)
+    {
+        if (instance is IHasRetrieved hasRetrieved)
+        {
+            hasRetrieved.Retrieved = DateTime.UtcNow;
+        }
+        
+        return instance;
+    }
+}
+```
+
+An instance of this interceptor is registered when configuring the `DbContext`:
+
+```csharp
+public class CustomerContext : DbContext
+{
+    private static readonly SetRetrievedInterceptor _setRetrievedInterceptor = new();
+    
+    public DbSet<Customer> Customers => Set<Customer>();
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder) 
+        => optionsBuilder
+            .AddInterceptors(_setRetrievedInterceptor)
+            .UseSqlite("Data Source = customers.db");
+}
+```
+
+> [!TIP]
+> This interceptor is stateless, which is common, so a single instance is created and shared between all `DbContext` instances.
+
+Now, whenever a `Customer` is queried from the database, the `Retrieved` property will be set automatically. For example:
+
+```csharp
+await using (var context = new CustomerContext())
+{
+    var customer = await context.Customers.SingleAsync(e => e.Name == "Alice");
+    Console.WriteLine($"Customer '{customer.Name}' was retrieved at '{customer.Retrieved.ToLocalTime()}'");
+}
+```
+
+Produces output:
+
+```output
+Customer 'Alice' was retrieved at '9/22/2022 5:25:54 PM'
+```
+
+### Example: Injecting services into entities
+
+EF Core already has built-in support for injecting some special services into context instances; for example, see [Lazy loading without proxies](xref:core/querying/related-data/lazy#lazy-loading-without-proxies), which works by injecting the `ILazyLoader` service.
+
+An `IMaterializationInterceptor` can be used to generalize this to any service. The following example shows how to inject an <xref:Microsoft.Extensions.Logging.ILogger> into entities such that they can perform their own logging.
+
+> [!NOTE]
+> Injecting services into entities couples those entity types to the injected services, which some people consider to be an anti-pattern.
+
+As before, an interface is used to define what can be done.
+
+```csharp
+public interface IHasLogger
+{
+    ILogger? Logger { get; set; }
+}
+```
+
+And entity types that will log must implement this interface. For example:
+
+```csharp
+public class Customer : IHasLogger
+{
+    private string? _phoneNumber;
+
+    public int Id { get; set; }
+    public string Name { get; set; } = null!;
+
+    public string? PhoneNumber
+    {
+        get => _phoneNumber;
+        set
+        {
+            Logger?.LogInformation(1, $"Updating phone number for '{Name}' from '{_phoneNumber}' to '{value}'.");
+
+            _phoneNumber = value;
+        }
+    }
+
+    [NotMapped]
+    public ILogger? Logger { get; set; }
+}
+```
+
+This time, the interceptor must implement `IMaterializationInterceptor.InitializedInstance`, which is called after every entity instance has been created and its property values have been initialized. The interceptor obtains an `ILogger` from the context and initializes `IHasLogger.Logger` with it:
+
+```csharp
+public class LoggerInjectionInterceptor : IMaterializationInterceptor
+{
+    private ILogger? _logger;
+
+    public object InitializedInstance(MaterializationInterceptionData materializationData, object instance)
+    {
+        if (instance is IHasLogger hasLogger)
+        {
+            _logger ??= materializationData.Context.GetService<ILoggerFactory>().CreateLogger("CustomersLogger");
+            hasLogger.Logger = _logger;
+        }
+
+        return instance;
+    }
+}
+```
+
+This time a new instance of the interceptor is used for each `DbContext` instance, since the `ILogger` obtained can change per `DbContext` instance, and the `ILogger` is cached on the interceptor:
+
+```csharp
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    => optionsBuilder.AddInterceptors(new LoggerInjectionInterceptor());
+```
+
+Now, whenever the `Customer.PhoneNumber` is changed, this change will be logged to the application's log. For example:
+
+```output
+info: CustomersLogger[1]
+      Updating phone number for 'Alice' from '+1 515 555 0123' to '+1 515 555 0125'.
+```
+
+## Query expression interception
+
+<xref:Microsoft.EntityFrameworkCore.Diagnostics.IQueryExpressionInterceptor> allows interception of the [LINQ expression tree](xref:core/querying/how-query-works) for a query before it is compiled. This can be used to dynamically modify queries in ways that apply across the application.
+
+> [!NOTE]
+> `IQueryExpressionInterceptor` is a singleton interceptor, meaning a single instance is typically shared between all `DbContext` instances.
+
+> [!WARNING]
+> Interceptors are powerful, but it's easy to get things wrong when working with expression trees. Always consider if there is an easier way of achieving what you want, such as modifying the query directly.
+
+### Example: Inject ordering into queries for stable sorting
+
+Consider a method that returns a page of customers:
+
+```csharp
+Task<List<Customer>> GetPageOfCustomers(string sortProperty, int page)
+{
+    using var context = new CustomerContext();
+
+    return context.Customers
+        .OrderBy(e => EF.Property<object>(e, sortProperty))
+        .Skip(page * 20).Take(20).ToListAsync();
+}
+```
+
+> [!TIP]
+> This query uses the <xref:Microsoft.EntityFrameworkCore.EF.Property*?displayProperty=nameWithType> method to specify the property to sort by. This allows the application to dynamically pass in the property name, allowing sorting by any property of the entity type. Be aware that sorting by non-indexed columns can be slow.
+
+This will work fine as long as the property used for sorting always returns a stable ordering. But this may not always be the case. For example, the LINQ query above generates the following on SQLite when ordering by `Customer.City`:
+
+```sql
+SELECT "c"."Id", "c"."City", "c"."Name", "c"."PhoneNumber"
+FROM "Customers" AS "c"
+ORDER BY "c"."City"
+LIMIT @__p_1 OFFSET @__p_0
+```
+
+If there are multiple customers with the same `City`, then the ordering of this query is not stable. This could lead to missing or duplicate results as the user pages through the data.
+
+A common way to fix this problem is to perform a secondary sorting by primary key. However, rather than manually adding this to every query, an interceptor can add the secondary ordering dynamically. To facilitate this, we define an interface for any entity that has an integer primary key:
+
+```csharp
+public interface IHasIntKey
+{
+    int Id { get; }
+}
+```
+
+This interface is implemented by the entity types of interest:
+
+```csharp
+public class Customer : IHasIntKey
+{
+    public int Id { get; set; }
+    public string Name { get; set; } = null!;
+    public string? City { get; set; }
+    public string? PhoneNumber { get; set; }
+}
+```
+
+We then need an interceptor that implements <xref:Microsoft.EntityFrameworkCore.Diagnostics.IQueryExpressionInterceptor>:
+
+```csharp
+public class KeyOrderingExpressionInterceptor : IQueryExpressionInterceptor
+{
+    public Expression QueryCompilationStarting(Expression queryExpression, QueryExpressionEventData eventData)
+        => new KeyOrderingExpressionVisitor().Visit(queryExpression);
+
+    private class KeyOrderingExpressionVisitor : ExpressionVisitor
+    {
+        private static readonly MethodInfo ThenByMethod
+            = typeof(Queryable).GetMethods()
+                .Single(m => m.Name == nameof(Queryable.ThenBy) && m.GetParameters().Length == 2);
+
+        protected override Expression VisitMethodCall(MethodCallExpression? methodCallExpression)
+        {
+            var methodInfo = methodCallExpression!.Method;
+            if (methodInfo.DeclaringType == typeof(Queryable)
+                && methodInfo.Name == nameof(Queryable.OrderBy)
+                && methodInfo.GetParameters().Length == 2)
+            {
+                var sourceType = methodCallExpression.Type.GetGenericArguments()[0];
+                if (typeof(IHasIntKey).IsAssignableFrom(sourceType))
+                {
+                    var lambdaExpression = (LambdaExpression)((UnaryExpression)methodCallExpression.Arguments[1]).Operand;
+                    var entityParameterExpression = lambdaExpression.Parameters[0];
+
+                    return Expression.Call(
+                        ThenByMethod.MakeGenericMethod(
+                            sourceType,
+                            typeof(int)),
+                        methodCallExpression,
+                        Expression.Lambda(
+                            typeof(Func<,>).MakeGenericType(entityParameterExpression.Type, typeof(int)),
+                            Expression.Property(entityParameterExpression, nameof(IHasIntKey.Id)),
+                            entityParameterExpression));
+                }
+            }
+
+            return base.VisitMethodCall(methodCallExpression);
+        }
+    }
+}
+```
+
+This probably looks pretty complicated--and it is! Working with expression trees is typically not easy. Let's look at what's happening:
+
+* Fundamentally, the interceptor encapsulates an <xref:System.Linq.Expressions.ExpressionVisitor>. The visitor overrides <xref:System.Linq.Expressions.ExpressionVisitor.VisitMethodCall*>, which will be called whenever there is a call to a method in the query expression tree.
+
+* The visitor checks whether or not this is a call to the <xref:System.Linq.Queryable.OrderBy*> method we are interested in.
+* If it is, then the visitor further checks if the generic method call is for a type that implements our `IHasIntKey` interface.
+* At this point we know that the method call is of the form `OrderBy(e => ...)`. We extract the lambda expression from this call and get the parameter used in that expression--that is, the `e`.
+* We now build a new <xref:System.Linq.Expressions.MethodCallExpression> using the <xref:System.Linq.Expressions.Expression.Call*?displayProperty=nameWithType> builder method. In this case, the method being called is `ThenBy(e => e.Id)`. We build this using the parameter extracted above and a property access to the `Id` property of the `IHasIntKey` interface.
+* The input into this call is the original `OrderBy(e => ...)`, and so the end result is an expression for `OrderBy(e => ...).ThenBy(e => e.Id)`.
+* This modified expression is returned from the visitor, which means the LINQ query has now been appropriately modified to include a `ThenBy` call.
+* EF Core continues and compiles this query expression into the appropriate SQL for the database being used.
+
+Registering this interceptor and executing `GetPageOfCustomers` now generates the following SQL:
+
+```sql
+SELECT "c"."Id", "c"."City", "c"."Name", "c"."PhoneNumber"
+FROM "Customers" AS "c"
+ORDER BY "c"."City", "c"."Id"
+LIMIT @__p_1 OFFSET @__p_0
+```
+
+This will now always produce a stable ordering, even if there are multiple customers with the same `City`.
+
+In many cases, the same thing can be achieved more simply by modifying the query directly. For example:
+
+```csharp
+Task<List<Customer>> GetPageOfCustomers2(string sortProperty, int page)
+{
+    using var context = new CustomerContext();
+
+    return context.Customers
+        .OrderBy(e => EF.Property<object>(e, sortProperty))
+        .ThenBy(e => e.Id)
+        .Skip(page * 20).Take(20).ToListAsync();
+}
+```
+
+In this case the `ThenBy` is simply added to the query. Yes, it may need to be done separately to every query, but it's simple, easy to understand, and will always work.
+
+## Identity resolution interception
+
+<xref:Microsoft.EntityFrameworkCore.Diagnostics.IIdentityResolutionInterceptor> allows interception of identity resolution conflicts when the <xref:Microsoft.EntityFrameworkCore.DbContext> starts tracking new entity instances.
+
+> [!NOTE]
+> This interceptor is currently only called when `DbContext.Update`, `DbContext.Attach`, and similar methods are used to track entities that are already being tracked with the same key. It is not called for entities returned from queries. This may change in a future release; [see this issue](https://github.com/dotnet/efcore/issues/37574).
+
+A `DbContext` can only track one entity instance with any given primary key value. This means multiple instances of an entity with the same key value must be resolved to a single instance. An interceptor of this type is called with the existing tracked instance and the new instance and must apply any property values and relationship changes from the new instance into the existing instance. The new instance is then discarded.
+
+EF Core provides a built-in implementation, <xref:Microsoft.EntityFrameworkCore.Diagnostics.UpdatingIdentityResolutionInterceptor>, which updates the existing tracked entity with values from the new instance. This can be registered when configuring the context:
+
+```csharp
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    => optionsBuilder
+        .AddInterceptors(new UpdatingIdentityResolutionInterceptor());
+```
+
+To implement custom identity resolution logic, create a class that implements `IIdentityResolutionInterceptor` and override the `UpdateTrackedInstance` method:
+
+```csharp
+public class CustomIdentityResolutionInterceptor : IIdentityResolutionInterceptor
+{
+    public void UpdateTrackedInstance(
+        IdentityResolutionInterceptionData interceptionData,
+        EntityEntry existingEntry,
+        object newEntity)
+    {
+        // Custom logic to merge property values from newEntity into the existing tracked entity
+        existingEntry.CurrentValues.SetValues(newEntity);
+    }
+}
+```
diff --git a/entity-framework/core/logging-events-diagnostics/metrics.md b/entity-framework/core/logging-events-diagnostics/metrics.md
new file mode 100644
index 0000000000..4434dfede3
--- /dev/null
+++ b/entity-framework/core/logging-events-diagnostics/metrics.md
@@ -0,0 +1,156 @@
+---
+title: Metrics - EF Core
+description: Tracking EF Core performance and diagnosing anomalies with .NET metrics
+author: cincuranet
+ms.date: 06/11/2024
+uid: core/logging-events-diagnostics/metrics
+---
+
+# Metrics in EF Core
+
+Entity Framework Core (EF Core) exposes continuous numeric metrics which can provide a good indication of your program's health. These metrics can be used for the following purposes:
+
+* Track general database load in realtime as the application is running
+* Expose problematic coding practices which can lead to degraded performance
+* Track down and isolate anomalous program behavior
+
+## Metrics
+
+EF Core reports metrics via the standard <xref:System.Diagnostics.Metrics?displayProperty=nameWithType> API. `Microsoft.EntityFrameworkCore` is the name of the meter. It's recommended to read [.NET documentation on metrics](/dotnet/core/diagnostics/metrics).
+
+> [!NOTE]
+> This feature was introduced in EF Core 9.0. [See event counters below](#event-counters-legacy) for older versions of EF Core.
+
+### Metrics and their meaning
+
+* [`microsoft.entityframeworkcore.active_dbcontexts`](#metric-microsoftentityframeworkcoreactive_dbcontexts)
+* [`microsoft.entityframeworkcore.queries`](#metric-microsoftentityframeworkcorequeries)
+* [`microsoft.entityframeworkcore.savechanges`](#metric-microsoftentityframeworkcoresavechanges)
+* [`microsoft.entityframeworkcore.compiled_query_cache_hits`](#metric-microsoftentityframeworkcorecompiled_query_cache_hits)
+* [`microsoft.entityframeworkcore.compiled_query_cache_misses`](#metric-microsoftentityframeworkcorecompiled_query_cache_misses)
+* [`microsoft.entityframeworkcore.execution_strategy_operation_failures`](#metric-microsoftentityframeworkcoreexecution_strategy_operation_failures)
+* [`microsoft.entityframeworkcore.optimistic_concurrency_failures`](#metric-microsoftentityframeworkcoreoptimistic_concurrency_failures)
+
+#### Metric: `microsoft.entityframeworkcore.active_dbcontexts`
+
+| Name     | Instrument Type | Unit (UCUM) | Description    |
+| -------- | --------------- | ----------- | -------------- |
+| `microsoft.entityframeworkcore.active_dbcontexts` | ObservableUpDownCounter | `{dbcontext}` | Number of currently active `DbContext` instances. |
+
+Available starting in: Entity Framework Core 9.0.
+
+#### Metric: `microsoft.entityframeworkcore.queries`
+
+| Name     | Instrument Type | Unit (UCUM) | Description    |
+| -------- | --------------- | ----------- | -------------- |
+| `microsoft.entityframeworkcore.queries` | ObservableCounter | `{query}` | Cumulative count of queries executed. |
+
+Available starting in: Entity Framework Core 9.0.
+
+#### Metric: `microsoft.entityframeworkcore.savechanges`
+
+| Name     | Instrument Type | Unit (UCUM) | Description    |
+| -------- | --------------- | ----------- | -------------- |
+| `microsoft.entityframeworkcore.savechanges` | ObservableCounter | `{savechanges}` | Cumulative count of changes saved. |
+
+Available starting in: Entity Framework Core 9.0.
+
+#### Metric: `microsoft.entityframeworkcore.compiled_query_cache_hits`
+
+| Name     | Instrument Type | Unit (UCUM) | Description    |
+| -------- | --------------- | ----------- | -------------- |
+| `microsoft.entityframeworkcore.compiled_query_cache_hits` | ObservableCounter | `{hits}` | Cumulative count of hits for the compiled query cache. |
+
+Available starting in: Entity Framework Core 9.0.
+
+#### Metric: `microsoft.entityframeworkcore.compiled_query_cache_misses`
+
+| Name     | Instrument Type | Unit (UCUM) | Description    |
+| -------- | --------------- | ----------- | -------------- |
+| `microsoft.entityframeworkcore.compiled_query_cache_misses` | ObservableCounter | `{misses}` | Cumulative count of misses for the compiled query cache. |
+
+Available starting in: Entity Framework Core 9.0.
+
+#### Metric: `microsoft.entityframeworkcore.execution_strategy_operation_failures`
+
+| Name     | Instrument Type | Unit (UCUM) | Description    |
+| -------- | --------------- | ----------- | -------------- |
+| `microsoft.entityframeworkcore.execution_strategy_operation_failures` | ObservableCounter | `{failure}` | Cumulative number of failed operation executed by an `IExecutionStrategy`. |
+
+Available starting in: Entity Framework Core 9.0.
+
+#### Metric: `microsoft.entityframeworkcore.optimistic_concurrency_failures`
+
+| Name     | Instrument Type | Unit (UCUM) | Description    |
+| -------- | --------------- | ----------- | -------------- |
+| `microsoft.entityframeworkcore.optimistic_concurrency_failures` | ObservableCounter | `{failure}` | Cumulative number of optimistic concurrency failures. |
+
+Available starting in: Entity Framework Core 9.0.
+
+## Event Counters (legacy)
+
+EF Core reports metrics via the standard .NET event counters feature; it's recommended to read [this blog post](https://devblogs.microsoft.com/dotnet/introducing-diagnostics-improvements-in-net-core-3-0/) for a quick overview of how counters work.
+
+### Attach to a process using dotnet-counters
+
+The [dotnet-counters tool](/dotnet/core/diagnostics/dotnet-counters) can be used to attach to a running process and report EF Core event counters regularly; nothing special needs to be done in the program for these counters to be available.
+
+First, install the `dotnet-counters` tool: `dotnet tool install --global dotnet-counters`.
+
+Next, find the process ID (PID) of the .NET process running your EF Core application:
+
+#### [Windows](#tab/windows)
+
+1. Open the Windows Task Manager by right-clicking on the task bar and selecting "Task Manager".
+2. Make sure that the "More details" option is selected at the bottom of the window.
+3. In the Processes tab, right-click a column and make sure that the PID column is enabled.
+4. Locate your application in the process list, and get its process ID from the PID column.
+
+#### [Linux or macOS](#tab/fluent-api)
+
+1. Use the `ps` command to list all processes running for your user.
+2. Locate your application in the process list, and get its process ID from the PID column.
+
+***
+
+Inside your .NET application, the process ID is available as `Process.GetCurrentProcess().Id`; this can be useful for printing the PID upon startup.
+
+Finally, launch `dotnet-counters` as follows:
+
+```console
+dotnet counters monitor --counters Microsoft.EntityFrameworkCore -p <PID>
+```
+
+`dotnet-counters` will now attach to your running process and start reporting continuous counter data:
+
+```console
+Press p to pause, r to resume, q to quit.
+ Status: Running
+
+[Microsoft.EntityFrameworkCore]
+    Active DbContexts                                               1
+    Execution Strategy Operation Failures (Count / 1 sec)           0
+    Execution Strategy Operation Failures (Total)                   0
+    Optimistic Concurrency Failures (Count / 1 sec)                 0
+    Optimistic Concurrency Failures (Total)                         0
+    Queries (Count / 1 sec)                                         1
+    Queries (Total)                                               189
+    Query Cache Hit Rate (%)                                      100
+    SaveChanges (Count / 1 sec)                                     0
+    SaveChanges (Total)                                             0
+```
+
+### Counters and their meaning
+
+Counter name                                                                      | Description
+--------------------------------------------------------------------------------  | ----
+Active DbContexts <br /> (`active-db-contexts`)                                          | The number of active, undisposed DbContext instances currently in your application. If this number grows continuously, you may have a leak because DbContext instances aren't being properly disposed. Note that if [context pooling](xref:core/performance/advanced-performance-topics#dbcontext-pooling) is enabled, this number includes pooled DbContext instances not currently in use.
+Execution Strategy Operation Failures <br /> (`total-execution-strategy-operation-failures` and  `execution-strategy-operation-failures-per-second`) | The number of times a database operation failed to execute. If a retrying execution strategy is enabled, this includes each individual failure within multiple attempts on the same operation. This can be used to detect transient issues with your infrastructure.
+Optimistic Concurrency Failures <br /> (`total-optimistic-concurrency-failures` and `optimistic-concurrency-failures-per-second`) | The number of times `SaveChanges` failed because of an optimistic concurrency error, because data in the data store was changed since your code loaded it. This corresponds to a <xref:Microsoft.EntityFrameworkCore.DbUpdateConcurrencyException> being thrown.
+Queries <br /> (`total-queries` and `queries-per-second`)                                | The number of queries executed.
+Query Cache Hit Rate (%) <br /> (`compiled-query-cache-hit-rate`)                        | The ratio of query cache hits to misses. The first time a given LINQ query is executed by EF Core (excluding parameters), it must be compiled in what is a relatively heavy process. In a normal application, all queries are reused, and the query cache hit rate should be stable at 100% after an initial warmup period. If this number is less than 100% over time, you may experience degraded perf due to repeated compilations, which could be a result of suboptimal dynamic query generation.
+SaveChanges <br />(`total-save-changes` and `save-changes-per-second`)                                                                       | The number of times `SaveChanges` has been called. Note that `SaveChanges` saves multiple changes in a single batch, so this doesn't necessarily represent each individual update done on a single entity.
+
+### Additional resources
+
+* [.NET documentation on event counters](/dotnet/core/diagnostics/event-counters)
diff --git a/entity-framework/core/logging-events-diagnostics/simple-logging.md b/entity-framework/core/logging-events-diagnostics/simple-logging.md
new file mode 100644
index 0000000000..cafb1cdb9a
--- /dev/null
+++ b/entity-framework/core/logging-events-diagnostics/simple-logging.md
@@ -0,0 +1,347 @@
+---
+title: Simple logging - EF Core
+description: Logging from an EF Core DbContext using LogTo
+author: SamMonoRT
+ms.date: 10/03/2020
+uid: core/logging-events-diagnostics/simple-logging
+---
+
+# Simple Logging
+
+> [!TIP]
+> You can [download this article's sample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/Logging/SimpleLogging) from GitHub.
+
+Entity Framework Core (EF Core) simple logging can be used to easily obtain logs while developing and debugging applications. This form of logging requires minimal configuration and no additional NuGet packages.
+
+> [!TIP]
+> EF Core also integrates with [Microsoft.Extensions.Logging](xref:core/logging-events-diagnostics/extensions-logging), which requires more configuration, but is often more suitable for logging in production applications.
+
+## Configuration
+
+EF Core logs can be accessed from any type of application through the use of <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.LogTo*> when [configuring a DbContext instance](xref:core/dbcontext-configuration/index). This configuration is commonly done in an override of <xref:Microsoft.EntityFrameworkCore.DbContext.OnConfiguring*?displayProperty=nameWithType>. For example:
+
+<!--
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.LogTo(Console.WriteLine);
+-->
+[!code-csharp[LogToConsole](../../../samples/core/Miscellaneous/Logging/SimpleLogging/Program.cs?name=LogToConsole)]
+
+Alternately, `LogTo` can be called as part of <xref:Microsoft.Extensions.DependencyInjection.EntityFrameworkServiceCollectionExtensions.AddDbContext*> or when creating a <xref:Microsoft.EntityFrameworkCore.DbContextOptions> instance to pass to the `DbContext` constructor.
+
+> [!TIP]
+> OnConfiguring is still called when AddDbContext is used or a DbContextOptions instance is passed to the DbContext constructor. This makes it the ideal place to apply context configuration regardless of how the DbContext is constructed.
+
+## Directing the logs
+
+### Logging to the console
+
+`LogTo` requires an <xref:System.Action`1> delegate that accepts a string. EF Core will call this delegate with a string for each log message generated. It is then up to the delegate to do something with the given message.
+
+The <xref:System.Console.WriteLine*?displayProperty=nameWithType> method is often used for this delegate, as shown above. This results in each log message being written to the console.
+
+### Logging to the debug window
+
+<xref:System.Diagnostics.Debug.WriteLine*?displayProperty=nameWithType> can be used to send output to the Debug window in Visual Studio or other IDEs. [Lambda syntax](/dotnet/csharp/language-reference/operators/lambda-expressions) must be used in this case because the `Debug` class is compiled out of release builds. For example:
+
+<!--
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.LogTo(message => Debug.WriteLine(message));
+-->
+[!code-csharp[LogToDebug](../../../samples/core/Miscellaneous/Logging/SimpleLogging/Program.cs?name=LogToDebug)]
+
+### Logging to a file
+
+Writing to a file requires creating a <xref:System.IO.StreamWriter> or similar for the file. The <xref:System.IO.StreamWriter.WriteLine*> method can then be used as in the other examples above. Remember to ensure the file is closed cleanly by disposing the writer when the context is disposed. For example:
+
+<!--
+    private readonly StreamWriter _logStream = new StreamWriter("mylog.txt", append: true);
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.LogTo(_logStream.WriteLine);
+
+    public override void Dispose()
+    {
+        base.Dispose();
+        _logStream.Dispose();
+    }
+
+    public override async ValueTask DisposeAsync()
+    {
+        await base.DisposeAsync();
+        await _logStream.DisposeAsync();
+    }
+-->
+[!code-csharp[LogToFile](../../../samples/core/Miscellaneous/Logging/SimpleLogging/Program.cs?name=LogToFile)]
+
+> [!TIP]
+> Consider using [Microsoft.Extensions.Logging](/aspnet/core/fundamentals/logging) for logging to files in production applications.
+
+## Getting detailed messages
+
+### Sensitive data
+
+By default, EF Core will not include the values of any data in exception messages. This is because such data may be confidential, and could be revealed in production use if an exception is not handled.
+
+However, knowing data values, especially for keys, can be very helpful when debugging. This can be enabled in EF Core by calling <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.EnableSensitiveDataLogging>. For example:
+
+<!--
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .LogTo(Console.WriteLine)
+            .EnableSensitiveDataLogging();
+-->
+[!code-csharp[SensitiveDataLogging](../../../samples/core/Miscellaneous/Logging/SimpleLogging/Program.cs?name=SensitiveDataLogging)]
+
+### Detailed query exceptions
+
+For performance reasons, EF Core does not wrap each call to read a value from the database provider in a try-catch block. However, this sometimes results in exceptions that are hard to diagnose, especially when the database returns a NULL when not allowed by the model.
+
+Turning on <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.EnableDetailedErrors*> will cause EF to introduce these try-catch blocks and thereby provide more detailed errors. For example:
+
+<!--
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .LogTo(Console.WriteLine)
+            .EnableDetailedErrors();
+-->
+[!code-csharp[EnableDetailedErrors](../../../samples/core/Miscellaneous/Logging/SimpleLogging/Program.cs?name=EnableDetailedErrors)]
+
+## Filtering
+
+### Log levels
+
+Every EF Core log message is assigned to a level defined by the <xref:Microsoft.Extensions.Logging.LogLevel> enum. By default, EF Core simple logging includes every message at `Debug` level or above. `LogTo` can be passed a higher minimum level to filter out some messages. For example, passing `Information` results in a minimal set of logs limited to database access and some housekeeping messages.
+
+<!--
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.LogTo(Console.WriteLine, LogLevel.Information);
+-->
+[!code-csharp[InfoOnly](../../../samples/core/Miscellaneous/Logging/SimpleLogging/Program.cs?name=InfoOnly)]
+
+### Specific messages
+
+Every log message is assigned an <xref:Microsoft.Extensions.Logging.EventId>. These IDs can be accessed from the <xref:Microsoft.EntityFrameworkCore.Diagnostics.CoreEventId> class or the <xref:Microsoft.EntityFrameworkCore.Diagnostics.RelationalEventId> class for relational-specific messages. A database provider may also have provider-specific IDs in a similar class. For example, <xref:Microsoft.EntityFrameworkCore.Diagnostics.SqlServerEventId> for the SQL Server provider.
+
+`LogTo` can be configured to only log the messages associated with one or more event IDs. For example, to log only messages for the context being initialized or disposed:
+
+<!--
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .LogTo(Console.WriteLine, new[] { CoreEventId.ContextDisposed, CoreEventId.ContextInitialized });
+-->
+[!code-csharp[EventIds](../../../samples/core/Miscellaneous/Logging/SimpleLogging/Program.cs?name=EventIds)]
+
+### Message categories
+
+Every log message is assigned to a named hierarchical logger category. The categories are:
+
+| Category                                             | Messages
+|:-----------------------------------------------------|-------------------------------------------------
+| Microsoft.EntityFrameworkCore                        | All EF Core messages
+| Microsoft.EntityFrameworkCore.Database               | All database interactions
+| Microsoft.EntityFrameworkCore.Database.Connection    | Uses of a database connection
+| Microsoft.EntityFrameworkCore.Database.Command       | Uses of a database command
+| Microsoft.EntityFrameworkCore.Database.Transaction   | Uses of a database transaction
+| Microsoft.EntityFrameworkCore.Update                 | Saving entities, excluding database interactions
+| Microsoft.EntityFrameworkCore.Model                  | All model and metadata interactions
+| Microsoft.EntityFrameworkCore.Model.Validation       | Model validation
+| Microsoft.EntityFrameworkCore.Query                  | Queries, excluding database interactions
+| Microsoft.EntityFrameworkCore.Infrastructure         | General events, such as context creation
+| Microsoft.EntityFrameworkCore.Scaffolding            | Database reverse engineering
+| Microsoft.EntityFrameworkCore.Migrations             | Migrations
+| Microsoft.EntityFrameworkCore.ChangeTracking         | Change tracking interactions
+
+`LogTo` can be configured to only log the messages from one or more categories. For example, to log only database interactions:
+
+<!--
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .LogTo(Console.WriteLine, new[] { DbLoggerCategory.Database.Name });
+-->
+[!code-csharp[DatabaseCategory](../../../samples/core/Miscellaneous/Logging/SimpleLogging/Program.cs?name=DatabaseCategory)]
+
+Notice that the <xref:Microsoft.EntityFrameworkCore.DbLoggerCategory> class provides a hierarchical API for finding a category and avoids the need to hard-code strings.
+
+Since categories are hierarchical, this example using the `Database` category will include all messages for the subcategories `Database.Connection`, `Database.Command`, and `Database.Transaction`.
+
+### Custom filters
+
+`LogTo` allows a custom filter to be used for cases where none of the filtering options above are sufficient. For example, to log any message at level `Information` or above, as well as messages for opening and closing a connection:
+
+<!--
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .LogTo(
+                Console.WriteLine,
+                (eventId, logLevel) => logLevel >= LogLevel.Information
+                                       || eventId == RelationalEventId.ConnectionOpened
+                                       || eventId == RelationalEventId.ConnectionClosed);
+-->
+[!code-csharp[CustomFilter](../../../samples/core/Miscellaneous/Logging/SimpleLogging/Program.cs?name=CustomFilter)]
+
+> [!TIP]
+> Filtering using custom filters or using any of the other options shown here is more efficient than filtering in the `LogTo` delegate. This is because if the filter determines the message should not be logged, then the log message is not even created.
+
+## Configuration for specific messages
+
+The EF Core <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.ConfigureWarnings*> API allows applications to change what happens when a specific event is encountered. This can be used to:
+
+* Change the log level at which the event is logged
+* Skip logging the event altogether
+* Throw an exception when the event occurs
+
+### Changing the log level for an event
+
+The previous example used a custom filter to log every message at `LogLevel.Information` as well as two events defined for `LogLevel.Debug`. The same can be achieved by changing the log level of the two `Debug` events to `Information`:
+
+<!--
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .ConfigureWarnings(b => b.Log(
+                (RelationalEventId.ConnectionOpened, LogLevel.Information),
+                (RelationalEventId.ConnectionClosed, LogLevel.Information)))
+            .LogTo(Console.WriteLine, LogLevel.Information);
+-->
+[!code-csharp[ChangeLogLevel](../../../samples/core/Miscellaneous/Logging/SimpleLogging/Program.cs?name=ChangeLogLevel)]
+
+### Suppress logging an event
+
+In a similar way, an individual event can be suppressed from logging. This is particularly useful for ignoring a warning that has been reviewed and understood. For example:
+
+<!--
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .ConfigureWarnings(b => b.Ignore(CoreEventId.DetachedLazyLoadingWarning))
+            .LogTo(Console.WriteLine);
+-->
+[!code-csharp[SuppressMessage](../../../samples/core/Miscellaneous/Logging/SimpleLogging/Program.cs?name=SuppressMessage)]
+
+### Throw for an event
+
+Finally, EF Core can be configured to throw for a given event. This is particularly useful for changing a warning into an error. (Indeed, this was the original purpose of `ConfigureWarnings` method, hence the name.) For example:
+
+<!--
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .ConfigureWarnings(b => b.Throw(RelationalEventId.MultipleCollectionIncludeWarning))
+            .LogTo(Console.WriteLine);
+-->
+[!code-csharp[ThrowForEvent](../../../samples/core/Miscellaneous/Logging/SimpleLogging/Program.cs?name=ThrowForEvent)]
+
+## Message contents and formatting
+
+The default content from `LogTo` is formatted across multiple lines. The first line contains message metadata:
+
+* The <xref:Microsoft.Extensions.Logging.LogLevel> as a four-character prefix
+* A local timestamp, formatted for the current culture
+* The <xref:Microsoft.Extensions.Logging.EventId> in the form that can be copy/pasted to get the member from <xref:Microsoft.EntityFrameworkCore.Diagnostics.CoreEventId> or one of the other `EventId` classes, plus the raw ID value
+* The event category, as described above.
+
+For example:
+
+```output
+info: 10/6/2020 10:52:45.581 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed DbCommand (0ms) [Parameters=[], CommandType='Text', CommandTimeout='30']
+      CREATE TABLE "Blogs" (
+          "Id" INTEGER NOT NULL CONSTRAINT "PK_Blogs" PRIMARY KEY AUTOINCREMENT,
+          "Name" INTEGER NOT NULL
+      );
+dbug: 10/6/2020 10:52:45.582 RelationalEventId.TransactionCommitting[20210] (Microsoft.EntityFrameworkCore.Database.Transaction)
+      Committing transaction.
+dbug: 10/6/2020 10:52:45.585 RelationalEventId.TransactionCommitted[20202] (Microsoft.EntityFrameworkCore.Database.Transaction)
+      Committed transaction.
+```
+
+This content can be customized by passing values from <xref:Microsoft.EntityFrameworkCore.Diagnostics.DbContextLoggerOptions>, as shown in the following sections.
+
+> [!TIP]
+> Consider using [Microsoft.Extensions.Logging](/aspnet/core/fundamentals/logging) for more control over log formatting.
+
+### Using UTC time
+
+By default, timestamps are designed for local consumption while debugging. Use <xref:Microsoft.EntityFrameworkCore.Diagnostics.DbContextLoggerOptions.DefaultWithUtcTime?displayProperty=nameWithType> to use culture-agnostic UTC timestamps instead, but keep everything else the same. For example:
+
+<!--
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.LogTo(
+            Console.WriteLine,
+            LogLevel.Debug,
+            DbContextLoggerOptions.DefaultWithUtcTime);
+-->
+[!code-csharp[Utc](../../../samples/core/Miscellaneous/Logging/SimpleLogging/Program.cs?name=Utc)]
+
+This example results in the following log formatting:
+
+```output
+info: 2020-10-06T17:55:39.0333701Z RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed DbCommand (0ms) [Parameters=[], CommandType='Text', CommandTimeout='30']
+      CREATE TABLE "Blogs" (
+          "Id" INTEGER NOT NULL CONSTRAINT "PK_Blogs" PRIMARY KEY AUTOINCREMENT,
+          "Name" INTEGER NOT NULL
+      );
+dbug: 2020-10-06T17:55:39.0333892Z RelationalEventId.TransactionCommitting[20210] (Microsoft.EntityFrameworkCore.Database.Transaction)
+      Committing transaction.
+dbug: 2020-10-06T17:55:39.0351684Z RelationalEventId.TransactionCommitted[20202] (Microsoft.EntityFrameworkCore.Database.Transaction)
+      Committed transaction.
+```
+
+### Single line logging
+
+Sometimes it is useful to get exactly one line per log message. This can be enabled by <xref:Microsoft.EntityFrameworkCore.Diagnostics.DbContextLoggerOptions.SingleLine?displayProperty=nameWithType>. For example:
+
+<!--
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.LogTo(
+            Console.WriteLine,
+            LogLevel.Debug,
+            DbContextLoggerOptions.DefaultWithLocalTime | DbContextLoggerOptions.SingleLine);
+-->
+[!code-csharp[SingleLine](../../../samples/core/Miscellaneous/Logging/SimpleLogging/Program.cs?name=SingleLine)]
+
+This example results in the following log formatting:
+
+```output
+info: 10/6/2020 10:52:45.723 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command) -> Executed DbCommand (0ms) [Parameters=[], CommandType='Text', CommandTimeout='30']CREATE TABLE "Blogs" (    "Id" INTEGER NOT NULL CONSTRAINT "PK_Blogs" PRIMARY KEY AUTOINCREMENT,    "Name" INTEGER NOT NULL);
+dbug: 10/6/2020 10:52:45.723 RelationalEventId.TransactionCommitting[20210] (Microsoft.EntityFrameworkCore.Database.Transaction) -> Committing transaction.
+dbug: 10/6/2020 10:52:45.725 RelationalEventId.TransactionCommitted[20202] (Microsoft.EntityFrameworkCore.Database.Transaction) -> Committed transaction.
+```
+
+### Other content options
+
+Other flags in <xref:Microsoft.EntityFrameworkCore.Diagnostics.DbContextLoggerOptions> can be used to trim down the amount of metadata included in the log. This can be useful in conjunction with single-line logging. For example:
+
+<!--
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.LogTo(
+            Console.WriteLine,
+            LogLevel.Debug,
+            DbContextLoggerOptions.UtcTime | DbContextLoggerOptions.SingleLine);
+-->
+[!code-csharp[TerseLogs](../../../samples/core/Miscellaneous/Logging/SimpleLogging/Program.cs?name=TerseLogs)]
+
+This example results in the following log formatting:
+
+```output
+2020-10-06T17:52:45.7320362Z -> Executed DbCommand (0ms) [Parameters=[], CommandType='Text', CommandTimeout='30']CREATE TABLE "Blogs" (    "Id" INTEGER NOT NULL CONSTRAINT "PK_Blogs" PRIMARY KEY AUTOINCREMENT,    "Name" INTEGER NOT NULL);
+2020-10-06T17:52:45.7320531Z -> Committing transaction.
+2020-10-06T17:52:45.7339441Z -> Committed transaction.
+```
+
+## Moving from EF6
+
+EF Core simple logging differs from <xref:System.Data.Entity.Database.Log?displayProperty=nameWithType> in EF6 in two important ways:
+
+* Log messages are not limited to only database interactions
+* The logging must be configured at context initialization time
+
+For the first difference, the filtering described above can be used to limit which messages are logged.
+
+The second difference is an intentional change to improve performance by not generating log messages when they are not needed. However, it is still possible to get a similar behavior to EF6 by creating a `Log` property on your `DbContext` and then using it only when it has been set. For example:
+
+<!--
+    public Action<string> Log { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.LogTo(s => Log?.Invoke(s));
+-->
+[!code-csharp[DatabaseLog](../../../samples/core/Miscellaneous/Logging/SimpleLogging/Program.cs?name=DatabaseLog)]
diff --git a/entity-framework/core/logging-events-diagnostics/to-query-string.md.stub b/entity-framework/core/logging-events-diagnostics/to-query-string.md.stub
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/entity-framework/core/managing-schemas/ensure-created.md b/entity-framework/core/managing-schemas/ensure-created.md
new file mode 100644
index 0000000000..7e332b9f1c
--- /dev/null
+++ b/entity-framework/core/managing-schemas/ensure-created.md
@@ -0,0 +1,59 @@
+---
+title: Create and Drop APIs - EF Core
+description: APIs for creating and dropping databases with Entity Framework Core
+author: SamMonoRT
+ms.date: 10/21/2021
+no-loc: [EnsureDeleted, EnsureCreated]
+uid: core/managing-schemas/ensure-created
+---
+# Create and Drop APIs
+
+The <xref:Microsoft.EntityFrameworkCore.Storage.IDatabaseCreator.EnsureCreatedAsync*> and <xref:Microsoft.EntityFrameworkCore.Storage.IDatabaseCreator.EnsureDeletedAsync*> methods provide a lightweight alternative to [Migrations](xref:core/managing-schemas/migrations/index) for managing the database schema. These methods are useful in scenarios when the data is transient and can be dropped when the schema changes. For example during prototyping, in tests, or for local caches.
+
+Some providers (especially non-relational ones) don't support Migrations. For these providers, `EnsureCreatedAsync` is often the easiest way to initialize the database schema.
+
+> [!WARNING]
+> `EnsureCreatedAsync` and Migrations don't work well together. If you're using Migrations, don't use `EnsureCreatedAsync` to initialize the schema.
+
+Transitioning from `EnsureCreatedAsync` to Migrations is not a seamless experience. The simplest way to do it is to drop the database and re-create it using Migrations. If you anticipate using migrations in the future, it's best to just start with Migrations instead of using `EnsureCreatedAsync`.
+
+## EnsureDeletedAsync
+
+The `EnsureDeletedAsync` method will drop the database if it exists. If you don't have the appropriate permissions, an exception is thrown.
+
+```csharp
+// Drop the database if it exists
+await dbContext.Database.EnsureDeletedAsync();
+```
+
+## EnsureCreatedAsync
+
+`EnsureCreatedAsync` will create the database if it doesn't exist and initialize the database schema. If any tables exist (including tables for another `DbContext` class), the schema won't be initialized.
+
+```csharp
+// Create the database if it doesn't exist
+dbContext.Database.EnsureCreatedAsync();
+```
+
+> [!TIP]
+> Async versions of these methods are also available.
+
+## SQL Script
+
+To get the SQL used by `EnsureCreatedAsync`, you can use the <xref:Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.GenerateCreateScript*> method.
+
+```csharp
+var sql = dbContext.Database.GenerateCreateScript();
+```
+
+## Multiple DbContext classes
+
+EnsureCreated only works when no tables are present in the database. If needed, you can write your own check to see if the schema needs to be initialized, and use the underlying IRelationalDatabaseCreator service to initialize the schema.
+
+```csharp
+// TODO: Check whether the schema needs to be initialized
+
+// Initialize the schema for this DbContext
+var databaseCreator = dbContext.GetService<IRelationalDatabaseCreator>();
+databaseCreator.CreateTables();
+```
diff --git a/entity-framework/core/managing-schemas/index.md b/entity-framework/core/managing-schemas/index.md
new file mode 100644
index 0000000000..2b1803e4d7
--- /dev/null
+++ b/entity-framework/core/managing-schemas/index.md
@@ -0,0 +1,26 @@
+---
+title: Managing Database Schemas - EF Core
+description: Overview of strategies for managing your database schemas with Entity Framework Core
+author: SamMonoRT
+ms.date: 10/30/2017
+uid: core/managing-schemas/index
+---
+# Managing Database Schemas
+
+EF Core provides two primary ways of keeping your EF Core model and database schema in sync. To choose between the two,
+decide whether your EF Core model or the database schema is the source of truth.
+
+If you want your EF Core model to be the source of truth, use [Migrations][1]. As you make changes to your EF Core
+model, this approach incrementally applies the corresponding schema changes to your database so that it remains
+compatible with your EF Core model.
+
+Use [Reverse Engineering][2] if you want your database schema to be the source of truth. This approach allows you to
+scaffold a DbContext and the entity type classes by reverse engineering your database schema into an EF Core model.
+
+> [!NOTE]
+> The [create and drop APIs][3] can also create the database schema from your EF Core model. However, they are primarily
+> for testing, prototyping, and other scenarios where dropping the database is acceptable.
+
+  [1]: xref:core/managing-schemas/migrations/index
+  [2]: xref:core/managing-schemas/scaffolding
+  [3]: xref:core/managing-schemas/ensure-created
diff --git a/entity-framework/core/managing-schemas/migrations/applying.md b/entity-framework/core/managing-schemas/migrations/applying.md
new file mode 100644
index 0000000000..b20af256d4
--- /dev/null
+++ b/entity-framework/core/managing-schemas/migrations/applying.md
@@ -0,0 +1,343 @@
+---
+title: Applying Migrations - EF Core
+description: Strategies for applying schema migrations to production and development databases using Entity Framework Core
+author: SamMonoRT
+ms.date: 10/29/2024
+uid: core/managing-schemas/migrations/applying
+ms.custom: sfi-ropc-nochange
+---
+# Applying Migrations
+
+Once your migrations have been added, they need to be deployed and applied to your databases. There are various strategies for doing this, with some being more appropriate for production environments, and others for the development lifecycle.
+
+> [!NOTE]
+> Whatever your deployment strategy, always inspect the generated migrations and test them before applying to a production database. A migration may drop a column when the intent was to rename it, or may fail for various reasons when applied to a database.
+
+## SQL scripts
+
+The recommended way to deploy migrations to a production database is by generating SQL scripts. The advantages of this strategy include the following:
+
+* SQL scripts can be reviewed for accuracy; this is important since applying schema changes to production databases is a potentially dangerous operation that could involve data loss.
+* In some cases, the scripts can be tuned to fit the specific needs of a production database.
+* SQL scripts can be used in conjunction with a deployment technology, and can even be generated as part of your CI process.
+* SQL scripts can be provided to a DBA, and can be managed and archived separately.
+
+### [.NET CLI](#tab/dotnet-core-cli)
+
+#### Basic Usage
+
+The following generates a SQL script from a blank database to the latest migration:
+
+```dotnetcli
+dotnet ef migrations script
+```
+
+#### With From (to implied)
+
+The following generates a SQL script from the given migration to the latest migration.
+
+```dotnetcli
+dotnet ef migrations script AddNewTables
+```
+
+#### With From and To
+
+The following generates a SQL script from the specified `from` migration to the specified `to` migration.
+
+```dotnetcli
+dotnet ef migrations script AddNewTables AddAuditTable
+```
+
+You can use a `from` that is newer than the `to` in order to generate a rollback script.
+
+> [!WARNING]
+> Please take note of potential data loss scenarios.
+
+### [Visual Studio](#tab/vs)
+
+#### Basic Usage
+
+The following generates a SQL script from a blank database to the latest migration:
+
+```powershell
+Script-Migration
+```
+
+#### With From (to implied)
+
+The following generates a SQL script from the given migration to the latest migration.
+
+```powershell
+Script-Migration AddNewTables
+```
+
+#### With From and To
+
+The following generates a SQL script from the specified `from` migration to the specified `to` migration.
+
+```powershell
+Script-Migration AddNewTables AddAuditTable
+```
+
+You can use a `from` that is newer than the `to` in order to generate a rollback script.
+
+> [!WARNING]
+> Please take note of potential data loss scenarios.
+
+***
+
+Script generation accepts the following two arguments to indicate which range of migrations should be generated:
+
+* The **from** migration should be the last migration applied to the database before running the script. If no migrations have been applied, specify `0` (this is the default).
+* The **to** migration is the last migration that will be applied to the database after running the script. This defaults to the last migration in your project.
+
+## Idempotent SQL scripts
+
+The SQL scripts generated above can only be applied to change your schema from one migration to another; it is your responsibility to apply the script appropriately, and only to databases in the correct migration state. EF Core also supports generating **idempotent** scripts, which internally check which migrations have already been applied (via the migrations history table), and only apply missing ones. This is useful if you don't exactly know what the last migration applied to the database was, or if you are deploying to multiple databases that may each be at a different migration.
+
+The following generates idempotent migrations:
+
+### [.NET CLI](#tab/dotnet-core-cli)
+
+```dotnetcli
+dotnet ef migrations script --idempotent
+```
+
+### [Visual Studio](#tab/vs)
+
+```powershell
+Script-Migration -Idempotent
+```
+
+***
+
+## Command-line tools
+
+The EF command-line tools can be used to apply migrations to a database. While productive for local development and testing of migrations, this approach isn't ideal for managing production databases:
+
+* The SQL commands are applied directly by the tool, without giving the developer a chance to inspect or modify them. This can be dangerous in a production environment.
+* The .NET SDK and the EF tool must be installed on production servers and requires the project's source code.
+
+### [.NET CLI](#tab/dotnet-core-cli)
+
+The following updates your database to the latest migration:
+
+```dotnetcli
+dotnet ef database update
+```
+
+The following updates your database to a given migration:
+
+```dotnetcli
+dotnet ef database update AddNewTables
+```
+
+Note that this can be used to roll back to an earlier migration as well.
+
+> [!WARNING]
+> Please take note of potential data loss scenarios.
+
+### [Visual Studio](#tab/vs)
+
+The following updates your database to the latest migration:
+
+```powershell
+Update-Database
+```
+
+The following updates your database to a given migration:
+
+```powershell
+Update-Database AddNewTables
+```
+
+Note that this can be used to roll back to an earlier migration as well.
+
+> [!WARNING]
+> Please take note of potential data loss scenarios.
+
+***
+
+For more information on applying migrations via the command-line tools, see the [EF Core tools reference](xref:core/cli/index).
+
+## Bundles
+
+Migration bundles are single-file executables that can be used to apply migrations to a database. They address some of the shortcomings of the SQL script and command-line tools:
+
+* Executing SQL scripts requires additional tools.
+* The transaction handling and continue-on-error behavior of these tools are inconsistent and sometimes unexpected. This can leave your database in an undefined state if a failure occurs when applying migrations.
+* Bundles can be generated as part of your CI process and easily executed later as part of your deployment process.
+* Bundles can be executed without installing the .NET SDK or EF Tool (or even the .NET Runtime, when self-contained), and they don't require the project's source code.
+
+### [.NET CLI](#tab/dotnet-core-cli)
+
+The following generates a bundle:
+
+```dotnetcli
+dotnet ef migrations bundle
+```
+
+The following generates a self-contained bundle for Linux:
+
+```dotnetcli
+dotnet ef migrations bundle --self-contained -r linux-x64
+```
+
+### [Visual Studio](#tab/vs)
+
+The following generates a bundle:
+
+```powershell
+Bundle-Migration
+```
+
+The following generates a self-contained bundle for Linux:
+
+```dotnetcli
+Bundle-Migration -SelfContained -TargetRuntime linux-x64
+```
+
+***
+
+For more information on creating bundles see the [EF Core tools reference](xref:core/cli/index).
+
+### `efbundle`
+
+The resulting executable is named `efbundle` by default. It can be used to update the database to the latest migration. It's equivalent to running `dotnet ef database update` or `Update-Database`.
+
+Arguments:
+
+| Argument                   | Description                                                                                    |
+|----------------------------|------------------------------------------------------------------------------------------------|
+| <nobr>`<MIGRATION>`</nobr> | The target migration. If '0', all migrations will be reverted. Defaults to the last migration. |
+
+Options:
+
+| Option                                   | Short             | Description                                                                                            |
+|------------------------------------------|-------------------|--------------------------------------------------------------------------------------------------------|
+| <nobr>`--connection <CONNECTION>`</nobr> |                   | The connection string to the database. Defaults to the one specified in AddDbContext or OnConfiguring. |
+| `--verbose`                              | <nobr>`-v`</nobr> | Show verbose output.                                                                                   |
+| `--no-color`                             |                   | Don't colorize output.                                                                                 |
+| `--prefix-output`                        |                   | Prefix output with level.                                                                              |
+
+The following example applies migrations to a local SQL Server instance using the specified username and credentials:
+
+```powershell
+.\efbundle.exe --connection 'Data Source=(local)\MSSQLSERVER;Initial Catalog=Blogging;User ID=myUsername;Password={;'$Credential;'here'}'
+```
+
+> [!WARNING]
+> Don't forget to copy appsettings.json alongside your bundle. The bundle relies on the presence of appsettings.json in the execution directory.
+
+### Migration bundle example
+
+A bundle needs migrations to include. These are created using `dotnet ef migrations add` as described in [_Create your first migration_](xref:core/managing-schemas/migrations/index#create-your-first-migration). Once you have migrations ready to deploy, create a bundle using the `dotnet ef migrations bundle`. For example:
+
+```dotnetcli
+PS C:\local\AllTogetherNow\SixOh> dotnet ef migrations bundle
+Build started...
+Build succeeded.
+Building bundle...
+Done. Migrations Bundle: C:\local\AllTogetherNow\SixOh\efbundle.exe
+PS C:\local\AllTogetherNow\SixOh>
+```
+
+The output is an executable suitable for your target operating system. In my case this is Windows x64, so I get an `efbundle.exe` dropped in my local folder. Running this executable applies the migrations contained within it:
+
+```dotnetcli
+PS C:\local\AllTogetherNow\SixOh> .\efbundle.exe
+Applying migration '20210903083845_MyMigration'.
+Done.
+PS C:\local\AllTogetherNow\SixOh>
+```
+
+As with `dotnet ef database update` or `Update-Database`, migrations are applied to the database only if they have not been already applied. For example, running the same bundle again does nothing, since there are no new migrations to apply:
+
+```dotnetcli
+PS C:\local\AllTogetherNow\SixOh> .\efbundle.exe
+No migrations were applied. The database is already up to date.
+Done.
+PS C:\local\AllTogetherNow\SixOh>
+```
+
+However, if changes are made to the model and more migrations are generated with `dotnet ef migrations add`, then these can be bundled into a new executable ready to apply. For example:
+
+```dotnetcli
+PS C:\local\AllTogetherNow\SixOh> dotnet ef migrations add SecondMigration
+Build started...
+Build succeeded.
+Done. To undo this action, use 'ef migrations remove'
+PS C:\local\AllTogetherNow\SixOh> dotnet ef migrations add Number3
+Build started...
+Build succeeded.
+Done. To undo this action, use 'ef migrations remove'
+PS C:\local\AllTogetherNow\SixOh> dotnet ef migrations bundle --force
+Build started...
+Build succeeded.
+Building bundle...
+Done. Migrations Bundle: C:\local\AllTogetherNow\SixOh\efbundle.exe
+PS C:\local\AllTogetherNow\SixOh>
+```
+
+> [!TIP]
+> The `--force` option can be used to overwrite the existing bundle with a new one.
+
+Executing this new bundle applies these two new migrations to the database:
+
+```dotnetcli
+PS C:\local\AllTogetherNow\SixOh> .\efbundle.exe
+Applying migration '20210903084526_SecondMigration'.
+Applying migration '20210903084538_Number3'.
+Done.
+PS C:\local\AllTogetherNow\SixOh>
+```
+
+By default, the bundle uses the database connection string from your application's configuration. However, a different database can be migrated by passing the connection string on the command line. For example:
+
+```dotnetcli
+PS C:\local\AllTogetherNow\SixOh> .\efbundle.exe --connection "Data Source=(LocalDb)\MSSQLLocalDB;Database=SixOhProduction"
+Applying migration '20210903083845_MyMigration'.
+Applying migration '20210903084526_SecondMigration'.
+Applying migration '20210903084538_Number3'.
+Done.
+PS C:\local\AllTogetherNow\SixOh>
+```
+
+> [!NOTE]
+> This time, all three migrations were applied, since none of them had yet been applied to the production database.
+
+***
+
+## Apply migrations at runtime
+
+It's possible for the application itself to apply migrations programmatically, typically during startup. While productive for local development and testing of migrations, this approach is inappropriate for managing production databases, for the following reasons:
+
+* For versions of EF prior to 9, if multiple instances of your application are running, both applications could attempt to apply the migration concurrently and fail (or worse, cause data corruption).
+* Similarly, if an application is accessing the database while another application migrates it, this can cause severe issues.
+* The application must have elevated access to modify the database schema. It's generally good practice to limit the application's database permissions in production.
+* It's important to be able to roll back an applied migration in case of an issue. The other strategies provide this easily and out of the box.
+* The SQL commands are applied directly by the program, without giving the developer a chance to inspect or modify them. This can be dangerous in a production environment.
+
+To apply migrations programmatically, call `context.Database.MigrateAsync()`. For example, a typical ASP.NET application can do the following:
+
+```csharp
+public static async Task Main(string[] args)
+{
+    var host = CreateHostBuilder(args).Build();
+
+    using (var scope = host.Services.CreateScope())
+    {
+        var db = scope.ServiceProvider.GetRequiredService<ApplicationDbContext>();
+        await db.Database.MigrateAsync();
+    }
+
+    host.Run();
+}
+```
+
+Note that `MigrateAsync()` builds on top of the `IMigrator` service, which can be used for more advanced scenarios. Use `myDbContext.GetInfrastructure().GetService<IMigrator>()` to access it.
+
+> [!WARNING]
+>
+> * Carefully consider before using this approach in production. Experience has shown that the simplicity of this deployment strategy is outweighed by the issues it creates. Consider generating SQL scripts from migrations instead.
+> * Don't call `EnsureCreatedAsync()` before `MigrateAsync()`. `EnsureCreatedAsync()` bypasses Migrations to create the schema, which causes `MigrateAsync()` to fail.
diff --git a/entity-framework/core/managing-schemas/migrations/history-table.md b/entity-framework/core/managing-schemas/migrations/history-table.md
new file mode 100644
index 0000000000..ea9fdf8562
--- /dev/null
+++ b/entity-framework/core/managing-schemas/migrations/history-table.md
@@ -0,0 +1,34 @@
+---
+title: Custom Migrations History Table - EF Core
+description: Customizing a history table to use for migrations with Entity Framework Core
+author: SamMonoRT
+ms.date: 11/07/2017
+uid: core/managing-schemas/migrations/history-table
+---
+# Custom Migrations History Table
+
+By default, EF Core keeps track of which migrations have been applied to the database by recording them in a table named
+`__EFMigrationsHistory`. For various reasons, you may want to customize this table to better suit your needs.
+
+> [!IMPORTANT]
+> If you customize the Migrations history table *after* applying migrations, you are responsible for updating the
+> existing table in the database.
+
+## Schema and table name
+
+You can change the schema and table name using the `MigrationsHistoryTable()` method in `OnConfiguring()` (or
+`ConfigureServices()` on ASP.NET Core). Here is an example using the SQL Server EF Core provider.
+
+[!code-csharp[Main](../../../../samples/core/Schemas/Migrations/MigrationTableNameContext.cs#TableNameContext)]
+
+## Other changes
+
+To configure additional aspects of the table, override and replace the provider-specific
+`IHistoryRepository` service. Here is an example of changing the MigrationId column name to *Id* on SQL Server.
+
+[!code-csharp[Main](../../../../samples/core/Schemas/Migrations/MyHistoryRepository.cs#HistoryRepositoryContext)]
+
+> [!WARNING]
+> `SqlServerHistoryRepository` is inside an internal namespace and may change in future releases.
+
+[!code-csharp[Main](../../../../samples/core/Schemas/Migrations/MyHistoryRepository.cs#HistoryRepository)]
diff --git a/entity-framework/core/managing-schemas/migrations/index.md b/entity-framework/core/managing-schemas/migrations/index.md
new file mode 100644
index 0000000000..7f8cbde524
--- /dev/null
+++ b/entity-framework/core/managing-schemas/migrations/index.md
@@ -0,0 +1,149 @@
+---
+title: Migrations Overview - EF Core
+description: Overview of using migrations to manage database schemas with Entity Framework Core
+author: SamMonoRT
+ms.date: 10/28/2020
+uid: core/managing-schemas/migrations/index
+---
+# Migrations Overview
+
+In real world projects, data models change as features get implemented: new entities or properties are added and removed, and database schemas need to be changed accordingly to be kept in sync with the application. The migrations feature in EF Core provides a way to incrementally update the database schema to keep it in sync with the application's data model while preserving existing data in the database.
+
+At a high level, migrations function in the following way:
+
+* When a data model change is introduced, the developer uses EF Core tools to add a corresponding migration describing the updates necessary to keep the database schema in sync. EF Core compares the current model against a snapshot of the old model to determine the differences, and generates migration source files; the files can be tracked in your project's source control like any other source file.
+* Once a new migration has been generated, it can be applied to a database in various ways. EF Core records all applied migrations in a special history table, allowing it to know which migrations have been applied and which haven't.
+
+The rest of this page is a step-by-step beginner's guide for using migrations. Consult the other pages in this section for more in-depth information.
+
+## Getting started
+
+Let's assume you've just completed your first EF Core application, which contains the following simple model:
+
+```csharp
+public class Blog
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+}
+```
+
+During development, you may have used the [Create and Drop APIs](xref:core/managing-schemas/ensure-created) to iterate quickly, changing your model as needed; but now that your application is going to production, you need a way to safely evolve the schema without dropping the entire database.
+
+### Install the tools
+
+First, you'll have to install the [EF Core command-line tools](xref:core/cli/index):
+
+* We generally recommend using the [.NET CLI tools](xref:core/cli/dotnet), which work on all platforms.
+* If you're more comfortable working inside Visual Studio or have experience with EF6 migrations, you can also use the [Package Manager Console tools](xref:core/cli/powershell).
+
+### Create your first migration
+
+You're now ready to add your first migration! Instruct EF Core to create a migration named **InitialCreate**:
+
+#### [.NET CLI](#tab/dotnet-core-cli)
+
+```dotnetcli
+dotnet ef migrations add InitialCreate
+```
+
+#### [Visual Studio](#tab/vs)
+
+```powershell
+Add-Migration InitialCreate
+```
+
+***
+
+EF Core will create a directory called **Migrations** in your project, and generate some files. It's a good idea to inspect what exactly EF Core generated - and possibly amend it - but we'll skip over that for now.
+
+### Create your database and schema
+
+At this point you can have EF create your database and create your schema from the migration. This can be done via the following:
+
+#### [.NET CLI](#tab/dotnet-core-cli)
+
+```dotnetcli
+dotnet ef database update
+```
+
+#### [Visual Studio](#tab/vs)
+
+```powershell
+Update-Database
+```
+
+***
+
+That's all there is to it - your application is ready to run on your new database, and you didn't need to write a single line of SQL. Note that this way of applying migrations is ideal for local development, but is less suitable for production environments - see the [Applying Migrations page](xref:core/managing-schemas/migrations/applying) for more info.
+
+### Evolving your model
+
+A few days have passed, and you're asked to add a creation timestamp to your blogs. You've done the necessary changes to your application, and your model now looks like this:
+
+```csharp
+public class Blog
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+    public DateTime CreatedTimestamp { get; set; }
+}
+```
+
+Your model and your production database are now out of sync - we must add a new column to your database schema. Let's create a new migration for this:
+
+#### [.NET CLI](#tab/dotnet-core-cli)
+
+```dotnetcli
+dotnet ef migrations add AddBlogCreatedTimestamp
+```
+
+#### [Visual Studio](#tab/vs)
+
+```powershell
+Add-Migration AddBlogCreatedTimestamp
+```
+
+***
+
+Note that we give migrations a descriptive name, to make it easier to understand the project history later.
+
+Since this isn't the project's first migration, EF Core now compares your updated model against a snapshot of the old model, before the column was added; the model snapshot is one of the files generated by EF Core when you add a migration, and is checked into source control. Based on that comparison, EF Core detects that a column has been added, and adds the appropriate migration.
+
+You can now apply your migration as before:
+
+<!--markdownlint-disable MD024-->
+
+#### [.NET CLI](#tab/dotnet-core-cli)
+
+```dotnetcli
+dotnet ef database update
+```
+
+#### [Visual Studio](#tab/vs)
+
+```powershell
+Update-Database
+```
+
+<!--markdownlint-enable MD024-->
+
+***
+
+Note that this time, EF detects that the database already exists. In addition, when our first migration was applied above, this fact was recorded in a special migrations history table in your database; this allows EF to automatically apply only the new migration.
+
+### Excluding parts of your model
+
+Sometimes you may want to reference types from another DbContext. This can lead to migration conflicts. To prevent this, exclude the type from the migrations of one of the DbContexts.
+
+[!code-csharp[](../../../../samples/core/Modeling/EntityTypes/FluentAPI/TableExcludeFromMigrations.cs#TableExcludeFromMigrations)]
+
+### Next steps
+
+The above was only a brief introduction to migrations. Please consult the other documentation pages to learn more about [managing migrations](xref:core/managing-schemas/migrations/managing), [applying them](xref:core/managing-schemas/migrations/applying), and other aspects. The [.NET CLI tool reference](xref:core/cli/index) also contains useful information on the different commands
+
+## Additional resources
+
+* [Entity Framework Core tools reference - .NET CLI](xref:core/cli/dotnet) : Includes commands to update, drop, add, remove, and  more.
+* [Entity Framework Core tools reference - Package Manager Console in Visual Studio](xref:core/cli/powershell) : Includes commands to update, drop, add, remove, and  more.
+* [.NET Data Community Standup session](https://www.youtube.com/watch?v=mSsGERmrhnE&list=PLdo4fOcmZ0oX-DBuRG4u58ZTAJgBAeQ-t&index=20) going over new migration features in EF Core 5.0.
diff --git a/entity-framework/core/managing-schemas/migrations/managing.md b/entity-framework/core/managing-schemas/migrations/managing.md
new file mode 100644
index 0000000000..2f903799bd
--- /dev/null
+++ b/entity-framework/core/managing-schemas/migrations/managing.md
@@ -0,0 +1,247 @@
+---
+title: Managing Migrations - EF Core
+description: Adding, removing and otherwise managing database schema migrations with Entity Framework Core
+author: SamMonoRT
+ms.date: 10/27/2020
+uid: core/managing-schemas/migrations/managing
+ms.custom: sfi-ropc-nochange
+---
+# Managing Migrations
+
+As your model changes, migrations are added and removed as part of normal development, and the migration files are checked into your project's source control. To manage migrations, you must first install the [EF Core command-line tools](xref:core/cli/index).
+
+> [!TIP]
+> If the `DbContext` is in a different assembly than the startup project, you can explicitly specify the target and startup projects in either the [Package Manager Console tools](xref:core/cli/powershell#target-and-startup-project) or the [.NET CLI tools](xref:core/cli/dotnet#target-project-and-startup-project).
+
+## Add a migration
+
+After your model has been changed, you can add a migration for that change:
+
+### [.NET CLI](#tab/dotnet-core-cli)
+
+```dotnetcli
+dotnet ef migrations add AddBlogCreatedTimestamp
+```
+
+### [Visual Studio](#tab/vs)
+
+```powershell
+Add-Migration AddBlogCreatedTimestamp
+```
+
+***
+
+The migration name can be used like a commit message in a version control system. For example, you might choose a name like *AddBlogCreatedTimestamp* if the change is a new `CreatedTimestamp` property on your `Blog` entity.
+
+Three files are added to your project under the **Migrations** directory:
+
+* **XXXXXXXXXXXXXX_AddBlogCreatedTimestamp.cs**--The main migrations file. Contains the operations necessary to apply the migration (in `Up`) and to revert it (in `Down`).
+* **XXXXXXXXXXXXXX_AddBlogCreatedTimestamp.Designer.cs**--The migrations metadata file. Contains information used by EF.
+* **MyContextModelSnapshot.cs**--A snapshot of your current model. Used to determine what changed when adding the next migration.
+
+The timestamp in the filename helps keep them ordered chronologically so you can see the progression of changes.
+
+### Namespaces
+
+You are free to move Migrations files and change their namespace manually. New migrations are created as siblings of the last migration. Alternatively, you can specify the directory at generation time as follows:
+
+#### [.NET CLI](#tab/dotnet-core-cli)
+
+```dotnetcli
+dotnet ef migrations add InitialCreate --output-dir Your/Directory
+```
+
+> [!NOTE]
+> You can also change the namespace independently of the directory using `--namespace`.
+
+#### [Visual Studio](#tab/vs)
+
+```powershell
+Add-Migration InitialCreate -OutputDir Your\Directory
+```
+
+> [!NOTE]
+> You can also change the namespace independently of the directory using `-Namespace`.
+
+***
+
+## Customize migration code
+
+While EF Core generally creates accurate migrations, you should always review the code and make sure it corresponds to the desired change; in some cases, it is even necessary to do so.
+
+### Column renames
+
+One notable example where customizing migrations is required is when renaming a property. For example, if you rename a property from `Name` to `FullName`, EF Core will generate the following migration:
+
+```csharp
+migrationBuilder.DropColumn(
+    name: "Name",
+    table: "Customers");
+
+migrationBuilder.AddColumn<string>(
+    name: "FullName",
+    table: "Customers",
+    nullable: true);
+```
+
+EF Core is generally unable to know when the intention is to drop a column and create a new one (two separate changes), and when a column should be renamed. If the above migration is applied as-is, all your customer names will be lost. To rename a column, replace the above generated migration with the following:
+
+```csharp
+migrationBuilder.RenameColumn(
+    name: "Name",
+    table: "Customers",
+    newName: "FullName");
+```
+
+> [!TIP]
+> The migration scaffolding process warns when an operation might result in data loss (like dropping a column). If you see that warning, be especially sure to review the migrations code for accuracy.
+
+### Adding raw SQL
+
+While renaming a column can be achieved via a built-in API, in many cases that is not possible. For example, we may want to replace existing `FirstName` and `LastName` properties with a single, new `FullName` property. The migration generated by EF Core will be the following:
+
+```csharp
+migrationBuilder.DropColumn(
+    name: "FirstName",
+    table: "Customer");
+
+migrationBuilder.DropColumn(
+    name: "LastName",
+    table: "Customer");
+
+migrationBuilder.AddColumn<string>(
+    name: "FullName",
+    table: "Customer",
+    nullable: true);
+```
+
+As before, this would cause unwanted data loss. To transfer the data from the old columns, we rearrange the migrations and introduce a raw SQL operation as follows:
+
+```csharp
+migrationBuilder.AddColumn<string>(
+    name: "FullName",
+    table: "Customer",
+    nullable: true);
+
+migrationBuilder.Sql(
+@"
+    UPDATE Customer
+    SET FullName = FirstName + ' ' + LastName;
+");
+
+migrationBuilder.DropColumn(
+    name: "FirstName",
+    table: "Customer");
+
+migrationBuilder.DropColumn(
+    name: "LastName",
+    table: "Customer");
+```
+
+### Arbitrary changes via raw SQL
+
+Raw SQL can also be used to manage database objects that EF Core isn't aware of. To do this, add a migration without making any model change; an empty migration will be generated, which you can then populate with raw SQL operations.
+
+For example, the following migration creates a SQL Server stored procedure:
+
+```csharp
+migrationBuilder.Sql(
+@"
+    EXEC ('CREATE PROCEDURE getFullName
+        @LastName nvarchar(50),
+        @FirstName nvarchar(50)
+    AS
+        SELECT @LastName + @FirstName;')");
+```
+
+> [!TIP]
+> `EXEC` is used when a statement must be the first or only one in a SQL batch. It can also be used to work around parser errors in idempotent migration scripts that can occur when referenced columns don't currently exist on a table.
+
+This can be used to manage any aspect of your database, including:
+
+* Stored procedures
+* Full-Text Search
+* Functions
+* Triggers
+* Views
+
+In most cases, EF Core will automatically wrap each migration in its own transaction when applying migrations. Unfortunately, some migrations operations cannot be performed within a transaction in some databases; for these cases, you may opt out of the transaction by passing `suppressTransaction: true` to `migrationBuilder.Sql`.
+
+## Remove a migration
+
+Sometimes you add a migration and realize you need to make additional changes to your EF Core model before applying it. To remove the last migration, use this command.
+
+### [.NET CLI](#tab/dotnet-core-cli)
+
+```dotnetcli
+dotnet ef migrations remove
+```
+
+### [Visual Studio](#tab/vs)
+
+```powershell
+Remove-Migration
+```
+
+***
+
+After removing the migration, you can make the additional model changes and add it again.
+
+> [!WARNING]
+> Avoid removing any migrations which have already been applied to production databases. Doing so means you won't be able to revert those migrations from the databases, and may break the assumptions made by subsequent migrations.
+
+## Listing migrations
+
+You can list all existing migrations as follows:
+
+### [.NET CLI](#tab/dotnet-core-cli)
+
+```dotnetcli
+dotnet ef migrations list
+```
+
+### [Visual Studio](#tab/vs)
+
+```powershell
+Get-Migration
+```
+
+***
+
+## Checking for pending model changes
+
+> [!NOTE]
+> This feature was added in EF Core 8.0.
+
+Sometimes you may want to check if there have been any model changes made since the last migration. This can help you know when you or a teammate forgot to add a migration. One way to do that is using this command.
+
+```dotnetcli
+dotnet ef migrations has-pending-model-changes
+```
+
+You can also perform this check programmatically using `context.Database.HasPendingModelChanges()`. This can be used to write a unit test that fails when you forget to add a migration.
+
+## Resetting all migrations
+
+In some extreme cases, it may be necessary to remove all migrations and start over. This can be easily done by deleting your **Migrations** folder and dropping your database; at that point you can create a new initial migration, which will contain your entire current schema.
+
+It's also possible to reset all migrations and create a single one without losing your data. This is sometimes called "squashing", and involves some manual work:
+
+1. Back up your database, in case something goes wrong.
+2. In your database, delete all rows from the migrations history table (e.g. `DELETE FROM [__EFMigrationsHistory]` on SQL Server).
+3. Delete your **Migrations** folder.
+4. Create a new migration and generate a SQL script for it (`dotnet ef migrations script`).
+5. Insert a single row into the migrations history, to record that the first migration has already been applied, since your tables are already there. The insert SQL is the last operation in the SQL script generated above, and resembles the following (don't forget to update the values):
+
+```sql
+INSERT INTO [__EFMigrationsHistory] ([MIGRATIONID], [PRODUCTVERSION])
+VALUES (N'<full_migration_timestamp_and_name>', N'<EF_version>');
+```
+
+> [!WARNING]
+> Any [custom migration code](#customize-migration-code) will be lost when the **Migrations** folder is deleted.  Any customizations must be applied to the new initial migration manually in order to be preserved.
+
+## Additional resources
+
+* [Entity Framework Core tools reference - .NET CLI](xref:core/cli/dotnet) : Includes commands to update, drop, add, remove, and  more.
+* [Entity Framework Core tools reference - Package Manager Console in Visual Studio](xref:core/cli/powershell) : Includes commands to update, drop, add, remove, and  more.
diff --git a/entity-framework/core/managing-schemas/migrations/operations.md b/entity-framework/core/managing-schemas/migrations/operations.md
new file mode 100644
index 0000000000..0e3495517c
--- /dev/null
+++ b/entity-framework/core/managing-schemas/migrations/operations.md
@@ -0,0 +1,49 @@
+---
+title: Custom Migrations Operations - EF Core
+description: Managing custom and raw SQL migrations for database schema management with Entity Framework Core
+author: SamMonoRT
+ms.date: 10/27/2020
+uid: core/managing-schemas/migrations/operations
+---
+# Custom Migrations Operations
+
+The MigrationBuilder API allows you to perform many different kinds of operations during a migration, but it's far from exhaustive. However, the API is also extensible allowing you to define your own operations. There are two ways to extend the API: Using the `Sql()` method, or by defining custom `MigrationOperation` objects.
+
+To illustrate, let's look at implementing an operation that creates a database user using each approach. In our migrations, we want to enable writing the following code:
+
+```csharp
+migrationBuilder.CreateUser("SQLUser1", "Password");
+```
+
+## Using MigrationBuilder.Sql()
+
+The easiest way to implement a custom operation is to define an extension method that calls `MigrationBuilder.Sql()`. Here is an example that generates the appropriate Transact-SQL.
+
+[!code-csharp[](../../../../samples/core/Schemas/Migrations/CustomOperationSql.cs#snippet_CustomOperationSql)]
+
+> [!TIP]
+> On SQL Server, use the `EXEC` function when a statement must be the first or only one in a SQL batch. It might also be needed to work around parser errors in idempotent migration scripts that can occur when referenced columns don't currently exist on a table.
+
+If your migrations need to support multiple database providers, you can use the `MigrationBuilder.ActiveProvider` property. Here's an example supporting both Microsoft SQL Server and PostgreSQL.
+
+[!code-csharp[](../../../../samples/core/Schemas/Migrations/CustomOperationMultiSql.cs#snippet_CustomOperationMultiSql)]
+
+This approach only works if you know every provider where your custom operation will be applied.
+
+## Using a MigrationOperation
+
+To decouple the custom operation from the SQL, you can define your own `MigrationOperation` to represent it. The operation is then passed to the provider so it can determine the appropriate SQL to generate.
+
+[!code-csharp[](../../../../samples/core/Schemas/Migrations/CustomOperation.cs#snippet_CreateUserOperation)]
+
+With this approach, the extension method just needs to add one of these operations to `MigrationBuilder.Operations`.
+
+[!code-csharp[](../../../../samples/core/Schemas/Migrations/CustomOperation.cs#snippet_MigrationBuilderExtension)]
+
+This approach requires each provider to know how to generate SQL for this operation in their `IMigrationsSqlGenerator` service. Here is an example overriding the SQL Server's generator to handle the new operation.
+
+[!code-csharp[](../../../../samples/core/Schemas/Migrations/CustomOperation.cs#snippet_MigrationsSqlGenerator)]
+
+Replace the default migrations sql generator service with the updated one.
+
+[!code-csharp[](../../../../samples/core/Schemas/Migrations/CustomOperation.cs#snippet_OnConfiguring)]
diff --git a/entity-framework/core/managing-schemas/migrations/projects.md b/entity-framework/core/managing-schemas/migrations/projects.md
new file mode 100644
index 0000000000..657459747e
--- /dev/null
+++ b/entity-framework/core/managing-schemas/migrations/projects.md
@@ -0,0 +1,64 @@
+---
+title: Using a Separate Migrations Project - EF Core
+description: Using a separate migration project for managing database schemas with Entity Framework Core
+author: SamMonoRT
+ms.date: 11/06/2020
+uid: core/managing-schemas/migrations/projects
+---
+
+# Using a Separate Migrations Project
+
+You may want to store your migrations in a different project than the one containing your `DbContext`. This is recommended if your project uses a platform-specific project type, such as WinUI, Xamarin, MAUI, Blazor, or Azure Functions, or if it targets a specific runtime identifier (RID). You can also use this strategy to maintain multiple sets of migrations, for example, one for development and another for release-to-release upgrades.
+
+> [!TIP]
+> You can view this article's [sample on GitHub](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Schemas/ThreeProjectMigrations).
+
+## Steps
+
+1. Create a new class library.
+
+2. Add a reference to your DbContext project.
+
+3. Move the migrations and model snapshot files to the class library.
+   > [!TIP]
+   > If you have no existing migrations, generate one in the project containing the DbContext then move it.
+   > This is important because if the migrations project does not contain an existing migration, the Add-Migration command will be unable to find the DbContext.
+
+4. Configure the migrations assembly:
+
+   [!code-csharp[](../../../../samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Startup.cs#snippet_MigrationsAssembly)]
+
+5. Add a reference to your migrations project from the **startup** project.
+
+   ```xml
+   <ItemGroup>
+     <ProjectReference Include="..\WebApplication1.Migrations\WebApplication1.Migrations.csproj" />
+   </ItemGroup>
+   ```
+
+   If this causes a circular dependency, you can update the base output path of the **migrations** project instead:
+
+   ```xml
+   <PropertyGroup>
+     <BaseOutputPath>..\WebApplication1\bin\</BaseOutputPath>
+   </PropertyGroup>
+   ```
+
+If you did everything correctly, you should be able to add new migrations to the project.
+
+## [.NET CLI](#tab/dotnet-core-cli)
+
+```dotnetcli
+dotnet ef migrations add NewMigration --project WebApplication1.Migrations
+```
+
+## [Visual Studio](#tab/vs)
+
+```powershell
+Add-Migration NewMigration -Project WebApplication1.Migrations
+```
+
+***
+
+> [!TIP]
+> If your application uses dependency injection, consider implementing <xref:Microsoft.EntityFrameworkCore.Design.IDesignTimeDbContextFactory`1> in your migrations project. This allows the EF tools to create your `DbContext` without needing to run the startup project. For more information, see [From a design-time factory](xref:core/cli/dbcontext-creation#from-a-design-time-factory).
diff --git a/entity-framework/core/managing-schemas/migrations/providers.md b/entity-framework/core/managing-schemas/migrations/providers.md
new file mode 100644
index 0000000000..1705faa841
--- /dev/null
+++ b/entity-framework/core/managing-schemas/migrations/providers.md
@@ -0,0 +1,78 @@
+---
+title: Migrations with Multiple Providers - EF Core
+description: Using migrations to manage database schemas when targeting multiple database providers with Entity Framework Core
+author: SamMonoRT
+ms.date: 10/29/2020
+uid: core/managing-schemas/migrations/providers
+---
+# Migrations with Multiple Providers
+
+The [EF Core Tools](xref:core/cli/index) only scaffold migrations for the active provider. Sometimes, however, you may want to use more than one provider (for example Microsoft SQL Server and SQLite) with your DbContext. Handle this by maintaining multiple sets of migrations--one for each provider--and adding a migration to each for every model change.
+
+## Using multiple context types
+
+One way to create multiple migration sets is to use one DbContext type per provider.
+
+```csharp
+class SqliteBlogContext : BlogContext
+{
+    protected override void OnConfiguring(DbContextOptionsBuilder options)
+        => options.UseSqlite("Data Source=my.db");
+}
+```
+
+Specify the context type when adding new migrations.
+
+### [.NET CLI](#tab/dotnet-core-cli)
+
+```dotnetcli
+dotnet ef migrations add InitialCreate --context BlogContext --output-dir Migrations/SqlServerMigrations
+dotnet ef migrations add InitialCreate --context SqliteBlogContext --output-dir Migrations/SqliteMigrations
+```
+
+### [Visual Studio](#tab/vs)
+
+```powershell
+Add-Migration InitialCreate -Context BlogContext -OutputDir Migrations\SqlServerMigrations
+Add-Migration InitialCreate -Context SqliteBlogContext -OutputDir Migrations\SqliteMigrations
+```
+
+***
+
+> [!TIP]
+> You don't need to specify the output directory for subsequent migrations since they are created as siblings to the
+> last one.
+
+## Using one context type
+
+It's also possible to use one DbContext type. This currently requires moving the migrations into a separate assembly. Please refer to [Using a Separate Migrations Project](xref:core/managing-schemas/migrations/projects) for instructions on setting up your projects.
+
+> [!TIP]
+> You can view this article's [sample on GitHub](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Schemas/TwoProjectMigrations).
+
+You can pass arguments into the app from the tools. This can enable a more streamlined workflow that avoids having to make manual changes to the project when running the tools.
+
+Here's one pattern that works well when using a [Generic Host](/dotnet/core/extensions/generic-host).
+
+[!code-csharp[](../../../../samples/core/Schemas/TwoProjectMigrations/WorkerService1/Program.cs#snippet_CreateHostBuilder)]
+
+Since the default host builder reads configuration from command-line arguments, you can specify the provider when running the tools.
+
+### [.NET CLI](#tab/dotnet-core-cli)
+
+```dotnetcli
+dotnet ef migrations add MyMigration --project ../SqlServerMigrations -- --provider SqlServer
+dotnet ef migrations add MyMigration --project ../SqliteMigrations -- --provider Sqlite
+```
+
+> [!TIP]
+> The `--` token directs `dotnet ef` to treat everything that follows as an argument and not try to parse them as options. Any extra arguments not used by `dotnet ef` are forwarded to the app.
+
+### [Visual Studio](#tab/vs)
+
+```powershell
+Add-Migration MyMigration -Args "--provider SqlServer"
+Add-Migration MyMigration -Args "--provider Sqlite"
+```
+
+***
diff --git a/entity-framework/core/managing-schemas/migrations/teams.md b/entity-framework/core/managing-schemas/migrations/teams.md
new file mode 100644
index 0000000000..f11152ed8c
--- /dev/null
+++ b/entity-framework/core/managing-schemas/migrations/teams.md
@@ -0,0 +1,34 @@
+---
+title: Migrations in Team Environments - EF Core
+description: Best practices for managing migrations and resolving conflicts in team environments with Entity Framework Core
+author: SamMonoRT
+ms.date: 02/18/2026
+uid: core/managing-schemas/migrations/teams
+---
+# Migrations in Team Environments
+
+When working with Migrations in team environments, various problems can arise when migrations are added by multiple developers around the same time; note that migrations aren't simply SQL scripts but also include a snapshot of the model at the time of that migration.
+
+For example, imagine developer A and B both create work branches at the same time, and generate a migration in their branches. If developer A merges their branch and then developer B does the same, the latest migration (developer B's) will have a context snapshot that does not include the changes from developer A's migration. This can cause various forms of corruption in later migrations.
+
+As a result, it is highly recommended to coordinate in advance and to avoid working concurrently on migrations in multiple branches when possible.
+
+## Detecting diverged migration trees
+
+> [!NOTE]
+> This feature is being introduced in EF Core 11 from preview-3 onwards.
+
+Starting with EF 11, the model snapshot records the ID of the latest migration. This means that if two developers each create a migration on separate branches, merging those branches will produce a source control conflict in the model snapshot file — since both branches modify the latest migration ID. This conflict is an important signal: it tells you that the migration trees have diverged, and one of them must be discarded before proceeding.
+
+To resolve this, follow the steps in [Resolving diverged migration trees](#resolving-diverged-migration-trees) below: abort the merge, remove your migration (keeping your model changes), merge your teammate's changes, and then re-add your migration.
+
+## Resolving diverged migration trees
+
+If, when merging a branch, a diverged migration tree is detected, resolve it by re-creating your migration. Follow these steps:
+
+1. Abort the merge and rollback to your working directory before the merge
+2. Remove your migration (but keep your model changes)
+3. Merge your teammate's changes into your working directory
+4. Re-add your migration
+
+After doing this, your migration is cleanly based on top of any migrations that have been added in the other branch, and its context snapshot contains all previous changes. Your migration can now be safely shared with the rest of the team.
diff --git a/entity-framework/core/managing-schemas/scaffolding/index.md b/entity-framework/core/managing-schemas/scaffolding/index.md
new file mode 100644
index 0000000000..4ea02e0f0c
--- /dev/null
+++ b/entity-framework/core/managing-schemas/scaffolding/index.md
@@ -0,0 +1,480 @@
+---
+title: Reverse Engineering - EF Core
+description: Reverse engineering a model from an existing database using Entity Framework Core
+author: SamMonoRT
+ms.date: 03/27/2023
+uid: core/managing-schemas/scaffolding
+ms.custom: sfi-ropc-nochange
+---
+# Scaffolding (Reverse Engineering)
+
+Reverse engineering is the process of scaffolding entity type classes and a [DbContext](/dotnet/api/microsoft.entityframeworkcore.dbcontext) class based on a database schema. It can be performed using the `Scaffold-DbContext` command of the EF Core Package Manager Console (PMC) tools or the `dotnet ef dbcontext scaffold` command of the .NET Command-line Interface (CLI) tools.
+
+> [!NOTE]
+> The scaffolding of a `DbContext` and entity types documented here is distinct from the [scaffolding of controllers in ASP.NET Core](/aspnet/mvc/overview/getting-started/introduction/adding-a-controller) using Visual Studio, which is not documented here.
+
+> [!TIP]
+> If you use Visual Studio, try out the [EF Core Power Tools](https://github.com/ErikEJ/EFCorePowerTools/) community extension. These tools provide a graphical tool which builds on top of the EF Core command line tools and offers additional workflow and customization options.
+
+## Prerequisites
+
+- Before scaffolding, you'll need to install either the [PMC tools](xref:core/cli/powershell), which work on Visual Studio only, or the [.NET CLI tools](xref:core/cli/dotnet), which work across all platforms supported by .NET.
+- Install the NuGet package for `Microsoft.EntityFrameworkCore.Design` in the project you are scaffolding to.
+- Install the NuGet package for the [database provider](xref:core/providers/index) that targets the database schema you want to scaffold from.
+
+## Required arguments
+
+Both the PMC and the .NET CLI commands have two required arguments: the connection string to the database, and the EF Core database provider to use.
+
+### Connection string
+
+[!INCLUDE [managed-identities-test-non-production](~/core/includes/managed-identities-test-non-production.md)]
+
+The first argument to the command is a connection string to the database. The tools use this connection string to read the database schema.
+
+How the connection string is quoted and escaped depends on the shell that is used to run the command. Refer to the shell's documentation. For example, PowerShell requires escaping `$`, but not `\`.
+
+The following example scaffolds entity types and a `DbContext` from the `Chinook` database located on the machine's SQL Server LocalDB instance, making use of the `Microsoft.EntityFrameworkCore.SqlServer` database provider.
+
+#### [.NET CLI](#tab/dotnet-core-cli)
+
+```dotnetcli
+dotnet ef dbcontext scaffold "Data Source=(localdb)\MSSQLLocalDB;Initial Catalog=Chinook" Microsoft.EntityFrameworkCore.SqlServer
+```
+
+#### [Visual Studio PMC](#tab/vs)
+
+```powershell
+Scaffold-DbContext 'Data Source=(localdb)\MSSQLLocalDB;Initial Catalog=Chinook' Microsoft.EntityFrameworkCore.SqlServer
+```
+
+***
+
+> [!TIP]
+> You can [use Configuration to store and retrieve the connection string](xref:core/miscellaneous/connection-strings#aspnet-core)
+
+#### Connection strings in the scaffolded code
+
+By default, the scaffolder will include the connection string in the scaffolded code, but with a warning. For example:
+
+```csharp
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+#warning To protect potentially sensitive information in your connection string, you should move it out of source code. You can avoid scaffolding the connection string by using the Name= syntax to read it from configuration - see https://go.microsoft.com/fwlink/?linkid=2131148. For more guidance on storing connection strings, see http://go.microsoft.com/fwlink/?LinkId=723263.
+    => optionsBuilder.UseSqlServer("Data Source=(LocalDb)\\MSSQLLocalDB;Database=AllTogetherNow");
+```
+
+This is done so that the generated code does not crash when first used, which would be a very poor learning experience. However, as the warning says, connection strings should not exist in production code. See [_DbContext Lifetime, Configuration, and Initialization_](xref:core/dbcontext-configuration/index) for the various ways that connection strings can be managed.
+
+> [!TIP]
+> The `-NoOnConfiguring` (Visual Studio PMC) or `--no-onconfiguring` (.NET CLI) option can be passed to suppress creation of the `OnConfiguring` method containing the connection string.
+
+### Provider name
+
+The second argument is the provider name. The provider name is typically the same as the provider's NuGet package name. For example, for SQL Server or Azure SQL, use `Microsoft.EntityFrameworkCore.SqlServer`.
+
+## Command line options
+
+The scaffolding process can be controlled by various command line options.
+
+### Specifying tables and views
+
+By default, all tables and views in the database schema are scaffolded into entity types. You can limit which tables and views are scaffolded by specifying schemas and tables.
+
+The `-Schemas` (Visual Studio PMC) or `--schema` (.NET CLI) argument specifies the schemas of tables and views for which entity types will be generated. If this argument is omitted, then all schemas are included. If this option is used, then all tables and views in the schemas will be included in the model, even if they are not explicitly included using `-Tables` or `--table`.
+
+The `-Tables` (Visual Studio PMC) or `--table` (.NET CLI) argument specified the tables and views for which entity types will be generated. Tables or views in a specific schema can be included using the 'schema.table' or 'schema.view' format. If this option is omitted, then all tables and views are included.                                              |
+
+For example, to scaffold only the `Artists` and `Albums` tables:
+
+#### [.NET CLI](#tab/dotnet-core-cli)
+
+```dotnetcli
+dotnet ef dbcontext scaffold ... --table Artist --table Album
+```
+
+#### [Visual Studio PMC](#tab/vs)
+
+```powershell
+Scaffold-DbContext ... -Tables Artists, Albums
+```
+
+***
+
+To scaffold all tables and views from the `Customer` and `Contractor` schemas:
+
+#### [.NET CLI](#tab/dotnet-core-cli)
+
+```dotnetcli
+dotnet ef dbcontext scaffold ... --schema Customer --schema Contractor
+```
+
+#### [Visual Studio PMC](#tab/vs)
+
+```powershell
+Scaffold-DbContext ... -Schemas Customer, Contractor
+```
+
+***
+
+For example, to scaffold the `Purchases` table from the `Customer` schema, and the `Accounts` and `Contracts` tables from the `Contractor` schema:
+
+#### [.NET CLI](#tab/dotnet-core-cli)
+
+```dotnetcli
+dotnet ef dbcontext scaffold ... --table Customer.Purchases --table Contractor.Accounts --table Contractor.Contracts
+```
+
+#### [Visual Studio PMC](#tab/vs)
+
+```powershell
+Scaffold-DbContext ... -Tables Customer.Purchases, Contractor.Accounts, Contractor.Contracts
+```
+
+***
+
+### Preserving database names
+
+Table and column names are fixed up to better match the .NET naming conventions for types and properties by default. Specifying `-UseDatabaseNames` (Visual Studio PMC) or `--use-database-names` (.NET CLI) will disable this behavior preserving the original database names as much as possible. Invalid .NET identifiers will still be fixed and synthesized names like navigation properties will still conform to .NET naming conventions.
+
+For example, consider the following tables:
+
+```sql
+CREATE TABLE [BLOGS] (
+    [ID] int NOT NULL IDENTITY,
+    [Blog_Name] nvarchar(max) NOT NULL,
+    CONSTRAINT [PK_Blogs] PRIMARY KEY ([ID]));
+
+CREATE TABLE [posts] (
+    [id] int NOT NULL IDENTITY,
+    [postTitle] nvarchar(max) NOT NULL,
+    [post content] nvarchar(max) NOT NULL,
+    [1 PublishedON] datetime2 NOT NULL,
+    [2 DeletedON] datetime2 NULL,
+    [BlogID] int NOT NULL,
+    CONSTRAINT [PK_Posts] PRIMARY KEY ([id]),
+    CONSTRAINT [FK_Posts_Blogs_BlogId] FOREIGN KEY ([BlogID]) REFERENCES [Blogs] ([ID]) ON DELETE CASCADE);
+```
+
+By default, the following entity types will be scaffolded from these tables:
+
+```csharp
+public partial class Blog
+{
+    public int Id { get; set; }
+    public string BlogName { get; set; } = null!;
+    public virtual ICollection<Post> Posts { get; set; } = new List<Post>();
+}
+
+public partial class Post
+{
+    public int Id { get; set; }
+    public string PostTitle { get; set; } = null!;
+    public string PostContent { get; set; } = null!;
+    public DateTime _1PublishedOn { get; set; }
+    public DateTime? _2DeletedOn { get; set; }
+    public int BlogId { get; set; }
+    public virtual Blog Blog { get; set; } = null!;
+    public virtual ICollection<Tag> Tags { get; set; } = new List<Tag>();
+}
+```
+
+However, using `-UseDatabaseNames` or `--use-database-names` results in the following entity types:
+
+```csharp
+public partial class BLOG
+{
+    public int ID { get; set; }
+    public string Blog_Name { get; set; } = null!;
+    public virtual ICollection<post> posts { get; set; } = new List<post>();
+}
+
+public partial class post
+{
+    public int id { get; set; }
+    public string postTitle { get; set; } = null!;
+    public string post_content { get; set; } = null!;
+    public DateTime _1_PublishedON { get; set; }
+    public DateTime? _2_DeletedON { get; set; }
+    public int BlogID { get; set; }
+    public virtual BLOG Blog { get; set; } = null!;
+}
+```
+
+### Use mapping attributes (aka Data Annotations)
+
+Entity types are configured using the [`ModelBuilder` API in `OnModelCreating`](xref:core/modeling/index#use-fluent-api-to-configure-a-model) by default. Specify `-DataAnnotations` (PMC) or `--data-annotations` (.NET CLI) to instead use [mapping attributes](xref:core/modeling/index#use-data-annotations-to-configure-a-model) when possible.
+
+For example, using the Fluent API will scaffold this:
+
+```csharp
+entity.Property(e => e.Title)
+    .IsRequired()
+    .HasMaxLength(160);
+```
+
+While using Data Annotations will scaffold this:
+
+```csharp
+[Required]
+[StringLength(160)]
+public string Title { get; set; }
+```
+
+> [!TIP]
+> Some aspects of the model cannot be configured using mapping attributes. The scaffolder will still use the model building API to handle these cases.
+
+### DbContext name
+
+The scaffolded `DbContext` class name will be the name of the database suffixed with _Context_ by default. To specify a different one, use `-Context` in PMC and `--context` in the .NET CLI.
+
+### Target directories and namespaces
+
+The entity classes and a DbContext class are scaffolded into the project's root directory and use the project's default namespace.
+
+#### [.NET CLI](#tab/dotnet-core-cli)
+
+You can specify the directory where classes are scaffolded using `--output-dir`, and `--context-dir` can be used to scaffold the DbContext class into a separate directory from the entity type classes:
+
+```dotnetcli
+dotnet ef dbcontext scaffold ... --context-dir Data --output-dir Models
+```
+
+By default, the namespace will be the root namespace plus the names of any subdirectories under the project's root directory. However, you can override the namespace for all output classes by using `--namespace`. You can also override the namespace for just the DbContext class using `--context-namespace`:
+
+```dotnetcli
+dotnet ef dbcontext scaffold ... --namespace Your.Namespace --context-namespace Your.DbContext.Namespace
+```
+
+#### [Visual Studio PMC](#tab/vs)
+
+You can specify the directory where classes are scaffolded using `-OutputDir`, and `-ContextDir` can be used to scaffold the DbContext class into a separate directory from the entity type classes:
+
+```powershell
+Scaffold-DbContext ... -ContextDir Data -OutputDir Models
+```
+
+By default, the namespace will be the root namespace plus the names of any subdirectories under the project's root directory. However, you can override the namespace for all output classes by using `-Namespace`. You can also override the namespace for just the DbContext class using `-ContextNamespace`.
+
+```powershell
+Scaffold-DbContext ... -Namespace Your.Namespace -ContextNamespace Your.DbContext.Namespace
+```
+
+***
+
+## The scaffolded code
+
+The result of scaffolding from an existing database is:
+
+- A file containing a class that inherits from `DbContext`
+- A file for each entity type
+
+> [!TIP]
+> Starting in EF7, you can also use T4 text templates to customize the generated code. See [_Custom Reverse Engineering Templates_](xref:core/managing-schemas/scaffolding/templates) for more details.
+
+### C# Nullable reference types
+
+The scaffolder can create EF model and entity types that use [C# nullable reference types](/dotnet/csharp/tutorials/nullable-reference-types) (NRTs). NRT usage is scaffolded automatically when NRT support is enabled in the C# project into which the code is being scaffolded.
+
+For example, the following `Tags` table contains both nullable non-nullable string columns:
+
+```sql
+CREATE TABLE [Tags] (
+  [Id] int NOT NULL IDENTITY,
+  [Name] nvarchar(max) NOT NULL,
+  [Description] nvarchar(max) NULL,
+  CONSTRAINT [PK_Tags] PRIMARY KEY ([Id]));
+```
+
+This results in corresponding nullable and non-nullable string properties in the generated class:
+
+<!--
+    public partial class Tag
+    {
+        public int Id { get; set; }
+        public string Name { get; set; } = null!;
+        public string? Description { get; set; }
+
+        public virtual ICollection<Post> Posts { get; set; }
+    }
+-->
+[!code-csharp[Tag](../../../../samples/core/Miscellaneous/NewInEFCore6/ScaffoldingSample.cs?name=Tag)]
+
+Similarly, the following `Posts` tables contains a required relationship to the `Blogs` table:
+
+```sql
+CREATE TABLE [Posts] (
+    [Id] int NOT NULL IDENTITY,
+    [Title] nvarchar(max) NOT NULL,
+    [Contents] nvarchar(max) NOT NULL,
+    [PostedOn] datetime2 NOT NULL,
+    [UpdatedOn] datetime2 NULL,
+    [BlogId] int NOT NULL,
+    CONSTRAINT [PK_Posts] PRIMARY KEY ([Id]),
+    CONSTRAINT [FK_Posts_Blogs_BlogId] FOREIGN KEY ([BlogId]) REFERENCES [Blogs] ([Id]));
+```
+
+This results in the scaffolding of non-nullable (required) relationship between blogs:
+
+<!--
+    public partial class Blog
+    {
+        public Blog()
+        {
+            Posts = new HashSet<Post>();
+        }
+
+        public int Id { get; set; }
+        public string Name { get; set; } = null!;
+
+        public virtual ICollection<Post> Posts { get; set; }
+    }
+-->
+[!code-csharp[Blog](../../../../samples/core/Miscellaneous/NewInEFCore6/ScaffoldingSample.cs?name=Blog)]
+
+And posts:
+
+<!--
+public partial class Post
+{
+    public int Id { get; set; }
+    public string Title { get; set; } = null!;
+    public string Contents { get; set; } = null!;
+    public DateTime PostedOn { get; set; }
+    public DateTime? UpdatedOn { get; set; }
+    public int BlogId { get; set; }
+
+    public virtual Blog Blog { get; set; } = null!;
+
+    public virtual ICollection<Tag> Tags { get; set; } = new List<Tag>();
+}
+-->
+[!code-csharp[Post](../../../../samples/core/Miscellaneous/NewInEFCore6/ScaffoldingSample.cs?name=Post)]
+
+### Many-to-many relationships
+
+The scaffolding process detects simple join tables and automatically generates a [many-to-many mapping](xref:core/modeling/relationships#many-to-many) for them. For example, consider tables for `Posts` and `Tags`, and a join table `PostTag` connecting them:
+
+```sql
+CREATE TABLE [Tags] (
+  [Id] int NOT NULL IDENTITY,
+  [Name] nvarchar(max) NOT NULL,
+  [Description] nvarchar(max) NULL,
+  CONSTRAINT [PK_Tags] PRIMARY KEY ([Id]));
+
+CREATE TABLE [Posts] (
+    [Id] int NOT NULL IDENTITY,
+    [Title] nvarchar(max) NOT NULL,
+    [Contents] nvarchar(max) NOT NULL,
+    [PostedOn] datetime2 NOT NULL,
+    [UpdatedOn] datetime2 NULL,
+    CONSTRAINT [PK_Posts] PRIMARY KEY ([Id]));
+
+CREATE TABLE [PostTag] (
+    [PostsId] int NOT NULL,
+    [TagsId] int NOT NULL,
+    CONSTRAINT [PK_PostTag] PRIMARY KEY ([PostsId], [TagsId]),
+    CONSTRAINT [FK_PostTag_Posts_TagsId] FOREIGN KEY ([TagsId]) REFERENCES [Tags] ([Id]) ON DELETE CASCADE,
+    CONSTRAINT [FK_PostTag_Tags_PostsId] FOREIGN KEY ([PostsId]) REFERENCES [Posts] ([Id]) ON DELETE CASCADE);
+```
+
+When scaffolded, this results in a class for Post:
+
+<!--
+public partial class Post
+{
+    public int Id { get; set; }
+    public string Title { get; set; } = null!;
+    public string Contents { get; set; } = null!;
+    public DateTime PostedOn { get; set; }
+    public DateTime? UpdatedOn { get; set; }
+    public int BlogId { get; set; }
+
+    public virtual Blog Blog { get; set; } = null!;
+
+    public virtual ICollection<Tag> Tags { get; set; } = new List<Tag>();
+}
+-->
+[!code-csharp[Post](../../../../samples/core/Miscellaneous/NewInEFCore6/ScaffoldingSample.cs?name=Post)]
+
+And a class for Tag:
+
+<!--
+    public partial class Tag
+    {
+        public int Id { get; set; }
+        public string Name { get; set; } = null!;
+        public string? Description { get; set; }
+
+        public virtual ICollection<Post> Posts { get; set; } = new List<Post>();
+    }
+-->
+[!code-csharp[Tag](../../../../samples/core/Miscellaneous/NewInEFCore6/ScaffoldingSample.cs?name=Tag)]
+
+But no class for the `PostTag` table. Instead, configuration for a many-to-many relationship is scaffolded:
+
+<!--
+entity.HasMany(d => d.Tags)
+    .WithMany(p => p.Posts)
+    .UsingEntity<Dictionary<string, object>>(
+        "PostTag",
+        l => l.HasOne<Tag>().WithMany().HasForeignKey("PostsId"),
+        r => r.HasOne<Post>().WithMany().HasForeignKey("TagsId"),
+        j =>
+            {
+                j.HasKey("PostsId", "TagsId");
+                j.ToTable("PostTag");
+                j.HasIndex(new[] { "TagsId" }, "IX_PostTag_TagsId");
+            });
+-->
+[!code-csharp[ManyToMany](../../../../samples/core/Miscellaneous/NewInEFCore6/ScaffoldingSample.cs?name=ManyToMany)]
+
+### Other programming languages
+
+The EF Core packages published by Microsoft scaffold C# code. However, the underlying scaffolding system supports a plugin model for scaffolding to other languages. This plugin model is used by various community-run projects, for example:
+
+- [EntityFrameworkCore.VisualBasic](https://github.com/efcore/EFCore.VisualBasic) provides support for Visual Basic
+- [EFCore.FSharp](https://github.com/efcore/EFCore.FSharp) provides support for F#
+
+### Customizing the code
+
+Starting with EF7, one of the best ways to customize the generated code is by [customizing the T4 templates used to generate it](xref:core/managing-schemas/scaffolding/templates).
+
+The code can also be changed after it is generated, but the best way to do this depends on whether you intend to re-run the scaffolding process when the database model changes.
+
+#### Scaffold once only
+
+With this approach, the scaffolded code provides a starting point for code-based mapping going forward. Any changes to the generated code can be made as desired--it becomes normal code just like any other code in your project.
+
+Keeping the database and the EF model in sync can be done in one of two ways:
+
+- Switch to using [EF Core database migrations](xref:core/managing-schemas/migrations/index), and use the entity types and EF model configuration as the source of truth, using migrations to drive the schema.
+- Manually update the entity types and EF configuration when the database changes. For example, if a new column is added to a table, then add a property for the column to the mapped entity type, and add any necessary configuration using mapping attributes and/or code in `OnModelCreating`. This is relatively easy, with the only real challenge being a process to make sure that database changes are recorded or detected in some way so that the developer(s) responsible for the code can react.
+
+#### Repeated scaffolding
+
+An alternate approach to scaffolding once is to re-scaffold every time the database changes. This will _overwrite_ any previously scaffolded code, meaning any changes made to entity types or EF configuration in that code will be lost.
+
+> [TIP]
+> By default, the EF commands will not overwrite any existing code to protect against accidental code loss. The `-Force` (Visual Studio PMC) or `--force` (.NET CLI) argument can be used to force overwriting of existing files.
+
+Since the scaffolded code will be overwritten, it is best not to modify it directly, but instead rely on [partial classes and methods](/dotnet/csharp/programming-guide/classes-and-structs/partial-classes-and-methods), and the mechanisms in EF Core that allow configuration to be overridden. Specifically:
+
+- Both the `DbContext` class and the entity classes are generated as partial. This allows introducing additional members and code in a separate file which will not be overridden when scaffolding is run.
+- The `DbContext` class contains a partial method called `OnModelCreatingPartial`. An implementation of this method can be added to the partial class for the `DbContext`. It will then be called after `OnModelCreating` is called.
+- Model configuration made using the `ModelBuilder` APIs overrides any configuration done by conventions or mapping attributes, as well earlier configuration done on the model builder. This means that code in `OnModelCreatingPartial` can be used to override the configuration generated by the scaffolding process, without the need to remove that configuration.
+
+Finally, remember that starting with EF7, the [T4 templates used to generate code can be customized](xref:core/managing-schemas/scaffolding/templates). This is often a more effective approach than scaffolding with the defaults and then modifying with partial classes and/or methods.
+
+## How it works
+
+Reverse engineering starts by reading the database schema. It reads information about tables, columns, constraints, and indexes.
+
+Next, it uses the schema information to create an EF Core model. Tables are used to create entity types; columns are used to create properties; and foreign keys are used to create relationships.
+
+Finally, the model is used to generate code. The corresponding entity type classes, Fluent API, and data annotations are scaffolded in order to re-create the same model from your app.
+
+## Limitations
+
+- Not everything about a model can be represented using a database schema. For example, information about [**inheritance hierarchies**](xref:core/modeling/inheritance), [**owned types**](xref:core/modeling/owned-entities), and [**table splitting**](xref:core/modeling/table-splitting) are not present in the database schema. Because of this, these constructs will never be scaffolded.
+- In addition, **some column types** may not be supported by the EF Core provider. These columns won't be included in the model.
+- You can define [**concurrency tokens**](xref:core/saving/concurrency) in an EF Core model to prevent two users from updating the same entity at the same time. Some databases have a special type to represent this type of column (for example, rowversion in SQL Server) in which case we can reverse engineer this information; however, other concurrency tokens will not be scaffolded.
diff --git a/entity-framework/core/managing-schemas/scaffolding/templates.md b/entity-framework/core/managing-schemas/scaffolding/templates.md
new file mode 100644
index 0000000000..c7499a0e00
--- /dev/null
+++ b/entity-framework/core/managing-schemas/scaffolding/templates.md
@@ -0,0 +1,239 @@
+---
+title: Custom Reverse Engineering Templates - EF Core
+description: Using T4 text templates to customize the scaffolded code when reverse engineering an Entity Framework Core model from a database
+author: SamMonoRT
+ms.date: 08/16/2022
+uid: core/managing-schemas/scaffolding/templates
+---
+# Custom Reverse Engineering Templates
+
+> [!NOTE]
+> This feature was added in EF Core 7.
+
+While [reverse engineering](xref:core/managing-schemas/scaffolding), Entity Framework Core strives to scaffold good, general-purpose code that can be used in a variety of app types and uses [common coding conventions](/dotnet/csharp/fundamentals/coding-style/coding-conventions) for a consistent look and a familiar feel. Sometimes, however, more specialized code and alternative coding styles are desirable. This article shows how to customize the scaffolded code using [T4 text templates](/visualstudio/modeling/code-generation-and-t4-text-templates).
+
+## Prerequisites
+
+This article assumes you're familiar with [reverse engineering in EF Core](xref:core/managing-schemas/scaffolding). If not, please review that article before proceeding.
+
+## Adding the default templates
+
+The first step to customizing the scaffolded code is to add the default templates to your project. The default templates are the ones used internally by EF Core when reverse engineering. They provide a starting point for you to begin customizing the scaffolded code.
+
+Start by installing the EF Core template package for `dotnet new`:
+
+```dotnetcli
+dotnet new install Microsoft.EntityFrameworkCore.Templates
+```
+
+Now you can add the default templates to your project. Do this by running the following command from your project directory.
+
+```dotnetcli
+dotnet new ef-templates
+```
+
+This command adds the following files to your project.
+
+- CodeTemplates/
+  - EFCore/
+    - DbContext.t4
+    - EntityType.t4
+
+The `DbContext.t4` template is used to scaffold a DbContext class for the database, and the `EntityType.t4` template is used to scaffold entity type classes for each table and view in the database.
+
+> [!TIP]
+> The .t4 extension is used (instead of .tt) to prevent Visual Studio from transforming the templates. The templates will be transformed by EF Core instead.
+
+## Introduction to T4
+
+Let's open the `DbContext.t4` template and inspect its contents. This file is a [T4 text template](/visualstudio/modeling/writing-a-t4-text-template). T4 is a language for generating text using .NET. The following code is for illustrative purposes only; it does not represent the full contents of the file.
+
+> [!IMPORTANT]
+> T4 text templates--especially ones that generate code--can be difficult to read without syntax highlighting. If necessary, search for an extension to your code editor that enables T4 syntax highlighting.
+
+```T4
+<#@ template hostSpecific="true" #>
+<#@ assembly name="Microsoft.EntityFrameworkCore.Design" #>
+<#@ parameter name="NamespaceHint" type="System.String" #>
+<#@ import namespace="Microsoft.EntityFrameworkCore" #>
+<#
+    if (!string.IsNullOrEmpty(NamespaceHint))
+    {
+#>
+namespace <#= NamespaceHint #>;
+```
+
+The first few lines that begin with `<#@` are called directives. They affect how the template is transformed. The following table briefly describes each kind of directive used.
+
+Directive   | Description
+----------- | -----------
+`template`  | Specifies hostSpecific="true" which enables using the `Host` property inside the template to access EF Core services.
+`assembly`  | Adds assembly references required to compile the template.
+`parameter` | Declares parameters that will be passed in by EF Core when transforming the template.
+`import`    | Like C# using directives, brings namespaces into scope for the template code.
+
+After the directives, the next section of `DbContext.t4` is called a control block. A standard control block begins with `<#` and ends with `#>`. The code inside of it will be executed when transforming the template. For a list of properties and methods available inside control blocks, see the [TextTransformation](/dotnet/api/microsoft.visualstudio.texttemplating.texttransformation) class.
+
+Anything outside of a control block will be copied directly to the template output.
+
+An expression control block begins with `<#=`. The code inside of it will be evaluated and the result will be added to the template output. These are similar to C# interpolated string arguments.
+
+For a more detailed and complete explanation of the T4 syntax, see [Writing a T4 Text Template](/visualstudio/modeling/writing-a-t4-text-template).
+
+## Customize the entity types
+
+Let's walk through what it's like to customize a template. By default, EF Core generates the following code for collection navigation properties.
+
+```C#
+public virtual ICollection<Album> Albums { get; } = new List<Album>();
+```
+
+Using `List<T>` is a good default for most applications. However, if you're using a XAML-based framework like WPF, WinUI, or .NET MAUI, you often want to use `ObservableCollection<T>` instead to enable data binding.
+
+Open the `EntityType.t4` template and find where it generates `List<T>`. It looks like this:
+
+```T4
+    if (navigation.IsCollection)
+    {
+#>
+    public virtual ICollection<<#= targetType #>> <#= navigation.Name #> { get; } = new List<<#= targetType #>>();
+<#
+    }
+```
+
+Replace List with ObservableCollection.
+
+```T4
+public virtual ICollection<<#= targetType #>> <#= navigation.Name #> { get; } = new ObservableCollection<<#= targetType #>>();
+```
+
+We also need to add a `using` directive to the scaffolded code. The usings are specified in a list near the top of the template. Add `System.Collections.ObjectModel` to the list.
+
+```C#
+var usings = new List<string>
+{
+    "System",
+    "System.Collections.Generic",
+    "System.Collections.ObjectModel"
+};
+```
+
+Test the changes by using the reverse engineering commands. The templates inside your project are used automatically by the commands.
+
+### [.NET CLI](#tab/dotnet-core-cli)
+
+```dotnetcli
+dotnet ef dbcontext scaffold "Data Source=(localdb)\MSSQLLocalDB;Initial Catalog=Chinook" Microsoft.EntityFrameworkCore.SqlServer
+```
+
+If you've ran the command previously, add the `--force` option to overwrite the existing files.
+
+### [Visual Studio](#tab/vs)
+
+```powershell
+Scaffold-DbContext 'Data Source=(localdb)\MSSQLLocalDB;Initial Catalog=Chinook' Microsoft.EntityFrameworkCore.SqlServer
+```
+
+If you've ran the command previously, add the `-Force` switch to overwrite the existing files.
+
+***
+
+If you did everything correctly, the collection navigation properties should now use `ObservableCollection<T>`.
+
+```C#
+public virtual ICollection<Album> Albums { get; } = new ObservableCollection<Album>();
+```
+
+## Updating templates
+
+When you add the default templates to your project, it creates a copy of them based on that version of EF Core. As bugs are fixed and features are added in subsequent versions of EF Core, your templates may become out of date. You should review the changes made in the EF Core templates and merge them into your customized templates.
+
+One way to review the changes made to the EF Core templates is to use git to compare them between versions. The following command will clone the EF Core repository and generate a diff of these files between versions 7.0.0 and 8.0.0.
+
+```console
+git clone --no-checkout https://github.com/dotnet/efcore.git
+cd efcore
+git diff v7.0.0 v8.0.0 -- src/EFCore.Design/Scaffolding/Internal/CSharpDbContextGenerator.tt src/EFCore.Design/Scaffolding/Internal/CSharpEntityTypeGenerator.tt
+```
+
+Another way to review the changes is to download the two versions of [Microsoft.EntityFrameworkCore.Templates](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Templates) from NuGet, extract their contents (you can change the file extensions to .zip), and compare those files.
+
+Before adding the default templates to a new project, remember to update to the latest EF Core template package.
+
+```dotnetcli
+dotnet new update
+```
+
+## Advanced usage
+
+### Ignoring the input model
+
+The `Model` and `EntityType` parameters represent one possible way of mapping to the database. You can choose to ignore or change parts of the model. For example, the navigation names we provide may not be ideal, and you can replace them with your own when scaffolding the code. Other things like constraint names and index filters are only used by Migrations and can safely be omitted from the model if you don't intend to use Migrations with the scaffolded code. Likewise, you may want to omit sequences or default constraints if they're not used by your app.
+
+When making advanced changes like this, just make sure the resulting model remains compatible with the database. Reviewing the SQL generated by `dbContext.Database.GenerateCreateScript()` is a good way to validate this.
+
+### Entity configuration classes
+
+For large models, the OnModelCreating method of the DbContext class can become unmanageably large. One way to address this is to use `IEntityTypeConfiguration<T>` classes. See [Creating and configuring a model](xref:core/modeling/index#grouping-configuration) for more information about these classes.
+
+To scaffold these classes, you can use a third template called `EntityTypeConfiguration.t4`. Like the `EntityType.t4` template, it gets used for each entity type in the model and uses the `EntityType` template parameter.
+
+### Generate Join Table in Many to Many Relationships
+
+By default, the scaffolding process does not generate an entity for join tables in simple many-to-many relationships. However, there are cases where explicitly generating the join table as an entity might be necessary (e.g., when finer control over the generated SQL query is required).
+
+The scaffolding behavior for each entity is controlled by the EntityType.t4 template file. Within this file, there is a condition that short-circuits entity generation for simple many-to-many join tables. To override this behavior and generate the join entity, you can comment out this condition in the 'EntityType.t4' file.
+
+```T4
+<#
+    // Comment this condition
+    if (EntityType.IsSimpleManyToManyJoinEntityType())
+    {
+        // Don't scaffold these
+        return "";
+    }
+    .  .  .    
+#>
+```
+
+### Scaffolding other types of files
+
+The primary purpose of reverse engineering in EF Core is to scaffold a DbContext and entity types. However, there's nothing in the tools that require you to actually scaffold code. For example, you could instead scaffold an entity relationship diagram using [Mermaid](https://mermaid-js.github.io/).
+
+````T4
+<#@ output extension=".md" #>
+<#@ assembly name="Microsoft.EntityFrameworkCore" #>
+<#@ assembly name="Microsoft.EntityFrameworkCore.Relational" #>
+<#@ assembly name="Microsoft.EntityFrameworkCore.Design" #>
+<#@ parameter name="Model" type="Microsoft.EntityFrameworkCore.Metadata.IModel" #>
+<#@ parameter name="Options" type="Microsoft.EntityFrameworkCore.Scaffolding.ModelCodeGenerationOptions" #>
+<#@ import namespace="System.Linq" #>
+<#@ import namespace="Microsoft.EntityFrameworkCore" #>
+# <#= Options.ContextName #>
+
+```mermaid
+erDiagram
+<#
+    foreach (var entityType in Model.GetEntityTypes().Where(e => !e.IsSimpleManyToManyJoinEntityType()))
+    {
+#>
+    <#= entityType.Name #> {
+    }
+<#
+        foreach (var foreignKey in entityType.GetForeignKeys())
+        {
+#>
+    <#= entityType.Name #> <#= foreignKey.IsUnique ? "|" : "}" #>o--<#= foreignKey.IsRequired ? "|" : "o" #>| <#= foreignKey.PrincipalEntityType.Name #> : "<#= foreignKey.GetConstraintName() #>"
+<#
+        }
+
+        foreach (var skipNavigation in entityType.GetSkipNavigations().Where(n => n.IsLeftNavigation()))
+        {
+#>
+    <#= entityType.Name #> }o--o{ <#= skipNavigation.TargetEntityType.Name #> : <#= skipNavigation.JoinEntityType.Name #>
+<#
+        }
+    }
+#>
+```
+````
diff --git a/entity-framework/core/miscellaneous/async.md b/entity-framework/core/miscellaneous/async.md
new file mode 100644
index 0000000000..7360e38ec8
--- /dev/null
+++ b/entity-framework/core/miscellaneous/async.md
@@ -0,0 +1,56 @@
+---
+title: Asynchronous Programming - EF Core
+description: Querying and saving data asynchronously with Entity Framework Core
+author: roji
+ms.date: 10/1/2021
+uid: core/miscellaneous/async
+---
+# Asynchronous Programming
+
+Asynchronous operations avoid blocking a thread while the query is executed in the database. Async operations are important for keeping a responsive UI in rich client applications, and can also increase throughput in web applications where they free up the thread to service other requests in web applications.
+
+Following the .NET standard, EF Core provides asynchronous counterparts to all synchronous methods which perform I/O. These have the same effects as the sync methods, and can be used with the C# `async` and `await` keywords. For example, instead of using DbContext.SaveChanges, which will block a thread while database I/O is performed, DbContext.SaveChangesAsync can be used:
+
+[!code-csharp[Main](../../../samples/core/Miscellaneous/Async/Program.cs#SaveChangesAsync)]
+
+For more information, see [the general C# asynchronous programming docs](/dotnet/csharp/async).
+
+> [!WARNING]
+> EF Core doesn't support multiple parallel operations being run on the same context instance. You should always wait for an operation to complete before beginning the next operation. This is typically done by using the `await` keyword on each async operation.
+
+> [!WARNING]
+> The async implementation of [Microsoft.Data.SqlClient](https://github.com/dotnet/SqlClient) unfortunately has some known issues (e.g. [#593](https://github.com/dotnet/SqlClient/issues/593), [#601](https://github.com/dotnet/SqlClient/issues/601), and others). If you're seeing unexpected performance problems, try using sync command execution instead, especially when dealing with large text or binary values.
+
+> [!NOTE]
+> EF Core passes cancellation tokens down to the underlying database provider in use (e.g. Microsoft.Data.SqlClient). These tokens may or may not be honored - consult your database provider's documentation.
+
+## Async LINQ operators
+
+In order to support executing LINQ queries asynchronously, EF Core provides a set of async extension methods which execute the query and return results. These counterparts to the standard, synchronous LINQ operators include <xref:Microsoft.EntityFrameworkCore.EntityFrameworkQueryableExtensions.ToListAsync*>, <xref:Microsoft.EntityFrameworkCore.EntityFrameworkQueryableExtensions.SingleAsync*>, <xref:Microsoft.EntityFrameworkCore.EntityFrameworkQueryableExtensions.AsAsyncEnumerable*>, etc.:
+
+[!code-csharp[Main](../../../samples/core/Miscellaneous/Async/Program.cs#ToListAsync)]
+
+Note that there are no async versions of some LINQ operators such as <xref:System.Linq.Queryable.Where*> or <xref:System.Linq.Queryable.OrderBy*>, because these only build up the LINQ expression tree and don't cause the query to be executed in the database. Only operators which cause query execution have async counterparts.
+
+> [!IMPORTANT]
+> The EF Core async extension methods are defined in the `Microsoft.EntityFrameworkCore` namespace. This namespace must be imported for the methods to be available.
+
+## Client-side async LINQ operators
+
+In certain cases, you may want to apply client-side LINQ operators to results coming back from the database; this is needed especially when you need to perform an operation that cannot be translated to SQL. For such cases, use <xref:Microsoft.EntityFrameworkCore.EntityFrameworkQueryableExtensions.AsAsyncEnumerable*> to execute the query on the database, and continue composing client-side LINQ operators over the resulting <xref:System.Collections.Generic.IAsyncEnumerable`1>. For example, the following executes a local .NET function on the asynchronous results of the EF LINQ query:
+
+```c#
+var blogs = context.Blogs
+    .Where(b => b.Rating > 3) // server-evaluated (translated to SQL)
+    .AsAsyncEnumerable()
+    .Where(b => SomeLocalFunction(b)); // client-evaluated (in .NET)
+
+await foreach (var blog in blogs)
+{
+    // ...
+}
+
+```
+
+> [!NOTE]
+> LINQ operators over <xref:System.Collections.Generic.IAsyncEnumerable`1> are being introduced in .NET 10. When using an older version of .NET, reference the [`System.Linq.Async` package](https://www.nuget.org/packages/System.Linq.Async).
diff --git a/entity-framework/core/miscellaneous/collations-and-case-sensitivity.md b/entity-framework/core/miscellaneous/collations-and-case-sensitivity.md
new file mode 100644
index 0000000000..821d2d39b2
--- /dev/null
+++ b/entity-framework/core/miscellaneous/collations-and-case-sensitivity.md
@@ -0,0 +1,74 @@
+---
+title: Collations and case sensitivity - EF Core
+description: Configuring collations and case-sensitivity in the database and on queries with Entity Framework Core
+author: roji
+ms.date: 04/27/2020
+uid: core/miscellaneous/collations-and-case-sensitivity
+---
+# Collations and Case Sensitivity
+
+Text processing in databases can be complex, and requires more user attention than one would suspect. For one thing, databases vary considerably in how they handle text; for example, while some databases are case-sensitive by default (e.g. Sqlite, PostgreSQL), others are case-insensitive (SQL Server, MySQL). In addition, because of index usage, case-sensitivity and similar aspects can have a far-reaching impact on query performance: while it may be tempting to use `string.ToLower` to force a case-insensitive comparison in a case-sensitive database, doing so may prevent your application from using indexes. This page details how to configure case sensitivity, or more generally, collations, and how to do so in an efficient way without compromising query performance.
+
+## Introduction to collations
+
+A fundamental concept in text processing is the *collation*, which is a set of rules determining how text values are ordered and compared for equality. For example, while a case-insensitive collation disregards differences between upper- and lower-case letters for the purposes of equality comparison, a case-sensitive collation does not. However, since case-sensitivity is culture-sensitive (e.g. `i` and `I` represent different letters in Turkish), there exist multiple case-insensitive collations, each with its own set of rules. The scope of collations also extends beyond case-sensitivity, to other aspects of character data; in German, for example, it is sometimes (but not always) desirable to treat `ä` and `ae` as identical. Finally, collations also define how text values are *ordered*: while German places `ä` after `a`, Swedish places it at the end of the alphabet.
+
+All text operations in a database use a collation - whether explicitly or implicitly - to determine how the operation compares and orders strings. The actual list of available collations and their naming schemes is database-specific; consult [the section below](#database-specific-information) for links to relevant documentation pages of various databases. Fortunately, databases do generally allow a default collation to be defined at the database or column level, and to explicitly specify which collation should be used for specific operations in a query.
+
+## Database collation
+
+In most database systems, a default collation is defined at the database level; unless overridden, that collation implicitly applies to all text operations occurring within that database. The database collation is typically set at database creation time (via the `CREATE DATABASE` DDL statement), and if not specified, defaults to a some server-level value determined at setup time. For example, the default server-level collation in SQL Server for the "English (United States)" machine locale is `SQL_Latin1_General_CP1_CI_AS`, which is a case-insensitive, accent-sensitive collation. Although database systems usually do permit altering the collation of an existing database, doing so can lead to complications; it is recommended to pick a collation before database creation.
+
+When using EF Core migrations to manage your database schema, the following in your model's `OnModelCreating` method configures a SQL Server database to use a case-sensitive collation:
+
+[!code-csharp[Main](../../../samples/core/Miscellaneous/Collations/Program.cs?name=DatabaseCollation)]
+
+## Column collation
+
+Collations can also be defined on text columns, overriding the database default. This can be useful if certain columns need to be case-insensitive, while the rest of the database needs to be case-sensitive.
+
+When using EF Core migrations to manage your database schema, the following configures the column for the `Name` property to be case-insensitive in a database that is otherwise configured to be case-sensitive:
+
+[!code-csharp[Main](../../../samples/core/Miscellaneous/Collations/Program.cs?name=ColumnCollation)]
+
+## Explicit collation in a query
+
+In some cases, the same column needs to be queried using different collations by different queries. For example, one query may need to perform a case-sensitive comparison on a column, while another may need to perform a case-insensitive comparison on the same column. This can be accomplished by explicitly specifying a collation within the query itself:
+
+[!code-csharp[Main](../../../samples/core/Miscellaneous/Collations/Program.cs?name=SimpleQueryCollation)]
+
+This generates a `COLLATE` clause in the SQL query, which applies a case-sensitive collation regardless of the collation defined at the column or database level:
+
+```sql
+SELECT [c].[Id], [c].[Name]
+FROM [Customers] AS [c]
+WHERE [c].[Name] COLLATE SQL_Latin1_General_CP1_CS_AS = N'John'
+```
+
+### Explicit collations and indexes
+
+Indexes are one of the most important factors in database performance - a query that runs efficiently with an index can grind to a halt without that index. Indexes implicitly inherit the collation of their column; this means that all queries on the column are automatically eligible to use indexes defined on that column - provided that the query doesn't specify a different collation. Specifying an explicit collation in a query will generally prevent that query from using an index defined on that column, since the collations would no longer match; it is therefore recommended to exercise caution when using this feature. It is always preferable to define the collation at the column (or database) level, allowing all queries to implicitly use that collation and benefit from any index.
+
+Note that some databases allow the collation to be defined when creating an index (e.g. PostgreSQL, Sqlite). This allows multiple indexes to be defined on the same column, speeding up operations with different collations (e.g. both case-sensitive and case-insensitive comparisons). Consult your database provider's documentation for more details.
+
+> [!WARNING]
+> Always inspect the query plans of your queries, and make sure the proper indexes are being used in performance-critical queries executing over large amounts of data. Overriding case-sensitivity in a query via `EF.Functions.Collate` (or by calling `string.ToLower`) can have a very significant impact on your application's performance.
+
+## Translation of built-in .NET string operations
+
+In .NET, string equality is case-sensitive by default: `s1 == s2` performs an ordinal comparison that requires the strings to be identical. Because the default collation of databases varies, and because it is desirable for simple equality to use indexes, EF Core makes no attempt to translate simple equality to a database case-sensitive operation: C# equality is translated directly to SQL equality, which may or may not be case-sensitive, depending on the specific database in use and its collation configuration.
+
+In addition, .NET provides overloads of [`string.Equals`](/dotnet/api/system.string.equals) accepting a [`StringComparison`](/dotnet/api/system.stringcomparison) enum, which allows specifying case-sensitivity and a culture for the comparison. By design, EF Core refrains from translating these overloads to SQL, and attempting to use them will result in an exception. For one thing, EF Core does not know which case-sensitive or case-insensitive collation should be used. More importantly, applying a collation would in most cases prevent index usage, significantly impacting performance for a very basic and commonly-used .NET construct. To force a query to use case-sensitive or case-insensitive comparison, specify a collation explicitly via `EF.Functions.Collate` as [detailed above](#explicit-collations-and-indexes).
+
+## Additional resources
+
+### Database-specific information
+
+* [SQL Server documentation on collations](/sql/relational-databases/collations/collation-and-unicode-support).
+* [Microsoft.Data.Sqlite documentation on collations](/dotnet/standard/data/sqlite/collation).
+* [PostgreSQL documentation on collations](https://www.postgresql.org/docs/current/collation.html).
+* [MySQL documentation on collations](https://dev.mysql.com/doc/refman/en/charset-general.html).
+
+### Other resources
+
+* [.NET Data Community Standup session](https://www.youtube.com/watch?v=OgMhLVa_VfA&list=PLdo4fOcmZ0oX-DBuRG4u58ZTAJgBAeQ-t&index=1), introducing collations and exploring perf and indexing aspects.
diff --git a/entity-framework/core/miscellaneous/connection-resiliency.md b/entity-framework/core/miscellaneous/connection-resiliency.md
new file mode 100644
index 0000000000..79072409ed
--- /dev/null
+++ b/entity-framework/core/miscellaneous/connection-resiliency.md
@@ -0,0 +1,111 @@
+---
+title: Connection Resiliency - EF Core
+description: Using connection resiliency to automatically retry failed commands with Entity Framework Core
+author: AndriySvyryd
+ms.date: 11/15/2016
+uid: core/miscellaneous/connection-resiliency
+---
+
+# Connection Resiliency
+
+Connection resiliency automatically retries failed database commands. The feature can be used with any database by supplying an "execution strategy", which encapsulates the logic necessary to detect failures and retry commands. EF Core providers can supply execution strategies tailored to their specific database failure conditions and optimal retry policies.
+
+As an example, the SQL Server provider includes an execution strategy that is specifically tailored to SQL Server (including SQL Azure). It is aware of the exception types that can be retried and has sensible defaults for maximum retries, delay between retries, etc.
+
+An execution strategy is specified when configuring the options for your context. This is typically in the `OnConfiguring` method of your derived context:
+
+[!code-csharp[Main](../../../samples/core/Miscellaneous/ConnectionResiliency/Program.cs#OnConfiguring)]
+
+or in `Startup.cs` for an ASP.NET Core application:
+
+```csharp
+public void ConfigureServices(IServiceCollection services)
+{
+    services.AddDbContext<PicnicContext>(
+        options => options.UseSqlServer(
+            "<connection string>",
+            providerOptions => providerOptions.EnableRetryOnFailure()));
+}
+```
+
+> [!NOTE]
+> Enabling retry on failure causes EF to internally buffer the resultset, which may significantly increase memory requirements for queries returning large resultsets. See [buffering and streaming](xref:core/performance/efficient-querying#buffering-and-streaming) for more details.
+
+## Custom execution strategy
+
+There is a mechanism to register a custom execution strategy of your own if you wish to change any of the defaults.
+
+```csharp
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+{
+    optionsBuilder
+        .UseMyProvider(
+            "<connection string>",
+            options => options.ExecutionStrategy(...));
+}
+```
+
+## Execution strategies and transactions
+
+An execution strategy that automatically retries on failures needs to be able to play back each operation in a retry block that fails. When retries are enabled, each operation you perform via EF Core becomes its own retriable operation. That is, each query and each call to `SaveChangesAsync()` will be retried as a unit if a transient failure occurs.
+
+However, if your code initiates a transaction using `BeginTransactionAsync()` you are defining your own group of operations that need to be treated as a unit, and everything inside the transaction would need to be played back if a failure occurs. You will receive an exception like the following if you attempt to do this when using an execution strategy:
+
+> InvalidOperationException: The configured execution strategy 'SqlServerRetryingExecutionStrategy' does not support user-initiated transactions. Use the execution strategy returned by 'DbContext.Database.CreateExecutionStrategy()' to execute all the operations in the transaction as a retriable unit.
+
+The solution is to manually invoke the execution strategy with a delegate representing everything that needs to be executed. If a transient failure occurs, the execution strategy will invoke the delegate again.
+
+[!code-csharp[Main](../../../samples/core/Miscellaneous/ConnectionResiliency/Program.cs#ManualTransaction)]
+
+This approach can also be used with ambient transactions.
+
+[!code-csharp[Main](../../../samples/core/Miscellaneous/ConnectionResiliency/Program.cs#AmbientTransaction)]
+
+## Transaction commit failure and the idempotency issue
+
+In general, when there is a connection failure the current transaction is rolled back. However, if the connection is dropped while the transaction is being committed the resulting state of the transaction is unknown.
+
+By default, the execution strategy will retry the operation as if the transaction was rolled back, but if it's not the case this will result in an exception if the new database state is incompatible or could lead to **data corruption** if the operation does not rely on a particular state, for example when inserting a new row with auto-generated key values.
+
+There are several ways to deal with this.
+
+### Option 1 - Do (almost) nothing
+
+The likelihood of a connection failure during transaction commit is low so it may be acceptable for your application to just fail if this condition actually occurs.
+
+However, you need to avoid using store-generated keys in order to ensure that an exception is thrown instead of adding a duplicate row. Consider using a client-generated GUID value or a client-side value generator.
+
+### Option 2 - Rebuild application state
+
+1. Discard the current `DbContext`.
+2. Create a new `DbContext` and restore the state of your application from the database.
+3. Inform the user that the last operation might not have been completed successfully.
+
+### Option 3 - Add state verification
+
+For most of the operations that change the database state it is possible to add code that checks whether it succeeded. EF provides an extension method to make this easier - `IExecutionStrategy.ExecuteInTransaction`.
+
+This method begins and commits a transaction and also accepts a function in the `verifySucceeded` parameter that is invoked when a transient error occurs during the transaction commit.
+
+[!code-csharp[Main](../../../samples/core/Miscellaneous/ConnectionResiliency/Program.cs#Verification)]
+
+> [!NOTE]
+> Here `SaveChanges` is invoked with `acceptAllChangesOnSuccess` set to `false` to avoid changing the state of the `Blog` entity to `Unchanged` if `SaveChanges` succeeds. This allows to retry the same operation if the commit fails and the transaction is rolled back.
+
+### Option 4 - Manually track the transaction
+
+If you need to use store-generated keys or need a generic way of handling commit failures that doesn't depend on the operation performed each transaction could be assigned an ID that is checked when the commit fails.
+
+1. Add a table to the database used to track the status of the transactions.
+2. Insert a row into the table at the beginning of each transaction.
+3. If the connection fails during the commit, check for the presence of the corresponding row in the database.
+4. If the commit is successful, delete the corresponding row to avoid the growth of the table.
+
+[!code-csharp[Main](../../../samples/core/Miscellaneous/ConnectionResiliency/Program.cs#Tracking)]
+
+> [!NOTE]
+> Make sure that the context used for the verification has an execution strategy defined as the connection is likely to fail again during verification if it failed during transaction commit.
+
+## Additional resources
+
+* [Troubleshoot transient connection errors in Azure SQL Database and SQL Managed Instance](/azure/azure-sql/database/troubleshoot-common-connectivity-issues)
diff --git a/entity-framework/core/miscellaneous/connection-strings.md b/entity-framework/core/miscellaneous/connection-strings.md
new file mode 100644
index 0000000000..29995850a9
--- /dev/null
+++ b/entity-framework/core/miscellaneous/connection-strings.md
@@ -0,0 +1,125 @@
+---
+title: Connection Strings - EF Core
+description: Managing connection strings under different environments with Entity Framework Core
+author: SamMonoRT
+ms.date: 10/27/2016
+uid: core/miscellaneous/connection-strings
+ms.custom: sfi-ropc-nochange
+---
+# Connection Strings
+
+Most database providers require a connection string to connect to the database. The connection string:
+
+* Can contain sensitive information that needs to be protected.
+* May need to change when the app moves to different environments, such as development, testing, and production.
+
+For more information, see [Secure authentication flows](/aspnet/core/security/#secure-authentication-flows)
+
+## ASP.NET Core
+
+The ASP.NET Core configuration can store connection strings with various providers:
+
+* In the `appsettings.Development.json` or `appsettings.json` file.
+* In an environment variable
+* Using [Azure Key Vault](/azure/key-vault/keys/quick-create-net)
+* Using the [Secret Manager tool](/aspnet/core/security/app-secrets#secret-manager)
+
+> [!WARNING]
+> Secrets should never be added to configuration files.
+
+For example, the [Secret Manager tool](/aspnet/core/security/app-secrets#secret-manager) can store the database password. When scaffolding and using Secret manager, a connection string consists of `Name=<database-alias>`.
+
+See the [Configuration section of the ASP.NET Core documentation](/aspnet/core/fundamentals/configuration) for more information.
+
+```dotnetcli
+dotnet user-secrets init
+dotnet user-secrets set ConnectionStrings:YourDatabaseAlias "Data Source=(localdb)\MSSQLLocalDB;Initial Catalog=YourDatabase"
+```
+
+Then, in scaffolding, use a connection string that consists of `Name=<database-alias>`.
+
+### [.NET CLI](#tab/dotnet-core-cli)
+
+```dotnetcli
+dotnet ef dbcontext scaffold Name=ConnectionStrings:YourDatabaseAlias Microsoft.EntityFrameworkCore.SqlServer
+```
+
+### [Visual Studio PMC](#tab/vs)
+
+```powershell
+Scaffold-DbContext 'Name=ConnectionStrings:YourDatabaseAlias' Microsoft.EntityFrameworkCore.SqlServer
+```
+
+***
+
+[!INCLUDE [managed-identities-test-non-production](~/core/includes/managed-identities-test-non-production.md)]
+
+The following example shows the connection string stored in `appsettings.json`.
+
+```json
+{
+  "ConnectionStrings": {
+    "BloggingDatabase": "Server=(localdb)\\mssqllocaldb;Database=EFGetStarted.ConsoleApp.NewDb;Trusted_Connection=True;"
+  },
+}
+```
+
+The context is typically configured in `Program.cs` with the connection string being read from configuration. Note the [GetConnectionString](/dotnet/api/microsoft.extensions.configuration.configurationextensions.getconnectionstring) method looks for a configuration value whose key is `ConnectionStrings:<connection string name>`. `GetConnectionString` requires the [Microsoft.Extensions.Configuration](/dotnet/api/microsoft.extensions.configuration) namespace.
+
+```csharp
+var conString = builder.Configuration.GetConnectionString("BloggingContext") ??
+     throw new InvalidOperationException("Connection string 'BloggingContext'" +
+    " not found.");
+builder.Services.AddDbContext<BloggingContext>(options =>
+    options.UseSqlServer(conString));
+```
+
+## WinForms & WPF Applications
+
+WinForms, WPF, and ASP.NET 4 applications have a tried and tested connection string pattern. The connection string should be added to your application's `App.config` file, or `Web.config` when using ASP.NET. Connection string containing sensitive information, such as username and password, should protect the contents of the configuration file using [Protected Configuration](/dotnet/framework/data/adonet/connection-strings-and-configuration-files#encrypting-configuration-file-sections-using-protected-configuration).
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<configuration>
+
+  <connectionStrings>
+    <add name="BloggingDatabase"
+         connectionString="Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;" />
+  </connectionStrings>
+</configuration>
+```
+
+> [!TIP]
+> The `providerName` setting is not required on EF Core connection strings stored in App.config because the database provider is configured via code.
+
+You can then read the connection string using the `ConfigurationManager` API in your context's `OnConfiguring` method. You may need to add a reference to the `System.Configuration` framework assembly to be able to use this API.
+
+```csharp
+public class BloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+      optionsBuilder.UseSqlServer(ConfigurationManager.ConnectionStrings["BloggingDatabase"].ConnectionString);
+    }
+}
+```
+
+## Universal Windows Platform (UWP)
+
+Connection strings in a UWP application are typically a SQLite connection that just specifies a local filename. They typically don't contain sensitive information, and don't need to be changed as an application is deployed. As such, these connection strings are usually fine to be left in code, as shown below. If you wish to move them out of code then UWP supports the concept of settings, see the [App Settings section of the UWP documentation](/windows/uwp/app-settings/store-and-retrieve-app-data) for details.
+
+```csharp
+public class BloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+            optionsBuilder.UseSqlite("Data Source=blogging.db");
+    }
+}
+```
diff --git a/entity-framework/core/miscellaneous/dependency-injection.md.stub b/entity-framework/core/miscellaneous/dependency-injection.md.stub
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/entity-framework/core/miscellaneous/internals/diagrams/generate.cmd b/entity-framework/core/miscellaneous/internals/diagrams/generate.cmd
new file mode 100644
index 0000000000..dc7883555f
--- /dev/null
+++ b/entity-framework/core/miscellaneous/internals/diagrams/generate.cmd
@@ -0,0 +1,2 @@
+:: npm install -g @mermaid-js/mermaid-cli
+FOR %%f IN (*.mmd) DO mmdc -i %%f -o %%~nf.png
diff --git a/entity-framework/core/miscellaneous/internals/diagrams/tools-cli.mmd b/entity-framework/core/miscellaneous/internals/diagrams/tools-cli.mmd
new file mode 100644
index 0000000000..37dfe69c26
--- /dev/null
+++ b/entity-framework/core/miscellaneous/internals/diagrams/tools-cli.mmd
@@ -0,0 +1,3 @@
+flowchart
+    read[/Read project metadata/] --> build
+    build[Build startup project] --> ef.exe
diff --git a/entity-framework/core/miscellaneous/internals/diagrams/tools-cli.png b/entity-framework/core/miscellaneous/internals/diagrams/tools-cli.png
new file mode 100644
index 0000000000..7031eba45f
Binary files /dev/null and b/entity-framework/core/miscellaneous/internals/diagrams/tools-cli.png differ
diff --git a/entity-framework/core/miscellaneous/internals/diagrams/tools-overview.mmd b/entity-framework/core/miscellaneous/internals/diagrams/tools-overview.mmd
new file mode 100644
index 0000000000..f50499e834
--- /dev/null
+++ b/entity-framework/core/miscellaneous/internals/diagrams/tools-overview.mmd
@@ -0,0 +1,4 @@
+flowchart
+    dotnet-ef --> ef.exe
+    pmc[PMC Tools] --> ef.exe
+    ef.exe --> EFCore.Design.dll
\ No newline at end of file
diff --git a/entity-framework/core/miscellaneous/internals/diagrams/tools-overview.png b/entity-framework/core/miscellaneous/internals/diagrams/tools-overview.png
new file mode 100644
index 0000000000..176d321d53
Binary files /dev/null and b/entity-framework/core/miscellaneous/internals/diagrams/tools-overview.png differ
diff --git a/entity-framework/core/miscellaneous/internals/diagrams/tools-pmc.mmd b/entity-framework/core/miscellaneous/internals/diagrams/tools-pmc.mmd
new file mode 100644
index 0000000000..467a1ba07d
--- /dev/null
+++ b/entity-framework/core/miscellaneous/internals/diagrams/tools-pmc.mmd
@@ -0,0 +1,4 @@
+flowchart
+    read[/Read project metadata/] --> build
+    build[Build startup project] --> ef.exe
+    ef.exe --> open[Open files]
diff --git a/entity-framework/core/miscellaneous/internals/diagrams/tools-pmc.png b/entity-framework/core/miscellaneous/internals/diagrams/tools-pmc.png
new file mode 100644
index 0000000000..52290f60dc
Binary files /dev/null and b/entity-framework/core/miscellaneous/internals/diagrams/tools-pmc.png differ
diff --git a/entity-framework/core/miscellaneous/internals/index.md b/entity-framework/core/miscellaneous/internals/index.md
new file mode 100644
index 0000000000..8530230247
--- /dev/null
+++ b/entity-framework/core/miscellaneous/internals/index.md
@@ -0,0 +1,30 @@
+---
+title: Architecture - EF Core
+description: The internal architecture of Entity Framework Core
+author: SamMonoRT
+ms.date: 11/27/2023
+uid: core/miscellaneous/internals/index
+---
+# EF Core Architecture
+
+In 2010, Scott Hanselman associated Entity Framework with a magic unicorn. That's because there's a lot of magic going on behind the scenes that users generally doesn't have to think about. If you've ever wondered how some of that magic works, these docs are for you. They cover the architecture and implementation details of various parts of EF Core.
+
+## Articles
+
+Here are the articles we've written so far. Use issue [#1920](https://github.com/dotnet/EntityFramework.Docs/issues/1920) to let us know what else you'd like to see!
+
+- [Design-time tools](xref:core/miscellaneous/internals/tools)
+
+## Community Standup
+
+The EF team produces community standup videos, where we discuss various aspects of .NET and data access. Some of these have explored EF internals, and can be a good way to understand the general architecture of EF.
+
+- [How to Add a Feature to EF Core](https://www.youtube.com/watch?v=9OMxy1wal1s&list=PLdo4fOcmZ0oX0ObHwBrJ0vJpZ7PiYMqeA)
+- [Internal Dependency Injection](https://www.youtube.com/watch?v=pYhe-Mt0HzI&list=PLdo4fOcmZ0oX0ObHwBrJ0vJpZ7PiYMqeA)
+- [DbContext Configuration and Lifetime](https://www.youtube.com/watch?v=NPgFlqXPbK8&list=PLdo4fOcmZ0oX0ObHwBrJ0vJpZ7PiYMqeA)
+- [IQueryable, LINQ and the EF Core query pipeline](https://www.youtube.com/watch?v=1Ld3dtnTrMw&list=PLdo4fOcmZ0oX0ObHwBrJ0vJpZ7PiYMqeA)
+- [Model Building](https://www.youtube.com/watch?v=FYz0rAxQkC8&list=PLdo4fOcmZ0oX0ObHwBrJ0vJpZ7PiYMqeA)
+
+## See also
+
+- [ASP.NET Core Architecture Series](https://www.youtube.com/playlist?list=PLdo4fOcmZ0oUDW57sHWGT9Cfp9lAEx3lU)
diff --git a/entity-framework/core/miscellaneous/internals/tools.md b/entity-framework/core/miscellaneous/internals/tools.md
new file mode 100644
index 0000000000..56b7dc40b0
--- /dev/null
+++ b/entity-framework/core/miscellaneous/internals/tools.md
@@ -0,0 +1,127 @@
+---
+title: Design-time Tools Architecture - EF Core
+description: The architecture of design-time tools in Entity Framework Core
+author: SamMonoRT
+ms.date: 01/17/2025
+uid: core/miscellaneous/internals/tools
+---
+# Design-time Tools Architecture
+
+The design-time tools are the part of EF that bootstrap design-time operations such as scaffolding a model or managing migrations. They are responsible for instantiating DbContext objects for use at design time.
+
+![Mermaid diagram of the high-level tools flow.](diagrams/tools-overview.png)
+
+There are two primary entry points: dotnet-ef and the NuGet Package Manager Console (PMC) EF Core tools. Both of these are responsible for gathering information about the user's projects, compiling them, then calling ef.exe which eventually calls the design-time entry points inside EFCore.Design.dll.
+
+## dotnet-ef
+
+dotnet-ef is a [.NET Tool](/dotnet/core/tools/global-tools-how-to-create). The dotnet- prefix allows it to be invoked as part of the main dotnet command: `dotnet ef`.
+
+There are two primary inputs to this command: the startup project and the target project. dotnet-ef is responsible for reading information about these projects then compiling them.
+
+![Mermaid diagram of dotnet-ef flow.](diagrams/tools-cli.png)
+
+It reads information about the projects by injecting an MSBuild .targets file and calling the custom MSBuild target. The .targets file is compiled into dotnet-ef as an embedded resource. The source is located at [src/dotnet-ef/Resources/EntityFrameworkCore.targets](https://github.com/dotnet/efcore/blob/main/src/dotnet-ef/Resources/EntityFrameworkCore.targets).
+
+It has a bit of logic at the beginning to handle multi-targeting projects. Essentially, it just picks the first target framework and re-invokes itself. After a single target framework has been determined, it gets several MSBuild properties like AssemblyName, OutputPath, RootNamespace, etc.
+
+After we've collected the project information, we compile the startup project. We assume that the target project will also be compiled transitively.
+
+Then dotnet-ef invokes ef.exe.
+
+## PMC Tools
+
+The PMC tools perform a similar function as dotnet-ef, but use Visual Studio APIs instead of MSBuild. They ship as the Microsoft.EntityFrameworkCore.Tools package. They are a special VS-aware [PowerShell module](/powershell/scripting/developer/module/writing-a-windows-powershell-module) that automatically gets loaded into the [NuGet Package Manager Console](/nuget/consume-packages/install-use-packages-powershell) via [init.ps1](https://github.com/dotnet/efcore/blob/main/src/EFCore.Tools/tools/init.ps1). Like dotnet-ef, each command take two primary inputs: the startup project and the target project. But the default values from these are taken from the IDE. The target project defaults to the project specified as the **Default project** inside the Package Manager Console. The startup project defaults to the one specified as the startup project (via **Set as Startup Project**) in Solution Explorer.
+
+![Mermaid diagram of PMC Tools flow.](diagrams/tools-pmc.png)
+
+The PMC tools gather information about the projects via the [EnvDTE](/dotnet/api/envdte.dte) APIs whenever possible. Occasionally, it needs to drop down to the [Common Project System](https://github.com/microsoft/VSProjectSystem) (CPS) or MSBuild APIs. The modern C# project system implementation source is available under the [dotnet/project-system](https://github.com/dotnet/project-system) project on GitHub.
+
+After collecting the information, it builds the entire solution.
+
+> [!TIP]
+> Issue [#9716](https://github.com/dotnet/efcore/issues/9716) is about updating it to only build the startup project.
+
+Then, like dotnet-ef, it invokes ef.exe. The PMC Tools have a bit of extra logic after invoking ef.exe to open any files created by a command to provide a more integrated experience.
+
+## ef.exe
+
+Sometimes referred to as the inside man, ef.exe (for lack of a better name) ships as part of both dotnet-ef and the PMC Tools as a set of binaries. There are various binaries for different target frameworks and platforms.
+
+* tools/
+  * net461/
+    * any/
+      * **ef.exe**
+    * win-x86/
+      * **ef.exe**
+    * win-arm64/
+      * **ef.exe**
+  * netcoreapp2.0/
+    * any/
+      * **ef.dll**
+
+The .NET Framework assemblies are only invoked for EF Core 3.1 projects and earlier targeting .NET Framework. By design, you can use the latest version of the tools on projects that use older versions of EF. There is no x64 because the assembly under the any directory targets the AnyCPU platform which runs as x64 on both x64 and arm64 versions of Windows.
+
+The .NET Core 2.0 assembly is used for projects targeting .NET Core or .NET 5 and newer.
+
+The primary responsibility of ef.exe is to load the startup project's output assembly and invoke the design-time entry points inside EFCore.Design.dll.
+
+On .NET Framework, we use a separate AppDomain to load the project assembly passing the project's App/Web.config file to honor and binding redirects added by NuGet or the user.
+
+On .NET Core/5+, we invoke ef.dll using the project's .deps.json and .runtimeconfig.json files to emulate the project's actual runtime and assembly loading behavior.
+
+```dotnetcli
+dotnet exec ef.dll --depsfile startupProject.deps.json --runtimeconfig startupProject.runtimeconfig.json
+```
+
+> [!TIP]
+> Issue [#18840](https://github.com/dotnet/efcore/issues/18840) is primarily about using [AssemblyLoadContext](/dotnet/core/dependency-loading/understanding-assemblyloadcontext) instead of `dotnet exec` to load the user's assembly. This should enable the tools to work with more project types including those targeting Android and iOS.
+
+After everything is set up to be loaded, ef.exe calls into EFCore.Design.dll via reflection and Activator.CreateInstance (or AppDomain.CreateInstance on .NET Framework).
+
+## EFCore.Design.dll
+
+EFCore.Design.dll, or more accurately, Microsoft.EntityFrameworkCore.Design.dll contains all the design-time logic for EF Core. All the entry points are inside the [OperationExecutor](https://github.com/dotnet/efcore/blob/main/src/EFCore.Design/Design/OperationExecutor.cs) class. A lot of the strangeness in the design of this class (MarshallByRefObject, nested types, etc.) stems from needing to invoke it across AppDomains on .NET Framework. A lot could be simplified if this requirement was removed. All of the signatures are weakly typed to enable both forward and backwards compatibility with the tools. Remember that different versions of the tools can be used to invoke projects using different versions of EF.
+
+In addition to the executor, [DbContextActivator](https://github.com/dotnet/efcore/blob/main/src/EFCore.Design/Design/DbContextActivator.cs) is another important type in this assembly. It's used by some of the ASP.NET Web Tools components to instantiate a user's DbContext at design time.
+
+### Creating a DbContext
+
+Before any specific design-time logic runs, a DbContext instance is typically required. The user can specify a simple or fully-qualified, case-insensitive type name for the DbContext, or they can not specify one if there is only a single DbContext type. Either way, we need to discover all the DbContext types before we narrow it down to a single one. The logic for discovering DbContext types live in the FindContextTypes method of [DbContextOperations](https://github.com/dotnet/efcore/blob/main/src/EFCore.Design/Design/Internal/DbContextOperations.cs).
+
+We look for DbContext types using various sources.
+
+* Referenced by IDesignTimeDbContextFactory\<T> implementations in the startup assembly.
+* DbContexts added to the application service provider. To get a list of all context types, we get everything registered as `DbContextOptions` and look at the ContextType property. (See below for how we get the application service provider.)
+* Types derived from DbContext in both the startup and target assemblies
+
+We also use various ways of instantiating the type. Here they are in order of precedence.
+
+1. Using an IDesignTimeDbContextFactory\<T> implementation
+2. Using an IDbContextFactory\<T> from the application service provider
+3. Using ActivatorUtilities.CreateInstance
+
+### Finding application services
+
+For the hightest fidelity to runtime behavior, we try to get the DbContext instance directly from the application service provider. We share this logic with the ASP.NET Core tooling. It's maintained as part of [dotnet/runtime](https://github.com/dotnet/runtime) project on GitHub under the [Microsoft.Extensions.HostFactoryResolver](https://github.com/dotnet/runtime/tree/main/src/libraries/Microsoft.Extensions.HostFactoryResolver) directory.
+
+In a nutshell, here are some of the strategies it uses.
+
+* Look for a method named BuildWebHost, CreateWebHostBuilder, or CreateHostBuilder next to the assembly entry point
+  * Build the host and get the services from the Services property
+* Call the assembly entry point
+  * Intercept the services while building the host and terminate before actually starting the host
+
+### Design-time services
+
+In addition to the application services and the internal DbContext services, there is a third set of [design-time services](xref:core/cli/services). These aren't added to internal service provider since they're never needed at runtime. The design-time services are built by [DesignTimeServicesBuilder](https://github.com/dotnet/efcore/blob/main/src/EFCore.Design/Design/Internal/DesignTimeServicesBuilder.cs). There are two main paths--one with a context instance and one without. The one without is primarily used when scaffolding a new DbContext. There are several extensibility points here to allow the user, providers, and extensions to override and customize the services.
+
+The user can customize services by adding an implementation of `IDesignTimeServices` to the startup assembly.
+
+Providers can customize services by adding the `DesignTimeProviderServices` attribute to their assembly. This points to an implementation of IDesignTimeServices.
+
+Extensions can customize services by adding `DesignTimeServicesReference` attributes to the target or startup assembly. If the attribute specifies a provider, it will only be added when that provider is in use.
+
+### Logging and exceptions
+
+After instantiating the DbContext, we wire up its logging to the tool's output. This enables output to be generated from the runtime. Any unhandled exceptions will also be written to the output. There is a special exception type `OperationException` that can be thrown to gracefully terminate the tools and show a simple error message without a stack trace.
diff --git a/entity-framework/core/miscellaneous/multitenancy.md b/entity-framework/core/miscellaneous/multitenancy.md
new file mode 100644
index 0000000000..44e0fdbca8
--- /dev/null
+++ b/entity-framework/core/miscellaneous/multitenancy.md
@@ -0,0 +1,120 @@
+---
+title: Multi-tenancy - EF Core
+description: Learn several ways to implement multi-tenant databases using Entity Framework Core.
+author: jeremylikness
+ms.author: jeliknes
+ms.date: 03/01/2022
+uid: core/miscellaneous/multitenancy
+---
+# Multi-tenancy
+
+Many line of business applications are designed to work with multiple customers. It is important to secure the data so that customer data isn't "leaked" or seen by other customers and potential competitors. These applications are classified as "multi-tenant" because each customer is considered a tenant of the application with their own set of data.
+
+[!INCLUDE [managed-identities-test-non-production](~/core/includes/managed-identities-test-non-production.md)]
+
+> [!IMPORTANT]
+> This document provides examples and solutions "as is." These are not intended to be "best practices" but rather "working practices" for your consideration.
+
+> [!TIP]
+> You can view the source code for this [sample on GitHub](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/Multitenancy)
+
+## Supporting multi-tenancy
+
+There are many approaches to implementing multi-tenancy in applications. One common approach (that is sometimes a requirement) is to keep data for each customer in a separate database. The schema is the same but the data is customer-specific. Another approach is to partition the data in an existing database by customer. This can be done by using a column in a table, or having a table in multiple schemas with a schema for each tenant.
+
+|Approach|Column for Tenant?|Schema per Tenant?|Multiple Databases?|EF Core Support|
+|:--:|:--:|:--:|:--:|:--:|
+|Discriminator (column)|Yes|No|No|Global query filter|
+|Database per tenant|No|No|Yes|Configuration|
+|Schema per tenant|No|Yes|No|Not supported|
+
+For the database-per-tenant approach, switching to the right database is as simple as providing the correct connection string. When the data is stored in a single database, a [global query filter](/ef/core/querying/filters) can be used to automatically filter rows by the tenant ID column, ensuring that developers don't accidentally write code that can access data from other customers.
+
+These examples should work fine in most app models, including console, WPF, WinForms, and ASP.NET Core apps. Blazor Server apps require special consideration.
+
+### Blazor Server apps and the life of the factory
+
+The recommended pattern for [using Entity Framework Core in Blazor apps](/aspnet/core/blazor/blazor-server-ef-core) is to register the [DbContextFactory](/ef/core/dbcontext-configuration/#using-a-dbcontext-factory-eg-for-blazor), then call it to create a new instance of the `DbContext` each operation. By default, the factory is a _singleton_ so only one copy exists for all users of the application. This is usually fine because although the factory is shared, the individual `DbContext` instances are not.
+
+For multi-tenancy, however, the connection string may change per user. Because the factory caches the configuration with the same lifetime, this means all users must share the same configuration. Therefore, the lifetime should be changed to `Scoped`.
+
+This issue doesn't occur in Blazor WebAssembly apps because the singleton is scoped to the user. Blazor Server apps, on the other hand, present a unique challenge. Although the app is a web app, it is "kept alive" by real-time communication using SignalR. A session is created per user and lasts beyond the initial request. A new factory should be provided per user to allow new settings. The lifetime for this special factory is scoped and a new instance is created per user session.
+
+## An example solution (single database)
+
+A possible solution is to create a simple `ITenantService` service that handles setting the user's current tenant. It provides callbacks so code is notified when the tenant changes. The implementation (with the callbacks omitted for clarity) might look like this:
+
+:::code language="csharp" source="../../../samples/core/Miscellaneous/Multitenancy/Common/ITenantService.cs":::
+
+The `DbContext` can then manage the multi-tenancy. The approach depends on your database strategy. If you are storing all tenants in a single database, you are likely going to use a query filter. The `ITenantService` is passed to the constructor via dependency injection and used to resolve and store the tenant identifier.
+
+:::code language="csharp" source="../../../samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Data/ContactContext.cs" range="11-14":::
+
+The `OnModelCreating` method is overridden to specify the query filter:
+
+:::code language="csharp" source="../../../samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Data/ContactContext.cs" range="32-34":::
+
+This ensures that every query is filtered to the tenant on every request. There is no need to filter in application code because the global filter will be automatically applied.
+
+The tenant provider and `DbContextFactory` are configured in the application startup like this, using Sqlite as an example:
+
+:::code language="csharp" source="../../../samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Program.cs" range="13-14":::
+
+Notice that the [service lifetime](/dotnet/core/extensions/dependency-injection#service-lifetimes) is configured with `ServiceLifetime.Scoped`. This enables it to take a dependency on the tenant provider.
+
+> [!NOTE]
+> Dependencies must always flow towards the singleton. That means a `Scoped` service can depend on another `Scoped` service or a `Singleton` service, but a `Singleton` service can only depend on other `Singleton` services: `Transient => Scoped => Singleton`.
+
+## Multiple schemas
+
+> [!WARNING]
+> This scenario is not directly supported by EF Core and is not a recommended solution.
+
+In a different approach, the same database may handle `tenant1` and `tenant2` by using table schemas.
+
+- **Tenant1** - `tenant1.CustomerData`
+- **Tenant2** - `tenant2.CustomerData`
+
+If you are not using EF Core to handle database updates with migrations and already have multi-schema tables, you can override the schema in a `DbContext` in `OnModelCreating` like this (the schema for table `CustomerData` is set to the tenant):
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder) =>
+    modelBuilder.Entity<CustomerData>().ToTable(nameof(CustomerData), tenant);
+```
+
+## Multiple databases and connection strings
+
+The multiple database version is implemented by passing a different connection string for each tenant. This can be configured at startup by resolving the service provider and using it to build the connection string. A connection string by tenant section is added to the `appsettings.json` configuration file.  
+
+:::code language="json" source="../../../samples/core/Miscellaneous/Multitenancy/MultiDb/appsettings.json":::
+
+The service and configuration are both injected into the `DbContext`:
+
+:::code language="csharp" source="../../../samples/core/Miscellaneous/Multitenancy/MultiDb/ContactContext.cs" range="11-19":::
+
+The tenant is then used to look up the connection string in `OnConfiguring`:
+
+:::code language="csharp" source="../../../samples/core/Miscellaneous/Multitenancy/MultiDb/ContactContext.cs" range="40-45":::
+
+This works fine for most scenarios unless the user can switch tenants during the same session.
+
+### Switching tenants
+
+In the previous configuration for multiple databases, the options are cached at the `Scoped` level. This means that if the user changes the tenant, the options are _not_ reevaluated and so the tenant change isn't reflected in queries.
+
+The easy solution for this when the tenant _can_ change is to set the lifetime to `Transient.` This ensures the tenant is re-evaluated along with the connection string each time a `DbContext` is requested. The user can switch tenants as often as they like. The following table helps you choose which lifetime makes the most sense for your factory.
+
+|**Scenario**|**Single database**|**Multiple databases**|
+|:--|:--|:--|
+|_User stays in a single tenant_|`Scoped`|`Scoped`|
+|_User can switch tenants_|`Scoped`|`Transient`|
+
+The default of `Singleton` still makes sense if your database does not take on user-scoped dependencies.
+
+## Performance notes
+
+EF Core was designed so that `DbContext` instances can be instantiated quickly with as little overhead as possible. For that reason, creating a new `DbContext` per operation should usually be fine. If this approach is impacting the performance of your application, consider using [DbContext pooling](xref:core/performance/advanced-performance-topics).
+
+## Conclusion
+
+This is working guidance for implementing multi-tenancy in EF Core apps. If you have further examples or scenarios or wish to provide feedback, please [open an issue](https://github.com/dotnet/EntityFramework.Docs/issues/new) and reference this document.
diff --git a/entity-framework/core/miscellaneous/nullable-reference-types.md b/entity-framework/core/miscellaneous/nullable-reference-types.md
new file mode 100644
index 0000000000..5c000b5f22
--- /dev/null
+++ b/entity-framework/core/miscellaneous/nullable-reference-types.md
@@ -0,0 +1,114 @@
+---
+title: Working with nullable reference types - EF Core
+description: Working with C# nullable reference types when using Entity Framework Core
+author: roji
+ms.date: 09/09/2019
+uid: core/miscellaneous/nullable-reference-types
+---
+# Working with Nullable Reference Types
+
+C# [nullable reference types (NRT)](/dotnet/csharp/tutorials/nullable-reference-types) allow reference types to be annotated, indicating whether it is valid for them to contain `null` or not. If you are new to this feature, it is recommended that you make yourself familiar with it by reading the C# docs. Nullable reference types are enabled by default in new project templates, but remain disabled in existing projects unless explicitly opted into.
+
+This page introduces EF Core's support for nullable reference types, and describes best practices for working with them.
+
+## Required and optional properties
+
+The main documentation on required and optional properties and their interaction with nullable reference types is the [Required and Optional Properties](xref:core/modeling/entity-properties#required-and-optional-properties) page. It is recommended you start out by reading that page first.
+
+> [!NOTE]
+> Exercise caution when enabling nullable reference types on an existing project: reference type properties which were previously configured as optional will now be configured as required, unless they are explicitly annotated to be nullable. When managing a relational database schema, this may cause migrations to be generated which alter the database column's nullability.
+
+## Non-nullable properties and initialization
+
+When nullable reference types are enabled, the C# compiler emits warnings for any uninitialized non-nullable property, as these would contain `null`. As a result, the following, common way of writing entity types cannot be used:
+
+```csharp
+public class Customer
+{
+    public int Id { get; set; }
+
+    // Generates CS8618, uninitialized non-nullable property:
+    public string Name { get; set; }
+}
+```
+
+If you're using C# 11 or above, [required members](/dotnet/csharp/whats-new/csharp-11#required-members) provide the perfect solution to this problem:
+
+```csharp
+public required string Name { get; set; }
+```
+
+The compiler now guarantees that when your code instantiates a Customer, it always initializes its Name property. And since the database column mapped to the property is non-nullable, any instances loaded by EF always contain a non-null Name as well.
+
+If you're using an older version of C#, [Constructor binding](xref:core/modeling/constructors) is an alternative technique to ensure that your non-nullable properties are initialized:
+
+[!code-csharp[Main](../../../samples/core/Miscellaneous/NullableReferenceTypes/CustomerWithConstructorBinding.cs?name=CustomerWithConstructorBinding&highlight=6-9)]
+
+Unfortunately, in some scenarios constructor binding isn't an option; navigation properties, for example, cannot be initialized in this way. In those cases, you can simply initialize the property to `null` with the help of the null-forgiving operator (but see below for more details):
+
+[!code-csharp[Main](../../../samples/core/Miscellaneous/NullableReferenceTypes/Order.cs?range=19)]
+
+### Required navigation properties
+
+Required navigation properties present an additional difficulty: although a dependent will always exist for a given principal, it may or may not be loaded by a particular query, depending on the needs at that point in the program ([see the different patterns for loading data](xref:core/querying/related-data)). At the same time, it may be undesirable to make these properties nullable, since that would force all access to them to check for `null`, even when the navigation is known to be loaded and therefore cannot be `null`.
+
+This isn't necessarily a problem! As long as a required dependent is properly loaded (e.g. via `Include`), accessing its navigation property is guaranteed to always return non-null. On the other hand, the application may choose to check whether or not the relationship is loaded by checking if the navigation is `null`. In such cases, it is reasonable to make the navigation nullable. This means that required navigations from the dependent to the principal:
+
+- Should be non-nullable if it is considered a programmer error to access a navigation when it is not loaded.
+- Should be nullable if it acceptable for application code to check the navigation to determine whether or not the relationship is loaded.
+
+If you'd like a stricter approach, you can have a non-nullable property with a nullable [backing field](xref:core/modeling/backing-field):
+
+[!code-csharp[Main](../../../samples/core/Miscellaneous/NullableReferenceTypes/Order.cs?range=10-17)]
+
+As long as the navigation is properly loaded, the dependent will be accessible via the property. If, however, the property is accessed without first properly loading the related entity, an `InvalidOperationException` is thrown, since the API contract has been used incorrectly.
+
+> [!NOTE]
+> Collection navigations, which contain references to multiple related entities, should always be non-nullable. An empty collection means that no related entities exist, but the list itself should never be `null`.
+
+## DbContext and DbSet
+
+With EF, it's common practice to have uninitialized DbSet properties on context types:
+
+```c#
+public class MyContext : DbContext
+{
+    public DbSet<Customer> Customers { get; set;}
+}
+```
+
+Although this generally causes a compiler warning, EF Core 7.0 and above suppress this warning, since EF automatically initializes these properties via reflection.
+
+On older version of EF Core, you can work around this problem as follows:
+
+```c#
+public class MyContext : DbContext
+{
+    public DbSet<Customer> Customers => Set<Customer>();
+}
+```
+
+Another strategy is to use non-nullable auto-properties, but to initialize them to `null`, using the null-forgiving operator (!) to silence the compiler warning. The DbContext base constructor ensures that all DbSet properties will get initialized, and null will never be observed on them.
+
+## Navigating and including nullable relationships
+
+When dealing with optional relationships, it's possible to encounter compiler warnings where an actual `null` reference exception would be impossible. When translating and executing your LINQ queries, EF Core guarantees that if an optional related entity does not exist, any navigation to it will simply be ignored, rather than throwing. However, the compiler is unaware of this EF Core guarantee, and produces warnings as if the LINQ query were executed in memory, with LINQ to Objects. As a result, it is necessary to use the null-forgiving operator (!) to inform the compiler that an actual `null` value isn't possible:
+
+```csharp
+var order = await context.Orders
+    .Where(o => o.OptionalInfo!.SomeProperty == "foo")
+    .ToListAsync();
+```
+
+A similar issue occurs when including multiple levels of relationships across optional navigations:
+
+[!code-csharp[Main](../../../samples/core/Miscellaneous/NullableReferenceTypes/Program.cs?name=Including&highlight=2)]
+
+If you find yourself doing this a lot, and the entity types in question are predominantly (or exclusively) used in EF Core queries, consider making the navigation properties non-nullable, and to configure them as optional via the Fluent API or Data Annotations. This will remove all compiler warnings while keeping the relationship optional; however, if your entities are traversed outside of EF Core, you may observe `null` values although the properties are annotated as non-nullable.
+
+## Limitations in older versions
+
+Prior to EF Core 6.0, the following limitations applied:
+
+- The public API surface wasn't annotated for nullability (the public API was "null-oblivious"), making it sometimes awkward to use when the NRT feature is turned on. This notably includes the async LINQ operators exposed by EF Core, such as [FirstOrDefaultAsync](/dotnet/api/microsoft.entityframeworkcore.entityframeworkqueryableextensions.firstordefaultasync). The public API is fully annotated for nullability starting with EF Core 6.0.
+- Reverse engineering did not support [C# 8 nullable reference types (NRTs)](/dotnet/csharp/tutorials/nullable-reference-types): EF Core always generated C# code that assumed the feature is off. For example, nullable text columns were scaffolded as a property with type `string` , not `string?`, with either the Fluent API or Data Annotations used to configure whether a property is required or not. If using an older version of EF Core, you can still edit the scaffolded code and replace these with C# nullability annotations.
diff --git a/entity-framework/core/miscellaneous/platforms.md b/entity-framework/core/miscellaneous/platforms.md
new file mode 100644
index 0000000000..43a590cc1f
--- /dev/null
+++ b/entity-framework/core/miscellaneous/platforms.md
@@ -0,0 +1,56 @@
+---
+title: Supported .NET implementations - EF Core
+description: Information on supported platforms across Entity Framework Core versions
+author: SamMonoRT
+ms.date: 12/13/2022
+uid: core/miscellaneous/platforms
+---
+
+# .NET implementations supported by EF Core
+
+We want EF Core to be available to developers on all modern .NET implementations. EF Core's support on .NET for Windows, Linux, and macOS is covered by automated testing and many applications are known to be using it successfully, other platforms that leverage trimming and ahead-of-time (AoT) compilation like iOS, Wasm, and Unity have some limitations that we are working to address.
+
+Several older .NET implementations are no longer supported. See the sections below for more guidance.
+
+| EF Core           | .NET & .NET Core | .NET Standard | .NET Framework |
+|------------------ | ---------------- | ------------- | -------------- |
+| **9.0**           | 8.0              |               |                |
+| **8.0**           | 8.0              |               |                |
+| ~~**7.0**~~ (EOL) | 6.0              |               |                |
+| ~~**6.0**~~ (EOL) | 6.0              |               |                |
+| ~~**5.0**~~ (EOL) | 5.0              | 2.1           |                |
+| ~~**3.1**~~ (EOL) | 3.1              | 2.0           | 4.7.2          |
+
+## .NET
+
+EF Core is a .NET library. EF Core version versions 8.0 and 9.0 both target .NET version 8.0. In general, we target the latest [LTS release](/lifecycle/products/microsoft-net-and-net-core) of .NET. This enables you to upgrade to a newer, STS release of EF Core to take advantage of the latest features without having to upgrade your entire app. There may be exceptions to this, however, as runtime features sometimes get added that require us to depend on the latest version of .NET.
+
+.NET supports multiple platforms including Windows, Linux, macOS, iOS, Android, and Wasm. For more details on which version are supported, see the [.NET Supported OS Policy](https://github.com/dotnet/core/blob/main/os-lifecycle-policy.md).
+
+## .NET Core
+
+The last release of .NET Core was version 3.1. It was renamed to just .NET in version 5.0. Note, version 4.0 was skipped to avoid confusion with .NET Framework--the original, Windows-only implementation. .NET continues to support multiple platforms including Windows, Linux, and macOS.
+
+## .NET Standard
+
+.NET Standard has been superseded by a new approach to uniformity. For more information, see [The future of .NET Standard](https://devblogs.microsoft.com/dotnet/the-future-of-net-standard/). The last version of EF Core that supported .NET Standard was version 5.0.
+
+## .NET Framework
+
+The last version of EF Core that supported .NET Framework was version 3.1. We recommend using .NET instead which continues to support WinForms and WPF applications. The [.NET Upgrade Assistant](/dotnet/core/porting/upgrade-assistant-overview) can help you with the migration process.
+
+## Xamarin
+
+The last version of EF Core that supported Xamarin was version 5.0. We recommend using .NET and [.NET MAUI](/dotnet/maui/) instead. .NET supports multiple platforms including Android, iOS, macOS, and Windows. .NET MAUI is an evolution of the Xamarin.Forms UI framework. Xamarin.Android, Xamarin.iOS, Xamarin.Mac are now integrated directly into .NET (starting with .NET 6) as .NET for Android, .NET for iOS, and .NET for macOS. If you're building with these project types today, they should be upgraded to .NET SDK-style projects for continued support. For more information about upgrading Xamarin projects to .NET, see the [Upgrade from Xamarin to .NET & .NET MAUI](/dotnet/maui/migration) documentation.
+
+## Universal Windows Platform
+
+The last version of EF Core that supported UWP was version 3.1. We recommend using .NET and the [Windows App SDK](/windows/apps/windows-app-sdk/) instead.
+
+## Unity
+
+Unity currently only supports .NET Standard libraries. The last version of EF Core that supported .NET Standard was version 5.0. Unity is currently working towards an implementation that uses .NET. For more information, see [Unity and .NET, what’s next?](https://blog.unity.com/technology/unity-and-net-whats-next)
+
+## Tizen
+
+Tizen is an open source operating system that runs on various Samsung devices including phones, tablets, watches, TVs, cameras, and appliances. [Tizen .NET](https://developer.samsung.com/tizen/About-Tizen.NET/Tizen.NET.html) enables you to develop apps for it using .NET and .NET MAUI. EF Core compatibility with Tizen is largely unknown. If you've tried it, we'd love your feedback.
diff --git a/entity-framework/core/miscellaneous/plugins.md b/entity-framework/core/miscellaneous/plugins.md
new file mode 100644
index 0000000000..c08cc5806a
--- /dev/null
+++ b/entity-framework/core/miscellaneous/plugins.md
@@ -0,0 +1,37 @@
+---
+title: Plug-in APIs - EF Core
+description: APIs extensions can use to plug into certain Entity Framework Core components
+author: SamMonoRT
+ms.date: 8/31/2023
+uid: core/miscellaneous/plugins
+---
+# Plug-in APIs
+
+EF Core extensions often require adding logic to core EF and provider components. This usually requires creating a derived component and replacing the original one in the internal service provider. This gets complicated when multiple extensions want to change the same component. In these cases, we provide plug-in APIs to allow multiple extensions to provide additional logic.
+
+## List of services
+
+The following is a list of plug-in APIs.
+
+Service                                                                                       | Description
+--------------------------------------------------------------------------------------------- | -----------
+<xref:Microsoft.EntityFrameworkCore.Storage.ITypeMappingSourcePlugin>                         | Adds mappings between .NET types and primitive store types.
+<xref:Microsoft.EntityFrameworkCore.Storage.IRelationalTypeMappingSourcePlugin>               | Adds mappings between .NET types and primitive relational database types.
+<xref:Microsoft.EntityFrameworkCore.Metadata.Conventions.Infrastructure.IConventionSetPlugin> | Adds model building conventions.
+<xref:Microsoft.EntityFrameworkCore.Query.IMemberTranslatorPlugin>                            | Adds SQL translations for .NET properties.
+<xref:Microsoft.EntityFrameworkCore.Query.IMethodCallTranslatorPlugin>                        | Adds SQL translations for .NET methods.
+<xref:Microsoft.EntityFrameworkCore.Query.IAggregateMethodCallTranslatorPlugin>               | Adds SQL translations for .NET enumerable methods.
+<xref:Microsoft.EntityFrameworkCore.Query.IEvaluatableExpressionFilterPlugin>                 | Forces server-eval of certain expressions.
+<xref:Microsoft.EntityFrameworkCore.Scaffolding.IProviderCodeGeneratorPlugin>                 | Scaffolds provider and DbContext options.
+
+## Examples
+
+Here are some extensions making use of these APIs:
+
+Extension | Description
+--------- | -----------
+[Microsoft.EntityFrameworkCore.Sqlite.NetTopologySuite](https://github.com/dotnet/efcore/tree/main/src/EFCore.Sqlite.NTS) | Adds type mappings and SQL translations for SpatiaLite's types.
+[Microsoft.EntityFrameworkCore.SqlServer.HierarchyId](https://github.com/dotnet/efcore/tree/main/src/EFCore.SqlServer.HierarchyId) | Adds type mappings and SQL translations for SQL Server's hierarchyid type.
+[Microsoft.EntityFrameworkCore.SqlServer.NetTopologySuite](https://github.com/dotnet/efcore/tree/main/src/EFCore.SqlServer.NTS) | Adds type mappings and SQL translations for SQL Server's geography and geometry types.
+[EFCore.CheckConstraints](https://github.com/efcore/EFCore.CheckConstraints) | Adds model building conventions for relational database check constraints.
+[EFCore.NamingConventions](https://github.com/efcore/EFCore.NamingConventions) | Adds model building conventions for alternative relational database table, column, and constraint names.
diff --git a/entity-framework/core/modeling/_static/debug-view.png b/entity-framework/core/modeling/_static/debug-view.png
new file mode 100644
index 0000000000..c0ecc80b80
Binary files /dev/null and b/entity-framework/core/modeling/_static/debug-view.png differ
diff --git a/entity-framework/core/modeling/_static/inheritance-tph-data.png b/entity-framework/core/modeling/_static/inheritance-tph-data.png
new file mode 100644
index 0000000000..98dd930b28
Binary files /dev/null and b/entity-framework/core/modeling/_static/inheritance-tph-data.png differ
diff --git a/entity-framework/core/modeling/_static/owned-entities-nested.png b/entity-framework/core/modeling/_static/owned-entities-nested.png
new file mode 100644
index 0000000000..d53c6586c4
Binary files /dev/null and b/entity-framework/core/modeling/_static/owned-entities-nested.png differ
diff --git a/entity-framework/core/modeling/_static/owned-entities-ownsmany.png b/entity-framework/core/modeling/_static/owned-entities-ownsmany.png
new file mode 100644
index 0000000000..4a1734b829
Binary files /dev/null and b/entity-framework/core/modeling/_static/owned-entities-ownsmany.png differ
diff --git a/entity-framework/core/modeling/_static/owned-entities-ownsone.png b/entity-framework/core/modeling/_static/owned-entities-ownsone.png
new file mode 100644
index 0000000000..5444862b13
Binary files /dev/null and b/entity-framework/core/modeling/_static/owned-entities-ownsone.png differ
diff --git a/entity-framework/core/modeling/backing-field.md b/entity-framework/core/modeling/backing-field.md
new file mode 100644
index 0000000000..ed79fd8db9
--- /dev/null
+++ b/entity-framework/core/modeling/backing-field.md
@@ -0,0 +1,62 @@
+---
+title: Backing Fields - EF Core
+description: Configuring backing fields for properties in an Entity Framework Core model
+author: SamMonoRT
+ms.date: 11/15/2021
+uid: core/modeling/backing-field
+---
+# Backing Fields
+
+Backing fields allow EF to read and/or write to a field rather than a property. This can be useful when encapsulation in the class is being used to restrict the use of and/or enhance the semantics around access to the data by application code, but the value should be read from and/or written to the database without using those restrictions/enhancements.
+
+## Basic configuration
+
+By convention, the following fields will be discovered as backing fields for a given property (listed in precedence order).
+
+* `<camel-cased property name>`
+* `_<camel-cased property name>`
+* `_<property name>`
+* `m_<camel-cased property name>`
+* `m_<property name>`
+
+In the following sample, the `Url` property is configured to have `_url` as its backing field:
+
+[!code-csharp[Main](../../../samples/core/Modeling/BackingFields/BackingField.cs#Sample)]
+
+Note that backing fields are only discovered for properties that are included in the model. For more information on which properties are included in the model, see [Including & Excluding Properties](xref:core/modeling/entity-properties#included-and-excluded-properties).
+
+You can also configure backing fields by using a [Data Annotations](xref:core/modeling/index#use-data-annotations-to-configure-a-model) or the [Fluent API](xref:core/modeling/index#use-fluent-api-to-configure-a-model), e.g. if the field name doesn't correspond to the above conventions:
+
+### [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[Main](../../../samples/core/Modeling/BackingFields/DataAnnotations/BackingField.cs?name=BackingField&highlight=7)]
+
+### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[Main](../../../samples/core/Modeling/BackingFields/FluentAPI/BackingField.cs?name=BackingField&highlight=5)]
+
+***
+
+## Field and property access
+
+By default, EF will always read and write to the backing field - assuming one has been properly configured - and will never use the property. However, EF also supports other access patterns. For example, the following sample instructs EF to write to the backing field only while materializing, and to use the property in all other cases:
+
+[!code-csharp[Main](../../../samples/core/Modeling/BackingFields/FluentAPI/BackingFieldAccessMode.cs?name=BackingFieldAccessMode&highlight=6)]
+
+See the [PropertyAccessMode enum](/dotnet/api/microsoft.entityframeworkcore.propertyaccessmode) for the complete set of supported options.
+
+## Field-only properties
+
+You can also create a conceptual property in your model that does not have a corresponding CLR property in the entity class, but instead uses a field to store the data in the entity. This is different from [Shadow Properties](xref:core/modeling/shadow-properties), where the data is stored in the change tracker, rather than in the entity's CLR type. Field-only properties are commonly used when the entity class uses methods instead of properties to get/set values, or in cases where fields shouldn't be exposed at all in the domain model (e.g. primary keys).
+
+You can configure a field-only property by providing a name in the `Property(...)` API:
+
+[!code-csharp[Main](../../../samples/core/Modeling/BackingFields/FluentAPI/BackingFieldNoProperty.cs#Sample)]
+
+EF will attempt to find a CLR property with the given name, or a field if a property isn't found. If neither a property nor a field are found, a shadow property will be set up instead.
+
+You may need to refer to a field-only property from LINQ queries, but such fields are typically private. You can use the `EF.Property(...)` method in a LINQ query to refer to the field:
+
+```csharp
+var blogs = db.blogs.OrderBy(b => EF.Property<string>(b, "_validatedUrl"));
+```
diff --git a/entity-framework/core/modeling/bulk-configuration.md b/entity-framework/core/modeling/bulk-configuration.md
new file mode 100644
index 0000000000..56bf6ff4e0
--- /dev/null
+++ b/entity-framework/core/modeling/bulk-configuration.md
@@ -0,0 +1,542 @@
+---
+title: Model Bulk Configuration - EF Core
+description: How to apply bulk configuration during model building in Entity Framework Core via Metadata API, conventions or pre-convention configuration.
+author: AndriySvyryd
+ms.date: 11/11/2022
+uid: core/modeling/bulk-configuration
+---
+# Model bulk configuration
+
+When an aspect needs to be configured in the same way across multiple entity types, the following techniques allow to reduce code duplication and consolidate the logic.
+
+See the [full sample project](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Modeling/BulkConfiguration) containing the code snippets presented below.
+
+## Bulk configuration in OnModelCreating
+
+Every builder object returned from <xref:Microsoft.EntityFrameworkCore.ModelBuilder> exposes a <xref:Microsoft.EntityFrameworkCore.ModelBuilder.Model> or `Metadata` property that provides a low-level access to the objects that comprise the model. In particular, there are methods that allow you to iterate over specific objects in the model and apply common configuration to them.
+
+In the following example the model contains a custom value type `Currency`:
+
+[!code-csharp[Main](../../../samples/core/Modeling/BulkConfiguration/Currency.cs?name=Currency)]
+
+Properties of this type are not discovered by default as the current EF provider doesn't know how to map it to a database type. This snippet of `OnModelCreating` adds all properties of the type `Currency` and configures a value converter to a supported type - `decimal`:
+
+[!code-csharp[Main](../../../samples/core/Modeling/BulkConfiguration/MetadataAPIContext.cs?name=MetadataAPI)]
+
+[!code-csharp[Main](../../../samples/core/Modeling/BulkConfiguration/CurrencyConverter.cs?name=CurrencyConverter)]
+
+### Drawbacks of the Metadata API
+
+- Unlike [Fluent API](xref:core/modeling/index#use-fluent-api-to-configure-a-model), every modification to the model needs to be done explicitly. For example, if some of the `Currency` properties were configured as navigations by a convention then you need to first remove the navigation referencing the CLR property before adding an entity type property for it. [#9117](https://github.com/dotnet/efcore/issues/9117) will improve this.
+- The conventions run after each change. If you remove a navigation discovered by a convention then the convention will run again and could add it back. To prevent this from happening you would need to either delay the conventions until after the property is added by calling <xref:Microsoft.EntityFrameworkCore.Metadata.Conventions.IConventionContext.DelayConventions> and later disposing the returned object or to mark the CLR property as ignored using <xref:Microsoft.EntityFrameworkCore.Metadata.IMutableModel.AddIgnored*>.
+- Entity types might be added after this iteration happens and the configuration won't be applied to them. This can usually be prevented by placing this code at the end of `OnModelCreating`, but if you have two interdependent sets of configurations there might not be an order that will allow them to be applied consistently.
+
+## Pre-convention configuration
+
+EF Core allows the mapping configuration to be specified once for a given CLR type; that configuration is then applied to all properties of that type in the model as they are discovered. This is called "pre-convention model configuration", since it configures aspects of the model before the model building conventions are allowed to run. Such configuration is applied by overriding <xref:Microsoft.EntityFrameworkCore.DbContext.ConfigureConventions*> on the type derived from <xref:Microsoft.EntityFrameworkCore.DbContext>.
+
+This example shows how configure all properties of type `Currency` to have a value converter:
+
+[!code-csharp[Main](../../../samples/core/Modeling/BulkConfiguration/CurrencyContext.cs?name=ConfigureConventions)]
+
+And this example shows how to configure some facets on all properties of type `string`:
+
+[!code-csharp[Main](../../../samples/core/Modeling/BulkConfiguration/PreConventionContext.cs?name=StringFacets)]
+
+> [!NOTE]
+> The type specified in a call from `ConfigureConventions` can be a base type, an interface or a generic type definition. All matching configurations will be applied in order from the least specific:
+>
+> 1. Interface
+> 2. Base type
+> 3. Generic type definition
+> 4. Non-nullable value type
+> 5. Exact type
+
+> [!IMPORTANT]
+> Pre-convention configuration is equivalent to explicit configuration that is applied as soon as a matching object is added to the model. It will override all conventions and Data Annotations. For example, with the above configuration all string foreign key properties will be created as non-unicode with `MaxLength` of 1024, even when this doesn't match the principal key.
+
+### Ignoring types
+
+Pre-convention configuration also allows to ignore a type and prevent it from being discovered by conventions either as an entity type or as a property on an entity type:
+
+[!code-csharp[Main](../../../samples/core/Modeling/BulkConfiguration/PreConventionContext.cs?name=IgnoreInterface)]
+
+### Default type mapping
+
+Generally, EF is able to translate queries with constants of a type that is not supported by the provider, as long as you have specified a value converter for a property of this type. However, in queries that don't involve any properties of this type, there is no way for EF to find the correct value converter. In this case, it's possible to call <xref:Microsoft.EntityFrameworkCore.ModelConfigurationBuilder.DefaultTypeMapping*> to add or override a provider type mapping:
+
+[!code-csharp[Main](../../../samples/core/Modeling/BulkConfiguration/PreConventionContext.cs?name=DefaultTypeMapping)]
+
+### Limitations of pre-convention configuration
+
+- Many aspects cannot be configured with this approach. [#6787](https://github.com/dotnet/efcore/issues/6787) will expand this to more types.
+- Currently the configuration is only determined by the CLR type. [#20418](https://github.com/dotnet/efcore/issues/20418) would allow custom predicates.
+- This configuration is performed before a model is created. If there are any conflicts that arise when applying it, the exception stack trace will not contain the `ConfigureConventions` method, so it might be harder to find the cause.
+
+## Conventions
+
+EF Core model building conventions are classes that contain logic that is triggered based on changes being made to the model as it is being built. This keeps the model up-to-date as explicit configuration is made, mapping attributes are applied, and other conventions run. To participate in this, every convention implements one or more interfaces which determine when the corresponding method will be triggered. For example, a convention that implements <xref:Microsoft.EntityFrameworkCore.Metadata.Conventions.IEntityTypeAddedConvention> will be triggered whenever a new entity type is added to the model. Likewise, a convention that implements both <xref:Microsoft.EntityFrameworkCore.Metadata.Conventions.IForeignKeyAddedConvention> and <xref:Microsoft.EntityFrameworkCore.Metadata.Conventions.IKeyAddedConvention> will be triggered whenever either a key or a foreign key is added to the model.
+
+Model building conventions are a powerful way to control the model configuration, but can be complex and hard to get right. In many cases, the [pre-convention model configuration](#pre-convention-configuration) can be used instead to easily specify common configuration for properties and types.
+
+### Adding a new convention
+
+#### Example: Constrain length of discriminator properties
+
+The [table-per-hierarchy inheritance mapping strategy](xref:core/modeling/inheritance) requires a discriminator column to specify which type is represented in any given row. By default, EF uses an unbounded string column for the discriminator, which ensures that it will work for any discriminator length. However, constraining the maximum length of discriminator strings can make for more efficient storage and queries. Let's create a new convention that will do that.
+
+EF Core model building conventions are triggered based on changes being made to the model as it is being built. This keeps the model up-to-date as explicit configuration is made, mapping attributes are applied, and other conventions run. To participate in this, every convention implements one or more interfaces which determine when the convention will be triggered. For example, a convention that implements <xref:Microsoft.EntityFrameworkCore.Metadata.Conventions.IEntityTypeAddedConvention> will be triggered whenever a new entity type is added to the model. Likewise, a convention that implements both <xref:Microsoft.EntityFrameworkCore.Metadata.Conventions.IForeignKeyAddedConvention> and <xref:Microsoft.EntityFrameworkCore.Metadata.Conventions.IKeyAddedConvention> will be triggered whenever either a key or a foreign key is added to the model.
+
+Knowing which interfaces to implement can be tricky, since configuration made to the model at one point may be changed or removed at a later point. For example, a key may be created by convention, but then later replaced when a different key is configured explicitly.
+
+Let's make this a bit more concrete by making a first attempt at implementing the discriminator-length convention:
+
+<!--
+public class DiscriminatorLengthConvention1 : IEntityTypeBaseTypeChangedConvention
+{
+    public void ProcessEntityTypeBaseTypeChanged(
+        IConventionEntityTypeBuilder entityTypeBuilder,
+        IConventionEntityType? newBaseType,
+        IConventionEntityType? oldBaseType,
+        IConventionContext<IConventionEntityType> context)
+    {
+        var discriminatorProperty = entityTypeBuilder.Metadata.FindDiscriminatorProperty();
+        if (discriminatorProperty != null
+            && discriminatorProperty.ClrType == typeof(string))
+        {
+            discriminatorProperty.Builder.HasMaxLength(24);
+        }
+    }
+}
+-->
+[!code-csharp[DiscriminatorLengthConvention1](../../../samples/core/Modeling/BulkConfiguration/ModelBuildingConventionsSample.cs?name=DiscriminatorLengthConvention1)]
+
+This convention implements <xref:Microsoft.EntityFrameworkCore.Metadata.Conventions.IEntityTypeBaseTypeChangedConvention>, which means it will be triggered whenever the mapped inheritance hierarchy for an entity type is changed. The convention then finds and configures the string discriminator property for the hierarchy.
+
+This convention is then used by calling <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.ConventionSetBuilder.Add*> in `ConfigureConventions`:
+
+```csharp
+protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+{
+    configurationBuilder.Conventions.Add(_ =>  new DiscriminatorLengthConvention1());
+}
+```
+
+> [!NOTE]
+> Rather than adding an instance of the convention directly, the `Add` method accepts a factory for creating instances of the convention. This allows the convention to use dependencies from the EF Core internal service provider. Since this convention has no dependencies, the service provider parameter is named `_`, indicating that it is never used.
+
+Building the model and looking at the `Post` entity type shows that this has worked - the discriminator property is now configured to with a maximum length of 24:
+
+```text
+ Discriminator (no field, string) Shadow Required AfterSave:Throw MaxLength(24)
+```
+
+But what happens if we now explicitly configure a different discriminator property? For example:
+
+```csharp
+modelBuilder.Entity<Post>()
+    .HasDiscriminator<string>("PostTypeDiscriminator")
+    .HasValue<Post>("Post")
+    .HasValue<FeaturedPost>("Featured");
+```
+
+Looking at the [debug view](xref:core/modeling/index#debug-view) of the model, we find that the discriminator length is no longer configured.
+
+```text
+ PostTypeDiscriminator (no field, string) Shadow Required AfterSave:Throw
+```
+
+This is because the discriminator property that we configured in our convention was later removed when the custom discriminator was added. We could attempt to fix this by implementing another interface on our convention to react to the discriminator changes, but figuring out which interface to implement is not easy.
+
+Fortunately, there is an easier approach. A lot of the time, it doesn't matter what the model looks like while it is being built, as long as the final model is correct. In addition, the configuration we want to apply often does not need to trigger other conventions to react. Therefore, our convention can implement <xref:Microsoft.EntityFrameworkCore.Metadata.Conventions.IModelFinalizingConvention>. _Model finalizing conventions_ run after all other model building is complete, and so have access to the near-final state of the model. This is opposed to _interactive conventions_ that react to each model change and make sure that the model is up-to-date at any point of the `OnModelCreating` method execution. A model finalizing convention will typically iterate over the entire model configuring model elements as it goes. So, in this case, we will find every discriminator in the model and configure it:
+
+<!--
+public class DiscriminatorLengthConvention2 : IModelFinalizingConvention
+{
+    public void ProcessModelFinalizing(IConventionModelBuilder modelBuilder, IConventionContext<IConventionModelBuilder> context)
+    {
+        foreach (var entityType in modelBuilder.Metadata.GetEntityTypes()
+                     .Where(entityType => entityType.BaseType == null))
+        {
+            var discriminatorProperty = entityType.FindDiscriminatorProperty();
+            if (discriminatorProperty != null
+                && discriminatorProperty.ClrType == typeof(string))
+            {
+                discriminatorProperty.Builder.HasMaxLength(24);
+            }
+        }
+    }
+}
+-->
+[!code-csharp[DiscriminatorLengthConvention2](../../../samples/core/Modeling/BulkConfiguration/ModelBuildingConventionsSample.cs?name=DiscriminatorLengthConvention2)]
+
+After building the model with this new convention, we find that the discriminator length is now configured correctly even though it has been customized:
+
+```text
+PostTypeDiscriminator (no field, string) Shadow Required AfterSave:Throw MaxLength(24)
+```
+
+We can go one step further and configure the max length to be the length of the longest discriminator value:
+
+<!--
+public class DiscriminatorLengthConvention3 : IModelFinalizingConvention
+{
+    public void ProcessModelFinalizing(IConventionModelBuilder modelBuilder, IConventionContext<IConventionModelBuilder> context)
+    {
+        foreach (var entityType in modelBuilder.Metadata.GetEntityTypes()
+                     .Where(entityType => entityType.BaseType == null))
+        {
+            var discriminatorProperty = entityType.FindDiscriminatorProperty();
+            if (discriminatorProperty != null
+                && discriminatorProperty.ClrType == typeof(string))
+            {
+                var maxDiscriminatorValueLength =
+                    entityType.GetDerivedTypesInclusive().Select(e => ((string)e.GetDiscriminatorValue()!).Length).Max();
+
+                discriminatorProperty.Builder.HasMaxLength(maxDiscriminatorValueLength);
+            }
+        }
+    }
+}
+-->
+[!code-csharp[DiscriminatorLengthConvention3](../../../samples/core/Modeling/BulkConfiguration/ModelBuildingConventionsSample.cs?name=DiscriminatorLengthConvention3)]
+
+Now the discriminator column max length is 8, which is the length of "Featured", the longest discriminator value in use.
+
+```text
+PostTypeDiscriminator (no field, string) Shadow Required AfterSave:Throw MaxLength(8)
+```
+
+#### Example: Default length for all string properties
+
+Let's look at another example where a finalizing convention can be used - setting a default maximum length for _any_ string property. The convention looks quite similar to the previous example:
+
+<!--
+public class MaxStringLengthConvention : IModelFinalizingConvention
+{
+    public void ProcessModelFinalizing(IConventionModelBuilder modelBuilder, IConventionContext<IConventionModelBuilder> context)
+    {
+        foreach (var property in modelBuilder.Metadata.GetEntityTypes()
+                     .SelectMany(
+                         entityType => entityType.GetDeclaredProperties()
+                             .Where(
+                                 property => property.ClrType == typeof(string))))
+        {
+            property.Builder.HasMaxLength(512);
+        }
+    }
+}
+-->
+[!code-csharp[MaxStringLengthConvention](../../../samples/core/Modeling/BulkConfiguration/ModelBuildingConventionsSample.cs?name=MaxStringLengthConvention)]
+
+This convention is pretty simple. It finds every string property in the model and sets its max length to 512. Looking in the debug view at the properties for `Post`, we see that all the string properties now have a max length of 512.
+
+```text
+EntityType: Post
+  Properties:
+    Id (int) Required PK AfterSave:Throw ValueGenerated.OnAdd
+    AuthorId (no field, int?) Shadow FK Index
+    BlogId (no field, int) Shadow Required FK Index
+    Content (string) Required MaxLength(512)
+    Discriminator (no field, string) Shadow Required AfterSave:Throw MaxLength(512)
+    PublishedOn (DateTime) Required
+    Title (string) Required MaxLength(512)
+```
+
+> [!NOTE]
+> The same can be accomplished by pre-convention configuration, but using a convention allows to further filter applicable properties and for [Data Annotations to override the configuration](xref:core/modeling/index).
+
+Finally, before we leave this example, what happens if we use both the `MaxStringLengthConvention` and `DiscriminatorLengthConvention3` at the same time? The answer is that it depends which order they are added, since model finalizing conventions run in the order they are added. So if `MaxStringLengthConvention` is added last, then it will run last, and it will set the max length of the discriminator property to 512. Therefore, in this case, it is better to add `DiscriminatorLengthConvention3` last so that it can override the default max length for just discriminator properties, while leaving all other string properties as 512.
+
+### Replacing an existing convention
+
+Sometimes rather than removing an existing convention completely we instead want to replace it with a convention that does basically the same thing, but with changed behavior. This is useful because the existing convention will already implement the interfaces it needs to be triggered appropriately.
+
+#### Example: Opt-in property mapping
+
+EF Core maps all public read-write properties by convention. This might not be appropriate for the way your entity types are defined. To change this, we can replace the <xref:Microsoft.EntityFrameworkCore.Metadata.Conventions.PropertyDiscoveryConvention> with our own implementation that doesn't map any property unless it is explicitly mapped in `OnModelCreating` or marked with a new attribute called `Persist`:
+
+<!--
+[AttributeUsage(AttributeTargets.Property | AttributeTargets.Field)]
+public sealed class PersistAttribute : Attribute
+{
+}
+-->
+[!code-csharp[PersistAttribute](../../../samples/core/Modeling/BulkConfiguration/ModelBuildingConventionsSample.cs?name=PersistAttribute)]
+
+Here is the new convention:
+
+<!--
+public class AttributeBasedPropertyDiscoveryConvention : PropertyDiscoveryConvention
+{
+    public AttributeBasedPropertyDiscoveryConvention(ProviderConventionSetBuilderDependencies dependencies)
+        : base(dependencies)
+    {
+    }
+
+    public override void ProcessEntityTypeAdded(
+        IConventionEntityTypeBuilder entityTypeBuilder,
+        IConventionContext<IConventionEntityTypeBuilder> context)
+        => Process(entityTypeBuilder);
+
+    public override void ProcessEntityTypeBaseTypeChanged(
+        IConventionEntityTypeBuilder entityTypeBuilder,
+        IConventionEntityType? newBaseType,
+        IConventionEntityType? oldBaseType,
+        IConventionContext<IConventionEntityType> context)
+    {
+        if ((newBaseType == null
+             || oldBaseType != null)
+            && entityTypeBuilder.Metadata.BaseType == newBaseType)
+        {
+            Process(entityTypeBuilder);
+        }
+    }
+
+    private void Process(IConventionEntityTypeBuilder entityTypeBuilder)
+    {
+        foreach (var memberInfo in GetRuntimeMembers())
+        {
+            if (Attribute.IsDefined(memberInfo, typeof(PersistAttribute), inherit: true))
+            {
+                entityTypeBuilder.Property(memberInfo);
+            }
+            else if (memberInfo is PropertyInfo propertyInfo
+                     && Dependencies.TypeMappingSource.FindMapping(propertyInfo) != null)
+            {
+                entityTypeBuilder.Ignore(propertyInfo.Name);
+            }
+        }
+
+        IEnumerable<MemberInfo> GetRuntimeMembers()
+        {
+            var clrType = entityTypeBuilder.Metadata.ClrType;
+
+            foreach (var property in clrType.GetRuntimeProperties()
+                         .Where(p => p.GetMethod != null && !p.GetMethod.IsStatic))
+            {
+                yield return property;
+            }
+
+            foreach (var property in clrType.GetRuntimeFields())
+            {
+                yield return property;
+            }
+        }
+    }
+}
+-->
+[!code-csharp[AttributeBasedPropertyDiscoveryConvention](../../../samples/core/Modeling/BulkConfiguration/ModelBuildingConventionsSample.cs?name=AttributeBasedPropertyDiscoveryConvention)]
+
+> [!TIP]
+> When replacing a built-in convention, the new convention implementation should inherit from the existing convention class. Note that some conventions have relational or provider-specific implementations, in which case the new convention implementation should inherit from the most specific existing convention class for the database provider in use.
+
+The convention is then registered using the <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.ConventionSetBuilder.Replace*> method in `ConfigureConventions`:
+
+<!--
+    protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+    {
+        configurationBuilder.Conventions.Replace<PropertyDiscoveryConvention>(
+            serviceProvider => new AttributeBasedPropertyDiscoveryConvention(
+                serviceProvider.GetRequiredService<ProviderConventionSetBuilderDependencies>()));
+    }
+-->
+[!code-csharp[ReplaceConvention](../../../samples/core/Modeling/BulkConfiguration/ModelBuildingConventionsSample.cs?name=ReplaceConvention)]
+
+> [!TIP]
+> This is a case where the existing convention has dependencies, represented by the `ProviderConventionSetBuilderDependencies` dependency object. These are obtained from the internal service provider using `GetRequiredService` and passed to the convention constructor.
+
+Notice that this convention allows fields to be mapped (in addition to properties) so long as they are marked with `[Persist]`. This means we can use private fields as hidden keys in the model.
+
+For example, consider the following entity types:
+
+<!--
+public class LaundryBasket
+{
+    [Persist] [Key]
+    private readonly int _id;
+
+    [Persist]
+    public int TenantId { get; init; }
+
+    public bool IsClean { get; set; }
+
+    public List<Garment> Garments { get; } = new();
+}
+
+public class Garment
+{
+    public Garment(string name, string color)
+    {
+        Name = name;
+        Color = color;
+    }
+
+    [Persist]
+    [Key]
+    private readonly int _id;
+
+    [Persist]
+    public int TenantId { get; init; }
+
+    [Persist]
+    public string Name { get; }
+
+    [Persist]
+    public string Color { get; }
+
+    public bool IsClean { get; set; }
+
+    public LaundryBasket? Basket { get; set; }
+}
+-->
+[!code-csharp[LaundryBasket](../../../samples/core/Modeling/BulkConfiguration/ModelBuildingConventionsSample.cs?name=LaundryBasket)]
+
+The model built from these entity types is:
+
+```text
+Model:
+  EntityType: Garment
+    Properties:
+      _id (_id, int) Required PK AfterSave:Throw ValueGenerated.OnAdd
+      Basket_id (no field, int?) Shadow FK Index
+      Color (string) Required
+      Name (string) Required
+      TenantId (int) Required
+    Navigations:
+      Basket (LaundryBasket) ToPrincipal LaundryBasket Inverse: Garments
+    Keys:
+      _id PK
+    Foreign keys:
+      Garment {'Basket_id'} -> LaundryBasket {'_id'} ToDependent: Garments ToPrincipal: Basket ClientSetNull
+    Indexes:
+      Basket_id
+  EntityType: LaundryBasket
+    Properties:
+      _id (_id, int) Required PK AfterSave:Throw ValueGenerated.OnAdd
+      TenantId (int) Required
+    Navigations:
+      Garments (List<Garment>) Collection ToDependent Garment Inverse: Basket
+    Keys:
+      _id PK
+```
+
+Normally, `IsClean` would have been mapped, but since it is not marked with `[Persist]`, it is now treated as an un-mapped property.
+
+> [!TIP]
+> This convention could not be implemented as a model finalizing convention because there are existing model finalizing conventions that need to run after the property is mapped to further configure it.
+
+### Conventions implementation considerations
+
+EF Core keeps track of how every piece of configuration was made. This is represented by the <xref:Microsoft.EntityFrameworkCore.Metadata.ConfigurationSource> enum. The different kinds of configuration are:
+
+- `Explicit`: The model element was explicitly configured in `OnModelCreating`
+- `DataAnnotation`: The model element was configured using a mapping attribute (aka data annotation) on the CLR type
+- `Convention`: The model element was configured by a model building convention
+
+Conventions should never override configuration marked as `DataAnnotation` or `Explicit`. This is achieved by using a _convention builder_, for example, the <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.IConventionPropertyBuilder>, which is obtained from the <xref:Microsoft.EntityFrameworkCore.Metadata.IConventionProperty.Builder> property. For example:
+
+```csharp
+property.Builder.HasMaxLength(512);
+```
+
+Calling `HasMaxLength` on the convention builder will only set the max length _if it was not already configured by a mapping attribute or in `OnModelCreating`_.
+
+Builder methods like this also have a second parameter: `fromDataAnnotation`. Set this to `true` if the convention is making the configuration on behalf of a mapping attribute. For example:
+
+```csharp
+property.Builder.HasMaxLength(512, fromDataAnnotation: true);
+```
+
+This sets the `ConfigurationSource` to `DataAnnotation`, which means that the value can now be overridden by explicit mapping on `OnModelCreating`, but not by non-mapping attribute conventions.
+
+If the current configuration can't be overridden then the method will return `null`, this needs to be accounted for if you need to perform further configuration:
+
+```csharp
+property.Builder.HasMaxLength(512)?.IsUnicode(false);
+```
+
+Notice that if the unicode configuration can't be overridden the max length will still be set. In case when you need to configure the facets only when both calls succeed then you can preemptively check this by calling <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.IConventionPropertyBuilder.CanSetMaxLength*> and <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.IConventionPropertyBuilder.CanSetIsUnicode*>:
+
+<!--
+public class MaxStringLengthNonUnicodeConvention : IModelFinalizingConvention
+{
+    public void ProcessModelFinalizing(IConventionModelBuilder modelBuilder, IConventionContext<IConventionModelBuilder> context)
+    {
+        foreach (var property in modelBuilder.Metadata.GetEntityTypes()
+                     .SelectMany(
+                         entityType => entityType.GetDeclaredProperties()
+                             .Where(
+                                 property => property.ClrType == typeof(string))))
+        {
+            var propertyBuilder = property.Builder;
+            if (propertyBuilder.CanSetMaxLength(512)
+                && propertyBuilder.CanSetIsUnicode(false))
+            {
+                propertyBuilder.HasMaxLength(512)!.IsUnicode(false);
+            }
+        }
+    }
+}
+-->
+[!code-csharp[MaxStringLengthNonUnicodeConvention](../../../samples/core/Modeling/BulkConfiguration/ModelBuildingConventionsSample.cs?name=MaxStringLengthNonUnicodeConvention)]
+
+Here we can be sure that the call to `HasMaxLength` will not return `null`. It is still recommended to use the builder instance returned from `HasMaxLength` as it might be different from `propertyBuilder`.
+
+> [!NOTE]
+> Other conventions are not triggered immediately after a convention makes a change, they are delayed until all conventions have finished processing the current change.
+
+### IConventionContext
+
+All convention methods also have an <xref:Microsoft.EntityFrameworkCore.Metadata.Conventions.IConventionContext`1> parameter. It provides methods that could be useful in some specific cases.
+
+#### Example: NotMappedAttribute convention
+
+This convention looks for <xref:System.ComponentModel.DataAnnotations.Schema.NotMappedAttribute> on a type that is added to the model and tries to remove that entity type from the model. But if the entity type is removed from the model then any other conventions that implement `ProcessEntityTypeAdded` no longer need to be run. This can be accomplished by calling <xref:Microsoft.EntityFrameworkCore.Metadata.Conventions.IConventionContext.StopProcessing>:
+
+```csharp
+public virtual void ProcessEntityTypeAdded(
+    IConventionEntityTypeBuilder entityTypeBuilder,
+    IConventionContext<IConventionEntityTypeBuilder> context)
+{
+    var type = entityTypeBuilder.Metadata.ClrType;
+    if (!Attribute.IsDefined(type, typeof(NotMappedAttribute), inherit: true))
+    {
+        return;
+    }
+
+    if (entityTypeBuilder.ModelBuilder.Ignore(entityTypeBuilder.Metadata.Name, fromDataAnnotation: true) != null)
+    {
+        context.StopProcessing();
+    }
+}
+```
+
+### IConventionModel
+
+Every builder object passed to the convention exposes a <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.IConventionModelBuilder.Metadata> property that provides a low-level access to the objects that comprise the model. In particular, there are methods that allow you to iterate over specific objects in the model and apply common configuration to them as seen in [Example: Default length for all string properties](#example-default-length-for-all-string-properties). This API is similar to <xref:Microsoft.EntityFrameworkCore.Metadata.IMutableModel> shown in [Bulk configuration](#bulk-configuration-in-onmodelcreating).
+
+> [!CAUTION]
+> It is advised to always perform configuration by calling methods on the builder exposed as the <xref:Microsoft.EntityFrameworkCore.Metadata.IConventionModel.Builder> property, because the builders check whether the given configuration would override something that was already specified using Fluent API or Data Annotations.
+
+## When to use each approach for bulk configuration
+
+Use [Metadata API](#bulk-configuration-in-onmodelcreating) when:
+
+- The configuration needs to be applied at a certain time and not react to later changes in the model.
+- The model building speed is very important. Metadata API has fewer safety checks and thus can be slightly faster than other approaches, however using a [Compiled model](xref:core/performance/advanced-performance-topics#compiled-models) would yield even better startup times.
+
+Use [Pre-convention model configuration](#pre-convention-configuration) when:
+
+- The applicability condition is simple as it only depends on the type.
+- The configuration needs to be applied at any point a property of the given type is added in the model and overrides Data Annotations and conventions
+
+Use [Finalizing Conventions](#conventions) when:
+
+- The applicability condition is complex.
+- The configuration shouldn't override what is specified by Data Annotations.
+
+Use [Interactive Conventions](#conventions) when:
+
+- Multiple conventions depend on each other. Finalizing conventions run in the order they were added and therefore can't react to changes made by later finalizing conventions.
+- The logic is shared between several contexts. Interactive conventions are safer than other approaches.
diff --git a/entity-framework/core/modeling/constructors.md b/entity-framework/core/modeling/constructors.md
new file mode 100644
index 0000000000..fb6247e35b
--- /dev/null
+++ b/entity-framework/core/modeling/constructors.md
@@ -0,0 +1,263 @@
+---
+title: Entity types with constructors - EF Core
+description: Using constructors to bind data with Entity Framework Core model
+author: SamMonoRT
+ms.date: 02/23/2018
+uid: core/modeling/constructors
+---
+# Entity types with constructors
+
+It's possible to define a constructor with parameters and have EF Core call this constructor when creating an instance of the entity. The constructor parameters can be bound to mapped properties, or to various kinds of services to facilitate behaviors like lazy-loading.
+
+> [!NOTE]
+> Currently, all constructor binding is by convention. Configuration of specific constructors to use is planned for a future release.
+
+## Binding to mapped properties
+
+Consider a typical Blog/Post model:
+
+```csharp
+public class Blog
+{
+    public int Id { get; set; }
+
+    public string Name { get; set; }
+    public string Author { get; set; }
+
+    public ICollection<Post> Posts { get; } = new List<Post>();
+}
+
+public class Post
+{
+    public int Id { get; set; }
+
+    public string Title { get; set; }
+    public string Content { get; set; }
+    public DateTime PostedOn { get; set; }
+
+    public Blog Blog { get; set; }
+}
+```
+
+When EF Core creates instances of these types, such as for the results of a query, it will first call the default parameterless constructor and then set each property to the value from the database. However, if EF Core finds a parameterized constructor with parameter names and types that match those of mapped properties, then it will instead call the parameterized constructor with values for those properties and will not set each property explicitly. For example:
+
+```csharp
+public class Blog
+{
+    public Blog(int id, string name, string author)
+    {
+        Id = id;
+        Name = name;
+        Author = author;
+    }
+
+    public int Id { get; set; }
+
+    public string Name { get; set; }
+    public string Author { get; set; }
+
+    public ICollection<Post> Posts { get; } = new List<Post>();
+}
+
+public class Post
+{
+    public Post(int id, string title, DateTime postedOn)
+    {
+        Id = id;
+        Title = title;
+        PostedOn = postedOn;
+    }
+
+    public int Id { get; set; }
+
+    public string Title { get; set; }
+    public string Content { get; set; }
+    public DateTime PostedOn { get; set; }
+
+    public Blog Blog { get; set; }
+}
+```
+
+Some things to note:
+
+* Not all properties need to have constructor parameters. For example, the Post.Content property is not set by any constructor parameter, so EF Core will set it after calling the constructor in the normal way.
+* The parameter types and names must match property types and names, except that properties can be Pascal-cased while the parameters are camel-cased.
+* EF Core cannot set navigation properties (such as Blog or Posts above) using a constructor.
+* The constructor can be public, private, or have any other accessibility. However, lazy-loading proxies require that the constructor is accessible from the inheriting proxy class. Usually this means making it either public or protected.
+
+### Read-only properties
+
+Once properties are being set via the constructor it can make sense to make some of them read-only. EF Core supports this, but there are some things to look out for:
+
+* Properties without setters are not mapped by convention. (Doing so tends to map properties that should not be mapped, such as computed properties.)
+* Using automatically generated key values requires a key property that is read-write, since the key value needs to be set by the key generator when inserting new entities.
+
+An easy way to avoid these things is to use private setters. For example:
+
+```csharp
+public class Blog
+{
+    public Blog(int id, string name, string author)
+    {
+        Id = id;
+        Name = name;
+        Author = author;
+    }
+
+    public int Id { get; private set; }
+
+    public string Name { get; private set; }
+    public string Author { get; private set; }
+
+    public ICollection<Post> Posts { get; } = new List<Post>();
+}
+
+public class Post
+{
+    public Post(int id, string title, DateTime postedOn)
+    {
+        Id = id;
+        Title = title;
+        PostedOn = postedOn;
+    }
+
+    public int Id { get; private set; }
+
+    public string Title { get; private set; }
+    public string Content { get; set; }
+    public DateTime PostedOn { get; private set; }
+
+    public Blog Blog { get; set; }
+}
+```
+
+EF Core sees a property with a private setter as read-write, which means that all properties are mapped as before and the key can still be store-generated.
+
+An alternative to using private setters is to make properties really read-only and add more explicit mapping in OnModelCreating. Likewise, some properties can be removed completely and replaced with only fields. For example, consider these entity types:
+
+```csharp
+public class Blog
+{
+    private int _id;
+
+    public Blog(string name, string author)
+    {
+        Name = name;
+        Author = author;
+    }
+
+    public string Name { get; }
+    public string Author { get; }
+
+    public ICollection<Post> Posts { get; } = new List<Post>();
+}
+
+public class Post
+{
+    private int _id;
+
+    public Post(string title, DateTime postedOn)
+    {
+        Title = title;
+        PostedOn = postedOn;
+    }
+
+    public string Title { get; }
+    public string Content { get; set; }
+    public DateTime PostedOn { get; }
+
+    public Blog Blog { get; set; }
+}
+```
+
+And this configuration in OnModelCreating:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Blog>(
+        b =>
+        {
+            b.HasKey("_id");
+            b.Property(e => e.Author);
+            b.Property(e => e.Name);
+        });
+
+    modelBuilder.Entity<Post>(
+        b =>
+        {
+            b.HasKey("_id");
+            b.Property(e => e.Title);
+            b.Property(e => e.PostedOn);
+        });
+}
+```
+
+Things to note:
+
+* The key "property" is now a field. It is not a `readonly` field so that store-generated keys can be used.
+* The other properties are read-only properties set only in the constructor.
+* If the primary key value is only ever set by EF or read from the database, then there is no need to include it in the constructor. This leaves the key "property" as a simple field and makes it clear that it should not be set explicitly when creating new blogs or posts.
+
+> [!NOTE]
+> This code will result in compiler warning '169' indicating that the field is never used. This can be ignored since in reality EF Core is using the field in an extralinguistic manner.
+
+## Injecting services
+
+EF Core can also inject "services" into an entity type's constructor. For example, the following can be injected:
+
+* `DbContext` - the current context instance, which can also be typed as your derived DbContext type
+* `ILazyLoader` - the lazy-loading service--see the [lazy-loading documentation](xref:core/querying/related-data) for more details
+* `Action<object, string>` - a lazy-loading delegate--see the [lazy-loading documentation](xref:core/querying/related-data) for more details
+* `IEntityType` - the EF Core metadata associated with this entity type
+
+> [!NOTE]
+> Currently, only services known by EF Core can be injected. Support for injecting application services is being considered for a future release.
+
+For example, an injected DbContext can be used to selectively access the database to obtain information about related entities without loading them all. In the example below this is used to obtain the number of posts in a blog without loading the posts:
+
+```csharp
+public class Blog
+{
+    public Blog()
+    {
+    }
+
+    private Blog(BloggingContext context)
+    {
+        Context = context;
+    }
+
+    private BloggingContext Context { get; set; }
+
+    public int Id { get; set; }
+    public string Name { get; set; }
+    public string Author { get; set; }
+
+    public ICollection<Post> Posts { get; set; }
+
+    public int PostsCount
+        => Posts?.Count
+           ?? Context?.Set<Post>().Count(p => Id == EF.Property<int?>(p, "BlogId"))
+           ?? 0;
+}
+
+public class Post
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+    public DateTime PostedOn { get; set; }
+
+    public Blog Blog { get; set; }
+}
+```
+
+A few things to notice about this:
+
+* The constructor is private, since it is only ever called by EF Core, and there is another public constructor for general use.
+* The code using the injected service (that is, the context) is defensive against it being `null` to handle cases where EF Core is not creating the instance.
+* Because service is stored in a read/write property it will be reset when the entity is attached to a new context instance.
+
+> [!WARNING]
+> Injecting the DbContext like this is often considered an anti-pattern since it couples your entity types directly to EF Core. Carefully consider all options before using service injection like this.
diff --git a/entity-framework/core/modeling/data-seeding.md b/entity-framework/core/modeling/data-seeding.md
new file mode 100644
index 0000000000..218eb4400b
--- /dev/null
+++ b/entity-framework/core/modeling/data-seeding.md
@@ -0,0 +1,118 @@
+---
+title: Data Seeding - EF Core
+description: Using data seeding to populate a database with an initial set of data using Entity Framework Core
+author: AndriySvyryd
+ms.date: 10/10/2024
+uid: core/modeling/data-seeding
+---
+
+# Data Seeding
+
+Data seeding is the process of populating a database with an initial set of data.
+
+There are several ways this can be accomplished in EF Core:
+
+* [Configuration options data seeding (`UseSeeding`)](#use-seeding-method)
+* [Custom initialization logic](#custom-initialization-logic)
+* [Model managed data (`HasData`)](#model-seed-data)
+* [Manual migration customization](#manual-migration-customization)
+
+<a name="use-seeding-method"></a>
+
+## Configuration options `UseSeeding` and `UseAsyncSeeding` methods
+
+EF 9 introduced <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseSeeding*> and <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseAsyncSeeding*> methods, which provide a convenient way of seeding the database with initial data. These methods aim to improve the experience of using custom initialization logic (explained below). They provide one clear location where all the data seeding code can be placed. Moreover, the code inside <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseSeeding*> and <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseAsyncSeeding*> methods is protected by the [migration locking mechanism](/ef/core/what-is-new/ef-core-9.0/whatsnew#concurrent-migrations) to prevent concurrency issues.
+
+The new seeding methods are called as part of <xref:Microsoft.EntityFrameworkCore.Storage.IDatabaseCreator.EnsureCreated*> operation, <xref:Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.Migrate*> and `dotnet ef database update` command, even if there are no model changes and no migrations were applied.
+
+> [!TIP]
+> Using <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseSeeding*> and <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseAsyncSeeding*> is the recommended way of seeding the database with initial data when working with EF Core.
+
+These methods can be set up in the [options configuration step](/ef/core/dbcontext-configuration/#dbcontextoptions). Here is an example:
+
+[!code-csharp[ContextOptionSeeding](../../../samples/core/Modeling/DataSeeding/DataSeedingContext.cs?name=ContextOptionSeeding)]
+
+> [!NOTE]
+> <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseSeeding*> is called from the <xref:Microsoft.EntityFrameworkCore.Storage.IDatabaseCreator.EnsureCreated*> method, and <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseAsyncSeeding*> is called from the <xref:Microsoft.EntityFrameworkCore.Storage.IDatabaseCreator.EnsureCreatedAsync*> method. When using this feature, it is recommended to implement both <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseSeeding*> and <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseAsyncSeeding*> methods using similar logic, even if the code using EF is asynchronous. EF Core tooling currently relies on the synchronous version of the method and will not seed the database correctly if the <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseSeeding*> method is not implemented.
+
+<a name="custom-initialization-logic"></a>
+
+## Custom initialization logic
+
+A straightforward and powerful way to perform data seeding is to use <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChangesAsync*> before the main application logic begins execution. It is recommended to use <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseSeeding*> and <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseAsyncSeeding*> for that purpose, however sometimes using these methods is not a good solution. An example scenario is when seeding requires using two different contexts in one transaction. Below is a code sample performing custom initialization in the application directly:
+
+[!code-csharp[Main](../../../samples/core/Modeling/DataSeeding/Program.cs?name=CustomSeeding)]
+
+> [!WARNING]
+> The seeding code should not be part of the normal app execution as this can cause concurrency issues when multiple instances are running and would also require the app having permission to modify the database schema.
+
+Depending on the constraints of your deployment the initialization code can be executed in different ways:
+
+* Running the initialization app locally
+* Deploying the initialization app with the main app, invoking the initialization routine and disabling or removing the initialization app.
+
+This can usually be automated by using [publish profiles](/aspnet/core/host-and-deploy/visual-studio-publish-profiles).
+
+<a name="model-seed-data"></a>
+
+## Model managed data
+
+Data can also be associated with an entity type as part of the model configuration. Then, EF Core [migrations](xref:core/managing-schemas/migrations/index) can automatically compute what insert, update or delete operations need to be applied when upgrading the database to a new version of the model.
+
+> [!WARNING]
+> Migrations only considers model changes when determining what operation should be performed to get the managed data into the desired state. Thus any changes to the data performed outside of migrations might be lost or cause an error.
+
+As an example, this will configure managed data for a `Country` in `OnModelCreating`:
+
+[!code-csharp[CountrySeed](../../../samples/core/Modeling/DataSeeding/ManagingDataContext.cs?name=CountrySeed)]
+
+To add entities that have a relationship, the foreign key values need to be specified:
+
+[!code-csharp[CitySeed](../../../samples/core/Modeling/DataSeeding/ManagingDataContext.cs?name=CitySeed)]
+
+When managing data for many-to-many navigations, the join entity needs to be configured explicitly. If the entity type has any properties in shadow state (e.g. the `LanguageCountry` join entity below), an anonymous class can be used to provide the values:
+
+[!code-csharp[LanguageSeed](../../../samples/core/Modeling/DataSeeding/ManagingDataContext.cs?name=LanguageSeed)]
+
+Owned entity types can be configured in a similar fashion:
+
+[!code-csharp[LanguageDetailsSeed](../../../samples/core/Modeling/DataSeeding/ManagingDataContext.cs?name=LanguageDetailsSeed)]
+
+See the [full sample project](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Modeling/DataSeeding) for more context.
+
+Once the data has been added to the model, [migrations](xref:core/managing-schemas/migrations/index) should be used to apply the changes.
+
+> [!TIP]
+> If you need to apply migrations as part of an automated deployment you can [create a SQL script](xref:core/managing-schemas/migrations/applying#sql-scripts) that can be previewed before execution.
+
+Alternatively, you can use <xref:Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade.EnsureCreatedAsync*> to create a new database containing the managed data, for example for a test database or when using the in-memory provider or any non-relational database. Note that if the database already exists, <xref:Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade.EnsureCreatedAsync*> will neither update the schema nor managed data in the database. For relational databases you shouldn't call <xref:Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade.EnsureCreatedAsync*> if you plan to use Migrations.
+
+> [!NOTE]
+> Populating the database using the <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.EntityTypeBuilder`1.HasData*> method used to be referred to as "data seeding". This naming sets incorrect expectations, as the feature has a number of limitations and is only appropriate for specific types of data. That is why we decided to rename it to "model managed data". <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseSeeding*> and <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseAsyncSeeding*> methods should be used for general purpose data seeding.
+
+### Limitations of model managed data
+
+This type of data is managed by migrations and the script to update the data that's already in the database needs to be generated without connecting to the database. This imposes some restrictions:
+
+* The primary key value needs to be specified even if it's usually generated by the database. It will be used to detect data changes between migrations.
+* Previously inserted data will be removed if the primary key is changed in any way.
+
+Therefore this feature is most useful for static data that's not expected to change outside of migrations and does not depend on anything else in the database, for example ZIP codes.
+
+If your scenario includes any of the following it is recommended to use <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseSeeding*> and <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseAsyncSeeding*> methods described in the first section:
+
+* Temporary data for testing
+* Data that depends on database state
+* Data that is large (seeding data gets captured in migration snapshots, and large data can quickly lead to huge files and degraded performance).
+* Data that needs key values to be generated by the database, including entities that use alternate keys as the identity
+* Data that requires custom transformation (that is not handled by [value conversions](xref:core/modeling/value-conversions)), such as some password hashing
+* Data that requires calls to external API, such as ASP.NET Core Identity roles and users creation
+* Data that isn't fixed and deterministic, such as seeding to `DateTime.Now`.
+
+<a name="manual-migration-customization"></a>
+
+## Manual migration customization
+
+When a migration is added the changes to the data specified with <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.EntityTypeBuilder`1.HasData*> are transformed to calls to `InsertData()`, `UpdateData()`, and `DeleteData()`. One way of working around some of the limitations of <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.EntityTypeBuilder`1.HasData*> is to manually add these calls or [custom operations](xref:core/managing-schemas/migrations/operations) to the migration instead.
+
+[!code-csharp[CustomInsert](../../../samples/core/Modeling/DataSeeding/Migrations/20241016041555_Initial.cs?name=CustomInsert)]
diff --git a/entity-framework/core/modeling/dynamic-model.md b/entity-framework/core/modeling/dynamic-model.md
new file mode 100644
index 0000000000..71e8576e73
--- /dev/null
+++ b/entity-framework/core/modeling/dynamic-model.md
@@ -0,0 +1,32 @@
+---
+title: Alternating between multiple models with the same DbContext type - EF Core
+description: Alternating between multiple models with the same DbContext type using Entity Framework Core
+author: AndriySvyryd
+ms.date: 01/03/2020
+uid: core/modeling/dynamic-model
+---
+# Alternating between multiple models with the same DbContext type
+
+The model built in `OnModelCreating` can use a property on the context to change how the model is built. For example, suppose you wanted to configure an entity differently based on some property:
+
+[!code-csharp[Main](../../../samples/core/Modeling/DynamicModel/DynamicContext.cs?name=OnModelCreating)]
+
+Unfortunately, this code wouldn't work as-is, since EF builds the model and runs `OnModelCreating` only once, caching the result for performance reasons. However, you can hook into the model caching mechanism to make EF aware of the property producing different models.
+
+## IModelCacheKeyFactory
+
+EF uses the `IModelCacheKeyFactory` to generate cache keys for models; by default, EF assumes that for any given context type the model will be the same, so the default implementation of this service returns a key that just contains the context type. To produce different models from the same context type, you need to replace the `IModelCacheKeyFactory` service with the correct implementation; the generated key will be compared to other model keys using the `Equals` method, taking into account all the variables that affect the model.
+
+The following implementation takes the `UseIntProperty` into account when producing a model cache key:
+
+[!code-csharp[Main](../../../samples/core/Modeling/DynamicModel/DynamicModelCacheKeyFactory.cs?name=DynamicModel)]
+
+You also have to implement the overload of the Create method that also handles design-time model caching. As in the following example:
+
+[!code-csharp[Main](../../../samples/core/Modeling/DynamicModel/DynamicModelCacheKeyFactoryDesignTimeSupport.cs?name=DynamicModelDesignTimeSupport)]
+
+Finally, register your new `IModelCacheKeyFactory` in your context's `OnConfiguring`:
+
+[!code-csharp[Main](../../../samples/core/Modeling/DynamicModel/DynamicContext.cs?name=OnConfiguring)]
+
+See the [full sample project](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Modeling/DynamicModel) for more context.
diff --git a/entity-framework/core/modeling/entity-properties.md b/entity-framework/core/modeling/entity-properties.md
new file mode 100644
index 0000000000..3f378076b7
--- /dev/null
+++ b/entity-framework/core/modeling/entity-properties.md
@@ -0,0 +1,206 @@
+---
+title: Entity Properties - EF Core
+description: How to configure and map entity properties using Entity Framework Core
+author: roji
+ms.date: 10/12/2021
+uid: core/modeling/entity-properties
+---
+# Entity Properties
+
+Each entity type in your model has a set of properties, which EF Core will read and write from the database. If you're using a relational database, entity properties map to table columns.
+
+## Included and excluded properties
+
+By [convention](xref:core/modeling/index#built-in-conventions), all public properties with a getter and a setter will be included in the model.
+
+Specific properties can be excluded as follows:
+
+### [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityProperties/DataAnnotations/IgnoreProperty.cs?name=IgnoreProperty&highlight=6)]
+
+### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityProperties/FluentAPI/IgnoreProperty.cs?name=IgnoreProperty&highlight=3,4)]
+
+***
+
+## Column names
+
+By convention, when using a relational database, entity properties are mapped to table columns having the same name as the property.
+
+If you prefer to configure your columns with different names, you can do so as following code snippet:
+
+### [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityProperties/DataAnnotations/ColumnName.cs?Name=ColumnName&highlight=3)]
+
+### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityProperties/FluentAPI/ColumnName.cs?Name=ColumnName&highlight=3-5)]
+
+***
+
+## Column data types
+
+When using a relational database, the database provider selects a data type based on the .NET type of the property. It also takes into account other metadata, such as the configured [maximum length](#maximum-length), whether the property is part of a primary key, etc.
+
+For example, the SQL Server provider maps `DateTime` properties to `datetime2(7)` columns, and `string` properties to `nvarchar(max)` columns (or to `nvarchar(450)` for properties that are used as a key).
+
+You can also configure your columns to specify an exact data type for a column. For example, the following code configures `Url` as a non-unicode string with maximum length of `200` and `Rating` as decimal with precision of `5` and scale of `2`:
+
+### [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityProperties/DataAnnotations/ColumnDataType.cs?name=ColumnDataType&highlight=5,8)]
+
+### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityProperties/FluentAPI/ColumnDataType.cs?name=ColumnDataType&highlight=6-7)]
+
+***
+
+### Maximum length
+
+Configuring a maximum length provides a hint to the database provider about the appropriate column data type to choose for a given property. Maximum length only applies to array data types, such as `string` and `byte[]`.
+
+> [!NOTE]
+> Entity Framework does not do any validation of maximum length before passing data to the provider. It is up to the provider or data store to validate if appropriate. For example, when targeting SQL Server, exceeding the maximum length will result in an exception as the data type of the underlying column will not allow excess data to be stored.
+
+In the following example, configuring a maximum length of 500 will cause a column of type `nvarchar(500)` to be created on SQL Server:
+
+#### [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityProperties/DataAnnotations/MaxLength.cs?name=MaxLength&highlight=5)]
+
+#### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityProperties/FluentAPI/MaxLength.cs?name=MaxLength&highlight=3-5)]
+
+***
+
+### Precision and Scale
+
+Some relational data types support the precision and scale facets; these control what values can be stored, and how much storage is needed for the column. Which data types support precision and scale is database-dependent, but in most databases `decimal` and `DateTime` types do support these facets. For `decimal` properties, precision defines the maximum number of digits needed to express any value the column will contain, and scale defines the maximum number of decimal places needed. For `DateTime` properties, precision defines the maximum number of digits needed to express fractions of seconds, and scale is not used.
+
+> [!NOTE]
+> Entity Framework does not do any validation of precision or scale before passing data to the provider. It is up to the provider or data store to validate as appropriate. For example, when targeting SQL Server, a column of data type `datetime` does not allow the precision to be set, whereas a `datetime2` one can have precision between 0 and 7 inclusive.
+
+In the following example, configuring the `Score` property to have precision 14 and scale 2 will cause a column of type `decimal(14,2)` to be created on SQL Server, and configuring the `LastUpdated` property to have precision 3 will cause a column of type `datetime2(3)`:
+
+#### [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityProperties/DataAnnotations/PrecisionAndScale.cs?name=PrecisionAndScale&highlight=4,6)]
+
+Scale is never defined without first defining precision, so the Data Annotation for defining the scale is `[Precision(precision, scale)]`.
+
+#### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityProperties/FluentAPI/PrecisionAndScale.cs?name=PrecisionAndScale&highlight=5,9)]
+
+Scale is never defined without first defining precision, so the Fluent API for defining the scale is `HasPrecision(precision, scale)`.
+
+***
+
+### Unicode
+
+In some relational databases, different types exist to represent Unicode and non-Unicode text data. For example, in SQL Server, `nvarchar(x)` is used to represent Unicode data in UTF-16, while `varchar(x)` is used to represent non-Unicode data (but see the notes on [SQL Server UTF-8 support](xref:core/providers/sql-server/columns#unicode-and-utf-8)). For databases which don't support this concept, configuring this has no effect.
+
+Text properties are configured as Unicode by default. You can configure a column as non-Unicode as follows:
+
+#### [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityProperties/DataAnnotations/Unicode.cs?name=Unicode&highlight=6-7)]
+
+#### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityProperties/FluentAPI/Unicode.cs?name=Unicode&highlight=5)]
+
+***
+
+## Required and optional properties
+
+A property is considered optional if it is valid for it to contain `null`. If `null` is not a valid value to be assigned to a property then it is considered to be a required property. When mapping to a relational database schema, required properties are created as non-nullable columns, and optional properties are created as nullable columns.
+
+### Conventions
+
+By convention, a property whose .NET type can contain null will be configured as optional, whereas properties whose .NET type cannot contain null will be configured as required. For example, all properties with .NET value types (`int`, `decimal`, `bool`, etc.) are configured as required, and all properties with nullable .NET value types (`int?`, `decimal?`, `bool?`, etc.) are configured as optional.
+
+C# [nullable reference types (NRT)](/dotnet/csharp/tutorials/nullable-reference-types) allow reference types to be annotated, indicating whether it is valid for them to contain null or not. This feature is enabled by default in new project templates, but remains disabled in existing projects unless explicitly opted into. Nullable reference types affect EF Core's behavior in the following way:
+
+* If nullable reference types are disabled, all properties with .NET reference types are configured as optional by convention (for example, `string`).
+* If nullable reference types are enabled, properties will be configured based on the C# nullability of their .NET type: `string?` will be configured as optional, but `string` will be configured as required.
+
+The following example shows an entity type with required and optional properties, with the nullable reference feature disabled and enabled:
+
+#### [With NRT](#tab/with-nrt)
+
+[!code-csharp[Main](../../../samples/core/Miscellaneous/NullableReferenceTypes/Customer.cs?name=Customer&highlight=4-6)]
+
+#### [Without NRT](#tab/without-nrt)
+
+[!code-csharp[Main](../../../samples/core/Miscellaneous/NullableReferenceTypes/CustomerWithoutNullableReferenceTypes.cs?name=Customer&highlight=5,8)]
+
+***
+
+Using nullable reference types is recommended since it flows the nullability expressed in C# code to EF Core's model and to the database, and obviates the use of the Fluent API or Data Annotations to express the same concept twice.
+
+> [!NOTE]
+> Exercise caution when enabling nullable reference types on an existing project: reference type properties which were previously configured as optional will now be configured as required, unless they are explicitly annotated to be nullable. When managing a relational database schema, this may cause migrations to be generated which alter the database column's nullability.
+
+For more information on nullable reference types and how to use them with EF Core, [see the dedicated documentation page for this feature](xref:core/miscellaneous/nullable-reference-types).
+
+### Explicit configuration
+
+A property that would be optional by convention can be configured to be required as follows:
+
+#### [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityProperties/DataAnnotations/Required.cs?name=Required&highlight=5)]
+
+#### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityProperties/FluentAPI/Required.cs?name=Required&highlight=3-5)]
+
+***
+
+## Column collations
+
+A collation can be defined on text columns, determining how they are compared and ordered. For example, the following code snippet configures a SQL Server column to be case-insensitive:
+
+[!code-csharp[Main](../../../samples/core/Miscellaneous/Collations/Program.cs?name=ColumnCollation)]
+
+If all columns in a database need to use a certain collation, define the collation at the database level instead.
+
+General information about EF Core support for collations can be found in the [collation documentation page](xref:core/miscellaneous/collations-and-case-sensitivity).
+
+## Column comments
+
+You can set an arbitrary text comment that gets set on the database column, allowing you to document your schema in the database:
+
+### [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityProperties/DataAnnotations/ColumnComment.cs?name=ColumnComment&highlight=5)]
+
+### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityProperties/FluentAPI/ColumnComment.cs?name=ColumnComment&highlight=5)]
+
+***
+
+## Column order
+
+By default when creating a table with [Migrations](xref:core/managing-schemas/migrations/index), EF Core orders primary key columns first, followed by properties of the entity type and owned types, and finally properties from base types. You can, however, specify a different column order:
+
+### [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[](../../../samples/core/Modeling/EntityProperties/DataAnnotations/ColumnOrder.cs#snippet_ColumnAttribute)]
+
+The Fluent API can be used to override ordering made with attributes, including resolving any conflicts when attributes on different properties specify the same order number.
+
+### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[](../../../samples/core/Modeling/EntityProperties/FluentAPI/ColumnOrder.cs#snippet_HasColumnOrder)]
+
+***
+
+Note that, in the general case, most databases only support ordering columns when the table is created. This means that the column order attribute cannot be used to re-order columns in an existing table.
diff --git a/entity-framework/core/modeling/entity-types.md b/entity-framework/core/modeling/entity-types.md
new file mode 100644
index 0000000000..a89541f7d5
--- /dev/null
+++ b/entity-framework/core/modeling/entity-types.md
@@ -0,0 +1,161 @@
+---
+title: Entity Types - EF Core
+description: How to configure and map entity types using Entity Framework Core
+author: AndriySvyryd
+ms.date: 10/25/2021
+uid: core/modeling/entity-types
+---
+# Entity Types
+
+Including a DbSet of a type on your context means that it is included in EF Core's model; we usually refer to such a type as an *entity*. EF Core can read and write entity instances from/to the database, and if you're using a relational database, EF Core can create tables for your entities via migrations.
+
+## Including types in the model
+
+By convention, types that are exposed in DbSet properties on your context are included in the model as entities. Entity types that are specified in the `OnModelCreating` method are also included, as are any types that are found by recursively exploring the navigation properties of other discovered entity types.
+
+In the code sample below, all types are included:
+
+* `Blog` is included because it's exposed in a DbSet property on the context.
+* `Post` is included because it's discovered via the `Blog.Posts` navigation property.
+* `AuditEntry` because it is specified in `OnModelCreating`.
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityTypes/EntityTypes.cs?name=EntityTypes&highlight=3,7,16)]
+
+## Excluding types from the model
+
+If you don't want a type to be included in the model, you can exclude it:
+
+### [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityTypes/DataAnnotations/IgnoreType.cs?name=IgnoreType&highlight=1)]
+
+### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityTypes/FluentAPI/IgnoreType.cs?name=IgnoreType&highlight=3)]
+
+***
+
+### Excluding from migrations
+
+It is sometimes useful to have the same entity type mapped in multiple `DbContext` types. This is especially true when using [bounded contexts](https://www.martinfowler.com/bliki/BoundedContext.html), for which it is common to have a different `DbContext` type for each bounded context.
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityTypes/FluentAPI/TableExcludeFromMigrations.cs?name=TableExcludeFromMigrations&highlight=4)]
+
+With this configuration migrations will not create the `AspNetUsers` table, but `IdentityUser` is still included in the model and can be used normally.
+
+If you need to start managing the table using migrations again then a new migration should be created where `AspNetUsers` is not excluded. The next migration will now contain any changes made to the table.
+
+## Table name
+
+By convention, each entity type will be set up to map to a database table with the same name as the DbSet property that exposes the entity. If no DbSet exists for the given entity, the class name is used.
+
+You can manually configure the table name:
+
+### [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityTypes/DataAnnotations/TableName.cs?Name=TableName&highlight=1)]
+
+### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityTypes/FluentAPI/TableName.cs?Name=TableName&highlight=3-4)]
+
+***
+
+## Table schema
+
+When using a relational database, tables are by convention created in your database's default schema. For example, Microsoft SQL Server will use the `dbo` schema (SQLite does not support schemas).
+
+You can configure tables to be created in a specific schema as follows:
+
+### [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityTypes/DataAnnotations/TableNameAndSchema.cs?name=TableNameAndSchema&highlight=1)]
+
+### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityTypes/FluentAPI/TableNameAndSchema.cs?name=TableNameAndSchema&highlight=3-4)]
+
+***
+
+Rather than specifying the schema for each table, you can also define the default schema at the model level with the fluent API:
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityTypes/FluentAPI/DefaultSchema.cs?name=DefaultSchema&highlight=3)]
+
+Note that setting the default schema will also affect other database objects, such as sequences.
+
+## View mapping
+
+Entity types can be mapped to database views using the Fluent API.
+
+> [!NOTE]
+> EF will assume that the referenced view already exists in the database, it will not create it automatically in a migration.
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityTypes/FluentAPI/ViewNameAndSchema.cs?name=ViewNameAndSchema&highlight=1)]
+
+ Mapping to a view will remove the default table mapping, but the entity type can also be mapped to a table explicitly. In this case the view mapping will be used for queries and the table mapping will be used for updates.
+
+> [!TIP]
+> To test keyless entity types mapped to views using the in-memory provider, map them to a query via <xref:Microsoft.EntityFrameworkCore.InMemoryEntityTypeBuilderExtensions.ToInMemoryQuery*>. See the [in-memory provider docs](xref:core/testing/testing-without-the-database#in-memory-provider) for more information.
+
+## Table-valued function mapping
+
+It's possible to map an entity type to a table-valued function (TVF) instead of a table in the database. To illustrate this, let's define another entity that represents blog with multiple posts. In the example, the entity is [keyless](xref:core/modeling/keyless-entity-types), but it doesn't have to be.
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityTypes/EntityTypes.cs#BlogWithMultiplePostsEntity)]
+
+Next, create the following table-valued function in the database, which returns only blogs with multiple posts as well as the number of posts associated with each of these blogs:
+
+```sql
+CREATE FUNCTION dbo.BlogsWithMultiplePosts()
+RETURNS TABLE
+AS
+RETURN
+(
+    SELECT b.Url, COUNT(p.BlogId) AS PostCount
+    FROM Blogs AS b
+    JOIN Posts AS p ON b.BlogId = p.BlogId
+    GROUP BY b.BlogId, b.Url
+    HAVING COUNT(p.BlogId) > 1
+)
+```
+
+Now, the entity `BlogWithMultiplePosts` can be mapped to this function in a following way:
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityTypes/EntityTypes.cs#QueryableFunctionConfigurationToFunction)]
+
+> [!NOTE]
+> In order to map an entity to a table-valued function the function must be parameterless.
+
+Conventionally, the entity properties will be mapped to matching columns returned by the TVF. If the columns returned by the TVF have different names than the entity property, then the entity's columns can be configured using `HasColumnName` method, just like when mapping to a regular table.
+
+When the entity type is mapped to a table-valued function, the query:
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityTypes/Program.cs#ToFunctionQuery)]
+
+Produces the following SQL:
+
+```sql
+SELECT [b].[Url], [b].[PostCount]
+FROM [dbo].[BlogsWithMultiplePosts]() AS [b]
+WHERE [b].[PostCount] > 3
+```
+
+## Table comments
+
+You can set an arbitrary text comment that gets set on the database table, allowing you to document your schema in the database:
+
+### [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityTypes/DataAnnotations/TableComment.cs?name=TableComment&highlight=1)]
+
+### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityTypes/FluentAPI/TableComment.cs?name=TableComment&highlight=4)]
+
+***
+
+## Shared-type entity types
+
+Entity types that use the same CLR type are known as shared-type entity types. These entity types need to be configured with a unique name, which must be supplied whenever the shared-type entity type is used, in addition to the CLR type. This means that the corresponding `DbSet` property must be implemented using a `Set` call.
+
+[!code-csharp[Main](../../../samples/core/Modeling/ShadowAndIndexerProperties/SharedType.cs?name=SharedType&highlight=3,7)]
diff --git a/entity-framework/core/modeling/generated-properties.md b/entity-framework/core/modeling/generated-properties.md
new file mode 100644
index 0000000000..c21189aec0
--- /dev/null
+++ b/entity-framework/core/modeling/generated-properties.md
@@ -0,0 +1,156 @@
+---
+title: Generated Values - EF Core
+description: How to configure value generation for properties when using Entity Framework Core
+author: AndriySvyryd
+ms.date: 5/27/2025
+uid: core/modeling/generated-properties
+---
+
+# Generated Values
+
+Database columns can have their values generated in various ways: primary key columns are frequently auto-incrementing integers, other columns have default or computed values, etc. This page details various patterns for configuration value generation with EF Core.
+
+## Default values
+
+On relational databases, a column can be configured with a default value; if a row is inserted without a value for that column, the default value will be used.
+
+You can configure a default value on a property:
+
+[!code-csharp[Main](../../../samples/core/Modeling/GeneratedProperties/FluentAPI/DefaultValue.cs?name=DefaultValue&highlight=3)]
+
+You can also specify a SQL fragment that is used to calculate the default value:
+
+[!code-csharp[Main](../../../samples/core/Modeling/GeneratedProperties/FluentAPI/DefaultValueSql.cs?name=DefaultValueSql&highlight=3)]
+
+The default value also takes effect when adding a new column to a table; existing rows which do not yet have a value for the new column will have the default value set on them.
+
+### Default value constraint name
+
+Starting with EF 10, for SQL Server you can explicitly specify the name for default value constraints, giving you more control over your database schema.
+
+[!code-csharp[Main](../../../samples/core/Modeling/GeneratedProperties/FluentAPI/DefaultValue.cs?name=DefaultValueNamed&highlight=3)]
+
+[!code-csharp[Main](../../../samples/core/Modeling/GeneratedProperties/FluentAPI/DefaultValueSql.cs?name=DefaultValueSqlNamed&highlight=3)]
+
+You can also call `UseNamedDefaultConstraints` to enable automatic naming of all the default constraints. Note that if you have existing migrations then the next migration you add will rename every single default constraint in your model.
+
+```C#
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.UseNamedDefaultConstraints();
+}
+```
+
+## Computed columns
+
+On most relational databases, a column can be configured to have its value computed in the database, typically with an expression referring to other columns:
+
+[!code-csharp[Main](../../../samples/core/Modeling/GeneratedProperties/FluentAPI/ComputedColumn.cs?name=DefaultComputedColumn&highlight=3)]
+
+The above creates a *virtual* computed column, whose value is computed every time it is fetched from the database. You may also specify that a computed column be *stored* (sometimes called *persisted*), meaning that it is computed on every update of the row, and is stored on disk alongside regular columns:
+
+[!code-csharp[Main](../../../samples/core/Modeling/GeneratedProperties/FluentAPI/ComputedColumn.cs?name=StoredComputedColumn&highlight=3)]
+
+## Primary keys
+
+By convention, non-composite primary keys of type short, int, long, or Guid are set up to have values generated for inserted entities if a value isn't provided by the application. Your database provider typically takes care of the necessary configuration; for example, a numeric primary key in SQL Server is automatically set up to be an IDENTITY column.
+
+For more information, [see the documentation about keys](xref:core/modeling/keys) and [guidance for specific inheritance mapping strategies](xref:core/modeling/inheritance#key-generation).
+
+## Explicitly configuring value generation
+
+We saw above that EF Core automatically sets up value generation for primary keys - but we may want to do the same for non-key properties. You can configure any property to have its value generated for inserted entities as follows:
+
+### [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[Main](../../../samples/core/Modeling/GeneratedProperties/DataAnnotations/ValueGeneratedOnAdd.cs?name=ValueGeneratedOnAdd&highlight=6)]
+
+### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[Main](../../../samples/core/Modeling/GeneratedProperties/FluentAPI/ValueGeneratedOnAdd.cs?name=ValueGeneratedOnAdd&highlight=5)]
+
+***
+
+Similarly, a property can be configured to have its value generated on add or update:
+
+### [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[Main](../../../samples/core/Modeling/GeneratedProperties/DataAnnotations/ValueGeneratedOnAddOrUpdate.cs?name=ValueGeneratedOnAddOrUpdate&highlight=6)]
+
+### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[Main](../../../samples/core/Modeling/GeneratedProperties/FluentAPI/ValueGeneratedOnAddOrUpdate.cs?name=ValueGeneratedOnAddOrUpdate&highlight=5)]
+
+***
+
+Unlike with default values or computed columns, we are not specifying *how* the values are to be generated; that depends on the database provider being used. Database providers may automatically set up value generation for some property types, but others may require you to manually set up how the value is generated.
+
+For example, on SQL Server, when a GUID property is configured as a primary key, the provider automatically performs value generation client-side, using an algorithm to generate optimal sequential GUID values. However, specifying <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder.ValueGeneratedOnAdd*> on a DateTime property will have no effect ([see the section below for DateTime value generation](#datetime-value-generation)).
+
+Similarly, byte[] properties that are configured as generated on add or update and marked as concurrency tokens are set up with the rowversion data type, so that values are automatically generated in the database. However, specifying <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder.ValueGeneratedOnAdd*> has no effect.
+
+Consult your provider's documentation for the specific value generation techniques it supports. The SQL Server value generation documentation can be found [here](xref:core/providers/sql-server/value-generation).
+
+## Date/time value generation
+
+A common request is to have a database column which contains the date/time for when the row was first inserted (value generated on add), or for when it was last updated (value generated on add or update). As there are various strategies to do this, EF Core providers usually don't set up value generation automatically for date/time columns - you have to configure this yourself.
+
+### Creation timestamp
+
+Configuring a date/time column to have the creation timestamp of the row is usually a matter of configuring a default value with the appropriate SQL function. For example, on SQL Server you may use the following:
+
+[!code-csharp[Main](../../../samples/core/Modeling/GeneratedProperties/FluentAPI/DefaultValueSql.cs?name=DefaultValueSql&highlight=5)]
+
+Be sure to select the appropriate function, as several may exist (e.g. `GETDATE()` vs. `GETUTCDATE()`).
+
+### Update timestamp
+
+Although stored computed columns seem like a good solution for managing last-updated timestamps, databases usually don't allow specifying functions such as `GETDATE()` in a computed column. As an alternative, you can set up a database trigger to achieve the same effect:
+
+```sql
+CREATE TRIGGER [dbo].[Blogs_UPDATE] ON [dbo].[Blogs]
+    AFTER UPDATE
+AS
+BEGIN
+    SET NOCOUNT ON;
+
+    IF ((SELECT TRIGGER_NESTLEVEL()) > 1) RETURN;
+
+    UPDATE B
+    SET LastUpdated = GETDATE()
+    FROM dbo.Blogs AS B
+    INNER JOIN INSERTED AS I
+        ON B.BlogId = I.BlogId
+END
+```
+
+For information on creating triggers, [see the documentation on using raw SQL in migrations](xref:core/managing-schemas/migrations/managing#adding-raw-sql).
+
+## Overriding value generation
+
+Although a property is configured for value generation, in many cases you may still explicitly specify a value for it. Whether this will actually work depends on the specific value generation mechanism that has been configured; while you may specify an explicit value instead of using a column's default value, the same cannot be done with computed columns.
+
+To override value generation with an explicit value, simply set the property to any value that is not the CLR default value for that property's type (`null` for `string`, `0` for `int`, `Guid.Empty` for `Guid`, etc.).
+
+> [!NOTE]
+> Trying to insert explicit values into SQL Server IDENTITY fails by default; [see these docs for a workaround](xref:core/providers/sql-server/value-generation#inserting-explicit-values-into-identity-columns).
+
+To provide an explicit value for properties that have been configured as value generated on add or update, you must also configure the property as follows:
+
+[!code-csharp[Main](../../../samples/core/Modeling/GeneratedProperties/FluentAPI/ValueGeneratedOnAddOrUpdateWithPropertySaveBehavior.cs?name=ValueGeneratedOnAddOrUpdateWithPropertySaveBehavior&highlight=5)]
+
+## No value generation
+
+Apart from specific scenarios such as those described above, properties typically have no value generation configured; this means that it's up to the application to always supply a value to be saved to the database. This value must be assigned to new entities before they are added to the context.
+
+However, in some cases you may want to disable value generation that has been set up by convention. For example, a primary key of type int is usually implicitly configured as value-generated-on-add (e.g. identity column on SQL Server). You can disable this via the following:
+
+### [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[Main](../../../samples/core/Modeling/GeneratedProperties/DataAnnotations/ValueGeneratedNever.cs?name=ValueGeneratedNever&highlight=3)]
+
+### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[Main](../../../samples/core/Modeling/GeneratedProperties/FluentAPI/ValueGeneratedNever.cs?name=ValueGeneratedNever&highlight=5)]
+
+***
diff --git a/entity-framework/core/modeling/index.md b/entity-framework/core/modeling/index.md
new file mode 100644
index 0000000000..35b940efa9
--- /dev/null
+++ b/entity-framework/core/modeling/index.md
@@ -0,0 +1,173 @@
+---
+title: Creating and Configuring a Model - EF Core
+description: Overview of creating and configuring a Entity Framework Core model via Fluent API, Data Annotations and conventions. 
+author: AndriySvyryd
+ms.date: 11/11/2022
+uid: core/modeling/index
+---
+# Creating and Configuring a Model
+
+EF Core uses a metadata _model_ to describe how the application's entity types are mapped to the underlying database. This model is built using a set of [_conventions_](#built-in-conventions) - heuristics that look for common patterns. The model can then be customized using [mapping attributes (also known as _data annotations_)](#use-data-annotations-to-configure-a-model) and/or calls to the <xref:Microsoft.EntityFrameworkCore.ModelBuilder> methods [(also known as _fluent API_)](#use-fluent-api-to-configure-a-model) in <xref:Microsoft.EntityFrameworkCore.DbContext.OnModelCreating*>, both of which will override the configuration performed by conventions.
+
+Most configuration can be applied to a model targeting any data store. Providers may also enable configuration that is specific to a particular data store and they can also ignore configuration that is not supported or not applicable. For documentation on provider-specific configuration see the [Database providers](xref:core/providers/index) section.
+
+> [!TIP]
+> You can view this article's [samples](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Modeling/) on GitHub.
+
+## Use fluent API to configure a model
+
+You can override the `OnModelCreating` method in your derived context and use the fluent API to configure your model. This is the most powerful method of configuration and allows configuration to be specified without modifying your entity classes. Fluent API configuration has the highest precedence and will override conventions and data annotations. The configuration is applied in the order the methods are called and if there are any conflicts the latest call will override previously specified configuration.
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityProperties/FluentAPI/Required.cs?highlight=12-14)]
+
+> [!TIP]
+> To apply the same configuration to multiple objects in the model see [bulk configuration](xref:core/modeling/bulk-configuration).
+
+### Grouping configuration
+
+To reduce the size of the `OnModelCreating` method all configuration for an entity type can be extracted to a separate class implementing <xref:Microsoft.EntityFrameworkCore.IEntityTypeConfiguration`1>.
+
+[!code-csharp[Main](../../../samples/core/Modeling/Misc/EntityTypeConfiguration.cs?Name=IEntityTypeConfiguration)]
+
+Then just invoke the `Configure` method from `OnModelCreating`.
+
+[!code-csharp[Main](../../../samples/core/Modeling/Misc/EntityTypeConfiguration.cs?Name=ApplyIEntityTypeConfiguration)]
+
+#### Applying all configurations in an assembly
+
+It is possible to apply all configuration specified in types implementing `IEntityTypeConfiguration` in a given assembly.
+
+[!code-csharp[Main](../../../samples/core/Modeling/Misc/EntityTypeConfiguration.cs?Name=ApplyConfigurationsFromAssembly)]
+
+> [!NOTE]
+> The order in which the configurations will be applied is undefined, therefore this method should only be used when the order doesn't matter.
+
+#### Using `EntityTypeConfigurationAttribute` on entity types
+
+Rather than explicitly calling `Configure`, an <xref:Microsoft.EntityFrameworkCore.EntityTypeConfigurationAttribute> can instead be placed on the entity type such that EF Core can find and use appropriate configuration. For example:
+
+<!--
+[EntityTypeConfiguration(typeof(BookConfiguration))]
+public class Book
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+    public string Isbn { get; set; }
+}
+-->
+[!code-csharp[BookEntityType](../../../samples/core/Miscellaneous/NewInEFCore6/EntityTypeConfigurationAttributeSample.cs?name=BookEntityType)]
+
+This attribute means that EF Core will use the specified `IEntityTypeConfiguration` implementation whenever the `Book` entity type is included in a model. The entity type is included in a model using one of the normal mechanisms. For example, by creating a <xref:Microsoft.EntityFrameworkCore.DbSet`1> property for the entity type:
+
+<!--
+public class BooksContext : DbContext
+{
+    public DbSet<Book> Books { get; set; }
+
+    //...
+-->
+[!code-csharp[DbContext](../../../samples/core/Miscellaneous/NewInEFCore6/EntityTypeConfigurationAttributeSample.cs?name=DbContext)]
+
+Or by registering it in <xref:Microsoft.EntityFrameworkCore.DbContext.OnModelCreating*>:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Book>();
+}
+```
+
+> [!NOTE]
+> `EntityTypeConfigurationAttribute` types will not be automatically discovered in an assembly. Entity types must be added to the model before the attribute will be discovered on that entity type.
+
+## Use data annotations to configure a model
+
+You can also apply certain attributes (known as _Data Annotations_) to your classes and properties. Data annotations will override conventions, but will be overridden by Fluent API configuration.
+
+[!code-csharp[Main](../../../samples/core/Modeling/EntityProperties/DataAnnotations/Annotations.cs)]
+
+## Built-in conventions
+
+EF Core includes many model building conventions that are enabled by default. You can find all of them in the list of classes that implement the <xref:Microsoft.EntityFrameworkCore.Metadata.Conventions.IConvention> interface. However, that list doesn't include conventions introduced by third-party database providers and plugins.
+
+Applications can remove or replace any of these conventions, as well as add new [custom conventions](xref:core/modeling/bulk-configuration#conventions) that apply configuration for patterns that are not recognized by EF out of the box.
+
+> [!TIP]
+> The code shown below comes from [ModelBuildingConventionsSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Modeling/BulkConfiguration/ModelBuildingConventionsSample.cs).
+
+### Removing an existing convention
+
+Sometimes one of the built-in conventions may not appropriate for your application, in which case it can be removed.
+
+> [!TIP]
+> If your model doesn't use mapping attributes (aka data annotations) for configuration, then all conventions with the name ending in `AttributeConvention` can be safely removed to speed up model building.
+
+#### Example: Don't create indexes for foreign key columns
+
+It usually makes sense to create indexes for foreign key (FK) columns, and hence there is a built-in convention for this: <xref:Microsoft.EntityFrameworkCore.Metadata.Conventions.ForeignKeyIndexConvention>. Looking at the model [debug view](#debug-view) for a `Post` entity type with relationships to `Blog` and `Author`, we can see two indexes are created--one for the `BlogId` FK, and the other for the `AuthorId` FK.
+
+```text
+  EntityType: Post
+    Properties:
+      Id (int) Required PK AfterSave:Throw ValueGenerated.OnAdd
+      AuthorId (no field, int?) Shadow FK Index
+      BlogId (no field, int) Shadow Required FK Index
+    Navigations:
+      Author (Author) ToPrincipal Author Inverse: Posts
+      Blog (Blog) ToPrincipal Blog Inverse: Posts
+    Keys:
+      Id PK
+    Foreign keys:
+      Post {'AuthorId'} -> Author {'Id'} ToDependent: Posts ToPrincipal: Author ClientSetNull
+      Post {'BlogId'} -> Blog {'Id'} ToDependent: Posts ToPrincipal: Blog Cascade
+    Indexes:
+      AuthorId
+      BlogId
+```
+
+However, indexes have overhead, and it may not always be appropriate to create them for all FK columns. To achieve this, the `ForeignKeyIndexConvention` can be removed when building the model:
+
+```csharp
+protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+{
+    configurationBuilder.Conventions.Remove(typeof(ForeignKeyIndexConvention));
+}
+```
+
+Looking at the debug view of the model for `Post` now, we see that the indexes on FKs have not been created:
+
+```text
+  EntityType: Post
+    Properties:
+      Id (int) Required PK AfterSave:Throw ValueGenerated.OnAdd
+      AuthorId (no field, int?) Shadow FK
+      BlogId (no field, int) Shadow Required FK
+    Navigations:
+      Author (Author) ToPrincipal Author Inverse: Posts
+      Blog (Blog) ToPrincipal Blog Inverse: Posts
+    Keys:
+      Id PK
+    Foreign keys:
+      Post {'AuthorId'} -> Author {'Id'} ToDependent: Posts ToPrincipal: Author ClientSetNull
+      Post {'BlogId'} -> Blog {'Id'} ToDependent: Posts ToPrincipal: Blog Cascade
+```
+
+When desired, indexes can still be explicitly created for foreign key columns, either using the <xref:Microsoft.EntityFrameworkCore.IndexAttribute> or with configuration in `OnModelCreating`.
+
+## Debug view
+
+The model builder debug view can be accessed in the debugger of your IDE. For example, with Visual Studio:
+
+![Accessing the model builder debug view from the Visual Studio debugger](_static/debug-view.png)
+
+It can also be accessed directly from code, for example to send the debug view to the console:
+
+```csharp
+Console.WriteLine(context.Model.ToDebugString());
+```
+
+The debug view has a short form and a long form. The long form also includes all the annotations, which could be useful if you need to view relational or provider-specific metadata. The long view can be accessed from code as well:
+
+```csharp
+Console.WriteLine(context.Model.ToDebugString(MetadataDebugStringOptions.LongDefault));
+```
diff --git a/entity-framework/core/modeling/indexes.md b/entity-framework/core/modeling/indexes.md
new file mode 100644
index 0000000000..003ca0c9cb
--- /dev/null
+++ b/entity-framework/core/modeling/indexes.md
@@ -0,0 +1,161 @@
+---
+title: Indexes - EF Core
+description: Configuring indexes in an Entity Framework Core model
+author: roji
+ms.date: 10/1/2021
+uid: core/modeling/indexes
+---
+# Indexes
+
+Indexes are a common concept across many data stores. While their implementation in the data store may vary, they are used to make lookups based on a column (or set of columns) more efficient. See the [indexes section](xref:core/performance/efficient-querying#use-indexes-properly) in the performance documentation for more information on good index usage.
+
+You can specify an index over a column as follows:
+
+## [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[Main](../../../samples/core/Modeling/IndexesAndConstraints/DataAnnotations/Index.cs?name=Index&highlight=1)]
+
+## [Fluent API](#tab/fluent-api)
+
+[!code-csharp[Main](../../../samples/core/Modeling/IndexesAndConstraints/FluentAPI/Index.cs?name=Index&highlight=4)]
+
+***
+
+> [!NOTE]
+> By convention, an index is created in each property (or set of properties) that are used as a foreign key.
+
+## Composite index
+
+An index can also span more than one column:
+
+### [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[Main](../../../samples/core/Modeling/IndexesAndConstraints/DataAnnotations/IndexComposite.cs?name=Composite&highlight=1)]
+
+### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[Main](../../../samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexComposite.cs?name=Composite&highlight=4)]
+
+***
+
+Indexes over multiple columns, also known as *composite indexes*, speed up queries which filter on index's columns, but also queries which only filter on the *first* columns covered by the index. See the [performance docs](xref:core/performance/efficient-querying#use-indexes-properly) for more information.
+
+## Index uniqueness
+
+By default, indexes aren't unique: multiple rows are allowed to have the same value(s) for the index's column set. You can make an index unique as follows:
+
+### [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[Main](../../../samples/core/Modeling/IndexesAndConstraints/DataAnnotations/IndexUnique.cs?name=IndexUnique&highlight=1)]
+
+### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[Main](../../../samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexUnique.cs?name=IndexUnique&highlight=5)]
+
+***
+
+Attempting to insert more than one entity with the same values for the index's column set will cause an exception to be thrown.
+
+## Index sort order
+
+In most databases, each column covered by an index can be either ascending or descending. For indexes covering only one column, this typically does not matter: the database can traverse the index in reverse order as needed. However, for composite indexes, the ordering can be crucial for good performance, and can mean the difference between an index getting used by a query or not. In general, the index columns' sort orders should correspond to those specified in the `ORDER BY` clause of your query.
+
+The index sort order is ascending by default. You can make all columns have descending order as follows:
+
+### [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[Main](../../../samples/core/Modeling/IndexesAndConstraints/DataAnnotations/IndexDescending.cs?name=IndexDescending&highlight=1)]
+
+### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[Main](../../../samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexDescending.cs?name=IndexDescending&highlight=5)]
+
+***
+
+You may also specify the sort order on a column-by-column basis as follows:
+
+### [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[Main](../../../samples/core/Modeling/IndexesAndConstraints/DataAnnotations/IndexDescendingAscending.cs?name=IndexDescendingAscending&highlight=1)]
+
+### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[Main](../../../samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexDescendingAscending.cs?name=IndexDescendingAscending&highlight=5)]
+
+***
+
+## Index naming and multiple indexes
+
+By convention, indexes created in a relational database are named `IX_<type name>_<property name>`. For composite indexes, `<property name>` becomes an underscore separated list of property names.
+
+You can set the name of the index created in the database:
+
+### [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[Main](../../../samples/core/Modeling/IndexesAndConstraints/DataAnnotations/IndexName.cs?name=IndexName&highlight=1)]
+
+### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[Main](../../../samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexName.cs?name=IndexName&highlight=5)]
+
+***
+
+Note that if you call `HasIndex` more than once on the same set of properties, that continues to configure a single index rather than create a new one:
+
+```csharp
+modelBuilder.Entity<Person>()
+    .HasIndex(p => new { p.FirstName, p.LastName })
+    .HasDatabaseName("IX_Names_Ascending");
+
+modelBuilder.Entity<Person>()
+    .HasIndex(p => new { p.FirstName, p.LastName })
+    .HasDatabaseName("IX_Names_Descending")
+    .IsDescending();
+```
+
+Since the second `HasIndex` call overrides the first one, this creates only a single, descending index. This can be useful for further configuring an index that was created by convention.
+
+To create multiple indexes over the same set of properties, pass a name to the `HasIndex`, which will be used to identify the index in the EF model, and to distinguish it from other indexes over the same properties:
+
+```c#
+modelBuilder.Entity<Person>()
+    .HasIndex(p => new { p.FirstName, p.LastName }, "IX_Names_Ascending");
+
+modelBuilder.Entity<Person>()
+    .HasIndex(p => new { p.FirstName, p.LastName }, "IX_Names_Descending")
+    .IsDescending();
+```
+
+Note that this name is also used as a default for the database name, so explicitly calling `HasDatabaseName` isn't required.
+
+## Index filter
+
+Some relational databases allow you to specify a filtered or partial index. This allows you to index only a subset of a column's values, reducing the index's size and improving both performance and disk space usage. For more information on SQL Server filtered indexes, [see the documentation](/sql/relational-databases/indexes/create-filtered-indexes).
+
+You can use the Fluent API to specify a filter on an index, provided as a SQL expression:
+
+[!code-csharp[Main](../../../samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexFilter.cs?name=IndexFilter&highlight=5)]
+
+When using the SQL Server provider EF adds an `'IS NOT NULL'` filter for all nullable columns that are part of a unique index. To override this convention you can supply a `null` value.
+
+[!code-csharp[Main](../../../samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexNoFilter.cs?name=IndexNoFilter&highlight=6)]
+
+## Included columns
+
+Some relational databases allow you to configure a set of columns which get included in the index, but aren't part of its "key". This can significantly improve query performance when all columns in the query are included in the index either as key or nonkey columns, as the table itself doesn't need to be accessed. For more information on SQL Server included columns, [see the documentation](/sql/relational-databases/indexes/create-indexes-with-included-columns).
+
+In the following example, the `Url` column is part of the index key, so any query filtering on that column can use the index. But in addition, queries accessing only the `Title` and `PublishedOn` columns will not need to access the table and will run more efficiently:
+
+[!code-csharp[Main](../../../samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexInclude.cs?name=IndexInclude&highlight=5-9)]
+
+## Check constraints
+
+Check constraints are a standard relational feature that allows you to define a condition that must hold for all rows in a table; any attempt to insert or modify data that violates the constraint will fail. Check constraints are similar to non-null constraints (which prohibit nulls in a column) or to unique constraints (which prohibit duplicates), but allow arbitrary SQL expression to be defined.
+
+You can use the Fluent API to specify a check constraint on a table, provided as a SQL expression:
+
+[!code-csharp[Main](../../../samples/core/Modeling/IndexesAndConstraints/FluentAPI/CheckConstraint.cs?name=CheckConstraint&highlight=4)]
+
+Multiple check constraints can be defined on the same table, each with their own name.
+
+Note: some common check constraints can be configured via the community package [EFCore.CheckConstraints](https://github.com/efcore/EFCore.CheckConstraints).
diff --git a/entity-framework/core/modeling/inheritance.md b/entity-framework/core/modeling/inheritance.md
new file mode 100644
index 0000000000..0fa7c0ff02
--- /dev/null
+++ b/entity-framework/core/modeling/inheritance.md
@@ -0,0 +1,355 @@
+---
+title: Inheritance - EF Core
+description: How to configure entity type inheritance using Entity Framework Core
+author: AndriySvyryd
+ms.date: 10/10/2022
+uid: core/modeling/inheritance
+---
+# Inheritance
+
+EF can map a .NET type hierarchy to a database. This allows you to write your .NET entities in code as usual, using base and derived types, and have EF seamlessly create the appropriate database schema, issue queries, etc. The actual details of how a type hierarchy is mapped are provider-dependent; this page describes inheritance support in the context of a relational database.
+
+## Entity type hierarchy mapping
+
+By convention, EF will not automatically scan for base or derived types; this means that if you want a CLR type in your hierarchy to be mapped, you must explicitly specify that type on your model. For example, specifying only the base type of a hierarchy will not cause EF Core to implicitly include all of its sub-types.
+
+The following sample exposes a DbSet for `Blog` and its subclass `RssBlog`. If `Blog` has any other subclass, it will not be included in the model.
+
+[!code-csharp[Main](../../../samples/core/Modeling/Inheritance/InheritanceDbSets.cs?name=InheritanceDbSets&highlight=3-4)]
+
+> [!NOTE]
+> Database columns are automatically made nullable as necessary when using TPH mapping. For example, the `RssUrl` column is nullable because regular `Blog` instances do not have that property.
+
+If you don't want to expose a `DbSet` for one or more entities in the hierarchy, you can also use the Fluent API to ensure they are included in the model.
+
+> [!TIP]
+> If you don't rely on [conventions](xref:core/modeling/index#built-in-conventions), you can specify the base type explicitly using `HasBaseType`. You can also use `.HasBaseType((Type)null)` to remove an entity type from the hierarchy.
+
+## Table-per-hierarchy and discriminator configuration
+
+By default, EF maps the inheritance using the *table-per-hierarchy* (TPH) pattern. TPH uses a single table to store the data for all types in the hierarchy, and a discriminator column is used to identify which type each row represents.
+
+The model above is mapped to the following database schema (note the implicitly created `Discriminator` column, which identifies which type of `Blog` is stored in each row).
+
+![Screenshot of the results of querying the Blog entity hierarchy using table-per-hierarchy pattern](_static/inheritance-tph-data.png)
+
+You can configure the name and type of the discriminator column and the values that are used to identify each type in the hierarchy:
+
+[!code-csharp[Main](../../../samples/core/Modeling/Inheritance/FluentAPI/DiscriminatorConfiguration.cs?name=DiscriminatorConfiguration&highlight=4-6)]
+
+In the examples above, EF added the discriminator implicitly as a [shadow property](xref:core/modeling/shadow-properties) on the base entity of the hierarchy. This property can be configured like any other:
+
+[!code-csharp[Main](../../../samples/core/Modeling/Inheritance/FluentAPI/DiscriminatorPropertyConfiguration.cs?name=DiscriminatorPropertyConfiguration&highlight=4-5)]
+
+Finally, the discriminator can also be mapped to a regular .NET property in your entity:
+
+[!code-csharp[Main](../../../samples/core/Modeling/Inheritance/FluentAPI/NonShadowDiscriminator.cs?name=NonShadowDiscriminator&highlight=4)]
+
+When querying for derived entities, which use the TPH pattern, EF Core adds a predicate over discriminator column in the query. This filter makes sure that we don't get any additional rows for base types or sibling types not in the result. This filter predicate is skipped for the base entity type since querying for the base entity will get results for all the entities in the hierarchy. When materializing results from a query, if we come across a discriminator value, which isn't mapped to any entity type in the model, we throw an exception since we don't know how to materialize the results. This error only occurs if your database contains rows with discriminator values, which aren't mapped in the EF model. If you have such data, then you can mark the discriminator mapping in EF Core model as incomplete to indicate that we should always add filter predicate for querying any type in the hierarchy. `IsComplete(false)` call on the discriminator configuration marks the mapping to be incomplete.
+
+[!code-csharp[Main](../../../samples/core/Modeling/Inheritance/FluentAPI/DiscriminatorMappingIncomplete.cs?name=DiscriminatorMappingIncomplete&highlight=5)]
+
+### Shared columns
+
+By default, when two sibling entity types in the hierarchy have a property with the same name, they will be mapped to two separate columns. However, if their type is identical they can be mapped to the same database column:
+
+[!code-csharp[Main](../../../samples/core/Modeling/Inheritance/FluentAPI/SharedTPHColumns.cs?name=SharedTPHColumns&highlight=9,13)]
+
+> [!NOTE]
+> Relational database providers, such as SQL Server, will not automatically use the discriminator predicate when querying shared columns when using a cast. The query `Url = (blog as RssBlog).Url` would also return the `Url` value for the sibling `Blog` rows. To restrict the query to `RssBlog` entities you need to manually add a filter on the discriminator, such as `Url = blog is RssBlog ? (blog as RssBlog).Url : null`.
+
+## Table-per-type configuration
+
+In the TPT mapping pattern, all the types are mapped to individual tables. Properties that belong solely to a base type or derived type are stored in a table that maps to that type. Tables that map to derived types also store a foreign key that joins the derived table with the base table.
+
+[!code-csharp[Main](../../../samples/core/Modeling/Inheritance/FluentAPI/TPTConfiguration.cs?name=TPTConfiguration)]
+
+> [!TIP]
+> Instead of calling `ToTable` on each entity type you can call `modelBuilder.Entity<Blog>().UseTptMappingStrategy()` on each root entity type and the table names will be generated by EF.
+
+> [!TIP]
+> To configure different column names for the primary key columns in each table see [Table-specific facet configuration](xref:core/modeling/table-splitting#table-specific-facet-configuration).
+
+EF will create the following database schema for the model above.
+
+```sql
+CREATE TABLE [Blogs] (
+    [BlogId] int NOT NULL IDENTITY,
+    [Url] nvarchar(max) NULL,
+    CONSTRAINT [PK_Blogs] PRIMARY KEY ([BlogId])
+);
+
+CREATE TABLE [RssBlogs] (
+    [BlogId] int NOT NULL,
+    [RssUrl] nvarchar(max) NULL,
+    CONSTRAINT [PK_RssBlogs] PRIMARY KEY ([BlogId]),
+    CONSTRAINT [FK_RssBlogs_Blogs_BlogId] FOREIGN KEY ([BlogId]) REFERENCES [Blogs] ([BlogId]) ON DELETE NO ACTION
+);
+```
+
+> [!NOTE]
+> If the primary key constraint is renamed the new name will be applied to all the tables mapped to the hierarchy, future EF versions will allow renaming the constraint only for a particular table when [issue 19970](https://github.com/dotnet/efcore/issues/19970) is fixed.
+
+If you are employing bulk configuration you can retrieve the column name for a specific table by calling <xref:Microsoft.EntityFrameworkCore.RelationalPropertyExtensions.GetColumnName(Microsoft.EntityFrameworkCore.Metadata.IProperty,Microsoft.EntityFrameworkCore.Metadata.StoreObjectIdentifier@)>.
+
+[!code-csharp[Main](../../../samples/core/Modeling/Inheritance/FluentAPI/TPTConfiguration.cs?name=Metadata&highlight=10)]
+
+> [!WARNING]
+> In many cases, TPT shows inferior performance when compared to TPH. [See the performance docs for more information](xref:core/performance/modeling-for-performance#inheritance-mapping).
+
+> [!CAUTION]
+> Columns for a derived type are mapped to different tables, therefore composite FK constraints and indexes that use both the inherited and declared properties cannot be created in the database.
+
+## Table-per-concrete-type configuration
+
+In the TPC mapping pattern, all the types are mapped to individual tables. Each table contains columns for all properties on the corresponding entity type. This addresses some common performance issues with the TPT strategy.
+
+> [!TIP]
+> The EF Team demonstrated and talked in depth about TPC mapping in an episode of the [.NET Data Community Standup](https://aka.ms/efstandups). As with all Community Standup episodes, you can [watch the TPC episode now on YouTube](https://youtu.be/HaL6DKW1mrg).
+
+[!code-csharp[Main](../../../samples/core/Modeling/Inheritance/FluentAPI/TPCConfiguration.cs?name=TPCConfiguration)]
+
+> [!TIP]
+> Instead of calling `ToTable` on each entity type just calling `modelBuilder.Entity<Blog>().UseTpcMappingStrategy()` on each root entity type will generate the table names by convention.
+
+> [!TIP]
+> To configure different column names for the primary key columns in each table see [Table-specific facet configuration](xref:core/modeling/table-splitting#table-specific-facet-configuration).
+
+EF will create the following database schema for the model above.
+
+```sql
+CREATE TABLE [Blogs] (
+    [BlogId] int NOT NULL DEFAULT (NEXT VALUE FOR [BlogSequence]),
+    [Url] nvarchar(max) NULL,
+    CONSTRAINT [PK_Blogs] PRIMARY KEY ([BlogId])
+);
+
+CREATE TABLE [RssBlogs] (
+    [BlogId] int NOT NULL DEFAULT (NEXT VALUE FOR [BlogSequence]),
+    [Url] nvarchar(max) NULL,
+    [RssUrl] nvarchar(max) NULL,
+    CONSTRAINT [PK_RssBlogs] PRIMARY KEY ([BlogId])
+);
+```
+
+### TPC database schema
+
+The TPC strategy is similar to the TPT strategy except that a different table is created for every *concrete* type in the hierarchy, but tables are **not** created for *abstract* types - hence the name “table-per-concrete-type”. As with TPT, the table itself indicates the type of the object saved. However, unlike TPT mapping, each table contains columns for every property in the concrete type and its base types. TPC database schemas are denormalized.
+
+For example, consider mapping this hierarchy:
+
+<!--
+    public abstract class Animal
+    {
+        protected Animal(string name)
+        {
+            Name = name;
+        }
+
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public abstract string Species { get; }
+
+        public Food? Food { get; set; }
+    }
+
+    public abstract class Pet : Animal
+    {
+        protected Pet(string name)
+            : base(name)
+        {
+        }
+
+        public string? Vet { get; set; }
+
+        public ICollection<Human> Humans { get; } = new List<Human>();
+    }
+
+    public class FarmAnimal : Animal
+    {
+        public FarmAnimal(string name, string species)
+            : base(name)
+        {
+            Species = species;
+        }
+
+        public override string Species { get; }
+
+        [Precision(18, 2)]
+        public decimal Value { get; set; }
+
+        public override string ToString()
+            => $"Farm animal '{Name}' ({Species}/{Id}) worth {Value:C} eats {Food?.ToString() ?? "<Unknown>"}";
+    }
+
+    public class Cat : Pet
+    {
+        public Cat(string name, string educationLevel)
+            : base(name)
+        {
+            EducationLevel = educationLevel;
+        }
+
+        public string EducationLevel { get; set; }
+        public override string Species => "Felis catus";
+
+        public override string ToString()
+            => $"Cat '{Name}' ({Species}/{Id}) with education '{EducationLevel}' eats {Food?.ToString() ?? "<Unknown>"}";
+    }
+
+    public class Dog : Pet
+    {
+        public Dog(string name, string favoriteToy)
+            : base(name)
+        {
+            FavoriteToy = favoriteToy;
+        }
+
+        public string FavoriteToy { get; set; }
+        public override string Species => "Canis familiaris";
+
+        public override string ToString()
+            => $"Dog '{Name}' ({Species}/{Id}) with favorite toy '{FavoriteToy}' eats {Food?.ToString() ?? "<Unknown>"}";
+    }
+
+    public class Human : Animal
+    {
+        public Human(string name)
+            : base(name)
+        {
+        }
+
+        public override string Species => "Homo sapiens";
+
+        public Animal? FavoriteAnimal { get; set; }
+        public ICollection<Pet> Pets { get; } = new List<Pet>();
+
+        public override string ToString()
+            => $"Human '{Name}' ({Species}/{Id}) with favorite animal '{FavoriteAnimal?.Name ?? "<Unknown>"}'" +
+               $" eats {Food?.ToString() ?? "<Unknown>"}";
+    }
+-->
+[!code-csharp[AnimalsHierarchy](../../../samples/core/Miscellaneous/NewInEFCore7/TpcInheritanceSample.cs?name=AnimalsHierarchy)]
+
+When using SQL Server, the tables created for this hierarchy are:
+
+```sql
+CREATE TABLE [Cats] (
+    [Id] int NOT NULL DEFAULT (NEXT VALUE FOR [AnimalSequence]),
+    [Name] nvarchar(max) NOT NULL,
+    [FoodId] uniqueidentifier NULL,
+    [Vet] nvarchar(max) NULL,
+    [EducationLevel] nvarchar(max) NOT NULL,
+    CONSTRAINT [PK_Cats] PRIMARY KEY ([Id]));
+
+CREATE TABLE [Dogs] (
+    [Id] int NOT NULL DEFAULT (NEXT VALUE FOR [AnimalSequence]),
+    [Name] nvarchar(max) NOT NULL,
+    [FoodId] uniqueidentifier NULL,
+    [Vet] nvarchar(max) NULL,
+    [FavoriteToy] nvarchar(max) NOT NULL,
+    CONSTRAINT [PK_Dogs] PRIMARY KEY ([Id]));
+
+CREATE TABLE [FarmAnimals] (
+    [Id] int NOT NULL DEFAULT (NEXT VALUE FOR [AnimalSequence]),
+    [Name] nvarchar(max) NOT NULL,
+    [FoodId] uniqueidentifier NULL,
+    [Value] decimal(18,2) NOT NULL,
+    [Species] nvarchar(max) NOT NULL,
+    CONSTRAINT [PK_FarmAnimals] PRIMARY KEY ([Id]));
+
+CREATE TABLE [Humans] (
+    [Id] int NOT NULL DEFAULT (NEXT VALUE FOR [AnimalSequence]),
+    [Name] nvarchar(max) NOT NULL,
+    [FoodId] uniqueidentifier NULL,
+    [FavoriteAnimalId] int NULL,
+    CONSTRAINT [PK_Humans] PRIMARY KEY ([Id]));
+```
+
+Notice that:
+
+- There are no tables for the `Animal` or `Pet` types, since these are `abstract` in the object model. Remember that C# does not allow instances of abstract types, and there is therefore no situation where an abstract type instance will be saved to the database.
+- The mapping of properties in base types is repeated for each concrete type. For example, every table has a `Name` column, and both Cats and Dogs have a `Vet` column.
+
+- Saving some data into this database results in the following:
+
+**Cats table**
+
+| Id  | Name   | FoodId                               | Vet                  | EducationLevel |
+|:----|:-------|:-------------------------------------|:---------------------|:---------------|
+| 1   | Alice  | 99ca3e98-b26d-4a0c-d4ae-08da7aca624f | Pengelly             | MBA            |
+| 2   | Mac    | 99ca3e98-b26d-4a0c-d4ae-08da7aca624f | Pengelly             | Preschool      |
+| 8   | Baxter | 5dc5019e-6f72-454b-d4b0-08da7aca624f | Bothell Pet Hospital | BSc            |
+
+**Dogs table**
+
+| Id  | Name  | FoodId                               | Vet      | FavoriteToy  |
+|:----|:------|:-------------------------------------|:---------|:-------------|
+| 3   | Toast | 011aaf6f-d588-4fad-d4ac-08da7aca624f | Pengelly | Mr. Squirrel |
+
+**FarmAnimals table**
+
+| Id  | Name  | FoodId                               | Value  | Species                |
+|:----|:------|:-------------------------------------|:-------|:-----------------------|
+| 4   | Clyde | 1d495075-f527-4498-d4af-08da7aca624f | 100.00 | Equus africanus asinus |
+
+**Humans table**
+
+| Id  | Name   | FoodId                               | FavoriteAnimalId      |
+|:----|:-------|:-------------------------------------|:----------------------|
+| 5   | Wendy  | 5418fd81-7660-432f-d4b1-08da7aca624f | 2                     |
+| 6   | Arthur | 59b495d4-0414-46bf-d4ad-08da7aca624f | 1                     |
+| 9   | Katie  | null                                 | 8                     |
+
+Notice that unlike with TPT mapping, all the information for a single object is contained in a single table. And, unlike with TPH mapping, there is no combination of column and row in any table where that is never used by the model. We'll see below how these characteristics can be important for queries and storage.
+
+### Key generation
+
+The inheritance mapping strategy chosen has consequences for how primary key values are generated and managed. Keys in TPH are easy, since each entity instance is represented by a single row in a single table. Any kind of key value generation can be used, and no additional constraints are needed.
+
+For the TPT strategy, there is always a row in the table mapped to the base type of the hierarchy. Any kind of key generation can be used on this row, and the keys for other tables are linked to this table using foreign key constraints.
+
+Things get a bit more complicated for TPC. First, it’s important to understand that EF Core requires that all entities in a hierarchy have a unique key value, even if the entities have different types. For example, using our example model, a Dog cannot have the same Id key value as a Cat. Second, unlike TPT, there is no common table that can act as the single place where key values live and can be generated. This means a simple `Identity` column cannot be used.
+
+For databases that support sequences, key values can be generated by using a single sequence referenced in the default constraint for each table. This is the strategy used in the TPC tables shown above, where each table has the following:
+
+```sql
+[Id] int NOT NULL DEFAULT (NEXT VALUE FOR [AnimalSequence])
+```
+
+`AnimalSequence` is a database sequence created by EF Core. This strategy is used by default for TPC hierarchies when using the EF Core database provider for SQL Server. Database providers for other databases that support sequences should have a similar default. Other key generation strategies that use sequences, such as Hi-Lo patterns, may also be used with TPC.
+
+While standard Identity columns don't work with TPC, it is possible to use Identity columns if each table is configured with an appropriate seed and increment such that the values generated for each table will never conflict. For example:
+
+<!--
+            modelBuilder.Entity<Cat>().ToTable("Cats", tb => tb.Property(e => e.Id).UseIdentityColumn(1, 4));
+            modelBuilder.Entity<Dog>().ToTable("Dogs", tb => tb.Property(e => e.Id).UseIdentityColumn(2, 4));
+            modelBuilder.Entity<FarmAnimal>().ToTable("FarmAnimals", tb => tb.Property(e => e.Id).UseIdentityColumn(3, 4));
+            modelBuilder.Entity<Human>().ToTable("Humans", tb => tb.Property(e => e.Id).UseIdentityColumn(4, 4));
+-->
+[!code-csharp[UsingIdentity](../../../samples/core/Miscellaneous/NewInEFCore7/TpcInheritanceSample.cs?name=UsingIdentity)]
+
+> [!IMPORTANT]
+> Using this strategy makes it harder to add derived types later as it requires the total number of types in the hierarchy to be known beforehand.
+
+SQLite does not support sequences or Identity seed/increment, and hence integer key value generation is not supported when using SQLite with the TPC strategy. However, client-side generation or globally unique keys - such as GUIDs - are supported on any database, including SQLite.
+
+### Foreign key constraints
+
+The TPC mapping strategy creates a denormalized SQL schema - this is one reason why some database purists are against it. For example, consider the foreign key column `FavoriteAnimalId`. The value in this column must match the primary key value of some animal. This can be enforced in the database with a simple FK constraint when using TPH or TPT. For example:
+
+```sql
+CONSTRAINT [FK_Animals_Animals_FavoriteAnimalId] FOREIGN KEY ([FavoriteAnimalId]) REFERENCES [Animals] ([Id])
+```
+
+But when using TPC, the primary key for any given animal is stored in the table corresponding to the concrete type of that animal. For example, a cat's primary key is stored in the `Cats.Id` column, while a dog's primary key is stored in the `Dogs.Id` column, and so on. This means an FK constraint cannot be created for this relationship.
+
+In practice, this is not a problem as long as the application does not attempt to insert invalid data. For example, if all the data is inserted by EF Core and uses navigations to relate entities, then it is guaranteed that the FK column will contain valid PK values at all times.
+
+## Summary and guidance
+
+In summary, TPH is usually fine for most applications, and is a good default for a wide range of scenarios, so don't add the complexity of TPC if you don't need it. Specifically, if your code will mostly query for entities of many types, such as writing queries against the base type, then lean towards TPH over TPC.
+
+That being said, TPC is also a good mapping strategy to use when your code will mostly query for entities of a single leaf type and your benchmarks show an improvement compared with TPH.
+
+Use TPT only if constrained to do so by external factors.
diff --git a/entity-framework/core/modeling/keyless-entity-types.md b/entity-framework/core/modeling/keyless-entity-types.md
new file mode 100644
index 0000000000..f1c22e0799
--- /dev/null
+++ b/entity-framework/core/modeling/keyless-entity-types.md
@@ -0,0 +1,97 @@
+---
+title: Keyless Entity Types - EF Core
+description: How to configure keyless entity types using Entity Framework Core
+author: AndriySvyryd
+ms.date: 10/10/2022
+uid: core/modeling/keyless-entity-types
+---
+# Keyless Entity Types
+
+> [!NOTE]
+> This feature was added under the name of query types. It was later renamed to keyless entity types.
+
+In addition to regular entity types, an EF Core model can contain _keyless entity types_, which can be used to carry out database queries against data that doesn't contain key values.
+
+## Defining Keyless entity types
+
+Keyless entity types can be defined as follows:
+
+### [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[Main](../../../samples/core/Modeling/KeylessEntityTypes/DataAnnotations/Keyless.cs?Name=Keyless&highlight=1)]
+
+### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[Main](../../../samples/core/Modeling/KeylessEntityTypes/FluentAPI/Keyless.cs?Name=Keyless&highlight=4)]
+
+***
+
+## Keyless entity types characteristics
+
+Keyless entity types support many of the same mapping capabilities as regular entity types, like inheritance mapping and navigation properties. On relational stores, they can configure the target database objects and columns via fluent API methods or data annotations.
+
+However, they are different from regular entity types in that they:
+
+- Cannot have a key defined.
+- Are never tracked for changes in the _DbContext_ and therefore are never inserted, updated or deleted on the database.
+- Are never discovered by convention.
+- Only support a subset of navigation mapping capabilities, specifically:
+  - They may never act as the principal end of a relationship.
+  - They may not have navigations to owned entities
+  - They can only contain reference navigation properties pointing to regular entities.
+  - Entities cannot contain navigation properties to keyless entity types.
+- Need to be configured with a `[Keyless]` data annotation or a `.HasNoKey()` method call.
+- May be mapped to a _defining query_. A defining query is a query declared in the model that acts as a data source for a keyless entity type.
+- Can have a hierarchy, but it must be mapped as TPH.
+- Cannot use table splitting or entity splitting.
+
+## Usage scenarios
+
+Some of the main usage scenarios for keyless entity types are:
+
+- Serving as the return type for [SQL queries](xref:core/querying/sql-queries).
+- Mapping to database views that do not contain a primary key.
+- Mapping to tables that do not have a primary key defined.
+- Mapping to queries defined in the model.
+
+## Mapping to database objects
+
+Mapping a keyless entity type to a database object is achieved using the `ToTable` or `ToView` fluent API. From the perspective of EF Core, the database object specified in this method is a _view_, meaning that it is treated as a read-only query source and cannot be the target of update, insert or delete operations. However, this does not mean that the database object is actually required to be a database view. It can alternatively be a database table that will be treated as read-only. Conversely, for regular entity types, EF Core assumes that a database object specified in the `ToTable` method can be treated as a _table_, meaning that it can be used as a query source but also targeted by update, delete and insert operations. In fact, you can specify the name of a database view in `ToTable` and everything should work fine as long as the view is configured to be updatable on the database.
+
+## Example
+
+The following example shows how to use keyless entity types to query a database view.
+
+> [!TIP]
+> You can view this article's [sample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Modeling/KeylessEntityTypes) on GitHub.
+
+First, we define a simple Blog and Post model:
+
+[!code-csharp[Main](../../../samples/core/Modeling/KeylessEntityTypes/Program.cs#Entities)]
+
+Next, we define a simple database view that will allow us to query the number of posts associated with each blog:
+
+[!code-csharp[Main](../../../samples/core/Modeling/KeylessEntityTypes/Program.cs#View)]
+
+Next, we define a class to hold the result from the database view:
+
+[!code-csharp[Main](../../../samples/core/Modeling/KeylessEntityTypes/Program.cs#KeylessEntityType)]
+
+Next, we configure the keyless entity type in _OnModelCreating_ using the `HasNoKey` API.
+We use fluent configuration API to configure the mapping for the keyless entity type:
+
+[!code-csharp[Main](../../../samples/core/Modeling/KeylessEntityTypes/Program.cs#Configuration)]
+
+Next, we configure the `DbContext` to include the `DbSet<T>`:
+
+[!code-csharp[Main](../../../samples/core/Modeling/KeylessEntityTypes/Program.cs#DbSet)]
+
+Finally, we can query the database view in the standard way:
+
+[!code-csharp[Main](../../../samples/core/Modeling/KeylessEntityTypes/Program.cs#Query)]
+
+> [!TIP]
+> Note we have also defined a context level query property (DbSet) to act as a root for queries against this type.
+
+> [!TIP]
+> To test keyless entity types mapped to views using the in-memory provider, map them to a query via <xref:Microsoft.EntityFrameworkCore.InMemoryEntityTypeBuilderExtensions.ToInMemoryQuery*>. See the [in-memory provider docs](xref:core/testing/testing-without-the-database#in-memory-provider) for more information.
diff --git a/entity-framework/core/modeling/keys.md b/entity-framework/core/modeling/keys.md
new file mode 100644
index 0000000000..bbb8ef5bec
--- /dev/null
+++ b/entity-framework/core/modeling/keys.md
@@ -0,0 +1,96 @@
+---
+title: Keys - EF Core
+description: How to configure keys for entity types when using Entity Framework Core
+author: AndriySvyryd
+ms.date: 10/14/2022
+uid: core/modeling/keys
+---
+# Keys
+
+A key serves as a unique identifier for each entity instance. Most entities in EF have a single key, which maps to the concept of a *primary key* in relational databases (for entities without keys, see [Keyless entities](xref:core/modeling/keyless-entity-types)). Entities can have additional keys beyond the primary key (see [Alternate Keys](#alternate-keys) for more information).
+
+## Configuring a primary key
+
+By convention, a property named `Id` or `<type name>Id` will be configured as the primary key of an entity.
+
+[!code-csharp[Main](../../../samples/core/Modeling/Keys/KeyId.cs?name=KeyId&highlight=3,11)]
+
+> [!NOTE]
+> [Owned entity types](xref:core/modeling/owned-entities) use different rules to define keys.
+
+You can configure a single property to be the primary key of an entity as follows:
+
+### [Data Annotations](#tab/data-annotations)
+
+[!code-csharp[KeySingle](../../../samples/core/Modeling/Keys/DataAnnotations/KeySingle.cs?name=KeySingle&highlight=3)]
+
+### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[KeySingle](../../../samples/core/Modeling/Keys/FluentAPI/KeySingle.cs?name=KeySingle&highlight=4)]
+
+***
+
+You can also configure multiple properties to be the key of an entity - this is known as a composite key. Conventions will only set up a composite key in specific cases - like for an owned type collection.
+
+### [Data Annotations](#tab/data-annotations)
+
+<!--
+[PrimaryKey(nameof(State), nameof(LicensePlate))]
+public class Car
+{
+    public string State { get; set; }
+    public string LicensePlate { get; set; }
+
+    public string Make { get; set; }
+    public string Model { get; set; }
+}
+-->
+[!code-csharp[KeyComposite](../../../samples/core/Modeling/Keys/DataAnnotations/KeyComposite.cs?name=KeyComposite&highlight=1)]
+
+### [Fluent API](#tab/fluent-api)
+
+[!code-csharp[KeyComposite](../../../samples/core/Modeling/Keys/FluentAPI/KeyComposite.cs?name=KeyComposite&highlight=4)]
+
+***
+
+## Value generation
+
+For non-composite numeric and GUID primary keys, EF Core sets up value generation for you by convention. For example, a numeric primary key in SQL Server is automatically set up to be an IDENTITY column. For more information, see [the documentation on value generation](xref:core/modeling/generated-properties) and [guidance for specific inheritance mapping strategies](xref:core/modeling/inheritance#key-generation).
+
+## Primary key name
+
+By convention, on relational databases primary keys are created with the name `PK_<type name>`. You can configure the name of the primary key constraint as follows:
+
+[!code-csharp[Main](../../../samples/core/Modeling/Keys/FluentAPI/KeyName.cs?name=KeyName&highlight=5)]
+
+## Key types and values
+
+While EF Core supports using properties of any primitive type as the primary key, including `string`, `Guid`, `byte[]` and others, not all databases support all types as keys. In some cases the key values can be converted to a supported type automatically, otherwise the conversion should be [specified manually](xref:core/modeling/value-conversions).
+
+Key properties must always have a non-default value when adding a new entity to the context, but some types will be [generated by the database](xref:core/modeling/generated-properties). In that case EF will try to generate a temporary value when the entity is added for tracking purposes. After [SaveChanges](/dotnet/api/Microsoft.EntityFrameworkCore.DbContext.SaveChanges) is called the temporary value will be replaced by the value generated by the database.
+
+> [!IMPORTANT]
+> If a key property has its value generated by the database and a non-default value is specified when an entity is added, then EF will assume that the entity already exists in the database and will try to update it instead of inserting a new one. To avoid this, turn off value generation or see [how to specify explicit values for generated properties](xref:core/modeling/generated-properties#overriding-value-generation).
+
+## Alternate Keys
+
+An alternate key serves as an alternate unique identifier for each entity instance in addition to the primary key; it can be used as the target of a relationship. When using a relational database this maps to the concept of a unique index/constraint on the alternate key column(s) and one or more foreign key constraints that reference the column(s).
+
+> [!TIP]
+> If you just want to enforce uniqueness on a column, define a unique index rather than an alternate key (see [Indexes](xref:core/modeling/indexes)). In EF, alternate keys are read-only and provide additional semantics over unique indexes because they can be used as the target of a foreign key.
+
+Alternate keys are typically introduced for you when needed and you do not need to manually configure them. By convention, an alternate key is introduced for you when you identify a property which isn't the primary key as the target of a relationship.
+
+[!code-csharp[Main](../../../samples/core/Modeling/Keys/AlternateKey.cs?name=AlternateKey&highlight=12)]
+
+You can also configure a single property to be an alternate key:
+
+[!code-csharp[Main](../../../samples/core/Modeling/Keys/FluentAPI/AlternateKeySingle.cs?name=AlternateKeySingle&highlight=4)]
+
+You can also configure multiple properties to be an alternate key (known as a composite alternate key):
+
+[!code-csharp[Main](../../../samples/core/Modeling/Keys/FluentAPI/AlternateKeyComposite.cs?name=AlternateKeyComposite&highlight=4)]
+
+Finally, by convention, the index and constraint that are introduced for an alternate key will be named `AK_<type name>_<property name>` (for composite alternate keys `<property name>` becomes an underscore separated list of property names). You can configure the name of the alternate key's index and unique constraint:
+
+[!code-csharp[Main](../../../samples/core/Modeling/Keys/FluentAPI/AlternateKeyName.cs?name=AlternateKeyName&highlight=5)]
diff --git a/entity-framework/core/modeling/owned-entities.md b/entity-framework/core/modeling/owned-entities.md
new file mode 100644
index 0000000000..b0b9817afd
--- /dev/null
+++ b/entity-framework/core/modeling/owned-entities.md
@@ -0,0 +1,160 @@
+---
+title: Owned Entity Types - EF Core
+description: How to configure owned entity types or aggregates when using Entity Framework Core
+author: AndriySvyryd
+ms.date: 11/06/2019
+uid: core/modeling/owned-entities
+---
+# Owned Entity Types
+
+EF Core allows you to model entity types that can only ever appear on navigation properties of other entity types. These are called _owned entity types_. The entity containing an owned entity type is its _owner_.
+
+Owned entities are essentially a part of the owner and cannot exist without it, they are conceptually similar to [aggregates](https://martinfowler.com/bliki/DDD_Aggregate.html). This means that the owned entity is by definition on the dependent side of the relationship with the owner.
+
+## Configuring types as owned
+
+In most providers, entity types are never configured as owned by convention - you must explicitly use the `OwnsOne` method in `OnModelCreating` or annotate the type with `OwnedAttribute` to configure the type as owned. The Azure Cosmos DB provider is an exception to this. Because Azure Cosmos DB is a document database, the provider configures all related entity types as owned by default.
+
+In this example, `StreetAddress` is a type with no identity property. It is used as a property of the Order type to specify the shipping address for a particular order.
+
+We can use the `OwnedAttribute` to treat it as an owned entity when referenced from another entity type:
+
+[!code-csharp[StreetAddress](../../../samples/core/Modeling/OwnedEntities/StreetAddress.cs?name=StreetAddress)]
+
+[!code-csharp[Order](../../../samples/core/Modeling/OwnedEntities/Order.cs?name=Order)]
+
+It is also possible to use the `OwnsOne` method in `OnModelCreating` to specify that the `ShippingAddress` property is an Owned Entity of the `Order` entity type and to configure additional facets if needed.
+
+[!code-csharp[OwnsOne](../../../samples/core/Modeling/OwnedEntities/OwnedEntityContext.cs?name=OwnsOne)]
+
+If the `ShippingAddress` property is private in the `Order` type, you can use the string version of the `OwnsOne` method:
+
+[!code-csharp[OwnsOneString](../../../samples/core/Modeling/OwnedEntities/OwnedEntityContext.cs?name=OwnsOneString)]
+
+The model above is mapped to the following database schema:
+
+![Screenshot of the database model for entity containing owned reference](_static/owned-entities-ownsone.png)
+
+See the [full sample project](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Modeling/OwnedEntities) for more context.
+
+> [!TIP]
+> The owned entity type can be marked as required, see [Required one-to-one dependents](xref:core/modeling/relationships/navigations#required-navigations) for more information.
+
+## Implicit keys
+
+Owned types configured with `OwnsOne` or discovered through a reference navigation always have a one-to-one relationship with the owner, therefore they don't need their own key values as the foreign key values are unique. In the previous example, the `StreetAddress` type does not need to define a key property.
+
+In order to understand how EF Core tracks these objects, it is useful to know that a primary key is created as a [shadow property](xref:core/modeling/shadow-properties) for the owned type. The value of the key of an instance of the owned type will be the same as the value of the key of the owner instance.
+
+## Collections of owned types
+
+To configure a collection of owned types use `OwnsMany` in `OnModelCreating`.
+
+Owned types need a primary key. If there are no good candidates properties on the .NET type, EF Core can try to create one. However, when owned types are defined through a collection, it isn't enough to just create a shadow property to act as both the foreign key into the owner and the primary key of the owned instance, as we do for `OwnsOne`: there can be multiple owned type instances for each owner, and hence the key of the owner isn't enough to provide a unique identity for each owned instance.
+
+The two most straightforward solutions to this are:
+
+- Defining a surrogate primary key on a new property independent of the foreign key that points to the owner. The contained values would need to be unique across all owners (e.g. if Parent {1} has Child {1}, then Parent {2} cannot have Child {1}), so the value doesn't have any inherent meaning. Since the foreign key is not part of the primary key its values can be changed, so you could move a child from one parent to another one, however this usually goes against aggregate semantics.
+- Using the foreign key and an additional property as a composite key. The additional property value now only needs to be unique for a given parent (so if Parent {1} has Child {1,1} then Parent {2} can still have Child {2,1}). By making the foreign key part of the primary key the relationship between the owner and the owned entity becomes immutable and reflects aggregate semantics better. This is what EF Core does by default.
+
+In this example we'll use the `Distributor` class.
+
+[!code-csharp[Distributor](../../../samples/core/Modeling/OwnedEntities/Distributor.cs?name=Distributor)]
+
+By default the primary key used for the owned type referenced through the `ShippingCenters` navigation property will be `("DistributorId", "Id")` where `"DistributorId"` is the FK and `"Id"` is a unique `int` value.
+
+To configure a different primary key call `HasKey`.
+
+[!code-csharp[OwnsMany](../../../samples/core/Modeling/OwnedEntities/OwnedEntityContext.cs?name=OwnsMany)]
+
+The model above is mapped to the following database schema:
+
+![Screenshot of the database model for entity containing owned collection](_static/owned-entities-ownsmany.png)
+
+## Mapping owned types with table splitting
+
+When using relational databases, by default reference owned types are mapped to the same table as the owner. This requires splitting the table in two: some columns will be used to store the data of the owner, and some columns will be used to store data of the owned entity. This is a common feature known as [table splitting](xref:core/modeling/table-splitting).
+
+By default, EF Core will name the database columns for the properties of the owned entity type following the pattern _Navigation_OwnedEntityProperty_. Therefore the `StreetAddress` properties will appear in the 'Orders' table with the names 'ShippingAddress_Street' and 'ShippingAddress_City'.
+
+You can use the `HasColumnName` method to rename those columns.
+
+[!code-csharp[ColumnNames](../../../samples/core/Modeling/OwnedEntities/OwnedEntityContext.cs?name=ColumnNames)]
+
+> [!NOTE]
+> Most of the normal entity type configuration methods like [Ignore](/dotnet/api/microsoft.entityframeworkcore.metadata.builders.ownednavigationbuilder.ignore) can be called in the same way.
+
+## Sharing the same .NET type among multiple owned types
+
+An owned entity type can be of the same .NET type as another owned entity type, therefore the .NET type may not be enough to identify an owned type.
+
+In those cases, the property pointing from the owner to the owned entity becomes the _defining navigation_ of the owned entity type. From the perspective of EF Core, the defining navigation is part of the type's identity alongside the .NET type.
+
+For example, in the following class `ShippingAddress` and `BillingAddress` are both of the same .NET type, `StreetAddress`.
+
+[!code-csharp[OrderDetails](../../../samples/core/Modeling/OwnedEntities/OrderDetails.cs?name=OrderDetails)]
+
+In order to understand how EF Core will distinguish tracked instances of these objects, it may be useful to think that the defining navigation has become part of the key of the instance alongside the value of the key of the owner and the .NET type of the owned type.
+
+## Nested owned types
+
+In this example `OrderDetails` owns `BillingAddress` and `ShippingAddress`, which are both `StreetAddress` types. Then `OrderDetails` is owned by the `DetailedOrder` type.
+
+[!code-csharp[DetailedOrder](../../../samples/core/Modeling/OwnedEntities/DetailedOrder.cs?name=DetailedOrder)]
+
+[!code-csharp[OrderStatus](../../../samples/core/Modeling/OwnedEntities/OrderStatus.cs?name=OrderStatus)]
+
+Each navigation to an owned type defines a separate entity type with completely independent configuration.
+
+In addition to nested owned types, an owned type can reference a regular entity which can be either the owner or a different entity as long as the owned entity is on the dependent side. This capability sets owned entity types apart from complex types in EF6.
+
+[!code-csharp[OrderDetails](../../../samples/core/Modeling/OwnedEntities/OrderDetails.cs?name=OrderDetails)]
+
+## Configuring owned types
+
+It is possible to chain the `OwnsOne` method in a fluent call to configure this model:
+
+[!code-csharp[OwnsOneNested](../../../samples/core/Modeling/OwnedEntities/OwnedEntityContext.cs?name=OwnsOneNested)]
+
+Notice the `WithOwner` call used to define the navigation property pointing back at the owner. To define a navigation to the owner entity type that's not part of the ownership relationship `WithOwner()` should be called without any arguments.
+
+It is also possible to achieve this result using `OwnedAttribute` on both `OrderDetails` and `StreetAddress`.
+
+In addition, notice the `Navigation` call. Navigation properties to owned types can be further configured [as for non-owned navigation properties](xref:core/modeling/relationships/navigations#required-navigations).
+
+The model above is mapped to the following database schema:
+
+![Screenshot of the database model for entity containing nested owned references](_static/owned-entities-nested.png)
+
+## Storing owned types in separate tables
+
+Also unlike EF6 complex types, owned types can be stored in a separate table from the owner. In order to override the convention that maps an owned type to the same table as the owner, you can simply call `ToTable` and provide a different table name. The following example will map `OrderDetails` and its two addresses to a separate table from `DetailedOrder`:
+
+[!code-csharp[OwnsOneTable](../../../samples/core/Modeling/OwnedEntities/OwnedEntityContext.cs?name=OwnsOneTable)]
+
+It is also possible to use the `TableAttribute` to accomplish this, but note that this would fail if there are multiple navigations to the owned type since in that case multiple entity types would be mapped to the same table.
+
+## Querying owned types
+
+When querying the owner the owned types will be included by default. It is not necessary to use the `Include` method, even if the owned types are stored in a separate table. Based on the model described before, the following query will get `Order`, `OrderDetails` and the two owned `StreetAddresses` from the database:
+
+[!code-csharp[DetailedOrderQuery](../../../samples/core/Modeling/OwnedEntities/Program.cs?name=DetailedOrderQuery)]
+
+## Limitations
+
+Some of these limitations are fundamental to how owned entity types work, but some others are restrictions that we may be able to remove in future releases:
+
+### By-design restrictions
+
+- You cannot create a `DbSet<T>` for an owned type.
+- You cannot call `Entity<T>()` with an owned type on `ModelBuilder`.
+- Instances of owned entity types cannot be shared by multiple owners (this is a well-known scenario for value objects that cannot be implemented using owned entity types).
+
+### Current shortcomings
+
+- Owned entity types cannot have inheritance hierarchies
+
+### Shortcomings in previous versions
+
+- In EF Core 2.x reference navigations to owned entity types cannot be null unless they are explicitly mapped to a separate table from the owner.
+- In EF Core 3.x the columns for owned entity types mapped to the same table as the owner are always marked as nullable.
diff --git a/entity-framework/core/modeling/relationships.md b/entity-framework/core/modeling/relationships.md
new file mode 100644
index 0000000000..938a13f22a
--- /dev/null
+++ b/entity-framework/core/modeling/relationships.md
@@ -0,0 +1,196 @@
+---
+title: Introduction to relationships - EF Core
+description: How to configure relationships between entity types when using Entity Framework Core
+author: SamMonoRT
+ms.date: 03/30/2023
+uid: core/modeling/relationships
+---
+# Introduction to relationships
+
+This document provides a simple introduction to the representation of relationships in object models and relational databases, including how EF Core maps between the two.
+
+## Relationships in object models
+
+A relationship defines how two entities relate to each other. For example, when modeling posts in a blog, each post is related to the blog it is published on, and the blog is related to all the posts published on that blog.
+
+In an object-oriented language like C#, the blog and post are typically represented by two classes: `Blog` and `Post`. For example:
+
+```csharp
+public class Blog
+{
+    public string Name { get; set; }
+    public virtual Uri SiteUri { get; set; }
+}
+```
+
+```csharp
+public class Post
+{
+    public string Title { get; set; }
+    public string Content { get; set; }
+    public DateTime PublishedOn { get; set; }
+    public bool Archived { get; set; }
+}
+```
+
+In the classes above, there is nothing to indicate that `Blog` and `Post` are related. This can be added to the object model by adding a reference from `Post` to the `Blog` on which it is published:
+
+```csharp
+public class Post
+{
+    public string Title { get; set; }
+    public string Content { get; set; }
+    public DateOnly PublishedOn { get; set; }
+    public bool Archived { get; set; }
+
+    public Blog Blog { get; set; }
+}
+```
+
+Likewise, the opposite direction of the same relationship can be represented as a collection of `Post` objects on each `Blog`:
+
+```csharp
+public class Blog
+{
+    public string Name { get; set; }
+    public virtual Uri SiteUri { get; set; }
+
+    public ICollection<Post> Posts { get; }
+}
+```
+
+This connection from `Blog` to `Post` and, inversely, from `Post` back to `Blog` is known as a "relationship" in EF Core.
+
+> [!IMPORTANT]
+> A **single** relationship can typically be traversed in either direction. In this example, that is from `Blog` to `Post` via the `Blog.Posts` property, and from `Post` back to `Blog` via the `Post.Blog` property. This is **one** relationship, not two.
+
+> [!TIP]
+> In EF Core, the `Blog.Posts` and `Post.Blog` properties are called "navigations".
+
+## Relationships in relational databases
+
+Relational databases represent relationships using foreign keys. For example, using SQL Server or Azure SQL, the following tables can be used to represent our `Post` and `Blog` classes:
+
+```sql
+CREATE TABLE [Posts] (
+    [Id] int NOT NULL IDENTITY,
+    [Title] nvarchar(max) NULL,
+    [Content] nvarchar(max) NULL,
+    [PublishedOn] datetime2 NOT NULL,
+    [Archived] bit NOT NULL,
+    [BlogId] int NOT NULL,
+    CONSTRAINT [PK_Posts] PRIMARY KEY ([Id]),
+    CONSTRAINT [FK_Posts_Blogs_BlogId] FOREIGN KEY ([BlogId]) REFERENCES [Blogs] ([Id]) ON DELETE CASCADE);
+
+CREATE TABLE [Blogs] (
+    [Id] int NOT NULL IDENTITY,
+    [Name] nvarchar(max) NULL,
+    [SiteUri] nvarchar(max) NULL,
+    CONSTRAINT [PK_Blogs] PRIMARY KEY ([Id]));
+```
+
+In this relational model, the `Posts` and `Blogs` tables are each given a "primary key" column. The value of the primary key uniquely identifies each post or blog. In addition, the `Posts` table is given a "foreign key" column. The `Blogs` primary key column `Id` is referenced by the `BlogId` foreign key column of the `Posts` table. This column is "constrained" such that any value in the `BlogId` column of `Posts` **must** match a value in the `Id` column of `Blogs`. This match determines which blog every post is related to. For example, if the `BlogId` value in one row of the `Posts` table is 7, then the post represented by that row is published in the blog with the primary key 7.
+
+## Mapping relationships in EF Core
+
+EF Core relationship mapping is all about mapping the primary key/foreign key representation used in a relational database to the references between objects used in an object model.
+
+In the most basic sense, this involves:
+
+- Adding a primary key property to each entity type.
+- Adding a foreign key property to one entity type.
+- Associating the references between entity types with the primary and foreign keys to form a single relationship configuration.
+
+Once this mapping is made, EF changes the foreign key values as needed when the references between objects change, and changes the references between objects as needed when the foreign key values change.
+
+> [!NOTE]
+> Primary keys are used for more than mapping relationships. See [_Keys_](xref:core/modeling/keys) for more information.
+
+For example, the entity types shown above can be updated with primary and foreign key properties:
+
+```csharp
+public class Blog
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+    public virtual Uri SiteUri { get; set; }
+
+    public ICollection<Post> Posts { get; }
+}
+```
+
+```csharp
+public class Post
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+    public DateTime PublishedOn { get; set; }
+    public bool Archived { get; set; }
+
+    public int BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
+```
+
+> [!TIP]
+> Primary and foreign key properties don't need to be publicly visible properties of the entity type. However, even when the properties are hidden, it is important to recognize that they still exist in the EF model.
+
+The primary key property of `Blog`, `Blog.Id`, and the foreign key property of `Post`, `Post.BlogId`, can then be associated with the references ("navigations") between the entity types (`Blog.Posts` and `Post.Blog`). This is done automatically by EF when building a simple relationship like this, but can also be specified explicitly when overriding the `OnModelCreating` method of your `DbContext`. For example:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Blog>()
+        .HasMany(e => e.Posts)
+        .WithOne(e => e.Blog)
+        .HasForeignKey(e => e.BlogId)
+        .HasPrincipalKey(e => e.Id);
+}
+```
+
+Now all these properties will behave coherently together as a representation of a single relationship between `Blog` and `Post`.
+
+## Find out more
+
+EF supports many different types of relationships, with many different ways these relationships can be represented and configured. To jump into examples for different kinds of relationships, see:
+
+- [_One-to-many relationships_](xref:core/modeling/relationships/one-to-many), in which a single entity is associated with any number of other entities.
+- [_One-to-one relationships_](xref:core/modeling/relationships/one-to-one), in which a single entity is associated with another single entity.
+- [_Many-to-many relationships_](xref:core/modeling/relationships/many-to-many), in which any number of entities are associated with any number of other entities.
+
+If you are new to EF, then trying the examples linked in in the bullet points above is a good way to get a feel for how relationships work.
+
+To dig deeper into the properties of entity types involved in relationship mapping, see:
+
+- [_Foreign and principal keys in relationships_](xref:core/modeling/relationships/foreign-and-principal-keys), which covers how foreign keys map to the database.
+- [_Relationship navigations_](xref:core/modeling/relationships/navigations), which describes how navigations are layered over a foreign key to provide an object-oriented view of the relationship.
+
+EF models are built using a combination of three mechanisms: conventions, mapping attributes, and the model builder API. Most of the examples show the model building API. To find out more about other options, see:
+
+- [_Relationship conventions_](xref:core/modeling/relationships/conventions), which discover entity types, their properties, and the relationships between the types.
+- [_Relationship mapping attributes_](xref:core/modeling/relationships/mapping-attributes), which can be used an alternative to the model building API for some aspects of relationship configuration.
+
+> [!IMPORTANT]
+> The model-building API is the final source of truth for the EF model--it always takes precedence over configuration discovered by convention or specified by mapping attributes. It is also the only mechanism with full fidelity to configure every aspect of the EF model.
+
+Other topics related to relationships include:
+
+- [_Cascade deletes_](xref:core/saving/cascade-delete), which describe how related entities can be automatically deleted when `SaveChanges` or `SaveChangesAsync` is called.
+- [_Owned entity types_](xref:core/modeling/owned-entities) use a special type of "owning" relationship that implies a stronger connection between the two types than the "normal" relationships discussed here. Many of the concepts described here for normal relationships are carried over to owned relationships. However, owned relationships also have their own special behaviors.
+
+> [!TIP]
+> Refer to the [glossary of relationship terms](xref:core/modeling/relationships/glossary) as needed when reading the documentation to help understand the terminology used.
+
+## Using relationships
+
+Relationships defined in the model can be used in various ways. For example:
+
+- Relationships can be used to [query related data](xref:core/querying/related-data) in any of three ways:
+  - [Eagerly](xref:core/querying/related-data/eager) as part of a LINQ query, using `Include`.
+  - [Lazily](xref:core/querying/related-data/lazy) using lazy-loading proxies, or lazy-loading without proxies.
+  - [Explicitly](xref:core/querying/related-data/explicit) using the `Load` or `LoadAsync` methods.
+- Relationships can be used in [data seeding](xref:core/modeling/data-seeding) through matching of PK values to FK values.
+- Relationships can be used to [track graphs of entities](xref:core/change-tracking/index). Relationships are then used by the change tracker to:
+  - [Detect changes in relationships and perform fixup](xref:core/change-tracking/relationship-changes)
+  - [Send foreign key updates to the database](xref:core/saving/related-data) with `SaveChanges` or `SaveChangesAsync`
diff --git a/entity-framework/core/modeling/relationships/conventions.md b/entity-framework/core/modeling/relationships/conventions.md
new file mode 100644
index 0000000000..f7ad5b99b3
--- /dev/null
+++ b/entity-framework/core/modeling/relationships/conventions.md
@@ -0,0 +1,454 @@
+---
+title: Conventions for relationship discovery - EF Core
+description: How navigations, foreign keys, and other aspects of relationships are discovered by EF Core model building conventions
+author: SamMonoRT
+ms.date: 03/30/2023
+uid: core/modeling/relationships/conventions
+---
+# Conventions for relationship discovery
+
+EF Core uses a set of [conventions](xref:core/modeling/bulk-configuration#conventions) when discovering and building a [model](xref:core/modeling/index) based on entity type classes. This document summarizes the conventions used for discovering and configuring [relationships between entity types](xref:core/modeling/relationships).
+
+> [!IMPORTANT]
+> The conventions described here can be overridden by explicit configuration of the relationship using either [mapping attributes](xref:core/modeling/relationships/mapping-attributes) or the model building API.
+
+> [!TIP]
+> The code below can be found in [RelationshipConventions.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Modeling/Relationships/RelationshipConventions.cs).
+
+## Discovering navigations
+
+Relationship discovery begins by discovering [navigations](xref:core/modeling/relationships/navigations) between entity types.
+
+### Reference navigations
+
+A property of an entity type is discovered as a [reference navigation](xref:core/modeling/relationships/navigations) when:
+
+- The property is public.
+- The property has a getter and a setter.
+  - The setter does not need to be public; it can be private or have any other [accessibility](/dotnet/csharp/language-reference/keywords/access-modifiers?source=recommendations).
+  - The setter can be [Init-only](/dotnet/csharp/properties#init-only).
+- The property type is, or could be, an entity type. This means that the type
+  - Must be a [reference type](/dotnet/csharp/language-reference/keywords/reference-types).
+  - Must not have been configured explicitly as a [primitive property type](xref:core/modeling/entity-properties).
+  - Must not be mapped as a primitive property type by the database provider being used.
+  - Must not be [automatically convertable](xref:core/modeling/value-conversions) to a primitive property type mapped by the database provider being used.
+- The property is not static.
+- The property is not an [indexer property](/dotnet/csharp/programming-guide/indexers/).
+
+For example, consider the following entity types:
+
+<!--
+        public class Blog
+        {
+            // Not discovered as reference navigations:
+            public int Id { get; set; }
+            public string Title { get; set; } = null!;
+            public Uri? Uri { get; set; }
+            public ConsoleKeyInfo ConsoleKeyInfo { get; set; }
+            public Author DefaultAuthor => new() { Name = $"Author of the blog {Title}" };
+
+            // Discovered as a reference navigation:
+            public Author? Author { get; private set; }
+        }
+
+        public class Author
+        {
+            // Not discovered as reference navigations:
+            public Guid Id { get; set; }
+            public string Name { get; set; } = null!;
+            public int BlogId { get; set; }
+
+            // Discovered as a reference navigation:
+            public Blog Blog { get; init; } = null!;
+        }
+-->
+[!code-csharp[ReferenceNavigations](../../../../samples/core/Modeling/Relationships/RelationshipConventions.cs?name=ReferenceNavigations)]
+
+For these types, `Blog.Author` and `Author.Blog` are discovered as reference navigations. On the other hand, the following properties are _not_ discovered as reference navigations:
+
+- `Blog.Id`, because `int` is a mapped primitive type
+- `Blog.Title`, because 'string` is a mapped primitive type
+- `Blog.Uri`, because `Uri` is automatically converted to a mapped primitive type
+- `Blog.ConsoleKeyInfo`, because `ConsoleKeyInfo` is a C# value type
+- `Blog.DefaultAuthor`, because the property does not have a setter
+- `Author.Id`, because `Guid` is a mapped primitive type
+- `Author.Name`, because 'string` is a mapped primitive type
+- `Author.BlogId`, because `int` is a mapped primitive type
+
+### Collection navigations
+
+A property of an entity type is discovered as a [collection navigation](xref:core/modeling/relationships/navigations) when:
+
+- The property is public.
+- The property has a getter. Collection navigations can have setters, but this is not required.
+- The property type is or implements `IEnumerable<TEntity>`, where `TEntity` is, or could be, an entity type. This means that the type of `TEntity`:
+  - Must be a [reference type](/dotnet/csharp/language-reference/keywords/reference-types).
+  - Must not have been configured explicitly as a [primitive property type](xref:core/modeling/entity-properties).
+  - Must not be mapped as a primitive property type by the database provider being used.
+  - Must not be [automatically convertable](xref:core/modeling/value-conversions) to a primitive property type mapped by the database provider being used.
+- The property is not static.
+- The property is not an [indexer property](/dotnet/csharp/programming-guide/indexers/).
+
+For example, in the following code, both `Blog.Tags` and `Tag.Blogs` are discovered as collection navigations:
+
+<!--
+        public class Blog
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; set; } = null!;
+        }
+
+        public class Tag
+        {
+            public Guid Id { get; set; }
+            public IEnumerable<Blog> Blogs { get; } = new List<Blog>();
+        }
+-->
+[!code-csharp[CollectionNavigations](../../../../samples/core/Modeling/Relationships/RelationshipConventions.cs?name=CollectionNavigations)]
+
+### Pairing navigations
+
+Once a navigation going from, for example, entity type A to entity type B is discovered, it must next be determined if this navigation has an inverse going in the opposite direction--that is, from entity type B to entity type A. If such an inverse is found, then the two navigations are paired together to form a single, bidirectional relationship.
+
+The type of relationship is determined by whether the navigation and its inverse are reference or collection navigations. Specifically:
+
+- If one navigation is a collection navigation and the other is a reference navigation, then the relationship is [one-to-many](xref:core/modeling/relationships/one-to-many).
+- If both navigations are reference navigations, then the relationship is [one-to-one](xref:core/modeling/relationships/one-to-one).
+- If both navigations are collection navigations, then the relationship is [many-to-many](xref:core/modeling/relationships/many-to-many).
+
+Discovery of each of these types of relationship is shown in the examples below:
+
+A single, one-to-many relationship between `Blog` and `Post` is discovered by pairing the `Blog.Posts` and `Post.Blog` navigations:
+
+<!--
+        public class Blog
+        {
+            public int Id { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public int? BlogId { get; set; }
+            public Blog? Blog { get; set; }
+        }
+-->
+[!code-csharp[OneToManySingleRelationship](../../../../samples/core/Modeling/Relationships/RelationshipConventions.cs?name=OneToManySingleRelationship)]
+
+A single, one-to-one relationship is discovered between `Blog` and `Author` is discovered by pairing the `Blog.Author` and `Author.Blog` navigations:
+
+<!--
+        public class Blog
+        {
+            public int Id { get; set; }
+            public Author? Author { get; set; }
+        }
+
+        public class Author
+        {
+            public int Id { get; set; }
+            public int? BlogId { get; set; }
+            public Blog? Blog { get; set; }
+        }
+-->
+[!code-csharp[OneToOneSingleRelationship](../../../../samples/core/Modeling/Relationships/RelationshipConventions.cs?name=OneToOneSingleRelationship)]
+
+A single, many-to-many relationship is discovered between `Post` and `Tag` is discovered by pairing the `Post.Tags` and `Tag.Posts` navigations:
+
+<!--
+        public class Post
+        {
+            public int Id { get; set; }
+            public ICollection<Tag> Tags { get; } = new List<Tag>();
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>();
+        }
+-->
+[!code-csharp[ManyToManySingleRelationship](../../../../samples/core/Modeling/Relationships/RelationshipConventions.cs?name=ManyToManySingleRelationship)]
+
+> [!NOTE]
+> This pairing of navigations may be incorrect if the two navigations represent two, different, unidirectional relationships. In this case, the two relationships must be configured explicitly.
+
+Pairing of relationships only works when there is a single relationship between two types. Multiple relationships between two types must be configured explicitly.
+
+> [!NOTE]
+> The descriptions here are in terms of relationships between two different types. However, it is possible for the same type to be on both ends of a relationship, and therefore for a single type to have two navigations both paired with each other. This is called a self-referencing relationship.
+
+## Discovering foreign key properties
+
+Once the navigations for a relationship have either been discovered or configured explicitly, then these navigations are used to discover appropriate foreign key properties for the relationship. A property is discovered as a foreign key when:
+
+- The property type is compatible with the primary or alternate key on the principal entity type.
+  - Types are compatible if they are the same, or if the foreign key property type is a nullable version of the primary or alternate key property type.
+- The property name matches one of the naming conventions for a foreign key property. The naming conventions are:
+  - `<navigation property name><principal key property name>`
+  - `<navigation property name>Id`
+  - `<principal entity type name><principal key property name>`
+  - `<principal entity type name>Id`
+- In addition, if the dependent end has been explicitly configured using the model building API, and the dependent primary key is compatible, then the dependent primary key will also be used as the foreign key.
+
+> [!TIP]
+> The "Id" suffix can have any casing.
+
+The following entity types show examples for each of these naming conventions.
+
+`Post.TheBlogKey` is discovered as the foreign key because it matches the pattern `<navigation property name><principal key property name>`:
+
+<!--
+        public class Blog
+        {
+            public int Key { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public int? TheBlogKey { get; set; }
+            public Blog? TheBlog { get; set; }
+        }
+-->
+[!code-csharp[NavigationPrincipalKeyFKName](../../../../samples/core/Modeling/Relationships/RelationshipConventions.cs?name=NavigationPrincipalKeyFKName)]
+
+`Post.TheBlogID` is discovered as the foreign key because it matches the pattern `<navigation property name>Id`:
+
+<!--
+        public class Blog
+        {
+            public int Key { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public int? TheBlogID { get; set; }
+            public Blog? TheBlog { get; set; }
+        }
+-->
+[!code-csharp[NavigationIdFKName](../../../../samples/core/Modeling/Relationships/RelationshipConventions.cs?name=NavigationIdFKName)]
+
+`Post.BlogKey` is discovered as the foreign key because it matches the pattern `<principal entity type name><principal key property name>`:
+
+<!--
+        public class Blog
+        {
+            public int Key { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public int? BlogKey { get; set; }
+            public Blog? TheBlog { get; set; }
+        }
+
+-->
+[!code-csharp[PrincipalTypePrincipalKeyFKName](../../../../samples/core/Modeling/Relationships/RelationshipConventions.cs?name=PrincipalTypePrincipalKeyFKName)]
+
+`Post.Blogid` is discovered as the foreign key because it matches the pattern `<principal entity type name>Id`:
+
+<!--
+        public class Blog
+        {
+            public int Key { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public int? Blogid { get; set; }
+            public Blog? TheBlog { get; set; }
+        }
+-->
+[!code-csharp[PrincipalTypeIdFKName](../../../../samples/core/Modeling/Relationships/RelationshipConventions.cs?name=PrincipalTypeIdFKName)]
+
+> [!NOTE]
+> In the case of one-to-many navigations, the foreign key properties must be on the type with the reference navigation, since this will be the dependent entity. In the case of one-to-one relationships, discovery of a foreign key property is used to determine which type represents the dependent end of the relationship. If no foreign key property is discovered, then the dependent end must be configured using `HasForeignKey`. See [_One-to-one relationships_](xref:core/modeling/relationships/one-to-one) for examples of this.
+
+The rules above also apply to [composite foreign keys](xref:core/modeling/relationships/foreign-and-principal-keys), where each property of the composite must have a compatible type with the corresponding property of the primary or alternate key, and each property name must match one of the naming conventions described above.
+
+## Determining cardinality
+
+EF uses the discovered navigations and foreign key properties to determine the cardinality of the relationship together with its principal and dependent ends:
+
+- If there is one, unpaired reference navigation, then the relationship is configured as a unidirectional [one-to-many](xref:core/modeling/relationships/one-to-many), with the reference navigation on the dependent end.
+- If there is one, unpaired collection navigation, then the relationship is configured as a unidirectional [one-to-many](xref:core/modeling/relationships/one-to-many), with the collection navigation on the principal end.
+- If there are paired reference and collection navigations, then the relationship is configured as a bidirectional [one-to-many](xref:core/modeling/relationships/one-to-many), with the collection navigation on the principal end.
+- If a reference navigation is paired with another reference navigation, then:
+  - If a foreign key property was discovered on one side but not the other, then the relationship is configured as a bidirectional [one-to-one](xref:core/modeling/relationships/one-to-one), with the foreign key property on the dependent end.
+  - Otherwise, the dependent side cannot be determined and EF throws an exception indicating that the dependent must be explicitly configured.
+- If a collection navigation is paired with another collection navigation, then the relationship is configured as a bidirectional [many-to-many](xref:core/modeling/relationships/many-to-many).
+
+## Shadow foreign key properties
+
+If EF has determined the dependent end of the relationship but no foreign key property was discovered, then EF will create a [shadow property](xref:core/modeling/shadow-properties) to represent the foreign key. The shadow property:
+
+- Has the type of the primary or alternate key property at the principal end of the relationship.
+  - The type is made nullable by default, making the relationship optional by default.
+- If there is a navigation on the dependent end, then the shadow foreign key property is named using this navigation name concatenated with the primary or alternate key property name.
+- If there is no navigation on the dependent end, then the shadow foreign key property is named using principal entity type name concatenated with the primary or alternate key property name.
+
+## Cascade delete
+
+By convention, required relationships are configured to [cascade delete](xref:core/saving/cascade-delete). Optional relationships are configured to not cascade delete.
+
+## Many-to-many
+
+[Many-to-many relationships](xref:core/modeling/relationships/many-to-many) do not have principal and dependent ends, and neither end contains a foreign key property. Instead, many-to-many relationships use a join entity type which contains pairs of foreign keys pointing to either end of the many-to-many. Consider the following entity types, for which a many-to-many relationship is discovered by convention:
+
+<!--
+        public class Post
+        {
+            public int Id { get; set; }
+            public ICollection<Tag> Tags { get; } = new List<Tag>();
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>();
+        }
+-->
+[!code-csharp[ManyToManySingleRelationship](../../../../samples/core/Modeling/Relationships/RelationshipConventions.cs?name=ManyToManySingleRelationship)]
+
+The conventions used in this discovery are:
+
+- The join entity type is named `<left entity type name><right entity type name>`. So, `PostTag` in this example.
+  - The join table has the same name as the join entity type.
+- The join entity type is given a foreign key property for each direction of the relationship. These are named `<navigation name><principal key name>`. So, in this example, the foreign key properties are `PostsId` and `TagsId`.
+  - For a unidirectional many-to-many, the foreign key property without an associated navigation is named `<principal entity type name><principal key name>`.
+- The foreign key properties are non-nullable, making both relationships to the join entity required.
+  - The cascade delete conventions mean that these relationships will be configured for cascade delete.
+- The join entity type is configured with a composite primary key consisting of the two foreign key properties. So, in this example, the primary key is made up of `PostsId` and `TagsId`.
+
+This results in the following EF model:
+
+```output
+Model:
+  EntityType: Post
+    Properties:
+      Id (int) Required PK AfterSave:Throw ValueGenerated.OnAdd
+    Skip navigations:
+      Tags (ICollection<Tag>) CollectionTag Inverse: Posts
+    Keys:
+      Id PK
+  EntityType: Tag
+    Properties:
+      Id (int) Required PK AfterSave:Throw ValueGenerated.OnAdd
+    Skip navigations:
+      Posts (ICollection<Post>) CollectionPost Inverse: Tags
+    Keys:
+      Id PK
+  EntityType: PostTag (Dictionary<string, object>) CLR Type: Dictionary<string, object>
+    Properties:
+      PostsId (no field, int) Indexer Required PK FK AfterSave:Throw
+      TagsId (no field, int) Indexer Required PK FK Index AfterSave:Throw
+    Keys:
+      PostsId, TagsId PK
+    Foreign keys:
+      PostTag (Dictionary<string, object>) {'PostsId'} -> Post {'Id'} Cascade
+      PostTag (Dictionary<string, object>) {'TagsId'} -> Tag {'Id'} Cascade
+    Indexes:
+      TagsId
+```
+
+And translates to the following database schema when using SQLite:
+
+```sql
+CREATE TABLE "Posts" (
+    "Id" INTEGER NOT NULL CONSTRAINT "PK_Posts" PRIMARY KEY AUTOINCREMENT);
+
+CREATE TABLE "Tag" (
+    "Id" INTEGER NOT NULL CONSTRAINT "PK_Tag" PRIMARY KEY AUTOINCREMENT);
+
+CREATE TABLE "PostTag" (
+    "PostsId" INTEGER NOT NULL,
+    "TagsId" INTEGER NOT NULL,
+    CONSTRAINT "PK_PostTag" PRIMARY KEY ("PostsId", "TagsId"),
+    CONSTRAINT "FK_PostTag_Posts_PostsId" FOREIGN KEY ("PostsId") REFERENCES "Posts" ("Id") ON DELETE CASCADE,
+    CONSTRAINT "FK_PostTag_Tag_TagsId" FOREIGN KEY ("TagsId") REFERENCES "Tag" ("Id") ON DELETE CASCADE);
+
+CREATE INDEX "IX_PostTag_TagsId" ON "PostTag" ("TagsId");
+```
+
+## Indexes
+
+By convention, EF creates a [database index](xref:core/modeling/indexes) for the property or properties of a foreign key. The type of index created is determined by:
+
+- The cardinality of the relationship
+- Whether the relationship is optional or required
+- The number of properties that make up the foreign key
+
+For a [one-to-many relationship](xref:core/modeling/relationships/one-to-many), a straightforward index is created by convention. The same index is created for optional and required relationships. For example, on SQLite:
+
+```sql
+CREATE INDEX "IX_Post_BlogId" ON "Post" ("BlogId");
+```
+
+Or on SQL Server:
+
+```sql
+CREATE INDEX [IX_Post_BlogId] ON [Post] ([BlogId]);
+```
+
+For an required [one-to-one relationship](xref:core/modeling/relationships/one-to-one), a unique index is created. For example, on SQLite:
+
+```sql
+CREATE UNIQUE INDEX "IX_Author_BlogId" ON "Author" ("BlogId");
+```
+
+Or on SQL Sever:
+
+```sql
+CREATE UNIQUE INDEX [IX_Author_BlogId] ON [Author] ([BlogId]);
+```
+
+For optional one-to-one relationships, the index created on SQLite is the same:
+
+```sql
+CREATE UNIQUE INDEX "IX_Author_BlogId" ON "Author" ("BlogId");
+```
+
+However, on SQL Server, an `IS NOT NULL` filter is added to better handle null foreign key values. For example:
+
+```sql
+CREATE UNIQUE INDEX [IX_Author_BlogId] ON [Author] ([BlogId]) WHERE [BlogId] IS NOT NULL;
+```
+
+For composite foreign keys, an index is created covering all the foreign key columns. For example:
+
+```sql
+CREATE INDEX "IX_Post_ContainingBlogId1_ContainingBlogId2" ON "Post" ("ContainingBlogId1", "ContainingBlogId2");
+```
+
+> [!NOTE]
+> EF does not create indexes for properties that are already covered by an existing index or primary key constraint.
+
+### How to stop EF creating indexes for foreign keys
+
+Indexes have overhead, and, [as asked here](https://github.com/dotnet/efcore/issues/10855), it may not always be appropriate to create them for all FK columns. To achieve this, the `ForeignKeyIndexConvention` can be removed when building the model:
+
+```csharp
+protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+{
+    configurationBuilder.Conventions.Remove(typeof(ForeignKeyIndexConvention));
+}
+```
+
+When desired, indexes can still be [explicitly created](xref:core/modeling/indexes) for those foreign key columns that do need them.
+
+## Foreign key constraint names
+
+By convention foreign key constraints are named `FK_<dependent type name>_<principal type name>_<foreign key property name>`. For composite foreign keys, `<foreign key property name>` becomes an underscore separated list of foreign key property names.
+
+## Additional resources
+
+- [.NET Data Community Standup video on custom model conventions](https://www.youtube.com/live/6apfe1L1FhY?feature=share).
diff --git a/entity-framework/core/modeling/relationships/foreign-and-principal-keys.md b/entity-framework/core/modeling/relationships/foreign-and-principal-keys.md
new file mode 100644
index 0000000000..0851e82de7
--- /dev/null
+++ b/entity-framework/core/modeling/relationships/foreign-and-principal-keys.md
@@ -0,0 +1,342 @@
+---
+title: Foreign and principal keys in relationships - EF Core
+description: The use and configuration of foreign keys, alternate keys, and primary keys in relationships
+author: SamMonoRT
+ms.date: 03/30/2023
+uid: core/modeling/relationships/foreign-and-principal-keys
+---
+# Foreign and principal keys in relationships
+
+All [one-to-one](xref:core/modeling/relationships/one-to-one) and [one-to-many](xref:core/modeling/relationships/one-to-many) relationships are defined by a foreign key on the dependent end that references a primary or alternate key on the principal end. For convenience, this primary or alternate key is known as the "principal key" for the relationship. [Many-to-many](xref:core/modeling/relationships/one-to-many) relationships are composed of two one-to-many relationships, each of which is itself defined by a foreign key referencing a principal key.
+
+> [!TIP]
+> The code below can be found in [ForeignAndPrincipalKeys.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Modeling/Relationships/ForeignAndPrincipalKeys.cs).
+
+## Foreign keys
+
+The property or properties that make up foreign key are often [discovered by convention](xref:core/modeling/relationships/conventions). The properties can also be configured explicitly using either [mapping attributes](xref:core/modeling/relationships/mapping-attributes) or with `HasForeignKey` in the model building API. `HasForeignKey` can be used with a lambda expression. For example, for a foreign key made up of a single property:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey(e => e.ContainingBlogId);
+            }
+-->
+[!code-csharp[ForeignKeyByLambda](../../../../samples/core/Modeling/Relationships/ForeignAndPrincipalKeys.cs?name=ForeignKeyByLambda)]
+
+Or, for a composite foreign key made up of more than one property:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey(e => new { e.ContainingBlogId1, e.ContainingBlogId2 });
+            }
+-->
+[!code-csharp[CompositeForeignKeyByLambda](../../../../samples/core/Modeling/Relationships/ForeignAndPrincipalKeys.cs?name=CompositeForeignKeyByLambda)]
+
+> [!TIP]
+> Using lambda expressions in model building API ensures that the property use is available for code analysis and refactoring, and also provides the property type to the API for use in further chained methods.
+
+`HasForeignKey` can also be passed the name of the foreign key property as a string. For example, for a single property:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey("ContainingBlogId");
+            }
+-->
+[!code-csharp[ForeignKeyByString](../../../../samples/core/Modeling/Relationships/ForeignAndPrincipalKeys.cs?name=ForeignKeyByString)]
+
+Or, for a composite foreign key:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey("ContainingBlogId1", "ContainingBlogId2");
+            }
+-->
+[!code-csharp[CompositeForeignKeyByString](../../../../samples/core/Modeling/Relationships/ForeignAndPrincipalKeys.cs?name=CompositeForeignKeyByString)]
+
+Using a string is useful when:
+
+- The property or properties are private.
+- The property or properties do not exist on the entity type and should be created as [shadow properties](xref:core/modeling/shadow-properties).
+- The property name is calculated or constructed based on some input to the model building process.
+
+### Non-nullable foreign key columns
+
+As described in [_Optional and required relationships_](xref:core/modeling/relationships#optional-and-required-relationships), the nullability of the foreign key property determines whether a relationship is optional or required. However, a nullable foreign key property can be used for a required relationship using the [`[Required]` attribute](xref:core/modeling/relationships/mapping-attributes), or by calling `IsRequired` in the model building API. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired();
+            }
+-->
+[!code-csharp[RequiredForeignKeyConfig](../../../../samples/core/Modeling/Relationships/ForeignAndPrincipalKeys.cs?name=RequiredForeignKeyConfig)]
+
+Or, if the foreign key is [discovered by convention](xref:core/modeling/relationships/conventions), then `IsRequired` can be used without a call to `HasForeignKey`:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .IsRequired();
+            }
+-->
+[!code-csharp[RequiredForeignKeyConfig2](../../../../samples/core/Modeling/Relationships/ForeignAndPrincipalKeys.cs?name=RequiredForeignKeyConfig2)]
+
+The end result of this is that the foreign key column in the database is made non-nullable even if the foreign key property is nullable. The same thing can be achieved by explicitly configuring the foreign key property itself as required. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .Property(e => e.BlogId)
+                    .IsRequired();
+            }
+-->
+[!code-csharp[RequiredForeignKeyConfigByProperty](../../../../samples/core/Modeling/Relationships/ForeignAndPrincipalKeys.cs?name=RequiredForeignKeyConfigByProperty)]
+
+### Shadow foreign keys
+
+Foreign key properties can be created as [shadow properties](xref:core/modeling/shadow-properties). A shadow property exists in the EF model but does not exist on the .NET type. EF keeps track of the property value and state internally.
+
+Shadow foreign keys are usually used when there is a desire to hide the relational concept of a foreign key from the domain model used by application code/business logic. This application code then manipulates the relationship entirely through [navigations](xref:core/modeling/relationships/navigations).
+
+> [!TIP]
+> If entities are going to be serialized, for example to send over a wire, then the foreign key values can be a useful way to keep the relationship information intact when the entities are not in an object/graph form. It is therefore often pragmatic to keep foreign key properties in the .NET type for this purpose. Foreign key properties can be private, which is often a good compromise to avoid exposing the foreign key while allowing its value to travel with the entity.  
+
+Shadow foreign key properties are often [created by convention](xref:core/modeling/relationships/conventions). A shadow foreign key will also be created if the argument to `HasForeignKey` does not match any .NET property. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey("MyBlogId");
+            }
+-->
+[!code-csharp[ShadowForeignKeyConfig](../../../../samples/core/Modeling/Relationships/ForeignAndPrincipalKeys.cs?name=ShadowForeignKeyConfig)]
+
+By convention, a shadow foreign key gets its type from the principal key in the relationship. This type is made nullable unless the relationship is detected as or configured as required.
+
+The shadow foreign key property can also be created explicitly, which is useful for configuring facets of the property. For example, to make the property non-nullable:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .Property<string>("MyBlogId")
+                    .IsRequired();
+
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey("MyBlogId");
+            }
+-->
+[!code-csharp[ShadowForeignKeyConfigByProperty](../../../../samples/core/Modeling/Relationships/ForeignAndPrincipalKeys.cs?name=ShadowForeignKeyConfigByProperty)]
+
+> [!TIP]
+> By convention, foreign key properties inherit facets such as maximum length and Unicode support from the principal key in the relationship. It is therefore rarely necessary to explicitly configure facets on a foreign key property.
+
+The creation of a shadow property if the given name does not match any property of the entity type can be disabled using `ConfigureWarnings`. For example:
+
+<!--
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.ConfigureWarnings(b => b.Throw(CoreEventId.ShadowPropertyCreated));
+-->
+[!code-csharp[ThrowForShadow](../../../../samples/core/Modeling/Relationships/ForeignAndPrincipalKeys.cs?name=ThrowForShadow)]
+
+### Foreign key constraint names
+
+By convention foreign key constraints are named `FK_<dependent type name>_<principal type name>_<foreign key property name>`. For composite foreign keys, `<foreign key property name>` becomes an underscore separated list of foreign key property names.
+
+This can be changed in the model building API using `HasConstraintName`. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey(e => e.BlogId)
+                    .HasConstraintName("My_BlogId_Constraint");
+            }
+-->
+[!code-csharp[ForeignKeyConstraintNameConfig](../../../../samples/core/Modeling/Relationships/ForeignAndPrincipalKeys.cs?name=ForeignKeyConstraintNameConfig)]
+
+> [!TIP]
+> The constraint name is not used by the EF runtime. It is only used when creating a database schema using [EF Core Migrations](xref:core/managing-schemas/migrations/index).
+
+### Excluding foreign key constraints from migrations
+
+> [!NOTE]
+> This feature is being introduced in EF Core 11, which is currently in preview.
+
+Sometimes it is useful to have the foreign key relationship represented in the EF model, but without creating the corresponding foreign key constraint in the database. This can happen with legacy databases where constraints don't exist, or in data synchronization scenarios where the order of inserting related entities might temporarily violate referential integrity constraints. In these cases, use `ExcludeForeignKeyFromMigrations` to prevent EF from generating the foreign key constraint in migrations (and `EnsureCreated`):
+
+```csharp
+modelBuilder.Entity<Blog>()
+    .HasMany(e => e.Posts)
+    .WithOne(e => e.Blog)
+    .HasForeignKey(e => e.BlogId)
+    .ExcludeForeignKeyFromMigrations();
+```
+
+With this configuration, EF will not create a foreign key constraint in the database, but the relationship is still tracked in the EF model and can be used normally for loading related data, change tracking, etc. EF will still create a database index for the foreign key column, since indexes benefit queries regardless of whether a constraint exists.
+
+To apply this across all foreign keys in the model (e.g. to globally disable all foreign key constraints), you can iterate over all foreign keys in `OnModelCreating`:
+
+```csharp
+foreach (var foreignKey in modelBuilder.Model.GetEntityTypes().SelectMany(e => e.GetForeignKeys()))
+{
+    foreignKey.SetIsExcludedFromMigrations(true);
+}
+```
+
+### Indexes for foreign keys
+
+By convention, EF creates a database index for the property or properties of a foreign key. See [_Model building conventions_](xref:core/modeling/relationships/conventions) for more information about the types of indexes created by convention.
+
+> [!TIP]
+> Relationships are defined in the EF model between entity types included in that model. Some relationships may need to reference an entity type in the model of a different context--for example, when using the [BoundedContext pattern](https://www.martinfowler.com/bliki/BoundedContext.html). In these situation, the foreign key column(s) should be mapped to normal properties, and these properties can then be manipulated manually to handle changes to the relationship.
+
+## Principal keys
+
+By convention, foreign keys are constrained to the primary key at the principal end of the relationship. However, an alternate key can be used instead. This is achieved using `HasPrincipalKey` on the model building API. For example, for a single property foreign key:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey(e => e.AlternateId);
+            }
+-->
+[!code-csharp[AlternateKeyConfigurationByLambda](../../../../samples/core/Modeling/Relationships/ForeignAndPrincipalKeys.cs?name=AlternateKeyConfigurationByLambda)]
+
+Or for a composite foreign key with multiple properties:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey(e => new { e.AlternateId1, e.AlternateId2 });
+            }
+-->
+[!code-csharp[CompositeAlternateKeyConfigurationByLambda](../../../../samples/core/Modeling/Relationships/ForeignAndPrincipalKeys.cs?name=CompositeAlternateKeyConfigurationByLambda)]
+
+`HasPrincipalKey` can also be passed the name of the alternate key property as a string. For example, for a single property key:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey("AlternateId");
+            }
+-->
+[!code-csharp[AlternateKeyConfigurationByString](../../../../samples/core/Modeling/Relationships/ForeignAndPrincipalKeys.cs?name=AlternateKeyConfigurationByString)]
+
+Or, for a composite key:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey("AlternateId1", "AlternateId2");
+            }
+-->
+[!code-csharp[CompositeAlternateKeyConfigurationByString](../../../../samples/core/Modeling/Relationships/ForeignAndPrincipalKeys.cs?name=CompositeAlternateKeyConfigurationByString)]
+
+> [!NOTE]
+> The order of the properties in the principal and foreign key must match. This is also the order in which the key is defined in the database schema. It does not have to be the same as the order of the properties in the entity type or the columns in the table.
+
+There is no need to call `HasAlternateKey` to define the alternate key on the principal entity; this is done automatically when `HasPrincipalKey` is used with properties that are not the primary key properties. However, `HasAlternateKey` can be used for further configure the alternate key, such as to set its database constraint name. See [_Keys_](xref:core/modeling/keys) for more information.
+
+## Relationships to keyless entities
+
+Every relationship must have a foreign key that references a principal (primary or alternate) key. This means that a [keyless entity type](xref:core/modeling/keyless-entity-types) cannot act as the principal end of a relationship, since there is no principal key for the foreign keys to reference.
+
+> [!TIP]
+> An entity type cannot have an alternate key but no primary key. In this case, the alternate key (or one of the alternate keys, if there are several) must be promoted to the primary key.
+
+However, keyless entity types can still have foreign keys defined, and hence can act as the dependent end of a relationship. For example, consider these types, where `Tag` has no key:
+
+<!--
+        public class Tag
+        {
+            public string Text { get; set; } = null!;
+            public int PostId { get; set; }
+            public Post Post { get; set; } = null!;
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+        }
+-->
+[!code-csharp[ForeignKeyInKeylessType](../../../../samples/core/Modeling/Relationships/ForeignAndPrincipalKeys.cs?name=ForeignKeyInKeylessType)]
+
+`Tag` can be configured at the dependent end of the relationship:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Tag>()
+                    .HasNoKey();
+
+                modelBuilder.Entity<Post>()
+                    .HasMany<Tag>()
+                    .WithOne(e => e.Post);
+            }
+-->
+[!code-csharp[ForeignKeyInKeylessTypeConfig](../../../../samples/core/Modeling/Relationships/ForeignAndPrincipalKeys.cs?name=ForeignKeyInKeylessTypeConfig)]
+
+> [!NOTE]
+> EF does not support navigations pointing to keyless entity types. See [GitHub Issue #30331](https://github.com/dotnet/efcore/issues/30331).
+
+## Foreign keys in many-to-many relationships
+
+In [many-to-many relationships](xref:core/modeling/relationships/many-to-many), the foreign keys are defined on the join entity type and mapped to foreign key constraints in the join table. Everything described above can also be applied to these join entity foreign keys. For example, setting the database constraint names:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity(
+                        l => l.HasOne(typeof(Tag)).WithMany().HasConstraintName("TagForeignKey_Constraint"),
+                        r => r.HasOne(typeof(Post)).WithMany().HasConstraintName("PostForeignKey_Constraint"));
+            }
+            #endregion
+-->
+[!code-csharp[ManyToManyForeignKeyConstraintNamesConfig](../../../../samples/core/Modeling/Relationships/ForeignAndPrincipalKeys.cs?name=ManyToManyForeignKeyConstraintNamesConfig)]
diff --git a/entity-framework/core/modeling/relationships/glossary.md b/entity-framework/core/modeling/relationships/glossary.md
new file mode 100644
index 0000000000..27d0708d1a
--- /dev/null
+++ b/entity-framework/core/modeling/relationships/glossary.md
@@ -0,0 +1,24 @@
+---
+title: Glossary of relationship terms - EF Core
+description: A glossary of the terms used when mapping foreign keys and relationships in Entity Framework Core
+author: SamMonoRT
+ms.date: 03/30/2023
+uid: core/modeling/relationships/glossary
+---
+# Glossary of relationship terms
+
+There are a number of terms used to describe relationships. It is not necessary to understand all these terms up-front. Refer back here as needed when reading the relationships documentation pages.
+
+- **Dependent entity:** This is the entity that contains the foreign key property or properties. A dependent is sometimes called a "child".
+- **Principal entity:** This is the entity that contains the primary/alternate key property or properties. A principal is sometimes called the "parent".
+- **Principal key:** The property or properties whose values uniquely identify the principal entity. The principal key may be the primary key or an alternate key.
+- **Foreign key:** The property or properties of the dependent entity type that are used to store the key values that match the principal key values of the related principal entity.
+- **Navigation:** A property on the entity on one side of the relationship that references the related entity or entities at the other end of the relationship.
+  - **Collection navigation:** A navigation that contains references to many related entities. Used to reference the "many" side(s) of one-to-many and many-to-many relationships.
+  - **Reference navigation:** A navigation that holds a reference to a single related entity. Used to reference the "one" side(s) of one-to-one and one-to-many relationships.
+  - **Inverse navigation:** When discussing a particular navigation, this term refers to the navigation on the other end of the relationship.
+- **Self-referencing relationship:** A relationship in which the dependent and the principal entity types are the same.
+- **Required relationship** A relationship represented by a non-nullable foreign key. A dependent entity in a required relationship cannot exist without a principal entity to which it refers.
+- **Optional relationship** A relationship represented by a nullable foreign key. A dependent entity in an optional relationship can exist without referring to any principal entity.
+- **Bidirectional relationship** A relationship that has navigations on both sides of the relationship.
+- **Unidirectional relationship** A relationship that has a navigation on one side of the relationship, but no navigation on the other side.
diff --git a/entity-framework/core/modeling/relationships/many-to-many.md b/entity-framework/core/modeling/relationships/many-to-many.md
new file mode 100644
index 0000000000..904e9e1451
--- /dev/null
+++ b/entity-framework/core/modeling/relationships/many-to-many.md
@@ -0,0 +1,1068 @@
+---
+title: Many-to-many relationships - EF Core
+description: How to configure many-to-many relationships between entity types when using Entity Framework Core
+author: SamMonoRT
+ms.date: 03/30/2023
+uid: core/modeling/relationships/many-to-many
+---
+# Many-to-many relationships
+
+Many-to-many relationships are used when any number entities of one entity type is associated with any number of entities of the same or another entity type. For example, a `Post` can have many associated `Tags`, and each `Tag` can in turn be associated with any number of `Posts`.
+
+## Understanding many-to-many relationships
+
+Many-to-many relationships are different from [one-to-many](xref:core/modeling/relationships/one-to-many) and [one-to-one](xref:core/modeling/relationships/one-to-one) relationships in that they cannot be represented in a simple way using just a foreign key. Instead, an additional entity type is needed to "join" the two sides of the relationship. This is known as the "join entity type" and maps to a "join table" in a relational database. The entities of this join entity type contain pairs of foreign key values, where one of each pair points to an entity on one side of the relationship, and the other points to an entity on the other side of the relationship. Each join entity, and therefore each row in the join table, therefore represents one association between the entity types in the relationship.
+
+EF Core can hide the join entity type and manage it behind the scenes. This allows the navigations of a many-to-many relationship to be used in a natural manner, adding or removing entities from each side as needed. However, it is useful to understand what is happening behind the scenes so that their overall behavior, and in particular the mapping to a relational database, makes sense. Let's start with a relational database schema setup to represent a many-to-many relationship between posts and tags:
+
+```sql
+CREATE TABLE "Posts" (
+    "Id" INTEGER NOT NULL CONSTRAINT "PK_Posts" PRIMARY KEY AUTOINCREMENT);
+
+CREATE TABLE "Tags" (
+    "Id" INTEGER NOT NULL CONSTRAINT "PK_Tags" PRIMARY KEY AUTOINCREMENT);
+
+CREATE TABLE "PostTag" (
+    "PostsId" INTEGER NOT NULL,
+    "TagsId" INTEGER NOT NULL,
+    CONSTRAINT "PK_PostTag" PRIMARY KEY ("PostsId", "TagsId"),
+    CONSTRAINT "FK_PostTag_Posts_PostsId" FOREIGN KEY ("PostsId") REFERENCES "Posts" ("Id") ON DELETE CASCADE,
+    CONSTRAINT "FK_PostTag_Tags_TagsId" FOREIGN KEY ("TagsId") REFERENCES "Tags" ("Id") ON DELETE CASCADE);
+```
+
+In this schema, `PostTag` is the join table. It contains two columns: `PostsId`, which is a foreign key to the primary key of the `Posts` table, and `TagsId`, which is a foreign key to primary key of the `Tags` table. Each row in this table therefore represents an association between one `Post` and one `Tag`.
+
+A simplistic mapping for this schema in EF Core consists of three entity types--one for each table. If each of these entity types are represented by a .NET class, then those classes might look the following:
+
+<!--
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<PostTag> PostTags { get; } = new();
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<PostTag> PostTags { get; } = new();
+        }
+
+        public class PostTag
+        {
+            public int PostsId { get; set; }
+            public int TagsId { get; set; }
+            public Post Post { get; set; } = null!;
+            public Tag Tag { get; set; } = null!;
+        }
+-->
+[!code-csharp[DirectJoinTableMapping](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=DirectJoinTableMapping)]
+
+Notice that in this mapping there is no many-to-many relationship, but rather two one-to-many relationships, one for each of the foreign keys defined in the join table. This is not an unreasonable way to map these tables, but doesn't reflect the intent of the join table, which is to represent a single many-to-many relationship, rather than two one-to-many relationships.
+
+EF allows for a more natural mapping through the introduction of two collection navigations, one on `Post` containing its related `Tags`, and an inverse on `Tag` containing its related `Posts`. For example:
+
+<!--
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<PostTag> PostTags { get; } = new();
+            public List<Tag> Tags { get; } = new();
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<PostTag> PostTags { get; } = new();
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class PostTag
+        {
+            public int PostsId { get; set; }
+            public int TagsId { get; set; }
+            public Post Post { get; set; } = null!;
+            public Tag Tag { get; set; } = null!;
+        }
+-->
+[!code-csharp[FullMappingWithJoinEntity](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=FullMappingWithJoinEntity)]
+
+> [!TIP]
+> These new navigations are known as "skip navigations", because they skip over the join entity to provide direct access to the other side of the many-to-many relationship.
+
+As is shown in the example above, a many-to-many relationship can be mapped in this way--that is, with a .NET class for the join entity, and with both navigations for the two one-to-many relationships _and_ skip navigations exposed on the entity types. However, EF can manage the join entity transparently, without a .NET class defined for it, and without navigations for the two one-to-many relationships. For example:
+
+<!--
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = new();
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+-->
+[!code-csharp[BasicManyToMany](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=BasicManyToMany)]
+
+Indeed, EF [model building conventions](xref:core/modeling/relationships/conventions) will, by default, map the `Post` and `Tag` types shown here to the three tables in the database schema at the top of this section. This mapping, without explicit use of the join type, is what is typically meant by the term "many-to-many".
+
+## Examples
+
+The following sections contain examples of many-to-many relationships, including the configuration needed to achieve each mapping.
+
+> [!TIP]
+> The code for all the examples below can be found in [ManyToMany.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Modeling/Relationships/ManyToMany.cs).
+
+## Basic many-to-many
+
+In the most basic case for a many-to-many, the entity types on each end of the relationship both have a collection navigation. For example:
+
+<!--
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = new();
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+-->
+[!code-csharp[BasicManyToMany](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=BasicManyToMany)]
+
+This relationship is [mapped by convention](xref:core/modeling/relationships/conventions). Even though it is not needed, an equivalent explicit configuration for this relationship is shown below as a learning tool:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts);
+            }
+-->
+[!code-csharp[BasicManyToManyConfig](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=BasicManyToManyConfig)]
+
+Even with this explicit configuration, many aspects of the relationship are still configured by convention. A more complete explicit configuration, again for learning purposes, is:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity(
+                        "PostTag",
+                        r => r.HasOne(typeof(Tag)).WithMany().HasForeignKey("TagsId").HasPrincipalKey(nameof(Tag.Id)),
+                        l => l.HasOne(typeof(Post)).WithMany().HasForeignKey("PostsId").HasPrincipalKey(nameof(Post.Id)),
+                        j => j.HasKey("PostsId", "TagsId"));
+            }
+-->
+[!code-csharp[BasicManyToManyFullConfig](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=BasicManyToManyFullConfig)]
+
+> [!IMPORTANT]
+> Please don't attempt to fully configure everything even when it is not needed. As can be seen above, the code gets complicated quickly and its easy to make a mistake. And even in the example above there are many things in the model that are still configured by convention. It's not realistic to think that everything in an EF model can always be fully configured explicitly.
+
+Regardless of whether the relationship is built by convention or using either of the shown explicit configurations, the resulting mapped schema (using SQLite) is:
+
+```sql
+CREATE TABLE "Posts" (
+    "Id" INTEGER NOT NULL CONSTRAINT "PK_Posts" PRIMARY KEY AUTOINCREMENT);
+
+CREATE TABLE "Tags" (
+    "Id" INTEGER NOT NULL CONSTRAINT "PK_Tags" PRIMARY KEY AUTOINCREMENT);
+
+CREATE TABLE "PostTag" (
+    "PostsId" INTEGER NOT NULL,
+    "TagsId" INTEGER NOT NULL,
+    CONSTRAINT "PK_PostTag" PRIMARY KEY ("PostsId", "TagsId"),
+    CONSTRAINT "FK_PostTag_Posts_PostsId" FOREIGN KEY ("PostsId") REFERENCES "Posts" ("Id") ON DELETE CASCADE,
+    CONSTRAINT "FK_PostTag_Tags_TagsId" FOREIGN KEY ("TagsId") REFERENCES "Tags" ("Id") ON DELETE CASCADE);
+```
+
+> [!TIP]
+> When using a Database First flow to [scaffold a DbContext from an existing database](xref:core/managing-schemas/scaffolding), EF Core 6 and later looks for this pattern in the database schema and scaffolds a many-to-many relationship as described in this document. This behavior can be changed through use of a [custom T4 template](xref:core/managing-schemas/scaffolding/templates). For other options, see [_Many-to-many relationships without mapped join entities are now scaffolded_](xref:core/what-is-new/ef-core-6.0/breaking-changes#many-to-many).
+
+> [!IMPORTANT]
+> Currently, EF Core uses `Dictionary<string, object>` to represent join entity instances for which no .NET class has been configured. However, to improve performance, a different type may be used in a future EF Core release. Do not depend on the join type being `Dictionary<string, object>` unless this has been explicitly configured.
+
+## Many-to-many with named join table
+
+In the previous example, the join table was named `PostTag` by convention. It can be given an explicit name with `UsingEntity`. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity("PostsToTagsJoinTable");
+            }
+-->
+[!code-csharp[ManyToManyNamedJoinTableConfig](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyNamedJoinTableConfig)]
+
+Everything else about the mapping remains the same, with only the name of the join table changing:
+
+```sql
+CREATE TABLE "PostsToTagsJoinTable" (
+    "PostsId" INTEGER NOT NULL,
+    "TagsId" INTEGER NOT NULL,
+    CONSTRAINT "PK_PostsToTagsJoinTable" PRIMARY KEY ("PostsId", "TagsId"),
+    CONSTRAINT "FK_PostsToTagsJoinTable_Posts_PostsId" FOREIGN KEY ("PostsId") REFERENCES "Posts" ("Id") ON DELETE CASCADE,
+    CONSTRAINT "FK_PostsToTagsJoinTable_Tags_TagsId" FOREIGN KEY ("TagsId") REFERENCES "Tags" ("Id") ON DELETE CASCADE);
+```
+
+## Many-to-many with join table foreign key names
+
+Following on from the previous example, the names of the foreign key columns in the join table can also be changed. There are two ways to do this. The first is to explicitly specify the foreign key property names on the join entity. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity(
+                        r => r.HasOne(typeof(Tag)).WithMany().HasForeignKey("TagForeignKey"),
+                        l => l.HasOne(typeof(Post)).WithMany().HasForeignKey("PostForeignKey"));
+            }
+-->
+[!code-csharp[ManyToManyNamedForeignKeyColumnsConfig](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyNamedForeignKeyColumnsConfig)]
+
+The second way is to leave the properties with their by-convention names, but then map these properties to different column names. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity(
+                        j =>
+                        {
+                            j.Property("PostsId").HasColumnName("PostForeignKey");
+                            j.Property("TagsId").HasColumnName("TagForeignKey");
+                        });
+            }
+-->
+[!code-csharp[ManyToManyNamedForeignKeyColumnsAlternateConfig](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyNamedForeignKeyColumnsAlternateConfig)]
+
+In either case, the mapping remains the same, with only the foreign key column names changed:
+
+```sql
+CREATE TABLE "PostTag" (
+    "PostForeignKey" INTEGER NOT NULL,
+    "TagForeignKey" INTEGER NOT NULL,
+    CONSTRAINT "PK_PostTag" PRIMARY KEY ("PostForeignKey", "TagForeignKey"),
+    CONSTRAINT "FK_PostTag_Posts_PostForeignKey" FOREIGN KEY ("PostForeignKey") REFERENCES "Posts" ("Id") ON DELETE CASCADE,
+    CONSTRAINT "FK_PostTag_Tags_TagForeignKey" FOREIGN KEY ("TagForeignKey") REFERENCES "Tags" ("Id") ON DELETE CASCADE);
+```
+
+> [!TIP]
+> Although not shown here, the previous two examples can be combined to map change the join table name and its foreign key column names.
+
+## Many-to-many with class for join entity
+
+So far in the examples, the join table has been automatically mapped to a [shared-type entity type](xref:core/modeling/entity-types#shared-type-entity-types). This removes the need for a dedicated class to be created for the entity type. However, it can be useful to have such a class so that it can be referenced easily, especially when navigations or a payload (A "payload" is any additional data in the join table. For example, the timestamp in which an entry in the join table is created.) are added to the class, as is shown in later examples below. To do this, first create a type `PostTag` for the join entity in addition to the existing types for `Post` and `Tag`:
+
+<!--
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = new();
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class PostTag
+        {
+            public int PostId { get; set; }
+            public int TagId { get; set; }
+        }
+-->
+[!code-csharp[ManyToManyWithJoinClass](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyWithJoinClass)]
+
+> [!TIP]
+> The class can have any name, but it is common to combine the names of the types at either end of the relationship.
+
+Now the `UsingEntity` method can be used to configure this as the join entity type for the relationship. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>();
+            }
+-->
+[!code-csharp[ManyToManyWithJoinClassConfig](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyWithJoinClassConfig)]
+
+The `PostId` and `TagId` are automatically picked up as the foreign keys and are configured as the composite primary key for the join entity type. The properties to use for the foreign keys can be explicitly configured for cases where they don't match the EF convention. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>(
+                        r => r.HasOne<Tag>().WithMany().HasForeignKey(e => e.TagId),
+                        l => l.HasOne<Post>().WithMany().HasForeignKey(e => e.PostId));
+            }
+-->
+[!code-csharp[ManyToManyWithJoinClassFkConfig](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyWithJoinClassFkConfig)]
+
+The mapped database schema for the join table in this example is structurally equivalent to the previous examples, but with some different column names:
+
+```sql
+CREATE TABLE "PostTag" (
+    "PostId" INTEGER NOT NULL,
+    "TagId" INTEGER NOT NULL,
+    CONSTRAINT "PK_PostTag" PRIMARY KEY ("PostId", "TagId"),
+    CONSTRAINT "FK_PostTag_Posts_PostId" FOREIGN KEY ("PostId") REFERENCES "Posts" ("Id") ON DELETE CASCADE,
+    CONSTRAINT "FK_PostTag_Tags_TagId" FOREIGN KEY ("TagId") REFERENCES "Tags" ("Id") ON DELETE CASCADE);
+```
+
+## Many-to-many with navigations to join entity
+
+Following on from the previous example, now that there is a class representing the join entity, it becomes easy to add navigations that reference this class. For example:
+
+<!--
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = new();
+            public List<PostTag> PostTags { get; } = new();
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = new();
+            public List<PostTag> PostTags { get; } = new();
+        }
+
+        public class PostTag
+        {
+            public int PostId { get; set; }
+            public int TagId { get; set; }
+        }
+-->
+[!code-csharp[ManyToManyWithNavsToJoinClass](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyWithNavsToJoinClass)]
+
+> [!IMPORTANT]
+> As shown in this example, navigations to the join entity type can be used _in addition to_ the skip navigations between the two ends of the many-to-many relationship. This means that the skip navigations can be used to interact with the many-to-many relationship in a natural manner, while the navigations to the join entity type can be used when greater control over the join entities themselves is needed. In a sense, this mapping provides the best of both worlds between a simple many-to-many mapping, and a mapping that more explicitly matches the database schema.
+
+Nothing needs to be changed in the `UsingEntity` call, since the navigations to the join entity are picked up by convention. Therefore, the configuration for this example is the same as for the last example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>();
+            }
+-->
+[!code-csharp[ManyToManyWithJoinClassConfig](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyWithJoinClassConfig)]
+
+The navigations can be configured explicitly for cases where they cannot be determined by convention. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>(
+                        r => r.HasOne<Tag>().WithMany(e => e.PostTags),
+                        l => l.HasOne<Post>().WithMany(e => e.PostTags));
+            }
+-->
+[!code-csharp[ManyToManyWithNavsToJoinClassWithNavConfig](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyWithNavsToJoinClassWithNavConfig)]
+
+The mapped database schema is not affected by including navigations in the model:
+
+```sql
+CREATE TABLE "PostTag" (
+    "PostId" INTEGER NOT NULL,
+    "TagId" INTEGER NOT NULL,
+    CONSTRAINT "PK_PostTag" PRIMARY KEY ("PostId", "TagId"),
+    CONSTRAINT "FK_PostTag_Posts_PostId" FOREIGN KEY ("PostId") REFERENCES "Posts" ("Id") ON DELETE CASCADE,
+    CONSTRAINT "FK_PostTag_Tags_TagId" FOREIGN KEY ("TagId") REFERENCES "Tags" ("Id") ON DELETE CASCADE);
+```
+
+## Many-to-many with navigations to and from join entity
+
+The previous example added navigations to the join entity type from the entity types at either end of the many-to-many relationship. Navigations can also be added in the other direction, or in both directions. For example:
+
+<!--
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = new();
+            public List<PostTag> PostTags { get; } = new();
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = new();
+            public List<PostTag> PostTags { get; } = new();
+        }
+
+        public class PostTag
+        {
+            public int PostId { get; set; }
+            public int TagId { get; set; }
+            public Post Post { get; set; } = null!;
+            public Tag Tag { get; set; } = null!;
+        }
+-->
+[!code-csharp[ManyToManyWithNavsToAndFromJoinClass](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyWithNavsToAndFromJoinClass)]
+
+Nothing needs to be changed in the `UsingEntity` call, since the navigations to the join entity are picked up by convention. Therefore, the configuration for this example is the same as for the last example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>();
+            }
+-->
+[!code-csharp[ManyToManyWithNavsToAndFromJoinClassConfig](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyWithNavsToAndFromJoinClassConfig)]
+
+The navigations can be configured explicitly for cases where they cannot be determined by convention. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>(
+                        r => r.HasOne<Tag>(e => e.Tag).WithMany(e => e.PostTags),
+                        l => l.HasOne<Post>(e => e.Post).WithMany(e => e.PostTags));
+            }
+-->
+[!code-csharp[ManyToManyWithNavsToAndFromJoinClassWithNavConfig](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyWithNavsToAndFromJoinClassWithNavConfig)]
+
+The mapped database schema is not affected by including navigations in the model:
+
+```sql
+CREATE TABLE "PostTag" (
+    "PostId" INTEGER NOT NULL,
+    "TagId" INTEGER NOT NULL,
+    CONSTRAINT "PK_PostTag" PRIMARY KEY ("PostId", "TagId"),
+    CONSTRAINT "FK_PostTag_Posts_PostId" FOREIGN KEY ("PostId") REFERENCES "Posts" ("Id") ON DELETE CASCADE,
+    CONSTRAINT "FK_PostTag_Tags_TagId" FOREIGN KEY ("TagId") REFERENCES "Tags" ("Id") ON DELETE CASCADE);
+```
+
+## Many-to-many with navigations and changed foreign keys
+
+The previous example showed a many-to-many with navigations to and from the join entity type. This example is the same, except that the foreign key properties used are also changed. For example:
+
+<!--
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = new();
+            public List<PostTag> PostTags { get; } = new();
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = new();
+            public List<PostTag> PostTags { get; } = new();
+        }
+
+        public class PostTag
+        {
+            public int PostForeignKey { get; set; }
+            public int TagForeignKey { get; set; }
+            public Post Post { get; set; } = null!;
+            public Tag Tag { get; set; } = null!;
+        }
+-->
+[!code-csharp[ManyToManyWithNamedFksAndNavsToAndFromJoinClass](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyWithNamedFksAndNavsToAndFromJoinClass)]
+
+Again, the `UsingEntity` method is used to configure this:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>(
+                        r => r.HasOne<Tag>(e => e.Tag).WithMany(e => e.PostTags).HasForeignKey(e => e.TagForeignKey),
+                        l => l.HasOne<Post>(e => e.Post).WithMany(e => e.PostTags).HasForeignKey(e => e.PostForeignKey));
+            }
+-->
+[!code-csharp[ManyToManyWithNamedFksAndNavsToAndFromJoinClassConfig](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyWithNamedFksAndNavsToAndFromJoinClassConfig)]
+
+The mapped database schema is now:
+
+```sql
+CREATE TABLE "PostTag" (
+    "PostForeignKey" INTEGER NOT NULL,
+    "TagForeignKey" INTEGER NOT NULL,
+    CONSTRAINT "PK_PostTag" PRIMARY KEY ("PostForeignKey", "TagForeignKey"),
+    CONSTRAINT "FK_PostTag_Posts_PostForeignKey" FOREIGN KEY ("PostForeignKey") REFERENCES "Posts" ("Id") ON DELETE CASCADE,
+    CONSTRAINT "FK_PostTag_Tags_TagForeignKey" FOREIGN KEY ("TagForeignKey") REFERENCES "Tags" ("Id") ON DELETE CASCADE);
+```
+
+## Unidirectional many-to-many
+
+It is not necessary to include a navigation on both sides of the many-to-many relationship. For example:
+
+<!--
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = new();
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+        }
+-->
+[!code-csharp[UnidirectionalManyToMany](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=UnidirectionalManyToMany)]
+
+EF needs some configuration to know that this should be a many-to-many relationship, rather than a one-to-many. This is done using `HasMany` and `WithMany`, but with no argument passed on the side without a navigation. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany();
+            }
+-->
+[!code-csharp[UnidirectionalManyToManyConfig](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=UnidirectionalManyToManyConfig)]
+
+Removing the navigation does not affect the database schema:
+
+```sql
+CREATE TABLE "Posts" (
+    "Id" INTEGER NOT NULL CONSTRAINT "PK_Posts" PRIMARY KEY AUTOINCREMENT);
+
+CREATE TABLE "Tags" (
+    "Id" INTEGER NOT NULL CONSTRAINT "PK_Tags" PRIMARY KEY AUTOINCREMENT);
+
+CREATE TABLE "PostTag" (
+    "PostId" INTEGER NOT NULL,
+    "TagsId" INTEGER NOT NULL,
+    CONSTRAINT "PK_PostTag" PRIMARY KEY ("PostId", "TagsId"),
+    CONSTRAINT "FK_PostTag_Posts_PostId" FOREIGN KEY ("PostId") REFERENCES "Posts" ("Id") ON DELETE CASCADE,
+    CONSTRAINT "FK_PostTag_Tags_TagsId" FOREIGN KEY ("TagsId") REFERENCES "Tags" ("Id") ON DELETE CASCADE);
+```
+
+## Many-to-many and join table with payload
+
+In the examples so far, the join table has been used only to store the foreign key pairs representing each association. However, it can also be used to store information about the association--for example, the time it was created. In such cases it is best to define a type for the join entity and add the "association payload" properties to this type. It is also common to create navigations to the join entity in addition to the "skip navigations" used for the many-to-many relationship. These additional navigations allow the join entity to be easily referenced from code, thereby facilitating reading and/or changing the payload data. For example:
+
+<!--
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = new();
+            public List<PostTag> PostTags { get; } = new();
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = new();
+            public List<PostTag> PostTags { get; } = new();
+        }
+
+        public class PostTag
+        {
+            public int PostId { get; set; }
+            public int TagId { get; set; }
+            public DateTime CreatedOn { get; set; }
+        }
+-->
+[!code-csharp[ManyToManyWithPayloadAndNavsToJoinClass](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyWithPayloadAndNavsToJoinClass)]
+
+It is also common to use generated values for payload properties--for example, a database timestamp that is automatically set when the association row is inserted. This requires some minimal configuration. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>(
+                        j => j.Property(e => e.CreatedOn).HasDefaultValueSql("CURRENT_TIMESTAMP"));
+            }
+-->
+[!code-csharp[ManyToManyWithPayloadAndNavsToJoinClassConfig](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyWithPayloadAndNavsToJoinClassConfig)]
+
+The result maps to a entity type schema with a timestamp set automatically when a row is inserted:
+
+```sql
+CREATE TABLE "PostTag" (
+    "PostId" INTEGER NOT NULL,
+    "TagId" INTEGER NOT NULL,
+    "CreatedOn" TEXT NOT NULL DEFAULT (CURRENT_TIMESTAMP),
+    CONSTRAINT "PK_PostTag" PRIMARY KEY ("PostId", "TagId"),
+    CONSTRAINT "FK_PostTag_Posts_PostId" FOREIGN KEY ("PostId") REFERENCES "Posts" ("Id") ON DELETE CASCADE,
+    CONSTRAINT "FK_PostTag_Tags_TagId" FOREIGN KEY ("TagId") REFERENCES "Tags" ("Id") ON DELETE CASCADE);
+```
+
+> [!TIP]
+> The SQL shown here is for SQLite. On SQL Server/Azure SQL, use `.HasDefaultValueSql("GETUTCDATE()")` and for `TEXT` read `datetime`.
+
+## Custom shared-type entity type as a join entity
+
+The previous example used the type `PostTag` as the join entity type. This type is specific to the posts-tags relationship. However, if you have multiple join tables with the same shape, then the same CLR type can be used for all of them. For example, imagine that all our join tables have a `CreatedOn` column. We can map these using `JoinType` class mapped as a [shared-type entity type](xref:core/modeling/entity-types#shared-type-entity-types):
+
+```csharp
+public class JoinType
+{
+    public int Id1 { get; set; }
+    public int Id2 { get; set; }
+    public DateTime CreatedOn { get; set; }
+}
+```
+
+This type can then be referenced as the join entity type by multiple different many-to-many relationships. For example:
+
+<!--
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = new();
+            public List<JoinType> PostTags { get; } = new();
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = new();
+            public List<JoinType> PostTags { get; } = new();
+        }
+
+        public class Blog
+        {
+            public int Id { get; set; }
+            public List<Author> Authors { get; } = new();
+            public List<JoinType> BlogAuthors { get; } = new();
+        }
+
+        public class Author
+        {
+            public int Id { get; set; }
+            public List<Blog> Blogs { get; } = new();
+            public List<JoinType> BlogAuthors { get; } = new();
+        }
+-->
+[!code-csharp[ManyToManyWithCustomSharedTypeEntityType](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyWithCustomSharedTypeEntityType)]
+
+And these relationships can then be configured appropriately to map the join type to a different table for each relationship:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<JoinType>(
+                        "PostTag",
+                        r => r.HasOne<Tag>().WithMany(e => e.PostTags).HasForeignKey(e => e.Id1),
+                        l => l.HasOne<Post>().WithMany(e => e.PostTags).HasForeignKey(e => e.Id2),
+                        j => j.Property(e => e.CreatedOn).HasDefaultValueSql("CURRENT_TIMESTAMP"));
+
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Authors)
+                    .WithMany(e => e.Blogs)
+                    .UsingEntity<JoinType>(
+                        "BlogAuthor",
+                        r => r.HasOne<Author>().WithMany(e => e.BlogAuthors).HasForeignKey(e => e.Id1),
+                        l => l.HasOne<Blog>().WithMany(e => e.BlogAuthors).HasForeignKey(e => e.Id2),
+                        j => j.Property(e => e.CreatedOn).HasDefaultValueSql("CURRENT_TIMESTAMP"));
+            }
+-->
+[!code-csharp[ManyToManyWithCustomSharedTypeEntityTypeConfig](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyWithCustomSharedTypeEntityTypeConfig)]
+
+This results in the following tables in the database schema:
+
+```sql
+CREATE TABLE "BlogAuthor" (
+    "Id1" INTEGER NOT NULL,
+    "Id2" INTEGER NOT NULL,
+    "CreatedOn" TEXT NOT NULL DEFAULT (CURRENT_TIMESTAMP),
+    CONSTRAINT "PK_BlogAuthor" PRIMARY KEY ("Id1", "Id2"),
+    CONSTRAINT "FK_BlogAuthor_Authors_Id1" FOREIGN KEY ("Id1") REFERENCES "Authors" ("Id") ON DELETE CASCADE,
+    CONSTRAINT "FK_BlogAuthor_Blogs_Id2" FOREIGN KEY ("Id2") REFERENCES "Blogs" ("Id") ON DELETE CASCADE);
+
+
+CREATE TABLE "PostTag" (
+    "Id1" INTEGER NOT NULL,
+    "Id2" INTEGER NOT NULL,
+    "CreatedOn" TEXT NOT NULL DEFAULT (CURRENT_TIMESTAMP),
+    CONSTRAINT "PK_PostTag" PRIMARY KEY ("Id1", "Id2"),
+    CONSTRAINT "FK_PostTag_Posts_Id2" FOREIGN KEY ("Id2") REFERENCES "Posts" ("Id") ON DELETE CASCADE,
+    CONSTRAINT "FK_PostTag_Tags_Id1" FOREIGN KEY ("Id1") REFERENCES "Tags" ("Id") ON DELETE CASCADE);
+```
+
+## Many-to-many with alternate keys
+
+So far, all the examples have shown the foreign keys in the join entity type being constrained to the primary keys of the entity types on either side of the relationship. Each foreign key, or both, can instead be constrained to an alternate key. For example, consider this model where`Tag` and `Post` have alternate key properties:
+
+<!--
+        public class Post
+        {
+            public int Id { get; set; }
+            public int AlternateKey { get; set; }
+            public List<Tag> Tags { get; } = new();
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public int AlternateKey { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+-->
+[!code-csharp[ManyToManyAlternateKeys](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyAlternateKeys)]
+
+The configuration for this model is:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity(
+                        r => r.HasOne(typeof(Tag)).WithMany().HasPrincipalKey(nameof(Tag.AlternateKey)),
+                        l => l.HasOne(typeof(Post)).WithMany().HasPrincipalKey(nameof(Post.AlternateKey)));
+            }
+-->
+[!code-csharp[ManyToManyAlternateKeysConfig](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyAlternateKeysConfig)]
+
+And the resulting database schema, for clarity, including also the tables with the alternate keys:
+
+```sql
+CREATE TABLE "Posts" (
+    "Id" INTEGER NOT NULL CONSTRAINT "PK_Posts" PRIMARY KEY AUTOINCREMENT,
+    "AlternateKey" INTEGER NOT NULL,
+    CONSTRAINT "AK_Posts_AlternateKey" UNIQUE ("AlternateKey"));
+
+CREATE TABLE "Tags" (
+    "Id" INTEGER NOT NULL CONSTRAINT "PK_Tags" PRIMARY KEY AUTOINCREMENT,
+    "AlternateKey" INTEGER NOT NULL,
+    CONSTRAINT "AK_Tags_AlternateKey" UNIQUE ("AlternateKey"));
+
+CREATE TABLE "PostTag" (
+    "PostsAlternateKey" INTEGER NOT NULL,
+    "TagsAlternateKey" INTEGER NOT NULL,
+    CONSTRAINT "PK_PostTag" PRIMARY KEY ("PostsAlternateKey", "TagsAlternateKey"),
+    CONSTRAINT "FK_PostTag_Posts_PostsAlternateKey" FOREIGN KEY ("PostsAlternateKey") REFERENCES "Posts" ("AlternateKey") ON DELETE CASCADE,
+    CONSTRAINT "FK_PostTag_Tags_TagsAlternateKey" FOREIGN KEY ("TagsAlternateKey") REFERENCES "Tags" ("AlternateKey") ON DELETE CASCADE);
+```
+
+The configuration for using alternate keys is slightly different if the join entity type is represented by a .NET type. For example:
+
+<!--
+        public class Post
+        {
+            public int Id { get; set; }
+            public int AlternateKey { get; set; }
+            public List<Tag> Tags { get; } = new();
+            public List<PostTag> PostTags { get; } = new();
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public int AlternateKey { get; set; }
+            public List<Post> Posts { get; } = new();
+            public List<PostTag> PostTags { get; } = new();
+        }
+
+        public class PostTag
+        {
+            public int PostId { get; set; }
+            public int TagId { get; set; }
+            public Post Post { get; set; } = null!;
+            public Tag Tag { get; set; } = null!;
+        }
+-->
+[!code-csharp[ManyToManyWithNavsAndAlternateKeys](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyWithNavsAndAlternateKeys)]
+
+The configuration can now use the generic `UsingEntity<>` method:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>(
+                        r => r.HasOne<Tag>(e => e.Tag).WithMany(e => e.PostTags).HasPrincipalKey(e => e.AlternateKey),
+                        l => l.HasOne<Post>(e => e.Post).WithMany(e => e.PostTags).HasPrincipalKey(e => e.AlternateKey));
+            }
+-->
+[!code-csharp[ManyToManyWithNavsAndAlternateKeysConfig](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyWithNavsAndAlternateKeysConfig)]
+
+And the resulting schema is:
+
+```sql
+CREATE TABLE "Posts" (
+    "Id" INTEGER NOT NULL CONSTRAINT "PK_Posts" PRIMARY KEY AUTOINCREMENT,
+    "AlternateKey" INTEGER NOT NULL,
+    CONSTRAINT "AK_Posts_AlternateKey" UNIQUE ("AlternateKey"));
+
+CREATE TABLE "Tags" (
+    "Id" INTEGER NOT NULL CONSTRAINT "PK_Tags" PRIMARY KEY AUTOINCREMENT,
+    "AlternateKey" INTEGER NOT NULL,
+    CONSTRAINT "AK_Tags_AlternateKey" UNIQUE ("AlternateKey"));
+
+CREATE TABLE "PostTag" (
+    "PostId" INTEGER NOT NULL,
+    "TagId" INTEGER NOT NULL,
+    CONSTRAINT "PK_PostTag" PRIMARY KEY ("PostId", "TagId"),
+    CONSTRAINT "FK_PostTag_Posts_PostId" FOREIGN KEY ("PostId") REFERENCES "Posts" ("AlternateKey") ON DELETE CASCADE,
+    CONSTRAINT "FK_PostTag_Tags_TagId" FOREIGN KEY ("TagId") REFERENCES "Tags" ("AlternateKey") ON DELETE CASCADE);
+```
+
+## Many-to-many and join table with separate primary key
+
+So far, the join entity type in all the examples has a primary key composed of the two foreign key properties. This is because each combination of values for these properties can occur at most once. These properties therefore form a natural primary key.
+
+> [!NOTE]
+> EF Core does not support duplicate entities in any collection navigation.
+
+If you control the database schema, then there is no reason for the join table to have an additional primary key column, However, it is possible that an existing join table may have a primary key column defined. EF can still map to this with some configuration.
+
+It is perhaps easiest to this by creating a class to represent the join entity. For example:
+
+<!--
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = new();
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class PostTag
+        {
+            public int Id { get; set; }
+            public int PostId { get; set; }
+            public int TagId { get; set; }
+        }
+        #endregion
+-->
+[!code-csharp[ManyToManyWithJoinClassHavingPrimaryKey](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyWithJoinClassHavingPrimaryKey)]
+
+This `PostTag.Id` property is now picked up as the primary key by convention, so the only configuration needed is a call to `UsingEntity` for the `PostTag` type:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>();
+            }
+-->
+[!code-csharp[ManyToManyWithJoinClassHavingPrimaryKeyConfig](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyWithJoinClassHavingPrimaryKeyConfig)]
+
+And the resulting schema for the join table is:
+
+```sql
+CREATE TABLE "PostTag" (
+    "Id" INTEGER NOT NULL CONSTRAINT "PK_PostTag" PRIMARY KEY AUTOINCREMENT,
+    "PostId" INTEGER NOT NULL,
+    "TagId" INTEGER NOT NULL,
+    CONSTRAINT "FK_PostTag_Posts_PostId" FOREIGN KEY ("PostId") REFERENCES "Posts" ("Id") ON DELETE CASCADE,
+    CONSTRAINT "FK_PostTag_Tags_TagId" FOREIGN KEY ("TagId") REFERENCES "Tags" ("Id") ON DELETE CASCADE);
+```
+
+A primary key can also be added to the join entity without defining a class for it. For example, with just `Post` and `Tag` types:
+
+<!--
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = new();
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+-->
+[!code-csharp[ManyToManyWithPrimaryKeyInJoinEntity](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyWithPrimaryKeyInJoinEntity)]
+
+The key can be added with this configuration:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity(
+                        j =>
+                        {
+                            j.IndexerProperty<int>("Id");
+                            j.HasKey("Id");
+                        });
+            }
+-->
+[!code-csharp[ManyToManyWithPrimaryKeyInJoinEntityConfig](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyWithPrimaryKeyInJoinEntityConfig)]
+
+Which results in a join table with a separate primary key column:
+
+```sql
+CREATE TABLE "PostTag" (
+    "Id" INTEGER NOT NULL CONSTRAINT "PK_PostTag" PRIMARY KEY AUTOINCREMENT,
+    "PostsId" INTEGER NOT NULL,
+    "TagsId" INTEGER NOT NULL,
+    CONSTRAINT "FK_PostTag_Posts_PostsId" FOREIGN KEY ("PostsId") REFERENCES "Posts" ("Id") ON DELETE CASCADE,
+    CONSTRAINT "FK_PostTag_Tags_TagsId" FOREIGN KEY ("TagsId") REFERENCES "Tags" ("Id") ON DELETE CASCADE);
+```
+
+## Many-to-many without cascading delete
+
+In all the examples shown above, the foreign keys created between the join table and the two sides of the many-to-many relationship are created with [cascading delete](xref:core/saving/cascade-delete) behavior. This is very useful because it means that if an entity on either side of the relationship is deleted, then the rows in the join table for that entity are automatically deleted. Or, in other words, when an entity no longer exists, then its relationships to other entities also no longer exist.
+
+It's hard to imagine when it is useful to change this behavior, but it can be done if desired. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity(
+                        r => r.HasOne(typeof(Tag)).WithMany().OnDelete(DeleteBehavior.Restrict),
+                        l => l.HasOne(typeof(Post)).WithMany().OnDelete(DeleteBehavior.Restrict));
+            }
+-->
+[!code-csharp[ManyToManyWithNoCascadeDeleteConfig](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=ManyToManyWithNoCascadeDeleteConfig)]
+
+The database schema for the join table uses restricted delete behavior on the foreign key constraint:
+
+```sql
+CREATE TABLE "PostTag" (
+    "PostsId" INTEGER NOT NULL,
+    "TagsId" INTEGER NOT NULL,
+    CONSTRAINT "PK_PostTag" PRIMARY KEY ("PostsId", "TagsId"),
+    CONSTRAINT "FK_PostTag_Posts_PostsId" FOREIGN KEY ("PostsId") REFERENCES "Posts" ("Id") ON DELETE RESTRICT,
+    CONSTRAINT "FK_PostTag_Tags_TagsId" FOREIGN KEY ("TagsId") REFERENCES "Tags" ("Id") ON DELETE RESTRICT);
+```
+
+## Self-referencing many-to-many
+
+The same entity type can be used at both ends of a many-to-many relationship; this is known as a "self-referencing" relationship. For example:
+
+<!--
+        public class Person
+        {
+            public int Id { get; set; }
+            public List<Person> Parents { get; } = new();
+            public List<Person> Children { get; } = new();
+        }
+-->
+[!code-csharp[SelfReferencingManyToMany](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=SelfReferencingManyToMany)]
+
+This maps to a join table called `PersonPerson`, with both foreign keys pointing back to the `People` table:
+
+```sql
+CREATE TABLE "PersonPerson" (
+    "ChildrenId" INTEGER NOT NULL,
+    "ParentsId" INTEGER NOT NULL,
+    CONSTRAINT "PK_PersonPerson" PRIMARY KEY ("ChildrenId", "ParentsId"),
+    CONSTRAINT "FK_PersonPerson_People_ChildrenId" FOREIGN KEY ("ChildrenId") REFERENCES "People" ("Id") ON DELETE CASCADE,
+    CONSTRAINT "FK_PersonPerson_People_ParentsId" FOREIGN KEY ("ParentsId") REFERENCES "People" ("Id") ON DELETE CASCADE);
+```
+
+## Symmetrical self-referencing many-to-many
+
+Sometimes a many-to-many relationship is naturally symmetrical. That is, if entity A is related to entity B, then entity B is also related to entity A. This is naturally modeled using a single navigation. For example, imagine the case where person A is friends with person B, and person B is friends with person A:
+
+<!--
+        public class Person
+        {
+            public int Id { get; set; }
+            public List<Person> Friends { get; } = new();
+        }
+-->
+[!code-csharp[SelfReferencingUnidirectionalManyToMany](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=SelfReferencingUnidirectionalManyToMany)]
+
+Unfortunately, this is not easy to map. The same navigation cannot be used for both ends of the relationship. The best that can be done is to map it as a unidirectional many-to-many relationship. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Person>()
+                    .HasMany(e => e.Friends)
+                    .WithMany();
+            }
+-->
+[!code-csharp[SelfReferencingUnidirectionalManyToManyConfig](../../../../samples/core/Modeling/Relationships/ManyToMany.cs?name=SelfReferencingUnidirectionalManyToManyConfig)]
+
+However, to make sure two people are both related to each other, each person will need to be manually added to the other person's `Friends` collection. For example:
+
+```csharp
+ginny.Friends.Add(hermione);
+hermione.Friends.Add(ginny);
+```
+
+## Direct use of join table
+
+All of the examples above make use of the EF Core many-to-many mapping patterns. However, it is also possible to map a join table to a normal entity type and just use the two one-to-many relationships for all operations.
+
+For example, these entity types represent the mapping of two normal tables and join table without using any many-to-many relationships:
+
+```csharp
+public class Post
+{
+    public int Id { get; set; }
+    public List<PostTag> PostTags { get; } = new();
+}
+
+public class Tag
+{
+    public int Id { get; set; }
+    public List<PostTag> PostTags { get; } = new();
+}
+
+public class PostTag
+{
+    public int PostId { get; set; }
+    public int TagId { get; set; }
+    public Post Post { get; set; } = null!;
+    public Tag Tag { get; set; } = null!;
+}
+```
+
+This requires no special mapping, since these are normal entity types with normal [one-to-many](xref:core/modeling/relationships/one-to-many) relationships.
+
+## Additional resources
+
+* [.NET Data Community Standup session](https://www.youtube.com/watch?v=W1sxepfIMRM&list=PLdo4fOcmZ0oX-DBuRG4u58ZTAJgBAeQ-t&index=32), with a deep dive into many-to-many and the infrastructure underpinning it.
diff --git a/entity-framework/core/modeling/relationships/mapping-attributes.md b/entity-framework/core/modeling/relationships/mapping-attributes.md
new file mode 100644
index 0000000000..6d5fe39f11
--- /dev/null
+++ b/entity-framework/core/modeling/relationships/mapping-attributes.md
@@ -0,0 +1,209 @@
+---
+title: Mapping attributes (aka Data Annotations) for relationships - EF Core
+description: Using mapping attributes (also know as Data Annotations) to configure Entity Framework Core relationships
+author: SamMonoRT
+ms.date: 03/30/2023
+uid: core/modeling/relationships/mapping-attributes
+---
+# Mapping attributes (aka data annotations) for relationships
+
+Mapping attributes are used to modify or override the configuration discovered by [model building conventions](xref:core/modeling/relationships/conventions). The configuration performed by mapping attributes can itself be overridden by [the model building API used in `OnModelCreating`](xref:core/modeling/index).
+
+> [!IMPORTANT]
+> This document only covers mapping attributes in the context of relationship configuration. Other uses of mapping attributes are covered in the relevant sections of the wider [modeling documentation](xref:core/modeling/index).
+
+> [!TIP]
+> The code below can be found in [MappingAttributes.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Modeling/Relationships/MappingAttributes.cs).
+
+## Where to get mapping attributes
+
+Many mapping attributes come from the [System.ComponentModel.DataAnnotations](/dotnet/api/system.componentmodel.dataannotations) and [System.ComponentModel.DataAnnotations.Schema](/dotnet/api/system.componentmodel.dataannotations.schema) namespaces. The attributes in these namespaces are included as part of the base framework in all supported versions of .NET, and so do not require the installation of any additional NuGet packages. These mapping attributes are commonly called "data annotations" and are used by a variety of frameworks, including EF Core, EF6, ASP.NET Core MVC, and so on. They are also used for validation.
+
+The use of data annotations across many technologies and for both mapping and validation has led to differences in semantics across technologies. All new mapping attributes designed for EF Core are now specific to EF Core, thereby keeping their semantics and use simple and clear. These attributes are contained in the [Microsoft.EntityFrameworkCore.Abstractions](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Abstractions/) NuGet package. This package is included as a dependency whenever the main [Microsoft.EntityFrameworkCore](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore/) package, or one of the associated database provider packages, is used. However, the Abstractions package is a lightweight package that can be referenced directly by application code without bringing in all of EF Core and its dependencies.
+
+## RequiredAttribute
+
+<xref:System.ComponentModel.DataAnnotations.RequiredAttribute> is applied to a property to indicate that the property cannot be `null`. In the context of relationships, `[Required]` is usually used on a foreign key property. Doing so makes the foreign key not nullable, thereby making the relationship required. For example, with the following types, the `Post.BlogId` property is made non-nullable, and the relationship becomes required.
+
+<!--
+        public class Blog
+        {
+            public string Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+
+            [Required]
+            public string BlogId { get; set; }
+
+            public Blog Blog { get; init; }
+        }
+-->
+[!code-csharp[RequiredOnForeignKey](../../../../samples/core/Modeling/Relationships/MappingAttributes.cs?name=RequiredOnForeignKey)]
+
+> [!NOTE]
+> When using [C# nullable reference types](/dotnet/csharp/tutorials/nullable-reference-types), the `BlogId` property in this example is already non-nullable, which means the `[Required]` attribute will have no effect.
+
+`[Required]` placed on the dependent navigation has the same effect. That is, making the foreign key non-nullable, and thereby making the relationship required. For example:
+
+<!--
+        public class Blog
+        {
+            public string Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+
+            public string BlogId { get; set; }
+
+            [Required]
+            public Blog Blog { get; init; }
+        }
+-->
+[!code-csharp[RequiredOnDependentNavigation](../../../../samples/core/Modeling/Relationships/MappingAttributes.cs?name=RequiredOnDependentNavigation)]
+
+If `[Required]` is found on the dependent navigation and the foreign key property is in shadow state, then shadow property is made non-nullable, thereby making the relationship required. For example:
+
+<!--
+        public class Blog
+        {
+            public string Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+
+            [Required]
+            public Blog Blog { get; init; }
+        }
+-->
+[!code-csharp[RequiredOnDependentNavigationShadowFk](../../../../samples/core/Modeling/Relationships/MappingAttributes.cs?name=RequiredOnDependentNavigationShadowFk)]
+
+> [!NOTE]
+> Using `[Required]` on the principal navigation side of a relationship has no effect.
+
+## ForeignKeyAttribute
+
+<xref:System.ComponentModel.DataAnnotations.Schema.ForeignKeyAttribute> is used to connect a foreign key property with its navigations. `[ForeignKey]` can be placed on the foreign key property with the name of the dependent navigation. For example:
+
+<!--
+        public class Blog
+        {
+            public string Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+
+            [ForeignKey(nameof(Blog))]
+            public string BlogKey { get; set; }
+
+            public Blog Blog { get; init; }
+        }
+
+-->
+[!code-csharp[ForeignKeyOnProperty](../../../../samples/core/Modeling/Relationships/MappingAttributes.cs?name=ForeignKeyOnProperty)]
+
+Or, `[ForeignKey]` can be placed on either the dependent or principal navigation with the name of the property to use as the foreign key. For example:
+
+<!--
+        public class Blog
+        {
+            public string Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+
+            public string BlogKey { get; set; }
+
+            [ForeignKey(nameof(BlogKey))]
+            public Blog Blog { get; init; }
+        }
+
+-->
+[!code-csharp[ForeignKeyOnDependentNavigation](../../../../samples/core/Modeling/Relationships/MappingAttributes.cs?name=ForeignKeyOnDependentNavigation)]
+
+When `[ForeignKey]` is placed on a navigation and the name provided does not match any property name, then a [shadow property](xref:core/modeling/shadow-properties) with that name will be created to act as the foreign key. For example:
+
+<!--
+        public class Blog
+        {
+            public string Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+
+            [ForeignKey("BlogKey")]
+            public Blog Blog { get; init; }
+        }
+-->
+[!code-csharp[ForeignKeyOnDependentNavigationShadowFk](../../../../samples/core/Modeling/Relationships/MappingAttributes.cs?name=ForeignKeyOnDependentNavigationShadowFk)]
+
+## InversePropertyAttribute
+
+<xref:System.ComponentModel.DataAnnotations.Schema.InversePropertyAttribute> is used to connect a navigation with its inverse. For example, in the following entity types, there are two relationships between `Blog` and `Post`. Without any configuration, [EF conventions](xref:core/modeling/relationships/conventions) cannot determine which navigations between the two types should be paired. Adding `[InverseProperty]` to one of the paired navigations resolves this ambiguity and allows EF to build the model.
+
+<!--
+        public class Blog
+        {
+            public int Id { get; set; }
+
+            [InverseProperty("Blog")]
+            public List<Post> Posts { get; } = new();
+
+            public int FeaturedPostId { get; set; }
+            public Post FeaturedPost { get; set; }
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; }
+
+            public Blog Blog { get; init; }
+        }
+-->
+[!code-csharp[InverseOnPrincipalNavigation](../../../../samples/core/Modeling/Relationships/MappingAttributes.cs?name=InverseOnPrincipalNavigation)]
+
+> [!IMPORTANT]
+> `[InverseProperty]` is only needed when there is more than one relationship between the same types. With a single relationship, the two navigations are paired automatically.
+
+## DeleteBehaviorAttribute
+
+[By convention](xref:core/modeling/relationships/conventions), EF uses the `ClientSetNull` <xref:Microsoft.EntityFrameworkCore.DeleteBehavior> for optional relationships, and the `Cascade` behavior for required relationships. This can be changed by placing the <xref:Microsoft.EntityFrameworkCore.DeleteBehaviorAttribute> on one of the navigations of the relationship. For example:
+
+<!--
+        public class Blog
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; }
+
+            [DeleteBehavior(DeleteBehavior.Restrict)]
+            public Blog Blog { get; init; }
+        }
+-->
+[!code-csharp[DeleteBehaviorOnDependentNavigation](../../../../samples/core/Modeling/Relationships/MappingAttributes.cs?name=DeleteBehaviorOnDependentNavigation)]
+
+See [_Cascade delete_](xref:core/saving/cascade-delete) for more information on cascading behaviors.
diff --git a/entity-framework/core/modeling/relationships/navigations.md b/entity-framework/core/modeling/relationships/navigations.md
new file mode 100644
index 0000000000..e39cb9b6f7
--- /dev/null
+++ b/entity-framework/core/modeling/relationships/navigations.md
@@ -0,0 +1,182 @@
+---
+title: Relationship navigations - EF Core
+description: Reference and collection navigations in Entity Framework Core
+author: SamMonoRT
+ms.date: 03/30/2023
+uid: core/modeling/relationships/navigations
+---
+# Relationship navigations
+
+EF Core relationships are defined by [foreign keys](xref:core/modeling/relationships/foreign-and-principal-keys). Navigations are layered over foreign keys to provide a natural, object-oriented view for reading and manipulating relationships. By using navigations, applications can work with graphs of entities without being concerned with what is happening to the foreign key values.
+
+> [!IMPORTANT]
+> Multiple relationships cannot share navigations. Any foreign key can be associated with at most one navigation from principal to dependent, and at most one navigation from dependent to principal.
+
+> [!TIP]
+> There is no need to make navigations virtual unless they are being used by [lazy-loading](xref:core/querying/related-data/lazy) or [change-tracking](xref:core/change-tracking/change-detection#change-tracking-proxies) proxies.
+
+## Reference navigations
+
+Navigations come in two forms--reference and collection. Reference navigations are simple object references to another entity. They represent the "one" side(s) of [one-to-many](xref:core/modeling/relationships/one-to-many) and [one-to-one](xref:core/modeling/relationships/one-to-one) relationships. For example:
+
+```csharp
+public Blog TheBlog { get; set; }
+```
+
+Reference navigations must have a setter, although it does not need to be public. Reference navigations should not be automatically initialized to a non-null default value; doing so is equivalent to asserting that an entity exists when it does not.
+
+When using [C# nullable reference types](/dotnet/csharp/tutorials/nullable-reference-types), reference navigations must be nullable for optional relationships:
+
+```csharp
+public Blog? TheBlog { get; set; }
+```
+
+Reference navigations for required relationships can be nullable or non-nullable.
+
+## Collection navigations
+
+Collection navigations are instances of a .NET collection type; that is, any type implementing <xref:System.Collections.Generic.ICollection`1>. The collection contains instances of the related entity type, of which there can be any number. They represent the "many" side(s) of [one-to-many](xref:core/modeling/relationships/one-to-many) and [many-to-many](xref:core/modeling/relationships/many-to-many) relationships. For example:
+
+```csharp
+public ICollection<Post> ThePosts { get; set; }
+```
+
+Collection navigations do not need to have a setter. It is common to initialize the collection inline, thereby removing the need to ever check if the property is `null`. For example:
+
+```csharp
+public ICollection<Post> ThePosts { get; } = new List<Post>();
+```
+
+> [!TIP]
+> Don't accidentally create an expression bodied property, such as `public ICollection<Post> ThePosts => new List<Post>();`. This will create a new, empty collection instance each time the property is accessed, and will therefore be useless as a navigation.
+
+### Collection types
+
+The underlying collection instance must implement <xref:System.Collections.Generic.ICollection`1>, and must have a working `Add` method. It is common to use <xref:System.Collections.Generic.List`1> or <xref:System.Collections.Generic.HashSet`1>. `List<T>` is efficient for small numbers of related entities and maintains a stable ordering. `HashSet<T>` has more efficient lookups for large numbers of entities, but does not have stable ordering. You can also use your own custom collection implementation.
+
+> [!IMPORTANT]
+> The collection must use reference equality. When creating a `HashSet<T>` for a collection navigation, make sure to use <xref:System.Collections.Generic.ReferenceEqualityComparer>.
+
+Arrays cannot be used for collection navigations because, even though they implement `ICollection<T>`, the `Add` method throws an exception when called.
+
+Even though the collection instance must be an `ICollection<T>`, the collection does not need to be exposed as such. For example, it is common to expose the navigation as an <xref:System.Collections.Generic.IEnumerable`1>, which provides a read-only view that cannot be randomly modified by application code. For example:
+
+```csharp
+public class Blog
+{
+    public int Id { get; set; }
+    public IEnumerable<Post> ThePosts { get; } = new List<Post>();
+}
+```
+
+A variation on this pattern includes methods for manipulation of the collection as needed. For example:
+
+```csharp
+public class Blog
+{
+    private readonly List<Post> _posts = new();
+
+    public int Id { get; set; }
+
+    public IEnumerable<Post> Posts => _posts;
+
+    public void AddPost(Post post) => _posts.Add(post);
+}
+```
+
+Application code could still cast the exposed collection to an `ICollection<T>` and then manipulate it. If this is a concern, then the entity could return a defensive copy of the collection. For example:
+
+```csharp
+public class Blog
+{
+    private readonly List<Post> _posts = new();
+
+    public int Id { get; set; }
+
+    public IEnumerable<Post> Posts => _posts.ToList();
+
+    public void AddPost(Post post) => _posts.Add(post);
+}
+```
+
+Carefully consider whether the value gained from this is high enough that it outweighs the overhead of creating a copy of the collection every time the navigation is accessed.
+
+> [!TIP]
+> This final pattern works because, by-default, EF accesses the collection through its backing field. This means that EF itself adds and removes entities from the actual collection, while applications only interact with a defensive copy of the collection.
+
+### Initialization of collection navigations
+
+Collection navigations can be initialized by the entity type, either eagerly:
+
+```csharp
+public class Blog
+{
+    public ICollection<Post> Posts { get; } = new List<Post>();
+}
+```
+
+Or lazily:
+
+```csharp
+public class Blog
+{
+    private ICollection<Post>? _posts;
+
+    public ICollection<Post> Posts => _posts ??= new List<Post>();
+}
+```
+
+If EF needs to add an entity to a collection navigation, for example, while executing a query, then it will initialize the collection if it is currently `null`. The instance created depends on the exposed type of the navigation.
+
+- If the navigation is exposed as a `HashSet<T>`, then an instance of `HashSet<T>` using <xref:System.Collections.Generic.ReferenceEqualityComparer> is created.
+- Otherwise, if the navigation is exposed as a concrete type with a parameterless constructor, then an instance of that concrete type is created. This applies to `List<T>`, but also to other collection types, including custom collection types.
+- Otherwise, if the navigation is exposed as an `IEnumerable<T>`, an `ICollection<T>`, or an `ISet<T>`, then an instance of `HashSet<T>` using `ReferenceEqualityComparer` is created.
+- Otherwise, if the navigation is exposed as an `IList<T>`, then an instance of `List<T>` is created.
+- Otherwise, an exception is thrown.
+
+> [!NOTE]
+> If [notification entities](xref:core/change-tracking/change-detection#notification-entities), including [change-tracking proxies](xref:core/change-tracking/change-detection#change-tracking-proxies), are being used, then <xref:System.Collections.ObjectModel.ObservableCollection`1> and <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ObservableHashSet`1> are used in place of `List<T>` and `HashSet<T>`.
+
+> [!IMPORTANT]
+> As described in the [change tracking documentation](xref:core/change-tracking/identity-resolution), EF only tracks a single instance of any entity with a given key value. This means that collections used as navigations must use [reference equality semantics](/dotnet/csharp/language-reference/operators/equality-operators). Entity types that don't override object equality will get this by default. Make sure to use <xref:System.Collections.Generic.ReferenceEqualityComparer> when creating a `HashSet<T>` for use as a navigation to ensure it works for all entity types.
+
+## Configuring navigations
+
+Navigations are included in the model as part of configuring a relationship. That is, by [convention](xref:core/modeling/relationships/conventions), or using `HasOne`, `HasMany`, etc. in the model building API. Most configuration associated with navigations is done by configuring the relationship itself.
+
+However, there are some types of configuration which are specific to the navigation properties themselves, rather than being part of the overall relationship configuration. This type of configuration is done with the `Navigation` method. For example, to force EF to access the navigation through its property, rather than using the backing field:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Blog>()
+        .Navigation(e => e.Posts)
+        .UsePropertyAccessMode(PropertyAccessMode.Property);
+
+    modelBuilder.Entity<Post>()
+        .Navigation(e => e.Blog)
+        .UsePropertyAccessMode(PropertyAccessMode.Property);
+}
+```
+
+> [!NOTE]
+> The `Navigation` call cannot be used to create a navigation property. It is only used to configure a navigation property which has been previously created by defining a relationship or from a convention.
+
+### Required navigations
+
+A navigation from dependent to principal is required if the relationship is required, which in turn means that the foreign key property is non-nullable. Conversely, the navigation is optional if the foreign key is nullable, and the relationship is therefore optional.
+
+Reference navigations from principal to dependent are different. In most cases, a principal entity can _always_ exist without any dependent entities. That is, a required relationship does _not_ indicate that there will always be at least one dependent entity. There is no way in the EF model, and also no standard way in a relational database, to ensure that a principal is associated with a certain number of dependents. If this is needed, then it must be implemented in application (business) logic.
+
+There is one exception to this rule--when the principal and dependent types are sharing the same table in a relational database, or contained in a document. This can happen with [owned types](xref:core/modeling/owned-entities), or non-owned types [sharing the same table](xref:core/modeling/table-splitting). In this case, the navigation property from the principal to the dependent can be marked as required, indicating that the dependent must exist.
+
+Configuration of the navigation property as required is done using the `Navigation` method. For example:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Blog>()
+        .Navigation(e => e.BlogHeader)
+        .IsRequired();
+}
+```
diff --git a/entity-framework/core/modeling/relationships/one-to-many.md b/entity-framework/core/modeling/relationships/one-to-many.md
new file mode 100644
index 0000000000..dbf71b765c
--- /dev/null
+++ b/entity-framework/core/modeling/relationships/one-to-many.md
@@ -0,0 +1,586 @@
+---
+title: One-to-many relationships - EF Core
+description: How to configure one-to-many relationships between entity types when using Entity Framework Core
+author: SamMonoRT
+ms.date: 03/30/2023
+uid: core/modeling/relationships/one-to-many
+---
+# One-to-many relationships
+
+One-to-many relationships are used when a single entity is associated with any number of other entities. For example, a `Blog` can have many associated `Posts`, but each `Post` is associated with only one `Blog`.
+
+This document is structured around lots of examples. The examples start with common cases, which also introduce concepts. Later examples cover less common kinds of configuration. A good approach here is to understand the first few examples and concepts, and then go to the later examples based on your specific needs. Based on this approach, we will start with simple "required" and "optional" one-to-many relationships.
+
+> [!TIP]
+> The code for all the examples below can be found in [OneToMany.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Modeling/Relationships/OneToMany.cs).
+
+## Required one-to-many
+
+<!--
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>();  // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; }                              // Required foreign key property
+            public Blog Blog { get; set; } = null!;                      // Required reference navigation to principal
+        }
+-->
+[!code-csharp[OneToManyRequired](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyRequired)]
+
+A one-to-many relationship is made up from:
+
+- One or more [primary or alternate key](xref:core/modeling/relationships/foreign-and-principal-keys#principal-keys) properties on the principal entity; that is the "one" end of the relationship. For example, `Blog.Id`.
+- One or more [foreign key](xref:core/modeling/relationships/foreign-and-principal-keys#foreign-keys) properties on the dependent entity; that is the "many" end of the relationship. For example, `Post.BlogId`.
+- Optionally, a [collection navigation](xref:core/modeling/relationships/navigations#collection-navigations) on the principal entity referencing the dependent entities. For example, `Blog.Posts`.
+- Optionally, a [reference navigation](xref:core/modeling/relationships/navigations#reference-navigations) on the dependent entity referencing the principal entity. For example, `Post.Blog`.
+
+So, for the relationship in this example:
+
+- The foreign key property `Post.BlogId` is not nullable. This makes the relationship "required" because every dependent (`Post`) _must be related to some principal_ (`Blog`), since its foreign key property must be set to some value.
+- Both entities have navigations pointing to the related entity or entities on the other side of the relationship.
+
+> [!NOTE]
+> A required relationship ensures that every dependent entity must be associated with some principal entity. However, a principal entity can _always_ exist without any dependent entities. That is, a required relationship does _not_ indicate that there will always be at least one dependent entity. There is no way in the EF model, and also no standard way in a relational database, to ensure that a principal is associated with a certain number of dependents. If this is needed, then it must be implemented in application (business) logic. See [_Required navigations_](xref:core/modeling/relationships/navigations#required-navigations) for more information.
+
+> [!TIP]
+> A relationship with two navigations, one from dependent to principal, and an inverse from principal to dependents, is known as a bidirectional relationship.
+
+This relationship is [discovered by convention](xref:core/modeling/relationships/conventions). That is:
+
+- `Blog` is discovered as the principal in the relationship, and `Post` is discovered as the dependent.
+- `Post.BlogId` is discovered as a foreign key of the dependent referencing the `Blog.Id` primary key of the principal. The relationship is discovered as required because `Post.BlogId` is not nullable.
+- `Blog.Posts` is discovered as the collection navigation.
+- `Post.Blog` is discovered as the reference navigation.
+
+> [!IMPORTANT]
+> When using [C# nullable reference types](/dotnet/csharp/tutorials/nullable-reference-types), the reference navigation must be nullable if the foreign key property is nullable. If the foreign key property is non-nullable, then the reference navigation may be nullable or not. In this case, `Post.BlogId` is non-nullable and `Post.Blog` is also non-nullable. The `= null!;` construct is used to mark this as intentional for the C# compiler, since EF typically sets the `Blog` instance and it cannot be null for a fully loaded relationship. See [_Working with Nullable Reference Types_](xref:core/miscellaneous/nullable-reference-types) for more information.
+
+For cases where the navigations, foreign key, or required/optional nature of the relationship are not discovered by convention, these things can be configured explicitly. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired();
+            }
+-->
+[!code-csharp[OneToManyRequiredFromPrincipal](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyRequiredFromPrincipal)]
+
+In the example above, configuration of the relationships starts with `HasMany` on the principal entity type (`Blog`) and then follows this with `WithOne`. As with all relationships, it is exactly equivalent to start with dependent entity type (`Post`) and use `HasOne` followed by `WithMany`. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasOne(e => e.Blog)
+                    .WithMany(e => e.Posts)
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired();
+            }
+-->
+[!code-csharp[OneToManyRequiredFromDependent](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyRequiredFromDependent)]
+
+Neither of these options is better than the other; they both result in exactly the same configuration.
+
+> [!TIP]
+> It is never necessary to configure a relationship twice, once starting from the principal, and then again starting from the dependent. Also, attempting to configure the principal and dependent halves of a relationship separately generally does not work. Choose to configure each relationship from either one end or the other and then write the configuration code only once.
+
+## Optional one-to-many
+
+<!--
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>(); // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public int? BlogId { get; set; } // Optional foreign key property
+            public Blog? Blog { get; set; } // Optional reference navigation to principal
+        }
+-->
+[!code-csharp[OneToManyOptional](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyOptional)]
+
+This is the same as the previous example, except that the foreign key property and navigation to the principal are now nullable. This makes the relationship "optional" because a dependent (`Post`) can exist _without_ being related to any principal (`Blog`).
+
+> [!IMPORTANT]
+> When using [C# nullable reference types](/dotnet/csharp/tutorials/nullable-reference-types), the reference navigation must be nullable if the foreign key property is nullable. In this case, `Post.BlogId` is nullable, so `Post.Blog` must be nullable too. See [_Working with Nullable Reference Types_](xref:core/miscellaneous/nullable-reference-types) for more information.
+
+As before, this relationship is [discovered by convention](xref:core/modeling/relationships/conventions). For cases where the navigations, foreign key, or required/optional nature of the relationship are not discovered by convention, these things can be configured explicitly. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired(false);
+            }
+-->
+[!code-csharp[OneToManyOptionalFromPrincipal](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyOptionalFromPrincipal)]
+
+## Required one-to-many with shadow foreign key
+
+<!--
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>();  // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public Blog Blog { get; set; }                               // Required reference navigation to principal
+        }
+-->
+[!code-csharp[OneToManyRequiredShadow](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyRequiredShadow)]
+
+In some cases, you may not want a foreign key property in your model, since foreign keys are a detail of how the relationship is represented in the database, which is not needed when using the relationship in a purely object-oriented manner. However, if entities are going to be serialized, for example to send over a wire, then the foreign key values can be a useful way to keep the relationship information intact when the entities are not in an object form. It is therefore often pragmatic to keep foreign key properties in the .NET type for this purpose. Foreign key properties can be private, which is often a good compromise to avoid exposing the foreign key while allowing its value to travel with the entity.
+
+Following on from the previous two examples, this example removes the foreign key property from the dependent entity type. EF therefore creates a [shadow foreign key property](xref:core/modeling/shadow-properties) called `BlogId` of type `int`.
+
+An important point to note here is that [C# nullable reference types](/dotnet/csharp/tutorials/nullable-reference-types) are being used, so the nullability of the reference navigation is used to determine whether or not the foreign key property is nullable, and therefore whether the relationship is optional or required. If nullable reference types are not being used, then the shadow foreign key property will be nullable by default, making the relationship optional by default. In this case, use `IsRequired` to force the shadow foreign key property to be non-nullable and make the relationship required.
+
+As before, this relationship is [discovered by convention](xref:core/modeling/relationships/conventions). For cases where the navigations, foreign key, or required/optional nature of the relationship are not discovered by convention, these things can be configured explicitly. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey("BlogId")
+                    .IsRequired();
+            }
+-->
+[!code-csharp[OneToManyRequiredShadowFromPrincipal](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyRequiredShadowFromPrincipal)]
+
+## Optional one-to-many with shadow foreign key
+
+<!--
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>();  // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public Blog? Blog { get; set; }                              // Optional reference navigation to principal
+        }
+-->
+[!code-csharp[OneToManyOptionalShadow](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyOptionalShadow)]
+
+Like the previous example, the foreign key property has been removed from the dependent entity type. EF therefore creates a [shadow foreign key property](xref:core/modeling/shadow-properties) called `BlogId` of type `int?`. Unlike the previous example, this time the foreign key property is created as nullable because [C# nullable reference types](/dotnet/csharp/tutorials/nullable-reference-types) are being used and the navigation on the dependent entity type is nullable. This makes the relationship optional.
+
+When C# nullable reference types are not being used, then the foreign key property will also, by default, be created as nullable. This means relationships with automatically created shadow properties are optional by default.
+
+As before, this relationship is [discovered by convention](xref:core/modeling/relationships/conventions). For cases where the navigations, foreign key, or required/optional nature of the relationship are not discovered by convention, these things can be configured explicitly. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey("BlogId")
+                    .IsRequired(false);
+            }
+-->
+[!code-csharp[OneToManyOptionalShadowFromPrincipal](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyOptionalShadowFromPrincipal)]
+
+## One-to-many without navigation to principal
+
+<!--
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>();  // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; }                              // Required foreign key property
+        }
+-->
+[!code-csharp[OneToManyRequiredNoNavigationToPrincipal](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyRequiredNoNavigationToPrincipal)]
+
+For this example, the foreign key property has been re-introduced, but the navigation on the dependent has been removed.
+
+> [!TIP]
+> A relationship with only one navigation, one from dependent to principal or one from principal to dependent(s), but not both, is known as a unidirectional relationship.
+
+As before, this relationship is [discovered by convention](xref:core/modeling/relationships/conventions). For cases where the navigations, foreign key, or required/optional nature of the relationship are not discovered by convention, these things can be configured explicitly. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne()
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired();
+            }
+-->
+[!code-csharp[OneToManyRequiredFromPrincipalNoNavigationToPrincipal](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyRequiredFromPrincipalNoNavigationToPrincipal)]
+
+Notice that the call to `WithOne` has no arguments. This is the way to tell EF that there is no navigation from `Post` to `Blog`.
+
+If configuration starts from the entity with no navigation, then the type of the entity on the other end of the relationship must be explicitly specified using the generic `HasOne<>()` call. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasOne<Blog>()
+                    .WithMany(e => e.Posts)
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired();
+            }
+-->
+[!code-csharp[OneToManyRequiredFromDependentNoNavigationToPrincipal](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyRequiredFromDependentNoNavigationToPrincipal)]
+
+## One-to-many without navigation to principal and with shadow foreign key
+
+<!--
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>();  // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+        }
+-->
+[!code-csharp[OneToManyRequiredShadowNoNavigationToPrincipal](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyRequiredShadowNoNavigationToPrincipal)]
+
+This example combines two of the previous examples by removing both the foreign key property and the navigation on the dependent.
+
+This relationship is [discovered by convention](xref:core/modeling/relationships/conventions) as an optional relationship. Since there is nothing in the code that could be used to indicate that it should be required, some minimal configuration using `IsRequired` is needed to create a required relationship. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne()
+                    .IsRequired();
+            }
+-->
+[!code-csharp[OneToManyRequiredShadowNoNavigationToPrincipalConfig](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyRequiredShadowNoNavigationToPrincipalConfig)]
+
+A more complete configuration can be used to explicitly configure the navigation and foreign key name, with an appropriate call to `IsRequired()` or `IsRequired(false)` as needed. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne()
+                    .HasForeignKey("BlogId")
+                    .IsRequired();
+            }
+-->
+[!code-csharp[OneToManyRequiredShadowFromPrincipalNoNavigationToPrincipal](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyRequiredShadowFromPrincipalNoNavigationToPrincipal)]
+
+## One-to-many without navigation to dependents
+
+<!--
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; }                              // Required foreign key property
+            public Blog Blog { get; set; } = null!;                      // Required reference navigation to principal
+        }
+-->
+[!code-csharp[OneToManyRequiredNoNavigationToDependents](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyRequiredNoNavigationToDependents)]
+
+The previous two examples had navigations from the principal to dependents, but no navigation from the dependent to principal. For the next couple of examples, the navigation on the dependent is re-introduced, while the navigation on the principal is removed instead.
+
+As before, this relationship is [discovered by convention](xref:core/modeling/relationships/conventions). For cases where the navigations, foreign key, or required/optional nature of the relationship are not discovered by convention, these things can be configured explicitly. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasOne(e => e.Blog)
+                    .WithMany()
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired();
+            }
+-->
+[!code-csharp[OneToManyRequiredFromDependentNoNavigationToDependents](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyRequiredFromDependentNoNavigationToDependents)]
+
+Notice again that `WithMany()` is called with no arguments to indicate that there is no navigation in this direction.
+
+If configuration starts from the entity with no navigation, then the type of the entity on the other end of the relationship must be explicitly specified using the generic `HasMany<>()` call. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany<Post>()
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired();
+            }
+-->
+[!code-csharp[OneToManyRequiredFromPrincipalNoNavigationToDependents](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyRequiredFromPrincipalNoNavigationToDependents)]
+
+## One-to-many with no navigations
+
+Occasionally, it can be useful to configure a relationship with no navigations. Such a relationship can only be manipulated by changing the foreign key value directly.
+
+<!--
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; } // Required foreign key property
+        }
+-->
+[!code-csharp[OneToManyRequiredNoNavigations](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyRequiredNoNavigations)]
+
+This relationship is not discovered by convention, since there are no navigations indicating that the two types are related. It can be configured explicitly in `OnModelCreating`. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany<Post>()
+                    .WithOne();
+            }
+-->
+[!code-csharp[OneToManyRequiredNoNavigationsConfig](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyRequiredNoNavigationsConfig)]
+
+With this configuration, the `Post.BlogId` property is still detected as the foreign key by convention, and the relationship is required because the foreign key property is not nullable. The relationship can be made "optional" by making the foreign key property nullable.
+
+A more complete explicit configuration of this relationship is::
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany<Post>()
+                    .WithOne()
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired();
+            }
+-->
+[!code-csharp[OneToManyRequiredFromPrincipalNoNavigations](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyRequiredFromPrincipalNoNavigations)]
+
+## One-to-many with alternate key
+
+In all the examples so far, the foreign key property on the dependent is constrained to the primary key property on the principal. The foreign key can instead be constrained to a different property, which then becomes an alternate key for the principal entity type. For example:
+
+<!--
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public int AlternateId { get; set; }                         // Alternate key as target of the Post.BlogId foreign key
+            public ICollection<Post> Posts { get; } = new List<Post>();  // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; }                              // Required foreign key property
+            public Blog Blog { get; set; } = null!;                      // Required reference navigation to principal
+        }
+-->
+[!code-csharp[OneToManyRequiredWithAlternateKey](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyRequiredWithAlternateKey)]
+
+This relationship is not discovered by convention, since EF will always, by convention, create a relationship to the primary key. It can be configured explicitly in `OnModelCreating` using a call to `HasPrincipalKey`. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey(e => e.AlternateId);
+            }
+-->
+[!code-csharp[OneToManyRequiredWithAlternateKeyConfig](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyRequiredWithAlternateKeyConfig)]
+
+`HasPrincipalKey` can be combined with other calls to explicitly configure the navigations, foreign key properties, and required/optional nature. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey(e => e.AlternateId)
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired();
+            }
+-->
+[!code-csharp[OneToManyRequiredFromPrincipalWithAlternateKey](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyRequiredFromPrincipalWithAlternateKey)]
+
+## One-to-many with composite foreign key
+
+In all the examples so far, the primary or alternate key property of the principal consisted of a single property. Primary or alternate keys can also be formed from more than one property--these are known as ["composite keys"](xref:core/modeling/keys). When the principal of a relationship has a composite key, then the foreign key of the dependent must also be a composite key with the same number of properties. For example:
+
+<!--
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id1 { get; set; }                                 // Composite key part 1
+            public int Id2 { get; set; }                                 // Composite key part 2
+            public ICollection<Post> Posts { get; } = new List<Post>();  // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public int BlogId1 { get; set; }                             // Required foreign key property part 1
+            public int BlogId2 { get; set; }                             // Required foreign key property part 2
+            public Blog Blog { get; set; } = null!;                      // Required reference navigation to principal
+        }
+-->
+[!code-csharp[OneToManyRequiredWithCompositeKey](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyRequiredWithCompositeKey)]
+
+This relationship is discovered by convention. However, the composite key itself needs to be configured explicitly::
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasKey(e => new { e.Id1, e.Id2 });
+            }
+-->
+[!code-csharp[OneToManyRequiredWithCompositeKeyConfig](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyRequiredWithCompositeKeyConfig)]
+
+> [!IMPORTANT]
+> A composite foreign key value is considered to be `null` if any of its property values are null. A composite foreign key with one property null and another non-null will not be considered a match for a primary or alternate key with the same values. Both will be considered `null`.
+
+Both `HasForeignKey` and `HasPrincipalKey` can be used to explicitly specify keys with multiple properties. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>(
+                    nestedBuilder =>
+                    {
+                        nestedBuilder.HasKey(e => new { e.Id1, e.Id2 });
+
+                        nestedBuilder.HasMany(e => e.Posts)
+                            .WithOne(e => e.Blog)
+                            .HasPrincipalKey(e => new { e.Id1, e.Id2 })
+                            .HasForeignKey(e => new { e.BlogId1, e.BlogId2 })
+                            .IsRequired();
+                    });
+            }
+-->
+[!code-csharp[OneToManyRequiredFromPrincipalWithCompositeKey](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=OneToManyRequiredFromPrincipalWithCompositeKey)]
+
+> [!TIP]
+> In the code above, the calls to `HasKey` and `HasMany` have been grouped together into a nested builder. Nested builders remove the need to call `Entity<>()` multiple times for the same entity type, but are functionally equivalent to calling `Entity<>()` multiple times.
+
+## Required one-to-many without cascade delete
+
+<!--
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>();  // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; }                              // Required foreign key property
+            public Blog Blog { get; set; } = null!;                      // Required reference navigation to principal
+        }
+-->
+[!code-csharp[RequiredWithoutCascadeDelete](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=RequiredWithoutCascadeDelete)]
+
+By convention, required relationships are configured to [cascade delete](xref:core/saving/cascade-delete); this means that when the principal is deleted, all of its dependents are deleted as well, since dependents cannot exist in the database without a principal. It's possible to configure EF to throw an exception instead of automatically deleting dependent rows that can no longer exist:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .OnDelete(DeleteBehavior.Restrict);
+            }
+-->
+[!code-csharp[RequiredWithoutCascadeDeleteConfig](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=RequiredWithoutCascadeDeleteConfig)]
+
+## Self-referencing one-to-many
+
+In all the previous examples, the principal entity type was different from the dependent entity type. This does not have to be the case. For example, in the types below, each `Employee` is related to other `Employees`.
+
+<!--
+        public class Employee
+        {
+            public int Id { get; set; }
+
+            public int? ManagerId { get; set; }                                    // Optional foreign key property
+            public Employee? Manager { get; set; }                                 // Optional reference navigation to principal
+            public ICollection<Employee> Reports { get; } = new List<Employee>();  // Collection navigation containing dependents
+        }
+-->
+[!code-csharp[SelfReferencing](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=SelfReferencing)]
+
+This relationship is [discovered by convention](xref:core/modeling/relationships/conventions). For cases where the navigations, foreign key, or required/optional nature of the relationship are not discovered by convention, these things can be configured explicitly. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Employee>()
+                    .HasOne(e => e.Manager)
+                    .WithMany(e => e.Reports)
+                    .HasForeignKey(e => e.ManagerId)
+                    .IsRequired(false);
+            }
+-->
+[!code-csharp[SelfReferencingConfig](../../../../samples/core/Modeling/Relationships/OneToMany.cs?name=SelfReferencingConfig)]
diff --git a/entity-framework/core/modeling/relationships/one-to-one.md b/entity-framework/core/modeling/relationships/one-to-one.md
new file mode 100644
index 0000000000..cea32d217b
--- /dev/null
+++ b/entity-framework/core/modeling/relationships/one-to-one.md
@@ -0,0 +1,686 @@
+---
+title: One-to-one relationships - EF Core
+description: How to configure one-to-one relationships between entity types when using Entity Framework Core
+author: SamMonoRT
+ms.date: 03/30/2023
+uid: core/modeling/relationships/one-to-one
+---
+# One-to-one relationships
+
+One-to-one relationships are used when one entity is associated with at most one other entity. For example, a `Blog` has one `BlogHeader`, and that `BlogHeader` belongs to a single `Blog`.
+
+This document is structured around lots of examples. The examples start with common cases, which also introduce concepts. Later examples cover less common kinds of configuration. A good approach here is to understand the first few examples and concepts, and then go to the later examples based on your specific needs. Based on this approach, we will start with simple "required" and "optional" one-to-one relationships.
+
+> [!TIP]
+> The code for all the examples below can be found in [OneToOne.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Modeling/Relationships/OneToOne.cs).
+
+## Required one-to-one
+
+<!--
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public BlogHeader? Header { get; set; }                            // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; }                                    // Required foreign key property
+            public Blog Blog { get; set; } = null!;                            // Required reference navigation to principal
+        }
+-->
+[!code-csharp[OneToOneRequired](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequired)]
+
+A one-to-one relationship is made up from:
+
+- One or more [primary or alternate key](xref:core/modeling/relationships/foreign-and-principal-keys#principal-keys) properties on the principal entity. For example, `Blog.Id`.
+- One or more [foreign key](xref:core/modeling/relationships/foreign-and-principal-keys#foreign-keys) properties on the dependent entity. For example, `BlogHeader.BlogId`.
+- Optionally, a [reference navigation](xref:core/modeling/relationships/navigations#reference-navigations) on the principal entity referencing the dependent entity. For example, `Blog.Header`.
+- Optionally, a [reference navigation](xref:core/modeling/relationships/navigations#reference-navigations) on the dependent entity referencing the principal entity. For example, `BlogHeader.Blog`.
+
+> [!TIP]
+> It is not always obvious which side of a one-to-one relationship should be the principal, and which side should be the dependent. Some considerations are:
+>
+> - If the database tables for the two types already exist, then the table with the foreign key column(s) must map to the dependent type.
+> - A type is usually the dependent type if it cannot logically exist without the other type. For example, it makes no sense to have a header for a blog that does not exist, so `BlogHeader` is naturally the dependent type.
+> - If there is a natural parent/child relationship, then the child is usually the dependent type.
+
+So, for the relationship in this example:
+
+- The foreign key property `BlogHeader.BlogId` is not nullable. This makes the relationship "required" because every dependent (`BlogHeader`) _must be related to some principal_ (`Blog`), since its foreign key property must be set to some value.
+- Both entities have navigations pointing to the related entity on the other side of the relationship.
+
+> [!NOTE]
+> A required relationship ensures that every dependent entity must be associated with some principal entity. However, a principal entity can _always_ exist without any dependent entity. That is, a required relationship does _not_ indicate that there will always be a dependent entity. There is no way in the EF model, and also no standard way in a relational database, to ensure that a principal is associated with a dependent. If this is needed, then it must be implemented in application (business) logic. See [_Required navigations_](xref:core/modeling/relationships/navigations#required-navigations) for more information.
+
+> [!TIP]
+> A relationship with two navigations--one from dependent to principal and an inverse from principal to dependent--is known as a bidirectional relationship.
+
+This relationship is [discovered by convention](xref:core/modeling/relationships/conventions). That is:
+
+- `Blog` is discovered as the principal in the relationship, and `BlogHeader` is discovered as the dependent.
+- `BlogHeader.BlogId` is discovered as a foreign key of the dependent referencing the `Blog.Id` primary key of the principal. The relationship is discovered as required because `BlogHeader.BlogId` is not nullable.
+- `Blog.BlogHeader` is discovered as a reference navigation.
+- `BlogHeader.Blog` is discovered as a reference navigation.
+
+> [!IMPORTANT]
+> When using [C# nullable reference types](/dotnet/csharp/tutorials/nullable-reference-types), the navigation from the dependent to the principal must be nullable if the foreign key property is nullable. If the foreign key property is non-nullable, then the navigation may be nullable or not. In this case, `BlogHeader.BlogId` is non-nullable, and `BlogHeader.Blog` is also non-nullable. The `= null!;` construct is used to mark this as intentional for the C# compiler, since EF typically sets the `Blog` instance and it cannot be null for a fully loaded relationship. See [_Working with Nullable Reference Types_](xref:core/miscellaneous/nullable-reference-types) for more information.
+
+For cases where the navigations, foreign key, or required/optional nature of the relationship are not discovered by convention, these things can be configured explicitly. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired();
+            }
+-->
+[!code-csharp[OneToOneRequiredFromPrincipal](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredFromPrincipal)]
+
+In the example above, configuration of the relationships starts the principal entity type (`Blog`). As with all relationships, it is exactly equivalent to start with dependent entity type (`BlogHeader`) instead. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne(e => e.Header)
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired();
+            }
+-->
+[!code-csharp[OneToOneRequiredFromDependent](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredFromDependent)]
+
+Neither of these options is better than the other; they both result in exactly the same configuration.
+
+> [!TIP]
+> It is never necessary to configure a relationship twice, once starting from the principal, and then again starting from the dependent. Also, attempting to configure the principal and dependent halves of a relationship separately generally does not work. Choose to configure each relationship from either one end or the other and then write the configuration code only once.
+
+## Optional one-to-one
+
+<!--
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public BlogHeader? Header { get; set; }                            // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public int? BlogId { get; set; }                                   // Optional foreign key property
+            public Blog? Blog { get; set; }                                    // Optional reference navigation to principal
+        }
+-->
+[!code-csharp[OneToOneOptional](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneOptional)]
+
+This is the same as the previous example, except that the foreign key property and navigation to the principal are now nullable. This makes the relationship "optional" because a dependent (`BlogHeader`) can _not_ be related to _any_ principal (`Blog`) by setting its foreign key property and navigation to `null`.
+
+> [!IMPORTANT]
+> When using [C# nullable reference types](/dotnet/csharp/tutorials/nullable-reference-types), the navigation property from dependent to principal must be nullable if the foreign key property is nullable. In this case, `BlogHeader.BlogId` is nullable, so `BlogHeader.Blog` must be nullable too. See [_Working with Nullable Reference Types_](xref:core/miscellaneous/nullable-reference-types) for more information.
+
+As before, this relationship is [discovered by convention](xref:core/modeling/relationships/conventions). For cases where the navigations, foreign key, or required/optional nature of the relationship are not discovered by convention, these things can be configured explicitly. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired(false);
+            }
+-->
+[!code-csharp[OneToOneOptionalFromPrincipal](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneOptionalFromPrincipal)]
+
+## Required one-to-one with primary key to primary key relationship
+
+<!--
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public BlogHeader? Header { get; set; }                            // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public Blog Blog { get; set; } = null!;                            // Required reference navigation to principal
+        }
+-->
+[!code-csharp[OneToOneRequiredPkToPk](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredPkToPk)]
+
+Unlike with one-to-many relationships, the dependent end of a one-to-one relationship may use its primary key property or properties as the foreign key property or properties. This is often called a PK-to-PK relationship. This is only possible when the principal and dependent types have the same primary key types, and the resulting relationship is always required, since the primary key of the dependent cannot be nullable.
+
+Any one-to-one relationship where the foreign key is not discovered by convention must be configured to indicate the principal and dependent ends of the relationship. This is typically done with a call to `HasForeignKey`. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey<BlogHeader>();
+            }
+-->
+[!code-csharp[OneToOneRequiredPkToPkConfig](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredPkToPkConfig)]
+
+> [!TIP]
+> `HasPrincipalKey` can also be used for this purpose, but doing so is less common.
+
+When no property is specified in the call to `HasForeignKey`, and the primary key is suitable, then it is used as the foreign key. For cases where the navigations, foreign key, or required/optional nature of the relationship are not discovered by convention, these things can be configured explicitly. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey<BlogHeader>(e => e.Id)
+                    .IsRequired();
+            }
+-->
+[!code-csharp[OneToOneRequiredPkToPkFromPrincipal](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredPkToPkFromPrincipal)]
+
+## Required one-to-one with shadow foreign key
+
+<!--
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public ICollection<BlogHeader> BlogHeaders { get; } = new List<BlogHeader>();  // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public Blog Blog { get; set; }                               // Required reference navigation to principal
+        }
+-->
+[!code-csharp[OneToOneRequiredShadow](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredShadow)]
+
+In some cases, you may not want a foreign key property in your model, since foreign keys are a detail of how the relationship is represented in the database, which is not needed when using the relationship in a purely object-oriented manner. However, if entities are going to be serialized, for example to send over a wire, then the foreign key values can be a useful way to keep the relationship information intact when the entities are not in an object form. It is therefore often pragmatic to keep foreign key properties in the .NET type for this purpose. Foreign key properties can be private, which is often a good compromise to avoid exposing the foreign key while allowing its value to travel with the entity.
+
+Following on from the previous example, this example removes the foreign key property from the dependent entity type. However, instead of using the primary key, EF is instead instructed to create a [shadow foreign key property](xref:core/modeling/shadow-properties) called `BlogId` of type `int`.
+
+An important point to note here is that [C# nullable reference types](/dotnet/csharp/tutorials/nullable-reference-types) are being used, so the nullability of the navigation from dependent to principal is used to determine whether or not the foreign key property is nullable, and therefore whether the relationship is optional or required. If nullable reference types are not being used, then the shadow foreign key property will be nullable by default making the relationship optional by default. In this case, use `IsRequired` to force the shadow foreign key property to be non-nullable and make the relationship required.
+
+This relationship again needs some configuration to indicate the principal and dependent ends:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey<BlogHeader>("BlogId");
+            }
+-->
+[!code-csharp[OneToOneRequiredShadowConfig](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredShadowConfig)]
+
+For cases where the navigations, foreign key, or required/optional nature of the relationship are not discovered by convention, these things can be configured explicitly. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey<BlogHeader>("BlogId")
+                    .IsRequired();
+            }
+-->
+[!code-csharp[OneToOneRequiredShadowFromPrincipal](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredShadowFromPrincipal)]
+
+## Optional one-to-one with shadow foreign key
+
+<!--
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public BlogHeader? Header { get; set; }                            // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public Blog? Blog { get; set; }                                    // Optional reference navigation to principal
+        }
+-->
+[!code-csharp[OneToOneOptionalShadow](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneOptionalShadow)]
+
+Like the previous example, the foreign key property has been removed from the dependent entity type. However, unlike the previous example, this time the foreign key property is created as nullable because [C# nullable reference types](/dotnet/csharp/tutorials/nullable-reference-types) are being used and the navigation on the dependent entity type is nullable. This makes the relationship optional.
+
+When C# nullable reference types are not being used, then the foreign key property will, by default, be created as nullable. This means relationships with automatically created shadow properties are optional by default.
+
+As before, this relationship needs some configuration to indicate the principal and dependent ends:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey<BlogHeader>("BlogId");
+            }
+-->
+[!code-csharp[OneToOneOptionalShadowConfig](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneOptionalShadowConfig)]
+
+For cases where the navigations, foreign key, or required/optional nature of the relationship are not discovered by convention, these things can be configured explicitly. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey<BlogHeader>("BlogId")
+                    .IsRequired(false);
+            }
+-->
+[!code-csharp[OneToOneOptionalShadowFromPrincipal](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneOptionalShadowFromPrincipal)]
+
+## One-to-one without navigation to principal
+
+<!--
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public BlogHeader? Header { get; set; }                            // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; }                                    // Required foreign key property
+        }
+-->
+[!code-csharp[OneToOneRequiredNoNavigationToPrincipal](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredNoNavigationToPrincipal)]
+
+For this example, the foreign key property has been re-introduced, but the navigation on the dependent has been removed.
+
+> [!TIP]
+> A relationship with only one navigation--one from dependent to principal or one from principal to dependent, but not both--is known as a unidirectional relationship.
+
+This relationship is [discovered by convention](xref:core/modeling/relationships/conventions), since the foreign key is discovered, thereby indicating the dependent side. For cases where the navigations, foreign key, or required/optional nature of the relationship are not discovered by convention, these things can be configured explicitly. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired();
+            }
+-->
+[!code-csharp[OneToOneRequiredFromPrincipalNoNavigationToPrincipal](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredFromPrincipalNoNavigationToPrincipal)]
+
+Notice that the call to `WithOne` has no arguments. This is the way to tell EF that there is no navigation from `BlogHeader` to `Blog`.
+
+If configuration starts from the entity with no navigation, then the type of the entity on the other end of the relationship must be explicitly specified using the generic `HasOne<>()` call. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne<Blog>()
+                    .WithOne(e => e.Header)
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired();
+            }
+-->
+[!code-csharp[OneToOneRequiredFromDependentNoNavigationToPrincipal](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredFromDependentNoNavigationToPrincipal)]
+
+## One-to-one without navigation to principal and with shadow foreign key
+
+<!--
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public BlogHeader? Header { get; set; } // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+        }
+-->
+[!code-csharp[OneToOneRequiredShadowNoNavigationToPrincipal](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredShadowNoNavigationToPrincipal)]
+
+This example combines two of the previous examples by removing both the foreign key property and the navigation on the dependent.
+
+As before, this relationship needs some configuration to indicate the principal and dependent ends:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>("BlogId")
+                    .IsRequired();
+            }
+-->
+[!code-csharp[OneToOneRequiredShadowNoNavigationToPrincipalConfig](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredShadowNoNavigationToPrincipalConfig)]
+
+A more complete configuration can be used to explicitly configure the navigation and foreign key name, with an appropriate call to `IsRequired()` or `IsRequired(false)` as needed. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.BlogHeaders)
+                    .WithOne()
+                    .HasForeignKey("BlogId")
+                    .IsRequired();
+            }
+-->
+[!code-csharp[OneToOneRequiredShadowFromPrincipalNoNavigationToPrincipal](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredShadowFromPrincipalNoNavigationToPrincipal)]
+
+## One-to-one without navigation to dependent
+
+<!--
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; }           // Required foreign key property
+            public Blog Blog { get; set; } = null!;   // Required reference navigation to principal
+        }
+-->
+[!code-csharp[OneToOneRequiredNoNavigationToDependents](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredNoNavigationToDependents)]
+
+The previous two examples had navigations from the principal to dependents, but no navigation from the dependent to principal. For the next couple of examples, the navigation on the dependent is re-introduced, while the navigation on the principal is removed instead.
+
+By convention, EF will treat this as a one-to-many relationship. Some minimal configuration is needed to make it one-to-one:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne();
+            }
+-->
+[!code-csharp[OneToOneRequiredNoNavigationToDependentsConfig](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredNoNavigationToDependentsConfig)]
+
+Notice again that `WithOne()` is called with no arguments to indicate that there is no navigation in this direction.
+
+For cases where the navigations, foreign key, or required/optional nature of the relationship are not discovered by convention, these things can be configured explicitly. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired();
+            }
+-->
+[!code-csharp[OneToOneRequiredFromDependentNoNavigationToDependents](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredFromDependentNoNavigationToDependents)]
+
+If configuration starts from the entity with no navigation, then the type of the entity on the other end of the relationship must be explicitly specified using the generic `HasOne<>()` call. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne<BlogHeader>()
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired();
+            }
+-->
+[!code-csharp[OneToOneRequiredFromPrincipalNoNavigationToDependents](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredFromPrincipalNoNavigationToDependents)]
+
+## One-to-one with no navigations
+
+Occasionally, it can be useful to configure a relationship with no navigations. Such a relationship can only be manipulated by changing the foreign key value directly.
+
+<!--
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; } // Required foreign key property
+        }
+-->
+[!code-csharp[OneToOneRequiredNoNavigations](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredNoNavigations)]
+
+This relationship is not discovered by convention, since there are no navigations indicating that the two types are related. It can be configured explicitly in `OnModelCreating`. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany<BlogHeader>()
+                    .WithOne();
+            }
+-->
+[!code-csharp[OneToOneRequiredNoNavigationsConfig](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredNoNavigationsConfig)]
+
+With this configuration, the `BlogHeader.BlogId` property is still detected as the foreign key by convention, and the relationship is "required" because the foreign key property is not nullable. The relationship can be made "optional" by making the foreign key property nullable.
+
+A more complete explicit configuration of this relationship is::
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne<BlogHeader>()
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired();
+            }
+-->
+[!code-csharp[OneToOneRequiredFromPrincipalNoNavigations](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredFromPrincipalNoNavigations)]
+
+## One-to-one with alternate key
+
+In all the examples so far, the foreign key property on the dependent is constrained to the primary key property on the principal. The foreign key can instead be constrained to a different property, which then becomes an alternate key for the principal entity type. For example:
+
+<!--
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public int AlternateId { get; set; }             // Alternate key as target of the BlogHeader.BlogId foreign key
+            public BlogHeader? Header { get; set; }          // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; }                  // Required foreign key property
+            public Blog Blog { get; set; } = null!;          // Required reference navigation to principal
+        }
+-->
+[!code-csharp[OneToOneRequiredWithAlternateKey](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredWithAlternateKey)]
+
+This relationship is not discovered by convention, since EF will always, by convention, create a relationship to the primary key. It can be configured explicitly in `OnModelCreating` using a call to `HasPrincipalKey`. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey<Blog>(e => e.AlternateId);
+            }
+-->
+[!code-csharp[OneToOneRequiredWithAlternateKeyConfig](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredWithAlternateKeyConfig)]
+
+`HasPrincipalKey` can be combined with other calls to explicitly configure the navigations, foreign key properties, and required/optional nature. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey<Blog>(e => e.AlternateId)
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired();
+            }
+-->
+[!code-csharp[OneToOneRequiredFromPrincipalWithAlternateKey](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredFromPrincipalWithAlternateKey)]
+
+## One-to-one with composite foreign key
+
+In all the examples so far, the primary or alternate key property of the principal consisted of a single property. Primary or alternate keys can also be formed form more than one property--these are known as ["composite keys"](xref:core/modeling/keys). When the principal of a relationship has a composite key, then the foreign key of the dependent must also be a composite key with the same number of properties. For example:
+
+<!--
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id1 { get; set; }              // Composite key part 1
+            public int Id2 { get; set; }              // Composite key part 2
+            public BlogHeader? Header { get; set; }   // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public int BlogId1 { get; set; }          // Required foreign key property part 1
+            public int BlogId2 { get; set; }          // Required foreign key property part 2
+            public Blog Blog { get; set; } = null!;   // Required reference navigation to principal
+        }
+-->
+[!code-csharp[OneToOneRequiredWithCompositeKey](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredWithCompositeKey)]
+
+This relationship is discovered by convention. However, it will only be discovered if the composite key has been configured explicitly, since composite keys are not discovered automatically. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasKey(e => new { e.Id1, e.Id2 });
+            }
+-->
+[!code-csharp[OneToOneRequiredWithCompositeKeyConfig](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredWithCompositeKeyConfig)]
+
+> [!IMPORTANT]
+> A composite foreign key value is considered to be `null` if any of its property values are null. A composite foreign key with one property null and another non-null will not be considered a match for a primary or alternate key with the same values. Both will be considered `null`.
+
+Both `HasForeignKey` and `HasPrincipalKey` can be used to explicitly specify keys with multiple properties. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>(
+                    nestedBuilder =>
+                    {
+                        nestedBuilder.HasKey(e => new { e.Id1, e.Id2 });
+
+                        nestedBuilder.HasOne(e => e.Header)
+                            .WithOne(e => e.Blog)
+                            .HasPrincipalKey<Blog>(e => new { e.Id1, e.Id2 })
+                            .HasForeignKey<BlogHeader>(e => new { e.BlogId1, e.BlogId2 })
+                            .IsRequired();
+                    });
+            }
+-->
+[!code-csharp[OneToOneRequiredFromPrincipalWithCompositeKey](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=OneToOneRequiredFromPrincipalWithCompositeKey)]
+
+> [!TIP]
+> In the code above, the calls to `HasKey` and `HasOne` have been grouped together into a nested builder. Nested builders remove the need to call `Entity<>()` multiple times for the same entity type, but are functionally equivalent to calling `Entity<>()` multiple times.
+
+## Required one-to-one without cascade delete
+
+<!--
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public BlogHeader? Header { get; set; }                            // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; }                                    // Required foreign key property
+            public Blog Blog { get; set; } = null!;                            // Required reference navigation to principal
+        }
+-->
+[!code-csharp[RequiredWithoutCascadeDelete](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=RequiredWithoutCascadeDelete)]
+
+By convention, required relationships are configured to [cascade delete](xref:core/saving/cascade-delete). This is because the dependent cannot exist in the database once the principal has been deleted. The database can be configured to generate an error, typically crashing the application, instead of automatically deleting dependent rows that can no longer exist. This requires some configuration:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .OnDelete(DeleteBehavior.Restrict);
+            }
+-->
+[!code-csharp[RequiredWithoutCascadeDeleteConfig](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=RequiredWithoutCascadeDeleteConfig)]
+
+## Self-referencing one-to-one
+
+In all the previous examples, the principal entity type was different from the dependent entity type. This does not have to be the case. For example, in the types below, each `Person` is optionally related to another `Person`.
+
+<!--
+        public class Person
+        {
+            public int Id { get; set; }
+
+            public int? HusbandId { get; set; }      // Optional foreign key property
+            public Person? Husband { get; set; }     // Optional reference navigation to principal
+            public Person? Wife { get; set; }        // Reference navigation to dependent
+        }
+-->
+[!code-csharp[SelfReferencing](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=SelfReferencing)]
+
+This relationship is [discovered by convention](xref:core/modeling/relationships/conventions). For cases where the navigations, foreign key, or required/optional nature of the relationship are not discovered by convention, these things can be configured explicitly. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Person>()
+                    .HasOne(e => e.Husband)
+                    .WithOne(e => e.Wife)
+                    .HasForeignKey<Person>(e => e.HusbandId)
+                    .IsRequired(false);
+            }
+-->
+[!code-csharp[SelfReferencingConfig](../../../../samples/core/Modeling/Relationships/OneToOne.cs?name=SelfReferencingConfig)]
+
+> [!NOTE]
+> For one-to-one self referencing relationships, since the principal and dependent entity types are the same, specifying which type contains the foreign key does not clarify the dependent end. In this case, the navigation specified in `HasOne` points from dependent to principal, and the navigation specified in `WithOne` points from principal to dependent.
diff --git a/entity-framework/core/modeling/sequences.md b/entity-framework/core/modeling/sequences.md
new file mode 100644
index 0000000000..b4a5c193eb
--- /dev/null
+++ b/entity-framework/core/modeling/sequences.md
@@ -0,0 +1,27 @@
+---
+title: Sequences - EF Core
+description: Configuring sequences in an Entity Framework Core model
+author: roji
+ms.date: 12/18/2019
+uid: core/modeling/sequences
+---
+# Sequences
+
+> [!NOTE]
+> Sequences are a feature typically supported only by relational databases. If you're using a non-relational database such as Azure Cosmos DB, check your database documentation on generating unique values.
+
+A sequence generates unique, sequential numeric values in the database. Sequences are not associated with a specific table, and multiple tables can be set up to draw values from the same sequence.
+
+## Basic usage
+
+You can set up a sequence in the model, and then use it to generate values for properties:
+
+[!code-csharp[Main](../../../samples/core/Modeling/Sequences/Sequence.cs?name=Sequence&highlight=3,7)]
+
+Note that the specific SQL used to generate a value from a sequence is database-specific; the above example works on SQL Server but will fail on other databases. Consult your specific database's documentation for more information.
+
+## Configuring sequence settings
+
+You can also configure additional aspects of the sequence, such as its schema, start value, increment, etc.:
+
+[!code-csharp[Main](../../../samples/core/Modeling/Sequences/SequenceConfiguration.cs?name=SequenceConfiguration&highlight=3-5)]
diff --git a/entity-framework/core/modeling/shadow-properties.md b/entity-framework/core/modeling/shadow-properties.md
new file mode 100644
index 0000000000..0a8f7ff72f
--- /dev/null
+++ b/entity-framework/core/modeling/shadow-properties.md
@@ -0,0 +1,71 @@
+---
+title: Shadow and Indexer Properties - EF Core
+description: Configuring shadow and indexer properties in an Entity Framework Core model
+author: AndriySvyryd
+ms.date: 10/25/2021
+uid: core/modeling/shadow-properties
+---
+# Shadow and Indexer Properties
+
+Shadow properties are properties that aren't defined in your .NET entity class but are defined for that entity type in the EF Core model. The value and state of these properties are maintained purely in the Change Tracker. Shadow properties are useful when there's data in the database that shouldn't be exposed on the mapped entity types.
+
+Indexer properties are entity type properties, which are backed by an [indexer](/dotnet/csharp/programming-guide/indexers/) in .NET entity class. They can be accessed using the indexer on the .NET class instances. It also allows you to add additional properties to the entity type without changing the CLR class.
+
+## Foreign key shadow properties
+
+Shadow properties are most often used for foreign key properties, where they are added to the model by convention when no foreign key property has been found by convention or configured explicitly. The relationship is represented by navigation properties, but in the database it is enforced by a foreign key constraint, and the value for the foreign key column is stored in the corresponding shadow property.
+
+The property will be named `<navigation property name><principal key property name>` (the navigation on the dependent entity, which points to the principal entity, is used for the naming). If the principal key property name starts with the name of the navigation property, then the name will just be `<principal key property name>`. If there is no navigation property on the dependent entity, then the principal type name concatenated with the primary or alternate key property name is used in its place `<principal type name><principal key property name>`.
+
+For example, the following code listing will result in a `BlogId` shadow property being introduced to the `Post` entity:
+
+[!code-csharp[Main](../../../samples/core/Modeling/ShadowAndIndexerProperties/ShadowForeignKey.cs?name=Conventions&highlight=21-23)]
+
+## Configuring shadow properties
+
+You can use the [Fluent API](xref:core/modeling/index#use-fluent-api-to-configure-a-model) to configure shadow properties. Once you have called the string overload of <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.EntityTypeBuilder.Property``1(System.String)>, you can chain any of the configuration calls you would for other properties. In the following sample, since `Blog` has no CLR property named `LastUpdated`, a shadow property is created:
+
+[!code-csharp[Main](../../../samples/core/Modeling/ShadowAndIndexerProperties/ShadowProperty.cs?name=ShadowProperty&highlight=8)]
+
+If the name supplied to the `Property` method matches the name of an existing property (a shadow property or one defined on the entity class), then the code will configure that existing property rather than introducing a new shadow property.
+
+## Accessing shadow properties
+
+Shadow property values can be obtained and changed through the `ChangeTracker` API:
+
+```csharp
+context.Entry(myBlog).Property("LastUpdated").CurrentValue = DateTime.Now;
+```
+
+Shadow properties can be referenced in LINQ queries via the `EF.Property` static method:
+
+```csharp
+var blogs = context.Blogs
+    .OrderBy(b => EF.Property<DateTime>(b, "LastUpdated"));
+```
+
+Shadow properties cannot be accessed after a no-tracking query since the entities returned are not tracked by the change tracker.
+
+## Configuring indexer properties
+
+You can use the Fluent API to configure indexer properties. Once you've called the method `IndexerProperty`, you can chain any of the configuration calls you would for other properties. In the following sample, `Blog` has an indexer defined and it will be used to create an indexer property.
+
+[!code-csharp[Main](../../../samples/core/Modeling/ShadowAndIndexerProperties/IndexerProperty.cs?name=IndexerProperty&highlight=7)]
+
+If the name supplied to the `IndexerProperty` method matches the name of an existing indexer property, then the code will configure that existing property. If the entity type has a property, which is backed by a property on the entity class, then an exception is thrown since indexer properties must only be accessed via the indexer.
+
+Indexer properties can be referenced in LINQ queries via the `EF.Property` static method as shown above or by using the CLR indexer property.
+
+## Property bag entity types
+
+Entity types that contain only indexer properties are known as property bag entity types. These entity types don't have shadow properties, and EF creates indexer properties instead. Currently only `Dictionary<string, object>` is supported as a property bag entity type. It must be configured as a [shared-type entity type](xref:core/modeling/entity-types#shared-type-entity-types) with a unique name and the corresponding `DbSet` property must be implemented using a `Set` call.
+
+[!code-csharp[Main](../../../samples/core/Modeling/ShadowAndIndexerProperties/SharedType.cs?name=SharedType&highlight=3,7)]
+
+Property bag entity types can be used wherever a normal entity type is used, including as an owned entity type. However, they do have certain limitations:
+
+- They can't have shadow properties.
+- [Indexer navigations aren't supported](https://github.com/dotnet/efcore/issues/13729)
+- [Inheritance isn't supported](https://github.com/dotnet/efcore/issues/9630)
+- [Some relationship model-building API lack overloads for shared-type entity types](https://github.com/dotnet/efcore/issues/23255)
+- [Other types can't be marked as property bags](https://github.com/dotnet/efcore/issues/22009)
diff --git a/entity-framework/core/modeling/spatial.md b/entity-framework/core/modeling/spatial.md
new file mode 100644
index 0000000000..a8a484e7e4
--- /dev/null
+++ b/entity-framework/core/modeling/spatial.md
@@ -0,0 +1,109 @@
+---
+title: Spatial Data - EF Core
+description: Using spatial data in an Entity Framework Core model
+author: SamMonoRT
+ms.date: 11/15/2021
+uid: core/modeling/spatial
+---
+# Spatial Data
+
+Spatial data represents the physical location and the shape of objects. Many databases provide support for this type of data so it can be indexed and queried alongside other data. Common scenarios include querying for objects within a given distance from a location, or selecting the object whose border contains a given location. EF Core supports mapping to spatial data types using the NetTopologySuite spatial library.
+
+## Installing
+
+In order to use spatial data with EF Core, you need to install the appropriate supporting NuGet package. Which package you need to install depends on the provider you're using.
+
+EF Core Provider                        | Spatial NuGet Package
+--------------------------------------- | ---------------------
+Microsoft.EntityFrameworkCore.SqlServer | [Microsoft.EntityFrameworkCore.SqlServer.NetTopologySuite](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.SqlServer.NetTopologySuite)
+Microsoft.EntityFrameworkCore.Sqlite    | [Microsoft.EntityFrameworkCore.Sqlite.NetTopologySuite](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Sqlite.NetTopologySuite)
+Microsoft.EntityFrameworkCore.InMemory  | [NetTopologySuite](https://www.nuget.org/packages/NetTopologySuite)
+Oracle.EntityFrameworkCore              | [Oracle.EntityFrameworkCore.NetTopologySuite](https://www.nuget.org/packages/Oracle.EntityFrameworkCore.NetTopologySuite)
+Npgsql.EntityFrameworkCore.PostgreSQL   | [Npgsql.EntityFrameworkCore.PostgreSQL.NetTopologySuite](https://www.nuget.org/packages/Npgsql.EntityFrameworkCore.PostgreSQL.NetTopologySuite)
+Pomelo.EntityFrameworkCore.MySql        | [Pomelo.EntityFrameworkCore.MySql.NetTopologySuite](https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql.NetTopologySuite)
+Devart.Data.MySql.EFCore                | [Devart.Data.MySql.EFCore.NetTopologySuite](https://www.nuget.org/packages/Devart.Data.MySql.EFCore.NetTopologySuite)
+Devart.Data.Oracle.EFCore               | [Devart.Data.Oracle.EFCore.NetTopologySuite](https://www.nuget.org/packages/Devart.Data.Oracle.EFCore.NetTopologySuite)
+Devart.Data.PostgreSql.EFCore           | [Devart.Data.PostgreSql.EFCore.NetTopologySuite](https://www.nuget.org/packages/Devart.Data.PostgreSql.EFCore.NetTopologySuite)
+Devart.Data.SQLite.EFCore               | [Devart.Data.SQLite.EFCore.NetTopologySuite](https://www.nuget.org/packages/Devart.Data.SQLite.EFCore.NetTopologySuite)
+Teradata.EntityFrameworkCore            | [Teradata.EntityFrameworkCore.NetTopologySuite](https://www.nuget.org/packages/Teradata.EntityFrameworkCore.NetTopologySuite)
+FileBaseContext                         | [NetTopologySuite](https://www.nuget.org/packages/NetTopologySuite)
+
+## NetTopologySuite
+
+[NetTopologySuite](https://nettopologysuite.github.io/NetTopologySuite/) (NTS) is a spatial library for .NET. EF Core enables mapping to spatial data types in the database by using NTS types in your model.
+
+To enable mapping to spatial types via NTS, call the UseNetTopologySuite method on the provider's DbContext options builder. For example, with SQL Server you'd call it like this.
+
+[!code-csharp[](../../../samples/core/Spatial/SqlServer/Models/WideWorldImportersContext.cs?name=snippet_UseNetTopologySuite)]
+
+There are several spatial data types. Which type you use depends on the types of shapes you want to allow. Here is the hierarchy of NTS types that you can use for properties in your model. They're located within the `NetTopologySuite.Geometries` namespace.
+
+* Geometry
+  * Point
+  * LineString
+  * Polygon
+  * GeometryCollection
+    * MultiPoint
+    * MultiLineString
+    * MultiPolygon
+
+> [!WARNING]
+> CircularString, CompoundCurve, and CurePolygon aren't supported by NTS.
+
+Using the base Geometry type allows any type of shape to be specified by the property.
+
+## Longitude and Latitude
+
+Coordinates in NTS are in terms of X and Y values. To represent longitude and latitude, use X for longitude and Y for latitude. Note that this is **backwards** from the `latitude, longitude` format in which you typically see these values.
+
+## Querying Data
+
+The following entity classes could be used to map to tables in the [Wide World Importers sample database](https://go.microsoft.com/fwlink/?LinkID=800630).
+
+[!code-csharp[](../../../samples/core/Spatial/SqlServer/Models/City.cs?name=snippet_City)]
+
+[!code-csharp[](../../../samples/core/Spatial/SqlServer/Models/Country.cs?name=snippet_Country)]
+
+In LINQ, the NTS methods and properties available as database functions will be translated to SQL. For example, the Distance and Contains methods are translated in the following queries. See your provider's documentation for which methods are supported.
+
+[!code-csharp[](../../../samples/core/Spatial/SqlServer/Program.cs?name=snippet_Distance)]
+
+[!code-csharp[](../../../samples/core/Spatial/SqlServer/Program.cs?name=snippet_Contains)]
+
+## Reverse engineering
+
+The spatial NuGet packages also enable [reverse engineering](xref:core/managing-schemas/scaffolding) models with spatial properties, but you need to install the package ***before*** running `Scaffold-DbContext` or `dotnet ef dbcontext scaffold`. If you don't, you'll receive warnings about not finding type mappings for the columns and the columns will be skipped.
+
+## SRID Ignored during client operations
+
+NTS ignores SRID values during operations. It assumes a planar coordinate system. This means that if you specify coordinates in terms of longitude and latitude, some client-evaluated values like distance, length, and area will be in degrees, not meters. For more meaningful values, you first need to project the coordinates to another coordinate system using a library like [ProjNet (for GeoAPI)](https://github.com/NetTopologySuite/ProjNet4GeoAPI).
+
+> [!NOTE]
+> Use the newer [ProjNet NuGet package](https://www.nuget.org/packages/ProjNet/), **not** the older package called ProjNet4GeoAPI.
+
+If an operation is server-evaluated by EF Core via SQL, the result's unit will be determined by the database.
+
+Here is an example of using ProjNet to calculate the distance between two cities.
+
+[!code-csharp[](../../../samples/core/Spatial/Projections/GeometryExtensions.cs?name=snippet_GeometryExtensions)]
+
+[!code-csharp[](../../../samples/core/Spatial/Projections/Program.cs?name=snippet_ProjectTo)]
+
+> [!NOTE]
+> 4326 refers to WGS 84, a standard used in GPS and other geographic systems.
+
+## Additional resources
+
+### Database-specific information
+
+Be sure to read your provider's documentation for additional information on working with spatial data.
+
+* [Spatial Data in the SQL Server Provider](xref:core/providers/sql-server/spatial)
+* [Spatial Data in the SQLite Provider](xref:core/providers/sqlite/spatial)
+* [Spatial Data in Oracle Data Provider for .NET](https://docs.oracle.com/en/database/oracle/oracle-database/26/odpnt/SpatialDataandNetTopologySuite.html)
+* [Spatial Data in the Npgsql Provider](https://www.npgsql.org/efcore/mapping/nts.html)
+
+### Other resources
+
+* [NetTopologySuite Docs](https://nettopologysuite.github.io/NetTopologySuite/)
+* [.NET Data Community Standup session](https://www.youtube.com/watch?v=IHslY5rrxD0&list=PLdo4fOcmZ0oX-DBuRG4u58ZTAJgBAeQ-t&index=15), focusing on spatial data and NetTopologySuite.
diff --git a/entity-framework/core/modeling/table-splitting.md b/entity-framework/core/modeling/table-splitting.md
new file mode 100644
index 0000000000..aca280051b
--- /dev/null
+++ b/entity-framework/core/modeling/table-splitting.md
@@ -0,0 +1,286 @@
+---
+title: Advanced table mapping - EF Core
+description: How to configure table splitting and entity splitting using Entity Framework Core.
+author: AndriySvyryd
+ms.date: 10/10/2022
+uid: core/modeling/table-splitting
+---
+
+# Advanced table mapping
+
+EF Core offers a lot of flexibility when it comes to mapping entity types to tables in a database. This becomes even more useful when you need to use a database that wasn't created by EF.
+
+The below techniques are described in terms of tables, but the same result can be achieved when mapping to views as well.
+
+## Table splitting
+
+EF Core allows to map two or more entities to a single row. This is called _table splitting_ or _table sharing_.
+
+### Configuration
+
+To use table splitting the entity types need to be mapped to the same table, have the primary keys mapped to the same columns and at least one relationship configured between the primary key of one entity type and another in the same table.
+
+A common scenario for table splitting is using only a subset of the columns in the table for greater performance or encapsulation.
+
+In this example `Order` represents a subset of `DetailedOrder`.
+
+[!code-csharp[Order](../../../samples/core/Modeling/TableSplitting/Order.cs?name=Order)]
+
+[!code-csharp[DetailedOrder](../../../samples/core/Modeling/TableSplitting/DetailedOrder.cs?name=DetailedOrder)]
+
+In addition to the required configuration we call `Property(o => o.Status).HasColumnName("Status")` to map `DetailedOrder.Status` to the same column as `Order.Status`.
+
+[!code-csharp[TableSplittingConfiguration](../../../samples/core/Modeling/TableSplitting/TableSplittingContext.cs?name=TableSplitting)]
+
+> [!TIP]
+> See the [full sample project](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Modeling/TableSplitting) for more context.
+
+### Usage
+
+Saving and querying entities using table splitting is done in the same way as other entities:
+
+[!code-csharp[Usage](../../../samples/core/Modeling/TableSplitting/Program.cs?name=Usage)]
+
+### Optional dependent entity
+
+If all of the columns used by a dependent entity are `NULL` in the database, then no instance for it will be created when queried. This allows modeling an optional dependent entity, where the relationship property on the principal would be null. Note that this would also happen if all of the dependent's properties are optional and set to `null`, which might not be expected.
+
+However, the additional check can impact query performance. In addition, if the dependent entity type has dependents of its own, then determining whether an instance should be created becomes non-trivial. To avoid these issues the dependent entity type can be marked as required, see [Required one-to-one dependents](xref:core/modeling/relationships/navigations#required-navigations) for more information.
+
+### Concurrency tokens
+
+If any of the entity types sharing a table has a concurrency token then it must be included in all other entity types as well. This is necessary in order to avoid a stale concurrency token value when only one of the entities mapped to the same table is updated.
+
+To avoid exposing the concurrency token to the consuming code, it's possible the create one as a [shadow property](xref:core/modeling/shadow-properties):
+
+[!code-csharp[TableSplittingConfiguration](../../../samples/core/Modeling/TableSplitting/TableSplittingContext.cs?name=ConcurrencyToken&highlight=2)]
+
+### Inheritance
+
+It's recommended to read [the dedicated page on inheritance](xref:core/modeling/inheritance) before continuing with this section.
+
+The dependent types using table splitting can have an inheritance hierarchy, but there are some limitations:
+
+- The dependent entity type __cannot__ use TPC mapping as the derived types wouldn't be able to map to the same table.
+- The dependent entity type __can__ use TPT mapping, but only the root entity type can use table splitting.
+- If the principal entity type uses TPC, then only the entity types that don't have any descendants can use table splitting. Otherwise the dependent columns would need to be duplicated on the tables corresponding to the derived types, complicating all interactions.
+
+## Entity splitting
+
+EF Core allows to map an entity to rows in two or more tables. This is called _entity splitting_.
+
+### Configuration
+
+For example, consider a database with three tables that hold customer data:
+
+- A `Customers` table for customer information
+- A `PhoneNumbers` table for the customer's phone number
+- An `Addresses` table for the customer's address
+
+Here are definitions for these tables in SQL Server:
+
+```sql
+CREATE TABLE [Customers] (
+    [Id] int NOT NULL IDENTITY,
+    [Name] nvarchar(max) NOT NULL,
+    CONSTRAINT [PK_Customers] PRIMARY KEY ([Id])
+);
+    
+CREATE TABLE [PhoneNumbers] (
+    [CustomerId] int NOT NULL,
+    [PhoneNumber] nvarchar(max) NULL,
+    CONSTRAINT [PK_PhoneNumbers] PRIMARY KEY ([CustomerId]),
+    CONSTRAINT [FK_PhoneNumbers_Customers_CustomerId] FOREIGN KEY ([CustomerId]) REFERENCES [Customers] ([Id]) ON DELETE CASCADE
+);
+
+CREATE TABLE [Addresses] (
+    [CustomerId] int NOT NULL,
+    [Street] nvarchar(max) NOT NULL,
+    [City] nvarchar(max) NOT NULL,
+    [PostCode] nvarchar(max) NULL,
+    [Country] nvarchar(max) NOT NULL,
+    CONSTRAINT [PK_Addresses] PRIMARY KEY ([CustomerId]),
+    CONSTRAINT [FK_Addresses_Customers_CustomerId] FOREIGN KEY ([CustomerId]) REFERENCES [Customers] ([Id]) ON DELETE CASCADE
+);
+```
+
+Each of these tables would typically be mapped to their own entity type, with relationships between the types. However, if all three tables are always used together, then it can be more convenient to map them all to a single entity type. For example:
+
+<!--
+    public class Customer
+    {
+        public Customer(string name, string street, string city, string? postCode, string country)
+        {
+            Name = name;
+            Street = street;
+            City = city;
+            PostCode = postCode;
+            Country = country;
+        }
+
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public string? PhoneNumber { get; set; }
+        public string Street { get; set; }
+        public string City { get; set; }
+        public string? PostCode { get; set; }
+        public string Country { get; set; }
+    }
+-->
+[!code-csharp[CombinedCustomer](../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs?name=CombinedCustomer)]
+
+This is achieved in EF7 by calling `SplitToTable` for each split in the entity type. For example, the following code splits the `Customer` entity type to the `Customers`, `PhoneNumbers`, and `Addresses` tables shown above:
+
+<!--
+            modelBuilder.Entity<Customer>(
+                entityBuilder =>
+                {
+                    entityBuilder
+                        .ToTable("Customers")
+                        .SplitToTable(
+                            "PhoneNumbers",
+                            tableBuilder =>
+                            {
+                                tableBuilder.Property(customer => customer.Id).HasColumnName("CustomerId");
+                                tableBuilder.Property(customer => customer.PhoneNumber);
+                            })
+                        .SplitToTable(
+                            "Addresses",
+                            tableBuilder =>
+                            {
+                                tableBuilder.Property(customer => customer.Id).HasColumnName("CustomerId");
+                                tableBuilder.Property(customer => customer.Street);
+                                tableBuilder.Property(customer => customer.City);
+                                tableBuilder.Property(customer => customer.PostCode);
+                                tableBuilder.Property(customer => customer.Country);
+                            });
+                });
+-->
+[!code-csharp[EntitySplitting](../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs?name=EntitySplitting)]
+
+Notice also that, if necessary, different column names can be specified for each of the tables. To configure the column name for the main table see [Table-specific facet configuration](#table-specific-facet-configuration).
+
+### Configuring the linking foreign key
+
+The FK linking the mapped tables is targeting the same properties on which it is declared. Normally it wouldn't be created in the database, as it would be redundant. But there's an exception for when the entity type is mapped to more than one table. To change its facets you can use the [relationship configuration Fluent API](xref:core/modeling/relationships/foreign-and-principal-keys):
+
+<!--
+            modelBuilder.Entity<Customer>()
+                .HasOne<Customer>()
+                .WithOne()
+                .HasForeignKey<Customer>(a => a.Id)
+                .OnDelete(DeleteBehavior.Restrict);
+-->
+[!code-csharp[LinkingForeignKey](../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs?name=LinkingForeignKey)]
+
+### Limitations
+
+- Entity splitting can't be used for entity types in hierarchies.
+- For any row in the main table there must be a row in each of the split tables (the fragments are not optional).
+
+## Table-specific facet configuration
+
+Some mapping patterns result in the same CLR property being mapped to a column in each of multiple different tables. EF7 allows these columns to have different names. For example, consider a simple inheritance hierarchy:
+
+<!--
+    public class Animal
+    {
+        public int Id { get; set; }
+        public string Breed { get; set; } = null!;
+    }
+
+    public class Cat : Animal
+    {
+        public string? EducationalLevel { get; set; }
+    }
+
+    public class Dog : Animal
+    {
+        public string? FavoriteToy { get; set; }
+    }
+-->
+[!code-csharp[Animals](../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs?name=Animals)]
+
+With the TPT [inheritance mapping strategy](xref:core/modeling/inheritance), these types will be mapped to three tables. However, the primary key column in each table may have a different name. For example:
+
+```sql
+CREATE TABLE [Animals] (
+    [Id] int NOT NULL IDENTITY,
+    [Breed] nvarchar(max) NOT NULL,
+    CONSTRAINT [PK_Animals] PRIMARY KEY ([Id])
+);
+
+CREATE TABLE [Cats] (
+    [CatId] int NOT NULL,
+    [EducationalLevel] nvarchar(max) NULL,
+    CONSTRAINT [PK_Cats] PRIMARY KEY ([CatId]),
+    CONSTRAINT [FK_Cats_Animals_CatId] FOREIGN KEY ([CatId]) REFERENCES [Animals] ([Id]) ON DELETE CASCADE
+);
+
+CREATE TABLE [Dogs] (
+    [DogId] int NOT NULL,
+    [FavoriteToy] nvarchar(max) NULL,
+    CONSTRAINT [PK_Dogs] PRIMARY KEY ([DogId]),
+    CONSTRAINT [FK_Dogs_Animals_DogId] FOREIGN KEY ([DogId]) REFERENCES [Animals] ([Id]) ON DELETE CASCADE
+);
+```
+
+EF7 allows this mapping to be configured using a nested table builder:
+
+<!--
+            modelBuilder.Entity<Animal>().ToTable("Animals");
+
+            modelBuilder.Entity<Cat>()
+                .ToTable(
+                    "Cats",
+                    tableBuilder => tableBuilder.Property(cat => cat.Id).HasColumnName("CatId"));
+
+            modelBuilder.Entity<Dog>()
+                .ToTable(
+                    "Dogs",
+                    tableBuilder => tableBuilder.Property(dog => dog.Id).HasColumnName("DogId"));
+-->
+[!code-csharp[AnimalsTpt](../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs?name=AnimalsTpt)]
+
+With the TPC inheritance mapping, the `Breed` property can also be mapped to different column names in different tables. For example, consider the following TPC tables:
+
+```sql
+CREATE TABLE [Cats] (
+    [CatId] int NOT NULL DEFAULT (NEXT VALUE FOR [AnimalSequence]),
+    [CatBreed] nvarchar(max) NOT NULL,
+    [EducationalLevel] nvarchar(max) NULL,
+    CONSTRAINT [PK_Cats] PRIMARY KEY ([CatId])
+);
+
+CREATE TABLE [Dogs] (
+    [DogId] int NOT NULL DEFAULT (NEXT VALUE FOR [AnimalSequence]),
+    [DogBreed] nvarchar(max) NOT NULL,
+    [FavoriteToy] nvarchar(max) NULL,
+    CONSTRAINT [PK_Dogs] PRIMARY KEY ([DogId])
+);
+```
+
+EF7 supports this table mapping:
+
+<!--
+            modelBuilder.Entity<Animal>().UseTpcMappingStrategy();
+
+            modelBuilder.Entity<Cat>()
+                .ToTable(
+                    "Cats",
+                    builder =>
+                    {
+                        builder.Property(cat => cat.Id).HasColumnName("CatId");
+                        builder.Property(cat => cat.Breed).HasColumnName("CatBreed");
+                    });
+
+            modelBuilder.Entity<Dog>()
+                .ToTable(
+                    "Dogs",
+                    builder =>
+                    {
+                        builder.Property(dog => dog.Id).HasColumnName("DogId");
+                        builder.Property(dog => dog.Breed).HasColumnName("DogBreed");
+                    });
+-->
+[!code-csharp[AnimalsTpc](../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs?name=AnimalsTpc)]
diff --git a/entity-framework/core/modeling/value-comparers.md b/entity-framework/core/modeling/value-comparers.md
new file mode 100644
index 0000000000..a5c1f430e3
--- /dev/null
+++ b/entity-framework/core/modeling/value-comparers.md
@@ -0,0 +1,121 @@
+---
+title: Value Comparers - EF Core
+description: Using value comparers to control how EF Core compares property values
+author: SamMonoRT
+ms.date: 11/15/2021
+uid: core/modeling/value-comparers
+---
+
+# Value Comparers
+
+> [!TIP]
+> The code in this document can be found on GitHub as a [runnable sample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Modeling/ValueConversions/).
+
+## Background
+
+[Change tracking](xref:core/change-tracking/index) means that EF Core automatically determines what changes were performed by the application on a loaded entity instance, so that those changes can be saved back to the database when <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*> is called. EF Core usually performs this by taking a *snapshot* of the instance when it's loaded from the database, and *comparing* that snapshot to the instance handed out to the application.
+
+EF Core comes with built-in logic for snapshotting and comparing most standard types used in databases, so users don't usually need to worry about this topic. However, when a property is mapped through a [value converter](xref:core/modeling/value-conversions), EF Core needs to perform comparison on arbitrary user types, which may be complex. By default, EF Core uses the default equality comparison defined by types (e.g. the `Equals` method); for snapshotting, [value types](/dotnet/csharp/language-reference/builtin-types/value-types) are copied to produce the snapshot, while for [reference types](/dotnet/csharp/language-reference/keywords/reference-types) no copying occurs, and the same instance is used as the snapshot.
+
+In cases where the built-in comparison behavior isn't appropriate, users may provide a *value comparer*, which contains logic for snapshotting, comparing and calculating a hash code. For example, the following sets up value conversion for `List<int>` property to be value converted to a JSON string in the database, and defines an appropriate value comparer as well:
+
+[!code-csharp[ListProperty](../../../samples/core/Modeling/ValueConversions/MappingListProperty.cs?name=ConfigureListProperty)]
+
+See [mutable classes](#mutable-classes) below for further details.
+
+Note that value comparers are also used when determining whether two key values are the same when resolving relationships; this is explained below.
+
+## Shallow vs. deep comparison
+
+For small, immutable value types such as `int`, EF Core's default logic works well: the value is copied as-is when snapshotted, and compared with the type's built-in equality comparison. When implementing your own value comparer, it's important to consider whether deep or shallow comparison (and snapshotting) logic is appropriate.
+
+Consider byte arrays, which can be arbitrarily large. These could be compared:
+
+* By reference, such that a difference is only detected if a new byte array is used
+* By deep comparison, such that mutation of the bytes in the array is detected
+
+By default, EF Core uses the first of these approaches for non-key byte arrays. That is, only references are compared and a change is detected only when an existing byte array is replaced with a new one. This is a pragmatic decision that avoids copying entire arrays and comparing them byte-to-byte when executing <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*>. It means that the common scenario of replacing, say, one image with another is handled in a performant way.
+
+On the other hand, reference equality would not work when byte arrays are used to represent binary keys, since it's very unlikely that an FK property is set to the *same instance* as a PK property to which it needs to be compared. Therefore, EF Core uses deep comparisons for byte arrays acting as keys; this is unlikely to have a big performance hit since binary keys are usually short.
+
+Note that the chosen comparison and snapshotting logic must correspond to each other: deep comparison requires deep snapshotting to function correctly.
+
+## Simple immutable classes
+
+Consider a property that uses a value converter to map a simple, immutable class.
+
+[!code-csharp[SimpleImmutableClass](../../../samples/core/Modeling/ValueConversions/MappingImmutableClassProperty.cs?name=SimpleImmutableClass)]
+
+[!code-csharp[ConfigureImmutableClassProperty](../../../samples/core/Modeling/ValueConversions/MappingImmutableClassProperty.cs?name=ConfigureImmutableClassProperty)]
+
+Properties of this type do not need special comparisons or snapshots because:
+
+* Equality is overridden so that different instances will compare correctly
+* The type is immutable, so there is no chance of mutating a snapshot value
+
+So in this case the default behavior of EF Core is fine as it is.
+
+## Simple immutable structs
+
+The mapping for simple structs is also simple and requires no special comparers or snapshotting.
+
+[!code-csharp[SimpleImmutableStruct](../../../samples/core/Modeling/ValueConversions/MappingImmutableStructProperty.cs?name=SimpleImmutableStruct)]
+
+[!code-csharp[ConfigureImmutableStructProperty](../../../samples/core/Modeling/ValueConversions/MappingImmutableStructProperty.cs?name=ConfigureImmutableStructProperty)]
+
+EF Core has built-in support for generating compiled, memberwise comparisons of struct properties. This means structs don't need to have equality overridden for EF Core, but you may still choose to do this for [other reasons](/dotnet/csharp/programming-guide/statements-expressions-operators/how-to-define-value-equality-for-a-type). Also, special snapshotting is not needed since structs are immutable and are always copied memberwise anyway. (This is also true for mutable structs, but [mutable structs should in general be avoided](/dotnet/csharp/write-safe-efficient-code).)
+
+## Mutable classes
+
+It is recommended that you use immutable types (classes or structs) with value converters when possible. This is usually more efficient and has cleaner semantics than using a mutable type. However, that being said, it is common to use properties of types that the application cannot change. For example, mapping a property containing a list of numbers:
+
+[!code-csharp[ListProperty](../../../samples/core/Modeling/ValueConversions/MappingListProperty.cs?name=ListProperty)]
+
+The <xref:System.Collections.Generic.List`1> class:
+
+* Has reference equality; two lists containing the same values are treated as different.
+* Is mutable; values in the list can be added and removed.
+
+A typical value conversion on a list property might convert the list to and from JSON:
+
+### [EF Core 5.0](#tab/ef5)
+
+[!code-csharp[ListProperty](../../../samples/core/Modeling/ValueConversions/MappingListProperty.cs?name=ConfigureListProperty&highlight=7-10)]
+
+### [Older versions](#tab/older-versions)
+
+[!code-csharp[ListProperty](../../../samples/core/Modeling/ValueConversions/MappingListPropertyOld.cs?name=ConfigureListProperty&highlight=8-11,17)]
+
+***
+
+The <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ValueComparer`1> constructor accepts three expressions:
+
+* An expression for checking equality
+* An expression for generating a hash code
+* An expression to snapshot a value
+
+In this case the comparison is done by checking if the sequences of numbers are the same.
+
+Likewise, the hash code is built from this same sequence. (Note that this is a hash code over mutable values and hence can [cause problems](https://ericlippert.com/2011/02/28/guidelines-and-rules-for-gethashcode/). Be immutable instead if you can.)
+
+The snapshot is created by cloning the list with `ToList`. Again, this is only needed if the lists are going to be mutated. Be immutable instead if you can.
+
+> [!NOTE]
+> Value converters and comparers are constructed using expressions rather than simple delegates. This is because EF Core inserts these expressions into a much more complex expression tree that is then compiled into an entity shaper delegate. Conceptually, this is similar to compiler inlining. For example, a simple conversion may just be a compiled in cast, rather than a call to another method to do the conversion.
+
+## Key comparers
+
+The background section covers why key comparisons may require special semantics. Make sure to create a comparer that is appropriate for keys when setting it on a primary, principal, or foreign key property.
+
+Use <xref:Microsoft.EntityFrameworkCore.MutablePropertyExtensions.SetKeyValueComparer*> in the rare cases where different semantics is required on the same property.
+
+> [!NOTE]
+> <xref:Microsoft.EntityFrameworkCore.MutablePropertyExtensions.SetStructuralValueComparer*> has been obsoleted. Use <xref:Microsoft.EntityFrameworkCore.MutablePropertyExtensions.SetKeyValueComparer*> instead.
+
+## Overriding the default comparer
+
+Sometimes the default comparison used by EF Core may not be appropriate. For example, mutation of byte arrays is not, by default, detected in EF Core. This can be overridden by setting a different comparer on the property:
+
+[!code-csharp[OverrideComparer](../../../samples/core/Modeling/ValueConversions/OverridingByteArrayComparisons.cs?name=OverrideComparer)]
+
+EF Core will now compare byte sequences and will therefore detect byte array mutations.
diff --git a/entity-framework/core/modeling/value-conversions.md b/entity-framework/core/modeling/value-conversions.md
new file mode 100644
index 0000000000..0a9e039b22
--- /dev/null
+++ b/entity-framework/core/modeling/value-conversions.md
@@ -0,0 +1,801 @@
+---
+title: Value Conversions - EF Core
+description: Configuring value converters in an Entity Framework Core model
+author: SamMonoRT
+ms.date: 01/16/2021
+uid: core/modeling/value-conversions
+---
+# Value Conversions
+
+Value converters allow property values to be converted when reading from or writing to the database. This conversion can be from one value to another of the same type (for example, encrypting strings) or from a value of one type to a value of another type (for example, converting enum values to and from strings in the database.)
+
+> [!TIP]
+> You can run and debug into all the code in this document by [downloading the sample code from GitHub](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Modeling/ValueConversions/).
+
+## Overview
+
+Value converters are specified in terms of a `ModelClrType` and a `ProviderClrType`. The model type is the .NET type of the property in the entity type. The provider type is the .NET type understood by the database provider. For example, to save enums as strings in the database, the model type is the type of the enum, and the provider type is `String`. These two types can be the same.
+
+Conversions are defined using two `Func` expression trees: one from `ModelClrType` to `ProviderClrType` and the other from `ProviderClrType` to `ModelClrType`. Expression trees are used so that they can be compiled into the database access delegate for efficient conversions. The expression tree may contain a simple call to a conversion method for complex conversions.
+
+> [!NOTE]
+> A property that has been configured for value conversion may also need to specify a <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ValueComparer`1>. See the examples below, and the [Value Comparers](xref:core/modeling/value-comparers) documentation for more information.
+
+## Configuring a value converter
+
+Value conversions are configured in <xref:Microsoft.EntityFrameworkCore.DbContext.OnModelCreating*?displayProperty=nameWithType>. For example, consider an enum and entity type defined as:
+
+<!--
+        public class Rider
+        {
+            public int Id { get; set; }
+            public EquineBeast Mount { get; set; }
+        }
+
+        public enum EquineBeast
+        {
+            Donkey,
+            Mule,
+            Horse,
+            Unicorn
+        }
+-->
+[!code-csharp[BeastAndRider](../../../samples/core/Modeling/ValueConversions/EnumToStringConversions.cs?name=BeastAndRider)]
+
+Conversions can be configured in <xref:Microsoft.EntityFrameworkCore.DbContext.OnModelCreating*> to store the enum values as strings such as "Donkey", "Mule", etc. in the database; you simply need to provide one function which converts from the `ModelClrType` to the `ProviderClrType`, and another for the opposite conversion:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder
+                    .Entity<Rider>()
+                    .Property(e => e.Mount)
+                    .HasConversion(
+                        v => v.ToString(),
+                        v => (EquineBeast)Enum.Parse(typeof(EquineBeast), v));
+            }
+-->
+[!code-csharp[ExplicitConversion](../../../samples/core/Modeling/ValueConversions/EnumToStringConversions.cs?name=ExplicitConversion)]
+
+> [!NOTE]
+> A `null` value will never be passed to a value converter. A null in a database column is always a null in the entity instance, and vice-versa. This makes the implementation of conversions easier and allows them to be shared amongst nullable and non-nullable properties. See [GitHub issue #13850](https://github.com/dotnet/efcore/issues/13850) for more information.
+
+### Bulk-configuring a value converter
+
+It's common for the same value converter to be configured for every property that uses the relevant CLR type. Rather than doing this manually for each property, you can use [pre-convention model configuration](xref:core/modeling/bulk-configuration#pre-convention-configuration) to do this once for your entire model. To do this, define your value converter as a class:
+
+[!code-csharp[Main](../../../samples/core/Modeling/BulkConfiguration/CurrencyConverter.cs?name=CurrencyConverter)]
+
+Then, override <xref:Microsoft.EntityFrameworkCore.DbContext.ConfigureConventions*> in your context type and configure the converter as follows:
+
+[!code-csharp[Main](../../../samples/core/Modeling/BulkConfiguration/CurrencyContext.cs?name=ConfigureConventions)]
+
+## Pre-defined conversions
+
+EF Core contains many pre-defined conversions that avoid the need to write conversion functions manually. Instead, EF Core will pick the conversion to use based on the property type in the model and the requested database provider type.
+
+For example, enum to string conversions are used as an example above, but EF Core will actually do this automatically when the provider type is configured as `string` using the generic type of <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder.HasConversion*>:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder
+                    .Entity<Rider>()
+                    .Property(e => e.Mount)
+                    .HasConversion<string>();
+            }
+-->
+[!code-csharp[ConversionByClrType](../../../samples/core/Modeling/ValueConversions/EnumToStringConversions.cs?name=ConversionByClrType)]
+
+The same thing can be achieved by explicitly specifying the database column type. For example, if the entity type is defined like so:
+
+### [Data Annotations](#tab/data-annotations)
+
+<!--
+        public class Rider2
+        {
+            public int Id { get; set; }
+
+            [Column(TypeName = "nvarchar(24)")]
+            public EquineBeast Mount { get; set; }
+        }
+-->
+[!code-csharp[ConversionByDatabaseType](../../../samples/core/Modeling/ValueConversions/EnumToStringConversions.cs?name=ConversionByDatabaseType)]
+
+### [Fluent API](#tab/fluent-api)
+
+<!--
+                modelBuilder
+                    .Entity<Rider2>()
+                    .Property(e => e.Mount)
+                    .HasColumnType("nvarchar(24)");
+-->
+[!code-csharp[ConversionByDatabaseTypeFluent](../../../samples/core/Modeling/ValueConversions/EnumToStringConversions.cs?name=ConversionByDatabaseTypeFluent)]
+
+***
+
+Then the enum values will be saved as strings in the database without any further configuration in <xref:Microsoft.EntityFrameworkCore.DbContext.OnModelCreating*>.
+
+## The ValueConverter class
+
+Calling <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.PropertyBuilder.HasConversion*> as shown above will create a <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.ValueConverter`2> instance and set it on the property. The `ValueConverter` can instead be created explicitly. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                var converter = new ValueConverter<EquineBeast, string>(
+                    v => v.ToString(),
+                    v => (EquineBeast)Enum.Parse(typeof(EquineBeast), v));
+
+                modelBuilder
+                    .Entity<Rider>()
+                    .Property(e => e.Mount)
+                    .HasConversion(converter);
+            }
+-->
+[!code-csharp[ConversionByConverterInstance](../../../samples/core/Modeling/ValueConversions/EnumToStringConversions.cs?name=ConversionByConverterInstance)]
+
+This can be useful when multiple properties use the same conversion.
+
+## Built-in converters
+
+As mentioned above, EF Core ships with a set of pre-defined <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.ValueConverter`2> classes, found in the <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion> namespace. In many cases EF will choose the appropriate built-in converter based on the type of the property in the model and the type requested in the database, as shown above for enums. For example, using `.HasConversion<int>()` on a `bool` property will cause EF Core to convert bool values to numerical zero and one values:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder
+                    .Entity<User>()
+                    .Property(e => e.IsActive)
+                    .HasConversion<int>();
+            }
+-->
+[!code-csharp[ConversionByBuiltInBoolToInt](../../../samples/core/Modeling/ValueConversions/EnumToStringConversions.cs?name=ConversionByBuiltInBoolToInt)]
+
+This is functionally the same as creating an instance of the built-in <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.BoolToZeroOneConverter`1> and setting it explicitly:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                var converter = new BoolToZeroOneConverter<int>();
+
+                modelBuilder
+                    .Entity<User>()
+                    .Property(e => e.IsActive)
+                    .HasConversion(converter);
+            }
+-->
+[!code-csharp[ConversionByBuiltInBoolToIntExplicit](../../../samples/core/Modeling/ValueConversions/EnumToStringConversions.cs?name=ConversionByBuiltInBoolToIntExplicit)]
+
+The following table summarizes commonly-used pre-defined conversions from model/property types to database provider types. In the table `any_numeric_type` means one of `int`, `short`, `long`, `byte`, `uint`, `ushort`, `ulong`, `sbyte`, `char`, `decimal`, `float`, or `double`.
+
+| Model/property type | Provider/database type | Conversion                                                | Usage
+|:--------------------|------------------------|-----------------------------------------------------------|------
+| bool                | any_numeric_type       | False/true to 0/1                                         | `.HasConversion<any_numeric_type>()`
+|                     | any_numeric_type       | False/true to any two numbers                             | Use <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.BoolToTwoValuesConverter`1>
+|                     | string                 | False/true to "N"/"Y"                                     | `.HasConversion<string>()`
+|                     | string                 | False/true to any two strings                             | Use <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.BoolToStringConverter>
+| any_numeric_type    | bool                   | 0/1 to false/true                                         | `.HasConversion<bool>()`
+|                     | any_numeric_type       | Simple cast                                               | `.HasConversion<any_numeric_type>()`
+|                     | string                 | The number as a string                                    | `.HasConversion<string>()`
+| Enum                | any_numeric_type       | The numeric value of the enum                             | `.HasConversion<any_numeric_type>()`
+|                     | string                 | The string representation of the enum value               | `.HasConversion<string>()`
+| string              | bool                   | Parses the string as a bool                               | `.HasConversion<bool>()`
+|                     | any_numeric_type       | Parses the string as the given numeric type               | `.HasConversion<any_numeric_type>()`
+|                     | char                   | The first character of the string                         | `.HasConversion<char>()`
+|                     | DateTime               | Parses the string as a DateTime                           | `.HasConversion<DateTime>()`
+|                     | DateTimeOffset         | Parses the string as a DateTimeOffset                     | `.HasConversion<DateTimeOffset>()`
+|                     | TimeSpan               | Parses the string as a TimeSpan                           | `.HasConversion<TimeSpan>()`
+|                     | Guid                   | Parses the string as a Guid                               | `.HasConversion<Guid>()`
+|                     | byte[]                 | The string as UTF8 bytes                                  | `.HasConversion<byte[]>()`
+| char                | string                 | A single character string                                 | `.HasConversion<string>()`
+| DateTime            | long                   | Encoded date/time preserving DateTime.Kind                | `.HasConversion<long>()`
+|                     | long                   | Ticks                                                     | Use <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.DateTimeToTicksConverter>
+|                     | string                 | Invariant culture date/time string                        | `.HasConversion<string>()`
+| DateTimeOffset      | long                   | Encoded date/time with offset                             | `.HasConversion<long>()`
+|                     | string                 | Invariant culture date/time string with offset            | `.HasConversion<string>()`
+| TimeSpan            | long                   | Ticks                                                     | `.HasConversion<long>()`
+|                     | string                 | Invariant culture time span string                        | `.HasConversion<string>()`
+| Uri                 | string                 | The URI as a string                                       | `.HasConversion<string>()`
+| PhysicalAddress     | string                 | The address as a string                                   | `.HasConversion<string>()`
+|                     | byte[]                 | Bytes in big-endian network order                         | `.HasConversion<byte[]>()`
+| IPAddress           | string                 | The address as a string                                   | `.HasConversion<string>()`
+|                     | byte[]                 | Bytes in big-endian network order                         | `.HasConversion<byte[]>()`
+| Guid                | string                 | The GUID in 'dddddddd-dddd-dddd-dddd-dddddddddddd' format | `.HasConversion<string>()`
+|                     | byte[]                 | Bytes in .NET binary serialization order                  | `.HasConversion<byte[]>()`
+
+Note that these conversions assume that the format of the value is appropriate for the conversion. For example, converting strings to numbers will fail if the string values cannot be parsed as numbers.
+
+The full list of built-in converters is:
+
+* Converting bool properties:
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.BoolToStringConverter> - Bool to strings such as "N" and "Y"
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.BoolToTwoValuesConverter`1> - Bool to any two values
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.BoolToZeroOneConverter`1> - Bool to zero and one
+* Converting byte array properties:
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.BytesToStringConverter> - Byte array to Base64-encoded string
+* Any conversion that requires only a type-cast
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.CastingConverter`2> - Conversions that require only a type cast
+* Converting char properties:
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.CharToStringConverter> - Char to single character string
+* Converting <xref:System.DateTimeOffset> properties:
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.DateTimeOffsetToBinaryConverter> - <xref:System.DateTimeOffset> to binary-encoded 64-bit value
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.DateTimeOffsetToBytesConverter> - <xref:System.DateTimeOffset> to byte array
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.DateTimeOffsetToStringConverter> - <xref:System.DateTimeOffset> to string
+* Converting <xref:System.DateTime> properties:
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.DateTimeToBinaryConverter> - <xref:System.DateTime> to 64-bit value including DateTimeKind
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.DateTimeToStringConverter> - <xref:System.DateTime> to string
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.DateTimeToTicksConverter> - <xref:System.DateTime> to ticks
+* Converting enum properties:
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.EnumToNumberConverter`2> - Enum to underlying number
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.EnumToStringConverter`1> - Enum to string
+* Converting <xref:System.Guid> properties:
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.GuidToBytesConverter> - <xref:System.Guid> to byte array
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.GuidToStringConverter> - <xref:System.Guid> to string
+* Converting <xref:System.Net.IPAddress> properties:
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.IPAddressToBytesConverter> - <xref:System.Net.IPAddress> to byte array
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.IPAddressToStringConverter> - <xref:System.Net.IPAddress> to string
+* Converting numeric (int, double, decimal, etc.) properties:
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.NumberToBytesConverter`1> - Any numerical value to byte array
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.NumberToStringConverter`1> - Any numerical value to string
+* Converting <xref:System.Net.NetworkInformation.PhysicalAddress> properties:
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.PhysicalAddressToBytesConverter> - <xref:System.Net.NetworkInformation.PhysicalAddress> to byte array
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.PhysicalAddressToStringConverter> - <xref:System.Net.NetworkInformation.PhysicalAddress> to string
+* Converting string properties:
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.StringToBoolConverter> - Strings such as "N" and "Y" to bool
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.StringToBytesConverter> - String to UTF8 bytes
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.StringToCharConverter> - String to character
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.StringToDateTimeConverter> - String to <xref:System.DateTime>
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.StringToDateTimeOffsetConverter> - String to <xref:System.DateTimeOffset>
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.StringToEnumConverter`1> - String to enum
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.StringToGuidConverter> - String to <xref:System.Guid>
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.StringToNumberConverter`1> - String to numeric type
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.StringToTimeSpanConverter> - String to <xref:System.TimeSpan>
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.StringToUriConverter> - String to <xref:System.Uri>
+* Converting <xref:System.TimeSpan> properties:
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.TimeSpanToStringConverter> - <xref:System.TimeSpan> to string
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.TimeSpanToTicksConverter> - <xref:System.TimeSpan> to ticks
+* Converting <xref:System.Uri> properties:
+  * <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.UriToStringConverter> - <xref:System.Uri> to string
+
+Note that all the built-in converters are stateless and so a single instance can be safely shared by multiple properties.
+
+## Column facets and mapping hints
+
+Some database types have facets that modify how the data is stored. These include:
+
+* Precision and scale for decimals and date/time columns
+* Size/length for binary and string columns
+* Unicode for string columns
+
+These facets can be configured in the normal way for a property that uses a value converter, and will apply to the converted database type. For example, when converting from an enum to strings, we can specify that the database column should be non-Unicode and store up to 20 characters:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder
+                    .Entity<Rider>()
+                    .Property(e => e.Mount)
+                    .HasConversion<string>()
+                    .HasMaxLength(20)
+                    .IsUnicode(false);
+            }
+-->
+[!code-csharp[ConversionByClrTypeWithFacets](../../../samples/core/Modeling/ValueConversions/EnumToStringConversions.cs?name=ConversionByClrTypeWithFacets)]
+
+Or, when creating the converter explicitly:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                var converter = new ValueConverter<EquineBeast, string>(
+                    v => v.ToString(),
+                    v => (EquineBeast)Enum.Parse(typeof(EquineBeast), v));
+
+                modelBuilder
+                    .Entity<Rider>()
+                    .Property(e => e.Mount)
+                    .HasConversion(converter)
+                    .HasMaxLength(20)
+                    .IsUnicode(false);
+            }
+-->
+[!code-csharp[ConversionByConverterInstanceWithFacets](../../../samples/core/Modeling/ValueConversions/EnumToStringConversions.cs?name=ConversionByConverterInstanceWithFacets)]
+
+This results in a `varchar(20)` column when using EF Core migrations against SQL Server:
+
+```sql
+CREATE TABLE [Rider] (
+    [Id] int NOT NULL IDENTITY,
+    [Mount] varchar(20) NOT NULL,
+    CONSTRAINT [PK_Rider] PRIMARY KEY ([Id]));
+```
+
+However, if by default all `EquineBeast` columns should be `varchar(20)`, then this information can be given to the value converter as a <xref:Microsoft.EntityFrameworkCore.Storage.ValueConversion.ConverterMappingHints>. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                var converter = new ValueConverter<EquineBeast, string>(
+                    v => v.ToString(),
+                    v => (EquineBeast)Enum.Parse(typeof(EquineBeast), v),
+                    new ConverterMappingHints(size: 20, unicode: false));
+
+                modelBuilder
+                    .Entity<Rider>()
+                    .Property(e => e.Mount)
+                    .HasConversion(converter);
+            }
+-->
+[!code-csharp[ConversionByConverterInstanceWithMappingHints](../../../samples/core/Modeling/ValueConversions/EnumToStringConversions.cs?name=ConversionByConverterInstanceWithMappingHints)]
+
+Now any time this converter is used, the database column will be non-unicode with a max length of 20. However, these are only hints since they are overridden by any facets explicitly set on the mapped property.
+
+## Examples
+
+### Simple value objects
+
+This example uses a simple type to wrap a primitive type. This can be useful when you want the type in your model to be more specific (and hence more type-safe) than a primitive type. In this example, that type is `Dollars`, which wraps the decimal primitive:
+
+<!--
+        public readonly struct Dollars
+        {
+            public Dollars(decimal amount) 
+                => Amount = amount;
+            
+            public decimal Amount { get; }
+
+            public override string ToString() 
+                => $"${Amount}";
+        }
+-->
+[!code-csharp[SimpleValueObject](../../../samples/core/Modeling/ValueConversions/SimpleValueObject.cs?name=SimpleValueObject)]
+
+This can be used in an entity type:
+
+<!--
+        public class Order
+        {
+            public int Id { get; set; }
+
+            public Dollars Price { get; set; }
+        }
+-->
+[!code-csharp[SimpleValueObjectModel](../../../samples/core/Modeling/ValueConversions/SimpleValueObject.cs?name=SimpleValueObjectModel)]
+
+And converted to the underlying `decimal` when stored in the database:
+
+<!--
+                modelBuilder.Entity<Order>()
+                    .Property(e => e.Price)
+                    .HasConversion(
+                        v => v.Amount,
+                        v => new Dollars(v));
+-->
+[!code-csharp[ConfigureImmutableStructProperty](../../../samples/core/Modeling/ValueConversions/SimpleValueObject.cs?name=ConfigureImmutableStructProperty)]
+
+> [!NOTE]
+> This value object is implemented as a [readonly struct](/dotnet/csharp/language-reference/builtin-types/struct). This means that EF Core can snapshot and compare values without issue. See [Value Comparers](xref:core/modeling/value-comparers) for more information.
+
+### Composite value objects
+
+In the previous example, the value object type contained only a single property. It is more common for a value object type to compose multiple properties that together form a domain concept. For example, a general `Money` type that contains both the amount and the currency:
+
+<!--
+        public readonly struct Money
+        {
+            [JsonConstructor]
+            public Money(decimal amount, Currency currency)
+            {
+                Amount = amount;
+                Currency = currency;
+            }
+
+            public override string ToString()
+                => (Currency == Currency.UsDollars ? "$" : "£") + Amount;
+
+            public decimal Amount { get; }
+            public Currency Currency { get; }
+        }
+
+        public enum Currency
+        {
+            UsDollars,
+            PoundsStirling
+        }
+-->
+[!code-csharp[CompositeValueObject](../../../samples/core/Modeling/ValueConversions/CompositeValueObject.cs?name=CompositeValueObject)]
+
+This value object can be used in an entity type as before:
+
+<!--
+        public class Order
+        {
+            public int Id { get; set; }
+
+            public Money Price { get; set; }
+        }
+-->
+[!code-csharp[CompositeValueObjectModel](../../../samples/core/Modeling/ValueConversions/CompositeValueObject.cs?name=CompositeValueObjectModel)]
+
+Value converters can currently only convert values to and from a single database column. This limitation means that all property values from the object must be encoded into a single column value. This is typically handled by serializing the object as it goes into the database, and then deserializing it again on the way out. For example, using <xref:System.Text.Json>:
+
+<!--
+                modelBuilder.Entity<Order>()
+                    .Property(e => e.Price)
+                    .HasConversion(
+                        v => JsonSerializer.Serialize(v, null),
+                        v => JsonSerializer.Deserialize<Money>(v, null));
+-->
+[!code-csharp[ConfigureCompositeValueObject](../../../samples/core/Modeling/ValueConversions/CompositeValueObject.cs?name=ConfigureCompositeValueObject)]
+
+> [!NOTE]
+> We plan to allow mapping an object to multiple columns in a future version of EF Core, removing the need to use serialization here. This is tracked by [GitHub issue #13947](https://github.com/dotnet/efcore/issues/13947).
+
+> [!NOTE]
+> As with the previous example, this value object is implemented as a [readonly struct](/dotnet/csharp/language-reference/builtin-types/struct). This means that EF Core can snapshot and compare values without issue. See [Value Comparers](xref:core/modeling/value-comparers) for more information.
+
+### Collections of primitives
+
+Serialization can also be used to store a collection of primitive values. For example:
+
+<!--
+        public class Post
+        {
+            public int Id { get; set; }
+            public string Title { get; set; }
+            public string Contents { get; set; }
+
+            public ICollection<string> Tags { get; set; }
+        }
+-->
+[!code-csharp[PrimitiveCollectionModel](../../../samples/core/Modeling/ValueConversions/PrimitiveCollection.cs?name=PrimitiveCollectionModel)]
+
+Using <xref:System.Text.Json> again:
+
+<!--
+                modelBuilder.Entity<Post>()
+                    .Property(e => e.Tags)
+                    .HasConversion(
+                        v => JsonSerializer.Serialize(v, null),
+                        v => JsonSerializer.Deserialize<List<string>>(v, null),
+                        new ValueComparer<ICollection<string>>(
+                            (c1, c2) => c1.SequenceEqual(c2),
+                            c => c.Aggregate(0, (a, v) => HashCode.Combine(a, v.GetHashCode())),
+                            c => (ICollection<string>)c.ToList()));
+-->
+[!code-csharp[ConfigurePrimitiveCollection](../../../samples/core/Modeling/ValueConversions/PrimitiveCollection.cs?name=ConfigurePrimitiveCollection)]
+
+`ICollection<string>` represents a mutable reference type. This means that a <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ValueComparer`1> is needed so that EF Core can track and detect changes correctly. See [Value Comparers](xref:core/modeling/value-comparers) for more information.
+
+### Collections of value objects
+
+Combining the previous two examples together we can create a collection of value objects. For example, consider an `AnnualFinance` type that models blog finances for a single year:
+
+<!--
+        public readonly struct AnnualFinance
+        {
+            [JsonConstructor]
+            public AnnualFinance(int year, Money income, Money expenses)
+            {
+                Year = year;
+                Income = income;
+                Expenses = expenses;
+            }
+
+            public int Year { get; }
+            public Money Income { get; }
+            public Money Expenses { get; }
+            public Money Revenue => new Money(Income.Amount - Expenses.Amount, Income.Currency);
+        }
+-->
+[!code-csharp[ValueObjectCollection](../../../samples/core/Modeling/ValueConversions/ValueObjectCollection.cs?name=ValueObjectCollection)]
+
+This type composes several of the `Money` types we created previously:
+
+<!--
+        public readonly struct Money
+        {
+            [JsonConstructor]
+            public Money(decimal amount, Currency currency)
+            {
+                Amount = amount;
+                Currency = currency;
+            }
+
+            public override string ToString()
+                => (Currency == Currency.UsDollars ? "$" : "£") + Amount;
+
+            public decimal Amount { get; }
+            public Currency Currency { get; }
+        }
+
+        public enum Currency
+        {
+            UsDollars,
+            PoundsStirling
+        }
+-->
+[!code-csharp[ValueObjectCollectionMoney](../../../samples/core/Modeling/ValueConversions/ValueObjectCollection.cs?name=ValueObjectCollectionMoney)]
+
+We can then add a collection of `AnnualFinance` to our entity type:
+
+<!--
+        public class Blog
+        {
+            public int Id { get; set; }
+            public string Name { get; set; }
+            
+            public IList<AnnualFinance> Finances { get; set; }
+        }
+-->
+[!code-csharp[ValueObjectCollectionModel](../../../samples/core/Modeling/ValueConversions/ValueObjectCollection.cs?name=ValueObjectCollectionModel)]
+
+And again use serialization to store this:
+
+<!--
+                modelBuilder.Entity<Blog>()
+                    .Property(e => e.Finances)
+                    .HasConversion(
+                        v => JsonSerializer.Serialize(v, null),
+                        v => JsonSerializer.Deserialize<List<AnnualFinance>>(v, null),
+                        new ValueComparer<IList<AnnualFinance>>(
+                            (c1, c2) => c1.SequenceEqual(c2),
+                            c => c.Aggregate(0, (a, v) => HashCode.Combine(a, v.GetHashCode())),
+                            c => (IList<AnnualFinance>)c.ToList()));
+-->
+[!code-csharp[ConfigureValueObjectCollection](../../../samples/core/Modeling/ValueConversions/ValueObjectCollection.cs?name=ConfigureValueObjectCollection)]
+
+> [!NOTE]
+> As before, this conversion requires a <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ValueComparer`1>. See [Value Comparers](xref:core/modeling/value-comparers) for more information.
+
+### Value objects as keys
+
+Sometimes primitive key properties may be wrapped in value objects to add an additional level of type-safety in assigning values. For example, we could implement a key type for blogs, and a key type for posts:
+
+<!--
+        public readonly struct BlogKey
+        {
+            public BlogKey(int id) => Id = id;
+            public int Id { get; }
+        }
+
+        public readonly struct PostKey
+        {
+            public PostKey(int id) => Id = id;
+            public int Id { get; }
+        }
+-->
+[!code-csharp[KeyValueObjects](../../../samples/core/Modeling/ValueConversions/KeyValueObjects.cs?name=KeyValueObjects)]
+
+These can then be used in the domain model:
+
+<!--
+        public class Blog
+        {
+            public BlogKey Id { get; set; }
+            public string Name { get; set; }
+
+            public ICollection<Post> Posts { get; set; }
+        }
+
+        public class Post
+        {
+            public PostKey Id { get; set; }
+
+            public string Title { get; set; }
+            public string Content { get; set; }
+
+            public BlogKey? BlogId { get; set; }
+            public Blog Blog { get; set; }
+        }
+-->
+[!code-csharp[KeyValueObjectsModel](../../../samples/core/Modeling/ValueConversions/KeyValueObjects.cs?name=KeyValueObjectsModel)]
+
+Notice that `Blog.Id` cannot accidentally be assigned a `PostKey`, and `Post.Id` cannot accidentally be assigned a `BlogKey`. Similarly, the `Post.BlogId` foreign key property must be assigned a `BlogKey`.
+
+> [!NOTE]
+> Showing this pattern does not mean we recommend it. Carefully consider whether this level of abstraction is helping or hampering your development experience. Also, consider using navigations and generated keys instead of dealing with key values directly.
+
+These key properties can then be mapped using value converters:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                var blogKeyConverter = new ValueConverter<BlogKey, int>(
+                    v => v.Id,
+                    v => new BlogKey(v));
+
+                modelBuilder.Entity<Blog>().Property(e => e.Id).HasConversion(blogKeyConverter);
+
+                modelBuilder.Entity<Post>(
+                    b =>
+                        {
+                            b.Property(e => e.Id).HasConversion(v => v.Id, v => new PostKey(v));
+                            b.Property(e => e.BlogId).HasConversion(blogKeyConverter);
+                        });
+            }
+-->
+[!code-csharp[ConfigureKeyValueObjects](../../../samples/core/Modeling/ValueConversions/KeyValueObjects.cs?name=ConfigureKeyValueObjects)]
+
+> [!NOTE]
+> Key properties with conversions can only use generated key values starting with EF Core 7.0.
+
+### Use ulong for timestamp/rowversion
+
+SQL Server supports automatic [optimistic concurrency](xref:core/saving/concurrency) using [8-byte binary `rowversion`/`timestamp` columns](/sql/t-sql/data-types/rowversion-transact-sql). These are always read from and written to the database using an 8-byte array. However, byte arrays are a mutable reference type, which makes them somewhat painful to deal with. Value converters allow the `rowversion` to instead be mapped to a `ulong` property, which is much more appropriate and easy to use than the byte array. For example, consider a `Blog` entity with a ulong concurrency token:
+
+<!--
+        public class Blog
+        {
+            public int Id { get; set; }
+            public string Name { get; set; }
+            public ulong Version { get; set; }
+        }
+-->
+[!code-csharp[ULongConcurrencyModel](../../../samples/core/Modeling/ValueConversions/ULongConcurrency.cs?name=ULongConcurrencyModel)]
+
+This can be mapped to a SQL server `rowversion` column using a value converter:
+
+<!--
+                modelBuilder.Entity<Blog>()
+                    .Property(e => e.Version)
+                    .IsRowVersion()
+                    .HasConversion<byte[]>();
+-->
+[!code-csharp[ConfigureULongConcurrency](../../../samples/core/Modeling/ValueConversions/ULongConcurrency.cs?name=ConfigureULongConcurrency)]
+
+### Specify the DateTime.Kind when reading dates
+
+SQL Server discards the <xref:System.DateTime.Kind*?displayProperty=nameWithType> flag when storing a <xref:System.DateTime> as a [`datetime`](/sql/t-sql/data-types/datetime-transact-sql) or [`datetime2`](/sql/t-sql/data-types/datetime2-transact-sql). This means that DateTime values coming back from the database always have a <xref:System.DateTimeKind> of `Unspecified`.
+
+Value converters can be used in two ways to deal with this. First, EF Core has a value converter that creates an 8-byte opaque value which preserves the `Kind` flag. For example:
+
+<!--
+                modelBuilder.Entity<Post>()
+                    .Property(e => e.PostedOn)
+                    .HasConversion<long>();
+-->
+[!code-csharp[ConfigurePreserveDateTimeKind1](../../../samples/core/Modeling/ValueConversions/PreserveDateTimeKind.cs?name=ConfigurePreserveDateTimeKind1)]
+
+This allows DateTime values with different `Kind` flags to be mixed in the database.
+
+The problem with this approach is that the database no longer has recognizable `datetime` or `datetime2` columns. So instead it is common to always store UTC time (or, less commonly, always local time) and then either ignore the `Kind` flag or set it to the appropriate value using a value converter. For example, the converter below ensures that the `DateTime` value read from the database will have the <xref:System.DateTimeKind> `UTC`:
+
+<!--
+                modelBuilder.Entity<Post>()
+                    .Property(e => e.LastUpdated)
+                    .HasConversion(
+                        v => v,
+                        v => new DateTime(v.Ticks, DateTimeKind.Utc));
+-->
+[!code-csharp[ConfigurePreserveDateTimeKind2](../../../samples/core/Modeling/ValueConversions/PreserveDateTimeKind.cs?name=ConfigurePreserveDateTimeKind2)]
+
+If a mix of local and UTC values are being set in entity instances, then the converter can be used to convert appropriately before inserting. For example:
+
+<!--
+                modelBuilder.Entity<Post>()
+                    .Property(e => e.LastUpdated)
+                    .HasConversion(
+                        v => v.ToUniversalTime(),
+                        v => new DateTime(v.Ticks, DateTimeKind.Utc));
+-->
+[!code-csharp[ConfigurePreserveDateTimeKind3](../../../samples/core/Modeling/ValueConversions/PreserveDateTimeKind.cs?name=ConfigurePreserveDateTimeKind3)]
+
+> [!NOTE]
+> Carefully consider unifying all database access code to use UTC time all the time, only dealing with local time when presenting data to users.
+
+### Use case-insensitive string keys
+
+Some databases, including SQL Server, perform case-insensitive string comparisons by default. .NET, on the other hand, performs case-sensitive string comparisons by default. This means that a foreign key value like "DotNet" will match the primary key value "dotnet" on SQL Server, but will not match it in EF Core. A value comparer for keys can be used to force EF Core into case-insensitive string comparisons like in the database. For example, consider a blog/posts model with string keys:
+
+<!--
+        public class Blog
+        {
+            public string Id { get; set; }
+            public string Name { get; set; }
+
+            public ICollection<Post> Posts { get; set; }
+        }
+
+        public class Post
+        {
+            public string Id { get; set; }
+            public string Title { get; set; }
+            public string Content { get; set; }
+
+            public string BlogId { get; set; }
+            public Blog Blog { get; set; }
+        }
+-->
+[!code-csharp[CaseInsensitiveStringsModel](../../../samples/core/Modeling/ValueConversions/CaseInsensitiveStrings.cs?name=CaseInsensitiveStringsModel)]
+
+This will not work as expected if some of the `Post.BlogId` values have different casing. The errors caused by this will depend on what the application is doing, but typically involve graphs of objects that are not [fixed-up](xref:core/change-tracking/relationship-changes) correctly, and/or updates that fail because the FK value is wrong. A value comparer can be used to correct this:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                var comparer = new ValueComparer<string>(
+                    (l, r) => string.Equals(l, r, StringComparison.OrdinalIgnoreCase),
+                    v => v.ToUpper().GetHashCode(),
+                    v => v);
+
+                modelBuilder.Entity<Blog>()
+                    .Property(e => e.Id)
+                    .Metadata.SetValueComparer(comparer);
+
+                modelBuilder.Entity<Post>(
+                    b =>
+                        {
+                            b.Property(e => e.Id).Metadata.SetValueComparer(comparer);
+                            b.Property(e => e.BlogId).Metadata.SetValueComparer(comparer);
+                        });
+            }
+-->
+[!code-csharp[ConfigureCaseInsensitiveStrings](../../../samples/core/Modeling/ValueConversions/CaseInsensitiveStrings.cs?name=ConfigureCaseInsensitiveStrings)]
+
+> [!NOTE]
+> .NET string comparisons and database string comparisons can differ in more than just case sensitivity. This pattern works for simple ASCII keys, but may fail for keys with any kind of culture-specific characters. See [Collations and Case Sensitivity](xref:core/miscellaneous/collations-and-case-sensitivity) for more information.
+
+### Handle fixed-length database strings
+
+The previous example did not need a value converter. However, a converter can be useful for fixed-length database string types like `char(20)` or `nchar(20)`. Fixed-length strings are padded to their full length whenever a value is inserted into the database. This means that a key value of "`dotnet`" will be read back from the database as "`dotnet..............`", where `.` represents a space character. This will then not compare correctly with key values that are not padded.
+
+A value converter can be used to trim the padding when reading key values. This can be combined with the value comparer in the previous example to compare fixed length case-insensitive ASCII keys correctly. For example:
+
+<!--
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                var converter = new ValueConverter<string, string>(
+                    v => v,
+                    v => v.Trim());
+                
+                var comparer = new ValueComparer<string>(
+                    (l, r) => string.Equals(l, r, StringComparison.OrdinalIgnoreCase),
+                    v => v.ToUpper().GetHashCode(),
+                    v => v);
+
+                modelBuilder.Entity<Blog>()
+                    .Property(e => e.Id)
+                    .HasColumnType("char(20)")
+                    .HasConversion(converter, comparer);
+
+                modelBuilder.Entity<Post>(
+                    b =>
+                        {
+                            b.Property(e => e.Id).HasColumnType("char(20)").HasConversion(converter, comparer);
+                            b.Property(e => e.BlogId).HasColumnType("char(20)").HasConversion(converter, comparer);
+                        });
+            }
+-->
+[!code-csharp[ConfigureFixedLengthStrings](../../../samples/core/Modeling/ValueConversions/FixedLengthStrings.cs?name=ConfigureFixedLengthStrings)]
+
+### Encrypt property values
+
+Value converters can be used to encrypt property values before sending them to the database, and then decrypt them on the way out. For example, using string reversal as a substitute for a real encryption algorithm:
+
+<!--
+                modelBuilder.Entity<User>().Property(e => e.Password).HasConversion(
+                    v => new string(v.Reverse().ToArray()),
+                    v => new string(v.Reverse().ToArray()));
+-->
+[!code-csharp[ConfigureEncryptPropertyValues](../../../samples/core/Modeling/ValueConversions/EncryptPropertyValues.cs?name=ConfigureEncryptPropertyValues)]
+
+> [!NOTE]
+> There is currently no way to get a reference to the current DbContext, or other session state, from within a value converter. This limits the kinds of encryption that can be used. Vote for [GitHub issue #11597](https://github.com/dotnet/efcore/issues/12205) to have this limitation removed.
+
+> [!WARNING]
+> Make sure to understand all the implications if you roll your own encryption to protect sensitive data. Consider instead using pre-built encryption mechanisms, such as [Always Encrypted](/sql/relational-databases/security/encryption/always-encrypted-database-engine) on SQL Server.
+
+## Limitations
+
+There are a few known current limitations of the value conversion system:
+
+* As noted above, `null` cannot be converted. Please vote (👍) for [GitHub issue #13850](https://github.com/dotnet/efcore/issues/13850) if this is something you need.
+* It isn't possible to query into value-converted properties, e.g. reference members on the value-converted .NET type in your LINQ queries. Please vote (👍) for [GitHub issue #10434](https://github.com/dotnet/efcore/issues/10434) if this is something you need - but considering using a [JSON column](xref:core/what-is-new/ef-core-7.0/whatsnew#json-columns) instead.
+* There is currently no way to spread a conversion of one property to multiple columns or vice-versa. Please vote (👍) for [GitHub issue #13947](https://github.com/dotnet/efcore/issues/13947) if this is something you need.
+* Value generation is not supported for most keys mapped through value converters. Please vote (👍) for [GitHub issue #11597](https://github.com/dotnet/efcore/issues/11597) if this is something you need.
+* Value conversions cannot reference the current DbContext instance. Please vote (👍) for [GitHub issue #12205](https://github.com/dotnet/efcore/issues/12205) if this is something you need.
+* Parameters using value-converted types cannot currently be used in raw SQL APIs. Please vote (👍) for [GitHub issue #27534](https://github.com/dotnet/efcore/issues/27354) if this is something you need.
+
+Removal of these limitations is being considered for future releases.
diff --git a/entity-framework/core/performance/_static/actualexecplan.png b/entity-framework/core/performance/_static/actualexecplan.png
new file mode 100644
index 0000000000..ec3936f0eb
Binary files /dev/null and b/entity-framework/core/performance/_static/actualexecplan.png differ
diff --git a/entity-framework/core/performance/advanced-performance-topics.md b/entity-framework/core/performance/advanced-performance-topics.md
new file mode 100644
index 0000000000..6968e94cfa
--- /dev/null
+++ b/entity-framework/core/performance/advanced-performance-topics.md
@@ -0,0 +1,356 @@
+---
+title: Advanced Performance Topics - EF Core
+description: Advanced performance topics for Entity Framework Core
+author: roji
+ms.date: 11/21/2025
+uid: core/performance/advanced-performance-topics
+ms.custom: sfi-ropc-nochange
+---
+# Advanced Performance Topics
+
+## DbContext pooling
+
+A `DbContext` is generally a light object: creating and disposing one doesn't involve a database operation, and most applications can do so without any noticeable impact on performance. However, each context instance does set up various internal services and objects necessary for performing its duties, and the overhead of continuously doing so may be significant in high-performance scenarios. For these cases, EF Core can *pool* your context instances: when you dispose your context, EF Core resets its state and stores it in an internal pool; when a new instance is next requested, that pooled instance is returned instead of setting up a new one. Context pooling allows you to pay context setup costs only once at program startup, rather than continuously.
+
+Note that context pooling is orthogonal to database connection pooling, which is managed at a lower level in the database driver.
+
+### [With dependency injection](#tab/with-di)
+
+The typical pattern in an ASP.NET Core app using EF Core involves registering a custom <xref:Microsoft.EntityFrameworkCore.DbContext> type into the [dependency injection](/aspnet/core/fundamentals/dependency-injection) container via <xref:Microsoft.Extensions.DependencyInjection.EntityFrameworkServiceCollectionExtensions.AddDbContext*>. Then, instances of that type are obtained through constructor parameters in controllers or Razor Pages.
+
+To enable context pooling, simply replace `AddDbContext` with <xref:Microsoft.Extensions.DependencyInjection.EntityFrameworkServiceCollectionExtensions.AddDbContextPool*>:
+
+[!code-csharp[Main](../../../samples/core/Performance/AspNetContextPooling/Program.cs#AddDbContextPool)]
+
+The `poolSize` parameter of <xref:Microsoft.Extensions.DependencyInjection.EntityFrameworkServiceCollectionExtensions.AddDbContextPool*> sets the maximum number of instances retained by the pool (defaults to 1024). Once `poolSize` is exceeded, new context instances are not cached and EF falls back to the non-pooling behavior of creating instances on demand.
+
+### [Without dependency injection](#tab/without-di)
+
+To use context pooling without dependency injection, initialize a `PooledDbContextFactory` and request context instances from it:
+
+[!code-csharp[Main](../../../samples/core/Performance/Other/Program.cs#DbContextPoolingWithoutDI)]
+
+The `poolSize` parameter of the `PooledDbContextFactory` constructor sets the maximum number of instances retained by the pool (defaults to 1024). Once `poolSize` is exceeded, new context instances are not cached and EF falls back to the non-pooling behavior of creating instances on demand.
+
+***
+
+### Benchmarks
+
+Following are the benchmark results for fetching a single row from a SQL Server database running locally on the same machine, with and without context pooling. As always, results will change with the number of rows, the latency to your database server and other factors. Importantly, this benchmarks single-threaded pooling performance, while a real-world contended scenario may have different results; benchmark on your platform before making any decisions. [The source code is available here](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Benchmarks/ContextPooling.cs), feel free to use it as a basis for your own measurements.
+
+|                Method | NumBlogs |     Mean |    Error |   StdDev |   Gen 0 | Gen 1 | Gen 2 | Allocated |
+|---------------------- |--------- |---------:|---------:|---------:|--------:|------:|------:|----------:|
+| WithoutContextPooling |        1 | 701.6 us | 26.62 us | 78.48 us | 11.7188 |     - |     - |  50.38 KB |
+|    WithContextPooling |        1 | 350.1 us |  6.80 us | 14.64 us |  0.9766 |     - |     - |   4.63 KB |
+
+### Managing state in pooled contexts
+
+Context pooling works by reusing the same context instance across requests; this means that it's effectively registered as a [Singleton](/aspnet/core/fundamentals/dependency-injection#service-lifetimes), and the same instance is reused across multiple requests (or DI scopes). This means that special care must be taken when the context involves any state that may change between requests. Crucially, the context's `OnConfiguring` is only invoked once - when the instance context is first created - and so cannot be used to set state which needs to vary (e.g. a tenant ID).
+
+A typical scenario involving context state would be a multi-tenant ASP.NET Core application, where the context instance has a *tenant ID* which is taken into account by queries (see [Global Query Filters](xref:core/querying/filters) for more details). Since the tenant ID needs to change with each web request, we need to go through some extra steps to make it all work with context pooling.
+
+Let's assume that your application registers a scoped `ITenant` service, which wraps the tenant ID and any other tenant-related information:
+
+[!code-csharp[Main](../../../samples/core/Performance/AspNetContextPoolingWithState/Program.cs#TenantResolution)]
+
+As written above, pay special attention to where you get the tenant ID from - this is an important aspect of your application's security.
+
+Once we have our scoped `ITenant` service, register a pooling context factory as a Singleton service, as usual:
+
+[!code-csharp[Main](../../../samples/core/Performance/AspNetContextPoolingWithState/Program.cs#RegisterSingletonContextFactory)]
+
+Next, write a custom context factory which gets a pooled context from the Singleton factory we registered, and injects the tenant ID into context instances it hands out:
+
+[!code-csharp[Main](../../../samples/core/Performance/AspNetContextPoolingWithState/WeatherForecastScopedFactory.cs#WeatherForecastScopedFactory)]
+
+Once we have our custom context factory, register it as a Scoped service:
+
+[!code-csharp[Main](../../../samples/core/Performance/AspNetContextPoolingWithState/Program.cs#RegisterScopedContextFactory)]
+
+Finally, arrange for a context to get injected from our Scoped factory:
+
+[!code-csharp[Main](../../../samples/core/Performance/AspNetContextPoolingWithState/Program.cs#RegisterDbContext)]
+
+As this point, your controllers automatically get injected with a context instance that has the right tenant ID, without having to know anything about it.
+
+The full source code for this sample is available [here](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Performance/AspNetContextPoolingWithState).
+
+> [!NOTE]
+> Although EF Core takes care of resetting internal state for `DbContext` and its related services, it generally does not reset state in the underlying database driver, which is outside of EF. For example, if you manually open and use a `DbConnection` or otherwise manipulate ADO.NET state, it's up to you to restore that state before returning the context instance to the pool, e.g. by closing the connection. Failure to do so may cause state to get leaked across unrelated requests.
+
+### Connection Pooling Considerations
+
+With most databases, a long-lived connection is required for performing database operations, and such connections can be expensive to open and close. EF does not implement connection pooling itself, but relies on the underlying database driver (e.g. ADO.NET driver) for managing database connections. Connection pooling is a client-side mechanism that reuses existing database connections to reduce the overhead of opening and closing connections repeatedly. This mechanism is generally consistent across databases supported by EF, such as Azure SQL Database, PostgreSQL, and others., although factors specific to the database or environment, such as resource limits or service configurations, may affect pooling efficiency. Connection pooling is usually enabled by default, and any pooling configuration must be performed at the low-level driver level as documented by that driver; for example, when using ADO.NET, parameters such as minimum or maximum pool sizes are usually configured via the connection string.
+
+Connection pooling is completely orthogonal to EF's `DbContext` pooling, which is described above: while the low-level database driver pools database connections (to avoid the overhead of opening/closing connections), EF can pool context instances (to avoid context memory allocation and initialization overheads). Regardless of whether a context instance is pooled or not, EF generally opens connections just before each operation (e.g. query), and closes it right afterwards, causing it to be returned to the pool; this is done to avoid keeping connections out of the pool any longer than is necessary.
+
+## Compiled queries
+
+When EF receives a LINQ query tree for execution, it must first "compile" that tree, e.g. produce SQL from it. Because this task is a heavy process, EF caches queries by the query tree shape, so that queries with the same structure reuse internally-cached compilation outputs. This caching ensures that executing the same LINQ query multiple times is very fast, even if parameter values differ.
+
+However, EF must still perform certain tasks before it can make use of the internal query cache. For example, your query's expression tree must be recursively compared with the expression trees of cached queries, to find the correct cached query. The overhead for this initial processing is negligible in the majority of EF applications, especially when compared to other costs associated with query execution (network I/O, actual query processing and disk I/O at the database...). However, in certain high-performance scenarios it may be desirable to eliminate it.
+
+EF supports *compiled queries*, which allow the explicit compilation of a LINQ query into a .NET delegate. Once this delegate is acquired, it can be invoked directly to execute the query, without providing the LINQ expression tree. This technique bypasses the cache lookup, and provides the most optimized way to execute a query in EF Core. Following are some benchmark results comparing compiled and non-compiled query performance; benchmark on your platform before making any decisions. [The source code is available here](https://github.com/dotnet/EntityFramework.Docs/blob/main/samples/core/Benchmarks/CompiledQueries.cs), feel free to use it as a basis for your own measurements.
+
+|               Method | NumBlogs |     Mean |    Error |   StdDev |  Gen 0 | Allocated |
+|--------------------- |--------- |---------:|---------:|---------:|-------:|----------:|
+|    WithCompiledQuery |        1 | 564.2 us |  6.75 us |  5.99 us | 1.9531 |      9 KB |
+| WithoutCompiledQuery |        1 | 671.6 us | 12.72 us | 16.54 us | 2.9297 |     13 KB |
+|    WithCompiledQuery |       10 | 645.3 us | 10.00 us |  9.35 us | 2.9297 |     13 KB |
+| WithoutCompiledQuery |       10 | 709.8 us | 25.20 us | 73.10 us | 3.9063 |     18 KB |
+
+To use compiled queries, first compile a query with <xref:Microsoft.EntityFrameworkCore.EF.CompileAsyncQuery*?displayProperty=nameWithType> as follows (use <xref:Microsoft.EntityFrameworkCore.EF.CompileQuery*?displayProperty=nameWithType> for synchronous queries):
+
+[!code-csharp[Main](../../../samples/core/Performance/Other/Program.cs#CompiledQueryCompile)]
+
+In this code sample, we provide EF with a lambda accepting a `DbContext` instance, and an arbitrary parameter to be passed to the query. You can now invoke that delegate whenever you wish to execute the query:
+
+[!code-csharp[Main](../../../samples/core/Performance/Other/Program.cs#CompiledQueryExecute)]
+
+Note that the delegate is thread-safe, and can be invoked concurrently on different context instances.
+
+### Limitations
+
+* Compiled queries may only be used against a single EF Core model. Different context instances of the same type can sometimes be configured to use different models; running compiled queries in this scenario is not supported.
+* When using parameters in compiled queries, use simple, scalar parameters. More complex parameter expressions - such as member/method accesses on instances - are not supported.
+
+## Query caching and parameterization
+
+When EF receives a LINQ query tree for execution, it must first "compile" that tree, e.g. produce SQL from it. Because this task is a heavy process, EF caches queries by the query tree shape, so that queries with the same structure reuse internally-cached compilation outputs. This caching ensures that executing the same LINQ query multiple times is very fast, even if parameter values differ.
+
+Consider the following two queries:
+
+[!code-csharp[Main](../../../samples/core/Performance/Other/Program.cs#QueriesWithConstants)]
+
+Since the expression trees contains different constants, the expression tree differs and each of these queries will be compiled separately by EF Core. In addition, each query produces a slightly different SQL command:
+
+```sql
+SELECT TOP(1) [b].[Id], [b].[Name]
+FROM [Posts] AS [b]
+WHERE [b].[Name] = N'post1'
+
+SELECT TOP(1) [b].[Id], [b].[Name]
+FROM [Posts] AS [b]
+WHERE [b].[Name] = N'post2'
+```
+
+Because the SQL differs, your database server will likely also need to produce a query plan for both queries, rather than reusing the same plan.
+
+A small modification to your queries can change things considerably:
+
+[!code-csharp[Main](../../../samples/core/Performance/Other/Program.cs#QueriesWithParameterization)]
+
+Since the blog name is now *parameterized*, both queries have the same tree shape, and EF only needs to be compiled once. The SQL produced is also parameterized, allowing the database to reuse the same query plan:
+
+```sql
+SELECT TOP(1) [b].[Id], [b].[Name]
+FROM [Posts] AS [b]
+WHERE [b].[Name] = @__postTitle_0
+```
+
+Note that there is no need to parameterize each and every query: it's perfectly fine to have some queries with constants, and indeed, databases (and EF) can sometimes perform certain optimization around constants which aren't possible when the query is parameterized. See the section on [dynamically-constructed queries](#dynamically-constructed-queries) for an example where proper parameterization is crucial.
+
+> [!NOTE]
+> EF Core's [metrics](xref:core/logging-events-diagnostics/metrics) report the Query Cache Hit Rate. In a normal application, this metric reaches 100% soon after program startup, once most queries have executed at least once. If this metric remains stable below 100%, that is an indication that your application may be doing something which defeats the query cache - it's a good idea to investigate that.
+>
+> [!TIP]
+> EF Core uses `IMemoryCache` for internal caching of compiled queries and models. You can configure the cache size limit if needed - see [Memory Cache Integration](#memory-cache-integration) for more information.
+
+> [!NOTE]
+> How the database manages caches query plans is database-dependent. For example, SQL Server implicitly maintains an LRU query plan cache, whereas PostgreSQL does not (but prepared statements can produce a very similar end effect). Consult your database documentation for more details.
+
+## Dynamically-constructed queries
+
+In some situations, it is necessary to dynamically construct LINQ queries rather than specifying them outright in source code. This can happen, for example, in a website which receives arbitrary query details from a client, with open-ended query operators (sorting, filtering, paging...). In principle, if done correctly, dynamically-constructed queries can be just as efficient as regular ones (although it's not possible to use the compiled query optimization with dynamic queries). In practice, however, they are frequently the source of performance issues, since it's easy to accidentally produce expression trees with shapes that differ every time.
+
+The following example uses three techniques to construct a query's `Where` lambda expression:
+
+1. **Expression API with constant**: Dynamically build the expression with the Expression API, using a constant node. This is a frequent mistake when dynamically building expression trees, and causes EF to recompile the query each time it's invoked with a different constant value (it also usually causes plan cache pollution at the database server).
+2. **Expression API with parameter**: A better version, which substitutes the constant with a parameter. This ensures that the query is only compiled once regardless of the value provided, and the same (parameterized) SQL is generated.
+3. **Simple with parameter**: A version which doesn't use the Expression API, for comparison, which creates the same tree as the method above but is much simpler. In many cases, it's possible to dynamically build your expression tree without resorting to the Expression API, which is easy to get wrong.
+
+We add a `Where` operator to the query only if the given parameter is not null. Note that this isn't a good use case for dynamically constructing a query - but we're using it for simplicity:
+
+### [Expression API with constant](#tab/expression-api-with-constant)
+
+[!code-csharp[Main](../../../samples/core/Benchmarks/DynamicallyConstructedQueries.cs?name=ExpressionApiWithConstant&highlight=11-18)]
+
+### [Expression API with parameter](#tab/expression-api-with-parameter)
+
+[!code-csharp[Main](../../../samples/core/Benchmarks/DynamicallyConstructedQueries.cs?name=ExpressionApiWithParameter&highlight=11-26)]
+
+### [Simple with parameter](#tab/simple-with-parameter)
+
+[!code-csharp[Main](../../../samples/core/Benchmarks/DynamicallyConstructedQueries.cs?name=SimpleWithParameter&highlight=12)]
+
+***
+
+Benchmarking these two techniques gives the following results:
+
+|                     Method |       Mean |    Error |   StdDev |    Gen0 |   Gen1 | Allocated |
+|--------------------------- |-----------:|---------:|---------:|--------:|-------:|----------:|
+|  ExpressionApiWithConstant | 1,665.8 us | 56.99 us | 163.5 us | 15.6250 |      - | 109.92 KB |
+| ExpressionApiWithParameter |   757.1 us | 35.14 us | 103.6 us | 12.6953 | 0.9766 |  54.95 KB |
+|        SimpleWithParameter |   760.3 us | 37.99 us | 112.0 us | 12.6953 |      - |  55.03 KB |
+
+Even if the sub-millisecond difference seems small, keep in mind that the constant version continuously pollutes the cache and causes other queries to be re-compiled, slowing them down as well and having a general negative impact on your overall performance. It's highly recommended to avoid constant query recompilation.
+
+> [!NOTE]
+> Avoid constructing queries with the expression tree API unless you really need to. Aside from the API's complexity, it's very easy to inadvertently cause significant performance issues when using them.
+
+## Compiled models
+
+Compiled models can improve EF Core startup time for applications with large models. A large model typically means hundreds to thousands of entity types and relationships. Startup time here is the time to perform the first operation on a `DbContext` when that `DbContext` type is used for the first time in the application. Note that just creating a `DbContext` instance does not cause the EF model to be initialized. Instead, typical first operations that cause the model to be initialized include calling `DbContext.Add` or executing the first query.
+
+Compiled models are created using the `dotnet ef` command-line tool. Ensure that you have [installed the latest version of the tool](xref:core/cli/dotnet#installing-the-tools) before continuing.
+
+A new `dbcontext optimize` command is used to generate the compiled model. For example:
+
+```dotnetcli
+dotnet ef dbcontext optimize
+```
+
+The `--output-dir` and `--namespace` options can be used to specify the directory and namespace into which the compiled model will be generated. For example:
+
+```dotnetcli
+PS C:\dotnet\efdocs\samples\core\Miscellaneous\CompiledModels> dotnet ef dbcontext optimize --output-dir MyCompiledModels --namespace MyCompiledModels
+Build started...
+Build succeeded.
+Successfully generated a compiled model, to use it call 'options.UseModel(MyCompiledModels.BlogsContextModel.Instance)'. Run this command again when the model is modified.
+PS C:\dotnet\efdocs\samples\core\Miscellaneous\CompiledModels>
+```
+
+* For more information see [`dotnet ef dbcontext optimize`](xref:core/cli/dotnet#dotnet-ef-dbcontext-optimize).
+* If you're more comfortable working inside Visual Studio, you can also use [Optimize-DbContext](xref:core/cli/powershell#optimize-dbcontext)
+
+The output from running this command includes a piece of code to copy-and-paste into your `DbContext` configuration to cause EF Core to use the compiled model. For example:
+
+```csharp
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    => optionsBuilder
+        .UseModel(MyCompiledModels.BlogsContextModel.Instance)
+        .UseSqlite(@"Data Source=test.db");
+```
+
+### Compiled model bootstrapping
+
+It is typically not necessary to look at the generated bootstrapping code. However, sometimes it can be useful to customize the model or its loading. The bootstrapping code looks something like this:
+
+<!--
+[DbContext(typeof(BlogsContext))]
+partial class BlogsContextModel : RuntimeModel
+{
+    private static BlogsContextModel _instance;
+    public static IModel Instance
+    {
+        get
+        {
+            if (_instance == null)
+            {
+                _instance = new BlogsContextModel();
+                _instance.Initialize();
+                _instance.Customize();
+            }
+
+            return _instance;
+        }
+    }
+
+    partial void Initialize();
+
+    partial void Customize();
+}
+-->
+[!code-csharp[RuntimeModel](../../../samples/core/Miscellaneous/CompiledModels/SingleRuntimeModel.cs?name=RuntimeModel)]
+
+This is a partial class with partial methods that can be implemented to customize the model as needed.
+
+In addition, multiple compiled models can be generated for `DbContext` types that may use different models depending on some runtime configuration. These should be placed into different folders and namespaces, as shown above. Runtime information, such as the connection string, can then be examined and the correct model returned as needed. For example:
+
+<!--
+public static class RuntimeModelCache
+{
+    private static readonly ConcurrentDictionary<string, IModel> _runtimeModels
+        = new();
+
+    public static IModel GetOrCreateModel(string connectionString)
+        => _runtimeModels.GetOrAdd(
+            connectionString, cs =>
+                {
+                    if (cs.Contains("X"))
+                    {
+                        return BlogsContextModel1.Instance;
+                    }
+
+                    if (cs.Contains("Y"))
+                    {
+                        return BlogsContextModel2.Instance;
+                    }
+
+                    throw new InvalidOperationException("No appropriate compiled model found.");
+                });
+}
+-->
+[!code-csharp[RuntimeModelCache](../../../samples/core/Miscellaneous/CompiledModels/MultipleRuntimeModels.cs?name=RuntimeModelCache)]
+
+### Limitations
+
+Compiled models have some limitations:
+
+* [Global query filters are not supported](https://github.com/dotnet/efcore/issues/24897).
+* [Lazy loading and change-tracking proxies are not supported](https://github.com/dotnet/efcore/issues/24902).
+* Value converters that reference private methods are not supported. Make referenced methods public or internal instead.
+* [The model must be manually synchronized by regenerating it any time the model definition or configuration change](https://github.com/dotnet/efcore/issues/24894).
+* Custom IModelCacheKeyFactory implementations are not supported. However, you can compile multiple models and load the appropriate one as needed.
+
+Because of these limitations, you should only use compiled models if your EF Core startup time is too slow. Compiling small models is typically not worth it.
+
+If supporting any of these features is critical to your success, then please vote for the appropriate issues linked above.
+
+### Handling compilation errors due to ambiguous type references
+
+When compiling models with types that have the same name but exist in different namespaces, the generated code may produce compilation errors due to ambiguous type references. To resolve this, you can customize the code generation to use fully-qualified type names by overriding `CSharpHelper.ShouldUseFullName` to return `true`. See [Design-time services](xref:core/cli/services) for information on how to override design-time services like `ICSharpHelper`.
+
+## Reducing runtime overhead
+
+As with any layer, EF Core adds a bit of runtime overhead compared to coding directly against lower-level database APIs. This runtime overhead is unlikely to impact most real-world applications in a significant way; the other topics in this performance guide, such as query efficiency, index usage and minimizing roundtrips, are far more important. In addition, even for highly-optimized applications, network latency and database I/O will usually dominate any time spent inside EF Core itself. However, for high-performance, low-latency applications where every bit of perf is important, the following recommendations can be used to reduce EF Core overhead to a minimum:
+
+* Turn on [DbContext pooling](#dbcontext-pooling); our benchmarks show that this feature can have a decisive impact on high-perf, low-latency applications.
+  * Make sure that the `maxPoolSize` corresponds to your usage scenario; if it is too low, `DbContext` instances will be constantly created and disposed, degrading performance. Setting it too high may needlessly consume memory as unused `DbContext` instances are maintained in the pool.
+  * For an extra tiny perf boost, consider using `PooledDbContextFactory` instead of having DI inject context instances directly. DI management of `DbContext` pooling incurs a slight overhead.
+* Use precompiled queries for hot queries.
+  * The more complex the LINQ query - the more operators it contains and the bigger the resulting expression tree - the more gains can be expected from using compiled queries.
+* Consider disabling thread safety checks by setting `EnableThreadSafetyChecks` to false in your context configuration.
+  * Using the same `DbContext` instance concurrently from different threads isn't supported. EF Core has a safety feature which detects this programming bug in many cases (but not all), and immediately throws an informative exception. However, this safety feature adds some runtime overhead.
+  * **WARNING:** Only disable thread safety checks after thoroughly testing that your application doesn't contain such concurrency bugs.
+
+## Memory Cache Integration
+
+EF Core uses `IMemoryCache` for internal caching operations such as query compilation and model building. By default, EF Core configures its own `IMemoryCache` with a size limit of 10240. For reference, a compiled query has a cache size of 10, while the built model has a cache size of 100.
+
+If you need to change the default cache size limit, use <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseMemoryCache*> to provide a custom `IMemoryCache` instance:
+
+```csharp
+var memoryCache = new MemoryCache(new MemoryCacheOptions { SizeLimit = 20480 });
+services.AddSingleton<IDisposable>(memoryCache);
+
+services.AddDbContext<ApplicationDbContext>(options =>
+{
+    options.UseMemoryCache(memoryCache);
+    options.UseSqlServer(connectionString);
+});
+```
+
+The `MemoryCache` instance is registered as `IDisposable` so that it will be disposed when the service provider is disposed, without replacing the app-wide `IMemoryCache`.
+
+Alternatively, if you register a custom `IMemoryCache` via `AddMemoryCache` in DI, you can resolve it from the service provider. Note that this shares the cache between EF Core and any other services that use `IMemoryCache`, so the size limit should account for all consumers. When a `SizeLimit` is set, all cache entries from every consumer must specify a size; otherwise `IMemoryCache` will throw when entries are added:
+
+```csharp
+services.AddMemoryCache(options => options.SizeLimit = 20480);
+
+services.AddDbContext<ApplicationDbContext>((serviceProvider, options) =>
+{
+    options.UseMemoryCache(serviceProvider.GetRequiredService<IMemoryCache>());
+    options.UseSqlServer(connectionString);
+});
+```
diff --git a/entity-framework/core/performance/efficient-querying.md b/entity-framework/core/performance/efficient-querying.md
new file mode 100644
index 0000000000..b2af305d6b
--- /dev/null
+++ b/entity-framework/core/performance/efficient-querying.md
@@ -0,0 +1,218 @@
+---
+title: Efficient Querying - EF Core
+description: Performance guide for efficient querying using Entity Framework Core
+author: roji
+ms.date: 10/1/2021
+uid: core/performance/efficient-querying
+---
+# Efficient Querying
+
+Querying efficiently is a vast subject, that covers subjects as wide-ranging as indexes, related entity loading strategies, and many others. This section details some common themes for making your queries faster, and pitfalls users typically encounter.
+
+## Use indexes properly
+
+The main deciding factor in whether a query runs fast or not is whether it will properly utilize indexes where appropriate: databases are typically used to hold large amounts of data, and queries which traverse entire tables are typically sources of serious performance issues. Indexing issues aren't easy to spot, because it isn't immediately obvious whether a given query will use an index or not. For example:
+
+[!code-csharp[Main](../../../samples/core/Performance/Other/Program.cs#Indexes)]
+
+A good way to spot indexing issues is to first pinpoint a slow query, and then examine its query plan via your database's favorite tool; see the [performance diagnosis](xref:core/performance/performance-diagnosis) page for more information on how to do that. The query plan displays whether the query traverses the entire table, or uses an index.
+
+As a general rule, there isn't any special EF knowledge to using indexes or diagnosing performance issues related to them; general database knowledge related to indexes is just as relevant to EF applications as to applications not using EF. The following lists some general guidelines to keep in mind when using indexes:
+
+* While indexes speed up queries, they also slow down updates since they need to be kept up-to-date. Avoid defining indexes which aren't needed, and consider using [index filters](xref:core/modeling/indexes#index-filter) to limit the index to a subset of the rows, thereby reducing this overhead.
+* Composite indexes can speed up queries which filter on multiple columns, but they can also speed up queries which don't filter on all the index's columns - depending on ordering. For example, an index on columns A and B speeds up queries filtering by A and B as well as queries filtering only by A, but it does not speed up queries only filtering over B.
+* If a query filters by an expression over a column (e.g. `price / 2`), a simple index cannot be used. However, you can define a [stored persisted column](xref:core/modeling/generated-properties#computed-columns) for your expression, and create an index over that. Some databases also support expression indexes, which can be directly used to speed up queries filtering by any expression.
+* Different databases allow indexes to be configured in various ways, and in many cases EF Core providers expose these via the Fluent API. For example, the SQL Server provider allows you to configure whether an index is [clustered](xref:core/providers/sql-server/indexes#clustering), or set its [fill factor](xref:core/providers/sql-server/indexes#fill-factor). Consult your provider's documentation for more information.
+
+## Project only properties you need
+
+EF Core makes it very easy to query out entity instances, and then use those instances in code. However, querying entity instances can frequently pull back more data than necessary from your database. Consider the following:
+
+[!code-csharp[Main](../../../samples/core/Performance/Other/Program.cs#ProjectEntities)]
+
+Although this code only actually needs each Blog's `Url` property, the entire Blog entity is fetched, and unneeded columns are transferred from the database:
+
+```sql
+SELECT [b].[BlogId], [b].[CreationDate], [b].[Name], [b].[Rating], [b].[Url]
+FROM [Blogs] AS [b]
+```
+
+This can be optimized by using `Select` to tell EF which columns to project out:
+
+[!code-csharp[Main](../../../samples/core/Performance/Other/Program.cs#ProjectSingleProperty)]
+
+The resulting SQL pulls back only the needed columns:
+
+```sql
+SELECT [b].[Url]
+FROM [Blogs] AS [b]
+```
+
+If you need to project out more than one column, project out to a C# anonymous type with the properties you want.
+
+Note that this technique is very useful for read-only queries, but things get more complicated if you need to *update* the fetched blogs, since EF's change tracking only works with entity instances. It's possible to perform updates without loading entire entities by attaching a modified Blog instance and telling EF which properties have changed, but that is a more advanced technique that may not be worth it.
+
+## Limit the resultset size
+
+By default, a query returns all rows that matches its filters:
+
+[!code-csharp[Main](../../../samples/core/Performance/Other/Program.cs#NoLimit)]
+
+Since the number of rows returned depends on actual data in your database, it's impossible to know how much data will be loaded from the database, how much memory will be taken up by the results, and how much additional load will be generated when processing these results (e.g. by sending them to a user browser over the network). Crucially, test databases frequently contain little data, so that everything works well while testing, but performance problems suddenly appear when the query starts running on real-world data and many rows are returned.
+
+As a result, it's usually worth giving thought to limiting the number of results:
+
+[!code-csharp[Main](../../../samples/core/Performance/Other/Program.cs#Limit25)]
+
+At a minimum, your UI could show a message indicating that more rows may exist in the database (and allow retrieving them in some other manner). A full-blown solution would implement *pagination*, where your UI only shows a certain number of rows at a time, and allow users to advance to the next page as needed; see the next section for more details on how to implement this efficiently.
+
+## Efficient pagination
+
+Pagination refers to retrieving results in pages, rather than all at once; this is typically done for large resultsets, where a user interface is shown that allows the user to navigate to the next or previous page of the results. A common way to implement pagination with databases is to use the `Skip` and `Take` operators (`OFFSET` and `LIMIT` in SQL); while this is an intuitive implementation, it's also quite inefficient. For pagination that allows moving one page at a time (as opposed to jumping to arbitrary pages), consider using *keyset pagination* instead.
+
+For more information, [see the documentation page on pagination](xref:core/querying/pagination).
+
+## Avoid cartesian explosion when loading related entities
+
+In relational databases, all related entities are loaded by introducing JOINs in single query.
+
+```sql
+SELECT [b].[BlogId], [b].[OwnerId], [b].[Rating], [b].[Url], [p].[PostId], [p].[AuthorId], [p].[BlogId], [p].[Content], [p].[Rating], [p].[Title]
+FROM [Blogs] AS [b]
+LEFT JOIN [Post] AS [p] ON [b].[BlogId] = [p].[BlogId]
+ORDER BY [b].[BlogId], [p].[PostId]
+```
+
+If a typical blog has multiple related posts, rows for these posts will duplicate the blog's information. This duplication leads to the so-called "cartesian explosion" problem. As more one-to-many relationships are loaded, the amount of duplicated data may grow and adversely affect the performance of your application.
+
+EF allows avoiding this effect via the use of "split queries", which load the related entities via separate queries. For more information, read [the documentation on split and single queries](xref:core/querying/single-split-queries).
+
+> [!NOTE]
+> The current implementation of [split queries](xref:core/querying/single-split-queries) executes a roundtrip for each query. We plan to improve this in the future, and execute all queries in a single roundtrip.
+
+## Load related entities eagerly when possible
+
+It's recommended to read [the dedicated page on related entities](xref:core/querying/related-data) before continuing with this section.
+
+When dealing with related entities, we usually know in advance what we need to load: a typical example would be loading a certain set of Blogs, along with all their Posts. In these scenarios, it is always better to use [eager loading](xref:core/querying/related-data/eager), so that EF can fetch all the required data in one roundtrip. The [filtered include](xref:core/querying/related-data/eager#filtered-include) feature also allows you to limit which related entities you'd like to load, while keeping the loading process eager and therefore doable in a single roundtrip:
+
+[!code-csharp[Main](../../../samples/core/Querying/RelatedData/Program.cs#FilteredInclude)]
+
+In other scenarios, we may not know which related entity we're going to need before we get its principal entity. For example, when loading some Blog, we may need to consult some other data source - possibly a webservice - in order to know whether we're interested in that Blog's Posts. In these cases, [explicit](xref:core/querying/related-data/explicit) or [lazy](xref:core/querying/related-data/lazy) loading can be used to fetch related entities separately, and populate the Blog's Posts navigation. Note that since these methods aren't eager, they require additional roundtrips to the database, which is source of slowdown; depending on your specific scenario, it may be more efficient to just always load all Posts, rather than to execute the additional roundtrips and selectively get only the Posts you need.
+
+### Beware of lazy loading
+
+[Lazy loading](xref:core/querying/related-data/lazy) often seems like a very useful way to write database logic, since EF Core automatically loads related entities from the database as they are accessed by your code. This avoids loading related entities that aren't needed (like [explicit loading](xref:core/querying/related-data/explicit)), and seemingly frees the programmer from having to deal with related entities altogether. However, lazy loading is particularly prone for producing unneeded extra roundtrips which can slow the application.
+
+Consider the following:
+
+[!code-csharp[Main](../../../samples/core/Performance/Other/Program.cs#NPlusOne)]
+
+This seemingly innocent piece of code iterates through all the blogs and their posts, printing them out. Turning on EF Core's [statement logging](xref:core/logging-events-diagnostics/index) reveals the following:
+
+```console
+info: Microsoft.EntityFrameworkCore.Database.Command[20101]
+      Executed DbCommand (1ms) [Parameters=[], CommandType='Text', CommandTimeout='30']
+      SELECT [b].[BlogId], [b].[Rating], [b].[Url]
+      FROM [Blogs] AS [b]
+info: Microsoft.EntityFrameworkCore.Database.Command[20101]
+      Executed DbCommand (5ms) [Parameters=[@__p_0='1'], CommandType='Text', CommandTimeout='30']
+      SELECT [p].[PostId], [p].[BlogId], [p].[Content], [p].[Title]
+      FROM [Post] AS [p]
+      WHERE [p].[BlogId] = @__p_0
+info: Microsoft.EntityFrameworkCore.Database.Command[20101]
+      Executed DbCommand (1ms) [Parameters=[@__p_0='2'], CommandType='Text', CommandTimeout='30']
+      SELECT [p].[PostId], [p].[BlogId], [p].[Content], [p].[Title]
+      FROM [Post] AS [p]
+      WHERE [p].[BlogId] = @__p_0
+info: Microsoft.EntityFrameworkCore.Database.Command[20101]
+      Executed DbCommand (1ms) [Parameters=[@__p_0='3'], CommandType='Text', CommandTimeout='30']
+      SELECT [p].[PostId], [p].[BlogId], [p].[Content], [p].[Title]
+      FROM [Post] AS [p]
+      WHERE [p].[BlogId] = @__p_0
+
+... and so on
+```
+
+What's going on here? Why are all these queries being sent for the simple loops above? With lazy loading, a Blog's Posts are only (lazily) loaded when its Posts property is accessed; as a result, each iteration in the inner foreach triggers an additional database query, in its own roundtrip. As a result, after the initial query loading all the blogs, we then have another query *per blog*, loading all its posts; this is sometimes called the *N+1* problem, and it can cause very significant performance issues.
+
+Assuming we're going to need all of the blogs' posts, it makes sense to use eager loading here instead. We can use the [Include](xref:core/querying/related-data/eager#eager-loading) operator to perform the loading, but since we only need the Blogs' URLs (and we should only [load what's needed](xref:core/performance/efficient-querying#project-only-properties-you-need)). So we'll use a projection instead:
+
+[!code-csharp[Main](../../../samples/core/Performance/Other/Program.cs#EagerlyLoadRelatedAndProject)]
+
+This will make EF Core fetch all the Blogs - along with their Posts - in a single query. In some cases, it may also be useful to avoid cartesian explosion effects by using [split queries](xref:core/querying/single-split-queries).
+
+> [!WARNING]
+> Because lazy loading makes it extremely easy to inadvertently trigger the N+1 problem, it is recommended to avoid it. Eager or explicit loading make it very clear in the source code when a database roundtrip occurs.
+
+## Buffering and streaming
+
+Buffering refers to loading all your query results into memory, whereas streaming means that EF hands the application a single result each time, never containing the entire resultset in memory. In principle, the memory requirements of a streaming query are fixed - they are the same whether the query returns 1 row or 1000; a buffering query, on the other hand, requires more memory the more rows are returned. For queries that produce large resultsets, this can be an important performance factor.
+
+Whether a query buffers or streams depends on how it is evaluated:
+
+[!code-csharp[Main](../../../samples/core/Performance/Other/Program.cs#BufferingAndStreaming)]
+
+If your queries return just a few results, then you probably don't have to worry about this. However, if your query might return large numbers of rows, it's worth giving thought to streaming instead of buffering.
+
+> [!NOTE]
+> Avoid using <xref:System.Linq.Enumerable.ToList*> or <xref:System.Linq.Enumerable.ToArray*> if you intend to use another LINQ operator on the result - this will needlessly buffer all results into memory. Use <xref:System.Linq.Enumerable.AsEnumerable*> instead.
+
+### Internal buffering by EF
+
+In certain situations, EF will itself buffer the resultset internally, regardless of how you evaluate your query. The two cases where this happens are:
+
+* When a retrying execution strategy is in place. This is done to make sure the same results are returned if the query is retried later.
+* When [split query](xref:core/querying/single-split-queries) is used, the resultsets of all but the last query are buffered - unless MARS (Multiple Active Result Sets) is enabled on SQL Server. This is because it is usually impossible to have multiple query resultsets active at the same time.
+
+Note that this internal buffering occurs in addition to any buffering you cause via LINQ operators. For example, if you use <xref:System.Linq.Enumerable.ToList*> on a query and a retrying execution strategy is in place, the resultset is loaded into memory *twice*: once internally by EF, and once by <xref:System.Linq.Enumerable.ToList*>.
+
+## Tracking, no-tracking and identity resolution
+
+It's recommended to read [the dedicated page on tracking and no-tracking](xref:core/querying/tracking) before continuing with this section.
+
+EF tracks entity instances by default, so that changes on them are detected and persisted when <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*> is called. Another effect of tracking queries is that EF detects if an instance has already been loaded for your data, and will automatically return that tracked instance rather than returning a new one; this is called *identity resolution*. From a performance perspective, change tracking means the following:
+
+* EF internally maintains a dictionary of tracked instances. When new data is loaded, EF checks the dictionary to see if an instance is already tracked for that entity's key (identity resolution). The dictionary maintenance and lookups take up some time when loading the query's results.
+* Before handing a loaded instance to the application, EF *snapshots* that instance and keeps the snapshot internally. When <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*> is called, the application's instance is compared with the snapshot to discover the changes to be persisted. The snapshot takes up more memory, and the snapshotting process itself takes time; it's sometimes possible to specify different, possibly more efficient snapshotting behavior via [value comparers](xref:core/modeling/value-comparers), or to use change-tracking proxies to bypass the snapshotting process altogether (though that comes with its own set of disadvantages).
+
+In read-only scenarios where changes aren't saved back to the database, the above overheads can be avoided by using [no-tracking queries](xref:core/querying/tracking#no-tracking-queries). However, since no-tracking queries do not perform identity resolution, a database row which is referenced by multiple other loaded rows will be materialized as different instances.
+
+To illustrate, assume we are loading a large number of Posts from the database, as well as the Blog referenced by each Post. If 100 Posts happen to reference the same Blog, a tracking query detects this via identity resolution, and all Post instances will refer the same de-duplicated Blog instance. A no-tracking query, in contrast, duplicates the same Blog 100 times - and application code must be written accordingly.
+
+Here are the results for a benchmark comparing tracking vs. no-tracking behavior for a query loading 10 Blogs with 20 Posts each. [The source code is available here](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Benchmarks/QueryTrackingBehavior.cs), feel free to use it as a basis for your own measurements.
+
+|       Method | NumBlogs | NumPostsPerBlog |       Mean |    Error |   StdDev |     Median | Ratio | RatioSD |   Gen 0 |   Gen 1 | Gen 2 | Allocated |
+|------------- |--------- |---------------- |-----------:|---------:|---------:|-----------:|------:|--------:|--------:|--------:|------:|----------:|
+|   AsTracking |       10 |              20 | 1,414.7 us | 27.20 us | 45.44 us | 1,405.5 us |  1.00 |    0.00 | 60.5469 | 13.6719 |     - | 380.11 KB |
+| AsNoTracking |       10 |              20 |   993.3 us | 24.04 us | 65.40 us |   966.2 us |  0.71 |    0.05 | 37.1094 |  6.8359 |     - | 232.89 KB |
+
+Finally, it is possible to perform updates without the overhead of change tracking, by utilizing a no-tracking query and then attaching the returned instance to the context, specifying which changes are to be made. This transfers the burden of change tracking from EF to the user, and should only be attempted if the change tracking overhead has been shown to be unacceptable via profiling or benchmarking.
+
+## Using SQL queries
+
+In some cases, more optimized SQL exists for your query, which EF does not generate. This can happen when the SQL construct is an extension specific to your database that's unsupported, or simply because EF does not translate to it yet. In these cases, writing SQL by hand can provide a substantial performance boost, and EF supports several ways to do this.
+
+* Use SQL queries [directly in your query](xref:core/querying/sql-queries), e.g. via <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.FromSqlRaw*>. EF even lets you compose over the SQL with regular LINQ queries, allowing you to express only a part of the query in SQL. This is a good technique when the SQL only needs to be used in a single query in your codebase.
+* Define a [user-defined function](xref:core/querying/database-functions) (UDF), and then call that from your queries. Note that EF allows UDFs to return full resultsets - these are known as table-valued functions (TVFs) - and also allows mapping a `DbSet` to a function, making it look just like just another table.
+* Define a database view and query from it in your queries. Note that unlike functions, views cannot accept parameters.
+
+> [!NOTE]
+> Raw SQL should generally be used as a last resort, after making sure that EF can't generate the SQL you want, and when performance is important enough for the given query to justify it. Using raw SQL brings considerable maintenance disadvantages.
+
+## Asynchronous programming
+
+As a general rule, in order for your application to be scalable, it's important to always use asynchronous APIs rather than synchronous one (e.g. <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChangesAsync*> rather than <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*>). Synchronous APIs block the thread for the duration of database I/O, increasing the need for threads and the number of thread context switches that must occur.
+
+For more information, see the page on [async programming](xref:core/miscellaneous/async).
+
+> [!WARNING]
+> Avoid mixing synchronous and asynchronous code in the same application - it's very easy to inadvertently trigger subtle thread-pool starvation issues.
+
+> [!WARNING]
+> The async implementation of [Microsoft.Data.SqlClient](https://github.com/dotnet/SqlClient) unfortunately has some known issues (e.g. [#593](https://github.com/dotnet/SqlClient/issues/593), [#601](https://github.com/dotnet/SqlClient/issues/601), and others). If you're seeing unexpected performance problems, try using sync command execution instead, especially when dealing with large text or binary values.
+
+## Additional resources
+
+* See the [advanced performance topics page](xref:core/performance/advanced-performance-topics) for additional topics related to efficient querying.
+* See the [performance section](xref:core/querying/null-comparisons#writing-performant-queries) of the null comparison documentation page for some best practices when comparing nullable values.
diff --git a/entity-framework/core/performance/efficient-updating.md b/entity-framework/core/performance/efficient-updating.md
new file mode 100644
index 0000000000..7a2a6c4f81
--- /dev/null
+++ b/entity-framework/core/performance/efficient-updating.md
@@ -0,0 +1,72 @@
+---
+title: Efficient Updating - EF Core
+description: Performance guide for efficient updating using Entity Framework Core
+author: roji
+ms.date: 12/1/2020
+uid: core/performance/efficient-updating
+---
+# Efficient Updating
+
+## Batching
+
+EF Core helps minimize roundtrips by automatically batching together all updates in a single roundtrip. Consider the following:
+
+[!code-csharp[Main](../../../samples/core/Performance/Other/Program.cs#SaveChangesBatching)]
+
+The above loads a blog from the database, changes its URL, and then adds two new blogs; to apply this, two SQL INSERT statements and one UPDATE statement are sent to the database. Rather than sending them one by one, as Blog instances are added, EF Core tracks these changes internally, and executes them in a single roundtrip when <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*> is called.
+
+The number of statements that EF batches in a single roundtrip depends on the database provider being used. For example, performance analysis has shown batching to be generally less efficient for SQL Server when less than 4 statements are involved. Similarly, the benefits of batching degrade after around 40 statements for SQL Server, so EF Core will by default only execute up to 42 statements in a single batch, and execute additional statements in separate roundtrips.
+
+Users can also tweak these thresholds to achieve potentially higher performance - but benchmark carefully before modifying these:
+
+[!code-csharp[Main](../../../samples/core/Performance/Other/BatchTweakingContext.cs#BatchTweaking)]
+
+## Use ExecuteUpdate and ExecuteDelete when relevant
+
+Let's assume you want to give all your employees a raise. A typical implementation for this in EF Core would look like the following:
+
+```c#
+foreach (var employee in context.Employees)
+{
+    employee.Salary += 1000;
+}
+await context.SaveChangesAsync();
+```
+
+While this is perfectly valid code, let's analyze what it does from a performance perspective:
+
+* A database roundtrip is performed, to load all the relevant employees; note that this brings all the Employees' row data to the client, even if only the salary will be needed.
+* EF Core's change tracking creates snapshots when loading the entities, and then compares those snapshots to the instances to find out which properties changed.
+* Typically, a second database roundtrip is performed to save all the changes (note that some database providers split the changes into multiples roundtrips). Although this batching behavior is far better than doing a roundtrip for each update, EF Core still sends an UPDATE statement per employee, and the database must execute each statement separately.
+
+Starting with EF Core 7.0, you can use the `ExecuteUpdateAsync` and `ExecuteDeleteAsync` methods to do the same thing far more efficiently:
+
+```c#
+await context.Employees.ExecuteUpdateAsync(s => s.SetProperty(e => e.Salary, e => e.Salary + 1000));
+```
+
+This sends the following SQL statement to the database:
+
+```sql
+UPDATE [Employees] SET [Salary] = [Salary] + 1000;
+```
+
+This `UPDATE` performs the entire operation in a single roundtrip, without loading or sending any actual data to the database, and without making use of EF's change tracking machinery, which imposes an additional overhead. For more information, see [`ExecuteUpdate` and `ExecuteDelete`](xref:core/saving/execute-insert-update-delete).
+
+If you're using an older version of EF Core which doesn't yet support `ExecuteUpdate` and `ExecuteDelete`, or want to execute a complex SQL statement which isn't supported by these methods, you can still use a SQL query to perform the operation:
+
+### [EF Core 7.0](#tab/ef7)
+
+```c#
+context.Database.ExecuteSql($"UPDATE [Employees] SET [Salary] = [Salary] + 1000");
+```
+
+### [Older Versions](#tab/older-versions)
+
+```c#
+context.Database.ExecuteSqlInterpolated($"UPDATE [Employees] SET [Salary] = [Salary] + 1000");
+```
+
+***
+
+To learn more about the differences between `SaveChanges` and `ExecuteUpdate`/`ExecuteDelete`, see the [Overview page](xref:core/saving/index) on saving data.
diff --git a/entity-framework/core/performance/index.md b/entity-framework/core/performance/index.md
new file mode 100644
index 0000000000..5cdb405e1d
--- /dev/null
+++ b/entity-framework/core/performance/index.md
@@ -0,0 +1,33 @@
+---
+title: Introduction to Performance - EF Core
+description: Performance guide for efficiently using Entity Framework Core
+author: roji
+ms.date: 12/1/2020
+uid: core/miscellaneous/performance/index
+---
+# Introduction to Performance
+
+Database performance is a vast and complex topic, spanning an entire stack of components: the database, networking, the database driver, and data access layers such as EF Core. While high-level layers and O/RMs such as EF Core considerably simplify application development and improve maintainability, they can sometimes be opaque, hiding performance-critical internal details such as the SQL being executed. This section attempts to provide an overview of how to achieve good performance with EF Core, and how to avoid common pitfalls which can degrade application performance.
+
+## Identify bottlenecks and measure, measure, measure
+
+As always with performance, it's important not to rush into optimization without data showing a problem; as the great Donald Knuth once said, "Premature optimization is the root of all evil". The [performance diagnosis](xref:core/performance/performance-diagnosis) section discusses various ways to understand where your application is spending time in database logic, and how to pinpoint specific problematic areas. Once a slow query has been identified, solutions can be considered: is your database missing an index? Should you try out other querying patterns?
+
+Always benchmark your code and possible alternatives yourself - the performance diagnosis section contains a sample benchmark with BenchmarkDotNet, which you can use as a template for your own benchmarks. Don't assume that general, public benchmarks apply as-is to your specific use-case; a variety of factors such as database latency, query complexity and actual data amounts in your tables can have a profound effect on which solution is best. For example, many public benchmarks are carried out in ideal networking conditions, where latency to the database is almost zero, and with extremely light queries which hardly require any processing (or disk I/O) on the database side. While these are valuable for comparing the runtime overheads of different data access layers, the differences they reveal usually prove to be negligible in a real-world application, where the database performs actual work and latency to the database is a significant performance factor.
+
+## Aspects of data access performance
+
+Overall data access performance can be broken down into the following broad categories:
+
+* **Pure database performance**. With relational database, EF translates the application's LINQ queries into the SQL statements getting executed by the database; these SQL statements themselves can run more or less efficiently. The right index in the right place can make a world of difference in SQL performance, or rewriting your LINQ query may make EF generate a better SQL query.
+* **Network data transfer**. As with any networking system, it's important to limit the amount of data going back and forth on the wire. This covers making sure that you only send and load data which you're actually going to need, but also avoiding the so-called "cartesian explosion" effect when loading related entities.
+* **Network roundtrips**. Beyond the amount of data going back and forth, the network roundtrips, since the time taken for a query to execute in the database can be dwarfed by the time packets travel back and forth between your application and your database. Roundtrip overhead heavily depends on your environment; the further away your database server is, the higher the latency and the costlier each roundtrip. With the advent of the cloud, applications increasingly find themselves further away from the database, and "chatty" applications which perform too many roundtrips experience degraded performance. Therefore, it's important to understand exactly when your application contacts the database, how many roundtrips it performs, and whether that number can be minimized.
+* **EF runtime overhead**. Finally, EF itself adds some runtime overhead to database operations: EF needs to compile your queries from LINQ to SQL (although that should normally be done only once), change tracking adds some overhead (but can be disabled), etc. In practice, the EF overhead for real-world applications is likely to be negligible in most cases, as query execution time in the database and network latency dominate the total time; but it's important to understand what your options are and how to avoid some pitfalls.
+
+## Know what's happening under the hood
+
+EF allows developers to concentrate on business logic by generating SQL, materializing results, and performing other tasks. Like any layer or abstraction, it also tends to hide what's happening under-the-hood, such as the actual SQL queries being executed. Performance isn't necessarily a critical aspect of every application out there, but in applications where it is, it is vital that the developer understand what EF is doing for them: inspect outgoing SQL queries, follow roundtrips to make sure the N+1 problem isn't occurring, etc.
+
+## Cache outside the database
+
+Finally, the most efficient way to interact with a database, is to not interact with it at all. In other words, if database access shows up as a performance bottleneck in your application, it may be worthwhile to cache certain results outside of the database, so as to minimize requests. Although caching adds complexity, it is an especially crucial part of any scalable application: while the application tier can be easy scaled by adding additional servers to handle increased load, scaling the database tier is usually far more complicated.
diff --git a/entity-framework/core/performance/modeling-for-performance.md b/entity-framework/core/performance/modeling-for-performance.md
new file mode 100644
index 0000000000..5c008f6232
--- /dev/null
+++ b/entity-framework/core/performance/modeling-for-performance.md
@@ -0,0 +1,69 @@
+---
+title: Modeling for Performance - EF Core
+description: Modeling efficiently when using Entity Framework Core
+author: roji
+ms.date: 10/10/2022
+uid: core/performance/modeling-for-performance
+---
+# Modeling for Performance
+
+In many cases, the way you model can have a profound impact on the performance of your application; while a properly normalized and "correct" model is usually a good starting point, in real-world applications some pragmatic compromises can go a long way for achieving good performance. Since it's quite difficult to change your model once an application is running in production, it's worth keeping performance in mind when creating the initial model.
+
+## Denormalization and caching
+
+*Denormalization* is the practice of adding redundant data to your schema, usually in order to eliminate joins when querying. For example, for a model with Blogs and Posts, where each Post has a Rating, you may be required to frequently show the average rating of the Blog. The simple approach to this would group the Posts by their Blog, and calculate the average as part of the query; but this requires a costly join between the two tables. Denormalization would add the calculated average of all posts to a new column on Blog, so that it is immediately accessible, without joining or calculating.
+
+The above can be viewed as a form of *caching* - aggregate information from the Posts is cached on their Blog; and like with any caching, the problem is how to keep the cached value up to date with the data it's caching. In many cases, it's OK for the cached data to lag for a bit; for example, in the example above, it's usually reasonable for the blog's average rating to not be completely up to date at any given point. If that's the case, you can have it recalculated every now and then; otherwise, a more elaborate system must be set up to keep the cached values up to date.
+
+The following details some techniques for denormalization and caching in EF Core, and points to the relevant sections in the documentation.
+
+### Stored computed columns
+
+If the data to be cached is a product of other columns in the same table, then a [stored computed column](xref:core/modeling/generated-properties#computed-columns) can be a perfect solution. For example, a `Customer` may have `FirstName` and `LastName` columns, but we may need to search by the customer's *full name*. A stored computed column is automatically maintained by the database - which recalculates it whenever the row is changed - and you can even define an index over it to speed up queries.
+
+### Update cache columns when inputs change
+
+If your cached column needs to reference inputs from outside the table's row, you cannot use computed columns. However, it is still possible to recalculate the column whenever its input changes; for example, you could recalculate the average Blog's rating every time a Post is changed, added or removed. Be sure to identify the exact conditions when recalculation is needed, otherwise your cached value will go out of sync.
+
+One way to do this, is to perform the update yourself, via the regular EF Core API. `SaveChanges` [Events](xref:core/logging-events-diagnostics/events) or [interceptors](xref:core/logging-events-diagnostics/interceptors#savechanges-interception) can be used to automatically check if any Posts are being updated, and to perform the recalculation that way. Note that this typically entails additional database roundtrips, as additional commands must be sent.
+
+For more perf-sensitive applications, database triggers can be defined to automatically perform the recalculation in the database. This saves the extra database roundtrips, automatically occurs within the same transaction as the main update, and can be simpler to set up. EF doesn't provide any specific API for creating or maintaining triggers, but it's perfectly fine to [create an empty migration and add the trigger definition via raw SQL](xref:core/managing-schemas/migrations/managing#arbitrary-changes-via-raw-sql).
+
+### Materialized/indexed views
+
+Materialized (or indexed) views are similar to regular views, except that their data is stored on disk ("materialized"), rather than calculated every time the view is queried. Such views are conceptually similar to stored computed columns, as they cache the results of potentially expensive calculations; however, they cache an entire query's resultset instead of a single column. Materialized views can be queried just like any regular table, and since they are cached on disk, such queries execute very quickly and cheaply without having to constantly perform the expensive calculations of the query which defines the view.
+
+Specific support for materialized views varies across databases. In some databases (e.g. [PostgreSQL](https://www.postgresql.org/docs/current/rules-materializedviews.html)), materialized views must be manually refreshed in order for their values to be synchronized with their underlying tables. This is typically done via a timer - in cases where some data lag is acceptable - or via a trigger or stored procedure call in specific conditions. [SQL Server Indexed Views](/sql/relational-databases/views/create-indexed-views), on the other hand, are automatically updated as their underlying tables are modified; this ensures that the view always shows the latest data, at the cost of slower updates. In addition, SQL Server Index Views have various restrictions on what they support; consult the [documentation](/sql/relational-databases/views/create-indexed-views) for more information.
+
+EF doesn't currently provide any specific API for creating or maintaining views, materialized/indexed or otherwise; but it's perfectly fine to [create an empty migration and add the view definition via raw SQL](xref:core/managing-schemas/migrations/managing#arbitrary-changes-via-raw-sql).
+
+## Inheritance mapping
+
+It's recommended to read [the dedicated page on inheritance](xref:core/modeling/inheritance) before continuing with this section.
+
+EF Core currently supports three techniques for mapping an inheritance model to a relational database:
+
+* **Table-per-hierarchy** (TPH), in which an entire .NET hierarchy of classes is mapped to a single database table.
+* **Table-per-type** (TPT), in which each type in the .NET hierarchy is mapped to a different table in the database.
+* **Table-per-concrete-type** (TPC), in which each concrete type in the .NET hierarchy is mapped to a different table in the database, where each table contains columns for all properties of the corresponding type.
+
+The choice of inheritance mapping technique can have a considerable impact on application performance - it's recommended to carefully measure before committing to a choice.
+
+Intuitively, TPT might seem like the "cleaner" technique; a separate table for each .NET type makes the database schema look similar to the .NET type hierarchy. In addition, since TPH must represent the entire hierarchy in a single table, rows have *all* columns regardless of the type actually being held in the row, and unrelated columns are always empty and unused. Aside from seeming to be an "unclean" mapping technique, many believe that these empty columns take up considerable space in the database and may hurt performance as well.
+
+> [!TIP]
+> If your database system supports it (e.g. SQL Server), then consider using "sparse columns" for TPH columns that will be rarely populated.
+
+However, measuring shows that TPT is in most cases the inferior mapping technique from a performance standpoint; where all data in TPH comes from a single table, TPT queries must join together multiple tables, and joins are one of the primary sources of performance issues in relational databases. Databases also generally tend to deal well with empty columns, and features such as [SQL Server sparse columns](/sql/relational-databases/tables/use-sparse-columns) can reduce this overhead even further.
+
+TPC has similar performance characteristics to TPH, but is slightly slower when selecting entities of all types as this involves several tables. However, TPC really excels when querying for entities of a single leaf type - the query only uses a single table and needs no filtering.
+
+For a concrete example, [see this benchmark](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Benchmarks/Inheritance.cs) which sets up a simple model with a 7-type hierarchy; 5000 rows are seeded for each type - totalling 35000 rows - and the benchmark simply loads all rows from the database:
+
+| Method |     Mean |   Error |   StdDev |     Gen 0 |     Gen 1 | Allocated |
+|------- |---------:|--------:|---------:|----------:|----------:|----------:|
+|    TPH | 149.0 ms | 3.38 ms |  9.80 ms | 4000.0000 | 1000.0000 |     40 MB |
+|    TPT | 312.9 ms | 6.17 ms | 10.81 ms | 9000.0000 | 3000.0000 |     75 MB |
+|    TPC | 158.2 ms | 3.24 ms |  8.88 ms | 5000.0000 | 2000.0000 |     46 MB |
+
+As can be seen, TPH and TPC are considerably more efficient than TPT for this scenario. Note that actual results always depend on the specific query being executed and the number of tables in the hierarchy, so other queries may show a different performance gap; you're encouraged to use this benchmark code as a template for testing other queries.
diff --git a/entity-framework/core/performance/nativeaot-and-precompiled-queries.md b/entity-framework/core/performance/nativeaot-and-precompiled-queries.md
new file mode 100644
index 0000000000..50e0394211
--- /dev/null
+++ b/entity-framework/core/performance/nativeaot-and-precompiled-queries.md
@@ -0,0 +1,126 @@
+---
+title: NativeAOT Support and Precompiled Queries (Experimental) - EF Core
+description: Publishing NativeAOT Entity Framework Core applications and using precompiled queries
+author: roji
+ms.date: 11/10/2024
+uid: core/performance/nativeaot-and-precompiled-queries
+---
+# NativeAOT Support and Precompiled Queries (Experimental)
+
+> [!WARNING]
+> NativeAOT and query precompilation are highly experimental feature, and are not yet suited for production use. The support described below should be viewed as infrastructure towards the final feature, which will be released in a future version. We encourage you to experiment with the current support and report on your experiences, but recommend against deploying EF NativeAOT applications in production. See below for specific known limitations.
+
+[.NET NativeAOT](/dotnet/core/deploying/native-aot) allows publishing self-contained .NET applications that have been compiled ahead-of-time (AOT). Doing so offers the following advantages:
+
+* Significantly faster application startup time
+* Small, self-contained binaries that have smaller memory footprints and are easier to deploy
+* Running applications in environments where just-in-time compilation isn't supported
+
+EF applications published with NativeAOT start up much faster than the same applications without it. In addition to the general .NET startup improvements that NativeAOT offers (i.e. no JIT compilation required each time), EF also precompiles LINQ queries when publishing your application, so that no processing is needed when starting up and the SQL is already available for immediate execution. The more EF LINQ queries an application has in its code, the faster the startup gains are expected to be.
+
+## Publishing an EF NativeAOT Application
+
+First, enable NativeAOT publishing for your project as follows:
+
+```xml
+<PropertyGroup>
+    <PublishAot>true</PublishAot>
+</PropertyGroup>
+```
+
+EF's support for LINQ query execution under NativeAOT relies on *query precompilation*: this mechanism statically identifies EF LINQ queries and generates C# [*interceptors*](/dotnet/csharp/whats-new/csharp-12#interceptors), which contain code to execute each specific query. This can significantly cut down on your application's startup time, as the heavy lifting of processing and compiling your LINQ queries into SQL no longer happens every time your application starts up. Instead, each query's interceptor contains the finalized SQL for that query, as well as optimized code to materialize database results as .NET objects.
+
+C# interceptors are currently an experimental feature, and require a special opt-in in your project file:
+
+```xml
+<PropertyGroup>
+  <InterceptorsNamespaces>$(InterceptorsNamespaces);Microsoft.EntityFrameworkCore.GeneratedInterceptors</InterceptorsNamespaces>
+</PropertyGroup>
+```
+
+Finally, the [`Microsoft.EntityFrameworkCore.Tasks`](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Tasks) package contains [MSBuild integration](xref:core/cli/msbuild) that will perform the query precompilation (and generate the required compiled model) when you publish your application:
+
+```xml
+<ItemGroup>
+  <PackageReference Include="Microsoft.EntityFrameworkCore.Tasks" Version="9.0.0">
+    <PrivateAssets>all</PrivateAssets>
+    <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+  </PackageReference>
+</ItemGroup>
+```
+
+You're now ready to publish your EF NativeAOT application:
+
+```console
+dotnet publish -r linux-arm64 -c Release
+```
+
+> [!NOTE]
+>
+> The publish command may fail with error `CS9137`. The cause of this error are outdated transitive package references `Microsoft.CodeAnalysis.CSharp.Workspaces` and `Microsoft.CodeAnalysis.Workspaces.MSBuild`. As a workaround add those packages explicitly to your .csproj file:
+>
+> ```xml
+> <PackageReference Include="Microsoft.CodeAnalysis.CSharp.Workspaces" Version="4.13.0" />
+> <PackageReference Include="Microsoft.CodeAnalysis.Workspaces.MSBuild" Version="4.13.0" />
+> ```
+>
+> See [this issue](https://github.com/dotnet/efcore/issues/35945) for more information.
+
+This shows publishing a NativeAOT publishing for Linux running on ARM64; [consult this catalog](/dotnet/core/rid-catalog) to find your runtime identifier. If you'd like to generate the interceptors without publishing - for example to examine the generated sources - you can do so via the `dotnet ef dbcontext optimize --precompile-queries --nativeaot` command.
+
+Due to the way C# interceptors work, any change in the application source invalidates them and requires repeating the above process. As a result, interceptor generation and actual publishing aren't expected to happen in the inner loop, as the developer is working on code; instead, both `dotnet ef dbcontext optimize` and `dotnet publish` can be executed in a publishing/deployment workflow, in a CI/CD system.
+
+> [!NOTE]
+> Publishing currently reports a number of trimming and NativeAOT warnings, meaning that your application isn't fully guaranteed to run properly. This is expected given the current experimental state of NativeAOT support; the final, non-experimental feature will report no warnings.
+
+## Limitations
+
+### Dynamic queries are not supported
+
+Query precompilation performs static analysis of your source code, identifying EF LINQ queries and generating C# interceptors for them. LINQ allows expressing highly dynamic queries, where LINQ operators are composed based on arbitrary conditions; such queries unfortunately cannot be statically analyzed, and are currently unsupported. Consider the following example:
+
+```c#
+IAsyncEnumerable<Blog> GetBlogs(BlogContext context, bool applyFilter)
+{
+    IQueryable<Blog> query = context.Blogs.OrderBy(b => b.Id);
+
+    if (applyFilter)
+    {
+        query = query.Where(b => b.Name != "foo");
+    }
+
+    return query.AsAsyncEnumerable();
+}
+```
+
+The above query is split across several statements, and dynamically composes the `Where` operator based on an external parameter; such queries cannot be precompiled. However, it is sometimes possible to rewrite such dynamic queries as multiple non-dynamic queries:
+
+```c#
+IAsyncEnumerable<Blog> GetBlogs(BlogContext context, bool applyFilter)
+    => applyFilter
+        ? context.Blogs.OrderBy(b => b.Id).Where(b => b.Name != "foo").AsAsyncEnumerable()
+        : context.Blogs.OrderBy(b => b.Id).AsAsyncEnumerable();
+```
+
+Since the two queries can each be statically analyzed from start to finish, precompilation can handle them.
+
+Note that dynamic queries will likely be supported in the future when using NativeAOT; however, since they cannot be precompiled, they will continue to slow down your application startup, and will also generally perform less efficiently compared to non-NativeAOT execution; this is because EF internally relies on code generation to materialize database results, but code generation is not supported when using NativeAOT.
+
+### Other limitations
+
+* LINQ query expression syntax (sometimes termed "comprehension syntax") is not supported.
+* The generated compiled model and query interceptors may currently be quite large in terms of code size, and take a long while to generate. We plan on improving this.
+* EF providers may need to build in support for precompiled queries; check your provider's documentation to know whether it is compatible with EF's NativeAOT support.
+* Value converters that use captured state are not supported.
+
+## Precompiled queries without NativeAOT
+
+Because of the current limitations of EF's NativeAOT support, it may not be usable for some applications. However, you may be able to take advantage of precompiled queries while publishing regular, non-NativeAOT applications; this allows you to at least benefit from the startup time reduction that precompiled queries offer, while being able to use dynamic queries and other features not currently supported with NativeAOT.
+
+Using precompiled queries without NativeAOT is simply a matter of executing the following:
+
+```console
+dotnet ef dbcontext optimize --precompile-queries
+```
+
+As shown above, this will generate a compiled model and interceptors for queries which could be precompiled, removing their overhead from your application's startup time.
diff --git a/entity-framework/core/performance/performance-diagnosis.md b/entity-framework/core/performance/performance-diagnosis.md
new file mode 100644
index 0000000000..09492fac7b
--- /dev/null
+++ b/entity-framework/core/performance/performance-diagnosis.md
@@ -0,0 +1,139 @@
+---
+title: Performance Diagnosis - EF Core
+description: Diagnosing Entity Framework Core performance and identifying bottlenecks
+author: roji
+ms.date: 12/1/2020
+uid: core/performance/performance-diagnosis
+---
+# Performance Diagnosis
+
+This section discusses ways for detecting performance issues in your EF application, and once a problematic area has been identified, how to further analyze them to identify the root problem. It's important to carefully diagnose and investigate any problems before jumping to any conclusions, and to avoid assuming where the root of the issue is.
+
+## Identifying slow database commands via logging
+
+At the end of the day, EF prepares and executes commands to be executed against your database; with relational database, that means executing SQL statements via the ADO.NET database API. If a certain query is taking too much time (e.g. because an index is missing), this can be seen discovered by inspecting command execution logs and observing how long they actually take.
+
+EF makes it very easy to capture command execution times, via either [simple logging](xref:core/logging-events-diagnostics/simple-logging) or [Microsoft.Extensions.Logging](xref:core/logging-events-diagnostics/extensions-logging):
+
+### [Simple logging](#tab/simple-logging)
+
+[!code-csharp[Main](../../../samples/core/Performance/Other/BloggingContext.cs#SimpleLogging)]
+
+### [Microsoft.Extensions.Logging](#tab/microsoft-extensions-logging)
+
+[!code-csharp[Main](../../../samples/core/Performance/Other/ExtensionsLoggingContext.cs#ExtensionsLogging)]
+
+***
+
+When the logging level is set at `LogLevel.Information`, EF emits a log message for each command execution with the time taken:
+
+```log
+info: 06/12/2020 09:12:36.117 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed DbCommand (4ms) [Parameters=[], CommandType='Text', CommandTimeout='30']
+      SELECT [b].[Id], [b].[Name]
+      FROM [Blogs] AS [b]
+      WHERE [b].[Name] = N'foo'
+```
+
+The above command took 4 milliseconds. If a certain command takes more than expected, you've found a possible culprit for a performance issue, and can now focus on it to understand why it's running slowly. Command logging can also reveal cases where unexpected database roundtrips are being made; this would show up as multiple commands where only one is expected.
+
+> [!WARNING]
+> Leaving command execution logging enabled in your production environment is usually a bad idea. The logging itself slows down your application, and may quickly create huge log files which can fill up your server's disk. It's recommended to only keep logging on for a short interval of time to gather data - while carefully monitoring your application - or to capture logging data on a pre-production system.
+
+## Correlating database commands to LINQ queries
+
+One problem with command execution logging is that it's sometimes difficult to correlate SQL queries and LINQ queries: the SQL commands executed by EF can look very different from the LINQ queries from which they were generated. To help with this difficulty, you may want to use EF's [query tags](xref:core/querying/tags) feature, which allows you to inject a small, identifying comment into the SQL query:
+
+[!code-csharp[Main](../../../samples/core/Querying/Tags/Program.cs#BasicQueryTag)]
+
+The tag shows up in the logs:
+
+```sql
+-- This is my spatial query!
+
+SELECT TOP(@__p_1) [p].[Id], [p].[Location]
+FROM [People] AS [p]
+ORDER BY [p].[Location].STDistance(@__myLocation_0) DESC
+```
+
+It's often worth tagging the major queries of an application in this way, to make the command execution logs more immediately readable.
+
+## Other interfaces for capturing performance data
+
+There are various alternatives to EF's logging feature for capturing command execution times, which may be more powerful. Databases typically come with their own tracing and performance analysis tools, which usually provide much richer, database-specific information beyond simple execution times; the actual setup, capabilities and usage vary considerably across databases.
+
+For example, [SQL Server Management Studio](/sql/ssms/download-sql-server-management-studio-ssms) is a powerful client that can connect to your SQL Server  instance and provide valuable management and performance information. It's beyond the scope of this section to go into the details, but two capabilities worth mentioning are the [Activity Monitor](/sql/relational-databases/performance-monitor/open-activity-monitor-sql-server-management-studio), which provides a live dashboard of server activity (including the most expensive queries), and the [Extended Events (XEvent)](/sql/relational-databases/extended-events/quick-start-extended-events-in-sql-server) feature, which allows defining arbitrary data capture sessions which can be tailored to your exact needs. [The SQL Server documentation on monitoring](/sql/relational-databases/performance/monitor-and-tune-for-performance) provides more information on these features, as well as others.
+
+Another approach for capturing performance data is to collect information automatically emitted by either EF or the database driver via the `DiagnosticSource` interface, and then analyze that data or display it on a dashboard. If you are using Azure, then [Azure Application Insights](/azure/azure-monitor/learn/tutorial-performance) provides such powerful monitoring out of the box, integrating database performance and query execution times in the analysis of how quickly your web requests are being served. More information on this is available in the [Application Insights performance tutorial](/azure/azure-monitor/learn/tutorial-performance), and in the [Azure SQL analytics page](/azure/azure-monitor/insights/azure-sql).
+
+## Inspecting query execution plans
+
+Once you've pinpointed a problematic query that requires optimization, the next step is usually analyzing the query's *execution plan*. When databases receive a SQL statement, they typically produce a plan of how that plan is to be executed; this sometimes requires complicated decision-making based on which indexes have been defined, how much data exists in tables, etc. (incidentally, the plan itself should usually be cached at the server for optimal performance). Relational databases typically provide a way for users to see the query plan, along with calculated costing for different parts of the query; this is invaluable for improving your queries.
+
+To get started on SQL Server, see the documentation on [query execution plans](/sql/relational-databases/performance/execution-plans). The typical analysis workflow would be to use [SQL Server Management Studio](/sql/relational-databases/performance/display-an-actual-execution-plan), pasting the SQL of a slow query identified via one of the means above, and [producing a graphical execution plan](/sql/relational-databases/performance/display-an-actual-execution-plan):
+
+![Display a SQL Server execution plan](_static/actualexecplan.png)
+
+While execution plans may seem complicated at first, it's worth spending a bit of time getting familiar with them. It's particularly important to note the costs associated with each node of the plan, and to identify how indexes are used (or not) in the various nodes.
+
+While the above information is specific to SQL Server, other databases typically provide the same kind of tools with similar visualization.
+
+> [!IMPORTANT]
+> Databases sometimes generate different query plans depending on actual data in the database. For example, if a table contains only a few rows, a database may choose not to use an index on that table, but to perform a full table scan instead. If analyzing query plans on a test database, always make sure it contains data that is similar to your production system.
+
+## Metrics
+
+The above sections focused on how to get information about your commands, and how these commands are executed in the database. In addition to that, EF exposes a set of *metrics* which provide more lower-level information on what's happening inside EF itself, and how your application is using it. These metrics can be very useful for diagnosing specific performance issues and performance anomalies, such as [query caching issues](xref:core/performance/advanced-performance-topics#dynamically-constructed-queries) which cause constant recompilation, undisposed DbContext leaks, and others.
+
+See the dedicated page on [EF's metrics](xref:core/logging-events-diagnostics/metrics) for more information.
+
+## Benchmarking with EF Core
+
+At the end of the day, you sometimes need to know whether a particular way of writing or executing a query is faster than another. It's important to never assume or speculate the answer, and it's extremely easy to put together a quick benchmark to get the answer. When writing benchmarks, it's strongly recommended to use the well-known [BenchmarkDotNet](https://benchmarkdotnet.org/index.html) library, which handles many pitfalls users encounter when trying to write their own benchmarks: have you performed some warmup iterations? How many iterations does your benchmark actually run, and why? Let's take a look at what a benchmark with EF Core looks like.
+
+> [!TIP]
+> The full benchmark project for the source below is available [here](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Benchmarks/AverageBlogRanking.cs). You are encouraged to copy it and use it as a template for your own benchmarks.
+
+As a simple benchmark scenario, let's compare the following different methods of calculating the average ranking of all Blogs in our database:
+
+* Load all entities, sum up their individual rankings, and calculate the average.
+* The same as above, only use a non-tracking query. This should be faster, since identity resolution isn't performed, and the entities aren't snapshotted for the purposes of change tracking.
+* Avoid loading the entire Blog entity instances at all, by projecting out the ranking only. The saves us from transferring the other, unneeded columns of the Blog entity type.
+* Calculate the average in the database by making it part of the query. This should be the fastest way, since everything is calculated in the database and only the result is transferred back to the client.
+
+With BenchmarkDotNet, you write the code to be benchmarked as a simple method - just like a unit test - and BenchmarkDotNet automatically runs each method for a sufficient number of iterations, reliably measuring how long it takes and how much memory is allocated. Here are the different methods ([the full benchmark code can be seen here](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Benchmarks/AverageBlogRanking.cs)):
+
+### [Load entities](#tab/load-entities)
+
+[!code-csharp[Main](../../../samples/core/Benchmarks/AverageBlogRanking.cs?name=LoadEntities)]
+
+### [Load entities, no tracking](#tab/load-entities-no-tracking)
+
+[!code-csharp[Main](../../../samples/core/Benchmarks/AverageBlogRanking.cs?name=LoadEntitiesNoTracking)]
+
+### [Project only ranking](#tab/project-only-ranking)
+
+[!code-csharp[Main](../../../samples/core/Benchmarks/AverageBlogRanking.cs?name=ProjectOnlyRanking)]
+
+### [Calculate in database](#tab/calculate-in-database)
+
+[!code-csharp[Main](../../../samples/core/Benchmarks/AverageBlogRanking.cs?name=CalculateInDatabase)]
+
+***
+
+The results are below, as printed by BenchmarkDotNet:
+
+|                 Method |       Mean |    Error |   StdDev |     Median | Ratio | RatioSD |    Gen 0 |   Gen 1 | Gen 2 |  Allocated |
+|----------------------- |-----------:|---------:|---------:|-----------:|------:|--------:|---------:|--------:|------:|-----------:|
+|           LoadEntities | 2,860.4 us | 54.31 us | 93.68 us | 2,844.5 us |  4.55 |    0.33 | 210.9375 | 70.3125 |     - | 1309.56 KB |
+| LoadEntitiesNoTracking | 1,353.0 us | 21.26 us | 18.85 us | 1,355.6 us |  2.10 |    0.14 |  87.8906 |  3.9063 |     - |  540.09 KB |
+|     ProjectOnlyRanking |   910.9 us | 20.91 us | 61.65 us |   892.9 us |  1.46 |    0.14 |  41.0156 |  0.9766 |     - |  252.08 KB |
+|    CalculateInDatabase |   627.1 us | 14.58 us | 42.54 us |   626.4 us |  1.00 |    0.00 |   4.8828 |       - |     - |   33.27 KB |
+
+> [!NOTE]
+> As the methods instantiate and dispose the context within the method, these operations are counted for the benchmark, although strictly speaking they are not part of the querying process. This should not matter if the goal is to compare two alternatives to one another (since the context instantiation and disposal are the same), and gives a more holistic measurement for the entire operation.
+
+One limitation of BenchmarkDotNet is that it measures simple, single-thread performance of the methods you provide, and is therefore not well-suited for benchmarking concurrent scenarios.
+
+> [!IMPORTANT]
+> Always make sure to have data in your database that is similar to production data when benchmarking, otherwise the benchmark results may not represent actual performance in production.
diff --git a/entity-framework/core/providers/cosmos/full-text-search.md b/entity-framework/core/providers/cosmos/full-text-search.md
new file mode 100644
index 0000000000..0140b7d07f
--- /dev/null
+++ b/entity-framework/core/providers/cosmos/full-text-search.md
@@ -0,0 +1,126 @@
+---
+title: Full-Text Search - Azure Cosmos DB Provider - EF Core
+description: Full-text search with the Azure Cosmos DB EF Core Provider
+author: maumar
+ms.date: 04/19/2025
+uid: core/providers/cosmos/full-text-search
+---
+# Full-text search
+
+> [!NOTE]
+> Full-text search support for Cosmos was introduced in EF 10.
+
+Azure Cosmos DB now offers support for [full-text search](/azure/cosmos-db/gen-ai/full-text-search). It enables efficient and effective text searches using advanced techniques like stemming, as well as evaluating the relevance of documents to a given search query. It can be used in combination with vector search (i.e. hybrid search) to improve the accuracy of responses in some AI scenarios.
+EF Core allows for modeling the database with full-text search enabled properties and using full-text search functions inside queries targeting Azure Cosmos DB.
+
+## Model configuration
+
+A property can be configured inside `OnModelCreating` to use full-text search by enabling it for the property and defining a full-text index:
+
+```c#
+public class Blog
+{
+    ...
+
+    public string Contents { get; set; }
+}
+
+public class BloggingContext
+{
+    ...
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>(b =>
+        {
+            b.Property(x => x.Contents).EnableFullTextSearch();
+            b.HasIndex(x => x.Contents).IsFullTextIndex();
+        });
+    }
+}
+```
+
+> [!NOTE]
+> Configuring the index is not mandatory, but it is recommended as it greatly improves performance of full-text search queries.
+
+Full-text search operations are language specific, using American English (`en-US`) by default. You can customize the language for individual properties as part of `EnableFullTextSearch` call:
+
+```c#
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Blog>(b =>
+    {
+        b.Property(x => x.Contents).EnableFullTextSearch();
+        b.HasIndex(x => x.Contents).IsFullTextIndex();
+        b.Property(x => x.ContentsGerman).EnableFullTextSearch("de-DE");
+        b.HasIndex(x => x.ContentsGerman).IsFullTextIndex();
+    });
+}
+```
+
+You can also set a default language for the container - unless overridden in the `EnableFullTextSearch` method, all full-text properties inside the container will use that language.
+
+```c#
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Blog>(b =>
+    {
+        b.HasDefaultFullTextLanguage("de-DE");
+        b.Property(x => x.ContentsEnglish).EnableFullTextSearch("en-US");
+        b.HasIndex(x => x.ContentsEnglish).IsFullTextIndex();
+        b.Property(x => x.ContentsGerman).EnableFullTextSearch();
+        b.HasIndex(x => x.ContentsGerman).IsFullTextIndex();
+        b.Property(x => x.TagsGerman).EnableFullTextSearch();
+        b.HasIndex(x => x.TagsGerman).IsFullTextIndex();
+    });
+}
+```
+
+## Querying
+
+As part of the full-text search feature, Azure Cosmos DB introduced several built-in functions which allow for efficient querying of content inside the full-text search enabled properties. These functions are: [`FullTextContains`](/azure/cosmos-db/nosql/query/fulltextcontains), [`FullTextContainsAll`](/azure/cosmos-db/nosql/query/fulltextcontainsall), [`FullTextContainsAny`](/azure/cosmos-db/nosql/query/fulltextcontainsany), which look for specific keyword or keywords and [`FullTextScore`](/azure/cosmos-db/nosql/query/fulltextscore), which returns [BM25 score](https://en.wikipedia.org/wiki/Okapi_BM25) based on provided keywords.
+
+> [!NOTE]
+> `FullTextScore` can only be used inside `OrderBy` to rank the documents based on the score.
+
+EF Core exposes these functions as part of `EF.Functions` so they can be used in queries:
+
+```c#
+var cosmosBlogs = await context.Blogs.Where(x => EF.Functions.FullTextContainsAll(x.Contents, "database", "cosmos")).ToListAsync();
+
+var keywords = new string[] { "AI", "agent", "breakthrough" };
+var mostInteresting = await context.Blogs.OrderBy(x => EF.Functions.FullTextScore(x.Contents, keywords)).Take(5).ToListAsync();
+```
+
+## Hybrid search
+
+Full-text search can be used with [vector search](xref:core/providers/cosmos/vector-search) in the same query; this is sometimes known as "hybrid search", and involves combining the scoring results from multiple searches via the [RRF (Reciprocal Rank Fusion) function](/azure/cosmos-db/nosql/query/rrf). Once you have your vector and full-text search configuration properly set up, you can perform hybrid search as follows:
+
+```c#
+float[] myVector = /* generate vector data from text, image, etc. */
+var hybrid = await context.Blogs
+    .OrderBy(x => EF.Functions.Rrf(
+        EF.Functions.FullTextScore(x.Contents, "database"), 
+        EF.Functions.VectorDistance(x.Vector, myVector)))
+    .Take(10)
+    .ToListAsync();
+```
+
+The RRF function also allows assigning different weights to each search function, allowing e.g. the vector search to have great weight in the overall results:
+
+```c#
+float[] myVector = /* generate vector data from text, image, etc. */
+var hybrid = await context.Blogs
+    .OrderBy(x => EF.Functions.Rrf(
+        new[]
+        {
+            EF.Functions.FullTextScore(x.Contents, "database"), 
+            EF.Functions.VectorDistance(x.Vector, myVector)
+        },
+        weights: new[] { 1, 2 }))
+    .Take(10)
+    .ToListAsync();
+```
+
+> [!TIP]
+> You can combine more than two scoring functions inside `Rrf` call, as well as using only `FullTextScore`, or only `VectorDistance` invocations.
diff --git a/entity-framework/core/providers/cosmos/index.md b/entity-framework/core/providers/cosmos/index.md
new file mode 100644
index 0000000000..2ea9c8925b
--- /dev/null
+++ b/entity-framework/core/providers/cosmos/index.md
@@ -0,0 +1,86 @@
+---
+title: Azure Cosmos DB Provider - EF Core
+description: Documentation for the database provider that allows Entity Framework Core to be used with Azure Cosmos DB.
+author: AndriySvyryd
+ms.date: 02/12/2023
+uid: core/providers/cosmos/index
+ms.custom: sfi-ropc-nochange
+---
+# EF Core Azure Cosmos DB Provider
+
+> [!WARNING]
+> Extensive work has gone into the Azure Cosmos DB provider in 9.0. In order to improve the provider, a number of high-impact breaking changes had to be made; if you are upgrading an existing application, please read the [breaking changes section](xref:core/what-is-new/ef-core-9.0/breaking-changes#cosmos-breaking-changes) carefully.
+
+This database provider allows Entity Framework Core to be used with Azure Cosmos DB. The provider is maintained as part of the [Entity Framework Core Project](https://github.com/dotnet/efcore).
+
+It is strongly recommended to familiarize yourself with the [Azure Cosmos DB documentation](/azure/cosmos-db/introduction) before reading this section.
+
+> [!NOTE]
+> This provider only works with Azure Cosmos DB for NoSQL.
+
+## Install
+
+Install the [Microsoft.EntityFrameworkCore.Cosmos NuGet package](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Cosmos/).
+
+### [.NET CLI](#tab/dotnet-core-cli)
+
+```dotnetcli
+dotnet add package Microsoft.EntityFrameworkCore.Cosmos
+```
+
+### [Visual Studio](#tab/vs)
+
+```powershell
+Install-Package Microsoft.EntityFrameworkCore.Cosmos
+```
+
+***
+
+## Get started
+
+> [!TIP]
+> You can view this article's [sample on GitHub](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Cosmos).
+
+As for other providers the first step is to call [UseCosmos](/dotnet/api/Microsoft.EntityFrameworkCore.CosmosDbContextOptionsExtensions.UseCosmos):
+
+[!code-csharp[Configuration](../../../../samples/core/Cosmos/ModelBuilding/OrderContext.cs?name=Configuration)]
+
+> [!WARNING]
+> The endpoint and key are hardcoded here for simplicity, but in a production app these should be [stored securely](/aspnet/core/security/app-secrets#secret-manager). See [Connecting and authenticating](xref:core/providers/cosmos/index#connecting-and-authenticating) for different ways to connect to Azure Cosmos DB.
+
+In this example `Order` is a simple entity with a reference to the [owned type](xref:core/modeling/owned-entities) `StreetAddress`.
+
+[!code-csharp[Order](../../../../samples/core/Cosmos/ModelBuilding/Order.cs?name=Order)]
+
+[!code-csharp[StreetAddress](../../../../samples/core/Cosmos/ModelBuilding/StreetAddress.cs?name=StreetAddress)]
+
+Saving and querying data follows the normal EF pattern:
+
+[!code-csharp[HelloCosmos](../../../../samples/core/Cosmos/ModelBuilding/Sample.cs?name=HelloCosmos)]
+
+> [!IMPORTANT]
+> Calling [EnsureCreatedAsync](/dotnet/api/Microsoft.EntityFrameworkCore.Storage.IDatabaseCreator.EnsureCreatedAsync) is necessary to create the required containers and insert the [seed data](xref:core/modeling/data-seeding) if present in the model. However `EnsureCreatedAsync` should only be called during deployment, not normal operation, as it may cause performance issues.
+>
+> Azure Cosmos DB SDK does not support RBAC for management plane operations in Azure Cosmos DB. Use Azure Management API instead of EnsureCreatedAsync with RBAC.
+
+## Connecting and authenticating
+
+The Azure Cosmos DB provider for EF Core has multiple overloads of the [UseCosmos](/dotnet/api/Microsoft.EntityFrameworkCore.CosmosDbContextOptionsExtensions.UseCosmos) method. These overloads support the different ways that a connection can be made to the database, and the different ways of ensuring that the connection is secure.
+
+> [!IMPORTANT]
+> Make sure to understand [_Secure access to data in Azure Cosmos DB_](/azure/cosmos-db/secure-access-to-data) to understand the security implications and best practices for using each overload of the `UseCosmos` method.
+> Generally, RBAC with token credentials is the recommended access-control mechanism.
+
+| Connection Mechanism       | UseCosmos Overload                                                     | More information                                                                          |
+|----------------------------|------------------------------------------------------------------------|----------------------------------------------------------------------------------------------|
+| Account endpoint and key   | `UseCosmos<DbContext>(accountEndpoint, accountKey, databaseName)`      | [Primary/secondary keys](/azure/cosmos-db/secure-access-to-data#primary-keys)                |
+| Account endpoint and token | `UseCosmos<DbContext>(accountEndpoint, tokenCredential, databaseName)` | [RBAC and Resource tokens](/azure/cosmos-db/secure-access-to-data#role-based-access-control) |
+| Connection string          | `UseCosmos<DbContext>(connectionString, databaseName)`                 | [Work with account keys and connection strings](/azure/cosmos-db/scripts/cli/common/keys)    |
+
+## Azure Cosmos DB options
+
+It is also possible to configure the Azure Cosmos DB provider with a single connection string and to specify other options to customize the connection:
+
+[!code-csharp[Configuration](../../../../samples/core/Cosmos/ModelBuilding/OptionsContext.cs?name=Configuration)]
+
+The code above shows some possible options - these are not intended to be used at the same time. See the [Azure Cosmos DB Options documentation](/dotnet/api/microsoft.azure.cosmos.cosmosclientoptions) for a detailed description of the effect of each option mentioned above.
diff --git a/entity-framework/core/providers/cosmos/limitations.md b/entity-framework/core/providers/cosmos/limitations.md
new file mode 100644
index 0000000000..e51f59be17
--- /dev/null
+++ b/entity-framework/core/providers/cosmos/limitations.md
@@ -0,0 +1,25 @@
+---
+title: Azure Cosmos DB Provider - Limitations - EF Core
+description: Limitations of the Entity Framework Core Azure Cosmos DB provider as compared to other providers
+author: AndriySvyryd
+ms.date: 09/26/2024
+uid: core/providers/cosmos/limitations
+---
+# EF Core Azure Cosmos DB Provider Limitations
+
+The Azure Cosmos DB database provider targets the Azure Cosmos DB NoSQL store, which is a [document database](https://en.wikipedia.org/wiki/Document-oriented_database). Most EF Core providers target [relational databases](https://en.wikipedia.org/wiki/Relational_database). Document databases and relational databases behave in fundamentally different ways. EF Core does not attempt to hide these differences; rather EF Core provides common patterns that can be used successfully across both kinds of database, together with features tailored to a particular provider that follow best practices for a given type of database. If a feature of EF Core is a pit-of-failure for a certain kind of database, then typically the database provider will not implement that feature, and instead help steer uses towards a [pit-of-success](/archive/blogs/brada/the-pit-of-success) approach.
+
+Common EF Core patterns that either do not apply, or are a pit-of-failure, when using a document database include:
+
+- Azure Cosmos DB does not provide relational-style transactions or full ACID guarantees across any number of operations and tables. However, the EF Core Azure Cosmos DB provider does use [Transactional batches](/azure/cosmos-db/transactional-batch) when possible; see [Saving data](xref:core/providers/cosmos/saving) for further details.
+- Schema migration is not supported, since there is no defined schema for the documents. However, there could be other mechanisms for dealing with evolving data shapes that do make sense with Azure Cosmos DB NoSQL, For example, [Schema versioning pattern with Azure Cosmos DB](https://github.com/dotnet/efcore/issues/23753), and [Azure Cosmos DB data migration](https://github.com/dotnet/efcore/issues/11099).
+- Reverse-engineering (scaffolding) a model from an existing database is not supported. Again, this is not supported because there is no defined database schema to scaffold from. However, see [Use shape of documents in the Azure Cosmos DB database to scaffold a schema](https://github.com/dotnet/efcore/issues/30290).
+- Schema concepts defined on the EF model, like indexes and constraints, are ignored when using a document database, since there is no schema. Note that Azure Cosmos DB NoSQL performs [automatic indexing of documents](/azure/cosmos-db/index-overview).
+- Loading graphs of related entities from different documents is not supported. Document databases are not designed to perform joins across many documents; doing so would be very inefficient. Instead, it is more common to denormalize data so that everything needed is in one, or a small number, of documents. However, there are some forms of cross-document relationships that could be handled--see [Limited Include support for Azure Cosmos DB](https://github.com/dotnet/efcore/issues/16920#issuecomment-989721078).
+
+> [!WARNING]
+> The Azure Cosmos DB SDK, which the EF provider uses, does not support synchronous I/O. As a result, synchronous EF APIs such as `ToList` or `SaveChanges` throw in version 9.0 and above; always use asynchronous
+> methods when using EF.
+> Previous versions of EF supported the synchronous APIs by calling `.Wait()` on the returned `Task`; this is known as "sync over async", and is a highly discouraged technique that can lead to deadlocks. See the EF 9.0 [breaking change note](xref:core/what-is-new/ef-core-9.0/breaking-changes#cosmos-nosync) for more information.
+
+Beyond the differences in relational and document databases, and limitations in the SDK, the EF Core provider for Azure Cosmos DB NoSQL does not include everything that _could_ be implemented using the combination of EF Core and the Azure Cosmos DB SDK. Potential enhancements in this area are tracked by [issues in the EF Core GitHub repo marked with the label `area-cosmos`](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aarea-cosmos+sort%3Areactions-%2B1-desc+label%3Atype-enhancement) The best way to indicate the importance of an issue is to vote (👍) for it. This data will then feed into the [planning process](xref:core/what-is-new/release-planning) for the next release.
diff --git a/entity-framework/core/providers/cosmos/modeling.md b/entity-framework/core/providers/cosmos/modeling.md
new file mode 100644
index 0000000000..c3c5262536
--- /dev/null
+++ b/entity-framework/core/providers/cosmos/modeling.md
@@ -0,0 +1,358 @@
+---
+title: Modeling - Azure Cosmos DB Provider - EF Core
+description: Configuring the model with the Azure Cosmos DB EF Core Provider
+author: roji
+ms.date: 09/26/2024
+uid: core/providers/cosmos/modeling
+---
+# Configuring the model with the EF Core Azure Cosmos DB Provider
+
+## Containers and entity types
+
+In Azure Cosmos DB, JSON documents are stored in containers. Unlike tables in relational databases, Azure Cosmos DB containers can contain documents with different shapes - a container does not impose a uniform schema on its documents. However, various configuration options are defined at the container level, and therefore affect all documents contained within it. See the [Azure Cosmos DB documentation on containers](/azure/cosmos-db/resource-model) for more information.
+
+By default, EF maps all entity types to the same container; this is usually a good default in terms of performance and pricing. The default container is named after the .NET context type (`OrderContext` in this case). To change the default container name, use <xref:Microsoft.EntityFrameworkCore.CosmosModelBuilderExtensions.HasDefaultContainer*>:
+
+```csharp
+modelBuilder.HasDefaultContainer("Store");
+```
+
+To map an entity type to a different container use <xref:Microsoft.EntityFrameworkCore.CosmosEntityTypeBuilderExtensions.ToContainer*>:
+
+```csharp
+modelBuilder.Entity<Order>().ToContainer("Orders");
+```
+
+Before mapping entity types to different containers, make sure you understand the potential performance and pricing implications (e.g. with regards to dedicated and shared throughput); [see the Azure Cosmos DB documentation to learn more](/azure/cosmos-db/resource-model).
+
+## IDs and keys
+
+Azure Cosmos DB requires all documents to have an `id` JSON property which uniquely identifies them. Like other EF providers, the EF Azure Cosmos DB provider will attempt to find a property named `Id` or `<type name>Id`, and configure that property as the key of your entity type, mapping it to the `id` JSON property. You can configure any property to be the key property by using <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.EntityTypeBuilder`1.HasKey*>; see [the general EF documentation on keys](xref:core/modeling/keys) for more information.
+
+Developers coming to Azure Cosmos DB from other databases sometimes expect the key (`Id`) property to be generated automatically. For example, on SQL Server, EF configures numeric key properties to be IDENTITY columns, where auto-incrementing values are generated in the database. In contrast, Azure Cosmos DB does not support automatic generation of properties, and so key properties must be explicitly set. Inserting an entity type with an unset key property will simply insert the CLR default value for that property (e.g. 0 for `int`), and a second insert will fail; EF issues a warning if you attempt to do this.
+
+If you'd like to have a GUID as your key property, you can configure EF to generate unique, random values at the client:
+
+```csharp
+modelBuilder.Entity<Session>().Property(b => b.Id).HasValueGenerator<GuidValueGenerator>();
+```
+
+## Partition keys
+
+Azure Cosmos DB uses partitioning to achieve horizontal scaling; proper modeling and careful selection of the partition key is vital for achieving good performance and keeping costs down. It's highly recommended to read [the Azure Cosmos DB documentation on partitioning](/azure/cosmos-db/partition-data) and to plan your partitioning strategy in advance.
+
+To configure the partition key with EF, call [HasPartitionKey](/dotnet/api/Microsoft.EntityFrameworkCore.CosmosEntityTypeBuilderExtensions.HasPartitionKey), passing it a regular property on your entity type:
+
+```csharp
+modelBuilder.Entity<Order>().HasPartitionKey(o => o.PartitionKey);
+```
+
+Any property can be made into a partition key as long as it is [converted to string](xref:core/modeling/value-conversions). Once configured, the partition key property should always have a non-null value; trying to insert a new entity type with an unset partition key property will result in an error.
+
+Note that Azure Cosmos DB allows two documents with the same `id` property to exist in a container, as long as they're in different partitions; this means that in order to uniquely identify a document within a container, both the `id` and the partition key properties must all be provided. Because of this, EF's internal notion of the entity primary key contains both of these elements by convention, unlike e.g. relational databases where there is no partition key concept. This means e.g. that [`FindAsync`](xref:core/change-tracking/entity-entries#find-and-findasync) requires both key and partition key properties ([see further docs](xref:core/providers/cosmos/querying#findasync)), and a query must specify these in its `Where` clause to benefit from efficient and cost-effective [`point reads`](xref:core/providers/cosmos/querying#point-reads).
+
+Note that the partition key is defined at the container level. This notably means that it's not possible for multiple entity types in the same container to have different partition key properties. If you need to define different partition keys, map the relevant entity types to different containers.
+
+### Hierarchical partition keys
+
+Azure Cosmos DB also supports _hierarchical_ partition keys to optimize data distribution even further; [see the documentation for more details](/azure/cosmos-db/hierarchical-partition-keys). EF 9.0 added support for hierarchical partition keys; to configure these, simply pass up to 3 properties to [HasPartitionKey](/dotnet/api/Microsoft.EntityFrameworkCore.CosmosEntityTypeBuilderExtensions.HasPartitionKey):
+
+```csharp
+modelBuilder.Entity<Order>().HasPartitionKey(o => new { e.TenantId, e.UserId, e.SessionId });
+```
+
+With such a hierarchical partition key, queries can be easily sent only to the a relevant subset of sub-partitions. For example, if you query for the Orders of a specific tenant, those queries will only be executed against the sub-partitions for that tenant.
+
+If you don't configure a partition key with EF, a warning will be logged at startup; EF Core will create containers with the partition key set to `__partitionKey`, and won't supply any value for it when inserting items. When no partition key is set, your container will be limited to 20 GB of data, which is the maximum storage for a single [logical partition](/azure/cosmos-db/partitioning-overview). While this can work for small dev/ test applications, it is highly discouraged to deploy a production application without a well-configured partition key strategy.
+
+Once your partition key properties are properly configured, you can provide values for them in queries; see [Querying with partition keys](xref:core/providers/cosmos/querying#partition-keys) for more information.
+
+## Discriminators
+
+Since multiple entity types may be mapped to the same container, EF Core always adds a `$type` discriminator property to all JSON documents you save (this property was called `Discriminator` before EF 9.0); this allows EF to recognize documents being loaded from the database, and materialize the right .NET type. Developers coming from relational databases may be familiar with discriminators in the context of [table-per-hierarchy inheritance (TPH)](xref:core/modeling/inheritance#table-per-hierarchy-and-discriminator-configuration); in Azure Cosmos DB, discriminators are used not just in inheritance mapping scenarios, but also because the same container can contain completely different document types.
+
+The discriminator property name and values can be configured with the standard EF APIs, [see these docs for more information](xref:core/modeling/inheritance). If you're mapping a single entity type to a container, are confident that you'll never be mapping another one, and would like to get rid of the discriminator property, call [HasNoDiscriminator](/dotnet/api/Microsoft.EntityFrameworkCore.Metadata.Builders.EntityTypeBuilder.HasNoDiscriminator):
+
+```csharp
+modelBuilder.Entity<Order>().HasNoDiscriminator();
+```
+
+Since the same container can contain different entity types, and the JSON `id` property must be unique within a container partition, you cannot have the same `id` value for entities of different types in the same container partition. Compare this to relational databases, where each entity type is mapped to a different table, and therefore has its own, separate key space. It is therefore your responsibility to ensure the `id` uniqueness of documents you insert into a container. If you need to have different entity types with the same primary key values, you can instruct EF to automatically insert the discriminator into the `id` property as follows:
+
+```csharp
+modelBuilder.Entity<Session>().HasDiscriminatorInJsonId();
+```
+
+While this may make it easier to work with `id` values, it may make it harder to interoperate with external applications working with your documents, as they now must be aware of EF's concatenated `id` format, as well as the discriminator values, which are by default derived from your .NET types. Note that this was the default behavior prior to EF 9.0.
+
+An additional option is to instruct EF to insert only the _root discriminator_, which is the discriminator of the root entity type of the hierarchy, into the `id` property:
+
+```csharp
+modelBuilder.Entity<Session>().HasRootDiscriminatorInJsonId();
+```
+
+This is similar, but allows EF to use efficient [point reads](xref:core/providers/cosmos/querying#point-reads) in more scenarios. If you need to insert a discriminator into the `id` property, consider inserting the root discriminator for better performance.
+
+## Provisioned throughput
+
+If you use EF Core to create the Azure Cosmos DB database or containers you can configure [provisioned throughput](/azure/cosmos-db/set-throughput) for the database by calling <xref:Microsoft.EntityFrameworkCore.CosmosModelBuilderExtensions.HasAutoscaleThroughput*?displayProperty=nameWithType> or <xref:Microsoft.EntityFrameworkCore.CosmosModelBuilderExtensions.HasManualThroughput*?displayProperty=nameWithType>. For example:
+
+<!--
+modelBuilder.HasManualThroughput(2000);
+modelBuilder.HasAutoscaleThroughput(4000);
+-->
+[!code-csharp[ModelThroughput](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosModelConfigurationSample.cs?name=ModelThroughput)]
+
+To configure provisioned throughput for a container call <xref:Microsoft.EntityFrameworkCore.CosmosEntityTypeBuilderExtensions.HasAutoscaleThroughput*?displayProperty=nameWithType> or <xref:Microsoft.EntityFrameworkCore.CosmosEntityTypeBuilderExtensions.HasManualThroughput*?displayProperty=nameWithType>. For example:
+
+<!--
+modelBuilder.Entity<Family>(
+    entityTypeBuilder =>
+    {
+        entityTypeBuilder.HasManualThroughput(5000);
+        entityTypeBuilder.HasAutoscaleThroughput(3000);
+    });
+-->
+[!code-csharp[EntityTypeThroughput](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosModelConfigurationSample.cs?name=EntityTypeThroughput)]
+
+## Time-to-live
+
+Entity types in the Azure Cosmos DB model can be configured with a default time-to-live. For example:
+
+```csharp
+modelBuilder.Entity<Hamlet>().HasDefaultTimeToLive(3600);
+```
+
+Or, for the analytical store:
+
+```csharp
+modelBuilder.Entity<Hamlet>().HasAnalyticalStoreTimeToLive(3600);
+```
+
+Time-to-live for individual entities can be set using a property mapped to "ttl" in the JSON document. For example:
+
+<!--
+            modelBuilder.Entity<Village>()
+                .HasDefaultTimeToLive(3600)
+                .Property(e => e.TimeToLive)
+                .ToJsonProperty("ttl");
+-->
+[!code-csharp[TimeToLiveProperty](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosModelConfigurationSample.cs?name=TimeToLiveProperty)]
+
+> [!NOTE]
+> A default time-to-live must configured on the entity type for the "ttl" to have any effect. See [_Time to Live (TTL) in Azure Cosmos DB_](/azure/cosmos-db/time-to-live) for more information.
+
+The time-to-live property is then set before the entity is saved. For example:
+
+<!--
+        var village = new Village { Id = "DN41", Name = "Healing", TimeToLive = 60 };
+        context.Add(village);
+        await context.SaveChangesAsync();
+-->
+[!code-csharp[SetTtl](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosModelConfigurationSample.cs?name=SetTtl)]
+
+The time-to-live property can be a [shadow property](xref:core/modeling/shadow-properties) to avoid polluting the domain entity with database concerns. For example:
+
+<!--
+            modelBuilder.Entity<Hamlet>()
+                .HasDefaultTimeToLive(3600)
+                .Property<int>("TimeToLive")
+                .ToJsonProperty("ttl");
+-->
+[!code-csharp[TimeToLiveShadowProperty](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosModelConfigurationSample.cs?name=TimeToLiveShadowProperty)]
+
+The shadow time-to-live property is then set by [accessing the tracked entity](xref:core/change-tracking/entity-entries). For example:
+
+<!--
+        var hamlet = new Hamlet { Id = "DN37", Name = "Irby" };
+        context.Add(hamlet);
+        context.Entry(hamlet).Property("TimeToLive").CurrentValue = 60;
+        await context.SaveChangesAsync();
+-->
+[!code-csharp[SetTtlShadow](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosModelConfigurationSample.cs?name=SetTtlShadow)]
+
+## Embedded entities
+
+> [!NOTE]
+> Related entity types are configured as owned by default. To prevent this for a specific entity type call <xref:Microsoft.EntityFrameworkCore.ModelBuilder.Entity*?displayProperty=nameWithType>.
+
+For Azure Cosmos DB, owned entities are embedded in the same item as the owner. To change a property name use [ToJsonProperty](/dotnet/api/Microsoft.EntityFrameworkCore.CosmosEntityTypeBuilderExtensions.ToJsonProperty):
+
+[!code-csharp[PropertyNames](../../../../samples/core/Cosmos/ModelBuilding/OrderContext.cs?name=PropertyNames)]
+
+With this configuration the order from the example above is stored like this:
+
+```json
+{
+    "Id": 1,
+    "PartitionKey": "1",
+    "TrackingNumber": null,
+    "id": "1",
+    "Address": {
+        "ShipsToCity": "London",
+        "ShipsToStreet": "221 B Baker St"
+    },
+    "_rid": "6QEKAM+BOOABAAAAAAAAAA==",
+    "_self": "dbs/6QEKAA==/colls/6QEKAM+BOOA=/docs/6QEKAM+BOOABAAAAAAAAAA==/",
+    "_etag": "\"00000000-0000-0000-683c-692e763901d5\"",
+    "_attachments": "attachments/",
+    "_ts": 1568163674
+}
+```
+
+Collections of owned entities are embedded as well. For the next example we'll use the `Distributor` class with a collection of `StreetAddress`:
+
+[!code-csharp[Distributor](../../../../samples/core/Cosmos/ModelBuilding/Distributor.cs?name=Distributor)]
+
+The owned entities don't need to provide explicit key values to be stored:
+
+[!code-csharp[OwnedCollection](../../../../samples/core/Cosmos/ModelBuilding/Sample.cs?name=OwnedCollection)]
+
+They will be persisted in this way:
+
+```json
+{
+    "Id": 1,
+    "Discriminator": "Distributor",
+    "id": "Distributor|1",
+    "ShippingCenters": [
+        {
+            "City": "Phoenix",
+            "Street": "500 S 48th Street"
+        },
+        {
+            "City": "Anaheim",
+            "Street": "5650 Dolly Ave"
+        }
+    ],
+    "_rid": "6QEKANzISj0BAAAAAAAAAA==",
+    "_self": "dbs/6QEKAA==/colls/6QEKANzISj0=/docs/6QEKANzISj0BAAAAAAAAAA==/",
+    "_etag": "\"00000000-0000-0000-683c-7b2b439701d5\"",
+    "_attachments": "attachments/",
+    "_ts": 1568163705
+}
+```
+
+Internally EF Core always needs to have unique key values for all tracked entities. The primary key created by default for collections of owned types consists of the foreign key properties pointing to the owner and an `int` property corresponding to the index in the JSON array. To retrieve these values entry API could be used:
+
+[!code-csharp[ImpliedProperties](../../../../samples/core/Cosmos/ModelBuilding/Sample.cs?name=ImpliedProperties)]
+
+> [!TIP]
+> When necessary the default primary key for the owned entity types can be changed, but then key values should be provided explicitly.
+
+### Collections of primitive types
+
+Collections of supported primitive types, such as `string` and `int`, are discovered and mapped automatically. Supported collections are all types that implement <xref:System.Collections.Generic.IReadOnlyList`1> or <xref:System.Collections.Generic.IReadOnlyDictionary`2>. For example, consider this entity type:
+
+<!--
+public class Book
+{
+    public Guid Id { get; set; }
+    public string Title { get; set; }
+    public IList<string> Quotes { get; set; }
+    public IDictionary<string, string> Notes { get; set; }
+}
+-->
+[!code-csharp[BookEntity](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosPrimitiveTypesSample.cs?name=BookEntity)]
+
+The `IList` and the `IDictionary` can be populated and persisted to the database:
+
+<!--
+using var context = new BooksContext();
+
+var book = new Book
+{
+    Title = "How It Works: Incredible History",
+    Quotes = new List<string>
+    {
+        "Thomas (Tommy) Flowers was the British engineer behind the design of the Colossus computer.",
+        "Invented originally for Guinness, plastic widgets are nitrogen-filled spheres.",
+        "For 20 years after its introduction in 1979, the Walkman dominated the personal stereo market."
+    },
+    Notes = new Dictionary<string, string>
+    {
+        { "121", "Fridges" },
+        { "144", "Peter Higgs" },
+        { "48", "Saint Mark's Basilica" },
+        { "36", "The Terracotta Army" }
+    }
+};
+
+context.Add(book);
+context.SaveChanges();
+-->
+[!code-csharp[Insert](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosPrimitiveTypesSample.cs?name=Insert)]
+
+This results in the following JSON document:
+
+```json
+{
+    "Id": "0b32283e-22a8-4103-bb4f-6052604868bd",
+    "Discriminator": "Book",
+    "Notes": {
+        "36": "The Terracotta Army",
+        "48": "Saint Mark's Basilica",
+        "121": "Fridges",
+        "144": "Peter Higgs"
+    },
+    "Quotes": [
+        "Thomas (Tommy) Flowers was the British engineer behind the design of the Colossus computer.",
+        "Invented originally for Guinness, plastic widgets are nitrogen-filled spheres.",
+        "For 20 years after its introduction in 1979, the Walkman dominated the personal stereo market."
+    ],
+    "Title": "How It Works: Incredible History",
+    "id": "Book|0b32283e-22a8-4103-bb4f-6052604868bd",
+    "_rid": "t-E3AIxaencBAAAAAAAAAA==",
+    "_self": "dbs/t-E3AA==/colls/t-E3AIxaenc=/docs/t-E3AIxaencBAAAAAAAAAA==/",
+    "_etag": "\"00000000-0000-0000-9b50-fc769dc901d7\"",
+    "_attachments": "attachments/",
+    "_ts": 1630075016
+}
+```
+
+These collections can then be updated, again in the normal way:
+
+<!--
+book.Quotes.Add("Pressing the emergency button lowered the rods again.");
+book.Notes["48"] = "Chiesa d'Oro";
+
+context.SaveChanges();
+-->
+[!code-csharp[Updates](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosPrimitiveTypesSample.cs?name=Updates)]
+
+Limitations:
+
+* Only dictionaries with string keys are supported.
+* Support for querying into primitive collections was added in EF Core 9.0.
+
+## Optimistic concurrency with eTags
+
+To configure an entity type to use [optimistic concurrency](xref:core/saving/concurrency) call <xref:Microsoft.EntityFrameworkCore.CosmosEntityTypeBuilderExtensions.UseETagConcurrency*>. This call will create an `_etag` property in [shadow state](xref:core/modeling/shadow-properties) and set it as the concurrency token.
+
+[!code-csharp[Main](../../../../samples/core/Cosmos/ModelBuilding/OrderContext.cs?name=ETag)]
+
+To make it easier to resolve concurrency errors you can map the eTag to a CLR property using <xref:Microsoft.EntityFrameworkCore.CosmosPropertyBuilderExtensions.IsETagConcurrency*>.
+
+[!code-csharp[Main](../../../../samples/core/Cosmos/ModelBuilding/OrderContext.cs?name=ETagProperty)]
+
+## Database triggers
+
+> [!NOTE]
+> Database trigger execution support was introduced in EF Core 10.0.
+
+Azure Cosmos DB supports pre- and post-triggers that run before or after database operations. EF Core can be configured to execute these triggers when performing save operations.
+
+> [!IMPORTANT]
+> Triggers are executed server-side by Azure Cosmos DB when EF Core performs operations, but they are not enforced - operations can be performed without running triggers if accessing the database directly. This means triggers should not be used for security-related functionality such as authentication or auditing, as they can be bypassed by applications that access the database directly without using EF Core.
+
+To configure triggers on an entity type, use the `HasTrigger` method:
+
+[!code-csharp[TriggerConfiguration](../../../../samples/core/Cosmos/ModelBuilding/TriggerSample.cs?name=TriggerConfiguration)]
+
+The `HasTrigger` method requires:
+
+* **modelName**: The name of the trigger in Azure Cosmos DB
+* **triggerType**: Either `TriggerType.Pre` (executed before the operation) or `TriggerType.Post` (executed after the operation)
+* **triggerOperation**: The operation that should execute the trigger - `Create`, `Replace`, `Delete`, or `All`
+
+Before triggers can be executed, they must be created in Azure Cosmos DB using the Cosmos SDK or Azure portal. The trigger name configured in EF Core must match the trigger name in Azure Cosmos DB.
diff --git a/entity-framework/core/providers/cosmos/planetary-docs-sample.md b/entity-framework/core/providers/cosmos/planetary-docs-sample.md
new file mode 100644
index 0000000000..2225fe864c
--- /dev/null
+++ b/entity-framework/core/providers/cosmos/planetary-docs-sample.md
@@ -0,0 +1,302 @@
+---
+title: Azure Cosmos DB Provider - Planetary Docs sample - EF Core
+description: An end-to-end sample to demonstrate create, read and update capabilities in the EF Core Azure Cosmos DB provider.
+author: JeremyLikness
+ms.author: jeliknes
+ms.date: 01/27/2022
+uid: core/providers/cosmos/planetary-docs-sample
+---
+# The Planetary Docs Sample
+
+The Planetary Docs sample is designed to provide a comprehensive example that demonstrates how an app with create, read, and update requirements is architected with the EF Core Azure Cosmos DB provider. This Blazor Server app provides search capabilities, an interface to add and update documents, and a system to store versioned snapshots. The fact that the payloads are documents with metadata that may change over time makes it ideally suited for a document database. The database uses multiple containers with different partition keys and a mechanism to provide blazing fast, inexpensive searches for specific fields. It also handles concurrency.
+
+## Get started
+
+Here's how to get started in a few easy steps.
+
+### Clone this repo
+
+Using your preferred tools, clone the repository. The `git` command looks like this:
+
+```bash
+git clone https://github.com/dotnet/EntityFramework.Docs
+```
+
+### Create an Azure Cosmos DB instance
+
+To run this demo, you will need to either run the [Azure Cosmos DB emulator](/azure/cosmos-db/local-emulator)
+or create an Azure Cosmos DB account. You can read
+[Create an Azure Cosmos DB account](/azure/cosmos-db/create-cosmosdb-resources-portal#create-an-azure-cosmos-db-account) to learn how. Be sure to check out the option
+for a [free account](/azure/cosmos-db/optimize-dev-test#azure-cosmos-db-free-tier)!
+
+Choose the **SQL API**.
+
+> This project is configured to use the emulator "out of the box."
+
+### Initialize the database
+
+Navigate to the `PlanetaryDocsLoader` project.
+
+If you are using the emulator, make sure the emulator is running.
+
+If you are using an Azure Cosmos DB account, update `Program.cs` with:
+
+- The Azure Cosmos DB endpoint
+- The Azure Cosmos DB key
+
+> The endpoint is the `URI` and the key is the `Primary Key` on the **keys** pane of your Azure Cosmos DB account in the [Azure Portal](https://portal.azure.com/).
+
+Run the application (`dotnet run` from the command line). You should see status
+as it parses documents, loads them to the database and then runs tests. This step
+may take several minutes.
+
+### Configure and run the Blazor app
+
+If you are using the emulator, the Blazor app is ready to run. If you are using an account, navigate to the `PlanetaryDocs` Blazor Server project and either update the `CosmosSettings` in the `appsettings.json` file, or create a new section in `appsettings.Development.json` and add your access key and endpoint. Run the app. You should be ready to go!
+
+## Project Details
+
+The following features were integrated into this project.
+
+`PlanetaryDocsLoader` parses the docs repository and inserts the
+documents into the database. It includes tests to verify the
+functionality is working.
+
+`PlanetaryDocs.Domain` hosts the domain classes, validation logic,
+and signature (interface) for data access.
+
+`PlanetaryDocs.DataAccess` contains the EF Core `DbContext`
+and an implementation of the data access service.
+
+- `DocsContext`
+  - Has model-building code that shows how to map ownership
+  - Uses value converters with JSON serialization to support primitives collection and nested
+complex types
+  - Demonstrates use of partition keys, including how to define them for the
+model and how to specify them in queries
+  - Provides an example of specifying the container by entity
+  - Shows how to turn off the discriminator
+  - Stores two entity types (aliases and tags) in the same container
+  - Uses a "shadow property" to track partition keys on aliases and tags
+  - Hooks into the `SavingChanges` event to automate the generation of audit snapshots
+- `DocumentService`
+  - Shows various strategies for C.R.U. operations
+  - Programmatically synchronizes related entities
+  - Demonstrates how to handle updates with concurrency to disconnected entities
+  - Uses the new `IDbContextFactory<T>` implementation to manage context instances
+
+`PlanetaryDocs` is a Blazor Server app.
+
+- Examples of JavaScript interop in the `TitleService`, `HistoryService`, and `MultiLineEditService`.
+- Uses keyboard handlers to allow keyboard-based navigation and input on the edit page
+- Shows a generic autocomplete component with debounce built-in
+- `HtmlPreview` uses a phantom `textarea` to render an HTML preview
+- `MarkDig` is used to transform markdown into HTML
+- The `MultiLineEdit` component shows a workaround using JavaScript interop for limitations with fields that have large input values
+- The `Editor` component supports concurrency. If you open a document twice in separate tabs and edit in both, the second will notify that changes were made and provide the option to reset or overwrite
+
+Your feedback is valuable! [File an issue](https://github.com/dotnet/EntityFramework.Docs/issues/new) to report defects or request changes (we also accept pull requests.)
+
+## Introducing Planetary Docs
+
+You may (or may not) know that Microsoft's [official documentation](/) runs entirely on open source. It uses markdown with some metadata enhancements to build the interactive documentation that .NET developers use daily. The hypothetical scenario for Planetary Docs is to provide a web-based tool for authoring the docs. It allows setting up the title, description, the alias of the author, assigning tags, editing markdown and previewing the HTML output.
+
+It's planetary because Azure Cosmos DB is "planetary scale". The app provides the ability to search documents. Documents are stored under aliases and tags for fast lookup, but full text search is available as well. The app automatically audits the documents (it takes snapshots of the document anytime it is edited and provides a view of the history).
+
+> [!NOTE]
+> Delete and restore aren't implemented.
+
+Here's a look at the document for `Document`:
+
+:::code language="csharp" source="../../../../samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/Document.cs":::
+
+For faster lookups, the `DocumentSummary` class contains some basic information about the document.
+
+:::code language="csharp" source="../../../../samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/DocumentSummary.cs":::
+
+This is used by both `Author` and `Tag`. They look pretty similar. Here's the `Tag` code:
+
+:::code language="csharp" source="../../../../samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/Tag.cs":::
+
+The `ETag` property is implemented on the model so it can be sent around the app and maintain the value (as opposed to using a [shadow property](xref:core/modeling/shadow-properties) ). The `ETag` is used [for concurrency](/dotnet/api/microsoft.azure.documents.resource.etag) in Azure Cosmos DB. Concurrency support is implemented in the sample app. To test it, try opening the same document in two tabs, then update one and save it, and finally update the other and save it.
+
+People often struggle with [disconnected entities](xref:core/saving/disconnected-entities) in EF Core. The pattern is used in this app to provide an example. It's not necessary in Blazor Server, but makes it easier to scale the app. The alternative approach is to track the state of the entity with EF Core's [change tracker](xref:core/change-tracking/index). The change tracker would enable you to drop the `ETag` property and use a shadow property instead.
+
+Finally, there is the `DocumentAudit` document.
+
+:::code language="csharp" source="../../../../samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/DocumentAudit.cs":::
+
+Ideally, the `Document` snapshot would be a proper property instead of a string. This is one of the [EF Core Azure Cosmos DB provider limitations](xref:core/providers/cosmos/limitations) EF Core currently has. There is not a way for `Document` to do double-duty as both a standalone entity and an "owned" entity. If you want the user to be able to search on properties in the historical document, you could either add those properties to the `DocumentAudit` class to be automatically indexed, or make a `DocumentSnapshot` class that shares the same properties but is configured as "owned" by the `DocumentAudit` parent.
+
+### Azure Cosmos DB setup
+
+The strategy for the data store is to use three containers.
+
+One container named `Documents` is dedicated exclusively to documents. They are partitioned by `id`. That's one partition per document. [Here's the rationale](/azure/cosmos-db/partitioning-overview#using-item-id-as-the-partition-key).
+
+The audits are stored in a container named `Audits`. The partition key is the document id, so all histories are stored in the same partition. This allows for fast, single-partition queries over historical data.
+
+Finally, there is some metadata that is stored in `Meta`. The partition key is the meta data type, either `Author` or `Tag`. The metadata contains summaries of the related documents. If the user wants to search for documents with tag `x` the app doesn't have to scan all documents. Instead, it reads the document for tag `x` that contains a collection of the related documents it is tagged in. This approach is fast for read but does require some additional work on writes and updates that will be covered later.
+
+### Entity Framework Core
+
+The `DbContext` for Planetary Docs is named `DocsContext` in the `PlanetaryDocs.DataAccess` project. It has a constructor that takes a `DbContextOptions<DocsContext>` parameter and passes it to the base class to enable run-time configuration.
+
+:::code language="csharp" source="../../../../samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/DocsContext.cs" range="31-33":::
+
+The `DbSet<>` generic type is used to specify the classes that should be persisted.
+
+:::code language="csharp" source="../../../../samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/DocsContext.cs" range="35-53":::
+
+A few helper methods on the `DbContext` class make it easier to search for and assign metadata. Both metadata items use a string-based key and specify the type as the partition key. This enables a generic strategy to find records:
+
+:::code language="csharp" source="../../../../samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/DocsContext.cs" range="89-106":::
+
+`FindAsync` (the existing method on the base `DbContext` that is shipped as part of EF Core) doesn't require closing the type to specify the key. It takes it as an `object` parameter and applies it based on the internal representation of the model.
+
+The entities are configured in the `OnModelCreating` overload. Here's the first configuration for `DocumentAudit`.
+
+:::code language="csharp" source="../../../../samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/DocsContext.cs" range="157-161":::
+
+This configuration informs EF Core that...
+
+- There will only be one type stored in the table, so there is no need for a discriminator to distinguish types.
+- The documents should be stored in a container named `Audits`.
+- The partition key is the document id.
+- The access key is the unique identifier of the audit combined with the partition key (the unique identifier of the document).
+
+Next, the `Document` is configured:
+
+:::code language="csharp" source="../../../../samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/DocsContext.cs" range="163-171":::
+
+Here we specify a few more details, such as how the `ETag` property should be mapped:
+
+:::code language="csharp" source="../../../../samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/DocsContext.cs" range="173-183":::
+
+The partition key is configured as a shadow property. Unlike the `ETag` property, the partition key is fixed and therefore doesn't have to live on the model. Read this to learn more about models in EF Core: [Creating and configuring a model](xref:core/modeling/index).
+
+The `SaveChanges` event is used that to automatically insert a document snapshot any time a document is inserted or updated. Every time changes are saved and the event is fired, the `ChangeTracker` is queried to find an `Document` entities that were added or updated. An audit entry is inserted for each one.
+
+:::code language="csharp" source="../../../../samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/DocsContext.cs" range="204-219":::
+
+Doing it this way will ensure audits are generated even if you build other apps that share the same `DbContext`.
+
+### The Data Service
+
+A common question is whether developers should use the repository pattern with EF Core, and the answer is, "It depends." To the extent that the `DbContext` is testable and can be interfaced for mocking, there are many cases when using it directly is perfectly fine. Whether or not you specifically use the repository pattern, adding a data access layer often makes sense when there are database-related tasks to do outside of the EF Core functionality. In this example, there is database-related logic that makes more sense to isolate rather than bloating the `DbContext`, so it is implemented in `DocumentService`.
+
+The service constructor is passed a `DbContext` factory. This is provided by EF Core to easily create new contexts using your preferred configuration. The app uses a "context per operation" rather than using long-lived contexts and change tracking. Here's the configuration to grab the settings and tell the factory to make contexts that connect to Azure Cosmos DB. The factory is then automatically injected into the service.
+
+:::code language="csharp" source="../../../../samples/end2end/PlanetaryDocs/PlanetaryDocs/Startup.cs" range="39-54":::
+
+Using this pattern demonstrates disconnected entities and also builds some resiliency against the case when your [Blazor SignalR circuit](/aspnet/core/blazor/fundamentals/signalr) may break.
+
+#### Load a document
+
+The document load is intended to get a snapshot that isn't tracked for changes because those will be sent in a separate operation. The main requirement is to set the partition key.
+
+:::code language="csharp" source="../../../../samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/DocumentService.cs" range="293-298":::
+
+#### Query documents
+
+The document query allows the user to search on text anywhere in the document and to further filter by author and/or tag. The pseudo code looks like this:
+
+- If there is a tag, load the tag and use the document summary list as the result set
+  - If there is also an author, load the author and filter the results to the intersection of results between tag and author
+    - If there is text, load the documents that match the text then filter the results to the author and tag intersection
+  - If there is also text, load the documents that match the text then filter the results to the tag results
+- Else if there is an author, load the author and filter the results to the document summary list as the result set
+  - If there is text, load the documents that match the text then filter the results to the author results
+- Else load the documents that match the text
+
+Performance-wise, a tag and/or author-based search only requires one or two documents to be loaded. A text search always loads matching documents and then further filters the list based on the existing documents, so it is significantly slower (but still fast).
+
+Here's the implementation. Note the `HashSet` works due to the `Equals` and `GetHashCode` overrides:
+
+:::code language="csharp" source="../../../../samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/DocumentService.cs" range="65-142":::
+
+### Create a document
+
+Ordinarily, creating a document with EF Core would be as easy as:
+
+```csharp
+context.Add(document);
+await context.SaveChangesAsync();
+```
+
+For `PlanetaryDocs` however, the document can have associated tags and an author. These have summaries that must be updated explicitly because there are no formal relationships.
+
+> [!NOTE]
+> This example uses code to keep documents in sync. If the database is used by multiple applications and services, it may make more sense to implement the logic at the database level and use [triggers and stored procedures](/azure/cosmos-db/how-to-write-stored-procedures-triggers-udfs) instead.
+
+A generic method handles keeping the documents in sync. The pseudo code is the same whether it is for an author or a tag:
+
+- If the document was inserted or updated
+  - A new document will result in "author changed" and "tags added"
+  - If the author was changed or a tag removed
+    - Load the metadata document for the old author or removed tag
+    - Remove the document from the summary list
+  - If the author was changed
+    - Load the metadata document for the new author
+    - Add the document to the summary list
+      - Load all tags for the model
+      - Update the author in the summary list for each tag
+  - If tags were added
+    - If tag exists
+      - Load the metadata document for the tag
+      - Add the document to the summary list
+    - Else
+      - Create a new tag with the document in the summary list
+  - If the document was updated and the title changed
+    - Load the metadata for the existing author and/or tags
+    - Update the title in the summary list
+
+This algorithm is an example of how EF Core shines. All of these manipulations can happen in a single pass. If a tag is referenced multiple times, it is only ever loaded once. The final call to save changes will commit all changes including inserts.
+
+Here's the code for handling changes to tags that is called as part of the insert process:
+
+:::code language="csharp" source="../../../../samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/DocumentService.cs" range="322-401":::
+
+The algorithm as implemented works for inserts, updates, and deletes.
+
+#### Update a document
+
+Now that the metadata sync has been implemented, the update code is simply:
+
+:::code language="csharp" source="../../../../samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/DocumentService.cs" range="189-198":::
+
+Concurrency works in this scenario because we persist the loaded version of the entity in the `ETag` property.
+
+#### Delete a document
+
+The delete code uses a simplified algorithm to remove existing tag and author references.
+
+:::code language="csharp" source="../../../../samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/DocumentService.cs" range="247-272":::
+
+#### Search metadata (tags or authors)
+
+Finding tags or authors that match a text string is a straightforward query. The key is to improve performance and reduce the cost of the query by making it a single partition query.
+
+:::code language="csharp" source="../../../../samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/DocumentService.cs" range="149-161":::
+
+The `ComputePartitionKey` method returns the simple type name as the partition. The authors list is not long, so the code pulls the aliases first, then applies an in-memory filter for the _contains_ logic.
+
+### Deal with document audits
+
+The last set of APIs deal with the automatically generated audits. This method loads document audits then projects them onto a summary. The projection is not done in the query because it requires deserializing the snapshot. Instead, the list of audits is obtained, then snapshots are deserialized to pull out the relevant data to display such as title and author.
+
+:::code language="csharp" source="../../../../samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/DocumentService.cs" range="205-215":::
+
+The `ToListAsync` materializes the query results and everything after is manipulated in memory.
+
+The app also lets you review an audit record using the same viewer control that live documents use. A method loads the audit, materializes the snapshot and returns a `Document` entity for the view to use.
+
+:::code language="csharp" source="../../../../samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/DocumentService.cs" range="223-240":::
+
+Finally, although you can delete a record, the audits remain. The web app doesn't implement this yet, but it is implemented in the data service. The steps are simply deserialize the requested version and insert it.
+
+:::code language="csharp" source="../../../../samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/DocumentService.cs" range="280-285":::
+
+## Conclusion
+
+The goal behind the sample is to provide some guidance for using the EF Core Azure Cosmos DB provider and to demonstrate the areas it shines. Please [file an issue](https://github.com/dotnet/EntityFramework.Docs/issues/new) with feedback or suggestions. We accept pull requests, so if you want to implement missing functionality or see an area of improvement, let us know!
diff --git a/entity-framework/core/providers/cosmos/querying.md b/entity-framework/core/providers/cosmos/querying.md
new file mode 100644
index 0000000000..582a085599
--- /dev/null
+++ b/entity-framework/core/providers/cosmos/querying.md
@@ -0,0 +1,323 @@
+---
+title: Querying - Azure Cosmos DB Provider - EF Core
+description: Querying with the Azure Cosmos DB EF Core Provider
+author: roji
+ms.date: 09/19/2024
+uid: core/providers/cosmos/querying
+---
+# Querying with the EF Core Azure Cosmos DB Provider
+
+## Querying basics
+
+[EF Core LINQ queries](xref:core/querying/index) can be executed against Azure Cosmos DB in the same way as for other database providers. For example:
+
+```csharp
+public class Session
+{
+    public Guid Id { get; set; }
+    public string Category { get; set; }
+
+    public string TenantId { get; set; } = null!;
+    public Guid UserId { get; set; }
+    public int SessionId { get; set; }
+}
+
+var stringResults = await context.Sessions
+    .Where(
+        e => e.Category.Length > 4
+            && e.Category.Trim().ToLower() != "disabled"
+            && e.Category.TrimStart().Substring(2, 2).Equals("xy", StringComparison.OrdinalIgnoreCase))
+    .ToListAsync();
+```
+
+> [!NOTE]
+> The Azure Cosmos DB provider does not translate the same set of LINQ queries as other providers.
+> For example, the EF `Include()` operator isn't supported on Azure Cosmos DB, since cross-document queries aren't supported in the database.
+
+## Partition keys
+
+The advantage of partitioning is to have your queries execute only against the partition where the relevant data is found, saving costs and ensuring faster result speed. Queries which don't specify partition keys are executed on all the partitions, which can be quite costly.
+
+Starting with EF 9.0, EF automatically detects and extracts partition key comparisons in your LINQ query's `Where` operators. Let's assume we execute the following query against our `Session` entity type, which is configured with a hierarchical partition key:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Session>()
+        .HasPartitionKey(b => new { b.TenantId, b.UserId, b.SessionId })
+}
+
+var tenantId = "Microsoft";
+var userId = new Guid("00aa00aa-bb11-cc22-dd33-44ee44ee44ee");
+var username = "scott";
+
+var sessions = await context.Sessions
+    .Where(
+        e => e.TenantId == tenantId
+             && e.UserId == userId
+             && e.SessionId > 0
+             && e.Username == username)
+    .ToListAsync();
+```
+
+Examining the logs generated by EF, we see this query executed as follows:
+
+```sql
+Executed ReadNext (166.6985 ms, 2.8 RU) ActivityId='312da0d2-095c-4e73-afab-27072b5ad33c', Container='test', Partition='["Microsoft","00aa00aa-bb11-cc22-dd33-44ee44ee44ee"]', Parameters=[]
+SELECT VALUE c
+FROM root c
+WHERE ((c["SessionId"] > 0) AND CONTAINS(c["Username"], "a"))
+```
+
+In these logs, we notice the following:
+
+* The first two comparisons - on `TenantId` and `UserId` - have been lifted out, and appear in the `ReadNext` "Partition" rather than in the `WHERE` clause; this means that query will only execute on the subpartitions for those values.
+* `SessionId` is also part of the hierarchical partition key, but instead of an equality comparison, it uses a greater-than operator (`>`), and therefore cannot be lifted out. It is part of the `WHERE` clause like any regular property.
+* `Username` is a regular property - not part of the partition key - and therefore remains in the `WHERE` clause as well.
+
+Note that even though some of the partition key values are not provided, hierarchical partition keys still allow targeting only the subpartitions which correspond to the first two properties. While this isn't as efficient as targeting a single partition (as identified by all three properties), it's still much more efficient than targeting all partitions.
+
+Rather than referencing partition key properties in a `Where` operator, you can explicitly specify them by using the <xref:Microsoft.EntityFrameworkCore.CosmosQueryableExtensions.WithPartitionKey*> operator:
+
+```c#
+var sessions = await context.Sessions
+    .WithPartitionKey(tenantId, userId)
+    .Where(e => e.SessionId > 0 && e.Username.Contains("a"))
+    .ToListAsync();
+```
+
+This executes in the same way as the above query, and can be preferable if you want to make partition keys more explicit in your queries. Using <xref:Microsoft.EntityFrameworkCore.CosmosQueryableExtensions.WithPartitionKey*> may be necessary in versions of EF prior to 9.0 - keep an eye on the logs to ensure that queries are using partition keys as expected.
+
+## Point reads
+
+While Azure Cosmos DB allows for powerful querying via SQL, such queries can be quite expensive. Azure Cosmos DB also supports _point reads_, which should be used when retrieving a single document if both the `id` property and the entire partition key are known. Point reads directly identify a specific document in a specific partition, and execute extremely efficiently and with reduced costs compared to retrieving the same document with a query. It's recommended to design your system to leverage point reads as often as possible. To read more, see the [Azure Cosmos DB documentation](/azure/cosmos-db/nosql/how-to-dotnet-read-item).
+
+In the previous section, we saw EF identifying and extracting partition key comparisons from the `Where` clause for more efficient querying, restricting processing only to the relevant partitions. It's possible to go a step further, and provide the `id` property in the query as well. Let's examine the following query:
+
+```c#
+var session = await context.Sessions.SingleAsync(
+    e => e.Id == someId
+         && e.TenantId == tenantId
+         && e.UserId == userId
+         && e.SessionId == sessionId);
+```
+
+In this query, a value for the `Id` property is provided (which is mapped to the Azure Cosmos DB `id` property), as well as values for all the partition key properties. Furthermore, there are no additional components to the query. When all these conditions are met, EF is able to execute the query as a point read:
+
+```console
+Executed ReadItem (46 ms, 1 RU) ActivityId='d7391311-2266-4811-ae2d-535904c42c43', Container='test', Id='9', Partition='["Microsoft","00aa00aa-bb11-cc22-dd33-44ee44ee44ee",10.0]'
+```
+
+Note the `ReadItem`, which indicates that the query was executed as an efficient point read - no SQL query is involved.
+
+Note that as with partition key extraction, significant improvements have been made to this mechanism in EF 9.0; older versions do not reliably detect and use point reads.
+
+## Pagination
+
+> [!NOTE]
+> This feature was introduced in EF Core 9.0 and is still experimental. Please let us know how it works for you and if you have any feedback.
+
+Pagination refers to retrieving results in pages, rather than all at once; this is typically done for large resultsets, where a user interface is displayed, allowing users to navigate through pages of the results.
+
+A common way to implement pagination with databases is to use the `Skip` and `Take` LINQ operators (`OFFSET` and `LIMIT` in SQL). Given a page size of 10 results, the third page can be fetched with EF Core as follows:
+
+```csharp
+var position = 20;
+var nextPage = await context.Session
+    .OrderBy(s => s.Id)
+    .Skip(position)
+    .Take(10)
+    .ToListAsync();
+```
+
+Unfortunately, this technique is quite inefficient and can considerably increase querying costs. Azure Cosmos DB provides a special mechanism for paginating through the result of a query, via the use of _continuation tokens_:
+
+```csharp
+CosmosPage firstPage = await context.Sessions
+    .OrderBy(s => s.Id)
+    .ToPageAsync(pageSize: 10, continuationToken: null);
+
+string continuationToken = firstPage.ContinuationToken;
+foreach (var session in firstPage.Values)
+{
+    // Display/send the sessions to the user
+}
+```
+
+Rather than terminating the LINQ query with `ToListAsync` or similar, we use the <xref:Microsoft.EntityFrameworkCore.CosmosQueryableExtensions.ToPageAsync*> method, instructing it to get at most 10 items in every page (note that there may be fewer items in the database). Since this is our first query, we'd like to get results from the beginning, and pass `null` as the continuation token. <xref:Microsoft.EntityFrameworkCore.CosmosQueryableExtensions.ToPageAsync*> returns a <xref:Microsoft.EntityFrameworkCore.CosmosPage`1>, which exposes a continuation token and the values in the page (up to 10 items). Your program will typically send those values to the client, along with the continuation token; this will allow resuming the query later and fetching more results.
+
+Let's assume the user now clicks on the "Next" button in their UI, asking for the next 10 items. You can then execute the query as follows:
+
+```csharp
+CosmosPage nextPage = await context.Sessions.OrderBy(s => s.Id).ToPageAsync(10, continuationToken);
+string continuationToken = nextPage.ContinuationToken;
+foreach (var session in nextPage.Values)
+{
+    // Display/send the sessions to the user
+}
+```
+
+We execute the same query, but this time we pass in the continuation token received from the first execution; this instructs the query engine to continue the query where it left off, and fetch the next 10 items. Once we fetch the last page and there are no more results, the continuation token will be `null`, and the "Next" button can be grayed out. This method of paginating is extremely efficient and cost-effective compared to using `Skip` and `Take`.
+
+To learn more about pagination in Azure Cosmos DB, [see this page](/azure/cosmos-db/nosql/query/pagination).
+
+> [!NOTE]
+> Azure Cosmos DB does not support backwards pagination, and does not provide a count of the total pages or items.
+>
+> <xref:Microsoft.EntityFrameworkCore.CosmosQueryableExtensions.ToPageAsync*> is currently annotated as experimental, since it may be replaced with a more generic EF pagination API that isn't Azure Cosmos DB specific. Although using the current API will generate a compilation warning (`EF9102`), doing so should be safe - future changes may require minor tweaks in the API shape.
+
+## `FindAsync`
+
+[`FindAsync`](xref:core/change-tracking/entity-entries#find-and-findasync) is a useful API for getting an entity by its primary key, and avoiding a database roundtrip when the entity has already been loaded and is tracked by the context.
+
+Developers familiar with relational databases are used to the primary key of an entity type consisting e.g. of an `Id` property. When using the EF Azure Cosmos DB provider, the primary key contains the partition key properties in addition to the property mapped to the JSON `id` property; this is the case since Azure Cosmos DB allows different partitions to contain documents with the same JSON `id` property, and so only the combined `id` and partition key uniquely identify a single document in a container:
+
+```csharp
+public class Session
+{
+    public Guid Id { get; set; }
+    public string PartitionKey { get; set; }
+    ...
+}
+
+var mySession = await context.FindAsync(id, pkey);
+```
+
+If you have a hierarchical partition key, you must pass all partition key values to `FindAsync`, in the order in which they were configured.
+
+> [!NOTE]
+> Use `FindAsync` only when the entity might already be tracked by your context, and you want to avoid the database roundtrip.
+> Otherwise, simply use `SingleAsync` - there is no performance difference between the two when the entity needs to be loaded from the database.
+
+## SQL queries
+
+Queries can also be written [directly in SQL](xref:core/querying/sql-queries). For example:
+
+```csharp
+var rating = 3;
+_ = await context.Blogs
+    .FromSql($"SELECT VALUE c FROM root c WHERE c.Rating > {rating}")
+    .ToListAsync();
+```
+
+This query results in the following query execution:
+
+```sql
+SELECT VALUE s
+FROM (
+    SELECT VALUE c FROM root c WHERE c.Angle1 <= @p0
+) s
+```
+
+Note that <xref:Microsoft.EntityFrameworkCore.CosmosQueryableExtensions.FromSql*> was introduced in EF 9.0. In previous versions, <xref:Microsoft.EntityFrameworkCore.CosmosQueryableExtensions.FromSqlRaw*> can be used instead, although note that that method is vulnerable to SQL injection attacks.
+
+For more information on SQL querying, see the [relational documentation on SQL queries](xref:core/querying/sql-queries); most of that content is relevant for the Azure Cosmos DB provider as well.
+
+## Function mappings
+
+This section shows which .NET methods and members are translated into which SQL functions when querying with the Azure Cosmos DB provider.
+
+### Date and time functions
+
+.NET                                       | SQL                                                                               | Added in
+------------------------------------------ | --------------------------------------------------------------------------------- | --------
+DateTime.UtcNow                            | [GetCurrentDateTime()](/azure/cosmos-db/nosql/query/getcurrentdatetime)
+DateTimeOffset.UtcNow                      | [GetCurrentDateTime()](/azure/cosmos-db/nosql/query/getcurrentdatetime)
+dateTime.Year<sup>1</sup>                  | [DateTimePart("yyyy", dateTime)](/azure/cosmos-db/nosql/query/datetimepart)       | EF 9
+dateTimeOffset.Year<sup>1</sup>            | [DateTimePart("yyyy", dateTimeOffset)](/azure/cosmos-db/nosql/query/datetimepart) | EF 9
+dateTime.AddYears(years)<sup>1</sup>       | [DateTimeAdd("yyyy", dateTime)](/azure/cosmos-db/nosql/query/datetimeadd)         | EF 9
+dateTimeOffset.AddYears(years)<sup>1</sup> | [DateTimeAdd("yyyy", dateTimeOffset)](/azure/cosmos-db/nosql/query/datetimeadd)   | EF 9
+
+<sup>1</sup> The other component members are translated as well (Month, Day...).
+
+### Numeric functions
+
+.NET                       | SQL
+-------------------------- | ---------------------------------------------------
+double.DegreesToRadians(x) | [RADIANS(@x)](/azure/cosmos-db/nosql/query/radians)
+double.RadiansToDegrees(x) | [DEGREES(@x)](/azure/cosmos-db/nosql/query/degrees)
+EF.Functions.Random()      | [RAND()](/azure/cosmos-db/nosql/query/rand)
+Math.Abs(value)            | [ABS(@value)](/azure/cosmos-db/nosql/query/abs)
+Math.Acos(d)               | [ACOS(@d)](/azure/cosmos-db/nosql/query/acos)
+Math.Asin(d)               | [ASIN(@d)](/azure/cosmos-db/nosql/query/asin)
+Math.Atan(d)               | [ATAN(@d)](/azure/cosmos-db/nosql/query/atan)
+Math.Atan2(y, x)           | [ATN2(@y, @x)](/azure/cosmos-db/nosql/query/atn2)
+Math.Ceiling(d)            | [CEILING(@d)](/azure/cosmos-db/nosql/query/ceiling)
+Math.Cos(d)                | [COS(@d)](/azure/cosmos-db/nosql/query/cos)
+Math.Exp(d)                | [EXP(@d)](/azure/cosmos-db/nosql/query/exp)
+Math.Floor(d)              | [FLOOR(@d)](/azure/cosmos-db/nosql/query/floor)
+Math.Log(a, newBase)       | [LOG(@a, @newBase)](/azure/cosmos-db/nosql/query/log)
+Math.Log(d)                | [LOG(@d)](/azure/cosmos-db/nosql/query/log)
+Math.Log10(d)              | [LOG10(@d)](/azure/cosmos-db/nosql/query/log10)
+Math.Pow(x, y)             | [POWER(@x, @y)](/azure/cosmos-db/nosql/query/power)
+Math.Round(d)              | [ROUND(@d)](/azure/cosmos-db/nosql/query/round)
+Math.Sign(value)           | [SIGN(@value)](/azure/cosmos-db/nosql/query/sign)
+Math.Sin(a)                | [SIN(@a)](/azure/cosmos-db/nosql/query/sin)
+Math.Sqrt(d)               | [SQRT(@d)](/azure/cosmos-db/nosql/query/sqrt)
+Math.Tan(a)                | [TAN(@a)](/azure/cosmos-db/nosql/query/atan)
+Math.Truncate(d)           | [TRUNC(@d)](/azure/cosmos-db/nosql/query/trunc)
+
+> [!TIP]
+> In addition to the methods listed here, corresponding [generic math](/dotnet/standard/generics/math) implementations
+> and [MathF](/dotnet/api/system.mathf) methods are also translated. For example, `Math.Sin`, `MathF.Sin`, `double.Sin`,
+> and `float.Sin` all map to the `SIN` function in SQL.
+
+### String functions
+
+.NET                                                              | SQL                                                                                | Added in
+----------------------------------------------------------------- | ---------------------------------------------------------------------------------- | --------
+Regex.IsMatch(input, pattern)                                     | [RegexMatch(@pattern, @input)](/azure/cosmos-db/nosql/query/regexmatch)
+Regex.IsMatch(input, pattern, options)                            | [RegexMatch(@input, @pattern, @options)](/azure/cosmos-db/nosql/query/regexmatch)
+string.Concat(str0, str1)                                         | @str0 + @str1
+string.Equals(a, b, StringComparison.Ordinal)                     | [STRINGEQUALS(@a, @b)](/azure/cosmos-db/nosql/query/stringequals)
+string.Equals(a, b, StringComparison.OrdinalIgnoreCase)           | [STRINGEQUALS(@a, @b, true)](/azure/cosmos-db/nosql/query/stringequals)
+stringValue.Contains(value)                                       | [CONTAINS(@stringValue, @value)](/azure/cosmos-db/nosql/query/contains)
+stringValue.Contains(value, StringComparison.Ordinal)             | [CONTAINS(@stringValue, @value, false)](/azure/cosmos-db/nosql/query/contains)     | EF 9
+stringValue.Contains(value, StringComparison.OrdinalIgnoreCase)   | [CONTAINS(@stringValue, @value, true)](/azure/cosmos-db/nosql/query/contains)      | EF 9
+stringValue.EndsWith(value)                                       | [ENDSWITH(@stringValue, @value)](/azure/cosmos-db/nosql/query/endswith)
+stringValue.EndsWith(value, StringComparison.Ordinal)             | [ENDSWITH(@stringValue, @value, false)](/azure/cosmos-db/nosql/query/endswith)     | EF 9
+stringValue.EndsWith(value, StringComparison.OrdinalIgnoreCase)   | [ENDSWITH(@stringValue, @value, true)](/azure/cosmos-db/nosql/query/endswith)      | EF 9
+stringValue.Equals(value, StringComparison.Ordinal)               | [STRINGEQUALS(@stringValue, @value)](/azure/cosmos-db/nosql/query/stringequals)
+stringValue.Equals(value, StringComparison.OrdinalIgnoreCase)     | [STRINGEQUALS(@stringValue, @value, true)](/azure/cosmos-db/nosql/query/stringequals)
+stringValue.FirstOrDefault()                                      | [LEFT(@stringValue, 1)](/azure/cosmos-db/nosql/query/left)
+stringValue.IndexOf(value)                                        | [INDEX_OF(@stringValue, @value)](/azure/cosmos-db/nosql/query/index-of)
+stringValue.IndexOf(value, startIndex)                            | [INDEX_OF(@stringValue, @value, @startIndex)](/azure/cosmos-db/nosql/query/index-of)
+stringValue.LastOrDefault()                                       | [RIGHT(@stringValue, 1)](/azure/cosmos-db/nosql/query/right)
+stringValue.Length                                                | [LENGTH(@stringValue)](/azure/cosmos-db/nosql/query/length)
+stringValue.Replace(oldValue, newValue)                           | [REPLACE(@stringValue, @oldValue, @newValue)](/azure/cosmos-db/nosql/query/replace)
+stringValue.StartsWith(value)                                     | [STARTSWITH(@stringValue, @value)](/azure/cosmos-db/nosql/query/startswith)
+stringValue.StartsWith(value, StringComparison.Ordinal)           | [STARTSWITH(@stringValue, @value, false)](/azure/cosmos-db/nosql/query/startswith) | EF 9
+stringValue.StartsWith(value, StringComparison.OrdinalIgnoreCase) | [STARTSWITH(@stringValue, @value, true)](/azure/cosmos-db/nosql/query/startswith)  | EF 9
+stringValue.Substring(startIndex)                                 | [SUBSTRING(@stringValue, @startIndex, LENGTH(@stringValue))](/azure/cosmos-db/nosql/query/substring)
+stringValue.Substring(startIndex, length)                         | [SUBSTRING(@stringValue, @startIndex, @length)](/azure/cosmos-db/nosql/query/substring)
+stringValue.ToLower()                                             | [LOWER(@stringValue)](/azure/cosmos-db/nosql/query/lower)
+stringValue.ToUpper()                                             | [UPPER(@stringValue)](/azure/cosmos-db/nosql/query/upper)
+stringValue.Trim()                                                | [TRIM(@stringValue)](/azure/cosmos-db/nosql/query/trim)
+stringValue.TrimEnd()                                             | [RTRIM(@stringValue)](/azure/cosmos-db/nosql/query/rtrim)
+stringValue.TrimStart()                                           | [LTRIM(@stringValue)](/azure/cosmos-db/nosql/query/ltrim)
+
+### Vector and full-text search
+
+.NET                                                                        | SQL                                                                                                           | Added in
+--------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | -----
+<xref:Microsoft.EntityFrameworkCore.CosmosDbFunctionsExtensions.VectorDistance*>(vector1, vector2).                              | [VectorDistance(vector1, vector2)](/azure/cosmos-db/nosql/query/vectordistance)                               | EF 9
+<xref:Microsoft.EntityFrameworkCore.CosmosDbFunctionsExtensions.VectorDistance*>(vector1, vector2, bruteForce)                   | [VectorDistance(vector1, vector2, bruteForce)](/azure/cosmos-db/nosql/query/vectordistance)                   | EF 9
+<xref:Microsoft.EntityFrameworkCore.CosmosDbFunctionsExtensions.VectorDistance*>(vector1, vector2, bruteForce, distanceFunction) | [VectorDistance(vector1, vector2, bruteForce, distanceFunction)](/azure/cosmos-db/nosql/query/vectordistance) | EF 9
+<xref:Microsoft.EntityFrameworkCore.CosmosDbFunctionsExtensions.FullTextContains*>(property, keyword)                            | [FullTextContains(property, keyword)](/azure/cosmos-db/nosql/query/fulltextcontains)                          | EF 10
+<xref:Microsoft.EntityFrameworkCore.CosmosDbFunctionsExtensions.FullTextContainsAll*>(property, keyword1, keyword2)              | [FullTextContainsAll(property, keyword1, keyword2)](/azure/cosmos-db/nosql/query/fulltextcontainsall)         | EF 10
+<xref:Microsoft.EntityFrameworkCore.CosmosDbFunctionsExtensions.FullTextContainsAny*>(property, keyword1, keyword2)              | [FullTextContainsAny(property, keyword1, keyword2)](/azure/cosmos-db/nosql/query/fulltextcontainsany)         | EF 10
+<xref:Microsoft.EntityFrameworkCore.CosmosDbFunctionsExtensions.FullTextScore*>(property, keyword1, keyword2)                    | [FullTextScore(property, keyword1, keyword2)](/azure/cosmos-db/nosql/query/fulltextscore)                     | EF 10
+<xref:Microsoft.EntityFrameworkCore.CosmosDbFunctionsExtensions.Rrf*>(search1, search2)                                          | [RRF(property, search1, search2)](/azure/cosmos-db/nosql/query/rrf).                                          | EF 10
+<xref:Microsoft.EntityFrameworkCore.CosmosDbFunctionsExtensions.Rrf*>(new[] { search1, search2 }, weights)                       | [RRF(property, search1, search2, weights)](/azure/cosmos-db/nosql/query/rrf)                                  | EF 10
+
+For more information on vector search, see [the documentation](xref:core/providers/cosmos/vector-search). For more information on full-text search, see [the documentation](xref:core/providers/cosmos/full-text-search).
+
+### Miscellaneous functions
+
+.NET                                                                                    | SQL                                                                                                           | Added in
+--------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | -----
+collection.Contains(item)                                                               | @item IN @collection
+<xref:Microsoft.EntityFrameworkCore.CosmosDbFunctionsExtensions.CoalesceUndefined*>(x, y)<sup>1</sup>                                        | [x ?? y](/azure/cosmos-db/nosql/query/ternary-coalesce-operators#coalesce-operator)                           | EF 9
+<xref:Microsoft.EntityFrameworkCore.CosmosDbFunctionsExtensions.IsDefined*>(x)                                                               | [IS_DEFINED(x)](/azure/cosmos-db/nosql/query/is-defined)                                                      | EF 9
+
+<sup>1</sup> Note that <xref:Microsoft.EntityFrameworkCore.CosmosDbFunctionsExtensions.CoalesceUndefined*> coalesces `undefined`, not `null`. To coalesce `null`, use the regular C# `??` operator.
diff --git a/entity-framework/core/providers/cosmos/saving.md b/entity-framework/core/providers/cosmos/saving.md
new file mode 100644
index 0000000000..b2f1da1a7c
--- /dev/null
+++ b/entity-framework/core/providers/cosmos/saving.md
@@ -0,0 +1,179 @@
+---
+title: Saving Data - Azure Cosmos DB Provider - EF Core
+description: Saving data with the Azure Cosmos DB EF Core Provider
+author: roji
+ms.date: 02/02/2026
+uid: core/providers/cosmos/saving
+---
+# Saving Data with the EF Core Azure Cosmos DB Provider
+
+## Saving basics
+
+Saving data with the Azure Cosmos DB provider works in a similar fashion to other providers. You add, modify or remove entities, and then call <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChangesAsync*> to persist those changes to the database. For more information on the basics of saving, see [Saving data](xref:core/saving/index).
+
+## Transactionality and transactional batches
+
+> [!NOTE]
+> Transactional batches support is being introduced in EF Core 11, which is currently in preview.
+
+Azure Cosmos DB provides limited support for atomic transactions; this is a common limitation of document databases, where the focus is on scalability and availability rather than strict transactional semantics. Azure Cosmos DB does support [transactional batches](/azure/cosmos-db/transactional-batch), which allow operations to be executed together as a batch within a single partition (see additional limitations below). Atomicity is guaranteed within a single batch: if any operation fails, the entire batch is rolled back and none of its changes are applied. However, once a batch is written, it cannot be rolled back or deferred, and atomicity cannot be enforced across multiple batches. Transactional batches also provide a performance benefit, as multiple documents can be updated in a single roundtrip, rather than performing a roundtrip for each update.
+
+Starting with EF 11, the EF Core Azure Cosmos DB provider leverages transactional batches by default whenever possible, providing a best-effort approximation of atomicity (and optimal performance) when saving changes. The batching behavior can be controlled by the <xref:Microsoft.EntityFrameworkCore.AutoTransactionBehavior> property, allowing developers to trade off between performance, consistency guarantees, and failure behavior depending on the application’s needs.
+
+* **Auto** (default) – EF automatically groups operations into transactional batches, which are executed sequentially. If a batch fails, execution stops immediately and no subsequent changes are saved, while any previously successful batches remain committed. This generally provides good performance when performing multiple operations that can be grouped by partition key value, with a best-effort approximation of atomicity.
+* **Never** – All operations are performed individually and sequentially, in the exact order they were tracked. This avoids batching and can be slower, especially for large numbers of changes. This was the behavior prior to version 11.
+* **Always** – Requires that all operations can be executed as a single transaction batch; if any operation cannot be included in a batch (see [Limitations](#limitations)), an exception is thrown. This allows you to guarantee full atomicity (and a single roundtrip) when executing `SaveChangesAsync`, but it is then up to you to manually ensure that all operations can be performed in a transactional batch.
+
+Here is an example of using <xref:Microsoft.EntityFrameworkCore.AutoTransactionBehavior.Always>, which causes `SaveChangesAsync` to fail because too many operations are attempted:
+
+```csharp
+using var context = new BlogsContext();
+context.Database.AutoTransactionBehavior = AutoTransactionBehavior.Always;
+context.AddRange(Enumerable.Range(0, 101).Select(i => new Post())); // 101 entries exceeds the batch item limit of 100.
+await context.SaveChangesAsync(); // Throws InvalidOperationException since the changes cannot be saved in a single batch.
+```
+
+### Limitations
+
+* Transactional batches can only be performed within a single partition.
+* Transactional batches can contain only up to 100 operations, and cannot surpass 2MB of data in total.
+* Azure Cosmos DB does not allow document writes with [pre- or post-triggers](/azure/cosmos-db/stored-procedures-triggers-udfs#triggers) to be part of a transactional batch. Because of this, any entities configured with triggers are executed separately and before any transactional batches. This can affect ordering and consistency in mixed scenarios.
+
+## Bulk execution
+
+> [!NOTE]
+> Bulk execution is being introduced in EF Core 11, which is currently in preview.
+
+Prior to version 11, the Azure Cosmos DB provider executed document operations sequentially when calling `SaveChangesAsync`; when saving a large number of entities, this was slow as each operation waits for the previous one to complete before starting. Version 11 enables [transactional batches](#transactionality-and-transactional-batches), which allow operations to be batched together for better performance. However, transactional batches can only be used against a single partition, and have various limitations (see the documentation above).
+
+An alternative approach is to use Azure Cosmos DB supports _bulk execution_, which allows multiple document operations to be executed in parallel and across DbContext instances, significantly improving throughput when saving many entities at once. This is especially useful for data loading scenarios, batch operations, or any situation where you need to save many entities.
+
+To enable bulk execution, configure your context using the `BulkExecutionEnabled()` option:
+
+```csharp
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    => optionsBuilder.UseCosmos(
+        "https://localhost:8081",
+        "C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==",
+        databaseName: "OrdersDB",
+        options => options.BulkExecutionEnabled());
+```
+
+With bulk execution enabled, document write operations are executed in parallel rather than sequentially. This can provide significant performance improvements when saving multiple entities, especially in scenarios involving hundreds or thousands of documents. However, make sure to understand [the caveats](https://devblogs.microsoft.com/cosmosdb/introducing-bulk-support-in-the-net-sdk/#what-are-the-caveats) before enabling this. Note that the behavior of `SaveChangesAsync` remains the same from an API perspective; it's only the internal execution that changes to take advantage of Azure Cosmos DB's bulk capabilities.
+
+For more information on bulk execution in Azure Cosmos DB, see the following Azure documentation:
+
+* [Introducing bulk support in the .NET SDK](https://devblogs.microsoft.com/cosmosdb/introducing-bulk-support-in-the-net-sdk/)
+* [Bulk updates with optimistic concurrency control](https://devblogs.microsoft.com/cosmosdb/bulk-updates-with-optimistic-concurrency-control/)
+
+## Session token management
+
+> [!NOTE]
+> Session token management is being introduced in EF Core 11, which is currently in preview.
+
+Azure Cosmos DB uses [session tokens](/azure/cosmos-db/consistency-levels#session-consistency) to track read-your-writes consistency within a session. When using session consistency (the default), each read or write operation returns a session token that can be used in subsequent requests to ensure that the requesting client reads its own writes.
+
+By default, the Azure Cosmos DB .NET SDK manages session tokens automatically within a single `CosmosClient` instance. However, in some scenarios you may need to manage session tokens manually:
+
+* When your application uses a round-robin load balancer that doesn't maintain session affinity between HTTP requests
+* When session tokens need to be persisted and restored across application restarts
+* When session tokens need to be shared between different `DbContext` instances or application processes
+
+### Configuring session token management mode
+
+To enable manual session token management, configure `SessionTokenManagementMode()` when setting up your context:
+
+```csharp
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    => optionsBuilder.UseCosmos(
+        "<connection string>",
+        databaseName: "OrdersDB",
+        options => options.SessionTokenManagementMode(SessionTokenManagementMode.SemiAutomatic));
+```
+
+The following modes are available:
+
+Mode               | Description
+-------------------|------------
+`FullyAutomatic`   | The default mode. Uses the underlying Cosmos DB SDK automatic session token management. `GetSessionTokens` and `UseSessionTokens` methods will throw when invoked.
+`SemiAutomatic`    | Allows overwriting the SDK's automatic session token management via `UseSessionTokens`. If `UseSessionTokens` has not been called for a container, the SDK's automatic management is used. EF tracks session tokens which can be retrieved via `GetSessionTokens`.
+`Manual`           | Fully replaces SDK automatic session token management. Only session tokens specified via `UseSessionTokens` or tracked by EF operations are used.
+`EnforcedManual`   | Same as `Manual`, but throws an exception if `UseSessionTokens` wasn't called for the container before executing an operation on it.
+
+### Retrieving session tokens
+
+After performing read or write operations, you can retrieve the session tokens tracked by EF:
+
+```csharp
+// Get the session token for the default container
+string? sessionToken = context.Database.GetSessionToken();
+
+// Get session tokens for all containers
+IReadOnlyDictionary<string, string?> allTokens = context.Database.GetSessionTokens();
+```
+
+### Setting session tokens
+
+Before performing read operations, you can set session tokens to ensure you read your own writes:
+
+```csharp
+// Set the session token for the default container
+context.Database.UseSessionToken(sessionToken);
+
+// Set session tokens for all containers
+context.Database.UseSessionTokens(sessionTokens);
+```
+
+### Appending session tokens
+
+You can also append session tokens to the existing ones. This is useful when you have session tokens from multiple sources and want to combine them:
+
+```csharp
+// Append a session token for the default container
+context.Database.AppendSessionToken(sessionToken);
+
+// Append session tokens for the specified containers
+context.Database.AppendSessionTokens(sessionTokens);
+```
+
+### Example: Session token management in a load-balanced web application
+
+The following example demonstrates how to manage session tokens in a web application with multiple instances behind a round-robin load balancer:
+
+```csharp
+// After writing data, retrieve and store the session token (e.g., in a cookie or header)
+public async Task<IActionResult> CreateDocument(DocumentDto dto)
+{
+    await using var context = new MyCosmosContext();
+
+    var document = new Document { Name = dto.Name };
+    context.Documents.Add(document);
+    await context.SaveChangesAsync();
+
+    // Retrieve the session token to return to the client
+    var sessionToken = context.Database.GetSessionToken();
+
+    // Store in response header for the client to send back in subsequent requests
+    Response.Headers["x-cosmos-session-token"] = sessionToken;
+
+    return Ok(document.Id);
+}
+
+// Before reading data, apply the session token from the client
+public async Task<IActionResult> GetDocument(int id)
+{
+    await using var context = new MyCosmosContext();
+
+    // Get the session token from the request header
+    if (Request.Headers.TryGetValue("x-cosmos-session-token", out var sessionToken))
+    {
+        context.Database.UseSessionToken(sessionToken!);
+    }
+
+    var document = await context.Documents.FindAsync(id);
+    return document is not null ? Ok(document) : NotFound();
+}
+```
+
+> [!WARNING]
+> Manual session token management can break session consistency when not handled properly. Only use manual mode when you have a specific need, such as running behind a load balancer without session affinity. For more information, see [Utilize session tokens](/azure/cosmos-db/nosql/how-to-manage-consistency?tabs=portal%2Cdotnetv2%2Capi-async#utilize-session-tokens) in the Azure Cosmos DB documentation.
diff --git a/entity-framework/core/providers/cosmos/unstructured-data.md b/entity-framework/core/providers/cosmos/unstructured-data.md
new file mode 100644
index 0000000000..e499aefb92
--- /dev/null
+++ b/entity-framework/core/providers/cosmos/unstructured-data.md
@@ -0,0 +1,58 @@
+---
+title: Azure Cosmos DB Provider - Working with Unstructured Data - EF Core
+description: How to work with Azure Cosmos DB unstructured data using Entity Framework Core
+author: AndriySvyryd
+ms.date: 11/05/2019
+uid: core/providers/cosmos/unstructured-data
+---
+# Working with Unstructured Data in EF Core Azure Cosmos DB Provider
+
+EF Core was designed to make it easy to work with data that follows a schema defined in the model. However one of the strengths of Azure Cosmos DB is the flexibility in the shape of the data stored.
+
+## Accessing the raw JSON
+
+It is possible to access the properties that are not tracked by EF Core through a special property in [shadow-state](xref:core/modeling/shadow-properties) named `"__jObject"` that contains a `JObject` representing the data received from the store and data that will be stored:
+
+[!code-csharp[Unmapped](../../../../samples/core/Cosmos/UnstructuredData/Sample.cs?highlight=21,22&name=Unmapped)]
+
+```json
+{
+    "Id": 1,
+    "PartitionKey": "1",
+    "TrackingNumber": null,
+    "id": "1",
+    "Address": {
+        "ShipsToCity": "London",
+        "ShipsToStreet": "221 B Baker St"
+    },
+    "_rid": "eLMaAK8TzkIBAAAAAAAAAA==",
+    "_self": "dbs/eLMaAA==/colls/eLMaAK8TzkI=/docs/eLMaAK8TzkIBAAAAAAAAAA==/",
+    "_etag": "\"00000000-0000-0000-683e-0a12bf8d01d5\"",
+    "_attachments": "attachments/",
+    "BillingAddress": "Clarence House",
+    "_ts": 1568164374
+}
+```
+
+> [!WARNING]
+> The `"__jObject"` property is part of the EF Core infrastructure and should only be used as a last resort as it is likely to have different behavior in future releases.
+
+> [!NOTE]
+> Changes to the entity will override the values stored in `"__jObject"` during `SaveChanges`.
+
+## Using CosmosClient
+
+To decouple completely from EF Core get the [CosmosClient](/dotnet/api/Microsoft.Azure.Cosmos.CosmosClient) object that is [part of the Azure Cosmos DB SDK](/azure/cosmos-db/sql-api-get-started) from `DbContext`:
+
+[!code-csharp[CosmosClient](../../../../samples/core/Cosmos/UnstructuredData/Sample.cs?highlight=3&name=CosmosClient)]
+
+## Missing property values
+
+In the previous example we removed the `"TrackingNumber"` property from the order. Because of how indexing works in Azure Cosmos DB, queries that reference the missing property somewhere else than in the projection could return unexpected results. For example:
+
+[!code-csharp[MissingProperties](../../../../samples/core/Cosmos/UnstructuredData/Sample.cs?name=MissingProperties)]
+
+The sorted query actually returns no results. This means that one should take care to always populate properties mapped by EF Core when working with the store directly.
+
+> [!NOTE]
+> This behavior might change in future versions of Azure Cosmos DB. For instance, currently if the indexing policy defines the composite index {Id/? ASC, TrackingNumber/? ASC)}, then a query that has 'ORDER BY c.Id ASC, c.Discriminator ASC' __would__ return items that are missing the `"TrackingNumber"` property.
diff --git a/entity-framework/core/providers/cosmos/vector-search.md b/entity-framework/core/providers/cosmos/vector-search.md
new file mode 100644
index 0000000000..8fdc7924ef
--- /dev/null
+++ b/entity-framework/core/providers/cosmos/vector-search.md
@@ -0,0 +1,64 @@
+---
+title: Vector Search - Azure Cosmos DB Provider - EF Core
+description: Vector search with the Azure Cosmos DB EF Core Provider
+author: roji
+ms.date: 09/20/2024
+uid: core/providers/cosmos/vector-search
+---
+# Vector search
+
+> [!NOTE]
+> The below describes the vector search support in EF 10. EF 9 includes similar experimental support with slightly different method naming.
+
+Azure Cosmos DB now offers support for vector similarity search. Vector search is a fundamental part of some application types, including AI, semantic search and others. Azure Cosmos DB allows you to store vectors directly in your documents alongside the rest of your data, meaning you can perform all of your queries against a single database. This can considerably simplify your architecture and remove the need for an additional, dedicated vector database solution in your stack. To learn more about Azure Cosmos DB vector search, [see the documentation](/azure/cosmos-db/nosql/vector-search).
+
+Vector property can be configured inside `OnModelCreating`:
+
+```c#
+public class Blog
+{
+    ...
+
+    public float[] Vector { get; set; }
+}
+
+public class BloggingContext
+{
+    ...
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>(b =>
+        {
+            b.Property(b => b.Vector).IsVectorProperty(DistanceFunction.Cosine, dimensions: 1536);
+            b.HasIndex(x => x.Vector).IsVectorIndex(VectorIndexType.Flat);
+        });
+    }
+}
+```
+
+At this point your model is configured. Insertion of vector data is done just like any other data type with EF:
+
+```c#
+float[] vector = /* generate vector data from text, image, etc. */
+context.Add(new Blog { Vector = vector });
+await context.SaveChangesAsync();
+```
+
+Finally, use the `EF.Functions.VectorDistance()` function in LINQ queries to perform vector similarity search:
+
+```c#
+float[] anotherVector = /* generate vector data from text, image, etc. */
+var blogs = await context.Blogs
+    .OrderBy(s => EF.Functions.VectorDistance(s.Vector, anotherVector))
+    .Take(5)
+    .ToListAsync();
+```
+
+This will returns the top five Blogs, based on the similarity of their `Vector` property and the externally-provided `anotherVector` data.
+
+## Hybrid search
+
+Vector similarity search can be used with full-text search in the same query (i.e. hybrid search), by combining results of `VectorDistance` and `FullTextScore` functions using the [`RRF`](/azure/cosmos-db/nosql/query/rrf) (Reciprocal Rank Fusion) function.
+
+See [documentation](xref:core/providers/cosmos/full-text-search?#hybrid-search) to learn how to enable full-text search support in EF model and how to use hybrid search in queries.
diff --git a/entity-framework/core/providers/in-memory/index.md b/entity-framework/core/providers/in-memory/index.md
new file mode 100644
index 0000000000..645798c692
--- /dev/null
+++ b/entity-framework/core/providers/in-memory/index.md
@@ -0,0 +1,45 @@
+---
+title: In-memory Database Provider - EF Core
+description: Information on the Entity Framework Core in-memory database provider
+author: SamMonoRT
+ms.date: 02/11/2023
+uid: core/providers/in-memory/index
+---
+# EF Core In-Memory Database Provider
+
+This database provider allows Entity Framework Core to be used with an in-memory database. While some users use the in-memory database for testing, this is discouraged. For more information on how to test EF Core applications, see the [_Testing EF Core Applications_](xref:core/testing/index). The provider is maintained by Microsoft as part of the [Entity Framework Core Project](https://github.com/dotnet/efcore).
+
+> [!WARNING]
+> The EF Core in-memory database is not designed for performance or robustness and should not be used outside of testing environments. It is not designed for production use.
+
+> [!IMPORTANT]
+> New features are not being added to the in-memory database.
+
+## Install
+
+Install the [Microsoft.EntityFrameworkCore.InMemory NuGet package](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.InMemory/).
+
+### [.NET CLI](#tab/dotnet-core-cli)
+
+```dotnetcli
+dotnet add package Microsoft.EntityFrameworkCore.InMemory
+```
+
+### [Visual Studio](#tab/vs)
+
+```powershell
+Install-Package Microsoft.EntityFrameworkCore.InMemory
+```
+
+***
+
+## Get Started
+
+The following resources will help you get started with this provider.
+
+* [Testing with in-memory (not recommended)](xref:core/testing/testing-without-the-database#inmemory-provider)
+* [UnicornStore Sample Application Tests](https://github.com/rowanmiller/UnicornStore/blob/master/UnicornStore/src/UnicornStore.Tests/Controllers/ShippingControllerTests.cs)
+
+## Supported Database Engines
+
+In-process naive, non-performant, and non-persisted in-memory database. Not designed for production use.
diff --git a/entity-framework/core/providers/index.md b/entity-framework/core/providers/index.md
new file mode 100644
index 0000000000..ac7d696e6a
--- /dev/null
+++ b/entity-framework/core/providers/index.md
@@ -0,0 +1,102 @@
+---
+title: Database Providers - EF Core
+description: Information about specific supported Entity Framework Core providers and about providers in general
+author: SamMonoRT
+ms.date: 12/13/2022
+uid: core/providers/index
+---
+
+# Database Providers
+
+Entity Framework Core can access many different databases through plug-in libraries called database providers.
+
+## Current providers
+
+> [!IMPORTANT]
+> EF Core providers are built by a variety of sources. Not all providers are maintained as part of the Microsoft [Entity Framework Core Project](https://github.com/dotnet/efcore). When considering a provider, be sure to evaluate quality, licensing, support, etc. to ensure they meet your requirements. Also make sure you review each provider's documentation for detailed version compatibility information.
+
+> [!IMPORTANT]
+> EF Core providers typically do not work across major versions. For example, a provider released for EF Core 8 will not work with EF Core 9.
+
+| NuGet Package                                                                                                        | Supported database engines                                  | Maintainer / Vendor                                                                             | Notes / Requirements                                                            | For EF Core | Useful links                                                                                                                                                                  |
+|----------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------|-------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| [Microsoft.EntityFrameworkCore.SqlServer](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.SqlServer)    | Azure SQL, SQL Server 2012 onwards, Azure Synapse Analytics | [EF Core Project](https://github.com/dotnet/efcore/) (Microsoft)                                |                                                                                 | 8, 9, 10          | [docs](xref:core/providers/sql-server/index)                                                                                                                            |
+| [Microsoft.EntityFrameworkCore.Sqlite](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Sqlite)          | SQLite 3.46.1 onwards                                       | [EF Core Project](https://github.com/dotnet/efcore/) (Microsoft)                                |                                                                                 | 8, 9, 10          | [docs](xref:core/providers/sqlite/index)                                                                                                                                |
+| [Microsoft.EntityFrameworkCore.InMemory](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.InMemory)      | EF Core in-memory database                                  | [EF Core Project](https://github.com/dotnet/efcore/) (Microsoft)                                | [Limitations](xref:core/testing/testing-without-the-database#inmemory-provider) | 8, 9, 10          | [docs](xref:core/providers/in-memory/index)                                                                                                                             |
+| [Microsoft.EntityFrameworkCore.Cosmos](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Cosmos)          | Azure Cosmos DB SQL API                                     | [EF Core Project](https://github.com/dotnet/efcore/) (Microsoft)                                |                                                                                 | 8, 9, 10          | [docs](xref:core/providers/cosmos/index)                                                                                                                                |
+| [Npgsql.EntityFrameworkCore.PostgreSQL](https://www.nuget.org/packages/Npgsql.EntityFrameworkCore.PostgreSQL)        | PostgreSQL                                                  | [Npgsql Development Team](https://github.com/npgsql)                                            |                                                                                 | 8, 9              | [docs](https://www.npgsql.org/efcore/index.html)                                                                                                                        |
+| [Pomelo.EntityFrameworkCore.MySql](https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql)                  | MySQL, MariaDB                                              | [Pomelo Foundation Project](https://github.com/PomeloFoundation)                                |                                                                                 | 8, 9              | [readme](https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql/blob/master/README.md)                                                                    |
+| [MySql.EntityFrameworkCore](https://www.nuget.org/packages/MySql.EntityFrameworkCore)                                | MySQL                                                       | [MySQL project](https://dev.mysql.com) (Oracle)                                                 |                                                                                 | 8, 9              | [docs](https://dev.mysql.com/doc/connector-net/en/connector-net-entityframework-core.html)                                                                              |
+| [Oracle.EntityFrameworkCore](https://www.nuget.org/packages/Oracle.EntityFrameworkCore/)                             | Oracle DB 19c onwards                                      | [Oracle](https://www.oracle.com/technetwork/topics/dotnet/)                                     |                                                                                 | 8, 9, 10              | [docs](https://docs.oracle.com/en/database/oracle/oracle-database/26/odpnt/ODPEFCore.html)                                                                                                            |
+| [MongoDB.EntityFrameworkCore](https://www.nuget.org/packages/MongoDB.EntityFrameworkCore/)                           | MongoDB                                                     | [MongoDB](https://www.mongodb.com/)                                                             |                                                                                 | 8                 | [docs](https://www.mongodb.com/docs/entity-framework/current/)                                                                                                          |
+| [Couchbase.EntityFrameworkCore](https://www.nuget.org/packages/Couchbase.EntityFrameworkCore)                        | Couchbase                                                   | [Couchbase](https://github.com/couchbaselabs/couchbase-efcore-provider)                         |                                                                                 | 8, 9              | [docs](https://docs.couchbase.com/efcore-provider/current/start-using-efcore-provider.html)                                                                             |
+| [Devart.Data.MySql.EFCore](https://www.nuget.org/packages/Devart.Data.MySql.EFCore/)                                 | MySQL 5 onwards                                             | [DevArt](https://www.devart.com/dotconnect/mysql/)                                              | Paid                                                                            | 8, 9              | [docs](https://docs.devart.com/dotconnect/mysql/GettingStarted.html)                                                                                                    |
+| [Devart.Data.Oracle.EFCore](https://www.nuget.org/packages/Devart.Data.Oracle.EFCore/)                               | Oracle DB 9.2.0.4 onwards                                   | [DevArt](https://www.devart.com/dotconnect/oracle/)                                             | Paid                                                                            | 8, 9              | [docs](https://docs.devart.com/dotconnect/oracle/GettingStarted.html)                                                                                                   |
+| [Devart.Data.PostgreSql.EFCore](https://www.nuget.org/packages/Devart.Data.PostgreSql.EFCore/)                       | PostgreSQL 8.0 onwards                                      | [DevArt](https://www.devart.com/dotconnect/postgresql/)                                         | Paid                                                                            | 8, 9              | [docs](https://docs.devart.com/dotconnect/postgresql/GettingStarted.html)                                                                                               |
+| [Devart.Data.SQLite.EFCore](https://www.nuget.org/packages/Devart.Data.SQLite.EFCore/)                               | SQLite 3 onwards                                            | [DevArt](https://www.devart.com/dotconnect/sqlite/)                                             | Paid                                                                            | 8, 9              | [docs](https://docs.devart.com/dotconnect/sqlite/GettingStarted.html)                                                                                                   |
+| [Devart.Data.DB2.EFCore](https://www.nuget.org/packages/Devart.Data.DB2.EFCore)                                      | DB2                                                         | [DevArt](https://www.devart.com/dotconnect/db2/)                                                | Paid                                                                            | 8, 9              | [docs](https://docs.devart.com/dotconnect/db2/GettingStarted.html)                                                                                                      |
+| [Devart.Data.Bigcommerce.EFCore](https://www.nuget.org/packages/Devart.Data.Bigcommerce.EFCore)                      | BigCommerce                                                 | [DevArt](https://www.devart.com/dotconnect/bigcommerce/)                                        | Paid                                                                            | 8, 9              | [docs](https://docs.devart.com/dotconnect/bigcommerce/GettingStarted.html)                                                                                              |
+| [Devart.Data.Dynamics.EFCore](https://www.nuget.org/packages/Devart.Data.Dynamics.EFCore)                            | Microsoft Dynamics 365                                      | [DevArt](https://www.devart.com/dotconnect/dynamicscrm/)                                        | Paid                                                                            | 8, 9              | [docs](https://docs.devart.com/dotconnect/dynamics/GettingStarted.html)                                                                                                 |
+| [Devart.Data.FreshBooks.EFCore](https://www.nuget.org/packages/Devart.Data.FreshBooks.EFCore)                        | FreshBooks                                                  | [DevArt](https://www.devart.com/dotconnect/freshbooks/)                                         | Paid                                                                            | 8, 9              | [docs](https://docs.devart.com/dotconnect/freshbooks/GettingStarted.html)                                                                                               |
+| [Devart.Data.Magento.EFCore](https://www.nuget.org/packages/Devart.Data.Magento.EFCore)                              | Magento                                                     | [DevArt](https://www.devart.com/dotconnect/magento/)                                            | Paid                                                                            | 8, 9              | [docs](https://docs.devart.com/dotconnect/magento/GettingStarted.html)                                                                                                  |
+| [Devart.Data.MailChimp.EFCore](https://www.nuget.org/packages/Devart.Data.MailChimp.EFCore)                          | Mailchimp                                                   | [DevArt](https://www.devart.com/dotconnect/mailchimp/)                                          | Paid                                                                            | 8, 9              | [docs](https://docs.devart.com/dotconnect/mailchimp/GettingStarted.html)                                                                                                |
+| [Devart.Data.QuickBooks.EFCore](https://www.nuget.org/packages/Devart.Data.QuickBooks.EFCore)                        | QuickBooks                                                  | [DevArt](https://www.devart.com/dotconnect/quickbooks/)                                         | Paid                                                                            | 8, 9              | [docs](https://docs.devart.com/dotconnect/quickbooks/GettingStarted.html)                                                                                               |
+| [Devart.Data.Salesforce.EFCore](https://www.nuget.org/packages/Devart.Data.Salesforce.EFCore)                        | Salesforce                                                  | [DevArt](https://www.devart.com/dotconnect/salesforce/)                                         | Paid                                                                            | 8, 9              | [docs](https://docs.devart.com/dotconnect/salesforce/GettingStarted.html)                                                                                               |
+| [Devart.Data.ExactTarget.EFCore](https://www.nuget.org/packages/Devart.Data.ExactTarget.EFCore)                      | Salesforce MC (ExactTarget)                                 | [DevArt](https://www.devart.com/dotconnect/exacttarget/)                                        | Paid                                                                            | 8, 9              | [docs](https://docs.devart.com/dotconnect/salesforcemc/GettingStarted.html)                                                                                             |
+| [Devart.Data.Sugar.EFCore](https://www.nuget.org/packages/Devart.Data.Sugar.EFCore)                                  | SugarCRM                                                    | [DevArt](https://www.devart.com/dotconnect/sugarcrm/)                                           | Paid                                                                            | 8, 9              | [docs](https://docs.devart.com/dotconnect/sugarcrm/GettingStarted.html)                                                                                                 |
+| [Devart.Data.Zoho.EFCore](https://www.nuget.org/packages/Devart.Data.Zoho.EFCore)                                    | Zoho CRM                                                    | [DevArt](https://www.devart.com/dotconnect/zohocrm/)                                            | Paid                                                                            | 8, 9              | [docs](https://docs.devart.com/dotconnect/zohocrm/GettingStarted.html)                                                                                                  |
+| [Devart.Data.ZohoBooks.EFCore](https://www.nuget.org/packages/Devart.Data.ZohoBooks.EFCore)                          | Zoho Books                                                  | [DevArt](https://www.devart.com/dotconnect/zohobooks/)                                          | Paid                                                                            | 8, 9              | [docs](https://docs.devart.com/dotconnect/zohobooks/GettingStarted.html)                                                                                                |
+| [Devart.Data.ZohoDesk.EFCore](https://www.nuget.org/packages/Devart.Data.ZohoDesk.EFCore)                            | Zoho Desk                                                   | [DevArt](https://www.devart.com/dotconnect/zohodesk/)                                           | Paid                                                                            | 8, 9              | [docs](https://docs.devart.com/dotconnect/zohodesk/GettingStarted.html)                                                                                                 |
+| [MASES.EntityFrameworkCore.KNet](https://www.nuget.org/packages/MASES.EntityFrameworkCore.KNet/)                     | Apache Kafka                                                | [MASES Group](https://masesgroup.com)                                                           | Trial, Subscription                                                             | 8                 | [docs](https://kefcore.masesgroup.com/)                                                                                                                                 |
+| [InterBase](https://www.nuget.org/packages/InterBaseSql.EntityFrameworkCore.InterBase/)                              | InterBase                                                   | [InterBase](https://interbase.com/)                                                             |                                                                                 | 8                 | [docs](https://docwiki.embarcadero.com/InterBase/2020/en/Entity_Framework)                                                                                              |
+| [FirebirdSql.EntityFrameworkCore.Firebird](https://www.nuget.org/packages/FirebirdSql.EntityFrameworkCore.Firebird/) | Firebird 3.0 onwards                                        | [Jiří Činčura](https://github.com/cincuranet)                                                   |                                                                                 | 8                 | [docs](https://github.com/FirebirdSQL/NETProvider/blob/master/docs/entity-framework-core.md)                                                                            |
+| [IBM.EntityFrameworkCore](https://www.nuget.org/packages/IBM.EntityFrameworkCore)                                    | Db2, Informix                                               | [IBM](https://ibm.com)                                                                          | Paid, Windows                                                                   | 8                 | [getting started](https://community.ibm.com/community/user/hybriddatamanagement/blogs/michelle-betbadal1/2020/04/29/getting-started-with-ibm-net-provider-for-net-core) |
+| [IBM.EntityFrameworkCore-lnx](https://www.nuget.org/packages/IBM.EntityFrameworkCore-lnx)                            | Db2, Informix                                               | [IBM](https://ibm.com)                                                                          | Paid, Linux                                                                     | 8                 | [getting started](https://community.ibm.com/community/user/hybriddatamanagement/blogs/michelle-betbadal1/2020/04/29/getting-started-with-ibm-net-provider-for-net-core) |
+| [IBM.EntityFrameworkCore-osx](https://www.nuget.org/packages/IBM.EntityFrameworkCore-osx)                            | Db2, Informix                                               | [IBM](https://ibm.com)                                                                          | Paid, macOS                                                                     | 8                 | [getting started](https://community.ibm.com/community/user/hybriddatamanagement/blogs/michelle-betbadal1/2020/04/29/getting-started-with-ibm-net-provider-for-net-core) |
+| [EntityFrameworkCore.Jet](https://www.nuget.org/packages/EntityFrameworkCore.Jet/)                                   | Microsoft Access files                                      | [CirrusRedOrg](https://github.com/CirrusRedOrg)                                                 | Windows                                                                         | 8, 9              | [readme](https://github.com/CirrusRedOrg/EntityFrameworkCore.Jet/blob/master/docs/README.md)                                                                            |
+| [Google.Cloud.EntityFrameworkCore.Spanner](https://www.nuget.org/packages/Google.Cloud.EntityFrameworkCore.Spanner)  | Google Cloud Spanner                                        | [Cloud Spanner Ecosystem](https://github.com/cloudspannerecosystem)                             |                                                                                 | 8                 | [tutorial](https://medium.com/google-cloud/google-cloud-spanner-with-entity-framework-core-2ddd16d2b252)                                                                |
+| [Teradata.EntityFrameworkCore](https://www.nuget.org/packages/Teradata.EntityFrameworkCore/)                         | Teradata Database 16.10 onwards                             | [Teradata](https://downloads.teradata.com/download/connectivity/net-data-provider-for-teradata) |                                                                                 | 3                 | [website](https://www.nuget.org/packages/Teradata.EntityFrameworkCore/)                                                                                                 |
+| [FileContextCore](https://www.nuget.org/packages/FileContextCore/)                                                   | Stores data in files                                        | [Morris Janatzek](https://github.com/morrisjdev)                                                | For development purposes                                                        | 3                 | [readme](https://github.com/morrisjdev/FileContextCore/blob/master/README.md)                                                                                           |
+| [FileBaseContext](https://www.nuget.org/packages/FileBaseContext/)                                                   | Store tables in files                                       | [k.D.g](https://github.com/dualbios)                                                            | For development purposes                                                        | 8, 9, 10          | [readme](https://github.com/dualbios/FileBaseContext/blob/main/README.md)                                                                                               |
+| [EntityFrameworkCore.SqlServerCompact35](https://www.nuget.org/packages/EntityFrameworkCore.SqlServerCompact35)      | SQL Server Compact 3.5                                      | [Erik Ejlskov Jensen](https://github.com/ErikEJ/)                                               | .NET Framework                                                                  | 2                 | [wiki](https://github.com/ErikEJ/EntityFramework.SqlServerCompact/wiki/Using-EF-Core-with-SQL-Server-Compact-in-Traditional-.NET-Applications)                          |
+| [EntityFrameworkCore.SqlServerCompact40](https://www.nuget.org/packages/EntityFrameworkCore.SqlServerCompact40)      | SQL Server Compact 4.0                                      | [Erik Ejlskov Jensen](https://github.com/ErikEJ/)                                               | .NET Framework                                                                  | 2                 | [wiki](https://github.com/ErikEJ/EntityFramework.SqlServerCompact/wiki/Using-EF-Core-with-SQL-Server-Compact-in-Traditional-.NET-Applications)                          |
+| [EntityFrameworkCore.OpenEdge](https://www.nuget.org/packages/EntityFrameworkCore.OpenEdge/)                         | Progress OpenEdge                                           | [Alex Wiese](https://github.com/alexwiese)                                                      |                                                                                 | 2                 | [readme](https://github.com/alexwiese/EntityFrameworkCore.OpenEdge/blob/master/README.md)                                                                               |
+| [EFCore.Snowflake](https://www.nuget.org/packages/EFCore.Snowflake/)                                                 | Snowflake                                                   | [Krzysztof Sielaff](https://github.com/Sielnix)                                                 |                                                                                 | 8                 | [readme](https://github.com/Sielnix/EFCore.Snowflake/blob/main/README.md)                                                                                               |
+| [EFCore.Kusto](https://www.nuget.org/packages/EFCore.Kusto/)                                                         | Azure Data Explorer (Kusto)                                 | [Anas Ismail Khan](https://github.com/anasik)                                                   |                                                                                 | 8                 | [readme](https://github.com/anasik/EFCore.Kusto/blob/main/README.md)                                                                                                    |
+| [EntityFrameworkCore.Ydb](https://www.nuget.org/packages/EntityFrameworkCore.Ydb)                                    | YDB                                                         | [YDB Team](https://github.com/ydb-platform/)                                                    |                                                                                 | 9, 10             | [website](https://ydb.tech/docs/en/integrations/orm/entity-framework?version=main)                                                                                      |
+
+## Adding a database provider to your application
+
+Most database providers for EF Core are distributed as NuGet packages, and can be installed as follows:
+
+## [.NET CLI](#tab/dotnet-core-cli)
+
+```dotnetcli
+dotnet add package provider_package_name
+```
+
+## [Visual Studio](#tab/vs)
+
+```powershell
+install-package provider_package_name
+```
+
+***
+
+Once installed, you will configure the provider in your `DbContext`, either in the `OnConfiguring` method or in the `AddDbContext` method if you are using a dependency injection container.
+For example, the following line configures the SQL Server provider with the passed connection string:
+
+```csharp
+optionsBuilder.UseSqlServer(
+    @"Server=(localdb)\mssqllocaldb;Database=MyDatabase;Trusted_Connection=True;");
+```
+
+Database providers can extend EF Core to enable functionality unique to specific databases. Some concepts are common to most databases, and are included in the primary EF Core components. Such concepts include expressing queries in LINQ, transactions, and tracking changes to objects once they are loaded from the database.
+Some concepts are specific to a particular provider. For example, the SQL Server provider allows you to [configure memory-optimized tables](xref:core/providers/sql-server/memory-optimized-tables) (a feature specific to SQL Server). Other concepts are specific to a class of providers.
+For example, EF Core providers for relational databases build on the common `Microsoft.EntityFrameworkCore.Relational` library, which provides APIs for configuring table and column mappings, foreign key constraints, etc. Providers are usually distributed as NuGet packages.
+
+> [!IMPORTANT]
+> When a new patch version of EF Core is released, it often includes updates to the `Microsoft.EntityFrameworkCore.Relational` package.
+> When you add a relational database provider, this package becomes a transitive dependency of your application.
+> But many providers are released independently from EF Core and may not be updated to depend on the newer patch version of that package.
+> In order to make sure you will get all bug fixes, it is recommended that you add the patch version of `Microsoft.EntityFrameworkCore.Relational` as a direct dependency of your application.
diff --git a/entity-framework/core/providers/sql-server/columns.md b/entity-framework/core/providers/sql-server/columns.md
new file mode 100644
index 0000000000..b04949855c
--- /dev/null
+++ b/entity-framework/core/providers/sql-server/columns.md
@@ -0,0 +1,37 @@
+---
+title: Microsoft SQL Server Database Provider - Columns - EF Core
+description: Column features specific to the Entity Framework Core SQL Server provider
+author: roji
+ms.date: 10/12/2021
+uid: core/providers/sql-server/columns
+---
+# Column features specific to the Entity Framework Core SQL Server provider
+
+This page details column configuration options that are specific to the SQL Server provider.
+
+## Unicode and UTF-8
+
+SQL Server 2019 introduced [introduced UTF-8](/sql/relational-databases/collations/collation-and-unicode-support#utf8) support, which allows storing UTF-8 data in `char` and `varchar` columns by configuring them with special UTF-8 collations. You can use UTF-8 columns with EF simply by configuring the column's type to `char` or `varchar`, specify a UTF-8 collation (ending with `_UTF8`), and specifying that the column should be Unicode:
+
+```c#
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Blog>()
+        .Property(b => b.Name)
+        .HasColumnType("varchar(max)")
+        .UseCollation("LATIN1_GENERAL_100_CI_AS_SC_UTF8")
+        .IsUnicode();
+}
+```
+
+## Sparse columns
+
+Sparse columns are ordinary columns that have an optimized storage for null values, reducing the space requirements for null values at the cost of more overhead to retrieve non-null values.
+
+As an example, consider a type hierarchy mapped via [the table-per-hierarchy (TPH) strategy](xref:core/modeling/inheritance#table-per-hierarchy-and-discriminator-configuration). In TPH, a single database table is used to hold all types in a hierarchy; this means that the table must contain columns for each and every property across the entire hierarchy, and for columns belonging to rare types, most rows will contain a null value for that column. In these cases, it may make sense to configure the column as *sparse*, in order to reduce the space requirements. The decision whether to make a column sparse must be made by the user, and depends on expectations for actual data in the table.
+
+A column can be made sparse via the Fluent API:
+
+[!code-csharp[SparseColumn](../../../../samples/core/SqlServer/Columns/SparseColumnContext.cs?name=SparseColumn&highlight=5)]
+
+For more information on sparse columns, [see the SQL Server docs](/sql/relational-databases/tables/use-sparse-columns).
diff --git a/entity-framework/core/providers/sql-server/full-text-search.md b/entity-framework/core/providers/sql-server/full-text-search.md
new file mode 100644
index 0000000000..54153a9fe7
--- /dev/null
+++ b/entity-framework/core/providers/sql-server/full-text-search.md
@@ -0,0 +1,253 @@
+---
+title: Microsoft SQL Server Database Provider - Full-Text Search - EF Core
+description: Using full-text search with the Entity Framework Core Microsoft SQL Server database provider
+author: roji
+ms.date: 02/05/2026
+uid: core/providers/sql-server/full-text-search
+---
+# Full-Text Search in the SQL Server EF Core Provider
+
+SQL Server provides [full-text search](/sql/relational-databases/search/full-text-search) capabilities that enable sophisticated text search beyond simple `LIKE` patterns. Full-text search supports linguistic matching, inflectional forms, proximity search, and weighted ranking.
+
+EF Core's SQL Server provider supports both full-text search *predicates* (for filtering) and *table-valued functions* (for filtering with ranking).
+
+## Setting up full-text search
+
+Before using full-text search, you must create a [full-text catalog](/sql/t-sql/statements/create-fulltext-catalog-transact-sql) on your database, and a [full-text index](/sql/t-sql/statements/create-fulltext-index-transact-sql) on the columns you want to search.
+
+### [EF Core 11+](#tab/ef-core-11)
+
+> [!NOTE]
+> Full-text catalog and index management in migrations was introduced in EF Core 11.
+
+You can configure full-text catalogs and indexes directly in your EF model. When you add a [migration](xref:core/managing-schemas/migrations/index), EF will generate the appropriate SQL to create (or alter) the catalog and index for you.
+
+First, define a full-text catalog on the model, then configure a full-text index on your entity type:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.HasFullTextCatalog("ftCatalog");
+
+    modelBuilder.Entity<Article>()
+        .HasFullTextIndex(a => a.Contents)
+        .HasKeyIndex("PK_Articles")
+        .OnCatalog("ftCatalog");
+}
+```
+
+The `HasKeyIndex()` method specifies the unique, non-nullable, single-column index used as the full-text key for the table (typically the primary key index). `OnCatalog()` assigns the full-text index to a specific catalog.
+
+You can also configure multiple columns and additional options such as per-column languages and change tracking:
+
+```csharp
+modelBuilder.Entity<Article>()
+    .HasFullTextIndex(a => new { a.Title, a.Contents })
+    .HasKeyIndex("PK_Articles")
+    .OnCatalog("ftCatalog")
+    .WithChangeTracking(FullTextChangeTracking.Manual)
+    .HasLanguage("Title", "English")
+    .HasLanguage("Contents", "French");
+```
+
+The full-text catalog can also be configured as the default catalog, and with accent sensitivity:
+
+```csharp
+modelBuilder.HasFullTextCatalog("ftCatalog")
+    .IsDefault()
+    .IsAccentSensitive(false);
+```
+
+### [Older versions](#tab/older-versions)
+
+On older versions of EF Core, you can set up full-text search by adding raw SQL to a migration. Add an empty migration and then edit it to include the full-text catalog and index creation SQL:
+
+```csharp
+protected override void Up(MigrationBuilder migrationBuilder)
+{
+    migrationBuilder.Sql(
+        sql: "CREATE FULLTEXT CATALOG ftCatalog AS DEFAULT;",
+        suppressTransaction: true);
+
+    migrationBuilder.Sql(
+        sql: "CREATE FULLTEXT INDEX ON Articles(Contents) KEY INDEX PK_Articles;",
+        suppressTransaction: true);
+}
+
+protected override void Down(MigrationBuilder migrationBuilder)
+{
+    migrationBuilder.Sql(
+        sql: "DROP FULLTEXT INDEX ON Articles;",
+        suppressTransaction: true);
+
+    migrationBuilder.Sql(
+        sql: "DROP FULLTEXT CATALOG ftCatalog;",
+        suppressTransaction: true);
+}
+```
+
+---
+
+For more information, see the [SQL Server full-text search documentation](/sql/relational-databases/search/get-started-with-full-text-search).
+
+## Full-text predicates
+
+EF Core supports the `FREETEXT()` and `CONTAINS()` predicates, which are used in `Where()` clauses to filter results.
+
+### FREETEXT()
+
+`FREETEXT()` performs a less strict matching, searching for words based on their meaning, including inflectional forms (such as verb tenses and noun plurals):
+
+```csharp
+var articles = await context.Articles
+    .Where(a => EF.Functions.FreeText(a.Contents, "veggies"))
+    .ToListAsync();
+```
+
+This translates to:
+
+```sql
+SELECT [a].[Id], [a].[Title], [a].[Contents]
+FROM [Articles] AS [a]
+WHERE FREETEXT([a].[Contents], N'veggies')
+```
+
+You can optionally specify a language term:
+
+```csharp
+var articles = await context.Articles
+    .Where(a => EF.Functions.FreeText(a.Contents, "veggies", "English"))
+    .ToListAsync();
+```
+
+### CONTAINS()
+
+`CONTAINS()` performs more precise matching and supports more sophisticated search criteria, including prefix terms, proximity search, and weighted terms:
+
+```csharp
+// Simple search
+var articles = await context.Articles
+    .Where(a => EF.Functions.Contains(a.Contents, "veggies"))
+    .ToListAsync();
+
+// Prefix search (words starting with "vegg")
+var articles = await context.Articles
+    .Where(a => EF.Functions.Contains(a.Contents, "\"vegg*\""))
+    .ToListAsync();
+
+// Phrase search
+var articles = await context.Articles
+    .Where(a => EF.Functions.Contains(a.Contents, "\"fresh vegetables\""))
+    .ToListAsync();
+```
+
+This translates to:
+
+```sql
+SELECT [a].[Id], [a].[Title], [a].[Contents]
+FROM [Articles] AS [a]
+WHERE CONTAINS([a].[Contents], N'veggies')
+```
+
+For more information on `CONTAINS()` query syntax, see the [SQL Server CONTAINS documentation](/sql/t-sql/queries/contains-transact-sql).
+
+## Full-text table-valued functions
+
+> [!NOTE]
+> Full-text table-valued functions are being introduced in EF Core 11.
+
+While the predicates above are useful for filtering, they don't provide ranking information. SQL Server's table-valued functions [`FREETEXTTABLE()`](/sql/relational-databases/system-functions/freetexttable-transact-sql) and [`CONTAINSTABLE()`](/sql/relational-databases/system-functions/containstable-transact-sql) return both matching rows and a ranking score that indicates how well each row matches the search query.
+
+### FreeTextTable()
+
+`FreeTextTable()` is the table-valued function version of `FreeText()`. It returns `FullTextSearchResult<TEntity>`, which includes both the entity and the ranking value:
+
+```csharp
+var results = await context.Articles
+    .Join(
+        context.Articles.FreeTextTable<Article, int>("veggies", topN: 10),
+        a => a.Id,
+        ftt => ftt.Key,
+        (a, ftt) => new { Article = a, ftt.Rank })
+    .OrderByDescending(r => r.Rank)
+    .ToListAsync();
+
+foreach (var result in results)
+{
+    Console.WriteLine($"Article {result.Article.Id} with rank {result.Rank}");
+}
+```
+
+Note that you must provide the generic type parameters; `Article` corresponds to the entity type being searched, where `int` is the full-text search key specified when creating the index, and which is returned by `FREETEXTTABLE()`.
+
+The above automatically searches across all columns registered for full-text searching and returns the top 10 matches. You can also provide a specific column to search:
+
+```csharp
+var results = await context.Articles
+    .Join(
+        context.Articles.FreeTextTable<Article, int>(a => a.Contents, "veggies"),
+        a => a.Id,
+        ftt => ftt.Key,
+        (a, ftt) => new { Article = a, ftt.Rank })
+    .OrderByDescending(r => r.Rank)
+    .ToListAsync();
+```
+
+... or multiple columns:
+
+```csharp
+var results = await context.Articles
+    .FreeTextTable(a => new { a.Title, a.Contents }, "veggies")
+    .Select(r => new { Article = r.Value, Rank = r.Rank })
+    .OrderByDescending(r => r.Rank)
+    .ToListAsync();
+```
+
+### ContainsTable()
+
+`ContainsTable()` is the table-valued function version of `Contains()`, supporting the same sophisticated search syntax while also providing ranking information:
+
+```csharp
+var results = await context.Articles
+    .Join(
+        context.Articles.ContainsTable<Article, int>( "veggies OR fruits"),
+        a => a.Id,
+        ftt => ftt.Key,
+        (a, ftt) => new { Article = a, ftt.Rank })
+    .OrderByDescending(r => r.Rank)
+    .ToListAsync();
+```
+
+### Limiting results
+
+Both table-valued functions support a `topN` parameter to limit the number of results:
+
+```csharp
+var results = await context.Articles
+    .FreeTextTable(a => a.Contents, "veggies", topN: 10)
+    .Select(r => new { Article = r.Value, Rank = r.Rank })
+    .OrderByDescending(r => r.Rank)
+    .ToListAsync();
+```
+
+### Specifying a language
+
+Both table-valued functions support specifying a language term for linguistic matching:
+
+```csharp
+var results = await context.Articles
+    .FreeTextTable(a => a.Contents, "veggies", languageTerm: "English")
+    .Select(r => new { Article = r.Value, Rank = r.Rank })
+    .ToListAsync();
+```
+
+## When to use predicates vs table-valued functions
+
+Feature                           | Predicates (`FreeText()`, `Contains()`) | Table-valued functions (`FreeTextTable()`, `ContainsTable()`)
+--------------------------------- | --------------------------------------- | -------------------------------------------------------------
+Provides ranking                  | ❌ No                                   | ✅ Yes
+Performance for large result sets | Better for filtering                    | Better for ranking and sorting
+Combine with other entities       | Via joins                               | Built-in entity result
+Use in `Where()` clause           | ✅ Yes                                  | ❌ No (use as a source)
+
+Use predicates when you simply need to filter results based on full-text search criteria. Use table-valued functions when you need ranking information to order results by relevance or display relevance scores to users.
diff --git a/entity-framework/core/providers/sql-server/functions.md b/entity-framework/core/providers/sql-server/functions.md
new file mode 100644
index 0000000000..42ea32ef66
--- /dev/null
+++ b/entity-framework/core/providers/sql-server/functions.md
@@ -0,0 +1,267 @@
+---
+title: Function Mappings - Microsoft SQL Server Database Provider - EF Core
+description: Function Mappings of the Microsoft SQL Server database provider
+author: roji
+ms.date: 4/14/2026
+uid: core/providers/sql-server/functions
+---
+# Function Mappings of the Microsoft SQL Server Provider
+
+This page shows which .NET members are translated into which SQL functions when using the SQL Server provider.
+
+## Aggregate functions
+
+.NET                                                                    | SQL                              | Added in
+----------------------------------------------------------------------- | -------------------------------- | --------
+EF.Functions.StandardDeviationSample(group.Select(x => x.Property))     | STDEV(Property)
+EF.Functions.StandardDeviationPopulation(group.Select(x => x.Property)) | STDEVP(Property)
+EF.Functions.VarianceSample(group.Select(x => x.Property))              | VAR(Property)
+EF.Functions.VariancePopulation(group.Select(x => x.Property))          | VARP(Property)
+group.Average(x => x.Property)                                          | AVG(Property)
+group.Count()                                                           | COUNT(*)
+group.LongCount()                                                       | COUNT_BIG(*)
+group.Max(x => x.Property)                                              | MAX(Property)
+group.Min(x => x.Property)                                              | MIN(Property)
+group.Sum(x => x.Property)                                              | SUM(Property)
+string.Concat(group.Select(x => x.Property))                            | STRING_AGG(Property, N'')
+string.Join(separator, group.Select(x => x.Property))                   | STRING_AGG(Property, @separator)
+
+## Binary functions
+
+.NET                         | SQL                           | Added in
+---------------------------- | ----------------------------- | --------
+bytes.Contains(value)        | CHARINDEX(@value, @bytes) > 0
+bytes.ElementAt(i)           | SUBSTRING(@bytes, @i + 1, 1)
+bytes.First()                | SUBSTRING(@bytes, 1, 1)
+bytes.Length                 | DATALENGTH(@bytes)
+bytes.SequenceEqual(second)  | @bytes = @second
+bytes[i]                     | SUBSTRING(@bytes, @i + 1, 1)
+EF.Functions.DataLength(arg) | DATALENGTH(@arg)
+
+## Conversion functions
+
+.NET                      | SQL                                    | Added in
+------------------------- | -------------------------------------- | --------
+bytes.ToString()          | CONVERT(varchar(100), @bytes)
+byteValue.ToString()      | CONVERT(varchar(3), @byteValue)
+charValue.ToString()      | CONVERT(varchar(1), @charValue)
+Convert.ToBoolean(value)  | CONVERT(bit, @value)
+Convert.ToByte(value)     | CONVERT(tinyint, @value)
+Convert.ToDecimal(value)  | CONVERT(decimal(18, 2), @value)
+Convert.ToDouble(value)   | CONVERT(float, @value)
+Convert.ToInt16(value)    | CONVERT(smallint, @value)
+Convert.ToInt32(value)    | CONVERT(int, @value)
+Convert.ToInt64(value)    | CONVERT(bigint, @value)
+Convert.ToString(value)   | CONVERT(nvarchar(max), @value)
+dateOnly.ToString()       | CONVERT(varchar(100), @dateOnly)
+dateTime.ToString()       | CONVERT(varchar(100), @dateTime)
+dateTimeOffset.ToString() | CONVERT(varchar(100), @dateTimeOffset)
+decimalValue.ToString()   | CONVERT(varchar(100), @decimalValue)
+doubleValue.ToString()    | CONVERT(varchar(100), @doubleValue)
+floatValue.ToString()     | CONVERT(varchar(100), @floatValue)
+guid.ToString()           | CONVERT(varchar(36), @guid)
+intValue.ToString()       | CONVERT(varchar(11), @intValue)
+longValue.ToString()      | CONVERT(varchar(20), @longValue)
+sbyteValue.ToString()     | CONVERT(varchar(4), @sbyteValue)
+shortValue.ToString()     | CONVERT(varchar(6), @shortValue)
+timeOnly.ToString()       | CONVERT(varchar(100), @timeOnly)
+timeSpan.ToString()       | CONVERT(varchar(100), @timeSpan)
+uintValue.ToString()      | CONVERT(varchar(10), @uintValue)
+ulongValue.ToString()     | CONVERT(varchar(19), @ulongValue)
+ushortValue.ToString()    | CONVERT(varchar(5), @ushortValue)
+
+## Date and time functions
+
+.NET                                                        | SQL                                                                             | Added in
+----------------------------------------------------------- | ------------------------------------------------------------------------------- | --------
+DateTime.Now                                                | GETDATE()
+DateTime.Today                                              | CONVERT(date, GETDATE())
+DateTime.UtcNow                                             | GETUTCDATE()
+dateTime.AddDays(value)                                     | DATEADD(day, @value, @dateTime)
+dateTime.AddHours(value)                                    | DATEADD(hour, @value, @dateTime)
+dateTime.AddMilliseconds(value)                             | DATEADD(millisecond, @value, @dateTime)
+dateTime.AddMinutes(value)                                  | DATEADD(minute, @value, @dateTime)
+dateTime.AddMonths(months)                                  | DATEADD(month, @months, @dateTime)
+dateTime.AddSeconds(value)                                  | DATEADD(second, @value, @dateTime)
+dateTime.AddYears(value)                                    | DATEADD(year, @value, @dateTime)
+dateTime.Date                                               | CONVERT(date, @dateTime)
+dateTime.Day                                                | DATEPART(day, @dateTime)
+dateTime.DayOfYear                                          | DATEPART(dayofyear, @dateTime)
+dateTime.Hour                                               | DATEPART(hour, @dateTime)
+dateTime.Microsecond                                        | DATEPART(microsecond, @dateTime) % 1000                                         | EF Core 10.0
+dateTime.Millisecond                                        | DATEPART(millisecond, @dateTime)
+dateTime.Minute                                             | DATEPART(minute, @dateTime)
+dateTime.Month                                              | DATEPART(month, @dateTime)
+dateTime.Nanosecond                                         | DATEPART(nanosecond, @dateTime) % 1000                                          | EF Core 10.0
+dateTime.Second                                             | DATEPART(second, @dateTime)
+dateTime.TimeOfDay                                          | CONVERT(time, @dateTime)
+dateTime.Year                                               | DATEPART(year, @dateTime)
+DateTimeOffset.Now                                          | SYSDATETIMEOFFSET()
+DateTimeOffset.UtcNow                                       | SYSUTCDATETIME()
+dateTimeOffset.AddDays(days)                                | DATEADD(day, @days, @dateTimeOffset)
+dateTimeOffset.AddHours(hours)                              | DATEADD(hour, @hours, @dateTimeOffset)
+dateTimeOffset.AddMilliseconds(milliseconds)                | DATEADD(millisecond, @milliseconds, @dateTimeOffset)
+dateTimeOffset.AddMinutes(minutes)                          | DATEADD(minute, @minutes, @dateTimeOffset)
+dateTimeOffset.AddMonths(months)                            | DATEADD(month, @months, @dateTimeOffset)
+dateTimeOffset.AddSeconds(seconds)                          | DATEADD(second, @seconds, @dateTimeOffset)
+dateTimeOffset.AddYears(years)                              | DATEADD(year, @years, @dateTimeOffset)
+dateTimeOffset.Date                                         | CONVERT(date, @dateTimeOffset)
+dateTimeOffset.DateTime                                     | CONVERT(datetime2, @dateTimeOffset)                                             | EF Core 11.0
+dateTimeOffset.Day                                          | DATEPART(day, @dateTimeOffset)
+dateTimeOffset.DayOfYear                                    | DATEPART(dayofyear, @dateTimeOffset)
+dateTimeOffset.Hour                                         | DATEPART(hour, @dateTimeOffset)
+dateTimeOffset.LocalDateTime                                | CONVERT(datetime2, @dateTimeOffset AT TIME ZONE CURRENT_TIMEZONE_ID())          | EF Core 11.0
+dateTimeOffset.Microsecond                                  | DATEPART(microsecond, @dateTimeOffset) % 1000                                   | EF Core 10.0
+dateTimeOffset.Millisecond                                  | DATEPART(millisecond, @dateTimeOffset)
+dateTimeOffset.Minute                                       | DATEPART(minute, @dateTimeOffset)
+dateTimeOffset.Month                                        | DATEPART(month, @dateTimeOffset)
+dateTimeOffset.Nanosecond                                   | DATEPART(nanosecond, @dateTimeOffset) % 1000                                    | EF Core 10.0
+dateTimeOffset.Offset.TotalMinutes                          | CAST(DATEPART(tz, @dateTimeOffset) AS float)                                    | EF Core 11.0
+dateTimeOffset.Second                                       | DATEPART(second, @dateTimeOffset)
+dateTimeOffset.TimeOfDay                                    | CONVERT(time, @dateTimeOffset)
+dateTimeOffset.ToOffset(offset)                             | SWITCHOFFSET(@dateTimeOffset, @offset)                                          | EF Core 11.0
+dateTimeOffset.ToUnixTimeSeconds()                          | DATEDIFF_BIG(second, '1970-01-01T00:00:00.0000000+00:00', @dateTimeOffset)
+dateTimeOffset.ToUnixTimeMilliseconds()                     | DATEDIFF_BIG(millisecond, '1970-01-01T00:00:00.0000000+00:00', @dateTimeOffset)
+dateTimeOffset.UtcDateTime                                  | CONVERT(datetime2, @dateTimeOffset AT TIME ZONE 'UTC')                          | EF Core 11.0
+dateTimeOffset.Year                                         | DATEPART(year, @dateTimeOffset)
+new DateTimeOffset(dateTime)                                | TODATETIMEOFFSET(@dateTime, '+00:00')                                           | EF Core 11.0
+new DateTimeOffset(dateTime, offset)                        | TODATETIMEOFFSET(@dateTime, @offset)                                            | EF Core 11.0
+DateOnly.FromDateTime(dateTime)                             | CONVERT(date, @dateTime)
+dateOnly.AddDays(value)                                     | DATEADD(day, @value, @dateOnly)
+dateOnly.AddMonths(months)                                  | DATEADD(month, @months, @dateOnly)
+dateOnly.AddYears(value)                                    | DATEADD(year, @value, @dateOnly)
+dateOnly.Day                                                | DATEPART(day, @dateOnly)
+dateOnly.DayOfYear                                          | DATEPART(dayofyear, @dateOnly)
+dateOnly.Month                                              | DATEPART(month, @dateOnly)
+dateOnly.Year                                               | DATEPART(year, @dateOnly)
+dateOnly.DayNumber                                          | DATEDIFF(day, '0001-01-01', @dateOnly)                                          | EF Core 10.0
+EF.Functions.AtTimeZone(dateTime, timeZone)                 | @dateTime AT TIME ZONE @timeZone
+EF.Functions.DateDiffDay(start, end)                        | DATEDIFF(day, @start, @end)
+EF.Functions.DateDiffHour(start, end)                       | DATEDIFF(hour, @start, @end)
+EF.Functions.DateDiffMicrosecond(start, end)                | DATEDIFF(microsecond, @start, @end)
+EF.Functions.DateDiffMillisecond(start, end)                | DATEDIFF(millisecond, @start, @end)
+EF.Functions.DateDiffMinute(start, end)                     | DATEDIFF(minute, @start, @d2)
+EF.Functions.DateDiffMonth(start, end)                      | DATEDIFF(month, @start, @end)
+EF.Functions.DateDiffNanosecond(start, end)                 | DATEDIFF(nanosecond, @start, @end)
+EF.Functions.DateDiffSecond(start, end)                     | DATEDIFF(second, @start, @end)
+EF.Functions.DateDiffWeek(start, end)                       | DATEDIFF(week, @start, @end)
+EF.Functions.DateDiffYear(start, end)                       | DATEDIFF(year, @start, @end)
+EF.Functions.DateFromParts(year, month, day)                | DATEFROMPARTS(@year, @month, @day)
+EF.Functions.DateTime2FromParts(year, month, day, ...)      | DATETIME2FROMPARTS(@year, @month, @day, ...)
+EF.Functions.DateTimeFromParts(year, month, day, ...)       | DATETIMEFROMPARTS(@year, @month, @day, ...)
+EF.Functions.DateTimeOffsetFromParts(year, month, day, ...) | DATETIMEOFFSETFROMPARTS(@year, @month, @day, ...)
+EF.Functions.DateTrunc(datepart, value)                     | DATETRUNC(@datepart, @value)                                                    | EF Core 11.0
+EF.Functions.IsDate(expression)                             | ISDATE(@expression)
+EF.Functions.SmallDateTimeFromParts(year, month, day, ...)  | SMALLDATETIMEFROMPARTS(@year, @month, @day, ...)
+EF.Functions.TimeFromParts(hour, minute, second, ...)       | TIMEFROMPARTS(@hour, @minute, @second, ...)
+timeOnly.AddHours(value)                                    | DATEADD(hour, @value, @timeOnly)
+timeOnly.AddMinutes(value)                                  | DATEADD(minute, @value, @timeOnly)
+timeOnly.Hour                                               | DATEPART(hour, @timeOnly)
+timeOnly.IsBetween(start, end)                              | @timeOnly >= @start AND @timeOnly < @end
+timeOnly.Microsecond                                        | DATEPART(microsecond, @timeOnly) % 1000                                         | EF Core 10.0
+timeOnly.Millisecond                                        | DATEPART(millisecond, @timeOnly)
+timeOnly.Minute                                             | DATEPART(minute, @timeOnly)
+timeOnly.Nanosecond                                         | DATEPART(nanosecond, @timeOnly) % 1000                                          | EF Core 10.0
+timeOnly.Second                                             | DATEPART(second, @timeOnly)
+timeSpan.Hours                                              | DATEPART(hour, @timeSpan)
+timeSpan.Microsecond                                        | DATEPART(microsecond, @timeSpan) % 1000                                         | EF Core 10.0
+timeSpan.Milliseconds                                       | DATEPART(millisecond, @timeSpan)
+timeSpan.Minutes                                            | DATEPART(minute, @timeSpan)
+timeSpan.Nanosecond                                         | DATEPART(nanosecond, @timeSpan) % 1000                                          | EF Core 10.0
+timeSpan.Seconds                                            | DATEPART(second, @timeSpan)
+
+## Numeric functions
+
+.NET                       | SQL                  | Added in
+-------------------------- | -------------------- | --------
+double.DegreesToRadians(x) | RADIANS(@x)
+double.RadiansToDegrees(x) | DEGREES(@x)
+EF.Functions.Random()      | RAND()
+Math.Abs(value)            | ABS(@value)
+Math.Acos(d)               | ACOS(@d)
+Math.Asin(d)               | ASIN(@d)
+Math.Atan(d)               | ATAN(@d)
+Math.Atan2(y, x)           | ATN2(@y, @x)
+Math.Ceiling(d)            | CEILING(@d)
+Math.Cos(d)                | COS(@d)
+Math.Exp(d)                | EXP(@d)
+Math.Floor(d)              | FLOOR(@d)
+Math.Log(d)                | LOG(@d)
+Math.Log(a, newBase)       | LOG(@a, @newBase)
+Math.Log10(d)              | LOG10(@d)
+Math.Max(x, y)             | GREATEST(@x, @y)    | EF Core 9.0
+Math.Min(x, y)             | LEAST(@x, @y)       | EF Core 9.0
+Math.Pow(x, y)             | POWER(@x, @y)
+Math.Round(d)              | ROUND(@d, 0)
+Math.Round(d, decimals)    | ROUND(@d, @decimals)
+Math.Sign(value)           | SIGN(@value)
+Math.Sin(a)                | SIN(@a)
+Math.Sqrt(d)               | SQRT(@d)
+Math.Tan(a)                | TAN(@a)
+Math.Truncate(d)           | ROUND(@d, 0, 1)
+
+> [!TIP]
+> In addition to the methods listed here, corresponding [generic math](/dotnet/standard/generics/math) implementations
+> and [MathF](/dotnet/api/system.mathf) methods are also translated. For example, `Math.Sin`, `MathF.Sin`, `double.Sin`,
+> and `float.Sin` all map to the `SIN` function in SQL.
+
+## String functions
+
+.NET                                                                    | SQL                                                                    | Added in
+----------------------------------------------------------------------- | ---------------------------------------------------------------------- | --------
+EF.Functions.Collate(operand, collation)                                | @operand COLLATE @collation
+EF.Functions.Contains(propertyReference, searchCondition)               | CONTAINS(@propertyReference, @searchCondition)
+EF.Functions.Contains(propertyReference, searchCondition, languageTerm) | CONTAINS(@propertyReference, @searchCondition, LANGUAGE @languageTerm)
+EF.Functions.FreeText(propertyReference, freeText)                      | FREETEXT(@propertyReference, @freeText)
+EF.Functions.FreeText(propertyReference, freeText, languageTerm)        | FREETEXT(@propertyReference, @freeText, LANGUAGE @languageTerm)
+EF.Functions.IsNumeric(expression)                                      | ISNUMERIC(@expression)
+EF.Functions.Like(matchExpression, pattern)                             | @matchExpression LIKE @pattern
+EF.Functions.Like(matchExpression, pattern, escapeCharacter)            | @matchExpression LIKE @pattern ESCAPE @escapeCharacter
+string.Compare(strA, strB)                                              | CASE WHEN @strA = @strB THEN 0 ... END
+string.Concat(str0, str1)                                               | @str0 + @str1
+string.IsNullOrEmpty(value)                                             | @value IS NULL OR @value LIKE N''
+string.IsNullOrWhiteSpace(value)                                        | @value IS NULL OR @value = N''
+string.Join(", ", new [] { x, y, z})                                    | CONCAT_WS(N', ', @x, @y, @z)                                           | EF Core 9.0
+stringValue.CompareTo(strB)                                             | CASE WHEN @stringValue = @strB THEN 0 ... END
+stringValue.Contains(value)                                             | @stringValue LIKE N'%' + @value + N'%'
+stringValue.EndsWith(value)                                             | @stringValue LIKE N'%' + @value
+stringValue.FirstOrDefault()                                            | SUBSTRING(@stringValue, 1, 1)
+stringValue.IndexOf(value)                                              | CHARINDEX(@value, @stringValue) - 1
+stringValue.IndexOf(value, startIndex)                                  | CHARINDEX(@value, @stringValue, @startIndex) - 1
+stringValue.LastOrDefault()                                             | SUBSTRING(@stringValue, LEN(@stringValue), 1)
+stringValue.Length                                                      | LEN(@stringValue)
+stringValue.Replace(@oldValue, @newValue)                               | REPLACE(@stringValue, @oldValue, @newValue)
+stringValue.StartsWith(value)                                           | @stringValue LIKE @value + N'%'
+stringValue.Substring(startIndex)                                       | SUBSTRING(@stringValue, @startIndex + 1, LEN(@stringValue))
+stringValue.Substring(startIndex, length)                               | SUBSTRING(@stringValue, @startIndex + 1, @length)
+stringValue.ToLower()                                                   | LOWER(@stringValue)
+stringValue.ToUpper()                                                   | UPPER(@stringValue)
+stringValue.Trim()                                                      | LTRIM(RTRIM(@stringValue))
+stringValue.TrimEnd()                                                   | RTRIM(@stringValue)
+stringValue.TrimStart()                                                 | LTRIM(@stringValue)
+
+## JSON functions
+
+.NET                                                              | SQL                                                       | Added in
+----------------------------------------------------------------- | --------------------------------------------------------- | --------
+EF.Functions.JsonContains(json, searchValue, path?, searchMode?)  | JSON_CONTAINS(@json, @searchValue, @path?, @searchMode?)  | EF 11.0
+EF.Functions.JsonPathExists(json, path)                           | JSON_PATH_EXISTS(@json, @path)                            | EF 11.0
+
+## Miscellaneous functions
+
+.NET                                     | SQL                                 | Added in
+---------------------------------------- | ----------------------------------- | --------
+enumValue.HasFlag(flag)                  | @enumValue & @flag = @flag
+Guid.NewGuid()                           | NEWID()
+nullable.GetValueOrDefault()             | COALESCE(@nullable, 0)
+nullable.GetValueOrDefault(defaultValue) | COALESCE(@nullable, @defaultValue)
+
+> [!NOTE]
+> Some SQL translations have been simplified for illustration purposes. The actual SQL is more complex to handle a wider range of values.
+
+## See also
+
+* [Vector Search Function Mappings](xref:core/providers/sql-server/vector-search)
+* [Full-Text Search Function Mappings](xref:core/providers/sql-server/full-text-search)
+* [Spatial Function Mappings](xref:core/providers/sql-server/spatial#spatial-function-mappings)
+* [HierarchyId Function Mappings](xref:core/providers/sql-server/hierarchyid#function-mappings)
diff --git a/entity-framework/core/providers/sql-server/hierarchyid.md b/entity-framework/core/providers/sql-server/hierarchyid.md
new file mode 100644
index 0000000000..dcbcca2a75
--- /dev/null
+++ b/entity-framework/core/providers/sql-server/hierarchyid.md
@@ -0,0 +1,410 @@
+---
+title: Microsoft SQL Server Database Provider - Hierarchical Data - EF Core
+description: Using hierarchical data with the Entity Framework Core Microsoft SQL Server database provider
+author: SamMonoRT
+ms.date: 03/11/2023
+uid: core/providers/sql-server/hierarchyid
+ms.custom: sfi-ropc-nochange
+---
+# Hierarchical Data in the SQL Server EF Core Provider
+
+> [!NOTE]
+> This feature was added in EF Core 8.0.
+
+Azure SQL and SQL Server have a special data type called [`hierarchyid`](/sql/t-sql/data-types/hierarchyid-data-type-method-reference) that is used to store [hierarchical data](/sql/relational-databases/hierarchical-data-sql-server). In this case, "hierarchical data" essentially means data that forms a tree structure, where each item can have a parent and/or children. Examples of such data are:
+
+- An organizational structure
+- A file system
+- A set of tasks in a project
+- A taxonomy of language terms
+- A graph of links between Web pages
+
+The database is then able to run queries against this data using its hierarchical structure. For example, a query can find ancestors and dependents of given items, or find all items at a certain depth in the hierarchy.
+
+## Using HierarchyId in .NET and EF Core
+
+At the lowest level, the [Microsoft.SqlServer.Types](https://www.nuget.org/packages/Microsoft.SqlServer.Types) NuGet package includes a type called `SqlHierarchyId`. While this type supports working hierarchyid values, it is a bit cumbersome to work with in LINQ.
+
+At the next level, a new [Microsoft.EntityFrameworkCore.SqlServer.Abstractions](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.SqlServer.Abstractions) package has been introduced, which includes a higher-level `HierarchyId` type intended for use in entity types.
+
+> [!TIP]
+> The `HierarchyId` type is more idiomatic to the norms of .NET than `SqlHierarchyId`, which is instead modeled after how .NET Framework types are hosted inside the SQL Server database engine.  `HierarchyId` is designed to work with EF Core, but it can also be used outside of EF Core in other applications. The `Microsoft.EntityFrameworkCore.SqlServer.Abstractions` package doesn't reference any other packages, and so has minimal impact on deployed application size and dependencies.
+
+Use of `HierarchyId` for EF Core functionality such as queries and updates requires the [Microsoft.EntityFrameworkCore.SqlServer.HierarchyId](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.SqlServer.HierarchyId) package. This package brings in `Microsoft.EntityFrameworkCore.SqlServer.Abstractions` and `Microsoft.SqlServer.Types` as transitive dependencies, and so is often the only package needed.
+
+### [.NET CLI](#tab/netcore-cli)
+
+```dotnetcli
+dotnet add package Microsoft.EntityFrameworkCore.SqlServer.HierarchyId
+```
+
+### [Visual Studio](#tab/visual-studio)
+
+- **Tools > NuGet Package Manager > Package Manager Console**
+- Run the following commands:
+
+  ```powershell
+  Install-Package Microsoft.EntityFrameworkCore.SqlServer.HierarchyId
+  ```
+
+Tip: You can also install packages by right-clicking on the project and selecting **Manage NuGet Packages**
+
+---
+
+Once the package is installed, use of `HierarchyId` is enabled by calling `UseHierarchyId` as part of the application's call to `UseSqlServer`. For example:
+
+```csharp
+options.UseSqlServer(
+    connectionString,
+    x => x.UseHierarchyId());
+```
+
+#### Modeling hierarchies
+
+The `HierarchyId` type can be used for properties of an entity type. For example, assume we want to model the paternal family tree of some fictional [halflings](https://en.wikipedia.org/wiki/Halfling). In the entity type for `Halfling`, a `HierarchyId` property can be used to locate each halfling in the family tree.
+
+<!--
+    public class Halfling
+    {
+        public Halfling(HierarchyId pathFromPatriarch, string name, int? yearOfBirth = null)
+        {
+            PathFromPatriarch = pathFromPatriarch;
+            Name = name;
+            YearOfBirth = yearOfBirth;
+        }
+
+        public int Id { get; private set; }
+        public HierarchyId PathFromPatriarch { get; set; }
+        public string Name { get; set; }
+        public int? YearOfBirth { get; set; }
+    }
+-->
+[!code-csharp[Halfling](../../../../samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs?name=Halfling)]
+
+> [!TIP]
+> The code shown here and in the examples below comes from [HierarchyIdSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs).
+
+> [!TIP]
+> If desired, `HierarchyId` is suitable for use as a key property type.
+
+In this case, the family tree is rooted with the patriarch of the family. Each halfling can be traced from the patriarch down the tree using its `PathFromPatriarch` property. SQL Server uses a compact binary format for these paths, but it is common to parse to and from a human-readable string representation when working with code. In this representation, the position at each level is separated by a `/` character. For example, consider the family tree in the diagram below:
+
+![Halfling family tree](../../what-is-new/ef-core-8.0/familytree.png)
+
+In this tree:
+
+- Balbo is at the root of the tree, represented by `/`.
+- Balbo has five children, represented by `/1/`, `/2/`, `/3/`, `/4/`, and `/5/`.
+- Balbo's first child, Mungo, also has five children, represented by `/1/1/`, `/1/2/`, `/1/3/`, `/1/4/`, and `/1/5/`. Notice that the `HierarchyId` for Mungo (`/1/`) is the prefix for all his children.
+- Similarly, Balbo's third child, Ponto, has two children, represented by `/3/1/` and `/3/2/`. Again the each of these children is prefixed by the `HierarchyId` for Ponto, which is represented as `/3/`.
+- And so on down the tree...
+
+The following code inserts this family tree into a database using EF Core:
+
+<!--
+            await AddRangeAsync(
+                new Halfling(HierarchyId.Parse("/"), "Balbo", 1167),
+                new Halfling(HierarchyId.Parse("/1/"), "Mungo", 1207),
+                new Halfling(HierarchyId.Parse("/2/"), "Pansy", 1212),
+                new Halfling(HierarchyId.Parse("/3/"), "Ponto", 1216),
+                new Halfling(HierarchyId.Parse("/4/"), "Largo", 1220),
+                new Halfling(HierarchyId.Parse("/5/"), "Lily", 1222),
+                new Halfling(HierarchyId.Parse("/1/1/"), "Bungo", 1246),
+                new Halfling(HierarchyId.Parse("/1/2/"), "Belba", 1256),
+                new Halfling(HierarchyId.Parse("/1/3/"), "Longo", 1260),
+                new Halfling(HierarchyId.Parse("/1/4/"), "Linda", 1262),
+                new Halfling(HierarchyId.Parse("/1/5/"), "Bingo", 1264),
+                new Halfling(HierarchyId.Parse("/3/1/"), "Rosa", 1256),
+                new Halfling(HierarchyId.Parse("/3/2/"), "Polo"),
+                new Halfling(HierarchyId.Parse("/4/1/"), "Fosco", 1264),
+                new Halfling(HierarchyId.Parse("/1/1/1/"), "Bilbo", 1290),
+                new Halfling(HierarchyId.Parse("/1/3/1/"), "Otho", 1310),
+                new Halfling(HierarchyId.Parse("/1/5/1/"), "Falco", 1303),
+                new Halfling(HierarchyId.Parse("/3/2/1/"), "Posco", 1302),
+                new Halfling(HierarchyId.Parse("/3/2/2/"), "Prisca", 1306),
+                new Halfling(HierarchyId.Parse("/4/1/1/"), "Dora", 1302),
+                new Halfling(HierarchyId.Parse("/4/1/2/"), "Drogo", 1308),
+                new Halfling(HierarchyId.Parse("/4/1/3/"), "Dudo", 1311),
+                new Halfling(HierarchyId.Parse("/1/3/1/1/"), "Lotho", 1310),
+                new Halfling(HierarchyId.Parse("/1/5/1/1/"), "Poppy", 1344),
+                new Halfling(HierarchyId.Parse("/3/2/1/1/"), "Ponto", 1346),
+                new Halfling(HierarchyId.Parse("/3/2/1/2/"), "Porto", 1348),
+                new Halfling(HierarchyId.Parse("/3/2/1/3/"), "Peony", 1350),
+                new Halfling(HierarchyId.Parse("/4/1/2/1/"), "Frodo", 1368),
+                new Halfling(HierarchyId.Parse("/4/1/3/1/"), "Daisy", 1350),
+                new Halfling(HierarchyId.Parse("/3/2/1/1/1/"), "Angelica", 1381));
+
+            await SaveChangesAsync();
+-->
+[!code-csharp[AddRangeAsync](../../../../samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs?name=AddRangeAsync)]
+
+> [!TIP]
+> If needed, decimal values can be used to create new nodes between two existing nodes. For example, `/3/2.5/2/` goes between `/3/2/2/` and `/3/3/2/`.
+
+#### Querying hierarchies
+
+`HierarchyId` exposes several methods that can be used in LINQ queries.
+
+| Method                                                           | Description                                                                                                                                                                |
+|------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `GetAncestor(int n)`                                             | Gets the node `n` levels up the hierarchical tree.                                                                                                                         |
+| `GetDescendant(HierarchyId? child1, HierarchyId? child2)`        | Gets the value of a descendant node that is greater than `child1` and less than `child2`.                                                                                  |
+| `GetLevel()`                                                     | Gets the level of this node in the hierarchical tree.                                                                                                                      |
+| `GetReparentedValue(HierarchyId? oldRoot, HierarchyId? newRoot)` | Gets a value representing the location of a new node that has a path from `newRoot` equal to the path from `oldRoot` to this, effectively moving this to the new location. |
+| `IsDescendantOf(HierarchyId? parent)`                            | Gets a value indicating whether this node is a descendant of `parent`.                                                                                                     |
+
+In addition, the operators `==`, `!=`, `<`, `<=`, `>` and `>=` can be used.
+
+The following are examples of using these methods in LINQ queries.
+
+**Get entities at a given level in the tree**
+
+The following query uses `GetLevel` to return all halflings at a given level in the family tree:
+
+<!--
+            var generation = await context.Halflings.Where(halfling => halfling.PathFromPatriarch.GetLevel() == level).ToListAsync();
+-->
+[!code-csharp[GetLevel](../../../../samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs?name=GetLevel)]
+
+This translates to the following SQL:
+
+```sql
+SELECT [h].[Id], [h].[Name], [h].[PathFromPatriarch], [h].[YearOfBirth]
+FROM [Halflings] AS [h]
+WHERE [h].[PathFromPatriarch].GetLevel() = @__level_0
+```
+
+Running this in a loop we can get the halflings for every generation:
+
+```text
+Generation 0: Balbo
+Generation 1: Mungo, Pansy, Ponto, Largo, Lily
+Generation 2: Bungo, Belba, Longo, Linda, Bingo, Rosa, Polo, Fosco
+Generation 3: Bilbo, Otho, Falco, Posco, Prisca, Dora, Drogo, Dudo
+Generation 4: Lotho, Poppy, Ponto, Porto, Peony, Frodo, Daisy
+Generation 5: Angelica
+```
+
+**Get the direct ancestor of an entity**
+
+The following query uses `GetAncestor` to find the direct ancestor of a halfling, given that halfling's name:
+
+<!--
+        async Task<Halfling?> FindDirectAncestor(string name)
+            => await context.Halflings
+                .SingleOrDefaultAsync(
+                    ancestor => ancestor.PathFromPatriarch == context.Halflings
+                        .Single(descendent => descendent.Name == name).PathFromPatriarch
+                        .GetAncestor(1));
+-->
+[!code-csharp[FindDirectAncestor](../../../../samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs?name=FindDirectAncestor)]
+
+This translates to the following SQL:
+
+```sql
+SELECT TOP(2) [h].[Id], [h].[Name], [h].[PathFromPatriarch], [h].[YearOfBirth]
+FROM [Halflings] AS [h]
+WHERE [h].[PathFromPatriarch] = (
+    SELECT TOP(1) [h0].[PathFromPatriarch]
+    FROM [Halflings] AS [h0]
+    WHERE [h0].[Name] = @__name_0).GetAncestor(1)
+```
+
+Running this query for the halfling "Bilbo" returns "Bungo".
+
+**Get the direct descendants of an entity**
+
+The following query also uses `GetAncestor`, but this time to find the direct descendants of a halfling, given that halfling's name:
+
+<!--
+        IQueryable<Halfling> FindDirectDescendents(string name)
+            => context.Halflings.Where(
+                descendent => descendent.PathFromPatriarch.GetAncestor(1) == context.Halflings
+                    .Single(ancestor => ancestor.Name == name).PathFromPatriarch);
+-->
+[!code-csharp[FindDirectDescendents](../../../../samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs?name=FindDirectDescendents)]
+
+This translates to the following SQL:
+
+```sql
+SELECT [h].[Id], [h].[Name], [h].[PathFromPatriarch], [h].[YearOfBirth]
+FROM [Halflings] AS [h]
+WHERE [h].[PathFromPatriarch].GetAncestor(1) = (
+    SELECT TOP(1) [h0].[PathFromPatriarch]
+    FROM [Halflings] AS [h0]
+    WHERE [h0].[Name] = @__name_0)
+```
+
+Running this query for the halfling "Mungo" returns "Bungo", "Belba", "Longo", and "Linda".
+
+**Get all ancestors of an entity**
+
+`GetAncestor` is useful for searching up or down a single level, or, indeed, a specified number of levels. On the other hand, `IsDescendantOf` is useful for finding all ancestors or dependents. For example, the following query uses `IsDescendantOf` to find the all the ancestors of a halfling, given that halfling's name:
+
+<!--
+        IQueryable<Halfling> FindAllAncestors(string name)
+            => context.Halflings.Where(
+                    ancestor => context.Halflings
+                        .Single(
+                            descendent =>
+                                descendent.Name == name
+                                && ancestor.Id != descendent.Id)
+                        .PathFromPatriarch.IsDescendantOf(ancestor.PathFromPatriarch))
+                .OrderByDescending(ancestor => ancestor.PathFromPatriarch.GetLevel());
+-->
+[!code-csharp[FindAllAncestors](../../../../samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs?name=FindAllAncestors)]
+
+> [!IMPORTANT]
+> `IsDescendantOf` returns true for itself, which is why it is filtered out in the query above.
+
+This translates to the following SQL:
+
+```sql
+SELECT [h].[Id], [h].[Name], [h].[PathFromPatriarch], [h].[YearOfBirth]
+FROM [Halflings] AS [h]
+WHERE (
+    SELECT TOP(1) [h0].[PathFromPatriarch]
+    FROM [Halflings] AS [h0]
+    WHERE [h0].[Name] = @__name_0 AND [h].[Id] <> [h0].[Id]).IsDescendantOf([h].[PathFromPatriarch]) = CAST(1 AS bit)
+ORDER BY [h].[PathFromPatriarch].GetLevel() DESC
+```
+
+Running this query for the halfling "Bilbo" returns "Bungo", "Mungo", and "Balbo".
+
+**Get all descendants of an entity**
+
+The following query also uses `IsDescendantOf`, but this time to all the descendants of a halfling, given that halfling's name:
+
+<!--
+        IQueryable<Halfling> FindAllDescendents(string name)
+            => context.Halflings.Where(
+                    descendent => descendent.PathFromPatriarch.IsDescendantOf(
+                        context.Halflings
+                            .Single(
+                                ancestor =>
+                                    ancestor.Name == name
+                                    && descendent.Id != ancestor.Id)
+                            .PathFromPatriarch))
+                .OrderBy(descendent => descendent.PathFromPatriarch.GetLevel());
+-->
+[!code-csharp[FindAllDescendents](../../../../samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs?name=FindAllDescendents)]
+
+This translates to the following SQL:
+
+```sql
+SELECT [h].[Id], [h].[Name], [h].[PathFromPatriarch], [h].[YearOfBirth]
+FROM [Halflings] AS [h]
+WHERE [h].[PathFromPatriarch].IsDescendantOf((
+    SELECT TOP(1) [h0].[PathFromPatriarch]
+    FROM [Halflings] AS [h0]
+    WHERE [h0].[Name] = @__name_0 AND [h].[Id] <> [h0].[Id])) = CAST(1 AS bit)
+ORDER BY [h].[PathFromPatriarch].GetLevel()
+```
+
+Running this query for the halfling "Mungo" returns "Bungo", "Belba", "Longo", "Linda", "Bingo", "Bilbo", "Otho", "Falco", "Lotho", and "Poppy".
+
+**Finding a common ancestor**
+
+One of the most common questions asked about this particular family tree is, "who is the common ancestor of Frodo and Bilbo?" We can use `IsDescendantOf` to write such a query:
+
+<!--
+        async Task<Halfling?> FindCommonAncestor(Halfling first, Halfling second)
+            => await context.Halflings
+                .Where(
+                    ancestor => first.PathFromPatriarch.IsDescendantOf(ancestor.PathFromPatriarch)
+                                && second.PathFromPatriarch.IsDescendantOf(ancestor.PathFromPatriarch))
+                .OrderByDescending(ancestor => ancestor.PathFromPatriarch.GetLevel())
+                .FirstOrDefaultAsync();
+-->
+[!code-csharp[FindCommonAncestor](../../../../samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs?name=FindCommonAncestor)]
+
+This translates to the following SQL:
+
+```sql
+SELECT TOP(1) [h].[Id], [h].[Name], [h].[PathFromPatriarch], [h].[YearOfBirth]
+FROM [Halflings] AS [h]
+WHERE @__first_PathFromPatriarch_0.IsDescendantOf([h].[PathFromPatriarch]) = CAST(1 AS bit)
+  AND @__second_PathFromPatriarch_1.IsDescendantOf([h].[PathFromPatriarch]) = CAST(1 AS bit)
+ORDER BY [h].[PathFromPatriarch].GetLevel() DESC
+```
+
+Running this query with "Bilbo" and "Frodo" tells us that their common ancestor is "Balbo".
+
+#### Updating hierarchies
+
+The normal [change tracking](xref:core/change-tracking/index) and [SaveChanges](xref:core/saving/basic) mechanisms can be used to update `hierarchyid` columns.
+
+**Re-parenting a sub-hierarchy**
+
+For example, I'm sure we all remember the scandal of SR 1752 (a.k.a. "LongoGate") when DNA testing revealed that Longo was not in fact the son of Mungo, but actually the son of Ponto! One fallout from this scandal was that the family tree needed to be re-written. In particular, Longo and all his descendants needed to be re-parented from Mungo to Ponto. `GetReparentedValue` can be used to do this. For example, first "Longo" and all his descendants are queried:
+
+<!--
+        var longoAndDescendents = await context.Halflings.Where(
+                descendent => descendent.PathFromPatriarch.IsDescendantOf(
+                    context.Halflings.Single(ancestor => ancestor.Name == "Longo").PathFromPatriarch))
+            .ToListAsync();
+-->
+[!code-csharp[LongoAndDescendents](../../../../samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs?name=LongoAndDescendents)]
+
+Then `GetReparentedValue` is used to update the `HierarchyId` for Longo and each descendent, followed by a call to `SaveChangesAsync`:
+
+<!--
+        foreach (var descendent in longoAndDescendents)
+        {
+            descendent.PathFromPatriarch
+                = descendent.PathFromPatriarch.GetReparentedValue(
+                    mungo.PathFromPatriarch, ponto.PathFromPatriarch)!;
+        }
+
+        await context.SaveChangesAsync();
+-->
+[!code-csharp[GetReparentedValue](../../../../samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs?name=GetReparentedValue)]
+
+This results in the following database update:
+
+```sql
+SET NOCOUNT ON;
+UPDATE [Halflings] SET [PathFromPatriarch] = @p0
+OUTPUT 1
+WHERE [Id] = @p1;
+UPDATE [Halflings] SET [PathFromPatriarch] = @p2
+OUTPUT 1
+WHERE [Id] = @p3;
+UPDATE [Halflings] SET [PathFromPatriarch] = @p4
+OUTPUT 1
+WHERE [Id] = @p5;
+```
+
+Using these parameters:
+
+```text
+ @p1='9',
+ @p0='0x7BC0' (Nullable = false) (Size = 2) (DbType = Object),
+ @p3='16',
+ @p2='0x7BD6' (Nullable = false) (Size = 2) (DbType = Object),
+ @p5='23',
+ @p4='0x7BD6B0' (Nullable = false) (Size = 3) (DbType = Object)
+ ```
+
+> [!NOTE]
+> The parameters values for `HierarchyId` properties are sent to the database in their compact, binary format.
+
+Following the update, querying for the descendants of "Mungo" returns "Bungo", "Belba", "Linda", "Bingo", "Bilbo", "Falco", and "Poppy", while querying for the descendants of "Ponto" returns "Longo", "Rosa", "Polo", "Otho", "Posco", "Prisca", "Lotho", "Ponto", "Porto", "Peony", and "Angelica".
+
+## Function mappings
+
+.NET                                             | SQL
+------------------------------------------------ | ---
+hierarchyId.GetAncestor(n)                       | @hierarchyId.GetAncestor(@n)
+hierarchyId.GetDescendant(child)                 | @hierarchyId.GetDescendant(@child, NULL)
+hierarchyId.GetDescendant(child1, child2)        | @hierarchyId.GetDescendant(@child1, @child2)
+hierarchyId.GetLevel()                           | @hierarchyId.GetLevel()
+hierarchyId.GetReparentedValue(oldRoot, newRoot) | @hierarchyId.GetReparentedValue(@oldRoot, @newRoot)
+HierarchyId.GetRoot()                            | hierarchyid::GetRoot()
+hierarchyId.IsDescendantOf(parent)               | @hierarchyId.IsDescendantOf(@parent)
+HierarchyId.Parse(input)                         | hierarchyid::Parse(@input)
+hierarchyId.ToString()                           | @hierarchyId.ToString()
+
+## Additional resources
+
+- [Hierarchical Data in SQL Server](/sql/relational-databases/hierarchical-data-sql-server)
diff --git a/entity-framework/core/providers/sql-server/index.md b/entity-framework/core/providers/sql-server/index.md
new file mode 100644
index 0000000000..56d3210ba0
--- /dev/null
+++ b/entity-framework/core/providers/sql-server/index.md
@@ -0,0 +1,131 @@
+---
+title: Microsoft SQL Server Database Provider - EF Core
+description: Documentation for the database provider that allows Entity Framework Core to be used with Microsoft SQL Server
+author: AndriySvyryd
+ms.date: 11/15/2021
+uid: core/providers/sql-server/index
+---
+# Microsoft SQL Server EF Core Database Provider
+
+This database provider allows Entity Framework Core to be used with Microsoft SQL Server (including Azure SQL and Azure Synapse Analytics). The provider is maintained as part of the [Entity Framework Core Project](https://github.com/dotnet/efcore).
+
+## Install
+
+Install the [Microsoft.EntityFrameworkCore.SqlServer NuGet package](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.SqlServer/).
+
+### [.NET CLI](#tab/dotnet-core-cli)
+
+```dotnetcli
+dotnet add package Microsoft.EntityFrameworkCore.SqlServer
+```
+
+### [Visual Studio](#tab/vs)
+
+```powershell
+Install-Package Microsoft.EntityFrameworkCore.SqlServer
+```
+
+***
+
+## Usage and configuration
+
+Once your project references the nuget package, configure EF for SQL Server as follows:
+
+### [SQL Server (on-premises)](#tab/sqlserver)
+
+```c#
+public class MyContext : DbContext
+{
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder.UseSqlServer("<CONNECTION STRING>");
+    }
+}
+```
+
+When using EF with dependency injection (e.g. ASP.NET), use the following:
+
+```c#
+var builder = WebApplication.CreateBuilder(args);
+builder.Services.AddDbContext<MyContext>(options =>
+    options.UseSqlServer(builder.Configuration.GetConnectionString("MyContext")));
+```
+
+### [Azure SQL](#tab/azure-sql)
+
+```c#
+public class MyContext : DbContext
+{
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder.UseAzureSql("<CONNECTION STRING>");
+    }
+}
+```
+
+When using EF with dependency injection (e.g. ASP.NET), use the following:
+
+```c#
+var builder = WebApplication.CreateBuilder(args);
+builder.Services.AddDbContext<MyContext>(options =>
+    options.UseAzureSql(builder.Configuration.GetConnectionString("MyContext")));
+```
+
+> [!NOTE]
+> <xref:Microsoft.EntityFrameworkCore.SqlServerDbContextOptionsExtensions.UseAzureSql*> was introduced in EF Core 9.0. When using an older version, use <xref:Microsoft.EntityFrameworkCore.SqlServerDbContextOptionsExtensions.UseSqlServer*> instead.
+
+### [Azure Synapse Analytics](#tab/azure-synapse)
+
+```c#
+public class MyContext : DbContext
+{
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder.UseAzureSynapse("<CONNECTION STRING>");
+    }
+}
+```
+
+When using EF with dependency injection (e.g. ASP.NET), use the following:
+
+```c#
+var builder = WebApplication.CreateBuilder(args);
+builder.Services.AddDbContext<MyContext>(options =>
+    options.UseAzureSynapse(builder.Configuration.GetConnectionString("MyContext")));
+```
+
+> [!NOTE]
+> <xref:Microsoft.EntityFrameworkCore.SqlServerDbContextOptionsExtensions.UseAzureSynapse*> was introduced in EF Core 9.0. When using an older version, use <xref:Microsoft.EntityFrameworkCore.SqlServerDbContextOptionsExtensions.UseSqlServer*> instead.
+
+***
+
+The EF SQL Server provider uses [Microsoft.Data.SqlClient](/sql/connect/ado-net/overview-sqlclient-driver) as its underlying ADO.NET provider. For more information on the connection strings accepted by SqlClient, [see this page](/sql/connect/ado-net/connection-string-syntax).
+
+## Compatibility level
+
+You can optionally configure EF with the compatibility level of your database; higher compatibility levels allow for newer features, and configuring EF accordingly makes it use those features. If you do not explicitly configure a compatibility level, a reasonable default will be chosen that may not take advantage of the newest features. As a result, it's recommended to explicitly configure the compatibility level you'd like to have.
+
+Note that this only covers EF's own configuration of the compatibility level - affecting e.g. the SQL it generates - but does not affect the compatibility level configured in your actual database. Databases hosted on newer versions of SQL Server may still be configured with lower compatibility levels, causing them to not support the latest features - so you may need to change the compatibility level in your database as well. For more information on compatibility levels, [see the documentation](/sql/relational-databases/databases/view-or-change-the-compatibility-level-of-a-database).
+
+To configure EF with a compatibility level, use `UseCompatibilityLevel()` as follows:
+
+```c#
+optionsBuilder.UseSqlServer("<CONNECTION STRING>", o => o.UseCompatibilityLevel(170));
+```
+
+## Connection resiliency
+
+EF includes functionality for automatically retrying failed database commands; for more information, [see the documentation](xref:core/miscellaneous/connection-resiliency). When using <xref:Microsoft.EntityFrameworkCore.SqlServerDbContextOptionsExtensions.UseAzureSql*> and <xref:Microsoft.EntityFrameworkCore.SqlServerDbContextOptionsExtensions.UseAzureSynapse*>, connection resiliency is automatically set up with the appropriate settings specific for those databases. Otherwise, when using <xref:Microsoft.EntityFrameworkCore.SqlServerDbContextOptionsExtensions.UseSqlServer*>, configure the provider with <xref:Microsoft.EntityFrameworkCore.Infrastructure.SqlEngineDbContextOptionsBuilder.EnableRetryOnFailure*> as shown in the connection resiliency documentation.
+
+In some cases, <xref:Microsoft.EntityFrameworkCore.SqlServerDbContextOptionsExtensions.UseSqlServer*> may be called in code that you cannot control. Starting with EF 9, to enable connection resiliency in such scenarios, call `ConfigureSqlEngine(c => c.EnableRetryOnFailureByDefault())` beforehand (this is not necessary with <xref:Microsoft.EntityFrameworkCore.SqlServerDbContextOptionsExtensions.UseAzureSql*> and <xref:Microsoft.EntityFrameworkCore.SqlServerDbContextOptionsExtensions.UseAzureSynapse*>).
+
+## Notes and caveats
+
+* The Microsoft.Data.SqlClient package ships more frequently than the EF Core provider. If you would like to take advantage of new features and bug fixes, you can add a direct package reference to the latest version of Microsoft.Data.SqlClient.
+* The EF SQL Server provider uses Microsoft.Data.SqlClient, and not the older System.Data.Client; if your project takes a direct dependency on SqlClient, make sure it references the Microsoft.Data.SqlClient package. For more information on the differences between Microsoft.Data.SqlClient and System.Data.SqlClient, [see this blog post](https://devblogs.microsoft.com/dotnet/introducing-the-new-microsoftdatasqlclient).
+
+## Supported database engines
+
+* Microsoft SQL Server (2019 onwards)
+* Azure SQL Database
+* Azure Synapse Analytics
diff --git a/entity-framework/core/providers/sql-server/indexes.md b/entity-framework/core/providers/sql-server/indexes.md
new file mode 100644
index 0000000000..326de935f1
--- /dev/null
+++ b/entity-framework/core/providers/sql-server/indexes.md
@@ -0,0 +1,39 @@
+---
+title: Microsoft SQL Server Database Provider - Indexes - EF Core
+description: Index features specific to the Entity Framework Core SQL Server provider
+author: roji
+ms.date: 9/1/2020
+uid: core/providers/sql-server/indexes
+---
+# Index features specific to the Entity Framework Core SQL Server provider
+
+This page details index configuration options that are specific to the SQL Server provider.
+
+## Clustering
+
+Clustered indexes sort and store the data rows in the table or view based on their key values. Creating the right clustered index for your table can significantly improve the speed of your queries, as data is already laid out in the optimal order. There can be only one clustered index per table, because the data rows themselves can be stored in only one order. For more information, see [the SQL Server documentation on clustered and non-clustered indexes](/sql/relational-databases/indexes/clustered-and-nonclustered-indexes-described).
+
+By default, the primary key column of a table is implicitly backed by a clustered index, and all other indexes are non-clustered.
+
+You can configure an index or key to be clustered as follows:
+
+[!code-csharp[ClusteredIndex](../../../../samples/core/SqlServer/Indexes/ClusteredIndexContext.cs?name=ClusteredIndex)]
+
+> [!NOTE]
+> SQL Server only supports one clustered index per table, and the primary key is by default clustered. If you'd like to have a clustered index on a non-key column, you must explicitly make your key non-clustered.
+
+## Fill factor
+
+The index fill-factor option is provided for fine-tuning index data storage and performance. For more information, see [the SQL Server documentation on fill factor](/sql/relational-databases/indexes/specify-fill-factor-for-an-index).
+
+You can configure an index's fill factor as follows:
+
+[!code-csharp[IndexFillFactor](../../../../samples/core/SqlServer/Indexes/IndexFillFactorContext.cs?name=IndexFillFactor)]
+
+## Online creation
+
+The ONLINE option allows concurrent user access to the underlying table or clustered index data and any associated nonclustered indexes during index creation, so that users can continue to update and query the underlying data. When you perform data definition language (DDL) operations offline, such as building or rebuilding a clustered index; these operations hold exclusive locks on the underlying data and associated indexes. For more information, see [the SQL Server documentation on the ONLINE index option](/sql/relational-databases/indexes/perform-index-operations-online).
+
+You can configure an index with the ONLINE option as follows:
+
+[!code-csharp[IndexOnline](../../../../samples/core/SqlServer/Indexes/IndexOnlineContext.cs?name=IndexOnline)]
diff --git a/entity-framework/core/providers/sql-server/memory-optimized-tables.md b/entity-framework/core/providers/sql-server/memory-optimized-tables.md
new file mode 100644
index 0000000000..9ca81392d2
--- /dev/null
+++ b/entity-framework/core/providers/sql-server/memory-optimized-tables.md
@@ -0,0 +1,16 @@
+---
+title: Microsoft SQL Server Database Provider - Memory-Optimized Tables - EF Core
+description: How to use Memory-Optimized Tables with the SQL Server Entity Framework Core Database Provider
+author: AndriySvyryd
+ms.date: 11/05/2019
+uid: core/providers/sql-server/memory-optimized-tables
+---
+# Memory-Optimized Tables support in SQL Server EF Core Database Provider
+
+[Memory-Optimized Tables](/sql/relational-databases/in-memory-oltp/memory-optimized-tables) are a feature of SQL Server where the entire table resides in memory. A second copy of the table data is maintained on disk, but only for durability purposes. Data in memory-optimized tables is only read from disk during database recovery. For example, after a server restart.
+
+## Configuring a memory-optimized table
+
+You can specify that the table an entity is mapped to is memory-optimized. When using EF Core to create and maintain a database based on your model (either with [migrations](xref:core/managing-schemas/migrations/index) or [EnsureCreated](/dotnet/api/Microsoft.EntityFrameworkCore.Storage.IDatabaseCreator.EnsureCreated)), a memory-optimized table will be created for these entities.
+
+[!code-csharp[IsMemoryOptimized](../../../../samples/core/SqlServer/InMemory/InMemoryContext.cs?name=IsMemoryOptimized)]
diff --git a/entity-framework/core/providers/sql-server/misc.md b/entity-framework/core/providers/sql-server/misc.md
new file mode 100644
index 0000000000..022c787d1c
--- /dev/null
+++ b/entity-framework/core/providers/sql-server/misc.md
@@ -0,0 +1,78 @@
+---
+title: Miscellaneous - Microsoft SQL Server Database Provider - EF Core
+description: Miscellaneous for the Microsoft SQL Server database provider
+author: roji
+ms.date: 09/20/2022
+uid: core/providers/sql-server/misc
+---
+# Miscellaneous notes for SQL Server
+
+## Azure SQL database options
+
+> [!NOTE]
+> You should [use `UseAzureSql` method](xref:core/providers/sql-server/index#usage) instead of `UseSqlServer` when connecting to Azure SQL.
+
+Azure SQL Database provides [a variety of pricing options](https://azure.microsoft.com/pricing/details/sql-database/single/) that are usually configured through the Azure Portal. However, if you are managing the schema using [EF Core migrations](xref:core/managing-schemas/migrations/index), you can configure the desired options with EF, and they will get applied when EF creates the database.
+
+You can specify the service tier of the database (EDITION) using [HasServiceTier](/dotnet/api/Microsoft.EntityFrameworkCore.SqlServerModelBuilderExtensions.HasServiceTier):
+
+[!code-csharp[HasServiceTier](../../../../samples/core/SqlServer/AzureDatabase/AzureSqlContext.cs?name=HasServiceTier)]
+
+You can specify the maximum size of the database using [HasDatabaseMaxSize](/dotnet/api/Microsoft.EntityFrameworkCore.SqlServerModelBuilderExtensions.HasDatabaseMaxSize):
+
+[!code-csharp[HasDatabaseMaxSize](../../../../samples/core/SqlServer/AzureDatabase/AzureSqlContext.cs?name=HasDatabaseMaxSize)]
+
+You can specify the performance level of the database (SERVICE_OBJECTIVE) using [HasPerformanceLevel](/dotnet/api/Microsoft.EntityFrameworkCore.SqlServerModelBuilderExtensions.HasPerformanceLevel):
+
+[!code-csharp[HasPerformanceLevel](../../../../samples/core/SqlServer/AzureDatabase/AzureSqlContext.cs?name=HasPerformanceLevel)]
+
+Use [HasPerformanceLevelSql](/dotnet/api/Microsoft.EntityFrameworkCore.SqlServerModelBuilderExtensions.HasPerformanceLevelSql) to configure the elastic pool, since the value is not a string literal:
+
+[!code-csharp[HasPerformanceLevel](../../../../samples/core/SqlServer/AzureDatabase/AzureSqlContext.cs?name=HasPerformanceLevelSql)]
+
+> [!TIP]
+> You can find all the supported values in the [ALTER DATABASE documentation](/sql/t-sql/statements/alter-database-transact-sql?view=azuresqldb-current&preserve-view=true).
+
+## SaveChanges, triggers and the OUTPUT clause
+
+When EF Core saves changes to the database, it does so with an optimized technique using the T-SQL [OUTPUT clause](/sql/t-sql/queries/output-clause-transact-sql#remarks). Unfortunately, the OUTPUT clause has some limitations; it notably cannot be used with tables that have triggers, for example.
+
+If you run into a limitation related to the use of the OUTPUT clause, you can disable it on a specific table via <xref:Microsoft.EntityFrameworkCore.SqlServerEntityTypeExtensions.UseSqlOutputClause*>:
+
+```c#
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Blog>()
+        .ToTable(tb => tb.UseSqlOutputClause(false));
+}
+```
+
+Doing this will make EF switch to an older, less efficient technique for updating the table.
+
+If most or all of your tables have triggers, you can configure this for all your model's tables by using the following [model building convention](xref:core/modeling/bulk-configuration#conventions):
+
+```c#
+public class NoOutputClauseConvention : IModelFinalizingConvention
+{
+    public virtual void ProcessModelFinalizing(
+        IConventionModelBuilder modelBuilder,
+        IConventionContext<IConventionModelBuilder> context)
+    {
+        foreach (var entityType in modelBuilder.Metadata.GetEntityTypes())
+        {
+            var table = StoreObjectIdentifier.Create(entityType, StoreObjectType.Table);
+            if (table is not null)
+            {
+                entityType.Builder.UseSqlOutputClause(false);
+            }
+
+            foreach (var fragment in entityType.GetMappingFragments(StoreObjectType.Table))
+            {
+                entityType.Builder.UseSqlOutputClause(false, fragment.StoreObject);
+            }
+        }
+    }
+}
+```
+
+This effectively calls <xref:Microsoft.EntityFrameworkCore.SqlServerEntityTypeExtensions.UseSqlOutputClause*> on all your model's tables, instead of you having to do it manually for each and every table.
diff --git a/entity-framework/core/providers/sql-server/spatial.md b/entity-framework/core/providers/sql-server/spatial.md
new file mode 100644
index 0000000000..99a067f5de
--- /dev/null
+++ b/entity-framework/core/providers/sql-server/spatial.md
@@ -0,0 +1,108 @@
+---
+title: Microsoft SQL Server Database Provider - Spatial Data - EF Core
+description: Using spatial data with the Entity Framework Core Microsoft SQL Server database provider
+author: SamMonoRT
+ms.date: 10/02/2020
+uid: core/providers/sql-server/spatial
+---
+# Spatial Data in the SQL Server EF Core Provider
+
+This page includes additional information about using spatial data with the Microsoft SQL Server database provider. For general information about using spatial data in EF Core, see the main [Spatial Data](xref:core/modeling/spatial) documentation.
+
+## Geography or geometry
+
+By default, spatial properties are mapped to `geography` columns in SQL Server. To use `geometry`, [configure the column type](xref:core/modeling/entity-properties#column-data-types) in your model.
+
+## Geography polygon rings
+
+When using the `geography` column type, SQL Server imposes additional requirements on the exterior ring (or shell) and interior rings (or holes). The exterior ring must be oriented counterclockwise and the interior rings clockwise. [NetTopologySuite](https://nettopologysuite.github.io/NetTopologySuite/) (NTS) validates this before sending values to the database.
+
+## FullGlobe
+
+SQL Server has a non-standard geometry type to represent the full globe when using the `geography` column type. It also has a way to represent polygons based on the full globe (without an exterior ring). Neither of these are supported by NTS.
+
+> [!WARNING]
+> FullGlobe and polygons based on it aren't supported by NTS.
+
+## Curves
+
+As mentioned in the main [Spatial Data](xref:core/modeling/spatial) documentation, NTS currently cannot represent curves. This means that you'll need to transform CircularString, CompoundCurve, and CurePolygon values using the [STCurveToLine](/sql/t-sql/spatial-geography/stcurvetoline-geography-data-type) method before using them in EF Core.
+
+> [!WARNING]
+> CircularString, CompoundCurve, and CurePolygon aren't supported by NTS.
+
+## Spatial function mappings
+
+This table shows which NTS members are translated into which SQL functions. Note that the translations vary depending on whether the column is of type geography or geometry.
+
+.NET                                      | SQL (geography)                                              | SQL (geometry)                                               | Added in
+----------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | --------
+EF.Functions.CurveToLine(geometry)        | @geometry.STCurveToLine()                                    | @geometry.STCurveToLine()                                    | EF Core 7.0
+geometry.Area                             | @geometry.STArea()                                           | @geometry.STArea()
+geometry.AsBinary()                       | @geometry.STAsBinary()                                       | @geometry.STAsBinary()
+geometry.AsText()                         | @geometry.AsTextZM()                                         | @geometry.AsTextZM()
+geometry.Boundary                         |                                                              | @geometry.STBoundary()
+geometry.Buffer(distance)                 | @geometry.STBuffer(@distance)                                | @geometry.STBuffer(@distance)
+geometry.Centroid                         |                                                              | @geometry.STCentroid()
+geometry.Contains(g)                      | @geometry.STContains(@g)                                     | @geometry.STContains(@g)
+geometry.ConvexHull()                     | @geometry.STConvexHull()                                     | @geometry.STConvexHull()
+geometry.Crosses(g)                       |                                                              | @geometry.STCrosses(@g)
+geometry.Difference(other)                | @geometry.STDifference(@other)                               | @geometry.STDifference(@other)
+geometry.Dimension                        | @geometry.STDimension()                                      | @geometry.STDimension()
+geometry.Disjoint(g)                      | @geometry.STDisjoint(@g)                                     | @geometry.STDisjoint(@g)
+geometry.Distance(g)                      | @geometry.STDistance(@g)                                     | @geometry.STDistance(@g)
+geometry.Envelope                         |                                                              | @geometry.STEnvelope()
+geometry.EqualsTopologically(g)           | @geometry.STEquals(@g)                                       | @geometry.STEquals(@g)
+geometry.GeometryType                     | @geometry.STGeometryType()                                   | @geometry.STGeometryType()
+geometry.GetGeometryN(n)                  | @geometry.STGeometryN(@n + 1)                                | @geometry.STGeometryN(@n + 1)
+geometry.InteriorPoint                    |                                                              | @geometry.STPointOnSurface()
+geometry.Intersection(other)              | @geometry.STIntersection(@other)                             | @geometry.STIntersection(@other)
+geometry.Intersects(g)                    | @geometry.STIntersects(@g)                                   | @geometry.STIntersects(@g)
+geometry.IsEmpty                          | @geometry.STIsEmpty()                                        | @geometry.STIsEmpty()
+geometry.IsSimple                         |                                                              | @geometry.STIsSimple()
+geometry.IsValid                          | @geometry.STIsValid()                                        | @geometry.STIsValid()
+geometry.IsWithinDistance(geom, distance) | @geometry.STDistance(@geom) <= @distance                     | @geometry.STDistance(@geom) <= @distance
+geometry.Length                           | @geometry.STLength()                                         | @geometry.STLength()
+geometry.NumGeometries                    | @geometry.STNumGeometries()                                  | @geometry.STNumGeometries()
+geometry.NumPoints                        | @geometry.STNumPoints()                                      | @geometry.STNumPoints()
+geometry.OgcGeometryType                  | CASE @geometry.STGeometryType() WHEN N'Point' THEN 1 ... END | CASE @geometry.STGeometryType() WHEN N'Point' THEN 1 ... END
+geometry.Overlaps(g)                      | @geometry.STOverlaps(@g)                                     | @geometry.STOverlaps(@g)
+geometry.PointOnSurface                   |                                                              | @geometry.STPointOnSurface()
+geometry.Relate(g, intersectionPattern)   |                                                              | @geometry.STRelate(@g, @intersectionPattern)
+geometry.SRID                             | @geometry.STSrid                                             | @geometry.STSrid
+geometry.SymmetricDifference(other)       | @geometry.STSymDifference(@other)                            | @geometry.STSymDifference(@other)
+geometry.ToBinary()                       | @geometry.STAsBinary()                                       | @geometry.STAsBinary()
+geometry.ToText()                         | @geometry.AsTextZM()                                         | @geometry.AsTextZM()
+geometry.Touches(g)                       |                                                              | @geometry.STTouches(@g)
+geometry.Union(other)                     | @geometry.STUnion(@other)                                    | @geometry.STUnion(@other)
+geometry.Within(g)                        | @geometry.STWithin(@g)                                       | @geometry.STWithin(@g)
+geometryCollection[i]                     | @geometryCollection.STGeometryN(@i + 1)                      | @geometryCollection.STGeometryN(@i + 1)
+geometryCollection.Count                  | @geometryCollection.STNumGeometries()                        | @geometryCollection.STNumGeometries()
+lineString.Count                          | @lineString.STNumPoints()                                    | @lineString.STNumPoints()
+lineString.EndPoint                       | @lineString.STEndPoint()                                     | @lineString.STEndPoint()
+lineString.GetPointN(n)                   | @lineString.STPointN(@n + 1)                                 | @lineString.STPointN(@n + 1)
+lineString.IsClosed                       | @lineString.STIsClosed()                                     | @lineString.STIsClosed()
+lineString.IsRing                         |                                                              | @lineString.IsRing()
+lineString.StartPoint                     | @lineString.STStartPoint()                                   | @lineString.STStartPoint()
+multiLineString.IsClosed                  | @multiLineString.STIsClosed()                                | @multiLineString.STIsClosed()
+point.M                                   | @point.M                                                     | @point.M
+point.X                                   | @point.Long                                                  | @point.STX
+point.Y                                   | @point.Lat                                                   | @point.STY
+point.Z                                   | @point.Z                                                     | @point.Z
+polygon.ExteriorRing                      | @polygon.RingN(1)                                            | @polygon.STExteriorRing()
+polygon.GetInteriorRingN(n)               | @polygon.RingN(@n + 2)                                       | @polygon.STInteriorRingN(@n + 1)
+polygon.NumInteriorRings                  | @polygon.NumRings() - 1                                      | @polygon.STNumInteriorRing()
+
+### Aggregate functions
+
+.NET                                                              | SQL                           | Added in
+----------------------------------------------------------------- | ----------------------------- | --------
+GeometryCombiner.Combine(group.Select(x => x.Property))           | CollectionAggregate(Property) | EF Core 7.0
+ConvexHull.Create(group.Select(x => x.Property))                  | ConvexHullAggregate(Property) | EF Core 7.0
+UnaryUnionOp.Union(group.Select(x => x.Property))                 | UnionAggregate(Property)      | EF Core 7.0
+EnvelopeCombiner.CombineAsGeometry(group.Select(x => x.Property)) | EnvelopeAggregate(Property)   | EF Core 7.0
+
+## Additional resources
+
+* [Spatial Data in SQL Server](/sql/relational-databases/spatial/spatial-data-sql-server)
+* [NetTopologySuite Docs](https://nettopologysuite.github.io/NetTopologySuite/)
diff --git a/entity-framework/core/providers/sql-server/temporal-tables.md b/entity-framework/core/providers/sql-server/temporal-tables.md
new file mode 100644
index 0000000000..118ccfe778
--- /dev/null
+++ b/entity-framework/core/providers/sql-server/temporal-tables.md
@@ -0,0 +1,282 @@
+---
+title: Microsoft SQL Server Database Provider - Temporal Tables - EF Core
+description: Using SQL Server/Azure SQL temporal tables (aka system-versioned tables) with EF Core
+author: SamMonoRT
+ms.date: 02/11/2023
+uid: core/providers/sql-server/temporal-tables
+---
+
+# SQL Server/Azure SQL temporal tables
+
+[SQL Server temporal tables](/sql/relational-databases/tables/temporal-tables) automatically keep track of all data ever stored in a table, even after that data has been updated or deleted. This is achieved by creating a parallel "history table" into which timestamped historical data is stored whenever a change is made to the main table. This allows historical data to be queried, such as for auditing, or restored, such as for recovery after accidental mutation or deletion.
+
+EF Core supports:
+
+* The creation of temporal tables using [EF Core Migrations](xref:core/managing-schemas/migrations/index)
+* Transformation of existing tables into temporal tables, again using Migrations
+* Querying historical data
+* Restoring data from some point in the past
+
+## Configuring a temporal table
+
+The model builder can be used to configure a table as temporal. For example:
+
+<!--
+modelBuilder
+    .Entity<Employee>()
+    .ToTable("Employees", b => b.IsTemporal());
+-->
+[!code-csharp[SimpleConfig](../../../../samples/core/Miscellaneous/NewInEFCore6/TemporalTablesSample.cs?name=SimpleConfig)]
+
+> [!TIP]
+> The code shown here comes from [TemporalTablesSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore6/TemporalTablesSample.cs).
+
+When using EF Core to create the database, the new table is configured as a temporal table with the SQL Server defaults for the timestamps and history table. For example, consider an `Employee` entity type:
+
+<!--
+    public class Employee
+    {
+        public Guid EmployeeId { get; set; }
+        public string Name { get; set; }
+        public string Position { get; set; }
+        public string Department { get; set; }
+        public string Address { get; set; }
+        public decimal AnnualSalary { get; set; }
+    }
+-->
+[!code-csharp[Employee](../../../../samples/core/Miscellaneous/NewInEFCore6/TemporalTablesSample.cs?name=Employee)]
+
+The temporal table created looks like this:
+
+```sql
+DECLARE @historyTableSchema sysname = SCHEMA_NAME()
+EXEC(N'CREATE TABLE [Employees] (
+    [EmployeeId] uniqueidentifier NOT NULL,
+    [Name] nvarchar(100) NULL,
+    [Position] nvarchar(100) NULL,
+    [Department] nvarchar(100) NULL,
+    [Address] nvarchar(1024) NULL,
+    [AnnualSalary] decimal(10,2) NOT NULL,
+    [PeriodEnd] datetime2 GENERATED ALWAYS AS ROW END NOT NULL,
+    [PeriodStart] datetime2 GENERATED ALWAYS AS ROW START NOT NULL,
+    CONSTRAINT [PK_Employees] PRIMARY KEY ([EmployeeId]),
+    PERIOD FOR SYSTEM_TIME([PeriodStart], [PeriodEnd])
+) WITH (SYSTEM_VERSIONING = ON (HISTORY_TABLE = [' + @historyTableSchema + N'].[EmployeeHistory]))');
+```
+
+Notice that SQL Server creates two hidden `datetime2` columns called `PeriodEnd` and `PeriodStart`. These "period columns" represent the time range during which the data in the row existed. These columns are mapped to [shadow properties](xref:core/modeling/shadow-properties) in the EF Core model, allowing them to be used in queries as shown later.
+
+> [!IMPORTANT]
+> The times in these columns are always UTC time generated by SQL Server. UTC times are used for all operations involving temporal tables, such as in the queries shown below.
+
+Notice also that an associated history table called `EmployeeHistory` is created automatically. The names of the period columns and history table can be changed with additional configuration to the model builder. For example:
+
+<!--
+modelBuilder
+    .Entity<Employee>()
+    .ToTable(
+        "Employees",
+        b => b.IsTemporal(
+            b =>
+            {
+                b.HasPeriodStart("ValidFrom");
+                b.HasPeriodEnd("ValidTo");
+                b.UseHistoryTable("EmployeeHistoricalData");
+            }));
+-->
+[!code-csharp[AdvancedConfig](../../../../samples/core/Miscellaneous/NewInEFCore6/TemporalTablesSample.cs?name=AdvancedConfig)]
+
+This is reflected in the table created by SQL Server:
+
+```sql
+DECLARE @historyTableSchema sysname = SCHEMA_NAME()
+EXEC(N'CREATE TABLE [Employees] (
+    [EmployeeId] uniqueidentifier NOT NULL,
+    [Name] nvarchar(100) NULL,
+    [Position] nvarchar(100) NULL,
+    [Department] nvarchar(100) NULL,
+    [Address] nvarchar(1024) NULL,
+    [AnnualSalary] decimal(10,2) NOT NULL,
+    [ValidFrom] datetime2 GENERATED ALWAYS AS ROW START NOT NULL,
+    [ValidTo] datetime2 GENERATED ALWAYS AS ROW END NOT NULL,
+    CONSTRAINT [PK_Employees] PRIMARY KEY ([EmployeeId]),
+    PERIOD FOR SYSTEM_TIME([ValidFrom], [ValidTo])
+) WITH (SYSTEM_VERSIONING = ON (HISTORY_TABLE = [' + @historyTableSchema + N'].[EmployeeHistoricalData]))');
+```
+
+## Using temporal tables
+
+Most of the time, temporal tables are used just like any other table. That is, the period columns and historical data are handled transparently by SQL Server such that the application can ignore them. For example, new entities can be saved to the database in the normal way:
+
+<!--
+context.AddRange(
+    new Employee
+    {
+        Name = "Pinky Pie",
+        Address = "Sugarcube Corner, Ponyville, Equestria",
+        Department = "DevDiv",
+        Position = "Party Organizer",
+        AnnualSalary = 100.0m
+    },
+    new Employee
+    {
+        Name = "Rainbow Dash",
+        Address = "Cloudominium, Ponyville, Equestria",
+        Department = "DevDiv",
+        Position = "Ponyville weather patrol",
+        AnnualSalary = 900.0m
+    },
+    new Employee
+    {
+        Name = "Fluttershy",
+        Address = "Everfree Forest, Equestria",
+        Department = "DevDiv",
+        Position = "Animal caretaker",
+        AnnualSalary = 30.0m
+    });
+
+context.SaveChanges();
+-->
+[!code-csharp[InsertData](../../../../samples/core/Miscellaneous/NewInEFCore6/TemporalTablesSample.cs?name=InsertData)]
+
+This data can then be queried, updated, and deleted in the normal way. For example:
+
+<!--
+var employee = context.Employees.Single(e => e.Name == "Rainbow Dash");
+context.Remove(employee);
+context.SaveChanges();
+-->
+[!code-csharp[NormalQuery](../../../../samples/core/Miscellaneous/NewInEFCore6/TemporalTablesSample.cs?name=NormalQuery)]
+
+Also, after a normal [tracking query](xref:core/querying/tracking#no-tracking-queries), the values from the period columns of the current data can be [accessed from the tracked entities](xref:core/change-tracking/entity-entries). For example:
+
+<!--
+var employees = context.Employees.ToList();
+foreach (var employee in employees)
+{
+    var employeeEntry = context.Entry(employee);
+    var validFrom = employeeEntry.Property<DateTime>("ValidFrom").CurrentValue;
+    var validTo = employeeEntry.Property<DateTime>("ValidTo").CurrentValue;
+
+    Console.WriteLine($"  Employee {employee.Name} valid from {validFrom} to {validTo}");
+}
+-->
+[!code-csharp[TrackingQuery](../../../../samples/core/Miscellaneous/NewInEFCore6/TemporalTablesSample.cs?name=TrackingQuery)]
+
+This prints:
+
+```none
+Starting data:
+  Employee Pinky Pie valid from 8/26/2021 4:38:58 PM to 12/31/9999 11:59:59 PM
+  Employee Rainbow Dash valid from 8/26/2021 4:38:58 PM to 12/31/9999 11:59:59 PM
+  Employee Fluttershy valid from 8/26/2021 4:38:58 PM to 12/31/9999 11:59:59 PM
+```
+
+Notice that the `ValidTo` column (by default called `PeriodEnd`) contains the `datetime2` max value. This is always the case for the current rows in the table. The `ValidFrom` columns (by default called `PeriodStart`) contains the UTC time that the row was inserted.
+
+## Querying historical data
+
+EF Core supports queries that include historical data through several specialized query operators:
+
+* `TemporalAsOf`: Returns rows that were active (current) at the given UTC time. This is a single row from the current table or history table for a given primary key.
+* `TemporalAll`: Returns all rows in the historical data. This is typically many rows from the history table and/or the current table for a given primary key.
+* `TemporalFromTo`: Returns all rows that were active between two given UTC times. This may be many rows from the history table and/or the current table for a given primary key.
+* `TemporalBetween`: The same as `TemporalFromTo`, except that rows are included that became active on the upper boundary.
+* `TemporalContainedIn`: Returns all rows that started being active and ended being active between two given UTC times. This may be many rows from the history table and/or the current table for a given primary key.
+
+> [!NOTE]
+> See the [SQL Server temporal tables documentation](/sql/relational-databases/tables/temporal-tables#how-do-i-query-temporal-data) for more information on exactly which rows are included for each of these operators.
+
+For example, after making some updates and deletes to our data, we can run a query using `TemporalAll` to see the historical data:
+
+<!--
+var history = context
+    .Employees
+    .TemporalAll()
+    .Where(e => e.Name == "Rainbow Dash")
+    .OrderBy(e => EF.Property<DateTime>(e, "ValidFrom"))
+    .Select(
+        e => new
+        {
+            Employee = e,
+            ValidFrom = EF.Property<DateTime>(e, "ValidFrom"),
+            ValidTo = EF.Property<DateTime>(e, "ValidTo")
+        })
+    .ToList();
+
+foreach (var pointInTime in history)
+{
+    Console.WriteLine(
+        $"  Employee {pointInTime.Employee.Name} was '{pointInTime.Employee.Position}' from {pointInTime.ValidFrom} to {pointInTime.ValidTo}");
+}
+-->
+[!code-csharp[TemporalAll](../../../../samples/core/Miscellaneous/NewInEFCore6/TemporalTablesSample.cs?name=TemporalAll)]
+
+Notice how the [EF.Property method](xref:core/modeling/shadow-properties#accessing-shadow-properties) can be used to access values from the period columns. This is used in the `OrderBy` clause to sort the data, and then in a projection to include these values in the returned data.
+
+This query brings back the following data:
+
+```none
+Historical data for Rainbow Dash:
+  Employee Rainbow Dash was 'Ponyville weather patrol' from 8/26/2021 4:38:58 PM to 8/26/2021 4:40:29 PM
+  Employee Rainbow Dash was 'Wonderbolt Trainee' from 8/26/2021 4:40:29 PM to 8/26/2021 4:41:59 PM
+  Employee Rainbow Dash was 'Wonderbolt Reservist' from 8/26/2021 4:41:59 PM to 8/26/2021 4:43:29 PM
+  Employee Rainbow Dash was 'Wonderbolt' from 8/26/2021 4:43:29 PM to 8/26/2021 4:44:59 PM
+```
+
+Notice that the last row returned stopped being active at 8/26/2021 4:44:59 PM. This is because the row for Rainbow Dash was deleted from the main table at that time. We will see later how this data can be restored.
+
+Similar queries can be written using `TemporalFromTo`, `TemporalBetween`, or `TemporalContainedIn`. For example:
+
+<!--
+var history = context
+    .Employees
+    .TemporalBetween(timeStamp2, timeStamp3)
+    .Where(e => e.Name == "Rainbow Dash")
+    .OrderBy(e => EF.Property<DateTime>(e, "ValidFrom"))
+    .Select(
+        e => new
+        {
+            Employee = e,
+            ValidFrom = EF.Property<DateTime>(e, "ValidFrom"),
+            ValidTo = EF.Property<DateTime>(e, "ValidTo")
+        })
+    .ToList();
+-->
+[!code-csharp[TemporalBetween](../../../../samples/core/Miscellaneous/NewInEFCore6/TemporalTablesSample.cs?name=TemporalBetween)]
+
+This query returns the following rows:
+
+```none
+Historical data for Rainbow Dash between 8/26/2021 4:41:14 PM and 8/26/2021 4:42:44 PM:
+  Employee Rainbow Dash was 'Wonderbolt Trainee' from 8/26/2021 4:40:29 PM to 8/26/2021 4:41:59 PM
+  Employee Rainbow Dash was 'Wonderbolt Reservist' from 8/26/2021 4:41:59 PM to 8/26/2021 4:43:29 PM
+```
+
+## Restoring historical data
+
+As mentioned above, Rainbow Dash was deleted from the `Employees` table. This was clearly a mistake, so let's go back to a point-in-time and restore the missing row from that time.
+
+<!--
+var employee = context
+    .Employees
+    .TemporalAsOf(timeStamp2)
+    .Single(e => e.Name == "Rainbow Dash");
+
+context.Add(employee);
+context.SaveChanges();
+-->
+[!code-csharp[RestoreData](../../../../samples/core/Miscellaneous/NewInEFCore6/TemporalTablesSample.cs?name=RestoreData)]
+
+This query returns a single row for Rainbow Dash as it was at the given UTC time. All queries using temporal operators are no-tracking by default, so the returned entity here is not tracked. This makes sense, because it does not currently exist in the main table. To re-insert the entity into the main table, we simply mark it as `Added` and then call `SaveChanges`.
+
+After re-inserting the row Rainbow Dash, querying the historical data shows that the row was restored as it was at the given UTC time:
+
+```none
+Historical data for Rainbow Dash:
+  Employee Rainbow Dash was 'Ponyville weather patrol' from 8/26/2021 4:38:58 PM to 8/26/2021 4:40:29 PM
+  Employee Rainbow Dash was 'Wonderbolt Trainee' from 8/26/2021 4:40:29 PM to 8/26/2021 4:41:59 PM
+  Employee Rainbow Dash was 'Wonderbolt Reservist' from 8/26/2021 4:41:59 PM to 8/26/2021 4:43:29 PM
+  Employee Rainbow Dash was 'Wonderbolt' from 8/26/2021 4:43:29 PM to 8/26/2021 4:44:59 PM
+  Employee Rainbow Dash was 'Wonderbolt Trainee' from 8/26/2021 4:44:59 PM to 12/31/9999 11:59:59 PM
+```
diff --git a/entity-framework/core/providers/sql-server/value-generation.md b/entity-framework/core/providers/sql-server/value-generation.md
new file mode 100644
index 0000000000..e564e736d0
--- /dev/null
+++ b/entity-framework/core/providers/sql-server/value-generation.md
@@ -0,0 +1,81 @@
+---
+title: Microsoft SQL Server Database Provider - Value Generation - EF Core
+description: Value Generation Patterns Specific to the SQL Server Entity Framework Core Database Provider
+author: roji
+ms.date: 11/15/2021
+uid: core/providers/sql-server/value-generation
+---
+# SQL Server Value Generation
+
+This page details value generation configuration  and patterns that are specific to the SQL Server provider. It's recommended to first read [the general page on value generation](xref:core/modeling/generated-properties).
+
+## IDENTITY columns
+
+By convention, numeric columns that are configured to have their values generated on add are set up as [SQL Server IDENTITY columns](/sql/t-sql/statements/create-table-transact-sql-identity-property).
+
+### Seed and increment
+
+By default, IDENTITY columns start off at 1 (the seed), and increment by 1 each time a row is added (the increment). You can configure a different seed and increment as follows:
+
+[!code-csharp[Main](../../../../samples/core/SqlServer/ValueGeneration/IdentityOptionsContext.cs?name=IdentityOptions&highlight=5)]
+
+### Inserting explicit values into IDENTITY columns
+
+By default, SQL Server doesn't allow inserting explicit values into IDENTITY columns. To do so, you must manually enable `IDENTITY_INSERT` before calling `SaveChangesAsync()`, as follows:
+
+[!code-csharp[Main](../../../../samples/core/SqlServer/ValueGeneration/ExplicitIdentityValues.cs?name=ExplicitIdentityValues)]
+
+> [!NOTE]
+> We have a [feature request](https://github.com/aspnet/EntityFramework/issues/703) on our backlog to do this automatically within the SQL Server provider.
+
+## Sequences
+
+As an alternative to IDENTITY columns, you can use standard sequences. This can be useful in various scenarios; for example, you may want to have multiple columns drawing their default values from a single sequence.
+
+SQL Server allows you to create sequences and use them as detailed in [the general page on sequences](xref:core/modeling/sequences). It's up to you to configure your properties to use sequences via `HasDefaultValueSql()`.
+
+## GUIDs
+
+For GUID primary keys, the provider automatically generates optimal sequential values, similar to SQL Server's [NEWSEQUENTIALID](/sql/t-sql/functions/newsequentialid-transact-sql) function. Generating the value on the client is more efficient in some scenarios, i.e. an extra database round trip isn't needed to get the database-generated value, when a dependent is also being inserted that references that key.
+
+To have EF generate the same sequential GUID values for non-key properties, configure them as follows:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Blog>().Property(b => b.Guid).HasValueGenerator(typeof(SequentialGuidValueGenerator));
+}
+```
+
+## Rowversions
+
+SQL Server has the [`rowversion`](/sql/t-sql/data-types/rowversion-transact-sql) data type, which automatically changes whenever the row is updated. This makes it very useful as a concurrency token, for managing cases where the same row is simultaneously updated by multiple transactions.
+
+To fully understand concurrency tokens and how to use them, read the dedicated page on [concurrency conflicts](xref:core/saving/concurrency). To map a `byte[]` property to a `rowversion` column, configure it as follows:
+
+### [Data Annotations](#tab/data-annotations)
+
+```c#
+public class Person
+{
+    public int PersonId { get; set; }
+    public string FirstName { get; set; }
+    public string LastName { get; set; }
+
+    [Timestamp]
+    public byte[] Version { get; set; }
+}
+```
+
+### [Fluent API](#tab/fluent-api)
+
+```c#
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Person>()
+        .Property(p => p.Version)
+        .IsRowVersion();
+}
+```
+
+***
diff --git a/entity-framework/core/providers/sql-server/vector-search.md b/entity-framework/core/providers/sql-server/vector-search.md
new file mode 100644
index 0000000000..77f510c409
--- /dev/null
+++ b/entity-framework/core/providers/sql-server/vector-search.md
@@ -0,0 +1,222 @@
+---
+title: Microsoft SQL Server Database Provider - Vector Search - EF Core
+description: Using vectors and embeddings to perform similarity search with the Entity Framework Core Microsoft SQL Server database provider
+author: roji
+ms.date: 08/17/2025
+uid: core/providers/sql-server/vector-search
+---
+# Vector search in the SQL Server EF Core Provider
+
+> [!NOTE]
+> Vector support was introduced in EF Core 10.0, and is only supported with SQL Server 2025 and above.
+
+The SQL Server vector data type allows storing *embeddings*, which are representations of meaning that can be efficiently searched over for similarity, powering AI workloads such as semantic search and retrieval-augmented generation (RAG).
+
+## Setting up vector properties
+
+To use the `vector` data type, simply add a .NET property of type `SqlVector<float>` to your entity type, specifying the dimensions as follows:
+
+### [Data Annotations](#tab/data-annotations)
+
+```c#
+public class Blog
+{
+    // ...
+
+    [Column(TypeName = "vector(1536)")]
+    public SqlVector<float> Embedding { get; set; }
+}
+```
+
+### [Fluent API](#tab/fluent-api)
+
+```c#
+public class Blog
+{
+    // ...
+
+    public SqlVector<float> Embedding { get; set; }
+}
+
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Blog>()
+        .Property(b => b.Embedding)
+        .HasColumnType("vector(1536)");
+}
+```
+
+***
+
+Once your property is added and the corresponding column created in the database, you can start inserting embeddings. Embedding generation is done outside of the database, usually via a service, and the details for doing this are out of scope for this documentation. However, [the .NET Microsoft.Extensions.AI library](/dotnet/ai/microsoft-extensions-ai) contains [`IEmbeddingGenerator`](/dotnet/ai/microsoft-extensions-ai#create-embeddings), which is an abstraction over embedding generators that has implementations for the major providers.
+
+Once you've chosen your embedding generator and set it up, use it to generate embeddings and insert them as follows:
+
+```c#
+IEmbeddingGenerator<string, Embedding<float>> embeddingGenerator = /* Set up your preferred embedding generator */;
+
+var embedding = await embeddingGenerator.GenerateVectorAsync("Some text to be vectorized");
+context.Blogs.Add(new Blog
+{
+    Name = "Some blog",
+    Embedding = new SqlVector<float>(embedding)
+});
+await context.SaveChangesAsync();
+```
+
+Once you have embeddings saved to your database, you're ready to perform vector similarity search over them.
+
+> [!NOTE]
+> Starting with EF Core 11, vector properties are not loaded by default when querying entities, since vectors are typically large and are rarely needed to be read back. Prior to EF Core 11, vector properties were always loaded like any other property.
+
+## Exact search with VECTOR_DISTANCE()
+
+The [`EF.Functions.VectorDistance()`](/sql/t-sql/functions/vector-distance-transact-sql) function computes the *exact* distance between two vectors. Use it to perform similarity search for a given user query:
+
+```c#
+var sqlVector = new SqlVector<float>(await embeddingGenerator.GenerateVectorAsync("Some user query to be vectorized"));
+var topSimilarBlogs = await context.Blogs
+    .OrderBy(b => EF.Functions.VectorDistance("cosine", b.Embedding, sqlVector))
+    .Take(3)
+    .ToListAsync();
+```
+
+This function computes the distance between the query vector and every row in the table, then returns the closest matches. While this provides perfectly accurate results, it can be slow for large datasets because SQL Server must scan all rows and compute distances for each one.
+
+> [!NOTE]
+> The built-in support in EF 10 replaces the previous [EFCore.SqlServer.VectorSearch](https://github.com/efcore/EFCore.SqlServer.VectorSearch) extension, which allowed performing vector search before the `vector` data type was introduced. As part of upgrading to EF 10, remove the extension from your projects.
+
+## Approximate search with VECTOR_SEARCH()
+
+> [!WARNING]
+> `VECTOR_SEARCH()` and vector indexes are currently experimental features in SQL Server and are subject to change. The APIs in EF Core for these features are also subject to change.
+
+For large datasets, computing exact distances for every row can be prohibitively slow. SQL Server 2025 introduces support for *approximate* search through a [vector index](/sql/t-sql/statements/create-vector-index-transact-sql), which provides much better performance at the expense of returning items that are approximately similar - rather than exactly similar - to the query.
+
+### Vector indexes
+
+To use `VECTOR_SEARCH()`, you must create a vector index on your vector column. Use the `HasVectorIndex()` method in your model configuration:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Blog>()
+        .HasVectorIndex(b => b.Embedding, "cosine");
+}
+```
+
+This will generate the following SQL migration:
+
+```sql
+CREATE VECTOR INDEX [IX_Blogs_Embedding]
+    ON [Blogs] ([Embedding])
+    WITH (METRIC = COSINE)
+```
+
+The following distance metrics are supported for vector indexes:
+
+Metric      | Description
+----------- | -----------
+`cosine`    | Cosine similarity (angular distance)
+`euclidean` | Euclidean distance (L2 norm)
+`dot`       | Dot product (negative inner product)
+
+Choose the metric that best matches your embedding model and use case. Cosine similarity is commonly used for text embeddings, while euclidean distance is often used for image embeddings.
+
+### Searching with VECTOR_SEARCH()
+
+Once you have a vector index, use the `VectorSearch()` extension method on your `DbSet`:
+
+```csharp
+var blogs = await context.Blogs
+    .VectorSearch(b => b.Embedding, embedding, "cosine", topN: 5)
+    .ToListAsync();
+
+foreach (var (blog, score) in blogs)
+{
+    Console.WriteLine($"Blog {blog.Id} with score {score}");
+}
+```
+
+This translates to the following SQL:
+
+```sql
+SELECT [v].[Id], [v].[Name], [v].[Distance]
+FROM VECTOR_SEARCH([Blogs], 'Embedding', @__embedding, 'metric = cosine', @__topN)
+```
+
+The `topN` parameter specifies the maximum number of results to return.
+
+`VectorSearch()` returns `VectorSearchResult<TEntity>`, which allows you to access both the entity and the computed distance:
+
+```csharp
+var searchResults = await context.Blogs
+    .VectorSearch(b => b.Embedding, embedding, "cosine", topN: 5)
+    .Where(r => r.Distance < 0.05)
+    .Select(r => new { Blog = r.Value, Distance = r.Distance })
+    .ToListAsync();
+```
+
+This allows you to filter on the similarity score, present it to users, etc.
+
+## Hybrid search
+
+*Hybrid search* combines vector similarity search with traditional [full-text search](xref:core/providers/sql-server/full-text-search) to deliver more relevant results. Vector search excels at finding semantically similar content, while full-text search is better at exact keyword matching. By combining both approaches and using Reciprocal Rank Fusion (RRF) to merge the results, you can build more intelligent search experiences.
+
+The following example shows how to implement hybrid search using EF Core, combining `FreeTextTable()` and `VectorSearch()` in a single query:
+
+```csharp
+var k = 20;
+string textualQuery = ...;
+SqlVector<float> queryEmbedding = ...;
+
+var results = await context.Articles
+    // Perform full-text search
+    .FreeTextTable<Article, int>(textualQuery, topN: k)
+    // Perform vector (semantic) search, joining the results of both searches together
+    .LeftJoin(
+        context.Articles.VectorSearch(b => b.Embedding, queryEmbedding, "cosine", topN: k),
+        fts => fts.Key,
+        vs => vs.Value.Id,
+        (fts, vs) => new
+        {
+            Article = vs.Value,
+            FullTextRank = fts.Rank,
+            VectorDistance = (double?)vs.Distance
+        })
+    // Apply Reciprocal Rank Fusion (RRF) to combine the results
+    .Select(x => new
+    {
+        x.Article,
+        RrfScore = (1.0 / (k + x.FullTextRank)) + (1.0 / (k + x.VectorDistance) ?? 0.0)
+    })
+    .OrderByDescending(x => x.RrfScore)
+    .Take(10)
+    .Select(x => x.Article)
+    .ToListAsync();
+```
+
+This query:
+
+1. Performs a full-text search on `Article`
+2. Performs a vector search on `Article` and combines the results to the full-text search results via a LEFT JOIN
+3. Calculates the RRF score by combining both the full text and the semantic ranking
+4. Orders by RRF score, takes the desired number of results and projects out the original `Article` entities.
+
+> [!NOTE]
+> Rather than using a LEFT JOIN, a FULL OUTER JOIN would be more suitable for this scenario; this would allow highly-ranking results from either search side to be included in the final result, even if that result does not appear at all on the other side. With the above LEFT JOIN approach, if a result has a very high vector similarity score, it never gets included in the final result if that result doesn't also have a high full-text score. However, EF doesn't currently support FULL OUTER JOIN; upvote [#37633](https://github.com/dotnet/efcore/issues/37633) if this is something you'd like to see supported.
+
+The query produces the following SQL:
+
+```sql
+SELECT TOP(@p3) [a0].[Id], [a0].[Content], [a0].[Title]
+FROM FREETEXTTABLE([Articles], *, @p, @p1) AS [f]
+LEFT JOIN VECTOR_SEARCH(
+    TABLE = [Articles] AS [a0],
+    COLUMN = [Embedding],
+    SIMILAR_TO = @p2,
+    METRIC = 'cosine',
+    TOP_N = @p3
+) AS [v] ON [f].[KEY] = [a0].[Id]
+ORDER BY 1.0E0 / CAST(10 + [f].[RANK] AS float) + ISNULL(1.0E0 / (10.0E0 + [v].[Distance]), 0.0E0) DESC
+```
diff --git a/entity-framework/core/providers/sqlite/functions.md b/entity-framework/core/providers/sqlite/functions.md
new file mode 100644
index 0000000000..bcc0c1e3a4
--- /dev/null
+++ b/entity-framework/core/providers/sqlite/functions.md
@@ -0,0 +1,208 @@
+---
+title: Function Mappings - SQLite Database Provider - EF Core
+description: Function Mappings of the SQLite EF Core database provider
+author: SamMonoRT
+ms.date: 7/26/2023
+uid: core/providers/sqlite/functions
+---
+# Function Mappings of the SQLite EF Core Provider
+
+This page shows which .NET members are translated into which SQL functions when using the SQLite provider.
+
+## Aggregate functions
+
+.NET                                                  | SQL                                | Added in
+----------------------------------------------------- | ---------------------------------- | --------
+group.Average(x => x.Property)                        | AVG(Property)
+group.Average(x => x.DecimalProperty)                 | ef_avg(DecimalProperty)            | EF Core 9.0
+group.Count()                                         | COUNT(*)
+group.LongCount()                                     | COUNT(*)
+group.Max(x => x.Property)                            | MAX(Property)
+group.Min(x => x.Property)                            | MIN(Property)
+group.Sum(x => x.Property)                            | SUM(Property)
+group.Sum(x => x.DecimalProperty)                     | ef_sum(DecimalProperty)            | EF Core 9.0
+string.Concat(group.Select(x => x.Property))          | group_concat(Property, '')
+string.Join(separator, group.Select(x => x.Property)) | group_concat(Property, @separator)
+
+## Binary functions
+
+.NET                                           | SQL                                  | Added in
+---------------------------------------------- | ------------------------------------ | --------
+bytes.Contains(value)                          | instr(@bytes, char(@value)) > 0
+bytes.Length                                   | length(@bytes)
+bytes.SequenceEqual(second)                    | @bytes = @second
+EF.Functions.Hex(bytes)                        | hex(@bytes)
+EF.Functions.Substr(bytes, startIndex)         | substr(@bytes, @startIndex)
+EF.Functions.Substr(bytes, startIndex, length) | substr(@bytes, @startIndex, @length)
+EF.Functions.Unhex(value)                      | unhex(@value)
+EF.Functions.Unhex(value, ignoreChars)         | unhex(@value, @ignoreChars)
+
+## Conversion functions
+
+.NET                      | SQL
+------------------------- | ---
+boolValue.ToString()      | CAST(@boolValue AS TEXT)
+byteValue.ToString()      | CAST(@byteValue AS TEXT)
+bytes.ToString()          | CAST(@bytes AS TEXT)
+charValue.ToString()      | CAST(@charValue AS TEXT)
+dateTime.ToString()       | CAST(@dateTime AS TEXT)
+dateTimeOffset.ToString() | CAST(@dateTimeOffset AS TEXT)
+decimalValue.ToString()   | CAST(@decimalValue AS TEXT)
+doubleValue.ToString()    | CAST(@doubleValue AS TEXT)
+floatValue.ToString()     | CAST(@floatValue AS TEXT)
+guid.ToString()           | CAST(@guid AS TEXT)
+intValue.ToString()       | CAST(@intValue AS TEXT)
+longValue.ToString()      | CAST(@longValue AS TEXT)
+sbyteValue.ToString()     | CAST(@sbyteValue AS TEXT)
+shortValue.ToString()     | CAST(@shortValue AS TEXT)
+timeSpan.ToString()       | CAST(@timeSpan AS TEXT)
+uintValue.ToString()      | CAST(@uintValue AS TEXT)
+ushortValue.ToString()    | CAST(@ushortValue AS TEXT)
+
+## Date and time functions
+
+.NET                            | SQL                                                                      | Added in
+------------------------------- | ------------------------------------------------------------------------ | --------
+dateOnly.AddDays(value)         | date(@dateOnly, @value \|\| ' days')
+dateOnly.AddMonths(months)      | date(@dateOnly, @months \|\| ' months')
+dateOnly.AddYears(value)        | date(@dateOnly, @value \|\| ' years')
+dateOnly.Day                    | strftime('%d', @dateOnly)
+dateOnly.DayOfWeek              | strftime('%w', @dateOnly)
+dateOnly.DayOfYear              | strftime('%j', @dateOnly)
+DateOnly.FromDateTime(dateTime) | date(@dateTime)
+dateOnly.Month                  | strftime('%m', @dateOnly)
+dateOnly.Year                   | strftime('%Y', @dateOnly)
+dateOnly.DayNumber              | CAST(julianday(@dateOnly) - julianday('0001-01-01') AS INTEGER)          | EF Core 10.0
+DateTime.Now                    | datetime('now', 'localtime')
+DateTime.Today                  | datetime('now', 'localtime', 'start of day')
+DateTime.UtcNow                 | datetime('now')
+dateTime.AddDays(value)         | datetime(@dateTime, @value \|\| ' days')
+dateTime.AddHours(value)        | datetime(@dateTime, @d \|\| ' hours')
+dateTime.AddMilliseconds(value) | datetime(@dateTime, (@value / 1000.0) \|\| ' seconds')
+dateTime.AddMinutes(value)      | datetime(@dateTime, @value \|\| ' minutes')
+dateTime.AddMonths(months)      | datetime(@dateTime, @months \|\| ' months')
+dateTime.AddSeconds(value)      | datetime(@dateTime, @value \|\| ' seconds')
+dateTime.AddTicks(value)        | datetime(@dateTime, (@value / 10000000.0) \|\| ' seconds')
+dateTime.AddYears(value)        | datetime(@dateTime, @value \|\| ' years')
+dateTime.Date                   | datetime(@dateTime, 'start of day')
+dateTime.Day                    | strftime('%d', @dateTime)
+dateTime.DayOfWeek              | strftime('%w', @dateTime)
+dateTime.DayOfYear              | strftime('%j', @dateTime)
+dateTime.Hour                   | strftime('%H', @dateTime)
+dateTime.Millisecond            | (strftime('%f', @dateTime) * 1000) % 1000
+dateTime.Minute                 | strftime('%M', @dateTime)
+dateTime.Month                  | strftime('%m', @dateTime)
+dateTime.Second                 | strftime('%S', @dateTime)
+dateTime.Ticks                  | (julianday(@dateTime) - julianday('0001-01-01 00:00:00')) * 864000000000
+dateTime.TimeOfDay              | time(@dateTime)
+dateTime.Year                   | strftime('%Y', @dateTime)
+
+> [!NOTE]
+> Some SQL has been simplified for illustration purposes. The actual SQL is more complex to handle a wider range of values.
+
+## Numeric functions
+
+.NET                             | SQL                                  | Added in
+-------------------------------- | ------------------------------------ | --------
+-decimalValue                    | ef_negate(@decimalValue)
+decimalValue - d                 | ef_add(@decimalValue, ef_negate(@d))
+decimalValue * d                 | ef_multiply(@decimalValue, @d)
+decimalValue / d                 | ef_divide(@decimalValue, @d)
+decimalValue % d                 | ef_mod(@decimalValue, @d)
+decimalValue + d                 | ef_add(@decimalValue, @d)
+decimalValue < d                 | ef_compare(@decimalValue, @d) < 0
+decimalValue <= d                | ef_compare(@decimalValue, @d) <= 0
+decimalValue > d                 | ef_compare(@decimalValue, @d) > 0
+decimalValue >= d                | ef_compare(@decimalValue, @d) >= 0
+double.DegreesToRadians(degrees) | radians(@degrees)
+double.RadiansToDegrees(radians) | degrees(@dradians)
+doubleValue % d                  | mod(@doubleValue, @d)
+EF.Functions.Random()            | abs(random() / 9223372036854780000.0)
+Math.Abs(value)                  | abs(@value)
+Math.Acos(value)                 | acos(@value)
+Math.Acosh(d)                    | acosh(@d)
+Math.Asin(d)                     | asin(@d)
+Math.Asinh(d)                    | asinh(@d)
+Math.Atan(d)                     | atan(@d)
+Math.Atan2(y, x)                 | atan2(@y, @x)
+Math.Atanh(d)                    | atanh(@d)
+Math.Ceiling(d)                  | ceiling(@d)
+Math.Cos(d)                      | cos(@d)
+Math.Cosh(value)                 | cosh(@value)
+Math.Exp(d)                      | exp(@d)
+Math.Floor(d)                    | floor(@d)
+Math.Log(d)                      | ln(@d)                                | EF Core 8.0
+Math.Log(a, newBase)             | log(@newBase, @a)                     | EF Core 8.0
+Math.Log2(x)                     | log2(@x)                              | EF Core 8.0
+Math.Log10(d)                    | log10(@d)                             | EF Core 8.0
+Math.Max(val1, val2)             | max(@val1, @val2)
+Math.Min(val1, val2)             | min(@val1, @val2)
+Math.Pow(x, y)                   | pow(@x, @y)                           | EF Core 8.0
+Math.Round(d)                    | round(@d)
+Math.Round(d, digits)            | round(@d, @digits)
+Math.Sign(d)                     | sign(@d)                              | EF Core 8.0
+Math.Sin(a)                      | sin(@a)                               | EF Core 8.0
+Math.Sinh(value)                 | sinh(@value)                          | EF Core 8.0
+Math.Sqrt(d)                     | sqrt(@d)                              | EF Core 8.0
+Math.Tan(a)                      | tan(@a)                               | EF Core 8.0
+Math.Tanh(value)                 | tanh(@value)                          | EF Core 8.0
+Math.Truncate(d)                 | trunc(@d)                             | EF Core 8.0
+
+> [!TIP]
+> In addition to the methods listed here, corresponding [generic math](/dotnet/standard/generics/math) implementations
+> and <xref:System.MathF> methods are also translated. For example, `Math.Sin`, `MathF.Sin`, `double.Sin`,
+> and `float.Sin` all map to the `sin` function in SQL.
+
+> [!TIP]
+> SQL functions prefixed with `ef_` are created by EF Core.
+
+## String functions
+
+.NET                                                         | SQL
+------------------------------------------------------------ | ---
+char.ToLower(c)                                              | lower(@c)
+char.ToUpper(c)                                              | upper(@c)
+EF.Functions.Collate(operand, collation)                     | @operand COLLATE @collation
+EF.Functions.Glob(matchExpression, pattern)                  | @matchExpression GLOB @pattern
+EF.Functions.Like(matchExpression, pattern)                  | @matchExpression LIKE @pattern
+EF.Functions.Like(matchExpression, pattern, escapeCharacter) | @matchExpression LIKE @pattern ESCAPE @escapeCharacter
+Regex.IsMatch(input, pattern)                                | @input REGEXP @pattern
+string.Compare(strA, strB)                                   | CASE WHEN @strA = @strB THEN 0 ... END
+string.Concat(str0, str1)                                    | @str0 \|\| @str1
+string.IsNullOrEmpty(value)                                  | @value IS NULL OR @value = ''
+string.IsNullOrWhiteSpace(value)                             | @value IS NULL OR trim(@value) = ''
+stringValue.CompareTo(strB)                                  | CASE WHEN @stringValue = @strB THEN 0 ... END
+stringValue.Contains(value)                                  | instr(@stringValue, @value) > 0
+stringValue.EndsWith(value)                                  | @stringValue LIKE '%' \|\| @value
+stringValue.FirstOrDefault()                                 | substr(@stringValue, 1, 1)
+stringValue.IndexOf(value)                                   | instr(@stringValue, @value) - 1
+stringValue.LastOrDefault()                                  | substr(@stringValue, length(@stringValue), 1)
+stringValue.Length                                           | length(@stringValue)
+stringValue.Replace(oldValue, newValue)                      | replace(@stringValue, @oldValue, @newValue)
+stringValue.StartsWith(value)                                | @stringValue LIKE @value \|\| '%'
+stringValue.Substring(startIndex)                            | substr(@stringValue, @startIndex + 1)
+stringValue.Substring(startIndex, length)                    | substr(@stringValue, @startIndex + 1, @length)
+stringValue.ToLower()                                        | lower(@stringValue)
+stringValue.ToUpper()                                        | upper(@stringValue)
+stringValue.Trim()                                           | trim(@stringValue)
+stringValue.Trim(trimChar)                                   | trim(@stringValue, @trimChar)
+stringValue.TrimEnd()                                        | rtrim(@stringValue)
+stringValue.TrimEnd(trimChar)                                | rtrim(@stringValue, @trimChar)
+stringValue.TrimStart()                                      | ltrim(@stringValue)
+stringValue.TrimStart(trimChar)                              | ltrim(@stringValue, @trimChar)
+
+> [!NOTE]
+> Some SQL has been simplified for illustration purposes. The actual SQL is more complex to handle a wider range of values.
+
+## Miscellaneous functions
+
+.NET                                     | SQL
+---------------------------------------- | ---
+collection.Contains(item)                | @item IN @collection
+enumValue.HasFlag(flag)                  | @enumValue & @flag = @flag
+nullable.GetValueOrDefault()             | coalesce(@nullable, 0)
+nullable.GetValueOrDefault(defaultValue) | coalesce(@nullable, @defaultValue)
+
+## See also
+
+* [Spatial Function Mappings](xref:core/providers/sqlite/spatial#spatial-function-mappings)
diff --git a/entity-framework/core/providers/sqlite/index.md b/entity-framework/core/providers/sqlite/index.md
new file mode 100644
index 0000000000..756a6e4a0e
--- /dev/null
+++ b/entity-framework/core/providers/sqlite/index.md
@@ -0,0 +1,36 @@
+---
+title: SQLite Database Provider - EF Core
+description: Information on the Entity Framework Core SQLite database provider
+author: SamMonoRT
+ms.date: 10/27/2016
+uid: core/providers/sqlite/index
+---
+# SQLite EF Core Database Provider
+
+This database provider allows Entity Framework Core to be used with SQLite. The provider is maintained as part of the [Entity Framework Core project](https://github.com/dotnet/efcore).
+
+## Install
+
+Install the [Microsoft.EntityFrameworkCore.Sqlite NuGet package](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Sqlite/).
+
+### [.NET CLI](#tab/dotnet-core-cli)
+
+```dotnetcli
+dotnet add package Microsoft.EntityFrameworkCore.Sqlite
+```
+
+### [Visual Studio](#tab/vs)
+
+```powershell
+Install-Package Microsoft.EntityFrameworkCore.Sqlite
+```
+
+***
+
+## Supported Database Engines
+
+* SQLite (3.46.1 onwards)
+
+## Limitations
+
+See [SQLite Limitations](xref:core/providers/sqlite/limitations) for some important limitations of the SQLite provider.
diff --git a/entity-framework/core/providers/sqlite/limitations.md b/entity-framework/core/providers/sqlite/limitations.md
new file mode 100644
index 0000000000..6107b6fce7
--- /dev/null
+++ b/entity-framework/core/providers/sqlite/limitations.md
@@ -0,0 +1,102 @@
+---
+title: SQLite Database Provider - Limitations - EF Core
+description: Limitations of the Entity Framework Core SQLite database provider as compared to other providers
+author: SamMonoRT
+ms.date: 11/15/2021
+uid: core/providers/sqlite/limitations
+---
+# SQLite EF Core Database Provider Limitations
+
+The SQLite provider has a number of migrations limitations. Most of these limitations are a result of limitations in the underlying SQLite database engine and are not specific to EF.
+
+## Modeling limitations
+
+The common relational library (shared by EF Core relational database providers) defines APIs for modelling concepts that are common to most relational database engines. A couple of these concepts are not supported by the SQLite provider.
+
+* Schemas
+* Sequences
+* Database-generated concurrency tokens ([see documentation](xref:core/saving/concurrency#native-database-generated-concurrency-tokens))
+
+## Query limitations
+
+SQLite doesn't natively support the following data types. EF Core can read and write values of these types, and querying for equality (`where e.Property == value`) is also supported. Other operations, however, like comparison and ordering will require evaluation on the client.
+
+* `DateTimeOffset`
+* `decimal`
+* `TimeSpan`
+* `ulong`
+
+Instead of `DateTimeOffset`, we recommend using `DateTime` values. When handling multiple time zones, we recommend converting the values to UTC before saving and then converting back to the appropriate time zone.
+
+The `decimal` type provides a high level of precision. If you don't need that level of precision, however, we recommend using `double` instead. You can use a [value converter](xref:core/modeling/value-conversions) to continue using `decimal` in your classes.
+
+```csharp
+modelBuilder.Entity<MyEntity>()
+    .Property(e => e.DecimalProperty)
+    .HasConversion<double>();
+```
+
+## Migrations limitations
+
+The SQLite database engine does not support a number of schema operations that are supported by the majority of other relational databases. If you attempt to apply one of the unsupported operations to a SQLite database then a `NotSupportedException` will be thrown.
+
+A rebuild will be attempted in order to perform certain operations. Rebuilds are only possible for database artifacts that are part of your EF Core model. If a database artifact isn't part of the model - for example, if it was created manually inside a migration - then a `NotSupportedException` is still thrown.
+
+Operation            | Supported?
+---------------------|:----------
+AddCheckConstraint   | ✔ (rebuild)
+AddColumn            | ✔
+AddForeignKey        | ✔ (rebuild)
+AddPrimaryKey        | ✔ (rebuild)
+AddUniqueConstraint  | ✔ (rebuild)
+AlterColumn          | ✔ (rebuild)
+CreateIndex          | ✔
+CreateTable          | ✔
+DropCheckConstraint  | ✔ (rebuild)
+DropColumn           | ✔ (rebuild)
+DropForeignKey       | ✔ (rebuild)
+DropIndex            | ✔
+DropPrimaryKey       | ✔ (rebuild)
+DropTable            | ✔
+DropUniqueConstraint | ✔ (rebuild)
+RenameColumn         | ✔
+RenameIndex          | ✔ (rebuild)
+RenameTable          | ✔
+EnsureSchema         | ✔ (no-op)
+DropSchema           | ✔ (no-op)
+Insert               | ✔
+Update               | ✔
+Delete               | ✔
+
+### Migrations limitations workaround
+
+You can workaround some of these limitations by manually writing code in your migrations to perform a rebuild. Table rebuilds involve creating a new table, copying data to the new table, dropping the old table, renaming the new table. You will need to use the <xref:Microsoft.EntityFrameworkCore.Migrations.MigrationBuilder.Sql%2A> method to perform some of these steps.
+
+See [Making Other Kinds Of Table Schema Changes](https://sqlite.org/lang_altertable.html#otheralter) in the SQLite documentation for more details.
+
+### Idempotent script limitations
+
+Unlike other databases, SQLite doesn't include a procedural language. Because of this, there is no way to generate the if-then logic required by the idempotent migration scripts.
+
+If you know the last migration applied to a database, you can generate a script from that migration to the latest migration.
+
+```dotnetcli
+dotnet ef migrations script CurrentMigration
+```
+
+Otherwise, we recommend using `dotnet ef database update` to apply migrations. You can specify the database file when running the command.
+
+```dotnetcli
+dotnet ef database update --connection "Data Source=My.db"
+```
+
+## Concurrent migrations protection
+
+EF9 introduced a locking mechanism when executing migrations. It aims to protect against multiple migration executions happening simultaneously, as that could leave the database in a corrupted state. This is one of the potential problems resulting from applying migrations at runtime using the <xref:Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.Migrate%2A> method (see [Applying migrations](xref:core/managing-schemas/migrations/applying) for more information). To mitigate this, EF creates an exclusive lock on the database before any migration operations are applied.
+
+Unfortunately, SQLite does not have built-in locking mechanism, so EF Core creates a separate table (`__EFMigrationsLock`) and uses it for locking. The lock is released when the migration completes and the seeding code finishes execution. However, if for some reason migration fails in a non-recoverable way, the lock may not be released correctly. If this happens, consecutive migrations will be blocked from executing SQL and therefore never complete. You can manually unblock them by deleting the `__EFMigrationsLock` table in the database.
+
+## See also
+
+* [Microsoft.Data.Sqlite Async Limitations](/dotnet/standard/data/sqlite/async)
+* [Microsoft.Data.Sqlite ADO.NET Limitations](/dotnet/standard/data/sqlite/adonet-limitations)
diff --git a/entity-framework/core/providers/sqlite/misc.md b/entity-framework/core/providers/sqlite/misc.md
new file mode 100644
index 0000000000..dab10b9e89
--- /dev/null
+++ b/entity-framework/core/providers/sqlite/misc.md
@@ -0,0 +1,52 @@
+---
+title: Miscellaneous - SQLite Database Provider - EF Core
+description: Miscellaneous information for the SQLite database provider
+author: roji
+ms.date: 11/27/2025
+uid: core/providers/sqlite/misc
+---
+# Miscellaneous notes for SQLite
+
+## SaveChanges and the RETURNING clause
+
+When EF Core saves changes to the database, it does so with an optimized technique using the SQL [RETURNING clause](https://sqlite.org/lang_returning.html). Unfortunately, the RETURNING clause has some limitations; it cannot be used with virtual tables or tables with certain trigger types, for example.
+
+If you run into a limitation related to the use of the RETURNING clause, you can disable it on a specific table via <xref:Microsoft.EntityFrameworkCore.SqliteEntityTypeExtensions.UseSqlReturningClause*>:
+
+```c#
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Blog>()
+        .ToTable(tb => tb.UseSqlReturningClause(false));
+}
+```
+
+Doing this will make EF switch to an older, less efficient technique for updating the table.
+
+If most or all of your tables have triggers, you can configure this for all your model's tables by using the following [model building convention](xref:core/modeling/bulk-configuration#conventions):
+
+```c#
+public class NoOutputClauseConvention : IModelFinalizingConvention
+{
+    public virtual void ProcessModelFinalizing(
+        IConventionModelBuilder modelBuilder,
+        IConventionContext<IConventionModelBuilder> context)
+    {
+        foreach (var entityType in modelBuilder.Metadata.GetEntityTypes())
+        {
+            var table = StoreObjectIdentifier.Create(entityType, StoreObjectType.Table);
+            if (table is not null)
+            {
+                entityType.Builder.UseSqlReturningClause(false);
+            }
+
+            foreach (var fragment in entityType.GetMappingFragments(StoreObjectType.Table))
+            {
+                entityType.Builder.UseSqlReturningClause(false, fragment.StoreObject);
+            }
+        }
+    }
+}
+```
+
+This effectively calls <xref:Microsoft.EntityFrameworkCore.SqliteEntityTypeExtensions.UseSqlReturningClause*> on all your model's tables, instead of you having to do it manually for each and every table.
diff --git a/entity-framework/core/providers/sqlite/spatial.md b/entity-framework/core/providers/sqlite/spatial.md
new file mode 100644
index 0000000000..943134068f
--- /dev/null
+++ b/entity-framework/core/providers/sqlite/spatial.md
@@ -0,0 +1,157 @@
+---
+title: SQLite Database Provider - Spatial Data - EF Core
+description: Using spatial data with the Entity Framework Core SQLite database provider
+author: SamMonoRT
+ms.date: 03/27/2026
+uid: core/providers/sqlite/spatial
+---
+# Spatial Data in the SQLite EF Core Provider
+
+This page includes additional information about using spatial data with the SQLite database provider. For general information about using spatial data in EF Core, see the main [Spatial Data](xref:core/modeling/spatial) documentation.
+
+## Installing SpatiaLite
+
+On Windows, the native `mod_spatialite` library is distributed as a [NuGet package](https://www.nuget.org/packages/mod_spatialite) dependency. Other platforms need to install it separately. This is typically done using a software package manager. For example, you can use APT on Debian and Ubuntu; and Homebrew on MacOS.
+
+```bash
+# Debian/Ubuntu
+apt-get install libsqlite3-mod-spatialite
+
+# macOS
+brew install libspatialite
+```
+
+Unfortunately, newer versions of PROJ (a dependency of SpatiaLite) are incompatible with EF's default [SQLitePCLRaw bundle](/dotnet/standard/data/sqlite/custom-versions#bundles). You can work around this by using the system SQLite library instead.
+
+> [!IMPORTANT]
+> Don't use `Microsoft.EntityFrameworkCore.Sqlite` or `Microsoft.Data.Sqlite` with SpatiaLite on macOS and Linux. Both packages pull in `SQLitePCLRaw.bundle_e_sqlite3` by default—a bundled version of SQLite that is incompatible with system-installed SQLite. Using it may result in a silent crash at run time. Use `Microsoft.EntityFrameworkCore.Sqlite.Core` or `Microsoft.Data.Sqlite.Core` instead, together with the system SQLite provider as shown below.
+>
+> Also note that the system-installed SQLite library may have different [compile-time options](https://sqlite.org/compile.html) than the bundled version. This can affect the availability of features such as math functions and full-text search. To quickly inspect the options in your SQLite build, run `PRAGMA compile_options;` and check for the features your application relies on.
+
+Replace `Microsoft.EntityFrameworkCore.Sqlite` with `Microsoft.EntityFrameworkCore.Sqlite.Core` and reference the `SQLitePCLRaw.provider.sqlite3` package to use the system SQLite library:
+
+```xml
+<ItemGroup>
+  <!-- Use Sqlite.Core with the system SQLite provider instead of Microsoft.EntityFrameworkCore.Sqlite -->
+  <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.Core" Version="10.0.0" />
+  <PackageReference Include="SQLitePCLRaw.provider.sqlite3" Version="2.1.10" />
+
+  <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.NetTopologySuite" Version="10.0.0" />
+</ItemGroup>
+```
+
+> [!NOTE]
+> Starting with EF Core 11 (SQLitePCLRaw 3.0), replace the `SQLitePCLRaw.provider.sqlite3` version with `3.x.x`. See the [breaking changes](xref:core/what-is-new/ef-core-11.0/breaking-changes#sqlite-bundles-removed) for details.
+
+Then add explicit initialization before using SQLite:
+
+```csharp
+SQLitePCL.raw.SetProvider(new SQLitePCL.SQLite3Provider_sqlite3());
+```
+
+On **macOS**, you'll also need to set an environment variable before running your app so it uses Homebrew's version of SQLite:
+
+```bash
+DYLD_LIBRARY_PATH="$(brew --prefix sqlite)/lib"
+```
+
+## Configuring SRID
+
+In SpatiaLite, columns need to specify an SRID per column. The default SRID is `0`. Specify a different SRID using the HasSrid method.
+
+```csharp
+modelBuilder.Entity<City>().Property(c => c.Location)
+    .HasSrid(4326);
+```
+
+> [!NOTE]
+> 4326 refers to WGS 84, a standard used in GPS and other geographic systems.
+
+## Dimension
+
+The default dimension (or ordinates) of a column is X and Y. To enable additional ordinates like Z or M, configure the column type.
+
+```csharp
+modelBuilder.Entity<City>().Property(c => c.Location)
+    .HasColumnType("POINTZ");
+```
+
+## Spatial function mappings
+
+This table shows which [NetTopologySuite](https://nettopologysuite.github.io/NetTopologySuite/) (NTS) members are translated into which SQL functions.
+
+.NET                                        | SQL
+------------------------------------------- | ---
+geometry.Area                               | Area(@geometry)
+geometry.AsBinary()                         | AsBinary(@geometry)
+geometry.AsText()                           | AsText(@geometry)
+geometry.Boundary                           | Boundary(@geometry)
+geometry.Buffer(distance)                   | Buffer(@geometry, @distance)
+geometry.Buffer(distance, quadrantSegments) | Buffer(@geometry, @distance, @quadrantSegments)
+geometry.Centroid                           | Centroid(@geometry)
+geometry.Contains(g)                        | Contains(@geometry, @g)
+geometry.ConvexHull()                       | ConvexHull(@geometry)
+geometry.CoveredBy(g)                       | CoveredBy(@geometry, @g)
+geometry.Covers(g)                          | Covers(@geometry, @g)
+geometry.Crosses(g)                         | Crosses(@geometry, @g)
+geometry.Difference(other)                  | Difference(@geometry, @other)
+geometry.Dimension                          | Dimension(@geometry)
+geometry.Disjoint(g)                        | Disjoint(@geometry, @g)
+geometry.Distance(g)                        | Distance(@geometry, @g)
+geometry.Envelope                           | Envelope(@geometry)
+geometry.EqualsTopologically(g)             | Equals(@geometry, @g)
+geometry.GeometryType                       | GeometryType(@geometry)
+geometry.GetGeometryN(n)                    | GeometryN(@geometry, @n + 1)
+geometry.InteriorPoint                      | PointOnSurface(@geometry)
+geometry.Intersection(other)                | Intersection(@geometry, @other)
+geometry.Intersects(g)                      | Intersects(@geometry, @g)
+geometry.IsEmpty                            | IsEmpty(@geometry)
+geometry.IsSimple                           | IsSimple(@geometry)
+geometry.IsValid                            | IsValid(@geometry)
+geometry.IsWithinDistance(geom, distance)   | Distance(@geometry, @geom) <= @distance
+geometry.Length                             | GLength(@geometry)
+geometry.NumGeometries                      | NumGeometries(@geometry)
+geometry.NumPoints                          | NumPoints(@geometry)
+geometry.OgcGeometryType                    | CASE GeometryType(@geometry) WHEN 'POINT' THEN 1 ... END
+geometry.Overlaps(g)                        | Overlaps(@geometry, @g)
+geometry.PointOnSurface                     | PointOnSurface(@geometry)
+geometry.Relate(g, intersectionPattern)     | Relate(@geometry, @g, @intersectionPattern)
+geometry.Reverse()                          | ST_Reverse(@geometry)
+geometry.SRID                               | SRID(@geometry)
+geometry.SymmetricDifference(other)         | SymDifference(@geometry, @other)
+geometry.ToBinary()                         | AsBinary(@geometry)
+geometry.ToText()                           | AsText(@geometry)
+geometry.Touches(g)                         | Touches(@geometry, @g)
+geometry.Union()                            | UnaryUnion(@geometry)
+geometry.Union(other)                       | GUnion(@geometry, @other)
+geometry.Within(g)                          | Within(@geometry, @g)
+geometryCollection[i]                       | GeometryN(@geometryCollection, @i + 1)
+geometryCollection.Count                    | NumGeometries(@geometryCollection)
+lineString.Count                            | NumPoints(@lineString)
+lineString.EndPoint                         | EndPoint(@lineString)
+lineString.GetPointN(n)                     | PointN(@lineString, @n + 1)
+lineString.IsClosed                         | IsClosed(@lineString)
+lineString.IsRing                           | IsRing(@lineString)
+lineString.StartPoint                       | StartPoint(@lineString)
+multiLineString.IsClosed                    | IsClosed(@multiLineString)
+point.M                                     | M(@point)
+point.X                                     | X(@point)
+point.Y                                     | Y(@point)
+point.Z                                     | Z(@point)
+polygon.ExteriorRing                        | ExteriorRing(@polygon)
+polygon.GetInteriorRingN(n)                 | InteriorRingN(@polygon, @n + 1)
+polygon.NumInteriorRings                    | NumInteriorRing(@polygon)
+
+### Aggregate functions
+
+.NET                                                              | SQL                           | Added in
+----------------------------------------------------------------- | ----------------------------- | --------
+GeometryCombiner.Combine(group.Select(x => x.Property))           | Collect(Property)             | EF Core 7.0
+ConvexHull.Create(group.Select(x => x.Property))                  | ConvexHull(Collect(Property)) | EF Core 7.0
+UnaryUnionOp.Union(group.Select(x => x.Property))                 | GUnion(Property)              | EF Core 7.0
+EnvelopeCombiner.CombineAsGeometry(group.Select(x => x.Property)) | Extent(Property)              | EF Core 7.0
+
+## Additional resources
+
+* [SpatiaLite Homepage](https://www.gaia-gis.it/fossil/libspatialite)
+* [NetTopologySuite API Documentation](https://nettopologysuite.github.io/NetTopologySuite/api/NetTopologySuite.html)
diff --git a/entity-framework/core/providers/sqlite/value-generation.md b/entity-framework/core/providers/sqlite/value-generation.md
new file mode 100644
index 0000000000..f25342c037
--- /dev/null
+++ b/entity-framework/core/providers/sqlite/value-generation.md
@@ -0,0 +1,48 @@
+---
+title: SQLite Database Provider - Value Generation - EF Core
+description: Value Generation Patterns Specific to the SQLite Entity Framework Core Database Provider
+author: AndriySvyryd
+ms.date: 09/26/2025
+uid: core/providers/sqlite/value-generation
+---
+# SQLite Value Generation
+
+This page details value generation configuration and patterns that are specific to the SQLite provider. It's recommended to first read [the general page on value generation](xref:core/modeling/generated-properties).
+
+## AUTOINCREMENT columns
+
+By convention, numeric primary key columns that are configured to have their values generated on add are set up with [SQLite's AUTOINCREMENT feature](https://sqlite.org/autoinc.html). Starting with EF Core 10, SQLite AUTOINCREMENT can also be enabled or disabled via configuration.
+
+### Configuring AUTOINCREMENT
+
+By convention, integer primary keys are automatically configured with AUTOINCREMENT when they are not part of a composite key and don't have a foreign key on them. However, you may need to explicitly configure a property to use SQLite AUTOINCREMENT when the property has a value conversion from a non-integer type, or when overriding conventions:
+
+[!code-csharp[Main](../../../../samples/core/Sqlite/ValueGeneration/SqliteAutoincrementWithValueConverter.cs?name=SqliteAutoincrementWithValueConverter&highlight=4)]
+
+## Disabling AUTOINCREMENT for default SQLite value generation
+
+AUTOINCREMENT imposes extra CPU, memory, disk space, and disk I/O overhead compared to the default key generation algorithm in SQLite - [ROWID](https://sqlite.org/lang_createtable.html#rowid). The downside of `ROWID` is that it reuses values from deleted rows. If your scenario wouldn't be affected by this, you may want to disable AUTOINCREMENT and use SQLite's default value generation behavior instead. You can do this using the Metadata API:
+
+<!--
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .Property(b => b.Id)
+            .Metadata.SetValueGenerationStrategy(SqliteValueGenerationStrategy.None);
+    }
+-->
+[!code-csharp[Main](../../../../samples/core/Sqlite/ValueGeneration/SqliteValueGenerationStrategyNone.cs?name=SqliteValueGenerationStrategyNone&highlight=5)]
+
+Alternatively, you can configure EF to not treat the property as value-generated:
+
+<!--
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .Property(b => b.Id)
+            .ValueGeneratedNever();
+    }
+-->
+[!code-csharp[Main](../../../../samples/core/Sqlite/ValueGeneration/SqliteValueGeneratedNever.cs?name=SqliteValueGeneratedNever&highlight=5)]
+
+This means that it's up to the application to supply a value for the property before saving to the database. Note that this still won't disable the default value generation server-side, so non-EF usages could still get a generated value. To [completely disable value generation](https://sqlite.org/lang_createtable.html#rowids_and_the_integer_primary_key), change the column type from `INTEGER` to `INT`.
diff --git a/entity-framework/core/providers/writing-a-provider.md b/entity-framework/core/providers/writing-a-provider.md
new file mode 100644
index 0000000000..132aeaad60
--- /dev/null
+++ b/entity-framework/core/providers/writing-a-provider.md
@@ -0,0 +1,95 @@
+---
+title: Writing a Database Provider - EF Core
+description: Information on writing a new Entity Framework Core provider
+author: SamMonoRT
+ms.date: 10/27/2016
+uid: core/providers/writing-a-provider
+---
+
+# Writing a Database Provider
+
+For information about writing an Entity Framework Core database provider, see [So you want to write an EF Core provider](https://blog.oneunicorn.com/2016/11/11/so-you-want-to-write-an-ef-core-provider/) by [Arthur Vickers](https://github.com/ajcvickers).
+
+> [!NOTE]
+> These posts have not been updated since EF Core 1.1 and there have been significant changes since that time.
+[Issue 681](https://github.com/dotnet/EntityFramework.Docs/issues/681) is tracking updates to this documentation.
+
+The EF Core codebase is open source and contains several database providers that can be used as a reference. You can find the source code at <https://github.com/dotnet/efcore>. It may also be helpful to look at the code for commonly used third-party providers, such as [Npgsql](https://github.com/npgsql/Npgsql.EntityFrameworkCore.PostgreSQL), [Pomelo MySQL](https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql), and [SQL Server Compact](https://github.com/ErikEJ/EntityFramework.SqlServerCompact). In particular, these projects are set up to extend from and run functional tests that we publish on NuGet. This kind of setup is strongly recommended.
+
+## Community standup videos
+
+The EF team produces "community standup" videos, where we discuss various aspects of .NET and data access. Some of these have explored EF internals, and can be a good way to understand the general architecture of EF when writing a provider:
+
+* [How to Add a Feature to EF Core](https://www.youtube.com/watch?v=9OMxy1wal1s&list=PLdo4fOcmZ0oX0ObHwBrJ0vJpZ7PiYMqeA)
+* [Internal Dependency Injection](https://www.youtube.com/watch?v=pYhe-Mt0HzI&list=PLdo4fOcmZ0oX0ObHwBrJ0vJpZ7PiYMqeA)
+* [DbContext Configuration and Lifetime](https://www.youtube.com/watch?v=NPgFlqXPbK8&list=PLdo4fOcmZ0oX0ObHwBrJ0vJpZ7PiYMqeA)
+* [IQueryable, LINQ and the EF Core query pipeline](https://www.youtube.com/watch?v=1Ld3dtnTrMw&list=PLdo4fOcmZ0oX0ObHwBrJ0vJpZ7PiYMqeA)
+* [Model Building](https://www.youtube.com/watch?v=FYz0rAxQkC8&list=PLdo4fOcmZ0oX0ObHwBrJ0vJpZ7PiYMqeA)
+
+## Suggested naming of third party providers
+
+We suggest using the following naming for NuGet packages. This is consistent with the names of packages delivered by the EF Core team.
+
+`<Optional project/company name>.EntityFrameworkCore.<Database engine name>`
+
+For example:
+
+* `Microsoft.EntityFrameworkCore.SqlServer`
+* `Npgsql.EntityFrameworkCore.PostgreSQL`
+* `EntityFrameworkCore.SqlServerCompact40`
+
+## The EF Core specification tests
+
+EF Core provides a specification test suite project, which all providers are encouraged to implement. The project contains tests which ensure that the provider function correctly, e.g. by executing various LINQ queries and ensuring that the correct results are returned. This test suite is used by EF Core's own providers (such as SQL Server, SQLite, and Azure Cosmos DB) as the primary regression testing mechanism, and are continuously updated and improved as new features are added to EF Core. By implementing these tests for other, 3rd-party providers, you can ensure that your database provider works correctly and implements all the latest EF Core features. Note that the test suite is quite large, as it covers the entire EF Core feature set; you don't have to implement everything - it's perfectly fine to cherry-pick certain test classes, and incrementally improve your coverage with time.
+
+To start using the specification tests, follow these steps:
+
+* Create an xUnit test project in your provider solution. We suggest the name `<Provider>.FunctionalTests` for consistency, so if your provider is called `AcmeSoftware.EntityFramework.AcmeDb`, call the test project `AcmeSoftware.EntityFramework.AcmeDb.FunctionalTests`.
+* From your new test project, reference the EF specification tests, which are published as regular Nuget packages. For relational providers, the specification test suite is [Microsoft.EntityFrameworkCore.Relational.Specification.Tests](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Relational.Specification.Tests), for non-relational provider, use [Microsoft.EntityFrameworkCore.Specification.Tests](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Specification.Tests)).
+* Pick a test class from the EF specification tests, and extend it from a corresponding test class in your own project. The available test classes can be seen in the [EF source code](https://github.com/dotnet/efcore/tree/main/test/EFCore.Relational.Specification.Tests). Your class should be named based on the EF test class, with your provider name inserted where appropriate. For example, `NorthwindWhereQueryRelationalTestBase` (which is a good place to start), would be extended by `NorthwindWhereQueryAcmeDbTest`.
+* At the very beginning, you'll have a bit of test infrastructure to implement - once that's done once, things will become easier. For example, for `NorthwindWhereQueryAcmeDbTest` you'll have to implement `NorthwindWhereQueryAcmeDbFixture`, which will require a `AcmeDbNorthwindTestStoreFactory`, which would need a Northwind.sql script to seed the AcmeDb version of the Northwind database. We strongly suggest keeping another EF Core provider's test suite open nearby, and following what it does. For example, the SQL Server implementation of the specification tests is visible [here](https://github.com/dotnet/efcore/tree/main/test/EFCore.SqlServer.FunctionalTests).
+* Once the infrastructure for the test class is done, you'll start seeing some green tests on it. You can investigate the failing tests, or temporarily skip them for later investigation. In this way you can add more and more test classes.
+* At some point, when you've extended most of the upstream test classes, you can also create `AcmeDbComplianceTest`, which extends `RelationalComplianceTestBase`. This test class will fail if your own test project doesn't extend an EF Core test class - it's a great way to know whether your test suite is complete, and also whether EF added a new test class in a new version. You can also opt out of extending specific test classes if they're not ready (or not relevant).
+
+### SQL assertions
+
+When implementing the specification tests, you have the option of additionally asserting the SQL that EF Core produces. This isn't mandatory: the specification test implementation already checks that your provider returned the expected rows from the database, so if it passes, your provider is likely doing the right thing. However, asserting that the SQL is what you expect it to be can add additional coverage in some cases, especially where some SQL construct is being used that's specific to your database.
+
+For example, here's the `Where_simple` test in [NorthwindWhereQuerySqlServerTest](https://github.com/dotnet/efcore/blob/main/test/EFCore.SqlServer.FunctionalTests/Query/NorthwindWhereQuerySqlServerTest.cs) test class:
+
+```c#
+public override async Task Where_simple(bool async)
+{
+    await base.Where_simple(async);
+
+    AssertSql(
+        @"SELECT [c].[CustomerID], [c].[Address], [c].[City], [c].[CompanyName], [c].[ContactName], [c].[ContactTitle], [c].[Country], [c].[Fax], [c].[Phone], [c].[PostalCode], [c].[Region]
+FROM [Customers] AS [c]
+WHERE [c].[City] = N'London'");
+}
+```
+
+The base invocation runs the specification test, which executes the LINQ query and verifies that the results are correct. In addition, `AssertSql` ensures that the SQL matched the baseline included in the test.
+
+#### Inspecting SQL assertion failures
+
+If a SQL assertion fails, xunit typically reports only the fragment of the SQL which did not match. To see the full SQL produced by your provider, you can have the test infrastructure output the complete new baseline when a test fails, so that you can inspect it and possibly replace the old one. To do this, pass the `ITestOutputHelper` provided by xunit to the `TestSqlLoggerFactory` of the test fixture:
+
+```c#
+public NorthwindWhereQuerySqlServerTest(
+    NorthwindQuerySqlServerFixture<NoopModelCustomizer> fixture,
+    ITestOutputHelper testOutputHelper)
+    : base(fixture)
+{
+    ClearLog();
+    Fixture.TestSqlLoggerFactory.SetTestOutputHelper(testOutputHelper);
+}
+```
+
+In the EF Core test suites, we usually keep the above line commented out in the constructor, so that we can easily uncomment it any time a SQL assertion fails.
+
+#### Bulk update of baselines
+
+If you use SQL assertions a lot, you'll have many SQL baselines in your test suite. In some cases, a small change - either in your provider or in EF Core itself - may cause a large number of these assertions to fail for some reason, e.g. parentheses were added somewhere. If that happens, manually correcting all the affected baselines can be a very tedious and time-consuming process.
+
+The EF Core test infrastructure has a feature which automatically updates all failing baselines with the new ones. Simply set the `EF_TEST_REWRITE_BASELINES` environment variable to `1` and run the tests, and the test source files should get updated. It's recommend to commit before doing this, and then use git to inspect the test diff, to make sure the new baselines make sense. Once you're satisfied, you can commit those changes as well.
diff --git a/entity-framework/core/querying/client-eval.md b/entity-framework/core/querying/client-eval.md
new file mode 100644
index 0000000000..fd14e8b5ad
--- /dev/null
+++ b/entity-framework/core/querying/client-eval.md
@@ -0,0 +1,69 @@
+---
+title: Client vs. Server Evaluation - EF Core
+description: Client and server evaluation of queries with Entity Framework Core
+author: smitpatel
+ms.date: 11/09/2020
+uid: core/querying/client-eval
+---
+# Client vs. Server Evaluation
+
+As a general rule, Entity Framework Core attempts to evaluate a query on the server as much as possible. EF Core converts parts of the query into parameters, which it can evaluate on the client side. The rest of the query (along with the generated parameters) is given to the database provider to determine the equivalent database query to evaluate on the server. EF Core supports partial client evaluation in the top-level projection (essentially, the last call to `Select()`). If the top-level projection in the query can't be translated to the server, EF Core will fetch any required data from the server and evaluate remaining parts of the query on the client. If EF Core detects an expression, in any place other than the top-level projection, which can't be translated to the server, then it throws a runtime exception. See [How queries work](xref:core/querying/how-query-works) to understand how EF Core determines what can't be translated to server.
+
+> [!NOTE]
+> Prior to version 3.0, Entity Framework Core supported client evaluation anywhere in the query. For more information, see the [previous versions section](#previous-versions).
+
+> [!TIP]
+> You can view this article's [sample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Querying/ClientEvaluation) on GitHub.
+
+## Client evaluation in the top-level projection
+
+In the following example, a helper method is used to standardize URLs for blogs, which are returned from a SQL Server database. Since the SQL Server provider has no insight into how this method is implemented, it isn't possible to translate it into SQL. All other aspects of the query are evaluated in the database, but passing the returned `URL` through this method is done on the client.
+
+[!code-csharp[Main](../../../samples/core/Querying/ClientEvaluation/Program.cs#ClientProjection)]
+
+[!code-csharp[Main](../../../samples/core/Querying/ClientEvaluation/Program.cs#ClientMethod)]
+
+## Unsupported client evaluation
+
+While client evaluation is useful, it can result in poor performance sometimes. Consider the following query, in which the helper method is now used in a where filter. Because the filter can't be applied in the database, all the data needs to be pulled into memory to apply the filter on the client. Based on the filter and the amount of data on the server, client evaluation could result in poor performance. So Entity Framework Core blocks such client evaluation and throws a runtime exception.
+
+[!code-csharp[Main](../../../samples/core/Querying/ClientEvaluation/Program.cs#ClientWhere)]
+
+## Explicit client evaluation
+
+You may need to force into client evaluation explicitly in certain cases like following
+
+- The amount of data is small so that evaluating on the client doesn't incur a huge performance penalty.
+- The LINQ operator being used has no server-side translation.
+
+In such cases, you can explicitly opt into client evaluation by calling methods like `AsEnumerable` or `ToList` (`AsAsyncEnumerable` or `ToListAsync` for async). By using `AsEnumerable` you would be streaming the results, but using `ToList` would cause buffering by creating a list, which also takes additional memory. Though if you're enumerating multiple times, then storing results in a list helps more since there's only one query to the database. Depending on the particular usage, you should evaluate which method is more useful for the case.
+
+[!code-csharp[Main](../../../samples/core/Querying/ClientEvaluation/Program.cs#ExplicitClientEvaluation)]
+
+> [!TIP]
+> If you are using `AsAsyncEnumerable` and want to compose the query further on client side then you can use [System.Interactive.Async](https://www.nuget.org/packages/System.Interactive.Async/) library which defines operators for async enumerables. For more information, see [client side linq operators](xref:core/miscellaneous/async#client-side-async-linq-operators).
+
+## Potential memory leak in client evaluation
+
+Since query translation and compilation are expensive, EF Core caches the compiled query plan. The cached delegate may use client code while doing client evaluation of top-level projection. EF Core generates parameters for the client-evaluated parts of the tree and reuses the query plan by replacing the parameter values. But certain constants in the expression tree can't be converted into parameters. If the cached delegate contains such constants, then those objects can't be garbage collected since they're still being referenced. If such an object contains a DbContext or other services in it, then it could cause the memory usage of the app to grow over time. This behavior is generally a sign of a memory leak. EF Core throws an exception whenever it comes across constants of a type that can't be mapped using current database provider. Common causes and their solutions are as follows:
+
+- **Using an instance method**: When using instance methods in a client projection, the expression tree contains a constant of the instance. If your method doesn't use any data from the instance, consider making the method static. If you need instance data in the method body, then pass the specific data as an argument to the method.
+- **Passing constant arguments to method**: This case arises generally by using `this` in an argument to client method. Consider splitting the argument in to multiple scalar arguments, which can be mapped by the database provider.
+- **Other constants**: If a constant is come across in any other case, then you can evaluate whether the constant is needed in processing. If it's necessary to have the constant, or if you can't use a solution from the above cases, then create a local variable to store the value and use local variable in the query. EF Core will convert the local variable into a parameter.
+
+## Previous versions
+
+The following section applies to EF Core versions before 3.0.
+
+Older EF Core versions supported client evaluation in any part of the query--not just the top-level projection. That's why queries similar to one posted under the [Unsupported client evaluation](#unsupported-client-evaluation) section worked correctly. Since this behavior could cause unnoticed performance issues, EF Core logged a client evaluation warning. For more information on viewing logging output, see [Logging](xref:core/logging-events-diagnostics/index).
+
+Optionally EF Core allowed you to change the default behavior to either throw an exception or do nothing when doing client evaluation (except for in the projection). The exception throwing behavior would make it similar to the behavior in 3.0. To change the behavior, you need to configure warnings while setting up the options for your context - typically in `DbContext.OnConfiguring`, or in `Startup.cs` if you're using ASP.NET Core.
+
+```csharp
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+{
+    optionsBuilder
+        .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFQuerying;Trusted_Connection=True;")
+        .ConfigureWarnings(warnings => warnings.Throw(RelationalEventId.QueryClientEvaluationWarning));
+}
+```
diff --git a/entity-framework/core/querying/complex-query-operators.md b/entity-framework/core/querying/complex-query-operators.md
new file mode 100644
index 0000000000..50309c4a6c
--- /dev/null
+++ b/entity-framework/core/querying/complex-query-operators.md
@@ -0,0 +1,156 @@
+---
+title: Complex Query Operators - EF Core
+description: In-depth information on the more complex LINQ query operators when using Entity Framework Core
+author: smitpatel
+ms.date: 10/03/2019
+uid: core/querying/complex-query-operators
+---
+# Complex Query Operators
+
+Language Integrated Query (LINQ) contains many complex operators, which combine multiple data sources or does complex processing. Not all LINQ operators have suitable translations on the server side. Sometimes, a query in one form translates to the server but if written in a different form doesn't translate even if the result is the same. This page describes some of the complex operators and their supported variations. In future releases, we may recognize more patterns and add their corresponding translations. It's also important to keep in mind that translation support varies between providers. A particular query, which is translated in SqlServer, may not work for SQLite databases.
+
+> [!TIP]
+> You can view this article's [sample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Querying/ComplexQuery) on GitHub.
+
+## Join
+
+The LINQ Join operator allows you to connect two data sources based on the key selector for each source, generating a tuple of values when the key matches. It naturally translates to `INNER JOIN` on relational databases. While the LINQ Join has outer and inner key selectors, the database requires a single join condition. So EF Core generates a join condition by comparing the outer key selector to the inner key selector for equality.
+
+[!code-csharp[Main](../../../samples/core/Querying/ComplexQuery/Program.cs#Join)]
+
+```sql
+SELECT [p].[PersonId], [p].[Name], [p].[PhotoId], [p0].[PersonPhotoId], [p0].[Caption], [p0].[Photo]
+FROM [PersonPhoto] AS [p0]
+INNER JOIN [Person] AS [p] ON [p0].[PersonPhotoId] = [p].[PhotoId]
+```
+
+Further, if the key selectors are anonymous types, EF Core generates a join condition to compare equality component-wise.
+
+[!code-csharp[Main](../../../samples/core/Querying/ComplexQuery/Program.cs#JoinComposite)]
+
+```sql
+SELECT [p].[PersonId], [p].[Name], [p].[PhotoId], [p0].[PersonPhotoId], [p0].[Caption], [p0].[Photo]
+FROM [PersonPhoto] AS [p0]
+INNER JOIN [Person] AS [p] ON ([p0].[PersonPhotoId] = [p].[PhotoId] AND ([p0].[Caption] = N'SN'))
+```
+
+## GroupJoin
+
+The LINQ GroupJoin operator allows you to connect two data sources similar to Join, but it creates a group of inner values for matching outer elements. Executing a query like the following example generates a result of `Blog` & `IEnumerable<Post>`. Since databases (especially relational databases) don't have a way to represent a collection of client-side objects, GroupJoin doesn't translate to the server in many cases. It requires you to get all of the data from the server to do GroupJoin without a special selector (first query below). But if the selector is limiting data being selected then fetching all of the data from the server may cause performance issues (second query below). That's why EF Core doesn't translate GroupJoin.
+
+[!code-csharp[Main](../../../samples/core/Querying/ComplexQuery/Program.cs#GroupJoin)]
+
+[!code-csharp[Main](../../../samples/core/Querying/ComplexQuery/Program.cs#GroupJoinComposed)]
+
+## SelectMany
+
+The LINQ SelectMany operator allows you to enumerate over a collection selector for each outer element and generate tuples of values from each data source. In a way, it's a join but without any condition so every outer element is connected with an element from the collection source. Depending on how the collection selector is related to the outer data source, SelectMany can translate into various different queries on the server side.
+
+### Collection selector doesn't reference outer
+
+When the collection selector isn't referencing anything from the outer source, the result is a cartesian product of both data sources. It translates to `CROSS JOIN` in relational databases.
+
+[!code-csharp[Main](../../../samples/core/Querying/ComplexQuery/Program.cs#SelectManyConvertedToCrossJoin)]
+
+```sql
+SELECT [b].[BlogId], [b].[OwnerId], [b].[Rating], [b].[Url], [p].[PostId], [p].[AuthorId], [p].[BlogId], [p].[Content], [p].[Rating], [p].[Title]
+FROM [Blogs] AS [b]
+CROSS JOIN [Posts] AS [p]
+```
+
+### Collection selector references outer in a where clause
+
+When the collection selector has a where clause, which references the outer element, then EF Core translates it to a database join and uses the predicate as the join condition. Normally this case arises when using collection navigation on the outer element as the collection selector. If the collection is empty for an outer element, then no results would be generated for that outer element. But if `DefaultIfEmpty` is applied on the collection selector then the outer element will be connected with a default value of the inner element. Because of this distinction, this kind of queries translates to `INNER JOIN` in the absence of `DefaultIfEmpty` and `LEFT JOIN` when `DefaultIfEmpty` is applied.
+
+[!code-csharp[Main](../../../samples/core/Querying/ComplexQuery/Program.cs#SelectManyConvertedToJoin)]
+
+```sql
+SELECT [b].[BlogId], [b].[OwnerId], [b].[Rating], [b].[Url], [p].[PostId], [p].[AuthorId], [p].[BlogId], [p].[Content], [p].[Rating], [p].[Title]
+FROM [Blogs] AS [b]
+INNER JOIN [Posts] AS [p] ON [b].[BlogId] = [p].[BlogId]
+
+SELECT [b].[BlogId], [b].[OwnerId], [b].[Rating], [b].[Url], [p].[PostId], [p].[AuthorId], [p].[BlogId], [p].[Content], [p].[Rating], [p].[Title]
+FROM [Blogs] AS [b]
+LEFT JOIN [Posts] AS [p] ON [b].[BlogId] = [p].[BlogId]
+```
+
+### Collection selector references outer in a non-where case
+
+When the collection selector references the outer element, which isn't in a where clause (as the case above), it doesn't translate to a database join. That's why we need to evaluate the collection selector for each outer element. It translates to `APPLY` operations in many relational databases. If the collection is empty for an outer element, then no results would be generated for that outer element. But if `DefaultIfEmpty` is applied on the collection selector then the outer element will be connected with a default value of the inner element. Because of this distinction, this kind of queries translates to `CROSS APPLY` in the absence of `DefaultIfEmpty` and `OUTER APPLY` when `DefaultIfEmpty` is applied. Certain databases like SQLite don't support `APPLY` operators so this kind of query may not be translated.
+
+[!code-csharp[Main](../../../samples/core/Querying/ComplexQuery/Program.cs#SelectManyConvertedToApply)]
+
+```sql
+SELECT [b].[BlogId], [b].[OwnerId], [b].[Rating], [b].[Url], ([b].[Url] + N'=>') + [p].[Title] AS [p]
+FROM [Blogs] AS [b]
+CROSS APPLY [Posts] AS [p]
+
+SELECT [b].[BlogId], [b].[OwnerId], [b].[Rating], [b].[Url], ([b].[Url] + N'=>') + [p].[Title] AS [p]
+FROM [Blogs] AS [b]
+OUTER APPLY [Posts] AS [p]
+```
+
+## GroupBy
+
+LINQ GroupBy operators create a result of type `IGrouping<TKey, TElement>` where `TKey` and `TElement` could be any arbitrary type. Furthermore, `IGrouping` implements `IEnumerable<TElement>`, which means you can compose over it using any LINQ operator after the grouping. Since no database structure can represent an `IGrouping`, GroupBy operators have no translation in most cases. When an aggregate operator is applied to each group, which returns a scalar, it can be translated to SQL `GROUP BY` in relational databases. The SQL `GROUP BY` is restrictive too. It requires you to group only by scalar values. The projection can only contain grouping key columns or any aggregate applied over a column. EF Core identifies this pattern and translates it to the server, as in the following example:
+
+[!code-csharp[Main](../../../samples/core/Querying/ComplexQuery/Program.cs#GroupBy)]
+
+```sql
+SELECT [p].[AuthorId] AS [Key], COUNT(*) AS [Count]
+FROM [Posts] AS [p]
+GROUP BY [p].[AuthorId]
+```
+
+EF Core also translates queries where an aggregate operator on the grouping appears in a Where or OrderBy (or other ordering) LINQ operator. It uses `HAVING` clause in SQL for the where clause. The part of the query before applying the GroupBy operator can be any complex query as long as it can be translated to server. Furthermore, once you apply aggregate operators on a grouping query to remove groupings from the resulting source, you can compose on top of it like any other query.
+
+[!code-csharp[Main](../../../samples/core/Querying/ComplexQuery/Program.cs#GroupByFilter)]
+
+```sql
+SELECT [p].[AuthorId] AS [Key], COUNT(*) AS [Count]
+FROM [Posts] AS [p]
+GROUP BY [p].[AuthorId]
+HAVING COUNT(*) > 0
+ORDER BY [p].[AuthorId]
+```
+
+The aggregate operators EF Core supports are as follows
+
+| .NET                     | SQL           |
+|--------------------------|---------------|
+| Average(x => x.Property) | AVG(Property) |
+| Count()                  | COUNT(*)      |
+| LongCount()              | COUNT(*)      |
+| Max(x => x.Property)     | MAX(Property) |
+| Min(x => x.Property)     | MIN(Property) |
+| Sum(x => x.Property)     | SUM(Property) |
+
+Additional aggregate operators may be supported. Check your provider docs for more function mappings.
+
+Even though there is no database structure to represent an `IGrouping`, in some cases, EF Core 7.0 and newer can create the groupings after the results are returned from the database. This is similar to how the [`Include`](xref:core/querying/related-data/eager) operator works when including related collections. The following LINQ query uses the GroupBy operator to group the results by the value of their Price property.
+
+```csharp
+var query = context.Books.GroupBy(s => s.Price);
+```
+
+```sql
+SELECT [b].[Price], [b].[Id], [b].[AuthorId]
+FROM [Books] AS [b]
+ORDER BY [b].[Price]
+```
+
+In this case, the GroupBy operator doesn't translate directly to a `GROUP BY` clause in the SQL, but instead, EF Core creates the groupings after the results are returned from the server.
+
+## Left Join
+
+While Left Join isn't a LINQ operator, relational databases have the concept of a Left Join which is frequently used in queries. A particular pattern in LINQ queries gives the same result as a `LEFT JOIN` on the server. EF Core identifies such patterns and generates the equivalent `LEFT JOIN` on the server side. The pattern involves creating a GroupJoin between both the data sources and then flattening out the grouping by using the SelectMany operator with DefaultIfEmpty on the grouping source to match null when the inner doesn't have a related element. The following example shows what that pattern looks like and what it generates.
+
+[!code-csharp[Main](../../../samples/core/Querying/ComplexQuery/Program.cs#LeftJoin)]
+
+```sql
+SELECT [b].[BlogId], [b].[OwnerId], [b].[Rating], [b].[Url], [p].[PostId], [p].[AuthorId], [p].[BlogId], [p].[Content], [p].[Rating], [p].[Title]
+FROM [Blogs] AS [b]
+LEFT JOIN [Posts] AS [p] ON [b].[BlogId] = [p].[BlogId]
+```
+
+The above pattern creates a complex structure in the expression tree. Because of that, EF Core requires you to flatten out the grouping results of the GroupJoin operator in a step immediately following the operator. Even if the GroupJoin-DefaultIfEmpty-SelectMany is used but in a different pattern, we may not identify it as a Left Join.
diff --git a/entity-framework/core/querying/database-functions.md b/entity-framework/core/querying/database-functions.md
new file mode 100644
index 0000000000..bf8649c223
--- /dev/null
+++ b/entity-framework/core/querying/database-functions.md
@@ -0,0 +1,55 @@
+---
+title: Database Functions - EF Core
+description: Information on database functions supported in EF Core query translation
+author: smitpatel
+ms.date: 11/10/2020
+uid: core/querying/database-functions
+---
+# Database Functions
+
+Database functions are the database equivalent of [C# methods](/dotnet/csharp/programming-guide/classes-and-structs/methods). A database function can be invoked with zero or more parameters and it computes the result based on the parameter values. Most databases, which use SQL for querying have support for database functions. So SQL generated by EF Core query translation also allows invoking database functions. C# methods don't have to translate strictly to database functions in EF Core.
+
+- A C# method may not have an equivalent database function.
+  - <xref:System.String.IsNullOrEmpty*?displayProperty=nameWithType> method translates to a null check and a comparison with an empty string in the database rather than a function.
+  - <xref:System.String.Equals(System.String,System.StringComparison)?displayProperty=nameWithType> method doesn't have database equivalent since string comparison can't be represented or mimicked easily in a database.
+- A database function may not have an equivalent C# method. The `??` operator in C#, which doesn't have any method, translates to the `COALESCE` function in the database.
+
+## Types of database functions
+
+EF Core SQL generation supports a subset of functions that can be used in databases. This limitation comes from the ability to represent a query in LINQ for the given database function. Further, each database has varying support of database functions, so EF Core provides a common subset. A database provider is free to extend EF Core SQL generation to support more patterns. Following are the types of database functions EF Core supports and uniquely identifies. These terms also help in understanding what translations come built in with EF Core providers.
+
+### Built-in vs user-defined functions
+
+Built-in functions come with database predefined, but user-defined functions are explicitly defined by the user in the database. When EF Core translates queries to use database functions, it uses built-in functions to make sure that the function is always available on the database. The distinction of built-in functions is necessary in some databases to generate SQL correctly. For example SqlServer requires that every user-defined function is invoked with a schema-qualified name. But built-in functions in SqlServer don't have a schema. PostgreSQL defines built-in function in the `public` schema but they can be invoked with schema-qualified names.
+
+### Aggregate vs scalar vs table-valued functions
+
+- Scalar functions take scalar values - like integers or strings - as parameters and return a scalar value as the result. Scalar functions can be used anywhere in SQL where a scalar value can be passed.
+- Aggregate functions take a stream of scalar values as parameters and return a scalar value as the result. Aggregate functions are applied on the whole query result set or on a group of values generated by applying `GROUP BY` operator.
+- Table-valued functions take scalar values as parameter(s) and return a stream of rows as the result. Table-valued functions are used as a table source in `FROM` clause.
+
+### Niladic functions
+
+Niladic functions are special database functions that don't have any parameters and must be invoked without parenthesis. They're similar to property/field access on an instance in C#. Niladic functions differ from parameter-less functions as the latter require empty parenthesis. There's no special name for database functions that requires parenthesis always. Another subset of database functions based on parameter count is variadic functions. Variadic functions can take varying number of parameters when invoked.
+
+## Database function mappings in EF Core
+
+EF Core supports three different ways of mapping between C# functions and database functions.
+
+### Built-in function mapping
+
+By default EF Core providers provide mappings for various built-in functions over primitive types. For example, <xref:System.String.ToLower?displayProperty=nameWithType> translates to `LOWER` in SqlServer. This functionality allows users to write queries in LINQ seamlessly. We usually provide a translation in the database that gives the same result as what the C# function provides on the client side. Sometimes, to achieve that, the actual translation could be something more complicated than a database function. In some scenarios, we also provide the most appropriate translation rather than matching C# semantics. The same feature is also used to provide common translations for some of the C# member accesses. For example, <xref:System.String.Length?displayProperty=nameWithType> translates to `LEN` in SqlServer. Apart from providers, plugin writers can also add additional translations. This extensibility is useful when plugins add support for more types as primitive types and want to translate methods over them.
+
+### EF.Functions mapping
+
+Since not all database functions have equivalent C# functions, EF Core providers have special C# methods to invoke certain database functions. These methods are defined as extension methods over `EF.Functions` to be used in LINQ queries. These methods are provider-specific as they're closely tied with particular database functions. So a method that works for one provider will likely not work for any other provider. Further, since the intention of these methods is to invoke a database function in the translated query, trying to evaluate them on the client results in an exception.
+
+### User-defined function mapping
+
+Apart from mappings provided by EF Core providers, users can also define custom mapping. A user-defined mapping extends the query translation according to the user needs. This functionality is useful when there are user-defined functions in the database, which the user wants to invoke from their LINQ query.
+
+## See also
+
+- [SqlServer built-in function mappings](xref:core/providers/sql-server/functions)
+- [Sqlite built-in function mappings](xref:core/providers/sqlite/functions)
+- [Azure Cosmos DB built-in function mappings](xref:core/providers/cosmos/querying#function-mappings)
diff --git a/entity-framework/core/querying/filters.md b/entity-framework/core/querying/filters.md
new file mode 100644
index 0000000000..75ddc4d792
--- /dev/null
+++ b/entity-framework/core/querying/filters.md
@@ -0,0 +1,159 @@
+---
+title: Global Query Filters - EF Core
+description: Using global query filters to filter results with Entity Framework Core
+author: maumar
+ms.date: 11/03/2017
+uid: core/querying/filters
+---
+# Global Query Filters
+
+Global query filters allow attaching a filter to an entity type and having that filter applied whenever a query on that entity type is executed; think of them as an additional LINQ `Where` operator that's added whenever the entity type is queried. Such filters are useful in a variety of cases.
+
+> [!TIP]
+> You can view this article's [sample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Querying/QueryFilters) on GitHub.
+
+## Basic example - soft deletion
+
+In some scenarios, rather than deleting a row from the database, it's preferable to instead set an `IsDeleted` flag to mark the row as deleted; this pattern is called *soft deletion*. Soft deletion allows rows to be undeleted if needed, or to preserve an audit trail where deleted rows are still accessible. Global query filters can be used to filter out soft-deleted rows by default, while still allowing you to access them in specific places by disabling the filter for a specific query.
+
+To enable soft deletion, let's add an `IsDeleted` property to our Blog type:
+
+[!code-csharp[Main](../../../samples/core/Querying/QueryFilters/SoftDeletion.cs#Blog)]
+
+We now set up a global query filter, using the <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.EntityTypeBuilder`1.HasQueryFilter*> API in `OnModelCreating`:
+
+[!code-csharp[Main](../../../samples/core/Querying/QueryFilters/SoftDeletion.cs#FilterConfiguration)]
+
+We can now query our `Blog` entities as usual; the configured filter will ensure that all queries will - by default - filter out all instances where `IsDeleted` is true.
+
+Note that at this point, you must manually set `IsDeleted` in order to soft-delete an entity. For a more end-to-end solution, you can override your context type's `SaveChangesAsync` method to add logic which goes over all entities which the user deleted, and changes them to be modified instead, setting the `IsDeleted` property to true:
+
+[!code-csharp[Main](../../../samples/core/Querying/QueryFilters/SoftDeletion.cs#SaveChangesAsyncOverride)]
+
+This allows you to use EF APIs that delete an entity instance as usual and have them get soft-deleted instead.
+
+## Using context data - multi-tenancy
+
+Another mainstream scenario for global query filters is *multi-tenancy*, where your application stores data belonging to different users in the same table. In such cases, there's usually a *tenant ID* column which associates the row to a specific tenant, and global query filters can be used to automatically filter for the rows of the current tenant. This provides strong tenant isolation for your queries by default, removing the need to think of filtering for the tenant in each and every query.
+
+Unlike with soft deletion, multi-tenancy requires knowing the *current* tenant ID; this value is usually determined e.g. when the user authenticates over the web. For EF's purposes, the tenant ID must be available on the context instance, so that the global query filter can refer to it and use it when querying. Let's accept a `tenantId` parameter in our context type's constructor, and reference that from our filter:
+
+```c#
+public class MultitenancyContext(string tenantId) : DbContext
+{
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>().HasQueryFilter(b => b.TenantId == tenantId);
+    }
+}
+```
+
+This forces anyone constructing a context to specify its associated tenant ID, and ensures that only `Blog` entities with that ID are returned from queries by default.
+
+> [!NOTE]
+> This sample only showed basic multi-tenancy concepts needed in order to demonstrate global query filters. For more information on multi-tenancy and EF, see [multi-tenancy in EF Core applications](xref:core/miscellaneous/multitenancy).
+
+## Using multiple query filters
+
+Calling <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.EntityTypeBuilder`1.HasQueryFilter*> with a simple filter overwrites any previous filter, so multiple filters **cannot** be defined on the same entity type in this way:
+
+```c#
+modelBuilder.Entity<Blog>().HasQueryFilter(b => !b.IsDeleted);
+// The following overwrites the previous query filter:
+modelBuilder.Entity<Blog>().HasQueryFilter(b => b.TenantId == tenantId);
+```
+
+### [EF 10+](#tab/ef10)
+
+> [!NOTE]
+> This feature is being introduced in EF Core 10.0 (in preview).
+
+In order to define multiple query filters on the same entity type, they must be *named*:
+
+[!code-csharp[Main](../../../samples/core/Querying/QueryFilters/NamedFilters.cs#FilterConfiguration)]
+
+This allows you to manage each filter separately, including selectively disabling one but not the other.
+
+### [Older versions](#tab/older)
+
+Prior to EF 10, you can attach multiple filters to an entity type by calling <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.EntityTypeBuilder`1.HasQueryFilter*> once and combining your filters using the `&&` operator:
+
+```c#
+modelBuilder.Entity<Blog>().HasQueryFilter(b => !b.IsDeleted && b.TenantId == tenantId);
+```
+
+This unfortunately does not allow to selectively disable a single filter.
+
+***
+
+## Disabling filters
+
+Filters may be disabled for individual LINQ queries by using the <xref:Microsoft.EntityFrameworkCore.EntityFrameworkQueryableExtensions.IgnoreQueryFilters*> operator:
+
+[!code-csharp[Main](../../../samples/core/Querying/QueryFilters/SoftDeletion.cs#DisableFilter)]
+
+If multiple named filters are configured, this disables all of them. To selectively disable specific filters (starting with EF 10), pass the list of filter names to be disabled:
+
+[!code-csharp[Main](../../../samples/core/Querying/QueryFilters/NamedFilters.cs#DisableSoftDeletionFilter)]
+
+## Query filters and required navigations
+
+> [!CAUTION]
+> Using required navigation to access entity which has global query filter defined may lead to unexpected results.
+
+Required navigations in EF imply that the related entity is always present. Since inner joins may be used to fetch related entities, if a required related entity is filtered out by the query filter, the parent entity may get filtered out as well. This can result in unexpectedly retrieving fewer elements than expected.
+
+To illustrate the problem, we can use `Blog` and `Post` entities and configure them as follows:
+
+[!code-csharp[Main](../../../samples/core/Querying/QueryFilters/QueryFiltersAndRequiredNavigations.cs#IncorrectFilter)]
+
+The model can be seeded with the following data:
+
+[!code-csharp[Main](../../../samples/core/Querying/QueryFilters/QueryFiltersAndRequiredNavigations.cs#SeedData)]
+
+The problem can be observed when executing the following two queries:
+
+[!code-csharp[Main](../../../samples/core/Querying/QueryFilters/QueryFiltersAndRequiredNavigations.cs#Queries)]
+
+With the above setup, the first query returns all 6 `Post` instances, but the second query returns only 3. This mismatch occurs because the `Include` method in the second query loads the related `Blog` entities. Since the navigation between `Blog` and `Post` is required, EF Core uses `INNER JOIN` when constructing the query:
+
+```sql
+SELECT [p].[PostId], [p].[BlogId], [p].[Content], [p].[IsDeleted], [p].[Title], [t].[BlogId], [t].[Name], [t].[Url]
+FROM [Posts] AS [p]
+INNER JOIN (
+    SELECT [b].[BlogId], [b].[Name], [b].[Url]
+    FROM [Blogs] AS [b]
+    WHERE [b].[Url] LIKE N'%fish%'
+) AS [t] ON [p].[BlogId] = [t].[BlogId]
+```
+
+Use of the `INNER JOIN` filters out all `Post` rows whose related `Blog` rows have been filtered out by a query filter. This problem can be addressed by configuring the navigation as optional navigation instead of required, causing EF to generate a `LEFT JOIN` instead of an `INNER JOIN`:
+
+[!code-csharp[Main](../../../samples/core/Querying/QueryFilters/QueryFiltersAndRequiredNavigations.cs#OptionalNavigation)]
+
+An alternative approach is to specify consistent filters on both `Blog` and `Post` entity types; once matching filters are applied to both `Blog` and `Post`, `Post` rows that could end up in unexpected state are removed and both queries return 3 results.
+
+[!code-csharp[Main](../../../samples/core/Querying/QueryFilters/QueryFiltersAndRequiredNavigations.cs#MatchingFilters)]
+
+## Query filters and IEntityTypeConfiguration
+
+If your query filter needs to access a tenant ID or similar contextual information, <xref:Microsoft.EntityFrameworkCore.IEntityTypeConfiguration`1> can pose an additional complication as unlike with `OnModelCreating`, there's no instance of your context type readily available to reference from the query filter. As a workaround, add a dummy context to your configuration type and reference that as follows:
+
+```c#
+private sealed class CustomerEntityConfiguration : IEntityTypeConfiguration<Customer>
+{
+    private readonly SomeDbContext _context = null!;
+
+    public void Configure(EntityTypeBuilder<Customer> builder)
+    {
+        builder.HasQueryFilter(d => d.TenantId == _context.TenantId);
+    }
+}
+```
+
+## Limitations
+
+Global query filters have the following limitations:
+
+* Filters can only be defined for the root entity type of an inheritance hierarchy.
+* Currently EF Core does not detect cycles in global query filter definitions, so you should be careful when defining them. If specified incorrectly, cycles could lead to infinite loops during query translation.
diff --git a/entity-framework/core/querying/how-query-works.md b/entity-framework/core/querying/how-query-works.md
new file mode 100644
index 0000000000..f19469a475
--- /dev/null
+++ b/entity-framework/core/querying/how-query-works.md
@@ -0,0 +1,42 @@
+---
+title: How Queries Work - EF Core
+description: General information on how Entity Framework Core internally compiles and executes queries
+author: SamMonoRT
+ms.date: 03/17/2020
+uid: core/querying/how-query-works
+---
+
+# How Queries Work
+
+Entity Framework Core uses Language Integrated Query (LINQ) to query data from the database. LINQ allows you to use C# (or your .NET language of choice) to write strongly typed queries based on your derived context and entity classes.
+
+> [!NOTE]
+> This article is out of date and some parts of it needs to be updated to account for changes happened in design of query pipeline. If you have any doubts about any behavior mentioned here, please [ask a question](https://github.com/dotnet/efcore/issues/new/choose).
+
+## The life of a query
+
+The following description is a high-level overview of the process each query goes through.
+
+1. The LINQ query is processed by Entity Framework Core to build a representation that is ready to be processed by the database provider
+   1. The result is cached so that this processing does not need to be done every time the query is executed
+2. The result is passed to the database provider
+   1. The database provider identifies which parts of the query can be evaluated in the database
+   2. These parts of the query are translated to database-specific query language (for example, SQL for a relational database)
+   3. A query is sent to the database and the result set returned (results are values from the database, not entity instances)
+3. For each item in the result set
+   1. If the query is a tracking query, EF checks if the data represents an entity already in the change tracker for the context instance
+      * If so, the existing entity is returned
+      * If not, a new entity is created, change tracking is set up, and the new entity is returned
+   2. If the query is a no-tracking query, then a new entity is always created and returned
+
+## When queries are executed
+
+When you call LINQ operators, you're simply building up an in-memory representation of the query. The query is only sent to the database when the results are consumed.
+
+The most common operations that result in the query being sent to the database are:
+
+* Iterating the results in a `for` loop
+* Using an operator such as `ToList`, `ToArray`, `Single`, `Count`, or the equivalent async overloads
+
+> [!WARNING]
+> **Always validate user input:** While EF Core protects against SQL injection attacks by using parameters and escaping literals in queries, it does not validate inputs. Appropriate validation, per the application's requirements, should be performed before values from un-trusted sources are used in LINQ queries, assigned to entity properties, or passed to other EF Core APIs. This includes any user input used to dynamically construct queries. Even when using LINQ, if you are accepting user input to build expressions, you need to make sure that only intended expressions can be constructed.
diff --git a/entity-framework/core/querying/index.md b/entity-framework/core/querying/index.md
new file mode 100644
index 0000000000..5fb484121a
--- /dev/null
+++ b/entity-framework/core/querying/index.md
@@ -0,0 +1,32 @@
+---
+title: Querying Data - EF Core
+description: Overview of information on querying in Entity Framework Core
+author: smitpatel
+ms.date: 10/03/2019
+uid: core/querying/index
+---
+# Querying Data
+
+Entity Framework Core uses Language-Integrated Query (LINQ) to query data from the database. LINQ allows you to use C# (or your .NET language of choice) to write strongly typed queries. It uses your derived context and entity classes to reference database objects. EF Core passes a representation of the LINQ query to the database provider. Database providers in turn translate it to database-specific query language (for example, SQL for a relational database). Queries are always executed against the database even if the entities returned in the result already exist in the context.
+
+> [!TIP]
+> You can view this article's [sample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Querying/Overview) on GitHub.
+
+The following snippets show a few examples of how to achieve common tasks with Entity Framework Core.
+
+## Loading all data
+
+[!code-csharp[Main](../../../samples/core/Querying/Overview/Program.cs#LoadingAllData)]
+
+## Loading a single entity
+
+[!code-csharp[Main](../../../samples/core/Querying/Overview/Program.cs#LoadingSingleEntity)]
+
+## Filtering
+
+[!code-csharp[Main](../../../samples/core/Querying/Overview/Program.cs#Filtering)]
+
+## Further readings
+
+- Learn more about [LINQ query expressions](/dotnet/csharp/programming-guide/concepts/linq/basic-linq-query-operations)
+- For more detailed information on how a query is processed in EF Core, see [How queries Work](xref:core/querying/how-query-works).
diff --git a/entity-framework/core/querying/null-comparisons.md b/entity-framework/core/querying/null-comparisons.md
new file mode 100644
index 0000000000..8e343bf30f
--- /dev/null
+++ b/entity-framework/core/querying/null-comparisons.md
@@ -0,0 +1,101 @@
+---
+title: Comparisons with null values in queries
+description: Information on how Entity Framework Core handles null comparisons in queries 
+author: maumar
+ms.date: 11/11/2020
+uid: core/querying/null-comparisons
+---
+# Query null semantics
+
+## Introduction
+
+SQL databases operate on 3-valued logic (`true`, `false`, `null`) when performing comparisons, as opposed to the boolean logic of C#. When translating LINQ queries to SQL, EF Core tries to compensate for the difference by introducing additional null checks for some elements of the query.
+To illustrate this, let's define the following entity:
+
+[!code-csharp[Main](../../../samples/core/Querying/NullSemantics/NullSemanticsEntity.cs#Entity)]
+
+and issue several queries:
+
+[!code-csharp[Main](../../../samples/core/Querying/NullSemantics/Program.cs#BasicExamples)]
+
+The first two queries produce simple comparisons. In the first query, both columns are non-nullable so null checks are not needed. In the second query, `NullableInt` could contain `null`, but `Id` is non-nullable; comparing `null` to non-null yields `null` as a result, which would be filtered out by `WHERE` operation. So no additional terms are needed either.
+
+```sql
+SELECT [e].[Id], [e].[Int], [e].[NullableInt], [e].[String1], [e].[String2]
+FROM [Entities] AS [e]
+WHERE [e].[Id] = [e].[Int]
+
+SELECT [e].[Id], [e].[Int], [e].[NullableInt], [e].[String1], [e].[String2]
+FROM [Entities] AS [e]
+WHERE [e].[Id] = [e].[NullableInt]
+```
+
+The third query introduces a null check. When `NullableInt` is `null` the comparison `Id <> NullableInt` yields `null`, which would be filtered out by `WHERE` operation. However, from the boolean logic perspective this case should be returned as part of the result. Hence EF Core adds the necessary check to ensure that.
+
+```sql
+SELECT [e].[Id], [e].[Int], [e].[NullableInt], [e].[String1], [e].[String2]
+FROM [Entities] AS [e]
+WHERE ([e].[Id] <> [e].[NullableInt]) OR [e].[NullableInt] IS NULL
+```
+
+Queries four and five show the pattern when both columns are nullable. It's worth noting that the `<>` operation produces more complicated (and potentially slower) query than the `==` operation.
+
+```sql
+SELECT [e].[Id], [e].[Int], [e].[NullableInt], [e].[String1], [e].[String2]
+FROM [Entities] AS [e]
+WHERE ([e].[String1] = [e].[String2]) OR ([e].[String1] IS NULL AND [e].[String2] IS NULL)
+
+SELECT [e].[Id], [e].[Int], [e].[NullableInt], [e].[String1], [e].[String2]
+FROM [Entities] AS [e]
+WHERE (([e].[String1] <> [e].[String2]) OR ([e].[String1] IS NULL OR [e].[String2] IS NULL)) AND ([e].[String1] IS NOT NULL OR [e].[String2] IS NOT NULL)
+```
+
+## Treatment of nullable values in functions
+
+Many functions in SQL can only return a `null` result if some of their arguments are `null`. EF Core takes advantage of this to produce more efficient queries.
+The query below illustrates the optimization:
+
+[!code-csharp[Main](../../../samples/core/Querying/NullSemantics/Program.cs#Functions)]
+
+The generated SQL is as follows (we don't need to evaluate the `SUBSTRING` function since it will be only null when either of the arguments to it is null.):
+
+```sql
+SELECT [e].[Id], [e].[Int], [e].[NullableInt], [e].[String1], [e].[String2]
+FROM [Entities] AS [e]
+WHERE [e].[String1] IS NULL OR [e].[String2] IS NULL
+```
+
+The optimization can also be used for user-defined functions. See [user defined function mapping](xref:core/querying/user-defined-function-mapping#configuring-nullability-of-user-defined-function-based-on-its-arguments) page for more details.
+
+## Writing performant queries
+
+- Comparing non-nullable columns is simpler and faster than comparing nullable columns. Consider marking columns as non-nullable whenever possible.
+
+- Checking for equality (`==`) is simpler and faster than checking for non-equality (`!=`), because query doesn't need to distinguish between `null` and `false` result. Use equality comparison whenever possible. However, simply negating `==` comparison is effectively the same as `!=`, so it doesn't result in performance improvement.
+
+- In some cases, it is possible to simplify a complex comparison by filtering out `null` values from a column explicitly - for example when no `null` values are present or these values are not relevant in the result. Consider the following example:
+
+[!code-csharp[Main](../../../samples/core/Querying/NullSemantics/Program.cs#ManualOptimization)]
+
+These queries produce the following SQL:
+
+```sql
+SELECT [e].[Id], [e].[Int], [e].[NullableInt], [e].[String1], [e].[String2]
+FROM [Entities] AS [e]
+WHERE ((([e].[String1] <> [e].[String2]) OR ([e].[String1] IS NULL OR [e].[String2] IS NULL)) AND ([e].[String1] IS NOT NULL OR [e].[String2] IS NOT NULL)) OR ((CAST(LEN([e].[String1]) AS int) = CAST(LEN([e].[String2]) AS int)) OR ([e].[String1] IS NULL AND [e].[String2] IS NULL))
+
+SELECT [e].[Id], [e].[Int], [e].[NullableInt], [e].[String1], [e].[String2]
+FROM [Entities] AS [e]
+WHERE ([e].[String1] IS NOT NULL AND [e].[String2] IS NOT NULL) AND (([e].[String1] <> [e].[String2]) OR (CAST(LEN([e].[String1]) AS int) = CAST(LEN([e].[String2]) AS int)))
+```
+
+In the second query, `null` results are filtered out from `String1` column explicitly. EF Core can safely treat the `String1` column as non-nullable during comparison, resulting in a simpler query.
+
+## Using relational null semantics
+
+It's possible to disable the null comparison compensation and use relational null semantics directly. This can be done by calling `UseRelationalNulls(true)` method on the options builder inside `OnConfiguring` method:
+
+[!code-csharp[Main](../../../samples/core/Querying/NullSemantics/NullSemanticsContext.cs#UseRelationalNulls)]
+
+> [!WARNING]
+> When using relational null semantics, your LINQ queries no longer have the same meaning as they do in C#, and may yield different results than expected. Exercise caution when using this mode.
diff --git a/entity-framework/core/querying/pagination.md b/entity-framework/core/querying/pagination.md
new file mode 100644
index 0000000000..eec9c64c29
--- /dev/null
+++ b/entity-framework/core/querying/pagination.md
@@ -0,0 +1,61 @@
+---
+title: Pagination - EF Core
+description: Writing paginating queries in Entity Framework Core
+author: roji
+ms.date: 12/19/2021
+uid: core/querying/pagination
+---
+# Pagination
+
+Pagination refers to retrieving results in pages, rather than all at once; this is typically done for large resultsets, where a user interface is shown that allows the user to navigate to the next or previous page of the results.
+
+> [!WARNING]
+> Regardless of the pagination method used, always make sure that your ordering is fully unique. For example, if results are ordered only by date, but there can be multiple results with the same date, then results could be skipped when paginating as they're ordered differently across two paginating queries. Ordering by both date and ID (or any other unique property or combination of properties) makes the ordering fully unique and avoids this problem. Note that relational databases do not apply any ordering by default, even on the primary key.
+
+> [!NOTE]
+> Azure Cosmos DB has its own mechanism for pagination, [see the dedicated documentation page](xref:core/providers/cosmos/querying#pagination).
+
+## Offset pagination
+
+A common way to implement pagination with databases is to use the `Skip` and `Take` LINQ operators (`OFFSET` and `LIMIT` in SQL). Given a page size of 10 results, the third page can be fetched with EF Core as follows:
+
+[!code-csharp[Main](../../../samples/core/Querying/Pagination/Program.cs?name=OffsetPagination&highlight=4)]
+
+Unfortunately, while this technique is very intuitive, it also has some severe shortcomings:
+
+1. The database must still process the first 20 entries, even if they aren't returned to the application; this creates possibly significant computation load that increases with the number of rows being skipped.
+2. If any updates occur concurrently, your pagination may end up skipping certain entries or showing them twice. For example, if an entry is removed as the user is moving from page 2 to 3, the whole resultset "shifts up", and one entry would be skipped.
+
+## Keyset pagination
+
+The recommended alternative to offset-based pagination - sometimes called *keyset pagination* or *seek-based pagination* - is to simply use a `WHERE` clause to skip rows, instead of an offset. This means remember the relevant values from the last entry fetched (instead of its offset), and to ask for the next rows after that row. For example, assuming the last entry in the last page we fetched had an ID value of 55, we'd simply do the following:
+
+[!code-csharp[Main](../../../samples/core/Querying/Pagination/Program.cs?name=KeySetPagination&highlight=4)]
+
+Assuming an index is defined on `PostId`, this query is very efficient, and also isn't sensitive to any concurrent changes happening in lower Id values.
+
+Keyset pagination is appropriate for pagination interfaces where the user navigates forwards and backwards, but does not support random access, where the user can jump to any specific page. Random access pagination requires using offset pagination as explained above; because of the shortcomings of offset pagination, carefully consider if random access pagination really is required for your use case, or if next/previous page navigation is enough. If random access pagination is necessary, a robust implementation could use keyset pagination when navigating to the next/previous page, and offset navigation when jumping to any other page.
+
+### Multiple pagination keys
+
+When using keyset pagination, it's frequently necessary to order by more than one property. For example, the following query paginates by date and ID:
+
+[!code-csharp[Main](../../../samples/core/Querying/Pagination/Program.cs?name=KeySetPaginationWithMultipleKeys&highlight=6)]
+
+This ensures that the next page picks off exactly where the previous one ended. As more ordering keys are added, additional clauses can be added.
+
+> [!NOTE]
+> Most SQL databases support a simpler and more efficient version of the above, using *row values*: `WHERE (Date, Id) > (@lastDate, @lastId)`. EF Core does not currently support expressing this in LINQ queries, this is tracked by [#26822](https://github.com/dotnet/efcore/issues/26822).
+
+## Indexes
+
+As with any other query, proper indexing is vital for good performance: make sure to have indexes in place which correspond to your pagination ordering. If ordering by more than one column, an index over those multiple columns can be defined; this is called a *composite index*.
+
+For more information, [see the documentation page on indexes](xref:core/modeling/indexes).
+
+## Additional resources
+
+* To learn more about the shortcomings of offset-based pagination and about keyset pagination, [see this post](https://use-the-index-luke.com/no-offset).
+* [.NET Data Community Standup session](https://www.youtube.com/watch?v=DIKH-q-gJNU) where we discuss pagination and demo all the above concepts.
+* [A technical deep dive presentation](https://www.slideshare.net/MarkusWinand/p2d2-pagination-done-the-postgresql-way) comparing offset and keyset pagination. While the content deals with the PostgreSQL database, the general information is valid for other relational databases as well.
+* For extensions on top of EF Core which simplify keyset pagination, see [MR.EntityFrameworkCore.KeysetPagination](https://github.com/mrahhal/MR.EntityFrameworkCore.KeysetPagination) and [MR.AspNetCore.Pagination](https://github.com/mrahhal/MR.AspNetCore.Pagination).
diff --git a/entity-framework/core/querying/related-data/eager.md b/entity-framework/core/querying/related-data/eager.md
new file mode 100644
index 0000000000..49886b9a89
--- /dev/null
+++ b/entity-framework/core/querying/related-data/eager.md
@@ -0,0 +1,157 @@
+---
+title: Eager Loading of Related Data - EF Core
+description: Eager loading of related data with Entity Framework Core
+author: roji
+ms.date: 11/11/2021
+uid: core/querying/related-data/eager
+---
+# Eager Loading of Related Data
+
+## Eager loading
+
+You can use the `Include` method to specify related data to be included in query results. In the following example, the blogs that are returned in the results will have their `Posts` property populated with the related posts.
+
+[!code-csharp[Main](../../../../samples/core/Querying/RelatedData/Program.cs#SingleInclude)]
+
+> [!TIP]
+> Entity Framework Core will automatically fix-up navigation properties to any other entities that were previously loaded into the context instance. So even if you don't explicitly include the data for a navigation property, the property may still be populated if some or all of the related entities were previously loaded.
+
+You can include related data from multiple relationships in a single query.
+
+[!code-csharp[Main](../../../../samples/core/Querying/RelatedData/Program.cs#MultipleIncludes)]
+
+> [!CAUTION]
+> Eager loading a collection navigation in a single query may cause performance issues. For more information, see [Single vs. split queries](xref:core/querying/single-split-queries).
+
+## Including multiple levels
+
+You can drill down through relationships to include multiple levels of related data using the `ThenInclude` method. The following example loads all blogs, their related posts, and the author of each post.
+
+[!code-csharp[Main](../../../../samples/core/Querying/RelatedData/Program.cs#SingleThenInclude)]
+
+You can chain multiple calls to `ThenInclude` to continue including further levels of related data.
+
+[!code-csharp[Main](../../../../samples/core/Querying/RelatedData/Program.cs#MultipleThenIncludes)]
+
+You can combine all of the calls to include related data from multiple levels and multiple roots in the same query.
+
+[!code-csharp[Main](../../../../samples/core/Querying/RelatedData/Program.cs#IncludeTree)]
+
+You may want to include multiple related entities for one of the entities that is being included. For example, when querying `Blogs`, you include `Posts` and then want to include both the `Author` and `Tags` of the `Posts`. To include both, you need to specify each include path starting at the root. For example, `Blog -> Posts -> Author` and `Blog -> Posts -> Tags`. It doesn't mean you'll get redundant joins; in most cases, EF will combine the joins when generating SQL.
+
+[!code-csharp[Main](../../../../samples/core/Querying/RelatedData/Program.cs#MultipleLeafIncludes)]
+
+> [!TIP]
+> You can also load multiple navigations using a single `Include` method. This is possible for navigation "chains" that are all references, or when they end with a single collection.
+
+[!code-csharp[Main](../../../../samples/core/Querying/RelatedData/Program.cs#IncludeMultipleNavigationsWithSingleInclude)]
+
+## Filtered include
+
+When applying Include to load related data, you can add certain enumerable operations to the included collection navigation, which allows for filtering and sorting of the results.
+
+Supported operations are: `Where`, `OrderBy`, `OrderByDescending`, `ThenBy`, `ThenByDescending`, `Skip`, and `Take`.
+
+Such operations should be applied on the collection navigation in the lambda passed to the Include method, as shown in example below:
+
+[!code-csharp[Main](../../../../samples/core/Querying/RelatedData/Program.cs#FilteredInclude)]
+
+Each included navigation allows only one unique set of filter operations. In cases where multiple Include operations are applied for a given collection navigation (`blog.Posts` in the examples below), filter operations can only be specified on one of them:
+
+[!code-csharp[Main](../../../../samples/core/Querying/RelatedData/Program.cs#MultipleLeafIncludesFiltered1)]
+
+Alternatively, identical operations can be applied for each navigation that is included multiple times:
+
+[!code-csharp[Main](../../../../samples/core/Querying/RelatedData/Program.cs#MultipleLeafIncludesFiltered2)]
+
+> [!CAUTION]
+> In case of tracking queries, results of Filtered Include may be unexpected due to [navigation fixup](xref:core/querying/tracking). All relevant entities that have been queried for previously and have been stored in the Change Tracker will be present in the results of Filtered Include query, even if they don't meet the requirements of the filter. Consider using `NoTracking` queries or re-create the DbContext when using Filtered Include in those situations.
+
+Example:
+
+```csharp
+var orders = await context.Orders.Where(o => o.Id > 1000).ToListAsync();
+
+// customer entities will have references to all orders where Id > 1000, rather than > 5000
+var filtered = await context.Customers.Include(c => c.Orders.Where(o => o.Id > 5000)).ToListAsync();
+```
+
+> [!NOTE]
+> In case of tracking queries, the navigation on which filtered include was applied is considered to be loaded. This means that EF Core will not attempt to re-load its values using [explicit loading](xref:core/querying/related-data/explicit) or [lazy loading](xref:core/querying/related-data/lazy), even though some elements could still be missing.
+
+## Include on derived types
+
+You can include related data from navigation defined only on a derived type using `Include` and `ThenInclude`.
+
+Given the following model:
+
+```csharp
+public class SchoolContext : DbContext
+{
+    public DbSet<Person> People { get; set; }
+    public DbSet<School> Schools { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<School>().HasMany(s => s.Students).WithOne(s => s.School);
+    }
+}
+
+public class Person
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+}
+
+public class Student : Person
+{
+    public School School { get; set; }
+}
+
+public class School
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+
+    public List<Student> Students { get; set; }
+}
+```
+
+Contents of `School` navigation of all People who are Students can be eagerly loaded using many patterns:
+
+* Using cast
+
+  ```csharp
+  context.People.Include(person => ((Student)person).School).ToList()
+  ```
+
+* Using `as` operator
+
+  ```csharp
+  context.People.Include(person => (person as Student).School).ToList()
+  ```
+
+* Using overload of `Include` that takes parameter of type `string`
+
+  ```csharp
+  context.People.Include("School").ToList()
+  ```
+
+## Model configuration for auto-including navigations
+
+You can configure a navigation in the model to be included every time the entity is loaded from the database using `AutoInclude` method. It has same effect as specifying `Include` with the navigation in every query where the entity type is returned in the results. Following example shows how to configure a navigation to be automatically included.
+
+[!code-csharp[Main](../../../../samples/core/Querying/RelatedData/BloggingContext.cs#AutoInclude)]
+
+After above configuration, running a query like below will load `ColorScheme` navigation for all the themes in the results.
+
+[!code-csharp[Main](../../../../samples/core/Querying/RelatedData/Program.cs#AutoIncludes)]
+
+This configuration is applied on every entity returned in the result no matter how it appeared in the results. That means if an entity is in the result because of use of a navigation, using `Include` over another entity type or auto-include configuration, it will load all the auto-included navigations for it. The same rule extends to the navigations configured as auto-included on derived type of the entity.
+
+If for a particular query you don't want to load the related data through a navigation, which is configured at model level to be auto-included, you can use `IgnoreAutoIncludes` method in your query. Using this method will stop loading all the navigations configured as auto-include by the user. Running a query like below will bring back all themes from database but won't load `ColorScheme` even though it's configured as auto-included navigation.
+
+[!code-csharp[Main](../../../../samples/core/Querying/RelatedData/Program.cs#IgnoreAutoIncludes)]
+
+> [!NOTE]
+> Navigations to owned types are also configured as auto-included by convention and using `IgnoreAutoIncludes` API doesn't stop them from being included. They will still be included in query results.
diff --git a/entity-framework/core/querying/related-data/explicit.md b/entity-framework/core/querying/related-data/explicit.md
new file mode 100644
index 0000000000..3a3e25caac
--- /dev/null
+++ b/entity-framework/core/querying/related-data/explicit.md
@@ -0,0 +1,28 @@
+---
+title: Explicit Loading of Related Data - EF Core
+description: Explicit loading of related data with Entity Framework Core
+author: roji
+ms.date: 9/8/2020
+uid: core/querying/related-data/explicit
+---
+# Explicit Loading of Related Data
+
+## Explicit loading
+
+You can explicitly load a navigation property via the `DbContext.Entry(...)` API.
+
+[!code-csharp[Main](../../../../samples/core/Querying/RelatedData/Program.cs#Explicit)]
+
+You can also explicitly load a navigation property by executing a separate query that returns the related entities. If change tracking is enabled, then when a query materializes an entity, EF Core will automatically set the navigation properties of the newly-loaded entity to refer to any entities already loaded, and set the navigation properties of the already-loaded entities to refer to the newly loaded entity.
+
+## Querying related entities
+
+You can also get a LINQ query that represents the contents of a navigation property.
+
+This allows you to apply other operators over the query. For example, applying an aggregate operator over the related entities without loading them into memory.
+
+[!code-csharp[Main](../../../../samples/core/Querying/RelatedData/Program.cs#NavQueryAggregate)]
+
+You can also filter which related entities are loaded into memory.
+
+[!code-csharp[Main](../../../../samples/core/Querying/RelatedData/Program.cs#NavQueryFiltered)]
diff --git a/entity-framework/core/querying/related-data/index.md b/entity-framework/core/querying/related-data/index.md
new file mode 100644
index 0000000000..507a72cc3f
--- /dev/null
+++ b/entity-framework/core/querying/related-data/index.md
@@ -0,0 +1,17 @@
+---
+title: Loading Related Data - EF Core
+description: Different strategies for loading related data with Entity Framework Core
+author: roji
+ms.date: 9/11/2020
+uid: core/querying/related-data
+---
+# Loading Related Data
+
+Entity Framework Core allows you to use the navigation properties in your model to load related entities. There are three common O/RM patterns used to load related data.
+
+* **[Eager loading](xref:core/querying/related-data/eager)** means that the related data is loaded from the database as part of the initial query.
+* **[Explicit loading](xref:core/querying/related-data/explicit)** means that the related data is explicitly loaded from the database at a later time.
+* **[Lazy loading](xref:core/querying/related-data/lazy)** means that the related data is transparently loaded from the database when the navigation property is accessed.
+
+> [!TIP]
+> You can view the [samples](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Querying/RelatedData) under this section on GitHub.
diff --git a/entity-framework/core/querying/related-data/lazy.md b/entity-framework/core/querying/related-data/lazy.md
new file mode 100644
index 0000000000..5c3e8ac2f8
--- /dev/null
+++ b/entity-framework/core/querying/related-data/lazy.md
@@ -0,0 +1,186 @@
+---
+title: Lazy Loading of Related Data - EF Core
+description: Lazy loading of related data with Entity Framework Core
+author: roji
+ms.date: 9/8/2020
+uid: core/querying/related-data/lazy
+ms.custom: sfi-ropc-nochange
+---
+# Lazy Loading of Related Data
+
+## Lazy loading with proxies
+
+The simplest way to use lazy-loading is by installing the [Microsoft.EntityFrameworkCore.Proxies](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Proxies/) package and enabling it with a call to `UseLazyLoadingProxies`. For example:
+
+```csharp
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    => optionsBuilder
+        .UseLazyLoadingProxies()
+        .UseSqlServer(myConnectionString);
+```
+
+Or when using AddDbContext:
+
+```csharp
+.AddDbContext<BloggingContext>(
+    b => b.UseLazyLoadingProxies()
+          .UseSqlServer(myConnectionString));
+```
+
+EF Core will then enable lazy loading for any navigation property that can be overridden--that is, it must be `virtual` and on a class that can be inherited from. For example, in the following entities, the `Post.Blog` and `Blog.Posts` navigation properties will be lazy-loaded.
+
+```csharp
+public class Blog
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+
+    public virtual ICollection<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public virtual Blog Blog { get; set; }
+}
+```
+
+> [!WARNING]
+> Lazy loading can cause unneeded extra database roundtrips to occur (the so-called N+1 problem), and care should be taken to avoid this. See the [performance section](xref:core/performance/efficient-querying#beware-of-lazy-loading) for more details.
+
+## Lazy loading without proxies
+
+Lazy-loading without proxies work by injecting the `ILazyLoader` service into an entity, as described in [Entity Type Constructors](xref:core/modeling/constructors). For example:
+
+```csharp
+public class Blog
+{
+    private ICollection<Post> _posts;
+
+    public Blog()
+    {
+    }
+
+    private Blog(ILazyLoader lazyLoader)
+    {
+        LazyLoader = lazyLoader;
+    }
+
+    private ILazyLoader LazyLoader { get; set; }
+
+    public int Id { get; set; }
+    public string Name { get; set; }
+
+    public ICollection<Post> Posts
+    {
+        get => LazyLoader.Load(this, ref _posts);
+        set => _posts = value;
+    }
+}
+
+public class Post
+{
+    private Blog _blog;
+
+    public Post()
+    {
+    }
+
+    private Post(ILazyLoader lazyLoader)
+    {
+        LazyLoader = lazyLoader;
+    }
+
+    private ILazyLoader LazyLoader { get; set; }
+
+    public int Id { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public Blog Blog
+    {
+        get => LazyLoader.Load(this, ref _blog);
+        set => _blog = value;
+    }
+}
+```
+
+This method doesn't require entity types to be inherited from or navigation properties to be virtual, and allows entity instances created with `new` to lazy-load once attached to a context. However, it requires a reference to the `ILazyLoader` service, which is defined in the [Microsoft.EntityFrameworkCore.Abstractions](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Abstractions/) package. This package contains a minimal set of types so that there is little impact in depending on it. However, to completely avoid depending on any EF Core packages in the entity types, it's possible to inject the `ILazyLoader.Load` method as a delegate. For example:
+
+```csharp
+public class Blog
+{
+    private ICollection<Post> _posts;
+
+    public Blog()
+    {
+    }
+
+    private Blog(Action<object, string> lazyLoader)
+    {
+        LazyLoader = lazyLoader;
+    }
+
+    private Action<object, string> LazyLoader { get; set; }
+
+    public int Id { get; set; }
+    public string Name { get; set; }
+
+    public ICollection<Post> Posts
+    {
+        get => LazyLoader.Load(this, ref _posts);
+        set => _posts = value;
+    }
+}
+
+public class Post
+{
+    private Blog _blog;
+
+    public Post()
+    {
+    }
+
+    private Post(Action<object, string> lazyLoader)
+    {
+        LazyLoader = lazyLoader;
+    }
+
+    private Action<object, string> LazyLoader { get; set; }
+
+    public int Id { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public Blog Blog
+    {
+        get => LazyLoader.Load(this, ref _blog);
+        set => _blog = value;
+    }
+}
+```
+
+The code above uses a `Load` extension method to make using the delegate a bit cleaner:
+
+```csharp
+public static class PocoLoadingExtensions
+{
+    public static TRelated Load<TRelated>(
+        this Action<object, string> loader,
+        object entity,
+        ref TRelated navigationField,
+        [CallerMemberName] string navigationName = null)
+        where TRelated : class
+    {
+        loader?.Invoke(entity, navigationName);
+
+        return navigationField;
+    }
+}
+```
+
+> [!NOTE]
+> The constructor parameter for the lazy-loading delegate must be called "lazyLoader". Configuration to use a different name than this is planned for a future release.
diff --git a/entity-framework/core/querying/related-data/serialization.md b/entity-framework/core/querying/related-data/serialization.md
new file mode 100644
index 0000000000..0ca8641729
--- /dev/null
+++ b/entity-framework/core/querying/related-data/serialization.md
@@ -0,0 +1,53 @@
+---
+title: Related Data and Serialization - EF Core
+description: Information about how cycles in related data with Entity Framework Core can affect serialization frameworks
+author: roji
+ms.date: 9/8/2020
+uid: core/querying/related-data/serialization
+---
+# Related data and serialization
+
+Because EF Core automatically does fix-up of navigation properties, you can end up with cycles in your object graph. For example, loading a blog and its related posts will result in a blog object that references a collection of posts. Each of those posts will have a reference back to the blog.
+
+Some serialization frameworks don't allow such cycles. For example, Json.NET will throw the following exception if a cycle is found.
+
+> Newtonsoft.Json.JsonSerializationException: Self referencing loop detected for property 'Blog' with type 'MyApplication.Models.Blog'.
+
+System.Text.Json will throw a similar exception if a cycle is found.
+
+> System.Text.Json.JsonException: A possible object cycle was detected. This can either be due to a cycle or if the object depth is larger than the maximum allowed depth of 32. Consider using ReferenceHandler.Preserve on JsonSerializerOptions to support cycles.
+
+If you're using Json.NET in ASP.NET Core, you can configure Json.NET to ignore cycles that it finds in the object graph. This configuration is done in the `ConfigureServices(...)` method in `Startup.cs`.
+
+```csharp
+public void ConfigureServices(IServiceCollection services)
+{
+    ...
+
+    services.AddMvc()
+        .AddJsonOptions(
+            options => options.SerializerSettings.ReferenceLoopHandling = Newtonsoft.Json.ReferenceLoopHandling.Ignore
+        );
+
+    ...
+}
+```
+
+If you're using System.Text.Json, you can configure it like this.
+
+```csharp
+public void ConfigureServices(IServiceCollection services)
+{
+    ...
+
+    services.AddControllers()
+        .AddJsonOptions(options =>
+        {
+            options.JsonSerializerOptions.ReferenceHandler = ReferenceHandler.IgnoreCycles;
+        });
+
+    ...
+}
+```
+
+Another alternative is to ignore the navigation properties that cause the cycle for JSON serialization. If you're using Json.NET, you can decorate one of the navigation properties with the `[JsonIgnore]` attribute, which instructs Json.NET to not traverse that navigation property while serializing. For System.Text.Json, you can use the `[JsonIgnore]` attribute in the `System.Text.Json.Serialization` namespace to achieve the same effect.
diff --git a/entity-framework/core/querying/single-split-queries.md b/entity-framework/core/querying/single-split-queries.md
new file mode 100644
index 0000000000..99ca263204
--- /dev/null
+++ b/entity-framework/core/querying/single-split-queries.md
@@ -0,0 +1,142 @@
+---
+title: Single vs. Split Queries - EF Core
+description: Translating LINQ queries into single and split SQL queries with Entity Framework Core
+author: roji
+ms.date: 1/9/2023
+uid: core/querying/single-split-queries
+---
+# Single vs. Split Queries
+
+## Performance issues with single queries
+
+When working against relational databases, EF loads related entities by introducing JOINs into a single query. While JOINs are quite standard when using SQL, they can create significant performance issues if used improperly. This page describes these performance issues, and shows an alternative way to load related entities which works around them.
+
+### Cartesian explosion
+
+Let's examine the following LINQ query and its translated SQL equivalent:
+
+```c#
+var blogs = await ctx.Blogs
+    .Include(b => b.Posts)
+    .Include(b => b.Contributors)
+    .ToListAsync();
+```
+
+```sql
+SELECT [b].[Id], [b].[Name], [p].[Id], [p].[BlogId], [p].[Title], [c].[Id], [c].[BlogId], [c].[FirstName], [c].[LastName]
+FROM [Blogs] AS [b]
+LEFT JOIN [Posts] AS [p] ON [b].[Id] = [p].[BlogId]
+LEFT JOIN [Contributors] AS [c] ON [b].[Id] = [c].[BlogId]
+ORDER BY [b].[Id], [p].[Id]
+```
+
+In this example, since both `Posts` and `Contributors` are collection navigations of `Blog` - they're at the same level - relational databases return a *cross product*: each row from `Posts` is joined with each row from `Contributors`. This means that if a given blog has 10 posts and 10 contributors, the database returns 100 rows for that single blog. This phenomenon - sometimes called *cartesian explosion* - can cause huge amounts of data to unintentionally get transferred to the client, especially as more sibling JOINs are added to the query; this can be a major performance issue in database applications.
+
+Note that cartesian explosion does not occur when the two JOINs aren't at the same level:
+
+```c#
+var blogs = await ctx.Blogs
+    .Include(b => b.Posts)
+    .ThenInclude(p => p.Comments)
+    .ToListAsync();
+```
+
+```sql
+SELECT [b].[Id], [b].[Name], [t].[Id], [t].[BlogId], [t].[Title], [t].[Id0], [t].[Content], [t].[PostId]
+FROM [Blogs] AS [b]
+LEFT JOIN [Posts] AS [p] ON [b].[Id] = [p].[BlogId]
+LEFT JOIN [Comment] AS [c] ON [p].[Id] = [c].[PostId]
+ORDER BY [b].[Id], [t].[Id]
+```
+
+In this query, `Comments` is a collection navigation of `Post`, unlike `Contributors` in the previous query, which was a collection navigation of `Blog`. In this case, a single row is returned for each comment that a blog has (through its posts), and a cross product does not occur.
+
+### Data duplication
+
+JOINs can create another type of performance issue. Let's examine the following query, which only loads a single collection navigation:
+
+```c#
+var blogs = await ctx.Blogs
+    .Include(b => b.Posts)
+    .ToListAsync();
+```
+
+```sql
+SELECT [b].[Id], [b].[Name], [b].[HugeColumn], [p].[Id], [p].[BlogId], [p].[Title]
+FROM [Blogs] AS [b]
+LEFT JOIN [Posts] AS [p] ON [b].[Id] = [p].[BlogId]
+ORDER BY [b].[Id]
+```
+
+Examining at the projected columns, each row returned by this query contains properties from both the `Blogs` and `Posts` tables; this means that the blog properties are duplicated for each post that the blog has. While this is usually normal and causes no issues, if the `Blogs` table happens to have a very big column (e.g. binary data, or a huge text), that column would get duplicated and sent back to the client multiple times. This can significantly increase network traffic and adversely affect your application's performance.
+
+If you don't actually need the huge column, it's easy to simply not query for it:
+
+```c#
+var blogs = await ctx.Blogs
+    .Select(b => new
+    {
+        b.Id,
+        b.Name,
+        b.Posts
+    })
+    .ToListAsync();
+```
+
+By using a projection to explicitly choose which columns you want, you can omit big columns and improve performance; note that this is a good idea regardless of data duplication, so consider doing it even when not loading a collection navigation. However, since this projects the blog to an anonymous type, the blog isn't tracked by EF and changes to it can't be saved back as usual.
+
+It's worth noting that unlike cartesian explosion, the data duplication caused by JOINs isn't typically significant, as the duplicated data size is negligible; this typically is something to worry about only if you have big columns in your principal table.
+
+## Split queries
+
+To work around the performance issues described above, EF allows you to specify that a given LINQ query should be *split* into multiple SQL queries. Instead of JOINs, split queries generate an additional SQL query for each included collection navigation:
+
+[!code-csharp[Main](../../../samples/core/Querying/RelatedData/Program.cs?name=AsSplitQuery&highlight=5)]
+
+It will produce the following SQL:
+
+```sql
+SELECT [b].[BlogId], [b].[OwnerId], [b].[Rating], [b].[Url]
+FROM [Blogs] AS [b]
+ORDER BY [b].[BlogId]
+
+SELECT [p].[PostId], [p].[AuthorId], [p].[BlogId], [p].[Content], [p].[Rating], [p].[Title], [b].[BlogId]
+FROM [Blogs] AS [b]
+INNER JOIN [Posts] AS [p] ON [b].[BlogId] = [p].[BlogId]
+ORDER BY [b].[BlogId]
+```
+
+> [!WARNING]
+> When using split queries with Skip/Take on EF versions prior to 10, pay special attention to making your query ordering fully unique; not doing so could cause incorrect data to be returned. For example, if results are ordered only by date, but there can be multiple results with the same date, then each one of the split queries could each get different results from the database. Ordering by both date and ID (or any other unique property or combination of properties) makes the ordering fully unique and avoids this problem. Note that relational databases do not apply any ordering by default, even on the primary key.
+
+> [!NOTE]
+> One-to-one related entities are always loaded via JOINs in the same query, as it has no performance impact.
+
+## Enabling split queries globally
+
+You can also configure split queries as the default for your application's context:
+
+[!code-csharp[Main](../../../samples/core/Querying/RelatedData/SplitQueriesBloggingContext.cs?name=QuerySplittingBehaviorSplitQuery&highlight=6)]
+
+When split queries are configured as the default, it's still possible to configure specific queries to execute as single queries:
+
+[!code-csharp[Main](../../../samples/core/Querying/RelatedData/Program.cs?name=AsSingleQuery&highlight=5)]
+
+EF Core uses single query mode by default in the absence of any configuration. Since it may cause performance issues, EF Core generates a warning whenever following conditions are met:
+
+- EF Core detects that the query loads multiple collections.
+- User hasn't configured query splitting mode globally.
+- User hasn't used `AsSingleQuery`/`AsSplitQuery` operator on the query.
+
+To turn off the warning, configure query splitting mode globally or at the query level to an appropriate value.
+
+## Characteristics of split queries
+
+While split query avoids the performance issues associated with JOINs and cartesian explosion, it also has some drawbacks:
+
+- While most databases guarantee data consistency for single queries, no such guarantees exist for multiple queries. If the database is updated concurrently when executing your queries, resulting data may not be consistent. You can mitigate it by wrapping the queries in a serializable or snapshot transaction, although doing so may create performance issues of its own. For more information, see your database's documentation.
+- Each query currently implies an additional network roundtrip to your database. Multiple network roundtrips can degrade performance, especially where latency to the database is high (for example, cloud services).
+- While some databases allow consuming the results of multiple queries at the same time (SQL Server with MARS, Sqlite), most allow only a single query to be active at any given point. So all results from earlier queries must be buffered in your application's memory before executing later queries, which leads to increased memory requirements.
+- When including reference navigations as well as collection navigations, each one of the split queries will include joins to the reference navigations. This can degrade performance, particularly if there are many reference navigations. Please upvote [#29182](https://github.com/dotnet/efcore/issues/29182) if this is something you'd like to see fixed.
+
+Unfortunately, there isn't one strategy for loading related entities that fits all scenarios. Carefully consider the advantages and disadvantages of single and split queries to select the one that fits your needs.
diff --git a/entity-framework/core/querying/sql-queries.md b/entity-framework/core/querying/sql-queries.md
new file mode 100644
index 0000000000..c30f503e5f
--- /dev/null
+++ b/entity-framework/core/querying/sql-queries.md
@@ -0,0 +1,272 @@
+---
+title: SQL Queries - EF Core
+description: Using SQL queries in Entity Framework Core
+author: smitpatel
+ms.date: 09/19/2022
+uid: core/querying/sql-queries
+---
+# SQL Queries
+
+Entity Framework Core allows you to drop down to SQL queries when working with a relational database. SQL queries are useful if the query you want can't be expressed using LINQ, or if a LINQ query causes EF to generate inefficient SQL. SQL queries can return regular entity types or [keyless entity types](xref:core/modeling/keyless-entity-types) that are part of your model.
+
+## Basic SQL queries
+
+You can use <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.FromSql*> to begin a LINQ query based on a SQL query:
+
+```csharp
+var blogs = await context.Blogs
+    .FromSql($"SELECT * FROM dbo.Blogs")
+    .ToListAsync();
+```
+
+> [!NOTE]
+>
+> <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.FromSql*> was introduced in EF Core 7.0. When using older versions, use <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.FromSqlInterpolated*> instead.
+
+SQL queries can be used to execute a stored procedure which returns entity data:
+
+```csharp
+var blogs = await context.Blogs
+    .FromSql($"EXECUTE dbo.GetMostPopularBlogs")
+    .ToListAsync();
+```
+
+> [!NOTE]
+>
+> <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.FromSql*> can only be used directly on a `DbSet`. It cannot be composed over an arbitrary LINQ query.
+
+## Passing parameters
+
+> [!WARNING]
+> **Pay close attention to parameterization when using SQL queries**
+>
+> When introducing any user-provided values into a SQL query, care must be taken to avoid SQL injection attacks. SQL injection occurs when a program integrates a user-provided string value into a SQL query, and the user-provided value is crafted to terminate the string and perform another malicious SQL operation. To learn more about SQL injection, [see this page](/sql/relational-databases/security/sql-injection).
+>
+> The <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.FromSql*> and <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.FromSqlInterpolated*> methods are safe against SQL injection, and always integrate parameter data as a separate SQL parameter. However, the <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.FromSqlRaw*> method can be vulnerable to SQL injection attacks, if improperly used. See below for more details.
+
+The following example passes a single parameter to a stored procedure by including a parameter placeholder in the SQL query string and providing an additional argument:
+
+```csharp
+var user = "johndoe";
+
+var blogs = await context.Blogs
+    .FromSql($"EXECUTE dbo.GetMostPopularBlogsForUser {user}")
+    .ToListAsync();
+```
+
+While this syntax may look like regular C# [string interpolation](/dotnet/csharp/language-reference/tokens/interpolated), the supplied value is wrapped in a `DbParameter` and the generated parameter name inserted where the `{0}` placeholder was specified. This makes <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.FromSql*> safe from SQL injection attacks, and sends the value efficiently and correctly to the database.
+
+When executing stored procedures, it can be useful to use named parameters in the SQL query string, especially when the stored procedure has optional parameters:
+
+```csharp
+var user = new SqlParameter("user", "johndoe");
+
+var blogs = await context.Blogs
+    .FromSql($"EXECUTE dbo.GetMostPopularBlogsForUser @filterByUser={user}")
+    .ToListAsync();
+```
+
+If you need more control over the database parameter being sent, you can also construct a `DbParameter` and supply it as a parameter value. This allows you to set the precise database type of the parameter, or facets such as its size, precision or length:
+
+```csharp
+var user = new SqlParameter("user", "johndoe");
+
+var blogs = await context.Blogs
+    .FromSql($"EXECUTE dbo.GetMostPopularBlogsForUser {user}")
+    .ToListAsync();
+```
+
+> [!NOTE]
+>
+> The parameters you pass must exactly match the stored procedure definition. Pay special attention to the ordering of the parameters, taking care to not miss or misplace any of them - or consider using named parameter notation. Also, make sure the parameter types correspond, and that their facets (size, precision, scale) are set as needed.
+
+### Dynamic SQL and parameters
+
+<xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.FromSql*> and its parameterization should be used wherever possible. However, there are certain scenarios where SQL needs to be dynamically pieced together, and database parameters cannot be used. For example, let's assume that a C# variable holds the name of the a property to be filtered by. It may be tempting to use a SQL query such as the following:
+
+```c#
+var propertyName = "User";
+var propertyValue = "johndoe";
+
+var blogs = await context.Blogs
+    .FromSql($"SELECT * FROM [Blogs] WHERE {propertyName} = {propertyValue}")
+    .ToListAsync();
+```
+
+This code doesn't work, since databases do not allow parameterizing column names (or any other part of the schema).
+
+First, it's important to consider the implications of dynamically constructing a query - via SQL or otherwise. Accepting a column name from a user may allow them to choose a column that isn't indexed, making the query run extremely slowly and overload your database; or it may allow them to choose a column containing data you don't want exposed. Except for truly dynamic scenarios, it's usually better to have two queries for two column names, rather than using parameterization to collapse them into a single query.
+
+If you've decided you do want to dynamically construct your SQL, you'll have to use <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.FromSqlRaw*>, which allows interpolating variable data directly into the SQL string, instead of using a database parameter:
+
+```csharp
+var columnName = "Url";
+var columnValue = new SqlParameter("columnValue", "http://SomeURL");
+
+var blogs = await context.Blogs
+    .FromSqlRaw($"SELECT * FROM [Blogs] WHERE {columnName} = @columnValue", columnValue)
+    .ToListAsync();
+```
+
+In the above code, the column name is inserted directly into the SQL, using C# string interpolation. It is your responsibility to make sure this string value is safe, sanitizing it if it comes from an unsafe origin; this means detecting special characters such as semicolons, comments, and other SQL constructs, and either escaping them properly or rejecting such inputs.
+
+On the other hand, the column value is sent via a `DbParameter`, and is therefore safe in the face of SQL injection.
+
+> [!WARNING]
+>
+> Be very careful when using <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.FromSqlRaw*>, and always make sure values are either from a safe origin, or are properly sanitized. SQL injection attacks can have disastrous consequences for your application.
+
+## Composing with LINQ
+
+You can compose on top of the initial SQL query using LINQ operators; EF Core will treat your SQL as a subquery and compose over it in the database. The following example uses a SQL query that selects from a Table-Valued Function (TVF). And then composes on it using LINQ to do filtering and sorting.
+
+```csharp
+var searchTerm = "Lorem ipsum";
+
+var blogs = await context.Blogs
+    .FromSql($"SELECT * FROM dbo.SearchBlogs({searchTerm})")
+    .Where(b => b.Rating > 3)
+    .OrderByDescending(b => b.Rating)
+    .ToListAsync();
+```
+
+The above query generates the following SQL:
+
+```sql
+SELECT [b].[BlogId], [b].[OwnerId], [b].[Rating], [b].[Url]
+FROM (
+    SELECT * FROM dbo.SearchBlogs(@p0)
+) AS [b]
+WHERE [b].[Rating] > 3
+ORDER BY [b].[Rating] DESC
+```
+
+### Including related data
+
+The [`Include`](xref:core/querying/related-data/eager) operator can be used to load related data, just like with any other LINQ query:
+
+```csharp
+var searchTerm = "Lorem ipsum";
+
+var blogs = await context.Blogs
+    .FromSql($"SELECT * FROM dbo.SearchBlogs({searchTerm})")
+    .Include(b => b.Posts)
+    .ToListAsync();
+```
+
+Composing with LINQ requires your SQL query to be composable, since EF Core will treat the supplied SQL as a subquery. Composable SQL queries generally begin with the `SELECT` keyword, and cannot contain SQL features that aren't valid in a subquery, such as:
+
+- A trailing semicolon
+- On SQL Server, a trailing query-level hint (for example, `OPTION (HASH JOIN)`)
+- On SQL Server, an `ORDER BY` clause that isn't used with `OFFSET 0` OR `TOP 100 PERCENT` in the `SELECT` clause
+
+SQL Server doesn't allow composing over stored procedure calls, so any attempt to apply additional query operators to such a call will result in invalid SQL. Use <xref:System.Linq.Enumerable.AsEnumerable*> or <xref:Microsoft.EntityFrameworkCore.EntityFrameworkQueryableExtensions.AsAsyncEnumerable*> right after <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.FromSql*> or <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.FromSqlRaw*> to make sure that EF Core doesn't try to compose over a stored procedure.
+
+## Change Tracking
+
+Queries that use <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.FromSql*> or <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.FromSqlRaw*> follow the exact same change tracking rules as any other LINQ query in EF Core. For example, if the query projects entity types, the results are tracked by default.
+
+The following example uses a SQL query that selects from a Table-Valued Function (TVF), then disables change tracking with the call to [`AsNoTracking`](xref:core/querying/tracking#no-tracking-queries):
+
+```csharp
+var searchTerm = "Lorem ipsum";
+
+var blogs = await context.Blogs
+    .FromSql($"SELECT * FROM dbo.SearchBlogs({searchTerm})")
+    .AsNoTracking()
+    .ToListAsync();
+```
+
+## Querying scalar (non-entity) types
+
+While <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.FromSql*> is useful for querying entities defined in your model, <xref:Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.SqlQuery*> allows you to easily query for scalar, non-entity types via SQL, without needing to drop down to lower-level data access APIs. For example, the following query fetches all the IDs from the `Blogs` table:
+
+### [SQL Server](#tab/sqlserver)
+
+```c#
+var ids = await context.Database
+    .SqlQuery<int>($"SELECT [BlogId] FROM [Blogs]")
+    .ToListAsync();
+```
+
+### [SQLite](#tab/sqlite)
+
+```c#
+var ids = await context.Database
+    .SqlQuery<int>($"""
+                    SELECT "BlogId" FROM "Blogs"
+                    """)
+    .ToListAsync();
+```
+
+### [PostgreSQL](#tab/postgres)
+
+```c#
+var ids = await context.Database
+    .SqlQuery<int>($"""
+                    SELECT "BlogId" FROM "Blogs"
+                    """)
+    .ToListAsync();
+```
+
+***
+
+You can also compose LINQ operators over your SQL query. However, since your SQL becomes a subquery whose output column needs to be referenced by the SQL EF adds, you must name the output column `Value`. For example, the following query returns the IDs which are above the ID average:
+
+### [SQL Server](#tab/sqlserver)
+
+```c#
+var overAverageIds = await context.Database
+    .SqlQuery<int>($"SELECT [BlogId] AS [Value] FROM [Blogs]")
+    .Where(id => id > context.Blogs.Average(b => b.BlogId))
+    .ToListAsync();
+```
+
+### [SQLite](#tab/sqlite)
+
+```c#
+var overAverageIds = await context.Database
+    .SqlQuery<int>($"""
+                    SELECT "BlogId" AS "Value" FROM "Blogs"
+                    """)
+    .Where(id => id > context.Blogs.Average(b => b.BlogId))
+    .ToListAsync();
+```
+
+### [PostgreSQL](#tab/postgres)
+
+```c#
+var overAverageIds = await context.Database
+    .SqlQuery<int>($"""
+                    SELECT "BlogId" AS "Value" FROM "Blogs"
+                    """)
+    .Where(id => id > context.Blogs.Average(b => b.BlogId))
+    .ToListAsync();
+```
+
+***
+
+<xref:Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.SqlQuery*> can be used with any scalar type supported by your database provider. If you'd like to use a type not supported by your database provider, you can use [pre-convention configuration](xref:core/modeling/bulk-configuration#pre-convention-configuration) to define a value conversion for it.
+
+<xref:Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.SqlQueryRaw*> allows for dynamic construction of SQL queries, just like <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.FromSqlRaw*> does for entity types.
+
+## Executing non-querying SQL
+
+In some scenarios, it may be necessary to execute SQL which does not return any data, typically for modifying data in the database or calling a stored procedure which doesn't return any result sets. This can be done via <xref:Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.ExecuteSql*>:
+
+```csharp
+using (var context = new BloggingContext())
+{
+    var rowsModified = context.Database.ExecuteSql($"UPDATE [Blogs] SET [Url] = NULL");
+}
+```
+
+This executes the provided SQL and returns the number of rows modified. <xref:Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.ExecuteSql*> protects against SQL injection by using safe parameterization, just like <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.FromSql*>, and <xref:Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.ExecuteSqlRaw*> allows for dynamic construction of SQL queries, just like <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.FromSqlRaw*> does for queries.
+
+## Limitations
+
+There are a few limitations to be aware of when returning entity types from SQL queries:
+
+- The SQL query must return data for all properties of the entity type.
+- The column names in the result set must match the column names that properties are mapped to. Note that this behavior is different from EF6; EF6 ignored property-to-column mapping for SQL queries, and result set column names had to match those property names.
+- The SQL query can't contain related data. However, in many cases you can compose on top of the query using the `Include` operator to return related data (see [Including related data](#including-related-data)).
diff --git a/entity-framework/core/querying/tags.md b/entity-framework/core/querying/tags.md
new file mode 100644
index 0000000000..f8b5131e3b
--- /dev/null
+++ b/entity-framework/core/querying/tags.md
@@ -0,0 +1,93 @@
+---
+title: Query Tags - EF Core
+description: Using query tags to help identify specific queries in log messages emitted by Entity Framework Core
+author: smitpatel
+ms.date: 11/14/2018
+uid: core/querying/tags
+---
+
+# Query tags
+
+Query tags help correlate LINQ queries in code with generated SQL queries captured in logs.
+You annotate a LINQ query using the new `TagWith()` method:
+
+> [!TIP]
+> You can view this article's [sample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Querying/Tags) on GitHub.
+
+[!code-csharp[Main](../../../samples/core/Querying/Tags/Program.cs#BasicQueryTag)]
+
+This LINQ query is translated to the following SQL statement:
+
+```sql
+-- This is my spatial query!
+
+SELECT TOP(@__p_1) [p].[Id], [p].[Location]
+FROM [People] AS [p]
+ORDER BY [p].[Location].STDistance(@__myLocation_0) DESC
+```
+
+It's possible to call `TagWith()` many times on the same query.
+Query tags are cumulative.
+For example, given the following methods:
+
+[!code-csharp[Main](../../../samples/core/Querying/Tags/Program.cs#QueryableMethods)]
+
+The following query:
+
+[!code-csharp[Main](../../../samples/core/Querying/Tags/Program.cs#ChainedQueryTags)]
+
+Translates to:
+
+```sql
+-- GetNearestPeople
+-- Limit
+
+SELECT TOP(@__p_1) [p].[Id], [p].[Location]
+FROM [People] AS [p]
+ORDER BY [p].[Location].STDistance(@__myLocation_0) DESC
+```
+
+It's also possible to use multi-line strings as query tags.
+For example:
+
+[!code-csharp[Main](../../../samples/core/Querying/Tags/Program.cs#MultilineQueryTag)]
+
+Produces the following SQL:
+
+```sql
+-- GetNearestPeople
+-- Limit
+-- This is a multi-line
+-- string
+
+SELECT TOP(@__p_1) [p].[Id], [p].[Location]
+FROM [People] AS [p]
+ORDER BY [p].[Location].STDistance(@__myLocation_0) DESC
+```
+
+## Tagging with file name and line number
+
+Queries can be automatically tagged with the file name and line number where the LINQ query is defined in source code. This is done using the <xref:Microsoft.EntityFrameworkCore.EntityFrameworkQueryableExtensions.TagWithCallSite*> method:
+
+```csharp
+var myLocation = new Point(1, 2);
+var closestPeople = await (from f in context.People.TagWithCallSite()
+                     orderby f.Location.Distance(myLocation) descending
+                     select f).Take(5).ToListAsync();
+```
+
+This query translates to (the actual line number will reflect where the query is defined in the source file):
+
+```sql
+-- file: C:\Work\EntityFramework.Docs\samples\Program.cs:23
+
+SELECT TOP(@__p_1) [p].[Id], [p].[Location]
+FROM [People] AS [p]
+ORDER BY [p].[Location].STDistance(@__myLocation_0) DESC
+```
+
+## Known limitations
+
+**Query tags aren't parameterizable:**
+EF Core always treats query tags in the LINQ query as string literals that are included in the generated SQL.
+Compiled queries that take query tags as parameters aren't allowed.
diff --git a/entity-framework/core/querying/tracking.md b/entity-framework/core/querying/tracking.md
new file mode 100644
index 0000000000..7d11841cae
--- /dev/null
+++ b/entity-framework/core/querying/tracking.md
@@ -0,0 +1,91 @@
+---
+title: Tracking vs. No-Tracking Queries - EF Core
+description: Information on tracking and no-tracking queries in Entity Framework Core
+author: smitpatel
+ms.date: 3/15/2023
+uid: core/querying/tracking
+---
+# Tracking vs. No-Tracking Queries
+
+Tracking behavior controls if Entity Framework Core keeps information about an entity instance in its change tracker. If an entity is tracked, any changes detected in the entity are persisted to the database during `SaveChanges`. EF Core also fixes up navigation properties between the entities in a tracking query result and the entities that are in the change tracker.
+
+> [!NOTE]
+> [Keyless entity types](xref:core/modeling/keyless-entity-types) are never tracked. Wherever this article mentions entity types, it refers to entity types which have a key defined.
+
+> [!TIP]
+> You can view this article's [sample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Querying/Tracking) on GitHub.
+
+## Tracking queries
+
+By default, queries that return entity types are tracking. A tracking query means any changes to entity instances are persisted by `SaveChanges`. In the following example, the change to the blogs rating is detected and persisted to the database during `SaveChanges`:
+
+[!code-csharp[Main](../../../samples/core/Querying/Tracking/Program.cs#Tracking)]
+
+When the results are returned in a tracking query, EF Core checks if the entity is already in the context. If EF Core finds an existing entity, then the same instance is returned, which can potentially use less memory and be faster than a no-tracking query. EF Core doesn't overwrite current and original values of the entity's properties in the entry with the database values. If the entity isn't found in the context, EF Core creates a new entity instance and attaches it to the context. Query results don't contain any entity which is added to the context but not yet saved to the database.
+
+## No-tracking queries
+
+No-tracking queries are useful when the results are used in a read-only scenario. They're generally quicker to execute because there's no need to set up the change tracking information. If the entities retrieved from the database don't need to be updated, then a no-tracking query should be used. An individual query can be set to be no-tracking. A no-tracking query also give results based on what's in the database disregarding any local changes or added entities.
+
+[!code-csharp[Main](../../../samples/core/Querying/Tracking/Program.cs#NoTracking)]
+
+The default tracking behavior can be changed at the context instance level:
+
+[!code-csharp[Main](../../../samples/core/Querying/Tracking/Program.cs#ContextDefaultTrackingBehavior)]
+
+The next section explains when a no-tracking query might be less efficient than a tracking query.
+
+## Identity resolution
+
+Since a tracking query uses the change tracker, EF Core does identity resolution in a tracking query. When materializing an entity, EF Core returns the same entity instance from the change tracker if it's already being tracked. If the result contains the same entity multiple times, the same instance is returned for each occurrence. No-tracking queries:
+
+* Don't use the change tracker and don't do identity resolution.
+* Return a new instance of the entity even when the same entity is contained in the result multiple times.
+
+Tracking and no-tracking can be combined in the same query. That is, you can have a no-tracking query, which does identity resolution in the results. Just like <xref:Microsoft.EntityFrameworkCore.EntityFrameworkQueryableExtensions.AsNoTracking*> queryable operator, we've added another operator <xref:Microsoft.EntityFrameworkCore.EntityFrameworkQueryableExtensions.AsNoTrackingWithIdentityResolution%60`1(System.Linq.IQueryable{%60%600})>. There's also associated entry added in the <xref:Microsoft.EntityFrameworkCore.QueryTrackingBehavior> enum. When the query to use identity resolution is configured with no tracking, a stand-alone change tracker is used in the background when generating query results so each instance is materialized only once. Since this change tracker is different from the one in the context, the results are not tracked by the context. After the query is enumerated fully, the change tracker goes out of scope and garbage collected as required.
+
+[!code-csharp[Main](../../../samples/core/Querying/Tracking/Program.cs#NoTrackingWithIdentityResolution)]
+
+## Configuring the default tracking behavior
+
+If you find yourself changing the tracking behavior for many queries, you may want to change the default instead:
+
+[!code-csharp[Main](../../../samples/core/Querying/Tracking/NonTrackingBloggingContext.cs?name=OnConfiguring&highlight=5)]
+
+This makes all your queries no-tracking by default. You can still add <xref:Microsoft.EntityFrameworkCore.EntityFrameworkQueryableExtensions.AsTracking*> to make specific queries tracking.
+
+## Tracking and custom projections
+
+Even if the result type of the query isn't an entity type, EF Core will still track entity types contained in the result by default. In the following query, which returns an anonymous type, the instances of `Blog` in the result set will be tracked.
+
+[!code-csharp[Main](../../../samples/core/Querying/Tracking/Program.cs#CustomProjection1)]
+
+If the result set contains entity types coming out from LINQ composition, EF Core will track them.
+
+[!code-csharp[Main](../../../samples/core/Querying/Tracking/Program.cs#CustomProjection2)]
+
+If the result set doesn't contain any entity types, then no tracking is done. In the following query, we return an anonymous type with some of the values from the entity (but no instances of the actual entity type). There are no tracked entities coming out of the query.
+
+[!code-csharp[Main](../../../samples/core/Querying/Tracking/Program.cs#CustomProjection3)]
+
+ EF Core supports doing client evaluation in the top-level projection. If EF Core materializes an entity instance for client evaluation, it will be tracked. Here, since we're passing `blog` entities to the client method `StandardizeURL`, EF Core will track the blog instances too.
+
+[!code-csharp[Main](../../../samples/core/Querying/Tracking/Program.cs#ClientProjection)]
+
+[!code-csharp[Main](../../../samples/core/Querying/Tracking/Program.cs#ClientMethod)]
+
+EF Core doesn't track the keyless entity instances contained in the result. But EF Core tracks all the other instances of entity types with a key according to rules above.
+
+## Previous versions
+
+Before version 3.0, EF Core had some differences in how tracking was done. Notable differences are as follows:
+
+* As explained in the [Client vs Server Evaluation](xref:core/querying/client-eval) page, EF Core supported client evaluation in any part of the query before version 3.0. Client evaluation caused materialization of entities, which weren't part of the result. So EF Core analyzed the result to detect what to track. This design had certain differences as follows:
+  * Client evaluation in the projection, which caused materialization but didn't return the materialized entity instance wasn't tracked. The following example didn't track `blog` entities.
+    [!code-csharp[Main](../../../samples/core/Querying/Tracking/Program.cs#ClientProjection)]
+
+  * EF Core didn't track the objects coming out of LINQ composition in certain cases. The following example didn't track `Post`.
+    [!code-csharp[Main](../../../samples/core/Querying/Tracking/Program.cs#CustomProjection2)]
+
+* Whenever query results contained keyless entity types, the whole query was made non-tracking. That means that entity types with keys, which are in the result weren't being tracked either.
+* EF Core used to do identity resolution in no-tracking queries. It used weak references to keep track of entities that had already been returned. So if a result set contained the same entity multiples times, you would get the same instance for each occurrence. Though if a previous result with the same identity went out of scope and got garbage collected, EF Core returned a new instance.
diff --git a/entity-framework/core/querying/user-defined-function-mapping.md b/entity-framework/core/querying/user-defined-function-mapping.md
new file mode 100644
index 0000000000..47747a777d
--- /dev/null
+++ b/entity-framework/core/querying/user-defined-function-mapping.md
@@ -0,0 +1,183 @@
+---
+title: User-defined function mapping - EF Core
+description: Mapping user-defined functions to database functions
+author: maumar
+ms.date: 11/23/2020
+uid: core/querying/user-defined-function-mapping
+---
+# User-defined function mapping
+
+EF Core allows for using user-defined SQL functions in queries. To do that, the functions need to be mapped to a CLR method during model configuration. When translating the LINQ query to SQL, the user-defined function is called instead of the CLR function it has been mapped to.
+
+## Mapping a method to a SQL function
+
+To illustrate how user-defined function mapping works, let's define the following entities:
+
+[!code-csharp[Main](../../../samples/core/Querying/UserDefinedFunctionMapping/Model.cs#Entities)]
+
+And the following model configuration:
+
+[!code-csharp[Main](../../../samples/core/Querying/UserDefinedFunctionMapping/Model.cs#EntityConfiguration)]
+
+Blog can have many posts and each post can have many comments.
+
+Next, create the user-defined function `CommentedPostCountForBlog`, which returns the count of posts with at least one comment for a given blog, based on the blog `Id`:
+
+```sql
+CREATE FUNCTION dbo.CommentedPostCountForBlog(@id int)
+RETURNS int
+AS
+BEGIN
+    RETURN (SELECT COUNT(*)
+        FROM [Posts] AS [p]
+        WHERE ([p].[BlogId] = @id) AND ((
+            SELECT COUNT(*)
+            FROM [Comments] AS [c]
+            WHERE [p].[PostId] = [c].[PostId]) > 0));
+END
+```
+
+To use this function in EF Core, we define the following CLR method, which we map to the user-defined function:
+
+[!code-csharp[Main](../../../samples/core/Querying/UserDefinedFunctionMapping/Model.cs#BasicFunctionDefinition)]
+
+The body of the CLR method is not important. The method will not be invoked client-side, unless EF Core can't translate its arguments. If the arguments can be translated, EF Core only cares about the method signature.
+
+> [!NOTE]
+> In the example, the method is defined on `DbContext`, but it can also be defined as a static method inside other classes.
+
+This function definition can now be associated with user-defined function in the model configuration:
+
+[!code-csharp[Main](../../../samples/core/Querying/UserDefinedFunctionMapping/Model.cs#BasicFunctionConfiguration)]
+
+By default, EF Core tries to map CLR function to a user-defined function with the same name. If the names differ, we can use `HasName` to provide the correct name for the user-defined function we want to map to.
+
+Now, executing the following query:
+
+[!code-csharp[Main](../../../samples/core/Querying/UserDefinedFunctionMapping/Program.cs#BasicQuery)]
+
+Will produce this SQL:
+
+```sql
+SELECT [b].[BlogId], [b].[Rating], [b].[Url]
+FROM [Blogs] AS [b]
+WHERE [dbo].[CommentedPostCountForBlog]([b].[BlogId]) > 1
+```
+
+## Mapping a method to a custom SQL
+
+EF Core also allows for user-defined functions that get converted to a specific SQL. The SQL expression is provided using `HasTranslation` method during user-defined function configuration.
+
+In the example below, we'll create a function that computes percentage difference between two integers.
+
+The CLR method is as follows:
+
+[!code-csharp[Main](../../../samples/core/Querying/UserDefinedFunctionMapping/Model.cs#HasTranslationFunctionDefinition)]
+
+The function definition is as follows:
+
+[!code-csharp[Main](../../../samples/core/Querying/UserDefinedFunctionMapping/Model.cs#HasTranslationFunctionConfiguration)]
+
+Once we define the function, it can be used in the query. Instead of calling database function, EF Core will translate the method body directly into SQL based on the SQL expression tree constructed from the HasTranslation. The following LINQ query:
+
+[!code-csharp[Main](../../../samples/core/Querying/UserDefinedFunctionMapping/Program.cs#HasTranslationQuery)]
+
+Produces the following SQL:
+
+```sql
+SELECT 100 * (ABS(CAST([p].[BlogId] AS float) - 3) / ((CAST([p].[BlogId] AS float) + 3) / 2))
+FROM [Posts] AS [p]
+```
+
+## Configuring nullability of user-defined function based on its arguments
+
+If the user-defined function can only return `null` when one or more of its arguments are `null`, EFCore provides way to specify that, resulting in more performant SQL. It can be done by adding a `PropagatesNullability()` call to the relevant function parameters model configuration.
+
+To illustrate this, define user function `ConcatStrings`:
+
+```sql
+CREATE FUNCTION [dbo].[ConcatStrings] (@prm1 nvarchar(max), @prm2 nvarchar(max))
+RETURNS nvarchar(max)
+AS
+BEGIN
+    RETURN @prm1 + @prm2;
+END
+```
+
+and two CLR methods that map to it:
+
+[!code-csharp[Main](../../../samples/core/Querying/UserDefinedFunctionMapping/Model.cs#NullabilityPropagationFunctionDefinition)]
+
+The model configuration (inside `OnModelCreating` method) is as follows:
+
+[!code-csharp[Main](../../../samples/core/Querying/UserDefinedFunctionMapping/Model.cs#NullabilityPropagationModelConfiguration)]
+
+The first function is configured in the standard way. The second function is configured to take advantage of the nullability propagation optimization, providing more information on how the function behaves around null parameters.
+
+When issuing the following queries:
+
+[!code-csharp[Main](../../../samples/core/Querying/UserDefinedFunctionMapping/Program.cs#NullabilityPropagationExamples)]
+
+We get this SQL:
+
+```sql
+SELECT [b].[BlogId], [b].[Rating], [b].[Url]
+FROM [Blogs] AS [b]
+WHERE ([dbo].[ConcatStrings]([b].[Url], CONVERT(VARCHAR(11), [b].[Rating])) <> N'Lorem ipsum...') OR [dbo].[ConcatStrings]([b].[Url], CONVERT(VARCHAR(11), [b].[Rating])) IS NULL
+
+SELECT [b].[BlogId], [b].[Rating], [b].[Url]
+FROM [Blogs] AS [b]
+WHERE ([dbo].[ConcatStrings]([b].[Url], CONVERT(VARCHAR(11), [b].[Rating])) <> N'Lorem ipsum...') OR ([b].[Url] IS NULL OR [b].[Rating] IS NULL)
+```
+
+The second query doesn't need to re-evaluate the function itself to test its nullability.
+
+> [!NOTE]
+> This optimization should only be used if the function can only return `null` when it's parameters are `null`.
+
+## Mapping a queryable function to a table-valued function
+
+EF Core also supports mapping to a table-valued function using a user-defined CLR method returning an `IQueryable` of entity types, allowing EF Core to map TVFs with parameters. The process is similar to mapping a scalar user-defined function to a SQL function: we need a TVF in the database, a CLR function that is used in the LINQ queries, and a mapping between the two.
+
+As an example, we'll use a table-valued function that returns all posts having at least one comment that meets a given "Like" threshold:
+
+```sql
+CREATE FUNCTION dbo.PostsWithPopularComments(@likeThreshold int)
+RETURNS TABLE
+AS
+RETURN
+(
+    SELECT [p].[PostId], [p].[BlogId], [p].[Content], [p].[Rating], [p].[Title]
+    FROM [Posts] AS [p]
+    WHERE (
+        SELECT COUNT(*)
+        FROM [Comments] AS [c]
+        WHERE ([p].[PostId] = [c].[PostId]) AND ([c].[Likes] >= @likeThreshold)) > 0
+)
+```
+
+The CLR method signature is as follows:
+
+[!code-csharp[Main](../../../samples/core/Querying/UserDefinedFunctionMapping/Model.cs#QueryableFunctionDefinition)]
+
+> [!TIP]
+> The `FromExpression` call in the CLR function body allows for the function to be used instead of a regular DbSet.
+
+And below is the mapping:
+
+[!code-csharp[Main](../../../samples/core/Querying/UserDefinedFunctionMapping/Model.cs#QueryableFunctionConfigurationHasDbFunction)]
+
+> [!NOTE]
+> A queryable function must be mapped to a table-valued function and can't make use of `HasTranslation`.
+
+When the function is mapped, the following query:
+
+[!code-csharp[Main](../../../samples/core/Querying/UserDefinedFunctionMapping/Program.cs#TableValuedFunctionQuery)]
+
+Produces:
+
+```sql
+SELECT [p].[PostId], [p].[BlogId], [p].[Content], [p].[Rating], [p].[Title]
+FROM [dbo].[PostsWithPopularComments](@likeThreshold) AS [p]
+ORDER BY [p].[Rating]
+```
diff --git a/entity-framework/core/saving/basic.md b/entity-framework/core/saving/basic.md
new file mode 100644
index 0000000000..ec972e066d
--- /dev/null
+++ b/entity-framework/core/saving/basic.md
@@ -0,0 +1,47 @@
+---
+title: Basic SaveChanges - EF Core
+description: Basic information on adding, updating and removing data using SaveChanges with Entity Framework Core
+author: SamMonoRT
+ms.date: 4/30/2023
+uid: core/saving/basic
+---
+# Basic SaveChanges
+
+<xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges?displayProperty=nameWithType> is one of two techniques for saving changes to the database with EF. With this method, you perform one or more *tracked changes* (add, update, delete), and then apply those changes by calling the `SaveChanges` method. As an alternative, <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.ExecuteUpdate*> and <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.ExecuteDelete*> can be used without involving the change tracker. For an introductory comparison of these two techniques, see the [Overview page](xref:core/saving/index) on saving data.
+
+> [!TIP]
+> You can view this article's [sample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Saving/Basics/) on GitHub.
+
+## Adding Data
+
+Use the <xref:Microsoft.EntityFrameworkCore.DbSet`1.Add*?displayProperty=nameWithType> method to add new instances of your entity classes. The data will be inserted into the database when you call <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges?displayProperty=nameWithType>:
+
+[!code-csharp[Main](../../../samples/core/Saving/Basics/Sample.cs#Add)]
+
+> [!TIP]
+> The `Add`, `Attach`, and `Update` methods all work on the full graph of entities passed to them, as described in the [Related Data](xref:core/saving/related-data) section. Alternately, the EntityEntry.State property can be used to set the state of just a single entity. For example, `context.Entry(blog).State = EntityState.Modified`.
+
+## Updating Data
+
+EF automatically detects changes made to an existing entity that is tracked by the context. This includes entities that you load/query from the database, and entities that were previously added and saved to the database.
+
+Simply modify the values assigned to properties and then call `SaveChanges`:
+
+[!code-csharp[Main](../../../samples/core/Saving/Basics/Sample.cs#Update)]
+
+## Deleting Data
+
+Use the <xref:Microsoft.EntityFrameworkCore.DbSet`1.Remove*?displayProperty=nameWithType> method to delete instances of your entity classes:
+
+[!code-csharp[Main](../../../samples/core/Saving/Basics/Sample.cs#Remove)]
+
+If the entity already exists in the database, it will be deleted during `SaveChanges`. If the entity has not yet been saved to the database (that is, it is tracked as added) then it will be removed from the context and will no longer be inserted when `SaveChanges` is called.
+
+## Multiple Operations in a single SaveChanges
+
+You can combine multiple Add/Update/Remove operations into a single call to `SaveChanges`:
+
+[!code-csharp[Main](../../../samples/core/Saving/Basics/Sample.cs#MultipleOperations)]
+
+> [!NOTE]
+> For most database providers, `SaveChanges` is transactional. This means all the operations either succeed or fail and the operations are never be left partially applied.
diff --git a/entity-framework/core/saving/cascade-delete.md b/entity-framework/core/saving/cascade-delete.md
new file mode 100644
index 0000000000..62df8623f1
--- /dev/null
+++ b/entity-framework/core/saving/cascade-delete.md
@@ -0,0 +1,565 @@
+---
+title: Cascade Delete - EF Core
+description: Configuring cascading behaviors triggered when an entity is deleted or severed from its principal/parent
+author: SamMonoRT
+ms.date: 08/10/2021
+uid: core/saving/cascade-delete
+---
+# Cascade Delete
+
+Entity Framework Core (EF Core) represents relationships using foreign keys. An entity with a foreign key is the child or dependent entity in the relationship. This entity's foreign key value must match the primary key value (or an alternate key value) of the related principal/parent entity.
+
+If the principal/parent entity is deleted, then the foreign key values of the dependents/children will no longer match the primary or alternate key of _any_ principal/parent. This is an invalid state, and will cause a referential constraint violation in most databases.
+
+There are two options to avoid this referential constraint violation:
+
+1. Set the FK values to null
+2. Also delete the dependent/child entities
+
+The first option is only valid for optional relationships where the foreign key property (and the database column to which it is mapped) must be nullable.
+
+The second option is valid for any kind of relationship and is known as "cascade delete".
+
+> [!TIP]
+> This document describes cascade deletes (and deleting orphans) from the perspective of updating the database. It makes heavy use of concepts introduced in [Change Tracking in EF Core](xref:core/change-tracking/index) and [Changing Foreign Keys and Navigations](xref:core/change-tracking/relationship-changes). Make sure to fully understand these concepts before tackling the material here.
+
+> [!TIP]  
+> You can run and debug into all the code in this document by [downloading the sample code from GitHub](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/CascadeDeletes).
+
+## When cascading behaviors happen
+
+Cascading deletes are needed when a dependent/child entity can no longer be associated with its current principal/parent. This can happen because the principal/parent is deleted, or it can happen when the principal/parent still exists but the dependent/child is no longer associated with it.
+
+### Deleting a principal/parent
+
+Consider this simple model where `Blog` is the principal/parent in a relationship with `Post`, which is the dependent/child. `Post.BlogId` is a foreign key property, the value of which must match the `Blog.Id` primary key of the blog to which the post belongs.
+
+<!--
+    public class Blog
+    {
+        public int Id { get; set; }
+
+        public string Name { get; set; }
+
+        public IList<Post> Posts { get; } = new List<Post>();
+    }
+
+    public class Post
+    {
+        public int Id { get; set; }
+
+        public string Title { get; set; }
+        public string Content { get; set; }
+
+        public int BlogId { get; set; }
+        public Blog Blog { get; set; }
+    }
+-->
+[!code-csharp[Model](../../../samples/core/CascadeDeletes/IntroRequiredSamples.cs?name=Model)]
+
+By convention, this relationship is configured as a required, since the `Post.BlogId` foreign key property is non-nullable. Required relationships are configured to use cascade deletes by default. See [Relationships](xref:core/modeling/relationships) for more information on modeling relationships.
+
+When deleting a blog, all posts are cascade deleted. For example:
+
+<!--
+            using var context = new BlogsContext();
+
+            var blog = context.Blogs.OrderBy(e => e.Name).Include(e => e.Posts).First();
+
+            context.Remove(blog);
+            
+            context.SaveChanges();
+-->
+[!code-csharp[Deleting_principal_parent_1](../../../samples/core/CascadeDeletes/IntroRequiredSamples.cs?name=Deleting_principal_parent_1)]
+
+SaveChanges generates the following SQL, using SQL Server as an example:
+
+```sql
+-- Executed DbCommand (1ms) [Parameters=[@p0='1'], CommandType='Text', CommandTimeout='30']
+SET NOCOUNT ON;
+DELETE FROM [Posts]
+WHERE [Id] = @p0;
+SELECT @@ROWCOUNT;
+
+-- Executed DbCommand (0ms) [Parameters=[@p0='2'], CommandType='Text', CommandTimeout='30']
+SET NOCOUNT ON;
+DELETE FROM [Posts]
+WHERE [Id] = @p0;
+SELECT @@ROWCOUNT;
+
+-- Executed DbCommand (2ms) [Parameters=[@p1='1'], CommandType='Text', CommandTimeout='30']
+SET NOCOUNT ON;
+DELETE FROM [Blogs]
+WHERE [Id] = @p1;
+SELECT @@ROWCOUNT;
+```
+
+### Severing a relationship
+
+Rather than deleting the blog, we could instead sever the relationship between each post and its blog. This can be done by setting the reference navigation `Post.Blog` to null for each post:
+
+<!--
+            using var context = new BlogsContext();
+
+            var blog = context.Blogs.OrderBy(e => e.Name).Include(e => e.Posts).First();
+
+            foreach (var post in blog.Posts)
+            {
+                post.Blog = null;
+            }
+            
+            context.SaveChanges();
+-->
+[!code-csharp[Severing_a_relationship_1](../../../samples/core/CascadeDeletes/IntroRequiredSamples.cs?name=Severing_a_relationship_1)]
+
+The relationship can also be severed by removing each post from the `Blog.Posts` collection navigation:
+
+<!--
+            using var context = new BlogsContext();
+
+            var blog = context.Blogs.OrderBy(e => e.Name).Include(e => e.Posts).First();
+
+            blog.Posts.Clear();
+            
+            context.SaveChanges();
+-->
+[!code-csharp[Severing_a_relationship_2](../../../samples/core/CascadeDeletes/IntroRequiredSamples.cs?name=Severing_a_relationship_2)]
+
+In either case the result is the same: the blog is not deleted, but the posts that are no longer associated with any blog are deleted:
+
+```sql
+-- Executed DbCommand (1ms) [Parameters=[@p0='1'], CommandType='Text', CommandTimeout='30']
+SET NOCOUNT ON;
+DELETE FROM [Posts]
+WHERE [Id] = @p0;
+SELECT @@ROWCOUNT;
+
+-- Executed DbCommand (0ms) [Parameters=[@p0='2'], CommandType='Text', CommandTimeout='30']
+SET NOCOUNT ON;
+DELETE FROM [Posts]
+WHERE [Id] = @p0;
+SELECT @@ROWCOUNT;
+```
+
+Deleting entities that are no longer associated with any principal/dependent is known as "deleting orphans".
+
+> [!TIP]
+> Cascade delete and deleting orphans are closely related. Both result in deleting dependent/child entities when the relationship to their required principal/parent is severed. For cascade delete, this severing happens because the principal/parent is itself deleted. For orphans, the principal/parent entity still exists, but is no longer related to the dependent/child entities.  
+
+## Where cascading behaviors happen
+
+Cascading behaviors can be applied to:
+
+- Entities tracked by the current <xref:Microsoft.EntityFrameworkCore.DbContext>
+- Entities in the database that have not been loaded into the context
+
+### Cascade delete of tracked entities
+
+EF Core always applies configured cascading behaviors to tracked entities. This means that if the application loads all relevant dependent/child entities into the DbContext, as is shown in the examples above, then cascading behaviors will be correctly applied regardless of how the database is configured.
+
+> [!TIP]
+> The exact timing of when cascading behaviors happen to tracked entities can be controlled using <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.CascadeDeleteTiming?displayProperty=nameWithType> and <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.DeleteOrphansTiming?displayProperty=nameWithType>. See [Changing Foreign Keys and Navigations](xref:core/change-tracking/relationship-changes) for more information.
+
+### Cascade delete in the database
+
+Many database systems also offer cascading behaviors that are triggered when an entity is deleted in the database. EF Core configures these behaviors based on the cascade delete behavior in the EF Core model when a database is created using <xref:Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade.EnsureCreated*> or EF Core migrations. For example, using the model above, the following table is created for posts when using SQL Server:
+
+```sql
+CREATE TABLE [Posts] (
+    [Id] int NOT NULL IDENTITY,
+    [Title] nvarchar(max) NULL,
+    [Content] nvarchar(max) NULL,
+    [BlogId] int NOT NULL,
+    CONSTRAINT [PK_Posts] PRIMARY KEY ([Id]),
+    CONSTRAINT [FK_Posts_Blogs_BlogId] FOREIGN KEY ([BlogId]) REFERENCES [Blogs] ([Id]) ON DELETE CASCADE
+);
+```
+
+Notice that the foreign key constraint defining the relationship between blogs and posts is configured with `ON DELETE CASCADE`.
+
+If we know that the database is configured like this, then we can delete a blog _without first loading posts_ and the database will take care of deleting all the posts that were related to that blog. For example:
+
+<!--
+            using var context = new BlogsContext();
+
+            var blog = context.Blogs.OrderBy(e => e.Name).First();
+
+            context.Remove(blog);
+            
+            context.SaveChanges();
+-->
+[!code-csharp[Where_cascading_behaviors_happen_1](../../../samples/core/CascadeDeletes/IntroRequiredSamples.cs?name=Where_cascading_behaviors_happen_1)]
+
+Notice that there is no `Include` for posts, so they are not loaded. SaveChanges in this case will delete just the blog, since that's the only entity being tracked:
+
+```sql
+-- Executed DbCommand (6ms) [Parameters=[@p0='1'], CommandType='Text', CommandTimeout='30']
+SET NOCOUNT ON;
+DELETE FROM [Blogs]
+WHERE [Id] = @p0;
+SELECT @@ROWCOUNT;
+```
+
+This would result in an exception if the foreign key constraint in the database is not configured for cascade deletes. However, in this case the posts are deleted by the database because it has been configured with `ON DELETE CASCADE` when it was created.
+
+> [!NOTE]
+> Databases don't typically have any way to automatically delete orphans. This is because while EF Core represents relationships using navigations as well of foreign keys, databases have only foreign keys and no navigations. This means that it is usually not possible to sever a relationship without loading both sides into the DbContext.
+
+> [!NOTE]
+> The EF Core in-memory database does not currently support cascade deletes in the database.
+
+> [!WARNING]
+> Do not configure cascade delete in the database when soft-deleting entities. This may cause entities to be accidentally really deleted instead of soft-deleted.
+
+### Database cascade limitations
+
+Some databases, most notably SQL Server, have limitations on the cascade behaviors that form cycles. For example, consider the following model:
+
+<!--
+    public class Blog
+    {
+        public int Id { get; set; }
+        public string Name { get; set; }
+
+        public IList<Post> Posts { get; } = new List<Post>();
+        
+        public int OwnerId { get; set; }
+        public Person Owner { get; set; }
+    }
+
+    public class Post
+    {
+        public int Id { get; set; }
+        public string Title { get; set; }
+        public string Content { get; set; }
+
+        public int BlogId { get; set; }
+        public Blog Blog { get; set; }
+        
+        public int AuthorId { get; set; }
+        public Person Author { get; set; }
+    }
+
+    public class Person
+    {
+        public int Id { get; set; }
+        public string Name { get; set; }
+        
+        public IList<Post> Posts { get; } = new List<Post>();
+
+        public Blog OwnedBlog { get; set; }
+    }
+-->
+[!code-csharp[Model](../../../samples/core/CascadeDeletes/WithDatabaseCycleSamples.cs?name=Model)]
+
+This model has three relationships, all required and therefore configured to cascade delete by convention:
+
+- Deleting a blog will cascade delete all the related posts
+- Deleting the author of posts will cause the authored posts to be cascade deleted
+- Deleting the owner of a blog will cause the blog to be cascade deleted
+
+This is all reasonable (if a bit draconian in blog management policies!) but attempting to create a SQL Server database with these cascades configured results in the following exception:
+
+> Microsoft.Data.SqlClient.SqlException (0x80131904): Introducing FOREIGN KEY constraint 'FK_Posts_Person_AuthorId' on table 'Posts' may cause cycles or multiple cascade paths. Specify ON DELETE NO ACTION or ON UPDATE NO ACTION, or modify other FOREIGN KEY constraints.
+
+There are two ways to handle this situation:
+
+1. Change one or more of the relationships to not cascade delete.
+2. Configure the database without one or more of these cascade deletes, then ensure all dependent entities are loaded so that EF Core can perform the cascading behavior.
+
+Taking the first approach with our example, we could make the post-blog relationship optional by giving it a nullable foreign key property:
+
+<!--
+            public int? BlogId { get; set; }
+-->
+[!code-csharp[NullableBlogId](../../../samples/core/CascadeDeletes/OptionalDependentsSamples.cs?name=NullableBlogId)]
+
+An optional relationship allows the post to exist without a blog, which means cascade delete will no longer be configured by default. This means there is no longer a cycle in cascading actions, and the database can be created without error on SQL Server.
+
+Taking the second approach instead, we can keep the blog-owner relationship required and configured for cascade delete, but make this configuration only apply to tracked entities, not the database:
+
+<!--
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder
+                .Entity<Blog>()
+                .HasOne(e => e.Owner)
+                .WithOne(e => e.OwnedBlog)
+                .OnDelete(DeleteBehavior.ClientCascade);
+        }
+-->
+[!code-csharp[OnModelCreating](../../../samples/core/CascadeDeletes/WithDatabaseCycleSamples.cs?name=OnModelCreating)]
+
+Now what happens if we load both a person and the blog they own, then delete the person?
+
+<!--
+            using var context = new BlogsContext();
+
+            var owner = context.People.Single(e => e.Name == "ajcvickers");
+            var blog = context.Blogs.Single(e => e.Owner == owner);
+
+            context.Remove(owner);
+            
+            context.SaveChanges();
+-->
+[!code-csharp[Database_cascade_limitations_1](../../../samples/core/CascadeDeletes/WithDatabaseCycleSamples.cs?name=Database_cascade_limitations_1)]
+
+EF Core will cascade the delete of the owner so that the blog is also deleted:
+
+```sql
+-- Executed DbCommand (8ms) [Parameters=[@p0='1'], CommandType='Text', CommandTimeout='30']
+SET NOCOUNT ON;
+DELETE FROM [Blogs]
+WHERE [Id] = @p0;
+SELECT @@ROWCOUNT;
+
+-- Executed DbCommand (2ms) [Parameters=[@p1='1'], CommandType='Text', CommandTimeout='30']
+SET NOCOUNT ON;
+DELETE FROM [People]
+WHERE [Id] = @p1;
+SELECT @@ROWCOUNT;
+```
+
+However, if the blog is not loaded when the owner is deleted:
+
+<!--
+                using var context = new BlogsContext();
+
+                var owner = context.People.Single(e => e.Name == "ajcvickers");
+
+                context.Remove(owner);
+            
+                context.SaveChanges();
+-->
+[!code-csharp[Database_cascade_limitations_2](../../../samples/core/CascadeDeletes/WithDatabaseCycleSamples.cs?name=Database_cascade_limitations_2)]
+
+Then an exception will be thrown due to violation of the foreign key constraint in the database:
+
+> Microsoft.Data.SqlClient.SqlException: The DELETE statement conflicted with the REFERENCE constraint "FK_Blogs_People_OwnerId". The conflict occurred in database "Scratch", table "dbo.Blogs", column 'OwnerId'.
+The statement has been terminated.
+
+## Cascading nulls
+
+Optional relationships have nullable foreign key properties mapped to nullable database columns. This means that the foreign key value can be set to null when the current principal/parent is deleted or is severed from the dependent/child.
+
+Let's look again at the examples from [When cascading behaviors happen](#when-cascading-behaviors-happen), but this time with an optional relationship represented by a nullable `Post.BlogId` foreign key property:
+
+<!--
+            public int? BlogId { get; set; }
+-->
+[!code-csharp[NullableBlogId](../../../samples/core/CascadeDeletes/OptionalDependentsSamples.cs?name=NullableBlogId)]
+
+This foreign key property will be set to null for each post when its related blog is deleted. For example, this code, which is the same as before:
+
+<!--
+            using var context = new BlogsContext();
+
+            var blog = context.Blogs.OrderBy(e => e.Name).Include(e => e.Posts).First();
+
+            context.Remove(blog);
+            
+            context.SaveChanges();
+-->
+[!code-csharp[Deleting_principal_parent_1b](../../../samples/core/CascadeDeletes/IntroOptionalSamples.cs?name=Deleting_principal_parent_1b)]
+
+Will now result in the following database updates when SaveChanges is called:
+
+```sql
+-- Executed DbCommand (2ms) [Parameters=[@p1='1', @p0=NULL (DbType = Int32)], CommandType='Text', CommandTimeout='30']
+SET NOCOUNT ON;
+UPDATE [Posts] SET [BlogId] = @p0
+WHERE [Id] = @p1;
+SELECT @@ROWCOUNT;
+
+-- Executed DbCommand (0ms) [Parameters=[@p1='2', @p0=NULL (DbType = Int32)], CommandType='Text', CommandTimeout='30']
+SET NOCOUNT ON;
+UPDATE [Posts] SET [BlogId] = @p0
+WHERE [Id] = @p1;
+SELECT @@ROWCOUNT;
+
+-- Executed DbCommand (1ms) [Parameters=[@p2='1'], CommandType='Text', CommandTimeout='30']
+SET NOCOUNT ON;
+DELETE FROM [Blogs]
+WHERE [Id] = @p2;
+SELECT @@ROWCOUNT;
+```
+
+Likewise, if the relationship is severed using either of the examples from above:
+
+<!--
+            using var context = new BlogsContext();
+
+            var blog = context.Blogs.OrderBy(e => e.Name).Include(e => e.Posts).First();
+
+            foreach (var post in blog.Posts)
+            {
+                post.Blog = null;
+            }
+            
+            context.SaveChanges();
+-->
+[!code-csharp[Severing_a_relationship_1b](../../../samples/core/CascadeDeletes/IntroOptionalSamples.cs?name=Severing_a_relationship_1b)]
+
+Or:
+
+<!--
+            using var context = new BlogsContext();
+
+            var blog = context.Blogs.OrderBy(e => e.Name).Include(e => e.Posts).First();
+
+            blog.Posts.Clear();
+            
+            context.SaveChanges();
+-->
+[!code-csharp[Severing_a_relationship_2b](../../../samples/core/CascadeDeletes/IntroOptionalSamples.cs?name=Severing_a_relationship_2b)]
+
+Then the posts are updated with null foreign key values when SaveChanges is called:
+
+```sql
+-- Executed DbCommand (2ms) [Parameters=[@p1='1', @p0=NULL (DbType = Int32)], CommandType='Text', CommandTimeout='30']
+SET NOCOUNT ON;
+UPDATE [Posts] SET [BlogId] = @p0
+WHERE [Id] = @p1;
+SELECT @@ROWCOUNT;
+
+-- Executed DbCommand (0ms) [Parameters=[@p1='2', @p0=NULL (DbType = Int32)], CommandType='Text', CommandTimeout='30']
+SET NOCOUNT ON;
+UPDATE [Posts] SET [BlogId] = @p0
+WHERE [Id] = @p1;
+SELECT @@ROWCOUNT;
+```
+
+See [Changing Foreign Keys and Navigations](xref:core/change-tracking/relationship-changes) for more information on how EF Core manages foreign keys and navigations as their values are changed.
+
+> [!NOTE]
+> The fixup of relationships like this has been the default behavior of Entity Framework since the first version in 2008. Prior to EF Core it didn't have a name and was not possible to change. It is now known as `ClientSetNull` as described in the next section.
+
+Databases can also be configured to cascade nulls like this when a principal/parent in an optional relationship is deleted. However, this is much less common than using cascading deletes in the database. Using cascading deletes and cascading nulls in the database at the same time will almost always result in relationship cycles when using SQL Server. See the next section for more information on configuring cascading nulls.
+
+## Configuring cascading behaviors
+
+> [!TIP]
+> Be sure to read sections above before coming here. The configuration options will likely not make sense if the preceding material is not understood.
+
+Cascade behaviors are configured per relationship using the <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.ReferenceCollectionBuilder.OnDelete*> method in <xref:Microsoft.EntityFrameworkCore.DbContext.OnModelCreating*>. For example:
+
+<!--
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder
+                .Entity<Blog>()
+                .HasOne(e => e.Owner)
+                .WithOne(e => e.OwnedBlog)
+                .OnDelete(DeleteBehavior.ClientCascade);
+        }
+-->
+[!code-csharp[OnModelCreating](../../../samples/core/CascadeDeletes/WithDatabaseCycleSamples.cs?name=OnModelCreating)]
+
+See [Relationships](xref:core/modeling/relationships) for more information on configuring relationships between entity types.
+
+`OnDelete` accepts a value from the, admittedly confusing, <xref:Microsoft.EntityFrameworkCore.DeleteBehavior> enum. This enum defines both the behavior of EF Core on tracked entities, and the configuration of cascade delete in the database when EF is used to create the schema.
+
+### Impact on database schema
+
+The following table shows the result of each `OnDelete` value on the foreign key constraint created by EF Core migrations or <xref:Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade.EnsureCreated*>.
+
+| DeleteBehavior        | Impact on database schema
+|:----------------------|--------------------------
+| Cascade               | ON DELETE CASCADE
+| Restrict              | ON DELETE RESTRICT
+| NoAction              | database default
+| SetNull               | ON DELETE SET NULL
+| ClientSetNull         | database default
+| ClientCascade         | database default
+| ClientNoAction        | database default
+
+The behaviors of `ON DELETE NO ACTION` (the database default) and `ON DELETE RESTRICT` in relational databases are typically either identical or very similar. Despite what `NO ACTION` may imply, both of these options cause referential constraints to be enforced. The difference, when there is one, is _when_ the database checks the constraints.  Check your database documentation for the specific differences between `ON DELETE NO ACTION` and `ON DELETE RESTRICT` on your database system.
+
+SQL Server doesn't support `ON DELETE RESTRICT`, so `ON DELETE NO ACTION` is used instead.
+
+The only values that will cause cascading behaviors on the database are `Cascade` and `SetNull`. All other values will configure the database to not cascade any changes.
+
+### Impact on SaveChanges behavior
+
+The tables in the following sections cover what happens to dependent/child entities when the principal/parent is deleted, or its relationship to the dependent/child entities is severed. Each table covers one of:
+
+- Optional (nullable FK) and required (non-nullable FK) relationships
+- When dependents/children are loaded and tracked by the DbContext and when they exist only in the database
+
+#### Required relationship with dependents/children loaded
+
+| DeleteBehavior    | On deleting principal/parent             | On severing from principal/parent
+|:------------------|------------------------------------------|----------------------------------------
+| Cascade           | Dependents deleted by EF Core            | Dependents deleted by EF Core
+| Restrict          | `InvalidOperationException`              | `InvalidOperationException`
+| NoAction          | `InvalidOperationException`              | `InvalidOperationException`
+| SetNull           | `SqlException` on creating database      | `SqlException` on creating database
+| ClientSetNull     | `InvalidOperationException`              | `InvalidOperationException`
+| ClientCascade     | Dependents deleted by EF Core            | Dependents deleted by EF Core
+| ClientNoAction    | `DbUpdateException`                      | `InvalidOperationException`
+
+Notes:
+
+- The default for required relationships like this is `Cascade`.
+- Using anything other than cascade delete for required relationships will result in an exception when SaveChanges is called.
+  - Typically, this is an `InvalidOperationException` from EF Core since the invalid state is detected in the loaded children/dependents.
+  - `ClientNoAction` forces EF Core to not check fixup dependents before sending them to the database, so in this case the database throws an exception, which is then wrapped in a `DbUpdateException` by SaveChanges.
+  - `SetNull` is rejected when creating the database since the foreign key column is not nullable.
+- Since dependents/children are loaded, they are always deleted by EF Core, and never left for the database to delete.
+
+#### Required relationship with dependents/children not loaded
+
+| DeleteBehavior    | On deleting principal/parent             | On severing from principal/parent
+|:------------------|------------------------------------------|----------------------------------------
+| Cascade           | Dependents deleted by database           | N/A
+| Restrict          | `DbUpdateException`                      | N/A
+| NoAction          | `DbUpdateException`                      | N/A
+| SetNull           | `SqlException` on creating database      | N/A
+| ClientSetNull     | `DbUpdateException`                      | N/A
+| ClientCascade     | `DbUpdateException`                      | N/A
+| ClientNoAction    | `DbUpdateException`                      | N/A
+
+Notes:
+
+- Severing a relationship is not valid here since the dependents/children are not loaded.
+- The default for required relationships like this is `Cascade`.
+- Using anything other than cascade delete for required relationships will result in an exception when SaveChanges is called.
+  - Typically, this is a `DbUpdateException` because the dependents/children are not loaded, and hence the invalid state can only be detected by the database. SaveChanges then wraps the database exception in a `DbUpdateException`.
+  - `SetNull` is rejected when creating the database since the foreign key column is not nullable.
+
+#### Optional relationship with dependents/children loaded
+
+| DeleteBehavior    | On deleting principal/parent             | On severing from principal/parent
+|:------------------|------------------------------------------|----------------------------------------
+| Cascade           | Dependents deleted by EF Core            | Dependents deleted by EF Core
+| Restrict          | Dependent FKs set to null by EF Core     | Dependent FKs set to null by EF Core
+| NoAction          | Dependent FKs set to null by EF Core     | Dependent FKs set to null by EF Core
+| SetNull           | Dependent FKs set to null by EF Core     | Dependent FKs set to null by EF Core
+| ClientSetNull     | Dependent FKs set to null by EF Core     | Dependent FKs set to null by EF Core
+| ClientCascade     | Dependents deleted by EF Core            | Dependents deleted by EF Core
+| ClientNoAction    | `DbUpdateException`                      | Dependent FKs set to null by EF Core
+
+Notes:
+
+- The default for optional relationships like this is `ClientSetNull`.
+- Dependents/children are never deleted unless `Cascade` or `ClientCascade` are configured.
+- All other values cause the dependent FKs to be set to null by EF Core...
+  - ...except `ClientNoAction` which tells EF Core not to touch the foreign keys of dependents/children when the principal/parent is deleted. The database therefore throws an exception, which is wrapped as a `DbUpdateException` by SaveChanges.
+
+#### Optional relationship with dependents/children not loaded
+
+| DeleteBehavior    | On deleting principal/parent             | On severing from principal/parent
+|:------------------|------------------------------------------|----------------------------------------
+| Cascade           | Dependents deleted by database           | N/A
+| Restrict          | `DbUpdateException`                      | N/A
+| NoAction          | `DbUpdateException`                      | N/A
+| SetNull           | Dependent FKs set to null by database    | N/A
+| ClientSetNull     | `DbUpdateException`                      | N/A
+| ClientCascade     | `DbUpdateException`                      | N/A
+| ClientNoAction    | `DbUpdateException`                      | N/A
+
+Notes:
+
+- Severing a relationship is not valid here since the dependents/children are not loaded.
+- The default for optional relationships like this is `ClientSetNull`.
+- Dependents/children must be loaded to avoid a database exception unless the database has been configured to cascade either deletes or nulls.
diff --git a/entity-framework/core/saving/concurrency.md b/entity-framework/core/saving/concurrency.md
new file mode 100644
index 0000000000..213e6eb9b8
--- /dev/null
+++ b/entity-framework/core/saving/concurrency.md
@@ -0,0 +1,178 @@
+---
+title: Handling Concurrency Conflicts - EF Core
+description: Managing conflicts when the same data is updated concurrently with Entity Framework Core
+author: SamMonoRT
+ms.date: 10/19/2022
+uid: core/saving/concurrency
+---
+# Handling Concurrency Conflicts
+
+> [!TIP]
+> You can view this article's [sample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Saving/Concurrency/) on GitHub.
+
+In most scenarios, databases are used concurrently by multiple application instances, each performing modifications to data independently of each other. When the same data gets modified at the same time, inconsistencies and data corruption can occur, e.g. when two clients modify different columns in the same row which are related in some way. This page discusses mechanisms for ensuring that your data stays consistent in the face of such concurrent changes.
+
+## Optimistic concurrency
+
+EF Core implements *optimistic concurrency*, which assumes that concurrency conflicts are relatively rare. In contrast to *pessimistic* approaches - which lock data up-front and only then proceed to modify it - optimistic concurrency takes no locks, but arranges for the data modification to fail on save if the data has changed since it was queried. This concurrency failure is reported to the application, which deals with it accordingly, possibly by retrying the entire operation on the new data.
+
+In EF Core, optimistic concurrency is implemented by configuring a property as a *concurrency token*. The concurrency token is loaded and tracked when an entity is queried - just like any other property. Then, when an update or delete operation is performed during <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges>, the value of the concurrency token on the database is compared against the original value read by EF Core.
+
+To understand how this works, let's assume we're on SQL Server, and define a typical Person entity type with a special `Version` property:
+
+```csharp
+public class Person
+{
+    public int PersonId { get; set; }
+    public string FirstName { get; set; }
+    public string LastName { get; set; }
+
+    [Timestamp]
+    public byte[] Version { get; set; }
+}
+```
+
+In SQL Server, this configures a concurrency token that automatically changes in the database every time the row is changed (more details are available below). With this configuration in place, let's examine what happens with a simple update operation:
+
+```csharp
+var person = await context.People.SingleAsync(b => b.FirstName == "John");
+person.FirstName = "Paul";
+await context.SaveChangesAsync();
+```
+
+1. In the first step, a Person is loaded from the database; this includes the concurrency token, which is now tracked as usual by EF along with the rest of the properties.
+2. The Person instance is then modified in some way - we change the `FirstName` property.
+3. We then instruct EF Core to persist the modification. Since a concurrency token is configured, EF Core sends the following SQL to the database:
+
+```sql
+UPDATE [People] SET [FirstName] = @p0
+WHERE [PersonId] = @p1 AND [Version] = @p2;
+```
+
+Note that in addition to the `PersonId` in the WHERE clause, EF Core has added a condition for `Version` as well; this only modifies the row if the `Version` column hasn't changed since the moment we queried it.
+
+In the normal ("optimistic") case, no concurrent update occurs and the UPDATE completes successfully, modifying the row; the database reports to EF Core that one row was affected by the UPDATE, as expected. However, if a concurrent update occurred, the UPDATE fails to find any matching rows and reports that zero were affected. As a result, EF Core's <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges> throws a <xref:Microsoft.EntityFrameworkCore.DbUpdateConcurrencyException>, which the application must catch and handle appropriately. Techniques for doing this are detailed below, under [Resolving concurrency conflicts](#resolving-concurrency-conflicts).
+
+While the above examples discussed *updates* to existing entities. EF also throws <xref:Microsoft.EntityFrameworkCore.DbUpdateConcurrencyException> when attempting to *delete* a row that has been concurrently modified. However, this exception is generally never thrown when adding entities; while the database may indeed raise a unique constraint violation if rows with the same key are being inserted, this results in a provider-specific exception being thrown, and not <xref:Microsoft.EntityFrameworkCore.DbUpdateConcurrencyException>.
+
+## Native database-generated concurrency tokens
+
+In the code above, we used the `[Timestamp]` attribute to map a property to a SQL Server [`rowversion`](/sql/t-sql/data-types/rowversion-transact-sql) column. Since `rowversion` automatically changes when the row is updated, it's very useful as a minimum-effort concurrency token that protects the entire row. Configuring a SQL Server `rowversion` column as a concurrency token is done as follows:
+
+### [Data Annotations](#tab/data-annotations)
+
+```c#
+public class Person
+{
+    public int PersonId { get; set; }
+    public string FirstName { get; set; }
+    public string LastName { get; set; }
+
+    [Timestamp]
+    public byte[] Version { get; set; }
+}
+```
+
+### [Fluent API](#tab/fluent-api)
+
+```c#
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Person>()
+        .Property(p => p.Version)
+        .IsRowVersion();
+}
+```
+
+***
+
+The `rowversion` type shown above is a SQL Server-specific feature; the details on setting up an automatically-updating concurrency token differ across databases, and some databases don't support these at all (e.g. SQLite). Consult your provider documentation for the precise details.
+
+## Application-managed concurrency tokens
+
+Rather than have the database manage the concurrency token automatically, you can manage it in application code. This allows using optimistic concurrency on databases - like SQLite - where no native automatically-updating type exists. But even on SQL Server, an application-managed concurrency token can provide fine-grained control on exactly which column changes cause the token to be regenerated. For example, you may have a property containing some cached or unimportant value, and don't want a change to that property to trigger a concurrency conflict.
+
+The following configures a GUID property to be a concurrency token:
+
+### [Data Annotations](#tab/data-annotations)
+
+```c#
+public class Person
+{
+    public int PersonId { get; set; }
+    public string FirstName { get; set; }
+
+    [ConcurrencyCheck]
+    public Guid Version { get; set; }
+}
+```
+
+### [Fluent API](#tab/fluent-api)
+
+```c#
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Person>()
+        .Property(p => p.Version)
+        .IsConcurrencyToken();
+}
+```
+
+***
+
+Since this property isn't database-generated, you must assign it in application whenever persisting changes:
+
+```c#
+var person = await context.People.SingleAsync(b => b.FirstName == "John");
+person.FirstName = "Paul";
+person.Version = Guid.NewGuid();
+await context.SaveChangesAsync();
+```
+
+If you want a new GUID value to always be assigned, you can do this via a [`SaveChanges` interceptor](xref:core/logging-events-diagnostics/interceptors#savechanges-interception). However, one advantage of manually managing the concurrency token is that you can control precisely when it gets regenerated, to avoid needless concurrency conflicts.
+
+## Resolving concurrency conflicts
+
+Regardless of how your concurrency token is set up, to implement optimistic concurrency, your application must properly handle the case where a concurrency conflict occurs and <xref:Microsoft.EntityFrameworkCore.DbUpdateConcurrencyException> is thrown; this is called *resolving a concurrency conflict*.
+
+One option is to simply inform the user that the update failed due to conflicting changes; the user can then load the new data and try again. Or if your application is performing an automated update, it can simply loop and retry immediately, after re-querying the data.
+
+A more sophisticated way to resolve concurrency conflicts is to *merge* the pending changes with the new values in the database. The precise details of which values get merged depend on the application, and the process may be directed by a user interface, where both sets of values are displayed.
+
+There are three sets of values available to help resolve a concurrency conflict:
+
+- **Current values** are the values that the application was attempting to write to the database.
+- **Original values** are the values that were originally retrieved from the database, before any edits were made.
+- **Database values** are the values currently stored in the database.
+
+The general approach to handle a concurrency conflict is:
+
+1. Catch `DbUpdateConcurrencyException` during `SaveChanges`.
+2. Use `DbUpdateConcurrencyException.Entries` to prepare a new set of changes for the affected entities.
+3. Refresh the original values of the concurrency token to reflect the current values in the database.
+4. Retry the process until no conflicts occur.
+
+In the following example, `Person.FirstName` and `Person.LastName` are set up as concurrency tokens. There is a `// TODO:` comment in the location where you include application specific logic to choose the value to be saved.
+
+[!code-csharp[Main](../../../samples/core/Saving/Concurrency/ConflictResolutionSample.cs?name=ConcurrencyHandlingCode&highlight=33-34)]
+
+## Using isolation levels for concurrency control
+
+Optimistic concurrency via concurrency tokens isn't the only way to ensure that data stays consistent in the face of concurrent changes.
+
+One mechanism to ensure consistency is the *repeatable reads* transaction isolation level. In most databases, this level guarantees that a transaction sees data in the database as it was when the transaction started, without being affected by any subsequent concurrent activity. Taking our basic sample from above, when we query for the `Person` in order to update it in some way, the database must make sure no other transactions interfere with that database row until the transaction completes. Depending on your database implementation, this happens in one of two ways:
+
+1. When the row is queried, your transaction takes a shared lock on it. Any external transaction attempting to update the row will block until your transaction completes. This is a form of pessimistic locking, and is implemented by the SQL Server "repeatable read" isolation level.
+2. Rather than locking, the database allows the external transaction to update the row, but when your own transaction attempts to do the update, a "serialization" error will be raised, indicating that a concurrency conflict occurred. This is a form of optimistic locking - not unlike EF's concurrency token feature - and is implemented by the SQL Server snapshot isolation level, as well as by the PostgreSQL repeatable reads isolation level.
+
+Note that the "serializable" isolation level provides the same guarantees as repeatable read (and adds additional ones), so it functions in the same way with respect to the above.
+
+Using a higher isolation level to manage concurrency conflicts is simpler, doesn't require concurrency tokens, and provides other advantages; for example, repeatable reads guarantee that your transaction always sees the same data across queries inside the transaction, avoiding inconsistencies. However, this approach does have its drawbacks.
+
+First, if your database implementation uses locking to implement the isolation level, then other transactions attempting to modify the same row must block for the entirety of the transaction. This could have an adverse effect on concurrent performance (keep your transaction short!), although note that EF's mechanism throws an exception and forces you to retry instead, which also has an impact. This applies to the SQL Server repeatable read level, but not to the snapshot level, which does not lock queried rows.
+
+More importantly, this approach requires a transaction to span all the operations. If you, say, query `Person` in order to display its details to a user, and then wait for the user to make changes, then the transaction must stay alive for a potentially long time, which should be avoided in most cases. As a result, this mechanism is usually appropriate when all contained operations executed immediately and the transaction doesn't depend on external inputs which may increase its duration.
+
+## Additional resources
+
+See [Conflict detection in EF Core](/aspnet/core/data/ef-rp/concurrency#conflict-detection-in-ef-core) for an ASP.NET Core sample with conflict detection.
diff --git a/entity-framework/core/saving/disconnected-entities.md b/entity-framework/core/saving/disconnected-entities.md
new file mode 100644
index 0000000000..6732214b94
--- /dev/null
+++ b/entity-framework/core/saving/disconnected-entities.md
@@ -0,0 +1,134 @@
+---
+title: Disconnected Entities - EF Core
+description: Working with disconnected, untracked entities across multiple context instances in Entity Framework Core
+author: SamMonoRT
+ms.date: 10/27/2016
+uid: core/saving/disconnected-entities
+---
+# Disconnected entities
+
+A DbContext instance will automatically track entities returned from the database. Changes made to these entities will then be detected when SaveChanges is called and the database will be updated as needed. See [Basic Save](xref:core/saving/basic) and [Related Data](xref:core/saving/related-data) for details.
+
+However, sometimes entities are queried using one context instance and then saved using a different instance. This often happens in "disconnected" scenarios such as a web application where the entities are queried, sent to the client, modified, sent back to the server in a request, and then saved. In this case, the second context instance needs to know whether the entities are new (should be inserted) or existing (should be updated).
+
+<!-- markdownlint-disable MD028 -->
+> [!TIP]
+> You can view this article's [sample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Saving/Disconnected/) on GitHub.
+
+> [!TIP]
+> EF Core can only track one instance of any entity with a given primary key value. The best way to avoid this being an issue is to use a short-lived context for each unit-of-work such that the context starts empty, has entities attached to it, saves those entities, and then the context is disposed and discarded.
+<!-- markdownlint-enable MD028 -->
+
+## Identifying new entities
+
+### Client identifies new entities
+
+The simplest case to deal with is when the client informs the server whether the entity is new or existing. For example, often the request to insert a new entity is different from the request to update an existing entity.
+
+The remainder of this section covers the cases where it is necessary to determine in some other way whether to insert or update.
+
+### With auto-generated keys
+
+The value of an automatically generated key can often be used to determine whether an entity needs to be inserted or updated. If the key has not been set (that is, it still has the CLR default value of null, zero, etc.), then the entity must be new and needs inserting. On the other hand, if the key value has been set, then it must have already been previously saved and now needs updating. In other words, if the key has a value, then the entity was queried, sent to the client, and has now come back to be updated.
+
+It is easy to check for an unset key when the entity type is known:
+
+[!code-csharp[Main](../../../samples/core/Saving/Disconnected/Sample.cs#IsItNewSimple)]
+
+However, EF also has a built-in way to do this for any entity type and key type:
+
+[!code-csharp[Main](../../../samples/core/Saving/Disconnected/Sample.cs#IsItNewGeneral)]
+
+> [!TIP]
+> Keys are set as soon as entities are tracked by the context, even if the entity is in the Added state. This helps when traversing a graph of entities and deciding what to do with each, such as when using the TrackGraph API. The key value should only be used in the way shown here _before_ any call is made to track the entity.
+
+### With other keys
+
+Some other mechanism is needed to identify new entities when key values are not generated automatically. There are two general approaches to this:
+
+* Query for the entity
+* Pass a flag from the client
+
+To query for the entity, just use the Find method:
+
+[!code-csharp[Main](../../../samples/core/Saving/Disconnected/Sample.cs#IsItNewQuery)]
+
+It is beyond the scope of this document to show the full code for passing a flag from a client. In a web app, it usually means making different requests for different actions, or passing some state in the request then extracting it in the controller.
+
+## Saving single entities
+
+If it is known whether or not an insert or update is needed, then either Add or Update can be used appropriately:
+
+[!code-csharp[Main](../../../samples/core/Saving/Disconnected/Sample.cs#InsertAndUpdateSingleEntity)]
+
+However, if the entity uses auto-generated key values, then the Update method can be used for both cases:
+
+[!code-csharp[Main](../../../samples/core/Saving/Disconnected/Sample.cs#InsertOrUpdateSingleEntity)]
+
+The Update method normally marks the entity for update, not insert. However, if the entity has an auto-generated key, and no key value has been set, then the entity is instead automatically marked for insert.
+
+If the entity is not using auto-generated keys, then the application must decide whether the entity should be inserted or updated: For example:
+
+[!code-csharp[Main](../../../samples/core/Saving/Disconnected/Sample.cs#InsertOrUpdateSingleEntityWithFind)]
+
+The steps here are:
+
+* If Find returns null, then the database doesn't already contain the blog with this ID, so we call Add mark it for insertion.
+* If Find returns an entity, then it exists in the database and the context is now tracking the existing entity
+  * We then use SetValues to set the values for all properties on this entity to those that came from the client.
+  * The SetValues call will mark the entity to be updated as needed.
+
+> [!TIP]
+> SetValues will only mark as modified the properties that have different values to those in the tracked entity. This means that when the update is sent, only those columns that have actually changed will be updated. (And if nothing has changed, then no update will be sent at all.)
+
+## Working with graphs
+
+### Identity resolution
+
+As noted above, EF Core can only track one instance of any entity with a given primary key value. When working with graphs the graph should ideally be created such that this invariant is maintained, and the context should be used for only one unit-of-work. If the graph does contain duplicates, then it will be necessary to process the graph before sending it to EF to consolidate multiple instances into one. This may not be trivial where instances have conflicting values and relationships, so consolidating duplicates should be done as soon as possible in your application pipeline to avoid conflict resolution.
+
+### All new/all existing entities
+
+An example of working with graphs is inserting or updating a blog together with its collection of associated posts. If all the entities in the graph should be inserted, or all should be updated, then the process is the same as described above for single entities. For example, a graph of blogs and posts created like this:
+
+[!code-csharp[Main](../../../samples/core/Saving/Disconnected/Sample.cs#CreateBlogAndPosts)]
+
+can be inserted like this:
+
+[!code-csharp[Main](../../../samples/core/Saving/Disconnected/Sample.cs#InsertGraph)]
+
+The call to Add will mark the blog and all the posts to be inserted.
+
+Likewise, if all the entities in a graph need to be updated, then Update can be used:
+
+[!code-csharp[Main](../../../samples/core/Saving/Disconnected/Sample.cs#UpdateGraph)]
+
+The blog and all its posts will be marked to be updated.
+
+### Mix of new and existing entities
+
+With auto-generated keys, Update can again be used for both inserts and updates, even if the graph contains a mix of entities that require inserting and those that require updating:
+
+[!code-csharp[Main](../../../samples/core/Saving/Disconnected/Sample.cs#InsertOrUpdateGraph)]
+
+Update will mark any entity in the graph, blog or post, for insertion if it does not have a key value set, while all other entities are marked for update.
+
+As before, when not using auto-generated keys, a query and some processing can be used:
+
+[!code-csharp[Main](../../../samples/core/Saving/Disconnected/Sample.cs#InsertOrUpdateGraphWithFind)]
+
+## Handling deletes
+
+Delete can be tricky to handle since often the absence of an entity means that it should be deleted. One way to deal with this is to use "soft deletes" such that the entity is marked as deleted rather than actually being deleted. Deletes then becomes the same as updates. Soft deletes can be implemented using [query filters](xref:core/querying/filters).
+
+For true deletes, a common pattern is to use an extension of the query pattern to perform what is essentially a graph diff. For example:
+
+[!code-csharp[Main](../../../samples/core/Saving/Disconnected/Sample.cs#InsertUpdateOrDeleteGraphWithFind)]
+
+## TrackGraph
+
+Internally, Add, Attach, and Update use graph-traversal with a determination made for each entity as to whether it should be marked as Added (to insert), Modified (to update), Unchanged (do nothing), or Deleted (to delete). This mechanism is exposed via the TrackGraph API. For example, let's assume that when the client sends back a graph of entities it sets some flag on each entity indicating how it should be handled. TrackGraph can then be used to process this flag:
+
+[!code-csharp[Main](../../../samples/core/Saving/Disconnected/Sample.cs#TrackGraph)]
+
+The flags are only shown as part of the entity for simplicity of the example. Typically the flags would be part of a DTO or some other state included in the request.
diff --git a/entity-framework/core/saving/execute-insert-update-delete.md b/entity-framework/core/saving/execute-insert-update-delete.md
new file mode 100644
index 0000000000..1e4760b84e
--- /dev/null
+++ b/entity-framework/core/saving/execute-insert-update-delete.md
@@ -0,0 +1,214 @@
+---
+title: ExecuteUpdate and ExecuteDelete - EF Core
+description: Using ExecuteUpdate and ExecuteDelete to save changes with Entity Framework Core
+author: roji
+ms.date: 4/30/2023
+uid: core/saving/execute-insert-update-delete
+---
+# ExecuteUpdate and ExecuteDelete
+
+<xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.ExecuteUpdate*> and <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.ExecuteDelete*> are a way to save data to the database without using EF's traditional change tracking and <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges> method. For an introductory comparison of these two techniques, see the [Overview page](xref:core/saving/index) on saving data.
+
+## ExecuteDelete
+
+Let's assume that you need to delete all Blogs with a rating below a certain threshold. The traditional <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges> approach requires you to do the following:
+
+```c#
+await foreach (var blog in context.Blogs.Where(b => b.Rating < 3).AsAsyncEnumerable())
+{
+    context.Blogs.Remove(blog);
+}
+
+await context.SaveChangesAsync();
+```
+
+This is quite an inefficient way to perform this task: we query the database for all Blogs matching our filter, and then we query, materialize and track all those instances; the number of matching entities could be huge. We then tell EF's change tracker that each Blog needs to be removed, and apply those changes by calling <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges>, which generates a `DELETE` statement for each and every one of them.
+
+Here is the same task performed via the <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.ExecuteDelete*> API:
+
+```c#
+await context.Blogs.Where(b => b.Rating < 3).ExecuteDeleteAsync();
+```
+
+This uses the familiar LINQ operators to determine which Blogs should be affected - just as if we were querying them - and then tells EF to execute a SQL `DELETE` against the database:
+
+```sql
+DELETE FROM [b]
+FROM [Blogs] AS [b]
+WHERE [b].[Rating] < 3
+```
+
+Aside from being simpler and shorter, this executes very efficiently in the database, without loading any data from the database or involving EF's change tracker. Note that you can use arbitrary LINQ operators to select which Blogs you'd like to delete - these are translated to SQL for execution at the database, just as if you were querying those Blogs out.
+
+## ExecuteUpdate
+
+Rather than deleting these Blogs, what if we wanted to change a property to indicate that they should be hidden instead? <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.ExecuteUpdate*> provides a similar way to express a SQL `UPDATE` statement:
+
+```c#
+await context.Blogs
+    .Where(b => b.Rating < 3)
+    .ExecuteUpdateAsync(setters => setters.SetProperty(b => b.IsVisible, false));
+```
+
+Like with `ExecuteDelete`, we first use LINQ to determine which Blogs should be affected; but with `ExecuteUpdate` we also need to express the change to be applied to the matching Blogs. This is done by calling `SetProperty` within the `ExecuteUpdate` call, and providing it with two arguments: the property to be changed (`IsVisible`), and the new value it should have (`false`). This causes the following SQL to be executed:
+
+```sql
+UPDATE [b]
+SET [b].[IsVisible] = CAST(0 AS bit)
+FROM [Blogs] AS [b]
+WHERE [b].[Rating] < 3
+```
+
+### Updating multiple properties
+
+`ExecuteUpdate` allows updating multiple properties in a single invocation. For example, to both set `IsVisible` to false and to set `Rating` to zero, simply chain additional `SetProperty` calls together:
+
+```c#
+await context.Blogs
+    .Where(b => b.Rating < 3)
+    .ExecuteUpdateAsync(setters => setters
+        .SetProperty(b => b.IsVisible, false)
+        .SetProperty(b => b.Rating, 0));
+```
+
+This executes the following SQL:
+
+```sql
+UPDATE [b]
+SET [b].[Rating] = 0,
+    [b].[IsVisible] = CAST(0 AS bit)
+FROM [Blogs] AS [b]
+WHERE [b].[Rating] < 3
+```
+
+### Referencing the existing property value
+
+The above examples updated the property to a new constant value. `ExecuteUpdate` also allows referencing the existing property value when calculating the new value; for example, to increase the rating of all matching Blogs by one, use the following:
+
+```c#
+await context.Blogs
+    .Where(b => b.Rating < 3)
+    .ExecuteUpdateAsync(setters => setters.SetProperty(b => b.Rating, b => b.Rating + 1));
+```
+
+Note that the second argument to `SetProperty` is now a lambda function, and not a constant as before. Its `b` parameter represents the Blog being updated; within that lambda, `b.Rating` thus contains the rating before any change occurred. This executes the following SQL:
+
+```sql
+UPDATE [b]
+SET [b].[Rating] = [b].[Rating] + 1
+FROM [Blogs] AS [b]
+WHERE [b].[Rating] < 3
+```
+
+### Navigations and related entities
+
+`ExecuteUpdate` does not currently support referencing navigations within the `SetProperty` lambda. For example, let's say we want to update all the Blogs' ratings so that each Blog's new rating is the average of all its Posts' ratings. We may try to use `ExecuteUpdate` as follows:
+
+```c#
+await context.Blogs.ExecuteUpdateAsync(
+    setters => setters.SetProperty(b => b.Rating, b => b.Posts.Average(p => p.Rating)));
+```
+
+However, EF does allow performing this operation by first using `Select` to calculate the average rating and project it to an anonymous type, and then using `ExecuteUpdate` over that:
+
+```c#
+await context.Blogs
+    .Select(b => new { Blog = b, NewRating = b.Posts.Average(p => p.Rating) })
+    .ExecuteUpdateAsync(setters => setters.SetProperty(b => b.Blog.Rating, b => b.NewRating));
+```
+
+This executes the following SQL:
+
+```sql
+UPDATE [b]
+SET [b].[Rating] = CAST((
+    SELECT AVG(CAST([p].[Rating] AS float))
+    FROM [Post] AS [p]
+    WHERE [b].[Id] = [p].[BlogId]) AS int)
+FROM [Blogs] AS [b]
+```
+
+## Change tracking
+
+Users familiar with `SaveChanges` are used to performing multiple changes, and then calling `SaveChanges` to apply all these changes to the database; this is made possible by EF's change tracker, which accumulates - or tracks - these changes.
+
+`ExecuteUpdate` and `ExecuteDelete` work quite differently: they take effect immediately, at the point in which they are invoked. This means that while a single `ExecuteUpdate` or `ExecuteDelete` operation can affect many rows, it isn't possible to accumulate multiple such operations and apply them at once, e.g. when calling `SaveChanges`. In fact, the functions are completely unaware of EF's change tracker, and have no interaction with it whatsoever. This has several important consequences.
+
+Consider the following code:
+
+```c#
+// 1. Query the blog with the name `SomeBlog`. Since EF queries are tracking by default, the Blog is now tracked by EF's change tracker.
+var blog = await context.Blogs.SingleAsync(b => b.Name == "SomeBlog");
+
+// 2. Increase the rating of all blogs in the database by one. This executes immediately.
+await context.Blogs.ExecuteUpdateAsync(setters => setters.SetProperty(b => b.Rating, b => b.Rating + 1));
+
+// 3. Increase the rating of `SomeBlog` by two. This modifies the .NET `Rating` property and is not yet persisted to the database.
+blog.Rating += 2;
+
+// 4. Persist tracked changes to the database.
+await context.SaveChangesAsync();
+```
+
+Crucially, when `ExecuteUpdate` is invoked and all Blogs are updated in the database, EF's change tracker is **not** updated, and the tracked .NET instance still has its original rating value, from the point at which it was queried. Let's assume that the Blog's rating was originally 5; after the 3rd line executes, the rating in the database is now 6 (because of the `ExecuteUpdate`), whereas the rating in the tracked .NET instance is 7. When `SaveChanges` is called, EF detects that the new value 7 is different from the original value 5, and persists that change. The change performed by `ExecuteUpdate` is overwritten and not taken into account.
+
+As a result, it is usually a good idea to avoid mixing both tracked `SaveChanges` modifications and untracked modifications via `ExecuteUpdate`/`ExecuteDelete`.
+
+## Transactions
+
+Continuing on the above, it's important to understand that `ExecuteUpdate` and `ExecuteDelete` do not implicitly start a transaction when they're invoked. Consider the following code:
+
+```c#
+await context.Blogs.ExecuteUpdateAsync(/* some update */);
+await context.Blogs.ExecuteUpdateAsync(/* another update */);
+
+var blog = await context.Blogs.SingleAsync(b => b.Name == "SomeBlog");
+blog.Rating += 2;
+await context.SaveChangesAsync();
+```
+
+Each `ExecuteUpdate` call causes a single SQL `UPDATE` to be sent to the database. Since no transaction is created, if any sort of failure prevents the second `ExecuteUpdate` from completing successfully, the effects of the first one are still persisted to the database. In fact, the four operations above - two invocations of `ExecuteUpdate`, a query and `SaveChanges` - each execute within their own transaction. To wrap multiple operations in a single transaction, explicitly start a transaction with <xref:Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade>:
+
+```c#
+using (var transaction = context.Database.BeginTransaction())
+{
+    context.Blogs.ExecuteUpdate(/* some update */);
+    context.Blogs.ExecuteUpdate(/* another update */);
+
+    ...
+}
+```
+
+For more information about transaction handling, see [Using Transactions](xref:core/saving/transactions).
+
+## Concurrency control and rows affected
+
+`SaveChanges` provides automatic [Concurrency Control](xref:core/saving/concurrency), using a concurrency token to ensure that a row wasn't changed between the moment you loaded it and the moment you save changes to it. Since `ExecuteUpdate` and `ExecuteDelete` do not interact with the change tracker, they cannot automatically apply concurrency control.
+
+However, both these methods do return the number of rows that were affected by the operation; this can come particularly handy for implementing concurrency control yourself:
+
+```c#
+// (load the ID and concurrency token for a Blog in the database)
+
+var numUpdated = await context.Blogs
+    .Where(b => b.Id == id && b.ConcurrencyToken == concurrencyToken)
+    .ExecuteUpdateAsync(/* ... */);
+if (numUpdated == 0)
+{
+    throw new Exception("Update failed!");
+}
+```
+
+In this code, we use a LINQ `Where` operator to apply an update to a specific Blog, and only if its concurrency token has a specific value (e.g. the one we saw when querying the Blog from the database). We then check how many rows were actually updated by `ExecuteUpdate`; if the result is zero, no rows were updated and the concurrency token was likely changed as a result of a concurrent update.
+
+## Limitations
+
+* Only updating and deleting is currently supported; insertion must be done via <xref:Microsoft.EntityFrameworkCore.DbSet`1.Add*?displayProperty=nameWithType> and <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges>.
+* While the SQL UPDATE and DELETE statements allow retrieving original column values for the rows affected, this isn't currently supported by `ExecuteUpdate` and `ExecuteDelete`.
+* Multiple invocations of these methods cannot be batched. Each invocation performs its own roundtrip to the database.
+* Databases typically allow only a single table to be modified with UPDATE or DELETE.
+* These methods currently only work with relational database providers.
+
+## Additional resources
+
+* [.NET Data Access Community Standup session](https://www.youtube.com/watch?v=rrKhbiXydKs&list=PLdo4fOcmZ0oX-DBuRG4u58ZTAJgBAeQ-t&index=33) where we discuss `ExecuteUpdate` and `ExecuteDelete`.
diff --git a/entity-framework/core/saving/index.md b/entity-framework/core/saving/index.md
new file mode 100644
index 0000000000..66fbd8e60a
--- /dev/null
+++ b/entity-framework/core/saving/index.md
@@ -0,0 +1,91 @@
+---
+title: Saving Data - EF Core
+description: Overview of saving data with Entity Framework Core
+author: SamMonoRT
+ms.date: 10/10/2022
+uid: core/saving/index
+---
+# Saving Data
+
+While querying allows you to read data from the database, saving data means adding new entities to the database, removing entities, or modifying the properties of existing entities in some way. Entity Framework Core (EF Core) supports two fundamental approaches for saving data to the database.
+
+## Approach 1: change tracking and SaveChanges
+
+In many scenarios, your program needs to query some data from the database, perform some modification on it, and save those modifications back; this is sometimes referred to as a "unit of work". For example, let's assume that you have a set of Blogs, and you'd like to change the `Url` property of one of them. In EF, this is typically done as follows:
+
+```c#
+using (var context = new BloggingContext())
+{
+    var blog = await context.Blogs.SingleAsync(b => b.Url == "http://example.com");
+    blog.Url = "http://example.com/blog";
+    await context.SaveChangesAsync();
+}
+```
+
+The code above performs the following steps:
+
+1. It uses a regular LINQ query to load an entity from the database (see [Query data](xref:core/querying/index)). EF's queries are tracking by default, meaning that EF tracks the loaded entities in its internal *change tracker*.
+2. The loaded entity instance is manipulated as usual, by assigning a .NET property. EF isn't involved in this step.
+3. Finally, <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges?displayProperty=nameWithType> is called. At this point, EF automatically detects any changes by comparing the entities with a snapshot from the moment they were loaded. Any detected changes are persisted to the database; when using a relational database, this typically involves sending e.g. a SQL `UPDATE` to update the relevant rows.
+
+Note that the above described a typical update operation for existing data, but similar principles hold for *adding* and *removing* entities. You interact with EF's change tracker by calling <xref:Microsoft.EntityFrameworkCore.DbSet`1.Add*?displayProperty=nameWithType> and <xref:Microsoft.EntityFrameworkCore.DbSet`1.Remove*>, causing the changes to be tracked. EF then applies all tracked changes to the database when <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges> is called (e.g. via SQL `INSERT` and `DELETE` when using a relational database).
+
+<xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges> offers the following advantages:
+
+* You don't need to write code to track which entities and properties changed - EF does this automatically for you, and only updates those properties in the database, improving performance. Imagine if your loaded entities are bound to a UI component, allowing users to change any property they wish; EF takes away the burden of figuring out which entities and properties were actually changed.
+* Saving changes to the database can sometimes be complicated! For example, if you want to add a Blog and some Posts for that blog, you may need to fetch the database-generated key for the inserted Blog before you can insert the Posts (since they need to refer to the Blog). EF does all this for you, taking away the complexity.
+* EF can detect concurrency issues, such as when a database row has been modified by someone else between your query and <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges>. More details are available in [Concurrency conflicts](xref:core/saving/concurrency).
+* On databases which support it, <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges> automatically wraps multiple changes in a transaction, ensuring your data stays consistent if a failure occurs. More details are available in [Transactions](xref:core/saving/transactions).
+* <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges> also batches together multiple changes in many cases, significantly reducing the number of database roundtrips and greatly improving performance. More details are available in [Efficient updating](xref:core/performance/efficient-updating#batching).
+
+For more information and code samples on basic <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges> usage, see [Basic SaveChanges](xref:core/saving/basic). For more information on EF's change tracking, see the [Change tracking overview](xref:core/change-tracking/index).
+
+## Approach 2: ExecuteUpdate and ExecuteDelete ("bulk update")
+
+While change tracking and <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges> are a powerful way to save changes, they do have certain disadvantages.
+
+First, <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges> requires that you query and track all the entities you will be modifying or deleting. If you need to, say, delete all Blogs with a rating below a certain threshold, you must query, materialize and track a potentially huge number of rows, and have <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges> generate a `DELETE` statement for each and every one of them. Relational databases provide a far more efficient alternative: a single `DELETE` command can be sent, specifying which rows to delete via a `WHERE` clause, but the <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges> model doesn't allow for generating that.
+
+To support this "bulk update" scenario, you can use <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.ExecuteDelete*> as follows:
+
+```c#
+context.Blogs.Where(b => b.Rating < 3).ExecuteDelete();
+```
+
+This allows you to express a SQL `DELETE` statement via regular LINQ operators - similar to a regular LINQ query - causing the following SQL to be executed against the database:
+
+```sql
+DELETE FROM [b]
+FROM [Blogs] AS [b]
+WHERE [b].[Rating] < 3
+```
+
+This executes very efficiently in the database, without loading any data from the database or involving EF's change tracker. Similarly, <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.ExecuteUpdate*> allows you to express a SQL `UPDATE` statement.
+
+Even if you aren't changing entities in bulk, you may know exactly which properties of which entity you want to change. Using the change tracking API to perform the change can be overly complex, requiring creating an entity instance, tracking it via <xref:Microsoft.EntityFrameworkCore.DbSet`1.Attach*>, making your changes and finally calling <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges>. For such scenarios, `ExecuteUpdate` and `ExecuteDelete` can be a considerably simpler way to express the same operation.
+
+Finally, both change tracking and <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges> itself impose a certain runtime overhead. If you're writing a high performance application, `ExecuteUpdate` and `ExecuteDelete` allow you to avoid both these components and efficiently generate the statement you want.
+
+However, note that `ExecuteUpdate` and `ExecuteDelete` also have certain limitations:
+
+* These methods execute immediately, and currently cannot be batched with other operations. On the other hand, <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges>, can batch multiple operations together.
+* Since change tracking isn't involved, it's your responsibility to know exactly which entities and properties need to be changed. This may mean more manual, low-level code tracking what needs to change and what doesn't.
+* In addition, since change tracking isn't involved, these methods do not automatically apply [Concurrency Control](xref:core/saving/concurrency) when persisting changes. However, you can still explicitly add a `Where` clause to implement concurrency control yourself.
+* Only updating and deleting is currently supported; insertion must be done via <xref:Microsoft.EntityFrameworkCore.DbSet`1.Add*?displayProperty=nameWithType> and <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges>.
+
+For more information and code samples, see [`ExecuteUpdate` and `ExecuteDelete`](xref:core/saving/execute-insert-update-delete).
+
+## Summary
+
+Following are a few guidelines for when to use which approach. Note that these aren't absolute rules, but provide a useful rules of thumb:
+
+* If you don't know in advance which changes will take place, use `SaveChanges`; it will automatically detect which changes need to be applied. Example scenarios:
+  * "I want to load a Blog from the database and display a form allowing the user to change it"
+* If you need to manipulate a graph of objects (i.e. multiple interconnected objects), use `SaveChanges`; it will figure out the proper ordering of the changes and how to link everything together.
+  * "I want to update a blog, changing some of its posts and deleting others"
+* If you wish to change a potentially large number of entities based on some criterion, use `ExecuteUpdate` and `ExecuteDelete`. Example scenarios:
+  * "I want to give all employees a raise"
+  * "I want to delete all blogs whose name starts with X"
+* If you already know exactly which entities you wish to modify and how you wish to change them, use `ExecuteUpdate` and `ExecuteDelete`. Example scenarios:
+  * "I want to delete the blog whose name is 'Foo'"
+  * "I want to change the name of the blog with Id 5 to 'Bar'"
diff --git a/entity-framework/core/saving/related-data.md b/entity-framework/core/saving/related-data.md
new file mode 100644
index 0000000000..5b5c3cfcee
--- /dev/null
+++ b/entity-framework/core/saving/related-data.md
@@ -0,0 +1,56 @@
+---
+title: Saving Related Data - EF Core
+description: Information on saving graphs of related entities and managing relationships in Entity Framework Core
+author: SamMonoRT
+ms.date: 10/27/2016
+uid: core/saving/related-data
+---
+# Saving Related Data
+
+In addition to isolated entities, you can also make use of the relationships defined in your model.
+
+> [!TIP]
+> You can view this article's [sample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Saving/RelatedData/) on GitHub.
+
+## Adding a graph of new entities
+
+If you create several new related entities, adding one of them to the context will cause the others to be added too.
+
+In the following example, the blog and three related posts are all inserted into the database. The posts are found and added, because they are reachable via the `Blog.Posts` navigation property.
+
+[!code-csharp[Main](../../../samples/core/Saving/RelatedData/Sample.cs#AddingGraphOfEntities)]
+
+> [!TIP]
+> Use the EntityEntry.State property to set the state of just a single entity. For example, `context.Entry(blog).State = EntityState.Modified`.
+
+## Adding a related entity
+
+If you reference a new entity from the navigation property of an entity that is already tracked by the context, the entity will be discovered and inserted into the database.
+
+In the following example, the `post` entity is inserted because it is added to the `Posts` property of the `blog` entity which was fetched from the database.
+
+[!code-csharp[Main](../../../samples/core/Saving/RelatedData/Sample.cs#AddingRelatedEntity)]
+
+## Changing relationships
+
+If you change the navigation property of an entity, the corresponding changes will be made to the foreign key column in the database.
+
+In the following example, the `post` entity is updated to belong to the new `blog` entity because its `Blog` navigation property is set to point to `blog`. Note that `blog` will also be inserted into the database because it is a new entity that is referenced by the navigation property of an entity that is already tracked by the context (`post`).
+
+[!code-csharp[Main](../../../samples/core/Saving/RelatedData/Sample.cs#ChangingRelationships)]
+
+## Removing relationships
+
+You can remove a relationship by setting a reference navigation to `null`, or removing the related entity from a collection navigation.
+
+Removing a relationship can have side effects on the dependent entity, according to the cascade delete behavior configured in the relationship.
+
+By default, for required relationships, a cascade delete behavior is configured and the child/dependent entity will be deleted from the database. For optional relationships, cascade delete is not configured by default, but the foreign key property will be set to null.
+
+See [Required and Optional Relationships](xref:core/modeling/relationships#optional-and-required-relationships) to learn about how the requiredness of relationships can be configured.
+
+See [Cascade Delete](xref:core/saving/cascade-delete) for more details on how cascade delete behaviors work, how they can be configured explicitly and  how they are selected by convention.
+
+In the following example, a cascade delete is configured on the relationship between `Blog` and `Post`, so the `post` entity is deleted from the database.
+
+[!code-csharp[Main](../../../samples/core/Saving/RelatedData/Sample.cs#RemovingRelationships)]
diff --git a/entity-framework/core/saving/transactions.md b/entity-framework/core/saving/transactions.md
new file mode 100644
index 0000000000..6788e93d87
--- /dev/null
+++ b/entity-framework/core/saving/transactions.md
@@ -0,0 +1,119 @@
+---
+title: Transactions - EF Core
+description: Managing transactions for atomicity when saving data with Entity Framework Core
+author: roji
+ms.date: 9/26/2020
+uid: core/saving/transactions
+---
+# Using Transactions
+
+Transactions allow several database operations to be processed in an atomic manner. If the transaction is committed, all of the operations are successfully applied to the database. If the transaction is rolled back, none of the operations are applied to the database.
+
+> [!TIP]
+> You can view this article's [sample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Saving/Transactions/) on GitHub.
+
+## Default transaction behavior
+
+By default, if the database provider supports transactions, all changes in a single call to `SaveChanges` are applied in a transaction. If any of the changes fail, then the transaction is rolled back and none of the changes are applied to the database. This means that `SaveChanges` is guaranteed to either completely succeed, or leave the database unmodified if an error occurs.
+
+For most applications, this default behavior is sufficient. You should only manually control transactions if your application requirements deem it necessary.
+
+## Controlling transactions
+
+You can use the `DbContext.Database` API to begin, commit, and rollback transactions. The following example shows two `SaveChanges` operations and a LINQ query being executed in a single transaction:
+
+[!code-csharp[Main](../../../samples/core/Saving/Transactions/ControllingTransaction.cs?name=Transaction&highlight=2,16-18)]
+
+While all relational database providers support transactions, other providers types may throw or no-op when transaction APIs are called.
+
+> [!NOTE]
+> Manually controlling transactions in this way is incompatible with implicitly invoked retrying execution strategies. See [Connection Resiliency](xref:core/miscellaneous/connection-resiliency#execution-strategies-and-transactions) for more information.
+
+## Savepoints
+
+When `SaveChanges` is invoked and a transaction is already in progress on the context, EF automatically creates a *savepoint* before saving any data. Savepoints are points within a database transaction which may later be rolled back to, if an error occurs or for any other reason. If `SaveChanges` encounters any error, it automatically rolls the transaction back to the savepoint, leaving the transaction in the same state as if it had never started. This allows you to possibly correct issues and retry saving, in particular when [optimistic concurrency](xref:core/saving/concurrency) issues occur.
+
+> [!WARNING]
+> Savepoints are incompatible with SQL Server's Multiple Active Result Sets (MARS). Savepoints will not be created by EF when MARS is enabled on the connection, even if MARS is not actively in use. If an error occurs during SaveChanges, the transaction may be left in an unknown state.
+
+It's also possible to manually manage savepoints, just as it is with transactions. The following example creates a savepoint within a transaction, and rolls back to it on failure:
+
+[!code-csharp[Main](../../../samples/core/Saving/Transactions/ManagingSavepoints.cs?name=Savepoints&highlight=9,19-20)]
+
+## Cross-context transaction
+
+You can also share a transaction across multiple context instances. This functionality is only available when using a relational database provider because it requires the use of `DbTransaction` and `DbConnection`, which are specific to relational databases.
+
+To share a transaction, the contexts must share both a `DbConnection` and a `DbTransaction`.
+
+### Allow connection to be externally provided
+
+Sharing a `DbConnection` requires the ability to pass a connection into a context when constructing it.
+
+The easiest way to allow `DbConnection` to be externally provided, is to stop using the `DbContext.OnConfiguring` method to configure the context and externally create `DbContextOptions` and pass them to the context constructor.
+
+> [!TIP]
+> `DbContextOptionsBuilder` is the API you used in `DbContext.OnConfiguring` to configure the context, you are now going to use it externally to create `DbContextOptions`.
+
+[!code-csharp[Main](../../../samples/core/Saving/Transactions/SharingTransaction.cs?name=Context&highlight=3,4,5)]
+
+An alternative is to keep using `DbContext.OnConfiguring`, but accept a `DbConnection` that is saved and then used in `DbContext.OnConfiguring`.
+
+```csharp
+public class BloggingContext : DbContext
+{
+    private DbConnection _connection;
+
+    public BloggingContext(DbConnection connection)
+    {
+      _connection = connection;
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder.UseSqlServer(_connection);
+    }
+}
+```
+
+### Share connection and transaction
+
+You can now create multiple context instances that share the same connection. Then use the `DbContext.Database.UseTransaction(DbTransaction)` API to enlist both contexts in the same transaction.
+
+[!code-csharp[Main](../../../samples/core/Saving/Transactions/SharingTransaction.cs?name=Transaction&highlight=1-4,7,15,22-24)]
+
+## Using external DbTransactions (relational databases only)
+
+If you are using multiple data access technologies to access a relational database, you may want to share a transaction between operations performed by these different technologies.
+
+The following example, shows how to perform an ADO.NET SqlClient operation and an Entity Framework Core operation in the same transaction.
+
+[!code-csharp[Main](../../../samples/core/Saving/Transactions/ExternalDbTransaction.cs?name=Transaction&highlight=4,9,20,25-27)]
+
+## Using System.Transactions
+
+It is possible to use ambient transactions if you need to coordinate across a larger scope.
+
+[!code-csharp[Main](../../../samples/core/Saving/Transactions/AmbientTransaction.cs?name=Transaction&highlight=1,2,3,26-28)]
+
+It is also possible to enlist in an explicit transaction.
+
+[!code-csharp[Main](../../../samples/core/Saving/Transactions/CommitableTransaction.cs?name=Transaction&highlight=1-2,15,28-30)]
+
+> [!NOTE]
+> If you're using async APIs, be sure to specify [TransactionScopeAsyncFlowOption.Enabled](/dotnet/api/system.transactions.transactionscopeasyncflowoption) in the `TransactionScope` constructor to ensure that the ambient transaction flows across async calls.
+
+For more information on `TransactionScope` and ambient transactions, [see this documentation](/dotnet/framework/data/transactions/implementing-an-implicit-transaction-using-transaction-scope).
+
+### Limitations of System.Transactions
+
+1. EF Core relies on database providers to implement support for System.Transactions. If a provider does not implement support for System.Transactions, it is possible that calls to these APIs will be completely ignored. SqlClient supports it.
+
+   > [!IMPORTANT]
+   > It is recommended that you test that the API behaves correctly with your provider before you rely on it for managing transactions. You are encouraged to contact the maintainer of the database provider if it does not.
+
+2. Distributed transaction support in System.Transactions was added to .NET 7.0 for Windows only. Any attempt to use distributed transactions on older .NET versions or on non-Windows platforms will fail.
+
+3. TransactionScope does not support async commit/rollback; that means that disposing it synchronously blocks the executing thread until the operation is complete.
diff --git a/entity-framework/core/testing/_static/fake-provider-and-repository-pattern.png b/entity-framework/core/testing/_static/fake-provider-and-repository-pattern.png
new file mode 100644
index 0000000000..860e68338e
Binary files /dev/null and b/entity-framework/core/testing/_static/fake-provider-and-repository-pattern.png differ
diff --git a/entity-framework/core/testing/_static/fake-provider-and-repository-pattern.xml b/entity-framework/core/testing/_static/fake-provider-and-repository-pattern.xml
new file mode 100644
index 0000000000..00eb9d506d
--- /dev/null
+++ b/entity-framework/core/testing/_static/fake-provider-and-repository-pattern.xml
@@ -0,0 +1 @@
+<mxfile host="app.diagrams.net" modified="2021-11-02T21:10:12.218Z" agent="5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/94.0.4606.104 Safari/537.36" etag="OJO2gix77F34yKq73hS7" version="15.6.6" type="device"><diagram id="v9ad4cJjRyrfpDr2_PBp" name="Page-1">7Vpbk6I4FP41Vs0+OAVBQB9b256Zqp7a3vVhtp+2IqQx05HQMba6v34TCWAI3vEy0z7JOQmJnO87lxxoOL3x/AuDyeg7DRFpACucN5z7BgC2Z9viR2oWSmMDL9VEDIdKVygG+D+klJbSTnGIJtpETinhONGVAY1jFHBNBxmjM33aCyX6rgmMkKEYBJCY2h845KNU23atQv8V4WiU7WxbamQMs8lKMRnBkM5WVE6/4fQYpTy9Gs97iEjrZXZJ73tYM5r/MYZivssNP5vWv1+fHyP3DTWbPra+8Ga/qVZ5h2SqHnjw16NQDBB7R0z9cb7IrCGeIZGXwYLgOETMaTjd2QhzNEhgIAdmggZCN+JjIiRbXA7pVMwMH4e5AgavEZPaP6dcLIOUfpJib7vi+gUT0qOEMqEI0QucEi5ncEZfkal/oTGvmJ3ZWy6uHhMxjuZr7WfnqAg+IzpGnC3ElOyGtgJSUdnJ5FnBC0+pRiuUyKZBxcQoX7kAS1wovPbAzjXgQaHgrhIp4yMa0RiSfqHtshQNMW4JqZjzSGmiTPUTcb5QjginnOpwojnm/8jbP7tKel4ZuZ+rlZfCQglr8FmDJoFDRLo5SSrgriRHagxpgc34CoPRKQvQBsMCFWcgixDfMM+p5gtDBHL8rv+P2tEHhufeJQnBgdiaxsuAGCKDIAX89nbP3Q+2alS2glm3lwLb1bzUtk0vtUGFm3qnclPHAKr/IOQeZTd8hGxdGh9vEz7e0ghDkQm9SF7p2bE8mjD6LsoVM2+eHdfak59bSn4Xh61twGamwzi8kyWgLFgInExwoBtaT4bb885euAjDssVKppTic5YdpVDkyqW0WJWeEMPCTIitpNO9s+6p06S3Y5pcw6wV5rgVxMl0O2dTtcMTxeJBcuK2LD3etDolQqaPqe5aLZ/LC7mlhVqlhVI7GAstyZ0/9uF8t82E/03meRFzwmmQJv2r4n9OWbA7Zw91mpNz3dmR696RJWE19xy/xL1yVN2ZxNsWOjWJW3sl2zciEqXY6Fv8HY2ptNBpMm7N1D9PSgbl8+jFU3JW2pVDFEcTjuPoWuOT/4HiU+qAtQcoUEqOwD8wQNkdfSHHPXOA8g0K3xpiawKQC/QA1PIv3BCz22aIuc6O2MFxpIY8VGPUsTs7hh1wbF10HC86hlPfemXSgd1r65Vlh/hbM2YTbvkZNkuSnYvjZjY5r6za++27MZnFt5eAfjW5ztOP8Vt6zPHAgZWiX6oU3XLJeeJKEZhH2d+vH1PN2kOdqU6279p8BO0jK4817Cu9xnAPbSv6vh7Ljer41DT+pc7stR6/D+oAXITDayL2kRxul85vzqFdRd8qHQTP3FUE5iu8v1FCJ5inPUM4lkVdPJwkOYAfus6//DtXUNFm4dOhXIsGrx8QIq/sixeHyLEMiMxkcPruylla83UG9fauQR0cGdSPc0Dz9flH/irFOFFf3v3MTsg95HAIJwIfsan3NpUfjnYf4CsqJLML8sl4ifaHga+wG9dB1OGKqexJa1gpFSQ4imUpKOwsj8ddiQIOILlTA2MchstAUMUaPThomB7o9lKrQgmw6qGG7fufSy9NK7iRHUarTsz1c8PstqzWO9YT5AIN8/x5w3lTkWSfEWchFh9+p2Vw8f280/8f</diagram></mxfile>
\ No newline at end of file
diff --git a/entity-framework/core/testing/advanced-topics.md b/entity-framework/core/testing/advanced-topics.md
new file mode 100644
index 0000000000..14ec2b88cd
--- /dev/null
+++ b/entity-framework/core/testing/advanced-topics.md
@@ -0,0 +1,36 @@
+---
+title: Advanced testing topics - EF Core
+description: Advanced Entity Framework Core testing topics
+author: AndriySvyryd
+ms.date: 11/21/2025
+uid: core/testing/advanced-topics
+---
+# Advanced testing topics
+
+This page described some less common topics related to testing EF Core applications.
+
+## EnableServiceProviderCaching
+
+EF Core uses an internal service provider to manage services required for database operations, including query compilation, model building, and other core functionality. By default, EF Core caches these internal service providers to improve performance when multiple `DbContext` instances share the same configuration.
+
+The <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.EnableServiceProviderCaching*> method controls whether EF Core caches the internal service provider:
+
+```csharp
+public class ApplicationDbContext : DbContext
+{
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .EnableServiceProviderCaching(false)
+            .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Test");
+    }
+}
+```
+
+**Default behavior**: Service provider caching is **enabled by default** (`true`). This means:
+
+- Service providers are cached and reused across `DbContext` instances with the same configuration
+- Better performance for applications that create many `DbContext` instances
+- Lower memory overhead when multiple contexts share configurations
+
+**When to disable caching**: Disabling service provider caching will greatly slow down `DbContext` creation and in the vast majority of cases the default behavior is recommended. If there are issues with incorrect internal services used, then they should be fixed in a different way. But if you are replacing services for testing purposes you could disable service provider caching (`false`) to ensure each test gets a fresh service provider.
diff --git a/entity-framework/core/testing/choosing-a-testing-strategy.md b/entity-framework/core/testing/choosing-a-testing-strategy.md
new file mode 100644
index 0000000000..371997f0e2
--- /dev/null
+++ b/entity-framework/core/testing/choosing-a-testing-strategy.md
@@ -0,0 +1,116 @@
+---
+title: Choosing a testing strategy - EF Core
+description: Different approaches to testing applications that use Entity Framework Core
+author: roji
+ms.date: 11/07/2021
+uid: core/testing/choosing-a-testing-strategy
+---
+# Choosing a testing strategy
+
+As discussed in the [Overview](xref:core/testing/index), a basic decision you need to make is whether your tests will involve your production database system - just as your application does - or whether your tests will run against a [test double](https://martinfowler.com/bliki/TestDouble.html), which replaces your production database system.
+
+Testing against a real external resource - rather than replacing it with a test double - can involve the following difficulties:
+
+1. In many cases, it's simply not possible or practical to test against the actual external resource. For example, your application may interact with some service that cannot be easily tested against (because of rate limiting, or the lack of a testing environment).
+2. Even when it's possible to involve the real external resource, this may be exceedingly slow: running a large amount of tests against a cloud service may cause tests to take too long. Testing should be part of the developer's everyday workflow, so it's important that tests run quickly.
+3. Executing tests against an external resource may involve isolation issues, where tests interfere with one another. For example, multiple tests running in parallel against a database may modify data and cause each other to fail in various ways. Using a test double avoids this, as each test runs against its own, in-memory resource, and is therefore naturally isolated from other tests.
+
+However, tests which pass against a test double don't guarantee that your program works when running against the real external resource. For example, a database test double may perform case-sensitive string comparisons, whereas the production database system does case-insensitive comparisons. Such issues are only uncovered when tests are executed against your real production database, making these tests an important part of any testing strategy.
+
+## Testing against the database may be easier than it seems
+
+Because of the above difficulties with testing against a real database, developers are frequently urged to use test doubles first, and have a robust test suite which they can run frequently on their machines; tests involving the database, in contrast, are supposed to be executed much less frequently, and in many cases also provide far less coverage. We recommend giving more thought to the latter, and suggest that databases may actually be far less affected by the above problems than people tend to think:
+
+1. Most databases can nowadays be easily installed on the developer's machine. Container-based technologies such as Docker can make this very easy, and libraries like [Testcontainers](https://dotnet.testcontainers.org/) can help automate the lifecycle of containerized databases in your tests. Technologies such as [GitHub Workspaces](https://docs.github.com/en/codespaces/overview) and [Dev Container](https://code.visualstudio.com/docs/remote/create-dev-container) set up your entire development environment for you (including the database). When using SQL Server, it's also possible to test against [LocalDB](/sql/database-engine/configure-windows/sql-server-express-localdb) on Windows, or easily set up a Docker image on Linux.
+2. Testing against a local database - with a reasonable test dataset - is usually extremely fast: communication is completely local, and test data is typically buffered in memory on the database side. EF Core itself contains over 30,000 tests against SQL Server alone; these complete reliably in a few minutes, execute in CI on every single commit, and are very frequently executed by developers locally. Some developers turn to an in-memory database (a "fake") in the belief that this is needed for speed - this is almost never actually the case.
+3. Isolation is indeed a hurdle when running tests against a real database, as tests may modify data and interfere with one another. However, there are various techniques to provide isolation in database testing scenarios; we concentrate on these in [Testing against your production database system](xref:core/testing/testing-with-the-database)).
+
+The above is not meant to disparage test doubles or to argue against using them. For one thing, test doubles are necessary for some scenarios which cannot be tested otherwise, such as simulating database failure. However, in our experience, users frequently shy away from testing against their database for the above reasons, believing it's slow, hard or unreliable, when that isn't necessarily the case. [Testing against your production database system](xref:core/testing/testing-with-the-database) aims to address this, providing guidelines and samples for writing fast, isolated tests against your database.
+
+## Different types of test doubles
+
+[Test doubles](https://martinfowler.com/bliki/TestDouble.html) is a broad term which encompasses very different approaches. This section covers some common techniques involving test doubles for testing EF Core applications:
+
+1. Use SQLite (in-memory mode) as a database fake, replacing your production database system.
+2. Use the EF Core in-memory provider as a database fake, replacing your production database system.
+3. Mock or stub out `DbContext` and `DbSet`.
+4. Introduce a repository layer between EF Core and your application code, and mock or stub that layer.
+
+Below, we'll explore what each method means, and compare it with the others. We recommend reading through the different methods to gain a full understanding of each one. If you've decided to write tests which don't involve your production database system, then a repository layer is the only approach allowing the comprehensive and reliable stubbing/mocking of the data layer. However, that approach has a significant cost in terms of implementation and maintenance.
+
+### SQLite as a database fake
+
+One possible testing approach is to swap your production database (e.g. SQL Server) with SQLite, effectively using it as a testing "fake". Aside from ease of setup, SQLite has an [in-memory database](https://sqlite.org/inmemorydb.html) feature which is especially useful for testing: each test is naturally isolated in its own in-memory database, and no actual files need to be managed.
+
+However, before doing this, it's important to understand that in EF Core, different database providers behave differently - EF Core does not attempt to abstract every aspect of the underlying database system. Fundamentally, this means that testing against SQLite does not guarantee the same results as against SQL Server, or any other database. Here are some examples of possible behavioral differences:
+
+* The same LINQ query may return different results on different providers. For example, SQL Server does case-insensitive string comparison by default, whereas SQLite is case-sensitive. This can make your tests pass against SQLite where they would fail against SQL Server (or vice versa).
+* Some queries which work on SQL Server simply aren't supported on SQLite, because the exact SQL support in these two database differs.
+* If your query happens to use a provider-specific method such as SQL Server's [`EF.Functions.DateDiffDay`](xref:core/providers/sql-server/functions#date-and-time-functions), that query will fail on SQLite, and cannot be tested.
+* Raw SQL may work, or it may fail or return different results, depending on exactly what is being done. SQL dialects are different in many ways across databases.
+
+Compared to running tests against your production database system, it's relatively easy to get started with SQLite, and so many users do. Unfortunately, the above limitations tend to eventually become problematic when testing EF Core applications, even if they don't seem to be at the beginning. As a result, we recommend either writing your tests against your real database, or if using a test double is an absolute necessity, taking onboard the cost of a repository pattern as discussed below.
+
+For information on how to use SQLite for testing, [see this section](xref:core/testing/testing-without-the-database#sqlite-in-memory).
+
+### In-memory as a database fake
+
+As an alternative to SQLite, EF Core also comes with an in-memory provider. Although this provider was originally designed to support internal testing of EF Core itself, some developers use it as a database fake when testing EF Core applications. Doing so is **highly discouraged**: as a database fake, in-memory has the same issues as SQLite (see above), but in addition has the following additional limitations:
+
+* The in-memory provider generally supports fewer query types than the SQLite provider, since it isn't a relational database. More queries will fail or behave differently in comparison to your production database.
+* Transactions are not supported.
+* Raw SQL is completely unsupported. Compare this with SQLite, where it's possible to use raw SQL, as long as that SQL works in the same way on SQLite and your production database.
+* The in-memory provider has not been optimized for performance, and will generally work slower than SQLite in in-memory mode (or even your production database system).
+
+In summary, in-memory has all the disadvantages of SQLite, along with a few more - and offers no advantages in return. If you are looking for a simple, in-memory database fake, use SQLite instead of the in-memory provider; but consider using the repository pattern instead as described below.
+
+For information on how to use in-memory for testing, see the [see this section](xref:core/testing/testing-without-the-database#inmemory).
+
+### Mocking or stubbing DbContext and DbSet
+
+This approach typically uses a mock framework to create a test double of `DbContext` and `DbSet`, and tests against those doubles. Mocking `DbContext` can be a good approach for testing various *non-query* functionality, such as calls to <xref:Microsoft.EntityFrameworkCore.DbContext.Add*> or <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges>, allowing you to verify that your code called them in write scenarios.
+
+However, properly mocking `DbSet` *query* functionality is not possible, since queries are expressed via LINQ operators, which are static extension method calls over `IQueryable`. As a result, when some people talk about "mocking `DbSet`", what they really mean is that they create a `DbSet` backed by an in-memory collection, and then evaluate query operators against that collection in memory, just like a simple `IEnumerable`. Rather than a mock, this is actually a sort of fake, where the in-memory collection replaces the the real database.
+
+Since only the `DbSet` itself is faked and the query is evaluated in-memory, this approach ends up being very similar to using the EF Core in-memory provider: both techniques execute query operators in .NET over an in-memory collection. As a result, this technique suffers from the same drawbacks as well: queries will behave differently (e.g. around case sensitivity) or will simply fail (e.g. because of provider-specific methods), raw SQL won't work and transactions will be ignored at best. As a result, this technique should generally be avoided for testing any query code.
+
+### Repository pattern
+
+The approaches above attempted to either swap EF Core's production database provider with a fake testing provider, or to create a `DbSet` backed by an in-memory collection. These techniques are similar in that they still evaluate the program's LINQ queries - either in SQLite or in memory - and this is ultimately the source of the difficulties outlined above: a query designed to execute against a specific production database cannot reliably execute elsewhere without issues.
+
+For a proper, reliable test double, consider introducing a [repository layer](https://martinfowler.com/eaaCatalog/repository.html) which mediates between your application code and EF Core. The production implementation of the repository contains the actual LINQ queries and executes them via EF Core. In testing, the repository abstraction is directly stubbed or mocked without needing any actual LINQ queries, effectively removing EF Core from your testing stack altogether and allowing tests to focus on application code alone.
+
+The following diagram compares the database fake approach (SQLite/in-memory) with the repository pattern:
+
+![Comparison of fake provider with repository pattern](_static/fake-provider-and-repository-pattern.png)
+
+Since LINQ queries are no longer part of testing, you can directly provide query results to your application. Put another way, the previous approaches roughly allow stubbing out *query inputs* (e.g. replacing SQL Server *tables* with in-memory ones), but then still execute the actual query operators in-memory. The repository pattern, in contrast, allows you to stub out *query outputs* directly, allowing for far more powerful and focused unit testing. Note that for this to work, your repository cannot expose any IQueryable-returning methods, as these once again cannot be stubbed out; IEnumerable should be returned instead.
+
+However, since the repository pattern requires encapsulating each and every (testable) LINQ query in an IEnumerable-returning method, it imposes an additional architectural layer on your application, and can incur significant cost to implement and maintain. This cost should not be discounted when making a choice on how to test an application, especially given that tests against the real database are still likely to be needed for the queries exposed by the repository.
+
+It's worth noting that repositories do have advantages outside of just testing. They ensure all data access code is concentrated in one place rather than being spread around the application, and if your application needs to support more than one database, then the repository abstraction can be very helpful for tweaking queries across providers.
+
+For a sample showing testing with a repository, [see this section](xref:core/testing/testing-without-the-database#repository-pattern).
+
+## Overall comparison
+
+The following table provides a quick, comparative view of the different testing techniques, and shows which functionality can be tested under which approach:
+
+Feature                                   | In-memory    | SQLite in-memory          | Mock DbContext | Repository pattern | Testing against the database
+----------------------------------------- | ------------ | ------------------------- | -------------- | ------------------ | ----------------------------
+Test double type                          | Fake         | Fake                      | Fake           | Mock/stub          | Real, no double
+Raw SQL?                                  | No           | Depends                   | No             | Yes                | Yes
+Transactions?                             | No (ignored) | Yes                       | Yes            | Yes                | Yes
+Provider-specific translations?           | No           | No                        | No             | Yes                | Yes
+Exact query behavior?                     | Depends      | Depends                   | Depends        | Yes                | Yes
+Can use LINQ anywhere in the application? | Yes          | Yes                       | Yes            | No*                | Yes
+
+<sup>*</sup> All testable database LINQ queries must be encapsulated in IEnumerable-returning repository methods, in order to be stubbed/mocked.
+
+## Summary
+
+* We recommend that developers have good test coverage of their application running against their actual production database system. This provides confidence that the application actually works in production, and with proper design, tests can execute reliably and quickly. Since these tests are required in any case, it's a good idea to start there, and if needed, add tests using test doubles later, as required.
+* If you've decided to use a test double, we recommend implementing the repository pattern, which allows you to stub or mock out your data access layer above EF Core, rather than using a fake EF Core provider (Sqlite/in-memory) or by mocking `DbSet`.
+* If the repository pattern isn't a viable option for some reason, consider using SQLite in-memory databases.
+* Avoid the in-memory provider for testing purposes - this is discouraged and only supported for legacy applications.
+* Avoid mocking `DbSet` for querying purposes.
diff --git a/entity-framework/core/testing/index.md b/entity-framework/core/testing/index.md
new file mode 100644
index 0000000000..f745459b15
--- /dev/null
+++ b/entity-framework/core/testing/index.md
@@ -0,0 +1,26 @@
+---
+title: Overview of testing applications that use EF Core - EF Core
+description: Overview of testing applications that use Entity Framework Core
+author: roji
+ms.date: 01/17/2021
+uid: core/testing/index
+---
+# Testing EF Core Applications
+
+Testing is an important concern to almost all application types - it allows you to be sure your application works correctly, and makes it instantly known if its behavior regresses in the future. Since testing may affect how your code is architected, it's highly recommended to plan for testing early and to ensure good coverage as your application evolves. This introductory section provides a quick overview of various testing strategies for applications using EF Core.
+
+## Involving the database (or not)
+
+When writing tests for your EF Core application, one basic decision you need to make is whether your tests will involve your production database system - just as your application does - or whether your tests will run against a [test double](https://martinfowler.com/bliki/TestDouble.html), which replaces your production database system. Two prominent examples of test doubles in the EF Core context are [SQLite in-memory mode](xref:core/testing/choosing-a-testing-strategy#sqlite-as-a-database-fake), and the [in-memory provider](xref:core/testing/choosing-a-testing-strategy#inmemory-as-a-database-fake).
+
+For an in-depth comparison and analysis of the different approaches, see [Choosing a testing strategy](xref:core/testing/choosing-a-testing-strategy). Below is a short point-by-point summary to help you get up to speed with the different options:
+
+* Developers frequently avoid testing against their production database system because they believe this is difficult or slow. This isn't always true in our experience, and we suggest giving this approach a chance: [Testing against your production database system](xref:core/testing/testing-with-the-database) provides techniques for doing this reliably and efficiently. Writing at least some tests against your database is usually necessary in any case - to make sure your application actually works against your production database - and tests not involving the database can be limited in what they allow you to test (see below).
+* The [in-memory provider](xref:core/testing/choosing-a-testing-strategy#inmemory-as-a-database-fake) will not behave like your real database in many important ways. Some features cannot be tested with it at all (e.g. transactions, raw SQL..), while other features may behave differently than your production database (e.g. case-sensitivity in queries). While in-memory can work for simple, constrained query scenarios, it is highly limited and we discourage its use.
+  * Mocking `DbSet` for querying is complex and difficult, and suffers from the same disadvantages as the in-memory approach; we discourage this as well.
+* [SQLite in-memory mode](xref:core/testing/choosing-a-testing-strategy#sqlite-as-a-database-fake) offers better compatibility with production relational databases, since SQLite is itself a full-fledged relational database. However, there will still be some important discrepancies between SQLite and your production database, and some features cannot be tested at all (e.g. provider-specific methods on EF.Functions).
+* For a testing approach that allows you to use a reliable test double for all the functionality of your production database system, it's possible to introduce a [repository layer](xref:core/testing/choosing-a-testing-strategy#repository-pattern) in your application. This allows you to exclude EF Core entirely from testing and to fully mock the repository; however, this alters the architecture of your application in a way which could be significant, and involves more implementation and maintenance costs.
+
+## Further reading
+
+For more in-depth information, see [Choosing a testing strategy](xref:core/testing/choosing-a-testing-strategy). For implementation guidelines and code samples, see [Testing against your production database system](xref:core/testing/testing-with-the-database) and [Testing without your production database system](xref:core/testing/testing-without-the-database).
diff --git a/entity-framework/core/testing/testing-with-the-database.md b/entity-framework/core/testing/testing-with-the-database.md
new file mode 100644
index 0000000000..fe33124490
--- /dev/null
+++ b/entity-framework/core/testing/testing-with-the-database.md
@@ -0,0 +1,134 @@
+---
+title: Testing against your Production Database System - EF Core
+description: Techniques for testing EF Core applications against your production database system
+author: roji
+ms.date: 1/24/2022
+uid: core/testing/testing-with-the-database
+---
+# Testing against your production database system
+
+In this page, we discuss techniques for writing automated tests which involve the database system against which the application runs in production. Alternate testing approaches exist, where the production database system is swapped out by test doubles; see the [testing overview page](xref:core/testing/index) for more information. Note that testing against a different database than what is used in production (e.g. Sqlite) is not covered here, since the different database is used as a test double; this approach is covered in [Testing without your production database system](xref:core/testing/testing-without-the-database).
+
+The main hurdle with testing which involves a real database is to ensure proper test isolation, so that tests running in parallel (or even in serial) don't interfere with each other. The full sample code for the below can be viewed [here](https://github.com/dotnet/EntityFramework.Docs/blob/main/samples/core/Testing/TestingWithTheDatabase).
+
+> [!TIP]
+> This page shows [xUnit](https://xunit.net/) techniques, but similar concepts exist in other testing frameworks, including [NUnit](https://nunit.org/).
+
+## Setting up your database system
+
+Most database systems nowadays can be easily installed, both in CI environments and on developer machines. While it's frequently easy enough to install the database via the regular installation mechanism, ready-to-use Docker images are available for most major databases and can make installation particularly easy in CI. Libraries like [Testcontainers](https://dotnet.testcontainers.org/) can further simplify this by automatically managing containerized database instances during testing. For the developer environment, [GitHub Workspaces](https://docs.github.com/en/codespaces/overview), [Dev Container](https://code.visualstudio.com/docs/remote/create-dev-container) can set up all needed services and dependencies - including the database. While this requires an initial investment in setup, once that's done you have a working testing environment and can concentrate on more important things.
+
+In certain cases, databases have a special edition or version which can be helpful for testing. When using SQL Server, [LocalDB](/sql/database-engine/configure-windows/sql-server-express-localdb) can be used to run tests locally with virtually no setup at all, spinning up the database instance on demand and possibly saving resources on less powerful developer machines. However, LocalDB is not without its issues:
+
+* It doesn't support everything that [SQL Server Developer Edition](/sql/sql-server/editions-and-components-of-sql-server-version-15#-editions) does.
+* It's only available on Windows.
+* It can cause lag on first test run as the service is spun up.
+
+We generally recommend installing SQL Server Developer edition rather than LocalDB, since it provides the full SQL Server feature set and is generally very easy to do.
+
+When using a cloud database, it's usually appropriate to test against a local version of the database, both to improve speed and to decrease costs. For example, when using SQL Azure in production, you can test against a locally-installed SQL Server - the two are extremely similar (though it's still wise to run tests against SQL Azure itself before going into production). When using Azure Cosmos DB, [the Azure Cosmos DB emulator](/azure/cosmos-db/local-emulator) is a useful tool both for developing locally and for running tests.
+
+## Creating, seeding and managing a test database
+
+Once your database is installed, you're ready to start using it in your tests. In most simple cases, your test suite has a single database that's shared between multiple tests across multiple test classes, so we need some logic to make sure the database is created and seeded exactly once during the lifetime of the test run.
+
+When using Xunit, this can be done via a [class fixture](https://xunit.net/docs/shared-context#class-fixture), which represents the database and is shared across multiple test runs:
+
+[!code-csharp[Main](../../../samples/core/Testing/TestingWithTheDatabase/TestDatabaseFixture.cs?name=TestDatabaseFixture)]
+
+When the above fixture is instantiated, it uses <xref:Microsoft.EntityFrameworkCore.Storage.IDatabaseCreator.EnsureDeleted> to drop the database (in case it exists from a previous run), and then <xref:Microsoft.EntityFrameworkCore.Storage.IDatabaseCreator.EnsureCreated> to create it with your latest model configuration ([see the docs for these APIs](xref:core/managing-schemas/ensure-created)). Once the database is created, the fixture seeds it with some data our tests can use. It's worth spending some time thinking about your seed data, since changing it later for a new test may cause existing tests to fail.
+
+To use the fixture in a test class, simply implement `IClassFixture` over your fixture type, and xUnit will inject it into your constructor:
+
+[!code-csharp[Main](../../../samples/core/Testing/TestingWithTheDatabase/BloggingControllerTest.cs?name=UsingTheFixture)]
+
+Your test class now has a `Fixture` property which can be used by tests to create a fully functional context instance:
+
+[!code-csharp[Main](../../../samples/core/Testing/TestingWithTheDatabase/BloggingControllerTest.cs?name=GetBlog&highlight=4)]
+
+Finally, you may have noticed some locking in the fixture's creation logic above. If the fixture is only used in a single test class, it is guaranteed to be instantiated exactly once by xUnit; but it's common to use the same database fixture in multiple test classes. xUnit does provide [collection fixtures](https://xunit.net/docs/shared-context#collection-fixture), but that mechanism prevents your test classes from running in parallel, which is important for test performance. To safely manage this with an xUnit class fixture, we take a simple lock around database creation and seeding, and use a static flag to make sure we never have to do it twice.
+
+## Tests which modify data
+
+The above example showed a read-only test, which is the easy case from a test isolation standpoint: since nothing is being modified, test interference isn't possible. In contrast, tests which modify data are more problematic, since they may interfere with one another. One common technique to isolate writing tests is to wrap the test in a transaction, and to have that transaction rolled back at the end of the test. Since nothing is actually committed to the database, other tests don't see any modifications and interference is avoided.
+
+Here's a controller method which adds a Blog to our database:
+
+[!code-csharp[Main](../../../samples/core/Testing/BloggingWebApi/Controllers/BloggingController.cs?name=AddBlog)]
+
+We can test this method with the following:
+
+[!code-csharp[Main](../../../samples/core/Testing/TestingWithTheDatabase/BloggingControllerTest.cs?name=AddBlog&highlight=5,10)]
+
+Some notes on the test code above:
+
+* We start a transaction to make sure the changes below aren't committed to the database, and don't interfere with other tests. Since the transaction is never committed, it is implicitly rolled back at the end of the test when the context instance is disposed.
+* After making the updates we want, we clear the context instance's change tracker with <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.Clear*?displayProperty=nameWithType>, to make sure we actually load the blog from the database below. We could use two context instances instead, but we'd then have to make sure the same transaction is used by both instances.
+* You may even want to start the transaction in the fixture's `CreateContext`, so that tests receive a context instance that's already in a transaction, and ready for updates. This can help prevent cases where the transaction is accidentally forgotten, leading to test interference which can be hard to debug. You may also want to separate read-only and write tests in different test classes as well.
+
+## Tests which explicitly manage transactions
+
+There is one final category of tests which presents an additional difficulty: tests which modify data and also explicitly manage transactions. Because databases do not typically support nested transactions, it isn't possible to use transactions for isolation as above, since they need to be used by actual product code. While these tests tend to be more rare, it's necessary to handle them in a special way: you must clean up your database to its original state after each test, and parallelization must be disabled so that these tests don't interfere with each other.
+
+Let's examine the following controller method as an example:
+
+[!code-csharp[Main](../../../samples/core/Testing/BloggingWebApi/Controllers/BloggingController.cs?name=UpdateBlogUrl&highlight=5)]
+
+Let's assume that for some reason, the method requires a serializable transaction to be used (this isn't typically the case). As a result, we cannot use a transaction to guarantee test isolation. Since the test will actually commit changes to the database, we'll define another fixture with its own, separate database, to make sure we don't interfere with the other tests already shown above:
+
+[!code-csharp[Main](../../../samples/core/Testing/TestingWithTheDatabase/TransactionalTestDatabaseFixture.cs?name=TransactionalTestDatabaseFixture)]
+
+This fixture is similar to the one used above, but notably contains a `Cleanup` method; we'll call this after every test to ensure that the database is reset to its starting state.
+
+If this fixture will only be used by a single test class, we can reference it as a class fixture as above - xUnit doesn't parallelize tests within the same class (read more about test collections and parallelization in the [xUnit docs](https://xunit.net/docs/running-tests-in-parallel.html)). If, however, we want to share this fixture between multiple classes, we must make sure these classes don't run in parallel, to avoid any interference. To do that, we will use this as an xUnit [collection fixture](https://xunit.net/docs/shared-context#collection-fixture) rather than as a [class fixture](https://xunit.net/docs/shared-context#class-fixture).
+
+First, we define a *test collection*, which references our fixture and will be used by all transactional test classes which require it:
+
+[!code-csharp[Main](../../../samples/core/Testing/TestingWithTheDatabase/TransactionalTestDatabaseFixture.cs?name=CollectionDefinition)]
+
+We now reference the test collection in our test class, and accept the fixture in the constructor as before:
+
+[!code-csharp[Main](../../../samples/core/Testing/TestingWithTheDatabase/TransactionalBloggingControllerTest.cs?name=UsingTheFixture&highlight=1,4)]
+
+Finally, we make our test class disposable, arranging for the fixture's `Cleanup` method to be called after each test:
+
+[!code-csharp[Main](../../../samples/core/Testing/TestingWithTheDatabase/TransactionalBloggingControllerTest.cs?name=Dispose)]
+
+Note that since xUnit only ever instantiates the collection fixture once, there is no need for us to use locking around database creation and seeding as we did above.
+
+The full sample code for the above can be viewed [here](https://github.com/dotnet/EntityFramework.Docs/blob/main/samples/core/Testing/TestingWithTheDatabase/TransactionalBloggingControllerTest.cs).
+
+> [!TIP]
+> If you have multiple test classes with tests which modify the database, you can still run them in parallel by having different fixtures, each referencing its own database. Creating and using many test databases isn't problematic and should be done whenever it's helpful.
+
+## Efficient database creation
+
+In the samples above, we used <xref:Microsoft.EntityFrameworkCore.Storage.IDatabaseCreator.EnsureDeleted> and <xref:Microsoft.EntityFrameworkCore.Storage.IDatabaseCreator.EnsureCreated> before running tests, to make sure we have an up-to-date test database. These operations can be a bit slow in certain databases, which can be a problem as you iterate over code changes and re-run tests over and over. If that's the case, you may want to temporarily comment out `EnsureDeleted` in your fixture's constructor: this will reuse the same database across test runs.
+
+The disadvantage of this approach is that if you change your EF Core model, your database schema won't be up to date, and tests may fail. As a result, we only recommend doing this temporarily during the development cycle.
+
+## Efficient database cleanup
+
+We saw above that when changes are actually committed to the database, we must clean up the database between every test to avoid interference. In the transactional test sample above, we did this by using EF Core APIs to delete the table's contents:
+
+[!code-csharp[Main](../../../samples/core/Testing/TestingWithTheDatabase/TransactionalTestDatabaseFixture.cs?name=Cleanup)]
+
+This typically isn't the most efficient way to clear out a table. If test speed is a concern, you may want to use raw SQL to delete the table instead:
+
+```sql
+DELETE FROM [Blogs];
+```
+
+You may also want to consider using the [respawn](https://github.com/jbogard/respawn) package, which efficiently clears out a database. In addition, it does not require you to specify the tables to be cleared, and so your cleanup code does not need to be updated as tables are added to your model.
+
+## Summary
+
+* When testing against a real database, it's worth distinguishing between the following test categories:
+  * Read-only tests are relatively simple, and can always execute in parallel against the same database without having to worry about isolation.
+  * Write tests are more problematic, but transactions can be used to make sure they're properly isolated.
+  * Transactional tests are the most problematic, requiring logic to reset the database back to its original state, as well as disabling parallelization.
+* Separating these test categories out into separate classes may avoid confusion and accidental interference between tests.
+* Give some thought up-front to your seeded test data, and try to write your tests in a way that won't break too often if that seed data changes.
+* Use multiple databases to parallelize tests which modify the database, and possibly also to allow different seed data configurations.
+* If test speed is a concern, you may want to look at more efficient techniques for creating your test database, and for cleaning its data between runs.
+* Always keep test parallelization and isolation in mind.
diff --git a/entity-framework/core/testing/testing-without-the-database.md b/entity-framework/core/testing/testing-without-the-database.md
new file mode 100644
index 0000000000..311804028e
--- /dev/null
+++ b/entity-framework/core/testing/testing-without-the-database.md
@@ -0,0 +1,86 @@
+---
+title: Testing without your Production Database System - EF Core
+description: Techniques for testing EF Core applications without involving  your production database system
+author: roji
+ms.date: 01/24/2022
+uid: core/testing/testing-without-the-database
+---
+# Testing without your production database system
+
+In this page, we discuss techniques for writing automated tests which do not involve the database system against which the application runs in production, by swapping your database with a [test double](https://en.wikipedia.org/wiki/Test_double). There are various types of test doubles and approaches for doing this, and it's recommended to thoroughly read [Choosing a testing strategy](xref:core/testing/choosing-a-testing-strategy) to fully understand the different options. Finally, it's also possible to test against your production database system; this is covered in [Testing against your production database system](xref:core/testing/testing-with-the-database).
+
+> [!TIP]
+> This page shows [xUnit](https://xunit.net/) techniques, but similar concepts exist in other testing frameworks, including [NUnit](https://nunit.org/).
+
+## Repository pattern
+
+If you've decided to write tests without involving your production database system, then the recommended technique for doing so is the repository pattern; for more background on this, see [this section](xref:core/testing/choosing-a-testing-strategy#repository-pattern). The first step of implementing the repository pattern is to extract out your EF Core LINQ queries to a separate layer, which we'll later stub or mock. Here's an example of a repository interface for our blogging system:
+
+[!code-csharp[Main](../../../samples/core/Testing/BusinessLogic/IBloggingRepository.cs?name=IBloggingRepository)]
+
+... and here's a partial sample implementation for production use:
+
+```csharp
+public class BloggingRepository : IBloggingRepository
+{
+    private readonly BloggingContext _context;
+
+    public BloggingRepository(BloggingContext context)
+        => _context = context;
+
+    public async Task<Blog> GetBlogByNameAsync(string name)
+        => await _context.Blogs.FirstOrDefaultAsync(b => b.Name == name);
+
+    // Other code...
+}
+```
+
+There's not much to it: the repository simply wraps an EF Core context, and exposes methods which execute the database queries and updates on it. A key point to note is that our `GetAllBlogs` method returns `IAsyncEnumerable<Blog>` (or `IEnumerable<Blog>`), and not `IQueryable<Blog>`. Returning the latter would mean that query operators can still be composed over the result, requiring that EF Core still be involved in translating the query; this would defeat the purpose of having a repository in the first place. `IAsyncEnumerable<Blog>` allows us to easily stub or mock what the repository returns.
+
+For an ASP.NET Core application, we need to register the repository as a service in dependency injection by adding the following to the application's `ConfigureServices`:
+
+[!code-csharp[Main](../../../samples/core/Testing/BloggingWebApi/Startup.cs?name=RegisterRepositoryInDI)]
+
+Finally, our controllers get injected with the repository service instead of the EF Core context, and execute methods on it:
+
+[!code-csharp[Main](../../../samples/core/Testing/BloggingWebApi/Controllers/BloggingControllerWithRepository.cs?name=BloggingControllerWithRepository&highlight=8)]
+
+At this point, your application is architected according to the repository pattern: the only point of contact with the data access layer - EF Core - is now via the repository layer, which acts as a mediator between application code and actual database queries. Tests can now be written simply by stubbing out the repository, or by mocking it with your favorite mocking library. Here's an example of a mock-based test using the popular [Moq](https://github.com/Moq/moq4) library:
+
+[!code-csharp[Main](../../../samples/core/Testing/TestingWithoutTheDatabase/RepositoryBloggingControllerTest.cs?name=GetBlog)]
+
+The full sample code can be viewed [here](https://github.com/dotnet/EntityFramework.Docs/blob/main/samples/core/Testing/TestingWithoutTheDatabase/RepositoryBloggingControllerTest.cs).
+
+## SQLite in-memory
+
+SQLite can easily be configured as the EF Core provider for your test suite instead of your production database system (e.g. SQL Server); consult the [SQLite provider docs](xref:core/providers/sqlite/index) for details. However, it's usually a good idea to use SQLite's [in-memory database](https://sqlite.org/inmemorydb.html) feature when testing, since it provides easy isolation between tests, and does not require dealing with actual SQLite files.
+
+To use in-memory SQLite, it's important to understand that a **new database is created** whenever a low-level connection is opened, and that it's **deleted** when that connection is closed. In normal usage, EF Core's `DbContext` opens and closes database connections as needed - every time a query is executed - to avoid keeping connection for unnecessarily long times. However, with in-memory SQLite this would lead to resetting the database every time; so as a workaround, we open the connection before passing it to EF Core, and arrange for it to be closed only when the test completes:
+
+[!code-csharp[Main](../../../samples/core/Testing/TestingWithoutTheDatabase/SqliteInMemoryBloggingControllerTest.cs?name=ConstructorAndDispose)]
+
+Tests can now call `CreateContext`, which returns a context using the connection we set up in the constructor, ensuring we have a clean database with the seeded data.
+
+The full sample code for SQLite in-memory testing can be viewed [here](https://github.com/dotnet/EntityFramework.Docs/blob/main/samples/core/Testing/TestingWithoutTheDatabase/SqliteInMemoryBloggingControllerTest.cs).
+
+## In-memory provider
+
+As discussed in the [testing overview page](xref:core/testing/choosing-a-testing-strategy#inmemory-as-a-database-fake), using the in-memory provider for testing is strongly discouraged; [consider using SQLite instead](#sqlite-in-memory), or [implementing the repository pattern](#repository-pattern). If you've decided to use in-memory, here is a typical test class constructor that sets up and seeds a new in-memory database before each test:
+
+[!code-csharp[Main](../../../samples/core/Testing/TestingWithoutTheDatabase/InMemoryBloggingControllerTest.cs?name=Constructor)]
+
+The full sample code for in-memory testing can be viewed [here](https://github.com/dotnet/EntityFramework.Docs/blob/main/samples/core/Testing/TestingWithoutTheDatabase/InMemoryBloggingControllerTest.cs).
+
+### In-memory database naming
+
+In-memory databases are identified by a simple, string name, and it's possible to connect to the same database several times by providing the same name (this is why the sample above must call `EnsureDeleted` before each test). However, note that in-memory databases are rooted in the context's internal service provider; while in most cases contexts share the same service provider, configuring contexts with different options may trigger the use of a new internal service provider. When that's the case, explicitly pass the same instance of <xref:Microsoft.EntityFrameworkCore.Storage.InMemoryDatabaseRoot> to `UseInMemoryDatabase` for all contexts which should share in-memory databases (this is typically done by having a static `InMemoryDatabaseRoot` field).
+
+### Transactions
+
+Note that by default, if a transaction is started, the in-memory provider will throw an exception since transactions aren't supported. You may wish to have transactions silently ignored instead, by configuring EF Core to ignore `InMemoryEventId.TransactionIgnoredWarning` as in the above sample. However, if your code actually relies on transactional semantics - e.g. depends on rollback actually rolling back changes - your test won't work.
+
+### Views
+
+The in-memory provider allows the definition of views via LINQ queries, using <xref:Microsoft.EntityFrameworkCore.InMemoryEntityTypeBuilderExtensions.ToInMemoryQuery*>:
+
+[!code-csharp[Main](../../../samples/core/Testing/TestingWithoutTheDatabase/InMemoryBloggingControllerTest.cs?name=ToInMemoryQuery)]
diff --git a/entity-framework/core/what-is-new/ef-core-1.0.md b/entity-framework/core/what-is-new/ef-core-1.0.md
new file mode 100644
index 0000000000..5fdd542f02
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-1.0.md
@@ -0,0 +1,174 @@
+---
+title: What is new in EF Core 1.0 - EF Core
+description: Changes and improvements in Entity Framework Core 1.0
+author: SamMonoRT
+ms.date: 10/27/2016
+uid: core/what-is-new/ef-core-1.0
+---
+# Features included in EF Core 1.0
+
+## Platforms
+
+### .NET Framework 4.5.1
+
+Includes Console, WPF, WinForms, ASP.NET 4, etc.
+
+### .NET Standard 1.3
+
+Including ASP.NET Core targeting both .NET Framework and .NET Core on Windows, OSX, and Linux.
+
+## Modelling
+
+### Basic modelling
+
+Based on POCO entities with get/set properties of common scalar types (`int`, `string`, etc.).
+
+### Relationships and navigation properties
+
+One-to-many and One-to-zero-or-one relationships can be specified in the model based on a foreign key. Navigation properties of simple collection or reference types can be associated with these relationships.
+
+### Built-in conventions
+
+These build an initial model based on the shape of the entity classes.
+
+### Fluent API
+
+Allows you to override the `OnModelCreating` method on your context to further configure the model that was discovered by convention.
+
+### Data annotations
+
+Are attributes that can be added to your entity classes/properties and will influence the EF model. For example, adding `[Required]` will let EF know that a property is required.
+
+### Relational Table mapping
+
+Allows entities to be mapped to tables/columns.
+
+### Key value generation
+
+Including client-side generation and database generation.
+
+### Database generated values
+
+Allows for values to be generated by the database on insert (default values) or update (computed columns).
+
+### Sequences in SQL Server
+
+Allows for sequence objects to be defined in the model.
+
+### Unique constraints
+
+Allows for the definition of alternate keys and the ability to define relationships that target that key.
+
+### Indexes
+
+Defining indexes in the model automatically introduces indexes in the database. Unique indexes are also supported.
+
+### Shadow state properties
+
+Allows for properties to be defined in the model that are not declared and are not stored in the .NET class but can be tracked and updated by EF Core. Commonly used for foreign key properties when exposing these in the object is not desired.
+
+### Table-Per-Hierarchy inheritance pattern
+
+Allows entities in an inheritance hierarchy to be saved to a single table using a discriminator column to identify they entity type for a given record in the database.
+
+### Model validation
+
+Detects invalid patterns in the model and provides helpful error messages.
+
+## Change tracking
+
+### Snapshot change tracking
+
+Allows changes in entities to be detected automatically by comparing current state against a copy (snapshot) of the original state.
+
+### Notification change tracking
+
+Allows your entities to notify the change tracker when property values are modified.
+
+### Accessing tracked state
+
+Via `DbContext.Entry` and `DbContext.ChangeTracker`.
+
+### Attaching detached entities/graphs
+
+The new `DbContext.AttachGraph` API helps re-attach entities to a context in order to save new/modified entities.
+
+## Saving data
+
+### Basic save functionality
+
+Allows changes to entity instances to be persisted to the database.
+
+### Optimistic Concurrency
+
+Protects against overwriting changes made by another user since data was fetched from the database.
+
+### Async SaveChanges
+
+Can free up the current thread to process other requests while the database processes the commands issued from `SaveChanges`.
+
+### Database Transactions
+
+Means that `SaveChanges` is always atomic (meaning it either completely succeeds, or no changes are made to the database). There are also transaction related APIs to allow sharing transactions between context instances etc.
+
+### Relational: Batching of statements
+
+Provides better performance by batching up multiple INSERT/UPDATE/DELETE commands into a single roundtrip to the database.
+
+## Query
+
+### Basic LINQ support
+
+Provides the ability to use LINQ to retrieve data from the database.
+
+### Mixed client/server evaluation
+
+Enables queries to contain logic that cannot be evaluated in the database, and must therefore be evaluated after the data is retrieved into memory.
+
+### NoTracking
+
+Queries enables quicker query execution when the context does not need to monitor for changes to the entity instances (this is useful if the results are read-only).
+
+### Eager loading
+
+Provides the `Include` and `ThenInclude` methods to identify related data that should also be fetched when querying.
+
+### Async query
+
+Can free up the current thread (and it's associated resources) to process other requests while the database processes the query.
+
+### Raw SQL queries
+
+Provides the `DbSet.FromSql` method to use raw SQL queries to fetch data. These queries can also be composed on using LINQ.
+
+## Database schema management
+
+### Database creation/deletion APIs
+
+Are mostly designed for testing where you want to quickly create/delete the database without using migrations.
+
+### Relational database migrations
+
+Allow a relational database schema to evolve overtime as your model changes.
+
+### Reverse engineer from database
+
+Scaffolds an EF model based on an existing relational database schema.
+
+## Database providers
+
+### SQL Server
+
+Connects to Microsoft SQL Server 2008 onwards.
+
+### SQLite
+
+Connects to a SQLite 3 database.
+
+### In-Memory
+
+Is designed to easily enable testing without connecting to a real database.
+
+### 3rd party providers
+
+Several providers are available for other database engines. See [Database Providers](xref:core/providers/index) for a complete list.
diff --git a/entity-framework/core/what-is-new/ef-core-1.1.md b/entity-framework/core/what-is-new/ef-core-1.1.md
new file mode 100644
index 0000000000..982a5cdc8a
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-1.1.md
@@ -0,0 +1,44 @@
+---
+title: What is new in EF Core 1.1 - EF Core
+description: Changes and improvements in Entity Framework Core 1.1
+author: SamMonoRT
+ms.date: 10/27/2016
+uid: core/what-is-new/ef-core-1.1
+---
+# New features in EF Core 1.1
+
+## Modeling
+
+### Field mapping
+
+Allows you to configure a backing field for a property. This can be useful for read-only properties, or data that has Get/Set methods rather than a property.
+
+### Mapping to Memory-Optimized Tables in SQL Server
+
+You can specify that the table an entity is mapped to is memory-optimized. When using EF Core to create and maintain a database based on your model (either with migrations or `Database.EnsureCreated()`), a memory-optimized table will be created for these entities.
+
+## Change tracking
+
+### Additional change tracking APIs from EF6
+
+Such as `Reload`, `GetModifiedProperties`, `GetDatabaseValues` etc.
+
+## Query
+
+### Explicit Loading
+
+Allows you to trigger population of a navigation property on an entity that was previously loaded from the database.
+
+### DbSet.Find
+
+Provides an easy way to fetch an entity based on its primary key value.
+
+## Other
+
+### Connection resiliency
+
+Automatically retries failed database commands. This is especially useful when connection to SQL Azure, where transient failures are common.
+
+### Simplified service replacement
+
+Makes it easier to replace internal services that EF uses.
diff --git a/entity-framework/core/what-is-new/ef-core-10.0/breaking-changes.md b/entity-framework/core/what-is-new/ef-core-10.0/breaking-changes.md
new file mode 100644
index 0000000000..7bd3139c43
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-10.0/breaking-changes.md
@@ -0,0 +1,558 @@
+---
+title: Breaking changes in EF Core 10 (EF10) - EF Core
+description: List of breaking changes introduced in Entity Framework Core 10 (EF10)
+author: roji
+ms.date: 10/09/2025
+uid: core/what-is-new/ef-core-10.0/breaking-changes
+---
+
+# Breaking changes in EF Core 10 (EF10)
+
+This page documents API and behavior changes that have the potential to break existing applications updating from EF Core 9 to EF Core 10. Make sure to review earlier breaking changes if updating from an earlier version of EF Core:
+
+- [Breaking changes in EF Core 9](xref:core/what-is-new/ef-core-9.0/breaking-changes)
+- [Breaking changes in EF Core 8](xref:core/what-is-new/ef-core-8.0/breaking-changes)
+- [Breaking changes in EF Core 7](xref:core/what-is-new/ef-core-7.0/breaking-changes)
+- [Breaking changes in EF Core 6](xref:core/what-is-new/ef-core-6.0/breaking-changes)
+
+## Summary
+
+> [!NOTE]
+> If you are using Microsoft.Data.Sqlite, please see the [separate section below on Microsoft.Data.Sqlite breaking changes](#MDS-breaking-changes).
+
+| **Breaking change**                                                                                             | **Impact** |
+|:--------------------------------------------------------------------------------------------------------------- | -----------|
+| [EF tools now require framework to be specified for multi-targeted projects](#ef-tools-multi-targeting)         | Medium     |
+| [Application Name is now injected into the connection string](#sqlserver-application-name)                      | Low        |
+| [SQL Server json data type used by default on Azure SQL and compatibility level 170](#sqlserver-json-data-type) | Low        |
+| [Parameterized collections now use multiple parameters by default](#parameterized-collections)                  | Low        |
+| [ExecuteUpdateAsync now accepts a regular, non-expression lambda](#ExecuteUpdateAsync-lambda)                   | Low        |
+| [Complex type column names are now uniquified](#complex-type-column-uniquification)                             | Low        |
+| [Nested complex type properties use full path in column names](#nested-complex-type-column-names)               | Low        |
+| [IDiscriminatorPropertySetConvention signature changed](#discriminator-convention-signature)                    | Low        |
+| [IRelationalCommandDiagnosticsLogger methods add logCommandText parameter](#logger-logcommandtext)              | Low        |
+
+## Medium-impact changes
+
+<a name="ef-tools-multi-targeting"></a>
+
+### EF tools now require framework to be specified for multi-targeted projects
+
+[Tracking Issue #37230](https://github.com/dotnet/efcore/issues/37230)
+
+#### Old behavior
+
+Previously, the EF tools (dotnet-ef) could be used on projects targeting multiple frameworks without specifying which framework to use.
+
+#### New behavior
+
+Starting with EF Core 10.0, when running EF tools on a project that targets multiple frameworks (using `<TargetFrameworks>` instead of `<TargetFramework>`), you must explicitly specify which target framework to use with the `--framework` option. Without this option, the following error will be thrown:
+
+> The project targets multiple frameworks. Use the --framework option to specify which target framework to use.
+
+#### Why
+
+In EF Core 10, the tools started relying on the `ResolvePackageAssets` MSBuild task to get more accurate information about project dependencies. However, this task is not available if the project is targeting multiple target frameworks (TFMs). The solution requires users to select which framework should be used.
+
+#### Mitigations
+
+When running any EF tools command on a project that targets multiple frameworks, specify the target framework using the `--framework` option. For example:
+
+```bash
+dotnet ef migrations add MyMigration --framework net9.0
+```
+
+```bash
+dotnet ef database update --framework net9.0
+```
+
+```bash
+dotnet ef migrations script --framework net9.0
+```
+
+If your project file looks like this:
+
+```xml
+<PropertyGroup>
+  <TargetFrameworks>net8.0;net9.0</TargetFrameworks>
+</PropertyGroup>
+```
+
+You'll need to choose one of the frameworks (e.g., `net9.0`) when running the EF tools.
+
+## Low-impact changes
+
+<a name="sqlserver-application-name"></a>
+
+### Application Name is now injected into the connection string
+
+[Tracking Issue #35730](https://github.com/dotnet/efcore/issues/35730)
+
+#### New behavior
+
+When a connection string without an `Application Name` is passed to EF, EF now inserts an `Application Name` containing anonymous information about the EF and SqlClient versions being used. In the vast majority of cases, this doesn't impact the application in any way, but can affect behavior in some edge cases. For example, if you connect to the same database with both EF and another non-EF data access technology (e.g. Dapper, ADO.NET), SqlClient will use a different internal connection pool, as EF will now use a different, updated connection string (one where `Application Name` has been injected). If this sort of mixed access is done within a `TransactionScope`, this can cause escalation to a distributed transaction where previously none was necessary, due of the usage of two connection strings which SqlClient identifies as two distinct databases.
+
+#### Mitigations
+
+A mitigation is to simply define an `Application Name` in your connection string. Once one is defined, EF does not overwrite it and the original connection string is preserved exactly as-is.
+
+<a name="sqlserver-json-data-type"></a>
+
+### SQL Server json data type used by default on Azure SQL and compatibility level 170
+
+[Tracking Issue #36372](https://github.com/dotnet/efcore/issues/36372)
+
+#### Old behavior
+
+Previously, when mapping primitive collections or owned types to JSON in the database, the SQL Server provider stored the JSON data in an `nvarchar(max)` column:
+
+```c#
+public class Blog
+{
+    // ...
+
+    // Primitive collection, mapped to nvarchar(max) JSON column
+    public string[] Tags { get; set; }
+    // Owned entity type mapped to nvarchar(max) JSON column
+    public List<Post> Posts { get; set; }
+}
+
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Blog>().OwnsMany(b => b.Posts, b => b.ToJson());
+}
+```
+
+For the above, EF previously generated the following table:
+
+```sql
+CREATE TABLE [Blogs] (
+    ...
+    [Tags] nvarchar(max),
+    [Posts] nvarchar(max)
+);
+```
+
+#### New behavior
+
+With EF 10, if you configure EF with <xref:Microsoft.EntityFrameworkCore.SqlServerDbContextOptionsExtensions.UseAzureSql*> ([see documentation](xref:core/providers/sql-server/index#usage-and-configuration)), or configure EF with a compatibility level of 170 or above ([see documentation](xref:core/providers/sql-server/index#compatibility-level)), EF will map to the new JSON data type instead:
+
+```sql
+CREATE TABLE [Blogs] (
+    ...
+    [Tags] json
+    [Posts] json
+);
+```
+
+Although the new JSON data type is the recommended way to store JSON data in SQL Server going forward, there may be some behavioral differences when transitioning from `nvarchar(max)`, and some specific querying forms may not be supported. For example, SQL Server does not support the DISTINCT operator over JSON arrays, and queries attempting to do so will fail.
+
+Note that if you have an existing table and are using <xref:Microsoft.EntityFrameworkCore.SqlServerDbContextOptionsExtensions.UseAzureSql*>, upgrading to EF 10 will cause a migration to be generated which alters all existing `nvarchar(max)` JSON columns to `json`. This alter operation is supported and should get applied seamlessly and without any issues, but is a non-trivial change to your database.
+
+#### Why
+
+The new JSON data type introduced by SQL Server is a superior, 1st-class way to store and interact with JSON data in the database; it notably brings significant performance improvements ([see documentation](/sql/t-sql/data-types/json-data-type)). All applications using Azure SQL Database or SQL Server 2025 are encouraged to migrate to the new JSON data type.
+
+#### Mitigations
+
+If you are targeting Azure SQL Database and do not wish to transition to the new JSON data type right away, you can configure EF with a compatibility level lower than 170:
+
+```c#
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+{
+    optionsBuilder.UseAzureSql("<connection string>", o => o.UseCompatibilityLevel(160));
+}
+```
+
+If you're targeting on-premises SQL Server, the default compatibility level with `UseSqlServer` is currently 150 (SQL Server 2019), so the JSON data type is not used.
+
+As an alternative, you can explicitly set the column type on specific properties to be `nvarchar(max)`:
+
+```c#
+public class Blog
+{
+    public string[] Tags { get; set; }
+    public List<Post> Posts { get; set; }
+}
+
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Blog>().PrimitiveCollection(b => b.Tags).HasColumnType("nvarchar(max)");
+    modelBuilder.Entity<Blog>().OwnsMany(b => b.Posts, b => b.ToJson().HasColumnType("nvarchar(max)"));
+    modelBuilder.Entity<Blog>().ComplexProperty(e => e.Posts, b => b.ToJson());
+}
+```
+
+<a name="parameterized-collections"></a>
+
+### Parameterized collections now use multiple parameters by default
+
+[Tracking Issue #34346](https://github.com/dotnet/efcore/issues/34346)
+
+#### Old behavior
+
+In EF Core 9 and earlier, parameterized collections in LINQ queries (such as those used with `.Contains()`) were translated to SQL using a JSON array parameter by default. Consider the following query:
+
+```c#
+int[] ids = [1, 2, 3];
+var blogs = await context.Blogs.Where(b => ids.Contains(b.Id)).ToListAsync();
+```
+
+On SQL Server, this generated the following SQL:
+
+```sql
+@__ids_0='[1,2,3]'
+
+SELECT [b].[Id], [b].[Name]
+FROM [Blogs] AS [b]
+WHERE [b].[Id] IN (
+    SELECT [i].[value]
+    FROM OPENJSON(@__ids_0) WITH ([value] int '$') AS [i]
+)
+```
+
+#### New behavior
+
+Starting with EF Core 10.0, parameterized collections are now translated using multiple scalar parameters by default:
+
+```sql
+SELECT [b].[Id], [b].[Name]
+FROM [Blogs] AS [b]
+WHERE [b].[Id] IN (@ids1, @ids2, @ids3)
+```
+
+#### Why
+
+The new default translation provides the query planner with cardinality information about the collection, which can lead to better query plans in many scenarios. The multiple parameter approach balances between plan cache efficiency (by parameterizing) and query optimization (by providing cardinality).
+
+However, different workloads may benefit from different translation strategies depending on collection sizes, query patterns, and database characteristics.
+
+> [!NOTE]
+> While the new default translation will not cause any behavioral change or performance regression in the majority of cases, the change in how queries are translated to SQL may have adverse consequences in some scenarios.
+>
+> Applications that were built with EF Core 8 or 9, and rely on the performance characteristics of the JSON array parameter translation (using `OPENJSON` or similar database-specific functions) may experience performance differences when upgrading to EF Core 10. This is especially relevant for queries with large collections or specific query patterns that benefited from the previous translation strategy.
+>
+> If you experience performance regressions after upgrading, consider using the mitigation strategies below to revert to the previous behavior globally or for specific queries.
+
+#### Mitigations
+
+If you encounter issues with the new default behavior (such as performance regressions), you can configure the translation mode globally:
+
+```c#
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    => optionsBuilder
+        .UseSqlServer("<CONNECTION STRING>", 
+            o => o.UseParameterizedCollectionMode(ParameterTranslationMode.Constant));
+```
+
+Available modes are:
+
+- `ParameterTranslationMode.MultipleParameters` - The new default (multiple scalar parameters)
+- `ParameterTranslationMode.Constant` - Inlines values as constants (pre-EF8 default behavior)
+- `ParameterTranslationMode.Parameter` - Uses JSON array parameter (EF8-9 default)
+
+You can also control the translation on a per-query basis:
+
+```c#
+// Use constants instead of parameters for this specific query
+var blogs = await context.Blogs
+    .Where(b => EF.Constant(ids).Contains(b.Id))
+    .ToListAsync();
+
+// Use a single parameter (e.g. JSON parameter with OPENJSON) instead of parameters for this specific query
+var blogs = await context.Blogs
+    .Where(b => EF.Parameter(ids).Contains(b.Id))
+    .ToListAsync();
+
+// Use multiple scalar parameters for this specific query. This is the default in EF 10, but is useful if the default was changed globally:
+var blogs = await context.Blogs
+    .Where(b => EF.MultipleParameters(ids).Contains(b.Id))
+    .ToListAsync();
+```
+
+For more information about parameterized collection translation, [see the documentation](xref:core/what-is-new/ef-core-10.0/whatsnew#parameterized-collection-translation).
+
+<a name="ExecuteUpdateAsync-lambda"></a>
+
+### ExecuteUpdateAsync now accepts a regular, non-expression lambda
+
+[Tracking Issue #32018](https://github.com/dotnet/efcore/issues/32018)
+
+#### Old behavior
+
+Previously, <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.ExecuteUpdate*> accepted an expression tree argument (`Expression<Func<...>>`) for the column setters.
+
+#### New behavior
+
+Starting with EF Core 10.0, <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.ExecuteUpdate*> now accepts a non-expression argument (`Func<...>`) for the column setters. If you were building expression trees to dynamically create the column setters argument, your code will no longer compile - but can be replaced with a much simpler alternative (see below).
+
+#### Why
+
+The fact that the column setters parameter was an expression tree made it quite difficult to do dynamic construction of the column setters, where some setters are only present based on some condition (see Mitigations below for an example).
+
+#### Mitigations
+
+Code that was building expression trees to dynamically create the column setters argument will need to be rewritten - but the result will be much simpler. For example, let's assume we want to update a Blog's Views, but conditionally also its Name. Since the setters argument was an expression tree, code such as the following needed to be written:
+
+```c#
+// Base setters - update the Views only
+Expression<Func<SetPropertyCalls<Blog>, SetPropertyCalls<Blog>>> setters =
+    s => s.SetProperty(b => b.Views, 8);
+
+// Conditionally add SetProperty(b => b.Name, "foo") to setters, based on the value of nameChanged
+if (nameChanged)
+{
+    var blogParameter = Expression.Parameter(typeof(Blog), "b");
+
+    setters = Expression.Lambda<Func<SetPropertyCalls<Blog>, SetPropertyCalls<Blog>>>(
+        Expression.Call(
+            instance: setters.Body,
+            methodName: nameof(SetPropertyCalls<Blog>.SetProperty),
+            typeArguments: [typeof(string)],
+            arguments:
+            [
+                Expression.Lambda<Func<Blog, string>>(Expression.Property(blogParameter, nameof(Blog.Name)), blogParameter),
+                Expression.Constant("foo")
+            ]),
+        setters.Parameters);
+}
+
+await context.Blogs.ExecuteUpdateAsync(setters);
+```
+
+Manually creating expression trees is complicated and error-prone, and made this common scenario much more difficult than it should have been. Starting with EF 10, you can now write the following instead:
+
+```c#
+await context.Blogs.ExecuteUpdateAsync(s =>
+{
+    s.SetProperty(b => b.Views, 8);
+    if (nameChanged)
+    {
+        s.SetProperty(b => b.Name, "foo");
+    }
+});
+```
+
+<a name="complex-type-column-uniquification"></a>
+
+### Complex type column names are now uniquified
+
+[Tracking Issue #4970](https://github.com/dotnet/EntityFramework.Docs/issues/4970)
+
+#### Old behavior
+
+Previously, when mapping complex types to table columns, if multiple properties in different complex types had the same column name, they would silently share the same column.
+
+#### New behavior
+
+Starting with EF Core 10.0, complex type column names are uniquified by appending a number at the end if another column with the same name exists on the table.
+
+#### Why
+
+This prevents data corruption that could occur when multiple properties are unintentionally mapped to the same column.
+
+#### Mitigations
+
+If you need multiple properties to share the same column, configure them explicitly using <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.ComplexPropertyBuilder.Property*> and <xref:Microsoft.EntityFrameworkCore.RelationalPropertyBuilderExtensions.HasColumnName*>:
+
+```c#
+modelBuilder.Entity<Customer>(b =>
+{
+    b.ComplexProperty(c => c.ShippingAddress, p => p.Property(a => a.Street).HasColumnName("Street"));
+    b.ComplexProperty(c => c.BillingAddress, p => p.Property(a => a.Street).HasColumnName("Street"));
+});
+```
+
+<a name="nested-complex-type-column-names"></a>
+
+### Nested complex type properties use full path in column names
+
+#### Old behavior
+
+Previously, properties on nested complex types were mapped to columns using just the declaring type name. For example, `EntityType.Complex.NestedComplex.Property` was mapped to column `NestedComplex_Property`.
+
+#### New behavior
+
+Starting with EF Core 10.0, properties on nested complex types use the full path to the property as part of the column name. For example, `EntityType.Complex.NestedComplex.Property` is now mapped to column `Complex_NestedComplex_Property`.
+
+#### Why
+
+This provides better column name uniqueness and makes it clearer which property maps to which column.
+
+#### Mitigations
+
+If you need to maintain the old column names, configure them explicitly using <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.ComplexPropertyBuilder.Property*> and <xref:Microsoft.EntityFrameworkCore.RelationalPropertyBuilderExtensions.HasColumnName*>:
+
+```c#
+modelBuilder.Entity<EntityType>()
+    .ComplexProperty(e => e.Complex)
+    .ComplexProperty(o => o.NestedComplex)
+    .Property(c => c.Property)
+    .HasColumnName("NestedComplex_Property");
+```
+
+<a name="discriminator-convention-signature"></a>
+
+### IDiscriminatorPropertySetConvention signature changed
+
+#### Old behavior
+
+Previously, `IDiscriminatorPropertySetConvention.ProcessDiscriminatorPropertySet` took `IConventionEntityTypeBuilder` as a parameter.
+
+#### New behavior
+
+Starting with EF Core 10.0, the method signature changed to take `IConventionTypeBaseBuilder` instead of `IConventionEntityTypeBuilder`.
+
+#### Why
+
+This change allows the convention to work with both entity types and complex types.
+
+#### Mitigations
+
+Update your custom convention implementations to use the new signature:
+
+```c#
+public virtual void ProcessDiscriminatorPropertySet(
+    IConventionTypeBaseBuilder typeBaseBuilder, // Changed from IConventionEntityTypeBuilder
+    string name,
+    Type type,
+    MemberInfo memberInfo,
+    IConventionContext<IConventionProperty> context)
+```
+
+<a name="logger-logcommandtext"></a>
+
+### IRelationalCommandDiagnosticsLogger methods add logCommandText parameter
+
+[Tracking Issue #35757](https://github.com/dotnet/efcore/issues/35757)
+
+#### Old behavior
+
+Previously, methods on `IRelationalCommandDiagnosticsLogger` such as `CommandReaderExecuting`, `CommandReaderExecuted`, `CommandScalarExecuting`, and others accepted a `command` parameter representing the database command being executed.
+
+#### New behavior
+
+Starting with EF Core 10.0, these methods now require an additional `logCommandText` parameter. This parameter contains the SQL command text that will be logged, which may have sensitive data redacted when <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.EnableSensitiveDataLogging*> is not enabled.
+
+#### Why
+
+This change supports the new feature to [redact inlined constants from logging by default](xref:core/what-is-new/ef-core-10.0/whatsnew#redact-inlined-constants-from-logging-by-default). When EF inlines parameter values into SQL (e.g., when using `EF.Constant()`), those values are now redacted from logs unless sensitive data logging is explicitly enabled. The `logCommandText` parameter provides the redacted SQL for logging purposes, while the `command` parameter contains the actual SQL that gets executed.
+
+#### Mitigations
+
+If you have a custom implementation of `IRelationalCommandDiagnosticsLogger`, you'll need to update your method signatures to include the new `logCommandText` parameter. For example:
+
+```c#
+public InterceptionResult<DbDataReader> CommandReaderExecuting(
+    IRelationalConnection connection,
+    DbCommand command,
+    DbContext context,
+    Guid commandId,
+    Guid connectionId,
+    DateTimeOffset startTime,
+    string logCommandText) // New parameter
+{
+    // Use logCommandText for logging purposes
+    // Use command for execution-related logic
+}
+```
+
+The `logCommandText` parameter contains the SQL to be logged (with inlined constants potentially redacted), while `command.CommandText` contains the actual SQL that will be executed against the database.
+
+<a name="MDS-breaking-changes"></a>
+
+## Microsoft.Data.Sqlite breaking changes
+
+### Summary
+
+| **Breaking change**                                                                                       | **Impact** |
+|:----------------------------------------------------------------------------------------------------------|------------|
+| [Using GetDateTimeOffset without an offset now assumes UTC](#DateTimeOffset-read)                         | High       |
+| [Writing DateTimeOffset into REAL column now writes in UTC](#DateTimeOffset-write)                        | High       |
+| [Using GetDateTime with an offset now returns value in UTC](#DateTime-read)                               | High       |
+
+### High-impact changes
+
+<a name="DateTimeOffset-read"></a>
+
+#### Using GetDateTimeOffset without an offset now assumes UTC
+
+[Tracking Issue #36195](https://github.com/dotnet/efcore/issues/36195)
+
+##### Old behavior
+
+Previously, when using `GetDateTimeOffset` on a textual timestamp that did not have an offset (e.g., `2014-04-15 10:47:16`), Microsoft.Data.Sqlite would assume the value was in the local time zone. I.e. the value was parsed as `2014-04-15 10:47:16+02:00` (assuming local time zone was UTC+2).
+
+##### New behavior
+
+Starting with Microsoft.Data.Sqlite 10.0, when using `GetDateTimeOffset` on a textual timestamp that does not have an offset, Microsoft.Data.Sqlite will assume the value is in UTC.
+
+##### Why
+
+Is is to align with SQLite's behavior where timestamps without an offset are treated as UTC.
+
+##### Mitigations
+
+Code should be adjusted accordingly.
+
+As a last/temporary resort, you can revert to previous behavior by setting `Microsoft.Data.Sqlite.Pre10TimeZoneHandling` AppContext switch to `true`, see [AppContext for library consumers](/dotnet/api/system.appcontext#ForConsumers) for more details.
+
+```C#
+AppContext.SetSwitch("Microsoft.Data.Sqlite.Pre10TimeZoneHandling", isEnabled: true);
+```
+
+<a name="DateTimeOffset-write"></a>
+
+#### Writing DateTimeOffset into REAL column now writes in UTC
+
+[Tracking Issue #36195](https://github.com/dotnet/efcore/issues/36195)
+
+##### Old behavior
+
+Previously, when writing a `DateTimeOffset` value into a REAL column, Microsoft.Data.Sqlite would write the value without taking the offset into account.
+
+##### New behavior
+
+Starting with Microsoft.Data.Sqlite 10.0, when writing a `DateTimeOffset` value into a REAL column, Microsoft.Data.Sqlite will convert the value to UTC before doing the conversions and writing it.
+
+##### Why
+
+The value written was incorrect, not aligning with SQLite's behavior where REAL timestamps are asummed to be UTC.
+
+##### Mitigations
+
+Code should be adjusted accordingly.
+
+As a last/temporary resort, you can revert to previous behavior by setting `Microsoft.Data.Sqlite.Pre10TimeZoneHandling` AppContext switch to `true`, see [AppContext for library consumers](/dotnet/api/system.appcontext#ForConsumers) for more details.
+
+```C#
+AppContext.SetSwitch("Microsoft.Data.Sqlite.Pre10TimeZoneHandling", isEnabled: true);
+```
+
+<a name="DateTime-read"></a>
+
+#### Using GetDateTime with an offset now returns value in UTC
+
+[Tracking Issue #36195](https://github.com/dotnet/efcore/issues/36195)
+
+##### Old behavior
+
+Previously, when using `GetDateTime` on a textual timestamp that had an offset (e.g., `2014-04-15 10:47:16+02:00`), Microsoft.Data.Sqlite would return the value with `DateTimeKind.Local` (even if the offset was not local). The time was parsed correctly taking the offset into account.
+
+##### New behavior
+
+Starting with Microsoft.Data.Sqlite 10.0, when using `GetDateTime` on a textual timestamp that has an offset, Microsoft.Data.Sqlite will convert the value to UTC and return it with `DateTimeKind.Utc`.
+
+##### Why
+
+Even though the time was parsed correctly it was dependent on the machine-configured local time zone, which could lead to unexpected results.
+
+##### Mitigations
+
+Code should be adjusted accordingly.
+
+As a last/temporary resort, you can revert to previous behavior by setting `Microsoft.Data.Sqlite.Pre10TimeZoneHandling` AppContext switch to `true`, see [AppContext for library consumers](/dotnet/api/system.appcontext#ForConsumers) for more details.
+
+```C#
+AppContext.SetSwitch("Microsoft.Data.Sqlite.Pre10TimeZoneHandling", isEnabled: true);
+```
diff --git a/entity-framework/core/what-is-new/ef-core-10.0/whatsnew.md b/entity-framework/core/what-is-new/ef-core-10.0/whatsnew.md
new file mode 100644
index 0000000000..f91b34e65d
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-10.0/whatsnew.md
@@ -0,0 +1,697 @@
+---
+title: What's New in EF Core 10
+description: Overview of new features in EF Core 10
+author: roji
+ms.date: 10/02/2025
+uid: core/what-is-new/ef-core-10.0/whatsnew
+---
+
+# What's New in EF Core 10
+
+EF Core 10.0 (EF10) was released in November 2025 and is a Long Term Support (LTS) release. EF10 will be supported until November 10, 2028.
+
+> [!TIP]
+> You can run and debug into the samples by [downloading the sample code from GitHub](https://github.com/dotnet/EntityFramework.Docs). Each section below links to the source code specific to that section.
+
+EF10 requires the .NET 10 SDK to build and requires the .NET 10 runtime to run. EF10 will not run on earlier .NET versions, and will not run on .NET Framework.
+
+The below release notes list the major improvements in the release; [the full list of issues for the release can be found here](https://github.com/dotnet/efcore/issues?q=is%3Aissue%20milestone%3A10.0.0).
+
+<a name="sql-server"></a>
+
+## Azure SQL and SQL Server
+
+<a name="sql-server-vector-search"></a>
+
+### Vector search support
+
+EF 10 brings full support for the recently-introduced [vector data type](/sql/t-sql/data-types/vector-data-type) and its supporting [`VECTOR_DISTANCE()`](/sql/t-sql/functions/vector-distance-transact-sql) function, available on Azure SQL Database and on SQL Server 2025. The vector data type allows storing *embeddings*, which are representation of meaning that can be efficiently searched over for similarity, powering AI workloads such as semantic search and retrieval-augmented generation (RAG).
+
+To use the `vector` data type, simply add a .NET property of type `SqlVector<float>` to your entity type:
+
+```c#
+public class Blog
+{
+    // ...
+
+    [Column(TypeName = "vector(1536)")]
+    public SqlVector<float> Embedding { get; set; }
+}
+```
+
+Then, insert embedding data by populating the Embedding property and calling <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChangesAsync*> as usual:
+
+```c#
+IEmbeddingGenerator<string, Embedding<float>> embeddingGenerator = /* Set up your preferred embedding generator */;
+
+var embedding = await embeddingGenerator.GenerateVectorAsync("Some text to be vectorized");
+context.Blogs.Add(new Blog
+{
+    Name = "Some blog",
+    Embedding = new SqlVector<float>(embedding)
+});
+await context.SaveChangesAsync();
+```
+
+Finally, use the <xref:Microsoft.EntityFrameworkCore.SqlServerDbFunctionsExtensions.VectorDistance*> [function](/sql/t-sql/functions/vector-distance-transact-sql) in your LINQ queries to perform similarity search for a given user query:
+
+```c#
+var sqlVector = /* some user query which we should search for similarity */;
+var topSimilarBlogs = context.Blogs
+    .OrderBy(b => EF.Functions.VectorDistance("cosine", b.Embedding, sqlVector))
+    .Take(3)
+    .ToListAsync();
+```
+
+For more information on vector search, [see the documentation](xref:core/providers/sql-server/vector-search).
+
+<a name="sql-server-json-type"></a>
+
+### JSON type support
+
+EF 10 also fully supports the new [json data type](/sql/t-sql/data-types/json-data-type), also available on Azure SQL Database and on SQL Server 2025. While SQL Server has included JSON functionality for several versions, the data itself was stored in plain textual columns in the database; the new data type provides significant efficiency improvements and a safer way to store and interact with JSON.
+
+With EF 10, if you've configured EF with <xref:Microsoft.EntityFrameworkCore.SqlServerDbContextOptionsExtensions.UseAzureSql*> or with a compatibility level of 170 or higher (SQL Server 2025), EF automatically defaults to using the new JSON data type. For example, the following entity type has a primitive collection (Tags, an array of strings) and Details (mapped as a complex type):
+
+```c#
+public class Blog
+{
+    public int Id { get; set; }
+
+    public string[] Tags { get; set; }
+    public required BlogDetails Details { get; set; }
+}
+
+public class BlogDetails
+{
+    public string? Description { get; set; }
+    public int Viewers { get; set; }
+}
+
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Blog>().ComplexProperty(b => b.Details, b => b.ToJson());
+}
+```
+
+EF 10 creates the following table for the above:
+
+```sql
+CREATE TABLE [Blogs] (
+    [Id] int NOT NULL IDENTITY,
+    [Name] nvarchar(max) NOT NULL,
+    [Tags] json NOT NULL,
+    [Details] json NOT NULL,
+    CONSTRAINT [PK_Blogs] PRIMARY KEY ([Id])
+);
+```
+
+LINQ querying is fully supported as well. For example, the following filters for blogs with more than 3 viewers:
+
+```c#
+var highlyViewedBlogs = await context.Blogs.Where(b => b.Details.Viewers > 3).ToListAsync();
+```
+
+This produces the following SQL, making use of the new `JSON_VALUE()` `RETURNING` clause:
+
+```sql
+SELECT [b].[Id], [b].[Name], [b].[Tags], [b].[Details]
+FROM [Blogs] AS [b]
+WHERE JSON_VALUE([b].[Details], '$.Viewers' RETURNING int) > 3
+```
+
+Note that if your EF application already uses JSON via `nvarchar` columns, these columns will be automatically changed to `json` with the first migration. You can opt out of this by manually setting the column type to `nvarchar(max)`, or configuring a compatibility level lower than 170.
+
+<a name="default-constraint-names"></a>
+
+### Custom default constraint names
+
+EF 10 now allows you to specify a name for default constraints using <xref:Microsoft.EntityFrameworkCore.RelationalPropertyBuilderExtensions.HasDefaultValueSql*>, rather than letting the database generate them:
+
+```c#
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Post>()
+        .Property(p => b.CreatedDate)
+        .HasDefaultValueSql("GETDATE()", "DF_Post_CreatedDate");
+}
+```
+
+You can also enable automatic naming by EF of all default constraints using <xref:Microsoft.EntityFrameworkCore.SqlServerModelBuilderExtensions.UseNamedDefaultConstraints*>:
+
+```c#
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.UseNamedDefaultConstraints();
+}
+```
+
+> [!NOTE]
+> If you have existing migrations, the next migration you add will rename every single default constraint in your model.
+
+<a name="cosmos"></a>
+
+## Azure Cosmos DB for NoSQL
+
+<a name="full-text-search-support"></a>
+
+### Full-text search support
+
+Azure Cosmos DB now offers support for [full-text search](/azure/cosmos-db/gen-ai/full-text-search). It enables efficient and effective text searches, as well as evaluating the relevance of documents to a given search query. It can be used in combination with vector search to improve the accuracy of responses in some AI scenarios.
+EF Core 10 is adding support for this feature allowing for modeling the database with full-text search enabled properties and using full-text search functions inside queries targeting Azure Cosmos DB.
+
+Here is a basic EF model configuration enabling full-text search on one of the properties:
+
+```c#
+public class Blog
+{
+    ...
+
+    public string Contents { get; set; }
+}
+
+public class BloggingContext
+{
+    ...
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>(b =>
+        {
+            b.Property(x => x.Contents).EnableFullTextSearch();
+            b.HasIndex(x => x.Contents).IsFullTextIndex();
+        });
+    }
+}
+```
+
+Once the model is configured, we can use full-text search operations in queries using methods provided in <xref:Microsoft.EntityFrameworkCore.EF.Functions*>:
+
+```c#
+var cosmosBlogs = await context.Blogs.Where(x => EF.Functions.FullTextContains(x.Contents, "cosmos")).ToListAsync();
+```
+
+The following full-text operations are currently supported: <xref:Microsoft.EntityFrameworkCore.CosmosDbFunctionsExtensions.FullTextContains*>, <xref:Microsoft.EntityFrameworkCore.CosmosDbFunctionsExtensions.FullTextContainsAll*>, <xref:Microsoft.EntityFrameworkCore.CosmosDbFunctionsExtensions.FullTextContainsAny*>, <xref:Microsoft.EntityFrameworkCore.CosmosDbFunctionsExtensions.FullTextScore*>. See the Azure Cosmos DB documentation for details: [`FullTextContains`](/azure/cosmos-db/nosql/query/fulltextcontains), [`FullTextContainsAll`](/azure/cosmos-db/nosql/query/fulltextcontainsall), [`FullTextContainsAny`](/azure/cosmos-db/nosql/query/fulltextcontainsany), [`FullTextScore`](/azure/cosmos-db/nosql/query/fulltextscore).
+
+For more information on Cosmos full-text search, see the [documentation](xref:core/providers/cosmos/full-text-search).
+
+### Hybrid search
+
+EF Core now supports <xref:Microsoft.EntityFrameworkCore.CosmosDbFunctionsExtensions.Rrf*> ([Reciprocal Rank Fusion](/azure/cosmos-db/nosql/query/rrf)) function, which combines vector similarity search and full-text search (i.e. hybrid search). Here is an example query using hybrid search:
+
+```c#
+float[] myVector = /* generate vector data from text, image, etc. */
+var hybrid = await context.Blogs.OrderBy(x => EF.Functions.Rrf(
+        EF.Functions.FullTextScore(x.Contents, "database"), 
+        EF.Functions.VectorDistance(x.Vector, myVector)))
+    .Take(10)
+    .ToListAsync();
+```
+
+For more information on Cosmos hybrid search, [see the documentation](xref:core/providers/cosmos/full-text-search?#hybrid-search).
+
+### Vector similarity search exits preview
+
+In EF9 we added experimental support for [vector similarity search](xref:core/what-is-new/ef-core-9.0/whatsnew#vector-similarity-search-preview). In EF Core 10, vector similarity search support is no longer experimental. We have also made some improvements to the feature:
+
+- EF Core can now generate containers with vector properties defined on owned reference entities. Containers with vector properties defined on owned collections still have to be created by other means. However, they can be used in queries.
+- Model building APIs have been renamed. A vector property can now be configured using the `IsVectorProperty` method, and vector index can be configured using the `IsVectorIndex` method.
+
+For more information on Cosmos vector search, [see the documentation](xref:core/providers/cosmos/vector-search).
+
+<a name="improved-model-evolution"></a>
+
+### Improved experience when evolving the model
+
+In previous versions of EF Core, evolving the model when using Azure Cosmos DB was quite painful. Specifically, when adding a new required property to the entity, EF would no longer be able to materialize that entity. The reason was that EF expected a value for the new property (since it was required), but the document created before the change didn't contain those values. The workaround was to mark the property as optional first, manually add default values for the property, and only then change it to required.
+
+In EF 10 we improved this experience - EF will now materialize a default value for a required property, if no data is present for it in the document, rather than throw.
+
+<a name="other-cosmos-improvements"></a>
+
+## Other Cosmos improvements
+
+- Use ExecutionStrategy for query execution (for retrying) ([#35692](https://github.com/dotnet/efcore/issues/35692)).
+
+<a name="complex-types"></a>
+
+## Complex types
+
+Complex types are used to model types which are contained within your entity types and have no identity of their own; while entity types are (usually) mapped to a database table, complex types can be mapped to columns in their container table ("table splitting"), or to a single JSON column. Complex types introduce document modeling techniques, which can bring substantial performance benefits as traditional JOINs are avoided, and can make your database modeling much simpler and more natural.
+
+### Table splitting
+
+For example, the following maps a customer's addresses as complex types:
+
+```c#
+modelBuilder.Entity<Customer>(b =>
+{
+    b.ComplexProperty(c => c.ShippingAddress);
+    b.ComplexProperty(c => c.BillingAddress);
+});
+```
+
+On relational database, this causes the addresses to be mapped to additional columns in the main `Customers` table:
+
+```sql
+CREATE TABLE [Customers] (
+    [Id] int NOT NULL IDENTITY,
+    [Name] nvarchar(max) NOT NULL,
+    [BillingAddress_City] nvarchar(max) NOT NULL,
+    [BillingAddress_PostalCode] nvarchar(max) NOT NULL,
+    [BillingAddress_Street] nvarchar(max) NOT NULL,
+    [BillingAddress_StreetNumber] int NOT NULL,
+    [ShippingAddress_City] nvarchar(max) NOT NULL,
+    [ShippingAddress_PostalCode] nvarchar(max) NOT NULL,
+    [ShippingAddress_Street] nvarchar(max) NOT NULL,
+    [ShippingAddress_StreetNumber] int NOT NULL,
+    CONSTRAINT [PK_Customers] PRIMARY KEY ([Id])
+);
+```
+
+Note the difference with the default, traditional relational behavior of mapping the addresses to a separate table and using a foreign key to represent the customer/address relationship.
+
+While the above was already possible since EF 8, EF 10 adds support for **optional** types:
+
+```c#
+public class Customer
+{
+    ...
+
+    public Address ShippingAddress { get; set; }
+    public Address? BillingAddress { get; set; }
+}
+```
+
+Note that optional complex types currently require at least one required property to be defined on the complex type.
+
+### JSON
+
+EF 10 now allows mapping complex types to JSON:
+
+```c#
+modelBuilder.Entity<Customer>(b =>
+{
+    b.ComplexProperty(c => c.ShippingAddress, c => c.ToJson());
+    b.ComplexProperty(c => c.BillingAddress, c => c.ToJson());
+});
+```
+
+This causes EF to map each Address to a single JSON column in the customer table. When using the new SQL Server 2025 JSON column ([see above](#sql-server-json-type)), this causes the following table to be created:
+
+```sql
+CREATE TABLE [Customers] (
+    [Id] int NOT NULL IDENTITY,
+    [Name] nvarchar(max) NOT NULL,
+    [ShippingAddress] json NOT NULL,
+    [BillingAddress] json NULL,
+    CONSTRAINT [PK_Customers] PRIMARY KEY ([Id])
+);
+```
+
+Unlike table splitting, JSON mapping allows collections within the mapped type. You can query and update properties inside your JSON documents just like any other non-JSON property, and perform efficient bulk updating on them via <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.ExecuteUpdateAsync*> ([see release note](#execute-update-json)).
+
+### Struct support
+
+Complex types also supports mapping .NET structs instead of classes:
+
+```c#
+public struct Address
+{
+    public required string Street { get; set; }
+    public required string City { get; set; }
+    public required string ZipCode { get; set; }
+}
+```
+
+This aligns well with complex types not having an identity of their own, and only being found within entity types which have an identity. However, collections of structs aren't currently supported.
+
+### Complex and owned entity types
+
+Both table splitting and JSON mapping have been supported before EF 10 via owned entity modeling. However, this modeling created quite a few issues stemming from the fact that owned entity types are entity types, and therefore still operate with reference semantics and an identity behind the scenes.
+
+For example, trying to assign a customer's billing address to be the same as their shipping address fails with owned entity types, since the same entity type can't be referenced more than once:
+
+```c#
+var customer = await context.Customers.SingleAsync(c => c.Id == someId);
+customer.BillingAddress = customer.ShippingAddress;
+await context.SaveChangesAsync(); // ERROR
+```
+
+In contrast, since complex types have value semantics, assigning them simply copies their properties over, as expected. For the same reasons, bulk assignment of owned entity types is not supported, whereas complex types fully support <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.ExecuteUpdateAsync*> in EF 10 ([see release note](#execute-update-json)).
+
+Similarly, comparing a customer's shipping and billing addresses in LINQ queries does not work as expected, since entity types are compared by their identities; complex types, on the other hand, are compared by their contents, producing the expected result.
+
+These issues - as well as various others - make complex types the better choice for modeling JSON and table splitting, and users already using owned entity types for these are advised to switch to complex types.
+
+<a name="linq-and-sql-translation"></a>
+
+## LINQ and SQL translation
+
+<a name="parameterized-collection-translation"></a>
+
+### Improved translation for parameterized collection
+
+A notoriously difficult problem with relational databases is queries that involve *parameterized collections*:
+
+```c#
+int[] ids = [1, 2, 3];
+var blogs = await context.Blogs.Where(b => ids.Contains(b.Id)).ToListAsync();
+```
+
+In the above query, `ids` is a parameterized collection: the same query can be executed many times, with `ids` containing different values each time.
+
+Since relational databases don't typically support sending a collection directly as a parameter, EF version up to 8.0 simply inlined the collection contents into the SQL as constants:
+
+```sql
+SELECT [b].[Id], [b].[Name]
+FROM [Blogs] AS [b]
+WHERE [b].[Id] IN (1, 2, 3)
+```
+
+While this works, it has the unfortunate consequence of generating different SQLs for different collections, causing database plan cache misses and bloat, and creating various performance problems (see [#13617](https://github.com/dotnet/efcore/issues/13617), which was the most highly-voted issue in the repo at the time). As a result, EF 8.0 leveraged the introduction of extensive JSON support and changed the translation of parameterized collections to use JSON arrays ([release notes](xref:core/what-is-new/ef-core-8.0/whatsnew#queries-with-primitive-collections
+)):
+
+```sql
+@__ids_0='[1,2,3]'
+
+SELECT [b].[Id], [b].[Name]
+FROM [Blogs] AS [b]
+WHERE [b].[Id] IN (
+    SELECT [i].[value]
+    FROM OPENJSON(@__ids_0) WITH ([value] int '$') AS [i]
+)
+```
+
+Here, the collection is encoded as a string containing a JSON array, sent as a single parameter and then unpacked using the SQL Server [`OPENJSON`](/sql/t-sql/functions/openjson-transact-sql) function (other databases use similar mechanisms). Since the collection is now parameterized, the SQL stays the same and a single query plan no matter what values the collection contains. Unfortunately, while elegant, this translation also deprives the database query planner of important information on the cardinality (or length) of the collection, and can cause a plan to be chosen that works well for a small - or large - number of elements. As a result, EF Core 9.0 introduced the ability to control which translation strategy to use ([release notes](xref:core/what-is-new/ef-core-9.0/whatsnew#parameterized-primitive-collections)).
+
+EF 10.0 introduces a new default translation mode for parameterized collections, where each value in the collection is translated into its own scalar parameter:
+
+```sql
+SELECT [b].[Id], [b].[Name]
+FROM [Blogs] AS [b]
+WHERE [b].[Id] IN (@ids1, @ids2, @ids3)
+```
+
+This allows the collection values to change without resulting in different SQLs - solving the plan cache problem - but at the same time provides the query planner with information on the collection cardinality.
+
+Since different cardinalities still cause different SQLs to be generated, EF also "pads" parameter list. For example, if your `ids` list contains 8 values, EF generates SQL with 10 parameters:
+
+```sql
+SELECT [b].[Id], [b].[Name]
+FROM [Blogs] AS [b]
+WHERE [b].[Id] IN (@ids1, @ids2, @ids3, @ids4, @ids5, @ids6, @ids7, @ids8, @ids9, @ids10)
+```
+
+The last two parameters `@ids9` and `@ids10` are added by EF to reduce the number of SQLs generated, and contain the same value as `@ids8`, so that the query returns the same result.
+
+Unfortunately, parameterized collections are a case where EF simply cannot always make the right choice: selecting between multiple parameters (the new default), a single JSON array parameter (with e.g. SQL Server `OPENJSON`) or multiple inlined constants can require knowledge about the data in your database, and different choices may work better for different queries. As a result, EF exposes full control to the user to control the translation strategy, both at the global configuration level:
+
+```c#
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    => optionsBuilder
+        .UseSqlServer("<CONNECTION STRING>", o => o.UseParameterizedCollectionMode(ParameterTranslationMode.Constant));
+```
+
+... and at the per-query level:
+
+```c#
+var blogs = await context.Blogs.Where(b => EF.Constant(ids).Contains(b.Id)).ToListAsync();
+```
+
+### Support for the .NET 10 `LeftJoin` and `RightJoin` operators
+
+`LEFT JOIN` is a common and useful operation when working with EF Core. In previous versions, implementing `LEFT JOIN` in LINQ was quite complicated, requiring `SelectMany`, `GroupJoin` and `DefaultIfEmpty` operations [in a particular configuration](/dotnet/csharp/linq/standard-query-operators/join-operations#perform-left-outer-joins).
+
+.NET 10 adds first-class LINQ support for `LeftJoin` method, making those queries much simpler to write. EF Core recognizes the new method, so it can be used in EF LINQ queries instead of the old construct:
+
+```C#
+var query = context.Students
+    .LeftJoin(
+        context.Departments,
+        student => student.DepartmentID,
+        department => department.ID,
+        (student, department) => new 
+        { 
+            student.FirstName,
+            student.LastName,
+            Department = department.Name ?? "[NONE]"
+        });
+```
+
+> [!NOTE]
+> EF 10 also supports the analogous `RightJoin` operator, which keeps all the data from the second collection and only the matching data from the first collection. EF 10 translates this to `RIGHT JOIN` operation in the database.
+
+Unfortunately, C# query syntax (`from x select x.Id`) doesn't yet support expressing left/right join operations in this way.
+
+See [#12793](https://github.com/dotnet/efcore/issues/12793) and [#35367](https://github.com/dotnet/efcore/issues/35367) for more details.
+
+### More consistent ordering for split queries
+
+Split queries can be essential to avoid performance issues associated with JOINs, such as the so-called "cartesian explosion" effect (see [Single vs. Split Queries](xref:core/querying/single-split-queries) to learn more). However, since split queries loads related data in separate SQL queries, consistency issues can arise, possibly leading to non-deterministic, hard-to-detect data corruption.
+
+For example, consider the following query:
+
+```C#
+var blogs = await context.Blogs
+    .AsSplitQuery()
+    .Include(b => b.Posts)
+    .OrderBy(b => b.Name)
+    .Take(2)
+    .ToListAsync();
+```
+
+Prior to EF10, the following two SQL queries were generated:
+
+```sql
+SELECT TOP(@__p_0) [b].[Id], [b].[Name]
+FROM [Blogs] AS [b]
+ORDER BY [b].[Name], [b].[Id]
+
+SELECT [p].[Id], [p].[BlogId], [p].[Title], [b0].[Id]
+FROM (
+    SELECT TOP(@__p_0) [b].[Id], [b].[Name]
+    FROM [Blogs] AS [b]
+    ORDER BY [b].[Name]
+) AS [b0]
+INNER JOIN [Post] AS [p] ON [b0].[Id] = [p].[BlogId]
+ORDER BY [b0].[Name], [b0].[Id]
+```
+
+Note that the first query (the one reading Blogs) is integrated as a subquery within the second (the one reading Posts). However, the ordering within the subquery omits the `Id` column, leading to possible incorrect data being returned.
+
+EF10 fixes this by ensuring that the ordering is consistent across the queries:
+
+```sql
+SELECT [p].[Id], [p].[BlogId], [p].[Title], [b0].[Id]
+FROM (
+    SELECT TOP(@p) [b].[Id], [b].[Name]
+    FROM [Blogs] AS [b]
+    ORDER BY [b].[Name], [b].[Id]
+) AS [b0]
+INNER JOIN [Post] AS [p] ON [b0].[Id] = [p].[BlogId]
+ORDER BY [b0].[Name], [b0].[Id]
+```
+
+<a name="other-query-improvements"></a>
+
+### Other query improvements
+
+#### New translations
+
+- Translate [DateOnly.ToDateTime()](/dotnet/api/system.dateonly.todatetime) ([#35194](https://github.com/dotnet/efcore/pull/35194), contributed by [@mseada94](https://github.com/mseada94)).
+- Translate [DateOnly.DayNumber](/dotnet/api/system.dateonly.daynumber) and `DayNumber` subtraction for SQL Server and SQLite ([#36183](https://github.com/dotnet/efcore/issues/36183)).
+- Translate date/time functions using `DatePart.Microsecond` and `DatePart.Nanosecond` arguments ([#34861](https://github.com/dotnet/efcore/pull/34861)).
+- Translate `COALESCE` as `ISNULL` on SQL Server, for most cases ([#34171](https://github.com/dotnet/efcore/pull/34171), contributed by [@ranma42](https://github.com/ranma42)).
+- Support some string functions taking `char` as arguments ([#34999](https://github.com/dotnet/efcore/pull/34999), contributed by [@ChrisJollyAU](https://github.com/ChrisJollyAU)).
+- Support `MAX`/`MIN`/`ORDER BY` using `decimal` on SQLite ([#35606](https://github.com/dotnet/efcore/pull/35606), contributed by [@ranma42](https://github.com/ranma42)).
+- Support projecting different navigations (but same type) via conditional operator ([#34589](https://github.com/dotnet/efcore/issues/34589), contributed by [@ranma42](https://github.com/ranma42)).
+
+#### Bug fixes and optimizations
+
+- Fix Microsoft.Data.Sqlite behavior around `DateTime`, `DateTimeOffset` and UTC, [see breaking change notes](xref:core/what-is-new/ef-core-10.0/breaking-changes#DateTimeOffset-read) ([#36195](https://github.com/dotnet/efcore/issues/36195)).
+- Fix translation of `DefaultIfEmpty` in various scenarios:
+  - [DefaultIfEmpty applied on child collection wipes the parent info in query result](https://github.com/dotnet/efcore/issues/19095)
+  - [Logic for lifting DefaultIfEmpty out of SelectMany (to LEFT JOIN/OUTER APPLY) is incorrect](https://github.com/dotnet/efcore/issues/33343)
+  - [NavigationExpandingExpressionVisitor moves Select() behind DefaultIfEmpty()](https://github.com/dotnet/efcore/issues/36208)
+  - [EF Core 9 no longer applies COALESCE in SQL translation for DefaultIfEmpty() which causing an InvalidOperationException](https://github.com/dotnet/efcore/issues/35950)
+- Optimize multiple consecutive `LIMIT`s ([#35384](https://github.com/dotnet/efcore/pull/35384), contributed by [@ranma42](https://github.com/ranma42)).
+- Optimize use of `Count` operation on `ICollection<T>` ([#35381](https://github.com/dotnet/efcore/pull/35381), contributed by [@ChrisJollyAU](https://github.com/ChrisJollyAU)).
+- Optimize `MIN`/`MAX` over `DISTINCT` ([#34699](https://github.com/dotnet/efcore/pull/34699), contributed by [@ranma42](https://github.com/ranma42)).
+- Simplify parameter names (e.g. from `@__city_0` to `@city`) ([#35200](https://github.com/dotnet/efcore/pull/35200)).
+
+<a name="execute-update-json"></a>
+
+## ExecuteUpdate support for relational JSON columns
+
+> [!NOTE]
+> ExecuteUpdate support for JSON requires mapping your types as complex types ([see above](#json)), and does not work when your types are mapped as owned entities.
+
+Although EF has support JSON columns for some time and allows updating them via <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*>, <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.ExecuteUpdateAsync*> lacked support for them. EF10 now allows referencing JSON columns and properties within them in <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.ExecuteUpdateAsync*>, allowing efficient bulk updating of document-modeled data within relational databases.
+
+For example, given the following model, mapping the `BlogDetails` type to a complex JSON column in the database:
+
+```c#
+public class Blog
+{
+    public int Id { get; set; }
+
+    public BlogDetails Details { get; set; }
+}
+
+public class BlogDetails
+{
+    public string Title { get; set; }
+    public int Views { get; set; }
+}
+
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Blog>().ComplexProperty(b => b.Details, bd => bd.ToJson());
+}
+```
+
+You can now use <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.ExecuteUpdateAsync*> as usual, referencing properties within `BlogDetails`:
+
+```c#
+await context.Blogs.ExecuteUpdateAsync(s =>
+    s.SetProperty(b => b.Details.Views, b => b.Details.Views + 1));
+```
+
+This generates the following for SQL Server 2025, using the efficient, new [`modify`](/sql/t-sql/data-types/json-data-type#the-modify-method) function to increment the JSON property `Views` by one:
+
+```sql
+UPDATE [b]
+SET [Details].modify('$.Views', JSON_VALUE([b].[Details], '$.Views' RETURNING int) + 1)
+FROM [Blogs] AS [b]
+```
+
+Older versions of SQL Server are also supported, where the JSON data is stored in an `nvarchar(max)` column rather than the new JSON data type support. For support with other databases, consult the documentation for your EF provider.
+
+<a name="named-query-filters"></a>
+
+## Named query filters
+
+EF's [global query filters](xref:core/querying/filters) feature has long enabled users to configuring filters to entity types which apply to all queries by default. This has simplified implementing common patterns and scenarios such as soft deletion, multitenancy and others. However, up to now EF has only supported a single query filter per entity type, making it difficult to have multiple filters and selectively disabling only some of them in specific queries.
+
+EF 10 introduces *named query filters*, which allow attaching names to query filter and managing each one separately:
+
+[!code-csharp[Main](../../../../samples/core/Querying/QueryFilters/NamedFilters.cs#FilterConfiguration)]
+
+This notably allows disabling only certain filters in a specific LINQ query:
+
+[!code-csharp[Main](../../../../samples/core/Querying/QueryFilters/NamedFilters.cs#DisableSoftDeletionFilter)]
+
+For more information on named query filters, [see the documentation](xref:core/querying/filters).
+
+This feature was contributed by [@bittola](https://github.com/bittola).
+
+## ExecuteUpdateAsync now accepts a regular, non-expression lambda
+
+The <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.ExecuteUpdateAsync*> can be used to express arbitrary update operations in the database. In previous versions, the changes to be performed on the database rows were provided via an expression tree parameter; this made it quite difficult to build those changes dynamically. For example, let's assume we want to update a Blog's Views, but conditionally also its Name. Since the setters argument was an expression tree, code such as the following needed to be written:
+
+```c#
+// Base setters - update the Views only
+Expression<Func<SetPropertyCalls<Blog>, SetPropertyCalls<Blog>>> setters =
+    s => s.SetProperty(b => b.Views, 8);
+
+// Conditionally add SetProperty(b => b.Name, "foo") to setters, based on the value of nameChanged
+if (nameChanged)
+{
+    var blogParameter = Expression.Parameter(typeof(Blog), "b");
+
+    setters = Expression.Lambda<Func<SetPropertyCalls<Blog>, SetPropertyCalls<Blog>>>(
+        Expression.Call(
+            instance: setters.Body,
+            methodName: nameof(SetPropertyCalls<Blog>.SetProperty),
+            typeArguments: [typeof(string)],
+            arguments:
+            [
+                Expression.Lambda<Func<Blog, string>>(Expression.Property(blogParameter, nameof(Blog.Name)), blogParameter),
+                Expression.Constant("foo")
+            ]),
+        setters.Parameters);
+}
+
+await context.Blogs.ExecuteUpdateAsync(setters);
+```
+
+Manually creating expression trees is complicated and error-prone, and made this common scenario much more difficult than it should have been. Starting with EF 10, you can now write the following instead:
+
+```c#
+await context.Blogs.ExecuteUpdateAsync(s =>
+{
+    s.SetProperty(b => b.Views, 8);
+    if (nameChanged)
+    {
+        s.SetProperty(b => b.Name, "foo");
+    }
+});
+```
+
+Thanks to [@aradalvand](https://github.com/aradalvand) for proposing and pushing for this change (in [#32018](https://github.com/dotnet/efcore/issues/32018)).
+
+<a name="other-improvements"></a>
+
+## Security-related improvements
+
+### Redact inlined constants from logging by default
+
+When logging executed SQL, EF does not log parameter values by default, since these may contain sensitive or personally-identifiable information (PII); <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.EnableSensitiveDataLogging*> can be used to enable logging parameter values in diagnostic or debugging scenarios ([see documentation](xref:core/logging-events-diagnostics/extensions-logging#sensitive-data)).
+
+However, EF sometimes inlines parameters into the SQL statement rather than sending them separately; in those scenarios, the potentially sensitive values were logged. EF10 no longer does this, redacting such inlined parameters by default and replacing them with a question mark character (`?`). For example, let's say we have a function that accepts a list of roles, and returns the list of users which have one of those roles:
+
+```c#
+Task<List<User>> GetUsersByRoles(BlogContext context, string[] roles)
+    => context.Users.Where(b => roles.Contains(b.Role)).ToListAsync();
+```
+
+Although the roles here are parameterized (may differ across invocations), we know that the actual sets of roles queried will be quite limited. We can therefore tell EF to *inline* the roles, so that the database's planner can plan execution separately for this query with its specific set of roles:
+
+```c#
+Task<List<User>> GetUsersByRoles(BlogContext context, string[] roles)
+    => context.Users.Where(b => EF.Constant(roles).Contains(b.Role)).ToListAsync();
+```
+
+On previous versions of EF, this produced the following SQL:
+
+```sql
+SELECT [u].[Id], [u].[Role]
+FROM [Users] AS [u]
+WHERE [u].[Role] IN (N'Administrator', N'Manager')
+```
+
+EF10 sends the same SQL to the database, but logs the following SQL, where the roles have been redacted:
+
+```sql
+SELECT [b].[Id], [b].[Role]
+FROM [Blogs] AS [b]
+WHERE [b].[Role] IN (?, ?)
+```
+
+If the roles represent sensitive information, this prevents that information from leaking into the application logs. As with regular parameters, full logging can be reenabled via <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.EnableSensitiveDataLogging*>.
+
+### Warn for string concatenation with raw SQL APIs
+
+SQL injection is one of the most serious security vulnerabilities in database applications; if unsanitized external input is inserted into SQL queries, a malicious user may be able to perform SQL injection, executing arbitrary SQL on your database. For more information about EF's SQL querying APIs and SQL injection, [see the documentation](xref:core/querying/sql-queries#passing-parameters).
+
+While EF users rarely deal with SQL directly, EF does provide SQL-based APIs for the cases where they're needed. Most of these APIs are safe in the face of SQL injection; for example <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.FromSql*> accepts a .NET `FormattableString`, and any parameter will automatically be send as a separate SQL parameter, preventing SQL injection. However, in some scenarios it's necessary to build up a dynamic SQL query by piecing together multiple fragments; <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.FromSqlRaw*> is designed specifically for this, and requires the user to ensure that all fragments are trusted or properly sanitized.
+
+Starting with EF10, EF has an analyzer which warns if concatenation is performed within a "raw" SQL method invocation:
+
+```c#
+var users = context.Users.FromSqlRaw("SELECT * FROM Users WHERE [" + fieldName + "] IS NULL");
+```
+
+If `fieldName` is trusted or has been properly sanitized, the warning can be safely suppressed.
+
+## Other improvements
+
+- AUTOINCREMENT can now be disabled for SQLite and is also supported for properties with value converters. For more information, see [SQLite Value Generation](xref:core/providers/sqlite/value-generation).
+- Stop spanning all migrations with a single transaction ([#35096](https://github.com/dotnet/efcore/issues/35096)). This reverts a change done in EF9 which caused issues in various migration scenarios.
+- Make SQL Server scaffolding compatible with Azure Data Explorer ([#34832](https://github.com/dotnet/efcore/pull/34832), contributed by [@barnuri](https://github.com/barnuri)).
+- Associate the DatabaseRoot with the scoped options instance and not the singleton options ([#34477](https://github.com/dotnet/efcore/pull/34477), contributed by [@koenigst](https://github.com/koenigst)).
+- Improve LoadExtension to work correctly with dotnet run and lib* named libs ([#35617](https://github.com/dotnet/efcore/pull/35617), contributed by [@krwq](https://github.com/krwq)).
+- Changes to AsyncLocal usage for better lazy loading performance ([#35835](https://github.com/dotnet/efcore/pull/35835), contributed by [@henriquewr](https://github.com/henriquewr)).
+
+[The full list of issues for the release can be found here](https://github.com/dotnet/efcore/issues?q=is%3Aissue%20milestone%3A10.0.0).
diff --git a/entity-framework/core/what-is-new/ef-core-11.0/breaking-changes.md b/entity-framework/core/what-is-new/ef-core-11.0/breaking-changes.md
new file mode 100644
index 0000000000..ece54855f2
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-11.0/breaking-changes.md
@@ -0,0 +1,370 @@
+---
+title: Breaking changes in EF Core 11 (EF11) - EF Core
+description: List of breaking changes introduced in Entity Framework Core 11 (EF11)
+author: roji
+ms.date: 03/27/2026
+uid: core/what-is-new/ef-core-11.0/breaking-changes
+---
+
+# Breaking changes in EF Core 11 (EF11)
+
+This page documents API and behavior changes that have the potential to break existing applications updating from EF Core 10 to EF Core 11. Make sure to review earlier breaking changes if updating from an earlier version of EF Core:
+
+- [Breaking changes in EF Core 10](xref:core/what-is-new/ef-core-10.0/breaking-changes)
+- [Breaking changes in EF Core 9](xref:core/what-is-new/ef-core-9.0/breaking-changes)
+- [Breaking changes in EF Core 8](xref:core/what-is-new/ef-core-8.0/breaking-changes)
+
+## Summary
+
+> [!NOTE]
+> If you are using Microsoft.Data.Sqlite, please see the [separate section below on Microsoft.Data.Sqlite breaking changes](#MDS-breaking-changes).
+
+| **Breaking change**                                                                                             | **Impact** |
+|:--------------------------------------------------------------------------------------------------------------- | -----------|
+| [Sync I/O via the Azure Cosmos DB provider has been fully removed](#cosmos-nosync)                              | Medium     |
+| [Microsoft.Data.SqlClient has been updated to 7.0](#sqlclient-7)                                                | Medium     |
+| [EF Core now throws by default when no migrations are found](#migrations-not-found)                             | Low        |
+| [`EFOptimizeContext` MSBuild property has been removed](#ef-optimize-context-removed)                           | Low        |
+| [EF tools packages no longer reference Microsoft.EntityFrameworkCore.Design](#ef-tools-no-design-dep)           | Low        |
+| [SqlVector properties are no longer loaded by default](#sqlvector-not-auto-loaded)                              | Low        |
+| [Cosmos: empty owned collections now return an empty collection instead of null](#cosmos-empty-collections)     | Low        |
+
+## Medium-impact changes
+
+<a name="cosmos-nosync"></a>
+
+### Sync I/O via the Azure Cosmos DB provider has been fully removed
+
+[Tracking Issue #37059](https://github.com/dotnet/efcore/issues/37059)
+
+#### Old behavior
+
+Synchronous I/O via the Azure Cosmos DB provider has been unsupported since EF 9.0 ([note](/ef/core/what-is-new/ef-core-9.0/breaking-changes#cosmos-nosync)); calling any sync I/O API - like `ToList` or `SaveChanges` threw an exception, unless a special opt-in was configured. When the opt-in was configured, sync I/O APIs worked as before, causing the provider to perform "sync-over-async" blocking against the Azure Cosmos DB SDK, which could result in deadlocks and other performance issues.
+
+#### New behavior
+
+Starting with EF Core 11.0, EF now always throws when a synchronous I/O API is called. There is no way to opt back into using sync I/O APIs.
+
+#### Why
+
+Synchronous blocking on asynchronous methods ("sync-over-async") is highly discouraged, and can lead to deadlock and other performance problems. Since the Azure Cosmos DB SDK only supports async methods, so does the EF Cosmos provider.
+
+#### Mitigations
+
+Convert your code to use async I/O APIs instead of sync I/O ones. For example, replace calls to `SaveChanges()` with `await SaveChangesAsync()`.
+
+<a name="sqlclient-7"></a>
+
+### Microsoft.Data.SqlClient has been updated to 7.0
+
+#### Old behavior
+
+EF Core 10 used [Microsoft.Data.SqlClient](https://www.nuget.org/packages/Microsoft.Data.SqlClient/) 6.x, which included Azure/Entra ID authentication dependencies (such as `Azure.Core`, `Azure.Identity`, and `Microsoft.Identity.Client`) in the core package.
+
+#### New behavior
+
+EF Core 11 now depends on [Microsoft.Data.SqlClient](https://www.nuget.org/packages/Microsoft.Data.SqlClient/) 7.0. This version removes Azure/Entra ID (formerly Azure Active Directory) authentication dependencies from the core package. If your application uses Entra ID authentication (for example, `ActiveDirectoryDefault`, `ActiveDirectoryInteractive`, `ActiveDirectoryManagedIdentity`, or `ActiveDirectoryServicePrincipal`), you must now install the [`Microsoft.Data.SqlClient.Extensions.Azure`](https://www.nuget.org/packages/Microsoft.Data.SqlClient.Extensions.Azure/) package separately.
+
+In addition, `SqlAuthenticationMethod.ActiveDirectoryPassword` has been marked as obsolete.
+
+For more details, see the [Microsoft.Data.SqlClient 7.0 release notes](https://github.com/dotnet/SqlClient/blob/main/release-notes/7.0/7.0.0.md).
+
+#### Why
+
+This change was made in [Microsoft.Data.SqlClient](https://www.nuget.org/packages/Microsoft.Data.SqlClient/) to reduce dependency bloat for applications that don't use Azure authentication, which is especially beneficial for containerized deployments and local development.
+
+#### Mitigations
+
+If your application uses Entra ID authentication with SQL Server, add a reference to the `Microsoft.Data.SqlClient.Extensions.Azure` package in your project:
+
+```xml
+<PackageReference Include="Microsoft.Data.SqlClient.Extensions.Azure" Version="7.0.0" />
+```
+
+No code changes are required beyond adding this package reference. If you use `SqlAuthenticationMethod.ActiveDirectoryPassword`, migrate to a modern authentication method such as `ActiveDirectoryDefault` or `ActiveDirectoryInteractive`.
+
+## Low-impact changes
+
+<a name="migrations-not-found"></a>
+
+### EF Core now throws by default when no migrations are found
+
+[Tracking Issue #35218](https://github.com/dotnet/efcore/issues/35218)
+
+#### Old behavior
+
+Previously, when calling <xref:Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.Migrate*> or <xref:Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.MigrateAsync*> on a database with no migrations in the assembly, EF Core logged an informational message and returned without applying any changes.
+
+#### New behavior
+
+Starting with EF Core 11.0, EF Core throws an exception by default when no migrations are found in the assembly. This is consistent with the `PendingModelChangesWarning` behavior [introduced in EF 9.0](xref:core/what-is-new/ef-core-9.0/breaking-changes#pending-model-changes).
+
+#### Why
+
+Calling `Migrate()` or `MigrateAsync()` when no migrations exist typically indicates a misconfiguration. Rather than silently continuing and leaving the database in a potentially incorrect state, EF Core now alerts developers to this issue immediately.
+
+#### Mitigations
+
+If you intentionally call `Migrate()` without having any migrations (for example, because you manage the database schema through other means), remove the `Migrate()` call or suppress the exception by configuring warnings:
+
+```csharp
+options.ConfigureWarnings(w => w.Ignore(RelationalEventId.MigrationsNotFound))
+```
+
+Or to log the event instead of throwing:
+
+```csharp
+options.ConfigureWarnings(w => w.Log(RelationalEventId.MigrationsNotFound))
+```
+
+<a name="ef-optimize-context-removed"></a>
+
+### `EFOptimizeContext` MSBuild property has been removed
+
+[Tracking Issue #35079](https://github.com/dotnet/efcore/issues/35079)
+
+#### Old behavior
+
+Previously, the `EFOptimizeContext` MSBuild property could be set to `true` to enable compiled model and precompiled query code generation during build or publish:
+
+```xml
+<EFOptimizeContext Condition="'$(Configuration)'=='Release'">true</EFOptimizeContext>
+```
+
+#### New behavior
+
+Starting with EF Core 11.0, the `EFOptimizeContext` MSBuild property has been removed. Code generation is now controlled exclusively through the `EFScaffoldModelStage` and `EFPrecompileQueriesStage` properties. When `PublishAOT` is set to `true`, code generation is automatically enabled during publish without needing any additional property.
+
+#### Why
+
+The `EFScaffoldModelStage` and `EFPrecompileQueriesStage` properties already provide fine-grained control over when code generation occurs. `EFOptimizeContext` was a redundant enablement gate.
+
+#### Mitigations
+
+Replace usages of `EFOptimizeContext` with the `EFScaffoldModelStage` and `EFPrecompileQueriesStage` properties. These can be set to `publish` or `build` to control at which stage code generation occurs:
+
+```xml
+<EFScaffoldModelStage>publish</EFScaffoldModelStage>
+<EFPrecompileQueriesStage>publish</EFPrecompileQueriesStage>
+```
+
+Any other value (for example, `none`) disables the corresponding generation.
+
+If you have `PublishAOT` set to `true`, code generation is automatically enabled during publish and no additional configuration is needed.
+
+<a name="ef-tools-no-design-dep"></a>
+
+### EF tools packages no longer reference Microsoft.EntityFrameworkCore.Design
+
+[Tracking Issue #37739](https://github.com/dotnet/efcore/issues/37739)
+
+#### Old behavior
+
+Previously, the `Microsoft.EntityFrameworkCore.Tools` and `Microsoft.EntityFrameworkCore.Tasks` NuGet packages had a dependency on `Microsoft.EntityFrameworkCore.Design`.
+
+#### New behavior
+
+Starting with EF Core 11.0, the `Microsoft.EntityFrameworkCore.Tools` and `Microsoft.EntityFrameworkCore.Tasks` NuGet packages no longer have a dependency on `Microsoft.EntityFrameworkCore.Design`.
+
+#### Why
+
+There was no hard dependency on the code in `Microsoft.EntityFrameworkCore.Design`, and this dependency was causing issues when using the latest `Microsoft.EntityFrameworkCore.Tools` with projects targeting older frameworks.
+
+#### Mitigations
+
+If your project relies on `Microsoft.EntityFrameworkCore.Design` being brought in transitively through the tools packages, add a direct reference to it in your project:
+
+```xml
+<PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="11.0.0" PrivateAssets="all" />
+```
+
+<a name="sqlvector-not-auto-loaded"></a>
+
+### SqlVector properties are no longer loaded by default
+
+[Tracking Issue #37279](https://github.com/dotnet/efcore/issues/37279)
+
+#### Old behavior
+
+Previously, when querying entities with `SqlVector<T>` properties, EF Core included the vector column in `SELECT` statements and populated the property on the returned entity.
+
+#### New behavior
+
+Starting with EF Core 11.0, `SqlVector<T>` properties are no longer included in `SELECT` statements when materializing entities. The property will be `null` on returned entities.
+
+Vector properties can still be used in `WHERE` and `ORDER BY` clauses—including with `VectorDistance()` and `VectorSearch()`; they just won't be included in the entity projection.
+
+#### Why
+
+Vector columns can be very large, containing hundreds or thousands of floating-point values. In the vast majority of cases, vectors are written to the database and then used for search, without needing to be read back. Excluding them from `SELECT` by default avoids unnecessary data transfer.
+
+#### Mitigations
+
+> [!NOTE]
+> A mechanism for opting vector properties back into automatic loading will be introduced later in the EF Core 11 release.
+
+If you need to read back vector values, use an explicit projection:
+
+```csharp
+var embeddings = await context.Blogs
+    .Select(b => new { b.Id, b.Embedding })
+    .ToListAsync();
+```
+
+<a name="cosmos-empty-collections"></a>
+
+### Cosmos: empty owned collections now return an empty collection instead of null
+
+[Tracking Issue #36577](https://github.com/dotnet/efcore/issues/36577)
+
+#### Old behavior
+
+Previously, when querying entities via the Azure Cosmos DB provider where an owned collection contained no items, the collection property was `null` on the materialized entity.
+
+#### New behavior
+
+Starting with EF Core 11.0, the Azure Cosmos DB provider correctly initializes empty owned collections, returning an empty collection instead of `null`.
+
+#### Why
+
+The previous behavior of materializing empty owned collections as `null` was a bug.
+
+#### Mitigations
+
+If your code explicitly checks owned collection properties for `null` to detect that the collection is empty, those checks can simply be removed, since the collection is now always initialized:
+
+```csharp
+// Before
+if (entity.OwnedCollection is null or { Count: 0 })
+{
+    // treated as empty
+}
+
+// After
+if (entity.OwnedCollection is { Count: 0 })
+{
+    // treated as empty
+}
+```
+
+<a name="MDS-breaking-changes"></a>
+
+## Microsoft.Data.Sqlite breaking changes
+
+> [!NOTE]
+> [SQLitePCLRaw](https://github.com/ericsink/SQLitePCL.raw) is an external, community-maintained library that is not owned or maintained by Microsoft. Microsoft.Data.Sqlite depends on it for its SQLite connectivity.
+
+### Summary
+
+| **Breaking change**                                                                                       | **Impact** |
+|:----------------------------------------------------------------------------------------------------------|------------|
+| [Encryption-enabled SQLite packages have been removed](#sqlite-encryption-removed)                        | Medium     |
+| [Some SQLitePCLRaw bundle packages have been removed](#sqlite-bundles-removed)                            | Medium     |
+
+### Medium-impact changes
+
+<a name="sqlite-encryption-removed"></a>
+
+#### Encryption-enabled SQLite packages have been removed
+
+[Tracking Issue #5108](https://github.com/dotnet/EntityFramework.Docs/issues/5108)
+
+##### Old behavior
+
+Previously, the `SQLitePCLRaw.bundle_e_sqlcipher` NuGet package provided encryption-enabled SQLite builds at no cost.
+
+##### New behavior
+
+Starting with SQLitePCLRaw 3.0 (used by Microsoft.Data.Sqlite 11.0), the `SQLitePCLRaw.bundle_e_sqlcipher` package has been deprecated and removed from NuGet. No-cost encryption-enabled SQLite builds are no longer distributed.
+
+##### Why
+
+The previous no-cost `SQLitePCLRaw.bundle_e_sqlcipher` package was barely maintained, which is a significant concern for encryption software where security vulnerabilities may go unpatched. The SQLitePCLRaw maintainer removed these builds in version 3.0 in favor of professionally maintained, paid alternatives that provide ongoing security updates.
+
+##### Mitigations
+
+If you need SQLite encryption, you have the following options:
+
+- **SQLite Encryption Extension (SEE)**: This is the official encryption implementation from the SQLite team. A paid license is required. See [https://sqlite.org/com/see.html](https://sqlite.org/com/see.html) for details. NuGet packages are available through [SourceGear's SQLite build service](https://github.com/ericsink/SQLitePCL.raw/wiki/SQLite-encryption-options-for-use-with-SQLitePCLRaw).
+- **SQLCipher**: Purchase supported builds from [Zetetic](https://www.zetetic.net/sqlcipher/), or build the [open source code](https://github.com/sqlcipher/sqlcipher) yourself.
+- **SQLite3 Multiple Ciphers**: NuGet packages are available from [SQLite3MultipleCiphers-NuGet](https://github.com/utelle/SQLite3MultipleCiphers-NuGet).
+  - When encrypting a new database or opening an existing database that was encrypted with SQLCipher, you must configure the cipher scheme in the connection string using URI parameters—for example: `Data Source=file:example.db?cipher=sqlcipher&legacy=4;Password=<password>`. See [How to open an existing database encrypted with SQLCipher](https://github.com/utelle/SQLite3MultipleCiphers-NuGet#how-to-open-an-existing-database-encrypted-with-sqlcipher) for details.
+
+For more details, see [SQLite encryption options for use with SQLitePCLRaw](https://github.com/ericsink/SQLitePCL.raw/wiki/SQLite-encryption-options-for-use-with-SQLitePCLRaw) and [SQLitePCLRaw 3.0 Release Notes](https://github.com/ericsink/SQLitePCL.raw/blob/main/v3.md).
+
+<a name="sqlite-bundles-removed"></a>
+
+#### Some SQLitePCLRaw bundle packages have been removed
+
+[Tracking Issue #5108](https://github.com/dotnet/EntityFramework.Docs/issues/5108)
+
+##### Old behavior
+
+Previously, the `SQLitePCLRaw.bundle_sqlite3`, `SQLitePCLRaw.bundle_winsqlite3`, `SQLitePCLRaw.bundle_green`, and `SQLitePCLRaw.bundle_e_sqlite3mc` packages provided a convenient way to configure SQLitePCLRaw with the corresponding SQLite provider.
+
+##### New behavior
+
+Starting with SQLitePCLRaw 3.0 (used by Microsoft.Data.Sqlite 11.0), these bundle packages have been removed. If your application depended on one of these bundles, you must now reference the corresponding provider package and explicitly initialize it.
+
+##### Why
+
+Each of these bundle packages contained only a single line of configuration code and added unnecessary packaging overhead. The corresponding provider packages are still supported.
+
+##### Mitigations
+
+Replace the removed bundle package with the corresponding provider package and add explicit initialization code.
+
+**If using `bundle_sqlite3` or `bundle_winsqlite3`**, replace the package reference:
+
+```xml
+<!-- Old -->
+<PackageReference Include="SQLitePCLRaw.bundle_sqlite3" Version="2.x.x" />
+<!-- or -->
+<PackageReference Include="SQLitePCLRaw.bundle_winsqlite3" Version="2.x.x" />
+
+<!-- New -->
+<PackageReference Include="SQLitePCLRaw.provider.sqlite3" Version="3.x.x" />
+<!-- or -->
+<PackageReference Include="SQLitePCLRaw.provider.winsqlite3" Version="3.x.x" />
+```
+
+Then add explicit initialization before using SQLite:
+
+```csharp
+// For sqlite3
+static void Init()
+{
+    SQLitePCL.raw.SetProvider(new SQLitePCL.SQLite3Provider_sqlite3());
+}
+
+// For winsqlite3
+static void Init()
+{
+    SQLitePCL.raw.SetProvider(new SQLitePCL.SQLite3Provider_winsqlite3());
+}
+```
+
+**If using `bundle_green`**, the recommended migration path is to switch to `SQLitePCLRaw.bundle_e_sqlite3`. Alternatively, use `SQLitePCLRaw.config.e_sqlite3` paired with a separate native library package like `SourceGear.sqlite3`, which allows you to update the SQLite version independently:
+
+```xml
+<PackageReference Include="SQLitePCLRaw.bundle_e_sqlite3" Version="3.x.x" />
+```
+
+If you only target iOS and want to continue using the system SQLite library, reference the provider directly:
+
+```xml
+<PackageReference Include="SQLitePCLRaw.core" Version="3.x.x" />
+<PackageReference Include="SQLitePCLRaw.provider.sqlite3" Version="3.x.x" />
+```
+
+And initialize it explicitly:
+
+```csharp
+static void Init()
+{
+    SQLitePCL.raw.SetProvider(new SQLitePCL.SQLite3Provider_sqlite3());
+}
+```
+
+> [!NOTE]
+> If you are using `SQLitePCLRaw.bundle_e_sqlite3`, no changes are required—just update the version number. See the [SQLitePCLRaw 3.0 Release Notes](https://github.com/ericsink/SQLitePCL.raw/blob/main/v3.md) for details.
diff --git a/entity-framework/core/what-is-new/ef-core-11.0/provider-facing-changes.md b/entity-framework/core/what-is-new/ef-core-11.0/provider-facing-changes.md
new file mode 100644
index 0000000000..34972144d9
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-11.0/provider-facing-changes.md
@@ -0,0 +1,19 @@
+---
+title: Provider-facing changes in EF Core 11 (EF11) - EF Core
+description: List of provider-facing changes introduced in Entity Framework Core 11 (EF11)
+author: roji
+ms.date: 01/16/2026
+uid: core/what-is-new/ef-core-11.0/provider-facing-changes
+---
+
+# Provider-facing changes in EF Core 11 (EF11)
+
+This page documents noteworthy changes in EF Core 11 which may affect EF providers; none of these should affect end-users of EF - this page is only meant for EF provider maintainers. The list is maintained on a best-effort basis, some changes may be missing.
+
+## Changes
+
+* Collation names are now quoted in SQL, like column and table names ([see #37462](https://github.com/dotnet/efcore/issues/37462)). If your database doesn't support collation name quoting, override `QuerySqlGenerator.VisitSql()` and `MigrationsSqlGenerator.ColumnDefinition()` to revert to the previous behavior, but it's recommended to implement some sort of restricted character validation.
+
+## Test changes
+
+* The inheritance specification tests have been reorganized into a folder of their own ([PR](https://github.com/dotnet/efcore/pull/37410)).
diff --git a/entity-framework/core/what-is-new/ef-core-11.0/whatsnew.md b/entity-framework/core/what-is-new/ef-core-11.0/whatsnew.md
new file mode 100644
index 0000000000..0c5ae797f7
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-11.0/whatsnew.md
@@ -0,0 +1,592 @@
+---
+title: What's New in EF Core 11
+description: Overview of new features in EF Core 11
+author: roji
+ms.date: 02/02/2026
+uid: core/what-is-new/ef-core-11.0/whatsnew
+---
+
+# What's New in EF Core 11
+
+EF Core 11.0 (EF11) is the next release after EF Core 10.0 and is currently in development.
+
+> [!TIP]
+> You can run and debug into the samples by [downloading the sample code from GitHub](https://github.com/dotnet/EntityFramework.Docs). Each section below links to the source code specific to that section.
+
+EF11 requires the .NET 11 SDK to build and requires the .NET 11 runtime to run. EF11 will not run on earlier .NET versions, and will not run on .NET Framework.
+
+## Complex types
+
+<a name="complex-types-tpt-tpc"></a>
+
+### Complex types and JSON columns on entity types with TPT/TPC inheritance
+
+EF Core has supported complex types and JSON columns for several versions, allowing you to model and persist nested, structured data within your entities. However, until now these features could not be used on entities with TPT (table-per-type) or TPC (table-per-concrete-type) inheritance.
+
+Starting with EF 11, you can now use complex types and JSON columns on entity types with TPT and TPC inheritance mappings. For example, consider the following entity types with a TPT inheritance strategy:
+
+```csharp
+public abstract class Animal
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+    public required AnimalDetails Details { get; set; }
+}
+
+public class Dog : Animal
+{
+    public string Breed { get; set; }
+}
+
+public class Cat : Animal
+{
+    public bool IsIndoor { get; set; }
+}
+
+[ComplexType]
+public class AnimalDetails
+{
+    public DateTime BirthDate { get; set; }
+    public string? Veterinarian { get; set; }
+}
+```
+
+With the following TPT mapping configuration:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Animal>().UseTptMappingStrategy();
+}
+```
+
+EF 11 now properly supports this scenario, creating the `Details_BirthDate` and `Details_Veterinarian` columns on the `Animal` table for the complex type properties.
+
+Similarly, JSON columns are now supported with TPT/TPC. The following configuration maps the `Details` property to a JSON column:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Animal>()
+        .UseTptMappingStrategy()
+        .ComplexProperty(a => a.Details, b => b.ToJson());
+}
+```
+
+This enhancement removes a significant limitation when modeling complex domain hierarchies, allowing you to combine the flexibility of TPT/TPC inheritance with the power of complex types and JSON columns.
+
+For more information on inheritance mapping strategies, see [Inheritance](xref:core/modeling/inheritance).
+
+<a name="complex-types-cosmos"></a>
+
+### Complex types in Azure Cosmos DB
+
+Complex types are now fully supported in the Azure Cosmos DB provider, embedded as nested JSON objects or arrays. For more information, [see the Cosmos DB section below](#cosmos-complex-types).
+
+<a name="complex-types-stabilization"></a>
+
+### Stabilization and bug fixes
+
+Significant effort has gone into making sure that complex type support is stable and bug-free, to unblock using complex types as an alternative to the owned entity mapping approach. Bugs fixed include:
+
+* [Error querying on complex type whose container is mapped to a table and a view](https://github.com/dotnet/efcore/issues/34706)
+* [Problem with ComplexProperty in EF9, when using the TPT approach](https://github.com/dotnet/efcore/issues/35392)
+* [Comparison of complex types does not compare properties within nested complex types](https://github.com/dotnet/efcore/issues/37391)
+* [Assignment of complex type does not assign nested properties correctly (ExecuteUpdate)](https://github.com/dotnet/efcore/issues/37395)
+* [Map two classes with same nullable complex properties to same column → NullReferenceException](https://github.com/dotnet/efcore/issues/37335)
+* [Complex property stored as JSON marked non-nullable in TPH class hierarchy](https://github.com/dotnet/efcore/issues/37404)
+* [EntityEntry.ReloadAsync throws when nullable complex property is null](https://github.com/dotnet/efcore/issues/37559)
+* [Unnecessary columns in SQL with Complex Types + object closures in projections](https://github.com/dotnet/efcore/issues/37551)
+
+## LINQ and SQL translation
+
+<a name="linq-to-one-join-pruning"></a>
+
+### Better SQL for to-one joins
+
+EF Core 11 generates better SQL when querying with to-one (reference) navigation includes in two ways.
+
+First, when using split queries (`AsSplitQuery()`), EF previously added unnecessary joins to reference navigations in the SQL generated for collection queries. For example, consider the following query:
+
+```csharp
+var blogs = context.Blogs
+    .Include(b => b.BlogType)
+    .Include(b => b.Posts)
+    .AsSplitQuery()
+    .ToList();
+```
+
+EF Core previously generated a split query for `Posts` that unnecessarily joined `BlogType`:
+
+```sql
+-- Before EF Core 11
+SELECT [p].[Id], [p].[BlogId], [p].[Title], [b].[Id], [b0].[Id]
+FROM [Blogs] AS [b]
+INNER JOIN [BlogType] AS [b0] ON [b].[BlogTypeId] = [b0].[Id]
+INNER JOIN [Post] AS [p] ON [b].[Id] = [p].[BlogId]
+ORDER BY [b].[Id], [b0].[Id]
+```
+
+In EF Core 11, the unneeded join is pruned:
+
+```sql
+-- EF Core 11
+SELECT [p].[Id], [p].[BlogId], [p].[Title], [b].[Id]
+FROM [Blogs] AS [b]
+INNER JOIN [Post] AS [p] ON [b].[Id] = [p].[BlogId]
+ORDER BY [b].[Id]
+```
+
+Second, EF no longer adds redundant keys from reference navigations to `ORDER BY` clauses. Because a reference navigation's key is functionally determined by the parent entity's key (via the foreign key), it does not need to appear separately. For example:
+
+```csharp
+var blogs = context.Blogs
+    .Include(b => b.Owner)
+    .Include(b => b.Posts)
+    .ToList();
+```
+
+EF Core previously included `[p].[PersonId]` in the `ORDER BY`, even though `[b].[BlogId]` already uniquely identifies the row:
+
+```sql
+-- Before EF Core 11
+ORDER BY [b].[BlogId], [p].[PersonId]
+```
+
+In EF Core 11, the redundant column is omitted:
+
+```sql
+-- EF Core 11
+ORDER BY [b].[BlogId]
+```
+
+Both optimizations can have a significant positive impact on query performance, especially when multiple reference navigations are included. A simple, common split query scenario showed a **29% improvement in querying performance**, as the database no longer has to perform the to-one join; single queries are also significantly improved by the removal of the ORDER BY, even if a bit less: one scenario showed a **22% improvement**.
+
+More details on the benchmark are available [here](https://github.com/dotnet/efcore/issues/29182#issuecomment-4231140289), and as always, actual performance in your application will vary based on your schema, data and a variety of other factors.
+
+<a name="linq-maxby-minby"></a>
+
+### MaxBy and MinBy
+
+EF Core now supports translating the LINQ `MaxByAsync` and `MinByAsync` methods (and their sync counterparts). These methods allow you to find the element with the maximum or minimum value for a given key selector, rather than just the maximum or minimum value itself.
+
+For example, to find the blog with the most posts:
+
+```csharp
+var blogWithMostPosts = await context.Blogs.MaxByAsync(b => b.Posts.Count());
+```
+
+This translates to the following SQL:
+
+```sql
+SELECT TOP(1) [b].[Id], [b].[Name]
+FROM [Blogs] AS [b]
+ORDER BY (
+    SELECT COUNT(*)
+    FROM [Posts] AS [p]
+    WHERE [b].[Id] = [p].[BlogId]) DESC
+```
+
+Similarly, `MinByAsync` orders ascending and returns the element with the minimum value for the key selector.
+
+### EF.Functions.JsonPathExists()
+
+EF Core 11 introduces `EF.Functions.JsonPathExists()`, which checks whether a given JSON path exists in a JSON document. On SQL Server, this translates to the [`JSON_PATH_EXISTS`](/sql/t-sql/functions/json-path-exists-transact-sql) function (available since SQL Server 2022).
+
+The following query filters blogs to those whose JSON data contains an `OptionalInt` property:
+
+```csharp
+var blogs = await context.Blogs
+    .Where(b => EF.Functions.JsonPathExists(b.JsonData, "$.OptionalInt"))
+    .ToListAsync();
+```
+
+This generates the following SQL:
+
+```sql
+SELECT [b].[Id], [b].[Name], [b].[JsonData]
+FROM [Blogs] AS [b]
+WHERE JSON_PATH_EXISTS([b].[JsonData], N'$.OptionalInt') = 1
+```
+
+`EF.Functions.JsonPathExists()` accepts a JSON value and a JSON path to check for. It can be used with scalar string properties, complex types, and owned entity types mapped to JSON columns.
+
+For the full `JSON_PATH_EXISTS` SQL Server documentation, see [`JSON_PATH_EXISTS`](/sql/t-sql/functions/json-path-exists-transact-sql).
+
+## SQL Server
+
+<a name="sqlserver-vector-search"></a>
+
+### VECTOR_SEARCH() and vector indexes
+
+> [!WARNING]
+> `VECTOR_SEARCH()` and vector indexes are currently experimental features in SQL Server and are subject to change. The APIs in EF Core for these features are also subject to change.
+
+In EF Core 10, we introduced translation for `EF.Functions.VectorDistance()`, which is a scalar function that computes the distance between two vectors. This function can be used in LINQ queries for vector similarity search, allowing you to find the most similar embeddings to a given embedding. However, `VectorDistance()` computes an _exact_ distance between the given vectors.
+
+When querying large datasets, SQL Server 2025 also supports performing _approximate_ search over a [vector index](/sql/t-sql/statements/create-vector-index-transact-sql), which provides much better performance at the expense of returning items that are approximately similar - rather than exactly similar - to the query. EF 11 now supports creating vector indexes through migrations:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Blog>()
+        .HasVectorIndex(b => b.Embedding, "cosine");
+}
+```
+
+Once you have a vector index, you can use the `VectorSearch()` extension method on your `DbSet` to perform an approximate search:
+
+```csharp
+var blogs = await context.Blogs
+    .VectorSearch(b => b.Embedding, embedding, "cosine", topN: 5)
+    .ToListAsync();
+```
+
+This translates to the SQL Server [`VECTOR_SEARCH()`](/sql/t-sql/functions/vector-search-transact-sql) table-valued function, which performs an approximate search over the vector index. The `topN` parameter specifies the number of results to return.
+
+`VectorSearch()` returns `VectorSearchResult<TEntity>`, allowing you to access the distance alongside the entity.
+
+For more information, see the [full documentation on vector search](xref:core/providers/sql-server/vector-search).
+
+<a name="sqlserver-vector-not-auto-loaded"></a>
+
+### Vector properties not loaded by default
+
+EF Core 11 changes how vector properties are loaded: `SqlVector<T>` columns are no longer included in `SELECT` statements when materializing entities. Since vectors can be quite large—containing hundreds or thousands of floating-point numbers—this avoids unnecessary data transfer in the common case where vectors are ingested and used for search but not read back.
+
+```csharp
+// Vector column is excluded from the projected entity
+var blogs = await context.Blogs.OrderBy(b => b.Name).ToListAsync();
+// Generates: SELECT [b].[Id], [b].[Name] FROM [Blogs] AS [b] ...
+
+// Explicit projection still loads the vector
+var embeddings = await context.Blogs
+    .Select(b => new { b.Id, b.Embedding })
+    .ToListAsync();
+```
+
+Vector properties can still be used in `WHERE` and `ORDER BY` clauses—including with `VectorDistance()` and `VectorSearch()`—and EF will correctly include them in the SQL, just not in the entity projection.
+
+This optimization can have a dramatic impact on application speed: a minimal benchmark showed an almost 9x (that's nine-fold) increase in performance, and that's while running against a local database. The optimization is even more impactful as latency to the database grows: when executing against a remote Azure SQL database, an improvement of around 22x was observed. More details on the benchmark are available [here](https://github.com/dotnet/efcore/issues/37279#issuecomment-4232243062), and as always, actual performance in your application will vary based on your entity, vector properties and latency.
+
+<a name="sqlserver-full-text"></a>
+
+### Full-text search improvements
+
+#### Full-text search catalog and index creation
+
+SQL Server's [full-text search](/sql/relational-databases/search/full-text-search) requires a full-text catalog and index to be set up on your database before you can use it. EF 11 now allows configuring full-text catalogs and indexes in your model, so that [EF migrations](xref:core/managing-schemas/migrations/index) can automatically create and manage them for you:
+
+```csharp
+// In your OnModelCreating:
+modelBuilder.HasFullTextCatalog("ftCatalog");
+
+modelBuilder.Entity<Blog>()
+    .HasFullTextIndex(b => b.FullName)
+    .HasKeyIndex("PK_Blogs")
+    .OnCatalog("ftCatalog");
+```
+
+This generates the following SQL in a migration:
+
+```sql
+CREATE FULLTEXT CATALOG [ftCatalog];
+CREATE FULLTEXT INDEX ON [Blogs]([FullName]) KEY INDEX [PK_Blogs] ON [ftCatalog];
+```
+
+Previously, full-text catalog and index creation had to be managed manually by adding SQL to migrations. For full details on setting up full-text catalogs and indexes, see the [full-text search documentation](xref:core/providers/sql-server/full-text-search#setting-up-full-text-search).
+
+<a name="sqlserver-full-text-tvf"></a>
+
+#### Full-text search table-valued functions
+
+EF Core has long provided support for SQL Server's full-text search predicates `FREETEXT()` and `CONTAINS()`, via `EF.Functions.FreeText()` and `EF.Functions.Contains()`. These predicates can be used in LINQ `Where()` clauses to filter results based on search criteria.
+
+However, SQL Server also has table-valued function versions of these functions, [`FREETEXTTABLE()`](/sql/relational-databases/system-functions/freetexttable-transact-sql) and [`CONTAINSTABLE()`](/sql/relational-databases/system-functions/containstable-transact-sql), which also return a ranking score along with the results, providing additional flexibility over the predicate versions. EF 11 now supports these table-valued functions:
+
+```csharp
+// Using FreeTextTable with a search query
+var results = await context.Blogs
+    .FreeTextTable(b => b.FullName, "John")
+    .Select(r => new { Blog = r.Value, Rank = r.Rank })
+    .OrderByDescending(r => r.Rank)
+    .ToListAsync();
+
+// Using ContainsTable with a search query
+var results = await context.Blogs
+    .ContainsTable(b => b.FullName, "John")
+    .Select(r => new { Blog = r.Value, Rank = r.Rank })
+    .OrderByDescending(r => r.Rank)
+    .ToListAsync();
+```
+
+Both methods return `FullTextSearchResult<TEntity>`, giving you access to both the entity and the ranking value from SQL Server's full-text engine. This allows for more sophisticated result ordering and filtering based on relevance scores.
+
+For more information, see the [full documentation on full-text search](xref:core/providers/sql-server/full-text-search).
+
+<a name="sql-server-json-contains"></a>
+
+### Contains operations using JSON_CONTAINS
+
+SQL Server 2025 introduced the [`JSON_CONTAINS`](/sql/t-sql/functions/json-contains-transact-sql) function, which checks whether a value exists in a JSON document. Starting with EF Core 11, when targeting SQL Server 2025, LINQ `Contains` queries over primitive (or scalar) collections stored as JSON are translated to use this function, replacing the previous, less efficient `OPENJSON`-based translation.
+
+The following query checks whether a blog's `Tags` collection contains a specific tag:
+
+```csharp
+var blogs = await context.Blogs
+    .Where(b => b.Tags.Contains("ef-core"))
+    .ToListAsync();
+```
+
+Before EF 11 - or when targeting older SQL Server versions - this generates the following SQL:
+
+```sql
+SELECT [b].[Id], [b].[Name], [b].[Tags]
+FROM [Blogs] AS [b]
+WHERE N'ef-core' IN (
+    SELECT [t].[value]
+    FROM OPENJSON([b].[Tags]) WITH ([value] nvarchar(max) '$') AS [t]
+)
+```
+
+With EF 11, configure EF to target SQL Server 2025 by setting the compatibility level as follows:
+
+```csharp
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    => optionsBuilder
+        .UseSqlServer("<CONNECTION STRING>", o => o.UseCompatibilityLevel(170));
+```
+
+At that point, EF will instead generate the following SQL:
+
+```sql
+SELECT [b].[Id], [b].[Name], [b].[Tags]
+FROM [Blogs] AS [b]
+WHERE JSON_CONTAINS([b].[Tags], 'ef-core') = 1
+```
+
+`JSON_CONTAINS()` can notably make use of a [JSON index](/sql/t-sql/statements/create-json-index-transact-sql), if one is defined.
+
+> [!NOTE]
+> `JSON_CONTAINS` does not support searching for null values. As a result, this translation is only applied when EF can determine that at least one side is non-nullable — either the item being searched for (e.g. a non-null constant or a non-nullable column), or the collection's elements. When this cannot be determined, EF falls back to the previous `OPENJSON`-based translation.
+
+#### EF.Functions.JsonContains()
+
+In the section above, EF Core automatically translates LINQ `Contains` queries over primitive collections to use the SQL Server `JSON_CONTAINS` function. In some cases, however, you may want to directly invoke `JSON_CONTAINS` yourself, for example to search for a value at a specific path, or to specify a search mode. For these cases, EF Core 11 introduces `EF.Functions.JsonContains()`.
+
+The following query checks whether a blog's JSON data contains a specific value at a given path:
+
+```csharp
+var blogs = await context.Blogs
+    .Where(b => EF.Functions.JsonContains(b.JsonData, 8, "$.Rating") == 1)
+    .ToListAsync();
+```
+
+This generates the following SQL:
+
+```sql
+SELECT [b].[Id], [b].[Name], [b].[JsonData]
+FROM [Blogs] AS [b]
+WHERE JSON_CONTAINS([b].[JsonData], 8, N'$.Rating') = 1
+```
+
+`EF.Functions.JsonContains()` accepts the JSON value to search in, the value to search for, and optionally a JSON path and a search mode. It can be used with scalar string properties, complex types, and owned entity types mapped to JSON columns.
+
+For the full `JSON_CONTAINS` SQL Server documentation, see [`JSON_CONTAINS`](/sql/t-sql/functions/json-contains-transact-sql).
+
+<a name="sqlserver-datetimeoffset-translations"></a>
+
+### Additional DateTimeOffset and date/time translations
+
+EF Core 11 adds several new SQL Server translations for `DateTimeOffset`. Properties such as `DateTime`, `UtcDateTime`, and `LocalDateTime` are now translated, allowing you to extract a `DateTime` from a `DateTimeOffset` in different time zones directly in your queries. `Offset.TotalMinutes` is also translated, giving access to the offset component, and `ToOffset()` allows converting a `DateTimeOffset` to a different offset via SQL Server's `SWITCHOFFSET`.
+
+You can also now construct a `DateTimeOffset` from a `DateTime` directly in LINQ queries, using `new DateTimeOffset(dateTime)` or `new DateTimeOffset(dateTime, offset)`, which translates to SQL Server's `TODATETIMEOFFSET` function.
+
+In addition, `EF.Functions.DateTrunc()` is now available for truncating `DateTime`, `DateTimeOffset`, `DateOnly` and `TimeOnly` values to a specified precision (e.g. day, hour, minute), translating to SQL Server's [`DATETRUNC`](/sql/t-sql/functions/datetrunc-transact-sql) function.
+
+For the complete list of date/time function translations, see the [SQL Server function mappings page](xref:core/providers/sql-server/functions).
+
+## Cosmos DB
+
+<a name="cosmos-complex-types"></a>
+
+### Complex types
+
+EF Core [complex types](xref:core/what-is-new/ef-core-10.0/whatsnew#complex-types) are now fully supported in the Azure Cosmos DB provider; they are embedded as nested JSON objects (or arrays, for collections) within the owning document, with support for queries, inserts, and updates.
+
+For example, the following configures `ShippingAddress` as a complex type:
+
+#### [Fluent API](#tab/fluent-api)
+
+```csharp
+modelBuilder.Entity<Order>()
+    .ComplexProperty(o => o.ShippingAddress);
+```
+
+#### [Data Annotations](#tab/data-annotations)
+
+```csharp
+[ComplexType]
+public class ShippingAddress
+{
+    public required string Street { get; set; }
+    public required string City { get; set; }
+}
+```
+
+***
+
+Complex types are generally a better fit than owned types when mapping to JSON documents: unlike owned types, complex types have value semantics and no identity, which means they work better in scenarios such as comparing two embedded objects within the same document.
+
+This feature was contributed by [@JoasE](https://github.com/JoasE) - many thanks!
+
+<a name="cosmos-transactional-batches"></a>
+
+### Transactional batches
+
+Azure Cosmos DB supports [transactional batches](/azure/cosmos-db/transactional-batch), which allow multiple operations to be executed atomically and in a single roundtrip against a single partition. Starting with EF Core 11, the provider leverages transactional batches by default, providing best-effort atomicity and improved performance when saving changes.
+
+The batching behavior can be controlled via the <xref:Microsoft.EntityFrameworkCore.AutoTransactionBehavior> property:
+
+* **Auto** (default): Operations are grouped into transactional batches by container and partition. Batches are executed sequentially; if a batch fails, subsequent batches are not executed.
+* **Never**: All operations are performed individually and sequentially (the pre-11 behavior).
+* **Always**: Requires all operations to fit in a single transactional batch; throws if they cannot.
+
+For more information, [see the documentation](xref:core/providers/cosmos/saving#transactionality-and-transactional-batches).
+
+This feature was contributed by [@JoasE](https://github.com/JoasE) - many thanks!
+
+<a name="cosmos-bulk-execution"></a>
+
+### Bulk execution
+
+Azure Cosmos DB supports _bulk execution_, which allows multiple document operations to be executed in parallel and across DbContext instances, significantly improving throughput when saving many entities at once. EF Core now supports enabling bulk execution:
+
+```csharp
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    => optionsBuilder.UseCosmos(
+        "<connection string>",
+        databaseName: "OrdersDB",
+        options => options.BulkExecutionEnabled());
+```
+
+For more information, [see the documentation](xref:core/providers/cosmos/saving#bulk-execution).
+
+This feature was contributed by [@JoasE](https://github.com/JoasE) - many thanks!
+
+<a name="cosmos-session-tokens"></a>
+
+### Session token management
+
+Azure Cosmos DB uses session tokens to track read-your-writes consistency within a session. When running in an environment with multiple instances (e.g., with round-robin load balancing), you may need to manually manage session tokens to ensure consistency across requests.
+
+EF Core now provides APIs to retrieve and set session tokens on a `DbContext`. To enable manual session token management, configure the `SessionTokenManagementMode()`:
+
+```csharp
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    => optionsBuilder.UseCosmos(
+        "<connection string>",
+        databaseName: "OrdersDB",
+        options => options.SessionTokenManagementMode(SessionTokenManagementMode.SemiAutomatic));
+```
+
+You can then retrieve and use session tokens:
+
+```csharp
+// After performing operations, retrieve the session token
+var sessionToken = context.Database.GetSessionToken();
+
+// Later, in a different context instance, apply the session token before reading
+context.Database.UseSessionToken(sessionToken);
+var result = await context.Documents.FindAsync(id);
+```
+
+For more information, [see the documentation](xref:core/providers/cosmos/saving#session-token-management).
+
+This feature was contributed by [@JoasE](https://github.com/JoasE) - many thanks!
+
+## Migrations
+
+<a name="migrations-exclude-fk"></a>
+
+### Excluding foreign key constraints from migrations
+
+It is now possible to configure a foreign key relationship in the EF model while preventing the corresponding database constraint from being created by migrations. This is useful for legacy databases without existing constraints, or in data synchronization scenarios where referential integrity constraints might conflict with the synchronization order:
+
+```csharp
+modelBuilder.Entity<Blog>()
+    .HasMany(e => e.Posts)
+    .WithOne(e => e.Blog)
+    .HasForeignKey(e => e.BlogId)
+    .ExcludeForeignKeyFromMigrations();
+```
+
+The relationship is fully supported in EF for queries, change tracking, etc. Only the foreign key constraint in the database is suppressed; a database index is still created on the foreign key column.
+
+For more information, see [Excluding foreign key constraints from migrations](xref:core/modeling/relationships/foreign-and-principal-keys#excluding-foreign-key-constraints-from-migrations).
+
+<a name="migrations-snapshot-latest-id"></a>
+
+### Latest migration ID recorded in model snapshot
+
+When working in team environments, it's common for multiple developers to create migrations on separate branches. When these branches are merged, the migration trees can diverge, leading to issues that are sometimes difficult to detect.
+
+Starting with EF Core 11, the model snapshot now records the ID of the latest migration. When two developers create migrations on divergent branches, both branches will modify this value in the model snapshot, causing a source control merge conflict. This conflict alerts the team that they need to resolve the divergence - typically by discarding one of the migration trees and creating a new, unified migration.
+
+For more information on managing migrations in team environments, see [Migrations in Team Environments](xref:core/managing-schemas/migrations/teams).
+
+<a name="migrations-add-and-apply"></a>
+
+### Create and apply migrations in one step
+
+The `dotnet ef database update` command now supports creating and applying a migration in a single step using the new `--add` option. This uses Roslyn to compile the migration at runtime, enabling scenarios like .NET Aspire and containerized applications where recompilation isn't possible:
+
+```dotnetcli
+dotnet ef database update InitialCreate --add
+```
+
+This command scaffolds a new migration named `InitialCreate`, compiles it using Roslyn, and immediately applies it to the database. The migration files are still saved to disk for source control and future recompilation. The same options available for `dotnet ef migrations add` can be used:
+
+```dotnetcli
+dotnet ef database update AddProducts --add --output-dir Migrations/Products --namespace MyApp.Migrations
+```
+
+In PowerShell, use the `-Add` parameter:
+
+```powershell
+Update-Database -Migration InitialCreate -Add
+```
+
+<a name="migrations-remove-connection-offline"></a>
+
+### Connection and offline options for migrations remove
+
+The `dotnet ef migrations remove` and `database drop` commands now accept `--connection` parameters, allowing you to specify the database connection string directly without needing to configure a default connection in your `DbContext`. Additionally, `migrations remove` supports the new `--offline` option to remove a migration without connecting to the database:
+
+```console
+# Remove migration with specific connection
+dotnet ef migrations remove --connection "Server=prod;Database=MyDb;..."
+
+# Remove migration without connecting to database (offline mode)
+dotnet ef migrations remove --offline
+
+# Revert and remove applied migration
+dotnet ef migrations remove --force
+
+# Drop specific database by connection string
+dotnet ef database drop --connection "Server=test;Database=MyDb;..." --force
+```
+
+The `--offline` option skips the database connection check entirely, which is useful when the database is inaccessible or when you're certain the migration hasn't been applied. Note that `--offline` and `--force` cannot be used together, since `--force` requires a database connection to check if the migration has been applied before reverting it.
+
+In PowerShell, use the `-Connection` and `-Offline` parameters:
+
+```powershell
+Remove-Migration -Connection "Server=prod;Database=MyDb;..."
+Remove-Migration -Offline
+Drop-Database -Connection "Server=test;Database=MyDb;..." -Force
+```
+
+## Other improvements
+
+* The EF command-line tool now writes all logging and status messages to standard error, reserving standard output only for the command's actual expected output. For example, when generating a migration SQL script with `dotnet ef migrations script`, only the SQL is written to standard output.
diff --git a/entity-framework/core/what-is-new/ef-core-2.0/index.md b/entity-framework/core/what-is-new/ef-core-2.0/index.md
new file mode 100644
index 0000000000..38f9e7f664
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-2.0/index.md
@@ -0,0 +1,318 @@
+---
+title: What is new in EF Core 2.0 - EF Core
+description: Changes and improvements in Entity Framework Core 2.0
+author: SamMonoRT
+ms.date: 02/20/2018
+uid: core/what-is-new/ef-core-2.0
+ms.custom: sfi-ropc-nochange
+---
+
+# New features in EF Core 2.0
+
+## .NET Standard 2.0
+
+EF Core now targets .NET Standard 2.0, which means it can work with .NET Core 2.0, .NET Framework 4.6.1, and other libraries that implement .NET Standard 2.0.
+See [Supported .NET Implementations](xref:core/miscellaneous/platforms) for more details on what is supported.
+
+## Modeling
+
+### Table splitting
+
+It is now possible to map two or more entity types to the same table where the primary key column(s) will be shared and each row will correspond to two or more entities.
+
+To use table splitting an identifying relationship (where foreign key properties form the primary key) must be configured between all of the entity types sharing the table:
+
+```csharp
+modelBuilder.Entity<Product>()
+    .HasOne(e => e.Details).WithOne(e => e.Product)
+    .HasForeignKey<ProductDetails>(e => e.Id);
+modelBuilder.Entity<Product>().ToTable("Products");
+modelBuilder.Entity<ProductDetails>().ToTable("Products");
+```
+
+Read the [section on table splitting](xref:core/modeling/table-splitting) for more information on this feature.
+
+### Owned types
+
+An owned entity type can share the same .NET type with another owned entity type, but since it cannot be identified just by the .NET type there must be a navigation to it from another entity type. The entity containing the defining navigation is the owner. When querying the owner the owned types will be included by default.
+
+By convention a shadow primary key will be created for the owned type and it will be mapped to the same table as the owner by using table splitting. This allows to use owned types similarly to how complex types are used in EF6:
+
+```csharp
+modelBuilder.Entity<Order>().OwnsOne(p => p.OrderDetails, cb =>
+    {
+        cb.OwnsOne(c => c.BillingAddress);
+        cb.OwnsOne(c => c.ShippingAddress);
+    });
+
+public class Order
+{
+    public int Id { get; set; }
+    public OrderDetails OrderDetails { get; set; }
+}
+
+public class OrderDetails
+{
+    public StreetAddress BillingAddress { get; set; }
+    public StreetAddress ShippingAddress { get; set; }
+}
+
+public class StreetAddress
+{
+    public string Street { get; set; }
+    public string City { get; set; }
+}
+```
+
+Read the [section on owned entity types](xref:core/modeling/owned-entities) for more information on this feature.
+
+### Model-level query filters
+
+EF Core 2.0 includes a new feature we call Model-level query filters. This feature allows LINQ query predicates (a boolean expression typically passed to the LINQ Where query operator) to be defined directly on Entity Types in the metadata model (usually in OnModelCreating). Such filters are automatically applied to any LINQ queries involving those Entity Types, including Entity Types referenced indirectly, such as through the use of Include or direct navigation property references. Some common applications of this feature are:
+
+- Soft delete - An Entity Types defines an IsDeleted property.
+- Multi-tenancy - An Entity Type defines a TenantId property.
+
+Here is a simple example demonstrating the feature for the two scenarios listed above:
+
+```csharp
+public class BloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    public int TenantId { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>().HasQueryFilter(
+            p => !p.IsDeleted
+            && p.TenantId == this.TenantId);
+    }
+}
+```
+
+We define a model-level filter that implements multi-tenancy and soft-delete for instances of the `Post` Entity Type. Note the use of a `DbContext` instance-level property: `TenantId`. Model-level filters will use the value from the correct context instance (that is, the context instance that is executing the query).
+
+Filters may be disabled for individual LINQ queries using the IgnoreQueryFilters() operator.
+
+#### Limitations
+
+- Navigation references are not allowed. This feature may be added based on feedback.
+- Filters can only be defined on the root Entity Type of a hierarchy.
+
+### Database scalar function mapping
+
+EF Core 2.0 includes an important contribution from [Paul Middleton](https://github.com/pmiddleton) which enables mapping database scalar functions to method stubs so that they can be used in LINQ queries and translated to SQL.
+
+Here is a brief description of how the feature can be used:
+
+Declare a static method on your `DbContext` and annotate it with `DbFunctionAttribute`:
+
+```csharp
+public class BloggingContext : DbContext
+{
+    [DbFunction]
+    public static int PostReadCount(int blogId)
+    {
+        throw new NotImplementedException();
+    }
+}
+```
+
+Methods like this are automatically registered. Once registered, calls to the method in a LINQ query can be translated to function calls in SQL:
+
+```csharp
+var query =
+    from p in context.Posts
+    where BloggingContext.PostReadCount(p.Id) > 5
+    select p;
+```
+
+A few things to note:
+
+- By convention the name of the method is used as the name of a function (in this case a user-defined function) when generating the SQL, but you can override the name and schema during method registration.
+- Currently only scalar functions are supported.
+- You must create the mapped function in the database. EF Core migrations will not take care of creating it.
+
+### Self-contained type configuration for code first
+
+In EF6 it was possible to encapsulate the code first configuration of a specific entity type by deriving from *EntityTypeConfiguration*. In EF Core 2.0 we are bringing this pattern back:
+
+```csharp
+class CustomerConfiguration : IEntityTypeConfiguration<Customer>
+{
+    public void Configure(EntityTypeBuilder<Customer> builder)
+    {
+        builder.HasKey(c => c.AlternateKey);
+        builder.Property(c => c.Name).HasMaxLength(200);
+    }
+}
+
+...
+// OnModelCreating
+builder.ApplyConfiguration(new CustomerConfiguration());
+```
+
+## High Performance
+
+### DbContext pooling
+
+The basic pattern for using EF Core in an ASP.NET Core application usually involves registering a custom DbContext type into the dependency injection system and later obtaining instances of that type through constructor parameters in controllers. This means a new instance of the DbContext is created for each request.
+
+In version 2.0 we are introducing a new way to register custom DbContext types in dependency injection which transparently introduces a pool of reusable DbContext instances. To use DbContext pooling, use the `AddDbContextPool` instead of `AddDbContext` during service registration:
+
+```csharp
+services.AddDbContextPool<BloggingContext>(
+    options => options.UseSqlServer(connectionString));
+```
+
+If this method is used, at the time a DbContext instance is requested by a controller we will first check if there is an instance available in the pool. Once the request processing finalizes, any state on the instance is reset and the instance is itself returned to the pool.
+
+This is conceptually similar to how connection pooling operates in ADO.NET providers and has the advantage of saving some of the cost of initialization of DbContext instance.
+
+### Limitations
+
+The new method introduces a few limitations on what can be done in the `OnConfiguring()` method of the DbContext.
+
+> [!WARNING]
+> Avoid using DbContext Pooling if you maintain your own state (for example, private fields) in your derived DbContext class that should not be shared across requests. EF Core will only reset the state that it is aware of before adding a DbContext instance to the pool.
+
+### Explicitly compiled queries
+
+This is the second opt-in performance feature designed to offer benefits in high-scale scenarios.
+
+Manual or explicitly compiled query APIs have been available in previous versions of EF and also in LINQ to SQL to allow applications to cache the translation of queries so that they can be computed only once and executed many times.
+
+Although in general EF Core can automatically compile and cache queries based on a hashed representation of the query expressions, this mechanism can be used to obtain a small performance gain by bypassing the computation of the hash and the cache lookup, allowing the application to use an already compiled query through the invocation of a delegate.
+
+```csharp
+// Create an explicitly compiled query
+private static Func<CustomerContext, int, Customer> _customerById =
+    EF.CompileQuery((CustomerContext db, int id) =>
+        db.Customers
+            .Include(c => c.Address)
+            .Single(c => c.Id == id));
+
+// Use the compiled query by invoking it
+using (var db = new CustomerContext())
+{
+   var customer = _customerById(db, 147);
+}
+```
+
+## Change Tracking
+
+### Attach can track a graph of new and existing entities
+
+EF Core supports automatic generation of key values through a variety of mechanisms. When using this feature, a value is generated if the key property is the CLR default--usually zero or null. This means that a graph of entities can be passed to `DbContext.Attach` or `DbSet.Attach` and EF Core will mark those entities that have a key already set as `Unchanged` while those entities that do not have a key set will be marked as `Added`. This makes it easy to attach a graph of mixed new and existing entities when using generated keys. `DbContext.Update` and `DbSet.Update` work in the same way, except that entities with a key set are marked as `Modified` instead of `Unchanged`.
+
+## Query
+
+### Improved LINQ translation
+
+Enables more queries to successfully execute, with more logic being evaluated in the database (rather than in-memory) and less data unnecessarily being retrieved from the database.
+
+### GroupJoin improvements
+
+This work improves the SQL that is generated for group joins. Group joins are most often a result of sub-queries on optional navigation properties.
+
+### String interpolation in FromSql and ExecuteSqlCommand
+
+C# 6 introduced String Interpolation, a feature that allows C# expressions to be directly embedded in string literals, providing a nice way of building strings at runtime. In EF Core 2.0 we added special support for interpolated strings to our two primary APIs that accept raw SQL strings: `FromSql` and `ExecuteSqlCommand`. This new support allows C# string interpolation to be used in a "safe" manner. That is, in a way that protects against common SQL injection mistakes that can occur when dynamically constructing SQL at runtime.
+
+Here is an example:
+
+```csharp
+var city = "London";
+var contactTitle = "Sales Representative";
+
+using (var context = CreateContext())
+{
+    context.Set<Customer>()
+        .FromSql($@"
+            SELECT *
+            FROM ""Customers""
+            WHERE ""City"" = {city} AND
+                ""ContactTitle"" = {contactTitle}")
+            .ToArray();
+  }
+```
+
+In this example, there are two variables embedded in the SQL format string. EF Core will produce the following SQL:
+
+```sql
+@p0='London' (Size = 4000)
+@p1='Sales Representative' (Size = 4000)
+
+SELECT *
+FROM ""Customers""
+WHERE ""City"" = @p0
+    AND ""ContactTitle"" = @p1
+```
+
+### EF.Functions.Like()
+
+We have added the EF.Functions property which can be used by EF Core or providers to define methods that map to database functions or operators so that those can be invoked in LINQ queries. The first example of such a method is Like():
+
+```csharp
+var aCustomers =
+    from c in context.Customers
+    where EF.Functions.Like(c.Name, "a%")
+    select c;
+```
+
+Note that Like() comes with an in-memory implementation, which can be handy when working against an in-memory database or when evaluation of the predicate needs to occur on the client side.
+
+## Database management
+
+### Pluralization hook for DbContext scaffolding
+
+EF Core 2.0 introduces a new *IPluralizer* service that is used to singularize entity type names and pluralize DbSet names. The default implementation is a no-op, so this is just a hook where folks can easily plug in their own pluralizer.
+
+Here is what it looks like for a developer to hook in their own pluralizer:
+
+```csharp
+public class MyDesignTimeServices : IDesignTimeServices
+{
+    public void ConfigureDesignTimeServices(IServiceCollection services)
+    {
+        services.AddSingleton<IPluralizer, MyPluralizer>();
+    }
+}
+
+public class MyPluralizer : IPluralizer
+{
+    public string Pluralize(string name)
+    {
+        return Inflector.Inflector.Pluralize(name) ?? name;
+    }
+
+    public string Singularize(string name)
+    {
+        return Inflector.Inflector.Singularize(name) ?? name;
+    }
+}
+```
+
+## Others
+
+### Move ADO.NET SQLite provider to SQLitePCL.raw
+
+This gives us a more robust solution in Microsoft.Data.Sqlite for distributing native SQLite binaries on different platforms.
+
+### Only one provider per model
+
+Significantly augments how providers can interact with the model and simplifies how conventions, annotations and fluent APIs work with different providers.
+
+EF Core 2.0 will now build a different [IModel](https://github.com/aspnet/EntityFramework/blob/master/src/EFCore/Metadata/IModel.cs) for each different provider being used. This is usually transparent to the application. This has facilitated a simplification of lower-level metadata APIs such that any access to *common relational metadata concepts* is always made through a call to `.Relational` instead of `.SqlServer`, `.Sqlite`, etc.
+
+### Consolidated logging and diagnostics
+
+Logging (based on ILogger) and Diagnostics (based on DiagnosticSource) mechanisms now share more code.
+
+The event IDs for messages sent to an ILogger have changed in 2.0. The event IDs are now unique across EF Core code. These messages now also follow the standard pattern for structured logging used by, for example, MVC.
+
+Logger categories have also changed. There is now a well-known set of categories accessed through [DbLoggerCategory](https://github.com/aspnet/EntityFramework/blob/master/src/EFCore/DbLoggerCategory.cs).
+
+DiagnosticSource events now use the same event ID names as the corresponding `ILogger` messages.
diff --git a/entity-framework/core/what-is-new/ef-core-2.0/upgrade.md b/entity-framework/core/what-is-new/ef-core-2.0/upgrade.md
new file mode 100644
index 0000000000..b92d9f2f61
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-2.0/upgrade.md
@@ -0,0 +1,194 @@
+---
+title: Upgrading from previous versions to EF Core 2 - EF Core
+description: Instructions and notes for upgrading to Entity Framework Core 2.0
+author: SamMonoRT
+ms.date: 10/25/2021
+uid: core/what-is-new/ef-core-2.0/upgrade
+---
+
+# Upgrading applications from previous versions to EF Core 2.0
+
+We have taken the opportunity to significantly refine our existing APIs and behaviors in 2.0. There are a few improvements that can require modifying existing application code, although we believe that for the majority of applications the impact will be low, in most cases requiring just recompilation and minimal guided changes to replace obsolete APIs.
+
+Updating an existing application to EF Core 2.0 may require:
+
+1. Upgrading the target .NET implementation of the application to one that supports .NET Standard 2.0. See [Supported .NET Implementations](xref:core/miscellaneous/platforms) for more details.
+
+2. Identify a provider for the target database which is compatible with EF Core 2.0. See [EF Core 2.0 requires a 2.0 database provider](#ef-core-20-requires-a-20-database-provider) below.
+
+3. Upgrading all the EF Core packages (runtime and tooling) to 2.0. Refer to [Installing EF Core](xref:core/get-started/overview/install) for more details.
+
+4. Make any necessary code changes to compensate for the breaking changes described in the rest of this document.
+
+## ASP.NET Core now includes EF Core
+
+Applications targeting ASP.NET Core 2.0 can use EF Core 2.0 without additional dependencies besides third party database providers. However, applications targeting previous versions of ASP.NET Core need to upgrade to ASP.NET Core 2.0 in order to use EF Core 2.0. For more details on upgrading ASP.NET Core applications to 2.0 see [the ASP.NET Core documentation on the subject](/aspnet/core/migration/1x-to-2x/).
+
+## New way of getting application services in ASP.NET Core
+
+The recommended pattern for ASP.NET Core web applications has been updated for 2.0 in a way that broke the design-time logic EF Core used in 1.x. Previously at design-time, EF Core would try to invoke `Startup.ConfigureServices` directly in order to access the application's service provider. In ASP.NET Core 2.0, Configuration is initialized outside of the `Startup` class. Applications using EF Core typically access their connection string from Configuration, so `Startup` by itself is no longer sufficient. If you upgrade an ASP.NET Core 1.x application, you may receive the following error when using the EF Core tools.
+
+> No parameterless constructor was found on 'ApplicationContext'. Either add a parameterless constructor to 'ApplicationContext' or add an implementation of 'IDesignTimeDbContextFactory&lt;ApplicationContext&gt;' in the same assembly as 'ApplicationContext'
+
+A new design-time hook has been added in ASP.NET Core 2.0's default template. The static `Program.BuildWebHost` method enables EF Core to access the application's service provider at design time. If you are upgrading an ASP.NET Core 1.x application, you will need to update the `Program` class to resemble the following.
+
+```csharp
+using Microsoft.AspNetCore;
+using Microsoft.AspNetCore.Hosting;
+
+namespace AspNetCoreDotNetCore2._0App
+{
+    public class Program
+    {
+        public static void Main(string[] args)
+        {
+            BuildWebHost(args).Run();
+        }
+
+        public static IWebHost BuildWebHost(string[] args) =>
+            WebHost.CreateDefaultBuilder(args)
+                .UseStartup<Startup>()
+                .Build();
+    }
+}
+```
+
+The adoption of this new pattern when updating applications to 2.0 is highly recommended and is required in order for product features like Entity Framework Core Migrations to work. The other common alternative is to [implement *IDesignTimeDbContextFactory\<TContext>*](xref:core/cli/dbcontext-creation#from-a-design-time-factory).
+
+## IDbContextFactory renamed
+
+In order to support diverse application patterns and give users more control over how their `DbContext` is used at design time, we have, in the past, provided the `IDbContextFactory<TContext>` interface. At design-time, the EF Core tools will discover implementations of this interface in your project and use it to create `DbContext` objects.
+
+This interface had a very general name which mislead some users to try re-using it for other `DbContext`-creating scenarios. They were caught off guard when the EF Tools then tried to use their implementation at design-time and caused commands like `Update-Database` or `dotnet ef database update` to fail.
+
+In order to communicate the strong design-time semantics of this interface, we have renamed it to `IDesignTimeDbContextFactory<TContext>`.
+
+For the 2.0 release the `IDbContextFactory<TContext>` still exists but is marked as obsolete.
+
+## DbContextFactoryOptions removed
+
+Because of the ASP.NET Core 2.0 changes described above, we found that `DbContextFactoryOptions` was no longer needed on the new `IDesignTimeDbContextFactory<TContext>` interface. Here are the alternatives you should be using instead.
+
+| DbContextFactoryOptions | Alternative                                                  |
+|:------------------------|:-------------------------------------------------------------|
+| ApplicationBasePath     | AppContext.BaseDirectory                                     |
+| ContentRootPath         | Directory.GetCurrentDirectory()                              |
+| EnvironmentName         | Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT") |
+
+## Design-time working directory changed
+
+The ASP.NET Core 2.0 changes also required the working directory used by `dotnet ef` to align with the working directory used by Visual Studio when running your application. One observable side effect of this is that SQLite filenames are now relative to the project directory and not the output directory like they used to be.
+
+## EF Core 2.0 requires a 2.0 database provider
+
+For EF Core 2.0 we have made many simplifications and improvements in the way database providers work. This means that 1.0.x and 1.1.x providers will not work with EF Core 2.0.
+
+The SQL Server and SQLite providers are shipped by the EF team and 2.0 versions will be available as part of the 2.0 release. The open-source third party providers for [SQL Compact](https://github.com/ErikEJ/EntityFramework.SqlServerCompact), [PostgreSQL](https://github.com/npgsql/Npgsql.EntityFrameworkCore.PostgreSQL), and [MySQL](https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql) are being updated for 2.0. For all other providers, please contact the provider writer.
+
+## Logging and Diagnostics events have changed
+
+Note: these changes should not impact most application code.
+
+The event IDs for messages sent to an [ILogger](/dotnet/api/microsoft.extensions.logging.ilogger) have changed in 2.0. The event IDs are now unique across EF Core code. These messages now also follow the standard pattern for structured logging used by, for example, MVC.
+
+Logger categories have also changed. There is now a well-known set of categories accessed through <xref:Microsoft.EntityFrameworkCore.DbLoggerCategory>.
+
+`DiagnosticSource` events now use the same event ID names as the corresponding `ILogger` messages. The event payloads are all nominal types derived from [EventData](/dotnet/api/microsoft.entityframeworkcore.diagnostics.eventdata).
+
+Event IDs, payload types, and categories are documented in the [CoreEventId](/dotnet/api/microsoft.entityframeworkcore.diagnostics.coreeventid) and the [RelationalEventId](/dotnet/api/microsoft.entityframeworkcore.diagnostics.relationaleventid) classes.
+
+IDs have also moved from Microsoft.EntityFrameworkCore.Infrastructure to the new Microsoft.EntityFrameworkCore.Diagnostics namespace.
+
+## EF Core relational metadata API changes
+
+EF Core 2.0 will now build a different [IModel](/dotnet/api/microsoft.entityframeworkcore.metadata.imodel) for each different provider being used. This is usually transparent to the application. This has facilitated a simplification of lower-level metadata APIs such that any access to *common relational metadata concepts* is always made through a call to `.Relational` instead of `.SqlServer`, `.Sqlite`, etc. For example, 1.1.x code like this:
+
+```csharp
+var tableName = context.Model.FindEntityType(typeof(User)).SqlServer().TableName;
+```
+
+Should now be written like this:
+
+```csharp
+var tableName = context.Model.FindEntityType(typeof(User)).Relational().TableName;
+```
+
+Instead of using methods like `ForSqlServerToTable`, extension methods are now available to write conditional code based on the current provider in use. For example:
+
+```csharp
+modelBuilder.Entity<User>().ToTable(
+    Database.IsSqlServer() ? "SqlServerName" : "OtherName");
+```
+
+Note that this change only applies to APIs/metadata that is defined for *all* relational providers. The API and metadata remains the same when it is specific to only a single provider. For example, clustered indexes are specific to SQL Sever, so `ForSqlServerIsClustered` and  `.SqlServer().IsClustered()` must still be used.
+
+## Don’t take control of the EF service provider
+
+EF Core uses an internal `IServiceProvider` (a dependency injection container) for its internal implementation. Applications should allow EF Core to create and manage this provider except in special cases. Strongly consider removing any calls to `UseInternalServiceProvider`. If an application does need to call `UseInternalServiceProvider`, then please consider [filing an issue](https://github.com/dotnet/efcore/issues) so we can investigate other ways to handle your scenario.
+
+Calling `AddEntityFramework`, `AddEntityFrameworkSqlServer`, etc. is not required by application code unless `UseInternalServiceProvider` is also called. Remove any existing calls to `AddEntityFramework` or `AddEntityFrameworkSqlServer`, etc. `AddDbContext` should still be used in the same way as before.
+
+## In-memory databases must be named
+
+The global unnamed in-memory database has been removed and instead all in-memory databases must be named. For example:
+
+```csharp
+optionsBuilder.UseInMemoryDatabase("MyDatabase");
+```
+
+This creates/uses a database with the name “MyDatabase”. If `UseInMemoryDatabase` is called again with the same name, then the same in-memory database will be used, allowing it to be shared by multiple context instances.
+
+## In-memory provider 'Include' operation no longer returns results if the included navigation is required but its value is null
+
+When trying to include a required navigation and the included navigation is null, the query no longer returns result for the entity on which the Include operation is applied. To avoid this problem, either provide a value for the required navigation or change the navigation to be optional.
+
+```csharp
+public class Person
+{
+    public int Id { get; set; }
+    public Language NativeLanguage { get; set;} // required navigation
+    public Person Sibling { get; set; } // optional navigation
+}
+...
+var person = new Person();
+context.People.Add(person);
+await context.SaveChangesAsync();
+...
+
+// returns one result
+await context.People.ToListAsync();
+
+// returns no results because 'NativeLanguage' navigation is required but has not been provided
+await context.People.Include(p => p.NativeLanguage).ToListAsync(); 
+
+// returns one result because 'Sibling' navigation is optional so it doesn't have to be provided
+await context.People.Include(p => p.Sibling).ToListAsync();
+```
+
+## Read-only API changes
+
+`IsReadOnlyBeforeSave`, `IsReadOnlyAfterSave`, and `IsStoreGeneratedAlways` have been obsoleted and replaced with [BeforeSaveBehavior](/dotnet/api/microsoft.entityframeworkcore.metadata.iproperty.beforesavebehavior) and [AfterSaveBehavior](/dotnet/api/microsoft.entityframeworkcore.metadata.iproperty.aftersavebehavior). These behaviors apply to any property (not only store-generated properties) and determine how the value of the property should be used when inserting into a database row (`BeforeSaveBehavior`) or when updating an existing database row (`AfterSaveBehavior`).
+
+Properties marked as [ValueGenerated.OnAddOrUpdate](/dotnet/api/microsoft.entityframeworkcore.metadata.valuegenerated) (for example, for computed columns) will by default ignore any value currently set on the property. This means that a store-generated value will always be obtained regardless of whether any value has been set or modified on the tracked entity. This can be changed by setting a different `Before\AfterSaveBehavior`.
+
+## New ClientSetNull delete behavior
+
+In previous releases, [DeleteBehavior.Restrict](/dotnet/api/microsoft.entityframeworkcore.deletebehavior) had a behavior for entities tracked by the context that more closed matched `SetNull` semantics. In EF Core 2.0, a new `ClientSetNull` behavior has been introduced as the default for optional relationships. This behavior has `SetNull` semantics for tracked entities and `Restrict` behavior for databases created using EF Core. In our experience, these are the most expected/useful behaviors for tracked entities and the database. `DeleteBehavior.Restrict` is now honored for tracked entities when set for optional relationships.
+
+## Provider design-time packages removed
+
+The `Microsoft.EntityFrameworkCore.Relational.Design` package has been removed. It's contents were consolidated into `Microsoft.EntityFrameworkCore.Relational` and `Microsoft.EntityFrameworkCore.Design`.
+
+This propagates into the provider design-time packages. Those packages (`Microsoft.EntityFrameworkCore.Sqlite.Design`, `Microsoft.EntityFrameworkCore.SqlServer.Design`, etc.) were removed and their contents consolidated into the main provider packages.
+
+To enable `Scaffold-DbContext` or `dotnet ef dbcontext scaffold` in EF Core 2.0, you only need to reference the single provider package:
+
+```xml
+<PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer"
+    Version="2.0.0" />
+<PackageReference Include="Microsoft.EntityFrameworkCore.Tools"
+    Version="2.0.0"
+    PrivateAssets="All" />
+<DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools.DotNet"
+    Version="2.0.0" />
+```
diff --git a/entity-framework/core/what-is-new/ef-core-2.1.md b/entity-framework/core/what-is-new/ef-core-2.1.md
new file mode 100644
index 0000000000..890ca15321
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-2.1.md
@@ -0,0 +1,176 @@
+---
+title: What is new in EF Core 2.1 - EF Core
+description: Changes and improvements in Entity Framework Core 2.1
+author: SamMonoRT
+ms.date: 02/20/2018
+uid: core/what-is-new/ef-core-2.1
+---
+
+# New features in EF Core 2.1
+
+Besides numerous bug fixes and small functional and performance enhancements, EF Core 2.1 includes some compelling new features:
+
+## Lazy loading
+
+EF Core now contains the necessary building blocks for anyone to author entity classes that can load their navigation properties on demand. We have also created a new package, Microsoft.EntityFrameworkCore.Proxies, that leverages those building blocks to produce lazy loading proxy classes based on minimally modified entity classes (for example, classes with virtual navigation properties).
+
+Read the [section on lazy loading](xref:core/querying/related-data#lazy-loading) for more information about this topic.
+
+## Parameters in entity constructors
+
+As one of the required building blocks for lazy loading, we enabled the creation of entities that take parameters in their constructors. You can use parameters to inject property values, lazy loading delegates, and services.
+
+Read the [section on entity constructor with parameters](xref:core/modeling/constructors) for more information about this topic.
+
+## Value conversions
+
+Until now, EF Core could only map properties of types natively supported by the underlying database provider. Values were copied back and forth between columns and properties without any transformation. Starting with EF Core 2.1, value conversions can be applied to transform the values obtained from columns before they are applied to properties, and vice versa. We have a number of conversions that can be applied by convention as necessary, as well as an explicit configuration API that allows registering custom conversions between columns and properties. Some of the application of this feature are:
+
+- Storing enums as strings
+- Mapping unsigned integers with SQL Server
+- Automatic encryption and decryption of property values
+
+Read the [section on value conversions](xref:core/modeling/value-conversions) for more information about this topic.
+
+## LINQ GroupBy translation
+
+Before version 2.1, in EF Core the GroupBy LINQ operator would always be evaluated in memory. We now support translating it to the SQL GROUP BY clause in most common cases.
+
+This example shows a query with GroupBy used to compute various aggregate functions:
+
+```csharp
+var query = context.Orders
+    .GroupBy(o => new { o.CustomerId, o.EmployeeId })
+    .Select(g => new
+        {
+          g.Key.CustomerId,
+          g.Key.EmployeeId,
+          Sum = g.Sum(o => o.Amount),
+          Min = g.Min(o => o.Amount),
+          Max = g.Max(o => o.Amount),
+          Avg = g.Average(o => o.Amount)
+        });
+```
+
+The corresponding SQL translation looks like this:
+
+```sql
+SELECT [o].[CustomerId], [o].[EmployeeId],
+    SUM([o].[Amount]), MIN([o].[Amount]), MAX([o].[Amount]), AVG([o].[Amount])
+FROM [Orders] AS [o]
+GROUP BY [o].[CustomerId], [o].[EmployeeId];
+```
+
+## Data Seeding
+
+With the new release it will be possible to provide initial data to populate a database. Unlike in EF6, seeding data is associated to an entity type as part of the model configuration. Then EF Core migrations can automatically compute what insert, update or delete operations need to be applied when upgrading the database to a new version of the model.
+
+As an example, you can use this to configure seed data for a Post in `OnModelCreating`:
+
+```csharp
+modelBuilder.Entity<Post>().HasData(new Post{ Id = 1, Text = "Hello World!" });
+```
+
+Read the [section on data seeding](xref:core/modeling/data-seeding) for more information about this topic.
+
+## Query types
+
+An EF Core model can now include query types. Unlike entity types, query types do not have keys defined on them and cannot be inserted, deleted or updated (that is, they are read-only), but they can be returned directly by queries. Some of the usage scenarios for query types are:
+
+- Mapping to views without primary keys
+- Mapping to tables without primary keys
+- Mapping to queries defined in the model
+- Serving as the return type for `FromSql()` queries
+
+Read the [section on query types](xref:core/modeling/keyless-entity-types) for more information about this topic.
+
+## Include for derived types
+
+It will be now possible to specify navigation properties only defined on derived types when writing expressions for the `Include` method. For the strongly typed version of `Include`, we support using either an explicit cast or the `as` operator. We also now support referencing the names of navigation property defined on derived types in the string version of `Include`:
+
+```csharp
+var option1 = context.People.Include(p => ((Student)p).School);
+var option2 = context.People.Include(p => (p as Student).School);
+var option3 = context.People.Include("School");
+```
+
+Read the [section on Include with derived types](xref:core/querying/related-data#include-on-derived-types) for more information about this topic.
+
+## System.Transactions support
+
+We have added the ability to work with System.Transactions features such as TransactionScope. This will work on both .NET Framework and .NET Core when using database providers that support it.
+
+Read the [section on System.Transactions](xref:core/saving/transactions#using-systemtransactions) for more information about this topic.
+
+## Better column ordering in initial migration
+
+Based on customer feedback, we have updated migrations to initially generate columns for tables in the same order as properties are declared in classes. Note that EF Core cannot change order when new members are added after the initial table creation.
+
+## Optimization of correlated subqueries
+
+We have improved our query translation to avoid executing "N + 1" SQL queries in many common scenarios in which the usage of a navigation property in the projection leads to joining data from the root query with data from a correlated subquery. The optimization requires buffering the results from the subquery, and we require that you modify the query to opt-in the new behavior.
+
+As an example, the following query normally gets translated into one query for Customers, plus N (where "N" is the number of customers returned) separate queries for Orders:
+
+```csharp
+var query = context.Customers.Select(
+    c => c.Orders.Where(o => o.Amount  > 100).Select(o => o.Amount));
+```
+
+By including `ToListAsync()` in the right place, you indicate that buffering is appropriate for the Orders, which enable the optimization:
+
+```csharp
+var query = context.Customers.Select(
+    c => c.Orders.Where(o => o.Amount  > 100).Select(o => o.Amount).ToList());
+```
+
+Note that this query will be translated to only two SQL queries: One for Customers and the next one for Orders.
+
+## [Owned] attribute
+
+It is now possible to configure [owned entity types](xref:core/modeling/owned-entities) by simply annotating the type with `[Owned]` and then making sure the owner entity is added to the model:
+
+```csharp
+[Owned]
+public class StreetAddress
+{
+    public string Street { get; set; }
+    public string City { get; set; }
+}
+
+public class Order
+{
+    public int Id { get; set; }
+    public StreetAddress ShippingAddress { get; set; }
+}
+```
+
+## Command-line tool dotnet-ef included in .NET Core SDK
+
+The _dotnet-ef_ commands are now part of the .NET Core SDK, therefore it will no longer be necessary to use DotNetCliToolReference in the project to be able to use migrations or to scaffold a DbContext from an existing database.
+
+See the section on [installing the tools](xref:core/cli/dotnet#installing-the-tools) for more details on how to enable command line tools for different versions of the .NET Core SDK and EF Core.
+
+## Microsoft.EntityFrameworkCore.Abstractions package
+
+The new package contains attributes and interfaces that you can use in your projects to light up EF Core features without taking a dependency on EF Core as a whole. For example, the [Owned] attribute and the ILazyLoader interface are located here.
+
+## State change events
+
+New `Tracked` And `StateChanged` events on `ChangeTracker` can be used to write logic that reacts to entities entering the DbContext or changing their state.
+
+## Raw SQL parameter analyzer
+
+A new code analyzer is included with EF Core that detects potentially unsafe usages of our raw-SQL APIs, like `FromSql` or `ExecuteSqlCommand`. For example, for the following query, you will see a warning because _minAge_ is not parameterized:
+
+```csharp
+var sql = $"SELECT * FROM People WHERE Age > {minAge}";
+var query = context.People.FromSql(sql);
+```
+
+## Database provider compatibility
+
+It is recommended that you use EF Core 2.1 with providers that have been updated or at least tested to work with EF Core 2.1.
+
+> [!TIP]
+> If you find any unexpected incompatibility or any issue in the new features, or if you have feedback on them, please report it using [our issue tracker](https://github.com/dotnet/efcore/issues/new).
diff --git a/entity-framework/core/what-is-new/ef-core-2.2.md b/entity-framework/core/what-is-new/ef-core-2.2.md
new file mode 100644
index 0000000000..34fc7fde1c
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-2.2.md
@@ -0,0 +1,113 @@
+---
+title: What is new in EF Core 2.2 - EF Core
+description: Changes and improvements in Entity Framework Core 2.2
+author: SamMonoRT
+ms.date: 11/14/2018
+uid: core/what-is-new/ef-core-2.2
+---
+
+# New features in EF Core 2.2
+
+## Spatial data support
+
+Spatial data can be used to represent the physical location and shape of objects.
+Many databases can natively store, index, and query spatial data.
+Common scenarios include querying for objects within a given distance, and testing if a polygon contains a given location.
+EF Core 2.2 now supports working with spatial data from various databases using types from the [NetTopologySuite](https://github.com/NetTopologySuite/NetTopologySuite) (NTS) library.
+
+Spatial data support is implemented as a series of provider-specific extension packages.
+Each of these packages contributes mappings for NTS types and methods, and the corresponding spatial types and functions in the database.
+Such provider extensions are now available for [SQL Server](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.SqlServer.NetTopologySuite/), [SQLite](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Sqlite.NetTopologySuite/), and [PostgreSQL](https://www.nuget.org/packages/Npgsql.EntityFrameworkCore.PostgreSQL.NetTopologySuite/) (from the [Npgsql project](https://www.npgsql.org/)).
+Spatial types can be used directly with the [EF Core in-memory provider](xref:core/providers/in-memory/index) without additional extensions.
+
+Once the provider extension is installed, you can add properties of supported types to your entities. For example:
+
+```csharp
+using NetTopologySuite.Geometries;
+
+namespace MyApp
+{
+  public class Friend
+  {
+    [Key]
+    public string Name { get; set; }
+
+    [Required]
+    public Point Location { get; set; }
+  }
+}
+```
+
+You can then persist entities with spatial data:
+
+```csharp
+using (var context = new MyDbContext())
+{
+    context.Add(
+        new Friend
+        {
+            Name = "Bill",
+            Location = new Point(-122.34877, 47.6233355) {SRID = 4326 }
+        });
+    await context.SaveChangesAsync();
+}
+```
+
+And you can execute database queries based on spatial data and operations:
+
+```csharp
+var nearestFriends =
+    await (from f in context.Friends
+    orderby f.Location.Distance(myLocation) descending
+    select f).Take(5).ToListAsync();
+```
+
+For more information on this feature, see the [spatial types documentation](xref:core/modeling/spatial).
+
+## Collections of owned entities
+
+EF Core 2.0 added the ability to model ownership in one-to-one associations.
+EF Core 2.2 extends the ability to express ownership to one-to-many associations.
+Ownership helps constrain how entities are used.
+
+For example, owned entities:
+
+- Can only ever appear on navigation properties of other entity types.
+- Are automatically loaded, and can only be tracked by a DbContext alongside their owner.
+
+In relational databases, owned collections are mapped to separate tables from the owner, just like regular one-to-many associations.
+But in document-oriented databases, we plan to nest owned entities (in owned collections or references) within the same document as the owner.
+
+You can use the feature by calling the new OwnsMany() API:
+
+```csharp
+modelBuilder.Entity<Customer>().OwnsMany(c => c.Addresses);
+```
+
+For more information, see the [updated owned entities documentation](xref:core/modeling/owned-entities#collections-of-owned-types).
+
+## Query tags
+
+This feature simplifies the correlation of LINQ queries in code with generated SQL queries captured in logs.
+
+To take advantage of query tags, you annotate a LINQ query using the new TagWith() method.
+Using the spatial query from a previous example:
+
+```csharp
+var nearestFriends =
+    await (from f in context.Friends.TagWith(@"This is my spatial query!")
+    orderby f.Location.Distance(myLocation) descending
+    select f).Take(5).ToListAsync();
+```
+
+This LINQ query will produce the following SQL output:
+
+```sql
+-- This is my spatial query!
+
+SELECT TOP(@__p_1) [f].[Name], [f].[Location]
+FROM [Friends] AS [f]
+ORDER BY [f].[Location].STDistance(@__myLocation_0) DESC
+```
+
+For more information, see the [query tags documentation](xref:core/querying/tags).
diff --git a/entity-framework/core/what-is-new/ef-core-3.0.md b/entity-framework/core/what-is-new/ef-core-3.0.md
new file mode 100644
index 0000000000..64bf5531b2
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-3.0.md
@@ -0,0 +1,14 @@
+---
+title: What is new in EF Core 3.0 - EF Core
+description: Changes and improvements in Entity Framework Core 3.0
+author: smitpatel
+ms.date: 11/09/2020
+uid: core/what-is-new/ef-core-3.0
+---
+
+# New features in EF Core 3.0
+
+Entity Framework Core (EF Core) version 3.0 is out of support. All the new features added in 3.0 are available in version 3.1. Refer to following links related to version 3.1.
+
+- [New features](xref:core/what-is-new/ef-core-3.x/index)
+- [Breaking changes](xref:core/what-is-new/ef-core-3.x/breaking-changes)
diff --git a/entity-framework/core/what-is-new/ef-core-3.x/breaking-changes.md b/entity-framework/core/what-is-new/ef-core-3.x/breaking-changes.md
new file mode 100644
index 0000000000..ee23f13876
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-3.x/breaking-changes.md
@@ -0,0 +1,1812 @@
+---
+title: Breaking changes in EF Core 3.x - EF Core
+description: Complete list of breaking changes introduced in Entity Framework Core 3.x
+author: SamMonoRT
+ms.date: 09/05/2020
+uid: core/what-is-new/ef-core-3.x/breaking-changes
+ms.custom: sfi-ropc-nochange
+---
+
+# Breaking changes included in EF Core 3.x
+
+The following API and behavior changes have the potential to break existing applications when upgrading them to 3.x.
+
+## Summary
+
+| **Breaking change**                                                                                               | **Impact** |
+|:------------------------------------------------------------------------------------------------------------------|------------|
+| [LINQ queries are no longer evaluated on the client](#linq-queries-are-no-longer-evaluated-on-the-client)         | High       |
+| [The EF Core command-line tool, dotnet ef, is no longer part of the .NET Core SDK](#dotnet-ef) | High      |
+| [DetectChanges honors store-generated key values](#dc) | High      |
+| [FromSql, ExecuteSql, and ExecuteSqlAsync have been renamed](#fromsql) | High      |
+| [Query types are consolidated with entity types](#qt) | High      |
+| [Entity Framework Core is no longer part of the ASP.NET Core shared framework](#no-longer) | Medium      |
+| [Cascade deletions now happen immediately by default](#cascade) | Medium      |
+| [Eager loading of related entities now happens in a single query](#eager-loading-single-query) | Medium      |
+| [DeleteBehavior.Restrict has cleaner semantics](#deletebehavior) | Medium      |
+| [Configuration API for owned type relationships has changed](#config) | Medium      |
+| [Each property uses independent in-memory integer key generation](#each) | Medium      |
+| [No-tracking queries no longer perform identity resolution](#notrackingresolution) | Medium      |
+| [Metadata API changes](#metadata-api-changes) | Medium      |
+| [Provider-specific Metadata API changes](#provider) | Medium      |
+| [UseRowNumberForPaging has been removed](#urn) | Medium      |
+| [FromSql method when used with stored procedure cannot be composed](#fromsqlsproc) | Medium      |
+| [FromSql methods can only be specified on query roots](#fromsql) | Low      |
+| [Temporary key values are no longer set onto entity instances](#tkv) | Low      |
+| [Dependent entities sharing the table with the principal are now optional](#de) | Low      |
+| [All entities sharing a table with a concurrency token column have to map it to a property](#aes) | Low      |
+| [Owned entities cannot be queried without the owner using a tracking query](#owned-query) | Low      |
+| [Inherited properties from unmapped types are now mapped to a single column for all derived types](#ip) | Low      |
+| [The foreign key property convention no longer matches same name as the principal property](#fkp) | Low      |
+| [Database connection is now closed if not used anymore before the TransactionScope has been completed](#dbc) | Low      |
+| [Backing fields are used by default](#backing-fields-are-used-by-default) | Low      |
+| [Throw if multiple compatible backing fields are found](#throw-if-multiple-compatible-backing-fields-are-found) | Low      |
+| [Field-only property names should match the field name](#field-only-property-names-should-match-the-field-name) | Low      |
+| [AddDbContext/AddDbContextPool no longer call AddLogging and AddMemoryCache](#adddbc) | Low      |
+| [AddEntityFramework* adds IMemoryCache with a size limit](#addentityframework-adds-imemorycache-with-a-size-limit) | Low      |
+| [DbContext.Entry now performs a local DetectChanges](#dbe) | Low      |
+| [String and byte array keys are not client-generated by default](#string-and-byte-array-keys-are-not-client-generated-by-default) | Low      |
+| [ILoggerFactory is now a scoped service](#ilf) | Low      |
+| [Lazy-loading proxies no longer assume navigation properties are fully loaded](#lazy-loading-proxies-no-longer-assume-navigation-properties-are-fully-loaded) | Low      |
+| [Excessive creation of internal service providers is now an error by default](#excessive-creation-of-internal-service-providers-is-now-an-error-by-default) | Low      |
+| [New behavior for HasOne/HasMany called with a single string](#nbh) | Low      |
+| [The return type for several async methods has been changed from Task to ValueTask](#rtnt) | Low      |
+| [The Relational:TypeMapping annotation is now just TypeMapping](#rtt) | Low      |
+| [ToTable on a derived type throws an exception](#totable-on-a-derived-type-throws-an-exception) | Low      |
+| [EF Core no longer sends pragma for SQLite FK enforcement](#pragma) | Low      |
+| [Microsoft.EntityFrameworkCore.Sqlite now depends on SQLitePCLRaw.bundle_e_sqlite3](#sqlite3) | Low      |
+| [Guid values are now stored as TEXT on SQLite](#guid) | Low      |
+| [Char values are now stored as TEXT on SQLite](#char) | Low      |
+| [Migration IDs are now generated using the invariant culture's calendar](#migid) | Low      |
+| [Extension info/metadata has been removed from IDbContextOptionsExtension](#xinfo) | Low      |
+| [LogQueryPossibleExceptionWithAggregateOperator has been renamed](#lqpe) | Low      |
+| [Clarify API for foreign key constraint names](#clarify) | Low      |
+| [IRelationalDatabaseCreator.HasTables/HasTablesAsync have been made public](#irdc2) | Low      |
+| [Microsoft.EntityFrameworkCore.Design is now a DevelopmentDependency package](#dip) | Low      |
+| [SQLitePCL.raw updated to version 2.0.0](#SQLitePCL) | Low      |
+| [NetTopologySuite updated to version 2.0.0](#NetTopologySuite) | Low      |
+| [Microsoft.Data.SqlClient is used instead of System.Data.SqlClient](#SqlClient) | Low      |
+| [Multiple ambiguous self-referencing relationships must be configured](#mersa) | Low      |
+| [DbFunction.Schema being null or empty string configures it to be in model's default schema](#udf-empty-string) | Low      |
+| [~~EF Core 3.0 targets .NET Standard 2.1 rather than .NET Standard 2.0~~ Reverted](#netstandard21) | |
+| [~~Query execution is logged at Debug level~~ Reverted](#qe) | |
+
+## High-impact changes
+
+### LINQ queries are no longer evaluated on the client
+
+[Tracking Issue #14935](https://github.com/dotnet/efcore/issues/14935)
+[Also see issue #12795](https://github.com/dotnet/efcore/issues/12795)
+
+#### Old behavior
+
+Before 3.0, when EF Core couldn't convert an expression that was part of a query to either SQL or a parameter, it automatically evaluated the expression on the client.
+By default, client evaluation of potentially expensive expressions only triggered a warning.
+
+#### New behavior
+
+Starting with 3.0, EF Core only allows expressions in the top-level projection (the last `Select()` call in the query) to be evaluated on the client.
+When expressions in any other part of the query can't be converted to either SQL or a parameter, an exception is thrown.
+
+#### Why
+
+Automatic client evaluation of queries allows many queries to be executed even if important parts of them can't be translated.
+This behavior can result in unexpected and potentially damaging behavior that may only become evident in production.
+For example, a condition in a `Where()` call which can't be translated can cause all rows from the table to be transferred from the database server, and the filter to be applied on the client.
+This situation can easily go undetected if the table contains only a few rows in development, but hit hard when the application moves to production, where the table may contain millions of rows.
+Client evaluation warnings also proved too easy to ignore during development.
+
+Besides this, automatic client evaluation can lead to issues in which improving query translation for specific expressions caused unintended breaking changes between releases.
+
+#### Mitigations
+
+If a query can't be fully translated, then either rewrite the query in a form that can be translated, or use `AsEnumerableAsync()`, `ToListAsync()`, or similar to explicitly bring data back to the client where it can then be further processed using LINQ-to-Objects.
+
+<a name="no-longer"></a>
+
+## Medium-impact changes
+
+### Entity Framework Core is no longer part of the ASP.NET Core shared framework
+
+[Tracking Issue Announcements#325](https://github.com/aspnet/Announcements/issues/325)
+
+#### Old behavior
+
+Before ASP.NET Core 3.0, when you added a package reference to `Microsoft.AspNetCore.App` or `Microsoft.AspNetCore.All`, it would include EF Core and some of the EF Core data providers like the SQL Server provider.
+
+#### New behavior
+
+Starting in 3.0, the ASP.NET Core shared framework doesn't include EF Core or any EF Core data providers.
+
+#### Why
+
+Before this change, getting EF Core required different steps depending on whether the application targeted ASP.NET Core and SQL Server or not.
+Also, upgrading ASP.NET Core forced the upgrade of EF Core and the SQL Server provider, which isn't always desirable.
+
+With this change, the experience of getting EF Core is the same across all providers, supported .NET implementations and application types.
+Developers can also now control exactly when EF Core and EF Core data providers are upgraded.
+
+#### Mitigations
+
+To use EF Core in an ASP.NET Core 3.0 application or any other supported application, explicitly add a package reference to the EF Core database provider that your application will use.
+
+<a name="dotnet-ef"></a>
+
+### The EF Core command-line tool, dotnet ef, is no longer part of the .NET Core SDK
+
+[Tracking Issue #14016](https://github.com/dotnet/efcore/issues/14016)
+
+#### Old behavior
+
+Before 3.0, the `dotnet ef` tool was included in the .NET Core SDK and was readily available to use from the command line from any project without requiring extra steps.
+
+#### New behavior
+
+Starting in 3.0, the .NET SDK does not include the `dotnet ef` tool, so before you can use it you have to explicitly install it as a local or global tool.
+
+#### Why
+
+This change allows us to distribute and update `dotnet ef` as a regular .NET CLI tool on NuGet, consistent with the fact that the EF Core 3.0 is also always distributed as a NuGet package.
+
+#### Mitigations
+
+To be able to manage migrations or scaffold a `DbContext`, install `dotnet-ef` as a global tool:
+
+```dotnetcli
+dotnet tool install --global dotnet-ef
+```
+
+You can also obtain it a local tool when you restore the dependencies of a project that declares it as a tooling dependency using a [tool manifest file](/dotnet/core/tools/global-tools#install-a-local-tool).
+
+## Low-impact changes
+
+<a name="fromsql"></a>
+
+### FromSql, ExecuteSql, and ExecuteSqlAsync have been renamed
+
+[Tracking Issue #10996](https://github.com/dotnet/efcore/issues/10996)
+
+> [!IMPORTANT]
+> `ExecuteSqlCommand` and `ExecuteSqlCommandAsync` are deprecated. Use these methods instead.
+
+#### Old behavior
+
+Before EF Core 3.0, these method names were overloaded to work with either a normal string or a string that should be interpolated into SQL and parameters.
+
+#### New behavior
+
+Starting with EF Core 3.0, use `FromSqlRaw`, `ExecuteSqlRaw`, and `ExecuteSqlRawAsync` to create a parameterized query where the parameters are passed separately from the query string.
+For example:
+
+```csharp
+context.Products.FromSqlRaw(
+    "SELECT * FROM Products WHERE Name = {0}",
+    product.Name);
+```
+
+Use `FromSqlInterpolated`, `ExecuteSqlInterpolated`, and `ExecuteSqlInterpolatedAsync` to create a parameterized query where the parameters are passed as part of an interpolated query string.
+For example:
+
+```csharp
+context.Products.FromSqlInterpolated(
+    $"SELECT * FROM Products WHERE Name = {product.Name}");
+```
+
+Note that both of the queries above will produce the same parameterized SQL with the same SQL parameters.
+
+#### Why
+
+Method overloads like this make it very easy to accidentally call the raw string method when the intent was to call the interpolated string method, and the other way around.
+This could result in queries not being parameterized when they should have been.
+
+#### Mitigations
+
+Switch to use the new method names.
+
+<a name="fromsqlsproc"></a>
+
+### FromSql method when used with stored procedure cannot be composed
+
+[Tracking Issue #15392](https://github.com/dotnet/efcore/issues/15392)
+
+#### Old behavior
+
+Before EF Core 3.0, FromSql method tried to detect if the passed SQL can be composed upon. It did client evaluation when the SQL was non-composable like a stored procedure. The following query worked by running the stored procedure on the server and doing FirstOrDefault on the client side.
+
+```csharp
+context.Products.FromSqlRaw("[dbo].[Ten Most Expensive Products]").FirstOrDefault();
+```
+
+#### New behavior
+
+Starting with EF Core 3.0, EF Core will not try to parse the SQL. So if you are composing after FromSqlRaw/FromSqlInterpolated, then EF Core will compose the SQL by causing sub query. So if you are using a stored procedure with composition then you will get an exception for invalid SQL syntax.
+
+#### Why
+
+EF Core 3.0 does not support automatic client evaluation, since it was error prone as explained [here](#linq-queries-are-no-longer-evaluated-on-the-client).
+
+#### Mitigations
+
+If you are using a stored procedure in FromSqlRaw/FromSqlInterpolated, you know that it cannot be composed upon, so you can add `AsEnumerable`/`AsAsyncEnumerable` right after the FromSql method call to avoid any composition on server side.
+
+```csharp
+context.Products.FromSqlRaw("[dbo].[Ten Most Expensive Products]").AsEnumerable().FirstOrDefault();
+```
+
+<a name="fromsql"></a>
+
+### FromSql methods can only be specified on query roots
+
+[Tracking Issue #15704](https://github.com/dotnet/efcore/issues/15704)
+
+#### Old behavior
+
+Before EF Core 3.0, the `FromSql` method could be specified anywhere in the query.
+
+#### New behavior
+
+Starting with EF Core 3.0, the new `FromSqlRaw` and `FromSqlInterpolated` methods (which replace `FromSql`) can only be specified on query roots, i.e. directly on the `DbSet<>`. Attempting to specify them anywhere else will result in a compilation error.
+
+#### Why
+
+Specifying `FromSql` anywhere other than on a `DbSet` had no added meaning or added value, and could cause ambiguity in certain scenarios.
+
+#### Mitigations
+
+`FromSql` invocations should be moved to be directly on the `DbSet` to which they apply.
+
+<a name="notrackingresolution"></a>
+
+### No-tracking queries no longer perform identity resolution
+
+[Tracking Issue #13518](https://github.com/dotnet/efcore/issues/13518)
+
+#### Old behavior
+
+Before EF Core 3.0, the same entity instance would be used for every occurrence of an entity with a given type and ID. This matches the behavior of tracking queries. For example, this query:
+
+```csharp
+var results = await context.Products.Include(e => e.Category).AsNoTracking().ToListAsync();
+```
+
+would return the same `Category` instance for each `Product` that is associated with the given category.
+
+#### New behavior
+
+Starting with EF Core 3.0, different entity instances will be created when an entity with a given type and ID is encountered at different places in the returned graph. For example, the query above will now return a new `Category` instance for each `Product` even when two products are associated with the same category.
+
+#### Why
+
+Identity resolution (that is, determining that an entity has the same type and ID as a previously encountered entity) adds additional performance and memory overhead. This usually runs counter to why no-tracking queries are used in the first place. Also, while identity resolution can sometimes be useful, it is not needed if the entities are to be serialized and sent to a client, which is common for no-tracking queries.
+
+#### Mitigations
+
+Use a tracking query if identity resolution is required.
+
+<a name="tkv"></a>
+
+### Temporary key values are no longer set onto entity instances
+
+[Tracking Issue #12378](https://github.com/dotnet/efcore/issues/12378)
+
+#### Old behavior
+
+Before EF Core 3.0, temporary values were assigned to all key properties that would later have a real value generated by the database.
+Usually these temporary values were large negative numbers.
+
+#### New behavior
+
+Starting with 3.0, EF Core stores the temporary key value as part of the entity's tracking information, and leaves the key property itself unchanged.
+
+#### Why
+
+This change was made to prevent temporary key values from erroneously becoming permanent when an entity that has been previously tracked by some `DbContext` instance is moved to a different `DbContext` instance.
+
+#### Mitigations
+
+Applications that assign primary key values onto foreign keys to form associations between entities may depend on the old behavior if the primary keys are store-generated and belong to entities in the `Added` state.
+This can be avoided by:
+
+* Not using store-generated keys.
+* Setting navigation properties to form relationships instead of setting foreign key values.
+* Obtain the actual temporary key values from the entity's tracking information.
+For example, `context.Entry(blog).Property(e => e.Id).CurrentValue` will return the temporary value even though `blog.Id` itself hasn't been set.
+
+<a name="dc"></a>
+
+### DetectChanges honors store-generated key values
+
+[Tracking Issue #14616](https://github.com/dotnet/efcore/issues/14616)
+
+#### Old behavior
+
+Before EF Core 3.0, an untracked entity found by `DetectChanges` would be tracked in the `Added` state and inserted as a new row when `SaveChanges` is called.
+
+#### New behavior
+
+Starting with EF Core 3.0, if an entity is using generated key values and some key value is set, then the entity will be tracked in the `Modified` state.
+This means that a row for the entity is assumed to exist and it will be updated when `SaveChanges` is called.
+If the key value isn't set, or if the entity type isn't using generated keys, then the new entity will still be tracked as `Added` as in previous versions.
+
+#### Why
+
+This change was made to make it easier and more consistent to work with disconnected entity graphs while using store-generated keys.
+
+#### Mitigations
+
+This change can break an application if an entity type is configured to use generated keys but key values are explicitly set for new instances.
+The fix is to explicitly configure the key properties to not use generated values.
+For example, with the fluent API:
+
+```csharp
+modelBuilder
+    .Entity<Blog>()
+    .Property(e => e.Id)
+    .ValueGeneratedNever();
+```
+
+Or with data annotations:
+
+```csharp
+[DatabaseGenerated(DatabaseGeneratedOption.None)]
+public string Id { get; set; }
+```
+
+<a name="cascade"></a>
+
+### Cascade deletions now happen immediately by default
+
+[Tracking Issue #10114](https://github.com/dotnet/efcore/issues/10114)
+
+#### Old behavior
+
+Before 3.0, EF Core applied cascading actions (deleting dependent entities when a required principal is deleted or when the relationship to a required principal is severed) did not happen until SaveChanges was called.
+
+#### New behavior
+
+Starting with 3.0, EF Core applies cascading actions as soon as the triggering condition is detected.
+For example, calling `context.Remove()` to delete a principal entity will result in all tracked related required dependents also being set to `Deleted` immediately.
+
+#### Why
+
+This change was made to improve the experience for data binding and auditing scenarios where it is important to understand which entities will be deleted _before_ `SaveChanges` is called.
+
+#### Mitigations
+
+The previous behavior can be restored through settings on `context.ChangeTracker`.
+For example:
+
+```csharp
+context.ChangeTracker.CascadeDeleteTiming = CascadeTiming.OnSaveChanges;
+context.ChangeTracker.DeleteOrphansTiming = CascadeTiming.OnSaveChanges;
+```
+
+<a name="eager-loading-single-query"></a>
+
+### Eager loading of related entities now happens in a single query
+
+[Tracking issue #18022](https://github.com/dotnet/efcore/issues/18022)
+
+#### Old behavior
+
+Before 3.0, eagerly loading collection navigations via `Include` operators caused multiple queries to be generated on relational database, one for each related entity type.
+
+#### New behavior
+
+Starting with 3.0, EF Core generates a single query with JOINs on relational databases.
+
+#### Why
+
+Issuing multiple queries to implement a single LINQ query caused numerous issues, including negative performance as multiple database roundtrips were necessary, and data coherency issues as each query could observe a different state of the database.
+
+#### Mitigations
+
+While technically this is not a breaking change, it could have a considerable effect on application performance when a single query contains a large number of `Include` operator on collection navigations. [See this comment](https://github.com/dotnet/efcore/issues/18022#issuecomment-542397085) for more information and for rewriting queries in a more efficient way.
+
+**
+
+<a name="deletebehavior"></a>
+
+### DeleteBehavior.Restrict has cleaner semantics
+
+[Tracking Issue #12661](https://github.com/dotnet/efcore/issues/12661)
+
+#### Old behavior
+
+Before 3.0, `DeleteBehavior.Restrict` created foreign keys in the database with `Restrict` semantics, but also changed internal fixup in a non-obvious way.
+
+#### New behavior
+
+Starting with 3.0, `DeleteBehavior.Restrict` ensures that foreign keys are created with `Restrict` semantics--that is, no cascades; throw on constraint violation--without also impacting EF internal fixup.
+
+#### Why
+
+This change was made to improve the experience for using `DeleteBehavior` in an intuitive manner, without unexpected side-effects.
+
+#### Mitigations
+
+The previous behavior can be restored by using `DeleteBehavior.ClientNoAction`.
+
+<a name="qt"></a>
+
+### Query types are consolidated with entity types
+
+[Tracking Issue #14194](https://github.com/dotnet/efcore/issues/14194)
+
+#### Old behavior
+
+Before EF Core 3.0, [query types](xref:core/modeling/keyless-entity-types) were a means to query data that doesn't define a primary key in a structured way.
+That is, a query type was used for mapping entity types without keys (more likely from a view, but possibly from a table) while a regular entity type was used when a key was available (more likely from a table, but possibly from a view).
+
+#### New behavior
+
+A query type now becomes just an entity type without a primary key.
+Keyless entity types have the same functionality as query types in previous versions.
+
+#### Why
+
+This change was made to reduce the confusion around the purpose of query types.
+Specifically, they are keyless entity types and they are inherently read-only because of this, but they should not be used just because an entity type needs to be read-only.
+Likewise, they are often mapped to views, but this is only because views often don't define keys.
+
+#### Mitigations
+
+The following parts of the API are now obsolete:
+
+* **`ModelBuilder.Query<>()`** - Instead `ModelBuilder.Entity<>().HasNoKey()` needs to be called to mark an entity type as having no keys.
+This would still not be configured by convention to avoid misconfiguration when a primary key is expected, but doesn't match the convention.
+* **`DbQuery<>`** - Instead `DbSet<>` should be used.
+* **`DbContext.Query<>()`** - Instead `DbContext.Set<>()` should be used.
+* **`IQueryTypeConfiguration<TQuery>`** - Instead `IEntityTypeConfiguration<TEntity>` should be used.
+
+> [!NOTE]
+> Due to [an issue in 3.x](https://github.com/dotnet/efcore/issues/19537) when querying keyless entities that have all properties set to `null` a `null` will be returned instead of an entity, if this issue is applicable to your scenario also add logic to handle `null` in results.
+
+<a name="config"></a>
+
+### Configuration API for owned type relationships has changed
+
+[Tracking Issue #12444](https://github.com/dotnet/efcore/issues/12444)
+[Tracking Issue #9148](https://github.com/dotnet/efcore/issues/9148)
+[Tracking Issue #14153](https://github.com/dotnet/efcore/issues/14153)
+
+#### Old behavior
+
+Before EF Core 3.0, configuration of the owned relationship was performed directly after the `OwnsOne` or `OwnsMany` call.
+
+#### New behavior
+
+Starting with EF Core 3.0, there is now fluent API to configure a navigation property to the owner using `WithOwner()`.
+For example:
+
+```csharp
+modelBuilder.Entity<Order>.OwnsOne(e => e.Details).WithOwner(e => e.Order);
+```
+
+The configuration related to the relationship between owner and owned should now be chained after `WithOwner()` similarly to how other relationships are configured.
+While the configuration for the owned type itself would still be chained after `OwnsOne()/OwnsMany()`.
+For example:
+
+```csharp
+modelBuilder.Entity<Order>.OwnsOne(e => e.Details, eb =>
+    {
+        eb.WithOwner()
+            .HasForeignKey(e => e.AlternateId)
+            .HasConstraintName("FK_OrderDetails");
+
+        eb.ToTable("OrderDetails");
+        eb.HasKey(e => e.AlternateId);
+        eb.HasIndex(e => e.Id);
+
+        eb.HasOne(e => e.Customer).WithOne();
+
+        eb.HasData(
+            new OrderDetails
+            {
+                AlternateId = 1,
+                Id = -1
+            });
+    });
+```
+
+Additionally calling `Entity()`, `HasOne()`, or `Set()` with an owned type target will now throw an exception.
+
+#### Why
+
+This change was made to create a cleaner separation between configuring the owned type itself and the _relationship to_ the owned type.
+This in turn removes ambiguity and confusion around methods like `HasForeignKey`.
+
+#### Mitigations
+
+Change configuration of owned type relationships to use the new API surface as shown in the example above.
+
+<a name="de"></a>
+
+### Dependent entities sharing the table with the principal are now optional
+
+[Tracking Issue #9005](https://github.com/dotnet/efcore/issues/9005)
+
+#### Old behavior
+
+Consider the following model:
+
+```csharp
+public class Order
+{
+    public int Id { get; set; }
+    public int CustomerId { get; set; }
+    public OrderDetails Details { get; set; }
+}
+
+public class OrderDetails
+{
+    public int Id { get; set; }
+    public string ShippingAddress { get; set; }
+}
+```
+
+Before EF Core 3.0, if `OrderDetails` is owned by `Order` or explicitly mapped to the same table then an `OrderDetails` instance was always required when adding a new `Order`.
+
+#### New behavior
+
+Starting with 3.0, EF Core allows to add an `Order` without an `OrderDetails` and maps all of the `OrderDetails` properties except the primary key to nullable columns.
+When querying EF Core sets `OrderDetails` to `null` if any of its required properties doesn't have a value or if it has no required properties besides the primary key and all properties are `null`.
+
+#### Mitigations
+
+If your model has a table sharing dependent with all optional columns, but the navigation pointing to it is not expected to be `null` then the application should be modified to handle cases when the navigation is `null`. If this is not possible a required property should be added to the entity type or at least one property should have a non-`null` value assigned to it.
+
+<a name="aes"></a>
+
+### All entities sharing a table with a concurrency token column have to map it to a property
+
+[Tracking Issue #14154](https://github.com/dotnet/efcore/issues/14154)
+
+#### Old behavior
+
+Consider the following model:
+
+```csharp
+public class Order
+{
+    public int Id { get; set; }
+    public int CustomerId { get; set; }
+    public byte[] Version { get; set; }
+    public OrderDetails Details { get; set; }
+}
+
+public class OrderDetails
+{
+    public int Id { get; set; }
+    public string ShippingAddress { get; set; }
+}
+
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Order>()
+        .Property(o => o.Version).IsRowVersion().HasColumnName("Version");
+}
+```
+
+Before EF Core 3.0, if `OrderDetails` is owned by `Order` or explicitly mapped to the same table then updating just `OrderDetails` will not update `Version` value on client and the next update will fail.
+
+#### New behavior
+
+Starting with 3.0, EF Core propagates the new `Version` value to `Order` if it owns `OrderDetails`. Otherwise an exception is thrown during model validation.
+
+#### Why
+
+This change was made to avoid a stale concurrency token value when only one of the entities mapped to the same table is updated.
+
+#### Mitigations
+
+All entities sharing the table have to include a property that is mapped to the concurrency token column. It's possible the create one in shadow-state:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<OrderDetails>()
+        .Property<byte[]>("Version").IsRowVersion().HasColumnName("Version");
+}
+```
+
+<a name="owned-query"></a>
+
+### Owned entities cannot be queried without the owner using a tracking query
+
+[Tracking Issue #18876](https://github.com/dotnet/efcore/issues/18876)
+
+#### Old behavior
+
+Before EF Core 3.0, the owned entities could be queried as any other navigation.
+
+```csharp
+context.People.Select(p => p.Address);
+```
+
+#### New behavior
+
+Starting with 3.0, EF Core will throw if a tracking query projects an owned entity without the owner.
+
+#### Why
+
+Owned entities cannot be manipulated without the owner, so in the vast majority of cases querying them in this way is an error.
+
+#### Mitigations
+
+If the owned entity should be tracked to be modified in any way later then the owner should be included in the query.
+
+Otherwise add an `AsNoTracking()` call:
+
+```csharp
+context.People.Select(p => p.Address).AsNoTracking();
+```
+
+<a name="ip"></a>
+
+### Inherited properties from unmapped types are now mapped to a single column for all derived types
+
+[Tracking Issue #13998](https://github.com/dotnet/efcore/issues/13998)
+
+#### Old behavior
+
+Consider the following model:
+
+```csharp
+public abstract class EntityBase
+{
+    public int Id { get; set; }
+}
+
+public abstract class OrderBase : EntityBase
+{
+    public int ShippingAddress { get; set; }
+}
+
+public class BulkOrder : OrderBase
+{
+}
+
+public class Order : OrderBase
+{
+}
+
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Ignore<OrderBase>();
+    modelBuilder.Entity<EntityBase>();
+    modelBuilder.Entity<BulkOrder>();
+    modelBuilder.Entity<Order>();
+}
+```
+
+Before EF Core 3.0, the `ShippingAddress` property would be mapped to separate columns for `BulkOrder` and `Order` by default.
+
+#### New behavior
+
+Starting with 3.0, EF Core only creates one column for `ShippingAddress`.
+
+#### Why
+
+The old behavior was unexpected.
+
+#### Mitigations
+
+The property can still be explicitly mapped to separate column on the derived types:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Ignore<OrderBase>();
+    modelBuilder.Entity<EntityBase>();
+    modelBuilder.Entity<BulkOrder>()
+        .Property(o => o.ShippingAddress).HasColumnName("BulkShippingAddress");
+    modelBuilder.Entity<Order>()
+        .Property(o => o.ShippingAddress).HasColumnName("ShippingAddress");
+}
+```
+
+<a name="fkp"></a>
+
+### The foreign key property convention no longer matches same name as the principal property
+
+[Tracking Issue #13274](https://github.com/dotnet/efcore/issues/13274)
+
+#### Old behavior
+
+Consider the following model:
+
+```csharp
+public class Customer
+{
+    public int CustomerId { get; set; }
+    public ICollection<Order> Orders { get; set; }
+}
+
+public class Order
+{
+    public int Id { get; set; }
+    public int CustomerId { get; set; }
+}
+```
+
+Before EF Core 3.0, the `CustomerId` property would be used for the foreign key by convention.
+However, if `Order` is an owned type, then this would also make `CustomerId` the primary key and this isn't usually the expectation.
+
+#### New behavior
+
+Starting with 3.0, EF Core doesn't try to use properties for foreign keys by convention if they have the same name as the principal property.
+Principal type name concatenated with principal property name, and navigation name concatenated with principal property name patterns are still matched.
+For example:
+
+```csharp
+public class Customer
+{
+    public int Id { get; set; }
+    public ICollection<Order> Orders { get; set; }
+}
+
+public class Order
+{
+    public int Id { get; set; }
+    public int CustomerId { get; set; }
+}
+```
+
+```csharp
+public class Customer
+{
+    public int Id { get; set; }
+    public ICollection<Order> Orders { get; set; }
+}
+
+public class Order
+{
+    public int Id { get; set; }
+    public int BuyerId { get; set; }
+    public Customer Buyer { get; set; }
+}
+```
+
+#### Why
+
+This change was made to avoid erroneously defining a primary key property on the owned type.
+
+#### Mitigations
+
+If the property was intended to be the foreign key, and hence part of the primary key, then explicitly configure it as such.
+
+<a name="dbc"></a>
+
+### Database connection is now closed if not used anymore before the TransactionScope has been completed
+
+[Tracking Issue #14218](https://github.com/dotnet/efcore/issues/14218)
+
+#### Old behavior
+
+Before EF Core 3.0, if the context opens the connection inside a `TransactionScope`, the connection remains open while the current `TransactionScope` is active.
+
+```csharp
+using (new TransactionScope())
+{
+    using (AdventureWorks context = new AdventureWorks())
+    {
+        context.ProductCategories.Add(new ProductCategory());
+        await context.SaveChangesAsync();
+
+        // Old behavior: Connection is still open at this point
+
+        var categories = await context.ProductCategories().ToListAsync();
+    }
+}
+```
+
+#### New behavior
+
+Starting with 3.0, EF Core closes the connection as soon as it's done using it.
+
+#### Why
+
+This change allows to use multiple contexts in the same `TransactionScope`. The new behavior also matches EF6.
+
+#### Mitigations
+
+If the connection needs to remain open explicit call to `OpenConnection()` will ensure that EF Core doesn't close it prematurely:
+
+```csharp
+using (new TransactionScope())
+{
+    using (AdventureWorks context = new AdventureWorks())
+    {
+        await context.Database.OpenConnectionAsync();
+        context.ProductCategories.Add(new ProductCategory());
+        await context.SaveChangesAsync();
+
+        var categories = await context.ProductCategories().ToListAsync();
+        await context.Database.CloseConnectionAsync();
+    }
+}
+```
+
+<a name="each"></a>
+
+### Each property uses independent in-memory integer key generation
+
+[Tracking Issue #6872](https://github.com/dotnet/efcore/issues/6872)
+
+#### Old behavior
+
+Before EF Core 3.0, one shared value generator was used for all in-memory integer key properties.
+
+#### New behavior
+
+Starting with EF Core 3.0, each integer key property gets its own value generator when using the in-memory database.
+Also, if the database is deleted, then key generation is reset for all tables.
+
+#### Why
+
+This change was made to align in-memory key generation more closely to real database key generation and to improve the ability to isolate tests from each other when using the in-memory database.
+
+#### Mitigations
+
+This can break an application that is relying on specific in-memory key values to be set.
+Consider instead not relying on specific key values, or updating to match the new behavior.
+
+### Backing fields are used by default
+
+[Tracking Issue #12430](https://github.com/dotnet/efcore/issues/12430)
+
+#### Old behavior
+
+Before 3.0, even if the backing field for a property was known, EF Core would still by default read and write the property value using the property getter and setter methods.
+The exception to this was query execution, where the backing field would be set directly if known.
+
+#### New behavior
+
+Starting with EF Core 3.0, if the backing field for a property is known, then EF Core will always read and write that property using the backing field.
+This could cause an application break if the application is relying on additional behavior coded into the getter or setter methods.
+
+#### Why
+
+This change was made to prevent EF Core from erroneously triggering business logic by default when performing database operations involving the entities.
+
+#### Mitigations
+
+The pre-3.0 behavior can be restored through configuration of the property access mode on `ModelBuilder`.
+For example:
+
+```csharp
+modelBuilder.UsePropertyAccessMode(PropertyAccessMode.PreferFieldDuringConstruction);
+```
+
+### Throw if multiple compatible backing fields are found
+
+[Tracking Issue #12523](https://github.com/dotnet/efcore/issues/12523)
+
+#### Old behavior
+
+Before EF Core 3.0, if multiple fields matched the rules for finding the backing field of a property, then one field would be chosen based on some precedence order.
+This could cause the wrong field to be used in ambiguous cases.
+
+#### New behavior
+
+Starting with EF Core 3.0, if multiple fields are matched to the same property, then an exception is thrown.
+
+#### Why
+
+This change was made to avoid silently using one field over another when only one can be correct.
+
+#### Mitigations
+
+Properties with ambiguous backing fields must have the field to use specified explicitly.
+For example, using the fluent API:
+
+```csharp
+modelBuilder
+    .Entity<Blog>()
+    .Property(e => e.Id)
+    .HasField("_id");
+```
+
+### Field-only property names should match the field name
+
+#### Old behavior
+
+Before EF Core 3.0, a property could be specified by a string value and if no property with that name was found on the .NET type then EF Core would try to match it to a field using convention rules.
+
+```csharp
+private class Blog
+{
+    private int _id;
+    public string Name { get; set; }
+}
+```
+
+```csharp
+modelBuilder
+    .Entity<Blog>()
+    .Property("Id");
+```
+
+#### New behavior
+
+Starting with EF Core 3.0, a field-only property must match the field name exactly.
+
+```csharp
+modelBuilder
+    .Entity<Blog>()
+    .Property("_id");
+```
+
+#### Why
+
+This change was made to avoid using the same field for two properties named similarly, it also makes the matching rules for field-only properties the same as for properties mapped to CLR properties.
+
+#### Mitigations
+
+Field-only properties must be named the same as the field they are mapped to.
+In a future release of EF Core after 3.0, we plan to re-enable explicitly configuring a field name that is different from the property name (see issue [#15307](https://github.com/dotnet/efcore/issues/15307)):
+
+```csharp
+modelBuilder
+    .Entity<Blog>()
+    .Property("Id")
+    .HasField("_id");
+```
+
+<a name="adddbc"></a>
+
+### AddDbContext/AddDbContextPool no longer call AddLogging and AddMemoryCache
+
+[Tracking Issue #14756](https://github.com/dotnet/efcore/issues/14756)
+
+#### Old behavior
+
+Before EF Core 3.0, calling `AddDbContext` or `AddDbContextPool` would also register logging and memory caching services with DI through calls to [AddLogging](/dotnet/api/microsoft.extensions.dependencyinjection.loggingservicecollectionextensions.addlogging) and [AddMemoryCache](/dotnet/api/microsoft.extensions.dependencyinjection.memorycacheservicecollectionextensions.addmemorycache).
+
+#### New behavior
+
+Starting with EF Core 3.0, `AddDbContext` and `AddDbContextPool` will no longer register these services with Dependency Injection (DI).
+
+#### Why
+
+EF Core 3.0 does not require that these services are in the application's DI container. However, if `ILoggerFactory` is registered in the application's DI container, then it will still be used by EF Core.
+
+#### Mitigations
+
+If your application needs these services, then register them explicitly with the DI container using  [AddLogging](/dotnet/api/microsoft.extensions.dependencyinjection.loggingservicecollectionextensions.addlogging) or [AddMemoryCache](/dotnet/api/microsoft.extensions.dependencyinjection.memorycacheservicecollectionextensions.addmemorycache).
+
+### AddEntityFramework* adds IMemoryCache with a size limit
+
+[Tracking Issue #12905](https://github.com/dotnet/efcore/issues/12905)
+
+#### Old behavior
+
+Before EF Core 3.0, calling `AddEntityFramework*` methods would also register memory caching services with DI without a size limit.
+
+#### New behavior
+
+Starting with EF Core 3.0, `AddEntityFramework*` will register an IMemoryCache service with a size limit. If any other services added afterwards depend on IMemoryCache they can quickly reach the default limit causing exceptions or degraded performance.
+
+#### Why
+
+Using IMemoryCache without a limit could result in uncontrolled memory usage if there is a bug in query caching logic or the queries are generated dynamically. Having a default limit mitigates a potential DoS attack.
+
+#### Mitigations
+
+In most cases calling `AddEntityFramework*` is not necessary if `AddDbContext` or `AddDbContextPool` is called as well. Therefore, the best mitigation is to remove the `AddEntityFramework*` call.
+
+If your application needs these services, then register a IMemoryCache implementation explicitly with the DI container beforehand using [AddMemoryCache](/dotnet/api/microsoft.extensions.dependencyinjection.memorycacheservicecollectionextensions.addmemorycache).
+
+<a name="dbe"></a>
+
+### DbContext.Entry now performs a local DetectChanges
+
+[Tracking Issue #13552](https://github.com/dotnet/efcore/issues/13552)
+
+#### Old behavior
+
+Before EF Core 3.0, calling `DbContext.Entry` would cause changes to be detected for all tracked entities.
+This ensured that the state exposed in the `EntityEntry` was up-to-date.
+
+#### New behavior
+
+Starting with EF Core 3.0, calling `DbContext.Entry` will now only attempt to detect changes in the given entity and any tracked principal entities related to it.
+This means that changes elsewhere may not have been detected by calling this method, which could have implications on application state.
+
+Note that if `ChangeTracker.AutoDetectChangesEnabled` is set to `false` then even this local change detection will be disabled.
+
+Other methods that cause change detection--for example `ChangeTracker.Entries` and `SaveChanges`--still cause a full `DetectChanges` of all tracked entities.
+
+#### Why
+
+This change was made to improve the default performance of using `context.Entry`.
+
+#### Mitigations
+
+Call `ChangeTracker.DetectChanges()` explicitly before calling `Entry` to ensure the pre-3.0 behavior.
+
+### String and byte array keys are not client-generated by default
+
+[Tracking Issue #14617](https://github.com/dotnet/efcore/issues/14617)
+
+#### Old behavior
+
+Before EF Core 3.0, `string` and `byte[]` key properties could be used without explicitly setting a non-null value.
+In such a case, the key value would be generated on the client as a GUID, serialized to bytes for `byte[]`.
+
+#### New behavior
+
+Starting with EF Core 3.0 an exception will be thrown indicating that no key value has been set.
+
+#### Why
+
+This change was made because client-generated `string`/`byte[]` values generally aren't useful, and the default behavior made it hard to reason about generated key values in a common way.
+
+#### Mitigations
+
+The pre-3.0 behavior can be obtained by explicitly specifying that the key properties should use generated values if no other non-null value is set.
+For example, with the fluent API:
+
+```csharp
+modelBuilder
+    .Entity<Blog>()
+    .Property(e => e.Id)
+    .ValueGeneratedOnAdd();
+```
+
+Or with data annotations:
+
+```csharp
+[DatabaseGenerated(DatabaseGeneratedOption.Identity)]
+public string Id { get; set; }
+```
+
+<a name="ilf"></a>
+
+### ILoggerFactory is now a scoped service
+
+[Tracking Issue #14698](https://github.com/dotnet/efcore/issues/14698)
+
+#### Old behavior
+
+Before EF Core 3.0, `ILoggerFactory` was registered as a singleton service.
+
+#### New behavior
+
+Starting with EF Core 3.0, `ILoggerFactory` is now registered as scoped.
+
+#### Why
+
+This change was made to allow association of a logger with a `DbContext` instance, which enables other functionality and removes some cases of pathological behavior such as an explosion of internal service providers.
+
+#### Mitigations
+
+This change should not impact application code unless it is registering and using custom services on the EF Core internal service provider.
+This isn't common.
+In these cases, most things will still work, but any singleton service that was depending on `ILoggerFactory` will need to be changed to obtain the `ILoggerFactory` in a different way.
+
+If you run into situations like this, please file an issue at on the [EF Core GitHub issue tracker](https://github.com/dotnet/efcore/issues) to let us know how you are using `ILoggerFactory` such that we can better understand how not to break this again in the future.
+
+### Lazy-loading proxies no longer assume navigation properties are fully loaded
+
+[Tracking Issue #12780](https://github.com/dotnet/efcore/issues/12780)
+
+#### Old behavior
+
+Before EF Core 3.0, once a `DbContext` was disposed there was no way of knowing if a given navigation property on an entity obtained from that context was fully loaded or not.
+Proxies would instead assume that a reference navigation is loaded if it has a non-null value, and that a collection navigation is loaded if it isn't empty.
+In these cases, attempting to lazy-load would be a no-op.
+
+#### New behavior
+
+Starting with EF Core 3.0, proxies keep track of whether or not a navigation property is loaded.
+This means attempting to access a navigation property that is loaded after the context has been disposed will always be a no-op, even when the loaded navigation is empty or null.
+Conversely, attempting to access a navigation property that isn't loaded will throw an exception if the context is disposed even if the navigation property is a non-empty collection.
+If this situation arises, it means the application code is attempting to use lazy-loading at an invalid time, and the application should be changed to not do this.
+
+#### Why
+
+This change was made to make the behavior consistent and correct when attempting to lazy-load on a disposed `DbContext` instance.
+
+#### Mitigations
+
+Update application code to not attempt lazy-loading with a disposed context, or configure this to be a no-op as described in the exception message.
+
+### Excessive creation of internal service providers is now an error by default
+
+[Tracking Issue #10236](https://github.com/dotnet/efcore/issues/10236)
+
+#### Old behavior
+
+Before EF Core 3.0, a warning would be logged for an application creating a pathological number of internal service providers.
+
+#### New behavior
+
+Starting with EF Core 3.0, this warning is now considered and error and an exception is thrown.
+
+#### Why
+
+This change was made to drive better application code through exposing this pathological case more explicitly.
+
+#### Mitigations
+
+The most appropriate cause of action on encountering this error is to understand the root cause and stop creating so many internal service providers.
+However, the error can be converted back to a warning (or ignored) via configuration on the `DbContextOptionsBuilder`.
+For example:
+
+```csharp
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+{
+    optionsBuilder
+        .ConfigureWarnings(w => w.Log(CoreEventId.ManyServiceProvidersCreatedWarning));
+}
+```
+
+<a name="nbh"></a>
+
+### New behavior for HasOne/HasMany called with a single string
+
+[Tracking Issue #9171](https://github.com/dotnet/efcore/issues/9171)
+
+#### Old behavior
+
+Before EF Core 3.0, code calling `HasOne` or `HasMany` with a single string was interpreted in a confusing way.
+For example:
+
+```csharp
+modelBuilder.Entity<Samurai>().HasOne("Entrance").WithOne();
+```
+
+The code looks like it is relating `Samurai` to some other entity type using the `Entrance` navigation property, which may be private.
+
+In reality, this code attempts to create a relationship to some entity type called `Entrance` with no navigation property.
+
+#### New behavior
+
+Starting with EF Core 3.0, the code above now does what it looked like it should have been doing before.
+
+#### Why
+
+The old behavior was very confusing, especially when reading the configuration code and looking for errors.
+
+#### Mitigations
+
+This will only break applications that are explicitly configuring relationships using strings for type names and without specifying the navigation property explicitly.
+This is not common.
+The previous behavior can be obtained through explicitly passing `null` for the navigation property name.
+For example:
+
+```csharp
+modelBuilder.Entity<Samurai>().HasOne("Some.Entity.Type.Name", null).WithOne();
+```
+
+<a name="rtnt"></a>
+
+### The return type for several async methods has been changed from Task to ValueTask
+
+[Tracking Issue #15184](https://github.com/dotnet/efcore/issues/15184)
+
+#### Old behavior
+
+The following async methods previously returned a `Task<T>`:
+
+* `DbContext.FindAsync()`
+* `DbSet.FindAsync()`
+* `DbContext.AddAsync()`
+* `DbSet.AddAsync()`
+* `ValueGenerator.NextValueAsync()` (and deriving classes)
+
+#### New behavior
+
+The aforementioned methods now return a `ValueTask<T>` over the same `T` as before.
+
+#### Why
+
+This change reduces the number of heap allocations incurred when invoking these methods, improving general performance.
+
+#### Mitigations
+
+Applications simply awaiting the above APIs only need to be recompiled - no source changes are necessary.
+A more complex usage (e.g. passing the returned `Task` to `Task.WhenAny()`) typically require that the returned `ValueTask<T>` be converted to a `Task<T>` by calling `AsTask()` on it.
+Note that this negates the allocation reduction that this change brings.
+
+<a name="rtt"></a>
+
+### The Relational:TypeMapping annotation is now just TypeMapping
+
+[Tracking Issue #9913](https://github.com/dotnet/efcore/issues/9913)
+
+#### Old behavior
+
+The annotation name for type mapping annotations was "Relational:TypeMapping".
+
+#### New behavior
+
+The annotation name for type mapping annotations is now "TypeMapping".
+
+#### Why
+
+Type mappings are now used for more than just relational database providers.
+
+#### Mitigations
+
+This will only break applications that access the type mapping directly as an annotation, which isn't common.
+The most appropriate action to fix is to use API surface to access type mappings rather than using the annotation directly.
+
+### ToTable on a derived type throws an exception
+
+[Tracking Issue #11811](https://github.com/dotnet/efcore/issues/11811)
+
+#### Old behavior
+
+Before EF Core 3.0, `ToTable()` called on a derived type would be ignored since only inheritance mapping strategy was TPH where this isn't valid.
+
+#### New behavior
+
+Starting with EF Core 3.0 and in preparation for adding TPT and TPC support in a later release, `ToTable()` called on a derived type will now throw an exception to avoid an unexpected mapping change in the future.
+
+#### Why
+
+Currently it isn't valid to map a derived type to a different table.
+This change avoids breaking in the future when it becomes a valid thing to do.
+
+#### Mitigations
+
+Remove any attempts to map derived types to other tables.
+
+### ForSqlServerHasIndex replaced with HasIndex
+
+[Tracking Issue #12366](https://github.com/dotnet/efcore/issues/12366)
+
+#### Old behavior
+
+Before EF Core 3.0, `ForSqlServerHasIndex().ForSqlServerInclude()` provided a way to configure columns used with `INCLUDE`.
+
+#### New behavior
+
+Starting with EF Core 3.0, using `Include` on an index is now supported at the relational level.
+Use `HasIndex().ForSqlServerInclude()`.
+
+#### Why
+
+This change was made to consolidate the API for indexes with `Include` into one place for all database providers.
+
+#### Mitigations
+
+Use the new API, as shown above.
+
+### Metadata API changes
+
+[Tracking Issue #214](https://github.com/dotnet/efcore/issues/214)
+
+#### New behavior
+
+The following properties were converted to extension methods:
+
+* `IEntityType.QueryFilter` -> `GetQueryFilter()`
+* `IEntityType.DefiningQuery` -> `GetDefiningQuery()`
+* `IProperty.IsShadowProperty` -> `IsShadowProperty()`
+* `IProperty.BeforeSaveBehavior` -> `GetBeforeSaveBehavior()`
+* `IProperty.AfterSaveBehavior` -> `GetAfterSaveBehavior()`
+
+#### Why
+
+This change simplifies the implementation of the aforementioned interfaces.
+
+#### Mitigations
+
+Use the new extension methods.
+
+<a name="provider"></a>
+
+### Provider-specific Metadata API changes
+
+[Tracking Issue #214](https://github.com/dotnet/efcore/issues/214)
+
+#### New behavior
+
+The provider-specific extension methods will be flattened out:
+
+* `IProperty.Relational().ColumnName` -> `IProperty.GetColumnName()`
+* `IEntityType.SqlServer().IsMemoryOptimized` -> `IEntityType.IsMemoryOptimized()`
+* `PropertyBuilder.UseSqlServerIdentityColumn()` -> `PropertyBuilder.UseIdentityColumn()`
+
+#### Why
+
+This change simplifies the implementation of the aforementioned extension methods.
+
+#### Mitigations
+
+Use the new extension methods.
+
+<a name="pragma"></a>
+
+### EF Core no longer sends pragma for SQLite FK enforcement
+
+[Tracking Issue #12151](https://github.com/dotnet/efcore/issues/12151)
+
+#### Old behavior
+
+Before EF Core 3.0, EF Core would send `PRAGMA foreign_keys = 1` when a connection to SQLite is opened.
+
+#### New behavior
+
+Starting with EF Core 3.0, EF Core no longer sends `PRAGMA foreign_keys = 1` when a connection to SQLite is opened.
+
+#### Why
+
+This change was made because EF Core uses `SQLitePCLRaw.bundle_e_sqlite3` by default, which in turn means that FK enforcement is switched on by default and doesn't need to be explicitly enabled each time a connection is opened.
+
+#### Mitigations
+
+Foreign keys are enabled by default in SQLitePCLRaw.bundle_e_sqlite3, which is used by default for EF Core.
+For other cases, foreign keys can be enabled by specifying `Foreign Keys=True` in your connection string.
+
+<a name="sqlite3"></a>
+
+### Microsoft.EntityFrameworkCore.Sqlite now depends on SQLitePCLRaw.bundle_e_sqlite3
+
+#### Old behavior
+
+Before EF Core 3.0, EF Core used `SQLitePCLRaw.bundle_green`.
+
+#### New behavior
+
+Starting with EF Core 3.0, EF Core uses `SQLitePCLRaw.bundle_e_sqlite3`.
+
+#### Why
+
+This change was made so that the version of SQLite used on iOS consistent with other platforms.
+
+#### Mitigations
+
+To use the native SQLite version on iOS, configure `Microsoft.Data.Sqlite` to use a different `SQLitePCLRaw` bundle.
+
+<a name="guid"></a>
+
+### Guid values are now stored as TEXT on SQLite
+
+[Tracking Issue #15078](https://github.com/dotnet/efcore/issues/15078)
+
+#### Old behavior
+
+Guid values were previously stored as BLOB values on SQLite.
+
+#### New behavior
+
+Guid values are now stored as TEXT.
+
+#### Why
+
+The binary format of Guids is not standardized. Storing the values as TEXT makes the database more compatible with other technologies.
+
+#### Mitigations
+
+You can migrate existing databases to the new format by executing SQL like the following.
+
+```sql
+UPDATE MyTable
+SET GuidColumn = hex(substr(GuidColumn, 4, 1)) ||
+                 hex(substr(GuidColumn, 3, 1)) ||
+                 hex(substr(GuidColumn, 2, 1)) ||
+                 hex(substr(GuidColumn, 1, 1)) || '-' ||
+                 hex(substr(GuidColumn, 6, 1)) ||
+                 hex(substr(GuidColumn, 5, 1)) || '-' ||
+                 hex(substr(GuidColumn, 8, 1)) ||
+                 hex(substr(GuidColumn, 7, 1)) || '-' ||
+                 hex(substr(GuidColumn, 9, 2)) || '-' ||
+                 hex(substr(GuidColumn, 11, 6))
+WHERE typeof(GuidColumn) == 'blob';
+```
+
+In EF Core, you could also continue using the previous behavior by configuring a value converter on these properties.
+
+```csharp
+modelBuilder
+    .Entity<MyEntity>()
+    .Property(e => e.GuidProperty)
+    .HasConversion(
+        g => g.ToByteArray(),
+        b => new Guid(b));
+```
+
+Microsoft.Data.Sqlite remains capable of reading Guid values from both BLOB and TEXT columns; however, since the default format for parameters and constants has changed you'll likely need to take action for most scenarios involving Guids.
+
+<a name="char"></a>
+
+### Char values are now stored as TEXT on SQLite
+
+[Tracking Issue #15020](https://github.com/dotnet/efcore/issues/15020)
+
+#### Old behavior
+
+Char values were previously stored as INTEGER values on SQLite. For example, a char value of _A_ was stored as the integer value 65.
+
+#### New behavior
+
+Char values are now stored as TEXT.
+
+#### Why
+
+Storing the values as TEXT is more natural and makes the database more compatible with other technologies.
+
+#### Mitigations
+
+You can migrate existing databases to the new format by executing SQL like the following.
+
+```sql
+UPDATE MyTable
+SET CharColumn = char(CharColumn)
+WHERE typeof(CharColumn) = 'integer';
+```
+
+In EF Core, you could also continue using the previous behavior by configuring a value converter on these properties.
+
+```csharp
+modelBuilder
+    .Entity<MyEntity>()
+    .Property(e => e.CharProperty)
+    .HasConversion(
+        c => (long)c,
+        i => (char)i);
+```
+
+Microsoft.Data.Sqlite also remains capable of reading character values from both INTEGER and TEXT columns, so certain scenarios may not require any action.
+
+<a name="migid"></a>
+
+### Migration IDs are now generated using the invariant culture's calendar
+
+[Tracking Issue #12978](https://github.com/dotnet/efcore/issues/12978)
+
+#### Old behavior
+
+Migration IDs were inadvertently generated using the current culture's calendar.
+
+#### New behavior
+
+Migration IDs are now always generated using the invariant culture's calendar (Gregorian).
+
+#### Why
+
+The order of migrations is important when updating the database or resolving merge conflicts. Using the invariant calendar avoids ordering issues that can result from team members having different system calendars.
+
+#### Mitigations
+
+This change affects anyone using a non-Gregorian calendar where the year is greater than the Gregorian calendar (like the Thai Buddhist calendar). Existing migration IDs will need to be updated so that new migrations are ordered after existing migrations.
+
+The migration ID can be found in the Migration attribute in the migrations' designer files.
+
+```diff
+ [DbContext(typeof(MyDbContext))]
+-[Migration("25620318122820_MyMigration")]
++[Migration("20190318122820_MyMigration")]
+ partial class MyMigration
+ {
+```
+
+The Migrations history table also needs to be updated.
+
+```sql
+UPDATE __EFMigrationsHistory
+SET MigrationId = CONCAT(LEFT(MigrationId, 4)  - 543, SUBSTRING(MigrationId, 4, 150))
+```
+
+<a name="urn"></a>
+
+### UseRowNumberForPaging has been removed
+
+[Tracking Issue #16400](https://github.com/dotnet/efcore/issues/16400)
+
+#### Old behavior
+
+Before EF Core 3.0, `UseRowNumberForPaging` could be used to generate SQL for paging that is compatible with SQL Server 2008.
+
+#### New behavior
+
+Starting with EF Core 3.0, EF will only generate SQL for paging that is only compatible with later SQL Server versions.
+
+#### Why
+
+We are making this change because [SQL Server 2008 is no longer a supported product](https://blogs.msdn.microsoft.com/sqlreleaseservices/end-of-mainstream-support-for-sql-server-2008-and-sql-server-2008-r2/) and updating this feature to work with the query changes made in EF Core 3.0 is significant work.
+
+#### Mitigations
+
+We recommend updating to a newer version of SQL Server, or using a higher compatibility level, so that the generated SQL is supported. That being said, if you are unable to do this, then please [comment on the tracking issue](https://github.com/dotnet/efcore/issues/16400) with details. We may revisit this decision based on feedback.
+
+<a name="xinfo"></a>
+
+### Extension info/metadata has been removed from IDbContextOptionsExtension
+
+[Tracking Issue #16119](https://github.com/dotnet/efcore/issues/16119)
+
+#### Old behavior
+
+`IDbContextOptionsExtension` contained methods for providing metadata about the extension.
+
+#### New behavior
+
+These methods have been moved onto a new `DbContextOptionsExtensionInfo` abstract base class, which is returned from a new `IDbContextOptionsExtension.Info` property.
+
+#### Why
+
+Over the releases from 2.0 to 3.0 we needed to add to or change these methods several times.
+Breaking them out into a new abstract base class will make it easier to make these kind of changes without breaking existing extensions.
+
+#### Mitigations
+
+Update extensions to follow the new pattern.
+Examples are found in the many implementations of `IDbContextOptionsExtension` for different kinds of extensions in the EF Core source code.
+
+<a name="lqpe"></a>
+
+### LogQueryPossibleExceptionWithAggregateOperator has been renamed
+
+[Tracking Issue #10985](https://github.com/dotnet/efcore/issues/10985)
+
+#### Change
+
+`RelationalEventId.LogQueryPossibleExceptionWithAggregateOperator` has been renamed to `RelationalEventId.LogQueryPossibleExceptionWithAggregateOperatorWarning`.
+
+#### Why
+
+Aligns the naming of this warning event with all other warning events.
+
+#### Mitigations
+
+Use the new name. (Note that the event ID number has not changed.)
+
+<a name="clarify"></a>
+
+### Clarify API for foreign key constraint names
+
+[Tracking Issue #10730](https://github.com/dotnet/efcore/issues/10730)
+
+#### Old behavior
+
+Before EF Core 3.0, foreign key constraint names were referred to as simply the "name". For example:
+
+```csharp
+var constraintName = myForeignKey.Name;
+```
+
+#### New behavior
+
+Starting with EF Core 3.0, foreign key constraint names are now referred to as the "constraint name". For example:
+
+```csharp
+var constraintName = myForeignKey.ConstraintName;
+```
+
+#### Why
+
+This change brings consistency to naming in this area, and also clarifies that this is the name of the foreign key constraint, and not the column or property name that the foreign key is defined on.
+
+#### Mitigations
+
+Use the new name.
+
+<a name="irdc2"></a>
+
+### IRelationalDatabaseCreator.HasTables/HasTablesAsync have been made public
+
+[Tracking Issue #15997](https://github.com/dotnet/efcore/issues/15997)
+
+#### Old behavior
+
+Before EF Core 3.0, these methods were protected.
+
+#### New behavior
+
+Starting with EF Core 3.0, these methods are public.
+
+#### Why
+
+These methods are used by EF to determine if a database is created but empty. This can also be useful from outside EF when determining whether or not to apply migrations.
+
+#### Mitigations
+
+Change the accessibility of any overrides.
+
+<a name="dip"></a>
+
+### Microsoft.EntityFrameworkCore.Design is now a DevelopmentDependency package
+
+[Tracking Issue #11506](https://github.com/dotnet/efcore/issues/11506)
+
+#### Old behavior
+
+Before EF Core 3.0, Microsoft.EntityFrameworkCore.Design was a regular NuGet package whose assembly could be referenced by projects that depended on it.
+
+#### New behavior
+
+Starting with EF Core 3.0, it is a DevelopmentDependency package. This means that the dependency won't flow transitively into other projects, and that you can no longer, by default, reference its assembly.
+
+#### Why
+
+This package is only intended to be used at design time. Deployed applications shouldn't reference it. Making the package a DevelopmentDependency reinforces this recommendation.
+
+#### Mitigations
+
+If you need to reference this package to override EF Core's design-time behavior, then you can update PackageReference item metadata in your project.
+
+```xml
+<PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="3.0.0">
+  <PrivateAssets>all</PrivateAssets>
+  <!-- Remove IncludeAssets to allow compiling against the assembly -->
+  <!--<IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>-->
+</PackageReference>
+```
+
+If the package is being referenced transitively via Microsoft.EntityFrameworkCore.Tools, you will need to add an explicit PackageReference to the package to change its metadata. Such an explicit reference must be added to any project where the types from the package are needed.
+
+<a name="SQLitePCL"></a>
+
+### SQLitePCL.raw updated to version 2.0.0
+
+[Tracking Issue #14824](https://github.com/dotnet/efcore/issues/14824)
+
+#### Old behavior
+
+Microsoft.EntityFrameworkCore.Sqlite previously depended on version 1.1.12 of SQLitePCL.raw.
+
+#### New behavior
+
+We've updated our package to depend on version 2.0.0.
+
+#### Why
+
+Version 2.0.0 of SQLitePCL.raw targets .NET Standard 2.0. It previously targeted .NET Standard 1.1 which required a large closure of transitive packages to work.
+
+#### Mitigations
+
+SQLitePCL.raw version 2.0.0 includes some breaking changes. See the [release notes](https://github.com/ericsink/SQLitePCL.raw/blob/v2/v2.md) for details.
+
+<a name="NetTopologySuite"></a>
+
+### NetTopologySuite updated to version 2.0.0
+
+[Tracking Issue #14825](https://github.com/dotnet/efcore/issues/14825)
+
+#### Old behavior
+
+The spatial packages previously depended on version 1.15.1 of NetTopologySuite.
+
+#### New behavior
+
+We've update our package to depend on version 2.0.0.
+
+#### Why
+
+Version 2.0.0 of NetTopologySuite aims to address several usability issues encountered by EF Core users.
+
+#### Mitigations
+
+NetTopologySuite version 2.0.0 includes some breaking changes. See the [release notes](https://www.nuget.org/packages/NetTopologySuite/2.0.0-pre001) for details.
+
+<a name="SqlClient"></a>
+
+### Microsoft.Data.SqlClient is used instead of System.Data.SqlClient
+
+[Tracking Issue #15636](https://github.com/dotnet/efcore/issues/15636)
+
+#### Old behavior
+
+Microsoft.EntityFrameworkCore.SqlServer previously depended on System.Data.SqlClient.
+
+#### New behavior
+
+We've updated our package to depend on Microsoft.Data.SqlClient.
+
+#### Why
+
+Microsoft.Data.SqlClient is the flagship data access driver for SQL Server going forward, and System.Data.SqlClient no longer be the focus of development.
+Some important features, such as Always Encrypted, are only available on Microsoft.Data.SqlClient.
+
+#### Mitigations
+
+If your code takes a direct dependency on System.Data.SqlClient, you must change it to reference Microsoft.Data.SqlClient instead; as the two packages maintain a very high degree
+of API compatibility, this should only be a simple package and namespace change.
+
+<a name="mersa"></a>
+
+### Multiple ambiguous self-referencing relationships must be configured
+
+[Tracking Issue #13573](https://github.com/dotnet/efcore/issues/13573)
+
+#### Old behavior
+
+An entity type with multiple self-referencing uni-directional navigation properties and matching FKs was incorrectly configured as a single relationship. For example:
+
+```csharp
+public class User
+{
+        public Guid Id { get; set; }
+        public User CreatedBy { get; set; }
+        public User UpdatedBy { get; set; }
+        public Guid CreatedById { get; set; }
+        public Guid? UpdatedById { get; set; }
+}
+```
+
+#### New behavior
+
+This scenario is now detected in model building and an exception is thrown indicating that the model is ambiguous.
+
+#### Why
+
+The resultant model was ambiguous and will likely usually be wrong for this case.
+
+#### Mitigations
+
+Use full configuration of the relationship. For example:
+
+```csharp
+modelBuilder
+     .Entity<User>()
+     .HasOne(e => e.CreatedBy)
+     .WithMany();
+
+ modelBuilder
+     .Entity<User>()
+     .HasOne(e => e.UpdatedBy)
+     .WithMany();
+```
+
+<a name="udf-empty-string"></a>
+
+### DbFunction.Schema being null or empty string configures it to be in model's default schema
+
+[Tracking Issue #12757](https://github.com/dotnet/efcore/issues/12757)
+
+#### Old behavior
+
+A DbFunction configured with schema as an empty string was treated as built-in function without a schema. For example following code will map `DatePart` CLR function to `DATEPART` built-in function on SqlServer.
+
+```csharp
+[DbFunction("DATEPART", Schema = "")]
+public static int? DatePart(string datePartArg, DateTime? date) => throw new Exception();
+
+```
+
+#### New behavior
+
+All DbFunction mappings are considered to be mapped to user defined functions. Hence empty string value would put the function inside the default schema for the model. Which could be the schema configured explicitly via fluent API `modelBuilder.HasDefaultSchema()` or `dbo` otherwise.
+
+#### Why
+
+Previously schema being empty was a way to treat that function is built-in but that logic is only applicable for SqlServer where built-in functions do not belong to any schema.
+
+#### Mitigations
+
+Configure DbFunction's translation manually to map it to a built-in function.
+
+```csharp
+modelBuilder
+    .HasDbFunction(typeof(MyContext).GetMethod(nameof(MyContext.DatePart)))
+    .HasTranslation(args => SqlFunctionExpression.Create("DatePart", args, typeof(int?), null));
+```
+
+<a name="netstandard21"></a>
+
+### ~~EF Core 3.0 targets .NET Standard 2.1 rather than .NET Standard 2.0~~ Reverted
+
+[Tracking Issue #15498](https://github.com/dotnet/efcore/issues/15498)
+
+EF Core 3.0 targets .NET Standard 2.1, which is a breaking change which excludes .NET Framework applications. EF Core 3.1 reverted this and targets .NET Standard 2.0 again.
+
+<a name="qe"></a>
+
+### ~~Query execution is logged at Debug level~~ Reverted
+
+[Tracking Issue #14523](https://github.com/dotnet/efcore/issues/14523)
+
+We reverted this change because new configuration in EF Core 3.0 allows the log level for any event to be specified by the application. For example, to switch logging of SQL to `Debug`, explicitly configure the level in `OnConfiguring` or `AddDbContext`:
+
+```csharp
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    => optionsBuilder
+        .UseSqlServer(connectionString)
+        .ConfigureWarnings(c => c.Log((RelationalEventId.CommandExecuting, LogLevel.Debug)));
+```
diff --git a/entity-framework/core/what-is-new/ef-core-3.x/index.md b/entity-framework/core/what-is-new/ef-core-3.x/index.md
new file mode 100644
index 0000000000..94d8f6e9a6
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-3.x/index.md
@@ -0,0 +1,202 @@
+---
+title: New features in Entity Framework Core 3.x - EF Core
+description: Changes and improvements in Entity Framework Core 3.x
+author: SamMonoRT
+ms.date: 09/05/2020
+uid: core/what-is-new/ef-core-3.x/index
+ms.custom: sfi-ropc-nochange
+---
+
+# New features in Entity Framework Core 3.x
+
+The following list includes the major new features in EF Core 3.x
+
+As a major release, EF Core 3.x also contains several [breaking changes](xref:core/what-is-new/ef-core-3.x/breaking-changes), which are API improvements that may have negative impact on existing applications.
+
+## LINQ overhaul
+
+LINQ enables you to write database queries using your .NET language of choice, taking advantage of rich type information to offer IntelliSense and compile-time type checking.
+But LINQ also enables you to write an unlimited number of complicated queries containing arbitrary expressions (method calls or operations).
+How to handle all those combinations is the main challenge for LINQ providers.
+
+In EF Core 3.x, we rearchitected our LINQ provider to enable translating more query patterns into SQL, generating efficient queries in more cases, and preventing inefficient queries from going undetected. The new LINQ provider is the foundation over which we'll be able to offer new query capabilities and performance improvements in future releases, without breaking existing applications and data providers.
+
+### Restricted client evaluation
+
+The most important design change has to do with how we handle LINQ expressions that cannot be converted to parameters or translated to SQL.
+
+In previous versions, EF Core identified what portions of a query could be translated to SQL, and executed the rest of the query on the client.
+This type of client-side execution is desirable in some situations, but in many other cases it can result in inefficient queries.
+
+For example, if EF Core 2.2 couldn't translate a predicate in a `Where()` call, it executed an SQL statement without a filter, transferred all the rows from the database, and then filtered them in-memory:
+
+```csharp
+var specialCustomers = context.Customers
+    .Where(c => c.Name.StartsWith(n) && IsSpecialCustomer(c));
+```
+
+That may be acceptable if the database contains a small number of rows but can result in significant performance issues or even application failure if the database contains a large number of rows.
+
+In EF Core 3.x, we've restricted client evaluation to only happen on the top-level projection (essentially, the last call to `Select()`).
+When EF Core 3.x detects expressions that can't be translated anywhere else in the query, it throws a runtime exception.
+
+To evaluate a predicate condition on the client as in the previous example, developers now need to explicitly switch evaluation of the query to LINQ to Objects:
+
+```csharp
+var specialCustomers = context.Customers
+    .Where(c => c.Name.StartsWith(n))
+    .AsEnumerable() // switches to LINQ to Objects
+    .Where(c => IsSpecialCustomer(c));
+```
+
+See the [breaking changes documentation](xref:core/what-is-new/ef-core-3.x/breaking-changes#linq-queries-are-no-longer-evaluated-on-the-client) for more details about how this can affect existing applications.
+
+### Single SQL statement per LINQ query
+
+Another aspect of the design that changed significantly in 3.x is that we now always generate a single SQL statement per LINQ query. In previous versions, we used to generate multiple SQL statements in certain cases, translated `Include()` calls on collection navigation properties and translated queries that followed certain patterns with subqueries. Although this was in some cases convenient, and for `Include()` it even helped avoid sending redundant data over the wire, the implementation was complex, and it resulted in some extremely inefficient behaviors (N+1 queries). There were situations in which the data returned across multiple queries was potentially inconsistent.
+
+Similarly to client evaluation, if EF Core 3.x can't translate a LINQ query into a single SQL statement, it throws a runtime exception. But we made EF Core capable of translating many of the common patterns that used to generate multiple queries to a single query with JOINs.
+
+## Azure Cosmos DB support
+
+The Azure Cosmos DB provider for EF Core enables developers familiar with the EF programming model to easily target Azure Cosmos DB as an application database. The goal is to make some of the advantages of Azure Cosmos DB, like global distribution, "always on" availability, elastic scalability, and low latency, even more accessible to .NET developers. The provider enables most EF Core features, like automatic change tracking, LINQ, and value conversions, against Azure Cosmos DB for NoSQL.
+
+See the [Azure Cosmos DB provider documentation](xref:core/providers/cosmos/index) for more details.
+
+## C# 8.0 support
+
+EF Core 3.x takes advantage of a couple of the [new features in C# 8.0](/dotnet/csharp/whats-new/csharp-8):
+
+### Asynchronous streams
+
+Asynchronous query results are now exposed using the new standard `IAsyncEnumerable<T>` interface and can be consumed using `await foreach`.
+
+```csharp
+var orders =
+    from o in context.Orders
+    where o.Status == OrderStatus.Pending
+    select o;
+
+await foreach(var o in orders.AsAsyncEnumerable())
+{
+    Process(o);
+}
+```
+
+See the [asynchronous streams in the C# documentation](/dotnet/csharp/whats-new/csharp-8#asynchronous-streams) for more details.
+
+### Nullable reference types
+
+When this new feature is enabled in your code, EF Core examines the nullability of reference type properties and applies it to corresponding columns and relationships in the database: properties of non-nullable references types are treated as if they had the `[Required]` data annotation attribute.
+
+For example, in the following class, properties marked as of type `string?` will be configured as optional, whereas `string` will be configured as required:
+
+```csharp
+public class Customer
+{
+    public int Id { get; set; }
+    public string FirstName { get; set; }
+    public string LastName { get; set; }
+    public string? MiddleName { get; set; }
+}
+```
+
+See [Working with nullable reference types](xref:core/miscellaneous/nullable-reference-types) in the EF Core documentation for more details.
+
+## Interception of database operations
+
+The new interception API in EF Core 3.x allows providing custom logic to be invoked automatically whenever low-level database operations occur as part of the normal operation of EF Core. For example, when opening connections, committing transactions, or executing commands.
+
+Similarly to the interception features that existed in EF 6, interceptors allow you to intercept operations before or after they happen. When you intercept them before they happen, you are allowed to by-pass execution and supply alternate results from the interception logic.
+
+For example, to manipulate command text, you can create a `DbCommandInterceptor`:
+
+```csharp
+public class HintCommandInterceptor : DbCommandInterceptor
+{
+    public override InterceptionResult<DbDataReader> ReaderExecuting(
+        DbCommand command,
+        CommandEventData eventData,
+        InterceptionResult<DbDataReader> result)
+    {
+        // Manipulate the command text, etc. here...
+        command.CommandText += " OPTION (OPTIMIZE FOR UNKNOWN)";
+        return result;
+    }
+}
+```
+
+And register it with your `DbContext`:
+
+```csharp
+services.AddDbContext(b => b
+    .UseSqlServer(connectionString)
+    .AddInterceptors(new HintCommandInterceptor()));
+```
+
+## Reverse engineering of database views
+
+Query types, which represent data that can be read from the database but not updated, have been renamed to [keyless entity types](xref:core/modeling/keyless-entity-types).
+As they are an excellent fit for mapping database views in most scenarios, EF Core now automatically creates keyless entity types when reverse engineering database views.
+
+For example, using the [dotnet ef command-line tool](xref:core/cli/dotnet) you can type:
+
+```dotnetcli
+dotnet ef dbcontext scaffold "Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;" Microsoft.EntityFrameworkCore.SqlServer
+```
+
+And the tool will now automatically scaffold types for views and tables without keys:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Names>(entity =>
+    {
+        entity.HasNoKey();
+        entity.ToView("Names");
+    });
+
+    modelBuilder.Entity<Things>(entity =>
+    {
+        entity.HasNoKey();
+    });
+}
+```
+
+## Dependent entities sharing the table with the principal are now optional
+
+Starting with EF Core 3.x, if `OrderDetails` is owned by `Order` or explicitly mapped to the same table, it will be possible to add an `Order` without an `OrderDetails` and all of the `OrderDetails` properties, except the primary key will be mapped to nullable columns.
+
+When querying, EF Core will set `OrderDetails` to `null` if any of its required properties doesn't have a value, or if it has no required properties besides the primary key and all properties are `null`.
+
+```csharp
+public class Order
+{
+    public int Id { get; set; }
+    public int CustomerId { get; set; }
+    public OrderDetails Details { get; set; }
+}
+
+[Owned]
+public class OrderDetails
+{
+    public int Id { get; set; }
+    public string ShippingAddress { get; set; }
+}
+```
+
+## EF 6.3 on .NET Core
+
+This isn't really an EF Core 3.x feature, but we think it is important to many of our current customers.
+
+We understand that many existing applications use previous versions of EF, and that porting them to EF Core only to take advantage of .NET can require a significant effort.
+For that reason, we decided to port the newest version of EF 6 to run on .NET Core 3.x.
+
+For more details, see [what's new in EF 6](xref:ef6/what-is-new/index).
+
+## Postponed features
+
+Some features originally planned for EF Core 3.x were postponed to future releases:
+
+- Ability to ignore parts of a model in migrations, tracked as [#2725](https://github.com/dotnet/efcore/issues/2725).
+- Property bag entities, tracked as two separate issues: [#9914](https://github.com/dotnet/efcore/issues/9914) about shared-type entities and [#13610](https://github.com/dotnet/efcore/issues/13610) about indexed property mapping support.
diff --git a/entity-framework/core/what-is-new/ef-core-5.0/breaking-changes.md b/entity-framework/core/what-is-new/ef-core-5.0/breaking-changes.md
new file mode 100644
index 0000000000..122e9a3c2c
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-5.0/breaking-changes.md
@@ -0,0 +1,701 @@
+---
+title: Breaking changes in EF Core 5.0 - EF Core
+description: Complete list of breaking changes introduced in Entity Framework Core 5.0
+author: SamMonoRT
+ms.date: 09/21/2022
+uid: core/what-is-new/ef-core-5.0/breaking-changes
+---
+
+# Breaking changes in EF Core 5.0
+
+The following API and behavior changes have the potential to break existing applications updating to EF Core 5.0.0.
+
+## Summary
+
+| **Breaking change**                                                                                                                   | **Impact** |
+|:--------------------------------------------------------------------------------------------------------------------------------------|------------|
+| [EF Core 5.0 does not support .NET Framework](#netstandard21)                                                                         | Medium     |
+| [IProperty.GetColumnName() is now obsolete](#getcolumnname-obsolete)                                                                  | Medium     |
+| [Precision and scale are required for decimals](#decimals)                                                                            | Medium     |
+| [Required or non-nullable navigation from principal to dependent has different semantics](#required-dependent)                        | Medium     |
+| [Defining query is replaced with provider-specific methods](#defining-query)                                                          | Medium     |
+| [Non-null reference navigations are not overwritten by queries](#nonnullreferences)                                                   | Medium     |
+| [ToView() is treated differently by migrations](#toview)                                                                              | Medium     |
+| [ToTable(null) marks the entity type as not mapped to a table](#totable)                                                              | Medium     |
+| [Removed HasGeometricDimension method from SQLite NTS extension](#geometric-sqlite)                                                   | Low        |
+| [Azure Cosmos DB: Partition key is now added to the primary key](#cosmos-partition-key)                                               | Low        |
+| [Azure Cosmos DB: `id` property renamed to `__id`](#cosmos-id)                                                                        | Low        |
+| [Azure Cosmos DB: byte[] is now stored as a base64 string instead of a number array](#cosmos-byte)                                    | Low        |
+| [Azure Cosmos DB: GetPropertyName and SetPropertyName were renamed](#cosmos-metadata)                                                 | Low        |
+| [Value generators are called when the entity state is changed from Detached to Unchanged, Updated, or Deleted](#non-added-generation) | Low        |
+| [IMigrationsModelDiffer now uses IRelationalModel](#relational-model)                                                                 | Low        |
+| [Discriminators are read-only](#read-only-discriminators)                                                                             | Low        |
+| [Provider-specific EF.Functions methods throw for in-memory provider](#no-client-methods)                                             | Low        |
+| [IndexBuilder.HasName is now obsolete](#index-obsolete)                                                                               | Low        |
+| [A pluralizer is now included for scaffolding reverse engineered models](#pluralizer)                                                 | Low        |
+| [INavigationBase replaces INavigation in some APIs to support skip navigations](#inavigationbase)                                     | Low        |
+| [Some queries with correlated collection that also use `Distinct` or `GroupBy` are no longer supported](#collection-distinct-groupby) | Low        |
+| [Using a collection of Queryable type in projection is not supported](#queryable-projection)                                          | Low        |
+
+## Medium-impact changes
+
+<a name="netstandard21"></a>
+
+### EF Core 5.0 does not support .NET Framework
+
+[Tracking Issue #15498](https://github.com/dotnet/efcore/issues/15498)
+
+#### Old behavior
+
+EF Core 3.1 targets .NET Standard 2.0, which is supported by .NET Framework.
+
+#### New behavior
+
+EF Core 5.0 targets .NET Standard 2.1, which is not supported by .NET Framework. This means EF Core 5.0 cannot be used with .NET Framework applications.
+
+#### Why
+
+This is part of the wider movement across .NET teams aimed at unification to a single .NET target framework. For more information see [the future of .NET Standard](https://devblogs.microsoft.com/dotnet/the-future-of-net-standard/).
+
+#### Mitigations
+
+.NET Framework applications can continue to use EF Core 3.1, which is a [long-term support (LTS) release](https://dotnet.microsoft.com/platform/support/policy/dotnet-core). Alternately, applications can be updated to use .NET Core 3.1 or .NET 5, both of which support .NET Standard 2.1.
+
+<a name="getcolumnname-obsolete"></a>
+
+### IProperty.GetColumnName() is now obsolete
+
+[Tracking Issue #2266](https://github.com/dotnet/efcore/issues/2266)
+
+#### Old behavior
+
+`GetColumnName()` returned the name of the column that a property is mapped to.
+
+#### New behavior
+
+`GetColumnName()` still returns the name of a column that a property is mapped to, but this behavior is now ambiguous since EF Core 5 supports TPT and simultaneous mapping to a view or a function where these mappings could use different column names for the same property.
+
+#### Why
+
+We marked this method as obsolete to guide users to a more accurate overload - <xref:Microsoft.EntityFrameworkCore.RelationalPropertyExtensions.GetColumnName(Microsoft.EntityFrameworkCore.Metadata.IProperty,Microsoft.EntityFrameworkCore.Metadata.StoreObjectIdentifier@)>.
+
+#### Mitigations
+
+If the entity type is only ever mapped to a single table, and never to views, functions, or multiple tables, the <xref:Microsoft.EntityFrameworkCore.RelationalPropertyExtensions.GetColumnBaseName(Microsoft.EntityFrameworkCore.Metadata.IReadOnlyProperty)> can be used in EF Core 5.0 and 6.0 to obtain the table name. For example:
+
+```csharp
+var columnName = property.GetColumnBaseName();
+```
+
+In EF Core 7.0, this can again be replaced with the new `GetColumnName`, which behaves as the original did for simple, single table only mappings.
+
+If the entity type may be mapped to views, functions, or multiple tables, then a <xref:Microsoft.EntityFrameworkCore.Metadata.StoreObjectIdentifier> must be obtained to identity the table, view, or function. This can be then be used to get the column name for that store object. For example:
+
+```csharp
+var columnName = property.GetColumnName(StoreObjectIdentifier.Table("Users", null)));
+```
+
+<a name="decimals"></a>
+
+### Precision and scale are required for decimals
+
+[Tracking Issue #19293](https://github.com/dotnet/efcore/issues/19293)
+
+#### Old behavior
+
+EF Core did not normally set precision and scale on <xref:Microsoft.Data.SqlClient.SqlParameter> objects. This means the full precision and scale was sent to SQL Server, at which point SQL Server would round based on the precision and scale of the database column.
+
+#### New behavior
+
+EF Core now sets precision and scale on parameters using the values configured for properties in the EF Core model. This means rounding now happens in SqlClient. Consequentially, if the configured precision and scale do not match the database precision and scale, then the rounding seen may change.
+
+#### Why
+
+Newer SQL Server features, including Always Encrypted, require that parameter facets are fully specified. In addition, SqlClient made a change to round instead of truncate decimal values, thereby matching the SQL Server behavior. This made it possible for EF Core to set these facets without changing the behavior for correctly configured decimals.
+
+#### Mitigations
+
+Map your decimal properties using a type name that includes precision and scale. For example:
+
+```csharp
+public class Blog
+{
+    public int Id { get; set; }
+
+    [Column(TypeName = "decimal(16, 5)")]
+    public decimal Score { get; set; }
+}
+```
+
+Or use `HasPrecision` in the model building APIs. For example:
+
+```csharp
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>().Property(e => e.Score).HasPrecision(16, 5);
+    }
+```
+
+<a name="required-dependent"></a>
+
+### Required or non-nullable navigation from principal to dependent has different semantics
+
+[Tracking Issue #17286](https://github.com/dotnet/efcore/issues/17286)
+
+#### Old behavior
+
+Only the navigations to principal could be configured as required. Therefore, using `RequiredAttribute` on the navigation to the dependent (the entity containing the foreign key) or marking it as non-nullable would instead create the foreign key on the defining entity type.
+
+#### New behavior
+
+With the added support for required dependents, it is now possible to mark any reference navigation as required, meaning that in the case shown above the foreign key will be defined on the other side of the relationship and the properties won't be marked as required.
+
+Calling `IsRequired` before specifying the dependent end is now ambiguous:
+
+```csharp
+modelBuilder.Entity<Blog>()
+    .HasOne(b => b.BlogImage)
+    .WithOne(i => i.Blog)
+    .IsRequired()
+    .HasForeignKey<BlogImage>(b => b.BlogForeignKey);
+```
+
+#### Why
+
+The new behavior is necessary to enable support for required dependents ([see #12100](https://github.com/dotnet/efcore/issues/12100)).
+
+#### Mitigations
+
+Remove `RequiredAttribute` from the navigation to the dependent and place it instead on the navigation to the principal or configure the relationship in `OnModelCreating`:
+
+```csharp
+modelBuilder.Entity<Blog>()
+    .HasOne(b => b.BlogImage)
+    .WithOne(i => i.Blog)
+    .HasForeignKey<BlogImage>(b => b.BlogForeignKey)
+    .IsRequired();
+```
+
+<a name="defining-query"></a>
+
+### Defining query is replaced with provider-specific methods
+
+[Tracking Issue #18903](https://github.com/dotnet/efcore/issues/18903)
+
+#### Old behavior
+
+Entity types were mapped to defining queries at the Core level. Anytime the entity type was used in the query root of the entity type was replaced by the defining query for any provider.
+
+#### New behavior
+
+APIs for defining query are deprecated. New provider-specific APIs were introduced.
+
+#### Why
+
+While defining queries were implemented as replacement query whenever query root is used in the query, it had a few issues:
+
+- If defining query is projecting entity type using `new { ... }` in `Select` method, then identifying that as an entity required additional work and made it inconsistent with how EF Core treats nominal types in the query.
+- For relational providers `FromSql` is still needed to pass the SQL string in LINQ expression form.
+
+Initially defining queries were introduced as client-side views to be used with In-Memory provider for keyless entities (similar to database views in relational databases). Such definition makes it easy to test application against in-memory database. Afterwards they became broadly applicable, which was useful but brought inconsistent and hard to understand behavior. So we decided to simplify the concept. We made LINQ based defining query exclusive to In-Memory provider and treat them differently. For more information, [see this issue](https://github.com/dotnet/efcore/issues/20023).
+
+#### Mitigations
+
+For relational providers, use `ToSqlQuery` method in `OnModelCreating` and pass in a SQL string to use for the entity type.
+For the In-Memory provider, use `ToInMemoryQuery` method in `OnModelCreating` and pass in a LINQ query to use for the entity type.
+
+<a name="nonnullreferences"></a>
+
+### Non-null reference navigations are not overwritten by queries
+
+[Tracking Issue #2693](https://github.com/dotnet/EntityFramework.Docs/issues/2693)
+
+#### Old behavior
+
+In EF Core 3.1, reference navigations eagerly initialized to non-null values would sometimes be overwritten by entity instances from the database, regardless of whether or not key values matched. However, in other cases, EF Core 3.1 would do the opposite and leave the existing non-null value.
+
+#### New behavior
+
+Starting with EF Core 5.0, non-null reference navigations are never overwritten by instances returned from a query.
+
+Note that eager initialization of a _collection_ navigation to an empty collection is still supported.
+
+#### Why
+
+Initialization of a reference navigation property to an "empty" entity instance results in an ambiguous state. For example:
+
+```csharp
+public class Blog
+{
+     public int Id { get; set; }
+     public Author Author { get; set; ) = new Author();
+}
+```
+
+Normally a query for Blogs and Authors will first create `Blog` instances and then set the appropriate `Author` instances based on the data returned from the database. However, in this case every `Blog.Author` property is already initialized to an empty `Author`. Except EF Core has no way to know that this instance is "empty". So overwriting this instance could potentially silently throw away a valid `Author`. Therefore, EF Core 5.0 now consistently does not overwrite a navigation that is already initialized.
+
+This new behavior also aligns with the behavior of EF6 in most cases, although upon investigation we also found some cases of inconsistency in EF6.
+
+#### Mitigations
+
+If this break is encountered, then the fix is to stop eagerly initializing reference navigation properties.
+
+<a name="toview"></a>
+
+### ToView() is treated differently by migrations
+
+[Tracking Issue #2725](https://github.com/dotnet/efcore/issues/2725)
+
+#### Old behavior
+
+Calling `ToView(string)` made the migrations ignore the entity type in addition to mapping it to a view.
+
+#### New behavior
+
+Now `ToView(string)` marks the entity type as not mapped to a table in addition to mapping it to a view. This results in the first migration after upgrading to EF Core 5 to try to drop the default table for this entity type as it's not longer ignored.
+
+#### Why
+
+EF Core now allows an entity type to be mapped to both a table and a view simultaneously, so `ToView` is no longer a valid indicator that it should be ignored by migrations.
+
+#### Mitigations
+
+Use the following code to mark the mapped table as excluded from migrations:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<User>().ToTable("UserView", t => t.ExcludeFromMigrations());
+}
+```
+
+<a name="totable"></a>
+
+### ToTable(null) marks the entity type as not mapped to a table
+
+[Tracking Issue #21172](https://github.com/dotnet/efcore/issues/21172)
+
+#### Old behavior
+
+`ToTable(null)` would reset the table name to the default.
+
+#### New behavior
+
+`ToTable(null)` now marks the entity type as not mapped to any table.
+
+#### Why
+
+EF Core now allows an entity type to be mapped to both a table and a view simultaneously, so `ToTable(null)` is used to indicate that it isn't mapped to any table.
+
+#### Mitigations
+
+Use the following code to reset the table name to the default if it's not mapped to a view or a DbFunction:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<User>().Metadata.RemoveAnnotation(RelationalAnnotationNames.TableName);
+}
+```
+
+## Low-impact changes
+
+<a name="geometric-sqlite"></a>
+
+### Removed HasGeometricDimension method from SQLite NTS extension
+
+[Tracking Issue #14257](https://github.com/dotnet/efcore/issues/14257)
+
+#### Old behavior
+
+HasGeometricDimension was used to enable additional dimensions (Z and M) on geometry columns. However, it only ever affected database creation. It was unnecessary to specify it to query values with additional dimensions. It also didn't work correctly when inserting or updating values with additional dimensions ([see #14257](https://github.com/dotnet/efcore/issues/14257)).
+
+#### New behavior
+
+To enable inserting and updating geometry values with additional dimensions (Z and M), the dimension needs to be specified as part of the column type name. This API matches more closely to the underlying behavior of SpatiaLite's AddGeometryColumn function.
+
+#### Why
+
+Using HasGeometricDimension after specifying the dimension in the column type is unnecessary and redundant, so we removed HasGeometricDimension entirely.
+
+#### Mitigations
+
+Use `HasColumnType` to specify the dimension:
+
+```csharp
+modelBuilder.Entity<GeoEntity>(
+    x =>
+    {
+        // Allow any GEOMETRY value with optional Z and M values
+        x.Property(e => e.Geometry).HasColumnType("GEOMETRYZM");
+
+        // Allow only POINT values with an optional Z value
+        x.Property(e => e.Point).HasColumnType("POINTZ");
+    });
+```
+
+<a name="cosmos-partition-key"></a>
+
+### Azure Cosmos DB: Partition key is now added to the primary key
+
+[Tracking Issue #15289](https://github.com/dotnet/efcore/issues/15289)
+
+#### Old behavior
+
+The partition key property was only added to the alternate key that includes `id`.
+
+#### New behavior
+
+The partition key property is now also added to the primary key by convention.
+
+#### Why
+
+This change makes the model better aligned with Azure Cosmos DB semantics and improves the performance of `Find` and some queries.
+
+#### Mitigations
+
+To prevent the partition key property to be added to the primary key, configure it in `OnModelCreating`.
+
+```csharp
+modelBuilder.Entity<Blog>()
+    .HasKey(b => b.Id);
+```
+
+<a name="cosmos-id"></a>
+
+### Azure Cosmos DB: `id` property renamed to `__id`
+
+[Tracking Issue #17751](https://github.com/dotnet/efcore/issues/17751)
+
+#### Old behavior
+
+The shadow property mapped to the `id` JSON property was also named `id`.
+
+#### New behavior
+
+The shadow property created by convention is now named `__id`.
+
+#### Why
+
+This change makes it less likely that the `id` property clashes with an existing property on the entity type.
+
+#### Mitigations
+
+To go back to the 3.x behavior, configure the `id` property in `OnModelCreating`.
+
+```csharp
+modelBuilder.Entity<Blog>()
+    .Property<string>("id")
+    .ToJsonProperty("id");
+```
+
+<a name="cosmos-byte"></a>
+
+### Azure Cosmos DB: byte[] is now stored as a base64 string instead of a number array
+
+[Tracking Issue #17306](https://github.com/dotnet/efcore/issues/17306)
+
+#### Old behavior
+
+Properties of type byte[] were stored as a number array.
+
+#### New behavior
+
+Properties of type byte[] are now stored as a base64 string.
+
+#### Why
+
+This representation of byte[] aligns better with expectations and is the default behavior of the major JSON serialization libraries.
+
+#### Mitigations
+
+Existing data stored as number arrays will still be queried correctly, but currently there isn't a supported way to change back the insert behavior. If this limitation is blocking your scenario, comment on [this issue](https://github.com/dotnet/efcore/issues/17306)
+
+<a name="cosmos-metadata"></a>
+
+### Azure Cosmos DB: GetPropertyName and SetPropertyName were renamed
+
+[Tracking Issue #17874](https://github.com/dotnet/efcore/issues/17874)
+
+#### Old behavior
+
+Previously the extension methods were called `GetPropertyName` and `SetPropertyName`
+
+#### New behavior
+
+The old API was removed and new methods added: `GetJsonPropertyName`, `SetJsonPropertyName`
+
+#### Why
+
+This change removes the ambiguity around what these methods are configuring.
+
+#### Mitigations
+
+Use the new API.
+
+<a name="non-added-generation"></a>
+
+### Value generators are called when the entity state is changed from Detached to Unchanged, Updated, or Deleted
+
+[Tracking Issue #15289](https://github.com/dotnet/efcore/issues/15289)
+
+#### Old behavior
+
+Value generators were only called when the entity state changed to Added.
+
+#### New behavior
+
+Value generators are now called when the entity state is changed from Detached to Unchanged, Updated, or Deleted and the property contains the default values.
+
+#### Why
+
+This change was necessary to improve the experience with properties that are not persisted to the data store and have their value generated always on the client.
+
+#### Mitigations
+
+To prevent the value generator from being called, assign a non-default value to the property before the state is changed.
+
+<a name="relational-model"></a>
+
+### IMigrationsModelDiffer now uses IRelationalModel
+
+[Tracking Issue #20305](https://github.com/dotnet/efcore/issues/20305)
+
+#### Old behavior
+
+`IMigrationsModelDiffer` API was defined using `IModel`.
+
+#### New behavior
+
+`IMigrationsModelDiffer` API now uses `IRelationalModel`. However the model snapshot still contains only `IModel` as this code is part of the application and Entity Framework can't change it without making a bigger breaking change.
+
+#### Why
+
+`IRelationalModel` is a newly added representation of the database schema. Using it to find differences is faster and more accurate.
+
+#### Mitigations
+
+Use the following code to compare the model from `snapshot` with the model from `context`:
+
+```csharp
+var dependencies = context.GetService<ProviderConventionSetBuilderDependencies>();
+var relationalDependencies = context.GetService<RelationalConventionSetBuilderDependencies>();
+
+var typeMappingConvention = new TypeMappingConvention(dependencies);
+typeMappingConvention.ProcessModelFinalizing(((IConventionModel)modelSnapshot.Model).Builder, null);
+
+var relationalModelConvention = new RelationalModelConvention(dependencies, relationalDependencies);
+var sourceModel = relationalModelConvention.ProcessModelFinalized(snapshot.Model);
+
+var modelDiffer = context.GetService<IMigrationsModelDiffer>();
+var hasDifferences = modelDiffer.HasDifferences(
+    ((IMutableModel)sourceModel).FinalizeModel().GetRelationalModel(),
+    context.Model.GetRelationalModel());
+```
+
+We are planning to improve this experience in 6.0 ([see #22031](https://github.com/dotnet/efcore/issues/22031))
+
+<a name="read-only-discriminators"></a>
+
+### Discriminators are read-only
+
+[Tracking Issue #21154](https://github.com/dotnet/efcore/issues/21154)
+
+#### Old behavior
+
+It was possible to change the discriminator value before calling `SaveChanges`
+
+#### New behavior
+
+An exception will be thrown in the above case.
+
+#### Why
+
+EF doesn't expect the entity type to change while it is still being tracked, so changing the discriminator value leaves the context in an inconsistent state, which might result in unexpected behavior.
+
+#### Mitigations
+
+If changing the discriminator value is necessary and the context will be disposed immediately after calling `SaveChanges`, the discriminator can be made mutable:
+
+```csharp
+modelBuilder.Entity<BaseEntity>()
+    .Property<string>("Discriminator")
+    .Metadata.SetAfterSaveBehavior(PropertySaveBehavior.Save);
+```
+
+<a name="no-client-methods"></a>
+
+### Provider-specific EF.Functions methods throw for in-memory provider
+
+[Tracking Issue #20294](https://github.com/dotnet/efcore/issues/20294)
+
+#### Old behavior
+
+Provider-specific EF.Functions methods contained implementation for client execution, which allowed them to be executed on the in-memory provider. For example, `EF.Functions.DateDiffDay` is a Sql Server specific method, which worked on InMemory provider.
+
+#### New behavior
+
+Provider-specific methods have been updated to throw an exception in their method body to block evaluating them on client side.
+
+#### Why
+
+Provider-specific methods map to a database function. The computation done by the mapped database function can't always be replicated on the client side in LINQ. It may cause the result from the server to differ when executing the same method on client. Since these methods are used in LINQ to translate to specific database functions, they don't need to be evaluated on client side. As the in-memory provider is a different _database_, these methods aren't available for this provider. Trying to execute them for InMemory provider, or any other provider that doesn't translate these methods, throws an exception.
+
+#### Mitigations
+
+Since there's no way to mimic behavior of database functions accurately, you should test the queries containing them against same kind of database as in production.
+
+<a name="index-obsolete"></a>
+
+### IndexBuilder.HasName is now obsolete
+
+[Tracking Issue #21089](https://github.com/dotnet/efcore/issues/21089)
+
+#### Old behavior
+
+Previously, only one index could be defined over a given set of properties. The database name of an index was configured using IndexBuilder.HasName.
+
+#### New behavior
+
+Multiple indexes are now allowed on the same set or properties. These indexes are now distinguished by a name in the model. By convention, the model name is used as the database name; however it can also be configured independently using HasDatabaseName.
+
+#### Why
+
+In the future, we'd like to enable both ascending and descending indexes or indexes with different collations on the same set of properties. This change moves us another step in that direction.
+
+#### Mitigations
+
+Any code that was previously calling IndexBuilder.HasName should be updated to call HasDatabaseName instead.
+
+If your project includes migrations generated prior to EF Core version 2.0.0, you can safely ignore the warning in those files and suppress it by adding `#pragma warning disable 612, 618`.
+
+<a name="pluralizer"></a>
+
+### A pluralizer is now included for scaffolding reverse engineered models
+
+[Tracking Issue #11160](https://github.com/dotnet/efcore/issues/11160)
+
+#### Old behavior
+
+Previously, you had to install a separate pluralizer package in order to pluralize DbSet and collection navigation names and singularize table names when scaffolding a DbContext and entity types by reverse engineering a database schema.
+
+#### New behavior
+
+EF Core now includes a pluralizer that uses the [Humanizer](https://github.com/Humanizr/Humanizer) library. This is the same library Visual Studio uses to recommend variable names.
+
+#### Why
+
+Using plural forms of words for collection properties and singular forms for types and reference properties is idiomatic in .NET.
+
+#### Mitigations
+
+To disable the pluralizer, use the `--no-pluralize` option on `dotnet ef dbcontext scaffold` or the `-NoPluralize` switch on `Scaffold-DbContext`.
+
+<a name="inavigationbase"></a>
+
+### INavigationBase replaces INavigation in some APIs to support skip navigations
+
+[Tracking Issue #2568](https://github.com/dotnet/EntityFramework.Docs/issues/2568)
+
+#### Old behavior
+
+EF Core prior to 5.0 supported only one form of navigation property, represented by the `INavigation` interface.
+
+#### New behavior
+
+EF Core 5.0 introduces many-to-many relationships which use "skip navigations". These are represented by the `ISkipNavigation` interface, and most of the functionality of `INavigation` has been pushed down to a common base interface: `INavigationBase`.
+
+#### Why
+
+Most of the functionality between normal and skip navigations is the same. However, skip navigations have a different relationship to foreign keys than normal navigations, since the FKs involved are not directly on either end of the relationship, but rather in the join entity.
+
+#### Mitigations
+
+In many cases applications can switch to using the new base interface with no other changes. However, in cases where the navigation is used to access foreign key properties, application code should either be constrained to only normal navigations, or updated to do the appropriate thing for both normal and skip navigations.
+
+<a name="collection-distinct-groupby"></a>
+
+### Some queries with correlated collection that also use `Distinct` or `GroupBy` are no longer supported
+
+[Tracking Issue #15873](https://github.com/dotnet/efcore/issues/15873)
+
+**Old behavior**
+
+Previously, queries involving correlated collections followed by `GroupBy`, as well as some queries using `Distinct` we allowed to execute.
+
+GroupBy example:
+
+```csharp
+context.Parents
+    .Select(p => p.Children
+        .GroupBy(c => c.School)
+        .Select(g => g.Key))
+```
+
+`Distinct` example - specifically `Distinct` queries where inner collection projection doesn't contain the primary key:
+
+```csharp
+context.Parents
+    .Select(p => p.Children
+        .Select(c => c.School)
+        .Distinct())
+```
+
+These queries could return incorrect results if the inner collection contained any duplicates, but worked correctly if all the elements in the inner collection were unique.
+
+**New behavior**
+
+These queries are no longer supported. Exception is thrown indicating that we don't have enough information to correctly build the results.
+
+**Why**
+
+For correlated collection scenarios we need to know entity's primary key in order to assign collection entities to the correct parent. When inner collection doesn't use `GroupBy` or `Distinct`, the missing primary key can simply be added to the projection. However in case of `GroupBy` and `Distinct` it can't be done because it would change the result of `GroupBy` or `Distinct` operation.
+
+**Mitigations**
+
+Rewrite the query to not use `GroupBy` or `Distinct` operations on the inner collection, and perform these operations on the client instead.
+
+```csharp
+(await context.Parents
+    .Select(p => p.Children.Select(c => c.School))
+    .ToListAsync())
+    .Select(x => x.GroupBy(c => c).Select(g => g.Key))
+```
+
+```csharp
+(await context.Parents
+    .Select(p => p.Children.Select(c => c.School))
+    .ToListAsync())
+    .Select(x => x.Distinct())
+```
+
+<a name="queryable-projection"></a>
+
+### Using a collection of Queryable type in projection is not supported
+
+[Tracking Issue #16314](https://github.com/dotnet/efcore/issues/16314)
+
+**Old behavior**
+
+Previously, it was possible to use collection of a Queryable type inside the projection in some cases, for example as an argument to a `List<T>` constructor:
+
+```csharp
+context.Blogs
+    .Select(b => new List<Post>(context.Posts.Where(p => p.BlogId == b.Id)))
+```
+
+**New behavior**
+
+These queries are no longer supported. Exception is thrown indicating that we can't create an object of Queryable type and suggesting how this could be fixed.
+
+**Why**
+
+We can't materialize an object of a Queryable type, so they would automatically be created using `List<T>` type instead. This would often cause an exception due to type mismatch which was not very clear and could be surprising to some users. We decided to recognize the pattern and throw a more meaningful exception.
+
+**Mitigations**
+
+Add `ToList()` call after the Queryable object in the projection:
+
+```csharp
+context.Blogs.Select(b => context.Posts.Where(p => p.BlogId == b.Id).ToList())
+```
diff --git a/entity-framework/core/what-is-new/ef-core-5.0/plan.md b/entity-framework/core/what-is-new/ef-core-5.0/plan.md
new file mode 100644
index 0000000000..b9d924c208
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-5.0/plan.md
@@ -0,0 +1,314 @@
+---
+title: Plan for Entity Framework Core 5.0
+description: The features planned for Entity Framework Core 5.0
+author: SamMonoRT
+ms.date: 08/22/2020
+uid: core/what-is-new/ef-core-5.0/plan
+---
+
+# Plan for Entity Framework Core 5.0
+
+> [!IMPORTANT]
+> EF Core 5.0 [has now been released](xref:core/what-is-new/index). This page remains as a historical record of the plan.
+
+As described in the [planning process](xref:core/what-is-new/release-planning), we have gathered input from stakeholders into a tentative plan for the EF Core 5.0 release.
+
+> [!IMPORTANT]
+> This plan is still a work-in-progress. Nothing here is a commitment. This plan is a starting point that will evolve as we learn more. Some things not currently planned for 5.0 may get pulled in. Some things currently planned for 5.0 may get punted out.
+
+## General information
+
+### Version number and release date
+
+EF Core 5.0 is currently scheduled for release at [the same time as .NET 5.0](https://devblogs.microsoft.com/dotnet/introducing-net-5/). The version "5.0" was chosen to align with .NET 5.0.
+
+### Supported platforms
+
+EF Core 5.0 is planned to run on any .NET Standard 2.1 platform, including .NET 5.0. This is part of the more general .NET wide [convergence of platforms to .NET Core](https://devblogs.microsoft.com/dotnet/introducing-net-5/).
+
+EF Core 5.0 will not run on .NET Framework.
+
+### Breaking changes
+
+EF Core 5.0 will contain some [breaking changes](xref:core/what-is-new/ef-core-5.0/breaking-changes), but these will be much less severe than was the case for EF Core 3.0. Our goal is to allow the vast majority of applications to update without breaking.
+
+It is expected that there will be some breaking changes for database providers, especially around TPT support. However, we expect the work to update a provider for 5.0 will be less than was required to update for 3.0.
+
+## Themes
+
+We have extracted a few major areas or themes which will form the basis for the large investments in EF Core 5.0.
+
+## Fully transparent many-to-many mapping by convention
+
+Lead developers: @smitpatel, @AndriySvyryd, and @lajones
+
+Tracked by [#10508](https://github.com/dotnet/efcore/issues/10508)
+
+T-shirt size: L
+
+Status: Done
+
+Many-to-many is the [most requested feature](https://github.com/dotnet/efcore/issues/1368) (~506 votes) on the GitHub backlog.
+
+Support for many-to-many relationships can be broken down into three major areas:
+
+* Skip navigation properties--covered by the next theme.
+* Property-bag entity types. These allow a standard CLR type (e.g. `Dictionary`) to be used for entity instances such that an explicit CLR type is not needed for each entity type. Tracked by [#9914](https://github.com/dotnet/efcore/issues/9914).
+* Sugar for easy configuration of many-to-many relationships.
+
+In addition to the skip navigation support, we are now pulling these other areas of many-to-many into EF Core 5.0 so as to provide a complete experience.
+
+## Many-to-many navigation properties (a.k.a "skip navigations")
+
+Lead developers: @smitpatel and @AndriySvyryd
+
+Tracked by [#19003](https://github.com/dotnet/efcore/issues/19003)
+
+T-shirt size: L
+
+Status: Done
+
+As described in the first theme, many-to-many support has multiple aspects.
+This theme specifically tracks use of skip navigations.
+We believe that the most significant blocker for those wanting many-to-many support is not being able to use the "natural" relationships, without referring to the join table, in business logic such as queries.
+The join table entity type may still exist, but it should not get in the way of business logic.
+
+## Table-per-type (TPT) inheritance mapping
+
+Lead developer: @AndriySvyryd and @smitpatel
+
+Tracked by [#2266](https://github.com/dotnet/efcore/issues/2266)
+
+T-shirt size: XL
+
+Status: Done
+
+We're doing TPT because it is both a highly requested feature (~289 votes; 3rd overall) and because it requires some low-level changes that we feel are appropriate for the foundational nature of the overall .NET 5 plan. We expect this to result in breaking changes for database providers, although these should be much less severe than the changes required for 3.0.
+
+## Filtered Include
+
+Lead developer: @maumar
+
+Tracked by [#1833](https://github.com/dotnet/efcore/issues/1833)
+
+T-shirt size: M
+
+Status: Done
+
+Filtered Include is a highly-requested feature (~376 votes; 2nd overall) that isn't a huge amount of work, and that we believe will unblock or make easier many scenarios that currently require model-level filters or more complex queries.
+
+## Split Include
+
+Lead developer: @smitpatel
+
+Tracked by [#20892](https://github.com/dotnet/efcore/issues/20892)
+
+T-shirt size: L
+
+Status: Done
+
+EF Core 3.0 changed the default behavior to create a single SQL query for a given LINQ query.
+This caused large performance regressions for queries that use Include for multiple collections.
+
+In EF Core 5.0, we are retaining the new default behavior.
+However, EF Core 5.0 will now allow generation of multiple queries for collection Includes where having a single query is causing bad performance.
+
+## Required one-to-one dependents
+
+Lead developers: @AndriySvyryd and @smitpatel
+
+Tracked by [#12100](https://github.com/dotnet/efcore/issues/12100)
+
+T-shirt size: M
+
+Status: Done
+
+In EF Core 3.0, all dependents, including owned types are optional (e.g. Person.Address can be null). In EF Core 5.0, dependents can be configured as required.
+
+## Rationalize ToTable, ToQuery, ToView, FromSql, etc
+
+Lead developers: @AndriySvyryd and @smitpatel
+
+Tracked by [#17270](https://github.com/dotnet/efcore/issues/17270)
+
+T-shirt size: L
+
+Status: Done
+
+We have made progress in previous releases towards supporting raw SQL, keyless types, and related areas. However, there are both gaps and inconsistencies in the way everything works together as a whole. The goal for 5.0 is to fix these and create a good experience for defining, migrating, and using different types of entities and their associated queries and database artifacts. This may also involve updates to the compiled query API.
+
+Note that this item may result in some application-level breaking changes since some of the functionality we currently have is too permissive such that it can quickly lead people into pits of failure. We will likely end up blocking some of this functionality together with guidance on what to do instead.
+
+## General query enhancements
+
+Lead developers: @smitpatel and @maumar
+
+Tracked by [issues labeled with `area-query` in the 5.0 milestone](https://github.com/dotnet/efcore/issues?utf8=%E2%9C%93&q=is%3Aissue+label%3Aarea-query+milestone%3A5.0.0+)
+
+T-shirt size: XL
+
+Status: Done
+
+The query translation code was extensively rewritten for EF Core 3.0. The query code is generally in a much more robust state because of this. For 5.0 we aren't planning on making major query changes, outside those needed to support TPT and skip navigation properties. However, there is still significant work needed to fix some technical debt left over from the 3.0 overhaul. We also plan to fix many bugs and implement small enhancements to further improve the overall query experience.
+
+## Migrations and deployment experience
+
+Lead developers: @bricelam
+
+Tracked by [#19587](https://github.com/dotnet/efcore/issues/19587)
+
+T-shirt size: L
+
+Status: Scoped/Done
+
+Scoping: The [migrations bundles feature](https://github.com/dotnet/efcore/issues/19693) has been deferred until after the EF Core 5.0 release. However, several other [targeted improvements related to migrations](https://github.com/dotnet/efcore/issues/19587#issuecomment-668794460) will be included in EF Core 5.0
+
+Currently, many developers migrate their databases at application startup time. This is easy but is not recommended because:
+
+* Multiple threads/processes/servers may attempt to migrate the database concurrently
+* Applications may try to access inconsistent state while this is happening
+* Usually the database permissions to modify the schema should not be granted for application execution
+* It's hard to revert back to a clean state if something goes wrong
+
+We want to deliver a better experience here that allows an easy way to migrate the database at deployment time. This should:
+
+* Work on Linux, Mac, and Windows
+* Be a good experience on the command line
+* Support scenarios with containers
+* Work with commonly used real-world deployment tools/flows
+* Integrate into at least Visual Studio
+
+The result is likely to be many small improvements in EF Core (for example, better Migrations on SQLite), together with guidance and longer-term collaborations with other teams to improve end-to-end experiences that go beyond just EF.
+
+## EF Core platforms experience
+
+Lead developers: @roji and @bricelam
+
+Tracked by [#19588](https://github.com/dotnet/efcore/issues/19588)
+
+T-shirt size: L
+
+Status: Scope/Done
+
+Scoping: Platform guidance and samples are published for Blazor, Xamarin, WinForms, and WPF. Xamarin and other AOT/linker work is now planned for EF Core 6.0.
+
+> [!IMPORTANT]
+> Xamarin.Android, Xamarin.iOS, Xamarin.Mac are now integrated directly into .NET (starting with .NET 6) as .NET for Android, .NET for iOS, and .NET for macOS. If you're building with these project types today, they should be upgraded to .NET SDK-style projects for continued support. For more information about upgrading Xamarin projects to .NET, see the [Upgrade from Xamarin to .NET & .NET MAUI](/dotnet/maui/migration) documentation.
+
+We have good guidance for using EF Core in traditional MVC-like web applications. Guidance for other platforms and application models is either missing or out-of-date. For EF Core 5.0, we plan to investigate, improve, and document the experience of using EF Core with:
+
+* Blazor
+* Xamarin, including using the AOT/linker story
+* WinForms/WPF/WinUI and possibly other U.I. frameworks
+
+This is likely to be many small improvements in EF Core, together with guidance and longer-term collaborations with other teams to improve end-to-end experiences that go beyond just EF.
+
+Specific areas we plan to look at are:
+
+* Deployment, including the experience for using EF tooling such as for Migrations
+* Application models, including Xamarin and Blazor, and probably others
+* SQLite experiences, including the spatial experience and table rebuilds
+* AOT and linking experiences
+* Diagnostics integration, including perf counters
+
+## Performance
+
+Lead developer: @roji
+
+Tracked by [issues labeled with `area-perf` in the 5.0 milestone](https://github.com/dotnet/efcore/issues?utf8=%E2%9C%93&q=is%3Aissue+label%3Aarea-perf+milestone%3A5.0.0+)
+
+T-shirt size: L
+
+Status: Scoped/Done
+
+Scoping: Major performance improvements in the Npgsql provider are complete. Other performance work is now planned for EF Core 6.0.
+
+For EF Core, we plan to improve our suite of performance benchmarks and make directed performance improvements to the runtime. In addition, we plan to complete the new ADO.NET batching API which was prototyped during the 3.0 release cycle. Also at the ADO.NET layer, we plan additional performance improvements to the Npgsql provider.
+
+As part of this work we also plan to add ADO.NET/EF Core performance counters and other diagnostics as appropriate.
+
+## Architectural/contributor documentation
+
+Lead documenter: @ajcvickers
+
+Tracked by [#1920](https://github.com/dotnet/EntityFramework.Docs/issues/1920)
+
+T-shirt size: L
+
+Status: Cut
+
+The idea here is to make it easier to understand what is going on in the internals of EF Core. This can be useful to anyone using EF Core, but the primary motivation is to make it easier for external people to:
+
+* Contribute to the EF Core code
+* Create database providers
+* Build other extensions
+
+Update: Unfortunately, this plan was too ambitious.
+We still believe this is important, but unfortunately it won't land with EF Core 5.0.
+
+## Microsoft.Data.Sqlite documentation
+
+Lead documenter: @bricelam
+
+Tracked by [#1675](https://github.com/dotnet/EntityFramework.Docs/issues/1675)
+
+T-shirt size: M
+
+Status: Completed. The new documentation is [live on Microsoft Learn](/dotnet/standard/data/sqlite/?tabs=netcore-cli).
+
+The EF Team also owns the Microsoft.Data.Sqlite ADO.NET provider. We plan to fully document this provider as part of the 5.0 release.
+
+## General documentation
+
+Lead documenter: @ajcvickers
+
+Tracked by [issues in the documentation repo in the 5.0 milestone](https://github.com/dotnet/EntityFramework.Docs/issues?utf8=%E2%9C%93&q=is%3Aissue+milestone%3A5.0.0+)
+
+T-shirt size: L
+
+Status: In-progress
+
+We are already in the process of updating documentation for the 3.0 and 3.1 releases. We are also working on:
+
+* An overhaul of the getting started articles to make them more approachable/easier to follow
+* Reorganization of articles to make things easier to find and to add cross-references
+* Adding more details and clarifications to existing articles
+* Updating the samples and adding more examples
+
+## Fixing bugs
+
+Tracked by [issues labeled with `type-bug` in the 5.0 milestone](https://github.com/dotnet/efcore/issues?utf8=%E2%9C%93&q=is%3Aissue+milestone%3A5.0.0+label%3Atype-bug+)
+
+Developers: @roji, @maumar, @bricelam, @smitpatel, @AndriySvyryd, @ajcvickers
+
+T-shirt size: L
+
+Status: In-progress
+
+At the time of writing, we have 135 bugs triaged to be fixed in the 5.0 release (with 62 already fixed), but there is significant overlap with the _General query enhancements_ section above.
+
+The incoming rate (issues that end up as work in a milestone) was about 23 issues per month over the course of the 3.0 release. Not all of these will need to be fixed in 5.0. As a rough estimate we plan to fix an additional 150 issues in the 5.0 time frame.
+
+## Small enhancements
+
+Tracked by [issues labeled with `type-enhancement` in the 5.0 milestone](https://github.com/dotnet/efcore/issues?utf8=%E2%9C%93&q=is%3Aissue+milestone%3A5.0.0+label%3Atype-enhancement+)
+
+Developers: @roji, @maumar, @bricelam, @smitpatel, @AndriySvyryd, @ajcvickers
+
+T-shirt size: L
+
+Status: Done
+
+In addition to the bigger features outlined above, we also have many smaller improvements scheduled for 5.0 to fix "paper-cuts". Note that many of these enhancements are also covered by the more general themes outlined above.
+
+## Below-the-line
+
+Tracked by [issues labeled with `consider-for-next-release`](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-next-release)
+
+These are bug fixes and enhancements that are **not** currently scheduled for the 5.0 release, but we will look at as stretch goals depending on the progress made on the work above.
+
+In addition, we always consider the [most voted issues](https://github.com/dotnet/efcore/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc) when planning. Cutting any of these issues from a release is always painful, but we do need a realistic plan for the resources we have.
+
+## Suggestions
+
+Your feedback on planning is important. The best way to indicate the importance of an issue is to vote (thumbs-up) for that issue on GitHub. This data will then feed into the [planning process](xref:core/what-is-new/release-planning) for the next release.
diff --git a/entity-framework/core/what-is-new/ef-core-5.0/whatsnew.md b/entity-framework/core/what-is-new/ef-core-5.0/whatsnew.md
new file mode 100644
index 0000000000..a15fc7d2d4
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-5.0/whatsnew.md
@@ -0,0 +1,388 @@
+---
+title: What's New in EF Core 5.0
+description: Overview of new features in EF Core 5.0
+author: SamMonoRT
+ms.date: 09/10/2020
+uid: core/what-is-new/ef-core-5.0/whatsnew
+---
+
+# What's New in EF Core 5.0
+
+The following list includes the major new features in EF Core 5.0. For the full list of issues in the release, see our [issue tracker](https://github.com/dotnet/efcore/issues?q=is%3Aissue+milestone%3A5.0.0).
+
+As a major release, EF Core 5.0 also contains several [breaking changes](xref:core/what-is-new/ef-core-5.0/breaking-changes), which are API improvements or behavioral changes that may have negative impact on existing applications.
+
+## Many-to-many
+
+EF Core 5.0 supports many-to-many relationships without explicitly mapping the join table.
+
+For example, consider these entity types:
+
+```csharp
+public class Post
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+    public ICollection<Tag> Tags { get; set; }
+}
+
+public class Tag
+{
+    public int Id { get; set; }
+    public string Text { get; set; }
+    public ICollection<Post> Posts { get; set; }
+}
+```
+
+EF Core 5.0 recognizes this as a many-to-many relationship by convention, and automatically creates a `PostTag` join table in the database. Data can be queried and updated without explicitly referencing the join table, considerably simplifying code. The join table can still be customized and queried explicitly if needed.
+
+For further information, [see the full documentation on many-to-many](xref:core/modeling/relationships/many-to-many).
+
+## Split queries
+
+Starting with EF Core 3.0, EF Core always generates a single SQL query for each LINQ query. This ensures consistency of the data returned within the constraints of the transaction mode in use. However, this can become very slow when the query uses `Include` or a projection to bring back multiple related collections.
+
+EF Core 5.0 now allows a single LINQ query including related collections to be split into multiple SQL queries. This can significantly improve performance, but can result in inconsistency in the results returned if the data changes between the two queries. Serializable or snapshot transactions can be used to mitigate this and achieve consistency with split queries, but that may bring other performance costs and behavioral difference.
+
+For example, consider a query that pulls in two levels of related collections using `Include`:
+
+```csharp
+var artists = await context.Artists
+    .Include(e => e.Albums)
+    .ToListAsync();
+```
+
+By default, EF Core will generate the following SQL when using the SQLite provider:
+
+```sql
+SELECT a."Id", a."Name", a0."Id", a0."ArtistId", a0."Title"
+FROM "Artists" AS a
+LEFT JOIN "Album" AS a0 ON a."Id" = a0."ArtistId"
+ORDER BY a."Id", a0."Id"
+```
+
+With split queries, the following SQL is generated instead:
+
+```sql
+SELECT a."Id", a."Name"
+FROM "Artists" AS a
+ORDER BY a."Id"
+
+SELECT a0."Id", a0."ArtistId", a0."Title", a."Id"
+FROM "Artists" AS a
+INNER JOIN "Album" AS a0 ON a."Id" = a0."ArtistId"
+ORDER BY a."Id"
+```
+
+Split queries can be enabled by placing the new `AsSplitQuery` operator anywhere in your LINQ query, or globally in your model's `OnConfiguring`. For further information, [see the full documentation on split queries](xref:core/querying/single-split-queries).
+
+## Simple logging and improved diagnostics
+
+EF Core 5.0 introduces a simple way to set up logging via the new `LogTo` method. The following will cause logging messages to be written to the console, including all SQL generated by EF Core:
+
+```csharp
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    => optionsBuilder.LogTo(Console.WriteLine);
+```
+
+In addition, it is now possible to call `ToQueryString` on any LINQ query, retrieving the SQL that the query would execute:
+
+```csharp
+Console.WriteLine(
+    ctx.Artists
+    .Where(a => a.Name == "Pink Floyd")
+    .ToQueryString());
+```
+
+Finally, various EF Core types have been fitted with an enhanced `DebugView` property which provides a detailed view into the internals. For example, <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.DebugView*?displayProperty=nameWithType> can be consulted to see exactly which entities are being tracked in a given moment.
+
+For further information, [see the documentation on logging and interception](xref:core/logging-events-diagnostics/index).
+
+## Filtered include
+
+The `Include` method now supports filtering of the entities included:
+
+```csharp
+var blogs = await context.Blogs
+    .Include(e => e.Posts.Where(p => p.Title.Contains("Cheese")))
+    .ToListAsync();
+```
+
+This query will return blogs together with each associated post, but only when the post title contains "Cheese".
+
+For further information, [see the full documentation on filtered include](xref:core/querying/related-data/eager#filtered-include).
+
+## Table-per-type (TPT) mapping
+
+By default, EF Core maps an inheritance hierarchy of .NET types to a single database table. This is known as table-per-hierarchy (TPH) mapping. EF Core 5.0 also allows mapping each .NET type in an inheritance hierarchy to a different database table; known as table-per-type (TPT) mapping.
+
+For example, consider this model with a mapped hierarchy:
+
+```csharp
+public class Animal
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+}
+
+public class Cat : Animal
+{
+    public string EducationLevel { get; set; }
+}
+
+public class Dog : Animal
+{
+    public string FavoriteToy { get; set; }
+}
+```
+
+With TPT, a database table is created for each type in the hierarchy:
+
+```sql
+CREATE TABLE [Animals] (
+    [Id] int NOT NULL IDENTITY,
+    [Name] nvarchar(max) NULL,
+    CONSTRAINT [PK_Animals] PRIMARY KEY ([Id])
+);
+
+CREATE TABLE [Cats] (
+    [Id] int NOT NULL,
+    [EducationLevel] nvarchar(max) NULL,
+    CONSTRAINT [PK_Cats] PRIMARY KEY ([Id]),
+    CONSTRAINT [FK_Cats_Animals_Id] FOREIGN KEY ([Id]) REFERENCES [Animals] ([Id]) ON DELETE NO ACTION,
+);
+
+CREATE TABLE [Dogs] (
+    [Id] int NOT NULL,
+    [FavoriteToy] nvarchar(max) NULL,
+    CONSTRAINT [PK_Dogs] PRIMARY KEY ([Id]),
+    CONSTRAINT [FK_Dogs_Animals_Id] FOREIGN KEY ([Id]) REFERENCES [Animals] ([Id]) ON DELETE NO ACTION,
+);
+```
+
+For further information, [see the full documentation on TPT](xref:core/modeling/inheritance).
+
+## Flexible entity mapping
+
+Entity types are commonly mapped to tables or views such that EF Core will pull back the contents of the table or view when querying for that type. EF Core 5.0 adds additional mapping options, where an entity can be mapped to a SQL query (called a "defining query"), or to a table-valued function (TVF):
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Post>().ToSqlQuery(
+        @"SELECT Id, Name, Category, BlogId FROM posts
+          UNION ALL
+          SELECT Id, Name, ""Legacy"", BlogId from legacy_posts");
+
+    modelBuilder.Entity<Blog>().ToFunction("BlogsReturningFunction");
+}
+```
+
+Table-valued functions can also be mapped to a .NET method rather than to a DbSet, allowing parameters to be passed; the mapping can be set up with <xref:Microsoft.EntityFrameworkCore.RelationalModelBuilderExtensions.HasDbFunction*>.
+
+Finally, it is now possible to map an entity to a view when querying (or to a function or defining query), but to a table when updating:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder
+        .Entity<Blog>()
+        .ToTable("Blogs")
+        .ToView("BlogsView");
+}
+```
+
+## Shared-type entity types and property bags
+
+EF Core 5.0 allows the same CLR type to be mapped to multiple different entity types; such types are known as shared-type entity types. While any CLR type can be used with this feature, .NET `Dictionary` offers a particularly compelling use-case which we call "property bags":
+
+```csharp
+public class ProductsContext : DbContext
+{
+    public DbSet<Dictionary<string, object>> Products => Set<Dictionary<string, object>>("Product");
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.SharedTypeEntity<Dictionary<string, object>>("Product", b =>
+        {
+            b.IndexerProperty<int>("Id");
+            b.IndexerProperty<string>("Name").IsRequired();
+            b.IndexerProperty<decimal>("Price");
+        });
+    }
+}
+```
+
+These entities can then be queried and updated just like normal entity types with their own, dedicated CLR type. More information can be found in the documentation on [property bags](xref:core/modeling/shadow-properties#property-bag-entity-types).
+
+## Required 1:1 dependents
+
+In EF Core 3.1, the dependent end of a one-to-one relationship was always considered optional. This was most apparent when using owned entities, as all the owned entity's column were created as nullable in the database, even if they were configured as required in the model.
+
+In EF Core 5.0, a navigation to an owned entity can be configured as a required dependent. For example:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Person>(b =>
+    {
+        b.OwnsOne(e => e.HomeAddress,
+            b =>
+            {
+                b.Property(e => e.City).IsRequired();
+                b.Property(e => e.Postcode).IsRequired();
+            });
+        b.Navigation(e => e.HomeAddress).IsRequired();
+    });
+}
+```
+
+## DbContextFactory
+
+EF Core 5.0 introduces `AddDbContextFactory` and `AddPooledDbContextFactory` to register a factory for creating DbContext instances in the application's dependency injection (D.I.) container; this can be useful when application code needs to create and dispose context instances manually.
+
+```csharp
+services.AddDbContextFactory<SomeDbContext>(b =>
+    b.UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Test"));
+```
+
+At this point, application services such as ASP.NET Core controllers can then be injected with `IDbContextFactory<TContext>`, and use it to instantiate context instances:
+
+```csharp
+public class MyController : Controller
+{
+    private readonly IDbContextFactory<SomeDbContext> _contextFactory;
+
+    public MyController(IDbContextFactory<SomeDbContext> contextFactory)
+        => _contextFactory = contextFactory;
+
+    public void DoSomeThing()
+    {
+        using (var context = _contextFactory.CreateDbContext())
+        {
+            // ...
+        }
+    }
+}
+```
+
+For further information, [see the full documentation on DbContextFactory](xref:core/dbcontext-configuration/index#using-a-dbcontext-factory-eg-for-blazor).
+
+## SQLite table rebuilds
+
+Compared to other databases, SQLite is relatively limited in its schema manipulation capabilities; for example, dropping a column from an existing table is not supported. EF Core 5.0 works around these limitations by automatically creating a new table, copying the data from the old table, dropping the old table and renaming the new one. This "rebuilds" the table, and allows previously unsupported migration operations to be safely applied.
+
+For details on which migration operations are now supported via table rebuilds, [see this documentation page](xref:core/providers/sqlite/limitations#migrations-limitations).
+
+## Database collations
+
+EF Core 5.0 introduces support for specifying text collations at the database, column or query level. This allows case sensitivity and other textual aspects to be configured in a way that is both flexible and does not compromise query performance.
+
+For example, the following will configure the `Name` column to be case-sensitive on SQL Server, and any indexes created on the column will function accordingly:
+
+```csharp
+modelBuilder
+    .Entity<User>()
+    .Property(e => e.Name)
+    .UseCollation("SQL_Latin1_General_CP1_CS_AS");
+```
+
+For further information, [see the full documentation on collations and case sensitivity](xref:core/miscellaneous/collations-and-case-sensitivity).
+
+## Event counters
+
+EF Core 5.0 exposes [event counters](https://devblogs.microsoft.com/dotnet/introducing-diagnostics-improvements-in-net-core-3-0) which can be used to track your application's performance and spot various anomalies. Simply attach to a process running EF with the [dotnet-counters](/dotnet/core/diagnostics/dotnet-counters) tool:
+
+```console
+> dotnet counters monitor Microsoft.EntityFrameworkCore -p 49496
+
+[Microsoft.EntityFrameworkCore]
+    Active DbContexts                                               1
+    Execution Strategy Operation Failures (Count / 1 sec)           0
+    Execution Strategy Operation Failures (Total)                   0
+    Optimistic Concurrency Failures (Count / 1 sec)                 0
+    Optimistic Concurrency Failures (Total)                         0
+    Queries (Count / 1 sec)                                     1,755
+    Queries (Total)                                            98,402
+    Query Cache Hit Rate (%)                                      100
+    SaveChanges (Count / 1 sec)                                     0
+    SaveChanges (Total)                                             1
+```
+
+For further information, [see the full documentation on event counters](xref:core/logging-events-diagnostics/metrics#event-counters-legacy).
+
+## Other features
+
+### Model building
+
+* Model building APIs have been introduced for easier configuration of [value comparers](xref:core/modeling/value-comparers).
+* Computed columns can now be configured as [*stored* or *virtual*](xref:core/modeling/generated-properties#computed-columns).
+* Precision and scale can now be configured [via the Fluent API](xref:core/modeling/entity-properties#precision-and-scale).
+* New model building APIs have been introduced for [navigation properties](xref:core/modeling/relationships/navigations).
+* New model building APIs have been introduced for fields, similar to properties.
+* The .NET [PhysicalAddress](/dotnet/api/system.net.networkinformation.physicaladdress) and [IPAddress](/dotnet/api/system.net.ipaddress) types can now be mapped to database string columns.
+* A backing field can now be configured via [the new `[BackingField]` attribute](xref:core/modeling/backing-field).
+* Nullable backing fields are now allowed, providing better support for store-generated defaults where the CLR default isn't a good sentinel value (notable `bool`).
+* A new `[Index]` attribute can be used on an entity type to specify an index, instead of using the Fluent API.
+* A new `[Keyless]` attribute can be used to configure an entity type [as having no key](xref:core/modeling/keyless-entity-types).
+* By default, [EF Core now regards discriminators as *complete*](xref:core/modeling/inheritance#table-per-hierarchy-and-discriminator-configuration), meaning that it expects to never see discriminator values not configured by the application in the model. This allows for some performance improvements, and can be disabled if your discriminator column might hold unknown values.
+
+### Query
+
+* Query translation failure exceptions now contain more explicit reasons about the reasons for the failure, to help pinpoint the issue.
+* No-tracking queries can now perform [identity resolution](xref:core/querying/tracking#identity-resolution), avoiding multiple entity instances being returned for the same database object.
+* Added support for GroupBy with conditional aggregates (e.g. `GroupBy(o => o.OrderDate).Select(g => g.Count(i => i.OrderDate != null))`).
+* Added support for translating the Distinct operator over group elements before aggregate.
+* Translation of [`Reverse`](/dotnet/api/system.linq.queryable.reverse).
+* Improved translation around `DateTime` for SQL Server (e.g. [`DateDiffWeek`](xref:Microsoft.EntityFrameworkCore.SqlServerDbFunctionsExtensions.DateDiffWeek*), [`DateFromParts`](xref:Microsoft.EntityFrameworkCore.SqlServerDbFunctionsExtensions.DateFromParts*)).
+* Translation of new methods on byte arrays (e.g. [`Contains`](/dotnet/api/system.linq.enumerable.contains), [`Length`](/dotnet/api/system.array.length), [`SequenceEqual`](/dotnet/api/system.linq.enumerable.sequenceequal)).
+* Translation of some additional bitwise operators, such as two's complement.
+* Translation of `FirstOrDefault` over strings.
+* Improved query translation around null semantics, resulting in tighter, more efficient queries.
+* User-mapped functions can now be annotated to control null propagation, again resulting in tighter, more efficient queries.
+* SQL containing CASE blocks is now considerably more concise.
+* The SQL Server [`DATALENGTH`](/sql/t-sql/functions/datalength-transact-sql) function can now be called in queries via the new [`EF.Functions.DataLength`](xref:Microsoft.EntityFrameworkCore.SqlServerDbFunctionsExtensions.DataLength*) method.
+* `EnableDetailedErrors` adds [additional details to exceptions](xref:core/logging-events-diagnostics/simple-logging#detailed-query-exceptions).
+
+### Saving
+
+* SaveChanges [interception](xref:core/logging-events-diagnostics/interceptors#savechanges-interception) and [events](xref:core/logging-events-diagnostics/events).
+* APIs have been introduced for controlling [transaction savepoints](xref:core/saving/transactions#savepoints). In addition, EF Core will automatically create a savepoint when `SaveChanges` is called and a transaction is already in progress, and roll back to it in case of failure.
+* A transaction ID can be explicitly set by the application, allowing for easier correlation of transaction events in logging and elsewhere.
+* The default maximum batch size for SQL Server has been changed to 42 based on an analysis of batching performance.
+
+### Migrations and scaffolding
+
+* Tables can now be [excluded from migrations](xref:core/modeling/entity-types#excluding-from-migrations).
+* A new [`dotnet ef migrations list`](xref:core/cli/dotnet#dotnet-ef-migrations-list) command now shows which migrations have not yet been applied to the database ([`Get-Migration`](xref:core/cli/powershell#get-migration) does the same in the Package Management Console).
+* Migrations scripts now contain transaction statements where appropriate to improve handling cases where migration application fails.
+* The columns for unmapped base classes are now ordered after other columns for mapped entity types. Note this only impacts newly created tables; the column order for existing tables remains unchanged.
+* Migration generation can now be aware if the migration being generated is idempotent, and whether the output will be executed immediately or generated as a script.
+* New command-line parameters have been added for specifying namespaces in [Migrations](xref:core/managing-schemas/migrations/index#namespaces) and [scaffolding](xref:core/managing-schemas/scaffolding#directories-and-namespaces).
+* The [dotnet ef database update](xref:core/cli/dotnet#dotnet-ef-database-update) command now accepts a new `--connection` parameter for specifying the connection string.
+* Scaffolding existing databases now singularizes table names, so tables named `People` and `Addresses` will be scaffolded to entity types called `Person` and `Address`. [Original database names can still be preserved](xref:core/managing-schemas/scaffolding#preserving-names).
+* The new [`--no-onconfiguring`](xref:core/cli/dotnet#dotnet-ef-dbcontext-scaffold) option can instruct EF Core to exclude `OnConfiguring` when scaffolding a model.
+
+### Azure Cosmos DB
+
+* [Azure Cosmos DB connection settings](xref:core/providers/cosmos/index#cosmos-options) have been expanded.
+* Optimistic concurrency is now [supported on Azure Cosmos DB via the use of ETags](xref:core/providers/cosmos/index#optimistic-concurrency-with-etags).
+* The new `WithPartitionKey` method allows the Azure Cosmos DB [partition key](xref:core/providers/cosmos/index#partition-keys) to be included both in the model and in queries.
+* The string methods [`Contains`](/dotnet/api/system.string.contains), [`StartsWith`](/dotnet/api/system.string.startswith) and [`EndsWith`](/dotnet/api/system.string.endswith) are now translated for Azure Cosmos DB.
+* The C# `is` operator is now translated on Azure Cosmos DB.
+
+### Sqlite
+
+* Computed columns are now supported.
+* Retrieving binary and string data with GetBytes, GetChars, and GetTextReader is now more efficient by making use of SqliteBlob and streams.
+* Initialization of SqliteConnection is now lazy.
+
+### Other
+
+* Change-tracking proxies can be generated that automatically implement [INotifyPropertyChanging](/dotnet/api/system.componentmodel.inotifypropertychanging) and [INotifyPropertyChanged](/dotnet/api/system.componentmodel.inotifypropertychanged). This provides an alternative approach to change-tracking that doesn't scan for changes when `SaveChanges` is called.
+* A <xref:System.Data.Common.DbConnection> or connection string can now be changed on an already-initialized DbContext.
+* The new <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.Clear*?displayProperty=nameWithType> method clears the DbContext of all tracked entities. This should usually not be needed when using the best practice of creating a new, short-lived context instance for each unit-of-work. However, if there is a need to reset the state of a DbContext instance, then using the new `Clear()` method is more efficient and robust than mass-detaching all entities.
+* The EF Core command line tools now automatically configure the `ASPNETCORE_ENVIRONMENT` *and* `DOTNET_ENVIRONMENT` environment variables to "Development". This brings the experience when using the generic host in line with the experience for ASP.NET Core during development.
+* Custom command-line arguments can be flowed into <xref:Microsoft.EntityFrameworkCore.Design.IDesignTimeDbContextFactory`1>, allowing applications to control how the context is created and initialized.
+* The index fill factor can now be [configured on SQL Server](xref:core/providers/sql-server/indexes#fill-factor).
+* The new <xref:Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.IsRelational*> property can be used to distinguish when using a relational provider and a non-relation provider (such as in-memory).
diff --git a/entity-framework/core/what-is-new/ef-core-6.0/breaking-changes.md b/entity-framework/core/what-is-new/ef-core-6.0/breaking-changes.md
new file mode 100644
index 0000000000..b8ab08ccfc
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-6.0/breaking-changes.md
@@ -0,0 +1,977 @@
+---
+title: Breaking changes in EF Core 6.0 - EF Core
+description: Complete list of breaking changes introduced in Entity Framework Core 6.0
+author: SamMonoRT
+ms.date: 09/21/2022
+uid: core/what-is-new/ef-core-6.0/breaking-changes
+ms.custom: sfi-ropc-nochange
+---
+
+# Breaking changes in EF Core 6.0
+
+The following API and behavior changes have the potential to break existing applications updating to EF Core 6.0.
+
+## Target Framework
+
+EF Core 6.0 targets .NET 6. Applications targeting older .NET, .NET Core, and .NET Framework versions will need to target .NET 6 to use EF Core 6.0.
+
+## Summary
+
+| **Breaking change**                                                                                                                 | **Impact** |
+|:------------------------------------------------------------------------------------------------------------------------------------|------------|
+| [Nested optional dependents sharing a table and with no required properties cannot be saved](#nested-optionals)                     | High       |
+| [Changing the owner of an owned entity now throws an exception](#owned-reparenting)                                                 | Medium     |
+| [Azure Cosmos DB: Related entity types are discovered as owned](#cosmos-owned)                                                      | Medium     |
+| [SQLite: Connections are pooled](#connection-pool)                                                                                  | Medium     |
+| [Many-to-many relationships without mapped join entities are now scaffolded](#many-to-many)                                         | Medium     |
+| [Cleaned up mapping between DeleteBehavior and ON DELETE values](#on-delete)                                                        | Low        |
+| [In-memory database validates required properties do not contain nulls](#in-memory-required)                                        | Low        |
+| [Removed last ORDER BY when joining for collections](#last-order-by)                                                                | Low        |
+| [DbSet no longer implements IAsyncEnumerable](#dbset-iasyncenumerable)                                                              | Low        |
+| [TVF return entity type is also mapped to a table by default](#tvf-table)                                                           | Low        |
+| [Check constraint name uniqueness is now validated](#unique-check-constraints)                                                      | Low        |
+| [Added IReadOnly Metadata interfaces and removed extension methods](#ireadonly-metadata)                                            | Low        |
+| [IExecutionStrategy is now a singleton service](#iexecutionstrategy)                                                                | Low        |
+| [SQL Server: More errors are considered transient](#transient-errors)                                                               | Low        |
+| [Azure Cosmos DB: More characters are escaped in 'id' values](#cosmos-id)                                                           | Low        |
+| [Some Singleton services are now Scoped](#query-services)                                                                           | Low*       |
+| [New caching API for extensions that add or replace services](#extensions-caching)                                                  | Low*       |
+| [New snapshot and design-time model initialization procedure](#snapshot-initialization)                                             | Low        |
+| [`OwnedNavigationBuilder.HasIndex` returns a different type now](#owned-index)                                                      | Low        |
+| [`DbFunctionBuilder.HasSchema(null)` overrides `[DbFunction(Schema = "schema")]`](#function-schema)                                 | Low        |
+| [Pre-initialized navigations are overridden by values from database queries](#overwrite-navigations)                                | Low        |
+| [Unknown enum string values in the database are not converted to the enum default when queried](#unknown-emums)                     | Low        |
+| [DbFunctionBuilder.HasTranslation now provides the function arguments as IReadOnlyList rather than IReadOnlyCollection](#func-args) | Low        |
+| [Default table mapping is not removed when the entity is mapped to a table-valued function](#tvf-default-mapping)                   | Low        |
+| [dotnet-ef targets .NET 6](#dotnet-ef)                                                                                              | Low        |
+| [`IModelCacheKeyFactory` implementations may need to be updated to handle design-time caching](#model-cache-key)                    | Low        |
+| [`NavigationBaseIncludeIgnored` is now an error by default](#ignored-navigation)                                                    | Low        |
+
+\* These changes are of particular interest to authors of database providers and extensions.
+
+## High-impact changes
+
+<a name="nested-optionals"></a>
+
+### Nested optional dependents sharing a table and with no required properties are disallowed
+
+[Tracking Issue #24558](https://github.com/dotnet/efcore/issues/24558)
+
+#### Old behavior
+
+Models with nested optional dependents sharing a table and with no required properties were allowed, but could result in data loss when querying for the data and then saving again. For example, consider the following model:
+
+```csharp
+public class Customer
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+    public ContactInfo ContactInfo { get; set; }
+}
+
+[Owned]
+public class ContactInfo
+{
+    public string Phone { get; set; }
+    public Address Address { get; set; }
+}
+
+[Owned]
+public class Address
+{
+    public string House { get; set; }
+    public string Street { get; set; }
+    public string City { get; set; }
+    public string Postcode { get; set; }
+}
+```
+
+None of the properties in `ContactInfo` or `Address` are required, and all these entity types are mapped to the same table. The rules for optional dependents (as opposed to required dependents) say that if all of the columns for `ContactInfo` are null, then no instance of `ContactInfo` will be created when querying for the owner `Customer`. However, this also means that no instance of `Address` will be created, even if the `Address` columns are non-null.
+
+#### New behavior
+
+Attempting to use this model will now throw the following exception:
+
+> System.InvalidOperationException:
+> Entity type 'ContactInfo' is an optional dependent using table sharing and containing other dependents without any required non shared property to identify whether the entity exists. If all nullable properties contain a null value in database then an object instance won't be created in the query causing nested dependent's values to be lost. Add a required property to create instances with null values for other properties or mark the incoming navigation as required to always create an instance.
+
+This prevents data loss when querying and saving data.
+
+#### Why
+
+Using models with nested optional dependents sharing a table and with no required properties often resulted in silent data loss.
+
+#### Mitigations
+
+Avoid using optional dependents sharing a table and with no required properties. There are three easy ways to do this:
+
+1. Make the dependents required. This means that the dependent entity will always have a value after it is queried, even if all its properties are null. For example:
+
+   ```csharp
+   public class Customer
+   {
+       public int Id { get; set; }
+       public string Name { get; set; }
+   
+       [Required]
+       public Address Address { get; set; }
+   }
+   ```
+
+   Or:
+
+   ```csharp
+   modelBuilder.Entity<Customer>(
+       b =>
+           {
+               b.OwnsOne(e => e.Address);
+               b.Navigation(e => e.Address).IsRequired();
+           });
+   ```
+
+2. Make sure that the dependent contains at least one required property.
+3. Map optional dependents to their own table, instead of sharing a table with the principal. For example:
+
+   ```csharp
+   modelBuilder.Entity<Customer>(
+       b =>
+           {
+               b.ToTable("Customers");
+               b.OwnsOne(e => e.Address, b => b.ToTable("CustomerAddresses"));
+           });
+   ```
+
+The problems with optional dependents and examples of these mitigations are included in the documentation for [What's new in EF Core 6.0](xref:core/what-is-new/ef-core-6.0/whatsnew#changes-to-owned-optional-dependent-handling).
+
+## Medium-impact changes
+
+<a name="owned-reparenting"></a>
+
+### Changing the owner of an owned entity now throws an exception
+
+[Tracking Issue #4073](https://github.com/dotnet/efcore/issues/4073)
+
+#### Old behavior
+
+It was possible to reassign an owned entity to a different owner entity.
+
+#### New behavior
+
+This action will now throw an exception:
+
+> The property '{entityType}.{property}' is part of a key and so cannot be modified or marked as modified. To change the principal of an existing entity with an identifying foreign key, first delete the dependent and invoke 'SaveChanges', and then associate the dependent with the new principal.
+
+#### Why
+
+Even though we don't require key properties to exist on an owned type, EF will still create shadow properties to be used as the primary key and the foreign key pointing to the owner. When the owner entity is changed it causes the values of the foreign key on the owned entity to change, and since they are also used as the primary key this results in the entity identity to change. This isn't yet fully supported in EF Core and was only conditionally allowed for owned entities, sometimes resulting in the internal state becoming inconsistent.
+
+#### Mitigations
+
+Instead of assigning the same owned instance to a new owner you can assign a copy and delete the old one.
+
+<a name="cosmos-owned"></a>
+
+### Azure Cosmos DB: Related entity types are discovered as owned
+
+[Tracking Issue #24803](https://github.com/dotnet/efcore/issues/24803)
+[What's new: Default to implicit ownership](xref:core/what-is-new/ef-core-6.0/whatsnew#default-to-implicit-ownership)
+
+#### Old behavior
+
+As in other providers, related entity types were discovered as normal (non-owned) types.
+
+#### New behavior
+
+Related entity types will now be owned by the entity type on which they were discovered. Only the entity types that correspond to a <xref:Microsoft.EntityFrameworkCore.DbSet`1> property will be discovered as non-owned.
+
+#### Why
+
+This behavior follows the common pattern of modeling data in Azure Cosmos DB of embedding related data into a single document. Azure Cosmos DB does not natively support joining different documents, so modeling related entities as non-owned has limited usefulness.
+
+#### Mitigations
+
+To configure an entity type to be non-owned call `modelBuilder.Entity<MyEntity>();`
+
+<a name="connection-pool"></a>
+
+### SQLite: Connections are pooled
+
+[Tracking Issue #13837](https://github.com/dotnet/efcore/issues/13837)
+[What's new: Default to implicit ownership](xref:core/what-is-new/ef-core-6.0/whatsnew#connection-pooling)
+
+#### Old behavior
+
+Previously, connections in Microsoft.Data.Sqlite were not pooled.
+
+#### New behavior
+
+Starting in 6.0, connections are now pooled by default. This results in database files being kept open by the process even after the ADO.NET connection object is closed.
+
+#### Why
+
+Pooling the underlying connections greatly improves the performance of opening and closing ADO.NET connection objects. This is especially noticeable for scenarios where opening the underlying connection is expensive as in the case of encryption, or in scenarios where there are a lot of short-lived connection to the database.
+
+#### Mitigations
+
+Connection pooling can be disabled by adding `Pooling=False` to a connection string.
+
+Some scenarios (like deleting the database file) may now encounter errors stating that the file is still in use. You can manually clear the connection pool before performing operations of the file using `SqliteConnection.ClearPool()`.
+
+```csharp
+SqliteConnection.ClearPool(connection);
+File.Delete(databaseFile);
+```
+
+<a name="many-to-many"></a>
+
+### Many-to-many relationships without mapped join entities are now scaffolded
+
+[Tracking Issue #22475](https://github.com/dotnet/efcore/issues/22475)
+
+#### Old behavior
+
+Scaffolding (reverse engineering) a `DbContext` and entity types from an existing database always explicitly mapped join tables to join entity types for many-to-many relationships.
+
+#### New behavior
+
+Simple join tables containing only two foreign key properties to other tables are no longer mapped to explicit entity types, but are instead mapped as a many-to-many relationship between the two joined tables.
+
+#### Why
+
+Many-to-many relationships without explicit join types were introduced in EF Core 5.0 and are a cleaner, more natural way to represent simple join tables.
+
+#### Mitigations
+
+There are two mitigations. The preferred approach is to update code to use the many-to-many relationships directly. It is very rare that the join entity type needs to be used directly when it contains only two foreign keys for the many-to-many relationships.
+
+Alternately, the explicit join entity can be added back to the EF model. For example, assuming a many-to-many relationship between `Post` and `Tag`, add back the join type and navigations using partial classes:
+
+```csharp
+public partial class PostTag
+{
+    public int PostsId { get; set; }
+    public int TagsId { get; set; }
+
+    public virtual Post Posts { get; set; }
+    public virtual Tag Tags { get; set; }
+}
+
+public partial class Post
+{
+    public virtual ICollection<PostTag> PostTags { get; set; }
+}
+
+public partial class Tag
+{
+    public virtual ICollection<PostTag> PostTags { get; set; }
+}
+```
+
+Then add configuration for the join type and navigations to a partial class for the DbContext:
+
+```csharp
+public partial class DailyContext
+{
+    partial void OnModelCreatingPartial(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>(entity =>
+        {
+            entity.HasMany(d => d.Tags)
+                .WithMany(p => p.Posts)
+                .UsingEntity<PostTag>(
+                    l => l.HasOne<Tag>(e => e.Tags).WithMany(e => e.PostTags).HasForeignKey(e => e.TagsId),
+                    r => r.HasOne<Post>(e => e.Posts).WithMany(e => e.PostTags).HasForeignKey(e => e.PostsId),
+                    j =>
+                    {
+                        j.HasKey("PostsId", "TagsId");
+                        j.ToTable("PostTag");
+                    });
+        });
+    }
+}
+```
+
+Finally, remove the generated configuration for the many-to-many relationship from the scaffolded context. This is needed because the scaffolded join entity type must be removed from the model before the explicit type can be used. This code will need to be removed each time the context is scaffolded, but because the code above is in partial classes it will persist.
+
+Note that with this configuration, the join entity can be used explicitly, just like in previous versions of EF Core. However, the relationship can also be used as a many-to-many relationship. This means that updating the code like this can be a temporary solution while the rest of the code is updated to use the relationship as a many-to-many in the natural way.
+
+## Low-impact changes
+
+<a name="on-delete"></a>
+
+### Cleaned up mapping between DeleteBehavior and ON DELETE values
+
+[Tracking Issue #21252](https://github.com/dotnet/efcore/issues/21252)
+
+#### Old behavior
+
+Some of the mappings between a relationship's `OnDelete()` behavior and the foreign keys' `ON DELETE` behavior in the database were inconsistent in both Migrations and Scaffolding.
+
+#### New behavior
+
+The following table illustrates the changes for **Migrations**.
+
+OnDelete()     | ON DELETE
+-------------- | ---------
+NoAction       | NO ACTION
+ClientNoAction | NO ACTION
+Restrict       | RESTRICT
+Cascade        | CASCADE
+ClientCascade  | ~~RESTRICT~~ **NO ACTION**
+SetNull        | SET NULL
+ClientSetNull  | ~~RESTRICT~~ **NO ACTION**
+
+The changes for **Scaffolding** are as follows.
+
+ON DELETE | OnDelete()
+--------- | ----------
+NO ACTION | ClientSetNull
+RESTRICT  | ~~ClientSetNull~~ **Restrict**
+CASCADE   | Cascade
+SET NULL  | SetNull
+
+#### Why
+
+The new mappings are more consistent. The default database behavior of NO ACTION is now preferred over the more restrictive and less performant RESTRICT behavior.
+
+#### Mitigations
+
+The default OnDelete() behavior of optional relationships is ClientSetNull. Its mapping has changed from RESTRICT to NO ACTION. This may cause a lot of operations to be generated in your first migration added after upgrading to EF Core 6.0.
+
+You can choose to either apply these operations or manually remove them from the migration since they have no functional impact on EF Core.
+
+SQL Server doesn't support RESTRICT, so these foreign keys were already created using NO ACTION. The migration operations will have no affect on SQL Server and are safe to remove.
+
+<a name="in-memory-required"></a>
+
+### In-memory database validates required properties do not contain nulls
+
+[Tracking Issue #10613](https://github.com/dotnet/efcore/issues/10613)
+
+#### Old behavior
+
+The in-memory database allowed saving null values even when the property was configured as required.
+
+#### New behavior
+
+The in-memory database throws a `Microsoft.EntityFrameworkCore.DbUpdateException` when `SaveChanges` or `SaveChangesAsync` is called and a required property is set to null.
+
+#### Why
+
+The in-memory database behavior now matches the behavior of other databases.
+
+#### Mitigations
+
+The previous behavior (i.e. not checking null values) can be restored when configuring the in-memory provider. For example:
+
+```csharp
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+{
+    optionsBuilder
+        .UseInMemoryDatabase("MyDatabase", b => b.EnableNullChecks(false));
+}
+```
+
+<a name="last-order-by"></a>
+
+### Removed last ORDER BY when joining for collections
+
+[Tracking Issue #19828](https://github.com/dotnet/efcore/issues/19828)
+
+#### Old behavior
+
+When performing SQL JOINs on collections (one-to-many relationships), EF Core used to add an ORDER BY for each key column of the joined table. For example, loading all Blogs with their related Posts was done via the following SQL:
+
+```sql
+SELECT [b].[BlogId], [b].[Name], [p].[PostId], [p].[BlogId], [p].[Title]
+FROM [Blogs] AS [b]
+LEFT JOIN [Post] AS [p] ON [b].[BlogId] = [p].[BlogId]
+ORDER BY [b].[BlogId], [p].[PostId]
+```
+
+These orderings are necessary for proper materialization of the entities.
+
+#### New behavior
+
+The very last ORDER BY for a collection join is now omitted:
+
+```sql
+SELECT [b].[BlogId], [b].[Name], [p].[PostId], [p].[BlogId], [p].[Title]
+FROM [Blogs] AS [b]
+LEFT JOIN [Post] AS [p] ON [b].[BlogId] = [p].[BlogId]
+ORDER BY [b].[BlogId]
+```
+
+An ORDER BY for the Post's ID column is no longer generated.
+
+#### Why
+
+Every ORDER BY imposes additional work at the database side, and the last ordering isn't necessary for EF Core's materialization needs. Data shows that removing this last ordering can produce a significant performance improvement in some scenarios.
+
+#### Mitigations
+
+If your application expects joined entities to be returned in a particular order, make that explicit by adding a LINQ `OrderBy` operator to your query.
+
+<a name="dbset-iasyncenumerable"></a>
+
+### DbSet no longer implements IAsyncEnumerable
+
+[Tracking Issue #24041](https://github.com/dotnet/efcore/issues/24041)
+
+#### Old behavior
+
+<xref:Microsoft.EntityFrameworkCore.DbSet`1>, which is used to execute queries on DbContext, used to implement <xref:System.Collections.Generic.IAsyncEnumerable`1>.
+
+#### New behavior
+
+<xref:Microsoft.EntityFrameworkCore.DbSet`1> no longer directly implements <xref:System.Collections.Generic.IAsyncEnumerable`1>.
+
+#### Why
+
+<xref:Microsoft.EntityFrameworkCore.DbSet`1> was originally made to implement <xref:System.Collections.Generic.IAsyncEnumerable`1> mainly in order to allow direct enumeration on it via the `foreach` construct. Unfortunately, when a project also references [System.Linq.Async](https://www.nuget.org/packages/System.Linq.Async) in order to compose async LINQ operators client-side, this resulted in an ambiguous invocation error between the operators defined over `IQueryable<T>` and those defined over `IAsyncEnumerable<T>`. C# 9 added [extension `GetEnumerator` support for `foreach` loops](/dotnet/csharp/language-reference/proposals/csharp-9.0/extension-getenumerator), removing the original main reason to reference `IAsyncEnumerable`.
+
+The vast majority of `DbSet` usages will continue to work as-is, since they compose LINQ operators over `DbSet`, enumerate it, etc. The only usages broken are those which attempt to cast `DbSet` directly to `IAsyncEnumerable`.
+
+#### Mitigations
+
+If you need to refer to a <xref:Microsoft.EntityFrameworkCore.DbSet`1> as an <xref:System.Collections.Generic.IAsyncEnumerable`1>, call <xref:Microsoft.EntityFrameworkCore.DbSet`1.AsAsyncEnumerable*?displayProperty=nameWithType> to explicitly cast it.
+
+<a name="tvf-table"></a>
+
+### TVF return entity type is also mapped to a table by default
+
+[Tracking Issue #23408](https://github.com/dotnet/efcore/issues/23408)
+
+#### Old behavior
+
+An entity type was not mapped to a table by default when used as a return type of a TVF configured with <xref:Microsoft.EntityFrameworkCore.RelationalModelBuilderExtensions.HasDbFunction*>.
+
+#### New behavior
+
+An entity type used as a return type of a TVF retains the default table mapping.
+
+#### Why
+
+It isn't intuitive that configuring a TVF removes the default table mapping for the return entity type.
+
+#### Mitigations
+
+To remove the default table mapping, call <xref:Microsoft.EntityFrameworkCore.RelationalEntityTypeBuilderExtensions.ToTable(Microsoft.EntityFrameworkCore.Metadata.Builders.EntityTypeBuilder,System.String)>:
+
+```csharp
+modelBuilder.Entity<MyEntity>().ToTable((string?)null));
+```
+
+<a name="unique-check-constraints"></a>
+
+### Check constraint name uniqueness is now validated
+
+[Tracking Issue #25061](https://github.com/dotnet/efcore/issues/25061)
+
+#### Old behavior
+
+Check constraints with the same name were allowed to be declared and used on the same table.
+
+#### New behavior
+
+Explicitly configuring two check constraints with the same name on the same table will now result in an exception. Check constraints created by a convention will be assigned a unique name.
+
+#### Why
+
+Most databases don't allow two check constraints with the same name to be created on the same table, and some require them to be unique even across tables. This would result in exception being thrown when applying a migration.
+
+#### Mitigations
+
+In some cases, valid check constraint names might be different due to this change. To specify the desired name explicitly, call <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.CheckConstraintBuilder.HasName*>:
+
+```csharp
+modelBuilder.Entity<MyEntity>().HasCheckConstraint("CK_Id", "Id > 0", c => c.HasName("CK_MyEntity_Id"));
+```
+
+<a name="ireadonly-metadata"></a>
+
+### Added IReadOnly Metadata interfaces and removed extension methods
+
+[Tracking Issue #19213](https://github.com/dotnet/efcore/issues/19213)
+
+#### Old behavior
+
+There were three sets of metadata interfaces: <xref:Microsoft.EntityFrameworkCore.Metadata.IModel>, <xref:Microsoft.EntityFrameworkCore.Metadata.IMutableModel> and <xref:Microsoft.EntityFrameworkCore.Metadata.IConventionModel> as well as extension methods.
+
+#### New behavior
+
+A new set of `IReadOnly` interfaces has been added, e.g. <xref:Microsoft.EntityFrameworkCore.Metadata.IReadOnlyModel>. Extension methods that were previously defined for the metadata interfaces have been converted to default interface methods.
+
+#### Why
+
+Default interface methods allow the implementation to be overridden, this is leveraged by the new run-time model implementation to offer better performance.
+
+#### Mitigations
+
+These changes shouldn't affect most code. However, if you were using the extension methods via the static invocation syntax, it would need to be converted to instance invocation syntax.
+
+<a name="iexecutionstrategy"></a>
+
+### IExecutionStrategy is now a singleton service
+
+[Tracking Issue #21350](https://github.com/dotnet/efcore/issues/21350)
+
+#### New behavior
+
+<xref:Microsoft.EntityFrameworkCore.Storage.IExecutionStrategy> is now a singleton service. This means that any added state in custom implementations will remain between executions and the delegate passed to <xref:Microsoft.EntityFrameworkCore.Infrastructure.RelationalDbContextOptionsBuilder`2.ExecutionStrategy*> will only be executed once.
+
+#### Why
+
+This reduced allocations on two hot paths in EF.
+
+#### Mitigations
+
+Implementations deriving from <xref:Microsoft.EntityFrameworkCore.Storage.ExecutionStrategy> should clear any state in <xref:Microsoft.EntityFrameworkCore.Storage.ExecutionStrategy.OnFirstExecution>.
+
+Conditional logic in the delegate passed to <xref:Microsoft.EntityFrameworkCore.Infrastructure.RelationalDbContextOptionsBuilder`2.ExecutionStrategy*> should be moved to a custom implementation of <xref:Microsoft.EntityFrameworkCore.Storage.IExecutionStrategy>.
+
+<a name="transient-errors"></a>
+
+### SQL Server: More errors are considered transient
+
+[Tracking Issue #25050](https://github.com/dotnet/efcore/issues/25050)
+
+#### New behavior
+
+The errors listed in the issue above are now considered transient. When using the default (non-retrying) execution strategy, these errors will now be wrapped in an addition exception instance.
+
+#### Why
+
+We continue to gather feedback from both users and SQL Server team on which errors should be considered transient.
+
+#### Mitigations
+
+To change the set of errors that are considered transient, use a custom execution strategy that could be derived from <xref:Microsoft.EntityFrameworkCore.SqlServerRetryingExecutionStrategy> - <xref:core/miscellaneous/connection-resiliency>.
+
+<a name="cosmos-id"></a>
+
+### Azure Cosmos DB: More characters are escaped in 'id' values
+
+[Tracking Issue #25100](https://github.com/dotnet/efcore/issues/25100)
+
+#### Old behavior
+
+In EF Core 5, only `'|'` was escaped in `id` values.
+
+#### New behavior
+
+In EF Core 6, `'/'`, `'\'`, `'?'` and `'#'` are also escaped in `id` values.
+
+#### Why
+
+These characters are invalid, as documented in [Resource.Id](/dotnet/api/microsoft.azure.documents.resource.id). Using them in `id` will cause queries to fail.
+
+#### Mitigations
+
+You can override the generated value by setting it before the entity is marked as `Added`:
+
+```csharp
+var entry = context.Attach(entity);
+entry.Property("__id").CurrentValue = "MyEntity|/\\?#";
+entry.State = EntityState.Added;
+```
+
+<a name="query-services"></a>
+
+### Some Singleton services are now Scoped
+
+[Tracking Issue #25084](https://github.com/dotnet/efcore/issues/25084)
+
+#### New behavior
+
+Many query services and some design-time services that were registered as `Singleton` are now registered as `Scoped`.
+
+#### Why
+
+The lifetime had to be changed to allow a new feature - <xref:Microsoft.EntityFrameworkCore.ModelConfigurationBuilder.DefaultTypeMapping*> - to affect queries.
+
+The design-time services lifetimes have been adjusted to match the run-time services lifetimes to avoid errors when using both.
+
+#### Mitigations
+
+Use <xref:Microsoft.EntityFrameworkCore.Infrastructure.EntityFrameworkServicesBuilder.TryAdd*> to register EF Core services using the default lifetime. Only use <xref:Microsoft.EntityFrameworkCore.Infrastructure.EntityFrameworkServicesBuilder.TryAddProviderSpecificServices*> for services that are not added by EF.
+
+<a name="extensions-caching"></a>
+
+### New caching API for extensions that add or replace services
+
+[Tracking Issue #19152](https://github.com/dotnet/efcore/issues/19152)
+
+#### Old behavior
+
+In EF Core 5, <xref:Microsoft.EntityFrameworkCore.Infrastructure.DbContextOptionsExtensionInfo.GetServiceProviderHashCode*> returned `long` and was used directly as part of the cache key for the service provider.
+
+#### New behavior
+
+<xref:Microsoft.EntityFrameworkCore.Infrastructure.DbContextOptionsExtensionInfo.GetServiceProviderHashCode*> now returns `int` and is only used to calculate the hash code of the cache key for the service provider.
+
+Also, <xref:Microsoft.EntityFrameworkCore.Infrastructure.DbContextOptionsExtensionInfo.ShouldUseSameServiceProvider*> needs to be implemented to indicate whether the current object represents the same service configuration and thus can use the same service provider.
+
+#### Why
+
+Just using a hash code as part of the cache key resulted in occasional collisions that were hard to diagnose and fix. The additional method ensures that the same service provider is used only when appropriate.
+
+#### Mitigations
+
+Many extensions don't expose any options that affect registered services and can use the following implementation of <xref:Microsoft.EntityFrameworkCore.Infrastructure.DbContextOptionsExtensionInfo.ShouldUseSameServiceProvider*>:
+
+```csharp
+private sealed class ExtensionInfo : DbContextOptionsExtensionInfo
+{
+    public ExtensionInfo(IDbContextOptionsExtension extension)
+        : base(extension)
+    {
+    }
+
+    ...
+
+    public override bool ShouldUseSameServiceProvider(DbContextOptionsExtensionInfo other)
+        => other is ExtensionInfo;
+}
+```
+
+Otherwise, additional predicates should be added to compare all relevant options.
+
+<a name="snapshot-initialization"></a>
+
+### New snapshot and design-time model initialization procedure
+
+[Tracking Issue #22031](https://github.com/dotnet/efcore/issues/22031)
+
+#### Old behavior
+
+In EF Core 5, specific conventions needed to be invoked before the snapshot model was ready to be used.
+
+#### New behavior
+
+<xref:Microsoft.EntityFrameworkCore.Infrastructure.IModelRuntimeInitializer> was introduced to hide some of the required steps, and a run-time model was introduced that doesn't have all the migrations metadata, so the design-time model should be used for model diffing.
+
+#### Why
+
+<xref:Microsoft.EntityFrameworkCore.Infrastructure.IModelRuntimeInitializer> abstracts away the model finalization steps, so these can now be changed without further breaking changes for the users.
+
+The optimized run-time model was introduced to improve run-time performance. It has several optimizations, one of which is removing metadata that is not used at run-time.
+
+#### Mitigations
+
+The following snippet illustrates how to check whether the current model is different from the snapshot model:
+
+```csharp
+var snapshotModel = migrationsAssembly.ModelSnapshot?.Model;
+
+if (snapshotModel is IMutableModel mutableModel)
+{
+    snapshotModel = mutableModel.FinalizeModel();
+}
+
+if (snapshotModel != null)
+{
+    snapshotModel = context.GetService<IModelRuntimeInitializer>().Initialize(snapshotModel);
+}
+
+var hasDifferences = context.GetService<IMigrationsModelDiffer>().HasDifferences(
+    snapshotModel?.GetRelationalModel(),
+    context.GetService<IDesignTimeModel>().Model.GetRelationalModel());
+```
+
+This snippet shows how to implement <xref:Microsoft.EntityFrameworkCore.Design.IDesignTimeDbContextFactory`1> by creating a model externally and calling <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseModel*>:
+
+```csharp
+internal class MyDesignContext : IDesignTimeDbContextFactory<MyContext>
+{
+    public TestContext CreateDbContext(string[] args)
+    {
+        var optionsBuilder = new DbContextOptionsBuilder();
+        optionsBuilder.UseSqlServer(Configuration.GetConnectionString("DB"));
+
+        var modelBuilder = SqlServerConventionSetBuilder.CreateModelBuilder();
+        CustomizeModel(modelBuilder);
+        var model = modelBuilder.Model.FinalizeModel();
+
+        var serviceContext = new MyContext(optionsBuilder.Options);
+        model = serviceContext.GetService<IModelRuntimeInitializer>().Initialize(model);
+        return new MyContext(optionsBuilder.Options);
+    }
+}
+```
+
+<a name="owned-index"></a>
+
+### `OwnedNavigationBuilder.HasIndex` returns a different type now
+
+[Tracking Issue #24005](https://github.com/dotnet/efcore/issues/24005)
+
+#### Old behavior
+
+In EF Core 5, <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.OwnedNavigationBuilder.HasIndex*> returned `IndexBuilder<TEntity>` where `TEntity` is the owner type.
+
+#### New behavior
+
+<xref:Microsoft.EntityFrameworkCore.Metadata.Builders.OwnedNavigationBuilder.HasIndex*> now returns `IndexBuilder<TDependentEntity>`, where `TDependentEntity` is the owned type.
+
+#### Why
+
+The returned builder object wasn't typed correctly.
+
+#### Mitigations
+
+Recompiling your assembly against the latest version of EF Core will be enough to fix any issues caused by this change.
+
+<a name="function-schema"></a>
+
+### `DbFunctionBuilder.HasSchema(null)` overrides `[DbFunction(Schema = "schema")]`
+
+[Tracking Issue #24228](https://github.com/dotnet/efcore/issues/24228)
+
+#### Old behavior
+
+In EF Core 5, calling <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.DbFunctionBuilder.HasSchema*> with `null` value didn't store the configuration source, thus <xref:Microsoft.EntityFrameworkCore.DbFunctionAttribute> was able to override it.
+
+#### New behavior
+
+Calling <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.DbFunctionBuilder.HasSchema*> with `null` value now stores the configuration source and prevents the attribute from overriding it.
+
+#### Why
+
+Configuration specified with the <xref:Microsoft.EntityFrameworkCore.ModelBuilder> API should not be overridable by data annotations.
+
+#### Mitigations
+
+Remove the `HasSchema` call to let the attribute configure the schema.
+
+<a name="overwrite-navigations"></a>
+
+### Pre-initialized navigations are overridden by values from database queries
+
+[Tracking Issue #23851](https://github.com/dotnet/efcore/issues/23851)
+
+#### Old behavior
+
+Navigation properties set to an empty object were left unchanged for tracking queries, but were overwritten for non-tracking queries. For example, consider the following entity types:
+
+```csharp
+public class Foo
+{
+    public int Id { get; set; }
+
+    public Bar Bar { get; set; } = new(); // Don't do this.
+}
+
+public class Bar
+{
+    public int Id { get; set; }
+}
+```
+
+A no-tracking query for `Foo` including `Bar` set `Foo.Bar` to the entity queried from the database. For example, this code:
+
+```csharp
+var foo = await context.Foos.AsNoTracking().Include(e => e.Bar).SingleAsync();
+Console.WriteLine($"Foo.Bar.Id = {foo.Bar.Id}");
+```
+
+Printed `Foo.Bar.Id = 1`.
+
+However, the same query run for tracking didn't overwrite `Foo.Bar` with the entity queried from the database. For example, this code:
+
+```csharp
+var foo = await context.Foos.Include(e => e.Bar).SingleAsync();
+Console.WriteLine($"Foo.Bar.Id = {foo.Bar.Id}");
+```
+
+Printed `Foo.Bar.Id = 0`.
+
+#### New behavior
+
+In EF Core 6.0, the behavior of tracking queries now matches that of no-tracking queries. This means that both this code:
+
+```csharp
+var foo = await context.Foos.AsNoTracking().Include(e => e.Bar).SingleAsync();
+Console.WriteLine($"Foo.Bar.Id = {foo.Bar.Id}");
+```
+
+And this code:
+
+```csharp
+var foo = await context.Foos.Include(e => e.Bar).SingleAsync();
+Console.WriteLine($"Foo.Bar.Id = {foo.Bar.Id}");
+```
+
+Print `Foo.Bar.Id = 1`.
+
+#### Why
+
+There are two reasons for making this change:
+
+1. To ensure that tracking and no-tracking queries have consistent behavior.
+2. When a database is queried it is reasonable to assume that the application code wants to get back the values that are stored in the database.
+
+#### Mitigations
+
+There are two mitigations:
+
+1. Do not query for objects from the database that should not be included in the results. For example, in the code snippets above, do not `Include` `Foo.Bar` if the `Bar` instance should not be returned from the database and included in the results.
+2. Set the value of the navigation after querying from the database. For example, in the code snippets above, call `foo.Bar = new()` after running the query.
+
+Also, consider not initializing related entity instances to default objects. This implies that the related instance is a new entity, not saved to the database, with no key value set. If instead the related entity does exist in the database, then the data in code is fundamentally at odds with the data stored in the database.
+
+<a name="unknown-emums"></a>
+
+### Unknown enum string values in the database are not converted to the enum default when queried
+
+[Tracking Issue #24084](https://github.com/dotnet/efcore/issues/24084)
+
+#### Old behavior
+
+Enum properties can be mapped to string columns in the database using `HasConversion<string>()` or `EnumToStringConverter`. This results in EF Core converting string values in the column to matching members of the .NET enum type. However, if the string value did not match and enum member, then the property was set to the default value for the enum.
+
+#### New behavior
+
+EF Core 6.0 now throws an `InvalidOperationException` with the message "Cannot convert string value '`{value}`' from the database to any value in the mapped '`{enumType}`' enum."
+
+#### Why
+
+Converting to the default value can result in database corruption if the entity is later saved back to the database.
+
+#### Mitigations
+
+Ideally, ensure that the database column only contains valid values. Alternately, implement a `ValueConverter` with the old behavior.
+
+<a name="func-args"></a>
+
+### DbFunctionBuilder.HasTranslation now provides the function arguments as IReadOnlyList rather than IReadOnlyCollection
+
+[Tracking Issue #23565](https://github.com/dotnet/efcore/issues/23565)
+
+#### Old behavior
+
+When configuring translation for a user-defined function using `HasTranslation` method, the arguments to the function were provided as `IReadOnlyCollection<SqlExpression>`.
+
+#### New behavior
+
+In EF Core 6.0, the arguments are now provided as `IReadOnlyList<SqlExpression>`.
+
+#### Why
+
+`IReadOnlyList` allows to use indexers, so the arguments are now easier to access.
+
+#### Mitigations
+
+None. `IReadOnlyList` implements `IReadOnlyCollection` interface, so the transition should be straightforward.
+
+<a name="tvf-default-mapping"></a>
+
+### Default table mapping is not removed when the entity is mapped to a table-valued function
+
+[Tracking Issue #23408](https://github.com/dotnet/efcore/issues/23408)
+
+#### Old behavior
+
+When an entity was mapped to a table-valued function, its default mapping to a table was removed.
+
+#### New behavior
+
+In EF Core 6.0, the entity is still mapped to a table using default mapping, even if it's also mapped to table-valued function.
+
+#### Why
+
+Table-valued functions which return entities are often used either as a helper or to encapsulate an operation returning a collection of entities, rather than as a strict replacement of the entire table. This change aims to be more in line with the likely user intention.
+
+#### Mitigations
+
+Mapping to a table can be explicitly disabled in the model configuration:
+
+```csharp
+modelBuilder.Entity<MyEntity>().ToTable((string)null);
+```
+
+<a name="dotnet-ef"></a>
+
+### dotnet-ef targets .NET 6
+
+[Tracking Issue #27787](https://github.com/dotnet/efcore/issues/27787)
+
+#### Old behavior
+
+The dotnet-ef command has targeted .NET Core 3.1 for a while now. This allowed you to use newer version of the tool without installing newer versions of the .NET runtime.
+
+#### New behavior
+
+In EF Core 6.0.6, the dotnet-ef tool now targets .NET 6. You can still use the tool on projects targeting older versions of .NET and .NET Core, but you'll need to install the .NET 6 runtime in order to run the tool.
+
+#### Why
+
+The .NET 6.0.200 SDK updated the behavior of `dotnet tool install` on osx-arm64 to create an osx-x64 shim for tools targeting .NET Core 3.1. In order to maintain a working default experience for dotnet-ef, we had to update it to target .NET 6.
+
+#### Mitigations
+
+To run dotnet-ef without installing the .NET 6 runtime, you can install an older version of the tool:
+
+```dotnetcli
+dotnet tool install dotnet-ef --version 3.1.*
+```
+
+<a name="model-cache-key"></a>
+
+### `IModelCacheKeyFactory` implementations may need to be updated to handle design-time caching
+
+[Tracking Issue #25154](https://github.com/dotnet/efcore/issues/25154)
+
+#### Old behavior
+
+`IModelCacheKeyFactory` did not have an option to cache the design-time model separately from the runtime model.
+
+#### New behavior
+
+`IModelCacheKeyFactory` has a new overload that allows the design-time model to be cached separately from the runtime model. Not implementing this method may result in an exception similar to:
+
+> System.InvalidOperationException: 'The requested configuration is not stored in the read-optimized model, please use 'DbContext.GetService&lt;IDesignTimeModel&gt;().Model'.'
+
+#### Why
+
+Implementation of compiled models required separation of the design-time (used when building the model) and runtime (used when executing queries, etc.) models. If the runtime code needs access to design-time information, then the design-time model must be cached.
+
+#### Mitigations
+
+Implement the new overload. For example:
+
+```csharp
+public object Create(DbContext context, bool designTime)
+    => context is DynamicContext dynamicContext
+        ? (context.GetType(), dynamicContext.UseIntProperty, designTime)
+        : (object)context.GetType();
+```
+
+The navigation '{navigation}' was ignored from 'Include' in the query since the fix-up will automatically populate it. If any further navigations are specified in 'Include' afterwards then they will be ignored. Walking back in the include tree is not allowed.
+
+<a name="ignored-navigation"></a>
+
+### `NavigationBaseIncludeIgnored` is now an error by default
+
+[Tracking Issue #4315](https://github.com/dotnet/EntityFramework.Docs/issues/4315)
+
+#### Old behavior
+
+The event `CoreEventId.NavigationBaseIncludeIgnored` was logged as a warning by default.
+
+#### New behavior
+
+The event `CoreEventId.NavigationBaseIncludeIgnored` was logged as an error by default and causes an exception to be thrown.
+
+#### Why
+
+These query patterns are not allowed, so EF Core now throws to indicate that the queries should be updated.
+
+#### Mitigations
+
+The old behavior can be restored by configuring the event as a warning. For example:
+
+```csharp
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    => optionsBuilder.ConfigureWarnings(b => b.Warn(CoreEventId.NavigationBaseIncludeIgnored));
+```
diff --git a/entity-framework/core/what-is-new/ef-core-6.0/compiled_models.png b/entity-framework/core/what-is-new/ef-core-6.0/compiled_models.png
new file mode 100644
index 0000000000..0ad21bd2c6
Binary files /dev/null and b/entity-framework/core/what-is-new/ef-core-6.0/compiled_models.png differ
diff --git a/entity-framework/core/what-is-new/ef-core-6.0/plan.md b/entity-framework/core/what-is-new/ef-core-6.0/plan.md
new file mode 100644
index 0000000000..4e792f5e57
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-6.0/plan.md
@@ -0,0 +1,346 @@
+---
+title: Plan for Entity Framework Core 6.0
+description: The themes and features planned for EF Core 6.0
+author: SamMonoRT
+ms.date: 11/09/2021
+uid: core/what-is-new/ef-core-6.0/plan
+---
+
+# Plan for Entity Framework Core 6.0
+
+> [!IMPORTANT]
+> EF Core 6.0 [has now been released](xref:core/what-is-new/index). This page remains as a historical record of the plan.
+
+As described in the [planning process](xref:core/what-is-new/release-planning), we have gathered input from stakeholders into a plan for the Entity Framework Core (EF Core) 6.0 release. This plan is periodically updated to reflect schedule and scope adjustments.
+
+Unlike previous releases, this plan does not attempt to cover all work for the 6.0 release. Instead, it indicates where and how we intend to invest in this release, but with flexibility to adjust scope or pull in new work as we gather feedback and learn while working on the release.
+
+> [!IMPORTANT]
+> This plan is not a commitment. It is a starting point that will evolve as we learn more. Some things not currently planned for 6.0 may get pulled in. Some things currently planned for 6.0 may get punted out.
+
+## General information
+
+### Version number and release date
+
+EF Core 6.0 is the next release after EF Core 5.0 and is currently scheduled for release in November 2021 at the same time as .NET 6.
+
+### Supported platforms
+
+EF Core 6.0 requires .NET 6. EF Core 6.0 does not target any .NET Standard version; for more information see [the future of .NET Standard](https://devblogs.microsoft.com/dotnet/the-future-of-net-standard/).
+
+EF Core 6.0 will not run on .NET Framework.
+
+EF Core 6.0 will align with .NET 6 as a [long-term support (LTS) release](https://dotnet.microsoft.com/platform/support/policy/dotnet-core).
+
+### Breaking changes
+
+EF Core 6.0 will contain a small number of [breaking changes](xref:core/what-is-new/ef-core-6.0/breaking-changes) as we continue to evolve both EF Core and the .NET platform. Our goal is to allow the vast majority of applications to update without breaking.
+
+## Themes
+
+The following areas will form the basis for the large investments in EF Core 6.0.
+
+## Highly requested features
+
+As always, a major input into the [planning process](xref:core/what-is-new/release-planning) comes from the [voting (👍) for features on GitHub](https://github.com/dotnet/efcore/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc). For EF Core 6.0 we plan to work on the following highly requested features:
+
+### SQL Server temporal tables
+
+Tracked by [#4693](https://github.com/dotnet/efcore/issues/4693)
+
+Status: Complete
+
+T-shirt size: Large
+
+Temporal tables support queries for data stored in the table at _any point in time_, as opposed to only the most recent data stored as is the case for normal tables. EF Core 6.0 will allow temporal tables to be created via Migrations, as well as allowing access to the data through LINQ queries.
+
+This work is initially scoped as [described on the issue](https://github.com/dotnet/efcore/issues/4693#issuecomment-625048974). We may pull in additional support based on feedback during the release.
+
+### JSON columns
+
+Tracked by [#4021](https://github.com/dotnet/efcore/issues/4021)
+
+Status: Cut
+
+T-shirt size: Medium
+
+This feature will introduce a common mechanism and patterns for JSON support that can be implemented by any database provider. We will work with the community to align existing implementations for [Npgsql](https://github.com/npgsql/efcore.pg) and [Pomelo MySQL](https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql), and also add support for SQL Server and SQLite.
+
+### ColumnAttribute.Order
+
+Tracked by [#10059](https://github.com/dotnet/efcore/issues/10059)
+
+Status: In-progress
+
+T-shirt size: Small
+
+This feature will allow arbitrary ordering of columns when **creating a table** with Migrations or `EnsureCreated`. Note that changing the order of columns in an existing tables requires that the table be rebuilt, and this is not something that we plan to support in any EF Core release.
+
+## Performance
+
+While EF Core is generally faster than EF6, there are still areas where significant improvements in performance are possible. We plan to tackle several of these areas in EF Core 6.0, while also improving our perf infrastructure and testing.
+
+This theme will involve a lot of iterative investigation, which will inform where we focus resources. We plan to begin with:
+
+### Performance infrastructure and new tests
+
+Status: Scoped/Complete
+
+T-shirt size: Medium
+
+The EF Core codebase already contains a set of performance benchmarks that are executed every day. For 6.0, we plan to improve the infrastructure for these tests as well as adding new tests. We will also profile mainline perf scenarios and fix any low-hanging fruit found.
+
+Update: We have improved test infrastructure and added new tests to support the work done for EF Core 6. Additional improvements in this area have been scoped out of the EF Core 6.0 release.
+
+### Compiled models
+
+Tracked by [#1906](https://github.com/dotnet/efcore/issues/1906)
+
+Status: Complete
+
+T-shirt size: X-Large
+
+Compiled models will allow the generation of a compiled form of the EF model. This will provide both better startup performance, as well as generally better performance when accessing the model.
+
+### TechEmpower Fortunes
+
+Tracked by [#23611](https://github.com/dotnet/efcore/issues/23611)
+
+Status: Complete
+
+T-shirt size: X-Large
+
+We have been running the industry standard [TechEmpower benchmarks](https://www.techempower.com/benchmarks/) on .NET against a PostgreSQL database for several years. The [Fortunes benchmark](https://www.techempower.com/benchmarks/#section=data-r19&hw=ph&test=fortune) is particularly relevant to EF scenarios. We have multiple variations of this benchmark, including:
+
+- An implementation that uses ADO.NET directly. This is the fastest implementation of the three listed here.
+- An implementation that uses [Dapper](https://www.nuget.org/packages/Dapper/). This is slower than using ADO.NET directly, but still fast.
+- An implementation that uses EF Core. This is currently the slowest implementation of the three.
+
+The goal for EF Core 6.0 is to get the EF Core performance to match that of Dapper on the TechEmpower Fortunes benchmark. (This is a significant challenge but we will do our best to get as close as we can.)
+
+### Linker/AOT
+
+Tracked by [#10963](https://github.com/dotnet/efcore/issues/10963)
+
+Status: Scoped/Complete
+
+T-shirt size: Medium
+
+EF Core performs large amounts of runtime code generation. This is challenging for app models that depend on linker tree shaking, such as .NET MAUI and Blazor, and platforms that don't allow dynamic compilation, such as iOS. We will continue investigating in this space as part of EF Core 6.0 and make targeted improvements as we can. However, we do not expect to fully close the gap in the 6.0 time frame.
+
+## Migrations and deployment
+
+Following on from the [investigations done for EF Core 5.0](xref:core/what-is-new/ef-core-5.0/plan#migrations-and-deployment-experience), we plan to introduce improved support for managing migrations and deploying databases. This includes two major areas:
+
+### Migrations bundles
+
+Tracked by [#19693](https://github.com/dotnet/efcore/issues/19693)
+
+Status: Complete
+
+T-shirt size: Medium
+
+A migrations bundle is a self-contained executable that applies migrations to a production database. The behavior will match `dotnet ef database update`, but should make SSH/Docker/PowerShell deployment much easier, since everything needed is contained in the single executable.
+
+### Managing migrations
+
+Tracked by [#22945](https://github.com/dotnet/efcore/issues/22945)
+
+Status: Cut
+
+T-shirt size: Large
+
+The number of migrations created for an application can grow to become a burden. In addition, these migrations are frequently deployed with the application even when this is not needed. In EF Core 6.0, we plan to improve this through better tooling and project/assembly management. Two specific issues we plan to address are [squash many migrations into one](https://github.com/dotnet/efcore/issues/2174) and [regenerate a clean model snapshot](https://github.com/dotnet/efcore/issues/18557).
+
+Update: most of the work in this area has been cut for 6.0 due to resource constraints.
+
+## Improve existing features and fix bugs
+
+Any [issue or bug assigned to the 6.0.0 milestone](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+milestone%3A6.0.0) is currently planned for this release. This includes many small enhancements and bug fixes.
+
+### EF6 query parity
+
+Tracked by [issues labeled with 'ef6-parity' and in the 6.0 milestone](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aef6-parity+milestone%3A6.0.0)
+
+Status: Scoped/Complete
+
+T-shirt size: Large
+
+EF Core 5.0 supports most query patterns supported by EF6, in addition to patterns not supported in EF6. For EF Core 6.0, we plan to close the gap and make supported EF Core queries a true superset of supported EF6 queries. This will be driven by investigation of the gaps, but already includes GroupBy issues such as [translate GroupBy followed by FirstOrDefault](https://github.com/dotnet/efcore/issues/12088), and raw SQL queries for [primitive](https://github.com/dotnet/efcore/issues/11624) and [unmapped](https://github.com/dotnet/efcore/issues/10753) types.
+
+Update: Raw SQL queries for primitive and unmapped types has been cut from 6.0 due to resourcing constraints and priority adjustments.
+
+### Value objects
+
+Tracked by [#9906](https://github.com/dotnet/efcore/issues/9906)
+
+Status: Cut
+
+T-shirt size: Medium
+
+It was previously the team view that owned entities, intended for [aggregate support](https://www.martinfowler.com/bliki/DDD_Aggregate.html), would also be a reasonable approximation to [value objects](https://www.martinfowler.com/bliki/ValueObject.html). Experience has shown this not to be the case. Therefore, in EF Core 6.0 we plan to introduce a better experience focused on the needs of value objects in domain-driven design. This approach will be based on value converters rather than owned entities.
+
+This work is initially scoped to allow [value converters which map to multiple columns](https://github.com/dotnet/efcore/issues/13947). We may pull in additional support based on feedback during the release.
+
+### Azure Cosmos DB database provider
+
+Tracked by [issues labeled with 'area-cosmos' and in the 6.0 milestone](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+milestone%3A6.0.0+label%3Aarea-cosmos)
+
+Status: Expanded/Complete
+
+T-shirt size: Large
+
+We are actively gathering feedback on which improvements to make to the Azure Cosmos DB provider in EF Core 6.0. We will update this document as we learn more. For now, please make sure to vote (👍) for the Azure Cosmos DB features that you need.
+
+Update: We have been doing extensive customer development around the Azure Cosmos DB provider. This has resulted in the following enhancements being pulled into EF Core 6.0:
+
+- [Azure Cosmos DB provider should default to implicit ownership](https://github.com/dotnet/efcore/issues/24803)
+- [Set partition key on join entity type by convention](https://github.com/dotnet/efcore/issues/23491)
+- [FromSql support](https://github.com/dotnet/efcore/issues/17311)
+- [Configure TTL per entity/entity type/collection](https://github.com/dotnet/efcore/issues/17307)
+- [API to configure container facets (throughput, size, partition key, etc.)](https://github.com/dotnet/efcore/issues/17301)
+- [Diagnostic events including statistics (query cost, activity id)](https://github.com/dotnet/efcore/issues/17298)
+- [Distinct operator in queries](https://github.com/dotnet/efcore/issues/16144)
+- [Add translators for member/methods which map to built-in functions](https://github.com/dotnet/efcore/issues/16143)
+- [Add basic support for collections and dictionaries of primitive types](https://github.com/dotnet/efcore/issues/14762)
+
+Update: The following issues were cut from the 6.0 release:
+
+- [Find/FindAsync performs SQL API query when entity has embedded entities](https://github.com/dotnet/efcore/issues/24202)
+- [Optimize more queries that could use ReadItem](https://github.com/dotnet/efcore/issues/20693)
+- [Detect partition key filters in more queries](https://github.com/dotnet/efcore/issues/20350)
+- [Translate subquery in filter condition](https://github.com/dotnet/efcore/issues/17957)
+- [Allow to specify consistency level for CUD operations](https://github.com/dotnet/efcore/issues/17309)
+- [Support aggregate operators](https://github.com/dotnet/efcore/issues/16146)
+
+### Expose model building conventions to applications
+
+Tracked by [#214](https://github.com/dotnet/efcore/issues/214)
+
+Status: Cut
+
+T-shirt size: Medium
+
+EF Core uses a set of conventions for building a model from .NET types. These conventions are currently controlled by the database provider. In EF Core 6.0, we intend to allow applications to hook into and change these conventions.
+
+### Zero bug balance (ZBB)
+
+Tracked by [issues labeled with `type-bug` in the 6.0 milestone](https://github.com/dotnet/efcore/issues?utf8=%E2%9C%93&q=is%3Aissue+milestone%3A6.0.0+label%3Atype-bug+)
+
+Status: In-progress/Scoped
+
+T-shirt size: Large
+
+We plan to fix all outstanding bugs during the EF Core 6.0 time frame. Some things to keep in mind:
+
+- This specifically applies to issues labeled [type-bug](https://github.com/dotnet/efcore/issues?q=is%3Aissue+label%3Atype-bug).
+- There will be exceptions, such as when the bug requires a design change or new feature to fix properly. These issues will be marked with the `blocked` label.
+- We will punt bugs based on risk when needed as is normal as we get close to a GA/RTM release.
+
+### Miscellaneous features
+
+Tracked by [issues labeled with `type-enhancement` in the 6.0 milestone](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+milestone%3A6.0.0+label%3Atype-enhancement)
+
+Status: Complete
+
+T-shirt size: Large
+
+Miscellaneous features planned for EF 6.0 include, but are not limited to:
+
+- [Split query for non-navigation collections](https://github.com/dotnet/efcore/issues/21234)
+- [Detect simple join tables in reverse engineering and create many-to-many relationships](https://github.com/dotnet/efcore/issues/22475)
+- [Mechanism/API to specify a default conversion for any property of a given type in the model](https://github.com/dotnet/efcore/issues/10784)
+
+Update: The following issues were cut from the 6.0 release:
+
+- [Complete full/free-text search on SQLite and SQL Server](https://github.com/dotnet/efcore/issues/4823)
+- [SQL Server spatial indexes](https://github.com/dotnet/efcore/issues/12538)
+- [Use the new batching API from ADO.NET](https://github.com/dotnet/efcore/issues/18990)
+
+## .NET integration
+
+The EF Core team also works on several related but independent technologies. In particular, we plan to work on:
+
+### Enhancements to System.Data
+
+Tracked by [issues in the dotnet\runtime repo labeled with `area-System.Data` in the 6.0 milestone](https://github.com/dotnet/runtime/issues?q=is%3Aopen+is%3Aissue+label%3Aarea-System.Data+milestone%3A6.0.0)
+
+Status: Scoped/Complete
+
+T-shirt size: Large
+
+This work includes:
+
+- Implementation of the new [batching API](https://github.com/dotnet/runtime/issues/28633).
+- Continued work with other .NET teams and the community to understand and evolve ADO.NET.
+
+Update: The following issues were cut from the 6.0 release:
+
+- [Standardize on DiagnosticSource for tracing in System.Data.* components](https://github.com/dotnet/runtime/issues/22336).
+
+### Enhancements to Microsoft.Data.Sqlite
+
+Tracked by [issues labeled with `type-enhancement` and `area-adonet-sqlite` in the 6.0 milestone](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+milestone%3A6.0.0+label%3Atype-enhancement+label%3Aarea-adonet-sqlite)
+
+Status: Scoped/Complete
+
+T-shirt size: Medium
+
+Several small improvements are planned for the Microsoft.Data.Sqlite, including [connection pooling](https://github.com/dotnet/efcore/issues/13837) and [prepared statements](https://github.com/dotnet/efcore/issues/14044) for performance.
+
+Update: Prepared statements has been cut from the 6.0 release.
+
+### Nullable reference types
+
+Tracked by [#14150](https://github.com/dotnet/efcore/issues/14150)
+
+Status: Complete
+
+T-shirt size: Large
+
+We will annotate the EF Core code to use [nullable reference types](/dotnet/csharp/nullable-references).
+
+## Experiments and investigations
+
+The EF team is planning to invest time during the EF Core 6.0 timeframe experimenting and investigating in two areas. This is a learning process and as such no concrete deliverables are planned for the 6.0 release.
+
+### SqlServer.Core
+
+Tracked in the [.NET Data Lab repo](https://github.com/dotnet/datalab/)
+
+Status: In-progress
+
+T-shirt size: Ongoing
+
+[Microsoft.Data.SqlClient](https://www.nuget.org/packages/Microsoft.Data.SqlClient/) is a fully-featured ADO.NET database provider for SQL Server. It supports a broad range of SQL Server features on both .NET and .NET Framework. However, it is also a large and old codebase with many complex interactions between its behaviors. This makes it difficult to investigate the potential gains the could be made using newer .NET features. Therefore, we are starting an experiment in collaboration with the community to determine what potential there is for a highly performing SQL Server driver for .NET.
+
+> [!IMPORTANT]
+> Investment in Microsoft.Data.SqlClient is not changing. It will continue to be the recommended way to connect to SQL Server and SQL Azure, both with and without EF Core. It will continue to support new SQL Server features as they are introduced.
+
+### GraphQL
+
+Status: In-progress
+
+T-shirt size: Ongoing
+
+[GraphQL](https://graphql.org/) has been gaining traction over the last few years across a variety of platforms. We plan to investigate the space and find ways to improve the experience with .NET. This will involve working with the community on understanding and supporting the existing ecosystem. It may also involve specific investment from Microsoft, either in the form of contributions to existing work or in developing complimentary pieces in the Microsoft stack.
+
+### DataVerse (formerly Common Data Services)
+
+Status: In-progress
+
+T-shirt size: Ongoing
+
+[DataVerse](/powerapps/maker/data-platform/data-platform-intro) is a column-based data store designed for rapid development of business applications. It automatically handles complex data types like binary objects (BLOBs) and has built-in entities and relationships like organizations and contacts. An SDK exists but developers may benefit from having an EF Core provider to use advanced LINQ queries, take advantage of unit of work and have a consistent data access API. The team will consider different ways to improve the .NET developer experience connecting to DataVerse.
+
+## Below-the-cut-line
+
+Tracked by [issues labeled with `consider-for-current-release`](https://github.com/aspnet/EntityFrameworkCore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release)
+
+These are bug fixes and enhancements that are **not** currently scheduled for the 6.0 release, but we will look at based on feedback throughout the release together with progress made on the work above. These issues may be pulled in to EF Core 6.0, and automatically become candidates for the next release.
+
+In addition, we always consider the [most voted issues](https://github.com/dotnet/efcore/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc) when planning. Cutting any of these issues from a release is always painful, but we do need a realistic plan for the resources we have. Make sure you have voted (👍) for the features you need.
+
+## Suggestions
+
+Your feedback on planning is important. The best way to indicate the importance of an issue is to vote (👍) for that issue on GitHub. This data will then feed into the [planning process](xref:core/what-is-new/release-planning) for the next release.
diff --git a/entity-framework/core/what-is-new/ef-core-6.0/whatsnew.md b/entity-framework/core/what-is-new/ef-core-6.0/whatsnew.md
new file mode 100644
index 0000000000..b33f1dbe0e
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-6.0/whatsnew.md
@@ -0,0 +1,3746 @@
+---
+title: What's New in EF Core 6.0
+description: Overview of new features in EF Core 6.0
+author: SamMonoRT
+ms.date: 12/06/2021
+uid: core/what-is-new/ef-core-6.0/whatsnew
+ms.custom: sfi-ropc-nochange
+---
+
+# What's New in EF Core 6.0
+
+EF Core 6.0 has [shipped to NuGet](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore/). This page contains an overview of interesting changes introduced in this release.
+
+> [!TIP]
+> You can run and debug into the samples shown below by [downloading the sample code from GitHub](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore6).
+
+## SQL Server temporal tables
+
+GitHub Issue: [#4693](https://github.com/dotnet/efcore/issues/4693).
+
+[SQL Server temporal tables](/sql/relational-databases/tables/temporal-tables) automatically keep track of all data ever stored in a table, even after that data has been updated or deleted. This is achieved by creating a parallel "history table" into which timestamped historical data is stored whenever a change is made to the main table. This allows historical data to be queried, such as for auditing, or restored, such as for recovery after accidental mutation or deletion.
+
+EF Core now supports:
+
+* The creation of temporal tables using Migrations
+* Transformation of existing tables into temporal tables, again using Migrations
+* Querying historical data
+* Restoring data from some point in the past
+
+### Configuring a temporal table
+
+The model builder can be used to configure a table as temporal. For example:
+
+<!--
+modelBuilder
+    .Entity<Employee>()
+    .ToTable("Employees", b => b.IsTemporal());
+-->
+[!code-csharp[SimpleConfig](../../../../samples/core/Miscellaneous/NewInEFCore6/TemporalTablesSample.cs?name=SimpleConfig)]
+
+When using EF Core to create the database, the new table will be configured as a temporal table with the SQL Server defaults for the timestamps and history table. For example, consider an `Employee` entity type:
+
+<!--
+    public class Employee
+    {
+        public Guid EmployeeId { get; set; }
+        public string Name { get; set; }
+        public string Position { get; set; }
+        public string Department { get; set; }
+        public string Address { get; set; }
+        public decimal AnnualSalary { get; set; }
+    }
+-->
+[!code-csharp[Employee](../../../../samples/core/Miscellaneous/NewInEFCore6/TemporalTablesSample.cs?name=Employee)]
+
+The temporal table created will look like this:
+
+```sql
+DECLARE @historyTableSchema sysname = SCHEMA_NAME()
+EXEC(N'CREATE TABLE [Employees] (
+    [EmployeeId] uniqueidentifier NOT NULL,
+    [Name] nvarchar(100) NULL,
+    [Position] nvarchar(100) NULL,
+    [Department] nvarchar(100) NULL,
+    [Address] nvarchar(1024) NULL,
+    [AnnualSalary] decimal(10,2) NOT NULL,
+    [PeriodEnd] datetime2 GENERATED ALWAYS AS ROW END NOT NULL,
+    [PeriodStart] datetime2 GENERATED ALWAYS AS ROW START NOT NULL,
+    CONSTRAINT [PK_Employees] PRIMARY KEY ([EmployeeId]),
+    PERIOD FOR SYSTEM_TIME([PeriodStart], [PeriodEnd])
+) WITH (SYSTEM_VERSIONING = ON (HISTORY_TABLE = [' + @historyTableSchema + N'].[EmployeeHistory]))');
+```
+
+Notice that SQL Server creates two hidden `datetime2` columns called `PeriodEnd` and `PeriodStart`. These "period columns" represent the time range during which the data in the row existed. These columns are mapped to [shadow properties](xref:core/modeling/shadow-properties) in the EF Core model, allowing them to be used in queries as shown later.
+
+> [!IMPORTANT]
+> The times in these columns are always UTC time generated by SQL Server. UTC times are used for all operations involving temporal tables, such as in the queries shown below.
+
+Notice also that an associated history table called `EmployeeHistory` is created automatically. The names of the period columns and history table can be changed with additional configuration to the model builder. For example:
+
+<!--
+modelBuilder
+    .Entity<Employee>()
+    .ToTable(
+        "Employees",
+        b => b.IsTemporal(
+            b =>
+            {
+                b.HasPeriodStart("ValidFrom");
+                b.HasPeriodEnd("ValidTo");
+                b.UseHistoryTable("EmployeeHistoricalData");
+            }));
+-->
+[!code-csharp[AdvancedConfig](../../../../samples/core/Miscellaneous/NewInEFCore6/TemporalTablesSample.cs?name=AdvancedConfig)]
+
+This is reflected in the table created by SQL Server:
+
+```sql
+DECLARE @historyTableSchema sysname = SCHEMA_NAME()
+EXEC(N'CREATE TABLE [Employees] (
+    [EmployeeId] uniqueidentifier NOT NULL,
+    [Name] nvarchar(100) NULL,
+    [Position] nvarchar(100) NULL,
+    [Department] nvarchar(100) NULL,
+    [Address] nvarchar(1024) NULL,
+    [AnnualSalary] decimal(10,2) NOT NULL,
+    [ValidFrom] datetime2 GENERATED ALWAYS AS ROW START NOT NULL,
+    [ValidTo] datetime2 GENERATED ALWAYS AS ROW END NOT NULL,
+    CONSTRAINT [PK_Employees] PRIMARY KEY ([EmployeeId]),
+    PERIOD FOR SYSTEM_TIME([ValidFrom], [ValidTo])
+) WITH (SYSTEM_VERSIONING = ON (HISTORY_TABLE = [' + @historyTableSchema + N'].[EmployeeHistoricalData]))');
+```
+
+### Using temporal tables
+
+Most of the time, temporal tables are used just like any other table. That is, the period columns and historical data are handled transparently by SQL Server such that the application can ignore them. For example, new entities can be saved to the database in the normal way:
+
+<!--
+context.AddRange(
+    new Employee
+    {
+        Name = "Pinky Pie",
+        Address = "Sugarcube Corner, Ponyville, Equestria",
+        Department = "DevDiv",
+        Position = "Party Organizer",
+        AnnualSalary = 100.0m
+    },
+    new Employee
+    {
+        Name = "Rainbow Dash",
+        Address = "Cloudominium, Ponyville, Equestria",
+        Department = "DevDiv",
+        Position = "Ponyville weather patrol",
+        AnnualSalary = 900.0m
+    },
+    new Employee
+    {
+        Name = "Fluttershy",
+        Address = "Everfree Forest, Equestria",
+        Department = "DevDiv",
+        Position = "Animal caretaker",
+        AnnualSalary = 30.0m
+    });
+
+context.SaveChanges();
+-->
+[!code-csharp[InsertData](../../../../samples/core/Miscellaneous/NewInEFCore6/TemporalTablesSample.cs?name=InsertData)]
+
+This data can then be queried, updated, and deleted in the normal way. For example:
+
+<!--
+var employee = context.Employees.Single(e => e.Name == "Rainbow Dash");
+context.Remove(employee);
+context.SaveChanges();
+-->
+[!code-csharp[NormalQuery](../../../../samples/core/Miscellaneous/NewInEFCore6/TemporalTablesSample.cs?name=NormalQuery)]
+
+Also, after a normal [tracking query](xref:core/querying/tracking#no-tracking-queries), the values from the period columns of the current data can be [accessed from the tracked entities](xref:core/change-tracking/entity-entries). For example:
+
+<!--
+var employees = context.Employees.ToList();
+foreach (var employee in employees)
+{
+    var employeeEntry = context.Entry(employee);
+    var validFrom = employeeEntry.Property<DateTime>("ValidFrom").CurrentValue;
+    var validTo = employeeEntry.Property<DateTime>("ValidTo").CurrentValue;
+
+    Console.WriteLine($"  Employee {employee.Name} valid from {validFrom} to {validTo}");
+}
+-->
+[!code-csharp[TrackingQuery](../../../../samples/core/Miscellaneous/NewInEFCore6/TemporalTablesSample.cs?name=TrackingQuery)]
+
+This prints:
+
+```none
+Starting data:
+  Employee Pinky Pie valid from 8/26/2021 4:38:58 PM to 12/31/9999 11:59:59 PM
+  Employee Rainbow Dash valid from 8/26/2021 4:38:58 PM to 12/31/9999 11:59:59 PM
+  Employee Fluttershy valid from 8/26/2021 4:38:58 PM to 12/31/9999 11:59:59 PM
+```
+
+Notice that the `ValidTo` column (by default called `PeriodEnd`) contains the `datetime2` max value. This is always the case for the current rows in the table. The `ValidFrom` columns (by default called `PeriodStart`) contains the UTC time that the row was inserted.
+
+### Querying historical data
+
+EF Core supports queries that include historical data through several new query operators:
+
+* `TemporalAsOf`: Returns rows that were active (current) at the given UTC time. This is a single row from the current table or history table for a given primary key.
+* `TemporalAll`: Returns all rows in the historical data. This is typically many rows from the history table and/or the current table for a given primary key.
+* `TemporalFromTo`: Returns all rows that were active between two given UTC times. This may be many rows from the history table and/or the current table for a given primary key.
+* `TemporalBetween`: The same as `TemporalFromTo`, except that rows are included that became active on the upper boundary.
+* `TemporalContainedIn`: Returns all rows that started being active and ended being active between two given UTC times. This may be many rows from the history table and/or the current table for a given primary key.
+
+> [!NOTE]
+> See the [SQL Server temporal tables documentation](/sql/relational-databases/tables/temporal-tables#how-do-i-query-temporal-data) for more information on exactly which rows are included for each of these operators.
+
+For example, after making some updates and deletes to our data, we can run a query using `TemporalAll` to see the historical data:
+
+<!--
+var history = context
+    .Employees
+    .TemporalAll()
+    .Where(e => e.Name == "Rainbow Dash")
+    .OrderBy(e => EF.Property<DateTime>(e, "ValidFrom"))
+    .Select(
+        e => new
+        {
+            Employee = e,
+            ValidFrom = EF.Property<DateTime>(e, "ValidFrom"),
+            ValidTo = EF.Property<DateTime>(e, "ValidTo")
+        })
+    .ToList();
+
+foreach (var pointInTime in history)
+{
+    Console.WriteLine(
+        $"  Employee {pointInTime.Employee.Name} was '{pointInTime.Employee.Position}' from {pointInTime.ValidFrom} to {pointInTime.ValidTo}");
+}
+-->
+[!code-csharp[TemporalAll](../../../../samples/core/Miscellaneous/NewInEFCore6/TemporalTablesSample.cs?name=TemporalAll)]
+
+Notice how the [EF.Property method](xref:core/modeling/shadow-properties#accessing-shadow-properties) can be used to access values from the period columns. This is used in the `OrderBy` clause to sort the data, and then in a projection to include these values in the returned data.
+
+This query brings back the following data:
+
+```none
+Historical data for Rainbow Dash:
+  Employee Rainbow Dash was 'Ponyville weather patrol' from 8/26/2021 4:38:58 PM to 8/26/2021 4:40:29 PM
+  Employee Rainbow Dash was 'Wonderbolt Trainee' from 8/26/2021 4:40:29 PM to 8/26/2021 4:41:59 PM
+  Employee Rainbow Dash was 'Wonderbolt Reservist' from 8/26/2021 4:41:59 PM to 8/26/2021 4:43:29 PM
+  Employee Rainbow Dash was 'Wonderbolt' from 8/26/2021 4:43:29 PM to 8/26/2021 4:44:59 PM
+```
+
+Notice that the last row returned stopped being active at 8/26/2021 4:44:59 PM. This is because the row for Rainbow Dash was deleted from the main table at that time. We will see later how this data can be restored.
+
+Similar queries can be written using `TemporalFromTo`, `TemporalBetween`, or `TemporalContainedIn`. For example:
+
+<!--
+var history = context
+    .Employees
+    .TemporalBetween(timeStamp2, timeStamp3)
+    .Where(e => e.Name == "Rainbow Dash")
+    .OrderBy(e => EF.Property<DateTime>(e, "ValidFrom"))
+    .Select(
+        e => new
+        {
+            Employee = e,
+            ValidFrom = EF.Property<DateTime>(e, "ValidFrom"),
+            ValidTo = EF.Property<DateTime>(e, "ValidTo")
+        })
+    .ToList();
+-->
+[!code-csharp[TemporalBetween](../../../../samples/core/Miscellaneous/NewInEFCore6/TemporalTablesSample.cs?name=TemporalBetween)]
+
+This query returns the following rows:
+
+```none
+Historical data for Rainbow Dash between 8/26/2021 4:41:14 PM and 8/26/2021 4:42:44 PM:
+  Employee Rainbow Dash was 'Wonderbolt Trainee' from 8/26/2021 4:40:29 PM to 8/26/2021 4:41:59 PM
+  Employee Rainbow Dash was 'Wonderbolt Reservist' from 8/26/2021 4:41:59 PM to 8/26/2021 4:43:29 PM
+```
+
+### Restoring historical data
+
+As mentioned above, Rainbow Dash was deleted from the `Employees` table. This was clearly a mistake, so let's go back to a point-in-time and restore the missing row from that time.
+
+<!--
+var employee = context
+    .Employees
+    .TemporalAsOf(timeStamp2)
+    .Single(e => e.Name == "Rainbow Dash");
+
+context.Add(employee);
+context.SaveChanges();
+-->
+[!code-csharp[RestoreData](../../../../samples/core/Miscellaneous/NewInEFCore6/TemporalTablesSample.cs?name=RestoreData)]
+
+This query returns a single row for Rainbow Dash as it was at the given UTC time. All queries using temporal operators are no-tracking by default, so the returned entity here is not tracked. This makes sense, because it does not currently exist in the main table. To re-insert the entity into the main table, we simply mark it as `Added` and then call `SaveChanges`.
+
+After re-inserting the row Rainbow Dash, querying the historical data shows that the row was restored as it was at the given UTC time:
+
+```none
+Historical data for Rainbow Dash:
+  Employee Rainbow Dash was 'Ponyville weather patrol' from 8/26/2021 4:38:58 PM to 8/26/2021 4:40:29 PM
+  Employee Rainbow Dash was 'Wonderbolt Trainee' from 8/26/2021 4:40:29 PM to 8/26/2021 4:41:59 PM
+  Employee Rainbow Dash was 'Wonderbolt Reservist' from 8/26/2021 4:41:59 PM to 8/26/2021 4:43:29 PM
+  Employee Rainbow Dash was 'Wonderbolt' from 8/26/2021 4:43:29 PM to 8/26/2021 4:44:59 PM
+  Employee Rainbow Dash was 'Wonderbolt Trainee' from 8/26/2021 4:44:59 PM to 12/31/9999 11:59:59 PM
+```
+
+## Migration Bundles
+
+GitHub Issue: [#19693](https://github.com/dotnet/efcore/issues/19693).
+
+EF Core migrations are used to generate database schema updates based on changes to the EF model. These schema updates should be applied at application deployment time, often as part of a continuous integration/continuous deployment (C.I./C.D.) system.
+
+EF Core now includes a new way to apply these schema updates: migration bundles. A migration bundle is a small executable containing migrations and the code needed to apply these migrations to the database.
+
+> [!NOTE]
+> See [Introducing DevOps-friendly EF Core Migration Bundles](https://devblogs.microsoft.com/dotnet/introducing-devops-friendly-ef-core-migration-bundles/) on the .NET Blog for a more in-depth discussion on migrations, bundles, and deployment.
+
+Migration bundles are created using the `dotnet ef` command-line tool. Ensure that you have [installed the latest version of the tool](xref:core/cli/dotnet#installing-the-tools) before continuing.
+
+A bundle needs migrations to include. These are created using `dotnet ef migrations add` as described in the [migrations documentation](xref:core/managing-schemas/migrations/index). Once you have migrations ready to deploy, create a bundle using the `dotnet ef migrations bundle`. For example:
+
+```dotnetcli
+PS C:\local\AllTogetherNow\SixOh> dotnet ef migrations bundle
+Build started...
+Build succeeded.
+Building bundle...
+Done. Migrations Bundle: C:\local\AllTogetherNow\SixOh\efbundle.exe
+PS C:\local\AllTogetherNow\SixOh>
+```
+
+The output is an executable suitable for your target operating system. In my case this is Windows x64, so I get an `efbundle.exe` dropped in my local folder. Running this executable applies the migrations contained within it:
+
+```dotnetcli
+PS C:\local\AllTogetherNow\SixOh> .\efbundle.exe
+Applying migration '20210903083845_MyMigration'.
+Done.
+PS C:\local\AllTogetherNow\SixOh>
+```
+
+Migrations are applied to the database only if they have not been already applied. For example, running the same bundle again does nothing, since there are no new migrations to apply:
+
+```dotnetcli
+PS C:\local\AllTogetherNow\SixOh> .\efbundle.exe
+No migrations were applied. The database is already up to date.
+Done.
+PS C:\local\AllTogetherNow\SixOh>
+```
+
+However, if changes are made to the model and more migrations are generated with `dotnet ef migrations add`, then these can be bundled into a new executable ready to apply. For example:
+
+```dotnetcli
+PS C:\local\AllTogetherNow\SixOh> dotnet ef migrations add SecondMigration
+Build started...
+Build succeeded.
+Done. To undo this action, use 'ef migrations remove'
+PS C:\local\AllTogetherNow\SixOh> dotnet ef migrations add Number3
+Build started...
+Build succeeded.
+Done. To undo this action, use 'ef migrations remove'
+PS C:\local\AllTogetherNow\SixOh> dotnet ef migrations bundle --force
+Build started...
+Build succeeded.
+Building bundle...
+Done. Migrations Bundle: C:\local\AllTogetherNow\SixOh\efbundle.exe
+PS C:\local\AllTogetherNow\SixOh>
+```
+
+Notice that the `--force` option can be used to overwrite the existing bundle with a new one.
+
+Executing this new bundle applies these two new migrations to the database:
+
+```dotnetcli
+PS C:\local\AllTogetherNow\SixOh> .\efbundle.exe
+Applying migration '20210903084526_SecondMigration'.
+Applying migration '20210903084538_Number3'.
+Done.
+PS C:\local\AllTogetherNow\SixOh>
+```
+
+By default, the bundle uses the database connection string from your application's configuration. However, a different database can be migrated by passing the connection string on the command line. For example:
+
+```dotnetcli
+PS C:\local\AllTogetherNow\SixOh> .\efbundle.exe --connection "Data Source=(LocalDb)\MSSQLLocalDB;Database=SixOhProduction"
+Applying migration '20210903083845_MyMigration'.
+Applying migration '20210903084526_SecondMigration'.
+Applying migration '20210903084538_Number3'.
+Done.
+PS C:\local\AllTogetherNow\SixOh>
+```
+
+Notice that this time all three migrations were applied, since none of them had yet been applied to the production database.
+
+Other options can be passed to the command line. Some common options are:
+
+* `--output` to specify the path of executable file to create.
+* `--context` to specify the DbContext type to use when the project contains multiple context types.
+* `--project` to specify the project to use. Defaults to the current working directory.
+* `--startup-project` to specify the startup project to use. Defaults to the current working directory.
+* `--no-build` to prevent the project from being built before running the command. This should only be used if the project is known to be up-to-date.
+* `--verbose` to see detailed information on what the command is doing. Use this option when including information in bug reports.
+
+Use `dotnet ef migrations bundle --help` to see all available options.
+
+Note that by default each migration is applied in its own transaction. See [GitHub issue #22616](https://github.com/dotnet/efcore/issues/22616) for a discussion of possible future enhancements in this area.
+
+## Pre-convention model configuration
+
+GitHub Issue: [#12229](https://github.com/dotnet/efcore/issues/12229).
+
+Previous versions of EF Core require that the mapping for every property of a given type is configured explicitly when that mapping differs from the default. This includes "facets" like the maximum length of strings and decimal precision, as well as value conversion for the property type.
+
+This necessitated either:
+
+* Model builder configuration for each property
+* A mapping attribute on each property
+* Explicit iteration over all properties of all entity types and use of the low-level metadata APIs when building the model.
+
+Note that explicit iteration is error-prone and hard to do robustly because the list of entity types and mapped properties may not be final at the time this iteration happens.
+
+EF Core 6.0 allows this mapping configuration to be specified once for a given type. It will then be applied to all properties of that type in the model. This is called "pre-convention model configuration", since it configures aspects of the model that are then used by the model building conventions. Such configuration is applied by overriding `ConfigureConventions` on your `DbContext`:
+
+<!--
+    public class SomeDbContext : DbContext
+    {
+        protected override void ConfigureConventions(
+            ModelConfigurationBuilder configurationBuilder)
+        {
+            // Pre-convention model configuration goes here
+        }
+    }
+-->
+[!code-csharp[WhereItGoes](../../../../samples/core/Miscellaneous/NewInEFCore6/PreConventionModelConfigurationSample.cs?name=WhereItGoes)]
+
+For example, consider the following entity types:
+
+<!--
+    public class Customer
+    {
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public bool IsActive { get; set; }
+        public Money AccountValue { get; set; }
+
+        public Session CurrentSession { get; set; }
+
+        public ICollection<Order> Orders { get; } = new List<Order>();
+    }
+
+    public class Order
+    {
+        public int Id { get; set; }
+        public string SpecialInstructions { get; set; }
+        public DateTime OrderDate { get; set; }
+        public bool IsComplete { get; set; }
+        public Money Price { get; set; }
+        public Money? Discount { get; set; }
+
+        public Customer Customer { get; set; }
+    }
+-->
+[!code-csharp[EntityTypes](../../../../samples/core/Miscellaneous/NewInEFCore6/PreConventionModelConfigurationSample.cs?name=EntityTypes)]
+
+All string properties can be configured to be ANSI (instead of Unicode) and have a maximum length of 1024:
+
+<!--
+            configurationBuilder
+                .Properties<string>()
+                .AreUnicode(false)
+                .HaveMaxLength(1024);
+-->
+[!code-csharp[StringFacets](../../../../samples/core/Miscellaneous/NewInEFCore6/PreConventionModelConfigurationSample.cs?name=StringFacets)]
+
+All DateTime properties can be converted to 64-bit integers in the database, using the default conversion from DateTimes to longs:
+
+<!--
+            configurationBuilder
+                .Properties<DateTime>()
+                .HaveConversion<long>();
+-->
+[!code-csharp[DateTimeConversion](../../../../samples/core/Miscellaneous/NewInEFCore6/PreConventionModelConfigurationSample.cs?name=DateTimeConversion)]
+
+All bool properties can be converted to the integers `0` or `1` using one of the built-in value converters:
+
+<!--
+            configurationBuilder
+                .Properties<bool>()
+                .HaveConversion<BoolToZeroOneConverter<int>>();
+-->
+[!code-csharp[BoolConversion](../../../../samples/core/Miscellaneous/NewInEFCore6/PreConventionModelConfigurationSample.cs?name=BoolConversion)]
+
+Assuming `Session` is a transient property of the entity and should not be persisted, it can be ignored everywhere in the model:
+
+<!--
+            configurationBuilder
+                .IgnoreAny<Session>();
+-->
+[!code-csharp[IgnoreSession](../../../../samples/core/Miscellaneous/NewInEFCore6/PreConventionModelConfigurationSample.cs?name=IgnoreSession)]
+
+Pre-convention model configuration is very useful when working with value objects. For example, the type `Money` in the model above is represented by read-only struct:
+
+<!--
+    public readonly struct Money
+    {
+        [JsonConstructor]
+        public Money(decimal amount, Currency currency)
+        {
+            Amount = amount;
+            Currency = currency;
+        }
+
+        public override string ToString()
+            => (Currency == Currency.UsDollars ? "$" : "£") + Amount;
+
+        public decimal Amount { get; }
+        public Currency Currency { get; }
+    }
+
+    public enum Currency
+    {
+        UsDollars,
+        PoundsSterling
+    }
+-->
+[!code-csharp[MoneyType](../../../../samples/core/Miscellaneous/NewInEFCore6/PreConventionModelConfigurationSample.cs?name=MoneyType)]
+
+This is then serialized to and from JSON using a custom value converter:
+
+<!--
+    public class MoneyConverter : ValueConverter<Money, string>
+    {
+        public MoneyConverter()
+            : base(
+                v => JsonSerializer.Serialize(v, (JsonSerializerOptions)null),
+                v => JsonSerializer.Deserialize<Money>(v, (JsonSerializerOptions)null))
+        {
+        }
+    }
+-->
+[!code-csharp[MoneyConverter](../../../../samples/core/Miscellaneous/NewInEFCore6/PreConventionModelConfigurationSample.cs?name=MoneyConverter)]
+
+This value converter can be configured once for all uses of Money:
+
+<!--
+            configurationBuilder
+                .Properties<Money>()
+                .HaveConversion<MoneyConverter>()
+                .HaveMaxLength(64);
+-->
+[!code-csharp[MoneyConversion](../../../../samples/core/Miscellaneous/NewInEFCore6/PreConventionModelConfigurationSample.cs?name=MoneyConversion)]
+
+Notice also that additional facets can be specified for the string column into which the serialized JSON is stored. In this case, the column is limited to a maximum length of 64.
+
+The tables created for SQL Server using migrations show how the configuration has been applied to all mapped columns:
+
+```sql
+CREATE TABLE [Customers] (
+    [Id] int NOT NULL IDENTITY,
+    [Name] varchar(1024) NULL,
+    [IsActive] int NOT NULL,
+    [AccountValue] nvarchar(64) NOT NULL,
+    CONSTRAINT [PK_Customers] PRIMARY KEY ([Id])
+);
+CREATE TABLE [Order] (
+    [Id] int NOT NULL IDENTITY,
+    [SpecialInstructions] varchar(1024) NULL,
+    [OrderDate] bigint NOT NULL,
+    [IsComplete] int NOT NULL,
+    [Price] nvarchar(64) NOT NULL,
+    [Discount] nvarchar(64) NULL,
+    [CustomerId] int NULL,
+    CONSTRAINT [PK_Order] PRIMARY KEY ([Id]),
+    CONSTRAINT [FK_Order_Customers_CustomerId] FOREIGN KEY ([CustomerId]) REFERENCES [Customers] ([Id])
+);
+```
+
+It is also possible to specify a default type mapping for a given type. For example:
+
+<!--
+            configurationBuilder
+                .DefaultTypeMapping<string>()
+                .IsUnicode(false);
+-->
+[!code-csharp[DefaultTypeMapping](../../../../samples/core/Miscellaneous/NewInEFCore6/PreConventionModelConfigurationSample.cs?name=DefaultTypeMapping)]
+
+This is rarely needed, but can be useful if a type is used in query in a way that is uncorrelated with any mapped property of the model.
+
+> [!NOTE]
+> See [Announcing Entity Framework Core 6.0 Preview 6: Configure Conventions](https://devblogs.microsoft.com/dotnet/announcing-entity-framework-core-6-0-preview-6-configure-conventions/) on the .NET Blog for more discussion and examples of pre-convention model configuration.
+
+## Compiled models
+
+GitHub Issue: [#1906](https://github.com/dotnet/efcore/issues/1906).
+
+Compiled models can improve EF Core startup time for applications with large models. A large model typically means 100s to 1000s of entity types and relationships.
+
+Startup time means the time to perform the first operation on a DbContext when that DbContext type is used for the first time in the application. Note that just creating a DbContext instance does not cause the EF model to be initialized. Instead, typical first operations that cause the model to be initialized include calling `DbContext.Add` or executing the first query.
+
+Compiled models are created using the `dotnet ef` command-line tool. Ensure that you have [installed the latest version of the tool](xref:core/cli/dotnet#installing-the-tools) before continuing.
+
+A new `dbcontext optimize` command is used to generate the compiled model. For example:
+
+```dotnetcli
+dotnet ef dbcontext optimize
+```
+
+The `--output-dir` and `--namespace` options can be used to specify the directory and namespace into which the compiled model will be generated. For example:
+
+```dotnetcli
+PS C:\dotnet\efdocs\samples\core\Miscellaneous\CompiledModels> dotnet ef dbcontext optimize --output-dir MyCompiledModels --namespace MyCompiledModels
+Build started...
+Build succeeded.
+Successfully generated a compiled model, to use it call 'options.UseModel(MyCompiledModels.BlogsContextModel.Instance)'. Run this command again when the model is modified.
+PS C:\dotnet\efdocs\samples\core\Miscellaneous\CompiledModels>
+```
+
+The output from running this command includes a piece of code to copy-and-paste into your DbContext configuration to cause EF Core to use the compiled model. For example:
+
+```csharp
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    => optionsBuilder
+        .UseModel(MyCompiledModels.BlogsContextModel.Instance)
+        .UseSqlite(@"Data Source=test.db");
+```
+
+### Compiled model bootstrapping
+
+It is typically not necessary to look at the generated bootstrapping code. However, sometimes it can be useful to customize the model or its loading. The bootstrapping code looks something like this:
+
+<!--
+[DbContext(typeof(BlogsContext))]
+partial class BlogsContextModel : RuntimeModel
+{
+    private static BlogsContextModel _instance;
+    public static IModel Instance
+    {
+        get
+        {
+            if (_instance == null)
+            {
+                _instance = new BlogsContextModel();
+                _instance.Initialize();
+                _instance.Customize();
+            }
+
+            return _instance;
+        }
+    }
+
+    partial void Initialize();
+
+    partial void Customize();
+}
+-->
+[!code-csharp[RuntimeModel](../../../../samples/core/Miscellaneous/CompiledModels/SingleRuntimeModel.cs?name=RuntimeModel)]
+
+This is a partial class with partial methods that can be implemented to customize the model as needed.
+
+In addition, multiple compiled models can be generated for DbContext types that may use different models depending on some runtime configuration. These should be placed into different folders and namespaces, as shown above. Runtime information, such as the connection string, can then be examined and the correct model returned as needed. For example:
+
+<!--
+public static class RuntimeModelCache
+{
+    private static readonly ConcurrentDictionary<string, IModel> _runtimeModels
+        = new();
+
+    public static IModel GetOrCreateModel(string connectionString)
+        => _runtimeModels.GetOrAdd(
+            connectionString, cs =>
+                {
+                    if (cs.Contains("X"))
+                    {
+                        return BlogsContextModel1.Instance;
+                    }
+
+                    if (cs.Contains("Y"))
+                    {
+                        return BlogsContextModel2.Instance;
+                    }
+
+                    throw new InvalidOperationException("No appropriate compiled model found.");
+                });
+}
+-->
+[!code-csharp[RuntimeModelCache](../../../../samples/core/Miscellaneous/CompiledModels/MultipleRuntimeModels.cs?name=RuntimeModelCache)]
+
+### Limitations
+
+Compiled models have some limitations:
+
+* [Global query filters are not supported](https://github.com/dotnet/efcore/issues/24897).
+* [Lazy loading and change-tracking proxies are not supported](https://github.com/dotnet/efcore/issues/24902).
+* Custom IModelCacheKeyFactory implementations are not supported. However, you can compile multiple models and load the appropriate one as needed.
+* [The model must be manually synchronized by regenerating it any time the model definition or configuration change](https://github.com/dotnet/efcore/issues/24894).
+
+Because of these limitations, you should only use compiled models if your EF Core startup time is too slow. Compiling small models is typically not worth it.
+
+If supporting any of these features is critical to your success, then please vote for the appropriate issues linked above.
+
+### Benchmarks
+
+> [!TIP]
+> You can try compiling a large model and running a benchmark on it by [downloading the sample code from GitHub](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/CompiledModels).
+
+The model in the GitHub repo referenced above contains 449 entity types, 6390 properties, and 720 relationships. This is a moderately large model. Using [BenchmarkDotNet](https://www.nuget.org/packages/BenchmarkDotNet) to measure, the average time to first query is 1.02 seconds on a reasonably powerful laptop. Using compiled models brings this down to 117 milliseconds on the same hardware. An 8x to 10x improvement like this stays relatively constant as the model size increases.
+
+![Compiled model performance improvement](compiled_models.png)
+
+> [!NOTE]
+> See [Announcing Entity Framework Core 6.0 Preview 5: Compiled Models](https://devblogs.microsoft.com/dotnet/announcing-entity-framework-core-6-0-preview-5-compiled-models/) on the .NET Blog for a more in-depth discussion of EF Core startup performance and compiled models.
+
+## Improved performance on TechEmpower Fortunes
+
+GitHub Issue: [#23611](https://github.com/dotnet/efcore/issues/23611).
+
+We made significant improvements to query performance for EF Core 6.0. Specifically:
+
+* EF Core 6.0 performance is now 70% faster on the industry-standard TechEmpower Fortunes benchmark, compared to 5.0.
+  * This is the full-stack perf improvement, including improvements in the benchmark code, the .NET runtime, etc.
+* EF Core 6.0 itself is 31% faster executing untracked queries.
+* Heap allocations have been reduced by 43% when executing queries.
+
+After these improvements, the gap between the popular "micro-ORM" [Dapper](https://github.com/DapperLib/Dapper) and EF Core in the TechEmpower Fortunes benchmark narrowed from 55% to around a little under 5%.
+
+> [!NOTE]
+> See [Announcing Entity Framework Core 6.0 Preview 4: Performance Edition](https://devblogs.microsoft.com/dotnet/announcing-entity-framework-core-6-0-preview-4-performance-edition/) on the .NET Blog for a detailed discussion of query performance improvements in EF Core 6.0.
+
+## Azure Cosmos DB provider enhancements
+
+EF Core 6.0 contains many improvements to the Azure Cosmos DB database provider.
+
+> [!TIP]
+> You can run and debug into all the the Cosmos-specific samples by [downloading the sample code from GitHub](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore6.Cosmos).
+
+### Default to implicit ownership
+
+GitHub Issue: [#24803](https://github.com/dotnet/efcore/issues/24803).
+
+When building a model for the Azure Cosmos DB provider, EF Core 6.0 will mark child entity types as owned by their parent entity by default. This removes the need for much of the `OwnsMany` and `OwnsOne` calls in the Azure Cosmos DB model. This makes it easier to embed child types into the document for the parent type, which is usually the appropriate way to model parents and children in a document database.
+
+For example, consider these entity types:
+
+<!--
+public class Family
+{
+    [JsonPropertyName("id")]
+    public string Id { get; set; }
+    
+    public string LastName { get; set; }
+    public bool IsRegistered { get; set; }
+    
+    public Address Address { get; set; }
+
+    public IList<Parent> Parents { get; } = new List<Parent>();
+    public IList<Child> Children { get; } = new List<Child>();
+}
+
+public class Parent
+{
+    public string FamilyName { get; set; }
+    public string FirstName { get; set; }
+}
+
+public class Child
+{
+    public string FamilyName { get; set; }
+    public string FirstName { get; set; }
+    public int Grade { get; set; }
+
+    public string Gender { get; set; }
+
+    public IList<Pet> Pets { get; } = new List<Pet>();
+}
+-->
+[!code-csharp[Model](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosImplicitOwnershipSample.cs?name=Model)]
+
+In EF Core 5.0, these types would have been modeled for Azure Cosmos DB with the following configuration:
+
+<!--
+modelBuilder.Entity<Family>()
+    .HasPartitionKey(e => e.LastName)
+    .OwnsMany(f => f.Parents);
+
+modelBuilder.Entity<Family>()
+    .OwnsMany(f => f.Children)
+    .OwnsMany(c => c.Pets);
+
+modelBuilder.Entity<Family>()
+    .OwnsOne(f => f.Address);        
+-->
+[!code-csharp[OldOnModelCreating](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosImplicitOwnershipSample.cs?name=OldOnModelCreating)]
+
+In EF Core 6.0, the ownership is implicit, reducing the model configuration to:
+
+<!--
+modelBuilder.Entity<Family>().HasPartitionKey(e => e.LastName);
+-->
+[!code-csharp[OnModelCreating](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosImplicitOwnershipSample.cs?name=OnModelCreating)]
+
+The resulting Azure Cosmos DB documents have the family's parents, children, pets, and address embedded in the family document. For example:
+
+```json
+{
+  "Id": "Wakefield.7",
+  "LastName": "Wakefield",
+  "Discriminator": "Family",
+  "IsRegistered": true,
+  "id": "Family|Wakefield.7",
+  "Address": {
+    "City": "NY",
+    "County": "Manhattan",
+    "State": "NY"
+  },
+  "Children": [
+    {
+      "FamilyName": "Merriam",
+      "FirstName": "Jesse",
+      "Gender": "female",
+      "Grade": 8,
+      "Pets": [
+        {
+          "GivenName": "Goofy"
+        },
+        {
+          "GivenName": "Shadow"
+        }
+      ]
+    },
+    {
+      "FamilyName": "Miller",
+      "FirstName": "Lisa",
+      "Gender": "female",
+      "Grade": 1,
+      "Pets": []
+    }
+  ],
+  "Parents": [
+    {
+      "FamilyName": "Wakefield",
+      "FirstName": "Robin"
+    },
+    {
+      "FamilyName": "Miller",
+      "FirstName": "Ben"
+    }
+  ],
+  "_rid": "x918AKh6p20CAAAAAAAAAA==",
+  "_self": "dbs/x918AA==/colls/x918AKh6p20=/docs/x918AKh6p20CAAAAAAAAAA==/",
+  "_etag": "\"00000000-0000-0000-adee-87f30c8c01d7\"",
+  "_attachments": "attachments/",
+  "_ts": 1632121802
+}
+```
+
+> [!NOTE]
+> It's important to remember that the `OwnsOne`/`OwnsMany` configuration must be used if you need to further configure these owned types.
+
+### Collections of primitive types
+
+GitHub Issue: [#14762](https://github.com/dotnet/efcore/issues/14762).
+
+EF Core 6.0 natively maps collections of primitive types when using the Azure Cosmos DB database provider. For example, consider this entity type:
+
+<!--
+public class Book
+{
+    public Guid Id { get; set; }
+    public string Title { get; set; }
+    public IList<string> Quotes { get; set; }
+    public IDictionary<string, string> Notes { get; set; }
+}
+-->
+[!code-csharp[BookEntity](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosPrimitiveTypesSample.cs?name=BookEntity)]
+
+Both the list and the dictionary can be populated and inserted into the database in the normal way:
+
+<!--
+using var context = new BooksContext();
+
+var book = new Book
+{
+    Title = "How It Works: Incredible History",
+    Quotes = new List<string>
+    {
+        "Thomas (Tommy) Flowers was the British engineer behind the design of the Colossus computer.",
+        "Invented originally for Guinness, plastic widgets are nitrogen-filled spheres.",
+        "For 20 years after its introduction in 1979, the Walkman dominated the personal stereo market."
+    },
+    Notes = new Dictionary<string, string>
+    {
+        { "121", "Fridges" },
+        { "144", "Peter Higgs" },
+        { "48", "Saint Mark's Basilica" },
+        { "36", "The Terracotta Army" }
+    }
+};
+
+context.Add(book);
+context.SaveChanges();
+-->
+[!code-csharp[Insert](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosPrimitiveTypesSample.cs?name=Insert)]
+
+This results in the following JSON document:
+
+```json
+{
+    "Id": "0b32283e-22a8-4103-bb4f-6052604868bd",
+    "Discriminator": "Book",
+    "Notes": {
+        "36": "The Terracotta Army",
+        "48": "Saint Mark's Basilica",
+        "121": "Fridges",
+        "144": "Peter Higgs"
+    },
+    "Quotes": [
+        "Thomas (Tommy) Flowers was the British engineer behind the design of the Colossus computer.",
+        "Invented originally for Guinness, plastic widgets are nitrogen-filled spheres.",
+        "For 20 years after its introduction in 1979, the Walkman dominated the personal stereo market."
+    ],
+    "Title": "How It Works: Incredible History",
+    "id": "Book|0b32283e-22a8-4103-bb4f-6052604868bd",
+    "_rid": "t-E3AIxaencBAAAAAAAAAA==",
+    "_self": "dbs/t-E3AA==/colls/t-E3AIxaenc=/docs/t-E3AIxaencBAAAAAAAAAA==/",
+    "_etag": "\"00000000-0000-0000-9b50-fc769dc901d7\"",
+    "_attachments": "attachments/",
+    "_ts": 1630075016
+}
+```
+
+These collections can then be updated, again in the normal way:
+
+<!--
+book.Quotes.Add("Pressing the emergency button lowered the rods again.");
+book.Notes["48"] = "Chiesa d'Oro";
+
+context.SaveChanges();
+-->
+[!code-csharp[Updates](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosPrimitiveTypesSample.cs?name=Updates)]
+
+Limitations:
+
+* Only dictionaries with string keys are supported
+* Querying into the contents of primitive collections is not currently supported. Vote for [#16926](https://github.com/dotnet/efcore/issues/16926), [#25700](https://github.com/dotnet/efcore/issues/25700), and [#25701](https://github.com/dotnet/efcore/issues/25701) if these features are important to you.
+
+### Translations to built-in functions
+
+GitHub Issue: [#16143](https://github.com/dotnet/efcore/issues/16143).
+
+The Azure Cosmos DB provider now translates more Base Class Library (BCL) methods to Azure Cosmos DB built-in-functions. The following tables show translations that are new in EF Core 6.0.
+
+**String translations**
+
+| BCL method         | Built-in function | Notes                       |
+|:-------------------|-------------------|-----------------------------|
+| `String.Length`    | `LENGTH`          |                             |
+| `String.ToLower`   | `LOWER`           |                             |
+| `String.TrimStart` | `LTRIM`           |                             |
+| `String.TrimEnd`   | `RTRIM`           |                             |
+| `String.Trim`      | `TRIM`            |                             |
+| `String.ToUpper`   | `UPPER`           |                             |
+| `String.Substring` | `SUBSTRING`       |                             |
+| `+` operator       | `CONCAT`          |                             |
+| `String.IndexOf`   | `INDEX_OF`        |                             |
+| `String.Replace`   | `REPLACE`         |                             |
+| `String.Equals`    | `STRINGEQUALS`    | Only case-insensitive calls |
+
+Translations for `LOWER`, `LTRIM`, `RTRIM`, `TRIM`, `UPPER`, and `SUBSTRING` were contributed by [@Marusyk](https://github.com/Marusyk). Many thanks!
+
+For Example:
+
+<!--
+var stringResults =
+    context.Triangles.Where(
+        e => e.Name.Length > 4
+             && e.Name.Trim().ToLower() != "obtuse"
+             && e.Name.TrimStart().Substring(2, 2).Equals("uT", StringComparison.OrdinalIgnoreCase))
+        .ToList();
+-->
+[!code-csharp[StringTranslations](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosQueriesSample.cs?name=StringTranslations)]
+
+Which translates to:
+
+```sql
+SELECT c
+FROM root c
+WHERE ((c["Discriminator"] = "Triangle") AND (((LENGTH(c["Name"]) > 4) AND (LOWER(TRIM(c["Name"])) != "obtuse")) AND STRINGEQUALS(SUBSTRING(LTRIM(c["Name"]), 2, 2), "uT", true)))
+```
+
+**Math translations**
+
+| BCL method                          | Built-in function |
+|:------------------------------------|-------------------|
+| `Math.Abs` or `MathF.Abs`           | `ABS`             |
+| `Math.Acos` or `MathF.Acos`         | `ACOS`            |
+| `Math.Asin` or `MathF.Asin`         | `ASIN`            |
+| `Math.Atan` or `MathF.Atan`         | `ATAN`            |
+| `Math.Atan2` or `MathF.Atan2`       | `ATN2`            |
+| `Math.Ceiling` or `MathF.Ceiling`   | `CEILING`         |
+| `Math.Cos` or `MathF.Cos`           | `COS`             |
+| `Math.Exp` or `MathF.Exp`           | `EXP`             |
+| `Math.Floor` or `MathF.Floor`       | `FLOOR`           |
+| `Math.Log` or `MathF.Log`           | `LOG`             |
+| `Math.Log10` or `MathF.Log10`       | `LOG10`           |
+| `Math.Pow` or `MathF.Pow`           | `POWER`           |
+| `Math.Round` or `MathF.Round`       | `ROUND`           |
+| `Math.Sign` or `MathF.Sign`         | `SIGN`            |
+| `Math.Sin` or `MathF.Sin`           | `SIN`             |
+| `Math.Sqrt` or `MathF.Sqrt`         | `SQRT`            |
+| `Math.Tan` or `MathF.Tan`           | `TAN`             |
+| `Math.Truncate` or `MathF.Truncate` | `TRUNC`           |
+| `DbFunctions.Random`                | `RAND`            |
+
+These translations were contributed by [@Marusyk](https://github.com/Marusyk). Many thanks!
+
+For Example:
+
+<!--
+var hypotenuse = 42.42;
+var mathResults =
+    context.Triangles.Where(
+            e => (Math.Round(e.Angle1) == 90.0
+                  || Math.Round(e.Angle2) == 90.0)
+                 && (hypotenuse * Math.Sin(e.Angle1) > 30.0
+                     || hypotenuse * Math.Cos(e.Angle2) > 30.0))
+        .ToList();
+-->
+[!code-csharp[MathTranslations](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosQueriesSample.cs?name=MathTranslations)]
+
+Which translates to:
+
+```sql
+SELECT c
+FROM root c
+WHERE ((c["Discriminator"] = "Triangle") AND (((ROUND(c["Angle1"]) = 90.0) OR (ROUND(c["Angle2"]) = 90.0)) AND (((@__hypotenuse_0 * SIN(c["Angle1"])) > 30.0) OR ((@__hypotenuse_0 * COS(c["Angle2"])) > 30.0))))
+```
+
+**DateTime translations**
+
+| BCL method        | Built-in function    |
+|:------------------|----------------------|
+| `DateTime.UtcNow` | `GetCurrentDateTime` |
+
+These translations were contributed by [@Marusyk](https://github.com/Marusyk). Many thanks!
+
+For Example:
+
+<!--
+var timeResults =
+    context.Triangles.Where(
+            e => e.InsertedOn <= DateTime.UtcNow)
+        .ToList();
+-->
+[!code-csharp[TimeTranslations](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosQueriesSample.cs?name=TimeTranslations)]
+
+Which translates to:
+
+```sql
+SELECT c
+FROM root c
+WHERE ((c["Discriminator"] = "Triangle") AND (c["InsertedOn"] <= GetCurrentDateTime()))
+```
+
+### Raw SQL queries with FromSql
+
+GitHub Issue: [#17311](https://github.com/dotnet/efcore/issues/17311).
+
+Sometimes it is necessary to execute a raw SQL query instead of using LINQ. This is now supported with the Azure Cosmos DB provider through use of the `FromSql` method. This works the same way it always has done with relational providers. For example:
+
+<!--
+var maxAngle = 60;
+var rawResults
+    = context.Triangles.FromSqlRaw(
+            @"SELECT * FROM root c WHERE c[""Angle1""] <= {0} OR c[""Angle2""] <= {0}",
+            maxAngle)
+        .ToList();
+-->
+[!code-csharp[FromSql](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosQueriesSample.cs?name=FromSql)]
+
+Which is executed as:
+
+```sql
+SELECT c
+FROM (
+    SELECT * FROM root c WHERE c["Angle1"] <= @p0 OR c["Angle2"] <= @p0
+) c
+```
+
+### Distinct queries
+
+GitHub Issue: [#16144](https://github.com/dotnet/efcore/issues/16144).
+
+Simple queries using `Distinct` are now translated. For example:
+
+<!--
+var distinctResults
+    = context.Triangles
+        .Select(e => e.Angle1).OrderBy(e => e).Distinct()
+        .ToList();
+-->
+[!code-csharp[DistictTranslation](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosQueriesSample.cs?name=DistictTranslation)]
+
+Which translates to:
+
+```sql
+SELECT DISTINCT c["Angle1"]
+FROM root c
+WHERE (c["Discriminator"] = "Triangle")
+ORDER BY c["Angle1"]
+```
+
+### Diagnostics
+
+GitHub Issue: [#17298](https://github.com/dotnet/efcore/issues/17298).
+
+The Azure Cosmos DB provider now logs more diagnostic information, including events for inserting, querying, updating, and deleting data from the database. The request units (RU) are included in these events whenever appropriate.
+
+> [!NOTE]
+> The logs show here use `EnableSensitiveDataLogging()` so that ID values are shown.
+
+Inserting an item into the Azure Cosmos DB database generates the `CosmosEventId.ExecutedCreateItem` event. For example, this code:
+
+<!--
+var triangle = new Triangle
+{
+    Name = "Impossible", 
+    PartitionKey = "TrianglesPartition", 
+    Angle1 = 90, 
+    Angle2 = 90, 
+    InsertedOn = DateTime.UtcNow
+};
+context.Add(triangle);
+context.SaveChanges();
+-->
+[!code-csharp[InsertEvents](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosDiagnosticsSample.cs?name=InsertEvents)]
+
+Logs the following diagnostic event:
+
+```none
+info: 8/30/2021 14:41:13.356 CosmosEventId.ExecutedCreateItem[30104] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed CreateItem (5 ms, 7.43 RU) ActivityId='417db46f-fcdd-49d9-a7f0-77210cd06f84', Container='Shapes', Id='Impossible', Partition='TrianglesPartition'
+```
+
+Retrieving items from the Azure Cosmos DB database using a query generates the `CosmosEventId.ExecutingSqlQuery` event, and then one or more `CosmosEventId.ExecutedReadNext` events for the items read. For example, this code:
+
+<!--
+var equilateral = context.Triangles.Single(e => e.Name == "Equilateral");
+-->
+[!code-csharp[QueryEvents](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosDiagnosticsSample.cs?name=QueryEvents)]
+
+Logs the following diagnostic events:
+
+```none
+info: 8/30/2021 14:41:13.475 CosmosEventId.ExecutingSqlQuery[30100] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executing SQL query for container 'Shapes' in partition '(null)' [Parameters=[]]
+      SELECT c
+      FROM root c
+      WHERE ((c["Discriminator"] = "Triangle") AND (c["id"] = "Equilateral"))
+      OFFSET 0 LIMIT 2
+info: 8/30/2021 14:41:13.651 CosmosEventId.ExecutedReadNext[30102] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed ReadNext (169.6126 ms, 2.93 RU) ActivityId='4e465fae-3d49-4c1f-bd04-142bc5d0b0a1', Container='Shapes', Partition='(null)', Parameters=[]
+      SELECT c
+      FROM root c
+      WHERE ((c["Discriminator"] = "Triangle") AND (c["id"] = "Equilateral"))
+      OFFSET 0 LIMIT 2
+```
+
+Retrieving a single item from the Azure Cosmos DB database using `Find` with a partition key generates the `CosmosEventId.ExecutingReadItem` and `CosmosEventId.ExecutedReadItem` events. For example, this code:
+
+<!--
+var isosceles = context.Triangles.Find("Isosceles", "TrianglesPartition");
+-->
+[!code-csharp[FindEvents](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosDiagnosticsSample.cs?name=FindEvents)]
+
+Logs the following diagnostic events:
+
+```none
+info: 8/30/2021 14:53:39.326 CosmosEventId.ExecutingReadItem[30101] (Microsoft.EntityFrameworkCore.Database.Command)
+      Reading resource 'Isosceles' item from container 'Shapes' in partition 'TrianglesPartition'.
+info: 8/30/2021 14:53:39.330 CosmosEventId.ExecutedReadItem[30103] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed ReadItem (1 ms, 1 RU) ActivityId='3c278643-4e7f-4bb2-9953-6055b5f1288f', Container='Shapes', Id='Isosceles', Partition='TrianglesPartition'
+```
+
+Saving an updated item to the Azure Cosmos DB database generates the `CosmosEventId.ExecutedReplaceItem` event. For example, this code:
+
+<!--
+triangle.Angle2 = 89;
+context.SaveChanges();
+-->
+[!code-csharp[UpdateEvents](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosDiagnosticsSample.cs?name=UpdateEvents)]
+
+Logs the following diagnostic event:
+
+```none
+info: 8/30/2021 14:53:39.343 CosmosEventId.ExecutedReplaceItem[30105] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed ReplaceItem (6 ms, 10.67 RU) ActivityId='1525b958-fea1-49e8-89f9-d429d0351fdb', Container='Shapes', Id='Impossible', Partition='TrianglesPartition'
+```
+
+Deleting an item from the Azure Cosmos DB database generates the `CosmosEventId.ExecutedDeleteItem` event. For example, this code:
+
+<!--
+context.Remove(triangle);
+context.SaveChanges();
+-->
+[!code-csharp[DeleteEvents](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosDiagnosticsSample.cs?name=DeleteEvents)]
+
+Logs the following diagnostic event:
+
+```none
+info: 8/30/2021 14:53:39.359 CosmosEventId.ExecutedDeleteItem[30106] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed DeleteItem (6 ms, 7.43 RU) ActivityId='cbc54463-405b-48e7-8c32-2c6502a4138f', Container='Shapes', Id='Impossible', Partition='TrianglesPartition'
+```
+
+### Configure throughput
+
+GitHub Issue: [#17301](https://github.com/dotnet/efcore/issues/17301).
+
+The Azure Cosmos DB model can now be configured with manual or auto-scale throughput. These values provision throughput on the database. For example:
+
+<!--
+modelBuilder.HasManualThroughput(2000);
+modelBuilder.HasAutoscaleThroughput(6000);
+-->
+[!code-csharp[ModelThroughput](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosModelConfigurationSample.cs?name=ModelThroughput)]
+
+In addition, individual entity types can be configured to provision throughput for the corresponding container. For example:
+
+<!--
+modelBuilder.Entity<Family>(
+    entityTypeBuilder =>
+    {
+        entityTypeBuilder.HasAutoscaleThroughput(3000);
+        entityTypeBuilder.HasAutoscaleThroughput(12000);
+    });
+-->
+[!code-csharp[EntityTypeThroughput](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosModelConfigurationSample.cs?name=EntityTypeThroughput)]
+
+### Configure time-to-live
+
+GitHub Issue: [#17307](https://github.com/dotnet/efcore/issues/17307).
+
+Entity types in the Azure Cosmos DB model can now be configured with the default time-to-live and time-to-live for the analytical store. For example:
+
+<!--
+modelBuilder.Entity<Family>(
+    entityTypeBuilder =>
+    {
+        entityTypeBuilder.HasDefaultTimeToLive(100);
+        entityTypeBuilder.HasAnalyticalStoreTimeToLive(200);
+    });
+-->
+[!code-csharp[TimeToLive](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosModelConfigurationSample.cs?name=TimeToLive)]
+
+### Resolve HTTP client factory
+
+GitHub Issue: [#21274](https://github.com/dotnet/efcore/issues/21274). This feature was contributed by [@dnperfors](https://github.com/dnperfors). Many thanks!
+
+The `HttpClientFactory` used by the Azure Cosmos DB provider can now be set explicitly. This can be especially useful during testing, for example to bypass certificate validation when using the Azure Cosmos DB emulator on Linux:
+
+<!--
+optionsBuilder
+    .EnableSensitiveDataLogging()
+    .UseCosmos(
+        "https://localhost:8081",
+        "C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==",
+        "PrimitiveCollections",
+        cosmosOptionsBuilder =>
+        {
+            cosmosOptionsBuilder.HttpClientFactory(
+                () => new HttpClient(
+                    new HttpClientHandler
+                    {
+                        ServerCertificateCustomValidationCallback =
+                            HttpClientHandler.DangerousAcceptAnyServerCertificateValidator
+                    }));
+        });
+-->
+[!code-csharp[HttpClientFactory](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosPrimitiveTypesSample.cs?name=HttpClientFactory)]
+
+> [!NOTE]
+> See [Taking the EF Core Azure Cosmos DB Provider for a Test Drive](https://devblogs.microsoft.com/dotnet/taking-the-ef-core-azure-cosmos-db-provider-for-a-test-drive/) on the .NET Blog for a detailed example of applying the Azure Cosmos DB provider improvements to an existing application.
+
+## Improvements to scaffolding from an existing database
+
+EF Core 6.0 contains several improvements when reverse engineering an EF model from an existing database.
+
+### Scaffolding many-to-many relationships
+
+GitHub Issue: [#22475](https://github.com/dotnet/efcore/issues/22475).
+
+EF Core 6.0 detects simple join tables and automatically generates a many-to-many mapping for them. For example, consider tables for `Posts` and `Tags`, and a join table `PostTag` connecting them:
+
+```sql
+CREATE TABLE [Tags] (
+  [Id] int NOT NULL IDENTITY,
+  [Name] nvarchar(max) NOT NULL,
+  [Description] nvarchar(max) NULL,
+  CONSTRAINT [PK_Tags] PRIMARY KEY ([Id]));
+
+CREATE TABLE [Posts] (
+    [Id] int NOT NULL IDENTITY,
+    [Title] nvarchar(max) NOT NULL,
+    [Contents] nvarchar(max) NOT NULL,
+    [PostedOn] datetime2 NOT NULL,
+    [UpdatedOn] datetime2 NULL,
+    CONSTRAINT [PK_Posts] PRIMARY KEY ([Id]));
+
+CREATE TABLE [PostTag] (
+    [PostsId] int NOT NULL,
+    [TagsId] int NOT NULL,
+    CONSTRAINT [PK_PostTag] PRIMARY KEY ([PostsId], [TagsId]),
+    CONSTRAINT [FK_PostTag_Posts_TagsId] FOREIGN KEY ([TagsId]) REFERENCES [Tags] ([Id]) ON DELETE CASCADE,
+    CONSTRAINT [FK_PostTag_Tags_PostsId] FOREIGN KEY ([PostsId]) REFERENCES [Posts] ([Id]) ON DELETE CASCADE);
+```
+
+These tables can be scaffolded from the command line. For example:
+
+```dotnetcli
+dotnet ef dbcontext scaffold "Data Source=(localdb)\MSSQLLocalDB;Initial Catalog=BloggingWithNRTs" Microsoft.EntityFrameworkCore.SqlServer
+```
+
+This results in a class for Post:
+
+<!--
+public partial class Post
+{
+    public int Id { get; set; }
+    public string Title { get; set; } = null!;
+    public string Contents { get; set; } = null!;
+    public DateTime PostedOn { get; set; }
+    public DateTime? UpdatedOn { get; set; }
+    public int BlogId { get; set; }
+
+    public virtual Blog Blog { get; set; } = null!;
+
+    public virtual ICollection<Tag> Tags { get; set; }
+}
+-->
+[!code-csharp[Post](../../../../samples/core/Miscellaneous/NewInEFCore6/ScaffoldingSample.cs?name=Post)]
+
+And a class for Tag:
+
+<!--
+    public partial class Tag
+    {
+        public int Id { get; set; }
+        public string Name { get; set; } = null!;
+        public string? Description { get; set; }
+
+        public virtual ICollection<Post> Posts { get; set; }
+    }
+-->
+[!code-csharp[Tag](../../../../samples/core/Miscellaneous/NewInEFCore6/ScaffoldingSample.cs?name=Tag)]
+
+But no class for the `PostTag` table. Instead, configuration for a many-to-many relationship is scaffolded:
+
+<!--
+entity.HasMany(d => d.Tags)
+    .WithMany(p => p.Posts)
+    .UsingEntity<Dictionary<string, object>>(
+        "PostTag",
+        l => l.HasOne<Tag>().WithMany().HasForeignKey("PostsId"),
+        r => r.HasOne<Post>().WithMany().HasForeignKey("TagsId"),
+        j =>
+            {
+                j.HasKey("PostsId", "TagsId");
+                j.ToTable("PostTag");
+                j.HasIndex(new[] { "TagsId" }, "IX_PostTag_TagsId");
+            });
+-->
+[!code-csharp[ManyToMany](../../../../samples/core/Miscellaneous/NewInEFCore6/ScaffoldingSample.cs?name=ManyToMany)]
+
+### Scaffold C# nullable reference types
+
+GitHub Issue: [#15520](https://github.com/dotnet/efcore/issues/15520).
+
+EF Core 6.0 now scaffolds an EF model and entity types that use C# nullable reference types (NRTs). NRT usage is scaffolded automatically when NRT support is enabled in the C# project into which the code is being scaffolded.
+
+For example, the following `Tags` table contains both nullable non-nullable string columns:
+
+```sql
+CREATE TABLE [Tags] (
+  [Id] int NOT NULL IDENTITY,
+  [Name] nvarchar(max) NOT NULL,
+  [Description] nvarchar(max) NULL,
+  CONSTRAINT [PK_Tags] PRIMARY KEY ([Id]));
+```
+
+This results in corresponding nullable and non-nullable string properties in the generated class:
+
+<!--
+    public partial class Tag
+    {
+        public int Id { get; set; }
+        public string Name { get; set; } = null!;
+        public string? Description { get; set; }
+
+        public virtual ICollection<Post> Posts { get; set; }
+    }
+-->
+[!code-csharp[Tag](../../../../samples/core/Miscellaneous/NewInEFCore6/ScaffoldingSample.cs?name=Tag)]
+
+Similarly, the following `Posts` tables contains a required relationship to the `Blogs` table:
+
+```sql
+CREATE TABLE [Posts] (
+    [Id] int NOT NULL IDENTITY,
+    [Title] nvarchar(max) NOT NULL,
+    [Contents] nvarchar(max) NOT NULL,
+    [PostedOn] datetime2 NOT NULL,
+    [UpdatedOn] datetime2 NULL,
+    [BlogId] int NOT NULL,
+    CONSTRAINT [PK_Posts] PRIMARY KEY ([Id]),
+    CONSTRAINT [FK_Posts_Blogs_BlogId] FOREIGN KEY ([BlogId]) REFERENCES [Blogs] ([Id]));
+```
+
+This results in the scaffolding of non-nullable (required) relationship between blogs:  
+
+<!--
+    public partial class Blog
+    {
+        public Blog()
+        {
+            Posts = new HashSet<Post>();
+        }
+
+        public int Id { get; set; }
+        public string Name { get; set; } = null!;
+
+        public virtual ICollection<Post> Posts { get; set; }
+    }
+-->
+[!code-csharp[Blog](../../../../samples/core/Miscellaneous/NewInEFCore6/ScaffoldingSample.cs?name=Blog)]
+
+And posts:
+
+<!--
+public partial class Post
+{
+    public int Id { get; set; }
+    public string Title { get; set; } = null!;
+    public string Contents { get; set; } = null!;
+    public DateTime PostedOn { get; set; }
+    public DateTime? UpdatedOn { get; set; }
+    public int BlogId { get; set; }
+
+    public virtual Blog Blog { get; set; } = null!;
+
+    public virtual ICollection<Tag> Tags { get; set; }
+}
+-->
+[!code-csharp[Post](../../../../samples/core/Miscellaneous/NewInEFCore6/ScaffoldingSample.cs?name=Post)]
+
+Finally, DbSet properties in the generated DbContext are created in a NRT-friendly way. For example:
+
+<!--
+public virtual DbSet<Blog> Blogs { get; set; } = null!;
+public virtual DbSet<Post> Posts { get; set; } = null!;
+public virtual DbSet<Tag> Tags { get; set; } = null!;
+-->
+[!code-csharp[DbSets](../../../../samples/core/Miscellaneous/NewInEFCore6/ScaffoldingSample.cs?name=DbSets)]
+
+### Database comments are scaffolded to code comments
+
+GitHub Issue: [#19113](https://github.com/dotnet/efcore/issues/19113). This feature was contributed by [@ErikEJ](https://github.com/ErikEJ). Many thanks!
+
+Comments on SQL tables and columns are now scaffolded into the entity types created when [reverse-engineering an EF Core model](xref:core/managing-schemas/scaffolding) from an existing SQL Server database.
+
+```csharp
+/// <summary>
+/// The Blog table.
+/// </summary>
+public partial class Blog
+{
+    /// <summary>
+    /// The primary key.
+    /// </summary>
+    [Key]
+    public int Id { get; set; }
+}
+```
+
+## LINQ query enhancements
+
+EF Core 6.0 contains several improvements in the translation and execution of LINQ queries.
+
+### Improved GroupBy support
+
+GitHub Issues: [#12088](https://github.com/dotnet/efcore/issues/12088), [#13805](https://github.com/dotnet/efcore/issues/13805), and [#22609](https://github.com/dotnet/efcore/issues/22609).
+
+EF Core 6.0 contains better support for `GroupBy` queries. Specifically, EF Core now:
+
+* Translate GroupBy followed by `FirstOrDefault` (or similar) over a group
+* Supports selecting the top N results from a group
+* Expands navigations after the `GroupBy` operator has been applied
+
+The following are example queries from customer reports and their translation on SQL Server.
+
+**Example 1:**
+
+<!--
+var people = context.People
+    .Include(e => e.Shoes)
+    .GroupBy(e => e.FirstName)
+    .Select(
+        g => g.OrderBy(e => e.FirstName)
+            .ThenBy(e => e.LastName)
+            .FirstOrDefault())
+    .ToList();
+-->
+[!code-csharp[GroupBy1](../../../../samples/core/Miscellaneous/NewInEFCore6/GroupBySample.cs?name=GroupBy1)]
+
+```sql
+SELECT [t0].[Id], [t0].[Age], [t0].[FirstName], [t0].[LastName], [t0].[MiddleInitial], [t].[FirstName], [s].[Id], [s].[Age], [s].[PersonId], [s].[Style]
+FROM (
+    SELECT [p].[FirstName]
+    FROM [People] AS [p]
+    GROUP BY [p].[FirstName]
+) AS [t]
+LEFT JOIN (
+    SELECT [t1].[Id], [t1].[Age], [t1].[FirstName], [t1].[LastName], [t1].[MiddleInitial]
+    FROM (
+        SELECT [p0].[Id], [p0].[Age], [p0].[FirstName], [p0].[LastName], [p0].[MiddleInitial], ROW_NUMBER() OVER(PARTITION BY [p0].[FirstName] ORDER BY [p0].[FirstName], [p0].[LastName]) AS [row]
+        FROM [People] AS [p0]
+    ) AS [t1]
+    WHERE [t1].[row] <= 1
+) AS [t0] ON [t].[FirstName] = [t0].[FirstName]
+LEFT JOIN [Shoes] AS [s] ON [t0].[Id] = [s].[PersonId]
+ORDER BY [t].[FirstName], [t0].[FirstName]
+```
+
+**Example 2:**
+
+<!--
+var group = context.People
+    .Select(
+        p => new
+        {
+            p.FirstName,
+            FullName = p.FirstName + " " + p.MiddleInitial + " " + p.LastName
+        })
+    .GroupBy(p => p.FirstName)
+    .Select(g => g.First())
+    .First();
+-->
+[!code-csharp[GroupBy2](../../../../samples/core/Miscellaneous/NewInEFCore6/GroupBySample.cs?name=GroupBy2)]
+
+```sql
+SELECT [t0].[FirstName], [t0].[FullName], [t0].[c]
+FROM (
+    SELECT TOP(1) [p].[FirstName]
+    FROM [People] AS [p]
+    GROUP BY [p].[FirstName]
+) AS [t]
+LEFT JOIN (
+    SELECT [t1].[FirstName], [t1].[FullName], [t1].[c]
+    FROM (
+        SELECT [p0].[FirstName], (((COALESCE([p0].[FirstName], N'') + N' ') + COALESCE([p0].[MiddleInitial], N'')) + N' ') + COALESCE([p0].[LastName], N'') AS [FullName], 1 AS [c], ROW_NUMBER() OVER(PARTITION BY [p0].[FirstName] ORDER BY [p0].[FirstName]) AS [row]
+        FROM [People] AS [p0]
+    ) AS [t1]
+    WHERE [t1].[row] <= 1
+) AS [t0] ON [t].[FirstName] = [t0].[FirstName]
+```
+
+**Example 3:**
+
+<!--
+var people = context.People
+    .Where(e => e.MiddleInitial == "Q" && e.Age == 20)
+    .GroupBy(e => e.LastName)
+    .Select(g => g.First().LastName)
+    .OrderBy(e => e.Length)
+    .ToList();
+-->
+[!code-csharp[GroupBy3](../../../../samples/core/Miscellaneous/NewInEFCore6/GroupBySample.cs?name=GroupBy3)]
+
+```sql
+SELECT (
+    SELECT TOP(1) [p1].[LastName]
+    FROM [People] AS [p1]
+    WHERE (([p1].[MiddleInitial] = N'Q') AND ([p1].[Age] = 20)) AND (([p].[LastName] = [p1].[LastName]) OR ([p].[LastName] IS NULL AND [p1].[LastName] IS NULL)))
+FROM [People] AS [p]
+WHERE ([p].[MiddleInitial] = N'Q') AND ([p].[Age] = 20)
+GROUP BY [p].[LastName]
+ORDER BY CAST(LEN((
+    SELECT TOP(1) [p1].[LastName]
+    FROM [People] AS [p1]
+    WHERE (([p1].[MiddleInitial] = N'Q') AND ([p1].[Age] = 20)) AND (([p].[LastName] = [p1].[LastName]) OR ([p].[LastName] IS NULL AND [p1].[LastName] IS NULL)))) AS int)
+```
+
+**Example 4:**
+
+<!--
+var results = (from person in context.People
+               join shoes in context.Shoes on person.Age equals shoes.Age
+               group shoes by shoes.Style
+               into people
+               select new
+               {
+                   people.Key,
+                   Style = people.Select(p => p.Style).FirstOrDefault(),
+                   Count = people.Count()
+               })
+    .ToList();
+-->
+[!code-csharp[GroupBy4](../../../../samples/core/Miscellaneous/NewInEFCore6/GroupBySample.cs?name=GroupBy4)]
+
+```sql
+SELECT [s].[Style] AS [Key], (
+    SELECT TOP(1) [s0].[Style]
+    FROM [People] AS [p0]
+    INNER JOIN [Shoes] AS [s0] ON [p0].[Age] = [s0].[Age]
+    WHERE ([s].[Style] = [s0].[Style]) OR ([s].[Style] IS NULL AND [s0].[Style] IS NULL)) AS [Style], COUNT(*) AS [Count]
+FROM [People] AS [p]
+INNER JOIN [Shoes] AS [s] ON [p].[Age] = [s].[Age]
+GROUP BY [s].[Style]
+```
+
+**Example 5:**
+
+<!--
+var results = context.People
+    .GroupBy(e => e.FirstName)
+    .Select(g => g.First().LastName)
+    .OrderBy(e => e)
+    .ToList();
+-->
+[!code-csharp[GroupBy5](../../../../samples/core/Miscellaneous/NewInEFCore6/GroupBySample.cs?name=GroupBy5)]
+
+```sql
+SELECT (
+    SELECT TOP(1) [p1].[LastName]
+    FROM [People] AS [p1]
+    WHERE ([p].[FirstName] = [p1].[FirstName]) OR ([p].[FirstName] IS NULL AND [p1].[FirstName] IS NULL))
+FROM [People] AS [p]
+GROUP BY [p].[FirstName]
+ORDER BY (
+    SELECT TOP(1) [p1].[LastName]
+    FROM [People] AS [p1]
+    WHERE ([p].[FirstName] = [p1].[FirstName]) OR ([p].[FirstName] IS NULL AND [p1].[FirstName] IS NULL))
+```
+
+**Example 6:**
+
+<!--
+var results = context.People.Where(e => e.Age == 20)
+    .GroupBy(e => e.Id)
+    .Select(g => g.First().MiddleInitial)
+    .OrderBy(e => e)
+    .ToList();
+-->
+[!code-csharp[GroupBy6](../../../../samples/core/Miscellaneous/NewInEFCore6/GroupBySample.cs?name=GroupBy6)]
+
+```sql
+SELECT (
+    SELECT TOP(1) [p1].[MiddleInitial]
+    FROM [People] AS [p1]
+    WHERE ([p1].[Age] = 20) AND ([p].[Id] = [p1].[Id]))
+FROM [People] AS [p]
+WHERE [p].[Age] = 20
+GROUP BY [p].[Id]
+ORDER BY (
+    SELECT TOP(1) [p1].[MiddleInitial]
+    FROM [People] AS [p1]
+    WHERE ([p1].[Age] = 20) AND ([p].[Id] = [p1].[Id]))
+```
+
+**Example 7:**
+
+<!--
+var size = 11;
+var results
+    = context.People
+        .Where(
+            p => p.Feet.Size == size
+                 && p.MiddleInitial != null
+                 && p.Feet.Id != 1)
+        .GroupBy(
+            p => new
+            {
+                p.Feet.Size,
+                p.Feet.Person.LastName
+            })
+        .Select(
+            g => new
+            {
+                g.Key.LastName,
+                g.Key.Size,
+                Min = g.Min(p => p.Feet.Size),
+            })
+        .ToList();
+-->
+[!code-csharp[GroupBy7](../../../../samples/core/Miscellaneous/NewInEFCore6/GroupBySample.cs?name=GroupBy7)]
+
+```sql
+Executed DbCommand (12ms) [Parameters=[@__size_0='11'], CommandType='Text', CommandTimeout='30']
+SELECT [p0].[LastName], [f].[Size], MIN([f0].[Size]) AS [Min]
+FROM [People] AS [p]
+LEFT JOIN [Feet] AS [f] ON [p].[Id] = [f].[Id]
+LEFT JOIN [People] AS [p0] ON [f].[Id] = [p0].[Id]
+LEFT JOIN [Feet] AS [f0] ON [p].[Id] = [f0].[Id]
+WHERE (([f].[Size] = @__size_0) AND [p].[MiddleInitial] IS NOT NULL) AND (([f].[Id] <> 1) OR [f].[Id] IS NULL)
+GROUP BY [f].[Size], [p0].[LastName]
+```
+
+**Example 8:**
+
+<!--
+var result = context.People
+    .Include(x => x.Shoes)
+    .Include(x => x.Feet)
+    .GroupBy(
+        x => new
+        {
+            x.Feet.Id,
+            x.Feet.Size
+        })
+    .Select(
+        x => new
+        {
+            Key = x.Key.Id + x.Key.Size,
+            Count = x.Count(),
+            Sum = x.Sum(el => el.Id),
+            SumOver60 = x.Sum(el => el.Id) / (decimal)60,
+            TotalCallOutCharges = x.Sum(el => el.Feet.Size == 11 ? 1 : 0)
+        })
+    .Count();
+-->
+[!code-csharp[GroupBy8](../../../../samples/core/Miscellaneous/NewInEFCore6/GroupBySample.cs?name=GroupBy8)]
+
+```sql
+SELECT COUNT(*)
+FROM (
+    SELECT [f].[Id], [f].[Size]
+    FROM [People] AS [p]
+    LEFT JOIN [Feet] AS [f] ON [p].[Id] = [f].[Id]
+    GROUP BY [f].[Id], [f].[Size]
+) AS [t]
+```
+
+**Example 9:**
+
+<!--
+var results = context.People
+    .GroupBy(n => n.FirstName)
+    .Select(g => new 
+    {
+        Feet = g.Key,
+        Total = g.Sum(n => n.Feet.Size) 
+    })
+    .ToList();
+-->
+[!code-csharp[GroupBy9](../../../../samples/core/Miscellaneous/NewInEFCore6/GroupBySample.cs?name=GroupBy9)]
+
+```sql
+SELECT [p].[FirstName] AS [Feet], COALESCE(SUM([f].[Size]), 0) AS [Total]
+FROM [People] AS [p]
+LEFT JOIN [Feet] AS [f] ON [p].[Id] = [f].[Id]
+GROUP BY [p].[FirstName]
+```
+
+**Example 10:**
+
+<!--
+var results = from Person person1
+                  in from Person person2
+                         in context.People
+                     select person2
+              join Shoes shoes
+                  in context.Shoes
+                  on person1.Age equals shoes.Age
+              group shoes by
+                  new
+                  {
+                      person1.Id,
+                      shoes.Style,
+                      shoes.Age
+                  }
+              into temp
+              select
+                  new
+                  {
+                      temp.Key.Id,
+                      temp.Key.Age,
+                      temp.Key.Style,
+                      Values = from t
+                                   in temp
+                               select
+                                   new
+                                   {
+                                       t.Id,
+                                       t.Style,
+                                       t.Age
+                                   }
+                  };
+-->
+[!code-csharp[GroupBy10](../../../../samples/core/Miscellaneous/NewInEFCore6/GroupBySample.cs?name=GroupBy10)]
+
+```sql
+SELECT [t].[Id], [t].[Age], [t].[Style], [t0].[Id], [t0].[Style], [t0].[Age], [t0].[Id0]
+FROM (
+    SELECT [p].[Id], [s].[Age], [s].[Style]
+    FROM [People] AS [p]
+    INNER JOIN [Shoes] AS [s] ON [p].[Age] = [s].[Age]
+    GROUP BY [p].[Id], [s].[Style], [s].[Age]
+) AS [t]
+LEFT JOIN (
+    SELECT [s0].[Id], [s0].[Style], [s0].[Age], [p0].[Id] AS [Id0]
+    FROM [People] AS [p0]
+    INNER JOIN [Shoes] AS [s0] ON [p0].[Age] = [s0].[Age]
+) AS [t0] ON (([t].[Id] = [t0].[Id0]) AND (([t].[Style] = [t0].[Style]) OR ([t].[Style] IS NULL AND [t0].[Style] IS NULL))) AND ([t].[Age] = [t0].[Age])
+ORDER BY [t].[Id], [t].[Style], [t].[Age], [t0].[Id0]
+```
+
+**Example 11:**
+
+<!--
+var grouping = context.People
+    .GroupBy(i => i.LastName)
+    .Select(g => new { LastName = g.Key, Count = g.Count() , First = g.FirstOrDefault(), Take = g.Take(2)})
+    .OrderByDescending(e => e.LastName)
+    .ToList();
+-->
+[!code-csharp[GroupBy11](../../../../samples/core/Miscellaneous/NewInEFCore6/GroupBySample.cs?name=GroupBy11)]
+
+```sql
+SELECT [t].[LastName], [t].[c], [t0].[Id], [t2].[Id], [t2].[Age], [t2].[FirstName], [t2].[LastName], [t2].[MiddleInitial], [t0].[Age], [t0].[FirstName], [t0].[LastName], [t0].[MiddleInitial]
+FROM (
+    SELECT [p].[LastName], COUNT(*) AS [c]
+    FROM [People] AS [p]
+    GROUP BY [p].[LastName]
+) AS [t]
+LEFT JOIN (
+    SELECT [t1].[Id], [t1].[Age], [t1].[FirstName], [t1].[LastName], [t1].[MiddleInitial]
+    FROM (
+        SELECT [p0].[Id], [p0].[Age], [p0].[FirstName], [p0].[LastName], [p0].[MiddleInitial], ROW_NUMBER() OVER(PARTITION BY [p0].[LastName] ORDER BY [p0].[Id]) AS [row]
+        FROM [People] AS [p0]
+    ) AS [t1]
+    WHERE [t1].[row] <= 1
+) AS [t0] ON [t].[LastName] = [t0].[LastName]
+LEFT JOIN (
+    SELECT [t3].[Id], [t3].[Age], [t3].[FirstName], [t3].[LastName], [t3].[MiddleInitial]
+    FROM (
+        SELECT [p1].[Id], [p1].[Age], [p1].[FirstName], [p1].[LastName], [p1].[MiddleInitial], ROW_NUMBER() OVER(PARTITION BY [p1].[LastName] ORDER BY [p1].[Id]) AS [row]
+        FROM [People] AS [p1]
+    ) AS [t3]
+    WHERE [t3].[row] <= 2
+) AS [t2] ON [t].[LastName] = [t2].[LastName]
+ORDER BY [t].[LastName] DESC, [t0].[Id], [t2].[LastName], [t2].[Id]
+```
+
+**Example 12:**
+
+<!--
+var grouping = context.People
+    .Include(e => e.Shoes)
+    .OrderBy(e => e.FirstName)
+    .ThenBy(e => e.LastName)
+    .GroupBy(e => e.FirstName)
+    .Select(g => new { Name = g.Key, People = g.ToList()})
+    .ToList();
+-->
+[!code-csharp[GroupBy12](../../../../samples/core/Miscellaneous/NewInEFCore6/GroupBySample.cs?name=GroupBy12)]
+
+```sql
+SELECT [t].[FirstName], [t0].[Id], [t0].[Age], [t0].[FirstName], [t0].[LastName], [t0].[MiddleInitial], [t0].[Id0], [t0].[Age0], [t0].[PersonId], [t0].[Style]
+FROM (
+    SELECT [p].[FirstName]
+    FROM [People] AS [p]
+    GROUP BY [p].[FirstName]
+) AS [t]
+LEFT JOIN (
+    SELECT [p0].[Id], [p0].[Age], [p0].[FirstName], [p0].[LastName], [p0].[MiddleInitial], [s].[Id] AS [Id0], [s].[Age] AS [Age0], [s].[PersonId], [s].[Style]
+    FROM [People] AS [p0]
+    LEFT JOIN [Shoes] AS [s] ON [p0].[Id] = [s].[PersonId]
+) AS [t0] ON [t].[FirstName] = [t0].[FirstName]
+ORDER BY [t].[FirstName], [t0].[Id]
+```
+
+**Example 13:**
+
+<!--
+var grouping = context.People
+    .GroupBy(m => new {m.FirstName, m.MiddleInitial })
+    .Select(am => new
+    {
+        Key = am.Key,
+        Items = am.ToList()
+    })
+    .ToList();
+-->
+[!code-csharp[GroupBy13](../../../../samples/core/Miscellaneous/NewInEFCore6/GroupBySample.cs?name=GroupBy13)]
+
+```sql
+SELECT [t].[FirstName], [t].[MiddleInitial], [p0].[Id], [p0].[Age], [p0].[FirstName], [p0].[LastName], [p0].[MiddleInitial]
+FROM (
+    SELECT [p].[FirstName], [p].[MiddleInitial]
+    FROM [People] AS [p]
+    GROUP BY [p].[FirstName], [p].[MiddleInitial]
+) AS [t]
+LEFT JOIN [People] AS [p0] ON (([t].[FirstName] = [p0].[FirstName]) OR ([t].[FirstName] IS NULL AND [p0].[FirstName] IS NULL)) AND (([t].[MiddleInitial] = [p0].[MiddleInitial]) OR ([t].[MiddleInitial] IS NULL AND [p0].[MiddleInitial] IS NULL))
+ORDER BY [t].[FirstName], [t].[MiddleInitial]
+```
+
+**Model**
+
+The entity types used for these examples are:
+
+<!--
+public class Person
+{
+    public int Id { get; set; }
+    public int Age { get; set; }
+    public string FirstName { get; set; }
+    public string LastName { get; set; }
+    public string MiddleInitial { get; set; }
+    public Feet Feet { get; set; }
+    public ICollection<Shoes> Shoes { get; } = new List<Shoes>();
+}
+
+public class Shoes
+{
+    public int Id { get; set; }
+    public int Age { get; set; }
+    public string Style { get; set; }
+    public Person Person { get; set; }
+}
+
+public class Feet
+{
+    public int Id { get; set; }
+    public int Size { get; set; }
+    public Person Person { get; set; }
+}
+-->
+[!code-csharp[Model](../../../../samples/core/Miscellaneous/NewInEFCore6/GroupBySample.cs?name=Model)]
+
+### Translate String.Concat with multiple arguments
+
+GitHub Issue: [#23859](https://github.com/dotnet/efcore/issues/23859). This feature was contributed by [@wmeints](https://github.com/wmeints). Many thanks!
+
+Starting with EF Core 6.0, calls to <xref:System.String.Concat*?displayProperty=nameWithType> with multiple arguments are now translated to SQL. For example, the following query:
+
+<!--
+        var shards = context.Shards
+            .Where(e => string.Concat(e.Token1, e.Token2, e.Token3) != e.TokensProcessed).ToList();
+-->
+[!code-csharp[StringConcat](../../../../samples/core/Miscellaneous/NewInEFCore6/StringConcatSample.cs?name=StringConcat)]
+
+Will be translated to the following SQL when using SQL Server:
+
+```sql
+SELECT [s].[Id], [s].[Token1], [s].[Token2], [s].[Token3], [s].[TokensProcessed]
+FROM [Shards] AS [s]
+WHERE (([s].[Token1] + ([s].[Token2] + [s].[Token3])) <> [s].[TokensProcessed]) OR [s].[TokensProcessed] IS NULL
+```
+
+### Smoother integration with System.Linq.Async
+
+GitHub Issue: [#24041](https://github.com/dotnet/efcore/issues/24041).
+
+The [System.Linq.Async](https://www.nuget.org/packages/System.Linq.Async/) package adds client-side async LINQ processing. Using this package with previous versions of EF Core was cumbersome due to a namespace clash for the async LINQ methods. In EF Core 6.0 we have taken advantage of C# pattern matching for <xref:System.Collections.Generic.IAsyncEnumerable`1> such that the exposed EF Core <xref:Microsoft.EntityFrameworkCore.DbSet`1> does not need to implement the interface directly.
+
+Note that most applications do not need to use System.Linq.Async since EF Core queries are usually fully translated on the server.
+
+### More flexible SQL Server free-text search
+
+GitHub Issue: [#23921](https://github.com/dotnet/efcore/issues/23921).
+
+In EF Core 6.0, we have relaxed the parameter requirements for <xref:Microsoft.EntityFrameworkCore.SqlServerDbFunctionsExtensions.FreeText(Microsoft.EntityFrameworkCore.DbFunctions,System.String,System.String)> and <xref:Microsoft.EntityFrameworkCore.SqlServerDbFunctionsExtensions.Contains*>. This allows these functions to be used with binary columns, or with columns mapped using a value converter. For example, consider an entity type with a `Name` property defined as a value object:
+
+<!--
+    public class Customer
+    {
+        public int Id { get; set; }
+
+        public Name Name { get; set; }
+    }
+
+    public class Name
+    {
+        public string First { get; set; }
+        public string MiddleInitial { get; set; }
+        public string Last { get; set; }
+    }
+-->
+[!code-csharp[EntityType](../../../../samples/core/Miscellaneous/NewInEFCore6/ContainsFreeTextSample.cs?name=EntityType)]
+
+This is mapped to JSON in the database:
+
+<!--
+            modelBuilder.Entity<Customer>()
+                .Property(e => e.Name)
+                .HasConversion(
+                    v => JsonSerializer.Serialize(v, null),
+                    v => JsonSerializer.Deserialize<Name>(v, null));
+-->
+[!code-csharp[ConfigureCompositeValueObject](../../../../samples/core/Miscellaneous/NewInEFCore6/ContainsFreeTextSample.cs?name=ConfigureCompositeValueObject)]
+
+A query can now be executed using `Contains` or `FreeText` even though the type of the property is `Name` not `string`. For example:
+
+<!--
+        var result = context.Customers.Where(e => EF.Functions.Contains(e.Name, "Martin")).ToList();
+-->
+[!code-csharp[Query](../../../../samples/core/Miscellaneous/NewInEFCore6/ContainsFreeTextSample.cs?name=Query)]
+
+This generates the following SQL, when using SQL Server:
+
+```sql
+SELECT [c].[Id], [c].[Name]
+FROM [Customers] AS [c]
+WHERE CONTAINS([c].[Name], N'Martin')
+```
+
+### Translate ToString on SQLite
+
+GitHub Issue: [#17223](https://github.com/dotnet/efcore/issues/17223). This feature was contributed by [@ralmsdeveloper](https://github.com/ralmsdeveloper). Many thanks!
+
+Calls to <xref:System.Object.ToString> are now translated to SQL when using the SQLite database provider. This can be useful for text searches involving non-string columns. For example, consider a `User` entity type that stores phone numbers as numeric values:
+
+<!--
+    public class User
+    {
+        public int Id { get; set; }
+        public string Username { get; set; }
+        public long PhoneNumber { get; set; }
+    }
+-->
+[!code-csharp[UserEntityType](../../../../samples/core/Miscellaneous/NewInEFCore6/ToStringTranslationSample.cs?name=UserEntityType)]
+
+`ToString` can be used to convert the number to a string in the database. We can then use this string with a function such as `LIKE` to find numbers that match a pattern. For example, to find all numbers containing 555:
+
+<!--
+var users = context.Users.Where(u => EF.Functions.Like(u.PhoneNumber.ToString(), "%555%")).ToList();
+-->
+[!code-csharp[Query](../../../../samples/core/Miscellaneous/NewInEFCore6/ToStringTranslationSample.cs?name=Query)]
+
+This translates to the following SQL when using a SQLite database:
+
+```sql
+SELECT "u"."Id", "u"."PhoneNumber", "u"."Username"
+FROM "Users" AS "u"
+WHERE CAST("u"."PhoneNumber" AS TEXT) LIKE '%555%'
+```
+
+Note that translation of <xref:System.Object.ToString> for SQL Server is already supported in EF Core 5.0, and may also be supported by other database providers.
+
+### EF.Functions.Random
+
+GitHub Issue: [#16141](https://github.com/dotnet/efcore/issues/16141). This feature was contributed by [@RaymondHuy](https://github.com/RaymondHuy). Many thanks!
+
+`EF.Functions.Random` maps to a database function returning a pseudo-random number between 0 and 1 exclusive. Translations have been implemented in the EF Core repo for SQL Server, SQLite, and Azure Cosmos DB. For example, consider a `User` entity type with a `Popularity` property:
+
+<!--
+    public class User
+    {
+        public int Id { get; set; }
+        public string Username { get; set; }
+        public int Popularity { get; set; }
+    }
+-->
+[!code-csharp[UserEntityType](../../../../samples/core/Miscellaneous/NewInEFCore6/RandomFunctionSample.cs?name=UserEntityType)]
+
+`Popularity` can have values from 1 to 5 inclusive. Using `EF.Functions.Random` we can write a query to return all users with a randomly chosen popularity:
+
+<!--
+var users = context.Users.Where(u => u.Popularity == (int)(EF.Functions.Random() * 5.0) + 1).ToList();
+-->
+[!code-csharp[Query](../../../../samples/core/Miscellaneous/NewInEFCore6/RandomFunctionSample.cs?name=Query)]
+
+This translates to the following SQL when using a SQL Server database:
+
+```sql
+SELECT [u].[Id], [u].[Popularity], [u].[Username]
+FROM [Users] AS [u]
+WHERE [u].[Popularity] = (CAST((RAND() * 4.0E0) AS int) + 1)
+```
+
+### Improved SQL Server translation for IsNullOrWhitespace
+
+GitHub Issue: [#22916](https://github.com/dotnet/efcore/issues/22916). This feature was contributed by [@Marusyk](https://github.com/Marusyk). Many thanks!
+
+Consider the following query:
+
+<!--
+        var users = context.Users.Where(
+            e => string.IsNullOrWhiteSpace(e.FirstName)
+                 || string.IsNullOrWhiteSpace(e.LastName)).ToList();
+-->
+[!code-csharp[Query](../../../../samples/core/Miscellaneous/NewInEFCore6/IsNullOrWhitespaceSample.cs?name=Query)]
+
+Before EF Core 6.0, this was translated to the following on SQL Server:
+
+```sql
+SELECT [u].[Id], [u].[FirstName], [u].[LastName]
+FROM [Users] AS [u]
+WHERE ([u].[FirstName] IS NULL OR (LTRIM(RTRIM([u].[FirstName])) = N'')) OR ([u].[LastName] IS NULL OR (LTRIM(RTRIM([u].[LastName])) = N''))
+```
+
+This translation has been improved for EF Core 6.0 to:
+
+```sql
+SELECT [u].[Id], [u].[FirstName], [u].[LastName]
+FROM [Users] AS [u]
+WHERE ([u].[FirstName] IS NULL OR ([u].[FirstName] = N'')) OR ([u].[LastName] IS NULL OR ([u].[LastName] = N''))
+```
+
+### Defining query for in-memory provider
+
+GitHub Issue: [#24600](https://github.com/dotnet/efcore/issues/24600).
+
+A new method `ToInMemoryQuery` can be used to write a defining query against the in-memory database for a given entity type. This is most useful for creating the equivalent of views on the in-memory database, especially when those views return keyless entity types. For example, consider a customer database for customers based in the United Kingdom. Each customer has an address:
+
+<!--
+public class Customer
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+    public Address Address { get; set; }
+}
+
+public class Address
+{
+    public int Id { get; set; }
+    public string House { get; set; }
+    public string Street { get; set; }
+    public string City { get; set; }
+    public string Postcode { get; set; }
+}
+-->
+[!code-csharp[EntityTypes](../../../../samples/core/Miscellaneous/NewInEFCore6/ToInMemoryQuerySample.cs?name=EntityTypes)]
+
+Now, imagine we want a view over this data that shows how many customers their are into each postcode area. We can create a keyless entity type to represent this:
+
+<!--
+public class CustomerDensity
+{
+    public string Postcode { get; set; }
+    public int CustomerCount { get; set; }
+}
+-->
+[!code-csharp[ViewType](../../../../samples/core/Miscellaneous/NewInEFCore6/ToInMemoryQuerySample.cs?name=ViewType)]
+
+And define a DbSet property for it on the DbContext, along with sets for other top-level entity types:
+
+<!--
+        public DbSet<Customer> Customers { get; set; }
+        public DbSet<CustomerDensity> CustomerDensities { get; set; }
+-->
+[!code-csharp[DbSets](../../../../samples/core/Miscellaneous/NewInEFCore6/ToInMemoryQuerySample.cs?name=DbSets)]
+
+Then, in `OnModelCreating`, we can write a LINQ query that defines the data to be returned for `CustomerDensities`:
+
+<!--
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder
+        .Entity<CustomerDensity>()
+        .HasNoKey()
+        .ToInMemoryQuery(
+            () => Customers
+                .GroupBy(c => c.Address.Postcode.Substring(0, 3))
+                .Select(
+                    g =>
+                        new CustomerDensity
+                        {
+                            Postcode = g.Key,
+                            CustomerCount = g.Count()
+                        }));
+}
+-->
+[!code-csharp[ToInMemoryQuery](../../../../samples/core/Miscellaneous/NewInEFCore6/ToInMemoryQuerySample.cs?name=ToInMemoryQuery)]
+
+This can then be queried just like any other DbSet property:
+
+<!--
+var results = context.CustomerDensities.ToList();
+-->
+[!code-csharp[Query](../../../../samples/core/Miscellaneous/NewInEFCore6/ToInMemoryQuerySample.cs?name=Query)]
+
+### Translate Substring with single parameter
+
+GitHub Issue: [#20173](https://github.com/dotnet/efcore/issues/20173). This feature was contributed by [@stevendarby](https://github.com/stevendarby). Many thanks!
+
+EF Core 6.0 now translates uses of `string.Substring` with a single argument. For example:
+
+<!--
+var result = context.Customers
+    .Select(a => new { Name = a.Name.Substring(3) })
+    .FirstOrDefault(a => a.Name == "hur");
+-->
+[!code-csharp[Substring](../../../../samples/core/Miscellaneous/NewInEFCore6/SubstringTranslationSample.cs?name=Substring)]
+
+This translates to the following SQL when using SQL Server:
+
+```sql
+SELECT TOP(1) SUBSTRING([c].[Name], 3 + 1, LEN([c].[Name])) AS [Name]
+FROM [Customers] AS [c]
+WHERE SUBSTRING([c].[Name], 3 + 1, LEN([c].[Name])) = N'hur'
+```
+
+### Split-queries for non-navigation collections
+
+GitHub Issue: [#21234](https://github.com/dotnet/efcore/issues/21234).
+
+EF Core supports splitting a single LINQ query into multiple SQL queries. In EF Core 6.0, this support has been expanded to include cases where non-navigation collections are contained in the query projection.
+
+The following are example queries showing the translation on SQL Server into either a single query or multiple queries.
+
+**Example 1:**
+
+LINQ query:
+
+<!--
+context.Customers
+    .Select(
+        c => new
+        {
+            c,
+            Orders = c.Orders
+                .Where(o => o.Id > 1)
+        })
+    .ToList();
+-->
+[!code-csharp[SplitQuery1](../../../../samples/core/Miscellaneous/NewInEFCore6/SplitQuerySample.cs?name=SplitQuery1)]
+
+Single SQL query:
+
+```sql
+SELECT [c].[Id], [t].[Id], [t].[CustomerId], [t].[OrderDate]
+FROM [Customers] AS [c]
+LEFT JOIN (
+    SELECT [o].[Id], [o].[CustomerId], [o].[OrderDate]
+    FROM [Order] AS [o]
+    WHERE [o].[Id] > 1
+) AS [t] ON [c].[Id] = [t].[CustomerId]
+ORDER BY [c].[Id]
+```
+
+Multiple SQL queries:
+
+```sql
+SELECT [c].[Id]
+FROM [Customers] AS [c]
+ORDER BY [c].[Id]
+
+SELECT [t].[Id], [t].[CustomerId], [t].[OrderDate], [c].[Id]
+FROM [Customers] AS [c]
+INNER JOIN (
+    SELECT [o].[Id], [o].[CustomerId], [o].[OrderDate]
+    FROM [Order] AS [o]
+    WHERE [o].[Id] > 1
+) AS [t] ON [c].[Id] = [t].[CustomerId]
+ORDER BY [c].[Id]
+```
+
+**Example 2:**
+
+LINQ query:
+
+<!--
+context.Customers
+    .Select(
+        c => new
+        {
+            c,
+            OrderDates = c.Orders
+                .Where(o => o.Id > 1)
+                .Select(o => o.OrderDate)
+        })
+    .ToList();
+-->
+[!code-csharp[SplitQuery2](../../../../samples/core/Miscellaneous/NewInEFCore6/SplitQuerySample.cs?name=SplitQuery2)]
+
+Single SQL query:
+
+```sql
+SELECT [c].[Id], [t].[OrderDate], [t].[Id]
+FROM [Customers] AS [c]
+  LEFT JOIN (
+  SELECT [o].[OrderDate], [o].[Id], [o].[CustomerId]
+  FROM [Order] AS [o]
+  WHERE [o].[Id] > 1
+  ) AS [t] ON [c].[Id] = [t].[CustomerId]
+ORDER BY [c].[Id]
+```
+
+Multiple SQL queries:
+
+```sql
+SELECT [c].[Id]
+FROM [Customers] AS [c]
+ORDER BY [c].[Id]
+
+SELECT [t].[Id], [t].[CustomerId], [t].[OrderDate], [c].[Id]
+FROM [Customers] AS [c]
+INNER JOIN (
+    SELECT [o].[Id], [o].[CustomerId], [o].[OrderDate]
+    FROM [Order] AS [o]
+    WHERE [o].[Id] > 1
+) AS [t] ON [c].[Id] = [t].[CustomerId]
+ORDER BY [c].[Id]
+```
+
+**Example 3:**
+
+LINQ query:
+
+<!--
+context.Customers
+    .Select(
+        c => new
+        {
+            c,
+            OrderDates = c.Orders
+                .Where(o => o.Id > 1)
+                .Select(o => o.OrderDate)
+                .Distinct()
+        })
+    .ToList();
+-->
+[!code-csharp[SplitQuery3](../../../../samples/core/Miscellaneous/NewInEFCore6/SplitQuerySample.cs?name=SplitQuery3)]
+
+Single SQL query:
+
+```sql
+SELECT [c].[Id], [t].[OrderDate]
+FROM [Customers] AS [c]
+  OUTER APPLY (
+  SELECT DISTINCT [o].[OrderDate]
+  FROM [Order] AS [o]
+  WHERE ([c].[Id] = [o].[CustomerId]) AND ([o].[Id] > 1)
+  ) AS [t]
+ORDER BY [c].[Id]
+```
+
+Multiple SQL queries:
+
+```sql
+SELECT [c].[Id]
+FROM [Customers] AS [c]
+ORDER BY [c].[Id]
+
+SELECT [t].[OrderDate], [c].[Id]
+FROM [Customers] AS [c]
+  CROSS APPLY (
+  SELECT DISTINCT [o].[OrderDate]
+  FROM [Order] AS [o]
+  WHERE ([c].[Id] = [o].[CustomerId]) AND ([o].[Id] > 1)
+  ) AS [t]
+ORDER BY [c].[Id]
+```
+
+### Remove last ORDER BY clause when joining for collection
+
+GitHub Issue: [#19828](https://github.com/dotnet/efcore/issues/19828).
+
+When loading related one-to-many entities, EF Core adds ORDER BY clauses to make sure all related entities for a given entity are grouped together.  However, the last ORDER BY clause is not necessary for EF generate the needed groupings, and can have an impact in performance. Therefore, EF Core 6.0 this clause is removed.
+
+For example, consider this query:
+
+<!--
+context.Customers
+    .Select(
+        e => new
+        {
+            e.Id,
+            FirstOrder = e.Orders.Where(i => i.Id == 1).ToList()
+        })
+    .ToList();
+-->
+[!code-csharp[OrderBy](../../../../samples/core/Miscellaneous/NewInEFCore6/SplitQuerySample.cs?name=OrderBy)]
+
+With EF Core 5.0 on SQL Server, this query is translated to:
+
+```sql
+SELECT [c].[Id], [t].[Id], [t].[CustomerId], [t].[OrderDate]
+FROM [Customers] AS [c]
+LEFT JOIN (
+    SELECT [o].[Id], [o].[CustomerId], [o].[OrderDate]
+    FROM [Order] AS [o]
+    WHERE [o].[Id] = 1
+) AS [t] ON [c].[Id] = [t].[CustomerId]
+ORDER BY [c].[Id], [t].[Id]
+```
+
+With EF Core 6.0, it is instead translated to:
+
+```sql
+SELECT [c].[Id], [t].[Id], [t].[CustomerId], [t].[OrderDate]
+FROM [Customers] AS [c]
+LEFT JOIN (
+    SELECT [o].[Id], [o].[CustomerId], [o].[OrderDate]
+    FROM [Order] AS [o]
+    WHERE [o].[Id] = 1
+) AS [t] ON [c].[Id] = [t].[CustomerId]
+ORDER BY [c].[Id]
+```
+
+### Tag queries with file name and line number
+
+GitHub Issue: [#14176](https://github.com/dotnet/efcore/issues/14176). This feature was contributed by [@michalczerwinski](https://github.com/michalczerwinski). Many thanks!
+
+Query tags allow adding a textural tag to a LINQ query such that it is then included in the generated SQL. In EF Core 6.0, this can be used to tag queries with the filename and line number of the LINQ code. For example:
+
+<!--
+var results1 = context
+    .Customers
+    .TagWithCallSite()
+    .Where(c => c.Name.StartsWith("A"))
+    .ToList();
+-->
+[!code-csharp[TagWithCallSite](../../../../samples/core/Miscellaneous/NewInEFCore6/TagWithFileAndLineSample.cs?name=TagWithCallSite)]
+
+This results in the following generated SQL when using SQL Server:
+
+```sql
+-- file: C:\dotnet\efdocs\samples\core\Miscellaneous\NewInEFCore6\TagWithFileAndLineSample.cs:21
+
+SELECT [c].[Id], [c].[Name]
+FROM [Customers] AS [c]
+WHERE [c].[Name] IS NOT NULL AND ([c].[Name] LIKE N'A%')
+```
+
+### Changes to owned optional dependent handling
+
+GitHub Issue: [#24558](https://github.com/dotnet/efcore/issues/24558).
+
+It becomes tricky to know whether an optional dependent entity exists or not when it shares a table with its principal entity. This is because there is a row in the table for the dependent because the principal needs it, regardless of whether or not the dependent exists. The way to handle this unambiguously is to ensure that the dependent has at least one required property. Since a required property cannot be null, it means if the value in the column for that property is null, then the dependent entity does not exist.
+
+For example, consider a `Customer` class where each customer has an owned `Address`:
+
+<!--
+public class Customer
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+    public Address Address { get; set; }
+}
+
+public class Address
+{
+    public string House { get; set; }
+    public string Street { get; set; }
+    public string City { get; set; }
+
+    [Required]
+    public string Postcode { get; set; }
+}
+-->
+[!code-csharp[AddressWithRequiredProperty](../../../../samples/core/Miscellaneous/NewInEFCore6/OptionalDependentsSample.cs?name=AddressWithRequiredProperty)]
+
+The address is optional, meaning that it is valid to save a customer with no address:
+
+<!--
+context.Customers1.Add(
+    new()
+    {
+        Name = "Foul Ole Ron"
+    });
+-->
+[!code-csharp[NoAddress](../../../../samples/core/Miscellaneous/NewInEFCore6/OptionalDependentsSample.cs?name=NoAddress)]
+
+However, if a customer does have an address, then that address must have at least a non-null postcode:
+
+<!--
+context.Customers1.Add(
+    new()
+    {
+        Name = "Havelock Vetinari",
+        Address = new()
+        {
+            Postcode = "AN1 1PL",
+        }
+    });
+-->
+[!code-csharp[PostcodeOnly](../../../../samples/core/Miscellaneous/NewInEFCore6/OptionalDependentsSample.cs?name=PostcodeOnly)]
+
+This is ensured by marking the `Postcode` property as `Required`.
+
+Now when customers are queried, if the Postcode column is null, then this means the customer does not have an address, and the `Customer.Address` navigation property is left null. For example, iterating through the customers and checking if the Address is null:
+
+<!--
+foreach (var customer in context.Customers1)
+{
+    Console.Write(customer.Name);
+
+    if (customer.Address == null)
+    {
+        Console.WriteLine(" has no address.");
+    }
+    else
+    {
+        Console.WriteLine($" has postcode {customer.Address.Postcode}.");
+    }
+}
+-->
+[!code-csharp[CheckForNullAddress](../../../../samples/core/Miscellaneous/NewInEFCore6/OptionalDependentsSample.cs?name=CheckForNullAddress)]
+
+Generates the following results:
+
+```output
+Foul Ole Ron has no address.
+Havelock Vetinari has postcode AN1 1PL.
+```
+
+Consider instead the case where no property off the address is required:
+
+<!--
+public class Customer
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+    public Address Address { get; set; }
+}
+
+public class Address
+{
+    public string House { get; set; }
+    public string Street { get; set; }
+    public string City { get; set; }
+    public string Postcode { get; set; }
+}
+-->
+[!code-csharp[AddressWithoutRequiredProperty](../../../../samples/core/Miscellaneous/NewInEFCore6/OptionalDependentsSample.cs?name=AddressWithoutRequiredProperty)]
+
+Now it is possible to save both a customer with no address, and a customer with an address where all the address properties are null:
+
+<!--
+context.Customers2.Add(
+    new()
+    {
+        Name = "Foul Ole Ron"
+    });
+
+context.Customers2.Add(
+    new()
+    {
+        Name = "Havelock Vetinari",
+        Address = new()
+    });
+-->
+[!code-csharp[AllNull](../../../../samples/core/Miscellaneous/NewInEFCore6/OptionalDependentsSample.cs?name=AllNull)]
+
+However, in the database, these two cases are indistinguishable, as we can see by directly querying the database columns:
+
+```output
+Id  Name               House   Street  City    Postcode
+1   Foul Ole Ron       NULL    NULL    NULL    NULL
+2   Havelock Vetinari  NULL    NULL    NULL    NULL
+```
+
+For this reason, EF Core 6.0 will now warn you when saving an optional dependent where all of its properties are null. For example:
+
+> warn: 9/27/2021 09:25:01.338 RelationalEventId.OptionalDependentWithAllNullPropertiesWarning[20704] (Microsoft.EntityFrameworkCore.Update)
+> The entity of type 'Address' with primary key values {CustomerId: -2147482646} is an optional dependent using table sharing. The entity does not have any property with a non-default value to identify whether the entity exists. This means that when it is queried no object instance will be created instead of an instance with all properties set to default values. Any nested dependents will also be lost. Either don't save any instance with only default values or mark the incoming navigation as required in the model.
+
+This becomes even more tricky where the optional dependent itself acts a a principal for a further optional dependent, also mapped to the same table. Rather than just warning, EF Core 6.0 disallows just cases of nested optional dependents. For example, consider the following model, where `ContactInfo` is owned by `Customer` and `Address` is in turned owned by `ContactInfo`:
+
+<!--
+public class Customer
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+    public ContactInfo ContactInfo { get; set; }
+}
+
+public class ContactInfo
+{
+    public string Phone { get; set; }
+    public Address Address { get; set; }
+}
+
+public class Address
+{
+    public string House { get; set; }
+    public string Street { get; set; }
+    public string City { get; set; }
+    public string Postcode { get; set; }
+}
+-->
+[!code-csharp[NestedWithoutRequiredProperty](../../../../samples/core/Miscellaneous/NewInEFCore6/OptionalDependentsSample.cs?name=NestedWithoutRequiredProperty)]
+
+Now if `ContactInfo.Phone` is null, then EF Core will not create an instance of `Address` if the relationship is optional, even though the address itself may have data. For this kind of model, EF Core 6.0 will throw the following exception:
+
+> System.InvalidOperationException:
+> Entity type 'ContactInfo' is an optional dependent using table sharing and containing other dependents without any required non shared property to identify whether the entity exists. If all nullable properties contain a null value in database then an object instance won't be created in the query causing nested dependent's values to be lost. Add a required property to create instances with null values for other properties or mark the incoming navigation as required to always create an instance.
+
+The bottom line here is to avoid the case where an optional dependent can contain all nullable property values and shares a table with its principal. There are three easy ways to avoid this:
+
+1. Make the dependent required. This means that the dependent entity will always have a value after it is queried, even if all its properties are null.
+2. Make sure that the dependent contains at least one required property, as described above.
+3. Save optional dependents to their own table, instead of sharing a table with the principal.
+
+A dependent can be made required by using the `Required` attribute on it's navigation:
+
+<!--
+public class Customer
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+    
+    [Required]
+    public Address Address { get; set; }
+}
+
+public class Address
+{
+    public string House { get; set; }
+    public string Street { get; set; }
+    public string City { get; set; }
+    public string Postcode { get; set; }
+}
+-->
+[!code-csharp[AddressWithRequiredNavigation](../../../../samples/core/Miscellaneous/NewInEFCore6/OptionalDependentsSample.cs?name=AddressWithRequiredNavigation)]
+
+Or by specifying it is required in `OnModelCreating`:
+
+<!--
+modelBuilder.Entity<WithRequiredNavigation.Customer>(
+    b =>
+        {
+            b.OwnsOne(e => e.Address);
+            b.Navigation(e => e.Address).IsRequired();
+        });
+-->
+[!code-csharp[RequiredInModel](../../../../samples/core/Miscellaneous/NewInEFCore6/OptionalDependentsSample.cs?name=RequiredInModel)]
+
+Dependents can be saved to a different table by specifying the tables to use in `OnModelCreating`:
+
+<!--
+modelBuilder
+    .Entity<WithDifferentTable.Customer>(
+        b =>
+            {
+                b.ToTable("Customers");
+                b.OwnsOne(
+                    e => e.Address,
+                    b => b.ToTable("CustomerAddresses"));
+            });
+-->
+[!code-csharp[WithDifferentTable](../../../../samples/core/Miscellaneous/NewInEFCore6/OptionalDependentsSample.cs?name=WithDifferentTable)]
+
+See the [OptionalDependentsSample](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore6) in GitHub for more examples of optional dependents, including cases with nested optional dependents.
+
+## New mapping attributes
+
+EF Core 6.0 contains several new attributes that can be applied to code to change the way it is mapped to the database.
+
+### UnicodeAttribute
+
+GitHub Issue: [#19794](https://github.com/dotnet/efcore/issues/19794). This feature was contributed by [@RaymondHuy](https://github.com/RaymondHuy). Many thanks!
+
+Starting with EF Core 6.0, a string property can now be mapped to a non-Unicode column using a mapping attribute _without specifying the database type directly_. For example, consider a `Book` entity type with a property for the [International Standard Book Number (ISBN)](https://en.wikipedia.org/wiki/International_Standard_Book_Number) in the form "ISBN 978-3-16-148410-0":
+
+<!--
+    public class Book
+    {
+        public int Id { get; set; }
+        public string Title { get; set; }
+
+        [Unicode(false)]
+        [MaxLength(22)]
+        public string Isbn { get; set; }
+    }
+-->
+[!code-csharp[BookEntityType](../../../../samples/core/Miscellaneous/NewInEFCore6/UnicodeAttributeSample.cs?name=BookEntityType)]
+
+Since ISBNs cannot contain any non-unicode characters, the `Unicode` attribute will cause a non-Unicode string type to be used. In addition, `MaxLength` is used to limit the size of the database column. For example, when using SQL Server, this results in a database column of `varchar(22)`:
+
+```sql
+CREATE TABLE [Book] (
+    [Id] int NOT NULL IDENTITY,
+    [Title] nvarchar(max) NULL,
+    [Isbn] varchar(22) NULL,
+    CONSTRAINT [PK_Book] PRIMARY KEY ([Id]));
+```
+
+> [!NOTE]
+> EF Core maps string properties to Unicode columns by default. `UnicodeAttribute` is ignored when the database system supports only Unicode types.
+
+### PrecisionAttribute
+
+GitHub Issue: [#17914](https://github.com/dotnet/efcore/issues/17914). This feature was contributed by [@RaymondHuy](https://github.com/RaymondHuy). Many thanks!
+
+The precision and scale of a database column can now be configured using mapping attributes _without specifying the database type directly_. For example, consider a `Product` entity type with a decimal `Price` property:
+
+<!--
+    public class Product
+    {
+        public int Id { get; set; }
+
+        [Precision(precision: 10, scale: 2)]
+        public decimal Price { get; set; }
+    }
+-->
+[!code-csharp[ProductEntityType](../../../../samples/core/Miscellaneous/NewInEFCore6/PrecisionAttributeSample.cs?name=ProductEntityType)]
+
+EF Core will map this property to a database column with precision 10 and scale 2. For example, on SQL Server:
+
+```sql
+CREATE TABLE [Product] (
+    [Id] int NOT NULL IDENTITY,
+    [Price] decimal(10,2) NOT NULL,
+    CONSTRAINT [PK_Product] PRIMARY KEY ([Id]));
+```
+
+### EntityTypeConfigurationAttribute
+
+GitHub Issue: [#23163](https://github.com/dotnet/efcore/issues/23163). This feature was contributed by [@KaloyanIT](https://github.com/KaloyanIT). Many thanks!
+
+<xref:Microsoft.EntityFrameworkCore.IEntityTypeConfiguration`1> instances allow <xref:Microsoft.EntityFrameworkCore.ModelBuilder> configuration for each entity type to be contained in its own configuration class. For example:
+
+<!--
+public class BookConfiguration : IEntityTypeConfiguration<Book>
+{
+    public void Configure(EntityTypeBuilder<Book> builder)
+    {
+        builder
+            .Property(e => e.Isbn)
+            .IsUnicode(false)
+            .HasMaxLength(22);
+    }
+}
+-->
+[!code-csharp[BookConfiguration](../../../../samples/core/Miscellaneous/NewInEFCore6/EntityTypeConfigurationAttributeSample.cs?name=BookConfiguration)]
+
+Normally, this configuration class must be instantiated and called into from <xref:Microsoft.EntityFrameworkCore.DbContext.OnModelCreating*?displayProperty=nameWithType>. For example:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    new BookConfiguration().Configure(modelBuilder.Entity<Book>());
+}
+```
+
+Starting with EF Core 6.0, an `EntityTypeConfigurationAttribute` can be placed on the entity type such that EF Core can find and use appropriate configuration. For example:
+
+<!--
+[EntityTypeConfiguration(typeof(BookConfiguration))]
+public class Book
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+    public string Isbn { get; set; }
+}
+-->
+[!code-csharp[BookEntityType](../../../../samples/core/Miscellaneous/NewInEFCore6/EntityTypeConfigurationAttributeSample.cs?name=BookEntityType)]
+
+This attribute means that EF Core will use the specified `IEntityTypeConfiguration` implementation whenever the `Book` entity type is included in a model. The entity type is included in a model using one of the normal mechanisms. For example, by creating a <xref:Microsoft.EntityFrameworkCore.DbSet`1> property for the entity type:
+
+<!--
+public class BooksContext : DbContext
+{
+    public DbSet<Book> Books { get; set; }
+
+    //...
+-->
+[!code-csharp[DbContext](../../../../samples/core/Miscellaneous/NewInEFCore6/EntityTypeConfigurationAttributeSample.cs?name=DbContext)]
+
+Or by registering it in <xref:Microsoft.EntityFrameworkCore.DbContext.OnModelCreating*>:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Book>();
+}
+```
+
+> [!NOTE]
+> `EntityTypeConfigurationAttribute` types will not be automatically discovered in an assembly. Entity types must be added to the model before the attribute will be discovered on that entity type.
+
+## Model building improvements
+
+In addition to new mapping attributes, EF Core 6.0 contains several other improvements to the model building process.
+
+### Support for SQL Server sparse columns
+
+GitHub Issue: [#8023](https://github.com/dotnet/efcore/issues/8023).
+
+SQL Server [sparse columns](/sql/relational-databases/tables/use-sparse-columns) are ordinary columns that are optimized to store null values. This can be useful when using [TPH inheritance mapping](xref:core/modeling/inheritance) where properties of a rarely used subtype will result in null column values for most rows in the table. For example, consider a `ForumModerator` class that extends from `ForumUser`:
+
+<!--
+    public class ForumUser
+    {
+        public int Id { get; set; }
+        public string Username { get; set; }
+    }
+
+    public class ForumModerator : ForumUser
+    {
+        public string ForumName { get; set; }
+    }
+-->
+[!code-csharp[UserEntityType](../../../../samples/core/Miscellaneous/NewInEFCore6/SparseColumnsSample.cs?name=UserEntityType)]
+
+There may be millions of users, with only a handful of these being moderators. This means mapping the `ForumName` as sparse might make sense here. This can now be configured using `IsSparse` in <xref:Microsoft.EntityFrameworkCore.DbContext.OnModelCreating*>. For example:
+
+<!--
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder
+                .Entity<ForumModerator>()
+                .Property(e => e.ForumName)
+                .IsSparse();
+        }
+-->
+[!code-csharp[OnModelCreating](../../../../samples/core/Miscellaneous/NewInEFCore6/SparseColumnsSample.cs?name=OnModelCreating)]
+
+EF Core migrations will then mark the column as sparse. For example:
+
+```sql
+CREATE TABLE [ForumUser] (
+    [Id] int NOT NULL IDENTITY,
+    [Username] nvarchar(max) NULL,
+    [Discriminator] nvarchar(max) NOT NULL,
+    [ForumName] nvarchar(max) SPARSE NULL,
+    CONSTRAINT [PK_ForumUser] PRIMARY KEY ([Id]));
+```
+
+> [!NOTE]
+> Sparse columns have limitations. Make sure to read the [SQL Server sparse columns documentation](/sql/relational-databases/tables/use-sparse-columns) to ensure that sparse columns are the right choice for your scenario.
+
+### Improvements to HasConversion API
+
+GitHub Issue: [#25468](https://github.com/dotnet/efcore/issues/25468).
+
+Before EF Core 6.0, the generic overloads of the `HasConversion` methods used the generic parameter to specify _the type to convert to_. For example, consider a `Currency` enum:
+
+<!--
+public enum Currency
+{
+    UsDollars,
+    PoundsStirling,
+    Euros
+}
+-->
+[!code-csharp[CurrencyEnum](../../../../samples/core/Miscellaneous/NewInEFCore6/HasConversionSample.cs?name=CurrencyEnum)]
+
+EF Core can be configured to save values of this enum as the strings "UsDollars", "PoundsStirling", and "Euros" using `HasConversion<string>`. For example:
+
+<!--
+modelBuilder.Entity<TestEntity1>()
+    .Property(e => e.Currency)
+    .HasConversion<string>();
+-->
+[!code-csharp[AsString](../../../../samples/core/Miscellaneous/NewInEFCore6/HasConversionSample.cs?name=AsString)]
+
+Starting with EF Core 6.0, the generic type can instead specify a _value converter type_. This can be one of the built-in value converters. For example, to store the enum values as 16-bit numbers in the database:
+
+<!--
+modelBuilder.Entity<TestEntity2>()
+    .Property(e => e.Currency)
+    .HasConversion<EnumToNumberConverter<Currency, short>>();
+-->
+[!code-csharp[AsShort](../../../../samples/core/Miscellaneous/NewInEFCore6/HasConversionSample.cs?name=AsShort)]
+
+Or it can be a custom value converter type. For example, consider a converter that stores the enum values as their currency symbols:
+
+<!--
+public class CurrencyToSymbolConverter : ValueConverter<Currency, string>
+{
+    public CurrencyToSymbolConverter()
+        : base(
+            v => v == Currency.PoundsStirling ? "£" : v == Currency.Euros ? "€" : "$",
+            v => v == "£" ? Currency.PoundsStirling : v == "€" ? Currency.Euros : Currency.UsDollars)
+    {
+    }
+}
+-->
+[!code-csharp[CurrencyConverter](../../../../samples/core/Miscellaneous/NewInEFCore6/HasConversionSample.cs?name=CurrencyConverter)]
+
+This can now be configured using the generic `HasConversion` method:
+
+<!--
+modelBuilder.Entity<TestEntity3>()
+    .Property(e => e.Currency)
+    .HasConversion<CurrencyToSymbolConverter>();
+-->
+[!code-csharp[AsSymbol](../../../../samples/core/Miscellaneous/NewInEFCore6/HasConversionSample.cs?name=AsSymbol)]
+
+### Less configuration for many-to-many relationships
+
+GitHub Issue: [#21535](https://github.com/dotnet/efcore/issues/21535).
+
+Unambiguous many-to-many relationships between two entity types are discovered by convention. Where necessary or if desired, the navigations can be specified explicitly. For example:
+
+<!--
+modelBuilder.Entity<Cat>()
+    .HasMany(e => e.Humans)
+    .WithMany(e => e.Cats);
+-->
+[!code-csharp[JustNavigation](../../../../samples/core/Miscellaneous/NewInEFCore6/ManyToManyConfigurationSample.cs?name=JustNavigation)]
+
+In both these cases, EF Core creates a shared entity typed based on `Dictionary<string, object>` to act as the join entity between the two types. Starting with EF Core 6.0, `UsingEntity` can be added to the configuration to change only this type, without the need for additional configuration. For example:
+
+<!--
+modelBuilder.Entity<Cat>()
+    .HasMany(e => e.Humans)
+    .WithMany(e => e.Cats)
+    .UsingEntity<CatHuman>();
+-->
+[!code-csharp[SpecifyEntityType](../../../../samples/core/Miscellaneous/NewInEFCore6/ManyToManyConfigurationSample.cs?name=SpecifyEntityType)]
+
+In addition, the join entity type can be additional configured without needing to specify the left and right relationships explicitly. For example:
+
+<!--
+modelBuilder.Entity<Cat>()
+    .HasMany(e => e.Humans)
+    .WithMany(e => e.Cats)
+    .UsingEntity<CatHuman>(
+        e => e.HasKey(e => new { e.CatsId, e.HumansId }));
+-->
+[!code-csharp[SpecifyEntityTypeAndKey](../../../../samples/core/Miscellaneous/NewInEFCore6/ManyToManyConfigurationSample.cs?name=SpecifyEntityTypeAndKey)]
+
+And finally, the full configuration can be supplied. For example:
+
+<!--
+modelBuilder.Entity<Cat>()
+    .HasMany(e => e.Humans)
+    .WithMany(e => e.Cats)
+    .UsingEntity<CatHuman>(
+        e => e.HasOne<Human>().WithMany().HasForeignKey(e => e.CatsId),
+        e => e.HasOne<Cat>().WithMany().HasForeignKey(e => e.HumansId),
+        e => e.HasKey(e => new { e.CatsId, e.HumansId }));
+-->
+[!code-csharp[SpecifyEntityTypeAndFks](../../../../samples/core/Miscellaneous/NewInEFCore6/ManyToManyConfigurationSample.cs?name=SpecifyEntityTypeAndFks)]
+
+### Allow value converters to convert nulls
+
+GitHub Issue: [#13850](https://github.com/dotnet/efcore/issues/13850).
+
+> [!IMPORTANT]
+> Due to the problems outlined below, the constructors for `ValueConverter` that allow conversion of nulls have been marked with `[EntityFrameworkInternal]` for the EF Core 6.0 release. Using these constructors will now generate a build warning.
+
+Value converters do not generally allow the conversion of null to some other value. This is because the same value converter can be used for both nullable and non-nullable types, which is very useful for PK/FK combinations where the FK is often nullable and the PK is not.
+
+Starting with EF Core 6.0, a value converter can be created that does convert nulls. However, validation of this feature has revealed proved it to be very problematic in practice with many pitfalls. For example:
+
+* [Value conversion to null in the store generates bad queries](https://github.com/dotnet/efcore/issues/26209)
+* [Value conversion from null in the store generates bad queries](https://github.com/dotnet/efcore/issues/26210)
+* [Value converters do not handle cases where the database column has multiple different values that convert to the same value](https://github.com/dotnet/efcore/issues/13850#issuecomment-894166107)
+* [Allow value converters to change nullability of columns](https://github.com/dotnet/efcore/issues/24685)
+
+These are not trivial issues and for the query issues they are not easy to detect. Therefore, we have marked this feature as internal for EF Core 6.0. You can still use it, but you will get a compiler warning. The warning can be disabled using `#pragma warning disable EF1001`.
+
+One example of where converting nulls can be useful is when the database contains nulls, but the entity type wants to use some other default value for the property. For example, consider an enum where its default value is "Unknown":
+
+<!--
+public enum Breed
+{
+    Unknown,
+    Burmese,
+    Tonkinese 
+}
+-->
+[!code-csharp[Breed](../../../../samples/core/Miscellaneous/NewInEFCore6/ConvertNullsSample.cs?name=Breed)]
+
+However, the database may have null values when the breed is unknown. In EF Core 6.0, a value converter can be used to account for this:
+
+<!--
+    public class BreedConverter : ValueConverter<Breed, string>
+    {
+#pragma warning disable EF1001
+        public BreedConverter()
+            : base(
+                v => v == Breed.Unknown ? null : v.ToString(),
+                v => v == null ? Breed.Unknown : Enum.Parse<Breed>(v),
+                convertsNulls: true)
+        {
+        }
+#pragma warning restore EF1001
+    }
+-->
+[!code-csharp[BreedConverter](../../../../samples/core/Miscellaneous/NewInEFCore6/ConvertNullsSample.cs?name=BreedConverter)]
+
+Cats with a breed of "Unknown" will have their `Breed` column set to null in the database. For example:
+
+<!--
+context.AddRange(
+    new Cat { Name = "Mac", Breed = Breed.Unknown },
+    new Cat { Name = "Clippy", Breed = Breed.Burmese },
+    new Cat { Name = "Sid", Breed = Breed.Tonkinese });
+
+context.SaveChanges();
+-->
+[!code-csharp[InsertCats](../../../../samples/core/Miscellaneous/NewInEFCore6/ConvertNullsSample.cs?name=InsertCats)]
+
+Which generates the following insert statements on SQL Server:
+
+```output
+info: 9/27/2021 19:43:55.966 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed DbCommand (16ms) [Parameters=[@p0=NULL (Size = 4000), @p1='Mac' (Size = 4000)], CommandType='Text', CommandTimeout='30']
+      SET NOCOUNT ON;
+      INSERT INTO [Cats] ([Breed], [Name])
+      VALUES (@p0, @p1);
+      SELECT [Id]
+      FROM [Cats]
+      WHERE @@ROWCOUNT = 1 AND [Id] = scope_identity();
+info: 9/27/2021 19:43:55.983 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed DbCommand (0ms) [Parameters=[@p0='Burmese' (Size = 4000), @p1='Clippy' (Size = 4000)], CommandType='Text', CommandTimeout='30']
+      SET NOCOUNT ON;
+      INSERT INTO [Cats] ([Breed], [Name])
+      VALUES (@p0, @p1);
+      SELECT [Id]
+      FROM [Cats]
+      WHERE @@ROWCOUNT = 1 AND [Id] = scope_identity();
+info: 9/27/2021 19:43:55.983 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed DbCommand (0ms) [Parameters=[@p0='Tonkinese' (Size = 4000), @p1='Sid' (Size = 4000)], CommandType='Text', CommandTimeout='30']
+      SET NOCOUNT ON;
+      INSERT INTO [Cats] ([Breed], [Name])
+      VALUES (@p0, @p1);
+      SELECT [Id]
+      FROM [Cats]
+      WHERE @@ROWCOUNT = 1 AND [Id] = scope_identity();
+```
+
+## DbContext factory improvements
+
+### AddDbContextFactory also registers DbContext directly
+
+GitHub Issue: [#25164](https://github.com/dotnet/efcore/issues/25164).
+
+Sometimes it is useful to have both a DbContext type _and_ a factory for contexts of that type both registered in the applications dependency injection (D.I.) container. This allows, for example, a scoped instance of the DbContext to be resolved from the request scope, while the factory can be used to create multiple independent instances when needed.
+
+To support this, `AddDbContextFactory` now also registers the DbContext type as a scoped service. For example, consider this registration in the application's D.I. container:
+
+<!--
+var container = services
+    .AddDbContextFactory<SomeDbContext>(
+        builder => builder.UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample"))
+    .BuildServiceProvider();
+-->
+[!code-csharp[Registration](../../../../samples/core/Miscellaneous/NewInEFCore6/DbContextFactorySample.cs?name=Registration)]
+
+With this registration, the factory can be resolved from the root D.I. container, just as in previous versions:
+
+<!--
+var factory = container.GetService<IDbContextFactory<SomeDbContext>>();
+using (var context = factory.CreateDbContext())
+{
+    // Contexts obtained from the factory must be explicitly disposed
+}
+-->
+[!code-csharp[ResolveFactory](../../../../samples/core/Miscellaneous/NewInEFCore6/DbContextFactorySample.cs?name=ResolveFactory)]
+
+Note that context instances created by the factory must be explicitly disposed.
+
+In addition, a DbContext instance can be resolved directly from a container scope:
+
+<!--
+using (var scope = container.CreateScope())
+{
+    var context = scope.ServiceProvider.GetService<SomeDbContext>();
+    // Context is disposed when the scope is disposed
+}
+-->
+[!code-csharp[ResolveContext](../../../../samples/core/Miscellaneous/NewInEFCore6/DbContextFactorySample.cs?name=ResolveContext)]
+
+In this case the context instance is disposed when the container scope is disposed; the context should not be disposed explicitly.
+
+At a higher level, this means that either the DbContext of the factory can be injected into other D.I. types. For example:
+
+<!--
+private class MyController2
+{
+    private readonly IDbContextFactory<SomeDbContext> _contextFactory;
+
+    public MyController2(IDbContextFactory<SomeDbContext> contextFactory)
+    {
+        _contextFactory = contextFactory;
+    }
+
+    public void DoSomething()
+    {
+        using var context1 = _contextFactory.CreateDbContext();
+        using var context2 = _contextFactory.CreateDbContext();
+
+        var results1 = context1.Blogs.ToList();
+        var results2 = context2.Blogs.ToList();
+        
+        // Contexts obtained from the factory must be explicitly disposed
+    }
+}
+-->
+[!code-csharp[InjectFactory](../../../../samples/core/Miscellaneous/NewInEFCore6/DbContextFactorySample.cs?name=InjectFactory)]
+
+Or:
+
+<!--
+private class MyController1
+{
+    private readonly SomeDbContext _context;
+
+    public MyController1(SomeDbContext context)
+    {
+        _context = context;
+    }
+
+    public void DoSomething()
+    {
+        var results = _context.Blogs.ToList();
+
+        // Injected context is disposed when the request scope is disposed
+    }
+}
+-->
+[!code-csharp[InjectContext](../../../../samples/core/Miscellaneous/NewInEFCore6/DbContextFactorySample.cs?name=InjectContext)]
+
+### DbContextFactory ignores DbContext parameterless constructor
+
+GitHub Issue: [#24124](https://github.com/dotnet/efcore/issues/24124).
+
+EF Core 6.0 now allows both a parameterless DbContext constructor, and a constructor that takes `DbContextOptions` to be used on the same context type when the factory is registered through `AddDbContextFactory`. For example, the context used in the examples above contains both constructors:
+
+<!--
+public class SomeDbContext : DbContext
+{
+    public SomeDbContext()
+    {
+    }
+
+    public SomeDbContext(DbContextOptions<SomeDbContext> options)
+        : base(options)
+    {
+    }
+    
+    public DbSet<Blog> Blogs { get; set; }
+}
+-->
+[!code-csharp[Context](../../../../samples/core/Miscellaneous/NewInEFCore6/DbContextFactorySample.cs?name=Context)]
+
+### DbContext pooling can be used without dependency injection
+
+GitHub Issue: [#24137](https://github.com/dotnet/efcore/issues/24137).
+
+The `PooledDbContextFactory` type has been made public so that it can be used as a stand-alone pool for DbContext instances, without the need for your application to have a dependency injection container. The pool is created with an instance of `DbContextOptions` that will be used to create context instances:
+
+<!--
+var options = new DbContextOptionsBuilder<SomeDbContext>()
+    .EnableSensitiveDataLogging()
+    .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample")
+    .Options;
+
+var factory = new PooledDbContextFactory<SomeDbContext>(options);
+-->
+[!code-csharp[CreatePool](../../../../samples/core/Miscellaneous/NewInEFCore6/PublicPooledDbContextFactorySample.cs?name=CreatePool)]
+
+The factory can then be used to create and pool instances. For example:
+
+<!--
+for (var i = 0; i < 2; i++)
+{
+    using var context1 = factory.CreateDbContext();
+    Console.WriteLine($"Created DbContext with ID {context1.ContextId}");
+
+    using var context2 = factory.CreateDbContext();
+    Console.WriteLine($"Created DbContext with ID {context2.ContextId}");
+}
+-->
+[!code-csharp[UsePool](../../../../samples/core/Miscellaneous/NewInEFCore6/PublicPooledDbContextFactorySample.cs?name=UsePool)]
+
+Instances are returned to the pool when they are disposed.
+
+## Miscellaneous improvements
+
+And finally, EF Core contains several improvements in areas not covered above.
+
+### Use [ColumnAttribute.Order] when creating tables
+
+GitHub Issue: [#10059](https://github.com/dotnet/efcore/issues/10059).
+
+The `Order` property of `ColumnAttribute` can now be used to order columns when creating a table with migrations. For example, consider the following model:
+
+<!--
+public class EntityBase
+{
+    public int Id { get; set; }
+    public DateTime UpdatedOn { get; set; }
+    public DateTime CreatedOn { get; set; }
+}
+
+public class PersonBase : EntityBase
+{
+    public string FirstName { get; set; }
+    public string LastName { get; set; }
+}
+
+public class Employee : PersonBase
+{
+    public string Department { get; set; }
+    public decimal AnnualSalary { get; set; }
+    public Address Address { get; set; }
+}
+
+[Owned]
+public class Address
+{
+    public string House { get; set; }
+    public string Street { get; set; }
+    public string City { get; set; }
+
+    [Required]
+    public string Postcode { get; set; }
+}
+-->
+[!code-csharp[WithoutOrdering](../../../../samples/core/Miscellaneous/NewInEFCore6/ColumnOrderSample.cs?name=WithoutOrdering)]
+
+By default, EF Core orders primary key columns first, following by properties of the entity type and owned types, and finally properties from base types. For example, the following table is created on SQL Server:
+
+```sql
+CREATE TABLE [EmployeesWithoutOrdering] (
+    [Id] int NOT NULL IDENTITY,
+    [Department] nvarchar(max) NULL,
+    [AnnualSalary] decimal(18,2) NOT NULL,
+    [Address_House] nvarchar(max) NULL,
+    [Address_Street] nvarchar(max) NULL,
+    [Address_City] nvarchar(max) NULL,
+    [Address_Postcode] nvarchar(max) NULL,
+    [UpdatedOn] datetime2 NOT NULL,
+    [CreatedOn] datetime2 NOT NULL,
+    [FirstName] nvarchar(max) NULL,
+    [LastName] nvarchar(max) NULL,
+    CONSTRAINT [PK_EmployeesWithoutOrdering] PRIMARY KEY ([Id]));
+```
+
+In EF Core 6.0, `ColumnAttribute` can be used to specify a different column order. For example:
+
+<!--
+public class EntityBase
+{
+    [Column(Order = 1)]
+    public int Id { get; set; }
+
+    [Column(Order = 98)]
+    public DateTime UpdatedOn { get; set; }
+
+    [Column(Order = 99)]
+    public DateTime CreatedOn { get; set; }
+}
+
+public class PersonBase : EntityBase
+{
+    [Column(Order = 2)]
+    public string FirstName { get; set; }
+
+    [Column(Order = 3)]
+    public string LastName { get; set; }
+}
+
+public class Employee : PersonBase
+{
+    [Column(Order = 20)]
+    public string Department { get; set; }
+
+    [Column(Order = 21)]
+    public decimal AnnualSalary { get; set; }
+
+    public Address Address { get; set; }
+}
+
+[Owned]
+public class Address
+{
+    [Column("House", Order = 10)]
+    public string House { get; set; }
+
+    [Column("Street", Order = 11)]
+    public string Street { get; set; }
+
+    [Column("City", Order = 12)]
+    public string City { get; set; }
+
+    [Required]
+    [Column("Postcode", Order = 13)]
+    public string Postcode { get; set; }
+}
+-->
+[!code-csharp[WithOrdering](../../../../samples/core/Miscellaneous/NewInEFCore6/ColumnOrderSample.cs?name=WithOrdering)]
+
+On SQL Server, the table generated is now:
+
+```sql
+CREATE TABLE [EmployeesWithOrdering] (
+    [Id] int NOT NULL IDENTITY,
+    [FirstName] nvarchar(max) NULL,
+    [LastName] nvarchar(max) NULL,
+    [House] nvarchar(max) NULL,
+    [Street] nvarchar(max) NULL,
+    [City] nvarchar(max) NULL,
+    [Postcode] nvarchar(max) NULL,
+    [Department] nvarchar(max) NULL,
+    [AnnualSalary] decimal(18,2) NOT NULL,
+    [UpdatedOn] datetime2 NOT NULL,
+    [CreatedOn] datetime2 NOT NULL,
+    CONSTRAINT [PK_EmployeesWithOrdering] PRIMARY KEY ([Id]));
+```
+
+This moves the `FistName` and `LastName` columns are moved to the top, even though they are defined in a base type. Notice that the column order values can have gaps, allowing ranges to be used to always place columns at the end, even when used by multiple derived types.
+
+This example also shows how the same `ColumnAttribute` can be used to specify both the column name and order.
+
+Column ordering can also be configured using the `ModelBuilder` API in `OnModelCreating`. For example:
+
+<!--
+modelBuilder.Entity<UsingModelBuilder.Employee>(
+    entityBuilder =>
+    {
+        entityBuilder.Property(e => e.Id).HasColumnOrder(1);
+        entityBuilder.Property(e => e.FirstName).HasColumnOrder(2);
+        entityBuilder.Property(e => e.LastName).HasColumnOrder(3);
+
+        entityBuilder.OwnsOne(
+            e => e.Address,
+            ownedBuilder =>
+            {
+                ownedBuilder.Property(e => e.House).HasColumnName("House").HasColumnOrder(4);
+                ownedBuilder.Property(e => e.Street).HasColumnName("Street").HasColumnOrder(5);
+                ownedBuilder.Property(e => e.City).HasColumnName("City").HasColumnOrder(6);
+                ownedBuilder.Property(e => e.Postcode).HasColumnName("Postcode").HasColumnOrder(7).IsRequired();
+            });
+
+        entityBuilder.Property(e => e.Department).HasColumnOrder(8);
+        entityBuilder.Property(e => e.AnnualSalary).HasColumnOrder(9);
+        entityBuilder.Property(e => e.UpdatedOn).HasColumnOrder(10);
+        entityBuilder.Property(e => e.CreatedOn).HasColumnOrder(11);
+    });
+-->
+[!code-csharp[UsingModelBuilder](../../../../samples/core/Miscellaneous/NewInEFCore6/ColumnOrderSample.cs?name=UsingModelBuilder)]
+
+Ordering on the model builder with `HasColumnOrder` takes precedence over any order specified with `ColumnAttribute`. This means `HasColumnOrder` can be used to override ordering made with attributes, including resolving any conflicts when attributes on different properties specify the same order number.
+
+> [!IMPORTANT]
+> Note that, in the general case, most databases only support ordering columns when the table is created. This means that the column order attribute cannot be used to re-order columns in an existing table. One notable exception to this is SQLite, where migrations will rebuild the entire table with new column orders.
+
+### EF Core Minimal API
+
+GitHub Issue: [#25192](https://github.com/dotnet/efcore/issues/25192).
+
+.NET Core 6.0 includes updated templates that feature simplified "minimal APIs" which remove a lot of the boilerplate code traditionally needed in .NET applications.
+
+EF Core 6.0 contains a new extension method that registers a DbContext type and supplies the configuration for a database provider in a single line. For example:
+
+<!--
+var builder = WebApplication.CreateBuilder(args);
+
+builder.Services.AddSqlite<MyDbContext>("Data Source=mydatabase.db");
+-->
+[!code-csharp[SqliteMinimal](../../../../samples/core/Miscellaneous/NewInEFCore6/MinimalApiSample.cs?name=SqliteMinimal)]
+
+<!--
+var builder = WebApplication.CreateBuilder(args);
+
+builder.Services.AddSqlServer<MyDbContext>(@"Server=(localdb)\mssqllocaldb;Database=MyDatabase");
+-->
+[!code-csharp[SqlServerMinimal](../../../../samples/core/Miscellaneous/NewInEFCore6/MinimalApiSample.cs?name=SqlServerMinimal)]
+
+<!--
+var builder = WebApplication.CreateBuilder(args);
+
+builder.Services.AddCosmos<MyDbContext>(
+    "https://localhost:8081",
+    "C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==");
+-->
+[!code-csharp[CosmosMinimal](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosMinimalApiSample.cs?name=CosmosMinimal)]
+
+These are exactly equivalent to:
+
+<!--
+var builder = WebApplication.CreateBuilder(args);
+
+builder.Services.AddDbContext<MyDbContext>(
+    options => options.UseSqlite("Data Source=mydatabase.db"));
+-->
+[!code-csharp[SqliteNormal](../../../../samples/core/Miscellaneous/NewInEFCore6/MinimalApiSample.cs?name=SqliteNormal)]
+
+<!--
+var builder = WebApplication.CreateBuilder(args);
+
+builder.Services.AddDbContext<MyDbContext>(
+    options => options.UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=MyDatabase"));
+-->
+[!code-csharp[SqlServerNormal](../../../../samples/core/Miscellaneous/NewInEFCore6/MinimalApiSample.cs?name=SqlServerNormal)]
+
+<!--
+var builder = WebApplication.CreateBuilder(args);
+
+builder.Services.AddDbContext<MyDbContext>(
+    options => options.UseCosmos(
+        "https://localhost:8081",
+        "C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw=="));
+-->
+[!code-csharp[CosmosNormal](../../../../samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosMinimalApiSample.cs?name=CosmosNormal)]
+
+> [!NOTE]
+> The EF Core minimal APIs support only very basic registration and configuration of a DbContext and provider. Use `AddDbContext`, `AddDbContextPool`, `AddDbContextFactory`, etc. to access all types of registration and configuration available in EF Core.
+
+Check out these resources to learn more about minimal APIs:
+
+* The presentation [Minimal APIs in .NET 6](https://www.plainconcepts.com/knowledge/minimal-apis-net6/) by Maria Naggaga
+* [A .NET 6 Minimal API Todo example Playground](https://www.hanselman.com/blog/a-net-6-minimal-api-todo-example-playground) on Scott Hanselman's blog
+* The gist [Minimal APIs at a glance](https://gist.github.com/davidfowl/ff1addd02d239d2d26f4648a06158727) by David Fowler
+* [A minimal API Playground](https://github.com/DamianEdwards/MinimalApiPlayground) by Damian Edwards on GitHub
+
+### Preserve synchronization context in SaveChangesAsync
+
+GitHub Issue: [#23971](https://github.com/dotnet/efcore/issues/23971).
+
+We [changed the EF Core code in the 5.0 release](https://github.com/dotnet/efcore/issues/10164) to set <xref:System.Threading.Tasks.Task.ConfigureAwait*?displayProperty=nameWithType> to `false` in all places where we `await` async code. This is generally a better choice for EF Core usage. However, <xref:System.Data.Entity.DbContext.SaveChangesAsync*> is a special case because EF Core will set generated values into tracked entities after the async database operation is complete. These changes may then trigger notifications which, for example, may have to run on the U.I. thread. Therefore, we are reverting this change in EF Core 6.0 for the <xref:System.Data.Entity.DbContext.SaveChangesAsync*> method only.
+
+### In-memory database: validate required properties are not null
+
+GitHub Issue: [#10613](https://github.com/dotnet/efcore/issues/10613). This feature was contributed by [@fagnercarvalho](https://github.com/fagnercarvalho). Many thanks!
+
+The EF Core in-memory database will now throw an exception if an attempt is made to save a null value for a property marked as required. For example, consider a `User` type with a required `Username` property:
+
+<!--
+    public class User
+    {
+        public int Id { get; set; }
+
+        [Required]
+        public string Username { get; set; }
+    }
+-->
+[!code-csharp[UserEntityType](../../../../samples/core/Miscellaneous/NewInEFCore6/InMemoryRequiredPropertiesSample.cs?name=UserEntityType)]
+
+Attempting to save an entity with a null `Username` will result in the following exception:
+
+> Microsoft.EntityFrameworkCore.DbUpdateException: Required properties '{'Username'}' are missing for the instance of entity type 'User' with the key value '{Id: 1}'.
+
+This validation can be disabled if necessary. For example:
+
+<!--
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .LogTo(Console.WriteLine, new[] { InMemoryEventId.ChangesSaved })
+                .UseInMemoryDatabase("UserContextWithNullCheckingDisabled")
+                .EnableNullabilityCheck(false);
+        }
+-->
+[!code-csharp[OnConfiguring](../../../../samples/core/Miscellaneous/NewInEFCore6/InMemoryRequiredPropertiesSample.cs?name=OnConfiguring)]
+
+### Command source information for diagnostics and interceptors
+
+GitHub Issue: [#23719](https://github.com/dotnet/efcore/issues/23719). This feature was contributed by [@Giorgi](https://github.com/Giorgi). Many thanks!
+
+The <xref:Microsoft.EntityFrameworkCore.Diagnostics.CommandEventData> supplied to diagnostics sources and interceptors now contains a <xref:Microsoft.EntityFrameworkCore.Diagnostics.CommandSource> enum value indicating which part of EF was responsible for creating the command. This can be used to filter interceptor behavior, for example to only intercept commands originating from `SaveChanges`:
+
+```csharp
+public class CommandSourceInterceptor : DbCommandInterceptor
+{
+    public override InterceptionResult<DbDataReader> ReaderExecuting(
+        DbCommand command, CommandEventData eventData, InterceptionResult<DbDataReader> result)
+    {
+        if (eventData.CommandSource == CommandSource.SaveChanges)
+        {
+            Console.WriteLine($"Saving changes for {eventData.Context!.GetType().Name}:");
+            Console.WriteLine();
+            Console.WriteLine(command.CommandText);
+        }
+
+        return result;
+    }
+}
+```
+
+This filters the interceptor to only `SaveChanges` events when used in an application which also generates migrations and queries. For example:
+
+```output
+Saving changes for CustomersContext:
+
+SET NOCOUNT ON;
+INSERT INTO [Customers] ([Name])
+VALUES (@p0);
+SELECT [Id]
+FROM [Customers]
+WHERE @@ROWCOUNT = 1 AND [Id] = scope_identity();
+```
+
+For more information, see [Filtering by command source](xref:core/logging-events-diagnostics/interceptors#filtering-by-command-source).
+
+### Better temporary values handling
+
+GitHub Issue: [#24245](https://github.com/dotnet/efcore/issues/24245).
+
+EF Core does not expose temporary values on entity type instances. For example, consider a `Blog` entity type with a store-generated key:
+
+<!--
+public class Blog
+{
+    public int Id { get; set; }
+
+    public ICollection<Post> Posts { get; } = new List<Post>();
+}
+-->
+[!code-csharp[Blog](../../../../samples/core/Miscellaneous/NewInEFCore6/TemporaryValuesSample.cs?name=Blog)]
+
+The `Id` key property will get a temporary value as soon as a `Blog` is tracked by the context. For example, when calling `DbContext.Add`:
+
+<!--
+var blog = new Blog();
+context.Add(blog);
+-->
+[!code-csharp[AddBlog](../../../../samples/core/Miscellaneous/NewInEFCore6/TemporaryValuesSample.cs?name=AddBlog)]
+
+The temporary value can be obtained from the context change tracker, but is not set into the entity instance. For example, this code:
+
+<!--
+Console.WriteLine($"Blog.Id value on entity instance = {blog.Id}");
+Console.WriteLine($"Blog.Id value tracked by EF = {context.Entry(blog).Property(e => e.Id).CurrentValue}");
+-->
+[!code-csharp[ShowValues](../../../../samples/core/Miscellaneous/NewInEFCore6/TemporaryValuesSample.cs?name=ShowValues)]
+
+Generates the following output:
+
+```output
+Blog.Id value on entity instance = 0
+Blog.Id value tracked by EF = -2147482647
+```
+
+This is good because it prevents the temporary value leaking into application code where it can accidentally be treated as non-temporary. However, sometimes it is useful to deal with temporary values directly. For example, an application may want to generate its own temporary values for a graph of entities before they are tracked so that they can be used to form relationships using foreign keys. This can be done by explicitly marking the values as temporary. For example:
+
+<!--
+var blog = new Blog { Id = -1 };
+var post1 = new Post { Id = -1, BlogId = -1 };
+var post2 = new Post { Id = -2, BlogId = -1 };
+
+context.Add(blog).Property(e => e.Id).IsTemporary = true;
+context.Add(post1).Property(e => e.Id).IsTemporary = true;
+context.Add(post2).Property(e => e.Id).IsTemporary = true;
+
+Console.WriteLine($"Blog has explicit temporary ID = {blog.Id}");
+Console.WriteLine($"Post 1 has explicit temporary ID = {post1.Id} and FK to Blog = {post1.BlogId}");
+Console.WriteLine($"Post 2 has explicit temporary ID = {post2.Id} and FK to Blog = {post2.BlogId}");
+-->
+[!code-csharp[MarkTemporary](../../../../samples/core/Miscellaneous/NewInEFCore6/TemporaryValuesSample.cs?name=MarkTemporary)]
+
+In EF Core 6.0, the value will remain on the entity instance even though it is now marked as temporary. For example, the code above generates the following output:
+
+```output
+Blog has explicit temporary ID = -1
+Post 1 has explicit temporary ID = -1 and FK to Blog = -1
+Post 2 has explicit temporary ID = -2 and FK to Blog = -1
+```
+
+Likewise, temporary values generated by EF Core can be set explicitly on to entity instances and marked as temporary values. This can be used to explicitly set relationships between new entities using their temporary key values. For example:
+
+<!--
+var post1 = new Post();
+var post2 = new Post();
+
+var blogIdEntry = context.Entry(blog).Property(e => e.Id);
+blog.Id = blogIdEntry.CurrentValue;
+blogIdEntry.IsTemporary = true;
+
+var post1IdEntry = context.Add(post1).Property(e => e.Id);
+post1.Id = post1IdEntry.CurrentValue;
+post1IdEntry.IsTemporary = true;
+post1.BlogId = blog.Id;
+
+var post2IdEntry = context.Add(post2).Property(e => e.Id);
+post2.Id = post2IdEntry.CurrentValue;
+post2IdEntry.IsTemporary = true;
+post2.BlogId = blog.Id;
+
+Console.WriteLine($"Blog has generated temporary ID = {blog.Id}");
+Console.WriteLine($"Post 1 has generated temporary ID = {post1.Id} and FK to Blog = {post1.BlogId}");
+Console.WriteLine($"Post 2 has generated temporary ID = {post2.Id} and FK to Blog = {post2.BlogId}");
+-->
+[!code-csharp[ExplicitManipulation](../../../../samples/core/Miscellaneous/NewInEFCore6/TemporaryValuesSample.cs?name=ExplicitManipulation)]
+
+Resulting in:
+
+```output
+Blog has generated temporary ID = -2147482647
+Post 1 has generated temporary ID = -2147482647 and FK to Blog = -2147482647
+Post 2 has generated temporary ID = -2147482646 and FK to Blog = -2147482647
+```
+
+### EF Core annotated for C# nullable reference types
+
+GitHub Issue: [#19007](https://github.com/dotnet/efcore/issues/19007).
+
+The EF Core codebase now uses [C# nullable reference types (NRTs)](/dotnet/csharp/tutorials/nullable-reference-types) throughout. This means that you will get the correct compiler indications for null usage when using EF Core 6.0 from your own code.
+
+## Microsoft.Data.Sqlite 6.0
+
+> [!TIP]
+> You can run and debug into all the samples shown below by [downloading the sample code from GitHub](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore6).
+
+### Connection Pooling
+
+GitHub Issue: [#13837](https://github.com/dotnet/efcore/issues/13837).
+
+It is common practice to keep database connections open for as little time as possible. This helps prevent contention on the connection resource. This is why libraries like EF Core open the connection immediately before performing a database operation, and close it again immediately after. For example, consider this EF Core code:
+
+<!--
+Console.WriteLine("Starting query...");
+Console.WriteLine();
+
+var users = context.Users.ToList();
+
+Console.WriteLine();
+Console.WriteLine("Query finished.");
+Console.WriteLine();
+
+foreach (var user in users)
+{
+    if (user.Username.Contains("microsoft"))
+    {
+        user.Username = "msft:" + user.Username;
+
+        Console.WriteLine("Starting SaveChanges...");
+        Console.WriteLine();
+
+        context.SaveChanges();
+
+        Console.WriteLine();
+        Console.WriteLine("SaveChanges finished.");
+    }
+}
+-->
+[!code-csharp[ConnectionExample](../../../../samples/core/Miscellaneous/NewInEFCore6/SqliteSamples.cs?name=ConnectionExample)]
+
+The output from this code, with logging for connections turned on, is:
+
+```none
+Starting query...
+
+dbug: 8/27/2021 09:26:57.810 RelationalEventId.ConnectionOpened[20001] (Microsoft.EntityFrameworkCore.Database.Connection)
+      Opened connection to database 'main' on server 'C:\dotnet\efdocs\samples\core\Miscellaneous\NewInEFCore6\bin\Debug\net6.0\test.db'.
+dbug: 8/27/2021 09:26:57.813 RelationalEventId.ConnectionClosed[20003] (Microsoft.EntityFrameworkCore.Database.Connection)
+      Closed connection to database 'main' on server 'test.db'.
+
+Query finished.
+
+Starting SaveChanges...
+
+dbug: 8/27/2021 09:26:57.813 RelationalEventId.ConnectionOpened[20001] (Microsoft.EntityFrameworkCore.Database.Connection)
+      Opened connection to database 'main' on server 'C:\dotnet\efdocs\samples\core\Miscellaneous\NewInEFCore6\bin\Debug\net6.0\test.db'.
+dbug: 8/27/2021 09:26:57.814 RelationalEventId.ConnectionClosed[20003] (Microsoft.EntityFrameworkCore.Database.Connection)
+      Closed connection to database 'main' on server 'test.db'.
+
+SaveChanges finished.
+```
+
+Notice that the connection is opened and closed rapidly for each operation.
+
+However, for most database systems, opening a physical connection to the database is an expensive operation. Therefore most ADO.NET providers create a pool of physical connections and rent them out to `DbConnection` instances as needed.
+
+SQLite is a little bit different since database access is typically just accessing a file. This means opening a connection to a SQLite database is usually very fast. However, this is not always the case. For example, opening a connection to an encrypted database can be very slow. Therefore, SQLite connections are now pooled when using Microsoft.Data.Sqlite 6.0.
+
+### Support DateOnly and TimeOnly
+
+GitHub Issue: [#24506](https://github.com/dotnet/efcore/issues/24506).
+
+Microsoft.Data.Sqlite 6.0 supports the new `DateOnly` and `TimeOnly` types from .NET 6. These can also be used in EF Core 6.0 with the SQLite provider. As always with SQLite, its native type system means that the values from these types need to be stored as one of the four supported types. Microsoft.Data.Sqlite stores them as `TEXT`. For example, an entity using these types:
+
+<!--
+public class User
+{
+    public int Id { get; set; }
+    public string Username { get; set; }
+    
+    public DateOnly Birthday { get; set; }
+    public TimeOnly TokensRenewed { get; set; }
+}
+-->
+[!code-csharp[UserEntityType](../../../../samples/core/Miscellaneous/NewInEFCore6/SqliteSamples.cs?name=UserEntityType)]
+
+Maps to the following table in the SQLite database:
+
+```sql
+CREATE TABLE "Users" (
+    "Id" INTEGER NOT NULL CONSTRAINT "PK_Users" PRIMARY KEY AUTOINCREMENT,
+    "Username" TEXT NULL,
+    "Birthday" TEXT NOT NULL,
+    "TokensRenewed" TEXT NOT NULL);
+```
+
+Values can then be saved, queried, and updated in the normal way. For example, this EF Core LINQ query:
+
+<!--
+var users = context.Users.Where(u => u.Birthday < new DateOnly(1900, 1, 1)).ToList();
+-->
+[!code-csharp[DateOnlyQuery](../../../../samples/core/Miscellaneous/NewInEFCore6/SqliteSamples.cs?name=DateOnlyQuery)]
+
+Is translated into the following on SQLite:
+
+```sql
+SELECT "u"."Id", "u"."Birthday", "u"."TokensRenewed", "u"."Username"
+FROM "Users" AS "u"
+WHERE "u"."Birthday" < '1900-01-01'
+```
+
+And returns only uses with birthdays before 1900 CE:
+
+```output
+Found 'ajcvickers'
+Found 'wendy'
+```
+
+### Savepoints API
+
+GitHub Issue: [#20228](https://github.com/dotnet/efcore/issues/20228).
+
+We have been standardizing on [a common API for savepoints in ADO.NET providers](https://github.com/dotnet/runtime/issues/33397). Microsoft.Data.Sqlite now supports this API, including:
+
+* <xref:System.Data.Common.DbTransaction.Save(System.String)> to create a savepoint in the transaction
+* <xref:System.Data.Common.DbTransaction.Rollback(System.String)> to roll back to a previous savepoint
+* <xref:System.Data.Common.DbTransaction.Release(System.String)> to release a savepoint
+
+Using a savepoint allows part of a transaction to be rolled back without rolling back the entire transaction. For example, the code below:
+
+* Creates a transaction
+* Sends an update to the database
+* Creates a savepoint
+* Sends another update to the database
+* Rolls back to the savepoint previous created
+* Commits the transaction
+
+<!--
+        using var connection = new SqliteConnection("DataSource=test.db");
+        connection.Open();
+
+        using var transaction = connection.BeginTransaction();
+
+        using (var command = connection.CreateCommand())
+        {
+            command.CommandText = @"UPDATE Users SET Username = 'ajcvickers' WHERE Id = 1";
+            command.ExecuteNonQuery();
+        }
+
+        transaction.Save("MySavepoint");
+
+        using (var command = connection.CreateCommand())
+        {
+            command.CommandText = @"UPDATE Users SET Username = 'wfvickers' WHERE Id = 2";
+            command.ExecuteNonQuery();
+        }
+
+        transaction.Rollback("MySavepoint");
+
+        transaction.Commit();
+-->
+[!code-csharp[PerformUpdates](../../../../samples/core/Miscellaneous/NewInEFCore6/SqliteSamples.cs?name=PerformUpdates)]
+
+This will result in the first update being committed to the database, while the second update is not committed since the savepoint was rolled back before committing the transaction.
+
+### Command timeout in the connection string
+
+GitHub Issue: [#22505](https://github.com/dotnet/efcore/issues/22505). This feature was contributed by [@nmichels](https://github.com/nmichels). Many thanks!
+
+ADO.NET providers support two distinct timeouts:
+
+* The connection timeout, which determines the maximum time to wait when making a connection to the database.
+* The command timeout, which determines the maximum time to wait for a command to complete executing.
+
+The command timeout can be set from code using <xref:System.Data.Common.DbCommand.CommandTimeout?displayProperty=nameWithType>. Many providers are now also exposing this command timeout in the connection string. Microsoft.Data.Sqlite is following this trend with the `Command Timeout` connection string keyword. For example, `"Command Timeout=60;DataSource=test.db"` will use 60 seconds as the default timeout for commands created by the connection.
+
+> [!TIP]
+> Sqlite treats `Default Timeout` as a synonym for `Command Timeout` and so can be used instead if preferred.
diff --git a/entity-framework/core/what-is-new/ef-core-7.0/breaking-changes.md b/entity-framework/core/what-is-new/ef-core-7.0/breaking-changes.md
new file mode 100644
index 0000000000..8d59f6d5fb
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-7.0/breaking-changes.md
@@ -0,0 +1,575 @@
+---
+title: Breaking changes in EF Core 7.0 (EF7) - EF Core
+description: Complete list of breaking changes introduced in Entity Framework Core 7.0 (EF7)
+author: SamMonoRT
+ms.date: 09/20/2023
+uid: core/what-is-new/ef-core-7.0/breaking-changes
+ms.custom: sfi-ropc-nochange
+---
+
+# Breaking changes in EF Core 7.0 (EF7)
+
+This page documents API and behavior changes that have the potential to break existing applications updating from EF Core 6 to EF Core 7. Make sure to review earlier breaking changes if updating from an earlier version of EF Core:
+
+- [Breaking changes in EF Core 6](xref:core/what-is-new/ef-core-6.0/breaking-changes)
+
+## Target Framework
+
+EF Core 7.0 targets .NET 6. This means that existing applications that target .NET 6 can continue to do so. Applications targeting older .NET, .NET Core, and .NET Framework versions will need to target .NET 6 or .NET 7 to use EF Core 7.0.
+
+## Summary
+
+| **Breaking change**                                                                                                                      | **Impact** |
+|:-----------------------------------------------------------------------------------------------------------------------------------------|------------|
+| [`Encrypt` defaults to `true` for SQL Server connections](#encrypt-true)                                                                 | High       |
+| [Some warnings will again throw exceptions by default](#warnings-as-errors)                                                              | High       |
+| [SQL Server tables with triggers or certain computed columns now require special EF Core configuration](#sqlserver-tables-with-triggers) | High       |
+| [SQLite tables with AFTER triggers and virtual tables now require special EF Core configuration](#sqlitetriggers)                        | High       |
+| [Orphaned dependents of optional relationships are not automatically deleted](#optional-deletes)                                         | Medium     |
+| [Cascade delete is configured between tables when using TPT mapping with SQL Server](#tpt-cascade-delete)                                | Medium     |
+| [Higher chance of busy/locked errors on SQLite when not using write-ahead logging](#sqliteretries)                                       | Medium     |
+| [Key properties may need to be configured with a provider value comparer](#provider-value-comparer)                                      | Low        |
+| [Check constraints and other table facets are now configured on the table](#table-configuration)                                         | Low        |
+| [Navigations from new entities to deleted entities are not fixed up](#deleted-fixup)                                                     | Low        |
+| [Using `FromSqlRaw` and related methods from the wrong provider throws](#use-the-correct-method)                                         | Low        |
+| [Scaffolded `OnConfiguring` no longer calls `IsConfigured`](#is-configured)                                                              | Low        |
+
+## High-impact changes
+
+<a name="encrypt-true"></a>
+
+### `Encrypt` defaults to `true` for SQL Server connections
+
+[Tracking Issue: SqlClient #1210](https://github.com/dotnet/SqlClient/pull/1210)
+
+> [!IMPORTANT]
+> This is a severe breaking change in the [Microsoft.Data.SqlClient](https://www.nuget.org/packages/Microsoft.Data.SqlClient/) package. **There is nothing that can be done in EF Core to revert or mitigate this change.** Please direct feedback to the [Microsoft.Data.SqlClient GitHub Repo](https://github.com/dotnet/SqlClient) or contact a [Microsoft Support Professional](https://support.serviceshub.microsoft.com/supportforbusiness/onboarding?origin=/supportforbusiness/create) for additional questions or help.
+
+#### Old behavior
+
+[SqlClient connection strings](/sql/connect/ado-net/connection-string-syntax) use `Encrypt=False` by default. This allows connections on development machines where the local server does not have a valid certificate.
+
+#### New behavior
+
+[SqlClient connection strings](/sql/connect/ado-net/connection-string-syntax) use `Encrypt=True` by default. This means that:
+
+- The server must be configured with a valid certificate
+- The client must trust this certificate
+
+If these conditions are not met, then a `SqlException` will be thrown. For example:
+
+> A connection was successfully established with the server, but then an error occurred during the login process. (provider: SSL Provider, error: 0 - The certificate chain was issued by an authority that is not trusted.)
+
+#### Why
+
+This change was made to ensure that, by default, either the connection is secure or the application will fail to connect.
+
+#### Mitigations
+
+There are three ways to proceed:
+
+1. [Install a valid certificate on the server](/sql/database-engine/configure-windows/enable-encrypted-connections-to-the-database-engine). Note that this is an involved process and requires obtaining a certificate and ensuring it is signed by an authority trusted by the client.
+2. If the server has a certificate, but it is not trusted by the client, then `TrustServerCertificate=True` to allow bypassing the normal trust mechanism.
+3. Explicitly add `Encrypt=False` to the connection string.
+
+> [!WARNING]
+> Options 2 and 3 both leave the server in a potentially insecure state.
+
+<a name="warnings-as-errors"></a>
+
+### Some warnings throw exceptions by default again
+
+[Tracking Issue #29069](https://github.com/dotnet/efcore/issues/29069)
+
+#### Old behavior
+
+In EF Core 6.0, a bug in the SQL Server provider meant that some warnings that are configured to throw exceptions by default were instead being logged but not throwing exceptions. These warnings are:
+
+| EventId                                                                                                                                      | Description                                                                                                     |
+|----------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------|
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.RelationalEventId.AmbientTransactionWarning?displayProperty=nameWithType>                    | An application may have expected an ambient transaction to be used when it was actually ignored.                |
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.RelationalEventId.IndexPropertiesBothMappedAndNotMappedToTable?displayProperty=nameWithType> | An index specifies properties some of which are mapped and some of which are not mapped to a column in a table. |
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.RelationalEventId.IndexPropertiesMappedToNonOverlappingTables?displayProperty=nameWithType>  | An index specifies properties which map to columns on non-overlapping tables.                                   |
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.RelationalEventId.ForeignKeyPropertiesMappedToUnrelatedTables?displayProperty=nameWithType>  | A foreign key specifies properties which don't map to the related tables.                                       |
+
+#### New behavior
+
+Starting with EF Core 7.0, these warnings again, by default, result in an exception being thrown.
+
+#### Why
+
+These are issues that very likely indicate an error in the application code that should be fixed.
+
+#### Mitigations
+
+Fix the underlying issue that is the reason for the warning.
+
+Alternately, the warning level can be changed so that it is [logged only or suppressed entirely](xref:core/logging-events-diagnostics/extensions-logging#configuration-for-specific-messages). For example:
+
+```csharp
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    => optionsBuilder
+        .ConfigureWarnings(b => b.Ignore(RelationalEventId.AmbientTransactionWarning));
+```
+
+<a name="sqlserver-tables-with-triggers"></a>
+
+### SQL Server tables with triggers or certain computed columns now require special EF Core configuration
+
+[Tracking Issue #27372](https://github.com/dotnet/efcore/issues/27372)
+
+#### Old behavior
+
+Previous versions of the SQL Server provider saved changes via a less efficient technique which always worked.
+
+#### New behavior
+
+By default, EF Core now saves changes via a significantly more efficient technique; unfortunately, this technique is not supported on SQL Server if the target table has database triggers, or certain types of computed columns. See the [SQL Server documentation](/sql/t-sql/queries/output-clause-transact-sql#remarks) for more details.
+
+#### Why
+
+The performance improvements linked to the new method are significant enough that it's important to bring them to users by default. At the same time, we estimate usage of database triggers or the affected computed columns in EF Core applications to be low enough that the negative breaking change consequences are outweighed by the performance gain.
+
+#### Mitigations
+
+In EF7 or later, if the target table has a trigger, then you can let EF Core know this, and EF will revert to the previous, less efficient technique. This can be done by configuring the corresponding entity type as follows:
+
+##### [EF 8+](#tab/data-annotations)
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Blog>()
+        .ToTable(tb => tb.UseSqlOutputClause(false));
+}
+```
+
+##### [EF 7](#tab/fluent-api)
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Blog>()
+        .ToTable(tb => tb.HasTrigger("SomeTrigger"));
+}
+```
+
+---
+
+For more information, including on how to configure this for all your tables, see the [SQL Server documentation](xref:core/providers/sql-server/misc#savechanges-triggers-and-the-output-clause).
+
+<a name="sqlitetriggers"></a>
+
+### SQLite tables with AFTER triggers and virtual tables now require special EF Core configuration
+
+[Tracking Issue #29916](https://github.com/dotnet/efcore/issues/29916)
+
+#### Old behavior
+
+Previous versions of the SQLite provider saved changes via a less efficient technique which always worked.
+
+#### New behavior
+
+By default, EF Core now saves changes via a more efficient technique, using the RETURNING clause. Unfortunately, this technique is not supported on SQLite if target table is has database AFTER triggers, is virtual, or if older versions of SQLite are being used. See the [SQLite documentation](https://www.sqlite.org/lang_returning.html) for more details.
+
+#### Why
+
+The simplifications and performance improvements linked to the new method are significant enough that it's important to bring them to users by default. At the same time, we estimate usage of database triggers and virtual tables in EF Core applications to be low enough that the negative breaking change consequences are outweighed by the performance gain.
+
+#### Mitigations
+
+In EF Core 8.0, the `UseSqlReturningClause` method has been introduced to explicitly revert back to the older, less efficient SQL. For example:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Blog>()
+        .ToTable(tb => tb.UseSqlReturningClause(false));
+}
+```
+
+If you are still using EF Core 7.0, then it's possible to revert to the old mechanism for the entire application by inserting the following code in your context configuration:
+
+```c#
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    => optionsBuilder
+        .UseSqlite(...)
+        .ReplaceService<IUpdateSqlGenerator, SqliteLegacyUpdateSqlGenerator>();
+```
+
+## Medium-impact changes
+
+<a name="optional-deletes"></a>
+
+### Orphaned dependents of optional relationships are not automatically deleted
+
+[Tracking Issue #27217](https://github.com/dotnet/efcore/issues/27217)
+
+#### Old behavior
+
+A [relationship is optional](xref:core/modeling/relationships) if its foreign key is nullable. Setting the foreign key to null allows the dependent entity exist without any related principal entity. Optional relationships can be configured to use [cascade deletes](xref:core/saving/cascade-delete), although this is not the default.
+
+An optional dependent can be severed from its principal by either setting its foreign key to null, or clearing the navigation to or from it. In EF Core 6.0, this would cause the dependent to be deleted when the relationship was configured for cascade delete.
+
+#### New behavior
+
+Starting with EF Core 7.0, the dependent is no longer deleted. Note that if the principal is deleted, then the dependent will still be deleted since cascade deletes are configured for the relationship.
+
+#### Why
+
+The dependent can exist without any relationship to a principal, so severing the relationship should not cause the entity to be deleted.
+
+#### Mitigations
+
+The dependent can be explicitly deleted:
+
+```csharp
+context.Remove(blog);
+```
+
+Or `SaveChanges` can be overridden or intercepted to delete dependents with no principal reference. For example:
+
+```csharp
+context.SavingChanges += (c, _) =>
+    {
+        foreach (var entry in ((DbContext)c!).ChangeTracker
+            .Entries<Blog>()
+            .Where(e => e.State == EntityState.Modified))
+        {
+            if (entry.Reference(e => e.Author).CurrentValue == null)
+            {
+                entry.State = EntityState.Deleted;
+            }
+        }
+    };
+```
+
+<a name="tpt-cascade-delete"></a>
+
+### Cascade delete is configured between tables when using TPT mapping with SQL Server
+
+[Tracking Issue #28532](https://github.com/dotnet/efcore/issues/28532)
+
+#### Old behavior
+
+When [mapping an inheritance hierarchy using the TPT strategy](xref:core/modeling/inheritance), the base table must contain a row for every entity saved, regardless of the actual type of that entity. Deleting the row in the base table should delete rows in all the other tables. EF Core configures a [cascade deletes](xref:core/saving/cascade-delete) for this.
+
+In EF Core 6.0, a bug in the SQL Server database provider meant that these cascade deletes were not being created.
+
+#### New behavior
+
+Starting with EF Core 7.0, the cascade deletes are now being created for SQL Server just as they always were for other databases.
+
+#### Why
+
+Cascade deletes from the base table to the sub-tables in TPT allow an entity to be deleted by deleting its row in the base table.
+
+#### Mitigations
+
+In most cases, this change should not cause any issues. However, SQL Server is very restrictive when there are multiple cascade behaviors configured between tables. This means that if there is an existing cascading relationship between tables in the TPT mapping, then SQL Server may generate the following error:
+
+> Microsoft.Data.SqlClient.SqlException: The DELETE statement conflicted with the REFERENCE constraint "FK_Blogs_People_OwnerId". The conflict occurred in database "Scratch", table "dbo.Blogs", column 'OwnerId'. The statement has been terminated.
+
+For example, this model creates a cycle of cascading relationships:
+
+```csharp
+[Table("FeaturedPosts")]
+public class FeaturedPost : Post
+{
+    public int ReferencePostId { get; set; }
+    public Post ReferencePost { get; set; } = null!;
+}
+
+[Table("Posts")]
+public class Post
+{
+    public int Id { get; set; }
+    public string? Title { get; set; }
+    public string? Content { get; set; }
+}
+```
+
+One of these will need to be configured to not use cascade deletes on the server. For example, to change the explicit relationship:
+
+```csharp
+modelBuilder
+    .Entity<FeaturedPost>()
+    .HasOne(e => e.ReferencePost)
+    .WithMany()
+    .OnDelete(DeleteBehavior.ClientCascade);
+```
+
+Or to change the implicit relationship created for the TPT mapping:
+
+```csharp
+modelBuilder
+    .Entity<FeaturedPost>()
+    .HasOne<Post>()
+    .WithOne()
+    .HasForeignKey<FeaturedPost>(e => e.Id)
+    .OnDelete(DeleteBehavior.ClientCascade);
+```
+
+<a name="sqliteretries"></a>
+
+### Higher chance of busy/locked errors on SQLite when not using write-ahead logging
+
+#### Old behavior
+
+Previous versions of the SQLite provider saved changes via a less efficient technique which was able to automatically retry when the table was locked/busy and write-ahead logging (WAL) was not enabled.
+
+#### New behavior
+
+By default, EF Core now saves changes via a more efficient technique, using the RETURNING clause. Unfortunately, this technique is not able to automatically retry when busy/locked. In a multi-threaded application (like a web app) not using write-ahead logging, it is common to encounter these errors.
+
+#### Why
+
+The simplifications and performance improvements linked to the new method are significant enough that it's important to bring them to users by default. Databases created by EF Core also enable write-ahead logging by default. The SQLite team also recommends enabling write-ahead logging by default.
+
+#### Mitigations
+
+If possible, you should enable write-ahead logging on your database. If your database was created by EF, this should already be the case. If not, you can enable write-ahead logging by executing the following command.
+
+```sql
+PRAGMA journal_mode = 'wal';
+```
+
+If, for some reason, you can't enable write-ahead logging, it's possible to revert to the old mechanism for the entire application by inserting the following code in your context configuration:
+
+##### [EF Core 7.0](#tab/v7)
+
+```csharp
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    => optionsBuilder
+        .UseSqlite(...)
+        .ReplaceService<IUpdateSqlGenerator, SqliteLegacyUpdateSqlGenerator>();
+```
+
+##### [EF Core 8.0 and above](#tab/v8)
+
+```csharp
+protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+{
+    configurationBuilder.Conventions.Add(_ => new DoNotUseReturningClauseConvention());
+}
+```
+
+```csharp
+class DoNotUseReturningClauseConvention : IModelFinalizingConvention
+{
+    public void ProcessModelFinalizing(
+        IConventionModelBuilder modelBuilder,
+        IConventionContext<IConventionModelBuilder> context)
+    {
+        foreach (var entityType in modelBuilder.Metadata.GetEntityTypes())
+        {
+            entityType.UseSqlReturningClause(false);
+        }
+    }
+}
+```
+
+---
+
+## Low-impact changes
+
+<a name="provider-value-comparer"></a>
+
+### Key properties may need to be configured with a provider value comparer
+
+[Tracking Issue #27738](https://github.com/dotnet/efcore/issues/27738)
+
+#### Old behavior
+
+In EF Core 6.0, key values taken directly from the properties of entity types were used for comparison of key values when saving changes. This would make use of any [custom value comparer](xref:core/modeling/value-comparers) configured on these properties.
+
+#### New behavior
+
+Starting with EF Core 7.0, database values are used for these comparisons. This "just works" for the vast majority of cases. However, if the properties were using a custom comparer, and that comparer cannot be applied to the database values, then a "provider value comparer" may be needed, as shown below.
+
+#### Why
+
+Various entity-splitting and table-splitting can result in multiple properties mapped to the same database column, and vice-versa. This requires values to be compared after conversion to value that will be used in the database.
+
+#### Mitigations
+
+Configure a provider value comparer. For example, consider the case where a value object is being used as a key, and the comparer for that key uses case-insensitive string comparisons:
+
+```csharp
+var blogKeyComparer = new ValueComparer<BlogKey>(
+    (l, r) => string.Equals(l.Id, r.Id, StringComparison.OrdinalIgnoreCase),
+    v => v.Id.ToUpper().GetHashCode(),
+    v => v);
+
+var blogKeyConverter = new ValueConverter<BlogKey, string>(
+    v => v.Id,
+    v => new BlogKey(v));
+
+modelBuilder.Entity<Blog>()
+    .Property(e => e.Id).HasConversion(
+        blogKeyConverter, blogKeyComparer);
+```
+
+The database values (strings) cannot directly use the comparer defined for `BlogKey` types. Therefore, a provider comparer for case-insensitive string comparisons must be configured:
+
+```csharp
+var caseInsensitiveComparer = new ValueComparer<string>(
+    (l, r) => string.Equals(l, r, StringComparison.OrdinalIgnoreCase),
+    v => v.ToUpper().GetHashCode(),
+    v => v);
+
+var blogKeyComparer = new ValueComparer<BlogKey>(
+    (l, r) => string.Equals(l.Id, r.Id, StringComparison.OrdinalIgnoreCase),
+    v => v.Id.ToUpper().GetHashCode(),
+    v => v);
+
+var blogKeyConverter = new ValueConverter<BlogKey, string>(
+    v => v.Id,
+    v => new BlogKey(v));
+
+modelBuilder.Entity<Blog>()
+    .Property(e => e.Id).HasConversion(
+        blogKeyConverter, blogKeyComparer, caseInsensitiveComparer);
+```
+
+<a name="table-configuration"></a>
+
+### Check constraints and other table facets are now configured on the table
+
+[Tracking Issue #28205](https://github.com/dotnet/efcore/issues/28205)
+
+#### Old behavior
+
+In EF Core 6.0, `HasCheckConstraint`, `HasComment`, and `IsMemoryOptimized` were called directly on the entity type builder. For example:
+
+```csharp
+modelBuilder
+    .Entity<Blog>()
+    .HasCheckConstraint("CK_Blog_TooFewBits", "Id > 1023");
+
+modelBuilder
+    .Entity<Blog>()
+    .HasComment("It's my table, and I'll delete it if I want to.");
+
+modelBuilder
+    .Entity<Blog>()
+    .IsMemoryOptimized();
+```
+
+#### New behavior
+
+Starting with EF Core 7.0, these methods are instead called on the table builder:
+
+```csharp
+modelBuilder
+    .Entity<Blog>()
+    .ToTable(b => b.HasCheckConstraint("CK_Blog_TooFewBits", "Id > 1023"));
+
+modelBuilder
+    .Entity<Blog>()
+    .ToTable(b => b.HasComment("It's my table, and I'll delete it if I want to."));
+
+modelBuilder
+    .Entity<Blog>()
+    .ToTable(b => b.IsMemoryOptimized());
+```
+
+The existing methods have been marked as `Obsolete`. They currently have the same behavior as the new methods, but will be removed in a future release.
+
+#### Why
+
+These facets apply to tables only. They will not be applied to any mapped views, functions, or stored procedures.
+
+#### Mitigations
+
+Use the table builder methods, as shown above.
+
+<a name="deleted-fixup"></a>
+
+### Navigations from new entities to deleted entities are not fixed up
+
+[Tracking Issue #28249](https://github.com/dotnet/efcore/issues/28249)
+
+#### Old behavior
+
+In EF Core 6.0, when a new entity is tracked either from a [tracking query](xref:core/querying/tracking) or by [attaching it](xref:core/change-tracking/explicit-tracking) to the `DbContext`, then navigations to and from related entities in the [`Deleted` state](xref:core/change-tracking/index#entity-states) are [fixed up](xref:core/change-tracking/relationship-changes#relationship-fixup).
+
+#### New behavior
+
+Starting with EF Core 7.0, navigations to and from `Deleted` entities are not fixed up.
+
+#### Why
+
+Once an entity is marked as `Deleted` it rarely makes sense to associate it with non-deleted entities.
+
+#### Mitigations
+
+Query or attach entities before marking entities as `Deleted`, or manually set navigation properties to and from the deleted entity.
+
+<a name="use-the-correct-method"></a>
+
+### Using `FromSqlRaw` and related methods from the wrong provider throws use-the-correct-method
+
+[Tracking Issue #26502](https://github.com/dotnet/efcore/issues/26502)
+
+#### Old behavior
+
+In EF Core 6.0, using the Azure Cosmos DB <xref:Microsoft.EntityFrameworkCore.CosmosQueryableExtensions.FromSqlRaw*> extension method when using a relational provider, or the relational <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.FromSqlRaw*> extension method when using the Azure Cosmos DB provider could silently fail. Likewise, using relational methods on the in-memory provider is a silent no-op.
+
+#### New behavior
+
+Starting with EF Core 7.0, using an extension method designed for one provider on a different provider will throw an exception.
+
+#### Why
+
+The correct extension method must be used for it to function correctly in all situations.
+
+#### Mitigations
+
+Use the correct extension method for the provider being used. If multiple providers are referenced, then call the extension method as a static method. For example:
+
+```csharp
+var result = await CosmosQueryableExtensions.FromSqlRaw(context.Blogs, "SELECT ...").ToListAsync();
+```
+
+Or:
+
+```csharp
+var result = await RelationalQueryableExtensions.FromSqlRaw(context.Blogs, "SELECT ...").ToListAsync();
+```
+
+<a name="is-configured"></a>
+
+### Scaffolded `OnConfiguring` no longer calls `IsConfigured`
+
+[Tracking Issue #4274](https://github.com/dotnet/EntityFramework.Docs/issues/4274)
+
+#### Old behavior
+
+In EF Core 6.0, the `DbContext` type scaffolded from an existing database contained a call to `IsConfigured`. For example:
+
+```csharp
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+{
+    if (!optionsBuilder.IsConfigured)
+    {
+#warning To protect potentially sensitive information in your connection string, you should move it out of source code. You can avoid scaffolding the connection string by using the Name= syntax to read it from configuration - see https://go.microsoft.com/fwlink/?linkid=2131148. For more guidance on storing connection strings, see http://go.microsoft.com/fwlink/?LinkId=723263.
+        optionsBuilder.UseNpgsql("MySecretConnectionString");
+    }
+}
+```
+
+#### New behavior
+
+Starting with EF Core 7.0, the call to `IsConfigured` is no longer included.
+
+#### Why
+
+There are very limited scenarios where the database provider is configured inside your DbContext in some cases, but only if the context is not configured already. Instead, leaving `OnConfiguring` here makes it more likely that a connection string containing sensitive information is left in the code, despite the compile-time warning. Thus the extra safely and cleaner code from removing this was deemed worthwhile, especially given that the `--no-onconfiguring` (.NET CLI) or `-NoOnConfiguring` (Visual Studio Package Manager Console) flag can be used to prevent scaffolding of the `OnConfiguring` method, and that customizable templates exist to add back `IsConfigured` if it is really needed.
+
+#### Mitigations
+
+Either:
+
+- Use the `--no-onconfiguring` (.NET CLI) or `-NoOnConfiguring` (Visual Studio Package Manager Console) argument when scaffolding from an existing database.
+- [Customize the T4 templates](xref:core/managing-schemas/scaffolding/templates) to add back the call to `IsConfigured`.
diff --git a/entity-framework/core/what-is-new/ef-core-7.0/plan.md b/entity-framework/core/what-is-new/ef-core-7.0/plan.md
new file mode 100644
index 0000000000..c884ce1487
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-7.0/plan.md
@@ -0,0 +1,342 @@
+---
+title: Plan for Entity Framework Core 7.0
+description: The themes and features planned for EF Core 7.0
+author: SamMonoRT
+ms.date: 12/15/2021
+uid: core/what-is-new/ef-core-7.0/plan
+---
+
+# Plan for Entity Framework Core 7.0
+
+As described in the [planning process](xref:core/what-is-new/release-planning), we have gathered input from stakeholders into a plan for Entity Framework Core 7.0 (EF Core 7.0.) For brevity, EF Core 7.0 is also referred to as just EF7.
+
+> [!IMPORTANT]
+> This plan is not a commitment; it will evolve as we continue to learn throughout the release. Some things not currently planned for EF7 may get pulled in. Some things currently planned for EF7 may get punted out.
+
+## General information
+
+EF Core 7.0 is the next release after EF Core 6.0 and is currently scheduled for release in November 2022 at the same time as .NET 7. There are no plans for an EF Core 6.1 release.
+
+### Supported platforms
+
+EF7 currently targets .NET 6. This may be updated to .NET 7 as we near the release. EF7 does not target any .NET Standard version; for more information see [the future of .NET Standard](https://devblogs.microsoft.com/dotnet/the-future-of-net-standard/). EF7 will not run on .NET Framework.
+
+EF7 will align with the [.NET support policy](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) and will therefore **not** be a long-term support (LTS) release.
+
+### Breaking changes
+
+EF7 will contain a small number of [breaking changes](xref:core/what-is-new/ef-core-7.0/breaking-changes) as we continue to evolve both EF Core and the .NET platform. Our goal is to minimize breaking changes as much as possible.
+
+## Themes
+
+The large investments in EF7 will fall mainly under the following themes:
+
+- Highly requested features
+- NET platforms and ecosystem
+- Clear path forward from EF6
+- Performance
+
+Each of these themes is described in detail below. The high-level status of each theme can be tracked in the [EF Core biweekly updates](https://github.com/dotnet/efcore/issues/23884). Please comment on [GitHub Issue #26994](https://github.com/dotnet/efcore/issues/26994) with any feedback or suggestions.
+
+## Theme: Highly requested features
+
+As always, a major input into the [planning process](xref:core/what-is-new/release-planning) comes from [votes (👍) for features on GitHub](https://github.com/dotnet/efcore/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc). Based on these votes in addition to other factors, we plan to work on the following highly requested features for EF7.
+
+### JSON columns
+
+Tracked by [Issue #4021: Map JSON values stored in database to EF properties](https://github.com/dotnet/efcore/issues/4021)
+
+Value proposition: Save and query into JSON-based documents stored in relational database columns.
+
+This feature will introduce a common mechanism and patterns for JSON support that can be implemented by any database provider. We will work with the community to align existing implementations for [Npgsql](https://github.com/npgsql/efcore.pg) and [Pomelo MySQL](https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql), and also add support for SQL Server and SQLite.
+
+### Bulk updates
+
+Tracked by [Issue #795: Bulk (i.e. set-based) CUD operations (without loading data into memory)](https://github.com/dotnet/efcore/issues/795)
+
+Value proposition: Efficient, predicate-based updates for many database rows without loading data into memory.
+
+[Change tracking](xref:core/change-tracking/index) followed by [SaveChanges](xref:core/saving/index) is the primary mechanism in EF Core for inserting, updating, and deleting entities. This mechanism ensures that database operations are ordered to satisfy constraints, and that tracked entities are kept in sync with the changes made to the database. However, it requires a database roundtrip to load entities into memory in order to create the appropriate database commands, followed by a database roundtrip to execute these commands.
+
+In contrast, bulk, or set-based, updates involve defining the changes that should be made to the database and then executing those changes without first loading entities into memory. This can be significantly faster than tracked updates, especially when the same modification must be applied to many different entities/rows.
+
+For EF7, we plan to implement bulk updates and deletes (but not inserts). Note that bulk updates is not the same as batching updates. EF Core already combines changes to many tracked entities into batches when sending updates to the database via `SaveChanges`.
+
+### Lifecycle hooks
+
+Tracked by [Issue #626: Lifecycle hooks](https://github.com/dotnet/efcore/issues/626)
+
+Value proposition: Allow applications to react when interesting things happen in EF code.
+
+Lifecycle hooks enable notification of an application or library whenever certain interesting conditions or actions occur for entities, properties, relationships, queries, context instances, and other EF constructs. We have implemented many lifecycle hooks over the previous versions of EF Core, including various [interceptors](xref:core/logging-events-diagnostics/interceptors) and [events](xref:core/logging-events-diagnostics/events). For EF7, we plan to add important missing hooks. For example, a hook for manipulation of entity instances after they are created, commonly known as [ObjectMaterialized](https://github.com/dotnet/efcore/issues/15911).
+
+### Table-per-concrete-type (TPC) mapping
+
+Tracked by [Issue #3170: TPC inheritance mapping pattern](https://github.com/dotnet/efcore/issues/3170)
+
+Value proposition: Map entities in a hierarchy to separate tables without taking the performance hit of TPT mapping.
+
+EF Core supports [table-per-hierarchy (TPH)](xref:core/modeling/inheritance#table-per-hierarchy-and-discriminator-configuration) and [table-per-type (TPT)](xref:core/modeling/inheritance#table-per-type-configuration) mapping for .NET inheritance hierarchies. Table-per-concrete-type (TPC) mapping is similar to TPT mapping in that each entity type in the hierarchy is mapped to a different database table. However, while TPT maps properties from a base type to columns in a table for the base type, TPC maps properties of the base type to the same table as the actual concrete type being mapped. This can result in considerably faster performance since multiple tables do not need to be joined when querying for a specific type. This comes at the expense of data denormalization, since columns are duplicated across in the tables mapped to each concrete type in the hierarchy.
+
+The work for TPC mapping also covers more general [entity splitting](https://github.com/dotnet/efcore/issues/620), and support for [specifying different facets per table in TPT, TPC or entity splitting](https://github.com/dotnet/efcore/issues/19811).
+
+### Map CUD operations to stored procedures
+
+Tracked by [Issue #245: Map inserts, updates, and deletes (CUD operations) to stored procedures](https://github.com/dotnet/efcore/issues/245)
+
+Value proposition: Use stored procedures to manage data modifications.
+
+EF Core already supports querying data from stored procedures. This feature will allow mapping the inserts, updates, and deletes generated by `SaveChanges` to stored procedures in the database.
+
+### Value objects
+
+Tracked by [Issue #9906: Use C# structs or classes as value objects](https://github.com/dotnet/efcore/issues/9906)
+
+Value proposition: Applications can use DDD-style value objects in EF models.
+
+It was previously the team view that owned entities, intended for [aggregate support](https://www.martinfowler.com/bliki/DDD_Aggregate.html), would also be a reasonable approximation to [value objects](https://www.martinfowler.com/bliki/ValueObject.html). Experience has shown this not to be the case. Therefore, in EF7, we plan to introduce a better experience focused on the needs of value objects in domain-driven design. This approach will be based on value converters rather than owned entities.
+
+This work is initially scoped to allow [value converters which map to multiple columns](https://github.com/dotnet/efcore/issues/13947). We may pull in additional support based on feedback during the release.
+
+### Support value generation when using value converters
+
+Tracked by [Issue #11597: Support more types of value generation with converters](https://github.com/dotnet/efcore/issues/11597)
+
+Value proposition: DDD-style encapsulated key types can make full use of automatically generated key values.
+
+EF Core 6.0 allowed more types of value generation to be used with keys mapped through [value converters](xref:core/modeling/value-conversions). We plan to generalize and expand this support in EF7.
+
+### Raw SQL queries for unmapped types
+
+Tracked by [Issue #10753: Support raw SQL queries without defining an entity type for the result](https://github.com/dotnet/efcore/issues/10753)
+
+Value proposition: Applications can execute more types of raw SQL query without dropping down to ADO.NET or using third-party libraries.
+
+Currently raw SQL queries must return a type in the model, either with or without a key defined. In EF7, we plan to allow raw SQL queries that directly return types that are not contained in the EF model.
+
+The work here will also cover [raw SQL queries that return simple/scalar types](https://github.com/dotnet/efcore/issues/11624), such as `Guid`, `DateTime`, `int`, and `string`.
+
+### Database scaffolding templates
+
+Tracked by [Issue #4038: Code templates for scaffolding entity types and DbContext from an existing database](https://github.com/dotnet/efcore/issues/4038)
+
+Value proposition: The code generated by `dotnet ef database scaffold` can be fully customized.
+
+We frequently receive requests to adjust the code generated when scaffolding (reverse engineering) from an existing database. We plan to address these requests in EF7 by supporting [T4 templates](/visualstudio/modeling/code-generation-and-t4-text-templates) for the generated entity types and `DbContext`. Developers will be able to customize the standard templates, or create new templates from scratch.
+
+## Theme: .NET platforms and ecosystem
+
+Much of the work planned for EF7 involves improving the data access experience for .NET across different platforms and domains. This involves work in EF Core where needed, but also work in other areas to ensure a great experience across .NET technologies. We will focus on the following platforms/technologies for the EF7 release:
+
+- [.NET MAUI](/dotnet/maui/what-is-maui)
+- [ASP.NET Core](https://dotnet.microsoft.com/learn/aspnet/what-is-aspnet-core)
+- [Azure Synapse](https://azure.microsoft.com/services/synapse-analytics/#overview)
+- [Blazor Server](https://dotnet.microsoft.com/apps/aspnet/web-apps/blazor)
+- [Blazor WebAssembly](https://dotnet.microsoft.com/apps/aspnet/web-apps/blazor)
+- [Windows Forms](/dotnet/desktop/winforms/overview)
+- [Windows Presentation Foundation (WPF)](https://visualstudio.microsoft.com/vs/features/wpf/)
+
+This list is based on many factors, including customer data, strategic direction, and available resources. The general areas we will be working on for these platforms are outlined below.
+
+### Distributed transactions
+
+Tracked by [Issue #715 in dotnet/runtime: Implement distributed/promoted transactions in System.Transactions](https://github.com/dotnet/runtime/issues/715)
+
+Value proposition: .NET Framework applications using distributed transactions can be ported to .NET 7.
+
+The `System.Transactions` library in .NET Framework contains native code that makes use of the Windows [Distributed Transactions Coordinator (DTC)](/previous-versions/windows/desktop/ms684146(v=vs.85)) to support distributed transactions. This code was never ported to .NET Core. In the .NET 7 timeframe, we plan to investigate and begin the process of bringing this functionality to modern .NET. This will be initially for Windows only, and will support only database scenarios where the ADO.NET provider also supports distributed transactions. Other uses of distributed transactions, such as in WCF, will not be supported in .NET 7. Based on feedback and cost, we may implement support for other scenarios and/or non-Windows platforms in a future release.
+
+### EF Core tooling
+
+Tracked by [Issue #26798: Modernize EF Core tooling](https://github.com/dotnet/efcore/issues/26798)
+
+Value proposition: `dotnet ef` commands are easy to use and work with modern platforms and technologies.
+
+.NET platforms have evolved since we first introduced tooling for migrations, database scaffolding, etc. in EF Core 1.0. In EF7, we plan to update the tooling architecture to better support new platforms, like .NET MAUI, and to streamline the process in areas such as the use of multiple projects. This includes providing better feedback when things go wrong, better integration with logging, performance, and new [sugar](https://en.wikipedia.org/wiki/Syntactic_sugar).
+
+### EF Core and graphical user interfaces
+
+Tracked by [Issue #26799: Improve experience for data binding and graphical interfaces](https://github.com/dotnet/efcore/issues/26799)
+
+Value proposition: It is easy to build data-bound graphical applications with EF Core.
+
+EF Core is designed to work well with data binding scenarios, such as those in Windows Forms and .NET MAUI. However, connecting the dots between these technologies is not always easy. For EF7, we plan to improve the experience with both work in EF Core and in Visual Studio to make it easier to build data-bound applications with EF Core.
+
+### SqlServer.Core (Woodstar)
+
+Tracked in the [.NET Data Lab repo](https://github.com/dotnet/datalab/)
+
+Value proposition: Fast, fully managed access to SQL Server and Azure SQL for modern .NET applications.
+
+[Microsoft.Data.SqlClient](https://www.nuget.org/packages/Microsoft.Data.SqlClient/) is a fully-featured ADO.NET database provider for SQL Server. It supports a broad range of SQL Server features on both .NET and .NET Framework. However, it is also a large and old codebase with many complex interactions between its behaviors. This makes it difficult to investigate the potential gains that could be made using newer .NET features.
+
+We began a project last year, colloquially known as "Woodstar", to investigate the potential for a highly performing SQL Server driver for .NET. We plan to make significant further investment into this project in the EF7 timeframe.
+
+> [!IMPORTANT]
+> Investment in Microsoft.Data.SqlClient is not changing. It will continue to be the recommended way to connect to SQL Server and Azure SQL, both with and without EF Core. It will continue to support new SQL Server features as they are introduced.
+
+### Azure Cosmos DB provider
+
+Tracked by [issues labeled with 'area-cosmos' and in the 7.0 milestone](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+milestone%3A7.0.0+label%3Aarea-cosmos)
+
+Value proposition: Continue to make EF Core the easiest and most productive way to work with [Azure Cosmos DB](https://azure.microsoft.com/services/cosmos-db/#overview).
+
+We made [significant improvements to the EF Core Azure Cosmos DB database provider for the 6.0 release](/ef/core/what-is-new/ef-core-6.0/whatsnew#cosmos-provider-enhancements). These improvements created a first-class experience for working with Azure Cosmos DB from EF Core, which is reflected by significant growth in adoption. We plan to continue this momentum in EF7 with the following further Azure Cosmos DB provider enhancements:
+
+- [Issue #16146: Support aggregate operators](https://github.com/dotnet/efcore/issues/16146)
+- [Issue #17306: Allow to use a custom JSON serializer](https://github.com/dotnet/efcore/issues/17306)
+- [Issue #17670: Translate non-persisted property in query when possible](https://github.com/dotnet/efcore/issues/17670)
+- [Issue #19944: Support trigger execution](https://github.com/dotnet/efcore/issues/19944)
+- [Issue #20350: Detect partition key filters in more queries](https://github.com/dotnet/efcore/issues/20350)
+- [Issue #20910: Add translation for string.Compare for Azure Cosmos DB](https://github.com/dotnet/efcore/issues/20910)
+- [Issue #23538: Improve query tree during translation](https://github.com/dotnet/efcore/issues/23538)
+- [Issue #24571: Allow terminating operators after Skip and Take](https://github.com/dotnet/efcore/issues/24571)
+- [Issue #24513: Add support for pagination (MaxItemCount)](https://github.com/dotnet/efcore/issues/24513)
+- [Issue #25700: translate Length/Count on collections](https://github.com/dotnet/efcore/issues/25700)
+- [Issue #25701: translate indexing into collection](https://github.com/dotnet/efcore/issues/25701)
+- [Issue #26478: Implement interceptors for Azure Cosmos DB](https://github.com/dotnet/efcore/issues/26478)
+- [Issue #26491: Support AAD RBAC via the ClientSecretCredential](https://github.com/dotnet/efcore/issues/26491)
+
+Please make sure to vote (👍) for the [Azure Cosmos DB provider features](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aarea-cosmos) that you need so that we can assess where to invest for the most benefit.
+
+### Migrations experience
+
+Tracked by [Issue #22946: Improvements to database migrations](https://github.com/dotnet/efcore/issues/22946)
+
+Value proposition: It is easy to get started with migrations and later use them effectively in CI/CD pipelines.
+
+EF Core 6.0 introduced [migrations bundles](xref:core/managing-schemas/migrations/applying#bundles), significantly improving the experience for cloud-native applications and database deployment within continuous integration and deployment systems. In EF7, we plan to make additional improvements in this area based on customer feedback. For example, we plan to support [executing all migrations in a single transaction](https://github.com/dotnet/efcore/issues/22616) to facilitate easier recovery if something goes wrong.
+
+In addition, we plan to improve the experience for developers getting started with migrations. This includes being able to create the database automatically when learning or beginning a project, and then [easily switching to managed migrations](https://github.com/dotnet/efcore/issues/3053) as the project matures. Alternately, for projects with an existing database, we plan to make it easy to create an initial EF model and then [switch to managing the database using migrations](https://github.com/dotnet/efcore/issues/2167) going forward.
+
+### Modern .NET
+
+As .NET continues to evolve we want to ensure that accessing data continues to be a great experience. To facilitate this, we plan to make progress on three areas during the EF7 timeframe.
+
+#### Trimming
+
+Tracked by [Issue #21894: Improve trimming support for EF Core apps to reduce application size](https://github.com/dotnet/efcore/issues/21894)
+
+Value proposition: Smaller applications that can be efficiently AOT compiled.
+
+EF Core performs large amounts of runtime code generation. This is challenging for app models that depend on linker tree shaking, such as .NET MAUI and Blazor, and platforms that don't allow dynamic compilation, such as iOS. We plan to greatly improve trimming of unused code in EF7. This will facilitate smaller assembly sizes when using EF Core, thus helping deployment and making ahead-of-time (AOT) compilation more efficient.
+
+#### Evolve System.Linq.Expression
+
+Value proposition: Use modern C# language features in LINQ queries.
+
+We are working with the Roslyn team on a plan to allow more C# features to be used in LINQ expressions. This is ongoing work which will mostly be tracked outside the EF Core repo.
+
+#### Translate new LINQ operators
+
+Tracked by [Issue #25570: Support new .NET LINQ features](https://github.com/dotnet/efcore/issues/25570)
+
+Value proposition: Use new LINQ operators when translating LINQ queries to SQL.
+
+New LINQ operators have recently been added to the BCL, and we expect more to be added going forward.  Issue [#25570](https://github.com/dotnet/efcore/issues/25570) tracks adding support for these to the EF7 LINQ provider. This issue will be updated as new LINQ operators are added. As with all existing LINQ operators, we will only add support when the operator has a reasonable and useful translation to the database.
+
+### Open telemetry for ADO.NET providers
+
+Tracked by [Issue #22336: Standardize on DiagnosticSource/OpenTelemetry for database tracing](https://github.com/dotnet/runtime/issues/22336)
+
+Value proposition: Cross-platform, industry-standard telemetry that can be monitored in your tool of choice.
+
+[Open telemetry](https://github.com/open-telemetry/opentelemetry-specification) is an initiative of the Cloud Native Foundation to foster a common telemetry mechanism for cloud-native software. With regard to databases, this includes establishing a database client telemetry standard. We plan to do work in the EF7 timeframe to help bring open telemetry to ADO.NET providers in the .NET ecosystem. This includes work with the community on the open source [MySQL](https://github.com/mysql-net/MySqlConnector) and [Npgsql](https://github.com/npgsql/Npgsql) providers, as well as [Microsoft.Data.Sqlite](https://github.com/dotnet/efcore#microsoftdatasqlite). We will also reach out to other providers, and we encourage maintainers of ADO.NET providers to get in touch if interested.
+
+### Enhancements to System.Data
+
+Tracked by [issues in the dotnet\runtime repo labeled with `area-System.Data` in the 7.0 milestone](https://github.com/dotnet/runtime/issues?q=is%3Aopen+is%3Aissue+label%3Aarea-System.Data+milestone%3A7.0.0)
+
+Value proposition: Better low-level data access to benefit all higher-level code.
+
+As with every release, we intend to explore improvements to .NET's low-level database access API, System.Data. We will focus on performance improvements (e.g. reduce memory allocations by eliminating boxing when using the API), as well as some usability improvements.
+
+The scope of the precise improvements will be determined later based on feasibility.
+
+### Research data access for cloud-native
+
+Value proposition: Future evolution of .NET data access that supports modern approaches such as microservices and cloud native.
+
+In the EF7 timeframe, we plan to research modern approaches to data access across .NET platforms, especially in reference to microservices and cloud-native applications. This research will help drive future investments in data access technologies for .NET.
+
+## Theme: Clear path forward from EF6
+
+Tracked by [Docs issue #1180: Provide a more complete guide to porting from EF6](https://github.com/dotnet/EntityFramework.Docs/issues/1180)
+
+Value proposition: Easily move your application from EF6 to EF7.
+
+EF Core has always [supported many scenarios not covered by the legacy EF6 stack](/ef/efcore-and-ef6/), as well as being generally much higher performing. However, EF6 has likewise supported [scenarios not covered by EF Core](/ef/efcore-and-ef6/). EF7 will add support for many of these scenarios, allowing more applications to port from legacy EF6 to EF7. At the same time, we are planning a [comprehensive porting guide](https://github.com/dotnet/EntityFramework.Docs/issues/1180) for applications moving from legacy EF6 to EF Core.
+
+Much of the work in this theme overlaps with work already outlined above. Some of the more significant work items are:
+
+- [Issue #214: Expose model building conventions to applications](https://github.com/dotnet/efcore/issues/214)
+- [Issue #245: Map inserts, updates, and deletes (CUD operations) to stored procedures](https://github.com/dotnet/efcore/issues/245)
+- [Issue #620: Entity splitting support](https://github.com/dotnet/efcore/issues/620)
+- [Issue #3170: TPC inheritance mapping pattern](https://github.com/dotnet/efcore/issues/3170)
+- [Issue #3864: Support unidirectional many-to-many relationships through shadow navigations](https://github.com/dotnet/efcore/issues/3864)
+- [Issue #4038: Code templates for scaffolding entity types and DbContext from an existing database](https://github.com/dotnet/efcore/issues/4038)
+- [Issue #10753: Support raw SQL queries without defining an entity type for the result](https://github.com/dotnet/efcore/issues/10753)
+- [Issue #11003: KeyAttribute support for composite primary key](https://github.com/dotnet/efcore/issues/11003)
+- [Issue #11624: Support raw SQL Queries for basic types like Guid, DateTime and int](https://github.com/dotnet/efcore/issues/11624)
+- [Issue #15911: Implement ObjectMaterialized event](https://github.com/dotnet/efcore/issues/15911)
+- [Issue #17653: Support for GroupBy entityType](https://github.com/dotnet/efcore/issues/17653)
+- [Issue #19929: Support GroupBy when it is final operator](https://github.com/dotnet/efcore/issues/19929)
+- [Issue #19930: Support GroupJoin when it is final query operator](https://github.com/dotnet/efcore/issues/19930)
+- [issue #26626: Use EF6 as an oracle for procedural testing of EF Core queries](https://github.com/dotnet/efcore/issues/26626)
+
+In addition, we plan to make it clear on the [legacy EF6 GitHub repo](https://github.com/dotnet/ef6) that we are not planning any future work on EF6. The exception to this is that we plan to add support for using EF6 with [Microsoft.Data.SqlClient](https://github.com/dotnet/SqlClient). This will be limited to runtime support. Use of the EF6 designer in Visual Studio will still require `System.Data.SqlClient`.
+
+Note that EF Core has a fundamentally different architecture to EF6. In particular, it does not make use of an Entity Data Model (EDM) specification. This means certain features such as EDMX and EntitySQL will never be supported in EF Core.
+
+## Theme: Performance
+
+Great performance is a fundamental tenet of EF Core, lower-level data access, and indeed all of .NET. Every release includes significant work on improving performance. As always, this theme will involve a lot of iterative investigation, which will then inform where we focus resources.
+
+### Performance of database inserts and updates
+
+Tracked by [Issue 26797: Improve change tracking and update performance](https://github.com/dotnet/efcore/issues/26797)
+
+Value proposition: High performance database inserts and updates from EF Core.
+
+Over the past few releases, we have focused on improving EF Core performance on non-tracking queries. For EF7, we plan to focus on performance related to database inserts and updates. This includes performance of change-tracking queries, performance of `DetectChanges`, and performance of the insert and update commands sent to the database.
+
+Part of this work includes implementation of [bulk (set-based) updates](https://github.com/dotnet/efcore/issues/795), which is tracked above as a highly-requested feature. However, we also plan to improve the performance of traditional updates using `SaveChanges`.
+
+### TechEmpower composite score
+
+Tracked by [Issue 26796: Improve performance in the TechEmpower composite score](https://github.com/dotnet/efcore/issues/26796)
+
+Value proposition: High performing low-level data updates for all .NET applications.
+
+We have been running the industry standard [TechEmpower benchmarks](https://www.techempower.com/benchmarks/) on .NET against a PostgreSQL database for several years. In the last couple of releases, we have significantly improved the [Fortunes benchmark](https://www.techempower.com/benchmarks/#section=data-r19&hw=ph&test=fortune) for both low-level data access and EF Core.
+
+In the EF7 timeframe we plan to specifically target improvements to the [TechEmpower composite score](https://www.techempower.com/benchmarks/#section=data-r20&hw=ph&test=composite). This measures performance over a wider range of scenarios.
+
+## Miscellaneous features
+
+Tracked by [issues labeled with `type-enhancement` in the 7.0 milestone](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+milestone%3A7.0.0+label%3Atype-enhancement)
+
+Value proposition: Continuous improvement to EF Core to meet existing and evolving application requirements.
+
+Miscellaneous features planned for EF 7.0 include, but are not limited to:
+
+- [Issue #14545: Design: Modernize generated C#](https://github.com/dotnet/efcore/issues/14545)
+- [Issue #15762: Provide easy way to get script from latest applied on database to latest in the codebase](https://github.com/dotnet/efcore/issues/15762)
+- [Issue #16406: Fully embrace provider-specific migrations](https://github.com/dotnet/efcore/issues/16406)
+- [Issue #18844: SQLite: Translate TimeSpan members](https://github.com/dotnet/efcore/issues/18844)
+- [Issue #18950: Enable nullability in migrations and model snapshots](https://github.com/dotnet/efcore/issues/18950)
+- [Issue #18990: Use the new batching API from ADO.NET](https://github.com/dotnet/efcore/issues/18990)
+- [Issue #21615: dotnet-ef database update -1 (down latest migration)](https://github.com/dotnet/efcore/issues/21615)
+- [Issue #21995: Generate the script for all migrations that have not yet been applied to a given database](https://github.com/dotnet/efcore/issues/21995)
+- [Issue #22138: Upgrade to SpatiaLite 5](https://github.com/dotnet/efcore/issues/22138)
+- [Issue #23085: Don't check for a connection string until after ConnectionOpening has been called](https://github.com/dotnet/efcore/issues/23085)
+- [Issue #24685: Allow value converters to change nullability of columns](https://github.com/dotnet/efcore/issues/24685)
+- [Issue #25103: SQLite: Translate more DateOnly and TimeOnly members](https://github.com/dotnet/efcore/issues/25103)
+- [Issue #25872: Provide more info about a migration bundle](https://github.com/dotnet/efcore/issues/25872)
+- [Issue #26155: Sugar for getting a migration script for just the last migration](https://github.com/dotnet/efcore/issues/26155)
+- [Issue #26417: Revisit the reporting of exceptions and stack traces in logging](https://github.com/dotnet/efcore/issues/26417)
+- [Issue #26528: Register a scoped DbContext automatically when using AddPooledDbContextFactory](https://github.com/dotnet/efcore/issues/26528)
+
+## Suggestions
+
+Your feedback on planning is important. Please comment on [GitHub Issue #26994](https://github.com/dotnet/efcore/issues/26994) with any feedback or general suggestions about the plan. The best way to indicate the importance of an issue is to vote (👍) for that [issue on GitHub](https://github.com/dotnet/efcore/issues). This data will then feed into the [planning process](xref:core/what-is-new/release-planning) for the next release.
diff --git a/entity-framework/core/what-is-new/ef-core-7.0/whatsnew.md b/entity-framework/core/what-is-new/ef-core-7.0/whatsnew.md
new file mode 100644
index 0000000000..2a9cda3770
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-7.0/whatsnew.md
@@ -0,0 +1,3914 @@
+---
+title: What's New in EF Core 7.0
+description: Overview of new features in EF Core 7.0
+author: SamMonoRT
+ms.date: 01/15/2022
+uid: core/what-is-new/ef-core-7.0/whatsnew
+ms.custom: sfi-ropc-nochange
+---
+
+# What's New in EF Core 7.0
+
+EF Core 7.0 (EF7) was [released in November 2022](https://devblogs.microsoft.com/dotnet/announcing-ef7/).
+
+> [!TIP]
+> You can run and debug into the samples by [downloading the sample code from GitHub](https://github.com/dotnet/EntityFramework.Docs). Each section links to the source code specific to that section.
+
+EF7 targets .NET 6, and so can be used with either [.NET 6 (LTS)](https://dotnet.microsoft.com/download/dotnet/6.0) or [.NET 7](https://dotnet.microsoft.com/download/dotnet/7.0).
+
+## Sample model
+
+Many of the examples below use a simple model with blogs, posts, tags, and authors:
+
+[!code-csharp[BlogsModel](../../../../samples/core/Miscellaneous/NewInEFCore7/BlogsContext.cs?name=BlogsModel)]
+
+Some of the examples also use aggregate types, which are mapped in different ways in different samples. There is one aggregate type for contacts:
+
+[!code-csharp[ContactDetailsAggregate](../../../../samples/core/Miscellaneous/NewInEFCore7/BlogsContext.cs?name=ContactDetailsAggregate)]
+
+And a second aggregate type for post metadata:
+
+[!code-csharp[PostMetadataAggregate](../../../../samples/core/Miscellaneous/NewInEFCore7/BlogsContext.cs?name=PostMetadataAggregate)]
+
+> [!TIP]
+> The sample model can be found in [BlogsContext.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore7/BlogsContext.cs).
+
+## JSON Columns
+
+Most relational databases support columns that contain JSON documents. The JSON in these columns can be drilled into with queries. This allows, for example, filtering and sorting by the elements of the documents, as well as the projection of elements out of the documents into results. JSON columns allow relational databases to take on some of the characteristics of document databases, creating a useful hybrid between the two.
+
+EF7 contains provider-agnostic support for JSON columns, with an implementation for SQL Server. This support allows the mapping of aggregates built from .NET types to JSON documents. Normal LINQ queries can be used on the aggregates, and these will be translated to the appropriate query constructs needed to drill into the JSON. EF7 also supports updating and saving changes to JSON documents.
+
+> [!NOTE]
+> SQLite support for JSON is [planned for post EF7](https://github.com/dotnet/efcore/issues/28816). The PostgreSQL and Pomelo MySQL providers already contain some support for JSON columns. We will be working with the authors of those providers to align JSON support across all providers.
+
+### Mapping to JSON columns
+
+In EF Core, aggregate types are defined using `OwnsOne` and `OwnsMany`. For example, consider the aggregate type from our sample model used to store contact information:
+
+<!--
+public class ContactDetails
+{
+    public Address Address { get; init; } = null!;
+    public string? Phone { get; set; }
+}
+
+public class Address
+{
+    public Address(string street, string city, string postcode, string country)
+    {
+        Street = street;
+        City = city;
+        Postcode = postcode;
+        Country = country;
+    }
+
+    public string Street { get; set; }
+    public string City { get; set; }
+    public string Postcode { get; set; }
+    public string Country { get; set; }
+}
+-->
+[!code-csharp[ContactDetailsAggregate](../../../../samples/core/Miscellaneous/NewInEFCore7/BlogsContext.cs?name=ContactDetailsAggregate)]
+
+This can then be used in an "owner" entity type, for example, to store the contact details of an author:
+
+```csharp
+public class Author
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+    public ContactDetails Contact { get; set; }
+}
+```
+
+The aggregate type is configured  in `OnModelCreating` using `OwnsOne`:
+
+<!--
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Author>().OwnsOne(
+            author => author.Contact, ownedNavigationBuilder =>
+            {
+                ownedNavigationBuilder.OwnsOne(contactDetails => contactDetails.Address);
+            });
+    }
+-->
+[!code-csharp[TableSharingAggregate](../../../../samples/core/Miscellaneous/NewInEFCore7/JsonColumnsSample.cs?name=TableSharingAggregate)]
+
+> [!TIP]
+> The code shown here comes from [JsonColumnsSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore7/JsonColumnsSample.cs).
+
+By default, relational database providers map aggregate types like this to the same table as the owning entity type. That is, each property of the `ContactDetails` and `Address` classes is mapped to a column in the `Authors` table.
+
+Some saved authors with contact details will look like this:
+
+**Authors**
+
+| Id  | Name             | Contact\_Address\_Street | Contact\_Address\_City | Contact\_Address\_Postcode | Contact\_Address\_Country | Contact\_Phone |
+|:----|:-----------------|:-------------------------|:-----------------------|:---------------------------|:--------------------------|:---------------|
+| 1   | Maddy Montaquila | 1 Main St                | Camberwick Green       | CW1 5ZH                    | UK                        | 01632 12345    |
+| 2   | Jeremy Likness   | 2 Main St                | Chigley                | CW1 5ZH                    | UK                        | 01632 12346    |
+| 3   | Daniel Roth      | 3 Main St                | Camberwick Green       | CW1 5ZH                    | UK                        | 01632 12347    |
+| 4   | Arthur Vickers   | 15a Main St              | Chigley                | CW1 5ZH                    | United Kingdom            | 01632 22345    |
+| 5   | Brice Lambson    | 4 Main St                | Chigley                | CW1 5ZH                    | UK                        | 01632 12349    |
+
+If desired, each entity type making up the aggregate can be mapped to its own table instead:
+
+<!--
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Author>().OwnsOne(
+            author => author.Contact, ownedNavigationBuilder =>
+            {
+                ownedNavigationBuilder.ToTable("Contacts");
+                ownedNavigationBuilder.OwnsOne(contactDetails => contactDetails.Address, ownedOwnedNavigationBuilder =>
+                {
+                    ownedOwnedNavigationBuilder.ToTable("Addresses");
+                });
+            });
+    }
+-->
+[!code-csharp[TableMappedAggregate](../../../../samples/core/Miscellaneous/NewInEFCore7/JsonColumnsSample.cs?name=TableMappedAggregate)]
+
+The same data is then stored across three tables:
+
+**Authors**
+
+| Id  | Name             |
+|:----|:-----------------|
+| 1   | Maddy Montaquila |
+| 2   | Jeremy Likness   |
+| 3   | Daniel Roth      |
+| 4   | Arthur Vickers   |
+| 5   | Brice Lambson    |
+
+**Contacts**
+
+| AuthorId | Phone       |
+|:---------|:------------|
+| 1        | 01632 12345 |
+| 2        | 01632 12346 |
+| 3        | 01632 12347 |
+| 4        | 01632 22345 |
+| 5        | 01632 12349 |
+
+**Addresses**
+
+| ContactDetailsAuthorId | Street      | City             | Postcode | Country        |
+|:-----------------------|:------------|:-----------------|:---------|:---------------|
+| 1                      | 1 Main St   | Camberwick Green | CW1 5ZH  | UK             |
+| 2                      | 2 Main St   | Chigley          | CW1 5ZH  | UK             |
+| 3                      | 3 Main St   | Camberwick Green | CW1 5ZH  | UK             |
+| 4                      | 15a Main St | Chigley          | CW1 5ZH  | United Kingdom |
+| 5                      | 4 Main St   | Chigley          | CW1 5ZH  | UK             |
+
+Now, for the interesting part. In EF7, the `ContactDetails` aggregate type can be mapped to a JSON column. This requires just one call to `ToJson()` when configuring the aggregate type:  
+
+<!--
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Author>().OwnsOne(
+            author => author.Contact, ownedNavigationBuilder =>
+            {
+                ownedNavigationBuilder.ToJson();
+                ownedNavigationBuilder.OwnsOne(contactDetails => contactDetails.Address);
+            });
+    }
+-->
+[!code-csharp[JsonColumnAggregate](../../../../samples/core/Miscellaneous/NewInEFCore7/JsonColumnsSample.cs?name=JsonColumnAggregate)]
+
+The `Authors` table will now contain a JSON column for `ContactDetails` populated with a JSON document for each author:
+
+**Authors**
+
+| Id  | Name             | Contact                                                                                                                                                                                                                                                                                             |
+|:----|:-----------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| 1   | Maddy Montaquila | {<br/>&nbsp;&nbsp;"Phone":"01632 12345",<br/>&nbsp;&nbsp;"Address": {<br/>&nbsp;&nbsp;&nbsp;&nbsp;"City":"Camberwick Green",<br/>&nbsp;&nbsp;&nbsp;&nbsp;"Country":"UK",<br/>&nbsp;&nbsp;&nbsp;&nbsp;"Postcode":"CW1 5ZH",<br/>&nbsp;&nbsp;&nbsp;&nbsp;"Street":"1 Main St"<br/>&nbsp;&nbsp;}<br/>} |
+| 2   | Jeremy Likness   | {<br/>&nbsp;&nbsp;"Phone":"01632 12346",<br/>&nbsp;&nbsp;"Address": {<br/>&nbsp;&nbsp;&nbsp;&nbsp;"City":"Chigley",<br/>&nbsp;&nbsp;&nbsp;&nbsp;"Country":"UK",<br/>&nbsp;&nbsp;&nbsp;&nbsp;"Postcode":"CH1 5ZH",<br/>&nbsp;&nbsp;&nbsp;&nbsp;"Street":"2 Main St"<br/>&nbsp;&nbsp;}<br/>}          |
+| 3   | Daniel Roth      | {<br/>&nbsp;&nbsp;"Phone":"01632 12347",<br/>&nbsp;&nbsp;"Address": {<br/>&nbsp;&nbsp;&nbsp;&nbsp;"City":"Camberwick Green",<br/>&nbsp;&nbsp;&nbsp;&nbsp;"Country":"UK",<br/>&nbsp;&nbsp;&nbsp;&nbsp;"Postcode":"CW1 5ZH",<br/>&nbsp;&nbsp;&nbsp;&nbsp;"Street":"3 Main St"<br/>&nbsp;&nbsp;}<br/>} |
+| 4   | Arthur Vickers   | {<br/>&nbsp;&nbsp;"Phone":"01632 12348",<br/>&nbsp;&nbsp;"Address": {<br/>&nbsp;&nbsp;&nbsp;&nbsp;"City":"Chigley",<br/>&nbsp;&nbsp;&nbsp;&nbsp;"Country":"UK",<br/>&nbsp;&nbsp;&nbsp;&nbsp;"Postcode":"CH1 5ZH",<br/>&nbsp;&nbsp;&nbsp;&nbsp;"Street":"15a Main St"<br/>&nbsp;&nbsp;}<br/>}        |
+| 5   | Brice Lambson    | {<br/>&nbsp;&nbsp;"Phone":"01632 12349",<br/>&nbsp;&nbsp;"Address": {<br/>&nbsp;&nbsp;&nbsp;&nbsp;"City":"Chigley",<br/>&nbsp;&nbsp;&nbsp;&nbsp;"Country":"UK",<br/>&nbsp;&nbsp;&nbsp;&nbsp;"Postcode":"CH1 5ZH",<br/>&nbsp;&nbsp;&nbsp;&nbsp;"Street":"4 Main St"<br/>&nbsp;&nbsp;}<br/>}          |
+
+> [!TIP]
+> This use of aggregates is very similar to the way JSON documents are mapped when using the EF Core provider for Azure Cosmos DB. JSON columns bring the capabilities of using EF Core against document databases to documents embedded in a relational database.
+
+The JSON documents shown above are very simple, but this mapping capability can also be used with more complex document structures. For example, consider another aggregate type from our sample model, used to represent metadata about a post:
+
+<!--
+public class PostMetadata
+{
+    public PostMetadata(int views)
+    {
+        Views = views;
+    }
+
+    public int Views { get; set; }
+    public List<SearchTerm> TopSearches { get; } = new();
+    public List<Visits> TopGeographies { get; } = new();
+    public List<PostUpdate> Updates { get; } = new();
+}
+
+public class SearchTerm
+{
+    public SearchTerm(string term, int count)
+    {
+        Term = term;
+        Count = count;
+    }
+
+    public string Term { get; private set; }
+    public int Count { get; private set; }
+}
+
+public class Visits
+{
+    public Visits(double latitude, double longitude, int count)
+    {
+        Latitude = latitude;
+        Longitude = longitude;
+        Count = count;
+    }
+
+    public double Latitude { get; private set; }
+    public double Longitude { get; private set; }
+    public int Count { get; private set; }
+    public List<string>? Browsers { get; set; }
+}
+
+public class PostUpdate
+{
+    public PostUpdate(IPAddress postedFrom, DateTime updatedOn)
+    {
+        PostedFrom = postedFrom;
+        UpdatedOn = updatedOn;
+    }
+
+    public IPAddress PostedFrom { get; private set; }
+    public string? UpdatedBy { get; init; }
+    public DateTime UpdatedOn { get; private set; }
+    public List<Commit> Commits { get; } = new();
+}
+
+public class Commit
+{
+    public Commit(DateTime committedOn, string comment)
+    {
+        CommittedOn = committedOn;
+        Comment = comment;
+    }
+
+    public DateTime CommittedOn { get; private set; }
+    public string Comment { get; set; }
+}
+-->
+[!code-csharp[PostMetadataAggregate](../../../../samples/core/Miscellaneous/NewInEFCore7/BlogsContext.cs?name=PostMetadataAggregate)]
+
+This aggregate type contains several nested types and collections. Calls to `OwnsOne` and `OwnsMany` are used to map this aggregate type:
+
+<!--
+        modelBuilder.Entity<Post>().OwnsOne(
+            post => post.Metadata, ownedNavigationBuilder =>
+            {
+                ownedNavigationBuilder.ToJson();
+                ownedNavigationBuilder.OwnsMany(metadata => metadata.TopSearches);
+                ownedNavigationBuilder.OwnsMany(metadata => metadata.TopGeographies);
+                ownedNavigationBuilder.OwnsMany(
+                    metadata => metadata.Updates,
+                    ownedOwnedNavigationBuilder => ownedOwnedNavigationBuilder.OwnsMany(update => update.Commits));
+            });
+-->
+[!code-csharp[PostMetadataConfig](../../../../samples/core/Miscellaneous/NewInEFCore7/JsonColumnsSample.cs?name=PostMetadataConfig)]
+
+> [!TIP]
+> `ToJson` is only needed on the aggregate root to map the entire aggregate to a JSON document.
+
+With this mapping, EF7 can create and query into a complex JSON document like this:
+
+```json
+{
+  "Views": 5085,
+  "TopGeographies": [
+    {
+      "Browsers": "Firefox, Netscape",
+      "Count": 924,
+      "Latitude": 110.793,
+      "Longitude": 39.2431
+    },
+    {
+      "Browsers": "Firefox, Netscape",
+      "Count": 885,
+      "Latitude": 133.793,
+      "Longitude": 45.2431
+    }
+  ],
+  "TopSearches": [
+    {
+      "Count": 9359,
+      "Term": "Search #1"
+    }
+  ],
+  "Updates": [
+    {
+      "PostedFrom": "127.0.0.1",
+      "UpdatedBy": "Admin",
+      "UpdatedOn": "1996-02-17T19:24:29.5429092Z",
+      "Commits": []
+    },
+    {
+      "PostedFrom": "127.0.0.1",
+      "UpdatedBy": "Admin",
+      "UpdatedOn": "2019-11-24T19:24:29.5429093Z",
+      "Commits": [
+        {
+          "Comment": "Commit #1",
+          "CommittedOn": "2022-08-21T00:00:00+01:00"
+        }
+      ]
+    },
+    {
+      "PostedFrom": "127.0.0.1",
+      "UpdatedBy": "Admin",
+      "UpdatedOn": "1997-05-28T19:24:29.5429097Z",
+      "Commits": [
+        {
+          "Comment": "Commit #1",
+          "CommittedOn": "2022-08-21T00:00:00+01:00"
+        },
+        {
+          "Comment": "Commit #2",
+          "CommittedOn": "2022-08-21T00:00:00+01:00"
+        }
+      ]
+    }
+  ]
+}
+```
+
+> [!NOTE]
+> Mapping spatial types directly to JSON is not yet supported. The document above uses `double` values as a workaround. Vote for [Support spatial types in JSON columns](https://github.com/dotnet/efcore/issues/28811) if this is something you are interested in.
+
+> [!NOTE]
+> Mapping collections of primitive types to JSON is not yet supported. The document above uses a value converter to transform the collection into a comma-separated string. Vote for [Json: add support for collection of primitive types](https://github.com/dotnet/efcore/issues/28688) if this is something you are interested in.
+
+> [!NOTE]
+> Mapping of owned types to JSON is not yet supported in conjunction with TPT or TPC inheritance. Vote for [Support JSON properties with TPT/TPC inheritance mapping](https://github.com/dotnet/efcore/issues/28443) if this is something you are interested in.
+
+### Queries into JSON columns
+
+Queries into JSON columns work just the same as querying into any other aggregate type in EF Core. That is, just use LINQ! Here are some examples.
+
+A query for all authors that live in Chigley:
+
+<!--
+        var authorsInChigley = await context.Authors
+            .Where(author => author.Contact.Address.City == "Chigley")
+            .ToListAsync();
+-->
+[!code-csharp[AuthorsInChigley](../../../../samples/core/Miscellaneous/NewInEFCore7/JsonColumnsSample.cs?name=AuthorsInChigley)]
+
+This query generates the following SQL when using SQL Server:
+
+```sql
+SELECT [a].[Id], [a].[Name], JSON_QUERY([a].[Contact],'$')
+FROM [Authors] AS [a]
+WHERE CAST(JSON_VALUE([a].[Contact],'$.Address.City') AS nvarchar(max)) = N'Chigley'
+```
+
+Notice the use of `JSON_VALUE` to get the `City` from the `Address` inside the JSON document.
+
+`Select` can be used to extract and project elements from the JSON document:
+
+<!--
+        var postcodesInChigley = await context.Authors
+            .Where(author => author.Contact.Address.City == "Chigley")
+            .Select(author => author.Contact.Address.Postcode)
+            .ToListAsync();
+-->
+[!code-csharp[PostcodesInChigley](../../../../samples/core/Miscellaneous/NewInEFCore7/JsonColumnsSample.cs?name=PostcodesInChigley)]
+
+This query generates the following SQL:
+
+```sql
+SELECT CAST(JSON_VALUE([a].[Contact],'$.Address.Postcode') AS nvarchar(max))
+FROM [Authors] AS [a]
+WHERE CAST(JSON_VALUE([a].[Contact],'$.Address.City') AS nvarchar(max)) = N'Chigley'
+```
+
+Here's an example that does a bit more in the filter and projection, and also orders by the phone number in the JSON document:
+
+<!--
+        var orderedAddresses = await context.Authors
+            .Where(
+                author => (author.Contact.Address.City == "Chigley"
+                           && author.Contact.Phone != null)
+                          || author.Name.StartsWith("D"))
+            .OrderBy(author => author.Contact.Phone)
+            .Select(
+                author => author.Name + " (" + author.Contact.Address.Street
+                          + ", " + author.Contact.Address.City
+                          + " " + author.Contact.Address.Postcode + ")")
+            .ToListAsync();
+-->
+[!code-csharp[OrderedAddresses](../../../../samples/core/Miscellaneous/NewInEFCore7/JsonColumnsSample.cs?name=OrderedAddresses)]
+
+This query generates the following SQL:
+
+```sql
+SELECT (((((([a].[Name] + N' (') + CAST(JSON_VALUE([a].[Contact],'$.Address.Street') AS nvarchar(max))) + N', ') + CAST(JSON_VALUE([a].[Contact],'$.Address.City') AS nvarchar(max))) + N' ') + CAST(JSON_VALUE([a].[Contact],'$.Address.Postcode') AS nvarchar(max))) + N')'
+FROM [Authors] AS [a]
+WHERE (CAST(JSON_VALUE([a].[Contact],'$.Address.City') AS nvarchar(max)) = N'Chigley' AND CAST(JSON_VALUE([a].[Contact],'$.Phone') AS nvarchar(max)) IS NOT NULL) OR ([a].[Name] LIKE N'D%')
+ORDER BY CAST(JSON_VALUE([a].[Contact],'$.Phone') AS nvarchar(max))
+```
+
+And when the JSON document contains collections, then these can be projected out in the results:
+
+<!--
+        var postsWithViews = await context.Posts.Where(post => post.Metadata!.Views > 3000)
+            .AsNoTracking()
+            .Select(
+                post => new
+                {
+                    post.Author!.Name,
+                    post.Metadata!.Views,
+                    Searches = post.Metadata.TopSearches,
+                    Commits = post.Metadata.Updates
+                })
+            .ToListAsync();
+-->
+[!code-csharp[PostsWithViews](../../../../samples/core/Miscellaneous/NewInEFCore7/JsonColumnsSample.cs?name=PostsWithViews)]
+
+This query generates the following SQL:
+
+```sql
+SELECT [a].[Name], CAST(JSON_VALUE([p].[Metadata],'$.Views') AS int), JSON_QUERY([p].[Metadata],'$.TopSearches'), [p].[Id], JSON_QUERY([p].[Metadata],'$.Updates')
+FROM [Posts] AS [p]
+LEFT JOIN [Authors] AS [a] ON [p].[AuthorId] = [a].[Id]
+WHERE CAST(JSON_VALUE([p].[Metadata],'$.Views') AS int) > 3000
+```
+
+> [!NOTE]
+> More complex queries involving JSON collections require `jsonpath` support. Vote for [Support jsonpath querying](https://github.com/dotnet/efcore/issues/28616) if this is something you are interested in.
+
+> [!TIP]
+> Consider creating indexes to improve query performance in JSON documents. For example, see [Index Json data](/sql/relational-databases/json/index-json-data) when using SQL Server.
+
+### Updating JSON columns
+
+[`SaveChanges` and `SaveChangesAsync`](xref:core/saving/basic) work in the normal way to make updates to a JSON column. For extensive changes, the entire document will be updated. For example, replacing most of the `Contact` document for an author:
+
+<!--
+        var jeremy = await context.Authors.SingleAsync(author => author.Name.StartsWith("Jeremy"));
+
+        jeremy.Contact = new() { Address = new("2 Riverside", "Trimbridge", "TB1 5ZS", "UK"), Phone = "01632 88346" };
+
+        await context.SaveChangesAsync();
+-->
+[!code-csharp[UpdateDocument](../../../../samples/core/Miscellaneous/NewInEFCore7/JsonColumnsSample.cs?name=UpdateDocument)]
+
+In this case, the entire new document is passed as a parameter:
+
+```text
+info: 8/30/2022 20:21:24.392 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed DbCommand (2ms) [Parameters=[@p0='{"Phone":"01632 88346","Address":{"City":"Trimbridge","Country":"UK","Postcode":"TB1 5ZS","Street":"2 Riverside"}}' (Nullable = false) (Size = 114), @p1='2'], CommandType='Text', CommandTimeout='30']
+```
+
+Which is then used in the `UPDATE` SQL:
+
+```sql
+UPDATE [Authors] SET [Contact] = @p0
+OUTPUT 1
+WHERE [Id] = @p1;
+```
+
+However, if only a sub-document is changed, then EF Core will use a `JSON_MODIFY` command to update only the sub-document. For example, changing the `Address` inside a `Contact` document:
+
+<!--
+        var brice = await context.Authors.SingleAsync(author => author.Name.StartsWith("Brice"));
+
+        brice.Contact.Address = new("4 Riverside", "Trimbridge", "TB1 5ZS", "UK");
+
+        await context.SaveChangesAsync();
+-->
+[!code-csharp[UpdateSubDocument](../../../../samples/core/Miscellaneous/NewInEFCore7/JsonColumnsSample.cs?name=UpdateSubDocument)]
+
+Generates the following parameters:
+
+```text
+info: 10/2/2022 15:51:15.895 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed DbCommand (2ms) [Parameters=[@p0='{"City":"Trimbridge","Country":"UK","Postcode":"TB1 5ZS","Street":"4 Riverside"}' (Nullable = false) (Size = 80), @p1='5'], CommandType='Text', CommandTimeout='30']
+```
+
+Which is used in the `UPDATE` via a `JSON_MODIFY` call:
+
+```sql
+UPDATE [Authors] SET [Contact] = JSON_MODIFY([Contact], 'strict $.Address', JSON_QUERY(@p0))
+OUTPUT 1
+WHERE [Id] = @p1;
+```
+
+Finally, if only a single property is changed, then EF Core will again use a "JSON_MODIFY" command, this time to patch only the changed property value. For example:
+
+<!--
+        var arthur = await context.Authors.SingleAsync(author => author.Name.StartsWith("Arthur"));
+
+        arthur.Contact.Address.Country = "United Kingdom";
+
+        await context.SaveChangesAsync();
+-->
+[!code-csharp[UpdateProperty](../../../../samples/core/Miscellaneous/NewInEFCore7/JsonColumnsSample.cs?name=UpdateProperty)]
+
+Generates the following parameters:
+
+```text
+info: 10/2/2022 15:54:05.112 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed DbCommand (2ms) [Parameters=[@p0='["United Kingdom"]' (Nullable = false) (Size = 18), @p1='4'], CommandType='Text', CommandTimeout='30']
+```
+
+Which are again used with a `JSON_MODIFY`:
+
+```sql
+UPDATE [Authors] SET [Contact] = JSON_MODIFY([Contact], 'strict $.Address.Country', JSON_VALUE(@p0, '$[0]'))
+OUTPUT 1
+WHERE [Id] = @p1;
+```
+
+## ExecuteUpdate and ExecuteDelete (Bulk updates)
+
+By default, EF Core [tracks changes to entities](xref:core/change-tracking/index), and then [sends updates to the database](xref:core/saving/index) when one of the `SaveChanges` methods is called. Changes are only sent for properties and relationships that have actually changed. Also, the tracked entities remain in sync with the changes sent to the database. This mechanism is an efficient and convenient way to send general-purpose inserts, updates, and deletes to the database. These changes are also batched to reduce the number of database round-trips.
+
+However, it is sometimes useful to execute update or delete commands on the database without involving the change tracker. EF7 enables this with the new <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.ExecuteUpdate*> and <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.ExecuteDelete*> methods. These methods are applied to a LINQ query and will update or delete entities in the database based on the results of that query. Many entities can be updated with a single command and the entities are not loaded into memory, which means this can result in more efficient updates and deletes.
+
+However, keep in mind that:
+
+- The specific changes to make must be specified explicitly; they are not automatically detected by EF Core.
+- Any tracked entities will not be kept in sync.
+- Additional commands may need to be sent in the correct order so as not to violate database constraints. For example, deleting dependents before a principal can be deleted.
+
+All of this means that the `ExecuteUpdate` and `ExecuteDelete` methods complement, rather than replace, the existing `SaveChanges` mechanism.
+
+### Basic `ExecuteDelete` examples
+
+> [!TIP]
+> The code shown here comes from [ExecuteDeleteSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore7/ExecuteDeleteSample.cs).
+
+Calling `ExecuteDelete` or `ExecuteDeleteAsync` on a `DbSet` immediately deletes all entities of that `DbSet` from the database. For example, to delete all `Tag` entities:
+
+<!--
+        await context.Tags.ExecuteDeleteAsync();
+-->
+[!code-csharp[DeleteAllTags](../../../../samples/core/Miscellaneous/NewInEFCore7/ExecuteDeleteSample.cs?name=DeleteAllTags)]
+
+This executes the following SQL when using SQL Server:
+
+```sql
+DELETE FROM [t]
+FROM [Tags] AS [t]
+```
+
+More interestingly, the query can contain a filter. For example:
+
+<!--
+        await context.Tags.Where(t => t.Text.Contains(".NET")).ExecuteDeleteAsync();
+-->
+[!code-csharp[DeleteTagsContainingDotNet](../../../../samples/core/Miscellaneous/NewInEFCore7/ExecuteDeleteSample.cs?name=DeleteTagsContainingDotNet)]
+
+This executes the following SQL:
+
+```sql
+DELETE FROM [t]
+FROM [Tags] AS [t]
+WHERE [t].[Text] LIKE N'%.NET%'
+```
+
+The query can also use more complex filters, including navigations to other types. For example, to delete tags only from old blog posts:
+
+<!--
+        await context.Tags.Where(t => t.Posts.All(e => e.PublishedOn.Year < 2022)).ExecuteDeleteAsync();
+-->
+[!code-csharp[DeleteTagsFromOldPosts](../../../../samples/core/Miscellaneous/NewInEFCore7/ExecuteDeleteSample.cs?name=DeleteTagsFromOldPosts)]
+
+Which executes:
+
+```sql
+DELETE FROM [t]
+FROM [Tags] AS [t]
+WHERE NOT EXISTS (
+    SELECT 1
+    FROM [PostTag] AS [p]
+    INNER JOIN [Posts] AS [p0] ON [p].[PostsId] = [p0].[Id]
+    WHERE [t].[Id] = [p].[TagsId] AND NOT (DATEPART(year, [p0].[PublishedOn]) < 2022))
+```
+
+### Basic `ExecuteUpdate` examples
+
+> [!TIP]
+> The code shown here comes from [ExecuteUpdateSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore7/ExecuteUpdateSample.cs).
+
+`ExecuteUpdate` and `ExecuteUpdateAsync` behave in a very similar way to the `ExecuteDelete` methods. The main difference is that an update requires knowing _which_ properties to update, and _how_ to update them. This is achieved using one or more calls to `SetProperty`. For example, to update the `Name` of every blog:
+
+<!--
+        await context.Blogs.ExecuteUpdateAsync(
+            s => s.SetProperty(b => b.Name, b => b.Name + " *Featured!*"));
+-->
+[!code-csharp[UpdateAllBlogs](../../../../samples/core/Miscellaneous/NewInEFCore7/ExecuteUpdateSample.cs?name=UpdateAllBlogs)]
+
+The first parameter of `SetProperty` specifies which property to update; in this case, `Blog.Name`. The second parameter specifies how the new value should be calculated; in this case, by taking the existing value and appending `"*Featured!*"`. The resulting SQL is:
+
+```sql
+UPDATE [b]
+SET [b].[Name] = [b].[Name] + N' *Featured!*'
+FROM [Blogs] AS [b]
+```
+
+As with `ExecuteDelete`, the query can be used to filter which entities are updated. In addition, multiple calls to `SetProperty` can be used to update more than one property on the target entity. For example, to update the `Title` and `Content` of all posts published before 2022:
+
+<!--
+            .Where(p => p.PublishedOn.Year < 2022)
+            .ExecuteUpdateAsync(s => s
+                .SetProperty(b => b.Title, b => b.Title + " (" + b.PublishedOn.Year + ")")
+                .SetProperty(b => b.Content, b => b.Content + " ( This content was published in " + b.PublishedOn.Year + ")"));
+-->
+[!code-csharp[UpdateOldPosts](../../../../samples/core/Miscellaneous/NewInEFCore7/ExecuteUpdateSample.cs?name=UpdateOldPosts)]
+
+In this case the generated SQL is a bit more complicated:
+
+```sql
+UPDATE [p]
+SET [p].[Content] = (([p].[Content] + N' ( This content was published in ') + COALESCE(CAST(DATEPART(year, [p].[PublishedOn]) AS nvarchar(max)), N'')) + N')',
+    [p].[Title] = (([p].[Title] + N' (') + COALESCE(CAST(DATEPART(year, [p].[PublishedOn]) AS nvarchar(max)), N'')) + N')'
+FROM [Posts] AS [p]
+WHERE DATEPART(year, [p].[PublishedOn]) < 2022
+```
+
+Finally, again as with `ExecuteDelete`, the filter can reference other tables. For example, to update all tags from old posts:
+
+<!--
+        await context.Tags
+            .Where(t => t.Posts.All(e => e.PublishedOn.Year < 2022))
+            .ExecuteUpdateAsync(s => s.SetProperty(t => t.Text, t => t.Text + " (old)"));
+-->
+[!code-csharp[UpdateTagsOnOldPosts](../../../../samples/core/Miscellaneous/NewInEFCore7/ExecuteUpdateSample.cs?name=UpdateTagsOnOldPosts)]
+
+Which generates:
+
+```sql
+UPDATE [t]
+SET [t].[Text] = [t].[Text] + N' (old)'
+FROM [Tags] AS [t]
+WHERE NOT EXISTS (
+    SELECT 1
+    FROM [PostTag] AS [p]
+    INNER JOIN [Posts] AS [p0] ON [p].[PostsId] = [p0].[Id]
+    WHERE [t].[Id] = [p].[TagsId] AND NOT (DATEPART(year, [p0].[PublishedOn]) < 2022))
+```
+
+For more information and code samples on `ExecuteUpdate` and `ExecuteDelete`, see [ExecuteUpdate and ExecuteDelete](xref:core/saving/execute-insert-update-delete).
+
+### Inheritance and multiple tables
+
+`ExecuteUpdate` and `ExecuteDelete` can only act on a single table. This has implications when working with different [inheritance mapping strategies](xref:core/modeling/inheritance). Generally, there are no problems when using the TPH mapping strategy, since there is only one table to modify. For example, deleting all `FeaturedPost` entities:
+
+<!--
+        await context.Set<FeaturedPost>().ExecuteDeleteAsync();
+-->
+[!code-csharp[DeleteFeaturedPosts](../../../../samples/core/Miscellaneous/NewInEFCore7/ExecuteDeleteSample.cs?name=DeleteFeaturedPosts)]
+
+Generates the following SQL when using TPH mapping:
+
+```sql
+DELETE FROM [p]
+FROM [Posts] AS [p]
+WHERE [p].[Discriminator] = N'FeaturedPost'
+```
+
+There are also no issues for this case when using the TPC mapping strategy, since again only changes to a single table are needed:
+
+```sql
+DELETE FROM [f]
+FROM [FeaturedPosts] AS [f]
+```
+
+However, attempting this when using the TPT mapping strategy will fail since it would require deleting rows from two different tables.
+
+Adding a filter to the query often means the operation will fail with both the TPC and TPT strategies. This is again because the rows may need to be deleted from multiple tables. For example, this query:
+
+<!--
+        await context.Posts.Where(p => p.Author.Name.StartsWith("Arthur")).ExecuteDeleteAsync();
+-->
+[!code-csharp[DeletePostsForGivenAuthor](../../../../samples/core/Miscellaneous/NewInEFCore7/ExecuteDeleteSample.cs?name=DeletePostsForGivenAuthor)]
+
+Generates the following SQL when using TPH:
+
+```sql
+DELETE FROM [p]
+FROM [Posts] AS [p]
+LEFT JOIN [Authors] AS [a] ON [p].[AuthorId] = [a].[Id]
+WHERE [a].[Name] IS NOT NULL AND ([a].[Name] LIKE N'Arthur%')
+```
+
+But fails when using TPC or TPT.
+
+> [!TIP]
+> [Issue #10879](https://github.com/dotnet/efcore/issues/28520) tracks adding support for automatically sending multiple commands in these scenarios. Vote for this issue if it's something you would like to see implemented.
+
+### `ExecuteDelete` and relationships
+
+As mentioned above, it may be necessary to delete or update dependent entities before the principal of a relationship can be deleted. For example, each `Post` is a dependent of its associated `Author`. This means that an author cannot be deleted if a post still references it; doing so will violate the foreign key constraint in the database. For example, attempting this:
+
+```csharp
+await context.Authors.ExecuteDeleteAsync();
+```
+
+Will result in the following exception on SQL Server:
+
+> Microsoft.Data.SqlClient.SqlException (0x80131904): The DELETE statement conflicted with the REFERENCE constraint "FK_Posts_Authors_AuthorId". The conflict occurred in database "TphBlogsContext", table "dbo.Posts", column 'AuthorId'.
+The statement has been terminated.
+
+To fix this, we must first either delete the posts, or sever the relationship between each post and its author by setting `AuthorId` foreign key property to null. For example, using the delete option:
+
+<!--
+        await context.Posts.TagWith("Deleting posts...").ExecuteDeleteAsync();
+        await context.Authors.TagWith("Deleting authors...").ExecuteDeleteAsync();
+-->
+[!code-csharp[DeleteAllAuthors](../../../../samples/core/Miscellaneous/NewInEFCore7/ExecuteDeleteSample.cs?name=DeleteAllAuthors)]
+
+> [!TIP]
+> `TagWith` can be used to tag `ExecuteDelete` or `ExecuteUpdate` in the same way as it tags normal queries.
+
+This results in two separate commands; the first to delete the dependents:
+
+```sql
+-- Deleting posts...
+
+DELETE FROM [p]
+FROM [Posts] AS [p]
+```
+
+And the second to delete the principals:
+
+```sql
+-- Deleting authors...
+
+DELETE FROM [a]
+FROM [Authors] AS [a]
+```
+
+> [!IMPORTANT]
+> Multiple `ExecuteDelete` and `ExecuteUpdate` commands will not be contained in a single transaction by default. However, the [DbContext transaction APIs](xref:core/saving/transactions) can be used in the normal way to wrap these commands in a transaction.
+
+> [!TIP]
+> Sending these commands in a single round-trip depends on [Issue #10879](https://github.com/dotnet/efcore/issues/10879). Vote for this issue if it's something you would like to see implemented.
+
+Configuring [cascade deletes](xref:core/saving/cascade-delete) in the database can be very useful here. In our model, the relationship between `Blog` and `Post` is required, which causes EF Core to configure a cascade delete by convention.  This means when a blog is deleted from the database, then all its dependent posts will also be deleted. It then follows that to delete all blogs and posts we need only delete the blogs:
+
+<!--
+        await context.Blogs.ExecuteDeleteAsync();
+-->
+[!code-csharp[DeleteAllBlogsAndPosts](../../../../samples/core/Miscellaneous/NewInEFCore7/ExecuteDeleteSample.cs?name=DeleteAllBlogsAndPosts)]
+
+This results in the following SQL:
+
+```sql
+DELETE FROM [b]
+FROM [Blogs] AS [b]
+```
+
+Which, as it is deleting a blog, will also cause all related posts to be deleted by the configured cascade delete.
+
+## Faster SaveChanges
+
+In EF7, the performance of <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChanges*> and <xref:Microsoft.EntityFrameworkCore.DbContext.SaveChangesAsync*> has been significantly improved. In some scenarios, saving changes is now up to four times faster than with EF Core 6.0!
+
+Most of these improvements come from:
+
+- Performing fewer roundtrips to the database
+- Generating faster SQL
+
+Some examples of these improvements are shown below.
+
+> [!NOTE]
+> See [Announcing Entity Framework Core 7 Preview 6: Performance Edition](https://devblogs.microsoft.com/dotnet/announcing-ef-core-7-preview6-performance-optimizations/) on the .NET Blog for an in-depth discussion of these changes.
+
+> [!TIP]
+> The code shown here comes from [SaveChangesPerformanceSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore7/SaveChangesPerformanceSample.cs).
+
+### Unneeded transactions are eliminated
+
+All modern relational databases guarantee transactionality for (most) single SQL statements. That is, the statement will never be only partially completed, even if an error occurs. EF7 avoids starting an explicit transaction in these cases.
+
+For example, looking at the logging for the following call to `SaveChanges`:
+
+<!--
+            await context.AddAsync(new Blog { Name = "MyBlog" });
+            await context.SaveChangesAsync();
+-->
+[!code-csharp[SimpleInsert](../../../../samples/core/Miscellaneous/NewInEFCore7/SaveChangesPerformanceSample.cs?name=SimpleInsert)]
+
+Shows that in EF Core 6.0, the `INSERT` command is wrapped by commands to begin and and then commit a transaction:
+
+```output
+dbug: 9/29/2022 11:43:09.196 RelationalEventId.TransactionStarted[20200] (Microsoft.EntityFrameworkCore.Database.Transaction)
+      Began transaction with isolation level 'ReadCommitted'.
+info: 9/29/2022 11:43:09.265 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed DbCommand (27ms) [Parameters=[@p0='MyBlog' (Nullable = false) (Size = 4000)], CommandType='Text', CommandTimeout='30']
+      SET NOCOUNT ON;
+      INSERT INTO [Blogs] ([Name])
+      VALUES (@p0);
+      SELECT [Id]
+      FROM [Blogs]
+      WHERE @@ROWCOUNT = 1 AND [Id] = scope_identity();
+dbug: 9/29/2022 11:43:09.297 RelationalEventId.TransactionCommitted[20202] (Microsoft.EntityFrameworkCore.Database.Transaction)
+      Committed transaction.
+```
+
+EF7 detects that the transaction is not needed here and so removes these calls:
+
+```output
+info: 9/29/2022 11:42:34.776 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed DbCommand (25ms) [Parameters=[@p0='MyBlog' (Nullable = false) (Size = 4000)], CommandType='Text', CommandTimeout='30']
+      SET IMPLICIT_TRANSACTIONS OFF;
+      SET NOCOUNT ON;
+      INSERT INTO [Blogs] ([Name])
+      OUTPUT INSERTED.[Id]
+      VALUES (@p0);
+```
+
+This removes two database roundtrips, which can make a huge difference to overall performance, especially when the latency of calls to the database is high. In typical production systems, the database is not co-located on the same machine as the application. This means latency is often relatively high, making this optimization particularly effective in real-world production systems.
+
+### Improved SQL for simple Identity insert
+
+The case above inserts a single row with an `IDENTITY` key column and no other database-generated values. EF7 simplifies the SQL in this case by using `OUTPUT INSERTED`. While this simplification is not valid for many other cases, it is still important to improve since this kind of single-row insert is very common in many applications.
+
+### Inserting multiple rows
+
+In EF Core 6.0, the default approach for inserting multiple rows was driven by limitations in SQL Server support for tables with triggers. We wanted to make sure that the default experience worked even for the minority of users with triggers in their tables. This meant that we could not use a simple `OUTPUT` clause, because, on SQL Server, this [doesn't work with triggers](/sql/t-sql/queries/output-clause-transact-sql#triggers). Instead, when inserting multiple entities, EF Core 6.0 generated some fairly convoluted SQL. For example, this call to `SaveChanges`:
+
+<!--
+            for (var i = 0; i < 4; i++)
+            {
+                await context.AddAsync(new Blog { Name = "Foo" + i });
+            }
+            await context.SaveChangesAsync();
+-->
+[!code-csharp[MultipleInsert](../../../../samples/core/Miscellaneous/NewInEFCore7/SaveChangesPerformanceSample.cs?name=MultipleInsert)]
+
+Results in the following actions when run against SQL Server with EF Core 6.0:
+
+```output
+dbug: 9/30/2022 17:19:51.919 RelationalEventId.TransactionStarted[20200] (Microsoft.EntityFrameworkCore.Database.Transaction)
+      Began transaction with isolation level 'ReadCommitted'.
+info: 9/30/2022 17:19:51.993 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed DbCommand (27ms) [Parameters=[@p0='Foo0' (Nullable = false) (Size = 4000), @p1='Foo1' (Nullable = false) (Size = 4000), @p2='Foo2' (Nullable = false) (Size = 4000), @p3='Foo3' (Nullable = false) (Size = 4000)], CommandType='Text', CommandTimeout='30']
+      SET NOCOUNT ON;
+      DECLARE @inserted0 TABLE ([Id] int, [_Position] [int]);
+      MERGE [Blogs] USING (
+      VALUES (@p0, 0),
+      (@p1, 1),
+      (@p2, 2),
+      (@p3, 3)) AS i ([Name], _Position) ON 1=0
+      WHEN NOT MATCHED THEN
+      INSERT ([Name])
+      VALUES (i.[Name])
+      OUTPUT INSERTED.[Id], i._Position
+      INTO @inserted0;
+
+      SELECT [i].[Id] FROM @inserted0 i
+      ORDER BY [i].[_Position];
+dbug: 9/30/2022 17:19:52.023 RelationalEventId.TransactionCommitted[20202] (Microsoft.EntityFrameworkCore.Database.Transaction)
+      Committed transaction.
+```
+
+> [!IMPORTANT]
+> Even though this is complicated, batching multiple inserts like this is still significantly faster than sending a single command for each insert.
+
+In EF7, you can still get this SQL if your tables contain triggers, but for the common case we now generate much more efficient, if still somewhat complex, commands:
+
+```output
+info: 9/30/2022 17:40:37.612 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed DbCommand (4ms) [Parameters=[@p0='Foo0' (Nullable = false) (Size = 4000), @p1='Foo1' (Nullable = false) (Size = 4000), @p2='Foo2' (Nullable = false) (Size = 4000), @p3='Foo3' (Nullable = false) (Size = 4000)], CommandType='Text', CommandTimeout='30']
+      SET IMPLICIT_TRANSACTIONS OFF;
+      SET NOCOUNT ON;
+      MERGE [Blogs] USING (
+      VALUES (@p0, 0),
+      (@p1, 1),
+      (@p2, 2),
+      (@p3, 3)) AS i ([Name], _Position) ON 1=0
+      WHEN NOT MATCHED THEN
+      INSERT ([Name])
+      VALUES (i.[Name])
+      OUTPUT INSERTED.[Id], i._Position;
+```
+
+The transaction is gone, as in the single insert case, because `MERGE` is a single statement protected by an implicit transaction. Also, the temporary table is gone and the OUTPUT clause now sends the generated IDs directly back to the client. This can be **four times faster than on EF Core 6.0**, depending on environmental factors such as latency between the application and database.
+
+### Triggers
+
+If the table has triggers, then the call to `SaveChanges` in the code above will throw an exception:
+
+> Unhandled exception. Microsoft.EntityFrameworkCore.DbUpdateException:</br>
+> Could not save changes because the target table has database triggers. Please configure your entity type accordingly, see `https://aka.ms/efcore-docs-sqlserver-save-changes-and-triggers` for more information.</br>
+> ---> Microsoft.Data.SqlClient.SqlException (0x80131904):</br>
+> The target table 'BlogsWithTriggers' of the DML statement cannot have any enabled triggers if the statement contains an OUTPUT clause without INTO clause.
+
+The following code can be used to inform EF Core that the table has a trigger:
+
+<!--
+            modelBuilder.Entity<BlogWithTrigger>()
+                .ToTable(tb => tb.HasTrigger("TRG_InsertUpdateBlog"));
+-->
+[!code-csharp[HasTrigger](../../../../samples/core/Miscellaneous/NewInEFCore7/SaveChangesPerformanceSample.cs?name=HasTrigger)]
+
+EF7 will then revert to the EF Core 6.0 SQL when sending insert and update commands for this table.
+
+For more information, including a convention to automatically configure all mapped tables with triggers, see [SQL Server tables with triggers now require special EF Core configuration](xref:core/what-is-new/ef-core-7.0/breaking-changes#sqlserver-tables-with-triggers) in the EF7 breaking changes documentation.
+
+### Fewer roundtrips for inserting graphs
+
+Consider inserting a graph of entities containing a new principal entity and also new dependent entities with foreign keys that reference the new principal. For example:
+
+<!--
+            await context.AddAsync(new Blog
+            {
+                Name = "MyBlog",
+                Posts =
+                {
+                    new() { Title = "My first post" },
+                    new() { Title = "My second post" }
+                }
+            });
+            await context.SaveChangesAsync();
+-->
+[!code-csharp[InsertGraph](../../../../samples/core/Miscellaneous/NewInEFCore7/SaveChangesPerformanceSample.cs?name=InsertGraph)]
+
+If the principal's primary key is generated by the database, then the value to set for the foreign key in the dependent is not known until the principal has been inserted. EF Core generates two roundtrips for this--one to insert the principal and get back the new primary key, and a second to insert the dependents with the foreign key value set. And since there are two statements for this, a transaction is needed, meaning there are in total four roundtrips:
+
+```output
+dbug: 10/1/2022 13:12:02.517 RelationalEventId.TransactionStarted[20200] (Microsoft.EntityFrameworkCore.Database.Transaction)
+      Began transaction with isolation level 'ReadCommitted'.
+info: 10/1/2022 13:12:02.517 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed DbCommand (0ms) [Parameters=[@p0='MyBlog' (Nullable = false) (Size = 4000)], CommandType='Text', CommandTimeout='30']
+      SET IMPLICIT_TRANSACTIONS OFF;
+      SET NOCOUNT ON;
+      INSERT INTO [Blogs] ([Name])
+      OUTPUT INSERTED.[Id]
+      VALUES (@p0);
+info: 10/1/2022 13:12:02.529 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed DbCommand (5ms) [Parameters=[@p1='6', @p2='My first post' (Nullable = false) (Size = 4000), @p3='6', @p4='My second post' (Nullable = false) (Size = 4000)], CommandType='Text', CommandTimeout='30']
+      SET IMPLICIT_TRANSACTIONS OFF;
+      SET NOCOUNT ON;
+      MERGE [Post] USING (
+      VALUES (@p1, @p2, 0),
+      (@p3, @p4, 1)) AS i ([BlogId], [Title], _Position) ON 1=0
+      WHEN NOT MATCHED THEN
+      INSERT ([BlogId], [Title])
+      VALUES (i.[BlogId], i.[Title])
+      OUTPUT INSERTED.[Id], i._Position;
+dbug: 10/1/2022 13:12:02.531 RelationalEventId.TransactionCommitted[20202] (Microsoft.EntityFrameworkCore.Database.Transaction)
+      Committed transaction.
+```
+
+However, in some cases, the primary key value is known before the principal is inserted. This includes:
+
+- Key values that are not automatically generated
+- Key values that are generated on the client, such as <xref:System.Guid> keys
+- Key values that are generated on the server in batches, such as when using a hi-lo value generator
+
+In EF7, these cases are now optimized into a single round-trip. For example, in the case above on SQL Server, the `Blog.Id` primary key can be configured to use the hi-lo generation strategy:
+
+<!--
+            modelBuilder.Entity<Blog>().Property(e => e.Id).UseHiLo();
+            modelBuilder.Entity<Post>().Property(e => e.Id).UseHiLo();
+-->
+[!code-csharp[UseHiLo](../../../../samples/core/Miscellaneous/NewInEFCore7/SaveChangesPerformanceSample.cs?name=UseHiLo)]
+
+The `SaveChanges` call from above is now optimized to a single roundtrip for the inserts.
+
+```output
+dbug: 10/1/2022 21:51:55.805 RelationalEventId.TransactionStarted[20200] (Microsoft.EntityFrameworkCore.Database.Transaction)
+      Began transaction with isolation level 'ReadCommitted'.
+info: 10/1/2022 21:51:55.806 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed DbCommand (0ms) [Parameters=[@p0='9', @p1='MyBlog' (Nullable = false) (Size = 4000), @p2='10', @p3='9', @p4='My first post' (Nullable = false) (Size = 4000), @p5='11', @p6='9', @p7='My second post' (Nullable = false) (Size = 4000)], CommandType='Text', CommandTimeout='30']
+      SET NOCOUNT ON;
+      INSERT INTO [Blogs] ([Id], [Name])
+      VALUES (@p0, @p1);
+      INSERT INTO [Posts] ([Id], [BlogId], [Title])
+      VALUES (@p2, @p3, @p4),
+      (@p5, @p6, @p7);
+dbug: 10/1/2022 21:51:55.807 RelationalEventId.TransactionCommitted[20202] (Microsoft.EntityFrameworkCore.Database.Transaction)
+      Committed transaction.
+```
+
+Notice that a transaction is still needed here. This is because inserts are being made into two separate tables.
+
+EF7 also uses a single batch in other cases where EF Core 6.0 would create more than one. For example, when deleting and inserting rows into the same table.
+
+### The value of SaveChanges
+
+As some of the examples here show, saving results to the database can be a complex business. This is where using something like EF Core really shows its value. EF Core:
+
+- Batches multiple insert, update, and delete commands together to reduce roundtrips
+- Figures out if an explicit transaction is needed or not
+- Determines what order to insert, update, and delete entities so that database constraints are not violated
+- Ensures database generated values are returned efficiently and propagated back into entities
+- Automatically sets foreign key values using the values generated for primary keys
+- Detect concurrency conflicts
+
+In addition, different database systems require different SQL for many of these cases. The EF Core database provider works with EF Core to ensure correct and efficient commands are sent for each case.
+
+## Table-per-concrete-type (TPC) inheritance mapping
+
+By default, EF Core maps an inheritance hierarchy of .NET types to a single database table. This is known as the [table-per-hierarchy (TPH)](xref:core/modeling/inheritance#table-per-hierarchy-and-discriminator-configuration) mapping strategy. EF Core 5.0 introduced the [table-per-type (TPT)](xref:core/modeling/inheritance#table-per-type-configuration) strategy, which supports mapping each .NET type to a different database table. EF7 introduces the table-per-concrete-type (TPC) strategy. TPC also maps .NET types to different tables, but in a way that addresses some common performance issues with the TPT strategy.
+
+> [!TIP]
+> The code shown here comes from [TpcInheritanceSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore7/TpcInheritanceSample.cs).
+
+> [!TIP]
+> The EF Team demonstrated and talked in depth about TPC mapping in an episode of the .NET Data Community Standup. As with [all Community Standup episodes](https://aka.ms/efstandups), you can [watch the TPC episode now on YouTube](https://youtu.be/HaL6DKW1mrg).
+
+### TPC database schema
+
+The TPC strategy is similar to the TPT strategy except that a different table is created for every _concrete_ type in the hierarchy, but tables are **not** created for _abstract_ types--hence the name “table-per-concrete-type”. As with TPT, the table itself indicates the type of the saved object. However, unlike TPT mapping, each table contains columns for every property in the concrete type and its base types. TPC database schemas are denormalized.
+
+For example, consider mapping this hierarchy:
+
+<!--
+    public abstract class Animal
+    {
+        protected Animal(string name)
+        {
+            Name = name;
+        }
+
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public abstract string Species { get; }
+
+        public Food? Food { get; set; }
+    }
+
+    public abstract class Pet : Animal
+    {
+        protected Pet(string name)
+            : base(name)
+        {
+        }
+
+        public string? Vet { get; set; }
+
+        public ICollection<Human> Humans { get; } = new List<Human>();
+    }
+
+    public class FarmAnimal : Animal
+    {
+        public FarmAnimal(string name, string species)
+            : base(name)
+        {
+            Species = species;
+        }
+
+        public override string Species { get; }
+
+        [Precision(18, 2)]
+        public decimal Value { get; set; }
+
+        public override string ToString()
+            => $"Farm animal '{Name}' ({Species}/{Id}) worth {Value:C} eats {Food?.ToString() ?? "<Unknown>"}";
+    }
+
+    public class Cat : Pet
+    {
+        public Cat(string name, string educationLevel)
+            : base(name)
+        {
+            EducationLevel = educationLevel;
+        }
+
+        public string EducationLevel { get; set; }
+        public override string Species => "Felis catus";
+
+        public override string ToString()
+            => $"Cat '{Name}' ({Species}/{Id}) with education '{EducationLevel}' eats {Food?.ToString() ?? "<Unknown>"}";
+    }
+
+    public class Dog : Pet
+    {
+        public Dog(string name, string favoriteToy)
+            : base(name)
+        {
+            FavoriteToy = favoriteToy;
+        }
+
+        public string FavoriteToy { get; set; }
+        public override string Species => "Canis familiaris";
+
+        public override string ToString()
+            => $"Dog '{Name}' ({Species}/{Id}) with favorite toy '{FavoriteToy}' eats {Food?.ToString() ?? "<Unknown>"}";
+    }
+
+    public class Human : Animal
+    {
+        public Human(string name)
+            : base(name)
+        {
+        }
+
+        public override string Species => "Homo sapiens";
+
+        public Animal? FavoriteAnimal { get; set; }
+        public ICollection<Pet> Pets { get; } = new List<Pet>();
+
+        public override string ToString()
+            => $"Human '{Name}' ({Species}/{Id}) with favorite animal '{FavoriteAnimal?.Name ?? "<Unknown>"}'" +
+               $" eats {Food?.ToString() ?? "<Unknown>"}";
+    }
+-->
+[!code-csharp[AnimalsHierarchy](../../../../samples/core/Miscellaneous/NewInEFCore7/TpcInheritanceSample.cs?name=AnimalsHierarchy)]
+
+When using SQL Server, the tables created for this hierarchy are:
+
+```sql
+CREATE TABLE [Cats] (
+    [Id] int NOT NULL DEFAULT (NEXT VALUE FOR [AnimalSequence]),
+    [Name] nvarchar(max) NOT NULL,
+    [FoodId] uniqueidentifier NULL,
+    [Vet] nvarchar(max) NULL,
+    [EducationLevel] nvarchar(max) NOT NULL,
+    CONSTRAINT [PK_Cats] PRIMARY KEY ([Id]));
+
+CREATE TABLE [Dogs] (
+    [Id] int NOT NULL DEFAULT (NEXT VALUE FOR [AnimalSequence]),
+    [Name] nvarchar(max) NOT NULL,
+    [FoodId] uniqueidentifier NULL,
+    [Vet] nvarchar(max) NULL,
+    [FavoriteToy] nvarchar(max) NOT NULL,
+    CONSTRAINT [PK_Dogs] PRIMARY KEY ([Id]));
+
+CREATE TABLE [FarmAnimals] (
+    [Id] int NOT NULL DEFAULT (NEXT VALUE FOR [AnimalSequence]),
+    [Name] nvarchar(max) NOT NULL,
+    [FoodId] uniqueidentifier NULL,
+    [Value] decimal(18,2) NOT NULL,
+    [Species] nvarchar(max) NOT NULL,
+    CONSTRAINT [PK_FarmAnimals] PRIMARY KEY ([Id]));
+
+CREATE TABLE [Humans] (
+    [Id] int NOT NULL DEFAULT (NEXT VALUE FOR [AnimalSequence]),
+    [Name] nvarchar(max) NOT NULL,
+    [FoodId] uniqueidentifier NULL,
+    [FavoriteAnimalId] int NULL,
+    CONSTRAINT [PK_Humans] PRIMARY KEY ([Id]));
+```
+
+Notice that:
+
+- There are no tables for the `Animal` or `Pet` types, since these are `abstract` in the object model. Remember that C# does not allow instances of abstract types, and there is therefore no situation where an abstract type instance will be saved to the database.
+- The mapping of properties in base types is repeated for each concrete type. For example, every table has a `Name` column, and both Cats and Dogs have a `Vet` column.
+
+- Saving some data into this database results in the following:
+
+**Cats table**
+
+| Id  | Name   | FoodId                               | Vet                  | EducationLevel |
+|:----|:-------|:-------------------------------------|:---------------------|:---------------|
+| 1   | Alice  | 99ca3e98-b26d-4a0c-d4ae-08da7aca624f | Pengelly             | MBA            |
+| 2   | Mac    | 99ca3e98-b26d-4a0c-d4ae-08da7aca624f | Pengelly             | Preschool      |
+| 8   | Baxter | 5dc5019e-6f72-454b-d4b0-08da7aca624f | Bothell Pet Hospital | BSc            |
+
+**Dogs table**
+
+| Id  | Name  | FoodId                               | Vet      | FavoriteToy  |
+|:----|:------|:-------------------------------------|:---------|:-------------|
+| 3   | Toast | 011aaf6f-d588-4fad-d4ac-08da7aca624f | Pengelly | Mr. Squirrel |
+
+**FarmAnimals table**
+
+| Id  | Name  | FoodId                               | Value  | Species                |
+|:----|:------|:-------------------------------------|:-------|:-----------------------|
+| 4   | Clyde | 1d495075-f527-4498-d4af-08da7aca624f | 100.00 | Equus africanus asinus |
+
+**Humans table**
+
+| Id  | Name   | FoodId                               | FavoriteAnimalId      |
+|:----|:-------|:-------------------------------------|:----------------------|
+| 5   | Wendy  | 5418fd81-7660-432f-d4b1-08da7aca624f | 2                     |
+| 6   | Arthur | 59b495d4-0414-46bf-d4ad-08da7aca624f | 1                     |
+| 9   | Katie  | null                                 | 8                     |
+
+Notice that, unlike with TPT mapping, all the information for a single object is contained in a single table. And, unlike with TPH mapping, there is no combination of column and row in any table where that is never used by the model. We'll see below how these characteristics can be important for queries and storage.
+
+### Configuring TPC inheritance
+
+All types in an inheritance hierarchy must be explicitly included in the model when mapping the hierarchy with EF Core. This can be done by creating `DbSet` properties on your `DbContext` for every type:
+
+<!--
+        public DbSet<Animal> Animals => Set<Animal>();
+        public DbSet<Pet> Pets => Set<Pet>();
+        public DbSet<FarmAnimal> FarmAnimals => Set<FarmAnimal>();
+        public DbSet<Cat> Cats => Set<Cat>();
+        public DbSet<Dog> Dogs => Set<Dog>();
+        public DbSet<Human> Humans => Set<Human>();
+-->
+[!code-csharp[AnimalSets](../../../../samples/core/Miscellaneous/NewInEFCore7/TpcInheritanceSample.cs?name=AnimalSets)]
+
+Or by using the `Entity` method in `OnModelCreating`:
+
+<!--
+            modelBuilder.Entity<Animal>();
+            modelBuilder.Entity<Pet>();
+            modelBuilder.Entity<Cat>();
+            modelBuilder.Entity<Dog>();
+            modelBuilder.Entity<FarmAnimal>();
+            modelBuilder.Entity<Human>();
+-->
+[!code-csharp[AnimalsInModelBuilder](../../../../samples/core/Miscellaneous/NewInEFCore7/TpcInheritanceSample.cs?name=AnimalsInModelBuilder)]
+
+> [!IMPORTANT]
+> This is different from the legacy EF6 behavior, where derived types of mapped base types would be automatically discovered if they were contained in the same assembly.
+
+Nothing else needs to be done to map the hierarchy as TPH, since it is the default strategy. However, starting with EF7, TPH can be made explicit by calling `UseTphMappingStrategy` on the base type of the hierarchy:
+
+<!--
+            modelBuilder.Entity<Animal>().UseTphMappingStrategy();
+-->
+[!code-csharp[UseTphMappingStrategy](../../../../samples/core/Miscellaneous/NewInEFCore7/TpcInheritanceSample.cs?name=UseTphMappingStrategy)]
+
+To use TPT instead, change this to `UseTptMappingStrategy`:
+
+<!--
+            modelBuilder.Entity<Animal>().UseTptMappingStrategy();
+-->
+[!code-csharp[UseTptMappingStrategy](../../../../samples/core/Miscellaneous/NewInEFCore7/TpcInheritanceSample.cs?name=UseTptMappingStrategy)]
+
+Likewise, `UseTpcMappingStrategy` is used to configure TPC:
+
+<!--
+            modelBuilder.Entity<Animal>().UseTpcMappingStrategy();
+-->
+[!code-csharp[UseTpcMappingStrategy](../../../../samples/core/Miscellaneous/NewInEFCore7/TpcInheritanceSample.cs?name=UseTpcMappingStrategy)]
+
+In each case, the table name used for each type is taken from the `DbSet` property name on your `DbContext`, or [can be configured](xref:core/modeling/entity-types#table-name) using the `ToTable` builder method, or the `[Table]` attribute.
+
+### TPC query performance
+
+For queries, the TPC strategy is an improvement over TPT because it ensures that the information for a given entity instance is always stored in a single table. This means the TPC strategy can be useful when the mapped hierarchy is large and has many concrete (usually leaf) types, each with a large number of properties, and where only a small subset of types are used in most queries.
+
+The SQL generated for three simple LINQ queries can be used to observe where TPC does well when compared to TPH and TPT. These queries are:
+
+1. A query that returns entities of all types in the hierarchy:
+
+   ```csharp
+   context.Animals.ToList();
+   ```
+
+2. A query that returns entities from a subset of types in the hierarchy:
+
+   ```csharp
+   context.Pets.ToList();
+   ```
+
+3. A query that returns only entities from a single leaf type in the hierarchy:
+
+   ```csharp
+   context.Cats.ToList();
+   ```
+
+#### TPH queries
+
+When using TPH, all three queries only query a single table, but with different filters on the discriminator column:
+
+1. TPH SQL returning entities of all types in the hierarchy:
+
+   ```sql
+   SELECT [a].[Id], [a].[Discriminator], [a].[FoodId], [a].[Name], [a].[Species], [a].[Value], [a].[FavoriteAnimalId], [a].[Vet], [a].[EducationLevel], [a].[FavoriteToy]
+   FROM [Animals] AS [a]
+   ```
+
+2. TPH SQL returning entities from a subset of types in the hierarchy:
+
+   ```sql
+   SELECT [a].[Id], [a].[Discriminator], [a].[FoodId], [a].[Name], [a].[Vet], [a].[EducationLevel], [a].[FavoriteToy]
+   FROM [Animals] AS [a]
+   WHERE [a].[Discriminator] IN (N'Cat', N'Dog')
+   ```
+
+3. TPH SQL returning only entities from a single leaf type in the hierarchy:
+
+   ```sql
+   SELECT [a].[Id], [a].[Discriminator], [a].[FoodId], [a].[Name], [a].[Vet], [a].[EducationLevel]
+   FROM [Animals] AS [a]
+   WHERE [a].[Discriminator] = N'Cat'
+   ```
+
+All these queries should perform well, especially with an appropriate database index on the discriminator column.
+
+#### TPT queries
+
+When using TPT, all of these queries require joining multiple tables, since the data for any given concrete type is split across many tables:
+
+1. TPT SQL returning entities of all types in the hierarchy:
+
+   ```sql
+   SELECT [a].[Id], [a].[FoodId], [a].[Name], [f].[Species], [f].[Value], [h].[FavoriteAnimalId], [p].[Vet], [c].[EducationLevel], [d].[FavoriteToy], CASE
+       WHEN [d].[Id] IS NOT NULL THEN N'Dog'
+       WHEN [c].[Id] IS NOT NULL THEN N'Cat'
+       WHEN [h].[Id] IS NOT NULL THEN N'Human'
+       WHEN [f].[Id] IS NOT NULL THEN N'FarmAnimal'
+   END AS [Discriminator]
+   FROM [Animals] AS [a]
+   LEFT JOIN [FarmAnimals] AS [f] ON [a].[Id] = [f].[Id]
+   LEFT JOIN [Humans] AS [h] ON [a].[Id] = [h].[Id]
+   LEFT JOIN [Pets] AS [p] ON [a].[Id] = [p].[Id]
+   LEFT JOIN [Cats] AS [c] ON [a].[Id] = [c].[Id]
+   LEFT JOIN [Dogs] AS [d] ON [a].[Id] = [d].[Id]
+   ```
+
+2. TPT SQL returning entities from a subset of types in the hierarchy:
+
+   ```sql
+   SELECT [a].[Id], [a].[FoodId], [a].[Name], [p].[Vet], [c].[EducationLevel], [d].[FavoriteToy], CASE
+       WHEN [d].[Id] IS NOT NULL THEN N'Dog'
+       WHEN [c].[Id] IS NOT NULL THEN N'Cat'
+   END AS [Discriminator]
+   FROM [Animals] AS [a]
+   INNER JOIN [Pets] AS [p] ON [a].[Id] = [p].[Id]
+   LEFT JOIN [Cats] AS [c] ON [a].[Id] = [c].[Id]
+   LEFT JOIN [Dogs] AS [d] ON [a].[Id] = [d].[Id]
+   ```
+
+3. TPT SQL returning only entities from a single leaf type in the hierarchy:
+
+   ```sql
+   SELECT [a].[Id], [a].[FoodId], [a].[Name], [p].[Vet], [c].[EducationLevel]
+   FROM [Animals] AS [a]
+   INNER JOIN [Pets] AS [p] ON [a].[Id] = [p].[Id]
+   INNER JOIN [Cats] AS [c] ON [a].[Id] = [c].[Id]
+   ```
+
+> [!NOTE]
+> EF Core uses “discriminator synthesis” to determine which table the data comes from, and hence the correct type to use. This works because the LEFT JOIN returns nulls for the dependent ID column (the “sub-tables”) which aren’t the correct type. So for a dog, `[d].[Id]` will be non-null, and all the other (concrete) IDs will be null.
+
+All of these queries can suffer from performance issues due to the table joins. This is why TPT is never a good choice for query performance.
+
+#### TPC queries
+
+TPC improves over TPT for all of these queries because the number of tables that need to be queried is reduced. In addition, the results from each table are combined using `UNION ALL`, which can be considerably faster than a table join, since it does not need to perform any matching between rows or de-duplication of rows.
+
+1. TPC SQL returning entities of all types in the hierarchy:
+
+   ```sql
+   SELECT [f].[Id], [f].[FoodId], [f].[Name], [f].[Species], [f].[Value], NULL AS [FavoriteAnimalId], NULL AS [Vet], NULL AS [EducationLevel], NULL AS [FavoriteToy], N'FarmAnimal' AS [Discriminator]
+   FROM [FarmAnimals] AS [f]
+   UNION ALL
+   SELECT [h].[Id], [h].[FoodId], [h].[Name], NULL AS [Species], NULL AS [Value], [h].[FavoriteAnimalId], NULL AS [Vet], NULL AS [EducationLevel], NULL AS [FavoriteToy], N'Human' AS [Discriminator]
+   FROM [Humans] AS [h]
+   UNION ALL
+   SELECT [c].[Id], [c].[FoodId], [c].[Name], NULL AS [Species], NULL AS [Value], NULL AS [FavoriteAnimalId], [c].[Vet], [c].[EducationLevel], NULL AS [FavoriteToy], N'Cat' AS [Discriminator]
+   FROM [Cats] AS [c]
+   UNION ALL
+   SELECT [d].[Id], [d].[FoodId], [d].[Name], NULL AS [Species], NULL AS [Value], NULL AS [FavoriteAnimalId], [d].[Vet], NULL AS [EducationLevel], [d].[FavoriteToy], N'Dog' AS [Discriminator]
+   FROM [Dogs] AS [d]
+   ```
+
+2. TPC SQL returning entities from a subset of types in the hierarchy:
+
+   ```sql
+   SELECT [c].[Id], [c].[FoodId], [c].[Name], [c].[Vet], [c].[EducationLevel], NULL AS [FavoriteToy], N'Cat' AS [Discriminator]
+   FROM [Cats] AS [c]
+   UNION ALL
+   SELECT [d].[Id], [d].[FoodId], [d].[Name], [d].[Vet], NULL AS [EducationLevel], [d].[FavoriteToy], N'Dog' AS [Discriminator]
+   FROM [Dogs] AS [d]
+   ```
+
+3. TPC SQL returning only entities from a single leaf type in the hierarchy:
+
+   ```sql
+   SELECT [c].[Id], [c].[FoodId], [c].[Name], [c].[Vet], [c].[EducationLevel]
+   FROM [Cats] AS [c]
+   ```
+
+Even though TPC is better than TPT for all of these queries, the TPH queries are still better when returning instances of multiple types. This is one of the reasons that TPH is the default strategy used by EF Core.
+
+As the SQL for query #3 shows, TPC really excels when querying for entities of a single leaf type. The query only uses a single table and needs no filtering.
+
+### TPC inserts and updates
+
+TPC also performs well when saving a new entity, since this requires inserting only a single row into a single table. This is also true for TPH. With TPT, rows must be inserted into many tables, which will perform less well.
+
+The same is often true for updates, although in this case if all columns being updated are in the same table, even for TPT, then the difference may not be significant.
+
+### Space considerations
+
+Both TPT and TPC can use less storage than TPH when there are many subtypes with many properties that are often not used. This is because every row in the TPH table must store a `NULL` for each of these unused properties. In practice, this is rarely an issue, but it could be worth considering when storing large amounts of data with these characteristics.
+
+> [!TIP]
+> If your database system supports it (e.g. SQL Server), then consider using "sparse columns" for TPH columns that will be rarely populated.
+
+### Key generation
+
+The inheritance mapping strategy chosen has consequences for how primary key values are generated and managed. Keys in TPH are easy since each entity instance is represented by a single row in a single table. Any kind of key value generation can be used, and no additional constraints are needed.
+
+For the TPT strategy, there is always a row in the table mapped to the base type of the hierarchy. Any kind of key generation can be used on this row, and the keys for other tables are linked to this table using foreign key constraints.
+
+Things get a bit more complicated for TPC. First, it’s important to understand that EF Core requires that all entities in a hierarchy must have a unique key value, even if the entities have different types. So, using our example model, a Dog cannot have the same Id key value as a Cat. Second, unlike TPT, there is no common table that can act as the single place where key values live and can be generated. This means a simple `Identity` column cannot be used.
+
+For databases that support sequences, key values can be generated by using a single sequence referenced in the default constraint for each table. This is the strategy used in the TPC tables shown above, where each table has the following:
+
+```sql
+[Id] int NOT NULL DEFAULT (NEXT VALUE FOR [AnimalSequence])
+```
+
+`AnimalSequence` is a database sequence created by EF Core. This strategy is used by default for TPC hierarchies when using the EF Core database provider for SQL Server. Database providers for other databases that support sequences should have a similar default. Other key generation strategies that use sequences, such as Hi-Lo patterns, may also be used with TPC.
+
+While standard Identity columns will not work with TPC, it is possible to use Identity columns if each table is configured with an appropriate seed and increment such that the values generated for each table will never conflict. For example:
+
+<!--
+            modelBuilder.Entity<Cat>().ToTable("Cats", tb => tb.Property(e => e.Id).UseIdentityColumn(1, 4));
+            modelBuilder.Entity<Dog>().ToTable("Dogs", tb => tb.Property(e => e.Id).UseIdentityColumn(2, 4));
+            modelBuilder.Entity<FarmAnimal>().ToTable("FarmAnimals", tb => tb.Property(e => e.Id).UseIdentityColumn(3, 4));
+            modelBuilder.Entity<Human>().ToTable("Humans", tb => tb.Property(e => e.Id).UseIdentityColumn(4, 4));
+-->
+[!code-csharp[UsingIdentity](../../../../samples/core/Miscellaneous/NewInEFCore7/TpcInheritanceSample.cs?name=UsingIdentity)]
+
+SQLite does not support sequences or Identity seed/increment, and hence integer key value generation is not supported when using SQLite with the TPC strategy. However, client-side generation or globally unique keys--for example, GUID keys--are supported on any database, including SQLite.
+
+### Foreign key constraints
+
+The TPC mapping strategy creates a denormalized SQL schema--this is one reason why some database purists are against it. For example, consider the foreign key column `FavoriteAnimalId`. The value in this column must match the primary key value of some animal. This can be enforced in the database with a simple FK constraint when using TPH or TPT. For example:
+
+```sql
+CONSTRAINT [FK_Animals_Animals_FavoriteAnimalId] FOREIGN KEY ([FavoriteAnimalId]) REFERENCES [Animals] ([Id])
+```
+
+But when using TPC, the primary key for an animal is stored in the table for the concrete type of that animal. For example, a cat's primary key is stored in the `Cats.Id` column, while a dog's primary key is stored in the `Dogs.Id` column, and so on. This means an FK constraint cannot be created for this relationship.
+
+In practice, this is not a problem as long as the application does not attempt to insert invalid data. For example, if all the data is inserted by EF Core and uses navigations to relate entities, then it is guaranteed that the FK column will contain valid PK value at all times.
+
+### Summary and guidance
+
+In summary, TPC is a good mapping strategy to use when your code will mostly query for entities of a single leaf type. This is because the storage requirements are smaller, and there is no discriminator column that may need an index. Inserts and updates are also efficient.
+
+That being said, TPH is usually fine for most applications, and is a good default for a wide range of scenarios, so don't add the complexity of TPC if you don't need it. Specifically, if your code will mostly query for entities of many types, such as writing queries against the base type, then lean towards TPH over TPC.
+
+Use TPT only if constrained to do so by external factors.
+
+## Custom Reverse Engineering Templates
+
+You can now customize the scaffolded code when reverse engineering an EF model from a database. Get started by adding the default templates to your project:
+
+```dotnetcli
+dotnet new install Microsoft.EntityFrameworkCore.Templates
+dotnet new ef-templates
+```
+
+The templates can then be customize and will automatically be used by `dotnet ef dbcontext scaffold` and `Scaffold-DbContext`.
+
+For more details, see [Custom Reverse Engineering Templates](xref:core/managing-schemas/scaffolding/templates).
+
+> [!TIP]
+> The EF Team demonstrated and talked in depth about reverse engineering templates in an episode of the .NET Data Community Standup. As with [all Community Standup episodes](https://aka.ms/efstandups), you can [watch the T4 templates episode now on YouTube](https://youtu.be/x2nh1vZBsHE).
+
+## Model building conventions
+
+EF Core uses a metadata "model" to describe how the application's entity types are mapped to the underlying database. This model is built using a set of around 60 "conventions". The model built by conventions can then be customized using [mapping attributes (aka "data annotations")](xref:core/modeling/index#use-data-annotations-to-configure-a-model) and/or calls to the [`DbModelBuilder` API in `OnModelCreating`](xref:core/modeling/index#use-fluent-api-to-configure-a-model).
+
+Starting with EF7, applications can now remove or replace any of these conventions, as well as add new conventions. Model building conventions are a powerful way to control the model configuration, but can be complex and hard to get right. In many cases, the existing [pre-convention model configuration](xref:core/modeling/bulk-configuration) can be used instead to easily specify a common configuration for properties and types.
+
+Changes to the conventions used by a `DbContext` are made by overriding the `DbContext.ConfigureConventions` method. For example:
+
+```csharp
+protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+{
+    configurationBuilder.Conventions.Remove(typeof(ForeignKeyIndexConvention));
+}
+```
+
+> [!TIP]
+> To find all built-in model building conventions, look for every class that implements the <xref:Microsoft.EntityFrameworkCore.Metadata.Conventions.IConvention> interface.
+
+> [!TIP]
+> The code shown here comes from [ModelBuildingConventionsSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore7/ModelBuildingConventionsSample.cs).
+
+### Removing an existing convention
+
+Sometimes one of the built-in conventions may not be appropriate for your application, in which case it can be removed.
+
+#### Example: Don't create indexes for foreign key columns
+
+It usually makes sense to create indexes for foreign key (FK) columns, and hence there is a built-in convention for this: <xref:Microsoft.EntityFrameworkCore.Metadata.Conventions.ForeignKeyIndexConvention>. Looking at the model [debug view](xref:core/modeling/index#debug-view) for a `Post` entity type with relationships to `Blog` and `Author`, we can see two indexes are created--one for the `BlogId` FK, and the other for the `AuthorId` FK.
+
+```text
+  EntityType: Post
+    Properties:
+      Id (int) Required PK AfterSave:Throw ValueGenerated.OnAdd
+      AuthorId (no field, int?) Shadow FK Index
+      BlogId (no field, int) Shadow Required FK Index
+    Navigations:
+      Author (Author) ToPrincipal Author Inverse: Posts
+      Blog (Blog) ToPrincipal Blog Inverse: Posts
+    Keys:
+      Id PK
+    Foreign keys:
+      Post {'AuthorId'} -> Author {'Id'} ToDependent: Posts ToPrincipal: Author ClientSetNull
+      Post {'BlogId'} -> Blog {'Id'} ToDependent: Posts ToPrincipal: Blog Cascade
+    Indexes:
+      AuthorId
+      BlogId
+```
+
+However, indexes have overhead, and, [as asked here](https://github.com/dotnet/efcore/issues/10855), it may not always be appropriate to create them for all FK columns. To achieve this, the `ForeignKeyIndexConvention` can be removed when building the model:
+
+```csharp
+protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+{
+    configurationBuilder.Conventions.Remove(typeof(ForeignKeyIndexConvention));
+}
+```
+
+Looking at the debug view of the model for `Post` now, we see that the indexes on FKs have not been created:
+
+```text
+  EntityType: Post
+    Properties:
+      Id (int) Required PK AfterSave:Throw ValueGenerated.OnAdd
+      AuthorId (no field, int?) Shadow FK
+      BlogId (no field, int) Shadow Required FK
+    Navigations:
+      Author (Author) ToPrincipal Author Inverse: Posts
+      Blog (Blog) ToPrincipal Blog Inverse: Posts
+    Keys:
+      Id PK
+    Foreign keys:
+      Post {'AuthorId'} -> Author {'Id'} ToDependent: Posts ToPrincipal: Author ClientSetNull
+      Post {'BlogId'} -> Blog {'Id'} ToDependent: Posts ToPrincipal: Blog Cascade
+```
+
+When desired, indexes can still be explicitly created for foreign key columns, either using the <xref:Microsoft.EntityFrameworkCore.IndexAttribute>:
+
+```csharp
+[Index("BlogId")]
+public class Post
+{
+    // ...
+}
+```
+
+Or with configuration in `OnModelCreating`:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<Post>(entityTypeBuilder => entityTypeBuilder.HasIndex("BlogId"));
+}
+```
+
+Looking at the `Post` entity type again, it now contains the `BlogId` index, but not the `AuthorId` index:
+
+```text
+  EntityType: Post
+    Properties:
+      Id (int) Required PK AfterSave:Throw ValueGenerated.OnAdd
+      AuthorId (no field, int?) Shadow FK
+      BlogId (no field, int) Shadow Required FK Index
+    Navigations:
+      Author (Author) ToPrincipal Author Inverse: Posts
+      Blog (Blog) ToPrincipal Blog Inverse: Posts
+    Keys:
+      Id PK
+    Foreign keys:
+      Post {'AuthorId'} -> Author {'Id'} ToDependent: Posts ToPrincipal: Author ClientSetNull
+      Post {'BlogId'} -> Blog {'Id'} ToDependent: Posts ToPrincipal: Blog Cascade
+    Indexes:
+      BlogId
+```
+
+> [!TIP]
+> If your model doesn't use mapping attributes (aka data annotations) for configuration, then all conventions ending in `AttributeConvention` can be safely removed to speed up model building.
+
+### Adding a new convention
+
+Removing existing conventions is a start, but what about adding completely new model building conventions? EF7 supports this as well!
+
+#### Example: Constrain length of discriminator properties
+
+The [table-per-hierarchy inheritance mapping strategy](xref:core/modeling/inheritance) requires a discriminator column to specify which type is represented in any given row. By default, EF uses an unbounded string column for the discriminator, which ensures that it will work for any discriminator length. However, constraining the maximum length of discriminator strings can make for more efficient storage and queries. Let's create a new convention that will do that.
+
+EF Core model building conventions are triggered based on changes being made to the model as it is being built. This keeps the model up-to-date as explicit configuration is made, mapping attributes are applied, and other conventions run. To participate in this, every convention implements one or more interfaces which determine when the convention will be triggered. For example, a convention that implements <xref:Microsoft.EntityFrameworkCore.Metadata.Conventions.IEntityTypeAddedConvention> will be triggered whenever a new entity type is added to the model. Likewise, a convention that implements both <xref:Microsoft.EntityFrameworkCore.Metadata.Conventions.IForeignKeyAddedConvention> and <xref:Microsoft.EntityFrameworkCore.Metadata.Conventions.IKeyAddedConvention> will be triggered whenever either a key or a foreign key is added to the model.
+
+Knowing which interfaces to implement can be tricky, since configuration made to the model at one point may be changed or removed at a later point. For example, a key may be created by convention, but then later replaced when a different key is configured explicitly.
+
+Let's make this a bit more concrete by making a first attempt at implementing the discriminator-length convention:
+
+<!--
+public class DiscriminatorLengthConvention1 : IEntityTypeBaseTypeChangedConvention
+{
+    public void ProcessEntityTypeBaseTypeChanged(
+        IConventionEntityTypeBuilder entityTypeBuilder,
+        IConventionEntityType? newBaseType,
+        IConventionEntityType? oldBaseType,
+        IConventionContext<IConventionEntityType> context)
+    {
+        var discriminatorProperty = entityTypeBuilder.Metadata.FindDiscriminatorProperty();
+        if (discriminatorProperty != null
+            && discriminatorProperty.ClrType == typeof(string))
+        {
+            discriminatorProperty.Builder.HasMaxLength(24);
+        }
+    }
+}
+-->
+[!code-csharp[DiscriminatorLengthConvention1](../../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingConventionsSample.cs?name=DiscriminatorLengthConvention1)]
+
+This convention implements <xref:Microsoft.EntityFrameworkCore.Metadata.Conventions.IEntityTypeBaseTypeChangedConvention>, which means it will be triggered whenever the mapped inheritance hierarchy for an entity type is changed. The convention then finds and configures the string discriminator property for the hierarchy.
+
+This convention is then used by calling `Add` in `ConfigureConventions`:
+
+```csharp
+protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+{
+    configurationBuilder.Conventions.Add(_ =>  new DiscriminatorLengthConvention1());
+}
+```
+
+> [!TIP]
+> Rather than adding an instance of the convention directly, the `Add` method accepts a factory for creating instances of the convention. This allows the convention to use dependencies from the EF Core internal service provider. Since this convention has no dependencies, the service provider parameter is named `_`, indicating that it is never used.
+
+Building the model and looking at the `Post` entity type shows that this has worked--the discriminator property is now configured to with a maximum length of 24:
+
+```text
+ Discriminator (no field, string) Shadow Required AfterSave:Throw MaxLength(24)
+```
+
+But what happens if we now explicitly configure a different discriminator property? For example:
+
+```csharp
+modelBuilder.Entity<Post>()
+    .HasDiscriminator<string>("PostTypeDiscriminator")
+    .HasValue<Post>("Post")
+    .HasValue<FeaturedPost>("Featured");
+```
+
+Looking at the debug view of the model, we find that the discriminator length is no longer configured!
+
+```text
+ PostTypeDiscriminator (no field, string) Shadow Required AfterSave:Throw
+```
+
+This is because the discriminator property that we configured in our convention was later removed when the custom discriminator was added. We could attempt to fix this by implementing another interface on our convention to react to the discriminator changes, but figuring out which interface to implement is not easy.
+
+Fortunately, there is a different way to approach this that makes things much easier. A lot of the time, it doesn't matter what the model looks like while it is being built, as long as the final model is correct. In addition, the configuration we want to apply often does not need to trigger other conventions to react. Therefore, our convention can implement <xref:Microsoft.EntityFrameworkCore.Metadata.Conventions.IModelFinalizingConvention>. Model finalizing conventions run after all other model building is complete, and so have access to the final state of the model. A model finalizing convention will typically iterate over the entire model configuring model elements as it goes. So, in this case, we will find every discriminator in the model and configure it:
+
+<!--
+public class DiscriminatorLengthConvention2 : IModelFinalizingConvention
+{
+    public void ProcessModelFinalizing(IConventionModelBuilder modelBuilder, IConventionContext<IConventionModelBuilder> context)
+    {
+        foreach (var entityType in modelBuilder.Metadata.GetEntityTypes()
+                     .Where(entityType => entityType.BaseType == null))
+        {
+            var discriminatorProperty = entityType.FindDiscriminatorProperty();
+            if (discriminatorProperty != null
+                && discriminatorProperty.ClrType == typeof(string))
+            {
+                discriminatorProperty.Builder.HasMaxLength(24);
+            }
+        }
+    }
+}
+-->
+[!code-csharp[DiscriminatorLengthConvention2](../../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingConventionsSample.cs?name=DiscriminatorLengthConvention2)]
+
+After building the model with this new convention, we find that the discriminator length is now configured correctly even though it has been customized:
+
+```text
+PostTypeDiscriminator (no field, string) Shadow Required AfterSave:Throw MaxLength(24)
+```
+
+Just for fun, let's go one step further and configure the max length to be the length of the longest discriminator value.
+
+<!--
+public class DiscriminatorLengthConvention3 : IModelFinalizingConvention
+{
+    public void ProcessModelFinalizing(IConventionModelBuilder modelBuilder, IConventionContext<IConventionModelBuilder> context)
+    {
+        foreach (var entityType in modelBuilder.Metadata.GetEntityTypes()
+                     .Where(entityType => entityType.BaseType == null))
+        {
+            var discriminatorProperty = entityType.FindDiscriminatorProperty();
+            if (discriminatorProperty != null
+                && discriminatorProperty.ClrType == typeof(string))
+            {
+                var maxDiscriminatorValueLength =
+                    entityType.GetDerivedTypesInclusive().Select(e => ((string)e.GetDiscriminatorValue()!).Length).Max();
+
+                discriminatorProperty.Builder.HasMaxLength(maxDiscriminatorValueLength);
+            }
+        }
+    }
+}
+-->
+[!code-csharp[DiscriminatorLengthConvention3](../../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingConventionsSample.cs?name=DiscriminatorLengthConvention3)]
+
+Now the discriminator column max length is 8, which is the length of "Featured", the longest discriminator value in use.
+
+```text
+PostTypeDiscriminator (no field, string) Shadow Required AfterSave:Throw MaxLength(8)
+```
+
+> [!TIP]
+> You might be wondering if the convention should also create an index for the discriminator column. There is [a discussion about this on GitHub](https://github.com/dotnet/efcore/issues/4030). The short answer is that sometimes an index might be useful, but most of the time it probably won't be. Therefore, it's best to create appropriate indexes here as needed, rather than have a convention to do it always. But if you disagree with this, then the convention above can easily be modified to create an index as well.
+
+#### Example: Default length for all string properties
+
+Let's look at another example where a finalizing convention can be used--this time, setting a default maximum length for _any_ string property, as [asked for on GitHub](https://github.com/dotnet/EntityFramework.Docs/issues/3756 ). The convention looks quite similar to the previous example:
+
+<!--
+public class MaxStringLengthConvention : IModelFinalizingConvention
+{
+    public void ProcessModelFinalizing(IConventionModelBuilder modelBuilder, IConventionContext<IConventionModelBuilder> context)
+    {
+        foreach (var property in modelBuilder.Metadata.GetEntityTypes()
+                     .SelectMany(
+                         entityType => entityType.GetDeclaredProperties()
+                             .Where(
+                                 property => property.ClrType == typeof(string))))
+        {
+            property.Builder.HasMaxLength(512);
+        }
+    }
+}
+-->
+[!code-csharp[MaxStringLengthConvention](../../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingConventionsSample.cs?name=MaxStringLengthConvention)]
+
+This convention is pretty simple. It finds every string property in the model and sets its max length to 512. Looking in the debug view at the properties for `Post`, we see that all the string properties now have a max length of 512.
+
+```text
+EntityType: Post
+  Properties:
+    Id (int) Required PK AfterSave:Throw ValueGenerated.OnAdd
+    AuthorId (no field, int?) Shadow FK Index
+    BlogId (no field, int) Shadow Required FK Index
+    Content (string) Required MaxLength(512)
+    Discriminator (no field, string) Shadow Required AfterSave:Throw MaxLength(512)
+    PublishedOn (DateTime) Required
+    Title (string) Required MaxLength(512)
+```
+
+But the `Content` property should probably allow more than 512 characters, or all our posts will be pretty short! This can be done without changing our convention by explicitly configuring the max length for just this property, either using a mapping attribute:
+
+```csharp
+[MaxLength(4000)]
+public string Content { get; set; }
+```
+
+Or with code in `OnModelCreating`:
+
+```csharp
+modelBuilder.Entity<Post>()
+    .Property(post => post.Content)
+    .HasMaxLength(4000);
+```
+
+Now all properties have a max length of 512, except `Content` which was explicitly configured with 4000:
+
+```text
+EntityType: Post
+  Properties:
+    Id (int) Required PK AfterSave:Throw ValueGenerated.OnAdd
+    AuthorId (no field, int?) Shadow FK Index
+    BlogId (no field, int) Shadow Required FK Index
+    Content (string) Required MaxLength(4000)
+    Discriminator (no field, string) Shadow Required AfterSave:Throw MaxLength(512)
+    PublishedOn (DateTime) Required
+    Title (string) Required MaxLength(512)
+```
+
+So why didn't our convention override the explicitly configured max length? The answer is that EF Core keeps track of how every piece of configuration was made. This is represented by the <xref:Microsoft.EntityFrameworkCore.Metadata.ConfigurationSource> enum. The different kinds of configuration are:
+
+- `Explicit`: The model element was explicitly configured in `OnModelCreating`
+- `DataAnnotation`: The model element was configured using a mapping attribute (aka data annotation) on the CLR type
+- `Convention`: The model element was configured by a model building convention
+
+Conventions never override configuration marked as `DataAnnotation` or `Explicit`. This is achieved by using a "convention builder", for example, the <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.IConventionPropertyBuilder>, which is obtained from the <xref:Microsoft.EntityFrameworkCore.Metadata.IConventionProperty.Builder> property. For example:
+
+```csharp
+property.Builder.HasMaxLength(512);
+```
+
+Calling `HasMaxLength` on the convention builder will only set the max length _if it was not already configured by a mapping attribute or in `OnModelCreating`_.
+
+Builder methods like this also have a second parameter: `fromDataAnnotation`. Set this to `true` if the convention is making the configuration on behalf of a mapping attribute. For example:
+
+```csharp
+property.Builder.HasMaxLength(512, fromDataAnnotation: true);
+```
+
+This sets the `ConfigurationSource` to `DataAnnotation`, which means that the value can now be overridden by explicit mapping on `OnModelCreating`, but not by non-mapping attribute conventions.
+
+Finally, before we leave this example, what happens if we use both the `MaxStringLengthConvention` and `DiscriminatorLengthConvention3` at the same time? The answer is that it depends on which order they are added, since model finalizing conventions run in the order they are added. So if `MaxStringLengthConvention` is added last, then it will run last, and it will set the max length of the discriminator property to 512. Therefore, in this case, it is better to add `DiscriminatorLengthConvention3` last so that it can override the default max length for just discriminator properties, while leaving all other string properties as 512.
+
+### Replacing an existing convention
+
+Sometimes rather than removing an existing convention completely we instead want to replace it with a convention that does basically the same thing, but with changed behavior. This is useful because the existing convention will already implement the interfaces it needs so as to be triggered appropriately.
+
+#### Example: Opt-in property mapping
+
+EF Core maps all public read-write properties by convention. This [might not be appropriate](https://github.com/dotnet/efcore/issues/16009) for the way your entity types are defined. To change this, we can replace the `PropertyDiscoveryConvention` with our own implementation that doesn't map any property unless it is explicitly mapped in `OnModelCreating` or marked with a new attribute called `Persist`:
+
+<!--
+[AttributeUsage(AttributeTargets.Property | AttributeTargets.Field)]
+public sealed class PersistAttribute : Attribute
+{
+}
+-->
+[!code-csharp[PersistAttribute](../../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingConventionsSample.cs?name=PersistAttribute)]
+
+Here is the new convention:
+
+<!--
+public class AttributeBasedPropertyDiscoveryConvention : PropertyDiscoveryConvention
+{
+    public AttributeBasedPropertyDiscoveryConvention(ProviderConventionSetBuilderDependencies dependencies)
+        : base(dependencies)
+    {
+    }
+
+    public override void ProcessEntityTypeAdded(
+        IConventionEntityTypeBuilder entityTypeBuilder,
+        IConventionContext<IConventionEntityTypeBuilder> context)
+        => Process(entityTypeBuilder);
+
+    public override void ProcessEntityTypeBaseTypeChanged(
+        IConventionEntityTypeBuilder entityTypeBuilder,
+        IConventionEntityType? newBaseType,
+        IConventionEntityType? oldBaseType,
+        IConventionContext<IConventionEntityType> context)
+    {
+        if ((newBaseType == null
+             || oldBaseType != null)
+            && entityTypeBuilder.Metadata.BaseType == newBaseType)
+        {
+            Process(entityTypeBuilder);
+        }
+    }
+
+    private void Process(IConventionEntityTypeBuilder entityTypeBuilder)
+    {
+        foreach (var memberInfo in GetRuntimeMembers())
+        {
+            if (Attribute.IsDefined(memberInfo, typeof(PersistAttribute), inherit: true))
+            {
+                entityTypeBuilder.Property(memberInfo);
+            }
+            else if (memberInfo is PropertyInfo propertyInfo
+                     && Dependencies.TypeMappingSource.FindMapping(propertyInfo) != null)
+            {
+                entityTypeBuilder.Ignore(propertyInfo.Name);
+            }
+        }
+
+        IEnumerable<MemberInfo> GetRuntimeMembers()
+        {
+            var clrType = entityTypeBuilder.Metadata.ClrType;
+
+            foreach (var property in clrType.GetRuntimeProperties()
+                         .Where(p => p.GetMethod != null && !p.GetMethod.IsStatic))
+            {
+                yield return property;
+            }
+
+            foreach (var property in clrType.GetRuntimeFields())
+            {
+                yield return property;
+            }
+        }
+    }
+}
+-->
+[!code-csharp[AttributeBasedPropertyDiscoveryConvention](../../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingConventionsSample.cs?name=AttributeBasedPropertyDiscoveryConvention)]
+
+> [!TIP]
+> When replacing a built-in convention, the new convention implementation should inherit from the existing convention class. Note that some conventions have relational or provider-specific implementations, in which case the new convention implementation should inherit from the most specific existing convention class for the database provider in use.
+
+The convention is then registered using the `Replace` method in `ConfigureConventions`:
+
+<!--
+    protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+    {
+        configurationBuilder.Conventions.Replace<PropertyDiscoveryConvention>(
+            serviceProvider => new AttributeBasedPropertyDiscoveryConvention(
+                serviceProvider.GetRequiredService<ProviderConventionSetBuilderDependencies>()));
+    }
+-->
+[!code-csharp[ReplaceConvention](../../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingConventionsSample.cs?name=ReplaceConvention)]
+
+> [!TIP]
+> This is a case where the existing convention has dependencies, represented by the `ProviderConventionSetBuilderDependencies` dependency object. These are obtained from the internal service provider using `GetRequiredService` and passed to the convention constructor.
+
+This convention works by getting all readable properties and fields from the given entity type. If the member is attributed with `[Persist]`, then it is mapped by calling:
+
+```csharp
+entityTypeBuilder.Property(memberInfo);
+```
+
+On the other hand, if the member is a property that would otherwise have been mapped, then it is excluded from the model using:
+
+```csharp
+entityTypeBuilder.Ignore(propertyInfo.Name);
+```
+
+Notice that this convention allows fields to be mapped (in addition to properties) so long as they are marked with `[Persist]`. This means we can use private fields as hidden keys in the model.
+
+For example, consider the following entity types:
+
+<!--
+public class LaundryBasket
+{
+    [Persist] [Key]
+    private readonly int _id;
+
+    [Persist]
+    public int TenantId { get; init; }
+
+    public bool IsClean { get; set; }
+
+    public List<Garment> Garments { get; } = new();
+}
+
+public class Garment
+{
+    public Garment(string name, string color)
+    {
+        Name = name;
+        Color = color;
+    }
+
+    [Persist]
+    [Key]
+    private readonly int _id;
+
+    [Persist]
+    public int TenantId { get; init; }
+
+    [Persist]
+    public string Name { get; }
+
+    [Persist]
+    public string Color { get; }
+
+    public bool IsClean { get; set; }
+
+    public LaundryBasket? Basket { get; set; }
+}
+-->
+[!code-csharp[LaundryBasket](../../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingConventionsSample.cs?name=LaundryBasket)]
+
+The model built from these entity types is:
+
+```text
+Model:
+  EntityType: Garment
+    Properties:
+      _id (_id, int) Required PK AfterSave:Throw ValueGenerated.OnAdd
+      Basket_id (no field, int?) Shadow FK Index
+      Color (string) Required
+      Name (string) Required
+      TenantId (int) Required
+    Navigations:
+      Basket (LaundryBasket) ToPrincipal LaundryBasket Inverse: Garments
+    Keys:
+      _id PK
+    Foreign keys:
+      Garment {'Basket_id'} -> LaundryBasket {'_id'} ToDependent: Garments ToPrincipal: Basket ClientSetNull
+    Indexes:
+      Basket_id
+  EntityType: LaundryBasket
+    Properties:
+      _id (_id, int) Required PK AfterSave:Throw ValueGenerated.OnAdd
+      TenantId (int) Required
+    Navigations:
+      Garments (List<Garment>) Collection ToDependent Garment Inverse: Basket
+    Keys:
+      _id PK
+```
+
+Notice that normally, `IsClean` would have been mapped, but since it is not marked with `[Persist]` (presumably because cleanliness is not a persistent property of laundry), it is now treated as an un-mapped property.
+
+> [!TIP]
+> This convention could not be implemented as a model finalizing convention because mapping a property triggers many other conventions to run to further configure the mapped property.
+
+## Stored procedure mapping
+
+By default, EF Core generates insert, update, and delete commands that work directly with tables or updatable views. EF7 introduces support for mapping of these commands to stored procedures.
+
+> [!TIP]
+> EF Core has always supported querying via stored procedures. The new support in EF7 is explicitly about using stored procedures for inserts, updates, and deletes.
+
+> [!IMPORTANT]
+> Support for stored procedure mapping does not imply that stored procedures are recommended.
+
+Stored procedures are mapped in `OnModelCreating` using `InsertUsingStoredProcedure`, `UpdateUsingStoredProcedure`, and `DeleteUsingStoredProcedure`. For example, to map stored procedures for a `Person` entity type:
+
+<!--
+            modelBuilder.Entity<Person>()
+                .InsertUsingStoredProcedure(
+                    "People_Insert",
+                    storedProcedureBuilder =>
+                    {
+                        storedProcedureBuilder.HasParameter(a => a.Name);
+                        storedProcedureBuilder.HasResultColumn(a => a.Id);
+                    })
+                .UpdateUsingStoredProcedure(
+                    "People_Update",
+                    storedProcedureBuilder =>
+                    {
+                        storedProcedureBuilder.HasOriginalValueParameter(person => person.Id);
+                        storedProcedureBuilder.HasOriginalValueParameter(person => person.Name);
+                        storedProcedureBuilder.HasParameter(person => person.Name);
+                        storedProcedureBuilder.HasRowsAffectedResultColumn();
+                    })
+                .DeleteUsingStoredProcedure(
+                    "People_Delete",
+                    storedProcedureBuilder =>
+                    {
+                        storedProcedureBuilder.HasOriginalValueParameter(person => person.Id);
+                        storedProcedureBuilder.HasOriginalValueParameter(person => person.Name);
+                        storedProcedureBuilder.HasRowsAffectedResultColumn();
+                    });
+-->
+[!code-csharp[PersonSprocs](../../../../samples/core/Miscellaneous/NewInEFCore7/DocumentsContext.cs?name=PersonSprocs)]
+
+This configuration maps to the following stored procedures when using SQL Server:
+
+**For inserts**
+
+```sql
+CREATE PROCEDURE [dbo].[People_Insert]
+    @Name [nvarchar](max)
+AS
+BEGIN
+      INSERT INTO [People] ([Name])
+      OUTPUT INSERTED.[Id]
+      VALUES (@Name);
+END
+```
+
+**For updates**
+
+```sql
+CREATE PROCEDURE [dbo].[People_Update]
+    @Id [int],
+    @Name_Original [nvarchar](max),
+    @Name [nvarchar](max)
+AS
+BEGIN
+    UPDATE [People] SET [Name] = @Name
+    WHERE [Id] = @Id AND [Name] = @Name_Original
+    SELECT @@ROWCOUNT
+END
+```
+
+**For deletes**
+
+```sql
+CREATE PROCEDURE [dbo].[People_Delete]
+    @Id [int],
+    @Name_Original [nvarchar](max)
+AS
+BEGIN
+    DELETE FROM [People]
+    OUTPUT 1
+    WHERE [Id] = @Id AND [Name] = @Name_Original;
+END
+```
+
+> [!TIP]
+> Stored procedures do not need to be used for every type in the model, or for all operations on a given type. For example, if only `DeleteUsingStoredProcedure` is specified for a given type, then EF Core will generate SQL as normal for insert and update operations and only use the stored procedure for deletes.
+
+The first argument passed to each method is the stored procedure name. This can be omitted, in which case EF Core will use the table name appended with "_Insert", "_Update", or "_Delete". So, in the example above, since the table is called "People", the stored procedure names can be removed with no change in functionality.
+
+The second argument is a builder used to configure the input and output of the stored procedure, including parameters, return values, and result columns.
+
+### Parameters
+
+Parameters must be added to the builder in the same order as they appear in the stored procedure definition.
+
+> [!NOTE]
+> Parameters can be named, but EF Core always calls stored procedures using positional arguments rather than named arguments. Vote for [Allow configuring sproc mapping to use parameter names for invocation](https://github.com/dotnet/efcore/issues/28439) if calling by name is something you are interested in.
+
+The first argument to each parameter builder method specifies the property in the model to which the parameter is bound. This can be a lambda expression:
+
+```csharp
+storedProcedureBuilder.HasParameter(a => a.Name);
+```
+
+Or a string, which is particularly useful when mapping [shadow properties](xref:core/modeling/shadow-properties):
+
+```csharp
+storedProcedureBuilder.HasParameter("Name");
+```
+
+Parameters are, by default, configured for "input". "Output" or "input/output" parameters can be configured using a nested builder. For example:
+
+```csharp
+storedProcedureBuilder.HasParameter(
+    document => document.RetrievedOn, 
+    parameterBuilder => parameterBuilder.IsOutput());
+```
+
+There are three different builder methods for different flavors of parameters:
+
+- `HasParameter` specifies a normal parameter bound to the current value of the given property.
+- `HasOriginalValueParameter` specifies a parameter bound to the original value of the given property. The original value is the value that the property had when it was queried from the database, if known. If this value is not known, then the current value is used instead. Original value parameters are useful for concurrency tokens.
+- `HasRowsAffectedParameter` specifies a parameter used to return the number of rows affected by the stored procedure.
+
+> [!TIP]
+> Original value parameters must be used for key values in "update" and "delete" stored procedures. This ensures that the correct row will be updated in future versions of EF Core that support mutable key values.
+
+### Returning values
+
+EF Core supports three mechanisms for returning values from stored procedures:
+
+- Output parameters, as shown above.
+- Result columns, which are specified using the `HasResultColumn` builder method.
+- The return value, which is limited to returning the number of rows affected, and is specified using the `HasRowsAffectedReturnValue` builder method.
+
+Values returned from stored procedures are often used for generated, default, or computed values, such as from an `Identity` key or a computed column. For example, the following configuration specifies four result columns:
+
+```csharp
+entityTypeBuilder.InsertUsingStoredProcedure(
+        storedProcedureBuilder =>
+        {
+            storedProcedureBuilder.HasParameter(document => document.Title);
+            storedProcedureBuilder.HasResultColumn(document => document.Id);
+            storedProcedureBuilder.HasResultColumn(document => document.FirstRecordedOn);
+            storedProcedureBuilder.HasResultColumn(document => document.RetrievedOn);
+            storedProcedureBuilder.HasResultColumn(document => document.RowVersion);
+        });
+```
+
+These are used to return:
+
+- The generated key value for the `Id` property.
+- The default value generated by the database for the `FirstRecordedOn` property.
+- The computed value generated by the database for the `RetrievedOn` property.
+- The automatically generated `rowversion` concurrency token for the `RowVersion` property.
+
+This configuration maps to the following stored procedure when using SQL Server:
+
+```sql
+CREATE PROCEDURE [dbo].[Documents_Insert]
+    @Title [nvarchar](max)
+AS
+BEGIN
+    INSERT INTO [Documents] ([Title])
+    OUTPUT INSERTED.[Id], INSERTED.[FirstRecordedOn], INSERTED.[RetrievedOn], INSERTED.[RowVersion]
+    VALUES (@Title);
+END
+```
+
+### Optimistic concurrency
+
+[Optimistic concurrency](xref:core/saving/concurrency) works the same way with stored procedures as it does without. The stored procedure should:
+
+- Use a concurrency token in a `WHERE` clause to ensure that the row is only updated if it has a valid token. The value used for the concurrency token is typically, but does not have to be, the original value of the concurrency token property.
+- Return the number of rows affected so that EF Core can compare this against the expected number of rows affected and throw a `DbUpdateConcurrencyException` if the values do not match.
+
+For example, the following SQL Server stored procedure uses a `rowversion` automatic concurrency token:
+
+```sql
+CREATE PROCEDURE [dbo].[Documents_Update]
+    @Id [int],
+    @RowVersion_Original [rowversion],
+    @Title [nvarchar](max),
+    @RowVersion [rowversion] OUT
+AS
+BEGIN
+    DECLARE @TempTable table ([RowVersion] varbinary(8));
+    UPDATE [Documents] SET
+        [Title] = @Title
+    OUTPUT INSERTED.[RowVersion] INTO @TempTable
+    WHERE [Id] = @Id AND [RowVersion] = @RowVersion_Original
+    SELECT @@ROWCOUNT;
+    SELECT @RowVersion = [RowVersion] FROM @TempTable;
+END
+```
+
+This is configured in EF Core using:
+
+```csharp
+.UpdateUsingStoredProcedure(
+    storedProcedureBuilder =>
+    {
+        storedProcedureBuilder.HasOriginalValueParameter(document => document.Id);
+        storedProcedureBuilder.HasOriginalValueParameter(document => document.RowVersion);
+        storedProcedureBuilder.HasParameter(document => document.Title);
+        storedProcedureBuilder.HasParameter(document => document.RowVersion, parameterBuilder => parameterBuilder.IsOutput());
+        storedProcedureBuilder.HasRowsAffectedResultColumn();
+    });
+```
+
+Notice that:
+
+- The original value of the `RowVersion` concurrency token is used.
+- The stored procedure uses a `WHERE` clause to ensure that the row is only updated if the `RowVersion` original value matches.
+- The new generated value for the `RowVersion` is inserted into a temporary table.
+- The number of rows affected (`@@ROWCOUNT`) and the generated `RowVersion` value are returned.
+
+### Mapping inheritance hierarchies to stored procedures
+
+EF Core requires that stored procedures follow the table layout for [types in a hierarchy](xref:core/modeling/inheritance). This means that:
+
+- A hierarchy mapped using TPH must have a single insert, update, and/or delete stored procedure targeting the single mapped table. The insert and update stored procedures must have a parameter for the discriminator value.
+- A hierarchy mapped using TPT must have an insert, update, and/or delete stored procedure for every type, including abstract types. EF Core will make multiple calls as needed to update, insert, and delete rows in all tables.
+- A hierarchy mapped using TPC must have an insert, update, and/or delete stored procedure for every concrete type, but not abstract types.
+
+> [!NOTE]
+> If using a single stored procedure per concrete type regardless of the mapping strategy is something you are interested in, then vote for [Support using a single sproc per concrete type regardless of the inheritance mapping strategy](https://github.com/dotnet/efcore/issues/29143).
+
+### Mapping owned types to stored procedures
+
+Configuration of stored procedures for owned types is done in the nested owned type builder. For example:
+
+```csharp
+modelBuilder.Entity<Person>(
+    entityTypeBuilder =>
+    {
+        entityTypeBuilder.OwnsOne(
+            author => author.Contact,
+            ownedNavigationBuilder =>
+            {
+                ownedNavigationBuilder.ToTable("Contacts");
+                ownedNavigationBuilder
+                    .InsertUsingStoredProcedure(
+                        storedProcedureBuilder =>
+                        {
+                            storedProcedureBuilder.HasParameter("PersonId");
+                            storedProcedureBuilder.HasParameter(contactDetails => contactDetails.Phone);
+                        })
+                    .UpdateUsingStoredProcedure(
+                        storedProcedureBuilder =>
+                        {
+                            storedProcedureBuilder.HasOriginalValueParameter("PersonId");
+                            storedProcedureBuilder.HasParameter(contactDetails => contactDetails.Phone);
+                            storedProcedureBuilder.HasRowsAffectedResultColumn();
+                        })
+                    .DeleteUsingStoredProcedure(
+                        storedProcedureBuilder =>
+                        {
+                            storedProcedureBuilder.HasOriginalValueParameter("PersonId");
+                            storedProcedureBuilder.HasRowsAffectedResultColumn();
+            });
+    });
+```
+
+> [!NOTE]
+> Currently stored procedures for insert, update, and delete only support owned types must be mapped to separate tables. That is, the owned type cannot be represented by columns in the owner table. Vote for [Add "table" splitting support to CUD sproc mapping](https://github.com/dotnet/efcore/issues/28434) if this is a limitation that you would like to see removed.
+
+### Mapping many-to-many join entities to stored procedures
+
+Configuration of stored procedures many-to-many join entities can be performed as part of the many-to-many configuration. For example:
+
+<!--
+            modelBuilder.Entity<Book>(
+                entityTypeBuilder =>
+                {
+                    entityTypeBuilder
+                        .HasMany(document => document.Authors)
+                        .WithMany(author => author.PublishedWorks)
+                        .UsingEntity<Dictionary<string, object>>(
+                            "BookPerson",
+                            builder => builder.HasOne<Person>().WithMany().OnDelete(DeleteBehavior.Cascade),
+                            builder => builder.HasOne<Book>().WithMany().OnDelete(DeleteBehavior.ClientCascade),
+                            joinTypeBuilder =>
+                            {
+                                joinTypeBuilder
+                                    .InsertUsingStoredProcedure(
+                                        storedProcedureBuilder =>
+                                        {
+                                            storedProcedureBuilder.HasParameter("AuthorsId");
+                                            storedProcedureBuilder.HasParameter("PublishedWorksId");
+                                        })
+                                    .DeleteUsingStoredProcedure(
+                                        storedProcedureBuilder =>
+                                        {
+                                            storedProcedureBuilder.HasOriginalValueParameter("AuthorsId");
+                                            storedProcedureBuilder.HasOriginalValueParameter("PublishedWorksId");
+                                            storedProcedureBuilder.HasRowsAffectedResultColumn();
+                                        });
+                            });
+                });
+-->
+[!code-csharp[JoinSprocs](../../../../samples/core/Miscellaneous/NewInEFCore7/DocumentsContext.cs?name=JoinSprocs)]
+
+## New and improved interceptors and events
+
+EF Core [interceptors](xref:core/logging-events-diagnostics/interceptors) enable interception, modification, and/or suppression of EF Core operations. EF Core also includes [traditional .NET events](xref:core/logging-events-diagnostics/events) and [logging](xref:core/logging-events-diagnostics/index).
+
+EF7 includes the following enhancements to interceptors:
+
+- Interception for [creating and populating new entity instances](https://github.com/dotnet/efcore/issues/15911) (aka "materialization")
+- Interception to [modify the LINQ expression tree](https://github.com/dotnet/efcore/issues/28505) before a query is compiled
+- Interception for [optimistic concurrency handling](https://github.com/dotnet/efcore/issues/28315) (`DbUpdateConcurrencyException`)
+- Interception for [connections _before_ checking if the connection string has been set](https://github.com/dotnet/efcore/issues/23085)
+- Interception for when EF Core has [finished consuming a result set](https://github.com/dotnet/efcore/issues/23535), but before that result set is closed
+- Interception for [creation of a `DbConnection` by EF Core](https://github.com/dotnet/efcore/issues/23087)
+- Interception for [`DbCommand` after it has been initialized](https://github.com/dotnet/efcore/issues/17261)
+
+In addition, EF7 includes new traditional .NET events for:
+
+- When an [entity is about to be tracked or change state](https://github.com/dotnet/efcore/issues/27093), but before it is actually tracked or change state
+- Before and after EF Core [detects changes to entities and properties](https://github.com/dotnet/efcore/issues/26506) (aka `DetectChanges` interception)
+
+The following sections provide brief summaries of these new interception capabilities. For detailed documentation and complete code samples, see [Interceptors](xref:core/logging-events-diagnostics/interceptors).
+
+### Materialization interception
+
+The new <xref:Microsoft.EntityFrameworkCore.Diagnostics.IMaterializationInterceptor> supports interception before and after an entity instance is created, and before and after properties of that instance are initialized. The interceptor can change or replace the entity instance at each point. This allows setting unmapped properties, using a factory to create instances, injecting services into entities, and more.
+
+For example, an interceptor can set a `Retrieved` timestamp on entities as they are loaded from the database:
+
+<!--
+public class SetRetrievedInterceptor : IMaterializationInterceptor
+{
+    public object InitializedInstance(MaterializationInterceptionData materializationData, object instance)
+    {
+        if (instance is IHasRetrieved hasRetrieved)
+        {
+            hasRetrieved.Retrieved = DateTime.UtcNow;
+        }
+        
+        return instance;
+    }
+}
+-->
+[!code-csharp[SetRetrievedInterceptor](../../../../samples/core/Miscellaneous/NewInEFCore7/SimpleMaterializationSample.cs?name=SetRetrievedInterceptor)]
+
+For more information and examples, including injecting services into entities, see [Materialization interception](xref:core/logging-events-diagnostics/interceptors#materialization-interception).
+
+### LINQ expression tree interception
+
+The new <xref:Microsoft.EntityFrameworkCore.Diagnostics.IQueryExpressionInterceptor> allows the LINQ expression tree for a query to be intercepted and modified before it is compiled. This can be used to dynamically add secondary ordering, apply filters, or make other modifications to queries across the application.
+
+For example, the following interceptor replaces the expression tree before it is compiled:
+
+```csharp
+public class KeyOrderingExpressionInterceptor : IQueryExpressionInterceptor
+{
+    public Expression QueryCompilationStarting(Expression queryExpression, QueryExpressionEventData eventData)
+        => new KeyOrderingExpressionVisitor().Visit(queryExpression);
+
+    // ExpressionVisitor that modifies the tree...
+}
+```
+
+For more information and examples, see [Query expression interception](xref:core/logging-events-diagnostics/interceptors#query-expression-interception).
+
+### Optimistic concurrency interception
+
+<xref:Microsoft.EntityFrameworkCore.Diagnostics.ISaveChangesInterceptor> now has `ThrowingConcurrencyException` and `ThrowingConcurrencyExceptionAsync` methods that are called before a <xref:Microsoft.EntityFrameworkCore.DbUpdateConcurrencyException> is thrown. These interception points allow the exception to be suppressed, possibly coupled with async database changes to resolve the violation.
+
+For example, if two requests try to delete the same entity, the second delete fails because the row no longer exists. An interceptor can suppress this, since the end result is the same:
+
+```csharp
+public class SuppressDeleteConcurrencyInterceptor : ISaveChangesInterceptor
+{
+    public InterceptionResult ThrowingConcurrencyException(
+        ConcurrencyExceptionEventData eventData,
+        InterceptionResult result)
+    {
+        if (eventData.Entries.All(e => e.State == EntityState.Deleted))
+        {
+            return InterceptionResult.Suppress();
+        }
+
+        return result;
+    }
+}
+```
+
+For more information and examples, see [Optimistic concurrency interception](xref:core/logging-events-diagnostics/interceptors#example-optimistic-concurrency-interception).
+
+### Lazy initialization of a connection string
+
+<xref:Microsoft.EntityFrameworkCore.Diagnostics.IDbConnectionInterceptor> can be used to dynamically configure connection strings at the time the connection is first used, for example to support per-tenant connection strings in a multi-tenant system. The `ConnectionOpeningAsync` method can perform an async operation to obtain the connection string, find an access token, and so on.
+
+For example, the following interceptor sets the connection string the first time the connection is opened:
+
+```csharp
+public class ConnectionStringInitializationInterceptor : DbConnectionInterceptor
+{
+    private readonly ITenantConnectionStringFactory _connectionStringFactory;
+
+    public ConnectionStringInitializationInterceptor(ITenantConnectionStringFactory connectionStringFactory)
+    {
+        _connectionStringFactory = connectionStringFactory;
+    }
+
+    public override async ValueTask<InterceptionResult> ConnectionOpeningAsync(
+        DbConnection connection, ConnectionEventData eventData, InterceptionResult result,
+        CancellationToken cancellationToken = new())
+    {
+        if (string.IsNullOrEmpty(connection.ConnectionString))
+        {
+            connection.ConnectionString =
+                (await _connectionStringFactory.GetConnectionStringAsync(cancellationToken));
+        }
+
+        return result;
+    }
+}
+```
+
+For more information and examples, see [Lazy initialization of a connection string](xref:core/logging-events-diagnostics/interceptors#example-lazy-initialization-of-a-connection-string).
+
+### Logging SQL Server query statistics
+
+Two interceptors can work together to send SQL Server query statistics to the application log. An <xref:Microsoft.EntityFrameworkCore.Diagnostics.IDbCommandInterceptor> prefixes commands with `SET STATISTICS IO ON` and uses the new `DataReaderClosingAsync` method to read statistics results. An <xref:Microsoft.EntityFrameworkCore.Diagnostics.IDbConnectionInterceptor> uses the new `ConnectionCreated` method to hook into the <xref:Microsoft.Data.SqlClient.SqlConnection.InfoMessage?displayProperty=nameWithType> event.
+
+For example, the command interceptor prefixes the statistics directive:
+
+```csharp
+public override ValueTask<InterceptionResult<DbDataReader>> ReaderExecutingAsync(
+    DbCommand command,
+    CommandEventData eventData,
+    InterceptionResult<DbDataReader> result,
+    CancellationToken cancellationToken = default)
+{
+    command.CommandText = "SET STATISTICS IO ON;" + Environment.NewLine + command.CommandText;
+
+    return new(result);
+}
+```
+
+For more information and examples, see [Logging SQL Server query statistics](xref:core/logging-events-diagnostics/interceptors#example-logging-sql-server-query-statistics).
+
+## Query enhancements
+
+EF7 contains many improvements in the translation of LINQ queries.
+
+### GroupBy as final operator
+
+> [!TIP]
+> The code shown here comes from [GroupByFinalOperatorSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore7/GroupByFinalOperatorSample.cs).
+
+EF7 supports using `GroupBy` as the final operator in a query. For example, this LINQ query:
+
+<!--
+var query = context.Books.GroupBy(s => s.Price);
+-->
+[!code-csharp[GroupByFinalOperator](../../../../samples/core/Miscellaneous/NewInEFCore7/GroupByFinalOperatorSample.cs?name=GroupByFinalOperator)]
+
+Translates to the following SQL when using SQL Server:
+
+```sql
+SELECT [b].[Price], [b].[Id], [b].[AuthorId]
+FROM [Books] AS [b]
+ORDER BY [b].[Price]
+```
+
+> [!NOTE]
+> This type of `GroupBy` does not translate directly to SQL, so EF Core does the grouping on the returned results. However, this does not result in any additional data being transferred from the server.
+
+### GroupJoin as final operator
+
+> [!TIP]
+> The code shown here comes from [GroupJoinFinalOperatorSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore7/GroupByFinalOperatorSample.cs).
+
+EF7 supports using `GroupJoin` as the final operator in a query. For example, this LINQ query:
+
+<!--
+            var query = context.Customers.GroupJoin(
+                context.Orders, c => c.Id, o => o.CustomerId, (c, os) => new { Customer = c, Orders = os });
+-->
+[!code-csharp[GroupJoinFinalOperator](../../../../samples/core/Miscellaneous/NewInEFCore7/GroupJoinFinalOperatorSample.cs?name=GroupJoinFinalOperator)]
+
+Translates to the following SQL when using SQL Server:
+
+```sql
+SELECT [c].[Id], [c].[Name], [t].[Id], [t].[Amount], [t].[CustomerId]
+FROM [Customers] AS [c]
+OUTER APPLY (
+    SELECT [o].[Id], [o].[Amount], [o].[CustomerId]
+    FROM [Orders] AS [o]
+    WHERE [c].[Id] = [o].[CustomerId]
+) AS [t]
+ORDER BY [c].[Id]
+```
+
+### GroupBy entity type
+
+> [!TIP]
+> The code shown here comes from [GroupByEntityTypeSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore7/GroupByEntityTypeSample.cs).
+
+EF7 supports grouping by an entity type. For example, this LINQ query:
+
+<!--
+            var query = context.Books
+                .GroupBy(s => s.Author)
+                .Select(s => new { Author = s.Key, MaxPrice = s.Max(p => p.Price) });
+-->
+[!code-csharp[GroupByEntityType](../../../../samples/core/Miscellaneous/NewInEFCore7/GroupByEntityTypeSample.cs?name=GroupByEntityType)]
+
+Translates to the following SQL when using SQLite:
+
+```sql
+SELECT [a].[Id], [a].[Name], MAX([b].[Price]) AS [MaxPrice]
+FROM [Books] AS [b]
+INNER JOIN [Author] AS [a] ON [b].[AuthorId] = [a].[Id]
+GROUP BY [a].[Id], [a].[Name]
+```
+
+Keep in mind that grouping by a unique property, such as the primary key, will always be more efficient than grouping by an entity type. However, grouping by entity types can be used for both keyed and keyless entity types.
+
+Also, grouping by an entity type with a primary key will always result in one group per entity instance, since every entity must have a unique key value. It is sometimes worth switching the source of the query so that grouping in not required. For example, the following query returns the same results as the previous query:
+<!--
+var query = context.Authors
+    .Select(a => new { Author = a, MaxPrice = a.Books.Max(b => b.Price) });
+-->
+[!code-csharp[GroupByEntityTypeReversed](../../../../samples/core/Miscellaneous/NewInEFCore7/GroupByEntityTypeSample.cs?name=GroupByEntityTypeReversed)]
+
+This query translates to the following SQL when using SQLite:
+
+```sql
+SELECT [a].[Id], [a].[Name], (
+    SELECT MAX([b].[Price])
+    FROM [Books] AS [b]
+    WHERE [a].[Id] = [b].[AuthorId]) AS [MaxPrice]
+FROM [Authors] AS [a]
+```
+
+### Subqueries don't reference ungrouped columns from outer query
+
+> [!TIP]
+> The code shown here comes from [UngroupedColumnsQuerySample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore7/UngroupedColumnsQuerySample.cs).
+
+In EF Core 6.0, a `GROUP BY` clause would reference columns in the outer query, which fails with some databases and is inefficient in others. For example, consider the following query:
+
+<!--
+            var query = from s in (from i in context.Invoices
+                                   group i by i.History.Month
+                                   into g
+                                   select new { Month = g.Key, Total = g.Sum(p => p.Amount), })
+                        select new
+                        {
+                            s.Month, s.Total, Payment = context.Payments.Where(p => p.History.Month == s.Month).Sum(p => p.Amount)
+                        };
+-->
+[!code-csharp[UngroupedColumns](../../../../samples/core/Miscellaneous/NewInEFCore7/UngroupedColumnsQuerySample.cs?name=UngroupedColumns)]
+
+In EF Core 6.0 on SQL Server, this was translated to:
+
+```sql
+SELECT DATEPART(month, [i].[History]) AS [Month], COALESCE(SUM([i].[Amount]), 0.0) AS [Total], (
+    SELECT COALESCE(SUM([p].[Amount]), 0.0)
+    FROM [Payments] AS [p]
+    WHERE DATEPART(month, [p].[History]) = DATEPART(month, [i].[History])) AS [Payment]
+FROM [Invoices] AS [i]
+GROUP BY DATEPART(month, [i].[History])
+```
+
+On EF7, the translation is:
+
+```sql
+SELECT [t].[Key] AS [Month], COALESCE(SUM([t].[Amount]), 0.0) AS [Total], (
+    SELECT COALESCE(SUM([p].[Amount]), 0.0)
+    FROM [Payments] AS [p]
+    WHERE DATEPART(month, [p].[History]) = [t].[Key]) AS [Payment]
+FROM (
+    SELECT [i].[Amount], DATEPART(month, [i].[History]) AS [Key]
+    FROM [Invoices] AS [i]
+) AS [t]
+GROUP BY [t].[Key]
+```
+
+### Read-only collections can be used for `Contains`
+
+> [!TIP]
+> The code shown here comes from [ReadOnlySetQuerySample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore7/ReadOnlySetQuerySample.cs).
+
+EF7 supports using `Contains` when the items to search for are contained in an `IReadOnlySet` or `IReadOnlyCollection`, or `IReadOnlyList`. For example, this LINQ query:
+
+<!--
+            IReadOnlySet<int> searchIds = new HashSet<int> { 1, 3, 5 };
+            var query = context.Customers.Where(p => p.Orders.Any(l => searchIds.Contains(l.Id)));
+-->
+[!code-csharp[ReadOnlySetQuery](../../../../samples/core/Miscellaneous/NewInEFCore7/ReadOnlySetQuerySample.cs?name=ReadOnlySetQuery)]
+
+Translates to the following SQL when using SQL Server:
+
+```sql
+SELECT [c].[Id], [c].[Name]
+FROM [Customers] AS [c]
+WHERE EXISTS (
+    SELECT 1
+    FROM [Orders] AS [o]
+    WHERE [c].[Id] = [o].[Customer1Id] AND [o].[Id] IN (1, 3, 5))
+```
+
+### Translations for aggregate functions
+
+EF7 introduces better extensibility for providers to translate aggregate functions. This and other work in this area have resulted in several new translations across providers, including:
+
+- [Translation of `String.Join` and `String.Concat`](https://github.com/dotnet/efcore/issues/2981)
+- [Translation of spatial aggregate functions](https://github.com/dotnet/efcore/issues/13278)
+- [Translation of statistics aggregate functions](https://github.com/dotnet/efcore/issues/28104)
+
+> [!NOTE]
+> Aggregate functions that act on `IEnumerable` argument are typically only translated in `GroupBy` queries. Vote for [Support spatial types in JSON columns](https://github.com/dotnet/efcore/issues/29200) if you are interested in getting this limitation removed.
+
+#### String aggregate functions
+
+> [!TIP]
+> The code shown here comes from [StringAggregateFunctionsSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore7/StringAggregateFunctionsSample.cs).
+
+Queries using <xref:System.String.Join*> and <xref:System.String.Concat*> are now translated when appropriate. For example:
+
+<!--
+        var query = context.Posts
+            .GroupBy(post => post.Author)
+            .Select(grouping => new { Author = grouping.Key, Books = string.Join("|", grouping.Select(post => post.Title)) });
+-->
+[!code-csharp[Join](../../../../samples/core/Miscellaneous/NewInEFCore7/StringAggregateFunctionsSample.cs?name=Join)]
+
+This query translates to the following when using SQL Server:
+
+```sql
+SELECT [a].[Id], [a].[Name], COALESCE(STRING_AGG([p].[Title], N'|'), N'') AS [Books]
+FROM [Posts] AS [p]
+LEFT JOIN [Authors] AS [a] ON [p].[AuthorId] = [a].[Id]
+GROUP BY [a].[Id], [a].[Name]
+```
+
+When combined with other string functions, these translations allow for some complex string manipulation on the server. For example:
+
+<!--
+        var query = context.Posts
+            .GroupBy(post => post.Author!.Name)
+            .Select(
+                grouping =>
+                    new
+                    {
+                        PostAuthor = grouping.Key,
+                        Blogs = string.Concat(
+                            grouping
+                                .Select(post => post.Blog.Name)
+                                .Distinct()
+                                .Select(postName => "'" + postName + "' ")),
+                        ContentSummaries = string.Join(
+                            " | ",
+                            grouping
+                                .Where(post => post.Content.Length >= 10)
+                                .Select(post => "'" + post.Content.Substring(0, 10) + "' "))
+                    });
+-->
+[!code-csharp[ConcatAndJoin](../../../../samples/core/Miscellaneous/NewInEFCore7/StringAggregateFunctionsSample.cs?name=ConcatAndJoin)]
+
+This query translates to the following when using SQL Server:
+
+```sql
+SELECT [t].[Name], (N'''' + [t0].[Name]) + N''' ', [t0].[Name], [t].[c]
+FROM (
+    SELECT [a].[Name], COALESCE(STRING_AGG(CASE
+        WHEN CAST(LEN([p].[Content]) AS int) >= 10 THEN COALESCE((N'''' + COALESCE(SUBSTRING([p].[Content], 0 + 1, 10), N'')) + N''' ', N'')
+    END, N' | '), N'') AS [c]
+    FROM [Posts] AS [p]
+    LEFT JOIN [Authors] AS [a] ON [p].[AuthorId] = [a].[Id]
+    GROUP BY [a].[Name]
+) AS [t]
+OUTER APPLY (
+    SELECT DISTINCT [b].[Name]
+    FROM [Posts] AS [p0]
+    LEFT JOIN [Authors] AS [a0] ON [p0].[AuthorId] = [a0].[Id]
+    INNER JOIN [Blogs] AS [b] ON [p0].[BlogId] = [b].[Id]
+    WHERE [t].[Name] = [a0].[Name] OR ([t].[Name] IS NULL AND [a0].[Name] IS NULL)
+) AS [t0]
+ORDER BY [t].[Name]
+```
+
+#### Spatial aggregate functions
+
+> [!TIP]
+> The code shown here comes from [SpatialAggregateFunctionsSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore7/SpatialAggregateFunctionsSample.cs).
+
+It is now possible for [database providers that support for NetTopologySuite](xref:core/modeling/spatial) to translate the following spatial aggregate functions:
+
+- [GeometryCombiner.Combine()](https://nettopologysuite.github.io/NetTopologySuite/api/NetTopologySuite.Geometries.Utilities.GeometryCombiner.html)
+- [UnaryUnionOp.Union()](https://nettopologysuite.github.io/NetTopologySuite/api/NetTopologySuite.Operation.Union.UnaryUnionOp.html)
+- [ConvexHull.Create()](http://nettopologysuite.github.io/NetTopologySuite/api/NetTopologySuite.Algorithm.ConvexHull.html)
+- [EnvelopeCombiner.CombineAsGeometry()](https://nettopologysuite.github.io/NetTopologySuite/api/NetTopologySuite.Geometries.Utilities.EnvelopeCombiner.html)
+
+> [!TIP]
+> These translations have been implemented by the team for SQL Server and SQLite. For other providers, contact the provider maintainer to add support if it has been implemented for that provider.
+
+For example:
+
+<!--
+            var query = context.Caches
+                .Where(cache => cache.Location.X < -90)
+                .GroupBy(cache => cache.Owner)
+                .Select(grouping => new
+                    {
+                        Id = grouping.Key,
+                        Combined = GeometryCombiner.Combine(grouping.Select(cache => cache.Location))
+                    });
+-->
+[!code-csharp[GeometryCombinerCombine](../../../../samples/core/Miscellaneous/NewInEFCore7/SpatialAggregateFunctionsSample.cs?name=GeometryCombinerCombine)]
+
+This query is translated to the following SQL when using SQL Server:
+
+```sql
+SELECT [c].[Owner] AS [Id], geography::CollectionAggregate([c].[Location]) AS [Combined]
+FROM [Caches] AS [c]
+WHERE [c].[Location].Long < -90.0E0
+GROUP BY [c].[Owner]
+```
+
+#### Statistical aggregate functions
+
+> [!TIP]
+> The code shown here comes from [StatisticalAggregateFunctionsSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore7/StatisticalAggregateFunctionsSample.cs).
+
+SQL Server translations have been implemented for the following statistical functions:
+
+- <xref:Microsoft.EntityFrameworkCore.SqlServerDbFunctionsExtensions.StandardDeviationSample*>
+- <xref:Microsoft.EntityFrameworkCore.SqlServerDbFunctionsExtensions.StandardDeviationPopulation*>
+- <xref:Microsoft.EntityFrameworkCore.SqlServerDbFunctionsExtensions.VarianceSample*>
+- <xref:Microsoft.EntityFrameworkCore.SqlServerDbFunctionsExtensions.VariancePopulation*>
+
+> [!TIP]
+> These translations have been implemented by the team for SQL Server. For other providers, contact the provider maintainer to add support if it has been implemented for that provider.
+
+For example:
+
+<!--
+            var query = context.Downloads
+                .GroupBy(download => download.Uploader.Id)
+                .Select(
+                    grouping => new
+                    {
+                        Author = grouping.Key,
+                        TotalCost = grouping.Sum(d => d.DownloadCount),
+                        AverageViews = grouping.Average(d => d.DownloadCount),
+                        VariancePopulation = EF.Functions.VariancePopulation(grouping.Select(d => d.DownloadCount)),
+                        VarianceSample = EF.Functions.VarianceSample(grouping.Select(d => d.DownloadCount)),
+                        StandardDeviationPopulation = EF.Functions.StandardDeviationPopulation(grouping.Select(d => d.DownloadCount)),
+                        StandardDeviationSample = EF.Functions.StandardDeviationSample(grouping.Select(d => d.DownloadCount))
+                    });
+-->
+[!code-csharp[StatsForAll](../../../../samples/core/Miscellaneous/NewInEFCore7/StatisticalAggregateFunctionsSample.cs?name=StatsForAll)]
+
+This query is translated to the following SQL when using SQL Server:
+
+```sql
+SELECT [u].[Id] AS [Author], COALESCE(SUM([d].[DownloadCount]), 0) AS [TotalCost], AVG(CAST([d].[DownloadCount] AS float)) AS [AverageViews], VARP([d].[DownloadCount]) AS [VariancePopulation], VAR([d].[DownloadCount]) AS [VarianceSample], STDEVP([d].[DownloadCount]) AS [StandardDeviationPopulation], STDEV([d].[DownloadCount]) AS [StandardDeviationSample]
+FROM [Downloads] AS [d]
+INNER JOIN [Uploader] AS [u] ON [d].[UploaderId] = [u].[Id]
+GROUP BY [u].[Id]
+```
+
+### Translation of `string.IndexOf`
+
+> [!TIP]
+> The code shown here comes from [MiscellaneousTranslationsSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore7/MiscellaneousTranslationsSample.cs).
+
+EF7 now translates <xref:System.String.IndexOf*?displayProperty=nameWithType> in LINQ queries. For example:
+
+<!--
+            var query = context.Posts
+                .Select(post => new { post.Title, IndexOfEntity = post.Content.IndexOf("Entity") })
+                .Where(post => post.IndexOfEntity > 0);
+-->
+[!code-csharp[StringIndexOf](../../../../samples/core/Miscellaneous/NewInEFCore7/MiscellaneousTranslationsSample.cs?name=StringIndexOf)]
+
+This query translates to the following SQL when using SQL Server:
+
+```sql
+SELECT [p].[Title], CAST(CHARINDEX(N'Entity', [p].[Content]) AS int) - 1 AS [IndexOfEntity]
+FROM [Posts] AS [p]
+WHERE (CAST(CHARINDEX(N'Entity', [p].[Content]) AS int) - 1) > 0
+```
+
+### Translation of `GetType` for entity types
+
+> [!TIP]
+> The code shown here comes from [MiscellaneousTranslationsSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore7/MiscellaneousTranslationsSample.cs).
+
+EF7 now translates <xref:System.Object.GetType?displayProperty=nameWithType> in LINQ queries. For example:
+
+<!--
+            var query = context.Posts.Where(post => post.GetType() == typeof(Post));
+-->
+[!code-csharp[GetType](../../../../samples/core/Miscellaneous/NewInEFCore7/MiscellaneousTranslationsSample.cs?name=GetType)]
+
+This query translates to the following SQL when using SQL Server with TPH inheritance:
+
+```sql
+SELECT [p].[Id], [p].[AuthorId], [p].[BlogId], [p].[Content], [p].[Discriminator], [p].[PublishedOn], [p].[Title], [p].[PromoText]
+FROM [Posts] AS [p]
+WHERE [p].[Discriminator] = N'Post'
+```
+
+Notice that this query returns only `Post` instances that are actually of type `Post`, and not those of any derived types. This is different from a query that uses `is` or `OfType`, which will also return instances of any derived types. For example, consider the query:
+
+<!--
+            var query = context.Posts.OfType<Post>();
+-->
+[!code-csharp[OfType](../../../../samples/core/Miscellaneous/NewInEFCore7/MiscellaneousTranslationsSample.cs?name=OfType)]
+
+Which translates to different SQL:
+
+```sql
+      SELECT [p].[Id], [p].[AuthorId], [p].[BlogId], [p].[Content], [p].[Discriminator], [p].[PublishedOn], [p].[Title], [p].[PromoText]
+      FROM [Posts] AS [p]
+```
+
+And will return both `Post` and `FeaturedPost` entities.
+
+### Support for `AT TIME ZONE`
+
+> [!TIP]
+> The code shown here comes from [MiscellaneousTranslationsSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore7/MiscellaneousTranslationsSample.cs).
+
+EF7 introduces new <xref:Microsoft.EntityFrameworkCore.SqlServerDbFunctionsExtensions.AtTimeZone*> functions for <xref:System.DateTime> and <xref:System.DateTimeOffset>. These functions translate to `AT TIME ZONE` clauses in the generated SQL. For example:
+
+<!--
+            var query = context.Posts
+                .Select(post => new
+                {
+                    post.Title,
+                    PacificTime = EF.Functions.AtTimeZone(post.PublishedOn, "Pacific Standard Time"),
+                    UkTime = EF.Functions.AtTimeZone(post.PublishedOn, "GMT Standard Time"),
+                });
+-->
+[!code-csharp[AtTimeZone](../../../../samples/core/Miscellaneous/NewInEFCore7/MiscellaneousTranslationsSample.cs?name=AtTimeZone)]
+
+This query translates to the following SQL when using SQL Server:
+
+```sql
+SELECT [p].[Title], [p].[PublishedOn] AT TIME ZONE 'Pacific Standard Time' AS [PacificTime], [p].[PublishedOn] AT TIME ZONE 'GMT Standard Time' AS [UkTime]
+FROM [Posts] AS [p]
+```
+
+> [!TIP]
+> These translations have been implemented by the team for SQL Server. For other providers, contact the provider maintainer to add support if it has been implemented for that provider.
+
+### Filtered Include on hidden navigations
+
+> [!TIP]
+> The code shown here comes from [MiscellaneousTranslationsSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore7/MiscellaneousTranslationsSample.cs).
+
+The [Include methods](xref:core/querying/related-data/eager) can now be used with <xref:Microsoft.EntityFrameworkCore.EF.Property*?displayProperty=nameWithType>. This allows [filtering and ordering](xref:core/querying/related-data/eager#filtered-include) even for private navigation properties, or private navigations represented by fields. For example:
+
+<!--
+            var query = context.Blogs.Include(
+                blog => EF.Property<ICollection<Post>>(blog, "Posts")
+                    .Where(post => post.Content.Contains(".NET"))
+                    .OrderBy(post => post.Title));
+-->
+[!code-csharp[FilteredInclude](../../../../samples/core/Miscellaneous/NewInEFCore7/MiscellaneousTranslationsSample.cs?name=FilteredInclude)]
+
+This is equivalent to:
+
+```csharp
+var query = context.Blogs.Include(
+    blog => Posts
+        .Where(post => post.Content.Contains(".NET"))
+        .OrderBy(post => post.Title));
+```
+
+But does not require `Blog.Posts` to be publicly accessible.
+
+When using SQL Server, both queries above translate to:
+
+```sql
+SELECT [b].[Id], [b].[Name], [t].[Id], [t].[AuthorId], [t].[BlogId], [t].[Content], [t].[Discriminator], [t].[PublishedOn], [t].[Title], [t].[PromoText]
+FROM [Blogs] AS [b]
+LEFT JOIN (
+    SELECT [p].[Id], [p].[AuthorId], [p].[BlogId], [p].[Content], [p].[Discriminator], [p].[PublishedOn], [p].[Title], [p].[PromoText]
+    FROM [Posts] AS [p]
+    WHERE [p].[Content] LIKE N'%.NET%'
+) AS [t] ON [b].[Id] = [t].[BlogId]
+ORDER BY [b].[Id], [t].[Title]
+```
+
+### Cosmos translation for `Regex.IsMatch`
+
+> [!TIP]
+> The code shown here comes from [CosmosQueriesSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore7/CosmosQueriesSample.cs).
+
+EF7 supports using <xref:System.Text.RegularExpressions.Regex.IsMatch*?displayProperty=nameWithType> in LINQ queries against Azure Cosmos DB. For example:
+
+<!--
+        var containsInnerT = await context.Triangles
+            .Where(o => Regex.IsMatch(o.Name, "[a-z]t[a-z]", RegexOptions.IgnoreCase))
+            .ToListAsync();
+-->
+[!code-csharp[RegexIsMatch](../../../../samples/core/Miscellaneous/NewInEFCore7/CosmosQueriesSample.cs?name=RegexIsMatch)]
+
+Translates to the following SQL:
+
+```sql
+SELECT c
+FROM root c
+WHERE ((c["Discriminator"] = "Triangle") AND RegexMatch(c["Name"], "[a-z]t[a-z]", "i"))
+```
+
+## DbContext API and behavior enhancements
+
+EF7 contains a variety of small improvements to <xref:Microsoft.EntityFrameworkCore.DbContext> and related classes.
+
+> [!TIP]
+> The code for samples in this section comes from [DbContextApiSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore7/DbContextApiSample.cs).
+
+### Suppressor for uninitialized DbSet properties
+
+Public, settable `DbSet` properties on a `DbContext` are automatically initialized by EF Core when the `DbContext` is constructed. For example, consider the following `DbContext` definition:
+
+```csharp
+public class SomeDbContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+}
+```
+
+The `Blogs` property will be set to a `DbSet<Blog>` instance as part of constructing the `DbContext` instance. This allows the context to be used for queries without any additional steps.
+
+However, following the introduction of [C# nullable reference types](/dotnet/csharp/tutorials/nullable-reference-types), the compiler now warns that the non-nullable property `Blogs` is not initialized:
+
+> `[CS8618] Non-nullable property 'Blogs' must contain a non-null value when exiting constructor. Consider declaring the property as nullable.`
+
+This is a bogus warning; the property is set to a non-null value by EF Core. Also, declaring the property as nullable will make the warning go away, but this is not a good idea because, conceptually, the property is not nullable and will never be null.
+
+EF7 contains a [DiagnosticSuppressor](/dotnet/fundamentals/code-analysis/suppress-warnings) for `DbSet` properties on a `DbContext` which stops the compiler from generating this warning.
+
+> [!TIP]
+> This pattern originated in the days when C# auto-properties were very limited. With modern C#, consider making the auto-properties read-only, and then either initialize them explicitly in the `DbContext` constructor, or obtain the cached `DbSet` instance from the context when needed. For example, `public DbSet<Blog> Blogs => Set<Blog>()`.
+
+### Distinguish cancellation from failure in logs
+
+Sometimes an application will explicitly cancel a query or other database operation. This is usually done using a <xref:System.Threading.CancellationToken> passed to the method performing the operation.
+
+In EF Core 6, the events logged when an operation is canceled are the same as those logged when the operation fails for some other reason. EF7 introduces new log events specifically for canceled database operations. These new events are, by default, logged at the <xref:Microsoft.Extensions.Logging.LogLevel.Debug> level. The following table shows the relevant events and their default log levels:
+
+| Event                                                                                                           | Description                                                         | Default log level |
+|-----------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------|-------------------|
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.CoreEventId.QueryIterationFailed?displayProperty=nameWithType>  | An error occurred while processing the results of a query.          | `LogLevel.Error`  |
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.CoreEventId.SaveChangesFailed?displayProperty=nameWithType>     | An error occurred while attempting to save changes to the database. | `LogLevel.Error`  |
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.RelationalEventId.CommandError?displayProperty=nameWithType>    | An error occurred while a database command was executing.           | `LogLevel.Error`  |
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.CoreEventId.QueryCanceled?displayProperty=nameWithType>         | A query was canceled.                                               | `LogLevel.Debug`  |
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.CoreEventId.SaveChangesCanceled?displayProperty=nameWithType>   | The database command was canceled while attempting to save changes. | `LogLevel.Debug`  |
+| <xref:Microsoft.EntityFrameworkCore.Diagnostics.RelationalEventId.CommandCanceled?displayProperty=nameWithType> | The execution of a `DbCommand` has been canceled.                   | `LogLevel.Debug`  |
+
+> [!NOTE]
+> Cancellation is detected by looking at the exception rather than checking the cancellation token. This means that cancellations not triggered via the  cancellation token will still be detected and logged in this way.
+
+### New `IProperty` and `INavigation` overloads for `EntityEntry` methods
+
+Code working with the EF model will often have an <xref:Microsoft.EntityFrameworkCore.Metadata.IProperty> or <xref:Microsoft.EntityFrameworkCore.Metadata.INavigation> representing property or navigation metadata. An [EntityEntry](xref:core/change-tracking/entity-entries) is then used to get the property/navigation value or query its state. However, prior to EF7, this required passing the _name_ of the property or navigation to methods of the `EntityEntry`, which would then re-lookup the `IProperty` or `INavigation`. In EF7, the `IProperty` or `INavigation` can instead be passed directly, avoiding the additional lookup.
+
+For example, consider a method to find all the siblings of a given entity:
+
+<!--
+    public static IEnumerable<TEntity> FindSiblings<TEntity>(
+        this DbContext context, TEntity entity, string navigationToParent)
+        where TEntity : class
+    {
+        var parentEntry = context.Entry(entity).Reference(navigationToParent);
+
+        return context.Entry(parentEntry.CurrentValue!)
+            .Collection(parentEntry.Metadata.Inverse!)
+            .CurrentValue!
+            .OfType<TEntity>()
+            .Where(e => !ReferenceEquals(e, entity));
+    }
+-->
+[!code-csharp[FindSiblings](../../../../samples/core/Miscellaneous/NewInEFCore7/DbContextApiSample.cs?name=FindSiblings)]
+
+This method finds the parent of a given entity, and then passes the inverse `INavigation` to the `Collection` method of the parent entry. This metadata is then used to return all siblings of the given parent. Here's an example of its use:
+
+<!--
+            Console.WriteLine($"Siblings to {post.Id}: '{post.Title}' are...");
+            foreach (var sibling in context.FindSiblings(post, nameof(post.Blog)))
+            {
+                Console.WriteLine($"    {sibling.Id}: '{sibling.Title}'");
+            }
+-->
+[!code-csharp[UseFindSiblings](../../../../samples/core/Miscellaneous/NewInEFCore7/DbContextApiSample.cs?name=UseFindSiblings)]
+
+And the output:
+
+```output
+Siblings to 1: 'Announcing Entity Framework 7 Preview 7: Interceptors!' are...
+    5: 'Productivity comes to .NET MAUI in Visual Studio 2022'
+    6: 'Announcing .NET 7 Preview 7'
+    7: 'ASP.NET Core updates in .NET 7 Preview 7'
+```
+
+### `EntityEntry` for shared-type entity types
+
+EF Core can use the same CLR type for multiple different entity types. These are known as "shared-type entity types", and are often used to map a dictionary type with key/value pairs used for the properties of the entity type. For example, a `BuildMetadata` entity type can be defined without defining a dedicated CLR type:
+
+<!--
+            modelBuilder.SharedTypeEntity<Dictionary<string, object>>(
+                "BuildMetadata", b =>
+                {
+                    b.IndexerProperty<int>("Id");
+                    b.IndexerProperty<string>("Tag");
+                    b.IndexerProperty<Version>("Version");
+                    b.IndexerProperty<string>("Hash");
+                    b.IndexerProperty<bool>("Prerelease");
+                });
+-->
+[!code-csharp[BuildMetadata](../../../../samples/core/Miscellaneous/NewInEFCore7/DbContextApiSample.cs?name=BuildMetadata)]
+
+Notice that the shared-type entity type must be named - in this case, the name is `BuildMetadata`. These entity types are then accessed using a `DbSet` for the entity type which is obtained using the name. For example:
+
+<!--
+        public DbSet<Dictionary<string, object>> BuildMetadata
+            => Set<Dictionary<string, object>>("BuildMetadata");
+-->
+[!code-csharp[BuildMetadataSet](../../../../samples/core/Miscellaneous/NewInEFCore7/DbContextApiSample.cs?name=BuildMetadataSet)]
+
+This `DbSet` can be used to track entity instances:
+
+```csharp
+await context.BuildMetadata.AddAsync(
+    new Dictionary<string, object>
+    {
+        { "Tag", "v7.0.0-rc.1.22426.7" },
+        { "Version", new Version(7, 0, 0) },
+        { "Prerelease", true },
+        { "Hash", "dc0f3e8ef10eb1464b27f0fd4704f53c01226036" }
+    });
+```
+
+And execute queries:
+
+<!--
+            var builds = await context.BuildMetadata
+                .Where(metadata => !EF.Property<bool>(metadata, "Prerelease"))
+                .OrderBy(metadata => EF.Property<string>(metadata, "Tag"))
+                .ToListAsync();
+-->
+[!code-csharp[BuildMetadataQuery](../../../../samples/core/Miscellaneous/NewInEFCore7/DbContextApiSample.cs?name=BuildMetadataQuery)]
+
+Now, in EF7, there is also an `Entry` method on `DbSet` which can be used to obtain the state of an instance, _even if it is not yet tracked_. For example:
+
+<!--
+                var state = context.BuildMetadata.Entry(build).State;
+-->
+[!code-csharp[GetEntry](../../../../samples/core/Miscellaneous/NewInEFCore7/DbContextApiSample.cs?name=GetEntry)]
+
+### `ContextInitialized` is now logged as `Debug`
+
+In EF7, the <xref:Microsoft.EntityFrameworkCore.Diagnostics.CoreEventId.ContextInitialized> event is logged at the <xref:Microsoft.Extensions.Logging.LogLevel.Debug> level. For example:
+
+```output
+dbug: 10/7/2022 12:27:52.379 CoreEventId.ContextInitialized[10403] (Microsoft.EntityFrameworkCore.Infrastructure)
+      Entity Framework Core 7.0.0 initialized 'BlogsContext' using provider 'Microsoft.EntityFrameworkCore.SqlServer:7.0.0' with options: SensitiveDataLoggingEnabled using NetTopologySuite
+```
+
+In previous releases, it was logged at the <xref:Microsoft.Extensions.Logging.LogLevel.Information> level. For example:
+
+```output
+info: 10/7/2022 12:30:34.757 CoreEventId.ContextInitialized[10403] (Microsoft.EntityFrameworkCore.Infrastructure)
+      Entity Framework Core 7.0.0 initialized 'BlogsContext' using provider 'Microsoft.EntityFrameworkCore.SqlServer:7.0.0' with options: SensitiveDataLoggingEnabled using NetTopologySuite
+```
+
+If desired, the log level can be changed back to `Information`:
+
+<!--
+            optionsBuilder.ConfigureWarnings(
+                builder =>
+                {
+                    builder.Log((CoreEventId.ContextInitialized, LogLevel.Information));
+                });
+-->
+[!code-csharp[ContextInitializedLog](../../../../samples/core/Miscellaneous/NewInEFCore7/DbContextApiSample.cs?name=ContextInitializedLog)]
+
+### `IEntityEntryGraphIterator` is publicly usable
+
+In EF7, the <xref:Microsoft.EntityFrameworkCore.ChangeTracking.IEntityEntryGraphIterator> service can be used by applications. This is the service used internally when discovering a graph of entities to track, and also by <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.TrackGraph*>. Here's an example that iterates over all entities reachable from some starting entity:
+
+<!--
+        var blogEntry = context.ChangeTracker.Entries<Blog>().First();
+        var found = new HashSet<object>();
+        var iterator = context.GetService<IEntityEntryGraphIterator>();
+        iterator.TraverseGraph(new EntityEntryGraphNode<HashSet<object>>(blogEntry, found, null, null), node =>
+        {
+            if (node.NodeState.Contains(node.Entry.Entity))
+            {
+                return false;
+            }
+
+            Console.Write($"Found with '{node.Entry.Entity.GetType().Name}'");
+
+            if (node.InboundNavigation != null)
+            {
+                Console.Write($" by traversing '{node.InboundNavigation.Name}' from '{node.SourceEntry!.Entity.GetType().Name}'");
+            }
+
+            Console.WriteLine();
+
+            node.NodeState.Add(node.Entry.Entity);
+
+            return true;
+        });
+
+        Console.WriteLine();
+        Console.WriteLine($"Finished iterating. Found {found.Count} entities.");
+        Console.WriteLine();
+-->
+[!code-csharp[IEntityEntryGraphIterator](../../../../samples/core/Miscellaneous/NewInEFCore7/DbContextApiSample.cs?name=IEntityEntryGraphIterator)]
+
+Notice:
+
+- The iterator stops traversing from a given node when the callback delegate returns `false`. This example keeps track of visited entities and returns `false` when the entity has already been visited. This prevents infinite loops resulting from cycles in the graph.
+- The `EntityEntryGraphNode<TState>` object allows the state to be passed around without capturing it into the delegate.
+- For every node visited other than the first, the node it was discovered from and the navigation it was discovered via are passed to the callback.
+
+## Model building enhancements
+
+EF7 contains a variety of small improvements in model building.
+
+> [!TIP]
+> The code for samples in this section comes from [ModelBuildingSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs).
+
+### Indexes can be ascending or descending
+
+By default, EF Core creates ascending indexes. EF7 also supports the creation of descending indexes. For example:
+
+```csharp
+modelBuilder
+    .Entity<Post>()
+    .HasIndex(post => post.Title)
+    .IsDescending();
+```
+
+Or, using the `Index` mapping attribute:
+
+```csharp
+[Index(nameof(Title), AllDescending = true)]
+public class Post
+{
+    public int Id { get; set; }
+
+    [MaxLength(64)]
+    public string? Title { get; set; }
+}
+```
+
+This is rarely useful for indexes over a single column, since the database can use the same index for ordering in both directions. However, this is not the case for composite indexes over multiple columns where the order on each column can be important. EF Core supports this by allowing multiple columns to have different ordering defined for each column. For example:
+
+<!--
+            #region CompositeIndex
+            modelBuilder
+                .Entity<Blog>()
+                .HasIndex(blog => new { blog.Name, blog.Owner })
+                .IsDescending(false, true);
+            #endregion
+-->
+[!code-csharp[CompositeIndex](../../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs?name=CompositeIndex)]
+
+Or, using a mapping attribute:
+
+```csharp
+[Index(nameof(Name), nameof(Owner), IsDescending = new[] { false, true })]
+public class Blog
+{
+    public int Id { get; set; }
+
+    [MaxLength(64)]
+    public string? Name { get; set; }
+
+    [MaxLength(64)]
+    public string? Owner { get; set; }
+
+    public List<Post> Posts { get; } = new();
+}
+```
+
+This results in the following SQL when using SQL Server:
+
+```sql
+CREATE INDEX [IX_Blogs_Name_Owner] ON [Blogs] ([Name], [Owner] DESC);
+```
+
+Finally, multiple indexes can be created over the same ordered set of columns by giving the indexes names. For example:
+
+<!--
+            modelBuilder
+                .Entity<Blog>()
+                .HasIndex(blog => new { blog.Name, blog.Owner }, "IX_Blogs_Name_Owner_1")
+                .IsDescending(false, true);
+
+            modelBuilder
+                .Entity<Blog>()
+                .HasIndex(blog => new { blog.Name, blog.Owner }, "IX_Blogs_Name_Owner_2")
+                .IsDescending(true, true);
+-->
+[!code-csharp[TwoIndexes](../../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs?name=TwoIndexes)]
+
+Or, using mapping attributes:
+
+<!--
+    [Index(nameof(Name), nameof(Owner), IsDescending = new[] { false, true }, Name = "IX_Blogs_Name_Owner_1")]
+    [Index(nameof(Name), nameof(Owner), IsDescending = new[] { true, true }, Name = "IX_Blogs_Name_Owner_2")]
+    public class Blog
+    {
+        public int Id { get; set; }
+
+        [MaxLength(64)]
+        public string? Name { get; set; }
+
+        [MaxLength(64)]
+        public string? Owner { get; set; }
+
+        public List<Post> Posts { get; } = new();
+    }
+-->
+[!code-csharp[CompositeIndexByAttribute](../../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs?name=CompositeIndexByAttribute)]
+
+This generates the following SQL on SQL Server:
+
+```sql
+CREATE INDEX [IX_Blogs_Name_Owner_1] ON [Blogs] ([Name], [Owner] DESC);
+CREATE INDEX [IX_Blogs_Name_Owner_2] ON [Blogs] ([Name] DESC, [Owner] DESC);
+```
+
+### Mapping attribute for composite keys
+
+EF7 introduces a new mapping attribute (aka "data annotation") for specifying the primary key property or properties of any entity type. Unlike <xref:System.ComponentModel.DataAnnotations.KeyAttribute?displayProperty=nameWithType>, <xref:Microsoft.EntityFrameworkCore.PrimaryKeyAttribute> is placed on the entity type class rather than on the key property. For example:
+
+```csharp
+[PrimaryKey(nameof(PostKey))]
+public class Post
+{
+    public int PostKey { get; set; }
+}
+```
+
+This makes it a natural fit for defining composite keys:
+
+<!--
+    [PrimaryKey(nameof(PostId), nameof(CommentId))]
+    public class Comment
+    {
+        public int PostId { get; set; }
+        public int CommentId { get; set; }
+    }
+-->
+[!code-csharp[CompositePrimaryKey](../../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs?name=CompositePrimaryKey)]
+
+Defining the index on the class also means it can be used to specify private properties or fields as keys, even though these would usually be ignored when building the EF model. For example:
+
+```csharp
+[PrimaryKey(nameof(_id))]
+public class Tag
+{
+    private readonly int _id;
+}
+```
+
+### `DeleteBehavior` mapping attribute
+
+EF7 introduces a mapping attribute (aka "data annotation") to specify the <xref:Microsoft.EntityFrameworkCore.DeleteBehavior> for a relationship. For example, [required relationships](xref:core/modeling/relationships) are created with <xref:Microsoft.EntityFrameworkCore.DeleteBehavior.Cascade?displayProperty=nameWithType> by default. This can be changed to <xref:Microsoft.EntityFrameworkCore.DeleteBehavior.NoAction?displayProperty=nameWithType> by default using <xref:Microsoft.EntityFrameworkCore.DeleteBehaviorAttribute>:
+
+```csharp
+public class Post
+{
+    public int Id { get; set; }
+    public string? Title { get; set; }
+
+    [DeleteBehavior(DeleteBehavior.NoAction)]
+    public Blog Blog { get; set; } = null!;
+}
+```
+
+This will disable cascade deletes for the Blog-Posts relationship.
+
+### Properties mapped to different column names
+
+Some mapping patterns result in the same CLR property being mapped to a column in each of multiple different tables. EF7 allows these columns to have different names. For example, consider a simple inheritance hierarchy:
+
+<!--
+    public class Animal
+    {
+        public int Id { get; set; }
+        public string Breed { get; set; } = null!;
+    }
+
+    public class Cat : Animal
+    {
+        public string? EducationalLevel { get; set; }
+    }
+
+    public class Dog : Animal
+    {
+        public string? FavoriteToy { get; set; }
+    }
+-->
+[!code-csharp[Animals](../../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs?name=Animals)]
+
+With the TPT [inheritance mapping strategy](xref:core/modeling/inheritance), these types will be mapped to three tables. However, the primary key column in each table may have a different name. For example:
+
+```sql
+CREATE TABLE [Animals] (
+    [Id] int NOT NULL IDENTITY,
+    [Breed] nvarchar(max) NOT NULL,
+    CONSTRAINT [PK_Animals] PRIMARY KEY ([Id])
+);
+
+CREATE TABLE [Cats] (
+    [CatId] int NOT NULL,
+    [EducationalLevel] nvarchar(max) NULL,
+    CONSTRAINT [PK_Cats] PRIMARY KEY ([CatId]),
+    CONSTRAINT [FK_Cats_Animals_CatId] FOREIGN KEY ([CatId]) REFERENCES [Animals] ([Id]) ON DELETE CASCADE
+);
+
+CREATE TABLE [Dogs] (
+    [DogId] int NOT NULL,
+    [FavoriteToy] nvarchar(max) NULL,
+    CONSTRAINT [PK_Dogs] PRIMARY KEY ([DogId]),
+    CONSTRAINT [FK_Dogs_Animals_DogId] FOREIGN KEY ([DogId]) REFERENCES [Animals] ([Id]) ON DELETE CASCADE
+);
+```
+
+EF7 allows this mapping to be configured using a nested table builder:
+
+<!--
+            modelBuilder.Entity<Animal>().ToTable("Animals");
+
+            modelBuilder.Entity<Cat>()
+                .ToTable(
+                    "Cats",
+                    tableBuilder => tableBuilder.Property(cat => cat.Id).HasColumnName("CatId"));
+
+            modelBuilder.Entity<Dog>()
+                .ToTable(
+                    "Dogs",
+                    tableBuilder => tableBuilder.Property(dog => dog.Id).HasColumnName("DogId"));
+-->
+[!code-csharp[AnimalsTpt](../../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs?name=AnimalsTpt)]
+
+With the TPC inheritance mapping, the `Breed` property can also be mapped to different column names in different tables. For example, consider the following TPC tables:
+
+```sql
+CREATE TABLE [Cats] (
+    [CatId] int NOT NULL DEFAULT (NEXT VALUE FOR [AnimalSequence]),
+    [CatBreed] nvarchar(max) NOT NULL,
+    [EducationalLevel] nvarchar(max) NULL,
+    CONSTRAINT [PK_Cats] PRIMARY KEY ([CatId])
+);
+
+CREATE TABLE [Dogs] (
+    [DogId] int NOT NULL DEFAULT (NEXT VALUE FOR [AnimalSequence]),
+    [DogBreed] nvarchar(max) NOT NULL,
+    [FavoriteToy] nvarchar(max) NULL,
+    CONSTRAINT [PK_Dogs] PRIMARY KEY ([DogId])
+);
+```
+
+EF7 supports this table mapping:
+
+<!--
+            modelBuilder.Entity<Animal>().UseTpcMappingStrategy();
+
+            modelBuilder.Entity<Cat>()
+                .ToTable(
+                    "Cats",
+                    builder =>
+                    {
+                        builder.Property(cat => cat.Id).HasColumnName("CatId");
+                        builder.Property(cat => cat.Breed).HasColumnName("CatBreed");
+                    });
+
+            modelBuilder.Entity<Dog>()
+                .ToTable(
+                    "Dogs",
+                    builder =>
+                    {
+                        builder.Property(dog => dog.Id).HasColumnName("DogId");
+                        builder.Property(dog => dog.Breed).HasColumnName("DogBreed");
+                    });
+-->
+[!code-csharp[AnimalsTpc](../../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs?name=AnimalsTpc)]
+
+### Unidirectional many-to-many relationships
+
+EF7 supports [many-to-many relationships](xref:core/modeling/relationships/many-to-many) where one side or the other does not have a navigation property. For example, consider `Post` and `Tag` types:
+
+```csharp
+public class Post
+{
+    public int Id { get; set; }
+    public string? Title { get; set; }
+    public Blog Blog { get; set; } = null!;
+    public List<Tag> Tags { get; } = new();
+}
+```
+
+<!--
+    public class Tag
+    {
+        public int Id { get; set; }
+        public string TagName { get; set; } = null!;
+    }
+-->
+[!code-csharp[Tag](../../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs?name=Tag)]
+
+Notice that the `Post` type has a navigation property for a list of tags, but the `Tag` type does not have a navigation property for posts. In EF7, this can still be configured as a many-to-many relationship, allowing the same `Tag` object to be used for many different posts. For example:
+
+<!--
+            modelBuilder
+                .Entity<Post>()
+                .HasMany(post => post.Tags)
+                .WithMany();
+-->
+[!code-csharp[ManyToMany](../../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs?name=ManyToMany)]
+
+This results in mapping to the appropriate join table:
+
+```sql
+CREATE TABLE [Tags] (
+    [Id] int NOT NULL IDENTITY,
+    [TagName] nvarchar(max) NOT NULL,
+    CONSTRAINT [PK_Tags] PRIMARY KEY ([Id])
+);
+
+CREATE TABLE [Posts] (
+    [Id] int NOT NULL IDENTITY,
+    [Title] nvarchar(64) NULL,
+    [BlogId] int NOT NULL,
+    CONSTRAINT [PK_Posts] PRIMARY KEY ([Id]),
+    CONSTRAINT [FK_Posts_Blogs_BlogId] FOREIGN KEY ([BlogId]) REFERENCES [Blogs] ([Id])
+);
+
+CREATE TABLE [PostTag] (
+    [PostId] int NOT NULL,
+    [TagsId] int NOT NULL,
+    CONSTRAINT [PK_PostTag] PRIMARY KEY ([PostId], [TagsId]),
+    CONSTRAINT [FK_PostTag_Posts_PostId] FOREIGN KEY ([PostId]) REFERENCES [Posts] ([Id]) ON DELETE CASCADE,
+    CONSTRAINT [FK_PostTag_Tags_TagsId] FOREIGN KEY ([TagsId]) REFERENCES [Tags] ([Id]) ON DELETE CASCADE
+);
+```
+
+And the relationship can be used as a many-to-many in the normal way. For example, inserting some posts which share various tags from a common set:
+
+<!--
+            var tags = new Tag[] { new() { TagName = "Tag1" }, new() { TagName = "Tag2" }, new() { TagName = "Tag2" }, };
+
+            await context.AddRangeAsync(new Blog { Posts =
+            {
+                new Post { Tags = { tags[0], tags[1] } },
+                new Post { Tags = { tags[1], tags[0], tags[2] } },
+                new Post()
+            } });
+
+            await context.SaveChangesAsync();
+-->
+[!code-csharp[InsertPostsAndTags](../../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs?name=InsertPostsAndTags)]
+
+### Entity splitting
+
+Entity splitting maps a single entity type to multiple tables. For example, consider a database with three tables that hold customer data:
+
+- A `Customers` table for customer information
+- A `PhoneNumbers` table for the customer's phone number
+- A `Addresses` table for the customer's address
+
+Here are definitions for these tables in SQL Server:
+
+```sql
+CREATE TABLE [Customers] (
+    [Id] int NOT NULL IDENTITY,
+    [Name] nvarchar(max) NOT NULL,
+    CONSTRAINT [PK_Customers] PRIMARY KEY ([Id])
+);
+    
+CREATE TABLE [PhoneNumbers] (
+    [CustomerId] int NOT NULL,
+    [PhoneNumber] nvarchar(max) NULL,
+    CONSTRAINT [PK_PhoneNumbers] PRIMARY KEY ([CustomerId]),
+    CONSTRAINT [FK_PhoneNumbers_Customers_CustomerId] FOREIGN KEY ([CustomerId]) REFERENCES [Customers] ([Id]) ON DELETE CASCADE
+);
+
+CREATE TABLE [Addresses] (
+    [CustomerId] int NOT NULL,
+    [Street] nvarchar(max) NOT NULL,
+    [City] nvarchar(max) NOT NULL,
+    [PostCode] nvarchar(max) NULL,
+    [Country] nvarchar(max) NOT NULL,
+    CONSTRAINT [PK_Addresses] PRIMARY KEY ([CustomerId]),
+    CONSTRAINT [FK_Addresses_Customers_CustomerId] FOREIGN KEY ([CustomerId]) REFERENCES [Customers] ([Id]) ON DELETE CASCADE
+);
+```
+
+Each of these tables would typically be mapped to their own entity type, with relationships between the types. However, if all three tables are always used together, then it can be more convenient to map them all to a single entity type. For example:
+
+<!--
+    public class Customer
+    {
+        public Customer(string name, string street, string city, string? postCode, string country)
+        {
+            Name = name;
+            Street = street;
+            City = city;
+            PostCode = postCode;
+            Country = country;
+        }
+
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public string? PhoneNumber { get; set; }
+        public string Street { get; set; }
+        public string City { get; set; }
+        public string? PostCode { get; set; }
+        public string Country { get; set; }
+    }
+-->
+[!code-csharp[CombinedCustomer](../../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs?name=CombinedCustomer)]
+
+This is achieved in EF7 by calling `SplitToTable` for each split in the entity type. For example, the following code splits the `Customer` entity type to the `Customers`, `PhoneNumbers`, and `Addresses` tables shown above:
+
+<!--
+            modelBuilder.Entity<Customer>(
+                entityBuilder =>
+                {
+                    entityBuilder
+                        .ToTable("Customers")
+                        .SplitToTable(
+                            "PhoneNumbers",
+                            tableBuilder =>
+                            {
+                                tableBuilder.Property(customer => customer.Id).HasColumnName("CustomerId");
+                                tableBuilder.Property(customer => customer.PhoneNumber);
+                            })
+                        .SplitToTable(
+                            "Addresses",
+                            tableBuilder =>
+                            {
+                                tableBuilder.Property(customer => customer.Id).HasColumnName("CustomerId");
+                                tableBuilder.Property(customer => customer.Street);
+                                tableBuilder.Property(customer => customer.City);
+                                tableBuilder.Property(customer => customer.PostCode);
+                                tableBuilder.Property(customer => customer.Country);
+                            });
+                });
+-->
+[!code-csharp[EntitySplitting](../../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs?name=EntitySplitting)]
+
+Notice also that, if necessary, different primary key column names can be specified for each of the tables.
+
+### SQL Server UTF-8 strings
+
+SQL Server Unicode strings as represented by the [`nchar` and `nvarchar` data types](/sql/t-sql/data-types/nchar-and-nvarchar-transact-sql) are stored as [UTF-16](https://en.wikipedia.org/wiki/UTF-16). In addition, the [`char` and `varchar` data types](/sql/t-sql/data-types/char-and-varchar-transact-sql) are used to store non-Unicode strings with support for various [character sets](https://en.wikipedia.org/wiki/Extended_ASCII).
+
+Starting with SQL Server 2019, the `char` and `varchar` data types can be used to instead store Unicode strings with [UTF-8](https://en.wikipedia.org/wiki/UTF-8) encoding. The is achieved by setting one of the [UTF-8 collations](/sql/relational-databases/collations/collation-and-unicode-support). For example, the following code configures a variable length SQL Server UTF-8 string for the `CommentText` column:  
+
+<!--
+            modelBuilder
+                .Entity<Comment>()
+                .Property(comment => comment.CommentText)
+                .HasColumnType("varchar(max)")
+                .UseCollation("LATIN1_GENERAL_100_CI_AS_SC_UTF8");
+-->
+[!code-csharp[Utf8](../../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs?name=Utf8)]
+
+This configuration generates the following SQL Server column definition:
+
+```sql
+CREATE TABLE [Comment] (
+    [PostId] int NOT NULL,
+    [CommentId] int NOT NULL,
+    [CommentText] varchar(max) COLLATE LATIN1_GENERAL_100_CI_AS_SC_UTF8 NOT NULL,
+    CONSTRAINT [PK_Comment] PRIMARY KEY ([PostId], [CommentId])
+);
+ ```
+
+### Temporal tables support owned entities
+
+EF Core [SQL Server temporal tables](xref:core/what-is-new/ef-core-6.0/whatsnew#sql-server-temporal-tables) mapping has been enhanced in EF7 to support [table sharing](xref:core/modeling/table-splitting). Most notably, the default mapping for [owned single entities](xref:core/modeling/owned-entities) uses table sharing.
+
+For example, consider an owner entity type `Employee` and its owned entity type `EmployeeInfo`:
+
+<!--
+    public class Employee
+    {
+        public Guid EmployeeId { get; set; }
+        public string Name { get; set; } = null!;
+
+        public EmployeeInfo Info { get; set; } = null!;
+    }
+
+    public class EmployeeInfo
+    {
+        public string Position { get; set; } = null!;
+        public string Department { get; set; } = null!;
+        public string? Address { get; set; }
+        public decimal? AnnualSalary { get; set; }
+    }
+-->
+[!code-csharp[EmployeeAndEmployeeInfo](../../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs?name=EmployeeAndEmployeeInfo)]
+
+If these types are mapped to the same table, then in EF7 that table can be made a temporal table:
+
+<!--
+            modelBuilder
+                .Entity<Employee>()
+                .ToTable(
+                    "Employees",
+                    tableBuilder =>
+                    {
+                        tableBuilder.IsTemporal();
+                        tableBuilder.Property<DateTime>("PeriodStart").HasColumnName("PeriodStart");
+                        tableBuilder.Property<DateTime>("PeriodEnd").HasColumnName("PeriodEnd");
+                    })
+                .OwnsOne(
+                    employee => employee.Info,
+                    ownedBuilder => ownedBuilder.ToTable(
+                        "Employees",
+                        tableBuilder =>
+                        {
+                            tableBuilder.IsTemporal();
+                            tableBuilder.Property<DateTime>("PeriodStart").HasColumnName("PeriodStart");
+                            tableBuilder.Property<DateTime>("PeriodEnd").HasColumnName("PeriodEnd");
+                        }));
+-->
+
+[!code-csharp[OwnedTemporalTable](../../../../samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs?name=OwnedTemporalTable)]
+
+> [!NOTE]
+> Making this configuration easier is tracked by [Issue #29303](https://github.com/dotnet/efcore/issues/29303). Vote for this issue if it's something you would like to see implemented.
+
+## Improved value generation
+
+EF7 includes two significant improvements to the automatic generation of values for key properties.
+
+> [!TIP]
+> The code for samples in this section comes from [ValueGenerationSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore7/ValueGenerationSample.cs).
+
+### Value generation for DDD guarded types
+
+In domain-driven design (DDD), "guarded keys" can improve the type safety of key properties. This is achieved by wrapping the key type in another type which is specific to the use of the key. For example, the following code defines a `ProductId` type for product keys, and a `CategoryId` type for category keys.
+
+<!--
+    public readonly struct ProductId
+    {
+        public ProductId(int value) => Value = value;
+        public int Value { get; }
+    }
+
+    public readonly struct CategoryId
+    {
+        public CategoryId(int value) => Value = value;
+        public int Value { get; }
+    }
+-->
+[!code-csharp[GuardedKeys](../../../../samples/core/Miscellaneous/NewInEFCore7/ValueGenerationSample.cs?name=GuardedKeys)]
+
+These are then used in `Product` and `Category` entity types:
+
+<!--
+    public class Product
+    {
+        public Product(string name) => Name = name;
+        public ProductId Id { get; set; }
+        public string Name { get; set; }
+        public CategoryId CategoryId { get; set; }
+        public Category Category { get; set; } = null!;
+    }
+
+    public class Category
+    {
+        public Category(string name) => Name = name;
+        public CategoryId Id { get; set; }
+        public string Name { get; set; }
+        public List<Product> Products { get; } = new();
+    }
+-->
+[!code-csharp[ProductAndCategory](../../../../samples/core/Miscellaneous/NewInEFCore7/ValueGenerationSample.cs?name=ProductAndCategory)]
+
+This makes it impossible to accidentally assign the ID for a category to a product, or vice versa.
+
+> [!WARNING]
+> As with many DDD concepts, this improved type safety comes at the expense of additional code complexity. It is worth considering whether, for example, assigning a product ID to a category is something that is ever likely to happen. Keeping things simple may be overall more beneficial to the codebase.
+
+The guarded key types shown here both wrap `int` key values, which means integer values will be used in the mapped database tables. This is achieved by defining [value converters](xref:core/modeling/value-conversions) for the types:
+
+<!--
+        protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+        {
+            configurationBuilder.Properties<ProductId>().HaveConversion<ProductIdConverter>();
+            configurationBuilder.Properties<CategoryId>().HaveConversion<CategoryIdConverter>();
+        }
+
+        private class ProductIdConverter : ValueConverter<ProductId, int>
+        {
+            public ProductIdConverter()
+                : base(v => v.Value, v => new(v))
+            {
+            }
+        }
+
+        private class CategoryIdConverter : ValueConverter<CategoryId, int>
+        {
+            public CategoryIdConverter()
+                : base(v => v.Value, v => new(v))
+            {
+            }
+        }
+-->
+[!code-csharp[KeyConverters](../../../../samples/core/Miscellaneous/NewInEFCore7/ValueGenerationSample.cs?name=KeyConverters)]
+
+> [!NOTE]
+> The code here uses `struct` types. This means they have appropriate value-type semantics for use as keys. If `class` types are used instead, then they need to either override equality semantics or also specify a [value comparer](xref:core/modeling/value-comparers).
+
+In EF7, key types based on value converters can use automatically generated key values so long as the underlying type supports this. This is configured in the normal way using `ValueGeneratedOnAdd`:
+
+<!--
+            modelBuilder.Entity<Product>().Property(product => product.Id).ValueGeneratedOnAdd();
+            modelBuilder.Entity<Category>().Property(category => category.Id).ValueGeneratedOnAdd();
+-->
+[!code-csharp[ValueGeneratedOnAdd](../../../../samples/core/Miscellaneous/NewInEFCore7/ValueGenerationSample.cs?name=ValueGeneratedOnAdd)]
+
+By default, this results in `IDENTITY` columns when used with SQL Server:
+
+```sql
+CREATE TABLE [Categories] (
+    [Id] int NOT NULL IDENTITY,
+    [Name] nvarchar(max) NOT NULL,
+    CONSTRAINT [PK_Categories] PRIMARY KEY ([Id]));
+
+CREATE TABLE [Products] (
+    [Id] int NOT NULL IDENTITY,
+    [Name] nvarchar(max) NOT NULL,
+    [CategoryId] int NOT NULL,
+    CONSTRAINT [PK_Products] PRIMARY KEY ([Id]),
+    CONSTRAINT [FK_Products_Categories_CategoryId] FOREIGN KEY ([CategoryId]) REFERENCES [Categories] ([Id]) ON DELETE CASCADE);
+```
+
+Which are used in the normal way to generate key values when inserting entities:
+
+```sql
+MERGE [Categories] USING (
+VALUES (@p0, 0),
+(@p1, 1)) AS i ([Name], _Position) ON 1=0
+WHEN NOT MATCHED THEN
+INSERT ([Name])
+VALUES (i.[Name])
+OUTPUT INSERTED.[Id], i._Position;
+```
+
+### Sequence-based key generation for SQL Server
+
+EF Core supports key value generation using [SQL Server `IDENTITY` columns](/dotnet/api/microsoft.entityframeworkcore.sqlservermodelbuilderextensions.useidentitycolumns), or [a Hi-Lo pattern](/dotnet/api/microsoft.entityframeworkcore.sqlservermodelbuilderextensions.usehilo) based on blocks of keys generated by a database sequence. EF7 introduces support for a database sequence attached to the key's column default constraint. In its simplest form, this just requires telling EF Core to use a sequence for the key property:
+
+```csharp
+modelBuilder.Entity<Product>().Property(product => product.Id).UseSequence();
+```
+
+This results in a sequence being defined in the database:
+
+```sql
+CREATE SEQUENCE [ProductSequence] START WITH 1 INCREMENT BY 1 NO MINVALUE NO MAXVALUE NO CYCLE;
+```
+
+Which is then used in the key column default constraint:
+
+```sql
+CREATE TABLE [Products] (
+    [Id] int NOT NULL DEFAULT (NEXT VALUE FOR [ProductSequence]),
+    [Name] nvarchar(max) NOT NULL,
+    [CategoryId] int NOT NULL,
+    CONSTRAINT [PK_Products] PRIMARY KEY ([Id]),
+    CONSTRAINT [FK_Products_Categories_CategoryId] FOREIGN KEY ([CategoryId]) REFERENCES [Categories] ([Id]) ON DELETE CASCADE);
+```
+
+> [!NOTE]
+> This form of key generation is used by default for generated keys in entity type hierarchies using the [TPC mapping strategy](xref:core/modeling/inheritance).
+
+If desired, the sequence can be given a different name and schema. For example:
+
+<!--
+            modelBuilder
+                .Entity<Product>()
+                .Property(product => product.Id)
+                .UseSequence("ProductsSequence", "northwind");
+-->
+[!code-csharp[Sequence](../../../../samples/core/Miscellaneous/NewInEFCore7/ValueGenerationSample.cs?name=Sequence)]
+
+Further configuration of the sequence is formed by configuring it explicitly in the model. For example:
+
+<!--
+            modelBuilder
+                .HasSequence<int>("ProductsSequence", "northwind")
+                .StartsAt(1000)
+                .IncrementsBy(2);
+-->
+[!code-csharp[ConfigureSequence](../../../../samples/core/Miscellaneous/NewInEFCore7/ValueGenerationSample.cs?name=ConfigureSequence)]
+
+## Migrations tooling improvements
+
+EF7 includes two significant improvements when using the [EF Core Migrations command-line tools](xref:core/managing-schemas/migrations/index).
+
+### UseSqlServer etc. accept null
+
+It is very common to read a connection string from a configuration file and then pass that connection string to `UseSqlServer`, `UseSqlite`, or the equivalent method for another provider. For example:
+
+```csharp
+services.AddDbContext<BloggingContext>(options =>
+    options.UseSqlServer(Configuration.GetConnectionString("BloggingDatabase")));
+```
+
+It is also common to pass a connection string when [applying migrations](xref:core/managing-schemas/migrations/applying). For example:
+
+```text
+dotnet ef database update --connection "Server=(localdb)\mssqllocaldb;Database=MyAppDb"
+```
+
+Or when using a [Migrations bundle](xref:core/managing-schemas/migrations/applying#bundles).
+
+```dotnetcli
+./bundle.exe --connection "Server=(localdb)\mssqllocaldb;Database=MyAppDb"
+```
+
+In this case, even though the connection string read from configuration isn't used, the application startup code still attempts to read it from configuration and pass it to `UseSqlServer`. If the configuration is not available, then this results in passing null to `UseSqlServer`. In EF7, this is allowed, as long as the connection string is ultimately set later, such as by passing `--connection` to the command-line tool.
+
+> [!NOTE]
+> This change has been made for `UseSqlServer` and `UseSqlite`. For other providers, contact the provider maintainer to make an equivalent change if it has not yet been done for that provider.
+
+### Detect when tools are running
+
+EF Core runs application code when the [`dotnet-ef`](xref:core/cli/dotnet) or [PowerShell](xref:core/cli/powershell) commands are being used. Sometimes it may be necessary to detect this situation to prevent inappropriate code from being executed at design-time. For example, code that automatically applies migrations at startup should probably not do this at design-time. In EF7, this can be detected using the `EF.IsDesignTime` flag:
+
+```csharp
+if (!EF.IsDesignTime)
+{
+    await context.Database.MigrateAsync();
+}
+```
+
+EF Core sets the `IsDesignTime` to `true` when application code is running on behalf of tools.
+
+## Performance enhancements for proxies
+
+EF Core supports dynamically generated proxies for [lazy-loading](xref:core/querying/related-data/lazy) and [change-tracking](xref:core/change-tracking/change-detection#change-tracking-proxies). EF7 contains two performance improvements when using these proxies:
+
+- The proxy types are now created lazily. This means that the initial model building time when using proxies can be massively faster with EF7 than it was with EF Core 6.0.
+- Proxies can now be used with compiled models.
+
+Here are some performance results for a model with 449 entity types, 6390 properties, and 720 relationships.
+
+| Scenario                                                    | Method           |    Mean |    Error |   StdDev |
+|-------------------------------------------------------------|------------------|--------:|---------:|---------:|
+| EF Core 6.0 without proxies                                 | TimeToFirstQuery | 1.085 s | 0.0083 s | 0.0167 s |
+| EF Core 6.0 with change-tracking proxies                    | TimeToFirstQuery | 13.01 s | 0.2040 s | 0.4110 s |
+| EF Core 7.0 without proxies                                 | TimeToFirstQuery | 1.442 s | 0.0134 s | 0.0272 s |
+| EF Core 7.0 with change-tracking proxies                    | TimeToFirstQuery | 1.446 s | 0.0160 s | 0.0323 s |
+| EF Core 7.0 with change-tracking proxies and compiled model | TimeToFirstQuery | 0.162 s | 0.0062 s | 0.0125 s |
+
+So, in this case, a model with change-tracking proxies can be ready to execute the first query 80 times faster in EF7 than was possible with EF Core 6.0.
+
+## First-class Windows Forms data binding
+
+The Windows Forms team has been making some [great improvements to the Visual Studio Designer experience](https://devblogs.microsoft.com/dotnet/state-of-the-windows-forms-designer-for-net-applications/). This includes [new experiences for data binding](https://devblogs.microsoft.com/dotnet/databinding-with-the-oop-windows-forms-designer/) that integrates well with EF Core.
+
+In brief, the new experience provides Visual Studio U.I. for creating an <xref:System.Web.UI.WebControls.ObjectDataSource>:
+
+![Choose Category data source type](../../get-started/_static/winforms-choose-category-type.png)
+
+This can then be bound to an EF Core `DbSet` with some simple code:
+
+```csharp
+public partial class MainForm : Form
+{
+    private ProductsContext? dbContext;
+
+    public MainForm()
+    {
+        InitializeComponent();
+    }
+
+    protected override void OnLoad(EventArgs e)
+    {
+        base.OnLoad(e);
+
+        this.dbContext = new ProductsContext();
+
+        this.dbContext.Categories.Load();
+        this.categoryBindingSource.DataSource = dbContext.Categories.Local.ToBindingList();
+    }
+
+    protected override void OnClosing(CancelEventArgs e)
+    {
+        base.OnClosing(e);
+
+        this.dbContext?.Dispose();
+        this.dbContext = null;
+    }
+}
+```
+
+See [Getting Started with Windows Forms](xref:core/get-started/winforms) for a complete walkthrough and [downloadable WinForms sample application](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/WinForms).
diff --git a/entity-framework/core/what-is-new/ef-core-8.0/breaking-changes.md b/entity-framework/core/what-is-new/ef-core-8.0/breaking-changes.md
new file mode 100644
index 0000000000..4ff9378494
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-8.0/breaking-changes.md
@@ -0,0 +1,689 @@
+---
+title: Breaking changes in EF Core 8.0 (EF8) - EF Core
+description: Complete list of breaking changes introduced in Entity Framework Core 8.0 (EF8)
+author: SamMonoRT
+ms.date: 10/04/2024
+uid: core/what-is-new/ef-core-8.0/breaking-changes
+---
+
+# Breaking changes in EF Core 8 (EF8)
+
+This page documents API and behavior changes that have the potential to break existing applications updating from EF Core 7 to EF Core 8. Make sure to review earlier breaking changes if updating from an earlier version of EF Core:
+
+- [Breaking changes in EF Core 7](xref:core/what-is-new/ef-core-7.0/breaking-changes)
+- [Breaking changes in EF Core 6](xref:core/what-is-new/ef-core-6.0/breaking-changes)
+
+## Target Framework
+
+EF Core 8 targets .NET 8. Applications targeting older .NET, .NET Core, and .NET Framework versions will need to update to target .NET 8.
+
+## Summary
+
+| **Breaking change**                                                                                           | **Impact** |
+|:--------------------------------------------------------------------------------------------------------------|------------|
+| [`Contains` in LINQ queries may stop working on older SQL Server versions](#sqlserver-contains-compatibility) | High       |
+| [Possible query performance regressions around `Contains` in LINQ queries](#contains-perf-regression)         | High       |
+| [Enums in JSON are stored as ints instead of strings by default](#enums-as-ints)                              | High       |
+| [SQL Server `date` and `time` now scaffold to .NET `DateOnly` and `TimeOnly`](#sqlserver-date-time-only)      | Medium     |
+| [Boolean columns with a database generated value are no longer scaffolded as nullable](#scaffold-bools)       | Medium     |
+| [SQLite `Math` methods now translate to SQL](#sqlite-math)                                                    | Low        |
+| [ITypeBase replaces IEntityType in some APIs](#type-base)                                                     | Low        |
+| [ValueGenerator expressions must use public APIs](#value-converters)                                          | Low        |
+| [ExcludeFromMigrations no longer excludes other tables in a TPC hierarchy](#exclude-from-migrations)          | Low        |
+| [Non-shadow integer keys are persisted to Cosmos documents](#persist-to-cosmos)                               | Low        |
+| [Relational model is generated in the compiled model](#compiled-relational-model)                             | Low        |
+| [Scaffolding may generate different navigation names](#navigation-names)                                      | Low        |
+| [Discriminators now have a max length](#discriminators)                                                       | Low        |
+| [SQL Server key values are compared case-insensitively](#casekeys)                                            | Low        |
+| [Multiple AddDbContext calls are applied in different order](#AddDbContext)                                   | Low        |
+| [EntityTypeAttributeConventionBase replaced with TypeAttributeConventionBase](#attributeConventionBase)       | Low        |
+
+## High-impact changes
+
+<a name="sqlserver-contains-compatibility"></a>
+
+### `Contains` in LINQ queries may stop working on older SQL Server versions
+
+[Tracking Issue #13617](https://github.com/dotnet/efcore/issues/13617)
+
+#### Old behavior
+
+EF had specialized support for LINQ queries using `Contains` operator over a parameterized value list:
+
+```c#
+var names = new[] { "Blog1", "Blog2" };
+
+var blogs = await context.Blogs
+    .Where(b => names.Contains(b.Name))
+    .ToArrayAsync();
+```
+
+Before EF Core 8.0, EF inserted the parameterized values as constants into the SQL:
+
+```sql
+SELECT [b].[Id], [b].[Name]
+FROM [Blogs] AS [b]
+WHERE [b].[Name] IN (N'Blog1', N'Blog2')
+```
+
+#### New behavior
+
+Starting with EF Core 8.0, EF now generates SQL that is more efficient in many cases, but is unsupported on SQL Server 2014 and below:
+
+```sql
+SELECT [b].[Id], [b].[Name]
+FROM [Blogs] AS [b]
+WHERE [b].[Name] IN (
+    SELECT [n].[value]
+    FROM OPENJSON(@__names_0) WITH ([value] nvarchar(max) '$') AS [n]
+)
+```
+
+Note that newer SQL Server versions may be configured with an older [compatibility level](/sql/t-sql/statements/alter-database-transact-sql-compatibility-level), also making them incompatible with the new SQL. This can also occur with an Azure SQL database which was migrated from a previous on-premises SQL Server instance, carrying over the old compatibility level.
+
+#### Why
+
+The insertion of constant values into the SQL creates many performance problems, defeating query plan caching and causing unneeded evictions of other queries. The new EF Core 8.0 translation uses the SQL Server [`OPENJSON`](/sql/t-sql/functions/openjson-transact-sql) function to instead transfer the values as a JSON array. This solves the performance issues inherent in the previous technique; however, the `OPENJSON` function is unavailable in SQL Server 2014 and below.
+
+For more information about this change, [see this blog post](https://devblogs.microsoft.com/dotnet/announcing-ef8-preview-4/).
+
+#### Mitigations
+
+If your database is SQL Server 2016 (13.x) or newer, or if you're using Azure SQL, check the configured compatibility level of your database via the following command:
+
+```sql
+SELECT name, compatibility_level FROM sys.databases;
+```
+
+If the compatibility level is below 130 (SQL Server 2016), consider modifying it to a newer value ([documentation](/sql/t-sql/statements/alter-database-transact-sql-compatibility-level#best-practices-for-upgrading-database-compatibility-leve)).
+
+Otherwise, if your database version really is older than SQL Server 2016, or is set to an old compatibility level which you cannot change for some reason, you can configure EF to revert to the older, pre-8.0 SQL. If you're using EF 9, you can use the newly-introduced <xref:Microsoft.EntityFrameworkCore.Infrastructure.RelationalDbContextOptionsBuilder`2.TranslateParameterizedCollectionsToConstants*>:
+
+```c#
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    => optionsBuilder.UseSqlServer("<CONNECTION STRING>", o => o.TranslateParameterizedCollectionsToConstants())
+```
+
+If you're using EF 8, you can achieve the same effect when using SQL Server by configuring EF's SQL compatibility level:
+
+```c#
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    => optionsBuilder
+        .UseSqlServer(@"<CONNECTION STRING>", o => o.UseCompatibilityLevel(120));
+```
+
+<a name="contains-perf-regression"></a>
+
+### Possible query performance regressions around `Contains` in LINQ queries
+
+[Tracking Issue #32394](https://github.com/dotnet/efcore/issues/32394)
+
+#### Old behavior
+
+EF had specialized support for LINQ queries using `Contains` operator over a parameterized value list:
+
+```c#
+var names = new[] { "Blog1", "Blog2" };
+
+var blogs = await context.Blogs
+    .Where(b => names.Contains(b.Name))
+    .ToArrayAsync();
+```
+
+Before EF Core 8.0, EF inserted the parameterized values as constants into the SQL:
+
+```sql
+SELECT [b].[Id], [b].[Name]
+FROM [Blogs] AS [b]
+WHERE [b].[Name] IN (N'Blog1', N'Blog2')
+```
+
+#### New behavior
+
+Starting with EF Core 8.0, EF now generates the following:
+
+```sql
+SELECT [b].[Id], [b].[Name]
+FROM [Blogs] AS [b]
+WHERE [b].[Name] IN (
+    SELECT [n].[value]
+    FROM OPENJSON(@__names_0) WITH ([value] nvarchar(max) '$') AS [n]
+)
+```
+
+However, after the release of EF 8 it turned out that while the new SQL is more efficient for most cases, it can be dramatically less efficient in a minority of cases, even causing query timeouts in some cases.
+
+Please see [this comment](https://github.com/dotnet/efcore/issues/32394#issuecomment-2266634632) for a summary of the change in EF 8, the partial mitigations provided in EF 9, and the plan going forward for EF 10.
+
+#### Mitigations
+
+If you're using EF 9, you can use the newly-introduced <xref:Microsoft.EntityFrameworkCore.Infrastructure.RelationalDbContextOptionsBuilder`2.TranslateParameterizedCollectionsToConstants*> to revert the `Contains` translation for all queries back to the pre-8.0 behavior:
+
+```c#
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    => optionsBuilder.UseSqlServer("<CONNECTION STRING>", o => o.TranslateParameterizedCollectionsToConstants())
+```
+
+If you're using EF 8, you can achieve the same effect when using SQL Server by configuring EF's SQL compatibility level:
+
+```c#
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    => optionsBuilder
+        .UseSqlServer(@"<CONNECTION STRING>", o => o.UseCompatibilityLevel(120));
+```
+
+Finally, you can control the translation on a query-by-query basis using <xref:Microsoft.EntityFrameworkCore.EF.Constant*?displayProperty=nameWithType> as follows:
+
+```c#
+var blogs = await context.Blogs
+    .Where(b => EF.Constant(names).Contains(b.Name))
+    .ToArrayAsync();
+```
+
+<a name="enums-as-ints"></a>
+
+### Enums in JSON are stored as ints instead of strings by default
+
+[Tracking Issue #13617](https://github.com/dotnet/efcore/issues/31100)
+
+#### Old behavior
+
+In EF7, [enums mapped to JSON](xref:core/what-is-new/ef-core-7.0/whatsnew#json-columns) are, by default, stored as string values in the JSON document.
+
+#### New behavior
+
+Starting with EF Core 8.0, EF now, by default, maps enums to integer values in the JSON document.
+
+#### Why
+
+EF has always, by default, mapped enums to a numeric column in relational databases. Since EF supports queries where values from JSON interact with values from columns and parameters, it is important that the values in JSON match the values in the non-JSON column.
+
+#### Mitigations
+
+To continue using strings, configure the enum property with a conversion. For example:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    modelBuilder.Entity<User>().Property(e => e.Status).HasConversion<string>();
+}
+```
+
+Or, for all properties of the enum type::
+
+```csharp
+protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+{
+    configurationBuilder.Properties<StatusEnum>().HaveConversion<string>();
+}
+```
+
+## Medium-impact changes
+
+<a name="sqlserver-date-time-only"></a>
+
+### SQL Server `date` and `time` now scaffold to .NET `DateOnly` and `TimeOnly`
+
+[Tracking Issue #24507](https://github.com/dotnet/efcore/issues/24507)
+
+#### Old behavior
+
+Previously, when scaffolding a SQL Server database with `date` or `time` columns, EF would generate entity properties with types <xref:System.DateTime> and <xref:System.TimeSpan>.
+
+#### New behavior
+
+Starting with EF Core 8.0, `date` and `time` are scaffolded as <xref:System.DateOnly> and <xref:System.TimeOnly>.
+
+#### Why
+
+<xref:System.DateOnly> and <xref:System.TimeOnly> were introduced in .NET 6.0, and are a perfect match for mapping the database date and time types. <xref:System.DateTime> notably contains a time component that goes unused and can cause confusion when mapping it to `date`, and <xref:System.TimeSpan> represents a time interval - possibly including days - rather than a time of day at which an event occurs. Using the new types prevents bugs and confusion, and provides clarity of intent.
+
+#### Mitigations
+
+This change only affects users which regularly re-scaffold their database into an EF code model ("database-first" flow).
+
+It is recommended to react to this change by modifying your code to use the newly scaffolded <xref:System.DateOnly> and <xref:System.TimeOnly> types. However, if that isn't possible, you can edit the scaffolding templates to revert to the previous mapping. To do this, set up the templates as described on [this page](xref:core/managing-schemas/scaffolding/templates). Then, edit the `EntityType.t4` file, find where the entity properties get generated (search for `property.ClrType`), and change the code to the following:
+
+```c#
+        var clrType = property.GetColumnType() switch
+        {
+            "date" when property.ClrType == typeof(DateOnly) => typeof(DateTime),
+            "date" when property.ClrType == typeof(DateOnly?) => typeof(DateTime?),
+            "time" when property.ClrType == typeof(TimeOnly) => typeof(TimeSpan),
+            "time" when property.ClrType == typeof(TimeOnly?) => typeof(TimeSpan?),
+            _ => property.ClrType
+        };
+
+        usings.AddRange(code.GetRequiredUsings(clrType));
+
+        var needsNullable = Options.UseNullableReferenceTypes && property.IsNullable && !clrType.IsValueType;
+        var needsInitializer = Options.UseNullableReferenceTypes && !property.IsNullable && !clrType.IsValueType;
+#>
+    public <#= code.Reference(clrType) #><#= needsNullable ? "?" : "" #> <#= property.Name #> { get; set; }<#= needsInitializer ? " = null!;" : "" #>
+<#
+```
+
+<a name="scaffold-bools"></a>
+
+### Boolean columns with a database generated value are no longer scaffolded as nullable
+
+[Tracking Issue #15070](https://github.com/dotnet/efcore/issues/15070)
+
+#### Old behavior
+
+Previously, non-nullable `bool` columns with a database default constraint were scaffolded as nullable `bool?` properties.
+
+#### New behavior
+
+Starting with EF Core 8.0, non-nullable `bool` columns are always scaffolded as non-nullable properties.
+
+#### Why
+
+A `bool` property will not have its value sent to the database if that value is `false`, which is the CLR default. If the database has a default value of `true` for the column, then even though the value of the property is `false`, the value in the database ends up as `true`. However, in EF8, the sentinel used to determine whether a property has a value can be changed. This is done automatically for `bool` properties with a database generated value of `true`, which means that it is no longer necessary to scaffold the properties as nullable.
+
+#### Mitigations
+
+This change only affects users which regularly re-scaffold their database into an EF code model ("database-first" flow).
+
+It is recommended to react to this change by modifying your code to use the non-nullable bool property. However, if that isn't possible, you can edit the scaffolding templates to revert to the previous mapping. To do this, set up the templates as described on [this page](xref:core/managing-schemas/scaffolding/templates). Then, edit the `EntityType.t4` file, find where the entity properties get generated (search for `property.ClrType`), and change the code to the following:
+
+```c#
+#>
+        var propertyClrType = property.ClrType != typeof(bool)
+                              || (property.GetDefaultValueSql() == null && property.GetDefaultValue() != null)
+            ? property.ClrType
+            : typeof(bool?);
+#>
+    public <#= code.Reference(propertyClrType) #><#= needsNullable ? "?" : "" #> <#= property.Name #> { get; set; }<#= needsInitializer ? " = null!;" : "" #>
+<#
+<#
+```
+
+## Low-impact changes
+
+<a name="sqlite-math"></a>
+
+### SQLite `Math` methods now translate to SQL
+
+[Tracking Issue #18843](https://github.com/dotnet/efcore/issues/18843)
+
+#### Old Behavior
+
+Previously only the Abs, Max, Min, and Round methods on `Math` were translated to SQL. All other members would be evaluated on the client if they appeared in the final Select expression of a query.
+
+#### New behavior
+
+In EF Core 8.0, all `Math` methods with corresponding [SQLite math functions](https://sqlite.org/lang_mathfunc.html) are translated to SQL.
+
+These math functions have been enabled in the native SQLite library that we provide by default (through our dependency on the SQLitePCLRaw.bundle_e_sqlite3 NuGet package). They have also been enabled in the library provided by SQLitePCLRaw.bundle_e_sqlcipher. If you're using one of these libraries, your application should not be affected by this change.
+
+There is a chance, however, that applications including the native SQLite library by other means may not enable the math functions. In these cases, the `Math` methods will be translated to SQL and encounter *no such function* errors when executed.
+
+#### Why
+
+SQLite added built-in math functions in version 3.35.0. Even though they're disabled by default, they've become pervasive enough that we decided to provide default translations for them in our EF Core SQLite provider.
+
+We also collaborated with Eric Sink on the SQLitePCLRaw project to enable math functions in all of the native SQLite libraries provided as part of that project.
+
+#### Mitigations
+
+The simplest way to fix breaks is, when possible, to enable the math function is the native SQLite library by specifying the [SQLITE_ENABLE_MATH_FUNCTIONS](https://sqlite.org/compile.html#enable_math_functions) compile-time option.
+
+If you don't control compilation of the native library, you can also fix breaks by create the functions yourself at runtime using the [Microsoft.Data.Sqlite](/dotnet/standard/data/sqlite/user-defined-functions) APIs.
+
+```csharp
+sqliteConnection
+    .CreateFunction<double, double, double>(
+        "pow",
+        Math.Pow,
+        isDeterministic: true);
+```
+
+Alternatively, you can force client-evaluation by splitting the Select expression into two parts separated by `AsEnumerable`.
+
+```csharp
+// Before
+var query = dbContext.Cylinders
+    .Select(
+        c => new
+        {
+            Id = c.Id
+            // May throw "no such function: pow"
+            Volume = Math.PI * Math.Pow(c.Radius, 2) * c.Height
+        });
+
+// After
+var query = dbContext.Cylinders
+    // Select the properties you'll need from the database
+    .Select(
+        c => new
+        {
+            c.Id,
+            c.Radius,
+            c.Height
+        })
+    // Switch to client-eval
+    .AsEnumerable()
+    // Select the final results
+    .Select(
+        c => new
+        {
+            Id = c.Id,
+            Volume = Math.PI * Math.Pow(c.Radius, 2) * c.Height
+        });
+```
+
+<a name="type-base"></a>
+
+### ITypeBase replaces IEntityType in some APIs
+
+[Tracking Issue #13947](https://github.com/dotnet/efcore/issues/13947)
+
+#### Old behavior
+
+Previously, all mapped structural types were entity types.
+
+#### New behavior
+
+With the introduction of complex types in EF8, some APIs that were previously use an `IEntityType` now use `ITypeBase` so that the APIs can be used with either entity or complex types. This includes:
+
+- `IProperty.DeclaringEntityType` is now obsolete and `IProperty.DeclaringType` should be used instead.
+- `IEntityTypeIgnoredConvention` is now obsolete and `ITypeIgnoredConvention` should be used instead.
+- `IValueGeneratorSelector.Select` now accepts an `ITypeBase` which may be, but does not have to be an `IEntityType`.
+
+#### Why
+
+With the introduction of complex types in EF8, these APIs can be used with either `IEntityType` or `IComplexType`.
+
+#### Mitigations
+
+The old APIs are obsoleted, but will not be removed until EF10. Code should be updated to use the new APIs ASAP.
+
+<a name="value-converters"></a>
+
+### ValueConverter and ValueComparer expressions must use public APIs for the compiled model
+
+[Tracking Issue #24896](https://github.com/dotnet/efcore/issues/24896)
+
+#### Old behavior
+
+Previously, `ValueConverter` and `ValueComparer` definitions were not included in the compiled model, and so could contain arbitrary code.
+
+#### New behavior
+
+EF now extracts the expressions from the `ValueConverter` and `ValueComparer` objects and includes these C# in the compiled model. This means that these expressions must only use public API.
+
+#### Why
+
+The EF team is gradually moving more constructs into the compiled model to support using EF Core with AOT in the future.
+
+#### Mitigations
+
+Make the APIs used by the comparer public. For example, consider this simple converter:
+
+```csharp
+public class MyValueConverter : ValueConverter<string, byte[]>
+{
+    public MyValueConverter()
+        : base(v => ConvertToBytes(v), v => ConvertToString(v))
+    {
+    }
+
+    private static string ConvertToString(byte[] bytes)
+        => ""; // ... TODO: Conversion code
+
+    private static byte[] ConvertToBytes(string chars)
+        => Array.Empty<byte>(); // ... TODO: Conversion code
+}
+```
+
+To use this converter in a compiled model with EF8, the `ConvertToString` and `ConvertToBytes` methods must be made public. For example:
+
+```csharp
+public class MyValueConverter : ValueConverter<string, byte[]>
+{
+    public MyValueConverter()
+        : base(v => ConvertToBytes(v), v => ConvertToString(v))
+    {
+    }
+
+    public static string ConvertToString(byte[] bytes)
+        => ""; // ... TODO: Conversion code
+
+    public static byte[] ConvertToBytes(string chars)
+        => Array.Empty<byte>(); // ... TODO: Conversion code
+}
+```
+
+<a name="exclude-from-migrations"></a>
+
+### ExcludeFromMigrations no longer excludes other tables in a TPC hierarchy
+
+[Tracking Issue #30079](https://github.com/dotnet/efcore/issues/30079)
+
+#### Old behavior
+
+Previously, using `ExcludeFromMigrations` on a table in a TPC hierarchy would also exclude other tables in the hierarchy.
+
+#### New behavior
+
+Starting with EF Core 8.0, `ExcludeFromMigrations` does not impact other tables.
+
+#### Why
+
+The old behavior was a bug and prevented migrations from being used to manage hierarchies across projects.
+
+#### Mitigations
+
+Use `ExcludeFromMigrations` explicitly on any other table that should be excluded.<a name="exclude-from-migrations"></a>
+
+<a name="persist-to-cosmos"></a>
+
+### Non-shadow integer keys are persisted to Cosmos documents
+
+[Tracking Issue #31664](https://github.com/dotnet/efcore/issues/31664)
+
+#### Old behavior
+
+Previously, non-shadow integer properties that match the criteria to be a synthesized key property would not be persisted into the JSON document, but were instead re-synthesized on the way out.
+
+#### New behavior
+
+Starting with EF Core 8.0, these properties are now persisted.
+
+#### Why
+
+The old behavior was a bug and prevented properties that match the synthesized key criteria from being persisted to Cosmos.
+
+#### Mitigations
+
+[Exclude the property from the model](xref:core/modeling/entity-properties#included-and-excluded-properties) if its value should not be persisted.
+Additionally, you can disable this behavior entirely by setting `Microsoft.EntityFrameworkCore.Issue31664` AppContext switch to `true`, see [AppContext for library consumers](/dotnet/api/system.appcontext#ForConsumers) for more details.
+
+```C#
+AppContext.SetSwitch("Microsoft.EntityFrameworkCore.Issue31664", isEnabled: true);
+```
+
+<a name="compiled-relational-model"></a>
+
+### Relational model is generated in the compiled model
+
+[Tracking Issue #24896](https://github.com/dotnet/efcore/issues/24896)
+
+#### Old behavior
+
+Previously, the relational model was computed at run-time even when using a compiled model.
+
+#### New behavior
+
+Starting with EF Core 8.0, the relational model is part of the generated compiled model. However, for particularly large models the generated file may fail to compile.
+
+#### Why
+
+This was done to further improve startup time.
+
+#### Mitigations
+
+Edit the generated `*ModelBuilder.cs` file and remove the line `AddRuntimeAnnotation("Relational:RelationalModel", CreateRelationalModel());` as well as the method `CreateRelationalModel()`.
+
+<a name="navigation-names"></a>
+
+### Scaffolding may generate different navigation names
+
+[Tracking Issue #27832](https://github.com/dotnet/efcore/issues/27832)
+
+#### Old behavior
+
+Previously when scaffolding a `DbContext` and entity types from an existing database, the navigation names for relationships were sometimes derived from a common prefix of multiple foreign key column names.
+
+#### New behavior
+
+Starting with EF Core 8.0, common prefixes of column names from a composite foreign key are no longer used to generate navigation names.
+
+#### Why
+
+This is an obscure naming rule which sometimes generates very poor names like, `S`, `Student_`, or even just `_`. Without this rule, strange names are no longer generated, and the naming conventions for navigations are also made simpler, thereby making it easier to understand and predict which names will be generated.
+
+#### Mitigations
+
+The [EF Core Power Tools](https://github.com/ErikEJ/EFCorePowerTools/issues/2143) have an option to keep generating navigations in the old way. Alternatively, the code generated can be fully customized using [T4 templates](xref:core/managing-schemas/scaffolding/templates). This can be used to example the foreign key properties of scaffolding relationships and use whatever rule is appropriate for your code to generate the navigation names you need.
+
+<a name="discriminators"></a>
+
+### Discriminators now have a max length
+
+[Tracking Issue #10691](https://github.com/dotnet/efcore/issues/10691)
+
+#### Old behavior
+
+Previously, discriminator columns created for [TPH inheritance mapping](xref:core/modeling/inheritance) were configured as `nvarchar(max)` on SQL Server/Azure SQL, or the equivalent unbounded string type on other databases.
+
+#### New behavior
+
+Starting with EF Core 8.0, discriminator columns are created with a max length that covers all the known discriminator values. EF will generate a migration to make this change. However, if the discriminator column is constrained in some way -- for example, as part of an index -- then the `AlterColumn` created by Migrations may fail.
+
+#### Why
+
+`nvarchar(max)` columns are inefficient and unnecessary when the lengths of all possible values are known.
+
+#### Mitigations
+
+The column size can be made explicitly unbounded:
+
+```csharp
+modelBuilder.Entity<Foo>()
+    .Property<string>("Discriminator")
+    .HasMaxLength(-1);
+```
+
+<a name="casekeys"></a>
+
+### SQL Server key values are compared case-insensitively
+
+[Tracking Issue #27526](https://github.com/dotnet/efcore/issues/27526)
+
+#### Old behavior
+
+Previously, when tracking entities with string keys with the SQL Server/Azure SQL database providers, the key values were compared using the default .NET case-sensitive ordinal comparer.
+
+#### New behavior
+
+Starting with EF Core 8.0, SQL Server/Azure SQL string key values are compared using the default .NET case-insensitive ordinal comparer.
+
+#### Why
+
+By default, SQL Server uses case-insensitive comparisons when comparing foreign key values for matches to principal key values. This means when EF uses case-sensitive comparisons it may not connect a foreign key to a principal key when it should.
+
+#### Mitigations
+
+Case-sensitive comparisons can be used by setting a custom `ValueComparer`. For example:
+
+```csharp
+protected override void OnModelCreating(ModelBuilder modelBuilder)
+{
+    var comparer = new ValueComparer<string>(
+        (l, r) => string.Equals(l, r, StringComparison.Ordinal),
+        v => v.GetHashCode(),
+        v => v);
+
+    modelBuilder.Entity<Blog>()
+        .Property(e => e.Id)
+        .Metadata.SetValueComparer(comparer);
+
+    modelBuilder.Entity<Post>(
+        b =>
+        {
+            b.Property(e => e.Id).Metadata.SetValueComparer(comparer);
+            b.Property(e => e.BlogId).Metadata.SetValueComparer(comparer);
+        });
+}
+```
+
+<a name="AddDbContext"></a>
+
+### Multiple AddDbContext calls are applied in different order
+
+[Tracking Issue #32518](https://github.com/dotnet/efcore/issues/32518)
+
+#### Old behavior
+
+Previously, when multiple calls to `AddDbContext`, `AddDbContextPool`, `AddDbContextFactory` or `AddPooledDbContextFactory` were made with the same context type but conflicting configuration, the first one won.
+
+#### New behavior
+
+Starting with EF Core 8.0, the configuration from the last call will take precedence.
+
+#### Why
+
+This was changed to be consistent with the new method `ConfigureDbContext`, that enables configuration composability for non-conflicting configurations. See [DbContext configuration](xref:core/dbcontext-configuration/index#configuredbcontext) for more information.
+
+#### Mitigations
+
+If your application depends on the previous behavior where the first registration wins, you have several options:
+
+1. **Reorder your registrations**: Place the registration with the configuration you want to use last:
+
+   ```csharp
+   services.AddDbContext<MyContext>(options => 
+       options.UseSqlServer("connection1")); // This will be ignored now
+   
+   services.AddDbContext<MyContext>(options => 
+       options.UseSqlServer("connection2")); // This will be used
+   ```
+
+2. **Remove previous registrations**: If possible, remove the conflicting registration.
+
+3. **Use conditional registration**: Check if the service is already registered before adding:
+
+   ```csharp
+   if (!services.Any(d => d.ServiceType == typeof(DbContextOptions<MyContext>)))
+   {
+       services.AddDbContext<MyContext>(options => 
+           options.UseSqlServer("connection"));
+   }
+   ```
+
+4. **Use the new `ConfigureDbContext` method**: This allows you to configure options without registering the context itself. See [DbContext configuration](xref:core/dbcontext-configuration/index#configuredbcontext) for more information:
+
+   ```csharp
+   services.ConfigureDbContext<MyContext>(options => 
+       options.UseSqlServer("connection"));
+   
+   services.AddDbContext<MyContext>(); // Register the context without configuration
+   ```
+
+<a name="attributeConventionBase"></a>
+
+### EntityTypeAttributeConventionBase replaced with TypeAttributeConventionBase
+
+#### New behavior
+
+In EF Core 8.0 `EntityTypeAttributeConventionBase` was renamed to `TypeAttributeConventionBase`.
+
+#### Why
+
+`TypeAttributeConventionBase` represents the functionality better as it now can be used for complex types and entity types.
+
+#### Mitigations
+
+Replace `EntityTypeAttributeConventionBase` usages with `TypeAttributeConventionBase`.
diff --git a/entity-framework/core/what-is-new/ef-core-8.0/ef8.png b/entity-framework/core/what-is-new/ef-core-8.0/ef8.png
new file mode 100644
index 0000000000..bde992e580
Binary files /dev/null and b/entity-framework/core/what-is-new/ef-core-8.0/ef8.png differ
diff --git a/entity-framework/core/what-is-new/ef-core-8.0/familytree.png b/entity-framework/core/what-is-new/ef-core-8.0/familytree.png
new file mode 100644
index 0000000000..af17503202
Binary files /dev/null and b/entity-framework/core/what-is-new/ef-core-8.0/familytree.png differ
diff --git a/entity-framework/core/what-is-new/ef-core-8.0/plan.md b/entity-framework/core/what-is-new/ef-core-8.0/plan.md
new file mode 100644
index 0000000000..b6759734db
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-8.0/plan.md
@@ -0,0 +1,160 @@
+---
+title: Plan for Entity Framework Core 8
+description: The themes and features planned for EF Core 8
+author: SamMonoRT
+ms.date: 12/14/2022
+uid: core/what-is-new/ef-core-8.0/plan
+---
+
+# Plan for Entity Framework Core 8
+
+![EF8 Logo](ef8.png)
+
+As described in the [planning process](xref:core/what-is-new/release-planning), we have gathered input from stakeholders into a plan for Entity Framework Core 8 (EF Core 8) and other .NET Data Access work for the .NET 8 timeframe. For brevity, EF Core 8 is also referred to as just EF8.
+
+> [!IMPORTANT]
+> This plan is not a commitment; it will evolve as we continue to learn throughout the release. Some things not currently planned for EF8 may get pulled in. Some things currently planned for EF8 may get punted out.
+
+## General information
+
+EF Core 8 is the next release after EF Core 7 and is scheduled for release in November 2023, at the same time as .NET 8. There are no plans for an EF Core 7.1 release.
+
+### Supported platforms
+
+EF8 currently targets .NET 6. This will likely be updated to .NET 8 as we near the release. EF8 does not target any .NET Standard version; for more information see [the future of .NET Standard](https://devblogs.microsoft.com/dotnet/the-future-of-net-standard/). EF8 will not run on .NET Framework.
+
+EF8 will align with .NET 8 as a long-term support (LTS) release. See the [.NET support policy](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) for more information.
+
+### Breaking changes
+
+EF8 will contain a small number of [breaking changes](xref:core/what-is-new/ef-core-8.0/breaking-changes) as we continue to evolve both EF Core and the .NET platform. Our goal is to minimize breaking changes as much as possible without stagnating the platform.
+
+## Themes
+
+Large investments for EF8 and data access in .NET 8 fall under the following themes:
+
+- Highly requested features
+- Cloud native and devices
+- Performance
+- Visual tooling
+- Developer experience
+
+Each of these themes is described in detail below. The high-level status of each theme can be tracked in the [.NET Data Biweekly Updates](https://github.com/dotnet/efcore/issues/27185). Please comment on [GitHub Issue #26994](https://github.com/dotnet/efcore/issues/26994) with any feedback or suggestions.
+
+## Theme: Highly requested features
+
+As always, a major input into the [planning process](xref:core/what-is-new/release-planning) comes from [votes (👍) for features on GitHub](https://github.com/dotnet/efcore/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc). Based on these votes and user input, we plan to work on the following highly requested features for EF8.
+
+### JSON columns
+
+Tracked by [issues labeled with 'area-json' and 'consider-for-current-release'](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-json)
+
+Value proposition: Build on EF7 JSON support to further power the document/relational hybrid pattern.
+
+EF7 introduced mapping of [SQL Server JSON columns to aggregate types](xref:core/what-is-new/ef-core-7.0/whatsnew#json-columns) in the EF model, but with some limitations. In EF8, we plan to address many of these limitations, and also test and improve performance. In EF7, JSON mapping to aggregates is limited to SQL Server. In EF8, we plan to bring support to SQLite and work with the owners of other providers to align JSON columns support across all providers.
+
+### Value objects
+
+Tracked by [Issue #9906: Use C# structs or classes as value objects](https://github.com/dotnet/efcore/issues/9906)
+
+Value proposition: Applications can use DDD-style value objects in EF models.
+
+It was previously the team view that owned entities, intended for [aggregate support](https://www.martinfowler.com/bliki/DDD_Aggregate.html), would also be a reasonable approximation to [value objects](https://www.martinfowler.com/bliki/ValueObject.html). Experience has shown this not to be the case. Therefore, in EF8, we plan to introduce a better experience focused on the needs of value objects in domain-driven design. This approach will be based on value converters rather than owned entities.
+
+### SQL queries for unmapped types
+
+Tracked by [Issue #10753: Support raw SQL queries without defining an entity type for the result](https://github.com/dotnet/efcore/issues/10753)
+
+Value proposition: Applications can execute more types of SQL query without dropping down to ADO.NET or using third-party libraries.
+
+Currently SQL queries must return a type in the model or a scalar type. In EF8, we plan to allow SQL queries that directly return types that are not contained in the EF model.
+
+## Theme: Cloud native and devices
+
+EF Core is most often used in traditional ASP.NET Core web applications. However, EF Core is increasingly used in microservices and on mobile devices. These environments generally favor smaller application size, faster start-up times, and no reliance on dynamic code generation. We significantly improved [trimming for EF Core apps in EF7](https://github.com/dotnet/efcore/issues/29092), and we plan further investment in these areas for EF8.
+
+### AOT and trimming with EF Core
+
+Tracked by [issues labeled with 'area-aot' and 'consider-for-current-release'](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-aot)
+
+Value proposition: Small, fast-starting EF Core applications with no dynamic code generation.
+
+EF Core has several characteristics that are a challenge for trimmed, ahead-of-time (AOT) compiled applications:
+
+- Use of imperative application code and reflection to discover the EF model and mappings
+- Use of reflection and dynamically generated types for queries and change tracking
+- Dynamically generated code for imperatively constructed arbitrary LINQ queries
+
+In EF8, we plan to investigate and prototype these areas to find a way forward for AOT and trimming that retains the current EF Core user experience.
+
+### AOT and trimming for ADO.NET
+
+Value proposition: Low-level data access can be used in cloud native applications.
+
+Higher-level data access technologies such as EF Core make use of ADO.NET data providers, such as [Microsoft.Data.SqlClient](https://www.nuget.org/packages/Microsoft.Data.SqlClient), [Microsoft.Data.Sqlite](https://www.nuget.org/packages/Microsoft.Data.Sqlite), and [Npgsql](https://www.nuget.org/packages/Npgsql). For .NET 8, we will ensure that the Npgsql provider for PostgreSQL and the Microsoft.Data.Sqlite provider for SQLite are full working in trimmed and AOT-compiled applications. We will also work with the authors of other ADO.NET data providers to help make them AOT and trimming friendly.
+
+## Theme: Performance
+
+Great performance is a fundamental for all of .NET, including both EF Core and lower-level data access. Woodstar (see below) will be our primary performance push in the .NET 8 timeframe. However, we also plan to work on performance in some other areas, such as in JSON columns, as described above. In addition, the work on AOT and trimming (see above) has a strong relationship to performance.
+
+### Woodstar
+
+Tracked in the [.NET Data Lab repo](https://github.com/dotnet/datalab/)
+
+Value proposition: Fast, fully managed access to SQL Server and Azure SQL for .NET applications.
+
+[Microsoft.Data.SqlClient](https://www.nuget.org/packages/Microsoft.Data.SqlClient/) is a fully-featured ADO.NET database provider for SQL Server. It supports a broad range of SQL Server features on both .NET and .NET Framework. However, it is also a large and old codebase with many complex interactions between its behaviors. This makes it difficult to leverage newer .NET performance features such as Pipelines. It also has several performance issues (most notably for [reading large data](https://github.com/dotnet/SqlClient/issues/593)) that have proved very hard to fix.
+
+We plan to invest more heavily on Woodstar in the .NET 8 timeframe. Our tentative goal is to run the TechEmpower Fortunes benchmark using Woodstar by the end of the release.
+
+> [!IMPORTANT]
+> Investment in Microsoft.Data.SqlClient is not changing. It will continue to be the recommended way to connect to SQL Server and Azure SQL, both with and without EF Core. It will continue to support new SQL Server features as they are introduced.
+
+## Theme: Visual Tooling
+
+EF Core features powerful, cross-platform command line tooling for database migrations, reverse engineering, and more. In addition, the [EF Core Power Tools](https://marketplace.visualstudio.com/items?itemName=ErikEJ.EFCorePowerTools&ssr=false#overview) offer a visual experience for some of these things. However, EF Core is virtually absent from the default Visual Studio UI experience. In the .NET 8 timeframe, we plan to make EF Core tooling a built-in part of the Visual Studio experience.
+
+### First-class T4 templates in Visual Studio
+
+Value proposition: Leverage T4 templating across multiple areas in Visual Studio.
+
+EF7 introduced [T4 templates for scaffolding (reverse engineering) an EF model](xref:core/what-is-new/ef-core-7.0/whatsnew#custom-reverse-engineering-templates) from an existing database. However, editing T4 templates can be difficult without a good editor experience. In the .NET 8 timeframe, we plan to bring a better T4 editing experience to Visual Studio so that it can be used for both EF and other templates.
+
+### EF Core Database First in Visual Studio
+
+Value proposition: Out-of-the-box Database First tooling in Visual Studio.
+
+The [EF Core Power Tools](https://marketplace.visualstudio.com/items?itemName=ErikEJ.EFCorePowerTools&ssr=false#overview) offer a great visual experience for EF Core tooling. However, the Power Tools are not installed out-of-the-box with Visual Studio and so can be hard to discover. In the .NET 8 timeframe, we plan to make EF Core tooling easily discoverable in Visual Studio. The primary focus of this work will be scaffolding (reverse engineering) an EF model from an existing database, otherwise known as "Database First", but may also include other areas.
+
+## Theme: Developer experience
+
+Creating a great experience for developers has always been a primary driving force for the team. Almost everything in the themes outlined here above relates to this in some way. In addition, a large part of the work planned for EF8 involves improving the developer experience in many small ways across multiple areas.
+
+All the issues that we may potentially work on for EF8 are [tracked on GitHub by the 'consider-for-current-release' label](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release). We will reassess these issues throughout the release and move issues into the [8.0 milestone](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+milestone%3A8.0.0) as we commit to working on them. Make sure to vote for issues that are important to you (👍) so that we can use this information when deciding which issues to work on.
+
+EF Core GitHub issues are all assigned to one or more "areas". The queries below filter issues we are considering for EF8 by major areas:
+
+- [Queries](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-query)
+- [Model building and metadata](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-model-building)
+- [Change tracking](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-change-tracking)
+- [Performance](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-perf)
+- [Migrations](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-migrations)
+- [DbContext and related APIs](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-dbcontext)
+- [Tooling](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-tools)
+- [Azure Cosmos provider](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-cosmos)
+- [Model building conventions](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-conventions)
+- [Relational-specific mapping](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-relational-mapping)
+- [SQL Server provider](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-sqlserver)
+- [SaveChanges](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-save-changes)
+- [Model to database mapping](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-o/c-mapping)
+- [SQLite provider](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-sqlite)
+- [Scaffolding (reverse engineering)](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-scaffolding)
+- [Logging](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-logging)
+- [Dynamic proxies](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-proxies)
+- [Type mapping](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-type-mapping)
+- [ADO.NET SQLite provider](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-adonet-sqlite)
+- [Temporal tables](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+label%3Aconsider-for-current-release+label%3Aarea-temporal-tables)
+
+## Suggestions
+
+Your feedback on planning is important. Please comment on [GitHub Issue #29853](https://github.com/dotnet/efcore/issues/29853) with any feedback or general suggestions about the plan. The best way to indicate the importance of an issue is to vote (👍) for that [issue on GitHub](https://github.com/dotnet/efcore/issues). This data will then feed into the [planning process](xref:core/what-is-new/release-planning) for the next release.
diff --git a/entity-framework/core/what-is-new/ef-core-8.0/whatsnew.md b/entity-framework/core/what-is-new/ef-core-8.0/whatsnew.md
new file mode 100644
index 0000000000..dd15bba7e2
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-8.0/whatsnew.md
@@ -0,0 +1,2659 @@
+---
+title: What's New in EF Core 8
+description: Overview of new features in EF Core 8
+author: SamMonoRT
+ms.date: 11/13/2023
+uid: core/what-is-new/ef-core-8.0/whatsnew
+ms.custom: sfi-ropc-nochange
+---
+
+# What's New in EF Core 8
+
+EF Core 8.0 (EF8) was [released in November 2023](https://devblogs.microsoft.com/dotnet/announcing-ef8/) and is a Long Term Support (LTS) release. EF8 will be supported until November 10, 2026.
+
+> [!TIP]
+> You can run and debug into the samples by [downloading the sample code from GitHub](https://github.com/dotnet/EntityFramework.Docs). Each section links to the source code specific to that section.
+
+EF8 requires the [.NET 8 SDK](https://aka.ms/get-dotnet-8) to build and requires the .NET 8 runtime to run. EF8 will not run on earlier .NET versions, and will not run on .NET Framework.
+
+## Value objects using Complex Types
+
+Objects saved to the database can be split into three broad categories:
+
+- Objects that are unstructured and hold a single value. For example, `int`, `Guid`, `string`, `IPAddress`. These are (somewhat loosely) called "primitive types".
+- Objects that are structured to hold multiple values, and where the identity of the object is defined by a key value. For example, `Blog`, `Post`, `Customer`. These are called "entity types".
+- Objects that are structured to hold multiple values, but the object has no key defining identity. For example, `Address`, `Coordinate`.
+
+Prior to EF8, there was no good way to map the third type of object. [Owned types](xref:core/modeling/owned-entities) can be used, but since owned types are actually entity types, they have semantics based on a key value, even when that key value is hidden.
+
+EF8 now supports "Complex Types" to cover this third type of object. Complex type objects:
+
+- Are not identified or tracked by key value.
+- Must be defined as part of an entity type.  (In other words, you cannot have a `DbSet` of a complex type.)
+- Can be either .NET [value types](/dotnet/csharp/language-reference/builtin-types/value-types) or [reference types](/dotnet/csharp/language-reference/keywords/reference-types).
+- Instances can be shared by multiple properties.
+
+### Simple example
+
+For example, consider an `Address` type:
+
+<!--
+    public class Address
+    {
+        public required string Line1 { get; set; }
+        public string? Line2 { get; set; }
+        public required string City { get; set; }
+        public required string Country { get; set; }
+        public required string PostCode { get; set; }
+    }
+-->
+[!code-csharp[Address](../../../../samples/core/Miscellaneous/NewInEFCore8/ComplexTypesSample.cs?name=Address)]
+
+`Address` is then used in three places in a simple customer/orders model:
+
+<!--
+    public class Customer
+    {
+        public int Id { get; set; }
+        public required string Name { get; set; }
+        public required Address Address { get; set; }
+        public List<Order> Orders { get; } = new();
+    }
+
+    public class Order
+    {
+        public int Id { get; set; }
+        public required string Contents { get; set; }
+        public required Address ShippingAddress { get; set; }
+        public required Address BillingAddress { get; set; }
+        public Customer Customer { get; set; } = null!;
+    }
+-->
+[!code-csharp[CustomerOrders](../../../../samples/core/Miscellaneous/NewInEFCore8/ComplexTypesSample.cs?name=CustomerOrders)]
+
+Let's create and save a customer with their address:
+
+<!--
+        #region SaveCustomer
+        var customer = new Customer
+        {
+            Name = "Willow",
+            Address = new() { Line1 = "Barking Gate", City = "Walpole St Peter", Country = "UK", PostCode = "PE14 7AV" }
+        };
+
+        context.Add(customer);
+        await context.SaveChangesAsync();
+
+-->
+[!code-csharp[SaveCustomer](../../../../samples/core/Miscellaneous/NewInEFCore8/ComplexTypesSample.cs?name=SaveCustomer)]
+
+This results in the following row being inserted into the database:
+
+```sql
+INSERT INTO [Customers] ([Name], [Address_City], [Address_Country], [Address_Line1], [Address_Line2], [Address_PostCode])
+OUTPUT INSERTED.[Id]
+VALUES (@p0, @p1, @p2, @p3, @p4, @p5);
+```
+
+Notice that the complex types do not get their own tables. Instead, they are saved inline to columns of the `Customers` table. This matches the table sharing behavior of owned types.
+
+> [!NOTE]
+> We don't plan to allow complex types to be mapped to their own table. However, in a future release, we do plan to allow the complex type to be saved as a JSON document in a single column. Vote for [Issue #31252](https://github.com/dotnet/efcore/issues/31252) if this is important to you.
+
+Now let's say we want to ship an order to a customer and use the customer's address as both the default billing an shipping address. The natural way to do this is to copy the `Address` object from the `Customer` into the `Order`. For example:
+
+<!--
+        #region CreateOrder
+        customer.Orders.Add(
+            new Order { Contents = "Tesco Tasty Treats", BillingAddress = customer.Address, ShippingAddress = customer.Address, });
+
+        await context.SaveChangesAsync();
+
+-->
+[!code-csharp[CreateOrder](../../../../samples/core/Miscellaneous/NewInEFCore8/ComplexTypesSample.cs?name=CreateOrder)]
+
+With complex types, this works as expected, and the address is inserted into the `Orders` table:
+
+```sql
+INSERT INTO [Orders] ([Contents], [CustomerId],
+    [BillingAddress_City], [BillingAddress_Country], [BillingAddress_Line1], [BillingAddress_Line2], [BillingAddress_PostCode],
+    [ShippingAddress_City], [ShippingAddress_Country], [ShippingAddress_Line1], [ShippingAddress_Line2], [ShippingAddress_PostCode])
+OUTPUT INSERTED.[Id]
+VALUES (@p0, @p1, @p2, @p3, @p4, @p5, @p6, @p7, @p8, @p9, @p10, @p11);
+```
+
+So far you might be saying, "but I could do this with owned types!" However, the "entity type" semantics of owned types quickly get in the way. For example, running the code above with owned types results in a slew of warnings and then an error:
+
+```text
+warn: 8/20/2023 12:48:01.678 CoreEventId.DuplicateDependentEntityTypeInstanceWarning[10001] (Microsoft.EntityFrameworkCore.Update) 
+      The same entity is being tracked as different entity types 'Order.BillingAddress#Address' and 'Customer.Address#Address' with defining navigations. If a property value changes, it will result in two store changes, which might not be the desired outcome.
+warn: 8/20/2023 12:48:01.687 CoreEventId.DuplicateDependentEntityTypeInstanceWarning[10001] (Microsoft.EntityFrameworkCore.Update) 
+      The same entity is being tracked as different entity types 'Order.ShippingAddress#Address' and 'Customer.Address#Address' with defining navigations. If a property value changes, it will result in two store changes, which might not be the desired outcome.
+warn: 8/20/2023 12:48:01.687 CoreEventId.DuplicateDependentEntityTypeInstanceWarning[10001] (Microsoft.EntityFrameworkCore.Update)
+      The same entity is being tracked as different entity types 'Order.ShippingAddress#Address' and 'Order.BillingAddress#Address' with defining navigations. If a property value changes, it will result in two store changes, which might not be the desired outcome.
+fail: 8/20/2023 12:48:01.709 CoreEventId.SaveChangesFailed[10000] (Microsoft.EntityFrameworkCore.Update) 
+      An exception occurred in the database while saving changes for context type 'NewInEfCore8.ComplexTypesSample+CustomerContext'.
+      System.InvalidOperationException: Cannot save instance of 'Order.ShippingAddress#Address' because it is an owned entity without any reference to its owner. Owned entities can only be saved as part of an aggregate also including the owner entity.
+         at Microsoft.EntityFrameworkCore.ChangeTracking.Internal.InternalEntityEntry.PrepareToSave()
+```
+
+This is because a single instance of the `Address` entity type (with the same hidden key value) is being used for three _different_ entity instances. On the other hand, sharing the same instance between complex properties is allowed, and so the code works as expected when using complex types.
+
+### Configuration of complex types
+
+Complex types must be configured in the model using either [mapping attributes](xref:core/modeling/index#use-data-annotations-to-configure-a-model) or by calling [`ComplexProperty` API in `OnModelCreating`](xref:core/modeling/index#use-fluent-api-to-configure-a-model). Complex types are not discovered by convention.
+
+For example, the `Address` type can be configured using the <xref:System.ComponentModel.DataAnnotations.Schema.ComplexTypeAttribute>:
+
+```csharp
+[ComplexType]
+public class Address
+{
+    public required string Line1 { get; set; }
+    public string? Line2 { get; set; }
+    public required string City { get; set; }
+    public required string Country { get; set; }
+    public required string PostCode { get; set; }
+}
+```
+
+Or in `OnModelCreating`:
+
+<!--
+        #region ComplexTypeConfig
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Customer>()
+                .ComplexProperty(e => e.Address);
+
+            modelBuilder.Entity<Order>(b =>
+            {
+                b.ComplexProperty(e => e.BillingAddress);
+                b.ComplexProperty(e => e.ShippingAddress);
+            });
+        }
+-->
+[!code-csharp[ComplexTypeConfig](../../../../samples/core/Miscellaneous/NewInEFCore8/ComplexTypesSample.cs?name=ComplexTypeConfig)]
+
+### Mutability
+
+In the example above, we ended up with the same `Address` instance used in three places. This is allowed and doesn't cause any issues for EF Core when using complex types. However, sharing instances of the same reference type means that if a property value on the instance is modified, then that change will be reflected in all three usages. For example, following on from above, let's change `Line1` of the customer address and save the changes:
+
+<!--
+        #region ChangeSharedAddress
+        customer.Address.Line1 = "Peacock Lodge";
+        await context.SaveChangesAsync();
+-->
+[!code-csharp[ChangeSharedAddress](../../../../samples/core/Miscellaneous/NewInEFCore8/ComplexTypesSample.cs?name=ChangeSharedAddress)]
+
+This results in the following update to the database when using SQL Server:
+
+```sql
+UPDATE [Customers] SET [Address_Line1] = @p0
+OUTPUT 1
+WHERE [Id] = @p1;
+UPDATE [Orders] SET [BillingAddress_Line1] = @p2, [ShippingAddress_Line1] = @p3
+OUTPUT 1
+WHERE [Id] = @p4;
+```
+
+Notice that all three `Line1` columns have changed, since they are all sharing the same instance. This is usually not what we want.
+
+> [!TIP]
+> If order addresses should change automatically when the customer address changes, then consider mapping the address as an entity type. `Order` and `Customer` can then safely reference the same address instance (which is now identified by a key) via a navigation property.
+
+A good way to deal with issues like this is to make the type immutable. Indeed, this immutability is often natural when a type is a good candidate for being a complex type. For example, it usually makes sense to supply a complex new `Address` object rather than to just mutate, say, the country while leaving the rest the same.
+
+Both reference and value types can be made immutable. We'll look at some examples in the following sections.
+
+### Reference types as complex types
+
+#### Immutable class
+
+We used a simple, mutable `class` in the example above. To prevent the issues with accidental mutation described above, we can make the class immutable. For example:
+
+```csharp
+public class Address
+{
+    public Address(string line1, string? line2, string city, string country, string postCode)
+    {
+        Line1 = line1;
+        Line2 = line2;
+        City = city;
+        Country = country;
+        PostCode = postCode;
+    }
+
+    public string Line1 { get; }
+    public string? Line2 { get; }
+    public string City { get; }
+    public string Country { get; }
+    public string PostCode { get; }
+}
+```
+
+> [!TIP]
+> With C# 12 or above, this class definition can be simplified using a primary constructor:
+>
+> ```csharp
+> public class Address(string line1, string? line2, string city, string country, string postCode)
+> {
+>     public string Line1 { get; } = line1;
+>     public string? Line2 { get; } = line2;
+>     public string City { get; } = city;
+>     public string Country { get; } = country;
+>     public string PostCode { get; } = postCode;
+> }
+> ```
+
+It is now not possible to change the `Line1` value on an existing address. Instead, we need to create a new instance with the changed value. For example:
+
+<!--
+        #region ChangeImmutableAddress
+        var currentAddress = customer.Address;
+        customer.Address = new Address(
+            "Peacock Lodge", currentAddress.Line2, currentAddress.City, currentAddress.Country, currentAddress.PostCode);
+
+        await context.SaveChangesAsync();
+-->
+[!code-csharp[ChangeImmutableAddress](../../../../samples/core/Miscellaneous/NewInEFCore8/ImmutableComplexTypesSample.cs?name=ChangeImmutableAddress)]
+
+This time the call to `SaveChangesAsync` only updates the customer address:
+
+```sql
+UPDATE [Customers] SET [Address_Line1] = @p0
+OUTPUT 1
+WHERE [Id] = @p1;
+```
+
+Note that even though the Address object is immutable, and the entire object has been changed, EF is still tracking changes to the individual properties, so only the columns with changed values are updated.
+
+#### Immutable record
+
+C# 9 introduced [record types](/dotnet/csharp/language-reference/builtin-types/record), which makes creating and using immutable objects easier. For example, the `Address` object can be made a record type:
+
+```csharp
+public record Address
+{
+    public Address(string line1, string? line2, string city, string country, string postCode)
+    {
+        Line1 = line1;
+        Line2 = line2;
+        City = city;
+        Country = country;
+        PostCode = postCode;
+    }
+
+    public string Line1 { get; init; }
+    public string? Line2 { get; init; }
+    public string City { get; init; }
+    public string Country { get; init; }
+    public string PostCode { get; init; }
+}
+```
+
+> [!TIP]
+> This record definition can be simplified using a primary constructor:
+>
+> ```csharp
+> public record Address(string Line1, string? Line2, string City, string Country, string PostCode);
+> ```
+
+Replacing the mutable object and calling `SaveChanges` now requires less code:
+
+<!--
+        #region ChangeImmutableRecord
+        customer.Address = customer.Address with { Line1 = "Peacock Lodge" };
+
+        await context.SaveChangesAsync();
+-->
+[!code-csharp[ChangeImmutableRecord](../../../../samples/core/Miscellaneous/NewInEFCore8/RecordComplexTypesSample.cs?name=ChangeImmutableRecord)]
+
+### Value types as complex types
+
+#### Mutable struct
+
+A simple mutable [value type](/dotnet/csharp/language-reference/builtin-types/value-types) can be used as a complex type. For example, `Address` can be defined as a `struct` in C#:
+
+<!--
+    #region AddressStruct
+    public struct Address
+    {
+        public string Line1 { get; set; }
+        public string? Line2 { get; set; }
+        public string City { get; set; }
+        public string Country { get; set; }
+        public string PostCode { get; set; }
+    }
+-->
+[!code-csharp[AddressStruct](../../../../samples/core/Miscellaneous/NewInEFCore8/StructComplexTypesSample.cs?name=AddressStruct)]
+
+Assigning the customer `Address` object to the shipping and billing `Address` properties results in each property getting a copy of the `Address`, since this is how value types work. This means that modifying the `Address` on the customer will not change the shipping or billing `Address` instances, so mutable structs don't have the same instance-sharing issues that happen with mutable classes.
+
+However, [mutable structs are generally discouraged in C#](/archive/blogs/ericlippert/mutating-readonly-structs), so think very carefully before using them.
+
+#### Immutable struct
+
+Immutable structs work well as complex types, just like immutable classes do. For example, `Address` can be defined such that it can not be modified:
+
+<!--
+    #region AddressImmutableStruct
+    public readonly struct Address(string line1, string? line2, string city, string country, string postCode)
+    {
+        public string Line1 { get; } = line1;
+        public string? Line2 { get; } = line2;
+        public string City { get; } = city;
+        public string Country { get; } = country;
+        public string PostCode { get; } = postCode;
+    }
+-->
+[!code-csharp[AddressImmutableStruct](../../../../samples/core/Miscellaneous/NewInEFCore8/ImmutableStructComplexTypesSample.cs?name=AddressImmutableStruct)]
+
+The code for changing the address now looks the same as when using immutable class:
+
+<!--
+        #region UpdateImmutableStruct
+        var currentAddress = customer.Address;
+        customer.Address = new Address(
+            "Peacock Lodge", currentAddress.Line2, currentAddress.City, currentAddress.Country, currentAddress.PostCode);
+
+        await context.SaveChangesAsync();
+-->
+[!code-csharp[UpdateImmutableStruct](../../../../samples/core/Miscellaneous/NewInEFCore8/ImmutableStructComplexTypesSample.cs?name=UpdateImmutableStruct)]
+
+#### Immutable struct record
+
+C# 10 introduced `struct record` types, which makes it easy to create and work with immutable struct records like it is with immutable class records. For example, we can define `Address` as an immutable struct record:
+
+<!--
+    #region RecordStructAddress
+    public readonly record struct Address(string Line1, string? Line2, string City, string Country, string PostCode);
+-->
+[!code-csharp[RecordStructAddress](../../../../samples/core/Miscellaneous/NewInEFCore8/RecordComplexTypesSample.cs?name=RecordStructAddress)]
+
+The code for changing the address now looks the same as when using immutable class record:
+
+<!--
+        #region ChangeImmutableRecord
+        customer.Address = customer.Address with { Line1 = "Peacock Lodge" };
+
+        await context.SaveChangesAsync();
+-->
+[!code-csharp[ChangeImmutableRecord](../../../../samples/core/Miscellaneous/NewInEFCore8/RecordComplexTypesSample.cs?name=ChangeImmutableRecord)]
+
+### Nested complex types
+
+A complex type can contain properties of other complex types. For example, let's use our `Address` complex type from above together with a `PhoneNumber` complex type, and nest them both inside another complex type:
+
+<!--
+    #region NestedComplexTypes
+    public record Address(string Line1, string? Line2, string City, string Country, string PostCode);
+
+    public record PhoneNumber(int CountryCode, long Number);
+
+    public record Contact
+    {
+        public required Address Address { get; init; }
+        public required PhoneNumber HomePhone { get; init; }
+        public required PhoneNumber WorkPhone { get; init; }
+        public required PhoneNumber MobilePhone { get; init; }
+    }
+-->
+[!code-csharp[NestedComplexTypes](../../../../samples/core/Miscellaneous/NewInEFCore8/NestedComplexTypesSample.cs?name=NestedComplexTypes)]
+
+We're using immutable records here, since these are a good match for the semantics of our complex types, but nesting of complex types can be done with any flavor of .NET type.
+
+> [!NOTE]
+> We're not using a primary constructor for the `Contact` type because EF Core does not yet support constructor injection of complex type values. Vote for [Issue #31621](https://github.com/dotnet/efcore/issues/31621) if this is important to you.
+
+We will add `Contact` as a property of the `Customer`:
+
+<!--
+    #region CustomerWithContact
+    public class Customer
+    {
+        public int Id { get; set; }
+        public required string Name { get; set; }
+        public required Contact Contact { get; set; }
+        public List<Order> Orders { get; } = new();
+    }
+-->
+[!code-csharp[CustomerWithContact](../../../../samples/core/Miscellaneous/NewInEFCore8/NestedComplexTypesSample.cs?name=CustomerWithContact)]
+
+And `PhoneNumber` as properties of the `Order`:
+
+<!--
+    #region OrderWithPhone
+    public class Order
+    {
+        public int Id { get; set; }
+        public required string Contents { get; set; }
+        public required PhoneNumber ContactPhone { get; set; }
+        public required Address ShippingAddress { get; set; }
+        public required Address BillingAddress { get; set; }
+        public Customer Customer { get; set; } = null!;
+    }
+-->
+[!code-csharp[OrderWithPhone](../../../../samples/core/Miscellaneous/NewInEFCore8/NestedComplexTypesSample.cs?name=OrderWithPhone)]
+
+Configuration of nested complex types can again be achieved using <xref:System.ComponentModel.DataAnnotations.Schema.ComplexTypeAttribute>:
+
+```csharp
+[ComplexType]
+public record Address(string Line1, string? Line2, string City, string Country, string PostCode);
+
+[ComplexType]
+public record PhoneNumber(int CountryCode, long Number);
+
+[ComplexType]
+public record Contact
+{
+    public required Address Address { get; init; }
+    public required PhoneNumber HomePhone { get; init; }
+    public required PhoneNumber WorkPhone { get; init; }
+    public required PhoneNumber MobilePhone { get; init; }
+}
+```
+
+Or in `OnModelCreating`:
+
+<!--
+        #region ConfigureNestedTypes
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Customer>(
+                b =>
+                {
+                    b.ComplexProperty(
+                        e => e.Contact,
+                        b =>
+                        {
+                            b.ComplexProperty(e => e.Address);
+                            b.ComplexProperty(e => e.HomePhone);
+                            b.ComplexProperty(e => e.WorkPhone);
+                            b.ComplexProperty(e => e.MobilePhone);
+                        });
+                });
+
+            modelBuilder.Entity<Order>(
+                b =>
+                {
+                    b.ComplexProperty(e => e.ContactPhone);
+                    b.ComplexProperty(e => e.BillingAddress);
+                    b.ComplexProperty(e => e.ShippingAddress);
+                });
+        }
+-->
+[!code-csharp[ConfigureNestedTypes](../../../../samples/core/Miscellaneous/NewInEFCore8/NestedComplexTypesSample.cs?name=ConfigureNestedTypes)]
+
+### Queries
+
+Properties of complex types on entity types are treated like any other non-navigation property of the entity type. This means that they are always loaded when the entity type is loaded. This is also true of any nested complex type properties. For example, querying for a customer:
+
+<!--
+        #region QueryCustomer
+        var customer = await context.Customers.FirstAsync(e => e.Id == customerId);
+-->
+[!code-csharp[QueryCustomer](../../../../samples/core/Miscellaneous/NewInEFCore8/NestedComplexTypesSample.cs?name=QueryCustomer)]
+
+Is translated to the following SQL when using SQL Server:
+
+```sql
+SELECT TOP(1) [c].[Id], [c].[Name], [c].[Contact_Address_City], [c].[Contact_Address_Country],
+    [c].[Contact_Address_Line1], [c].[Contact_Address_Line2], [c].[Contact_Address_PostCode],
+    [c].[Contact_HomePhone_CountryCode], [c].[Contact_HomePhone_Number], [c].[Contact_MobilePhone_CountryCode],
+    [c].[Contact_MobilePhone_Number], [c].[Contact_WorkPhone_CountryCode], [c].[Contact_WorkPhone_Number]
+FROM [Customers] AS [c]
+WHERE [c].[Id] = @__customerId_0
+```
+
+Notice two things from this SQL:
+
+- Everything is returned to populate the customer _and_ all the nested `Contact`, `Address`, and `PhoneNumber` complex types.
+- All the complex type values are stored as columns in the table for the entity type. Complex types are never mapped to separate tables.
+
+#### Projections
+
+Complex types can be projected from a query. For example, selecting just the shipping address from an order:
+
+<!--
+        #region QueryShippingAddress
+        var shippingAddress = await context.Orders
+            .Where(e => e.Id == orderId)
+            .Select(e => e.ShippingAddress)
+            .SingleAsync();
+-->
+[!code-csharp[QueryShippingAddress](../../../../samples/core/Miscellaneous/NewInEFCore8/NestedComplexTypesSample.cs?name=QueryShippingAddress)]
+
+This translates to the following when using SQL Server:
+
+```sql
+SELECT TOP(2) [o].[ShippingAddress_City], [o].[ShippingAddress_Country], [o].[ShippingAddress_Line1],
+    [o].[ShippingAddress_Line2], [o].[ShippingAddress_PostCode]
+FROM [Orders] AS [o]
+WHERE [o].[Id] = @__orderId_0
+```
+
+Note that projections of complex types cannot be tracked, since complex type objects have no identity to use for tracking.
+
+### Use in predicates
+
+Members of complex types can be used in predicates. For example, finding all the orders going to a certain city:
+
+<!--
+        #region QueryOrdersInCity
+        var city = "Walpole St Peter";
+        var walpoleOrders = await context.Orders.Where(e => e.ShippingAddress.City == city).ToListAsync();
+-->
+[!code-csharp[QueryOrdersInCity](../../../../samples/core/Miscellaneous/NewInEFCore8/NestedComplexTypesSample.cs?name=QueryOrdersInCity)]
+
+Which translates to the following SQL on SQL Server:
+
+```sql
+SELECT [o].[Id], [o].[Contents], [o].[CustomerId], [o].[BillingAddress_City], [o].[BillingAddress_Country],
+    [o].[BillingAddress_Line1], [o].[BillingAddress_Line2], [o].[BillingAddress_PostCode],
+    [o].[ContactPhone_CountryCode], [o].[ContactPhone_Number], [o].[ShippingAddress_City],
+    [o].[ShippingAddress_Country], [o].[ShippingAddress_Line1], [o].[ShippingAddress_Line2],
+    [o].[ShippingAddress_PostCode]
+FROM [Orders] AS [o]
+WHERE [o].[ShippingAddress_City] = @__city_0
+```
+
+A full complex type instance can also be used in predicates. For example, finding all customers with a given phone number:
+
+<!--
+        #region QueryWithPhoneNumber
+        var phoneNumber = new PhoneNumber(44, 7777555777);
+        var customersWithNumber = await context.Customers
+            .Where(
+                e => e.Contact.MobilePhone == phoneNumber
+                     || e.Contact.WorkPhone == phoneNumber
+                     || e.Contact.HomePhone == phoneNumber)
+            .ToListAsync();
+-->
+[!code-csharp[QueryWithPhoneNumber](../../../../samples/core/Miscellaneous/NewInEFCore8/NestedComplexTypesSample.cs?name=QueryWithPhoneNumber)]
+
+This translates to the following SQL when using SQL Server:
+
+```sql
+SELECT [c].[Id], [c].[Name], [c].[Contact_Address_City], [c].[Contact_Address_Country], [c].[Contact_Address_Line1],
+     [c].[Contact_Address_Line2], [c].[Contact_Address_PostCode], [c].[Contact_HomePhone_CountryCode],
+     [c].[Contact_HomePhone_Number], [c].[Contact_MobilePhone_CountryCode], [c].[Contact_MobilePhone_Number],
+     [c].[Contact_WorkPhone_CountryCode], [c].[Contact_WorkPhone_Number]
+FROM [Customers] AS [c]
+WHERE ([c].[Contact_MobilePhone_CountryCode] = @__entity_equality_phoneNumber_0_CountryCode
+    AND [c].[Contact_MobilePhone_Number] = @__entity_equality_phoneNumber_0_Number)
+OR ([c].[Contact_WorkPhone_CountryCode] = @__entity_equality_phoneNumber_0_CountryCode
+    AND [c].[Contact_WorkPhone_Number] = @__entity_equality_phoneNumber_0_Number)
+OR ([c].[Contact_HomePhone_CountryCode] = @__entity_equality_phoneNumber_0_CountryCode
+    AND [c].[Contact_HomePhone_Number] = @__entity_equality_phoneNumber_0_Number)
+```
+
+Notice that equality is performed by expanding out each member of the complex type. This aligns with complex types having no key for identity and hence a complex type instance is equal to another complex type instance if and only if all their members are equal. This also aligns with the equality defined by .NET for record types.
+
+### Manipulation of complex type values
+
+EF8 provides access to tracking information such as the current and original values of complex types and whether or not a property value has been modified. The API complex types is an extension of [the change tracking API already used for entity types](xref:core/change-tracking/entity-entries).
+
+The `ComplexProperty` methods of <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry> return a entry for an entire complex object. For example, to get the current value of the `Order.BillingAddress`:
+
+<!--
+        #region BillingAddressCurrentValue
+        var billingAddress = context.Entry(order)
+            .ComplexProperty(e => e.BillingAddress)
+            .CurrentValue;
+-->
+[!code-csharp[BillingAddressCurrentValue](../../../../samples/core/Miscellaneous/NewInEFCore8/NestedComplexTypesSample.cs?name=BillingAddressCurrentValue)]
+
+A call to `Property` can be added to access a property of the complex type. For example to get the current value of just the billing post code:
+
+<!--
+        #region PostCodeCurrentValue
+        var postCode = context.Entry(order)
+            .ComplexProperty(e => e.BillingAddress)
+            .Property(e => e.PostCode)
+            .CurrentValue;
+-->
+[!code-csharp[PostCodeCurrentValue](../../../../samples/core/Miscellaneous/NewInEFCore8/NestedComplexTypesSample.cs?name=PostCodeCurrentValue)]
+
+Nested complex types are accessed using nested calls to `ComplexProperty`. For example, to get the city from the nested `Address` of the `Contact` on a `Customer`:
+
+<!--
+        #region CityCurrentValue
+        var currentCity = context.Entry(customer)
+            .ComplexProperty(e => e.Contact)
+            .ComplexProperty(e => e.Address)
+            .Property(e => e.City)
+            .CurrentValue;
+-->
+[!code-csharp[CityCurrentValue](../../../../samples/core/Miscellaneous/NewInEFCore8/NestedComplexTypesSample.cs?name=CityCurrentValue)]
+
+Other methods are available for reading and changing state. For example, <xref:Microsoft.EntityFrameworkCore.ChangeTracking.PropertyEntry.IsModified?displayProperty=nameWithType> can be used to set a property of a complex type as modified:
+
+<!--
+        #region SetPostCodeIsModified
+        context.Entry(customer)
+            .ComplexProperty(e => e.Contact)
+            .ComplexProperty(e => e.Address)
+            .Property(e => e.PostCode)
+            .IsModified = true;
+-->
+[!code-csharp[SetPostCodeIsModified](../../../../samples/core/Miscellaneous/NewInEFCore8/NestedComplexTypesSample.cs?name=SetPostCodeIsModified)]
+
+### Current limitations
+
+Complex types represent a significant investment across the EF stack. We were not able to make everything work in this release, but we plan to close some of the gaps in a future release. Make sure to vote (👍) on the appropriate GitHub issues if fixing any of these limitations is important to you.
+
+Complex type limitations in EF8 include:
+
+- Support collections of complex types. ([Issue #31237](https://github.com/dotnet/efcore/issues/31237))
+- Allow complex type properties to be null. ([Issue #31376](https://github.com/dotnet/efcore/issues/31376))
+- Map complex type properties to JSON columns. ([Issue #31252](https://github.com/dotnet/efcore/issues/31252))
+- Constructor injection for complex types. ([Issue #31621](https://github.com/dotnet/efcore/issues/31621))
+- Add seed data support for complex types. ([Issue #31254](https://github.com/dotnet/efcore/issues/31254))
+- Map complex type properties for the Cosmos provider. ([Issue #31253](https://github.com/dotnet/efcore/issues/31253))
+- Implement complex types for the in-memory database. ([Issue #31464](https://github.com/dotnet/efcore/issues/31464))
+
+## Primitive collections
+
+A persistent question when using relational databases is what to do with collections of primitive types; that is, lists or arrays of integers, date/times, strings, and so on. If you're using PostgreSQL, then its easy to store these things using PostgreSQL's [built-in array type](https://www.postgresql.org/docs/current/arrays.html). For other databases, there are two common approaches:
+
+- Create a table with a column for the primitive type value and another column to act as a foreign key linking each value to its owner of the collection.
+- Serialize the primitive collection into some column type that is handled by the database--for example, serialize to and from a string.
+
+The first option has advantages in many situations--we'll take a quick look at it at the end of this section. However, it's not a natural representation of the data in the model, and if what you really have is a collection of a primitive type, then the second option can be more effective.
+
+Starting with Preview 4, EF8 now includes built-in support for the second option, using JSON as the serialization format. JSON works well for this since modern relational databases include built-in mechanisms for querying and manipulating JSON, such that the JSON column can, effectively, be treated as a table when needed, without the overhead of actually creating that table. These same mechanisms allow JSON to be passed in parameters and then used in similar way to table-valued parameters in queries--more about this later.
+
+> [!TIP]
+> The code shown here comes from [PrimitiveCollectionsSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore8/PrimitiveCollectionsSample.cs).
+
+### Primitive collection properties
+
+EF Core can map any `IEnumerable<T>` property, where `T` is a primitive type, to a JSON column in the database. This is done by convention for public properties which have both a getter and a setter. For example, all properties in the following entity type are mapped to JSON columns by convention:
+
+```csharp
+public class PrimitiveCollections
+{
+    public IEnumerable<int> Ints { get; set; }
+    public ICollection<string> Strings { get; set; }
+    public IList<DateOnly> Dates { get; set; }
+    public uint[] UnsignedInts { get; set; }
+    public List<bool> Booleans { get; set; }
+    public List<Uri> Urls { get; set; }
+}
+```
+
+> [!NOTE]
+> What do we mean by "primitive type" in this context? Essentially, something that the database provider knows how to map, using some kind of value conversion if necessary. For example, in the entity type above, the types `int`, `string`, `DateTime`, `DateOnly` and `bool` are all handled without conversion by the database provider. SQL Server does not have native support for unsigned ints or URIs, but `uint` and `Uri` are still treated as primitive types because there are [built-in value converters](xref:core/modeling/value-conversions#built-in-converters) for these types.
+
+By default, EF Core uses an unconstrained Unicode string column type to hold the JSON, since this protects against data loss with large collections. However, on some database systems, such as SQL Server, specifying a maximum length for the string can improve performance. This, along with other column configuration, can be done [in the normal way](xref:core/modeling/entity-properties). For example:
+
+```csharp
+modelBuilder
+    .Entity<PrimitiveCollections>()
+    .Property(e => e.Booleans)
+    .HasMaxLength(1024)
+    .IsUnicode(false);
+```
+
+Or, using mapping attributes:
+
+```csharp
+[MaxLength(2500)]
+[Unicode(false)]
+public uint[] UnsignedInts { get; set; }
+```
+
+A default column configuration can be used for all properties of a certain type using [pre-convention model configuration](xref:core/modeling/bulk-configuration#pre-convention-configuration). For example:
+
+```csharp
+protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+{
+    configurationBuilder
+        .Properties<List<DateOnly>>()
+        .AreUnicode(false)
+        .HaveMaxLength(4000);
+}
+```
+
+### Queries with primitive collections
+
+Let's look at some of the queries that make use of collections of primitive types. For this, we'll need a simple model with two entity types. The first represents a [British public house](https://en.wikipedia.org/wiki/Pub), or "pub":
+
+<!--
+    public class Pub
+    {
+        public Pub(string name, string[] beers)
+        {
+            Name = name;
+            Beers = beers;
+        }
+
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public string[] Beers { get; set; }
+        public List<DateOnly> DaysVisited { get; private set; } = new();
+    }
+-->
+[!code-csharp[Pub](../../../../samples/core/Miscellaneous/NewInEFCore8/PrimitiveCollectionsSample.cs?name=Pub)]
+
+The `Pub` type contains two primitive collections:
+
+- `Beers` is an array of strings representing the beer brands available at the pub.
+- `DaysVisited` is a list of the dates on which the pub was visited.
+
+> [!TIP]
+> In a real application, it would probably make more sense to create an entity type for beer, and have a table for beers. We're showing a primitive collection here to illustrate how they work. But remember, just because you can model something as a primitive collection doesn't mean that you necessarily should.
+
+The second entity type represents a dog walk in the British countryside:
+
+<!--
+    public class DogWalk
+    {
+        public DogWalk(string name)
+        {
+            Name = name;
+        }
+
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public Terrain Terrain { get; set; }
+        public List<DateOnly> DaysVisited { get; private set; } = new();
+        public Pub? ClosestPub { get; set; }
+    }
+
+    public enum Terrain
+    {
+        Forest,
+        River,
+        Hills,
+        Village,
+        Park,
+        Beach,
+    }
+-->
+[!code-csharp[DogWalk](../../../../samples/core/Miscellaneous/NewInEFCore8/PrimitiveCollectionsSample.cs?name=DogWalk)]
+
+Like `Pub`, `DogWalk` also contains a collection of the dates visited, and a link to the closest pub since, you know, sometimes the dog needs a saucer of beer after a long walk.
+
+Using this model, the first query we will do is a simple `Contains` query to find all walks with one of several different terrains:
+
+<!--
+        var terrains = new[] { Terrain.River, Terrain.Beach, Terrain.Park };
+        var walksWithTerrain = await context.Walks
+            .Where(e => terrains.Contains(e.Terrain))
+            .Select(e => e.Name)
+            .ToListAsync();
+-->
+[!code-csharp[WalksWithTerrain](../../../../samples/core/Miscellaneous/NewInEFCore8/PrimitiveCollectionsSample.cs?name=WalksWithTerrain)]
+
+This is already translated by current versions of EF Core by inlining the values to look for. For example, when using SQL Server:
+
+```sql
+SELECT [w].[Name]
+FROM [Walks] AS [w]
+WHERE [w].[Terrain] IN (1, 5, 4)
+```
+
+However, this strategy does not work well with database query caching; see [Announcing EF8 Preview 4](https://devblogs.microsoft.com/dotnet/announcing-ef8-preview-4/) on the .NET Blog for a discussion of the issue.
+
+> [!IMPORTANT]
+> The inlining of values here is done in such a way that there is no chance of a SQL injection attack. The change to use JSON described below is all about performance, and nothing to do with security.
+
+For EF Core 8, the default is now to pass the list of terrains as a single parameter containing a JSON collection. For example:
+
+```none
+@__terrains_0='[1,5,4]'
+```
+
+The query then uses `OpenJson` on SQL Server:
+
+```sql
+SELECT [w].[Name]
+FROM [Walks] AS [w]
+WHERE EXISTS (
+    SELECT 1
+    FROM OpenJson(@__terrains_0) AS [t]
+    WHERE CAST([t].[value] AS int) = [w].[Terrain])
+```
+
+Or `json_each` on SQLite:
+
+```sql
+SELECT "w"."Name"
+FROM "Walks" AS "w"
+WHERE EXISTS (
+    SELECT 1
+    FROM json_each(@__terrains_0) AS "t"
+    WHERE "t"."value" = "w"."Terrain")
+```
+
+> [!NOTE]
+> `OpenJson` is only available on SQL Server 2016 ([compatibility level 130](/sql/t-sql/statements/alter-database-transact-sql-compatibility-level)) and later. You can tell SQL Server that you're using an older version by configuring the compatibility level as part of `UseSqlServer`. For example:
+>
+> ```csharp
+> protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+>     => optionsBuilder
+>         .UseSqlServer(
+>             @"Data Source=(LocalDb)\MSSQLLocalDB;Database=AllTogetherNow",
+>             sqlServerOptionsBuilder => sqlServerOptionsBuilder.UseCompatibilityLevel(120));
+> ```
+
+Let's try a different kind of `Contains` query. In this case, we'll look for a value of the parameter collection in the column. For example, any pub that stocks Heineken:
+
+<!--
+        var beer = "Heineken";
+        var pubsWithHeineken = await context.Pubs
+            .Where(e => e.Beers.Contains(beer))
+            .Select(e => e.Name)
+            .ToListAsync();
+-->
+[!code-csharp[PubsWithHeineken](../../../../samples/core/Miscellaneous/NewInEFCore8/PrimitiveCollectionsSample.cs?name=PubsWithHeineken)]
+
+The existing [documentation from What's New in EF7](xref:core/what-is-new/ef-core-7.0/whatsnew#json-columns) provides detailed information on JSON mapping, queries, and updates. This documentation now also applies to SQLite.
+
+```sql
+SELECT [p].[Name]
+FROM [Pubs] AS [p]
+WHERE EXISTS (
+    SELECT 1
+    FROM OpenJson([p].[Beers]) AS [b]
+    WHERE [b].[value] = @__beer_0)
+```
+
+`OpenJson` is now used to to extract values from JSON column so that each value can be matched to the passed parameter.
+
+We can combine the use of `OpenJson` on the parameter with `OpenJson` on the column. For example, to find pubs that stock any one of a variety of lagers:
+
+<!--
+        var beers = new[] { "Carling", "Heineken", "Stella Artois", "Carlsberg" };
+        var pubsWithLager = await context.Pubs
+            .Where(e => beers.Any(b => e.Beers.Contains(b)))
+            .Select(e => e.Name)
+            .ToListAsync();
+-->
+[!code-csharp[PubsWithLager](../../../../samples/core/Miscellaneous/NewInEFCore8/PrimitiveCollectionsSample.cs?name=PubsWithLager)]
+
+This translates to the following on SQL Server:
+
+```sql
+SELECT [p].[Name]
+FROM [Pubs] AS [p]
+WHERE EXISTS (
+    SELECT 1
+    FROM OpenJson(@__beers_0) AS [b]
+    WHERE EXISTS (
+        SELECT 1
+        FROM OpenJson([p].[Beers]) AS [b0]
+        WHERE [b0].[value] = [b].[value] OR ([b0].[value] IS NULL AND [b].[value] IS NULL)))
+```
+
+The `@__beers_0` parameter value here is `["Carling","Heineken","Stella Artois","Carlsberg"]`.
+
+Let's look at a query that makes use of the column containing a collection of dates. For example, to find pubs visited this year:
+
+<!--
+        var thisYear = DateTime.Now.Year;
+        var pubsVisitedThisYear = await context.Pubs
+            .Where(e => e.DaysVisited.Any(v => v.Year == thisYear))
+            .Select(e => e.Name)
+            .ToListAsync();
+-->
+[!code-csharp[PubsVisitedThisYear](../../../../samples/core/Miscellaneous/NewInEFCore8/PrimitiveCollectionsSample.cs?name=PubsVisitedThisYear)]
+
+This translates to the following on SQL Server:
+
+```sql
+SELECT [p].[Name]
+FROM [Pubs] AS [p]
+WHERE EXISTS (
+    SELECT 1
+    FROM OpenJson([p].[DaysVisited]) AS [d]
+    WHERE DATEPART(year, CAST([d].[value] AS date)) = @__thisYear_0)
+```
+
+Notice that the query makes use of the date-specific function `DATEPART` here because EF _knows that the primitive collection contains dates_. It might not seem like it, but this is actually really important. Because EF knows what's in the collection, it can generate appropriate SQL to use the typed values with parameters, functions, other columns etc.
+
+Let's use the date collection again, this time to order appropriately for the type and project values extracted from the collection. For example, let's list pubs in the order that they were first visited, and with the first and last date each pub was visited:
+
+<!--
+        var pubsVisitedInOrder = await context.Pubs
+            .Select(e => new
+            {
+                e.Name,
+                FirstVisited = e.DaysVisited.OrderBy(v => v).First(),
+                LastVisited = e.DaysVisited.OrderByDescending(v => v).First(),
+            })
+            .OrderBy(p => p.FirstVisited)
+            .ToListAsync();
+-->
+[!code-csharp[PubsVisitedInOrder](../../../../samples/core/Miscellaneous/NewInEFCore8/PrimitiveCollectionsSample.cs?name=PubsVisitedInOrder)]
+
+This translates to the following on SQL Server:
+
+```sql
+SELECT [p].[Name], (
+    SELECT TOP(1) CAST([d0].[value] AS date)
+    FROM OpenJson([p].[DaysVisited]) AS [d0]
+    ORDER BY CAST([d0].[value] AS date)) AS [FirstVisited], (
+    SELECT TOP(1) CAST([d1].[value] AS date)
+    FROM OpenJson([p].[DaysVisited]) AS [d1]
+    ORDER BY CAST([d1].[value] AS date) DESC) AS [LastVisited]
+FROM [Pubs] AS [p]
+ORDER BY (
+    SELECT TOP(1) CAST([d].[value] AS date)
+    FROM OpenJson([p].[DaysVisited]) AS [d]
+    ORDER BY CAST([d].[value] AS date))
+```
+
+And finally, just how often do we end up visiting the closest pub when taking the dog for a walk? Let's find out:
+
+<!--
+        var walksWithADrink = await context.Walks.Select(
+            w => new
+            {
+                WalkName = w.Name,
+                PubName = w.ClosestPub.Name,
+                Count = w.DaysVisited.Count(v => w.ClosestPub.DaysVisited.Contains(v)),
+                TotalCount = w.DaysVisited.Count
+            }).ToListAsync();
+-->
+[!code-csharp[WalksWithADrink](../../../../samples/core/Miscellaneous/NewInEFCore8/PrimitiveCollectionsSample.cs?name=WalksWithADrink)]
+
+This translates to the following on SQL Server:
+
+```sql
+SELECT [w].[Name] AS [WalkName], [p].[Name] AS [PubName], (
+    SELECT COUNT(*)
+    FROM OpenJson([w].[DaysVisited]) AS [d]
+    WHERE EXISTS (
+        SELECT 1
+        FROM OpenJson([p].[DaysVisited]) AS [d0]
+        WHERE CAST([d0].[value] AS date) = CAST([d].[value] AS date) OR ([d0].[value] IS NULL AND [d].[value] IS NULL))) AS [Count], (
+    SELECT COUNT(*)
+    FROM OpenJson([w].[DaysVisited]) AS [d1]) AS [TotalCount]
+FROM [Walks] AS [w]
+INNER JOIN [Pubs] AS [p] ON [w].[ClosestPubId] = [p].[Id]
+```
+
+And reveals the following data:
+
+```none
+The Prince of Wales Feathers was visited 5 times in 8 "Ailsworth to Nene" walks.
+The Prince of Wales Feathers was visited 6 times in 9 "Caster Hanglands" walks.
+The Royal Oak was visited 6 times in 8 "Ferry Meadows" walks.
+The White Swan was visited 7 times in 9 "Woodnewton" walks.
+The Eltisley was visited 6 times in 8 "Eltisley" walks.
+Farr Bay Inn was visited 7 times in 11 "Farr Beach" walks.
+Farr Bay Inn was visited 7 times in 9 "Newlands" walks.
+```
+
+Looks like beer and dog walking are a winning combination!
+
+### Primitive collections in JSON documents
+
+In all the examples above, column for primitive collection contains JSON. However, this is not the same as mapping [an owned entity type to a column containing a JSON document](xref:core/what-is-new/ef-core-7.0/whatsnew#json-columns), which was introduced in EF7. But what if that JSON document itself contains a primitive collection? Well, all the queries above still work in the same way! For example, imagine we move the _days visited_ data into an owned type `Visits` mapped to a JSON document:
+
+<!--
+    public class Pub
+    {
+        public Pub(string name)
+        {
+            Name = name;
+        }
+
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public BeerData Beers { get; set; } = null!;
+        public Visits Visits { get; set; } = null!;
+    }
+
+    public class Visits
+    {
+        public string? LocationTag { get; set; }
+        public List<DateOnly> DaysVisited { get; set; } = null!;
+    }
+-->
+[!code-csharp[Pub](../../../../samples/core/Miscellaneous/NewInEFCore8/PrimitiveCollectionsInJsonSample.cs?name=Pub)]
+
+> [!TIP]
+> The code shown here comes from [PrimitiveCollectionsInJsonSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore8/PrimitiveCollectionsInJsonSample.cs).
+
+We can now run a variation of our final query that, this time, extracts data from the JSON document, including queries into the primitive collections contained in the document:
+
+<!--
+        var walksWithADrink = await context.Walks.Select(
+            w => new
+            {
+                WalkName = w.Name,
+                PubName = w.ClosestPub.Name,
+                WalkLocationTag = w.Visits.LocationTag,
+                PubLocationTag = w.ClosestPub.Visits.LocationTag,
+                Count = w.Visits.DaysVisited.Count(v => w.ClosestPub.Visits.DaysVisited.Contains(v)),
+                TotalCount = w.Visits.DaysVisited.Count
+            }).ToListAsync();
+-->
+[!code-csharp[WalksWithADrink](../../../../samples/core/Miscellaneous/NewInEFCore8/PrimitiveCollectionsInJsonSample.cs?name=WalksWithADrink)]
+
+This translates to the following on SQL Server:
+
+```sql
+SELECT [w].[Name] AS [WalkName], [p].[Name] AS [PubName], JSON_VALUE([w].[Visits], '$.LocationTag') AS [WalkLocationTag], JSON_VALUE([p].[Visits], '$.LocationTag') AS [PubLocationTag], (
+    SELECT COUNT(*)
+    FROM OpenJson(JSON_VALUE([w].[Visits], '$.DaysVisited')) AS [d]
+    WHERE EXISTS (
+        SELECT 1
+        FROM OpenJson(JSON_VALUE([p].[Visits], '$.DaysVisited')) AS [d0]
+        WHERE CAST([d0].[value] AS date) = CAST([d].[value] AS date) OR ([d0].[value] IS NULL AND [d].[value] IS NULL))) AS [Count], (
+    SELECT COUNT(*)
+    FROM OpenJson(JSON_VALUE([w].[Visits], '$.DaysVisited')) AS [d1]) AS [TotalCount]
+FROM [Walks] AS [w]
+INNER JOIN [Pubs] AS [p] ON [w].[ClosestPubId] = [p].[Id]
+```
+
+And to a similar query when using SQLite:
+
+```sql
+SELECT "w"."Name" AS "WalkName", "p"."Name" AS "PubName", "w"."Visits" ->> 'LocationTag' AS "WalkLocationTag", "p"."Visits" ->> 'LocationTag' AS "PubLocationTag", (
+    SELECT COUNT(*)
+    FROM json_each("w"."Visits" ->> 'DaysVisited') AS "d"
+    WHERE EXISTS (
+        SELECT 1
+        FROM json_each("p"."Visits" ->> 'DaysVisited') AS "d0"
+        WHERE "d0"."value" = "d"."value")) AS "Count", json_array_length("w"."Visits" ->> 'DaysVisited') AS "TotalCount"
+FROM "Walks" AS "w"
+INNER JOIN "Pubs" AS "p" ON "w"."ClosestPubId" = "p"."Id"
+```
+
+> [!TIP]
+> Notice that on SQLite EF Core now makes use of the `->>` operator, resulting in queries that are both easier to read and often more performant.
+
+### Mapping primitive collections to a table
+
+We mentioned above that another option for primitive collections is to map them to a different table. First class support for this is tracked by [Issue #25163](https://github.com/dotnet/efcore/issues/25163); make sure to vote for this issue if it is important to you. Until this is implemented, the best approach is to create a wrapping type for the primitive. For example, let's create a type for `Beer`:
+
+<!--
+    [Owned]
+    public class Beer
+    {
+        public Beer(string name)
+        {
+            Name = name;
+        }
+
+        public string Name { get; private set; }
+    }
+-->
+[!code-csharp[Beer](../../../../samples/core/Miscellaneous/NewInEFCore8/PrimitiveCollectionToTableSample.cs?name=Beer)]
+
+Notice that the type simply wraps the primitive value--it doesn't have a primary key or any foreign keys defined. This type can then be used in the `Pub` class:
+
+<!--
+    public class Pub
+    {
+        public Pub(string name)
+        {
+            Name = name;
+        }
+
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public List<Beer> Beers { get; set; } = new();
+        public List<DateOnly> DaysVisited { get; private set; } = new();
+    }
+-->
+[!code-csharp[Pub](../../../../samples/core/Miscellaneous/NewInEFCore8/PrimitiveCollectionToTableSample.cs?name=Pub)]
+
+EF will now create a `Beer` table, synthesizing primary key and foreign key columns back to the `Pubs` table. For example, on SQL Server:
+
+```sql
+CREATE TABLE [Beer] (
+    [PubId] int NOT NULL,
+    [Id] int NOT NULL IDENTITY,
+    [Name] nvarchar(max) NOT NULL,
+    CONSTRAINT [PK_Beer] PRIMARY KEY ([PubId], [Id]),
+    CONSTRAINT [FK_Beer_Pubs_PubId] FOREIGN KEY ([PubId]) REFERENCES [Pubs] ([Id]) ON DELETE CASCADE
+```
+
+## Enhancements to JSON column mapping
+
+EF8 includes improvements to the [JSON column mapping support introduced in EF7](xref:core/what-is-new/ef-core-7.0/whatsnew#json-columns).
+
+> [!TIP]
+> The code shown here comes from [JsonColumnsSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore8/JsonColumnsSample.cs).
+
+### Translate element access into JSON arrays
+
+EF8 supports indexing in JSON arrays when executing queries. For example, the following query checks whether the first two updates were made before a given date.
+
+<!--
+        var cutoff = DateOnly.FromDateTime(DateTime.UtcNow - TimeSpan.FromDays(365));
+        var updatedPosts = await context.Posts
+            .Where(
+                p => p.Metadata!.Updates[0].UpdatedOn < cutoff
+                     && p.Metadata!.Updates[1].UpdatedOn < cutoff)
+            .ToListAsync();
+-->
+[!code-csharp[CollectionIndexPredicate](../../../../samples/core/Miscellaneous/NewInEFCore8/JsonColumnsSample.cs?name=CollectionIndexPredicate)]
+
+This translates into the following SQL when using SQL Server:
+
+```sql
+SELECT [p].[Id], [p].[Archived], [p].[AuthorId], [p].[BlogId], [p].[Content], [p].[Discriminator], [p].[PublishedOn], [p].[Title], [p].[PromoText], [p].[Metadata]
+FROM [Posts] AS [p]
+WHERE CAST(JSON_VALUE([p].[Metadata],'$.Updates[0].UpdatedOn') AS date) < @__cutoff_0
+  AND CAST(JSON_VALUE([p].[Metadata],'$.Updates[1].UpdatedOn') AS date) < @__cutoff_0
+```
+
+> [!NOTE]
+> This query will succeed even if a given post does not have any updates, or only has a single update. In such a case, `JSON_VALUE` returns `NULL` and the predicate is not matched.
+
+Indexing into JSON arrays can also be used to project elements from an array into the final results. For example, the following query projects out the `UpdatedOn` date for the first and second updates of each post.
+
+<!--
+        var postsAndRecentUpdatesNullable = await context.Posts
+            .Select(p => new
+            {
+                p.Title,
+                LatestUpdate = (DateOnly?)p.Metadata!.Updates[0].UpdatedOn,
+                SecondLatestUpdate = (DateOnly?)p.Metadata.Updates[1].UpdatedOn
+            })
+            .ToListAsync();
+-->
+[!code-csharp[CollectionIndexProjectionNullable](../../../../samples/core/Miscellaneous/NewInEFCore8/JsonColumnsSample.cs?name=CollectionIndexProjectionNullable)]
+
+This translates into the following SQL when using SQL Server:
+
+```sql
+SELECT [p].[Title],
+       CAST(JSON_VALUE([p].[Metadata],'$.Updates[0].UpdatedOn') AS date) AS [LatestUpdate],
+       CAST(JSON_VALUE([p].[Metadata],'$.Updates[1].UpdatedOn') AS date) AS [SecondLatestUpdate]
+FROM [Posts] AS [p]
+```
+
+As noted above, `JSON_VALUE` returns null if the element of the array does not exist. This is handled in the query by casting the projected value to a nullable `DateOnly`. An alternative to casting the value is to filter the query results so that `JSON_VALUE` will never return null. For example:
+
+<!--
+        var postsAndRecentUpdates = await context.Posts
+            .Where(p => p.Metadata!.Updates[0].UpdatedOn != null
+                        && p.Metadata!.Updates[1].UpdatedOn != null)
+            .Select(p => new
+            {
+                p.Title,
+                LatestUpdate = p.Metadata!.Updates[0].UpdatedOn,
+                SecondLatestUpdate = p.Metadata.Updates[1].UpdatedOn
+            })
+            .ToListAsync();
+-->
+[!code-csharp[CollectionIndexProjection](../../../../samples/core/Miscellaneous/NewInEFCore8/JsonColumnsSample.cs?name=CollectionIndexProjection)]
+
+This translates into the following SQL when using SQL Server:
+
+```sql
+SELECT [p].[Title],
+       CAST(JSON_VALUE([p].[Metadata],'$.Updates[0].UpdatedOn') AS date) AS [LatestUpdate],
+       CAST(JSON_VALUE([p].[Metadata],'$.Updates[1].UpdatedOn') AS date) AS [SecondLatestUpdate]
+FROM [Posts] AS [p]
+      WHERE (CAST(JSON_VALUE([p].[Metadata],'$.Updates[0].UpdatedOn') AS date) IS NOT NULL)
+        AND (CAST(JSON_VALUE([p].[Metadata],'$.Updates[1].UpdatedOn') AS date) IS NOT NULL)
+```
+
+### Translate queries into embedded collections
+
+EF8 supports queries against collections of both primitive (discussed above) and non-primitive types embedded in the JSON document. For example, the following query returns all posts with any of an arbitrary list of search terms:
+
+<!--
+        #region PostsWithSearchTerms
+        var searchTerms = new[] { "Search #2", "Search #3", "Search #5", "Search #8", "Search #13", "Search #21", "Search #34" };
+
+        var postsWithSearchTerms = await context.Posts
+            .Where(post => post.Metadata!.TopSearches.Any(s => searchTerms.Contains(s.Term)))
+            .ToListAsync();
+-->
+[!code-csharp[PostsWithSearchTerms](../../../../samples/core/Miscellaneous/NewInEFCore8/JsonColumnsSample.cs?name=PostsWithSearchTerms)]
+
+This translates into the following SQL when using SQL Server:
+
+```sql
+SELECT [p].[Id], [p].[Archived], [p].[AuthorId], [p].[BlogId], [p].[Content], [p].[Discriminator], [p].[PublishedOn], [p].[Title], [p].[PromoText], [p].[Metadata]
+FROM [Posts] AS [p]
+WHERE EXISTS (
+    SELECT 1
+    FROM OPENJSON([p].[Metadata], '$.TopSearches') WITH (
+        [Count] int '$.Count',
+        [Term] nvarchar(max) '$.Term'
+    ) AS [t]
+    WHERE EXISTS (
+        SELECT 1
+        FROM OPENJSON(@__searchTerms_0) WITH ([value] nvarchar(max) '$') AS [s]
+        WHERE [s].[value] = [t].[Term]))
+```
+
+### JSON Columns for SQLite
+
+EF7 introduced support for mapping to JSON columns when using Azure SQL/SQL Server. EF8 extends this support to SQLite databases. As for the SQL Server support, this includes:
+
+- Mapping of aggregates built from .NET types to JSON documents stored in SQLite columns
+- Queries into JSON columns, such as filtering and sorting by the elements of the documents
+- Queries that project elements out of the JSON document into results
+- Updating and saving changes to JSON documents
+
+The existing [documentation from What's New in EF7](xref:core/what-is-new/ef-core-7.0/whatsnew#json-columns) provides detailed information on JSON mapping, queries, and updates. This documentation now also applies to SQLite.
+
+> [!TIP]
+> The code shown in the EF7 documentation has been updated to also run on SQLite can can be found in [JsonColumnsSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore8/JsonColumnsSample.cs).
+
+#### Queries into JSON columns
+
+Queries into JSON columns on SQLite use the `json_extract` function. For example, the "authors in Chigley" query from the documentation referenced above:
+
+<!--
+        var authorsInChigley = await context.Authors
+            .Where(author => author.Contact.Address.City == "Chigley")
+            .ToListAsync();
+-->
+[!code-csharp[AuthorsInChigley](../../../../samples/core/Miscellaneous/NewInEFCore8/JsonColumnsSample.cs?name=AuthorsInChigley)]
+
+Is translated to the following SQL when using SQLite:
+
+```sql
+SELECT "a"."Id", "a"."Name", "a"."Contact"
+FROM "Authors" AS "a"
+WHERE json_extract("a"."Contact", '$.Address.City') = 'Chigley'
+```
+
+#### Updating JSON columns
+
+For updates, EF uses the `json_set` function on SQLite. For example, when updating a single property in a document:
+
+<!--
+        var arthur = await context.Authors.SingleAsync(author => author.Name.StartsWith("Arthur"));
+
+        arthur.Contact.Address.Country = "United Kingdom";
+
+        await context.SaveChangesAsync();
+-->
+[!code-csharp[UpdateProperty](../../../../samples/core/Miscellaneous/NewInEFCore8/JsonColumnsSample.cs?name=UpdateProperty)]
+
+EF generates the following parameters:
+
+```text
+info: 3/10/2023 10:51:33.127 RelationalEventId.CommandExecuted[20101] (Microsoft.EntityFrameworkCore.Database.Command)
+      Executed DbCommand (0ms) [Parameters=[@p0='["United Kingdom"]' (Nullable = false) (Size = 18), @p1='4'], CommandType='Text', CommandTimeout='30']
+```
+
+Which use the `json_set` function on SQLite:
+
+```sql
+UPDATE "Authors" SET "Contact" = json_set("Contact", '$.Address.Country', json_extract(@p0, '$[0]'))
+WHERE "Id" = @p1
+RETURNING 1;
+```
+
+<a name="hierarchyid"></a>
+
+## HierarchyId in .NET and EF Core
+
+Azure SQL and SQL Server have a special data type called [`hierarchyid`](/sql/t-sql/data-types/hierarchyid-data-type-method-reference) that is used to store [hierarchical data](/sql/relational-databases/hierarchical-data-sql-server). In this case, "hierarchical data" essentially means data that forms a tree structure, where each item can have a parent and/or children. Examples of such data are:
+
+- An organizational structure
+- A file system
+- A set of tasks in a project
+- A taxonomy of language terms
+- A graph of links between Web pages
+
+The database is then able to run queries against this data using its hierarchical structure. For example, a query can find ancestors and dependents of given items, or find all items at a certain depth in the hierarchy.
+
+### Support in .NET and EF Core
+
+Official support for the SQL Server `hierarchyid` type has only recently come to modern .NET platforms. This support is in the form of the [Microsoft.SqlServer.Types](https://www.nuget.org/packages/Microsoft.SqlServer.Types) NuGet package, which brings in low-level SQL Server-specific types. In this case, the low-level type is called `SqlHierarchyId`.
+
+At the next level, a new [Microsoft.EntityFrameworkCore.SqlServer.Abstractions](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.SqlServer.Abstractions) package has been introduced, which includes a higher-level `HierarchyId` type intended for use in entity types.
+
+> [!TIP]
+> The `HierarchyId` type is more idiomatic to the norms of .NET than `SqlHierarchyId`, which is instead modeled after how .NET Framework types are hosted inside the SQL Server database engine.  `HierarchyId` is designed to work with EF Core, but it can also be used outside of EF Core in other applications. The `Microsoft.EntityFrameworkCore.SqlServer.Abstractions` package doesn't reference any other packages, and so has minimal impact on deployed application size and dependencies.
+
+Use of `HierarchyId` for EF Core functionality such as queries and updates requires the [Microsoft.EntityFrameworkCore.SqlServer.HierarchyId](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.SqlServer.HierarchyId) package. This package brings in `Microsoft.EntityFrameworkCore.SqlServer.Abstractions` and `Microsoft.SqlServer.Types` as transitive dependencies, and so is often the only package needed. Once the package is installed, use of `HierarchyId` is enabled by calling `UseHierarchyId` as part of the application's call to `UseSqlServer`. For example:
+
+```csharp
+options.UseSqlServer(
+    connectionString,
+    x => x.UseHierarchyId());
+```
+
+> [!NOTE]
+> Unofficial support for `hierarchyid` in EF Core has been available for many years via the [EntityFrameworkCore.SqlServer.HierarchyId](https://www.nuget.org/packages/EntityFrameworkCore.SqlServer.HierarchyId) package. This package has been maintained as a collaboration between the community and the EF team. Now that there is official support for `hierarchyid` in .NET, the code from this community package forms, with the permission of the original contributors, the basis for the official package described here. Many thanks to all those involved over the years, including [@aljones](https://github.com/aljones), [@cutig3r](https://github.com/cutig3r), [@huan086](https://github.com/huan086), [@kmataru](https://github.com/kmataru), [@mehdihaghshenas](https://github.com/mehdihaghshenas), and [@vyrotek](https://github.com/vyrotek)
+
+### Modeling hierarchies
+
+The `HierarchyId` type can be used for properties of an entity type. For example, assume we want to model the paternal family tree of some fictional [halflings](https://en.wikipedia.org/wiki/Halfling). In the entity type for `Halfling`, a `HierarchyId` property can be used to locate each halfling in the family tree.
+
+<!--
+    public class Halfling
+    {
+        public Halfling(HierarchyId pathFromPatriarch, string name, int? yearOfBirth = null)
+        {
+            PathFromPatriarch = pathFromPatriarch;
+            Name = name;
+            YearOfBirth = yearOfBirth;
+        }
+
+        public int Id { get; private set; }
+        public HierarchyId PathFromPatriarch { get; set; }
+        public string Name { get; set; }
+        public int? YearOfBirth { get; set; }
+    }
+-->
+[!code-csharp[Halfling](../../../../samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs?name=Halfling)]
+
+> [!TIP]
+> The code shown here and in the examples below comes from [HierarchyIdSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs).
+
+> [!TIP]
+> If desired, `HierarchyId` is suitable for use as a key property type.
+
+In this case, the family tree is rooted with the patriarch of the family. Each halfling can be traced from the patriarch down the tree using its `PathFromPatriarch` property. SQL Server uses a compact binary format for these paths, but it is common to parse to and from a human-readable string representation when when working with code. In this representation, the position at each level is separated by a `/` character. For example, consider the family tree in the diagram below:
+
+![Halfling family tree](familytree.png)
+
+In this tree:
+
+- Balbo is at the root of the tree, represented by `/`.
+- Balbo has five children, represented by `/1/`, `/2/`, `/3/`, `/4/`, and `/5/`.
+- Balbo's first child, Mungo, also has five children, represented by `/1/1/`, `/1/2/`, `/1/3/`, `/1/4/`, and `/1/5/`. Notice that the `HierarchyId` for Balbo (`/1/`) is the prefix for all his children.
+- Similarly, Balbo's third child, Ponto, has two children, represented by `/3/1/` and `/3/2/`. Again the each of these children is prefixed by the `HierarchyId` for Ponto, which is represented as `/3/`.
+- And so on down the tree...
+
+The following code inserts this family tree into a database using EF Core:
+
+<!--
+            await AddRangeAsync(
+                new Halfling(HierarchyId.Parse("/"), "Balbo", 1167),
+                new Halfling(HierarchyId.Parse("/1/"), "Mungo", 1207),
+                new Halfling(HierarchyId.Parse("/2/"), "Pansy", 1212),
+                new Halfling(HierarchyId.Parse("/3/"), "Ponto", 1216),
+                new Halfling(HierarchyId.Parse("/4/"), "Largo", 1220),
+                new Halfling(HierarchyId.Parse("/5/"), "Lily", 1222),
+                new Halfling(HierarchyId.Parse("/1/1/"), "Bungo", 1246),
+                new Halfling(HierarchyId.Parse("/1/2/"), "Belba", 1256),
+                new Halfling(HierarchyId.Parse("/1/3/"), "Longo", 1260),
+                new Halfling(HierarchyId.Parse("/1/4/"), "Linda", 1262),
+                new Halfling(HierarchyId.Parse("/1/5/"), "Bingo", 1264),
+                new Halfling(HierarchyId.Parse("/3/1/"), "Rosa", 1256),
+                new Halfling(HierarchyId.Parse("/3/2/"), "Polo"),
+                new Halfling(HierarchyId.Parse("/4/1/"), "Fosco", 1264),
+                new Halfling(HierarchyId.Parse("/1/1/1/"), "Bilbo", 1290),
+                new Halfling(HierarchyId.Parse("/1/3/1/"), "Otho", 1310),
+                new Halfling(HierarchyId.Parse("/1/5/1/"), "Falco", 1303),
+                new Halfling(HierarchyId.Parse("/3/2/1/"), "Posco", 1302),
+                new Halfling(HierarchyId.Parse("/3/2/2/"), "Prisca", 1306),
+                new Halfling(HierarchyId.Parse("/4/1/1/"), "Dora", 1302),
+                new Halfling(HierarchyId.Parse("/4/1/2/"), "Drogo", 1308),
+                new Halfling(HierarchyId.Parse("/4/1/3/"), "Dudo", 1311),
+                new Halfling(HierarchyId.Parse("/1/3/1/1/"), "Lotho", 1310),
+                new Halfling(HierarchyId.Parse("/1/5/1/1/"), "Poppy", 1344),
+                new Halfling(HierarchyId.Parse("/3/2/1/1/"), "Ponto", 1346),
+                new Halfling(HierarchyId.Parse("/3/2/1/2/"), "Porto", 1348),
+                new Halfling(HierarchyId.Parse("/3/2/1/3/"), "Peony", 1350),
+                new Halfling(HierarchyId.Parse("/4/1/2/1/"), "Frodo", 1368),
+                new Halfling(HierarchyId.Parse("/4/1/3/1/"), "Daisy", 1350),
+                new Halfling(HierarchyId.Parse("/3/2/1/1/1/"), "Angelica", 1381));
+
+            await SaveChangesAsync();
+-->
+[!code-csharp[AddRangeAsync](../../../../samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs?name=AddRangeAsync)]
+
+> [!TIP]
+> If needed, decimal values can be used to create new nodes between two existing nodes. For example, `/3/2.5/2/` goes between `/3/2/2/` and `/3/3/2/`.
+
+### Querying hierarchies
+
+`HierarchyId` exposes several methods that can be used in LINQ queries.
+
+| Method                                                           | Description                                                                                                                                                                |
+|------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `GetAncestor(int n)`                                             | Gets the node `n` levels up the hierarchical tree.                                                                                                                         |
+| `GetDescendant(HierarchyId? child1, HierarchyId? child2)`        | Gets the value of a descendant node that is greater than `child1` and less than `child2`.                                                                                  |
+| `GetLevel()`                                                     | Gets the level of this node in the hierarchical tree.                                                                                                                      |
+| `GetReparentedValue(HierarchyId? oldRoot, HierarchyId? newRoot)` | Gets a value representing the location of a new node that has a path from `newRoot` equal to the path from `oldRoot` to this, effectively moving this to the new location. |
+| `IsDescendantOf(HierarchyId? parent)`                            | Gets a value indicating whether this node is a descendant of `parent`.                                                                                                     |
+
+In addition, the operators `==`, `!=`, `<`, `<=`, `>` and `>=` can be used.
+
+The following are examples of using these methods in LINQ queries.
+
+**Get entities at a given level in the tree**
+
+The following query uses `GetLevel` to return all halflings at a given level in the family tree:
+
+<!--
+            var generation = await context.Halflings.Where(halfling => halfling.PathFromPatriarch.GetLevel() == level).ToListAsync();
+-->
+[!code-csharp[GetLevel](../../../../samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs?name=GetLevel)]
+
+This translates to the following SQL:
+
+```sql
+SELECT [h].[Id], [h].[Name], [h].[PathFromPatriarch], [h].[YearOfBirth]
+FROM [Halflings] AS [h]
+WHERE [h].[PathFromPatriarch].GetLevel() = @__level_0
+```
+
+Running this in a loop we can get the halflings for every generation:
+
+```text
+Generation 0: Balbo
+Generation 1: Mungo, Pansy, Ponto, Largo, Lily
+Generation 2: Bungo, Belba, Longo, Linda, Bingo, Rosa, Polo, Fosco
+Generation 3: Bilbo, Otho, Falco, Posco, Prisca, Dora, Drogo, Dudo
+Generation 4: Lotho, Poppy, Ponto, Porto, Peony, Frodo, Daisy
+Generation 5: Angelica
+```
+
+**Get the direct ancestor of an entity**
+
+The following query uses `GetAncestor` to find the direct ancestor of a halfling, given that halfling's name:
+
+<!--
+        async Task<Halfling?> FindDirectAncestor(string name)
+            => await context.Halflings
+                .SingleOrDefaultAsync(
+                    ancestor => ancestor.PathFromPatriarch == context.Halflings
+                        .Single(descendent => descendent.Name == name).PathFromPatriarch
+                        .GetAncestor(1));
+-->
+[!code-csharp[FindDirectAncestor](../../../../samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs?name=FindDirectAncestor)]
+
+This translates to the following SQL:
+
+```sql
+SELECT TOP(2) [h].[Id], [h].[Name], [h].[PathFromPatriarch], [h].[YearOfBirth]
+FROM [Halflings] AS [h]
+WHERE [h].[PathFromPatriarch] = (
+    SELECT TOP(1) [h0].[PathFromPatriarch]
+    FROM [Halflings] AS [h0]
+    WHERE [h0].[Name] = @__name_0).GetAncestor(1)
+```
+
+Running this query for the halfling "Bilbo" returns "Bungo".
+
+**Get the direct descendents of an entity**
+
+The following query also uses `GetAncestor`, but this time to find the direct descendents of a halfling, given that halfling's name:
+
+<!--
+        IQueryable<Halfling> FindDirectDescendents(string name)
+            => context.Halflings.Where(
+                descendent => descendent.PathFromPatriarch.GetAncestor(1) == context.Halflings
+                    .Single(ancestor => ancestor.Name == name).PathFromPatriarch);
+-->
+[!code-csharp[FindDirectDescendents](../../../../samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs?name=FindDirectDescendents)]
+
+This translates to the following SQL:
+
+```sql
+SELECT [h].[Id], [h].[Name], [h].[PathFromPatriarch], [h].[YearOfBirth]
+FROM [Halflings] AS [h]
+WHERE [h].[PathFromPatriarch].GetAncestor(1) = (
+    SELECT TOP(1) [h0].[PathFromPatriarch]
+    FROM [Halflings] AS [h0]
+    WHERE [h0].[Name] = @__name_0)
+```
+
+Running this query for the halfling "Mungo" returns "Bungo", "Belba", "Longo", and "Linda".
+
+**Get all ancestors of an entity**
+
+`GetAncestor` is useful for searching up or down a single level, or, indeed, a specified number of levels. On the other hand, `IsDescendantOf` is useful for finding all ancestors or dependents. For example, the following query uses `IsDescendantOf` to find the all the ancestors of a halfling, given that halfling's name:
+
+<!--
+        IQueryable<Halfling> FindAllAncestors(string name)
+            => context.Halflings.Where(
+                    ancestor => context.Halflings
+                        .Single(
+                            descendent =>
+                                descendent.Name == name
+                                && ancestor.Id != descendent.Id)
+                        .PathFromPatriarch.IsDescendantOf(ancestor.PathFromPatriarch))
+                .OrderByDescending(ancestor => ancestor.PathFromPatriarch.GetLevel());
+-->
+[!code-csharp[FindAllAncestors](../../../../samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs?name=FindAllAncestors)]
+
+> [!IMPORTANT]
+> `IsDescendantOf` returns true for itself, which is why it is filtered out in the query above.
+
+This translates to the following SQL:
+
+```sql
+SELECT [h].[Id], [h].[Name], [h].[PathFromPatriarch], [h].[YearOfBirth]
+FROM [Halflings] AS [h]
+WHERE (
+    SELECT TOP(1) [h0].[PathFromPatriarch]
+    FROM [Halflings] AS [h0]
+    WHERE [h0].[Name] = @__name_0 AND [h].[Id] <> [h0].[Id]).IsDescendantOf([h].[PathFromPatriarch]) = CAST(1 AS bit)
+ORDER BY [h].[PathFromPatriarch].GetLevel() DESC
+```
+
+Running this query for the halfling "Bilbo" returns "Bungo", "Mungo", and "Balbo".
+
+**Get all descendents of an entity**
+
+The following query also uses `IsDescendantOf`, but this time to all the descendents of a halfling, given that halfling's name:
+
+<!--
+        IQueryable<Halfling> FindAllDescendents(string name)
+            => context.Halflings.Where(
+                    descendent => descendent.PathFromPatriarch.IsDescendantOf(
+                        context.Halflings
+                            .Single(
+                                ancestor =>
+                                    ancestor.Name == name
+                                    && descendent.Id != ancestor.Id)
+                            .PathFromPatriarch))
+                .OrderBy(descendent => descendent.PathFromPatriarch.GetLevel());
+-->
+[!code-csharp[FindAllDescendents](../../../../samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs?name=FindAllDescendents)]
+
+This translates to the following SQL:
+
+```sql
+SELECT [h].[Id], [h].[Name], [h].[PathFromPatriarch], [h].[YearOfBirth]
+FROM [Halflings] AS [h]
+WHERE [h].[PathFromPatriarch].IsDescendantOf((
+    SELECT TOP(1) [h0].[PathFromPatriarch]
+    FROM [Halflings] AS [h0]
+    WHERE [h0].[Name] = @__name_0 AND [h].[Id] <> [h0].[Id])) = CAST(1 AS bit)
+ORDER BY [h].[PathFromPatriarch].GetLevel()
+```
+
+Running this query for the halfling "Mungo" returns "Bungo", "Belba", "Longo", "Linda", "Bingo", "Bilbo", "Otho", "Falco", "Lotho", and "Poppy".
+
+**Finding a common ancestor**
+
+One of the most common questions asked about this particular family tree is, "who is the common ancestor of Frodo and Bilbo?" We can use `IsDescendantOf` to write such a query:
+
+<!--
+        async Task<Halfling?> FindCommonAncestor(Halfling first, Halfling second)
+            => await context.Halflings
+                .Where(
+                    ancestor => first.PathFromPatriarch.IsDescendantOf(ancestor.PathFromPatriarch)
+                                && second.PathFromPatriarch.IsDescendantOf(ancestor.PathFromPatriarch))
+                .OrderByDescending(ancestor => ancestor.PathFromPatriarch.GetLevel())
+                .FirstOrDefaultAsync();
+-->
+[!code-csharp[FindCommonAncestor](../../../../samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs?name=FindCommonAncestor)]
+
+This translates to the following SQL:
+
+```sql
+SELECT TOP(1) [h].[Id], [h].[Name], [h].[PathFromPatriarch], [h].[YearOfBirth]
+FROM [Halflings] AS [h]
+WHERE @__first_PathFromPatriarch_0.IsDescendantOf([h].[PathFromPatriarch]) = CAST(1 AS bit)
+  AND @__second_PathFromPatriarch_1.IsDescendantOf([h].[PathFromPatriarch]) = CAST(1 AS bit)
+ORDER BY [h].[PathFromPatriarch].GetLevel() DESC
+```
+
+Running this query with "Bilbo" and "Frodo" tells us that their common ancestor is "Balbo".
+
+### Updating hierarchies
+
+The normal [change tracking](xref:core/change-tracking/index) and [SaveChanges](xref:core/saving/basic) mechanisms can be used to update `hierarchyid` columns.
+
+**Re-parenting a sub-hierarchy**
+
+For example, I'm sure we all remember the scandal of SR 1752 (a.k.a. "LongoGate") when DNA testing revealed that Longo was not in fact the son of Mungo, but actually the son of Ponto! One fallout from this scandal was that the family tree needed to be re-written. In particular, Longo and all his descendents needed to be re-parented from Mungo to Ponto. `GetReparentedValue` can be used to do this. For example, first "Longo" and all his descendents are queried:
+
+<!--
+        var longoAndDescendents = await context.Halflings.Where(
+                descendent => descendent.PathFromPatriarch.IsDescendantOf(
+                    context.Halflings.Single(ancestor => ancestor.Name == "Longo").PathFromPatriarch))
+            .ToListAsync();
+-->
+[!code-csharp[LongoAndDescendents](../../../../samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs?name=LongoAndDescendents)]
+
+Then `GetReparentedValue` is used to update the `HierarchyId` for Longo and each descendent, followed by a call to `SaveChangesAsync`:
+
+<!--
+        foreach (var descendent in longoAndDescendents)
+        {
+            descendent.PathFromPatriarch
+                = descendent.PathFromPatriarch.GetReparentedValue(
+                    mungo.PathFromPatriarch, ponto.PathFromPatriarch)!;
+        }
+
+        await context.SaveChangesAsync();
+-->
+[!code-csharp[GetReparentedValue](../../../../samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs?name=GetReparentedValue)]
+
+This results in the following database update:
+
+```sql
+SET NOCOUNT ON;
+UPDATE [Halflings] SET [PathFromPatriarch] = @p0
+OUTPUT 1
+WHERE [Id] = @p1;
+UPDATE [Halflings] SET [PathFromPatriarch] = @p2
+OUTPUT 1
+WHERE [Id] = @p3;
+UPDATE [Halflings] SET [PathFromPatriarch] = @p4
+OUTPUT 1
+WHERE [Id] = @p5;
+```
+
+Using these parameters:
+
+```text
+ @p1='9',
+ @p0='0x7BC0' (Nullable = false) (Size = 2) (DbType = Object),
+ @p3='16',
+ @p2='0x7BD6' (Nullable = false) (Size = 2) (DbType = Object),
+ @p5='23',
+ @p4='0x7BD6B0' (Nullable = false) (Size = 3) (DbType = Object)
+ ```
+
+> [!NOTE]
+> The parameters values for `HierarchyId` properties are sent to the database in their compact, binary format.
+
+Following the update, querying for the descendents of "Mungo" returns "Bungo", "Belba", "Linda", "Bingo", "Bilbo", "Falco", and "Poppy", while querying for the descendents of "Ponto" returns "Longo", "Rosa", "Polo", "Otho", "Posco", "Prisca", "Lotho", "Ponto", "Porto", "Peony", and "Angelica".
+
+## Raw SQL queries for unmapped types
+
+EF7 introduced [raw SQL queries returning scalar types](xref:core/querying/sql-queries#querying-scalar-(non-entity)-types). This is enhanced in EF8 to include raw SQL queries returning any mappable CLR type, without including that type in the EF model.
+
+> [!TIP]
+> The code shown here comes from [RawSqlSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore8/RawSqlSample.cs).
+
+Queries using unmapped types are executed using <xref:Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.SqlQuery*> or <xref:Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.SqlQueryRaw*>. The former uses string interpolation to parameterize the query, which helps ensure that all non-constant values are parameterized. For example, consider the following database table:
+
+```sql
+CREATE TABLE [Posts] (
+    [Id] int NOT NULL IDENTITY,
+    [Title] nvarchar(max) NOT NULL,
+    [Content] nvarchar(max) NOT NULL,
+    [PublishedOn] date NOT NULL,
+    [BlogId] int NOT NULL,
+);
+```
+
+`SqlQuery` can be used to query this table and return instances of a `BlogPost` type with properties corresponding to the columns in the table:
+
+For example:
+
+```csharp
+public class BlogPost
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+    public DateOnly PublishedOn { get; set; }
+    public int BlogId { get; set; }
+}
+```
+
+For example:
+
+<!--
+        var start = new DateOnly(2022, 1, 1);
+        var end = new DateOnly(2023, 1, 1);
+        var postsIn2022 =
+            await context.Database
+                .SqlQuery<BlogPost>($"SELECT * FROM Posts as p WHERE p.PublishedOn >= {start} AND p.PublishedOn < {end}")
+                .ToListAsync();
+-->
+[!code-csharp[SqlQueryAllColumns](../../../../samples/core/Miscellaneous/NewInEFCore8/RawSqlSample.cs?name=SqlQueryAllColumns)]
+
+This query is parameterized and executed as:
+
+```sql
+SELECT * FROM Posts as p WHERE p.PublishedOn >= @p0 AND p.PublishedOn < @p1
+```
+
+The type used for query results can contain common mapping constructs supported by EF Core, such as parameterized constructors and mapping attributes. For example:
+
+<!--
+    public class BlogPost
+    {
+        public BlogPost(string blogTitle, string content, DateOnly publishedOn)
+        {
+            BlogTitle = blogTitle;
+            Content = content;
+            PublishedOn = publishedOn;
+        }
+
+        public int Id { get; private set; }
+
+        [Column("Title")]
+        public string BlogTitle { get; set; }
+
+        public string Content { get; set; }
+        public DateOnly PublishedOn { get; set; }
+        public int BlogId { get; set; }
+    }
+-->
+[!code-csharp[BlogPost](../../../../samples/core/Miscellaneous/NewInEFCore8/RawSqlSample.cs?name=BlogPost)]
+
+> [!NOTE]
+> Types used in this way do not have keys defined and cannot have relationships to other types. Types with relationships must be mapped in the model.
+
+The type used must have a property for every value in the result set, but do not need to match any table in the database. For example, the following type represents only a subset of information for each post, and includes the blog name, which comes from the `Blogs` table:
+
+<!--
+    public class PostSummary
+    {
+        public string BlogName { get; set; }
+        public string PostTitle { get; set; }
+        public DateOnly PublishedOn { get; set; }
+    }
+-->
+[!code-csharp[PostSummary](../../../../samples/core/Miscellaneous/NewInEFCore8/RawSqlSample.cs?name=PostSummary)]
+
+And can be queried using `SqlQuery` in the same way as before:
+
+<!--
+        var summaries =
+            await context.Database.SqlQuery<PostSummary>(
+                    @$"SELECT b.Name AS BlogName, p.Title AS PostTitle, p.PublishedOn
+                    FROM Posts AS p
+                    INNER JOIN Blogs AS b ON p.BlogId = b.Id")
+                .ToListAsync();
+-->
+[!code-csharp[SqlQueryJoin](../../../../samples/core/Miscellaneous/NewInEFCore8/RawSqlSample.cs?name=SqlQueryJoin)]
+
+One nice feature of `SqlQuery` is that it returns an `IQueryable` which can be composed on using LINQ. For example, a 'Where' clause can be added to the query above:
+
+<!--
+        var summariesIn2022 =
+            await context.Database.SqlQuery<PostSummary>(
+                    @$"SELECT b.Name AS BlogName, p.Title AS PostTitle, p.PublishedOn
+                    FROM Posts AS p
+                    INNER JOIN Blogs AS b ON p.BlogId = b.Id")
+                .Where(p => p.PublishedOn >= start && p.PublishedOn < end)
+                .ToListAsync();
+-->
+[!code-csharp[SqlQueryJoinComposed](../../../../samples/core/Miscellaneous/NewInEFCore8/RawSqlSample.cs?name=SqlQueryJoinComposed)]
+
+This is executed as:
+
+```sql
+SELECT [n].[BlogName], [n].[PostTitle], [n].[PublishedOn]
+FROM (
+         SELECT b.Name AS BlogName, p.Title AS PostTitle, p.PublishedOn
+         FROM Posts AS p
+                  INNER JOIN Blogs AS b ON p.BlogId = b.Id
+     ) AS [n]
+WHERE [n].[PublishedOn] >= @__cutoffDate_1 AND [n].[PublishedOn] < @__end_2
+```
+
+At this point it is worth remembering that all of the above can be done completely in LINQ without the need to write any SQL. This includes returning instances of an unmapped type like `PostSummary`. For example, the preceding query can be written in LINQ as:
+
+```csharp
+var summaries =
+    await context.Posts.Select(
+            p => new PostSummary
+            {
+                BlogName = p.Blog.Name,
+                PostTitle = p.Title,
+                PublishedOn = p.PublishedOn,
+            })
+        .Where(p => p.PublishedOn >= start && p.PublishedOn < end)
+        .ToListAsync();
+```
+
+Which translates to much cleaner SQL:
+
+```sql
+SELECT [b].[Name] AS [BlogName], [p].[Title] AS [PostTitle], [p].[PublishedOn]
+FROM [Posts] AS [p]
+INNER JOIN [Blogs] AS [b] ON [p].[BlogId] = [b].[Id]
+WHERE [p].[PublishedOn] >= @__start_0 AND [p].[PublishedOn] < @__end_1
+```
+
+> [!TIP]
+> EF is able to generate cleaner SQL when it is responsible for the entire query than it is when composing over user-supplied SQL because, in the former case, the full semantics of the query is available to EF.
+
+So far, all the queries have been executed directly against tables. `SqlQuery` can also be used to return results from a view without mapping the view type in the EF model. For example:
+
+<!--
+        var summariesFromView =
+            await context.Database.SqlQuery<PostSummary>(
+                    @$"SELECT * FROM PostAndBlogSummariesView")
+                .Where(p => p.PublishedOn >= start && p.PublishedOn < end)
+                .ToListAsync();
+-->
+[!code-csharp[SqlQueryView](../../../../samples/core/Miscellaneous/NewInEFCore8/RawSqlSample.cs?name=SqlQueryView)]
+
+Likewise, `SqlQuery` can be used for the results of a function:
+
+<!--
+        var summariesFromFunc =
+            await context.Database.SqlQuery<PostSummary>(
+                    @$"SELECT * FROM GetPostsPublishedAfter({start})")
+                .Where(p => p.PublishedOn < end)
+                .ToListAsync();
+-->
+[!code-csharp[SqlQueryFunction](../../../../samples/core/Miscellaneous/NewInEFCore8/RawSqlSample.cs?name=SqlQueryFunction)]
+
+The returned `IQueryable` can be composed upon when it is the result of a view or function, just like it can be for the result of a table query. Stored procedures can be also be executed using `SqlQuery`, but most databases do not support composing over them. For example:
+
+<!--
+        var summariesFromStoredProc =
+            await context.Database.SqlQuery<PostSummary>(
+                    @$"exec GetRecentPostSummariesProc")
+                .ToListAsync();
+-->
+[!code-csharp[SqlQueryStoredProc](../../../../samples/core/Miscellaneous/NewInEFCore8/RawSqlSample.cs?name=SqlQueryStoredProc)]
+
+## Enhancements to lazy-loading
+
+### Lazy-loading for no-tracking queries
+
+EF8 adds support for [lazy-loading of navigations](xref:core/querying/related-data/lazy) on entities that are not being tracked by the `DbContext`. This means a no-tracking query can be followed by lazy-loading of navigations on the entities returned by the no-tracking query.
+
+> [!TIP]
+> The code for the lazy-loading examples shown below comes from [LazyLoadingSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore8/LazyLoadingSample.cs).
+
+For example, consider a no-tracking query for blogs:
+
+<!--
+var blogs = await context.Blogs.AsNoTracking().ToListAsync();
+-->
+[!code-csharp[NoTrackingForBlogs](../../../../samples/core/Miscellaneous/NewInEFCore8/LazyLoadingSample.cs?name=NoTrackingForBlogs)]
+
+If `Blog.Posts` is configured for lazy-loading, for example, using lazy-loading proxies, then accessing `Posts` will cause it to load from the database:
+
+<!--
+        Console.WriteLine();
+        Console.Write("Choose a blog: ");
+        if (int.TryParse(ReadLine(), out var blogId))
+        {
+            Console.WriteLine("Posts:");
+            foreach (var post in blogs[blogId - 1].Posts)
+            {
+                Console.WriteLine($"  {post.Title}");
+            }
+        }
+-->
+[!code-csharp[ChooseABlog](../../../../samples/core/Miscellaneous/NewInEFCore8/LazyLoadingSample.cs?name=ChooseABlog)]
+
+EF8 also reports whether or not a given navigation is loaded for entities not tracked by the context. For example:
+
+<!--
+        foreach (var blog in blogs)
+        {
+            if (context.Entry(blog).Collection(e => e.Posts).IsLoaded)
+            {
+                Console.WriteLine($" Posts for blog '{blog.Name}' are loaded.");
+            }
+        }
+-->
+[!code-csharp[IsLoaded](../../../../samples/core/Miscellaneous/NewInEFCore8/LazyLoadingSample.cs?name=IsLoaded)]
+
+There are a few important considerations when using lazy-loading in this way:
+
+- Lazy-loading will only succeed until the `DbContext` used to query the entity is disposed.
+- Entities queried in this way maintain a reference to their `DbContext`, even though they are not tracked by it. Care should be taken to avoid memory leaks if the entity instances will have long lifetimes.
+- Explicitly detaching the entity by setting its state to `EntityState.Detached` severs the reference to the `DbContext` and lazy-loading will no longer work.
+- Remember that all lazy-loading uses synchronous I/O, since there is no way to access a property in an asynchronous manner.
+
+Lazy-loading from untracked entities works for both [lazy-loading proxies](xref:core/querying/related-data/lazy#lazy-loading-with-proxies) and [lazy-loading without proxies](xref:core/querying/related-data/lazy#lazy-loading-without-proxies).
+
+### Explicit loading from untracked entities
+
+EF8 supports loading of navigations on untracked entities even when the entity or navigation is not configured for lazy-loading. Unlike with lazy-loading, this [explicit loading](xref:core/querying/related-data/explicit) can be done asynchronously. For example:
+
+<!--
+            await context.Entry(blog).Collection(e => e.Posts).LoadAsync();
+-->
+[!code-csharp[ExplicitLoad](../../../../samples/core/Miscellaneous/NewInEFCore8/LazyLoadingSample.cs?name=ExplicitLoad)]
+
+### Opt-out of lazy-loading for specific navigations
+
+EF8 allows configuration of specific navigations to not lazy-load, even when everything else is set up to do so. For example, to configure the `Post.Author` navigation to not lazy-load, do the following:
+
+<!--
+        modelBuilder
+            .Entity<Post>()
+            .Navigation(p => p.Author)
+            .EnableLazyLoading(false);
+-->
+[!code-csharp[NoLazyLoading](../../../../samples/core/Miscellaneous/NewInEFCore8/LazyLoadingSample.cs?name=NoLazyLoading)]
+
+Disabling Lazy-loading like this works for both [lazy-loading proxies](xref:core/querying/related-data/lazy#lazy-loading-with-proxies) and [lazy-loading without proxies](xref:core/querying/related-data/lazy#lazy-loading-without-proxies).
+
+Lazy-loading proxies work by overriding virtual navigation properties. In classic EF6 applications, a common source of bugs is forgetting to make a navigation virtual, since the navigation will then silently not lazy-load. Therefore, EF Core proxies throw by default when a navigation is not virtual.
+
+This can be changed in EF8 to opt-in to the classic EF6 behavior such that a navigation can be made to not lazy-load simply by making the navigation non-virtual. This opt-in is configured as part of the call to `UseLazyLoadingProxies`. For example:
+
+<!--
+        optionsBuilder.UseLazyLoadingProxies(ignoreNonVirtualNavigations: true);
+-->
+[!code-csharp[IgnoreNonVirtualNavigations](../../../../samples/core/Miscellaneous/NewInEFCore8/LazyLoadingSample.cs?name=IgnoreNonVirtualNavigations)]
+
+## Access to tracked entities
+
+### Lookup tracked entities by primary, alternate, or foreign key
+
+Internally, EF maintains data structures for finding tracked entities by primary, alternate, or foreign key. These data structures are used for efficient fixup between related entities when new entities are tracked or relationships change.
+
+EF8 contains new public APIs so that applications can now use these data structures to efficiently lookup tracked entities. These APIs are accessed through the <xref:Microsoft.EntityFrameworkCore.ChangeTracking.LocalView`1> of the entity type. For example, to lookup a tracked entity by its primary key:
+
+<!--
+        var blogEntry = context.Blogs.Local.FindEntry(2)!;
+-->
+[!code-csharp[LookupByPrimaryKey](../../../../samples/core/Miscellaneous/NewInEFCore8/LookupByKeySample.cs?name=LookupByPrimaryKey)]
+
+> [!TIP]
+> The code shown here comes from [LookupByKeySample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore8/LookupByKeySample.cs).
+
+The [`FindEntry`](https://github.com/dotnet/efcore/blob/81886272a761df8fafe4970b895b1e1fe35effb8/src/EFCore/ChangeTracking/LocalView.cs#L543) method returns either the <xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry`1> for the tracked entity, or `null` if no entity with the given key is being tracked. Like all methods on `LocalView`, the database is never queried, even if the entity is not found. The returned entry contains the entity itself, as well as tracking information. For example:
+
+<!--
+        Console.WriteLine($"Blog '{blogEntry.Entity.Name}' with key {blogEntry.Entity.Id} is tracked in the '{blogEntry.State}' state.");
+-->
+[!code-csharp[UseEntry](../../../../samples/core/Miscellaneous/NewInEFCore8/LookupByKeySample.cs?name=UseEntry)]
+
+Looking up an entity by anything other than a primary key requires that the property name be specified. For example, to look up by an alternate key:
+
+<!--
+        var siteEntry = context.Websites.Local.FindEntry(nameof(Website.Uri), new Uri("https://www.bricelam.net/"))!;
+-->
+[!code-csharp[LookupByAlternateKey](../../../../samples/core/Miscellaneous/NewInEFCore8/LookupByKeySample.cs?name=LookupByAlternateKey)]
+
+Or to look up by a unique foreign key:
+
+<!--
+        var blogAtSiteEntry = context.Blogs.Local.FindEntry(nameof(Blog.SiteUri), new Uri("https://www.bricelam.net/"))!;
+-->
+[!code-csharp[LookupByUniqueForeignKey](../../../../samples/core/Miscellaneous/NewInEFCore8/LookupByKeySample.cs?name=LookupByUniqueForeignKey)]
+
+So far, the lookups have always returned a single entry, or `null`. However, some lookups can return more than one entry, such as when looking up by a non-unique foreign key. The [`GetEntries`](https://github.com/dotnet/efcore/blob/81886272a761df8fafe4970b895b1e1fe35effb8/src/EFCore/ChangeTracking/LocalView.cs#L664) method should be used for these lookups. For example:
+
+<!--
+        var postEntries = context.Posts.Local.GetEntries(nameof(Post.BlogId), 2);
+-->
+[!code-csharp[LookupByForeignKey](../../../../samples/core/Miscellaneous/NewInEFCore8/LookupByKeySample.cs?name=LookupByForeignKey)]
+
+In all these cases, the value being used for the lookup is either a primary key, alternate key, or foreign key value. EF uses its internal data structures for these lookups. However, lookups by value can also be used for the value of any property or combination of properties. For example, to find all archived posts:
+
+<!--
+        var archivedPostEntries = context.Posts.Local.GetEntries(nameof(Post.Archived), true);
+-->
+[!code-csharp[LookupByAnyProperty](../../../../samples/core/Miscellaneous/NewInEFCore8/LookupByKeySample.cs?name=LookupByAnyProperty)]
+
+This lookup requires a scan of all tracked `Post` instances, and so will be less efficient than key lookups. However, it is usually still faster than naive queries using <xref:Microsoft.EntityFrameworkCore.ChangeTracking.ChangeTracker.Entries%60`1?displayProperty=nameWithType>.
+
+Finally, it is also possible to perform lookups against composite keys, other combinations of multiple properties, or when the property type is not known at compile time. For example:
+
+<!--
+        var postTagEntry = context.Set<PostTag>().Local.FindEntryUntyped(new object[] { 4, "TagEF" });
+-->
+[!code-csharp[LookupByCompositePrimaryKey](../../../../samples/core/Miscellaneous/NewInEFCore8/LookupByKeySample.cs?name=LookupByCompositePrimaryKey)]
+
+## Model building
+
+### Discriminator columns have max length
+
+In EF8, string discriminator columns used for [TPH inheritance mapping](xref:core/modeling/inheritance) are now configured with a max length. This length is calculated as the smallest Fibonacci number that covers all defined discriminator values. For example, consider the following hierarchy:
+
+```csharp
+public abstract class Document
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+}
+
+public abstract class Book : Document
+{
+    public string? Isbn { get; set; }
+}
+
+public class PaperbackEdition : Book
+{
+}
+
+public class HardbackEdition : Book
+{
+}
+
+public class Magazine : Document
+{
+    public int IssueNumber { get; set; }
+}
+```
+
+With the convention of using the class names for discriminator values, the possible values here are "PaperbackEdition", "HardbackEdition", and "Magazine", and hence the discriminator column is configured for a max length of 21. For example, when using SQL Server:
+
+```sql
+CREATE TABLE [Documents] (
+    [Id] int NOT NULL IDENTITY,
+    [Title] nvarchar(max) NOT NULL,
+    [Discriminator] nvarchar(21) NOT NULL,
+    [Isbn] nvarchar(max) NULL,
+    [IssueNumber] int NULL,
+    CONSTRAINT [PK_Documents] PRIMARY KEY ([Id]),
+```
+
+> [!TIP]
+> Fibonacci numbers are used to limit the number of times a migration is generated to change the column length as new types are added to the hierarchy.
+
+### DateOnly/TimeOnly supported on SQL Server
+
+The <xref:System.DateOnly> and <xref:System.TimeOnly> types were introduced in .NET 6 and have been supported for several database providers (e.g. SQLite, MySQL, and PostgreSQL) since their introduction. For SQL Server, the recent release of a [Microsoft.Data.SqlClient](https://www.nuget.org/packages/Microsoft.Data.SqlClient/) package targeting .NET 6 has allowed [ErikEJ to add support for these types at the ADO.NET level](https://github.com/dotnet/SqlClient/pull/1813). This in turn paved the way for support in EF8 for `DateOnly` and `TimeOnly` as properties in entity types.
+
+> [!TIP]
+> `DateOnly` and `TimeOnly` can be used in EF Core 6 and 7 using the [ErikEJ.EntityFrameworkCore.SqlServer.DateOnlyTimeOnly](https://www.nuget.org/packages/ErikEJ.EntityFrameworkCore.SqlServer.DateOnlyTimeOnly) community package from [@ErikEJ](https://github.com/ErikEJ).
+
+For example, consider the following EF model for British schools:
+
+<!--
+public class School
+{
+    public int Id { get; set; }
+    public string Name { get; set; } = null!;
+    public DateOnly Founded { get; set; }
+    public List<Term> Terms { get; } = new();
+    public List<OpeningHours> OpeningHours { get; } = new();
+}
+
+public class Term
+{
+    public int Id { get; set; }
+    public string Name { get; set; } = null!;
+    public DateOnly FirstDay { get; set; }
+    public DateOnly LastDay { get; set; }
+    public School School { get; set; } = null!;
+}
+
+[Owned]
+public class OpeningHours
+{
+    public OpeningHours(DayOfWeek dayOfWeek, TimeOnly? opensAt, TimeOnly? closesAt)
+    {
+        DayOfWeek = dayOfWeek;
+        OpensAt = opensAt;
+        ClosesAt = closesAt;
+    }
+
+    public DayOfWeek DayOfWeek { get; private set; }
+    public TimeOnly? OpensAt { get; set; }
+    public TimeOnly? ClosesAt { get; set; }
+}
+-->
+[!code-csharp[BritishSchools](../../../../samples/core/Miscellaneous/NewInEFCore8/DateOnlyTimeOnlySample.cs?name=BritishSchools)]
+
+> [!TIP]
+> The code shown here comes from [DateOnlyTimeOnlySample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore8/DateOnlyTimeOnlySample.cs).
+
+> [!NOTE]
+> This model represents only British schools and stores times as local (GMT) times. Handling different timezones would complicate this code significantly. Note that using `DateTimeOffset` would not help here, since opening and closing times have different offsets depending whether daylight saving time is active or not.
+
+These entity types map to the following tables when using SQL Server. Notice that the `DateOnly` properties map to `date` columns, and the `TimeOnly` properties map to `time` columns.
+
+```sql
+CREATE TABLE [Schools] (
+    [Id] int NOT NULL IDENTITY,
+    [Name] nvarchar(max) NOT NULL,
+    [Founded] date NOT NULL,
+    CONSTRAINT [PK_Schools] PRIMARY KEY ([Id]));
+
+CREATE TABLE [OpeningHours] (
+    [SchoolId] int NOT NULL,
+    [Id] int NOT NULL IDENTITY,
+    [DayOfWeek] int NOT NULL,
+    [OpensAt] time NULL,
+    [ClosesAt] time NULL,
+    CONSTRAINT [PK_OpeningHours] PRIMARY KEY ([SchoolId], [Id]),
+    CONSTRAINT [FK_OpeningHours_Schools_SchoolId] FOREIGN KEY ([SchoolId]) REFERENCES [Schools] ([Id]) ON DELETE CASCADE);
+
+CREATE TABLE [Term] (
+    [Id] int NOT NULL IDENTITY,
+    [Name] nvarchar(max) NOT NULL,
+    [FirstDay] date NOT NULL,
+    [LastDay] date NOT NULL,
+    [SchoolId] int NOT NULL,
+    CONSTRAINT [PK_Term] PRIMARY KEY ([Id]),
+    CONSTRAINT [FK_Term_Schools_SchoolId] FOREIGN KEY ([SchoolId]) REFERENCES [Schools] ([Id]) ON DELETE CASCADE);
+```
+
+Queries using `DateOnly` and `TimeOnly` work in the expected manner. For example, the following LINQ query finds schools that are currently open:
+
+<!--
+            openSchools = await context.Schools
+                .Where(
+                    s => s.Terms.Any(
+                             t => t.FirstDay <= today
+                                  && t.LastDay >= today)
+                         && s.OpeningHours.Any(
+                             o => o.DayOfWeek == dayOfWeek
+                                  && o.OpensAt < time && o.ClosesAt >= time))
+                .ToListAsync();
+-->
+[!code-csharp[OpenSchools](../../../../samples/core/Miscellaneous/NewInEFCore8/DateOnlyTimeOnlySample.cs?name=OpenSchools)]
+
+This query translates to the following SQL, as shown by <xref:Microsoft.EntityFrameworkCore.EntityFrameworkQueryableExtensions.ToQueryString*>:
+
+```sql
+DECLARE @__today_0 date = '2023-02-07';
+DECLARE @__dayOfWeek_1 int = 2;
+DECLARE @__time_2 time = '19:53:40.4798052';
+
+SELECT [s].[Id], [s].[Founded], [s].[Name], [o0].[SchoolId], [o0].[Id], [o0].[ClosesAt], [o0].[DayOfWeek], [o0].[OpensAt]
+FROM [Schools] AS [s]
+LEFT JOIN [OpeningHours] AS [o0] ON [s].[Id] = [o0].[SchoolId]
+WHERE EXISTS (
+    SELECT 1
+    FROM [Term] AS [t]
+    WHERE [s].[Id] = [t].[SchoolId] AND [t].[FirstDay] <= @__today_0 AND [t].[LastDay] >= @__today_0) AND EXISTS (
+    SELECT 1
+    FROM [OpeningHours] AS [o]
+    WHERE [s].[Id] = [o].[SchoolId] AND [o].[DayOfWeek] = @__dayOfWeek_1 AND [o].[OpensAt] < @__time_2 AND [o].[ClosesAt] >= @__time_2)
+ORDER BY [s].[Id], [o0].[SchoolId]
+```
+
+`DateOnly` and `TimeOnly` can also be used in JSON columns. For example, `OpeningHours` can be saved as a JSON document, resulting in data that looks like this:
+
+| Column       | Value                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| Id           | 2                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| Name         | Farr High School                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| Founded      | 1964-05-01                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| OpeningHours | <pre>[<br>  { "DayOfWeek": "Sunday", "ClosesAt": null, "OpensAt": null },<br>  { "DayOfWeek": "Monday", "ClosesAt": "15:35:00", "OpensAt": "08:45:00" },<br>  { "DayOfWeek": "Tuesday", "ClosesAt": "15:35:00", "OpensAt": "08:45:00" },<br>  { "DayOfWeek": "Wednesday", "ClosesAt": "15:35:00", "OpensAt": "08:45:00" },<br>  { "DayOfWeek": "Thursday", "ClosesAt": "15:35:00", "OpensAt": "08:45:00" },<br>  { "DayOfWeek": "Friday", "ClosesAt": "12:50:00", "OpensAt": "08:45:00" },<br>  { "DayOfWeek": "Saturday", "ClosesAt": null, "OpensAt": null }<br>] |
+
+Combining two features from EF8, we can now query for opening hours by indexing into the JSON collection. For example:
+
+<!--
+            openSchools = await context.Schools
+                .Where(
+                    s => s.Terms.Any(
+                             t => t.FirstDay <= today
+                                  && t.LastDay >= today)
+                         && s.OpeningHours[(int)dayOfWeek].OpensAt < time
+                         && s.OpeningHours[(int)dayOfWeek].ClosesAt >= time)
+                .ToListAsync();
+-->
+[!code-csharp[OpenSchoolsJson](../../../../samples/core/Miscellaneous/NewInEFCore8/DateOnlyTimeOnlySample.cs?name=OpenSchoolsJson)]
+
+This query translates to the following SQL, as shown by <xref:Microsoft.EntityFrameworkCore.EntityFrameworkQueryableExtensions.ToQueryString*>:
+
+```sql
+DECLARE @__today_0 date = '2023-02-07';
+DECLARE @__dayOfWeek_1 int = 2;
+DECLARE @__time_2 time = '20:14:34.7795877';
+
+SELECT [s].[Id], [s].[Founded], [s].[Name], [s].[OpeningHours]
+FROM [Schools] AS [s]
+WHERE EXISTS (
+    SELECT 1
+    FROM [Term] AS [t]
+    WHERE [s].[Id] = [t].[SchoolId] AND [t].[FirstDay] <= @__today_0
+      AND [t].[LastDay] >= @__today_0)
+      AND CAST(JSON_VALUE([s].[OpeningHours],'$[' + CAST(CAST(@__dayOfWeek_1 AS int) AS nvarchar(max)) + '].OpensAt') AS time) < @__time_2
+      AND CAST(JSON_VALUE([s].[OpeningHours],'$[' + CAST(CAST(@__dayOfWeek_1 AS int) AS nvarchar(max)) + '].ClosesAt') AS time) >= @__time_2
+```
+
+Finally, updates and deletes can be accomplished with [tracking and SaveChanges](xref:core/saving/basic), or using [ExecuteUpdate/ExecuteDelete](xref:core/what-is-new/ef-core-7.0/whatsnew#executeupdate-and-executedelete-bulk-updates). For example:
+
+<!--
+        await context.Schools
+            .Where(e => e.Terms.Any(t => t.LastDay.Year == 2022))
+            .SelectMany(e => e.Terms)
+            .ExecuteUpdateAsync(s => s.SetProperty(t => t.LastDay, t => t.LastDay.AddDays(1)));
+-->
+[!code-csharp[UpdateForSnowDay](../../../../samples/core/Miscellaneous/NewInEFCore8/DateOnlyTimeOnlySample.cs?name=UpdateForSnowDay)]
+
+This update translates to the following SQL:
+
+```sql
+UPDATE [t0]
+SET [t0].[LastDay] = DATEADD(day, CAST(1 AS int), [t0].[LastDay])
+FROM [Schools] AS [s]
+INNER JOIN [Term] AS [t0] ON [s].[Id] = [t0].[SchoolId]
+WHERE EXISTS (
+    SELECT 1
+    FROM [Term] AS [t]
+    WHERE [s].[Id] = [t].[SchoolId] AND DATEPART(year, [t].[LastDay]) = 2022)
+```
+
+### Reverse engineer Synapse and Dynamics 365 TDS
+
+EF8 reverse engineering (a.k.a. scaffolding from an existing database) now supports [Synapse Serverless SQL Pool](/azure/synapse-analytics/sql/on-demand-workspace-overview) and [Dynamics 365 TDS Endpoint](/power-apps/developer/data-platform/dataverse-sql-query) databases.
+
+> [!WARNING]
+> These database systems have differences from normal SQL Server and Azure SQL databases. These differences mean that not all EF Core functionality is supported when writing queries against or performing other operations with these database systems.
+
+## Enhancements to Math translations
+
+[Generic math](/dotnet/standard/generics/math) interfaces were introduced in .NET 7. Concrete types like `double` and `float` implemented these interfaces adding new APIs mirroring the existing functionality of [Math](/dotnet/api/system.math) and [MathF](/dotnet/api/system.mathf).
+
+EF Core 8 translates calls to these generic math APIs in LINQ using providers' existing SQL translations for `Math` and `MathF`. This means you're now free to choose between calls either like `Math.Sin` or `double.Sin` in your EF queries.
+
+We worked with the .NET team to add two new generic math methods in .NET 8 that are implemented on `double` and `float`. These are also translated to SQL in EF Core 8.
+
+| .NET             | SQL     |
+|------------------|---------|
+| DegreesToRadians | RADIANS |
+| RadiansToDegrees | DEGREES |
+
+Finally, we worked with Eric Sink in the [SQLitePCLRaw project](https://github.com/ericsink/SQLitePCL.raw) to enable the [SQLite math functions](https://sqlite.org/lang_mathfunc.html) in their builds of the native SQLite library. This includes the native library you get by default when you install the EF Core SQLite provider. This enables several new SQL translations in LINQ including: Acos, Acosh, Asin, Asinh, Atan, Atan2, Atanh, Ceiling, Cos, Cosh, DegreesToRadians, Exp, Floor, Log, Log2, Log10, Pow, RadiansToDegrees, Sign, Sin, Sinh, Sqrt, Tan, Tanh, and Truncate.
+
+## Checking for pending model changes
+
+We've added a new `dotnet ef` command to check whether any model changes have been made since the last migration. This can be useful in CI/CD scenarios to ensure you or a teammate didn't forget to add a migration.
+
+```dotnetcli
+dotnet ef migrations has-pending-model-changes
+```
+
+You can also perform this check programmatically in your application or tests using the new `dbContext.Database.HasPendingModelChanges()` method.
+
+## Enhancements to SQLite scaffolding
+
+SQLite only supports four primitive data types--INTEGER, REAL, TEXT, and BLOB. Previously, this meant that when you reverse engineered a SQLite database to [scaffold an EF Core model](xref:core/managing-schemas/scaffolding), the resulting entity types would only included properties of type `long`, `double`, `string`, and `byte[]`. Additional .NET types are supported by the EF Core SQLite provider by converting between them and one of the four primitive SQLite types.
+
+In EF Core 8, we now use the data format and column type name in addition to the SQLite type in order to determine a more appropriate .NET type to use in the model. The following tables show some of the cases where the additional information leads to better property types in the model.
+
+| Column type name | .NET type                  |
+| ---------------- | -------------------------- |
+| BOOLEAN          | ~~byte[]~~&nbsp;**bool**   |
+| SMALLINT         | ~~long~~&nbsp;**short**    |
+| INT              | ~~long~~&nbsp;**int**      |
+| BIGINT           | long                       |
+| STRING           | ~~byte[]~~&nbsp;**string** |
+
+| Data format                            | .NET type                    |
+| -------------------------------------- | ---------------------------- |
+| '0.0'                                  | ~~string~~&nbsp;**decimal**  |
+| '1970-01-01'                           | ~~string~~&nbsp;**DateOnly** |
+| '1970-01-01 00:00:00'                  | ~~string~~&nbsp;**DateTime** |
+| '00:00:00'                             | ~~string~~&nbsp;**TimeSpan** |
+| '00000000-0000-0000-0000-000000000000' | ~~string~~&nbsp;**Guid**     |
+
+## Sentinel values and database defaults
+
+Databases allow columns to be configured to generate a default value if no value is provided when inserting a row. This can be represented in EF using `HasDefaultValue` for constants:
+
+```csharp
+b.Property(e => e.Status).HasDefaultValue("Hidden");
+```
+
+Or `HasDefaultValueSql` for arbitrary SQL clauses:
+
+```csharp
+b.Property(e => e.LeaseDate).HasDefaultValueSql("getutcdate()");
+```
+
+> [!TIP]
+> The code shown below comes from [DefaultConstraintSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore8/DefaultConstraintSample.cs).
+
+In order for EF to make use of this, it must determine when and when not to send a value for the column. By default, EF uses the CLR default as a sentinel for this. That is, when the value of `Status` or `LeaseDate` in the examples above are the CLR defaults for these types, then EF _interprets that to mean that the property has not been set_, and so does not send a value to the database. This works well for reference types--for example, if the `string` property `Status` is `null`, then EF doesn't send `null` to the database, but rather does not include any value so that the database default (`"Hidden"`) is used. Likewise, for the `DateTime` property `LeaseDate`, EF will not insert the CLR default value of `1/1/0001 12:00:00 AM`, but will instead omit this value so that database default is used.
+
+However, in some cases the CLR default value is a valid value to insert. EF8 handles this by allowing the sentinel value for a column to change. For example, consider an integer column configured with a database default:
+
+```csharp
+b.Property(e => e.Credits).HasDefaultValueSql(10);
+```
+
+In this case, we want the new entity to be inserted with the given number of credits, unless this is not specified, in which case 10 credits are assigned. However, this means that inserting a record with zero credits is not possible, since zero is the CLR default, and hence will cause EF to send no value. In EF8, this can be fixed by changing the sentinel for the property from zero to `-1`:
+
+```csharp
+b.Property(e => e.Credits).HasDefaultValueSql(10).HasSentinel(-1);
+```
+
+EF will now only use the database default if `Credits` is set to `-1`; a value of zero will be inserted like any other amount.
+
+It can often be useful to reflect this in the entity type as well as in the EF configuration. For example:
+
+```csharp
+public class Person
+{
+    public int Id { get; set; }
+    public int Credits { get; set; } = -1;
+}
+```
+
+This means that the sentinel value of -1 gets set automatically when the instance is created, meaning that the property starts in its "not-set" state.
+
+> [!TIP]
+> If you want to configure the database default constraint for use when `Migrations` creates the column, but you want EF to always insert a value, then configure the property as not-generated. For example, `b.Property(e => e.Credits).HasDefaultValueSql(10).ValueGeneratedNever();`.
+
+### Database defaults for booleans
+
+Boolean properties present an extreme form of this problem, since the CLR default (`false`) is one of only two valid values. This means that a `bool` property with a database default constraint will only have a value inserted if that value is `true`. When the database default value is `false`, then this means when the property value is `false`, then the database default will be used, which is `false`. Otherwise, if the property value is `true`, then `true` will be inserted. So when the database default is `false`, then the database column ends up with the correct value.
+
+On the other hand, if the database default value is `true`, this means when the property value is `false`, then the database default will be used, which is `true`! And when the property value is `true`, then `true` will be inserted. So, the value in the column will always end `true` in the database, regardless of what the property value is.
+
+EF8 fixes this problem by setting the sentinel for bool properties to the same value as the database default value. Both cases above then result in the correct value being inserted, regardless of whether the database default is `true` or `false`.
+
+> [!TIP]
+> When scaffolding from an existing database, EF8 parses and then includes simple default values into `HasDefaultValue` calls. (Previously, all default values were scaffolded as opaque `HasDefaultValueSql` calls.) This means that non-nullable bool columns with a `true` or `false` constant database default are no longer scaffolded as nullable.
+
+### Database defaults for enums
+
+Enum properties can have similar problems to `bool` properties because enums typically have a very small set of valid values, and the CLR default may be one of these values. For example, consider this entity type and enum:
+
+```csharp
+public class Course
+{
+    public int Id { get; set; }
+    public Level Level { get; set; }
+}
+
+public enum Level
+{
+    Beginner,
+    Intermediate,
+    Advanced,
+    Unspecified
+}
+```
+
+The `Level` property is then configured with a database default:
+
+```csharp
+modelBuilder.Entity<Course>()
+    .Property(e => e.Level)
+    .HasDefaultValue(Level.Intermediate);
+```
+
+With this configuration, EF will exclude sending the value to the database when it is set to `Level.Beginner`, and instead `Level.Intermediate` is assigned by the database. This isn't what was intended!
+
+The problem would not have occurred if the enum been defined with the "unknown" or "unspecified" value being the database default:
+
+```csharp
+public enum Level
+{
+    Unspecified,
+    Beginner,
+    Intermediate,
+    Advanced
+}
+```
+
+However, it is not always possible to change an existing enum, so in EF8, the sentinel can again be specified. For example, going back to the original enum:
+
+```csharp
+modelBuilder.Entity<Course>()
+    .Property(e => e.Level)
+    .HasDefaultValue(Level.Intermediate)
+    .HasSentinel(Level.Unspecified);
+```
+
+Now `Level.Beginner` will be inserted as normal, and the database default will only be used when the property value is `Level.Unspecified`. It can again be useful to reflect this in the entity type itself. For example:
+
+```csharp
+public class Course
+{
+    public int Id { get; set; }
+    public Level Level { get; set; } = Level.Unspecified;
+}
+```
+
+### Using a nullable backing field
+
+A more general way to handle the problem described above is to create a nullable backing field for the non-nullable property. For example, consider the following entity type with a `bool` property:
+
+```csharp
+public class Account
+{
+    public int Id { get; set; }
+    public bool IsActive { get; set; }
+}
+```
+
+The property can be given a nullable backing field:
+
+```csharp
+public class Account
+{
+    public int Id { get; set; }
+
+    private bool? _isActive;
+
+    public bool IsActive
+    {
+        get => _isActive ?? false;
+        set => _isActive = value;
+    }
+}
+```
+
+The backing field here will remain `null` _unless the property setter is actually called_. That is, the value of the backing field is a better indication of whether the property has been set or not than the CLR default of the property. This works out-of-the box with EF, since EF will use the backing field to read and write the property by default.
+
+## Better ExecuteUpdate and ExecuteDelete
+
+SQL commands that perform updates and deletes, such as those generated by `ExecuteUpdate` and `ExecuteDelete` methods, must target a single database table. However, in EF7, `ExecuteUpdate` and `ExecuteDelete` did not support updates accessing multiple entity types _even when the query ultimately affected a single table_. EF8 removes this limitation. For example, consider a `Customer` entity type with `CustomerInfo` owned type:
+
+<!--
+    #region CustomerAndInfo
+    public class Customer
+    {
+        public int Id { get; set; }
+        public required string Name { get; set; }
+        public required CustomerInfo CustomerInfo { get; set; }
+    }
+
+    [Owned]
+    public class CustomerInfo
+    {
+        public string? Tag { get; set; }
+    }
+-->
+[!code-csharp[CustomerAndInfo](../../../../samples/core/Miscellaneous/NewInEFCore8/ExecuteUpdateDeleteSample.cs?name=CustomerAndInfo)]
+
+Both of these entity types map to the `Customers` table. However, the following bulk update fails on EF7 because it uses both entity types:
+
+<!--
+        await context.Customers
+            .Where(e => e.Name == name)
+            .ExecuteUpdateAsync(
+                s => s.SetProperty(b => b.CustomerInfo.Tag, "Tagged")
+                    .SetProperty(b => b.Name, b => b.Name + "_Tagged"));
+-->
+[!code-csharp[UpdateWithOwned](../../../../samples/core/Miscellaneous/NewInEFCore8/ExecuteUpdateDeleteSample.cs?name=UpdateWithOwned)]
+
+In EF8, this now translates to the following SQL when using Azure SQL:
+
+```sql
+UPDATE [c]
+SET [c].[Name] = [c].[Name] + N'_Tagged',
+    [c].[CustomerInfo_Tag] = N'Tagged'
+FROM [Customers] AS [c]
+WHERE [c].[Name] = @__name_0
+```
+
+Similarly, instances returned from a `Union` query can be updated as long as the updates all target the same table. For example, we can update any `Customer` with a region of `France`, and at the same time, any `Customer` who has visited a store with the region `France`:
+
+<!--
+        await context.CustomersWithStores
+            .Where(e => e.Region == "France")
+            .Union(context.Stores.Where(e => e.Region == "France").SelectMany(e => e.Customers))
+            .ExecuteUpdateAsync(s => s.SetProperty(b => b.Tag, "The French Connection"));
+-->
+[!code-csharp[UpdateWithUnion](../../../../samples/core/Miscellaneous/NewInEFCore8/ExecuteUpdateDeleteSample.cs?name=UpdateWithUnion)]
+
+In EF8, this query generates the following when using Azure SQL:
+
+```sql
+UPDATE [c]
+SET [c].[Tag] = N'The French Connection'
+FROM [CustomersWithStores] AS [c]
+INNER JOIN (
+    SELECT [c0].[Id], [c0].[Name], [c0].[Region], [c0].[StoreId], [c0].[Tag]
+    FROM [CustomersWithStores] AS [c0]
+    WHERE [c0].[Region] = N'France'
+    UNION
+    SELECT [c1].[Id], [c1].[Name], [c1].[Region], [c1].[StoreId], [c1].[Tag]
+    FROM [Stores] AS [s]
+    INNER JOIN [CustomersWithStores] AS [c1] ON [s].[Id] = [c1].[StoreId]
+    WHERE [s].[Region] = N'France'
+) AS [t] ON [c].[Id] = [t].[Id]
+```
+
+As a final example, in EF8, `ExecuteUpdate` can be used to update entities in a TPT hierarchy as long as all updated properties are mapped to the same table. For example, consider these entity types mapped using TPT:
+
+<!--
+    [Table("TptSpecialCustomers")]
+    public class SpecialCustomerTpt : CustomerTpt
+    {
+        public string? Note { get; set; }
+    }
+
+    [Table("TptCustomers")]
+    public class CustomerTpt
+    {
+        public int Id { get; set; }
+        public required string Name { get; set; }
+    }
+-->
+[!code-csharp[CustomerTpt](../../../../samples/core/Miscellaneous/NewInEFCore8/ExecuteUpdateDeleteSample.cs?name=CustomerTpt)]
+
+With EF8, the `Note` property can be updated:
+
+<!--
+        await context.TptSpecialCustomers
+            .Where(e => e.Name == name)
+            .ExecuteUpdateAsync(s => s.SetProperty(b => b.Note, "Noted"));
+-->
+[!code-csharp[TptUpdateNote](../../../../samples/core/Miscellaneous/NewInEFCore8/ExecuteUpdateDeleteSample.cs?name=TptUpdateNote)]
+
+Or the `Name` property can be updated:
+
+<!--
+        await context.TptSpecialCustomers
+            .Where(e => e.Name == name)
+            .ExecuteUpdateAsync(s => s.SetProperty(b => b.Name, b => b.Name + " (Noted)"));
+-->
+[!code-csharp[TptUpdateName](../../../../samples/core/Miscellaneous/NewInEFCore8/ExecuteUpdateDeleteSample.cs?name=TptUpdateName)]
+
+However, EF8 fails attempting to update both the `Name` and the `Note` properties because they are mapped to different tables. For example:
+
+<!--
+            await context.TptSpecialCustomers
+                .Where(e => e.Name == name)
+                .ExecuteUpdateAsync(s => s.SetProperty(b => b.Note, "Noted")
+                    .SetProperty(b => b.Name, b => b.Name + " (Noted)"));
+-->
+[!code-csharp[TptUpdateBoth](../../../../samples/core/Miscellaneous/NewInEFCore8/ExecuteUpdateDeleteSample.cs?name=TptUpdateBoth)]
+
+Throws the following exception:
+
+```text
+The LINQ expression 'DbSet<SpecialCustomerTpt>()
+    .Where(s => s.Name == __name_0)
+    .ExecuteUpdate(s => s.SetProperty<string>(
+        propertyExpression: b => b.Note,
+        valueExpression: "Noted").SetProperty<string>(
+        propertyExpression: b => b.Name,
+        valueExpression: b => b.Name + " (Noted)"))' could not be translated. Additional information: Multiple 'SetProperty' invocations refer to different tables ('b => b.Note' and 'b => b.Name'). A single 'ExecuteUpdate' call can only update the columns of a single table. See https://go.microsoft.com/fwlink/?linkid=2101038 for more information.
+```
+
+## Better use of `IN` queries
+
+When the `Contains` LINQ operator is used with a subquery, EF Core now generates better queries using SQL `IN` instead of `EXISTS`; aside from producing more readable SQL, in some cases this can result in dramatically faster queries. For example, consider the following LINQ query:
+
+```csharp
+var blogsWithPosts = await context.Blogs
+    .Where(b => context.Posts.Select(p => p.BlogId).Contains(b.Id))
+    .ToListAsync();
+```
+
+EF7 generates the following for PostgreSQL:
+
+```sql
+SELECT b."Id", b."Name"
+      FROM "Blogs" AS b
+      WHERE EXISTS (
+          SELECT 1
+          FROM "Posts" AS p
+          WHERE p."BlogId" = b."Id")
+```
+
+Since the subquery references the external `Blogs` table (via `b."Id"`), this is a _correlated subquery_, meaning that the `Posts` subquery must be executed for each row in the `Blogs` table. In EF8, the following SQL is generated instead:
+
+```sql
+SELECT b."Id", b."Name"
+      FROM "Blogs" AS b
+      WHERE b."Id" IN (
+          SELECT p."BlogId"
+          FROM "Posts" AS p
+      )
+```
+
+Since the subquery no longer references `Blogs`, it can be evaluated once, yielding massive performance improvements on most database systems. However, some database systems, most notably SQL Server, the database is able to optimize the first query to the second query so that the performance is the same.
+
+## Numeric rowversions for SQL Azure/SQL Server
+
+SQL Server automatic [optimistic concurrency](xref:core/saving/concurrency) is handled using [`rowversion` columns](/sql/t-sql/data-types/rowversion-transact-sql). A `rowversion` is an 8-byte opaque value passed between database, client, and server. By default, SqlClient exposes `rowversion` types as `byte[]`, despite mutable reference types being a bad match for `rowversion` semantics. In EF8, it is easy to instead map `rowversion` columns to `long` or `ulong` properties. For example:
+
+```csharp
+modelBuilder.Entity<Blog>()
+    .Property(e => e.RowVersion)
+    .IsRowVersion();
+```
+
+## Parentheses elimination
+
+Generating readable SQL is an important goal for EF Core. In EF8, the generated SQL is more readable through automatic elimination of unneeded parenthesis. For example, the following LINQ query:
+
+```csharp
+await ctx.Customers  
+    .Where(c => c.Id * 3 + 2 > 0 && c.FirstName != null || c.LastName != null)  
+    .ToListAsync();  
+```
+
+Translates to the following Azure SQL when using EF7:
+
+```sql
+SELECT [c].[Id], [c].[City], [c].[FirstName], [c].[LastName], [c].[Street]
+FROM [Customers] AS [c]
+WHERE ((([c].[Id] * 3) + 2) > 0 AND ([c].[FirstName] IS NOT NULL)) OR ([c].[LastName] IS NOT NULL)
+```
+
+Which has been improved to the following when using EF8:
+
+```sql
+SELECT [c].[Id], [c].[City], [c].[FirstName], [c].[LastName], [c].[Street]
+FROM [Customers] AS [c]
+WHERE ([c].[Id] * 3 + 2 > 0 AND [c].[FirstName] IS NOT NULL) OR [c].[LastName] IS NOT NULL
+```
+
+## Specific opt-out for RETURNING/OUTPUT clause
+
+EF7 changed the default update SQL to use `RETURNING`/`OUTPUT` for fetching back database-generated columns. Some cases where identified where this does not work, and so EF8 introduces explicit opt-outs for this behavior.
+
+For example, to opt-out of `OUTPUT` when using the SQL Server/Azure SQL provider:
+
+```csharp
+ modelBuilder.Entity<Customer>().ToTable(tb => tb.UseSqlOutputClause(false));
+```
+
+Or to opt-out of `RETURNING` when using the SQLite provider:
+
+```csharp
+ modelBuilder.Entity<Customer>().ToTable(tb => tb.UseSqlReturningClause(false));
+```
+
+See the [SQL Server](xref:core/providers/sql-server/misc#savechanges-triggers-and-the-output-clause) and [SQLite](xref:core/providers/sqlite/misc#savechanges-and-the-returning-clause) documentation pages for more details.
+
+## Other minor changes
+
+In addition to the enhancements described above, there have been many smaller changes made to EF8. This includes:
+
+- [NativeAOT/trimming compatibility for Microsoft.Data.Sqlite](https://github.com/dotnet/efcore/issues/29725)
+- [Allow Multi-region or Application Preferred Regions in EF Core Cosmos](https://github.com/dotnet/efcore/issues/29424)
+- [SQLite: Add EF.Functions.Unhex](https://github.com/dotnet/efcore/issues/31355)
+- [SQL Server Index options SortInTempDB and DataCompression](https://github.com/dotnet/efcore/issues/30408)
+- [Allow 'unsharing' connection between contexts](https://github.com/dotnet/efcore/issues/30704)
+- [Add Generic version of EntityTypeConfiguration Attribute](https://github.com/dotnet/efcore/issues/30072)
+- [Query: add support for projecting JSON entities that have been composed on](https://github.com/dotnet/efcore/issues/31365)
+- [Remove unneeded subquery and projection when using ordering without limit/offset in set operations](https://github.com/dotnet/efcore/issues/30684)
+- [Allow pooling DbContext with singleton services](https://github.com/dotnet/efcore/issues/27752)
+- [Optional RestartSequenceOperation.StartValue](https://github.com/dotnet/efcore/issues/26560)
+- [Allow UseSequence and HiLo on non-key properties](https://github.com/dotnet/efcore/issues/29758)
+- [Provide more information when 'No DbContext was found' error is generated](https://github.com/dotnet/efcore/issues/18715)
+- [Pass query tracking behavior to materialization interceptor](https://github.com/dotnet/efcore/issues/29910)
+- [Use case-insensitive string key comparisons on SQL Server](https://github.com/dotnet/efcore/issues/27526)
+- [Allow value converters to change the DbType](https://github.com/dotnet/efcore/issues/24771)
+- [Resolve application services in EF services](https://github.com/dotnet/efcore/issues/13540)
+- [Allow transfer of ownership of DbConnection from application to DbContext](https://github.com/dotnet/efcore/issues/24199)
diff --git a/entity-framework/core/what-is-new/ef-core-9.0/breaking-changes.md b/entity-framework/core/what-is-new/ef-core-9.0/breaking-changes.md
new file mode 100644
index 0000000000..33c5838232
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-9.0/breaking-changes.md
@@ -0,0 +1,734 @@
+---
+title: Breaking changes in EF Core 9 (EF9) - EF Core
+description: List of breaking changes introduced in Entity Framework Core 9 (EF9)
+author: SamMonoRT
+ms.date: 01/17/2025
+uid: core/what-is-new/ef-core-9.0/breaking-changes
+---
+
+# Breaking changes in EF Core 9 (EF9)
+
+This page documents API and behavior changes that have the potential to break existing applications updating from EF Core 8 to EF Core 9. Make sure to review earlier breaking changes if updating from an earlier version of EF Core:
+
+- [Breaking changes in EF Core 8](xref:core/what-is-new/ef-core-8.0/breaking-changes)
+- [Breaking changes in EF Core 7](xref:core/what-is-new/ef-core-7.0/breaking-changes)
+- [Breaking changes in EF Core 6](xref:core/what-is-new/ef-core-6.0/breaking-changes)
+
+## Target Framework
+
+EF Core 9 targets .NET 8. This means that existing applications that target .NET 8 can continue to do so. Applications targeting older .NET, .NET Core, and .NET Framework versions will need to target .NET 8 or .NET 9 to use EF Core 9.
+
+## Summary
+
+> [!NOTE]
+> If you are using Azure Cosmos DB, please see the [separate section below on Azure Cosmos DB breaking changes](#azure-cosmos-db-breaking-changes).
+
+| **Breaking change**                                                                                       | **Impact** |
+|:----------------------------------------------------------------------------------------------------------|------------|
+| [Exception is thrown when applying migrations if there are pending model changes](#pending-model-changes) | High       |
+| [Exception is thrown when applying migrations in an explicit transaction](#migrations-transaction)        | High       |
+| [`Microsoft.EntityFrameworkCore.Design` not found when using EF tools](#tools-design)                     | Medium     |
+| [`EF.Functions.Unhex()` now returns `byte[]?`](#unhex)                                                    | Low        |
+| [Compiled models now reference value converter methods directly](#compiled-model-private-methods)         | Low        |
+| [SqlFunctionExpression's nullability arguments' arity validated](#sqlfunctionexpression-nullability)      | Low        |
+| [`ToString()` method now returns empty string for `null` instances](#nullable-tostring)                   | Low        |
+| [Shared framework dependencies were updated to 9.0.x](#shared-framework-dependencies)                     | Low        |
+| [EF tools no longer support .NET Framework projects](#ef-tools-no-netfx)                                  | Low        |
+
+## High-impact changes
+
+<a name="pending-model-changes"></a>
+
+### Exception is thrown when applying migrations if there are pending model changes
+
+[Tracking Issue #33732](https://github.com/dotnet/efcore/issues/33732)
+
+#### Old behavior
+
+If the model has pending changes compared to the last migration they are not applied with the rest of the migrations when <xref:Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.Migrate*> is called.
+
+#### New behavior
+
+Starting with EF Core 9.0, if the model has pending changes compared to the last migration an exception is thrown when `dotnet ef database update`, <xref:Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.Migrate*> or <xref:Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.MigrateAsync*> is called:
+> :::no-loc text="The model for context 'DbContext' has pending changes. Add a new migration before updating the database. This exception can be suppressed or logged by passing event ID 'RelationalEventId.PendingModelChangesWarning' to the 'ConfigureWarnings' method in 'DbContext.OnConfiguring' or 'AddDbContext'.":::
+
+#### Why
+
+Forgetting to add a new migration after making model changes is a common mistake that can be hard to diagnose in some cases. The new exception ensures that the app's model matches the database after the migrations are applied.
+
+#### Mitigations
+
+There are several common situations when this exception can be thrown:
+
+- There are no migrations at all. This is common when the database is updated through other means.
+  - **Mitigation**: If you don't plan to use migrations for managing the database schema then remove the <xref:Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.Migrate*> or <xref:Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.MigrateAsync*> call, otherwise add a migration.
+- There is at least one migration, but the model snapshot is missing. This is common for migrations created manually.
+  - **Mitigation**: Add a new migration using EF tooling, this will update the model snapshot.
+- The model wasn't modified by the developer, but it's built in a non-deterministic way causing EF to detect it as modified. This is common when `new DateTime()`, `DateTime.Now`, `DateTime.UtcNow`, or `Guid.NewGuid()` are used in objects supplied to <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.EntityTypeBuilder`1.HasData*>.
+  - **Mitigation**: Add a new migration, examine its contents to locate the cause, and replace the dynamic data with a static, hardcoded value in the model. The migration should be recreated after the model is fixed. If dynamic data has to be used for seeding consider using [the new seeding pattern](/ef/core/what-is-new/ef-core-9.0/whatsnew#improved-data-seeding) instead of <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.EntityTypeBuilder`1.HasData*>.
+- The last migration was created for a different provider than the one used to apply the migrations.
+  - **Mitigation**: This is an unsupported scenario. The warning can be suppressed using the code snippet below, but this scenario will likely stop working in a future EF Core release. The recommended solution is [to generate a separate set of migrations for each provider](xref:core/managing-schemas/migrations/providers).
+- The migrations are generated, modified or chosen dynamically by replacing some of the EF services.
+  - **Mitigation**: The warning is a false positive in this case and should be suppressed:  
+    `options.ConfigureWarnings(w => w.Ignore(Microsoft.EntityFrameworkCore.Diagnostics.RelationalEventId.PendingModelChangesWarning))`
+- You are using ASP.NET Core Identity and change options that affect the model, such as:
+
+    ```csharp
+    .AddDefaultIdentity<ApplicationUser>(options =>
+        {
+            options.Stores.SchemaVersion = IdentitySchemaVersions.Version2;
+            options.Stores.MaxLengthForKeys = 256;
+            options.SignIn.RequireConfirmedAccount = false;
+        })
+    ```
+
+  - **Mitigation**: To make sure that the options are applied consistently the app needs to be specified as the startup project when running the EF tools or, alternatively, `IDesignTimeDbContextFactory` needs to be implemented in the project containing the `DbContext`:
+
+    ```csharp
+    public class DatabaseContextDesignTimeFactory : IDesignTimeDbContextFactory<DatabaseContext>
+    {
+        public DatabaseContext CreateDbContext(string[] args)
+        {
+            var services = new ServiceCollection();
+            AddIdentity(services);
+            var serviceProvider = services.BuildServiceProvider();
+            var optionsBuilder = new DbContextOptionsBuilder<DatabaseContext>();
+            optionsBuilder.UseApplicationServiceProvider(serviceProvider);
+            optionsBuilder.UseSqlServer();
+            return new DatabaseContext(optionsBuilder.Options);
+        }
+    
+        public static IServiceCollection AddIdentity(IServiceCollection services)
+        {
+            services.AddDefaultIdentity<ApplicationUser>(options =>
+                {
+                    options.Stores.SchemaVersion = IdentitySchemaVersions.Version2;
+                    options.Stores.MaxLengthForKeys = 256;
+                    options.SignIn.RequireConfirmedAccount = false;
+                })
+                .AddRoles<IdentityRole>()
+                .AddEntityFrameworkStores<DatabaseContext>();
+    
+            return services;
+        }
+    }
+    ```
+
+If your scenario doesn't fall under any of the above cases and adding a new migration creates the same migration each time or an empty migration and the exception is still thrown then create a small repro project and [share it with the EF team in a new issue](https://github.com/dotnet/efcore/issues/new/choose).
+
+<a name="migrations-transaction"></a>
+
+### Exception is thrown when applying migrations in an explicit transaction
+
+[Tracking Issue #17578](https://github.com/dotnet/efcore/issues/17578)
+
+#### Old behavior
+
+To apply migrations resiliently the following pattern was commonly used:
+
+```csharp
+await dbContext.Database.CreateExecutionStrategy().ExecuteAsync(async () =>
+{
+    await using var transaction = await dbContext.Database.BeginTransactionAsync(cancellationToken);
+    await dbContext.Database.MigrateAsync(cancellationToken);
+    await transaction.CommitAsync(cancellationToken);
+});
+```
+
+#### New behavior
+
+Starting with EF Core 9.0, <xref:Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.Migrate*> and <xref:Microsoft.EntityFrameworkCore.RelationalDatabaseFacadeExtensions.MigrateAsync*> calls will start a transaction and execute the commands using an `ExecutionStrategy` and if your app uses the above pattern an exception is thrown:
+> :::no-loc text="An error was generated for warning 'Microsoft.EntityFrameworkCore.Migrations.MigrationsUserTransactionWarning': A transaction was started before applying migrations. This prevents a database lock to be acquired and hence the database will not be protected from concurrent migration applications. The transactions and execution strategy are already managed by EF as needed. Remove the external transaction. This exception can be suppressed or logged by passing event ID 'RelationalEventId.MigrationsUserTransactionWarning' to the 'ConfigureWarnings' method in 'DbContext.OnConfiguring' or 'AddDbContext'.":::
+
+#### Why
+
+Using an explicit transaction prevents a database lock to be acquired and hence the database will not be protected from concurrent migration applications, it also limits EF on how it can manage the transactions internally.
+
+#### Mitigations
+
+If there is only one database call inside the transaction then remove the external transaction and `ExecutionStrategy`:
+
+```csharp
+await dbContext.Database.MigrateAsync(cancellationToken);
+```
+
+Otherwise, if your scenario requires an explicit transaction and you have other mechanism in place to prevent concurrent migration application, then ignore the warning:
+  
+```csharp
+options.ConfigureWarnings(w => w.Ignore(RelationalEventId.MigrationsUserTransactionWarning))
+```
+
+## Medium-impact changes
+
+<a name="tools-design"></a>
+
+### `Microsoft.EntityFrameworkCore.Design` not found when using EF tools
+
+[Tracking Issue #35265](https://github.com/dotnet/efcore/issues/35265)
+
+#### Old behavior
+
+Previusly, the EF tools required `Microsoft.EntityFrameworkCore.Design` to be referenced in the following way.
+
+```XML
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="*.0.0">
+      <PrivateAssets>all</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+    </PackageReference>
+```
+
+#### New behavior
+
+Starting with .NET SDK 9.0.200 an exception is thrown when an EF tool is invoked:
+> :::no-loc text="Could not load file or assembly 'Microsoft.EntityFrameworkCore.Design, Culture=neutral, PublicKeyToken=null'. The system cannot find the file specified.":::
+
+#### Why
+
+EF tools were relying on an undocumented behavior of .NET SDK that caused private assets to be included in the generated `.deps.json` file. This was fixed in [sdk#45259](https://github.com/dotnet/sdk/pull/45259). Unfortunately, the EF change to account for this doesn't meet the servicing bar for EF 9.0.x, so it will be fixed in EF 10.
+
+#### Mitigations
+
+As a workaround before EF 10 is released you can mark the `Design` assembly reference as publishable:
+
+```XML
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="9.0.1">
+      <PrivateAssets>all</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+      <Publish>true</Publish>
+    </PackageReference>
+```
+
+This will include it in the generated `.deps.json` file, but has a side effect of copying `Microsoft.EntityFrameworkCore.Design.dll` to the output and publish folders.
+
+## Low-impact changes
+
+<a name="unhex"></a>
+
+### `EF.Functions.Unhex()` now returns `byte[]?`
+
+[Tracking Issue #33864](https://github.com/dotnet/efcore/issues/33864)
+
+#### Old behavior
+
+The `EF.Functions.Unhex()` function was previously annotated to return `byte[]`.
+
+#### New behavior
+
+Starting with EF Core 9.0, Unhex() is now annotated to return `byte[]?`.
+
+#### Why
+
+`Unhex()` is translated to the SQLite `unhex` function, which returns NULL for invalid inputs. As a result, `Unhex()` returned `null` for those cases, in violation of the annotation.
+
+#### Mitigations
+
+If you are sure that the text content passed to `Unhex()` represents a valid, hexadecimal string, you can simply add the null-forgiving operator as an assertion that the invocation will never return null:
+
+```csharp
+var binaryData = await context.Blogs.Select(b => EF.Functions.Unhex(b.HexString)!).ToListAsync();
+```
+
+Otherwise, add runtime checks for null on the return value of Unhex().
+
+<a name="compiled-model-private-methods"></a>
+
+### Compiled models now reference value converter methods directly
+
+[Tracking Issue #35033](https://github.com/dotnet/efcore/issues/35033)
+
+#### Old behavior
+
+Previously, when using value converters with compiled models (using `dotnet ef dbcontext optimize`), EF would reference the converter type and everything worked correctly.
+
+```c#
+public sealed class BooleanToCharConverter() : ValueConverter<bool, char>(v => ConvertToChar(v), v => ConvertToBoolean(v))
+{
+    public static readonly BooleanToCharConverter Default = new();
+
+    private static char ConvertToChar(bool value) // Private method
+        => value ? 'Y' : 'N';
+
+    private static bool ConvertToBoolean(char value) // Private method
+        => value == 'Y';
+}
+```
+
+#### New behavior
+
+Starting with EF Core 9.0, EF generates code that directly references the conversion methods themselves. If these methods are private, compilation will fail.
+
+#### Why
+
+This change was necessary to support NativeAOT.
+
+#### Mitigations
+
+Make the methods referenced by value converters public or internal instead of private.
+
+<a name="sqlfunctionexpression-nullability"></a>
+
+### SqlFunctionExpression's nullability arguments' arity validated
+
+[Tracking Issue #33852](https://github.com/dotnet/efcore/issues/33852)
+
+#### Old behavior
+
+Previously it was possible to create a `SqlFunctionExpression` with a different number of arguments and nullability propagation arguments.
+
+#### New behavior
+
+Starting with EF Core 9.0, EF now throws if the number of arguments and nullability propagation arguments do not match.
+
+#### Why
+
+Not having matching number of arguments and nullability propagation arguments can lead to unexpected behavior.
+
+#### Mitigations
+
+Make sure the `argumentsPropagateNullability` has same number of elements as the `arguments`. When in doubt use `false` for nullability argument.
+
+<a name="nullable-tostring"></a>
+
+### `ToString()` method now returns empty string for `null` instances
+
+[Tracking Issue #33941](https://github.com/dotnet/efcore/issues/33941)
+
+#### Old behavior
+
+Previously EF returned inconsistent results for the `ToString()` method when the argument value was `null`. E.g. `ToString()` on `bool?` property with `null` value returned `null`, but for non-property `bool?` expressions whose value was `null` it returned `True`. The behavior was also inconsistent for other data types, e.g. `ToString()` on `null` value enum returned empty string.
+
+#### New behavior
+
+Starting with EF Core 9.0, the `ToString()` method now consistently returns empty string in all cases when the argument value is `null`.
+
+#### Why
+
+The old behavior was inconsistent across different data types and situations, as well as not aligned with the [C# behavior](/dotnet/api/system.nullable-1.tostring#returns).
+
+#### Mitigations
+
+To revert to the old behavior, rewrite the query accordingly:
+
+```csharp
+var newBehavior = context.Entity.Select(x => x.NullableBool.ToString());
+var oldBehavior = context.Entity.Select(x => x.NullableBool == null ? null : x.NullableBool.ToString());
+```
+
+<a name="shared-framework-dependencies"></a>
+
+### Shared framework dependencies were updated to 9.0.x
+
+#### Old behavior
+
+Apps using the `Microsoft.NET.Sdk.Web` SDK and targetting net8.0 would resolve packages like `System.Text.Json`, `Microsoft.Extensions.Caching.Memory`, `Microsoft.Extensions.Configuration.Abstractions`, `Microsoft.Extensions.Logging` and `Microsoft.Extensions.DependencyModel` from the shared framework, so these assemblies wouldn't normally be deployed with the app.
+
+#### New behavior
+
+While EF Core 9.0 still supports net8.0 it now references the 9.0.x versions of `System.Text.Json`, `Microsoft.Extensions.Caching.Memory`, `Microsoft.Extensions.Configuration.Abstractions`, `Microsoft.Extensions.Logging` and `Microsoft.Extensions.DependencyModel`. Apps targetting net8.0 will not be able to leverage the shared framework to avoid deploying these assemblies.
+
+#### Why
+
+The matching dependency versions contain the latest security fixes and using them simplifies the servicing model for EF Core.
+
+#### Mitigations
+
+Change your app to target net9.0 to get the previous behavior.
+
+<a name="ef-tools-no-netfx"></a>
+
+### EF tools no longer support .NET Framework projects
+
+[Tracking Issue #37745](https://github.com/dotnet/efcore/issues/37745)
+
+#### Old behavior
+
+Previously, the EF Core tools (`dotnet-ef` CLI and Package Manager Console tools) worked with projects targeting .NET Framework.
+
+#### New behavior
+
+Starting with EF Core 9.0, the EF Core tools no longer work with projects targeting .NET Framework. The tools produce an error when the startup project targets .NET Framework.
+
+#### Why
+
+The current version of EF Core tools works with all supported EF Core versions and there are no longer any supported EF Core versions that work on .NET Framework.
+
+#### Mitigations
+
+Update your project to target .NET (e.g., .NET 8 or later). If your project currently targets .NET Framework, see the [porting guide](/dotnet/core/porting/) for information on migrating to .NET.
+
+## Azure Cosmos DB breaking changes
+
+Extensive work has gone into making the Azure Cosmos DB provider better in 9.0. The changes include a number of high-impact breaking changes; if you are upgrading an existing application, please read the following carefully.
+
+| **Breaking change**                                                                                                                                  | **Impact** |
+|:---------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| [The discriminator property is now named `$type` instead of `Discriminator`](#cosmos-discriminator-name-change)                                      | High       |
+| [The `id` property no longer contains the discriminator by default](#cosmos-id-property-changes)                                                     | High       |
+| [The JSON `id` property is mapped to the key](#cosmos-key-changes)                                                                                   | High       |
+| [Sync I/O via the Azure Cosmos DB provider is no longer supported](#cosmos-nosync)                                                                   | Medium     |
+| [SQL queries must now project JSON values directly](#cosmos-sql-queries-with-value)                                                                  | Medium     |
+| [Undefined results are now automatically filtered from query results](#cosmos-undefined-filtering)                                                   | Medium     |
+| [Incorrectly translated queries are no longer translated](#cosmos-incorrect-translations)                                                            | Medium     |
+| [`HasIndex` now throws instead of being ignored](#cosmos-hasindex-throws)                                                                            | Low        |
+| [`IncludeRootDiscriminatorInJsonId` was renamed to `HasRootDiscriminatorInJsonId` after 9.0.0-rc.2](#cosmos-IncludeRootDiscriminatorInJsonId-rename) | Low        |
+| [The referenced Newtonsoft.Json version was updated from 10.0.2 to 13.0.1](#cosmos-newtonsoft-json-version)                                         | Low        |
+
+### High-impact changes
+
+<a name="cosmos-discriminator-name-change"></a>
+
+#### The discriminator property is now named `$type` instead of `Discriminator`
+
+[Tracking Issue #34269](https://github.com/dotnet/efcore/issues/34269)
+
+##### Old behavior
+
+EF automatically adds a discriminator property to JSON documents to identify the entity type that the document represents. In previous versions of EF, this JSON property used to be named `Discriminator` by default.
+
+##### New behavior
+
+Starting with EF Core 9.0, the discriminator property is now called `$type` by default. If you have existing documents in Azure Cosmos DB from previous versions of EF, these use the old `Discriminator` naming, and after upgrading to EF 9.0, queries against those documents will fail.
+
+##### Why
+
+An emerging JSON practice uses a `$type` property in scenarios where a document's type needs to be identified. For example, .NET's System.Text.Json also supports polymorphism, using `$type` as its default discriminator property name ([docs](/dotnet/standard/serialization/system-text-json/polymorphism#customize-the-type-discriminator-name)). To align with the rest of the ecosystem and make it easier to interoperate with external tools, the default was changed.
+
+##### Mitigations
+
+The easiest mitigation is to simply configure the name of the discriminator property to be `Discriminator`, just as before using <xref:Microsoft.EntityFrameworkCore.Metadata.Builders.EntityTypeBuilder.HasDiscriminator*>:
+
+```csharp
+modelBuilder.Entity<Session>().HasDiscriminator<string>("Discriminator");
+```
+
+Doing this for all your top-level entity types will make EF behave just like before.
+
+At this point, if you wish, you can also update all your documents to use the new `$type` naming.
+
+<a name="cosmos-id-property-changes"></a>
+
+#### The `id` property now contains only the EF key property by default
+
+[Tracking Issue #34179](https://github.com/dotnet/efcore/issues/34179)
+
+##### Old behavior
+
+Previously, EF inserted the discriminator value of your entity type into the `id` property of the document. For example, if you saved a `Blog` entity type with an `Id` property containing 8, the JSON `id` property would contain `Blog|8`.
+
+##### New behavior
+
+Starting with EF Core 9.0, the JSON `id` property no longer contains the discriminator value, and only contains the value of your key property. For the above example, the JSON `id` property would simply be `8`. If you have existing documents in Azure Cosmos DB from previous versions of EF, these have the discriminator value in the JSON `id` property, and after upgrading to EF 9.0, queries against those documents will fail.
+
+##### Why
+
+Since the JSON `id` property must be unique, the discriminator was previously added to it to allow different entities with the same key value to exist. For example, this allowed having both a `Blog` and a `Post` with an `Id` property containing the value 8 within the same container and partition. This aligned better with relational database data modeling patterns, where each entity type is mapped to its own table, and therefore has its own key-space.
+
+EF 9.0 generally changed the mapping to be more aligned with common Azure Cosmos DB NoSQL practices and expectations, rather than to correspond to the expectations of users coming from relational databases. In addition, having the discriminator value in the `id` property made it more difficult for external tools and systems to interact with EF-generated JSON documents; such external systems aren't generally aware of the EF discriminator values, which are by default derived from .NET types.
+
+##### Mitigations
+
+The easiest mitigation is to simply configure EF to include the discriminator in the JSON `id` property, as before using <xref:Microsoft.EntityFrameworkCore.CosmosEntityTypeBuilderExtensions.HasDiscriminatorInJsonId*>. A new configuration option has been introduced for this purpose:
+
+```csharp
+modelBuilder.Entity<Session>().HasDiscriminatorInJsonId();
+```
+
+Doing this for all your top-level entity types will make EF behave just like before.
+
+At this point, if you wish, you can also update all your documents to rewrite their JSON `id` property. Note that this is only possible if entities of different types don't share the same id value within the same container.
+
+<a name="cosmos-key-changes"></a>
+
+#### The JSON `id` property is mapped to the key
+
+[Tracking Issue #34179](https://github.com/dotnet/efcore/issues/34179)
+
+##### Old behavior
+
+Previously, EF created a shadow property mapped to the JSON `id` property, unless one of the properties was mapped to `id` explicitly.
+
+##### New behavior
+
+Starting with EF Core 9, the key property will be mapped to the JSON `id` property by convention if possible. This means that the key property will no longer be persisted in the document under a different name with the same value, so non-EF code consuming the documents and relying on this property being present would no longer function correctly.
+
+##### Why
+
+EF 9.0 generally changed the mapping to be more aligned with common Azure Cosmos DB NoSQL practices and expectations. And it is not common to store the key value twice in the document.
+
+##### Mitigations
+
+If you would like to preserve EF Core 8 behavior the easiest mitigation is to use <xref:Microsoft.EntityFrameworkCore.CosmosEntityTypeBuilderExtensions.HasShadowId*>, a new configuration option that has been introduced for this purpose:
+
+```csharp
+modelBuilder.Entity<Session>().HasShadowId();
+```
+
+Doing this for all your top-level entity types will make EF behave just like before. Or you could apply it to all entity types in the model with one call using <xref:Microsoft.EntityFrameworkCore.CosmosModelBuilderExtensions.HasShadowIds*>:
+
+```csharp
+modelBuilder.HasShadowIds();
+```
+
+### Medium-impact changes
+
+<a name="cosmos-nosync"></a>
+
+#### Sync I/O via the Azure Cosmos DB provider is no longer supported
+
+[Tracking Issue #32563](https://github.com/dotnet/efcore/issues/32563)
+
+##### Old behavior
+
+Previously, calling synchronous methods like `ToList` or `SaveChanges` would cause EF Core to block synchronously using `.GetAwaiter().GetResult()` when executing async calls against the Azure Cosmos DB SDK. This can result in deadlock.
+
+##### New behavior
+
+Starting with EF Core 9.0, EF now throws by default when attempting to use synchronous I/O. The exception message is "Azure Cosmos DB does not support synchronous I/O. Make sure to use and correctly await only async methods when using Entity Framework Core to access Azure Cosmos DB. See [https://aka.ms/ef-cosmos-nosync](https://aka.ms/ef-cosmos-nosync) for more information."
+
+##### Why
+
+Synchronous blocking on asynchronous methods can result in deadlock, and the Azure Cosmos DB SDK only supports async methods.
+
+##### Mitigations
+
+In EF Core 9.0, the error can be suppressed with:
+
+```csharp
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+{
+    optionsBuilder.ConfigureWarnings(w => w.Ignore(CosmosEventId.SyncNotSupported));
+}
+```
+
+That being said, applications should stop using sync APIs with Azure Cosmos DB since this is not supported by the Azure Cosmos DB SDK. The ability to suppress the exception will be removed in a future release of EF Core, after which the only option will be to use async APIs.
+
+<a name="cosmos-sql-queries-with-value"></a>
+
+#### SQL queries must now project JSON values directly
+
+[Tracking Issue #25527](https://github.com/dotnet/efcore/issues/25527)
+
+##### Old behavior
+
+Previously, EF generated queries such as the following:
+
+```sql
+SELECT c["City"] FROM root c
+```
+
+Such queries cause Azure Cosmos DB to wrap each result in a JSON object, as follows:
+
+```json
+[
+    {
+        "City": "Berlin"
+    },
+    {
+        "City": "México D.F."
+    }
+]
+```
+
+##### New behavior
+
+Starting with EF Core 9.0, EF now adds the `VALUE` modifier to queries as follows:
+
+```sql
+SELECT VALUE c["City"] FROM root c
+```
+
+Such queries cause Azure Cosmos DB to return the values directly, without being wrapped:
+
+```json
+[
+    "Berlin",
+    "México D.F."
+]
+```
+
+If your application makes use of [SQL queries](xref:core/providers/cosmos/querying#sql-queries), such queries are likely broken after upgrading to EF 9.0, as they don't include the `VALUE` modifier.
+
+##### Why
+
+Wrapping each result in an additional JSON object can cause performance degradation in some scenarios, bloats the JSON result payload, and isn't the natural way to work with Azure Cosmos DB.
+
+##### Mitigations
+
+To mitigate, simply add the `VALUE` modifier to the projections of your SQL queries, as shown above.
+
+<a name="cosmos-undefined-filtering"></a>
+
+#### Undefined results are now automatically filtered from query results
+
+[Tracking Issue #25527](https://github.com/dotnet/efcore/issues/25527)
+
+##### Old behavior
+
+Previously, EF generated queries such as the following:
+
+```sql
+SELECT c["City"] FROM root c
+```
+
+Such queries cause Azure Cosmos DB to wrap each result in a JSON object, as follows:
+
+```json
+[
+    {
+        "City": "Berlin"
+    },
+    {
+        "City": "México D.F."
+    }
+]
+```
+
+If any of the results were undefined (e.g. the `City` property was absent from the document), an empty document was returned, and EF would return `null` for that result.
+
+##### New behavior
+
+Starting with EF Core 9.0, EF now adds the `VALUE` modifier to queries as follows:
+
+```sql
+SELECT VALUE c["City"] FROM root c
+```
+
+Such queries cause Azure Cosmos DB to return the values directly, without being wrapped:
+
+```json
+[
+    "Berlin",
+    "México D.F."
+]
+```
+
+The Azure Cosmos DB behavior is to automatically filter `undefined` values out of results; this means that if one of the `City` properties is absent from the document, the query would return just a single result, rather than two results, with one being `null`.
+
+##### Why
+
+Wrapping each result in an additional JSON object can cause performance degradation in some scenarios, bloats the JSON result payload, and isn't the natural way to work with Azure Cosmos DB.
+
+##### Mitigations
+
+If getting `null` values for undefined results is important for your application, coalesce the `undefined` values to `null` using the new `EF.Functions.Coalesce` operator:
+
+```csharp
+var users = await context.Customer
+    .Select(c => EF.Functions.CoalesceUndefined(c.City, null))
+    .ToListAsync();
+```
+
+<a name="cosmos-incorrect-translations"></a>
+
+#### Incorrectly translated queries are no longer translated
+
+[Tracking Issue #34123](https://github.com/dotnet/efcore/issues/34123)
+
+##### Old behavior
+
+Previously, EF translated queries such as the following:
+
+```csharp
+var sessions = await context.Sessions
+    .Take(5)
+    .Where(s => s.Name.StartsWith("f"))
+    .ToListAsync();
+```
+
+However, the SQL translation for this query was incorrect:
+
+```sql
+SELECT c
+FROM root c
+WHERE ((c["Discriminator"] = "Session") AND STARTSWITH(c["Name"], "f"))
+OFFSET 0 LIMIT @__p_0
+```
+
+In SQL, the `WHERE` clause is evaluated _before_ the `OFFSET` and `LIMIT` clauses; but in the LINQ query above, the `Take` operator appears before the `Where` operator. As a result, such queries could return incorrect results.
+
+##### New behavior
+
+Starting with EF Core 9.0, such queries are no longer translated, and an exception is thrown.
+
+##### Why
+
+Incorrect translations can cause silent data corruption, which can introduce hard-to-discover bugs in your application. EF always prefer to fail-fast by throwing up-front rather than to possibly cause data corruption.
+
+##### Mitigations
+
+If you were happy with the previous behavior and would like to execute the same SQL, simply swap around the order of LINQ operators:
+
+```csharp
+var sessions = await context.Sessions
+    .Where(s => s.Name.StartsWith("f"))
+    .Take(5)
+    .ToListAsync();
+```
+
+Unfortunately, Azure Cosmos DB does not currently support the `OFFSET` and `LIMIT` clauses in SQL subqueries, which is what the proper translation of the original LINQ query requires.
+
+### Low-impact changes
+
+<a name="cosmos-hasindex-throws"></a>
+
+#### `HasIndex` now throws instead of being ignored
+
+[Tracking Issue #34023](https://github.com/dotnet/efcore/issues/34023)
+
+##### Old behavior
+
+Previously, calls to <xref: Microsoft.EntityFrameworkCore.Metadata.Builders.EntityTypeBuilder`1.HasIndex*> were ignored by the EF Cosmos DB provider.
+
+##### New behavior
+
+The provider now throws if <xref: Microsoft.EntityFrameworkCore.Metadata.Builders.EntityTypeBuilder`1.HasIndex*> is specified.
+
+##### Why
+
+In Azure Cosmos DB, all properties are indexed by default, and no indexing needs to be specified. While it's possible to define a custom indexing policy, this isn't currently supported by EF, and can be done via the Azure Portal without EF support. Since <xref: Microsoft.EntityFrameworkCore.Metadata.Builders.EntityTypeBuilder`1.HasIndex*> calls weren't doing anything, they are no longer allowed.
+
+##### Mitigations
+
+Remove any calls to <xref: Microsoft.EntityFrameworkCore.Metadata.Builders.EntityTypeBuilder`1.HasIndex*>.
+
+<a name="cosmos-IncludeRootDiscriminatorInJsonId-rename"></a>
+
+#### `IncludeRootDiscriminatorInJsonId` was renamed to `HasRootDiscriminatorInJsonId` after 9.0.0-rc.2
+
+[Tracking Issue #34717](https://github.com/dotnet/efcore/pull/34717)
+
+##### Old behavior
+
+The `IncludeRootDiscriminatorInJsonId` API was introduced in 9.0.0 rc.1.
+
+##### New behavior
+
+For the final release of EF Core 9.0, the API was renamed to `HasRootDiscriminatorInJsonId`
+
+##### Why
+
+Another related API was renamed to start with `Has` instead of `Include`, and so this one was renamed for consistency as well.
+
+##### Mitigations
+
+If your code is using the `IncludeRootDiscriminatorInJsonId` API, simply change it to reference `HasRootDiscriminatorInJsonId` instead.
+
+<a name="cosmos-newtonsoft-json-version"></a>
+
+#### The referenced Newtonsoft.Json version was updated from 10.0.2 to 13.0.1
+
+##### Old behavior
+
+The Cosmos provider referenced Newtonsoft.Json version 10.0.2.
+
+##### New behavior
+
+Starting with EF Core 9.0, the Cosmos provider references Newtonsoft.Json version 13.0.1.
+
+##### Why
+
+The previously referenced version of Newtonsoft.Json has known vulnerabilities. The version was updated to avoid depending on a package version with known security issues.
+
+##### Mitigations
+
+The upgrade to Newtonsoft.Json 13.0.1 should not cause issues in most cases. If your application uses Newtonsoft.Json directly and relies on a specific older version, you can update your application to be compatible with Newtonsoft.Json 13.0.1 or later. See the [Newtonsoft.Json release notes](https://github.com/JamesNK/Newtonsoft.Json/releases) for details on changes between versions.
diff --git a/entity-framework/core/what-is-new/ef-core-9.0/ef9.png b/entity-framework/core/what-is-new/ef-core-9.0/ef9.png
new file mode 100644
index 0000000000..771a0bd47e
Binary files /dev/null and b/entity-framework/core/what-is-new/ef-core-9.0/ef9.png differ
diff --git a/entity-framework/core/what-is-new/ef-core-9.0/whatsnew.md b/entity-framework/core/what-is-new/ef-core-9.0/whatsnew.md
new file mode 100644
index 0000000000..001f1c8931
--- /dev/null
+++ b/entity-framework/core/what-is-new/ef-core-9.0/whatsnew.md
@@ -0,0 +1,1499 @@
+---
+title: What's New in EF Core 9
+description: Overview of new features in EF Core 9
+author: SamMonoRT
+ms.date: 10/21/2024
+uid: core/what-is-new/ef-core-9.0/whatsnew
+---
+
+# What's New in EF Core 9
+
+EF Core 9.0 (EF9) was released in November 2024 and is a Short Term Support (STS) release. EF9 will be supported until November 10, 2026.
+
+EF9 is available as [daily builds](https://github.com/dotnet/efcore/blob/main/docs/DailyBuilds.md) which contain all the latest EF9 features and API tweaks. The samples here make use of these daily builds.
+
+> [!TIP]
+> You can run and debug into the samples by [downloading the sample code from GitHub](https://github.com/dotnet/EntityFramework.Docs). Each section below links to the source code specific to that section.
+
+EF9 targets .NET 8, and can therefore be used with either [.NET 8 (LTS)](https://dotnet.microsoft.com/download/dotnet/8.0) or [.NET 9](https://dotnet.microsoft.com/download/dotnet/9.0).
+
+> [!TIP]
+> The _What's New_ docs are updated for each preview. All the samples are set up to use the [EF9 daily builds](https://github.com/dotnet/efcore/blob/main/docs/DailyBuilds.md), which usually have several additional weeks of completed work compared to the latest preview. We strongly encourage use of the daily builds when testing new features so that you're not doing your testing against stale bits.
+
+<a name="cosmos"></a>
+
+## Azure Cosmos DB for NoSQL
+
+EF 9.0 brings substantial improvements to the EF Core provider for Azure Cosmos DB; significant parts of the provider have been rewritten to provide new functionality, allow new forms of queries, and better align the provider with Azure Cosmos DB best practices. The main high-level improvements are listed below; for a full list, [see this epic issue](https://github.com/dotnet/efcore/issues/33033).
+
+> [!WARNING]
+> As part of the improvements going into the provider, a number of high-impact breaking changes had to be made; if you are upgrading an existing application, please read the [breaking changes section](xref:core/what-is-new/ef-core-9.0/breaking-changes#cosmos-breaking-changes) carefully.
+
+### Improvements querying with partition keys and document IDs
+
+Each document stored in an Azure Cosmos DB database has a unique resource ID. In addition, each document can contain a "partition key" which determines the logical partitioning of data such that the database can be effectively scaled. More information on choosing partition keys can be found in [_Partitioning and horizontal scaling in Azure Cosmos DB_](/azure/cosmos-db/partitioning-overview).
+
+In EF 9.0, the Azure Cosmos DB provider is significantly better at identifying partition key comparisons in your LINQ queries, and extracting them out to ensure your queries are only sent to the relevant partition; this can greatly improve the performance of your queries and reduce RU charges. For example:
+
+```csharp
+var sessions = await context.Sessions
+    .Where(b => b.PartitionKey == "someValue" && b.Username.StartsWith("x"))
+    .ToListAsync();
+```
+
+In this query, the provider automatically recognizes the comparison on `PartitionKey`; if we examine the logs, we'll see the following:
+
+```console
+Executed ReadNext (189.8434 ms, 2.8 RU) ActivityId='8cd669ed-2ca5-4f2b-8923-338899071361', Container='test', Partition='["someValue"]', Parameters=[]
+SELECT VALUE c
+FROM root c
+WHERE STARTSWITH(c["Username"], "x")
+```
+
+Note that the `WHERE` clause does not contain `PartitionKey`: that comparison has been "lifted" out and is used to execute the query only against the relevant partition. In previous versions, the comparison was left in the `WHERE` clause in many situations, causing the query to be executed against all partitions and resulting in increased costs and reduced performance.
+
+In addition, if your query also provides a value for the document's ID property, and doesn't include any other query operations, the provider can apply an additional optimization:
+
+```csharp
+var somePartitionKey = "someValue";
+var someId = 8;
+var sessions = await context.Sessions
+    .Where(b => b.PartitionKey == somePartitionKey && b.Id == someId)
+    .SingleAsync();
+```
+
+The logs show the following for this query:
+
+```console
+Executed ReadItem (73 ms, 1 RU) ActivityId='13f0f8b8-d481-47f0-bf41-67f7deb008b2', Container='test', Id='8', Partition='["someValue"]'
+```
+
+Here, no SQL query is sent at all. Instead, the provider performs an an extremely efficient _point read_ (`ReadItem` API), which directly fetches the document given the partition key and ID. This is the most efficient and cost-effective kind of read you can perform in Azure Cosmos DB; [see the Azure Cosmos DB documentation](/azure/cosmos-db/nosql/how-to-dotnet-read-item) for more information about point reads.
+
+To learn more about querying with partition keys and point reads, [see the querying documentation page](xref:core/providers/cosmos/querying).
+
+### Hierarchical partition keys
+
+> [!TIP]
+> The code shown here comes from [HierarchicalPartitionKeysSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore9.Cosmos/HierarchicalPartitionKeysSample.cs).
+
+Azure Cosmos DB originally supported a single partition key, but has since expanded partitioning capabilities to also support [subpartitioning through the specification of up to three levels of hierarchy in the partition key](/azure/cosmos-db/hierarchical-partition-keys). EF Core 9 brings full support for hierarchical partition keys, allowing you take advantage of the better performance and cost savings associated with this feature.
+
+Partition keys are specified using the model building API, typically in <xref:Microsoft.EntityFrameworkCore.DbContext.OnModelCreating*?displayProperty=nameWithType>. There must be a mapped property in the entity type for each level of the partition key. For example, consider a `UserSession` entity type:
+
+<!--
+    public class UserSession
+    {
+        // Item ID
+        public Guid Id { get; set; }
+
+        // Partition Key
+        public string TenantId { get; set; } = null!;
+        public Guid UserId { get; set; }
+        public int SessionId { get; set; }
+
+        // Other members
+        public string Username { get; set; } = null!;
+    }
+-->
+[!code-csharp[UserSession](../../../../samples/core/Miscellaneous/NewInEFCore9.Cosmos/HierarchicalPartitionKeysSample.cs?name=UserSession)]
+
+The following code specifies a three-level partition key using the `TenantId`, `UserId`, and `SessionId` properties:
+
+<!--
+            modelBuilder
+                .Entity<UserSession>()
+                .HasPartitionKey(e => new { e.TenantId, e.UserId, e.SessionId });
+-->
+[!code-csharp[HasPartitionKey](../../../../samples/core/Miscellaneous/NewInEFCore9.Cosmos/HierarchicalPartitionKeysSample.cs?name=HasPartitionKey)]
+
+> [!TIP]
+> This partition key definition follows the example given in [_Choose your hierarchical partition keys_](/azure/cosmos-db/hierarchical-partition-keys#choose-your-hierarchical-partition-keys) from the Azure Cosmos DB documentation.
+
+Notice how, starting with EF Core 9, properties of any mapped type can be used in the partition key. For `bool` and numeric types, like the `int SessionId` property, the value is used directly in the partition key. Other types, like the `Guid UserId` property, are automatically converted to strings.
+
+When querying, EF automatically extracts the partition key values from queries and applies them to the Azure Cosmos DB query API to ensure the queries are constrained appropriately to the fewest number of partitions possible. For example, consider the following LINQ query that supplies all three partition key values in the hierarchy:
+
+<!--
+            var tenantId = "Microsoft";
+            var sessionId = 7;
+            var userId = new Guid("99A410D7-E467-4CC5-92DE-148F3FC53F4C");
+
+            var sessions = await context.Sessions
+                .Where(
+                    e => e.TenantId == tenantId
+                         && e.UserId == userId
+                         && e.SessionId == sessionId
+                         && e.Username.Contains("a"))
+                .ToListAsync();
+-->
+[!code-csharp[FullPartitionKey](../../../../samples/core/Miscellaneous/NewInEFCore9.Cosmos/HierarchicalPartitionKeysSample.cs?name=FullPartitionKey)]
+
+When executing this query, EF Core will extract the values of the `tenantId`, `userId`, and `sessionId` parameters, and pass them to the Azure Cosmos DB query API as the partition key value. For example, see the logs from executing the query above:
+
+```output
+info: 6/10/2024 19:06:00.017 CosmosEventId.ExecutingSqlQuery[30100] (Microsoft.EntityFrameworkCore.Database.Command) 
+      Executing SQL query for container 'UserSessionContext' in partition '["Microsoft","00aa00aa-bb11-cc22-dd33-44ee44ee44ee",7.0]' [Parameters=[]]
+      SELECT c
+      FROM root c
+      WHERE ((c["Discriminator"] = "UserSession") AND CONTAINS(c["Username"], "a"))
+```
+
+Notice that the partition key comparisons have been removed from the `WHERE` clause, and are instead used as the partition key for efficient execution: `["Microsoft","00aa00aa-bb11-cc22-dd33-44ee44ee44ee",7.0]`.
+
+For more information, see the documentation on [querying with partition keys](xref:core/providers/cosmos/querying#partition-keys).
+
+### Significantly improved LINQ querying capabilities
+
+In EF 9.0, the LINQ translation capabilities of the the Azure Cosmos DB provider have been greatly expanded, and the provider can now execute significantly more query types. The full list of query improvements is too long to list, but here are the main highlights:
+
+* Full support for EF's primitive collections, allowing you to perform LINQ querying on collections of e.g. ints or strings. See [What's new in EF8: primitive collections](xref:core/what-is-new/ef-core-8.0/whatsnew#primitive-collections) for more information.
+* Support for arbitrary querying over non-primitive collections.
+* Lots of additional LINQ operators are now supported: indexing into collections, `Length`/`Count`, `ElementAt`, `Contains`, and many others.
+* Support for aggregate operators such as `Count` and `Sum`.
+* Additional function translations (see the [function mappings documentation](xref:core/providers/cosmos/querying#function-mappings) for the full list of supported translations):
+  * Translations for `DateTime` and `DateTimeOffset` component members (`DateTime.Year`, `DateTimeOffset.Month`...).
+  * <xref:Microsoft.EntityFrameworkCore.CosmosDbFunctionsExtensions.IsDefined*> and <xref:Microsoft.EntityFrameworkCore.CosmosDbFunctionsExtensions.CoalesceUndefined*> now allow dealing with `undefined` values.
+  * `string.Contains`, `StartsWith` and `EndsWith` now support `StringComparison.OrdinalIgnoreCase`.
+
+For the full list of querying improvements, see [this issue](https://github.com/dotnet/efcore/issues/33033):
+
+### Improved modeling aligned to Azure Cosmos DB and JSON standards
+
+EF 9.0 maps to Azure Cosmos DB documents in more natural ways for a JSON-based document database, and helps interoperate with other systems accessing your documents. Although this entails breaking changes, APIs exist which allow reverting back to the pre-9.0 behavior in all cases.
+
+#### Simplified `id` properties without discriminators
+
+First, previous versions of EF inserted the discriminator value into the JSON `id` property, producing documents such as the following:
+
+```json
+{
+    "id": "Blog|1099",
+    ...
+}
+```
+
+This was done in order to allow for documents of different types (e.g. Blog and Post) and the same key value (1099) to exist within the same container partition. Starting with EF 9.0, the `id` property contains contains only the key value:
+
+```json
+{
+    "id": 1099,
+    ...
+}
+```
+
+This is a more natural way to map to JSON, and makes it easier for external tools and systems to interact with EF-generated JSON documents; such external systems aren't generally aware of the EF discriminator values, which are by default derived from .NET types.
+
+Note this is a breaking change, since EF will no longer be able to query existing documents with the old `id` format. An API has been introduced to revert to the previous behavior, see the [breaking change note](xref:core/what-is-new/ef-core-9.0/breaking-changes#cosmos-id-property-changes) and the [the documentation](xref:core/providers/cosmos/modeling#Discriminators) for more details.
+
+#### Discriminator property renamed to `$type`
+
+The default discriminator property was previously named `Discriminator`. EF 9.0 changes the default to `$type`:
+
+```json
+{
+    "id": 1099,
+    "$type": "Blog",
+    ...
+}
+```
+
+This follows the emerging standard for JSON polymorphism, allowing better interoperability with other tools. For example, .NET's System.Text.Json also supports polymorphism, using `$type` as its default discriminator property name ([docs](/dotnet/standard/serialization/system-text-json/polymorphism#customize-the-type-discriminator-name)).
+
+Note this is a breaking change, since EF will no longer be able to query existing documents with the old discriminator property name. See the [breaking change note](xref:core/what-is-new/ef-core-9.0/breaking-changes#cosmos-discriminator-name-change) for details on how to revert to the previous naming.
+
+### Vector similarity search (preview)
+
+Azure Cosmos DB now offers preview support for vector similarity search. Vector search is a fundamental part of some application types, including AI, semantic search and others. Azure Cosmos DB allows you to store vectors directly in your documents alongside the rest of your data, meaning you can perform all of your queries against a single database. This can considerably simplify your architecture and remove the need for an additional, dedicated vector database solution in your stack. To learn more about Azure Cosmos DB vector search, [see the documentation](/azure/cosmos-db/nosql/vector-search).
+
+Once your Azure Cosmos DB container is properly set up, using vector search via EF is a simple matter of adding a vector property and configuring it:
+
+```c#
+public class Blog
+{
+    ...
+
+    public float[] Vector { get; set; }
+}
+
+public class BloggingContext
+{
+    ...
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .Property(b => b.Embeddings)
+            .IsVector(DistanceFunction.Cosine, dimensions: 1536);
+    }
+}
+```
+
+Once that's done, use the <xref:Microsoft.EntityFrameworkCore.CosmosDbFunctionsExtensions.VectorDistance*> function in LINQ queries to perform vector similarity search:
+
+```c#
+var blogs = await context.Blogs
+    .OrderBy(s => EF.Functions.VectorDistance(s.Vector, vector))
+    .Take(5)
+    .ToListAsync();
+```
+
+For more information, see the [documentation on vector search](xref:core/providers/cosmos/vector-search).
+
+### Pagination support
+
+The Azure Cosmos DB provider now allows for paginating through query results via _continuation tokens_, which is far more efficient and cost-effective than the traditional use of `Skip` and `Take`:
+
+```c#
+var firstPage = await context.Posts
+    .OrderBy(p => p.Id)
+    .ToPageAsync(pageSize: 10, continuationToken: null);
+
+var continuationToken = firstPage.ContinuationToken;
+foreach (var post in page.Values)
+{
+    // Display/send the posts to the user
+}
+```
+
+The new <xref:Microsoft.EntityFrameworkCore.CosmosQueryableExtensions.ToPageAsync*> operator returns a <xref:Microsoft.EntityFrameworkCore.CosmosPage`1>, which exposes a continuation token that can be used to efficiently resume the query at a later point, fetching the next 10 items:
+
+```c#
+var nextPage = await context.Sessions.OrderBy(s => s.Id).ToPageAsync(10, continuationToken);
+```
+
+For more information, [see the documentation section on pagination](xref:core/providers/cosmos/querying#pagination).
+
+### FromSql for safer SQL querying
+
+The Azure Cosmos DB provider has allowed SQL querying via <xref:Microsoft.EntityFrameworkCore.CosmosQueryableExtensions.FromSqlRaw*>. However, that API can be susceptible to SQL injection attacks when user-provided data is interpolated or concatenated into the SQL. In EF 9.0, you can now use the new <xref:Microsoft.EntityFrameworkCore.CosmosQueryableExtensions.FromSql*> method, which always integrates parameterized data as a parameter outside the SQL:
+
+```c#
+var maxAngle = 8;
+_ = await context.Blogs
+    .FromSql($"SELECT VALUE c FROM root c WHERE c.Angle1 <= {maxAngle}")
+    .ToListAsync();
+```
+
+For more information, [see the documentation section on pagination](xref:core/providers/cosmos/querying#pagination).
+
+### Role-based access
+
+Azure Cosmos DB for NoSQL includes a [built-in role-based access control (RBAC) system](/azure/cosmos-db/role-based-access-control). This is now supported by EF9 for all data plane operations. However, Azure Cosmos DB SDK does not support RBAC for management plane operations in Azure Cosmos DB. Use Azure Management API instead of <xref:Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade.EnsureCreatedAsync*> with RBAC.
+
+### Synchronous I/O is now blocked by default
+
+Azure Cosmos DB for NoSQL does not support synchronous (blocking) APIs from application code. Previously, EF masked this by blocking for you on async calls. However, this both encourages synchronous I/O use, which is bad practice, and [may cause deadlocks](https://blog.stephencleary.com/2012/07/dont-block-on-async-code.html). Therefore, starting with EF 9, an exception is thrown when synchronous access is attempted. For example:
+
+Synchronous I/O can still be used for now by configuring the warning level appropriately. For example, in `OnConfiguring` on your `DbContext` type:
+
+```csharp
+protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    => optionsBuilder.ConfigureWarnings(b => b.Ignore(CosmosEventId.SyncNotSupported));
+```
+
+Note, however, that we plan to fully remove sync support in EF 11, so start updating to use async methods like `ToListAsync` and `SaveChangesAsync` as soon as possible!
+
+## AOT and pre-compiled queries
+
+> [!WARNING]
+> NativeAOT and query precompilation are highly experimental features, and are not yet suited for production use. The support described below should be viewed as infrastructure towards the final feature, which will be released in a future version. We encourage you to experiment with the current support and report on your experiences, but recommend against deploying EF NativeAOT applications in production.
+
+EF 9.0 brings initial, experimental support for [.NET NativeAOT](/dotnet/core/deploying/native-aot), allowing the publishing of ahead-of-time compiled applications which make use of EF to access databases. To support LINQ queries in NativeAOT mode, EF relies on _query precompilation_: this mechanism statically identifies EF LINQ queries and generates C# [_interceptors_](/dotnet/csharp/whats-new/csharp-12#interceptors), which contain code to execute each specific query. This can significantly cut down on your application's startup time, as the heavy lifting of processing and compiling your LINQ queries into SQL no longer happens every time your application starts up. Instead, each query's interceptor contains the finalized SQL for that query, as well as optimized code to materialize database results as .NET objects.
+
+For example, given a program with the following EF query:
+
+```c#
+var blogs = await context.Blogs.Where(b => b.Name == "foo").ToListAsync();
+```
+
+EF will generate a C# interceptor into your project, which will take over the query execution. Instead of processing the query and translating it to SQL every time the program starts, the interceptor has the SQL embedded right into it (for SQL Server in this case), allowing your program to start up much faster:
+
+```c#
+var relationalCommandTemplate = ((IRelationalCommandTemplate)(new RelationalCommand(materializerLiftableConstantContext.CommandBuilderDependencies, "SELECT [b].[Id], [b].[Name]\nFROM [Blogs] AS [b]\nWHERE [b].[Name] = N'foo'", new IRelationalParameter[] { })));
+```
+
+In addition, the same interceptor contains code to materialize your .NET object from database results:
+
+```c#
+var instance = new Blog();
+UnsafeAccessor_Blog_Id_Set(instance) = dataReader.GetInt32(0);
+UnsafeAccessor_Blog_Name_Set(instance) = dataReader.GetString(1);
+```
+
+This uses another new .NET feature - [unsafe accessors](/dotnet/api/system.runtime.compilerservices.unsafeaccessorattribute), to inject data from the database into your object's private fields.
+
+If you're interested in NativeAOT and like to experiment with cutting-edge features, give this a try! Just be aware that the feature should be considered unstable, and currently has many limitations; we expect to stabilize it and make it more suitable for production usage in EF 10.
+
+See the [NativeAOT documentation page](xref:core/performance/nativeaot-and-precompiled-queries) for more details.
+
+## LINQ and SQL translation
+
+Like with every release, EF9 includes a large number of improvements to the LINQ querying capabilities. New queries can be translated, and many SQL translations for supported scenarios have been improved, for both better performance and readability.
+
+The number of improvements is too great to list them all here. Below, some of the more important improvements are highlighted; see [this issue](https://github.com/dotnet/efcore/issues/34151) for a more complete listing of the work done in 9.0.
+
+We'd like to call out Andrea Canciani ([@ranma42](https://github.com/ranma42)) for his numerous, high-quality contributions to optimizing the SQL that gets generated by EF Core!
+
+<a name="complex-types"></a>
+
+### Complex types: GroupBy and ExecuteUpdate support
+
+#### GroupBy
+
+> [!TIP]
+> The code shown here comes from [ComplexTypesSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore9/ComplexTypesSample.cs).
+
+EF9 supports grouping by a complex type instance. For example:
+
+<!--
+        var groupedAddresses = await context.Stores
+            .GroupBy(b => b.StoreAddress)
+            .Select(g => new { g.Key, Count = g.Count() })
+            .ToListAsync();
+-->
+[!code-csharp[GroupByComplexType](../../../../samples/core/Miscellaneous/NewInEFCore9/ComplexTypesSample.cs?name=GroupByComplexType)]
+
+EF translates this as grouping by each member of the complex type, which aligns with the semantics of complex types as value objects. For example, on Azure SQL:
+
+```sql
+SELECT [s].[StoreAddress_City], [s].[StoreAddress_Country], [s].[StoreAddress_Line1], [s].[StoreAddress_Line2], [s].[StoreAddress_PostCode], COUNT(*) AS [Count]
+FROM [Stores] AS [s]
+GROUP BY [s].[StoreAddress_City], [s].[StoreAddress_Country], [s].[StoreAddress_Line1], [s].[StoreAddress_Line2], [s].[StoreAddress_PostCode]
+```
+
+#### ExecuteUpdate
+
+> [!TIP]
+> The code shown here comes from [ExecuteUpdateSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore9/ExecuteUpdateSample.cs).
+
+Similarly, in EF9 <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.ExecuteUpdateAsync*> has also been improved to accept complex type properties. However, each member of the complex type must be specified explicitly. For example:
+
+<!--
+            #region UpdateComplexType
+            var newAddress = new Address("Gressenhall Farm Shop", null, "Beetley", "Norfolk", "NR20 4DR");
+
+            await context.Stores
+                .Where(e => e.Region == "Germany")
+                .ExecuteUpdateAsync(s => s.SetProperty(b => b.StoreAddress, newAddress));
+-->
+[!code-csharp[UpdateComplexType](../../../../samples/core/Miscellaneous/NewInEFCore9/ExecuteUpdateSample.cs?name=UpdateComplexType)]
+
+This generates SQL that updates each column mapped to the complex type:
+
+```sql
+UPDATE [s]
+SET [s].[StoreAddress_City] = @__complex_type_newAddress_0_City,
+    [s].[StoreAddress_Country] = @__complex_type_newAddress_0_Country,
+    [s].[StoreAddress_Line1] = @__complex_type_newAddress_0_Line1,
+    [s].[StoreAddress_Line2] = NULL,
+    [s].[StoreAddress_PostCode] = @__complex_type_newAddress_0_PostCode
+FROM [Stores] AS [s]
+WHERE [s].[Region] = N'Germany'
+```
+
+Previously, you had to manually list out the different properties of the complex type in your <xref:Microsoft.EntityFrameworkCore.RelationalQueryableExtensions.ExecuteUpdateAsync*> call.
+
+<a name="prune"></a>
+
+### Prune unneeded elements from SQL
+
+Previously, EF sometimes produced SQL which contained elements that weren't actually needed; in most cases, these were possibly needed at an earlier stage of SQL processing, and were left behind. EF9 now prunes most such elements, resulting in more compact and, in some cases, more efficient SQL.
+
+#### Table pruning
+
+As a first example, the SQL generated by EF sometimes contained JOINs to tables which weren't actually needed in the query. Consider the following model, which uses [table-per-type (TPT) inheritance mapping](xref:core/modeling/inheritance#table-per-type-configuration):
+
+```csharp
+public class Order
+{
+    public int Id { get; set; }
+    ...
+
+    public Customer Customer { get; set; }
+}
+
+public class DiscountedOrder : Order
+{
+    public double Discount { get; set; }
+}
+
+public class Customer
+{
+    public int Id { get; set; }
+    ...
+
+    public List<Order> Orders { get; set; }
+}
+
+public class BlogContext : DbContext
+{
+    ...
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Order>().UseTptMappingStrategy();
+    }
+}
+```
+
+If we then execute the following query to get all Customers with at least one Order:
+
+```csharp
+var customers = await context.Customers.Where(o => o.Orders.Any()).ToListAsync();
+```
+
+EF8 generated the following SQL:
+
+```sql
+SELECT [c].[Id], [c].[Name]
+FROM [Customers] AS [c]
+WHERE EXISTS (
+    SELECT 1
+    FROM [Orders] AS [o]
+    LEFT JOIN [DiscountedOrders] AS [d] ON [o].[Id] = [d].[Id]
+    WHERE [c].[Id] = [o].[CustomerId])
+```
+
+Note that the query contained a join to the `DiscountedOrders` table even though no columns were referenced on it. EF9 generates a pruned SQL without the join:
+
+```c#
+SELECT [c].[Id], [c].[Name]
+FROM [Customers] AS [c]
+WHERE EXISTS (
+    SELECT 1
+    FROM [Orders] AS [o]
+    WHERE [c].[Id] = [o].[CustomerId])
+```
+
+#### Projection pruning
+
+Similarly, let's examine the following query:
+
+```csharp
+var orders = await context.Orders
+    .Where(o => o.Amount > 10)
+    .Take(5)
+    .CountAsync();
+```
+
+On EF8, this query generated the following SQL:
+
+```sql
+SELECT COUNT(*)
+FROM (
+    SELECT TOP(@__p_0) [o].[Id]
+    FROM [Orders] AS [o]
+    WHERE [o].[Amount] > 10
+) AS [t]
+```
+
+Note that the `[o].[Id]` projection isn't needed in the subquery, since the outer SELECT expression simply counts the rows. EF9 generates the following instead:
+
+```sql
+SELECT COUNT(*)
+FROM (
+    SELECT TOP(@__p_0) 1 AS empty
+    FROM [Orders] AS [o]
+    WHERE [o].[Amount] > 10
+) AS [s]
+```
+
+... and the projection is empty. This may not seem like much, but it can significantly simplify the SQL in some cases; you're welcome to scroll through some of the [SQL changes in the tests](https://github.com/dotnet/efcore/pull/32672/files#diff-95664269d9a59fe9627612bf1d3e1704e76f6065e329edeecd14a8bf436db058L4011) to see the effect.
+
+<a name="greatest"></a>
+
+### Translations involving GREATEST/LEAST
+
+> [!TIP]
+> The code shown here comes from [LeastGreatestSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore9/LeastGreatestSample.cs).
+
+Several new translations have been introduced that use the `GREATEST` and `LEAST` SQL functions.
+
+> [!IMPORTANT]
+> The `GREATEST` and `LEAST` functions were [introduced to SQL Server/Azure SQL databases in the 2022 version](https://techcommunity.microsoft.com/t5/azure-sql-blog/introducing-the-greatest-and-least-t-sql-functions/ba-p/2281726). Visual Studio 2022 installs SQL Server 2019 by default. We recommend installing [SQL Server Developer Edition 2022](https://www.microsoft.com/sql-server/sql-server-downloads) to try out these new translations in EF9.
+
+For example, queries using `Math.Max` or `Math.Min` are now translated for Azure SQL using `GREATEST` and `LEAST` respectively. For example:
+
+<!--
+        #region MathMin
+        var walksUsingMin = await context.Walks
+            .Where(e => Math.Min(e.DaysVisited.Count, e.ClosestPub.Beers.Length) > 4)
+            .ToListAsync();
+-->
+[!code-csharp[MathMin](../../../../samples/core/Miscellaneous/NewInEFCore9/LeastGreatestSample.cs?name=MathMin)]
+
+This query is translated to the following SQL when using EF9 executing against SQL Server 2022:
+
+```sql
+SELECT [w].[Id], [w].[ClosestPubId], [w].[DaysVisited], [w].[Name], [w].[Terrain]
+FROM [Walks] AS [w]
+INNER JOIN [Pubs] AS [p] ON [w].[ClosestPubId] = [p].[Id]
+WHERE LEAST((
+    SELECT COUNT(*)
+    FROM OPENJSON([w].[DaysVisited]) AS [d]), (
+    SELECT COUNT(*)
+    FROM OPENJSON([p].[Beers]) AS [b])) >
+```
+
+`Math.Min` and `Math.Max` can also be used on the values of a primitive collection. For example:
+
+<!--
+        #region MathMinPrimitive
+        var pubsInlineMax = await context.Pubs
+            .SelectMany(e => e.Counts)
+            .Where(e => Math.Max(e, threshold) > top)
+            .ToListAsync();
+-->
+[!code-csharp[MathMinPrimitive](../../../../samples/core/Miscellaneous/NewInEFCore9/LeastGreatestSample.cs?name=MathMinPrimitive)]
+
+This query is translated to the following SQL when using EF9 executing against SQL Server 2022:
+
+```sql
+SELECT [c].[value]
+FROM [Pubs] AS [p]
+CROSS APPLY OPENJSON([p].[Counts]) WITH ([value] int '$') AS [c]
+WHERE GREATEST([c].[value], @__threshold_0) > @__top_1
+```
+
+Finally, `RelationalDbFunctionsExtensions.Least` and `RelationalDbFunctionsExtensions.Greatest` can be used to directly invoke the `Least` or `Greatest` function in SQL. For example:
+
+<!--
+        #region Least
+        var leastCount = await context.Pubs
+            .Select(e => EF.Functions.Least(e.Counts.Length, e.DaysVisited.Count, e.Beers.Length))
+            .ToListAsync();
+-->
+[!code-csharp[Least](../../../../samples/core/Miscellaneous/NewInEFCore9/LeastGreatestSample.cs?name=Least)]
+
+This query is translated to the following SQL when using EF9 executing against SQL Server 2022:
+
+```sql
+SELECT LEAST((
+    SELECT COUNT(*)
+    FROM OPENJSON([p].[Counts]) AS [c]), (
+    SELECT COUNT(*)
+    FROM OPENJSON([p].[DaysVisited]) AS [d]), (
+    SELECT COUNT(*)
+    FROM OPENJSON([p].[Beers]) AS [b]))
+FROM [Pubs] AS [p]
+```
+
+<a name="parameterization"></a>
+
+### Force or prevent query parameterization
+
+> [!TIP]
+> The code shown here comes from [QuerySample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore9/QuerySample.cs).
+
+Except in some special cases, EF Core parameterizes variables used in a LINQ query, but includes constants in the generated SQL. For example, consider the following query method:
+
+<!--
+        #region DefaultParameterization
+        async Task<List<Post>> GetPosts(int id)
+            => await context.Posts
+                .Where(e => e.Title == ".NET Blog" && e.Id == id)
+                .ToListAsync();
+-->
+[!code-csharp[DefaultParameterization](../../../../samples/core/Miscellaneous/NewInEFCore9/QuerySample.cs?name=DefaultParameterization)]
+
+This translates to the following SQL and parameters when using Azure SQL:
+
+```output
+Executed DbCommand (1ms) [Parameters=[@__id_0='1'], CommandType='Text', CommandTimeout='30']
+SELECT [p].[Id], [p].[Archived], [p].[AuthorId], [p].[BlogId], [p].[Content], [p].[Discriminator], [p].[PublishedOn], [p].[Title], [p].[PromoText], [p].[Metadata]
+FROM [Posts] AS [p]
+WHERE [p].[Title] = N'.NET Blog' AND [p].[Id] = @__id_0
+```
+
+Notice that EF created a constant in the SQL for ".NET Blog" because this value will not change from query to query. Using a constant allows this value to be examined by the database engine when creating a query plan, potentially resulting in a more efficient query.
+
+On the other hand, the value of `id` is parameterized, since the same query may be executed with many different values for `id`. Creating a constant in this case would result in pollution of the query cache with lots of queries that differ only in `id` values. This is very bad for overall performance of the database.
+
+Generally speaking, these defaults should not be changed. However, EF Core 8.0.2 introduces an <xref:Microsoft.EntityFrameworkCore.EF.Constant*> method which forces EF to use a constant even if a parameter would be used by default. For example:
+
+<!--
+        #region ForceConstant
+        async Task<List<Post>> GetPostsForceConstant(int id)
+            => await context.Posts
+                .Where(e => e.Title == ".NET Blog" && e.Id == EF.Constant(id))
+                .ToListAsync();
+-->
+[!code-csharp[ForceConstant](../../../../samples/core/Miscellaneous/NewInEFCore9/QuerySample.cs?name=ForceConstant)]
+
+The translation now contains a constant for the `id` value:
+
+```output
+Executed DbCommand (1ms) [Parameters=[], CommandType='Text', CommandTimeout='30']
+SELECT [p].[Id], [p].[Archived], [p].[AuthorId], [p].[BlogId], [p].[Content], [p].[Discriminator], [p].[PublishedOn], [p].[Title], [p].[PromoText], [p].[Metadata]
+FROM [Posts] AS [p]
+WHERE [p].[Title] = N'.NET Blog' AND [p].[Id] = 1
+```
+
+#### The EF.Parameter method
+
+EF9 introduces the <xref:Microsoft.EntityFrameworkCore.EF.Parameter*> method to do the opposite. That is, force EF to use a parameter even if the value is a constant in code. For example:
+
+<!--
+        #region ForceParameter
+        async Task<List<Post>> GetPostsForceParameter(int id)
+            => await context.Posts
+                .Where(e => e.Title == EF.Parameter(".NET Blog") && e.Id == id)
+                .ToListAsync();
+-->
+[!code-csharp[ForceParameter](../../../../samples/core/Miscellaneous/NewInEFCore9/QuerySample.cs?name=ForceParameter)]
+
+The translation now contains a parameter for the ".NET Blog" string:
+
+```output
+Executed DbCommand (1ms) [Parameters=[@__p_0='.NET Blog' (Size = 4000), @__id_1='1'], CommandType='Text', CommandTimeout='30']
+SELECT [p].[Id], [p].[Archived], [p].[AuthorId], [p].[BlogId], [p].[Content], [p].[Discriminator], [p].[PublishedOn], [p].[Title], [p].[PromoText], [p].[Metadata]
+FROM [Posts] AS [p]
+WHERE [p].[Title] = @__p_0 AND [p].[Id] = @__id_1
+```
+
+<a name="parameterized-collections"></a>
+
+#### Parameterized primitive collections
+
+EF8 changed the way [some queries that use primitive collections are translated](xref:core/what-is-new/ef-core-8.0/whatsnew#queries-with-primitive-collections). When a LINQ query contains a parameterized primitive collection, EF converts its contents to JSON and pass it as a single parameter value the query:
+
+<!--
+#region DefaultParameterizationPrimitiveCollection
+async Task<List<Post>> GetPostsPrimitiveCollection(int[] ids)
+    => await context.Posts
+        .Where(e => e.Title == ".NET Blog" && ids.Contains(e.Id))
+        .ToListAsync();
+-->
+[!code-csharp[ForceParameter](../../../../samples/core/Miscellaneous/NewInEFCore9/QuerySample.cs?name=DefaultParameterizationPrimitiveCollection)]
+
+This will result in the following translation on SQL Server:
+
+```output
+Executed DbCommand (5ms) [Parameters=[@__ids_0='[1,2,3]' (Size = 4000)], CommandType='Text', CommandTimeout='30']
+SELECT [p].[Id], [p].[Archived], [p].[AuthorId], [p].[BlogId], [p].[Content], [p].[Discriminator], [p].[PublishedOn], [p].[Rating], [p].[Title], [p].[PromoText], [p].[Metadata]
+FROM [Posts] AS [p]
+WHERE [p].[Title] = N'.NET Blog' AND [p].[Id] IN (
+    SELECT [i].[value]
+    FROM OPENJSON(@__ids_0) WITH ([value] int '$') AS [i]
+)
+```
+
+This allows having the same SQL query for different parameterized collections (only the parameter value changes), but in some situations it can lead to performance issues as the database isn't able to optimally plan for the query. The <xref:Microsoft.EntityFrameworkCore.EF.Constant*> method can be used to revert to the previous translation.
+
+The following query uses <xref:Microsoft.EntityFrameworkCore.EF.Constant*> to that effect:
+
+<!--
+#region ForceConstantPrimitiveCollection
+async Task<List<Post>> GetPostsForceConstantCollection(int[] ids)
+    => await context.Posts
+        .Where(e => e.Title == ".NET Blog" && EF.Constant(ids).Contains(e.Id))
+        .ToListAsync();
+-->
+[!code-csharp[ForceParameter](../../../../samples/core/Miscellaneous/NewInEFCore9/QuerySample.cs?name=ForceConstantPrimitiveCollection)]
+
+The resulting SQL is as follows:
+
+```sql
+SELECT [p].[Id], [p].[Archived], [p].[AuthorId], [p].[BlogId], [p].[Content], [p].[Discriminator], [p].[PublishedOn], [p].[Rating], [p].[Title], [p].[PromoText], [p].[Metadata]
+FROM [Posts] AS [p]
+WHERE [p].[Title] = N'.NET Blog' AND [p].[Id] IN (1, 2, 3)
+```
+
+Moreover, EF9 introduces `TranslateParameterizedCollectionsToConstants` [context option](/ef/core/dbcontext-configuration/#dbcontextoptions) that can be used to prevent primitive collection parameterization for all queries. We also added a complementing `TranslateParameterizedCollectionsToParameters` which forces parameterization of primitive collections explicitly (this is the default behavior).
+
+> [!TIP]
+> The <xref:Microsoft.EntityFrameworkCore.EF.Parameter*> method overrides the context option. If you want to prevent parameterization of primitive collections for most of your queries (but not all), you can set the context option `TranslateParameterizedCollectionsToConstants` and use <xref:Microsoft.EntityFrameworkCore.EF.Parameter*> for the queries or individual variables that you want to parameterize.
+
+<a name="inlinedsubs"></a>
+
+### Inlined uncorrelated subqueries
+
+> [!TIP]
+> The code shown here comes from [QuerySample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore9/QuerySample.cs).
+
+In EF8, an IQueryable referenced in another query may be executed as a separate database roundtrip. For example, consider the following LINQ query:
+
+<!--
+        #region InlinedSubquery
+        var dotnetPosts = context
+            .Posts
+            .Where(p => p.Title.Contains(".NET"));
+
+        var results = dotnetPosts
+            .Where(p => p.Id > 2)
+            .Select(p => new { Post = p, TotalCount = dotnetPosts.Count() })
+            .Skip(2).Take(10)
+            .ToArray();
+-->
+[!code-csharp[InlinedSubquery](../../../../samples/core/Miscellaneous/NewInEFCore9/QuerySample.cs?name=InlinedSubquery)]
+
+In EF8, the query for `dotnetPosts` is executed as one round trip, and then the final results are executed as second query. For example, on SQL Server:
+
+```sql
+SELECT COUNT(*)
+FROM [Posts] AS [p]
+WHERE [p].[Title] LIKE N'%.NET%'
+
+SELECT [p].[Id], [p].[Archived], [p].[AuthorId], [p].[BlogId], [p].[Content], [p].[Discriminator], [p].[PublishedOn], [p].[Title], [p].[PromoText], [p].[Metadata]
+FROM [Posts] AS [p]
+WHERE [p].[Title] LIKE N'%.NET%' AND [p].[Id] > 2
+ORDER BY (SELECT 1)
+OFFSET @__p_1 ROWS FETCH NEXT @__p_2 ROWS ONLY
+```
+
+In EF9, the `IQueryable` in the `dotnetPosts` is inlined, resulting in a single database round trip:
+
+```sql
+SELECT [p].[Id], [p].[Archived], [p].[AuthorId], [p].[BlogId], [p].[Content], [p].[Discriminator], [p].[PublishedOn], [p].[Title], [p].[PromoText], [p].[Metadata], (
+    SELECT COUNT(*)
+    FROM [Posts] AS [p0]
+    WHERE [p0].[Title] LIKE N'%.NET%')
+FROM [Posts] AS [p]
+WHERE [p].[Title] LIKE N'%.NET%' AND [p].[Id] > 2
+ORDER BY (SELECT 1)
+OFFSET @__p_0 ROWS FETCH NEXT @__p_1 ROWS ONLY
+```
+
+<a name="aggregate-over-subquery"></a>
+
+### Aggregate functions over subqueries and aggregates on SQL Server
+
+EF9 improves the translation of some complex queries using aggregate functions composed over subqueries or other aggregate functions.
+Below is an example of such query:
+
+<!--
+var latestPostsAverageRatingByLanguage = await context.Blogs.
+    Select(x => new
+    {
+        x.Language,
+        LatestPostRating = x.Posts.OrderByDescending(xx => xx.PublishedOn).FirstOrDefault().Rating
+    })
+    .GroupBy(x => x.Language)
+    .Select(x => x.Average(xx => xx.LatestPostRating))
+    .ToListAsync();
+-->
+[!code-csharp[AggregateOverSubquery](../../../../samples/core/Miscellaneous/NewInEFCore9/QuerySample.cs?name=AggregateOverSubquery)]
+
+First, `Select` computes `LatestPostRating` for each `Post` which requires a subquery when translating to SQL. Later in the query these results are aggregated using `Average` operation. The resulting SQL looks as follows when run on SQL Server:
+
+```sql
+SELECT AVG([s].[Rating])
+FROM [Blogs] AS [b]
+OUTER APPLY (
+    SELECT TOP(1) [p].[Rating]
+    FROM [Posts] AS [p]
+    WHERE [b].[Id] = [p].[BlogId]
+    ORDER BY [p].[PublishedOn] DESC
+) AS [s]
+GROUP BY [b].[Language]
+```
+
+In previous versions EF Core would generate invalid SQL for similar queries, trying to apply the aggregate operation directly over the subquery. This is not allowed on SQL Server and results in an exception.
+Same principle applies to queries using aggregate over another aggregate:
+
+<!--
+var topRatedPostsAverageRatingByLanguage = await context.Blogs.
+    Select(x => new
+    {
+        x.Language,
+        TopRating = x.Posts.Max(x => x.Rating)
+    })
+    .GroupBy(x => x.Language)
+    .Select(x => x.Average(xx => xx.TopRating))
+    .ToListAsync();
+-->
+[!code-csharp[AggregateOverAggregate](../../../../samples/core/Miscellaneous/NewInEFCore9/QuerySample.cs?name=AggregateOverAggregate)]
+
+> [!NOTE]
+> This change doesn't affect Sqlite, which supports aggregates over subqueries (or other aggregates) and it does not support `LATERAL JOIN` (`APPLY`). Below is the SQL for the first query running on Sqlite:
+>
+> ```sql
+> SELECT ef_avg((
+>     SELECT "p"."Rating"
+>     FROM "Posts" AS "p"
+>     WHERE "b"."Id" = "p"."BlogId"
+>     ORDER BY "p"."PublishedOn" DESC
+>     LIMIT 1))
+> FROM "Blogs" AS "b"
+> GROUP BY "b"."Language"
+> ```
+
+<a name="count-not-zero"></a>
+
+### Queries using Count != 0 are optimized
+
+> [!TIP]
+> The code shown here comes from [QuerySample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore9/QuerySample.cs).
+
+In EF8, the following LINQ query was translated to use the SQL `COUNT` function:
+
+<!--
+        var blogsWithPost = await context.Blogs
+            .Where(b => b.Posts.Count > 0)
+            .ToListAsync();
+-->
+[!code-csharp[NormalizeCount](../../../../samples/core/Miscellaneous/NewInEFCore9/QuerySample.cs?name=NormalizeCount)]
+
+EF9 now generates a more efficient translation using `EXISTS`:
+
+```sql
+SELECT "b"."Id", "b"."Name", "b"."SiteUri"
+FROM "Blogs" AS "b"
+WHERE EXISTS (
+    SELECT 1
+    FROM "Posts" AS "p"
+    WHERE "b"."Id" = "p"."BlogId")
+```
+
+<a name="comparison-null-semantics"></a>
+
+### C# semantics for comparison operations on nullable values
+
+In EF8 comparisons between nullable elements were not performed correctly for some scenarios. In C#, if one or both operands are null, the result of a comparison operation is false; otherwise, the contained values of operands are compared. In EF8 we used to translate comparisons using database null semantics. This would produce results different than similar query using LINQ to Objects.
+Moreover, we would produce different results when comparison was done in filter vs projection. Some queries would also produce different results between Sql Server and Sqlite/Postgres.
+
+For example, the query:
+
+<!--
+var negatedNullableComparisonFilter = await context.Entities
+    .Where(x => !(x.NullableIntOne > x.NullableIntTwo))
+    .Select(x => new { x.NullableIntOne, x.NullableIntTwo }).ToListAsync();
+-->
+[!code-csharp[NegatedNullableComparisonFilter](../../../../samples/core/Miscellaneous/NewInEFCore9/NullSemanticsSample.cs?name=NegatedNullableComparisonFilter)]
+
+would generate the following SQL:
+
+```sql
+SELECT [e].[NullableIntOne], [e].[NullableIntTwo]
+FROM [Entities] AS [e]
+WHERE NOT ([e].[NullableIntOne] > [e].[NullableIntTwo])
+```
+
+which filters out entities whose `NullableIntOne` or `NullableIntTwo` are set to null.
+
+In EF9 we produce:
+
+```sql
+SELECT [e].[NullableIntOne], [e].[NullableIntTwo]
+FROM [Entities] AS [e]
+WHERE CASE
+    WHEN [e].[NullableIntOne] > [e].[NullableIntTwo] THEN CAST(0 AS bit)
+    ELSE CAST(1 AS bit)
+END = CAST(1 AS bit)
+```
+
+Similar comparison performed in a projection:
+
+<!--
+var negatedNullableComparisonProjection = await context.Entities.Select(x => new
+{
+    x.NullableIntOne,
+    x.NullableIntTwo,
+    Operation = !(x.NullableIntOne > x.NullableIntTwo)
+}).ToListAsync();
+-->
+[!code-csharp[NegatedNullableComparisonProjection](../../../../samples/core/Miscellaneous/NewInEFCore9/NullSemanticsSample.cs?name=NegatedNullableComparisonProjection)]
+
+resulted in the following SQL:
+
+```sql
+SELECT [e].[NullableIntOne], [e].[NullableIntTwo], CASE
+    WHEN NOT ([e].[NullableIntOne] > [e].[NullableIntTwo]) THEN CAST(1 AS bit)
+    ELSE CAST(0 AS bit)
+END AS [Operation]
+FROM [Entities] AS [e]
+```
+
+which returns `false` for entities whose `NullableIntOne` or `NullableIntTwo` are set to null (rather than `true` expected in C#). Running the same scenario on Sqlite generated:
+
+```sql
+SELECT "e"."NullableIntOne", "e"."NullableIntTwo", NOT ("e"."NullableIntOne" > "e"."NullableIntTwo") AS "Operation"
+FROM "Entities" AS "e"
+```
+
+which results in `Nullable object must have a value` exception, as translation produces `null` value for cases where `NullableIntOne` or `NullableIntTwo` are null.
+
+EF9 now properly handles these scenarios, producing results consistent with LINQ to Objects and across different providers.
+
+This enhancement was contributed by [@ranma42](https://github.com/ranma42). Many thanks!
+
+<a name="order-operator"></a>
+
+### Translation of `Order` and `OrderDescending` LINQ operators
+
+EF9 enables the translation of LINQ simplified ordering operations (`Order` and `OrderDescending`). These work similar to `OrderBy`/`OrderByDescending` but don't require an argument. Instead, they apply default ordering - for entities this means ordering based on primary key values and for other types, ordering based on the values themselves.
+
+Below is an example query which takes advantage of the simplified ordering operators:
+
+<!--
+var orderOperation = await context.Blogs
+    .Order()
+    .Select(x => new
+    {
+        x.Name,
+        OrderedPosts = x.Posts.OrderDescending().ToList(),
+        OrderedTitles = x.Posts.Select(xx => xx.Title).Order().ToList()
+    })
+    .ToListAsync();
+-->
+[!code-csharp[OrderOrderDescending](../../../../samples/core/Miscellaneous/NewInEFCore9/QuerySample.cs?name=OrderOrderDescending)]
+
+This query is equivalent to the following:
+
+<!--
+var orderByEquivalent = await context.Blogs
+    .OrderBy(x => x.Id)
+    .Select(x => new
+    {
+        x.Name,
+        OrderedPosts = x.Posts.OrderByDescending(xx => xx.Id).ToList(),
+        OrderedTitles = x.Posts.Select(xx => xx.Title).OrderBy(xx => xx).ToList()
+    })
+    .ToListAsync();
+-->
+[!code-csharp[OrderByEquivalent](../../../../samples/core/Miscellaneous/NewInEFCore9/QuerySample.cs?name=OrderByEquivalent)]
+
+and produces the following SQL:
+
+```sql
+SELECT [b].[Name], [b].[Id], [p].[Id], [p].[Archived], [p].[AuthorId], [p].[BlogId], [p].[Content], [p].[Discriminator], [p].[PublishedOn], [p].[Rating], [p].[Title], [p].[PromoText], [p].[Metadata], [p0].[Title], [p0].[Id]
+FROM [Blogs] AS [b]
+LEFT JOIN [Posts] AS [p] ON [b].[Id] = [p].[BlogId]
+LEFT JOIN [Posts] AS [p0] ON [b].[Id] = [p0].[BlogId]
+ORDER BY [b].[Id], [p].[Id] DESC, [p0].[Title]
+```
+
+> [!NOTE]
+> `Order` and `OrderDescending` methods are only supported for collections of entities, complex types or scalars - they will not work on more complex projections, e.g. collections of anonymous types containing multiple properties.
+
+This enhancement was contributed by the EF Team alumnus [@bricelam](https://github.com/bricelam). Many thanks!
+
+<a name="improved-negation"></a>
+
+### Improved translation of logical negation operator (!)
+
+EF9 brings many optimizations around SQL `CASE/WHEN`, `COALESCE`, negation, and various other constructs; most of these were contributed by Andrea Canciani ([@ranma42](https://github.com/ranma42)) - many thanks for all of these! Below, we'll detail just a few of these optimizations around logical negation.
+
+Let's examine the following query:
+
+<!--
+var negatedContainsSimplification = await context.Posts
+    .Where(p => !p.Content.Contains("Announcing"))
+    .Select(p => new { p.Content }).ToListAsync();
+-->
+[!code-csharp[NegatedContainsImprovements](../../../../samples/core/Miscellaneous/NewInEFCore9/QuerySample.cs?name=NegatedContainsImprovements)]
+
+In EF8 we would produce the following SQL:
+
+```sql
+SELECT "p"."Content"
+FROM "Posts" AS "p"
+WHERE NOT (instr("p"."Content", 'Announcing') > 0)
+```
+
+In EF9 we "push" `NOT` operation into the comparison:
+
+```sql
+SELECT "p"."Content"
+FROM "Posts" AS "p"
+WHERE instr("p"."Content", 'Announcing') <= 0
+```
+
+Another example, applicable to SQL Server, is a negated conditional operation.
+
+<!--
+var caseSimplification = await context.Blogs
+    .Select(b => !(b.Id > 5 ? false : true))
+    .ToListAsync();
+-->
+[!code-csharp[CaseTranslationImprovements](../../../../samples/core/Miscellaneous/NewInEFCore9/QuerySample.cs?name=CaseTranslationImprovements)]
+
+In EF8 used to result in nested `CASE` blocks:
+
+```sql
+SELECT CASE
+    WHEN CASE
+        WHEN [b].[Id] > 5 THEN CAST(0 AS bit)
+        ELSE CAST(1 AS bit)
+    END = CAST(0 AS bit) THEN CAST(1 AS bit)
+    ELSE CAST(0 AS bit)
+END
+FROM [Blogs] AS [b]
+```
+
+In EF9 we removed the nesting:
+
+```sql
+SELECT CASE
+    WHEN [b].[Id] > 5 THEN CAST(1 AS bit)
+    ELSE CAST(0 AS bit)
+END
+FROM [Blogs] AS [b]
+```
+
+On SQL Server, when projecting a negated bool property:
+
+<!--
+var negatedBoolProjection = await context.Posts.Select(x => new { x.Title, Active = !x.Archived }).ToListAsync();
+-->
+[!code-csharp[NegatedBoolProjection](../../../../samples/core/Miscellaneous/NewInEFCore9/QuerySample.cs?name=NegatedBoolProjection)]
+
+ EF8 would generate a `CASE` block because comparisons can't appear in the projection directly in SQL Server queries:
+
+ ```sql
+SELECT [p].[Title], CASE
+    WHEN [p].[Archived] = CAST(0 AS bit) THEN CAST(1 AS bit)
+    ELSE CAST(0 AS bit)
+END AS [Active]
+FROM [Posts] AS [p]
+ ```
+
+In EF9, this translation has been simplified and now uses bitwise NOT (`~`):
+
+```sql
+SELECT [p].[Title], ~[p].[Archived] AS [Active]
+FROM [Posts] AS [p]
+```
+
+<a name="azuresql-azuresynapse"></a>
+
+### Better support for Azure SQL and Azure Synapse
+
+EF9 allows for more flexibility when specifying the type of SQL Server which is being targeted. Instead of configuring EF with `UseSqlServer`, you can now specify `UseAzureSql` or `UseAzureSynapse`.
+This allows EF to produce better SQL when using Azure SQL or Azure Synapse. EF can take advantage of the database specific features (e.g. [dedicated type for JSON on Azure SQL](/sql/t-sql/data-types/json-data-type)), or work around its limitations (e.g. [`ESCAPE` clause is not available when using `LIKE` on Azure Synapse](/sql/t-sql/language-elements/like-transact-sql#syntax)).
+
+### Other query improvements
+
+* The primitive collections querying support [introduced in EF8](xref:core/what-is-new/ef-core-8.0/whatsnew#queries-with-primitive-collections) has been extended to support all `ICollection<T>` types. Note that this applies only to parameter and inline collections - primitive collections that are part of entities are still limited to arrays, lists and [in EF9 also read-only arrays/lists](#read-only-primitive-collections).
+* New `ToHashSetAsync` functions to return the results of a query as a `HashSet` ([#30033](https://github.com/dotnet/efcore/issues/30033), contributed by [@wertzui](https://github.com/wertzui)).
+* `TimeOnly.FromDateTime` and `FromTimeSpan` are now translated on SQL Server ([#33678](https://github.com/dotnet/efcore/issues/33678)).
+* `ToString` over enums is now translated ([#33706](https://github.com/dotnet/efcore/pull/33706), contributed by [@Danevandy99](https://github.com/Danevandy99)).
+* `string.Join` now translates to [CONCAT_WS](/sql/t-sql/functions/concat-ws-transact-sql) in non-aggregate context on SQL Server ([#28899](https://github.com/dotnet/efcore/issues/28899)).
+* `EF.Functions.PatIndex` now translates to the SQL Server [`PATINDEX`](/sql/t-sql/functions/patindex-transact-sql) function, which returns the starting position of the first occurrence of a pattern ([#33702](https://github.com/dotnet/efcore/issues/33702), [@smnsht](https://github.com/smnsht)).
+* `Sum` and `Average` now work for decimals on SQLite ([#33721](https://github.com/dotnet/efcore/pull/33721), contributed by [@ranma42](https://github.com/ranma42)).
+* Fixes and optimizations to `string.StartsWith` and `EndsWith` ([#31482](https://github.com/dotnet/efcore/pull/31482)).
+* `Convert.To*` methods can now accept argument of type `object` ([#33891](https://github.com/dotnet/efcore/pull/33891), contributed by [@imangd](https://github.com/imangd)).
+* Exclusive-Or (XOR) operation is now translated on SQL Server ([#34071](https://github.com/dotnet/efcore/pull/34071), contributed by [@ranma42](https://github.com/ranma42)).
+* Optimizations around nullability for `COLLATE` and `AT TIME ZONE` operations ([#34263](https://github.com/dotnet/efcore/pull/34263), contributed by [@ranma42](https://github.com/ranma42)).
+* Optimizations for `DISTINCT` over `IN`, `EXISTS` and set operations ([#34381](https://github.com/dotnet/efcore/pull/34381), contributed by [@ranma42](https://github.com/ranma42)).
+
+The above were only some of the more important query improvements in EF9; see [this issue](https://github.com/dotnet/efcore/issues/34151) for a more complete listing.
+
+## Migrations
+
+<a name="concurrent-migrations"></a>
+
+### Protection against concurrent migrations
+
+EF9 introduces a locking mechanism to protect against multiple migration executions happening simultaneously, as that could leave the database in a corrupted state. This doesn't happen when migrations are deployed to the production environment using [recommended methods](/ef/core/managing-schemas/migrations/applying#sql-scripts), but can happen if migrations are applied at runtime using the [`DbContext.Database.MigrateAsync()`](/dotnet/api/microsoft.entityframeworkcore.relationaldatabasefacadeextensions.migrate) method. We recommend applying migrations at deployment, rather than as part of application startup, but that can result in more complicated application architectures (e.g. [when using .NET Aspire projects](/dotnet/aspire/database/ef-core-migrations)).
+
+> [!NOTE]
+> If you are using Sqlite database, see [potential issues associated with this feature](/ef/core/providers/sqlite/limitations#concurrent-migrations-protection).
+
+<a name="warn-when-no-transaction"></a>
+
+### Warn when multiple migration operations can't be run inside a transaction
+
+The majority of operations performed during migrations are protected by a transaction. This ensures that if for some reason migration fails, the database does not end up in a corrupted state. However, some operations are not wrapped in a transaction (e.g. [operations on SQL Server memory-optimized tables](/sql/relational-databases/in-memory-oltp/unsupported-sql-server-features-for-in-memory-oltp#scenarios-not-supported), or database altering operations like modifying the database collation). To avoid corrupting the database in case of migration failure, it is recommended that these operations are performed in isolation using a separate migration. EF9 now detects a scenario when a migration contains multiple operations, one of which can't be wrapped in a transaction, and issues a warning.
+
+### Improved data seeding
+
+EF9 introduced a convenient way to perform data seeding, that is populating the database with initial data. <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> now contains <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseSeeding*> and <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseAsyncSeeding*> methods which get executed when the DbContext is initialized (as part of <xref:Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade.EnsureCreatedAsync*>).
+
+> [!NOTE]
+> If the application had ran previously, the database may already contain the sample data (which would have been added on the first initialization of the context). As such, <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseSeeding*> <xref:Microsoft.EntityFrameworkCore.DbContextOptionsBuilder.UseAsyncSeeding*> should check if data exists before attempting to populate the database. This can be achieved by issuing a simple EF query.
+
+Here is an example of how these methods can be used:
+
+[!code-csharp[ContextOptionSeeding](../../../../samples/core/Modeling/DataSeeding/DataSeedingContext.cs?name=ContextOptionSeeding)]
+
+More information can be found [here](/ef/core/modeling/data-seeding#use-seeding-method).
+
+### Other migration improvements
+
+* When changing an existing table into a SQL Server temporal table, the migration code size has been significantly reduced.
+
+## Model building
+
+<a name="auto-compiled-models"></a>
+
+### Auto-compiled models
+
+> [!TIP]
+> The code shown here comes from the [NewInEFCore9.CompiledModels](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore9.CompiledModels/) sample.
+
+Compiled models can improve startup time for applications with large models--that is entity type counts in the 100s or 1000s. In previous versions of EF Core, a compiled model had to be generated manually, using the command line. For example:
+
+```dotnetcli
+dotnet ef dbcontext optimize
+```
+
+After running the command, a line like, `.UseModel(MyCompiledModels.BlogsContextModel.Instance)` must be added to `OnConfiguring` to tell EF Core to use the compiled model.
+
+Starting with EF9, this `.UseModel` line is no longer needed when the application's `DbContext` type is in the same project/assembly as the compiled model. Instead, the compiled model will be detected and used automatically. This can be seen by having EF log whenever it is building the model. Running a simple application then shows EF building the model when the application starts:
+
+```output
+Starting application...
+>> EF is building the model...
+Model loaded with 2 entity types.
+```
+
+The output from running `dotnet ef dbcontext optimize` on the model project is:
+
+```output
+PS D:\code\EntityFramework.Docs\samples\core\Miscellaneous\NewInEFCore9.CompiledModels\Model> dotnet ef dbcontext optimize
+
+Build succeeded in 0.3s
+
+Build succeeded in 0.3s
+Build started...
+Build succeeded.
+>> EF is building the model...
+>> EF is building the model...
+Successfully generated a compiled model, it will be discovered automatically, but you can also call 'options.UseModel(BlogsContextModel.Instance)'. Run this command again when the model is modified.
+PS D:\code\EntityFramework.Docs\samples\core\Miscellaneous\NewInEFCore9.CompiledModels\Model> 
+```
+
+Notice that the log output indicates that the _model was built when running the command_. If we now run the application again, after rebuilding but without making any code changes, then the output is:
+
+```output
+Starting application...
+Model loaded with 2 entity types.
+```
+
+Notice that the model was not built when starting the application because the compiled model was detected and used automatically.
+
+### MSBuild integration
+
+With the above approach, the compiled model still needs to be regenerated manually when the entity types or `DbContext` configuration is changed. However, EF9 ships with an MSBuild task package that can automatically update the compiled model when the model project is built! To get started, install the [Microsoft.EntityFrameworkCore.Tasks](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Tasks/) NuGet package. For example:
+
+```dotnetcli
+dotnet add package Microsoft.EntityFrameworkCore.Tasks --version 9.0.0
+```
+
+> [!TIP]
+> Use the package version in the command above that matches the version of EF Core that you are using.
+
+Then enable the integration by setting the `EFOptimizeContext` and `EFScaffoldModelStage` properties in your `.csproj` file. For example:
+
+```xml
+<PropertyGroup>
+    <EFOptimizeContext>true</EFOptimizeContext>
+    <EFScaffoldModelStage>build</EFScaffoldModelStage>
+</PropertyGroup>
+```
+
+Now, if we build the project, we can see logging at build time indicating that the compiled model is being built:
+
+```output
+Optimizing DbContext...
+dotnet exec --depsfile D:\code\EntityFramework.Docs\samples\core\Miscellaneous\NewInEFCore9.CompiledModels\App\bin\Release\net8.0\App.deps.json
+  --additionalprobingpath G:\packages 
+  --additionalprobingpath "C:\Program Files (x86)\Microsoft Visual Studio\Shared\NuGetPackages" 
+  --runtimeconfig D:\code\EntityFramework.Docs\samples\core\Miscellaneous\NewInEFCore9.CompiledModels\App\bin\Release\net8.0\App.runtimeconfig.json G:\packages\microsoft.entityframeworkcore.tasks\9.0.0-preview.4.24205.3\tasks\net8.0\..\..\tools\netcoreapp2.0\ef.dll dbcontext optimize --output-dir D:\code\EntityFramework.Docs\samples\core\Miscellaneous\NewInEFCore9.CompiledModels\Model\obj\Release\net8.0\ 
+  --namespace NewInEfCore9 
+  --suffix .g 
+  --assembly D:\code\EntityFramework.Docs\samples\core\Miscellaneous\NewInEFCore9.CompiledModels\Model\bin\Release\net8.0\Model.dll
+  --project-dir D:\code\EntityFramework.Docs\samples\core\Miscellaneous\NewInEFCore9.CompiledModels\Model 
+  --root-namespace NewInEfCore9 
+  --language C# 
+  --nullable 
+  --working-dir D:\code\EntityFramework.Docs\samples\core\Miscellaneous\NewInEFCore9.CompiledModels\App 
+  --verbose 
+  --no-color 
+  --prefix-output 
+```
+
+And running the application shows that the compiled model has been detected and hence the model is not built again:
+
+```output
+Starting application...
+Model loaded with 2 entity types.
+```
+
+Now, whenever the model changes, the compiled model will be automatically rebuilt as soon as the project is built.
+
+For more information see [MSBuild integration](xref:core/cli/msbuild).
+
+<a name="read-only-primitives"></a>
+
+### Read-only primitive collections
+
+> [!TIP]
+> The code shown here comes from [PrimitiveCollectionsSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore9/PrimitiveCollectionsSample.cs).
+
+EF8 introduced support for [mapping arrays and mutable lists of primitive types](xref:core/what-is-new/ef-core-8.0/whatsnew#primitive-collections). This has been expanded in EF9 to include read-only collections/lists. Specifically, EF9 supports collections typed as `IReadOnlyList`, `IReadOnlyCollection`, or `ReadOnlyCollection`. For example, in the following code, `DaysVisited` will be mapped by convention as a primitive collection of dates:
+
+```csharp
+public class DogWalk
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+    public ReadOnlyCollection<DateOnly> DaysVisited { get; set; }
+}
+```
+
+The read-only collection can be backed by a normal, mutable collection if desired. For example, in the following code, `DaysVisited` can be mapped as a primitive collection of dates, while still allowing code in the class to manipulate the underlying list.
+
+```csharp
+    public class Pub
+    {
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public IReadOnlyCollection<string> Beers { get; set; }
+
+        private List<DateOnly> _daysVisited = new();
+        public IReadOnlyList<DateOnly> DaysVisited => _daysVisited;
+    }
+```
+
+These collections can then be used in queries in the normal way. For example, this LINQ query:
+
+<!--
+        var walksWithADrink = await context.Walks.Select(
+            w => new
+            {
+                WalkName = w.Name,
+                PubName = w.ClosestPub.Name,
+                Count = w.DaysVisited.Count(v => w.ClosestPub.DaysVisited.Contains(v)),
+                TotalCount = w.DaysVisited.Count
+            }).ToListAsync();
+-->
+[!code-csharp[WalksWithADrink](../../../../samples/core/Miscellaneous/NewInEFCore9/PrimitiveCollectionsSample.cs?name=WalksWithADrink)]
+
+Which translates to the following SQL on SQLite:
+
+```sql
+SELECT "w"."Name" AS "WalkName", "p"."Name" AS "PubName", (
+    SELECT COUNT(*)
+    FROM json_each("w"."DaysVisited") AS "d"
+    WHERE "d"."value" IN (
+        SELECT "d0"."value"
+        FROM json_each("p"."DaysVisited") AS "d0"
+    )) AS "Count", json_array_length("w"."DaysVisited") AS "TotalCount"
+FROM "Walks" AS "w"
+INNER JOIN "Pubs" AS "p" ON "w"."ClosestPubId" = "p"."Id"
+```
+
+<a name="sequence-caching"></a>
+
+### Specify fill-factor for keys and indexes
+
+> [!TIP]
+> The code shown here comes from [ModelBuildingSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore9/ModelBuildingSample.cs).
+
+EF9 supports specification of the [SQL Server fill-factor](/sql/relational-databases/indexes/specify-fill-factor-for-an-index) when using EF Core Migrations to create keys and indexes. From the SQL Server docs, "When an index is created or rebuilt, the fill-factor value determines the percentage of space on each leaf-level page to be filled with data, reserving the remainder on each page as free space for future growth."
+
+The fill-factor can be set on a single or composite primary and alternate keys and indexes using <xref:Microsoft.EntityFrameworkCore.SqlServerIndexBuilderExtensions.HasFillFactor*>. For example:
+
+<!--
+            #region FillFactor
+            modelBuilder.Entity<User>()
+                .HasKey(e => e.Id)
+                .HasFillFactor(80);
+
+            modelBuilder.Entity<User>()
+                .HasAlternateKey(e => new { e.Region, e.Ssn })
+                .HasFillFactor(80);
+
+            modelBuilder.Entity<User>()
+                .HasIndex(e => new { e.Name })
+                .HasFillFactor(80);
+
+            modelBuilder.Entity<User>()
+                .HasIndex(e => new { e.Region, e.Tag })
+                .HasFillFactor(80);
+-->
+[!code-csharp[FillFactor](../../../../samples/core/Miscellaneous/NewInEFCore9/ModelBuildingSample.cs?name=FillFactor)]
+
+When applied to existing tables, this will alter the tables to the fill-factor to the constraint:
+
+```sql
+ALTER TABLE [User] DROP CONSTRAINT [AK_User_Region_Ssn];
+ALTER TABLE [User] DROP CONSTRAINT [PK_User];
+DROP INDEX [IX_User_Name] ON [User];
+DROP INDEX [IX_User_Region_Tag] ON [User];
+
+ALTER TABLE [User] ADD CONSTRAINT [AK_User_Region_Ssn] UNIQUE ([Region], [Ssn]) WITH (FILLFACTOR = 80);
+ALTER TABLE [User] ADD CONSTRAINT [PK_User] PRIMARY KEY ([Id]) WITH (FILLFACTOR = 80);
+CREATE INDEX [IX_User_Name] ON [User] ([Name]) WITH (FILLFACTOR = 80);
+CREATE INDEX [IX_User_Region_Tag] ON [User] ([Region], [Tag]) WITH (FILLFACTOR = 80);
+```
+
+This enhancement was contributed by [@deano-hunter](https://github.com/deano-hunter). Many thanks!
+
+<a name="conventions"></a>
+
+### Make existing model building conventions more extensible
+
+> [!TIP]
+> The code shown here comes from [CustomConventionsSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore9/CustomConventionsSample.cs).
+
+Public model building conventions for applications were [introduced in EF7](xref:core/modeling/bulk-configuration#Conventions). In EF9, we have made it easier to extend some of the existing conventions. For example, [the code to map properties by attribute in EF7](xref:core/what-is-new/ef-core-7.0/whatsnew#model-building-conventions) is this:
+
+```csharp
+public class AttributeBasedPropertyDiscoveryConvention : PropertyDiscoveryConvention
+{
+    public AttributeBasedPropertyDiscoveryConvention(ProviderConventionSetBuilderDependencies dependencies)
+        : base(dependencies)
+    {
+    }
+
+    public override void ProcessEntityTypeAdded(
+        IConventionEntityTypeBuilder entityTypeBuilder,
+        IConventionContext<IConventionEntityTypeBuilder> context)
+        => Process(entityTypeBuilder);
+
+    public override void ProcessEntityTypeBaseTypeChanged(
+        IConventionEntityTypeBuilder entityTypeBuilder,
+        IConventionEntityType? newBaseType,
+        IConventionEntityType? oldBaseType,
+        IConventionContext<IConventionEntityType> context)
+    {
+        if ((newBaseType == null
+             || oldBaseType != null)
+            && entityTypeBuilder.Metadata.BaseType == newBaseType)
+        {
+            Process(entityTypeBuilder);
+        }
+    }
+
+    private void Process(IConventionEntityTypeBuilder entityTypeBuilder)
+    {
+        foreach (var memberInfo in GetRuntimeMembers())
+        {
+            if (Attribute.IsDefined(memberInfo, typeof(PersistAttribute), inherit: true))
+            {
+                entityTypeBuilder.Property(memberInfo);
+            }
+            else if (memberInfo is PropertyInfo propertyInfo
+                     && Dependencies.TypeMappingSource.FindMapping(propertyInfo) != null)
+            {
+                entityTypeBuilder.Ignore(propertyInfo.Name);
+            }
+        }
+
+        IEnumerable<MemberInfo> GetRuntimeMembers()
+        {
+            var clrType = entityTypeBuilder.Metadata.ClrType;
+
+            foreach (var property in clrType.GetRuntimeProperties()
+                         .Where(p => p.GetMethod != null && !p.GetMethod.IsStatic))
+            {
+                yield return property;
+            }
+
+            foreach (var property in clrType.GetRuntimeFields())
+            {
+                yield return property;
+            }
+        }
+    }
+}
+```
+
+In EF9, this can be simplified down to the following:
+
+<!--
+    #region AttributeBasedPropertyDiscoveryConvention
+    public class AttributeBasedPropertyDiscoveryConvention(ProviderConventionSetBuilderDependencies dependencies)
+        : PropertyDiscoveryConvention(dependencies)
+    {
+        protected override bool IsCandidatePrimitiveProperty(
+            MemberInfo memberInfo, IConventionTypeBase structuralType, out CoreTypeMapping? mapping)
+        {
+            if (base.IsCandidatePrimitiveProperty(memberInfo, structuralType, out mapping))
+            {
+                if (Attribute.IsDefined(memberInfo, typeof(PersistAttribute), inherit: true))
+                {
+                    return true;
+                }
+
+                structuralType.Builder.Ignore(memberInfo.Name);
+            }
+
+            mapping = null;
+            return false;
+        }
+    }
+-->
+[!code-csharp[AttributeBasedPropertyDiscoveryConvention](../../../../samples/core/Miscellaneous/NewInEFCore9/CustomConventionsSample.cs?name=AttributeBasedPropertyDiscoveryConvention)]
+
+<a name="non-pub-apply"></a>
+
+### Update ApplyConfigurationsFromAssembly to call non-public constructors
+
+In previous versions of EF Core, the <xref:Microsoft.EntityFrameworkCore.ModelBuilder.ApplyConfigurationsFromAssembly*> method only instantiated configuration types with a public, parameterless constructors. In EF9, we have both [improved the error messages generated when this fails](https://github.com/dotnet/efcore/pull/32577), and also enabled instantiation by non-public constructor. This is useful when co-locating configuration in a private nested class which should never be instantiated by application code. For example:
+
+```csharp
+public class Country
+{
+    public int Code { get; set; }
+    public required string Name { get; set; }
+
+    private class FooConfiguration : IEntityTypeConfiguration<Country>
+    {
+        private FooConfiguration()
+        {
+        }
+
+        public void Configure(EntityTypeBuilder<Country> builder)
+        {
+            builder.HasKey(e => e.Code);
+        }
+    }
+}
+```
+
+As an aside, some people think this pattern is an abomination because it couples the entity type to the configuration. Other people think it is very useful because it co-locates configuration with the entity type. Let's not debate this here. :-)
+
+## SQL Server HierarchyId
+
+> [!TIP]
+> The code shown here comes from [HierarchyIdSample.cs](https://github.com/dotnet/EntityFramework.Docs/tree/main/samples/core/Miscellaneous/NewInEFCore9/HierarchyIdSample.cs).
+
+<a name="hierarchyid-path-generation"></a>
+
+### Sugar for HierarchyId path generation
+
+First class support for the SQL Server `HierarchyId` type was [added in EF8](xref:core/what-is-new/ef-core-8.0/whatsnew#hierarchyid). In EF9, a sugar method has been added to make it easier to create new child nodes in the tree structure. For example, the following code queries for an existing entity with a `HierarchyId` property:
+
+<!--
+        #region HierarchyIdQuery
+        var daisy = await context.Halflings.SingleAsync(e => e.Name == "Daisy");
+-->
+[!code-csharp[HierarchyIdQuery](../../../../samples/core/Miscellaneous/NewInEFCore9/HierarchyIdSample.cs?name=HierarchyIdQuery)]
+
+This `HierarchyId` property can then be used to create child nodes without any explicit string manipulation. For example:
+
+<!--
+        #region HierarchyIdParse1
+        var child1 = new Halfling(HierarchyId.Parse(daisy.PathFromPatriarch, 1), "Toast");
+        var child2 = new Halfling(HierarchyId.Parse(daisy.PathFromPatriarch, 2), "Wills");
+-->
+[!code-csharp[HierarchyIdParse1](../../../../samples/core/Miscellaneous/NewInEFCore9/HierarchyIdSample.cs?name=HierarchyIdParse1)]
+
+If `daisy` has a `HierarchyId` of `/4/1/3/1/`, then, `child1` will get the `HierarchyId` "/4/1/3/1/1/", and `child2` will get the `HierarchyId` "/4/1/3/1/2/".
+
+To create a node between these two children, an additional sub-level can be used. For example:
+
+<!--
+        #region HierarchyIdParse2
+        var child1b = new Halfling(HierarchyId.Parse(daisy.PathFromPatriarch, 1, 5), "Toast");
+-->
+[!code-csharp[HierarchyIdParse2](../../../../samples/core/Miscellaneous/NewInEFCore9/HierarchyIdSample.cs?name=HierarchyIdParse2)]
+
+This creates a node with a `HierarchyId` of `/4/1/3/1/1.5/`, putting it between `child1` and `child2`.
+
+This enhancement was contributed by [@Rezakazemi890](https://github.com/Rezakazemi890). Many thanks!
+
+## Tooling
+
+<a name="fewer-rebuilds"></a>
+
+### Fewer rebuilds
+
+The [`dotnet ef` command line tool](xref:core/cli/dotnet) by default builds your project before executing the tool. This is because not rebuilding before running the tool is a common source of confusion when things don't work. Experienced developers can use the `--no-build` option to avoid this build, which may be slow. However, even the `--no-build` option could cause the project to be re-built the next time it is built outside of the EF tooling.
+
+We believe a [community contribution](https://github.com/dotnet/efcore/pull/32860) from [@Suchiman](https://github.com/Suchiman) has fixed this. However, we're also conscious that tweaks around MSBuild behaviors have a tendency to have unintended consequences, so we're asking people like you to try this out and report back on any negative experiences you have.
diff --git a/entity-framework/core/what-is-new/index.md b/entity-framework/core/what-is-new/index.md
new file mode 100644
index 0000000000..16509f0513
--- /dev/null
+++ b/entity-framework/core/what-is-new/index.md
@@ -0,0 +1,51 @@
+---
+title: EF Core releases and planning
+description: Current EF Core releases and schedule/planning details for future releases
+author: SamMonoRT
+ms.date: 11/20/2025
+uid: core/what-is-new/index
+---
+
+# EF Core releases and planning
+
+## Stable releases
+
+| Release                                                                                | Target framework  | Supported until           | Links                                                                                                                                                                                  |
+|----------------------------------------------------------------------------------------|-------------------|---------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| [EF Core 10.0](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore)           | .NET 10           | November 10, 2028         | [What's new](xref:core/what-is-new/ef-core-10.0/whatsnew) / [Breaking changes](xref:core/what-is-new/ef-core-10.0/breaking-changes)                                                      |
+| [EF Core 9.0](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore)            | .NET 8            | November 10, 2026         | [What's new](xref:core/what-is-new/ef-core-9.0/whatsnew) / [Breaking changes](xref:core/what-is-new/ef-core-9.0/breaking-changes)                                                      |
+| [EF Core 8.0](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore)            | .NET 8            | November 10, 2026         | [What's new](xref:core/what-is-new/ef-core-8.0/whatsnew) / [Breaking changes](xref:core/what-is-new/ef-core-8.0/breaking-changes)                                                      |
+| ~~[EF Core 7.0](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore/7.0.0)~~  | .NET 6            | Expired May 14, 2024      | [What's new](xref:core/what-is-new/ef-core-7.0/whatsnew) / [Breaking changes](xref:core/what-is-new/ef-core-7.0/breaking-changes)                                                      |
+| ~~[EF Core 6.0](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore/6.0.0)~~  | .NET 6            | Expired November 12, 2024 | [What's new](xref:core/what-is-new/ef-core-6.0/whatsnew) / [Breaking changes](xref:core/what-is-new/ef-core-6.0/breaking-changes)                                                      |
+| ~~[EF Core 5.0](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore/5.0.17)~~ | .NET Standard 2.1 | Expired May 10, 2022      | [Announcement](https://devblogs.microsoft.com/dotnet/announcing-the-release-of-ef-core-5-0/) / [Breaking changes](xref:core/what-is-new/ef-core-5.0/breaking-changes)                  |
+| ~~[EF Core 3.1](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore/3.1.31)~~ | .NET Standard 2.0 | Expired December 13, 2022 | [Announcement](https://devblogs.microsoft.com/dotnet/announcing-entity-framework-core-3-1-and-entity-framework-6-4/)                                                                   |
+| ~~[EF Core 3.0](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore/3.0.3)~~  | .NET Standard 2.1 | Expired March 3, 2020     | [Announcement](https://devblogs.microsoft.com/dotnet/announcing-ef-core-3-0-and-ef-6-3-general-availability/) / [Breaking changes](xref:core/what-is-new/ef-core-3.x/breaking-changes) |
+| ~~[EF Core 2.2](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore/2.2.6)~~  | .NET Standard 2.0 | Expired December 23, 2019 | [Announcement](https://devblogs.microsoft.com/dotnet/announcing-entity-framework-core-2-2/)                                                                                            |
+| ~~[EF Core 2.1](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore/2.1.14)~~ | .NET Standard 2.0 | Expired August 21, 2021*  | [Announcement](https://devblogs.microsoft.com/dotnet/announcing-entity-framework-core-2-1/)                                                                                            |
+| ~~[EF Core 2.0](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore/2.0.3)~~  | .NET Standard 2.0 | Expired October 1, 2018   | [Announcement](https://devblogs.microsoft.com/dotnet/announcing-entity-framework-core-2-0/)                                                                                            |
+| ~~[EF Core 1.1](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore/1.1.6)~~  | .NET Standard 1.3 | Expired June 27 2019      | [Announcement](https://devblogs.microsoft.com/dotnet/announcing-entity-framework-core-1-1/)                                                                                            |
+| ~~[EF Core 1.0](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore/1.0.6)~~  | .NET Standard 1.3 | Expired June 27 2019      | [Announcement](https://devblogs.microsoft.com/dotnet/entity-framework-core-1-0-0-available/)                                                                                           |
+
+See [supported platforms](xref:core/miscellaneous/platforms) for information about the specific platforms supported by each EF Core release.
+
+Entity Framework Core releases and support are aligned with .NET releases and support. See the [.NET support policy](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) for information on support expiration and long-term support (LTS) releases.
+
+\* EF Core 2.1 will continue to be supported when used with ASP.NET Core 2.1 on .NET Framework only. See [ASP.NET Support Policy](https://dotnet.microsoft.com/platform/support/policy/aspnet) for details.
+
+## Guidance on updating to new releases
+
+* Supported releases are patched for security and other critical bugs. Always use the latest patch of a given release. For example, for EF Core 10.0, use 10.0.x for the highest 'x' available.
+* Major version updates (for example, from EF Core 9 to EF Core 10) often have breaking changes. Thorough testing is advised when updating across major versions. Use the breaking changes links above for guidance on dealing with breaking changes.
+* Minor version updates do not typically contain breaking changes. However, thorough testing is still advised since new features can introduce regressions.
+
+## Release planning and schedules
+
+EF Core releases align with the [.NET shipping schedule](https://github.com/dotnet/core/blob/main/roadmap.md).
+
+Patch releases usually ship monthly, but have a long lead time.
+
+See the [release planning process](xref:core/what-is-new/release-planning) for more information on how we decide what to ship in each release. We typically don't do detailed planning for further out than the next major or minor release.
+
+## EF Core 11.0
+
+The next planned stable release is **EF Core 11.0**, or just **EF11**, scheduled for **November 2026**.
diff --git a/entity-framework/core/what-is-new/nuget-packages.md b/entity-framework/core/what-is-new/nuget-packages.md
new file mode 100644
index 0000000000..a97dd66ce3
--- /dev/null
+++ b/entity-framework/core/what-is-new/nuget-packages.md
@@ -0,0 +1,107 @@
+---
+title: EF Core NuGet Packages
+description: Overview of the different Entity Framework Core NuGet packages
+author: SamMonoRT
+ms.date: 10/21/2024
+uid: core/what-is-new/nuget-packages
+---
+
+# EF Core NuGet Packages
+
+Entity Framework Core (EF Core) is shipped as [NuGet](https://www.nuget.org/profiles/EntityFramework) packages. The packages needed by an application depends on:
+
+- The type of database system being used (SQL Server, SQLite, etc.)
+- The EF Core features needed
+
+The usual process for installing packages is:
+
+- Decide on a database provider and install the appropriate package ([see below](#database-providers))
+- Also install [Microsoft.EntityFrameworkCore](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore/), and [Microsoft.EntityFrameworkCore.Relational](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Relational/) if using a relational database provider. This helps ensure that consistent versions are being used, and also means that NuGet will let you know when new package versions are shipped.
+- Optionally, decide which kind of tooling you need and install the appropriate packages for that ([see below](#tools))
+
+See [Getting started tutorial for Entity Framework Core](xref:core/get-started/overview/first-app) for help getting started with EF Core.
+
+## Package versions
+
+Make sure to install the same version of all EF Core packages shipped by Microsoft. For example, if version 5.0.3 of Microsoft.EntityFrameworkCore.SqlServer is installed, then all other Microsoft.EntityFrameworkCore.* packages must also be at 5.0.3.
+
+Also make sure that any external packages are compatible with the version of EF Core being used. In particular, check that external database provider supports the version of EF Core you are using. New major versions of EF Core usually require an updated database provider.
+
+> [!WARNING]
+> NuGet does not enforce consistent package versions. Always carefully check which package versions you are referencing in your `.csproj` file or equivalent.
+
+## Database providers
+
+EF Core supports different database systems through the use of "database providers". Each system has its own database provider, which is shipped as NuGet package. Applications should install one or more of these provider packages.
+
+Common database providers are listed in the table below. See [database providers](xref:core/providers/index) for a more comprehensive list of available providers.
+
+| Database system                   | Package
+|:----------------------------------|----------------------
+| SQL Server and SQL Azure          | [Microsoft.EntityFrameworkCore.SqlServer](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.SqlServer)
+| SQLite                            | [Microsoft.EntityFrameworkCore.Sqlite](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Sqlite)
+| Azure Cosmos DB                   | [Microsoft.EntityFrameworkCore.Cosmos](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Cosmos)
+| PostgreSQL                        | [Npgsql.EntityFrameworkCore.PostgreSQL](https://www.nuget.org/packages/Npgsql.EntityFrameworkCore.PostgreSQL/)*
+| MySQL                             | [Pomelo.EntityFrameworkCore.MySql](https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql/)*
+| EF Core in-memory database**      | [Microsoft.EntityFrameworkCore.InMemory](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.InMemory)
+
+*These are popular, high quality, open-source providers developed and shipped by the community. The other providers listed are shipped by Microsoft.
+
+**Carefully consider whether to use the in-memory provider. It is not designed for production use, and also may not be [the best solution for testing](xref:core/testing/index).
+
+## Tools
+
+Use of tooling for [EF Core migrations](xref:core/managing-schemas/migrations/index) and [reverse engineering (scaffolding) from an existing database](xref:core/managing-schemas/scaffolding) requires installation of the appropriate tooling package:
+
+- [dotnet-ef](https://www.nuget.org/packages/dotnet-ef/) for cross-platform command line tooling
+- [Microsoft.EntityFrameworkCore.Tasks](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Tasks/) for MSBuild tasks allowing build-time integration.
+- [Microsoft.EntityFrameworkCore.Tools](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Tools/) for PowerShell tooling that works in the Visual Studio [Package Manager Console](/nuget/consume-packages/install-use-packages-powershell)
+
+See [Entity Framework Core Tools Reference](xref:core/cli/index) for more information on using EF Core tooling, including how to correctly install the `dotnet-ef` tool in a project or globally.
+
+> [!TIP]
+> By default, the Microsoft.EntityFrameworkCore.Design package is installed in such a way that it will not be deployed with your application. This also means that its types cannot be transitively used in other projects. Use a normal `PackageReference` in your `.csproj` file or equivalent if you need access to the types in this package. See [Design-time services](xref:core/cli/services) for more information.
+
+## Extension packages
+
+There are many [extensions for EF Core](xref:core/extensions/index) published both by Microsoft and third parties as NuGet packages. Commonly used packages include:
+
+| Functionality                                | Package | Additional dependencies
+|:---------------------------------------------|---------|------------------------
+| Proxies for lazy-loading and change tracking | [Microsoft.EntityFrameworkCore.Proxies](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Proxies/) | [Castle.Core](https://www.nuget.org/packages/Castle.Core/)
+| Spatial support for SQL Server               | [Microsoft.EntityFrameworkCore.SqlServer.NetTopologySuite](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.SqlServer.NetTopologySuite/) | [NetTopologySuite](https://www.nuget.org/packages/NetTopologySuite/) and [NetTopologySuite.IO.SqlServerBytes](https://www.nuget.org/packages/NetTopologySuite.IO.SqlServerBytes/)
+| Spatial support for SQLite                   | [Microsoft.EntityFrameworkCore.Sqlite.NetTopologySuite](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Sqlite.NetTopologySuite/) | [NetTopologySuite](https://www.nuget.org/packages/NetTopologySuite/) and [NetTopologySuite.IO.SpatiaLite](https://www.nuget.org/packages/NetTopologySuite.IO.SpatiaLite/)
+| Spatial support for PostgreSQL               | [Npgsql.EntityFrameworkCore.PostgreSQL.NetTopologySuite](https://www.nuget.org/packages/Npgsql.EntityFrameworkCore.PostgreSQL.NetTopologySuite) | [NetTopologySuite](https://www.nuget.org/packages/NetTopologySuite/) and [NetTopologySuite.IO.PostGIS](https://www.nuget.org/packages/NetTopologySuite.IO.PostGIS/) (via [Npgsql.NetTopologySuite](https://www.nuget.org/packages/Npgsql.NetTopologySuite/))
+| Spatial support for MySQL                    | [Pomelo.EntityFrameworkCore.MySql.NetTopologySuite](https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql.NetTopologySuite) | [NetTopologySuite](https://www.nuget.org/packages/NetTopologySuite/)
+
+## Other packages
+
+Other EF Core packages are pulled in as dependencies of the database provider package. However, you may want to add explicit package references for these packages so that NuGet will provide notifications when new versions are released.
+
+| Functionality                                              | Package
+|:-----------------------------------------------------------|--------
+| EF Core basic functionality                                | [Microsoft.EntityFrameworkCore](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore/)
+| Common relational database functionality                   | [Microsoft.EntityFrameworkCore.Relational](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Relational/)
+| Lightweight package for EF Core attributes, etc.           | [Microsoft.EntityFrameworkCore.Abstractions](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Abstractions/)
+| Roslyn code analyzers for EF Core usage                    | [Microsoft.EntityFrameworkCore.Analyzers](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Analyzers/)
+| EF Core SQLite provider without a native SQLite dependency | [Microsoft.EntityFrameworkCore.Sqlite.Core](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Sqlite.Core/)
+| Design-time functionality implementation shared by EF tools| [Microsoft.EntityFrameworkCore.Design](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Design/)
+
+## Packages for database provider testing
+
+The following packages are used to test database providers built in external GitHub repositories. See [efcore.pg](https://github.com/npgsql/efcore.pg) and [Pomelo.EntityFrameworkCore.MySql](https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql) for examples. Applications should not install these packages.
+
+| Functionality                                              | Package
+|:-----------------------------------------------------------|--------
+| Tests for any database provider                            | [Microsoft.EntityFrameworkCore.Specification.Tests](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Specification.Tests/)
+| Tests for relational database providers                    | [Microsoft.EntityFrameworkCore.Relational.Specification.Tests](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Relational.Specification.Tests/)
+
+## Obsolete packages
+
+Do **not** install the following obsolete packages, and remove them if they are currently installed in your projects:
+
+- Microsoft.EntityFrameworkCore.Relational.Design
+- Microsoft.EntityFrameworkCore.Tools.DotNet
+- Microsoft.EntityFrameworkCore.SqlServer.Design
+- Microsoft.EntityFrameworkCore.Sqlite.Design
+- Microsoft.EntityFrameworkCore.Relational.Design.Specification.Tests
diff --git a/entity-framework/core/what-is-new/release-planning.md b/entity-framework/core/what-is-new/release-planning.md
new file mode 100644
index 0000000000..8934b9ed83
--- /dev/null
+++ b/entity-framework/core/what-is-new/release-planning.md
@@ -0,0 +1,115 @@
+---
+title: EF Core release planning
+description: Information on how Entity Framework Core planning and releasing is done
+author: SamMonoRT
+ms.date: 01/28/2020
+uid: core/what-is-new/release-planning
+---
+
+# Release planning process
+
+We often get questions about how we choose specific features to go into a particular release.
+This document outlines the process we use.
+The process is continually evolving as we find better ways to plan, but the general ideas remain the same.
+
+## Different kinds of releases
+
+Different kinds of release contain different kinds of changes.
+This in turn means that the release planning is different for different kinds of release.
+
+### Patch releases
+
+Patch releases change only the "patch" part of the version.
+For example, EF Core 3.1.**1** is a release that patches issues found in EF Core 3.1.**0**.
+
+Patch releases are intended to fix critical customer bugs.
+This means patch releases do not include new features.
+API changes are not allowed in patch releases except in special circumstances.
+
+The bar to make a change in a patch release is very high.
+This is because it is critical that patch releases do not introduce new bugs.
+Therefore, the decision process emphasizes high value and low risk.
+
+We are more likely to patch an issue if:
+
+* It is impacting multiple customers
+* It is a regression from a previous release
+* The failure causes data corruption
+
+We are less likely to patch an issue if:
+
+* There are reasonable workarounds
+* The fix has high risk of breaking something else
+* The bug is in a corner-case
+
+This bar gradually rises through the lifetime of a [long-term support (LTS)](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) release. This is because LTS releases emphasize stability.
+
+The final decision about whether or not to patch an issue is made by the .NET Directors at Microsoft.
+
+### Major releases
+
+Major releases change the EF "major" version number.
+For example, EF Core **3**.0.0 is a major release that makes a big step forward over EF Core 2.2.x.
+
+Major releases:
+
+* Are intended to improve the quality and features of the previous release
+* Typically contain bug fixes and new features
+  * Some of the new features may be fundamental changes to the way EF Core works
+* Typically include intentional breaking changes
+  * Breaking changes are necessary part of evolving EF Core as we learn
+  * However, we think very carefully about making any breaking change because of the potential customer impact. We may have been too aggressive with breaking changes in the past. Going forward, we will strive to minimize changes that break applications, and to reduce changes that break database providers and extensions.
+* Have many prerelease previews pushed to NuGet
+
+## Planning for major/minor releases
+
+### GitHub issue tracking
+
+GitHub ([https://github.com/dotnet/efcore](https://github.com/dotnet/efcore)) is the source-of-truth for all EF Core planning.
+
+Issues on GitHub have:
+
+* A state
+  * [Open](https://github.com/dotnet/efcore/issues) issues have not been addressed.
+  * [Closed](https://github.com/dotnet/efcore/issues?q=is%3Aissue+is%3Aclosed) issues have been addressed.
+    * All issues that have been fixed are [tagged with closed-fixed](https://github.com/dotnet/efcore/issues?q=is%3Aissue+label%3Aclosed-fixed+is%3Aclosed). An issue tagged with closed-fixed is fixed and merged, but may not have been released.
+    * Other `closed-` labels indicate other reasons for closing an issue. For example, duplicates are tagged with closed-duplicate.
+* A type
+  * [Bugs](https://github.com/dotnet/efcore/issues?q=is%3Aissue+is%3Aopen+label%3Atype-bug) represent bugs.
+  * [Enhancements](https://github.com/dotnet/efcore/issues?q=is%3Aissue+is%3Aopen+label%3Atype-enhancement) represent new features or better functionality in existing features.
+* A milestone
+  * [Issues with no milestone](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+no%3Amilestone) are being considered by the team. The decision on what to do with the issue has not yet been made or a change in the decision is being considered.
+  * [Issues in the Backlog milestone](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+milestone%3ABacklog) are items that the EF team will consider working on in a future release
+    * Issues in the backlog may be [tagged with consider-for-next-release](https://github.com/dotnet/efcore/issues?q=is%3Aissue+is%3Aopen+label%3Aconsider-for-next-release) indicating that this work item is high on the list for the next release.
+  * Open issues in a versioned milestone are items that the team plans to work on in that version. For example, [these are the issues we plan to work on for EF Core 5.0](https://github.com/dotnet/efcore/issues?q=is%3Aopen+is%3Aissue+milestone%3A5.0.0).
+  * Closed issues in a versioned milestone are issues that are completed for that version. Note that the version may not yet have been released. For example, [these are the issues completed for EF Core 3.0](https://github.com/dotnet/efcore/issues?q=is%3Aissue+milestone%3A3.0.0+is%3Aclosed).
+* Votes!
+  * Voting is the best way to indicate that an issue is important to you.
+  * To vote, just add a "thumbs-up" 👍 to the issue. For example, [these are the top-voted issues](https://github.com/dotnet/efcore/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc)
+  * Please also comment describing specific reasons you need the feature if you feel this adds value. Commenting "+1" or similar does not add value.
+
+### The planning process
+
+The planning process is more involved than just taking the top-most requested features from the backlog.
+This is because we gather feedback from multiple stakeholders in multiple ways.
+We then shape a release based on:
+
+* Input from customers
+* Input from other stakeholders
+* Strategic direction
+* Resources available
+* Schedule
+
+Some of the questions we ask are:
+
+1. **How many developers we think will use the feature and how much better will it make their applications or experience?** To answer this question, we collect feedback from many sources — Comments and votes on issues is one of those sources. Specific engagements with important customers is another.
+
+2. **What are the workarounds people can use if we don't implement this feature yet?** For example, many developers can map a join table to work around lack of native many-to-many support. Obviously, not all developers want to do it, but many can, and that counts as a factor in our decision.
+
+3. **Does implementing this feature evolve the architecture of EF Core such that it moves us closer to implementing other features?** We tend to favor features that act as building blocks for other features. For instance, property bag entities can help us move towards many-to-many support, and entity constructors enabled our lazy loading support.
+
+4. **Is the feature an extensibility point?** We tend to favor extensibility points over normal features because they enable developers to hook their own behaviors and compensate for any missing functionality.
+
+5. **What is the synergy of the feature when used in combination with other products?** We favor features that enable or significantly improve the experience of using EF Core with other products, such as .NET Core, the latest version of Visual Studio, Microsoft Azure, and so on.
+
+6. **What are the skills of the people available to work on a feature, and how can we best leverage these resources?** Each member of the EF team and our community contributors has different levels of experience in different areas, so we have to plan accordingly. Even if we wanted to have "all hands on deck" to work on a specific feature like GroupBy translations, or many-to-many, that wouldn't be practical.
diff --git a/entity-framework/docfx.json b/entity-framework/docfx.json
new file mode 100644
index 0000000000..2fe671b0a1
--- /dev/null
+++ b/entity-framework/docfx.json
@@ -0,0 +1,109 @@
+{
+  "metadata": [
+    {
+      "src": [
+        {
+          "files": [
+            "src/**.csproj"
+          ],
+          "exclude": [
+            "**/bin/**",
+            "**/obj/**",
+            "_site/**"
+          ]
+        }
+      ],
+      "dest": "api"
+    }
+  ],
+  "build": {
+    "content": [
+      {
+        "files": [
+          "api/**.yml",
+          "api/index.md"
+        ]
+      },
+      {
+        "files": [
+          "**.md",
+          "**/*.yml",
+          "*.md"
+        ],
+        "exclude": [
+          "**/bin/**",
+          "**/obj/**",
+          "**/includes/**",
+          "_site/**"
+        ]
+      }
+    ],
+    "resource": [
+      {
+        "files": [
+          "**.png",
+          "**.jpg"
+        ],
+        "exclude": [
+          "**/bin/**",
+          "**/obj/**",
+          "_site/**"
+        ]
+      }
+    ],
+    "overwrite": [
+      {
+        "files": [
+          "apidoc/**.md"
+        ],
+        "exclude": [
+          "**/bin/**",
+          "**/obj/**",
+          "_site/**"
+        ]
+      }
+    ],
+    "globalMetadata": {
+      "ms.service": "entity-framework",
+      "breadcrumb_path": "/ef/breadcrumb/toc.json",
+      "searchScope": [
+        "Entity Framework"
+      ],
+      "ms.topic": "concept-article",
+      "audience": "developer",
+      "ms.tgt_pltfrm": "dotnet",
+      "ms.devlang": "dotnet",
+      "ms.author": "sampatel",
+      "feedback_system": "OpenSource",
+      "feedback_github_repo": "dotnet/EntityFramework.Docs",
+      "feedback_product_url": "https://github.com/dotnet/efcore/issues/new/choose",
+      "open_source_feedback_contributorGuideUrl": "https://learn.microsoft.com/contribute/content/dotnet/dotnet-contribute",
+      "open_source_feedback_issueTitle": "",
+      "open_source_feedback_productLogoLightUrl": "https://learn.microsoft.com/media/logos/logo_net.svg",
+      "open_source_feedback_productLogoDarkUrl": "https://learn.microsoft.com/media/logos/logo_net.svg",
+      "open_source_feedback_issueUrl": "https://github.com/dotnet/EntityFramework.Docs/issues/new?template=z-customer-feedback.yml",
+      "open_source_feedback_productName": ".NET",
+      "uhfHeaderId": "MSDocsHeader-DotNet"
+    },
+    "fileMetadata": {
+      "ms.subservice": {
+        "ef6/**/**.md": "entity-framework-6",
+        "core/**/**.md": "entity-framework-core",
+        "efcore-and-ef6/**/**.md": "entity-framework-core"
+      },
+      "feedback_product_url": {
+        "ef6/**/**.md": "https://github.com/dotnet/ef6/issues/new"
+      },
+      "ms.technology": {
+      },
+      "ms.update-cycle": {
+        "**/**.{md,yml}": "3650-days"
+      }           
+    },
+    "dest": "_site",
+    "template": [
+      "default"
+    ],
+    "markdownEngineName": "markdig"
+  }
+}
diff --git a/entity-framework/dotnet-data/index.yml b/entity-framework/dotnet-data/index.yml
new file mode 100644
index 0000000000..fa791286b6
--- /dev/null
+++ b/entity-framework/dotnet-data/index.yml
@@ -0,0 +1,266 @@
+### YamlMime:Hub
+
+title: .NET (C#) data documentation hub
+summary: This page contains resources about how to work with data using .NET (C#). Use our docs and tutorials to choose from our wide variety of available databases & data access approaches and get started quick!
+brand: dotnet
+
+metadata:
+  title:  .NET (C#) data documentation 
+  center  description: This page contains resources about how to work with data using .NET (C#). Use our docs and tutorials to choose from our wide variety of available databases & data access approaches and get started quick!
+  ms.product: entity-framework
+  ms.topic: hub-page
+  author: jcjiang
+  ms.date: 03/08/2023
+
+# highlightedContent section (optional)
+# Maximum of 8 items
+highlightedContent:
+  # itemType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | video | whats-new
+  items:    
+
+      # Card
+    - title: "Accessing your data using C# (Entity Framework Core)"
+      itemType: overview
+      url: /ef/core/
+
+    # Card
+    - title: "Tutorial: Query and manage data using C# (Entity Framework Core)"
+      itemType: quickstart
+      url: /training/modules/persist-data-ef-core/
+
+    # Card
+    - title: "Video: Access a SQL Server or Azure SQL database in 6 minutes with C#"
+      itemType: quickstart
+      url: /shows/on-net/how-do-i-use-sql-server-with-csharp-and-dotnet
+
+    # Card
+    - title: "Tutorial: Access a SQLite database using C# (Entity Framework Core)"
+      itemType: quickstart
+      url: /ef/core/get-started/overview/first-app
+
+    # Card
+    - title: "Using C# to work with a SQL Server or Azure SQL database (Docs)"
+      itemType: overview
+      url: /troubleshoot/developer/visualstudio/csharp/language-compilers/create-sql-server-database-programmatically
+    
+    # Card
+    - title: "Querying data with Language-Integrated Query (LINQ)"
+      itemType: overview
+      url: /dotnet/standard/linq
+
+    # Card
+    - title: "Tutorial: Create a web API that uses a database"
+      itemType: quickstart
+      url: /aspnet/core/tutorials/first-web-api
+
+    # Card
+    - title: "What is ML.NET?"
+      itemType: overview
+      url: https://dotnet.microsoft.com/learn/ml-dotnet/what-is-mldotnet
+
+# Card with summary style
+additionalContent:
+  # Supports up to 3 sections
+  sections:
+    - title: Supported database management systems # < 60 chars (optional)
+      items:
+        # Card
+        - title: Relational databases
+          links:
+            - url: /dotnet/standard/data/sqlite/
+              text: "Use .NET (C#) to connect and query data in SQLite"
+            - url: /sql/
+              text: "Use .NET (C#) to connect and query data in Microsoft SQL Server or Azure SQL"
+            - url: /azure/postgresql/flexible-server/connect-csharp
+              text: "Use .NET (C#) to connect and query data in Azure Database for PostgreSQL - Flexible Server"
+            - url: /azure/mysql/connect-csharp
+              text: "Use .NET (C#) to connect and query data in Azure Database for MySQL"
+
+        # Card
+        - title: Document database (Azure Cosmos DB)
+          links:
+            - url: /azure/cosmos-db
+              text: "Azure Cosmos DB documentation"
+            - url: /azure/cosmos-db/sql/sql-api-dotnet-application
+              text: "Develop an ASP.NET Core MVC web application with Azure Cosmos DB by using .NET SDK"
+            - url: /azure/cosmos-db/sql/create-notebook-visualize-data
+              text: "Create a notebook in Azure Cosmos DB to analyze and visualize the data"
+            - url: /azure/cosmos-db/mongodb/mongodb-introduction
+              text: "Azure Cosmos DB for MongoDB"
+            - url: /ef/core/providers/cosmos/
+              text: "EF Core Azure Cosmos DB provider"
+
+        # Card
+        - title: Graph database (Azure Cosmos DB Graph API)
+          links:
+            - url: /azure/cosmos-db/graph/graph-introduction
+              text: "Introduction to Azure Cosmos DB for Apache Gremlin"
+            - url: /azure/cosmos-db/graph/create-graph-dotnet
+              text: "Build a .NET Framework or Core application using the Azure Cosmos DB for Apache Gremlin account"
+            - url: /sql/relational-databases/graphs/sql-graph-architecture
+              text: "SQL Graph Architecture"
+
+        # Card
+        - title: Distributed key/value databases and cache
+          links:
+            - url: https://microsoft.github.io/FASTER/
+              text: "FASTER concurrent persistent key/value store"
+            - url: /dotnet/orleans/overview
+              text: "Microsoft Orleans framework for distributed apps"
+            - url: https://github.com/Azure/azure-sdk-for-net/blob/Azure.Data.Tables_12.5.0/sdk/tables/Azure.Data.Tables/README.md
+              text: "Azure Tables client library for .NET"
+            - url: /azure/azure-cache-for-redis/cache-overview
+              text: "Azure Cache for Redis"
+
+        # Card
+        - title: Unstructured/blob storage
+          links:
+            - url: /azure/storage/blobs/storage-blobs-introduction
+              text: "Introduction to blob storage"
+            - url: /azure/storage/blobs/storage-quickstart-blobs-dotnet?tabs=environment-variable-windows
+              text: "Quickstart: Azure Blob Storage client library v12 for .NET"
+            - url: /azure/storage/blobs/data-lake-storage-introduction
+              text: "Introduction to Azure Data Lake Storage Gen2"
+
+    #Section
+    - title: Data services
+      items:
+
+        # Card
+        - title: EF Core
+          links:
+            - url: /ef/core/
+              text: "Overview"
+            - url: /ef/core/get-started/overview/first-app
+              text: "Create your first EF Core app"
+            - url: /training/modules/persist-data-ef-core/
+              text: "Learn: Persist and retrieve relational data with EF Core"
+            - url: /ef/core/providers/
+              text: "Supported databases"
+
+        - title: Language Integrated Query (LINQ)
+          links:
+            - url: /dotnet/csharp/programming-guide/concepts/linq
+              text: "Overview"
+            - url: /dotnet/csharp/programming-guide/concepts/linq/introduction-to-linq-queries
+              text: "Introduction to LINQ queries"
+            - url: /dotnet/csharp/programming-guide/concepts/linq/linq-to-objects
+              text: "LINQ over IEnumerable"
+        
+        # Card
+        - title: Big data
+          links:
+            - url: /dotnet/spark/what-is-apache-spark-dotnet
+              text: "What is .NET for Apache Spark?"
+            - url: https://dotnet.microsoft.com/learn/data/spark-tutorial/intro
+              text: "10-minute .NET for Apache Spark(tm) Tutorial"    
+            - url: /azure/synapse-analytics/overview-what-is
+              text: "What is Azure Synapse?"
+
+        # Card
+        - title: Machine learning
+          links:
+            - url: https://dotnet.microsoft.com/learn/ml-dotnet/what-is-mldotnet
+              text: "What is ML.NET? Step-by-step"
+            - url: /dotnet/machine-learning/
+              text: "ML.NET documentation"
+            - url: /dotnet/machine-learning/tutorials/
+              text: "ML.NET tutorials"
+
+        # Card
+        - title: Mobile apps
+          links:
+            - url: /azure/developer/mobile-apps/azure-mobile-apps/overview
+              text: "Microsoft Datasync Framework (Azure mobile apps)"
+            - url: /azure/developer/mobile-apps/azure-mobile-apps/quickstarts/maui/
+              text: "Build a .NET MAUI mobile app with Azure Mobile Apps"
+            - url: /azure/developer/mobile-apps/azure-mobile-apps/howto/data-sync
+              text: "Offline data sync"
+
+        # Card
+        - title: ETL and analytics
+          links:
+            - url: /azure/architecture/data-guide/relational-data/etl
+              text: "Extract, Transform and Load (ETL) Architecture"
+            - url: /azure/data-factory/concepts-pipelines-activities?tabs=data-factory
+              text: "ETL with Azure Data Factory and/or Synapse Analytics"
+            - url: /sql/integration-services/sql-server-integration-services
+              text: "SQL Server Integration Services"
+
+        # Card
+        - title: Messages, notifications, and events
+          links:
+            - url: /dotnet/architecture/microservices/multi-container-microservice-net-applications/integration-event-based-microservice-communications
+              text: "Implementing event-based communication between .NET microservices"
+            - url: /dotnet/architecture/serverless/event-grid
+              text: "Serverless messaging with Azure Event Grid"
+            - url: /azure/event-hubs/event-hubs-dotnet-standard-getstarted-send
+              text: "Send and receive events from .NET using Azure Event Hubs"
+            - url: /dotnet/orleans/overview 
+              text: "Distributed .NET apps with Orleans"
+              
+
+    # Section
+    - title: "APIs"
+      items:
+        # Card
+        - title: REST
+          links:
+            - url: /aspnet/core/tutorials/min-web-api
+              text: "Minimal Web API tutorial"
+            - url: /azure/architecture/best-practices/api-design
+              text: "RESTful web API design"
+            - url: /azure/api-management/
+              text: "Azure API Management (APIM)"
+            - url: /aspnet/core/tutorials/web-api-help-pages-using-swagger
+              text: "Document APIs with Swagger (OpenAPI)"
+
+        # Card
+        - title: OData
+          links:
+            - url: /odata/overview
+              text: "OData overview"
+            - url: /odata/client/getting-started
+              text: "Get started with the OData client for .NET"
+            - url: https://youtu.be/Q3Ove-2Uh94
+              text: "Video: OData (.NET Data community standup)"
+
+        # Card
+        - title: GraphQL
+          links:
+            - url: /shows/graphql/
+              text: "Video series: Learning GraphQL"
+            - url: /azure/api-management/graphql-api
+              text: "Azure API Management support for GraphQL"
+            - url: /shows/on-net/getting-started-with-hotchocolate
+              text: "Video: Getting start with GraphQL on .NET using HotChocolate"
+
+        # Card
+        - title: CoreWCF
+          links:
+            - url: https://github.com/CoreWCF/CoreWCF
+              text: "CoreWCF overview"
+            - url: https://github.com/CoreWCF/CoreWCF/blob/main/Documentation/Walkthrough.md
+              text: "CoreWCF walkthrough"
+
+        # Card
+        - title: gRPC
+          links:
+            - url: /aspnet/core/grpc/
+              text: "Overview of gRPC on .NET"
+            - url: /aspnet/core/grpc/basics
+              text: "Write gRPC services with C# and .NET"
+            - url: /aspnet/core/grpc/client
+              text: "Call gRPC services from .NET with C#"
+            - url: /aspnet/core/grpc/why-migrate-wcf-to-dotnet-grpc
+              text: "Why migrate from WCF to gRPC on ASP.NET Core"
+
+        # Card
+        - title: SignalR
+          links:
+            - url: /aspnet/signalr/overview/getting-started/introduction-to-signalr
+              text: "Introduction to SignalR"
+            - url: /aspnet/signalr/overview/guide-to-the-api/
+              text: "Guide to the SignalR API"
+            - url: /aspnet/core/signalr/api-design
+              text: "SignalR API design considerations"
diff --git a/entity-framework/ef6/fundamentals/async.md b/entity-framework/ef6/fundamentals/async.md
new file mode 100644
index 0000000000..e6860e1fd7
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/async.md
@@ -0,0 +1,233 @@
+---
+title: Async query and save - EF6
+description: Async query and save in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/fundamentals/async
+---
+# Async query and save
+> [!NOTE]
+> **EF6 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 6. If you are using an earlier version, some or all of the information does not apply.
+
+EF6 introduced support for asynchronous query and save using the [async and await keywords](https://msdn.microsoft.com/library/vstudio/hh191443.aspx) that were introduced in .NET 4.5. While not all applications may benefit from asynchrony, it can be used to improve client responsiveness and server scalability when handling long-running, network or I/O-bound tasks.
+
+## When to really use async
+
+The purpose of this walkthrough is to introduce the async concepts in a way that makes it easy to observe the difference between asynchronous and synchronous program execution. This walkthrough is not intended to illustrate any of the key scenarios where async programming provides benefits.
+
+Async programming is primarily focused on freeing up the current managed thread (thread running .NET code) to do other work while it waits for an operation that does not require any compute time from a managed thread. For example, whilst the database engine is processing a query there is nothing to be done by .NET code.
+
+In client applications (WinForms, WPF, etc.) the current thread can be used to keep the UI responsive while the async operation is performed. In server applications (ASP.NET etc.) the thread can be used to process other incoming requests - this can reduce memory usage and/or increase throughput of the server.
+
+In most applications using async will have no noticeable benefits and even could be detrimental. Use tests, profiling and common sense to measure the impact of async in your particular scenario before committing to it.
+
+Here are some more resources to learn about async:
+
+-   [Brandon Bray’s overview of async/await in .NET 4.5](https://devblogs.microsoft.com/dotnet/async-in-4-5-worth-the-await/)
+-   [Asynchronous Programming](https://msdn.microsoft.com/library/hh191443.aspx) pages in the MSDN Library
+
+## Create the model
+
+We’ll be using the [Code First workflow](xref:ef6/modeling/code-first/workflows/new-database) to create our model and generate the database, however the asynchronous functionality will work with all EF models including those created with the EF Designer.
+
+-   Create a Console Application and call it **AsyncDemo**
+-   Add the EntityFramework NuGet package
+    -   In Solution Explorer, right-click on the **AsyncDemo** project
+    -   Select **Manage NuGet Packages…**
+    -   In the Manage NuGet Packages dialog, Select the **Online** tab and choose the **EntityFramework** package
+    -   Click **Install**
+-   Add a **Model.cs** class with the following implementation
+
+``` csharp
+    using System.Collections.Generic;
+    using System.Data.Entity;
+
+    namespace AsyncDemo
+    {
+        public class BloggingContext : DbContext
+        {
+            public DbSet<Blog> Blogs { get; set; }
+            public DbSet<Post> Posts { get; set; }
+        }
+
+        public class Blog
+        {
+            public int BlogId { get; set; }
+            public string Name { get; set; }
+
+            public virtual List<Post> Posts { get; set; }
+        }
+
+        public class Post
+        {
+            public int PostId { get; set; }
+            public string Title { get; set; }
+            public string Content { get; set; }
+
+            public int BlogId { get; set; }
+            public virtual Blog Blog { get; set; }
+        }
+    }
+```
+
+ 
+
+## Create a synchronous program
+
+Now that we have an EF model, let's write some code that uses it to perform some data access.
+
+-   Replace the contents of **Program.cs** with the following code
+
+``` csharp
+    using System;
+    using System.Linq;
+
+    namespace AsyncDemo
+    {
+        class Program
+        {
+            static void Main(string[] args)
+            {
+                PerformDatabaseOperations();
+
+                Console.WriteLine("Quote of the day");
+                Console.WriteLine(" Don't worry about the world coming to an end today... ");
+                Console.WriteLine(" It's already tomorrow in Australia.");
+
+                Console.WriteLine();
+                Console.WriteLine("Press any key to exit...");
+                Console.ReadKey();
+            }
+
+            public static void PerformDatabaseOperations()
+            {
+                using (var db = new BloggingContext())
+                {
+                    // Create a new blog and save it
+                    db.Blogs.Add(new Blog
+                    {
+                        Name = "Test Blog #" + (db.Blogs.Count() + 1)
+                    });
+                    Console.WriteLine("Calling SaveChanges.");
+                    db.SaveChanges();
+                    Console.WriteLine("SaveChanges completed.");
+
+                    // Query for all blogs ordered by name
+                    Console.WriteLine("Executing query.");
+                    var blogs = (from b in db.Blogs
+                                orderby b.Name
+                                select b).ToList();
+
+                    // Write all blogs out to Console
+                    Console.WriteLine("Query completed with following results:");
+                    foreach (var blog in blogs)
+                    {
+                        Console.WriteLine(" " + blog.Name);
+                    }
+                }
+            }
+        }
+    }
+```
+
+This code calls the `PerformDatabaseOperations` method which saves a new **Blog** to the database and then retrieves all **Blogs** from the database and prints them to the **Console**. After this, the program writes a quote of the day to the **Console**.
+
+Since the code is synchronous, we can observe the following execution flow when we run the program:
+
+1.  `SaveChanges` begins to push the new **Blog** to the database
+2.  `SaveChanges` completes
+3.  Query for all **Blogs** is sent to the database
+4.  Query returns and results are written to **Console**
+5.  Quote of the day is written to **Console**
+
+![Sync Output](~/ef6/media/syncoutput.png) 
+
+ 
+
+## Making it asynchronous
+
+Now that we have our program up and running, we can begin making use of the new async and await keywords. We've made the following changes to Program.cs
+
+1.  Line 2: The using statement for the `System.Data.Entity` namespace gives us access to the EF async extension methods.
+2.  Line 4: The using statement for the `System.Threading.Tasks` namespace allows us to use the `Task` type.
+3.  Line 12 & 18: We are capturing as task that monitors the progress of `PerformSomeDatabaseOperations` (line 12) and then blocking program execution for this task to complete once all the work for the program is done (line 18).
+4.  Line 25: We've update `PerformSomeDatabaseOperations` to be marked as `async` and return a `Task`.
+5.  Line 35: We're now calling the Async version of `SaveChanges` and awaiting it's completion.
+6.  Line 42: We're now calling the Async version of `ToList` and awaiting on the result.
+
+For a comprehensive list of available extension methods in the `System.Data.Entity` namespace, refer to the `QueryableExtensions` class. *You’ll also need to add `using System.Data.Entity` to your using statements.*
+
+``` csharp
+    using System;
+    using System.Data.Entity;
+    using System.Linq;
+    using System.Threading.Tasks;
+
+    namespace AsyncDemo
+    {
+        class Program
+        {
+            static void Main(string[] args)
+            {
+                var task = PerformDatabaseOperations();
+
+                Console.WriteLine("Quote of the day");
+                Console.WriteLine(" Don't worry about the world coming to an end today... ");
+                Console.WriteLine(" It's already tomorrow in Australia.");
+
+                task.Wait();
+
+                Console.WriteLine();
+                Console.WriteLine("Press any key to exit...");
+                Console.ReadKey();
+            }
+
+            public static async Task PerformDatabaseOperations()
+            {
+                using (var db = new BloggingContext())
+                {
+                    // Create a new blog and save it
+                    db.Blogs.Add(new Blog
+                    {
+                        Name = "Test Blog #" + (db.Blogs.Count() + 1)
+                    });
+                    Console.WriteLine("Calling SaveChanges.");
+                    await db.SaveChangesAsync();
+                    Console.WriteLine("SaveChanges completed.");
+
+                    // Query for all blogs ordered by name
+                    Console.WriteLine("Executing query.");
+                    var blogs = await (from b in db.Blogs
+                                orderby b.Name
+                                select b).ToListAsync();
+
+                    // Write all blogs out to Console
+                    Console.WriteLine("Query completed with following results:");
+                    foreach (var blog in blogs)
+                    {
+                        Console.WriteLine(" - " + blog.Name);
+                    }
+                }
+            }
+        }
+    }
+```
+
+Now that the code is asynchronous, we can observe a different execution flow when we run the program:
+
+1. `SaveChanges` begins to push the new **Blog** to the database  
+    *Once the command is sent to the database no more compute time is needed on the current managed thread. The `PerformDatabaseOperations` method returns (even though it hasn't finished executing) and program flow in the Main method continues.*
+2. **Quote of the day is written to Console**  
+    *Since there is no more work to do in the Main method, the managed thread is blocked on the `Wait` call until the database operation completes. Once it completes, the remainder of our `PerformDatabaseOperations` will be executed.*
+3.  `SaveChanges` completes  
+4.  Query for all **Blogs** is sent to the database  
+    *Again, the managed thread is free to do other work while the query is processed in the database. Since all other execution has completed, the thread will just halt on the Wait call though.*
+5.  Query returns and results are written to **Console**  
+
+![Async Output](~/ef6/media/asyncoutput.png) 
+
+ 
+
+## The takeaway
+
+We now saw how easy it is to make use of EF’s asynchronous methods. Although the advantages of async may not be very apparent with a simple console app, these same strategies can be applied in situations where long-running or network-bound activities might otherwise block the application, or cause a large number of threads to increase the memory footprint.
diff --git a/entity-framework/ef6/fundamentals/configuring/code-based.md b/entity-framework/ef6/fundamentals/configuring/code-based.md
new file mode 100644
index 0000000000..116c56e06b
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/configuring/code-based.md
@@ -0,0 +1,120 @@
+---
+title: Code-based configuration - EF6
+description: Code-based configuration in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/fundamentals/configuring/code-based
+---
+# Code-based configuration
+> [!NOTE]
+> **EF6 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 6. If you are using an earlier version, some or all of the information does not apply.  
+
+Configuration for an Entity Framework application can be specified in a config file (app.config/web.config) or through code. The latter is known as code-based configuration.  
+
+Configuration in a config file is described in a [separate article](xref:ef6/fundamentals/configuring/config-file). The config file takes precedence over code-based configuration. In other words, if a configuration option is set in both code and in the config file, then the setting in the config file is used.  
+
+## Using `DbConfiguration`
+
+Code-based configuration in EF6 and above is achieved by creating a subclass of `System.Data.Entity.Config.DbConfiguration`. The following guidelines should be followed when subclassing `DbConfiguration`:  
+
+- Create only one `DbConfiguration` class for your application. This class specifies app-domain wide settings.  
+- Place your `DbConfiguration` class in the same assembly as your `DbContext` class. (See the *Moving `DbConfiguration`* section if you want to change this.)  
+- Give your `DbConfiguration` class a public parameterless constructor.  
+- Set configuration options by calling protected `DbConfiguration` methods from within this constructor.  
+
+Following these guidelines allows EF to discover and use your configuration automatically by both tooling that needs to access your model and when your application is run.  
+
+## Example  
+
+A class derived from `DbConfiguration` might look like this:  
+
+``` csharp
+using System.Data.Entity;
+using System.Data.Entity.Infrastructure;
+using System.Data.Entity.SqlServer;
+
+namespace MyNamespace
+{
+    public class MyConfiguration : DbConfiguration
+    {
+        public MyConfiguration()
+        {
+            SetExecutionStrategy("System.Data.SqlClient", () => new SqlAzureExecutionStrategy());
+            SetDefaultConnectionFactory(new LocalDbConnectionFactory("mssqllocaldb"));
+        }
+    }
+}
+```  
+
+This class sets up EF to use the SQL Azure execution strategy - to automatically retry failed database operations - and to use Local DB for databases that are created by convention from Code First.  
+
+## Moving `DbConfiguration`  
+
+There are cases where it is not possible to place your `DbConfiguration` class in the same assembly as your `DbContext` class. For example, you may have two `DbContext` classes each in different assemblies. There are two options for handling this.  
+
+The first option is to use the config file to specify the `DbConfiguration` instance to use. To do this, set the codeConfigurationType attribute of the entityFramework section. For example:  
+
+``` xml
+<entityFramework codeConfigurationType="MyNamespace.MyDbConfiguration, MyAssembly">
+    ...Your EF config...
+</entityFramework>
+```  
+
+The value of codeConfigurationType must be the assembly and namespace qualified name of your `DbConfiguration` class.  
+
+The second option is to place `DbConfigurationTypeAttribute` on your context class. For example:  
+
+``` csharp  
+[DbConfigurationType(typeof(MyDbConfiguration))]
+public class MyContextContext : DbContext
+{
+}
+```  
+
+The value passed to the attribute can either be your `DbConfiguration` type - as shown above - or the assembly and namespace qualified type name string. For example:  
+
+``` csharp
+[DbConfigurationType("MyNamespace.MyDbConfiguration, MyAssembly")]
+public class MyContextContext : DbContext
+{
+}
+```  
+
+## Setting `DbConfiguration` explicitly  
+
+There are some situations where configuration may be needed before any `DbContext` type has been used. Examples of this include:  
+
+- Using `DbModelBuilder` to build a model without a context  
+- Using some other framework/utility code that utilizes a `DbContext` where that context is used before your application context is used  
+
+In such situations EF is unable to discover the configuration automatically and you must instead do one of the following:  
+
+- Set the `DbConfiguration` type in the config file, as described in the *Moving `DbConfiguration`* section above
+- Call the static `DbConfiguration`.SetConfiguration method during application startup  
+
+## Overriding `DbConfiguration`  
+
+There are some situations where you need to override the configuration set in the `DbConfiguration`. This is not typically done by application developers but rather by third party providers and plug-ins that cannot use a derived `DbConfiguration` class.  
+
+For this, EntityFramework allows an event handler to be registered that can modify existing configuration just before it is locked down.  It also provides a sugar method specifically for replacing any service returned by the EF service locator. This is how it is intended to be used:  
+
+- At app startup (before EF is used) the plug-in or provider should register the event handler method for this event. (Note that this must happen before the application uses EF.)  
+- The event handler makes a call to ReplaceService for every service that needs to be replaced.  
+
+For example, to replace `IDbConnectionFactory` and `DbProviderService` you would register a handler something like this:  
+
+``` csharp
+DbConfiguration.Loaded += (_, a) =>
+   {
+       a.ReplaceService<DbProviderServices>((s, k) => new MyProviderServices(s));
+       a.ReplaceService<IDbConnectionFactory>((s, k) => new MyConnectionFactory(s));
+   };
+```  
+
+In the code above, `MyProviderServices` and `MyConnectionFactory` represent your implementations of the service.  
+
+You can also add additional dependency handlers to get the same effect.  
+
+Note that you could also wrap `DbProviderFactory` in this way, but doing so will only affect EF and not uses of the `DbProviderFactory` outside of EF. For this reason you’ll probably want to continue to wrap `DbProviderFactory` as you have before.  
+
+You should also keep in mind the services that you run externally to your application - for example, when running migrations from the Package Manager Console. When you run migrate from the console it will attempt to find your `DbConfiguration`. However, whether or not it will get the wrapped service depends on where the event handler it registered. If it is registered as part of the construction of your `DbConfiguration` then the code should execute and the service should get wrapped. Usually this won’t be the case and this means that tooling won’t get the wrapped service.  
diff --git a/entity-framework/ef6/fundamentals/configuring/config-file.md b/entity-framework/ef6/fundamentals/configuring/config-file.md
new file mode 100644
index 0000000000..94fbe3e13d
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/configuring/config-file.md
@@ -0,0 +1,256 @@
+---
+title: Configuration File Settings - EF6
+description: Configuration file settings in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/fundamentals/configuring/config-file
+ms.custom: sfi-ropc-nochange
+---
+# Configuration File Settings
+Entity Framework allows a number of settings to be specified from the configuration file. In general EF follows a ‘convention over configuration’ principle: all the settings discussed in this post have a default behavior, you only need to worry about changing the setting when the default no longer satisfies your requirements. 
+
+## Configuration data guidelines
+
+* Never store passwords or other sensitive data in configuration provider code or in plain text configuration files.
+* Don't use production secrets in development or test environments.
+* Specify secrets outside of the project so that they can't be accidentally committed to a source code repository.
+* Consider protecting the contents of the configuration file using [Protected Configuration](/dotnet/framework/data/adonet/connection-strings-and-configuration-files#encrypt-configuration-file-sections-using-protected-configuration).
+
+[!INCLUDE [managed-identities-test-non-production](~/core/includes/managed-identities-test-non-production.md)]
+
+## A Code-Based Alternative  
+
+All of these settings can also be applied using code. Starting in EF6 we introduced [code-based configuration](xref:ef6/fundamentals/configuring/code-based), which provides a central way of applying configuration from code. Prior to EF6, configuration can still be applied from code but you need to use various APIs to configure different areas. The configuration file option allows these settings to be easily changed during deployment without updating your code.
+
+## The Entity Framework Configuration Section  
+
+Starting with EF4.1 you could set the database initializer for a context using the **appSettings** section of the configuration file. In EF 4.3 we introduced the custom **entityFramework** section to handle the new settings. Entity Framework will still recognize database initializers set using the old format, but we recommend moving to the new format where possible.
+
+The **entityFramework** section was automatically added to the configuration file of your project when you installed the EntityFramework NuGet package.  
+
+``` xml
+<?xml version="1.0" encoding="utf-8"?>
+<configuration>
+  <configSections>
+    <!-- For more information on Entity Framework configuration, visit http://go.microsoft.com/fwlink/?LinkID=237468 -->
+    <section name="entityFramework"
+       type="System.Data.Entity.Internal.ConfigFile.EntityFrameworkSection, EntityFramework, Version=4.3.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
+  </configSections>
+</configuration>
+```  
+
+## Connection Strings  
+
+[This page](xref:ef6/fundamentals/configuring/connection-strings) provides more details on how Entity Framework determines the database to be used, including connection strings in the configuration file.  
+
+Connection strings go in the standard **connectionStrings** element and do not require the **entityFramework** section.  
+
+Code First based models use normal ADO.NET connection strings. For example:  
+
+``` xml
+<connectionStrings>
+  <add name="BlogContext"  
+        providerName="System.Data.SqlClient"  
+        connectionString="Server=.\SQLEXPRESS;Database=Blogging;Integrated Security=True;"/>
+</connectionStrings>
+```  
+
+EF Designer based models use special EF connection strings. For example:  
+
+``` xml  
+<connectionStrings>
+  <add name="BlogContext"  
+    connectionString=
+      "metadata=
+        res://*/BloggingModel.csdl|
+        res://*/BloggingModel.ssdl|
+        res://*/BloggingModel.msl;
+      provider=System.Data.SqlClient;
+      provider connection string=
+        &quot;data source=(localdb)\mssqllocaldb;
+        initial catalog=Blogging;
+        integrated security=True;
+        multipleactiveresultsets=True;&quot;"
+     providerName="System.Data.EntityClient" />
+</connectionStrings>
+```
+
+## Code-Based Configuration Type (EF6 Onwards)  
+
+Starting with EF6, you can specify the DbConfiguration for EF to use for [code-based configuration](xref:ef6/fundamentals/configuring/code-based) in your application. In most cases you don't need to specify this setting as EF will automatically discover your DbConfiguration. For details of when you may need to specify DbConfiguration in your config file see the **Moving DbConfiguration** section of [Code-Based Configuration](xref:ef6/fundamentals/configuring/code-based).  
+
+To set a DbConfiguration type, you specify the assembly qualified type name in the **codeConfigurationType** element.  
+
+> [!NOTE]
+> An assembly qualified name is the namespace qualified name, followed by a comma, then the assembly that the type resides in. You can optionally also specify the assembly version, culture and public key token.  
+
+``` xml
+<entityFramework codeConfigurationType="MyNamespace.MyConfiguration, MyAssembly">
+</entityFramework>
+```  
+
+## EF Database Providers (EF6 Onwards)  
+
+Prior to EF6, Entity Framework-specific parts of a database provider had to be included as part of the core ADO.NET provider. Starting with EF6, the EF specific parts are now managed and registered separately.  
+
+Normally you won't need to register providers yourself. This will typically be done by the provider when you install it.  
+
+Providers are registered by including a **provider** element under the **providers** child section of the **entityFramework** section. There are two required attributes for a provider entry:  
+
+- **invariantName** identifies the core ADO.NET provider that this EF provider targets  
+- **type** is the assembly qualified type name of the EF provider implementation  
+
+> [!NOTE]
+> An assembly qualified name is the namespace qualified name, followed by a comma, then the assembly that the type resides in. You can optionally also specify the assembly version, culture and public key token.  
+
+As an example here is the entry created to register the default SQL Server provider when you install Entity Framework.  
+
+``` xml  
+<providers>
+  <provider invariantName="System.Data.SqlClient" type="System.Data.Entity.SqlServer.SqlProviderServices, EntityFramework.SqlServer" />
+</providers>
+```  
+
+## Interceptors (EF6.1 Onwards)  
+
+Starting with EF6.1 you can register interceptors in the configuration file. Interceptors allow you to run additional logic when EF performs certain operations, such as executing database queries, opening connections, etc.  
+
+Interceptors are registered by including an **interceptor** element under the **interceptors** child section of the **entityFramework** section. For example, the following configuration registers the built-in **DatabaseLogger** interceptor that will log all database operations to the Console.  
+
+``` xml  
+<interceptors>
+  <interceptor type="System.Data.Entity.Infrastructure.Interception.DatabaseLogger, EntityFramework"/>
+</interceptors>
+```  
+
+### Logging Database Operations to a File (EF6.1 Onwards)  
+
+Registering interceptors via the config file is especially useful when you want to add logging to an existing application to help debug an issue. **DatabaseLogger** supports logging to a file by supplying the file name as a constructor parameter.  
+
+``` xml  
+<interceptors>
+  <interceptor type="System.Data.Entity.Infrastructure.Interception.DatabaseLogger, EntityFramework">
+    <parameters>
+      <parameter value="C:\Temp\LogOutput.txt"/>
+    </parameters>
+  </interceptor>
+</interceptors>
+```  
+
+By default this will cause the log file to be overwritten with a new file each time the app starts. To instead append to the log file if it already exists use something like:  
+
+``` xml  
+<interceptors>
+  <interceptor type="System.Data.Entity.Infrastructure.Interception.DatabaseLogger, EntityFramework">
+    <parameters>
+      <parameter value="C:\Temp\LogOutput.txt"/>
+      <parameter value="true" type="System.Boolean"/>
+    </parameters>
+  </interceptor>
+</interceptors>
+```  
+
+For additional information on **DatabaseLogger** and registering interceptors, see the blog post [EF 6.1: Turning on logging without recompiling](https://blog.oneunicorn.com/2014/02/09/ef-6-1-turning-on-logging-without-recompiling/).  
+
+## Code First Default Connection Factory  
+
+The configuration section allows you to specify a default connection factory that Code First should use to locate a database to use for a context. The default connection factory is only used when no connection string has been added to the configuration file for a context.  
+
+When you installed the EF NuGet package a default connection factory was registered that points to either SQL Express or LocalDB, depending on which one you have installed.  
+
+To set a connection factory, you specify the assembly qualified type name in the **defaultConnectionFactory** element.  
+
+> [!NOTE]
+> An assembly qualified name is the namespace qualified name, followed by a comma, then the assembly that the type resides in. You can optionally also specify the assembly version, culture and public key token.  
+
+Here is an example of setting your own default connection factory:  
+
+``` xml  
+<entityFramework>
+  <defaultConnectionFactory type="MyNamespace.MyCustomFactory, MyAssembly"/>
+</entityFramework>
+```  
+
+The above example requires the custom factory to have a parameterless constructor. If needed, you can specify constructor parameters using the **parameters** element.  
+
+For example, the SqlCeConnectionFactory, that is included in Entity Framework, requires you to supply a provider invariant name to the constructor. The provider invariant name identifies the version of SQL Compact you want to use. The following configuration will cause contexts to use SQL Compact version 4.0 by default.  
+
+``` xml  
+<entityFramework>
+  <defaultConnectionFactory type="System.Data.Entity.Infrastructure.SqlCeConnectionFactory, EntityFramework">
+    <parameters>
+      <parameter value="System.Data.SqlServerCe.4.0" />
+    </parameters>
+  </defaultConnectionFactory>
+</entityFramework>
+```  
+
+If you don’t set a default connection factory, Code First uses the SqlConnectionFactory, pointing to `.\SQLEXPRESS`. SqlConnectionFactory also has a constructor that allows you to override parts of the connection string. If you want to use a SQL Server instance other than `.\SQLEXPRESS` you can use this constructor to set the server.  
+
+The following configuration will cause Code First to use **MyDatabaseServer** for contexts that don’t have an explicit connection string set.  
+
+``` xml  
+<entityFramework>
+  <defaultConnectionFactory type="System.Data.Entity.Infrastructure.SqlConnectionFactory, EntityFramework">
+    <parameters>
+      <parameter value="Data Source=MyDatabaseServer; Integrated Security=True; MultipleActiveResultSets=True" />
+    </parameters>
+  </defaultConnectionFactory>
+</entityFramework>
+```  
+
+By default, it’s assumed that constructor arguments are of type string. You can use the type attribute to change this.  
+
+``` xml
+<parameter value="2" type="System.Int32" />
+```  
+
+## Database Initializers  
+
+Database initializers are configured on a per-context basis. They can be set in the configuration file using the **context** element. This element uses the assembly qualified name to identify the context being configured.  
+
+By default, Code First contexts are configured to use the CreateDatabaseIfNotExists initializer. There is a **disableDatabaseInitialization** attribute on the **context** element that can be used to disable database initialization.  
+
+For example, the following configuration disables database initialization for the Blogging.BlogContext context defined in MyAssembly.dll.  
+
+``` xml  
+<contexts>
+  <context type=" Blogging.BlogContext, MyAssembly" disableDatabaseInitialization="true" />
+</contexts>
+```  
+
+You can use the **databaseInitializer** element to set a custom initializer.  
+
+``` xml
+<contexts>
+  <context type=" Blogging.BlogContext, MyAssembly">
+    <databaseInitializer type="Blogging.MyCustomBlogInitializer, MyAssembly" />
+  </context>
+</contexts>
+```  
+
+Constructor parameters use the same syntax as default connection factories.  
+
+``` xml  
+<contexts>
+  <context type=" Blogging.BlogContext, MyAssembly">
+    <databaseInitializer type="Blogging.MyCustomBlogInitializer, MyAssembly">
+      <parameters>
+        <parameter value="MyConstructorParameter" />
+      </parameters>
+    </databaseInitializer>
+  </context>
+</contexts>
+```  
+
+You can configure one of the generic database initializers that are included in Entity Framework. The **type** attribute uses the .NET Framework format for generic types.  
+
+For example, if you are using Code First Migrations, you can configure the database to be migrated automatically using the `MigrateDatabaseToLatestVersion<TContext, TMigrationsConfiguration>` initializer.  
+
+``` xml
+<contexts>
+  <context type="Blogging.BlogContext, MyAssembly">
+    <databaseInitializer type="System.Data.Entity.MigrateDatabaseToLatestVersion`2[[Blogging.BlogContext, MyAssembly], [Blogging.Migrations.Configuration, MyAssembly]], EntityFramework" />
+  </context>
+</contexts>
+```
diff --git a/entity-framework/ef6/fundamentals/configuring/connection-strings.md b/entity-framework/ef6/fundamentals/configuring/connection-strings.md
new file mode 100644
index 0000000000..32a18a4ac3
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/configuring/connection-strings.md
@@ -0,0 +1,147 @@
+---
+title: Connection strings and models - EF6
+description: Connection strings and models in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/fundamentals/configuring/connection-strings
+ms.custom: sfi-ropc-nochange
+---
+# Connection strings and models
+This article covers how Entity Framework discovers which database connection to use, and how to change it. Models created with Code First and the EF Designer are covered. 
+
+[!INCLUDE [managed-identities-test-non-production](~/core/includes/managed-identities-test-non-production.md)]
+
+
+Typically an Entity Framework application uses a class derived from DbContext. This derived class calls one of the constructors on the base DbContext class to control:  
+
+- How the context connects to a database, that is, how a connection string is found and used.
+- Whether the context calculates a model using Code First or loads a model created with the EF Designer.
+- Additional advanced options  
+
+The following fragments show some of the ways the DbContext constructors can be used.  
+
+## Use Code First with connection by convention  
+
+If you have not done any other configuration in your application, then calling the parameterless constructor on DbContext will cause DbContext to run in Code First mode with a database connection created by convention. For example:  
+
+``` csharp  
+namespace Demo.EF
+{
+    public class BloggingContext : DbContext
+    {
+        public BloggingContext()
+        // C# will call base class parameterless constructor by default
+        {
+        }
+    }
+}
+```  
+
+In this example DbContext uses the namespace qualified name of your derived context class—Demo.EF.BloggingContext—as the database name and creates a connection string for this database using either SQL Express or LocalDB. If both are installed, SQL Express will be used.  
+
+Visual Studio 2010 includes SQL Express by default and Visual Studio 2012 and later includes LocalDB. During installation, the EntityFramework NuGet package checks which database server is available. The NuGet package will then update the configuration file by setting the default database server that Code First uses when creating a connection by convention. If SQL Express is running, it will be used. If SQL Express is not available then LocalDB will be registered as the default instead. No changes are made to the configuration file if it already contains a setting for the default connection factory.  
+
+## Use Code First with connection by convention and specified database name  
+
+If you have not done any other configuration in your application, then calling the string constructor on DbContext with the database name you want to use will cause DbContext to run in Code First mode with a database connection created by convention to the database of that name. For example:  
+
+``` csharp  
+public class BloggingContext : DbContext
+{
+    public BloggingContext()
+        : base("BloggingDatabase")
+    {
+    }
+}
+```  
+
+In this example DbContext uses “BloggingDatabase” as the database name and creates a connection string for this database using either SQL Express (installed with Visual Studio 2010) or LocalDB (installed with Visual Studio 2012). If both are installed, SQL Express will be used.  
+
+## Use Code First with connection string in app.config/web.config file  
+
+You may choose to put a connection string in your app.config or web.config file. For example:  
+
+``` xml  
+<configuration>
+  <connectionStrings>
+    <add name="BloggingCompactDatabase"
+         providerName="System.Data.SqlServerCe.4.0"
+         connectionString="Data Source=Blogging.sdf"/>
+  </connectionStrings>
+</configuration>
+```  
+
+This is an easy way to tell DbContext to use a database server other than SQL Express or LocalDB — the example above specifies a SQL Server Compact Edition database.  
+
+If the name of the connection string matches the name of your context (either with or without namespace qualification) then it will be found by DbContext when the parameterless constructor is used. If the connection string name is different from the name of your context then you can tell DbContext to use this connection in Code First mode by passing the connection string name to the DbContext constructor. For example:  
+
+``` csharp  
+public class BloggingContext : DbContext
+{
+    public BloggingContext()
+        : base("BloggingCompactDatabase")
+    {
+    }
+}
+```  
+
+Alternatively, you can use the form “name=\<connection string name\>” for the string passed to the DbContext constructor. For example:  
+
+``` csharp  
+public class BloggingContext : DbContext
+{
+    public BloggingContext()
+        : base("name=BloggingCompactDatabase")
+    {
+    }
+}
+```  
+
+This form makes it explicit that you expect the connection string to be found in your config file. An exception will be thrown if a connection string with the given name is not found.  
+
+## Database/Model First with connection string in app.config/web.config file  
+
+Models created with the EF Designer are different from Code First in that your model already exists and is not generated from code when the application runs. The model typically exists as an EDMX file in your project.  
+
+The designer will add an EF connection string to your app.config or web.config file. This connection string is special in that it contains information about how to find the information in your EDMX file. For example:  
+
+``` xml  
+<configuration>  
+  <connectionStrings>  
+    <add name="Northwind_Entities"  
+         connectionString="metadata=res://*/Northwind.csdl|  
+                                    res://*/Northwind.ssdl|  
+                                    res://*/Northwind.msl;  
+                           provider=System.Data.SqlClient;  
+                           provider connection string=  
+                               &quot;Data Source=.\sqlexpress;  
+                                     Initial Catalog=Northwind;  
+                                     Integrated Security=True;  
+                                     MultipleActiveResultSets=True&quot;"  
+         providerName="System.Data.EntityClient"/>  
+  </connectionStrings>  
+</configuration>
+```  
+
+The EF Designer will also generate code that tells DbContext to use this connection by passing the connection string name to the DbContext constructor. For example:  
+
+``` csharp  
+public class NorthwindContext : DbContext
+{
+    public NorthwindContext()
+        : base("name=Northwind_Entities")
+    {
+    }
+}
+```  
+
+DbContext knows to load the existing model (rather than using Code First to calculate it from code) because the connection string is an EF connection string containing details of the model to use.  
+
+## Other DbContext constructor options  
+
+The DbContext class contains other constructors and usage patterns that enable some more advanced scenarios. Some of these are:  
+
+- You can use the DbModelBuilder class to build a Code First model without instantiating a DbContext instance. The result of this is a DbModel object. You can then pass this DbModel object to one of the DbContext constructors when you are ready to create your DbContext instance.  
+- You can pass a full connection string to DbContext instead of just the database or connection string name. By default this connection string is used with the System.Data.SqlClient provider; this can be changed by setting a different implementation of IConnectionFactory onto context.Database.DefaultConnectionFactory.  
+- You can use an existing DbConnection object by passing it to a DbContext constructor. If the connection object is an instance of EntityConnection, then the model specified in the connection will be used rather than calculating a model using Code First. If the object is an instance of some other type—for example, SqlConnection—then the context will use it for Code First mode.  
+- You can pass an existing ObjectContext to a DbContext constructor to create a DbContext wrapping the existing context. This can be used for existing applications that use ObjectContext but which want to take advantage of DbContext in some parts of the application.  
diff --git a/entity-framework/ef6/fundamentals/configuring/dependency-resolution.md b/entity-framework/ef6/fundamentals/configuring/dependency-resolution.md
new file mode 100644
index 0000000000..ba8bc306ac
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/configuring/dependency-resolution.md
@@ -0,0 +1,203 @@
+---
+title: Dependency resolution - EF6
+description: Dependency resolution in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/fundamentals/configuring/dependency-resolution
+---
+# Dependency resolution
+> [!NOTE]
+> **EF6 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 6. If you are using an earlier version, some or all of the information does not apply.  
+
+Starting with EF6, Entity Framework contains a general-purpose mechanism for obtaining implementations of services that it requires. That is, when EF uses an instance of some interfaces or base classes it will ask for a concrete implementation of the interface or base class to use. This is achieved through use of the IDbDependencyResolver interface:  
+
+``` csharp
+public interface IDbDependencyResolver
+{
+    object GetService(Type type, object key);
+}
+```  
+
+The GetService method is typically called by EF and is handled by an implementation of IDbDependencyResolver provided either by EF or by the application. When called, the type argument is the interface or base class type of the service being requested, and the key object is either null or an object providing contextual information about the requested service.  
+
+Unless otherwise stated any object returned must be thread-safe since it can be used as a singleton. In many cases the object returned is a factory in which case the factory itself must be thread-safe but the object returned from the factory does not need to be thread-safe since a new instance is requested from the factory for each use.
+
+This article does not contain full details on how to implement IDbDependencyResolver, but instead acts as a reference for the service types (that is, the interface and base class types) for which EF calls GetService and the semantics of the key object for each of these calls.
+
+## System.Data.Entity.IDatabaseInitializer<TContext\>  
+
+**Version introduced**: EF6.0.0  
+
+**Object returned**: A database initializer for the given context type  
+
+**Key**: Not used; will be null  
+
+## Func<System.Data.Entity.Migrations.Sql.MigrationSqlGenerator\>  
+
+**Version introduced**: EF6.0.0
+
+**Object returned**: A factory to create a SQL generator that can be used for Migrations and other actions that cause a database to be created, such as database creation with database initializers.  
+
+**Key**: A string containing the ADO.NET provider invariant name specifying the type of database for which SQL will be generated. For example, the SQL Server SQL generator is returned for the key "System.Data.SqlClient".  
+
+>[!NOTE]
+> For more details on provider-related services in EF6 see the [EF6 provider model](xref:ef6/fundamentals/providers/provider-model) section.  
+
+## System.Data.Entity.Core.Common.DbProviderServices  
+
+**Version introduced**: EF6.0.0  
+
+**Object returned**: The EF provider to use for a given provider invariant name  
+
+**Key**: A string containing the ADO.NET provider invariant name specifying the type of database for which a provider is needed. For example, the SQL Server provider is returned for the key "System.Data.SqlClient".  
+
+>[!NOTE]
+> For more details on provider-related services in EF6 see the [EF6 provider model](xref:ef6/fundamentals/providers/provider-model) section.  
+
+## System.Data.Entity.Infrastructure.IDbConnectionFactory  
+
+**Version introduced**: EF6.0.0  
+
+**Object returned**: The connection factory that will be used when EF creates a database connection by convention. That is, when no connection or connection string is given to EF, and no connection string can be found in the `app.config` or `web.config`, then this service is used to create a connection by convention. Changing the connection factory can allow EF to use a different type of database (for example, SQL Server Compact Edition) by default. Never store passwords or other sensitive data in configuration provider code or in plain text configuration files. Specify secrets outside of the project so that they can't be accidentally committed to a source code repository. Consider protecting the contents of the configuration file using [Protected Configuration](/dotnet/framework/data/adonet/connection-strings-and-configuration-files#encrypt-configuration-file-sections-using-protected-configuration).
+
+**Key**: Not used; will be null  
+
+>[!NOTE]
+> For more details on provider-related services in EF6 see the [EF6 provider model](xref:ef6/fundamentals/providers/provider-model) section.  
+
+## System.Data.Entity.Infrastructure.IManifestTokenService  
+
+**Version introduced**: EF6.0.0  
+
+**Object returned**: A service that can generate a provider manifest token from a connection. This service is typically used in two ways. First, it can be used to avoid Code First connecting to the database when building a model. Second, it can be used to force Code First to build a model for a specific database version -- for example, to force a model for SQL Server 2005 even if sometimes SQL Server 2008 is used.  
+
+**Object lifetime**: Singleton -- the same object may be used multiple times and concurrently by different threads  
+
+**Key**: Not used; will be null  
+
+## System.Data.Entity.Infrastructure.IDbProviderFactoryService  
+
+**Version introduced**: EF6.0.0  
+
+**Object returned**: A service that can obtain a provider factory from a given connection. On .NET 4.5 the provider is publicly accessible from the connection. On .NET 4 the default implementation of this service uses some heuristics to find the matching provider. If these fail then a new implementation of this service can be registered to provide an appropriate resolution.  
+
+**Key**: Not used; will be null  
+
+## Func<DbContext, System.Data.Entity.Infrastructure.IDbModelCacheKey\>  
+
+**Version introduced**: EF6.0.0  
+
+**Object returned**: A factory that will generate a model cache key for a given context. By default, EF caches one model per DbContext type per provider. A different implementation of this service can be used to add other information, such as schema name, to the cache key.  
+
+**Key**: Not used; will be null  
+
+## System.Data.Entity.Spatial.DbSpatialServices  
+
+**Version introduced**: EF6.0.0  
+
+**Object returned**: An EF spatial provider that adds support to the basic EF provider for geography and geometry spatial types.  
+
+**Key**: DbSpatialServices is asked for in two ways. First, provider-specific spatial services are requested using a DbProviderInfo object (which contains invariant name and manifest token) as the key. Second, DbSpatialServices can be asked for with no key. This is used to resolve the "global spatial provider" which is used when creating stand-alone DbGeography or DbGeometry types.  
+
+>[!NOTE]
+> For more details on provider-related services in EF6 see the [EF6 provider model](xref:ef6/fundamentals/providers/provider-model) section.  
+
+## Func<System.Data.Entity.Infrastructure.IDbExecutionStrategy\>  
+
+**Version introduced**: EF6.0.0  
+
+**Object returned**: A factory to create a service that allows a provider to implement retries or other behavior when queries and commands are executed against the database. If no implementation is provided, then EF will simply execute the commands and propagate any exceptions thrown. For SQL Server this service is used to provide a retry policy which is especially useful when running against cloud-based database servers such as SQL Azure.  
+
+**Key**: An ExecutionStrategyKey object that contains the provider invariant name and optionally a server name for which the execution strategy will be used.  
+
+>[!NOTE]
+> For more details on provider-related services in EF6 see the [EF6 provider model](xref:ef6/fundamentals/providers/provider-model) section.  
+
+## Func<DbConnection, string, System.Data.Entity.Migrations.History.HistoryContext\>  
+
+**Version introduced**: EF6.0.0  
+
+**Object returned**: A factory that allows a provider to configure the mapping of the HistoryContext to the `__MigrationHistory` table used by EF Migrations. The HistoryContext is a Code First DbContext and can be configured using the normal fluent API to change things like the name of the table and the column mapping specifications.  
+
+**Key**: Not used; will be null  
+
+>[!NOTE]
+> For more details on provider-related services in EF6 see the [EF6 provider model](xref:ef6/fundamentals/providers/provider-model) section.  
+
+## System.Data.Common.DbProviderFactory  
+
+**Version introduced**: EF6.0.0  
+
+**Object returned**: The ADO.NET provider to use for a given provider invariant name.  
+
+**Key**: A string containing the ADO.NET provider invariant name  
+
+>[!NOTE]
+> This service is not usually changed directly since the default implementation uses the normal ADO.NET provider registration. For more details on provider-related services in EF6 see the [EF6 provider model](xref:ef6/fundamentals/providers/provider-model) section.  
+
+## System.Data.Entity.Infrastructure.IProviderInvariantName  
+
+**Version introduced**: EF6.0.0  
+
+**Object returned**: a service that is used to determine a provider invariant name for a given type of DbProviderFactory. The default implementation of this service uses the ADO.NET provider registration. This means that if the ADO.NET provider is not registered in the normal way because DbProviderFactory is being resolved by EF, then it will also be necessary to resolve this service.  
+
+**Key**: The DbProviderFactory instance for which an invariant name is required.  
+
+>[!NOTE]
+> For more details on provider-related services in EF6 see the [EF6 provider model](xref:ef6/fundamentals/providers/provider-model) section.  
+
+## System.Data.Entity.Core.Mapping.ViewGeneration.IViewAssemblyCache  
+
+**Version introduced**: EF6.0.0  
+
+**Object returned**: a cache of the assemblies that contain pre-generated views. A replacement is typically used to let EF know which assemblies contain pre-generated views without doing any discovery.  
+
+**Key**: Not used; will be null  
+
+## System.Data.Entity.Infrastructure.Pluralization.IPluralizationService
+
+**Version introduced**: EF6.0.0  
+
+**Object returned**: a service used by EF to pluralize and singularize names. By default an English pluralization service is used.  
+
+**Key**: Not used; will be null  
+
+## System.Data.Entity.Infrastructure.Interception.IDbInterceptor  
+
+**Version introduced**: EF6.0.0
+
+**Objects returned**: Any interceptors that should be registered when the application starts. Note that these objects are requested using the GetServices call and all interceptors returned by any dependency resolver will registered.
+
+**Key**: Not used; will be null.  
+
+## Func<System.Data.Entity.DbContext, Action<string\>, System.Data.Entity.Infrastructure.Interception.DatabaseLogFormatter\>  
+
+**Version introduced**: EF6.0.0  
+
+**Object returned**: A factory that will be used to create the database log formatter that will be used when the context.Database.Log property is set on the given context.  
+
+**Key**: Not used; will be null.  
+
+## Func<System.Data.Entity.DbContext\>  
+
+**Version introduced**: EF6.1.0  
+
+**Object returned**: A factory that will be used to create context instances for Migrations when the context does not have an accessible parameterless constructor.  
+
+**Key**: The Type object for the type of the derived DbContext for which a factory is needed.  
+
+## Func<System.Data.Entity.Core.Metadata.Edm.IMetadataAnnotationSerializer\>  
+
+**Version introduced**: EF6.1.0  
+
+**Object returned**: A factory that will be used to create serializers for serialization of strongly-typed custom annotations such that they can be serialized and deserialized into XML for use in Code First Migrations.  
+
+**Key**: The name of the annotation that is being serialized or deserialized.  
+
+## Func<System.Data.Entity.Infrastructure.TransactionHandler\>  
+
+**Version introduced**: EF6.1.0  
+
+**Object returned**: A factory that will be used to create handlers for transactions so that special handling can be applied for situations such as handling commit failures.  
+
+**Key**: An ExecutionStrategyKey object that contains the provider invariant name and optionally a server name for which the transaction handler will be used.  
diff --git a/entity-framework/ef6/fundamentals/connection-management.md b/entity-framework/ef6/fundamentals/connection-management.md
new file mode 100644
index 0000000000..7822123493
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/connection-management.md
@@ -0,0 +1,230 @@
+---
+title: Connection management - EF6
+description: Connection management in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/fundamentals/connection-management
+ms.custom: sfi-ropc-nochange
+---
+# Connection management
+This page describes the behavior of Entity Framework with regard to passing connections to the context and the functionality of the **Database.Connection.Open()** API.  
+
+## Passing Connections to the Context  
+
+### Behavior for EF5 and earlier versions  
+
+There are two constructors which accept connections:  
+
+``` csharp
+public DbContext(DbConnection existingConnection, bool contextOwnsConnection)
+public DbContext(DbConnection existingConnection, DbCompiledModel model, bool contextOwnsConnection)
+```  
+
+It is possible to use these but you have to work around a couple of limitations:  
+
+1. If you pass an open connection to either of these then the first time the framework attempts to use it an InvalidOperationException is thrown saying it cannot re-open an already open connection.  
+2. The contextOwnsConnection flag is interpreted to mean whether or not the underlying store connection should be disposed when the context is disposed. But, regardless of that setting, the store connection is always closed when the context is disposed. So if you have more than one DbContext with the same connection whichever context is disposed first will close the connection (similarly if you have mixed an existing ADO.NET connection with a DbContext, DbContext will always close the connection when it is disposed).  
+
+It is possible to work around the first limitation above by passing a closed connection and only executing code that would open it once all contexts have been created:  
+
+``` csharp
+using System.Collections.Generic;
+using System.Data.Common;
+using System.Data.Entity;
+using System.Data.Entity.Infrastructure;
+using System.Data.EntityClient;
+using System.Linq;
+
+namespace ConnectionManagementExamples
+{
+    class ConnectionManagementExampleEF5
+    {         
+        public static void TwoDbContextsOneConnection()
+        {
+            using (var context1 = new BloggingContext())
+            {
+                var conn =
+                    ((EntityConnection)  
+                        ((IObjectContextAdapter)context1).ObjectContext.Connection)  
+                            .StoreConnection;
+
+                using (var context2 = new BloggingContext(conn, contextOwnsConnection: false))
+                {
+                    context2.Database.ExecuteSqlCommand(
+                        @"UPDATE Blogs SET Rating = 5" +
+                        " WHERE Name LIKE '%Entity Framework%'");
+
+                    var query = context1.Posts.Where(p => p.Blog.Rating > 5);
+                    foreach (var post in query)
+                    {
+                        post.Title += "[Cool Blog]";
+                    }
+                    context1.SaveChanges();
+                }
+            }
+        }
+    }
+}
+```  
+
+The second limitation just means you need to refrain from disposing any of your DbContext objects until you are ready for the connection to be closed.  
+
+### Behavior in EF6 and future versions  
+
+In EF6 and future versions the DbContext has the same two constructors but no longer requires that the connection passed to the constructor be closed when it is received. So this is now possible:  
+
+``` csharp
+using System.Collections.Generic;
+using System.Data.Entity;
+using System.Data.SqlClient;
+using System.Linq;
+using System.Transactions;
+
+namespace ConnectionManagementExamples
+{
+    class ConnectionManagementExample
+    {
+        public static void PassingAnOpenConnection()
+        {
+            using (var conn = new SqlConnection("{connectionString}"))
+            {
+                conn.Open();
+
+                var sqlCommand = new SqlCommand();
+                sqlCommand.Connection = conn;
+                sqlCommand.CommandText =
+                    @"UPDATE Blogs SET Rating = 5" +
+                     " WHERE Name LIKE '%Entity Framework%'";
+                sqlCommand.ExecuteNonQuery();
+
+                using (var context = new BloggingContext(conn, contextOwnsConnection: false))
+                {
+                    var query = context.Posts.Where(p => p.Blog.Rating > 5);
+                    foreach (var post in query)
+                    {
+                        post.Title += "[Cool Blog]";
+                    }
+                    context.SaveChanges();
+                }
+
+                var sqlCommand2 = new SqlCommand();
+                sqlCommand2.Connection = conn;
+                sqlCommand2.CommandText =
+                    @"UPDATE Blogs SET Rating = 7" +
+                     " WHERE Name LIKE '%Entity Framework Rocks%'";
+                sqlCommand2.ExecuteNonQuery();
+            }
+        }
+    }
+}
+```  
+
+Also the contextOwnsConnection flag now controls whether or not the connection is both closed and disposed when the DbContext is disposed. So in the above example the connection is not closed when the context is disposed (line 32) as it would have been in previous versions of EF, but rather when the connection itself is disposed (line 40).  
+
+Of course it is still possible for the DbContext to take control of the connection (just set contextOwnsConnection to true or use one of the other constructors) if you so wish.  
+
+> [!NOTE]
+> There are some additional considerations when using transactions with this new model. For details see [Working with Transactions](xref:ef6/saving/transactions).  
+
+## Database.Connection.Open()  
+
+### Behavior for EF5 and earlier versions  
+
+In EF5 and earlier versions there is a bug such that the **ObjectContext.Connection.State** was not updated to reflect the true state of the underlying store connection. For example, if you executed the following code you can be returned the status **Closed** even though in fact the underlying store connection is **Open**.  
+
+``` csharp
+((IObjectContextAdapter)context).ObjectContext.Connection.State
+```  
+
+Separately, if you open the database connection by calling Database.Connection.Open() it will be open until the next time you execute a query or call anything which requires a database connection (for example, SaveChanges()) but after that the underlying store connection will be closed. The context will then re-open and re-close the connection any time another database operation is required:  
+
+``` csharp
+using System;
+using System.Data;
+using System.Data.Entity;
+using System.Data.Entity.Infrastructure;
+using System.Data.EntityClient;
+
+namespace ConnectionManagementExamples
+{
+    public class DatabaseOpenConnectionBehaviorEF5
+    {
+        public static void DatabaseOpenConnectionBehavior()
+        {
+            using (var context = new BloggingContext())
+            {
+                // At this point the underlying store connection is closed
+
+                context.Database.Connection.Open();
+
+                // Now the underlying store connection is open  
+                // (though ObjectContext.Connection.State will report closed)
+
+                var blog = new Blog { /* Blog’s properties */ };
+                context.Blogs.Add(blog);
+
+                // The underlying store connection is still open  
+
+                context.SaveChanges();
+
+                // After SaveChanges() the underlying store connection is closed  
+                // Each SaveChanges() / query etc now opens and immediately closes
+                // the underlying store connection
+
+                blog = new Blog { /* Blog’s properties */ };
+                context.Blogs.Add(blog);
+                context.SaveChanges();
+            }
+        }
+    }
+}
+```  
+
+### Behavior in EF6 and future versions  
+
+For EF6 and future versions we have taken the approach that if the calling code chooses to open the connection by calling context.Database.Connection.Open() then it has a good reason for doing so and the framework will assume that it wants control over opening and closing of the connection and will no longer close the connection automatically.  
+
+> [!NOTE]
+> This can potentially lead to connections which are open for a long time so use with care.  
+
+We also updated the code so that ObjectContext.Connection.State now keeps track of the state of the underlying connection correctly.  
+
+``` csharp
+using System;
+using System.Data;
+using System.Data.Entity;
+using System.Data.Entity.Core.EntityClient;
+using System.Data.Entity.Infrastructure;
+
+namespace ConnectionManagementExamples
+{
+    internal class DatabaseOpenConnectionBehaviorEF6
+    {
+        public static void DatabaseOpenConnectionBehavior()
+        {
+            using (var context = new BloggingContext())
+            {
+                // At this point the underlying store connection is closed
+
+                context.Database.Connection.Open();
+
+                // Now the underlying store connection is open and the
+                // ObjectContext.Connection.State correctly reports open too
+
+                var blog = new Blog { /* Blog’s properties */ };
+                context.Blogs.Add(blog);
+                context.SaveChanges();
+
+                // The underlying store connection remains open for the next operation  
+
+                blog = new Blog { /* Blog’s properties */ };
+                context.Blogs.Add(blog);
+                context.SaveChanges();
+
+                // The underlying store connection is still open
+
+           } // The context is disposed – so now the underlying store connection is closed
+        }
+    }
+}
+```  
diff --git a/entity-framework/ef6/fundamentals/connection-resiliency/commit-failures.md b/entity-framework/ef6/fundamentals/connection-resiliency/commit-failures.md
new file mode 100644
index 0000000000..bc68501905
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/connection-resiliency/commit-failures.md
@@ -0,0 +1,68 @@
+---
+title: Handling transaction commit failures - EF6
+description: Handling transaction commit failures in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/fundamentals/connection-resiliency/commit-failures
+---
+# Handling transaction commit failures
+
+> [!NOTE]
+> **EF6.1 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 6.1. If you are using an earlier version, some or all of the information does not apply.  
+
+As part of 6.1 we are introducing a new connection resiliency feature for EF: the ability to detect and recover automatically when transient connection failures affect the acknowledgment of transaction commits. The full details of the scenario are best described in the blog post [SQL Database Connectivity and the Idempotency Issue](/archive/blogs/adonet/sql-database-connectivity-and-the-idempotency-issue).  In summary, the scenario is that when an exception is raised during a transaction commit there are two possible causes:  
+
+1. The transaction commit failed on the server
+2. The transaction commit succeeded on the server but a connectivity issue prevented the success notification from reaching the client  
+
+When the first situation happens the application or the user can retry the operation, but when the second situation occurs retries should be avoided and the application could recover automatically. The challenge is that without the ability to detect what was the actual reason an exception was reported during commit, the application cannot choose the right course of action. The new feature in EF 6.1 allows EF to double-check with the database if the transaction succeeded and take the right course of action transparently.  
+
+## Using the feature  
+
+In order to enable the feature you need include a call to [SetTransactionHandler](https://msdn.microsoft.com/library/system.data.entity.dbconfiguration.setdefaulttransactionhandler.aspx) in the constructor of your **DbConfiguration**. If you are unfamiliar with **DbConfiguration**, see [Code Based Configuration](xref:ef6/fundamentals/configuring/code-based). This feature can be used in combination with the automatic retries we introduced in EF6, which help in the situation in which the transaction actually failed to commit on the server due to a transient failure:  
+
+``` csharp
+using System.Data.Entity;
+using System.Data.Entity.Infrastructure;
+using System.Data.Entity.SqlServer;
+
+public class MyConfiguration : DbConfiguration  
+{
+  public MyConfiguration()  
+  {  
+    SetTransactionHandler(SqlProviderServices.ProviderInvariantName, () => new CommitFailureHandler());  
+    SetExecutionStrategy(SqlProviderServices.ProviderInvariantName, () => new SqlAzureExecutionStrategy());  
+  }  
+}
+```  
+
+## How transactions are tracked  
+
+When the feature is enabled, EF will automatically add a new table to the database called **__Transactions**. A new row is inserted in this table every time a transaction is created by EF and that row is checked for existence if a transaction failure occurs during commit.  
+
+Although EF will do a best effort to prune rows from the table when they aren’t needed anymore, the table can grow if the application exits prematurely and for that reason you may need to purge the table manually in some cases.  
+
+## How to handle commit failures with previous versions
+
+Before EF 6.1 there was no mechanism to handle commit failures in the EF product. There are several ways to dealing with this situation that can be applied to previous versions of EF6:  
+
+* Option 1 - Do nothing  
+
+  The likelihood of a connection failure during transaction commit is low so it may be acceptable for your application to just fail if this condition actually occurs.  
+
+* Option 2 - Use the database to reset state  
+
+  1. Discard the current DbContext  
+  2. Create a new DbContext and restore the state of your application from the database  
+  3. Inform the user that the last operation might not have been completed successfully  
+
+* Option 3 - Manually track the transaction  
+
+  1. Add a non-tracked table to the database used to track the status of the transactions.  
+  2. Insert a row into the table at the beginning of each transaction.  
+  3. If the connection fails during the commit, check for the presence of the corresponding row in the database.  
+     * If the row is present, continue normally, as the transaction was committed successfully  
+     * If the row is absent, use an execution strategy to retry the current operation.  
+  4. If the commit is successful, delete the corresponding row to avoid the growth of the table.  
+
+[This blog post](/archive/blogs/adonet/sql-database-connectivity-and-the-idempotency-issue) contains sample code for accomplishing this on SQL Azure.  
diff --git a/entity-framework/ef6/fundamentals/connection-resiliency/retry-logic.md b/entity-framework/ef6/fundamentals/connection-resiliency/retry-logic.md
new file mode 100644
index 0000000000..2a56f1a5f0
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/connection-resiliency/retry-logic.md
@@ -0,0 +1,149 @@
+---
+title: Connection resiliency and retry logic - EF6
+description: Connection resiliency and retry logic in Entity Framework 6
+author: AndriySvyryd
+ms.date: 11/20/2019
+uid: ef6/fundamentals/connection-resiliency/retry-logic
+---
+# Connection resiliency and retry logic
+> [!NOTE]
+> **EF6 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 6. If you are using an earlier version, some or all of the information does not apply.  
+
+Applications connecting to a database server have always been vulnerable to connection breaks due to back-end failures and network instability. However, in a LAN based environment working against dedicated database servers these errors are rare enough that extra logic to handle those failures is not often required. With the rise of cloud based database servers such as Windows Azure SQL Database and connections over less reliable networks it is now more common for connection breaks to occur. This could be due to defensive techniques that cloud databases use to ensure fairness of service, such as connection throttling, or to instability in the network causing intermittent timeouts and other transient errors.  
+
+Connection Resiliency refers to the ability for EF to automatically retry any commands that fail due to these connection breaks.  
+
+## Execution Strategies  
+
+Connection retry is taken care of by an implementation of the IDbExecutionStrategy interface. Implementations of the IDbExecutionStrategy will be responsible for accepting an operation and, if an exception occurs, determining if a retry is appropriate and retrying if it is. There are four execution strategies that ship with EF:  
+
+1. **DefaultExecutionStrategy**: this execution strategy does not retry any operations, it is the default for databases other than sql server.  
+2. **DefaultSqlExecutionStrategy**: this is an internal execution strategy that is used by default. This strategy does not retry at all, however, it will wrap any exceptions that could be transient to inform users that they might want to enable connection resiliency.  
+3. **DbExecutionStrategy**: this class is suitable as a base class for other execution strategies, including your own custom ones. It implements an exponential retry policy, where the initial retry happens with zero delay and the delay increases exponentially until the maximum retry count is hit. This class has an abstract ShouldRetryOn method that can be implemented in derived execution strategies to control which exceptions should be retried.  
+4. **SqlAzureExecutionStrategy**: this execution strategy inherits from DbExecutionStrategy and will retry on exceptions that are known to be possibly transient when working with Azure SQL Database.
+
+> [!NOTE]
+> Execution strategies 2 and 4 are included in the Sql Server provider that ships with EF, which is in the EntityFramework.SqlServer assembly and are designed to work with SQL Server.  
+
+## Enabling an Execution Strategy  
+
+The easiest way to tell EF to use an execution strategy is with the SetExecutionStrategy method of the [DbConfiguration](xref:ef6/fundamentals/configuring/code-based) class:  
+
+``` csharp
+public class MyConfiguration : DbConfiguration
+{
+    public MyConfiguration()
+    {
+        SetExecutionStrategy("System.Data.SqlClient", () => new SqlAzureExecutionStrategy());
+    }
+}
+```  
+
+This code tells EF to use the SqlAzureExecutionStrategy when connecting to SQL Server.  
+
+## Configuring the Execution Strategy  
+
+The constructor of SqlAzureExecutionStrategy can accept two parameters, MaxRetryCount and MaxDelay. MaxRetry count is the maximum number of times that the strategy will retry. The MaxDelay is a TimeSpan representing the maximum delay between retries that the execution strategy will use.  
+
+To set the maximum number of retries to 1 and the maximum delay to 30 seconds you would execute the following:  
+
+``` csharp
+public class MyConfiguration : DbConfiguration
+{
+    public MyConfiguration()
+    {
+        SetExecutionStrategy(
+            "System.Data.SqlClient",
+            () => new SqlAzureExecutionStrategy(1, TimeSpan.FromSeconds(30)));
+    }
+}
+```  
+
+The SqlAzureExecutionStrategy will retry instantly the first time a transient failure occurs, but will delay longer between each retry until either the max retry limit is exceeded or the total time hits the max delay.  
+
+The execution strategies will only retry a limited number of exceptions that are usually transient, you will still need to handle other errors as well as catching the RetryLimitExceeded exception for the case where an error is not transient or takes too long to resolve itself.  
+
+There are some known limitations when using a retrying execution strategy:  
+
+## Streaming queries are not supported  
+
+By default, EF6 and later version will buffer query results rather than streaming them. If you want to have results streamed you can use the AsStreaming method to change a LINQ to Entities query to streaming.  
+
+``` csharp
+using (var db = new BloggingContext())
+{
+    var query = (from b in db.Blogs
+                orderby b.Url
+                select b).AsStreaming();
+    }
+}
+```  
+
+Streaming is not supported when a retrying execution strategy is registered. This limitation exists because the connection could drop part way through the results being returned. When this occurs, EF needs to re-run the entire query but has no reliable way of knowing which results have already been returned (data may have changed since the initial query was sent, results may come back in a different order, results may not have a unique identifier, etc.).  
+
+## User initiated transactions are not supported  
+
+When you have configured an execution strategy that results in retries, there are some limitations around the use of transactions.  
+
+By default, EF will perform any database updates within a transaction. You don’t need to do anything to enable this, EF always does this automatically.  
+
+For example, in the following code SaveChanges is automatically performed within a transaction. If SaveChanges were to fail after inserting one of the new Site’s then the transaction would be rolled back and no changes applied to the database. The context is also left in a state that allows SaveChanges to be called again to retry applying the changes.  
+
+``` csharp
+using (var db = new BloggingContext())
+{
+    db.Blogs.Add(new Site { Url = "http://msdn.com/data/ef" });
+    db.Blogs.Add(new Site { Url = "http://blogs.msdn.com/adonet" });
+    db.SaveChanges();
+}
+```  
+
+When not using a retrying execution strategy you can wrap multiple operations in a single transaction. For example, the following code wraps two SaveChanges calls in a single transaction. If any part of either operation fails then none of the changes are applied.  
+
+``` csharp
+using (var db = new BloggingContext())
+{
+    using (var trn = db.Database.BeginTransaction())
+    {
+        db.Blogs.Add(new Site { Url = "http://msdn.com/data/ef" });
+        db.Blogs.Add(new Site { Url = "http://blogs.msdn.com/adonet" });
+        db.SaveChanges();
+
+        db.Blogs.Add(new Site { Url = "http://twitter.com/efmagicunicorns" });
+        db.SaveChanges();
+
+        trn.Commit();
+    }
+}
+```  
+
+This is not supported when using a retrying execution strategy because EF isn’t aware of any previous operations and how to retry them. For example, if the second SaveChanges failed then EF no longer has the required information to retry the first SaveChanges call.  
+
+### Solution: Manually Call Execution Strategy  
+
+The solution is to manually use the execution strategy and give it the entire set of logic to be run, so that it can retry everything if one of the operations fails. When an execution strategy derived from DbExecutionStrategy is running it will suspend the implicit execution strategy used in SaveChanges.  
+
+Note that any contexts should be constructed within the code block to be retried. This ensures that we are starting with a clean state for each retry.  
+
+``` csharp
+var executionStrategy = new SqlAzureExecutionStrategy();
+
+executionStrategy.Execute(
+    () =>
+    {
+        using (var db = new BloggingContext())
+        {
+            using (var trn = db.Database.BeginTransaction())
+            {
+                db.Blogs.Add(new Blog { Url = "http://msdn.com/data/ef" });
+                db.Blogs.Add(new Blog { Url = "http://blogs.msdn.com/adonet" });
+                db.SaveChanges();
+
+                db.Blogs.Add(new Blog { Url = "http://twitter.com/efmagicunicorns" });
+                db.SaveChanges();
+
+                trn.Commit();
+            }
+        }
+    });
+```  
diff --git a/entity-framework/ef6/fundamentals/databinding/winforms.md b/entity-framework/ef6/fundamentals/databinding/winforms.md
new file mode 100644
index 0000000000..e7daf1f603
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/databinding/winforms.md
@@ -0,0 +1,408 @@
+---
+title: Databinding with WinForms - EF6
+description: Databinding with WinForms in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/fundamentals/databinding/winforms
+---
+# Databinding with WinForms
+This step-by-step walkthrough shows how to bind POCO types to Window Forms (WinForms) controls in a “master-detail" form. The application uses Entity Framework to populate objects with data from the database, track changes, and persist data to the database.
+
+The model defines two types that participate in one-to-many relationship: Category (principal\\master) and Product (dependent\\detail). Then, the Visual Studio tools are used to bind the types defined in the model to the WinForms controls. The WinForms data-binding framework enables navigation between related objects: selecting rows in the master view causes the detail view to update with the corresponding child data.
+
+The screen shots and code listings in this walkthrough are taken from Visual Studio 2013 but you can complete this walkthrough with Visual Studio 2012 or Visual Studio 2010.
+
+## Pre-Requisites
+
+You need to have Visual Studio 2013, Visual Studio 2012 or Visual Studio 2010 installed to complete this walkthrough.
+
+If you are using Visual Studio 2010, you also have to install NuGet. For more information, see [Installing NuGet](https://docs.nuget.org/docs/start-here/installing-nuget).
+
+## Create the Application
+
+-   Open Visual Studio
+-   **File -&gt; New -&gt; Project….**
+-   Select **Windows** in the left pane and **Windows FormsApplication** in the right pane
+-   Enter **WinFormswithEFSample** as the name
+-   Select **OK**
+
+## Install the Entity Framework NuGet package
+
+-   In Solution Explorer, right-click on the **WinFormswithEFSample** project
+-   Select **Manage NuGet Packages…**
+-   In the Manage NuGet Packages dialog, Select the **Online** tab and choose the **EntityFramework** package
+-   Click **Install**  
+    > [!NOTE]
+    > In addition to the EntityFramework assembly a reference to System.ComponentModel.DataAnnotations is also added. If the project has a reference to System.Data.Entity, then it will be removed when the EntityFramework package is installed. The System.Data.Entity assembly is no longer used for Entity Framework 6 applications.
+
+## Implementing IListSource for Collections
+
+Collection properties must implement the IListSource interface to enable two-way data binding with sorting when using Windows Forms. To do this we are going to extend ObservableCollection to add IListSource functionality.
+
+-   Add an **ObservableListSource** class to the project:
+    -   Right-click on the project name
+    -   Select **Add -&gt; New Item**
+    -   Select **Class** and enter **ObservableListSource** for the class name
+-   Replace the code generated by default with the following code:
+
+*This class enables two-way data binding as well as sorting. The class derives from ObservableCollection&lt;T&gt; and adds an explicit implementation of IListSource. The GetList() method of IListSource is implemented to return an IBindingList implementation that stays in sync with the ObservableCollection. The IBindingList implementation generated by ToBindingList supports sorting. The ToBindingList extension method is defined in the EntityFramework assembly.*
+
+``` csharp
+    using System.Collections;
+    using System.Collections.Generic;
+    using System.Collections.ObjectModel;
+    using System.ComponentModel;
+    using System.Diagnostics.CodeAnalysis;
+    using System.Data.Entity;
+
+    namespace WinFormswithEFSample
+    {
+        public class ObservableListSource<T> : ObservableCollection<T>, IListSource
+            where T : class
+        {
+            private IBindingList _bindingList;
+
+            bool IListSource.ContainsListCollection { get { return false; } }
+
+            IList IListSource.GetList()
+            {
+                return _bindingList ?? (_bindingList = this.ToBindingList());
+            }
+        }
+    }
+```
+
+## Define a Model
+
+In this walkthrough you can chose to implement a model using Code First or the EF Designer. Complete one of the two following sections.
+
+### Option 1: Define a Model using Code First
+
+This section shows how to create a model and its associated database using Code First. Skip to the next section (**Option 2: Define a model using Database First)** if you would rather use Database First to reverse engineer your model from a database using the EF designer
+
+When using Code First development you usually begin by writing .NET Framework classes that define your conceptual (domain) model.
+
+-   Add a new **Product** class to project
+-   Replace the code generated by default with the following code:
+
+``` csharp
+    using System;
+    using System.Collections.Generic;
+    using System.Linq;
+    using System.Text;
+    using System.Threading.Tasks;
+
+    namespace WinFormswithEFSample
+    {
+        public class Product
+        {
+            public int ProductId { get; set; }
+            public string Name { get; set; }
+
+            public int CategoryId { get; set; }
+            public virtual Category Category { get; set; }
+        }
+    }
+```
+
+-   Add a **Category** class to the project.
+-   Replace the code generated by default with the following code:
+
+``` csharp
+    using System;
+    using System.Collections.Generic;
+    using System.Linq;
+    using System.Text;
+    using System.Threading.Tasks;
+
+    namespace WinFormswithEFSample
+    {
+        public class Category
+        {
+            private readonly ObservableListSource<Product> _products =
+                    new ObservableListSource<Product>();
+
+            public int CategoryId { get; set; }
+            public string Name { get; set; }
+            public virtual ObservableListSource<Product> Products { get { return _products; } }
+        }
+    }
+```
+
+In addition to defining entities, you need to define a class that derives from **DbContext** and exposes **DbSet&lt;TEntity&gt;** properties. The **DbSet** properties let the context know which types you want to include in the model. The **DbContext** and **DbSet** types are defined in the EntityFramework assembly.
+
+An instance of the DbContext derived type manages the entity objects during run time, which includes populating objects with data from a database, change tracking, and persisting data to the database.
+
+-   Add a new **ProductContext** class to the project.
+-   Replace the code generated by default with the following code:
+
+``` csharp
+    using System;
+    using System.Collections.Generic;
+    using System.Data.Entity;
+    using System.Linq;
+    using System.Text;
+
+    namespace WinFormswithEFSample
+    {
+        public class ProductContext : DbContext
+        {
+            public DbSet<Category> Categories { get; set; }
+            public DbSet<Product> Products { get; set; }
+        }
+    }
+```
+
+Compile the project.
+
+### Option 2: Define a model using Database First
+
+This section shows how to use Database First to reverse engineer your model from a database using the EF designer. If you completed the previous section (**Option 1: Define a model using Code First)**, then skip this section and go straight to the **Lazy Loading** section.
+
+#### Create an Existing Database
+
+Typically when you are targeting an existing database it will already be created, but for this walkthrough we need to create a database to access.
+
+The database server that is installed with Visual Studio is different depending on the version of Visual Studio you have installed:
+
+-   If you are using Visual Studio 2010 you'll be creating a SQL Express database.
+-   If you are using Visual Studio 2012 then you'll be creating a [LocalDB](https://msdn.microsoft.com/library/hh510202.aspx) database.
+
+Let's go ahead and generate the database.
+
+-   **View -&gt; Server Explorer**
+-   Right click on **Data Connections -&gt; Add Connection…**
+-   If you haven’t connected to a database from Server Explorer before you’ll need to select Microsoft SQL Server as the data source
+
+    ![Change Data Source](~/ef6/media/changedatasource.png)
+
+-   Connect to either LocalDB or SQL Express, depending on which one you have installed, and enter **Products** as the database name
+
+    ![Add Connection LocalDB](~/ef6/media/addconnectionlocaldb.png)
+
+    ![Add Connection Express](~/ef6/media/addconnectionexpress.png)
+
+-   Select **OK** and you will be asked if you want to create a new database, select **Yes**
+
+    ![Create Database](~/ef6/media/createdatabase.png)
+
+-   The new database will now appear in Server Explorer, right-click on it and select **New Query**
+-   Copy the following SQL into the new query, then right-click on the query and select **Execute**
+
+``` SQL
+    CREATE TABLE [dbo].[Categories] (
+        [CategoryId] [int] NOT NULL IDENTITY,
+        [Name] [nvarchar](max),
+        CONSTRAINT [PK_dbo.Categories] PRIMARY KEY ([CategoryId])
+    )
+
+    CREATE TABLE [dbo].[Products] (
+        [ProductId] [int] NOT NULL IDENTITY,
+        [Name] [nvarchar](max),
+        [CategoryId] [int] NOT NULL,
+        CONSTRAINT [PK_dbo.Products] PRIMARY KEY ([ProductId])
+    )
+
+    CREATE INDEX [IX_CategoryId] ON [dbo].[Products]([CategoryId])
+
+    ALTER TABLE [dbo].[Products] ADD CONSTRAINT [FK_dbo.Products_dbo.Categories_CategoryId] FOREIGN KEY ([CategoryId]) REFERENCES [dbo].[Categories] ([CategoryId]) ON DELETE CASCADE
+```
+
+#### Reverse Engineer Model
+
+We’re going to make use of Entity Framework Designer, which is included as part of Visual Studio, to create our model.
+
+-   **Project -&gt; Add New Item…**
+-   Select **Data** from the left menu and then **ADO.NET Entity Data Model**
+-   Enter **ProductModel** as the name and click **OK**
+-   This launches the **Entity Data Model Wizard**
+-   Select **Generate from Database** and click **Next**
+
+    ![Choose Model Contents](~/ef6/media/choosemodelcontents.png)
+
+-   Select the connection to the database you created in the first section, enter **ProductContext** as the name of the connection string and click **Next**
+
+    ![Choose Your Connection](~/ef6/media/chooseyourconnection.png)
+
+-   Click the checkbox next to ‘Tables’ to import all tables and click ‘Finish’
+
+    ![Choose Your Objects](~/ef6/media/chooseyourobjects.png)
+
+Once the reverse engineer process completes the new model is added to your project and opened up for you to view in the Entity Framework Designer. An App.config file has also been added to your project with the connection details for the database.
+
+#### Additional Steps in Visual Studio 2010
+
+If you are working in Visual Studio 2010 then you will need to update the EF designer to use EF6 code generation.
+
+-   Right-click on an empty spot of your model in the EF Designer and select **Add Code Generation Item…**
+-   Select **Online Templates** from the left menu and search for **DbContext**
+-   Select the **EF 6.x DbContext Generator for C\#,** enter **ProductsModel** as the name and click Add
+
+#### Updating code generation for data binding
+
+EF generates code from your model using T4 templates. The templates shipped with Visual Studio or downloaded from the Visual Studio gallery are intended for general purpose use. This means that the entities generated from these templates have simple ICollection&lt;T&gt; properties. However, when doing data binding it is desirable to have collection properties that implement IListSource. This is why we created the ObservableListSource class above and we are now going to modify the templates to make use of this class.
+
+-   Open the **Solution Explorer** and find **ProductModel.edmx** file
+-   Find the **ProductModel.tt** file which will be nested under the ProductModel.edmx file
+
+    ![Product Model Template](~/ef6/media/productmodeltemplate.png)
+
+-   Double-click on the ProductModel.tt file to open it in the Visual Studio editor
+-   Find and replace the two occurrences of “**ICollection**” with “**ObservableListSource**”. These are located at approximately lines 296 and 484.
+-   Find and replace the first occurrence of “**HashSet**” with “**ObservableListSource**”. This occurrence is located at approximately line 50. **Do not** replace the second occurrence of HashSet found later in the code.
+-   Save the ProductModel.tt file. This should cause the code for entities to be regenerated. If the code does not regenerate automatically, then right click on ProductModel.tt and choose “Run Custom Tool”.
+
+If you now open the Category.cs file (which is nested under ProductModel.tt) then you should see that the Products collection has the type **ObservableListSource&lt;Product&gt;**.
+
+Compile the project.
+
+## Lazy Loading
+
+The **Products** property on the **Category** class and **Category** property on the **Product** class are navigation properties. In Entity Framework, navigation properties provide a way to navigate a relationship between two entity types.
+
+EF gives you an option of loading related entities from the database automatically the first time you access the navigation property. With this type of loading (called lazy loading), be aware that the first time you access each navigation property a separate query will be executed against the database if the contents are not already in the context.
+
+When using POCO entity types, EF achieves lazy loading by creating instances of derived proxy types during runtime and then overriding virtual properties in your classes to add the loading hook. To get lazy loading of related objects, you must declare navigation property getters as **public** and **virtual** (**Overridable** in Visual Basic), and you class must not be **sealed** (**NotOverridable** in Visual Basic). When using Database First navigation properties are automatically made virtual to enable lazy loading. In the Code First section we chose to make the navigation properties virtual for the same reason
+
+## Bind Object to Controls
+
+Add the classes that are defined in the model as data sources for this WinForms application.
+
+-   From the main menu, select **Project -&gt; Add New Data Source …**
+    (in Visual Studio 2010, you need to select **Data -&gt; Add New Data Source…**)
+-   In the Choose a Data Source Type window, select **Object** and click **Next**
+-   In the Select the Data Objects dialog, unfold the **WinFormswithEFSample** two times and select **Category**
+    There is no need to select the Product data source, because we will get to it through the Product’s property on the Category data source.
+
+    ![Data Source](~/ef6/media/datasource.png)
+
+-   Click **Finish.**
+    If the Data Sources window is not showing up, select **View -&gt; Other Windows-&gt; Data Sources**
+-   Press the pin icon, so the Data Sources window does not auto hide. You may need to hit the refresh button if the window was already visible.
+
+    ![Data Source 2](~/ef6/media/datasource2.png)
+
+-   In Solution Explorer, double-click the **Form1.cs** file to open the main form in designer.
+-   Select the **Category** data source and drag it on the form. By default, a new DataGridView (**categoryDataGridView**) and Navigation toolbar controls are added to the designer. These controls are bound to the BindingSource (**categoryBindingSource**) and Binding Navigator (**categoryBindingNavigator**) components that are created as well.
+-   Edit the columns on the **categoryDataGridView**. We want to set the **CategoryId** column to read-only. The value for the **CategoryId** property is generated by the database after we save the data.
+    -   Right-click the DataGridView control and select Edit Columns…
+    -   Select the CategoryId column and set ReadOnly to True
+    -   Press OK
+-   Select Products from under the Category data source and drag it on the form. The productDataGridView and productBindingSource are added to the form.
+-   Edit the columns on the productDataGridView. We want to hide the CategoryId and Category columns and set ProductId to read-only. The value for the ProductId property is generated by the database after we save the data.
+    -   Right-click the DataGridView control and select **Edit Columns...**.
+    -   Select the **ProductId** column and set **ReadOnly** to **True**.
+    -   Select the **CategoryId** column and press the **Remove** button. Do the same with the **Category** column.
+    -   Press **OK**.
+
+    So far, we associated our DataGridView controls with BindingSource components in the designer. In the next section we will add code to the code behind to set categoryBindingSource.DataSource to the collection of entities that are currently tracked by DbContext. When we dragged-and-dropped Products from under the Category, the WinForms took care of setting up the productsBindingSource.DataSource property to categoryBindingSource and productsBindingSource.DataMember property to Products. Because of this binding, only the products that belong to the currently selected Category will be displayed in the productDataGridView.
+-   Enable the **Save** button on the Navigation toolbar by clicking the right mouse button and selecting **Enabled**.
+
+    ![Form 1 Designer](~/ef6/media/form1-designer.png)
+
+-   Add the event handler for the save button by double-clicking on the button. This will add the event handler and bring you to the code behind for the form. The code for the **categoryBindingNavigatorSaveItem\_Click** event handler will be added in the next section.
+
+## Add the Code that Handles Data Interaction
+
+We'll now add the code to use the ProductContext to perform data access. Update the code for the main form window as shown below.
+
+The code declares a long-running instance of ProductContext. The ProductContext object is used to query and save data to the database. The Dispose() method on the ProductContext instance is then called from the overridden OnClosing method. The code comments provide details about what the code does.
+
+``` csharp
+    using System;
+    using System.Collections.Generic;
+    using System.ComponentModel;
+    using System.Data;
+    using System.Drawing;
+    using System.Linq;
+    using System.Text;
+    using System.Threading.Tasks;
+    using System.Windows.Forms;
+    using System.Data.Entity;
+
+    namespace WinFormswithEFSample
+    {
+        public partial class Form1 : Form
+        {
+            ProductContext _context;
+            public Form1()
+            {
+                InitializeComponent();
+            }
+
+            protected override void OnLoad(EventArgs e)
+            {
+                base.OnLoad(e);
+                _context = new ProductContext();
+
+                // Call the Load method to get the data for the given DbSet
+                // from the database.
+                // The data is materialized as entities. The entities are managed by
+                // the DbContext instance.
+                _context.Categories.Load();
+
+                // Bind the categoryBindingSource.DataSource to
+                // all the Unchanged, Modified and Added Category objects that
+                // are currently tracked by the DbContext.
+                // Note that we need to call ToBindingList() on the
+                // ObservableCollection<TEntity> returned by
+                // the DbSet.Local property to get the BindingList<T>
+                // in order to facilitate two-way binding in WinForms.
+                this.categoryBindingSource.DataSource =
+                    _context.Categories.Local.ToBindingList();
+            }
+
+            private void categoryBindingNavigatorSaveItem_Click(object sender, EventArgs e)
+            {
+                this.Validate();
+
+                // Currently, the Entity Framework doesn’t mark the entities
+                // that are removed from a navigation property (in our example the Products)
+                // as deleted in the context.
+                // The following code uses LINQ to Objects against the Local collection
+                // to find all products and marks any that do not have
+                // a Category reference as deleted.
+                // The ToList call is required because otherwise
+                // the collection will be modified
+                // by the Remove call while it is being enumerated.
+                // In most other situations you can do LINQ to Objects directly
+                // against the Local property without using ToList first.
+                foreach (var product in _context.Products.Local.ToList())
+                {
+                    if (product.Category == null)
+                    {
+                        _context.Products.Remove(product);
+                    }
+                }
+
+                // Save the changes to the database.
+                this._context.SaveChanges();
+
+                // Refresh the controls to show the values         
+                // that were generated by the database.
+                this.categoryDataGridView.Refresh();
+                this.productsDataGridView.Refresh();
+            }
+
+            protected override void OnClosing(CancelEventArgs e)
+            {
+                base.OnClosing(e);
+                this._context.Dispose();
+            }
+        }
+    }
+```
+
+## Test the Windows Forms Application
+
+-   Compile and run the application and you can test out the functionality.
+
+    ![Form 1 Before Save](~/ef6/media/form1beforesave.png)
+
+-   After saving the store generated keys are shown on the screen.
+
+    ![Form 1 After Save](~/ef6/media/form1aftersave.png)
+
+-   If you used Code First, then you will also see that a **WinFormswithEFSample.ProductContext** database is created for you.
+
+    ![Server Object Explorer](~/ef6/media/serverobjexplorer.png)
diff --git a/entity-framework/ef6/fundamentals/databinding/wpf.md b/entity-framework/ef6/fundamentals/databinding/wpf.md
new file mode 100644
index 0000000000..755c2025e2
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/databinding/wpf.md
@@ -0,0 +1,403 @@
+---
+title: Databinding with WPF - EF6
+description: Databinding with WPF in Entity Framework 6
+author: SamMonoRT
+ms.date: 05/19/2020
+uid: ef6/fundamentals/databinding/wpf
+---
+# Databinding with WPF
+
+> [!IMPORTANT]
+> **This document is valid for WPF on the .NET Framework only**
+>
+> This document describes databinding for WPF on the .NET Framework. For new .NET projects, we recommend you use [EF Core](xref:core/index) instead of Entity Framework 6. The documentation for databinding in EF Core is here: [Getting Started with WPF](xref:core/get-started/wpf).
+
+This step-by-step walkthrough shows how to bind POCO types to WPF controls in a “master-detail" form. The application uses the Entity Framework APIs to populate objects with data from the database, track changes, and persist data to the database.
+
+The model defines two types that participate in one-to-many relationship: **Category** (principal\\master) and **Product** (dependent\\detail). Then, the Visual Studio tools are used to bind the types defined in the model to the WPF controls. The WPF data-binding framework enables navigation between related objects: selecting rows in the master view causes the detail view to update with the corresponding child data.
+
+The screen shots and code listings in this walkthrough are taken from Visual Studio 2013 but you can complete this walkthrough with Visual Studio 2012 or Visual Studio 2010.
+
+## Use the 'Object' Option for Creating WPF Data Sources
+
+With previous version of Entity Framework we used to recommend using the **Database** option when creating a new Data Source based on a model created with the EF Designer. This was because the designer would generate a context that derived from ObjectContext and entity classes that derived from EntityObject. Using the Database option would help you write the best code for interacting with this API surface.
+
+The EF Designers for Visual Studio 2012 and Visual Studio 2013 generate a context that derives from DbContext together with simple POCO entity classes. With Visual Studio 2010 we recommend swapping to a code generation template that uses DbContext as described later in this walkthrough.
+
+When using the DbContext API surface you should use the **Object** option when creating a new Data Source, as shown in this walkthrough.
+
+If needed, you can [revert to ObjectContext based code generation](xref:ef6/modeling/designer/codegen/legacy-objectcontext) for models created with the EF Designer.
+
+## Pre-Requisites
+
+You need to have Visual Studio 2013, Visual Studio 2012 or Visual Studio 2010 installed to complete this walkthrough.
+
+If you are using Visual Studio 2010, you also have to install NuGet. For more information, see [Installing NuGet](/nuget/install-nuget-client-tools).  
+
+## Create the Application
+
+- Open Visual Studio
+- **File -&gt; New -&gt; Project….**
+- Select **Windows** in the left pane and **WPFApplication** in the right pane
+- Enter **WPFwithEFSample** as the name
+- Select **OK**
+
+## Install the Entity Framework NuGet package
+
+- In Solution Explorer, right-click on the **WinFormswithEFSample** project
+- Select **Manage NuGet Packages…**
+- In the Manage NuGet Packages dialog, Select the **Online** tab and choose the **EntityFramework** package
+- Click **Install**  
+    >[!NOTE]
+    > In addition to the EntityFramework assembly a reference to System.ComponentModel.DataAnnotations is also added. If the project has a reference to System.Data.Entity, then it will be removed when the EntityFramework package is installed. The System.Data.Entity assembly is no longer used for Entity Framework 6 applications.
+
+## Define a Model
+
+In this walkthrough you can chose to implement a model using Code First or the EF Designer. Complete one of the two following sections.
+
+### Option 1: Define a Model using Code First
+
+This section shows how to create a model and its associated database using Code First. Skip to the next section (**Option 2: Define a model using Database First)** if you would rather use Database First to reverse engineer your model from a database using the EF designer
+
+When using Code First development you usually begin by writing .NET Framework classes that define your conceptual (domain) model.
+
+- Add a new class to the **WPFwithEFSample:**
+  - Right-click on the project name
+  - Select **Add**, then **New Item**
+  - Select **Class** and enter **Product** for the class name
+- Replace the **Product** class definition with the following code:
+
+``` csharp
+    namespace WPFwithEFSample
+    {
+        public class Product
+        {
+            public int ProductId { get; set; }
+            public string Name { get; set; }
+
+            public int CategoryId { get; set; }
+            public virtual Category Category { get; set; }
+        }
+    }
+```
+
+- Add a **Category** class with the following definition:
+
+``` csharp
+    using System.Collections.ObjectModel;
+
+    namespace WPFwithEFSample
+    {
+        public class Category
+        {
+            public Category()
+            {
+                this.Products = new ObservableCollection<Product>();
+            }
+
+            public int CategoryId { get; set; }
+            public string Name { get; set; }
+
+            public virtual ObservableCollection<Product> Products { get; private set; }
+        }
+    }
+```
+
+The **Products** property on the **Category** class and **Category** property on the **Product** class are navigation properties. In Entity Framework, navigation properties provide a way to navigate a relationship between two entity types.
+
+In addition to defining entities, you need to define a class that derives from DbContext and exposes DbSet&lt;TEntity&gt; properties. The DbSet&lt;TEntity&gt; properties let the context know which types you want to include in the model.
+
+An instance of the DbContext derived type manages the entity objects during run time, which includes populating objects with data from a database, change tracking, and persisting data to the database.
+
+- Add a new **ProductContext** class to the project with the following definition:
+
+``` csharp
+    using System.Data.Entity;
+
+    namespace WPFwithEFSample
+    {
+        public class ProductContext : DbContext
+        {
+            public DbSet<Category> Categories { get; set; }
+            public DbSet<Product> Products { get; set; }
+        }
+    }
+```
+
+Compile the project.
+
+### Option 2: Define a model using Database First
+
+This section shows how to use Database First to reverse engineer your model from a database using the EF designer. If you completed the previous section (**Option 1: Define a model using Code First)**, then skip this section and go straight to the **Lazy Loading** section.
+
+#### Create an Existing Database
+
+Typically when you are targeting an existing database it will already be created, but for this walkthrough we need to create a database to access.
+
+The database server that is installed with Visual Studio is different depending on the version of Visual Studio you have installed:
+
+- If you are using Visual Studio 2010 you'll be creating a SQL Express database.
+- If you are using Visual Studio 2012 then you'll be creating a [LocalDB](https://msdn.microsoft.com/library/hh510202.aspx) database.
+
+Let's go ahead and generate the database.
+
+- **View -&gt; Server Explorer**
+- Right click on **Data Connections -&gt; Add Connection…**
+- If you haven’t connected to a database from Server Explorer before you’ll need to select Microsoft SQL Server as the data source
+
+    ![Change Data Source](~/ef6/media/changedatasource.png)
+
+- Connect to either LocalDB or SQL Express, depending on which one you have installed, and enter **Products** as the database name
+
+    ![Add Connection LocalDB](~/ef6/media/addconnectionlocaldb.png)
+
+    ![Add Connection Express](~/ef6/media/addconnectionexpress.png)
+
+- Select **OK** and you will be asked if you want to create a new database, select **Yes**
+
+    ![Create Database](~/ef6/media/createdatabase.png)
+
+- The new database will now appear in Server Explorer, right-click on it and select **New Query**
+- Copy the following SQL into the new query, then right-click on the query and select **Execute**
+
+``` SQL
+    CREATE TABLE [dbo].[Categories] (
+        [CategoryId] [int] NOT NULL IDENTITY,
+        [Name] [nvarchar](max),
+        CONSTRAINT [PK_dbo.Categories] PRIMARY KEY ([CategoryId])
+    )
+
+    CREATE TABLE [dbo].[Products] (
+        [ProductId] [int] NOT NULL IDENTITY,
+        [Name] [nvarchar](max),
+        [CategoryId] [int] NOT NULL,
+        CONSTRAINT [PK_dbo.Products] PRIMARY KEY ([ProductId])
+    )
+
+    CREATE INDEX [IX_CategoryId] ON [dbo].[Products]([CategoryId])
+
+    ALTER TABLE [dbo].[Products] ADD CONSTRAINT [FK_dbo.Products_dbo.Categories_CategoryId] FOREIGN KEY ([CategoryId]) REFERENCES [dbo].[Categories] ([CategoryId]) ON DELETE CASCADE
+```
+
+#### Reverse Engineer Model
+
+We’re going to make use of Entity Framework Designer, which is included as part of Visual Studio, to create our model.
+
+- **Project -&gt; Add New Item…**
+- Select **Data** from the left menu and then **ADO.NET Entity Data Model**
+- Enter **ProductModel** as the name and click **OK**
+- This launches the **Entity Data Model Wizard**
+- Select **Generate from Database** and click **Next**
+
+    ![Choose Model Contents](~/ef6/media/choosemodelcontents.png)
+
+- Select the connection to the database you created in the first section, enter **ProductContext** as the name of the connection string and click **Next**
+
+    ![Choose Your Connection](~/ef6/media/chooseyourconnection.png)
+
+- Click the checkbox next to ‘Tables’ to import all tables and click ‘Finish’
+
+    ![Choose Your Objects](~/ef6/media/chooseyourobjects.png)
+
+Once the reverse engineer process completes the new model is added to your project and opened up for you to view in the Entity Framework Designer. An App.config file has also been added to your project with the connection details for the database.
+
+#### Additional Steps in Visual Studio 2010
+
+If you are working in Visual Studio 2010 then you will need to update the EF designer to use EF6 code generation.
+
+- Right-click on an empty spot of your model in the EF Designer and select **Add Code Generation Item…**
+- Select **Online Templates** from the left menu and search for **DbContext**
+- Select the **EF 6.x DbContext Generator for C\#,** enter **ProductsModel** as the name and click Add
+
+#### Updating code generation for data binding
+
+EF generates code from your model using T4 templates. The templates shipped with Visual Studio or downloaded from the Visual Studio gallery are intended for general purpose use. This means that the entities generated from these templates have simple ICollection&lt;T&gt; properties. However, when doing data binding using WPF it is desirable to use **ObservableCollection** for collection properties so that WPF can keep track of changes made to the collections. To this end we will to modify the templates to use ObservableCollection.
+
+- Open the **Solution Explorer** and find **ProductModel.edmx** file
+- Find the **ProductModel.tt** file which will be nested under the ProductModel.edmx file
+
+    ![WPF Product Model Template](~/ef6/media/wpfproductmodeltemplate.png)
+
+- Double-click on the ProductModel.tt file to open it in the Visual Studio editor
+- Find and replace the two occurrences of “**ICollection**” with “**ObservableCollection**”. These are located approximately at lines 296 and 484.
+- Find and replace the first occurrence of “**HashSet**” with “**ObservableCollection**”. This occurrence is located approximately at line 50. **Do not** replace the second occurrence of HashSet found later in the code.
+- Find and replace the only occurrence of “**System.Collections.Generic**” with “**System.Collections.ObjectModel**”. This is located approximately at line 424.
+- Save the ProductModel.tt file. This should cause the code for entities to be regenerated. If the code does not regenerate automatically, then right click on ProductModel.tt and choose “Run Custom Tool”.
+
+If you now open the Category.cs file (which is nested under ProductModel.tt) then you should see that the Products collection has the type **ObservableCollection&lt;Product&gt;**.
+
+Compile the project.
+
+## Lazy Loading
+
+The **Products** property on the **Category** class and **Category** property on the **Product** class are navigation properties. In Entity Framework, navigation properties provide a way to navigate a relationship between two entity types.
+
+EF gives you an option of loading related entities from the database automatically the first time you access the navigation property. With this type of loading (called lazy loading), be aware that the first time you access each navigation property a separate query will be executed against the database if the contents are not already in the context.
+
+When using POCO entity types, EF achieves lazy loading by creating instances of derived proxy types during runtime and then overriding virtual properties in your classes to add the loading hook. To get lazy loading of related objects, you must declare navigation property getters as **public** and **virtual** (**Overridable** in Visual Basic), and your class must not be **sealed** (**NotOverridable** in Visual Basic). When using Database First navigation properties are automatically made virtual to enable lazy loading. In the Code First section we chose to make the navigation properties virtual for the same reason.
+
+## Bind Object to Controls
+
+Add the classes that are defined in the model as data sources for this WPF application.
+
+- Double-click **MainWindow.xaml** in Solution Explorer to open the main form
+- From the main menu, select **Project -&gt; Add New Data Source …**
+    (in Visual Studio 2010, you need to select **Data -&gt; Add New Data Source…**)
+- In the Choose a Data Source Typewindow, select **Object** and click **Next**
+- In the Select the Data Objects dialog, unfold the **WPFwithEFSample** two times and select **Category**  
+    *There is no need to select the **Product** data source, because we will get to it through the **Product**’s property on the **Category** data source*  
+
+    ![Select Data Objects](~/ef6/media/selectdataobjects.png)
+
+- Click **Finish.**
+- The Data Sources window is opened next to the MainWindow.xaml window
+    *If the Data Sources window is not showing up, select **View -&gt; Other Windows-&gt; Data Sources***
+- Press the pin icon, so the Data Sources window does not auto hide. You may need to hit the refresh button if the window was already visible.
+
+    ![Data Sources](~/ef6/media/datasources.png)
+
+- Select the **Category** data source and drag it on the form.
+
+The following happened when we dragged this source:
+
+- The **categoryViewSource** resource and the **categoryDataGrid** control were added to XAML
+- The DataContext property on the parent Grid element was set to "{StaticResource **categoryViewSource** }". The **categoryViewSource** resource serves as a binding source for the outer\\parent Grid element. The inner Grid elements then inherit the DataContext value from the parent Grid (the categoryDataGrid’s ItemsSource property is set to "{Binding}")
+
+``` xml
+    <Window.Resources>
+        <CollectionViewSource x:Key="categoryViewSource"
+                                d:DesignSource="{d:DesignInstance {x:Type local:Category}, CreateList=True}"/>
+    </Window.Resources>
+    <Grid DataContext="{StaticResource categoryViewSource}">
+        <DataGrid x:Name="categoryDataGrid" AutoGenerateColumns="False" EnableRowVirtualization="True"
+                    ItemsSource="{Binding}" Margin="13,13,43,191"
+                    RowDetailsVisibilityMode="VisibleWhenSelected">
+            <DataGrid.Columns>
+                <DataGridTextColumn x:Name="categoryIdColumn" Binding="{Binding CategoryId}"
+                                    Header="Category Id" Width="SizeToHeader"/>
+                <DataGridTextColumn x:Name="nameColumn" Binding="{Binding Name}"
+                                    Header="Name" Width="SizeToHeader"/>
+            </DataGrid.Columns>
+        </DataGrid>
+    </Grid>
+```
+
+## Adding a Details Grid
+
+Now that we have a grid to display Categories let's add a details grid to display the associated Products.
+
+- Select the **Products** property from under the **Category** data source and drag it on the form.
+  - The **categoryProductsViewSource** resource and **productDataGrid** grid are added to XAML
+  - The binding path for this resource is set to Products
+  - WPF data-binding framework ensures that only Products related to the selected Category show up in **productDataGrid**
+- From the Toolbox, drag **Button** on to the form. Set the **Name** property to **buttonSave** and the **Content** property to **Save**.
+
+The form should look similar to this:
+
+![Designer Form](~/ef6/media/designer.png)
+
+## Add Code that Handles Data Interaction
+
+It's time to add some event handlers to the main window.
+
+- In the XAML window, click on the **&lt;Window** element, this selects the main window
+- In the **Properties** window choose **Events** at the top right, then double-click the text box to right of the **Loaded** label
+
+    ![Main Window Properties](~/ef6/media/mainwindowproperties.png)
+
+- Also add the **Click** event for the **Save** button by double-clicking the Save button in the designer.
+
+This brings you to the code behind for the form, we'll now edit the code to use the ProductContext to perform data access. Update the code for the MainWindow as shown below.
+
+The code declares a long-running instance of **ProductContext**. The **ProductContext** object is used to query and save data to the database. The **Dispose()** on the **ProductContext** instance is then called from the overridden **OnClosing** method. The code comments provide details about what the code does.
+
+``` csharp
+    using System.Data.Entity;
+    using System.Linq;
+    using System.Windows;
+
+    namespace WPFwithEFSample
+    {
+        public partial class MainWindow : Window
+        {
+            private ProductContext _context = new ProductContext();
+            public MainWindow()
+            {
+                InitializeComponent();
+            }
+
+            private void Window_Loaded(object sender, RoutedEventArgs e)
+            {
+                System.Windows.Data.CollectionViewSource categoryViewSource =
+                    ((System.Windows.Data.CollectionViewSource)(this.FindResource("categoryViewSource")));
+
+                // Load is an extension method on IQueryable,
+                // defined in the System.Data.Entity namespace.
+                // This method enumerates the results of the query,
+                // similar to ToList but without creating a list.
+                // When used with Linq to Entities this method
+                // creates entity objects and adds them to the context.
+                _context.Categories.Load();
+
+                // After the data is loaded call the DbSet<T>.Local property
+                // to use the DbSet<T> as a binding source.
+                categoryViewSource.Source = _context.Categories.Local;
+            }
+
+            private void buttonSave_Click(object sender, RoutedEventArgs e)
+            {
+                // When you delete an object from the related entities collection
+                // (in this case Products), the Entity Framework doesn’t mark
+                // these child entities as deleted.
+                // Instead, it removes the relationship between the parent and the child
+                // by setting the parent reference to null.
+                // So we manually have to delete the products
+                // that have a Category reference set to null.
+
+                // The following code uses LINQ to Objects
+                // against the Local collection of Products.
+                // The ToList call is required because otherwise the collection will be modified
+                // by the Remove call while it is being enumerated.
+                // In most other situations you can use LINQ to Objects directly
+                // against the Local property without using ToList first.
+                foreach (var product in _context.Products.Local.ToList())
+                {
+                    if (product.Category == null)
+                    {
+                        _context.Products.Remove(product);
+                    }
+                }
+
+                _context.SaveChanges();
+                // Refresh the grids so the database generated values show up.
+                this.categoryDataGrid.Items.Refresh();
+                this.productsDataGrid.Items.Refresh();
+            }
+
+            protected override void OnClosing(System.ComponentModel.CancelEventArgs e)
+            {
+                base.OnClosing(e);
+                this._context.Dispose();
+            }
+        }
+
+    }
+```
+
+## Test the WPF Application
+
+- Compile and run the application. If you used Code First, then you will see that a **WPFwithEFSample.ProductContext** database is created for you.
+- Enter a category name in the top grid and product names in the bottom grid
+    *Do not enter anything in ID columns, because the primary key is generated by the database*
+
+    ![Main Window with new categories and products](~/ef6/media/screen1.png)
+
+- Press the **Save** button to save the data to the database
+
+After the call to DbContext’s **SaveChanges()**, the IDs are populated with the database generated values. Because we called **Refresh()** after **SaveChanges()** the **DataGrid** controls are updated with the new values as well.
+
+![Main Window with IDs populated](~/ef6/media/screen2.png)
+
+## Additional Resources
+
+To learn more about data binding to collections using WPF, see [this topic](/dotnet/framework/wpf/data/data-binding-overview#binding-to-collections) in the WPF documentation.  
diff --git a/entity-framework/ef6/fundamentals/disconnected-entities/index.md b/entity-framework/ef6/fundamentals/disconnected-entities/index.md
new file mode 100644
index 0000000000..5ff7b2e0ee
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/disconnected-entities/index.md
@@ -0,0 +1,29 @@
+---
+title: Working with disconnected entities - EF6
+description: Working with disconnected entities in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/fundamentals/disconnected-entities/index
+---
+# Working with disconnected entities
+
+In an Entity Framework-based application, a context class is responsible for detecting changes applied to tracked entities. Calling the SaveChanges method persists the changes tracked by the context to the database. When working with n-tier applications, entity objects are usually modified while disconnected from the context, and you must decide how to track changes and report those changes back to the context. This topic discusses different options that are available when using Entity Framework with disconnected entities.
+
+## Web service frameworks
+
+Web services technologies typically support patterns that can be used to persist changes on individual disconnected objects. For example, ASP.NET Web API allows you to code controller actions that can include calls to EF to persist changes made to an object on a database. In fact, the Web API tooling in Visual Studio makes it easy to scaffold a Web API controller from your Entity Framework 6 model. For more information, see [using Web API with Entity Framework 6](/aspnet/web-api/overview/data/using-web-api-with-entity-framework/).
+
+Historically, there have been several other Web services technologies that offered integration with Entity Framework, like [WCF Data Services](/dotnet/framework/data/wcf/create-a-data-service-using-an-adonet-ef-data-wcf) and [RIA Services](/previous-versions/dotnet/wcf-ria/ee707344(v=vs.91)).
+
+## Low-level EF APIs
+
+If you don't want to use an existing n-tier solution, or if you want to customize what happens inside a controller action in a Web API services, Entity Framework provides APIs that allow you to apply changes made on a disconnected tier. For more information, see [Add, Attach, and entity state](xref:ef6/saving/change-tracking/entity-state).  
+
+## Self-Tracking Entities  
+
+Tracking changes on arbitrary graphs of entities while disconnected from the EF context is a hard problem. One of the attempts to solve it was the Self-Tracking Entities code generation template. This template generates entity classes that contain logic to track changes made on a disconnected tier as state in the entities themselves. A set of extension methods is also generated to apply those changes to a context.
+
+This template can be used with models created using the EF Designer, but can not be used with Code First models. For more information, see [Self-Tracking Entities](xref:ef6/fundamentals/disconnected-entities/self-tracking-entities/index).  
+
+> [!IMPORTANT]
+> We no longer recommend using the self-tracking-entities template. It will only continue to be available to support existing applications. If your application requires working with disconnected graphs of entities, consider other alternatives such as [Trackable Entities](https://trackableentities.github.io/), which is a technology similar to Self-Tracking-Entities that is more actively developed by the community, or writing custom code using the low-level change tracking APIs.
diff --git a/entity-framework/ef6/fundamentals/disconnected-entities/self-tracking-entities/index.md b/entity-framework/ef6/fundamentals/disconnected-entities/self-tracking-entities/index.md
new file mode 100644
index 0000000000..417a85c22d
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/disconnected-entities/self-tracking-entities/index.md
@@ -0,0 +1,50 @@
+---
+title: Self-tracking entities - EF6
+description: Self-tracking entities in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/fundamentals/disconnected-entities/self-tracking-entities/index
+---
+# Self-tracking entities
+
+> [!IMPORTANT]
+> We no longer recommend using the self-tracking-entities template. It will only continue to be available to support existing applications. If your application requires working with disconnected graphs of entities, consider other alternatives such as [Trackable Entities](https://trackableentities.github.io/), which is a technology similar to Self-Tracking-Entities that is more actively developed by the community, or writing custom code using the low-level change tracking APIs.
+
+In an Entity Framework-based application, a context is responsible for tracking changes in your objects. You then use the SaveChanges method to persist the changes to the database. When working with N-Tier applications, the entity objects are usually disconnected from the context and you must decide how to track changes and report those changes back to the context. Self-Tracking Entities (STEs) can help you track changes in any tier and then replay these changes into a context to be saved.  
+
+Use STEs only if the context is not available on a tier where the changes to the object graph are made. If the context is available, there is no need to use STEs because the context will take care of tracking changes.  
+
+This template item generates two .tt (text template) files:  
+
+- The **\<model name\>.tt** file generates the entity types and a helper class that contains the change-tracking logic that is used by self-tracking entities and the extension methods that allow setting state on self-tracking entities.  
+- The **\<model name\>.Context.tt** file generates a derived context and an extension class that contains **ApplyChanges** methods for the **ObjectContext** and **ObjectSet** classes. These methods examine the change-tracking information that is contained in the graph of self-tracking entities to infer the set of operations that must be performed to save the changes in the database.  
+
+## Get Started  
+
+To get started, visit the [Self-Tracking Entities Walkthrough](xref:ef6/fundamentals/disconnected-entities/self-tracking-entities/walkthrough) page.  
+
+## Functional Considerations When Working with Self-Tracking Entities  
+> [!IMPORTANT]
+> We no longer recommend using the self-tracking-entities template. It will only continue to be available to support existing applications. If your application requires working with disconnected graphs of entities, consider other alternatives such as [Trackable Entities](https://trackableentities.github.io/), which is a technology similar to Self-Tracking-Entities that is more actively developed by the community, or writing custom code using the low-level change tracking APIs.
+
+Consider the following when working with self-tracking entities:  
+
+- Make sure that your client project has a reference to the assembly containing the entity types. If you add only the service reference to the client project, the client project will use the WCF proxy types and not the actual self-tracking entity types. This means that you will not get the automated notification features that manage the tracking of the entities on the client. If you intentionally do not want to include the entity types, you will have to manually set change-tracking information on the client for the changes to be sent back to the service.  
+- Calls to the service operation should be stateless and create a new instance of object context. We also recommend that you create object context in a **using** block.  
+- When you send the graph that was modified on the client to the service and then intend to continue working with the same graph on the client, you have to manually iterate through the graph and call the **AcceptChanges** method on each object to reset the change tracker.  
+
+    > If objects in your graph contain properties with database-generated values (for example, identity or concurrency values), Entity Framework will replace values of these properties with the database-generated values after the **SaveChanges** method is called. You can implement your service operation to return saved objects or a list of generated property values for the objects back to the client. The client would then need to replace the object instances or object property values with the objects or property values returned from the service operation.  
+- Merging graphs from multiple service requests may introduce objects with duplicate key values in the resulting graph. Entity Framework does not remove the objects with duplicate keys when you call the **ApplyChanges** method but instead throws an exception. To avoid having graphs with duplicate key values follow one of the patterns described in the following blog: [Self-Tracking Entities: ApplyChanges and duplicate entities](https://go.microsoft.com/fwlink/?LinkID=205119&clcid=0x409).  
+- When you change the relationship between objects by setting the foreign key property, the reference navigation property is set to null and not synchronized to the appropriate principal entity on the client. After the graph is attached to the object context (for example, after you call the **ApplyChanges** method), the foreign key properties and navigation properties are synchronized.  
+
+    > Not having a reference navigation property synchronized with the appropriate principal object could be an issue if you have specified cascade delete on the foreign key relationship. If you delete the principal, the delete will not be propagated to the dependent objects. If you have cascade deletes specified, use navigation properties to change relationships instead of setting the foreign key property.  
+- Self-tracking entities are not enabled to perform lazy loading.  
+- Binary serialization and serialization to ASP.NET state management objects is not supported by self-tracking entities. However, you can customize the template to add the binary serialization support. For more information, see [Using Binary Serialization and ViewState with Self-Tracking Entities](https://go.microsoft.com/fwlink/?LinkId=199208).  
+
+## Security Considerations  
+
+The following security considerations should be taken into account when working with self-tracking entities:  
+
+- A service should not trust requests to retrieve or update data from a non-trusted client or through a non-trusted channel. A client must be authenticated: a secure channel or message envelope should be used. Clients' requests to update or retrieve data must be validated to ensure they conform to expected and legitimate changes for the given scenario.  
+- Avoid using sensitive information as entity keys (for example, social security numbers). This mitigates the possibility of inadvertently serializing sensitive information in the self-tracking entity graphs to a client that is not fully trusted. With independent associations, the original key of an entity that is related to the one that is being serialized might be sent to the client as well.  
+- To avoid propagating exception messages that contain sensitive data to the client tier, calls to **ApplyChanges** and **SaveChanges** on the server tier should be wrapped in exception-handling code.  
diff --git a/entity-framework/ef6/fundamentals/disconnected-entities/self-tracking-entities/walkthrough.md b/entity-framework/ef6/fundamentals/disconnected-entities/self-tracking-entities/walkthrough.md
new file mode 100644
index 0000000000..cabbc56cd1
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/disconnected-entities/self-tracking-entities/walkthrough.md
@@ -0,0 +1,551 @@
+---
+title: Self-Tracking Entities Walkthrough - EF6
+description: Self-tracking entities walkthrough for Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/fundamentals/disconnected-entities/self-tracking-entities/walkthrough
+ms.custom: sfi-ropc-nochange
+---
+# Self-Tracking Entities Walkthrough
+> [!IMPORTANT]
+> We no longer recommend using the self-tracking-entities template. It will only continue to be available to support existing applications. If your application requires working with disconnected graphs of entities, consider other alternatives such as [Trackable Entities](https://trackableentities.github.io/), which is a technology similar to Self-Tracking-Entities that is more actively developed by the community, or writing custom code using the low-level change tracking APIs.
+
+This walkthrough demonstrates the scenario in which a Windows Communication Foundation (WCF) service exposes an operation that returns an entity graph. Next, a client application manipulates that graph and submits the modifications to a service operation that validates and saves the updates to a database using Entity Framework.
+
+Before completing this walkthrough make sure you read the [Self-Tracking Entities](xref:ef6/fundamentals/disconnected-entities/self-tracking-entities/index) page.
+
+This walkthrough completes the following actions:
+
+-   Creates a database to access.
+-   Creates a class library that contains the model.
+-   Swaps to the Self-Tracking Entity Generator template.
+-   Moves the entity classes to a separate project.
+-   Creates a WCF service that exposes operations to query and save entities.
+-   Creates client applications (Console and WPF) that consume the service.
+
+We'll use Database First in this walkthrough but the same techniques apply equally to Model First.
+
+## Pre-Requisites
+
+To complete this walkthrough you will need a recent version of Visual Studio.
+
+## Create a Database
+
+The database server that is installed with Visual Studio is different depending on the version of Visual Studio you have installed:
+
+-   If you are using Visual Studio 2012 then you'll be creating a LocalDB database.
+-   If you are using Visual Studio 2010 you'll be creating a SQL Express database.
+
+Let's go ahead and generate the database.
+
+-   Open Visual Studio
+-   **View -&gt; Server Explorer**
+-   Right click on **Data Connections -&gt; Add Connection…**
+-   If you haven’t connected to a database from Server Explorer before you’ll need to select **Microsoft SQL Server** as the data source
+-   Connect to either LocalDB or SQL Express, depending on which one you have installed
+-   Enter **STESample** as the database name
+-   Select **OK** and you will be asked if you want to create a new database, select **Yes**
+-   The new database will now appear in Server Explorer
+-   If you are using Visual Studio 2012
+    -   Right-click on the database in Server Explorer and select **New Query**
+    -   Copy the following SQL into the new query, then right-click on the query and select **Execute**
+-   If you are using Visual Studio 2010
+    -   Select **Data -&gt; Transact SQL Editor -&gt; New Query Connection...**
+    -   Enter **.\\SQLEXPRESS** as the server name and click **OK**
+    -   Select the **STESample** database from the drop down at the top of the query editor
+    -   Copy the following SQL into the new query, then right-click on the query and select **Execute SQL**
+
+``` SQL
+    CREATE TABLE [dbo].[Blogs] (
+        [BlogId] INT IDENTITY (1, 1) NOT NULL,
+        [Name] NVARCHAR (200) NULL,
+        [Url]  NVARCHAR (200) NULL,
+        CONSTRAINT [PK_dbo.Blogs] PRIMARY KEY CLUSTERED ([BlogId] ASC)
+    );
+
+    CREATE TABLE [dbo].[Posts] (
+        [PostId] INT IDENTITY (1, 1) NOT NULL,
+        [Title] NVARCHAR (200) NULL,
+        [Content] NTEXT NULL,
+        [BlogId] INT NOT NULL,
+        CONSTRAINT [PK_dbo.Posts] PRIMARY KEY CLUSTERED ([PostId] ASC),
+        CONSTRAINT [FK_dbo.Posts_dbo.Blogs_BlogId] FOREIGN KEY ([BlogId]) REFERENCES [dbo].[Blogs] ([BlogId]) ON DELETE CASCADE
+    );
+
+    SET IDENTITY_INSERT [dbo].[Blogs] ON
+    INSERT INTO [dbo].[Blogs] ([BlogId], [Name], [Url]) VALUES (1, N'ADO.NET Blog', N'blogs.msdn.com/adonet')
+    SET IDENTITY_INSERT [dbo].[Blogs] OFF
+    INSERT INTO [dbo].[Posts] ([Title], [Content], [BlogId]) VALUES (N'Intro to EF', N'Interesting stuff...', 1)
+    INSERT INTO [dbo].[Posts] ([Title], [Content], [BlogId]) VALUES (N'What is New', N'More interesting stuff...', 1)
+```
+
+## Create the Model
+
+First up, we need a project to put the model in.
+
+-   **File -&gt; New -&gt; Project...**
+-   Select **Visual C\#** from the left pane and then **Class Library**
+-   Enter **STESample** as the name and click **OK**
+
+Now we'll create a simple model in the EF Designer to access our database:
+
+-   **Project -&gt; Add New Item...**
+-   Select **Data** from the left pane and then **ADO.NET Entity Data Model**
+-   Enter **BloggingModel** as the name and click **OK**
+-   Select **Generate from database** and click **Next**
+-   Enter the connection information for the database that you created in the previous section
+-   Enter **BloggingContext** as the name for the connection string and click **Next**
+-   Check the box next to **Tables** and click **Finish**
+
+## Swap to STE Code Generation
+
+Now we need to disable the default code generation and swap to Self-Tracking Entities.
+
+### If you are using Visual Studio 2012
+
+-   Expand **BloggingModel.edmx** in **Solution Explorer** and delete the **BloggingModel.tt** and **BloggingModel.Context.tt**
+    *This will disable the default code generation*
+-   Right-click an empty area on the EF Designer surface and select **Add Code Generation Item...**
+-   Select **Online** from the left pane and search for **STE Generator**
+-   Select the **STE Generator for C\#** template, enter **STETemplate** as the name and click **Add**
+-   The **STETemplate.tt** and **STETemplate.Context.tt** files are added nested under the BloggingModel.edmx file
+
+### If you are using Visual Studio 2010
+
+-   Right-click an empty area on the EF Designer surface and select **Add Code Generation Item...**
+-   Select **Code** from the left pane and then **ADO.NET Self-Tracking Entity Generator**
+-   Enter **STETemplate** as the name and click **Add**
+-   The **STETemplate.tt** and **STETemplate.Context.tt** files are added directly to your project
+
+## Move Entity Types into Separate Project
+
+To use Self-Tracking Entities our client application needs access to the entity classes generated from our model. Because we don't want to expose the whole model to the client application we're going to move the entity classes into a separate project.
+
+The first step is to stop generating entity classes in the existing project:
+
+-   Right-click on **STETemplate.tt** in **Solution Explorer** and select **Properties**
+-   In the **Properties** window clear **TextTemplatingFileGenerator** from the **CustomTool** property
+-   Expand **STETemplate.tt** in **Solution Explorer** and delete all files nested under it
+
+Next, we are going to add a new project and generate the entity classes in it
+
+-   **File -&gt; Add -&gt; Project...**
+-   Select **Visual C\#** from the left pane and then **Class Library**
+-   Enter **STESample.Entities** as the name and click **OK**
+-   **Project -&gt; Add Existing Item...**
+-   Navigate to the **STESample** project folder
+-   Select to view **All Files (\*.\*)**
+-   Select the **STETemplate.tt** file
+-   Click on the drop down arrow next to the **Add** button and select **Add As Link**
+
+    ![Add Linked Template](~/ef6/media/addlinkedtemplate.png)
+
+We're also going to make sure the entity classes get generated in the same namespace as the context. This just reduces the number of using statements we need to add throughout our application.
+
+-   Right-click on the linked **STETemplate.tt** in **Solution Explorer** and select **Properties**
+-   In the **Properties** window set **Custom Tool Namespace** to **STESample**
+
+The code generated by the STE template will need a reference to **System.Runtime.Serialization** in order to compile. This library is needed for the WCF **DataContract** and **DataMember** attributes that are used on the serializable entity types.
+
+-   Right click on the **STESample.Entities** project in **Solution Explorer** and select **Add Reference...**
+    -   In Visual Studio 2012 - check the box next to **System.Runtime.Serialization** and click **OK**
+    -   In Visual Studio 2010 - select **System.Runtime.Serialization** and click **OK**
+
+Finally, the project with our context in it will need a reference to the entity types.
+
+-   Right click on the **STESample** project in **Solution Explorer** and select **Add Reference...**
+    -   In Visual Studio 2012 - select **Solution** from the left pane, check the box next to **STESample.Entities** and click **OK**
+    -   In Visual Studio 2010 - select the **Projects** tab, select **STESample.Entities** and click **OK**
+
+>[!NOTE]
+> Another option for moving the entity types to a separate project is to move the template file, rather than linking it from its default location. If you do this, you will need to update the **inputFile** variable in the template to provide the relative path to the edmx file (in this example that would be **..\\BloggingModel.edmx**).
+
+## Create a WCF Service
+
+Now it's time to add a WCF Service to expose our data, we'll start by creating the project.
+
+-   **File -&gt; Add -&gt; Project...**
+-   Select **Visual C\#** from the left pane and then **WCF Service Application**
+-   Enter **STESample.Service** as the name and click **OK**
+-   Add a reference to the **System.Data.Entity** assembly
+-   Add a reference to the **STESample** and **STESample.Entities** projects
+
+We need to copy the EF connection string to this project so that it is found at runtime.
+
+-   Open the **App.Config** file for the **STESample **project and copy the **connectionStrings** element
+-   Paste the **connectionStrings** element as a child element of the **configuration** element of the **Web.Config** file in the **STESample.Service** project
+
+Now it's time to implement the actual service.
+
+-   Open **IService1.cs** and replace the contents with the following code
+
+``` csharp
+    using System.Collections.Generic;
+    using System.ServiceModel;
+
+    namespace STESample.Service
+    {
+        [ServiceContract]
+        public interface IService1
+        {
+            [OperationContract]
+            List<Blog> GetBlogs();
+
+            [OperationContract]
+            void UpdateBlog(Blog blog);
+        }
+    }
+```
+
+-   Open **Service1.svc** and replace the contents with the following code
+
+``` csharp
+    using System;
+    using System.Collections.Generic;
+    using System.Data;
+    using System.Linq;
+
+    namespace STESample.Service
+    {
+        public class Service1 : IService1
+        {
+            /// <summary>
+            /// Gets all the Blogs and related Posts.
+            /// </summary>
+            public List<Blog> GetBlogs()
+            {
+                using (BloggingContext context = new BloggingContext())
+                {
+                    return context.Blogs.Include("Posts").ToList();
+                }
+            }
+
+            /// <summary>
+            /// Updates Blog and its related Posts.
+            /// </summary>
+            public void UpdateBlog(Blog blog)
+            {
+                using (BloggingContext context = new BloggingContext())
+                {
+                    try
+                    {
+                        // TODO: Perform validation on the updated order before applying the changes.
+
+                        // The ApplyChanges method examines the change tracking information
+                        // contained in the graph of self-tracking entities to infer the set of operations
+                        // that need to be performed to reflect the changes in the database.
+                        context.Blogs.ApplyChanges(blog);
+                        context.SaveChanges();
+
+                    }
+                    catch (UpdateException)
+                    {
+                        // To avoid propagating exception messages that contain sensitive data to the client tier
+                        // calls to ApplyChanges and SaveChanges should be wrapped in exception handling code.
+                        throw new InvalidOperationException("Failed to update. Try your request again.");
+                    }
+                }
+            }        
+        }
+    }
+```
+
+## Consume the Service from a Console Application
+
+Let's create a console application that uses our service.
+
+-   **File -&gt; New -&gt; Project...**
+-   Select **Visual C\#** from the left pane and then **Console Application**
+-   Enter **STESample.ConsoleTest** as the name and click **OK**
+-   Add a reference to the **STESample.Entities** project
+
+We need a service reference to our WCF service
+
+-   Right-click the **STESample.ConsoleTest** project in **Solution Explorer** and select **Add Service Reference...**
+-   Click **Discover**
+-   Enter **BloggingService** as the namespace and click **OK**
+
+Now we can write some code to consume the service.
+
+-   Open **Program.cs** and replace the contents with the following code.
+
+``` csharp
+    using STESample.ConsoleTest.BloggingService;
+    using System;
+    using System.Linq;
+
+    namespace STESample.ConsoleTest
+    {
+        class Program
+        {
+            static void Main(string[] args)
+            {
+                // Print out the data before we change anything
+                Console.WriteLine("Initial Data:");
+                DisplayBlogsAndPosts();
+
+                // Add a new Blog and some Posts
+                AddBlogAndPost();
+                Console.WriteLine("After Adding:");
+                DisplayBlogsAndPosts();
+
+                // Modify the Blog and one of its Posts
+                UpdateBlogAndPost();
+                Console.WriteLine("After Update:");
+                DisplayBlogsAndPosts();
+
+                // Delete the Blog and its Posts
+                DeleteBlogAndPost();
+                Console.WriteLine("After Delete:");
+                DisplayBlogsAndPosts();
+
+                Console.WriteLine("Press any key to exit...");
+                Console.ReadKey();
+            }
+
+            static void DisplayBlogsAndPosts()
+            {
+                using (var service = new Service1Client())
+                {
+                    // Get all Blogs (and Posts) from the service
+                    // and print them to the console
+                    var blogs = service.GetBlogs();
+                    foreach (var blog in blogs)
+                    {
+                        Console.WriteLine(blog.Name);
+                        foreach (var post in blog.Posts)
+                        {
+                            Console.WriteLine(" - {0}", post.Title);
+                        }
+                    }
+                }
+
+                Console.WriteLine();
+                Console.WriteLine();
+            }
+
+            static void AddBlogAndPost()
+            {
+                using (var service = new Service1Client())
+                {
+                    // Create a new Blog with a couple of Posts
+                    var newBlog = new Blog
+                    {
+                        Name = "The New Blog",
+                        Posts =
+                        {
+                            new Post { Title = "Welcome to the new blog"},
+                            new Post { Title = "What's new on the new blog"}
+                        }
+                    };
+
+                    // Save the changes using the service
+                    service.UpdateBlog(newBlog);
+                }
+            }
+
+            static void UpdateBlogAndPost()
+            {
+                using (var service = new Service1Client())
+                {
+                    // Get all the Blogs
+                    var blogs = service.GetBlogs();
+
+                    // Use LINQ to Objects to find The New Blog
+                    var blog = blogs.First(b => b.Name == "The New Blog");
+
+                    // Update the Blogs name
+                    blog.Name = "The Not-So-New Blog";
+
+                    // Update one of the related posts
+                    blog.Posts.First().Content = "Some interesting content...";
+
+                    // Save the changes using the service
+                    service.UpdateBlog(blog);
+                }
+            }
+
+            static void DeleteBlogAndPost()
+            {
+                using (var service = new Service1Client())
+                {
+                    // Get all the Blogs
+                    var blogs = service.GetBlogs();
+
+                    // Use LINQ to Objects to find The Not-So-New Blog
+                    var blog = blogs.First(b => b.Name == "The Not-So-New Blog");
+
+                    // Mark all related Posts for deletion
+                    // We need to call ToList because each Post will be removed from the
+                    // Posts collection when we call MarkAsDeleted
+                    foreach (var post in blog.Posts.ToList())
+                    {
+                        post.MarkAsDeleted();
+                    }
+
+                    // Mark the Blog for deletion
+                    blog.MarkAsDeleted();
+
+                    // Save the changes using the service
+                    service.UpdateBlog(blog);
+                }
+            }
+        }
+    }
+```
+
+You can now run the application to see it in action.
+
+-   Right-click the **STESample.ConsoleTest** project in **Solution Explorer** and select **Debug -&gt; Start new instance**
+
+You'll see the following output when the application executes.
+
+```console
+Initial Data:
+ADO.NET Blog
+- Intro to EF
+- What is New
+
+After Adding:
+ADO.NET Blog
+- Intro to EF
+- What is New
+The New Blog
+- Welcome to the new blog
+- What's new on the new blog
+
+After Update:
+ADO.NET Blog
+- Intro to EF
+- What is New
+The Not-So-New Blog
+- Welcome to the new blog
+- What's new on the new blog
+
+After Delete:
+ADO.NET Blog
+- Intro to EF
+- What is New
+
+Press any key to exit...
+```
+
+## Consume the Service from a WPF Application
+
+Let's create a WPF application that uses our service.
+
+-   **File -&gt; New -&gt; Project...**
+-   Select **Visual C\#** from the left pane and then **WPF Application**
+-   Enter **STESample.WPFTest** as the name and click **OK**
+-   Add a reference to the **STESample.Entities** project
+
+We need a service reference to our WCF service
+
+-   Right-click the **STESample.WPFTest** project in **Solution Explorer** and select **Add Service Reference...**
+-   Click **Discover**
+-   Enter **BloggingService** as the namespace and click **OK**
+
+Now we can write some code to consume the service.
+
+-   Open **MainWindow.xaml** and replace the contents with the following code.
+
+``` xaml
+    <Window
+        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
+        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
+        xmlns:STESample="clr-namespace:STESample;assembly=STESample.Entities"
+        mc:Ignorable="d" x:Class="STESample.WPFTest.MainWindow"
+        Title="MainWindow" Height="350" Width="525" Loaded="Window_Loaded">
+
+        <Window.Resources>
+            <CollectionViewSource
+                x:Key="blogViewSource"
+                d:DesignSource="{d:DesignInstance {x:Type STESample:Blog}, CreateList=True}"/>
+            <CollectionViewSource
+                x:Key="blogPostsViewSource"
+                Source="{Binding Posts, Source={StaticResource blogViewSource}}"/>
+        </Window.Resources>
+
+        <Grid DataContext="{StaticResource blogViewSource}">
+            <DataGrid AutoGenerateColumns="False" EnableRowVirtualization="True"
+                      ItemsSource="{Binding}" Margin="10,10,10,179">
+                <DataGrid.Columns>
+                    <DataGridTextColumn Binding="{Binding BlogId}" Header="Id" Width="Auto" IsReadOnly="True" />
+                    <DataGridTextColumn Binding="{Binding Name}" Header="Name" Width="Auto"/>
+                    <DataGridTextColumn Binding="{Binding Url}" Header="Url" Width="Auto"/>
+                </DataGrid.Columns>
+            </DataGrid>
+            <DataGrid AutoGenerateColumns="False" EnableRowVirtualization="True"
+                      ItemsSource="{Binding Source={StaticResource blogPostsViewSource}}" Margin="10,145,10,38">
+                <DataGrid.Columns>
+                    <DataGridTextColumn Binding="{Binding PostId}" Header="Id" Width="Auto"  IsReadOnly="True"/>
+                    <DataGridTextColumn Binding="{Binding Title}" Header="Title" Width="Auto"/>
+                    <DataGridTextColumn Binding="{Binding Content}" Header="Content" Width="Auto"/>
+                </DataGrid.Columns>
+            </DataGrid>
+            <Button Width="68" Height="23" HorizontalAlignment="Right" VerticalAlignment="Bottom"
+                    Margin="0,0,10,10" Click="buttonSave_Click">Save</Button>
+        </Grid>
+    </Window>
+```
+
+-   Open the code behind for MainWindow (**MainWindow.xaml.cs**) and replace the contents with the following code
+
+``` csharp
+    using STESample.WPFTest.BloggingService;
+    using System.Collections.Generic;
+    using System.Linq;
+    using System.Windows;
+    using System.Windows.Data;
+
+    namespace STESample.WPFTest
+    {
+        public partial class MainWindow : Window
+        {
+            public MainWindow()
+            {
+                InitializeComponent();
+            }
+
+            private void Window_Loaded(object sender, RoutedEventArgs e)
+            {
+                using (var service = new Service1Client())
+                {
+                    // Find the view source for Blogs and populate it with all Blogs (and related Posts)
+                    // from the Service. The default editing functionality of WPF will allow the objects
+                    // to be manipulated on the screen.
+                    var blogsViewSource = (CollectionViewSource)this.FindResource("blogViewSource");
+                    blogsViewSource.Source = service.GetBlogs().ToList();
+                }
+            }
+
+            private void buttonSave_Click(object sender, RoutedEventArgs e)
+            {
+                using (var service = new Service1Client())
+                {
+                    // Get the blogs that are bound to the screen
+                    var blogsViewSource = (CollectionViewSource)this.FindResource("blogViewSource");
+                    var blogs = (List<Blog>)blogsViewSource.Source;
+
+                    // Save all Blogs and related Posts
+                    foreach (var blog in blogs)
+                    {
+                        service.UpdateBlog(blog);
+                    }
+
+                    // Re-query for data to get database-generated keys etc.
+                    blogsViewSource.Source = service.GetBlogs().ToList();
+                }
+            }
+        }
+    }
+```
+
+You can now run the application to see it in action.
+
+-   Right-click the **STESample.WPFTest** project in **Solution Explorer** and select **Debug -&gt; Start new instance**
+-   You can manipulate the data using the screen and save it via the service using the **Save** button
+
+![WPF Main window](~/ef6/media/wpf.png)
diff --git a/entity-framework/ef6/fundamentals/install.md b/entity-framework/ef6/fundamentals/install.md
new file mode 100644
index 0000000000..da382359ac
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/install.md
@@ -0,0 +1,59 @@
+---
+title: Get Entity Framework - EF6
+description: Get Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/fundamentals/install
+---
+# Get Entity Framework
+Entity Framework is made up of the EF Tools for Visual Studio and the EF Runtime.
+
+## EF Tools for Visual Studio
+
+The [Entity Framework Tools for Visual Studio](/visualstudio/data-tools/entity-data-model-tools-in-visual-studio) include the EF Designer and the EF Model Wizard and are required for the database first and model first workflows. EF Tools are included in all recent versions of Visual Studio. If you perform a custom install of Visual Studio you will need to ensure that the item "Entity Framework 6 Tools" is selected by either choosing a workload that includes it or by selecting it as an individual component.
+
+For some past versions of Visual Studio, updated EF Tools are available as a download. See [Visual Studio Versions](xref:ef6/what-is-new/visual-studio) for guidance on how to get the latest version of EF Tools available for your version of Visual Studio.
+
+## EF Runtime
+
+The latest version of Entity Framework is available as the [EntityFramework NuGet package](https://nuget.org/packages/EntityFramework/). If you are not familiar with the NuGet Package Manager, we encourage you to read the [NuGet Overview](/nuget/consume-packages/overview-and-workflow).
+
+### Installing the EF NuGet Package
+
+You can install the EntityFramework package by right-clicking on the **References** folder of your project and selecting **Manage NuGet Packages…**
+
+![Manage NuGet Packages](~/ef6/media/managenugetpackages.png)
+
+### Installing from Package Manager Console
+
+Alternatively, you can install EntityFramework by running the following command in the [Package Manager Console](https://docs.nuget.org/docs/start-here/using-the-package-manager-console).
+
+``` powershell
+Install-Package EntityFramework
+```
+
+## Installing a specific version of EF
+
+From EF 4.1 onwards, new versions of the EF runtime have been released as the [EntityFramework NuGet Package](https://www.nuget.org/packages/EntityFramework/). Any of those versions can be added to a .NET Framework-based project by running the following command in Visual Studio's [Package Manager Console](https://docs.nuget.org/docs/start-here/using-the-package-manager-console):
+
+``` powershell
+Install-Package EntityFramework -Version <number>
+```
+
+Note that `<number>` represents the specific version of EF to install. For example, 6.2.0 is the version of number for EF 6.2.   
+
+EF runtimes before 4.1 were part of .NET Framework and cannot be installed separately.
+
+### Installing the Latest Preview
+
+The above methods will give you the latest fully supported release of Entity Framework. There are often prerelease versions of Entity Framework available that we would love you to try out and give us feedback on.
+
+To install the latest preview of EntityFramework you can select **Include Prerelease** in the Manage NuGet Packages window. If no prerelease versions are available you will automatically get the latest fully supported version of Entity Framework.
+
+![Include PreRelease](~/ef6/media/includeprerelease.png)
+
+Alternatively, you can run the following command in the [Package Manager Console](https://docs.nuget.org/docs/start-here/using-the-package-manager-console).
+
+``` powershell
+Install-Package EntityFramework -Pre
+```
diff --git a/entity-framework/ef6/fundamentals/logging-and-interception.md b/entity-framework/ef6/fundamentals/logging-and-interception.md
new file mode 100644
index 0000000000..e6bba2c799
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/logging-and-interception.md
@@ -0,0 +1,366 @@
+---
+title: Logging and intercepting database operations - EF6
+description: Logging and intercepting database operations in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/fundamentals/logging-and-interception
+---
+# Logging and intercepting database operations
+> [!NOTE]
+> **EF6 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 6. If you are using an earlier version, some or all of the information does not apply.  
+
+Starting with Entity Framework 6, anytime Entity Framework sends a command to the database this command can be intercepted by application code. This is most commonly used for logging SQL, but can also be used to modify or abort the command.  
+
+Specifically, EF includes:  
+
+- A Log property for the context similar to DataContext.Log in LINQ to SQL  
+- A mechanism to customize the content and formatting of the output sent to the log  
+- Low-level building blocks for interception giving greater control/flexibility  
+
+## Context Log property  
+
+The DbContext.Database.Log property can be set to a delegate for any method that takes a string. Most commonly it is used with any TextWriter by setting it to the “Write” method of that TextWriter. All SQL generated by the current context will be logged to that writer. For example, the following code will log SQL to the console:  
+
+``` csharp
+using (var context = new BlogContext())
+{
+    context.Database.Log = Console.Write;
+
+    // Your code here...
+}
+```  
+
+Notice that context.Database.Log is set to Console.Write. This is all that is needed to log SQL to the console.  
+
+Let’s add some simple query/insert/update code so that we can see some output:  
+
+``` csharp
+using (var context = new BlogContext())
+{
+    context.Database.Log = Console.Write;
+
+    var blog = context.Blogs.First(b => b.Title == "One Unicorn");
+
+    blog.Posts.First().Title = "Green Eggs and Ham";
+
+    blog.Posts.Add(new Post { Title = "I do not like them!" });
+
+    context.SaveChanges();
+}
+```  
+
+This will generate the following output:  
+
+``` SQL
+SELECT TOP (1)
+    [Extent1].[Id] AS [Id],
+    [Extent1].[Title] AS [Title]
+    FROM [dbo].[Blogs] AS [Extent1]
+    WHERE (N'One Unicorn' = [Extent1].[Title]) AND ([Extent1].[Title] IS NOT NULL)
+-- Executing at 10/8/2013 10:55:41 AM -07:00
+-- Completed in 4 ms with result: SqlDataReader
+
+SELECT
+    [Extent1].[Id] AS [Id],
+    [Extent1].[Title] AS [Title],
+    [Extent1].[BlogId] AS [BlogId]
+    FROM [dbo].[Posts] AS [Extent1]
+    WHERE [Extent1].[BlogId] = @EntityKeyValue1
+-- EntityKeyValue1: '1' (Type = Int32)
+-- Executing at 10/8/2013 10:55:41 AM -07:00
+-- Completed in 2 ms with result: SqlDataReader
+
+UPDATE [dbo].[Posts]
+SET [Title] = @0
+WHERE ([Id] = @1)
+-- @0: 'Green Eggs and Ham' (Type = String, Size = -1)
+-- @1: '1' (Type = Int32)
+-- Executing asynchronously at 10/8/2013 10:55:41 AM -07:00
+-- Completed in 12 ms with result: 1
+
+INSERT [dbo].[Posts]([Title], [BlogId])
+VALUES (@0, @1)
+SELECT [Id]
+FROM [dbo].[Posts]
+WHERE @@ROWCOUNT > 0 AND [Id] = scope_identity()
+-- @0: 'I do not like them!' (Type = String, Size = -1)
+-- @1: '1' (Type = Int32)
+-- Executing asynchronously at 10/8/2013 10:55:41 AM -07:00
+-- Completed in 2 ms with result: SqlDataReader
+```  
+
+(Note that this is the output assuming any database initialization has already happened. If database initialization had not already happened then there would be a lot more output showing all the work Migrations does under the covers to check for or create a new database.)  
+
+## What gets logged?  
+
+When the Log property is set all of the following will be logged:  
+
+- SQL for all different kinds of commands. For example:  
+    - Queries, including normal LINQ queries, eSQL queries, and raw queries from methods such as SqlQuery  
+    - Inserts, updates, and deletes generated as part of SaveChanges  
+    - Relationship loading queries such as those generated by lazy loading  
+- Parameters  
+- Whether or not the command is being executed asynchronously  
+- A timestamp indicating when the command started executing  
+- Whether or not the command completed successfully, failed by throwing an exception, or, for async, was canceled  
+- Some indication of the result value  
+- The approximate amount of time it took to execute the command. Note that this is the time from sending the command to getting the result object back. It does not include time to read the results.  
+
+Looking at the example output above, each of the four commands logged are:  
+
+- The query resulting from the call to context.Blogs.First  
+    - Notice that the ToString method of getting the SQL would not have worked for this query since “First” does not provide an IQueryable on which ToString could be called  
+- The query resulting from the lazy-loading of blog.Posts  
+    - Notice the parameter details for the key value for which lazy loading is happening  
+    - Only properties of the parameter that are set to non-default values are logged. For example, the Size property is only shown if it is non-zero.  
+- Two commands resulting from SaveChangesAsync; one for the update to change a post title, the other for an insert to add a new post  
+    - Notice the parameter details for the FK and Title properties  
+    - Notice that these commands are being executed asynchronously  
+
+## Logging to different places  
+
+As shown above logging to the console is super easy. It’s also easy to log to memory, file, etc. by using different kinds of [TextWriter](https://msdn.microsoft.com/library/system.io.textwriter.aspx).  
+
+If you are familiar with LINQ to SQL you might notice that in LINQ to SQL the Log property is set to the actual TextWriter object (for example, Console.Out) while in EF the Log property is set to a method that accepts a string (for example, Console.Write or Console.Out.Write). The reason for this is to decouple EF from TextWriter by accepting any delegate that can act as a sink for strings. For example, imagine that you already have some logging framework and it defines a logging method like so:  
+
+``` csharp
+public class MyLogger
+{
+    public void Log(string component, string message)
+    {
+        Console.WriteLine("Component: {0} Message: {1} ", component, message);
+    }
+}
+```  
+
+This could be hooked up to the EF Log property like this:  
+
+``` csharp
+var logger = new MyLogger();
+context.Database.Log = s => logger.Log("EFApp", s);
+```  
+
+## Result logging  
+
+The default logger logs command text (SQL), parameters, and the “Executing” line with a timestamp before the command is sent to the database. A “completed” line containing elapsed time is logged following execution of the command.  
+
+Note that for async commands the “completed” line is not logged until the async task actually completes, fails, or is canceled.  
+
+The “completed” line contains different information depending on the type of command and whether or not execution was successful.  
+
+### Successful execution  
+
+For commands that complete successfully the output is “Completed in x ms with result: “ followed by some indication of what the result was. For commands that return a data reader the result indication is the type of [DbDataReader](https://msdn.microsoft.com/library/system.data.common.dbdatareader.aspx) returned. For commands that return an integer value such as the update command shown above the result shown is that integer.  
+
+### Failed execution  
+
+For commands that fail by throwing an exception, the output contains the message from the exception. For example, using SqlQuery to query against a table that does exist will result in log output something like this:  
+
+``` SQL
+SELECT * from ThisTableIsMissing
+-- Executing at 5/13/2013 10:19:05 AM
+-- Failed in 1 ms with error: Invalid object name 'ThisTableIsMissing'.
+```  
+
+### Canceled execution  
+
+For async commands where the task is canceled the result could be failure with an exception, since this is what the underlying ADO.NET provider often does when an attempt is made to cancel. If this doesn’t happen and the task is canceled cleanly then the output will look something like this:  
+
+```console
+update Blogs set Title = 'No' where Id = -1
+-- Executing asynchronously at 5/13/2013 10:21:10 AM
+-- Canceled in 1 ms
+```  
+
+## Changing log content and formatting  
+
+Under the covers the Database.Log property makes use of a DatabaseLogFormatter object. This object effectively binds an IDbCommandInterceptor implementation (see below) to a delegate that accepts strings and a DbContext. This means that methods on DatabaseLogFormatter are called before and after the execution of commands by EF. These DatabaseLogFormatter methods gather and format log output and send it to the delegate.  
+
+### Customizing DatabaseLogFormatter  
+
+Changing what is logged and how it is formatted can be achieved by creating a new class that derives from DatabaseLogFormatter and overrides methods as appropriate. The most common methods to override are:  
+
+- LogCommand – Override this to change how commands are logged before they are executed. By default LogCommand calls LogParameter for each parameter; you may choose to do the same in your override or handle parameters differently instead.  
+- LogResult – Override this to change how the outcome from executing a command is logged.  
+- LogParameter – Override this to change the formatting and content of parameter logging.  
+
+For example, suppose we wanted to log just a single line before each command is sent to the database. This can be done with two overrides:  
+
+- Override LogCommand to format and write the single line of SQL  
+- Override LogResult to do nothing.  
+
+The code would look something like this:
+
+``` csharp
+public class OneLineFormatter : DatabaseLogFormatter
+{
+    public OneLineFormatter(DbContext context, Action<string> writeAction)
+        : base(context, writeAction)
+    {
+    }
+
+    public override void LogCommand<TResult>(
+        DbCommand command, DbCommandInterceptionContext<TResult> interceptionContext)
+    {
+        Write(string.Format(
+            "Context '{0}' is executing command '{1}'{2}",
+            Context.GetType().Name,
+            command.CommandText.Replace(Environment.NewLine, ""),
+            Environment.NewLine));
+    }
+
+    public override void LogResult<TResult>(
+        DbCommand command, DbCommandInterceptionContext<TResult> interceptionContext)
+    {
+    }
+}
+```  
+
+To log output simply call the Write method which will send output to the configured write delegate.  
+
+(Note that this code does simplistic removal of line breaks just as an example. It will likely not work well for viewing complex SQL.)  
+
+### Setting the DatabaseLogFormatter  
+
+Once a new DatabaseLogFormatter class has been created it needs to be registered with EF. This is done using code-based configuration. In a nutshell this means creating a new class that derives from DbConfiguration in the same assembly as your DbContext class and then calling SetDatabaseLogFormatter in the constructor of this new class. For example:  
+
+``` csharp
+public class MyDbConfiguration : DbConfiguration
+{
+    public MyDbConfiguration()
+    {
+        SetDatabaseLogFormatter(
+            (context, writeAction) => new OneLineFormatter(context, writeAction));
+    }
+}
+```  
+
+### Using the new DatabaseLogFormatter  
+
+This new DatabaseLogFormatter will now be used anytime Database.Log is set. So, running the code from part 1 will now result in the following output:  
+
+```console
+Context 'BlogContext' is executing command 'SELECT TOP (1) [Extent1].[Id] AS [Id], [Extent1].[Title] AS [Title]FROM [dbo].[Blogs] AS [Extent1]WHERE (N'One Unicorn' = [Extent1].[Title]) AND ([Extent1].[Title] IS NOT NULL)'
+Context 'BlogContext' is executing command 'SELECT [Extent1].[Id] AS [Id], [Extent1].[Title] AS [Title], [Extent1].[BlogId] AS [BlogId]FROM [dbo].[Posts] AS [Extent1]WHERE [Extent1].[BlogId] = @EntityKeyValue1'
+Context 'BlogContext' is executing command 'update [dbo].[Posts]set [Title] = @0where ([Id] = @1)'
+Context 'BlogContext' is executing command 'insert [dbo].[Posts]([Title], [BlogId])values (@0, @1)select [Id]from [dbo].[Posts]where @@rowcount > 0 and [Id] = scope_identity()'
+```  
+
+## Interception building blocks  
+
+So far we have looked at how to use DbContext.Database.Log to log the SQL generated by EF. But this code is actually a relatively thin facade over some low-level building blocks for more general interception.  
+
+### Interception interfaces  
+
+The interception code is built around the concept of interception interfaces. These interfaces inherit from IDbInterceptor and define methods that are called when EF performs some action. The intent is to have one interface per type of object being intercepted. For example, the IDbCommandInterceptor interface defines methods that are called before EF makes a call to ExecuteNonQuery, ExecuteScalar, ExecuteReader, and related methods. Likewise, the interface defines methods that are called when each of these operations completes. The DatabaseLogFormatter class that we looked at above implements this interface to log commands.  
+
+### The interception context  
+
+Looking at the methods defined on any of the interceptor interfaces it is apparent that every call is given an object of type DbInterceptionContext or some type derived from this such as DbCommandInterceptionContext\<\>. This object contains contextual information about the action that EF is taking. For example, if the action is being taken on behalf of a DbContext, then the DbContext is included in the DbInterceptionContext. Similarly, for commands that are being executed asynchronously, the IsAsync flag is set on DbCommandInterceptionContext.  
+
+### Result handling  
+
+The DbCommandInterceptionContext\<\> class contains properties called Result, OriginalResult, Exception, and OriginalException. These properties are set to null/zero for calls to the interception methods that are called before the operation is executed — that is, for the …Executing methods. If the operation is executed and succeeds, then Result and OriginalResult are set to the result of the operation. These values can then be observed in the interception methods that are called after the operation has executed — that is, on the …Executed methods. Likewise, if the operation throws, then the Exception and OriginalException properties will be set.  
+
+#### Suppressing execution  
+
+If an interceptor sets the Result property before the command has executed (in one of the …Executing methods) then EF will not attempt to actually execute the command, but will instead just use the result set. In other words, the interceptor can suppress execution of the command but have EF continue as if the command had been executed.  
+
+An example of how this might be used is the command batching that has traditionally been done with a wrapping provider. The interceptor would store the command for later execution as a batch but would “pretend” to EF that the command had executed as normal. Note that it requires more than this to implement batching, but this is an example of how changing the interception result might be used.  
+
+Execution can also be suppressed by setting the Exception property in one of the …Executing methods. This causes EF to continue as if execution of the operation had failed by throwing the given exception. This may, of course, cause the application to crash, but it may also be a transient exception or some other exception that is handled by EF. For example, this could be used in test environments to test the behavior of an application when command execution fails.  
+
+#### Changing the result after execution  
+
+If an interceptor sets the Result property after the command has executed (in one of the …Executed methods) then EF will use the changed result instead of the result that was actually returned from the operation. Similarly, if an interceptor sets the Exception property after the command has executed, then EF will throw the set exception as if the operation had thrown the exception.  
+
+An interceptor can also set the Exception property to null to indicate that no exception should be thrown. This can be useful if execution of the operation failed but the interceptor wishes EF to continue as if the operation had succeeded. This usually also involves setting the Result so that EF has some result value to work with as it continues.  
+
+#### OriginalResult and OriginalException  
+
+After EF has executed an operation it will set either the Result and OriginalResult properties if execution did not fail or the Exception and OriginalException properties if execution failed with an exception.  
+
+The OriginalResult and OriginalException properties are read-only and are only set by EF after actually executing an operation. These properties cannot be set by interceptors. This means that any interceptor can distinguish between an exception or result that has been set by some other interceptor as opposed to the real exception or result that occurred when the operation was executed.  
+
+### Registering interceptors  
+
+Once a class that implements one or more of the interception interfaces has been created it can be registered with EF using the DbInterception class. For example:  
+
+``` csharp
+DbInterception.Add(new NLogCommandInterceptor());
+```  
+
+Interceptors can also be registered at the app-domain level using the DbConfiguration code-based configuration mechanism.  
+
+### Example: Logging to NLog  
+
+Let’s put all this together into an example that using IDbCommandInterceptor and [NLog](https://nlog-project.org/) to:  
+
+- Log a warning for any command that is executed non-asynchronously  
+- Log an error for any command that throws when executed  
+
+Here’s the class that does the logging, which should be registered as shown above:  
+
+``` csharp
+public class NLogCommandInterceptor : IDbCommandInterceptor
+{
+    private static readonly Logger Logger = LogManager.GetCurrentClassLogger();
+
+    public void NonQueryExecuting(
+        DbCommand command, DbCommandInterceptionContext<int> interceptionContext)
+    {
+        LogIfNonAsync(command, interceptionContext);
+    }
+
+    public void NonQueryExecuted(
+        DbCommand command, DbCommandInterceptionContext<int> interceptionContext)
+    {
+        LogIfError(command, interceptionContext);
+    }
+
+    public void ReaderExecuting(
+        DbCommand command, DbCommandInterceptionContext<DbDataReader> interceptionContext)
+    {
+        LogIfNonAsync(command, interceptionContext);
+    }
+
+    public void ReaderExecuted(
+        DbCommand command, DbCommandInterceptionContext<DbDataReader> interceptionContext)
+    {
+        LogIfError(command, interceptionContext);
+    }
+
+    public void ScalarExecuting(
+        DbCommand command, DbCommandInterceptionContext<object> interceptionContext)
+    {
+        LogIfNonAsync(command, interceptionContext);
+    }
+
+    public void ScalarExecuted(
+        DbCommand command, DbCommandInterceptionContext<object> interceptionContext)
+    {
+        LogIfError(command, interceptionContext);
+    }
+
+    private void LogIfNonAsync<TResult>(
+        DbCommand command, DbCommandInterceptionContext<TResult> interceptionContext)
+    {
+        if (!interceptionContext.IsAsync)
+        {
+            Logger.Warn("Non-async command used: {0}", command.CommandText);
+        }
+    }
+
+    private void LogIfError<TResult>(
+        DbCommand command, DbCommandInterceptionContext<TResult> interceptionContext)
+    {
+        if (interceptionContext.Exception != null)
+        {
+            Logger.Error("Command {0} failed with exception {1}",
+                command.CommandText, interceptionContext.Exception);
+        }
+    }
+}
+```  
+
+Notice how this code uses the interception context to discover when a command is being executed non-asynchronously and to discover when there was an error executing a command.  
diff --git a/entity-framework/ef6/fundamentals/performance/ngen.md b/entity-framework/ef6/fundamentals/performance/ngen.md
new file mode 100644
index 0000000000..77cd6cef2e
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/performance/ngen.md
@@ -0,0 +1,84 @@
+---
+title: Improving startup performance with NGen - EF6
+description: Improving startup performance with NGen in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/fundamentals/performance/ngen
+---
+# Improving startup performance with NGen
+> [!NOTE]
+> **EF6 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 6. If you are using an earlier version, some or all of the information does not apply.  
+
+The .NET Framework supports the generation of native images for managed applications and libraries as a way to help applications start faster and also in some cases use less memory. Native images are created by translating managed code assemblies into files containing native machine instructions before the application is executed, relieving the .NET JIT (Just-In-Time) compiler from having to generate the native instructions at application runtime.  
+
+Prior to version 6, the EF runtime’s core libraries were part of the .NET Framework and native images were generated automatically for them. Starting with version 6 the whole EF runtime has been combined into the EntityFramework NuGet package. Native images have to now be generated using the NGen.exe command line tool to obtain similar results.  
+
+Empirical observations show that native images of the EF runtime assemblies can cut between 1 and 3 seconds of application startup time.  
+
+## How to use NGen.exe  
+
+The most basic function of the NGen.exe tool is to “install” (that is, to create and persist to disk) native images for an assembly and all its direct dependencies. Here is how you can achieve that:  
+
+1. Open a Command Prompt window as an administrator.
+2. Change the current working directory to the location of the assemblies you want to generate native images for:
+
+   ``` console
+   cd <*Assemblies location*>  
+   ```
+
+3. Depending on your operating system and the application’s configuration you might need to generate native images for 32 bit architecture, 64 bit architecture or for both.
+
+   For 32 bit run:
+
+   ``` console
+   %WINDIR%\Microsoft.NET\Framework\v4.0.30319\ngen install <Assembly name>  
+   ```
+
+   For 64 bit run:
+  
+   ``` console
+   %WINDIR%\Microsoft.NET\Framework64\v4.0.30319\ngen install <Assembly name>  
+   ```
+
+> [!TIP]
+> Generating native images for the wrong architecture is a very common mistake. When in doubt you can simply generate native images for all the architectures that apply to the operating system installed in the machine.  
+
+NGen.exe also supports other functions such as uninstalling and displaying the installed native images, queuing the generation of multiple images, etc. For more details of usage read the [NGen.exe documentation](https://msdn.microsoft.com/library/6t9t5wcf.aspx).  
+
+## When to use NGen.exe  
+
+When it comes to decide which assemblies to generate native images for in an application based on EF version 6 or greater, you should consider the following options:  
+
+- **The main EF runtime assembly, EntityFramework.dll**: A typical EF based application executes a significant amount of code from this assembly on startup or on its first access to the database. Consequently, creating native images of this assembly will produce the biggest gains in startup performance.  
+- **Any EF provider assembly used by your application**: Startup time can also benefit slightly from generating native images of these. For example, if the application uses the EF provider for SQL Server you will want to generate a native image for EntityFramework.SqlServer.dll.  
+- **Your application’s assemblies and other dependencies**: The [NGen.exe documentation](https://msdn.microsoft.com/library/6t9t5wcf.aspx) covers general criteria for choosing which assemblies to generate native images for and the impact of native images on security, advanced options such as “hard binding”, scenarios such as using native images in debugging and profiling scenarios, etc.  
+
+> [!TIP]
+> Make sure you carefully measure the impact of using native images on both the startup performance and the overall performance of your application and compare them against actual requirements. While native images will generally help improve startup up performance and in some cases reduce memory usage, not all scenarios will benefit equally. For instance, on steady state execution (that is, once all the methods being used by the application have been invoked at least once) code generated by the JIT compiler can in fact yield slightly better performance than native images.  
+
+## Using NGen.exe in a development machine  
+
+During development the .NET JIT compiler will offer the best overall tradeoff for code that is changing frequently. Generating native images for compiled dependencies such as the EF runtime assemblies can help accelerate development and testing by cutting a few seconds out at the beginning of each execution.  
+
+A good place to find the EF runtime assemblies is the NuGet package location for the solution. For example, for an application using EF 6.0.2 with SQL Server and targeting .NET 4.5 or greater you can type the following in a Command Prompt window (remember to open it as an administrator):  
+
+```console
+cd <Solution directory>\packages\EntityFramework.6.0.2\lib\net45
+%WINDIR%\Microsoft.NET\Framework\v4.0.30319\ngen install EntityFramework.SqlServer.dll
+%WINDIR%\Microsoft.NET\Framework64\v4.0.30319\ngen install EntityFramework.SqlServer.dll
+```  
+
+> [!NOTE]
+> This takes advantage of the fact that installing the native images for EF provider for SQL Server will also by default install the native images for the main EF runtime assembly. This works because NGen.exe can detect that EntityFramework.dll is a direct dependency of the EntityFramework.SqlServer.dll assembly located in the same directory.  
+
+## Creating native images during setup  
+
+The WiX Toolkit supports queuing the generation of native images for managed assemblies during setup, as explained in this [how-to guide](https://wixtoolset.org/documentation/manual/v3/howtos/files_and_registry/ngen_managed_assemblies.html). Another alternative is to create a custom setup task that execute the NGen.exe command.  
+
+## Verifying that native images are being used for EF  
+
+You can verify that a specific application is using a native assembly by looking for loaded assemblies that have the extension “.ni.dll” or “.ni.exe”. For example, a native image for the EF’s main runtime assembly will be called EntityFramework.ni.dll. An easy way to inspect the loaded .NET assemblies of a process is to use [Process Explorer](https://technet.microsoft.com/sysinternals/bb896653).  
+
+## Other things to be aware of  
+
+**Creating a native image of an assembly should not be confused with registering the assembly in the [GAC (Global Assembly Cache)](https://msdn.microsoft.com/library/yf1d93sz.aspx)**. NGen.exe allows creating images of assemblies that are not in the GAC, and in fact, multiple applications that use a specific version of EF can share the same native image. While Windows 8 can automatically create native images for assemblies placed in the GAC, the EF runtime is optimized to be deployed alongside your application and we do not recommend registering it in the GAC as this has a negative impact on assembly resolution and servicing your applications among other aspects.  
diff --git a/entity-framework/ef6/fundamentals/performance/perf-whitepaper.md b/entity-framework/ef6/fundamentals/performance/perf-whitepaper.md
new file mode 100644
index 0000000000..11f578b2f2
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/performance/perf-whitepaper.md
@@ -0,0 +1,1578 @@
+---
+title: Performance considerations for EF4, EF5, and EF6 - EF6
+description: Performance considerations for Entity Framework 4, 5, and 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/fundamentals/performance/perf-whitepaper
+---
+# Performance considerations for EF 4, 5, and 6
+By David Obando, Eric Dettinger and others
+
+Published: April 2012
+
+Last updated: May 2014
+
+------------------------------------------------------------------------
+
+## 1. Introduction
+
+Object-Relational Mapping frameworks are a convenient way to provide an abstraction for data access in an object-oriented application. For .NET applications, Microsoft's recommended O/RM is Entity Framework. With any abstraction though, performance can become a concern.
+
+This whitepaper was written to show the performance considerations when developing applications using Entity Framework, to give developers an idea of the Entity Framework internal algorithms that can affect performance, and to provide tips for investigation and improving performance in their applications that use Entity Framework. There are a number of good topics on performance already available on the web, and we've also tried pointing to these resources where possible.
+
+Performance is a tricky topic. This whitepaper is intended as a resource to help you make performance related decisions for your applications that use Entity Framework. We have included some test metrics to demonstrate performance, but these metrics aren't intended as absolute indicators of the performance you will see in your application.
+
+For practical purposes, this document assumes Entity Framework 4 is run under .NET 4.0 and Entity Framework 5 and 6 are run under .NET 4.5. Many of the performance improvements made for Entity Framework 5 reside within the core components that ship with .NET 4.5.
+
+Entity Framework 6 is an out of band release and does not depend on the Entity Framework components that ship with .NET. Entity Framework 6 work on both .NET 4.0 and .NET 4.5, and can offer a big performance benefit to those who haven’t upgraded from .NET 4.0 but want the latest Entity Framework bits in their application. When this document mentions Entity Framework 6, it refers to the latest version available at the time of this writing: version 6.1.0.
+
+## 2. Cold vs. Warm Query Execution
+
+The very first time any query is made against a given model, the Entity Framework does a lot of work behind the scenes to load and validate the model. We frequently refer to this first query as a "cold" query.  Further queries against an already loaded model are known as "warm" queries, and are much faster.
+
+Let’s take a high-level view of where time is spent when executing a query using Entity Framework, and see where things are improving in Entity Framework 6.
+
+**First Query Execution – cold query**
+
+| Code User Writes                                                                                     | Action                    | EF4 Performance Impact                                                                                                                                                                                                                                                                                                                                                                                                        | EF5 Performance Impact                                                                                                                                                                                                                                                                                                                                                                                                                                                    | EF6 Performance Impact                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+|:-----------------------------------------------------------------------------------------------------|:--------------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `using(var db = new MyContext())` <br/> `{`                                                          | Context creation          | Medium                                                                                                                                                                                                                                                                                                                                                                                                                        | Medium                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Low                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| `  var q1 = ` <br/> `    from c in db.Customers` <br/> `    where c.Id == id1` <br/> `    select c;` | Query expression creation | Low                                                                                                                                                                                                                                                                                                                                                                                                                           | Low                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Low                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| `  var c1 = q1.First();`                                                                             | LINQ query execution      | - Metadata loading: High but cached <br/> - View generation: Potentially very high but cached <br/> - Parameter evaluation: Medium <br/> - Query translation: Medium <br/> - Materializer generation: Medium but cached <br/> - Database query execution: Potentially high <br/> + Connection.Open <br/> + Command.ExecuteReader <br/> + DataReader.Read <br/> Object materialization: Medium <br/> - Identity lookup: Medium | - Metadata loading: High but cached <br/> - View generation: Potentially very high but cached <br/> - Parameter evaluation: Low <br/> - Query translation: Medium but cached <br/> - Materializer generation: Medium but cached <br/> - Database query execution: Potentially high (Better queries in some situations) <br/> + Connection.Open <br/> + Command.ExecuteReader <br/> + DataReader.Read <br/> Object materialization: Medium <br/> - Identity lookup: Medium | - Metadata loading: High but cached <br/> - View generation: Medium but cached <br/> - Parameter evaluation: Low <br/> - Query translation: Medium but cached <br/> - Materializer generation: Medium but cached <br/> - Database query execution: Potentially high (Better queries in some situations) <br/> + Connection.Open <br/> + Command.ExecuteReader <br/> + DataReader.Read <br/> Object materialization: Medium (Faster than EF5) <br/> - Identity lookup: Medium |
+| `}`                                                                                                  | Connection.Close          | Low                                                                                                                                                                                                                                                                                                                                                                                                                           | Low                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Low                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+
+
+**Second Query Execution – warm query**
+
+| Code User Writes                                                                                     | Action                    | EF4 Performance Impact                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | EF5 Performance Impact                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | EF6 Performance Impact                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+|:-----------------------------------------------------------------------------------------------------|:--------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `using(var db = new MyContext())` <br/> `{`                                                          | Context creation          | Medium                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Medium                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Low                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `  var q1 = ` <br/> `    from c in db.Customers` <br/> `    where c.Id == id1` <br/> `    select c;` | Query expression creation | Low                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Low                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Low                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `  var c1 = q1.First();`                                                                             | LINQ query execution      | - Metadata ~~loading~~ lookup: ~~High but cached~~ Low <br/> - View ~~generation~~ lookup: ~~Potentially very high but cached~~ Low <br/> - Parameter evaluation: Medium <br/> - Query ~~translation~~ lookup: Medium <br/> - Materializer ~~generation~~ lookup: ~~Medium but cached~~ Low <br/> - Database query execution: Potentially high <br/> + Connection.Open <br/> + Command.ExecuteReader <br/> + DataReader.Read <br/> Object materialization: Medium <br/> - Identity lookup: Medium | - Metadata ~~loading~~ lookup: ~~High but cached~~ Low <br/> - View ~~generation~~ lookup: ~~Potentially very high but cached~~ Low <br/> - Parameter evaluation: Low <br/> - Query ~~translation~~ lookup: ~~Medium but cached~~ Low <br/> - Materializer ~~generation~~ lookup: ~~Medium but cached~~ Low <br/> - Database query execution: Potentially high (Better queries in some situations) <br/> + Connection.Open <br/> + Command.ExecuteReader <br/> + DataReader.Read <br/> Object materialization: Medium <br/> - Identity lookup: Medium | - Metadata ~~loading~~ lookup: ~~High but cached~~ Low <br/> - View ~~generation~~ lookup: ~~Medium but cached~~ Low <br/> - Parameter evaluation: Low <br/> - Query ~~translation~~ lookup: ~~Medium but cached~~ Low <br/> - Materializer ~~generation~~ lookup: ~~Medium but cached~~ Low <br/> - Database query execution: Potentially high (Better queries in some situations) <br/> + Connection.Open <br/> + Command.ExecuteReader <br/> + DataReader.Read <br/> Object materialization: Medium (Faster than EF5) <br/> - Identity lookup: Medium |
+| `}`                                                                                                  | Connection.Close          | Low                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Low                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Low                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+
+
+There are several ways to reduce the performance cost of both cold and warm queries, and we'll take a look at these in the following section. Specifically, we'll look at reducing the cost of model loading in cold queries by using pre-generated views, which should help alleviate performance pains experienced during view generation. For warm queries, we'll cover query plan caching, no tracking queries, and different query execution options.
+
+### 2.1 What is View Generation?
+
+In order to understand what view generation is, we must first understand what “Mapping Views” are. Mapping Views are executable representations of the transformations specified in the mapping for each entity set and association. Internally, these mapping views take the shape of CQTs (canonical query trees). There are two types of mapping views:
+
+-   Query views: these represent the transformation necessary to go from the database schema to the conceptual model.
+-   Update views: these represent the transformation necessary to go from the conceptual model to the database schema.
+
+Keep in mind that the conceptual model might differ from the database schema in various ways. For example, one single table might be used to store the data for two different entity types. Inheritance and non-trivial mappings play a role in the complexity of the mapping views.
+
+The process of computing these views based on the specification of the mapping is what we call view generation. View generation can either take place dynamically when a model is loaded, or at build time, by using "pre-generated views"; the latter are serialized in the form of Entity SQL statements to a C\# or VB file.
+
+When views are generated, they are also validated. From a performance standpoint, the vast majority of the cost of view generation is actually the validation of the views which ensures that the connections between the entities make sense and have the correct cardinality for all the supported operations.
+
+When a query over an entity set is executed, the query is combined with the corresponding query view, and the result of this composition is run through the plan compiler to create the representation of the query that the backing store can understand. For SQL Server, the final result of this compilation will be a T-SQL SELECT statement. The first time an update over an entity set is performed, the update view is run through a similar process to transform it into DML statements for the target database.
+
+### 2.2 Factors that affect View Generation performance
+
+The performance of view generation step not only depends on the size of your model but also on how interconnected the model is. If two Entities are connected via an inheritance chain or an Association, they are said to be connected. Similarly if two tables are connected via a foreign key, they are connected. As the number of connected Entities and tables in your schemas increase, the view generation cost increases.
+
+The algorithm that we use to generate and validate views is exponential in the worst case, though we do use some optimizations to improve this. The biggest factors that seem to negatively affect performance are:
+
+-   Model size, referring to the number of entities and the amount of associations between these entities.
+-   Model complexity, specifically inheritance involving a large number of types.
+-   Using Independent Associations, instead of Foreign Key Associations.
+
+For small, simple models the cost may be small enough to not bother using pre-generated views. As model size and complexity increase, there are several options available to reduce the cost of view generation and validation.
+
+### 2.3 Using Pre-Generated Views to decrease model load time
+
+For detailed information on how to use pre-generated views on Entity Framework 6 visit [Pre-Generated Mapping Views](xref:ef6/fundamentals/performance/pre-generated-views)
+
+#### 2.3.1 Pre-Generated views using the Entity Framework Power Tools Community Edition
+
+You can use the [Entity Framework 6 Power Tools Community Edition](https://marketplace.visualstudio.com/items?itemName=ErikEJ.EntityFramework6PowerToolsCommunityEdition) to generate views of EDMX and Code First models by right-clicking the model class file and using the Entity Framework menu to select “Generate Views”. The Entity Framework Power Tools Community Edition work only on DbContext-derived contexts.
+
+#### 2.3.2 How to use Pre-generated views with a model created by EDMGen
+
+EDMGen is a utility that ships with .NET and works with Entity Framework 4 and 5, but not with Entity Framework 6. EDMGen allows you to generate a model file, the object layer and the views from the command line. One of the outputs will be a Views file in your language of choice, VB or C\#. This is a code file containing Entity SQL snippets for each entity set. To enable pre-generated views, you simply include the file in your project.
+
+If you manually make edits to the schema files for the model, you will need to re-generate the views file. You can do this by running EDMGen with the **/mode:ViewGeneration** flag.
+
+#### 2.3.3 How to use Pre-Generated Views with an EDMX file
+
+You can also use EDMGen to generate views for an EDMX file - the previously referenced MSDN topic describes how to add a pre-build event to do this - but this is complicated and there are some cases where it isn't possible. It's generally easier to use a T4 template to generate the views when your model is in an edmx file.
+
+The ADO.NET team blog has a post that describes how to use a T4 template for view generation ( \<https://learn.microsoft.com/archive/blogs/adonet/how-to-use-a-t4-template-for-view-generation>). This post includes a template that can be downloaded and added to your project. The template was written for the first version of Entity Framework, so they aren’t guaranteed to work with the latest versions of Entity Framework. However, you can download a more up-to-date set of view generation templates for Entity Framework 4 and 5from the Visual Studio Gallery:
+
+-   VB.NET: \<http://visualstudiogallery.msdn.microsoft.com/118b44f2-1b91-4de2-a584-7a680418941d>
+-   C\#: \<http://visualstudiogallery.msdn.microsoft.com/ae7730ce-ddab-470f-8456-1b313cd2c44d>
+
+If you’re using Entity Framework 6 you can get the view generation T4 templates from the Visual Studio Gallery at \<http://visualstudiogallery.msdn.microsoft.com/18a7db90-6705-4d19-9dd1-0a6c23d0751f>.
+
+### 2.4 Reducing the cost of view generation
+
+Using pre-generated views moves the cost of view generation from model loading (run time) to design time. While this improves startup performance at runtime, you will still experience the pain of view generation while you are developing. There are several additional tricks that can help reduce the cost of view generation, both at compile time and run time.
+
+#### 2.4.1 Using Foreign Key Associations to reduce view generation cost
+
+We have seen a number of cases where switching the associations in the model from Independent Associations to Foreign Key Associations dramatically improved the time spent in view generation.
+
+To demonstrate this improvement, we generated two versions of the Navision model by using EDMGen. *Note: see appendix C for a description of the Navision model.* The Navision model is interesting for this exercise due to its very large amount of entities and relationships between them.
+
+One version of this very large model was generated with Foreign Keys Associations and the other was generated with Independent Associations. We then timed how long it took to generate the views for each model. Entity Framework 5 test used the GenerateViews() method from class EntityViewGenerator to generate the views, while the Entity Framework 6 test used the GenerateViews() method from class StorageMappingItemCollection. This due to code restructuring that occurred in the Entity Framework 6 codebase.
+
+Using Entity Framework 5, view generation for the model with Foreign Keys took 65 minutes in a lab machine. It's unknown how long it would have taken to generate the views for the model that used independent associations. We left the test running for over a month before the machine was rebooted in our lab to install monthly updates.
+
+Using Entity Framework 6, view generation for the model with Foreign Keys took 28 seconds in the same lab machine. View generation for the model that uses Independent Associations took 58 seconds. The improvements done to Entity Framework 6 on its view generation code mean that many projects won’t need pre-generated views to obtain faster startup times.
+
+It’s important to remark that pre-generating views in Entity Framework 4 and 5 can be done with EDMGen or the Entity Framework Power Tools. For Entity Framework 6 view generation can be done via the Entity Framework Power Tools or programmatically as described in [Pre-Generated Mapping Views](xref:ef6/fundamentals/performance/pre-generated-views).
+
+##### 2.4.1.1 How to use Foreign Keys instead of Independent Associations
+
+When using EDMGen or the Entity Designer in Visual Studio, you get FKs by default, and it only takes a single checkbox or command line flag to switch between FKs and IAs.
+
+If you have a large Code First model, using Independent Associations will have the same effect on view generation. You can avoid this impact by including Foreign Key properties on the classes for your dependent objects, though some developers will consider this to be polluting their object model. You can find more information on this subject in \<http://blog.oneunicorn.com/2011/12/11/whats-the-deal-with-mapping-foreign-keys-using-the-entity-framework/>.
+
+| When using      | Do this                                                                                                                                                                                                                                                                                                                              |
+|:----------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| Entity Designer | After adding an association between two entities, make sure you have a referential constraint. Referential constraints tell Entity Framework to use Foreign Keys instead of Independent Associations. For additional details visit \<https://learn.microsoft.com/archive/blogs/efdesign/foreign-keys-in-the-entity-framework>. |
+| EDMGen          | When using EDMGen to generate your files from the database, your Foreign Keys will be respected and added to the model as such. For more information on the different options exposed by EDMGen visit [http://msdn.microsoft.com/library/bb387165.aspx](https://msdn.microsoft.com/library/bb387165.aspx).                           |
+| Code First      | See the "Relationship Convention" section of the [Code First Conventions](xref:ef6/modeling/code-first/conventions/built-in) topic for information on how to include foreign key properties on dependent objects when using Code First.                                                                                              |
+
+#### 2.4.2 Moving your model to a separate assembly
+
+When your model is included directly in your application's project and you generate views through a pre-build event or a T4 template, view generation and validation will take place whenever the project is rebuilt, even if the model wasn't changed. If you move the model to a separate assembly and reference it from your application's project, you can make other changes to your application without needing to rebuild the project containing the model.
+
+*Note:*  when moving your model to separate assemblies remember to copy the connection strings for the model into the application configuration file of the client project.
+
+#### 2.4.3 Disable validation of an edmx-based model
+
+EDMX models are validated at compile time, even if the model is unchanged. If your model has already been validated, you can suppress validation at compile time by setting the "Validate on Build" property to false in the properties window. When you change your mapping or model, you can temporarily re-enable validation to verify your changes.
+
+Note that performance improvements were made to the Entity Framework Designer for Entity Framework 6, and the cost of the “Validate on Build” is much lower than in previous versions of the designer.
+
+## 3 Caching in the Entity Framework
+
+Entity Framework has the following forms of caching built-in:
+
+1.  Object caching – the ObjectStateManager built into an ObjectContext instance keeps track in memory of the objects that have been retrieved using that instance. This is also known as first-level cache.
+2.  Query Plan Caching - reusing the generated store command when a query is executed more than once.
+3.  Metadata caching - sharing the metadata for a model across different connections to the same model.
+
+Besides the caches that EF provides out of the box, a special kind of ADO.NET data provider known as a wrapping provider can also be used to extend Entity Framework with a cache for the results retrieved from the database, also known as second-level caching.
+
+### 3.1 Object Caching
+
+By default when an entity is returned in the results of a query, just before EF materializes it, the ObjectContext will check if an entity with the same key has already been loaded into its ObjectStateManager. If an entity with the same keys is already present EF will include it in the results of the query. Although EF will still issue the query against the database, this behavior can bypass much of the cost of materializing the entity multiple times.
+
+#### 3.1.1 Getting entities from the object cache using DbContext Find
+
+Unlike a regular query, the Find method in DbSet (APIs included for the first time in EF 4.1) will perform a search in memory before even issuing the query against the database. It’s important to note that two different ObjectContext instances will have two different ObjectStateManager instances, meaning that they have separate object caches.
+
+Find uses the primary key value to attempt to find an entity tracked by the context. If the entity is not in the context then a query will be executed and evaluated against the database, and null is returned if the entity is not found in the context or in the database. Note that Find also returns entities that have been added to the context but have not yet been saved to the database.
+
+There is a performance consideration to be taken when using Find. Invocations to this method by default will trigger a validation of the object cache in order to detect changes that are still pending commit to the database. This process can be very expensive if there are a very large number of objects in the object cache or in a large object graph being added to the object cache, but it can also be disabled. In certain cases, you may perceive over an order of magnitude of difference in calling the Find method when you disable auto detect changes. Yet a second order of magnitude is perceived when the object actually is in the cache versus when the object has to be retrieved from the database. Here is an example graph with measurements taken using some of our microbenchmarks, expressed in milliseconds, with a load of 5000 entities:
+
+![.NET 4.5 logarithmic scale](~/ef6/media/net45logscale.png ".NET 4.5 - logarithmic scale")
+
+Example of Find with auto-detect changes disabled:
+
+``` csharp
+    context.Configuration.AutoDetectChangesEnabled = false;
+    var product = context.Products.Find(productId);
+    context.Configuration.AutoDetectChangesEnabled = true;
+    ...
+```
+
+What you have to consider when using the Find method is:
+
+1.  If the object is not in the cache the benefits of Find are negated, but the syntax is still simpler than a query by key.
+2.  If auto detect changes is enabled the cost of the Find method may increase by one order of magnitude, or even more depending on the complexity of your model and the amount of entities in your object cache.
+
+Also, keep in mind that Find only returns the entity you are looking for and it does not automatically loads its associated entities if they are not already in the object cache. If you need to retrieve associated entities, you can use a query by key with eager loading. For more information see **8.1 Lazy Loading vs. Eager Loading**.
+
+#### 3.1.2 Performance issues when the object cache has many entities
+
+The object cache helps to increase the overall responsiveness of Entity Framework. However, when the object cache has a very large amount of entities loaded it may affect certain operations such as Add, Remove, Find, Entry, SaveChanges and more. In particular, operations that trigger a call to DetectChanges will be negatively affected by very large object caches. DetectChanges synchronizes the object graph with the object state manager and its performance will determined directly by the size of the object graph. For more information about DetectChanges, see [Tracking Changes in POCO Entities](https://msdn.microsoft.com/library/dd456848.aspx).
+
+When using Entity Framework 6, developers are able to call AddRange and RemoveRange directly on a DbSet, instead of iterating on a collection and calling Add once per instance. The advantage of using the range methods is that the cost of DetectChanges is only paid once for the entire set of entities as opposed to once per each added entity.
+
+### 3.2 Query Plan Caching
+
+The first time a query is executed, it goes through the internal plan compiler to translate the conceptual query into the store command (for example, the T-SQL which is executed when run against SQL Server).  If query plan caching is enabled, the next time the query is executed the store command is retrieved directly from the query plan cache for execution, bypassing the plan compiler.
+
+The query plan cache is shared across ObjectContext instances within the same AppDomain. You don't need to hold onto an ObjectContext instance to benefit from query plan caching.
+
+#### 3.2.1 Some notes about Query Plan Caching
+
+-   The query plan cache is shared for all query types: Entity SQL, LINQ to Entities, and CompiledQuery objects.
+-   By default, query plan caching is enabled for Entity SQL queries, whether executed through an EntityCommand or through an ObjectQuery. It is also enabled by default for LINQ to Entities queries in Entity Framework on .NET 4.5, and in Entity Framework 6
+    -   Query plan caching can be disabled by setting the EnablePlanCaching property (on EntityCommand or ObjectQuery) to false. For example:
+``` csharp
+                    var query = from customer in context.Customer
+                                where customer.CustomerId == id
+                                select new
+                                {
+                                    customer.CustomerId,
+                                    customer.Name
+                                };
+                    ObjectQuery oQuery = query as ObjectQuery;
+                    oQuery.EnablePlanCaching = false;
+```
+-   For parameterized queries, changing the parameter's value will still hit the cached query. But changing a parameter's facets (for example, size, precision, or scale) will hit a different entry in the cache.
+-   When using Entity SQL, the query string is part of the key. Changing the query at all will result in different cache entries, even if the queries are functionally equivalent. This includes changes to casing or whitespace.
+-   When using LINQ, the query is processed to generate a part of the key. Changing the LINQ expression will therefore generate a different key.
+-   Other technical limitations may apply; see Autocompiled Queries for more details.
+
+#### 3.2.2      Cache eviction algorithm
+
+Understanding how the internal algorithm works will help you figure out when to enable or disable query plan caching. The cleanup algorithm is as follows:
+
+1.  Once the cache contains a set number of entries (800), we start a timer that periodically (once-per-minute) sweeps the cache.
+2.  During cache sweeps, entries are removed from the cache on a LFRU (Least frequently – recently used) basis. This algorithm takes both hit count and age into account when deciding which entries are ejected.
+3.  At the end of each cache sweep, the cache again contains 800 entries.
+
+All cache entries are treated equally when determining which entries to evict. This means the store command for a CompiledQuery has the same chance of eviction as the store command for an Entity SQL query.
+
+Note that the cache eviction timer is kicked in when there are 800 entities in the cache, but the cache is only swept 60 seconds after this timer is started. That means that for up to 60 seconds your cache may grow to be quite large.
+
+#### 3.2.3       Test Metrics demonstrating query plan caching performance
+
+To demonstrate the effect of query plan caching on your application's performance, we performed a test where we executed a number of Entity SQL queries against the Navision model. See the appendix for a description of the Navision model and the types of queries which were executed. In this test, we first iterate through the list of queries and execute each one once to add them to the cache (if caching is enabled). This step is untimed. Next, we sleep the main thread for over 60 seconds to allow cache sweeping to take place; finally, we iterate through the list a 2nd time to execute the cached queries. Additionally, the SQL Server plan cache is flushed before each set of queries is executed so that the times we obtain accurately reflect the benefit given by the query plan cache.
+
+##### 3.2.3.1       Test Results
+
+| Test                                                                   | EF5 no cache | EF5 cached | EF6 no cache | EF6 cached |
+|:-----------------------------------------------------------------------|:-------------|:-----------|:-------------|:-----------|
+| Enumerating all 18723 queries                                          | 124          | 125.4      | 124.3        | 125.3      |
+| Avoiding sweep (just the first 800 queries, regardless of complexity)  | 41.7         | 5.5        | 40.5         | 5.4        |
+| Just the AggregatingSubtotals queries (178 total - which avoids sweep) | 39.5         | 4.5        | 38.1         | 4.6        |
+
+*All times in seconds.*
+
+Moral - when executing lots of distinct queries (for example,  dynamically created queries), caching doesn't help and the resulting flushing of the cache can keep the queries that would benefit the most from plan caching from actually using it.
+
+The AggregatingSubtotals queries are the most complex of the queries we tested with. As expected, the more complex the query is, the more benefit you will see from query plan caching.
+
+Because a CompiledQuery is really a LINQ query with its plan cached, the comparison of a CompiledQuery versus the equivalent Entity SQL query should have similar results. In fact, if an app has lots of dynamic Entity SQL queries, filling the cache with queries will also effectively cause CompiledQueries to “decompile” when they are flushed from the cache. In this scenario, performance may be improved by disabling caching on the dynamic queries to prioritize the CompiledQueries. Better yet, of course, would be to rewrite the app to use parameterized queries instead of dynamic queries.
+
+### 3.3 Using CompiledQuery to improve performance with LINQ queries
+
+Our tests indicate that using CompiledQuery can bring a benefit of 7% over autocompiled LINQ queries; this means that you’ll spend 7% less time executing code from the Entity Framework stack; it does not mean your application will be 7% faster. Generally speaking, the cost of writing and maintaining CompiledQuery objects in EF 5.0 may not be worth the trouble when compared to the benefits. Your mileage may vary, so exercise this option if your project requires the extra push. Note that CompiledQueries are only compatible with ObjectContext-derived models, and not compatible with DbContext-derived models.
+
+For more information on creating and invoking a CompiledQuery, see [Compiled Queries (LINQ to Entities)](https://msdn.microsoft.com/library/bb896297.aspx).
+
+There are two considerations you have to take when using a CompiledQuery, namely the requirement to use static instances and the problems they have with composability. Here follows an in-depth explanation of these two considerations.
+
+#### 3.3.1       Use static CompiledQuery instances
+
+Since compiling a LINQ query is a time-consuming process, we don’t want to do it every time we need to fetch data from the database. CompiledQuery instances allow you to compile once and run multiple times, but you have to be careful and procure to re-use the same CompiledQuery instance every time instead of compiling it over and over again. The use of static members to store the CompiledQuery instances becomes necessary; otherwise you won’t see any benefit.
+
+For example, suppose your page has the following method body to handle displaying the products for the selected category:
+
+``` csharp
+    // Warning: this is the wrong way of using CompiledQuery
+    using (NorthwindEntities context = new NorthwindEntities())
+    {
+        string selectedCategory = this.categoriesList.SelectedValue;
+
+        var productsForCategory = CompiledQuery.Compile<NorthwindEntities, string, IQueryable<Product>>(
+            (NorthwindEntities nwnd, string category) =>
+                nwnd.Products.Where(p => p.Category.CategoryName == category)
+        );
+
+        this.productsGrid.DataSource = productsForCategory.Invoke(context, selectedCategory).ToList();
+        this.productsGrid.DataBind();
+    }
+
+    this.productsGrid.Visible = true;
+```
+
+In this case, you will create a new CompiledQuery instance on the fly every time the method is called. Instead of seeing performance benefits by retrieving the store command from the query plan cache, the CompiledQuery will go through the plan compiler every time a new instance is created. In fact, you will be polluting your query plan cache with a new CompiledQuery entry every time the method is called.
+
+Instead, you want to create a static instance of the compiled query, so you are invoking the same compiled query every time the method is called. One way to so this is by adding the CompiledQuery instance as a member of your object context.  You can then make things a little cleaner by accessing the CompiledQuery through a helper method:
+
+``` csharp
+    public partial class NorthwindEntities : ObjectContext
+    {
+        private static readonly Func<NorthwindEntities, string, IEnumerable<Product>> productsForCategoryCQ = CompiledQuery.Compile(
+            (NorthwindEntities context, string categoryName) =>
+                context.Products.Where(p => p.Category.CategoryName == categoryName)
+            );
+
+        public IEnumerable<Product> GetProductsForCategory(string categoryName)
+        {
+            return productsForCategoryCQ.Invoke(this, categoryName).ToList();
+        }
+```
+
+This helper method would be invoked as follows:
+
+``` csharp
+    this.productsGrid.DataSource = context.GetProductsForCategory(selectedCategory);
+```
+
+#### 3.3.2       Composing over a CompiledQuery
+
+The ability to compose over any LINQ query is extremely useful; to do this, you simply invoke a method after the IQueryable such as *Skip()* or *Count()*. However, doing so essentially returns a new IQueryable object. While there’s nothing to stop you technically from composing over a CompiledQuery, doing so will cause the generation of a new IQueryable object that requires passing through the plan compiler again.
+
+Some components will make use of composed IQueryable objects to enable advanced functionality. For example, ASP.NET’s GridView can be data-bound to an IQueryable object via the SelectMethod property. The GridView will then compose over this IQueryable object to allow sorting and paging over the data model. As you can see, using a CompiledQuery for the GridView would not hit the compiled query but would generate a new autocompiled query.
+
+One place where you may run into this is when adding progressive filters to a query. For example, suppose you had a Customers page with several drop-down lists for optional filters (for example, Country and OrdersCount). You can compose these filters over the IQueryable results of a CompiledQuery, but doing so will result in the new query going through the plan compiler every time you execute it.
+
+``` csharp
+    using (NorthwindEntities context = new NorthwindEntities())
+    {
+        IQueryable<Customer> myCustomers = context.InvokeCustomersForEmployee();
+
+        if (this.orderCountFilterList.SelectedItem.Value != defaultFilterText)
+        {
+            int orderCount = int.Parse(orderCountFilterList.SelectedValue);
+            myCustomers = myCustomers.Where(c => c.Orders.Count > orderCount);
+        }
+
+        if (this.countryFilterList.SelectedItem.Value != defaultFilterText)
+        {
+            myCustomers = myCustomers.Where(c => c.Address.Country == countryFilterList.SelectedValue);
+        }
+
+        this.customersGrid.DataSource = myCustomers;
+        this.customersGrid.DataBind();
+    }
+```
+
+ To avoid this re-compilation, you can rewrite the CompiledQuery to take the possible filters into account:
+
+``` csharp
+    private static readonly Func<NorthwindEntities, int, int?, string, IQueryable<Customer>> customersForEmployeeWithFiltersCQ = CompiledQuery.Compile(
+        (NorthwindEntities context, int empId, int? countFilter, string countryFilter) =>
+            context.Customers.Where(c => c.Orders.Any(o => o.EmployeeID == empId))
+            .Where(c => countFilter.HasValue == false || c.Orders.Count > countFilter)
+            .Where(c => countryFilter == null || c.Address.Country == countryFilter)
+        );
+```
+
+Which would be invoked in the UI like:
+
+``` csharp
+    using (NorthwindEntities context = new NorthwindEntities())
+    {
+        int? countFilter = (this.orderCountFilterList.SelectedIndex == 0) ?
+            (int?)null :
+            int.Parse(this.orderCountFilterList.SelectedValue);
+
+        string countryFilter = (this.countryFilterList.SelectedIndex == 0) ?
+            null :
+            this.countryFilterList.SelectedValue;
+
+        IQueryable<Customer> myCustomers = context.InvokeCustomersForEmployeeWithFilters(
+                countFilter, countryFilter);
+
+        this.customersGrid.DataSource = myCustomers;
+        this.customersGrid.DataBind();
+    }
+```
+
+ A tradeoff here is the generated store command will always have the filters with the null checks, but these should be fairly simple for the database server to optimize:
+
+``` SQL
+...
+WHERE ((0 = (CASE WHEN (@p__linq__1 IS NOT NULL) THEN cast(1 as bit) WHEN (@p__linq__1 IS NULL) THEN cast(0 as bit) END)) OR ([Project3].[C2] > @p__linq__2)) AND (@p__linq__3 IS NULL OR [Project3].[Country] = @p__linq__4)
+```
+
+### 3.4 Metadata caching
+
+The Entity Framework also supports Metadata caching. This is essentially caching of type information and type-to-database mapping information across different connections to the same model. The Metadata cache is unique per AppDomain.
+
+#### 3.4.1 Metadata Caching algorithm
+
+1.  Metadata information for a model is stored in an ItemCollection for each EntityConnection.
+    -   As a side note, there are different ItemCollection objects for different parts of the model. For example, StoreItemCollections contains the information about the database model; ObjectItemCollection contains information about the data model; EdmItemCollection contains information about the conceptual model.
+
+2.  If two connections use the same connection string, they will share the same ItemCollection instance.
+3.  Functionally equivalent but textually different connection strings may result in different metadata caches. We do tokenize connection strings, so simply changing the order of the tokens should result in shared metadata. But two connection strings that seem functionally the same may not be evaluated as identical after tokenization.
+4.  The ItemCollection is periodically checked for use. If it is determined that a workspace has not been accessed recently, it will be marked for cleanup on the next cache sweep.
+5.  Merely creating an EntityConnection will cause a metadata cache to be created (though the item collections in it will not be initialized until the connection is opened). This workspace will remain in-memory until the caching algorithm determines it is not “in use”.
+
+The Customer Advisory Team has written a blog post that describes holding a reference to an ItemCollection in order to avoid "deprecation" when using large models: \<https://learn.microsoft.com/archive/blogs/appfabriccat/holding-a-reference-to-the-ef-metadataworkspace-for-wcf-services>.
+
+#### 3.4.2 The relationship between Metadata Caching and Query Plan Caching
+
+The query plan cache instance lives in the MetadataWorkspace's ItemCollection of store types. This means that cached store commands will be used for queries against any context instantiated using a given MetadataWorkspace. It also means that if you have two connections strings that are slightly different and don't match after tokenizing, you will have different query plan cache instances.
+
+### 3.5 Results caching
+
+With results caching (also known as "second-level caching"), you keep the results of queries in a local cache. When issuing a query, you first see if the results are available locally before you query against the store. While results caching isn't directly supported by Entity Framework, it's possible to add a second level cache by using a wrapping provider. An example wrapping provider with a second-level cache is Alachisoft's [Entity Framework Second Level Cache based on NCache](https://www.alachisoft.com/ncache/entity-framework.html).
+
+This implementation of second-level caching is an injected functionality that takes place after the LINQ expression has been evaluated (and funcletized) and the query execution plan is computed or retrieved from the first-level cache. The second-level cache will then store only the raw database results, so the materialization pipeline still executes afterwards.
+
+#### 3.5.1 Additional references for results caching with the wrapping provider
+
+-   Julie Lerman has written a "Second-Level Caching in Entity Framework and Windows Azure" MSDN article that includes how to update the sample wrapping provider to use Windows Server AppFabric caching: [https://msdn.microsoft.com/magazine/hh394143.aspx](https://msdn.microsoft.com/magazine/hh394143.aspx)
+-   If you are working with Entity Framework 5, the team blog has a post that describes how to get things running with the caching provider for Entity Framework 5: \<https://learn.microsoft.com/archive/blogs/adonet/ef-caching-with-jarek-kowalskis-provider>. It also includes a T4 template to help automate adding the 2nd-level caching to your project.
+
+## 4 Autocompiled Queries
+
+When a query is issued against a database using Entity Framework, it must go through a series of steps before actually materializing the results; one such step is Query Compilation. Entity SQL queries were known to have good performance as they are automatically cached, so the second or third time you execute the same query it can skip the plan compiler and use the cached plan instead.
+
+Entity Framework 5 introduced automatic caching for LINQ to Entities queries as well. In past editions of Entity Framework creating a CompiledQuery to speed your performance was a common practice, as this would make your LINQ to Entities query cacheable. Since caching is now done automatically without the use of a CompiledQuery, we call this feature “autocompiled queries”. For more information about the query plan cache and its mechanics, see Query Plan Caching.
+
+Entity Framework detects when a query requires to be recompiled, and does so when the query is invoked even if it had been compiled before. Common conditions that cause the query to be recompiled are:
+
+-   Changing the MergeOption associated to your query. The cached query will not be used, instead the plan compiler will run again and the newly created plan gets cached.
+-   Changing the value of ContextOptions.UseCSharpNullComparisonBehavior. You get the same effect as changing the MergeOption.
+
+Other conditions can prevent your query from using the cache. Common examples are:
+
+-   Using IEnumerable&lt;T&gt;.Contains&lt;&gt;(T value).
+-   Using functions that produce queries with constants.
+-   Using the properties of a non-mapped object.
+-   Linking your query to another query that requires to be recompiled.
+
+### 4.1 Using IEnumerable&lt;T&gt;.Contains&lt;T&gt;(T value)
+
+Entity Framework does not cache queries that invoke IEnumerable&lt;T&gt;.Contains&lt;T&gt;(T value) against an in-memory collection, since the values of the collection are considered volatile. The following example query will not be cached, so it will always be processed by the plan compiler:
+
+``` csharp
+int[] ids = new int[10000];
+...
+using (var context = new MyContext())
+{
+    var query = context.MyEntities
+                    .Where(entity => ids.Contains(entity.Id));
+
+    var results = query.ToList();
+    ...
+}
+```
+
+Note that the size of the IEnumerable against which Contains is executed determines how fast or how slow your query is compiled. Performance can suffer significantly when using large collections such as the one shown in the example above.
+
+Entity Framework 6 contains optimizations to the way IEnumerable&lt;T&gt;.Contains&lt;T&gt;(T value) works when queries are executed. The SQL code that is generated is much faster to produce and more readable, and in most cases it also executes faster in the server.
+
+### 4.2 Using functions that produce queries with constants
+
+The Skip(), Take(), Contains() and DefautIfEmpty() LINQ operators do not produce SQL queries with parameters but instead put the values passed to them as constants. Because of this, queries that might otherwise be identical end up polluting the query plan cache, both on the EF stack and on the database server, and do not get reutilized unless the same constants are used in a subsequent query execution. For example:
+
+``` csharp
+var id = 10;
+...
+using (var context = new MyContext())
+{
+    var query = context.MyEntities.Select(entity => entity.Id).Contains(id);
+
+    var results = query.ToList();
+    ...
+}
+```
+
+In this example, each time this query is executed with a different value for id the query will be compiled into a new plan.
+
+In particular pay attention to the use of Skip and Take when doing paging. In EF6 these methods have a lambda overload that effectively makes the cached query plan reusable because EF can capture variables passed to these methods and translate them to SQLparameters. This also helps keep the cache cleaner since otherwise each query with a different constant for Skip and Take would get its own query plan cache entry.
+
+Consider the following code, which is suboptimal but is only meant to exemplify this class of queries:
+
+``` csharp
+var customers = context.Customers.OrderBy(c => c.LastName);
+for (var i = 0; i < count; ++i)
+{
+    var currentCustomer = customers.Skip(i).FirstOrDefault();
+    ProcessCustomer(currentCustomer);
+}
+```
+
+A faster version of this same code would involve calling Skip with a lambda:
+
+``` csharp
+var customers = context.Customers.OrderBy(c => c.LastName);
+for (var i = 0; i < count; ++i)
+{
+    var currentCustomer = customers.Skip(() => i).FirstOrDefault();
+    ProcessCustomer(currentCustomer);
+}
+```
+
+The second snippet may run up to 11% faster because the same query plan is used every time the query is run, which saves CPU time and avoids polluting the query cache. Furthermore, because the parameter to Skip is in a closure the code might as well look like this now:
+
+``` csharp
+var i = 0;
+var skippyCustomers = context.Customers.OrderBy(c => c.LastName).Skip(() => i);
+for (; i < count; ++i)
+{
+    var currentCustomer = skippyCustomers.FirstOrDefault();
+    ProcessCustomer(currentCustomer);
+}
+```
+
+### 4.3 Using the properties of a non-mapped object
+
+When a query uses the properties of a non-mapped object type as a parameter then the query will not get cached. For example:
+
+``` csharp
+using (var context = new MyContext())
+{
+    var myObject = new NonMappedType();
+
+    var query = from entity in context.MyEntities
+                where entity.Name.StartsWith(myObject.MyProperty)
+                select entity;
+
+   var results = query.ToList();
+    ...
+}
+```
+
+In this example, assume that class NonMappedType is not part of the Entity model. This query can easily be changed to not use a non-mapped type and instead use a local variable as the parameter to the query:
+
+``` csharp
+using (var context = new MyContext())
+{
+    var myObject = new NonMappedType();
+    var myValue = myObject.MyProperty;
+    var query = from entity in context.MyEntities
+                where entity.Name.StartsWith(myValue)
+                select entity;
+
+    var results = query.ToList();
+    ...
+}
+```
+
+In this case, the query will be able to get cached and will benefit from the query plan cache.
+
+### 4.4 Linking to queries that require recompiling
+
+Following the same example as above, if you have a second query that relies on a query that needs to be recompiled, your entire second query will also be recompiled. Here’s an example to illustrate this scenario:
+
+``` csharp
+int[] ids = new int[10000];
+...
+using (var context = new MyContext())
+{
+    var firstQuery = from entity in context.MyEntities
+                        where ids.Contains(entity.Id)
+                        select entity;
+
+    var secondQuery = from entity in context.MyEntities
+                        where firstQuery.Any(otherEntity => otherEntity.Id == entity.Id)
+                        select entity;
+
+    var results = secondQuery.ToList();
+    ...
+}
+```
+
+The example is generic, but it illustrates how linking to firstQuery is causing secondQuery to be unable to get cached. If firstQuery had not been a query that requires recompiling, then secondQuery would have been cached.
+
+## 5 NoTracking Queries
+
+### 5.1 Disabling change tracking to reduce state management overhead
+
+If you are in a read-only scenario and want to avoid the overhead of loading the objects into the ObjectStateManager, you can issue "No Tracking" queries.  Change tracking can be disabled at the query level.
+
+Note though that by disabling change tracking you are effectively turning off the object cache. When you query for an entity, we can't skip materialization by pulling the previously-materialized query results from the ObjectStateManager. If you are repeatedly querying for the same entities on the same context, you might actually see a performance benefit from enabling change tracking.
+
+When querying using ObjectContext, ObjectQuery and ObjectSet instances will remember a MergeOption once it is set, and queries that are composed on them will inherit the effective MergeOption of the parent query. When using DbContext, tracking can be disabled by calling the AsNoTracking() modifier on the DbSet.
+
+#### 5.1.1 Disabling change tracking for a query when using DbContext
+
+You can switch the mode of a query to NoTracking by chaining a call to the AsNoTracking() method in the query. Unlike ObjectQuery, the DbSet and DbQuery classes in the DbContext API don’t have a mutable property for the MergeOption.
+
+``` csharp
+    var productsForCategory = from p in context.Products.AsNoTracking()
+                                where p.Category.CategoryName == selectedCategory
+                                select p;
+
+
+```
+
+#### 5.1.2 Disabling change tracking at the query level using ObjectContext
+
+``` csharp
+    var productsForCategory = from p in context.Products
+                                where p.Category.CategoryName == selectedCategory
+                                select p;
+
+    ((ObjectQuery)productsForCategory).MergeOption = MergeOption.NoTracking;
+```
+
+#### 5.1.3 Disabling change tracking for an entire entity set using ObjectContext
+
+``` csharp
+    context.Products.MergeOption = MergeOption.NoTracking;
+
+    var productsForCategory = from p in context.Products
+                                where p.Category.CategoryName == selectedCategory
+                                select p;
+```
+
+### 5.2 Test Metrics demonstrating the performance benefit of NoTracking queries
+
+In this test we look at the cost of filling the ObjectStateManager by comparing Tracking to NoTracking queries for the Navision model. See the appendix for a description of the Navision model and the types of queries which were executed. In this test, we iterate through the list of queries and execute each one once. We ran two variations of the test, once with NoTracking queries and once with the default merge option of "AppendOnly". We ran each variation 3 times and take the mean value of the runs. Between the tests we clear the query cache on the SQL Server and shrink the tempdb by running the following commands:
+
+1.  DBCC DROPCLEANBUFFERS
+2.  DBCC FREEPROCCACHE
+3.  DBCC SHRINKDATABASE (tempdb, 0)
+
+Test Results, median over 3 runs:
+
+|                        | NO TRACKING – WORKING SET | NO TRACKING – TIME | APPEND ONLY – WORKING SET | APPEND ONLY – TIME |
+|:-----------------------|:--------------------------|:-------------------|:--------------------------|:-------------------|
+| **Entity Framework 5** | 460361728                 | 1163536 ms         | 596545536                 | 1273042 ms         |
+| **Entity Framework 6** | 647127040                 | 190228 ms          | 832798720                 | 195521 ms          |
+
+Entity Framework 5 will have a smaller memory footprint at the end of the run than Entity Framework 6 does. The additional memory consumed by Entity Framework 6 is the result of additional memory structures and code that enable new features and better performance.
+
+There’s also a clear difference in memory footprint when using the ObjectStateManager. Entity Framework 5 increased its footprint by 30% when keeping track of all the entities we materialized from the database. Entity Framework 6 increased its footprint by 28% when doing so.
+
+In terms of time, Entity Framework 6 outperforms Entity Framework 5 in this test by a large margin. Entity Framework 6 completed the test in roughly 16% of the time consumed by Entity Framework 5. Additionally, Entity Framework 5 takes 9% more time to complete when the ObjectStateManager is being used. In comparison, Entity Framework 6 is using 3% more time when using the ObjectStateManager.
+
+## 6 Query Execution Options
+
+Entity Framework offers several different ways to query. We'll take a look at the following options, compare the pros and cons of each, and examine their performance characteristics:
+
+-   LINQ to Entities.
+-   No Tracking LINQ to Entities.
+-   Entity SQL over an ObjectQuery.
+-   Entity SQL over an EntityCommand.
+-   ExecuteStoreQuery.
+-   SqlQuery.
+-   CompiledQuery.
+
+### 6.1       LINQ to Entities queries
+
+``` csharp
+var q = context.Products.Where(p => p.Category.CategoryName == "Beverages");
+```
+
+**Pros**
+
+-   Suitable for CUD operations.
+-   Fully materialized objects.
+-   Simplest to write with syntax built into the programming language.
+-   Good performance.
+
+**Cons**
+
+-   Certain technical restrictions, such as:
+    -   Patterns using DefaultIfEmpty for OUTER JOIN queries result in more complex queries than simple OUTER JOIN statements in Entity SQL.
+    -   You still can’t use LIKE with general pattern matching.
+
+### 6.2       No Tracking LINQ to Entities queries
+
+When the context derives ObjectContext:
+
+``` csharp
+context.Products.MergeOption = MergeOption.NoTracking;
+var q = context.Products.Where(p => p.Category.CategoryName == "Beverages");
+```
+
+When the context derives DbContext:
+
+``` csharp
+var q = context.Products.AsNoTracking()
+                        .Where(p => p.Category.CategoryName == "Beverages");
+```
+
+**Pros**
+
+-   Improved performance over regular LINQ queries.
+-   Fully materialized objects.
+-   Simplest to write with syntax built into the programming language.
+
+**Cons**
+
+-   Not suitable for CUD operations.
+-   Certain technical restrictions, such as:
+    -   Patterns using DefaultIfEmpty for OUTER JOIN queries result in more complex queries than simple OUTER JOIN statements in Entity SQL.
+    -   You still can’t use LIKE with general pattern matching.
+
+Note that queries that project scalar properties are not tracked even if the NoTracking is not specified. For example:
+
+``` csharp
+var q = context.Products.Where(p => p.Category.CategoryName == "Beverages").Select(p => new { p.ProductName });
+```
+
+This particular query doesn’t explicitly specify being NoTracking, but since it’s not materializing a type that’s known to the object state manager then the materialized result is not tracked.
+
+### 6.3       Entity SQL over an ObjectQuery
+
+``` csharp
+ObjectQuery<Product> products = context.Products.Where("it.Category.CategoryName = 'Beverages'");
+```
+
+**Pros**
+
+-   Suitable for CUD operations.
+-   Fully materialized objects.
+-   Supports query plan caching.
+
+**Cons**
+
+-   Involves textual query strings which are more prone to user error than query constructs built into the language.
+
+### 6.4       Entity SQL over an Entity Command
+
+``` csharp
+EntityCommand cmd = eConn.CreateCommand();
+cmd.CommandText = "Select p From NorthwindEntities.Products As p Where p.Category.CategoryName = 'Beverages'";
+
+using (EntityDataReader reader = cmd.ExecuteReader(CommandBehavior.SequentialAccess))
+{
+    while (reader.Read())
+    {
+        // manually 'materialize' the product
+    }
+}
+```
+
+**Pros**
+
+-   Supports query plan caching in .NET 4.0 (plan caching is supported by all other query types in .NET 4.5).
+
+**Cons**
+
+-   Involves textual query strings which are more prone to user error than query constructs built into the language.
+-   Not suitable for CUD operations.
+-   Results are not automatically materialized, and must be read from the data reader.
+
+### 6.5       SqlQuery and ExecuteStoreQuery
+
+SqlQuery on Database:
+
+``` csharp
+// use this to obtain entities and not track them
+var q1 = context.Database.SqlQuery<Product>("select * from products");
+```
+
+SqlQuery on DbSet:
+
+``` csharp
+// use this to obtain entities and have them tracked
+var q2 = context.Products.SqlQuery("select * from products");
+```
+
+ExecuteStoreQuery:
+
+``` csharp
+var beverages = context.ExecuteStoreQuery<Product>(
+@"     SELECT        P.ProductID, P.ProductName, P.SupplierID, P.CategoryID, P.QuantityPerUnit, P.UnitPrice, P.UnitsInStock, P.UnitsOnOrder, P.ReorderLevel, P.Discontinued, P.DiscontinuedDate
+       FROM            Products AS P INNER JOIN Categories AS C ON P.CategoryID = C.CategoryID
+       WHERE        (C.CategoryName = 'Beverages')"
+);
+```
+
+**Pros**
+
+-   Generally fastest performance since plan compiler is bypassed.
+-   Fully materialized objects.
+-   Suitable for CUD operations when used from the DbSet.
+
+**Cons**
+
+-   Query is textual and error prone.
+-   Query is tied to a specific backend by using store semantics instead of conceptual semantics.
+-   When inheritance is present, handcrafted query needs to account for mapping conditions for the type requested.
+
+### 6.6       CompiledQuery
+
+``` csharp
+private static readonly Func<NorthwindEntities, string, IQueryable<Product>> productsForCategoryCQ = CompiledQuery.Compile(
+    (NorthwindEntities context, string categoryName) =>
+        context.Products.Where(p => p.Category.CategoryName == categoryName)
+        );
+…
+var q = context.InvokeProductsForCategoryCQ("Beverages");
+```
+
+**Pros**
+
+-   Provides up to a 7% performance improvement over regular LINQ queries.
+-   Fully materialized objects.
+-   Suitable for CUD operations.
+
+**Cons**
+
+-   Increased complexity and programming overhead.
+-   The performance improvement is lost when composing on top of a compiled query.
+-   Some LINQ queries can't be written as a CompiledQuery - for example, projections of anonymous types.
+
+### 6.7       Performance Comparison of different query options
+
+Simple microbenchmarks where the context creation was not timed were put to the test. We measured querying 5000 times for a set of non-cached entities in a controlled environment. These numbers are to be taken with a warning: they do not reflect actual numbers produced by an application, but instead they are a very accurate measurement of how much of a performance difference there is when different querying options are compared apples-to-apples, excluding the cost of creating a new context.
+
+| EF  | Test                                 | Time (ms) | Memory   |
+|:----|:-------------------------------------|:----------|:---------|
+| EF5 | ObjectContext ESQL                   | 2414      | 38801408 |
+| EF5 | ObjectContext Linq Query             | 2692      | 38277120 |
+| EF5 | DbContext Linq Query No Tracking     | 2818      | 41840640 |
+| EF5 | DbContext Linq Query                 | 2930      | 41771008 |
+| EF5 | ObjectContext Linq Query No Tracking | 3013      | 38412288 |
+|     |                                      |           |          |
+| EF6 | ObjectContext ESQL                   | 2059      | 46039040 |
+| EF6 | ObjectContext Linq Query             | 3074      | 45248512 |
+| EF6 | DbContext Linq Query No Tracking     | 3125      | 47575040 |
+| EF6 | DbContext Linq Query                 | 3420      | 47652864 |
+| EF6 | ObjectContext Linq Query No Tracking | 3593      | 45260800 |
+
+![EF5 micro benchmarks, 5000 warm iterations](~/ef6/media/ef5micro5000warm.png)
+
+![EF6 micro benchmarks, 5000 warm iterations](~/ef6/media/ef6micro5000warm.png)
+
+Microbenchmarks are very sensitive to small changes in the code. In this case, the difference between the costs of Entity Framework 5 and Entity Framework 6 are due to the addition of [interception](xref:ef6/fundamentals/logging-and-interception) and [transactional improvements](xref:ef6/saving/transactions). These microbenchmarks numbers, however, are an amplified vision into a very small fragment of what Entity Framework does. Real-world scenarios of warm queries should not see a performance regression when upgrading from Entity Framework 5 to Entity Framework 6.
+
+To compare the real-world performance of the different query options, we created 5 separate test variations where we use a different query option to select all products whose category name is "Beverages". Each iteration includes the cost of creating the context, and the cost of materializing all returned entities. 10 iterations are run untimed before taking the sum of 1000 timed iterations. The results shown are the median run taken from 5 runs of each test. For more information, see Appendix B which includes the code for the test.
+
+| EF  | Test                                        | Time (ms) | Memory   |
+|:----|:--------------------------------------------|:----------|:---------|
+| EF5 | ObjectContext Entity Command                | 621       | 39350272 |
+| EF5 | DbContext Sql Query on Database             | 825       | 37519360 |
+| EF5 | ObjectContext Store Query                   | 878       | 39460864 |
+| EF5 | ObjectContext Linq Query No Tracking        | 969       | 38293504 |
+| EF5 | ObjectContext Entity Sql using Object Query | 1089      | 38981632 |
+| EF5 | ObjectContext Compiled Query                | 1099      | 38682624 |
+| EF5 | ObjectContext Linq Query                    | 1152      | 38178816 |
+| EF5 | DbContext Linq Query No Tracking            | 1208      | 41803776 |
+| EF5 | DbContext Sql Query on DbSet                | 1414      | 37982208 |
+| EF5 | DbContext Linq Query                        | 1574      | 41738240 |
+|     |                                             |           |          |
+| EF6 | ObjectContext Entity Command                | 480       | 47247360 |
+| EF6 | ObjectContext Store Query                   | 493       | 46739456 |
+| EF6 | DbContext Sql Query on Database             | 614       | 41607168 |
+| EF6 | ObjectContext Linq Query No Tracking        | 684       | 46333952 |
+| EF6 | ObjectContext Entity Sql using Object Query | 767       | 48865280 |
+| EF6 | ObjectContext Compiled Query                | 788       | 48467968 |
+| EF6 | DbContext Linq Query No Tracking            | 878       | 47554560 |
+| EF6 | ObjectContext Linq Query                    | 953       | 47632384 |
+| EF6 | DbContext Sql Query on DbSet                | 1023      | 41992192 |
+| EF6 | DbContext Linq Query                        | 1290      | 47529984 |
+
+
+![EF5 warm query 1000 iterations](~/ef6/media/ef5warmquery1000.png)
+
+![EF6 warm query 1000 iterations](~/ef6/media/ef6warmquery1000.png)
+
+> [!NOTE]
+> For completeness, we included a variation where we execute an Entity SQL query on an EntityCommand. However, because results are not materialized for such queries, the comparison isn't necessarily apples-to-apples. The test includes a close approximation to materializing to try making the comparison fairer.
+
+In this end-to-end case, Entity Framework 6 outperforms Entity Framework 5 due to performance improvements made on several parts of the stack, including a much lighter DbContext initialization and faster MetadataCollection&lt;T&gt; lookups.
+
+## 7 Design time performance considerations
+
+### 7.1       Inheritance Strategies
+
+Another performance consideration when using Entity Framework is the inheritance strategy you use. Entity Framework supports 3 basic types of inheritance and their combinations:
+
+-   Table per Hierarchy (TPH) – where each inheritance set maps to a table with a discriminator column to indicate which particular type in the hierarchy is being represented in the row.
+-   Table per Type (TPT) – where each type has its own table in the database; the child tables only define the columns that the parent table doesn’t contain.
+-   Table per Class (TPC) – where each type has its own full table in the database; the child tables define all their fields, including those defined in parent types.
+
+If your model uses TPT inheritance, the queries which are generated will be more complex than those that are generated with the other inheritance strategies, which may result on longer execution times on the store.  It will generally take longer to generate queries over a TPT model, and to materialize the resulting objects.
+
+See the "Performance Considerations when using TPT (Table per Type) Inheritance in the Entity Framework" MSDN blog post: \<https://learn.microsoft.com/archive/blogs/adonet/performance-considerations-when-using-tpt-table-per-type-inheritance-in-the-entity-framework>.
+
+#### 7.1.1       Avoiding TPT in Model First or Code First applications
+
+When you create a model over an existing database that has a TPT schema, you don't have many options. But when creating an application using Model First or Code First, you should avoid TPT inheritance for performance concerns.
+
+When you use Model First in the Entity Designer Wizard, you will get TPT for any inheritance in your model. If you want to switch to a TPH inheritance strategy with Model First, you can use the "Entity Designer Database Generation Power Pack" available from the Visual Studio Gallery ( \<http://visualstudiogallery.msdn.microsoft.com/df3541c3-d833-4b65-b942-989e7ec74c87/>).
+
+When using Code First to configure the mapping of a model with inheritance, EF will use TPH by default, therefore all entities in the inheritance hierarchy will be mapped to the same table. See the "Mapping with the Fluent API" section of the "Code First in Entity Framework4.1" article in MSDN Magazine ( [http://msdn.microsoft.com/magazine/hh126815.aspx](https://msdn.microsoft.com/magazine/hh126815.aspx)) for more details.
+
+### 7.2       Upgrading from EF4 to improve model generation time
+
+A SQL Server-specific improvement to the algorithm that generates the store-layer (SSDL) of the model is available in Entity Framework 5 and 6, and as an update to Entity Framework 4 when Visual Studio 2010 SP1 is installed. The following test results demonstrate the improvement when generating a very big model, in this case the Navision model. See Appendix C for more details about it.
+
+The model contains 1005 entity sets and 4227 association sets.
+
+| Configuration                              | Breakdown of time consumed                                                                                                                                               |
+|:-------------------------------------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| Visual Studio 2010, Entity Framework 4     | SSDL Generation: 2 hr 27 min <br/> Mapping Generation: 1 second <br/> CSDL Generation: 1 second <br/> ObjectLayer Generation: 1 second <br/> View Generation: 2 h 14 min |
+| Visual Studio 2010 SP1, Entity Framework 4 | SSDL Generation: 1 second <br/> Mapping Generation: 1 second <br/> CSDL Generation: 1 second <br/> ObjectLayer Generation: 1 second <br/> View Generation: 1 hr 53 min   |
+| Visual Studio 2013, Entity Framework 5     | SSDL Generation: 1 second <br/> Mapping Generation: 1 second <br/> CSDL Generation: 1 second <br/> ObjectLayer Generation: 1 second <br/> View Generation: 65 minutes    |
+| Visual Studio 2013, Entity Framework 6     | SSDL Generation: 1 second <br/> Mapping Generation: 1 second <br/> CSDL Generation: 1 second <br/> ObjectLayer Generation: 1 second <br/> View Generation: 28 seconds.   |
+
+
+It's worth noting that when generating the SSDL, the load is almost entirely spent on the SQL Server, while the client development machine is waiting idle for results to come back from the server. DBAs should particularly appreciate this improvement. It's also worth noting that essentially the entire cost of model generation takes place in View Generation now.
+
+### 7.3       Splitting Large Models with Database First and Model First
+
+As model size increases, the designer surface becomes cluttered and difficult to use. We typically consider a model with more than 300 entities to be too large to effectively use the designer. The following blog post describes several options for splitting large models: \<https://learn.microsoft.com/archive/blogs/adonet/working-with-large-models-in-entity-framework-part-2>.
+
+The post was written for the first version of Entity Framework, but the steps still apply.
+
+### 7.4       Performance considerations with the Entity Data Source Control
+
+We've seen cases in multi-threaded performance and stress tests where the performance of a web application using the EntityDataSource Control deteriorates significantly. The underlying cause is that the EntityDataSource repeatedly calls MetadataWorkspace.LoadFromAssembly on the assemblies referenced by the Web application to discover the types to be used as entities.
+
+The solution is to set the ContextTypeName of the EntityDataSource to the type name of your derived ObjectContext class. This turns off the mechanism that scans all referenced assemblies for entity types.
+
+Setting the ContextTypeName field also prevents a functional problem where the EntityDataSource in .NET 4.0 throws a ReflectionTypeLoadException when it can't load a type from an assembly via reflection. This issue has been fixed in .NET 4.5.
+
+### 7.5       POCO entities and change tracking proxies
+
+Entity Framework enables you to use custom data classes together with your data model without making any modifications to the data classes themselves. This means that you can use "plain-old" CLR objects (POCO), such as existing domain objects, with your data model. These POCO data classes (also known as persistence-ignorant objects), which are mapped to entities that are defined in a data model, support most of the same query, insert, update, and delete behaviors as entity types that are generated by the Entity Data Model tools.
+
+Entity Framework can also create proxy classes derived from your POCO types, which are used when you want to enable features such as lazy loading and automatic change tracking on POCO entities. Your POCO classes must meet certain requirements to allow Entity Framework to use proxies, as described here: [http://msdn.microsoft.com/library/dd468057.aspx](https://msdn.microsoft.com/library/dd468057.aspx).
+
+Chance tracking proxies will notify the object state manager each time any of the properties of your entities has its value changed, so Entity Framework knows the actual state of your entities all the time. This is done by adding notification events to the body of the setter methods of your properties, and having the object state manager processing such events. Note that creating a proxy entity will typically be more expensive than creating a non-proxy POCO entity due to the added set of events created by Entity Framework.
+
+When a POCO entity does not have a change tracking proxy, changes are found by comparing the contents of your entities against a copy of a previous saved state. This deep comparison will become a lengthy process when you have many entities in your context, or when your entities have a very large amount of properties, even if none of them changed since the last comparison took place.
+
+In summary: you’ll pay a performance hit when creating the change tracking proxy, but change tracking will help you speed up the change detection process when your entities have many properties or when you have many entities in your model. For entities with a small number of properties where the amount of entities doesn’t grow too much, having change tracking proxies may not be of much benefit.
+
+## 8 Loading Related Entities
+
+### 8.1 Lazy Loading vs. Eager Loading
+
+Entity Framework offers several different ways to load the entities that are related to your target entity. For example, when you query for Products, there are different ways that the related Orders will be loaded into the Object State Manager. From a performance standpoint, the biggest question to consider when loading related entities will be whether to use Lazy Loading or Eager Loading.
+
+When using Eager Loading, the related entities are loaded along with your target entity set. You use an Include statement in your query to indicate which related entities you want to bring in.
+
+When using Lazy Loading, your initial query only brings in the target entity set. But whenever you access a navigation property, another query is issued against the store to load the related entity.
+
+Once an entity has been loaded, any further queries for the entity will load it directly from the Object State Manager, whether you are using lazy loading or eager loading.
+
+### 8.2 How to choose between Lazy Loading and Eager Loading
+
+The important thing is that you understand the difference between Lazy Loading and Eager Loading so that you can make the correct choice for your application. This will help you evaluate the tradeoff between multiple requests against the database versus a single request that may contain a large payload. It may be appropriate to use eager loading in some parts of your application and lazy loading in other parts.
+
+As an example of what's happening under the hood, suppose you want to query for the customers who live in the UK and their order count.
+
+**Using Eager Loading**
+
+``` csharp
+using (NorthwindEntities context = new NorthwindEntities())
+{
+    var ukCustomers = context.Customers.Include(c => c.Orders).Where(c => c.Address.Country == "UK");
+    var chosenCustomer = AskUserToPickCustomer(ukCustomers);
+    Console.WriteLine("Customer Id: {0} has {1} orders", customer.CustomerID, customer.Orders.Count);
+}
+```
+
+**Using Lazy Loading**
+
+``` csharp
+using (NorthwindEntities context = new NorthwindEntities())
+{
+    context.ContextOptions.LazyLoadingEnabled = true;
+
+    //Notice that the Include method call is missing in the query
+    var ukCustomers = context.Customers.Where(c => c.Address.Country == "UK");
+
+    var chosenCustomer = AskUserToPickCustomer(ukCustomers);
+    Console.WriteLine("Customer Id: {0} has {1} orders", customer.CustomerID, customer.Orders.Count);
+}
+```
+
+When using eager loading, you'll issue a single query that returns all customers and all orders. The store command looks like:
+
+``` SQL
+SELECT
+[Project1].[C1] AS [C1],
+[Project1].[CustomerID] AS [CustomerID],
+[Project1].[CompanyName] AS [CompanyName],
+[Project1].[ContactName] AS [ContactName],
+[Project1].[ContactTitle] AS [ContactTitle],
+[Project1].[Address] AS [Address],
+[Project1].[City] AS [City],
+[Project1].[Region] AS [Region],
+[Project1].[PostalCode] AS [PostalCode],
+[Project1].[Country] AS [Country],
+[Project1].[Phone] AS [Phone],
+[Project1].[Fax] AS [Fax],
+[Project1].[C2] AS [C2],
+[Project1].[OrderID] AS [OrderID],
+[Project1].[CustomerID1] AS [CustomerID1],
+[Project1].[EmployeeID] AS [EmployeeID],
+[Project1].[OrderDate] AS [OrderDate],
+[Project1].[RequiredDate] AS [RequiredDate],
+[Project1].[ShippedDate] AS [ShippedDate],
+[Project1].[ShipVia] AS [ShipVia],
+[Project1].[Freight] AS [Freight],
+[Project1].[ShipName] AS [ShipName],
+[Project1].[ShipAddress] AS [ShipAddress],
+[Project1].[ShipCity] AS [ShipCity],
+[Project1].[ShipRegion] AS [ShipRegion],
+[Project1].[ShipPostalCode] AS [ShipPostalCode],
+[Project1].[ShipCountry] AS [ShipCountry]
+FROM ( SELECT
+      [Extent1].[CustomerID] AS [CustomerID],
+       [Extent1].[CompanyName] AS [CompanyName],
+       [Extent1].[ContactName] AS [ContactName],
+       [Extent1].[ContactTitle] AS [ContactTitle],
+       [Extent1].[Address] AS [Address],
+       [Extent1].[City] AS [City],
+       [Extent1].[Region] AS [Region],
+       [Extent1].[PostalCode] AS [PostalCode],
+       [Extent1].[Country] AS [Country],
+       [Extent1].[Phone] AS [Phone],
+       [Extent1].[Fax] AS [Fax],
+      1 AS [C1],
+       [Extent2].[OrderID] AS [OrderID],
+       [Extent2].[CustomerID] AS [CustomerID1],
+       [Extent2].[EmployeeID] AS [EmployeeID],
+       [Extent2].[OrderDate] AS [OrderDate],
+       [Extent2].[RequiredDate] AS [RequiredDate],
+       [Extent2].[ShippedDate] AS [ShippedDate],
+       [Extent2].[ShipVia] AS [ShipVia],
+       [Extent2].[Freight] AS [Freight],
+       [Extent2].[ShipName] AS [ShipName],
+       [Extent2].[ShipAddress] AS [ShipAddress],
+       [Extent2].[ShipCity] AS [ShipCity],
+       [Extent2].[ShipRegion] AS [ShipRegion],
+       [Extent2].[ShipPostalCode] AS [ShipPostalCode],
+       [Extent2].[ShipCountry] AS [ShipCountry],
+      CASE WHEN ([Extent2].[OrderID] IS NULL) THEN CAST(NULL AS int) ELSE 1 END AS [C2]
+      FROM  [dbo].[Customers] AS [Extent1]
+      LEFT OUTER JOIN [dbo].[Orders] AS [Extent2] ON [Extent1].[CustomerID] = [Extent2].[CustomerID]
+      WHERE N'UK' = [Extent1].[Country]
+)  AS [Project1]
+ORDER BY [Project1].[CustomerID] ASC, [Project1].[C2] ASC
+```
+
+When using lazy loading, you'll issue the following query initially:
+
+``` SQL
+SELECT
+[Extent1].[CustomerID] AS [CustomerID],
+[Extent1].[CompanyName] AS [CompanyName],
+[Extent1].[ContactName] AS [ContactName],
+[Extent1].[ContactTitle] AS [ContactTitle],
+[Extent1].[Address] AS [Address],
+[Extent1].[City] AS [City],
+[Extent1].[Region] AS [Region],
+[Extent1].[PostalCode] AS [PostalCode],
+[Extent1].[Country] AS [Country],
+[Extent1].[Phone] AS [Phone],
+[Extent1].[Fax] AS [Fax]
+FROM [dbo].[Customers] AS [Extent1]
+WHERE N'UK' = [Extent1].[Country]
+```
+
+And each time you access the Orders navigation property of a customer another query like the following is issued against the store:
+
+``` SQL
+exec sp_executesql N'SELECT
+[Extent1].[OrderID] AS [OrderID],
+[Extent1].[CustomerID] AS [CustomerID],
+[Extent1].[EmployeeID] AS [EmployeeID],
+[Extent1].[OrderDate] AS [OrderDate],
+[Extent1].[RequiredDate] AS [RequiredDate],
+[Extent1].[ShippedDate] AS [ShippedDate],
+[Extent1].[ShipVia] AS [ShipVia],
+[Extent1].[Freight] AS [Freight],
+[Extent1].[ShipName] AS [ShipName],
+[Extent1].[ShipAddress] AS [ShipAddress],
+[Extent1].[ShipCity] AS [ShipCity],
+[Extent1].[ShipRegion] AS [ShipRegion],
+[Extent1].[ShipPostalCode] AS [ShipPostalCode],
+[Extent1].[ShipCountry] AS [ShipCountry]
+FROM [dbo].[Orders] AS [Extent1]
+WHERE [Extent1].[CustomerID] = @EntityKeyValue1',N'@EntityKeyValue1 nchar(5)',@EntityKeyValue1=N'AROUT'
+```
+
+For more information, see the [Loading Related Objects](https://msdn.microsoft.com/library/bb896272.aspx).
+
+#### 8.2.1 Lazy Loading versus Eager Loading cheat sheet
+
+There’s no such thing as a one-size-fits-all to choosing eager loading versus lazy loading. Try first to understand the differences between both strategies so you can do a well informed decision; also, consider if your code fits to any of the following scenarios:
+
+| Scenario                                                                    | Our Suggestion                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+|:----------------------------------------------------------------------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| Do you need to access many navigation properties from the fetched entities? | **No** - Both options will probably do. However, if the payload your query is bringing is not too big, you may experience performance benefits by using Eager loading as it’ll require less network round trips to materialize your objects. <br/> <br/> **Yes** - 	If you need to access many navigation properties from the entities, you’d do that by using multiple include statements in your query with Eager loading. The more entities you include, the bigger the payload your query will return. Once you include three or more entities into your query, consider switching to Lazy loading. |
+| Do you know exactly what data will be needed at run time?                   | **No** - Lazy loading will be better for you. Otherwise, you may end up querying for data that you will not need. <br/> <br/> **Yes** - Eager loading is probably your best bet; it will help loading entire sets faster. If your query requires fetching a very large amount of data, and this becomes too slow, then try Lazy loading instead.                                                                                                                                                                                                                                                       |
+| Is your code executing far from your database? (increased network latency)  | **No** - When the network latency is not an issue, using Lazy loading may simplify your code. Remember that the topology of your application may change, so don’t take database proximity for granted. <br/> <br/> **Yes** - When the network is a problem, only you can decide what fits better for your scenario. Typically Eager loading will be better because it requires fewer round trips.                                                                                                                                                                                                      |
+
+
+#### 8.2.2       Performance concerns with multiple Includes
+
+When we hear performance questions that involve server response time problems, the source of the issue is frequently queries with multiple Include statements. While including related entities in a query is powerful, it's important to understand what's happening under the covers.
+
+It takes a relatively long time for a query with multiple Include statements in it to go through our internal plan compiler to produce the store command. The majority of this time is spent trying to optimize the resulting query. The generated store command will contain an Outer Join or Union for each Include, depending on your mapping. Queries like this will bring in large connected graphs from your database in a single payload, which will acerbate any bandwidth issues, especially when there is a lot of redundancy in the payload (for example, when multiple levels of Include are used to traverse associations in the one-to-many direction).
+
+You can check for cases where your queries are returning excessively large payloads by accessing the underlying TSQL for the query by using ToTraceString and executing the store command in SQL Server Management Studio to see the payload size. In such cases you can try to reduce the number of Include statements in your query to just bring in the data you need. Or you may be able to break your query into a smaller sequence of subqueries, for example:
+
+**Before breaking the query:**
+
+``` csharp
+using (NorthwindEntities context = new NorthwindEntities())
+{
+    var customers = from c in context.Customers.Include(c => c.Orders)
+                    where c.LastName.StartsWith(lastNameParameter)
+                    select c;
+
+    foreach (Customer customer in customers)
+    {
+        ...
+    }
+}
+```
+
+**After breaking the query:**
+
+``` csharp
+using (NorthwindEntities context = new NorthwindEntities())
+{
+    var orders = from o in context.Orders
+                 where o.Customer.LastName.StartsWith(lastNameParameter)
+                 select o;
+
+    orders.Load();
+
+    var customers = from c in context.Customers
+                    where c.LastName.StartsWith(lastNameParameter)
+                    select c;
+
+    foreach (Customer customer in customers)
+    {
+        ...
+    }
+}
+```
+
+This will work only on tracked queries, as we are making use of the ability the context has to perform identity resolution and association fixup automatically.
+
+As with lazy loading, the tradeoff will be more queries for smaller payloads. You can also use projections of individual properties to explicitly select only the data you need from each entity, but you will not be loading entities in this case, and updates will not be supported.
+
+#### 8.2.3 Workaround to get lazy loading of properties
+
+Entity Framework currently doesn’t support lazy loading of scalar or complex properties. However, in cases where you have a table that includes a large object such as a BLOB, you can use table splitting to separate the large properties into a separate entity. For example, suppose you have a Product table that includes a varbinary photo column. If you don't frequently need to access this property in your queries, you can use table splitting to bring in only the parts of the entity that you normally need. The entity representing the product photo will only be loaded when you explicitly need it.
+
+A good resource that shows how to enable table splitting is Gil Fink's "Table Splitting in Entity Framework" blog post: \<http://blogs.microsoft.co.il/blogs/gilf/archive/2009/10/13/table-splitting-in-entity-framework.aspx>.
+
+## 9 Other considerations
+
+### 9.1      Server Garbage Collection
+
+Some users might experience resource contention that limits the parallelism they are expecting when the Garbage Collector is not properly configured. Whenever EF is used in a multithreaded scenario, or in any application that resembles a server-side system, make sure to enable Server Garbage Collection. This is done via a simple setting in your application config file:
+
+``` xml
+<?xmlversion="1.0" encoding="utf-8" ?>
+<configuration>
+        <runtime>
+               <gcServer enabled="true" />
+        </runtime>
+</configuration>
+```
+
+This should decrease your thread contention and increase your throughput by up to 30% in CPU saturated scenarios. In general terms, you should always test how your application behaves using the classic Garbage Collection (which is better tuned for UI and client side scenarios) as well as the Server Garbage Collection.
+
+### 9.2      AutoDetectChanges
+
+As mentioned earlier, Entity Framework might show performance issues when the object cache has many entities. Certain operations, such as Add, Remove, Find, Entry and SaveChanges, trigger calls to DetectChanges which might consume a large amount of CPU based on how large the object cache has become. The reason for this is that the object cache and the object state manager try to stay as synchronized as possible on each operation performed to a context so that the produced data is guaranteed to be correct under a wide array of scenarios.
+
+It is generally a good practice to leave Entity Framework’s automatic change detection enabled for the entire life of your application. If your scenario is being negatively affected by high CPU usage and your profiles indicate that the culprit is the call to DetectChanges, consider temporarily turning off AutoDetectChanges in the sensitive portion of your code:
+
+``` csharp
+try
+{
+    context.Configuration.AutoDetectChangesEnabled = false;
+    var product = context.Products.Find(productId);
+    ...
+}
+finally
+{
+    context.Configuration.AutoDetectChangesEnabled = true;
+}
+```
+
+Before turning off AutoDetectChanges, it’s good to understand that this might cause Entity Framework to lose its ability to track certain information about the changes that are taking place on the entities. If handled incorrectly, this might cause data inconsistency on your application. For more information on turning off AutoDetectChanges, read \<http://blog.oneunicorn.com/2012/03/12/secrets-of-detectchanges-part-3-switching-off-automatic-detectchanges/>.
+
+### 9.3      Context per request
+
+Entity Framework’s contexts are meant to be used as short-lived instances in order to provide the most optimal performance experience. Contexts are expected to be short lived and discarded, and as such have been implemented to be very lightweight and reutilize metadata whenever possible. In web scenarios it’s important to keep this in mind and not have a context for more than the duration of a single request. Similarly, in non-web scenarios, context should be discarded based on your understanding of the different levels of caching in the Entity Framework. Generally speaking, one should avoid having a context instance throughout the life of the application, as well as contexts per thread and static contexts.
+
+### 9.4      Database null semantics
+
+Entity Framework by default will generate SQL code that has C\# null comparison semantics. Consider the following example query:
+
+``` csharp
+            int? categoryId = 7;
+            int? supplierId = 8;
+            decimal? unitPrice = 0;
+            short? unitsInStock = 100;
+            short? unitsOnOrder = 20;
+            short? reorderLevel = null;
+
+            var q = from p incontext.Products
+                    where p.Category.CategoryName == "Beverages"
+                          || (p.CategoryID == categoryId
+                                || p.SupplierID == supplierId
+                                || p.UnitPrice == unitPrice
+                                || p.UnitsInStock == unitsInStock
+                                || p.UnitsOnOrder == unitsOnOrder
+                                || p.ReorderLevel == reorderLevel)
+                    select p;
+
+            var r = q.ToList();
+```
+
+In this example, we’re comparing a number of nullable variables against nullable properties on the entity, such as SupplierID and UnitPrice. The generated SQL for this query will ask if the parameter value is the same as the column value, or if both the parameter and the column values are null. This will hide the way the database server handles nulls and will provide a consistent C\# null experience across different database vendors. On the other hand, the generated code is a bit convoluted and may not perform well when the amount of comparisons in the where statement of the query grows to a large number.
+
+One way to deal with this situation is by using database null semantics. Note that this might potentially behave differently to the C\# null semantics since now Entity Framework will generate simpler SQL that exposes the way the database engine handles null values. Database null semantics can be activated per-context with one single configuration line against the context configuration:
+
+``` csharp
+                context.Configuration.UseDatabaseNullSemantics = true;
+```
+
+Small to medium sized queries will not display a perceptible performance improvement when using database null semantics, but the difference will become more noticeable on queries with a large number of potential null comparisons.
+
+In the example query above, the performance difference was less than 2% in a microbenchmark running in a controlled environment.
+
+### 9.5      Async
+
+Entity Framework 6 introduced support of async operations when running on .NET 4.5 or later. For the most part, applications that have IO related contention will benefit the most from using asynchronous query and save operations. If your application does not suffer from IO contention, the use of async will, in the best cases, run synchronously and return the result in the same amount of time as a synchronous call, or in the worst case, simply defer execution to an asynchronous task and add extra time to the completion of your scenario.
+
+For information on how asynchronous programming work that will help you deciding if async will improve the performance of your application, see [Asynchronous Programming with Async and Await](https://msdn.microsoft.com/library/hh191443.aspx). For more information on the use of async operations on Entity Framework, see [Async Query and Save](xref:ef6/fundamentals/async).
+
+### 9.6      NGEN
+
+Entity Framework 6 does not come in the default installation of .NET framework. As such, the Entity Framework assemblies are not NGEN’d by default which means that all the Entity Framework code is subject to the same JIT’ing costs as any other MSIL assembly. This might degrade the F5 experience while developing and also the cold startup of your application in the production environments. In order to reduce the CPU and memory costs of JIT’ing it is advisable to NGEN the Entity Framework images as appropriate. For more information on how to improve the startup performance of Entity Framework 6 with NGEN, see [Improving Startup Performance with NGen](xref:ef6/fundamentals/performance/ngen).
+
+### 9.7      Code First versus EDMX
+
+Entity Framework reasons about the impedance mismatch problem between object oriented programming and relational databases by having an in-memory representation of the conceptual model (the objects), the storage schema (the database) and a mapping between the two. This metadata is called an Entity Data Model, or EDM for short. From this EDM, Entity Framework will derive the views to roundtrip data from the objects in memory to the database and back.
+
+When Entity Framework is used with an EDMX file that formally specifies the conceptual model, the storage schema, and the mapping, then the model loading stage only has to validate that the EDM is correct (for example, make sure that no mappings are missing), then generate the views, then validate the views and have this metadata ready for use. Only then can a query be executed or new data be saved to the data store.
+
+The Code First approach is, at its heart, a sophisticated Entity Data Model generator. The Entity Framework has to produce an EDM from the provided code; it does so by analyzing the classes involved in the model, applying conventions and configuring the model via the Fluent API. After the EDM is built, the Entity Framework essentially behaves the same way as it would had an EDMX file been present in the project. Thus, building the model from Code First adds extra complexity that translates into a slower startup time for the Entity Framework when compared to having an EDMX. The cost is completely dependent on the size and complexity of the model that’s being built.
+
+When choosing to use EDMX versus Code First, it’s important to know that the flexibility introduced by Code First increases the cost of building the model for the first time. If your application can withstand the cost of this first-time load then typically Code First will be the preferred way to go.
+
+## 10 Investigating Performance
+
+### 10.1 Using the Visual Studio Profiler
+
+If you are having performance issues with the Entity Framework, you can use a profiler like the one built into Visual Studio to see where your application is spending its time. This is the tool we used to generate the pie charts in the “Exploring the Performance of the ADO.NET Entity Framework - Part 1” blog post ( \<https://learn.microsoft.com/archive/blogs/adonet/exploring-the-performance-of-the-ado-net-entity-framework-part-1>) that show where Entity Framework spends its time during cold and warm queries.
+
+The "Profiling Entity Framework using the Visual Studio 2010 Profiler" blog post written by the Data and Modeling Customer Advisory Team shows a real-world example of how they used the profiler to investigate a performance problem.  \<https://learn.microsoft.com/archive/blogs/dmcat/profiling-entity-framework-using-the-visual-studio-2010-profiler>. This post was written for a windows application. If you need to profile a web application the Windows Performance Recorder (WPR) and Windows Performance Analyzer (WPA) tools may work better than working from Visual Studio. WPR and WPA are part of the Windows Performance Toolkit which is included with the Windows Assessment and Deployment Kit.
+
+### 10.2 Application/Database profiling
+
+Tools like the profiler built into Visual Studio tell you where your application is spending time.  Another type of profiler is available that performs dynamic analysis of your running application, either in production or pre-production depending on needs, and looks for common pitfalls and anti-patterns of database access.
+
+Two commercially available profilers are the Entity Framework Profiler ( \<http://efprof.com>) and ORMProfiler ( \<http://ormprofiler.com>).
+
+If your application is an MVC application using Code First, you can use StackExchange's MiniProfiler. Scott Hanselman describes this tool in his blog at: \<http://www.hanselman.com/blog/NuGetPackageOfTheWeek9ASPNETMiniProfilerFromStackExchangeRocksYourWorld.aspx>.
+
+For more information on profiling your application's database activity, see Julie Lerman's MSDN Magazine article titled [Profiling Database Activity in the Entity Framework](https://msdn.microsoft.com/magazine/gg490349.aspx).
+
+### 10.3 Database logger
+
+If you are using Entity Framework 6 also consider using the built-in logging functionality. The Database property of the context can be instructed to log its activity via a simple one-line configuration:
+
+``` csharp
+    using (var context = newQueryComparison.DbC.NorthwindEntities())
+    {
+        context.Database.Log = Console.WriteLine;
+        var q = context.Products.Where(p => p.Category.CategoryName == "Beverages");
+        q.ToList();
+    }
+```
+
+In this example the database activity will be logged to the console, but the Log property can be configured to call any Action&lt;string&gt; delegate.
+
+If you want to enable database logging without recompiling, and you are using Entity Framework 6.1 or later, you can do so by adding an interceptor in the web.config or app.config file of your application.
+
+``` xml
+  <interceptors>
+    <interceptor type="System.Data.Entity.Infrastructure.Interception.DatabaseLogger, EntityFramework">
+      <parameters>
+        <parameter value="C:\Path\To\My\LogOutput.txt"/>
+      </parameters>
+    </interceptor>
+  </interceptors>
+```
+
+For more information on how to add logging without recompiling go to \<http://blog.oneunicorn.com/2014/02/09/ef-6-1-turning-on-logging-without-recompiling/>.
+
+## 11 Appendix
+
+### 11.1 A. Test Environment
+
+This environment uses a 2-machine setup with the database on a separate machine from the client application. Machines are in the same rack, so network latency is relatively low, but more realistic than a single-machine environment.
+
+#### 11.1.1       App Server
+
+##### 11.1.1.1      Software Environment
+
+-   Entity Framework 4 Software Environment
+    -   OS Name: Windows Server 2008 R2 Enterprise SP1.
+    -   Visual Studio 2010 – Ultimate.
+    -   Visual Studio 2010 SP1 (only for some comparisons).
+-   Entity Framework 5 and 6 Software Environment
+    -   OS Name: Windows 8.1 Enterprise
+    -   Visual Studio 2013 – Ultimate.
+
+##### 11.1.1.2      Hardware Environment
+
+-   Dual Processor:     Intel(R) Xeon(R) CPU L5520 W3530 @ 2.27GHz, 2261 Mhz8 GHz, 4 Core(s), 84 Logical Processor(s).
+-   2412 GB RamRAM.
+-   136 GB SCSI250GB SATA 7200 rpm 3GB/s drive split into 4 partitions.
+
+#### 11.1.2       DB server
+
+##### 11.1.2.1      Software Environment
+
+-   OS Name: Windows Server 2008 R28.1 Enterprise SP1.
+-   SQL Server 2008 R22012.
+
+##### 11.1.2.2      Hardware Environment
+
+-   Single Processor: Intel(R) Xeon(R) CPU L5520  @ 2.27GHz, 2261 MhzES-1620 0 @ 3.60GHz, 4 Core(s), 8 Logical Processor(s).
+-   824 GB RamRAM.
+-   465 GB ATA500GB SATA 7200 rpm 6GB/s drive split into 4 partitions.
+
+### 11.2      B. Query performance comparison tests
+
+The Northwind model was used to execute these tests. It was generated from the database using the Entity Framework designer. Then, the following code was used to compare the performance of the query execution options:
+
+``` csharp
+using System;
+using System.Collections.Generic;
+using System.Data;
+using System.Data.Common;
+using System.Data.Entity.Infrastructure;
+using System.Data.EntityClient;
+using System.Data.Objects;
+using System.Linq;
+
+namespace QueryComparison
+{
+    public partial class NorthwindEntities : ObjectContext
+    {
+        private static readonly Func<NorthwindEntities, string, IQueryable<Product>> productsForCategoryCQ = CompiledQuery.Compile(
+            (NorthwindEntities context, string categoryName) =>
+                context.Products.Where(p => p.Category.CategoryName == categoryName)
+                );
+
+        public IQueryable<Product> InvokeProductsForCategoryCQ(string categoryName)
+        {
+            return productsForCategoryCQ(this, categoryName);
+        }
+    }
+
+    public class QueryTypePerfComparison
+    {
+        private static string entityConnectionStr = @"metadata=res://*/Northwind.csdl|res://*/Northwind.ssdl|res://*/Northwind.msl;provider=System.Data.SqlClient;provider connection string='data source=.;initial catalog=Northwind;integrated security=True;multipleactiveresultsets=True;App=EntityFramework'";
+
+        public void LINQIncludingContextCreation()
+        {
+            using (NorthwindEntities context = new NorthwindEntities())
+            {                 
+                var q = context.Products.Where(p => p.Category.CategoryName == "Beverages");
+                q.ToList();
+            }
+        }
+
+        public void LINQNoTracking()
+        {
+            using (NorthwindEntities context = new NorthwindEntities())
+            {
+                context.Products.MergeOption = MergeOption.NoTracking;
+
+                var q = context.Products.Where(p => p.Category.CategoryName == "Beverages");
+                q.ToList();
+            }
+        }
+
+        public void CompiledQuery()
+        {
+            using (NorthwindEntities context = new NorthwindEntities())
+            {
+                var q = context.InvokeProductsForCategoryCQ("Beverages");
+                q.ToList();
+            }
+        }
+
+        public void ObjectQuery()
+        {
+            using (NorthwindEntities context = new NorthwindEntities())
+            {
+                ObjectQuery<Product> products = context.Products.Where("it.Category.CategoryName = 'Beverages'");
+                products.ToList();
+            }
+        }
+
+        public void EntityCommand()
+        {
+            using (EntityConnection eConn = new EntityConnection(entityConnectionStr))
+            {
+                eConn.Open();
+                EntityCommand cmd = eConn.CreateCommand();
+                cmd.CommandText = "Select p From NorthwindEntities.Products As p Where p.Category.CategoryName = 'Beverages'";
+
+                using (EntityDataReader reader = cmd.ExecuteReader(CommandBehavior.SequentialAccess))
+                {
+                    List<Product> productsList = new List<Product>();
+                    while (reader.Read())
+                    {
+                        DbDataRecord record = (DbDataRecord)reader.GetValue(0);
+
+                        // 'materialize' the product by accessing each field and value. Because we are materializing products, we won't have any nested data readers or records.
+                        int fieldCount = record.FieldCount;
+
+                        // Treat all products as Product, even if they are the subtype DiscontinuedProduct.
+                        Product product = new Product();  
+
+                        product.ProductID = record.GetInt32(0);
+                        product.ProductName = record.GetString(1);
+                        product.SupplierID = record.GetInt32(2);
+                        product.CategoryID = record.GetInt32(3);
+                        product.QuantityPerUnit = record.GetString(4);
+                        product.UnitPrice = record.GetDecimal(5);
+                        product.UnitsInStock = record.GetInt16(6);
+                        product.UnitsOnOrder = record.GetInt16(7);
+                        product.ReorderLevel = record.GetInt16(8);
+                        product.Discontinued = record.GetBoolean(9);
+
+                        productsList.Add(product);
+                    }
+                }
+            }
+        }
+
+        public void ExecuteStoreQuery()
+        {
+            using (NorthwindEntities context = new NorthwindEntities())
+            {
+                ObjectResult<Product> beverages = context.ExecuteStoreQuery<Product>(
+@"    SELECT        P.ProductID, P.ProductName, P.SupplierID, P.CategoryID, P.QuantityPerUnit, P.UnitPrice, P.UnitsInStock, P.UnitsOnOrder, P.ReorderLevel, P.Discontinued
+    FROM            Products AS P INNER JOIN Categories AS C ON P.CategoryID = C.CategoryID
+    WHERE        (C.CategoryName = 'Beverages')"
+);
+                beverages.ToList();
+            }
+        }
+
+        public void ExecuteStoreQueryDbContext()
+        {
+            using (var context = new QueryComparison.DbC.NorthwindEntities())
+            {
+                var beverages = context.Database.SqlQuery\<QueryComparison.DbC.Product>(
+@"    SELECT        P.ProductID, P.ProductName, P.SupplierID, P.CategoryID, P.QuantityPerUnit, P.UnitPrice, P.UnitsInStock, P.UnitsOnOrder, P.ReorderLevel, P.Discontinued
+    FROM            Products AS P INNER JOIN Categories AS C ON P.CategoryID = C.CategoryID
+    WHERE        (C.CategoryName = 'Beverages')"
+);
+                beverages.ToList();
+            }
+        }
+
+        public void ExecuteStoreQueryDbSet()
+        {
+            using (var context = new QueryComparison.DbC.NorthwindEntities())
+            {
+                var beverages = context.Products.SqlQuery(
+@"    SELECT        P.ProductID, P.ProductName, P.SupplierID, P.CategoryID, P.QuantityPerUnit, P.UnitPrice, P.UnitsInStock, P.UnitsOnOrder, P.ReorderLevel, P.Discontinued
+    FROM            Products AS P INNER JOIN Categories AS C ON P.CategoryID = C.CategoryID
+    WHERE        (C.CategoryName = 'Beverages')"
+);
+                beverages.ToList();
+            }
+        }
+
+        public void LINQIncludingContextCreationDbContext()
+        {
+            using (var context = new QueryComparison.DbC.NorthwindEntities())
+            {                 
+                var q = context.Products.Where(p => p.Category.CategoryName == "Beverages");
+                q.ToList();
+            }
+        }
+
+        public void LINQNoTrackingDbContext()
+        {
+            using (var context = new QueryComparison.DbC.NorthwindEntities())
+            {
+                var q = context.Products.AsNoTracking().Where(p => p.Category.CategoryName == "Beverages");
+                q.ToList();
+            }
+        }
+    }
+}
+```
+
+### 11.3 C. Navision Model
+
+The Navision database is a large database used to demo Microsoft Dynamics – NAV. The generated conceptual model contains 1005 entity sets and 4227 association sets. The model used in the test is “flat” – no inheritance has been added to it.
+
+#### 11.3.1 Queries used for Navision tests
+
+The queries list used with the Navision model contains 3 categories of Entity SQL queries:
+
+##### 11.3.1.1 Lookup
+
+A simple lookup query with no aggregations
+
+-   Count: 16232
+-   Example:
+
+``` xml
+  <Query complexity="Lookup">
+    <CommandText>Select value distinct top(4) e.Idle_Time From NavisionFKContext.Session as e</CommandText>
+  </Query>
+```
+
+##### 11.3.1.2 SingleAggregating
+
+A normal BI query with multiple aggregations, but no subtotals (single query)
+
+-   Count: 2313
+-   Example:
+
+``` xml
+  <Query complexity="SingleAggregating">
+    <CommandText>NavisionFK.MDF_SessionLogin_Time_Max()</CommandText>
+  </Query>
+```
+
+Where MDF\_SessionLogin\_Time\_Max() is defined in the model as:
+
+``` xml
+  <Function Name="MDF_SessionLogin_Time_Max" ReturnType="Collection(DateTime)">
+    <DefiningExpression>SELECT VALUE Edm.Min(E.Login_Time) FROM NavisionFKContext.Session as E</DefiningExpression>
+  </Function>
+```
+
+##### 11.3.1.3 AggregatingSubtotals
+
+A BI query with aggregations and subtotals (via union all)
+
+-   Count: 178
+-   Example:
+
+``` xml
+  <Query complexity="AggregatingSubtotals">
+    <CommandText>
+using NavisionFK;
+function AmountConsumed(entities Collection([CRONUS_International_Ltd__Zone])) as
+(
+    Edm.Sum(select value N.Block_Movement FROM entities as E, E.CRONUS_International_Ltd__Bin as N)
+)
+function AmountConsumed(P1 Edm.Int32) as
+(
+    AmountConsumed(select value e from NavisionFKContext.CRONUS_International_Ltd__Zone as e where e.Zone_Ranking = P1)
+)
+----------------------------------------------------------------------------------------------------------------------
+(
+    select top(10) Zone_Ranking, Cross_Dock_Bin_Zone, AmountConsumed(GroupPartition(E))
+    from NavisionFKContext.CRONUS_International_Ltd__Zone as E
+    where AmountConsumed(E.Zone_Ranking) > @MinAmountConsumed
+    group by E.Zone_Ranking, E.Cross_Dock_Bin_Zone
+)
+union all
+(
+    select top(10) Zone_Ranking, Cast(null as Edm.Byte) as P2, AmountConsumed(GroupPartition(E))
+    from NavisionFKContext.CRONUS_International_Ltd__Zone as E
+    where AmountConsumed(E.Zone_Ranking) > @MinAmountConsumed
+    group by E.Zone_Ranking
+)
+union all
+{
+    Row(Cast(null as Edm.Int32) as P1, Cast(null as Edm.Byte) as P2, AmountConsumed(select value E
+                                                                         from NavisionFKContext.CRONUS_International_Ltd__Zone as E
+                                                                         where AmountConsumed(E.Zone_Ranking) > @MinAmountConsumed))
+}</CommandText>
+    <Parameters>
+      <Parameter Name="MinAmountConsumed" DbType="Int32" Value="10000" />
+    </Parameters>
+  </Query>
+```
diff --git a/entity-framework/ef6/fundamentals/performance/pre-generated-views.md b/entity-framework/ef6/fundamentals/performance/pre-generated-views.md
new file mode 100644
index 0000000000..cf9dc1c598
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/performance/pre-generated-views.md
@@ -0,0 +1,121 @@
+---
+title: Pre-generated mapping views - EF6
+description: Pre-generated mapping views in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/fundamentals/performance/pre-generated-views
+---
+# Pre-generated mapping views
+Before the Entity Framework can execute a query or save changes to the data source, it must generate a set of mapping views to access the database. These mapping views are a set of Entity SQL statement that represent the database in an abstract way, and are part of the metadata which is cached per application domain. If you create multiple instances of the same context in the same application domain, they will reuse mapping views from the cached metadata rather than regenerating them. Because mapping view generation is a significant part of the overall cost of executing the first query, the Entity Framework enables you to pre-generate mapping views and include them in the compiled project. For more information, see  [Performance Considerations (Entity Framework)](xref:ef6/fundamentals/performance/perf-whitepaper).
+
+## Generating Mapping Views with the EF Power Tools Community Edition
+
+The easiest way to pre-generate views is to use the [EF Power Tools Community Edition](https://marketplace.visualstudio.com/items?itemName=ErikEJ.EntityFramework6PowerToolsCommunityEdition). Once you have the Power Tools installed you will have a menu option to Generate Views, as below.
+
+-   For **Code First** models right-click on the code file that contains your DbContext class.
+-   For **EF Designer** models right-click on your EDMX file.
+
+![generate Views](~/ef6/media/generateviews.png)
+
+Once the process is finished you will have a class similar to the following generated
+
+![generated Views](~/ef6/media/generatedviews.png)
+
+Now when you run your application EF will use this class to load views as required. If your model changes and you do not re-generate this class then EF will throw an exception.
+
+## Generating Mapping Views from Code - EF6 Onwards
+
+The other way to generate views is to use the APIs that EF provides. When using this method you have the freedom to serialize the views however you like, but you also need to load the views yourself.
+
+> [!NOTE]
+> **EF6 Onwards Only** - The APIs shown in this section were introduced in Entity Framework 6. If you are using an earlier version this information does not apply.
+
+### Generating Views
+
+The APIs to generate views are on the System.Data.Entity.Core.Mapping.StorageMappingItemCollection class. You can retrieve a StorageMappingCollection for a Context by using the MetadataWorkspace of an ObjectContext. If you are using the newer DbContext API then you can access this by using the IObjectContextAdapter like below, in this code we have an instance of your derived DbContext called dbContext:
+
+``` csharp
+    var objectContext = ((IObjectContextAdapter) dbContext).ObjectContext;
+    var  mappingCollection = (StorageMappingItemCollection)objectContext.MetadataWorkspace
+                                                                        .GetItemCollection(DataSpace.CSSpace);
+```
+
+Once you have the StorageMappingItemCollection then you can get access to the GenerateViews and ComputeMappingHashValue methods.
+
+``` csharp
+    public Dictionary<EntitySetBase, DbMappingView> GenerateViews(IList<EdmSchemaError> errors)
+    public string ComputeMappingHashValue()
+```
+
+The first method creates a dictionary with an entry for each view in the container mapping. The second method computes a hash value for the single container mapping and is used at runtime to validate that the model has not changed since the views were pre-generated. Overrides of the two methods are provided for complex scenarios involving multiple container mappings.
+
+When generating views you will call the GenerateViews method and then write out the resulting EntitySetBase and DbMappingView. You will also need to store the hash generated by the ComputeMappingHashValue method.
+
+### Loading Views
+
+In order to load the views generated by the GenerateViews method, you can provide EF with a class that inherits from the DbMappingViewCache abstract class. DbMappingViewCache specifies two methods that you must implement:
+
+``` csharp
+    public abstract string MappingHashValue { get; }
+    public abstract DbMappingView GetView(EntitySetBase extent);
+```
+
+The MappingHashValue property must return the hash generated by the ComputeMappingHashValue method. When EF is going to ask for views it will first generate and compare the hash value of the model with the hash returned by this property. If they do not match then EF will throw an EntityCommandCompilationException exception.
+
+The GetView method will accept an EntitySetBase and you need to return a DbMappingVIew containing the EntitySql that was generated for that was associated with the given EntitySetBase in the dictionary generated by the GenerateViews method. If EF asks for a view that you do not have then GetView should return null.
+
+The following is an extract from the DbMappingViewCache that is generated with the Power Tools as described above, in it we see one way to store and retrieve the EntitySql required.
+
+``` csharp
+    public override string MappingHashValue
+    {
+        get { return "a0b843f03dd29abee99789e190a6fb70ce8e93dc97945d437d9a58fb8e2afd2e"; }
+    }
+
+    public override DbMappingView GetView(EntitySetBase extent)
+    {
+        if (extent == null)
+        {
+            throw new ArgumentNullException("extent");
+        }
+
+        var extentName = extent.EntityContainer.Name + "." + extent.Name;
+
+        if (extentName == "BlogContext.Blogs")
+        {
+            return GetView2();
+        }
+
+        if (extentName == "BlogContext.Posts")
+        {
+            return GetView3();
+        }
+
+        return null;
+    }
+
+    private static DbMappingView GetView2()
+    {
+        return new DbMappingView(@"
+            SELECT VALUE -- Constructing Blogs
+            [BlogApp.Models.Blog](T1.Blog_BlogId, T1.Blog_Test, T1.Blog_title, T1.Blog_Active, T1.Blog_SomeDecimal)
+            FROM (
+            SELECT
+                T.BlogId AS Blog_BlogId,
+                T.Test AS Blog_Test,
+                T.title AS Blog_title,
+                T.Active AS Blog_Active,
+                T.SomeDecimal AS Blog_SomeDecimal,
+                True AS _from0
+            FROM CodeFirstDatabase.Blog AS T
+            ) AS T1");
+    }
+```
+
+To have EF use your DbMappingViewCache you add use the DbMappingViewCacheTypeAttribute, specifying the context that it was created for. In the code below we associate the BlogContext with the MyMappingViewCache class.
+
+``` csharp
+    [assembly: DbMappingViewCacheType(typeof(BlogContext), typeof(MyMappingViewCache))]
+```
+
+For more complex scenarios, mapping view cache instances can be provided by specifying a mapping view cache factory. This can be done by implementing the abstract class System.Data.Entity.Infrastructure.MappingViews.DbMappingViewCacheFactory. The instance of the mapping view cache factory that is used can be retrieved or set using the StorageMappingItemCollection.MappingViewCacheFactoryproperty.
diff --git a/entity-framework/ef6/fundamentals/providers/index.md b/entity-framework/ef6/fundamentals/providers/index.md
new file mode 100644
index 0000000000..aadfafc560
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/providers/index.md
@@ -0,0 +1,93 @@
+---
+title: Entity Framework Providers - EF6
+description: Entity Framework Providers in Entity Framework 6
+author: SamMonoRT
+ms.date: 06/27/2018
+uid: ef6/fundamentals/providers/index
+---
+
+# Entity Framework 6 Providers
+> [!NOTE]
+> **EF6 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 6. If you are using an earlier version, some or all of the information does not apply.
+
+The Entity Framework is now being developed under an open-source license and EF6 and above will not be shipped as part of the .NET Framework. This has many advantages but also requires that EF providers be rebuilt against the EF6 assemblies. This means that EF providers for EF5 and below will not work with EF6 until they have been rebuilt.
+
+## Which providers are available for EF6?
+
+Providers we are aware of that have been rebuilt for EF6 include:
+
+*   **Microsoft SQL Server provider**
+    *   Built from the [Entity Framework open source code base](https://github.com/aspnet/EntityFramework6)
+    *   Shipped as part of the [EntityFramework NuGet package](https://nuget.org/packages/EntityFramework)
+*   **Microsoft SQL Server Compact Edition provider**
+    *   Built from the [Entity Framework open source code base](https://github.com/aspnet/EntityFramework6)
+    *   Shipped in the [EntityFramework.SqlServerCompact NuGet package](https://nuget.org/packages/EntityFramework.SqlServerCompact)
+*   [**Devart dotConnect Data Providers**](https://www.devart.com/dotconnect/)
+    *   There are third-party providers from [Devart](https://www.devart.com/) for a variety of databases including Oracle, MySQL, PostgreSQL, SQLite, Salesforce, DB2, and SQL Server
+*   [**CData Software providers**](https://www.cdata.com/ado/)
+    *   There are third-party providers from [CData Software](https://www.cdata.com/ado/) for a variety of data stores including Salesforce, Azure Table Storage, MySql, and many more
+*   **Firebird provider**
+    *   Available as a [NuGet Package](https://www.nuget.org/packages/EntityFramework.Firebird/)
+*   **Visual Fox Pro provider**
+    *   Available as a [NuGet package](https://www.nuget.org/packages/VFPEntityFrameworkProvider2/)
+*   **MySQL**
+    *   [MySQL Connector/NET for Entity Framework](https://dev.mysql.com/doc/connector-net/en/connector-net-entityframework60.html)
+*   **PostgreSQL**
+    *   Npgsql is available as a [NuGet package](https://www.nuget.org/packages/EntityFramework6.Npgsql/)
+*   **Oracle**
+    *   ODP.NET is available as a [NuGet package](https://www.nuget.org/packages/Oracle.ManagedDataAccess.EntityFramework/)
+*   **SQLite**
+    *   System.Data.SQLite is available as a [NuGet package](https://www.nuget.org/packages/System.Data.SQLite/)
+
+Note that inclusion in this list does not indicate the level of functionality or support for a given provider, only that a build for EF6 has been made available.
+
+## Registering EF providers
+
+Starting with Entity Framework 6 EF providers can be registered using either code-based configuration or in the application’s config file.
+
+### Config file registration
+
+Registration of the EF provider in app.config or web.config has the following format:
+
+
+``` xml
+    <entityFramework>
+       <providers>
+         <provider invariantName="My.Invariant.Name" type="MyProvider.MyProviderServices, MyAssembly" />
+       </providers>
+    </entityFramework>
+```
+
+Note that often if the EF provider is installed from NuGet, then the NuGet package will automatically add this registration to the config file. If you install the NuGet package into a project that is not the startup project for your app, then you may need to copy the registration into the config file for your startup project.
+
+The “invariantName” in this registration is the same invariant name used to identify an ADO.NET provider. This can be found as the “invariant” attribute in a DbProviderFactories registration and as the “providerName” attribute in a connection string registration. The invariant name to use should also be included in documentation for the provider. Examples of invariant names are “System.Data.SqlClient” for SQL Server and “System.Data.SqlServerCe.4.0” for SQL Server Compact.
+
+The “type” in this registration is the assembly-qualified name of the provider type that derives from “System.Data.Entity.Core.Common.DbProviderServices”. For example, the string to use for SQL Compact is “System.Data.Entity.SqlServerCompact.SqlCeProviderServices, EntityFramework.SqlServerCompact”. The type to use here should be included in documentation for the provider.
+
+### Code-based registration
+
+Starting with Entity Framework 6 application-wide configuration for EF can be specified in code. For full details see _[Entity Framework Code-Based Configuration](https://msdn.microsoft.com/data/jj680699)_. The normal way to register an EF provider using code-based configuration is to create a new class that derives from System.Data.Entity.DbConfiguration and place it in the same assembly as your DbContext class. Your DbConfiguration class should then register the provider in its constructor. For example, to register the SQL Compact provider the DbConfiguration class looks like this:
+
+``` csharp
+    public class MyConfiguration : DbConfiguration
+    {
+        public MyConfiguration()
+        {
+            SetProviderServices(
+                SqlCeProviderServices.ProviderInvariantName,
+                SqlCeProviderServices.Instance);
+        }
+    }
+```
+
+In this code “SqlCeProviderServices.ProviderInvariantName” is a convenience for the SQL Server Compact provider invariant name string (“System.Data.SqlServerCe.4.0”) and SqlCeProviderServices.Instance returns the singleton instance of the SQL Compact EF provider.
+
+## What if the provider I need isn’t available?
+
+If the provider is available for previous versions of EF, then we encourage you to contact the owner of the provider and ask them to create an EF6 version. You should include a reference to the [documentation for the EF6 provider model](xref:ef6/fundamentals/providers/provider-model).
+
+## Can I write a provider myself?
+
+It is certainly possible to create an EF provider yourself although it should not be considered a trivial undertaking. The link above about the EF6 provider model is a good place to start. You may also find it useful to use the code for the SQL Server and SQL CE provider included in the [EF open source codebase](https://github.com/aspnet/EntityFramework6) as a starting point or for reference.
+
+Note that starting with EF6 the EF provider is less tightly coupled to the underlying ADO.NET provider. This makes it easier to write an EF provider without needing to write or wrap the ADO.NET classes.
diff --git a/entity-framework/ef6/fundamentals/providers/provider-model.md b/entity-framework/ef6/fundamentals/providers/provider-model.md
new file mode 100644
index 0000000000..f295cffd2f
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/providers/provider-model.md
@@ -0,0 +1,260 @@
+---
+title: The Entity Framework 6 provider model - EF6
+description: The Entity Framework 6 provider model in Entity Framework 6
+author: SamMonoRT
+ms.date: 06/27/2018
+uid: ef6/fundamentals/providers/provider-model
+---
+# The Entity Framework 6 provider model
+
+The Entity Framework provider model allows Entity Framework to be used with different types of database server. For example, one provider can be plugged in to allow EF to be used against Microsoft SQL Server, while another provider can be plugged into to allow EF to be used against Microsoft SQL Server Compact Edition. The providers for EF6 that we are aware of can be found on the [Entity Framework providers](xref:ef6/fundamentals/providers/index) page.
+
+Certain changes were required to the way EF interacts with providers to allow EF to be released under an open source license. These changes require rebuilding of EF providers against the EF6 assemblies together with new mechanisms for registration of the provider.
+
+## Rebuilding
+
+With EF6 the core code that was previously part of the .NET Framework is now being shipped as out-of-band (OOB) assemblies. Details on how to build applications against EF6 can be found on the [Updating applications for EF6](xref:ef6/what-is-new/upgrading-to-ef6) page. Providers will also need to be rebuilt using these instructions.
+
+## Provider types overview
+
+An EF provider is really a collection of provider-specific services defined by CLR types that these services extend from (for a base class) or implement (for an interface). Two of these services are fundamental and necessary for EF to function at all. Others are optional and only need to be implemented if specific functionality is required and/or the default implementations of these services does not work for the specific database server being targeted.
+
+## Fundamental provider types
+
+### DbProviderFactory
+
+EF depends on having a type derived from [System.Data.Common.DbProviderFactory](https://msdn.microsoft.com/library/system.data.common.dbproviderfactory.aspx) for performing all low-level database access. DbProviderFactory is not actually part of EF but is instead a class in the .NET Framework that serves an entry point for ADO.NET providers that can be used by EF, other O/RMs or directly by an application to obtain instances of connections, commands, parameters and other ADO.NET abstractions in a provider agnostic way. More information about DbProviderFactory can be found in the [MSDN documentation for ADO.NET](https://msdn.microsoft.com/library/a6cd7c08.aspx).
+
+### DbProviderServices
+
+EF depends on having a type derived from DbProviderServices for providing additional functionality needed by EF on top of the functionality already provided by the ADO.NET provider. In older versions of EF the DbProviderServices class was part of the .NET Framework and was found in the System.Data.Common namespace. Starting with EF6 this class is now part of EntityFramework.dll and is in the System.Data.Entity.Core.Common namespace.
+
+More details about the fundamental functionality of a DbProviderServices implementation can be found on [MSDN](https://msdn.microsoft.com/library/ee789835.aspx). However, note that as of the time of writing this information is not updated for EF6 although most of the concepts are still valid. The SQL Server and SQL Server Compact implementations of DbProviderServices are also checked into to the [open-source codebase](https://github.com/aspnet/EntityFramework6/) and can serve as useful references for other implementations.
+
+In older versions of EF the DbProviderServices implementation to use was obtained directly from an ADO.NET provider. This was done by casting DbProviderFactory to IServiceProvider and calling the GetService method. This tightly coupled the EF provider to the DbProviderFactory. This coupling blocked EF from being moved out of the .NET Framework and therefore for EF6 this tight coupling has been removed and an implementation of DbProviderServices is now registered directly in the application’s configuration file or in code-based configuration as described in more detail the _Registering DbProviderServices_ section below.
+
+## Additional services
+
+In addition to the fundamental services described above there are also many other services used by EF which are either always or sometimes provider-specific. Default provider-specific implementations of these services can be supplied by a DbProviderServices implementation. Applications can also override the implementations of these services, or provide implementations when a DbProviderServices type does not provide a default. This is described in more detail in the _Resolving additional services_ section below.
+
+The additional service types that a provider may be of interest to a provider are listed below. More details about each of these service types can be found in the API documentation.
+
+### IDbExecutionStrategy
+
+This is an optional service that allows a provider to implement retries or other behavior when queries and commands are executed against the database. If no implementation is provided, then EF will simply execute the commands and propagate any exceptions thrown. For SQL Server this service is used to provide a retry policy which is especially useful when running against cloud-based database servers such as SQL Azure.
+
+### IDbConnectionFactory
+
+This is an optional service that allows a provider to create DbConnection objects by convention when given only a database name. Note that while this service can be resolved by a DbProviderServices implementation it has been present since EF 4.1 and can also be explicitly set in either the config file or in code. The provider will only get a chance to resolve this service if it registered as the default provider (see _The default provider_ below) and if a default connection factory has not been set elsewhere.
+
+### DbSpatialServices
+
+This is an optional services that allows a provider to add support for geography and geometry spatial types. An implementation of this service must be supplied in order for an application to use EF with spatial types. DbSpatialServices is asked for in two ways. First, provider-specific spatial services are requested using a DbProviderInfo object (which contains invariant name and manifest token) as key. Second, DbSpatialServices can be asked for with no key. This is used to resolve the “global spatial provider” that is used when creating stand-alone DbGeography or DbGeometry types.
+
+### MigrationSqlGenerator
+
+This is an optional service that allows EF Migrations to be used for the generation of SQL used in creating and modifying database schemas by Code First. An implementation is required in order to support Migrations. If an implementation is provided then it will also be used when databases are created using database initializers or the Database.Create method.
+
+### Func<DbConnection, string, HistoryContextFactory>
+
+This is an optional service that allows a provider to configure the mapping of the HistoryContext to the `__MigrationHistory` table used by EF Migrations. The HistoryContext is a Code First DbContext and can be configured using the normal fluent API to change things like the name of the table and the column mapping specifications. The default implementation of this service returned by EF for all providers may work for a given database server if all the default table and column mappings are supported by that provider. In such a case the provider does not need to supply an implementation of this service.
+
+### IDbProviderFactoryResolver
+
+This is an optional service for obtaining the correct DbProviderFactory from a given DbConnection object. The default implementation of this service returned by EF for all providers is intended to work for all providers. However, when running on .NET 4, the DbProviderFactory is not publicly accessible from one if its DbConnections. Therefore, EF uses some heuristics to search the registered providers to find a match. It is possible that for some providers these heuristics will fail and in such situations the provider should supply a new implementation.
+
+## Registering DbProviderServices
+
+The DbProviderServices implementation to use can be registered either in the application’s configuration file (app.config or web.config) or using code-based configuration. In either case the registration uses the provider’s “invariant name” as a key. This allows multiple providers to be registered and used in a single application. The invariant name used for EF registrations is the same as the invariant name used for ADO.NET provider registration and connection strings. For example, for SQL Server the invariant name “System.Data.SqlClient” is used.
+
+### Config file registration
+
+The DbProviderServices type to use is registered as a provider element in the providers list of the entityFramework section of the application’s config file. For example:
+
+``` xml
+<entityFramework>
+  <providers>
+    <provider invariantName="My.Invariant.Name" type="MyProvider.MyProviderServices, MyAssembly" />
+  </providers>
+</entityFramework>
+```
+
+The _type_ string must be the assembly-qualified type name of the DbProviderServices implementation to use.
+
+### Code-based registration
+
+Starting with EF6 providers can also be registered using code. This allows an EF provider to be used without any change to the application’s configuration file. To use code-based configuration an application should create a DbConfiguration class as described in the [code-based configuration documentation](https://msdn.com/data/jj680699). The constructor of the DbConfiguration class should then call SetProviderServices to register the EF provider. For example:
+
+``` csharp
+public class MyConfiguration : DbConfiguration
+{
+    public MyConfiguration()
+    {
+        SetProviderServices("My.New.Provider", new MyProviderServices());
+    }
+}
+```
+
+## Resolving additional services
+
+As mentioned above in the _Provider types overview_ section, a DbProviderServices class can also be used to resolve additional services. This is possible because DbProviderServices implements IDbDependencyResolver and each registered DbProviderServices type is added as a “default resolver”. The IDbDependencyResolver mechanism is described in more detail in [Dependency Resolution](xref:ef6/fundamentals/configuring/dependency-resolution). However, it is not necessary to understand all the concepts in this specification to resolve additional services in a provider.
+
+The most common way for a provider to resolve additional services is to call DbProviderServices.AddDependencyResolver for each service in the constructor of the DbProviderServices class. For example, SqlProviderServices (the EF provider for SQL Server) has code similar to this for initialization:
+
+``` csharp
+private SqlProviderServices()
+{
+    AddDependencyResolver(new SingletonDependencyResolver<IDbConnectionFactory>(
+        new SqlConnectionFactory()));
+
+    AddDependencyResolver(new ExecutionStrategyResolver<DefaultSqlExecutionStrategy>(
+        "System.data.SqlClient", null, () => new DefaultSqlExecutionStrategy()));
+
+    AddDependencyResolver(new SingletonDependencyResolver<Func<MigrationSqlGenerator>>(
+        () => new SqlServerMigrationSqlGenerator(), "System.data.SqlClient"));
+
+    AddDependencyResolver(new SingletonDependencyResolver<DbSpatialServices>(
+        SqlSpatialServices.Instance,
+        k =>
+        {
+            var asSpatialKey = k as DbProviderInfo;
+            return asSpatialKey == null
+                || asSpatialKey.ProviderInvariantName == ProviderInvariantName;
+        }));
+}
+```
+
+This constructor uses the following helper classes:
+
+*   SingletonDependencyResolver: provides a simple way to resolve Singleton services—that is, services for which the same instance is returned each time that GetService is called. Transient services are often registered as a singleton factory that will be used to create transient instances on demand.
+*   ExecutionStrategyResolver: a resolver specific to returning IExecutionStrategy implementations.
+
+Instead of using DbProviderServices.AddDependencyResolver it is also possible to override DbProviderServices.GetService and resolve additional services directly. This method will be called when EF needs a service defined by a certain type and, in some cases, for a given key. The method should return the service if it can, or return null to opt-out of returning the service and instead allow another class to resolve it. For example, to resolve the default connection factory the code in GetService might look something like this:
+
+``` csharp
+public override object GetService(Type type, object key)
+{
+    if (type == typeof(IDbConnectionFactory))
+    {
+        return new SqlConnectionFactory();
+    }
+    return null;
+}
+```
+
+### Registration order
+
+When multiple DbProviderServices implementations are registered in an application’s config file they will be added as secondary resolvers in the order that they are listed. Since resolvers are always added to the top of the secondary resolver chain this means that the provider at the end of the list will get a chance to resolve dependencies before the others. (This can seem a little counter-intuitive at first, but it makes sense if you imagine taking each provider out of the list and stacking it on top of the existing providers.)
+
+This ordering usually doesn’t matter because most provider services are provider-specific and keyed by provider invariant name. However, for services that are not keyed by provider invariant name or some other provider-specific key the service will be resolved based on this ordering. For example, if it is not explicitly set differently somewhere else, then the default connection factory will come from the topmost provider in the chain.
+
+## Additional config file registrations
+
+It is possible to explicitly register some of the additional provider services described above directly in an application’s config file. When this is done the registration in the config file will be used instead of anything returned by the GetService method of the DbProviderServices implementation.
+
+### Registering the default connection factory
+
+Starting with EF5 the EntityFramework NuGet package automatically registered either the SQL Express connection factory or the LocalDb connection factory in the config file.
+
+For example:
+
+``` xml
+<entityFramework>
+  <defaultConnectionFactory type="System.Data.Entity.Infrastructure.SqlConnectionFactory, EntityFramework" >
+</entityFramework>
+```
+
+The _type_ is the assembly-qualified type name for the default connection factory, which must implement IDbConnectionFactory.
+
+It is recommended that a provider NuGet package set the default connection factory in this way when installed. See _NuGet Packages for providers_ below.
+
+## Additional EF6 provider changes
+
+### Spatial provider changes
+
+Providers that support spatial types must now implement some additional methods on classes deriving from DbSpatialDataReader:
+
+*   `public abstract bool IsGeographyColumn(int ordinal)`
+*   `public abstract bool IsGeometryColumn(int ordinal)`
+
+There are also new asynchronous versions of existing methods that are recommended to be overridden as the default implementations delegate to the synchronous methods and therefore do not execute asynchronously:
+
+*   `public virtual Task<DbGeography> GetGeographyAsync(int ordinal, CancellationToken cancellationToken)`
+*   `public virtual Task<DbGeometry> GetGeometryAsync(int ordinal, CancellationToken cancellationToken)`
+
+### Native support for Enumerable.Contains
+
+EF6 introduces a new expression type, DbInExpression, which was added to address performance issues around use of Enumerable.Contains in LINQ queries. The DbProviderManifest class has a new virtual method, SupportsInExpression, which is called by EF to determine if a provider handles the new expression type. For compatibility with existing provider implementations the method returns false. To benefit from this improvement, an EF6 provider can add code to handle DbInExpression and override SupportsInExpression to return true. An instance of DbInExpression can be created by calling the DbExpressionBuilder.In method. A DbInExpression instance is composed of a DbExpression, usually representing a table column, and a list of DbConstantExpression to test for a match.
+
+## NuGet packages for providers
+
+One way to make an EF6 provider available is to release it as a NuGet package. Using a NuGet package has the following advantages:
+
+*   It is easy to use NuGet to add the provider registration to the application’s config file
+*   Additional changes can be made to the config file to set the default connection factory so that connections made by convention will use the registered provider
+*   NuGet handles adding binding redirects so that the EF6 provider should continue to work even after a new EF package is released
+
+An example of this is the EntityFramework.SqlServerCompact package which is included in the [open source codebase](https://github.com/aspnet/entityframework6). This package provides a good template for creating EF provider NuGet packages.
+
+### PowerShell commands
+
+When the EntityFramework NuGet package is installed it registers a PowerShell module that contains two commands that are very useful for provider packages:
+
+*   Add-EFProvider adds a new entity for the provider in the target project’s configuration file and makes sure it is at the end of the list of registered providers.
+*   Add-EFDefaultConnectionFactory either adds or updates the defaultConnectionFactory registration in the target project’s configuration file.
+
+Both these commands take care of adding an entityFramework section to the config file and adding a providers collection if necessary.
+
+It is intended that these commands be called from the install.ps1 NuGet script. For example, install.ps1 for the SQL Compact provider looks similar to this:
+
+``` powershell
+param($installPath, $toolsPath, $package, $project)
+Add-EFDefaultConnectionFactory $project 'System.Data.Entity.Infrastructure.SqlCeConnectionFactory, EntityFramework' -ConstructorArguments 'System.Data.SqlServerCe.4.0'
+Add-EFProvider $project 'System.Data.SqlServerCe.4.0' 'System.Data.Entity.SqlServerCompact.SqlCeProviderServices, EntityFramework.SqlServerCompact'</pre>
+```
+
+More information about these commands can be obtained by using get-help in the Package Manager Console window.
+
+## Wrapping providers
+
+A wrapping provider is an EF and/or ADO.NET provider that wraps an existing provider to extend it with other functionality such as profiling or tracing capabilities. Wrapping providers can be registered in the normal way, but it is often more convenient to setup the wrapping provider at runtime by intercepting the resolution of provider-related services. The static event OnLockingConfiguration on the DbConfiguration class can be used to do this.
+
+OnLockingConfiguration is called after EF has determined where all EF configuration for the app domain will be obtained from but before it is locked for use. At app startup (before EF is used) the app should register an event handler for this event. (We are considering adding support for registering this handler in the config file but this is not yet supported.) The event handler should then make a call to ReplaceService for every service that needs to be wrapped.  
+
+For example, to wrap IDbConnectionFactory and DbProviderService, a handler something like this should be registered:
+
+``` csharp
+DbConfiguration.OnLockingConfiguration +=
+    (_, a) =>
+    {
+        a.ReplaceService<DbProviderServices>(
+            (s, k) => new MyWrappedProviderServices(s));
+
+        a.ReplaceService<IDbConnectionFactory>(
+            (s, k) => new MyWrappedConnectionFactory(s));
+    };
+```
+
+The service that has been resolved and should now be wrapped together with the key that was used to resolve the service are passed to the handler. The handler can then wrap this service and replace the returned service with the wrapped version.
+
+## Resolving a DbProviderFactory with EF
+
+DbProviderFactory is one of the fundamental provider types needed by EF as described in the _Provider types overview_ section above. As already mentioned, It is not an EF type and registration is usually not part of EF configuration, but is instead the normal ADO.NET provider registration in the machine.config file and/or application’s config file.
+
+Despite this EF still uses its normal dependency resolution mechanism when looking for a DbProviderFactory to use. The default resolver uses the normal ADO.NET registration in the config files and so this is usually transparent. But because of the normal dependency resolution mechanism is used it means that an IDbDependencyResolver can be used to resolve a DbProviderFactory even when normal ADO.NET registration has not been done.
+
+Resolving DbProviderFactory in this way has several implications:
+
+*   An application using code-based configuration can add calls in their DbConfiguration class to register the appropriate DbProviderFactory. This is especially useful for applications that do not want to (or cannot) make use of any file-based configuration at all.
+*   The service can be wrapped or replaced using ReplaceService as described in the _Wrapping providers_ section above
+*   Theoretically, a DbProviderServices implementation could resolve a DbProviderFactory.
+
+The important point to note about doing any of these things is that they will only affect the lookup of DbProviderFactory by EF. Other non-EF code may still expect the ADO.NET provider to be registered in the normal way and may fail if the registration is not found. For this reason it is normally better for a DbProviderFactory to be registered in the normal ADO.NET way.
+
+### Related services
+
+If EF is used to resolve a DbProviderFactory, then it should also resolve the IProviderInvariantName and IDbProviderFactoryResolver services.
+
+IProviderInvariantName is a service that is used to determine a provider invariant name for a given type of DbProviderFactory. The default implementation of this service uses the ADO.NET provider registration. This means that if the ADO.NET provider is not registered in the normal way because DbProviderFactory is being resolved by EF, then it will also be necessary to resolve this service. Note that a resolver for this service is automatically added when using the DbConfiguration.SetProviderFactory method.
+
+As described in the _Provider types overview_ section above, the IDbProviderFactoryResolver is used to obtain the correct DbProviderFactory from a given DbConnection object. The default implementation of this service when running on .NET 4 uses the ADO.NET provider registration. This means that if the ADO.NET provider is not registered in the normal way because DbProviderFactory is being resolved by EF, then it will also be necessary to resolve this service.
diff --git a/entity-framework/ef6/fundamentals/providers/spatial-support.md b/entity-framework/ef6/fundamentals/providers/spatial-support.md
new file mode 100644
index 0000000000..934f014e19
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/providers/spatial-support.md
@@ -0,0 +1,54 @@
+---
+title: Provider Support for Spatial Types - EF6
+description: Provider support for spatial types in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/fundamentals/providers/spatial-support
+---
+# Provider Support for Spatial Types
+Entity Framework supports working with spatial data through the DbGeography or DbGeometry classes. These classes rely on database-specific functionality offered by the Entity Framework provider. Not all providers support spatial data and those that do may have additional prerequisites such as the installation of spatial type assemblies. More information about provider support for spatial types is provided below.  
+
+Additional information on how to use spatial types in an application can be found in two walkthroughs, one for Code First, the other for Database First or Model First:  
+
+- [Spatial Data Types in Code First](xref:ef6/modeling/code-first/data-types/spatial)  
+- [Spatial Data Types in EF Designer](xref:ef6/modeling/designer/data-types/spatial)  
+
+## EF releases that support spatial types  
+
+Support for spatial types was introduced in EF5. However, in EF5 spatial types are only supported when the application targets and runs on .NET 4.5.  
+
+Starting with EF6 spatial types are supported for applications targeting both .NET 4 and .NET 4.5.  
+
+## EF providers that support spatial types  
+
+### EF5  
+
+The Entity Framework providers for EF5 that we are aware of that support spatial types are:  
+
+- Microsoft SQL Server provider  
+    - This provider is shipped as part of EF5.  
+    - This provider depends on some additional low-level libraries that may need to be installed—see below for details.  
+- [Devart dotConnect for Oracle](https://www.devart.com/dotconnect/oracle/)  
+    - This is a third-party provider from Devart.  
+
+If you know of an EF5 provider that supports spatial types then please get in contact and we will be happy to add it to this list.  
+
+### EF6  
+
+The Entity Framework providers for EF6 that we are aware of that support spatial types are:  
+
+- Microsoft SQL Server provider  
+    - This provider is shipped as part of EF6.  
+    - This provider depends on some additional low-level libraries that may need to be installed—see below for details.  
+- [Devart dotConnect for Oracle](https://www.devart.com/dotconnect/oracle/)  
+    - This is a third-party provider from Devart.  
+
+If you know of an EF6 provider that supports spatial types then please get in contact and we will be happy to add it to this list.  
+
+## Prerequisites for spatial types with Microsoft SQL Server  
+
+SQL Server spatial support depends on the low-level, SQL Server-specific types SqlGeography and SqlGeometry. These types live in Microsoft.SqlServer.Types.dll assembly, and this assembly is not shipped as part of EF or as part of the .NET Framework.  
+
+When Visual Studio is installed it will often also install a version of SQL Server, and this will include installation of the Microsoft.SqlServer.Types.dll.  
+
+If SQL Server is not installed on the machine where you want to use spatial types, or if spatial types were excluded from the SQL Server installation, then you will need to install them manually. The types can be installed using `SQLSysClrTypes.msi`, which is part of Microsoft SQL Server Feature Pack. Spatial types are SQL Server version-specific, so we recommend [search for "SQL Server Feature Pack"](https://www.microsoft.com/search/explore?q=SQL+Server+Feature+Pack) in the Microsoft Download Center, then select and download the option that corresponds to the version of SQL Server you will use.
diff --git a/entity-framework/ef6/fundamentals/proxies.md b/entity-framework/ef6/fundamentals/proxies.md
new file mode 100644
index 0000000000..7572a524a1
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/proxies.md
@@ -0,0 +1,72 @@
+---
+title: Working with proxies - EF6
+description: Working with proxies in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/fundamentals/proxies
+---
+# Working with proxies
+When creating instances of POCO entity types, Entity Framework often creates instances of a dynamically generated derived type that acts as a proxy for the entity. This proxy overrides some virtual properties of the entity to insert hooks for performing actions automatically when the property is accessed. For example, this mechanism is used to support lazy loading of relationships. The techniques shown in this topic apply equally to models created with Code First and the EF Designer.  
+
+## Disabling proxy creation  
+
+Sometimes it is useful to prevent Entity Framework from creating proxy instances. For example, serializing non-proxy instances is considerably easier than serializing proxy instances. Proxy creation can be turned off by clearing the `ProxyCreationEnabled` flag. One place you could do this is in the constructor of your context. For example:  
+
+``` csharp
+public class BloggingContext : DbContext
+{
+    public BloggingContext()
+    {
+        this.Configuration.ProxyCreationEnabled = false;
+    }  
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+}
+```  
+
+Note that the EF will not create proxies for types where there is nothing for the proxy to do. This means that you can also avoid proxies by having types that are sealed and/or have no virtual properties.  
+
+## Explicitly creating an instance of a proxy  
+
+A proxy instance will not be created if you create an instance of an entity using the new operator. This may not be a problem, but if you need to create a proxy instance (for example, so that lazy loading or proxy change tracking will work) then you can do so using the `Create` method of `DbSet`. For example:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var blog = context.Blogs.Create();
+}
+```  
+
+The generic version of `Create` can be used if you want to create an instance of a derived entity type. For example:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var admin = context.Users.Create<Administrator>();
+}
+```  
+
+Note that the `Create` method does not add or attach the created entity to the context.  
+
+Note that the `Create` method will just create an instance of the entity type itself if creating a proxy type for the entity would have no value because it would not do anything. For example, if the entity type is sealed and/or has no virtual properties then `Create` will just create an instance of the entity type.  
+
+## Getting the actual entity type from a proxy type  
+
+Proxy types have names that look something like this:  
+
+```
+System.Data.Entity.DynamicProxies.Blog_5E43C6C196972BF0754973E48C9C941092D86818CD94005E9A759B70BF6E48E6
+```
+
+You can find the entity type for this proxy type using the `GetObjectType` method from `ObjectContext`. For example:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var blog = context.Blogs.Find(1);
+    var entityType = ObjectContext.GetObjectType(blog.GetType());
+}
+```  
+
+Note that if the type passed to `GetObjectType` is an instance of an entity type that is not a proxy type then the type of entity is still returned. This means you can always use this method to get the actual entity type without any other checking to see if the type is a proxy type or not.  
diff --git a/entity-framework/ef6/fundamentals/relationships.md b/entity-framework/ef6/fundamentals/relationships.md
new file mode 100644
index 0000000000..f52c9cb1dc
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/relationships.md
@@ -0,0 +1,175 @@
+---
+title: Relationships, navigation properties, and foreign keys - EF6
+description: Relationships, navigation properties, and foreign keys in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/fundamentals/relationships
+---
+# Relationships, navigation properties, and foreign keys
+
+This article gives an overview of how Entity Framework manages relationships between entities. It also gives some guidance on how to map and manipulate relationships.
+
+## Relationships in EF
+
+In relational databases, relationships (also called associations) between tables are defined through foreign keys. A foreign key (FK) is a column or combination of columns that is used to establish and enforce a link between the data in two tables. There are generally three types of relationships: one-to-one, one-to-many, and many-to-many. In a one-to-many relationship, the foreign key is defined on the table that represents the many end of the relationship. The many-to-many relationship involves defining a third table (called a junction or join table), whose primary key is composed of the foreign keys from both related tables. In a one-to-one relationship, the primary key acts additionally as a foreign key and there is no separate foreign key column for either table.
+
+The following image shows two tables that participate in one-to-many relationship. The **Course** table is the dependent table because it contains the **DepartmentID** column that links it to the **Department** table.
+
+![Department and Course tables](~/ef6/media/database2.png)
+
+In Entity Framework, an entity can be related to other entities through an association or relationship. Each relationship contains two ends that describe the entity type and the multiplicity of the type (one, zero-or-one, or many) for the two entities in that relationship. The relationship may be governed by a referential constraint, which describes which end in the relationship is a principal role and which is a dependent role.
+
+Navigation properties provide a way to navigate an association between two entity types. Every object can have a navigation property for every relationship in which it participates. Navigation properties allow you to navigate and manage relationships in both directions, returning either a reference object (if the multiplicity is either one or zero-or-one) or a collection (if the multiplicity is many). You may also choose to have one-way navigation, in which case you define the navigation property on only one of the types that participates in the relationship and not on both.
+
+It is recommended to include properties in the model that map to foreign keys in the database. With foreign key properties included, you can create or change a relationship by modifying the foreign key value on a dependent object. This kind of association is called a foreign key association. Using foreign keys is even more essential when working with disconnected entities. Note, that when working with 1-to-1 or 1-to-0..1 relationships, there is no separate foreign key column, the primary key property acts as the foreign key and is always included in the model.
+
+When foreign key columns are not included in the model, the association information is managed as an independent object. Relationships are tracked through object references instead of foreign key properties. This type of association is called an *independent association*. The most common way to modify an *independent association* is to modify the navigation properties that are generated for each entity that participates in the association.
+
+You can choose to use one or both types of associations in your model. However, if you have a pure many-to-many relationship that is connected by a join table that contains only foreign keys, the EF will use an independent association to manage such many-to-many relationship.   
+
+The following image shows a conceptual model that was created with the Entity Framework Designer. The model contains two entities that participate in one-to-many relationship. Both entities have navigation properties. **Course** is the dependent entity and has the **DepartmentID** foreign key property defined.
+
+![Department and Course tables with navigation properties](~/ef6/media/relationshipefdesigner.png)
+
+The following code snippet shows the same model that was created with Code First.
+
+``` csharp
+public class Course
+{
+  public int CourseID { get; set; }
+  public string Title { get; set; }
+  public int Credits { get; set; }
+  public int DepartmentID { get; set; }
+  public virtual Department Department { get; set; }
+}
+
+public class Department
+{
+   public Department()
+   {
+     this.Courses = new HashSet<Course>();
+   }  
+   public int DepartmentID { get; set; }
+   public string Name { get; set; }
+   public decimal Budget { get; set; }
+   public DateTime StartDate { get; set; }
+   public int? Administrator {get ; set; }
+   public virtual ICollection<Course> Courses { get; set; }
+}
+```
+
+## Configuring or mapping relationships
+
+The rest of this page covers how to access and manipulate data using relationships. For information on setting up relationships in your model, see the following pages.
+
+-   To configure relationships in Code First, see [Data Annotations](xref:ef6/modeling/code-first/data-annotations) and [Fluent API – Relationships](xref:ef6/modeling/code-first/fluent/relationships).
+-   To configure relationships using the Entity Framework Designer, see [Relationships with the EF Designer](xref:ef6/modeling/designer/relationships).
+
+## Creating and modifying relationships
+
+In a *foreign key association*, when you change the relationship, the state of a dependent object with an `EntityState.Unchanged` state changes to `EntityState.Modified`. In an independent relationship, changing the relationship does not update the state of the dependent object.
+
+The following examples show how to use the foreign key properties and navigation properties to associate the related objects. With foreign key associations, you can use either method to change, create, or modify relationships. With independent associations, you cannot use the foreign key property.
+
+- By assigning a new value to a foreign key property, as in the following example.  
+  ``` csharp
+  course.DepartmentID = newCourse.DepartmentID;
+  ```
+
+- The following code removes a relationship by setting the foreign key to **null**. Note, that the foreign key property must be nullable.  
+  ``` csharp
+  course.DepartmentID = null;
+  ```
+
+  >[!NOTE]
+  > If the reference is in the added state (in this example, the course object), the reference navigation property will not be synchronized with the key values of a new object until SaveChanges is called. Synchronization does not occur because the object context does not contain permanent keys for added objects until they are saved. If you must have new objects fully synchronized as soon as you set the relationship, use one of the following methods.*
+
+- By assigning a new object to a navigation property. The following code creates a relationship between a course and a `department`. If the objects are attached to the context, the `course` is also added to the `department.Courses` collection, and the corresponding foreign key property on the `course` object is set to the key property value of the department.  
+  ``` csharp
+  course.Department = department;
+  ```
+
+- To delete the relationship, set the navigation property to `null`. If you are working with Entity Framework that is based on .NET 4.0, then the related end needs to be loaded before you set it to null. For example:   
+  ``` csharp
+  context.Entry(course).Reference(c => c.Department).Load();
+  course.Department = null;
+  ```
+
+  Starting with Entity Framework 5.0, that is based on .NET 4.5, you can set the relationship to null without loading the related end. You can also set the current value to null using the following method.   
+  ``` csharp
+  context.Entry(course).Reference(c => c.Department).CurrentValue = null;
+  ```
+
+- By deleting or adding an object in an entity collection. For example, you can add an object of type `Course` to the `department.Courses` collection. This operation creates a relationship between a particular **course** and a particular `department`. If the objects are attached to the context, the department reference and the foreign key property on the **course** object will be set to the appropriate `department`.  
+  ``` csharp
+  department.Courses.Add(newCourse);
+  ```
+
+- By using the `ChangeRelationshipState` method to change the state of the specified relationship between two entity objects. This method is most commonly used when working with N-Tier applications and an *independent association* (it cannot be used with a foreign key association). Also, to use this method you must drop down to `ObjectContext`, as shown in the example below.  
+In the following example, there is a many-to-many relationship between Instructors and Courses. Calling the `ChangeRelationshipState` method and passing the `EntityState.Added` parameter, lets the `SchoolContext` know that a relationship has been added between the two objects:
+  ``` csharp
+
+  ((IObjectContextAdapter)context).ObjectContext.
+    ObjectStateManager.
+    ChangeRelationshipState(course, instructor, c => c.Instructor, EntityState.Added);
+  ```
+
+  Note that if you are updating (not just adding) a relationship, you must delete the old relationship after adding the new one:
+
+  ``` csharp
+  ((IObjectContextAdapter)context).ObjectContext.
+    ObjectStateManager.
+    ChangeRelationshipState(course, oldInstructor, c => c.Instructor, EntityState.Deleted);
+  ```
+
+## Synchronizing the changes between the foreign keys and navigation properties
+
+When you change the relationship of the objects attached to the context by using one of the methods described above, Entity Framework needs to keep foreign keys, references, and collections in sync. Entity Framework automatically manages this synchronization (also known as relationship fix-up) for the POCO entities with proxies. For more information, see [Working with Proxies](xref:ef6/fundamentals/proxies).
+
+If you are using POCO entities without proxies, you must make sure that the **DetectChanges** method is called to synchronize the related objects in the context. Note that the following APIs automatically trigger a **DetectChanges** call.
+
+-   `DbSet.Add`
+-   `DbSet.AddRange`
+-   `DbSet.Remove`
+-   `DbSet.RemoveRange`
+-   `DbSet.Find`
+-   `DbSet.Local`
+-   `DbContext.SaveChanges`
+-   `DbSet.Attach`
+-   `DbContext.GetValidationErrors`
+-   `DbContext.Entry`
+-   `DbChangeTracker.Entries`
+-   Executing a LINQ query against a `DbSet`
+
+## Loading related objects
+
+In Entity Framework you commonly use navigation properties to load entities that are related to the returned entity by the defined association. For more information, see [Loading Related Objects](xref:ef6/querying/related-data).
+
+> [!NOTE]
+> In a foreign key association, when you load a related end of a dependent object, the related object will be loaded based on the foreign key value of the dependent that is currently in memory:
+
+``` csharp
+    // Get the course where currently DepartmentID = 2.
+    Course course = context.Courses.First(c => c.DepartmentID == 2);
+
+    // Use DepartmentID foreign key property
+    // to change the association.
+    course.DepartmentID = 3;
+
+    // Load the related Department where DepartmentID = 3
+    context.Entry(course).Reference(c => c.Department).Load();
+```
+
+In an independent association, the related end of a dependent object is queried based on the foreign key value that is currently in the database. However, if the relationship was modified, and the reference property on the dependent object points to a different principal object that is loaded in the object context, Entity Framework will try to create a relationship as it is defined on the client.
+
+## Managing concurrency
+
+In both foreign key and independent associations, concurrency checks are based on the entity keys and other entity properties that are defined in the model. When using the EF Designer to create a model, set the `ConcurrencyMode` attribute to **fixed** to specify that the property should be checked for concurrency. When using Code First to define a model, use the `ConcurrencyCheck` annotation on properties that you want to be checked for concurrency. When working with Code First you can also use the `TimeStamp` annotation to specify that the property should be checked for concurrency. You can have only one timestamp property in a given class. Code First maps this property to a non-nullable field in the database.
+
+We recommend that you always use the foreign key association when working with entities that participate in concurrency checking and resolution.
+
+For more information, see [Handling Concurrency Conflicts](xref:ef6/saving/concurrency).
+
+## Working with overlapping Keys
+
+Overlapping keys are composite keys where some properties in the key are also part of another key in the entity. You cannot have an overlapping key in an independent association. To change a foreign key association that includes overlapping keys, we recommend that you modify the foreign key values instead of using the object references.
diff --git a/entity-framework/ef6/fundamentals/testing/mocking.md b/entity-framework/ef6/fundamentals/testing/mocking.md
new file mode 100644
index 0000000000..77aa55389d
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/testing/mocking.md
@@ -0,0 +1,400 @@
+---
+title: Testing with a mocking framework - EF6
+description: Testing with a mocking framework in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/fundamentals/testing/mocking
+---
+# Testing with a mocking framework
+> [!NOTE]
+> **EF6 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 6. If you are using an earlier version, some or all of the information does not apply.  
+
+When writing tests for your application it is often desirable to avoid hitting the database.  Entity Framework allows you to achieve this by creating a context – with behavior defined by your tests – that makes use of in-memory data.  
+
+## Options for creating test doubles  
+
+There are two different approaches that can be used to create an in-memory version of your context.  
+
+- **Create your own test doubles** – This approach involves writing your own in-memory implementation of your context and DbSets. This gives you a lot of control over how the classes behave but can involve writing and owning a reasonable amount of code.  
+- **Use a mocking framework to create test doubles** – Using a mocking framework (such as Moq) you can have the in-memory implementations of your context and sets created dynamically at runtime for you.  
+
+This article will deal with using a mocking framework. For creating your own test doubles see [Testing with Your Own Test Doubles](xref:ef6/fundamentals/testing/writing-test-doubles).  
+
+To demonstrate using EF with a mocking framework we are going to use Moq. The easiest way to get Moq is to install the [Moq package from NuGet](https://nuget.org/packages/Moq/).  
+
+## Testing with pre-EF6 versions  
+
+The scenario shown in this article is dependent on some changes we made to DbSet in EF6. For testing with EF5 and earlier version see [Testing with a Fake Context](https://romiller.com/2012/02/14/testing-with-a-fake-dbcontext/).  
+
+## Limitations of EF in-memory test doubles  
+
+In-memory test doubles can be a good way to provide unit test level coverage of bits of your application that use EF. However, when doing this you are using LINQ to Objects to execute queries against in-memory data. This can result in different behavior than using EF’s LINQ provider (LINQ to Entities) to translate queries into SQL that is run against your database.  
+
+One example of such a difference is loading related data. If you create a series of Blogs that each have related Posts, then when using in-memory data the related Posts will always be loaded for each Blog. However, when running against a database the data will only be loaded if you use the Include method.  
+
+For this reason, it is recommended to always include some level of end-to-end testing (in addition to your unit tests) to ensure your application works correctly against a database.  
+
+## Following along with this article  
+
+This article gives complete code listings that you can copy into Visual Studio to follow along if you wish. It's easiest to create a **Unit Test Project** and you will need to target **.NET Framework 4.5** to complete the sections that use async.  
+
+## The EF model  
+
+The service we're going to test makes use of an EF model made up of the BloggingContext and the Blog and Post classes. This code may have been generated by the EF Designer or be a Code First model.  
+
+``` csharp
+using System.Collections.Generic;
+using System.Data.Entity;
+
+namespace TestingDemo
+{
+    public class BloggingContext : DbContext
+    {
+        public virtual DbSet<Blog> Blogs { get; set; }
+        public virtual DbSet<Post> Posts { get; set; }
+    }
+
+    public class Blog
+    {
+        public int BlogId { get; set; }
+        public string Name { get; set; }
+        public string Url { get; set; }
+
+        public virtual List<Post> Posts { get; set; }
+    }
+
+    public class Post
+    {
+        public int PostId { get; set; }
+        public string Title { get; set; }
+        public string Content { get; set; }
+
+        public int BlogId { get; set; }
+        public virtual Blog Blog { get; set; }
+    }
+}
+```  
+
+### Virtual DbSet properties with EF Designer  
+
+Note that the DbSet properties on the context are marked as virtual. This will allow the mocking framework to derive from our context and overriding these properties with a mocked implementation.  
+
+If you are using Code First then you can edit your classes directly. If you are using the EF Designer then you’ll need to edit the T4 template that generates your context. Open up the \<model_name\>.Context.tt file that is nested under you edmx file, find the following fragment of code and add in the virtual keyword as shown.  
+
+``` csharp
+public string DbSet(EntitySet entitySet)
+{
+    return string.Format(
+        CultureInfo.InvariantCulture,
+        "{0} virtual DbSet\<{1}> {2} {{ get; set; }}",
+        Accessibility.ForReadOnlyProperty(entitySet),
+        _typeMapper.GetTypeName(entitySet.ElementType),
+        _code.Escape(entitySet));
+}
+```  
+
+## Service to be tested  
+
+To demonstrate testing with in-memory test doubles we are going to be writing a couple of tests for a BlogService. The service is capable of creating new blogs (AddBlog) and returning all Blogs ordered by name (GetAllBlogs). In addition to GetAllBlogs, we’ve also provided a method that will asynchronously get all blogs ordered by name (GetAllBlogsAsync).  
+
+``` csharp
+using System.Collections.Generic;
+using System.Data.Entity;
+using System.Linq;
+using System.Threading.Tasks;
+
+namespace TestingDemo
+{
+    public class BlogService
+    {
+        private BloggingContext _context;
+
+        public BlogService(BloggingContext context)
+        {
+            _context = context;
+        }
+
+        public Blog AddBlog(string name, string url)
+        {
+            var blog = _context.Blogs.Add(new Blog { Name = name, Url = url });
+            _context.SaveChanges();
+
+            return blog;
+        }
+
+        public List<Blog> GetAllBlogs()
+        {
+            var query = from b in _context.Blogs
+                        orderby b.Name
+                        select b;
+
+            return query.ToList();
+        }
+
+        public async Task<List<Blog>> GetAllBlogsAsync()
+        {
+            var query = from b in _context.Blogs
+                        orderby b.Name
+                        select b;
+
+            return await query.ToListAsync();
+        }
+    }
+}
+```  
+
+## Testing non-query scenarios  
+
+That’s all we need to do to start testing non-query methods. The following test uses Moq to create a context. It then creates a DbSet\<Blog\> and wires it up to be returned from the context’s Blogs property. Next, the context is used to create a new BlogService which is then used to create a new blog – using the AddBlog method. Finally, the test verifies that the service added a new Blog and called SaveChanges on the context.  
+
+``` csharp
+using Microsoft.VisualStudio.TestTools.UnitTesting;
+using Moq;
+using System.Data.Entity;
+
+namespace TestingDemo
+{
+    [TestClass]
+    public class NonQueryTests
+    {
+        [TestMethod]
+        public void CreateBlog_saves_a_blog_via_context()
+        {
+            var mockSet = new Mock<DbSet<Blog>>();
+
+            var mockContext = new Mock<BloggingContext>();
+            mockContext.Setup(m => m.Blogs).Returns(mockSet.Object);
+
+            var service = new BlogService(mockContext.Object);
+            service.AddBlog("ADO.NET Blog", "http://blogs.msdn.com/adonet");
+
+            mockSet.Verify(m => m.Add(It.IsAny<Blog>()), Times.Once());
+            mockContext.Verify(m => m.SaveChanges(), Times.Once());
+        }
+    }
+}
+```  
+
+## Testing query scenarios  
+
+In order to be able to execute queries against our DbSet test double we need to setup an implementation of IQueryable. The first step is to create some in-memory data – we’re using a List\<Blog\>. Next, we create a context and DBSet\<Blog\> then wire up the IQueryable implementation for the DbSet – they’re just delegating to the LINQ to Objects provider that works with List\<T\>.  
+
+We can then create a BlogService based on our test doubles and ensure that the data we get back from GetAllBlogs is ordered by name.  
+
+``` csharp
+using Microsoft.VisualStudio.TestTools.UnitTesting;
+using Moq;
+using System.Collections.Generic;
+using System.Data.Entity;
+using System.Linq;
+
+namespace TestingDemo
+{
+    [TestClass]
+    public class QueryTests
+    {
+        [TestMethod]
+        public void GetAllBlogs_orders_by_name()
+        {
+            var data = new List<Blog>
+            {
+                new Blog { Name = "BBB" },
+                new Blog { Name = "ZZZ" },
+                new Blog { Name = "AAA" },
+            }.AsQueryable();
+
+            var mockSet = new Mock<DbSet<Blog>>();
+            mockSet.As<IQueryable<Blog>>().Setup(m => m.Provider).Returns(data.Provider);
+            mockSet.As<IQueryable<Blog>>().Setup(m => m.Expression).Returns(data.Expression);
+            mockSet.As<IQueryable<Blog>>().Setup(m => m.ElementType).Returns(data.ElementType);
+            mockSet.As<IQueryable<Blog>>().Setup(m => m.GetEnumerator()).Returns(() => data.GetEnumerator());
+
+            var mockContext = new Mock<BloggingContext>();
+            mockContext.Setup(c => c.Blogs).Returns(mockSet.Object);
+
+            var service = new BlogService(mockContext.Object);
+            var blogs = service.GetAllBlogs();
+
+            Assert.AreEqual(3, blogs.Count);
+            Assert.AreEqual("AAA", blogs[0].Name);
+            Assert.AreEqual("BBB", blogs[1].Name);
+            Assert.AreEqual("ZZZ", blogs[2].Name);
+        }
+    }
+}
+```  
+
+### Testing with async queries
+
+Entity Framework 6 introduced a set of extension methods that can be used to asynchronously execute a query. Examples of these methods include ToListAsync, FirstAsync, ForEachAsync, etc.  
+
+Because Entity Framework queries make use of LINQ, the extension methods are defined on IQueryable and IEnumerable. However, because they are only designed to be used with Entity Framework you may receive the following error if you try to use them on a LINQ query that isn’t an Entity Framework query:
+
+> The source IQueryable doesn't implement IDbAsyncEnumerable{0}. Only sources that implement IDbAsyncEnumerable can be used for Entity Framework asynchronous operations. For more details see [http://go.microsoft.com/fwlink/?LinkId=287068](https://go.microsoft.com/fwlink/?LinkId=287068).  
+
+Whilst the async methods are only supported when running against an EF query, you may want to use them in your unit test when running against an in-memory test double of a DbSet.  
+
+In order to use the async methods we need to create an in-memory DbAsyncQueryProvider to process the async query. Whilst it would be possible to setup a query provider using Moq, it is much easier to create a test double implementation in code. The code for this implementation is as follows:  
+
+``` csharp
+using System.Collections.Generic;
+using System.Data.Entity.Infrastructure;
+using System.Linq;
+using System.Linq.Expressions;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace TestingDemo
+{
+    internal class TestDbAsyncQueryProvider<TEntity> : IDbAsyncQueryProvider
+    {
+        private readonly IQueryProvider _inner;
+
+        internal TestDbAsyncQueryProvider(IQueryProvider inner)
+        {
+            _inner = inner;
+        }
+
+        public IQueryable CreateQuery(Expression expression)
+        {
+            return new TestDbAsyncEnumerable<TEntity>(expression);
+        }
+
+        public IQueryable<TElement> CreateQuery<TElement>(Expression expression)
+        {
+            return new TestDbAsyncEnumerable<TElement>(expression);
+        }
+
+        public object Execute(Expression expression)
+        {
+            return _inner.Execute(expression);
+        }
+
+        public TResult Execute<TResult>(Expression expression)
+        {
+            return _inner.Execute<TResult>(expression);
+        }
+
+        public Task<object> ExecuteAsync(Expression expression, CancellationToken cancellationToken)
+        {
+            return Task.FromResult(Execute(expression));
+        }
+
+        public Task<TResult> ExecuteAsync<TResult>(Expression expression, CancellationToken cancellationToken)
+        {
+            return Task.FromResult(Execute<TResult>(expression));
+        }
+    }
+
+    internal class TestDbAsyncEnumerable<T> : EnumerableQuery<T>, IDbAsyncEnumerable<T>, IQueryable<T>
+    {
+        public TestDbAsyncEnumerable(IEnumerable<T> enumerable)
+            : base(enumerable)
+        { }
+
+        public TestDbAsyncEnumerable(Expression expression)
+            : base(expression)
+        { }
+
+        public IDbAsyncEnumerator<T> GetAsyncEnumerator()
+        {
+            return new TestDbAsyncEnumerator<T>(this.AsEnumerable().GetEnumerator());
+        }
+
+        IDbAsyncEnumerator IDbAsyncEnumerable.GetAsyncEnumerator()
+        {
+            return GetAsyncEnumerator();
+        }
+
+        IQueryProvider IQueryable.Provider
+        {
+            get { return new TestDbAsyncQueryProvider<T>(this); }
+        }
+    }
+
+    internal class TestDbAsyncEnumerator<T> : IDbAsyncEnumerator<T>
+    {
+        private readonly IEnumerator<T> _inner;
+
+        public TestDbAsyncEnumerator(IEnumerator<T> inner)
+        {
+            _inner = inner;
+        }
+
+        public void Dispose()
+        {
+            _inner.Dispose();
+        }
+
+        public Task<bool> MoveNextAsync(CancellationToken cancellationToken)
+        {
+            return Task.FromResult(_inner.MoveNext());
+        }
+
+        public T Current
+        {
+            get { return _inner.Current; }
+        }
+
+        object IDbAsyncEnumerator.Current
+        {
+            get { return Current; }
+        }
+    }
+}
+```  
+
+Now that we have an async query provider we can write a unit test for our new GetAllBlogsAsync method.  
+
+``` csharp
+using Microsoft.VisualStudio.TestTools.UnitTesting;
+using Moq;
+using System.Collections.Generic;
+using System.Data.Entity;
+using System.Data.Entity.Infrastructure;
+using System.Linq;
+using System.Threading.Tasks;
+
+namespace TestingDemo
+{
+    [TestClass]
+    public class AsyncQueryTests
+    {
+        [TestMethod]
+        public async Task GetAllBlogsAsync_orders_by_name()
+        {
+
+            var data = new List<Blog>
+            {
+                new Blog { Name = "BBB" },
+                new Blog { Name = "ZZZ" },
+                new Blog { Name = "AAA" },
+            }.AsQueryable();
+
+            var mockSet = new Mock<DbSet<Blog>>();
+            mockSet.As<IDbAsyncEnumerable<Blog>>()
+                .Setup(m => m.GetAsyncEnumerator())
+                .Returns(new TestDbAsyncEnumerator<Blog>(data.GetEnumerator()));
+
+            mockSet.As<IQueryable<Blog>>()
+                .Setup(m => m.Provider)
+                .Returns(new TestDbAsyncQueryProvider<Blog>(data.Provider));
+
+            mockSet.As<IQueryable<Blog>>().Setup(m => m.Expression).Returns(data.Expression);
+            mockSet.As<IQueryable<Blog>>().Setup(m => m.ElementType).Returns(data.ElementType);
+            mockSet.As<IQueryable<Blog>>().Setup(m => m.GetEnumerator()).Returns(() => data.GetEnumerator());
+
+            var mockContext = new Mock<BloggingContext>();
+            mockContext.Setup(c => c.Blogs).Returns(mockSet.Object);
+
+            var service = new BlogService(mockContext.Object);
+            var blogs = await service.GetAllBlogsAsync();
+
+            Assert.AreEqual(3, blogs.Count);
+            Assert.AreEqual("AAA", blogs[0].Name);
+            Assert.AreEqual("BBB", blogs[1].Name);
+            Assert.AreEqual("ZZZ", blogs[2].Name);
+        }
+    }
+}
+```  
diff --git a/entity-framework/ef6/fundamentals/testing/testability-article.md b/entity-framework/ef6/fundamentals/testing/testability-article.md
new file mode 100644
index 0000000000..b0aace8a38
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/testing/testability-article.md
@@ -0,0 +1,972 @@
+---
+title: Testability and Entity Framework 4.0 - EF6
+description: Testability and Entity Framework 4.0
+author: SamMonoRT
+ms.date: 10/23/2016
+ms.custom: sfi-ropc-nochange
+---
+# Testability and Entity Framework 4.0
+Scott Allen
+
+Published: May 2010
+
+## Introduction
+
+This white paper describes and demonstrates how to write testable code with the ADO.NET Entity Framework 4.0 and Visual Studio 2010. This paper does not try to focus on a specific testing methodology, like test-driven design (TDD) or behavior-driven design (BDD). Instead this paper will focus on how to write code that uses the ADO.NET Entity Framework yet remains easy to isolate and test in an automated fashion. We’ll look at common design patterns that facilitate testing in data access scenarios and see how to apply those patterns when using the framework. We’ll also look at specific features of the framework to see how those features can work in testable code.
+
+## What Is Testable Code?
+
+The ability to verify a piece of software using automated unit tests offers many desirable benefits. Everyone knows that good tests will reduce the number of software defects in an application and increase the application’s quality - but having unit tests in place goes far beyond just finding bugs.
+
+A good unit test suite allows a development team to save time and remain in control of the software they create. A team can make changes to existing code, refactor, redesign, and restructure software to meet new requirements, and add new components into an application all while knowing the test suite can verify the application’s behavior. Unit tests are part of a quick feedback cycle to facilitate change and preserve the maintainability of software as complexity increases.
+
+Unit testing comes with a price, however. A team has to invest the time to create and maintain unit tests. The amount of effort required to create these tests is directly related to the **testability** of the underlying software. How easy is the software to test? A team designing software with testability in mind will create effective tests faster than the team working with un-testable software.
+
+Microsoft designed the ADO.NET Entity Framework 4.0 (EF4) with testability in mind. This doesn’t mean developers will be writing unit tests against framework code itself. Instead, the testability goals for EF4 make it easy to create testable code that builds on top of the framework. Before we look at specific examples, it’s worthwhile to understand the qualities of testable code.
+
+### The Qualities of Testable Code
+
+Code that is easy to test will always exhibit at least two traits. First, testable code is easy to **observe**. Given some set of inputs, it should be easy to observe the output of the code. For example, testing the following method is easy because the method directly returns the result of a calculation.
+
+``` csharp
+    public int Add(int x, int y) {
+        return x + y;
+    }
+```
+
+Testing a method is difficult if the method writes the computed value into a network socket, a database table, or a file like the following code. The test has to perform additional work to retrieve the value.
+
+``` csharp
+    public void AddAndSaveToFile(int x, int y) {
+         var results = string.Format("The answer is {0}", x + y);
+         File.WriteAllText("results.txt", results);
+    }
+```
+
+Secondly, testable code is easy to **isolate**. Let’s use the following pseudo-code as a bad example of testable code.
+
+``` csharp
+    public int ComputePolicyValue(InsurancePolicy policy) {
+        using (var connection = new SqlConnection("dbConnection"))
+        using (var command = new SqlCommand(query, connection)) {
+
+            // business calculations omitted ...               
+
+            if (totalValue > notificationThreshold) {
+                var message = new MailMessage();
+                message.Subject = "Warning!";
+                var client = new SmtpClient();
+                client.Send(message);
+            }
+        }
+        return totalValue;
+    }
+```
+
+The method is easy to observe – we can pass in an insurance policy and verify the return value matches an expected result. However, to test the method we’ll need to have a database installed with the correct schema, and configure the SMTP server in case the method tries to send an email.
+
+The unit test only wants to verify the calculation logic inside the method, but the test might fail because the email server is offline, or because the database server moved. Both of these failures are unrelated to the behavior the test wants to verify. The behavior is difficult to isolate.
+
+Software developers who strive to write testable code often strive to maintain a separation of concerns in the code they write. The above method should focus on the business calculations and delegate the database and email implementation details to other components. Robert C. Martin calls this the Single Responsibility Principle. An object should encapsulate a single, narrow responsibility, like calculating the value of a policy. All other database and notification work should be the responsibility of some other object. Code written in this fashion is easier to isolate because it is focused on a single task.
+
+In .NET we have the abstractions we need to follow the Single Responsibility Principle and achieve isolation. We can use interface definitions and force the code to use the interface abstraction instead of a concrete type. Later in this paper we’ll see how a method like the bad example presented above can work with interfaces that *look* like they will talk to the database. At test time, however, we can substitute a dummy implementation that doesn’t talk to the database but instead holds data in memory. This dummy implementation will isolate the code from unrelated problems in the data access code or database configuration.
+
+There are additional benefits to isolation. The business calculation in the last method should only take a few milliseconds to execute, but the test itself might run for several seconds as the code hops around the network and talks to various servers. Unit tests should run fast to facilitate small changes. Unit tests should also be repeatable and not fail because a component unrelated to the test has a problem. Writing code that is easy to observe and to isolate means developers will have an easier time writing tests for the code, spend less time waiting for tests to execute, and more importantly, spend less time tracking down bugs that do not exist.
+
+Hopefully you can appreciate the benefits of testing and understand the qualities that testable code exhibits. We are about to address how to write code that works with EF4 to save data into a database while remaining observable and easy to isolate, but first we’ll narrow our focus to discuss testable designs for data access.
+
+## Design Patterns for Data Persistence
+
+Both of the bad examples presented earlier had too many responsibilities. The first bad example had to perform a calculation *and* write to a file. The second bad example had to read data from a database *and* perform a business calculation *and* send email. By designing smaller methods that separate concerns and delegate responsibility to other components you’ll make great strides towards writing testable code. The goal is to build functionality by composing actions from small and focused abstractions.
+
+When it comes to data persistence the small and focused abstractions we are looking for are so common they’ve been documented as design patterns. Martin Fowler’s book Patterns of Enterprise Application Architecture was the first work to describe these patterns in print. We’ll provide a brief description of these patterns in the following sections before we show how these ADO.NET Entity Framework implements and works with these patterns.
+
+### The Repository Pattern
+
+Fowler says a repository “mediates between the domain and data mapping layers using a collection-like interface for accessing domain objects”. The goal of the repository pattern is to isolate code from the minutiae of data access, and as we saw earlier isolation is a required trait for testability.
+
+The key to the isolation is how the repository exposes objects using a collection-like interface. The logic you write to use the repository has no idea how the repository will materialize the objects you request. The repository might talk to a database, or it might just return objects from an in-memory collection. All your code needs to know is that the repository appears to maintain the collection, and you can retrieve, add, and delete objects from the collection.
+
+In existing .NET applications a concrete repository often inherits from a generic interface like the following:
+
+``` csharp
+    public interface IRepository<T> {       
+        IEnumerable<T> FindAll();
+        IEnumerable<T> FindBy(Expression<Func\<T, bool>> predicate);
+        T FindById(int id);
+        void Add(T newEntity);
+        void Remove(T entity);
+    }
+```
+
+We’ll make a few changes to the interface definition when we provide an implementation for EF4, but the basic concept remains the same. Code can use a concrete repository implementing this interface to retrieve an entity by its primary key value, to retrieve a collection of entities based on the evaluation of a predicate, or simply retrieve all available entities. The code can also add and remove entities through the repository interface.
+
+Given an IRepository of Employee objects, code can perform the following operations.
+
+``` csharp
+    var employeesNamedScott =
+        repository
+            .FindBy(e => e.Name == "Scott")
+            .OrderBy(e => e.HireDate);
+    var firstEmployee = repository.FindById(1);
+    var newEmployee = new Employee() {/*... */};
+    repository.Add(newEmployee);
+```
+
+Since the code is using an interface (IRepository of Employee), we can provide the code with different implementations of the interface. One implementation might be an implementation backed by EF4 and persisting objects into a Microsoft SQL Server database. A different implementation (one we use during testing) might be backed by an in-memory List of Employee objects. The interface will help to achieve isolation in the code.
+
+Notice the IRepository&lt;T&gt; interface does not expose a Save operation. How do we update existing objects? You might come across IRepository definitions that do include the Save operation, and implementations of these repositories will need to immediately persist an object into the database. However, in many applications we don’t want to persist objects individually. Instead, we want to bring objects to life, perhaps from different repositories, modify those objects as part of a business activity, and then persist all the objects as part of a single, atomic operation. Fortunately, there is a pattern to allow this type of behavior.
+
+### The Unit of Work Pattern
+
+Fowler says a unit of work will “maintain a list of objects affected by a business transaction and coordinates the writing out of changes and the resolution of concurrency problems”. It is the responsibility of the unit of work to track changes to the objects we bring to life from a repository and persist any changes we’ve made to the objects when we tell the unit of work to commit the changes. It’s also the responsibility of the unit of work to take the new objects we’ve added to all repositories and insert the objects into a database, and also mange deletion.
+
+If you’ve ever done any work with ADO.NET DataSets then you’ll already be familiar with the unit of work pattern. ADO.NET DataSets had the ability to track our updates, deletions, and insertion of DataRow objects and could (with the help of a TableAdapter) reconcile all our changes to a database. However, DataSet objects model a disconnected subset of the underlying database. The unit of work pattern exhibits the same behavior, but works with business objects and domain objects that are isolated from data access code and unaware of the database.
+
+An abstraction to model the unit of work in .NET code might look like the following:
+
+``` csharp
+    public interface IUnitOfWork {
+        IRepository<Employee> Employees { get; }
+        IRepository<Order> Orders { get; }
+        IRepository<Customer> Customers { get; }
+        void Commit();
+    }
+```
+
+By exposing repository references from the unit of work we can ensure a single unit of work object has the ability to track all entities materialized during a business transaction. The implementation of the Commit method for a real unit of work is where all the magic happens to reconcile in-memory changes with the database. 
+
+Given an IUnitOfWork reference, code can make changes to business objects retrieved from one or more repositories and save all the changes using the atomic Commit operation.
+
+``` csharp
+    var firstEmployee = unitofWork.Employees.FindById(1);
+    var firstCustomer = unitofWork.Customers.FindById(1);
+    firstEmployee.Name = "Alex";
+    firstCustomer.Name = "Christopher";
+    unitofWork.Commit();
+```
+
+### The Lazy Load Pattern
+
+Fowler uses the name lazy load to describe “an object that doesn’t contain all of the data you need but knows how to get it”. Transparent lazy loading is an important feature to have when writing testable business code and working with a relational database. As an example, consider the following code.
+
+``` csharp
+    var employee = repository.FindById(id);
+    // ... and later ...
+    foreach(var timeCard in employee.TimeCards) {
+        // .. manipulate the timeCard
+    }
+```
+
+How is the TimeCards collection populated? There are two possible answers. One answer is that the employee repository, when asked to fetch an employee, issues a query to retrieve both the employee along with the employee’s associated time card information. In relational databases this generally requires a query with a JOIN clause and may result in retrieving more information than an application needs. What if the application never needs to touch the TimeCards property?
+
+A second answer is to load the TimeCards property “on demand”. This lazy loading is implicit and transparent to the business logic because the code does not invoke special APIs to retrieve time card information. The code assumes the time card information is present when needed. There is some magic involved with lazy loading that generally involves runtime interception of method invocations. The intercepting code is responsible for talking to the database and retrieving time card information while leaving the business logic free to be business logic. This lazy load magic allows the business code to isolate itself from data retrieval operations and results in more testable code.
+
+The drawback to a lazy load is that when an application *does* need the time card information the code will execute an additional query. This isn’t a concern for many applications, but for performance sensitive applications or applications looping through a number of employee objects and executing a query to retrieve time cards during each iteration of the loop (a problem often referred to as the N+1 query problem), lazy loading is a drag. In these scenarios an application might want to eagerly load time card information in the most efficient manner possible.
+
+Fortunately, we’ll see how EF4 supports both implicit lazy loads and efficient eager loads as we move into the next section and implement these patterns.
+
+## Implementing Patterns with the Entity Framework
+
+The good news is that all of the design patterns we described in the last section are straightforward to implement with EF4. To demonstrate we are going to use a simple ASP.NET MVC application to edit and display Employees and their associated time card information. We’ll start by using the following “plain old CLR objects” (POCOs). 
+
+``` csharp
+    public class Employee {
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public DateTime HireDate { get; set; }
+        public ICollection<TimeCard> TimeCards { get; set; }
+    }
+
+    public class TimeCard {
+        public int Id { get; set; }
+        public int Hours { get; set; }
+        public DateTime EffectiveDate { get; set; }
+    }
+```
+
+These class definitions will change slightly as we explore different approaches and features of EF4, but the intent is to keep these classes as persistence ignorant (PI) as possible. A PI object doesn’t know *how*, or even *if*, the state it holds lives inside a database. PI and POCOs go hand in hand with testable software. Objects using a POCO approach are less constrained, more flexible, and easier to test because they can operate without a database present.
+
+With the POCOs in place we can create an Entity Data Model (EDM) in Visual Studio (see figure 1). We will not use the EDM to generate code for our entities. Instead, we want to use the entities we lovingly craft by hand. We will only use the EDM to generate our database schema and provide the metadata EF4 needs to map objects into the database.
+
+![ef test_01](~/ef6/media/eftest-01.jpg)
+
+**Figure 1**
+
+Note: if you want to develop the EDM model first, it is possible to generate clean, POCO code from the EDM. You can do this with a Visual Studio 2010 extension provided by the Data Programmability team. To download the extension, launch the Extension Manager from the Tools menu in Visual Studio and search the online gallery of templates for “POCO” (See figure 2). There are several POCO templates available for EF. For more information on using the template, see “ [Walkthrough: POCO Template for the Entity Framework](/archive/blogs/adonet/walkthrough-poco-template-for-the-entity-framework)”.
+
+![ef test_02](~/ef6/media/eftest-02.png)
+
+**Figure 2**
+
+From this POCO starting point we will explore two different approaches to testable code. The first approach I call the EF approach because it leverages abstractions from the Entity Framework API to implement units of work and repositories. In the second approach we will create our own custom repository abstractions and then see the advantages and disadvantages of each approach. We’ll start by exploring the EF approach.  
+
+### An EF Centric Implementation
+
+Consider the following controller action from an ASP.NET MVC project. The action retrieves an Employee object and returns a result to display a detailed view of the employee.
+
+``` csharp
+    public ViewResult Details(int id) {
+        var employee = _unitOfWork.Employees
+                                  .Single(e => e.Id == id);
+        return View(employee);
+    }
+```
+
+Is the code testable? There are at least two tests we’d need to verify the action’s behavior. First, we’d like to verify the action returns the correct view – an easy test. We’d also want to write a test to verify the action retrieves the correct employee, and we’d like to do this without executing code to query the database. Remember we want to isolate the code under test. Isolation will ensure the test doesn’t fail because of a bug in the data access code or database configuration. If the test fails, we will know we have a bug in the controller logic, and not in some lower level system component.
+
+To achieve isolation we’ll need some abstractions like the interfaces we presented earlier for repositories and units of work. Remember the repository pattern is designed to mediate between domain objects and the data mapping layer. In this scenario EF4 *is* the data mapping layer, and already provides a repository-like abstraction named IObjectSet&lt;T&gt; (from the System.Data.Objects namespace). The interface definition looks like the following.
+
+``` csharp
+    public interface IObjectSet<TEntity> :
+                     IQueryable<TEntity>,
+                     IEnumerable<TEntity>,
+                     IQueryable,
+                     IEnumerable
+                     where TEntity : class
+    {
+        void AddObject(TEntity entity);
+        void Attach(TEntity entity);
+        void DeleteObject(TEntity entity);
+        void Detach(TEntity entity);
+    }
+```
+
+IObjectSet&lt;T&gt; meets the requirements for a repository because it resembles a collection of objects (via IEnumerable&lt;T&gt;) and provides methods to add and remove objects from the simulated collection. The Attach and Detach methods expose additional capabilities of the EF4 API. To use IObjectSet&lt;T&gt; as the interface for repositories we need a unit of work abstraction to bind repositories together.
+
+``` csharp
+    public interface IUnitOfWork {
+        IObjectSet<Employee> Employees { get; }
+        IObjectSet<TimeCard> TimeCards { get; }
+        void Commit();
+    }
+```
+
+One concrete implementation of this interface will talk to SQL Server and is easy to create using the ObjectContext class from EF4. The ObjectContext class is the real unit of work in the EF4 API.
+
+``` csharp
+    public class SqlUnitOfWork : IUnitOfWork {
+        public SqlUnitOfWork() {
+            var connectionString =
+                ConfigurationManager
+                    .ConnectionStrings[ConnectionStringName]
+                    .ConnectionString;
+            _context = new ObjectContext(connectionString);
+        }
+
+        public IObjectSet<Employee> Employees {
+            get { return _context.CreateObjectSet<Employee>(); }
+        }
+
+        public IObjectSet<TimeCard> TimeCards {
+            get { return _context.CreateObjectSet<TimeCard>(); }
+        }
+
+        public void Commit() {
+            _context.SaveChanges();
+        }
+
+        readonly ObjectContext _context;
+        const string ConnectionStringName = "EmployeeDataModelContainer";
+    }
+```
+
+Bringing an IObjectSet&lt;T&gt; to life is as easy as invoking the CreateObjectSet method of the ObjectContext object. Behind the scenes the framework will use the metadata we provided in the EDM to produce a concrete ObjectSet&lt;T&gt;. We’ll stick with returning the IObjectSet&lt;T&gt; interface because it will help preserve testability in client code.
+
+This concrete implementation is useful in production, but we need to focus on how we’ll use our IUnitOfWork abstraction to facilitate testing.
+
+### The Test Doubles
+
+To isolate the controller action we’ll need the ability to switch between the real unit of work (backed by an ObjectContext) and a test double or “fake” unit of work (performing in-memory operations). The common approach to perform this type of switching is to not let the MVC controller instantiate a unit of work, but instead pass the unit of work into the controller as a constructor parameter.
+
+``` csharp
+    class EmployeeController : Controller {
+      publicEmployeeController(IUnitOfWork unitOfWork)  {
+          _unitOfWork = unitOfWork;
+      }
+      ...
+    }
+```
+
+The above code is an example of dependency injection. We don’t allow the controller to create it’s dependency (the unit of work) but inject the dependency into the controller. In an MVC project it is common to use a custom controller factory in combination with an inversion of control (IoC) container to automate dependency injection. These topics are beyond the scope of this article, but you can read more by following the references at the end of this article.
+
+A fake unit of work implementation that we can use for testing might look like the following.
+
+``` csharp
+    public class InMemoryUnitOfWork : IUnitOfWork {
+        public InMemoryUnitOfWork() {
+            Committed = false;
+        }
+        public IObjectSet<Employee> Employees {
+            get;
+            set;
+        }
+
+        public IObjectSet<TimeCard> TimeCards {
+            get;
+            set;
+        }
+
+        public bool Committed { get; set; }
+        public void Commit() {
+            Committed = true;
+        }
+    }
+```
+
+Notice the fake unit of work exposes a Commited property. It’s sometimes useful to add features to a fake class that facilitate testing. In this case it is easy to observe if code commits a unit of work by checking the Commited property.
+
+We’ll also need a fake IObjectSet&lt;T&gt; to hold Employee and TimeCard objects in memory. We can provide a single implementation using generics.
+
+``` csharp
+    public class InMemoryObjectSet<T> : IObjectSet<T> where T : class
+        public InMemoryObjectSet()
+            : this(Enumerable.Empty<T>()) {
+        }
+        public InMemoryObjectSet(IEnumerable<T> entities) {
+            _set = new HashSet<T>();
+            foreach (var entity in entities) {
+                _set.Add(entity);
+            }
+            _queryableSet = _set.AsQueryable();
+        }
+        public void AddObject(T entity) {
+            _set.Add(entity);
+        }
+        public void Attach(T entity) {
+            _set.Add(entity);
+        }
+        public void DeleteObject(T entity) {
+            _set.Remove(entity);
+        }
+        public void Detach(T entity) {
+            _set.Remove(entity);
+        }
+        public Type ElementType {
+            get { return _queryableSet.ElementType; }
+        }
+        public Expression Expression {
+            get { return _queryableSet.Expression; }
+        }
+        public IQueryProvider Provider {
+            get { return _queryableSet.Provider; }
+        }
+        public IEnumerator<T> GetEnumerator() {
+            return _set.GetEnumerator();
+        }
+        IEnumerator IEnumerable.GetEnumerator() {
+            return GetEnumerator();
+        }
+
+        readonly HashSet<T> _set;
+        readonly IQueryable<T> _queryableSet;
+    }
+```
+
+This test double delegates most of its work to an underlying HashSet&lt;T&gt; object. Note that IObjectSet&lt;T&gt; requires a generic constraint enforcing T as a class (a reference type), and also forces us to implement IQueryable&lt;T&gt;. It is easy to make an in-memory collection appear as an IQueryable&lt;T&gt; using the standard LINQ operator AsQueryable.
+
+### The Tests
+
+Traditional unit tests will use a single test class to hold all of the tests for all of the actions in a single MVC controller. We can write these tests, or any type of unit test, using the in memory fakes we’ve built. However, for this article we will avoid the monolithic test class approach and instead group our tests to focus on a specific piece of functionality.  For example, “create new employee” might be the functionality we want to test, so we will use a single test class to verify the single controller action responsible for creating a new employee.
+
+There is some common setup code we need for all these fine grained test classes. For example, we always need to create our in-memory repositories and fake unit of work. We also need an instance of the employee controller with the fake unit of work injected. We’ll share this common setup code across test classes by using a base class.
+
+``` csharp
+    public class EmployeeControllerTestBase {
+        public EmployeeControllerTestBase() {
+            _employeeData = EmployeeObjectMother.CreateEmployees()
+                                                .ToList();
+            _repository = new InMemoryObjectSet<Employee>(_employeeData);
+            _unitOfWork = new InMemoryUnitOfWork();
+            _unitOfWork.Employees = _repository;
+            _controller = new EmployeeController(_unitOfWork);
+        }
+
+        protected IList<Employee> _employeeData;
+        protected EmployeeController _controller;
+        protected InMemoryObjectSet<Employee> _repository;
+        protected InMemoryUnitOfWork _unitOfWork;
+    }
+```
+
+The “object mother” we use in the base class is one common pattern for creating test data. An object mother contains factory methods to instantiate test entities for use across multiple test fixtures.
+
+``` csharp
+    public static class EmployeeObjectMother {
+        public static IEnumerable<Employee> CreateEmployees() {
+            yield return new Employee() {
+                Id = 1, Name = "Scott", HireDate=new DateTime(2002, 1, 1)
+            };
+            yield return new Employee() {
+                Id = 2, Name = "Poonam", HireDate=new DateTime(2001, 1, 1)
+            };
+            yield return new Employee() {
+                Id = 3, Name = "Simon", HireDate=new DateTime(2008, 1, 1)
+            };
+        }
+        // ... more fake data for different scenarios
+    }
+```
+
+We can use the EmployeeControllerTestBase as the base class for a number of test fixtures (see figure 3). Each test fixture will test a specific controller action. For example, one test fixture will focus on testing the Create action used during an HTTP GET request (to display the view for creating an employee), and a different fixture will focus on the Create action used in an HTTP POST request (to take information submitted by the user to create an employee). Each derived class is only responsible for the setup needed in its specific context, and to provide the assertions needed to verify the outcomes for its specific test context.
+
+![ef test_03](~/ef6/media/eftest-03.png)
+
+**Figure 3**
+
+The naming convention and test style presented here isn’t required for testable code – it’s just one approach. Figure 4 shows the tests running in the Jet Brains Resharper test runner plugin for Visual Studio 2010.
+
+![ef test_04](~/ef6/media/eftest-04.png)
+
+**Figure 4**
+
+With a base class to handle the shared setup code, the unit tests for each controller action are small and easy to write. The tests will execute quickly (since we are performing in-memory operations), and shouldn’t fail because of unrelated infrastructure or environmental concerns (because we’ve isolated the unit under test).
+
+``` csharp
+    [TestClass]
+    public class EmployeeControllerCreateActionPostTests
+               : EmployeeControllerTestBase {
+        [TestMethod]
+        public void ShouldAddNewEmployeeToRepository() {
+            _controller.Create(_newEmployee);
+            Assert.IsTrue(_repository.Contains(_newEmployee));
+        }
+        [TestMethod]
+        public void ShouldCommitUnitOfWork() {
+            _controller.Create(_newEmployee);
+            Assert.IsTrue(_unitOfWork.Committed);
+        }
+        // ... more tests
+
+        Employee _newEmployee = new Employee() {
+            Name = "NEW EMPLOYEE",
+            HireDate = new System.DateTime(2010, 1, 1)
+        };
+    }
+```
+
+In these tests, the base class does most of the setup work. Remember the base class constructor creates the in-memory repository, a fake unit of work, and an instance of the EmployeeController class. The test class derives from this base class and focuses on the specifics of testing the Create method. In this case the specifics boil down to the “arrange, act, and assert” steps you’ll see in any unit testing procedure:
+
+-   Create a newEmployee object to simulate incoming data.
+-   Invoke the Create action of the EmployeeController and pass in the newEmployee.
+-   Verify the Create action produces the expected results (the employee appears in the repository).
+
+What we’ve built allows us to test any of the EmployeeController actions. For example, when we write tests for the Index action of the Employee controller we can inherit from the test base class to establish the same base setup for our tests. Again the base class will create the in-memory repository, the fake unit of work, and an instance of the EmployeeController. The tests for the Index action only need to focus on invoking the Index action and testing the qualities of the model the action returns.
+
+``` csharp
+    [TestClass]
+    public class EmployeeControllerIndexActionTests
+               : EmployeeControllerTestBase {
+        [TestMethod]
+        public void ShouldBuildModelWithAllEmployees() {
+            var result = _controller.Index();
+            var model = result.ViewData.Model
+                          as IEnumerable<Employee>;
+            Assert.IsTrue(model.Count() == _employeeData.Count);
+        }
+        [TestMethod]
+        public void ShouldOrderModelByHiredateAscending() {
+            var result = _controller.Index();
+            var model = result.ViewData.Model
+                         as IEnumerable<Employee>;
+            Assert.IsTrue(model.SequenceEqual(
+                           _employeeData.OrderBy(e => e.HireDate)));
+        }
+        // ...
+    }
+```
+
+The tests we are creating with in-memory fakes are oriented towards testing the *state* of the software. For example, when testing the Create action we want to inspect the state of the repository after the create action executes – does the repository hold the new employee?
+
+``` csharp
+    [TestMethod]
+    public void ShouldAddNewEmployeeToRepository() {
+        _controller.Create(_newEmployee);
+        Assert.IsTrue(_repository.Contains(_newEmployee));
+    }
+```
+
+Later we’ll look at interaction based testing. Interaction based testing will ask if the code under test invoked the proper methods on our objects and passed the correct parameters. For now we’ll move on the cover another design pattern – the lazy load.
+
+## Eager Loading and Lazy Loading
+
+At some point in the ASP.NET  MVC web application we might wish to display an employee’s information and include the employee’s associated time cards. For example, we might have a time card summary display that shows the employee’s name and the total number of time cards in the system. There are several approaches we can take to implement this feature.
+
+### Projection
+
+One easy approach to create the summary is to construct a model dedicated to the information we want to display in the view. In this scenario the model might look like the following.
+
+``` csharp
+    public class EmployeeSummaryViewModel {
+        public string Name { get; set; }
+        public int TotalTimeCards { get; set; }
+    }
+```
+
+Note that the EmployeeSummaryViewModel is not an entity – in other words it is not something we want to persist in the database. We are only going to use this class to shuffle data into the view in a strongly typed manner. The view model is like a data transfer object (DTO) because it contains no behavior (no methods) – only properties. The properties will hold the data we need to move. It is easy to instantiate this view model using LINQ’s standard projection operator – the Select operator.
+
+``` csharp
+    public ViewResult Summary(int id) {
+        var model = _unitOfWork.Employees
+                               .Where(e => e.Id == id)
+                               .Select(e => new EmployeeSummaryViewModel
+                                  {
+                                    Name = e.Name,
+                                    TotalTimeCards = e.TimeCards.Count()
+                                  })
+                               .Single();
+        return View(model);
+    }
+```
+
+There are two notable features to the above code. First – the code is easy to test because it is still easy to observe and isolate. The Select operator works just as well against our in-memory fakes as it does against the real unit of work.
+
+``` csharp
+    [TestClass]
+    public class EmployeeControllerSummaryActionTests
+               : EmployeeControllerTestBase {
+        [TestMethod]
+        public void ShouldBuildModelWithCorrectEmployeeSummary() {
+            var id = 1;
+            var result = _controller.Summary(id);
+            var model = result.ViewData.Model as EmployeeSummaryViewModel;
+            Assert.IsTrue(model.TotalTimeCards == 3);
+        }
+        // ...
+    }
+```
+
+The second notable feature is how the code allows EF4 to generate a single, efficient query to assemble employee and time card information together. We’ve loaded employee information and time card information into the same object without using any special APIs. The code merely expressed the information it requires using standard LINQ operators that work against in-memory data sources as well as remote data sources. EF4 was able to translate the expression trees generated by the LINQ query and C\# compiler into a single and efficient T-SQL query.
+
+``` SQL
+    SELECT
+    [Limit1].[Id] AS [Id],
+    [Limit1].[Name] AS [Name],
+    [Limit1].[C1] AS [C1]
+    FROM (SELECT TOP (2)
+      [Project1].[Id] AS [Id],
+      [Project1].[Name] AS [Name],
+      [Project1].[C1] AS [C1]
+      FROM (SELECT
+        [Extent1].[Id] AS [Id],
+        [Extent1].[Name] AS [Name],
+        (SELECT COUNT(1) AS [A1]
+         FROM [dbo].[TimeCards] AS [Extent2]
+         WHERE [Extent1].[Id] =
+               [Extent2].[EmployeeTimeCard_TimeCard_Id]) AS [C1]
+              FROM [dbo].[Employees] AS [Extent1]
+               WHERE [Extent1].[Id] = @p__linq__0
+         )  AS [Project1]
+    )  AS [Limit1]
+```
+
+There are other times when we don’t want to work with a view model or DTO object, but with real entities. When we know we need an employee *and* the employee’s time cards, we can eagerly load the related data in an unobtrusive and efficient manner.
+
+### Explicit Eager Loading
+
+When we want to eagerly load related entity information we need some mechanism for business logic (or in this scenario, controller action logic) to express its desire to the repository. The EF4 ObjectQuery&lt;T&gt; class defines an Include method to specify the related objects to retrieve during a query. Remember the EF4 ObjectContext exposes entities via the concrete ObjectSet&lt;T&gt; class which inherits from ObjectQuery&lt;T&gt;.  If we were using ObjectSet&lt;T&gt; references in our controller action we could write the following code to specify an eager load of time card information for each employee.
+
+``` csharp
+    _employees.Include("TimeCards")
+              .Where(e => e.HireDate.Year > 2009);
+```
+
+However, since we are trying to keep our code testable we are not exposing ObjectSet&lt;T&gt; from outside the real unit of work class. Instead, we rely on the IObjectSet&lt;T&gt; interface which is easier to fake, but IObjectSet&lt;T&gt; does not define an Include method. The beauty of LINQ is that we can create our own Include operator.
+
+``` csharp
+    public static class QueryableExtensions {
+        public static IQueryable<T> Include<T>
+                (this IQueryable<T> sequence, string path) {
+            var objectQuery = sequence as ObjectQuery<T>;
+            if(objectQuery != null)
+            {
+                return objectQuery.Include(path);
+            }
+            return sequence;
+        }
+    }
+```
+
+Notice this Include operator is defined as an extension method for IQueryable&lt;T&gt; instead of IObjectSet&lt;T&gt;. This gives us the ability to use the method with a wider range of possible types, including IQueryable&lt;T&gt;, IObjectSet&lt;T&gt;, ObjectQuery&lt;T&gt;, and ObjectSet&lt;T&gt;. In the event the underlying sequence is not a genuine EF4 ObjectQuery&lt;T&gt;, then there is no harm done and the Include operator is a no-op. If the underlying sequence *is* an ObjectQuery&lt;T&gt; (or derived from ObjectQuery&lt;T&gt;), then EF4 will see our requirement for additional data and formulate the proper SQL query.
+
+With this new operator in place we can explicitly request an eager load of time card information from the repository.
+
+``` csharp
+    public ViewResult Index() {
+        var model = _unitOfWork.Employees
+                               .Include("TimeCards")
+                               .OrderBy(e => e.HireDate);
+        return View(model);
+    }
+```
+
+When run against a real ObjectContext, the code produces the following single query. The query gathers enough information from the database in one trip to materialize the employee objects and fully populate their TimeCards property.
+
+``` SQL
+    SELECT
+    [Project1].[Id] AS [Id],
+    [Project1].[Name] AS [Name],
+    [Project1].[HireDate] AS [HireDate],
+    [Project1].[C1] AS [C1],
+    [Project1].[Id1] AS [Id1],
+    [Project1].[Hours] AS [Hours],
+    [Project1].[EffectiveDate] AS [EffectiveDate],
+    [Project1].[EmployeeTimeCard_TimeCard_Id] AS [EmployeeTimeCard_TimeCard_Id]
+    FROM ( SELECT
+         [Extent1].[Id] AS [Id],
+         [Extent1].[Name] AS [Name],
+         [Extent1].[HireDate] AS [HireDate],
+         [Extent2].[Id] AS [Id1],
+         [Extent2].[Hours] AS [Hours],
+         [Extent2].[EffectiveDate] AS [EffectiveDate],
+         [Extent2].[EmployeeTimeCard_TimeCard_Id] AS
+                    [EmployeeTimeCard_TimeCard_Id],
+         CASE WHEN ([Extent2].[Id] IS NULL) THEN CAST(NULL AS int)
+         ELSE 1 END AS [C1]
+         FROM  [dbo].[Employees] AS [Extent1]
+         LEFT OUTER JOIN [dbo].[TimeCards] AS [Extent2] ON [Extent1].[Id] = [Extent2].[EmployeeTimeCard_TimeCard_Id]
+    )  AS [Project1]
+    ORDER BY [Project1].[HireDate] ASC,
+             [Project1].[Id] ASC, [Project1].[C1] ASC
+```
+
+The great news is the code inside the action method remains fully testable. We don’t need to provide any additional features for our fakes to support the Include operator. The bad news is we had to use the Include operator inside of the code we wanted to keep persistence ignorant. This is a prime example of the type of tradeoffs you’ll need to evaluate when building testable code. There are times when you need to let persistence concerns leak outside the repository abstraction to meet performance goals.
+
+The alternative to eager loading is lazy loading. Lazy loading means we do *not* need our business code to explicitly announce the requirement for associated data. Instead, we use our entities in the application and if additional data is needed Entity Framework will load the data on demand.
+
+### Lazy Loading
+
+It’s easy to imagine a scenario where we don’t know what data a piece of business logic will need. We might know the logic needs an employee object, but we may branch into different execution paths where some of those paths require time card information from the employee, and some do not. Scenarios like this are perfect for implicit lazy loading because data magically appears on an as-needed basis.
+
+Lazy loading, also known as deferred loading, does place some requirements on our entity objects. POCOs with true persistence ignorance would not face any requirements from the persistence layer, but true persistence ignorance is practically impossible to achieve.  Instead we measure persistence ignorance in relative degrees. It would be unfortunate if we needed to inherit from a persistence oriented base class or use a specialized collection to achieve lazy loading in POCOs. Fortunately, EF4 has a less intrusive solution.
+
+### Virtually Undetectable
+
+When using POCO objects, EF4 can dynamically generate runtime proxies for entities. These proxies invisibly wrap the materialized POCOs and provide additional services by intercepting each property get and set operation to perform additional work. One such service is the lazy loading feature we are looking for. Another service is an efficient change tracking mechanism which can record when the program changes the property values of an entity. The list of changes is used by the ObjectContext during the SaveChanges method to persist any modified entities using UPDATE commands.
+
+For these proxies to work, however, they need a way to hook into property get and set operations on an entity, and the proxies achieve this goal by overriding virtual members. Thus, if we want to have implicit lazy loading and efficient change tracking we need to go back to our POCO class definitions and mark properties as virtual.
+
+``` csharp
+    public class Employee {
+        public virtual int Id { get; set; }
+        public virtual string Name { get; set; }
+        public virtual DateTime HireDate { get; set; }
+        public virtual ICollection<TimeCard> TimeCards { get; set; }
+    }
+```
+
+We can still say the Employee entity is mostly persistence ignorant. The only requirement is to use virtual members and this does not impact the testability of the code. We don’t need to derive from any special base class, or even use a special collection dedicated to lazy loading. As the code demonstrates, any class implementing ICollection&lt;T&gt; is available to hold related entities.
+
+There is also one minor change we need to make inside our unit of work. Lazy loading is *off* by default when working directly with an ObjectContext object. There is a property we can set on the ContextOptions property to enable deferred loading, and we can set this property inside our real unit of work if we want to enable lazy loading everywhere.
+
+``` csharp
+    public class SqlUnitOfWork : IUnitOfWork {
+         public SqlUnitOfWork() {
+             // ...
+             _context = new ObjectContext(connectionString);
+             _context.ContextOptions.LazyLoadingEnabled = true;
+         }    
+         // ...
+     }
+```
+
+With implicit lazy loading enabled, application code can use an employee and the employee’s associated time cards while remaining blissfully unaware of the work required for EF to load the extra data.
+
+``` csharp
+    var employee = _unitOfWork.Employees
+                              .Single(e => e.Id == id);
+    foreach (var card in employee.TimeCards) {
+        // ...
+    }
+```
+
+Lazy loading makes the application code easier to write, and with the proxy magic the code remains completely testable. In-memory fakes of the unit of work can simply preload fake entities with associated data when needed during a test.
+
+At this point we’ll turn our attention from building repositories using IObjectSet&lt;T&gt; and look at abstractions to hide all signs of the persistence framework.
+
+## Custom Repositories
+
+When we first presented the unit of work design pattern in this article we provided some sample code for what the unit of work might look like. Let’s re-present this original idea using the employee and employee time card scenario we’ve been working with.
+
+``` csharp
+    public interface IUnitOfWork {
+        IRepository<Employee> Employees { get; }
+        IRepository<TimeCard> TimeCards { get;  }
+        void Commit();
+    }
+```
+
+The primary difference between this unit of work and the unit of work we created in the last section is how this unit of work does not use any abstractions from the EF4 framework (there is no IObjectSet&lt;T&gt;). IObjectSet&lt;T&gt; works well as a repository interface, but the API it exposes might not perfectly align with our application’s needs. In this upcoming approach we will represent repositories using a custom IRepository&lt;T&gt; abstraction.
+
+Many developers who follow test-driven design, behavior-driven design, and domain driven methodologies design prefer the IRepository&lt;T&gt; approach for several reasons. First, the IRepository&lt;T&gt; interface represents an “anti-corruption” layer. As described by Eric Evans in his Domain Driven Design book an anti-corruption layer keeps your domain code away from infrastructure APIs, like a persistence API. Secondly, developers can build methods into the repository that meet the exact needs of an application (as discovered while writing tests). For example, we might frequently need to locate a single entity using an ID value, so we can add a FindById method to the repository interface.  Our IRepository&lt;T&gt; definition will look like the following.
+
+``` csharp
+    public interface IRepository<T>
+                    where T : class, IEntity {
+        IQueryable<T> FindAll();
+        IQueryable<T> FindWhere(Expression<Func\<T, bool>> predicate);
+        T FindById(int id);       
+        void Add(T newEntity);
+        void Remove(T entity);
+    }
+```
+
+Notice we’ll drop back to using an IQueryable&lt;T&gt; interface to expose entity collections. IQueryable&lt;T&gt; allows LINQ expression trees to flow into the EF4 provider and give the provider a holistic view of the query. A second option would be to return IEnumerable&lt;T&gt;, which means the EF4 LINQ provider will only see the expressions built inside of the repository. Any grouping, ordering, and projection done outside of the repository will not be composed into the SQL command sent to the database, which can hurt performance. On the other hand, a repository returning only IEnumerable&lt;T&gt; results will never surprise you with a new SQL command. Both approaches will work, and both approaches remain testable.
+
+It’s straightforward to provide a single implementation of the IRepository&lt;T&gt; interface using generics and the EF4 ObjectContext API.
+
+``` csharp
+    public class SqlRepository<T> : IRepository<T>
+                                    where T : class, IEntity {
+        public SqlRepository(ObjectContext context) {
+            _objectSet = context.CreateObjectSet<T>();
+        }
+        public IQueryable<T> FindAll() {
+            return _objectSet;
+        }
+        public IQueryable<T> FindWhere(
+                               Expression<Func\<T, bool>> predicate) {
+            return _objectSet.Where(predicate);
+        }
+        public T FindById(int id) {
+            return _objectSet.Single(o => o.Id == id);
+        }
+        public void Add(T newEntity) {
+            _objectSet.AddObject(newEntity);
+        }
+        public void Remove(T entity) {
+            _objectSet.DeleteObject(entity);
+        }
+        protected ObjectSet<T> _objectSet;
+    }
+```
+
+The IRepository&lt;T&gt; approach gives us some additional control over our queries because a client has to invoke a method to get to an entity. Inside the method we could provide additional checks and LINQ operators to enforce application constraints. Notice the interface has two constraints on the generic type parameter. The first constraint is the class cons taint required by ObjectSet&lt;T&gt;, and the second constraint forces our entities to implement IEntity – an abstraction created for the application. The IEntity interface forces entities to have a readable Id property, and we can then use this property in the FindById method. IEntity is defined with the following code.
+
+``` csharp
+    public interface IEntity {
+        int Id { get; }
+    }
+```
+
+IEntity could be considered a small violation of persistence ignorance since our entities are required to implement this interface. Remember persistence ignorance is about tradeoffs, and for many the FindById functionality will outweigh the constraint imposed by the interface. The interface has no impact on testability.
+
+Instantiating a live IRepository&lt;T&gt; requires an EF4 ObjectContext, so a concrete unit of work implementation should manage the instantiation.
+
+``` csharp
+    public class SqlUnitOfWork : IUnitOfWork {
+        public SqlUnitOfWork() {
+            var connectionString =
+                ConfigurationManager
+                    .ConnectionStrings[ConnectionStringName]
+                    .ConnectionString;
+
+            _context = new ObjectContext(connectionString);
+            _context.ContextOptions.LazyLoadingEnabled = true;
+        }
+
+        public IRepository<Employee> Employees {
+            get {
+                if (_employees == null) {
+                    _employees = new SqlRepository<Employee>(_context);
+                }
+                return _employees;
+            }
+        }
+
+        public IRepository<TimeCard> TimeCards {
+            get {
+                if (_timeCards == null) {
+                    _timeCards = new SqlRepository<TimeCard>(_context);
+                }
+                return _timeCards;
+            }
+        }
+
+        public void Commit() {
+            _context.SaveChanges();
+        }
+
+        SqlRepository<Employee> _employees = null;
+        SqlRepository<TimeCard> _timeCards = null;
+        readonly ObjectContext _context;
+        const string ConnectionStringName = "EmployeeDataModelContainer";
+    }
+```
+
+### Using the Custom Repository
+
+Using our custom repository is not significantly different from using the repository based on IObjectSet&lt;T&gt;. Instead of applying LINQ operators directly to a property, we’ll first need to invoke one the repository’s methods to grab an IQueryable&lt;T&gt; reference.
+
+``` csharp
+    public ViewResult Index() {
+        var model = _repository.FindAll()
+                               .Include("TimeCards")
+                               .OrderBy(e => e.HireDate);
+        return View(model);
+    }
+```
+
+Notice the custom Include operator we implemented previously will work without change. The repository’s FindById method removes duplicated logic from actions trying to retrieve a single entity.
+
+``` csharp
+    public ViewResult Details(int id) {
+        var model = _repository.FindById(id);
+        return View(model);
+    }
+```
+
+There is no significant difference in the testability of the two approaches we’ve examined. We could provide fake implementations of IRepository&lt;T&gt; by building concrete classes backed by HashSet&lt;Employee&gt; - just like what we did in the last section. However, some developers prefer to use mock objects and mock object frameworks instead of building fakes. We’ll look at using mocks to test our implementation and discuss the differences between mocks and fakes in the next section.
+
+### Testing with Mocks
+
+There are different approaches to building what Martin Fowler calls a “test double”. A test double (like a movie stunt double) is an object you build to “stand in” for real, production objects during tests. The in-memory repositories we created are test doubles for the repositories that talk to SQL Server. We’ve seen how to use these test-doubles during the unit tests to isolate code and keep tests running fast.
+
+The test doubles we’ve built have real, working implementations. Behind the scenes each one stores a concrete collection of objects, and they will add and remove objects from this collection as we manipulate the repository during a test. Some developers like to build their test doubles this way – with real code and working implementations.  These test doubles are what we call *fakes*. They have working implementations, but they aren’t real enough for production use. The fake repository doesn’t actually write to the database. The fake SMTP server doesn’t actually send an email message over the network.
+
+### Mocks versus Fakes
+
+There is another type of test double known as a *mock*. While fakes have working implementations, mocks come with no implementation. With the help of a mock object framework we construct these mock objects at run time and use them as test doubles. In this section we’ll be using the open source mocking framework Moq. Here is a simple example of using Moq to dynamically create a test double for an employee repository.
+
+``` csharp
+    Mock<IRepository<Employee>> mock =
+        new Mock<IRepository<Employee>>();
+    IRepository<Employee> repository = mock.Object;
+    repository.Add(new Employee());
+    var employee = repository.FindById(1);
+```
+
+We ask Moq for an IRepository&lt;Employee&gt; implementation and it builds one dynamically. We can get to the object implementing IRepository&lt;Employee&gt; by accessing the Object property of the Mock&lt;T&gt; object. It is this inner object we can pass into our controllers, and they won’t know if this is a test double or the real repository. We can invoke methods on the object just like we would invoke methods on an object with a real implementation.
+
+You must be wondering what the mock repository will do when we invoke the Add method. Since there is no implementation behind the mock object, Add does nothing. There is no concrete collection behind the scenes like we had with the fakes we wrote, so the employee is discarded. What about the return value of FindById? In this case the mock object does the only thing it can do, which is return a default value. Since we are returning a reference type (an Employee), the return value is a null value.
+
+Mocks might sound worthless; however, there are two more features of mocks we haven’t talked about. First, the Moq framework records all the calls made on the mock object. Later in the code we can ask Moq if anyone invoked the Add method, or if anyone invoked the FindById method. We’ll see later how we can use this “black box” recording feature in tests.
+
+The second great feature is how we can use Moq to program a mock object with *expectations*. An expectation tells the mock object how to respond to any given interaction. For example, we can program an expectation into our mock and tell it to return an employee object when someone invokes FindById. The Moq framework uses a Setup API and lambda expressions to program these expectations.
+
+``` csharp
+    [TestMethod]
+    public void MockSample() {
+        Mock<IRepository<Employee>> mock =
+            new Mock<IRepository<Employee>>();
+        mock.Setup(m => m.FindById(5))
+            .Returns(new Employee {Id = 5});
+        IRepository<Employee> repository = mock.Object;
+        var employee = repository.FindById(5);
+        Assert.IsTrue(employee.Id == 5);
+    }
+```
+
+In this sample we ask Moq to dynamically build a repository, and then we program the repository with an expectation. The expectation tells the mock object to return a new employee object with an Id value of 5 when someone invokes the FindById method passing a value of 5. This test passes, and we didn’t need to build a full implementation to fake IRepository&lt;T&gt;.
+
+Let’s revisit the tests we wrote earlier and rework them to use mocks instead of fakes. Just like before, we’ll use a base class to setup the common pieces of infrastructure we need for all of the controller’s tests.
+
+``` csharp
+    public class EmployeeControllerTestBase {
+        public EmployeeControllerTestBase() {
+            _employeeData = EmployeeObjectMother.CreateEmployees()
+                                                .AsQueryable();
+            _repository = new Mock<IRepository<Employee>>();
+            _unitOfWork = new Mock<IUnitOfWork>();
+            _unitOfWork.Setup(u => u.Employees)
+                       .Returns(_repository.Object);
+            _controller = new EmployeeController(_unitOfWork.Object);
+        }
+
+        protected IQueryable<Employee> _employeeData;
+        protected Mock<IUnitOfWork> _unitOfWork;
+        protected EmployeeController _controller;
+        protected Mock<IRepository<Employee>> _repository;
+    }
+```
+
+The setup code remains mostly the same. Instead of using fakes, we’ll use Moq to construct mock objects. The base class arranges for the mock unit of work to return a mock repository when code invokes the Employees property. The rest of the mock setup will take place inside the test fixtures dedicated to each specific scenario. For example, the test fixture for the Index action will setup the mock repository to return a list of employees when the action invokes the FindAll method of the mock repository.
+
+``` csharp
+    [TestClass]
+    public class EmployeeControllerIndexActionTests
+               : EmployeeControllerTestBase {
+        public EmployeeControllerIndexActionTests() {
+            _repository.Setup(r => r.FindAll())
+                        .Returns(_employeeData);
+        }
+        // .. tests
+        [TestMethod]
+        public void ShouldBuildModelWithAllEmployees() {
+            var result = _controller.Index();
+            var model = result.ViewData.Model
+                          as IEnumerable<Employee>;
+            Assert.IsTrue(model.Count() == _employeeData.Count());
+        }
+        // .. and more tests
+    }
+```
+
+Except for the expectations, our tests look similar to the tests we had before. However, with the recording ability of a mock framework we can approach testing from a different angle. We’ll look at this new perspective in the next section.
+
+### State versus Interaction Testing
+
+There are different techniques you can use to test software with mock objects. One approach is to use state based testing, which is what we have done in this paper so far. State based testing makes assertions about the state of the software. In the last test we invoked an action method on the controller and made an assertion about the model it should build. Here are some other examples of testing state:
+
+-   Verify the repository contains the new employee object after Create executes.
+-   Verify the model holds a list of all employees after Index executes.
+-   Verify the repository does not contain a given employee after Delete executes.
+
+Another approach you’ll see with mock objects is to verify *interactions*. While state based testing makes assertions about the state of objects, interaction based testing makes assertions about how objects interact. For example:
+
+-   Verify the controller invokes the repository’s Add method when Create executes.
+-   Verify the controller invokes the repository’s FindAll method when Index executes.
+-   Verify the controller invokes the unit of work’s Commit method to save changes when Edit executes.
+
+Interaction testing often requires less test data, because we aren’t poking inside of collections and verifying counts. For example, if we know the Details action invokes a repository’s FindById method with the correct value - then the action is probably behaving correctly. We can verify this behavior without setting up any test data to return from FindById.
+
+``` csharp
+    [TestClass]
+    public class EmployeeControllerDetailsActionTests
+               : EmployeeControllerTestBase {
+         // ...
+        [TestMethod]
+        public void ShouldInvokeRepositoryToFindEmployee() {
+            var result = _controller.Details(_detailsId);
+            _repository.Verify(r => r.FindById(_detailsId));
+        }
+        int _detailsId = 1;
+    }
+```
+
+The only setup required in the above test fixture is the setup provided by the base class. When we invoke the controller action, Moq will record the interactions with the mock repository. Using the Verify API of Moq, we can ask Moq if the controller invoked FindById with the proper ID value. If the controller did not invoke the method, or invoked the method with an unexpected parameter value, the Verify method will throw an exception and the test will fail.
+
+Here is another example to verify the Create action invokes Commit on the current unit of work.
+
+``` csharp
+    [TestMethod]
+    public void ShouldCommitUnitOfWork() {
+        _controller.Create(_newEmployee);
+        _unitOfWork.Verify(u => u.Commit());
+    }
+```
+
+One danger with interaction testing is the tendency to over specify interactions. The ability of the mock object to record and verify every interaction with the mock object doesn’t mean the test should try to verify every interaction. Some interactions are implementation details and you should only verify the interactions *required* to satisfy the current test.
+
+The choice between mocks or fakes largely depends on the system you are testing and your personal (or team) preferences. Mock objects can drastically reduce the amount of code you need to implement test doubles, but not everyone is comfortable programming expectations and verifying interactions.
+
+## Conclusions
+
+In this paper we’ve demonstrated several approaches to creating testable code while using the ADO.NET Entity Framework for data persistence. We can leverage built in abstractions like IObjectSet&lt;T&gt;, or create our own abstractions like IRepository&lt;T&gt;.  In both cases, the POCO support in the ADO.NET Entity Framework 4.0 allows the consumers of these abstractions to remain persistent ignorant and highly testable. Additional EF4 features like implicit lazy loading allows business and application service code to work without worrying about the details of a relational data store. Finally, the abstractions we create are easy to mock or fake inside of unit tests, and we can use these test doubles to achieve fast running, highly isolated, and reliable tests.
+
+### Additional Resources
+
+-   Martin Fowler, [Catalog of Patterns](https://www.martinfowler.com/eaaCatalog/index.html) from *Patterns of Enterprise Application Architecture*
+-   Griffin Caprio, “ [Dependency Injection](https://msdn.microsoft.com/magazine/cc163739.aspx)”
+-   Data Programmability Blog, “ [Walkthrough: Test Driven Development with the Entity Framework 4.0](/archive/blogs/adonet/walkthrough-test-driven-development-with-the-entity-framework-4-0)”.
+-   Data Programmability Blog, “ [Using Repository and Unit of Work patterns with Entity Framework 4.0](/archive/blogs/adonet/using-repository-and-unit-of-work-patterns-with-entity-framework-4-0)”
+-   Aaron Jensen, “ [Introducing Machine Specifications](https://web.archive.org/web/20210516223054/http://codebetter.com/aaronjensen/2008/05/08/introducing-machine-specifications-or-mspec-for-short/)”
+-   Eric Lee, “ [BDD with MSTest](https://saintgimp.org/2009/01/20/bdd-with-mstest/)”
+-   Eric Evans, “ [Domain Driven Design](https://books.google.com/books?id=7dlaMs0SECsC&printsec=frontcover&dq=evans%20domain%20driven%20design&hl=en&ei=cHztS6C8KIaglAfA_dS1CA&sa=X&oi=book_result&ct=result&resnum=1&ved=0CCoQ6AEwAA)”
+-   Martin Fowler, “ [Mocks Aren’t Stubs](https://martinfowler.com/articles/mocksArentStubs.html)”
+-   Martin Fowler, “ [Test Double](https://martinfowler.com/bliki/TestDouble.html)”
+-   [Moq](https://code.google.com/p/moq/)
+
+### Biography
+
+Scott Allen is a member of the technical staff at Pluralsight and the founder of OdeToCode.com. In 15 years of commercial software development, Scott has worked on solutions for everything from 8-bit embedded devices to highly scalable ASP.NET web applications. You can reach Scott on his blog at OdeToCode, or on Twitter at [https://twitter.com/OdeToCode](https://twitter.com/OdeToCode).
diff --git a/entity-framework/ef6/fundamentals/testing/writing-test-doubles.md b/entity-framework/ef6/fundamentals/testing/writing-test-doubles.md
new file mode 100644
index 0000000000..88887d302a
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/testing/writing-test-doubles.md
@@ -0,0 +1,483 @@
+---
+title: Testing with your own test doubles - EF6
+description: Testing with your own test doubles in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/fundamentals/testing/writing-test-doubles
+---
+# Testing with your own test doubles
+> [!NOTE]
+> **EF6 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 6. If you are using an earlier version, some or all of the information does not apply.  
+
+When writing tests for your application it is often desirable to avoid hitting the database.  Entity Framework allows you to achieve this by creating a context – with behavior defined by your tests – that makes use of in-memory data.  
+
+## Options for creating test doubles  
+
+There are two different approaches that can be used to create an in-memory version of your context.  
+
+- **Create your own test doubles** – This approach involves writing your own in-memory implementation of your context and DbSets. This gives you a lot of control over how the classes behave but can involve writing and owning a reasonable amount of code.  
+- **Use a mocking framework to create test doubles** – Using a mocking framework (such as Moq) you can have the in-memory implementations of you context and sets created dynamically at runtime for you.  
+
+This article will deal with creating your own test double. For information on using a mocking framework see [Testing with a Mocking Framework](xref:ef6/fundamentals/testing/mocking).  
+
+## Testing with pre-EF6 versions  
+
+The code shown in this article is compatible with EF6. For testing with EF5 and earlier version see [Testing with a Fake Context](https://romiller.com/2012/02/14/testing-with-a-fake-dbcontext/).  
+
+## Limitations of EF in-memory test doubles  
+
+In-memory test doubles can be a good way to provide unit test level coverage of bits of your application that use EF. However, when doing this you are using LINQ to Objects to execute queries against in-memory data. This can result in different behavior than using EF’s LINQ provider (LINQ to Entities) to translate queries into SQL that is run against your database.  
+
+One example of such a difference is loading related data. If you create a series of Blogs that each have related Posts, then when using in-memory data the related Posts will always be loaded for each Blog. However, when running against a database the data will only be loaded if you use the Include method.  
+
+For this reason, it is recommended to always include some level of end-to-end testing (in addition to your unit tests) to ensure your application works correctly against a database.  
+
+## Following along with this article  
+
+This article gives complete code listings that you can copy into Visual Studio to follow along if you wish. It's easiest to create a **Unit Test Project** and you will need to target **.NET Framework 4.5** to complete the sections that use async.  
+
+## Creating a context interface  
+
+We're going to look at testing a service that makes use of an EF model. In order to be able to replace our EF context with an in-memory version for testing, we'll define an interface that our EF context (and it's in-memory double) will implement.
+
+The service we are going to test will query and modify data using the DbSet properties of our context and also call SaveChanges to push changes to the database. So we're including these members on the interface.  
+
+``` csharp
+using System.Data.Entity;
+
+namespace TestingDemo
+{
+    public interface IBloggingContext
+    {
+        DbSet<Blog> Blogs { get; }
+        DbSet<Post> Posts { get; }
+        int SaveChanges();
+    }
+}
+```  
+
+## The EF model  
+
+The service we're going to test makes use of an EF model made up of the BloggingContext and the Blog and Post classes. This code may have been generated by the EF Designer or be a Code First model.  
+
+``` csharp
+using System.Collections.Generic;
+using System.Data.Entity;
+
+namespace TestingDemo
+{
+    public class BloggingContext : DbContext, IBloggingContext
+    {
+        public DbSet<Blog> Blogs { get; set; }
+        public DbSet<Post> Posts { get; set; }
+    }
+
+    public class Blog
+    {
+        public int BlogId { get; set; }
+        public string Name { get; set; }
+        public string Url { get; set; }
+
+        public virtual List<Post> Posts { get; set; }
+    }
+
+    public class Post
+    {
+        public int PostId { get; set; }
+        public string Title { get; set; }
+        public string Content { get; set; }
+
+        public int BlogId { get; set; }
+        public virtual Blog Blog { get; set; }
+    }
+}
+```  
+
+### Implementing the context interface with the EF Designer  
+
+Note that our context implements the IBloggingContext interface.  
+
+If you are using Code First then you can edit your context directly to implement the interface. If you are using the EF Designer then you’ll need to edit the T4 template that generates your context. Open up the \<model_name\>.Context.tt file that is nested under you edmx file, find the following fragment of code and add in the interface as shown.  
+
+``` csharp  
+<#=Accessibility.ForType(container)#> partial class <#=code.Escape(container)#> : DbContext, IBloggingContext
+```  
+
+## Service to be tested  
+
+To demonstrate testing with in-memory test doubles we are going to be writing a couple of tests for a BlogService. The service is capable of creating new blogs (AddBlog) and returning all Blogs ordered by name (GetAllBlogs). In addition to GetAllBlogs, we’ve also provided a method that will asynchronously get all blogs ordered by name (GetAllBlogsAsync).  
+
+``` csharp
+using System.Collections.Generic;
+using System.Data.Entity;
+using System.Linq;
+using System.Threading.Tasks;
+
+namespace TestingDemo
+{
+    public class BlogService
+    {
+        private IBloggingContext _context;
+
+        public BlogService(IBloggingContext context)
+        {
+            _context = context;
+        }
+
+        public Blog AddBlog(string name, string url)
+        {
+            var blog = new Blog { Name = name, Url = url };
+            _context.Blogs.Add(blog);
+            _context.SaveChanges();
+
+            return blog;
+        }
+
+        public List<Blog> GetAllBlogs()
+        {
+            var query = from b in _context.Blogs
+                        orderby b.Name
+                        select b;
+
+            return query.ToList();
+        }
+
+        public async Task<List<Blog>> GetAllBlogsAsync()
+        {
+            var query = from b in _context.Blogs
+                        orderby b.Name
+                        select b;
+
+            return await query.ToListAsync();
+        }
+    }
+}
+```
+
+## Creating the in-memory test doubles  
+
+Now that we have the real EF model and the service that can use it, it's time to create the in-memory test double that we can use for testing. We've created a TestContext test double for our context. In test doubles we get to choose the behavior we want in order to support the tests we are going to run. In this example we're just capturing the number of times SaveChanges is called, but you can include whatever logic is needed to verify the scenario you are testing.  
+
+We've also created a TestDbSet that provides an in-memory implementation of DbSet. We've provided a complete implementation for all the methods on DbSet (except for Find), but you only need to implement the members that your test scenario will use.  
+
+TestDbSet makes use of some other infrastructure classes that we've included to ensure that async queries can be processed.  
+
+``` csharp
+using System;
+using System.Collections.Generic;
+using System.Collections.ObjectModel;
+using System.Data.Entity;
+using System.Data.Entity.Infrastructure;
+using System.Linq;
+using System.Linq.Expressions;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace TestingDemo
+{
+    public class TestContext : IBloggingContext
+    {
+        public TestContext()
+        {
+            this.Blogs = new TestDbSet<Blog>();
+            this.Posts = new TestDbSet<Post>();
+        }
+
+        public DbSet<Blog> Blogs { get; set; }
+        public DbSet<Post> Posts { get; set; }
+        public int SaveChangesCount { get; private set; }
+        public int SaveChanges()
+        {
+            this.SaveChangesCount++;
+            return 1;
+        }
+    }
+
+    public class TestDbSet<TEntity> : DbSet<TEntity>, IQueryable, IEnumerable<TEntity>, IDbAsyncEnumerable<TEntity>
+        where TEntity : class
+    {
+        ObservableCollection<TEntity> _data;
+        IQueryable _query;
+
+        public TestDbSet()
+        {
+            _data = new ObservableCollection<TEntity>();
+            _query = _data.AsQueryable();
+        }
+
+        public override TEntity Add(TEntity item)
+        {
+            _data.Add(item);
+            return item;
+        }
+
+        public override TEntity Remove(TEntity item)
+        {
+            _data.Remove(item);
+            return item;
+        }
+
+        public override TEntity Attach(TEntity item)
+        {
+            _data.Add(item);
+            return item;
+        }
+
+        public override TEntity Create()
+        {
+            return Activator.CreateInstance<TEntity>();
+        }
+
+        public override TDerivedEntity Create<TDerivedEntity>()
+        {
+            return Activator.CreateInstance<TDerivedEntity>();
+        }
+
+        public override ObservableCollection<TEntity> Local
+        {
+            get { return _data; }
+        }
+
+        Type IQueryable.ElementType
+        {
+            get { return _query.ElementType; }
+        }
+
+        Expression IQueryable.Expression
+        {
+            get { return _query.Expression; }
+        }
+
+        IQueryProvider IQueryable.Provider
+        {
+            get { return new TestDbAsyncQueryProvider<TEntity>(_query.Provider); }
+        }
+
+        System.Collections.IEnumerator System.Collections.IEnumerable.GetEnumerator()
+        {
+            return _data.GetEnumerator();
+        }
+
+        IEnumerator<TEntity> IEnumerable<TEntity>.GetEnumerator()
+        {
+            return _data.GetEnumerator();
+        }
+
+        IDbAsyncEnumerator<TEntity> IDbAsyncEnumerable<TEntity>.GetAsyncEnumerator()
+        {
+            return new TestDbAsyncEnumerator<TEntity>(_data.GetEnumerator());
+        }
+    }
+
+    internal class TestDbAsyncQueryProvider<TEntity> : IDbAsyncQueryProvider
+    {
+        private readonly IQueryProvider _inner;
+
+        internal TestDbAsyncQueryProvider(IQueryProvider inner)
+        {
+            _inner = inner;
+        }
+
+        public IQueryable CreateQuery(Expression expression)
+        {
+            return new TestDbAsyncEnumerable<TEntity>(expression);
+        }
+
+        public IQueryable<TElement> CreateQuery<TElement>(Expression expression)
+        {
+            return new TestDbAsyncEnumerable<TElement>(expression);
+        }
+
+        public object Execute(Expression expression)
+        {
+            return _inner.Execute(expression);
+        }
+
+        public TResult Execute<TResult>(Expression expression)
+        {
+            return _inner.Execute<TResult>(expression);
+        }
+
+        public Task<object> ExecuteAsync(Expression expression, CancellationToken cancellationToken)
+        {
+            return Task.FromResult(Execute(expression));
+        }
+
+        public Task<TResult> ExecuteAsync<TResult>(Expression expression, CancellationToken cancellationToken)
+        {
+            return Task.FromResult(Execute<TResult>(expression));
+        }
+    }
+
+    internal class TestDbAsyncEnumerable<T> : EnumerableQuery<T>, IDbAsyncEnumerable<T>, IQueryable<T>
+    {
+        public TestDbAsyncEnumerable(IEnumerable<T> enumerable)
+            : base(enumerable)
+        { }
+
+        public TestDbAsyncEnumerable(Expression expression)
+            : base(expression)
+        { }
+
+        public IDbAsyncEnumerator<T> GetAsyncEnumerator()
+        {
+            return new TestDbAsyncEnumerator<T>(this.AsEnumerable().GetEnumerator());
+        }
+
+        IDbAsyncEnumerator IDbAsyncEnumerable.GetAsyncEnumerator()
+        {
+            return GetAsyncEnumerator();
+        }
+
+        IQueryProvider IQueryable.Provider
+        {
+            get { return new TestDbAsyncQueryProvider<T>(this); }
+        }
+    }
+
+    internal class TestDbAsyncEnumerator<T> : IDbAsyncEnumerator<T>
+    {
+        private readonly IEnumerator<T> _inner;
+
+        public TestDbAsyncEnumerator(IEnumerator<T> inner)
+        {
+            _inner = inner;
+        }
+
+        public void Dispose()
+        {
+            _inner.Dispose();
+        }
+
+        public Task<bool> MoveNextAsync(CancellationToken cancellationToken)
+        {
+            return Task.FromResult(_inner.MoveNext());
+        }
+
+        public T Current
+        {
+            get { return _inner.Current; }
+        }
+
+        object IDbAsyncEnumerator.Current
+        {
+            get { return Current; }
+        }
+    }
+}
+```  
+
+### Implementing Find  
+
+The Find method is difficult to implement in a generic fashion. If you need to test code that makes use of the Find method it is easiest to create a test DbSet for each of the entity types that need to support find. You can then write logic to find that particular type of entity, as shown below.  
+
+``` csharp
+using System.Linq;
+
+namespace TestingDemo
+{
+    class TestBlogDbSet : TestDbSet<Blog>
+    {
+        public override Blog Find(params object[] keyValues)
+        {
+            var id = (int)keyValues.Single();
+            return this.SingleOrDefault(b => b.BlogId == id);
+        }
+    }
+}
+```  
+
+## Writing some tests  
+
+That’s all we need to do to start testing. The following test creates a TestContext and then a service based on this context. The service is then used to create a new blog – using the AddBlog method. Finally, the test verifies that the service added a new Blog to the context's Blogs property and called SaveChanges on the context.  
+
+This is just an example of the types of things you can test with an in-memory test double and you can adjust the logic of the test doubles and the verification to meet your requirements.  
+
+``` csharp
+using Microsoft.VisualStudio.TestTools.UnitTesting;
+using System.Linq;
+
+namespace TestingDemo
+{
+    [TestClass]
+    public class NonQueryTests
+    {
+        [TestMethod]
+        public void CreateBlog_saves_a_blog_via_context()
+        {
+            var context = new TestContext();
+
+            var service = new BlogService(context);
+            service.AddBlog("ADO.NET Blog", "http://blogs.msdn.com/adonet");
+
+            Assert.AreEqual(1, context.Blogs.Count());
+            Assert.AreEqual("ADO.NET Blog", context.Blogs.Single().Name);
+            Assert.AreEqual("http://blogs.msdn.com/adonet", context.Blogs.Single().Url);
+            Assert.AreEqual(1, context.SaveChangesCount);
+        }
+    }
+}
+```  
+
+Here is another example of a test - this time one that performs a query. The test starts by creating a test context with some data in its Blog property - note that the data is not in alphabetical order. We can then create a BlogService based on our test context and ensure that the data we get back from GetAllBlogs is ordered by name.  
+
+``` csharp
+using Microsoft.VisualStudio.TestTools.UnitTesting;
+
+namespace TestingDemo
+{
+    [TestClass]
+    public class QueryTests
+    {
+        [TestMethod]
+        public void GetAllBlogs_orders_by_name()
+        {
+            var context = new TestContext();
+            context.Blogs.Add(new Blog { Name = "BBB" });
+            context.Blogs.Add(new Blog { Name = "ZZZ" });
+            context.Blogs.Add(new Blog { Name = "AAA" });
+
+            var service = new BlogService(context);
+            var blogs = service.GetAllBlogs();
+
+            Assert.AreEqual(3, blogs.Count);
+            Assert.AreEqual("AAA", blogs[0].Name);
+            Assert.AreEqual("BBB", blogs[1].Name);
+            Assert.AreEqual("ZZZ", blogs[2].Name);
+        }
+    }
+}
+```  
+
+Finally, we'll write one more test that uses our async method to ensure that the async infrastructure we included in [TestDbSet](#creating-the-in-memory-test-doubles) is working.  
+
+``` csharp
+using Microsoft.VisualStudio.TestTools.UnitTesting;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+
+namespace TestingDemo
+{
+    [TestClass]
+    public class AsyncQueryTests
+    {
+        [TestMethod]
+        public async Task GetAllBlogsAsync_orders_by_name()
+        {
+            var context = new TestContext();
+            context.Blogs.Add(new Blog { Name = "BBB" });
+            context.Blogs.Add(new Blog { Name = "ZZZ" });
+            context.Blogs.Add(new Blog { Name = "AAA" });
+
+            var service = new BlogService(context);
+            var blogs = await service.GetAllBlogsAsync();
+
+            Assert.AreEqual(3, blogs.Count);
+            Assert.AreEqual("AAA", blogs[0].Name);
+            Assert.AreEqual("BBB", blogs[1].Name);
+            Assert.AreEqual("ZZZ", blogs[2].Name);
+        }
+    }
+}
+```  
diff --git a/entity-framework/ef6/fundamentals/working-with-dbcontext.md b/entity-framework/ef6/fundamentals/working-with-dbcontext.md
new file mode 100644
index 0000000000..bd5e8195ff
--- /dev/null
+++ b/entity-framework/ef6/fundamentals/working-with-dbcontext.md
@@ -0,0 +1,70 @@
+---
+title: Working with DbContext - EF6
+description: Working with DbContext in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/fundamentals/working-with-dbcontext
+---
+# Working with DbContext
+
+In order to use Entity Framework to query, insert, update, and delete data using .NET objects, you first need to [Create a Model](xref:ef6/modeling/index) which maps the entities and relationships that are defined in your model to tables in a database.
+
+Once you have a model, the primary class your application interacts with is `System.Data.Entity.DbContext` (often referred to as the context class). You can use a DbContext associated to a model to:
+- Write and execute queries   
+- Materialize query results as entity objects
+- Track changes that are made to those objects
+- Persist object changes back on the database
+- Bind objects in memory to UI controls
+
+This page gives some guidance on how to manage the context class.  
+
+## Defining a DbContext derived class  
+
+The recommended way to work with context is to define a class that derives from DbContext and exposes DbSet properties that represent collections of the specified entities in the context. If you are working with the EF Designer, the context will be generated for you. If you are working with Code First, you will typically write the context yourself.  
+
+``` csharp
+public class ProductContext : DbContext
+{
+    public DbSet<Category> Categories { get; set; }
+    public DbSet<Product> Products { get; set; }
+}
+```  
+
+Once you have a context, you would query for, add (using `Add` or `Attach` methods ) or remove (using `Remove`) entities in the context through these properties. Accessing a `DbSet` property on a context object represent a starting query that returns all entities of the specified type. Note that just accessing a property will not execute the query. A query is executed when:  
+
+- It is enumerated by a `foreach` (C#) or `For Each` (Visual Basic) statement.  
+- It is enumerated by a collection operation such as `ToArray`, `ToDictionary`, or `ToList`.  
+- LINQ operators such as `First` or `Any` are specified in the outermost part of the query.  
+- One of the following methods are called: the `Load` extension method, `DbEntityEntry.Reload`,  `Database.ExecuteSqlCommand`, and `DbSet<T>.Find`, if an entity with the specified key is not found already loaded in the context.  
+
+## Lifetime  
+
+The lifetime of the context begins when the instance is created and ends when the instance is either disposed or garbage-collected. Use **using** if you want all the resources that the context controls to be disposed at the end of the block. When you use **using**, the compiler automatically creates a try/finally block and calls dispose in the **finally** block.  
+
+``` csharp
+public void UseProducts()
+{
+    using (var context = new ProductContext())
+    {     
+        // Perform data access using the context
+    }
+}
+```  
+
+Here are some general guidelines when deciding on the lifetime of the context:  
+
+- When working with Web applications, use a context instance per request.  
+- When working with Windows Presentation Foundation (WPF) or Windows Forms, use a context instance per form. This lets you use change-tracking functionality that context provides.  
+- If the context instance is created by a dependency injection container, it is usually the responsibility of the container to dispose the context.
+- If the context is created in application code, remember to dispose of the context when it is no longer required.  
+- When working with long-running context consider the following:  
+    - As you load more objects and their references into memory, the memory consumption of the context may increase rapidly. This may cause performance issues.  
+    - The context is not thread-safe, therefore it should not be shared across multiple threads doing work on it concurrently.
+    - If an exception causes the context to be in an unrecoverable state, the whole application may terminate.  
+    - The chances of running into concurrency-related issues increase as the gap between the time when the data is queried and updated grows.  
+
+## Connections  
+
+By default, the context manages connections to the database. The context opens and closes connections as needed. For example, the context opens a connection to execute a query, and then closes the connection when all the result sets have been processed.  
+
+There are cases when you want to have more control over when the connection opens and closes. For example, when working with SQL Server Compact, it is often recommended to maintain a separate open connection to the database for the lifetime of the application to improve performance. You can manage this process manually by using the `Connection` property.  
diff --git a/entity-framework/ef6/get-started.md b/entity-framework/ef6/get-started.md
new file mode 100644
index 0000000000..c73f79335c
--- /dev/null
+++ b/entity-framework/ef6/get-started.md
@@ -0,0 +1,67 @@
+---
+title: Get started with Entity Framework 6 - EF6
+description: Get started with Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/get-started
+---
+# Get started with Entity Framework 6
+
+This guide contains a collection of links to selected documentation articles, walkthroughs and videos that can help you get started quickly.
+
+## Fundamentals
+
+* [Get Entity Framework](xref:ef6/fundamentals/install)
+
+  Here you will learn how to add Entity Framework to your applications and, if you want to use the EF Designer, make sure you get it installed in Visual Studio.
+
+* [Creating a Model: Code First, the EF Designer, and the EF Workflows](xref:ef6/modeling/index)
+
+  Do you prefer to specify your EF model writing code or drawing boxes and lines?
+Are you going to use EF to map your objects to an existing database or would you like EF to create a database tailored for your objects?
+Here you learn about two different approaches to use EF6: EF Designer and Code First.
+Make sure you follow the discussion and watch the video about the difference.
+
+* [Working with DbContext](xref:ef6/fundamentals/working-with-dbcontext)
+
+  DbContext is the first and most important EF type that you need to learn how to use. It serves as the launchpad for database queries and keeps track of changes you make to objects so that they can be persisted back to the database.
+
+* [Ask a Question](xref:ef6/resources/get-help)
+
+  Find out how to get help from the experts and contribute your own answers to the community.
+
+* [Contribute](https://github.com/aspnet/EntityFramework6/)
+
+  Entity Framework 6 uses an open development model. Find out how you can help make EF even better by visiting our GitHub repository.
+
+## Code First resources
+
+  - [Code First to an Existing Database Workflow](xref:ef6/modeling/code-first/workflows/existing-database)
+  - [Code First to a New Database Workflow](xref:ef6/modeling/code-first/workflows/new-database)
+  - [Mapping Enums Using Code First](xref:ef6/modeling/code-first/data-types/enums)
+  - [Mapping Spatial Types Using Code First](xref:ef6/modeling/code-first/data-types/spatial)
+  - [Writing Custom Code First Conventions](xref:ef6/modeling/code-first/conventions/custom)
+  - [Using Code First Fluent Configuration with Visual Basic](xref:ef6/modeling/code-first/fluent/vb)
+  - [Code First Migrations](xref:ef6/modeling/code-first/migrations/index)
+  - [Code First Migrations in Team Environments](xref:ef6/modeling/code-first/migrations/teams)
+  - [Automatic Code First Migrations](xref:ef6/modeling/code-first/migrations/automatic) (This is no longer recommended)
+
+## EF Designer resources
+  - [Database First Workflow](xref:ef6/modeling/designer/workflows/database-first)
+  - [Model First Workflow](xref:ef6/modeling/designer/workflows/model-first)
+  - [Mapping Enums](xref:ef6/modeling/designer/data-types/enums)
+  - [Mapping Spatial Types](xref:ef6/modeling/designer/data-types/spatial)
+  - [Table-Per Hierarchy Inheritance Mapping](xref:ef6/modeling/designer/inheritance/tph)
+  - [Table-Per Type Inheritance Mapping](xref:ef6/modeling/designer/inheritance/tpt)
+  - [Stored Procedure Mapping for Updates](xref:ef6/modeling/designer/stored-procedures/cud)
+  - [Stored Procedure Mapping for Query](xref:ef6/modeling/designer/stored-procedures/query)
+  - [Entity Splitting](xref:ef6/modeling/designer/entity-splitting)
+  - [Table Splitting](xref:ef6/modeling/designer/table-splitting)
+  - [Defining Query](xref:ef6/modeling/designer/advanced/defining-query) (Advanced)
+  - [Table-Valued Functions](xref:ef6/modeling/designer/advanced/tvfs) (Advanced)
+
+## Other resources
+  - [Async Query and Save](xref:ef6/fundamentals/async)
+  - [Databinding with WinForms](xref:ef6/fundamentals/databinding/winforms)
+  - [Databinding with WPF](xref:ef6/fundamentals/databinding/wpf)
+  - [Disconnected scenarios with Self-Tracking Entities](xref:ef6/fundamentals/disconnected-entities/self-tracking-entities/walkthrough) (This is no longer recommended)
diff --git a/entity-framework/ef6/index.md b/entity-framework/ef6/index.md
new file mode 100644
index 0000000000..b9c481b6ae
--- /dev/null
+++ b/entity-framework/ef6/index.md
@@ -0,0 +1,44 @@
+---
+title: Overview of Entity Framework 6 - EF6
+description: Overview of Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/index
+---
+# Entity Framework 6
+Entity Framework 6 (EF6) is a tried and tested object-relational mapper (O/RM) for .NET with many years of feature development and stabilization.
+
+As an O/RM, EF6 reduces the impedance mismatch between the relational and object-oriented worlds, enabling developers to write applications that interact with data stored in relational databases using strongly-typed .NET objects that represent the application's domain, and eliminating the need for a large portion of the data access "plumbing" code that they usually need to write.
+
+EF6 implements many popular O/RM features:
+- Mapping of [POCO](xref:ef6/resources/glossary#poco) entity classes which do not depend on any EF types
+- Automatic change tracking
+- Identity resolution and Unit of Work
+- Eager, lazy and explicit loading
+- Translation of strongly-typed queries using [LINQ (Language INtegrated Query)](https://aka.ms/AA6hsvu)
+- Rich mapping capabilities, including support for:
+  - One-to-one, one-to-many and many-to-many relationships
+  - Inheritance (table per hierarchy, table per type and table per concrete class)
+  - Complex types
+  - Stored procedures
+- A visual designer to create entity models.
+- A "Code First" experience to create entity models by writing code.
+- Models can either be generated from existing databases and then hand-edited, or they can be created from scratch and then used to generate new databases.
+- Integration with .NET Framework application models, including ASP.NET, and through databinding, with WPF and WinForms.
+- Database connectivity based on ADO.NET and numerous [providers](xref:ef6/fundamentals/providers/index) available to connect to SQL Server, Oracle, MySQL, SQLite, PostgreSQL, DB2, etc.
+
+## Should I use EF6 or EF Core?
+
+EF Core is a more modern, lightweight and extensible version of Entity Framework that has very similar capabilities and benefits to EF6.
+EF Core is a complete rewrite and contains many new features not available in EF6, although it also still lacks some of the most advanced mapping capabilities of EF6.
+Consider using EF Core in new applications if the feature set matches your requirements.
+[Compare EF Core & EF6](xref:efcore-and-ef6/index) examines this choice in greater detail.
+
+## [Get Started](xref:ef6/get-started)
+
+Add the EntityFramework NuGet package to your project or install the [Entity Framework Tools for Visual Studio](https://aka.ms/AA6i8c5). Then watch videos, read tutorials, and advanced documentation to help you make the most of EF6.
+
+## Past Entity Framework Versions
+
+This is the documentation for the latest version of Entity Framework 6, although much of it also applies to past releases.
+Check out [What's New](xref:ef6/what-is-new/index) and [Past Releases](xref:ef6/what-is-new/past-releases) for a complete list of EF releases and the features they introduced.
diff --git a/entity-framework/ef6/media/add-code-gen-item.png b/entity-framework/ef6/media/add-code-gen-item.png
new file mode 100644
index 0000000000..7baefed5ea
Binary files /dev/null and b/entity-framework/ef6/media/add-code-gen-item.png differ
diff --git a/entity-framework/ef6/media/addassociation.png b/entity-framework/ef6/media/addassociation.png
new file mode 100644
index 0000000000..dde940ddd0
Binary files /dev/null and b/entity-framework/ef6/media/addassociation.png differ
diff --git a/entity-framework/ef6/media/addassociationmf.png b/entity-framework/ef6/media/addassociationmf.png
new file mode 100644
index 0000000000..5d56e02d1f
Binary files /dev/null and b/entity-framework/ef6/media/addassociationmf.png differ
diff --git a/entity-framework/ef6/media/addblogentity.png b/entity-framework/ef6/media/addblogentity.png
new file mode 100644
index 0000000000..cfd20baefe
Binary files /dev/null and b/entity-framework/ef6/media/addblogentity.png differ
diff --git a/entity-framework/ef6/media/addconnectionexpress.png b/entity-framework/ef6/media/addconnectionexpress.png
new file mode 100644
index 0000000000..feb763d7fc
Binary files /dev/null and b/entity-framework/ef6/media/addconnectionexpress.png differ
diff --git a/entity-framework/ef6/media/addconnectionlocaldb.png b/entity-framework/ef6/media/addconnectionlocaldb.png
new file mode 100644
index 0000000000..f9ddef3e3d
Binary files /dev/null and b/entity-framework/ef6/media/addconnectionlocaldb.png differ
diff --git a/entity-framework/ef6/media/addenumtype.png b/entity-framework/ef6/media/addenumtype.png
new file mode 100644
index 0000000000..e6c324194b
Binary files /dev/null and b/entity-framework/ef6/media/addenumtype.png differ
diff --git a/entity-framework/ef6/media/addlinkedtemplate.png b/entity-framework/ef6/media/addlinkedtemplate.png
new file mode 100644
index 0000000000..64a8fd3224
Binary files /dev/null and b/entity-framework/ef6/media/addlinkedtemplate.png differ
diff --git a/entity-framework/ef6/media/addnewcomplextype.png b/entity-framework/ef6/media/addnewcomplextype.png
new file mode 100644
index 0000000000..ef747c764d
Binary files /dev/null and b/entity-framework/ef6/media/addnewcomplextype.png differ
diff --git a/entity-framework/ef6/media/addpropertiestocomplextype.png b/entity-framework/ef6/media/addpropertiestocomplextype.png
new file mode 100644
index 0000000000..c42fd9377c
Binary files /dev/null and b/entity-framework/ef6/media/addpropertiestocomplextype.png differ
diff --git a/entity-framework/ef6/media/adduserentity.png b/entity-framework/ef6/media/adduserentity.png
new file mode 100644
index 0000000000..cbb2d13a4b
Binary files /dev/null and b/entity-framework/ef6/media/adduserentity.png differ
diff --git a/entity-framework/ef6/media/asyncoutput.png b/entity-framework/ef6/media/asyncoutput.png
new file mode 100644
index 0000000000..b38ad2e0fb
Binary files /dev/null and b/entity-framework/ef6/media/asyncoutput.png differ
diff --git a/entity-framework/ef6/media/changedatasource.png b/entity-framework/ef6/media/changedatasource.png
new file mode 100644
index 0000000000..2279d718c4
Binary files /dev/null and b/entity-framework/ef6/media/changedatasource.png differ
diff --git a/entity-framework/ef6/media/choosemodelcontents.png b/entity-framework/ef6/media/choosemodelcontents.png
new file mode 100644
index 0000000000..32d891e4e5
Binary files /dev/null and b/entity-framework/ef6/media/choosemodelcontents.png differ
diff --git a/entity-framework/ef6/media/chooseyourconnection.png b/entity-framework/ef6/media/chooseyourconnection.png
new file mode 100644
index 0000000000..9def25d583
Binary files /dev/null and b/entity-framework/ef6/media/chooseyourconnection.png differ
diff --git a/entity-framework/ef6/media/chooseyourobjects.png b/entity-framework/ef6/media/chooseyourobjects.png
new file mode 100644
index 0000000000..86c5486144
Binary files /dev/null and b/entity-framework/ef6/media/chooseyourobjects.png differ
diff --git a/entity-framework/ef6/media/codegenfiles.png b/entity-framework/ef6/media/codegenfiles.png
new file mode 100644
index 0000000000..4dca4c6e23
Binary files /dev/null and b/entity-framework/ef6/media/codegenfiles.png differ
diff --git a/entity-framework/ef6/media/codegenstrategy.png b/entity-framework/ef6/media/codegenstrategy.png
new file mode 100644
index 0000000000..dc79b35f8f
Binary files /dev/null and b/entity-framework/ef6/media/codegenstrategy.png differ
diff --git a/entity-framework/ef6/media/codetemplates.png b/entity-framework/ef6/media/codetemplates.png
new file mode 100644
index 0000000000..1d1a493f2c
Binary files /dev/null and b/entity-framework/ef6/media/codetemplates.png differ
diff --git a/entity-framework/ef6/media/color.png b/entity-framework/ef6/media/color.png
new file mode 100644
index 0000000000..7d07d0e9ac
Binary files /dev/null and b/entity-framework/ef6/media/color.png differ
diff --git a/entity-framework/ef6/media/compositekey.png b/entity-framework/ef6/media/compositekey.png
new file mode 100644
index 0000000000..0f61c021fc
Binary files /dev/null and b/entity-framework/ef6/media/compositekey.png differ
diff --git a/entity-framework/ef6/media/connection.png b/entity-framework/ef6/media/connection.png
new file mode 100644
index 0000000000..134d3822a4
Binary files /dev/null and b/entity-framework/ef6/media/connection.png differ
diff --git a/entity-framework/ef6/media/converttoenum.png b/entity-framework/ef6/media/converttoenum.png
new file mode 100644
index 0000000000..eed0a3d509
Binary files /dev/null and b/entity-framework/ef6/media/converttoenum.png differ
diff --git a/entity-framework/ef6/media/createdatabase.png b/entity-framework/ef6/media/createdatabase.png
new file mode 100644
index 0000000000..20b638362b
Binary files /dev/null and b/entity-framework/ef6/media/createdatabase.png differ
diff --git a/entity-framework/ef6/media/createdatabasedialog.png b/entity-framework/ef6/media/createdatabasedialog.png
new file mode 100644
index 0000000000..c847615785
Binary files /dev/null and b/entity-framework/ef6/media/createdatabasedialog.png differ
diff --git a/entity-framework/ef6/media/createemptymodel.png b/entity-framework/ef6/media/createemptymodel.png
new file mode 100644
index 0000000000..1fc35de7e1
Binary files /dev/null and b/entity-framework/ef6/media/createemptymodel.png differ
diff --git a/entity-framework/ef6/media/database.png b/entity-framework/ef6/media/database.png
new file mode 100644
index 0000000000..a624acd133
Binary files /dev/null and b/entity-framework/ef6/media/database.png differ
diff --git a/entity-framework/ef6/media/database2.png b/entity-framework/ef6/media/database2.png
new file mode 100644
index 0000000000..61e9d495a3
Binary files /dev/null and b/entity-framework/ef6/media/database2.png differ
diff --git a/entity-framework/ef6/media/databaselocaldb.png b/entity-framework/ef6/media/databaselocaldb.png
new file mode 100644
index 0000000000..1dd04b11dc
Binary files /dev/null and b/entity-framework/ef6/media/databaselocaldb.png differ
diff --git a/entity-framework/ef6/media/datasource.png b/entity-framework/ef6/media/datasource.png
new file mode 100644
index 0000000000..9b5355df7f
Binary files /dev/null and b/entity-framework/ef6/media/datasource.png differ
diff --git a/entity-framework/ef6/media/datasource2.png b/entity-framework/ef6/media/datasource2.png
new file mode 100644
index 0000000000..917f1138bd
Binary files /dev/null and b/entity-framework/ef6/media/datasource2.png differ
diff --git a/entity-framework/ef6/media/datasources.png b/entity-framework/ef6/media/datasources.png
new file mode 100644
index 0000000000..917f1138bd
Binary files /dev/null and b/entity-framework/ef6/media/datasources.png differ
diff --git a/entity-framework/ef6/media/dbcontexttemplate.png b/entity-framework/ef6/media/dbcontexttemplate.png
new file mode 100644
index 0000000000..f209f48d80
Binary files /dev/null and b/entity-framework/ef6/media/dbcontexttemplate.png differ
diff --git a/entity-framework/ef6/media/deletetables.png b/entity-framework/ef6/media/deletetables.png
new file mode 100644
index 0000000000..4e507d7390
Binary files /dev/null and b/entity-framework/ef6/media/deletetables.png differ
diff --git a/entity-framework/ef6/media/designer.png b/entity-framework/ef6/media/designer.png
new file mode 100644
index 0000000000..61b3957e1b
Binary files /dev/null and b/entity-framework/ef6/media/designer.png differ
diff --git a/entity-framework/ef6/media/designersurface.png b/entity-framework/ef6/media/designersurface.png
new file mode 100644
index 0000000000..ddf91024f2
Binary files /dev/null and b/entity-framework/ef6/media/designersurface.png differ
diff --git a/entity-framework/ef6/media/diagramfiles.png b/entity-framework/ef6/media/diagramfiles.png
new file mode 100644
index 0000000000..fba64eb43b
Binary files /dev/null and b/entity-framework/ef6/media/diagramfiles.png differ
diff --git a/entity-framework/ef6/media/diagramname.png b/entity-framework/ef6/media/diagramname.png
new file mode 100644
index 0000000000..1043d5c844
Binary files /dev/null and b/entity-framework/ef6/media/diagramname.png differ
diff --git a/entity-framework/ef6/media/editfunctionimport.png b/entity-framework/ef6/media/editfunctionimport.png
new file mode 100644
index 0000000000..352e18651c
Binary files /dev/null and b/entity-framework/ef6/media/editfunctionimport.png differ
diff --git a/entity-framework/ef6/media/ef5micro5000warm.png b/entity-framework/ef6/media/ef5micro5000warm.png
new file mode 100644
index 0000000000..447b7f7900
Binary files /dev/null and b/entity-framework/ef6/media/ef5micro5000warm.png differ
diff --git a/entity-framework/ef6/media/ef5warmquery1000.png b/entity-framework/ef6/media/ef5warmquery1000.png
new file mode 100644
index 0000000000..e1be12a3de
Binary files /dev/null and b/entity-framework/ef6/media/ef5warmquery1000.png differ
diff --git a/entity-framework/ef6/media/ef6micro5000warm.png b/entity-framework/ef6/media/ef6micro5000warm.png
new file mode 100644
index 0000000000..c14706f793
Binary files /dev/null and b/entity-framework/ef6/media/ef6micro5000warm.png differ
diff --git a/entity-framework/ef6/media/ef6warmquery1000.png b/entity-framework/ef6/media/ef6warmquery1000.png
new file mode 100644
index 0000000000..6e72ed9acf
Binary files /dev/null and b/entity-framework/ef6/media/ef6warmquery1000.png differ
diff --git a/entity-framework/ef6/media/efdesigner.png b/entity-framework/ef6/media/efdesigner.png
new file mode 100644
index 0000000000..467e2332eb
Binary files /dev/null and b/entity-framework/ef6/media/efdesigner.png differ
diff --git a/entity-framework/ef6/media/efdesigner2.png b/entity-framework/ef6/media/efdesigner2.png
new file mode 100644
index 0000000000..20487af15b
Binary files /dev/null and b/entity-framework/ef6/media/efdesigner2.png differ
diff --git a/entity-framework/ef6/media/eftest-01.jpg b/entity-framework/ef6/media/eftest-01.jpg
new file mode 100644
index 0000000000..90ff1a5e95
Binary files /dev/null and b/entity-framework/ef6/media/eftest-01.jpg differ
diff --git a/entity-framework/ef6/media/eftest-02.png b/entity-framework/ef6/media/eftest-02.png
new file mode 100644
index 0000000000..f45798f0ac
Binary files /dev/null and b/entity-framework/ef6/media/eftest-02.png differ
diff --git a/entity-framework/ef6/media/eftest-03.png b/entity-framework/ef6/media/eftest-03.png
new file mode 100644
index 0000000000..fb86efb408
Binary files /dev/null and b/entity-framework/ef6/media/eftest-03.png differ
diff --git a/entity-framework/ef6/media/eftest-04.png b/entity-framework/ef6/media/eftest-04.png
new file mode 100644
index 0000000000..0dafde49ba
Binary files /dev/null and b/entity-framework/ef6/media/eftest-04.png differ
diff --git a/entity-framework/ef6/media/figure01.png b/entity-framework/ef6/media/figure01.png
new file mode 100644
index 0000000000..549e76a079
Binary files /dev/null and b/entity-framework/ef6/media/figure01.png differ
diff --git a/entity-framework/ef6/media/figure02.png b/entity-framework/ef6/media/figure02.png
new file mode 100644
index 0000000000..878c5147b8
Binary files /dev/null and b/entity-framework/ef6/media/figure02.png differ
diff --git a/entity-framework/ef6/media/finaltph.png b/entity-framework/ef6/media/finaltph.png
new file mode 100644
index 0000000000..311ff6544d
Binary files /dev/null and b/entity-framework/ef6/media/finaltph.png differ
diff --git a/entity-framework/ef6/media/firstmigration.png b/entity-framework/ef6/media/firstmigration.png
new file mode 100644
index 0000000000..bf4cf75914
Binary files /dev/null and b/entity-framework/ef6/media/firstmigration.png differ
diff --git a/entity-framework/ef6/media/fluentapi.png b/entity-framework/ef6/media/fluentapi.png
new file mode 100644
index 0000000000..f9179c4d5e
Binary files /dev/null and b/entity-framework/ef6/media/fluentapi.png differ
diff --git a/entity-framework/ef6/media/form1-designer.png b/entity-framework/ef6/media/form1-designer.png
new file mode 100644
index 0000000000..2434b9a5d9
Binary files /dev/null and b/entity-framework/ef6/media/form1-designer.png differ
diff --git a/entity-framework/ef6/media/form1aftersave.png b/entity-framework/ef6/media/form1aftersave.png
new file mode 100644
index 0000000000..9695f215d4
Binary files /dev/null and b/entity-framework/ef6/media/form1aftersave.png differ
diff --git a/entity-framework/ef6/media/form1beforesave.png b/entity-framework/ef6/media/form1beforesave.png
new file mode 100644
index 0000000000..e0ee81c043
Binary files /dev/null and b/entity-framework/ef6/media/form1beforesave.png differ
diff --git a/entity-framework/ef6/media/functionimports.png b/entity-framework/ef6/media/functionimports.png
new file mode 100644
index 0000000000..9b3ae5bba0
Binary files /dev/null and b/entity-framework/ef6/media/functionimports.png differ
diff --git a/entity-framework/ef6/media/generatedclasses.png b/entity-framework/ef6/media/generatedclasses.png
new file mode 100644
index 0000000000..7626fe2e8e
Binary files /dev/null and b/entity-framework/ef6/media/generatedclasses.png differ
diff --git a/entity-framework/ef6/media/generatedclassesdf.png b/entity-framework/ef6/media/generatedclassesdf.png
new file mode 100644
index 0000000000..76e60cc83d
Binary files /dev/null and b/entity-framework/ef6/media/generatedclassesdf.png differ
diff --git a/entity-framework/ef6/media/generatedviews.png b/entity-framework/ef6/media/generatedviews.png
new file mode 100644
index 0000000000..a9922b4e98
Binary files /dev/null and b/entity-framework/ef6/media/generatedviews.png differ
diff --git a/entity-framework/ef6/media/generateviews.png b/entity-framework/ef6/media/generateviews.png
new file mode 100644
index 0000000000..76722d7e11
Binary files /dev/null and b/entity-framework/ef6/media/generateviews.png differ
diff --git a/entity-framework/ef6/media/github-mark-32px.png b/entity-framework/ef6/media/github-mark-32px.png
new file mode 100644
index 0000000000..0a31d665cf
Binary files /dev/null and b/entity-framework/ef6/media/github-mark-32px.png differ
diff --git a/entity-framework/ef6/media/import.jpg b/entity-framework/ef6/media/import.jpg
new file mode 100644
index 0000000000..77ffeca98c
Binary files /dev/null and b/entity-framework/ef6/media/import.jpg differ
diff --git a/entity-framework/ef6/media/importsprocs.jpg b/entity-framework/ef6/media/importsprocs.jpg
new file mode 100644
index 0000000000..28f2a34ad6
Binary files /dev/null and b/entity-framework/ef6/media/importsprocs.jpg differ
diff --git a/entity-framework/ef6/media/includeprerelease.png b/entity-framework/ef6/media/includeprerelease.png
new file mode 100644
index 0000000000..8ae34981a1
Binary files /dev/null and b/entity-framework/ef6/media/includeprerelease.png differ
diff --git a/entity-framework/ef6/media/insert.png b/entity-framework/ef6/media/insert.png
new file mode 100644
index 0000000000..eaddbf5cd5
Binary files /dev/null and b/entity-framework/ef6/media/insert.png differ
diff --git a/entity-framework/ef6/media/insert1.png b/entity-framework/ef6/media/insert1.png
new file mode 100644
index 0000000000..651d8fddba
Binary files /dev/null and b/entity-framework/ef6/media/insert1.png differ
diff --git a/entity-framework/ef6/media/insert2.png b/entity-framework/ef6/media/insert2.png
new file mode 100644
index 0000000000..8224c0693a
Binary files /dev/null and b/entity-framework/ef6/media/insert2.png differ
diff --git a/entity-framework/ef6/media/installed.png b/entity-framework/ef6/media/installed.png
new file mode 100644
index 0000000000..11866471eb
Binary files /dev/null and b/entity-framework/ef6/media/installed.png differ
diff --git a/entity-framework/ef6/media/intellitrace.png b/entity-framework/ef6/media/intellitrace.png
new file mode 100644
index 0000000000..425f5bd1eb
Binary files /dev/null and b/entity-framework/ef6/media/intellitrace.png differ
diff --git a/entity-framework/ef6/media/jj591583-figure01.png b/entity-framework/ef6/media/jj591583-figure01.png
new file mode 100644
index 0000000000..d436a3ae37
Binary files /dev/null and b/entity-framework/ef6/media/jj591583-figure01.png differ
diff --git a/entity-framework/ef6/media/jj591583-figure02.png b/entity-framework/ef6/media/jj591583-figure02.png
new file mode 100644
index 0000000000..c702dabe9a
Binary files /dev/null and b/entity-framework/ef6/media/jj591583-figure02.png differ
diff --git a/entity-framework/ef6/media/jj591583-figure03.png b/entity-framework/ef6/media/jj591583-figure03.png
new file mode 100644
index 0000000000..cf4e558ab4
Binary files /dev/null and b/entity-framework/ef6/media/jj591583-figure03.png differ
diff --git a/entity-framework/ef6/media/jj591583-figure04.png b/entity-framework/ef6/media/jj591583-figure04.png
new file mode 100644
index 0000000000..961c8f4f72
Binary files /dev/null and b/entity-framework/ef6/media/jj591583-figure04.png differ
diff --git a/entity-framework/ef6/media/jj591583-figure05.png b/entity-framework/ef6/media/jj591583-figure05.png
new file mode 100644
index 0000000000..2205125768
Binary files /dev/null and b/entity-framework/ef6/media/jj591583-figure05.png differ
diff --git a/entity-framework/ef6/media/jj591583-figure06.png b/entity-framework/ef6/media/jj591583-figure06.png
new file mode 100644
index 0000000000..9fe2856a35
Binary files /dev/null and b/entity-framework/ef6/media/jj591583-figure06.png differ
diff --git a/entity-framework/ef6/media/jj591583-figure07.png b/entity-framework/ef6/media/jj591583-figure07.png
new file mode 100644
index 0000000000..5d225370d9
Binary files /dev/null and b/entity-framework/ef6/media/jj591583-figure07.png differ
diff --git a/entity-framework/ef6/media/jj591583-figure08.png b/entity-framework/ef6/media/jj591583-figure08.png
new file mode 100644
index 0000000000..3cbdd3b69a
Binary files /dev/null and b/entity-framework/ef6/media/jj591583-figure08.png differ
diff --git a/entity-framework/ef6/media/jj591583-figure09.png b/entity-framework/ef6/media/jj591583-figure09.png
new file mode 100644
index 0000000000..23cebe8929
Binary files /dev/null and b/entity-framework/ef6/media/jj591583-figure09.png differ
diff --git a/entity-framework/ef6/media/jj591583-figure10.png b/entity-framework/ef6/media/jj591583-figure10.png
new file mode 100644
index 0000000000..2c015d5389
Binary files /dev/null and b/entity-framework/ef6/media/jj591583-figure10.png differ
diff --git a/entity-framework/ef6/media/jj591583-figure11.png b/entity-framework/ef6/media/jj591583-figure11.png
new file mode 100644
index 0000000000..308390bc2a
Binary files /dev/null and b/entity-framework/ef6/media/jj591583-figure11.png differ
diff --git a/entity-framework/ef6/media/localchanges.png b/entity-framework/ef6/media/localchanges.png
new file mode 100644
index 0000000000..4f18aa0181
Binary files /dev/null and b/entity-framework/ef6/media/localchanges.png differ
diff --git a/entity-framework/ef6/media/localdbconnection.png b/entity-framework/ef6/media/localdbconnection.png
new file mode 100644
index 0000000000..35a59e45e2
Binary files /dev/null and b/entity-framework/ef6/media/localdbconnection.png differ
diff --git a/entity-framework/ef6/media/localdbconnectiondf.png b/entity-framework/ef6/media/localdbconnectiondf.png
new file mode 100644
index 0000000000..120e0eddec
Binary files /dev/null and b/entity-framework/ef6/media/localdbconnectiondf.png differ
diff --git a/entity-framework/ef6/media/localdbconnectionmf.png b/entity-framework/ef6/media/localdbconnectionmf.png
new file mode 100644
index 0000000000..54a649a1ab
Binary files /dev/null and b/entity-framework/ef6/media/localdbconnectionmf.png differ
diff --git a/entity-framework/ef6/media/mainwindowproperties.png b/entity-framework/ef6/media/mainwindowproperties.png
new file mode 100644
index 0000000000..8ad98b3ced
Binary files /dev/null and b/entity-framework/ef6/media/mainwindowproperties.png differ
diff --git a/entity-framework/ef6/media/managenugetpackages.png b/entity-framework/ef6/media/managenugetpackages.png
new file mode 100644
index 0000000000..4565b95695
Binary files /dev/null and b/entity-framework/ef6/media/managenugetpackages.png differ
diff --git a/entity-framework/ef6/media/mapcomplextype.png b/entity-framework/ef6/media/mapcomplextype.png
new file mode 100644
index 0000000000..0974384944
Binary files /dev/null and b/entity-framework/ef6/media/mapcomplextype.png differ
diff --git a/entity-framework/ef6/media/mapping.png b/entity-framework/ef6/media/mapping.png
new file mode 100644
index 0000000000..2ab9c47110
Binary files /dev/null and b/entity-framework/ef6/media/mapping.png differ
diff --git a/entity-framework/ef6/media/mapping2.png b/entity-framework/ef6/media/mapping2.png
new file mode 100644
index 0000000000..65baad7415
Binary files /dev/null and b/entity-framework/ef6/media/mapping2.png differ
diff --git a/entity-framework/ef6/media/mappingdetails.png b/entity-framework/ef6/media/mappingdetails.png
new file mode 100644
index 0000000000..068de97c83
Binary files /dev/null and b/entity-framework/ef6/media/mappingdetails.png differ
diff --git a/entity-framework/ef6/media/mappingdetails2.png b/entity-framework/ef6/media/mappingdetails2.png
new file mode 100644
index 0000000000..f33930f891
Binary files /dev/null and b/entity-framework/ef6/media/mappingdetails2.png differ
diff --git a/entity-framework/ef6/media/mappingdetails4.png b/entity-framework/ef6/media/mappingdetails4.png
new file mode 100644
index 0000000000..f3e8dae4c5
Binary files /dev/null and b/entity-framework/ef6/media/mappingdetails4.png differ
diff --git a/entity-framework/ef6/media/mappingdetailsshortcuts.png b/entity-framework/ef6/media/mappingdetailsshortcuts.png
new file mode 100644
index 0000000000..33f4196d3c
Binary files /dev/null and b/entity-framework/ef6/media/mappingdetailsshortcuts.png differ
diff --git a/entity-framework/ef6/media/mergemigration.png b/entity-framework/ef6/media/mergemigration.png
new file mode 100644
index 0000000000..3e96e7e675
Binary files /dev/null and b/entity-framework/ef6/media/mergemigration.png differ
diff --git a/entity-framework/ef6/media/modelbrowser.png b/entity-framework/ef6/media/modelbrowser.png
new file mode 100644
index 0000000000..d58d635631
Binary files /dev/null and b/entity-framework/ef6/media/modelbrowser.png differ
diff --git a/entity-framework/ef6/media/modelinitial.png b/entity-framework/ef6/media/modelinitial.png
new file mode 100644
index 0000000000..ecf000393b
Binary files /dev/null and b/entity-framework/ef6/media/modelinitial.png differ
diff --git a/entity-framework/ef6/media/modelmappingclasses.png b/entity-framework/ef6/media/modelmappingclasses.png
new file mode 100644
index 0000000000..9bca1ba1d9
Binary files /dev/null and b/entity-framework/ef6/media/modelmappingclasses.png differ
diff --git a/entity-framework/ef6/media/modelupdated.png b/entity-framework/ef6/media/modelupdated.png
new file mode 100644
index 0000000000..ded3517e89
Binary files /dev/null and b/entity-framework/ef6/media/modelupdated.png differ
diff --git a/entity-framework/ef6/media/net40files.png b/entity-framework/ef6/media/net40files.png
new file mode 100644
index 0000000000..496b145e84
Binary files /dev/null and b/entity-framework/ef6/media/net40files.png differ
diff --git a/entity-framework/ef6/media/net45files.png b/entity-framework/ef6/media/net45files.png
new file mode 100644
index 0000000000..0647b0f8f7
Binary files /dev/null and b/entity-framework/ef6/media/net45files.png differ
diff --git a/entity-framework/ef6/media/net45logscale.png b/entity-framework/ef6/media/net45logscale.png
new file mode 100644
index 0000000000..9b1e86a9bf
Binary files /dev/null and b/entity-framework/ef6/media/net45logscale.png differ
diff --git a/entity-framework/ef6/media/openas.png b/entity-framework/ef6/media/openas.png
new file mode 100644
index 0000000000..d8d8440292
Binary files /dev/null and b/entity-framework/ef6/media/openas.png differ
diff --git a/entity-framework/ef6/media/persontable.png b/entity-framework/ef6/media/persontable.png
new file mode 100644
index 0000000000..2639bfb134
Binary files /dev/null and b/entity-framework/ef6/media/persontable.png differ
diff --git a/entity-framework/ef6/media/productmodeltemplate.png b/entity-framework/ef6/media/productmodeltemplate.png
new file mode 100644
index 0000000000..56c7c79c30
Binary files /dev/null and b/entity-framework/ef6/media/productmodeltemplate.png differ
diff --git a/entity-framework/ef6/media/pull.png b/entity-framework/ef6/media/pull.png
new file mode 100644
index 0000000000..f5222ee7c5
Binary files /dev/null and b/entity-framework/ef6/media/pull.png differ
diff --git a/entity-framework/ef6/media/refactor.png b/entity-framework/ef6/media/refactor.png
new file mode 100644
index 0000000000..cd34af028e
Binary files /dev/null and b/entity-framework/ef6/media/refactor.png differ
diff --git a/entity-framework/ef6/media/refactor2.png b/entity-framework/ef6/media/refactor2.png
new file mode 100644
index 0000000000..21a394b681
Binary files /dev/null and b/entity-framework/ef6/media/refactor2.png differ
diff --git a/entity-framework/ef6/media/refconstraint.png b/entity-framework/ef6/media/refconstraint.png
new file mode 100644
index 0000000000..5cc21f9049
Binary files /dev/null and b/entity-framework/ef6/media/refconstraint.png differ
diff --git a/entity-framework/ef6/media/refreshwizard.png b/entity-framework/ef6/media/refreshwizard.png
new file mode 100644
index 0000000000..648975cc8f
Binary files /dev/null and b/entity-framework/ef6/media/refreshwizard.png differ
diff --git a/entity-framework/ef6/media/relationshipefdesigner.png b/entity-framework/ef6/media/relationshipefdesigner.png
new file mode 100644
index 0000000000..34d9545c7e
Binary files /dev/null and b/entity-framework/ef6/media/relationshipefdesigner.png differ
diff --git a/entity-framework/ef6/media/schemainitial.png b/entity-framework/ef6/media/schemainitial.png
new file mode 100644
index 0000000000..e78ed7c63c
Binary files /dev/null and b/entity-framework/ef6/media/schemainitial.png differ
diff --git a/entity-framework/ef6/media/schemawithdisplaynamerenamed.png b/entity-framework/ef6/media/schemawithdisplaynamerenamed.png
new file mode 100644
index 0000000000..117a6e9c41
Binary files /dev/null and b/entity-framework/ef6/media/schemawithdisplaynamerenamed.png differ
diff --git a/entity-framework/ef6/media/schemawithurl.png b/entity-framework/ef6/media/schemawithurl.png
new file mode 100644
index 0000000000..0fc1d46b91
Binary files /dev/null and b/entity-framework/ef6/media/schemawithurl.png differ
diff --git a/entity-framework/ef6/media/schemawithusers.png b/entity-framework/ef6/media/schemawithusers.png
new file mode 100644
index 0000000000..d86bf23abf
Binary files /dev/null and b/entity-framework/ef6/media/schemawithusers.png differ
diff --git a/entity-framework/ef6/media/screen.png b/entity-framework/ef6/media/screen.png
new file mode 100644
index 0000000000..03d601bd12
Binary files /dev/null and b/entity-framework/ef6/media/screen.png differ
diff --git a/entity-framework/ef6/media/screen1.png b/entity-framework/ef6/media/screen1.png
new file mode 100644
index 0000000000..ae97d026bf
Binary files /dev/null and b/entity-framework/ef6/media/screen1.png differ
diff --git a/entity-framework/ef6/media/screen2.png b/entity-framework/ef6/media/screen2.png
new file mode 100644
index 0000000000..b7d8e50199
Binary files /dev/null and b/entity-framework/ef6/media/screen2.png differ
diff --git a/entity-framework/ef6/media/search.png b/entity-framework/ef6/media/search.png
new file mode 100644
index 0000000000..c08e95ada5
Binary files /dev/null and b/entity-framework/ef6/media/search.png differ
diff --git a/entity-framework/ef6/media/secondmigration.png b/entity-framework/ef6/media/secondmigration.png
new file mode 100644
index 0000000000..19d6aeb81d
Binary files /dev/null and b/entity-framework/ef6/media/secondmigration.png differ
diff --git a/entity-framework/ef6/media/select.png b/entity-framework/ef6/media/select.png
new file mode 100644
index 0000000000..ca455b8c4f
Binary files /dev/null and b/entity-framework/ef6/media/select.png differ
diff --git a/entity-framework/ef6/media/select1.png b/entity-framework/ef6/media/select1.png
new file mode 100644
index 0000000000..f1ae0ce948
Binary files /dev/null and b/entity-framework/ef6/media/select1.png differ
diff --git a/entity-framework/ef6/media/select2.png b/entity-framework/ef6/media/select2.png
new file mode 100644
index 0000000000..8fedcdd5ad
Binary files /dev/null and b/entity-framework/ef6/media/select2.png differ
diff --git a/entity-framework/ef6/media/selectdataobjects.png b/entity-framework/ef6/media/selectdataobjects.png
new file mode 100644
index 0000000000..d0a00beffb
Binary files /dev/null and b/entity-framework/ef6/media/selectdataobjects.png differ
diff --git a/entity-framework/ef6/media/selectdatasource.png b/entity-framework/ef6/media/selectdatasource.png
new file mode 100644
index 0000000000..d213f70a92
Binary files /dev/null and b/entity-framework/ef6/media/selectdatasource.png differ
diff --git a/entity-framework/ef6/media/serverobjexplorer.png b/entity-framework/ef6/media/serverobjexplorer.png
new file mode 100644
index 0000000000..f399f58eba
Binary files /dev/null and b/entity-framework/ef6/media/serverobjexplorer.png differ
diff --git a/entity-framework/ef6/media/showallfiles.png b/entity-framework/ef6/media/showallfiles.png
new file mode 100644
index 0000000000..5c67dfeace
Binary files /dev/null and b/entity-framework/ef6/media/showallfiles.png differ
diff --git a/entity-framework/ef6/media/sqlexpressconnectiondf.png b/entity-framework/ef6/media/sqlexpressconnectiondf.png
new file mode 100644
index 0000000000..a406bab6e0
Binary files /dev/null and b/entity-framework/ef6/media/sqlexpressconnectiondf.png differ
diff --git a/entity-framework/ef6/media/sqlexpressconnectionmf.png b/entity-framework/ef6/media/sqlexpressconnectionmf.png
new file mode 100644
index 0000000000..8e9c85be21
Binary files /dev/null and b/entity-framework/ef6/media/sqlexpressconnectionmf.png differ
diff --git a/entity-framework/ef6/media/stackoverflow.png b/entity-framework/ef6/media/stackoverflow.png
new file mode 100644
index 0000000000..e99a8a3cae
Binary files /dev/null and b/entity-framework/ef6/media/stackoverflow.png differ
diff --git a/entity-framework/ef6/media/startingpoint.png b/entity-framework/ef6/media/startingpoint.png
new file mode 100644
index 0000000000..bf1bc701a9
Binary files /dev/null and b/entity-framework/ef6/media/startingpoint.png differ
diff --git a/entity-framework/ef6/media/submit.png b/entity-framework/ef6/media/submit.png
new file mode 100644
index 0000000000..a11946dafc
Binary files /dev/null and b/entity-framework/ef6/media/submit.png differ
diff --git a/entity-framework/ef6/media/syncoutput.png b/entity-framework/ef6/media/syncoutput.png
new file mode 100644
index 0000000000..7a57556913
Binary files /dev/null and b/entity-framework/ef6/media/syncoutput.png differ
diff --git a/entity-framework/ef6/media/tpt.png b/entity-framework/ef6/media/tpt.png
new file mode 100644
index 0000000000..27fa16458c
Binary files /dev/null and b/entity-framework/ef6/media/tpt.png differ
diff --git a/entity-framework/ef6/media/tptexample.jpg b/entity-framework/ef6/media/tptexample.jpg
new file mode 100644
index 0000000000..5aac915d2c
Binary files /dev/null and b/entity-framework/ef6/media/tptexample.jpg differ
diff --git a/entity-framework/ef6/media/updatedmetadata.png b/entity-framework/ef6/media/updatedmetadata.png
new file mode 100644
index 0000000000..f1248e5fef
Binary files /dev/null and b/entity-framework/ef6/media/updatedmetadata.png differ
diff --git a/entity-framework/ef6/media/viewedmwithdesigner.png b/entity-framework/ef6/media/viewedmwithdesigner.png
new file mode 100644
index 0000000000..2d61695983
Binary files /dev/null and b/entity-framework/ef6/media/viewedmwithdesigner.png differ
diff --git a/entity-framework/ef6/media/vs2010-templates.png b/entity-framework/ef6/media/vs2010-templates.png
new file mode 100644
index 0000000000..7390c9d515
Binary files /dev/null and b/entity-framework/ef6/media/vs2010-templates.png differ
diff --git a/entity-framework/ef6/media/vs2012-templates.png b/entity-framework/ef6/media/vs2012-templates.png
new file mode 100644
index 0000000000..cbfdfc7335
Binary files /dev/null and b/entity-framework/ef6/media/vs2012-templates.png differ
diff --git a/entity-framework/ef6/media/warning2.png b/entity-framework/ef6/media/warning2.png
new file mode 100644
index 0000000000..ca3f94b1f5
Binary files /dev/null and b/entity-framework/ef6/media/warning2.png differ
diff --git a/entity-framework/ef6/media/whichworkflow-thumb.png b/entity-framework/ef6/media/whichworkflow-thumb.png
new file mode 100644
index 0000000000..43c708e6eb
Binary files /dev/null and b/entity-framework/ef6/media/whichworkflow-thumb.png differ
diff --git a/entity-framework/ef6/media/wizardfour.png b/entity-framework/ef6/media/wizardfour.png
new file mode 100644
index 0000000000..f319ce74ab
Binary files /dev/null and b/entity-framework/ef6/media/wizardfour.png differ
diff --git a/entity-framework/ef6/media/wizardone.png b/entity-framework/ef6/media/wizardone.png
new file mode 100644
index 0000000000..8c7608550e
Binary files /dev/null and b/entity-framework/ef6/media/wizardone.png differ
diff --git a/entity-framework/ef6/media/wizardonecfe.png b/entity-framework/ef6/media/wizardonecfe.png
new file mode 100644
index 0000000000..83ce2400c5
Binary files /dev/null and b/entity-framework/ef6/media/wizardonecfe.png differ
diff --git a/entity-framework/ef6/media/wizardstep1.png b/entity-framework/ef6/media/wizardstep1.png
new file mode 100644
index 0000000000..041c32b140
Binary files /dev/null and b/entity-framework/ef6/media/wizardstep1.png differ
diff --git a/entity-framework/ef6/media/wizardstep2.png b/entity-framework/ef6/media/wizardstep2.png
new file mode 100644
index 0000000000..5a75865a3b
Binary files /dev/null and b/entity-framework/ef6/media/wizardstep2.png differ
diff --git a/entity-framework/ef6/media/wizardstep3.png b/entity-framework/ef6/media/wizardstep3.png
new file mode 100644
index 0000000000..423fc502fd
Binary files /dev/null and b/entity-framework/ef6/media/wizardstep3.png differ
diff --git a/entity-framework/ef6/media/wizardthree.png b/entity-framework/ef6/media/wizardthree.png
new file mode 100644
index 0000000000..cb065dba02
Binary files /dev/null and b/entity-framework/ef6/media/wizardthree.png differ
diff --git a/entity-framework/ef6/media/wizardthreecfe.png b/entity-framework/ef6/media/wizardthreecfe.png
new file mode 100644
index 0000000000..9147acc469
Binary files /dev/null and b/entity-framework/ef6/media/wizardthreecfe.png differ
diff --git a/entity-framework/ef6/media/wizardtwo.png b/entity-framework/ef6/media/wizardtwo.png
new file mode 100644
index 0000000000..e8823a40ea
Binary files /dev/null and b/entity-framework/ef6/media/wizardtwo.png differ
diff --git a/entity-framework/ef6/media/wizardtwocfe.png b/entity-framework/ef6/media/wizardtwocfe.png
new file mode 100644
index 0000000000..1528acdb86
Binary files /dev/null and b/entity-framework/ef6/media/wizardtwocfe.png differ
diff --git a/entity-framework/ef6/media/wpf.png b/entity-framework/ef6/media/wpf.png
new file mode 100644
index 0000000000..1a612a5d18
Binary files /dev/null and b/entity-framework/ef6/media/wpf.png differ
diff --git a/entity-framework/ef6/media/wpfproductmodeltemplate.png b/entity-framework/ef6/media/wpfproductmodeltemplate.png
new file mode 100644
index 0000000000..becddc186f
Binary files /dev/null and b/entity-framework/ef6/media/wpfproductmodeltemplate.png differ
diff --git a/entity-framework/ef6/media/xmleditor.png b/entity-framework/ef6/media/xmleditor.png
new file mode 100644
index 0000000000..11d070fbce
Binary files /dev/null and b/entity-framework/ef6/media/xmleditor.png differ
diff --git a/entity-framework/ef6/modeling/code-first/conventions/built-in.md b/entity-framework/ef6/modeling/code-first/conventions/built-in.md
new file mode 100644
index 0000000000..23f1a048ad
--- /dev/null
+++ b/entity-framework/ef6/modeling/code-first/conventions/built-in.md
@@ -0,0 +1,176 @@
+---
+title: Code First Conventions - EF6
+description: Code First Conventions in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/code-first/conventions/built-in
+---
+# Code First Conventions
+Code First enables you to describe a model by using C# or Visual Basic .NET classes. The basic shape of the model is detected by using conventions. Conventions are sets of rules that are used to automatically configure a conceptual model based on class definitions when working with Code First. The conventions are defined in the System.Data.Entity.ModelConfiguration.Conventions namespace.  
+
+You can further configure your model by using data annotations or the fluent API. Precedence is given to configuration through the fluent API followed by data annotations and then conventions. For more information see [Data Annotations](xref:ef6/modeling/code-first/data-annotations), [Fluent API - Relationships](xref:ef6/modeling/code-first/fluent/relationships), [Fluent API - Types & Properties](xref:ef6/modeling/code-first/fluent/types-and-properties) and [Fluent API with VB.NET](xref:ef6/modeling/code-first/fluent/vb).  
+
+A detailed list of Code First conventions is available in the [API Documentation](https://msdn.microsoft.com/library/system.data.entity.modelconfiguration.conventions.aspx). This topic provides an overview of the conventions used by Code First.  
+
+## Type Discovery  
+
+When using Code First development you usually begin by writing .NET Framework classes that define your conceptual (domain) model. In addition to defining the classes, you also need to let **DbContext** know which types you want to include in the model. To do this, you define a context class that derives from **DbContext** and exposes **DbSet** properties for the types that you want to be part of the model. Code First will include these types and also will pull in any referenced types, even if the referenced types are defined in a different assembly.  
+
+If your types participate in an inheritance hierarchy, it is enough to define a **DbSet** property for the base class, and the derived types will be automatically included, if they are in the same assembly as the base class.  
+
+In the following example, there is only one **DbSet** property defined on the **SchoolEntities** class (**Departments**). Code First uses this property to discover and pull in any referenced types.  
+
+``` csharp
+public class SchoolEntities : DbContext
+{
+    public DbSet<Department> Departments { get; set; }
+}
+
+public class Department
+{
+    // Primary key
+    public int DepartmentID { get; set; }
+    public string Name { get; set; }
+
+    // Navigation property
+    public virtual ICollection<Course> Courses { get; set; }
+}
+
+public class Course
+{
+    // Primary key
+    public int CourseID { get; set; }
+
+    public string Title { get; set; }
+    public int Credits { get; set; }
+
+    // Foreign key
+    public int DepartmentID { get; set; }
+
+    // Navigation properties
+    public virtual Department Department { get; set; }
+}
+
+public partial class OnlineCourse : Course
+{
+    public string URL { get; set; }
+}
+
+public partial class OnsiteCourse : Course
+{
+    public string Location { get; set; }
+    public string Days { get; set; }
+    public System.DateTime Time { get; set; }
+}
+```  
+
+If you want to exclude a type from the model, use the **NotMapped** attribute or the **DbModelBuilder.Ignore** fluent API.  
+
+```  csharp
+modelBuilder.Ignore<Department>();
+```  
+
+## Primary Key Convention  
+
+Code First infers that a property is a primary key if a property on a class is named “ID” (not case sensitive), or the class name followed by "ID". If the type of the primary key property is numeric or GUID it will be configured as an identity column.  
+
+``` csharp
+public class Department
+{
+    // Primary key
+    public int DepartmentID { get; set; }
+
+    . . .  
+
+}
+```  
+
+## Relationship Convention  
+
+In Entity Framework, navigation properties provide a way to navigate a relationship between two entity types. Every object can have a navigation property for every relationship in which it participates. Navigation properties allow you to navigate and manage relationships in both directions, returning either a reference object (if the multiplicity is either one or zero-or-one) or a collection (if the multiplicity is many). Code First infers relationships based on the navigation properties defined on your types.  
+
+In addition to navigation properties, we recommend that you include foreign key properties on the types that represent dependent objects. Any property with the same data type as the principal primary key property and with a name that follows one of the following formats represents a foreign key for the relationship: '\<navigation property name\>\<principal primary key property name\>', '\<principal class name\>\<primary key property name\>', or '\<principal primary key property name\>'. If multiple matches are found then precedence is given in the order listed above. Foreign key detection is not case sensitive. When a foreign key property is detected, Code First infers the multiplicity of the relationship based on the nullability of the foreign key. If the property is nullable then the relationship is registered as optional; otherwise the relationship is registered as required.  
+
+If a foreign key on the dependent entity is not nullable, then Code First sets cascade delete on the relationship. If a foreign key on the dependent entity is nullable, Code First does not set cascade delete on the relationship, and when the principal is deleted the foreign key will be set to null. The multiplicity and cascade delete behavior detected by convention can be overridden by using the fluent API.  
+
+In the following example the navigation properties and a foreign key are used to define the relationship between the Department and Course classes.  
+
+``` csharp
+public class Department
+{
+    // Primary key
+    public int DepartmentID { get; set; }
+    public string Name { get; set; }
+
+    // Navigation property
+    public virtual ICollection<Course> Courses { get; set; }
+}
+
+public class Course
+{
+    // Primary key
+    public int CourseID { get; set; }
+
+    public string Title { get; set; }
+    public int Credits { get; set; }
+
+    // Foreign key
+    public int DepartmentID { get; set; }
+
+    // Navigation properties
+    public virtual Department Department { get; set; }
+}
+```  
+
+> [!NOTE]
+> If you have multiple relationships between the same types (for example, suppose you define the **Person** and **Book** classes, where the **Person** class contains the **ReviewedBooks** and **AuthoredBooks** navigation properties and the **Book** class contains the **Author** and **Reviewer** navigation properties) you need to manually configure the relationships by using Data Annotations or the fluent API. For more information, see [Data Annotations - Relationships](xref:ef6/modeling/code-first/data-annotations) and [Fluent API - Relationships](xref:ef6/modeling/code-first/fluent/relationships).  
+
+## Complex Types Convention  
+
+When Code First discovers a class definition where a primary key cannot be inferred, and no primary key is registered through data annotations or the fluent API, then the type is automatically registered as a complex type. Complex type detection also requires that the type does not have properties that reference entity types and is not referenced from a collection property on another type. Given the following class definitions Code First would infer that **Details** is a complex type because it has no primary key.  
+
+``` csharp
+public partial class OnsiteCourse : Course
+{
+    public OnsiteCourse()
+    {
+        Details = new Details();
+    }
+
+    public Details Details { get; set; }
+}
+
+public class Details
+{
+    public System.DateTime Time { get; set; }
+    public string Location { get; set; }
+    public string Days { get; set; }
+}
+```  
+
+## Connection String Convention  
+
+To learn about the conventions that DbContext uses to discover the connection to use see [Connections and Models](xref:ef6/fundamentals/configuring/connection-strings).  
+
+## Removing Conventions  
+
+You can remove any of the conventions defined in the System.Data.Entity.ModelConfiguration.Conventions namespace. The following example removes **PluralizingTableNameConvention**.  
+
+``` csharp
+public class SchoolEntities : DbContext
+{
+     . . .
+
+    protected override void OnModelCreating(DbModelBuilder modelBuilder)
+    {
+        // Configure Code First to ignore PluralizingTableName convention
+        // If you keep this convention, the generated tables  
+        // will have pluralized names.
+        modelBuilder.Conventions.Remove<PluralizingTableNameConvention>();
+    }
+}
+```  
+
+## Custom Conventions  
+
+Custom conventions are supported in EF6 onwards. For more information see [Custom Code First Conventions](xref:ef6/modeling/code-first/conventions/custom).
diff --git a/entity-framework/ef6/modeling/code-first/conventions/custom.md b/entity-framework/ef6/modeling/code-first/conventions/custom.md
new file mode 100644
index 0000000000..e87491ded0
--- /dev/null
+++ b/entity-framework/ef6/modeling/code-first/conventions/custom.md
@@ -0,0 +1,335 @@
+---
+title: Custom Code First Conventions - EF6
+description: Custom Code First Conventions in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/code-first/conventions/custom
+---
+# Custom Code First Conventions
+> [!NOTE]
+> **EF6 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 6. If you are using an earlier version, some or all of the information does not apply.
+
+When using Code First your model is calculated from your classes using a set of conventions. The default [Code First Conventions](xref:ef6/modeling/code-first/conventions/built-in) determine things like which property becomes the primary key of an entity, the name of the table an entity maps to, and what precision and scale a decimal column has by default.
+
+Sometimes these default conventions are not ideal for your model, and you have to work around them by configuring many individual entities using Data Annotations or the Fluent API. Custom Code First Conventions let you define your own conventions that provide configuration defaults for your model. In this walkthrough, we will explore the different types of custom conventions and how to create each of them.
+
+
+## Model-Based Conventions
+
+This page covers the DbModelBuilder API for custom conventions. This API should be sufficient for authoring most custom conventions. However, there is also the ability to author model-based conventions - conventions that manipulate the final model once it is created - to handle advanced scenarios. For more information, see [Model-Based Conventions](xref:ef6/modeling/code-first/conventions/model).
+
+ 
+
+## Our Model
+
+Let's start by defining a simple model that we can use with our conventions. Add the following classes to your project.
+
+``` csharp
+    using System;
+    using System.Collections.Generic;
+    using System.Data.Entity;
+    using System.Linq;
+
+    public class ProductContext : DbContext
+    {
+        static ProductContext()
+        {
+            Database.SetInitializer(new DropCreateDatabaseIfModelChanges<ProductContext>());
+        }
+
+        public DbSet<Product> Products { get; set; }
+    }
+
+    public class Product
+    {
+        public int Key { get; set; }
+        public string Name { get; set; }
+        public decimal? Price { get; set; }
+        public DateTime? ReleaseDate { get; set; }
+        public ProductCategory Category { get; set; }
+    }
+
+    public class ProductCategory
+    {
+        public int Key { get; set; }
+        public string Name { get; set; }
+        public List<Product> Products { get; set; }
+    }
+```
+
+ 
+
+## Introducing Custom Conventions
+
+Let’s write a convention that configures any property named Key to be the primary key for its entity type.
+
+Conventions are enabled on the model builder, which can be accessed by overriding OnModelCreating in the context. Update the ProductContext class as follows:
+
+``` csharp
+    public class ProductContext : DbContext
+    {
+        static ProductContext()
+        {
+            Database.SetInitializer(new DropCreateDatabaseIfModelChanges<ProductContext>());
+        }
+
+        public DbSet<Product> Products { get; set; }
+
+        protected override void OnModelCreating(DbModelBuilder modelBuilder)
+        {
+            modelBuilder.Properties()
+                        .Where(p => p.Name == "Key")
+                        .Configure(p => p.IsKey());
+        }
+    }
+```
+
+Now, any property in our model named Key will be configured as the primary key of whatever entity its part of.
+
+We could also make our conventions more specific by filtering on the type of property that we are going to configure:
+
+``` csharp
+    modelBuilder.Properties<int>()
+                .Where(p => p.Name == "Key")
+                .Configure(p => p.IsKey());
+```
+
+This will configure all properties called Key to be the primary key of their entity, but only if they are an integer.
+
+An interesting feature of the IsKey method is that it is additive. Which means that if you call IsKey on multiple properties and they will all become part of a composite key. The one caveat for this is that when you specify multiple properties for a key you must also specify an order for those properties. You can do this by calling the HasColumnOrder method like below:
+
+``` csharp
+    modelBuilder.Properties<int>()
+                .Where(x => x.Name == "Key")
+                .Configure(x => x.IsKey().HasColumnOrder(1));
+
+    modelBuilder.Properties()
+                .Where(x => x.Name == "Name")
+                .Configure(x => x.IsKey().HasColumnOrder(2));
+```
+
+This code will configure the types in our model to have a composite key consisting of the int Key column and the string Name column. If we view the model in the designer it would look like this:
+
+![composite Key](~/ef6/media/compositekey.png)
+
+Another example of property conventions is to configure all DateTime properties in my model to map to the datetime2 type in SQL Server instead of datetime. You can achieve this with the following:
+
+``` csharp
+    modelBuilder.Properties<DateTime>()
+                .Configure(c => c.HasColumnType("datetime2"));
+```
+
+ 
+
+## Convention Classes
+
+Another way of defining conventions is to use a Convention Class to encapsulate your convention. When using a Convention Class then you create a type that inherits from the Convention class in the System.Data.Entity.ModelConfiguration.Conventions namespace.
+
+We can create a Convention Class with the datetime2 convention that we showed earlier by doing the following:
+
+``` csharp
+    public class DateTime2Convention : Convention
+    {
+        public DateTime2Convention()
+        {
+            this.Properties<DateTime>()
+                .Configure(c => c.HasColumnType("datetime2"));        
+        }
+    }
+```
+
+To tell EF to use this convention you add it to the Conventions collection in OnModelCreating, which if you’ve been following along with the walkthrough will look like this:
+
+``` csharp
+    protected override void OnModelCreating(DbModelBuilder modelBuilder)
+    {
+        modelBuilder.Properties<int>()
+                    .Where(p => p.Name.EndsWith("Key"))
+                    .Configure(p => p.IsKey());
+
+        modelBuilder.Conventions.Add(new DateTime2Convention());
+    }
+```
+
+As you can see we add an instance of our convention to the conventions collection. Inheriting from Convention provides a convenient way of grouping and sharing conventions across teams or projects. You could, for example, have a class library with a common set of conventions that all of your organizations projects use.
+
+ 
+
+## Custom Attributes
+
+Another great use of conventions is to enable new attributes to be used when configuring a model. To illustrate this, let’s create an attribute that we can use to mark String properties as non-Unicode.
+
+``` csharp
+    [AttributeUsage(AttributeTargets.Property, AllowMultiple = false)]
+    public class NonUnicode : Attribute
+    {
+    }
+```
+
+Now, let’s create a convention to apply this attribute to our model:
+
+``` csharp
+    modelBuilder.Properties()
+                .Where(x => x.GetCustomAttributes(false).OfType<NonUnicode>().Any())
+                .Configure(c => c.IsUnicode(false));
+```
+
+With this convention we can add the NonUnicode attribute to any of our string properties, which means the column in the database will be stored as varchar instead of nvarchar.
+
+One thing to note about this convention is that if you put the NonUnicode attribute on anything other than a string property then it will throw an exception. It does this because you cannot configure IsUnicode on any type other than a string. If this happens, then you can make your convention more specific, so that it filters out anything that isn’t a string.
+
+While the above convention works for defining custom attributes there is another API that can be much easier to use, especially when you want to use properties from the attribute class.
+
+For this example we are going to update our attribute and change it to an IsUnicode attribute, so it looks like this:
+
+``` csharp
+    [AttributeUsage(AttributeTargets.Property, AllowMultiple = false)]
+    internal class IsUnicode : Attribute
+    {
+        public bool Unicode { get; set; }
+
+        public IsUnicode(bool isUnicode)
+        {
+            Unicode = isUnicode;
+        }
+    }
+```
+
+Once we have this, we can set a bool on our attribute to tell the convention whether or not a property should be Unicode. We could do this in the convention we have already by accessing the ClrProperty of the configuration class like this:
+
+``` csharp
+    modelBuilder.Properties()
+                .Where(x => x.GetCustomAttributes(false).OfType<IsUnicode>().Any())
+                .Configure(c => c.IsUnicode(c.ClrPropertyInfo.GetCustomAttribute<IsUnicode>().Unicode));
+```
+
+This is easy enough, but there is a more succinct way of achieving this by using the Having method of the conventions API. The Having method has a parameter of type Func&lt;PropertyInfo, T&gt; which accepts the PropertyInfo the same as the Where method, but is expected to return an object. If the returned object is null then the property will not be configured, which means you can filter out properties with it just like Where, but it is different in that it will also capture the returned object and pass it to the Configure method. This works like the following:
+
+``` csharp
+    modelBuilder.Properties()
+                .Having(x => x.GetCustomAttributes(false).OfType<IsUnicode>().FirstOrDefault())
+                .Configure((config, att) => config.IsUnicode(att.Unicode));
+```
+
+Custom attributes are not the only reason to use the Having method, it is useful anywhere that you need to reason about something that you are filtering on when configuring your types or properties.
+
+ 
+
+## Configuring Types
+
+So far all of our conventions have been for properties, but there is another area of the conventions API for configuring the types in your model. The experience is similar to the conventions we have seen so far, but the options inside configure will be at the entity instead of property level.
+
+One of the things that Type level conventions can be really useful for is changing the table naming convention, either to map to an existing schema that differs from the EF default or to create a new database with a different naming convention. To do this we first need a method that can accept the TypeInfo for a type in our model and return what the table name for that type should be:
+
+``` csharp
+    private string GetTableName(Type type)
+    {
+        var result = Regex.Replace(type.Name, ".[A-Z]", m => m.Value[0] + "_" + m.Value[1]);
+
+        return result.ToLower();
+    }
+```
+
+This method takes a type and returns a string that uses lower case with underscores instead of CamelCase. In our model this means that the ProductCategory class will be mapped to a table called product\_category instead of ProductCategories.
+
+Once we have that method we can call it in a convention like this:
+
+``` csharp
+    modelBuilder.Types()
+                .Configure(c => c.ToTable(GetTableName(c.ClrType)));
+```
+
+This convention configures every type in our model to map to the table name that is returned from our GetTableName method. This convention is the equivalent to calling the ToTable method for each entity in the model using the Fluent API.
+
+One thing to note about this is that when you call ToTable EF will take the string that you provide as the exact table name, without any of the pluralization that it would normally do when determining table names. This is why the table name from our convention is product\_category instead of product\_categories. We can resolve that in our convention by making a call to the pluralization service ourselves.
+
+In the following code we will use the [Dependency Resolution](xref:ef6/fundamentals/configuring/dependency-resolution) feature added in EF6 to retrieve the pluralization service that EF would have used and pluralize our table name.
+
+``` csharp
+    private string GetTableName(Type type)
+    {
+        var pluralizationService = DbConfiguration.DependencyResolver.GetService<IPluralizationService>();
+
+        var result = pluralizationService.Pluralize(type.Name);
+
+        result = Regex.Replace(result, ".[A-Z]", m => m.Value[0] + "_" + m.Value[1]);
+
+        return result.ToLower();
+    }
+```
+
+> [!NOTE]
+> The generic version of GetService is an extension method in the System.Data.Entity.Infrastructure.DependencyResolution namespace, you will need to add a using statement to your context in order to use it.
+
+### ToTable and Inheritance
+
+Another important aspect of ToTable is that if you explicitly map a type to a given table, then you can alter the mapping strategy that EF will use. If you call ToTable for every type in an inheritance hierarchy, passing the type name as the name of the table like we did above, then you will change the default Table-Per-Hierarchy (TPH) mapping strategy to Table-Per-Type (TPT). The best way to describe this is whith a concrete example:
+
+``` csharp
+    public class Employee
+    {
+        public int Id { get; set; }
+        public string Name { get; set; }
+    }
+
+    public class Manager : Employee
+    {
+        public string SectionManaged { get; set; }
+    }
+```
+
+By default both employee and manager are mapped to the same table (Employees) in the database. The table will contain both employees and managers with a discriminator column that will tell you what type of instance is stored in each row. This is TPH mapping as there is a single table for the hierarchy. However, if you call ToTable on both classe then each type will instead be mapped to its own table, also known as TPT since each type has its own table.
+
+``` csharp
+    modelBuilder.Types()
+                .Configure(c=>c.ToTable(c.ClrType.Name));
+```
+
+The code above will map to a table structure that looks like the following:
+
+![tpt Example](~/ef6/media/tptexample.jpg)
+
+You can avoid this, and maintain the default TPH mapping, in a couple ways:
+
+1.  Call ToTable with the same table name for each type in the hierarchy.
+2.  Call ToTable only on the base class of the hierarchy, in our example that would be employee.
+
+ 
+
+## Execution Order
+
+Conventions operate in a last wins manner, the same as the Fluent API. What this means is that if you write two conventions that configure the same option of the same property, then the last one to execute wins. As an example, in the code below the max length of all strings is set to 500 but we then configure all properties called Name in the model to have a max length of 250.
+
+``` csharp
+    modelBuilder.Properties<string>()
+                .Configure(c => c.HasMaxLength(500));
+
+    modelBuilder.Properties<string>()
+                .Where(x => x.Name == "Name")
+                .Configure(c => c.HasMaxLength(250));
+```
+
+Because the convention to set max length to 250 is after the one that sets all strings to 500, all the properties called Name in our model will have a MaxLength of 250 while any other strings, such as descriptions, would be 500. Using conventions in this way means that you can provide a general convention for types or properties in your model and then overide them for subsets that are different.
+
+The Fluent API and Data Annotations can also be used to override a convention in specific cases. In our example above if we had used the Fluent API to set the max length of a property then we could have put it before or after the convention, because the more specific Fluent API will win over the more general Configuration Convention.
+
+ 
+
+## Built-in Conventions
+
+Because custom conventions could be affected by the default Code First conventions, it can be useful to add conventions to run before or after another convention. To do this you can use the AddBefore and AddAfter methods of the Conventions collection on your derived DbContext. The following code would add the convention class we created earlier so that it will run before the built in key discovery convention.
+
+``` csharp
+    modelBuilder.Conventions.AddBefore<IdKeyDiscoveryConvention>(new DateTime2Convention());
+```
+
+This is going to be of the most use when adding conventions that need to run before or after the built in conventions, a list of the built in conventions can be found here: [System.Data.Entity.ModelConfiguration.Conventions Namespace](https://msdn.microsoft.com/library/system.data.entity.modelconfiguration.conventions.aspx).
+
+You can also remove conventions that you do not want applied to your model. To remove a convention, use the Remove method. Here is an example of removing the PluralizingTableNameConvention.
+
+``` csharp
+    protected override void OnModelCreating(DbModelBuilder modelBuilder)
+    {
+        modelBuilder.Conventions.Remove<PluralizingTableNameConvention>();
+    }
+```
diff --git a/entity-framework/ef6/modeling/code-first/conventions/model.md b/entity-framework/ef6/modeling/code-first/conventions/model.md
new file mode 100644
index 0000000000..7ce942bf4c
--- /dev/null
+++ b/entity-framework/ef6/modeling/code-first/conventions/model.md
@@ -0,0 +1,207 @@
+---
+title: Model-Based Conventions - EF6
+description: Model-Based Conventions in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/code-first/conventions/model
+---
+# Model-Based Conventions
+> [!NOTE]
+> **EF6 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 6. If you are using an earlier version, some or all of the information does not apply.  
+
+Model based conventions are an advanced method of convention based model configuration. For most scenarios the [Custom Code First Convention API on DbModelBuilder](xref:ef6/modeling/code-first/conventions/custom) should be used. An understanding of the DbModelBuilder API for conventions is recommended before using model based conventions.  
+
+Model based conventions allow the creation of conventions that affect properties and tables which are not configurable through standard conventions. Examples of these are discriminator columns in table per hierarchy models and Independent Association columns.  
+
+## Creating a Convention   
+
+The first step in creating a model based convention is choosing when in the pipeline the convention needs to be applied to the model. There are two types of model conventions, Conceptual (C-Space) and Store (S-Space). A C-Space convention is applied to the model that the application builds, whereas an S-Space convention is applied to the version of the model that represents the database and controls things such as how automatically-generated columns are named.  
+
+A model convention is a class that extends from either IConceptualModelConvention or IStoreModelConvention.  These interfaces both accept a generic type that can be of type MetadataItem which is used to filter the data type that the convention applies to.  
+
+## Adding a Convention   
+
+Model conventions are added in the same way as regular conventions classes. In the **OnModelCreating** method, add the convention to the list of conventions for a model.  
+
+``` csharp
+using System.Data.Entity;
+using System.Data.Entity.Core.Metadata.Edm;
+using System.Data.Entity.Infrastructure;
+using System.Data.Entity.ModelConfiguration.Conventions;
+
+public class BlogContext : DbContext  
+{  
+    public DbSet<Post> Posts { get; set; }  
+    public DbSet<Comment> Comments { get; set; }  
+
+    protected override void OnModelCreating(DbModelBuilder modelBuilder)  
+    {  
+        modelBuilder.Conventions.Add<MyModelBasedConvention>();  
+    }  
+}
+```  
+
+A convention can also be added in relation to another convention using the Conventions.AddBefore\<\> or Conventions.AddAfter\<\> methods. For more information about the conventions that Entity Framework applies see the notes section.  
+
+``` csharp
+protected override void OnModelCreating(DbModelBuilder modelBuilder)
+{
+    modelBuilder.Conventions.AddAfter<IdKeyDiscoveryConvention>(new MyModelBasedConvention());
+}
+```  
+
+## Example: Discriminator Model Convention  
+
+Renaming columns generated by EF is an example of something that you can’t do with the other conventions APIs.  This is a situation where using model conventions is your only option.  
+
+An example of how to use a model based convention to configure generated columns is customizing the way discriminator columns are named.  Below is an example of a simple model based convention that renames every column in the model named “Discriminator” to “EntityType”.  This includes columns that the developer simply named “Discriminator”. Since the “Discriminator” column is a generated column this needs to run in S-Space.  
+
+``` csharp
+using System.Data.Entity;
+using System.Data.Entity.Core.Metadata.Edm;
+using System.Data.Entity.Infrastructure;
+using System.Data.Entity.ModelConfiguration.Conventions;
+
+class DiscriminatorRenamingConvention : IStoreModelConvention<EdmProperty>  
+{  
+    public void Apply(EdmProperty property, DbModel model)  
+    {            
+        if (property.Name == "Discriminator")  
+        {  
+            property.Name = "EntityType";  
+        }  
+    }  
+}
+```  
+
+## Example: General IA Renaming Convention   
+
+Another more complicated example of model based conventions in action is to configure the way that Independent Associations (IAs) are named.  This is a situation where Model conventions are applicable because IAs are generated by EF and aren’t present in the model that the DbModelBuilder API can access.  
+
+When EF generates an IA, it creates a column named EntityType_KeyName. For example, for an association named Customer with a key column named CustomerId it would generate a column named Customer_CustomerId. The following convention strips the ‘\_’ character out of the column name that is generated for the IA.  
+
+``` csharp
+using System.Data.Entity;
+using System.Data.Entity.Core.Metadata.Edm;
+using System.Data.Entity.Infrastructure;
+using System.Data.Entity.ModelConfiguration.Conventions;
+
+// Provides a convention for fixing the independent association (IA) foreign key column names.  
+public class ForeignKeyNamingConvention : IStoreModelConvention<AssociationType>
+{
+
+    public void Apply(AssociationType association, DbModel model)
+    {
+        // Identify ForeignKey properties (including IAs)  
+        if (association.IsForeignKey)
+        {
+            // rename FK columns  
+            var constraint = association.Constraint;
+            if (DoPropertiesHaveDefaultNames(constraint.FromProperties, constraint.ToRole.Name, constraint.ToProperties))
+            {
+                NormalizeForeignKeyProperties(constraint.FromProperties);
+            }
+            if (DoPropertiesHaveDefaultNames(constraint.ToProperties, constraint.FromRole.Name, constraint.FromProperties))
+            {
+                NormalizeForeignKeyProperties(constraint.ToProperties);
+            }
+        }
+    }
+
+    private bool DoPropertiesHaveDefaultNames(ReadOnlyMetadataCollection<EdmProperty> properties, string roleName, ReadOnlyMetadataCollection<EdmProperty> otherEndProperties)
+    {
+        if (properties.Count != otherEndProperties.Count)
+        {
+            return false;
+        }
+
+        for (int i = 0; i < properties.Count; ++i)
+        {
+            if (!properties[i].Name.EndsWith("_" + otherEndProperties[i].Name))
+            {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    private void NormalizeForeignKeyProperties(ReadOnlyMetadataCollection<EdmProperty> properties)
+    {
+        for (int i = 0; i < properties.Count; ++i)
+        {
+            int underscoreIndex = properties[i].Name.IndexOf('_');
+            if (underscoreIndex > 0)
+            {
+                properties[i].Name = properties[i].Name.Remove(underscoreIndex, 1);
+            }                 
+        }
+    }
+}
+```  
+
+## Extending Existing Conventions   
+
+If you need to write a convention that is similar to one of the conventions that Entity Framework already applies to your model you can always extend that convention to avoid having to rewrite it from scratch.  An example of this is to replace the existing Id matching convention with a custom one.   An added benefit to overriding the key convention is that the overridden method will get called only if there is no key already detected or explicitly configured. A list of conventions that used by Entity Framework is available here: [http://msdn.microsoft.com/library/system.data.entity.modelconfiguration.conventions.aspx](https://msdn.microsoft.com/library/system.data.entity.modelconfiguration.conventions.aspx).  
+
+``` csharp
+using System.Data.Entity;
+using System.Data.Entity.Core.Metadata.Edm;
+using System.Data.Entity.Infrastructure;
+using System.Data.Entity.ModelConfiguration.Conventions;
+using System.Linq;  
+
+// Convention to detect primary key properties.
+// Recognized naming patterns in order of precedence are:
+// 1. 'Key'
+// 2. [type name]Key
+// Primary key detection is case insensitive.
+public class CustomKeyDiscoveryConvention : KeyDiscoveryConvention
+{
+    private const string Id = "Key";
+
+    protected override IEnumerable<EdmProperty> MatchKeyProperty(
+        EntityType entityType, IEnumerable<EdmProperty> primitiveProperties)
+    {
+        Debug.Assert(entityType != null);
+        Debug.Assert(primitiveProperties != null);
+
+        var matches = primitiveProperties
+            .Where(p => Id.Equals(p.Name, StringComparison.OrdinalIgnoreCase));
+
+        if (!matches.Any())
+       {
+            matches = primitiveProperties
+                .Where(p => (entityType.Name + Id).Equals(p.Name, StringComparison.OrdinalIgnoreCase));
+        }
+
+        // If the number of matches is more than one, then multiple properties matched differing only by
+        // case--for example, "Key" and "key".  
+        if (matches.Count() > 1)
+        {
+            throw new InvalidOperationException("Multiple properties match the key convention");
+        }
+
+        return matches;
+    }
+}
+```  
+
+We then need to add our new convention before the existing key convention. After we add the CustomKeyDiscoveryConvention, we can remove the IdKeyDiscoveryConvention.  If we didn’t remove the existing IdKeyDiscoveryConvention this convention would still take precedence over the Id discovery convention since it is run first, but in the case where no “key” property is found, the “id” convention will run.  We see this behavior because each convention sees the model as updated by the previous convention (rather than operating on it independently and all being combined together) so that if for example, a previous convention updated a column name to match something of interest to your custom convention (when before that the name was not of interest) then it will apply to that column.  
+
+``` csharp
+public class BlogContext : DbContext
+{
+    public DbSet<Post> Posts { get; set; }
+    public DbSet<Comment> Comments { get; set; }
+
+    protected override void OnModelCreating(DbModelBuilder modelBuilder)
+    {
+        modelBuilder.Conventions.AddBefore<IdKeyDiscoveryConvention>(new CustomKeyDiscoveryConvention());
+        modelBuilder.Conventions.Remove<IdKeyDiscoveryConvention>();
+    }
+}
+```  
+
+## Notes  
+
+A list of conventions that are currently applied by Entity Framework is available in the MSDN documentation here: [http://msdn.microsoft.com/library/system.data.entity.modelconfiguration.conventions.aspx](https://msdn.microsoft.com/library/system.data.entity.modelconfiguration.conventions.aspx).  This list is pulled directly from our source code.  The source code for Entity Framework 6 is available on [GitHub](https://github.com/aspnet/entityframework6/) and many of the conventions used by Entity Framework are good starting points for custom model based conventions.  
diff --git a/entity-framework/ef6/modeling/code-first/data-annotations.md b/entity-framework/ef6/modeling/code-first/data-annotations.md
new file mode 100644
index 0000000000..cef0504cb0
--- /dev/null
+++ b/entity-framework/ef6/modeling/code-first/data-annotations.md
@@ -0,0 +1,460 @@
+---
+title: Code First Data Annotations - EF6
+description: Code First Data Annotations in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/code-first/data-annotations
+---
+# Code First Data Annotations
+> [!NOTE]
+> **EF4.1 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 4.1. If you are using an earlier version, some or all of this information does not apply.
+
+The content on this page is adapted from an article originally written by Julie Lerman (\<http://thedatafarm.com>).
+
+Entity Framework Code First allows you to use your own domain classes to represent the model that EF relies on to perform querying, change tracking, and updating functions. Code First leverages a programming pattern referred to as 'convention over configuration.' Code First will assume that your classes follow the conventions of Entity Framework, and in that case, will automatically work out how to perform its job. However, if your classes do not follow those conventions, you have the ability to add configurations to your classes to provide EF with the requisite information.
+
+Code First gives you two ways to add these configurations to your classes. One is using simple attributes called DataAnnotations, and the second is using Code First’s Fluent API, which provides you with a way to describe configurations imperatively, in code.
+
+This article will focus on using DataAnnotations (in the System.ComponentModel.DataAnnotations namespace) to configure your classes – highlighting the most commonly needed configurations. DataAnnotations are also understood by a number of .NET applications, such as ASP.NET MVC which allows these applications to leverage the same annotations for client-side validations.
+
+
+## The model
+
+I’ll demonstrate Code First DataAnnotations with a simple pair of classes: Blog and Post.
+
+``` csharp
+    public class Blog
+    {
+        public int Id { get; set; }
+        public string Title { get; set; }
+        public string BloggerName { get; set;}
+        public virtual ICollection<Post> Posts { get; set; }
+    }
+
+    public class Post
+    {
+        public int Id { get; set; }
+        public string Title { get; set; }
+        public DateTime DateCreated { get; set; }
+        public string Content { get; set; }
+        public int BlogId { get; set; }
+        public ICollection<Comment> Comments { get; set; }
+    }
+```
+
+As they are, the Blog and Post classes conveniently follow code first convention and require no tweaks to enable EF compatibility. However, you can also use the annotations to provide more information to EF about the classes and the database to which they map.
+
+ 
+
+## Key
+
+Entity Framework relies on every entity having a key value that is used for entity tracking. One convention of Code First is implicit key properties; Code First will look for a property named “Id”, or a combination of class name and “Id”, such as “BlogId”. This property will map to a primary key column in the database.
+
+The Blog and Post classes both follow this convention. What if they didn’t? What if Blog used the name *PrimaryTrackingKey* instead, or even *foo*? If code first does not find a property that matches this convention it will throw an exception because of Entity Framework’s requirement that you must have a key property. You can use the key annotation to specify which property is to be used as the EntityKey.
+
+``` csharp
+    public class Blog
+    {
+        [Key]
+        public int PrimaryTrackingKey { get; set; }
+        public string Title { get; set; }
+        public string BloggerName { get; set;}
+        public virtual ICollection<Post> Posts { get; set; }
+    }
+```
+
+If you are using code first’s database generation feature, the Blog table will have a primary key column named PrimaryTrackingKey, which is also defined as Identity by default.
+
+![Blog table with primary key](~/ef6/media/jj591583-figure01.png)
+
+### Composite keys
+
+Entity Framework supports composite keys - primary keys that consist of more than one property. For example, you could have a Passport class whose primary key is a combination of PassportNumber and IssuingCountry.
+
+``` csharp
+    public class Passport
+    {
+        [Key]
+        public int PassportNumber { get; set; }
+        [Key]
+        public string IssuingCountry { get; set; }
+        public DateTime Issued { get; set; }
+        public DateTime Expires { get; set; }
+    }
+```
+
+Attempting to use the above class in your EF model would result in an `InvalidOperationException`:
+
+*Unable to determine composite primary key ordering for type 'Passport'. Use the ColumnAttribute or the HasKey method to specify an order for composite primary keys.*
+
+In order to use composite keys, Entity Framework requires you to define an order for the key properties. You can do this by using the Column annotation to specify an order.
+
+>[!NOTE]
+> The order value is relative (rather than index based) so any values can be used. For example, 100 and 200 would be acceptable in place of 1 and 2.
+
+``` csharp
+    public class Passport
+    {
+        [Key]
+        [Column(Order=1)]
+        public int PassportNumber { get; set; }
+        [Key]
+        [Column(Order = 2)]
+        public string IssuingCountry { get; set; }
+        public DateTime Issued { get; set; }
+        public DateTime Expires { get; set; }
+    }
+```
+
+If you have entities with composite foreign keys, then you must specify the same column ordering that you used for the corresponding primary key properties.
+
+Only the relative ordering within the foreign key properties needs to be the same, the exact values assigned to **Order** do not need to match. For example, in the following class, 3 and 4 could be used in place of 1 and 2.
+
+``` csharp
+    public class PassportStamp
+    {
+        [Key]
+        public int StampId { get; set; }
+        public DateTime Stamped { get; set; }
+        public string StampingCountry { get; set; }
+
+        [ForeignKey("Passport")]
+        [Column(Order = 1)]
+        public int PassportNumber { get; set; }
+
+        [ForeignKey("Passport")]
+        [Column(Order = 2)]
+        public string IssuingCountry { get; set; }
+
+        public Passport Passport { get; set; }
+    }
+```
+
+## Required
+
+The `Required` annotation tells EF that a particular property is required.
+
+Adding Required to the Title property will force EF (and MVC) to ensure that the property has data in it.
+
+``` csharp
+    [Required]
+    public string Title { get; set; }
+```
+
+With no additional code or markup changes in the application, an MVC application will perform client side validation, even dynamically building a message using the property and annotation names.
+
+![Create page with Title is required error](~/ef6/media/jj591583-figure02.png)
+
+The Required attribute will also affect the generated database by making the mapped property non-nullable. Notice that the Title field has changed to “not null”.
+
+>[!NOTE]
+> In some cases it may not be possible for the column in the database to be non-nullable even though the property is required. For example, when using a TPH inheritance strategy data for multiple types is stored in a single table. If a derived type includes a required property the column cannot be made non-nullable since not all types in the hierarchy will have this property.
+
+ 
+
+![Blogs table](~/ef6/media/jj591583-figure03.png)
+
+ 
+
+## MaxLength and MinLength
+
+The `MaxLength` and `MinLength` attributes allow you to specify additional property validations, just as you did with `Required`.
+
+Here is the BloggerName with length requirements. The example also demonstrates how to combine attributes.
+
+``` csharp
+    [MaxLength(10),MinLength(5)]
+    public string BloggerName { get; set; }
+```
+
+The MaxLength annotation will impact the database by setting the property’s length to 10.
+
+![Blogs table showing max length on BloggerName column](~/ef6/media/jj591583-figure04.png)
+
+MVC client-side annotation and EF 4.1 server-side annotation will both honor this validation, again dynamically building an error message: “The field BloggerName must be a string or array type with a maximum length of '10'.” That message is a little long. Many annotations let you specify an error message with the ErrorMessage attribute.
+
+``` csharp
+    [MaxLength(10, ErrorMessage="BloggerName must be 10 characters or less"),MinLength(5)]
+    public string BloggerName { get; set; }
+```
+
+You can also specify ErrorMessage in the Required annotation.
+
+![Create page with custom error message](~/ef6/media/jj591583-figure05.png)
+
+ 
+
+## NotMapped
+
+Code first convention dictates that every property that is of a supported data type is represented in the database. But this isn’t always the case in your applications. For example you might have a property in the Blog class that creates a code based on the Title and BloggerName fields. That property can be created dynamically and does not need to be stored. You can mark any properties that do not map to the database with the NotMapped annotation such as this BlogCode property.
+
+``` csharp
+    [NotMapped]
+    public string BlogCode
+    {
+        get
+        {
+            return Title.Substring(0, 1) + ":" + BloggerName.Substring(0, 1);
+        }
+    }
+```
+
+ 
+
+## ComplexType
+
+It’s not uncommon to describe your domain entities across a set of classes and then layer those classes to describe a complete entity. For example, you may add a class called BlogDetails to your model.
+
+``` csharp
+    public class BlogDetails
+    {
+        public DateTime? DateCreated { get; set; }
+
+        [MaxLength(250)]
+        public string Description { get; set; }
+    }
+```
+
+Notice that `BlogDetails` does not have any type of key property. In domain driven design, `BlogDetails` is referred to as a value object. Entity Framework refers to value objects as complex types.  Complex types cannot be tracked on their own.
+
+However as a property in the `Blog` class, `BlogDetails` will be tracked as part of a `Blog` object. In order for code first to recognize this, you must mark the `BlogDetails` class as a `ComplexType`.
+
+``` csharp
+    [ComplexType]
+    public class BlogDetails
+    {
+        public DateTime? DateCreated { get; set; }
+
+        [MaxLength(250)]
+        public string Description { get; set; }
+    }
+```
+
+Now you can add a property in the `Blog` class to represent the `BlogDetails` for that blog.
+
+``` csharp
+        public BlogDetails BlogDetail { get; set; }
+```
+
+In the database, the `Blog` table will contain all of the properties of the blog including the properties contained in its `BlogDetail` property. By default, each one is preceded with the name of the complex type, "BlogDetail".
+
+![Blog table with complex type](~/ef6/media/jj591583-figure06.png)
+
+
+## ConcurrencyCheck
+
+The `ConcurrencyCheck` annotation allows you to flag one or more properties to be used for concurrency checking in the database when a user edits or deletes an entity. If you've been working with the EF Designer, this aligns with setting a property's `ConcurrencyMode` to `Fixed`.
+
+Let’s see how `ConcurrencyCheck` works by adding it to the `BloggerName` property.
+
+``` csharp
+    [ConcurrencyCheck, MaxLength(10, ErrorMessage="BloggerName must be 10 characters or less"),MinLength(5)]
+    public string BloggerName { get; set; }
+```
+
+When `SaveChanges` is called, because of the `ConcurrencyCheck` annotation on the `BloggerName` field, the original value of that property will be used in the update. The command will attempt to locate the correct row by filtering not only on the key value but also on the original value of `BloggerName`.  Here are the critical parts of the UPDATE command sent to the database, where you can see the command will update the row that has a `PrimaryTrackingKey` is 1 and a `BloggerName` of “Julie” which was the original value when that blog was retrieved from the database.
+
+``` SQL
+    where (([PrimaryTrackingKey] = @4) and ([BloggerName] = @5))
+    @4=1,@5=N'Julie'
+```
+
+If someone has changed the blogger name for that blog in the meantime, this update will fail and you’ll get a **DbUpdateConcurrencyException** that you'll need to handle.
+
+ 
+
+## TimeStamp
+
+It's more common to use rowversion or timestamp fields for concurrency checking. But rather than using the `ConcurrencyCheck` annotation, you can use the more specific `TimeStamp` annotation as long as the type of the property is byte array. Code first will treat `Timestamp` properties the same as `ConcurrencyCheck` properties, but it will also ensure that the database field that code first generates is non-nullable. You can only have one timestamp property in a given class.
+
+Adding the following property to the Blog class:
+
+``` csharp
+    [Timestamp]
+    public Byte[] TimeStamp { get; set; }
+```
+
+results in code first creating a non-nullable timestamp column in the database table.
+
+![Blogs table with time stamp column](~/ef6/media/jj591583-figure07.png)
+
+ 
+
+## Table and Column
+
+If you are letting Code First create the database, you may want to change the name of the tables and columns it is creating. You can also use Code First with an existing database. But it's not always the case that the names of the classes and properties in your domain match the names of the tables and columns in your database.
+
+My class is named `Blog` and by convention, code first presumes this will map to a table named `Blogs`. If that's not the case you can specify the name of the table with the `Table` attribute. Here for example, the annotation is specifying that the table name is **InternalBlogs**.
+
+``` csharp
+    [Table("InternalBlogs")]
+    public class Blog
+```
+
+The `Column` annotation is a more adept in specifying the attributes of a mapped column. You can stipulate a name, data type or even the order in which a column appears in the table. Here is an example of the `Column` attribute.
+
+``` csharp
+    [Column("BlogDescription", TypeName="ntext")]
+    public String Description {get;set;}
+```
+
+Don’t confuse Column’s `TypeName` attribute with the DataType DataAnnotation. DataType is an annotation used for the UI and is ignored by Code First.
+
+Here is the table after it’s been regenerated. The table name has changed to **InternalBlogs** and `Description` column from the complex type is now `BlogDescription`. Because the name was specified in the annotation, code first will not use the convention of starting the column name with the name of the complex type.
+
+![Blogs table and column renamed](~/ef6/media/jj591583-figure08.png)
+
+ 
+
+## DatabaseGenerated
+
+An important database features is the ability to have computed properties. If you're mapping your Code First classes to tables that contain computed columns, you don't want Entity Framework to try to update those columns. But you do want EF to return those values from the database after you've inserted or updated data. You can use the `DatabaseGenerated` annotation to flag those properties in your class along with the `Computed` enum. Other enums are `None` and `Identity`.
+
+``` csharp
+    [DatabaseGenerated(DatabaseGeneratedOption.Computed)]
+    public DateTime DateCreated { get; set; }
+```
+
+You can use database generated on byte or timestamp columns when code first is generating the database, otherwise you should only use this when pointing to existing databases because code first won't be able to determine the formula for the computed column.
+
+You read above that by default, a key property that is an integer will become an identity key in the database. That would be the same as setting `DatabaseGenerated` to `DatabaseGeneratedOption.Identity`. If you do not want it to be an identity key, you can set the value to `DatabaseGeneratedOption.None`.
+
+ 
+
+## Index
+
+> [!NOTE]
+> **EF6.1 Onwards Only** - The `Index` attribute was introduced in Entity Framework 6.1. If you are using an earlier version the information in this section does not apply.
+
+You can create an index on one or more columns using the **IndexAttribute**. Adding the attribute to one or more properties will cause EF to create the corresponding index in the database when it creates the database, or scaffold the corresponding **CreateIndex** calls if you are using Code First Migrations.
+
+For example, the following code will result in an index being created on the `Rating` column of the `Posts` table in the database.
+
+``` csharp
+    public class Post
+    {
+        public int Id { get; set; }
+        public string Title { get; set; }
+        public string Content { get; set; }
+        [Index]
+        public int Rating { get; set; }
+        public int BlogId { get; set; }
+    }
+```
+
+By default, the index will be named **IX\_&lt;property name&gt;** (IX\_Rating in the above example). You can also specify a name for the index though. The following example specifies that the index should be named `PostRatingIndex`.
+
+``` csharp
+    [Index("PostRatingIndex")]
+    public int Rating { get; set; }
+```
+
+By default, indexes are non-unique, but you can use the `IsUnique` named parameter to specify that an index should be unique. The following example introduces a unique index on a `User`'s login name.
+
+``` csharp
+    public class User
+    {
+        public int UserId { get; set; }
+
+        [Index(IsUnique = true)]
+        [StringLength(200)]
+        public string Username { get; set; }
+
+        public string DisplayName { get; set; }
+    }
+```
+
+### Multiple-Column Indexes
+
+Indexes that span multiple columns are specified by using the same name in multiple Index annotations for a given table. When you create multi-column indexes, you need to specify an order for the columns in the index. For example, the following code creates a multi-column index on `Rating` and `BlogId` called **IX\_BlogIdAndRating**. `BlogId` is the first column in the index and `Rating` is the second.
+
+``` csharp
+    public class Post
+    {
+        public int Id { get; set; }
+        public string Title { get; set; }
+        public string Content { get; set; }
+        [Index("IX_BlogIdAndRating", 2)]
+        public int Rating { get; set; }
+        [Index("IX_BlogIdAndRating", 1)]
+        public int BlogId { get; set; }
+    }
+```
+
+ 
+
+## Relationship Attributes: InverseProperty and ForeignKey
+
+> [!NOTE]
+> This page provides information about setting up relationships in your Code First model using Data Annotations. For general information about relationships in EF and how to access and manipulate data using relationships, see [Relationships & Navigation Properties](xref:ef6/fundamentals/relationships).*
+
+Code first convention will take care of the most common relationships in your model, but there are some cases where it needs help.
+
+Changing the name of the key property in the `Blog` class created a problem with its relationship to `Post`. 
+
+When generating the database, code first sees the `BlogId` property in the Post class and recognizes it, by the convention that it matches a class name plus **Id**, as a foreign key to the `Blog` class. But there is no `BlogId` property in the blog class. The solution for this is to create a navigation property in the `Post` and use the `ForeignKey` DataAnnotation to help code first understand how to build the relationship between the two classes (using the `Post.BlogId` property) as well as how to specify constraints in the database.
+
+``` csharp
+    public class Post
+    {
+            public int Id { get; set; }
+            public string Title { get; set; }
+            public DateTime DateCreated { get; set; }
+            public string Content { get; set; }
+            public int BlogId { get; set; }
+            [ForeignKey("BlogId")]
+            public Blog Blog { get; set; }
+            public ICollection<Comment> Comments { get; set; }
+    }
+```
+
+The constraint in the database shows a relationship between `InternalBlogs.PrimaryTrackingKey` and `Posts.BlogId`. 
+
+![relationship between InternalBlogs.PrimaryTrackingKey and Posts.BlogId](~/ef6/media/jj591583-figure09.png)
+
+The `InverseProperty` is used when you have multiple relationships between classes.
+
+In the `Post` class, you may want to keep track of who wrote a blog post as well as who edited it. Here are two new navigation properties for the Post class.
+
+``` csharp
+    public Person CreatedBy { get; set; }
+    public Person UpdatedBy { get; set; }
+```
+
+You’ll also need to add in the `Person` class referenced by these properties. The `Person` class has navigation properties back to the `Post`, one for all of the posts written by the person and one for all of the posts updated by that person.
+
+``` csharp
+    public class Person
+    {
+            public int Id { get; set; }
+            public string Name { get; set; }
+            public List<Post> PostsWritten { get; set; }
+            public List<Post> PostsUpdated { get; set; }
+    }
+```
+
+Code first is not able to match up the properties in the two classes on its own. The database table for `Posts` should have one foreign key for the `CreatedBy` person and one for the `UpdatedBy` person but code first will create four foreign key properties: **Person\_Id**, **Person\_Id1**, **CreatedBy\_Id** and **UpdatedBy\_Id**.
+
+![Posts table with extra foreign keys](~/ef6/media/jj591583-figure10.png)
+
+To fix these problems, you can use the `InverseProperty` annotation to specify the alignment of the properties.
+
+``` csharp
+    [InverseProperty("CreatedBy")]
+    public List<Post> PostsWritten { get; set; }
+
+    [InverseProperty("UpdatedBy")]
+    public List<Post> PostsUpdated { get; set; }
+```
+
+Because the `PostsWritten` property in Person knows that this refers to the `Post` type, it will build the relationship to `Post.CreatedBy`. Similarly, `PostsUpdated` will be connected to `Post.UpdatedBy`. And code first will not create the extra foreign keys.
+
+![Posts table without extra foreign keys](~/ef6/media/jj591583-figure11.png)
+
+ 
+
+## Summary
+
+DataAnnotations not only let you describe client and server side validation in your code first classes, but they also allow you to enhance and even correct the assumptions that code first will make about your classes based on its conventions. With DataAnnotations you can not only drive database schema generation, but you can also map your code first classes to a pre-existing database.
+
+While they are very flexible, keep in mind that DataAnnotations provide only the most commonly needed configuration changes you can make on your code first classes. To configure your classes for some of the edge cases, you should look to the alternate configuration mechanism, Code First’s Fluent API .
diff --git a/entity-framework/ef6/modeling/code-first/data-types/enums.md b/entity-framework/ef6/modeling/code-first/data-types/enums.md
new file mode 100644
index 0000000000..42ba2afeb8
--- /dev/null
+++ b/entity-framework/ef6/modeling/code-first/data-types/enums.md
@@ -0,0 +1,143 @@
+---
+title: Enum Support - Code First - EF6
+description: Enum Support - Code First in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/code-first/data-types/enums
+---
+# Enum Support - Code First
+> [!NOTE]
+> **EF5 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 5. If you are using an earlier version, some or all of the information does not apply.
+
+This video and step-by-step walkthrough shows how to use enum types with Entity Framework Code First. It also demonstrates how to use enums in a LINQ query.
+
+This walkthrough will use Code First to create a new database, but you can also use [Code First to map to an existing database](xref:ef6/modeling/code-first/workflows/existing-database).
+
+Enum support was introduced in Entity Framework 5. To use the new features like enums, spatial data types, and table-valued functions, you must target .NET Framework 4.5. Visual Studio 2012 targets .NET 4.5 by default.
+
+In Entity Framework, an enumeration can have the following underlying types: **Byte**, **Int16**, **Int32**, **Int64** , or **SByte**.
+
+## Watch the video
+This video shows how to use enum types with Entity Framework Code First. It also demonstrates how to use enums in a LINQ query.
+
+**Presented By**: Julia Kornich
+
+**Video**: [WMV](https://download.microsoft.com/download/A/5/8/A583DEE8-FD5C-47EE-A4E1-966DDF39D1DA/HDI-ITPro-MSDN-winvideo-enumwithcodefirst.wmv) | [MP4](https://download.microsoft.com/download/A/5/8/A583DEE8-FD5C-47EE-A4E1-966DDF39D1DA/HDI-ITPro-MSDN-mp4video-enumwithcodefirst.m4v) | [WMV (ZIP)](https://download.microsoft.com/download/A/5/8/A583DEE8-FD5C-47EE-A4E1-966DDF39D1DA/HDI-ITPro-MSDN-winvideo-enumwithcodefirst.zip)
+
+## Pre-Requisites
+
+You will need to have Visual Studio 2012, Ultimate, Premium, Professional, or Web Express edition installed to complete this walkthrough.
+
+ 
+
+## Set up the Project
+
+1.  Open Visual Studio 2012
+2.  On the **File** menu, point to **New**, and then click **Project**
+3.  In the left pane, click **Visual C\#**, and then select the **Console** template
+4.  Enter **EnumCodeFirst** as the name of the project and click **OK**
+
+## Define a New Model using Code First
+
+When using Code First development you usually begin by writing .NET Framework classes that define your conceptual (domain) model. The code below defines the Department class.
+
+The code also defines the DepartmentNames enumeration. By default, the enumeration is of **int** type. The Name property on the Department class is of the DepartmentNames type.
+
+Open the Program.cs file and paste the following class definitions.
+
+``` csharp
+public enum DepartmentNames
+{
+    English,
+    Math,
+    Economics
+}     
+
+public partial class Department
+{
+    public int DepartmentID { get; set; }
+    public DepartmentNames Name { get; set; }
+    public decimal Budget { get; set; }
+}
+```
+ 
+
+## Define the DbContext Derived Type
+
+In addition to defining entities, you need to define a class that derives from DbContext and exposes DbSet&lt;TEntity&gt; properties. The DbSet&lt;TEntity&gt; properties let the context know which types you want to include in the model.
+
+An instance of the DbContext derived type manages the entity objects during run time, which includes populating objects with data from a database, change tracking, and persisting data to the database.
+
+The DbContext and DbSet types are defined in the EntityFramework assembly. We will add a reference to this DLL by using the EntityFramework NuGet package.
+
+1.  In Solution Explorer, right-click on the project name.
+2.  Select **Manage NuGet Packages…**
+3.  In the Manage NuGet Packages dialog, Select the **Online** tab and choose the **EntityFramework** package.
+4.  Click **Install**
+
+Note, that in addition to the EntityFramework  assembly, references to System.ComponentModel.DataAnnotations and System.Data.Entity assemblies are added as well.
+
+At the top of the Program.cs file, add the following using statement:
+
+``` csharp
+using System.Data.Entity;
+```
+
+In the Program.cs add the context definition. 
+
+``` csharp
+public partial class EnumTestContext : DbContext
+{
+    public DbSet<Department> Departments { get; set; }
+}
+```
+ 
+
+## Persist and Retrieve Data
+
+Open the Program.cs file where the Main method is defined. Add the following code into the Main function. The code adds a new Department object to the context. It then saves the data. The code also executes a LINQ query that returns a Department where the name is DepartmentNames.English.
+
+``` csharp
+using (var context = new EnumTestContext())
+{
+    context.Departments.Add(new Department { Name = DepartmentNames.English });
+
+    context.SaveChanges();
+
+    var department = (from d in context.Departments
+                        where d.Name == DepartmentNames.English
+                        select d).FirstOrDefault();
+
+    Console.WriteLine(
+        "DepartmentID: {0} Name: {1}",
+        department.DepartmentID,  
+        department.Name);
+}
+```
+
+Compile and run the application. The program produces the following output:
+
+``` csharp
+DepartmentID: 1 Name: English
+```
+ 
+
+## View the Generated Database
+
+When you run the application the first time, the Entity Framework creates a database for you. Because we have Visual Studio 2012 installed, the database will be created on the LocalDB instance. By default, the Entity Framework names the database after the fully qualified name of the derived context (for this example that is **EnumCodeFirst.EnumTestContext**). The subsequent times the existing database will be used.  
+
+Note, that if you make any changes to your model after the database has been created, you should use Code First Migrations to update the database schema. See [Code First to a New Database](xref:ef6/modeling/code-first/workflows/new-database) for an example of using Migrations.
+
+To view the database and data, do the following:
+
+1.  In the Visual Studio 2012 main menu, select **View** -&gt; **SQL Server Object Explorer**.
+2.  If LocalDB is not in the list of servers, click the right mouse button on **SQL Server** and select **Add SQL Server**
+    Use the default **Windows Authentication** to connect to the LocalDB instance
+3.  Expand the LocalDB node
+4.  Unfold the **Databases** folder to see the new database and browse to the **Department** table
+    Note, that Code First does not create a table that maps to the enumeration type
+5.  To view data, right-click on the table and select **View Data**
+
+## Summary
+
+In this walkthrough we looked at how to use enum types with Entity Framework Code First. 
diff --git a/entity-framework/ef6/modeling/code-first/data-types/spatial.md b/entity-framework/ef6/modeling/code-first/data-types/spatial.md
new file mode 100644
index 0000000000..fb4f87eb57
--- /dev/null
+++ b/entity-framework/ef6/modeling/code-first/data-types/spatial.md
@@ -0,0 +1,151 @@
+---
+title: Spatial - Code First - EF6
+description: Spatial - Code First in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/code-first/data-types/spatial
+---
+# Spatial - Code First
+> [!NOTE]
+> **EF5 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 5. If you are using an earlier version, some or all of the information does not apply.
+
+The video and step-by-step walkthrough shows how to map spatial types with Entity Framework Code First. It also demonstrates how to use a LINQ query to find a distance between two locations.
+
+This walkthrough will use Code First to create a new database, but you can also use [Code First to an existing database](xref:ef6/modeling/code-first/workflows/existing-database).
+
+Spatial type support was introduced in Entity Framework 5. Note that to use the new features like spatial type, enums, and Table-valued functions, you must target .NET Framework 4.5. Visual Studio 2012 targets .NET 4.5 by default.
+
+To use spatial data types you must also use an Entity Framework provider that has spatial support. See [provider support for spatial types](xref:ef6/fundamentals/providers/spatial-support) for more information.
+
+There are two main spatial data types: geography and geometry. The geography data type stores ellipsoidal data (for example, GPS latitude and longitude coordinates). The geometry data type represents Euclidean (flat) coordinate system.
+
+## Watch the video
+This video shows how to map spatial types with Entity Framework Code First. It also demonstrates how to use a LINQ query to find a distance between two locations.
+
+**Presented By**: Julia Kornich
+
+**Video**: [WMV](https://download.microsoft.com/download/9/1/3/913EA17E-6F97-41D8-A4FE-805A0D83D26A/HDI-ITPro-MSDN-winvideo-spatialwithcodefirst.wmv) | [MP4](https://download.microsoft.com/download/9/1/3/913EA17E-6F97-41D8-A4FE-805A0D83D26A/HDI-ITPro-MSDN-mp4video-spatialwithcodefirst.m4v) | [WMV (ZIP)](https://download.microsoft.com/download/9/1/3/913EA17E-6F97-41D8-A4FE-805A0D83D26A/HDI-ITPro-MSDN-winvideo-spatialwithcodefirst.zip)
+
+## Pre-Requisites
+
+You will need to have Visual Studio 2012, Ultimate, Premium, Professional, or Web Express edition installed to complete this walkthrough.
+
+## Set up the Project
+
+1.  Open Visual Studio 2012
+2.  On the **File** menu, point to **New**, and then click **Project**
+3.  In the left pane, click **Visual C\#**, and then select the **Console** template
+4.  Enter **SpatialCodeFirst** as the name of the project and click **OK**
+
+## Define a New Model using Code First
+
+When using Code First development you usually begin by writing .NET Framework classes that define your conceptual (domain) model. The code below defines the University class.
+
+The University has the Location property of the DbGeography type. To use the DbGeography type, you must add a reference to the System.Data.Entity assembly and also add the System.Data.Spatial using statement.
+
+Open the Program.cs file and paste the following using statements at the top of the file:
+
+``` csharp
+using System.Data.Spatial;
+```
+
+Add the following University class definition to the Program.cs file.
+
+``` csharp
+public class University  
+{
+    public int UniversityID { get; set; }
+    public string Name { get; set; }
+    public DbGeography Location { get; set; }
+}
+```
+
+## Define the DbContext Derived Type
+
+In addition to defining entities, you need to define a class that derives from DbContext and exposes DbSet&lt;TEntity&gt; properties. The DbSet&lt;TEntity&gt; properties let the context know which types you want to include in the model.
+
+An instance of the DbContext derived type manages the entity objects during run time, which includes populating objects with data from a database, change tracking, and persisting data to the database.
+
+The DbContext and DbSet types are defined in the EntityFramework assembly. We will add a reference to this DLL by using the EntityFramework NuGet package.
+
+1.  In Solution Explorer, right-click on the project name.
+2.  Select **Manage NuGet Packages…**
+3.  In the Manage NuGet Packages dialog, Select the **Online** tab and choose the **EntityFramework** package.
+4.  Click **Install**
+
+Note, that in addition to the EntityFramework  assembly, a reference to the System.ComponentModel.DataAnnotations assembly is also added.
+
+At the top of the Program.cs file, add the following using statement:
+
+``` csharp
+using System.Data.Entity;
+```
+
+In the Program.cs add the context definition. 
+
+``` csharp
+public partial class UniversityContext : DbContext
+{
+    public DbSet<University> Universities { get; set; }
+}
+```
+
+## Persist and Retrieve Data
+
+Open the Program.cs file where the Main method is defined. Add the following code into the Main function.
+
+The code adds two new University objects to the context. Spatial properties are initialized by using the DbGeography.FromText method. The geography point represented as WellKnownText is passed to the method. The code then saves the data. Then, the LINQ query that that returns a University object where its location is closest to the specified location, is constructed and executed.
+
+``` csharp
+using (var context = new UniversityContext ())
+{
+    context.Universities.Add(new University()
+        {
+            Name = "Graphic Design Institute",
+            Location = DbGeography.FromText("POINT(-122.336106 47.605049)"),
+        });
+
+    context. Universities.Add(new University()
+        {
+            Name = "School of Fine Art",
+            Location = DbGeography.FromText("POINT(-122.335197 47.646711)"),
+        });
+
+    context.SaveChanges();
+
+    var myLocation = DbGeography.FromText("POINT(-122.296623 47.640405)");
+
+    var university = (from u in context.Universities
+                        orderby u.Location.Distance(myLocation)
+                        select u).FirstOrDefault();
+
+    Console.WriteLine(
+        "The closest University to you is: {0}.",
+        university.Name);
+}
+```
+
+Compile and run the application. The program produces the following output:
+
+```console
+The closest University to you is: School of Fine Art.
+```
+
+## View the Generated Database
+
+When you run the application the first time, the Entity Framework creates a database for you. Because we have Visual Studio 2012 installed, the database will be created on the LocalDB instance. By default, the Entity Framework names the database after the fully qualified name of the derived context (in this example that is **SpatialCodeFirst.UniversityContext**). The subsequent times the existing database will be used.  
+
+Note, that if you make any changes to your model after the database has been created, you should use Code First Migrations to update the database schema. See [Code First to a New Database](xref:ef6/modeling/code-first/workflows/new-database) for an example of using Migrations.
+
+To view the database and data, do the following:
+
+1.  In the Visual Studio 2012 main menu, select **View** -&gt; **SQL Server Object Explorer**.
+2.  If LocalDB is not in the list of servers, click the right mouse button on **SQL Server** and select **Add SQL Server**
+    Use the default **Windows Authentication** to connect to the LocalDB instance
+3.  Expand the LocalDB node
+4.  Unfold the **Databases** folder to see the new database and browse to the **Universities** table
+5.  To view data, right-click on the table and select **View Data**
+
+## Summary
+
+In this walkthrough we looked at how to use spatial types with Entity Framework Code First. 
diff --git a/entity-framework/ef6/modeling/code-first/dbsets.md b/entity-framework/ef6/modeling/code-first/dbsets.md
new file mode 100644
index 0000000000..76b8256ffe
--- /dev/null
+++ b/entity-framework/ef6/modeling/code-first/dbsets.md
@@ -0,0 +1,60 @@
+---
+title: Defining DbSets - EF6
+description: Defining DbSets in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/code-first/dbsets
+---
+# Defining DbSets
+When developing with the Code First workflow you define a derived DbContext that represents your session with the database and exposes a DbSet for each type in your model. This topic covers the various ways you can define the DbSet properties.  
+
+## DbContext with DbSet properties  
+
+The common case shown in Code First examples is to have a DbContext with public automatic DbSet properties for the entity types of your model. For example:  
+
+``` csharp
+public class BloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+}
+```  
+
+When used in Code First mode, this will configure Blogs and Posts as entity types, as well as configuring other types reachable from these. In addition DbContext will automatically call the setter for each of these properties to set an instance of the appropriate DbSet.  
+
+## DbContext with IDbSet properties  
+
+There are situations, such as when creating mocks or fakes, where it is more useful to declare your set properties using an interface. In such cases the IDbSet interface can be used in place of DbSet. For example:  
+
+``` csharp
+public class BloggingContext : DbContext
+{
+    public IDbSet<Blog> Blogs { get; set; }
+    public IDbSet<Post> Posts { get; set; }
+}
+```  
+
+This context works in exactly the same way as the context that uses the DbSet class for its set properties.  
+
+## DbContext with read-only set properties  
+
+If you do not wish to expose public setters for your DbSet or IDbSet properties you can instead create read-only properties and create the set instances yourself. For example:  
+
+``` csharp
+public class BloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs
+    {
+        get { return Set<Blog>(); }
+    }
+
+    public DbSet<Post> Posts
+    {
+        get { return Set<Post>(); }
+    }
+}
+```  
+
+Note that DbContext caches the instance of DbSet returned from the Set method so that each of these properties will return the same instance every time it is called.  
+
+Discovery of entity types for Code First works in the same way here as it does for properties with public getters and setters.  
diff --git a/entity-framework/ef6/modeling/code-first/fluent/cud-stored-procedures.md b/entity-framework/ef6/modeling/code-first/fluent/cud-stored-procedures.md
new file mode 100644
index 0000000000..52936ce336
--- /dev/null
+++ b/entity-framework/ef6/modeling/code-first/fluent/cud-stored-procedures.md
@@ -0,0 +1,364 @@
+---
+title: Code First Insert, Update, and Delete Stored Procedures - EF6
+description: Code First Insert, Update, and Delete Stored Procedures in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/code-first/fluent/cud-stored-procedures
+---
+# Code First Insert, Update, and Delete Stored Procedures
+> [!NOTE]
+> **EF6 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 6. If you are using an earlier version, some or all of the information does not apply.  
+
+By default, Code First will configure all entities to perform insert, update and delete commands using direct table access. Starting in EF6 you can configure your Code First model to use stored procedures for some or all entities in your model.  
+
+## Basic Entity Mapping  
+
+You can opt into using stored procedures for insert, update and delete using the Fluent API.  
+
+``` csharp
+modelBuilder
+  .Entity<Blog>()
+  .MapToStoredProcedures();
+```  
+
+Doing this will cause Code First to use some conventions to build the expected shape of the stored procedures in the database.  
+
+- Three stored procedures named **\<type_name\>_Insert**, **\<type_name\>_Update** and **\<type_name\>_Delete** (for example, Blog_Insert, Blog_Update and Blog_Delete).  
+- Parameter names correspond to the property names.  
+  > [!NOTE]
+  > If you use HasColumnName() or the Column attribute to rename the column for a given property then this name is used for parameters instead of the property name.  
+- **The insert stored procedure** will have a parameter for every property, except for those marked as store generated (identity or computed). The stored procedure should return a result set with a column for each store generated property.  
+- **The update stored procedure** will have a parameter for every property, except for those marked with a store generated pattern of 'Computed'. Some concurrency tokens require a parameter for the original value, see the *Concurrency Tokens* section below for details. The stored procedure should return a result set with a column for each computed property.  
+- **The delete stored procedure** should have a parameter for the key value of the entity (or multiple parameters if the entity has a composite key). Additionally, the delete procedure should also have parameters for any independent association foreign keys on the target table (relationships that do not have corresponding foreign key properties declared in the entity). Some concurrency tokens require a parameter for the original value, see the *Concurrency Tokens* section below for details.  
+
+Using the following class as an example:  
+
+``` csharp
+public class Blog  
+{  
+  public int BlogId { get; set; }  
+  public string Name { get; set; }  
+  public string Url { get; set; }  
+}
+```  
+
+The default stored procedures would be:  
+
+``` SQL
+CREATE PROCEDURE [dbo].[Blog_Insert]  
+  @Name nvarchar(max),  
+  @Url nvarchar(max)  
+AS  
+BEGIN
+  INSERT INTO [dbo].[Blogs] ([Name], [Url])
+  VALUES (@Name, @Url)
+
+  SELECT SCOPE_IDENTITY() AS BlogId
+END
+CREATE PROCEDURE [dbo].[Blog_Update]  
+  @BlogId int,  
+  @Name nvarchar(max),  
+  @Url nvarchar(max)  
+AS  
+  UPDATE [dbo].[Blogs]
+  SET [Name] = @Name, [Url] = @Url     
+  WHERE BlogId = @BlogId;
+CREATE PROCEDURE [dbo].[Blog_Delete]  
+  @BlogId int  
+AS  
+  DELETE FROM [dbo].[Blogs]
+  WHERE BlogId = @BlogId
+```  
+
+### Overriding the Defaults  
+
+You can override part or all of what was configured by default.  
+
+You can change the name of one or more stored procedures. This example renames the update stored procedure only.  
+
+``` csharp
+modelBuilder  
+  .Entity<Blog>()  
+  .MapToStoredProcedures(s =>  
+    s.Update(u => u.HasName("modify_blog")));
+```  
+
+This example renames all three stored procedures.  
+
+``` csharp
+modelBuilder  
+  .Entity<Blog>()  
+  .MapToStoredProcedures(s =>  
+    s.Update(u => u.HasName("modify_blog"))  
+     .Delete(d => d.HasName("delete_blog"))  
+     .Insert(i => i.HasName("insert_blog")));
+```  
+
+In these examples the calls are chained together, but you can also use lambda block syntax.  
+
+``` csharp
+modelBuilder  
+  .Entity<Blog>()  
+  .MapToStoredProcedures(s =>  
+    {  
+      s.Update(u => u.HasName("modify_blog"));  
+      s.Delete(d => d.HasName("delete_blog"));  
+      s.Insert(i => i.HasName("insert_blog"));  
+    });
+```  
+
+This example renames the parameter for the BlogId property on the update stored procedure.  
+
+``` csharp
+modelBuilder  
+  .Entity<Blog>()  
+  .MapToStoredProcedures(s =>  
+    s.Update(u => u.Parameter(b => b.BlogId, "blog_id")));
+```  
+
+These calls are all chainable and composable. Here is an example that renames all three stored procedures and their parameters.  
+
+``` csharp
+modelBuilder  
+  .Entity<Blog>()  
+  .MapToStoredProcedures(s =>  
+    s.Update(u => u.HasName("modify_blog")  
+                   .Parameter(b => b.BlogId, "blog_id")  
+                   .Parameter(b => b.Name, "blog_name")  
+                   .Parameter(b => b.Url, "blog_url"))  
+     .Delete(d => d.HasName("delete_blog")  
+                   .Parameter(b => b.BlogId, "blog_id"))  
+     .Insert(i => i.HasName("insert_blog")  
+                   .Parameter(b => b.Name, "blog_name")  
+                   .Parameter(b => b.Url, "blog_url")));
+```  
+
+You can also change the name of the columns in the result set that contains database generated values.  
+
+``` csharp
+modelBuilder
+  .Entity<Blog>()
+  .MapToStoredProcedures(s =>
+    s.Insert(i => i.Result(b => b.BlogId, "generated_blog_identity")));
+```
+
+``` SQL
+CREATE PROCEDURE [dbo].[Blog_Insert]  
+  @Name nvarchar(max),  
+  @Url nvarchar(max)  
+AS  
+BEGIN
+  INSERT INTO [dbo].[Blogs] ([Name], [Url])
+  VALUES (@Name, @Url)
+
+  SELECT SCOPE_IDENTITY() AS generated_blog_id
+END
+```  
+
+## Relationships Without a Foreign Key in the Class (Independent Associations)  
+
+When a foreign key property is included in the class definition, the corresponding parameter can be renamed in the same way as any other property. When a relationship exists without a foreign key property in the class, the default parameter name is **\<navigation_property_name\>_\<primary_key_name\>**.  
+
+For example, the following class definitions would result in a Blog_BlogId parameter being expected in the stored procedures to insert and update Posts.  
+
+``` csharp
+public class Blog  
+{  
+  public int BlogId { get; set; }  
+  public string Name { get; set; }  
+  public string Url { get; set; }
+
+  public List<Post> Posts { get; set; }  
+}  
+
+public class Post  
+{  
+  public int PostId { get; set; }  
+  public string Title { get; set; }  
+  public string Content { get; set; }  
+
+  public Blog Blog { get; set; }  
+}
+```  
+
+### Overriding the Defaults  
+
+You can change parameters for foreign keys that are not included in the class by supplying the path to the primary key property to the Parameter method.  
+
+``` csharp
+modelBuilder
+  .Entity<Post>()  
+  .MapToStoredProcedures(s =>  
+    s.Insert(i => i.Parameter(p => p.Blog.BlogId, "blog_id")));
+```  
+
+If you don’t have a navigation property on the dependent entity (i.e no Post.Blog property) then you can use the Association method to identify the other end of the relationship and then configure the parameters that correspond to each of the key property(s).  
+
+``` csharp
+modelBuilder
+  .Entity<Post>()  
+  .MapToStoredProcedures(s =>  
+    s.Insert(i => i.Navigation<Blog>(  
+      b => b.Posts,  
+      c => c.Parameter(b => b.BlogId, "blog_id"))));
+```  
+
+## Concurrency Tokens  
+
+Update and delete stored procedures may also need to deal with concurrency:  
+
+- If the entity contains concurrency tokens, the stored procedure can optionally have an output parameter that returns the number of rows updated/deleted (rows affected). Such a parameter must be configured using the RowsAffectedParameter method.  
+By default EF uses the return value from ExecuteNonQuery to determine how many rows were affected. Specifying a rows affected output parameter is useful if you perform any logic in your sproc that would result in the return value of ExecuteNonQuery being incorrect (from EF's perspective) at the end of execution.  
+- For each concurrency token there will be a parameter named **\<property_name\>_Original** (for example, Timestamp_Original ). This will be passed the original value of this property – the value when queried from the database.  
+    - Concurrency tokens that are computed by the database – such as timestamps – will only have an original value parameter.  
+    - Non-computed properties that are set as concurrency tokens will also have a parameter for the new value in the update procedure. This uses the naming conventions already discussed for new values. An example of such a token would be using a Blog's URL as a concurrency token, the new value is required because this can be updated to a new value by your code (unlike a Timestamp token which is only updated by the database).  
+
+This is an example class and update stored procedure with a timestamp concurrency token.  
+
+``` csharp
+public class Blog  
+{  
+  public int BlogId { get; set; }  
+  public string Name { get; set; }  
+  public string Url { get; set; }  
+  [Timestamp]
+  public byte[] Timestamp { get; set; }
+}
+```
+
+``` SQL
+CREATE PROCEDURE [dbo].[Blog_Update]  
+  @BlogId int,  
+  @Name nvarchar(max),  
+  @Url nvarchar(max),
+  @Timestamp_Original rowversion  
+AS  
+  UPDATE [dbo].[Blogs]
+  SET [Name] = @Name, [Url] = @Url     
+  WHERE BlogId = @BlogId AND [Timestamp] = @Timestamp_Original
+```  
+
+Here is an example class and update stored procedure with non-computed concurrency token.  
+
+``` csharp
+public class Blog  
+{  
+  public int BlogId { get; set; }  
+  public string Name { get; set; }  
+  [ConcurrencyCheck]
+  public string Url { get; set; }  
+}
+```
+
+``` SQL
+CREATE PROCEDURE [dbo].[Blog_Update]  
+  @BlogId int,  
+  @Name nvarchar(max),  
+  @Url nvarchar(max),
+  @Url_Original nvarchar(max),
+AS  
+  UPDATE [dbo].[Blogs]
+  SET [Name] = @Name, [Url] = @Url     
+  WHERE BlogId = @BlogId AND [Url] = @Url_Original
+```  
+
+### Overriding the Defaults  
+
+You can optionally introduce a rows affected parameter.  
+
+``` csharp
+modelBuilder  
+  .Entity<Blog>()  
+  .MapToStoredProcedures(s =>  
+    s.Update(u => u.RowsAffectedParameter("rows_affected")));
+```  
+
+For database computed concurrency tokens – where only the original value is passed – you can just use the standard parameter renaming mechanism to rename the parameter for the original value.  
+
+``` csharp
+modelBuilder  
+  .Entity<Blog>()  
+  .MapToStoredProcedures(s =>  
+    s.Update(u => u.Parameter(b => b.Timestamp, "blog_timestamp")));
+```  
+
+For non-computed concurrency tokens – where both the original and new value are passed – you can use an overload of Parameter that allows you to supply a name for each parameter.  
+
+``` csharp
+modelBuilder
+ .Entity<Blog>()
+ .MapToStoredProcedures(s => s.Update(u => u.Parameter(b => b.Url, "blog_url", "blog_original_url")));
+```  
+
+## Many to Many Relationships  
+
+We’ll use the following classes as an example in this section.  
+
+``` csharp
+public class Post  
+{  
+  public int PostId { get; set; }  
+  public string Title { get; set; }  
+  public string Content { get; set; }  
+
+  public List<Tag> Tags { get; set; }  
+}  
+
+public class Tag  
+{  
+  public int TagId { get; set; }  
+  public string TagName { get; set; }  
+
+  public List<Post> Posts { get; set; }  
+}
+```  
+
+Many to many relationships can be mapped to stored procedures with the following syntax.  
+
+``` csharp
+modelBuilder  
+  .Entity<Post>()  
+  .HasMany(p => p.Tags)  
+  .WithMany(t => t.Posts)  
+  .MapToStoredProcedures();
+```  
+
+If no other configuration is supplied then the following stored procedure shape is used by default.  
+
+- Two stored procedures named **\<type_one\>\<type_two\>_Insert** and **\<type_one\>\<type_two\>_Delete** (for example, PostTag_Insert and PostTag_Delete).  
+- The parameters will be the key value(s) for each type. The name of each parameter being **\<type_name\>_\<property_name\>** (for example, Post_PostId and Tag_TagId).
+
+Here are example insert and update stored procedures.  
+
+``` SQL
+CREATE PROCEDURE [dbo].[PostTag_Insert]  
+  @Post_PostId int,  
+  @Tag_TagId int  
+AS  
+  INSERT INTO [dbo].[Post_Tags] (Post_PostId, Tag_TagId)   
+  VALUES (@Post_PostId, @Tag_TagId)
+CREATE PROCEDURE [dbo].[PostTag_Delete]  
+  @Post_PostId int,  
+  @Tag_TagId int  
+AS  
+  DELETE FROM [dbo].[Post_Tags]    
+  WHERE Post_PostId = @Post_PostId AND Tag_TagId = @Tag_TagId
+```  
+
+### Overriding the Defaults  
+
+The procedure and parameter names can be configured in a similar way to entity stored procedures.  
+
+``` csharp
+modelBuilder  
+  .Entity<Post>()  
+  .HasMany(p => p.Tags)  
+  .WithMany(t => t.Posts)  
+  .MapToStoredProcedures(s =>  
+    s.Insert(i => i.HasName("add_post_tag")  
+                   .LeftKeyParameter(p => p.PostId, "post_id")  
+                   .RightKeyParameter(t => t.TagId, "tag_id"))  
+     .Delete(d => d.HasName("remove_post_tag")  
+                   .LeftKeyParameter(p => p.PostId, "post_id")  
+                   .RightKeyParameter(t => t.TagId, "tag_id")));
+```  
diff --git a/entity-framework/ef6/modeling/code-first/fluent/relationships.md b/entity-framework/ef6/modeling/code-first/fluent/relationships.md
new file mode 100644
index 0000000000..f327f60e4b
--- /dev/null
+++ b/entity-framework/ef6/modeling/code-first/fluent/relationships.md
@@ -0,0 +1,263 @@
+---
+title: Fluent API - Relationships - EF6
+description: Fluent API - Relationships in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/code-first/fluent/relationships
+---
+# Fluent API - Relationships
+> [!NOTE]
+> This page provides information about setting up relationships in your Code First model using the fluent API. For general information about relationships in EF and how to access and manipulate data using relationships, see [Relationships & Navigation Properties](xref:ef6/fundamentals/relationships).  
+
+When working with Code First, you define your model by defining your domain CLR classes. By default, Entity Framework uses the Code First conventions to map your classes to the database schema. If you use the Code First naming conventions, in most cases you can rely on Code First to set up relationships between your tables based on the foreign keys and navigation properties that you define on the classes. If you do not follow the conventions when defining your classes, or if you want to change the way the conventions work, you can use the fluent API or data annotations to configure your classes so Code First can map the relationships between your tables.  
+
+## Introduction  
+
+When configuring a relationship with the fluent API, you start with the EntityTypeConfiguration instance and then use the HasRequired, HasOptional, or HasMany method to specify the type of relationship this entity participates in. The HasRequired and HasOptional methods take a lambda expression that represents a reference navigation property. The HasMany method takes a lambda expression that represents a collection navigation property. You can then configure an inverse navigation property by using the WithRequired, WithOptional, and WithMany methods. These methods have overloads that do not take arguments and can be used to specify cardinality with unidirectional navigations.  
+
+You can then configure foreign key properties by using the HasForeignKey method. This method takes a lambda expression that represents the property to be used as the foreign key.  
+
+## Configuring a Required-to-Optional Relationship (One-to–Zero-or-One)  
+
+The following example configures a one-to-zero-or-one relationship. The OfficeAssignment has the InstructorID property that is a primary key and a foreign key, because the name of the property does not follow the convention the HasKey method is used to configure the primary key.  
+
+``` csharp
+// Configure the primary key for the OfficeAssignment
+modelBuilder.Entity<OfficeAssignment>()
+    .HasKey(t => t.InstructorID);
+
+// Map one-to-zero or one relationship
+modelBuilder.Entity<OfficeAssignment>()
+    .HasRequired(t => t.Instructor)
+    .WithOptional(t => t.OfficeAssignment);
+```  
+
+## Configuring a Relationship Where Both Ends Are Required (One-to-One)  
+
+In most cases Entity Framework can infer which type is the dependent and which is the principal in a relationship. However, when both ends of the relationship are required or both sides are optional Entity Framework cannot identify the dependent and principal. When both ends of the relationship are required, use WithRequiredPrincipal or WithRequiredDependent after the HasRequired method. When both ends of the relationship are optional, use WithOptionalPrincipal or WithOptionalDependent after the HasOptional method.  
+
+``` csharp
+// Configure the primary key for the OfficeAssignment
+modelBuilder.Entity<OfficeAssignment>()
+    .HasKey(t => t.InstructorID);
+
+modelBuilder.Entity<Instructor>()
+    .HasRequired(t => t.OfficeAssignment)
+    .WithRequiredPrincipal(t => t.Instructor);
+```  
+
+## Configuring a Many-to-Many Relationship  
+
+The following code configures a many-to-many relationship between the Course and Instructor types. In the following example, the default Code First conventions are used to create a join table. As a result the CourseInstructor table is created with Course_CourseID and Instructor_InstructorID columns.  
+
+``` csharp
+modelBuilder.Entity<Course>()
+    .HasMany(t => t.Instructors)
+    .WithMany(t => t.Courses)
+```  
+
+If you want to specify the join table name and the names of the columns in the table you need to do additional configuration by using the Map method. The following code generates the CourseInstructor table with CourseID and InstructorID columns.  
+
+``` csharp
+modelBuilder.Entity<Course>()
+    .HasMany(t => t.Instructors)
+    .WithMany(t => t.Courses)
+    .Map(m =>
+    {
+        m.ToTable("CourseInstructor");
+        m.MapLeftKey("CourseID");
+        m.MapRightKey("InstructorID");
+    });
+```  
+
+## Configuring a Relationship with One Navigation Property  
+
+A one-directional (also called unidirectional) relationship is when a navigation property is defined on only one of the relationship ends and not on both. By convention, Code First always interprets a unidirectional relationship as one-to-many. For example, if you want a one-to-one relationship between Instructor and OfficeAssignment, where you have a navigation property on only the Instructor type, you need to use the fluent API to configure this relationship.  
+
+``` csharp
+// Configure the primary Key for the OfficeAssignment
+modelBuilder.Entity<OfficeAssignment>()
+    .HasKey(t => t.InstructorID);
+
+modelBuilder.Entity<Instructor>()
+    .HasRequired(t => t.OfficeAssignment)
+    .WithRequiredPrincipal();
+```  
+
+## Enabling Cascade Delete  
+
+You can configure cascade delete on a relationship by using the WillCascadeOnDelete method. If a foreign key on the dependent entity is not nullable, then Code First sets cascade delete on the relationship. If a foreign key on the dependent entity is nullable, Code First does not set cascade delete on the relationship, and when the principal is deleted the foreign key will be set to null.  
+
+You can remove these cascade delete conventions by using:  
+
+modelBuilder.Conventions.Remove\<OneToManyCascadeDeleteConvention\>()  
+modelBuilder.Conventions.Remove\<ManyToManyCascadeDeleteConvention\>()  
+
+The following code configures the relationship to be required and then disables cascade delete.  
+
+``` csharp
+modelBuilder.Entity<Course>()
+    .HasRequired(t => t.Department)
+    .WithMany(t => t.Courses)
+    .HasForeignKey(d => d.DepartmentID)
+    .WillCascadeOnDelete(false);
+```  
+
+## Configuring a Composite Foreign Key  
+
+If the primary key on the Department type consisted of DepartmentID and Name properties, you would configure the primary key for the Department and the foreign key on the Course types as follows:  
+
+``` csharp
+// Composite primary key
+modelBuilder.Entity<Department>()
+.HasKey(d => new { d.DepartmentID, d.Name });
+
+// Composite foreign key
+modelBuilder.Entity<Course>()  
+    .HasRequired(c => c.Department)  
+    .WithMany(d => d.Courses)
+    .HasForeignKey(d => new { d.DepartmentID, d.DepartmentName });
+```  
+
+## Renaming a Foreign Key That Is Not Defined in the Model  
+
+If you choose not to define a foreign key on the CLR type, but want to specify what name it should have in the database, do the following:  
+
+``` csharp
+modelBuilder.Entity<Course>()
+    .HasRequired(c => c.Department)
+    .WithMany(t => t.Courses)
+    .Map(m => m.MapKey("ChangedDepartmentID"));
+```  
+
+## Configuring a Foreign Key Name That Does Not Follow the Code First Convention  
+
+If the foreign key property on the Course class was called SomeDepartmentID instead of DepartmentID, you would need to do the following to specify that you want SomeDepartmentID to be the foreign key:  
+
+``` csharp
+modelBuilder.Entity<Course>()
+         .HasRequired(c => c.Department)
+         .WithMany(d => d.Courses)
+         .HasForeignKey(c => c.SomeDepartmentID);
+```  
+
+## Model Used in Samples  
+
+The following Code First model is used for the samples on this page.  
+
+``` csharp
+using System.Data.Entity;
+using System.Data.Entity.ModelConfiguration.Conventions;
+// add a reference to System.ComponentModel.DataAnnotations DLL
+using System.ComponentModel.DataAnnotations;
+using System.Collections.Generic;
+using System;
+
+public class SchoolEntities : DbContext
+{
+    public DbSet<Course> Courses { get; set; }
+    public DbSet<Department> Departments { get; set; }
+    public DbSet<Instructor> Instructors { get; set; }
+    public DbSet<OfficeAssignment> OfficeAssignments { get; set; }
+
+    protected override void OnModelCreating(DbModelBuilder modelBuilder)
+    {
+        // Configure Code First to ignore PluralizingTableName convention
+        // If you keep this convention then the generated tables will have pluralized names.
+        modelBuilder.Conventions.Remove<PluralizingTableNameConvention>();
+    }
+}
+
+public class Department
+{
+    public Department()
+    {
+        this.Courses = new HashSet<Course>();
+    }
+    // Primary key
+    public int DepartmentID { get; set; }
+    public string Name { get; set; }
+    public decimal Budget { get; set; }
+    public System.DateTime StartDate { get; set; }
+    public int? Administrator { get; set; }
+
+    // Navigation property
+    public virtual ICollection<Course> Courses { get; private set; }
+}
+
+public class Course
+{
+    public Course()
+    {
+        this.Instructors = new HashSet<Instructor>();
+    }
+    // Primary key
+    public int CourseID { get; set; }
+
+    public string Title { get; set; }
+    public int Credits { get; set; }
+
+    // Foreign key
+    public int DepartmentID { get; set; }
+
+    // Navigation properties
+    public virtual Department Department { get; set; }
+    public virtual ICollection<Instructor> Instructors { get; private set; }
+}
+
+public partial class OnlineCourse : Course
+{
+    public string URL { get; set; }
+}
+
+public partial class OnsiteCourse : Course
+{
+    public OnsiteCourse()
+    {
+        Details = new Details();
+    }
+
+    public Details Details { get; set; }
+}
+
+public class Details
+{
+    public System.DateTime Time { get; set; }
+    public string Location { get; set; }
+    public string Days { get; set; }
+}
+
+public class Instructor
+{
+    public Instructor()
+    {
+        this.Courses = new List<Course>();
+    }
+
+    // Primary key
+    public int InstructorID { get; set; }
+    public string LastName { get; set; }
+    public string FirstName { get; set; }
+    public System.DateTime HireDate { get; set; }
+
+    // Navigation properties
+    public virtual ICollection<Course> Courses { get; private set; }
+}
+
+public class OfficeAssignment
+{
+    // Specifying InstructorID as a primary
+    [Key()]
+    public Int32 InstructorID { get; set; }
+
+    public string Location { get; set; }
+
+    // When Entity Framework sees Timestamp attribute
+    // it configures ConcurrencyCheck and DatabaseGeneratedPattern=Computed.
+    [Timestamp]
+    public Byte[] Timestamp { get; set; }
+
+    // Navigation property
+    public virtual Instructor Instructor { get; set; }
+}
+```  
diff --git a/entity-framework/ef6/modeling/code-first/fluent/types-and-properties.md b/entity-framework/ef6/modeling/code-first/fluent/types-and-properties.md
new file mode 100644
index 0000000000..7073fd877c
--- /dev/null
+++ b/entity-framework/ef6/modeling/code-first/fluent/types-and-properties.md
@@ -0,0 +1,440 @@
+---
+title: Fluent API - Configuring and Mapping Properties and Types - EF6
+description: Fluent API - Configuring and Mapping Properties and Types in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/code-first/fluent/types-and-properties
+---
+# Fluent API - Configuring and Mapping Properties and Types
+When working with Entity Framework Code First the default behavior is to map your POCO classes to tables using a set of conventions baked into EF. Sometimes, however, you cannot or do not want to follow those conventions and need to map entities to something other than what the conventions dictate.  
+
+There are two main ways you can configure EF to use something other than conventions, namely [annotations](xref:ef6/modeling/code-first/data-annotations) or EFs fluent API. The annotations only cover a subset of the fluent API functionality, so there are mapping scenarios that cannot be achieved using annotations. This article is designed to demonstrate how to use the fluent API to configure properties.  
+
+The code first fluent API is most commonly accessed by overriding the [OnModelCreating](https://msdn.microsoft.com/library/system.data.entity.dbcontext.onmodelcreating.aspx) method on your derived [DbContext](https://msdn.microsoft.com/library/system.data.entity.dbcontext.aspx). The following samples are designed to show how to do various tasks with the fluent api and allow you to copy the code out and customize it to suit your model, if you wish to see the model that they can be used with as-is then it is provided at the end of this article.  
+
+## Model-Wide Settings  
+
+### Default Schema (EF6 onwards)  
+
+Starting with EF6 you can use the HasDefaultSchema method on DbModelBuilder to specify the database schema to use for all tables, stored procedures, etc. This default setting will be overridden for any objects that you explicitly configure a different schema for.  
+
+``` csharp
+modelBuilder.HasDefaultSchema("sales");
+```  
+
+### Custom Conventions (EF6 onwards)  
+
+Starting with EF6 you can create your own conventions to supplement the ones included in Code First. For more details, see [Custom Code First Conventions](xref:ef6/modeling/code-first/conventions/custom).  
+
+## Property Mapping  
+
+The [Property](https://msdn.microsoft.com/library/system.data.entity.infrastructure.dbentityentry.property.aspx) method is used to configure attributes for each property belonging to an entity or complex type. The Property method is used to obtain a configuration object for a given property. The options on the configuration object are specific to the type being configured; IsUnicode is available only on string properties for example.  
+
+### Configuring a Primary Key  
+
+The Entity Framework convention for primary keys is:  
+
+1. Your class defines a property whose name is “ID” or “Id”  
+2. or a class name followed by “ID” or “Id”  
+
+To explicitly set a property to be a primary key, you can use the HasKey method. In the following example, the HasKey method is used to configure the InstructorID primary key on the OfficeAssignment type.  
+
+``` csharp
+modelBuilder.Entity<OfficeAssignment>().HasKey(t => t.InstructorID);
+```  
+
+### Configuring a Composite Primary Key  
+
+The following example configures the DepartmentID and Name properties to be the composite primary key of the Department type.  
+
+``` csharp
+modelBuilder.Entity<Department>().HasKey(t => new { t.DepartmentID, t.Name });
+```  
+
+### Switching off Identity for Numeric Primary Keys  
+
+The following example sets the DepartmentID property to System.ComponentModel.DataAnnotations.DatabaseGeneratedOption.None to indicate that the value will not be generated by the database.  
+
+``` csharp
+modelBuilder.Entity<Department>().Property(t => t.DepartmentID)
+    .HasDatabaseGeneratedOption(DatabaseGeneratedOption.None);
+```  
+
+### Specifying the Maximum Length on a Property  
+
+In the following example, the Name property should be no longer than 50 characters. If you make the value longer than 50 characters, you will get a [DbEntityValidationException](https://msdn.microsoft.com/library/system.data.entity.validation.dbentityvalidationexception.aspx) exception. If Code First creates a database from this model it will also set the maximum length of the Name column to 50 characters.  
+
+``` csharp
+modelBuilder.Entity<Department>().Property(t => t.Name).HasMaxLength(50);
+```  
+
+### Configuring the Property to be Required  
+
+In the following example, the Name property is required. If you do not specify the Name, you will get a DbEntityValidationException exception. If Code First creates a database from this model then the column used to store this property will usually be non-nullable.  
+
+> [!NOTE]
+> In some cases it may not be possible for the column in the database to be non-nullable even though the property is required. For example, when using a TPH inheritance strategy data for multiple types is stored in a single table. If a derived type includes a required property the column cannot be made non-nullable since not all types in the hierarchy will have this property.  
+
+``` csharp
+modelBuilder.Entity<Department>().Property(t => t.Name).IsRequired();
+```  
+
+### Configuring an Index on one or more properties  
+
+> [!NOTE]
+> **EF6.1 Onwards Only** - The Index attribute was introduced in Entity Framework 6.1. If you are using an earlier version the information in this section does not apply.  
+
+Creating indexes isn't natively supported by the Fluent API, but you can make use of the support for **IndexAttribute** via the Fluent API. Index attributes are processed by including a model annotation on the model that is then turned into an Index in the database later in the pipeline. You can manually add these same annotations using the Fluent API.  
+
+The easiest way to do this is to create an instance of **IndexAttribute** that contains all the settings for the new index. You can then create an instance of **IndexAnnotation** which is an EF specific type that will convert the **IndexAttribute** settings into a model annotation that can be stored on the EF model. These can then be passed to the **HasColumnAnnotation** method on the Fluent API, specifying the name **Index** for the annotation.  
+
+``` csharp
+modelBuilder
+    .Entity<Department>()
+    .Property(t => t.Name)
+    .HasColumnAnnotation("Index", new IndexAnnotation(new IndexAttribute()));
+```  
+
+For a complete list of the settings available in **IndexAttribute**, see the *Index* section of [Code First Data Annotations](xref:ef6/modeling/code-first/data-annotations). This includes customizing the index name, creating unique indexes, and creating multi-column indexes.  
+
+You can specify multiple index annotations on a single property by passing an array of **IndexAttribute** to the constructor of **IndexAnnotation**.  
+
+``` csharp
+modelBuilder
+    .Entity<Department>()
+    .Property(t => t.Name)
+    .HasColumnAnnotation(
+        "Index",  
+        new IndexAnnotation(new[]
+            {
+                new IndexAttribute("Index1"),
+                new IndexAttribute("Index2") { IsUnique = true }
+            })));
+```  
+
+### Specifying Not to Map a CLR Property to a Column in the Database  
+
+The following example shows how to specify that a property on a CLR type is not mapped to a column in the database.  
+
+``` csharp
+modelBuilder.Entity<Department>().Ignore(t => t.Budget);
+```  
+
+### Mapping a CLR Property to a Specific Column in the Database  
+
+The following example maps the Name CLR property to the DepartmentName database column.  
+
+``` csharp
+modelBuilder.Entity<Department>()
+    .Property(t => t.Name)
+    .HasColumnName("DepartmentName");
+```  
+
+### Renaming a Foreign Key That Is Not Defined in the Model  
+
+If you choose not to define a foreign key on a CLR type, but want to specify what name it should have in the database, do the following:  
+
+``` csharp
+modelBuilder.Entity<Course>()
+    .HasRequired(c => c.Department)
+    .WithMany(t => t.Courses)
+    .Map(m => m.MapKey("ChangedDepartmentID"));
+```  
+
+### Configuring whether a String Property Supports Unicode Content  
+
+By default strings are Unicode (nvarchar in SQL Server). You can use the IsUnicode method to specify that a string should be of varchar type.  
+
+``` csharp
+modelBuilder.Entity<Department>()
+    .Property(t => t.Name)
+    .IsUnicode(false);
+```  
+
+### Configuring the Data Type of a Database Column  
+
+The [HasColumnType](https://msdn.microsoft.com/library/system.data.entity.modelconfiguration.configuration.stringcolumnconfiguration.hascolumntype.aspx) method enables mapping to different representations of the same basic type. Using this method does not enable you to perform any conversion of the data at run time. Note that IsUnicode is the preferred way of setting columns to varchar, as it is database agnostic.  
+
+``` csharp
+modelBuilder.Entity<Department>()   
+    .Property(p => p.Name)   
+    .HasColumnType("varchar");
+```  
+
+### Configuring Properties on a Complex Type  
+
+There are two ways to configure scalar properties on a complex type.  
+
+You can call Property on ComplexTypeConfiguration.  
+
+``` csharp
+modelBuilder.ComplexType<Details>()
+    .Property(t => t.Location)
+    .HasMaxLength(20);
+```  
+
+You can also use the dot notation to access a property of a complex type.  
+
+``` csharp
+modelBuilder.Entity<OnsiteCourse>()
+    .Property(t => t.Details.Location)
+    .HasMaxLength(20);
+```  
+
+### Configuring a Property to Be Used as an Optimistic Concurrency Token  
+
+To specify that a property in an entity represents a concurrency token, you can use either the ConcurrencyCheck attribute or the IsConcurrencyToken method.  
+
+``` csharp
+modelBuilder.Entity<OfficeAssignment>()
+    .Property(t => t.Timestamp)
+    .IsConcurrencyToken();
+```  
+
+You can also use the IsRowVersion method to configure the property to be a row version in the database. Setting the property to be a row version automatically configures it to be an optimistic concurrency token.  
+
+``` csharp
+modelBuilder.Entity<OfficeAssignment>()
+    .Property(t => t.Timestamp)
+    .IsRowVersion();
+```  
+
+## Type Mapping  
+
+### Specifying That a Class Is a Complex Type  
+
+By convention, a type that has no primary key specified is treated as a complex type. There are some scenarios where Code First will not detect a complex type (for example, if you do have a property called ID, but you do not mean for it to be a primary key). In such cases, you would use the fluent API to explicitly specify that a type is a complex type.  
+
+``` csharp
+modelBuilder.ComplexType<Details>();
+```  
+
+### Specifying Not to Map a CLR Entity Type to a Table in the Database  
+
+The following example shows how to exclude a CLR type from being mapped to a table in the database.  
+
+``` csharp
+modelBuilder.Ignore<OnlineCourse>();
+```  
+
+### Mapping an Entity Type to a Specific Table in the Database  
+
+All properties of Department will be mapped to columns in a table called t_ Department.  
+
+``` csharp
+modelBuilder.Entity<Department>()  
+    .ToTable("t_Department");
+```  
+
+You can also specify the schema name like this:  
+
+``` csharp
+modelBuilder.Entity<Department>()  
+    .ToTable("t_Department", "school");
+```  
+
+### Mapping the Table-Per-Hierarchy (TPH) Inheritance  
+
+In the TPH mapping scenario, all types in an inheritance hierarchy are mapped to a single table. A discriminator column is used to identify the type of each row. When creating your model with Code First, TPH is the default strategy for the types that participate in the inheritance hierarchy. By default, the discriminator column is added to the table with the name “Discriminator” and the CLR type name of each type in the hierarchy is used for the discriminator values. You can modify the default behavior by using the fluent API.  
+
+``` csharp
+modelBuilder.Entity<Course>()  
+    .Map<Course>(m => m.Requires("Type").HasValue("Course"))  
+    .Map<OnsiteCourse>(m => m.Requires("Type").HasValue("OnsiteCourse"));
+```  
+
+### Mapping the Table-Per-Type (TPT) Inheritance  
+
+In the TPT mapping scenario, all types are mapped to individual tables. Properties that belong solely to a base type or derived type are stored in a table that maps to that type. Tables that map to derived types also store a foreign key that joins the derived table with the base table.  
+
+``` csharp
+modelBuilder.Entity<Course>().ToTable("Course");  
+modelBuilder.Entity<OnsiteCourse>().ToTable("OnsiteCourse");
+```  
+
+### Mapping the Table-Per-Concrete Class (TPC) Inheritance  
+
+In the TPC mapping scenario, all non-abstract types in the hierarchy are mapped to individual tables. The tables that map to the derived classes have no relationship to the table that maps to the base class in the database. All properties of a class, including inherited properties, are mapped to columns of the corresponding table.  
+
+Call the MapInheritedProperties method to configure each derived type. MapInheritedProperties remaps all properties that were inherited from the base class to new columns in the table for the derived class.  
+
+> [!NOTE]
+> Note that because the tables participating in TPC inheritance hierarchy do not share a primary key there will be duplicate entity keys when inserting in tables that are mapped to subclasses if you have database generated values with the same identity seed. To solve this problem you can either specify a different initial seed value for each table or switch off identity on the primary key property. Identity is the default value for integer key properties when working with Code First.  
+
+``` csharp
+modelBuilder.Entity<Course>()
+    .Property(c => c.CourseID)
+    .HasDatabaseGeneratedOption(DatabaseGeneratedOption.None);
+
+modelBuilder.Entity<OnsiteCourse>().Map(m =>
+{
+    m.MapInheritedProperties();
+    m.ToTable("OnsiteCourse");
+});
+
+modelBuilder.Entity<OnlineCourse>().Map(m =>
+{
+    m.MapInheritedProperties();
+    m.ToTable("OnlineCourse");
+});
+```  
+
+### Mapping Properties of an Entity Type to Multiple Tables in the Database (Entity Splitting)  
+
+Entity splitting allows the properties of an entity type to be spread across multiple tables. In the following example, the Department entity is split into two tables: Department and DepartmentDetails. Entity splitting uses multiple calls to the Map method to map a subset of properties to a specific table.  
+
+``` csharp
+modelBuilder.Entity<Department>()
+    .Map(m =>
+    {
+        m.Properties(t => new { t.DepartmentID, t.Name });
+        m.ToTable("Department");
+    })
+    .Map(m =>
+    {
+        m.Properties(t => new { t.DepartmentID, t.Administrator, t.StartDate, t.Budget });
+        m.ToTable("DepartmentDetails");
+    });
+```  
+
+### Mapping Multiple Entity Types to One Table in the Database (Table Splitting)  
+
+The following example maps two entity types that share a primary key to one table.  
+
+``` csharp
+modelBuilder.Entity<OfficeAssignment>()
+    .HasKey(t => t.InstructorID);
+
+modelBuilder.Entity<Instructor>()
+    .HasRequired(t => t.OfficeAssignment)
+    .WithRequiredPrincipal(t => t.Instructor);
+
+modelBuilder.Entity<Instructor>().ToTable("Instructor");
+
+modelBuilder.Entity<OfficeAssignment>().ToTable("Instructor");
+```  
+
+### Mapping an Entity Type to Insert/Update/Delete Stored Procedures (EF6 onwards)  
+
+Starting with EF6 you can map an entity to use stored procedures for insert update and delete. For more details see, [Code First Insert/Update/Delete Stored Procedures](xref:ef6/modeling/code-first/fluent/cud-stored-procedures).  
+
+## Model Used in Samples  
+
+The following Code First model is used for the samples on this page.  
+
+``` csharp
+using System.Data.Entity;
+using System.Data.Entity.ModelConfiguration.Conventions;
+// add a reference to System.ComponentModel.DataAnnotations DLL
+using System.ComponentModel.DataAnnotations;
+using System.Collections.Generic;
+using System;
+
+public class SchoolEntities : DbContext
+{
+    public DbSet<Course> Courses { get; set; }
+    public DbSet<Department> Departments { get; set; }
+    public DbSet<Instructor> Instructors { get; set; }
+    public DbSet<OfficeAssignment> OfficeAssignments { get; set; }
+
+    protected override void OnModelCreating(DbModelBuilder modelBuilder)
+    {
+        // Configure Code First to ignore PluralizingTableName convention
+        // If you keep this convention then the generated tables will have pluralized names.
+        modelBuilder.Conventions.Remove<PluralizingTableNameConvention>();
+    }
+}
+
+public class Department
+{
+    public Department()
+    {
+        this.Courses = new HashSet<Course>();
+    }
+    // Primary key
+    public int DepartmentID { get; set; }
+    public string Name { get; set; }
+    public decimal Budget { get; set; }
+    public System.DateTime StartDate { get; set; }
+    public int? Administrator { get; set; }
+
+    // Navigation property
+    public virtual ICollection<Course> Courses { get; private set; }
+}
+
+public class Course
+{
+    public Course()
+    {
+        this.Instructors = new HashSet<Instructor>();
+    }
+    // Primary key
+    public int CourseID { get; set; }
+
+    public string Title { get; set; }
+    public int Credits { get; set; }
+
+    // Foreign key
+    public int DepartmentID { get; set; }
+
+    // Navigation properties
+    public virtual Department Department { get; set; }
+    public virtual ICollection<Instructor> Instructors { get; private set; }
+}
+
+public partial class OnlineCourse : Course
+{
+    public string URL { get; set; }
+}
+
+public partial class OnsiteCourse : Course
+{
+    public OnsiteCourse()
+    {
+        Details = new Details();
+    }
+
+    public Details Details { get; set; }
+}
+
+public class Details
+{
+    public System.DateTime Time { get; set; }
+    public string Location { get; set; }
+    public string Days { get; set; }
+}
+
+public class Instructor
+{
+    public Instructor()
+    {
+        this.Courses = new List<Course>();
+    }
+
+    // Primary key
+    public int InstructorID { get; set; }
+    public string LastName { get; set; }
+    public string FirstName { get; set; }
+    public System.DateTime HireDate { get; set; }
+
+    // Navigation properties
+    public virtual ICollection<Course> Courses { get; private set; }
+}
+
+public class OfficeAssignment
+{
+    // Specifying InstructorID as a primary
+    [Key()]
+    public Int32 InstructorID { get; set; }
+
+    public string Location { get; set; }
+
+    // When Entity Framework sees Timestamp attribute
+    // it configures ConcurrencyCheck and DatabaseGeneratedPattern=Computed.
+    [Timestamp]
+    public Byte[] Timestamp { get; set; }
+
+    // Navigation property
+    public virtual Instructor Instructor { get; set; }
+}
+```  
diff --git a/entity-framework/ef6/modeling/code-first/fluent/vb.md b/entity-framework/ef6/modeling/code-first/fluent/vb.md
new file mode 100644
index 0000000000..1e38974dcf
--- /dev/null
+++ b/entity-framework/ef6/modeling/code-first/fluent/vb.md
@@ -0,0 +1,414 @@
+---
+title: Fluent API with VB.NET - EF6
+description: Fluent API with VB.NET in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/code-first/fluent/vb
+---
+# Fluent API with VB.NET
+Code First allows you to define your model using C\# or VB.NET classes. Additional configuration can optionally be performed using attributes on your classes and properties or by using a fluent API. This walkthrough shows how to perform fluent API configuration using VB.NET.
+
+This page assumes you have a basic understanding of Code First. Check out the following walkthroughs for more information on Code First:
+
+-   [Code First to a New Database](xref:ef6/modeling/code-first/workflows/new-database)
+-   [Code First to an Existing Database](xref:ef6/modeling/code-first/workflows/existing-database)
+
+## Pre-Requisites
+
+You will need to have at least Visual Studio 2010 or Visual Studio 2012 installed to complete this walkthrough.
+
+If you are using Visual Studio 2010, you will also need to have [NuGet](https://visualstudiogallery.msdn.microsoft.com/27077b70-9dad-4c64-adcf-c7cf6bc9970c) installed
+
+## Create the Application
+
+To keep things simple we’re going to build a basic console application that uses Code First to perform data access.
+
+-   Open Visual Studio
+-   **File -&gt; New -&gt; Project…**
+-   Select **Windows** from the left menu and **Console Application**
+-   Enter **CodeFirstVBSample** as the name
+-   Select **OK**
+
+## Define the Model
+
+In this step you will define VB.NET POCO entity types that represent the conceptual model. The classes do not need to derive from any base classes or implement any interfaces.
+
+-   Add a new class to the project, enter **SchoolModel** for the class name
+-   Replace the contents of the new class with the following code
+
+``` vb
+Public Class Department
+    Public Sub New()
+        Me.Courses = New List(Of Course)()
+    End Sub
+
+    ' Primary key
+    Public Property DepartmentID() As Integer
+    Public Property Name() As String
+    Public Property Budget() As Decimal
+    Public Property StartDate() As Date
+    Public Property Administrator() As Integer?
+    Public Overridable Property Courses() As ICollection(Of Course)
+End Class
+
+Public Class Course
+    Public Sub New()
+        Me.Instructors = New HashSet(Of Instructor)()
+    End Sub
+
+    ' Primary key
+    Public Property CourseID() As Integer
+    Public Property Title() As String
+    Public Property Credits() As Integer
+
+    ' Foreign  key that does not follow the Code First convention.
+    ' The fluent API will be used to configure DepartmentID_FK  to be the foreign key for this entity.
+    Public Property DepartmentID_FK() As Integer
+
+    ' Navigation properties
+    Public Overridable Property Department() As Department
+    Public Overridable Property Instructors() As ICollection(Of Instructor)
+End Class
+
+Public Class OnlineCourse
+    Inherits Course
+
+    Public Property URL() As String
+End Class
+
+Partial Public Class OnsiteCourse
+    Inherits Course
+
+    Public Sub New()
+        Details = New OnsiteCourseDetails()
+    End Sub
+
+    Public Property Details() As OnsiteCourseDetails
+ End Class
+
+' Complex type
+Public Class OnsiteCourseDetails
+    Public Property Time() As Date
+    Public Property Location() As String
+    Public Property Days() As String
+End Class
+
+Public Class Person
+    ' Primary key
+    Public Property PersonID() As Integer
+    Public Property LastName() As String
+    Public Property FirstName() As String
+End Class
+
+Public Class Instructor
+    Inherits Person
+
+    Public Sub New()
+        Me.Courses = New List(Of Course)()
+    End Sub
+
+    Public Property HireDate() As Date
+
+    ' Navigation properties
+    Private privateCourses As ICollection(Of Course)
+    Public Overridable Property Courses() As ICollection(Of Course)
+    Public Overridable Property OfficeAssignment() As OfficeAssignment
+End Class
+
+Public Class OfficeAssignment
+    ' Primary key that does not follow the Code First convention.
+    ' The HasKey method is used later to configure the primary key for the entity.
+    Public Property InstructorID() As Integer
+
+    Public Property Location() As String
+    Public Property Timestamp() As Byte()
+
+    ' Navigation property
+    Public Overridable Property Instructor() As Instructor
+End Class
+```
+
+## Define a Derived Context
+
+We’re about to start to using types from the Entity Framework so we need to add the EntityFramework NuGet package.
+
+-   **Project –&gt; **Manage NuGet Packages…**
+> [!NOTE]
+> If you don’t have the **Manage NuGet Packages…** option you should install the [latest version of NuGet](https://visualstudiogallery.msdn.microsoft.com/27077b70-9dad-4c64-adcf-c7cf6bc9970c)
+-   Select the **Online** tab
+-   Select the **EntityFramework** package
+-   Click **Install**
+
+Now it’s time to define a derived context, which represents a session with the database, allowing us to query and save data. We define a context that derives from System.Data.Entity.DbContext and exposes a typed DbSet&lt;TEntity&gt; for each class in our model.
+
+-   Add a new class to the project, enter **SchoolContext** for the class name
+-   Replace the contents of the new class with the following code
+
+```vb
+Imports System.ComponentModel.DataAnnotations
+Imports System.ComponentModel.DataAnnotations.Schema
+Imports System.Data.Entity
+Imports System.Data.Entity.Infrastructure
+Imports System.Data.Entity.ModelConfiguration.Conventions
+
+Public Class SchoolContext
+    Inherits DbContext
+
+    Public Property OfficeAssignments() As DbSet(Of OfficeAssignment)
+    Public Property Instructors() As DbSet(Of Instructor)
+    Public Property Courses() As DbSet(Of Course)
+    Public Property Departments() As DbSet(Of Department)
+
+    Protected Overrides Sub OnModelCreating(ByVal modelBuilder As DbModelBuilder)
+    End Sub
+End Class
+```
+
+## Configuring with the Fluent API
+
+This section demonstrates how to use the fluent APIs to configure types to tables mapping, properties to columns mapping, and relationships between tables\\type in your model. The fluent API is exposed through the **DbModelBuilder** type and is most commonly accessed by overriding the **OnModelCreating** method on **DbContext**.
+
+-   Copy the following code and add it to the **OnModelCreating** method defined on the **SchoolContext** class
+    The comments explain what each mapping does
+
+``` vb
+' Configure Code First to ignore PluralizingTableName convention
+' If you keep this convention then the generated tables
+' will have pluralized names.
+modelBuilder.Conventions.Remove(Of PluralizingTableNameConvention)()
+
+
+' Specifying that a Class is a Complex Type
+
+' The model defined in this topic defines a type OnsiteCourseDetails.
+' By convention, a type that has no primary key specified
+' is treated as a complex type.
+' There are some scenarios where Code First will not
+' detect a complex type (for example, if you do have a property
+' called ID, but you do not mean for it to be a primary key).
+' In such cases, you would use the fluent API to
+' explicitly specify that a type is a complex type.
+modelBuilder.ComplexType(Of OnsiteCourseDetails)()
+
+
+' Mapping a CLR Entity Type to a Specific Table in the Database.
+
+' All properties of OfficeAssignment will be mapped
+' to columns  in a table called t_OfficeAssignment.
+modelBuilder.Entity(Of OfficeAssignment)().ToTable("t_OfficeAssignment")
+
+
+' Mapping the Table-Per-Hierarchy (TPH) Inheritance
+
+' In the TPH mapping scenario, all types in an inheritance hierarchy
+' are mapped to a single table.
+' A discriminator column is used to identify the type of each row.
+' When creating your model with Code First,      
+' TPH is the default strategy for the types that
+' participate in the inheritance hierarchy.
+' By default, the discriminator column is added
+' to the table with the name “Discriminator”
+' and the CLR type name of each type in the hierarchy
+' is used for the discriminator values.
+' You can modify the default behavior by using the fluent API.
+modelBuilder.Entity(Of Person)().
+    Map(Of Person)(Function(t) t.Requires("Type").
+        HasValue("Person")).
+        Map(Of Instructor)(Function(t) t.Requires("Type").
+        HasValue("Instructor"))
+
+
+' Mapping the Table-Per-Type (TPT) Inheritance
+
+' In the TPT mapping scenario, all types are mapped to individual tables.
+' Properties that belong solely to a base type or derived type are stored
+' in a table that maps to that type. Tables that map to derived types
+' also store a foreign key that joins the derived table with the base table.
+modelBuilder.Entity(Of Course)().ToTable("Course")
+modelBuilder.Entity(Of OnsiteCourse)().ToTable("OnsiteCourse")
+modelBuilder.Entity(Of OnlineCourse)().ToTable("OnlineCourse")
+
+
+' Configuring a Primary Key
+
+' If your class defines a property whose name is “ID” or “Id”,
+' or a class name followed by “ID” or “Id”,
+' the Entity Framework treats this property as a primary key by convention.
+' If your property name does not follow this pattern, use the HasKey method
+' to configure the primary key for the entity.
+modelBuilder.Entity(Of OfficeAssignment)().
+    HasKey(Function(t) t.InstructorID)
+
+
+' Specifying the Maximum Length on a Property
+
+' In the following example, the Name property
+' should be no longer than 50 characters.
+' If you make the value longer than 50 characters,
+' you will get a DbEntityValidationException exception.
+modelBuilder.Entity(Of Department)().Property(Function(t) t.Name).
+    HasMaxLength(60)
+
+
+' Configuring the Property to be Required
+
+' In the following example, the Name property is required.
+' If you do not specify the Name,
+' you will get a DbEntityValidationException exception.
+' The database column used to store this property will be non-nullable.
+modelBuilder.Entity(Of Department)().Property(Function(t) t.Name).
+    IsRequired()
+
+
+' Switching off Identity for Numeric Primary Keys
+
+' The following example sets the DepartmentID property to
+' System.ComponentModel.DataAnnotations.DatabaseGeneratedOption.None to indicate that
+' the value will not be generated by the database.
+modelBuilder.Entity(Of Course)().Property(Function(t) t.CourseID).
+    HasDatabaseGeneratedOption(DatabaseGeneratedOption.None)
+
+'Specifying NOT to Map a CLR Property to a Column in the Database
+ modelBuilder.Entity(Of Department)().
+     Ignore(Function(t) t.Administrator)
+
+'Mapping a CLR Property to a Specific Column in the Database
+ modelBuilder.Entity(Of Department)().Property(Function(t) t.Budget).
+     HasColumnName("DepartmentBudget")
+
+'Configuring the Data Type of a Database Column
+ modelBuilder.Entity(Of Department)().Property(Function(t) t.Name).
+     HasColumnType("varchar")
+
+'Configuring Properties on a Complex Type
+modelBuilder.Entity(Of OnsiteCourse)().Property(Function(t) t.Details.Days).
+    HasColumnName("Days")
+modelBuilder.Entity(Of OnsiteCourse)().Property(Function(t) t.Details.Location).
+    HasColumnName("Location")
+modelBuilder.Entity(Of OnsiteCourse)().Property(Function(t) t.Details.Time).
+    HasColumnName("Time")
+
+
+' Map one-to-zero or one relationship
+
+' The OfficeAssignment has the InstructorID
+' property that is a primary key and a foreign key.
+modelBuilder.Entity(Of OfficeAssignment)().
+    HasRequired(Function(t) t.Instructor).
+    WithOptional(Function(t) t.OfficeAssignment)
+
+
+' Configuring a Many-to-Many Relationship
+
+' The following code configures a many-to-many relationship
+' between the Course  and Instructor types.
+' In the following example, the default Code First conventions
+' are used  to create a join table.
+' As a result the CourseInstructor table is created with
+' Course_CourseID  and Instructor_InstructorID columns.
+modelBuilder.Entity(Of Course)().
+    HasMany(Function(t) t.Instructors).
+    WithMany(Function(t) t.Courses)
+
+
+' Configuring a Many-to-Many Relationship and specifying the names
+' of the columns in the join table
+
+' If you want to specify the join table name
+' and the names of the columns in the table
+' you need to do additional configuration by using the Map method.
+' The following code generates the CourseInstructor
+' table with CourseID and InstructorID columns.
+modelBuilder.Entity(Of Course)().
+    HasMany(Function(t) t.Instructors).
+    WithMany(Function(t) t.Courses).
+    Map(Sub(m)
+            m.ToTable("CourseInstructor")
+            m.MapLeftKey("CourseID")
+            m.MapRightKey("InstructorID")
+        End Sub)
+
+
+' Configuring a foreign key name that does not follow the Code First convention
+
+' The foreign key property on the Course class is called DepartmentID_FK
+' since that does not follow Code First conventions you need to explicitly specify
+' that you want DepartmentID_FK to be the foreign key.
+modelBuilder.Entity(Of Course)().
+    HasRequired(Function(t) t.Department).
+    WithMany(Function(t) t.Courses).
+    HasForeignKey(Function(t) t.DepartmentID_FK)
+
+
+' Enabling Cascade Delete
+
+' By default, if a foreign key on the dependent entity is not nullable,
+' then Code First sets cascade delete on the relationship.
+' If a foreign key on the dependent entity is nullable,
+' Code First does not set cascade delete on the relationship,
+' and when the principal is deleted the foreign key will be set to null.
+' The following code configures cascade delete on the relationship.
+
+' You can also remove the cascade delete conventions by using:
+' modelBuilder.Conventions.Remove<OneToManyCascadeDeleteConvention>()
+' and modelBuilder.Conventions.Remove<ManyToManyCascadeDeleteConvention>().
+modelBuilder.Entity(Of Course)().
+    HasRequired(Function(t) t.Department).
+    WithMany(Function(t) t.Courses).
+    HasForeignKey(Function(d) d.DepartmentID_FK).
+    WillCascadeOnDelete(False)
+```
+
+## Using the Model
+
+Let's perform some data access using the **SchoolContext** to see out model in action.
+
+-   Open the Module1.vb file where the Main function is defined
+-   Copy and paste the following Module1 definition
+
+``` vb
+Imports System.Data.Entity
+
+Module Module1
+
+    Sub Main()
+
+        Using context As New SchoolContext()
+
+            ' Create and save a new Department.
+            Console.Write("Enter a name for a new Department: ")
+            Dim name = Console.ReadLine()
+
+            Dim department = New Department With { .Name = name, .StartDate = DateTime.Now }
+            context.Departments.Add(department)
+            context.SaveChanges()
+
+            ' Display all Departments from the database ordered by name
+            Dim departments =
+                From d In context.Departments
+                Order By d.Name
+                Select d
+
+            Console.WriteLine("All Departments in the database:")
+            For Each department In departments
+                Console.WriteLine(department.Name)
+            Next
+
+        End Using
+
+        Console.WriteLine("Press any key to exit...")
+        Console.ReadKey()
+
+    End Sub
+
+End Module
+```
+
+You can now run the application and test it out.
+
+```console
+Enter a name for a new Department: Computing
+All Departments in the database:
+Computing
+Press any key to exit...
+```
diff --git a/entity-framework/ef6/modeling/code-first/migrations/automatic.md b/entity-framework/ef6/modeling/code-first/migrations/automatic.md
new file mode 100644
index 0000000000..63d6e32ced
--- /dev/null
+++ b/entity-framework/ef6/modeling/code-first/migrations/automatic.md
@@ -0,0 +1,210 @@
+---
+title: Automatic Code First Migrations - EF6
+description: Automatic Code First Migrations in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/code-first/migrations/automatic
+---
+# Automatic Code First Migrations
+Automatic Migrations allows you to use Code First Migrations without having a code file in your project for each change you make. Not all changes can be applied automatically - for example column renames require the use of a code-based migration.
+
+> [!NOTE]
+> This article assumes you know how to use Code First Migrations in basic scenarios. If you don’t, then you’ll need to read [Code First Migrations](xref:ef6/modeling/code-first/migrations/index) before continuing.
+
+## Recommendation for Team Environments
+
+You can intersperse automatic and code-based migrations but this is not recommended in team development scenarios. If you are part of a team of developers that use source control you should either use purely automatic migrations or purely code-based migrations. Given the limitations of automatic migrations we recommend using code-based migrations in team environments.
+
+## Building an Initial Model & Database
+
+Before we start using migrations we need a project and a Code First model to work with. For this walkthrough we are going to use the canonical **Blog** and **Post** model.
+
+-   Create a new **MigrationsAutomaticDemo** Console application
+-   Add the latest version of the **EntityFramework** NuGet package to the project
+    -   **Tools –&gt; Library Package Manager –&gt; Package Manager Console**
+    -   Run the **Install-Package EntityFramework** command
+-   Add a **Model.cs** file with the code shown below. This code defines a single **Blog** class that makes up our domain model and a **BlogContext** class that is our EF Code First context
+
+  ``` csharp
+      using System.Data.Entity;
+      using System.Collections.Generic;
+      using System.ComponentModel.DataAnnotations;
+      using System.Data.Entity.Infrastructure;
+
+      namespace MigrationsAutomaticDemo
+      {
+          public class BlogContext : DbContext
+          {
+              public DbSet<Blog> Blogs { get; set; }
+          }
+
+          public class Blog
+          {
+              public int BlogId { get; set; }
+              public string Name { get; set; }
+          }
+      }
+  ```
+
+-   Now that we have a model it’s time to use it to perform data access. Update the **Program.cs** file with the code shown below.
+
+  ``` csharp
+      using System;
+      using System.Collections.Generic;
+      using System.Linq;
+      using System.Text;
+
+      namespace MigrationsAutomaticDemo
+      {
+          class Program
+          {
+              static void Main(string[] args)
+              {
+                  using (var db = new BlogContext())
+                  {
+                      db.Blogs.Add(new Blog { Name = "Another Blog " });
+                      db.SaveChanges();
+
+                      foreach (var blog in db.Blogs)
+                      {
+                          Console.WriteLine(blog.Name);
+                      }
+                  }
+
+                  Console.WriteLine("Press any key to exit...");
+                  Console.ReadKey();
+              }
+          }
+      }
+  ```
+
+-   Run your application and you will see that a **MigrationsAutomaticCodeDemo.BlogContext** database is created for you.
+
+    ![Database LocalDB](~/ef6/media/databaselocaldb.png)
+
+## Enabling Migrations
+
+It’s time to make some more changes to our model.
+
+-   Let’s introduce a Url property to the Blog class.
+
+``` csharp
+    public string Url { get; set; }
+```
+
+If you were to run the application again you would get an InvalidOperationException stating *The model backing the 'BlogContext' context has changed since the database was created. Consider using Code First Migrations to update the database (* [*http://go.microsoft.com/fwlink/?LinkId=238269*](https://go.microsoft.com/fwlink/?LinkId=238269)*).*
+
+As the exception suggests, it’s time to start using Code First Migrations. Because we want to use automatic migrations we’re going to specify the **–EnableAutomaticMigrations** switch.
+
+-   Run the **Enable-Migrations –EnableAutomaticMigrations** command in Package Manager Console
+    This command has added a **Migrations** folder to our project. This new folder contains one file:
+
+-   **The Configuration class.** This class allows you to configure how Migrations behaves for your context. For this walkthrough we will just use the default configuration.
+    *Because there is just a single Code First context in your project, Enable-Migrations has automatically filled in the context type this configuration applies to.*
+
+ 
+
+## Your First Automatic Migration
+
+Code First Migrations has two primary commands that you are going to become familiar with.
+
+-   **Add-Migration** will scaffold the next migration based on changes you have made to your model since the last migration was created
+-   **Update-Database** will apply any pending migrations to the database
+
+We are going to avoid using Add-Migration (unless we really need to) and focus on letting Code First Migrations automatically calculate and apply the changes. Let’s use **Update-Database** to get Code First Migrations to push the changes to our model (the new **Blog.Ur**l property) to the database.
+
+-   Run the **Update-Database** command in Package Manager Console.
+
+The **MigrationsAutomaticDemo.BlogContext** database is now updated to include the **Url** column in the **Blogs** table.
+
+ 
+
+## Your Second Automatic Migration
+
+Let’s make another change and let Code First Migrations automatically push the changes to the database for us.
+
+-   Let's also add a new **Post** class
+
+``` csharp
+    public class Post
+    {
+        public int PostId { get; set; }
+        [MaxLength(200)]
+        public string Title { get; set; }
+        public string Content { get; set; }
+
+        public int BlogId { get; set; }
+        public Blog Blog { get; set; }
+    }
+```
+
+-   We'll also add a **Posts** collection to the **Blog** class to form the other end of the relationship between **Blog** and **Post**
+
+``` csharp
+    public virtual List<Post> Posts { get; set; }
+```
+
+Now use **Update-Database** to bring the database up-to-date. This time let’s specify the **–Verbose** flag so that you can see the SQL that Code First Migrations is running.
+
+-   Run the **Update-Database –Verbose** command in Package Manager Console.
+
+## Adding a Code Based Migration
+
+Now let’s look at something we might want to use a code-based migration for.
+
+-   Let’s add a **Rating** property to the **Blog** class
+
+``` csharp
+    public int Rating { get; set; }
+```
+
+We could just run **Update-Database** to push these changes to the database. However, we're adding a non-nullable **Blogs.Rating** column, if there is any existing data in the table it will get assigned the CLR default of the data type for new column (Rating is integer, so that would be **0**). But we want to specify a default value of **3** so that existing rows in the **Blogs** table will start with a decent rating.
+Let’s use the Add-Migration command to write this change out to a code-based migration so that we can edit it. The **Add-Migration** command allows us to give these migrations a name, let’s just call ours **AddBlogRating**.
+
+-   Run the **Add-Migration AddBlogRating** command in Package Manager Console.
+-   In the **Migrations** folder we now have a new **AddBlogRating** migration. The migration filename is pre-fixed with a timestamp to help with ordering. Let’s edit the generated code to specify a default value of 3 for Blog.Rating (Line 10 in the code below)
+
+*The migration also has a code-behind file that captures some metadata. This metadata will allow Code First Migrations to replicate the automatic migrations we performed before this code-based migration. This is important if another developer wants to run our migrations or when it’s time to deploy our application.*
+
+``` csharp
+    namespace MigrationsAutomaticDemo.Migrations
+    {
+        using System;
+        using System.Data.Entity.Migrations;
+
+        public partial class AddBlogRating : DbMigration
+        {
+            public override void Up()
+            {
+                AddColumn("Blogs", "Rating", c => c.Int(nullable: false, defaultValue: 3));
+            }
+
+            public override void Down()
+            {
+                DropColumn("Blogs", "Rating");
+            }
+        }
+    }
+```
+
+Our edited migration is looking good, so let’s use **Update-Database** to bring the database up-to-date.
+
+-   Run the **Update-Database** command in Package Manager Console.
+
+## Back to Automatic Migrations
+
+We are now free to switch back to automatic migrations for our simpler changes. Code First Migrations will take care of performing the automatic and code-based migrations in the correct order based on the metadata it is storing in the code-behind file for each code-based migration.
+
+-   Let’s add a Post.Abstract property to our model
+
+``` csharp
+    public string Abstract { get; set; }
+```
+
+Now we can use **Update-Database** to get Code First Migrations to push this change to the database using an automatic migration.
+
+-   Run the **Update-Database** command in Package Manager Console.
+
+## Summary
+
+In this walkthrough you saw how to use automatic migrations to push model changes to the database. You also saw how to scaffold and run code-based migrations in between automatic migrations when you need more control.
diff --git a/entity-framework/ef6/modeling/code-first/migrations/existing-database.md b/entity-framework/ef6/modeling/code-first/migrations/existing-database.md
new file mode 100644
index 0000000000..dab982a981
--- /dev/null
+++ b/entity-framework/ef6/modeling/code-first/migrations/existing-database.md
@@ -0,0 +1,84 @@
+---
+title: Code First Migrations with an existing database - EF6
+description: Code First Migrations with an existing database in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/code-first/migrations/existing-database
+---
+# Code First Migrations with an existing database
+> [!NOTE]
+> **EF4.3 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 4.1. If you are using an earlier version, some or all of the information does not apply.
+
+This article covers using Code First Migrations with an existing database, one that wasn’t created by Entity Framework.
+
+> [!NOTE]
+> This article assumes you know how to use Code First Migrations in basic scenarios. If you don’t, then you’ll need to read [Code First Migrations](xref:ef6/modeling/code-first/migrations/index) before continuing.
+
+## Step 1: Create a model
+
+Your first step will be to create a Code First model that targets your existing database. The [Code First to an Existing Database](xref:ef6/modeling/code-first/workflows/existing-database) topic provides detailed guidance on how to do this.
+
+>[!NOTE]
+> It is important to follow the rest of the steps in this topic before making any changes to your model that would require changes to the database schema. The following steps require the model to be in-sync with the database schema.
+
+## Step 2: Enable Migrations
+
+The next step is to enable migrations. You can do this by running the **Enable-Migrations** command in Package Manager Console.
+
+This command will create a folder in your solution called Migrations, and put a single class inside it called Configuration. The Configuration class is where you configure migrations for your application, you can find out more about it in the [Code First Migrations](xref:ef6/modeling/code-first/migrations/index) topic.
+
+## Step 3: Add an initial migration
+
+Once migrations have been created and applied to the local database you may also want to apply these changes to other databases. For example, your local database may be a test database and you may ultimately want to also apply the changes to a production database and/or other developers test databases. There are two options for this step and the one you should pick depends whether or not the schema of any other databases is empty or currently matches the schema of the local database.
+
+-   **Option One: Use existing schema as starting point.** You should use this approach when other databases that migrations will be applied to in the future will have the same schema as your local database currently has. For example, you might use this if your local test database currently matches v1 of your production database and you will later apply these migrations to update your production database to v2.
+-   **Option Two: Use empty database as starting point.** You should use this approach when other databases that migrations will be applied to in the future are empty (or do not exist yet). For example, you might use this if you started developing your application using a test database but without using migrations and you will later want to create a production database from scratch.
+
+### Option One: Use existing schema as a starting point
+
+Code First Migrations uses a snapshot of the model stored in the most recent migration to detect changes to the model (you can find detailed information about this in [Code First Migrations in Team Environments](xref:ef6/modeling/code-first/migrations/teams)). Since we are going to assume that databases already have the schema of the current model, we will generate an empty (no-op) migration that has the current model as a snapshot.
+
+1.  Run the **Add-Migration InitialCreate –IgnoreChanges** command in Package Manager Console. This creates an empty migration with the current model as a snapshot.
+2.  Run the **Update-Database** command in Package Manager Console. This will apply the InitialCreate migration to the database. Since the actual migration doesn’t contain any changes, it will simply add a row to the \_\_MigrationsHistory table indicating that this migration has already been applied.
+
+### Option Two: Use empty database as a starting point
+
+In this scenario we need Migrations to be able to create the entire database from scratch – including the tables that are already present in our local database. We’re going to generate an InitialCreate migration that includes logic to create the existing schema. We’ll then make our existing database look like this migration has already been applied.
+
+1.  Run the **Add-Migration InitialCreate** command in Package Manager Console. This creates a migration to create the existing schema.
+2.  Comment out all code in the Up method of the newly created migration. This will allow us to ‘apply’ the migration to the local database without trying to recreate all the tables etc. that already exist.
+3.  Run the **Update-Database** command in Package Manager Console. This will apply the InitialCreate migration to the database. Since the actual migration doesn’t contain any changes (because we temporarily commented them out), it will simply add a row to the \_\_MigrationsHistory table indicating that this migration has already been applied.
+4.  Un-comment the code in the Up method. This means that when this migration is applied to future databases, the schema that already existed in the local database will be created by migrations.
+
+## Things to be aware of
+
+There are a few things you need to be aware of when using Migrations against an existing database.
+
+### Default/calculated names may not match existing schema
+
+Migrations explicitly specifies names for columns and tables when it scaffolds a migrations. However, there are other database objects that Migrations calculates a default name for when applying the migrations. This includes indexes and foreign key constraints. When targeting an existing schema, these calculated names may not match what actually exists in your database.
+
+Here are some examples of when you need to be aware of this:
+
+**If you used ‘Option One: Use existing schema as a starting point’ from Step 3:**
+
+-   If future changes in your model require changing or dropping one of the database objects that is named differently, you will need to modify the scaffolded migration to specify the correct name. The Migrations APIs have an optional Name parameter that allows you to do this.
+    For example, your existing schema may have a Post table with a BlogId foreign key column that has an index named IndexFk\_BlogId. However, by default Migrations would expect this index to be named IX\_BlogId. If you make a change to your model that results in dropping this index, you will need to modify the scaffolded DropIndex call to specify the IndexFk\_BlogId name.
+
+**If you used ‘Option Two: Use empty database as a starting point’ from Step 3:**
+
+-   Trying to run the Down method of the initial migration (that is, reverting to an empty database) against your local database may fail because Migrations will try to drop indexes and foreign key constraints using the incorrect names. This will only affect your local database since other databases will be created from scratch using the Up method of the initial migration.
+    If you want to downgrade your existing local database to an empty state it is easiest to do this manually, either by dropping the database or dropping all the tables. After this initial downgrade all database objects will be recreated with the default names, so this issue will not present itself again.
+-   If future changes in your model require changing or dropping one of the database objects that is named differently, this will not work against your existing local database – since the names won’t match the defaults. However, it will work against databases that were created ‘from scratch’ since they will have used the default names chosen by Migrations.
+    You could either make these changes manually on your local existing database, or consider having Migrations recreate your database from scratch – as it will on other machines.
+-   Databases created using the Up method of your initial migration may differ slightly from the local database since the calculated default names for indexes and foreign key constraints will be used. You may also end up with extra indexes as Migrations will create indexes on foreign key columns by default – this may not have been the case in your original local database.
+
+### Not all database objects are represented in the model
+
+Database objects that are not part of your model will not be handled by Migrations. This can include views, stored procedures, permissions, tables that are not part of your model, additional indexes, etc.
+
+Here are some examples of when you need to be aware of this:
+
+-   Regardless of the option you chose in ‘Step 3’, if future changes in your model require changing or dropping these additional objects Migrations will not know to make these changes. For example, if you drop a column that has an additional index on it, Migrations will not know to drop the index. You will need to manually add this to the scaffolded Migration.
+-   If you used ‘Option Two: Use empty database as a starting point’, these additional objects will not be created by the Up method of your initial migration.
+    You can modify the Up and Down methods to take care of these additional objects if you wish. For objects that are not natively supported in the Migrations API – such as views – you can use the [Sql](https://msdn.microsoft.com/library/system.data.entity.migrations.dbmigration.sql.aspx) method to run raw SQL to create/drop them.
diff --git a/entity-framework/ef6/modeling/code-first/migrations/history-customization.md b/entity-framework/ef6/modeling/code-first/migrations/history-customization.md
new file mode 100644
index 0000000000..0ee0f6dd42
--- /dev/null
+++ b/entity-framework/ef6/modeling/code-first/migrations/history-customization.md
@@ -0,0 +1,87 @@
+---
+title: Customizing the migrations history table - EF6
+description: Customizing the migrations history table in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/code-first/migrations/history-customization
+---
+# Customizing the migrations history table
+> [!NOTE]
+> **EF6 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 6. If you are using an earlier version, some or all of the information does not apply.
+
+> [!NOTE]
+> This article assumes you know how to use Code First Migrations in basic scenarios. If you don’t, then you’ll need to read [Code First Migrations](xref:ef6/modeling/code-first/migrations/index) before continuing.
+
+## What is Migrations History Table?
+
+Migrations history table is a table used by Code First Migrations to store details about migrations applied to the database. By default the name of the table in the database is \_\_MigrationHistory and it is created when applying the first migration to the database. In Entity Framework 5 this table was a system table if the application used Microsoft Sql Server database. This has changed in Entity Framework 6 however and the migrations history table is no longer marked a system table.
+
+## Why customize Migrations History Table?
+
+Migrations history table is supposed to be used solely by Code First Migrations and changing it manually can break migrations. However sometimes the default configuration is not suitable and the table needs to be customized, for instance:
+
+-   You need to change names and/or facets of the columns to enable a 3<sup>rd</sup> party Migrations provider
+-   You want to change the name of the table
+-   You need to use a non-default schema for the \_\_MigrationHistory table
+-   You need to store additional data for a given version of the context and therefore you need to add an additional column to the table
+
+## Words of precaution
+
+Changing the migration history table is powerful but you need to be careful to not overdo it. EF runtime currently does not check whether the customized migrations history table is compatible with the runtime. If it is not your application may break at runtime or behave in unpredictable ways. This is even more important if you use multiple contexts per database in which case multiple contexts can use the same migration history table to store information about migrations.
+
+## How to customize Migrations History Table?
+
+Before you start you need to know that you can customize the migrations history table only before you apply the first migration. Now, to the code.
+
+First, you will need to create a class derived from System.Data.Entity.Migrations.History.HistoryContext class. The HistoryContext class is derived from the DbContext class so configuring the migrations history table is very similar to configuring EF models with fluent API. You just need to override the OnModelCreating method and use fluent API to configure the table.
+
+>[!NOTE]
+> Typically when you configure EF models you don’t need to call base.OnModelCreating() from the overridden OnModelCreating method since the DbContext.OnModelCreating() has empty body. This is not the case when configuring the migrations history table. In this case the first thing to do in your OnModelCreating() override is to actually call base.OnModelCreating(). This will configure the migrations history table in the default way which you then tweak in the overriding method.
+
+Let’s say you want to rename the migrations history table and put it to a custom schema called “admin”. In addition your DBA would like you to rename the MigrationId column to Migration\_ID.  You could achieve this by creating the following class derived from HistoryContext:
+
+``` csharp
+    using System.Data.Common;
+    using System.Data.Entity;
+    using System.Data.Entity.Migrations.History;
+
+    namespace CustomizableMigrationsHistoryTableSample
+    {
+        public class MyHistoryContext : HistoryContext
+        {
+            public MyHistoryContext(DbConnection dbConnection, string defaultSchema)
+                : base(dbConnection, defaultSchema)
+            {
+            }
+
+            protected override void OnModelCreating(DbModelBuilder modelBuilder)
+            {
+                base.OnModelCreating(modelBuilder);
+                modelBuilder.Entity<HistoryRow>().ToTable(tableName: "MigrationHistory", schemaName: "admin");
+                modelBuilder.Entity<HistoryRow>().Property(p => p.MigrationId).HasColumnName("Migration_ID");
+            }
+        }
+    }
+```
+
+Once your custom HistoryContext is ready you need to make EF aware of it by registering it via [code-based configuration](https://msdn.com/data/jj680699):
+
+``` csharp
+    using System.Data.Entity;
+
+    namespace CustomizableMigrationsHistoryTableSample
+    {
+        public class ModelConfiguration : DbConfiguration
+        {
+            public ModelConfiguration()
+            {
+                this.SetHistoryContext("System.Data.SqlClient",
+                    (connection, defaultSchema) => new MyHistoryContext(connection, defaultSchema));
+            }
+        }
+    }
+```
+
+That’s pretty much it. Now you can go to the Package Manager Console, Enable-Migrations, Add-Migration and finally Update-Database. This should result in adding to the database a migrations history table configured according to the details you specified in your HistoryContext derived class.
+
+![Migrations History Table](~/ef6/media/database.png)
diff --git a/entity-framework/ef6/modeling/code-first/migrations/index.md b/entity-framework/ef6/modeling/code-first/migrations/index.md
new file mode 100644
index 0000000000..44430e731f
--- /dev/null
+++ b/entity-framework/ef6/modeling/code-first/migrations/index.md
@@ -0,0 +1,349 @@
+---
+title: Code First Migrations - EF6
+description: Code First Migrations in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/code-first/migrations/index
+---
+# Code First Migrations
+Code First Migrations is the recommended way to evolve your application's database schema if you are using the Code First workflow. Migrations provide a set of tools that allow:
+
+1. Create an initial database that works with your EF model
+2. Generating migrations to keep track of changes you make to your EF model
+2. Keep your database up to date with those changes
+
+The following walkthrough will provide an overview of Code First Migrations in Entity Framework. You can either complete the entire walkthrough or skip to the topic you are interested in. The following topics are covered:
+
+## Building an Initial Model & Database
+
+Before we start using migrations we need a project and a Code First model to work with. For this walkthrough we are going to use the canonical **Blog** and **Post** model.
+
+-   Create a new **MigrationsDemo** Console application
+-   Add the latest version of the **EntityFramework** NuGet package to the project
+    -   **Tools –&gt; Library Package Manager –&gt; Package Manager Console**
+    -   Run the **Install-Package EntityFramework** command
+-   Add a **Model.cs** file with the code shown below. This code defines a single **Blog** class that makes up our domain model and a **BlogContext** class that is our EF Code First context
+
+  ``` csharp
+      using System.Data.Entity;
+      using System.Collections.Generic;
+      using System.ComponentModel.DataAnnotations;
+      using System.Data.Entity.Infrastructure;
+
+      namespace MigrationsDemo
+      {
+          public class BlogContext : DbContext
+          {
+              public DbSet<Blog> Blogs { get; set; }
+          }
+
+          public class Blog
+          {
+              public int BlogId { get; set; }
+              public string Name { get; set; }
+          }
+      }
+  ```
+
+-   Now that we have a model it’s time to use it to perform data access. Update the **Program.cs** file with the code shown below.
+
+  ``` csharp
+      using System;
+      using System.Collections.Generic;
+      using System.Linq;
+      using System.Text;
+
+      namespace MigrationsDemo
+      {
+          class Program
+          {
+              static void Main(string[] args)
+              {
+                  using (var db = new BlogContext())
+                  {
+                      db.Blogs.Add(new Blog { Name = "Another Blog " });
+                      db.SaveChanges();
+
+                      foreach (var blog in db.Blogs)
+                      {
+                          Console.WriteLine(blog.Name);
+                      }
+                  }
+
+                  Console.WriteLine("Press any key to exit...");
+                  Console.ReadKey();
+              }
+          }
+      }
+  ```
+
+-   Run your application and you will see that a **MigrationsCodeDemo.BlogContext** database is created for you.
+
+    ![Database  LocalDB](~/ef6/media/databaselocaldb.png)
+
+## Enabling Migrations
+
+It’s time to make some more changes to our model.
+
+-   Let’s introduce a Url property to the Blog class.
+
+``` csharp
+    public string Url { get; set; }
+```
+
+If you were to run the application again you would get an InvalidOperationException stating *The model backing the 'BlogContext' context has changed since the database was created. Consider using Code First Migrations to update the database (* [*http://go.microsoft.com/fwlink/?LinkId=238269*](https://go.microsoft.com/fwlink/?LinkId=238269)*).*
+
+As the exception suggests, it’s time to start using Code First Migrations. The first step is to enable migrations for our context.
+
+-   Run the **Enable-Migrations** command in Package Manager Console
+
+    This command has added a **Migrations** folder to our project. This new folder contains two files:
+
+-   **The Configuration class.** This class allows you to configure how Migrations behaves for your context. For this walkthrough we will just use the default configuration.
+    *Because there is just a single Code First context in your project, Enable-Migrations has automatically filled in the context type this configuration applies to.*
+-   **An InitialCreate migration**. This migration was generated because we already had Code First create a database for us, before we enabled migrations. The code in this scaffolded migration represents the objects that have already been created in the database. In our case that is the **Blog** table with a **BlogId** and **Name** columns. The filename includes a timestamp to help with ordering.
+    *If the database had not already been created this InitialCreate migration would not have been added to the project. Instead, the first time we call Add-Migration the code to create these tables would be scaffolded to a new migration.*
+
+### Multiple Models Targeting the Same Database
+
+When using versions prior to EF6, only one Code First model could be used to generate/manage the schema of a database. This is the result of a single **\_\_MigrationsHistory** table per database with no way to identify which entries belong to which model.
+
+Starting with EF6, the **Configuration** class includes a **ContextKey** property. This acts as a unique identifier for each Code First model. A corresponding column in the **\_\_MigrationsHistory** table allows entries from multiple models to share the table. By default, this property is set to the fully qualified name of your context.
+
+## Generating & Running Migrations
+
+Code First Migrations has two primary commands that you are going to become familiar with.
+
+-   **Add-Migration** will scaffold the next migration based on changes you have made to your model since the last migration was created
+-   **Update-Database** will apply any pending migrations to the database
+
+We need to scaffold a migration to take care of the new Url property we have added. The **Add-Migration** command allows us to give these migrations a name, let’s just call ours **AddBlogUrl**.
+
+-   Run the **Add-Migration AddBlogUrl** command in Package Manager Console
+-   In the **Migrations** folder we now have a new **AddBlogUrl** migration. The migration filename is pre-fixed with a timestamp to help with ordering
+
+``` csharp
+    namespace MigrationsDemo.Migrations
+    {
+        using System;
+        using System.Data.Entity.Migrations;
+
+        public partial class AddBlogUrl : DbMigration
+        {
+            public override void Up()
+            {
+                AddColumn("dbo.Blogs", "Url", c => c.String());
+            }
+
+            public override void Down()
+            {
+                DropColumn("dbo.Blogs", "Url");
+            }
+        }
+    }
+```
+
+We could now edit or add to this migration but everything looks pretty good. Let’s use **Update-Database** to apply this migration to the database.
+
+-   Run the **Update-Database** command in Package Manager Console
+-   Code First Migrations will compare the migrations in our **Migrations** folder with the ones that have been applied to the database. It will see that the **AddBlogUrl** migration needs to be applied, and run it.
+
+The **MigrationsDemo.BlogContext** database is now updated to include the **Url** column in the **Blogs** table.
+
+## Customizing Migrations
+
+So far we’ve generated and run a migration without making any changes. Now let’s look at editing the code that gets generated by default.
+
+-   It’s time to make some more changes to our model, let’s add a new **Rating** property to the **Blog** class
+
+``` csharp
+    public int Rating { get; set; }
+```
+
+-   Let's also add a new **Post** class
+
+``` csharp
+    public class Post
+    {
+        public int PostId { get; set; }
+        [MaxLength(200)]
+        public string Title { get; set; }
+        public string Content { get; set; }
+
+        public int BlogId { get; set; }
+        public Blog Blog { get; set; }
+    }
+```
+
+-   We'll also add a **Posts** collection to the **Blog** class to form the other end of the relationship between **Blog** and **Post**
+
+``` csharp
+    public virtual List<Post> Posts { get; set; }
+```
+
+We'll use the **Add-Migration** command to let Code First Migrations scaffold its best guess at the migration for us. We’re going to call this migration **AddPostClass**.
+
+-   Run the **Add-Migration AddPostClass** command in Package Manager Console.
+
+Code First Migrations did a pretty good job of scaffolding these changes, but there are some things we might want to change:
+
+1.  First up, let’s add a unique index to **Posts.Title** column
+    (Adding in line 22 & 29 in the code below).
+2.  We’re also adding a non-nullable **Blogs.Rating** column. If there is any existing data in the table it will get assigned the CLR default of the data type for new column (Rating is integer, so that would be **0**). But we want to specify a default value of **3** so that existing rows in the **Blogs** table will start with a decent rating.
+    (You can see the default value specified on line 24 of the code below)
+
+``` csharp
+    namespace MigrationsDemo.Migrations
+    {
+        using System;
+        using System.Data.Entity.Migrations;
+
+        public partial class AddPostClass : DbMigration
+        {
+            public override void Up()
+            {
+                CreateTable(
+                    "dbo.Posts",
+                    c => new
+                        {
+                            PostId = c.Int(nullable: false, identity: true),
+                            Title = c.String(maxLength: 200),
+                            Content = c.String(),
+                            BlogId = c.Int(nullable: false),
+                        })
+                    .PrimaryKey(t => t.PostId)
+                    .ForeignKey("dbo.Blogs", t => t.BlogId, cascadeDelete: true)
+                    .Index(t => t.BlogId)
+                    .Index(p => p.Title, unique: true);
+
+                AddColumn("dbo.Blogs", "Rating", c => c.Int(nullable: false, defaultValue: 3));
+            }
+
+            public override void Down()
+            {
+                DropIndex("dbo.Posts", new[] { "Title" });
+                DropIndex("dbo.Posts", new[] { "BlogId" });
+                DropForeignKey("dbo.Posts", "BlogId", "dbo.Blogs");
+                DropColumn("dbo.Blogs", "Rating");
+                DropTable("dbo.Posts");
+            }
+        }
+    }
+```
+
+Our edited migration is ready to go, so let’s use **Update-Database** to bring the database up-to-date. This time let’s specify the **–Verbose** flag so that you can see the SQL that Code First Migrations is running.
+
+-   Run the **Update-Database –Verbose** command in Package Manager Console.
+
+## Data Motion / Custom SQL
+
+So far we have looked at migration operations that don’t change or move any data, now let’s look at something that needs to move some data around. There is no native support for data motion yet, but we can run some arbitrary SQL commands at any point in our script.
+
+-   Let’s add a **Post.Abstract** property to our model. Later, we’re going to pre-populate the **Abstract** for existing posts using some text from the start of the **Content** column.
+
+``` csharp
+    public string Abstract { get; set; }
+```
+
+We'll use the **Add-Migration** command to let Code First Migrations scaffold its best guess at the migration for us.
+
+-   Run the **Add-Migration AddPostAbstract** command in Package Manager Console.
+-   The generated migration takes care of the schema changes but we also want to pre-populate the **Abstract** column using the first 100 characters of content for each post. We can do this by dropping down to SQL and running an **UPDATE** statement after the column is added.
+    (Adding in line 12 in the code below)
+
+``` csharp
+    namespace MigrationsDemo.Migrations
+    {
+        using System;
+        using System.Data.Entity.Migrations;
+
+        public partial class AddPostAbstract : DbMigration
+        {
+            public override void Up()
+            {
+                AddColumn("dbo.Posts", "Abstract", c => c.String());
+
+                Sql("UPDATE dbo.Posts SET Abstract = LEFT(Content, 100) WHERE Abstract IS NULL");
+            }
+
+            public override void Down()
+            {
+                DropColumn("dbo.Posts", "Abstract");
+            }
+        }
+    }
+```
+
+Our edited migration is looking good, so let’s use **Update-Database** to bring the database up-to-date. We’ll specify the **–Verbose** flag so that we can see the SQL being run against the database.
+
+-   Run the **Update-Database –Verbose** command in Package Manager Console.
+
+## Migrate to a Specific Version (Including Downgrade)
+
+So far we have always upgraded to the latest migration, but there may be times when you want upgrade/downgrade to a specific migration.
+
+Let’s say we want to migrate our database to the state it was in after running our **AddBlogUrl** migration. We can use the **–TargetMigration** switch to downgrade to this migration.
+
+-   Run the **Update-Database –TargetMigration: AddBlogUrl** command in Package Manager Console.
+
+This command will run the Down script for our **AddBlogAbstract** and **AddPostClass** migrations.
+
+If you want to roll all the way back to an empty database then you can use the **Update-Database –TargetMigration: $InitialDatabase** command.
+
+## Getting a SQL Script
+
+If another developer wants these changes on their machine they can just sync once we check our changes into source control. Once they have our new migrations they can just run the Update-Database command to have the changes applied locally. However if we want to push these changes out to a test server, and eventually production, we probably want a SQL script we can hand off to our DBA.
+
+-   Run the **Update-Database** command but this time specify the **–Script** flag so that changes are written to a script rather than applied. We’ll also specify a source and target migration to generate the script for. We want a script to go from an empty database (**$InitialDatabase**) to the latest version (migration **AddPostAbstract**).
+    *If you don’t specify a target migration, Migrations will use the latest migration as the target. If you don't specify a source migrations, Migrations will use the current state of the database.*
+-   Run the **Update-Database -Script -SourceMigration: $InitialDatabase -TargetMigration: AddPostAbstract** command in Package Manager Console
+
+Code First Migrations will run the migration pipeline but instead of actually applying the changes it will write them out to a .sql file for you. Once the script is generated, it is opened for you in Visual Studio, ready for you to view or save.
+
+### Generating Idempotent Scripts
+
+Starting with EF6, if you specify **–SourceMigration $InitialDatabase** then the generated script will be ‘idempotent’. Idempotent scripts can upgrade a database currently at any version to the latest version (or the specified version if you use **–TargetMigration**). The generated script includes logic to check the **\_\_MigrationsHistory** table and only apply changes that haven't been previously applied.
+
+## Automatically Upgrading on Application Startup (MigrateDatabaseToLatestVersion Initializer)
+
+If you are deploying your application you may want it to automatically upgrade the database (by applying any pending migrations) when the application launches. You can do this by registering the **MigrateDatabaseToLatestVersion** database initializer. A database initializer simply contains some logic that is used to make sure the database is setup correctly. This logic is run the first time the context is used within the application process (**AppDomain**).
+
+We can update the **Program.cs** file, as shown below, to set the **MigrateDatabaseToLatestVersion** initializer for BlogContext before we use the context (Line 14). Note that you also need to add a using statement for the **System.Data.Entity** namespace (Line 5).
+
+*When we create an instance of this initializer we need to specify the context type (**BlogContext**) and the migrations configuration (**Configuration**) - the migrations configuration is the class that got added to our **Migrations** folder when we enabled Migrations.*
+
+``` csharp
+    using System;
+    using System.Collections.Generic;
+    using System.Linq;
+    using System.Text;
+    using System.Data.Entity;
+    using MigrationsDemo.Migrations;
+
+    namespace MigrationsDemo
+    {
+        class Program
+        {
+            static void Main(string[] args)
+            {
+                Database.SetInitializer(new MigrateDatabaseToLatestVersion<BlogContext, Configuration>());
+
+                using (var db = new BlogContext())
+                {
+                    db.Blogs.Add(new Blog { Name = "Another Blog " });
+                    db.SaveChanges();
+
+                    foreach (var blog in db.Blogs)
+                    {
+                        Console.WriteLine(blog.Name);
+                    }
+                }
+
+                Console.WriteLine("Press any key to exit...");
+                Console.ReadKey();
+            }
+        }
+    }
+```
+
+Now whenever our application runs it will first check if the database it is targeting is up-to-date, and apply any pending migrations if it is not.
diff --git a/entity-framework/ef6/modeling/code-first/migrations/migrate-exe.md b/entity-framework/ef6/modeling/code-first/migrations/migrate-exe.md
new file mode 100644
index 0000000000..f628550328
--- /dev/null
+++ b/entity-framework/ef6/modeling/code-first/migrations/migrate-exe.md
@@ -0,0 +1,91 @@
+---
+title: Using migrate.exe - EF6
+description: Using migrate.exe in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/code-first/migrations/migrate-exe
+ms.custom: sfi-ropc-nochange
+---
+# Using migrate.exe
+Code First Migrations can be used to update a database from inside visual studio, but can also be executed via the command line tool migrate.exe. This page will give a quick overview on how to use migrate.exe to execute migrations against a database.
+
+> [!NOTE]
+> This article assumes you know how to use Code First Migrations in basic scenarios. If you don’t, then you’ll need to read [Code First Migrations](xref:ef6/modeling/code-first/migrations/index) before continuing.
+
+## Copy migrate.exe
+
+When you install Entity Framework using NuGet migrate.exe will be inside the tools folder of the downloaded package. In &lt;project folder&gt;\\packages\\EntityFramework.&lt;version&gt;\\tools
+
+Once you have migrate.exe then you need to copy it to the location of the assembly that contains your migrations.
+
+If your application targets .NET 4, and not 4.5, then you will need to copy the **Redirect.config** into the location as well and rename it **migrate.exe.config**. This is so that migrate.exe gets the correct binding redirects to be able to locate the Entity Framework assembly.
+
+| .NET 4.5                                      | .NET 4.0                                      |
+|:----------------------------------------------|:----------------------------------------------|
+| ![.NET 4.5 Files](~/ef6/media/net45files.png) | ![.NET 4.0 Files](~/ef6/media/net40files.png) |
+
+> [!NOTE]
+> migrate.exe doesn't support x64 assemblies.
+
+Once you have moved migrate.exe to the correct folder then you should be able to use it to execute migrations against the database. All the utility is designed to do is execute migrations. It cannot generate migrations or create a SQL script.
+
+## See options
+
+``` console
+Migrate.exe /?
+```
+
+The above will display the help page associated with this utility, note that you will need to have the EntityFramework.dll in the same location that you are running migrate.exe in order for this to work.
+
+## Migrate to the latest migration
+
+``` console
+Migrate.exe MyMvcApplication.dll /startupConfigurationFile="..\\web.config"
+```
+
+When running migrate.exe the only mandatory parameter is the assembly, which is the assembly that contains the migrations that you are trying to run, but it will use all convention based settings if you do not specify the configuration file.
+
+## Migrate to a specific migration
+
+``` console
+Migrate.exe MyApp.exe /startupConfigurationFile="MyApp.exe.config" /targetMigration="AddTitle"
+```
+
+If you want to run migrations up to a specific migration, then you can specify the name of the migration. This will run all previous migrations as required until getting to the migration specified.
+
+## Specify working directory
+
+``` console
+Migrate.exe MyApp.exe /startupConfigurationFile="MyApp.exe.config" /startupDirectory="c:\\MyApp"
+```
+
+If you assembly has dependencies or reads files relative to the working directory then you will need to set startupDirectory.
+
+## Specify migration configuration to use
+
+``` console
+Migrate.exe MyAssembly CustomConfig /startupConfigurationFile="..\\web.config"
+```
+
+If you have multiple migration configuration classes, classes inheriting from DbMigrationConfiguration, then you need to specify which is to be used for this execution. This is specified by providing the optional second parameter without a switch as above.
+
+## Provide connection string
+
+``` console
+Migrate.exe BlogDemo.dll /connectionString="Data Source=localhost;Initial Catalog=BlogDemo;Integrated Security=SSPI" /connectionProviderName="System.Data.SqlClient"
+```
+
+If you wish to specify a connection string at the command line then you must also provide the provider name. Not specifying the provider name will cause an exception.
+
+## Common Problems
+
+| Error Message                                                                                                                                                                                                                                                                                                                      | Solution                                                                                                                                                                                                                                                                                             |
+|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| Unhandled Exception: System.IO.FileLoadException:  Could not load file or assembly 'EntityFramework, Version=5.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089' or one of its dependencies. The located assembly's manifest definition does not match the assembly reference. (Exception from HRESULT: 0x80131040)         | This typically means that you are running a .NET 4 application without the Redirect.config file. You need to copy the Redirect.config to the same location as migrate.exe and rename it to migrate.exe.config.                                                                                       |
+| Unhandled Exception: System.IO.FileLoadException: Could not load file or assembly 'EntityFramework, Version=4.4.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089' or one of its dependencies. The located assembly's manifest definition does not match the assembly reference. (Exception from HRESULT: 0x80131040)          | This exception means that you are running a .NET 4.5 application with the Redirect.config copied to the migrate.exe location. If your app is .NET 4.5 then you do not need to have the config file with the redirects inside. Delete the migrate.exe.config file.                                    |
+| ERROR: Unable to update database to match the current model because there are pending changes and automatic migration is disabled. Either write the pending model changes to a code-based migration or enable automatic migration. Set DbMigrationsConfiguration.AutomaticMigrationsEnabled to true to enable automatic migration. | This error occurs if running migrate when you haven’t created a migration to cope with changes made to the model, and the database does not match the model. Adding a property to a model class then running migrate.exe without creating a migration to upgrade the database is an example of this. |
+| ERROR: Type is not resolved for member 'System.Data.Entity.Migrations.Design.ToolingFacade+UpdateRunner,EntityFramework, Version=5.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089'.                                                                                                                                       | This error can be caused by specifying an incorrect startup directory. This must be the location of migrate.exe                                                                                                                                                                                      |
+| Unhandled Exception: System.NullReferenceException: Object reference not set to an instance of an object. <br/>   at System.Data.Entity.Migrations.Console.Program.Main(String[] args)                                                                                                                                             | This can be caused by not specifying a required parameter for a scenario that you are using. For example specifying a connection string without specifying the provider name.                                                                                                                        |
+| ERROR: More than one migrations configuration type was found in the assembly 'ClassLibrary1'. Specify the name of the one to use.                                                                                                                                                                                                  | As the error states, there is more than one configuration class in the given assembly. You must use the /configurationType switch to specify which to use.                                                                                                                                           |
+| ERROR: Could not load file or assembly ‘&lt;assemblyName&gt;’ or one of its dependencies. The given assembly name or codebase was invalid. (Exception from HRESULT: 0x80131047)                                                                                                                                                    | This can be caused by specifying an assembly name incorrectly or not having                                                                                                                                                                                                                          |
+| ERROR: Could not load file or assembly ‘&lt;assemblyName&gt;' or one of its dependencies. An attempt was made to load a program with an incorrect format.                                                                                                                                                                          | This happens if you are trying to run migrate.exe against an x64 application. EF 5.0 and below will only work on x86.                                                                                                                                                                                |
diff --git a/entity-framework/ef6/modeling/code-first/migrations/teams.md b/entity-framework/ef6/modeling/code-first/migrations/teams.md
new file mode 100644
index 0000000000..a57e493aae
--- /dev/null
+++ b/entity-framework/ef6/modeling/code-first/migrations/teams.md
@@ -0,0 +1,165 @@
+---
+title: Code First Migrations in Team Environments - EF6
+description: Code First Migrations in Team Environments in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/code-first/migrations/teams
+---
+# Code First Migrations in Team Environments
+> [!NOTE]
+> This article assumes you know how to use Code First Migrations in basic scenarios. If you don’t, then you’ll need to read [Code First Migrations](xref:ef6/modeling/code-first/migrations/index) before continuing.
+
+## Grab a coffee, you need to read this whole article
+
+The issues in team environments are mostly around merging migrations when two developers have generated migrations in their local code base. While the steps to solve these are pretty simple, they require you to have a solid understanding of how migrations works. Please don’t just skip ahead to the end – take the time to read the whole article to ensure you are successful.
+
+## Some general guidelines
+
+Before we dig into how to manage merging migrations generated by multiple developers, here are some general guidelines to set you up for success.
+
+### Each team member should have a local development database
+
+Migrations uses the **\_\_MigrationsHistory** table to store what migrations have been applied to the database. If you have multiple developers generating different migrations while trying to target the same database (and thus share a **\_\_MigrationsHistory** table) migrations is going to get very confused.
+
+Of course, if you have team members that aren’t generating migrations, there is no problem having them share a central development database.
+
+### Avoid automatic migrations
+
+The bottom line is that automatic migrations initially look good in team environments, but in reality they just don’t work. If you want to know why, keep reading – if not, then you can skip to the next section.
+
+Automatic migrations allows you to have your database schema updated to match the current model without the need to generate code files (code-based migrations). Automatic migrations would work very well in a team environment if you only ever used them and never generated any code-based migrations. The problem is that automatic migrations are limited and don’t handle a number of operations – property/column renames, moving data to another table, etc. To handle these scenarios you end up generating code-based migrations (and editing the scaffolded code) that are mixed in between changes that are handled by automatic migrations. This makes it near on impossible to merge changes when two developers check in migrations.
+
+## Understanding how migrations works
+
+The key to successfully using migrations in a team environment is a basic understanding how migrations tracks and uses information about the model to detect model changes.
+
+### The first migration
+
+When you add the first migration to your project, you run something like **Add-Migration First** in Package Manager Console. The high level steps that this command performs are pictured below.
+
+![First Migration](~/ef6/media/firstmigration.png)
+
+The current model is calculated from your code (1). The required database objects are then calculated by the model differ (2) – since this is the first migration the model differ just uses an empty model for the comparison. The required changes are passed to the code generator to build the required migration code (3) which is then added to your Visual Studio solution (4).
+
+In addition to the actual migration code that is stored in the main code file, migrations also generates some additional code-behind files. These files are metadata that is used by migrations and are not something you should edit. One of these files is a resource file (.resx) that contains a snapshot of the model at the time the migration was generated. You’ll see how this is used in the next step.
+
+At this point you would probably run **Update-Database** to apply your changes to the database, and then go about implementing other areas of your application.
+
+### Subsequent migrations
+
+Later you come back and make some changes to your model – in our example we’ll add a **Url** property to **Blog**. You would then issue a command such as **Add-Migration AddUrl** to scaffold a migration to apply the corresponding database changes. The high level steps that this command performs are pictured below.
+
+![Second Migration](~/ef6/media/secondmigration.png)
+
+Just like last time, the current model is calculated from code (1). However, this time there are existing migrations so the previous model is retrieved from the latest migration (2). These two models are diffed to find the required database changes (3) and then the process completes as before.
+
+This same process is used for any further migrations that you add to the project.
+
+### Why bother with the model snapshot?
+
+You may be wondering why EF bothers with the model snapshot – why not just look at the database. If so, read on. If you’re not interested then you can skip this section.
+
+There are a number of reasons EF keeps the model snapshot around:
+
+-   It allows your database to drift from the EF model. These changes can be made directly in the database, or you can change the scaffolded code in your migrations to make the changes. Here are a couple of examples of this in practice:
+    -   You want to add an Inserted and Updated to column to one or more of your tables but you don’t want to include these columns in the EF model. If migrations looked at the database it would continually try to drop these columns every time you scaffolded a migration. Using the model snapshot, EF will only ever detect legitimate changes to the model.
+    -   You want to change the body of a stored procedure used for updates to include some logging. If migrations looked at this stored procedure from the database it would continually try and reset it back to the definition that EF expects. By using the model snapshot, EF will only ever scaffold code to alter the stored procedure when you change the shape of the procedure in the EF model.
+    -   These same principles apply to adding extra indexes, including extra tables in your database, mapping EF to a database view that sits over a table, etc.
+-   The EF model contains more than just the shape of the database. Having the entire model allows migrations to look at information about the properties and classes in your model and how they map to the columns and tables. This information allows migrations to be more intelligent in the code that it scaffolds. For example, if you change the name of the column that a property maps to migrations can detect the rename by seeing that it’s the same property – something that can’t be done if you only have the database schema. 
+
+## What causes issues in team environments
+
+The workflow covered in the previous section works great when you are a single developer working on an application. It also works well in a team environment if you are the only person making changes to the model. In this scenario you can make model changes, generate migrations and submit them to your source control. Other developers can sync your changes and run **Update-Database** to have the schema changes applied.
+
+Issues start to arise when you have multiple developers making changes to the EF model and submitting to source control at the same time. What EF lacks is a first class way to merge your local migrations with migrations that another developer has submitted to source control since you last synced.
+
+## An example of a merge conflict
+
+First let’s look at a concrete example of such a merge conflict. We’ll continue on with the example we looked at earlier. As a starting point let’s assume the changes from the previous section were checked in by the original developer. We’ll track two developers as they make changes to code base.
+
+We’ll track the EF model and the migrations through a number of changes. For a starting point, both developers have synced to the source control repository, as depicted in the following graphic.
+
+![Starting Point](~/ef6/media/startingpoint.png)
+
+Developer \#1 and developer \#2 now makes some changes to the EF model in their local code base. Developer \#1 adds a **Rating** property to **Blog** – and generates an **AddRating** migration to apply the changes to the database. Developer \#2 adds a **Readers** property to **Blog** – and generates the corresponding **AddReaders** migration. Both developers run **Update-Database**, to apply the changes to their local databases, and then continue developing the application.
+
+> [!NOTE]
+> Migrations are prefixed with a timestamp, so our graphic represents that the AddReaders migration from Developer \#2 comes after the AddRating migration from Developer \#1. Whether developer \#1 or \#2 generated the migration first makes no difference to the issues of working in a team, or the process for merging them that we’ll look at in the next section.
+
+![Local Changes](~/ef6/media/localchanges.png)
+
+It’s a lucky day for Developer \#1 as they happen to submit their changes first. Because no one else has checked in since they synced their repository, they can just submit their changes without performing any merging.
+
+![Submit Changes](~/ef6/media/submit.png)
+
+Now it’s time for Developer \#2 to submit. They aren’t so lucky. Because someone else has submitted changes since they synced, they will need to pull down the changes and merge. The source control system will likely be able to automatically merge the changes at the code level since they are very simple. The state of Developer \#2’s local repository after syncing is depicted in the following graphic. 
+
+![Pull From Source Control](~/ef6/media/pull.png)
+
+At this stage Developer \#2 can run **Update-Database** which will detect the new **AddRating** migration (which hasn’t been applied to Developer \#2’s database) and apply it. Now the **Rating** column is added to the **Blogs** table and the database is in sync with the model.
+
+There are a couple of problems though:
+
+1.  Although **Update-Database** will apply the **AddRating** migration it will also raise a warning: *Unable to update database to match the current model because there are pending changes and automatic migration is disabled…*
+    The problem is that the model snapshot stored in the last migration (**AddReader**) is missing the **Rating** property on **Blog** (since it wasn’t part of the model when the migration was generated). Code First detects that the model in the last migration doesn’t match the current model and raises the warning.
+2.  Running the application would result in an InvalidOperationException stating that “*The model backing the 'BloggingContext' context has changed since the database was created. Consider using Code First Migrations to update the database…”*
+    Again, the problem is the model snapshot stored in the last migration doesn’t match the current model.
+3.  Finally, we would expect running **Add-Migration** now would generate an empty migration (since there are no changes to apply to the database). But because migrations compares the current model to the one from the last migration (which is missing the **Rating** property) it will actually scaffold another **AddColumn** call to add in the **Rating** column. Of course, this migration would fail during **Update-Database** because the **Rating** column already exists.
+
+## Resolving the merge conflict
+
+The good news is that it’s not too hard to deal with the merge manually – provided you have an understanding of how migrations works. So if you’ve skipped ahead to this section… sorry, you need to go back and read the rest of the article first!
+
+There are two options, the easiest is to generate a blank migration that has the correct current model as a snapshot. The second option is to update the snapshot in the last migration to have the correct model snapshot. The second option is a little harder and can’t be used in every scenario, but it’s also cleaner because it doesn’t involve adding an extra migration.
+
+### Option 1: Add a blank ‘merge’ migration
+
+In this option we generate a blank migration solely for the purpose of making sure the latest migration has the correct model snapshot stored in it.
+
+This option can be used regardless of who generated the last migration. In the example we’ve been following Developer \#2 is taking care of the merge and they happened to generate the last migration. But these same steps can be used if Developer \#1 generated the last migration. The steps also apply if there are multiple migrations involved – we’ve just been looking at two in order to keep it simple.
+
+The following process can be used for this approach, starting from the time you realize you have changes that need to be synced from source control.
+
+1.  Ensure any pending model changes in your local code base have been written to a migration. This step ensures you don’t miss any legitimate changes when it comes time to generate the blank migration.
+2.  Sync with source control.
+3.  Run **Update-Database** to apply any new migrations that other developers have checked in.
+    **_Note:_** *if you don’t get any warnings from the Update-Database command then there were no new migrations from other developers and there is no need to perform any further merging.*
+4.  Run **Add-Migration &lt;pick\_a\_name&gt; –IgnoreChanges** (for example, **Add-Migration Merge –IgnoreChanges**). This generates a migration with all the metadata (including a snapshot of the current model) but will ignore any changes it detects when comparing the current model to the snapshot in the last migrations (meaning you get a blank **Up** and **Down** method).
+5.  Run **Update-Database** to re-apply the latest migration with the updated metadata.
+6.  Continue developing, or submit to source control (after running your unit tests of course).
+
+Here is the state of Developer \#2’s local code base after using this approach.
+
+![Merge Migration](~/ef6/media/mergemigration.png)
+
+### Option 2: Update the model snapshot in the last migration
+
+This option is very similar to option 1 but removes the extra blank migration – because let’s face it, who wants extra code files in their solution.
+
+**This approach is only feasible if the latest migration exists only in your local code base and has not yet been submitted to source control (for example, if the last migration was generated by the user doing the merge)**. Editing the metadata of migrations that other developers may have already applied to their development database – or even worse applied to a production database – can result in unexpected side effects. During the process we’re going to roll back the last migration in our local database and re-apply it with updated metadata.
+
+While the last migration needs to just be in the local code base there are no restrictions to the number or order of migrations that proceed it. There can be multiple migrations from multiple different developers and the same steps apply– we’ve just been looking at two in order to keep it simple.
+
+The following process can be used for this approach, starting from the time you realize you have changes that need to be synced from source control.
+
+1.  Ensure any pending model changes in your local code base have been written to a migration. This step ensures you don’t miss any legitimate changes when it comes time to generate the blank migration.
+2.  Sync with the source control.
+3.  Run **Update-Database** to apply any new migrations that other developers have checked in.
+    **_Note:_** *if you don’t get any warnings from the Update-Database command then there were no new migrations from other developers and there is no need to perform any further merging.*
+4.  Run **Update-Database –TargetMigration &lt;second\_last\_migration&gt;** (in the example we’ve been following this would be **Update-Database –TargetMigration AddRating**). This rolls the database back to the state of the second last migration – effectively ‘un-applying’ the last migration from the database.
+    **_Note:_** *This step is required to make it safe to edit the metadata of the migration since the metadata is also stored in the \_\_MigrationsHistoryTable of the database. This is why you should only use this option if the last migration is only in your local code base. If other databases had the last migration applied you would also have to roll them back and re-apply the last migration to update the metadata.* 
+5.  Run **Add-Migration &lt;full\_name\_including\_timestamp\_of\_last\_migration**&gt; (in the example we’ve been following this would be something like **Add-Migration 201311062215252\_AddReaders**).
+    **_Note:_** *You need to include the timestamp so that migrations knows you want to edit the existing migration rather than scaffolding a new one.*
+    This will update the metadata for the last migration to match the current model. You’ll get the following warning when the command completes, but that’s exactly what you want. “*Only the Designer Code for migration '201311062215252\_AddReaders' was re-scaffolded. To re-scaffold the entire migration, use the -Force parameter.”*
+6.  Run **Update-Database** to re-apply the latest migration with the updated metadata.
+7.  Continue developing, or submit to source control (after running your unit tests of course).
+
+Here is the state of Developer \#2’s local code base after using this approach.
+
+![Updated Metadata](~/ef6/media/updatedmetadata.png)
+
+## Summary
+
+There are some challenges when using Code First Migrations in a team environment. However, a basic understanding of how migrations works and some simple approaches for resolving merge conflicts make it easy to overcome these challenges.
+
+The fundamental issue is incorrect metadata stored in the latest migration. This causes Code First to incorrectly detect that the current model and database schema don’t match and to scaffold incorrect code in the next migration. This situation can be overcome by generating a blank migration with the correct model, or updating the metadata in the latest migration.
diff --git a/entity-framework/ef6/modeling/code-first/workflows/existing-database.md b/entity-framework/ef6/modeling/code-first/workflows/existing-database.md
new file mode 100644
index 0000000000..fda7b50a07
--- /dev/null
+++ b/entity-framework/ef6/modeling/code-first/workflows/existing-database.md
@@ -0,0 +1,221 @@
+---
+title: Code First to an Existing Database - EF6
+description: Code First to an Existing Database in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/code-first/workflows/existing-database
+ms.custom: sfi-ropc-nochange
+---
+# Code First to an Existing Database
+This step-by-step walkthrough provides an introduction to Code First development targeting an existing database. Code First allows you to define your model using C\# or VB.Net classes. Optionally additional configuration can be performed using attributes on your classes and properties or by using a fluent API.
+
+## Pre-Requisites
+
+You will need to have **Visual Studio 2012** or **Visual Studio 2013** installed to complete this walkthrough.
+
+You will also need version **6.1** (or later) of the **Entity Framework Tools for Visual Studio** installed. See [Get Entity Framework](xref:ef6/fundamentals/install) for information on installing the latest version of the Entity Framework Tools.
+
+## 1. Create an Existing Database
+
+Typically when you are targeting an existing database it will already be created, but for this walkthrough we need to create a database to access.
+
+Let's go ahead and generate the database.
+
+-   Open Visual Studio
+-   **View -&gt; Server Explorer**
+-   Right click on **Data Connections -&gt; Add Connection…**
+-   If you haven’t connected to a database from **Server Explorer** before you’ll need to select **Microsoft SQL Server** as the data source
+
+    ![Select Data Source](~/ef6/media/selectdatasource.png)
+
+-   Connect to your LocalDB instance, and enter **Blogging** as the database name
+
+    ![LocalDB Connection](~/ef6/media/localdbconnection.png)
+
+-   Select **OK** and you will be asked if you want to create a new database, select **Yes**
+
+    ![Create Database Dialog](~/ef6/media/createdatabasedialog.png)
+
+-   The new database will now appear in Server Explorer, right-click on it and select **New Query**
+-   Copy the following SQL into the new query, then right-click on the query and select **Execute**
+
+``` SQL
+CREATE TABLE [dbo].[Blogs] (
+    [BlogId] INT IDENTITY (1, 1) NOT NULL,
+    [Name] NVARCHAR (200) NULL,
+    [Url]  NVARCHAR (200) NULL,
+    CONSTRAINT [PK_dbo.Blogs] PRIMARY KEY CLUSTERED ([BlogId] ASC)
+);
+
+CREATE TABLE [dbo].[Posts] (
+    [PostId] INT IDENTITY (1, 1) NOT NULL,
+    [Title] NVARCHAR (200) NULL,
+    [Content] NTEXT NULL,
+    [BlogId] INT NOT NULL,
+    CONSTRAINT [PK_dbo.Posts] PRIMARY KEY CLUSTERED ([PostId] ASC),
+    CONSTRAINT [FK_dbo.Posts_dbo.Blogs_BlogId] FOREIGN KEY ([BlogId]) REFERENCES [dbo].[Blogs] ([BlogId]) ON DELETE CASCADE
+);
+
+INSERT INTO [dbo].[Blogs] ([Name],[Url])
+VALUES ('The Visual Studio Blog', 'http://blogs.msdn.com/visualstudio/')
+
+INSERT INTO [dbo].[Blogs] ([Name],[Url])
+VALUES ('.NET Framework Blog', 'http://blogs.msdn.com/dotnet/')
+```
+
+## 2. Create the Application
+
+To keep things simple we will build a basic console application that uses Code First to do the data access:
+
+-   Open Visual Studio
+-   **File -&gt; New -&gt; Project…**
+-   Select **Windows** from the left menu and **Console Application**
+-   Enter **CodeFirstExistingDatabaseSample** as the name
+-   Select **OK**
+
+ 
+
+## 3. Reverse Engineer Model
+
+We will use the Entity Framework Tools for Visual Studio to help us generate some initial code to map to the database. These tools are just generating code that you could also type by hand if you prefer.
+
+-   **Project -&gt; Add New Item…**
+-   Select **Data** from the left menu and then **ADO.NET Entity Data Model**
+-   Enter **BloggingContext** as the name and click **OK**
+-   This launches the **Entity Data Model Wizard**
+-   Select **Code First from Database** and click **Next**
+
+    ![Wizard One CFE](~/ef6/media/wizardonecfe.png)
+
+-   Select the connection to the database you created in the first section and click **Next**
+
+    ![Wizard Two CFE](~/ef6/media/wizardtwocfe.png)
+
+-   Click the checkbox next to **Tables** to import all tables and click **Finish**
+
+    ![Wizard Three CFE](~/ef6/media/wizardthreecfe.png)
+
+Once the reverse engineer process completes a number of items will have been added to the project, let's take a look at what's been added.
+
+### Configuration file
+
+An App.config file has been added to the project, this file contains the connection string to the existing database.
+
+``` xml
+<connectionStrings>
+  <add  
+    name="BloggingContext"  
+    connectionString="data source=(localdb)\mssqllocaldb;initial catalog=Blogging;integrated security=True;MultipleActiveResultSets=True;App=EntityFramework"  
+    providerName="System.Data.SqlClient" />
+</connectionStrings>
+```
+
+*You’ll notice some other settings in the configuration file too, these are default EF settings that tell Code First where to create databases. Since we are mapping to an existing database these setting will be ignored in our application.*
+
+### Derived Context
+
+A **BloggingContext** class has been added to the project. The context represents a session with the database, allowing us to query and save data.
+The context exposes a **DbSet&lt;TEntity&gt;** for each type in our model. You’ll also notice that the default constructor calls a base constructor using the **name=** syntax. This tells Code First that the connection string to use for this context should be loaded from the configuration file.
+
+``` csharp
+public partial class BloggingContext : DbContext
+    {
+        public BloggingContext()
+            : base("name=BloggingContext")
+        {
+        }
+
+        public virtual DbSet<Blog> Blogs { get; set; }
+        public virtual DbSet<Post> Posts { get; set; }
+
+        protected override void OnModelCreating(DbModelBuilder modelBuilder)
+        {
+        }
+    }
+```
+
+*You should always use the **name=** syntax when you are using a connection string in the config file. This ensures that if the connection string is not present then Entity Framework will throw rather than creating a new database by convention.*
+
+### Model classes
+
+Finally, a **Blog** and **Post** class have also been added to the project. These are the domain classes that make up our model. You'll see Data Annotations applied to the classes to specify configuration where the Code First conventions would not align with the structure of the existing database. For example, you'll see the **StringLength** annotation on **Blog.Name** and **Blog.Url** since they have a maximum length of **200** in the database (the Code First default is to use the maximum length supported by the database provider - **nvarchar(max)** in SQL Server).
+
+``` csharp
+public partial class Blog
+{
+    public Blog()
+    {
+        Posts = new HashSet<Post>();
+    }
+
+    public int BlogId { get; set; }
+
+    [StringLength(200)]
+    public string Name { get; set; }
+
+    [StringLength(200)]
+    public string Url { get; set; }
+
+    public virtual ICollection<Post> Posts { get; set; }
+}
+```
+
+## 4. Reading & Writing Data
+
+Now that we have a model it’s time to use it to access some data. Implement the **Main** method in **Program.cs** as shown below. This code creates a new instance of our context and then uses it to insert a new **Blog**. Then it uses a LINQ query to retrieve all **Blogs** from the database ordered alphabetically by **Title**.
+
+``` csharp
+class Program
+{
+    static void Main(string[] args)
+    {
+        using (var db = new BloggingContext())
+        {
+            // Create and save a new Blog
+            Console.Write("Enter a name for a new Blog: ");
+            var name = Console.ReadLine();
+
+            var blog = new Blog { Name = name };
+            db.Blogs.Add(blog);
+            db.SaveChanges();
+
+            // Display all Blogs from the database
+            var query = from b in db.Blogs
+                        orderby b.Name
+                        select b;
+
+            Console.WriteLine("All blogs in the database:");
+            foreach (var item in query)
+            {
+                Console.WriteLine(item.Name);
+            }
+
+            Console.WriteLine("Press any key to exit...");
+            Console.ReadKey();
+        }
+    }
+}
+```
+
+You can now run the application and test it.
+
+```console
+Enter a name for a new Blog: ADO.NET Blog
+All blogs in the database:
+.NET Framework Blog
+ADO.NET Blog
+The Visual Studio Blog
+Press any key to exit...
+```
+ 
+## What if My Database Changes?
+
+The Code First to Database wizard is designed to generate a starting point set of classes that you can then tweak and modify. If your database schema changes you can either manually edit the classes or perform another reverse engineer to overwrite the classes.
+
+## Using Code First Migrations to an Existing Database
+
+If you want to use Code First Migrations with an existing database, see [Code First Migrations to an existing database](xref:ef6/modeling/code-first/migrations/existing-database).
+
+## Summary
+
+In this walkthrough we looked at Code First development using an existing database. We used the Entity Framework Tools for Visual Studio to reverse engineer a set of classes that mapped to the database and could be used to store and retrieve data.
diff --git a/entity-framework/ef6/modeling/code-first/workflows/new-database.md b/entity-framework/ef6/modeling/code-first/workflows/new-database.md
new file mode 100644
index 0000000000..494c672922
--- /dev/null
+++ b/entity-framework/ef6/modeling/code-first/workflows/new-database.md
@@ -0,0 +1,368 @@
+---
+title: Code First to a New Database - EF6
+description: Code First to a New Database in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/code-first/workflows/new-database
+ms.custom: sfi-ropc-nochange
+---
+# Code First to a New Database
+This video and step-by-step walkthrough provide an introduction to Code First development targeting a new database. This scenario includes targeting a database that doesn’t exist and Code First will create, or an empty database that Code First will add new tables to. Code First allows you to define your model using C\# or VB.Net classes. Additional configuration can optionally be performed using attributes on your classes and properties or by using a fluent API.
+
+## Watch the video
+This video provides an introduction to Code First development targeting a new database. This scenario includes targeting a database that doesn’t exist and Code First will create, or an empty database that Code First will add new tables to. Code First allows you to define your model using C# or VB.Net classes. Additional configuration can optionally be performed using attributes on your classes and properties or by using a fluent API.
+
+**Presented By**: [Rowan Miller](https://romiller.com/)
+
+**Video**: [WMV](https://download.microsoft.com/download/B/A/5/BA57BADE-D558-4693-8F82-29E64E4084AB/HDI-ITPro-MSDN-winvideo-CodeFirstNewDatabase.wmv) | [MP4](https://download.microsoft.com/download/B/A/5/BA57BADE-D558-4693-8F82-29E64E4084AB/HDI-ITPro-MSDN-mp4Video-CodeFirstNewDatabase.m4v) | [WMV (ZIP)](https://download.microsoft.com/download/B/A/5/BA57BADE-D558-4693-8F82-29E64E4084AB/HDI-ITPro-MSDN-winvideo-CodeFirstNewDatabase.zip)
+
+## Pre-Requisites
+
+You will need to have at least Visual Studio 2010 or Visual Studio 2012 installed to complete this walkthrough.
+
+If you are using Visual Studio 2010, you will also need to have [NuGet](https://visualstudiogallery.msdn.microsoft.com/27077b70-9dad-4c64-adcf-c7cf6bc9970c) installed.
+
+## 1. Create the Application
+
+To keep things simple we’re going to build a basic console application that uses Code First to perform data access.
+
+-   Open Visual Studio
+-   **File -&gt; New -&gt; Project…**
+-   Select **Windows** from the left menu and **Console Application**
+-   Enter **CodeFirstNewDatabaseSample** as the name
+-   Select **OK**
+
+## 2. Create the Model
+
+Let’s define a very simple model using classes. We’re just defining them in the Program.cs file but in a real world application you would split your classes out into separate files and potentially a separate project.
+
+Below the Program class definition in Program.cs add the following two classes.
+
+``` csharp
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Name { get; set; }
+
+    public virtual List<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int BlogId { get; set; }
+    public virtual Blog Blog { get; set; }
+}
+```
+
+You’ll notice that we’re making the two navigation properties (Blog.Posts and Post.Blog) virtual. This enables the Lazy Loading feature of Entity Framework. Lazy Loading means that the contents of these properties will be automatically loaded from the database when you try to access them.
+
+## 3. Create a Context
+
+Now it’s time to define a derived context, which represents a session with the database, allowing us to query and save data. We define a context that derives from System.Data.Entity.DbContext and exposes a typed DbSet&lt;TEntity&gt; for each class in our model.
+
+We’re now starting to use types from the Entity Framework so we need to add the EntityFramework NuGet package.
+
+-   **Project –&gt; Manage NuGet Packages…**
+    Note: If you don’t have the **Manage NuGet Packages…** option you should install the [latest version of NuGet](https://visualstudiogallery.msdn.microsoft.com/27077b70-9dad-4c64-adcf-c7cf6bc9970c)
+-   Select the **Online** tab
+-   Select the **EntityFramework** package
+-   Click **Install**
+
+Add a using statement for System.Data.Entity at the top of Program.cs.
+
+``` csharp
+using System.Data.Entity;
+```
+
+Below the Post class in Program.cs add the following derived context.
+
+``` csharp
+public class BloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+}
+```
+
+Here is a complete listing of what Program.cs should now contain.
+
+``` csharp
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using System.Data.Entity;
+
+namespace CodeFirstNewDatabaseSample
+{
+    class Program
+    {
+        static void Main(string[] args)
+        {
+        }
+    }
+
+    public class Blog
+    {
+        public int BlogId { get; set; }
+        public string Name { get; set; }
+
+        public virtual List<Post> Posts { get; set; }
+    }
+
+    public class Post
+    {
+        public int PostId { get; set; }
+        public string Title { get; set; }
+        public string Content { get; set; }
+
+        public int BlogId { get; set; }
+        public virtual Blog Blog { get; set; }
+    }
+
+    public class BloggingContext : DbContext
+    {
+        public DbSet<Blog> Blogs { get; set; }
+        public DbSet<Post> Posts { get; set; }
+    }
+}
+```
+
+That is all the code we need to start storing and retrieving data. Obviously there is quite a bit going on behind the scenes and we’ll take a look at that in a moment but first let’s see it in action.
+
+## 4. Reading & Writing Data
+
+Implement the Main method in Program.cs as shown below. This code creates a new instance of our context and then uses it to insert a new Blog. Then it uses a LINQ query to retrieve all Blogs from the database ordered alphabetically by Title.
+
+``` csharp
+class Program
+{
+    static void Main(string[] args)
+    {
+        using (var db = new BloggingContext())
+        {
+            // Create and save a new Blog
+            Console.Write("Enter a name for a new Blog: ");
+            var name = Console.ReadLine();
+
+            var blog = new Blog { Name = name };
+            db.Blogs.Add(blog);
+            db.SaveChanges();
+
+            // Display all Blogs from the database
+            var query = from b in db.Blogs
+                        orderby b.Name
+                        select b;
+
+            Console.WriteLine("All blogs in the database:");
+            foreach (var item in query)
+            {
+                Console.WriteLine(item.Name);
+            }
+
+            Console.WriteLine("Press any key to exit...");
+            Console.ReadKey();
+        }
+    }
+}
+```
+
+You can now run the application and test it out.
+
+```console
+Enter a name for a new Blog: ADO.NET Blog
+All blogs in the database:
+ADO.NET Blog
+Press any key to exit...
+```
+### Where’s My Data?
+
+By convention DbContext has created a database for you.
+
+-   If a local SQL Express instance is available (installed by default with Visual Studio 2010) then Code First has created the database on that instance
+-   If SQL Express isn’t available then Code First will try and use [LocalDB](https://msdn.microsoft.com/library/hh510202(v=sql.110).aspx) (installed by default with Visual Studio 2012)
+-   The database is named after the fully qualified name of the derived context, in our case that is **CodeFirstNewDatabaseSample.BloggingContext**
+
+These are just the default conventions and there are various ways to change the database that Code First uses, more information is available in the **How DbContext Discovers the Model and Database Connection** topic.
+You can connect to this database using Server Explorer in Visual Studio
+
+-   **View -&gt; Server Explorer**
+-   Right click on **Data Connections** and select **Add Connection…**
+-   If you haven’t connected to a database from Server Explorer before you’ll need to select Microsoft SQL Server as the data source
+
+    ![Select Data Source](~/ef6/media/selectdatasource.png)
+
+-   Connect to either LocalDB or SQL Express, depending on which one you have installed
+
+We can now inspect the schema that Code First created.
+
+![Schema Initial](~/ef6/media/schemainitial.png)
+
+DbContext worked out what classes to include in the model by looking at the DbSet properties that we defined. It then uses the default set of Code First conventions to determine table and column names, determine data types, find primary keys, etc. Later in this walkthrough we’ll look at how you can override these conventions.
+
+## 5. Dealing with Model Changes
+
+Now it’s time to make some changes to our model, when we make these changes we also need to update the database schema. To do this we are going to use a feature called Code First Migrations, or Migrations for short.
+
+Migrations allows us to have an ordered set of steps that describe how to upgrade (and downgrade) our database schema. Each of these steps, known as a migration, contains some code that describes the changes to be applied. 
+
+The first step is to enable Code First Migrations for our BloggingContext.
+
+-   **Tools -&gt; Library Package Manager -&gt; Package Manager Console**
+-   Run the **Enable-Migrations** command in Package Manager Console
+-   A new Migrations folder has been added to our project that contains two items:
+    -   **Configuration.cs** – This file contains the settings that Migrations will use for migrating BloggingContext. We don’t need to change anything for this walkthrough, but here is where you can specify seed data, register providers for other databases, changes the namespace that migrations are generated in etc.
+    -   **&lt;timestamp&gt;\_InitialCreate.cs** – This is your first migration, it represents the changes that have already been applied to the database to take it from being an empty database to one that includes the Blogs and Posts tables. Although we let Code First automatically create these tables for us, now that we have opted in to Migrations they have been converted into a Migration. Code First has also recorded in our local database that this Migration has already been applied. The timestamp on the filename is used for ordering purposes.
+
+    Now let’s make a change to our model, add a Url property to the Blog class:
+
+``` csharp
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Name { get; set; }
+    public string Url { get; set; }
+
+    public virtual List<Post> Posts { get; set; }
+}
+```
+
+-   Run the **Add-Migration AddUrl** command in Package Manager Console.
+    The Add-Migration command checks for changes since your last migration and scaffolds a new migration with any changes that are found. We can give migrations a name; in this case we are calling the migration ‘AddUrl’.
+    The scaffolded code is saying that we need to add a Url column, that can hold string data, to the dbo.Blogs table. If needed, we could edit the scaffolded code but that’s not required in this case.
+
+``` csharp
+namespace CodeFirstNewDatabaseSample.Migrations
+{
+    using System;
+    using System.Data.Entity.Migrations;
+
+    public partial class AddUrl : DbMigration
+    {
+        public override void Up()
+        {
+            AddColumn("dbo.Blogs", "Url", c => c.String());
+        }
+
+        public override void Down()
+        {
+            DropColumn("dbo.Blogs", "Url");
+        }
+    }
+}
+```
+
+-   Run the **Update-Database** command in Package Manager Console. This command will apply any pending migrations to the database. Our InitialCreate migration has already been applied so migrations will just apply our new AddUrl migration.
+    Tip: You can use the **–Verbose** switch when calling Update-Database to see the SQL that is being executed against the database.
+
+The new Url column is now added to the Blogs table in the database:
+
+![Schema With Url](~/ef6/media/schemawithurl.png)
+
+## 6. Data Annotations
+
+So far we’ve just let EF discover the model using its default conventions, but there are going to be times when our classes don’t follow the conventions and we need to be able to perform further configuration. There are two options for this; we’ll look at Data Annotations in this section and then the fluent API in the next section.
+
+-   Let’s add a User class to our model
+
+``` csharp
+public class User
+{
+    public string Username { get; set; }
+    public string DisplayName { get; set; }
+}
+```
+
+-   We also need to add a set to our derived context
+
+``` csharp
+public class BloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+    public DbSet<User> Users { get; set; }
+}
+```
+
+-   If we tried to add a migration we’d get an error saying “*EntityType ‘User’ has no key defined. Define the key for this EntityType.”* because EF has no way of knowing that Username should be the primary key for User.
+-   We’re going to use Data Annotations now so we need to add a using statement at the top of Program.cs
+
+```csharp
+using System.ComponentModel.DataAnnotations;
+```
+
+-   Now annotate the Username property to identify that it is the primary key
+
+``` csharp
+public class User
+{
+    [Key]
+    public string Username { get; set; }
+    public string DisplayName { get; set; }
+}
+```
+
+-   Use the **Add-Migration AddUser** command to scaffold a migration to apply these changes to the database
+-   Run the **Update-Database** command to apply the new migration to the database
+
+The new table is now added to the database:
+
+![Schema With Users](~/ef6/media/schemawithusers.png)
+
+The full list of annotations supported by EF is:
+
+-   [KeyAttribute](https://msdn.microsoft.com/library/system.componentmodel.dataannotations.keyattribute)
+-   [StringLengthAttribute](https://msdn.microsoft.com/library/system.componentmodel.dataannotations.stringlengthattribute)
+-   [MaxLengthAttribute](https://msdn.microsoft.com/library/system.componentmodel.dataannotations.maxlengthattribute)
+-   [ConcurrencyCheckAttribute](https://msdn.microsoft.com/library/system.componentmodel.dataannotations.concurrencycheckattribute)
+-   [RequiredAttribute](https://msdn.microsoft.com/library/system.componentmodel.dataannotations.requiredattribute)
+-   [TimestampAttribute](https://msdn.microsoft.com/library/system.componentmodel.dataannotations.timestampattribute)
+-   [ComplexTypeAttribute](https://msdn.microsoft.com/library/system.componentmodel.dataannotations.schema.complextypeattribute)
+-   [ColumnAttribute](https://msdn.microsoft.com/library/system.componentmodel.dataannotations.schema.columnattribute)
+-   [TableAttribute](https://msdn.microsoft.com/library/system.componentmodel.dataannotations.schema.tableattribute)
+-   [InversePropertyAttribute](https://msdn.microsoft.com/library/system.componentmodel.dataannotations.schema.inversepropertyattribute)
+-   [ForeignKeyAttribute](https://msdn.microsoft.com/library/system.componentmodel.dataannotations.schema.foreignkeyattribute)
+-   [DatabaseGeneratedAttribute](https://msdn.microsoft.com/library/system.componentmodel.dataannotations.schema.databasegeneratedattribute)
+-   [NotMappedAttribute](https://msdn.microsoft.com/library/system.componentmodel.dataannotations.schema.notmappedattribute)
+
+## 7. Fluent API
+
+In the previous section we looked at using Data Annotations to supplement or override what was detected by convention. The other way to configure the model is via the Code First fluent API.
+
+Most model configuration can be done using simple data annotations. The fluent API is a more advanced way of specifying model configuration that covers everything that data annotations can do in addition to some more advanced configuration not possible with data annotations. Data annotations and the fluent API can be used together.
+
+To access the fluent API you override the OnModelCreating method in DbContext. Let’s say we wanted to rename the column that User.DisplayName is stored in to display\_name.
+
+-   Override the OnModelCreating method on BloggingContext with the following code
+
+``` csharp
+public class BloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+    public DbSet<User> Users { get; set; }
+
+    protected override void OnModelCreating(DbModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<User>()
+            .Property(u => u.DisplayName)
+            .HasColumnName("display_name");
+    }
+}
+```
+
+-   Use the **Add-Migration ChangeDisplayName** command to scaffold a migration to apply these changes to the database.
+-   Run the **Update-Database** command to apply the new migration to the database.
+
+The DisplayName column is now renamed to display\_name:
+
+![Schema With Display Name Renamed](~/ef6/media/schemawithdisplaynamerenamed.png)
+
+## Summary
+
+In this walkthrough we looked at Code First development using a new database. We defined a model using classes then used that model to create a database and store and retrieve data. Once the database was created we used Code First Migrations to change the schema as our model evolved. We also saw how to configure a model using Data Annotations and the Fluent API.
diff --git a/entity-framework/ef6/modeling/designer/advanced/defining-query.md b/entity-framework/ef6/modeling/designer/advanced/defining-query.md
new file mode 100644
index 0000000000..8858c586e6
--- /dev/null
+++ b/entity-framework/ef6/modeling/designer/advanced/defining-query.md
@@ -0,0 +1,202 @@
+---
+title: Defining Query - EF Designer - EF6
+description: Defining Query - EF Designer in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/designer/advanced/defining-query
+---
+# Defining Query - EF Designer
+This walkthrough demonstrates how to add a defining query and a corresponding entity type to a model using the EF Designer. A defining query is commonly used to provide functionality similar to that provided by a database view, but the view is defined in the model, not the database. A defining query allows you to execute a SQL statement that is specified in the **DefiningQuery** element of an .edmx file. For more information, see **DefiningQuery** in the [SSDL Specification](xref:ef6/modeling/designer/advanced/edmx/ssdl-spec).
+
+When using defining queries, you also have to define an entity type in your model. The entity type is used to surface data exposed by the defining query. Note that data surfaced through this entity type is read-only.
+
+Parameterized queries cannot be executed as defining queries. However, the data can be updated by mapping the insert, update, and delete functions of the entity type that surfaces the data to stored procedures. For more information, see [Insert, Update, and Delete with Stored Procedures](xref:ef6/modeling/designer/stored-procedures/cud).
+
+This topic shows how to perform the following tasks.
+
+-   Add a Defining Query
+-   Add an Entity Type to the Model
+-   Map the Defining Query to the Entity Type
+
+## Prerequisites
+
+To complete this walkthrough, you will need:
+
+- A recent version of Visual Studio.
+- The [School sample database](xref:ef6/resources/school-database).
+
+## Set up the Project
+
+This walkthrough is using Visual Studio 2012 or newer.
+
+-   Open Visual Studio.
+-   On the **File** menu, point to **New**, and then click **Project**.
+-   In the left pane, click **Visual C\#**, and then select the **Console Application** template.
+-   Enter **DefiningQuerySample** as the name of the project and click **OK**.
+
+ 
+
+## Create a Model based on the School Database
+
+-   Right-click the project name in Solution Explorer, point to **Add**, and then click **New Item**.
+-   Select **Data** from the left menu and then select **ADO.NET Entity Data Model** in the Templates pane.
+-   Enter **DefiningQueryModel.edmx** for the file name, and then click **Add**.
+-   In the Choose Model Contents dialog box, select **Generate from database**, and then click **Next**.
+-   Click New Connection. In the Connection Properties dialog box, enter the server name (for example, **(localdb)\\mssqllocaldb**), select the authentication method, type **School** for the database name, and then click **OK**.
+    The Choose Your Data Connection dialog box is updated with your database connection setting.
+-   In the Choose Your Database Objects dialog box, check the **Tables** node. This will add all the tables to the **School** model.
+-   Click **Finish**.
+-   In Solution Explorer, right-click the **DefiningQueryModel.edmx** file and select **Open With…**.
+-   Select **XML (Text) Editor**.
+
+    ![XML Editor](~/ef6/media/xmleditor.png)
+
+-   Click **Yes** if prompted with the following message:
+
+    ![Warning 2](~/ef6/media/warning2.png)
+
+ 
+
+## Add a Defining Query
+
+In this step we will use the XML Editor to add a defining query and an entity type to the SSDL section of the .edmx file. 
+
+-   Add an **EntitySet** element to the SSDL section of the .edmx file (line 5 thru 13). Specify the following:
+    -   Only the **Name** and **EntityType** attributes of the **EntitySet** element are specified.
+    -   The fully-qualified name of the entity type is used in the **EntityType** attribute.
+    -   The SQL statement to be executed is specified in the **DefiningQuery** element.
+
+``` xml
+    <!-- SSDL content -->
+    <edmx:StorageModels>
+      <Schema Namespace="SchoolModel.Store" Alias="Self" Provider="System.Data.SqlClient" ProviderManifestToken="2008" xmlns:store="http://schemas.microsoft.com/ado/2007/12/edm/EntityStoreSchemaGenerator" xmlns="http://schemas.microsoft.com/ado/2009/11/edm/ssdl">
+        <EntityContainer Name="SchoolModelStoreContainer">
+           <EntitySet Name="GradeReport" EntityType="SchoolModel.Store.GradeReport">
+              <DefiningQuery>
+                SELECT CourseID, Grade, FirstName, LastName
+                FROM StudentGrade
+                JOIN
+                (SELECT * FROM Person WHERE EnrollmentDate IS NOT NULL) AS p
+                ON StudentID = p.PersonID
+              </DefiningQuery>
+          </EntitySet>
+          <EntitySet Name="Course" EntityType="SchoolModel.Store.Course" store:Type="Tables" Schema="dbo" />
+```
+
+-   Add the **EntityType** element to the SSDL section of the .edmx. file as shown below. Note the following:
+    -   The value of the **Name** attribute corresponds to the value of the **EntityType** attribute in the **EntitySet** element above, although the fully-qualified name of the entity type is used in the **EntityType** attribute.
+    -   The property names correspond to the column names returned by the SQL statement in the **DefiningQuery** element (above).
+    -   In this example, the entity key is composed of three properties to ensure a unique key value.
+
+``` xml
+    <EntityType Name="GradeReport">
+      <Key>
+        <PropertyRef Name="CourseID" />
+        <PropertyRef Name="FirstName" />
+        <PropertyRef Name="LastName" />
+      </Key>
+      <Property Name="CourseID"
+                Type="int"
+                Nullable="false" />
+      <Property Name="Grade"
+                Type="decimal"
+                Precision="3"
+                Scale="2" />
+      <Property Name="FirstName"
+                Type="nvarchar"
+                Nullable="false"
+                MaxLength="50" />
+      <Property Name="LastName"
+                Type="nvarchar"
+                Nullable="false"
+                MaxLength="50" />
+    </EntityType>
+```
+
+>[!NOTE]
+> If later you run the **Update Model Wizard** dialog, any changes made to the storage model, including defining queries, will be overwritten.
+
+ 
+
+## Add an Entity Type to the Model
+
+In this step we will add the entity type to the conceptual model using the EF Designer.  Note the following:
+
+-   The **Name** of the entity corresponds to the value of the **EntityType** attribute in the **EntitySet** element above.
+-   The property names correspond to the column names returned by the SQL statement in the **DefiningQuery** element above.
+-   In this example, the entity key is composed of three properties to ensure a unique key value.
+
+Open the model in the EF Designer.
+
+-   Double-click the DefiningQueryModel.edmx.
+-   Say **Yes** to the following message:
+
+    ![Warning 2](~/ef6/media/warning2.png)
+
+ 
+
+The Entity Designer, which provides a design surface for editing your model, is displayed.
+
+-   Right-click the designer surface and select **Add New**-&gt;**Entity…**.
+-   Specify **GradeReport** for the entity name and **CourseID** for the **Key Property**.
+-   Right-click the **GradeReport** entity and select **Add New**-&gt; **Scalar Property**.
+-   Change the default name of the property to **FirstName**.
+-   Add another scalar property and specify **LastName** for the name.
+-   Add another scalar property and specify **Grade** for the name.
+-   In the **Properties** window, change the **Grade**’s **Type** property to **Decimal**.
+-   Select the **FirstName** and **LastName** properties.
+-   In the **Properties** window, change the **EntityKey** property value to **True**.
+
+As a result, the following elements were added to the **CSDL** section of the .edmx file.
+
+``` xml
+    <EntitySet Name="GradeReport" EntityType="SchoolModel.GradeReport" />
+
+    <EntityType Name="GradeReport">
+    . . .
+    </EntityType>
+```
+
+ 
+
+## Map the Defining Query to the Entity Type
+
+In this step, we will use the Mapping Details window to map the conceptual and storage entity types.
+
+-   Right-click the **GradeReport** entity on the design surface and select **Table Mapping**.  
+    The **Mapping Details** window is displayed.
+-   Select **GradeReport** from the **&lt;Add a Table or View&gt;** dropdown list (located under **Table**s).  
+    Default mappings between the conceptual and storage **GradeReport** entity type appear.  
+    ![Mapping Details3](~/ef6/media/mappingdetails.png)
+
+As a result, the **EntitySetMapping** element is added to the mapping section of the .edmx file. 
+
+``` xml
+    <EntitySetMapping Name="GradeReports">
+      <EntityTypeMapping TypeName="IsTypeOf(SchoolModel.GradeReport)">
+        <MappingFragment StoreEntitySet="GradeReport">
+          <ScalarProperty Name="LastName" ColumnName="LastName" />
+          <ScalarProperty Name="FirstName" ColumnName="FirstName" />
+          <ScalarProperty Name="Grade" ColumnName="Grade" />
+          <ScalarProperty Name="CourseID" ColumnName="CourseID" />
+        </MappingFragment>
+      </EntityTypeMapping>
+    </EntitySetMapping>
+```
+
+-   Compile the application.
+
+ 
+
+## Call the Defining Query in your Code
+
+You can now execute the defining query by using the **GradeReport** entity type. 
+
+``` csharp
+    using (var context = new SchoolEntities())
+    {
+        var report = context.GradeReports.FirstOrDefault();
+        Console.WriteLine("{0} {1} got {2}",
+            report.FirstName, report.LastName, report.Grade);
+    }
+```
diff --git a/entity-framework/ef6/modeling/designer/advanced/edmx/csdl-spec.md b/entity-framework/ef6/modeling/designer/advanced/edmx/csdl-spec.md
new file mode 100644
index 0000000000..01c8667ae6
--- /dev/null
+++ b/entity-framework/ef6/modeling/designer/advanced/edmx/csdl-spec.md
@@ -0,0 +1,2094 @@
+---
+title: CSDL Specification - EF6
+description: CSDL Specification in Entity Framework 6
+author: SamMonoRT
+ms.date: 08/23/2024
+uid: ef6/modeling/designer/advanced/edmx/csdl-spec
+---
+# CSDL Specification
+
+> [!NOTE]
+> CSDL v1 is unsupported, please update to V3
+
+Conceptual schema definition language (CSDL) is an XML-based language that describes the entities, relationships, and functions that make up a conceptual model of a data-driven application. This conceptual model can be used by the Entity Framework or WCF Data Services. The metadata that is described with CSDL is used by the Entity Framework to map entities and relationships that are defined in a conceptual model to a data source. For more information, see [SSDL Specification](xref:ef6/modeling/designer/advanced/edmx/ssdl-spec) and [MSL Specification](xref:ef6/modeling/designer/advanced/edmx/msl-spec).
+
+CSDL is the Entity Framework's implementation of the Entity Data Model.
+
+In an Entity Framework application, conceptual model metadata is loaded from a .csdl file (written in CSDL) into an instance of the System.Data.Metadata.Edm.EdmItemCollection and is accessible by using methods in the System.Data.Metadata.Edm.MetadataWorkspace class. Entity Framework uses conceptual model metadata to translate queries against the conceptual model to data source-specific commands.
+
+The EF Designer stores conceptual model information in an .edmx file at design time. At build time, the EF Designer uses information in an .edmx file to create the .csdl file that is needed by Entity Framework at runtime.
+
+Versions of CSDL are differentiated by XML namespaces.
+
+| CSDL Version | XML Namespace                                |
+|:-------------|:---------------------------------------------|
+| CSDL v1      | `https://schemas.microsoft.com/ado/2006/04/edm` |
+| CSDL v2      | `https://schemas.microsoft.com/ado/2008/09/edm` |
+| CSDL v3      | `https://schemas.microsoft.com/ado/2009/11/edm` |
+
+## Association Element (CSDL)
+
+An **Association** element defines a relationship between two entity types. An association must specify the entity types that are involved in the relationship and the possible number of entity types at each end of the relationship, which is known as the multiplicity. The multiplicity of an association end can have a value of one (1), zero or one (0..1), or many (\*). This information is specified in two child End elements.
+
+Entity type instances at one end of an association can be accessed through navigation properties or foreign keys, if they are exposed on an entity type.
+
+In an application, an instance of an association represents a specific association between instances of entity types. Association instances are logically grouped in an association set.
+
+An **Association** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one element)
+-   End (exactly 2 elements)
+-   ReferentialConstraint (zero or one element)
+-   Annotation elements (zero or more elements)
+
+### Applicable Attributes
+
+The table below describes the attributes that can be applied to the **Association** element.
+
+| Attribute Name | Is Required | Value                        |
+|:---------------|:------------|:-----------------------------|
+| **Name**       | Yes         | The name of the association. |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **Association** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+### Example
+
+The following example shows an **Association** element that defines the **CustomerOrders** association when foreign keys have not been exposed on the **Customer** and **Order** entity types. The **Multiplicity** values for each **End** of the association indicate that many **Orders** can be associated with a **Customer**, but only one **Customer** can be associated with an **Order**. Additionally, the **OnDelete** element indicates that all **Orders** that are related to a particular **Customer** and have been loaded into the ObjectContext will be deleted if the **Customer** is deleted.
+
+``` xml
+ <Association Name="CustomerOrders">
+   <End Type="ExampleModel.Customer" Role="Customer" Multiplicity="1" >
+         <OnDelete Action="Cascade" />
+   </End>
+   <End Type="ExampleModel.Order" Role="Order" Multiplicity="*" />
+ </Association>
+```
+ 
+
+The following example shows an **Association** element that defines the **CustomerOrders** association when foreign keys have been exposed on the **Customer** and **Order** entity types. With foreign keys exposed, the relationship between the entities is managed with a **ReferentialConstraint** element. A corresponding AssociationSetMapping element is not necessary to map this association to the data source.
+
+``` xml
+ <Association Name="CustomerOrders">
+   <End Type="ExampleModel.Customer" Role="Customer" Multiplicity="1" >
+         <OnDelete Action="Cascade" />
+   </End>
+   <End Type="ExampleModel.Order" Role="Order" Multiplicity="*" />
+   <ReferentialConstraint>
+        <Principal Role="Customer">
+            <PropertyRef Name="Id" />
+        </Principal>
+        <Dependent Role="Order">
+             <PropertyRef Name="CustomerId" />
+         </Dependent>
+   </ReferentialConstraint>
+ </Association>
+```
+ 
+
+ 
+
+## AssociationSet Element (CSDL)
+
+The **AssociationSet** element in conceptual schema definition language (CSDL) is a logical container for association instances of the same type. An association set provides a definition for grouping association instances so that they can be mapped to a data source.  
+
+The **AssociationSet** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one elements allowed)
+-   End (exactly two elements required)
+-   Annotation elements (zero or more elements allowed)
+
+The **Association** attribute specifies the type of association that an association set contains. The entity sets that make up the ends of an association set are specified with exactly two child **End** elements.
+
+### Applicable Attributes
+
+The table below describes the attributes that can be applied to the **AssociationSet** element.
+
+| Attribute Name  | Is Required | Value                                                                                                                                                             |
+|:----------------|:------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Name**        | Yes         | The name of the entity set. The value of the **Name** attribute cannot be the same as the value of the **Association** attribute.                                 |
+| **Association** | Yes         | The fully-qualified name of the association that the association set contains instances of. The association must be in the same namespace as the association set. |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **AssociationSet** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+### Example
+
+The following example shows an **EntityContainer** element with two **AssociationSet** elements:
+
+``` xml
+ <EntityContainer Name="BooksContainer" >
+   <EntitySet Name="Books" EntityType="BooksModel.Book" />
+   <EntitySet Name="Publishers" EntityType="BooksModel.Publisher" />
+   <EntitySet Name="Authors" EntityType="BooksModel.Author" />
+   <AssociationSet Name="PublishedBy" Association="BooksModel.PublishedBy">
+     <End Role="Book" EntitySet="Books" />
+     <End Role="Publisher" EntitySet="Publishers" />
+   </AssociationSet>
+   <AssociationSet Name="WrittenBy" Association="BooksModel.WrittenBy">
+     <End Role="Book" EntitySet="Books" />
+     <End Role="Author" EntitySet="Authors" />
+   </AssociationSet>
+ </EntityContainer>
+```
+ 
+
+ 
+
+## CollectionType Element (CSDL)
+
+The **CollectionType** element in conceptual schema definition language (CSDL) specifies that a function parameter or function return type is a collection. The **CollectionType** element can be a child of the Parameter element or the ReturnType (Function) element. The type of collection can be specified by using either the **Type** attribute or one of the following child elements:
+
+-   **CollectionType**
+-   ReferenceType
+-   RowType
+-   TypeRef
+
+> [!NOTE]
+> A model will not validate if the type of a collection is specified with both the **Type** attribute and a child element.
+
+ 
+
+### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **CollectionType** element. Note that the **DefaultValue**, **MaxLength**, **FixedLength**, **Precision**, **Scale**, **Unicode**, and **Collation** attributes are only applicable to collections of **EDMSimpleTypes**.
+
+| Attribute Name                                                          | Is Required | Value                                                                                                                                                                                                                            |
+|:------------------------------------------------------------------------|:------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Type**                                                                | No          | The type of the collection.                                                                                                                                                                                                      |
+| **Nullable**                                                            | No          | **True** (the default value) or **False** depending on whether the property can have a null value. <br/> [!NOTE]                                                                                                                 |
+| > In the CSDL v1, a complex type property must have `Nullable="False"`. |             |                                                                                                                                                                                                                                  |
+| **DefaultValue**                                                        | No          | The default value of the property.                                                                                                                                                                                               |
+| **MaxLength**                                                           | No          | The maximum length of the property value.                                                                                                                                                                                        |
+| **FixedLength**                                                         | No          | **True** or **False** depending on whether the property value will be stored as a fixed length string.                                                                                                                           |
+| **Precision**                                                           | No          | The precision of the property value.                                                                                                                                                                                             |
+| **Scale**                                                               | No          | The scale of the property value.                                                                                                                                                                                                 |
+| **SRID**                                                                | No          | Spatial System Reference Identifier. Valid only for properties of spatial types.   For more information, see [SRID](https://en.wikipedia.org/wiki/SRID) and [SRID (SQL Server)](https://msdn.microsoft.com/library/bb964707.aspx) |
+| **Unicode**                                                             | No          | **True** or **False** depending on whether the property value will be stored as a Unicode string.                                                                                                                                |
+| **Collation**                                                           | No          | A string that specifies the collating sequence to be used in the data source.                                                                                                                                                    |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **CollectionType** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+### Example
+
+The following example shows a model-defined function that that uses a **CollectionType** element to specify that the function returns a collection of **Person** entity types (as specified with the **ElementType** attribute).
+
+``` xml
+ <Function Name="LastNamesAfter">
+        <Parameter Name="someString" Type="Edm.String"/>
+        <ReturnType>
+             <CollectionType  ElementType="SchoolModel.Person"/>
+        </ReturnType>
+        <DefiningExpression>
+             SELECT VALUE p
+             FROM SchoolEntities.People AS p
+             WHERE p.LastName >= someString
+        </DefiningExpression>
+ </Function>
+```
+ 
+
+The following example shows a model-defined function that uses a **CollectionType** element to specify that the function returns a collection of rows (as specified in the **RowType** element).
+
+``` xml
+ <Function Name="LastNamesAfter">
+   <Parameter Name="someString" Type="Edm.String" />
+   <ReturnType>
+    <CollectionType>
+      <RowType>
+        <Property Name="FirstName" Type="Edm.String" Nullable="false" />
+        <Property Name="LastName" Type="Edm.String" Nullable="false" />
+      </RowType>
+    </CollectionType>
+   </ReturnType>
+   <DefiningExpression>
+             SELECT VALUE ROW(p.FirstName, p.LastName)
+             FROM SchoolEntities.People AS p
+             WHERE p.LastName &gt;= somestring
+   </DefiningExpression>
+ </Function>
+```
+ 
+
+The following example shows a model-defined function that uses the **CollectionType** element to specify that the function accepts as a parameter a collection of **Department** entity types.
+
+``` xml
+ <Function Name="GetAvgBudget">
+      <Parameter Name="Departments">
+          <CollectionType>
+             <TypeRef Type="SchoolModel.Department"/>
+          </CollectionType>
+           </Parameter>
+       <ReturnType Type="Collection(Edm.Decimal)"/>
+       <DefiningExpression>
+             SELECT VALUE AVG(d.Budget) FROM Departments AS d
+       </DefiningExpression>
+ </Function>
+```
+ 
+
+ 
+
+## ComplexType Element (CSDL)
+
+A **ComplexType** element defines a data structure composed of **EdmSimpleType** properties or other complex types.  A complex type can be a property of an entity type or another complex type. A complex type is similar to an entity type in that a complex type defines data. However, there are some key differences between complex types and entity types:
+
+-   Complex types do not have identities (or keys) and therefore cannot exist independently. Complex types can only exist as properties of entity types or other complex types.
+-   Complex types cannot participate in associations. Neither end of an association can be a complex type, and therefore navigation properties cannot be defined for complex types.
+-   A complex type property cannot have a null value, though the scalar properties of a complex type may each be set to null.
+
+A **ComplexType** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one element)
+-   Property (zero or more elements)
+-   Annotation elements (zero or more elements)
+
+The table below describes the attributes that can be applied to the **ComplexType** element.
+
+| Attribute Name                                                                                                 | Is Required | Value                                                                                                                                                                               |
+|:---------------------------------------------------------------------------------------------------------------|:------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| Name                                                                                                           | Yes         | The name of the complex type. The name of a complex type cannot be the same as the name of another complex type, entity type, or association that is within the scope of the model. |
+| BaseType                                                                                                       | No          | The name of another complex type that is the base type of the complex type that is being defined. <br/> [!NOTE]                                                                     |
+| > This attribute is not applicable in CSDL v1. Inheritance for complex types is not supported in that version. |             |                                                                                                                                                                                     |
+| Abstract                                                                                                       | No          | **True** or **False** (the default value) depending on whether the complex type is an abstract type. <br/> [!NOTE]                                                                  |
+| > This attribute is not applicable in CSDL v1. Complex types in that version cannot be abstract types.         |             |                                                                                                                                                                                     |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **ComplexType** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+### Example
+
+The following example shows a complex type, **Address**, with the **EdmSimpleType** properties **StreetAddress**, **City**, **StateOrProvince**, **Country**, and **PostalCode**.
+
+``` xml
+ <ComplexType Name="Address" >
+   <Property Type="String" Name="StreetAddress" Nullable="false" />
+   <Property Type="String" Name="City" Nullable="false" />
+   <Property Type="String" Name="StateOrProvince" Nullable="false" />
+   <Property Type="String" Name="Country" Nullable="false" />
+   <Property Type="String" Name="PostalCode" Nullable="false" />
+ </ComplexType>
+```
+ 
+
+To define the complex type **Address** (above) as a property of an entity type, you must declare the property type in the entity type definition. The following example shows the **Address** property as a complex type on an entity type (**Publisher**):
+
+``` xml
+ <EntityType Name="Publisher">
+       <Key>
+         <PropertyRef Name="Id" />
+       </Key>
+       <Property Type="Int32" Name="Id" Nullable="false" />
+       <Property Type="String" Name="Name" Nullable="false" />
+       <Property Type="BooksModel.Address" Name="Address" Nullable="false" />
+       <NavigationProperty Name="Books" Relationship="BooksModel.PublishedBy"
+                           FromRole="Publisher" ToRole="Book" />
+     </EntityType>
+```
+ 
+
+ 
+
+## DefiningExpression Element (CSDL)
+
+The **DefiningExpression** element in conceptual schema definition language (CSDL) contains an Entity SQL expression that defines a function in the conceptual model.  
+
+> [!NOTE]
+> For validation purposes, a **DefiningExpression** element can contain arbitrary content. However, Entity Framework will throw an exception at runtime if a **DefiningExpression** element does not contain valid Entity SQL.
+
+ 
+
+### Applicable Attributes
+
+Any number of annotation attributes (custom XML attributes) may be applied to the **DefiningExpression** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+### Example
+
+The following example uses a **DefiningExpression** element to define a function that returns the number of years since a book was published. The content of the **DefiningExpression** element is written in Entity SQL.
+
+``` xml
+ <Function Name="GetYearsInPrint" ReturnType="Edm.Int32" >
+       <Parameter Name="book" Type="BooksModel.Book" />
+       <DefiningExpression>
+         Year(CurrentDateTime()) - Year(cast(book.PublishedDate as DateTime))
+       </DefiningExpression>
+     </Function>
+```
+ 
+
+ 
+
+## Dependent Element (CSDL)
+
+The **Dependent** element in conceptual schema definition language (CSDL) is a child element to the ReferentialConstraint element and defines the dependent end of a referential constraint. A **ReferentialConstraint** element defines functionality that is similar to a referential integrity constraint in a relational database. In the same way that a column (or columns) from a database table can reference the primary key of another table, a property (or properties) of an entity type can reference the entity key of another entity type. The entity type that is referenced is called the *principal end* of the constraint. The entity type that references the principal end is called the *dependent end* of the constraint. **PropertyRef** elements are used to specify which keys reference the principal end.
+
+The **Dependent** element can have the following child elements (in the order listed):
+
+-   PropertyRef (one or more elements)
+-   Annotation elements (zero or more elements)
+
+### Applicable Attributes
+
+The table below describes the attributes that can be applied to the **Dependent** element.
+
+| Attribute Name | Is Required | Value                                                                |
+|:---------------|:------------|:---------------------------------------------------------------------|
+| **Role**       | Yes         | The name of the entity type on the dependent end of the association. |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **Dependent** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+### Example
+
+The following example shows a **ReferentialConstraint** element being used as part of the definition of the **PublishedBy** association. The **PublisherId** property of the **Book** entity type makes up the dependent end of the referential constraint.
+
+``` xml
+ <Association Name="PublishedBy">
+   <End Type="BooksModel.Book" Role="Book" Multiplicity="*" >
+   </End>
+   <End Type="BooksModel.Publisher" Role="Publisher" Multiplicity="1" />
+   <ReferentialConstraint>
+     <Principal Role="Publisher">
+       <PropertyRef Name="Id" />
+     </Principal>
+     <Dependent Role="Book">
+       <PropertyRef Name="PublisherId" />
+     </Dependent>
+   </ReferentialConstraint>
+ </Association>
+```
+ 
+
+ 
+
+## Documentation Element (CSDL)
+
+The **Documentation** element in conceptual schema definition language (CSDL) can be used to provide information about an object that is defined in a parent element. In an .edmx file, when the **Documentation** element is a child of an element that appears as an object on the design surface of the EF Designer  (such as an entity, association, or property), the contents of the **Documentation** element will appear in the Visual Studio **Properties** window for the object.
+
+The **Documentation** element can have the following child elements (in the order listed):
+
+-   **Summary**: A brief description of the parent element. (zero or one element)
+-   **LongDescription**: An extensive description of the parent element. (zero or one element)
+-   Annotation elements. (zero or more elements)
+
+### Applicable Attributes
+
+Any number of annotation attributes (custom XML attributes) may be applied to the **Documentation** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+### Example
+
+The following example shows the **Documentation** element as a child element of an EntityType element. If the snippet below were in the CSDL content of an .edmx file, the contents of the **Summary** and **LongDescription** elements would appear in the Visual Studio **Properties** window when you click on the `Customer` entity type.
+
+``` xml
+ <EntityType Name="Customer">
+    <Documentation>
+      <Summary>Summary here.</Summary>
+      <LongDescription>Long description here.</LongDescription>
+    </Documentation>
+    <Key>
+      <PropertyRef Name="CustomerId" />
+    </Key>
+    <Property Type="Int32" Name="CustomerId" Nullable="false" />
+    <Property Type="String" Name="Name" Nullable="false" />
+ </EntityType>
+```
+ 
+
+ 
+
+## End Element (CSDL)
+
+The **End** element in conceptual schema definition language (CSDL) can be a child of the Association element or the AssociationSet element. In each case, the role of the **End** element is different and the applicable attributes are different.
+
+### End Element as a Child of the Association Element
+
+An **End** element (as a child of the **Association** element) identifies the entity type on one end of an association and the number of entity type instances that can exist at that end of an association. Association ends are defined as part of an association; an association must have exactly two association ends. Entity type instances at one end of an association can be accessed through navigation properties or foreign keys if they are exposed on an entity type.  
+
+An **End** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one element)
+-   OnDelete (zero or one element)
+-   Annotation elements (zero or more elements)
+
+#### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **End** element when it is the child of an **Association** element.
+
+| Attribute Name   | Is Required | Value                                                                                                                                                                                                                                                                                                                                                                                                              |
+|:-----------------|:------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Type**         | Yes         | The name of the entity type at one end of the association.                                                                                                                                                                                                                                                                                                                                                         |
+| **Role**         | No          | A name for the association end. If no name is provided, the name of the entity type on the association end will be used.                                                                                                                                                                                                                                                                                           |
+| **Multiplicity** | Yes         | **1**, **0..1**, or **\*** depending on the number of entity type instances that can be at the end of the association. <br/> **1** indicates that exactly one entity type instance exists at the association end. <br/> **0..1** indicates that zero or one entity type instances exist at the association end. <br/> **\*** indicates that zero, one, or more entity type instances exist at the association end. |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **End** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+#### Example
+
+The following example shows an **Association** element that defines the **CustomerOrders** association. The **Multiplicity** values for each **End** of the association indicate that many **Orders** can be associated with a **Customer**, but only one **Customer** can be associated with an **Order**. Additionally, the **OnDelete** element indicates that all **Orders** that are related to a particular **Customer** and that have been loaded into the ObjectContext will be deleted if the **Customer** is deleted.
+
+``` xml
+ <Association Name="CustomerOrders">
+   <End Type="ExampleModel.Customer" Role="Customer" Multiplicity="1" />
+   <End Type="ExampleModel.Order" Role="Order" Multiplicity="*">
+         <OnDelete Action="Cascade" />
+   </End>
+ </Association>
+```
+ 
+
+### End Element as a Child of the AssociationSet Element
+
+The **End** element specifies one end of an association set. The **AssociationSet** element must contain two **End** elements. The information contained in an **End** element is used in mapping an association set to a data source.
+
+An **End** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one element)
+-   Annotation elements (zero or more elements)
+
+> [!NOTE]
+> Annotation elements must appear after all other child elements. Annotation elements are only allowed in CSDL v2 and later.
+
+ 
+
+#### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **End** element when it is the child of an **AssociationSet** element.
+
+| Attribute Name | Is Required | Value                                                                                                                                                                                                                 |
+|:---------------|:------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **EntitySet**  | Yes         | The name of the **EntitySet** element that defines one end of the parent **AssociationSet** element. The **EntitySet** element must be defined in the same entity container as the parent **AssociationSet** element. |
+| **Role**       | No          | The name of the association set end. If the **Role** attribute is not used, the name of the association set end will be the name of the entity set.                                                                   |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **End** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+#### Example
+
+The following example shows an **EntityContainer** element with two **AssociationSet** elements, each with two **End** elements:
+
+``` xml
+ <EntityContainer Name="BooksContainer" >
+   <EntitySet Name="Books" EntityType="BooksModel.Book" />
+   <EntitySet Name="Publishers" EntityType="BooksModel.Publisher" />
+   <EntitySet Name="Authors" EntityType="BooksModel.Author" />
+   <AssociationSet Name="PublishedBy" Association="BooksModel.PublishedBy">
+     <End Role="Book" EntitySet="Books" />
+     <End Role="Publisher" EntitySet="Publishers" />
+   </AssociationSet>
+   <AssociationSet Name="WrittenBy" Association="BooksModel.WrittenBy">
+     <End Role="Book" EntitySet="Books" />
+     <End Role="Author" EntitySet="Authors" />
+   </AssociationSet>
+ </EntityContainer>
+```
+ 
+
+ 
+
+## EntityContainer Element (CSDL)
+
+The **EntityContainer** element in conceptual schema definition language (CSDL) is a logical container for entity sets, association sets, and function imports. A conceptual model entity container maps to a storage model entity container through the EntityContainerMapping element. A storage model entity container describes the structure of the database: entity sets describe tables, association sets describe foreign key constraints, and function imports describe stored procedures in a database.
+
+An **EntityContainer** element can have zero or one Documentation elements. If a **Documentation** element is present, it must precede all **EntitySet**, **AssociationSet**, and **FunctionImport** elements.
+
+An **EntityContainer** element can have zero or more of the following child elements (in the order listed):
+
+-   EntitySet
+-   AssociationSet
+-   FunctionImport
+-   Annotation elements
+
+You can extend an **EntityContainer** element to include the contents of another **EntityContainer** that is within the same namespace. To include the contents of another **EntityContainer**, in the referencing **EntityContainer** element, set the value of the **Extends** attribute to the name of the **EntityContainer** element that you want to include. All child elements of the included **EntityContainer** element will be treated as child elements of the referencing **EntityContainer** element.
+
+### Applicable Attributes
+
+The table below describes the attributes that can be applied to the **Using** element.
+
+| Attribute Name | Is Required | Value                                                           |
+|:---------------|:------------|:----------------------------------------------------------------|
+| **Name**       | Yes         | The name of the entity container.                               |
+| **Extends**    | No          | The name of another entity container within the same namespace. |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **EntityContainer** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+### Example
+
+The following example shows an **EntityContainer** element that defines three entity sets and two association sets.
+
+``` xml
+ <EntityContainer Name="BooksContainer" >
+   <EntitySet Name="Books" EntityType="BooksModel.Book" />
+   <EntitySet Name="Publishers" EntityType="BooksModel.Publisher" />
+   <EntitySet Name="Authors" EntityType="BooksModel.Author" />
+   <AssociationSet Name="PublishedBy" Association="BooksModel.PublishedBy">
+     <End Role="Book" EntitySet="Books" />
+     <End Role="Publisher" EntitySet="Publishers" />
+   </AssociationSet>
+   <AssociationSet Name="WrittenBy" Association="BooksModel.WrittenBy">
+     <End Role="Book" EntitySet="Books" />
+     <End Role="Author" EntitySet="Authors" />
+   </AssociationSet>
+ </EntityContainer>
+```
+ 
+
+ 
+
+## EntitySet Element (CSDL)
+
+The **EntitySet** element in conceptual schema definition language is a logical container for instances of an entity type and instances of any type that is derived from that entity type. The relationship between an entity type and an entity set is analogous to the relationship between a row and a table in a relational database. Like a row, an entity type defines a set of related data, and, like a table, an entity set contains instances of that definition. An entity set provides a construct for grouping entity type instances so that they can be mapped to related data structures in a data source.  
+
+More than one entity set for a particular entity type may be defined.
+
+> [!NOTE]
+> The EF Designer does not support conceptual models that contain multiple entity sets per type.
+
+ 
+
+The **EntitySet** element can have the following child elements (in the order listed):
+
+-   Documentation Element (zero or one elements allowed)
+-   Annotation elements (zero or more elements allowed)
+
+### Applicable Attributes
+
+The table below describes the attributes that can be applied to the **EntitySet** element.
+
+| Attribute Name | Is Required | Value                                                                                    |
+|:---------------|:------------|:-----------------------------------------------------------------------------------------|
+| **Name**       | Yes         | The name of the entity set.                                                              |
+| **EntityType** | Yes         | The fully-qualified name of the entity type for which the entity set contains instances. |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **EntitySet** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+### Example
+
+The following example shows an **EntityContainer** element with three **EntitySet** elements:
+
+``` xml
+ <EntityContainer Name="BooksContainer" >
+   <EntitySet Name="Books" EntityType="BooksModel.Book" />
+   <EntitySet Name="Publishers" EntityType="BooksModel.Publisher" />
+   <EntitySet Name="Authors" EntityType="BooksModel.Author" />
+   <AssociationSet Name="PublishedBy" Association="BooksModel.PublishedBy">
+     <End Role="Book" EntitySet="Books" />
+     <End Role="Publisher" EntitySet="Publishers" />
+   </AssociationSet>
+   <AssociationSet Name="WrittenBy" Association="BooksModel.WrittenBy">
+     <End Role="Book" EntitySet="Books" />
+     <End Role="Author" EntitySet="Authors" />
+   </AssociationSet>
+ </EntityContainer>
+```
+ 
+
+It is possible to define multiple entity sets per type (MEST). The following example defines an entity container with two entity sets for the **Book** entity type:
+
+``` xml
+ <EntityContainer Name="BooksContainer" >
+   <EntitySet Name="Books" EntityType="BooksModel.Book" />
+   <EntitySet Name="FictionBooks" EntityType="BooksModel.Book" />
+   <EntitySet Name="Publishers" EntityType="BooksModel.Publisher" />
+   <EntitySet Name="Authors" EntityType="BooksModel.Author" />
+   <AssociationSet Name="PublishedBy" Association="BooksModel.PublishedBy">
+     <End Role="Book" EntitySet="Books" />
+     <End Role="Publisher" EntitySet="Publishers" />
+   </AssociationSet>
+   <AssociationSet Name="BookAuthor" Association="BooksModel.BookAuthor">
+     <End Role="Book" EntitySet="Books" />
+     <End Role="Author" EntitySet="Authors" />
+   </AssociationSet>
+ </EntityContainer>
+```
+ 
+
+ 
+
+## EntityType Element (CSDL)
+
+The **EntityType** element represents the structure of a top-level concept, such as a customer or order, in a conceptual model. An entity type is a template for instances of entity types in an application. Each template contains the following information:
+
+-   A unique name. (Required.)
+-   An entity key that is defined by one or more properties. (Required.)
+-   Properties for containing data. (Optional.)
+-   Navigation properties that allow for navigation from one end of an association to the other end. (Optional.)
+
+In an application, an instance of an entity type represents a specific object (such as a specific customer or order). Each instance of an entity type must have a unique entity key within an entity set.
+
+Two entity type instances are considered equal only if they are of the same type and the values of their entity keys are the same.
+
+An **EntityType** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one element)
+-   Key (zero or one element)
+-   Property (zero or more elements)
+-   NavigationProperty (zero or more elements)
+-   Annotation elements (zero or more elements)
+
+### Applicable Attributes
+
+The table below describes the attributes that can be applied to the **EntityType** element.
+
+| Attribute Name                                                                                                                                  | Is Required | Value                                                                                            |
+|:------------------------------------------------------------------------------------------------------------------------------------------------|:------------|:-------------------------------------------------------------------------------------------------|
+| **Name**                                                                                                                                        | Yes         | The name of the entity type.                                                                     |
+| **BaseType**                                                                                                                                    | No          | The name of another entity type that is the base type of the entity type that is being defined.  |
+| **Abstract**                                                                                                                                    | No          | **True** or **False**, depending on whether the entity type is an abstract type.                 |
+| **OpenType**                                                                                                                                    | No          | **True** or **False** depending on whether the entity type is an open entity type. <br/> [!NOTE] |
+| > The **OpenType** attribute is only applicable to entity types that are defined in conceptual models that are used with ADO.NET Data Services. |             |                                                                                                  |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **EntityType** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+### Example
+
+The following example shows an **EntityType** element with three **Property** elements and two **NavigationProperty** elements:
+
+``` xml
+ <EntityType Name="Book">
+   <Key>
+     <PropertyRef Name="ISBN" />
+   </Key>
+   <Property Type="String" Name="ISBN" Nullable="false" />
+   <Property Type="String" Name="Title" Nullable="false" />
+   <Property Type="Decimal" Name="Revision" Nullable="false" Precision="29" Scale="29" />
+   <NavigationProperty Name="Publisher" Relationship="BooksModel.PublishedBy"
+                       FromRole="Book" ToRole="Publisher" />
+   <NavigationProperty Name="Authors" Relationship="BooksModel.WrittenBy"
+                       FromRole="Book" ToRole="Author" />
+ </EntityType>
+```
+ 
+
+ 
+
+## EnumType Element (CSDL)
+
+The **EnumType** element represents an enumerated type.
+
+An **EnumType** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one element)
+-   Member (zero or more elements)
+-   Annotation elements (zero or more elements)
+
+### Applicable Attributes
+
+The table below describes the attributes that can be applied to the **EnumType** element.
+
+| Attribute Name     | Is Required | Value                                                                                                                                                                                         |
+|:-------------------|:------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Name**           | Yes         | The name of the entity type.                                                                                                                                                                  |
+| **IsFlags**        | No          | **True** or **False**, depending on whether the enum type can be used as a set of flags. The default value is **False.**.                                                                     |
+| **UnderlyingType** | No          | **Edm.Byte**, **Edm.Int16**, **Edm.Int32**, **Edm.Int64** or **Edm.SByte** defining the range of values of the type.   The default underlying type of enumeration elements is **Edm.Int32.**. |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **EnumType** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+### Example
+
+The following example shows an **EnumType** element with three **Member** elements:
+
+``` xml
+ <EnumType Name="Color" IsFlags=”false” UnderlyingTyp=”Edm.Byte”>
+   <Member Name="Red" />
+   <Member Name="Green" />
+   <Member Name="Blue" />
+ </EntityType>
+```
+ 
+
+ 
+
+## Function Element (CSDL)
+
+The **Function** element in conceptual schema definition language (CSDL) is used to define or declare functions in the conceptual model. A function is defined by using a DefiningExpression element.  
+
+A **Function** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one element)
+-   Parameter (zero or more elements)
+-   DefiningExpression (zero or one element)
+-   ReturnType (Function) (zero or one element)
+-   Annotation elements (zero or more elements)
+
+A return type for a function must be specified with either the **ReturnType** (Function) element or the **ReturnType** attribute (see below), but not both. The possible return types are any EdmSimpleType, entity type, complex type, row type, or ref type (or a collection of one of these types).
+
+### Applicable Attributes
+
+The table below describes the attributes that can be applied to the **Function** element.
+
+| Attribute Name | Is Required | Value                              |
+|:---------------|:------------|:-----------------------------------|
+| **Name**       | Yes         | The name of the function.          |
+| **ReturnType** | No          | The type returned by the function. |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **Function** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+### Example
+
+The following example uses a **Function** element to define a function that returns the number of years since an instructor was hired.
+
+``` xml
+ <Function Name="YearsSince" ReturnType="Edm.Int32">
+   <Parameter Name="date" Type="Edm.DateTime" />
+   <DefiningExpression>
+     Year(CurrentDateTime()) - Year(date)
+   </DefiningExpression>
+ </Function>
+```
+ 
+
+ 
+
+## FunctionImport Element (CSDL)
+
+The **FunctionImport** element in conceptual schema definition language (CSDL) represents a function that is defined in the data source but available to objects through the conceptual model. For example, a Function element in the storage model can be used to represent a stored procedure in a database. A **FunctionImport** element in the conceptual model represents the corresponding function in an Entity Framework application and is mapped to the storage model function by using the FunctionImportMapping element. When the function is called in the application, the corresponding stored procedure is executed in the database.
+
+The **FunctionImport** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one elements allowed)
+-   Parameter (zero or more elements allowed)
+-   Annotation elements (zero or more elements allowed)
+-   ReturnType (FunctionImport) (zero or more elements allowed)
+
+One **Parameter** element should be defined for each parameter that the function accepts.
+
+A return type for a function must be specified with either the **ReturnType** (FunctionImport) element or the **ReturnType** attribute (see below), but not both. The return type value must be a  collection of EdmSimpleType, EntityType, or ComplexType.
+
+### Applicable Attributes
+
+The table below describes the attributes that can be applied to the **FunctionImport** element.
+
+| Attribute Name   | Is Required | Value                                                                                                                                                                                                 |
+|:-----------------|:------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Name**         | Yes         | The name of the imported function.                                                                                                                                                                    |
+| **ReturnType**   | No          | The type that the function returns. Do not use this attribute if the function does not return a value. Otherwise, the value must be a collection of ComplexType, EntityType, or EDMSimpleType.        |
+| **EntitySet**    | No          | If the function returns a collection of entity types, the value of the **EntitySet** must be the entity set to which the collection belongs. Otherwise, the **EntitySet** attribute must not be used. |
+| **IsComposable** | No          | If the value is set to true, the function is composable (Table-valued Function) and can be used in a LINQ query.  The default is **false**.                                                           |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **FunctionImport** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+### Example
+
+The following example shows a **FunctionImport** element that accepts one parameter and returns a collection of entity types:
+
+``` xml
+ <FunctionImport Name="GetStudentGrades"
+                 EntitySet="StudentGrade"
+                 ReturnType="Collection(SchoolModel.StudentGrade)">
+        <Parameter Name="StudentID" Mode="In" Type="Int32" />
+ </FunctionImport>
+```
+ 
+
+ 
+
+## Key Element (CSDL)
+
+The **Key** element is a child element of the EntityType element and defines an *entity key* (a property or a set of properties of an entity type that determine identity). The properties that make up an entity key are chosen at design time. The values of entity key properties must uniquely identify an entity type instance within an entity set at run time. The properties that make up an entity key should be chosen to guarantee uniqueness of instances in an entity set. The **Key** element defines an entity key by referencing one or more of the properties of an entity type.
+
+The **Key** element can have the following child elements:
+
+-   PropertyRef (one or more elements)
+-   Annotation elements (zero or more elements)
+
+### Applicable Attributes
+
+Any number of annotation attributes (custom XML attributes) may be applied to the **Key** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+### Example
+
+The example below defines an entity type named **Book**. The entity key is defined by referencing the **ISBN** property of the entity type.
+
+``` xml
+ <EntityType Name="Book">
+   <Key>
+     <PropertyRef Name="ISBN" />
+   </Key>
+   <Property Type="String" Name="ISBN" Nullable="false" />
+   <Property Type="String" Name="Title" Nullable="false" />
+   <Property Type="Decimal" Name="Revision" Nullable="false" Precision="29" Scale="29" />
+   <NavigationProperty Name="Publisher" Relationship="BooksModel.PublishedBy"
+                       FromRole="Book" ToRole="Publisher" />
+   <NavigationProperty Name="Authors" Relationship="BooksModel.WrittenBy"
+                       FromRole="Book" ToRole="Author" />
+ </EntityType>
+```
+ 
+
+The **ISBN** property is a good choice for the entity key because an International Standard Book Number (ISBN) uniquely identifies a book.
+
+The following example shows an entity type (**Author**) that has an entity key that consists of two properties, **Name** and **Address**.
+
+``` xml
+ <EntityType Name="Author">
+   <Key>
+     <PropertyRef Name="Name" />
+     <PropertyRef Name="Address" />
+   </Key>
+   <Property Type="String" Name="Name" Nullable="false" />
+   <Property Type="String" Name="Address" Nullable="false" />
+   <NavigationProperty Name="Books" Relationship="BooksModel.WrittenBy"
+                       FromRole="Author" ToRole="Book" />
+ </EntityType>
+```
+ 
+
+Using **Name** and **Address** for the entity key is a reasonable choice, because two authors of the same name are unlikely to live at the same address. However, this choice for an entity key does not absolutely guarantee unique entity keys in an entity set. Adding a property, such as **AuthorId**, that could be used to uniquely identify an author would be recommended in this case.
+
+ 
+
+## Member Element (CSDL)
+
+The **Member** element is a child element of the EnumType element and defines a member of the enumerated type.
+
+### Applicable Attributes
+
+The table below describes the attributes that can be applied to the **FunctionImport** element.
+
+| Attribute Name | Is Required | Value                                                                                                                                                                                    |
+|:---------------|:------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Name**       | Yes         | The name of the member.                                                                                                                                                                  |
+| **Value**      | No          | The value of the member. By default, the first member has the value 0, and the value of each successive enumerator is incremented by 1. Multiple members with the same values may exist. |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **FunctionImport** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+### Example
+
+The following example shows an **EnumType** element with three **Member** elements:
+
+``` xml
+ <EnumType Name="Color">
+   <Member Name="Red" Value=”1”/>
+   <Member Name="Green" Value=”3” />
+   <Member Name="Blue" Value=”5”/>
+ </EntityType>
+```
+ 
+
+ 
+
+## NavigationProperty Element (CSDL)
+
+A **NavigationProperty** element defines a navigation property, which provides a reference to the other end of an association. Unlike properties defined with the Property element, navigation properties do not define the shape and characteristics of data. They provide a way to navigate an association between two entity types.
+
+Note that navigation properties are optional on both entity types at the ends of an association. If you define a navigation property on one entity type at the end of an association, you do not have to define a navigation property on the entity type at the other end of the association.
+
+The data type returned by a navigation property is determined by the multiplicity of its remote association end. For example, suppose a navigation property, **OrdersNavProp**, exists on a **Customer** entity type and navigates a one-to-many association between **Customer** and **Order**. Because the remote association end for the navigation property has multiplicity many (\*), its data type is a collection (of **Order**). Similarly, if a navigation property, **CustomerNavProp**, exists on the **Order** entity type, its data type would be **Customer** since the multiplicity of the remote end is one (1).
+
+A **NavigationProperty** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one element)
+-   Annotation elements (zero or more elements)
+
+### Applicable Attributes
+
+The table below describes the attributes that can be applied to the **NavigationProperty** element.
+
+| Attribute Name   | Is Required | Value                                                                                                                                                                                                                                            |
+|:-----------------|:------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Name**         | Yes         | The name of the navigation property.                                                                                                                                                                                                             |
+| **Relationship** | Yes         | The name of an association that is within the scope of the model.                                                                                                                                                                                |
+| **ToRole**       | Yes         | The end of the association at which navigation ends. The value of the **ToRole** attribute must be the same as the value of one of the **Role** attributes defined on one of the association ends (defined in the AssociationEnd element).       |
+| **FromRole**     | Yes         | The end of the association from which navigation begins. The value of the **FromRole** attribute must be the same as the value of one of the **Role** attributes defined on one of the association ends (defined in the AssociationEnd element). |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **NavigationProperty** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+### Example
+
+The following example defines an entity type (**Book**) with two navigation properties (**PublishedBy** and **WrittenBy**):
+
+``` xml
+ <EntityType Name="Book">
+   <Key>
+     <PropertyRef Name="ISBN" />
+   </Key>
+   <Property Type="String" Name="ISBN" Nullable="false" />
+   <Property Type="String" Name="Title" Nullable="false" />
+   <Property Type="Decimal" Name="Revision" Nullable="false" Precision="29" Scale="29" />
+   <NavigationProperty Name="Publisher" Relationship="BooksModel.PublishedBy"
+                       FromRole="Book" ToRole="Publisher" />
+   <NavigationProperty Name="Authors" Relationship="BooksModel.WrittenBy"
+                       FromRole="Book" ToRole="Author" />
+ </EntityType>
+```
+ 
+
+ 
+
+## OnDelete Element (CSDL)
+
+The **OnDelete** element in conceptual schema definition language (CSDL) defines behavior that is connected with an association. If the **Action** attribute is set to **Cascade** on one end of an association, related entity types on the other end of the association are deleted when the entity type on the first end is deleted. If the association between two entity types is a primary key-to-primary key relationship, then a loaded dependent object is deleted when the principal object on the other end of the association is deleted regardless of the **OnDelete** specification.  
+
+> [!NOTE]
+> The **OnDelete** element only affects the runtime behavior of an application; it does not affect behavior in the data source. The behavior defined in the data source should be the same as the behavior defined in the application.
+
+ 
+
+An **OnDelete** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one element)
+-   Annotation elements (zero or more elements)
+
+### Applicable Attributes
+
+The table below describes the attributes that can be applied to the **OnDelete** element.
+
+| Attribute Name | Is Required | Value                                                                                                                                                                                                                         |
+|:---------------|:------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Action**     | Yes         | **Cascade** or **None**. If **Cascade**, dependent entity types will be deleted when the principal entity type is deleted. If **None**, dependent entity types will not be deleted when the principal entity type is deleted. |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **Association** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+### Example
+
+The following example shows an **Association** element that defines the **CustomerOrders** association. The **OnDelete** element indicates that all **Orders** that are related to a particular **Customer** and have been loaded into the ObjectContext will be deleted when the **Customer** is deleted.
+
+``` xml
+ <Association Name="CustomerOrders">
+   <End Type="ExampleModel.Customer" Role="Customer" Multiplicity="1">
+         <OnDelete Action="Cascade" />
+   </End>
+   <End Type="ExampleModel.Order" Role="Order" Multiplicity="*" />
+ </Association>
+```
+ 
+
+ 
+
+## Parameter Element (CSDL)
+
+The **Parameter** element in conceptual schema definition language (CSDL) can be a child of the FunctionImport element or the Function element.
+
+### FunctionImport Element Application
+
+A **Parameter** element (as a child of the **FunctionImport** element) is used to define input and output parameters for function imports that are declared in CSDL.
+
+The **Parameter** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one elements allowed)
+-   Annotation elements (zero or more elements allowed)
+
+#### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **Parameter** element.
+
+| Attribute Name | Is Required | Value                                                                                                                                                                                                                           |
+|:---------------|:------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Name**       | Yes         | The name of the parameter.                                                                                                                                                                                                      |
+| **Type**       | Yes         | The parameter type. The value must be an **EDMSimpleType** or a complex type that is within the scope of the model.                                                                                                             |
+| **Mode**       | No          | **In**, **Out**, or **InOut** depending on whether the parameter is an input, output, or input/output parameter.                                                                                                                |
+| **MaxLength**  | No          | The maximum allowed length of the parameter.                                                                                                                                                                                    |
+| **Precision**  | No          | The precision of the parameter.                                                                                                                                                                                                 |
+| **Scale**      | No          | The scale of the parameter.                                                                                                                                                                                                     |
+| **SRID**       | No          | Spatial System Reference Identifier. Valid only for parameters of spatial types. For more information, see [SRID](https://en.wikipedia.org/wiki/SRID) and [SRID (SQL Server)](https://msdn.microsoft.com/library/bb964707.aspx). |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **Parameter** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+#### Example
+
+The following example shows a **FunctionImport** element with one **Parameter** child element. The function accepts one input parameter and returns a collection of entity types.
+
+``` xml
+ <FunctionImport Name="GetStudentGrades"
+                 EntitySet="StudentGrade"
+                 ReturnType="Collection(SchoolModel.StudentGrade)">
+        <Parameter Name="StudentID" Mode="In" Type="Int32" />
+ </FunctionImport>
+```
+ 
+
+### Function Element Application
+
+A **Parameter** element (as a child of the **Function** element) defines parameters for functions that are defined or declared in a conceptual model.
+
+The **Parameter** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one elements)
+-   CollectionType (zero or one elements)
+-   ReferenceType (zero or one elements)
+-   RowType (zero or one elements)
+
+> [!NOTE]
+> Only one of the **CollectionType**, **ReferenceType**, or **RowType** elements can be a child element of a **Property** element.
+
+ 
+
+-   Annotation elements (zero or more elements allowed)
+
+> [!NOTE]
+> Annotation elements must appear after all other child elements. Annotation elements are only allowed in CSDL v2 and later.
+
+ 
+
+#### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **Parameter** element.
+
+| Attribute Name   | Is Required | Value                                                                                                                                                                                                                           |
+|:-----------------|:------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Name**         | Yes         | The name of the parameter.                                                                                                                                                                                                      |
+| **Type**         | No          | The parameter type. A parameter can be any of the following types (or collections of these types): <br/> **EdmSimpleType** <br/> entity type <br/> complex type <br/> row type <br/> reference type                             |
+| **Nullable**     | No          | **True** (the default value) or **False** depending on whether the property can have a **null** value.                                                                                                                          |
+| **DefaultValue** | No          | The default value of the property.                                                                                                                                                                                              |
+| **MaxLength**    | No          | The maximum length of the property value.                                                                                                                                                                                       |
+| **FixedLength**  | No          | **True** or **False** depending on whether the property value will be stored as a fixed length string.                                                                                                                          |
+| **Precision**    | No          | The precision of the property value.                                                                                                                                                                                            |
+| **Scale**        | No          | The scale of the property value.                                                                                                                                                                                                |
+| **SRID**         | No          | Spatial System Reference Identifier. Valid only for properties of spatial types. For more information, see [SRID](https://en.wikipedia.org/wiki/SRID) and [SRID (SQL Server)](https://msdn.microsoft.com/library/bb964707.aspx). |
+| **Unicode**      | No          | **True** or **False** depending on whether the property value will be stored as a Unicode string.                                                                                                                               |
+| **Collation**    | No          | A string that specifies the collating sequence to be used in the data source.                                                                                                                                                   |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **Parameter** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+#### Example
+
+The following example shows a **Function** element that uses one **Parameter** child element to define a function parameter.
+
+``` xml
+ <Function Name="GetYearsEmployed" ReturnType="Edm.Int32">
+ <Parameter Name="Instructor" Type="SchoolModel.Person" />
+   <DefiningExpression>
+   Year(CurrentDateTime()) - Year(cast(Instructor.HireDate as DateTime))
+   </DefiningExpression>
+ </Function>
+```
+
+ 
+
+## Principal Element (CSDL)
+
+The **Principal** element in conceptual schema definition language (CSDL) is a child element to the ReferentialConstraint element that defines the principal end of a referential constraint. A **ReferentialConstraint** element defines functionality that is similar to a referential integrity constraint in a relational database. In the same way that a column (or columns) from a database table can reference the primary key of another table, a property (or properties) of an entity type can reference the entity key of another entity type. The entity type that is referenced is called the *principal end* of the constraint. The entity type that references the principal end is called the *dependent end* of the constraint. **PropertyRef** elements are used to specify which keys are referenced by the dependent end.
+
+The **Principal** element can have the following child elements (in the order listed):
+
+-   PropertyRef (one or more elements)
+-   Annotation elements (zero or more elements)
+
+### Applicable Attributes
+
+The table below describes the attributes that can be applied to the **Principal** element.
+
+| Attribute Name | Is Required | Value                                                                |
+|:---------------|:------------|:---------------------------------------------------------------------|
+| **Role**       | Yes         | The name of the entity type on the principal end of the association. |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **Principal** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+### Example
+
+The following example shows a **ReferentialConstraint** element that is part of the definition of the **PublishedBy** association. The **Id** property of the **Publisher** entity type makes up the principal end of the referential constraint.
+
+``` xml
+ <Association Name="PublishedBy">
+   <End Type="BooksModel.Book" Role="Book" Multiplicity="*" >
+   </End>
+   <End Type="BooksModel.Publisher" Role="Publisher" Multiplicity="1" />
+   <ReferentialConstraint>
+     <Principal Role="Publisher">
+       <PropertyRef Name="Id" />
+     </Principal>
+     <Dependent Role="Book">
+       <PropertyRef Name="PublisherId" />
+     </Dependent>
+   </ReferentialConstraint>
+ </Association>
+```
+ 
+
+ 
+
+## Property Element (CSDL)
+
+The **Property** element in conceptual schema definition language (CSDL) can be a child of the EntityType element, the ComplexType element, or the RowType element.
+
+### EntityType and ComplexType Element Applications
+
+**Property** elements (as children of **EntityType** or **ComplexType** elements) define the shape and characteristics of data that an entity type instance or complex type instance will contain. Properties in a conceptual model are analogous to properties that are defined on a class. In the same way that properties on a class define the shape of the class and carry information about objects, properties in a conceptual model define the shape of an entity type and carry information about entity type instances.
+
+The **Property** element can have the following child elements (in the order listed):
+
+-   Documentation Element (zero or one elements allowed)
+-   Annotation elements (zero or more elements allowed)
+
+The following facets can be applied to a **Property** element: **Nullable**, **DefaultValue**, **MaxLength**, **FixedLength**, **Precision**, **Scale**, **Unicode**, **Collation**, **ConcurrencyMode**. Facets are XML attributes that provide information about how property values are stored in the data store.
+
+> [!NOTE]
+> Facets can only be applied to properties of type **EDMSimpleType**.
+
+ 
+
+#### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **Property** element.
+
+| Attribute Name                                                         | Is Required | Value                                                                                                                                                                                                                           |
+|:-----------------------------------------------------------------------|:------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Name**                                                               | Yes         | The name of the property.                                                                                                                                                                                                       |
+| **Type**                                                               | Yes         | The type of the property value. The property value type must be an **EDMSimpleType** or a complex type (indicated by a fully-qualified name) that is within scope of the model.                                                 |
+| **Nullable**                                                           | No          | **True** (the default value) or <strong>False</strong> depending on whether the property can have a null value. <br/> [!NOTE]                                                                                                   |
+| > In the CSDL v1 a complex type property must have `Nullable="False"`. |             |                                                                                                                                                                                                                                 |
+| **DefaultValue**                                                       | No          | The default value of the property.                                                                                                                                                                                              |
+| **MaxLength**                                                          | No          | The maximum length of the property value.                                                                                                                                                                                       |
+| **FixedLength**                                                        | No          | **True** or **False** depending on whether the property value will be stored as a fixed length string.                                                                                                                          |
+| **Precision**                                                          | No          | The precision of the property value.                                                                                                                                                                                            |
+| **Scale**                                                              | No          | The scale of the property value.                                                                                                                                                                                                |
+| **SRID**                                                               | No          | Spatial System Reference Identifier. Valid only for properties of spatial types. For more information, see [SRID](https://en.wikipedia.org/wiki/SRID) and [SRID (SQL Server)](https://msdn.microsoft.com/library/bb964707.aspx). |
+| **Unicode**                                                            | No          | **True** or **False** depending on whether the property value will be stored as a Unicode string.                                                                                                                               |
+| **Collation**                                                          | No          | A string that specifies the collating sequence to be used in the data source.                                                                                                                                                   |
+| **ConcurrencyMode**                                                    | No          | **None** (the default value) or **Fixed**. If the value is set to **Fixed**, the property value will be used in optimistic concurrency checks.                                                                                  |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **Property** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+#### Example
+
+The following example shows an **EntityType** element with three **Property** elements:
+
+``` xml
+ <EntityType Name="Book">
+   <Key>
+     <PropertyRef Name="ISBN" />
+   </Key>
+   <Property Type="String" Name="ISBN" Nullable="false" />
+   <Property Type="String" Name="Title" Nullable="false" />
+   <Property Type="Decimal" Name="Revision" Nullable="false" Precision="29" Scale="29" />
+   <NavigationProperty Name="Publisher" Relationship="BooksModel.PublishedBy"
+                       FromRole="Book" ToRole="Publisher" />
+   <NavigationProperty Name="Authors" Relationship="BooksModel.WrittenBy"
+                       FromRole="Book" ToRole="Author" />
+ </EntityType>
+```
+ 
+
+The following example shows a **ComplexType** element with five **Property** elements:
+
+``` xml
+ <ComplexType Name="Address" >
+   <Property Type="String" Name="StreetAddress" Nullable="false" />
+   <Property Type="String" Name="City" Nullable="false" />
+   <Property Type="String" Name="StateOrProvince" Nullable="false" />
+   <Property Type="String" Name="Country" Nullable="false" />
+   <Property Type="String" Name="PostalCode" Nullable="false" />
+ </ComplexType>
+```
+ 
+
+### RowType Element Application
+
+**Property** elements (as the children of a **RowType** element) define the shape and characteristics of data that can be passed to or returned from a model-defined function.  
+
+The **Property** element can have exactly one of the following child elements:
+
+-   CollectionType
+-   ReferenceType
+-   RowType
+
+The **Property** element can have any number child annotation elements.
+
+> [!NOTE]
+> Annotation elements are only allowed in CSDL v2 and later.
+
+ 
+
+#### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **Property** element.
+
+| Attribute Name                                                     | Is Required | Value                                                                                                                                                                                                                           |
+|:-------------------------------------------------------------------|:------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Name**                                                           | Yes         | The name of the property.                                                                                                                                                                                                       |
+| **Type**                                                           | Yes         | The type of the property value.                                                                                                                                                                                                 |
+| **Nullable**                                                       | No          | **True** (the default value) or **False** depending on whether the property can have a null value. <br/> [!NOTE]                                                                                                                |
+| > In CSDL v1 a complex type property must have `Nullable="False"`. |             |                                                                                                                                                                                                                                 |
+| **DefaultValue**                                                   | No          | The default value of the property.                                                                                                                                                                                              |
+| **MaxLength**                                                      | No          | The maximum length of the property value.                                                                                                                                                                                       |
+| **FixedLength**                                                    | No          | **True** or **False** depending on whether the property value will be stored as a fixed length string.                                                                                                                          |
+| **Precision**                                                      | No          | The precision of the property value.                                                                                                                                                                                            |
+| **Scale**                                                          | No          | The scale of the property value.                                                                                                                                                                                                |
+| **SRID**                                                           | No          | Spatial System Reference Identifier. Valid only for properties of spatial types. For more information, see [SRID](https://en.wikipedia.org/wiki/SRID) and [SRID (SQL Server)](https://msdn.microsoft.com/library/bb964707.aspx). |
+| **Unicode**                                                        | No          | **True** or **False** depending on whether the property value will be stored as a Unicode string.                                                                                                                               |
+| **Collation**                                                      | No          | A string that specifies the collating sequence to be used in the data source.                                                                                                                                                   |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **Property** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+#### Example
+
+The following example shows **Property** elements used to define the shape of the return type of a model-defined function.
+
+``` xml
+ <Function Name="LastNamesAfter">
+   <Parameter Name="someString" Type="Edm.String" />
+   <ReturnType>
+    <CollectionType>
+      <RowType>
+        <Property Name="FirstName" Type="Edm.String" Nullable="false" />
+        <Property Name="LastName" Type="Edm.String" Nullable="false" />
+      </RowType>
+    </CollectionType>
+   </ReturnType>
+   <DefiningExpression>
+             SELECT VALUE ROW(p.FirstName, p.LastName)
+             FROM SchoolEntities.People AS p
+             WHERE p.LastName &gt;= somestring
+   </DefiningExpression>
+ </Function>
+```
+ 
+
+ 
+
+## PropertyRef Element (CSDL)
+
+The **PropertyRef** element in conceptual schema definition language (CSDL) references a property of an entity type to indicate that the property will perform one of the following roles:
+
+-   Part of the entity's key (a property or a set of properties of an entity type that determine identity). One or more **PropertyRef** elements can be used to define an entity key.
+-   The dependent or principal end of a referential constraint.
+
+The **PropertyRef** element can only have annotation elements (zero or more) as child elements.
+
+> [!NOTE]
+> Annotation elements are only allowed in CSDL v2 and later.
+
+ 
+
+### Applicable Attributes
+
+The table below describes the attributes that can be applied to the **PropertyRef** element.
+
+| Attribute Name | Is Required | Value                                |
+|:---------------|:------------|:-------------------------------------|
+| **Name**       | Yes         | The name of the referenced property. |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **PropertyRef** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+### Example
+
+The example below defines an entity type (**Book**). The entity key is defined by referencing the **ISBN** property of the entity type.
+
+``` xml
+ <EntityType Name="Book">
+   <Key>
+     <PropertyRef Name="ISBN" />
+   </Key>
+   <Property Type="String" Name="ISBN" Nullable="false" />
+   <Property Type="String" Name="Title" Nullable="false" />
+   <Property Type="Decimal" Name="Revision" Nullable="false" Precision="29" Scale="29" />
+   <NavigationProperty Name="Publisher" Relationship="BooksModel.PublishedBy"
+                       FromRole="Book" ToRole="Publisher" />
+   <NavigationProperty Name="Authors" Relationship="BooksModel.WrittenBy"
+                       FromRole="Book" ToRole="Author" />
+ </EntityType>
+```
+ 
+
+In the next example, two **PropertyRef** elements are used to indicate that two properties (**Id** and **PublisherId**) are the principal and dependent ends of a referential constraint.
+
+``` xml
+ <Association Name="PublishedBy">
+   <End Type="BooksModel.Book" Role="Book" Multiplicity="*" >
+   </End>
+   <End Type="BooksModel.Publisher" Role="Publisher" Multiplicity="1" />
+   <ReferentialConstraint>
+     <Principal Role="Publisher">
+       <PropertyRef Name="Id" />
+     </Principal>
+     <Dependent Role="Book">
+       <PropertyRef Name="PublisherId" />
+     </Dependent>
+   </ReferentialConstraint>
+ </Association>
+```
+ 
+
+ 
+
+## ReferenceType Element (CSDL)
+
+The **ReferenceType** element in conceptual schema definition language (CSDL) specifies a reference to an entity type. The **ReferenceType** element can be a child of the following elements:
+
+-   ReturnType (Function)
+-   Parameter
+-   CollectionType
+
+The **ReferenceType** element is used when defining a parameter or return type for a function.
+
+A **ReferenceType** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one element)
+-   Annotation elements (zero or more elements)
+
+### Applicable Attributes
+
+The table below describes the attributes that can be applied to the **ReferenceType** element.
+
+| Attribute Name | Is Required | Value                                         |
+|:---------------|:------------|:----------------------------------------------|
+| **Type**       | Yes         | The name of the entity type being referenced. |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **ReferenceType** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+### Example
+
+The following example shows the **ReferenceType** element used as a child of a **Parameter** element in a model-defined function that accepts a reference to a **Person** entity type:
+
+``` xml
+ <Function Name="GetYearsEmployed" ReturnType="Edm.Int32">
+   <Parameter Name="instructor">
+     <ReferenceType Type="SchoolModel.Person" />
+   </Parameter>
+   <DefiningExpression>
+   Year(CurrentDateTime()) - Year(cast(instructor.HireDate as DateTime))
+   </DefiningExpression>
+ </Function>
+```
+ 
+
+The following example shows the **ReferenceType** element used as a child of a **ReturnType** (Function) element in a model-defined function that returns a reference to a **Person** entity type:
+
+``` xml
+ <Function Name="GetPersonReference">
+     <Parameter Name="p" Type="SchoolModel.Person" />
+     <ReturnType>
+         <ReferenceType Type="SchoolModel.Person" />
+     </ReturnType>
+     <DefiningExpression>
+           REF(p)
+     </DefiningExpression>
+ </Function>
+```
+ 
+
+ 
+
+## ReferentialConstraint Element (CSDL)
+
+A **ReferentialConstraint** element in conceptual schema definition language (CSDL) defines functionality that is similar to a referential integrity constraint in a relational database. In the same way that a column (or columns) from a database table can reference the primary key of another table, a property (or properties) of an entity type can reference the entity key of another entity type. The entity type that is referenced is called the *principal end* of the constraint. The entity type that references the principal end is called the *dependent end* of the constraint.
+
+If a foreign key that is exposed on one entity type references a property on another entity type, the **ReferentialConstraint** element defines an association between the two entity types. Because the **ReferentialConstraint** element provides information about how two entity types are related, no corresponding AssociationSetMapping element is necessary in the mapping specification language (MSL). An association between two entity types that do not have foreign keys exposed must have a corresponding **AssociationSetMapping** element in order to map association information to the data source.
+
+If a foreign key is not exposed on an entity type, the **ReferentialConstraint** element can only define a primary key-to-primary key constraint between the entity type and another entity type.
+
+A **ReferentialConstraint** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one element)
+-   Principal (exactly one element)
+-   Dependent (exactly one element)
+-   Annotation elements (zero or more elements)
+
+### Applicable Attributes
+
+The **ReferentialConstraint** element can have any number of annotation attributes (custom XML attributes). However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+### Example
+
+The following example shows a **ReferentialConstraint** element being used as part of the definition of the **PublishedBy** association.
+
+``` xml
+ <Association Name="PublishedBy">
+   <End Type="BooksModel.Book" Role="Book" Multiplicity="*" >
+   </End>
+   <End Type="BooksModel.Publisher" Role="Publisher" Multiplicity="1" />
+   <ReferentialConstraint>
+     <Principal Role="Publisher">
+       <PropertyRef Name="Id" />
+     </Principal>
+     <Dependent Role="Book">
+       <PropertyRef Name="PublisherId" />
+     </Dependent>
+   </ReferentialConstraint>
+ </Association>
+```
+ 
+
+ 
+
+## ReturnType (Function) Element (CSDL)
+
+The **ReturnType** (Function) element in conceptual schema definition language (CSDL) specifies the return type for a function that is defined in a Function element. A function return type can also be specified with a **ReturnType** attribute.
+
+Return types can be any **EdmSimpleType**, entity type, complex type, row type, ref type, or a collection of one of these types.
+
+The return type of a function can be specified with either the **Type** attribute of the **ReturnType** (Function) element, or with one of the following child elements:
+
+-   CollectionType
+-   ReferenceType
+-   RowType
+
+> [!NOTE]
+> A model will not validate if you specify a function return type with both the **Type** attribute of the **ReturnType** (Function) element and one of the child elements.
+
+ 
+
+### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **ReturnType** (Function) element.
+
+| Attribute Name | Is Required | Value                              |
+|:---------------|:------------|:-----------------------------------|
+| **ReturnType** | No          | The type returned by the function. |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **ReturnType** (Function) element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+### Example
+
+The following example uses a **Function** element to define a function that returns the number of years a book has been in print. Note that the return type is specified by the **Type** attribute of a **ReturnType** (Function) element.
+
+``` xml
+ <Function Name="GetYearsInPrint">
+   <ReturnType Type=="Edm.Int32">
+   <Parameter Name="book" Type="BooksModel.Book" />
+   <DefiningExpression>
+    Year(CurrentDateTime()) - Year(cast(book.PublishedDate as DateTime))
+   </DefiningExpression>
+ </Function>
+```
+ 
+
+ 
+
+## ReturnType (FunctionImport) Element (CSDL)
+
+The **ReturnType** (FunctionImport) element in conceptual schema definition language (CSDL) specifies the return type for a function that is defined in a FunctionImport element. A function return type can also be specified with a **ReturnType** attribute.
+
+Return types can be any collection of entity type, complex type,or **EdmSimpleType**,
+
+The return type of a function is specified with the **Type** attribute of the **ReturnType** (FunctionImport) element.
+
+### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **ReturnType** (FunctionImport) element.
+
+| Attribute Name | Is Required | Value                                                                                                                                                                                                 |
+|:---------------|:------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Type**       | No          | The type that the function returns. The value must be a collection of ComplexType, EntityType, or EDMSimpleType.                                                                                      |
+| **EntitySet**  | No          | If the function returns a collection of entity types, the value of the **EntitySet** must be the entity set to which the collection belongs. Otherwise, the **EntitySet** attribute must not be used. |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **ReturnType** (FunctionImport) element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+### Example
+
+The following example uses a **FunctionImport** that returns books and publishers. Note that the function returns two result sets and therefore two **ReturnType** (FunctionImport) elements are specified.
+
+``` xml
+ <FunctionImport Name="GetBooksAndPublishers">
+   <ReturnType Type=="Collection(BooksModel.Book )" EntitySet=”Books”>
+   <ReturnType Type=="Collection(BooksModel.Publisher)" EntitySet=”Publishers”>
+ </FunctionImport>
+```
+ 
+
+ 
+
+## RowType Element (CSDL)
+
+A **RowType** element in conceptual schema definition language (CSDL) defines an unnamed structure as a parameter or return type for a function defined in the conceptual model.
+
+A **RowType** element can be the child of the following elements:
+
+-   CollectionType
+-   Parameter
+-   ReturnType (Function)
+
+A **RowType** element can have the following child elements (in the order listed):
+
+-   Property (one or more)
+-   Annotation elements (zero or more)
+
+### Applicable Attributes
+
+Any number of annotation attributes (custom XML attributes) may be applied to the **RowType** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+### Example
+
+The following example shows a model-defined function that uses a **CollectionType** element to specify that the function returns a collection of rows (as specified in the **RowType** element).
+
+``` xml
+ <Function Name="LastNamesAfter">
+   <Parameter Name="someString" Type="Edm.String" />
+   <ReturnType>
+    <CollectionType>
+      <RowType>
+        <Property Name="FirstName" Type="Edm.String" Nullable="false" />
+        <Property Name="LastName" Type="Edm.String" Nullable="false" />
+      </RowType>
+    </CollectionType>
+   </ReturnType>
+   <DefiningExpression>
+             SELECT VALUE ROW(p.FirstName, p.LastName)
+             FROM SchoolEntities.People AS p
+             WHERE p.LastName &gt;= somestring
+   </DefiningExpression>
+ </Function>
+```
+
+## Schema Element (CSDL)
+
+The **Schema** element is the root element of a conceptual model definition. It contains definitions for the objects, functions, and containers that make up a conceptual model.
+
+The **Schema** element may contain zero or more of the following child elements:
+
+-   Using
+-   EntityContainer
+-   EntityType
+-   EnumType
+-   Association
+-   ComplexType
+-   Function
+
+A **Schema** element may contain zero or one Annotation elements.
+
+> [!NOTE]
+> The **Function** element and annotation elements are only allowed in CSDL v2 and later.
+
+ 
+
+The **Schema** element uses the **Namespace** attribute to define the namespace for the entity type, complex type, and association objects in a conceptual model. Within a namespace, no two objects can have the same name. Namespaces can span multiple **Schema** elements and multiple .csdl files.
+
+A conceptual model namespace is different from the XML namespace of the **Schema** element. A conceptual model namespace (as defined by the **Namespace** attribute) is a logical container for entity types, complex types, and association types. The XML namespace (indicated by the **xmlns** attribute) of a **Schema** element is the default namespace for child elements and attributes of the **Schema** element. XML namespaces of the form `https://schemas.microsoft.com/ado/YYYY/MM/edm` (where YYYY and MM represent a year and month respectively) are reserved for CSDL. Custom elements and attributes cannot be in namespaces that have this form.
+
+### Applicable Attributes
+
+The table below describes the attributes can be applied to the **Schema** element.
+
+| Attribute Name | Is Required | Value                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+|:---------------|:------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Namespace**  | Yes         | The namespace of the conceptual model. The value of the **Namespace** attribute is used to form the fully qualified name of a type. For example, if an **EntityType** named *Customer* is in the Simple.Example.Model namespace, then the fully qualified name of the **EntityType** is SimpleExampleModel.Customer. <br/> The following strings cannot be used as the value for the **Namespace** attribute: **System**, **Transient**, or **Edm**. The value for the **Namespace** attribute cannot be the same as the value for the **Namespace** attribute in the SSDL Schema element. |
+| **Alias**      | No          | An identifier used in place of the namespace name. For example, if an **EntityType** named *Customer* is in the Simple.Example.Model namespace and the value of the **Alias** attribute is *Model*, then you can use Model.Customer as the fully qualified name of the **EntityType.**                                                                                                                                                                                                                                                                                                     |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **Schema** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+### Example
+
+The following example shows a **Schema** element that contains an **EntityContainer** element, two **EntityType** elements, and one **Association** element.
+
+``` xml
+ <Schema xmlns="https://schemas.microsoft.com/ado/2009/11/edm"
+      xmlns:cg="https://schemas.microsoft.com/ado/2009/11/codegeneration"
+      xmlns:store="https://schemas.microsoft.com/ado/2009/11/edm/EntityStoreSchemaGenerator"
+       Namespace="ExampleModel" Alias="Self">
+         <EntityContainer Name="ExampleModelContainer">
+           <EntitySet Name="Customers"
+                      EntityType="ExampleModel.Customer" />
+           <EntitySet Name="Orders" EntityType="ExampleModel.Order" />
+           <AssociationSet
+                       Name="CustomerOrder"
+                       Association="ExampleModel.CustomerOrders">
+             <End Role="Customer" EntitySet="Customers" />
+             <End Role="Order" EntitySet="Orders" />
+           </AssociationSet>
+         </EntityContainer>
+         <EntityType Name="Customer">
+           <Key>
+             <PropertyRef Name="CustomerId" />
+           </Key>
+           <Property Type="Int32" Name="CustomerId" Nullable="false" />
+           <Property Type="String" Name="Name" Nullable="false" />
+           <NavigationProperty
+                    Name="Orders"
+                    Relationship="ExampleModel.CustomerOrders"
+                    FromRole="Customer" ToRole="Order" />
+         </EntityType>
+         <EntityType Name="Order">
+           <Key>
+             <PropertyRef Name="OrderId" />
+           </Key>
+           <Property Type="Int32" Name="OrderId" Nullable="false" />
+           <Property Type="Int32" Name="ProductId" Nullable="false" />
+           <Property Type="Int32" Name="Quantity" Nullable="false" />
+           <NavigationProperty
+                    Name="Customer"
+                    Relationship="ExampleModel.CustomerOrders"
+                    FromRole="Order" ToRole="Customer" />
+           <Property Type="Int32" Name="CustomerId" Nullable="false" />
+         </EntityType>
+         <Association Name="CustomerOrders">
+           <End Type="ExampleModel.Customer"
+                Role="Customer" Multiplicity="1" />
+           <End Type="ExampleModel.Order"
+                Role="Order" Multiplicity="*" />
+           <ReferentialConstraint>
+             <Principal Role="Customer">
+               <PropertyRef Name="CustomerId" />
+             </Principal>
+             <Dependent Role="Order">
+               <PropertyRef Name="CustomerId" />
+             </Dependent>
+           </ReferentialConstraint>
+         </Association>
+       </Schema>
+```
+ 
+
+ 
+
+## TypeRef Element (CSDL)
+
+The **TypeRef** element in conceptual schema definition language (CSDL) provides a reference to an existing named type. The **TypeRef** element can be a child of the CollectionType element, which is used to specify that a function has a collection as a parameter or return type.
+
+A **TypeRef** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one element)
+-   Annotation elements (zero or more elements)
+
+### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **TypeRef** element. Note that the **DefaultValue**, **MaxLength**, **FixedLength**, **Precision**, **Scale**, **Unicode**, and **Collation** attributes are only applicable to **EDMSimpleTypes**.
+
+| Attribute Name                                                     | Is Required | Value                                                                                                                                                                                                                           |
+|:-------------------------------------------------------------------|:------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Type**                                                           | No          | The name of the type being referenced.                                                                                                                                                                                          |
+| **Nullable**                                                       | No          | **True** (the default value) or **False** depending on whether the property can have a null value. <br/> [!NOTE]                                                                                                                |
+| > In CSDL v1 a complex type property must have `Nullable="False"`. |             |                                                                                                                                                                                                                                 |
+| **DefaultValue**                                                   | No          | The default value of the property.                                                                                                                                                                                              |
+| **MaxLength**                                                      | No          | The maximum length of the property value.                                                                                                                                                                                       |
+| **FixedLength**                                                    | No          | **True** or **False** depending on whether the property value will be stored as a fixed length string.                                                                                                                          |
+| **Precision**                                                      | No          | The precision of the property value.                                                                                                                                                                                            |
+| **Scale**                                                          | No          | The scale of the property value.                                                                                                                                                                                                |
+| **SRID**                                                           | No          | Spatial System Reference Identifier. Valid only for properties of spatial types. For more information, see [SRID](https://en.wikipedia.org/wiki/SRID) and [SRID (SQL Server)](https://msdn.microsoft.com/library/bb964707.aspx). |
+| **Unicode**                                                        | No          | **True** or **False** depending on whether the property value will be stored as a Unicode string.                                                                                                                               |
+| **Collation**                                                      | No          | A string that specifies the collating sequence to be used in the data source.                                                                                                                                                   |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **CollectionType** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+### Example
+
+The following example shows a model-defined function that uses the **TypeRef** element (as a child of a **CollectionType** element) to specify that the function accepts a collection of **Department** entity types.
+
+``` xml
+ <Function Name="GetAvgBudget">
+      <Parameter Name="Departments">
+          <CollectionType>
+             <TypeRef Type="SchoolModel.Department"/>
+          </CollectionType>
+           </Parameter>
+       <ReturnType Type="Collection(Edm.Decimal)"/>
+       <DefiningExpression>
+             SELECT VALUE AVG(d.Budget) FROM Departments AS d
+       </DefiningExpression>
+ </Function>
+```
+ 
+
+ 
+
+## Using Element (CSDL)
+
+The **Using** element in conceptual schema definition language (CSDL) imports the contents of a conceptual model that exists in a different namespace. By setting the value of the **Namespace** attribute, you can refer to entity types, complex types, and association types that are defined in another conceptual model. More than one **Using** element can be a child of a **Schema** element.
+
+> [!NOTE]
+> The **Using** element in CSDL does not function exactly like a **using** statement in a programming language. By importing a namespace with a **using** statement in a programming language, you do not affect objects in the original namespace. In CSDL, an imported namespace can contain an entity type that is derived from an entity type in the original namespace. This can affect entity sets declared in the original namespace.
+
+ 
+
+The **Using** element can have the following child elements:
+
+-   Documentation (zero or one elements allowed)
+-   Annotation elements (zero or more elements allowed)
+
+### Applicable Attributes
+
+The table below describes the attributes can be applied to the **Using** element.
+
+| Attribute Name | Is Required | Value                                                                                                                                                                              |
+|:---------------|:------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Namespace**  | Yes         | The name of the imported namespace.                                                                                                                                                |
+| **Alias**      | Yes         | An identifier used in place of the namespace name. Although this attribute is required, it is not required that it be used in place of the namespace name to qualify object names. |
+
+ 
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **Using** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+ 
+
+### Example
+
+The following example demonstrates the **Using** element being used to import a namespace that is defined elsewhere. Note that the namespace for the **Schema** element shown is `BooksModel`. The `Address` property on the `Publisher`**EntityType** is a complex type that is defined in the `ExtendedBooksModel` namespace (imported with the **Using** element).
+
+``` xml
+ <Schema xmlns="https://schemas.microsoft.com/ado/2009/11/edm"
+           xmlns:cg="https://schemas.microsoft.com/ado/2009/11/codegeneration"
+           xmlns:store="https://schemas.microsoft.com/ado/2009/11/edm/EntityStoreSchemaGenerator"
+           Namespace="BooksModel" Alias="Self">
+
+     <Using Namespace="BooksModel.Extended" Alias="BMExt" />
+
+ <EntityContainer Name="BooksContainer" >
+       <EntitySet Name="Publishers" EntityType="BooksModel.Publisher" />
+     </EntityContainer>
+
+ <EntityType Name="Publisher">
+       <Key>
+         <PropertyRef Name="Id" />
+       </Key>
+       <Property Type="Int32" Name="Id" Nullable="false" />
+       <Property Type="String" Name="Name" Nullable="false" />
+       <Property Type="BMExt.Address" Name="Address" Nullable="false" />
+     </EntityType>
+
+ </Schema>
+```
+ 
+
+ 
+
+## Annotation Attributes (CSDL)
+
+Annotation attributes in conceptual schema definition language (CSDL) are custom XML attributes in the conceptual model. In addition to having valid XML structure, the following must be true of annotation attributes:
+
+-   Annotation attributes must not be in any XML namespace that is reserved for CSDL.
+-   More than one annotation attribute may be applied to a given CSDL element.
+-   The fully-qualified names of any two annotation attributes must not be the same.
+
+Annotation attributes can be used to provide extra metadata about the elements in a conceptual model. Metadata contained in annotation elements can be accessed at runtime by using classes in the System.Data.Metadata.Edm namespace.
+
+### Example
+
+The following example shows an **EntityType** element with an annotation attribute (**CustomAttribute**). The example also shows an annotation element applied to the entity type element.
+
+``` xml
+ <Schema Namespace="SchoolModel" Alias="Self"
+         xmlns:annotation="https://schemas.microsoft.com/ado/2009/02/edm/annotation"
+         xmlns="https://schemas.microsoft.com/ado/2009/11/edm">
+   <EntityContainer Name="SchoolEntities" annotation:LazyLoadingEnabled="true">
+     <EntitySet Name="People" EntityType="SchoolModel.Person" />
+   </EntityContainer>
+   <EntityType Name="Person" xmlns:p="http://CustomNamespace.com"
+               p:CustomAttribute="Data here.">
+     <Key>
+       <PropertyRef Name="PersonID" />
+     </Key>
+     <Property Name="PersonID" Type="Int32" Nullable="false"
+               annotation:StoreGeneratedPattern="Identity" />
+     <Property Name="LastName" Type="String" Nullable="false"
+               MaxLength="50" Unicode="true" FixedLength="false" />
+     <Property Name="FirstName" Type="String" Nullable="false"
+               MaxLength="50" Unicode="true" FixedLength="false" />
+     <Property Name="HireDate" Type="DateTime" />
+     <Property Name="EnrollmentDate" Type="DateTime" />
+     <p:CustomElement>
+       Custom metadata.
+     </p:CustomElement>
+   </EntityType>
+ </Schema>
+```
+ 
+
+The following code retrieves the metadata in the annotation attribute and writes it to the console:
+
+``` xml
+ EdmItemCollection collection = new EdmItemCollection("School.csdl");
+ MetadataWorkspace workspace = new MetadataWorkspace();
+ workspace.RegisterItemCollection(collection);
+ EdmType contentType;
+ workspace.TryGetType("Person", "SchoolModel", DataSpace.CSpace, out contentType);
+ if (contentType.MetadataProperties.Contains("http://CustomNamespace.com:CustomAttribute"))
+ {
+     MetadataProperty annotationProperty =
+         contentType.MetadataProperties["http://CustomNamespace.com:CustomAttribute"];
+     object annotationValue = annotationProperty.Value;
+     Console.WriteLine(annotationValue.ToString());
+ }
+```
+ 
+
+The code above assumes that the `School.csdl` file is in the project's output directory and that you have added the following `Imports` and `Using` statements to your project:
+
+``` csharp
+ using System.Data.Metadata.Edm;
+```
+ 
+
+ 
+
+## Annotation Elements (CSDL)
+
+Annotation elements in conceptual schema definition language (CSDL) are custom XML elements in the conceptual model. In addition to having valid XML structure, the following must be true of annotation elements:
+
+-   Annotation elements must not be in any XML namespace that is reserved for CSDL.
+-   More than one annotation element may be a child of a given CSDL element.
+-   The fully-qualified names of any two annotation elements must not be the same.
+-   Annotation elements must appear after all other child elements of a given CSDL element.
+
+Annotation elements can be used to provide extra metadata about the elements in a conceptual model. Starting with the .NET Framework version 4, metadata contained in annotation elements can be accessed at runtime by using classes in the System.Data.Metadata.Edm namespace.
+
+### Example
+
+The following example shows an **EntityType** element with an annotation element (**CustomElement**). The example also show an annotation attribute applied to the entity type element.
+
+``` xml
+ <Schema Namespace="SchoolModel" Alias="Self"
+         xmlns:annotation="https://schemas.microsoft.com/ado/2009/02/edm/annotation"
+         xmlns="https://schemas.microsoft.com/ado/2009/11/edm">
+   <EntityContainer Name="SchoolEntities" annotation:LazyLoadingEnabled="true">
+     <EntitySet Name="People" EntityType="SchoolModel.Person" />
+   </EntityContainer>
+   <EntityType Name="Person" xmlns:p="http://CustomNamespace.com"
+               p:CustomAttribute="Data here.">
+     <Key>
+       <PropertyRef Name="PersonID" />
+     </Key>
+     <Property Name="PersonID" Type="Int32" Nullable="false"
+               annotation:StoreGeneratedPattern="Identity" />
+     <Property Name="LastName" Type="String" Nullable="false"
+               MaxLength="50" Unicode="true" FixedLength="false" />
+     <Property Name="FirstName" Type="String" Nullable="false"
+               MaxLength="50" Unicode="true" FixedLength="false" />
+     <Property Name="HireDate" Type="DateTime" />
+     <Property Name="EnrollmentDate" Type="DateTime" />
+     <p:CustomElement>
+       Custom metadata.
+     </p:CustomElement>
+   </EntityType>
+ </Schema>
+```
+ 
+
+The following code retrieves the metadata in the annotation element and writes it to the console:
+
+``` csharp
+ EdmItemCollection collection = new EdmItemCollection("School.csdl");
+ MetadataWorkspace workspace = new MetadataWorkspace();
+ workspace.RegisterItemCollection(collection);
+ EdmType contentType;
+ workspace.TryGetType("Person", "SchoolModel", DataSpace.CSpace, out contentType);
+ if (contentType.MetadataProperties.Contains("http://CustomNamespace.com:CustomElement"))
+ {
+     MetadataProperty annotationProperty =
+         contentType.MetadataProperties["http://CustomNamespace.com:CustomElement"];
+     object annotationValue = annotationProperty.Value;
+     Console.WriteLine(annotationValue.ToString());
+ }
+```
+ 
+
+The code above assumes that the School.csdl file is in the project's output directory and that you have added the following `Imports` and `Using` statements to your project:
+
+``` csharp
+ using System.Data.Metadata.Edm;
+```
+ 
+
+ 
+
+## Conceptual Model Types (CSDL)
+
+Conceptual schema definition language (CSDL) supports a set of abstract primitive data types, called **EDMSimpleTypes**, that define properties in a conceptual model. **EDMSimpleTypes** are proxies for primitive data types that are supported in the storage or hosting environment.
+
+The table below lists the primitive data types that are supported by CSDL. The table also lists the facets that can be applied to each **EDMSimpleType**.
+
+| EDMSimpleType                    | Description                                                | Applicable Facets                                                        |
+|:---------------------------------|:-----------------------------------------------------------|:-------------------------------------------------------------------------|
+| **Edm.Binary**                   | Contains binary data.                                      | MaxLength, FixedLength, Nullable, Default                                |
+| **Edm.Boolean**                  | Contains the value **true** or **false**.                  | Nullable, Default                                                        |
+| **Edm.Byte**                     | Contains an unsigned 8-bit integer value.                  | Precision, Nullable, Default                                             |
+| **Edm.DateTime**                 | Represents a date and time.                                | Precision, Nullable, Default                                             |
+| **Edm.DateTimeOffset**           | Contains a date and time as an offset in minutes from GMT. | Precision, Nullable, Default                                             |
+| **Edm.Decimal**                  | Contains a numeric value with fixed precision and scale.   | Precision, Nullable, Default                                             |
+| **Edm.Double**                   | Contains a floating point number with 15-digit precision   | Precision, Nullable, Default                                             |
+| **Edm.Float**                    | Contains a floating point number with 7-digit precision.   | Precision, Nullable, Default                                             |
+| **Edm.Guid**                     | Contains a 16-byte unique identifier.                      | Precision, Nullable, Default                                             |
+| **Edm.Int16**                    | Contains a signed 16-bit integer value.                    | Precision, Nullable, Default                                             |
+| **Edm.Int32**                    | Contains a signed 32-bit integer value.                    | Precision, Nullable, Default                                             |
+| **Edm.Int64**                    | Contains a signed 64-bit integer value.                    | Precision, Nullable, Default                                             |
+| **Edm.SByte**                    | Contains a signed 8-bit integer value.                     | Precision, Nullable, Default                                             |
+| **Edm.String**                   | Contains character data.                                   | Unicode, FixedLength, MaxLength, Collation, Precision, Nullable, Default |
+| **Edm.Time**                     | Contains a time of day.                                    | Precision, Nullable, Default                                             |
+| **Edm.Geography**                |                                                            | Nullable, Default, SRID                                                  |
+| **Edm.GeographyPoint**           |                                                            | Nullable, Default, SRID                                                  |
+| **Edm.GeographyLineString**      |                                                            | Nullable, Default, SRID                                                  |
+| **Edm.GeographyPolygon**         |                                                            | Nullable, Default, SRID                                                  |
+| **Edm.GeographyMultiPoint**      |                                                            | Nullable, Default, SRID                                                  |
+| **Edm.GeographyMultiLineString** |                                                            | Nullable, Default, SRID                                                  |
+| **Edm.GeographyMultiPolygon**    |                                                            | Nullable, Default, SRID                                                  |
+| **Edm.GeographyCollection**      |                                                            | Nullable, Default, SRID                                                  |
+| **Edm.Geometry**                 |                                                            | Nullable, Default, SRID                                                  |
+| **Edm.GeometryPoint**            |                                                            | Nullable, Default, SRID                                                  |
+| **Edm.GeometryLineString**       |                                                            | Nullable, Default, SRID                                                  |
+| **Edm.GeometryPolygon**          |                                                            | Nullable, Default, SRID                                                  |
+| **Edm.GeometryMultiPoint**       |                                                            | Nullable, Default, SRID                                                  |
+| **Edm.GeometryMultiLineString**  |                                                            | Nullable, Default, SRID                                                  |
+| **Edm.GeometryMultiPolygon**     |                                                            | Nullable, Default, SRID                                                  |
+| **Edm.GeometryCollection**       |                                                            | Nullable, Default, SRID                                                  |
+
+## Facets (CSDL)
+
+Facets in conceptual schema definition language (CSDL) represent constraints on properties of entity types and complex types. Facets appear as XML attributes on the following CSDL elements:
+
+-   Property
+-   TypeRef
+-   Parameter
+
+The following table describes the facets that are supported in CSDL. All facets are optional. Some facets listed below are used by the Entity Framework when generating a database from a conceptual model.
+
+> [!NOTE]
+> For information about data types in a conceptual model, see Conceptual Model Types (CSDL).
+
+| Facet               | Description                                                                                                                                                                                                                                                   | Applies to                                                                                                                                                                                                                                                                                                                                                                           | Used for the database generation | Used by the runtime |
+|:--------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:---------------------------------|:--------------------|
+| **Collation**       | Specifies the collating sequence (or sorting sequence) to be used when performing comparison and ordering operations on values of the property.                                                                                                               | **Edm.String**                                                                                                                                                                                                                                                                                                                                                                       | Yes                              | No                  |
+| **ConcurrencyMode** | Indicates that the value of the property should be used for optimistic concurrency checks.                                                                                                                                                                    | All **EDMSimpleType** properties                                                                                                                                                                                                                                                                                                                                                     | No                               | Yes                 |
+| **Default**         | Specifies the default value of the property if no value is supplied upon instantiation.                                                                                                                                                                       | All **EDMSimpleType** properties                                                                                                                                                                                                                                                                                                                                                     | Yes                              | Yes                 |
+| **FixedLength**     | Specifies whether the length of the property value can vary.                                                                                                                                                                                                  | **Edm.Binary**, **Edm.String**                                                                                                                                                                                                                                                                                                                                                       | Yes                              | No                  |
+| **MaxLength**       | Specifies the maximum length of the property value.                                                                                                                                                                                                           | **Edm.Binary**, **Edm.String**                                                                                                                                                                                                                                                                                                                                                       | Yes                              | No                  |
+| **Nullable**        | Specifies whether the property can have a **null** value.                                                                                                                                                                                                     | All **EDMSimpleType** properties                                                                                                                                                                                                                                                                                                                                                     | Yes                              | Yes                 |
+| **Precision**       | For properties of type **Decimal**, specifies the number of digits a property value can have. For properties of type **Time**, **DateTime**, and **DateTimeOffset**, specifies the number of digits for the fractional part of seconds of the property value. | **Edm.DateTime**, **Edm.DateTimeOffset**, **Edm.Decimal**, **Edm.Time**                                                                                                                                                                                                                                                                                                              | Yes                              | No                  |
+| **Scale**           | Specifies the number of digits to the right of the decimal point for the property value.                                                                                                                                                                      | **Edm.Decimal**                                                                                                                                                                                                                                                                                                                                                                      | Yes                              | No                  |
+| **SRID**            | Specifies the Spatial System Reference System ID. For more information, see [SRID](https://en.wikipedia.org/wiki/SRID) and [SRID (SQL Server)](https://msdn.microsoft.com/library/bb964707.aspx).                                                              | **Edm.Geography, Edm.GeographyPoint, Edm.GeographyLineString, Edm.GeographyPolygon, Edm.GeographyMultiPoint, Edm.GeographyMultiLineString, Edm.GeographyMultiPolygon, Edm.GeographyCollection, Edm.Geometry, Edm.GeometryPoint, Edm.GeometryLineString, Edm.GeometryPolygon, Edm.GeometryMultiPoint, Edm.GeometryMultiLineString, Edm.GeometryMultiPolygon, Edm.GeometryCollection** | No                               | Yes                 |
+| **Unicode**         | Indicates whether the property value is stored as Unicode.                                                                                                                                                                                                    | **Edm.String**                                                                                                                                                                                                                                                                                                                                                                       | Yes                              | Yes                 |
+
+>[!NOTE]
+> When generating a database from a conceptual model, the Generate Database Wizard will recognize the value of the **StoreGeneratedPattern** attribute on a **Property** element if it is in the following namespace: `https://schemas.microsoft.com/ado/2009/02/edm/annotation`. The supported values for the attribute are **Identity** and **Computed**. A value of **Identity** will produce a database column with an identity value that is generated in the database. A value of **Computed** will produce a column with a value that is computed in the database.
+
+### Example
+
+The following example shows facets applied to the properties of an entity type:
+
+``` xml
+ <EntityType Name="Product">
+   <Key>
+     <PropertyRef Name="ProductId" />
+   </Key>
+   <Property Type="Int32"
+             Name="ProductId" Nullable="false"
+             a:StoreGeneratedPattern="Identity"
+    xmlns:a="https://schemas.microsoft.com/ado/2009/02/edm/annotation" />
+   <Property Type="String"
+             Name="ProductName"
+             Nullable="false"
+             MaxLength="50" />
+   <Property Type="String"
+             Name="Location"
+             Nullable="true"
+             MaxLength="25" />
+ </EntityType>
+```
diff --git a/entity-framework/ef6/modeling/designer/advanced/edmx/msl-spec.md b/entity-framework/ef6/modeling/designer/advanced/edmx/msl-spec.md
new file mode 100644
index 0000000000..8f1d2db901
--- /dev/null
+++ b/entity-framework/ef6/modeling/designer/advanced/edmx/msl-spec.md
@@ -0,0 +1,1635 @@
+---
+title: MSL Specification - EF6
+description: MSL Specification in Entity Framework 6
+author: SamMonoRT
+ms.date: 08/23/2024
+uid: ef6/modeling/designer/advanced/edmx/msl-spec
+---
+# MSL Specification
+
+> [!NOTE]
+> MSL v1 is unsupported, please update to V3
+
+Mapping specification language (MSL) is an XML-based language that describes the mapping between the conceptual model and storage model of an Entity Framework application.
+
+In an Entity Framework application, mapping metadata is loaded from an .msl file (written in MSL) at build time. Entity Framework uses mapping metadata at runtime to translate queries against the conceptual model to store-specific commands.
+
+The Entity Framework Designer (EF Designer) stores mapping information in an .edmx file at design time. At build time, the Entity Designer uses information in an .edmx file to create the .msl file that is needed by Entity Framework at runtime
+
+Names of all conceptual or storage model types that are referenced in MSL must be qualified by their respective namespace names. For information about the conceptual model namespace name, see [CSDL Specification](xref:ef6/modeling/designer/advanced/edmx/csdl-spec). For information about the storage model namespace name, see [SSDL Specification](xref:ef6/modeling/designer/advanced/edmx/ssdl-spec).
+
+Versions of MSL are differentiated by XML namespaces.
+
+| MSL Version | XML Namespace                                        |
+|:------------|:-----------------------------------------------------|
+| MSL v1      | urn:schemas-microsoft-com:windows:storage:mapping:CS |
+| MSL v2      | `https://schemas.microsoft.com/ado/2008/09/mapping/cs` |
+| MSL v3      | `https://schemas.microsoft.com/ado/2009/11/mapping/cs` |
+
+## Alias Element (MSL)
+
+The **Alias** element in mapping specification language (MSL) is a child of the Mapping element that is used to define aliases for conceptual model and storage model namespaces. Names of all conceptual or storage model types that are referenced in MSL must be qualified by their respective namespace names. For information about the conceptual model namespace name, see Schema Element (CSDL). For information about the storage model namespace name, see Schema Element (SSDL).
+
+The **Alias** element cannot have child elements.
+
+### Applicable Attributes
+
+The table below describes the attributes that can be applied to the **Alias** element.
+
+| Attribute Name | Is Required | Value                                                                     |
+|:---------------|:------------|:--------------------------------------------------------------------------|
+| **Key**        | Yes         | The alias for the namespace that is specified by the **Value** attribute. |
+| **Value**      | Yes         | The namespace for which the value of the **Key** element is an alias.     |
+
+### Example
+
+The following example shows an **Alias** element that defines an alias, `c`, for types that are defined in the conceptual model.
+
+``` xml
+ <Mapping Space="C-S"
+          xmlns="https://schemas.microsoft.com/ado/2009/11/mapping/cs">
+   <Alias Key="c" Value="SchoolModel"/>
+   <EntityContainerMapping StorageEntityContainer="SchoolModelStoreContainer"
+                           CdmEntityContainer="SchoolModelEntities">
+     <EntitySetMapping Name="Courses">
+       <EntityTypeMapping TypeName="c.Course">
+         <MappingFragment StoreEntitySet="Course">
+           <ScalarProperty Name="CourseID" ColumnName="CourseID" />
+           <ScalarProperty Name="Title" ColumnName="Title" />
+           <ScalarProperty Name="Credits" ColumnName="Credits" />
+           <ScalarProperty Name="DepartmentID" ColumnName="DepartmentID" />
+         </MappingFragment>
+       </EntityTypeMapping>
+     </EntitySetMapping>
+     <EntitySetMapping Name="Departments">
+       <EntityTypeMapping TypeName="c.Department">
+         <MappingFragment StoreEntitySet="Department">
+           <ScalarProperty Name="DepartmentID" ColumnName="DepartmentID" />
+           <ScalarProperty Name="Name" ColumnName="Name" />
+           <ScalarProperty Name="Budget" ColumnName="Budget" />
+           <ScalarProperty Name="StartDate" ColumnName="StartDate" />
+           <ScalarProperty Name="Administrator" ColumnName="Administrator" />
+         </MappingFragment>
+       </EntityTypeMapping>
+     </EntitySetMapping>
+   </EntityContainerMapping>
+ </Mapping>
+```
+
+## AssociationEnd Element (MSL)
+
+The **AssociationEnd** element in mapping specification language (MSL) is used when the modification functions of an entity type in the conceptual model are mapped to stored procedures in the underlying database. If a modification stored procedure takes a parameter whose value is held in an association property, the **AssociationEnd** element maps the property value to the parameter. For more information, see the example below.
+
+For more information about mapping modification functions of entity types to stored procedures, see ModificationFunctionMapping Element (MSL) and Walkthrough: Mapping an Entity to Stored Procedures.
+
+The **AssociationEnd** element can have the following child elements:
+
+-   ScalarProperty
+
+### Applicable Attributes
+
+The following table describes the attributes that are applicable to the **AssociationEnd** element.
+
+| Attribute Name     | Is Required | Value                                                                                                                                                                             |
+|:-------------------|:------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **AssociationSet** | Yes         | The name of the association that is being mapped.                                                                                                                                 |
+| **From**           | Yes         | The value of the **FromRole** attribute of the navigation property that corresponds to the association being mapped. For more information, see NavigationProperty Element (CSDL). |
+| **To**             | Yes         | The value of the **ToRole** attribute of the navigation property that corresponds to the association being mapped. For more information, see NavigationProperty Element (CSDL).   |
+
+### Example
+
+Consider the following conceptual model entity type:
+
+``` xml
+ <EntityType Name="Course">
+   <Key>
+     <PropertyRef Name="CourseID" />
+   </Key>
+   <Property Type="Int32" Name="CourseID" Nullable="false" />
+   <Property Type="String" Name="Title" Nullable="false" MaxLength="100"
+             FixedLength="false" Unicode="true" />
+   <Property Type="Int32" Name="Credits" Nullable="false" />
+   <NavigationProperty Name="Department"
+                       Relationship="SchoolModel.FK_Course_Department"
+                       FromRole="Course" ToRole="Department" />
+ </EntityType>
+```
+
+Also consider the following stored procedure:
+
+``` SQL
+ CREATE PROCEDURE [dbo].[UpdateCourse]
+                                @CourseID int,
+                                @Title nvarchar(50),
+                                @Credits int,
+                                @DepartmentID int
+                                AS
+                                UPDATE Course SET Title=@Title,
+                                                              Credits=@Credits,
+                                                              DepartmentID=@DepartmentID
+                                WHERE CourseID=@CourseID;
+```
+
+In order to map the update function of the `Course` entity to this stored procedure, you must supply a value to the **DepartmentID** parameter. The value for `DepartmentID` does not correspond to a property on the entity type; it is contained in an independent association whose mapping is shown here:
+
+``` xml
+ <AssociationSetMapping Name="FK_Course_Department"
+                        TypeName="SchoolModel.FK_Course_Department"
+                        StoreEntitySet="Course">
+   <EndProperty Name="Course">
+     <ScalarProperty Name="CourseID" ColumnName="CourseID" />
+   </EndProperty>
+   <EndProperty Name="Department">
+     <ScalarProperty Name="DepartmentID" ColumnName="DepartmentID" />
+   </EndProperty>
+ </AssociationSetMapping>
+```
+
+The following code shows the **AssociationEnd** element used to map the **DepartmentID** property of the **FK\_Course\_Department** association to the **UpdateCourse** stored procedure (to which the update function of the **Course** entity type is mapped):
+
+``` xml
+ <EntitySetMapping Name="Courses">
+   <EntityTypeMapping TypeName="SchoolModel.Course">
+     <MappingFragment StoreEntitySet="Course">
+       <ScalarProperty Name="Credits" ColumnName="Credits" />
+       <ScalarProperty Name="Title" ColumnName="Title" />
+       <ScalarProperty Name="CourseID" ColumnName="CourseID" />
+     </MappingFragment>
+   </EntityTypeMapping>
+   <EntityTypeMapping TypeName="SchoolModel.Course">
+     <ModificationFunctionMapping>
+       <UpdateFunction FunctionName="SchoolModel.Store.UpdateCourse">
+         <AssociationEnd AssociationSet="FK_Course_Department"
+                         From="Course" To="Department">
+           <ScalarProperty Name="DepartmentID"
+                           ParameterName="DepartmentID"
+                           Version="Current" />
+         </AssociationEnd>
+         <ScalarProperty Name="Credits" ParameterName="Credits"
+                         Version="Current" />
+         <ScalarProperty Name="Title" ParameterName="Title"
+                         Version="Current" />
+         <ScalarProperty Name="CourseID" ParameterName="CourseID"
+                         Version="Current" />
+       </UpdateFunction>
+     </ModificationFunctionMapping>
+   </EntityTypeMapping>
+ </EntitySetMapping>
+```
+
+## AssociationSetMapping Element (MSL)
+
+The **AssociationSetMapping** element in mapping specification language (MSL) defines the mapping between an association in the conceptual model and table columns in the underlying database.
+
+Associations in the conceptual model are types whose properties represent primary and foreign key columns in the underlying database. The **AssociationSetMapping** element uses two EndProperty elements to define the mappings between association type properties and columns in the database. You can place conditions on these mappings with the Condition element. Map the insert, update, and delete functions for associations to stored procedures in the database with the ModificationFunctionMapping element. Define read-only mappings between associations and table columns by using an Entity SQL string in a QueryView element.
+
+> [!NOTE]
+> If a referential constraint is defined for an association in the conceptual model, the association does not need to be mapped with an **AssociationSetMapping** element. If an **AssociationSetMapping** element is present for an association that has a referential constraint, the mappings defined in the **AssociationSetMapping** element will be ignored. For more information, see ReferentialConstraint Element (CSDL).
+
+The **AssociationSetMapping** element can have the following child elements
+
+-   QueryView (zero or one)
+-   EndProperty (zero or two)
+-   Condition (zero or more)
+-   ModificationFunctionMapping (zero or one)
+
+### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **AssociationSetMapping** element.
+
+| Attribute Name     | Is Required | Value                                                                                       |
+|:-------------------|:------------|:--------------------------------------------------------------------------------------------|
+| **Name**           | Yes         | The name of the conceptual model association set that is being mapped.                      |
+| **TypeName**       | No          | The namespace-qualified name of the conceptual model association type that is being mapped. |
+| **StoreEntitySet** | No          | The name of the table that is being mapped.                                                 |
+
+### Example
+
+The following example shows an **AssociationSetMapping** element in which the **FK\_Course\_Department** association set in the conceptual model is mapped to the **Course** table in the database. Mappings between association type properties and table columns are specified in child **EndProperty** elements.
+
+``` xml
+ <AssociationSetMapping Name="FK_Course_Department"
+                        TypeName="SchoolModel.FK_Course_Department"
+                        StoreEntitySet="Course">
+   <EndProperty Name="Department">
+     <ScalarProperty Name="DepartmentID" ColumnName="DepartmentID" />
+   </EndProperty>
+   <EndProperty Name="Course">
+     <ScalarProperty Name="CourseID" ColumnName="CourseID" />
+   </EndProperty>
+ </AssociationSetMapping>
+```
+
+## ComplexProperty Element (MSL)
+
+A **ComplexProperty** element in mapping specification language (MSL) defines the mapping between a complex type property on a conceptual model entity type and table columns in the underlying database. The property-column mappings are specified in child ScalarProperty elements.
+
+The **ComplexType** property element can have the following child elements:
+
+-   ScalarProperty (zero or more)
+-   **ComplexProperty** (zero or more)
+-   ComplexTypeMapping (zero or more)
+-   Condition (zero or more)
+
+### Applicable Attributes
+
+The following table describes the attributes that are applicable to the **ComplexProperty** element:
+
+| Attribute Name | Is Required | Value                                                                                            |
+|:---------------|:------------|:-------------------------------------------------------------------------------------------------|
+| **Name**       | Yes         | The name of the complex property of an entity type in the conceptual model that is being mapped. |
+| **TypeName**   | No          | The namespace-qualified name of the conceptual model property type.                              |
+
+### Example
+
+The following example is based on the School model. The following complex type has been added to the conceptual model:
+
+``` xml
+ <ComplexType Name="FullName">
+   <Property Type="String" Name="LastName"
+             Nullable="false" MaxLength="50"
+             FixedLength="false" Unicode="true" />
+   <Property Type="String" Name="FirstName"
+             Nullable="false" MaxLength="50"
+             FixedLength="false" Unicode="true" />
+ </ComplexType>
+```
+
+The **LastName** and **FirstName** properties of the **Person** entity type have been replaced with one complex property, **Name**:
+
+``` xml
+ <EntityType Name="Person">
+   <Key>
+     <PropertyRef Name="PersonID" />
+   </Key>
+   <Property Name="PersonID" Type="Int32" Nullable="false"
+             annotation:StoreGeneratedPattern="Identity" />
+   <Property Name="HireDate" Type="DateTime" />
+   <Property Name="EnrollmentDate" Type="DateTime" />
+   <Property Name="Name" Type="SchoolModel.FullName" Nullable="false" />
+ </EntityType>
+```
+
+The following MSL shows the **ComplexProperty** element used to map the **Name** property to columns in the underlying database:
+
+``` xml
+ <EntitySetMapping Name="People">
+   <EntityTypeMapping TypeName="SchoolModel.Person">
+     <MappingFragment StoreEntitySet="Person">
+       <ScalarProperty Name="PersonID" ColumnName="PersonID" />
+       <ScalarProperty Name="HireDate" ColumnName="HireDate" />
+       <ScalarProperty Name="EnrollmentDate" ColumnName="EnrollmentDate" />
+       <ComplexProperty Name="Name" TypeName="SchoolModel.FullName">
+         <ScalarProperty Name="FirstName" ColumnName="FirstName" />
+         <ScalarProperty Name="LastName" ColumnName="LastName" />  
+       </ComplexProperty>
+     </MappingFragment>
+   </EntityTypeMapping>
+ </EntitySetMapping>
+```
+
+## ComplexTypeMapping Element (MSL)
+
+The **ComplexTypeMapping** element in mapping specification language (MSL) is a child of the ResultMapping element and defines the mapping between a function import in the conceptual model and a stored procedure in the underlying database when the following are true:
+
+-   The function import returns a conceptual complex type.
+-   The names of the columns returned by the stored procedure do not exactly match the names of the properties on the complex type.
+
+By default, the mapping between the columns returned by a stored procedure and a complex type is based on column and property names. If column names do not exactly match property names, you must use the **ComplexTypeMapping** element to define the mapping. For an example of the default mapping, see FunctionImportMapping Element (MSL).
+
+The **ComplexTypeMapping** element can have the following child elements:
+
+-   ScalarProperty (zero or more)
+
+### Applicable Attributes
+
+The following table describes the attributes that are applicable to the **ComplexTypeMapping** element.
+
+| Attribute Name | Is Required | Value                                                                  |
+|:---------------|:------------|:-----------------------------------------------------------------------|
+| **TypeName**   | Yes         | The namespace-qualified name of the complex type that is being mapped. |
+
+### Example
+
+Consider the following stored procedure:
+
+``` SQL
+ CREATE PROCEDURE [dbo].[GetGrades]
+             @student_Id int
+             AS
+             SELECT     EnrollmentID as enroll_id,
+                                                                             Grade as grade,
+                                                                             CourseID as course_id,
+                                                                             StudentID as student_id
+                                               FROM dbo.StudentGrade
+             WHERE StudentID = @student_Id
+```
+
+Also consider the following conceptual model complex type:
+
+``` xml
+ <ComplexType Name="GradeInfo">
+   <Property Type="Int32" Name="EnrollmentID" Nullable="false" />
+   <Property Type="Decimal" Name="Grade" Nullable="true"
+             Precision="3" Scale="2" />
+   <Property Type="Int32" Name="CourseID" Nullable="false" />
+   <Property Type="Int32" Name="StudentID" Nullable="false" />
+ </ComplexType>
+```
+
+In order to create a function import that returns instances of the previous complex type, the mapping between the columns returned by the stored procedure and the entity type must be defined in a **ComplexTypeMapping** element:
+
+``` xml
+ <FunctionImportMapping FunctionImportName="GetGrades"
+                        FunctionName="SchoolModel.Store.GetGrades" >
+   <ResultMapping>
+     <ComplexTypeMapping TypeName="SchoolModel.GradeInfo">
+       <ScalarProperty Name="EnrollmentID" ColumnName="enroll_id"/>
+       <ScalarProperty Name="CourseID" ColumnName="course_id"/>
+       <ScalarProperty Name="StudentID" ColumnName="student_id"/>
+       <ScalarProperty Name="Grade" ColumnName="grade"/>
+     </ComplexTypeMapping>
+   </ResultMapping>
+ </FunctionImportMapping>
+```
+
+## Condition Element (MSL)
+
+The **Condition** element in mapping specification language (MSL) places conditions on mappings between the conceptual model and the underlying database. The mapping that is defined within an XML node is valid if all conditions, as specified in child **Condition** elements, are met. Otherwise, the mapping is not valid. For example, if a MappingFragment element contains one or more **Condition** child elements, the mapping defined within the **MappingFragment** node will only be valid if all the conditions of the child **Condition** elements are met.
+
+Each condition can apply to either a **Name** (the name of a conceptual model entity property, specified by the **Name** attribute), or a **ColumnName** (the name of a column in the database, specified by the **ColumnName** attribute). When the **Name** attribute is set, the condition is checked against an entity property value. When the **ColumnName** attribute is set, the condition is checked against a column value. Only one of the **Name** or **ColumnName** attribute can be specified in a **Condition** element.
+
+> [!NOTE]
+> When the **Condition** element is used within a FunctionImportMapping element, only the **Name** attribute is not applicable.
+
+The **Condition** element can be a child of the following elements:
+
+-   AssociationSetMapping
+-   ComplexProperty
+-   EntitySetMapping
+-   MappingFragment
+-   EntityTypeMapping
+
+The **Condition** element can have no child elements.
+
+### Applicable Attributes
+
+The following table describes the attributes that are applicable to the **Condition** element:
+
+| Attribute Name | Is Required | Value                                                                                                                                                                                                                                                                                         |
+|:---------------|:------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **ColumnName** | No          | The name of the table column whose value is used to evaluate the condition.                                                                                                                                                                                                                   |
+| **IsNull**     | No          | **True** or **False**. If the value is **True** and the column value is **null**, or if the value is **False** and the column value is not **null**, the condition is true. Otherwise, the condition is false. <br/> The **IsNull** and **Value** attributes cannot be used at the same time. |
+| **Value**      | No          | The value with which the column value is compared. If the values are the same, the condition is true. Otherwise, the condition is false. <br/> The **IsNull** and **Value** attributes cannot be used at the same time.                                                                       |
+| **Name**       | No          | The name of the conceptual model entity property whose value is used to evaluate the condition. <br/> This attribute is not applicable if the **Condition** element is used within a FunctionImportMapping element.                                                                           |
+
+### Example
+
+The following example shows **Condition** elements as children of **MappingFragment** elements. When **HireDate** is not null and **EnrollmentDate** is null, data is mapped between the **SchoolModel.Instructor** type and the **PersonID** and **HireDate** columns of the **Person** table. When **EnrollmentDate** is not null and **HireDate** is null, data is mapped between the **SchoolModel.Student** type and the **PersonID** and **Enrollment** columns of the **Person** table.
+
+``` xml
+ <EntitySetMapping Name="People">
+   <EntityTypeMapping TypeName="IsTypeOf(SchoolModel.Person)">
+     <MappingFragment StoreEntitySet="Person">
+       <ScalarProperty Name="PersonID" ColumnName="PersonID" />
+       <ScalarProperty Name="FirstName" ColumnName="FirstName" />
+       <ScalarProperty Name="LastName" ColumnName="LastName" />
+     </MappingFragment>
+   </EntityTypeMapping>
+   <EntityTypeMapping TypeName="IsTypeOf(SchoolModel.Instructor)">
+     <MappingFragment StoreEntitySet="Person">
+       <ScalarProperty Name="PersonID" ColumnName="PersonID" />
+       <ScalarProperty Name="HireDate" ColumnName="HireDate" />
+       <Condition ColumnName="HireDate" IsNull="false" />
+       <Condition ColumnName="EnrollmentDate" IsNull="true" />
+     </MappingFragment>
+   </EntityTypeMapping>
+   <EntityTypeMapping TypeName="IsTypeOf(SchoolModel.Student)">
+     <MappingFragment StoreEntitySet="Person">
+       <ScalarProperty Name="PersonID" ColumnName="PersonID" />
+       <ScalarProperty Name="EnrollmentDate"
+                       ColumnName="EnrollmentDate" />
+       <Condition ColumnName="EnrollmentDate" IsNull="false" />
+       <Condition ColumnName="HireDate" IsNull="true" />
+     </MappingFragment>
+   </EntityTypeMapping>
+ </EntitySetMapping>
+```
+
+## DeleteFunction Element (MSL)
+
+The **DeleteFunction** element in mapping specification language (MSL) maps the delete function of an entity type or association in the conceptual model to a stored procedure in the underlying database. Stored procedures to which modification functions are mapped must be declared in the storage model. For more information, see Function Element (SSDL).
+
+> [!NOTE]
+> If you do not map all three of the insert, update, or delete operations of an entity type to stored procedures, the unmapped operations will fail if executed at runtime and an UpdateException is thrown.
+
+### DeleteFunction Applied to EntityTypeMapping
+
+When applied to the EntityTypeMapping element, the **DeleteFunction** element maps the delete function of an entity type in the conceptual model to a stored procedure.
+
+The **DeleteFunction** element can have the following child elements when applied to an **EntityTypeMapping** element:
+
+-   AssociationEnd (zero or more)
+-   ComplexProperty (zero or more)
+-   ScalarProperty (zero or more)
+
+#### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **DeleteFunction** element when it is applied to an **EntityTypeMapping** element.
+
+| Attribute Name            | Is Required | Value                                                                                                                                                    |
+|:--------------------------|:------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **FunctionName**          | Yes         | The namespace-qualified name of the stored procedure to which the delete function is mapped. The stored procedure must be declared in the storage model. |
+| **RowsAffectedParameter** | No          | The name of the output parameter that returns the number of rows affected.                                                                               |
+
+#### Example
+
+The following example is based on the School model and shows the **DeleteFunction** element mapping the delete function of the **Person** entity type to the **DeletePerson** stored procedure. The **DeletePerson** stored procedure is declared in the storage model.
+
+``` xml
+ <EntitySetMapping Name="People">
+   <EntityTypeMapping TypeName="SchoolModel.Person">
+     <MappingFragment StoreEntitySet="Person">
+       <ScalarProperty Name="PersonID" ColumnName="PersonID" />
+       <ScalarProperty Name="LastName" ColumnName="LastName" />
+       <ScalarProperty Name="FirstName" ColumnName="FirstName" />
+       <ScalarProperty Name="HireDate" ColumnName="HireDate" />
+       <ScalarProperty Name="EnrollmentDate"
+                       ColumnName="EnrollmentDate" />
+     </MappingFragment>
+ </EntityTypeMapping>
+   <EntityTypeMapping TypeName="SchoolModel.Person">
+     <ModificationFunctionMapping>
+       <InsertFunction FunctionName="SchoolModel.Store.InsertPerson">
+         <ScalarProperty Name="EnrollmentDate"
+                         ParameterName="EnrollmentDate" />
+         <ScalarProperty Name="HireDate" ParameterName="HireDate" />
+         <ScalarProperty Name="FirstName" ParameterName="FirstName" />
+         <ScalarProperty Name="LastName" ParameterName="LastName" />
+         <ResultBinding Name="PersonID" ColumnName="NewPersonID" />
+       </InsertFunction>
+       <UpdateFunction FunctionName="SchoolModel.Store.UpdatePerson">
+         <ScalarProperty Name="EnrollmentDate"
+                         ParameterName="EnrollmentDate"
+                         Version="Current" />
+         <ScalarProperty Name="HireDate" ParameterName="HireDate"
+                         Version="Current" />
+         <ScalarProperty Name="FirstName" ParameterName="FirstName"
+                         Version="Current" />
+         <ScalarProperty Name="LastName" ParameterName="LastName"
+                         Version="Current" />
+         <ScalarProperty Name="PersonID" ParameterName="PersonID"
+                         Version="Current" />
+       </UpdateFunction>
+       <DeleteFunction FunctionName="SchoolModel.Store.DeletePerson">
+         <ScalarProperty Name="PersonID" ParameterName="PersonID" />
+       </DeleteFunction>
+     </ModificationFunctionMapping>
+   </EntityTypeMapping>
+ </EntitySetMapping>
+```
+
+### DeleteFunction Applied to AssociationSetMapping
+
+When applied to the AssociationSetMapping element, the **DeleteFunction** element maps the delete function of an association in the conceptual model to a stored procedure.
+
+The **DeleteFunction** element can have the following child elements when applied to the **AssociationSetMapping** element:
+
+-   EndProperty
+
+#### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **DeleteFunction** element when it is applied to the **AssociationSetMapping** element.
+
+| Attribute Name            | Is Required | Value                                                                                                                                                    |
+|:--------------------------|:------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **FunctionName**          | Yes         | The namespace-qualified name of the stored procedure to which the delete function is mapped. The stored procedure must be declared in the storage model. |
+| **RowsAffectedParameter** | No          | The name of the output parameter that returns the number of rows affected.                                                                               |
+
+#### Example
+
+The following example is based on the School model and shows the **DeleteFunction** element used to map delete function of the **CourseInstructor** association to the **DeleteCourseInstructor** stored procedure. The **DeleteCourseInstructor** stored procedure is declared in the storage model.
+
+``` xml
+ <AssociationSetMapping Name="CourseInstructor"
+                        TypeName="SchoolModel.CourseInstructor"
+                        StoreEntitySet="CourseInstructor">
+   <EndProperty Name="Person">
+     <ScalarProperty Name="PersonID" ColumnName="PersonID" />
+   </EndProperty>
+   <EndProperty Name="Course">
+     <ScalarProperty Name="CourseID" ColumnName="CourseID" />
+   </EndProperty>
+   <ModificationFunctionMapping>
+     <InsertFunction FunctionName="SchoolModel.Store.InsertCourseInstructor" >   
+       <EndProperty Name="Course">
+         <ScalarProperty Name="CourseID" ParameterName="courseId"/>
+       </EndProperty>
+       <EndProperty Name="Person">
+         <ScalarProperty Name="PersonID" ParameterName="instructorId"/>
+       </EndProperty>
+     </InsertFunction>
+     <DeleteFunction FunctionName="SchoolModel.Store.DeleteCourseInstructor">
+       <EndProperty Name="Course">
+         <ScalarProperty Name="CourseID" ParameterName="courseId"/>
+       </EndProperty>
+       <EndProperty Name="Person">
+         <ScalarProperty Name="PersonID" ParameterName="instructorId"/>
+       </EndProperty>
+     </DeleteFunction>
+   </ModificationFunctionMapping>
+ </AssociationSetMapping>
+```
+
+## EndProperty Element (MSL)
+
+The **EndProperty** element in mapping specification language (MSL) defines the mapping between an end or a modification function of a conceptual model association and the underlying database. The property-column mapping is specified in a child ScalarProperty element.
+
+When an **EndProperty** element is used to define the mapping for the end of a conceptual model association, it is a child of an AssociationSetMapping element. When the **EndProperty** element is used to define the mapping for a modification function of a conceptual model association, it is a child of an InsertFunction element or DeleteFunction element.
+
+The **EndProperty** element can have the following child elements:
+
+-   ScalarProperty (zero or more)
+
+### Applicable Attributes
+
+The following table describes the attributes that are applicable to the **EndProperty** element:
+
+| Attribute Name | Is Required | Value                                                 |
+|:---------------|:------------|:------------------------------------------------------|
+| Name           | Yes         | The name of the association end that is being mapped. |
+
+### Example
+
+The following example shows an **AssociationSetMapping** element in which the **FK\_Course\_Department** association in the conceptual model is mapped to the **Course** table in the database. Mappings between association type properties and table columns are specified in child **EndProperty** elements.
+
+``` xml
+ <AssociationSetMapping Name="FK_Course_Department"
+                        TypeName="SchoolModel.FK_Course_Department"
+                        StoreEntitySet="Course">
+   <EndProperty Name="Department">
+     <ScalarProperty Name="DepartmentID" ColumnName="DepartmentID" />
+   </EndProperty>
+   <EndProperty Name="Course">
+     <ScalarProperty Name="CourseID" ColumnName="CourseID" />
+   </EndProperty>
+ </AssociationSetMapping>
+```
+
+### Example
+
+The following example shows the **EndProperty** element mapping the insert and delete functions of an association (**CourseInstructor**) to stored procedures in the underlying database. The functions that are mapped to are declared in the storage model.
+
+``` xml
+ <AssociationSetMapping Name="CourseInstructor"
+                        TypeName="SchoolModel.CourseInstructor"
+                        StoreEntitySet="CourseInstructor">
+   <EndProperty Name="Person">
+     <ScalarProperty Name="PersonID" ColumnName="PersonID" />
+   </EndProperty>
+   <EndProperty Name="Course">
+     <ScalarProperty Name="CourseID" ColumnName="CourseID" />
+   </EndProperty>
+   <ModificationFunctionMapping>
+     <InsertFunction FunctionName="SchoolModel.Store.InsertCourseInstructor" >   
+       <EndProperty Name="Course">
+         <ScalarProperty Name="CourseID" ParameterName="courseId"/>
+       </EndProperty>
+       <EndProperty Name="Person">
+         <ScalarProperty Name="PersonID" ParameterName="instructorId"/>
+       </EndProperty>
+     </InsertFunction>
+     <DeleteFunction FunctionName="SchoolModel.Store.DeleteCourseInstructor">
+       <EndProperty Name="Course">
+         <ScalarProperty Name="CourseID" ParameterName="courseId"/>
+       </EndProperty>
+       <EndProperty Name="Person">
+         <ScalarProperty Name="PersonID" ParameterName="instructorId"/>
+       </EndProperty>
+     </DeleteFunction>
+   </ModificationFunctionMapping>
+ </AssociationSetMapping>
+```
+
+## EntityContainerMapping Element (MSL)
+
+The **EntityContainerMapping** element in mapping specification language (MSL) maps the entity container in the conceptual model to the entity container in the storage model. The **EntityContainerMapping** element is a child of the Mapping element.
+
+The **EntityContainerMapping** element can have the following child elements (in the order listed):
+
+-   EntitySetMapping (zero or more)
+-   AssociationSetMapping (zero or more)
+-   FunctionImportMapping (zero or more)
+
+### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **EntityContainerMapping** element.
+
+| Attribute Name            | Is Required | Value                                                                                                                                                                                                                                                    |
+|:--------------------------|:------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **StorageModelContainer** | Yes         | The name of the storage model entity container that is being mapped.                                                                                                                                                                                     |
+| **CdmEntityContainer**    | Yes         | The name of the conceptual model entity container that is being mapped.                                                                                                                                                                                  |
+| **GenerateUpdateViews**   | No          | **True** or **False**. If **False**, no update views are generated. This attribute should be set to **False** when you have a read-only mapping that would be invalid because data may not round-trip successfully. <br/> The default value is **True**. |
+
+### Example
+
+The following example shows an **EntityContainerMapping** element that maps the **SchoolModelEntities** container (the conceptual model entity container) to the **SchoolModelStoreContainer** container (the storage model entity container):
+
+``` xml
+ <EntityContainerMapping StorageEntityContainer="SchoolModelStoreContainer"
+                         CdmEntityContainer="SchoolModelEntities">
+   <EntitySetMapping Name="Courses">
+     <EntityTypeMapping TypeName="c.Course">
+       <MappingFragment StoreEntitySet="Course">
+         <ScalarProperty Name="CourseID" ColumnName="CourseID" />
+         <ScalarProperty Name="Title" ColumnName="Title" />
+         <ScalarProperty Name="Credits" ColumnName="Credits" />
+         <ScalarProperty Name="DepartmentID" ColumnName="DepartmentID" />
+       </MappingFragment>
+     </EntityTypeMapping>
+   </EntitySetMapping>
+   <EntitySetMapping Name="Departments">
+     <EntityTypeMapping TypeName="c.Department">
+       <MappingFragment StoreEntitySet="Department">
+         <ScalarProperty Name="DepartmentID" ColumnName="DepartmentID" />
+         <ScalarProperty Name="Name" ColumnName="Name" />
+         <ScalarProperty Name="Budget" ColumnName="Budget" />
+         <ScalarProperty Name="StartDate" ColumnName="StartDate" />
+         <ScalarProperty Name="Administrator" ColumnName="Administrator" />
+       </MappingFragment>
+     </EntityTypeMapping>
+   </EntitySetMapping>
+ </EntityContainerMapping>
+```
+
+## EntitySetMapping Element (MSL)
+
+The **EntitySetMapping** element in mapping specification language (MSL) maps all types in a conceptual model entity set to entity sets in the storage model. An entity set in the conceptual model is a logical container for instances of entities of the same type (and derived types). An entity set in the storage model represents a table or view in the underlying database. The conceptual model entity set is specified by the value of the **Name** attribute of the **EntitySetMapping** element. The mapped-to table or view is specified by the **StoreEntitySet** attribute in each child MappingFragment element or in the **EntitySetMapping** element itself.
+
+The **EntitySetMapping** element can have the following child elements:
+
+-   EntityTypeMapping (zero or more)
+-   QueryView (zero or one)
+-   MappingFragment (zero or more)
+
+### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **EntitySetMapping** element.
+
+| Attribute Name           | Is Required | Value                                                                                                                                                                                                                         |
+|:-------------------------|:------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Name**                 | Yes         | The name of the conceptual model entity set that is being mapped.                                                                                                                                                             |
+| **TypeName** **1**       | No          | The name of the conceptual model entity type that is being mapped.                                                                                                                                                            |
+| **StoreEntitySet** **1** | No          | The name of the storage model entity set that is being mapped to.                                                                                                                                                             |
+| **MakeColumnsDistinct**  | No          | **True** or **False** depending on whether only distinct rows are returned. <br/> If this attribute is set to **True**, the **GenerateUpdateViews** attribute of the EntityContainerMapping element must be set to **False**. |
+
+ 
+
+**1** The **TypeName** and **StoreEntitySet** attributes can be used in place of the EntityTypeMapping and MappingFragment child elements to map a single entity type to a single table.
+
+### Example
+
+The following example shows an **EntitySetMapping** element that maps three types (a base type and two derived types) in the **Courses** entity set of the conceptual model to three different tables in the underlying database. The tables are specified by the **StoreEntitySet** attribute in each **MappingFragment** element.
+
+``` xml
+ <EntitySetMapping Name="Courses">
+   <EntityTypeMapping TypeName="IsTypeOf(SchoolModel1.Course)">
+     <MappingFragment StoreEntitySet="Course">
+       <ScalarProperty Name="CourseID" ColumnName="CourseID" />
+       <ScalarProperty Name="DepartmentID" ColumnName="DepartmentID" />
+       <ScalarProperty Name="Credits" ColumnName="Credits" />
+       <ScalarProperty Name="Title" ColumnName="Title" />
+     </MappingFragment>
+   </EntityTypeMapping>
+   <EntityTypeMapping TypeName="IsTypeOf(SchoolModel1.OnlineCourse)">
+     <MappingFragment StoreEntitySet="OnlineCourse">
+       <ScalarProperty Name="CourseID" ColumnName="CourseID" />
+       <ScalarProperty Name="URL" ColumnName="URL" />
+     </MappingFragment>
+   </EntityTypeMapping>
+   <EntityTypeMapping TypeName="IsTypeOf(SchoolModel1.OnsiteCourse)">
+     <MappingFragment StoreEntitySet="OnsiteCourse">
+       <ScalarProperty Name="CourseID" ColumnName="CourseID" />
+       <ScalarProperty Name="Time" ColumnName="Time" />
+       <ScalarProperty Name="Days" ColumnName="Days" />
+       <ScalarProperty Name="Location" ColumnName="Location" />
+     </MappingFragment>
+   </EntityTypeMapping>
+ </EntitySetMapping>
+```
+
+## EntityTypeMapping Element (MSL)
+
+The **EntityTypeMapping** element in mapping specification language (MSL) defines the mapping between an entity type in the conceptual model and tables or views in the underlying database. For information about conceptual model entity types and underlying database tables or views, see EntityType Element (CSDL) and EntitySet Element (SSDL). The conceptual model entity type that is being mapped is specified by the **TypeName** attribute of the **EntityTypeMapping** element. The table or view that is being mapped is specified by the **StoreEntitySet** attribute of the child MappingFragment element.
+
+The ModificationFunctionMapping child element can be used to map the insert, update, or delete functions of entity types to stored procedures in the database.
+
+The **EntityTypeMapping** element can have the following child elements:
+
+-   MappingFragment (zero or more)
+-   ModificationFunctionMapping (zero or one)
+-   ScalarProperty
+-   Condition
+
+> [!NOTE]
+> **MappingFragment** and **ModificationFunctionMapping** elements cannot be child elements of the **EntityTypeMapping** element at the same time.
+
+
+> [!NOTE]
+> The **ScalarProperty** and **Condition** elements can only be child elements of the **EntityTypeMapping** element when it is used within a FunctionImportMapping element.
+
+### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **EntityTypeMapping** element.
+
+| Attribute Name | Is Required | Value                                                                                                                                                                                                |
+|:---------------|:------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **TypeName**   | Yes         | The namespace-qualified name of the conceptual model entity type that is being mapped. <br/> If the type is abstract or a derived type, the value must be `IsOfType(Namespace-qualified_type_name)`. |
+
+### Example
+
+The following example shows an EntitySetMapping element with two child **EntityTypeMapping** elements. In the first **EntityTypeMapping** element, the **SchoolModel.Person** entity type is mapped to the **Person** table. In the second **EntityTypeMapping** element, the update functionality of the **SchoolModel.Person** type is mapped to a stored procedure, **UpdatePerson**, in the database.
+
+``` xml
+ <EntitySetMapping Name="People">
+   <EntityTypeMapping TypeName="SchoolModel.Person">
+     <MappingFragment StoreEntitySet="Person">
+       <ScalarProperty Name="PersonID" ColumnName="PersonID" />
+       <ScalarProperty Name="LastName" ColumnName="LastName" />
+       <ScalarProperty Name="FirstName" ColumnName="FirstName" />
+       <ScalarProperty Name="HireDate" ColumnName="HireDate" />
+       <ScalarProperty Name="EnrollmentDate" ColumnName="EnrollmentDate" />
+     </MappingFragment>
+   </EntityTypeMapping>
+   <EntityTypeMapping TypeName="SchoolModel.Person">
+     <ModificationFunctionMapping>
+       <UpdateFunction FunctionName="SchoolModel.Store.UpdatePerson">
+         <ScalarProperty Name="EnrollmentDate" ParameterName="EnrollmentDate"
+                         Version="Current" />
+         <ScalarProperty Name="HireDate" ParameterName="HireDate"
+                         Version="Current" />
+         <ScalarProperty Name="FirstName" ParameterName="FirstName"
+                         Version="Current" />
+         <ScalarProperty Name="LastName" ParameterName="LastName"
+                         Version="Current" />
+         <ScalarProperty Name="PersonID" ParameterName="PersonID"
+                         Version="Current" />
+       </UpdateFunction>
+     </ModificationFunctionMapping>
+   </EntityTypeMapping>
+ </EntitySetMapping>
+```
+
+### Example
+
+The next example shows the mapping of a type hierarchy in which the root type is abstract. Note the use of the `IsOfType` syntax for the **TypeName** attributes.
+
+``` xml
+ <EntitySetMapping Name="People">
+   <EntityTypeMapping TypeName="IsTypeOf(SchoolModel.Person)">
+     <MappingFragment StoreEntitySet="Person">
+       <ScalarProperty Name="PersonID" ColumnName="PersonID" />
+       <ScalarProperty Name="FirstName" ColumnName="FirstName" />
+       <ScalarProperty Name="LastName" ColumnName="LastName" />
+     </MappingFragment>
+   </EntityTypeMapping>
+   <EntityTypeMapping TypeName="IsTypeOf(SchoolModel.Instructor)">
+     <MappingFragment StoreEntitySet="Person">
+       <ScalarProperty Name="PersonID" ColumnName="PersonID" />
+       <ScalarProperty Name="HireDate" ColumnName="HireDate" />
+       <Condition ColumnName="HireDate" IsNull="false" />
+       <Condition ColumnName="EnrollmentDate" IsNull="true" />
+     </MappingFragment>
+   </EntityTypeMapping>
+   <EntityTypeMapping TypeName="IsTypeOf(SchoolModel.Student)">
+     <MappingFragment StoreEntitySet="Person">
+       <ScalarProperty Name="PersonID" ColumnName="PersonID" />
+       <ScalarProperty Name="EnrollmentDate"
+                       ColumnName="EnrollmentDate" />
+       <Condition ColumnName="EnrollmentDate" IsNull="false" />
+       <Condition ColumnName="HireDate" IsNull="true" />
+     </MappingFragment>
+   </EntityTypeMapping>
+ </EntitySetMapping>
+```
+
+## FunctionImportMapping Element (MSL)
+
+The **FunctionImportMapping** element in mapping specification language (MSL) defines the mapping between a function import in the conceptual model and a stored procedure or function in the underlying database. Function imports must be declared in the conceptual model and stored procedures must be declared in the storage model. For more information, see FunctionImport Element (CSDL) and Function Element (SSDL).
+
+> [!NOTE]
+> By default, if a function import returns a conceptual model entity type or complex type, then the names of the columns returned by the underlying stored procedure must exactly match the names of the properties on the conceptual model type. If the column names do not exactly match the property names, the mapping must be defined in a ResultMapping element.
+
+The **FunctionImportMapping** element can have the following child elements:
+
+-   ResultMapping (zero or more)
+
+### Applicable Attributes
+
+The following table describes the attributes that are applicable to the **FunctionImportMapping** element:
+
+| Attribute Name         | Is Required | Value                                                                                   |
+|:-----------------------|:------------|:----------------------------------------------------------------------------------------|
+| **FunctionImportName** | Yes         | The name of the function import in the conceptual model that is being mapped.           |
+| **FunctionName**       | Yes         | The namespace-qualified name of the function in the storage model that is being mapped. |
+
+### Example
+
+The following example is based on the School model. Consider the following function in the storage model:
+
+``` xml
+ <Function Name="GetStudentGrades" Aggregate="false"
+           BuiltIn="false" NiladicFunction="false"
+           IsComposable="false" ParameterTypeSemantics="AllowImplicitConversion"
+           Schema="dbo">
+   <Parameter Name="StudentID" Type="int" Mode="In" />
+ </Function>
+```
+
+Also consider this function import in the conceptual model:
+
+``` xml
+ <FunctionImport Name="GetStudentGrades" EntitySet="StudentGrades"
+                 ReturnType="Collection(SchoolModel.StudentGrade)">
+   <Parameter Name="StudentID" Mode="In" Type="Int32" />
+ </FunctionImport>
+```
+
+The following example shows a **FunctionImportMapping** element used to map the function and function import above to each other:
+
+``` xml
+ <FunctionImportMapping FunctionImportName="GetStudentGrades"
+                        FunctionName="SchoolModel.Store.GetStudentGrades" />
+```
+ 
+## InsertFunction Element (MSL)
+
+The **InsertFunction** element in mapping specification language (MSL) maps the insert function of an entity type or association in the conceptual model to a stored procedure in the underlying database. Stored procedures to which modification functions are mapped must be declared in the storage model. For more information, see Function Element (SSDL).
+
+> [!NOTE]
+> If you do not map all three of the insert, update, or delete operations of an entity type to stored procedures, the unmapped operations will fail if executed at runtime and an UpdateException is thrown.
+
+The **InsertFunction** element can be a child of the ModificationFunctionMapping element and applied to the EntityTypeMapping element or the AssociationSetMapping element.
+
+### InsertFunction Applied to EntityTypeMapping
+
+When applied to the EntityTypeMapping element, the **InsertFunction** element maps the insert function of an entity type in the conceptual model to a stored procedure.
+
+The **InsertFunction** element can have the following child elements when applied to an **EntityTypeMapping** element:
+
+-   AssociationEnd (zero or more)
+-   ComplexProperty (zero or more)
+-   ResultBinding (zero or one)
+-   ScalarProperty (zero or more)
+
+#### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **InsertFunction** element when applied to an **EntityTypeMapping** element.
+
+| Attribute Name            | Is Required | Value                                                                                                                                                    |
+|:--------------------------|:------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **FunctionName**          | Yes         | The namespace-qualified name of the stored procedure to which the insert function is mapped. The stored procedure must be declared in the storage model. |
+| **RowsAffectedParameter** | No          | The name of the output parameter that returns the number of affected rows.                                                                               |
+
+#### Example
+
+The following example is based on the School model and shows the **InsertFunction** element used to map insert function of the Person entity type to the **InsertPerson** stored procedure. The **InsertPerson** stored procedure is declared in the storage model.
+
+``` xml
+ <EntityTypeMapping TypeName="SchoolModel.Person">
+   <ModificationFunctionMapping>
+     <InsertFunction FunctionName="SchoolModel.Store.InsertPerson">
+       <ScalarProperty Name="EnrollmentDate"
+                       ParameterName="EnrollmentDate" />
+       <ScalarProperty Name="HireDate" ParameterName="HireDate" />
+       <ScalarProperty Name="FirstName" ParameterName="FirstName" />
+       <ScalarProperty Name="LastName" ParameterName="LastName" />
+       <ResultBinding Name="PersonID" ColumnName="NewPersonID" />
+     </InsertFunction>
+     <UpdateFunction FunctionName="SchoolModel.Store.UpdatePerson">
+       <ScalarProperty Name="EnrollmentDate"
+                       ParameterName="EnrollmentDate"
+                       Version="Current" />
+       <ScalarProperty Name="HireDate" ParameterName="HireDate"
+                       Version="Current" />
+       <ScalarProperty Name="FirstName" ParameterName="FirstName"
+                       Version="Current" />
+       <ScalarProperty Name="LastName" ParameterName="LastName"
+                       Version="Current" />
+       <ScalarProperty Name="PersonID" ParameterName="PersonID"
+                       Version="Current" />
+     </UpdateFunction>
+     <DeleteFunction FunctionName="SchoolModel.Store.DeletePerson">
+       <ScalarProperty Name="PersonID" ParameterName="PersonID" />
+     </DeleteFunction>
+   </ModificationFunctionMapping>
+ </EntityTypeMapping>
+```
+### InsertFunction Applied to AssociationSetMapping
+
+When applied to the AssociationSetMapping element, the **InsertFunction** element maps the insert function of an association in the conceptual model to a stored procedure.
+
+The **InsertFunction** element can have the following child elements when applied to the **AssociationSetMapping** element:
+
+-   EndProperty
+
+#### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **InsertFunction** element when it is applied to the **AssociationSetMapping** element.
+
+| Attribute Name            | Is Required | Value                                                                                                                                                    |
+|:--------------------------|:------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **FunctionName**          | Yes         | The namespace-qualified name of the stored procedure to which the insert function is mapped. The stored procedure must be declared in the storage model. |
+| **RowsAffectedParameter** | No          | The name of the output parameter that returns the number of rows affected.                                                                               |
+
+#### Example
+
+The following example is based on the School model and shows the **InsertFunction** element used to map insert function of the **CourseInstructor** association to the **InsertCourseInstructor** stored procedure. The **InsertCourseInstructor** stored procedure is declared in the storage model.
+
+``` xml
+ <AssociationSetMapping Name="CourseInstructor"
+                        TypeName="SchoolModel.CourseInstructor"
+                        StoreEntitySet="CourseInstructor">
+   <EndProperty Name="Person">
+     <ScalarProperty Name="PersonID" ColumnName="PersonID" />
+   </EndProperty>
+   <EndProperty Name="Course">
+     <ScalarProperty Name="CourseID" ColumnName="CourseID" />
+   </EndProperty>
+   <ModificationFunctionMapping>
+     <InsertFunction FunctionName="SchoolModel.Store.InsertCourseInstructor" >   
+       <EndProperty Name="Course">
+         <ScalarProperty Name="CourseID" ParameterName="courseId"/>
+       </EndProperty>
+       <EndProperty Name="Person">
+         <ScalarProperty Name="PersonID" ParameterName="instructorId"/>
+       </EndProperty>
+     </InsertFunction>
+     <DeleteFunction FunctionName="SchoolModel.Store.DeleteCourseInstructor">
+       <EndProperty Name="Course">
+         <ScalarProperty Name="CourseID" ParameterName="courseId"/>
+       </EndProperty>
+       <EndProperty Name="Person">
+         <ScalarProperty Name="PersonID" ParameterName="instructorId"/>
+       </EndProperty>
+     </DeleteFunction>
+   </ModificationFunctionMapping>
+ </AssociationSetMapping>
+```
+
+## Mapping Element (MSL)
+
+The **Mapping** element in mapping specification language (MSL) contains information for mapping objects that are defined in a conceptual model to a database (as described in a storage model). For more information, see CSDL Specification and SSDL Specification.
+
+The **Mapping** element is the root element for a mapping specification. The XML namespace for mapping specifications is `https://schemas.microsoft.com/ado/2009/11/mapping/cs`.
+
+The mapping element can have the following child elements (in the order listed):
+
+-   Alias (zero or more)
+-   EntityContainerMapping (exactly one)
+
+Names of conceptual and storage model types that are referenced in MSL must be qualified by their respective namespace names. For information about the conceptual model namespace name, see Schema Element (CSDL). For information about the storage model namespace name, see Schema Element (SSDL). Aliases for namespaces that are used in MSL can be defined with the Alias element.
+
+### Applicable Attributes
+
+The table below describes the attributes that can be applied to the **Mapping** element.
+
+| Attribute Name | Is Required | Value                                                 |
+|:---------------|:------------|:------------------------------------------------------|
+| **Space**      | Yes         | **C-S**. This is a fixed value and cannot be changed. |
+
+### Example
+
+The following example shows a **Mapping** element that is based on part of the School model. For more information about the School model, see Quickstart (Entity Framework):
+
+``` xml
+ <Mapping Space="C-S"
+          xmlns="https://schemas.microsoft.com/ado/2009/11/mapping/cs">
+   <Alias Key="c" Value="SchoolModel"/>
+   <EntityContainerMapping StorageEntityContainer="SchoolModelStoreContainer"
+                           CdmEntityContainer="SchoolModelEntities">
+     <EntitySetMapping Name="Courses">
+       <EntityTypeMapping TypeName="c.Course">
+         <MappingFragment StoreEntitySet="Course">
+           <ScalarProperty Name="CourseID" ColumnName="CourseID" />
+           <ScalarProperty Name="Title" ColumnName="Title" />
+           <ScalarProperty Name="Credits" ColumnName="Credits" />
+           <ScalarProperty Name="DepartmentID" ColumnName="DepartmentID" />
+         </MappingFragment>
+       </EntityTypeMapping>
+     </EntitySetMapping>
+     <EntitySetMapping Name="Departments">
+       <EntityTypeMapping TypeName="c.Department">
+         <MappingFragment StoreEntitySet="Department">
+           <ScalarProperty Name="DepartmentID" ColumnName="DepartmentID" />
+           <ScalarProperty Name="Name" ColumnName="Name" />
+           <ScalarProperty Name="Budget" ColumnName="Budget" />
+           <ScalarProperty Name="StartDate" ColumnName="StartDate" />
+           <ScalarProperty Name="Administrator" ColumnName="Administrator" />
+         </MappingFragment>
+       </EntityTypeMapping>
+     </EntitySetMapping>
+   </EntityContainerMapping>
+ </Mapping>
+```
+
+## MappingFragment Element (MSL)
+
+The **MappingFragment** element in mapping specification language (MSL) defines the mapping between the properties of a conceptual model entity type and a table or view in the database. For information about conceptual model entity types and underlying database tables or views, see EntityType Element (CSDL) and EntitySet Element (SSDL). The **MappingFragment** can be a child element of the EntityTypeMapping element or the EntitySetMapping element.
+
+The **MappingFragment** element can have the following child elements:
+
+-   ComplexType (zero or more)
+-   ScalarProperty (zero or more)
+-   Condition (zero or more)
+
+### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **MappingFragment** element.
+
+| Attribute Name          | Is Required | Value                                                                                                                                                                                                                         |
+|:------------------------|:------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **StoreEntitySet**      | Yes         | The name of the table or view that is being mapped.                                                                                                                                                                           |
+| **MakeColumnsDistinct** | No          | **True** or **False** depending on whether only distinct rows are returned. <br/> If this attribute is set to **True**, the **GenerateUpdateViews** attribute of the EntityContainerMapping element must be set to **False**. |
+
+### Example
+
+The following example shows a **MappingFragment** element as the child of an **EntityTypeMapping** element. In this example, properties of the **Course** type in the conceptual model are mapped to columns of the **Course** table in the database.
+
+``` xml
+ <EntitySetMapping Name="Courses">
+   <EntityTypeMapping TypeName="SchoolModel.Course">
+     <MappingFragment StoreEntitySet="Course">
+       <ScalarProperty Name="CourseID" ColumnName="CourseID" />
+       <ScalarProperty Name="Title" ColumnName="Title" />
+       <ScalarProperty Name="Credits" ColumnName="Credits" />
+       <ScalarProperty Name="DepartmentID" ColumnName="DepartmentID" />
+     </MappingFragment>
+   </EntityTypeMapping>
+ </EntitySetMapping>
+```
+
+### Example
+
+The following example shows a **MappingFragment** element as the child of an **EntitySetMapping** element. As in the example above, properties of the **Course** type in the conceptual model are mapped to columns of the **Course** table in the database.
+
+``` xml
+ <EntitySetMapping Name="Courses" TypeName="SchoolModel.Course">
+     <MappingFragment StoreEntitySet="Course">
+       <ScalarProperty Name="CourseID" ColumnName="CourseID" />
+       <ScalarProperty Name="Title" ColumnName="Title" />
+       <ScalarProperty Name="Credits" ColumnName="Credits" />
+       <ScalarProperty Name="DepartmentID" ColumnName="DepartmentID" />
+     </MappingFragment>
+ </EntitySetMapping>
+```
+
+## ModificationFunctionMapping Element (MSL)
+
+The **ModificationFunctionMapping** element in mapping specification language (MSL) maps the insert, update, and delete functions of a conceptual model entity type to stored procedures in the underlying database. The **ModificationFunctionMapping** element can also map the insert and delete functions for many-to-many associations in the conceptual model to stored procedures in the underlying database. Stored procedures to which modification functions are mapped must be declared in the storage model. For more information, see Function Element (SSDL).
+
+> [!NOTE]
+> If you do not map all three of the insert, update, or delete operations of an entity type to stored procedures, the unmapped operations will fail if executed at runtime and an UpdateException is thrown.
+
+
+> [!NOTE]
+> If the modification functions for one entity in an inheritance hierarchy are mapped to stored procedures, then modification functions for all types in the hierarchy must be mapped to stored procedures.
+
+The **ModificationFunctionMapping** element can be a child of the EntityTypeMapping element or the AssociationSetMapping element.
+
+The **ModificationFunctionMapping** element can have the following child elements:
+
+-   DeleteFunction (zero or one)
+-   InsertFunction (zero or one)
+-   UpdateFunction (zero or one)
+
+No attributes are applicable to the **ModificationFunctionMapping** element.
+
+### Example
+
+The following example shows the entity set mapping for the **People** entity set in the School model. In addition to the column mapping for the **Person** entity type, the mapping of the insert, update, and delete functions of the **Person** type are shown. The functions that are mapped to are declared in the storage model.
+
+``` xml
+ <EntitySetMapping Name="People">
+   <EntityTypeMapping TypeName="SchoolModel.Person">
+     <MappingFragment StoreEntitySet="Person">
+       <ScalarProperty Name="PersonID" ColumnName="PersonID" />
+       <ScalarProperty Name="LastName" ColumnName="LastName" />
+       <ScalarProperty Name="FirstName" ColumnName="FirstName" />
+       <ScalarProperty Name="HireDate" ColumnName="HireDate" />
+       <ScalarProperty Name="EnrollmentDate"
+                       ColumnName="EnrollmentDate" />
+     </MappingFragment>
+ </EntityTypeMapping>
+   <EntityTypeMapping TypeName="SchoolModel.Person">
+     <ModificationFunctionMapping>
+       <InsertFunction FunctionName="SchoolModel.Store.InsertPerson">
+         <ScalarProperty Name="EnrollmentDate"
+                         ParameterName="EnrollmentDate" />
+         <ScalarProperty Name="HireDate" ParameterName="HireDate" />
+         <ScalarProperty Name="FirstName" ParameterName="FirstName" />
+         <ScalarProperty Name="LastName" ParameterName="LastName" />
+         <ResultBinding Name="PersonID" ColumnName="NewPersonID" />
+       </InsertFunction>
+       <UpdateFunction FunctionName="SchoolModel.Store.UpdatePerson">
+         <ScalarProperty Name="EnrollmentDate"
+                         ParameterName="EnrollmentDate"
+                         Version="Current" />
+         <ScalarProperty Name="HireDate" ParameterName="HireDate"
+                         Version="Current" />
+         <ScalarProperty Name="FirstName" ParameterName="FirstName"
+                         Version="Current" />
+         <ScalarProperty Name="LastName" ParameterName="LastName"
+                         Version="Current" />
+         <ScalarProperty Name="PersonID" ParameterName="PersonID"
+                         Version="Current" />
+       </UpdateFunction>
+       <DeleteFunction FunctionName="SchoolModel.Store.DeletePerson">
+         <ScalarProperty Name="PersonID" ParameterName="PersonID" />
+       </DeleteFunction>
+     </ModificationFunctionMapping>
+   </EntityTypeMapping>
+ </EntitySetMapping>
+```
+
+### Example
+
+The following example shows the association set mapping for the **CourseInstructor** association set in the School model. In addition to the column mapping for the **CourseInstructor** association, the mapping of the insert and delete functions of the **CourseInstructor** association are shown. The functions that are mapped to are declared in the storage model.
+
+``` xml
+ <AssociationSetMapping Name="CourseInstructor"
+                        TypeName="SchoolModel.CourseInstructor"
+                        StoreEntitySet="CourseInstructor">
+   <EndProperty Name="Person">
+     <ScalarProperty Name="PersonID" ColumnName="PersonID" />
+   </EndProperty>
+   <EndProperty Name="Course">
+     <ScalarProperty Name="CourseID" ColumnName="CourseID" />
+   </EndProperty>
+   <ModificationFunctionMapping>
+     <InsertFunction FunctionName="SchoolModel.Store.InsertCourseInstructor" >   
+       <EndProperty Name="Course">
+         <ScalarProperty Name="CourseID" ParameterName="courseId"/>
+       </EndProperty>
+       <EndProperty Name="Person">
+         <ScalarProperty Name="PersonID" ParameterName="instructorId"/>
+       </EndProperty>
+     </InsertFunction>
+     <DeleteFunction FunctionName="SchoolModel.Store.DeleteCourseInstructor">
+       <EndProperty Name="Course">
+         <ScalarProperty Name="CourseID" ParameterName="courseId"/>
+       </EndProperty>
+       <EndProperty Name="Person">
+         <ScalarProperty Name="PersonID" ParameterName="instructorId"/>
+       </EndProperty>
+     </DeleteFunction>
+   </ModificationFunctionMapping>
+ </AssociationSetMapping>
+```
+ 
+
+ 
+
+## QueryView Element (MSL)
+
+The **QueryView** element in mapping specification language (MSL) defines a read-only mapping between an entity type or association in the conceptual model and a table in the underlying database. The mapping is defined with an Entity SQL query that is evaluated against the storage model, and you express the result set in terms of an entity or association in the conceptual model. Because query views are read-only, you cannot use standard update commands to update types that are defined by query views. You can make updates to these types by using modification functions. For more information, see How to: Map Modification Functions to Stored Procedures.
+
+> [!NOTE]
+> In the **QueryView** element, Entity SQL expressions that contain **GroupBy**, group aggregates, or navigation properties are not supported.
+
+ 
+
+The **QueryView** element can be a child of the EntitySetMapping element or the AssociationSetMapping element. In the former case, the query view defines a read-only mapping for an entity in the conceptual model. In the latter case, the query view defines a read-only mapping for an association in the conceptual model.
+
+> [!NOTE]
+> If the **AssociationSetMapping** element is for an association with a referential constraint, the **AssociationSetMapping** element is ignored. For more information, see ReferentialConstraint Element (CSDL).
+
+The **QueryView** element cannot have any child elements.
+
+### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **QueryView** element.
+
+| Attribute Name | Is Required | Value                                                                         |
+|:---------------|:------------|:------------------------------------------------------------------------------|
+| **TypeName**   | No          | The name of the conceptual model type that is being mapped by the query view. |
+
+### Example
+
+The following example shows the **QueryView** element as a child of the **EntitySetMapping** element and defines a query view mapping for the **Department** entity type in the School Model.
+
+``` xml
+ <EntitySetMapping Name="Departments" >
+   <QueryView>
+     SELECT VALUE SchoolModel.Department(d.DepartmentID,
+                                         d.Name,
+                                         d.Budget,
+                                         d.StartDate)
+     FROM SchoolModelStoreContainer.Department AS d
+     WHERE d.Budget > 150000
+   </QueryView>
+ </EntitySetMapping>
+```
+
+Because the query only returns a subset of the members of the **Department** type in the storage model, the **Department** type in the School model has been modified based on this mapping as follows:
+
+``` xml
+ <EntityType Name="Department">
+   <Key>
+     <PropertyRef Name="DepartmentID" />
+   </Key>
+   <Property Type="Int32" Name="DepartmentID" Nullable="false" />
+   <Property Type="String" Name="Name" Nullable="false"
+             MaxLength="50" FixedLength="false" Unicode="true" />
+   <Property Type="Decimal" Name="Budget" Nullable="false"
+             Precision="19" Scale="4" />
+   <Property Type="DateTime" Name="StartDate" Nullable="false" />
+   <NavigationProperty Name="Courses"
+                       Relationship="SchoolModel.FK_Course_Department"
+                       FromRole="Department" ToRole="Course" />
+ </EntityType>
+```
+
+### Example
+
+The next example shows the **QueryView** element as the child of an **AssociationSetMapping** element and defines a read-only mapping for the `FK_Course_Department` association in the School model.
+
+``` xml
+ <EntityContainerMapping StorageEntityContainer="SchoolModelStoreContainer"
+                         CdmEntityContainer="SchoolEntities">
+   <EntitySetMapping Name="Courses" >
+     <QueryView>
+       SELECT VALUE SchoolModel.Course(c.CourseID,
+                                       c.Title,
+                                       c.Credits)
+       FROM SchoolModelStoreContainer.Course AS c
+     </QueryView>
+   </EntitySetMapping>
+   <EntitySetMapping Name="Departments" >
+     <QueryView>
+       SELECT VALUE SchoolModel.Department(d.DepartmentID,
+                                           d.Name,
+                                           d.Budget,
+                                           d.StartDate)
+       FROM SchoolModelStoreContainer.Department AS d
+       WHERE d.Budget > 150000
+     </QueryView>
+   </EntitySetMapping>
+   <AssociationSetMapping Name="FK_Course_Department" >
+     <QueryView>
+       SELECT VALUE SchoolModel.FK_Course_Department(
+         CREATEREF(SchoolEntities.Departments, row(c.DepartmentID), SchoolModel.Department),
+         CREATEREF(SchoolEntities.Courses, row(c.CourseID)) )
+       FROM SchoolModelStoreContainer.Course AS c
+     </QueryView>
+   </AssociationSetMapping>
+ </EntityContainerMapping>
+```
+ 
+### Comments
+
+You can define query views to enable the following scenarios:
+
+-   Define an entity in the conceptual model that doesn't include all the properties of the entity in the storage model. This includes properties that do not have default values and do not support **null** values.
+-   Map computed columns in the storage model to properties of entity types in the conceptual model.
+-   Define a mapping where conditions used to partition entities in the conceptual model are not based on equality. When you specify a conditional mapping using the **Condition** element, the supplied condition must equal the specified value. For more information, see Condition Element (MSL).
+-   Map the same column in the storage model to multiple types in the conceptual model.
+-   Map multiple types to the same table.
+-   Define associations in the conceptual model that are not based on foreign keys in the relational schema.
+-   Use custom business logic to set the value of properties in the conceptual model. For example, you could map the string value "T" in the data source to a value of **true**, a Boolean, in the conceptual model.
+-   Define conditional filters for query results.
+-   Enforce fewer restrictions on data in the conceptual model than in the storage model. For example, you could make a property in the conceptual model nullable even if the column to which it is mapped does not support **null**values.
+
+The following considerations apply when you define query views for entities:
+
+-   Query views are read-only. You can only make updates to entities by using modification functions.
+-   When you define an entity type by a query view, you must also define all related entities by query views.
+-   When you map a many-to-many association to an entity in the storage model that represents a link table in the relational schema, you must define a **QueryView** element in the **AssociationSetMapping** element for this link table.
+-   Query views must be defined for all types in a type hierarchy. You can do this in the following ways:
+-   -   With a single **QueryView** element that specifies a single Entity SQL query that returns a union of all of the entity types in the hierarchy.
+    -   With a single **QueryView** element that specifies a single Entity SQL query that uses the CASE operator to return a specific entity type in the hierarchy based on a specific condition.
+    -   With an additional **QueryView** element for a specific type in the hierarchy. In this case, use the **TypeName** attribute of the **QueryView** element to specify the entity type for each view.
+-   When a query view is defined, you cannot specify the **StorageSetName** attribute on the **EntitySetMapping** element.
+-   When a query view is defined, the **EntitySetMapping**element cannot also contain **Property** mappings.
+
+## ResultBinding Element (MSL)
+
+The **ResultBinding** element in mapping specification language (MSL) maps column values that are returned by stored procedures to entity properties in the conceptual model when entity type modification functions are mapped to stored procedures in the underlying database. For example, when the value of an identity column is returned by an insert stored procedure, the **ResultBinding** element maps the returned value to an entity type property in the conceptual model.
+
+The **ResultBinding** element can be child of the InsertFunction element or the UpdateFunction element.
+
+The **ResultBinding** element cannot have any child elements.
+
+### Applicable Attributes
+
+The following table describes the attributes that are applicable to the **ResultBinding** element:
+
+| Attribute Name | Is Required | Value                                                                         |
+|:---------------|:------------|:------------------------------------------------------------------------------|
+| **Name**       | Yes         | The name of the entity property in the conceptual model that is being mapped. |
+| **ColumnName** | Yes         | The name of the column being mapped.                                          |
+
+### Example
+
+The following example is based on the School model and shows an **InsertFunction** element used to map the insert function of the **Person** entity type to the **InsertPerson** stored procedure. (The **InsertPerson** stored procedure is shown below and is declared in the storage model.) A **ResultBinding** element is used to map a column value that is returned by the stored procedure (**NewPersonID**) to an entity type property (**PersonID**).
+
+``` xml
+ <EntityTypeMapping TypeName="SchoolModel.Person">
+   <ModificationFunctionMapping>
+     <InsertFunction FunctionName="SchoolModel.Store.InsertPerson">
+       <ScalarProperty Name="EnrollmentDate"
+                       ParameterName="EnrollmentDate" />
+       <ScalarProperty Name="HireDate" ParameterName="HireDate" />
+       <ScalarProperty Name="FirstName" ParameterName="FirstName" />
+       <ScalarProperty Name="LastName" ParameterName="LastName" />
+       <ResultBinding Name="PersonID" ColumnName="NewPersonID" />
+     </InsertFunction>
+     <UpdateFunction FunctionName="SchoolModel.Store.UpdatePerson">
+       <ScalarProperty Name="EnrollmentDate"
+                       ParameterName="EnrollmentDate"
+                       Version="Current" />
+       <ScalarProperty Name="HireDate" ParameterName="HireDate"
+                       Version="Current" />
+       <ScalarProperty Name="FirstName" ParameterName="FirstName"
+                       Version="Current" />
+       <ScalarProperty Name="LastName" ParameterName="LastName"
+                       Version="Current" />
+       <ScalarProperty Name="PersonID" ParameterName="PersonID"
+                       Version="Current" />
+     </UpdateFunction>
+     <DeleteFunction FunctionName="SchoolModel.Store.DeletePerson">
+       <ScalarProperty Name="PersonID" ParameterName="PersonID" />
+     </DeleteFunction>
+   </ModificationFunctionMapping>
+ </EntityTypeMapping>
+```
+
+The following Transact-SQL describes the **InsertPerson** stored procedure:
+
+``` SQL
+ CREATE PROCEDURE [dbo].[InsertPerson]
+                                @LastName nvarchar(50),
+                                @FirstName nvarchar(50),
+                                @HireDate datetime,
+                                @EnrollmentDate datetime
+                                AS
+                                INSERT INTO dbo.Person (LastName,
+                                                                             FirstName,
+                                                                             HireDate,
+                                                                             EnrollmentDate)
+                                VALUES (@LastName,
+                                               @FirstName,
+                                               @HireDate,
+                                               @EnrollmentDate);
+                                SELECT SCOPE_IDENTITY() as NewPersonID;
+```
+
+## ResultMapping Element (MSL)
+
+The **ResultMapping** element in mapping specification language (MSL) defines the mapping between a function import in the conceptual model and a stored procedure in the underlying database when the following are true:
+
+-   The function import returns a conceptual model entity type or complex type.
+-   The names of the columns returned by the stored procedure do not exactly match the names of the properties on the entity type or complex type.
+
+By default, the mapping between the columns returned by a stored procedure and an entity type or complex type is based on column and property names. If column names do not exactly match property names, you must use the **ResultMapping** element to define the mapping. For an example of the default mapping, see FunctionImportMapping Element (MSL).
+
+The **ResultMapping** element is a child element of the FunctionImportMapping element.
+
+The **ResultMapping** element can have the following child elements:
+
+-   EntityTypeMapping (zero or more)
+-   ComplexTypeMapping
+
+No attributes are applicable to the **ResultMapping** Element.
+
+### Example
+
+Consider the following stored procedure:
+
+``` SQL
+ CREATE PROCEDURE [dbo].[GetGrades]
+             @student_Id int
+             AS
+             SELECT     EnrollmentID as enroll_id,
+                                                                             Grade as grade,
+                                                                             CourseID as course_id,
+                                                                             StudentID as student_id
+                                               FROM dbo.StudentGrade
+             WHERE StudentID = @student_Id
+```
+
+Also consider the following conceptual model entity type:
+
+``` xml
+ <EntityType Name="StudentGrade">
+   <Key>
+     <PropertyRef Name="EnrollmentID" />
+   </Key>
+   <Property Name="EnrollmentID" Type="Int32" Nullable="false"
+             annotation:StoreGeneratedPattern="Identity" />
+   <Property Name="CourseID" Type="Int32" Nullable="false" />
+   <Property Name="StudentID" Type="Int32" Nullable="false" />
+   <Property Name="Grade" Type="Decimal" Precision="3" Scale="2" />
+ </EntityType>
+```
+
+In order to create a function import that returns instances of the previous entity type, the mapping between the columns returned by the stored procedure and the entity type must be defined in a **ResultMapping** element:
+
+``` xml
+ <FunctionImportMapping FunctionImportName="GetGrades"
+                        FunctionName="SchoolModel.Store.GetGrades" >
+   <ResultMapping>
+     <EntityTypeMapping TypeName="SchoolModel.StudentGrade">
+       <ScalarProperty Name="EnrollmentID" ColumnName="enroll_id"/>
+       <ScalarProperty Name="CourseID" ColumnName="course_id"/>
+       <ScalarProperty Name="StudentID" ColumnName="student_id"/>
+       <ScalarProperty Name="Grade" ColumnName="grade"/>
+     </EntityTypeMapping>
+   </ResultMapping>
+ </FunctionImportMapping>
+```
+
+## ScalarProperty Element (MSL)
+
+The **ScalarProperty** element in mapping specification language (MSL) maps a property on a conceptual model entity type, complex type, or association to a table column or stored procedure parameter in the underlying database.
+
+> [!NOTE]
+> Stored procedures to which modification functions are mapped must be declared in the storage model. For more information, see Function Element (SSDL).
+
+The **ScalarProperty** element can be a child of the following elements:
+
+-   MappingFragment
+-   InsertFunction
+-   UpdateFunction
+-   DeleteFunction
+-   EndProperty
+-   ComplexProperty
+-   ResultMapping
+
+As a child of the **MappingFragment**, **ComplexProperty**, or **EndProperty** element, the **ScalarProperty** element maps a property in the conceptual model to a column in the database. As a child of the **InsertFunction**, **UpdateFunction**, or **DeleteFunction** element, the **ScalarProperty** element maps a property in the conceptual model to a stored procedure parameter.
+
+The **ScalarProperty** element cannot have any child elements.
+
+### Applicable Attributes
+
+The attributes that apply to the **ScalarProperty** element differ depending on the role of the element.
+
+The following table describes the attributes that are applicable when the **ScalarProperty** element is used to map a conceptual model property to a column in the database:
+
+| Attribute Name | Is Required | Value                                                           |
+|:---------------|:------------|:----------------------------------------------------------------|
+| **Name**       | Yes         | The name of the conceptual model property that is being mapped. |
+| **ColumnName** | Yes         | The name of the table column that is being mapped.              |
+
+The following table describes the attributes that are applicable to the **ScalarProperty** element when it is used to map a conceptual model property to a stored procedure parameter:
+
+| Attribute Name    | Is Required | Value                                                                                                                                           |
+|:------------------|:------------|:------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Name**          | Yes         | The name of the conceptual model property that is being mapped.                                                                                 |
+| **ParameterName** | Yes         | The name of the parameter that is being mapped.                                                                                                 |
+| **Version**       | No          | **Current** or **Original** depending on whether the current value or the original value of the property should be used for concurrency checks. |
+
+### Example
+
+The following example shows the **ScalarProperty** element used in two ways:
+
+-   To map the properties of the **Person** entity type to the columns of the **Person**table.
+-   To map the properties of the **Person** entity type to the parameters of the **UpdatePerson** stored procedure. The stored procedures are declared in the storage model.
+
+``` xml
+ <EntitySetMapping Name="People">
+   <EntityTypeMapping TypeName="SchoolModel.Person">
+     <MappingFragment StoreEntitySet="Person">
+       <ScalarProperty Name="PersonID" ColumnName="PersonID" />
+       <ScalarProperty Name="LastName" ColumnName="LastName" />
+       <ScalarProperty Name="FirstName" ColumnName="FirstName" />
+       <ScalarProperty Name="HireDate" ColumnName="HireDate" />
+       <ScalarProperty Name="EnrollmentDate"
+                       ColumnName="EnrollmentDate" />
+     </MappingFragment>
+ </EntityTypeMapping>
+   <EntityTypeMapping TypeName="SchoolModel.Person">
+     <ModificationFunctionMapping>
+       <InsertFunction FunctionName="SchoolModel.Store.InsertPerson">
+         <ScalarProperty Name="EnrollmentDate"
+                         ParameterName="EnrollmentDate" />
+         <ScalarProperty Name="HireDate" ParameterName="HireDate" />
+         <ScalarProperty Name="FirstName" ParameterName="FirstName" />
+         <ScalarProperty Name="LastName" ParameterName="LastName" />
+         <ResultBinding Name="PersonID" ColumnName="NewPersonID" />
+       </InsertFunction>
+       <UpdateFunction FunctionName="SchoolModel.Store.UpdatePerson">
+         <ScalarProperty Name="EnrollmentDate"
+                         ParameterName="EnrollmentDate"
+                         Version="Current" />
+         <ScalarProperty Name="HireDate" ParameterName="HireDate"
+                         Version="Current" />
+         <ScalarProperty Name="FirstName" ParameterName="FirstName"
+                         Version="Current" />
+         <ScalarProperty Name="LastName" ParameterName="LastName"
+                         Version="Current" />
+         <ScalarProperty Name="PersonID" ParameterName="PersonID"
+                         Version="Current" />
+       </UpdateFunction>
+       <DeleteFunction FunctionName="SchoolModel.Store.DeletePerson">
+         <ScalarProperty Name="PersonID" ParameterName="PersonID" />
+       </DeleteFunction>
+     </ModificationFunctionMapping>
+   </EntityTypeMapping>
+ </EntitySetMapping>
+```
+
+### Example
+
+The next example shows the **ScalarProperty** element used to map the insert and delete functions of a conceptual model association to stored procedures in the database. The stored procedures are declared in the storage model.
+
+``` xml
+ <AssociationSetMapping Name="CourseInstructor"
+                        TypeName="SchoolModel.CourseInstructor"
+                        StoreEntitySet="CourseInstructor">
+   <EndProperty Name="Person">
+     <ScalarProperty Name="PersonID" ColumnName="PersonID" />
+   </EndProperty>
+   <EndProperty Name="Course">
+     <ScalarProperty Name="CourseID" ColumnName="CourseID" />
+   </EndProperty>
+   <ModificationFunctionMapping>
+     <InsertFunction FunctionName="SchoolModel.Store.InsertCourseInstructor" >   
+       <EndProperty Name="Course">
+         <ScalarProperty Name="CourseID" ParameterName="courseId"/>
+       </EndProperty>
+       <EndProperty Name="Person">
+         <ScalarProperty Name="PersonID" ParameterName="instructorId"/>
+       </EndProperty>
+     </InsertFunction>
+     <DeleteFunction FunctionName="SchoolModel.Store.DeleteCourseInstructor">
+       <EndProperty Name="Course">
+         <ScalarProperty Name="CourseID" ParameterName="courseId"/>
+       </EndProperty>
+       <EndProperty Name="Person">
+         <ScalarProperty Name="PersonID" ParameterName="instructorId"/>
+       </EndProperty>
+     </DeleteFunction>
+   </ModificationFunctionMapping>
+ </AssociationSetMapping>
+```
+
+## UpdateFunction Element (MSL)
+
+The **UpdateFunction** element in mapping specification language (MSL) maps the update function of an entity type in the conceptual model to a stored procedure in the underlying database. Stored procedures to which modification functions are mapped must be declared in the storage model. For more information, see Function Element (SSDL).
+
+> [!NOTE]
+>  If you do not map all three of the insert, update, or delete operations of an entity type to stored procedures, the unmapped operations will fail if executed at runtime and an UpdateException is thrown.
+
+The **UpdateFunction** element can be a child of the ModificationFunctionMapping element and applied to the EntityTypeMapping element.
+
+The **UpdateFunction** element can have the following child elements:
+
+-   AssociationEnd (zero or more)
+-   ComplexProperty (zero or more)
+-   ResultBinding (zero or one)
+-   ScalarProperty (zero or more)
+
+### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **UpdateFunction** element.
+
+| Attribute Name            | Is Required | Value                                                                                                                                                    |
+|:--------------------------|:------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **FunctionName**          | Yes         | The namespace-qualified name of the stored procedure to which the update function is mapped. The stored procedure must be declared in the storage model. |
+| **RowsAffectedParameter** | No          | The name of the output parameter that returns the number of rows affected.                                                                               |
+
+### Example
+
+The following example is based on the School model and shows the **UpdateFunction** element used to map update function of the **Person** entity type to the **UpdatePerson** stored procedure. The **UpdatePerson** stored procedure is declared in the storage model.
+
+``` xml
+ <EntityTypeMapping TypeName="SchoolModel.Person">
+   <ModificationFunctionMapping>
+     <InsertFunction FunctionName="SchoolModel.Store.InsertPerson">
+       <ScalarProperty Name="EnrollmentDate"
+                       ParameterName="EnrollmentDate" />
+       <ScalarProperty Name="HireDate" ParameterName="HireDate" />
+       <ScalarProperty Name="FirstName" ParameterName="FirstName" />
+       <ScalarProperty Name="LastName" ParameterName="LastName" />
+       <ResultBinding Name="PersonID" ColumnName="NewPersonID" />
+     </InsertFunction>
+     <UpdateFunction FunctionName="SchoolModel.Store.UpdatePerson">
+       <ScalarProperty Name="EnrollmentDate"
+                       ParameterName="EnrollmentDate"
+                       Version="Current" />
+       <ScalarProperty Name="HireDate" ParameterName="HireDate"
+                       Version="Current" />
+       <ScalarProperty Name="FirstName" ParameterName="FirstName"
+                       Version="Current" />
+       <ScalarProperty Name="LastName" ParameterName="LastName"
+                       Version="Current" />
+       <ScalarProperty Name="PersonID" ParameterName="PersonID"
+                       Version="Current" />
+     </UpdateFunction>
+     <DeleteFunction FunctionName="SchoolModel.Store.DeletePerson">
+       <ScalarProperty Name="PersonID" ParameterName="PersonID" />
+     </DeleteFunction>
+   </ModificationFunctionMapping>
+ </EntityTypeMapping>
+```
diff --git a/entity-framework/ef6/modeling/designer/advanced/edmx/ssdl-spec.md b/entity-framework/ef6/modeling/designer/advanced/edmx/ssdl-spec.md
new file mode 100644
index 0000000000..ed6d4ec8b6
--- /dev/null
+++ b/entity-framework/ef6/modeling/designer/advanced/edmx/ssdl-spec.md
@@ -0,0 +1,1077 @@
+---
+title: SSDL Specification - EF6
+description: SSDL Specification in Entity Framework 6
+author: SamMonoRT
+ms.date: 08/23/2024
+uid: ef6/modeling/designer/advanced/edmx/ssdl-spec
+---
+# SSDL Specification
+
+> [!NOTE]
+> SSDL v1 is unsupported, please update to V3
+
+Store schema definition language (SSDL) is an XML-based language that describes the storage model of an Entity Framework application.
+
+In an Entity Framework application, storage model metadata is loaded from a .ssdl file (written in SSDL) into an instance of the System.Data.Metadata.Edm.StoreItemCollection and is accessible by using methods in the System.Data.Metadata.Edm.MetadataWorkspace class. Entity Framework uses storage model metadata to translate queries against the conceptual model to store-specific commands.
+
+The Entity Framework Designer (EF Designer) stores storage model information in an .edmx file at design time. At build time the Entity Designer uses information in an .edmx file to create the .ssdl file that is needed by Entity Framework at runtime.
+
+Versions of SSDL are differentiated by XML namespaces.
+
+| SSDL Version | XML Namespace                                     |
+|:-------------|:--------------------------------------------------|
+| SSDL v1      | `https://schemas.microsoft.com/ado/2006/04/edm/ssdl` |
+| SSDL v2      | `https://schemas.microsoft.com/ado/2009/02/edm/ssdl` |
+| SSDL v3      | `https://schemas.microsoft.com/ado/2009/11/edm/ssdl` |
+
+## Association Element (SSDL)
+
+An **Association** element in store schema definition language (SSDL) specifies table columns that participate in a foreign key constraint in the underlying database. Two required child End elements specify tables at the ends of the association and the multiplicity at each end. An optional ReferentialConstraint element specifies the principal and dependent ends of the association as well as the participating columns. If no **ReferentialConstraint** element is present, an AssociationSetMapping element must be used to specify the column mappings for the association.
+
+The **Association** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one)
+-   End (exactly two)
+-   ReferentialConstraint (zero or one)
+-   Annotation elements (zero or more)
+
+### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **Association** element.
+
+| Attribute Name | Is Required | Value                                                                            |
+|:---------------|:------------|:---------------------------------------------------------------------------------|
+| **Name**       | Yes         | The name of the corresponding foreign key constraint in the underlying database. |
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **Association** element. However, custom attributes may not belong to any XML namespace that is reserved for SSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+### Example
+
+The following example shows an **Association** element that uses a **ReferentialConstraint** element to specify the columns that participate in the **FK\_CustomerOrders** foreign key constraint:
+
+``` xml
+ <Association Name="FK_CustomerOrders">
+   <End Role="Customers"
+        Type="ExampleModel.Store.Customers" Multiplicity="1">
+     <OnDelete Action="Cascade" />
+   </End>
+   <End Role="Orders"
+        Type="ExampleModel.Store.Orders" Multiplicity="*" />
+   <ReferentialConstraint>
+     <Principal Role="Customers">
+       <PropertyRef Name="CustomerId" />
+     </Principal>
+     <Dependent Role="Orders">
+       <PropertyRef Name="CustomerId" />
+     </Dependent>
+   </ReferentialConstraint>
+ </Association>
+```
+
+## AssociationSet Element (SSDL)
+
+The **AssociationSet** element in store schema definition language (SSDL) represents a foreign key constraint between two tables in the underlying database. The table columns that participate in the foreign key constraint are specified in an Association element. The **Association** element that corresponds to a given **AssociationSet** element is specified in the **Association** attribute of the **AssociationSet** element.
+
+SSDL association sets are mapped to CSDL association sets by an AssociationSetMapping element. However, if the CSDL association for a given CSDL association set is defined by using a ReferentialConstraint element , no corresponding **AssociationSetMapping** element is necessary. In this case, if an **AssociationSetMapping** element is present, the mappings it defines will be overridden by the **ReferentialConstraint** element.
+
+The **AssociationSet** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one)
+-   End (zero or two)
+-   Annotation elements (zero or more)
+
+### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **AssociationSet** element.
+
+| Attribute Name  | Is Required | Value                                                                                                |
+|:----------------|:------------|:-----------------------------------------------------------------------------------------------------|
+| **Name**        | Yes         | The name of the foreign key constraint that the association set represents.                          |
+| **Association** | Yes         | The name of the association that defines the columns that participate in the foreign key constraint. |
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **AssociationSet** element. However, custom attributes may not belong to any XML namespace that is reserved for SSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+### Example
+
+The following example shows an **AssociationSet** element that represents the `FK_CustomerOrders` foreign key constraint in the underlying database:
+
+``` xml
+ <AssociationSet Name="FK_CustomerOrders"
+                 Association="ExampleModel.Store.FK_CustomerOrders">
+   <End Role="Customers" EntitySet="Customers" />
+   <End Role="Orders" EntitySet="Orders" />
+ </AssociationSet>
+```
+
+## CollectionType Element (SSDL)
+
+The **CollectionType** element in store schema definition language (SSDL) specifies that a function’s return type is a collection. The **CollectionType** element is a child of the ReturnType element. The type of collection is specified by using the RowType child element:
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **CollectionType** element. However, custom attributes may not belong to any XML namespace that is reserved for SSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+### Example
+
+The following example shows a function that uses a **CollectionType** element to specify that the function returns a collection of rows.
+
+``` xml
+   <Function Name="GetProducts" IsComposable="true" Schema="dbo">
+     <ReturnType>
+       <CollectionType>
+         <RowType>
+           <Property Name="ProductID" Type="int" Nullable="false" />
+           <Property Name="CategoryID" Type="bigint" Nullable="false" />
+           <Property Name="ProductName" Type="nvarchar" MaxLength="40" Nullable="false" />
+           <Property Name="UnitPrice" Type="money" />
+           <Property Name="Discontinued" Type="bit" />
+         </RowType>
+       </CollectionType>
+     </ReturnType>
+   </Function>
+```
+
+## CommandText Element (SSDL)
+
+The **CommandText** element in store schema definition language (SSDL) is a child of the Function element that allows you to define a SQL statement that is executed at the database. The **CommandText** element allows you to add functionality that is similar to a stored procedure in the database, but you define the **CommandText** element in the storage model.
+
+The **CommandText** element cannot have child elements. The body of the **CommandText** element must be a valid SQL statement for the underlying database.
+
+No attributes are applicable to the **CommandText** element.
+
+### Example
+
+The following example shows a **Function** element with a child **CommandText** element. Expose the **UpdateProductInOrder** function as a method on the ObjectContext by importing it into the conceptual model.  
+
+``` xml
+ <Function Name="UpdateProductInOrder" IsComposable="false">
+   <CommandText>
+     UPDATE Orders
+     SET ProductId = @productId
+     WHERE OrderId = @orderId;
+   </CommandText>
+   <Parameter Name="productId"
+              Mode="In"
+              Type="int"/>
+   <Parameter Name="orderId"
+              Mode="In"
+              Type="int"/>
+ </Function>
+```
+
+## DefiningQuery Element (SSDL)
+
+The **DefiningQuery** element in store schema definition language (SSDL) allows you to execute a SQL statement directly in the underlying database. The **DefiningQuery** element is commonly used like a database view, but the view is defined in the storage model instead of the database. The view defined in a **DefiningQuery** element can be mapped to an entity type in the conceptual model through an EntitySetMapping element. These mappings are read-only.  
+
+The following SSDL syntax shows the declaration of an **EntitySet** followed by the **DefiningQuery** element that contains a query used to retrieve the view.
+
+``` xml
+ <Schema>
+     <EntitySet Name="Tables" EntityType="Self.STable">
+         <DefiningQuery>
+           SELECT  TABLE_CATALOG,
+                   'test' as TABLE_SCHEMA,
+                   TABLE_NAME
+           FROM    INFORMATION_SCHEMA.TABLES
+         </DefiningQuery>
+     </EntitySet>
+ </Schema>
+```
+
+You can use stored procedures in the Entity Framework to enable read-write scenarios over views. You can use either a data source view or an Entity SQL view as the base table for retrieving data and for change processing by stored procedures.
+
+You can use the **DefiningQuery** element to target Microsoft SQL Server Compact 3.5. Though SQL Server Compact 3.5 does not support stored procedures, you can implement similar functionality with the **DefiningQuery** element. Another place where it can be useful is in creating stored procedures to overcome a mismatch between the data types used in the programming language and those of the data source. You could write a **DefiningQuery** that takes a certain set of parameters and then calls a stored procedure with a different set of parameters, for example, a stored procedure that deletes data.
+
+## Dependent Element (SSDL)
+
+The **Dependent** element in store schema definition language (SSDL) is a child element to the ReferentialConstraint element that defines the dependent end of a foreign key constraint (also called a referential constraint). The **Dependent** element specifies the column (or columns) in a table that reference a primary key column (or columns). **PropertyRef** elements specify which columns are referenced. The Principal element specifies the primary key columns that are referenced by columns that are specified in the **Dependent** element.
+
+The **Dependent** element can have the following child elements (in the order listed):
+
+-   PropertyRef (one or more)
+-   Annotation elements (zero or more)
+
+### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **Dependent** element.
+
+| Attribute Name | Is Required | Value                                                                                                                                                       |
+|:---------------|:------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Role**       | Yes         | The same value as the **Role** attribute (if used) of the corresponding End element; otherwise, the name of the table that contains the referencing column. |
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **Dependent** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+### Example
+
+The following example shows an Association element that uses a **ReferentialConstraint** element to specify the columns that participate in the **FK\_CustomerOrders** foreign key constraint. The **Dependent** element specifies the **CustomerId** column of the **Order** table as the dependent end of the constraint.
+
+``` xml
+ <Association Name="FK_CustomerOrders">
+   <End Role="Customers"
+        Type="ExampleModel.Store.Customers" Multiplicity="1">
+     <OnDelete Action="Cascade" />
+   </End>
+   <End Role="Orders"
+        Type="ExampleModel.Store.Orders" Multiplicity="*" />
+   <ReferentialConstraint>
+     <Principal Role="Customers">
+       <PropertyRef Name="CustomerId" />
+     </Principal>
+     <Dependent Role="Orders">
+       <PropertyRef Name="CustomerId" />
+     </Dependent>
+   </ReferentialConstraint>
+ </Association>
+```
+
+## Documentation Element (SSDL)
+
+The **Documentation** element in store schema definition language (SSDL) can be used to provide information about an object that is defined in a parent element.
+
+The **Documentation** element can have the following child elements (in the order listed):
+
+-   **Summary**: A brief description of the parent element. (zero or one element)
+-   **LongDescription**: An extensive description of the parent element. (zero or one element)
+
+### Applicable Attributes
+
+Any number of annotation attributes (custom XML attributes) may be applied to the **Documentation** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+### Example
+
+The following example shows the **Documentation** element as a child element of an EntityType element.
+
+``` xml
+ <EntityType Name="Customers">
+   <Documentation>
+     <Summary>Summary here.</Summary>
+     <LongDescription>Long description here.</LongDescription>
+   </Documentation>
+   <Key>
+     <PropertyRef Name="CustomerId" />
+   </Key>
+   <Property Name="CustomerId" Type="int" Nullable="false" />
+   <Property Name="Name" Type="nvarchar(max)" Nullable="false" />
+ </EntityType>
+```
+
+## End Element (SSDL)
+
+The **End** element in store schema definition language (SSDL) specifies the table and number of rows at one end of a foreign key constraint in the underlying database. The **End** element can be a child of the Association element or the AssociationSet element. In each case, the possible child elements and applicable attributes are different.
+
+### End Element as a Child of the Association Element
+
+An **End** element (as a child of the **Association** element) specifies the table and number of rows at the end of a foreign key constraint with the **Type** and **Multiplicity** attributes respectively. Ends of a foreign key constraint are defined as part of an SSDL association; an SSDL association must have exactly two ends.
+
+An **End** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one element)
+-   OnDelete (zero or one element)
+-   Annotation elements (zero or more elements)
+
+#### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **End** element when it is the child of an **Association** element.
+
+| Attribute Name   | Is Required | Value                                                                                                                                                                                                                                                                                                                                                                                      |
+|:-----------------|:------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Type**         | Yes         | The fully qualified name of the SSDL entity set that is at the end of the foreign key constraint.                                                                                                                                                                                                                                                                                          |
+| **Role**         | No          | The value of the **Role** attribute in either the Principal or Dependent element of the corresponding ReferentialConstraint element (if used).                                                                                                                                                                                                                                             |
+| **Multiplicity** | Yes         | **1**, **0..1**, or **\*** depending on the number of rows that can be at the end of the foreign key constraint. <br/> **1** indicates that exactly one row exists at the foreign key constraint end. <br/> **0..1** indicates that zero or one row exists at the foreign key constraint end. <br/> **\*** indicates that zero, one, or more rows exist at the foreign key constraint end. |
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **End** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+#### Example
+
+The following example shows an **Association** element that defines the **FK\_CustomerOrders** foreign key constraint. The **Multiplicity** values specified on each **End** element indicate that many rows in the **Orders** table can be associated with a row in the **Customers** table, but only one row in the **Customers** table can be associated with a row in the **Orders** table. Additionally, the **OnDelete** element indicates that all rows in the **Orders** table that reference a particular row in the **Customers** table will be deleted if the row in the **Customers** table is deleted.
+
+``` xml
+ <Association Name="FK_CustomerOrders">
+   <End Role="Customers"
+        Type="ExampleModel.Store.Customers" Multiplicity="1">
+     <OnDelete Action="Cascade" />
+   </End>
+   <End Role="Orders"
+        Type="ExampleModel.Store.Orders" Multiplicity="*" />
+   <ReferentialConstraint>
+     <Principal Role="Customers">
+       <PropertyRef Name="CustomerId" />
+     </Principal>
+     <Dependent Role="Orders">
+       <PropertyRef Name="CustomerId" />
+     </Dependent>
+   </ReferentialConstraint>
+ </Association>
+```
+
+### End Element as a Child of the AssociationSet Element
+
+The **End** element (as a child of the **AssociationSet** element) specifies a table at one end of a foreign key constraint in the underlying database.
+
+An **End** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one)
+-   Annotation elements (zero or more)
+
+#### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **End** element when it is the child of an **AssociationSet** element.
+
+| Attribute Name | Is Required | Value                                                                                                                  |
+|:---------------|:------------|:-----------------------------------------------------------------------------------------------------------------------|
+| **EntitySet**  | Yes         | The name of the SSDL entity set that is at the end of the foreign key constraint.                                      |
+| **Role**       | No          | The value of one of the **Role** attributes specified on one **End** element of the corresponding Association element. |
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **End** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+#### Example
+
+The following example shows an **EntityContainer** element with an **AssociationSet** element with two **End** elements:
+
+``` xml
+ <EntityContainer Name="ExampleModelStoreContainer">
+   <EntitySet Name="Customers"
+              EntityType="ExampleModel.Store.Customers"
+              Schema="dbo" />
+   <EntitySet Name="Orders"
+              EntityType="ExampleModel.Store.Orders"
+              Schema="dbo" />
+   <AssociationSet Name="FK_CustomerOrders"
+                   Association="ExampleModel.Store.FK_CustomerOrders">
+     <End Role="Customers" EntitySet="Customers" />
+     <End Role="Orders" EntitySet="Orders" />
+   </AssociationSet>
+ </EntityContainer>
+```
+
+## EntityContainer Element (SSDL)
+
+An **EntityContainer** element in store schema definition language (SSDL) describes the structure of the underlying data source in an Entity Framework application: SSDL entity sets (defined in EntitySet elements) represent tables in a database, SSDL entity types (defined in EntityType elements) represent rows in a table, and association sets (defined in AssociationSet elements) represent foreign key constraints in a database. A storage model entity container maps to a conceptual model entity container through the EntityContainerMapping element.
+
+An **EntityContainer** element can have zero or one Documentation elements. If a **Documentation** element is present, it must precede all other child elements.
+
+An **EntityContainer** element can have zero or more of the following child elements (in the order listed):
+
+-   EntitySet
+-   AssociationSet
+-   Annotation elements
+
+### Applicable Attributes
+
+The table below describes the attributes that can be applied to the **EntityContainer** element.
+
+| Attribute Name | Is Required | Value                                                                   |
+|:---------------|:------------|:------------------------------------------------------------------------|
+| **Name**       | Yes         | The name of the entity container. This name cannot contain periods (.). |
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **EntityContainer** element. However, custom attributes may not belong to any XML namespace that is reserved for SSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+### Example
+
+The following example shows an **EntityContainer** element that defines two entity sets and one association set. Note that entity type and association type names are qualified by the conceptual model namespace name.
+
+``` xml
+ <EntityContainer Name="ExampleModelStoreContainer">
+   <EntitySet Name="Customers"
+              EntityType="ExampleModel.Store.Customers"
+              Schema="dbo" />
+   <EntitySet Name="Orders"
+              EntityType="ExampleModel.Store.Orders"
+              Schema="dbo" />
+   <AssociationSet Name="FK_CustomerOrders"
+                   Association="ExampleModel.Store.FK_CustomerOrders">
+     <End Role="Customers" EntitySet="Customers" />
+     <End Role="Orders" EntitySet="Orders" />
+   </AssociationSet>
+ </EntityContainer>
+```
+
+## EntitySet Element (SSDL)
+
+An **EntitySet** element in store schema definition language (SSDL) represents a table or view in the underlying database. An EntityType element in SSDL represents a row in the table or view. The **EntityType** attribute of an **EntitySet** element specifies the particular SSDL entity type that represents rows in an SSDL entity set. The mapping between a CSDL entity set and an SSDL entity set is specified in an EntitySetMapping element.
+
+The **EntitySet** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one element)
+-   DefiningQuery (zero or one element)
+-   Annotation elements
+
+### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **EntitySet** element.
+
+> [!NOTE]
+> Some attributes (not listed here) may be qualified with the **store** alias. These attributes are used by the Update Model Wizard when updating a model.
+
+| Attribute Name | Is Required | Value                                                                                    |
+|:---------------|:------------|:-----------------------------------------------------------------------------------------|
+| **Name**       | Yes         | The name of the entity set.                                                              |
+| **EntityType** | Yes         | The fully-qualified name of the entity type for which the entity set contains instances. |
+| **Schema**     | No          | The database schema.                                                                     |
+| **Table**      | No          | The database table.                                                                      |
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **EntitySet** element. However, custom attributes may not belong to any XML namespace that is reserved for SSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+### Example
+
+The following example shows an **EntityContainer** element that has two **EntitySet** elements and one **AssociationSet** element:
+
+``` xml
+ <EntityContainer Name="ExampleModelStoreContainer">
+   <EntitySet Name="Customers"
+              EntityType="ExampleModel.Store.Customers"
+              Schema="dbo" />
+   <EntitySet Name="Orders"
+              EntityType="ExampleModel.Store.Orders"
+              Schema="dbo" />
+   <AssociationSet Name="FK_CustomerOrders"
+                   Association="ExampleModel.Store.FK_CustomerOrders">
+     <End Role="Customers" EntitySet="Customers" />
+     <End Role="Orders" EntitySet="Orders" />
+   </AssociationSet>
+ </EntityContainer>
+```
+
+## EntityType Element (SSDL)
+
+An **EntityType** element in store schema definition language (SSDL) represents a row in a table or view of the underlying database. An EntitySet element in SSDL represents the table or view in which rows occur. The **EntityType** attribute of an **EntitySet** element specifies the particular SSDL entity type that represents rows in an SSDL entity set. The mapping between an SSDL entity type and a CSDL entity type is specified in an EntityTypeMapping element.
+
+The **EntityType** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one element)
+-   Key (zero or one element)
+-   Annotation elements
+
+### Applicable Attributes
+
+The table below describes the attributes that can be applied to the **EntityType** element.
+
+| Attribute Name | Is Required | Value                                                                                                                                                                  |
+|:---------------|:------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Name**       | Yes         | The name of the entity type. This value is usually the same as the name of the table in which the entity type represents a row. This value can contain no periods (.). |
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **EntityType** element. However, custom attributes may not belong to any XML namespace that is reserved for SSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+### Example
+
+The following example shows an **EntityType** element with two properties:
+
+``` xml
+ <EntityType Name="Customers">
+   <Documentation>
+     <Summary>Summary here.</Summary>
+     <LongDescription>Long description here.</LongDescription>
+   </Documentation>
+   <Key>
+     <PropertyRef Name="CustomerId" />
+   </Key>
+   <Property Name="CustomerId" Type="int" Nullable="false" />
+   <Property Name="Name" Type="nvarchar(max)" Nullable="false" />
+ </EntityType>
+```
+
+## Function Element (SSDL)
+
+The **Function** element in store schema definition language (SSDL) specifies a stored procedure that exists in the underlying database.
+
+The **Function** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one)
+-   Parameter (zero or more)
+-   CommandText (zero or one)
+-   ReturnType (zero or more)
+-   Annotation elements (zero or more)
+
+A return type for a function must be specified with either the **ReturnType** element or the **ReturnType** attribute (see below), but not both.
+
+Stored procedures that are specified in the storage model can be imported into the conceptual model of an application. For more information, see [Querying with Stored Procedures](xref:ef6/modeling/designer/stored-procedures/query). The **Function** element can also be used to define custom functions in the storage model.  
+
+### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **Function** element.
+
+> [!NOTE]
+> Some attributes (not listed here) may be qualified with the **store** alias. These attributes are used by the Update Model Wizard when updating a model.
+
+| Attribute Name             | Is Required | Value                                                                                                                                                                                                              |
+|:---------------------------|:------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Name**                   | Yes         | The name of the stored procedure.                                                                                                                                                                                  |
+| **ReturnType**             | No          | The return type of the stored procedure.                                                                                                                                                                           |
+| **Aggregate**              | No          | **True** if the stored procedure returns an aggregate value; otherwise **False**.                                                                                                                                  |
+| **BuiltIn**                | No          | **True** if the function is a built-in<sup>1</sup> function; otherwise **False**.                                                                                                                                  |
+| **StoreFunctionName**      | No          | The name of the stored procedure.                                                                                                                                                                                  |
+| **NiladicFunction**        | No          | **True** if the function is a niladic<sup>2</sup> function; **False** otherwise.                                                                                                                                   |
+| **IsComposable**           | No          | **True** if the function is a composable<sup>3</sup> function; **False** otherwise.                                                                                                                                |
+| **ParameterTypeSemantics** | No          | The enumeration that defines the type semantics used to resolve function overloads. The enumeration is defined in the provider manifest per function definition. The default value is **AllowImplicitConversion**. |
+| **Schema**                 | No          | The name of the schema in which the stored procedure is defined.                                                                                                                                                   |
+
+<sup>1</sup> A built-in function is a function that is defined in the database. For information about functions that are defined in the storage model, see CommandText Element (SSDL).
+
+<sup>2</sup> A niladic function is a function that accepts no parameters and, when called, does not require parentheses.
+
+<sup>3</sup> Two functions are composable if the output of one function can be the input for the other function.
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **Function** element. However, custom attributes may not belong to any XML namespace that is reserved for SSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+### Example
+
+The following example shows a **Function** element that corresponds to the **UpdateOrderQuantity** stored procedure. The stored procedure accepts two parameters and does not return a value.
+
+``` xml
+ <Function Name="UpdateOrderQuantity"
+           Aggregate="false"
+           BuiltIn="false"
+           NiladicFunction="false"
+           IsComposable="false"
+           ParameterTypeSemantics="AllowImplicitConversion"
+           Schema="dbo">
+   <Parameter Name="orderId" Type="int" Mode="In" />
+   <Parameter Name="newQuantity" Type="int" Mode="In" />
+ </Function>
+```
+
+## Key Element (SSDL)
+
+The **Key** element in store schema definition language (SSDL) represents the primary key of a table in the underlying database. **Key** is a child element of an EntityType element, which represents a row in a table. The primary key is defined in the **Key** element by referencing one or more Property elements that are defined on the **EntityType** element.
+
+The **Key** element can have the following child elements (in the order listed):
+
+-   PropertyRef (one or more)
+-   Annotation elements
+
+No attributes are applicable to the **Key** element.
+
+### Example
+
+The following example shows an **EntityType** element with a key that references one property:
+
+``` xml
+ <EntityType Name="Customers">
+   <Documentation>
+     <Summary>Summary here.</Summary>
+     <LongDescription>Long description here.</LongDescription>
+   </Documentation>
+   <Key>
+     <PropertyRef Name="CustomerId" />
+   </Key>
+   <Property Name="CustomerId" Type="int" Nullable="false" />
+   <Property Name="Name" Type="nvarchar(max)" Nullable="false" />
+ </EntityType>
+```
+
+## OnDelete Element (SSDL)
+
+The **OnDelete** element in store schema definition language (SSDL) reflects the database behavior when a row that participates in a foreign key constraint is deleted. If the action is set to **Cascade**, then rows that reference a row that is being deleted will also be deleted. If the action is set to **None**, then rows that reference a row that is being deleted are not also deleted. An **OnDelete** element is a child element of an End element.
+
+An **OnDelete** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one)
+-   Annotation elements (zero or more)
+
+### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **OnDelete** element.
+
+| Attribute Name | Is Required | Value                                                                                               |
+|:---------------|:------------|:----------------------------------------------------------------------------------------------------|
+| **Action**     | Yes         | **Cascade** or **None**. (The value **Restricted** is valid but has the same behavior as **None**.) |
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **OnDelete** element. However, custom attributes may not belong to any XML namespace that is reserved for SSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+### Example
+
+The following example shows an **Association** element that defines the **FK\_CustomerOrders** foreign key constraint. The **OnDelete** element indicates that all rows in the **Orders** table that reference a particular row in the **Customers** table will be deleted if the row in the **Customers** table is deleted.
+
+``` xml
+ <Association Name="FK_CustomerOrders">
+   <End Role="Customers"
+        Type="ExampleModel.Store.Customers" Multiplicity="1">
+     <OnDelete Action="Cascade" />
+   </End>
+   <End Role="Orders"
+        Type="ExampleModel.Store.Orders" Multiplicity="*" />
+   <ReferentialConstraint>
+     <Principal Role="Customers">
+       <PropertyRef Name="CustomerId" />
+     </Principal>
+     <Dependent Role="Orders">
+       <PropertyRef Name="CustomerId" />
+     </Dependent>
+   </ReferentialConstraint>
+ </Association>
+```
+
+## Parameter Element (SSDL)
+
+The **Parameter** element in store schema definition language (SSDL) is a child of the Function element that specifies parameters for a stored procedure in the database.
+
+The **Parameter** element can have the following child elements (in the order listed):
+
+-   Documentation (zero or one)
+-   Annotation elements (zero or more)
+
+### Applicable Attributes
+
+The table below describes the attributes that can be applied to the **Parameter** element.
+
+| Attribute Name | Is Required | Value                                                                                                                                                                                                                           |
+|:---------------|:------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Name**       | Yes         | The name of the parameter.                                                                                                                                                                                                      |
+| **Type**       | Yes         | The parameter type.                                                                                                                                                                                                             |
+| **Mode**       | No          | **In**, **Out**, or **InOut** depending on whether the parameter is an input, output, or input/output parameter.                                                                                                                |
+| **MaxLength**  | No          | The maximum length of the parameter.                                                                                                                                                                                            |
+| **Precision**  | No          | The precision of the parameter.                                                                                                                                                                                                 |
+| **Scale**      | No          | The scale of the parameter.                                                                                                                                                                                                     |
+| **SRID**       | No          | Spatial System Reference Identifier. Valid only for parameters of spatial types. For more information, see [SRID](https://en.wikipedia.org/wiki/SRID) and [SRID (SQL Server)](https://msdn.microsoft.com/library/bb964707.aspx). |
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **Parameter** element. However, custom attributes may not belong to any XML namespace that is reserved for SSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+### Example
+
+The following example shows a **Function** element that has two **Parameter** elements that specify input parameters:
+
+``` xml
+ <Function Name="UpdateOrderQuantity"
+           Aggregate="false"
+           BuiltIn="false"
+           NiladicFunction="false"
+           IsComposable="false"
+           ParameterTypeSemantics="AllowImplicitConversion"
+           Schema="dbo">
+   <Parameter Name="orderId" Type="int" Mode="In" />
+   <Parameter Name="newQuantity" Type="int" Mode="In" />
+ </Function>
+```
+
+## Principal Element (SSDL)
+
+The **Principal** element in store schema definition language (SSDL) is a child element to the ReferentialConstraint element that defines the principal end of a foreign key constraint (also called a referential constraint). The **Principal** element specifies the primary key column (or columns) in a table that is referenced by another column (or columns). **PropertyRef** elements specify which columns are referenced. The Dependent element specifies columns that reference the primary key columns that are specified in the **Principal** element.
+
+The **Principal** element can have the following child elements (in the order listed):
+
+-   PropertyRef (one or more)
+-   Annotation elements (zero or more)
+
+### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **Principal** element.
+
+| Attribute Name | Is Required | Value                                                                                                                                                      |
+|:---------------|:------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Role**       | Yes         | The same value as the **Role** attribute (if used) of the corresponding End element; otherwise, the name of the table that contains the referenced column. |
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **Principal** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+### Example
+
+The following example shows an Association element that uses a **ReferentialConstraint** element to specify the columns that participate in the **FK\_CustomerOrders** foreign key constraint. The **Principal** element specifies the **CustomerId** column of the **Customer** table as the principal end of the constraint.
+
+``` xml
+ <Association Name="FK_CustomerOrders">
+   <End Role="Customers"
+        Type="ExampleModel.Store.Customers" Multiplicity="1">
+     <OnDelete Action="Cascade" />
+   </End>
+   <End Role="Orders"
+        Type="ExampleModel.Store.Orders" Multiplicity="*" />
+   <ReferentialConstraint>
+     <Principal Role="Customers">
+       <PropertyRef Name="CustomerId" />
+     </Principal>
+     <Dependent Role="Orders">
+       <PropertyRef Name="CustomerId" />
+     </Dependent>
+   </ReferentialConstraint>
+ </Association>
+```
+
+## Property Element (SSDL)
+
+The **Property** element in store schema definition language (SSDL) represents a column in a table in the underlying database. **Property** elements are children of EntityType elements, which represent rows in a table. Each **Property** element defined on an **EntityType** element represents a column.
+
+A **Property** element cannot have any child elements.
+
+### Applicable Attributes
+
+The following table describes the attributes that can be applied to the **Property** element.
+
+| Attribute Name            | Is Required | Value                                                                                                                                                                                                                           |
+|:--------------------------|:------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Name**                  | Yes         | The name of the corresponding column.                                                                                                                                                                                           |
+| **Type**                  | Yes         | The type of the corresponding column.                                                                                                                                                                                           |
+| **Nullable**              | No          | **True** (the default value) or **False** depending on whether the corresponding column can have a null value.                                                                                                                  |
+| **DefaultValue**          | No          | The default value of the corresponding column.                                                                                                                                                                                  |
+| **MaxLength**             | No          | The maximum length of the corresponding column.                                                                                                                                                                                 |
+| **FixedLength**           | No          | **True** or **False** depending on whether the corresponding column value will be stored as a fixed length string.                                                                                                              |
+| **Precision**             | No          | The precision of the corresponding column.                                                                                                                                                                                      |
+| **Scale**                 | No          | The scale of the corresponding column.                                                                                                                                                                                          |
+| **Unicode**               | No          | **True** or **False** depending on whether the corresponding column value will be stored as a Unicode string.                                                                                                                   |
+| **Collation**             | No          | A string that specifies the collating sequence to be used in the data source.                                                                                                                                                   |
+| **SRID**                  | No          | Spatial System Reference Identifier. Valid only for properties of spatial types. For more information, see [SRID](https://en.wikipedia.org/wiki/SRID) and [SRID (SQL Server)](https://msdn.microsoft.com/library/bb964707.aspx). |
+| **StoreGeneratedPattern** | No          | **None**, **Identity** (if the corresponding column value is an identity that is generated in the database), or **Computed** (if the corresponding column value is computed in the database). Not Valid for RowType properties. |
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **Property** element. However, custom attributes may not belong to any XML namespace that is reserved for SSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+### Example
+
+The following example shows an **EntityType** element with two child **Property** elements:
+
+``` xml
+ <EntityType Name="Customers">
+   <Documentation>
+     <Summary>Summary here.</Summary>
+     <LongDescription>Long description here.</LongDescription>
+   </Documentation>
+   <Key>
+     <PropertyRef Name="CustomerId" />
+   </Key>
+   <Property Name="CustomerId" Type="int" Nullable="false" />
+   <Property Name="Name" Type="nvarchar(max)" Nullable="false" />
+ </EntityType>
+```
+
+## PropertyRef Element (SSDL)
+
+The **PropertyRef** element in store schema definition language (SSDL) references a property defined on an EntityType element to indicate that the property will perform one of the following roles:
+
+-   Be part of the primary key of the table that the **EntityType** represents. One or more **PropertyRef** elements can be used to define a primary key. For more information, see Key element.
+-   Be the dependent or principal end of a referential constraint. For more information, see ReferentialConstraint element.
+
+The **PropertyRef** element can only have the following child elements:
+
+-   Documentation (zero or one)
+-   Annotation elements
+
+### Applicable Attributes
+
+The table below describes the attributes that can be applied to the **PropertyRef** element.
+
+| Attribute Name | Is Required | Value                                |
+|:---------------|:------------|:-------------------------------------|
+| **Name**       | Yes         | The name of the referenced property. |
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **PropertyRef** element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+### Example
+
+The following example shows a **PropertyRef** element used to define a primary key by referencing a property that is defined on an **EntityType** element.
+
+``` xml
+ <EntityType Name="Customers">
+   <Documentation>
+     <Summary>Summary here.</Summary>
+     <LongDescription>Long description here.</LongDescription>
+   </Documentation>
+   <Key>
+     <PropertyRef Name="CustomerId" />
+   </Key>
+   <Property Name="CustomerId" Type="int" Nullable="false" />
+   <Property Name="Name" Type="nvarchar(max)" Nullable="false" />
+ </EntityType>
+```
+
+## ReferentialConstraint Element (SSDL)
+
+The **ReferentialConstraint** element in store schema definition language (SSDL) represents a foreign key constraint (also called a referential integrity constraint) in the underlying database. The principal and dependent ends of the constraint are specified by the Principal and Dependent child elements, respectively. Columns that participate in the principal and dependent ends are referenced with PropertyRef elements.
+
+The **ReferentialConstraint** element is an optional child element of the Association element. If a **ReferentialConstraint** element is not used to map the foreign key constraint that is specified in the **Association** element, an AssociationSetMapping element must be used to do this.
+
+The **ReferentialConstraint** element can have the following child elements:
+
+-   Documentation (zero or one)
+-   Principal (exactly one)
+-   Dependent (exactly one)
+-   Annotation elements (zero or more)
+
+### Applicable Attributes
+
+Any number of annotation attributes (custom XML attributes) may be applied to the **ReferentialConstraint** element. However, custom attributes may not belong to any XML namespace that is reserved for SSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+### Example
+
+The following example shows an **Association** element that uses a **ReferentialConstraint** element to specify the columns that participate in the **FK\_CustomerOrders** foreign key constraint:
+
+``` xml
+ <Association Name="FK_CustomerOrders">
+   <End Role="Customers"
+        Type="ExampleModel.Store.Customers" Multiplicity="1">
+     <OnDelete Action="Cascade" />
+   </End>
+   <End Role="Orders"
+        Type="ExampleModel.Store.Orders" Multiplicity="*" />
+   <ReferentialConstraint>
+     <Principal Role="Customers">
+       <PropertyRef Name="CustomerId" />
+     </Principal>
+     <Dependent Role="Orders">
+       <PropertyRef Name="CustomerId" />
+     </Dependent>
+   </ReferentialConstraint>
+ </Association>
+```
+
+## ReturnType Element (SSDL)
+
+The **ReturnType** element in store schema definition language (SSDL) specifies the return type for a function that is defined in a **Function** element. A function return type can also be specified with a **ReturnType** attribute.
+
+The return type of a function is specified with the **Type** attribute or the **ReturnType** element.
+
+The **ReturnType** element can have the following child elements:
+
+- CollectionType (one)  
+
+> [!NOTE]
+> Any number of annotation attributes (custom XML attributes) may be applied to the **ReturnType** element. However, custom attributes may not belong to any XML namespace that is reserved for SSDL. The fully-qualified names for any two custom attributes cannot be the same.
+
+### Example
+
+The following example uses a **Function** that returns a collection of rows.
+
+``` xml
+   <Function Name="GetProducts" IsComposable="true" Schema="dbo">
+     <ReturnType>
+       <CollectionType>
+         <RowType>
+           <Property Name="ProductID" Type="int" Nullable="false" />
+           <Property Name="CategoryID" Type="bigint" Nullable="false" />
+           <Property Name="ProductName" Type="nvarchar" MaxLength="40" Nullable="false" />
+           <Property Name="UnitPrice" Type="money" />
+           <Property Name="Discontinued" Type="bit" />
+         </RowType>
+       </CollectionType>
+     </ReturnType>
+   </Function>
+```
+
+
+## RowType Element (SSDL)
+
+A **RowType** element in store schema definition language (SSDL) defines an unnamed structure as a return type for a function defined in the store.
+
+A **RowType** element is the child element of **CollectionType** element:
+
+A **RowType** element can have the following child elements:
+
+- Property (one or more)  
+
+### Example
+
+The following example shows a store function that uses a **CollectionType** element to specify that the function returns a collection of rows (as specified in the **RowType** element).
+
+
+``` xml
+   <Function Name="GetProducts" IsComposable="true" Schema="dbo">
+     <ReturnType>
+       <CollectionType>
+         <RowType>
+           <Property Name="ProductID" Type="int" Nullable="false" />
+           <Property Name="CategoryID" Type="bigint" Nullable="false" />
+           <Property Name="ProductName" Type="nvarchar" MaxLength="40" Nullable="false" />
+           <Property Name="UnitPrice" Type="money" />
+           <Property Name="Discontinued" Type="bit" />
+         </RowType>
+       </CollectionType>
+     </ReturnType>
+   </Function>
+```
+
+## Schema Element (SSDL)
+
+The **Schema** element in store schema definition language (SSDL) is the root element of a storage model definition. It contains definitions for the objects, functions, and containers that make up a storage model.
+
+The **Schema** element may contain zero or more of the following child elements:
+
+-   Association
+-   EntityType
+-   EntityContainer
+-   Function
+
+The **Schema** element uses the **Namespace** attribute to define the namespace for the entity type and association objects in a storage model. Within a namespace, no two objects can have the same name.
+
+A storage model namespace is different from the XML namespace of the **Schema** element. A storage model namespace (as defined by the **Namespace** attribute) is a logical container for entity types and association types. The XML namespace (indicated by the **xmlns** attribute) of a **Schema** element is the default namespace for child elements and attributes of the **Schema** element. XML namespaces of the form `https://schemas.microsoft.com/ado/YYYY/MM/edm/ssdl` (where YYYY and MM represent a year and month respectively) are reserved for SSDL. Custom elements and attributes cannot be in namespaces that have this form.
+
+### Applicable Attributes
+
+The table below describes the attributes can be applied to the **Schema** element.
+
+| Attribute Name            | Is Required | Value                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+|:--------------------------|:------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Namespace**             | Yes         | The namespace of the storage model. The value of the **Namespace** attribute is used to form the fully qualified name of a type. For example, if an **EntityType** named *Customer* is in the ExampleModel.Store namespace, then the fully qualified name of the **EntityType** is ExampleModel.Store.Customer. <br/> The following strings cannot be used as the value for the **Namespace** attribute: **System**, **Transient**, or **Edm**. The value for the **Namespace** attribute cannot be the same as the value for the **Namespace** attribute in the CSDL Schema element. |
+| **Alias**                 | No          | An identifier used in place of the namespace name. For example, if an **EntityType** named *Customer* is in the ExampleModel.Store namespace and the value of the **Alias** attribute is *StorageModel*, then you can use StorageModel.Customer as the fully qualified name of the **EntityType.**                                                                                                                                                                                                                                                                                    |
+| **Provider**              | Yes         | The data provider.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| **ProviderManifestToken** | Yes         | A token that indicates to the provider which provider manifest to return. No format for the token is defined. Values for the token are defined by the provider. For information about SQL Server provider manifest tokens, see SqlClient for Entity Framework.                                                                                                                                                                                                                                                                                                                        |
+
+### Example
+
+The following example shows a **Schema** element that contains an **EntityContainer** element, two **EntityType** elements, and one **Association** element.
+
+``` xml
+ <Schema Namespace="ExampleModel.Store"
+       Alias="Self" Provider="System.Data.SqlClient"
+       ProviderManifestToken="2008"
+       xmlns="https://schemas.microsoft.com/ado/2009/11/edm/ssdl">
+   <EntityContainer Name="ExampleModelStoreContainer">
+     <EntitySet Name="Customers"
+                EntityType="ExampleModel.Store.Customers"
+                Schema="dbo" />
+     <EntitySet Name="Orders"
+                EntityType="ExampleModel.Store.Orders"
+                Schema="dbo" />
+     <AssociationSet Name="FK_CustomerOrders"
+                     Association="ExampleModel.Store.FK_CustomerOrders">
+       <End Role="Customers" EntitySet="Customers" />
+       <End Role="Orders" EntitySet="Orders" />
+     </AssociationSet>
+   </EntityContainer>
+   <EntityType Name="Customers">
+     <Documentation>
+       <Summary>Summary here.</Summary>
+       <LongDescription>Long description here.</LongDescription>
+     </Documentation>
+     <Key>
+       <PropertyRef Name="CustomerId" />
+     </Key>
+     <Property Name="CustomerId" Type="int" Nullable="false" />
+     <Property Name="Name" Type="nvarchar(max)" Nullable="false" />
+   </EntityType>
+   <EntityType Name="Orders" xmlns:c="http://CustomNamespace">
+     <Key>
+       <PropertyRef Name="OrderId" />
+     </Key>
+     <Property Name="OrderId" Type="int" Nullable="false"
+               c:CustomAttribute="someValue"/>
+     <Property Name="ProductId" Type="int" Nullable="false" />
+     <Property Name="Quantity" Type="int" Nullable="false" />
+     <Property Name="CustomerId" Type="int" Nullable="false" />
+     <c:CustomElement>
+       Custom data here.
+     </c:CustomElement>
+   </EntityType>
+   <Association Name="FK_CustomerOrders">
+     <End Role="Customers"
+          Type="ExampleModel.Store.Customers" Multiplicity="1">
+       <OnDelete Action="Cascade" />
+     </End>
+     <End Role="Orders"
+          Type="ExampleModel.Store.Orders" Multiplicity="*" />
+     <ReferentialConstraint>
+       <Principal Role="Customers">
+         <PropertyRef Name="CustomerId" />
+       </Principal>
+       <Dependent Role="Orders">
+         <PropertyRef Name="CustomerId" />
+       </Dependent>
+     </ReferentialConstraint>
+   </Association>
+   <Function Name="UpdateOrderQuantity"
+             Aggregate="false"
+             BuiltIn="false"
+             NiladicFunction="false"
+             IsComposable="false"
+             ParameterTypeSemantics="AllowImplicitConversion"
+             Schema="dbo">
+     <Parameter Name="orderId" Type="int" Mode="In" />
+     <Parameter Name="newQuantity" Type="int" Mode="In" />
+   </Function>
+   <Function Name="UpdateProductInOrder" IsComposable="false">
+     <CommandText>
+       UPDATE Orders
+       SET ProductId = @productId
+       WHERE OrderId = @orderId;
+     </CommandText>
+     <Parameter Name="productId"
+                Mode="In"
+                Type="int"/>
+     <Parameter Name="orderId"
+                Mode="In"
+                Type="int"/>
+   </Function>
+ </Schema>
+```
+
+## Annotation Attributes
+
+Annotation attributes in store schema definition language (SSDL) are custom XML attributes in the storage model that provide extra metadata about the elements in the storage model. In addition to having valid XML structure, the following constraints apply to annotation attributes:
+
+-   Annotation attributes must not be in any XML namespace that is reserved for SSDL.
+-   The fully-qualified names of any two annotation attributes must not be the same.
+
+More than one annotation attribute may be applied to a given SSDL element. Metadata contained in annotation elements can be accessed at runtime by using classes in the System.Data.Metadata.Edm namespace.
+
+### Example
+
+The following example shows an EntityType element that has an annotation attribute applied to the **OrderId** property. The example also show an annotation element added to the **EntityType** element.
+
+``` xml
+ <EntityType Name="Orders" xmlns:c="http://CustomNamespace">
+   <Key>
+     <PropertyRef Name="OrderId" />
+   </Key>
+   <Property Name="OrderId" Type="int" Nullable="false"
+             c:CustomAttribute="someValue"/>
+   <Property Name="ProductId" Type="int" Nullable="false" />
+   <Property Name="Quantity" Type="int" Nullable="false" />
+   <Property Name="CustomerId" Type="int" Nullable="false" />
+   <c:CustomElement>
+     Custom data here.
+   </c:CustomElement>
+ </EntityType>
+```
+
+## Annotation Elements (SSDL)
+
+Annotation elements in store schema definition language (SSDL) are custom XML elements in the storage model that provide extra metadata about the storage model. In addition to having valid XML structure, the following constraints apply to annotation elements:
+
+-   Annotation elements must not be in any XML namespace that is reserved for SSDL.
+-   The fully-qualified names of any two annotation elements must not be the same.
+-   Annotation elements must appear after all other child elements of a given SSDL element.
+
+More than one annotation element may be a child of a given SSDL element. Starting with the .NET Framework version 4, metadata contained in annotation elements can be accessed at runtime by using classes in the System.Data.Metadata.Edm namespace.
+
+### Example
+
+The following example shows an EntityType element that has an annotation element (**CustomElement**). The example also shows an annotation attribute applied to the **OrderId** property.
+
+``` xml
+ <EntityType Name="Orders" xmlns:c="http://CustomNamespace">
+   <Key>
+     <PropertyRef Name="OrderId" />
+   </Key>
+   <Property Name="OrderId" Type="int" Nullable="false"
+             c:CustomAttribute="someValue"/>
+   <Property Name="ProductId" Type="int" Nullable="false" />
+   <Property Name="Quantity" Type="int" Nullable="false" />
+   <Property Name="CustomerId" Type="int" Nullable="false" />
+   <c:CustomElement>
+     Custom data here.
+   </c:CustomElement>
+ </EntityType>
+```
+
+## Facets (SSDL)
+
+Facets in store schema definition language (SSDL) represent constraints on column types that are specified in Property elements. Facets are implemented as XML attributes on **Property** elements.
+
+The following table describes the facets that are supported in SSDL:
+
+| Facet           | Description                                                                                                                                                                                                                                                 |
+|:----------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Collation**   | Specifies the collating sequence (or sorting sequence) to be used when performing comparison and ordering operations on values of the property.                                                                                                             |
+| **FixedLength** | Specifies whether the length of the column value can vary.                                                                                                                                                                                                  |
+| **MaxLength**   | Specifies the maximum length of the column value.                                                                                                                                                                                                           |
+| **Precision**   | For properties of type **Decimal**, specifies the number of digits a property value can have. For properties of type **Time**, **DateTime**, and **DateTimeOffset**, specifies the number of digits for the fractional part of seconds of the column value. |
+| **Scale**       | Specifies the number of digits to the right of the decimal point for the column value.                                                                                                                                                                      |
+| **Unicode**     | Indicates whether the column value is stored as Unicode.                                                                                                                                                                                                    |
diff --git a/entity-framework/ef6/modeling/designer/advanced/multiple-result-sets.md b/entity-framework/ef6/modeling/designer/advanced/multiple-result-sets.md
new file mode 100644
index 0000000000..66bf8627b2
--- /dev/null
+++ b/entity-framework/ef6/modeling/designer/advanced/multiple-result-sets.md
@@ -0,0 +1,216 @@
+---
+title: Stored Procedures with Multiple Result Sets - EF6
+description: Stored Procedures with Multiple Result Sets in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/designer/advanced/multiple-result-sets
+---
+# Stored Procedures with Multiple Result Sets
+Sometimes when using stored procedures you will need to return more than one result set. This scenario is commonly used to reduce the number of database round trips required to compose a single screen. Prior to EF5, Entity Framework would allow the stored procedure to be called but would only return the first result set to the calling code.
+
+This article will show you two ways that you can use to access more than one result set from a stored procedure in Entity Framework. One that uses just code and works with both Code first and the EF Designer and one that only works with the EF Designer. The tooling and API support for this should improve in future versions of Entity Framework.
+
+## Model
+
+The examples in this article use a basic Blog and Posts model where a blog has many posts and a post belongs to a single blog. We will use a stored procedure in the database that returns all blogs and posts, something like this:
+
+``` SQL
+    CREATE PROCEDURE [dbo].[GetAllBlogsAndPosts]
+    AS
+        SELECT * FROM dbo.Blogs
+        SELECT * FROM dbo.Posts
+```
+
+## Accessing Multiple Result Sets with Code
+
+We can execute use code to issue a raw SQL command to execute our stored procedure. The advantage of this approach is that it works with both Code first and the EF Designer.
+
+In order to get multiple result sets working we need to drop to the ObjectContext API by using the IObjectContextAdapter interface.
+
+Once we have an ObjectContext then we can use the Translate method to translate the results of our stored procedure into entities that can be tracked and used in EF as normal. The following code sample demonstrates this in action.
+
+``` csharp
+    using (var db = new BloggingContext())
+    {
+        // If using Code First we need to make sure the model is built before we open the connection
+        // This isn't required for models created with the EF Designer
+        db.Database.Initialize(force: false);
+
+        // Create a SQL command to execute the sproc
+        var cmd = db.Database.Connection.CreateCommand();
+        cmd.CommandText = "[dbo].[GetAllBlogsAndPosts]";
+
+        try
+        {
+
+            db.Database.Connection.Open();
+            // Run the sproc
+            var reader = cmd.ExecuteReader();
+
+            // Read Blogs from the first result set
+            var blogs = ((IObjectContextAdapter)db)
+                .ObjectContext
+                .Translate<Blog>(reader, "Blogs", MergeOption.AppendOnly);   
+
+
+            foreach (var item in blogs)
+            {
+                Console.WriteLine(item.Name);
+            }        
+
+            // Move to second result set and read Posts
+            reader.NextResult();
+            var posts = ((IObjectContextAdapter)db)
+                .ObjectContext
+                .Translate<Post>(reader, "Posts", MergeOption.AppendOnly);
+
+
+            foreach (var item in posts)
+            {
+                Console.WriteLine(item.Title);
+            }
+        }
+        finally
+        {
+            db.Database.Connection.Close();
+        }
+    }
+```
+
+The Translate method accepts the reader that we received when we executed the procedure, an EntitySet name, and a MergeOption. The EntitySet name will be the same as the DbSet property on your derived context. The MergeOption enum controls how results are handled if the same entity already exists in memory.
+
+Here we iterate through the collection of blogs before we call NextResult, this is important given the above code because the first result set must be consumed before moving to the next result set.
+
+Once the two translate methods are called then the Blog and Post entities are tracked by EF the same way as any other entity and so can be modified or deleted and saved as normal.
+
+>[!NOTE]
+> EF does not take any mapping into account when it creates entities using the Translate method. It will simply match column names in the result set with property names on your classes.
+
+>[!NOTE]
+> That if you have lazy loading enabled, accessing the posts property on one of the blog entities then EF will connect to the database to lazily load all posts, even though we have already loaded them all. This is because EF cannot know whether or not you have loaded all posts or if there are more in the database. If you want to avoid this then you will need to disable lazy loading.
+
+## Multiple Result Sets with Configured in EDMX
+
+>[!NOTE]
+> You must target .NET Framework 4.5 to be able to configure multiple result sets in EDMX. If you are targeting .NET 4.0 you can use the code-based method shown in the previous section.
+
+If you are using the EF Designer, you can also modify your model so that it knows about the different result sets that will be returned. One thing to know before hand is that the tooling is not multiple result set aware, so you will need to manually edit the edmx file. Editing the edmx file like this will work but it will also break the validation of the model in VS. So if you validate your model you will always get errors.
+
+-   In order to do this you need to add the stored procedure to your model as you would for a single result set query.
+-   Once you have this then you need to right click on your model and select **Open With..** then **Xml**
+
+    ![Open As](~/ef6/media/openas.png)
+
+Once you have the model opened as XML then you need to do the following steps:
+
+-   Find the complex type and function import in your model:
+
+``` xml
+    <!-- CSDL content -->
+    <edmx:ConceptualModels>
+
+    ...
+
+      <FunctionImport Name="GetAllBlogsAndPosts" ReturnType="Collection(BlogModel.GetAllBlogsAndPosts_Result)" />
+
+    ...
+
+      <ComplexType Name="GetAllBlogsAndPosts_Result">
+        <Property Type="Int32" Name="BlogId" Nullable="false" />
+        <Property Type="String" Name="Name" Nullable="false" MaxLength="255" />
+        <Property Type="String" Name="Description" Nullable="true" />
+      </ComplexType>
+
+    ...
+
+    </edmx:ConceptualModels>
+```
+
+ 
+
+-   Remove the complex type
+-   Update the function import so that it maps to your entities, in our case it will look like the following:
+
+``` xml
+    <FunctionImport Name="GetAllBlogsAndPosts">
+      <ReturnType EntitySet="Blogs" Type="Collection(BlogModel.Blog)" />
+      <ReturnType EntitySet="Posts" Type="Collection(BlogModel.Post)" />
+    </FunctionImport>
+```
+
+This tells the model that the stored procedure will return two collections, one of blog entries and one of post entries.
+
+-   Find the function mapping element:
+
+``` xml
+    <!-- C-S mapping content -->
+    <edmx:Mappings>
+
+    ...
+
+      <FunctionImportMapping FunctionImportName="GetAllBlogsAndPosts" FunctionName="BlogModel.Store.GetAllBlogsAndPosts">
+        <ResultMapping>
+          <ComplexTypeMapping TypeName="BlogModel.GetAllBlogsAndPosts_Result">
+            <ScalarProperty Name="BlogId" ColumnName="BlogId" />
+            <ScalarProperty Name="Name" ColumnName="Name" />
+            <ScalarProperty Name="Description" ColumnName="Description" />
+          </ComplexTypeMapping>
+        </ResultMapping>
+      </FunctionImportMapping>
+
+    ...
+
+    </edmx:Mappings>
+```
+
+-   Replace the result mapping with one for each entity being returned, such as the following:
+
+``` xml
+    <ResultMapping>
+      <EntityTypeMapping TypeName ="BlogModel.Blog">
+        <ScalarProperty Name="BlogId" ColumnName="BlogId" />
+        <ScalarProperty Name="Name" ColumnName="Name" />
+        <ScalarProperty Name="Description" ColumnName="Description" />
+      </EntityTypeMapping>
+    </ResultMapping>
+    <ResultMapping>
+      <EntityTypeMapping TypeName="BlogModel.Post">
+        <ScalarProperty Name="BlogId" ColumnName="BlogId" />
+        <ScalarProperty Name="PostId" ColumnName="PostId"/>
+        <ScalarProperty Name="Title" ColumnName="Title" />
+        <ScalarProperty Name="Text" ColumnName="Text" />
+      </EntityTypeMapping>
+    </ResultMapping>
+```
+
+It is also possible to map the result sets to complex types, such as the one created by default. To do this you create a new complex type, instead of removing them, and use the complex types everywhere that you had used the entity names in the examples above.
+
+Once these mappings have been changed then you can save the model and execute the following code to use the stored procedure:
+
+``` csharp
+    using (var db = new BlogEntities())
+    {
+        var results = db.GetAllBlogsAndPosts();
+
+        foreach (var result in results)
+        {
+            Console.WriteLine("Blog: " + result.Name);
+        }
+
+        var posts = results.GetNextResult<Post>();
+
+        foreach (var result in posts)
+        {
+            Console.WriteLine("Post: " + result.Title);
+        }
+
+        Console.ReadLine();
+    }
+```
+
+>[!NOTE]
+> If you manually edit the edmx file for your model it will be overwritten if you ever regenerate the model from the database.
+
+## Summary
+
+Here we have shown two different methods of accessing multiple result sets using Entity Framework. Both of them are equally valid depending on your situation and preferences and you should choose the one that seems best for your circumstances. It is planned that the support for multiple result sets will be improved in future versions of Entity Framework and that performing the steps in this document will no longer be necessary.
diff --git a/entity-framework/ef6/modeling/designer/advanced/tvfs.md b/entity-framework/ef6/modeling/designer/advanced/tvfs.md
new file mode 100644
index 0000000000..f3a4d8bcf4
--- /dev/null
+++ b/entity-framework/ef6/modeling/designer/advanced/tvfs.md
@@ -0,0 +1,133 @@
+---
+title: Table-Valued Functions (TVFs) - EF6
+description: Table-Valued Functions (TVFs) in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/designer/advanced/tvfs
+---
+# Table-Valued Functions (TVFs)
+> [!NOTE]
+> **EF5 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 5. If you are using an earlier version, some or all of the information does not apply.
+
+The video and step-by-step walkthrough shows how to map table-valued functions (TVFs) using the Entity Framework Designer. It also demonstrates how to call a TVF from a LINQ query.
+
+TVFs are currently only supported in the Database First workflow.
+
+TVF support was introduced in Entity Framework version 5. Note that to use the new features like table-valued functions, enums, and spatial types you must target .NET Framework 4.5. Visual Studio 2012 targets .NET 4.5 by default.
+
+TVFs are very similar to stored procedures with one key difference: the result of a TVF is composable. That means the results from a TVF can be used in a LINQ query while the results of a stored procedure cannot.
+
+## Watch the video
+
+**Presented By**: Julia Kornich
+
+[WMV](https://download.microsoft.com/download/6/0/A/60A6E474-5EF3-4E1E-B9EA-F51D2DDB446A/HDI-ITPro-MSDN-winvideo-tvf.wmv) | [MP4](https://download.microsoft.com/download/6/0/A/60A6E474-5EF3-4E1E-B9EA-F51D2DDB446A/HDI-ITPro-MSDN-mp4video-tvf.m4v) | [WMV (ZIP)](https://download.microsoft.com/download/6/0/A/60A6E474-5EF3-4E1E-B9EA-F51D2DDB446A/HDI-ITPro-MSDN-winvideo-tvf.zip)
+
+## Pre-Requisites
+
+To complete this walkthrough, you need to:
+
+- Install the [School database](xref:ef6/resources/school-database).
+
+- Have a recent version of Visual Studio
+
+## Set up the Project
+
+1.  Open Visual Studio
+2.  On the **File** menu, point to **New**, and then click **Project**
+3.  In the left pane, click **Visual C\#**, and then select the **Console** template
+4.  Enter **TVF** as the name of the project and click **OK**
+
+## Add a TVF to the Database
+
+-   Select **View -&gt; SQL Server Object Explorer**
+-   If LocalDB is not in the list of servers:
+    Right-click on **SQL Server** and select **Add SQL Server**
+    Use the default **Windows Authentication** to connect to the LocalDB server
+-   Expand the LocalDB node
+-   Under the Databases node, right-click the School database node and select **New Query…**
+-   In T-SQL Editor, paste the following TVF definition
+
+``` SQL
+CREATE FUNCTION [dbo].[GetStudentGradesForCourse]
+
+(@CourseID INT)
+
+RETURNS TABLE
+
+RETURN
+    SELECT [EnrollmentID],
+           [CourseID],
+           [StudentID],
+           [Grade]
+    FROM   [dbo].[StudentGrade]
+    WHERE  CourseID = @CourseID
+```
+
+-   Click the right mouse button on the T-SQL editor and select **Execute**
+-   The GetStudentGradesForCourse function is added to the School database
+
+ 
+
+## Create a Model
+
+1.  Right-click the project name in Solution Explorer, point to **Add**, and then click **New Item**
+2.  Select **Data** from the left menu and then select **ADO.NET Entity Data Model** in the **Templates** pane
+3.  Enter **TVFModel.edmx** for the file name, and then click **Add**
+4.  In the Choose Model Contents dialog box, select **Generate from database**, and then click **Next**
+5.  Click **New Connection**
+    Enter **(localdb)\\mssqllocaldb** in the Server name text box
+    Enter **School** for the database name
+    Click **OK**
+6.  In the Choose Your Database Objects dialog box, under the **Tables** node, select the **Person**, **StudentGrade**, and **Course** tables
+7.  Select the **GetStudentGradesForCourse** function located under the **Stored Procedures and Functions** node
+    Note, that starting with Visual Studio 2012, the Entity Designer allows you to batch import your Stored Procedures and Functions
+8.  Click **Finish**
+9.  The Entity Designer, which provides a design surface for editing your model, is displayed. All the objects that you selected in the **Choose Your Database Objects** dialog box are added to the model.
+10. By default, the result shape of each imported stored procedure or function will automatically become a new complex type in your entity model. But we want to map the results of the GetStudentGradesForCourse function to the StudentGrade entity:
+    Right-click the design surface and select **Model Browser**
+    In Model Browser, select **Function Imports**, and then double-click the **GetStudentGradesForCourse** function
+    In the Edit Function Import dialog box, select **Entities** and choose **StudentGrade**
+
+## Persist and Retrieve Data
+
+Open the file where the Main method is defined. Add the following code into the Main function.
+
+The following code demonstrates how to build a query that uses a Table-valued Function. The query projects the results into an anonymous type that contains the related Course title and related students with a grade greater or equal to 3.5.
+
+``` csharp
+using (var context = new SchoolEntities())
+{
+    var CourseID = 4022;
+    var Grade = 3.5M;
+
+    // Return all the best students in the Microeconomics class.
+    var students = from s in context.GetStudentGradesForCourse(CourseID)
+                            where s.Grade >= Grade
+                            select new
+                            {
+                                s.Person,
+                                s.Course.Title
+                            };
+
+    foreach (var result in students)
+    {
+        Console.WriteLine(
+            "Couse: {0}, Student: {1} {2}",
+            result.Title,  
+            result.Person.FirstName,  
+            result.Person.LastName);
+    }
+}
+```
+
+Compile and run the application. The program produces the following output:
+
+```console
+Couse: Microeconomics, Student: Arturo Anand
+Couse: Microeconomics, Student: Carson Bryant
+```
+
+## Summary
+
+In this walkthrough we looked at how to map Table-valued Functions (TVFs) using the Entity Framework Designer. It also demonstrated how to call a TVF from a LINQ query.
diff --git a/entity-framework/ef6/modeling/designer/codegen/index.md b/entity-framework/ef6/modeling/designer/codegen/index.md
new file mode 100644
index 0000000000..59db859901
--- /dev/null
+++ b/entity-framework/ef6/modeling/designer/codegen/index.md
@@ -0,0 +1,169 @@
+---
+title: Designer Code Generation Templates - EF6
+description: Designer Code Generation Templates in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/designer/codegen/index
+---
+# Designer Code Generation Templates
+When you create a model using the Entity Framework Designer your classes and derived context are automatically generated for you. In addition to the default code generation we also provide a number of templates that can be used to customize the code that gets generated. These templates are provided as T4 Text Templates, allowing you to customize the templates if needed.
+
+The code that gets generated by default depends on which version of Visual Studio you create your model in:
+
+-   Models created in Visual Studio 2012 & 2013 will generate simple POCO entity classes and a context that derives from the simplified DbContext.
+-   Models created in Visual Studio 2010 will generate entity classes that derive from EntityObject and a context that derives from ObjectContext.
+  > [!NOTE]    
+  > We recommend switching to the DbContext Generator template once you've added your model.
+
+This page covers the available templates and then provides instructions for adding a template to your model.
+
+## Available Templates
+
+The following templates are provided by the Entity Framework team:
+
+### DbContext Generator
+
+This template will generate simple POCO entity classes and a context that derives from DbContext using EF6.
+This is the recommended template unless you have a reason to use one of the other templates listed below.
+It is also the code generation template you get by default if you are using recent versions of Visual Studio (Visual Studio 2013 onwards):
+When you create a new model this template is used by default and the T4 files (.tt) are nested under your .edmx file.
+
+#### Older versions of Visual Studio
+- **Visual Studio 2012:** To get the **EF 6.x DbContextGenerator** templates you will need to install the latest **Entity Framework Tools for Visual Studio** - see the [Get Entity Framework](xref:ef6/fundamentals/install) page for more information.
+- **Visual Studio 2010:** The **EF 6.x DbContextGenerator** templates are not available for Visual Studio 2010.
+
+#### DbContext Generator for EF 5.x
+
+If you are using an older version of the EntityFramework NuGet package (one with a major version of 5) you will need to use the **EF 5.x DbContext Generator** template.
+
+If you are using Visual Studio 2013 or 2012 this template is already installed.
+
+If you are using Visual Studio 2010 you will need to select the **Online** tab when adding the template to download it from Visual Studio Gallery. Alternatively you can install the template directly from Visual Studio Gallery ahead of time. Because the templates are included in later versions of Visual Studio the versions on the gallery can only be installed on Visual Studio 2010.
+
+- [EF 5.x DbContext Generator for C#](https://visualstudiogallery.msdn.microsoft.com/da740968-02f9-42a9-9ee4-1a9a06d896a2)
+- [EF 5.x DbContext Generator for C# Web Sites](https://visualstudiogallery.msdn.microsoft.com/5d01a981-91b8-492c-b42c-c771c3f31e03)
+- [EF 5.x DbContext Generator for VB.NET](https://visualstudiogallery.msdn.microsoft.com/875c882d-333e-455a-8dae-5353510527dd?src=featured)
+- [EF 5.x DbContext Generator for VB.NET Web Sites](https://visualstudiogallery.msdn.microsoft.com/d4d7d4cd-c2d0-43e6-8944-12f6ff8f2614)
+
+#### DbContext Generator for EF 4.x
+
+If you are using an older version of the EntityFramework NuGet package (one with a major version of 4) you will need to use the **EF 4.x DbContext Generator** template. This can be found in the **Online** tab when adding the template, or you can install the template directly from Visual Studio Gallery ahead of time.
+
+- [EF 4.x DbContext Generator for C#](https://visualstudiogallery.msdn.microsoft.com/7812b04c-db36-4817-8a84-e73c452410a2)
+- [EF 4.x DbContext Generator for C# Web Sites](https://visualstudiogallery.msdn.microsoft.com/de0e9bc6-e86a-4448-8a2e-a1260a53203e)
+- [EF 4.x DbContext Generator for VB.NET](https://visualstudiogallery.msdn.microsoft.com/73679ae5-e358-4e76-a538-c7b5e04ac073)
+- [EF 4.x DbContext Generator for VB.NET Web Sites](https://visualstudiogallery.msdn.microsoft.com/86f5a660-306e-4831-840c-2e4ee7474a92)
+
+### EntityObject Generator
+
+This template will generate entity classes that derive from EntityObject and a context that derives from ObjectContext.
+
+> [!NOTE]
+> Consider using the DbContext Generator
+
+The DbContext Generator is now the recommended template for new applications. The DbContext Generator takes advantage of the simpler DbContext API. The EntityObject Generator continues to be available to support existing applications.
+
+**Visual Studio 2010, 2012 &amp; 2013**
+
+You will need to select the **Online** tab when adding the template to download it from Visual Studio Gallery. Alternatively you can install the template directly from Visual Studio Gallery ahead of time.
+
+- [EF 6.x EntityObject Generator for C#](https://visualstudiogallery.msdn.microsoft.com/66612113-549c-4a9e-a14a-f629ceb3f89a)
+- [EF 6.x EntityObject Generator for C# Web Sites](https://visualstudiogallery.msdn.microsoft.com/076140f3-6dbe-451f-a0e0-16b6d2bd8996)
+- [EF 6.x EntityObject Generator for VB.NET](https://visualstudiogallery.msdn.microsoft.com/ff479d55-2c85-43c5-a4d6-21cd659435ea)
+- [EF 6.x EntityObject Generator for VB.NET Web Sites](https://visualstudiogallery.msdn.microsoft.com/668e2b92-c142-4da2-8e60-866c6346fc6a)
+
+**EntityObject Generator for EF 5.x**
+
+
+If you are using Visual Studio 2012 or 2013 you will need to select the **Online** tab when adding the template to download it from Visual Studio Gallery. Alternatively you can install the template directly from Visual Studio Gallery ahead of time. Because the templates are included in Visual Studio 2010 the versions on the gallery can only be installed on Visual Studio 2012 &amp; 2013.
+
+- [EF 5.x EntityObject Generator for C#](https://visualstudiogallery.msdn.microsoft.com/1da40393-b5ec-404a-a000-6a7e6e911339)
+- [EF 5.x EntityObject Generator for C# Web Sites](https://visualstudiogallery.msdn.microsoft.com/94b48556-fcf0-4b9b-8615-20f9066ae9ac)
+- [EF 5.x EntityObject Generator for VB.NET](https://visualstudiogallery.msdn.microsoft.com/92c0129e-40dc-488c-a836-7e30846dfb30)
+- [EF 5.x EntityObject Generator for VB.NET Web Sites](https://visualstudiogallery.msdn.microsoft.com/5dd7f75c-8c98-4eb7-b4bc-06f0d0b03b41)
+
+If you just want ObjectContext code generation without needing to edit the template you can [revert to EntityObject code generation](xref:ef6/modeling/designer/codegen/legacy-objectcontext).
+
+If you are using Visual Studio 2010 this template is already installed. If you create a new model in Visual Studio 2010 this template is used by default but the .tt files are not included in your project. If you want to customize the template you will need to add it to your project.
+
+### Self-Tracking Entities (STE) Generator
+
+This template will generate Self-Tracking Entity classes and a context that derives from ObjectContext. In an EF application, a context is responsible for tracking changes in the entities. However, in N-Tier scenarios, the context might not be available on the tier that modifies the entities. Self-tracking entities help you track changes in any tier. For more information, see [Self-Tracking Entities](xref:ef6/fundamentals/disconnected-entities/self-tracking-entities/index).
+
+> [!NOTE]
+> STE Template Not Recommended
+
+We no longer recommend using the STE template in new applications, it continues to be available to support existing applications. Visit the [disconnected entities article](xref:ef6/fundamentals/disconnected-entities/index) for other options we recommend for N-Tier scenarios.
+
+> [!NOTE]
+> There is no EF 6.x version of the STE template.
+
+
+> [!NOTE]
+> There is no Visual Studio 2013 version of the STE template.
+
+### Visual Studio 2012
+
+If you are using Visual Studio 2012 you will need to select the **Online** tab when adding the template to download it from Visual Studio Gallery. Alternatively you can install the template directly from Visual Studio Gallery ahead of time. Because the templates are included in Visual Studio 2010 the versions on the gallery can only be installed on Visual Studio 2012.
+
+- [EF 5.x STE Generator for C#](https://visualstudiogallery.msdn.microsoft.com/a3ac10a5-9365-4096-bb58-d9a1ba71db8f)
+- [EF 5.x STE Generator for C# Web Sites](https://visualstudiogallery.msdn.microsoft.com/1b55ab82-eeb4-47ba-8d35-3c7c8b5f5a8c)
+- [EF 5.x STE Generator for VB.NET](https://visualstudiogallery.msdn.microsoft.com/1ba8c6a3-44e9-4e1f-b21e-596f3168474b)
+- [EF 5.x STE Generator for VB.NET Web Sites](https://visualstudiogallery.msdn.microsoft.com/a9fd5f0a-9af4-4e32-9c09-0e057072152e)
+
+#### Visual Studio 2010**
+
+If you are using Visual Studio 2010 this template is already installed.
+
+### POCO Entity Generator
+
+This template will generate POCO entity classes and a context that derives from ObjectContext
+
+> [!NOTE]
+> Consider using the DbContext Generator
+
+The DbContext Generator is now the recommended template for generating POCO classes in new applications. The DbContext Generator takes advantage of the new DbContext API and can generate simpler POCO classes. The POCO Entity Generator continues to be available to support existing applications.
+
+> [!NOTE]
+> There is no EF 5.x or EF 6.x version of the STE template.
+
+> [!NOTE]
+> There is no Visual Studio 2013 version of the POCO template.
+
+#### Visual Studio 2012 &amp; Visual Studio 2010
+
+You will need to select the **Online** tab when adding the template to download it from Visual Studio Gallery. Alternatively you can install the template directly from Visual Studio Gallery ahead of time.
+
+- [EF 4.x POCO Generator for C#](https://visualstudiogallery.msdn.microsoft.com/23df0450-5677-4926-96cc-173d02752313)
+- [EF 4.x POCO Generator for C# Web Sites](https://visualstudiogallery.msdn.microsoft.com/fe568da5-aa1a-4178-a2a5-48813c707a7f)
+- [EF 4.x POCO Generator for VB.NET](https://visualstudiogallery.msdn.microsoft.com/53ecbded-8936-4299-ab04-1e44e5489752)
+- [EF 4.x POCO Generator for VB.NET Web Sites](https://visualstudiogallery.msdn.microsoft.com/463c5aca-05ad-4cdb-910b-2e4f83269e34)
+
+### What are the "Web Sites" Templates
+
+The "Web Sites" templates (for example, **EF 5.x DbContext Generator for C\# Web Sites**) are for use in Web Site projects created via **File -&gt; New -&gt; Web Site...**. These are different from Web Applications, created via **File -&gt; New -&gt; Project...**, which use the standard templates. We provide separate templates because the item template system in Visual Studio requires them.
+
+## Using a Template
+
+To start using a code generation template, right-click an empty spot on the design surface in the EF Designer and select **Add Code Generation Item...**.
+
+![Add Code Gen Item](~/ef6/media/add-code-gen-item.png)
+
+If you've already installed the template you want to use (or it was included in Visual Studio), then it will be available under either the **Code** or **Data** section from the left menu.
+
+![Installed Template](~/ef6/media/installed.png)
+
+If you don't already have the template installed, select **Online** from the left menu and search for the template you want.
+
+![Search Template](~/ef6/media/search.png) 
+
+If you are using Visual Studio 2012, the new .tt files will be nested under the .edmx file.*
+
+> [!NOTE]
+> For models created in Visual Studio 2012 you will need to delete the templates used for default code generation, otherwise you will have duplicate classes and context generated. The default files are **&lt;model name&gt;.tt** and **&lt;model name&gt;.context.tt**. 
+
+![VS2012 Templates](~/ef6/media/vs2012-templates.png)
+
+If you are using Visual Studio 2010, the tt files are added directly to your project.  
+
+![VS2010 Templates](~/ef6/media/vs2010-templates.png)
diff --git a/entity-framework/ef6/modeling/designer/codegen/legacy-objectcontext.md b/entity-framework/ef6/modeling/designer/codegen/legacy-objectcontext.md
new file mode 100644
index 0000000000..061d21367a
--- /dev/null
+++ b/entity-framework/ef6/modeling/designer/codegen/legacy-objectcontext.md
@@ -0,0 +1,33 @@
+---
+title: Reverting to ObjectContext in Entity Framework Designer - EF6
+description: Reverting to ObjectContext in Entity Framework Designer in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/designer/codegen/legacy-objectcontext
+---
+# Reverting to ObjectContext in Entity Framework Designer
+With previous version of Entity Framework a model created with the EF Designer would generate a context that derived from ObjectContext and entity classes that derived from EntityObject.
+
+Starting with EF4.1 we recommended swapping to a code generation template that generates a context deriving from DbContext and POCO entity classes.
+
+In Visual Studio 2012 you get DbContext code generated by default for all new models created with the EF Designer. Existing models will continue to generate ObjectContext based code unless you decide to swap to the DbContext based code generator.
+
+## Reverting Back to ObjectContext Code Generation
+
+### 1. Disable DbContext Code Generation
+
+Generation of the derived DbContext and POCO classes is handled by two .tt files in you project, if you expand the .edmx file in solution explorer you will see these files. Delete both of these files from your project.
+
+![Code Gen Files](~/ef6/media/codegenfiles.png)
+
+If you are using VB.NET you will need to select the **Show All Files** button to see the nested files.
+
+![Show All Files](~/ef6/media/showallfiles.png)
+
+### 2. Re-Enable ObjectContext Code Generation
+
+Open you model in the EF Designer, right-click on a blank section of the design surface and select **Properties**.
+
+In the Properties window change the **Code Generation Strategy** from **None** to **Default**.
+
+![Code Gen Strategy](~/ef6/media/codegenstrategy.png)
diff --git a/entity-framework/ef6/modeling/designer/data-types/complex-types.md b/entity-framework/ef6/modeling/designer/data-types/complex-types.md
new file mode 100644
index 0000000000..e4b18fdadd
--- /dev/null
+++ b/entity-framework/ef6/modeling/designer/data-types/complex-types.md
@@ -0,0 +1,166 @@
+---
+title: Complex Types - EF Designer - EF6
+description: Complex Types - EF Designer in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/designer/data-types/complex-types
+---
+# Complex Types - EF Designer
+This topic shows how to map complex types with the Entity Framework Designer (EF Designer) and how to query for entities that contain properties of complex type.
+
+The following image shows the main windows that are used when working with the EF Designer.
+
+![EF Designer](~/ef6/media/efdesigner.png)
+
+> [!NOTE]
+> When you build the conceptual model, warnings about unmapped entities and associations may appear in the Error List. You can ignore these warnings because after you choose to generate the database from the model, the errors will go away.
+
+## What is a Complex Type
+
+Complex types are non-scalar properties of entity types that enable scalar properties to be organized within entities. Like entities, complex types consist of scalar properties or other complex type properties.
+
+When you work with objects that represent complex types, be aware of the following:
+
+-   Complex types do not have keys and therefore cannot exist independently. Complex types can only exist as properties of entity types or other complex types.
+-   Complex types cannot participate in associations and cannot contain navigation properties.
+-   Complex type properties cannot be **null**. An **InvalidOperationException **occurs when **DbContext.SaveChanges** is called and a null complex object is encountered. Scalar properties of complex objects can be **null**.
+-   Complex types cannot inherit from other complex types.
+-   You must define the complex type as a **class**. 
+-   EF detects changes to members on a complex type object when **DbContext.DetectChanges** is called. Entity Framework calls **DetectChanges** automatically when the following members are called: **DbSet.Find**, **DbSet.Local**, **DbSet.Remove**, **DbSet.Add**, **DbSet.Attach**, **DbContext.SaveChanges**, **DbContext.GetValidationErrors**, **DbContext.Entry**, **DbChangeTracker.Entries**.
+
+## Refactor an Entity’s Properties into New Complex Type
+
+If you already have an entity in your conceptual model you may want to refactor some of the properties into a complex type property.
+
+On the designer surface, select one or more properties (excluding navigation properties) of an entity, then right-click and select **Refactor -&gt; Move to New Complex Type**.
+
+![Refactor Into New Complex Type](~/ef6/media/refactor.png)
+
+A new complex type with the selected properties is added to the **Model Browser**. The complex type is given a default name.
+
+A complex property of the newly created type replaces the selected properties. All property mappings are preserved.
+
+![Refactor Into New Complex Type 2](~/ef6/media/refactor2.png)
+
+## Create a New Complex Type
+
+You can also create a new complex type that does not contain properties of an existing entity.
+
+Right-click the **Complex Types** folder in the Model Browser, point to **AddNew Complex Type…**. Alternatively, you can select the **Complex Types** folder and press the **Insert** key on your keyboard.
+
+![Add New Complex type](~/ef6/media/addnewcomplextype.png)
+
+A new complex type is added to the folder with a default name. You can now add properties to the type.
+
+## Add Properties to a Complex Type
+
+Properties of a complex type can be scalar types or existing complex types. However, complex type properties cannot have circular references. For example, a complex type **OnsiteCourseDetails** cannot have a property of complex type **OnsiteCourseDetails**.
+
+You can add a property to a complex type in any of the ways listed below.
+
+-   Right-click a complex type in the Model Browser, point to **Add**, then point to **Scalar Property** or **Complex Property**, then select the desired property type. Alternatively, you can select a complex type and then press the **Insert** key on your keyboard.  
+
+    ![Add Properties to Complex Type](~/ef6/media/addpropertiestocomplextype.png)
+
+    A new property is added to the complex type with a default name.
+
+- OR -
+
+-   Right-click an entity property on the **EF  Designer** surface and select **Copy**, then right-click the complex type in the **Model Browser** and select **Paste**.
+
+## Rename a Complex Type
+
+When you rename a complex type, all references to the type are updated throughout the project.
+
+-   Slowly double-click a complex type in the **Model Browser**.
+    The name will be selected and in edit mode.
+
+- OR -
+
+-   Right-click a complex type in the **Model Browser** and select **Rename**.
+
+- OR -
+
+-   Select a complex type in the Model Browser and press the F2 key.
+
+- OR -
+
+-   Right-click a complex type in the **Model Browser** and select **Properties**. Edit the name in the **Properties** window.
+
+## Add an Existing Complex Type to an Entity and Map its Properties to Table Columns
+
+1.  Right-click an entity, point to **Add New**, and select **Complex Property**.
+    A complex type property with a default name is added to the entity. A default type (chosen from the existing complex types) is assigned to the property.
+2.  Assign the desired type to the property in the **Properties** window.
+    After adding a complex type property to an entity, you must map its properties to table columns.
+3.  Right-click an entity type on the design surface or in the **Model Browser** and select **Table Mappings**.
+    The table mappings are displayed in the **Mapping Details** window.
+4.  Expand the **Maps to &lt;Table Name&gt;** node.
+    A **Column Mappings** node appears.
+5.  Expand the **Column Mappings** node.
+    A list of all the columns in the table appears. The default properties (if any) to which the columns map are listed under the **Value/Property** heading.
+6.  Select the column you want to map, and then right-click the corresponding **Value/Property** field.
+    A drop-down list of all the scalar properties is displayed.
+7.  Select the appropriate property.
+
+    ![Map Complex Type](~/ef6/media/mapcomplextype.png)
+
+8.  Repeat steps 6 and 7 for each table column.
+
+>[!NOTE]
+> To delete a column mapping, select the column that you want to map, and then click the **Value/Property** field. Then, select **Delete** from the drop-down list.
+
+## Map a Function Import to a Complex Type
+
+Function imports are based on stored procedures. To map a function import to a complex type, the columns returned by the corresponding stored procedure must match the properties of the complex type in number and must have storage types that are compatible with the property types.
+
+-   Double-click on an imported function that you want to map to a complex type.
+
+    ![Function Imports](~/ef6/media/functionimports.png)
+
+-   Fill in the settings for the new function import, as follows:
+    -   Specify the stored procedure for which you are creating a function import in the **Stored Procedure Name** field. This field is a drop-down list that displays all the stored procedures in the storage model.
+    -   Specify the name of the function import in the **Function Import Name** field.
+    -   Select **Complex** as the return type and then specify the specific complex return type by choosing the appropriate type from the drop-down list.
+
+        ![Edit Function Import](~/ef6/media/editfunctionimport.png)
+
+-   Click **OK**.
+    The function import entry is created in the conceptual model.
+
+### Customize Column Mapping for Function Import
+
+-   Right-click the function import in the Model Browser and select **Function Import Mapping**.
+    The **Mapping Details** window appears and shows the default mapping for the function import. Arrows indicate the mappings between column values and property values. By default, the column names are assumed to be the same as the complex type's property names. The default column names appear in gray text.
+-   If necessary, change the column names to match the column names that are returned by the stored procedure that corresponds to the function import.
+
+## Delete a Complex Type
+
+When you delete a complex type, the type is deleted from the conceptual model and mappings for all instances of the type are deleted. However, references to the type are not updated. For example, if an entity has a complex type property of type ComplexType1 and ComplexType1 is deleted in the **Model Browser**, the corresponding entity property is not updated. The model will not validate  because it contains an entity that references a deleted complex type. You can update or delete references to deleted complex types by using the Entity Designer.
+
+-   Right-click a complex type in the Model Browser and select **Delete**.
+
+- OR -
+
+-   Select a complex type in the Model Browser and press the Delete key on your keyboard.
+
+## Query for Entities Containing Properties of Complex Type
+
+The following code shows how to execute a query that returns a collection of entity type objects that contain a complex type property.
+
+``` csharp
+    using (SchoolEntities context = new SchoolEntities())
+    {
+        var courses =
+            from c in context.OnsiteCourses
+            order by c.Details.Time
+            select c;
+
+        foreach (var c in courses)
+        {
+            Console.WriteLine("Time: " + c.Details.Time);
+            Console.WriteLine("Days: " + c.Details.Days);
+            Console.WriteLine("Location: " + c.Details.Location);
+        }
+    }
+```
diff --git a/entity-framework/ef6/modeling/designer/data-types/enums.md b/entity-framework/ef6/modeling/designer/data-types/enums.md
new file mode 100644
index 0000000000..467ca9ede2
--- /dev/null
+++ b/entity-framework/ef6/modeling/designer/data-types/enums.md
@@ -0,0 +1,143 @@
+---
+title: Enum Support - EF Designer - EF6
+description: Enum Support - EF Designer in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/designer/data-types/enums
+---
+# Enum Support - EF Designer
+> [!NOTE]
+> **EF5 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 5. If you are using an earlier version, some or all of the information does not apply.
+
+This video and step-by-step walkthrough shows how to use enum types with the Entity Framework Designer. It also demonstrates how to use enums in a LINQ query.
+
+This walkthrough will use Model First to create a new database, but the EF Designer can also be used with the [Database First](xref:ef6/modeling/designer/workflows/database-first) workflow to map to an existing database.
+
+Enum support was introduced in Entity Framework 5. To use the new features like enums, spatial data types, and table-valued functions, you must target .NET Framework 4.5. Visual Studio 2012 targets .NET 4.5 by default.
+
+In Entity Framework, an enumeration can have the following underlying types: **Byte**, **Int16**, **Int32**, **Int64** , or **SByte**.
+
+## Watch the Video
+This video shows how to use enum types with the Entity Framework Designer. It also demonstrates how to use enums in a LINQ query.
+
+**Presented By**: Julia Kornich
+
+**Video**: [WMV](https://download.microsoft.com/download/0/7/A/07ADECC9-7893-415D-9F20-8B97D46A37EC/HDI-ITPro-MSDN-winvideo-enumwithdesiger.wmv) | [MP4](https://download.microsoft.com/download/0/7/A/07ADECC9-7893-415D-9F20-8B97D46A37EC/HDI-ITPro-MSDN-mp4video-enumwithdesiger.m4v) | [WMV (ZIP)](https://download.microsoft.com/download/0/7/A/07ADECC9-7893-415D-9F20-8B97D46A37EC/HDI-ITPro-MSDN-winvideo-enumwithdesiger.zip)
+
+## Pre-Requisites
+
+You will need to have Visual Studio 2012, Ultimate, Premium, Professional, or Web Express edition installed to complete this walkthrough.
+
+## Set up the Project
+
+1.  Open Visual Studio 2012
+2.  On the **File** menu, point to **New**, and then click **Project**
+3.  In the left pane, click **Visual C\#**, and then select the **Console** template
+4.  Enter **EnumEFDesigner** as the name of the project and click **OK**
+
+## Create a New Model using the EF Designer
+
+1.  Right-click the project name in Solution Explorer, point to **Add**, and then click **New Item**
+2.  Select **Data** from the left menu and then select **ADO.NET Entity Data Model** in the Templates pane
+3.  Enter **EnumTestModel.edmx** for the file name, and then click **Add**
+4.  On the Entity Data Model Wizard page, select **Empty Model** in the Choose Model Contents dialog box
+5.  Click **Finish**
+
+The Entity Designer, which provides a design surface for editing your model, is displayed.
+
+The wizard performs the following actions:
+
+-   Generates the EnumTestModel.edmx file that defines the conceptual model, the storage model, and the mapping between them. Sets the Metadata Artifact Processing property of the .edmx file to Embed in Output Assembly so the generated metadata files get embedded into the assembly.
+-   Adds a reference to the following assemblies: EntityFramework, System.ComponentModel.DataAnnotations, and System.Data.Entity.
+-   Creates EnumTestModel.tt and EnumTestModel.Context.tt files and adds them under the .edmx file. These T4 template files generate the code that defines the DbContext derived type and POCO types that map to the entities in the .edmx model.
+
+## Add a New Entity Type
+
+1.  Right-click an empty area of the design surface, select **Add -&gt; Entity**, the New Entity dialog box appears
+2.  Specify **Department** for the type name and specify **DepartmentID** for the key property name, leave the type as **Int32**
+3.  Click **OK**
+4.  Right-click the entity and select **Add New -&gt; Scalar Property**
+5.  Rename the new property to **Name**
+6.  Change the type of the new property to **Int32** (by default, the new property is of String type)
+    To change the type, open the Properties window and change the Type property to **Int32**
+7.  Add another scalar property and rename it to **Budget**, change the type to **Decimal**
+
+## Add an Enum Type
+
+1.  In the Entity Framework Designer, right-click the Name property, select **Convert to enum**
+
+    ![Convert To Enum](~/ef6/media/converttoenum.png)
+
+2.  In the **Add Enum** dialog box type **DepartmentNames** for the Enum Type Name, change the Underlying Type to **Int32**, and then add the following members to the type: English, Math, and Economics
+
+    ![Add Enum Type](~/ef6/media/addenumtype.png)
+
+3.  Press **OK**
+4.  Save the model and build the project
+    > [!NOTE]
+    > When you build, warnings about unmapped entities and associations may appear in the Error List. You can ignore these warnings because after we choose to generate the database from the model, the errors will go away.
+
+If you look at the Properties window, you will notice that the type of the Name property was changed to **DepartmentNames** and the newly added enum type was added to the list of types.
+
+If you switch to the Model Browser window, you will see that the type was also added to the Enum Types node.
+
+![Model Browser](~/ef6/media/modelbrowser.png)
+
+>[!NOTE]
+> You can also add new enum types from this window by clicking the right mouse button and selecting **Add Enum Type**. Once the type is created it will appear in the list of types and you would be able to associate with a property
+
+## Generate Database from Model
+
+Now we can generate a database that is based on the model.
+
+1.  Right-click an empty space on the Entity Designer surface and select **Generate Database from Model**
+2.  The Choose Your Data Connection Dialog Box of the Generate Database Wizard is displayed
+    Click the **New Connection** button
+    Specify **(localdb)\\mssqllocaldb** for the server name and **EnumTest** for the database and click **OK**
+3.  A dialog asking if you want to create a new database will pop up, click **Yes**.
+4.  Click **Next** and the Create Database Wizard generates data definition language (DDL) for creating a database
+    The generated DDL is displayed in the Summary and Settings Dialog Box
+    Note, that the DDL does not contain a definition for a table that maps to the enumeration type
+5.  Click **Finish**
+    Clicking Finish does not execute the DDL script.
+6.  The Create Database Wizard does the following:
+    Opens the **EnumTest.edmx.sql** in T-SQL Editor
+    Generates the store schema and mapping sections of the EDMX file
+    Adds connection string information to the App.config file
+7.  Click the right mouse button in T-SQL Editor and select **Execute**
+    The Connect to Server dialog appears, enter the connection information from step 2 and click **Connect**
+8.  To view the generated schema, right-click on the database name in SQL Server Object Explorer and select **Refresh**
+
+## Persist and Retrieve Data
+
+Open the Program.cs file where the Main method is defined. Add the following code into the Main function. The code adds a new Department object to the context. It then saves the data. The code also executes a LINQ query that returns a Department where the name is DepartmentNames.English.
+
+``` csharp
+using (var context = new EnumTestModelContainer())
+{
+    context.Departments.Add(new Department{ Name = DepartmentNames.English });
+
+    context.SaveChanges();
+
+    var department = (from d in context.Departments
+                        where d.Name == DepartmentNames.English
+                        select d).FirstOrDefault();
+
+    Console.WriteLine(
+        "DepartmentID: {0} and Name: {1}",
+        department.DepartmentID,  
+        department.Name);
+}
+```
+
+Compile and run the application. The program produces the following output:
+
+```console
+DepartmentID: 1 Name: English
+```
+
+To view data in the database, right-click on the database name in SQL Server Object Explorer and select **Refresh**. Then, click the right mouse button on the table and select **View Data**.
+
+## Summary
+
+In this walkthrough we looked at how to map enum types using the Entity Framework Designer and how to use enums in code. 
diff --git a/entity-framework/ef6/modeling/designer/data-types/spatial.md b/entity-framework/ef6/modeling/designer/data-types/spatial.md
new file mode 100644
index 0000000000..e224e7b238
--- /dev/null
+++ b/entity-framework/ef6/modeling/designer/data-types/spatial.md
@@ -0,0 +1,136 @@
+---
+title: Spatial - EF Designer - EF6
+description: Spatial - EF Designer in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/designer/data-types/spatial
+---
+# Spatial - EF Designer
+> [!NOTE]
+> **EF5 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 5. If you are using an earlier version, some or all of the information does not apply.
+
+The video and step-by-step walkthrough shows how to map spatial types with the Entity Framework Designer. It also demonstrates how to use a LINQ query to find a distance between two locations.
+
+This walkthrough will use Model First to create a new database, but the EF Designer can also be used with the [Database First](xref:ef6/modeling/designer/workflows/database-first) workflow to map to an existing database.
+
+Spatial type support was introduced in Entity Framework 5. Note that to use the new features like spatial type, enums, and Table-valued functions, you must target .NET Framework 4.5. Visual Studio 2012 targets .NET 4.5 by default.
+
+To use spatial data types you must also use an Entity Framework provider that has spatial support. See [provider support for spatial types](xref:ef6/fundamentals/providers/spatial-support) for more information.
+
+There are two main spatial data types: geography and geometry. The geography data type stores ellipsoidal data (for example, GPS latitude and longitude coordinates). The geometry data type represents Euclidean (flat) coordinate system.
+
+## Watch the video
+This video shows how to map spatial types with the Entity Framework Designer. It also demonstrates how to use a LINQ query to find a distance between two locations.
+
+**Presented By**: Julia Kornich
+
+**Video**: [WMV](https://download.microsoft.com/download/E/C/9/EC9E6547-8983-4C1F-A919-D33210E4B213/HDI-ITPro-MSDN-winvideo-spatialwithdesigner.wmv) | [MP4](https://download.microsoft.com/download/E/C/9/EC9E6547-8983-4C1F-A919-D33210E4B213/HDI-ITPro-MSDN-mp4video-spatialwithdesigner.m4v) | [WMV (ZIP)](https://download.microsoft.com/download/E/C/9/EC9E6547-8983-4C1F-A919-D33210E4B213/HDI-ITPro-MSDN-winvideo-spatialwithdesigner.zip)
+
+## Pre-Requisites
+
+You will need to have Visual Studio 2012, Ultimate, Premium, Professional, or Web Express edition installed to complete this walkthrough.
+
+## Set up the Project
+
+1.  Open Visual Studio 2012
+2.  On the **File** menu, point to **New**, and then click **Project**
+3.  In the left pane, click **Visual C\#**, and then select the **Console** template
+4.  Enter **SpatialEFDesigner** as the name of the project and click **OK**
+
+## Create a New Model using the EF Designer
+
+1.  Right-click the project name in Solution Explorer, point to **Add**, and then click **New Item**
+2.  Select **Data** from the left menu and then select **ADO.NET Entity Data Model** in the Templates pane
+3.  Enter **UniversityModel.edmx** for the file name, and then click **Add**
+4.  On the Entity Data Model Wizard page, select **Empty Model** in the Choose Model Contents dialog box
+5.  Click **Finish**
+
+The Entity Designer, which provides a design surface for editing your model, is displayed.
+
+The wizard performs the following actions:
+
+-   Generates the EnumTestModel.edmx file that defines the conceptual model, the storage model, and the mapping between them. Sets the Metadata Artifact Processing property of the .edmx file to Embed in Output Assembly so the generated metadata files get embedded into the assembly.
+-   Adds a reference to the following assemblies: EntityFramework, System.ComponentModel.DataAnnotations, and System.Data.Entity.
+-   Creates UniversityModel.tt and UniversityModel.Context.tt files and adds them under the .edmx file. These T4 template files generate the code that defines the DbContext derived type and POCO types that map to the entities in the .edmx model
+
+## Add a New Entity Type
+
+1.  Right-click an empty area of the design surface, select **Add -&gt; Entity**, the New Entity dialog box appears
+2.  Specify **University** for the type name and specify **UniversityID** for the key property name, leave the type as **Int32**
+3.  Click **OK**
+4.  Right-click the entity and select **Add New -&gt; Scalar Property**
+5.  Rename the new property to **Name**
+6.  Add another scalar property and rename it to **Location**
+    Open the Properties window and change the type of the new property to **Geography**
+7.  Save the model and build the project
+    > [!NOTE]
+    > When you build, warnings about unmapped entities and associations may appear in the Error List. You can ignore these warnings because after we choose to generate the database from the model, the errors will go away.
+
+## Generate Database from Model
+
+Now we can generate a database that is based on the model.
+
+1.  Right-click an empty space on the Entity Designer surface and select **Generate Database from Model**
+2.  The Choose Your Data Connection Dialog Box of the Generate Database Wizard is displayed
+    Click the **New Connection** button
+    Specify **(localdb)\\mssqllocaldb** for the server name and **University** for the database and click **OK**
+3.  A dialog asking if you want to create a new database will pop up, click **Yes**.
+4.  Click **Next** and the Create Database Wizard generates data definition language (DDL) for creating a database
+    The generated DDL is displayed in the Summary and Settings Dialog Box
+    Note, that the DDL does not contain a definition for a table that maps to the enumeration type
+5.  Click **Finish**
+    Clicking Finish does not execute the DDL script.
+6.  The Create Database Wizard does the following:
+    Opens the **UniversityModel.edmx.sql** in T-SQL Editor
+    Generates the store schema and mapping sections of the EDMX file
+    Adds connection string information to the App.config file
+7.  Click the right mouse button in T-SQL Editor and select **Execute**
+    The Connect to Server dialog appears, enter the connection information from step 2 and click **Connect**
+8.  To view the generated schema, right-click on the database name in SQL Server Object Explorer and select **Refresh**
+
+## Persist and Retrieve Data
+
+Open the Program.cs file where the Main method is defined. Add the following code into the Main function.
+
+The code adds two new University objects to the context. Spatial properties are initialized by using the DbGeography.FromText method. The geography point represented as WellKnownText is passed to the method. The code then saves the data. Then, the LINQ query that that returns a University object where its location is closest to the specified location, is constructed and executed.
+
+``` csharp
+using (var context = new UniversityModelContainer())
+{
+    context.Universities.Add(new University()
+    {
+        Name = "Graphic Design Institute",
+        Location = DbGeography.FromText("POINT(-122.336106 47.605049)"),
+    });
+
+    context.Universities.Add(new University()
+    {
+        Name = "School of Fine Art",
+        Location = DbGeography.FromText("POINT(-122.335197 47.646711)"),
+    });
+
+    context.SaveChanges();
+
+    var myLocation = DbGeography.FromText("POINT(-122.296623 47.640405)");
+
+    var university = (from u in context.Universities
+                                orderby u.Location.Distance(myLocation)
+                                select u).FirstOrDefault();
+
+    Console.WriteLine(
+        "The closest University to you is: {0}.",
+        university.Name);
+}
+```
+
+Compile and run the application. The program produces the following output:
+
+```console
+The closest University to you is: School of Fine Art.
+```
+
+To view data in the database, right-click on the database name in SQL Server Object Explorer and select **Refresh**. Then, click the right mouse button on the table and select **View Data**.
+
+## Summary
+
+In this walkthrough we looked at how to map spatial types using the Entity Framework Designer and how to use spatial types in code. 
diff --git a/entity-framework/ef6/modeling/designer/entity-splitting.md b/entity-framework/ef6/modeling/designer/entity-splitting.md
new file mode 100644
index 0000000000..adde5f4ad6
--- /dev/null
+++ b/entity-framework/ef6/modeling/designer/entity-splitting.md
@@ -0,0 +1,139 @@
+---
+title: Designer Entity Splitting - EF6
+description: Designer Entity Splitting in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/designer/entity-splitting
+---
+# Designer Entity Splitting
+This walkthrough shows how to map an entity type to two tables by modifying a model with the Entity Framework Designer (EF Designer). You can map an entity to multiple tables when the tables share a common key. The concepts that apply to mapping an entity type to two tables are easily extended to mapping an entity type to more than two tables.
+
+The following image shows the main windows that are used when working with the EF Designer.
+
+![EF Designer](~/ef6/media/efdesigner.png)
+
+## Prerequisites
+
+Visual Studio 2012 or Visual Studio 2010, Ultimate, Premium, Professional, or Web Express edition.
+
+## Create the Database
+
+The database server that is installed with Visual Studio is different depending on the version of Visual Studio you have installed:
+
+-   If you are using Visual Studio 2012 then you'll be creating a LocalDB database.
+-   If you are using Visual Studio 2010 you'll be creating a SQL Express database.
+
+First we'll create a database with two tables that we are going to combine into a single entity.
+
+-   Open Visual Studio
+-   **View -&gt; Server Explorer**
+-   Right click on **Data Connections -&gt; Add Connection…**
+-   If you haven’t connected to a database from Server Explorer before you’ll need to select **Microsoft SQL Server** as the data source
+-   Connect to either LocalDB or SQL Express, depending on which one you have installed
+-   Enter **EntitySplitting** as the database name
+-   Select **OK** and you will be asked if you want to create a new database, select **Yes**
+-   The new database will now appear in Server Explorer
+-   If you are using Visual Studio 2012
+    -   Right-click on the database in Server Explorer and select **New Query**
+    -   Copy the following SQL into the new query, then right-click on the query and select **Execute**
+-   If you are using Visual Studio 2010
+    -   Select **Data -&gt; Transact SQL Editor -&gt; New Query Connection...**
+    -   Enter **.\\SQLEXPRESS** as the server name and click **OK**
+    -   Select the **EntitySplitting** database from the drop down at the top of the query editor
+    -   Copy the following SQL into the new query, then right-click on the query and select **Execute SQL**
+
+``` SQL
+CREATE TABLE [dbo].[Person] (
+[PersonId] INT IDENTITY (1, 1) NOT NULL,
+[FirstName] NVARCHAR (200) NULL,
+[LastName] NVARCHAR (200) NULL,
+CONSTRAINT [PK_Person] PRIMARY KEY CLUSTERED ([PersonId] ASC)
+);
+
+CREATE TABLE [dbo].[PersonInfo] (
+[PersonId] INT NOT NULL,
+[Email] NVARCHAR (200) NULL,
+[Phone] NVARCHAR (50) NULL,
+CONSTRAINT [PK_PersonInfo] PRIMARY KEY CLUSTERED ([PersonId] ASC),
+CONSTRAINT [FK_Person_PersonInfo] FOREIGN KEY ([PersonId]) REFERENCES [dbo].[Person] ([PersonId]) ON DELETE CASCADE
+);
+```
+
+## Create the Project
+
+-   On the **File** menu, point to **New**, and then click **Project**.
+-   In the left pane, click **Visual C\#**, and then select the **Console Application** template.
+-   Enter **MapEntityToTablesSample** as the name of the project and click **OK**.
+-   Click **No** if prompted to save the SQL query created in the first section.
+
+## Create a Model based on the Database
+
+-   Right-click the project name in Solution Explorer, point to **Add**, and then click **New Item**.
+-   Select **Data** from the left menu and then select **ADO.NET Entity Data Model** in the Templates pane.
+-   Enter **MapEntityToTablesModel.edmx** for the file name, and then click **Add**.
+-   In the Choose Model Contents dialog box, select **Generate from database**, and then click **Next.**
+-   Select the **EntitySplitting** connection from the drop down and click **Next**.
+-   In the Choose Your Database Objects dialog box, check the box next to the **Tables** node.
+    This will add all the tables from the **EntitySplitting** database to the model.
+-   Click **Finish**.
+
+The Entity Designer, which provides a design surface for editing your model, is displayed.
+
+## Map an Entity to Two Tables
+
+In this step we will update the **Person** entity type to combine data from the **Person** and **PersonInfo** tables.
+
+-   Select the **Email** and **Phone** properties of the **PersonInfo **entity and press **Ctrl+X** keys.
+-   Select the **Person **entity and press **Ctrl+V** keys.
+-   On the design surface, select the **PersonInfo** entity and press **Delete** button on the keyboard.
+-   Click **No** when asked if you want to remove the **PersonInfo** table from the model, we are about to map it to the **Person** entity.
+
+    ![Delete  Tables](~/ef6/media/deletetables.png)
+
+The next steps require the **Mapping Details** window. If you cannot see this window, right-click the design surface and select **Mapping Details**.
+
+-   Select the **Person** entity type and click **&lt;Add a Table or View&gt;** in the **Mapping Details** window.
+-   Select **PersonInfo ** from the drop-down list.
+    The **Mapping Details** window is updated with default column mappings, these are fine for our scenario.
+
+The **Person** entity type is now mapped to the **Person** and **PersonInfo** tables.
+
+![Mapping 2](~/ef6/media/mapping2.png)
+
+## Use the Model
+
+-   Paste the following code in the Main method.
+
+``` csharp
+    using (var context = new EntitySplittingEntities())
+    {
+        var person = new Person
+        {
+            FirstName = "John",
+            LastName = "Doe",
+            Email = "john@example.com",
+            Phone = "555-555-5555"
+        };
+
+        context.People.Add(person);
+        context.SaveChanges();
+
+        foreach (var item in context.People)
+        {
+            Console.WriteLine(item.FirstName);
+        }
+    }
+```
+
+-   Compile and run the application.
+
+The following T-SQL statements were executed against the database as a result of running this application. 
+
+-   The following two **INSERT** statements were executed as a result of executing context.SaveChanges(). They take the data from the **Person** entity and split it between the **Person** and **PersonInfo** tables.
+
+    ![Insert 1](~/ef6/media/insert1.png)
+
+    ![Insert 2](~/ef6/media/insert2.png)
+-   The following **SELECT** was executed as a result of enumerating the people in the database. It combines the data from the **Person** and **PersonInfo** table.
+
+    ![Select Combining Person and PersonInfo Data](~/ef6/media/select.png)
diff --git a/entity-framework/ef6/modeling/designer/inheritance/tph.md b/entity-framework/ef6/modeling/designer/inheritance/tph.md
new file mode 100644
index 0000000000..3601c8fbfb
--- /dev/null
+++ b/entity-framework/ef6/modeling/designer/inheritance/tph.md
@@ -0,0 +1,126 @@
+---
+title: Designer TPH Inheritance - EF6
+description: Designer TPH Inheritance in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/designer/inheritance/tph
+---
+# Designer TPH Inheritance
+This step-by-step walkthrough shows how to implement table-per-hierarchy (TPH) inheritance in your conceptual model with the Entity Framework Designer (EF Designer). TPH inheritance uses one database table to maintain data for all of the entity types in an inheritance hierarchy.
+
+In this walkthrough we will map the Person table to three entity types: Person (the base type), Student (derives from Person), and Instructor (derives from Person). We'll create a conceptual model from the database (Database First) and then alter the model to implement the TPH inheritance using the EF Designer.
+
+It is possible to map to a TPH inheritance using Model First but you would have to write your own database generation workflow which is complex. You would then assign this workflow to the **Database Generation Workflow** property in the EF Designer. An easier alternative is to use Code First.
+
+## Other Inheritance Options
+
+Table-per-Type (TPT) is another type of inheritance in which separate tables in the database are mapped to entities that participate in the inheritance.  For information about how to map Table-per-Type inheritance with the EF Designer, see [EF Designer TPT Inheritance](xref:ef6/modeling/designer/inheritance/tpt).
+
+Table-per-Concrete Type Inheritance (TPC) and mixed inheritance models are supported by the Entity Framework runtime but are not supported by the EF Designer. If you want to use TPC or mixed inheritance, you have two options: use Code First, or manually edit the EDMX file. If you choose to work with the EDMX file, the Mapping Details Window will be put into “safe mode” and you will not be able to use the designer to change the mappings.
+
+## Prerequisites
+
+To complete this walkthrough, you will need:
+
+- A recent version of Visual Studio.
+- The [School sample database](xref:ef6/resources/school-database).
+
+## Set up the Project
+
+-   Open Visual Studio 2012.
+-   Select **File-&gt; New -&gt; Project**
+-   In the left pane, click **Visual C\#**, and then select the **Console** template.
+-   Enter **TPHDBFirstSample** as the name.
+-   Select **OK**.
+
+## Create a Model
+
+-   Right-click the project name in Solution Explorer, and select **Add -&gt; New Item**.
+-   Select **Data** from the left menu and then select **ADO.NET Entity Data Model** in the Templates pane.
+-   Enter **TPHModel.edmx** for the file name, and then click **Add**.
+-   In the Choose Model Contents dialog box, select **Generate from database**, and then click **Next**.
+-   Click **New Connection**.
+    In the Connection Properties dialog box, enter the server name (for example, **(localdb)\\mssqllocaldb**), select the authentication method, type **School** for the database name, and then click **OK**.
+    The Choose Your Data Connection dialog box is updated with your database connection setting.
+-   In the Choose Your Database Objects dialog box, under the Tables node, select the **Person** table.
+-   Click **Finish**.
+
+The Entity Designer, which provides a design surface for editing your model, is displayed. All the objects that you selected in the Choose Your Database Objects dialog box are added to the model.
+
+That is how the **Person** table looks in the database.
+
+![Person Table](~/ef6/media/persontable.png) 
+
+## Implement Table-per-Hierarchy Inheritance
+
+The **Person** table has the **Discriminator** column, which can have one of two values: “Student” and “Instructor”. Depending on the value the **Person** table will be mapped to the **Student** entity or the **Instructor** entity. The **Person** table also has two columns, **HireDate** and **EnrollmentDate**, which must be **nullable** because a person cannot be a student and an instructor at the same time (at least not in this walkthrough).
+
+### Add new Entities
+
+-   Add a new entity.
+    To do this, right-click on an empty space of the design surface of the Entity Framework Designer, and select **Add-&gt;Entity**.
+-   Type **Instructor** for the **Entity name** and select **Person** from the drop-down list for the **Base type**.
+-   Click **OK**.
+-   Add another new entity. Type **Student** for the **Entity name** and select **Person** from the drop-down list for the **Base type**.
+
+Two new entity types were added to the design surface. An arrow points from the new entity types to the **Person** entity type; this indicates that **Person** is the base type for the new entity types.
+
+-   Right-click the **HireDate** property of the **Person** entity. Select **Cut** (or use the Ctrl-X key).
+-   Right-click the **Instructor** entity and select **Paste** (or use the Ctrl-V key).
+-   Right-click the **HireDate** property and select **Properties**.
+-   In the **Properties** window, set the **Nullable** property to **false**.
+-   Right-click the **EnrollmentDate** property of the **Person** entity. Select **Cut** (or use the Ctrl-X key).
+-   Right-click the **Student** entity and select **Paste(or use the Ctrl-V key).**
+-   Select the **EnrollmentDate** property and set the **Nullable** property to **false**.
+-   Select the **Person** entity type. In the **Properties** window, set its **Abstract** property to **true**.
+-   Delete the **Discriminator** property from **Person**. The reason it should be deleted is explained in the following section.
+
+### Map the entities
+
+-   Right-click the **Instructor** and select **Table Mapping.**
+    The Instructor entity is selected in the Mapping Details window.
+-   Click **&lt;Add a Table or View&gt;** in the **Mapping Details** window.
+    The **&lt;Add a Table or View&gt;** field becomes a drop-down list of tables or views to which the selected entity can be mapped.
+-   Select **Person** from the drop-down list.
+-   The **Mapping Details** window is updated with default column mappings and an option for adding a condition.
+-   Click on **&lt;Add a Condition&gt;**.
+    The **&lt;Add a Condition&gt;** field becomes a drop-down list of columns for which conditions can be set.
+-   Select **Discriminator** from the drop-down list.
+-   In the **Operator** column of the **Mapping Details** window, select = from the drop-down list.
+-   In the **Value/Property** column, type **Instructor**. The end result should look like this:
+
+    ![Mapping Details](~/ef6/media/mappingdetails2.png)
+
+-   Repeat these steps for the **Student** entity type, but make the condition equal to **Student** value.  
+    *The reason we wanted to remove the **Discriminator** property, is because you cannot map a table column more than once. This column will be used for conditional mapping, so it cannot be used for property mapping as well. The only way it can be used for both, if a condition uses an **Is Null** or **Is Not Null** comparison.*
+
+Table-per-hierarchy inheritance is now implemented.
+
+![Final TPH](~/ef6/media/finaltph.png)
+
+## Use the Model
+
+Open the **Program.cs** file where the **Main** method is defined. Paste the following code into the **Main** function. The code executes three queries. The first query brings back all **Person** objects. The second query uses the **OfType** method to return **Instructor** objects. The third query uses the **OfType** method to return **Student** objects.
+
+``` csharp
+    using (var context = new SchoolEntities())
+    {
+        Console.WriteLine("All people:");
+        foreach (var person in context.People)
+        {
+            Console.WriteLine("    {0} {1}", person.FirstName, person.LastName);
+        }
+
+        Console.WriteLine("Instructors only: ");
+        foreach (var person in context.People.OfType<Instructor>())
+        {
+            Console.WriteLine("    {0} {1}", person.FirstName, person.LastName);
+        }
+
+        Console.WriteLine("Students only: ");
+        foreach (var person in context.People.OfType<Student>())
+        {
+            Console.WriteLine("    {0} {1}", person.FirstName, person.LastName);
+        }
+    }
+```
diff --git a/entity-framework/ef6/modeling/designer/inheritance/tpt.md b/entity-framework/ef6/modeling/designer/inheritance/tpt.md
new file mode 100644
index 0000000000..8bba825ec6
--- /dev/null
+++ b/entity-framework/ef6/modeling/designer/inheritance/tpt.md
@@ -0,0 +1,100 @@
+---
+title: Designer TPT Inheritance - EF6
+description: Designer TPT Inheritance in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/designer/inheritance/tpt
+---
+# Designer TPT Inheritance
+This step-by-step walkthrough shows how to implement table-per-type (TPT) inheritance in your model using the Entity Framework Designer (EF Designer). Table-per-type inheritance uses a separate table in the database to maintain data for non-inherited properties and key properties for each type in the inheritance hierarchy.
+
+In this walkthrough we will map the **Course** (base type), **OnlineCourse** (derives from Course), and **OnsiteCourse** (derives from **Course**) entities to tables with the same names. We'll create a model from the database and then alter the model to implement the TPT inheritance.
+
+You can also start with the Model First and then generate the database from the model. The EF Designer uses the TPT strategy by default and so any inheritance in the model will be mapped to separate tables.
+
+## Other Inheritance Options
+
+Table-per-Hierarchy (TPH) is another type of inheritance in which one database table is used to maintain data for all of the entity types in an inheritance hierarchy.  For information about how to map Table-per-Hierarchy inheritance with the Entity Designer, see [EF Designer TPH Inheritance](xref:ef6/modeling/designer/inheritance/tph). 
+
+Note that, the Table-per-Concrete Type Inheritance (TPC) and mixed inheritance models are supported by the Entity Framework runtime but are not supported by the EF Designer. If you want to use TPC or mixed inheritance, you have two options: use Code First, or manually edit the EDMX file. If you choose to work with the EDMX file, the Mapping Details Window will be put into “safe mode” and you will not be able to use the designer to change the mappings.
+
+## Prerequisites
+
+To complete this walkthrough, you will need:
+
+- A recent version of Visual Studio.
+- The [School sample database](xref:ef6/resources/school-database).
+
+## Set up the Project
+
+-   Open Visual Studio 2012.
+-   Select **File-&gt; New -&gt; Project**
+-   In the left pane, click **Visual C\#**, and then select the **Console** template.
+-   Enter **TPTDBFirstSample** as the name.
+-   Select **OK**.
+
+## Create a Model
+
+-   Right-click the project in Solution Explorer, and select **Add -&gt; New Item**.
+-   Select **Data** from the left menu and then select **ADO.NET Entity Data Model** in the Templates pane.
+-   Enter **TPTModel.edmx** for the file name, and then click **Add**.
+-   In the Choose Model Contents dialog box, select** Generate from database**, and then click **Next**.
+-   Click **New Connection**.
+    In the Connection Properties dialog box, enter the server name (for example, **(localdb)\\mssqllocaldb**), select the authentication method, type **School** for the database name, and then click **OK**.
+    The Choose Your Data Connection dialog box is updated with your database connection setting.
+-   In the Choose Your Database Objects dialog box, under the Tables node, select the **Department**, **Course, OnlineCourse, and OnsiteCourse** tables.
+-   Click **Finish**.
+
+The Entity Designer, which provides a design surface for editing your model, is displayed. All the objects that you selected in the Choose Your Database Objects dialog box are added to the model.
+
+## Implement Table-per-Type Inheritance
+
+-   On the design surface, right-click the **OnlineCourse** entity type and select **Properties**.
+-   In the **Properties** window, set the Base Type property to **Course**.
+-   Right-click the **OnsiteCourse** entity type and select **Properties**.
+-   In the **Properties** window, set the Base Type property to **Course**.
+-   Right-click the association (the line) between the **OnlineCourse** and **Course** entity types.
+    Select **Delete from Model**.
+-   Right-click the association between the **OnsiteCourse** and **Course** entity types.
+    Select **Delete from Model**.
+
+We will now delete the **CourseID** property from **OnlineCourse** and **OnsiteCourse** because these classes inherit **CourseID** from the **Course** base type.
+
+-   Right-click the **CourseID** property of the **OnlineCourse** entity type, and then select **Delete from Model**.
+-   Right-click the **CourseID** property of the **OnsiteCourse** entity type, and then select **Delete from Model**
+-   Table-per-type inheritance is now implemented.
+
+![Table Per Type](~/ef6/media/tpt.png)
+
+## Use the Model
+
+Open the **Program.cs** file where the **Main** method is defined. Paste the following code into the **Main** function. The code executes three queries. The first query brings back all **Courses** related to the specified department. The second query uses the **OfType** method to return **OnlineCourses** related to the specified department. The third query returns **OnsiteCourses**.
+
+``` csharp
+    using (var context = new SchoolEntities())
+    {
+        foreach (var department in context.Departments)
+        {
+            Console.WriteLine("The {0} department has the following courses:",
+                               department.Name);
+
+            Console.WriteLine("   All courses");
+            foreach (var course in department.Courses )
+            {
+                Console.WriteLine("     {0}", course.Title);
+            }
+
+            foreach (var course in department.Courses.
+                OfType<OnlineCourse>())
+            {
+                Console.WriteLine("   Online - {0}", course.Title);
+            }
+
+            foreach (var course in department.Courses.
+                OfType<OnsiteCourse>())
+            {
+                Console.WriteLine("   Onsite - {0}", course.Title);
+            }
+        }
+    }
+```
diff --git a/entity-framework/ef6/modeling/designer/keyboard-shortcuts.md b/entity-framework/ef6/modeling/designer/keyboard-shortcuts.md
new file mode 100644
index 0000000000..8091d9b73d
--- /dev/null
+++ b/entity-framework/ef6/modeling/designer/keyboard-shortcuts.md
@@ -0,0 +1,203 @@
+---
+title: Entity Framework Designer Keyboard Shortcuts - EF6
+description: Entity Framework Designer Keyboard Shortcuts in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework Designer Keyboard Shortcuts
+This page provides a list of keyboard shorcuts that are available in the various screens of the Entity Framework Tools for Visual Studio.
+
+## ADO.NET Entity Data Model Wizard
+
+### Step One: Choose Model Contents
+
+![Wizard One](~/ef6/media/wizardone.png)
+
+| Shortcut  | Action                                                     | Notes                                               |
+|:----------|:-----------------------------------------------------------|:----------------------------------------------------|
+| **Alt+n** | Move to next screen                                        | Not available for all selections of model contents. |
+| **Alt+f** | Finish wizard                                              | Not available for all selections of model contents. |
+| **Alt+w** | Switch focus to the “What should the model contain?” pane. |                                                     |
+
+### Step Two: Choose Your Connection
+
+![Wizard Two](~/ef6/media/wizardtwo.png)
+
+| Shortcut  | Action                                                     | Notes                                                   |
+|:----------|:-----------------------------------------------------------|:--------------------------------------------------------|
+| **Alt+n** | Move to next screen                                        |                                                         |
+| **Alt+p** | Move to previous screen                                    |                                                         |
+| **Alt+w** | Switch focus to the “What should the model contain?” pane. |                                                         |
+| **Alt+c** | Open the “Connection Properties” window                    | Allows for the definition of a new database connection. |
+| **Alt+e** | Exclude sensitive data from the connection string          |                                                         |
+| **Alt+i** | Include sensitive data in the connection string            |                                                         |
+| **Alt+s** | Toggle the “Save connection settings in App.Config” option |                                                         |
+
+### Step Three: Choose Your Version
+
+![Wizard Three](~/ef6/media/wizardthree.png)
+
+| Shortcut  | Action                                             | Notes                                                                                 |
+|:----------|:---------------------------------------------------|:--------------------------------------------------------------------------------------|
+| **Alt+n** | Move to next screen                                |                                                                                       |
+| **Alt+p** | Move to previous screen                            |                                                                                       |
+| **Alt+w** | Switch focus to Entity Framework version selection | Allows for specifying a different version of Entity Framework for use in the project. |
+
+### Step Four: Choose Your Database Objects and Settings
+
+![Wizard Four](~/ef6/media/wizardfour.png)
+
+| Shortcut  | Action                                                                                    | Notes                                                               |
+|:----------|:------------------------------------------------------------------------------------------|:--------------------------------------------------------------------|
+| **Alt+f** | Finish wizard                                                                             |                                                                     |
+| **Alt+p** | Move to previous screen                                                                   |                                                                     |
+| **Alt+w** | Switch focus to database object selection pane                                            | Allows for specifying database objects to be reverse engineered.    |
+| **Alt+s** | Toggle the “Pluralize or singularize generated object names” option                       |                                                                     |
+| **Alt+k** | Toggle the “Include foreign key columns in the model” option                              | Not available for all selections of model contents.                 |
+| **Alt+i** | Toggle the “Import selected stored procedures and functions into the entity model” option | Not available for all selections of model contents.                 |
+| **Alt+m** | Switches focus to the “Model Namespace” text field                                        | Not available for all selections of model contents.                 |
+| **Space** | Toggle selection on element                                                               | If element has children, all child elements will be toggled as well |
+| **Left**  | Collapse child tree                                                                       |                                                                     |
+| **Right** | Expand child tree                                                                         |                                                                     |
+| **Up**    | Navigate to previous element in tree                                                      |                                                                     |
+| **Down**  | Navigate to next element in tree                                                          |                                                                     |
+
+## EF Designer Surface
+
+![Designer Surface](~/ef6/media/designersurface.png)
+
+| Shortcut                                                                                | Action                      | Notes                                                                                                                                                                                                                               |
+|:----------------------------------------------------------------------------------------|:----------------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Space/Enter**                                                                         | Toggle Selection            | Toggles selection on the object with focus.                                                                                                                                                                                         |
+| **Esc**                                                                                 | Cancel Selection            | Cancels the current selection.                                                                                                                                                                                                      |
+| **Ctrl + A**                                                                            | Select All                  | Selects all the shapes on the design surface.                                                                                                                                                                                       |
+| **Up arrow**                                                                            | Move up                     | Moves selected entity up one grid increment. <br/> If in a list, moves to the previous sibling subfield.                                                                                                                            |
+| **Down arrow**                                                                          | Move down                   | Moves selected entity down one grid increment. <br/> If in a list, moves to the next sibling subfield.                                                                                                                              |
+| **Left arrow**                                                                          | Move left                   | Moves selected entity left one grid increment. <br/> If in a list, moves to the previous sibling subfield.                                                                                                                          |
+| **Right arrow**                                                                         | Move right                  | Moves selected entity right one grid increment. <br/> If in a list, moves to the next sibling subfield.                                                                                                                             |
+| **Shift + left arrow**                                                                  | Size shape left             | Reduces the width of the selected entity by one grid increment.                                                                                                                                                                     |
+| **Shift + right arrow**                                                                 | Size shape right            | Increases the width of the selected entity by one grid increment.                                                                                                                                                                   |
+| **Home**                                                                                | First Peer                  | Moves focus and selection to the first object on the design surface at the same peer level.                                                                                                                                         |
+| **End**                                                                                 | Last Peer                   | Moves focus and selection to the last object on the design surface at the same peer level.                                                                                                                                          |
+| **Ctrl + Home**                                                                         | First Peer (focus)          | Same as first peer, but moves focus instead of moving focus and selection.                                                                                                                                                          |
+| **Ctrl + End**                                                                          | Last Peer (focus)           | Same as last peer, but moves focus instead of moving focus and selection.                                                                                                                                                           |
+| **Tab**                                                                                 | Next Peer                   | Moves focus and selection to the next object on the design surface at the same peer level.                                                                                                                                          |
+| **Shift+Tab**                                                                           | Previous Peer               | Moves focus and selection to the previous object on the design surface at the same peer level.                                                                                                                                      |
+| **Alt+Ctrl+Tab**                                                                        | Next Peer (focus)           | Same as next peer, but moves focus instead of moving focus and selection.                                                                                                                                                           |
+| **Alt+Ctrl+Shift+Tab**                                                                  | Previous Peer (focus)       | Same as previous peer, but moves focus instead of moving focus and selection.                                                                                                                                                       |
+| **&lt;**                                                                                | Ascend                      | Moves to the next object on the design surface one level higher in the hierarchy. If there are no shapes above this shape in the hierarchy (that is, the object is placed directly on the design surface), the diagram is selected. |
+| **&gt;**                                                                                | Descend                     | Moves to the next contained object on the design surface one level below this one in the hierarchy. If there are no contained object, this is a no-op.                                                                              |
+| **Ctrl + &lt;**                                                                         | Ascend (focus)              | Same as ascend command, but moves focus without selection.                                                                                                                                                                          |
+| **Ctrl + &gt;**                                                                         | Descend (focus)             | Same as descend command, but moves focus without selection.                                                                                                                                                                         |
+| **Shift + End**                                                                         | Follow to connected         | From an entity, moves to an entity which this entity is connected to.                                                                                                                                                               |
+| **Del**                                                                                 | Delete                      | Delete an object or connector from the diagram.                                                                                                                                                                                     |
+| **Ins**                                                                                 | Insert                      | Adds a new property to an entity when either the “Scalar Properties” compartment header or a property itself is selected.                                                                                                           |
+| **Pg Up**                                                                               | Scroll diagram up           | Scrolls the design surface up, in increments equal to 75% of the height of the currently visible design surface.                                                                                                                    |
+| **Pg Down**                                                                             | Scroll diagram down         | Scrolls the design surface down.                                                                                                                                                                                                    |
+| **Shift + Pg Down**                                                                     | Scroll diagram right        | Scrolls the design surface to the right.                                                                                                                                                                                            |
+| **Shift + Pg Up**                                                                       | Scroll diagram left         | Scrolls the design surface to the left.                                                                                                                                                                                             |
+| **F2**                                                                                  | Enter edit mode             | Standard keyboard shortcut for entering edit mode for a text control.                                                                                                                                                               |
+| **Shift + F10**                                                                         | Display shortcut menu       | Standard keyboard shortcut for displaying a selected item’s shortcut menu.                                                                                                                                                          |
+| **Control + Shift + Mouse Left Click**  <br/> **Control + Shift + MouseWheel forward**  | Semantic Zoom In            | Zooms in on the area of the Diagram View beneath the mouse pointer.                                                                                                                                                                 |
+| **Control + Shift + Mouse Right Click** <br/> **Control + Shift + MouseWheel backward** | Semantic Zoom Out           | Zooms out from the area of the Diagram View beneath the mouse pointer. It re-centers the diagram when you zoom out too far for the current diagram center.                                                                          |
+| **Control + Shift + '+'** <br/> **Control + MouseWheel forward**                        | Zoom In                     | Zooms in on the center of the Diagram View.                                                                                                                                                                                         |
+| **Control + Shift + '-'** <br/> **Control + MouseWheel backward**                       | Zoom Out                    | Zooms out from the clicked area of the Diagram View. It re-centers the diagram when you zoom out too far for the current diagram center.                                                                                            |
+| **Control + Shift + Draw a rectangle with the left mouse button down**                  | Zoom Area                   | Zooms in centered on the area that you've selected. When you hold down the Control + Shift keys, you'll see that the cursor changes to a magnifying glass, which allows you to define the area to zoom into.                        |
+| **Context Menu Key + ‘M’**                                                              | Open Mapping Details Window | Opens the Mapping Details window to edit mappings for selected entity                                                                                                                                                               |
+
+## Mapping Details Window
+
+![Mapping Details Shortcuts](~/ef6/media/mappingdetailsshortcuts.png)
+
+| Shortcut                  | Action         | Notes                                                                                                                                 |
+|:--------------------------|:---------------|:--------------------------------------------------------------------------------------------------------------------------------------|
+| **Tab**                   | Switch Context | Switches between the main window area and the toolbar on the left                                                                     |
+| **Arrow keys**            | Navigation     | Move up and down rows, or right and left across columns in the main window area. Move between the buttons in the toolbar on the left. |
+| **Enter** <br/> **Space** | Select         | Selects a button in the toolbar on the left.                                                                                          |
+| **Alt + Down Arrow**      | Open List      | Drop down a list if a cell is selected that has a drop down list.                                                                     |
+| **Enter**                 | List Select    | Selects an element in a drop down list.                                                                                               |
+| **Esc**                   | List Close     | Closes a drop down list.                                                                                                              |
+
+## Visual Studio Navigation
+
+Entity Framework also supplies a number of actions that can have custom keyboard shortcuts mapped (no shortcuts are mapped by default). To create these custom shortcuts, click on the Tools menu, then Options.  Under Environment, choose Keyboard.  Scroll down the list in the middle until you can select the desired command, enter the shortcut in the “Press shortcut keys” text box, and click Assign. The possible shortcuts are as follows:
+
+| Shortcut                                                                                       |
+|:-----------------------------------------------------------------------------------------------|
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Add.ComplexProperty.ComplexTypes**        |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.AddCodeGenerationItem**                   |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.AddFunctionImport**                       |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.AddNew.AddEnumType**                      |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.AddNew.Association**                      |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.AddNew.ComplexProperty**                  |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.AddNew.ComplexType**                      |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.AddNew.Entity**                           |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.AddNew.FunctionImport**                   |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.AddNew.Inheritance**                      |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.AddNew.NavigationProperty**               |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.AddNew.ScalarProperty**                   |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.AddNewDiagram**                           |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.AddtoDiagram**                            |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Close**                                   |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Collapse**                                |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.ConverttoEnum**                           |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Diagram.CollapseAll**                     |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Diagram.ExpandAll**                       |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Diagram.ExportasImage**                   |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Diagram.LayoutDiagram**                   |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Edit**                                    |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.EntityKey**                               |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Expand**                                  |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.FunctionImportMapping**                   |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.GenerateDatabasefromModel**               |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.GoToDefinition**                          |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Grid.ShowGrid**                           |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Grid.SnaptoGrid**                         |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.IncludeRelated**                          |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.MappingDetails**                          |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.ModelBrowser**                            |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.MoveDiagramstoSeparateFile**              |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.MoveProperties.Down**                     |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.MoveProperties.Down5**                    |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.MoveProperties.ToBottom**                 |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.MoveProperties.ToTop**                    |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.MoveProperties.Up**                       |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.MoveProperties.Up5**                      |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.MovetonewDiagram**                        |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Open**                                    |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Refactor.MovetoNewComplexType**           |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Refactor.Rename**                         |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.RemovefromDiagram**                       |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Rename**                                  |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.ScalarPropertyFormat.DisplayName**        |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.ScalarPropertyFormat.DisplayNameandType** |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Select.BaseType**                         |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Select.Entity**                           |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Select.Property**                         |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Select.Subtype**                          |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.SelectAll**                               |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.SelectAssociation**                       |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.ShowinDiagram**                           |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.ShowinModelBrowser**                      |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.StoredProcedureMapping**                  |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.TableMapping**                            |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.UpdateModelfromDatabase**                 |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Validate**                                |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Zoom.10**                                 |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Zoom.100**                                |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Zoom.125**                                |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Zoom.150**                                |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Zoom.200**                                |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Zoom.25**                                 |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Zoom.300**                                |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Zoom.33**                                 |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Zoom.400**                                |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Zoom.50**                                 |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Zoom.66**                                 |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Zoom.75**                                 |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Zoom.Custom**                             |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Zoom.ZoomIn**                             |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Zoom.ZoomOut**                            |
+| **OtherContextMenus.MicrosoftDataEntityDesignContext.Zoom.ZoomtoFit**                          |
+| **View.EntityDataModelBrowser**                                                                |
+| **View.EntityDataModelMappingDetails**                                                         |
diff --git a/entity-framework/ef6/modeling/designer/multiple-diagrams.md b/entity-framework/ef6/modeling/designer/multiple-diagrams.md
new file mode 100644
index 0000000000..4ce69d2d5a
--- /dev/null
+++ b/entity-framework/ef6/modeling/designer/multiple-diagrams.md
@@ -0,0 +1,77 @@
+---
+title: Multiple Diagrams per Model - EF6
+description: Multiple Diagrams per Model in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/designer/multiple-diagrams
+---
+# Multiple Diagrams per Model
+> [!NOTE]
+> **EF5 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 5. If you are using an earlier version, some or all of the information does not apply.
+
+This video and page shows how to split a model into multiple diagrams using the Entity Framework Designer (EF Designer). You might want to use this feature when your model becomes too large to view or edit.
+
+In earlier versions of the EF Designer you could only have one diagram per the EDMX file. Starting with Visual Studio 2012, you can use the EF Designer to split your EDMX file into multiple diagrams.
+
+## Watch the video
+This video shows how to split a model into multiple diagrams using the Entity Framework Designer (EF Designer). You might want to use this feature when your model becomes too large to view or edit.
+
+**Presented By**: Julia Kornich
+
+**Video**: [WMV](https://download.microsoft.com/download/5/C/2/5C2B52AB-5532-426F-B078-1E253341B5FA/HDI-ITPro-MSDN-winvideo-multiplediagrams.wmv) | [MP4](https://download.microsoft.com/download/5/C/2/5C2B52AB-5532-426F-B078-1E253341B5FA/HDI-ITPro-MSDN-mp4video-multiplediagrams.m4v) | [WMV (ZIP)](https://download.microsoft.com/download/5/C/2/5C2B52AB-5532-426F-B078-1E253341B5FA/HDI-ITPro-MSDN-winvideo-multiplediagrams.zip)
+
+## EF Designer Overview
+
+When you create a model using the EF Designer’s Entity Data Model Wizard, an .edmx file is created and added to your solution. This file defines the shape of your entities and how they map to the database.
+
+The EF Designer consists of the following components:
+
+-   A visual design surface for editing the model. You can create, modify, or delete entities and associations.
+-   A **Model Browser** window that provides tree views of the model.  The entities and their associations are located under the *\[ModelName\]* folder. The database tables and constraints are located under the *\[ModelName\]*.Store folder.
+-   A **Mapping Details** window for viewing and editing mappings. You can map entity types or associations to database tables, columns, and stored procedures. 
+
+The visual design surface window is automatically opened when the Entity Data Model Wizard finishes. If the Model Browser is not visible, right-click the main design surface and select **Model Browser**.
+
+The following screenshot shows an .edmx file opened in the EF Designer. The screenshot shows the visual design surface (to the left) and the **Model Browser** window (to the right).
+
+![EF Designer 2](~/ef6/media/efdesigner2.png)
+
+To undo an operation done in the EF Designer, click Ctrl-Z.
+
+## Working with Diagrams
+
+By default the EF Designer creates one diagram called Diagram1. If you have a diagram with a large number of entities and associations, you will most like want to split them up logically. Starting with Visual Studio 2012, you can view your conceptual model in multiple diagrams.   
+
+As you add new diagrams, they appear under the Diagrams folder in the Model Browser window. To rename a diagram: select the diagram in the Model Browser window, click once on the name, and type the new name.  You can also right-click the diagram name and select **Rename**.
+
+The diagram name is displayed next to the .edmx file name, in the Visual Studio editor. For example Model1.edmx\[Diagram1\].
+
+![Diagram Name](~/ef6/media/diagramname.png)
+
+The diagrams content (shape and color of entities and associations) is stored in the .edmx.diagram file. To view this file, select Solution Explorer and unfold the .edmx file. 
+
+![Diagram Files](~/ef6/media/diagramfiles.png)
+
+You should not edit the .edmx.diagram file manually, the content of this file maybe overwritten by the EF Designer.
+ 
+## Splitting Entities and Associations into a New Diagram
+
+You can select entities on the existing diagram (hold Shift to select multiple entities). Click the right mouse button and select **Move to new Diagram**. The new diagram is created and the selected entities and their associations are moved to the diagram.
+
+Alternatively, you can right-click the Diagrams folder in Model Browser and select **Add new Diagram.** You can then drag and drop entities from under the Entity Types folder in Model Browser onto the design surface.
+
+You can also cut or copy entities (using Ctrl-X or Ctrl-C keys) from one diagram and paste (using Ctrl-V key) on the other. If the diagram into which you are pasting an entity already contains an entity with the same name, a new entity will be created and added to the model.  For example: Diagram2 contains the Department entity. Then, you paste another Department on Diagram2. The Department1 entity is created and added to the conceptual model.   
+
+To include related entities in a diagram, rick-click the entity and select **Include Related**. This will make a copy of the related entities and associations in the specified diagram.
+
+## Changing the Color of Entities
+
+In addition to splitting a model into multiple diagrams, you can also change colors of your entities.
+
+To change the color, select an entity (or multiple entities) on the design surface. Then, click the right mouse button and select **Properties**. In the Properties window, select the **Fill Color** property. Specify the color using either a valid color name (for example, Red) or a valid RGB (for example, 255, 128, 128). 
+
+![Change Color](~/ef6/media/color.png)
+
+## Summary
+
+In this topic we looked at how to split a model into multiple diagrams and also how to specify a different color for an entity using the Entity Framework Designer. 
diff --git a/entity-framework/ef6/modeling/designer/relationships.md b/entity-framework/ef6/modeling/designer/relationships.md
new file mode 100644
index 0000000000..e7774cfae9
--- /dev/null
+++ b/entity-framework/ef6/modeling/designer/relationships.md
@@ -0,0 +1,120 @@
+---
+title: Relationships - EF Designer - EF6
+description: Relationships - EF Designer in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/designer/relationships
+---
+# Relationships - EF Designer
+> [!NOTE]
+> This page provides information about setting up relationships in your model using the EF Designer. For general information about relationships in EF and how to access and manipulate data using relationships, see [Relationships & Navigation Properties](xref:ef6/fundamentals/relationships).
+
+Associations define relationships between entity types in a model. This topic shows how to map associations with the Entity Framework Designer (EF Designer). The following image shows the main windows that are used when working with the EF Designer.
+
+![EF Designer](~/ef6/media/efdesigner.png)
+
+> [!NOTE]
+> When you build the conceptual model, warnings about unmapped entities and associations may appear in the Error List. You can ignore these warnings because after you choose to generate the database from the model, the errors will go away.
+
+## Associations Overview
+
+When you design your model using the EF Designer, an .edmx file represents your model. In the .edmx file, an **Association** element defines a relationship between two entity types. An association must specify the entity types that are involved in the relationship and the possible number of entity types at each end of the relationship, which is known as the multiplicity. The multiplicity of an association end can have a value of one (1), zero or one (0..1), or many (\*). This information is specified in two child **End** elements.
+
+At run time, entity type instances at one end of an association can be accessed through navigation properties or foreign keys (if you choose to expose foreign keys in your entities). With foreign keys exposed, the relationship between the entities is managed with a **ReferentialConstraint** element (a child element of the **Association** element). It is recommended that you always expose foreign keys for relationships in your entities.
+
+> [!NOTE]
+> In many-to-many (\*:\*) you cannot add foreign keys to the entities. In a \*:\* relationship, the association information is managed with an independent object.
+
+For information about CSDL elements (**ReferentialConstraint**, **Association**, etc.) see the [CSDL specification](xref:ef6/modeling/designer/advanced/edmx/csdl-spec).
+
+## Create and Delete Associations
+
+Creating an association with the EF Designer updates the model content of the .edmx file. After creating an association, you must create the mappings for the association (discussed later in this topic).
+
+> [!NOTE]
+> This section assumes that you already added the entities you wish to create an association between to your model.
+
+### To create an association
+
+1.  Right-click an empty area of the design surface, point to **Add New**, and select **Association…**.
+2.  Fill in the settings for the association in the **Add Association** dialog.
+
+    ![Add Association](~/ef6/media/addassociation.png)
+
+    > [!NOTE]
+    > You can choose to not add navigation properties or foreign key properties to the entities at the ends of the association by clearing the **Navigation Property **and **Add foreign key properties to the &lt;entity type name&gt; Entity **checkboxes. If you add only one navigation property, the association will be traversable in only one direction. If you add no navigation properties, you must choose to add foreign key properties in order to access entities at the ends of the association.
+    
+3.  Click **OK**.
+
+### To delete an association
+
+To delete an association do one of the following:
+
+-   Right-click the association on the EF Designer surface and select **Delete**.
+
+- OR -
+
+-   Select one or more associations and press the DELETE key.
+
+## Include Foreign Key Properties in Your Entities (Referential Constraints)
+
+It is recommended that you always expose foreign keys for relationships in your entities. Entity Framework uses a referential constraint to identify that a property acts as the foreign key for a relationship.
+
+If you checked the ***Add foreign key properties to the &lt;entity type name&gt; Entity*** checkbox when creating a relationship, this referential constraint was added for you.
+
+When you use the EF Designer to add or edit a referential constraint, the EF Designer adds or modifies a **ReferentialConstraint** element in the CSDL content of the .edmx file.
+
+-   Double-click the association that you want to edit.
+    The **Referential Constraint** dialog box appears.
+-   From the **Principal** drop-down list, select the principal entity in the referential constraint.
+    The entity's key properties are added to the **Principal Key** list in the dialog box.
+-   From the **Dependent** drop-down list, select the dependent entity in the referential constraint.
+-   For each principal key that has a dependent key, select a corresponding dependent key from the drop-down lists in the **Dependent Key** column.
+
+    ![Ref Constraint](~/ef6/media/refconstraint.png)
+
+-   Click **OK**.
+
+## Create and Edit Association Mappings
+
+You can specify how an association maps to the database in the **Mapping Details** window of the EF Designer.
+
+> [!NOTE]
+> You can only map details for the associations that do not have a referential constraint specified. If a referential constraint is specified then a foreign key property is included in the entity and you can use the Mapping Details for the entity to control which column the foreign key maps to.
+
+### Create an association mapping
+
+-   Right-click an association in the design surface and select **Table Mapping**.
+    This displays the association mapping in the **Mapping Details** window.
+-   Click **Add a Table or View**.
+    A drop-down list appears that includes all the tables in the storage model.
+-   Select the table to which the association will map.
+    The **Mapping Details** window displays both ends of the association and the key properties for the entity type at each **End**.
+-   For each key property, click the **Column** field, and select the column to which the property will map.
+
+    ![Mapping Details 4](~/ef6/media/mappingdetails4.png)
+
+### Edit an association mapping
+
+-   Right-click an association in the design surface and select **Table Mapping**.
+    This displays the association mapping in the **Mapping Details** window.
+-   Click **Maps to &lt;Table Name&gt;**.
+    A drop-down list appears that includes all the tables in the storage model.
+-   Select the table to which the association will map.
+    The **Mapping Details** window displays both ends of the association and the key properties for the entity type at each End.
+-   For each key property, click the **Column** field, and select the column to which the property will map.
+
+## Edit and Delete Navigation Properties
+
+Navigation properties are shortcut properties that are used to locate the entities at the ends of an association in a model. Navigation properties can be created when you create an association between two entity types.
+
+#### To edit navigation properties
+
+-   Select a navigation property on the EF Designer surface.
+    Information about the navigation property is displayed in the Visual Studio **Properties** window.
+-   Change the property settings in the **Properties** window.
+
+#### To delete navigation properties
+
+-   If foreign keys are not exposed on entity types in the conceptual model, deleting a navigation property may make the corresponding association traversable in only one direction or not traversable at all.
+-   Right-click a navigation property on the EF Designer surface and select **Delete**.
diff --git a/entity-framework/ef6/modeling/designer/select-runtime-version.md b/entity-framework/ef6/modeling/designer/select-runtime-version.md
new file mode 100644
index 0000000000..4f6c206a45
--- /dev/null
+++ b/entity-framework/ef6/modeling/designer/select-runtime-version.md
@@ -0,0 +1,44 @@
+---
+title: Selecting Entity Framework Runtime Version for EF Designer Models - EF6
+description: Selecting Entity Framework Runtime Version for EF Designer Models in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Selecting Entity Framework Runtime Version for EF Designer Models
+> [!NOTE]
+> **EF6 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 6. If you are using an earlier version, some or all of the information does not apply.
+
+Starting with EF6 the following screen was added to the EF Designer to allow you to select the version of the runtime you wish to target when creating a model. The screen will appear when the latest version of Entity Framework is not already installed in the project. If the latest version is already installed it will just be used by default.
+
+![Select Runtime Version](~/ef6/media/screen.png)
+
+## Targeting EF6.x
+
+You can choose EF6 from the 'Choose Your Version' screen to add the EF6 runtime to your project. Once you've added EF6, you’ll stop seeing this screen in the current project.
+
+EF6 will be disabled if you already have an older version of EF installed (since you can't target multiple versions of the runtime from the same project). If EF6 option is not enabled here, follow these steps to upgrade your project to EF6:
+
+1.  Right-click on your project in Solution Explorer and select **Manage NuGet Packages...**
+2.  Select **Updates**
+3.  Select **EntityFramework** (make sure it is going to update it to the version you want)
+4.  Click **Update**
+
+ 
+
+## Targeting EF5.x
+
+You can choose EF5 from the 'Choose Your Version' screen to add the EF5 runtime to your project. Once you've added EF5, you’ll still see the screen with the EF6 option disabled.
+
+If you have an EF4.x version of the runtime already installed then you will see that version of EF listed in the screen rather than EF5. In this situation you can upgrade to EF5 using the following steps:
+
+1.  Select **Tools -&gt; Library Package Manager -&gt; Package Manager Console**
+2.  Run **Install-Package EntityFramework -version 5.0.0**
+
+ 
+
+## Targeting EF4.x
+
+You can install the EF4.x runtime to your project using the following steps:
+
+1.  Select **Tools -&gt; Library Package Manager -&gt; Package Manager Console**
+2.  Run **Install-Package EntityFramework -version 4.3.0**
diff --git a/entity-framework/ef6/modeling/designer/stored-procedures/cud.md b/entity-framework/ef6/modeling/designer/stored-procedures/cud.md
new file mode 100644
index 0000000000..cd93da2a3c
--- /dev/null
+++ b/entity-framework/ef6/modeling/designer/stored-procedures/cud.md
@@ -0,0 +1,154 @@
+---
+title: Designer CUD Stored Procedures - EF6
+description: Designer CUD Stored Procedures in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/designer/stored-procedures/cud
+---
+# Designer CUD Stored Procedures
+
+This step-by-step walkthrough show how to map the create\\insert, update, and delete (CUD) operations of an entity type to stored procedures using the Entity Framework Designer (EF Designer).  By default, the Entity Framework automatically generates the SQL statements for the CUD operations, but you can also map stored procedures to these operations.  
+
+Note, that Code First does not support mapping to stored procedures or functions. However, you can call stored procedures or functions by using the System.Data.Entity.DbSet.SqlQuery method. For example:
+
+``` csharp
+var query = context.Products.SqlQuery("EXECUTE [dbo].[GetAllProducts]");
+```
+
+## Considerations when Mapping the CUD Operations to Stored Procedures
+
+When mapping the CUD operations to stored procedures, the following considerations apply:
+
+- If you are mapping one of the CUD operations to a stored procedure, map all of them. If you do not map all three, the unmapped operations will fail if executed and an **UpdateException** will be thrown.
+- You must map every parameter of the stored procedure to entity properties.
+- If the server generates the primary key value for the inserted row, you must map this value back to the entity's key property. In the example that follows, the **InsertPerson** stored procedure returns the newly created primary key as part of the stored procedure's result set. The primary key is mapped to the entity key (**PersonID**) using the **&lt;Add Result Bindings&gt;** feature of the EF Designer.
+- The stored procedure calls are mapped 1:1 with the entities in the conceptual model. For example, if you implement an inheritance hierarchy in your conceptual model and then map the CUD stored procedures for the **Parent** (base) and the **Child** (derived) entities, saving the **Child** changes will only call the **Child**’s stored procedures, it will not trigger the **Parent**’s stored procedures calls.
+
+## Prerequisites
+
+To complete this walkthrough, you will need:
+
+- A recent version of Visual Studio.
+- The [School sample database](xref:ef6/resources/school-database).
+
+## Set up the Project
+
+- Open Visual Studio 2012.
+- Select **File-&gt; New -&gt; Project**
+- In the left pane, click **Visual C\#**, and then select the **Console** template.
+- Enter **CUDSProcsSample** as the name.
+- Select **OK**.
+
+## Create a Model
+
+- Right-click the project name in Solution Explorer, and select **Add -&gt; New Item**.
+- Select **Data** from the left menu and then select **ADO.NET Entity Data Model** in the Templates pane.
+- Enter **CUDSProcs.edmx** for the file name, and then click **Add**.
+- In the Choose Model Contents dialog box, select **Generate from database**, and then click **Next**.
+- Click **New Connection**. In the Connection Properties dialog box, enter the server name (for example, **(localdb)\\mssqllocaldb**), select the authentication method, type **School** for the database name, and then click **OK**.
+    The Choose Your Data Connection dialog box is updated with your database connection setting.
+- In the Choose Your Database Objects dialog box, under the **Tables** node, select the **Person** table.
+- Also, select the following stored procedures under the **Stored Procedures and Functions** node: **DeletePerson**, **InsertPerson**, and **UpdatePerson**.
+- Starting with Visual Studio 2012 the EF Designer supports bulk import of stored procedures. The **Import selected stored procedures and functions into the entity model** is checked by default. Since in this example we have stored procedures that insert, update, and delete entity types, we do not want to import them and will uncheck this checkbox.
+
+    ![Import S Procs](~/ef6/media/importsprocs.jpg)
+
+- Click **Finish**.
+    The EF Designer, which provides a design surface for editing your model, is displayed.
+
+## Map the Person Entity to Stored Procedures
+
+- Right-click the **Person** entity type and select **Stored Procedure Mapping**.
+- The stored procedure mappings appear in the **Mapping Details** window.
+- Click **&lt;Select Insert Function&gt;**.
+    The field becomes a drop-down list of the stored procedures in the storage model that can be mapped to entity types in the conceptual model.
+    Select **InsertPerson** from the drop-down list.
+- Default mappings between stored procedure parameters and entity properties appear. Note that arrows indicate the mapping direction: Property values are supplied to stored procedure parameters.
+- Click **&lt;Add Result Binding&gt;**.
+- Type **NewPersonID**, the name of the parameter returned by the **InsertPerson** stored procedure. Make sure not to type leading or trailing spaces.
+- Press **Enter**.
+- By default, **NewPersonID** is mapped to the entity key **PersonID**. Note that an arrow indicates the direction of the mapping: The value of the result column is supplied to the property.
+
+    ![Mapping Details](~/ef6/media/mappingdetails.png)
+
+- Click **&lt;Select Update Function&gt;** and select **UpdatePerson** from the resulting drop-down list.
+- Default mappings between stored procedure parameters and entity properties appear.
+- Click **&lt;Select Delete Function&gt;** and select **DeletePerson** from the resulting drop-down list.
+- Default mappings between stored procedure parameters and entity properties appear.
+
+The insert, update, and delete operations of the **Person** entity type are now mapped to stored procedures.
+
+If you want to enable concurrency checking when updating or deleting an entity with stored procedures, use one of the following options:
+
+- Use an **OUTPUT** parameter to return the number of affected rows from the stored procedure and check the **Rows Affected Parameter** checkbox next to the parameter name. If the value returned is zero when the operation is called, an  [**OptimisticConcurrencyException**](https://msdn.microsoft.com/library/system.data.optimisticconcurrencyexception.aspx) will be thrown.
+- Check the **Use Original Value** checkbox next to a property that you want to use for concurrency checking. When an update is attempted, the value of the property that was originally read from the database will be used when writing data back to the database. If the value does not match the value in the database, an **OptimisticConcurrencyException** will be thrown.
+
+## Use the Model
+
+Open the **Program.cs** file where the **Main** method is defined. Add the following code into the Main function.
+
+The code creates a new **Person** object, then updates the object, and finally deletes the object.
+
+``` csharp
+    using (var context = new SchoolEntities())
+    {
+        var newInstructor = new Person
+        {
+            FirstName = "Robyn",
+            LastName = "Martin",
+            HireDate = DateTime.Now,
+            Discriminator = "Instructor"
+        }
+
+        // Add the new object to the context.
+        context.People.Add(newInstructor);
+
+        Console.WriteLine("Added {0} {1} to the context.",
+            newInstructor.FirstName, newInstructor.LastName);
+
+        Console.WriteLine("Before SaveChanges, the PersonID is: {0}",
+            newInstructor.PersonID);
+
+        // SaveChanges will call the InsertPerson sproc.  
+        // The PersonID property will be assigned the value
+        // returned by the sproc.
+        context.SaveChanges();
+
+        Console.WriteLine("After SaveChanges, the PersonID is: {0}",
+            newInstructor.PersonID);
+
+        // Modify the object and call SaveChanges.
+        // This time, the UpdatePerson will be called.
+        newInstructor.FirstName = "Rachel";
+        context.SaveChanges();
+
+        // Remove the object from the context and call SaveChanges.
+        // The DeletePerson sproc will be called.
+        context.People.Remove(newInstructor);
+        context.SaveChanges();
+
+        Person deletedInstructor = context.People.
+            Where(p => p.PersonID == newInstructor.PersonID).
+            FirstOrDefault();
+
+        if (deletedInstructor == null)
+            Console.WriteLine("A person with PersonID {0} was deleted.",
+                newInstructor.PersonID);
+    }
+```
+
+- Compile and run the application. The program produces the following output *
+
+> [!NOTE]
+> PersonID is auto-generated by the server, so you will most likely see a different number*
+
+``` Output
+Added Robyn Martin to the context.
+Before SaveChanges, the PersonID is: 0
+After SaveChanges, the PersonID is: 51
+A person with PersonID 51 was deleted.
+```
+
+If you are working with the Ultimate version of Visual Studio, you can use Intellitrace with the debugger to see the SQL statements that get executed.
+
+![Debug With Intellitrace](~/ef6/media/intellitrace.png)
diff --git a/entity-framework/ef6/modeling/designer/stored-procedures/query.md b/entity-framework/ef6/modeling/designer/stored-procedures/query.md
new file mode 100644
index 0000000000..ab595b5f1d
--- /dev/null
+++ b/entity-framework/ef6/modeling/designer/stored-procedures/query.md
@@ -0,0 +1,99 @@
+---
+title: Designer Query Stored Procedures - EF6
+description: Designer Query Stored Procedures in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/designer/stored-procedures/query
+---
+# Designer Query Stored Procedures
+
+This step-by-step walkthrough shows how to use the Entity Framework Designer (EF Designer) to import stored procedures into a model and then call the imported stored procedures to retrieve results.
+
+Note, that Code First does not support mapping to stored procedures or functions. However, you can call stored procedures or functions by using the System.Data.Entity.DbSet.SqlQuery method. For example:
+
+```csharp
+var query = context.Products.SqlQuery("EXECUTE [dbo].[GetAllProducts]")`;
+```
+
+## Prerequisites
+
+To complete this walkthrough, you will need:
+
+- A recent version of Visual Studio.
+- The [School sample database](xref:ef6/resources/school-database).
+
+## Set up the Project
+
+- Open Visual Studio 2012.
+- Select **File-&gt; New -&gt; Project**
+- In the left pane, click **Visual C\#**, and then select the **Console** template.
+- Enter **EFwithSProcsSample** as the name.
+- Select **OK**.
+
+## Create a Model
+
+- Right-click the project in Solution Explorer and select **Add -&gt; New Item**.
+- Select **Data** from the left menu and then select **ADO.NET Entity Data Model** in the Templates pane.
+- Enter **EFwithSProcsModel.edmx** for the file name, and then click **Add**.
+- In the Choose Model Contents dialog box, select **Generate from database**, and then click **Next**.
+- Click **New Connection**.  
+    In the Connection Properties dialog box, enter the server name (for example, **(localdb)\\mssqllocaldb**), select the authentication method, type **School** for the database name, and then click **OK**.  
+    The Choose Your Data Connection dialog box is updated with your database connection setting.
+- In the Choose Your Database Objects dialog box, check the **Tables** checkbox to select all the tables.  
+    Also, select the following stored procedures under the **Stored Procedures and Functions** node: **GetStudentGrades** and **GetDepartmentName**.
+
+    ![Import Stored Procedures](~/ef6/media/import.jpg)
+
+    *Starting with Visual Studio 2012 the EF Designer supports bulk import of stored procedures. The **Import selected stored procedures and functions into the entity model** is checked by default.*
+- Click **Finish**.
+
+By default, the result shape of each imported stored procedure or function that returns more than one column will automatically become a new complex type. In this example we want to map the results of the **GetStudentGrades** function to the **StudentGrade** entity and the results of the **GetDepartmentName** to **none** (**none** is the default value).
+
+For a function import to return an entity type, the columns returned by the corresponding stored procedure must exactly match the scalar properties of the returned entity type. A function import can also return collections of simple types, complex types, or no value.
+
+- Right-click the design surface and select **Model Browser**.
+- In **Model Browser**, select **Function Imports**, and then double-click the **GetStudentGrades** function.
+- In the Edit Function Import dialog box, select **Entities** and choose **StudentGrade**.  
+    *The **Function Import is composable** checkbox at the top of the **Function Imports** dialog will let you map to composable functions. If you do check this box, only composable functions (Table-valued Functions) will appear in the **Stored Procedure / Function Name** drop-down list. If you do not check this box, only non-composable functions will be shown in the list.*
+
+## Use the Model
+
+Open the **Program.cs** file where the **Main** method is defined. Add the following code into the Main function.
+
+The code calls two stored procedures: **GetStudentGrades** (returns **StudentGrades** for the specified *StudentId*) and **GetDepartmentName** (returns the name of the department in the output parameter).  
+
+``` csharp
+    using (SchoolEntities context = new SchoolEntities())
+    {
+        // Specify the Student ID.
+        int studentId = 2;
+
+        // Call GetStudentGrades and iterate through the returned collection.
+        foreach (StudentGrade grade in context.GetStudentGrades(studentId))
+        {
+            Console.WriteLine("StudentID: {0}\tSubject={1}", studentId, grade.Subject);
+            Console.WriteLine("Student grade: " + grade.Grade);
+        }
+
+        // Call GetDepartmentName.
+        // Declare the name variable that will contain the value returned by the output parameter.
+        ObjectParameter name = new ObjectParameter("Name", typeof(String));
+        context.GetDepartmentName(1, name);
+        Console.WriteLine("The department name is {0}", name.Value);
+
+    }
+```
+
+Compile and run the application. The program produces the following output:
+
+```console
+StudentID: 2
+Student grade: 4.00
+StudentID: 2
+Student grade: 3.50
+The department name is Engineering
+```
+
+## Output Parameters
+
+If output parameters are used, their values will not be available until the results have been read completely. This is due to the underlying behavior of DbDataReader, see [Retrieving Data Using a DataReader](https://go.microsoft.com/fwlink/?LinkID=398589) for more details.
diff --git a/entity-framework/ef6/modeling/designer/table-splitting.md b/entity-framework/ef6/modeling/designer/table-splitting.md
new file mode 100644
index 0000000000..5866db7693
--- /dev/null
+++ b/entity-framework/ef6/modeling/designer/table-splitting.md
@@ -0,0 +1,132 @@
+---
+title: Designer Table Splitting - EF6
+description: Designer Table Splitting in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/designer/table-splitting
+---
+# Designer Table Splitting
+This walkthrough shows how to map multiple entity types to a single table by modifying a model with the Entity Framework Designer (EF Designer).
+
+One reason you may want to use table splitting is delaying the loading of some properties when using lazy loading to load your objects. You can separate the properties that might contain very large amount of data into a separate entity and only load it when required.
+
+The following image shows the main windows that are used when working with the EF Designer.
+
+![EF Designer](~/ef6/media/efdesigner.png)
+
+## Prerequisites
+
+To complete this walkthrough, you will need:
+
+- A recent version of Visual Studio.
+- The [School sample database](xref:ef6/resources/school-database).
+
+## Set up the Project
+
+This walkthrough is using Visual Studio 2012.
+
+-   Open Visual Studio 2012.
+-   On the **File** menu, point to **New**, and then click **Project**.
+-   In the left pane, click Visual C\#, and then select the Console Application template.
+-   Enter **TableSplittingSample** as the name of the project and click **OK**.
+
+## Create a Model based on the School Database
+
+-   Right-click the project name in Solution Explorer, point to **Add**, and then click **New Item**.
+-   Select **Data** from the left menu and then select **ADO.NET Entity Data Model** in the Templates pane.
+-   Enter **TableSplittingModel.edmx** for the file name, and then click **Add**.
+-   In the Choose Model Contents dialog box, select **Generate from database**, and then click **Next.**
+-   Click New Connection. In the Connection Properties dialog box, enter the server name (for example, **(localdb)\\mssqllocaldb**), select the authentication method, type **School** for the database name, and then click **OK**.
+    The Choose Your Data Connection dialog box is updated with your database connection setting.
+-   In the Choose Your Database Objects dialog box, unfold the **Tables** node and check the **Person** table. This will add the specified table to the **School** model.
+-   Click **Finish**.
+
+The Entity Designer, which provides a design surface for editing your model, is displayed. All the objects that you selected in the **Choose Your Database Objects** dialog box are added to the model.
+
+## Map Two Entities to a Single Table
+
+In this section you will split the **Person** entity into two entities and then map them to a single table.
+
+> [!NOTE]
+> The **Person** entity does not contain any properties that may contain large amount of data; it is just used as an example.
+
+-   Right-click an empty area of the design surface, point to **Add New**, and click **Entity**.
+    The **New Entity** dialog box appears.
+-   Type **HireInfo** for the **Entity name** and **PersonID** for the **Key Property** name.
+-   Click **OK**.
+-   A new entity type is created and displayed on the design surface.
+-   Select the **HireDate** property of the **Person** entity type and press **Ctrl+X** keys.
+-   Select the **HireInfo** entity and press **Ctrl+V** keys.
+-   Create an association between **Person** and **HireInfo**. To do this, right-click an empty area of the design surface, point to **Add New**, and click **Association**.
+-   The **Add Association** dialog box appears. The **PersonHireInfo** name is given by default.
+-   Specify multiplicity **1(One)** on both ends of the relationship.
+-   Press **OK**.
+
+The next step requires the **Mapping Details** window. If you cannot see this window, right-click the design surface and select **Mapping Details**.
+
+-   Select the **HireInfo** entity type and click **&lt;Add a Table or View&gt;** in the **Mapping Details** window.
+-   Select **Person** from the **&lt;Add a Table or View&gt;** field drop-down list. The list contains tables or views to which the selected entity can be mapped.
+    The appropriate properties should be mapped by default.
+
+    ![Mapping Properties](~/ef6/media/mapping.png)
+
+-   Select the **PersonHireInfo** association on the design surface.
+-   Right-click the association on the design surface and select **Properties**.
+-   In the **Properties** window, select the **Referential Constraints** property and click the ellipses button.
+-   Select **Person** from the **Principal** drop-down list.
+-   Press **OK**.
+
+ 
+
+## Use the Model
+
+-   Paste the following code in the Main method.
+
+``` csharp
+    using (var context = new SchoolEntities())
+    {
+        Person person = new Person()
+        {
+            FirstName = "Kimberly",
+            LastName = "Morgan",
+            Discriminator = "Instructor",
+        };
+
+        person.HireInfo = new HireInfo()
+        {
+            HireDate = DateTime.Now
+        };
+
+        // Add the new person to the context.
+        context.People.Add(person);
+
+        // Insert a row into the Person table.  
+        context.SaveChanges();
+
+        // Execute a query against the Person table.
+        // The query returns columns that map to the Person entity.
+        var existingPerson = context.People.FirstOrDefault();
+
+        // Execute a query against the Person table.
+        // The query returns columns that map to the Instructor entity.
+        var hireInfo = existingPerson.HireInfo;
+
+        Console.WriteLine("{0} was hired on {1}",
+            existingPerson.LastName, hireInfo.HireDate);
+    }
+```
+-   Compile and run the application.
+
+The following T-SQL statements were executed against the **School** database as a result of running this application. 
+
+-   The following **INSERT** was executed as a result of executing context.SaveChanges() and combines data from the **Person** and **HireInfo** entities
+
+    ![Insert Combining Person and HireInfo Data](~/ef6/media/insert.png)
+
+-   The following **SELECT** was executed as a result of executing context.People.FirstOrDefault() and selects just the columns mapped to **Person**
+
+    ![Select 1](~/ef6/media/select1.png)
+
+-   The following **SELECT** was executed as a result of accessing the navigation property existingPerson.Instructor and selects just the columns mapped to **HireInfo**
+
+    ![Select 2](~/ef6/media/select2.png)
diff --git a/entity-framework/ef6/modeling/designer/workflows/database-first.md b/entity-framework/ef6/modeling/designer/workflows/database-first.md
new file mode 100644
index 0000000000..1e80b05f07
--- /dev/null
+++ b/entity-framework/ef6/modeling/designer/workflows/database-first.md
@@ -0,0 +1,227 @@
+---
+title: Database First - EF6
+description: Database First in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/designer/workflows/database-first
+---
+# Database First
+This video and step-by-step walkthrough provide an introduction to Database First development using Entity Framework. Database First allows you to reverse engineer a model from an existing database. The model is stored in an EDMX file (.edmx extension) and can be viewed and edited in the Entity Framework Designer. The classes that you interact with in your application are automatically generated from the EDMX file.
+
+## Watch the video
+This video provides an introduction to Database First development using Entity Framework. Database First allows you to reverse engineer a model from an existing database. The model is stored in an EDMX file (.edmx extension) and can be viewed and edited in the Entity Framework Designer. The classes that you interact with in your application are automatically generated from the EDMX file.
+
+**Presented By**: [Rowan Miller](https://romiller.com/)
+
+**Video**: [WMV](https://download.microsoft.com/download/8/F/0/8F0B5F63-4939-4DC8-A726-FF139B37F8D8/HDI-ITPro-MSDN-winvideo-databasefirst.wmv) | [MP4](https://download.microsoft.com/download/8/F/0/8F0B5F63-4939-4DC8-A726-FF139B37F8D8/HDI-ITPro-MSDN-mp4video-databasefirst.m4v) | [WMV (ZIP)](https://download.microsoft.com/download/8/F/0/8F0B5F63-4939-4DC8-A726-FF139B37F8D8/HDI-ITPro-MSDN-winvideo-databasefirst.zip)
+
+## Pre-Requisites
+
+You will need to have at least Visual Studio 2010 or Visual Studio 2012 installed to complete this walkthrough.
+
+If you are using Visual Studio 2010, you will also need to have [NuGet](https://visualstudiogallery.msdn.microsoft.com/27077b70-9dad-4c64-adcf-c7cf6bc9970c) installed.
+
+ 
+
+## 1. Create an Existing Database
+
+Typically when you are targeting an existing database it will already be created, but for this walkthrough we need to create a database to access.
+
+The database server that is installed with Visual Studio is different depending on the version of Visual Studio you have installed:
+
+-   If you are using Visual Studio 2010 you'll be creating a SQL Express database.
+-   If you are using Visual Studio 2012 then you'll be creating a [LocalDB](https://msdn.microsoft.com/library/hh510202(v=sql.110).aspx) database.
+
+ 
+
+Let's go ahead and generate the database.
+
+-   Open Visual Studio
+-   **View -&gt; Server Explorer**
+-   Right click on **Data Connections -&gt; Add Connection…**
+-   If you haven’t connected to a database from Server Explorer before you’ll need to select Microsoft SQL Server as the data source
+
+    ![Select Data Source](~/ef6/media/selectdatasource.png)
+
+-   Connect to either LocalDB or SQL Express, depending on which one you have installed, and enter **DatabaseFirst.Blogging** as the database name
+
+    ![Sql Express Connection DF](~/ef6/media/sqlexpressconnectiondf.png)
+
+    ![LocalDB Connection DF](~/ef6/media/localdbconnectiondf.png)
+
+-   Select **OK** and you will be asked if you want to create a new database, select **Yes**
+
+    ![Create Database Dialog](~/ef6/media/createdatabasedialog.png)
+
+-   The new database will now appear in Server Explorer, right-click on it and select **New Query**
+-   Copy the following SQL into the new query, then right-click on the query and select **Execute**
+
+``` SQL
+CREATE TABLE [dbo].[Blogs] (
+    [BlogId] INT IDENTITY (1, 1) NOT NULL,
+    [Name] NVARCHAR (200) NULL,
+    [Url]  NVARCHAR (200) NULL,
+    CONSTRAINT [PK_dbo.Blogs] PRIMARY KEY CLUSTERED ([BlogId] ASC)
+);
+
+CREATE TABLE [dbo].[Posts] (
+    [PostId] INT IDENTITY (1, 1) NOT NULL,
+    [Title] NVARCHAR (200) NULL,
+    [Content] NTEXT NULL,
+    [BlogId] INT NOT NULL,
+    CONSTRAINT [PK_dbo.Posts] PRIMARY KEY CLUSTERED ([PostId] ASC),
+    CONSTRAINT [FK_dbo.Posts_dbo.Blogs_BlogId] FOREIGN KEY ([BlogId]) REFERENCES [dbo].[Blogs] ([BlogId]) ON DELETE CASCADE
+);
+```
+
+## 2. Create the Application
+
+To keep things simple we’re going to build a basic console application that uses the Database First to perform data access:
+
+-   Open Visual Studio
+-   **File -&gt; New -&gt; Project…**
+-   Select **Windows** from the left menu and **Console Application**
+-   Enter **DatabaseFirstSample** as the name
+-   Select **OK**
+
+ 
+
+## 3. Reverse Engineer Model
+
+We’re going to make use of Entity Framework Designer, which is included as part of Visual Studio, to create our model.
+
+-   **Project -&gt; Add New Item…**
+-   Select **Data** from the left menu and then **ADO.NET Entity Data Model**
+-   Enter **BloggingModel** as the name and click **OK**
+-   This launches the **Entity Data Model Wizard**
+-   Select **Generate from Database** and click **Next**
+
+    ![Wizard Step 1](~/ef6/media/wizardstep1.png)
+
+-   Select the connection to the database you created in the first section, enter **BloggingContext** as the name of the connection string and click **Next**
+
+    ![Wizard Step 2](~/ef6/media/wizardstep2.png)
+
+-   Click the checkbox next to ‘Tables’ to import all tables and click ‘Finish’
+
+    ![Wizard Step 3](~/ef6/media/wizardstep3.png)
+
+ 
+
+Once the reverse engineer process completes the new model is added to your project and opened up for you to view in the Entity Framework Designer. An App.config file has also been added to your project with the connection details for the database.
+
+![Model Initial](~/ef6/media/modelinitial.png)
+
+### Additional Steps in Visual Studio 2010
+
+If you are working in Visual Studio 2010 there are some additional steps you need to follow to upgrade to the latest version of Entity Framework. Upgrading is important because it gives you access to an improved API surface, that is much easier to use, as well as the latest bug fixes.
+
+First up, we need to get the latest version of Entity Framework from NuGet.
+
+-   **Project –&gt; Manage NuGet Packages…**
+    *If you don’t have the **Manage NuGet Packages…** option you should install the [latest version of NuGet](https://visualstudiogallery.msdn.microsoft.com/27077b70-9dad-4c64-adcf-c7cf6bc9970c)*
+-   Select the **Online** tab
+-   Select the **EntityFramework** package
+-   Click **Install**
+
+Next, we need to swap our model to generate code that makes use of the DbContext API, which was introduced in later versions of Entity Framework.
+
+-   Right-click on an empty spot of your model in the EF Designer and select **Add Code Generation Item…**
+-   Select **Online Templates** from the left menu and search for **DbContext**
+-   Select the EF **5.x DbContext Generator for C\#**, enter **BloggingModel** as the name and click **Add**
+
+    ![DbContext Template](~/ef6/media/dbcontexttemplate.png)
+
+ 
+
+## 4. Reading & Writing Data
+
+Now that we have a model it’s time to use it to access some data. The classes we are going to use to access data are being automatically generated for you based on the EDMX file.
+
+*This screen shot is from Visual Studio 2012, if you are using Visual Studio 2010 the BloggingModel.tt and BloggingModel.Context.tt files will be directly under your project rather than nested under the EDMX file.*
+
+![Generated Classes DF](~/ef6/media/generatedclassesdf.png)
+
+ 
+
+Implement the Main method in Program.cs as shown below. This code creates a new instance of our context and then uses it to insert a new Blog. Then it uses a LINQ query to retrieve all Blogs from the database ordered alphabetically by Title.
+
+``` csharp
+class Program
+{
+    static void Main(string[] args)
+    {
+        using (var db = new BloggingContext())
+        {
+            // Create and save a new Blog
+            Console.Write("Enter a name for a new Blog: ");
+            var name = Console.ReadLine();
+
+            var blog = new Blog { Name = name };
+            db.Blogs.Add(blog);
+            db.SaveChanges();
+
+            // Display all Blogs from the database
+            var query = from b in db.Blogs
+                        orderby b.Name
+                        select b;
+
+            Console.WriteLine("All blogs in the database:");
+            foreach (var item in query)
+            {
+                Console.WriteLine(item.Name);
+            }
+
+            Console.WriteLine("Press any key to exit...");
+            Console.ReadKey();
+        }
+    }
+}
+```
+
+You can now run the application and test it out.
+
+```console
+Enter a name for a new Blog: ADO.NET Blog
+All blogs in the database:
+ADO.NET Blog
+Press any key to exit...
+```
+ 
+
+## 5. Dealing with Database Changes
+
+Now it’s time to make some changes to our database schema, when we make these changes we also need to update our model to reflect those changes.
+
+The first step is to make some changes to the database schema. We’re going to add a Users table to the schema.
+
+-   Right-click on the **DatabaseFirst.Blogging** database in Server Explorer and select **New Query**
+-   Copy the following SQL into the new query, then right-click on the query and select **Execute**
+
+``` SQL
+CREATE TABLE [dbo].[Users]
+(
+    [Username] NVARCHAR(50) NOT NULL PRIMARY KEY,  
+    [DisplayName] NVARCHAR(MAX) NULL
+)
+```
+
+Now that the schema is updated, it’s time to update the model with those changes.
+
+-   Right-click on an empty spot of your model in the EF Designer and select ‘Update Model from Database…’, this will launch the Update Wizard
+-   On the Add tab of the Update Wizard check the box next to Tables, this indicates that we want to add any new tables from the schema.
+    *The Refresh tab shows any existing tables in the model that will be checked for changes during the update. The Delete tabs show any tables that have been removed from the schema and will also be removed from the model as part of the update. The information on these two tabs is automatically detected and is provided for informational purposes only, you cannot change any settings.*
+
+    ![Refresh Wizard](~/ef6/media/refreshwizard.png)
+
+-   Click Finish on the Update Wizard
+
+ 
+
+The model is now updated to include a new User entity that maps to the Users table we added to the database.
+
+![Model Updated](~/ef6/media/modelupdated.png)
+
+## Summary
+
+In this walkthrough we looked at Database First development, which allowed us to create a model in the EF Designer based on an existing database. We then used that model to read and write some data from the database. Finally, we updated the model to reflect changes we made to the database schema.
diff --git a/entity-framework/ef6/modeling/designer/workflows/model-first.md b/entity-framework/ef6/modeling/designer/workflows/model-first.md
new file mode 100644
index 0000000000..009e4d379f
--- /dev/null
+++ b/entity-framework/ef6/modeling/designer/workflows/model-first.md
@@ -0,0 +1,195 @@
+---
+title: Model First - EF6
+description: Model First in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/modeling/designer/workflows/model-first
+---
+# Model First
+This video and step-by-step walkthrough provide an introduction to Model First development using Entity Framework. Model First allows you to create a new model using the Entity Framework Designer and then generate a database schema from the model. The model is stored in an EDMX file (.edmx extension) and can be viewed and edited in the Entity Framework Designer. The classes that you interact with in your application are automatically generated from the EDMX file.
+
+## Watch the video
+This video and step-by-step walkthrough provide an introduction to Model First development using Entity Framework. Model First allows you to create a new model using the Entity Framework Designer and then generate a database schema from the model. The model is stored in an EDMX file (.edmx extension) and can be viewed and edited in the Entity Framework Designer. The classes that you interact with in your application are automatically generated from the EDMX file.
+
+**Presented By**: [Rowan Miller](https://romiller.com/)
+
+**Video**: [WMV](https://download.microsoft.com/download/5/B/1/5B1C338C-AFA7-4F68-B304-48BB008146EF/HDI-ITPro-MSDN-winvideo-modelfirst.wmv) | [MP4](https://download.microsoft.com/download/5/B/1/5B1C338C-AFA7-4F68-B304-48BB008146EF/HDI-ITPro-MSDN-mp4video-modelfirst.m4v) | [WMV (ZIP)](https://download.microsoft.com/download/5/B/1/5B1C338C-AFA7-4F68-B304-48BB008146EF/HDI-ITPro-MSDN-winvideo-modelfirst.zip)
+
+## Pre-Requisites
+
+You will need to have Visual Studio 2010 or Visual Studio 2012 installed to complete this walkthrough.
+
+If you are using Visual Studio 2010, you will also need to have [NuGet](https://visualstudiogallery.msdn.microsoft.com/27077b70-9dad-4c64-adcf-c7cf6bc9970c) installed.
+
+## 1. Create the Application
+
+To keep things simple we’re going to build a basic console application that uses the Model First to perform data access:
+
+-   Open Visual Studio
+-   **File -&gt; New -&gt; Project…**
+-   Select **Windows** from the left menu and **Console Application**
+-   Enter **ModelFirstSample** as the name
+-   Select **OK**
+
+## 2. Create Model
+
+We’re going to make use of Entity Framework Designer, which is included as part of Visual Studio, to create our model.
+
+-   **Project -&gt; Add New Item…**
+-   Select **Data** from the left menu and then **ADO.NET Entity Data Model**
+-   Enter **BloggingModel** as the name and click **OK**, this launches the Entity Data Model Wizard
+-   Select **Empty Model** and click **Finish**
+
+    ![Create Empty Model](~/ef6/media/createemptymodel.png)
+
+The Entity Framework Designer is opened with a blank model. Now we can start adding entities, properties and associations to the model.
+
+-   Right-click on the design surface and select **Properties**
+-   In the Properties window change the **Entity Container Name** to **BloggingContext**
+    *This is the name of the derived context that will be generated for you, the context represents a session with the database, allowing us to query and save data*
+-   Right-click on the design surface and select **Add New -&gt; Entity…**
+-   Enter **Blog** as the entity name and **BlogId** as the key name and click **OK**
+
+    ![Add Blog Entity](~/ef6/media/addblogentity.png)
+
+-   Right-click on the new entity on the design surface and select **Add New -&gt; Scalar Property**, enter **Name** as the name of the property.
+-   Repeat this process to add a **Url** property.
+-   Right-click on the **Url** property on the design surface and select **Properties**, in the Properties window change the **Nullable** setting to **True**
+    *This allows us to save a Blog to the database without assigning it a Url*
+-   Using the techniques you just learnt, add a **Post** entity with a **PostId** key property
+-   Add **Title** and **Content** scalar properties to the **Post** entity
+
+Now that we have a couple of entities, it’s time to add an association (or relationship) between them.
+
+-   Right-click on the design surface and select **Add New -&gt; Association…**
+-   Make one end of the relationship point to **Blog** with a multiplicity of **One** and the other end point to **Post** with a multiplicity of **Many**
+    *This means that a Blog has many Posts and a Post belongs to one Blog*
+-   Ensure the **Add foreign key properties to 'Post' Entity** box is checked and click **OK**
+
+    ![Add Association MF](~/ef6/media/addassociationmf.png)
+
+We now have a simple model that we can generate a database from and use to read and write data.
+
+![Model Initial](~/ef6/media/modelinitial.png)
+
+### Additional Steps in Visual Studio 2010
+
+If you are working in Visual Studio 2010 there are some additional steps you need to follow to upgrade to the latest version of Entity Framework. Upgrading is important because it gives you access to an improved API surface, that is much easier to use, as well as the latest bug fixes.
+
+First up, we need to get the latest version of Entity Framework from NuGet.
+
+-   **Project –&gt; Manage NuGet Packages…**
+    *If you don’t have the **Manage NuGet Packages…** option you should install the [latest version of NuGet](https://visualstudiogallery.msdn.microsoft.com/27077b70-9dad-4c64-adcf-c7cf6bc9970c)*
+-   Select the **Online** tab
+-   Select the **EntityFramework** package
+-   Click **Install**
+
+Next, we need to swap our model to generate code that makes use of the DbContext API, which was introduced in later versions of Entity Framework.
+
+-   Right-click on an empty spot of your model in the EF Designer and select **Add Code Generation Item…**
+-   Select **Online Templates** from the left menu and search for **DbContext**
+-   Select the EF **5.x DbContext Generator for C\#**, enter **BloggingModel** as the name and click **Add**
+
+    ![DbContext Template](~/ef6/media/dbcontexttemplate.png)
+
+## 3. Generating the Database
+
+Given our model, Entity Framework can calculate a database schema that will allow us to store and retrieve data using the model.
+
+The database server that is installed with Visual Studio is different depending on the version of Visual Studio you have installed:
+
+-   If you are using Visual Studio 2010 you'll be creating a SQL Express database.
+-   If you are using Visual Studio 2012 then you'll be creating a [LocalDB](https://msdn.microsoft.com/library/hh510202(v=sql.110).aspx) database.
+
+Let's go ahead and generate the database.
+
+-   Right-click on the design surface and select **Generate Database from Model…**
+-   Click **New Connection…** and specify either LocalDB or SQL Express, depending on which version of Visual Studio you are using, enter **ModelFirst.Blogging** as the database name.
+
+    ![LocalDB Connection MF](~/ef6/media/localdbconnectionmf.png)
+
+    ![Sql Express Connection MF](~/ef6/media/sqlexpressconnectionmf.png)
+
+-   Select **OK** and you will be asked if you want to create a new database, select **Yes**
+-   Select **Next** and the Entity Framework Designer will calculate a script to create the database schema
+-   Once the script is displayed, click **Finish** and the script will be added to your project and opened
+-   Right-click on the script and select **Execute**, you will be prompted to specify the database to connect to, specify LocalDB or SQL Server Express, depending on which version of Visual Studio you are using
+
+## 4. Reading & Writing Data
+
+Now that we have a model it’s time to use it to access some data. The classes we are going to use to access data are being automatically generated for you based on the EDMX file.
+
+*This screen shot is from Visual Studio 2012, if you are using Visual Studio 2010 the BloggingModel.tt and BloggingModel.Context.tt files will be directly under your project rather than nested under the EDMX file.*
+
+![Generated Classes](~/ef6/media/generatedclasses.png)
+
+Implement the Main method in Program.cs as shown below. This code creates a new instance of our context and then uses it to insert a new Blog. Then it uses a LINQ query to retrieve all Blogs from the database ordered alphabetically by Title.
+
+``` csharp
+class Program
+{
+    static void Main(string[] args)
+    {
+        using (var db = new BloggingContext())
+        {
+            // Create and save a new Blog
+            Console.Write("Enter a name for a new Blog: ");
+            var name = Console.ReadLine();
+
+            var blog = new Blog { Name = name };
+            db.Blogs.Add(blog);
+            db.SaveChanges();
+
+            // Display all Blogs from the database
+            var query = from b in db.Blogs
+                        orderby b.Name
+                        select b;
+
+            Console.WriteLine("All blogs in the database:");
+            foreach (var item in query)
+            {
+                Console.WriteLine(item.Name);
+            }
+
+            Console.WriteLine("Press any key to exit...");
+            Console.ReadKey();
+        }
+    }
+}
+```
+
+You can now run the application and test it out.
+
+```console
+Enter a name for a new Blog: ADO.NET Blog
+All blogs in the database:
+ADO.NET Blog
+Press any key to exit...
+```
+
+## 5. Dealing with Model Changes
+
+Now it’s time to make some changes to our model, when we make these changes we also need to update the database schema.
+
+We’ll start by adding a new User entity to our model.
+
+-   Add a new **User** entity name with **Username** as the key name and **String** as the property type for the key
+
+    ![Add User Entity](~/ef6/media/adduserentity.png)
+
+-   Right-click on the **Username** property on the design surface and select **Properties**, In the Properties window change the **MaxLength** setting to **50**
+    *This restricts the data that can be stored in username to 50 characters*
+-   Add a **DisplayName** scalar property to the **User** entity
+
+We now have an updated model and we are ready to update the database to accommodate our new User entity type.
+
+-   Right-click on the design surface and select **Generate Database from Model…**, Entity Framework will calculate a script to recreate a schema based on the updated model.
+-   Click **Finish**
+-   You may receive warnings about overwriting the existing DDL script and the mapping and storage parts of the model, click **Yes** for both these warnings
+-   The updated SQL script to create the database is opened for you  
+    *The script that is generated will drop all existing tables and then recreate the schema from scratch. This may work for local development but is not a viable for pushing changes to a database that has already been deployed. If you need to publish changes to a database that has already been deployed, you will need to edit the script or use a schema compare tool to calculate a migration script.*
+-   Right-click on the script and select **Execute**, you will be prompted to specify the database to connect to, specify LocalDB or SQL Server Express, depending on which version of Visual Studio you are using
+
+## Summary
+
+In this walkthrough we looked at Model First development, which allowed us to create a model in the EF Designer and then generate a database from that model. We then used the model to read and write some data from the database. Finally, we updated the model and then recreated the database schema to match the model.
diff --git a/entity-framework/ef6/modeling/index.md b/entity-framework/ef6/modeling/index.md
new file mode 100644
index 0000000000..94b9f8d128
--- /dev/null
+++ b/entity-framework/ef6/modeling/index.md
@@ -0,0 +1,51 @@
+---
+title: Creating a Model - EF6
+description: Creating a Model in Entity Framework 6
+author: SamMonoRT
+ms.date: 07/05/2018
+uid: ef6/modeling/index
+---
+# Creating a Model
+
+An EF model stores the details about how application classes and properties map to database tables and columns. There are two main ways to create an EF model:
+
+- **Using Code First**: The developer writes code to specify the model. EF generates the models and mappings at runtime based on entity classes and additional model configuration provided by the developer.
+
+- **Using the EF Designer**: The developer draws boxes and lines to specify the model using the EF Designer. The resulting model is stored as XML in a file with the EDMX extension. The application's domain objects are typically generated automatically from the conceptual model.
+
+## EF workflows
+
+Both of these approaches can be used to target an existing database or create a new database, resulting in 4 different workflows.
+Find out about which one is best for you:  
+
+|                                           | I just want to write code...                                                                                                                   | I want to use a designer...                                                                                                                        |
+|:------------------------------------------|:-----------------------------------------------------------------------------------------------------------------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------|
+| **I am creating a new database**          | [Use **Code First** to define your model in code and then generate a database.](xref:ef6/modeling/code-first/workflows/new-database)           | [Use **Model First** to define your model using boxes and lines and then generate a database.](xref:ef6/modeling/designer/workflows/model-first)   |
+| **I need to access an existing database** | [Use **Code First** to create a code based model that maps to an existing database.](xref:ef6/modeling/code-first/workflows/existing-database) | [Use **Database First** to create a boxes and lines model that maps to an existing database.](xref:ef6/modeling/designer/workflows/database-first) |
+
+### Watch the video: What EF workflow should I use?
+
+This short video explains the differences, and how to find the one that is right for you.
+
+**Presented By**: [Rowan Miller](https://romiller.com/)
+
+![Which Workflow Thumb](../media/whichworkflow-thumb.png)
+ [WMV](https://download.microsoft.com/download/8/F/8/8F81F4CD-3678-4229-8D79-0C63FFA3C595/HDI_ITPro_Technet_winvideo_ChoseYourWorkflow.wmv) | [MP4](https://download.microsoft.com/download/8/F/8/8F81F4CD-3678-4229-8D79-0C63FFA3C595/HDI_ITPro_Technet_mp4video_ChoseYourWorkflow.m4v) | [WMV (ZIP)](https://download.microsoft.com/download/8/F/8/8F81F4CD-3678-4229-8D79-0C63FFA3C595/HDI_ITPro_Technet_winvideo_ChoseYourWorkflow.zip)
+
+If after watching the video you still don't feel comfortable deciding if you want to use the EF Designer or Code First, learn both!
+
+## A look under the hood
+
+Regardless of whether you use Code First or the EF Designer, an EF model always has several components:
+
+- The application's domain objects or entity types themselves. This is often referred to as the object layer
+
+- A conceptual model consisting of domain-specific entity types and relationships, described using the [Entity Data Model](xref:ef6/resources/glossary#entity-data-model). This layer is often referred to with the letter "C", for _conceptual_.
+
+- A storage model representing tables, columns and relationships as defined in the database. This layer is often referred to with the later "S", for _storage_.  
+
+- A mapping between the conceptual model and the database schema. This mapping is often referred to as "C-S" mapping.
+
+EF's mapping engine leverages the "C-S" mapping to transform operations against entities - such as create, read, update, and delete - into equivalent operations against tables in the database.
+
+The mapping between the conceptual model and the application's objects is often referred to as "O-C" mapping. Compared to the "C-S" mapping, "O-C" mapping is implicit and one-to-one: entities, properties and relationships defined in the conceptual model are required to match the shapes and types of the .NET objects. From EF4 and beyond, the objects layer can be composed of simple objects with properties without any dependencies on EF. These are usually referred to as Plain-Old CLR Objects (POCO) and mapping of types and properties is performed base on name matching conventions. Previously, in EF 3.5 there were specific restrictions for the object layer, like entities having to derive from the EntityObject class and having to carry EF attributes to implement the "O-C" mapping.
diff --git a/entity-framework/ef6/querying/index.md b/entity-framework/ef6/querying/index.md
new file mode 100644
index 0000000000..e7149479bc
--- /dev/null
+++ b/entity-framework/ef6/querying/index.md
@@ -0,0 +1,85 @@
+---
+title: Querying and Finding Entities - EF6
+description: Querying and Finding Entities in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/querying/index
+---
+# Querying and Finding Entities
+This topic covers the various ways you can query for data using Entity Framework, including LINQ and the Find method. The techniques shown in this topic apply equally to models created with Code First and the EF Designer.  
+
+## Finding entities using a query  
+
+DbSet and IDbSet implement IQueryable and so can be used as the starting point for writing a LINQ query against the database. This is not the appropriate place for an in-depth discussion of LINQ, but here are a couple of simple examples:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    // Query for all blogs with names starting with B
+    var blogs = from b in context.Blogs
+                   where b.Name.StartsWith("B")
+                   select b;
+
+    // Query for the Blog named ADO.NET Blog
+    var blog = context.Blogs
+                    .Where(b => b.Name == "ADO.NET Blog")
+                    .FirstOrDefault();
+}
+```  
+
+Note that DbSet and IDbSet always create queries against the database and will always involve a round trip to the database even if the entities returned already exist in the context. A query is executed against the database when:  
+
+- It is enumerated by a **foreach** (C#) or **For Each** (Visual Basic) statement.  
+- It is enumerated by a collection operation such as [ToArray](https://msdn.microsoft.com/library/bb298736), [ToDictionary](https://msdn.microsoft.com/library/system.linq.enumerable.todictionary), or [ToList](https://msdn.microsoft.com/library/bb342261).  
+- LINQ operators such as [First](https://msdn.microsoft.com/library/bb291976) or [Any](https://msdn.microsoft.com/library/bb337697) are specified in the outermost part of the query.  
+- The following methods are called: the [Load](https://msdn.microsoft.com/library/system.data.entity.dbextensions.load) extension method on a DbSet, [DbEntityEntry.Reload](https://msdn.microsoft.com/library/system.data.entity.infrastructure.dbentityentry.reload.aspx), and Database.ExecuteSqlCommand.  
+
+When results are returned from the database, objects that do not exist in the context are attached to the context. If an object is already in the context, the existing object is returned (the current and original values of the object's properties in the entry are **not** overwritten with database values).  
+
+When you perform a query, entities that have been added to the context but have not yet been saved to the database are not returned as part of the result set. To get the data that is in the context, see [Local Data](xref:ef6/querying/local-data).  
+
+If a query returns no rows from the database, the result will be an empty collection, rather than **null**.  
+
+## Finding entities using primary keys  
+
+The Find method on DbSet uses the primary key value to attempt to find an entity tracked by the context. If the entity is not found in the context then a query will be sent to the database to find the entity there. Null is returned if the entity is not found in the context or in the database.  
+
+Find is different from using a query in two significant ways:  
+
+- A round-trip to the database will only be made if the entity with the given key is not found in the context.  
+- Find will return entities that are in the Added state. That is, Find will return entities that have been added to the context but have not yet been saved to the database.  
+### Finding an entity by primary key  
+
+The following code shows some uses of Find:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    // Will hit the database
+    var blog = context.Blogs.Find(3);
+
+    // Will return the same instance without hitting the database
+    var blogAgain = context.Blogs.Find(3);
+
+    context.Blogs.Add(new Blog { Id = -1 });
+
+    // Will find the new blog even though it does not exist in the database
+    var newBlog = context.Blogs.Find(-1);
+
+    // Will find a User which has a string primary key
+    var user = context.Users.Find("johndoe1987");
+}
+```  
+
+### Finding an entity by composite primary key  
+
+Entity Framework allows your entities to have composite keys - that's a key that is made up of more than one property. For example, you could have a BlogSettings entity that represents a users settings for a particular blog. Because a user would only ever have one BlogSettings for each blog you could chose to make the primary key of BlogSettings a combination of BlogId and Username. The following code attempts to find the BlogSettings with BlogId = 3 and Username = "johndoe1987":  
+
+``` csharp  
+using (var context = new BloggingContext())
+{
+    var settings = context.BlogSettings.Find(3, "johndoe1987");
+}
+```  
+
+Note that when you have composite keys you need to use ColumnAttribute or the fluent API to specify an ordering for the properties of the composite key. The call to Find must use this order when specifying the values that form the key.  
diff --git a/entity-framework/ef6/querying/load-method.md b/entity-framework/ef6/querying/load-method.md
new file mode 100644
index 0000000000..2dcf7e5ae5
--- /dev/null
+++ b/entity-framework/ef6/querying/load-method.md
@@ -0,0 +1,41 @@
+---
+title: The Load Method - EF6
+description: The Load Method in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/querying/load-method
+---
+# The Load Method
+There are several scenarios where you may want to load entities from the database into the context without immediately doing anything with those entities. A good example of this is loading entities for data binding as described in [Local Data](xref:ef6/querying/local-data). One common way to do this is to write a LINQ query and then call ToList on it, only to immediately discard the created list. The Load extension method works just like ToList except that it avoids the creation of the list altogether.  
+
+The techniques shown in this topic apply equally to models created with Code First and the EF Designer.  
+
+Here are two examples of using Load. The first is taken from a Windows Forms data binding application where Load is used to query for entities before binding to the local collection, as described in [Local Data](xref:ef6/querying/local-data):  
+
+``` csharp
+protected override void OnLoad(EventArgs e)
+{
+    base.OnLoad(e);
+
+    _context = new ProductContext();
+
+    _context.Categories.Load();
+    categoryBindingSource.DataSource = _context.Categories.Local.ToBindingList();
+}
+```  
+
+The second example shows using Load to load a filtered collection of related entities, as described in [Loading Related Entities](xref:ef6/querying/related-data):  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var blog = context.Blogs.Find(1);
+
+    // Load the posts with the 'entity-framework' tag related to a given blog
+    context.Entry(blog)
+        .Collection(b => b.Posts)
+        .Query()
+        .Where(p => p.Tags.Contains("entity-framework"))
+        .Load();
+}
+```  
diff --git a/entity-framework/ef6/querying/local-data.md b/entity-framework/ef6/querying/local-data.md
new file mode 100644
index 0000000000..6f9cfb8c6e
--- /dev/null
+++ b/entity-framework/ef6/querying/local-data.md
@@ -0,0 +1,326 @@
+---
+title: Local Data - EF6
+description: Local Data in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/querying/local-data
+---
+# Local Data
+Running a LINQ query directly against a DbSet will always send a query to the database, but you can access the data that is currently in-memory using the DbSet.Local property. You can also access the extra information EF is tracking about your entities using the DbContext.Entry and DbContext.ChangeTracker.Entries methods. The techniques shown in this topic apply equally to models created with Code First and the EF Designer.  
+
+## Using Local to look at local data  
+
+The Local property of DbSet provides simple access to the entities of the set that are currently being tracked by the context and have not been marked as Deleted. Accessing the Local property never causes a query to be sent to the database. This means that it is usually used after a query has already been performed. The Load extension method can be used to execute a query so that the context tracks the results. For example:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    // Load all blogs from the database into the context
+    context.Blogs.Load();
+
+    // Add a new blog to the context
+    context.Blogs.Add(new Blog { Name = "My New Blog" });
+
+    // Mark one of the existing blogs as Deleted
+    context.Blogs.Remove(context.Blogs.Find(1));
+
+    // Loop over the blogs in the context.
+    Console.WriteLine("In Local: ");
+    foreach (var blog in context.Blogs.Local)
+    {
+        Console.WriteLine(
+            "Found {0}: {1} with state {2}",
+            blog.BlogId,  
+            blog.Name,
+            context.Entry(blog).State);
+    }
+
+    // Perform a query against the database.
+    Console.WriteLine("\nIn DbSet query: ");
+    foreach (var blog in context.Blogs)
+    {
+        Console.WriteLine(
+            "Found {0}: {1} with state {2}",
+            blog.BlogId,  
+            blog.Name,
+            context.Entry(blog).State);
+    }
+}
+```  
+
+If we had two blogs in the database - 'ADO.NET Blog' with a BlogId of 1 and 'The Visual Studio Blog' with a BlogId of 2 - we could expect the following output:  
+
+```console
+In Local:
+Found 0: My New Blog with state Added
+Found 2: The Visual Studio Blog with state Unchanged
+
+In DbSet query:
+Found 1: ADO.NET Blog with state Deleted
+Found 2: The Visual Studio Blog with state Unchanged
+```  
+
+This illustrates three points:  
+
+- The new blog 'My New Blog' is included in the Local collection even though it has not yet been saved to the database. This blog has a primary key of zero because the database has not yet generated a real key for the entity.  
+- The 'ADO.NET Blog' is not included in the local collection even though it is still being tracked by the context. This is because we removed it from the DbSet thereby marking it as deleted.  
+- When DbSet is used to perform a query the blog marked for deletion (ADO.NET Blog) is included in the results and the new blog (My New Blog) that has not yet been saved to the database is not included in the results. This is because DbSet is performing a query against the database and the results returned always reflect what is in the database.  
+
+## Using Local to add and remove entities from the context  
+
+The Local property on DbSet returns an [ObservableCollection](https://msdn.microsoft.com/library/ms668604.aspx) with events hooked up such that it stays in sync with the contents of the context. This means that entities can be added or removed from either the Local collection or the DbSet. It also means that queries that bring new entities into the context will result in the Local collection being updated with those entities. For example:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    // Load some posts from the database into the context
+    context.Posts.Where(p => p.Tags.Contains("entity-framework")).Load();  
+
+    // Get the local collection and make some changes to it
+    var localPosts = context.Posts.Local;
+    localPosts.Add(new Post { Name = "What's New in EF" });
+    localPosts.Remove(context.Posts.Find(1));  
+
+    // Loop over the posts in the context.
+    Console.WriteLine("In Local after entity-framework query: ");
+    foreach (var post in context.Posts.Local)
+    {
+        Console.WriteLine(
+            "Found {0}: {1} with state {2}",
+            post.Id,  
+            post.Title,
+            context.Entry(post).State);
+    }
+
+    var post1 = context.Posts.Find(1);
+    Console.WriteLine(
+        "State of post 1: {0} is {1}",
+        post1.Name,  
+        context.Entry(post1).State);  
+
+    // Query some more posts from the database
+    context.Posts.Where(p => p.Tags.Contains("asp.net")).Load();  
+
+    // Loop over the posts in the context again.
+    Console.WriteLine("\nIn Local after asp.net query: ");
+    foreach (var post in context.Posts.Local)
+    {
+        Console.WriteLine(
+            "Found {0}: {1} with state {2}",
+            post.Id,  
+            post.Title,
+            context.Entry(post).State);
+    }
+}
+```  
+
+Assuming we had a few posts tagged with 'entity-framework' and 'asp.net' the output may look something like this:  
+
+```console
+In Local after entity-framework query:
+Found 3: EF Designer Basics with state Unchanged
+Found 5: EF Code First Basics with state Unchanged
+Found 0: What's New in EF with state Added
+State of post 1: EF Beginners Guide is Deleted
+
+In Local after asp.net query:
+Found 3: EF Designer Basics with state Unchanged
+Found 5: EF Code First Basics with state Unchanged
+Found 0: What's New in EF with state Added
+Found 4: ASP.NET Beginners Guide with state Unchanged
+```  
+
+This illustrates three points:  
+
+- The new post 'What's New in EF' that was added to the Local collection becomes tracked by the context in the Added state. It will therefore be inserted into the database when SaveChanges is called.  
+- The post that was removed from the Local collection (EF Beginners Guide) is now marked as deleted in the context. It will therefore be deleted from the database when SaveChanges is called.  
+- The additional post (ASP.NET Beginners Guide) loaded into the context with the second query is automatically added to the Local collection.  
+
+One final thing to note about Local is that because it is an ObservableCollection performance is not great for large numbers of entities. Therefore if you are dealing with thousands of entities in your context it may not be advisable to use Local.  
+
+## Using Local for WPF data binding  
+
+The Local property on DbSet can be used directly for data binding in a WPF application because it is an instance of ObservableCollection. As described in the previous sections this means that it will automatically stay in sync with the contents of the context and the contents of the context will automatically stay in sync with it. Note that you do need to pre-populate the Local collection with data for there to be anything to bind to since Local never causes a database query.  
+
+This is not an appropriate place for a full WPF data binding sample but the key elements are:  
+
+- Setup a binding source  
+- Bind it to the Local property of your set  
+- Populate Local using a query to the database.  
+
+## WPF binding to navigation properties  
+
+If you are doing master/detail data binding you may want to bind the detail view to a navigation property of one of your entities. An easy way to make this work is to use an ObservableCollection for the navigation property. For example:  
+
+``` csharp
+public class Blog
+{
+    private readonly ObservableCollection<Post> _posts =
+        new ObservableCollection<Post>();
+
+    public int BlogId { get; set; }
+    public string Name { get; set; }
+
+    public virtual ObservableCollection<Post> Posts
+    {
+        get { return _posts; }
+    }
+}
+```  
+
+## Using Local to clean up entities in SaveChanges  
+
+In most cases entities removed from a navigation property will not be automatically marked as deleted in the context. For example, if you remove a Post object from the Blog.Posts collection then that post will not be automatically deleted when SaveChanges is called. If you need it to be deleted then you may need to find these dangling entities and mark them as deleted before calling SaveChanges or as part of an overridden SaveChanges. For example:  
+
+``` csharp
+public override int SaveChanges()
+{
+    foreach (var post in this.Posts.Local.ToList())
+    {
+        if (post.Blog == null)
+        {
+            this.Posts.Remove(post);
+        }
+    }
+
+    return base.SaveChanges();
+}
+```  
+
+The code above uses the Local collection to find all posts and marks any that do not have a blog reference as deleted. The ToList call is required because otherwise the collection will be modified by the Remove call while it is being enumerated. In most other situations you can query directly against the Local property without using ToList first.  
+
+## Using Local and ToBindingList for Windows Forms data binding  
+
+Windows Forms does not support full fidelity data binding using ObservableCollection directly. However, you can still use the DbSet Local property for data binding to get all the benefits described in the previous sections. This is achieved through the ToBindingList extension method which creates an [IBindingList](https://msdn.microsoft.com/library/system.componentmodel.ibindinglist.aspx) implementation backed by the Local ObservableCollection.  
+
+This is not an appropriate place for a full Windows Forms data binding sample but the key elements are:  
+
+- Setup an object binding source  
+- Bind it to the Local property of your set using Local.ToBindingList()  
+- Populate Local using a query to the database  
+
+## Getting detailed information about tracked entities  
+
+Many of the examples in this series use the Entry method to return a DbEntityEntry instance for an entity. This entry object then acts as the starting point for gathering information about the entity such as its current state, as well as for performing operations on the entity such as explicitly loading a related entity.  
+
+The Entries methods return DbEntityEntry objects for many or all entities being tracked by the context. This allows you to gather information or perform operations on many entities rather than just a single entry. For example:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    // Load some entities into the context
+    context.Blogs.Load();
+    context.Authors.Load();
+    context.Readers.Load();
+
+    // Make some changes
+    context.Blogs.Find(1).Title = "The New ADO.NET Blog";
+    context.Blogs.Remove(context.Blogs.Find(2));
+    context.Authors.Add(new Author { Name = "Jane Doe" });
+    context.Readers.Find(1).Username = "johndoe1987";
+
+    // Look at the state of all entities in the context
+    Console.WriteLine("All tracked entities: ");
+    foreach (var entry in context.ChangeTracker.Entries())
+    {
+        Console.WriteLine(
+            "Found entity of type {0} with state {1}",
+            ObjectContext.GetObjectType(entry.Entity.GetType()).Name,
+            entry.State);
+    }
+
+    // Find modified entities of any type
+    Console.WriteLine("\nAll modified entities: ");
+    foreach (var entry in context.ChangeTracker.Entries()
+                              .Where(e => e.State == EntityState.Modified))
+    {
+        Console.WriteLine(
+            "Found entity of type {0} with state {1}",
+            ObjectContext.GetObjectType(entry.Entity.GetType()).Name,
+            entry.State);
+    }
+
+    // Get some information about just the tracked blogs
+    Console.WriteLine("\nTracked blogs: ");
+    foreach (var entry in context.ChangeTracker.Entries<Blog>())
+    {
+        Console.WriteLine(
+            "Found Blog {0}: {1} with original Name {2}",
+            entry.Entity.BlogId,  
+            entry.Entity.Name,
+            entry.Property(p => p.Name).OriginalValue);
+    }
+
+    // Find all people (author or reader)
+    Console.WriteLine("\nPeople: ");
+    foreach (var entry in context.ChangeTracker.Entries<IPerson>())
+    {
+        Console.WriteLine("Found Person {0}", entry.Entity.Name);
+    }
+}
+```  
+
+You'll notice we are introducing an Author and Reader class into the example - both of these classes implement the IPerson interface.  
+
+``` csharp
+public class Author : IPerson
+{
+    public int AuthorId { get; set; }
+    public string Name { get; set; }
+    public string Biography { get; set; }
+}
+
+public class Reader : IPerson
+{
+    public int ReaderId { get; set; }
+    public string Name { get; set; }
+    public string Username { get; set; }
+}
+
+public interface IPerson
+{
+    string Name { get; }
+}
+```  
+
+Let's assume we have the following data in the database:
+
+Blog with BlogId = 1 and Name = 'ADO.NET Blog'  
+Blog with BlogId = 2 and Name = 'The Visual Studio Blog'  
+Blog with BlogId = 3 and Name = '.NET Framework Blog'  
+Author with AuthorId = 1 and Name = 'Joe Bloggs'  
+Reader with ReaderId = 1 and Name = 'John Doe'  
+
+The output from running the code would be:  
+
+```console
+All tracked entities:
+Found entity of type Blog with state Modified
+Found entity of type Blog with state Deleted
+Found entity of type Blog with state Unchanged
+Found entity of type Author with state Unchanged
+Found entity of type Author with state Added
+Found entity of type Reader with state Modified
+
+All modified entities:
+Found entity of type Blog with state Modified
+Found entity of type Reader with state Modified
+
+Tracked blogs:
+Found Blog 1: The New ADO.NET Blog with original Name ADO.NET Blog
+Found Blog 2: The Visual Studio Blog with original Name The Visual Studio Blog
+Found Blog 3: .NET Framework Blog with original Name .NET Framework Blog
+
+People:
+Found Person John Doe
+Found Person Joe Bloggs
+Found Person Jane Doe
+```  
+
+These examples illustrate several points:  
+
+- The Entries methods return entries for entities in all states, including Deleted. Compare this to Local which excludes Deleted entities.  
+- Entries for all entity types are returned when the non-generic Entries method is used. When the generic entries method is used entries are only returned for entities that are instances of the generic type. This was used above to get entries for all blogs. It was also used to get entries for all entities that implement IPerson. This demonstrates that the generic type does not have to be an actual entity type.  
+- LINQ to Objects can be used to filter the results returned. This was used above to find entities of any type as long as they are modified.  
+
+Note that DbEntityEntry instances always contain a non-null Entity. Relationship entries and stub entries are not represented as DbEntityEntry instances so there is no need to filter for these.
diff --git a/entity-framework/ef6/querying/no-tracking.md b/entity-framework/ef6/querying/no-tracking.md
new file mode 100644
index 0000000000..81e9f707af
--- /dev/null
+++ b/entity-framework/ef6/querying/no-tracking.md
@@ -0,0 +1,25 @@
+---
+title: No-Tracking Queries - EF6
+description: No-Tracking Queries in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/querying/no-tracking
+---
+# No-Tracking Queries
+Sometimes you may want to get entities back from a query but not have those entities be tracked by the context. This may result in better performance when querying for large numbers of entities in read-only scenarios. The techniques shown in this topic apply equally to models created with Code First and the EF Designer.  
+
+A new extension method AsNoTracking allows any query to be run in this way. For example:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    // Query for all blogs without tracking them
+    var blogs1 = context.Blogs.AsNoTracking();
+
+    // Query for some blogs without tracking them
+    var blogs2 = context.Blogs
+                        .Where(b => b.Name.Contains(".NET"))
+                        .AsNoTracking()
+                        .ToList();
+}
+```  
diff --git a/entity-framework/ef6/querying/raw-sql.md b/entity-framework/ef6/querying/raw-sql.md
new file mode 100644
index 0000000000..f7e54a6890
--- /dev/null
+++ b/entity-framework/ef6/querying/raw-sql.md
@@ -0,0 +1,81 @@
+---
+title: Raw SQL Queries - EF6
+description: Raw SQL Queries in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/querying/raw-sql
+---
+# Raw SQL Queries (EF6)
+
+Entity Framework allows you to query using LINQ with your entity classes. However, there may be times that you want to run queries using raw SQL directly against the database. This includes calling stored procedures, which can be helpful for Code First models that currently do not support mapping to stored procedures. The techniques shown in this topic apply equally to models created with Code First and the EF Designer.  
+
+## Writing SQL queries for entities  
+
+The SqlQuery method on DbSet allows a raw SQL query to be written that will return entity instances. The returned objects will be tracked by the context just as they would be if they were returned by a LINQ query. For example:  
+
+``` csharp  
+using (var context = new BloggingContext())
+{
+    var blogs = context.Blogs.SqlQuery("SELECT * FROM dbo.Blogs").ToList();
+}
+```  
+
+Note that, just as for LINQ queries, the query is not executed until the results are enumerated—in the example above this is done with the call to ToList.  
+
+Care should be taken whenever raw SQL queries are written for two reasons. First, the query should be written to ensure that it only returns entities that are really of the requested type. For example, when using features such as inheritance it is easy to write a query that will create entities that are of the wrong CLR type.  
+
+Second, some types of raw SQL query expose potential security risks, especially around SQL injection attacks. Make sure that you use parameters in your query in the correct way to guard against such attacks.  
+
+### Loading entities from stored procedures  
+
+You can use DbSet.SqlQuery to load entities from the results of a stored procedure. For example, the following code calls the dbo.GetBlogs procedure in the database:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var blogs = context.Blogs.SqlQuery("dbo.GetBlogs").ToList();
+}
+```  
+
+You can also pass parameters to a stored procedure using the following syntax:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var blogId = 1;
+
+    var blogs = context.Blogs.SqlQuery("dbo.GetBlogById @p0", blogId).Single();
+}
+```  
+
+## Writing SQL queries for non-entity types  
+
+A SQL query returning instances of any type, including primitive types, can be created using the SqlQuery method on the Database class. For example:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var blogNames = context.Database.SqlQuery<string>(
+                       "SELECT Name FROM dbo.Blogs").ToList();
+}
+```  
+
+The results returned from SqlQuery on Database will never be tracked by the context even if the objects are instances of an entity type.  
+
+## Sending raw commands to the database  
+
+Non-query commands can be sent to the database using the ExecuteSqlCommand method on Database. For example:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    context.Database.ExecuteSqlCommand(
+        "UPDATE dbo.Blogs SET Name = 'Another Name' WHERE BlogId = 1");
+}
+```  
+
+Note that any changes made to data in the database using ExecuteSqlCommand are opaque to the context until entities are loaded or reloaded from the database.  
+
+### Output Parameters  
+
+If output parameters are used, their values will not be available until the results have been read completely. This is due to the underlying behavior of DbDataReader, see [Retrieving Data Using a DataReader](https://go.microsoft.com/fwlink/?LinkID=398589) for more details.  
diff --git a/entity-framework/ef6/querying/related-data.md b/entity-framework/ef6/querying/related-data.md
new file mode 100644
index 0000000000..fbed6a59b3
--- /dev/null
+++ b/entity-framework/ef6/querying/related-data.md
@@ -0,0 +1,211 @@
+---
+title: Loading Related Entities - EF6
+description: Loading Related Entities in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/querying/related-data
+---
+# Loading Related Entities
+
+Entity Framework supports three ways to load related data - eager loading, lazy loading and explicit loading. The techniques shown in this topic apply equally to models created with Code First and the EF Designer.
+
+## Eagerly Loading
+
+Eager loading is the process whereby a query for one type of entity also loads related entities as part of the query. Eager loading is achieved by use of the Include method. For example, the queries below will load blogs and all the posts related to each blog.
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    // Load all blogs and related posts.
+    var blogs1 = context.Blogs
+                        .Include(b => b.Posts)
+                        .ToList();
+
+    // Load one blog and its related posts.
+    var blog1 = context.Blogs
+                       .Where(b => b.Name == "ADO.NET Blog")
+                       .Include(b => b.Posts)
+                       .FirstOrDefault();
+
+    // Load all blogs and related posts
+    // using a string to specify the relationship.
+    var blogs2 = context.Blogs
+                        .Include("Posts")
+                        .ToList();
+
+    // Load one blog and its related posts
+    // using a string to specify the relationship.
+    var blog2 = context.Blogs
+                       .Where(b => b.Name == "ADO.NET Blog")
+                       .Include("Posts")
+                       .FirstOrDefault();
+}
+```
+
+> [!NOTE]
+> Include is an extension method in the System.Data.Entity namespace so make sure you are using that namespace.
+
+### Eagerly loading multiple levels
+
+It is also possible to eagerly load multiple levels of related entities. The queries below show examples of how to do this for both collection and reference navigation properties.  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    // Load all blogs, all related posts, and all related comments.
+    var blogs1 = context.Blogs
+                        .Include(b => b.Posts.Select(p => p.Comments))
+                        .ToList();
+
+    // Load all users, their related profiles, and related avatar.
+    var users1 = context.Users
+                        .Include(u => u.Profile.Avatar)
+                        .ToList();
+
+    // Load all blogs, all related posts, and all related comments  
+    // using a string to specify the relationships.
+    var blogs2 = context.Blogs
+                        .Include("Posts.Comments")
+                        .ToList();
+
+    // Load all users, their related profiles, and related avatar  
+    // using a string to specify the relationships.
+    var users2 = context.Users
+                        .Include("Profile.Avatar")
+                        .ToList();
+}
+```  
+
+> [!NOTE]
+> It is not currently possible to filter which related entities are loaded. Include will always bring in all related entities.  
+
+## Lazy Loading
+
+Lazy loading is the process whereby an entity or collection of entities is automatically loaded from the database the first time that a property referring to the entity/entities is accessed. When using POCO entity types, lazy loading is achieved by creating instances of derived proxy types and then overriding virtual properties to add the loading hook. For example, when using the Blog entity class defined below, the related Posts will be loaded the first time the Posts navigation property is accessed:
+
+``` csharp
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Name { get; set; }
+    public string Url { get; set; }
+    public string Tags { get; set; }
+
+    public virtual ICollection<Post> Posts { get; set; }
+}
+```
+
+### Turn lazy loading off for serialization
+
+Lazy loading and serialization don’t mix well, and if you aren’t careful you can end up querying for your entire database just because lazy loading is enabled. Most serializers work by accessing each property on an instance of a type. Property access triggers lazy loading, so more entities get serialized. On those entities properties are accessed, and even more entities are loaded. It’s a good practice to turn lazy loading off before you serialize an entity. The following sections show how to do this.
+
+### Turning off lazy loading for specific navigation properties
+
+Lazy loading of the Posts collection can be turned off by making the Posts property non-virtual:
+
+``` csharp
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Name { get; set; }
+    public string Url { get; set; }
+    public string Tags { get; set; }
+
+    public ICollection<Post> Posts { get; set; }
+}
+```
+
+Loading of the Posts collection can still be achieved using eager loading (see *Eagerly Loading* above) or the Load method (see *Explicitly Loading* below).
+
+### Turn off lazy loading for all entities
+
+Lazy loading can be turned off for all entities in the context by setting a flag on the Configuration property. For example:
+
+``` csharp
+public class BloggingContext : DbContext
+{
+    public BloggingContext()
+    {
+        this.Configuration.LazyLoadingEnabled = false;
+    }
+}
+```
+
+Loading of related entities can still be achieved using eager loading (see *Eagerly Loading* above) or the Load method (see *Explicitly Loading* below).
+
+## Explicitly Loading
+
+Even with lazy loading disabled it is still possible to lazily load related entities, but it must be done with an explicit call. To do so you use the Load method on the related entity’s entry. For example:
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var post = context.Posts.Find(2);
+
+    // Load the blog related to a given post.
+    context.Entry(post).Reference(p => p.Blog).Load();
+
+    // Load the blog related to a given post using a string.
+    context.Entry(post).Reference("Blog").Load();
+
+    var blog = context.Blogs.Find(1);
+
+    // Load the posts related to a given blog.
+    context.Entry(blog).Collection(p => p.Posts).Load();
+
+    // Load the posts related to a given blog
+    // using a string to specify the relationship.
+    context.Entry(blog).Collection("Posts").Load();
+}
+```
+
+> [!NOTE]
+> The Reference method should be used when an entity has a navigation property to another single entity. On the other hand, the Collection method should be used when an entity has a navigation property to a collection of other entities.
+
+### Applying filters when explicitly loading related entities
+
+The Query method provides access to the underlying query that Entity Framework will use when loading related entities. You can then use LINQ to apply filters to the query before executing it with a call to a LINQ extension method such as ToList, Load, etc. The Query method can be used with both reference and collection navigation properties but is most useful for collections where it can be used to load only part of the collection. For example:
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var blog = context.Blogs.Find(1);
+
+    // Load the posts with the 'entity-framework' tag related to a given blog.
+    context.Entry(blog)
+           .Collection(b => b.Posts)
+           .Query()
+           .Where(p => p.Tags.Contains("entity-framework"))
+           .Load();
+
+    // Load the posts with the 'entity-framework' tag related to a given blog
+    // using a string to specify the relationship.
+    context.Entry(blog)
+           .Collection("Posts")
+           .Query()
+           .Where(p => p.Tags.Contains("entity-framework"))
+           .Load();
+}
+```
+
+When using the Query method it is usually best to turn off lazy loading for the navigation property. This is because otherwise the entire collection may get loaded automatically by the lazy loading mechanism either before or after the filtered query has been executed.
+
+> [!NOTE]
+> While the relationship can be specified as a string instead of a lambda expression, the returned IQueryable is not generic when a string is used and so the Cast method is usually needed before anything useful can be done with it.
+
+## Using Query to count related entities without loading them
+
+Sometimes it is useful to know how many entities are related to another entity in the database without actually incurring the cost of loading all those entities. The Query method with the LINQ Count method can be used to do this. For example:
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var blog = context.Blogs.Find(1);
+
+    // Count how many posts the blog has.
+    var postCount = context.Entry(blog)
+                           .Collection(b => b.Posts)
+                           .Query()
+                           .Count();
+}
+```
diff --git a/entity-framework/ef6/resources/blogs.md b/entity-framework/ef6/resources/blogs.md
new file mode 100644
index 0000000000..1e9d4ccb6f
--- /dev/null
+++ b/entity-framework/ef6/resources/blogs.md
@@ -0,0 +1,28 @@
+---
+title: Entity Framework Blogs - EF6
+description: Entity Framework 6 Blogs
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework Blogs
+Besides the product documentation, these blogs can be a source of useful information on Entity Framework:
+
+## EF Team blogs
+
+- [.NET Blog - Tag: Entity Framework](https://blogs.msdn.microsoft.com/dotnet/tag/entity-framework/)
+- [ADO.NET Blog (no longer in use)](https://blogs.msdn.microsoft.com/adonet/)
+- [EF Design Blog (no longer in use)](https://blogs.msdn.microsoft.com/efdesign/)
+
+## Current and former EF team bloggers
+
+- [Arthur Vickers](https://blog.oneunicorn.com/)
+- [Brice Lambson](https://www.bricelam.net/)
+- [Diego Vega](https://blogs.msdn.microsoft.com/diego/)
+- [Rowan Miller](https://romiller.com/category/entity-framework/)
+- [Pawel Kadluczka](https://blog.3d-logic.com/category/entity-framework/)
+- [Alex James](https://blogs.msdn.microsoft.com/alexj/)
+- [Zlatko Michailov](https://blogs.msdn.microsoft.com/esql/)
+
+## EF Community Bloggers
+
+- [Julie Lerman](https://thedatafarm.com/blog/)  
diff --git a/entity-framework/ef6/resources/case-studies.md b/entity-framework/ef6/resources/case-studies.md
new file mode 100644
index 0000000000..3efe63008b
--- /dev/null
+++ b/entity-framework/ef6/resources/case-studies.md
@@ -0,0 +1,51 @@
+---
+title: Case Studies for Entity Framework - EF6
+description: Case Studies for Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Microsoft Case Studies for Entity Framework
+The case studies on this page highlight a few real-world production projects that have employed Entity Framework.
+> [!NOTE]
+> The detailed versions of these case studies are no longer available on the Microsoft website. Therefore the links have been removed.
+
+## Epicor
+Epicor is a large global software company (with over 400 developers) that develops Enterprise Resource Planning (ERP) solutions for companies in more than 150 countries.
+Their flagship product, Epicor 9, is based on a Service-Oriented Architecture (SOA) using the .NET Framework.
+Faced with numerous customer requests to provide support for Language Integrated Query (LINQ), and also wanting to reduce the load on their back-end SQL Servers, the team decided to upgrade to Visual Studio 2010 and the .NET Framework 4.0.
+Using the Entity Framework 4.0, they were able to achieve these goals and also greatly simplify development and maintenance.
+In particular, the Entity Framework’s rich T4 support allowed them to take full control of their generated code and automatically build in performance-saving features such as pre-compiled queries and caching.
+
+> “We conducted some performance tests recently with existing code, and we were able to reduce the requests to SQL Server by 90 percent.
+That is because of the ADO.NET Entity Framework 4.” – Erik Johnson, Vice President, Product Research  
+
+## Veracity Solutions
+Having acquired an event-planning software system that was going to be difficult to maintain and extend over the long-term, Veracity Solutions used Visual Studio 2010 to re-write it as a powerful and easy-to-use Rich Internet Application built on Silverlight 4.
+Using .NET RIA Services, they were able to quickly build a service layer on top of the Entity Framework that avoided code duplication and allowed for common validation and authentication logic across tiers.  
+
+> “We were sold on the Entity Framework when it was first introduced, and the Entity Framework 4 has proven to be even better.
+Tooling is improved, and it’s easier to manipulate the .edmx files that define the conceptual model, storage model, and mapping between those models...
+With the Entity Framework, I can get that data access layer working in a day—and build it out as I go along.
+The Entity Framework is our de facto data access layer; I don’t know why anyone wouldn’t use it.” – Joe McBride, Senior Developer
+
+## NEC Display Solutions of America
+NEC wanted to enter the market for digital place-based advertising with a solution to benefit advertisers and network owners and increase its own revenues.
+In order to do that, it launched a pair of web applications that automate the manual processes required in a traditional ad campaign.
+The sites were built using ASP.NET, Silverlight 3, AJAX and WCF, along with the Entity Framework in the data access layer to talk to SQL Server 2008.
+
+> “With SQL Server, we felt we could get the throughput we needed to serve advertisers and networks with information in real time and the reliability to help ensure that the information in our mission-critical applications would always be available”- Mike Corcoran, Director of IT
+
+## Darwin Dimensions
+Using a wide range of Microsoft technologies, the team at Darwin set out to create Evolver - an online avatar portal that consumers could use to create stunning, lifelike avatars for use in games, animations, and social networking pages.
+With the productivity benefits of the Entity Framework, and pulling in components like Windows Workflow Foundation (WF) and Windows Server AppFabric (a highly-scalable in-memory application cache), the team was able to deliver an amazing product in 35% less development time.
+Despite having team members split across multiple countries, the team following an agile development process with weekly releases.
+
+ > “We try not to create technology for technology’s sake. As a startup, it is crucial that we leverage technology that saves time and money.
+ .NET was the choice for fast, cost-effective development.” – Zachary Olsen, Architect  
+
+## Silverware
+With more than 15 years of experience in developing point-of-sale (POS) solutions for small and midsize restaurant groups, the development team at Silverware set out to enhance their product with more enterprise-level features in order to attract larger restaurant chains.
+Using the latest version of Microsoft’s development tools, they were able to build the new solution four times faster than before.
+Key new features like LINQ and the Entity Framework made it easier to move from Crystal Reports to SQL Server 2008 and SQL Server Reporting Services (SSRS) for their data storage and reporting needs.
+
+> “Effective data management is key to the success of SilverWare – and this is why we decided to adopt SQL Reporting.” - Nicholas Romanidis, Director of IT/Software Engineering
diff --git a/entity-framework/ef6/resources/contribute.md b/entity-framework/ef6/resources/contribute.md
new file mode 100644
index 0000000000..69e00b81e6
--- /dev/null
+++ b/entity-framework/ef6/resources/contribute.md
@@ -0,0 +1,13 @@
+---
+title: Contribute to Entity Framework - EF6
+description: Contribute to Entity Framework 6
+author: SamMonoRT
+ms.date: 07/05/2018
+---
+# Contribute to Entity Framework 6
+
+Entity Framework 6 is developed using an open source model on GitHub. Although the main focus of the Entity Framework Team at Microsoft is on adding new features to Entity Framework Core, and we don't expect any major features to be added to Entity Framework 6, we still accept contributions.
+
+For product contributions, please start at the [Contributing wiki page in our GitHub repository](https://github.com/aspnet/EntityFramework6/wiki/Contributing).
+
+For documentation contributions, please start by reading the [contribution guidance](https://github.com/dotnet/EntityFramework.Docs/blob/main/CONTRIBUTING.md) in our documentation repository.
diff --git a/entity-framework/ef6/resources/get-help.md b/entity-framework/ef6/resources/get-help.md
new file mode 100644
index 0000000000..bb1ad923c9
--- /dev/null
+++ b/entity-framework/ef6/resources/get-help.md
@@ -0,0 +1,17 @@
+---
+title: Get Help Using Entity Framework - EF6
+description: Get Help Using Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/resources/get-help
+---
+# Get Help Using Entity Framework
+## ![StackOverflow Questions](~/ef6/media/stackoverflow.png) Questions About Using EF  
+
+The best way to get help using Entity Framework is to [post a question on Stack Overflow](https://stackoverflow.com/questions/ask) using the **entity-framework** tag.  
+
+If you are not familiar with Stack Overflow, be sure to [read the guidelines on asking questions](https://stackoverflow.com/help/asking). In particular, do not use Stack Overflow to report bugs, ask roadmap questions, or suggest new features.  
+
+## ![GitHub Mark](~/ef6/media/github-mark-32px.png) Bug Reports and Feature Requests  
+
+If you have found a bug that you think should be fixed, have a feature you would like to see implemented, or a question you couldn't find an answer to, create an issue on [the EF6 GitHub repository](https://github.com/aspnet/EntityFramework6/issues).
diff --git a/entity-framework/ef6/resources/glossary.md b/entity-framework/ef6/resources/glossary.md
new file mode 100644
index 0000000000..b325dad886
--- /dev/null
+++ b/entity-framework/ef6/resources/glossary.md
@@ -0,0 +1,76 @@
+---
+title: Entity Framework Glossary - EF6
+description: Entity Framework 6 Glossary
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/resources/glossary
+---
+# Entity Framework Glossary
+## Code First
+Creating an Entity Framework model using code. The model can target an existing database or a new database.
+
+## Context
+A class that represents a session with the database, allowing you to query and save data. A context derives from the DbContext or ObjectContext class.
+
+## Convention (Code First)
+A rule that Entity Framework uses to infer the shape of you model from your classes.
+
+## Database First
+Creating an Entity Framework model, using the EF Designer, that targets an existing database.
+
+## Eager loading
+A pattern of loading related data where a query for one type of entity also loads related entities as part of the query.
+
+## EF Designer
+A visual designer in Visual Studio that allows you to create an Entity Framework model using boxes and lines.
+
+## Entity
+A class or object that represents application data such as customers, products, and orders.
+
+## Entity Data Model
+A model that describes entities and the relationships between them. EF uses EDM to describe the conceptual model against which the developer programs. EDM builds on the Entity Relationship model introduced by Dr. Peter Chen. The EDM was originally developed with the primary goal of becoming the common data model across a suite of developer and server technologies from Microsoft. EDM is also used as part of the OData protocol.
+
+## Explicit loading
+A pattern of loading related data where related objects are loaded by calling an API.
+
+## Fluent API
+An API that can be used to configure a Code First model.
+
+## Foreign key association
+An association between entities where a property that represents the foreign key is included in the class of the dependent entity. For example, Product contains a CategoryId property.
+
+## Identifying relationship
+A relationship where the primary key of the principal entity is part of the primary key of the dependent entity. In this kind of relationship, the dependent entity cannot exist without the principal entity.
+
+## Independent association
+An association between entities where there is no property representing the foreign key in the class of the dependent entity. For example, a Product class contains a relationship to Category but no CategoryId property. Entity Framework tracks the state of the association independently of the state of the entities at the two association ends.
+
+## Lazy loading
+A pattern of loading related data where related objects are automatically loaded when a navigation property is accessed.
+
+## Model First
+Creating an Entity Framework model, using the EF Designer, that is then used to create a new database.
+
+## Navigation property
+A property of an entity that references another entity. For example, Product contains a Category navigation property and Category contains a Products navigation property.
+
+## POCO
+Acronym for Plain-Old CLR Object. A simple user class that has no dependencies with any framework. In the context of EF, an entity class that does not derive from EntityObject, implements any interfaces or carries any attributes defined in EF. Such entity classes that are decoupled from the persistence framework are also said to be "persistence ignorant".  
+
+## Relationship inverse
+The opposite end of a relationship, for example, product.Category and category.Product.
+
+## Self-tracking entity
+An entity built from a code generation template that helps with N-Tier development.
+
+## Table-per-concrete type (TPC)
+A method of mapping the inheritance where each non-abstract type in the hierarchy is mapped to separate table in the database.
+
+## Table-per-hierarchy (TPH)
+A method of mapping the inheritance where all types in the hierarchy are mapped to the same table in the database. A discriminator column(s) is used to identify what type each row is associated with.
+
+## Table-per-type (TPT)
+A method of mapping the inheritance where the common properties of all types in the hierarchy are mapped to the same table in the database, but properties unique to each type are mapped to a separate table.
+
+## Type discovery
+The process of identifying the types that should be part of an Entity Framework model.
diff --git a/entity-framework/ef6/resources/licenses/ef5/chs.md b/entity-framework/ef6/resources/licenses/ef5/chs.md
new file mode 100644
index 0000000000..8cf15c4f0a
--- /dev/null
+++ b/entity-framework/ef6/resources/licenses/ef5/chs.md
@@ -0,0 +1,46 @@
+---
+title: Entity Framework 5 License (CHS) - EF6
+description: Entity Framework 5 License (CHS)
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework 5 License (CHS)
+**MICROSOFT 软件补充程序许可条款**
+
+**ENTITY FRAMEWORK 5.0 （适用于 MICROSOFT WINDOWS OPERATING SYSTEM ）**
+
+Microsoft Corporation（或 Microsoft Corporation 在您所在地的关联公司）现授予您本补充程序的许可证。如果您获得了使用 Microsoft Windows Operating System 软件（"软件"）的许可证，您可以使用本补充程序。如果您没有该软件的许可证，则不得使用。您可以将本补充程序用于获得有效许可的每份软件副本。
+
+下列许可条款说明了本补充程序的使用条款。这些条款和软件的许可条款在您使用本补充程序时适用。如果发生冲突，则以这些补充程序许可条款为准。
+
+**使用本补充程序即表示您接受这些条款。如果您不接受这些条款，请不要使用本补充程序。**
+
+**如果您遵守这些许可条款，您将具有下列权利。**
+
+1. **可分发代码。**本补充程序中包含"可分发代码"。"可分发代码"是指，如果您遵守下述条款，则可以在您开发的程序中分发这些代码。
+
+a. **使用和分发权。**
+
+-   您可以复制和分发对象代码形式的补充程序。
+-   *第三方分发*。您可以允许您的程序分销商作为这些程序的一部分复制和分发"可分发代码"。
+
+b. **分发要求。对于您分发的任何可分发代码，您必须**
+
+-   在您的程序中对其增加重要的主要功能；
+-   对于任何文件扩展名为 .lib 的可分发代码，仅分发通过链接器与您的程序一起运行上述可分发代码的结果；
+-   仅分发作为安装程序的一部分包含在安装程序中的未经修改的可分发代码；
+-   要求分销商及外部最终用户同意至少能够像本协议一样保护"可分发代码"的条款；
+-   显示您的程序的有效版权声明；以及
+-   对于与分发或使用您的程序有关的任何索赔，为 Microsoft 提供辩护、赔偿，包括支付律师费，并使 Microsoft 免受损失。
+
+c. **分发限制。您不可以**
+
+-   更改"可分发代码"中的任何版权、商标或专利声明；
+-   在您的程序名称中使用 Microsoft 的商标，或者以其他方式暗示您的程序来自 Microsoft 或经 Microsoft 认可；
+-   分发可分发代码，以便在 Windows 平台以外的任何平台上运行；
+-   在恶意的、欺骗性的或非法的程序中包括可分发代码；或者
+-   修改或分发任何可分发代码的源代码，致使其任何部分受到"排除许可"的制约。"排除许可"指符合以下使用、修改或分发条件的许可：
+    -   以源代码形式披露或分发代码；或
+    -   其他人有权对其进行修改。
+
+2. **对补充程序的支持服务。**Microsoft 为 https://support.microsoft.com/ 中指明的本软件提供支持服务。
diff --git a/entity-framework/ef6/resources/licenses/ef5/cht.md b/entity-framework/ef6/resources/licenses/ef5/cht.md
new file mode 100644
index 0000000000..0e14fc34ed
--- /dev/null
+++ b/entity-framework/ef6/resources/licenses/ef5/cht.md
@@ -0,0 +1,46 @@
+---
+title: Entity Framework 5 License (CHT) - EF6
+description: Entity Framework 5 License (CHT)
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework 5 License (CHT)
+**MICROSOFT 軟體增補程式授權條款**
+
+**ENTITY FRAMEWORK 5.0 之 MICROSOFT WINDOWS OPERATING SYSTEM**
+
+Microsoft 公司（或其關係企業，視　貴用戶所居住的地點而定）授權　貴用戶使用本增補程式。 若　貴用戶取得 Microsoft Windows Operating System 軟體（「軟體」）之使用授權，即可使用本增補程式。　貴用戶若未取得軟體授權，即不得使用本增補程式。　貴用戶擁有之每份有效授權軟體拷貝，均得使用本增補程式。
+
+以下授權款條說明本增補程式之其他使用條款。　貴用戶使用本增補程式時，請遵守上述條款與軟體授權條款。若發生使用爭議，亦適用這些補充的授權條款。
+
+**增補程式一經使用，即表示　貴用戶同意接受這些條款。若　貴用戶不同意這些授權條款，請不要使用本增補程式。**
+
+**若　貴用戶遵守本授權條款，則　貴用戶得享有以下各項權利。**
+
+**1. 可散布程式碼。**增補程式由「可散佈程式碼」構成。「可散布程式碼」係若　貴用戶遵守以下條款，則可於　貴用戶開發的程式中散布之程式碼。
+
+**a. 使用及散布的權利。**
+
+-   　貴用戶得以目的碼形式複製與散布增補程式。
+-   *第三者廠商散布*。　貴用戶得同意程式經銷商將「可散布程式碼」視為　貴用戶那些程式之一部分，進行複製與散布。
+
+**b. 散布要件。針對　貴用戶散布的任何「可散布程式碼」，　貴用戶必須**
+
+-   在程式中，為「可散布程式碼」加入重要的新功能；
+-   針對任何副檔名為 .lib 的「可散布程式碼」，　貴用戶僅得散布透過　貴用戶程式之連結器執行這類「可散布程式碼」所產生的結果；
+-   散布包含於某一安裝程式中的「可散布程式碼」時，僅能做為該安裝程式之一部分進行散布，且不得經過任何修改；
+-   要求散布者及外部終端使用者，需同意「保護『可散布程式碼』的程度不得低於本合約」之相關條款；
+-   在程式中顯示有效的著作權聲明；以及
+-   若因　貴用戶散布或使用程式而使 Microsoft 遭他人提出損害賠償請求權時，　貴用戶應賠償 Microsoft 之損失（包括律師費），為之辯護，並使其不受損害。
+
+**c. 散布限制。　貴用戶不得**
+
+-   變更「可散布程式碼」中之任何著作權、商標或專利聲明；
+-   於　貴用戶的程式名稱使用 Microsoft 的商標，或暗示該程式來自 Microsoft 或由 Microsoft 背書；
+-   散布並於非 Windows 的平台上執行；
+-   將「可散布程式碼」置於惡意、欺騙或違法的程式碼中；或
+-   修改或散布任何「可散布程式碼」的原始碼，如此將會使其任何部分受到「排除性授權」之限制。「排除性授權」係指在使用、修改或散布時，應遵守下列條件：
+    -   程式碼必須以原始碼形式揭露或散布，或
+    -   他人有修改的權利。
+
+**2. 增補程式支援服務。**Microsoft 為軟體提供支援服務之相關說明，請參閱 https://support.microsoft.com/ 。
diff --git a/entity-framework/ef6/resources/licenses/ef5/deu.md b/entity-framework/ef6/resources/licenses/ef5/deu.md
new file mode 100644
index 0000000000..53b6fcbc1e
--- /dev/null
+++ b/entity-framework/ef6/resources/licenses/ef5/deu.md
@@ -0,0 +1,46 @@
+---
+title: Entity Framework 5 License (DEU) - EF6
+description: Entity Framework 5 License (DEU)
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework 5 License (DEU)
+**LIZENZBESTIMMUNGEN FÜR MICROSOFT-SOFTWAREERGÄNZUNG**
+
+**ENTITY FRAMEWORK 5.0 FÜR MICROSOFT WINDOWS OPERATING SYSTEM**
+
+Microsoft Corporation (oder eine andere Microsoft-Konzerngesellschaft, wenn diese an dem Ort, an dem Sie die Software erwerben, die Software lizenziert) lizenziert diese Softwareergänzung an Sie. Wenn Sie über eine Lizenz zur Verwendung der Software Microsoft Windows Operating System (die „Software") verfügen, sind Sie berechtigt, diese Softwareergänzung zu verwenden. Sie sind nicht berechtigt, sie zu verwenden, wenn Sie keine Lizenz für die Software haben. Sie sind berechtigt, diese Softwareergänzung mit jeder ordnungsgemäß lizenzierten Kopie der Software zu verwenden.
+
+In den folgenden Lizenzbestimmungen werden zusätzliche Nutzungsbedingungen für diese Softwareergänzung beschrieben. Diese Bestimmungen und die Lizenzbestimmungen für die Software gelten für Ihre Verwendung der Softwareergänzung. Im Falle eines Widerspruchs gelten diese ergänzenden Lizenzbestimmungen.
+
+**Durch die Verwendung dieser Softwareergänzung erkennen Sie diese Bestimmungen an. Falls Sie die Bestimmungen nicht akzeptieren, sind Sie nicht berechtigt, diese Softwareergänzung zu verwenden.**
+
+**Wenn Sie diese Lizenzbestimmungen einhalten, haben Sie die nachfolgend aufgeführten Rechte.**
+
+**1. VERTREIBBARER CODE.** Die Softwareergänzung besteht aus Vertreibbarem Code. „Vertreibbarer Code" ist Code, den Sie in von Ihnen entwickelten Programmen vertreiben dürfen, wenn Sie die nachfolgenden Bestimmungen einhalten.
+
+**a. Recht zur Nutzung und zum Vertrieb.**
+
+-   Sie sind berechtigt, die Objektcodeform der Softwareergänzung zu kopieren und zu vertreiben.
+-   *Vertrieb durch Dritte.* Sie sind berechtigt, Distributoren Ihrer Programme zu erlauben, den vertreibbaren Code als Teil dieser Programme zu kopieren und zu vertreiben.
+
+**b. Vertriebsbedingungen. Für vertreibbaren Code, den Sie vertreiben, sind Sie verpflichtet:**
+
+-   diesem in Ihren Programmen wesentliche primäre Funktionalität hinzuzufügen
+-   für Vertreibbaren Code mit der Dateinamenerweiterung LIB nur die Ergebnisse des Durchlaufs dieses Vertreibbaren Codes durch einen Linker mit Ihrem Programm zu vertreiben
+-   in einem Setupprogramm enthaltenen Vertreibbaren Code nur als Teil dieses Setupprogramms ohne Änderung zu vertreiben
+-   von Distributoren und externen Endbenutzern die Zustimmung zu Bestimmungen zu verlangen, die einen mindestens gleichwertigen Schutz für ihn bieten wie dieser Vertrag
+-   Ihren gültigen Urheberrechtshinweis auf Ihren Programmen anzubringen
+-   Microsoft freizustellen und gegen alle Ansprüche zu verteidigen, inklusive Anwaltsgebühren, die mit dem Vertrieb oder der Verwendung Ihrer Programme in Zusammenhang stehen.
+
+**c. Vertriebseinschränkungen. Sie sind nicht dazu berechtigt:**
+
+-   Urheberrechts-, Markenrechts- oder Patenthinweise im vertreibbaren Code zu ändern
+-   die Marken von Microsoft in den Namen Ihrer Programme oder auf eine Weise zu verwenden, die nahe legt, dass Ihre Programme von Microsoft stammen oder von Microsoft empfohlen werden
+-   vertreibbaren Code zur Ausführung auf einer anderen Plattform als der Windows-Plattform zu vertreiben
+-   vertreibbaren Code in böswillige, täuschende oder rechtswidrige Programme aufzunehmen
+-   den Quellcode von vertreibbarem Code so zu ändern oder zu vertreiben, dass irgendein Teil von ihm einer Ausschlusslizenz unterliegt. Eine Ausschlusslizenz ist eine Lizenz, die als Bedingung für eine Verwendung, Änderung oder einen Vertrieb erfordert, dass:
+    -   der Code in Quellcodeform offen gelegt oder vertrieben wird
+    -   andere das Recht haben, ihn zu ändern.
+
+**2. SUPPORTLEISTUNGEN FÜR SOFTWAREERGÄNZUNG.** Microsoft stellt Supportleistungen für diese Software bereit, die unter https://support.microsoft.com/ beschrieben werden.
diff --git a/entity-framework/ef6/resources/licenses/ef5/enu.md b/entity-framework/ef6/resources/licenses/ef5/enu.md
new file mode 100644
index 0000000000..1c8aaf5ed7
--- /dev/null
+++ b/entity-framework/ef6/resources/licenses/ef5/enu.md
@@ -0,0 +1,46 @@
+---
+title: Entity Framework 5 License - EF6
+description: Entity Framework 5 License
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework 5 License (ENU)
+**MICROSOFT SOFTWARE SUPPLEMENTAL LICENSE TERMS**
+
+**ENTITY FRAMEWORK 5.0 FOR MICROSOFT WINDOWS OPERATING SYSTEM**
+
+Microsoft Corporation (or based on where you live, one of its affiliates) licenses this supplement to you. If you are licensed to use Microsoft Windows Operating System software (the "software"), you may use this supplement. You may not use it if you do not have a license for the software. You may use this supplement with each validly licensed copy of the software.
+
+The following license terms describe additional use terms for this supplement. These terms and the license terms for the software apply to your use of the supplement. If there is a conflict, these supplemental license terms apply.
+
+**By using this supplement, you accept these terms. If you do not accept them, do not use this supplement.**
+
+**If you comply with these license terms, you have the rights below.**
+
+**1. DISTRIBUTABLE CODE.** The supplement is comprised of Distributable Code. "Distributable Code" is code that you are permitted to distribute in programs you develop if you comply with the terms below.
+
+**a. Right to Use and Distribute.**
+
+-   You may copy and distribute the object code form of the supplement.
+-   *Third Party Distribution.* You may permit distributors of your programs to copy and distribute the Distributable Code as part of those programs.
+
+**b. Distribution Requirements. For any Distributable Code you distribute, you must**
+
+-   add significant primary functionality to it in your programs;
+-   for any Distributable Code having a filename extension of .lib, distribute only the results of running such Distributable Code through a linker with your program;
+-   distribute Distributable Code included in a setup program only as part of that setup program without modification;
+-   require distributors and external end users to agree to terms that protect it at least as much as this agreement;
+-   display your valid copyright notice on your programs; and
+-   indemnify, defend, and hold harmless Microsoft from any claims, including attorneys' fees, related to the distribution or use of your programs.
+
+**c. Distribution Restrictions. You may not**
+
+-   alter any copyright, trademark or patent notice in the Distributable Code;
+-   use Microsoft's trademarks in your programs' names or in a way that suggests your programs come from or are endorsed by Microsoft;
+-   distribute Distributable Code to run on a platform other than the Windows platform;
+-   include Distributable Code in malicious, deceptive or unlawful programs; or
+-   modify or distribute the source code of any Distributable Code so that any part of it becomes subject to an Excluded License. An Excluded License is one that requires, as a condition of use, modification or distribution, that
+    -   the code be disclosed or distributed in source code form; or
+    -   others have the right to modify it.
+
+**2. SUPPORT SERVICES FOR SUPPLEMENT.** Microsoft provides support services for this software as described at https://support.microsoft.com/.
diff --git a/entity-framework/ef6/resources/licenses/ef5/esn.md b/entity-framework/ef6/resources/licenses/ef5/esn.md
new file mode 100644
index 0000000000..42f2aff788
--- /dev/null
+++ b/entity-framework/ef6/resources/licenses/ef5/esn.md
@@ -0,0 +1,46 @@
+---
+title: Entity Framework 5 License (ESN) - EF6
+description: Entity Framework 5 License (ESN)
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework 5 License (ESN)
+**TÉRMINOS SUPLEMENTARIOS A LA LICENCIA DE USO DE SOFTWARE DE MICROSOFT**
+
+**ENTITY FRAMEWORK 5.0 PARA MICROSOFT WINDOWS OPERATING SYSTEM**
+
+Microsoft Corporation (o, en función del lugar en el que usted resida, alguna de las afiliadas de su grupo) le concede a usted la licencia de este suplemento. Si dispone de licencia de uso para el software de Microsoft Windows Operating System (el "software"), podrá utilizar este suplemento. No podrá utilizarlo si no dispone de una licencia del software. Podrá utilizar este complemento con cada copia licenciada válida del software.
+
+Los siguientes términos de licencia describen términos de uso adicionales para este suplemento. Dichos términos y los términos de licencia para el software se aplicarán al uso que haga del suplemento. En caso de conflicto, prevalecerán los presentes términos de la licencia suplementaria.
+
+**Al hacer uso del suplemento, se entiende que acepta estos términos. Si usted no los acepta, no use el suplemento.**
+
+**Si cumple usted los presentes términos de esta licencia, dispondrá de los siguientes derechos.**
+
+**1. CÓDIGO DISTRIBUIBLE.** El suplemento se compone de Código Distribuible. El "Código Distribuible" es código que usted está autorizado a distribuir en los programas que desarrolle, siempre y cuando cumpla los términos que se especifican a continuación,
+
+**a. Derecho de utilización y distribución.**
+
+-   Podrá copiar y distribuir el código objeto del complemento.
+-   *Distribución a terceros.* Podrá permitir a los distribuidores de sus programas copiar y distribuir el Código Distribuible como parte de dichos programas.
+
+**b. Requisitos de distribución. Para cualquier Código distribuible, deberá:**
+
+-   añadir al mismo una funcionalidad principal significativa en sus programas;
+-   Para cualquier Código Distribuible con extensión de archivo .lib, distribuir únicamente los resultados de la ejecución e dicho Código Distribuible a través de un vinculador con su programa.
+-   Distribuir el Código Distribuible que se incluya en un programa de instalación exclusivamente como parte de dicho programa sin modificación alguna.
+-   exigir a los distribuidores y usuarios finales externos que acepten proteger el software como mínimo tal y como lo especifica el presente contrato;
+-   mostrar un aviso válido de sus derechos de autor en los programas, así como
+-   indemnizar, proteger y defender a Microsoft frente a toda reclamación, incluidos los honorarios de abogados, relacionados con el uso o la distribución de sus programas.
+
+**c. Restricciones de distribución. Queda prohibido:**
+
+-   modificar cualquier aviso de derechos de autor, marca comercial o patente del Código Distribuible;
+-   utilizar las marcas comerciales de Microsoft en los nombres de sus programas o sugerir de alguna manera que sus programas son de la familia de Microsoft o están promocionados por Microsoft;
+-   distribuir Código Distribuible para ejecutarlo en una plataforma distinta de Windows;
+-   incluir Código distribuible en programas maliciosos, engañosos o ilegales; o
+-   modificar o distribuir el código fuente de cualquier Código Distribuible de modo que alguna parte del mismo pase a estar sujeta a una Licencia de Exclusión. Una Licencia de Exclusión es aquella que requiere, como condición de uso, modificación o distribución, que:
+    -   el código sea divulgado o distribuido en forma de código fuente, o que
+    -   otros tengan derecho a modificarlo.
+
+**2. SERVICIOS DE SOPORTE TÉCNICO PARA SUPLEMENTOS.** Microsoft presta servicios de soporte técnico para este software, tal y como se describe en https://support.microsoft.com/.
diff --git a/entity-framework/ef6/resources/licenses/ef5/fra.md b/entity-framework/ef6/resources/licenses/ef5/fra.md
new file mode 100644
index 0000000000..2653e2ed2a
--- /dev/null
+++ b/entity-framework/ef6/resources/licenses/ef5/fra.md
@@ -0,0 +1,46 @@
+---
+title: Entity Framework 5 License (FRA) - EF6
+description: Entity Framework 5 License (FRA)
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework 5 License (FRA)
+**TERMES DU CONTRAT DE LICENCE D'UN SUPPLÉMENT MICROSOFT**
+
+**ENTITY FRAMEWORK 5.0 POUR MICROSOFT WINDOWS OPERATING SYSTEM**
+
+Microsoft Corporation (ou en fonction du lieu où vous vivez, l'un de ses affiliés) vous accorde une licence pour ce supplément. Si vous êtes titulaire d'une licence d'utilisation du logiciel Microsoft Windows Operating System (le « logiciel »), vous pouvez utiliser ce supplément. Vous n'êtes pas autorisé à utiliser ce supplément si vous n'êtes pas titulaire d'une licence pour le logiciel. Vous pouvez utiliser une copie de ce supplément avec chaque copie concédée sous licence du logiciel.
+
+Les conditions de licence suivantes décrivent les conditions d'utilisation supplémentaires applicables pour ce supplément. Les présentes conditions et les conditions de licence pour le logiciel s'appliquent à l'utilisation du supplément. En cas de conflit, les présentes conditions de licence supplémentaires s'appliquent.
+
+**En utilisant ce supplément, vous acceptez ces termes. Si vous ne les acceptez pas, n'utilisez pas ce supplément.**
+
+**Dans le cadre du présent accord de licence, vous disposez des droits ci-dessous.**
+
+**1. CODE DISTRIBUABLE.** Le supplément constitue du Code Distribuable. Le « Code Distribuable » est le code que vous êtes autorisé à distribuer dans les programmes que vous développez, sous réserve de vous conformer aux termes ci-après.
+
+**a. Droit d'utilisation et de distribution.**
+
+-   Vous êtes autorisé à copier et à distribuer la version en code objet du supplément.
+-   *Distribution par des tierces parties.* Vous pouvez autoriser les distributeurs de vos programmes à copier et à distribuer le code distribuable en tant que partie intégrante de ces programmes.
+
+**b. Conditions de distribution. Pour pouvoir distribuer du code distribuable, vous devez :**
+
+-   y ajouter des fonctionnalités importantes au sein de vos programmes,
+-   pour tout Code distribuable dont l'extension de nom de fichier est .lib, distribuer seulement les résultats de l'exécution de ce Code distribuable à l'aide d'un éditeur de liens avec votre programme ;
+-   distribuer le Code distribuable inclus dans un programme d'installation seulement en tant que partie intégrante de ce programme sans modification ;
+-   lier les distributeurs et les utilisateurs externes par un contrat dont les termes les protègent autant que le présent contrat,
+-   afficher votre propre mention de droits d'auteur valable sur vos programmes et
+-   garantir et défendre Microsoft contre toute réclamation, y compris pour les honoraires d'avocats, qui résulterait de la distribution ou l'utilisation de vos programmes.
+
+**c. Restrictions de distribution. Vous n'êtes pas autorisé à :**
+
+-   modifier toute mention de droits d'auteur, de marques ou de droits de propriété industrielle pouvant figurer dans le code distribuable,
+-   utiliser les marques de Microsoft dans les noms de vos programmes ou d'une façon qui suggère que vos programmes sont fournis par Microsoft ou sous la responsabilité de Microsoft,
+-   distribuer le Code distribuable en vue de son exécution sur une plate-forme autre que la plate-forme Windows,
+-   inclure le Code distribuable dans des programmes malveillants, trompeurs ou interdits par la loi, ou
+-   modifier ou distribuer le code source de code distribuable de manière à ce qu'il fasse l'objet, en partie ou dans son intégralité, d'une Licence Exclue. Une Licence Exclue implique comme condition d'utilisation, de modification ou de distribution, que :
+    -   le code soit dévoilé ou distribué dans sa forme de code source, ou
+    -   d'autres aient le droit de le modifier.
+
+**2. SERVICES D'ASSISTANCE TECHNIQUE POUR LE SUPPLÉMENT.** Microsoft fournit des services d'assistance technique pour ce logiciel disponibles sur le site https://support.microsoft.com/.
diff --git a/entity-framework/ef6/resources/licenses/ef5/ita.md b/entity-framework/ef6/resources/licenses/ef5/ita.md
new file mode 100644
index 0000000000..b6221349f9
--- /dev/null
+++ b/entity-framework/ef6/resources/licenses/ef5/ita.md
@@ -0,0 +1,46 @@
+---
+title: Entity Framework 5 License (ITA) - EF6
+description: Entity Framework 5 License (ITA)
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework 5 License (ITA)
+**CONTRATTO DI LICENZA SUPPLEMENTARE PER IL SOFTWARE MICROSOFT**
+
+**ENTITY FRAMEWORK 5.0 PER MICROSOFT WINDOWS OPERATING SYSTEM**
+
+Microsoft Corporation (o, in base al luogo di residenza del licenziatario, una delle sue consociate) concede in licenza al licenziatario il presente supplemento. Qualora il licenziatario sia autorizzato a utilizzare Microsoft Windows Operating System il software (il "software"), potrà usare il presente supplemento. Il licenziatario non potrà utilizzarlo qualora non disponga di una licenza per il software. Il licenziatario potrà utilizzare il presente supplemento con ciascuna copia validamente concessa in licenza del software.
+
+Nelle condizioni di licenza che seguono sono descritte condizioni di utilizzo aggiuntive per il presente supplemento. Tali condizioni e le condizioni di licenza per il software si applicano all'utilizzo del supplemento da parte del licenziatario. Qualora esista un conflitto tra le predette condizioni di licenza, prevarranno le condizioni di licenza supplementari.
+
+**Utilizzando il presente supplemento, il licenziatario accetta le presenti condizioni. Qualora il licenziatario non le accetti, non potrà utilizzare il supplemento.**
+
+**Qualora il licenziatario si attenga alle presenti condizioni di licenza, disporrà dei diritti di seguito indicati.**
+
+**1. CODICE DISTRIBUIBILE.** Il supplemento è costituito dal "Codice Distribuibile". Il "Codice Distribuibile" è codice che il licenziatario potrà distribuire nei programmi che svilupperà, a condizione che si attenga alle condizioni di seguito riportate.
+
+**a. Diritto di Utilizzo e Distribuzione.**
+
+-   Il licenziatario potrà duplicare e distribuire il formato in codice oggetto del supplemento.
+-   *Distribuzione a Terzi.* Il licenziatario potrà autorizzare i distributori dei programmi del licenziatario stesso a duplicare e distribuire il Codice Distribuibile come parte di tali programmi.
+
+**b. Requisiti per la Distribuzione. Per distribuire il Codice Distribuibile, il licenziatario deve:**
+
+-   aggiungere rilevanti e significative funzionalità al Codice Distribuibile nei programmi del licenziatario;
+-   distribuire, per ogni file del Codice distribuibile con estensione .lib, solo i risultati dell'esecuzione di tale Codice Distribuibile attraverso un linker al programma;
+-   distribuire il Codice Distribuibile incluso in un programma di installazione solo nell'ambito di tale programma e senza alcuna modifica;
+-   far accettare ai distributori e agli utenti finali esterni un contratto con condizioni che garantiscano almeno lo stesso livello di tutela definito nel presente contratto;
+-   visualizzare una valida comunicazione di copyright del licenziatario stesso nei suoi programmi;
+-   indennizzare, manlevare e difendere Microsoft da ogni e qualsiasi domanda o azione giudiziaria, ivi incluse le spese legali, relative all'utilizzo o alla distribuzione dei programmi del licenziatario.
+
+**c. Restrizioni per la Distribuzione. Il licenziatario non potrà**
+
+-   modificare le eventuali comunicazioni relative ai copyright, ai marchi o ai brevetti riportati nel Codice Distribuibile;
+-   utilizzare i marchi di Microsoft nei nomi dei programmi del licenziatario stesso o in modo tale da suggerire che tali programmi provengano o siano riconosciuti in qualsiasi modo da Microsoft;
+-   distribuire il Codice Distribuibile al fine di essere eseguito su una piattaforma diversa dalla piattaforma Windows;
+-   includere Codice Distribuibile in programmi dannosi, ingannevoli o illegali;
+-   modificare o distribuire il codice sorgente di qualsiasi Codice Distribuibile in modo da assoggettare una qualsiasi parte di tale codice alle condizioni di una Licenza Esclusa. Per Licenza Esclusa si intende qualsiasi licenza che richieda, come condizione per l'utilizzo, la modifica o la distribuzione, che
+    -   il codice sia divulgato o distribuito nel formato in codice sorgente;
+    -   altri abbiano il diritto di modificarlo.
+
+**2. SERVIZI DI SUPPORTO TECNICO PER IL SUPPLEMENTO.** Microsoft fornisce servizi di supporto tecnico per questo software come descritto all'indirizzo https://support.microsoft.com/.
diff --git a/entity-framework/ef6/resources/licenses/ef5/jpn.md b/entity-framework/ef6/resources/licenses/ef5/jpn.md
new file mode 100644
index 0000000000..982d6c5505
--- /dev/null
+++ b/entity-framework/ef6/resources/licenses/ef5/jpn.md
@@ -0,0 +1,46 @@
+---
+title: Entity Framework 5 License (JPN) - EF6
+description: Entity Framework 5 License (JPN)
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework 5 License (JPN)
+**マイクロソフト ソフトウェア 追加ライセンス条項**
+
+**ENTITY FRAMEWORK 5.0 FOR MICROSOFT WINDOWS OPERATING SYSTEM**
+
+Microsoft Corporation (以下「マイクロソフト」といいます) は、本追加ソフトウェアのライセンスをお客様に供与します。Microsoft Windows Operating System ソフトウェア(以下「本ソフトウェア」といいます) を使用するためのラインセンスを取得している場合は、本追加ソフトウェアを使用できます。本ソフトウェアのライセンスを取得していない場合は、本追加ソフトウェアを使用することはできません。お客様は、本ソフトウェアの有効なライセンス取得済みの複製 1 部ごとに本追加ソフトウェアを使用できます。
+
+以下のライセンス条項は、について説明しています。これらの条項と本ソフトウェアのライセンス条項が本追加ソフトウェアの使用に適用されます。両者の間に矛盾がある場合は、本追加ライセンス条項が適用されます。
+
+**本追加ソフトウェアを使用することにより、お客様はこれらの条項に同意されたものとします。これらの条項に同意されない場合、本追加ソフトウェアを使用することはできません。**
+
+**お客様がこれらのライセンス条項を遵守することを条件として、お客様は以下が許諾されます。**
+
+**1. 再頒布可能コード**　本追加ソフトウェアは再頒布可能コードで構成されています。「再頒布可能コード」とは、お客様が開発されたプログラムに含めて再頒布することができるコードです。ただし、お客様は以下の条件に従うものとします。
+
+**a. 使用および再頒布の権利　**
+
+-   お客様は、本追加ソフトウェアをオブジェクト コード形式で複製し、再頒布することができます。
+-   *第三者による再頒布*　お客様は、お客様のプログラムの頒布者に対して、お客様のプログラムの一部として再頒布可能コードの複製および頒布を許可することができます。
+
+**b. 再頒布の条件　お客様は、お客様が頒布するすべての再頒布可能コードにつき、以下に従わなければなりません。**
+
+-   お客様のプログラムにおいて再頒布可能コードに重要な新しい機能を追加すること
+-   .lib というファイル名拡張子が付いた再頒布可能コードの場合は、リンカーによってその再頒布可能コードを実行した結果だけをお客様のプログラムと共に再頒布すること。
+-   セットアップ プログラムに含まれる再頒布可能コードを、改変されていないセットアップ プログラムの一部としてのみ頒布すること。
+-   お客様のアプリケーションの頒布者およびエンド ユーザーに、本ライセンス条項と同等以上に再頒布可能コードを保護する条項に同意させること
+-   お客様のアプリケーションにお客様名義の有効な著作権表示を行うこと
+-   お客様のプログラムの頒布または使用に関するクレームについて、マイクロソフトを免責、保護、補償すること (弁護士費用についての免責、保護、補償も含む)
+
+**c. 再頒布の制限　以下の行為は一切禁止されています。**
+
+-   再頒布可能コードの著作権、商標または特許の表示を改変すること
+-   お客様のプログラムの名称の一部にマイクロソフトの商標を使用したり、お客様の製品がマイクロソフトから由来したり、マイクロソフトが推奨するように見せかけること
+-   Windows プラットフォーム以外のプラット フォームで実行ために再頒布可能コードを再頒布すること
+-   再頒布可能コードを悪質、詐欺的または違法なプログラムに組み込むこと
+-   除外ライセンスのいずれかの条項が適用されることとなるような方法で再頒布可能コードのソース コードを改変または再頒布すること。「除外ライセンス」とは、使用、改変または再頒布の条件として以下の条件を満たすことを要求するライセンスです。
+    -   コードをソース コード形式で公表または頒布すること
+    -   他者が改変を行う権利を有すること
+
+**2. 本追加ソフトウェアのサポート サービス**　マイクロソフトは、本ソフトウェアに対し https://support.microsoft.com/ で説明されるサポート サービスを提供します。
diff --git a/entity-framework/ef6/resources/licenses/ef5/kor.md b/entity-framework/ef6/resources/licenses/ef5/kor.md
new file mode 100644
index 0000000000..843e7400d7
--- /dev/null
+++ b/entity-framework/ef6/resources/licenses/ef5/kor.md
@@ -0,0 +1,46 @@
+---
+title: Entity Framework 5 License (KOR) - EF6
+description: Entity Framework 5 License (KOR)
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework 5 License (KOR)
+**MICROSOFT 소프트웨어 사용권 조항**
+
+**ENTITY FRAMEWORK 5.0 FOR MICROSOFT WINDOWS OPERATING SYSTEM**
+
+Microsoft Corporation(또는 거주 지역에 따라 계열사 중 하나)은 귀하에게 본 추가 구성 요소의 사용권을 부여합니다. 소프트웨어 ("소프트웨어")에 대한 사용권이 있는 경우 Microsoft Windows Operating System 의 추가 구성 요소를 사용할 수 있습니다. 해당 소프트웨어 사용권이 없는 경우에는 추가 구성 요소도 사용할 수 없습니다. 적법하게 사용권이 허여된 소프트웨어의 각 사본에 본 추가 구성 요소를 사용할 수 있습니다.
+
+다음 사용권 조항은 본 추가 구성 요소에 대한 추가적인 사용 조건입니다. 소프트웨어에 대한 이러한 조건 및 사용권 조항은 추가 구성 요소의 사용에 적용됩니다. 상충되는 경우에는 본 추가 구성 요소의 사용권 조항을 적용합니다.
+
+**이 추가 구성 요소를 사용하는 것으로 귀하는 아래의 조건들에 동의하게 됩니다. 동의하지 않을 경우에는 추가 구성 요소를 사용하지 마십시오.**
+
+**본 사용권 조항을 준수하는 경우 아래와 같은 권한을 행사할 수 있습니다.**
+
+**1. 배포 가능 코드.** 본 추가 구성 요소에는 배포 가능 코드가 포함되어 있습니다. "배포 가능 코드"란 귀하가 아래 조항을 준수하는 경우 귀하가 개발하는 프로그램에 배포할 수 있는 코드입니다.
+
+**a. 사용 및 배포 권한.**
+
+-   귀하는 본 추가 구성 요소를 개체 코드 형태로 복사 및 배포할 수 있습니다.
+-   *제3자에 의한 배포*. 배포 가능 코드를 프로그램의 일부로 복사 및 배포할 수 있도록 프로그램 배포자에게 허용할 수 있습니다.
+
+**b. 배포 조건. 배포 가능 코드를 배포하려면**
+
+-   귀하의 프로그램 내에서 배포 가능 코드에 중요한 기능을 추가해야 합니다.
+-   .lib라는 파일 이름 확장자를 가진 모든 배포 가능 코드의 경우 귀하의 프로그램과 함께 링커를 통한 배포 가능 코드 실행 결과만 배포해야 합니다.
+-   설치 프로그램에 포함된 배포 가능 코드를 수정하지 않은 상태로 설치 프로그램의 일부로만 배포해야 합니다.
+-   최소한 본 계약에 준하는 배포 가능 코드를 보호할 수 있는 조항에 배포자와 외부의 최종 사용자가 동의하도록 해야 합니다.
+-   귀하의 프로그램에 유효한 저작권 표시를 해야 합니다.
+-   귀하의 프로그램 배포 또는 사용과 관련된 모든 청구(변호사 비용 포함)로부터 Microsoft를 면책하고 해를 입히지 않으며 방어해야 합니다.
+
+**c. 배포 제한. 다음과 같은 행위는 허용되지 않습니다.**
+
+-   배포 가능 코드의 저작권, 상표 또는 특허 표시를 변경하는 행위
+-   Microsoft의 상표를 프로그램 이름에 사용하거나 Microsoft에서 만들거나 보증한다고 광고하는 행위
+-   배포 가능 코드를 배포하여 Windows가 아닌 플랫폼에서 실행하는 행위
+-   배포 가능 코드를 악의적이고 기만적이거나 불법적인 프로그램에 포함하는 행위
+-   배포 가능 코드의 일부분이 예외적 사용권에 적용되도록 배포 가능 코드의 소스 코드를 수정하거나 배포하는 행위. 예외적 사용권이란 사용, 수정 또는 배포를 위해 다음과 같은 조건을 필요로 하는 사용권입니다.
+    -   코드를 소스 코드 형태로 공개하거나 배포합니다.
+    -   다른 사람이 배포 가능 코드를 수정할 수 있는 권한을 갖습니다.
+
+**2. 추가 구성 요소에 대한 지원 서비스.** Microsoft는 https://support.microsoft.com/ 에 기술된 대로 본 소프트웨어에 대한 지원 서비스를 제공합니다.
diff --git a/entity-framework/ef6/resources/licenses/ef5/rus.md b/entity-framework/ef6/resources/licenses/ef5/rus.md
new file mode 100644
index 0000000000..a6fc8dfde6
--- /dev/null
+++ b/entity-framework/ef6/resources/licenses/ef5/rus.md
@@ -0,0 +1,46 @@
+---
+title: Entity Framework 5 License (RUS) - EF6
+description: Entity Framework 5 License (RUS)
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework 5 License (RUS)
+**УСЛОВИЯ ДОПОЛНЕНИЯ К ЛИЦЕНЗИИ КОРПОРАЦИИ МАЙКРОСОФТ НА ИСПОЛЬЗОВАНИЕ ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ**
+
+**ENTITY FRAMEWORK 5.0 ДЛЯ MICROSOFT WINDOWS OPERATING SYSTEM**
+
+Корпорация Майкрософт (или одно из ее аффилированных лиц, в зависимости от места вашего проживания) предоставляет вам данное дополнение к лицензии. Если у вас есть лицензия на использование программного обеспечения Microsoft Windows Operating System («программное обеспечение»), вы можете использовать данное дополнение. Вы не имеете права использовать дополнение, если у вас нет лицензии на программное обеспечение. Вы имеете право использовать данное дополнение с каждой лицензионной копией программного обеспечения.
+
+Следующие условия лицензии описывают дополнительные условия использования для данного дополнения. Использование вами этого дополнения регулируется данными условиями и условиями лицензии на использование программного обеспечения. В случае расхождения между этими условиями и условиями лицензии на использование программного обеспечения применяются данные дополнительные условия лицензии.
+
+**Используя это дополнение, вы выражаете свое согласие соблюдать эти условия. Если вы не согласны, не используйте это дополнение.**
+
+**При соблюдении вами этих условияй лицензии вам предоставляются следующие права.**
+
+**1. ВТОРИЧНО РАСПРОСТРАНЯЕМЫЙ КОД.** Данный дополнительный компонент представляет собой вторично распространяемый код. «Вторично распространяемый код» ― это код, который разрешается распространять в составе разрабатываемых вами программ при соблюдении изложенных ниже условий.
+
+**a. Право на использование и распространение.**
+
+-   Вы имеете право копировать и распространять дополнительный компонент в виде объектного кода.
+-   *Распространение третьими лицами.* Вы можете разрешить дистрибьюторам ваших программ копировать и распространять Вторично распространяемый код как часть этих программ.
+
+**b. Условия распространения. Для распространения любого Вторично распространяемого кода вы должны:**
+
+-   существенно расширить основные функциональные возможности кода в своих программах;
+-   для любого Вторично распространяемого кода с расширением LIB распространять только результаты запуска такого кода посредством компоновщика с помощью вашей программы;
+-   распространять Вторично распространяемый код, включенный в программу установки, только как часть этой программы установки без изменений;
+-   потребовать от дистрибуторов и внешних конечных пользователей принять на себя обязательств по соблюдению условий, которые будут защищать Вторично распространяемый код не меньше, чем данное соглашение;
+-   отображать действительное уведомление об авторских правах в ваших программах;
+-   освободить от ответственности, оградить и защитить корпорацию Майкрософт от любых претензий и исков, связанных с использованием или распространением ваших программ, включая расходы на оплату услуг адвокатов.
+
+**c. Ограничения на распространение. Вы не имеете права:**
+
+-   изменять уведомления об авторских или патентных правах, а также товарные знаки, присутствующие во Вторично распространяемом коде;
+-   использовать товарные знаки корпорации Майкрософт в названиях своих программ, а также иным способом, который позволяет предположить, что ваша продукция произведена или рекомендована корпорацией Майкрософт;
+-   распространять Вторично распространяемый код для использования на платформе, отличной от Windows;
+-   включать Вторично распространяемый код в программы, созданные со злым умыслом или с целью обмана, а также в незаконные;
+-   модифицировать или распространять исходный код любого Вторично распространяемого кода таким образом, что какая-либо его часть попадает под действие условий Исключенной лицензии. Исключенная лицензия - это любая лицензия, согласно которой использование, изменение или распространение Вторично распространяемого кода возможно только при соблюдении следующих условий:
+    -   код раскрывается и распространяется в виде исходного кода;
+    -   другие имеют право его модифицировать.
+
+**2. ТЕХНИЧЕСКАЯ ПОДДЕРЖКА ДОПОЛНЕНИЯ.** Корпорация Майкрософт предоставляет техническую поддержку дополнения, как указано на веб-узле https://support.microsoft.com/.
diff --git a/entity-framework/ef6/resources/licenses/ef6/chs.md b/entity-framework/ef6/resources/licenses/ef6/chs.md
new file mode 100644
index 0000000000..270ac98d00
--- /dev/null
+++ b/entity-framework/ef6/resources/licenses/ef6/chs.md
@@ -0,0 +1,82 @@
+---
+title: Entity Framework 6 Runtime License (CHS) - EF6
+description: Entity Framework 6 Runtime License (CHS)
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework 6 Runtime License (CHS)
+**MICROSOFT 软件许可条款**
+
+**MICROSOFT ENTITY FRAMEWORK**
+
+这些许可条款是Microsoft Corporation（或您所在地的 Microsoft 关联公司）与您之间达成的协议。请阅读条款内容。这些条款适用于上述软件，包括您用来接收该软件的介质（如果有）。这些条款也适用于 Microsoft 为本软件提供的任何
+
+-   更新
+-   补充程序
+-   基于 Internet 的服务，以及
+-   支持服务
+
+（除非这些项目附带有其他条款）。如果确实附带有其他条款，应遵守那些条款。
+
+**使用该软件，即表示您接受这些条款。如果您不接受这些条款，请不要使用该软件。**
+
+**如果您遵守这些许可条款，将拥有以下永久权利。**
+
+**1.    安装和使用权利。**您可以在您的设备上安装和使用本软件任意数量的副本。
+
+**2.    其他许可要求和/或使用权利。**
+
+-   **a.    可分发代码。**该软件包含可分发代码。如果您遵守下述条款，则可以在您开发的程序中分发这些代码。
+    -   **i.      使用权利和分发权利。下列代码和文件为“可分发代码”。**
+        -   您可以复制和分发对象代码形式的软件文件。
+        -   *第三方分发*。您可以允许您的程序分销商将可分发代码作为这些程序的一部分进行复制和分发。
+    -   **ii.    分发要求。对于您分发的任何可分发代码，您必须**
+        -   在您的程序中为其添加重要的主要功能；
+        -   要求分销商及外部最终用户同意遵守保护条款且保护范围不得小于本协议；
+        -   在您的程序上显示有效的版权声明；以及
+        -   对于与分发或使用您的程序有关的任何索赔，为 Microsoft 提供辩护、补偿，包括支付律师费，并使 Microsoft 免受损害。
+    -   **iii.   分发限制。您不得**
+        -   改变可分发代码中的任何版权、商标或专利声明；
+        -   在您的程序名称中使用 Microsoft 的商标，或者以其他方式暗示您的程序来自 Microsoft 或经 Microsoft 认可；
+        -   分发“可分发代码”以在 Windows 平台以外的任何平台上运行；
+        -   在恶意的、欺骗性的或非法的程序中添加可分发代码；或者
+        -   修改或分发任何可分发代码的源代码，致使其任何部分受到“排除许可”的制约。排除许可指要求以如下规定为使用、修改或分发条件的许可：
+            -   以源代码形式公布或分发代码；或者
+            -   其他人有权对其进行修改。
+
+**3.    许可范围。**软件只授予使用许可，而非出售。本协议只授予您使用软件的某些权利。Microsoft 保留所有其他权利。除非适用的法律赋予您此项限制之外的权利，否则您只能在本协议明示允许的范围内使用软件。为此，您必须遵守该软件中的任何技术限制，这些限制只允许您以特定的方式使用软件。您不得
+
+-   绕过软件中的任何技术限制；
+-   对软件进行反向工程、反向编译或反汇编；尽管有此项限制，但如果适用的法律明示允许上述活动，并仅在适用的法律明示允许的范围内从事上述活动则不在此限；
+-   发布软件供他人复制；
+-   出租、租赁或出借该软件；
+-   将该软件或本协议转让给任何第三方；
+-   使用软件提供商业软件托管服务。
+
+**4.    文档。**能够合法访问您的计算机或内部网络的所有用户都可以复制该文档，但仅供内部参考之用。
+
+**5.    出口限制。**该软件受美国出口法律和法规的约束。您必须遵守适用于该软件的所有国内和国际出口法律和法规。这些法律包括对目的地、最终用户和最终用途的各种限制。有关详细信息，请参阅www.microsoft.com/exporting。
+
+**6.    支持服务。**该软件是按“现状”提供的，所以我们可能不为其提供支持服务。
+
+**7.    完整协议。**本协议以及您使用的补充程序、更新、基于 Internet 的服务和支持服务的有关条款，共同构成了该软件和支持服务的完整协议。
+
+**8.    适用的法律。**
+
+-   **a.    美国。**如果您在美国购买该软件，则对本协议的解释以及由于违反本协议而引起的索赔均以华盛顿州法律为准并受其管辖，而不考虑冲突法原则。您所居住的州的法律管辖其他所有索赔项目，包括根据州消费者保护法、不正当竞争法以及侵权行为提出的相关索赔。
+-   **b.    美国以外。**如果您在其他任何国家/地区购买该软件，则应遵守该国家/地区的法律。
+
+**9.    法律效力。**本协议规定了某些合法权利。根据您所在国家/地区的法律规定，您可能享有其他权利。您还可能享有与您的软件卖方相关的权利。如果您所在国家/地区的法律不允许本协议改变您所在国家/地区法律赋予您的权利，则本协议将不改变您按照所在国家/地区的法律应享有的权利。
+
+**10.   免责声明。该软件按“现状”授予许可。您须自行承担使用该软件的风险。Microsoft 不提供任何明示的保证、保障或条件。根据您当地的法律，您可能享有本协议无法改变的其他消费者权利或法定保障。在您当地法律允许的范围内，Microsoft 排除有关适销性、针对特定目的的适用性和不侵权的默示保证。**
+
+**以下内容适用于澳大利亚 - 您享有《澳大利亚消费者法》规定的法定保障，这些条款中的任何规定均无意影响这些权利。**
+
+**11.   损害补偿责任的限制和排除条款。您只能因直接损害从 Microsoft 及其供应商处获得退款，且退款金额上限为 5.00 美元。您不能因其他任何损害获得退款，包括后果性损害、利润损失、特别的损害、间接损害或附带性损害。**
+
+此限制适用于：
+
+-   与第三方 Internet 站点上的软件、服务、内容（包括代码）或第三方程序相关的任何情况；以及
+-   在适用的法律允许的范围内，因违约、违反保证、保障或条件、严格责任、过失或其他侵权行为引起的索赔。
+
+即使 Microsoft 知道或应该知道可能会出现损害，此项限制也同样适用。由于您所在国家/地区可能不允许排除或限制附带损害、后果性损害或其他损害的赔偿责任，因此上述限制或排除条款可能对您不适用。
diff --git a/entity-framework/ef6/resources/licenses/ef6/cht.md b/entity-framework/ef6/resources/licenses/ef6/cht.md
new file mode 100644
index 0000000000..49bbd55788
--- /dev/null
+++ b/entity-framework/ef6/resources/licenses/ef6/cht.md
@@ -0,0 +1,82 @@
+---
+title: Entity Framework 6 Runtime License (CHT) - EF6
+description: Entity Framework 6 Runtime License (CHT)
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework 6 Runtime License (CHT)
+**MICROSOFT 軟體授權條款**
+
+**MICROSOFT ENTITY FRAMEWORK**
+
+本授權條款係一份由　貴用戶與Microsoft Corporation (或其關係企業，視　貴用戶所居住的地點而定) 之間所成立之協議。請仔細閱讀這些授權條款。這些授權條款適用於上述軟體，包括　貴用戶所收受的媒體(如果有的話)。這些條款亦適用於任何Microsoft 之
+
+-   更新程式、
+-   增補程式、
+-   網際網路服務與
+-   支援服務
+
+但若上述項目另附有其他條款，如遇此情形，則其他條款優先適用。
+
+**軟體一經使用，即表示　貴用戶接受這些授權條款。若　貴用戶不接受這些授權條款，請不要使用軟體。**
+
+**若　貴用戶遵守本授權條款，即可永久享有以下權利。**
+
+**1.    安裝與使用權利。**　貴用戶得於裝置上安裝和使用任何數量之軟體拷貝。
+
+**2.    其他授權要件及/或使用權利。**
+
+-   **a.    可散布程式碼。**若　貴用戶遵守以下條款，則　貴用戶得於自己開發的程式中散布軟體包含的部分程式碼。
+    -   **i.      使用及散布權利。下列程式碼與檔案為「可散布程式碼」。**
+        -   　貴用戶得以軟體檔案的目的碼形式複製與散布。
+        -   *第三人散布*。　貴用戶得同意程式經銷商將「可散布程式碼」視為　貴用戶之程式的一部分，進行複製與散布。
+    -   **ii.    散布要件。針對　貴用戶散布的任何「可散布程式碼」，　貴用戶必須**
+        -   在　貴用戶的程式中，為「可散布程式碼」加入重要的主要功能；
+        -   要求散布者及外部終端使用者同意「保護『可散布程式碼』的程度不得低於本合約」之相關條款；
+        -   在程式中顯示有效的著作權標示；和
+        -   若因散布或使用　貴用戶之程式而使 Microsoft 遭他人提出索賠時，　貴用戶應賠償 Microsoft 之損失 (包括律師費)，使之免遭損害，並出面代為辯護。
+    -   **iii.   散布限制。　貴用戶不得**
+        -   變更「可散布程式碼」中之任何著作權、商標或專利聲明；
+        -   於　貴用戶的程式名稱使用 Microsoft 的商標，或暗示程式來自 Microsoft 或經由 Microsoft 背書；
+        -   散佈「可散佈程式碼」並於非 Windows 的平台上執行；
+        -   將「可散布程式碼」置於惡意、欺騙或違法的程式中；或
+        -   修改或散布任何可散布程式碼的原始碼，使其任何部分受到除外授權之約束。「除外授權」係指在使用、修改或散布時，應遵守下列條件：
+            -   程式碼必須以原始碼形式揭露或散布，或
+            -   提供他人修改的權利。
+
+**3.    授權範圍。**軟體係授權使用，而非出售賣斷。本合約僅提供　貴用戶使用軟體的部分權利。Microsoft 保留所有其他權利。除非相關法律賦予　貴用戶超出本合約限制的其他權利，否則　貴用戶僅得在本合約明示許可之範圍內使用軟體。因此，　貴用戶必須遵守只允許以特定方式使用軟體的科技保護措施。　貴用戶不得
+
+-   規避軟體中所包含的科技保護措施；
+-   對軟體進行還原工程、解編或反向組譯，但儘管有此限制相關法律仍明文允許者，不在此限；
+-   將軟體發佈給其他人進行複製；
+-   出租、租賃或出借軟體；
+-   將軟體或本合約移轉給任何第三人；或者
+-   利用軟體提供商業軟體主機服務。
+
+**4.    說明文件。**任何有權存取　貴用戶之電腦或內部網路的人，皆得基於　貴用戶內部參考之目的，複製及使用該說明文件。
+
+**5.    出口限制。**軟體受到美國出口法令規定之規範。　貴用戶必須遵守適用於軟體之一切本國及國際出口法令規定之規範。這些法規包括目的地限制、使用者限制和使用用途限制。如需詳細資訊，請參閱www.microsoft.com/exporting。
+
+**6.    支援服務。**本軟體係依「現況」提供，因此本公司得不提供支援服務。
+
+**7.    整份合約。**本合約以及　貴用戶所使用的增補程式、更新程式、網際網路服務和支援服務之條款構成關於軟體和支援服務之整份合約。
+
+**8.    準據法。**
+
+-   **a.    美國。**若　貴用戶在美國境內取得軟體，本合約之解釋或任何違反本合約所衍生的訴訟，無論是否有法規衝突產生，均應以美國華盛頓州之法律做為準據法。所有其他訴訟將以　貴用戶居住之州法律為準據法，包含違反州消費者保護法、不當競爭法和侵權行為的訴訟。
+-   **b.    美國境外。**若　貴用戶在美國以外的國家/地區取得軟體，則本合約應以　貴用戶所居住之國家/地區的法律為準據法。
+
+**9.    法律效力。**本合約敘述了特定的法律權利。　貴用戶所在國家的法律可能會提供　貴用戶其他權利。此外，　貴用戶取得軟體的單位可能也會提供相關的權利。若　貴用戶所在之國家/地區法律不允許，則本合約無法改變　貴用戶所在之國家/地區法律提供給　貴用戶的權利。
+
+**10.   不為瑕疵擔保之聲明。軟體係依「現況」授權。　貴用戶須自行承擔使用風險。Microsoft 不提供明示擔保、保證或條件。　貴用戶所在地區的法律可能會提供本合約無法改變的額外消費者權利或法律保證。在　貴用戶所屬當地法律允許之範圍內，Microsoft 可排除適售性、符合特定目的或未侵權之默示擔保。**
+
+**僅適用於澳大利亞 –　貴用戶依據澳大利亞消費者法律 (Australian Consumer Law) 享有法定保證，本合約條款並不意圖影響這些權利。**
+
+**11.   救濟權與損害賠償責任之限制與排除。　貴用戶僅得就直接損害，要求 Microsoft 及其供應商負擔損害賠償責任，且其金額不得超過 $5.00 美元。　貴用戶無法就其他損害 (包括衍生性損害、利潤損失、特殊損害、間接損害或附隨性損害) 請求損害賠償。**
+
+這項限制適用於
+
+-   與軟體、服務、第三方廠商網站上的內容 (包括程式碼) 或第三方廠商程式相關的任何事項；和
+-   在相關法律許可的範圍之內，因為違反合約、瑕疵擔保、保證或條件、無過失責任、過失或其他侵權行為所主張之訴訟案件。
+
+即使 Microsoft 已知悉或應知悉該等損害發生之可能性，此項限制仍然適用。此外，　貴用戶所在之國家/地區也可能不允許對附隨性損害、衍生性損害或其他損害加以排除或限制，這種情況也可能造成上述限制或排除規定並不適用於　貴用戶。
diff --git a/entity-framework/ef6/resources/licenses/ef6/deu.md b/entity-framework/ef6/resources/licenses/ef6/deu.md
new file mode 100644
index 0000000000..6c84673a54
--- /dev/null
+++ b/entity-framework/ef6/resources/licenses/ef6/deu.md
@@ -0,0 +1,82 @@
+---
+title: Entity Framework 6 Runtime License (DEU) - EF6
+description: Entity Framework 6 Runtime License (DEU)
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework 6 Runtime License (DEU)
+**MICROSOFT-SOFTWARELIZENZBESTIMMUNGEN**
+
+**MICROSOFT ENTITY FRAMEWORK**
+
+Diese Lizenzbestimmungen sind ein Vertrag zwischen Ihnen und der Microsoft Corporation (oder einer anderen Microsoft-Konzerngesellschaft, wenn diese an dem Ort, an dem Sie leben, die Software lizenziert). Bitte lesen Sie die Bestimmungen aufmerksam durch. Sie gelten für die oben genannte Software und gegebenenfalls für die Medien, auf denen Sie diese erhalten haben. Diese Bestimmungen gelten auch für alle von Microsoft diesbezüglich angebotenen
+
+-   Updates
+-   Ergänzungen
+-   internetbasierten Dienste und
+-   Supportservices.
+
+Liegen letztgenannten Elementen eigene Bestimmungen bei, gelten diese eigenen Bestimmungen.
+
+**Durch die Verwendung der Software erkennen Sie diese Bestimmungen an. Falls Sie die Bestimmungen nicht akzeptieren, sind Sie nicht berechtigt, die Software zu verwenden.**
+
+**Wenn Sie diese Lizenzbestimmungen einhalten, verfügen Sie über die nachfolgend aufgeführten zeitlich unbeschränkten Rechte.**
+
+**1.    RECHTE ZUR INSTALLATION UND NUTZUNG.** Sie sind berechtigt, eine beliebige Anzahl von Kopien der Software auf Ihren Geräten zu installieren und zu verwenden.
+
+**2.    ZUSÄTZLICHE LIZENZANFORDERUNGEN UND/ODER NUTZUNGSRECHTE.**
+
+-   **a.    Vertreibbarer Code.** Die Software enthält Code, den Sie in von Ihnen entwickelten Programmen vertreiben dürfen, wenn Sie die nachfolgenden Bestimmungen einhalten.
+    -   **i.      Recht zur Nutzung und zum Vertrieb. Bei dem nachfolgend aufgelisteten Code und den nachfolgend aufgelisteten Dateien handelt es sich um „Vertreibbaren Code“.**
+        -   Sie sind berechtigt, die Objektcodeform der Softwaredateien zu kopieren und zu vertreiben.
+        -   *Vertrieb durch Dritte.* Sie sind berechtigt, Distributoren Ihrer Programme zu erlauben, den Vertreibbaren Code als Teil dieser Programme zu kopieren und zu vertreiben.
+    -   **ii.    Vertriebsbedingungen. Für Vertreibbaren Code, den Sie vertreiben, sind Sie verpflichtet:**
+        -   diesem in Ihren Programmen wesentliche primäre Funktionalität hinzuzufügen
+        -   von Distributoren und externen Endbenutzern die Zustimmung zu Bestimmungen zu verlangen, die einen mindestens gleichwertigen Schutz für ihn bieten wie dieser Vertrag
+        -   Ihren gültigen Urheberrechtshinweis auf Ihren Programmen anzubringen
+        -   Microsoft von allen Ansprüchen freizustellen und gegen alle Ansprüche zu verteidigen, einschließlich Anwaltsgebühren, die mit dem Vertrieb oder der Verwendung Ihrer Programme in Zusammenhang stehen.
+    -   **iii.   Vertriebsbeschränkungen. Sie sind nicht dazu berechtigt:**
+        -   Urheberrechts-, Markenrechts- oder Patenthinweise im Vertreibbaren Code zu ändern
+        -   die Marken von Microsoft in den Namen Ihrer Programme oder auf eine Weise zu verwenden, die nahe legt, dass Ihre Programme von Microsoft stammen oder von Microsoft empfohlen werden
+        -   Vertreibbaren Code zur Ausführung auf einer anderen Plattform als der Windows-Plattform zu vertreiben
+        -   Vertreibbaren Code in bösartige, täuschende oder rechtswidrige Programme aufzunehmen
+        -   den Quellcode von Vertreibbarem Code so zu ändern oder zu vertreiben, dass irgendein Teil von ihm einer Ausgeschlossenen Lizenz unterliegt. Eine Ausgeschlossene Lizenz ist eine Lizenz, die als Bedingung für eine Verwendung, Änderung oder einen Vertrieb erfordert, dass:
+            -   der Code in Quellcodeform offengelegt oder vertrieben wird oder
+            -   andere das Recht haben, ihn zu ändern.
+
+**3.    GÜLTIGKEITSBEREICH DER LIZENZ.** Die Software wird lizenziert, nicht verkauft. Dieser Vertrag gibt Ihnen nur einige Rechte zur Verwendung der Software. Microsoft behält sich alle anderen Rechte vor. Sie dürfen die Software nur wie in diesem Vertrag ausdrücklich gestattet verwenden, es sei denn, das anwendbare Recht gibt Ihnen ungeachtet dieser Einschränkung umfassendere Rechte. Dabei sind Sie verpflichtet, alle technischen Beschränkungen der Software einzuhalten, die Ihnen nur spezielle Verwendungen gestatten. Sie sind nicht dazu berechtigt:
+
+-   technische Beschränkungen der Software zu umgehen
+-   die Software zurückzuentwickeln (Reverse Engineering), zu dekompilieren oder zu disassemblieren, es sei denn, dass (und nur insoweit) es das anwendbare Recht ungeachtet dieser Einschränkung ausdrücklich gestattet
+-   die Software zu veröffentlichen, damit andere sie kopieren können
+-   die Software zu vermieten, zu verleasen oder zu verleihen
+-   die Software oder diesen Vertrag an Dritte zu übertragen oder
+-   die Software für kommerzielle Software-Hostingdienste zu verwenden.
+
+**4.    DOKUMENTATION.** Jede Person, die über einen gültigen Zugriff auf Ihren Computer oder Ihr internes Netzwerk verfügt, ist berechtigt, die Dokumentation zu Ihren internen Referenzzwecken zu kopieren und zu verwenden.
+
+**5.    AUSFUHRBESCHRÄNKUNGEN.** Die Software unterliegt den Exportgesetzen und -regelungen der USA sowie des Landes, aus dem sie ausgeführt wird. Sie sind verpflichtet, alle nationalen und internationalen Exportgesetze und -regelungen einzuhalten, die für die Software gelten. Diese Gesetze enthalten auch Beschränkungen in Bezug auf die Endnutzer und Endnutzung. Weitere Informationen finden Sie unter https://www.microsoft.com/exporting.
+
+**6.    SUPPORTSERVICES.** Da diese Software „wie besehen“ bereitgestellt wird, stellen wir möglicherweise keine Supportservices für sie bereit.
+
+**7.    GESAMTER VERTRAG.** Dieser Vertrag sowie die Bestimmungen für von Ihnen verwendete Ergänzungen, Updates, internetbasierte Dienste und Supportservices stellen den gesamten Vertrag für die Software und die Supportservices dar.
+
+**8.    ANWENDBARES RECHT.**
+
+-   **a.    Vereinigte Staaten.** Wenn Sie die Software in den Vereinigten Staaten erworben haben, regelt das Gesetz des Staates Washington die Auslegung dieses Vertrages und gilt für Ansprüche, die aus einer Vertragsverletzung entstehen, ungeachtet der Bestimmungen des internationalen Privatrechts. Die Gesetze des Staates Ihres Wohnorts regeln alle anderen Ansprüche, einschließlich Ansprüche aus den Verbraucherschutzgesetzen des Staates, aus Gesetzen gegen unlauteren Wettbewerb und aus Deliktsrecht.
+-   **b.    Außerhalb der Vereinigten Staaten.** Wenn Sie die Software in einem anderen Land erworben haben, gelten die Gesetze dieses Landes.
+
+**9.    RECHTLICHE WIRKUNG.** Dieser Vertrag beschreibt bestimmte Rechte. Möglicherweise haben Sie unter den Gesetzen Ihres Landes weitergehende Rechte. Möglicherweise verfügen Sie außerdem über Rechte im Hinblick auf die Partei, von der Sie die Software erworben haben. Dieser Vertrag ändert nicht Ihre Rechte, die sich aus den Gesetzen Ihres Landes ergeben, sofern die Gesetze Ihres Landes dies nicht zulassen.
+
+**10.  AUSSCHLUSS VON GARANTIEN. Die Software wird „wie besehen“ lizenziert. Sie tragen das mit der Verwendung verbundene Risiko. Microsoft gewährt keine ausdrücklichen Gewährleistungen oder Garantien. Möglicherweise gelten unter den örtlich anwendbaren Gesetzen zusätzliche Verbraucherrechte oder gesetzliche Garantien, die durch diesen Vertrag nicht abgeändert werden können. Im durch das örtlich anwendbare Recht zugelassenen Umfang schließt Microsoft konkludente Garantien der Handelsüblichkeit, Eignung für einen bestimmten Zweck und Nichtverletzung von Rechten Dritter aus.**
+
+**FÜR AUSTRALIEN – Nach dem Australian Consumer Law gelten gesetzliche Garantien, und es besteht an keiner Stelle in diesen Bestimmungen die Absicht, diese Rechte einzuschränken.**
+
+**11.  BESCHRÄNKUNG UND AUSSCHLUSS DES SCHADENERSATZES. Sie können von Microsoft und deren Lieferanten nur einen Ersatz für direkte Schäden bis zu einem Betrag von 5,00 US-Dollar erhalten. Sie können keinen Ersatz für andere Schäden erhalten, einschließlich Folgeschäden, Schäden aus entgangenem Gewinn, spezielle, indirekte oder zufällige Schäden.**
+
+Diese Beschränkung gilt für
+
+-   jeden Gegenstand im Zusammenhang mit der Software, Diensten, Inhalten (einschließlich Code) auf Internetseiten von Drittanbietern oder Programmen von Drittanbietern und
+-   Ansprüche aus Vertragsverletzungen, Verletzungen der Garantie oder der Gewährleistung, verschuldensunabhängiger Haftung, Fahrlässigkeit oder anderen unerlaubten Handlungen im durch das anwendbare Recht zugelassenen Umfang.
+
+Sie hat auch dann Gültigkeit, wenn Microsoft von der Möglichkeit der Schäden gewusst hat oder hätte wissen müssen. Obige Beschränkung und obiger Ausschluss gelten möglicherweise nicht für Sie, weil Ihr Land den Ausschluss oder die Beschränkung von zufälligen Schäden, Folgeschäden oder sonstigen Schäden nicht gestattet. Wenn Sie die Software in DEUTSCHLAND oder in ÖSTERREICH erworben haben, findet die Beschränkung im vorstehenden Absatz „Beschränkung und Ausschluss des Schadenersatzes“ auf Sie keine Anwendung. Stattdessen gelten für Schadenersatz oder Ersatz vergeblicher Aufwendungen, gleich aus welchem Rechtsgrund einschließlich unerlaubter Handlung, die folgenden Regelungen: Microsoft haftet bei Vorsatz, grober Fahrlässigkeit, bei Ansprüchen nach dem Produkthaftungsgesetz sowie bei Verletzung von Leben, Körper oder der Gesundheit nach den gesetzlichen Vorschriften. Microsoft haftet nicht für leichte Fahrlässigkeit. Wenn Sie die Software jedoch in Deutschland erworben haben, haftet Microsoft auch für leichte Fahrlässigkeit, wenn Microsoft eine Vertragspflicht verletzt, deren Erfüllung die ordnungsgemäße Durchführung des Vertrages überhaupt erst ermöglicht, deren Verletzung die Erreichung des Vertragszwecks gefährdet und auf deren Einhaltung Sie regelmäßig vertrauen dürfen (sog. „Kardinalpflichten“). In diesen Fällen ist die Haftung von Microsoft auf typische und vorhersehbare Schäden beschränkt. In allen anderen Fällen haftet Microsoft auch in Deutschland nicht für leichte Fahrlässigkeit.
diff --git a/entity-framework/ef6/resources/licenses/ef6/enu.md b/entity-framework/ef6/resources/licenses/ef6/enu.md
new file mode 100644
index 0000000000..e0d1ebca96
--- /dev/null
+++ b/entity-framework/ef6/resources/licenses/ef6/enu.md
@@ -0,0 +1,82 @@
+---
+title: Entity Framework 6 Runtime License - EF6
+description: Entity Framework 6 Runtime License
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework 6 Runtime License (ENU)
+**MICROSOFT SOFTWARE LICENSE TERMS**
+
+**MICROSOFT ENTITY FRAMEWORK**
+
+These license terms are an agreement between Microsoft Corporation (or based on where you live, one of its affiliates) and you. Please read them. They apply to the software named above, which includes the media on which you received it, if any. The terms also apply to any Microsoft
+
+-   updates,
+-   supplements,
+-   Internet-based services, and
+-   support services
+
+for this software, unless other terms accompany those items. If so, those terms apply.
+
+**By using the software, you accept these terms. If you do not accept them, do not use the software.**
+
+**If you comply with these license terms, you have the perpetual rights below.**
+
+**1.    INSTALLATION AND USE RIGHTS.** You may install and use any number of copies of the software on your devices.
+
+**2.    ADDITIONAL LICENSING REQUIREMENTS AND/OR USE RIGHTS.**
+
+-   **a.    Distributable Code.** The software contains code that you are permitted to distribute in programs you develop if you comply with the terms below.
+    -   **i.      Right to Use and Distribute. The code and files listed below are “Distributable Code.”**
+        -   You may copy and distribute the object code form of the software files.
+        -   *Third Party Distribution*. You may permit distributors of your programs to copy and distribute the Distributable Code as part of those programs.
+    -   **ii.    Distribution Requirements. For any Distributable Code you distribute, you must**
+        -   add significant primary functionality to it in your programs;
+        -   require distributors and external end users to agree to terms that protect it at least as much as this agreement;
+        -   display your valid copyright notice on your programs; and
+        -   indemnify, defend, and hold harmless Microsoft from any claims, including attorneys’ fees, related to the distribution or use of your programs.
+    -   **iii.   Distribution Restrictions. You may not**
+        -   alter any copyright, trademark or patent notice in the Distributable Code;
+        -   use Microsoft’s trademarks in your programs’ names or in a way that suggests your programs come from or are endorsed by Microsoft;
+        -   distribute Distributable Code, to run on a platform other than the Windows platform;
+        -   include Distributable Code in malicious, deceptive or unlawful programs; or
+        -   modify or distribute the source code of any Distributable Code so that any part of it becomes subject to an Excluded License. An Excluded License is one that requires, as a condition of use, modification or distribution, that
+            -   the code be disclosed or distributed in source code form; or
+            -   others have the right to modify it.
+
+**3.    SCOPE OF LICENSE.** The software is licensed, not sold. This agreement only gives you some rights to use the software. Microsoft reserves all other rights. Unless applicable law gives you more rights despite this limitation, you may use the software only as expressly permitted in this agreement. In doing so, you must comply with any technical limitations in the software that only allow you to use it in certain ways. You may not
+
+-   work around any technical limitations in the software;
+-   reverse engineer, decompile or disassemble the software, except and only to the extent that applicable law expressly permits, despite this limitation;
+-   publish the software for others to copy;
+-   rent, lease or lend the software;
+-   transfer the software or this agreement to any third party; or
+-   use the software for commercial software hosting services.
+
+**4.    DOCUMENTATION.** Any person that has valid access to your computer or internal network may copy and use the documentation for your internal, reference purposes.
+
+**5.    EXPORT RESTRICTIONS.** The software is subject to United States export laws and regulations. You must comply with all domestic and international export laws and regulations that apply to the software. These laws include restrictions on destinations, end users and end use. For additional information, see https://www.microsoft.com/exporting.
+
+**6.    SUPPORT SERVICES.** Because this software is “as is,” we may not provide support services for it.
+
+**7.    ENTIRE AGREEMENT.** This agreement, and the terms for supplements, updates, Internet-based services and support services that you use, are the entire agreement for the software and support services.
+
+**8.    APPLICABLE LAW.**
+
+-   **a.    United States**. If you acquired the software in the United States, Washington state law governs the interpretation of this agreement and applies to claims for breach of it, regardless of conflict of laws principles. The laws of the state where you live govern all other claims, including claims under state consumer protection laws, unfair competition laws, and in tort.
+-   **b.    Outside the United States.** If you acquired the software in any other country, the laws of that country apply.
+
+**9.    LEGAL EFFECT.** This agreement describes certain legal rights. You may have other rights under the laws of your country. You may also have rights with respect to the party from whom you acquired the software. This agreement does not change your rights under the laws of your country if the laws of your country do not permit it to do so.
+
+**10.   DISCLAIMER OF WARRANTY. The software is licensed “as-is.” You bear the risk of using it. Microsoft gives no express warranties, guarantees or conditions. You may have additional consumer rights or statutory guarantees under your local laws which this agreement cannot change. To the extent permitted under your local laws, Microsoft excludes the implied warranties of merchantability, fitness for a particular purpose and non-infringement.**
+
+**FOR AUSTRALIA – You have statutory guarantees under the Australian Consumer Law and nothing in these terms is intended to affect those rights.**
+
+**11.   LIMITATION ON AND EXCLUSION OF REMEDIES AND DAMAGES. You can recover from Microsoft and its suppliers only direct damages up to U.S. $5.00. You cannot recover any other damages, including consequential, lost profits, special, indirect or incidental damages.**
+
+This limitation applies to
+
+-   anything related to the software, services, content (including code) on third party Internet sites, or third party programs; and
+-   claims for breach of contract, breach of warranty, guarantee or condition, strict liability, negligence, or other tort to the extent permitted by applicable law.
+
+It also applies even if Microsoft knew or should have known about the possibility of the damages. The above limitation or exclusion may not apply to you because your country may not allow the exclusion or limitation of incidental, consequential or other damages.
diff --git a/entity-framework/ef6/resources/licenses/ef6/esn.md b/entity-framework/ef6/resources/licenses/ef6/esn.md
new file mode 100644
index 0000000000..0ba55fddfc
--- /dev/null
+++ b/entity-framework/ef6/resources/licenses/ef6/esn.md
@@ -0,0 +1,82 @@
+---
+title: Entity Framework 6 Runtime License (ESN) - EF6
+description: Entity Framework 6 Runtime License (ESN)
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework 6 Runtime License (ESN)
+**TÉRMINOS DE LICENCIA DEL SOFTWARE DE MICROSOFT**
+
+**MICROSOFT ENTITY FRAMEWORK**
+
+Los presentes términos de licencia constituyen un contrato entre Microsoft Corporation (o, en función de donde resida, una de sus filiales) y usted. Le rogamos que los lea atentamente. Se aplican al software antes mencionado, el cual incluye los soportes físicos en los que lo haya recibido, si los hubiera. Estos términos también se aplicarán a los siguientes elementos de Microsoft:
+
+-   actualizaciones,
+-   complementos,
+-   servicios basados en Internet, y
+-   servicios de soporte técnico.
+
+Todos ellos deben corresponder a este software, salvo que existan otros términos aplicables a dichos elementos. En tal caso, se aplicarán esos términos.
+
+**Al hacer uso del software, estará aceptando estos términos. Si no los acepta, no utilice el software.**
+
+**Si cumple con estos términos de licencia, tendrá los derechos perpetuos que se describen a continuación.**
+
+**1.    DERECHOS DE INSTALACIÓN Y USO.** Podrá instalar y utilizar cualquier número de copias del software en sus dispositivos.
+
+**2.    REQUISITOS DE LICENCIA Y/O DERECHOS DE USO ADICIONALES.**
+
+-   **a.    Código Distribuible.** El software contiene código que puede distribuir en los programas que desarrolle siempre que cumpla con los términos siguientes.
+    -   **i.      Derecho a utilizar y distribuir. El código y los archivos que se indican a continuación son “Código Distribuible”.**
+        -   Puede copiar y distribuir el código objeto de los siguientes archivos de software.
+        -   *Distribución de terceros*. Puede permitir a los distribuidores de sus programas que copien y distribuyan el Código Distribuible como parte de esos programas.
+    -   **ii.    Requisitos de distribución. Para cualquier Código Distribuible que distribuya debe:**
+        -   agregarle una funcionalidad primaria significativa en sus programas;
+        -   exigir a los distribuidores y usuarios finales externos que acepten términos que lo protejan en la misma medida que este contrato;
+        -   mostrar su aviso de propiedad intelectual válido en sus programas; e
+        -   indemnizar, defender y eximir de responsabilidad a Microsoft ante cualquier reclamación, incluidos honorarios de abogados, relacionada con la distribución o el uso de sus programas.
+    -   **iii.   Restricciones de distribución. No podrá:**
+        -   alterar ningún aviso de propiedad intelectual, marca o patente en el Código Distribuible;
+        -   utilizar las marcas de Microsoft en los nombres de sus programas de una forma que sugiera que estos provienen de Microsoft o que esta los respalda;
+        -   distribuir el Código Distribuible para que se ejecute en una plataforma distinta de Windows;
+        -   incluir Código Distribuible en programas malintencionados, engañosos o ilícitos; o
+        -   modificar o distribuir el código fuente de cualquier Código Distribuible para que cualquier parte de él esté sujeta a una Licencia Excluida. Una Licencia Excluida es una que exige, como condición de uso, modificación o distribución que
+            -   el código se revele o distribuya en código fuente; u
+            -   otros tengan el derecho de modificarlo.
+
+**3.    ÁMBITO DE LA LICENCIA.** El software se cede sujeto a licencia y no es objeto de venta. El presente contrato solo le otorga algunos derechos de uso del software. Microsoft se reserva todos los demás derechos. A menos que la legislación aplicable le otorgue más derechos a pesar de esta limitación, solo podrá utilizar el software tal como se permite expresamente en este contrato. Al hacerlo, deberá ajustarse a las limitaciones técnicas del software que solo permiten utilizarlo de determinadas formas. No podrá:
+
+-   eludir las limitaciones técnicas del software;
+-   utilizar técnicas de ingeniería inversa, descompilar o desensamblar el software, excepto y únicamente en la medida en que lo permita expresamente la legislación aplicable, a pesar de la presente limitación;
+-   hacer público el software para que otros lo copien;
+-   alquilar, arrendar o dar en préstamo el software;
+-   transmitir el software o este contrato a un tercero; o
+-   utilizar el software para prestar servicios de hosting de software comercial.
+
+**4.    DOCUMENTACIÓN.** Toda persona que tenga acceso válido a su equipo o a la red interna puede copiar y utilizar la documentación a efectos internos de consulta.
+
+**5.    RESTRICCIONES EN MATERIA DE EXPORTACIÓN.** El software está sujeto a las leyes y reglamentos en materia de exportación de los Estados Unidos. Debe cumplir con todas las leyes y reglamentos, nacionales e internacionales, en materia de exportación que sean de aplicación al software. Dichas leyes incluyen limitaciones en cuanto a destino, usuarios finales y uso final. Para obtener más información, visite https://www.microsoft.com/exporting.
+
+**6.    SERVICIOS DE SOPORTE TÉCNICO.** Debido a que este software se presenta “tal cual”, no podemos prestar servicios de soporte técnico para el mismo.
+
+**7.    CONTRATO COMPLETO.** El presente contrato y los términos aplicables a complementos, actualizaciones, servicios basados en Internet y servicios de soporte técnico que utilice constituyen el contrato completo respecto al software y a los servicios de soporte técnico.
+
+**8.    LEGISLACIÓN APLICABLE.**
+
+-   **a.    Estados Unidos.** Si adquirió el software en los Estados Unidos, la interpretación del presente contrato se regirá por la legislación del Estado de Washington, que se aplicará a las reclamaciones por incumplimiento del mismo, con independencia de conflictos de principios legales. Para el resto de las reclamaciones, será aplicable la legislación de su estado de residencia, incluidas las reclamaciones en virtud de las leyes estatales en materia de protección al consumidor, competencia desleal y responsabilidad extracontractual.
+-   **b.    Fuera de los Estados Unidos.** Si adquirió el software en otro país, se aplicará la legislación de dicho país.
+
+**9.    EFECTOS LEGALES.** El presente contrato describe determinados derechos legales. Es posible que disponga de otros derechos en virtud de la legislación de su país. Asimismo, pueden asistirle determinados derechos con respecto a la parte de la que adquirió el software. Este contrato no modifica los derechos de los que dispone en virtud de la legislación de su país si dicha legislación no permite tal cosa.
+
+**10.  RENUNCIA DE GARANTÍA. El software se concede con licencia “tal cual”, por consiguiente, usted asume el riesgo de utilizarlo. Microsoft no otorga ninguna garantía ni condición expresa. Es posible que la legislación local le otorgue derechos del consumidor o garantías legales adicionales que el presente contrato no pueda modificar. En la medida en que así lo permita la legislación local, Microsoft excluye las garantías implícitas de comerciabilidad, idoneidad para un fin particular y ausencia de infracción de derechos.**
+
+**PARA AUSTRALIA: Usted cuenta con garantías legales conforme a la ley australiana del consumidor y nada en estos términos pretende afectar dichos derechos.**
+
+**11.  LIMITACIÓN Y EXCLUSIÓN DE RECURSOS E INDEMNIZACIONES. La cantidad máxima que se podrá obtener de Microsoft y de sus proveedores en concepto de indemnización por daños directos será de $5,00 dólares estadounidenses. No podrá obtener indemnización alguna por daños de otra índole, incluidos los daños consecuenciales, por lucro cesante, especiales, indirectos o incidentales.**
+
+Esta limitación se aplica a:
+
+-   Cualquier cuestión relacionada con el software, los servicios, el contenido (incluido el código) que se hallen en sitios de Internet de terceros o programas de terceros.
+-   Reclamaciones por incumplimiento de contrato, incumplimiento de garantía o condición, responsabilidad objetiva, negligencia u otra responsabilidad extracontractual en la medida permitida por la legislación aplicable.
+
+Asimismo, también será de aplicación incluso si Microsoft conocía o debería haber conocido la posibilidad de que se produjesen dichos daños. También pueden producirse situaciones en las que la limitación o exclusión precedente no pueda aplicarse a su caso porque su jurisdicción no admita la exclusión o limitación de daños incidentales consecuenciales o de otra índole.
diff --git a/entity-framework/ef6/resources/licenses/ef6/fra.md b/entity-framework/ef6/resources/licenses/ef6/fra.md
new file mode 100644
index 0000000000..f162db8612
--- /dev/null
+++ b/entity-framework/ef6/resources/licenses/ef6/fra.md
@@ -0,0 +1,82 @@
+---
+title: Entity Framework 6 Runtime License (FRA) - EF6
+description: Entity Framework 6 Runtime License (FRA)
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework 6 Runtime License (FRA)
+**TERMES DU CONTRAT DE LICENCE LOGICIEL MICROSOFT**
+
+**MICROSOFT ENTITY FRAMEWORK**
+
+Les présents termes du contrat de licence constituent un contrat entre Microsoft Corporation (ou en fonction du lieu où vous vivez, l’un de ses affiliés) et vous. Lisez-les attentivement. Ils portent sur le logiciel visé ci-dessus, y compris le support sur lequel vous l’avez reçu, le cas échéant. Ce contrat porte également sur les produits Microsoft suivants :
+
+-   les mises à jour,
+-   les suppléments,
+-   les services Internet, et
+-   les services d’assistance technique
+
+de ce logiciel à moins que d’autres termes n’accompagnent ces produits, auquel cas ces derniers prévalent.
+
+**En utilisant le logiciel, vous acceptez ces termes. Si vous ne les acceptez pas, n’utilisez pas le logiciel.**
+
+**Dans le cadre du présent contrat de licence, vous disposez des droits perpétuels présentés ci-dessous.**
+
+**1.    INSTALLATION ET DROITS D’UTILISATION.** Vous êtes autorisé à installer et utiliser un nombre quelconque de copies du logiciel sur vos dispositifs.
+
+**2.    CONDITIONS DE LICENCE ET/OU DROITS D’UTILISATION SUPPLÉMENTAIRES.**
+
+-   **a.    Code distribuable.** Le logiciel contient du code que vous êtes autorisé à distribuer dans les programmes que vous développez, sous réserve de vous conformer aux termes ci-après.
+    -   **i.      Droit d’utilisation et de distribution. Le code et les fichiers répertoriés ci-après constituent le « Code distribuable ».**
+        -   Vous êtes autorisé à copier et à distribuer la version en code objet des fichiers du logiciel.
+        -   *Distribution par des tiers*. vous pouvez autoriser les distributeurs de vos programmes à copier et à distribuer le Code distribuable en tant que partie intégrante de ces programmes.
+    -   **ii.    Conditions de distribution. Pour tout Code distribuable que vous distribuez, vous devez :**
+        -   y ajouter des fonctionnalités importantes et principales au sein de vos programmes,
+        -   exiger des distributeurs et des utilisateurs finaux externes qu’ils acceptent les termes qui protègent le Code Distribuable de manière au moins équivalente à ceux du présent contrat ;
+        -   afficher votre propre mention de droits d’auteur valable dans vos programmes, et
+        -   garantir et défendre Microsoft contre toute réclamation, y compris pour les honoraires d’avocats, qui résulterait de la distribution ou de l’utilisation de vos programmes.
+    -   **iii.   Restrictions de distribution. Vous n’êtes pas autorisé à :**
+        -   modifier toute mention de droits d’auteur, marques commerciales ou mention de droits de brevet pouvant figurer dans le Code distribuable,
+        -   utiliser les marques commerciales de Microsoft dans les noms de vos programmes ou d’une façon qui suggère que vos programmes sont fournis ou recommandés par Microsoft,
+        -   distribuer le Code distribuable en vue de son exécution sur une plateforme autre que la plateforme Windows,
+        -   inclure le Code distribuable dans des programmes malveillants, trompeurs ou interdits par la loi ; ou
+        -   modifier ou distribuer le code source de tout Code distribuable de manière à ce qu’il fasse l’objet, en tout ou partie, d’une Licence exclue. Une Licence exclue implique comme condition d’utilisation, de modification ou de distribution, que :
+            -   le code soit divulgué ou distribué sous forme de code source, ou
+            -   d’autres aient le droit de le modifier.
+
+**3.    CHAMP D’APPLICATION DE LA LICENCE.** Le logiciel n’est pas vendu mais concédé sous licence. Le présent contrat vous confère certains droits d’utilisation du logiciel. Microsoft se réserve tous les autres droits. Sauf si la réglementation applicable vous confère d’autres droits, nonobstant la présente limitation, vous n’êtes autorisé à utiliser le logiciel qu’en conformité avec les termes du présent contrat. À cette fin, vous devez vous conformer aux restrictions techniques contenues dans le logiciel qui vous permettent de l’utiliser d’une certaine façon. Vous n’êtes pas autorisé à :
+
+-   contourner les restrictions techniques contenues dans le logiciel ;
+-   reconstituer la logique du logiciel, le décompiler ou le désassembler, sauf dans la mesure où ces opérations seraient expressément permises par la réglementation applicable nonobstant la présente limitation ;
+-   publier le logiciel en vue d’une reproduction par autrui ;
+-   louer ou prêter le logiciel ;
+-   transférer le logiciel ou le présent contrat à un tiers ; ou
+-   utiliser le logiciel en association avec des services d’hébergement commercial.
+
+**4.    DOCUMENTATION.** Tout utilisateur disposant d’un accès valable à votre ordinateur ou à votre réseau interne est autorisé à copier et à utiliser la documentation à titre de référence et à des fins internes.
+
+**5.    RESTRICTIONS À L’EXPORTATION.** Le logiciel est soumis aux lois et réglementations américaines en matière d’exportation. Vous devez vous conformer à toutes les lois et réglementations nationales et internationales en matière d’exportation concernant le logiciel. Ces lois comportent des restrictions sur les utilisateurs finaux et les utilisations finales. Des informations supplémentaires sont disponibles sur le site https://www.microsoft.com/exporting.
+
+**6.    SERVICES D’ASSISTANCE TECHNIQUE.** Ce logiciel étant fourni « en l’état », nous ne fournirons aucun service d’assistance technique.
+
+**7.    INTÉGRALITÉ DES ACCORDS.** Le présent contrat ainsi que les termes concernant les suppléments, les mises à jour, les services Internet et d’assistance technique que vous utilisez constituent l’intégralité des accords en ce qui concerne le logiciel et les services d’assistance technique.
+
+**8.    RÉGLEMENTATION APPLICABLE.**
+
+-   **a.    États-Unis.** Si vous avez acquis le logiciel aux États-Unis, les lois de l’État de Washington, États-Unis d’Amérique, régissent l’interprétation de ce contrat et s’appliquent en cas de réclamation pour manquement aux termes du contrat, sans donner d’effet aux dispositions régissant les conflits de lois. Les lois du pays dans lequel vous vivez régissent toutes les autres réclamations, notamment les réclamations fondées sur les lois fédérales en matière de protection des consommateurs, de concurrence déloyale et de délits.
+-   **b.    En dehors des États-Unis.** Si vous avez acquis le logiciel dans un autre pays, les lois de ce pays s’appliquent.
+
+**9.    EFFET JURIDIQUE.** Le présent contrat décrit certains droits légaux. Vous pouvez bénéficier d’autres droits prévus par les lois de votre État ou pays. Vous pouvez également bénéficier de certains droits à l’égard de la partie auprès de laquelle vous avez acquis le logiciel. Le présent contrat ne modifie pas les droits que vous confèrent les lois de votre État ou pays si celles-ci ne le permettent pas.
+
+**10.  EXCLUSIONS DE GARANTIE. Le logiciel est concédé sous licence « en l’état ». Vous assumez tous les risques liés à son utilisation. Microsoft n’accorde aucune garantie ou condition expresse. Vous pouvez bénéficier de droits des consommateurs supplémentaires ou de garanties statutaires dans le cadre du droit local, que ce contrat ne peut modifier. Lorsque cela est autorisé par le droit local, Microsoft exclut les garanties implicites de qualité, d’adéquation à un usage particulier et d’absence de violation.**
+
+**POUR L’AUSTRALIE – La loi australienne sur la consommation (Australian Consumer Law) vous accorde des garanties statutaires qu’aucun élément du présent accord ne peut affecter.**
+
+**11.  LIMITATION ET EXCLUSION DE RECOURS ET DE DOMMAGES. Vous pouvez obtenir de Microsoft et de ses fournisseurs une indemnisation en cas de dommages directs limitée à 5,00 USD. Vous ne pouvez prétendre à aucune indemnisation pour les autres dommages, y compris les dommages spéciaux, indirects, incidents ou accessoires et les pertes de bénéfices.**
+
+Cette limitation concerne :
+
+-   toute affaire liée au logiciel, aux services ou au contenu (y compris le code) figurant sur des sites Internet tiers ou dans des programmes tiers ; et
+-   les réclamations pour manquement aux termes du contrat ou violation de garantie, les réclamations en cas de responsabilité sans faute, de négligence ou autre délit dans la limite autorisée par la réglementation applicable.
+
+Elle s’applique également même si Microsoft connaissait l’éventualité d’un tel dommage. La limitation ou l’exclusion ci­dessus peut également ne pas vous être applicable si votre pays n’autorise pas l’exclusion ou la limitation de responsabilité pour les dommages incidents, indirects ou de quelque nature que ce soit.
diff --git a/entity-framework/ef6/resources/licenses/ef6/ita.md b/entity-framework/ef6/resources/licenses/ef6/ita.md
new file mode 100644
index 0000000000..617cf044c3
--- /dev/null
+++ b/entity-framework/ef6/resources/licenses/ef6/ita.md
@@ -0,0 +1,82 @@
+---
+title: Entity Framework 6 Runtime License (ITA) - EF6
+description: Entity Framework 6 Runtime License (ITA)
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework 6 Runtime License (ITA)
+**CONDIZIONI DI LICENZA SOFTWARE MICROSOFT**
+
+**MICROSOFT ENTITY FRAMEWORK**
+
+Le presenti condizioni di licenza costituiscono il contratto tra Microsoft Corporation (o, in base al luogo di residenza del licenziatario, una delle sue consociate) e il licenziatario. Il licenziatario dovrà leggerle con attenzione. Le presenti condizioni si applicano al suddetto software Microsoft, inclusi gli eventuali supporti di memorizzazione sui quali è stato ricevuto. Le presenti condizioni si applicano inoltre a
+
+-   aggiornamenti,
+-   supplementi,
+-   servizi basati su Internet e
+-   servizi di supporto tecnico
+
+forniti da Microsoft e relativi al predetto software, a meno che questi non siano accompagnati da condizioni specifiche. In tal caso, tali condizioni specifiche prevarranno su quelle del presente contratto.
+
+**Utilizzando il software, il licenziatario accetta le presenti condizioni. Qualora non le accetti, non potrà utilizzare il software.**
+
+**Qualora il licenziatario si attenga alle presenti condizioni di licenza, disporrà dei diritti perpetui di seguito indicati.**
+
+**1.    DIRITTI DI INSTALLAZIONE E DI UTILIZZO.** Il licenziatario potrà installare e utilizzare un numero qualsiasi di copie del software sui propri dispositivi.
+
+**2.    REQUISITI AGGIUNTIVI PER LE LICENZE E/O DIRITTI SULL’UTILIZZO.**
+
+-   **a.    Codice Distribuibile.** Il software contiene codice che il licenziatario potrà distribuire nei programmi che svilupperà, purché si attenga alle condizioni di seguito riportate.
+    -   **i.      Diritto di Utilizzo e Distribuzione. Il codice e i file elencati di seguito costituiscono il “Codice Distribuibile”.**
+        -   Il licenziatario potrà duplicare e distribuire il formato in codice oggetto dei file del software.
+        -   *Distribuzione da Parte di Terzi*. Il licenziatario potrà autorizzare i distributori dei propri programmi a duplicare e distribuire il Codice Distribuibile nell’ambito di tali programmi.
+    -   **ii.    Requisiti per la Distribuzione. Per distribuire il Codice Distribuibile, il licenziatario dovrà**
+        -   aggiungere rilevanti e significative funzionalità nei programmi;
+        -   far accettare ai distributori e agli utenti finali esterni un contratto con condizioni che garantiscano almeno lo stesso livello di tutela del Codice Distribuibile definito nel presente contratto;
+        -   visualizzare valide informazioni sul copyright nei propri programmi e
+        -   indennizzare, manlevare e difendere Microsoft da qualsiasi reclamo, ivi incluse le spese legali, relativo alla distribuzione o all’utilizzo dei propri programmi.
+    -   **iii.   Limitazioni relative alla Distribuzione. Il licenziatario non potrà**
+        -   modificare le eventuali informazioni su copyright, marchi o brevetti presenti nel Codice Distribuibile;
+        -   utilizzare i marchi di Microsoft nei nomi dei programmi o in modo tale da far presumere che i programmi provengano o siano approvati da Microsoft;
+        -   distribuire Codice Distribuibile da eseguire su una piattaforma diversa dalla piattaforma Windows;
+        -   includere il Codice Distribuibile in programmi dannosi, ingannevoli o illegali né
+        -   modificare o distribuire il codice sorgente di alcun Codice Distribuibile in modo che nessuna parte di tale codice diventi soggetta a una Licenza Esclusa. Per Licenza Esclusa si intende qualsiasi licenza che come condizione per l’utilizzo, la modifica o la distribuzione richieda che
+            -   il codice sia divulgato o distribuito nel formato in codice sorgente oppure
+            -   altri abbiano il diritto di modificarlo.
+
+**3.    AMBITO DI VALIDITÀ DELLA LICENZA.** Il software non viene venduto, ma è concesso in licenza. Il presente contratto concede al licenziatario solo alcuni diritti di utilizzo del software. Microsoft si riserva tutti gli altri diritti. Nel limite massimo consentito dalla legge applicabile, il licenziatario potrà utilizzare il software esclusivamente nei modi espressamente previsti dal presente contratto. Nel far ciò il licenziatario dovrà attenersi a qualsiasi limitazione tecnica presente nel software che gli consenta di utilizzarlo solo in determinati modi. Il licenziatario non potrà
+
+-   aggirare le limitazioni tecniche presenti nel software;
+-   decompilare o disassemblare il software, fatta eccezione per i casi in cui le suddette attività siano espressamente consentite dalla legge applicabile, nonostante questa limitazione;
+-   pubblicare il software per consentirne la duplicazione da parte di altri;
+-   noleggiare il software né concederlo in locazione o in prestito;
+-   trasferire il software o il presente contratto a terzi né
+-   utilizzare il software per fornire hosting di servizi commerciali.
+
+**4.    DOCUMENTAZIONE.** Qualsiasi persona che disponga di accesso valido al computer o alla rete interna del licenziatario potrà duplicare e utilizzare la documentazione per fini di riferimento interno.
+
+**5.    LIMITAZIONI RELATIVE ALL’ESPORTAZIONE.** Il software è soggetto alle leggi e ai regolamenti in vigore negli Stati Uniti in materia di controllo dell’esportazione. Il licenziatario dovrà attenersi a tutte le leggi e a tutti i regolamenti locali e internazionali applicabili al software in materia di controllo dell’esportazione. Queste leggi includono limitazioni circa le destinazioni, gli utenti finali e l’utilizzo finale. Per ulteriori informazioni, il licenziatario potrà visitare la pagina https://www.microsoft.com/exporting.
+
+**6.    SERVIZI DI SUPPORTO TECNICO.** Poiché il presente software viene fornito “com’è”, non è prevista l’erogazione di servizi di supporto tecnico da parte di Microsoft.
+
+**7.    INTERO ACCORDO.** Il presente contratto e le condizioni che disciplinano l’utilizzo dei supplementi, degli aggiornamenti, dei servizi basati su Internet e dei servizi di supporto tecnico usati dal licenziatario costituiscono l’intero accordo relativo al software e ai servizi di supporto tecnico.
+
+**8.    LEGGE APPLICABILE.**
+
+-   **a.    Stati Uniti.** Qualora il software sia stato acquistato negli Stati Uniti, il presente contratto è disciplinato e interpretato esclusivamente in base alla legge dello Stato di Washington e tale legge si applica ai reclami aventi ad oggetto gli inadempimenti contrattuali, indipendentemente dai principi in materia di conflitto di leggi. Tutti gli altri reclami, inclusi quelli aventi ad oggetto inadempimenti della normativa a tutela dei consumatori, inadempimenti delle norme in materia di concorrenza sleale e l’illecito civile, saranno disciplinati dalle leggi dello Stato di residenza del licenziatario.
+-   **b.    Al di fuori degli Stati Uniti.** Qualora il licenziatario abbia acquistato il software in qualsiasi altro Paese, il presente contratto è disciplinato dalle leggi di tale Paese.
+
+**9.    EFFETTI GIURIDICI.** Con il presente contratto vengono concessi determinati diritti. Al licenziatario potranno essere concessi altri diritti ai sensi delle leggi del Paese di residenza. Il licenziatario potrebbe, inoltre, vantare ulteriori diritti direttamente nei confronti della parte da cui ha acquistato il software. Il presente contratto non modifica i diritti del licenziatario che le leggi del Paese di residenza del licenziatario non consentono di modificare.
+
+**10.  ESCLUSIONE DI GARANZIE. Il software viene concesso in licenza “com’è”. Il licenziatario lo utilizza a proprio rischio. Non vengono fornite garanzie o condizioni espresse. Il presente contratto non modifica eventuali ulteriori diritti dei consumatori o garanzie di legge riconosciute al licenziatario dalle leggi locali. Nella misura massima consentita dalle leggi locali Microsoft esclude eventuali garanzie implicite di commerciabilità (qualità non inferiore alla media), adeguatezza per uno scopo specifico e non violazione di diritti di terzi.**
+
+**PER L’AUSTRALIA: il licenziatario è soggetto alle garanzie di legge previste ai sensi della Legge Australiana a Tutela dei Consumatori (Australian Consumer Law) e nessuna disposizione contenuta nelle presenti condizioni influisce su tali diritti.**
+
+**11.  LIMITAZIONE DI RESPONSABILITÀ ED ESCLUSIONE DI RIMEDI E DANNI. Il licenziatario può richiedere a Microsoft e ai suoi fornitori il solo risarcimento per i danni diretti nel limite di cinque dollari (USD 5). Il licenziatario non ha diritto a ottenere il risarcimento per eventuali altri danni, inclusi i danni consequenziali, speciali, indiretti, incidentali o relativi alla perdita di profitti.**
+
+Questa limitazione si applica a
+
+-   qualsiasi questione relativa al software, ai servizi, al contenuto (incluso il codice) sui siti Internet o nei programmi di terzi e
+-   reclami relativi a inadempimento contrattuale, inadempimenti della garanzia o delle condizioni, responsabilità oggettiva, negligenza o altro illecito civile, nella misura massima consentita dalla legge applicabile.
+
+Tale limitazione si applica anche nel caso in cui Microsoft sia stata informata o avrebbe dovuto essere informata della possibilità del verificarsi di tali danni. La limitazione o l**’**esclusione di cui sopra potrebbe non essere applicabile al licenziatario in quanto l’esclusione o la limitazione di danni incidentali, consequenziali o di altro tipo potrebbe non essere consentita nel Paese di residenza del licenziatario.
diff --git a/entity-framework/ef6/resources/licenses/ef6/jpn.md b/entity-framework/ef6/resources/licenses/ef6/jpn.md
new file mode 100644
index 0000000000..45708651d8
--- /dev/null
+++ b/entity-framework/ef6/resources/licenses/ef6/jpn.md
@@ -0,0 +1,83 @@
+---
+title: Entity Framework 6 Runtime License (JPN) - EF6
+description: Entity Framework 6 Runtime License (JPN)
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework 6 Runtime License (JPN)
+**マイクロソフト ソフトウェア ライセンス条項**
+
+**MICROSOFT ENTITY FRAMEWORK**
+
+マイクロソフト ソフトウェア ライセンス条項 (以下、「本ライセンス条項」といいます) は、お客様と Microsoft Corporation (またはお客様の所在地に応じた関連会社。以下、「マイクロソフト」といいます) との契約を構成します。以下のライセンス条項を注意してお読みください。本ライセンス条項は、上記のソフトウェアおよびソフトウェアが記録されたメディア (以下総称して「本ソフトウェア」といいます) に適用されます。また、本ライセンス条項は本ソフトウェアに関連する下記マイクロソフト製品にも適用されるものとします。
+
+-   更新プログラム
+-   追加ソフトウェア
+-   インターネット ベースのサービス
+-   サポート サービス
+
+これらの製品に別途ライセンス条項が付属している場合には、当該ライセンス条項が適用されるものとします。
+
+**本ソフトウェアを使用することにより、お客様は本ライセンス条項に同意されたものとします。本ライセンス条項に同意されない場合、本ソフトウェアを使用することはできません。**
+
+**お客様が本ライセンス条項を遵守することを条件として、お客様には以下の永続的な権利が許諾されます。**
+
+**1.    インストールおよび使用に関する権利。**お客様は、本ソフトウェアの任意の部数の複製をお客様のデバイスにインストールして使用することができます。
+
+**2.    追加のライセンス条件および追加の使用権。**
+
+-   **a.    再頒布可能コード。**本ソフトウェアには、お客様が開発されたプログラムに含めて再頒布可能なコードが含まれています。ただし、以下の条件に従うものとします。
+    -   **i.      使用および再頒布の権利。以下に記載するコードおよびファイルを「再頒布可能コード」と定義します。**
+        -   お客様は、ソフトウェア ファイルをオブジェクト コード形式で複製し、再頒布することができます。
+        -   *第三者による再頒布*。お客様は、お客様のプログラムの頒布者に対して、お客様のプログラムの一部として再頒布可能コードの複製および頒布を許可することができます。
+    -   **ii.    再頒布の条件。お客様は、お客様が頒布するすべての再頒布可能コードにつき、以下の条項に従わなければなりません。**
+        -   お客様のプログラムにおいて再頒布可能コードに重要かつ主要な機能を追加すること。
+        -   お客様のプログラムの頒布者および外部エンド ユーザーに、本ライセンス条項と同等以上に再頒布可能コードを保護する条項に同意させること。
+        -   お客様のプログラムにお客様名義の有効な著作権表示を行うこと。
+        -   お客様のプログラムの頒布または使用に関する請求 (弁護士報酬を含みます) について、マイクロソフトを免責、防御、および補償すること。
+    -   **iii.   再頒布の制限。お客様は、以下を行うことはできません。**
+        -   再頒布可能コードの著作権、商標または特許の表示を改変すること。
+        -   お客様のプログラムの名称の一部にマイクロソフトの商標を使用したり、お客様の製品がマイクロソフトから由来したり、マイクロソフトが推奨するように見せかけること。
+        -   Windows プラットフォーム以外のプラットフォームで実行するプログラムにおいて再配布可能コードを配布すること
+        -   悪意のある、欺瞞的、または違法なプログラムに再頒布可能コードを含めること。
+        -   再頒布可能コードの一部に除外ライセンスが適用されることとなるような方法で再頒布可能コードのソース コードを改変または頒布すること。「除外ライセンス」とは、使用、改変または頒布の条件として以下を満たすことを要求するライセンスです。
+            -   コードをソース コード形式で公表または頒布すること。または
+            -   その他の者がコード改変の権利を有すること。
+
+**3.    ライセンスの適用範囲。**本ソフトウェアは使用許諾されるものであり、販売されるものではありません。本ライセンス条項は、お客様に本ソフトウェアを使用する限定的な権利を付与します。マイクロソフトはその他の権利をすべて留保します。適用される法令により上記の制限を超える権利が与えられる場合を除き、お客様は本ライセンス条項で明示的に許可された方法でのみ本ソフトウェアを使用することができます。お客様は、使用方法を制限するために本ソフトウェアに組み込まれている技術的制限に従わなければなりません。お客様は、以下を行うことはできません。
+
+-   本ソフトウェアの技術的な制限を回避して使用すること。
+-   本ソフトウェアをリバース エンジニアリング、逆コンパイル、または逆アセンブルすること。ただし、適用される法令により明示的に認められている場合を除きます。
+-   第三者が複製できるように本ソフトウェアを公開すること。
+-   本ソフトウェアをレンタル、リース、または貸与すること。
+-   本ソフトウェアまたは本ライセンス条項を第三者に譲渡すること。
+-   本ソフトウェアを商用ソフトウェア ホスティング サービスで使用すること。
+
+**4.    ドキュメンテーション。**お客様のコンピューターまたは内部ネットワークに有効なアクセス権を有する者は、お客様の内部使用目的に限り、ドキュメントを複製して使用することができます。
+
+**5.    輸出規制。**本ソフトウェアは米国および日本国の輸出に関する規制の対象となります。お客様は、本ソフトウェアに適用されるすべての国内法および国際法 (輸出対象国、エンド ユーザーおよびエンド ユーザーによる使用に関する制限を含みます) を遵守しなければなりません。詳細については https://www.microsoft.com/ja-jp/exporting/ をご参照ください。
+
+**6.    サポート サービス。**本ソフトウェアは現状有姿で提供されます。そのため、マイクロソフトはサポート サービスを提供しない場合があります。
+
+**7.    完全合意。**本ライセンス条項およびお客様が使用する追加ソフトウェア、更新プログラム、インターネット ベースのサービス、ならびにサポート サービスに関する条項は、本ソフトウェアおよびサポート サービスについてのお客様とマイクロソフトとの間の完全なる合意です。
+
+**8.    準拠法。**
+
+-   **a.    日本。**お客様が本ソフトウェアを日本国内で入手された場合、本ライセンス条項は日本法に準拠するものとします。
+-   **b.    米国。**お客様が本ソフトウェアを米国内で入手された場合、抵触法に関わらず、本ライセンス条項の解釈および契約違反への主張は、米国ワシントン州法に準拠するものとします。消費者保護法、公正取引法、および違法行為を含みますがこれに限定されない他の主張については、お客様が所在する地域の法律に準拠します。
+-   **c.     日本および米国以外。**お客様が本ソフトウェアを日本国および米国以外の国で入手された場合、本ライセンス条項は適用される地域法に準拠するものとします。
+
+**9.    法的効力。**本ライセンス条項は、特定の法的な権利を規定します。お客様は、地域や国によっては、本ライセンス条項の定めにかかわらず、本ライセンス条項と異なる権利を有する場合があります。また、お客様は本ソフトウェアの取得取引の相手方に対して権利を取得できる場合もあります。本ライセンス条項は、お客様の地域または国の法律により権利の拡大が認められない限り、それらの権利を変更しないものとします。
+
+**10.  あらゆる保証の免責。本ソフトウェアは、現状有姿のまま瑕疵を問わない条件で提供されます。本ソフトウェアの使用に伴う危険は、お客様の負担とします。マイクロソフトは、明示的な瑕疵担保責任または保証責任を一切負いません。本ライセンス条項では変更できないお客様の地域の法律による追加の消費者の権利または法定保証が存在する場合があります。お客様の地域の国内法等によって認められる限り、マイクロソフトは、商品性、特定目的に対する適合性、および侵害の不存在に関する瑕疵担保責任または黙示の保証責任を負いません。**
+
+**オーストラリア限定。お客様は、オーストラリア消費者法に基づく法定保証を有し、これらの条項は、それらの権利に影響を与えることを意図するものではありません。**
+
+**11.  救済手段および責任の制限および除外。マイクロソフトおよびそのサプライヤーの責任は、5.00 米ドルを上限とする直接損害に限定されます。その他の損害 (派生的損害、逸失利益、特別損害、間接損害、および付随的損害を含みますがこれらに限定されません) に関しては、一切責任を負いません。**
+
+この制限は、以下に適用されるものとします。
+
+-   本ソフトウェア、サービス、第三者のインターネットのサイト上のコンテンツ (コードを含みます)、または第三者のプログラムに関連した事項
+-   契約違反、保証違反、厳格責任、過失、または不法行為等の請求 (適用される法令により認められている範囲において)
+
+この制限は、マイクロソフトが損害の可能性を認識していたか、または認識し得た場合にも適用されます。また、一部の国では付随的損害および派生的損害の免責、または責任の制限が認められないため、上記の制限事項が適用されない場合があります。
diff --git a/entity-framework/ef6/resources/licenses/ef6/kor.md b/entity-framework/ef6/resources/licenses/ef6/kor.md
new file mode 100644
index 0000000000..0163b43245
--- /dev/null
+++ b/entity-framework/ef6/resources/licenses/ef6/kor.md
@@ -0,0 +1,82 @@
+---
+title: Entity Framework 6 Runtime License (KOR) - EF6
+description: Entity Framework 6 Runtime License (KOR)
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework 6 Runtime License (KOR)
+**MICROSOFT 소프트웨어 사용권 계약서**
+
+**MICROSOFT ENTITY FRAMEWORK**
+
+본 사용권 계약은 Microsoft Corporation(또는 거주 지역에 따라 계열사 중 하나)과 귀하 간에 체결되는 계약입니다. 본 사용권 계약을 읽어 주시기 바랍니다. 본 사용권 계약은 위에 명시된 소프트웨어 및 이 소프트웨어가 포함된 미디어가 있는 경우 해당 미디어에 적용됩니다. 본 계약은 해당 품목에 별도의 약정이 있지 않는 한, 이 소프트웨어에 대한
+
+-   업데이트,
+-   추가 구성 요소,
+-   인터넷 기반 서비스 및
+-   지원 서비스
+
+와 같은Microsoft 구성 요소에도 적용됩니다. 별도의 약정이 있는 경우, 해당 약정이 적용됩니다.
+
+**이 소프트웨어를 사용함으로써 귀하는 아래의 조항들에 동의하게 됩니다. 동의하지 않을 경우에는 소프트웨어를 사용하지 마십시오.**
+
+**본 사용권 계약을 준수하는 경우 아래와 같은 영구적 권리를 행사할 수 있습니다.**
+
+**1.    설치 및 사용 권한.** 본 소프트웨어의 사본을 수량에 관계없이 장치에 설치하여 사용할 수 있습니다.
+
+**2.    추가 사용권 요구 사항 및/또는 사용 권한.**
+
+-   **a.    배포 가능 코드.** 소프트웨어에는 귀사가 아래 조항을 준수하는 경우 귀사가 개발하는 프로그램에서 배포 권한이 부여되는 코드가 포함되어 있습니다.
+    -   **i.      사용 및 배포 권한. 아래에 나열된 코드 및 파일은 "배포 가능 코드"입니다.**
+        -   귀하는 소프트웨어 파일을 개체 코드 형태로 복사 및 배포할 수 있습니다.
+        -   *제3자에 의한 배포*. 프로그램 배포자가 배포 가능 코드를 프로그램의 일부로 복사 및 배포하도록 허용할 수 있습니다.
+    -   **ii.    배포 조건. 배포 가능 코드를 배포하려면**
+        -   귀사의 프로그램 내에서 배포 가능 코드에 중요한 기능을 추가해야 합니다.
+        -   최소한 본 계약에 준하는 배포 가능 코드를 보호할 수 있는 조항에 배포자와 외부의 최종 사용자가 동의하도록 해야 합니다.
+        -   귀사의 프로그램에 유효한 저작권 표시를 해야 합니다.
+        -   귀사의 프로그램 배포 또는 사용과 관련된 모든 청구(변호사 비용 포함)로부터 Microsoft를 면책하고 해를 입히지 않으며 방어해야 합니다.
+    -   **iii.   배포 제한. 다음과 같은 행위는 허용되지 않습니다.**
+        -   배포 가능 코드의 저작권, 상표 또는 특허 표시를 변경하는 행위
+        -   Microsoft의 상표를 프로그램 이름에 사용하거나 귀사의 프로그램을Microsoft에서 만들거나 보증한다고 광고하는 행위
+        -   배포 가능 코드를 배포하여 Windows가 아닌 플랫폼에서 실행하는 행위
+        -   배포 가능 코드를 악성, 기만적 또는 불법적인 프로그램에 포함하는 행위
+        -   배포 가능 코드의 일부분이 예외적 라이선스에 적용되도록 배포 가능 코드의 소스 코드를 수정하거나 배포하는 행위. 예외적 라이선스란 사용, 수정 또는 배포를 위해 다음과 같은 조건을 필요로 하는 라이선스입니다.
+            -   코드가 소스 코드 형태로 공개되거나 배포됩니다.
+            -   다른 사람에게 배포 가능 코드를 수정할 수 있는 권리가 있습니다.
+
+**3.    사용권의 범위.** 본 소프트웨어는 판매되는 것이 아니라 그 사용이 허여되는 것입니다. 본 계약은 귀하에게 소프트웨어를 사용할 수 있는 권한을 허여합니다. 기타 모든 권한은Microsoft가 보유합니다. 이러한 제한과 관계없이 관련 법률에서 귀하에게 더 많은 권한을 부여하지 않는 한, 귀하는 본 계약에서 명시적으로 허용되는 조건에 한해서만 소프트웨어를 사용할 수 있습니다. 그렇게 하는 경우 귀하는 특정 방식으로만 사용할 수 있도록 하는 소프트웨어의 모든 기술적 제한 사항을 준수해야 합니다. 다음과 같은 행위는 허용되지 않습니다.
+
+-   소프트웨어의 기술적 제한 사항을 위반하는 행위
+-   이러한 제한에도 불구하고 관련 법률에서 명시적으로 허용하는 경우를 제외한 소프트웨어의 리버스 엔지니어링, 디컴파일 또는 디스어셈블 작업을 수행하는 행위
+-   다른 사람이 복사할 수 있도록 소프트웨어를 게시하는 행위
+-   소프트웨어를 임대, 대여 또는 대부하는 행위
+-   소프트웨어나 본 계약서를 제3자에게 양도하는 행위
+-   상업용 소프트웨어 호스팅 서비스에 소프트웨어를 사용하는 행위
+
+**4.    설명서.** 귀하의 컴퓨터 또는 내부 네트워크에 유효한 액세스 권한이 있는 사용자는 내부적인 참고 목적으로 설명서를 복사 및 사용할 수 있습니다.
+
+**5.    수출 제한.** 소프트웨어는 미국 수출 법률 및 규정의 적용을 받습니다. 귀하는 소프트웨어에 적용되는 모든 국내 및 국제 수출 법률 및 규정을 준수해야 합니다. 이러한 법률에는 목적지, 최종 사용자 및 최종 용도에 대한 제한이 포함됩니다. 자세한 내용은 https://www.microsoft.com/exporting 을 참조하십시오.
+
+**6.    지원 서비스.** 이 소프트웨어는 "있는 그대로" 제공되므로 이 소프트웨어에 대한 지원 서비스가 제공되지 않을 수 있습니다.
+
+**7.    전면 합의.** 본 계약 및 귀하가 이용하는 추가 구성 요소, 업데이트, 인터넷 기반 서비스 및 지원 서비스에 대한 조항은 소프트웨어 및 지원 서비스에 대한 전면 합의입니다.
+
+**8.    관련 법률.**
+
+-   **a.    미국.** 소프트웨어를 미국에서 구입한 경우, 국제사법 원칙에 관계없이 본 계약의 해석은 워싱턴 주법을 따르며 계약 위반에 대한 청구 발생 시에도 워싱턴 주법이 적용됩니다. 소비자 보호법, 불공정거래법 및 기타 불법 행위 관련 법규의 적용을 받는 청구가 발생한 경우 귀하가 거주하고 있는 주의 주법이 적용됩니다.
+-   **b.    미국 외 지역.** 본 사용권 계약에는 대한민국 법이 적용됩니다.
+
+**9.    법적 효력.** 본 계약은 특정 법적 권리에 대해 기술하고 있습니다. 귀하는 귀하가 거주하고 있는 국가의 법규가 보장하는 다른 권리를 보유할 수 있습니다. 또한 귀하가 소프트웨어를 구입한 당사자와 관련된 권리를 보유할 수도 있습니다. 귀하가 거주하고 있는 국가의 법에서 권리 변경을 허용하지 않는 경우 본 계약은 해당 권리를 변경하지 않습니다.
+
+**10.  보증의 부인. 이 소프트웨어는 "있는 그대로" 사용권이 허여됩니다. 소프트웨어의 사용으로 발생하는 위험은 귀하의 책임입니다. Microsoft는 어떠한 명시적 보증, 보장 또는 조건도 제시하지 않습니다. 귀하는 귀하가 거주하는 지역의 법규에 따른 추가적인 소비자 권리 또는 법적 권리를 보유할 수 있으며, 이 권리는 본 계약을 통해 변경되지 않습니다. 귀하가 거주하는 지역의 법규가 허용하는 범위 내에서Microsoft는 상업성, 특정 목적에의 적합성 및 비침해성과 관련된 묵시적 보증을 배제합니다.**
+
+**오스트레일리아의 경우 – 귀하는 오스트레일리아 소비자 보호법에 따라 법적 권리를 보유하며 본 계약서의 어떠한 내용도 해당 권리에 영향을 미칠 수 없습니다.**
+
+**11.  손해 및 구제수단의 제한 및 배제. 귀하는 직접적인 손해에 한해Microsoft와 그 공급자로부터 최대 미화$5.00까지 보상받을 수 있습니다. 결과적 손해, 이익 손실, 특별, 간접 또는 부수적 손해를 포함한 기타 모든 손해에 대해서는 보상을 받을 수 없습니다.**
+
+이 제한 사항은 다음에 적용됩니다.
+
+-   제3자 인터넷 사이트상의 소프트웨어, 서비스, 콘텐츠(코드 포함) 또는 제3자 프로그램과 관련하여 발생하는 모든 문제
+-   계약 위반, 보증, 보장 또는 조건의 불이행, 무과실 책임, 과실 또는 관련 법률에서 허용하는 범위 내의 기타 불법 행위 등으로 인한 청구
+
+Microsoft가 그러한 손해의 가능성에 대해 사전에 알고 있었거나 알아야만 했던 경우에도 적용됩니다. 귀하가 거주하고 있는 국가에서 부수적, 결과적 또는 기타 손해의 배제나 제한을 허용하지 않는 경우에는 위의 제한이나 배제가 적용되지 않을 수 있습니다.
diff --git a/entity-framework/ef6/resources/licenses/ef6/prerelease/alpha.md b/entity-framework/ef6/resources/licenses/ef6/prerelease/alpha.md
new file mode 100644
index 0000000000..5892416695
--- /dev/null
+++ b/entity-framework/ef6/resources/licenses/ef6/prerelease/alpha.md
@@ -0,0 +1,85 @@
+---
+title: Entity Framework 6 Runtime Alpha License - EF6
+description: Entity Framework 6 Runtime Alpha License
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework 6 Runtime Alpha License (ENU)
+**MICROSOFT PRE-RELEASE SOFTWARE LICENSE TERMS**
+
+**MICROSOFT Entity Framework**
+
+These license terms are an agreement between Microsoft Corporation (or based on where you live, one of its affiliates) and you. Please read them. They apply to the pre-release software named above, which includes the media on which you received it, if any. The terms also apply to any Microsoft
+
+-   updates,
+-   supplements,
+-   Internet-based services, and
+-   support services
+
+for this software, unless other terms accompany those items. If so, those terms apply.
+
+**By using the software, you accept these terms. If you do not accept them, do not use the software.**
+
+**If you comply with these license terms, you have the rights below.**
+
+**1)   INSTALLATION AND USE RIGHTS. ** You may install and use any number of copies of the software on your devices. 
+
+**2)   TERM.**This agreement will automatically expire on August 1, 2013 or the commercial release of the software, whichever comes first.
+
+**3)   PRE-RELEASE SOFTWARE.** This software is a pre-release version. It may not work the way a final version of the software will. We may change it for the final, commercial version. We also may not release a commercial version.
+
+**4)   FEEDBACK.** If you give feedback about the software to Microsoft, you give to Microsoft, without charge, the right to use, share and commercialize your feedback in any way and for any purpose. You also give to third parties, without charge, any patent rights needed for their products, technologies and services to use or interface with any specific parts of a Microsoft software or service that includes the feedback. You will not give feedback that is subject to a license that requires Microsoft to license its software or documentation to third parties because we include your feedback in them. These rights survive this agreement.
+
+**5)   THIRD PARTY NOTICES.** The software may include third party code that Microsoft, not the third party, licenses to you under this agreement.  Notices, if any, for the third party code are included for your information only. 
+
+**6)   Scope of License.** The software is licensed, not sold. This agreement only gives you some rights to use the software. Microsoft reserves all other rights. Unless applicable law gives you more rights despite this limitation, you may use the software only as expressly permitted in this agreement. In doing so, you must comply with any technical limitations in the software that only allow you to use it in certain ways. You may not
+
+-   disclose the results of any benchmark tests of the software to any third party without Microsoft’s prior written approval;
+-   work around any technical limitations in the software;
+-   reverse engineer, decompile or disassemble the software, except and only to the extent that applicable law expressly permits, despite this limitation;
+-   make more copies of the software than specified in this agreement or allowed by applicable law, despite this limitation;
+-   publish the software for others to copy;
+-   rent, lease or lend the software; or
+-   transfer the software or this agreement to any third party.
+
+**7)   Export Restrictions.**The software is subject to United States export laws and regulations. You must comply with all domestic and international export laws and regulations that apply to the software. These laws include restrictions on destinations, end users and end use. For additional information, see [www.microsoft.com/exporting](https://www.microsoft.com/exporting).
+
+**8)   SUPPORT SERVICES.** Because this software is “as is,” we may not provide support services for it.
+
+**9)   Entire Agreement.** This agreement, and the terms for supplements, updates, Internet-based services and support services that you use, are the entire agreement for the software and support services.
+
+**10) Applicable Law.**
+
+**a)   United States.** If you acquired the software in the United States, Washington state law governs the interpretation of this agreement and applies to claims for breach of it, regardless of conflict of laws principles. The laws of the state where you live govern all other claims, including claims under state consumer protection laws, unfair competition laws, and in tort.
+
+**b)   Outside the United States.** If you acquired the software in any other country, the laws of that country apply.
+
+**11) Legal Effect.** This agreement describes certain legal rights. You may have other rights under the laws of your country. You may also have rights with respect to the party from whom you acquired the software. This agreement does not change your rights under the laws of your country if the laws of your country do not permit it to do so.
+
+**12) Disclaimer of Warranty.The software is licensed “as-is.” You bear the risk of using it. Microsoft gives no express warranties, guarantees or conditions. You may have additional consumer rights under your local laws which this agreement cannot change. To the extent permitted under your local laws, Microsoft excludes the implied warranties of merchantability, fitness for a particular purpose and non-infringement.**
+
+**13) Limitation on and Exclusion of Remedies and Damages.You can recover from Microsoft and its suppliers only direct damages up to U.S. $5.00. You cannot recover any other damages, including consequential, lost profits, special, indirect or incidental damages.**
+
+This limitation applies to
+
+-   anything related to the software, services, content (including code) on third party Internet sites, or third party programs; and
+-   claims for breach of contract, breach of warranty, guarantee or condition, strict liability, negligence, or other tort to the extent permitted by applicable law.
+
+It also applies even if Microsoft knew or should have known about the possibility of the damages. The above limitation or exclusion may not apply to you because your country may not allow the exclusion or limitation of incidental, consequential or other damages.
+
+**Please note: As this software is distributed in Quebec, Canada, some of the clauses in this agreement are provided below in French.**
+
+**Remarque : Ce logiciel étant distribué au Québec, Canada, certaines des clauses dans ce contrat sont fournies ci-dessous en français.**
+
+**EXONÉRATION DE GARANTIE.** Le logiciel visé par une licence est offert « tel quel ». Toute utilisation de ce logiciel est à votre seule risque et péril. Microsoft n’accorde aucune autre garantie expresse. Vous pouvez bénéficier de droits additionnels en vertu du droit local sur la protection des consommateurs, que ce contrat ne peut modifier. La ou elles sont permises par le droit locale, les garanties implicites de qualité marchande, d’adéquation à un usage particulier et d’absence de contrefaçon sont exclues.
+
+**LIMITATION DES DOMMAGES-INTÉRÊTS ET EXCLUSION DE RESPONSABILITÉ POUR LES DOMMAGES.** Vous pouvez obtenir de Microsoft et de ses fournisseurs une indemnisation en cas de dommages directs uniquement à hauteur de 5,00 $ US. Vous ne pouvez prétendre à aucune indemnisation pour les autres dommages, y compris les dommages spéciaux, indirects ou accessoires et pertes de bénéfices.
+
+Cette limitation concerne :
+
+-   tout ce qui est relié au logiciel, aux services ou au contenu (y compris le code) figurant sur des sites Internet tiers ou dans des programmes tiers ; et
+-   les réclamations au titre de violation de contrat ou de garantie, ou au titre de responsabilité stricte, de négligence ou d’une autre faute dans la limite autorisée par la loi en vigueur.
+
+Elle s’applique également, même si Microsoft connaissait ou devrait connaître l’éventualité d’un tel dommage. Si votre pays n’autorise pas l’exclusion ou la limitation de responsabilité pour les dommages indirects, accessoires ou de quelque nature que ce soit, il se peut que la limitation ou l’exclusion ci-dessus ne s’appliquera pas à votre égard.
+
+**EFFET JURIDIQUE.** Le présent contrat décrit certains droits juridiques. Vous pourriez avoir d’autres droits prévus par les lois de votre pays. Le présent contrat ne modifie pas les droits que vous confèrent les lois de votre pays si celles-ci ne le permettent pas.
diff --git a/entity-framework/ef6/resources/licenses/ef6/prerelease/beta-rc.md b/entity-framework/ef6/resources/licenses/ef6/prerelease/beta-rc.md
new file mode 100644
index 0000000000..575a7e1674
--- /dev/null
+++ b/entity-framework/ef6/resources/licenses/ef6/prerelease/beta-rc.md
@@ -0,0 +1,73 @@
+---
+title: Entity Framework 6 Runtime Beta/RC License - EF6
+description: Entity Framework 6 Runtime Beta/RC License
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework 6 Runtime Beta/RC License (ENU)
+**MICROSOFT PRE-RELEASE SOFTWARE LICENSE TERMS**
+
+**MICROSOFT ENTITY FRAMEWORK**
+
+These license terms are an agreement between Microsoft Corporation (or based on where you live, one of its affiliates) and you. Please read them. They apply to the pre-release software named above, which includes the media on which you received it, if any. The terms also apply to any Microsoft
+
+-   updates,
+-   supplements,
+-   Internet-based services, and
+-   support services
+
+for this software, unless other terms accompany those items. If so, those terms apply.
+
+**BY USING THE SOFTWARE, YOU ACCEPT THESE TERMS. IF YOU DO NOT ACCEPT THEM, DO NOT USE THE SOFTWARE.**
+
+**IF YOU COMPLY WITH THESE LICENSE TERMS, YOU HAVE THE RIGHTS BELOW.**
+
+**1.    INSTALLATION AND USE RIGHTS.**
+
+**a.    Installation and Use.**
+
+-   You may install and use any number of copies of the software on your premises to design, develop and test your programs for use with the software.
+-   You may not test the software in a live operating environment unless Microsoft permits you to do so under another agreement.
+
+**2.    TERM.** The term of this agreement is until 31/12/2013 (day/month/year), or commercial release of the software, whichever is first.
+
+**3.    PRE-RELEASE SOFTWARE.** This software is a pre-release version. It may not work the way a final version of the software will. We may change it for the final, commercial version. We also may not release a commercial version.
+
+**4.    FEEDBACK.** If you give feedback about the software to Microsoft, you give to Microsoft, without charge, the right to use, share and commercialize your feedback in any way and for any purpose. You also give to third parties, without charge, any patent rights needed for their products, technologies and services to use or interface with any specific parts of a Microsoft software or service that includes the feedback. You will not give feedback that is subject to a license that requires Microsoft to license its software or documentation to third parties because we include your feedback in them. These rights survive this agreement.
+
+**5.    SCOPE OF LICENSE.** The software is licensed, not sold. This agreement only gives you some rights to use the software. Microsoft reserves all other rights. Unless applicable law gives you more rights despite this limitation, you may use the software only as expressly permitted in this agreement. In doing so, you must comply with any technical limitations in the software that only allow you to use it in certain ways. You may not
+
+-   work around any technical limitations in the software;
+-   reverse engineer, decompile or disassemble the software, except and only to the extent that applicable law expressly permits, despite this limitation;
+-   make more copies of the software than specified in this agreement or allowed by applicable law, despite this limitation;
+-   publish the software for others to copy;
+-   rent, lease or lend the software;
+-   transfer the software or this agreement to any third party; or
+-   use the software for commercial software hosting services.
+
+**6.    EXPORT RESTRICTIONS.** The software is subject to United States export laws and regulations. You must comply with all domestic and international export laws and regulations that apply to the software. These laws include restrictions on destinations, end users and end use. For additional information, see https://www.microsoft.com/exporting.
+
+**7.    SUPPORT SERVICES.** Because this software is “as is,” we may not provide support services for it.
+
+**8.    ENTIRE AGREEMENT.** This agreement, and the terms for supplements, updates, Internet-based services and support services that you use, are the entire agreement for the software and support services.
+
+**9.    APPLICABLE LAW.**
+
+**a.    United States.** If you acquired the software in the United States, Washington state law governs the interpretation of this agreement and applies to claims for breach of it, regardless of conflict of laws principles. The laws of the state where you live govern all other claims, including claims under state consumer protection laws, unfair competition laws, and in tort.
+
+**b.    Outside the United States.** If you acquired the software in any other country, the laws of that country apply.
+
+**10. LEGAL EFFECT.** This agreement describes certain legal rights. You may have other rights under the laws of your country. You may also have rights with respect to the party from whom you acquired the software. This agreement does not change your rights under the laws of your country if the laws of your country do not permit it to do so.
+
+**11. DISCLAIMER OF WARRANTY. THE SOFTWARE IS LICENSED “AS-IS.” YOU BEAR THE RISK OF USING IT. MICROSOFT GIVES NO EXPRESS WARRANTIES, GUARANTEES OR CONDITIONS. YOU MAY HAVE ADDITIONAL CONSUMER RIGHTS OR STATUTORY GUARANTEES UNDER YOUR LOCAL LAWS WHICH THIS AGREEMENT CANNOT CHANGE. TO THE EXTENT PERMITTED UNDER YOUR LOCAL LAWS, MICROSOFT EXCLUDES THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.**
+
+**FOR AUSTRALIA – YOU HAVE STATUTORY GUARANTEES UNDER THE AUSTRALIAN CONSUMER LAW AND NOTHING IN THESE TERMS IS INTENDED TO AFFECT THOSE RIGHTS.**
+
+**12. LIMITATION ON AND EXCLUSION OF REMEDIES AND DAMAGES. YOU CAN RECOVER FROM MICROSOFT AND ITS SUPPLIERS ONLY DIRECT DAMAGES UP TO U.S. $5.00. YOU CANNOT RECOVER ANY OTHER DAMAGES, INCLUDING CONSEQUENTIAL, LOST PROFITS, SPECIAL, INDIRECT OR INCIDENTAL DAMAGES.**
+
+This limitation applies to
+
+-   anything related to the software, services, content (including code) on third party Internet sites, or third party programs; and
+-   claims for breach of contract, breach of warranty, guarantee or condition, strict liability, negligence, or other tort to the extent permitted by applicable law.
+
+It also applies even if Microsoft knew or should have known about the possibility of the damages. The above limitation or exclusion may not apply to you because your country may not allow the exclusion or limitation of incidental, consequential or other damages.
diff --git a/entity-framework/ef6/resources/licenses/ef6/rus.md b/entity-framework/ef6/resources/licenses/ef6/rus.md
new file mode 100644
index 0000000000..7b97f450eb
--- /dev/null
+++ b/entity-framework/ef6/resources/licenses/ef6/rus.md
@@ -0,0 +1,82 @@
+---
+title: Entity Framework 6 Runtime License (RUS) - EF6
+description: Entity Framework 6 Runtime License (RUS)
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework 6 Runtime License (RUS)
+**УСЛОВИЯ ЛИЦЕНЗИИ НА ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ MICROSOFT**
+
+**MICROSOFT ENTITY FRAMEWORK**
+
+Настоящие условия лицензии являются соглашением между корпорацией Microsoft (или, в зависимости от места вашего проживания, одним из ее аффилированных лиц) и вами. Прочтите их внимательно. Они применяются к вышеуказанному программному обеспечению, включая носители, на которых оно распространяется (если они есть). Эти условия распространяются также на все
+
+-   обновления,
+-   дополнительные компоненты,
+-   службы Интернета и
+-   службы технической поддержки
+
+Microsoft для данного программного обеспечения, если эти элементы не сопровождаются другими условиями. В последнем случае применяются соответствующие условия.
+
+**Используя это программное обеспечение, вы выражаете согласие соблюдать данные условия. Если вы не согласны с условиями лицензии, не используйте это программное обеспечение.**
+
+**При соблюдении вами условий данной лицензии вам предоставляются следующие бессрочные права.**
+
+**1.    УСТАНОВКА И ПРАВА ИСПОЛЬЗОВАНИЯ.** Вы можете установить и использовать любое количество копий программного обеспечения на своих устройствах.
+
+**2.    ДОПОЛНИТЕЛЬНЫЕ ТРЕБОВАНИЯ ЛИЦЕНЗИРОВАНИЯ И ПРАВА НА ИСПОЛЬЗОВАНИЕ.**
+
+-   **a.    Вторично распространяемый код.** Программное обеспечение содержит код, который разрешается распространять в составе разрабатываемых вами программ при соблюдении вами следующих условий.
+    -   **i.      Право на использование и распространение. Программный код и файлы, перечисленные ниже, представляют собой «Вторично распространяемый код».**
+        -   Вы имеете право копировать и распространять в виде объектного кода файлы программного обеспечения.
+        -   *Распространение третьими лицами*. Вы можете разрешить дистрибьюторам ваших программ копировать и распространять Вторично распространяемый код как часть этих программ.
+    -   **ii.    Условия распространения. Для распространения любого Вторично распространяемого кода вы должны:**
+        -   существенно расширить основные функциональные возможности кода в своих программах;
+        -   потребовать от дистрибьюторов и внешних конечных пользователей соблюдения условий, которые будут защищать Вторично распространяемый код не меньше, чем данное соглашение;
+        -   отображать действительное уведомление об авторских правах в ваших программах; и
+        -   освободить от ответственности, защитить и оградить Microsoft от любых претензий и исков, связанных с использованием и распространением ваших программ, включая расходы на оплату услуг адвокатов.
+    -   **iii.   Ограничения распространения. Вы не имеете права:**
+        -   изменять уведомления об авторских правах, патентных правах и правах на товарные знаки, присутствующие во Вторично распространяемом коде;
+        -   использовать товарные знаки Microsoft в названиях своих программ или таким способом, который заставил бы пользователя предположить, что программа является продуктом Microsoft или одобрена ею;
+        -   распространять Вторично распространяемый код для использования его на платформе, отличной от Windows;
+        -   включать Вторично распространяемый код во вредоносные, незаконные или вводящие в заблуждение программы;
+        -   изменять или распространять исходный код любого Вторично распространяемого кода таким образом, чтобы любая его часть подпадала под действие исключенной лицензии. Исключенная лицензия — это любая лицензия, согласно которой использование, изменение или распространение возможны только при соблюдении следующих условий:
+            -   код раскрывается и распространяется в виде исходного кода;
+            -   другие лица имеют право его изменять.
+
+**3.    ОБЪЕМ ЛИЦЕНЗИИ.** Программное обеспечение не продается, а лицензируется. Это соглашение дает вам только некоторые права на использование программного обеспечения. Microsoft оставляет за собой все остальные права. За исключением случаев, когда, несмотря на данное ограничение, применимое право предоставляет вам больше прав, вы можете использовать программное обеспечение только теми способами, которые явно указаны в условиях настоящего соглашения. При этом вы должны соблюдать все технические ограничения в программном обеспечении, допускающие использование программного обеспечения только определенным образом. Вы не имеете права:
+
+-   пытаться обойти технические ограничения в программном обеспечении;
+-   изучать технологию, декомпилировать или деассемблировать программное обеспечение, если это прямо не разрешено применимым правом, несмотря на данное ограничение;
+-   публиковать программное обеспечение, предоставляя другим лицам возможность его копировать;
+-   предоставлять программное обеспечение в прокат, в аренду или во временное пользование;
+-   передавать программное обеспечение или это соглашение третьим лицам;
+-   использовать это программное обеспечение для предоставления услуг удаленного доступа на коммерческой основе.
+
+**4.    ДОКУМЕНТАЦИЯ.** Любое лицо, имеющее право на доступ к вашему компьютеру или внутренней сети, может копировать и использовать документацию для внутренних целей справочного характера.
+
+**5.    ОГРАНИЧЕНИЯ НА ЭКСПОРТ.** Данное программное обеспечение подпадает под действие экспортного законодательства Соединенных Штатов. Вы обязаны соблюдать все внутренние и международные нормы экспортного законодательства, применимые к программному обеспечению. К таким положениям экспортного законодательства относятся ограничения по конечным пользователям, порядку и регионам конечного использования. Дополнительные сведения см. на веб-сайте https://www.microsoft.com/exporting.
+
+**6.    ТЕХНИЧЕСКАЯ ПОДДЕРЖКА.** Так как это программное обеспечение предоставляется «как есть», Microsoft может не предоставлять услуг по его технической поддержке.
+
+**7.    ПОЛНОТА СОГЛАШЕНИЯ.** Это соглашение, а также условия, которые сопровождают используемые вами дополнения, обновления, службы Интернета и службы технической поддержки, составляют полное соглашение по программному обеспечению и службам поддержки.
+
+**8.    ПРИМЕНИМОЕ ПРАВО.**
+
+-   **a.    На территории Соединенных Штатов.** Если вы приобрели программное обеспечение в Соединенных Штатах, это соглашение подлежит толкованию в соответствии с законодательством штата Вашингтон, США. Любые претензии в связи с нарушением данного соглашения также рассматриваются в соответствии с этим законодательством независимо от принципов коллизионного права. Все остальные претензии, включая претензии на основании законов штата о защите потребителей и законов о недобросовестной конкуренции, а также в связи с гражданским правонарушением, регулируются законами штата, в котором вы проживаете.
+-   **b.    За пределами Соединенных Штатов.** Если вы приобрели программное обеспечение в любой другой стране, применяются законы этой страны.
+
+**9.    ЮРИДИЧЕСКАЯ СИЛА.** Это соглашение описывает определенные юридические права. По законам своего штата или своей страны вы можете иметь дополнительные права. Вы также можете иметь права в отношении стороны, у которой вы приобрели программное обеспечение. Это соглашение не изменяет ваших прав, предусмотренных законами вашей страны, если это не допускается законами вашей страны.
+
+**10.  ОТКАЗ ОТ ПРЕДОСТАВЛЕНИЯ ГАРАНТИЙ. Программное обеспечение лицензируется «как есть». Вы пользуетесь им на собственный риск. Microsoft не предоставляет никаких явных гарантий и не гарантирует соблюдение каких-либо условий. Вы можете иметь дополнительные права потребителя или гарантии, предусмотренные местным законодательством, которое это соглашение не может изменить. В степени, допускаемой местным законодательством, Microsoft исключает подразумеваемые гарантии товарной пригодности, пригодности для определенной цели и отсутствия нарушения прав иных правообладателей.**
+
+**ДЛЯ АВСТРАЛИИ — вы имеете гарантии, предусмотренные Законом Австралии о правах потребителей, и ничто в настоящих условиях не подразумевает ущемление этих прав.**
+
+**11.  ОГРАНИЧЕНИЕ И ОТСУТСТВИЕ СРЕДСТВ ЗАЩИТЫ ПРАВ ПОТРЕБИТЕЛЕЙ В СВЯЗИ С УБЫТКАМИ И УЩЕРБОМ. Вы можете взыскать с Microsoft и поставщиков Microsoft только прямые убытки в размере не более 5,00 долларов США. Вы не можете взыскать никакие другие убытки, включая косвенные, специальные, опосредованные или случайные убытки, а также убытки в связи с упущенной выгодой.**
+
+Это ограничение распространяется:
+
+-   на все, что связано с программным обеспечением, службами и содержимым веб-сайтов третьих лиц (включая код), а также с программами сторонних разработчиков;
+-   на претензии, связанные с нарушением условий соглашения, гарантии или других условий, строгой ответственностью, неосторожностью или другим гражданским правонарушением, в максимально допустимой степени в соответствии с применимым правом.
+
+Это ограничение действует даже в том случае, если в Microsoft было или должно было быть известно о возможности таких убытков. Вышеуказанные ограничения и исключения могут к вам не относиться, если законодательство вашей страны не допускает исключения или ограничения ответственности за случайные, косвенные или другие убытки.
diff --git a/entity-framework/ef6/resources/school-database.md b/entity-framework/ef6/resources/school-database.md
new file mode 100644
index 0000000000..1730c3cbe6
--- /dev/null
+++ b/entity-framework/ef6/resources/school-database.md
@@ -0,0 +1,676 @@
+---
+title: School Sample Database - EF6
+description: School Sample Database for Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/resources/school-database
+---
+# School Sample Database
+This topic contains the schema and data for the School database. The sample School database is used in various places throughout the Entity Framework documentation.  
+
+> [!NOTE]
+> The database server that is installed with Visual Studio is different depending on the version of Visual Studio you use. See [Visual Studio Releases](xref:ef6/what-is-new/visual-studio) for details on what to use.  
+
+Here are the steps to create the database:
+
+- Open Visual Studio  
+- **View** -> **Server Explorer**  
+- Right click on **Data Connections** -> **Add Connection…**  
+- If you haven’t connected to a database from Server Explorer before you’ll need to select **Microsoft SQL Server** as the data source  
+- Connect to either LocalDB or SQL Express, depending on which one you have installed  
+- Enter **School** as the database name  
+- Select **OK** and you will be asked if you want to create a new database, select **Yes**  
+- The new database will now appear in Server Explorer  
+- If you are using Visual Studio 2012 or newer
+    - Right-click on the database in Server Explorer and select **New Query**  
+    - Copy the following SQL into the new query, then right-click on the query and select **Execute**  
+- If you are using Visual Studio 2010  
+    - Select **Data** -> **Transact SQL Editor** -> **New Query Connection...**  
+    - Enter **.\SQLEXPRESS** as the server name and click **OK**  
+    - Select the **STESample** database from the drop down at the top of the query editor  
+    - Copy the following SQL into the new query, then right-click on the query and select **Execute SQL**  
+
+``` SQL  
+SET ANSI_NULLS ON
+GO
+SET QUOTED_IDENTIFIER ON
+GO
+
+-- Create the Department table.
+IF NOT EXISTS (SELECT * FROM sys.objects
+WHERE object_id = OBJECT_ID(N'[dbo].[Department]')
+AND type in (N'U'))
+BEGIN
+CREATE TABLE [dbo].[Department]([DepartmentID] [int] NOT NULL,
+[Name] [nvarchar](50) NOT NULL,
+[Budget] [money] NOT NULL,
+[StartDate] [datetime] NOT NULL,
+[Administrator] [int] NULL,
+CONSTRAINT [PK_Department] PRIMARY KEY CLUSTERED
+(
+[DepartmentID] ASC
+)WITH (IGNORE_DUP_KEY = OFF) ON [PRIMARY]) ON [PRIMARY]
+END
+GO
+
+-- Create the Person table.
+IF NOT EXISTS (SELECT * FROM sys.objects
+WHERE object_id = OBJECT_ID(N'[dbo].[Person]')
+AND type in (N'U'))
+BEGIN
+CREATE TABLE [dbo].[Person]([PersonID] [int] IDENTITY(1,1) NOT NULL,
+[LastName] [nvarchar](50) NOT NULL,
+[FirstName] [nvarchar](50) NOT NULL,
+[HireDate] [datetime] NULL,
+[EnrollmentDate] [datetime] NULL,
+[Discriminator] [nvarchar](50) NOT NULL,
+CONSTRAINT [PK_School.Student] PRIMARY KEY CLUSTERED
+(
+[PersonID] ASC
+)WITH (IGNORE_DUP_KEY = OFF) ON [PRIMARY]) ON [PRIMARY]
+END
+GO
+
+-- Create the OnsiteCourse table.
+IF NOT EXISTS (SELECT * FROM sys.objects
+WHERE object_id = OBJECT_ID(N'[dbo].[OnsiteCourse]')
+AND type in (N'U'))
+BEGIN
+CREATE TABLE [dbo].[OnsiteCourse]([CourseID] [int] NOT NULL,
+[Location] [nvarchar](50) NOT NULL,
+[Days] [nvarchar](50) NOT NULL,
+[Time] [smalldatetime] NOT NULL,
+CONSTRAINT [PK_OnsiteCourse] PRIMARY KEY CLUSTERED
+(
+[CourseID] ASC
+)WITH (IGNORE_DUP_KEY = OFF) ON [PRIMARY]) ON [PRIMARY]
+END
+GO
+
+-- Create the OnlineCourse table.
+IF NOT EXISTS (SELECT * FROM sys.objects
+WHERE object_id = OBJECT_ID(N'[dbo].[OnlineCourse]')
+AND type in (N'U'))
+BEGIN
+CREATE TABLE [dbo].[OnlineCourse]([CourseID] [int] NOT NULL,
+[URL] [nvarchar](100) NOT NULL,
+CONSTRAINT [PK_OnlineCourse] PRIMARY KEY CLUSTERED
+(
+[CourseID] ASC
+)WITH (IGNORE_DUP_KEY = OFF) ON [PRIMARY]) ON [PRIMARY]
+END
+GO
+
+--Create the StudentGrade table.
+IF NOT EXISTS (SELECT * FROM sys.objects
+WHERE object_id = OBJECT_ID(N'[dbo].[StudentGrade]')
+AND type in (N'U'))
+BEGIN
+CREATE TABLE [dbo].[StudentGrade]([EnrollmentID] [int] IDENTITY(1,1) NOT NULL,
+[CourseID] [int] NOT NULL,
+[StudentID] [int] NOT NULL,
+[Grade] [decimal](3, 2) NULL,
+CONSTRAINT [PK_StudentGrade] PRIMARY KEY CLUSTERED
+(
+[EnrollmentID] ASC
+)WITH (IGNORE_DUP_KEY = OFF) ON [PRIMARY]) ON [PRIMARY]
+END
+GO
+
+-- Create the CourseInstructor table.
+IF NOT EXISTS (SELECT * FROM sys.objects
+WHERE object_id = OBJECT_ID(N'[dbo].[CourseInstructor]')
+AND type in (N'U'))
+BEGIN
+CREATE TABLE [dbo].[CourseInstructor]([CourseID] [int] NOT NULL,
+[PersonID] [int] NOT NULL,
+CONSTRAINT [PK_CourseInstructor] PRIMARY KEY CLUSTERED
+(
+[CourseID] ASC,
+[PersonID] ASC
+)WITH (IGNORE_DUP_KEY = OFF) ON [PRIMARY]) ON [PRIMARY]
+END
+GO
+
+-- Create the Course table.
+IF NOT EXISTS (SELECT * FROM sys.objects
+WHERE object_id = OBJECT_ID(N'[dbo].[Course]')
+AND type in (N'U'))
+BEGIN
+CREATE TABLE [dbo].[Course]([CourseID] [int] NOT NULL,
+[Title] [nvarchar](100) NOT NULL,
+[Credits] [int] NOT NULL,
+[DepartmentID] [int] NOT NULL,
+CONSTRAINT [PK_School.Course] PRIMARY KEY CLUSTERED
+(
+[CourseID] ASC
+)WITH (IGNORE_DUP_KEY = OFF) ON [PRIMARY]) ON [PRIMARY]
+END
+GO
+
+-- Create the OfficeAssignment table.
+IF NOT EXISTS (SELECT * FROM sys.objects
+WHERE object_id = OBJECT_ID(N'[dbo].[OfficeAssignment]')
+AND type in (N'U'))
+BEGIN
+CREATE TABLE [dbo].[OfficeAssignment]([InstructorID] [int] NOT NULL,
+[Location] [nvarchar](50) NOT NULL,
+[Timestamp] [timestamp] NOT NULL,
+CONSTRAINT [PK_OfficeAssignment] PRIMARY KEY CLUSTERED
+(
+[InstructorID] ASC
+)WITH (IGNORE_DUP_KEY = OFF) ON [PRIMARY]) ON [PRIMARY]
+END
+GO
+
+-- Define the relationship between OnsiteCourse and Course.
+IF NOT EXISTS (SELECT * FROM sys.foreign_keys
+WHERE object_id = OBJECT_ID(N'[dbo].[FK_OnsiteCourse_Course]')
+AND parent_object_id = OBJECT_ID(N'[dbo].[OnsiteCourse]'))
+ALTER TABLE [dbo].[OnsiteCourse] WITH CHECK ADD
+CONSTRAINT [FK_OnsiteCourse_Course] FOREIGN KEY([CourseID])
+REFERENCES [dbo].[Course] ([CourseID])
+GO
+ALTER TABLE [dbo].[OnsiteCourse] CHECK
+CONSTRAINT [FK_OnsiteCourse_Course]
+GO
+
+-- Define the relationship between OnlineCourse and Course.
+IF NOT EXISTS (SELECT * FROM sys.foreign_keys
+WHERE object_id = OBJECT_ID(N'[dbo].[FK_OnlineCourse_Course]')
+AND parent_object_id = OBJECT_ID(N'[dbo].[OnlineCourse]'))
+ALTER TABLE [dbo].[OnlineCourse] WITH CHECK ADD
+CONSTRAINT [FK_OnlineCourse_Course] FOREIGN KEY([CourseID])
+REFERENCES [dbo].[Course] ([CourseID])
+GO
+ALTER TABLE [dbo].[OnlineCourse] CHECK
+CONSTRAINT [FK_OnlineCourse_Course]
+GO
+
+-- Define the relationship between StudentGrade and Course.
+IF NOT EXISTS (SELECT * FROM sys.foreign_keys
+WHERE object_id = OBJECT_ID(N'[dbo].[FK_StudentGrade_Course]')
+AND parent_object_id = OBJECT_ID(N'[dbo].[StudentGrade]'))
+ALTER TABLE [dbo].[StudentGrade] WITH CHECK ADD
+CONSTRAINT [FK_StudentGrade_Course] FOREIGN KEY([CourseID])
+REFERENCES [dbo].[Course] ([CourseID])
+GO
+ALTER TABLE [dbo].[StudentGrade] CHECK
+CONSTRAINT [FK_StudentGrade_Course]
+GO
+
+--Define the relationship between StudentGrade and Student.
+IF NOT EXISTS (SELECT * FROM sys.foreign_keys
+WHERE object_id = OBJECT_ID(N'[dbo].[FK_StudentGrade_Student]')
+AND parent_object_id = OBJECT_ID(N'[dbo].[StudentGrade]'))
+ALTER TABLE [dbo].[StudentGrade] WITH CHECK ADD
+CONSTRAINT [FK_StudentGrade_Student] FOREIGN KEY([StudentID])
+REFERENCES [dbo].[Person] ([PersonID])
+GO
+ALTER TABLE [dbo].[StudentGrade] CHECK
+CONSTRAINT [FK_StudentGrade_Student]
+GO
+
+-- Define the relationship between CourseInstructor and Course.
+IF NOT EXISTS (SELECT * FROM sys.foreign_keys
+WHERE object_id = OBJECT_ID(N'[dbo].[FK_CourseInstructor_Course]')
+AND parent_object_id = OBJECT_ID(N'[dbo].[CourseInstructor]'))
+ALTER TABLE [dbo].[CourseInstructor] WITH CHECK ADD
+CONSTRAINT [FK_CourseInstructor_Course] FOREIGN KEY([CourseID])
+REFERENCES [dbo].[Course] ([CourseID])
+GO
+ALTER TABLE [dbo].[CourseInstructor] CHECK
+CONSTRAINT [FK_CourseInstructor_Course]
+GO
+
+-- Define the relationship between CourseInstructor and Person.
+IF NOT EXISTS (SELECT * FROM sys.foreign_keys
+WHERE object_id = OBJECT_ID(N'[dbo].[FK_CourseInstructor_Person]')
+AND parent_object_id = OBJECT_ID(N'[dbo].[CourseInstructor]'))
+ALTER TABLE [dbo].[CourseInstructor] WITH CHECK ADD
+CONSTRAINT [FK_CourseInstructor_Person] FOREIGN KEY([PersonID])
+REFERENCES [dbo].[Person] ([PersonID])
+GO
+ALTER TABLE [dbo].[CourseInstructor] CHECK
+CONSTRAINT [FK_CourseInstructor_Person]
+GO
+
+-- Define the relationship between Course and Department.
+IF NOT EXISTS (SELECT * FROM sys.foreign_keys
+WHERE object_id = OBJECT_ID(N'[dbo].[FK_Course_Department]')
+AND parent_object_id = OBJECT_ID(N'[dbo].[Course]'))
+ALTER TABLE [dbo].[Course] WITH CHECK ADD
+CONSTRAINT [FK_Course_Department] FOREIGN KEY([DepartmentID])
+REFERENCES [dbo].[Department] ([DepartmentID])
+GO
+ALTER TABLE [dbo].[Course] CHECK CONSTRAINT [FK_Course_Department]
+GO
+
+--Define the relationship between OfficeAssignment and Person.
+IF NOT EXISTS (SELECT * FROM sys.foreign_keys
+WHERE object_id = OBJECT_ID(N'[dbo].[FK_OfficeAssignment_Person]')
+AND parent_object_id = OBJECT_ID(N'[dbo].[OfficeAssignment]'))
+ALTER TABLE [dbo].[OfficeAssignment] WITH CHECK ADD
+CONSTRAINT [FK_OfficeAssignment_Person] FOREIGN KEY([InstructorID])
+REFERENCES [dbo].[Person] ([PersonID])
+GO
+ALTER TABLE [dbo].[OfficeAssignment] CHECK
+CONSTRAINT [FK_OfficeAssignment_Person]
+GO
+
+-- Create InsertOfficeAssignment stored procedure.
+IF NOT EXISTS (SELECT * FROM sys.objects
+WHERE object_id = OBJECT_ID(N'[dbo].[InsertOfficeAssignment]')
+AND type in (N'P', N'PC'))
+BEGIN
+EXEC dbo.sp_executesql @statement = N'
+CREATE PROCEDURE [dbo].[InsertOfficeAssignment]
+@InstructorID int,
+@Location nvarchar(50)
+AS
+INSERT INTO dbo.OfficeAssignment (InstructorID, Location)
+VALUES (@InstructorID, @Location);
+IF @@ROWCOUNT > 0
+BEGIN
+SELECT [Timestamp] FROM OfficeAssignment
+WHERE InstructorID=@InstructorID;
+END
+'
+END
+GO
+
+--Create the UpdateOfficeAssignment stored procedure.
+IF NOT EXISTS (SELECT * FROM sys.objects
+WHERE object_id = OBJECT_ID(N'[dbo].[UpdateOfficeAssignment]')
+AND type in (N'P', N'PC'))
+BEGIN
+EXEC dbo.sp_executesql @statement = N'
+CREATE PROCEDURE [dbo].[UpdateOfficeAssignment]
+@InstructorID int,
+@Location nvarchar(50),
+@OrigTimestamp timestamp
+AS
+UPDATE OfficeAssignment SET Location=@Location
+WHERE InstructorID=@InstructorID AND [Timestamp]=@OrigTimestamp;
+IF @@ROWCOUNT > 0
+BEGIN
+SELECT [Timestamp] FROM OfficeAssignment
+WHERE InstructorID=@InstructorID;
+END
+'
+END
+GO
+
+-- Create the DeleteOfficeAssignment stored procedure.
+IF NOT EXISTS (SELECT * FROM sys.objects
+WHERE object_id = OBJECT_ID(N'[dbo].[DeleteOfficeAssignment]')
+AND type in (N'P', N'PC'))
+BEGIN
+EXEC dbo.sp_executesql @statement = N'
+CREATE PROCEDURE [dbo].[DeleteOfficeAssignment]
+@InstructorID int
+AS
+DELETE FROM OfficeAssignment
+WHERE InstructorID=@InstructorID;
+'
+END
+GO
+
+-- Create the DeletePerson stored procedure.
+IF NOT EXISTS (SELECT * FROM sys.objects
+WHERE object_id = OBJECT_ID(N'[dbo].[DeletePerson]')
+AND type in (N'P', N'PC'))
+BEGIN
+EXEC dbo.sp_executesql @statement = N'
+CREATE PROCEDURE [dbo].[DeletePerson]
+@PersonID int
+AS
+DELETE FROM Person WHERE PersonID = @PersonID;
+'
+END
+GO
+
+-- Create the UpdatePerson stored procedure.
+IF NOT EXISTS (SELECT * FROM sys.objects
+WHERE object_id = OBJECT_ID(N'[dbo].[UpdatePerson]')
+AND type in (N'P', N'PC'))
+BEGIN
+EXEC dbo.sp_executesql @statement = N'
+CREATE PROCEDURE [dbo].[UpdatePerson]
+@PersonID int,
+@LastName nvarchar(50),
+@FirstName nvarchar(50),
+@HireDate datetime,
+@EnrollmentDate datetime,
+@Discriminator nvarchar(50)
+AS
+UPDATE Person SET LastName=@LastName,
+FirstName=@FirstName,
+HireDate=@HireDate,
+EnrollmentDate=@EnrollmentDate,
+Discriminator=@Discriminator
+WHERE PersonID=@PersonID;
+'
+END
+GO
+
+-- Create the InsertPerson stored procedure.
+IF NOT EXISTS (SELECT * FROM sys.objects
+WHERE object_id = OBJECT_ID(N'[dbo].[InsertPerson]')
+AND type in (N'P', N'PC'))
+BEGIN
+EXEC dbo.sp_executesql @statement = N'
+CREATE PROCEDURE [dbo].[InsertPerson]
+@LastName nvarchar(50),
+@FirstName nvarchar(50),
+@HireDate datetime,
+@EnrollmentDate datetime,
+@Discriminator nvarchar(50)
+AS
+INSERT INTO dbo.Person (LastName,
+FirstName,
+HireDate,
+EnrollmentDate,
+Discriminator)
+VALUES (@LastName,
+@FirstName,
+@HireDate,
+@EnrollmentDate,
+@Discriminator);
+SELECT SCOPE_IDENTITY() as NewPersonID;
+'
+END
+GO
+
+-- Create GetStudentGrades stored procedure.
+IF NOT EXISTS (SELECT * FROM sys.objects
+WHERE object_id = OBJECT_ID(N'[dbo].[GetStudentGrades]')
+AND type in (N'P', N'PC'))
+BEGIN
+EXEC dbo.sp_executesql @statement = N'
+CREATE PROCEDURE [dbo].[GetStudentGrades]
+@StudentID int
+AS
+SELECT EnrollmentID, Grade, CourseID, StudentID FROM dbo.StudentGrade
+WHERE StudentID = @StudentID
+'
+END
+GO
+
+-- Create GetDepartmentName stored procedure.
+IF NOT EXISTS (SELECT * FROM sys.objects
+WHERE object_id = OBJECT_ID(N'[dbo].[GetDepartmentName]')
+AND type in (N'P', N'PC'))
+BEGIN
+EXEC dbo.sp_executesql @statement = N'
+CREATE PROCEDURE [dbo].[GetDepartmentName]
+@ID int,
+@Name nvarchar(50) OUTPUT
+AS
+SELECT @Name = Name FROM Department
+WHERE DepartmentID = @ID
+'
+END
+GO
+
+-- Insert data into the Person table.
+USE School
+GO
+SET IDENTITY_INSERT dbo.Person ON
+GO
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (1, 'Abercrombie', 'Kim', '1995-03-11', null, 'Instructor');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (2, 'Barzdukas', 'Gytis', null, '2005-09-01', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (3, 'Justice', 'Peggy', null, '2001-09-01', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (4, 'Fakhouri', 'Fadi', '2002-08-06', null, 'Instructor');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (5, 'Harui', 'Roger', '1998-07-01', null, 'Instructor');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (6, 'Li', 'Yan', null, '2002-09-01', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (7, 'Norman', 'Laura', null, '2003-09-01', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (8, 'Olivotto', 'Nino', null, '2005-09-01', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (9, 'Tang', 'Wayne', null, '2005-09-01', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (10, 'Alonso', 'Meredith', null, '2002-09-01', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (11, 'Lopez', 'Sophia', null, '2004-09-01', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (12, 'Browning', 'Meredith', null, '2000-09-01', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (13, 'Anand', 'Arturo', null, '2003-09-01', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (14, 'Walker', 'Alexandra', null, '2000-09-01', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (15, 'Powell', 'Carson', null, '2004-09-01', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (16, 'Jai', 'Damien', null, '2001-09-01', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (17, 'Carlson', 'Robyn', null, '2005-09-01', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (18, 'Zheng', 'Roger', '2004-02-12', null, 'Instructor');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (19, 'Bryant', 'Carson', null, '2001-09-01', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (20, 'Suarez', 'Robyn', null, '2004-09-01', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (21, 'Holt', 'Roger', null, '2004-09-01', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (22, 'Alexander', 'Carson', null, '2005-09-01', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (23, 'Morgan', 'Isaiah', null, '2001-09-01', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (24, 'Martin', 'Randall', null, '2005-09-01', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (25, 'Kapoor', 'Candace', '2001-01-15', null, 'Instructor');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (26, 'Rogers', 'Cody', null, '2002-09-01', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (27, 'Serrano', 'Stacy', '1999-06-01', null, 'Instructor');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (28, 'White', 'Anthony', null, '2001-09-01', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (29, 'Griffin', 'Rachel', null, '2004-09-01', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (30, 'Shan', 'Alicia', null, '2003-09-01', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (31, 'Stewart', 'Jasmine', '1997-10-12', null, 'Instructor');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (32, 'Xu', 'Kristen', '2001-7-23', null, 'Instructor');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (33, 'Gao', 'Erica', null, '2003-01-30', 'Student');
+INSERT INTO dbo.Person (PersonID, LastName, FirstName, HireDate, EnrollmentDate, Discriminator)
+VALUES (34, 'Van Houten', 'Roger', '2000-12-07', null, 'Instructor');
+GO
+SET IDENTITY_INSERT dbo.Person OFF
+GO
+
+-- Insert data into the Department table.
+INSERT INTO dbo.Department (DepartmentID, [Name], Budget, StartDate, Administrator)
+VALUES (1, 'Engineering', 350000.00, '2007-09-01', 2);
+INSERT INTO dbo.Department (DepartmentID, [Name], Budget, StartDate, Administrator)
+VALUES (2, 'English', 120000.00, '2007-09-01', 6);
+INSERT INTO dbo.Department (DepartmentID, [Name], Budget, StartDate, Administrator)
+VALUES (4, 'Economics', 200000.00, '2007-09-01', 4);
+INSERT INTO dbo.Department (DepartmentID, [Name], Budget, StartDate, Administrator)
+VALUES (7, 'Mathematics', 250000.00, '2007-09-01', 3);
+GO
+
+
+
+-- Insert data into the Course table.
+INSERT INTO dbo.Course (CourseID, Title, Credits, DepartmentID)
+VALUES (1050, 'Chemistry', 4, 1);
+INSERT INTO dbo.Course (CourseID, Title, Credits, DepartmentID)
+VALUES (1061, 'Physics', 4, 1);
+INSERT INTO dbo.Course (CourseID, Title, Credits, DepartmentID)
+VALUES (1045, 'Calculus', 4, 7);
+INSERT INTO dbo.Course (CourseID, Title, Credits, DepartmentID)
+VALUES (2030, 'Poetry', 2, 2);
+INSERT INTO dbo.Course (CourseID, Title, Credits, DepartmentID)
+VALUES (2021, 'Composition', 3, 2);
+INSERT INTO dbo.Course (CourseID, Title, Credits, DepartmentID)
+VALUES (2042, 'Literature', 4, 2);
+INSERT INTO dbo.Course (CourseID, Title, Credits, DepartmentID)
+VALUES (4022, 'Microeconomics', 3, 4);
+INSERT INTO dbo.Course (CourseID, Title, Credits, DepartmentID)
+VALUES (4041, 'Macroeconomics', 3, 4);
+INSERT INTO dbo.Course (CourseID, Title, Credits, DepartmentID)
+VALUES (4061, 'Quantitative', 2, 4);
+INSERT INTO dbo.Course (CourseID, Title, Credits, DepartmentID)
+VALUES (3141, 'Trigonometry', 4, 7);
+GO
+
+-- Insert data into the OnlineCourse table.
+INSERT INTO dbo.OnlineCourse (CourseID, URL)
+VALUES (2030, 'http://www.fineartschool.net/Poetry');
+INSERT INTO dbo.OnlineCourse (CourseID, URL)
+VALUES (2021, 'http://www.fineartschool.net/Composition');
+INSERT INTO dbo.OnlineCourse (CourseID, URL)
+VALUES (4041, 'http://www.fineartschool.net/Macroeconomics');
+INSERT INTO dbo.OnlineCourse (CourseID, URL)
+VALUES (3141, 'http://www.fineartschool.net/Trigonometry');
+
+--Insert data into OnsiteCourse table.
+INSERT INTO dbo.OnsiteCourse (CourseID, Location, Days, [Time])
+VALUES (1050, '123 Smith', 'MTWH', '11:30');
+INSERT INTO dbo.OnsiteCourse (CourseID, Location, Days, [Time])
+VALUES (1061, '234 Smith', 'TWHF', '13:15');
+INSERT INTO dbo.OnsiteCourse (CourseID, Location, Days, [Time])
+VALUES (1045, '121 Smith','MWHF', '15:30');
+INSERT INTO dbo.OnsiteCourse (CourseID, Location, Days, [Time])
+VALUES (4061, '22 Williams', 'TH', '11:15');
+INSERT INTO dbo.OnsiteCourse (CourseID, Location, Days, [Time])
+VALUES (2042, '225 Adams', 'MTWH', '11:00');
+INSERT INTO dbo.OnsiteCourse (CourseID, Location, Days, [Time])
+VALUES (4022, '23 Williams', 'MWF', '9:00');
+
+-- Insert data into the CourseInstructor table.
+INSERT INTO dbo.CourseInstructor(CourseID, PersonID)
+VALUES (1050, 1);
+INSERT INTO dbo.CourseInstructor(CourseID, PersonID)
+VALUES (1061, 31);
+INSERT INTO dbo.CourseInstructor(CourseID, PersonID)
+VALUES (1045, 5);
+INSERT INTO dbo.CourseInstructor(CourseID, PersonID)
+VALUES (2030, 4);
+INSERT INTO dbo.CourseInstructor(CourseID, PersonID)
+VALUES (2021, 27);
+INSERT INTO dbo.CourseInstructor(CourseID, PersonID)
+VALUES (2042, 25);
+INSERT INTO dbo.CourseInstructor(CourseID, PersonID)
+VALUES (4022, 18);
+INSERT INTO dbo.CourseInstructor(CourseID, PersonID)
+VALUES (4041, 32);
+INSERT INTO dbo.CourseInstructor(CourseID, PersonID)
+VALUES (4061, 34);
+GO
+
+--Insert data into the OfficeAssignment table.
+INSERT INTO dbo.OfficeAssignment(InstructorID, Location)
+VALUES (1, '17 Smith');
+INSERT INTO dbo.OfficeAssignment(InstructorID, Location)
+VALUES (4, '29 Adams');
+INSERT INTO dbo.OfficeAssignment(InstructorID, Location)
+VALUES (5, '37 Williams');
+INSERT INTO dbo.OfficeAssignment(InstructorID, Location)
+VALUES (18, '143 Smith');
+INSERT INTO dbo.OfficeAssignment(InstructorID, Location)
+VALUES (25, '57 Adams');
+INSERT INTO dbo.OfficeAssignment(InstructorID, Location)
+VALUES (27, '271 Williams');
+INSERT INTO dbo.OfficeAssignment(InstructorID, Location)
+VALUES (31, '131 Smith');
+INSERT INTO dbo.OfficeAssignment(InstructorID, Location)
+VALUES (32, '203 Williams');
+INSERT INTO dbo.OfficeAssignment(InstructorID, Location)
+VALUES (34, '213 Smith');
+
+-- Insert data into the StudentGrade table.
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (2021, 2, 4);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (2030, 2, 3.5);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (2021, 3, 3);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (2030, 3, 4);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (2021, 6, 2.5);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (2042, 6, 3.5);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (2021, 7, 3.5);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (2042, 7, 4);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (2021, 8, 3);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (2042, 8, 3);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (4041, 9, 3.5);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (4041, 10, null);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (4041, 11, 2.5);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (4041, 12, null);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (4061, 12, null);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (4022, 14, 3);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (4022, 13, 4);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (4061, 13, 4);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (4041, 14, 3);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (4022, 15, 2.5);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (4022, 16, 2);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (4022, 17, null);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (4022, 19, 3.5);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (4061, 20, 4);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (4061, 21, 2);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (4022, 22, 3);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (4041, 22, 3.5);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (4061, 22, 2.5);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (4022, 23, 3);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (1045, 23, 1.5);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (1061, 24, 4);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (1061, 25, 3);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (1050, 26, 3.5);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (1061, 26, 3);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (1061, 27, 3);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (1045, 28, 2.5);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (1050, 28, 3.5);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (1061, 29, 4);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (1050, 30, 3.5);
+INSERT INTO dbo.StudentGrade (CourseID, StudentID, Grade)
+VALUES (1061, 30, 4);
+GO
+```  
diff --git a/entity-framework/ef6/resources/tools.md b/entity-framework/ef6/resources/tools.md
new file mode 100644
index 0000000000..dc75375ee3
--- /dev/null
+++ b/entity-framework/ef6/resources/tools.md
@@ -0,0 +1,19 @@
+---
+title: Tools & Extensions - EF6
+description: Tools & Extensions  in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Entity Framework Tools & Extensions
+
+> [!IMPORTANT]  
+> Extensions are built by a variety of sources and not maintained as part of Entity Framework. When considering a third party extension, be sure to evaluate quality, licensing, compatibility, support, etc. to ensure they meet your requirements.
+
+Entity Framework has been a popular O/RM for many years. Here are some examples of free and paid tools and extensions developed for it:
+
+- [EF Power Tools Community Edition](https://marketplace.visualstudio.com/items?itemName=ErikEJ.EntityFramework6PowerToolsCommunityEdition)
+- [EF Profiler](https://hibernatingrhinos.com/products/efprof)  
+- [LINQPad](https://www.linqpad.net)  
+- [LLBLGen Pro](https://www.llblgen.com)  
+- [Huagati DBML/EDMX Tools](https://www.huagati.com/dbmltools)  
+- [Entity Developer](https://www.devart.com/entitydeveloper)  
diff --git a/entity-framework/ef6/saving/change-tracking/auto-detect-changes.md b/entity-framework/ef6/saving/change-tracking/auto-detect-changes.md
new file mode 100644
index 0000000000..a439c49b9a
--- /dev/null
+++ b/entity-framework/ef6/saving/change-tracking/auto-detect-changes.md
@@ -0,0 +1,53 @@
+---
+title: Automatic detect changes - EF6
+description: Automatic detect changes in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/saving/change-tracking/auto-detect-changes
+---
+# Automatic detect changes
+When using most POCO entities the determination of how an entity has changed (and therefore which updates need to be sent to the database) is handled by the Detect Changes algorithm. Detect Changes works by detecting the differences between the current property values of the entity and the original property values that are stored in a snapshot when the entity was queried or attached. The techniques shown in this topic apply equally to models created with Code First and the EF Designer.  
+
+By default, Entity Framework performs Detect Changes automatically when the following methods are called:  
+
+- DbSet.Find  
+- DbSet.Local  
+- DbSet.Add  
+- DbSet.AddRange
+- DbSet.Remove  
+- DbSet.RemoveRange
+- DbSet.Attach  
+- DbContext.SaveChanges  
+- DbContext.GetValidationErrors  
+- DbContext.Entry  
+- DbChangeTracker.Entries  
+
+## Disabling automatic detection of changes  
+
+If you are tracking a lot of entities in your context and you call one of these methods many times in a loop, then you may get significant performance improvements by turning off detection of changes for the duration of the loop. For example:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    try
+    {
+        context.Configuration.AutoDetectChangesEnabled = false;
+
+        // Make many calls in a loop
+        foreach (var blog in aLotOfBlogs)
+        {
+            context.Blogs.Add(blog);
+        }
+    }
+    finally
+    {
+        context.Configuration.AutoDetectChangesEnabled = true;
+    }
+}
+```  
+
+Don’t forget to re-enable detection of changes after the loop — We've used a try/finally to ensure it is always re-enabled even if code in the loop throws an exception.  
+
+An alternative to disabling and re-enabling is to leave automatic detection of changes turned off at all times and either call context.ChangeTracker.DetectChanges explicitly or use change tracking proxies diligently. Both of these options are advanced and can easily introduce subtle bugs into your application so use them with care.  
+
+If you need to add or remove many objects from a context, consider using DbSet.AddRange and DbSet.RemoveRange. This methods automatically detect changes only once after the add or remove operations are completed. 
diff --git a/entity-framework/ef6/saving/change-tracking/entity-state.md b/entity-framework/ef6/saving/change-tracking/entity-state.md
new file mode 100644
index 0000000000..aed7343dd1
--- /dev/null
+++ b/entity-framework/ef6/saving/change-tracking/entity-state.md
@@ -0,0 +1,176 @@
+---
+title: Working with entity states - EF6
+description: Working with entity states in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/saving/change-tracking/entity-state
+---
+# Working with entity states
+This topic will cover how to add and attach entities to a context and how Entity Framework processes these during SaveChanges.
+Entity Framework takes care of tracking the state of entities while they are connected to a context, but in disconnected or N-Tier scenarios you can let EF know what state your entities should be in.
+The techniques shown in this topic apply equally to models created with Code First and the EF Designer.  
+
+## Entity states and SaveChanges
+
+An entity can be in one of five states as defined by the EntityState enumeration. These states are:  
+
+- Added: the entity is being tracked by the context but does not yet exist in the database  
+- Unchanged: the entity is being tracked by the context and exists in the database, and its property values have not changed from the values in the database  
+- Modified: the entity is being tracked by the context and exists in the database, and some or all of its property values have been modified  
+- Deleted: the entity is being tracked by the context and exists in the database, but has been marked for deletion from the database the next time SaveChanges is called  
+- Detached: the entity is not being tracked by the context  
+
+SaveChanges does different things for entities in different states:  
+
+- Unchanged entities are not touched by SaveChanges. Updates are not sent to the database for entities in the Unchanged state.  
+- Added entities are inserted into the database and then become Unchanged when SaveChanges returns.  
+- Modified entities are updated in the database and then become Unchanged when SaveChanges returns.  
+- Deleted entities are deleted from the database and are then detached from the context.  
+
+The following examples show ways in which the state of an entity or an entity graph can be changed.  
+
+## Adding a new entity to the context  
+
+A new entity can be added to the context by calling the Add method on DbSet.
+This puts the entity into the Added state, meaning that it will be inserted into the database the next time that SaveChanges is called.
+For example:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var blog = new Blog { Name = "ADO.NET Blog" };
+    context.Blogs.Add(blog);
+    context.SaveChanges();
+}
+```  
+
+Another way to add a new entity to the context is to change its state to Added. For example:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var blog = new Blog { Name = "ADO.NET Blog" };
+    context.Entry(blog).State = EntityState.Added;
+    context.SaveChanges();
+}
+```  
+
+Finally, you can add a new entity to the context by hooking it up to another entity that is already being tracked.
+This could be by adding the new entity to the collection navigation property of another entity or by setting a reference navigation property of another entity to point to the new entity. For example:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    // Add a new User by setting a reference from a tracked Blog
+    var blog = context.Blogs.Find(1);
+    blog.Owner = new User { UserName = "johndoe1987" };
+
+    // Add a new Post by adding to the collection of a tracked Blog
+    blog.Posts.Add(new Post { Name = "How to Add Entities" });
+
+    context.SaveChanges();
+}
+```  
+
+Note that for all of these examples if the entity being added has references to other entities that are not yet tracked then these new entities will also be added to the context and will be inserted into the database the next time that SaveChanges is called.  
+
+## Attaching an existing entity to the context  
+
+If you have an entity that you know already exists in the database but which is not currently being tracked by the context then you can tell the context to track the entity using the Attach method on DbSet. The entity will be in the Unchanged state in the context. For example:  
+
+``` csharp
+var existingBlog = new Blog { BlogId = 1, Name = "ADO.NET Blog" };
+
+using (var context = new BloggingContext())
+{
+    context.Blogs.Attach(existingBlog);
+
+    // Do some more work...  
+
+    context.SaveChanges();
+}
+```  
+
+Note that no changes will be made to the database if SaveChanges is called without doing any other manipulation of the attached entity. This is because the entity is in the Unchanged state.  
+
+Another way to attach an existing entity to the context is to change its state to Unchanged. For example:  
+
+``` csharp
+var existingBlog = new Blog { BlogId = 1, Name = "ADO.NET Blog" };
+
+using (var context = new BloggingContext())
+{
+    context.Entry(existingBlog).State = EntityState.Unchanged;
+
+    // Do some more work...  
+
+    context.SaveChanges();
+}
+```  
+
+Note that for both of these examples if the entity being attached has references to other entities that are not yet tracked then these new entities will also attached to the context in the Unchanged state.  
+
+## Attaching an existing but modified entity to the context  
+
+If you have an entity that you know already exists in the database but to which changes may have been made then you can tell the context to attach the entity and set its state to Modified.
+For example:  
+
+``` csharp
+var existingBlog = new Blog { BlogId = 1, Name = "ADO.NET Blog" };
+
+using (var context = new BloggingContext())
+{
+    context.Entry(existingBlog).State = EntityState.Modified;
+
+    // Do some more work...  
+
+    context.SaveChanges();
+}
+```  
+
+When you change the state to Modified all the properties of the entity will be marked as modified and all the property values will be sent to the database when SaveChanges is called.  
+
+Note that if the entity being attached has references to other entities that are not yet tracked, then these new entities will be attached to the context in the Unchanged state—they will not automatically be made Modified.
+If you have multiple entities that need to be marked Modified you should set the state for each of these entities individually.  
+
+## Changing the state of a tracked entity  
+
+You can change the state of an entity that is already being tracked by setting the State property on its entry. For example:  
+
+``` csharp
+var existingBlog = new Blog { BlogId = 1, Name = "ADO.NET Blog" };
+
+using (var context = new BloggingContext())
+{
+    context.Blogs.Attach(existingBlog);
+    context.Entry(existingBlog).State = EntityState.Unchanged;
+
+    // Do some more work...  
+
+    context.SaveChanges();
+}
+```  
+
+Note that calling Add or Attach for an entity that is already tracked can also be used to change the entity state. For example, calling Attach for an entity that is currently in the Added state will change its state to Unchanged.  
+
+## Insert or update pattern  
+
+A common pattern for some applications is to either Add an entity as new (resulting in a database insert) or Attach an entity as existing and mark it as modified (resulting in a database update) depending on the value of the primary key.
+For example, when using database generated integer primary keys it is common to treat an entity with a zero key as new and an entity with a non-zero key as existing.
+This pattern can be achieved by setting the entity state based on a check of the primary key value. For example:  
+
+``` csharp
+public void InsertOrUpdate(Blog blog)
+{
+    using (var context = new BloggingContext())
+    {
+        context.Entry(blog).State = blog.BlogId == 0 ?
+                                   EntityState.Added :
+                                   EntityState.Modified;
+
+        context.SaveChanges();
+    }
+}
+```  
+
+Note that when you change the state to Modified all the properties of the entity will be marked as modified and all the property values will be sent to the database when SaveChanges is called.  
diff --git a/entity-framework/ef6/saving/change-tracking/property-values.md b/entity-framework/ef6/saving/change-tracking/property-values.md
new file mode 100644
index 0000000000..b1ad9c7ff7
--- /dev/null
+++ b/entity-framework/ef6/saving/change-tracking/property-values.md
@@ -0,0 +1,369 @@
+---
+title: Working with property values - EF6
+description: Working with property values in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/saving/change-tracking/property-values
+---
+# Working with property values
+For the most part Entity Framework will take care of tracking the state, original values, and current values of the properties of your entity instances. However, there may be some cases - such as disconnected scenarios - where you want to view or manipulate the information EF has about the properties. The techniques shown in this topic apply equally to models created with Code First and the EF Designer.  
+
+Entity Framework keeps track of two values for each property of a tracked entity. The current value is, as the name indicates, the current value of the property in the entity. The original value is the value that the property had when the entity was queried from the database or attached to the context.  
+
+There are two general mechanisms for working with property values:  
+
+- The value of a single property can be obtained in a strongly typed way using the Property method.  
+- Values for all properties of an entity can be read into a DbPropertyValues object. DbPropertyValues then acts as a dictionary-like object to allow property values to be read and set. The values in a DbPropertyValues object can be set from values in another DbPropertyValues object or from values in some other object, such as another copy of the entity or a simple data transfer object (DTO).  
+
+The sections below show examples of using both of the above mechanisms.  
+
+## Getting and setting the current or original value of an individual property  
+
+The example below shows how the current value of a property can be read and then set to a new value:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var blog = context.Blogs.Find(3);
+
+    // Read the current value of the Name property
+    string currentName1 = context.Entry(blog).Property(u => u.Name).CurrentValue;
+
+    // Set the Name property to a new value
+    context.Entry(blog).Property(u => u.Name).CurrentValue = "My Fancy Blog";
+
+    // Read the current value of the Name property using a string for the property name
+    object currentName2 = context.Entry(blog).Property("Name").CurrentValue;
+
+    // Set the Name property to a new value using a string for the property name
+    context.Entry(blog).Property("Name").CurrentValue = "My Boring Blog";
+}
+```  
+
+Use the OriginalValue property instead of the CurrentValue property to read or set the original value.  
+
+Note that the returned value is typed as “object” when a string is used to specify the property name. On the other hand, the returned value is strongly typed if a lambda expression is used.  
+
+Setting the property value like this will only mark the property as modified if the new value is different from the old value.  
+
+When a property value is set in this way the change is automatically detected even if AutoDetectChanges is turned off.  
+
+## Getting and setting the current value of an unmapped property  
+
+The current value of a property that is not mapped to the database can also be read. An example of an unmapped property could be an RssLink property on Blog. This value may be calculated based on the BlogId, and therefore doesn't need to be stored in the database. For example:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var blog = context.Blogs.Find(1);
+    // Read the current value of an unmapped property
+    var rssLink = context.Entry(blog).Property(p => p.RssLink).CurrentValue;
+
+    // Use a string to specify the property name
+    var rssLinkAgain = context.Entry(blog).Property("RssLink").CurrentValue;
+}
+```  
+
+The current value can also be set if the property exposes a setter.  
+
+Reading the values of unmapped properties is useful when performing Entity Framework validation of unmapped properties. For the same reason current values can be read and set for properties of entities that are not currently being tracked by the context. For example:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    // Create an entity that is not being tracked
+    var blog = new Blog { Name = "ADO.NET Blog" };
+
+    // Read and set the current value of Name as before
+    var currentName1 = context.Entry(blog).Property(u => u.Name).CurrentValue;
+    context.Entry(blog).Property(u => u.Name).CurrentValue = "My Fancy Blog";
+    var currentName2 = context.Entry(blog).Property("Name").CurrentValue;
+    context.Entry(blog).Property("Name").CurrentValue = "My Boring Blog";
+}
+```  
+
+Note that original values are not available for unmapped properties or for properties of entities that are not being tracked by the context.  
+
+## Checking whether a property is marked as modified  
+
+The example below shows how to check whether or not an individual property is marked as modified:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var blog = context.Blogs.Find(1);
+
+    var nameIsModified1 = context.Entry(blog).Property(u => u.Name).IsModified;
+
+    // Use a string for the property name
+    var nameIsModified2 = context.Entry(blog).Property("Name").IsModified;
+}
+```  
+
+The values of modified properties are sent as updates to the database when SaveChanges is called.  
+
+##  Marking a property as modified  
+
+The example below shows how to force an individual property to be marked as modified:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var blog = context.Blogs.Find(1);
+
+    context.Entry(blog).Property(u => u.Name).IsModified = true;
+
+    // Use a string for the property name
+    context.Entry(blog).Property("Name").IsModified = true;
+}
+```  
+
+Marking a property as modified forces an update to be send to the database for the property when SaveChanges is called even if the current value of the property is the same as its original value.  
+
+It is not currently possible to reset an individual property to be not modified after it has been marked as modified. This is something we plan to support in a future release.  
+
+## Reading current, original, and database values for all properties of an entity  
+
+The example below shows how to read the current values, the original values, and the values actually in the database for all mapped properties of an entity.  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var blog = context.Blogs.Find(1);
+
+    // Make a modification to Name in the tracked entity
+    blog.Name = "My Cool Blog";
+
+    // Make a modification to Name in the database
+    context.Database.SqlCommand("update dbo.Blogs set Name = 'My Boring Blog' where Id = 1");
+
+    // Print out current, original, and database values
+    Console.WriteLine("Current values:");
+    PrintValues(context.Entry(blog).CurrentValues);
+
+    Console.WriteLine("\nOriginal values:");
+    PrintValues(context.Entry(blog).OriginalValues);
+
+    Console.WriteLine("\nDatabase values:");
+    PrintValues(context.Entry(blog).GetDatabaseValues());
+}
+
+public static void PrintValues(DbPropertyValues values)
+{
+    foreach (var propertyName in values.PropertyNames)
+    {
+        Console.WriteLine("Property {0} has value {1}",
+                          propertyName, values[propertyName]);
+    }
+}
+```  
+
+The current values are the values that the properties of the entity currently contain. The original values are the values that were read from the database when the entity was queried. The database values are the values as they are currently stored in the database. Getting the database values is useful when the values in the database may have changed since the entity was queried such as when a concurrent edit to the database has been made by another user.  
+
+## Setting current or original values from another object  
+
+The current or original values of a tracked entity can be updated by copying values from another object. For example:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var blog = context.Blogs.Find(1);
+    var coolBlog = new Blog { Id = 1, Name = "My Cool Blog" };
+    var boringBlog = new BlogDto { Id = 1, Name = "My Boring Blog" };
+
+    // Change the current and original values by copying the values from other objects
+    var entry = context.Entry(blog);
+    entry.CurrentValues.SetValues(coolBlog);
+    entry.OriginalValues.SetValues(boringBlog);
+
+    // Print out current and original values
+    Console.WriteLine("Current values:");
+    PrintValues(entry.CurrentValues);
+
+    Console.WriteLine("\nOriginal values:");
+    PrintValues(entry.OriginalValues);
+}
+
+public class BlogDto
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+}
+```  
+
+Running the code above will print out:  
+
+```console
+Current values:
+Property Id has value 1
+Property Name has value My Cool Blog
+
+Original values:
+Property Id has value 1
+Property Name has value My Boring Blog
+```  
+
+This technique is sometimes used when updating an entity with values obtained from a service call or a client in an n-tier application. Note that the object used does not have to be of the same type as the entity so long as it has properties whose names match those of the entity. In the example above, an instance of BlogDTO is used to update the original values.  
+
+Note that only properties that are set to different values when copied from the other object will be marked as modified.  
+
+## Setting current or original values from a dictionary  
+
+The current or original values of a tracked entity can be updated by copying values from a dictionary or some other data structure. For example:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var blog = context.Blogs.Find(1);
+
+    var newValues = new Dictionary<string, object>
+    {
+        { "Name", "The New ADO.NET Blog" },
+        { "Url", "blogs.msdn.com/adonet" },
+    };
+
+    var currentValues = context.Entry(blog).CurrentValues;
+
+    foreach (var propertyName in newValues.Keys)
+    {
+        currentValues[propertyName] = newValues[propertyName];
+    }
+
+    PrintValues(currentValues);
+}
+```  
+
+Use the OriginalValues property instead of the CurrentValues property to set original values.  
+
+## Setting current or original values from a dictionary using Property  
+
+An alternative to using CurrentValues or OriginalValues as shown above is to use the Property method to set the value of each property. This can be preferable when you need to set the values of complex properties. For example:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var user = context.Users.Find("johndoe1987");
+
+    var newValues = new Dictionary<string, object>
+    {
+        { "Name", "John Doe" },
+        { "Location.City", "Redmond" },
+        { "Location.State.Name", "Washington" },
+        { "Location.State.Code", "WA" },
+    };
+
+    var entry = context.Entry(user);
+
+    foreach (var propertyName in newValues.Keys)
+    {
+        entry.Property(propertyName).CurrentValue = newValues[propertyName];
+    }
+}
+```  
+
+In the example above complex properties are accessed using dotted names. For other ways to access complex properties see the two sections later in this topic specifically about complex properties.  
+
+## Creating a cloned object containing current, original, or database values  
+
+The DbPropertyValues object returned from CurrentValues, OriginalValues, or GetDatabaseValues can be used to create a clone of the entity. This clone will contain the property values from the DbPropertyValues object used to create it. For example:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var blog = context.Blogs.Find(1);
+
+    var clonedBlog = context.Entry(blog).GetDatabaseValues().ToObject();
+}
+```  
+
+Note that the object returned is not the entity and is not being tracked by the context. The returned object also does not have any relationships set to other objects.  
+
+The cloned object can be useful for resolving issues related to concurrent updates to the database, especially where a UI that involves data binding to objects of a certain type is being used.  
+
+## Getting and setting the current or original values of complex properties  
+
+The value of an entire complex object can be read and set using the Property method just as it can be for a primitive property. In addition you can drill down into the complex object and read or set properties of that object, or even a nested object. Here are some examples:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var user = context.Users.Find("johndoe1987");
+
+    // Get the Location complex object
+    var location = context.Entry(user)
+                       .Property(u => u.Location)
+                       .CurrentValue;
+
+    // Get the nested State complex object using chained calls
+    var state1 = context.Entry(user)
+                     .ComplexProperty(u => u.Location)
+                     .Property(l => l.State)
+                     .CurrentValue;
+
+    // Get the nested State complex object using a single lambda expression
+    var state2 = context.Entry(user)
+                     .Property(u => u.Location.State)
+                     .CurrentValue;
+
+    // Get the nested State complex object using a dotted string
+    var state3 = context.Entry(user)
+                     .Property("Location.State")
+                     .CurrentValue;
+
+    // Get the value of the Name property on the nested State complex object using chained calls
+    var name1 = context.Entry(user)
+                       .ComplexProperty(u => u.Location)
+                       .ComplexProperty(l => l.State)
+                       .Property(s => s.Name)
+                       .CurrentValue;
+
+    // Get the value of the Name property on the nested State complex object using a single lambda expression
+    var name2 = context.Entry(user)
+                       .Property(u => u.Location.State.Name)
+                       .CurrentValue;
+
+    // Get the value of the Name property on the nested State complex object using a dotted string
+    var name3 = context.Entry(user)
+                       .Property("Location.State.Name")
+                       .CurrentValue;
+}
+```  
+
+Use the OriginalValue property instead of the CurrentValue property to get or set an original value.  
+
+Note that either the Property or the ComplexProperty method can be used to access a complex property. However, the ComplexProperty method must be used if you wish to drill down into the complex object with additional Property or ComplexProperty calls.  
+
+## Using DbPropertyValues to access complex properties  
+
+When you use CurrentValues, OriginalValues, or GetDatabaseValues to get all the current, original, or database values for an entity, the values of any complex properties are returned as nested DbPropertyValues objects. These nested objects can then be used to get values of the complex object. For example, the following method will print out the values of all properties, including values of any complex properties and nested complex properties.  
+
+``` csharp
+public static void WritePropertyValues(string parentPropertyName, DbPropertyValues propertyValues)
+{
+    foreach (var propertyName in propertyValues.PropertyNames)
+    {
+        var nestedValues = propertyValues[propertyName] as DbPropertyValues;
+        if (nestedValues != null)
+        {
+            WritePropertyValues(parentPropertyName + propertyName + ".", nestedValues);
+        }
+        else
+        {
+            Console.WriteLine("Property {0}{1} has value {2}",
+                              parentPropertyName, propertyName,
+                              propertyValues[propertyName]);
+        }
+    }
+}
+```  
+
+To print out all current property values the method would be called like this:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var user = context.Users.Find("johndoe1987");
+
+    WritePropertyValues("", context.Entry(user).CurrentValues);
+}
+```  
diff --git a/entity-framework/ef6/saving/concurrency.md b/entity-framework/ef6/saving/concurrency.md
new file mode 100644
index 0000000000..93aa565f51
--- /dev/null
+++ b/entity-framework/ef6/saving/concurrency.md
@@ -0,0 +1,195 @@
+---
+title: Handling Concurrency Conflicts - EF6
+description: Handling Concurrency Conflicts in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/saving/concurrency
+---
+# Handling Concurrency Conflicts (EF6)
+
+Optimistic concurrency involves optimistically attempting to save your entity to the database in the hope that the data there has not changed since the entity was loaded. If it turns out that the data has changed then an exception is thrown and you must resolve the conflict before attempting to save again. This topic covers how to handle such exceptions in Entity Framework. The techniques shown in this topic apply equally to models created with Code First and the EF Designer.  
+
+This post is not the appropriate place for a full discussion of optimistic concurrency. The sections below assume some knowledge of concurrency resolution and show patterns for common tasks.  
+
+Many of these patterns make use of the topics discussed in [Working with Property Values](xref:ef6/saving/change-tracking/property-values).  
+
+Resolving concurrency issues when you are using independent associations (where the foreign key is not mapped to a property in your entity) is much more difficult than when you are using foreign key associations. Therefore if you are going to do concurrency resolution in your application it is advised that you always map foreign keys into your entities. All the examples below assume that you are using foreign key associations.  
+
+A DbUpdateConcurrencyException is thrown by SaveChanges when an optimistic concurrency exception is detected while attempting to save an entity that uses foreign key associations.  
+
+## Resolving optimistic concurrency exceptions with Reload (database wins)  
+
+The Reload method can be used to overwrite the current values of the entity with the values now in the database. The entity is then typically given back to the user in some form and they must try to make their changes again and re-save. For example:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var blog = context.Blogs.Find(1);
+    blog.Name = "The New ADO.NET Blog";
+
+    bool saveFailed;
+    do
+    {
+        saveFailed = false;
+
+        try
+        {
+            context.SaveChanges();
+        }
+        catch (DbUpdateConcurrencyException ex)
+        {
+            saveFailed = true;
+
+            // Update the values of the entity that failed to save from the store
+            ex.Entries.Single().Reload();
+        }
+
+    } while (saveFailed);
+}
+```  
+
+A good way to simulate a concurrency exception is to set a breakpoint on the SaveChanges call and then modify an entity that is being saved in the database using another tool such as SQL Server Management Studio. You could also insert a line before SaveChanges to update the database directly using SqlCommand. For example:  
+
+``` csharp
+context.Database.SqlCommand(
+    "UPDATE dbo.Blogs SET Name = 'Another Name' WHERE BlogId = 1");
+```  
+
+The Entries method on DbUpdateConcurrencyException returns the DbEntityEntry instances for the entities that failed to update. (This property currently always returns a single value for concurrency issues. It may return multiple values for general update exceptions.) An alternative for some situations might be to get entries for all entities that may need to be reloaded from the database and call reload for each of these.  
+
+## Resolving optimistic concurrency exceptions as client wins  
+
+The example above that uses Reload is sometimes called database wins or store wins because the values in the entity are overwritten by values from the database. Sometimes you may wish to do the opposite and overwrite the values in the database with the values currently in the entity. This is sometimes called client wins and can be done by getting the current database values and setting them as the original values for the entity. (See [Working with Property Values](xref:ef6/saving/change-tracking/property-values) for information on current and original values.) For example:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var blog = context.Blogs.Find(1);
+    blog.Name = "The New ADO.NET Blog";
+
+    bool saveFailed;
+    do
+    {
+        saveFailed = false;
+        try
+        {
+            context.SaveChanges();
+        }
+        catch (DbUpdateConcurrencyException ex)
+        {
+            saveFailed = true;
+
+            // Update original values from the database
+            var entry = ex.Entries.Single();
+            entry.OriginalValues.SetValues(entry.GetDatabaseValues());
+        }
+
+    } while (saveFailed);
+}
+```  
+
+## Custom resolution of optimistic concurrency exceptions  
+
+Sometimes you may want to combine the values currently in the database with the values currently in the entity. This usually requires some custom logic or user interaction. For example, you might present a form to the user containing the current values, the values in the database, and a default set of resolved values. The user would then edit the resolved values as necessary and it would be these resolved values that get saved to the database. This can be done using the DbPropertyValues objects returned from CurrentValues and GetDatabaseValues on the entity’s entry. For example:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var blog = context.Blogs.Find(1);
+    blog.Name = "The New ADO.NET Blog";
+
+    bool saveFailed;
+    do
+    {
+        saveFailed = false;
+        try
+        {
+            context.SaveChanges();
+        }
+        catch (DbUpdateConcurrencyException ex)
+        {
+            saveFailed = true;
+
+            // Get the current entity values and the values in the database
+            var entry = ex.Entries.Single();
+            var currentValues = entry.CurrentValues;
+            var databaseValues = entry.GetDatabaseValues();
+
+            // Choose an initial set of resolved values. In this case we
+            // make the default be the values currently in the database.
+            var resolvedValues = databaseValues.Clone();
+
+            // Have the user choose what the resolved values should be
+            HaveUserResolveConcurrency(currentValues, databaseValues, resolvedValues);
+
+            // Update the original values with the database values and
+            // the current values with whatever the user choose.
+            entry.OriginalValues.SetValues(databaseValues);
+            entry.CurrentValues.SetValues(resolvedValues);
+        }
+    } while (saveFailed);
+}
+
+public void HaveUserResolveConcurrency(DbPropertyValues currentValues,
+                                       DbPropertyValues databaseValues,
+                                       DbPropertyValues resolvedValues)
+{
+    // Show the current, database, and resolved values to the user and have
+    // them edit the resolved values to get the correct resolution.
+}
+```  
+
+## Custom resolution of optimistic concurrency exceptions using objects  
+
+The code above uses DbPropertyValues instances for passing around current, database, and resolved values. Sometimes it may be easier to use instances of your entity type for this. This can be done using the ToObject and SetValues methods of DbPropertyValues. For example:  
+
+``` csharp
+using (var context = new BloggingContext())
+{
+    var blog = context.Blogs.Find(1);
+    blog.Name = "The New ADO.NET Blog";
+
+    bool saveFailed;
+    do
+    {
+        saveFailed = false;
+        try
+        {
+            context.SaveChanges();
+        }
+        catch (DbUpdateConcurrencyException ex)
+        {
+            saveFailed = true;
+
+            // Get the current entity values and the values in the database
+            // as instances of the entity type
+            var entry = ex.Entries.Single();
+            var databaseValues = entry.GetDatabaseValues();
+            var databaseValuesAsBlog = (Blog)databaseValues.ToObject();
+
+            // Choose an initial set of resolved values. In this case we
+            // make the default be the values currently in the database.
+            var resolvedValuesAsBlog = (Blog)databaseValues.ToObject();
+
+            // Have the user choose what the resolved values should be
+            HaveUserResolveConcurrency((Blog)entry.Entity,
+                                       databaseValuesAsBlog,
+                                       resolvedValuesAsBlog);
+
+            // Update the original values with the database values and
+            // the current values with whatever the user choose.
+            entry.OriginalValues.SetValues(databaseValues);
+            entry.CurrentValues.SetValues(resolvedValuesAsBlog);
+        }
+
+    } while (saveFailed);
+}
+
+public void HaveUserResolveConcurrency(Blog entity,
+                                       Blog databaseValues,
+                                       Blog resolvedValues)
+{
+    // Show the current, database, and resolved values to the user and have
+    // them update the resolved values to get the correct resolution.
+}
+```  
diff --git a/entity-framework/ef6/saving/index.md b/entity-framework/ef6/saving/index.md
new file mode 100644
index 0000000000..c0224e5a4d
--- /dev/null
+++ b/entity-framework/ef6/saving/index.md
@@ -0,0 +1,10 @@
+---
+title: Saving Data - EF6
+description: Saving Data in Entity Framework 6
+author: SamMonoRT
+ms.date: 07/05/2018
+---
+
+# Saving Data with Entity Framework 6
+
+In this section you can find information about EF's change tracking capabilities and what happens when you call SaveChanges to persist any changes to objects into the database.
diff --git a/entity-framework/ef6/saving/transactions.md b/entity-framework/ef6/saving/transactions.md
new file mode 100644
index 0000000000..b786185b29
--- /dev/null
+++ b/entity-framework/ef6/saving/transactions.md
@@ -0,0 +1,299 @@
+---
+title: Working with Transactions - EF6
+description: Working with Transactions in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/saving/transactions
+---
+# Working with Transactions
+> [!NOTE]
+> **EF6 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 6. If you are using an earlier version, some or all of the information does not apply.  
+
+This document will describe using transactions in EF6 including the enhancements we have added since EF5 to make working with transactions easy.  
+
+## What EF does by default  
+
+In all versions of Entity Framework, whenever you execute **SaveChanges()** to insert, update or delete on the database the framework will wrap that operation in a transaction. This transaction lasts only long enough to execute the operation and then completes. When you execute another such operation a new transaction is started.  
+
+Starting with EF6 **Database.ExecuteSqlCommand()** by default will wrap the command in a transaction if one was not already present. There are overloads of this method that allow you to override this behavior if you wish. Also in EF6 execution of stored procedures included in the model through APIs such as **ObjectContext.ExecuteFunction()** does the same (except that the default behavior cannot at the moment be overridden).  
+
+In either case, the isolation level of the transaction is whatever isolation level the database provider considers its default setting. By default, for instance, on SQL Server this is READ COMMITTED.  
+
+Entity Framework does not wrap queries in a transaction.  
+
+This default functionality is suitable for a lot of users and if so there is no need to do anything different in EF6; just write the code as you always did.  
+
+However some users require greater control over their transactions – this is covered in the following sections.  
+
+## How the APIs work  
+
+Prior to EF6 Entity Framework insisted on opening the database connection itself (it threw an exception if it was passed a connection that was already open). Since a transaction can only be started on an open connection, this meant that the only way a user could wrap several operations into one transaction was either to use a [TransactionScope](https://msdn.microsoft.com/library/system.transactions.transactionscope.aspx) or use the **ObjectContext.Connection** property and start calling **Open()** and **BeginTransaction()** directly on the returned **EntityConnection** object. In addition, API calls which contacted the database would fail if you had started a transaction on the underlying database connection on your own.  
+
+> [!NOTE]
+> The limitation of only accepting closed connections was removed in Entity Framework 6. For details, see [Connection Management](xref:ef6/fundamentals/connection-management).  
+
+Starting with EF6 the framework now provides:  
+
+1. **Database.BeginTransaction()** : An easier method for a user to start and complete transactions themselves within an existing DbContext – allowing several operations to be combined within the same transaction and hence either all committed or all rolled back as one. It also allows the user to more easily specify the isolation level for the transaction.  
+2. **Database.UseTransaction()** : which allows the DbContext to use a transaction which was started outside of the Entity Framework.  
+
+### Combining several operations into one transaction within the same context  
+
+**Database.BeginTransaction()** has two overrides – one which takes an explicit [IsolationLevel](https://msdn.microsoft.com/library/system.data.isolationlevel.aspx) and one which takes no arguments and uses the default IsolationLevel from the underlying database provider. Both overrides return a **DbContextTransaction** object which provides **Commit()** and **Rollback()** methods which perform commit and rollback on the underlying store transaction.  
+
+The **DbContextTransaction** is meant to be disposed once it has been committed or rolled back. One easy way to accomplish this is the **using(…) {…}** syntax which will automatically call **Dispose()** when the using block completes:  
+
+``` csharp
+using System;
+using System.Collections.Generic;
+using System.Data.Entity;
+using System.Data.SqlClient;
+using System.Linq;
+using System.Transactions;
+
+namespace TransactionsExamples
+{
+    class TransactionsExample
+    {
+        static void StartOwnTransactionWithinContext()
+        {
+            using (var context = new BloggingContext())
+            {
+                using (var dbContextTransaction = context.Database.BeginTransaction())
+                {
+                    context.Database.ExecuteSqlCommand(
+                        @"UPDATE Blogs SET Rating = 5" +
+                            " WHERE Name LIKE '%Entity Framework%'"
+                        );
+
+                    var query = context.Posts.Where(p => p.Blog.Rating >= 5);
+                    foreach (var post in query)
+                    {
+                        post.Title += "[Cool Blog]";
+                    }
+
+                    context.SaveChanges();
+
+                    dbContextTransaction.Commit();
+                }
+            }
+        }
+    }
+}
+```  
+
+> [!NOTE]
+> Beginning a transaction requires that the underlying store connection is open. So calling Database.BeginTransaction() will open the connection  if it is not already opened. If DbContextTransaction opened the connection then it will close it when Dispose() is called.  
+
+### Passing an existing transaction to the context  
+
+Sometimes you would like a transaction which is even broader in scope and which includes operations on the same database but outside of EF completely. To accomplish this you must open the connection and start the transaction yourself and then tell EF a) to use the already-opened database connection, and b) to use the existing transaction on that connection.  
+
+To do this you must define and use a constructor on your context class which inherits from one of the DbContext constructors which take i) an existing connection parameter and ii) the contextOwnsConnection boolean.  
+
+> [!NOTE]
+> The contextOwnsConnection flag must be set to false when called in this scenario. This is important as it informs Entity Framework that it should not close the connection when it is done with it (for example, see line 4 below):  
+
+``` csharp
+using (var conn = new SqlConnection("..."))
+{
+    conn.Open();
+    using (var context = new BloggingContext(conn, contextOwnsConnection: false))
+    {
+    }
+}
+```  
+
+Furthermore, you must start the transaction yourself (including the IsolationLevel if you want to avoid the default setting) and let Entity Framework know that there is an existing transaction already started on the connection (see line 33 below).  
+
+Then you are free to execute database operations either directly on the SqlConnection itself, or on the DbContext. All such operations are executed within one transaction. You take responsibility for committing or rolling back the transaction and for calling Dispose() on it, as well as for closing and disposing the database connection. For example:  
+
+``` csharp
+using System;
+using System.Collections.Generic;
+using System.Data.Entity;
+using System.Data.SqlClient;
+using System.Linq;
+using System.Transactions;
+
+namespace TransactionsExamples
+{
+     class TransactionsExample
+     {
+        static void UsingExternalTransaction()
+        {
+            using (var conn = new SqlConnection("..."))
+            {
+               conn.Open();
+
+               using (var sqlTxn = conn.BeginTransaction(System.Data.IsolationLevel.Snapshot))
+               {
+                   var sqlCommand = new SqlCommand();
+                   sqlCommand.Connection = conn;
+                   sqlCommand.Transaction = sqlTxn;
+                   sqlCommand.CommandText =
+                       @"UPDATE Blogs SET Rating = 5" +
+                        " WHERE Name LIKE '%Entity Framework%'";
+                   sqlCommand.ExecuteNonQuery();
+
+                   using (var context =  
+                     new BloggingContext(conn, contextOwnsConnection: false))
+                    {
+                        context.Database.UseTransaction(sqlTxn);
+
+                        var query =  context.Posts.Where(p => p.Blog.Rating >= 5);
+                        foreach (var post in query)
+                        {
+                            post.Title += "[Cool Blog]";
+                        }
+                       context.SaveChanges();
+                    }
+
+                    sqlTxn.Commit();
+                }
+            }
+        }
+    }
+}
+```  
+
+### Clearing up the transaction
+
+You can pass null to Database.UseTransaction() to clear Entity Framework’s knowledge of the current transaction. Entity Framework will neither commit nor rollback the existing transaction when you do this, so use with care and only if you’re sure this is what you want to do.  
+
+### Errors in UseTransaction
+
+You will see an exception from Database.UseTransaction() if you pass a transaction when:  
+- Entity Framework already has an existing transaction  
+- Entity Framework is already operating within a TransactionScope  
+- The connection object in the transaction passed is null. That is, the transaction is not associated with a connection – usually this is a sign that that transaction has already completed  
+- The connection object in the transaction passed does not match the Entity Framework’s connection.  
+
+## Using transactions with other features  
+
+This section details how the above transactions interact with:  
+
+- Connection resiliency  
+- Asynchronous methods  
+- TransactionScope transactions  
+
+### Connection Resiliency  
+
+The new Connection Resiliency feature does not work with user-initiated transactions. For details, see [Retrying Execution Strategies](xref:ef6/fundamentals/connection-resiliency/retry-logic#user-initiated-transactions-are-not-supported).  
+
+### Asynchronous Programming  
+
+The approach outlined in the previous sections needs no further options or settings to work with the [asynchronous query and save methods](xref:ef6/fundamentals/async
+). But be aware that, depending on what you do within the asynchronous methods, this may result in long-running transactions – which can in turn cause deadlocks or blocking which is bad for the performance of the overall application.  
+
+### TransactionScope Transactions  
+
+Prior to EF6 the recommended way of providing larger scope transactions was to use a TransactionScope object:  
+
+``` csharp
+using System.Collections.Generic;
+using System.Data.Entity;
+using System.Data.SqlClient;
+using System.Linq;
+using System.Transactions;
+
+namespace TransactionsExamples
+{
+    class TransactionsExample
+    {
+        static void UsingTransactionScope()
+        {
+            using (var scope = new TransactionScope(TransactionScopeOption.Required))
+            {
+                using (var conn = new SqlConnection("..."))
+                {
+                    conn.Open();
+
+                    var sqlCommand = new SqlCommand();
+                    sqlCommand.Connection = conn;
+                    sqlCommand.CommandText =
+                        @"UPDATE Blogs SET Rating = 5" +
+                            " WHERE Name LIKE '%Entity Framework%'";
+                    sqlCommand.ExecuteNonQuery();
+
+                    using (var context =
+                        new BloggingContext(conn, contextOwnsConnection: false))
+                    {
+                        var query = context.Posts.Where(p => p.Blog.Rating > 5);
+                        foreach (var post in query)
+                        {
+                            post.Title += "[Cool Blog]";
+                        }
+                        context.SaveChanges();
+                    }
+                }
+
+                scope.Complete();
+            }
+        }
+    }
+}
+```  
+
+The SqlConnection and Entity Framework would both use the ambient TransactionScope transaction and hence be committed together.  
+
+Starting with .NET 4.5.1 TransactionScope has been updated to also work with asynchronous methods via the use of the [TransactionScopeAsyncFlowOption](https://msdn.microsoft.com/library/system.transactions.transactionscopeasyncflowoption.aspx) enumeration:  
+
+``` csharp
+using System.Collections.Generic;
+using System.Data.Entity;
+using System.Data.SqlClient;
+using System.Linq;
+using System.Transactions;
+
+namespace TransactionsExamples
+{
+    class TransactionsExample
+    {
+        public static void AsyncTransactionScope()
+        {
+            using (var scope = new TransactionScope(TransactionScopeAsyncFlowOption.Enabled))
+            {
+                using (var conn = new SqlConnection("..."))
+                {
+                    await conn.OpenAsync();
+
+                    var sqlCommand = new SqlCommand();
+                    sqlCommand.Connection = conn;
+                    sqlCommand.CommandText =
+                        @"UPDATE Blogs SET Rating = 5" +
+                            " WHERE Name LIKE '%Entity Framework%'";
+                    await sqlCommand.ExecuteNonQueryAsync();
+
+                    using (var context = new BloggingContext(conn, contextOwnsConnection: false))
+                    {
+                        var query = context.Posts.Where(p => p.Blog.Rating > 5);
+                        foreach (var post in query)
+                        {
+                            post.Title += "[Cool Blog]";
+                        }
+
+                        await context.SaveChangesAsync();
+                    }
+                }
+                
+                scope.Complete();
+            }
+        }
+    }
+}
+```  
+
+There are still some limitations to the TransactionScope approach:  
+
+- Requires .NET 4.5.1 or greater to work with asynchronous methods.  
+- It cannot be used in cloud scenarios unless you are sure you have one and only one connection (cloud scenarios do not support distributed transactions).  
+- It cannot be combined with the Database.UseTransaction() approach of the previous sections.  
+- It will throw exceptions if you issue any DDL and have not enabled distributed transactions through the MSDTC Service.  
+
+Advantages of the TransactionScope approach:  
+
+- It will automatically upgrade a local transaction to a distributed transaction if you make more than one connection to a given database or combine a connection to one database with a connection to a different database within the same transaction (note: you must have the MSDTC service configured to allow distributed transactions for this to work).  
+- Ease of coding. If you prefer the transaction to be ambient and dealt with implicitly in the background rather than explicitly under you control then the TransactionScope approach may suit you better.  
+
+In summary, with the new Database.BeginTransaction() and Database.UseTransaction() APIs above, the TransactionScope approach is no longer necessary for most users. If you do continue to use TransactionScope then be aware of the above limitations. We recommend using the approach outlined in the previous sections instead where possible.  
diff --git a/entity-framework/ef6/saving/validation.md b/entity-framework/ef6/saving/validation.md
new file mode 100644
index 0000000000..2d13759e31
--- /dev/null
+++ b/entity-framework/ef6/saving/validation.md
@@ -0,0 +1,236 @@
+---
+title: Validation - EF6
+description: Validation in Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+---
+# Data Validation
+> [!NOTE]
+> **EF4.1 Onwards Only** - The features, APIs, etc. discussed in this page were introduced in Entity Framework 4.1. If you are using an earlier version, some or all of the information does not apply
+
+The content on this page is adapted from an article originally written by Julie Lerman ([https://thedatafarm.com](https://thedatafarm.com)).
+
+Entity Framework provides a great variety of validation features that can feed through to a user interface for client-side validation or be used for server-side validation. When using code first, you can specify validations using annotation or fluent API configurations. Additional validations, and more complex, can be specified in code and will work whether your model hails from code first, model first or database first.
+
+## The model
+
+I'll demonstrate the validations with a simple pair of classes: Blog and Post.
+
+``` csharp
+public class Blog
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+    public string BloggerName { get; set; }
+    public DateTime DateCreated { get; set; }
+    public virtual ICollection<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+    public DateTime DateCreated { get; set; }
+    public string Content { get; set; }
+    public int BlogId { get; set; }
+    public ICollection<Comment> Comments { get; set; }
+}
+```
+
+## Data Annotations
+
+Code First uses annotations from the `System.ComponentModel.DataAnnotations` assembly as one means of configuring code first classes. Among these annotations are those which provide rules such as the `Required`, `MaxLength` and `MinLength`. A number of .NET client applications also recognize these annotations, for example, ASP.NET MVC. You can achieve both client side and server side validation with these annotations. For example, you can force the Blog Title property to be a required property.
+
+``` csharp
+[Required]
+public string Title { get; set; }
+```
+
+With no additional code or markup changes in the application, an existing MVC application will perform client side validation, even dynamically building a message using the property and annotation names.
+
+![figure 1](~/ef6/media/figure01.png)
+
+In the post back method of this Create view, Entity Framework is used to save the new blog to the database, but MVC's client-side validation is triggered before the application reaches that code.
+
+Client side validation is not bullet-proof however. Users can impact features of their browser or worse yet, a hacker might use some trickery to avoid the UI validations. But Entity Framework will also recognize the `Required` annotation and validate it.
+
+A simple way to test this is to disable MVC's client-side validation feature. You can do this in the MVC application's web.config file. The appSettings section has a key for ClientValidationEnabled. Setting this key to false will prevent the UI from performing validations.
+
+``` xml
+<appSettings>
+    <add key="ClientValidationEnabled"value="false"/>
+    ...
+</appSettings>
+```
+
+Even with the client-side validation disabled, you will get the same response in your application. The error message "The Title field is required" will be displayed as before. Except now it will be a result of server-side validation. Entity Framework will perform the validation on the `Required` annotation (before it even bothers to build an `INSERT` command to send to the database) and return the error to MVC which will display the message.
+
+## Fluent API
+
+You can use code first's fluent API instead of annotations to get the same client side & server side validation. Rather than use `Required`, I'll show you this using a MaxLength validation.
+
+Fluent API configurations are applied as code first is building the model from the classes. You can inject the configurations by overriding the DbContext class' OnModelCreating  method. Here is a configuration specifying that the BloggerName property can be no longer than 10 characters.
+
+``` csharp
+public class BlogContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+    public DbSet<Comment> Comments { get; set; }
+
+    protected override void OnModelCreating(DbModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>().Property(p => p.BloggerName).HasMaxLength(10);
+    }
+}
+```
+
+Validation errors thrown based on the Fluent API configurations will not automatically reach the UI, but you can capture it in code and then respond to it accordingly.
+
+Here's some exception handling error code in the application's BlogController class that captures that validation error when Entity Framework attempts to save a blog with a BloggerName that exceeds the 10 character maximum.
+
+``` csharp
+[HttpPost]
+public ActionResult Edit(int id, Blog blog)
+{
+    try
+    {
+        db.Entry(blog).State = EntityState.Modified;
+        db.SaveChanges();
+        return RedirectToAction("Index");
+    }
+    catch (DbEntityValidationException ex)
+    {
+        var error = ex.EntityValidationErrors.First().ValidationErrors.First();
+        this.ModelState.AddModelError(error.PropertyName, error.ErrorMessage);
+        return View();
+    }
+}
+```
+
+The validation doesn't automatically get passed back into the view which is why the additional code that uses `ModelState.AddModelError` is being used. This ensures that the error details make it to the view which will then use the `ValidationMessageFor` Htmlhelper to display the error.
+
+``` csharp
+@Html.ValidationMessageFor(model => model.BloggerName)
+```
+
+## IValidatableObject
+
+`IValidatableObject` is an interface that lives in `System.ComponentModel.DataAnnotations`. While it is not part of the Entity Framework API, you can still leverage it for server-side validation in your Entity Framework classes. `IValidatableObject` provides a `Validate` method that Entity Framework will call during SaveChanges or you can call yourself any time you want to validate the classes.
+
+Configurations such as `Required` and `MaxLength` perform validation on a single field. In the `Validate` method you can have even more complex logic, for example, comparing two fields.
+
+In the following example, the `Blog` class has been extended to implement `IValidatableObject` and then provide a rule that the `Title` and `BloggerName` cannot match.
+
+``` csharp
+public class Blog : IValidatableObject
+{
+    public int Id { get; set; }
+
+    [Required]
+    public string Title { get; set; }
+
+    public string BloggerName { get; set; }
+    public DateTime DateCreated { get; set; }
+    public virtual ICollection<Post> Posts { get; set; }
+
+    public IEnumerable<ValidationResult> Validate(ValidationContext validationContext)
+    {
+        if (Title == BloggerName)
+        {
+            yield return new ValidationResult(
+                "Blog Title cannot match Blogger Name",
+                new[] { nameof(Title), nameof(BloggerName) });
+        }
+    }
+}
+```
+
+The `ValidationResult` constructor takes a `string` that represents the error message and an array of `string`s that represent the member names that are associated with the validation. Since this validation checks both the `Title` and the `BloggerName`, both property names are returned.
+
+Unlike the validation provided by the Fluent API, this validation result will be recognized by the View and the exception handler that I used earlier to add the error into `ModelState` is unnecessary. Because I set both property names in the `ValidationResult`, the MVC HtmlHelpers display the error message for both of those properties.
+
+![figure 2](~/ef6/media/figure02.png)
+
+## DbContext.ValidateEntity
+
+`DbContext` has an overridable method called `ValidateEntity`. When you call `SaveChanges`, Entity Framework will call this method for each entity in its cache whose state is not `Unchanged`. You can put validation logic directly in here or even use this method to call, for example, the `Blog.Validate` method added in the previous section.
+
+Here's an example of a `ValidateEntity` override that validates new `Post`s to ensure that the post title hasn't been used already. It first checks to see if the entity is a post and that its state is Added. If that's the case, then it looks in the database to see if there is already a post with the same title. If there is an existing post already, then a new `DbEntityValidationResult` is created.
+
+`DbEntityValidationResult` houses a `DbEntityEntry` and an `ICollection<DbValidationErrors>` for a single entity. At the start of this method, a `DbEntityValidationResult` is instantiated and then any errors that are discovered are added into its `ValidationErrors` collection.
+
+``` csharp
+protected override DbEntityValidationResult ValidateEntity (
+    System.Data.Entity.Infrastructure.DbEntityEntry entityEntry,
+    IDictionary<object, object> items)
+{
+    var result = new DbEntityValidationResult(entityEntry, new List<DbValidationError>());
+
+    if (entityEntry.Entity is Post post && entityEntry.State == EntityState.Added)
+    {
+        // Check for uniqueness of post title
+        if (Posts.Where(p => p.Title == post.Title).Any())
+        {
+            result.ValidationErrors.Add(
+                    new System.Data.Entity.Validation.DbValidationError(
+                        nameof(Title),
+                        "Post title must be unique."));
+        }
+    }
+
+    if (result.ValidationErrors.Count > 0)
+    {
+        return result;
+    }
+    else
+    {
+        return base.ValidateEntity(entityEntry, items);
+    }
+}
+```
+
+## Explicitly triggering validation
+
+A call to `SaveChanges` triggers all of the validations covered in this article. But you don't need to rely on `SaveChanges`. You may prefer to validate elsewhere in your application.
+
+`DbContext.GetValidationErrors` will trigger all of the validations, those defined by annotations or the Fluent API, the validation created in `IValidatableObject` (for example, `Blog.Validate`), and the validations performed in the `DbContext.ValidateEntity` method.
+
+The following code will call `GetValidationErrors` on the current instance of a `DbContext`. `ValidationErrors` are grouped by entity type into `DbEntityValidationResult`. The code iterates first through the `DbEntityValidationResult`s returned by the method and then through each `DbValidationError` inside.
+
+``` csharp
+foreach (var validationResult in db.GetValidationErrors())
+{
+    foreach (var error in validationResult.ValidationErrors)
+    {
+        Debug.WriteLine(
+            "Entity Property: {0}, Error {1}",
+            error.PropertyName,
+            error.ErrorMessage);
+    }
+}
+```
+
+## Other considerations when using validation
+
+Here are a few other points to consider when using Entity Framework validation:
+
+- Lazy loading is disabled during validation
+- EF will validate data annotations on non-mapped properties (properties that are not mapped to a column in the database)
+- Validation is performed after changes are detected during `SaveChanges`. If you make changes during validation it is your responsibility to notify the change tracker
+- `DbUnexpectedValidationException` is thrown if errors occur during validation
+- Facets that Entity Framework includes in the model (maximum length, required, etc.) will cause validation, even if there are no data annotations in your classes and/or you used the EF Designer to create your model
+- Precedence rules:
+  - Fluent API calls override the corresponding data annotations
+- Execution order:
+  - Property validation occurs before type validation
+  - Type validation only occurs if property validation succeeds
+- If a property is complex, its validation will also include:
+  - Property-level validation on the complex type properties
+  - Type level validation on the complex type, including `IValidatableObject` validation on the complex type
+
+## Summary
+
+The validation API in Entity Framework plays very nicely with client side validation in MVC but you don't have to rely on client-side validation. Entity Framework will take care of the validation on the server side for DataAnnotations or configurations you've applied with the code first Fluent API.
+
+You also saw a number of extensibility points for customizing the behavior whether you use the `IValidatableObject` interface or tap into the `DbContext.ValidateEntity` method. And these last two means of validation are available through the `DbContext`, whether you use the Code First, Model First or Database First workflow to describe your conceptual model.
diff --git a/entity-framework/ef6/what-is-new/index.md b/entity-framework/ef6/what-is-new/index.md
new file mode 100644
index 0000000000..2f8ce7a64c
--- /dev/null
+++ b/entity-framework/ef6/what-is-new/index.md
@@ -0,0 +1,61 @@
+---
+title: What's new - EF6
+description: What's new in Entity Framework 6
+author: SamMonoRT
+ms.date: 05/17/2024
+uid: ef6/what-is-new/index
+---
+# What's new in EF6
+
+We highly recommend that you use the latest released version of Entity Framework to ensure you get the latest features and the highest stability.
+However, we realize that you may need to use a previous version, or that you may want to experiment with new improvements in the latest pre-release.
+To install specific versions of EF, see [Get Entity Framework](xref:ef6/fundamentals/install).
+
+## EF 6.5.0
+
+The EF 6.5.0 runtime was released to NuGet in June 2024. The primary goal of EF 6.5 is to include a new SQL Server / Azure SQL Database provider. See [list of important fixes](https://github.com/dotnet/ef6/milestone/17?closed=1) on Github. Here are some of the more notable ones:
+
+- New SQL Server / Azure SQL Database provider (contributed by the community) - [Microsoft.EntityFramework.SqlServer](https://www.nuget.org/packages/Microsoft.EntityFramework.SqlServer/). This new provider uses the modern SQL Server client [Microsoft.Data.SqlClient](https://www.nuget.org/packages/Microsoft.Data.SqlClient). For more information about configuration of this provider, see [Microsoft.EntityFramework.SqlServer Guide](xref:ef6/what-is-new/microsoft-ef6-sqlserver).
+- The `ef6` utility was updated to only support .NET 6 and newer. It was also updated to support reading from app.config files, and support Windows ARM64.
+- The System.Data.SqlClient driver was updated to version 4.8.6.
+
+## EF 6.4.0
+
+The EF 6.4.0 runtime was released to NuGet in December 2019. The primary goal of EF 6.4 is to polish the features and scenarios that was delivered in EF 6.3. See [list of important fixes](https://github.com/dotnet/ef6/milestone/14?closed=1) on Github.
+
+## EF 6.3.0
+
+The EF 6.3.0 runtime was released to NuGet in September 2019. The main goal of this release was to facilitate migrating existing applications that use EF 6 to .NET Core 3.0. The community has also contributed several bug fixes and enhancements. See the issues closed in each 6.3.0 [milestone](https://github.com/aspnet/EntityFramework6/milestones?state=closed) for details. Here are some of the more notable ones:
+
+- Support for .NET Core 3.0
+  - The EntityFramework package now targets .NET Standard 2.1 in addition to .NET Framework 4.x.
+  - This means that EF 6.3 is cross-platform and supported on other operating systems besides Windows, like Linux and macOS.
+  - The migrations commands have been rewritten to execute out of process and work with SDK-style projects.
+- Support for SQL Server HierarchyId.
+- Improved compatibility with Roslyn and NuGet PackageReference.
+- Added `ef6.exe` utility for enabling, adding, scripting, and applying migrations from assemblies. This replaces `migrate.exe`.
+
+### EF designer support
+
+There's currently no support for using the EF designer directly on .NET or .NET Standard projects or on an SDK-style .NET Framework project. 
+
+You can work around this limitation by adding the EDMX file and the generated classes for the entities and the DbContext as linked files to a .NET Core 3.0 or .NET Standard 2.1 project in the same solution.
+
+The linked files will look like this in the project file:
+
+``` csproj 
+<ItemGroup>
+  <EntityDeploy Include="..\EdmxDesignHost\Entities.edmx" Link="Model\Entities.edmx" />
+  <Compile Include="..\EdmxDesignHost\Entities.Context.cs" Link="Model\Entities.Context.cs" />
+  <Compile Include="..\EdmxDesignHost\Thing.cs" Link="Model\Thing.cs" />
+  <Compile Include="..\EdmxDesignHost\Person.cs" Link="Model\Person.cs" />
+</ItemGroup>
+```
+
+Note that the EDMX file is linked with the EntityDeploy build action. This is a special MSBuild task (now included in the EF 6.3 package) that takes care of adding the EF model into the target assembly as embedded resources (or copying it as files in the output folder, depending on the Metadata Artifact Processing setting in the EDMX). For more details on how to get this set up, see our [EDMX .NET sample](https://aka.ms/EdmxDotNetCoreSample).
+
+Warning: make sure the old style (i.e. non-SDK-style) .NET Framework project defining the "real" .edmx file comes _before_ the project defining the link inside the .sln file. Otherwise, when you open the .edmx file in the designer, you see the error message "The Entity Framework is not available in the target framework currently specified for the project. You can change the target framework of the project or edit the model in the XmlEditor".
+
+## Past Releases
+
+The [Past Releases](xref:ef6/what-is-new/past-releases) page contains an archive of all previous versions of EF and the major features that were introduced on each release.
diff --git a/entity-framework/ef6/what-is-new/microsoft-ef6-sqlserver.md b/entity-framework/ef6/what-is-new/microsoft-ef6-sqlserver.md
new file mode 100644
index 0000000000..ae71e2d60e
--- /dev/null
+++ b/entity-framework/ef6/what-is-new/microsoft-ef6-sqlserver.md
@@ -0,0 +1,165 @@
+---
+title: Entity Framework 6 SQL Server provider based on Microsoft.Data.SqlClient
+description: Microsoft.EntityFramework.SqlServer guide
+author: SamMonoRT
+ms.date: 06/11/2024
+uid: ef6/what-is-new/microsoft-ef6-sqlserver
+ms.custom: sfi-ropc-nochange
+---
+
+# Entity Framework 6 SQL Server provider based on Microsoft.Data.SqlClient
+
+This Entity Framework 6 provider is a replacement provider for the built-in SQL Server provider.
+
+This provider depends on the modern [Microsoft.Data.SqlClient](https://github.com/dotnet/SqlClient) ADO.NET provider, which includes the following advantages over the currently used driver:
+
+- Current client receiving full support in contrast to `System.Data.SqlClient`, which is in maintenance mode
+- Supports new SQL Server features, including support for the SQL Server 2022 enhanced client protocol (TDS8)
+- Supports most Azure Active Directory authentication methods
+- Supports Always Encrypted with .NET
+
+Notice that this provider is a runtime only update and will not work with the existing Visual Studio tooling.
+
+The latest build of this package is available from [NuGet](https://www.nuget.org/packages/Microsoft.EntityFramework.SqlServer)
+
+## Configuration
+
+There are various ways to configure Entity Framework to use this provider.
+
+You can register the provider in code using an attribute:
+
+````csharp
+[DbConfigurationType(typeof(MicrosoftSqlDbConfiguration))]
+public class SchoolContext : DbContext
+{
+    public SchoolContext() : base()
+    {
+    }
+
+    public DbSet<Student> Students { get; set; }
+}
+````
+
+If you have multiple classes inheriting from DbContext in your solution, add the DbConfigurationType attribute to all of them.
+
+Or you can use the SetConfiguration method before any data access calls:
+
+````csharp
+ DbConfiguration.SetConfiguration(new MicrosoftSqlDbConfiguration());
+````
+
+Or add the following lines to your existing derived DbConfiguration class:
+
+````csharp
+SetProviderFactory(MicrosoftSqlProviderServices.ProviderInvariantName, Microsoft.Data.SqlClient.SqlClientFactory.Instance);
+SetProviderServices(MicrosoftSqlProviderServices.ProviderInvariantName, MicrosoftSqlProviderServices.Instance);
+// Optional
+SetExecutionStrategy(MicrosoftSqlProviderServices.ProviderInvariantName, () => new MicrosoftSqlAzureExecutionStrategy());
+````
+
+You can also use App.Config based configuration:
+
+````xml
+<?xml version="1.0" encoding="utf-8"?>
+<configuration>
+    <configSections>
+        <section name="entityFramework" type="System.Data.Entity.Internal.ConfigFile.EntityFrameworkSection, EntityFramework, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" requirePermission="false" />    
+    </configSections>
+    <entityFramework>
+        <providers>
+            <provider invariantName="Microsoft.Data.SqlClient" type="System.Data.Entity.SqlServer.MicrosoftSqlProviderServices, Microsoft.EntityFramework.SqlServer" />
+        </providers>
+    </entityFramework>
+    <system.data>
+        <DbProviderFactories>
+           <add name="SqlClient Data Provider"
+             invariant="Microsoft.Data.SqlClient"
+             description=".NET Framework Data Provider for SqlServer"
+             type="Microsoft.Data.SqlClient.SqlClientFactory, Microsoft.Data.SqlClient" />
+        </DbProviderFactories>
+    </system.data>
+</configuration>
+````
+
+If you use App.Config with a .NET 6 or later app, you must remove the `<system.data>` section above and register the DbProviderFactory in code once:
+
+````csharp
+DbProviderFactories.RegisterFactory(MicrosoftSqlProviderServices.ProviderInvariantName, Microsoft.Data.SqlClient.SqlClientFactory.Instance);
+````
+
+## EDMX usage
+
+If you use an EDMX file, update the `Provider` name:
+
+````xml
+<edmx:Edmx Version="3.0" xmlns:edmx="http://schemas.microsoft.com/ado/2009/11/edmx">
+  <edmx:Runtime>
+    <edmx:StorageModels>
+      <Schema Namespace="ChinookModel.Store" Provider="Microsoft.Data.SqlClient" >
+````
+
+> In order to use the EDMX file with the Visual Studio designer, you must switch the provider name back to `System.Data.SqlClient`
+
+Also update the provider name inside the EntityConnection connection string - `provider=Microsoft.Data.SqlClient`
+
+````xml
+ <add 
+    name="Database" 
+    connectionString="metadata=res://*/EFModels.csdl|res://*/EFModels.ssdl|res://*/EFModels.msl;provider=Microsoft.Data.SqlClient;provider connection string=&quot;data source=server;initial catalog=mydb;integrated security=True;persist security info=True;" 
+    providerName="System.Data.EntityClient" 
+ />
+````
+
+## Code changes
+
+To use the provider in an existing solution, a few code changes are required (as needed).
+
+`using System.Data.SqlClient;` => `using Microsoft.Data.SqlClient;`
+
+`using Microsoft.SqlServer.Server;` => `using Microsoft.Data.SqlClient.Server;`
+
+The following classes have been renamed to avoid conflicts with classes that uses `System.Data.SqlClient` in the existing SQL Server provider:
+
+`SqlAzureExecutionStrategy` => `MicrosoftSqlAzureExecutionStrategy`
+
+`SqlDbConfiguration` => `MicrosoftSqlDbConfiguration`
+
+`SqlProviderServices` => `MicrosoftSqlProviderServices`
+
+`SqlServerMigrationSqlGenerator` => `MicrosoftSqlServerMigrationSqlGenerator`
+
+`SqlSpatialServices` => `MicrosoftSqlSpatialServices`
+
+`SqlConnectionFactory` => `MicrosoftSqlConnectionFactory`
+
+`LocalDbConnectionFactory` => `MicrosoftLocalDbConnectionFactory`
+
+## Known issues
+
+**Azure App Service with .NET Framework and connection strings configuration**
+
+If you use Azure App Service with .NET Framework and the [connection strings configuration feature](/azure/app-service/configure-common?tabs=portal#configure-connection-strings), you can encounter runtime issues, as the `ProviderName` connection string setting in this scenario is hardcoded to `System.Data.SqlClient`.
+
+Solution is to use a derived MicrosoftSqlDbConfiguration class like this:
+
+```csharp
+public class AppServiceConfiguration : MicrosoftSqlDbConfiguration
+{
+    public AppServiceConfiguration()
+    {
+        SetProviderFactory("System.Data.SqlClient", Microsoft.Data.SqlClient.SqlClientFactory.Instance);
+        SetProviderServices("System.Data.SqlClient", MicrosoftSqlProviderServices.Instance);
+        SetExecutionStrategy("System.Data.SqlClient", () => new MicrosoftSqlAzureExecutionStrategy());
+    }
+}
+```
+
+Then use this derived class in the code-based configuration described above.
+
+**EntityFramework.dll installed in GAC**
+
+If an older version of EntityFramework.dll is installed in the .NET Framework GAC (Global Assembly Cache), you might get this error:
+
+`The 'PrimitiveTypeKind' attribute is invalid - The value 'HierarchyId' is invalid according to its datatype`
+
+Solution is to remove the .dll from the GAC. EF6 assemblies should never be installed in the GAC.
diff --git a/entity-framework/ef6/what-is-new/past-releases.md b/entity-framework/ef6/what-is-new/past-releases.md
new file mode 100644
index 0000000000..fc52492e0d
--- /dev/null
+++ b/entity-framework/ef6/what-is-new/past-releases.md
@@ -0,0 +1,279 @@
+---
+title: Past Releases of Entity Framework - EF6
+description: Past Releases of Entity Framework
+author: SamMonoRT
+ms.date: 09/12/2019
+uid: ef6/what-is-new/past-releases
+---
+# Past Releases of Entity Framework
+
+The first version of Entity Framework was released in 2008, as part of .NET Framework 3.5 SP1 and Visual Studio 2008 SP1.
+
+Starting with the EF4.1 release it has shipped as the [EntityFramework NuGet Package](https://www.nuget.org/packages/EntityFramework/) - currently one of the most popular packages on NuGet.org.
+
+Between versions 4.1 and 5.0, the EntityFramework NuGet package extended the EF libraries that shipped as part of .NET Framework.
+
+Starting with version 6, EF became an open source project and also moved completely out of band from the .NET Framework.
+This means that when you add the EntityFramework version 6 NuGet package to an application, you are getting a complete copy of the EF library that does not depend on the EF bits that ship as part of .NET Framework.
+This helped somewhat accelerate the pace of development and delivery of new features.
+
+In June 2016, we released EF Core 1.0. EF Core is based on a new codebase and is designed as a more lightweight and extensible version of EF.
+Currently EF Core is the main focus of development for the Entity Framework Team at Microsoft.
+This means there are no new major features planned for EF6. However EF6 is still maintained as an open source project and a supported Microsoft product.
+
+Here is the list of past releases, in reverse chronological order, with information on the new features that were introduced in each release.
+
+## EF Tools Update in Visual Studio 2017 15.7
+In May 2018, we released an updated version of the EF Tools as part of Visual Studio 2017 15.7.
+It includes improvements for some common pain points:
+
+- Fixes for several user interface accessibility bugs
+- Workaround for SQL Server performance regression when generating models from existing databases [#4](https://github.com/aspnet/entityframework6/issues/4)
+- Support for updating models for larger models on SQL Server [#185](https://github.com/aspnet/EntityFramework6/issues/185)
+
+Another improvement in this new version of EF Tools is that it installs the EF 6.2 runtime when creating a model in a new project. With older versions of Visual Studio, it is possible to use the EF 6.2 runtime (as well as any past version of EF) by installing the corresponding version of the NuGet package.
+
+## EF 6.2.0
+The EF 6.2 runtime was released to NuGet in October of 2017.
+Thanks in great part to the efforts our community of open source contributors, EF 6.2 includes numerous [bugs fixes](https://github.com/aspnet/entityframework6/issues?utf8=%E2%9C%93&q=is%3Aissue%20milestone%3A6.2.0%20is%3Aclosed%20label%3Aclosed-fixed%20-label%3Aarea-tools%20label%3Atype-bug) and [product enhancements](https://github.com/aspnet/entityframework6/issues?utf8=%E2%9C%93&q=is%3Aissue%20milestone%3A6.2.0%20is%3Aclosed%20label%3Aclosed-fixed%20-label%3Aarea-tools%20label%3Atype-enhancement%20).
+
+Here is a brief list of the most important changes affecting the EF 6.2 runtime:
+
+- Reduce start up time by loading finished code first models from a persistent cache [#275](https://github.com/aspnet/EntityFramework6/issues/275)
+- Fluent API to define indexes [#274](https://github.com/aspnet/EntityFramework6/issues/274)
+- DbFunctions.Like() to enable writing LINQ queries that translate to LIKE in SQL [#241](https://github.com/aspnet/EntityFramework6/issues/241)
+- Migrate.exe now supports -script option [#240](https://github.com/aspnet/EntityFramework6/issues/240)
+- EF6 can now work with key values generated by a sequence in SQL Server [#165](https://github.com/aspnet/EntityFramework6/issues/165)
+- Update list of transient errors for SQL Azure Execution Strategy [#83](https://github.com/aspnet/EntityFramework6/issues/83)
+- Bug: Retrying queries or SQL commands fails with "The SqlParameter is already contained by another SqlParameterCollection" [#81](https://github.com/aspnet/EntityFramework6/issues/81)
+- Bug: Evaluation of DbQuery.ToString() frequently times out in the debugger [#73](https://github.com/aspnet/EntityFramework6/issues/73)
+
+## EF 6.1.3
+The EF 6.1.3 runtime was released to NuGet in October of 2015.
+This release contains only fixes to high-priority defects and regressions reported on the 6.1.2 release.
+The fixes include:
+
+- Query: Regression in EF 6.1.2: OUTER APPLY introduced and more complex queries for 1:1 relationships and “let” clause
+- TPT problem with hiding base class property in inherited class
+- DbMigration.Sql fails when the word ‘go’ is contained in the text
+- Create compatibility flag for UnionAll and Intersect flattening support
+- Query with multiple Includes does not work in 6.1.2 (working in 6.1.1)
+- “You have an error in your SQL syntax” exception after upgrading from EF 6.1.1 to 6.1.2
+
+## EF 6.1.2
+The EF 6.1.2 runtime was released to NuGet in December of 2014.
+This version is mostly about bug fixes. We also accepted a couple of noteworthy changes from members of the community:
+- **Query cache parameters can be configured from the app/web.configuration file**
+    ``` xml
+    <entityFramework>
+      <queryCache size='1000' cleaningIntervalInSeconds='-1'/>
+    </entityFramework>
+    ```
+- **SqlFile and SqlResource methods on DbMigration** allow you to run a SQL script stored as a file or embedded resource.
+
+## EF 6.1.1
+The EF 6.1.1 runtime was released to NuGet in June of 2014.
+This version contains fixes for issues that a number of people have encountered. Among others:
+- Designer: Error opening EF5 edmx with decimal precision in EF6 designer
+- Default instance detection logic for LocalDB doesn't work with SQL Server 2014
+
+## EF 6.1.0
+The EF 6.1.0 runtime was released to NuGet in March of 2014.
+This minor update includes a significant number of new features:
+
+- **Tooling consolidation** provides a consistent way to create a new EF model. This feature [extends the ADO.NET Entity Data Model wizard to support creating Code First models](xref:ef6/modeling/code-first/workflows/existing-database), including reverse engineering from an existing database. These features were previously available in Beta quality in the EF Power Tools.
+- **[Handling of transaction commit failures](xref:ef6/fundamentals/connection-resiliency/commit-failures)** provides the CommitFailureHandler which makes use of the newly introduced ability to intercept transaction operations. The CommitFailureHandler allows automatic recovery from connection failures whilst committing a transaction.
+- **[IndexAttribute](xref:ef6/modeling/code-first/data-annotations)** allows indexes to be specified by placing an `[Index]` attribute on a property (or properties) in your Code First model. Code First will then create a corresponding index in the database.
+- **The public mapping API** provides access to the information EF has on how properties and types are mapped to columns and tables in the database. In past releases this API was internal.
+- **[Ability to configure interceptors via the App/Web.config file](xref:ef6/fundamentals/configuring/config-file)** allows interceptors to be added without recompiling the application.
+- **System.Data.Entity.Infrastructure.Interception.DatabaseLogger**is a new interceptor that makes it easy to log all database operations to a file. In combination with the previous feature, this allows you to easily [switch on logging of database operations for a deployed application](xref:ef6/fundamentals/configuring/config-file), without the need to recompile.
+- **Migrations model change detection** has been improved so that scaffolded migrations are more accurate; performance of the change detection process has also been enhanced.
+- **Performance improvements** including reduced database operations during initialization, optimizations for null equality comparison in LINQ queries, faster view generation (model creation) in more scenarios, and more efficient materialization of tracked entities with multiple associations.
+
+## EF 6.0.2
+The EF 6.0.2 runtime was released to NuGet in December of 2013.
+This patch release is limited to fixing issues that were introduced in the EF6 release (regressions in performance/behavior since EF5).
+
+## EF 6.0.1
+The EF 6.0.1 runtime was released to NuGet in October of 2013 simultaneously with EF 6.0.0, because the latter was embedded in a version of Visual Studio that had locked down a few months before.
+This patch release is limited to fixing issues that were introduced in the EF6 release (regressions in performance/behavior since EF5).
+The most notable changes were to fix some performance issues during warm-up for EF models.
+This was important as warm-up performance was an area of focus in EF6 and these issues were negating some of the other performance gains made in EF6.
+
+## EF 6.0
+The EF 6.0.0 runtime was released to NuGet in October of 2013.
+This is the first version in which a complete EF runtime is included in the [EntityFramework NuGet Package](https://www.nuget.org/packages/EntityFramework/) which does not depend on the EF bits that are part of the .NET Framework.
+Moving the remaining parts of the runtime to the NuGet package required a number of breaking change for existing code.
+See the section on [Upgrading to Entity Framework 6](xref:ef6/what-is-new/upgrading-to-ef6) for more details on the manual steps required to upgrade.
+
+This release includes numerous new features.
+The following features work for models created with Code First or the EF Designer:
+
+- **[Async Query and Save](xref:ef6/fundamentals/async)** adds support for the task-based asynchronous patterns that were introduced in .NET 4.5.
+- **[Connection Resiliency](xref:ef6/fundamentals/connection-resiliency/retry-logic)** enables automatic recovery from transient connection failures.
+- **[Code-Based Configuration](xref:ef6/fundamentals/configuring/code-based)** gives you the option of performing configuration – that was traditionally performed in a config file – in code.
+- **[Dependency Resolution](xref:ef6/fundamentals/configuring/dependency-resolution)** introduces support for the Service Locator pattern and we've factored out some pieces of functionality that can be replaced with custom implementations.
+- **[Interception/SQL logging](xref:ef6/fundamentals/logging-and-interception)** provides low-level building blocks for interception of EF operations with simple SQL logging built on top.
+- **Testability improvements** make it easier to create test doubles for DbContext and DbSet when [using a mocking framework](xref:ef6/fundamentals/testing/mocking) or [writing your own test doubles](xref:ef6/fundamentals/testing/writing-test-doubles).
+- **[DbContext can now be created with a DbConnection that is already opened](xref:ef6/fundamentals/connection-management)** which enables scenarios where it would be helpful if the connection could be open when creating the context (such as sharing a connection between components where you can not guarantee the state of the connection).
+- **[Improved Transaction Support](xref:ef6/saving/transactions)** provides support for a transaction external to the framework as well as improved ways of creating a transaction within the Framework.
+- **Enums, Spatial and Better Performance on .NET 4.0** - By moving the core components that used to be in the .NET Framework into the EF NuGet package we are now able to offer enum support, spatial data types and the performance improvements from EF5 on .NET 4.0.
+- **Improved performance of Enumerable.Contains in LINQ queries**.
+- **Improved warm up time (view generation)**, especially for large models.
+- **Pluggable Pluralization &amp; Singularization Service**.
+- **Custom implementations of Equals or GetHashCode** on entity classes are now supported.
+- **DbSet.AddRange/RemoveRange** provides an optimized way to add or remove multiple entities from a set.
+- **DbChangeTracker.HasChanges** provides an easy and efficient way to see if there are any pending changes to be saved to the database.
+- **SqlCeFunctions** provides a SQL Compact equivalent to the SqlFunctions.
+
+The following features apply to Code First only:
+
+- **[Custom Code First Conventions](xref:ef6/modeling/code-first/conventions/custom)** allow write your own conventions to help avoid repetitive configuration. We provide a simple API for lightweight conventions as well as some more complex building blocks to allow you to author more complicated conventions.
+- **[Code First Mapping to Insert/Update/Delete Stored Procedures](xref:ef6/modeling/code-first/fluent/cud-stored-procedures)** is now supported.
+- **[Idempotent migrations scripts](xref:ef6/modeling/code-first/migrations/index)** allow you to generate a SQL script that can upgrade a database at any version up to the latest version.
+- **[Configurable Migrations History Table](xref:ef6/modeling/code-first/migrations/history-customization)** allows you to customize the definition of the migrations history table. This is particularly useful for database providers that require the appropriate data types etc. to be specified for the Migrations History table to work correctly.
+- **Multiple Contexts per Database** removes the previous limitation of one Code First model per database when using Migrations or when Code First automatically created the database for you.
+- **[DbModelBuilder.HasDefaultSchema](xref:ef6/modeling/code-first/fluent/types-and-properties)** is a new Code First API that allows the default database schema for a Code First model to be configured in one place. Previously the Code First default schema was hard-coded to &quot;dbo&quot; and the only way to configure the schema to which a table belonged was via the ToTable API.
+- **DbModelBuilder.Configurations.AddFromAssembly method** allows you to easily add all configuration classes defined in an assembly when you are using configuration classes with the Code First Fluent API.
+- **[Custom Migrations Operations](https://romiller.com/2013/02/27/ef6-writing-your-own-code-first-migration-operations/)** enabled you to add additional operations to be used in your code-based migrations.
+- **Default transaction isolation level is changed to READ_COMMITTED_SNAPSHOT** for databases created using Code First, allowing for more scalability and fewer deadlocks.
+- **Entity and complex types can now be nestedinside classes**.
+
+## EF 5.0
+The EF 5.0.0 runtime was released to NuGet in August of 2012.
+This release introduces some new features including enum support, table-valued functions, spatial data types and various performance improvements.
+
+The Entity Framework Designer in Visual Studio 2012 also introduces support for multiple-diagrams per model, coloring of shapes on the design surface and batch import of stored procedures.
+
+Here is a list of content we put together specifically for the EF 5 release:
+
+-   [EF 5 Release Post](https://blogs.msdn.com/b/adonet/archive/2012/08/15/ef5-released.aspx)
+-   New Features in EF5
+    -   [Enum Support in Code First](xref:ef6/modeling/code-first/data-types/enums)
+    -   [Enum Support in EF Designer](xref:ef6/modeling/designer/data-types/enums)
+    -   [Spatial Data Types in Code First](xref:ef6/modeling/code-first/data-types/spatial)
+    -   [Spatial Data Types in EF Designer](xref:ef6/modeling/designer/data-types/spatial)
+    -   [Provider Support for Spatial Types](xref:ef6/fundamentals/providers/spatial-support)
+    -   [Table-Valued Functions](xref:ef6/modeling/designer/advanced/tvfs)
+    -   [Multiple Diagrams per Model](xref:ef6/modeling/designer/multiple-diagrams)
+-   Setting up your model
+    -   [Creating a Model](xref:ef6/modeling/index)
+    -   [Connections and Models](xref:ef6/fundamentals/configuring/connection-strings)
+    -   [Performance Considerations](xref:ef6/fundamentals/performance/perf-whitepaper)
+    -   [Working with Microsoft SQL Azure](xref:ef6/fundamentals/connection-resiliency/retry-logic)
+    -   [Configuration File Settings](xref:ef6/fundamentals/configuring/config-file)
+    -   [Glossary](xref:ef6/resources/glossary)
+    -   Code First
+        -   [Code First to a new database (walkthrough and video)](xref:ef6/modeling/code-first/workflows/new-database)
+        -   [Code First to an existing database (walkthrough and video)](xref:ef6/modeling/code-first/workflows/existing-database)
+        -   [Conventions](xref:ef6/modeling/code-first/conventions/built-in)
+        -   [Data Annotations](xref:ef6/modeling/code-first/data-annotations)
+        -   [Fluent API - Configuring/Mapping Properties & Types](xref:ef6/modeling/code-first/fluent/types-and-properties)
+        -   [Fluent API - Configuring Relationships](xref:ef6/modeling/code-first/fluent/relationships)
+        -   [Fluent API with VB.NET](xref:ef6/modeling/code-first/fluent/vb)
+        -   [Code First Migrations](xref:ef6/modeling/code-first/migrations/index)
+        -   [Automatic Code First Migrations](xref:ef6/modeling/code-first/migrations/automatic)
+        -   [Migrate.exe](xref:ef6/modeling/code-first/migrations/migrate-exe)
+        -   [Defining DbSets](xref:ef6/modeling/code-first/dbsets)
+    -   EF Designer
+        -   [Model First (walkthrough and video)](xref:ef6/modeling/designer/workflows/model-first)
+        -   [Database First (walkthrough and video)](xref:ef6/modeling/designer/workflows/database-first)
+        -   [Complex Types](xref:ef6/modeling/designer/data-types/complex-types)
+        -   [Associations/Relationships](xref:ef6/modeling/designer/relationships)
+        -   [TPT Inheritance Pattern](xref:ef6/modeling/designer/inheritance/tpt)
+        -   [TPH Inheritance Pattern](xref:ef6/modeling/designer/inheritance/tph)
+        -   [Query with Stored Procedures](xref:ef6/modeling/designer/stored-procedures/query)
+        -   [Stored Procedures with Multiple Result Sets](xref:ef6/modeling/designer/advanced/multiple-result-sets)
+        -   [Insert, Update & Delete with Stored Procedures](xref:ef6/modeling/designer/stored-procedures/cud)
+        -   [Map an Entity to Multiple Tables (Entity Splitting)](xref:ef6/modeling/designer/entity-splitting)
+        -   [Map Multiple Entities to One Table (Table Splitting)](xref:ef6/modeling/designer/table-splitting)
+        -   [Defining Queries](xref:ef6/modeling/designer/advanced/defining-query)
+        -   [Code Generation Templates](xref:ef6/modeling/designer/codegen/index)
+        -   [Reverting to ObjectContext](xref:ef6/modeling/designer/codegen/legacy-objectcontext)
+-   Using Your Model
+    -   [Working with DbContext](xref:ef6/fundamentals/working-with-dbcontext)
+    -   [Querying/Finding Entities](xref:ef6/querying/index)
+    -   [Working with Relationships](xref:ef6/fundamentals/relationships)
+    -   [Loading Related Entities](xref:ef6/querying/related-data)
+    -   [Working with Local Data](xref:ef6/querying/local-data)
+    -   [N-Tier Applications](xref:ef6/fundamentals/disconnected-entities/index)
+    -   [Raw SQL Queries](xref:ef6/querying/raw-sql)
+    -   [Optimistic Concurrency Patterns](xref:ef6/saving/concurrency)
+    -   [Working with Proxies](xref:ef6/fundamentals/proxies)
+    -   [Automatic Detect Changes](xref:ef6/saving/change-tracking/auto-detect-changes)
+    -   [No-Tracking Queries](xref:ef6/querying/no-tracking)
+    -   [The Load Method](xref:ef6/querying/load-method)
+    -   [Add/Attach and Entity States](xref:ef6/saving/change-tracking/entity-state)
+    -   [Working with Property Values](xref:ef6/saving/change-tracking/property-values)
+    -   [Data Binding with WPF (Windows Presentation Foundation)](xref:ef6/fundamentals/databinding/wpf)
+    -   [Data Binding with WinForms (Windows Forms)](xref:ef6/fundamentals/databinding/winforms)
+
+## EF 4.3.1
+The EF 4.3.1 runtime was released to NuGet in February 2012 shortly after EF 4.3.0.
+This patch release included some bug fixes to the EF 4.3 release and introduced better LocalDB support for customers using EF 4.3 with Visual Studio 2012.
+
+Here is a list of content we put together specifically for the EF 4.3.1 release, most of the content provided for EF 4.1 still applies to EF 4.3 as well:
+
+-   [EF 4.3.1 Release Blog  Post](https://blogs.msdn.com/b/adonet/archive/2012/02/29/ef4-3-1-and-ef5-beta-1-available-on-nuget.aspx)
+
+## EF 4.3
+The EF 4.3.0 runtime was released to NuGet in February of 2012.
+This release included the new Code First Migrations feature that allows a database created by Code First to be incrementally changed as your Code First model evolves.
+
+Here is a list of content we put together specifically for the EF 4.3 release, most of the content provided for EF 4.1 still applies to EF 4.3 as well:
+-   [EF 4.3 Release Post](https://blogs.msdn.com/b/adonet/archive/2012/02/09/ef-4-3-released.aspx)
+-   [EF 4.3 Code-Based Migrations Walkthrough](https://blogs.msdn.com/b/adonet/archive/2012/02/09/ef-4-3-code-based-migrations-walkthrough.aspx)
+-   [EF 4.3 Automatic Migrations Walkthrough](https://blogs.msdn.com/b/adonet/archive/2012/02/09/ef-4-3-automatic-migrations-walkthrough.aspx)
+
+## EF 4.2
+The EF 4.2.0 runtime was released to NuGet in November of 2011.
+This release includes bug fixes to the EF 4.1.1 release.
+Because this release only included bug fixes it could have been the EF 4.1.2 patch release but we opted to move to 4.2 to allow us to move away from the date based patch version numbers we used in the 4.1.x releases and adopt the [Semantic Versioning](https://semver.org) standard for semantic versioning.
+
+Here is a list of content we put together specifically for the EF 4.2 release, the content provided for EF 4.1 still applies to EF 4.2 as well:
+
+-   [EF 4.2 Release Post](https://blogs.msdn.com/b/adonet/archive/2011/11/01/ef-4-2-released.aspx)
+-   [Code First Walkthrough](https://blogs.msdn.com/b/adonet/archive/2011/09/28/ef-4-2-code-first-walkthrough.aspx)
+-   [Model & Database First Walkthrough](https://blogs.msdn.com/b/adonet/archive/2011/09/28/ef-4-2-model-amp-database-first-walkthrough.aspx)
+
+## EF 4.1.1
+The EF 4.1.10715 runtime was released to NuGet in July of 2011.
+In addition to bug fixes this patch release introduced some components to make it easier for design time tooling to work with a Code First model.
+These components are used by Code First Migrations (included in EF 4.3) and the EF Power Tools.
+
+You’ll notice that the strange version number 4.1.10715 of the package.
+We used to use date based patch versions before we decided to adopt [Semantic Versioning](https://semver.org).
+Think of this version as EF 4.1 patch 1 (or EF 4.1.1).
+
+Here is a list of content we put together for the 4.1.1 release:
+
+-   [EF 4.1.1 Release Post](https://blogs.msdn.com/b/adonet/archive/2011/07/25/ef-4-1-update-1-released.aspx)
+
+## EF 4.1
+The EF 4.1.10331 runtime was the first to be published on NuGet, in April of 2011.
+This release included the simplified DbContext API and the Code First workflow.
+
+You will notice the strange version number, 4.1.10331, which should really have been 4.1. In addition there is a 4.1.10311 version which should have been 4.1.0-rc (the ‘rc’ stands for ‘release candidate’).
+We used to use date based patch versions before we decided to adopt [Semantic Versioning](https://semver.org).
+
+Here is a list of content we put together for the 4.1 release. Much of it still applies to later releases of Entity Framework:
+
+-   [EF 4.1 Release Post](https://blogs.msdn.com/b/adonet/archive/2011/04/11/ef-4-1-released.aspx)
+-   [Code First Walkthrough](https://blogs.msdn.com/b/adonet/archive/2011/03/15/ef-4-1-code-first-walkthrough.aspx)
+-   [Model & Database First Walkthrough](https://blogs.msdn.com/b/adonet/archive/2011/03/15/ef-4-1-model-amp-database-first-walkthrough.aspx)
+-   [SQL Azure Federations and the Entity Framework](https://blogs.msdn.com/b/adonet/archive/2012/01/10/sql-azure-federations-and-the-entity-framework.aspx)
+
+## EF 4.0
+This release was included in .NET Framework 4 and Visual Studio 2010, in April of 2010.
+Important new features in this release included POCO support, foreign key mapping, lazy loading, testability improvements, customizable code generation and the Model First workflow.
+
+Although it was the second release of Entity Framework, it was named EF 4 to align with the .NET Framework version that it shipped with.
+After this release, we started making Entity Framework available on NuGet and adopted semantic versioning since we were no longer tied to the .NET Framework Version.
+
+Note that some subsequent versions of .NET Framework have shipped with significant updates to the included EF bits.
+In fact, many of the new features of EF 5.0 were implemented as improvements on these bits.
+However, in order to rationalize the versioning story for EF, we continue to refer to the EF bits that are part of the .NET Framework as the EF 4.0 runtime, while all newer versions consist of the [EntityFramework NuGet Package](https://www.nuget.org/packages/EntityFramework/).
+
+## EF 3.5
+The initial version of Entity Framework was included in .NET 3.5 Service Pack 1 and Visual Studio 2008 SP1, released in August of 2008.
+This release provided basic O/RM support using the Database First workflow.
diff --git a/entity-framework/ef6/what-is-new/upgrading-to-ef6.md b/entity-framework/ef6/what-is-new/upgrading-to-ef6.md
new file mode 100644
index 0000000000..6a185fb6ae
--- /dev/null
+++ b/entity-framework/ef6/what-is-new/upgrading-to-ef6.md
@@ -0,0 +1,80 @@
+---
+title: Upgrading to Entity Framework 6 - EF6
+description: Upgrading to Entity Framework 6
+author: SamMonoRT
+ms.date: 10/23/2016
+uid: ef6/what-is-new/upgrading-to-ef6
+---
+# Upgrading to Entity Framework 6
+
+In previous versions of EF the code was split between core libraries (primarily System.Data.Entity.dll) shipped as part of the .NET Framework and out-of-band (OOB) libraries (primarily EntityFramework.dll) shipped in a NuGet package. EF6 takes the code from the core libraries and incorporates it into the OOB libraries. This was necessary in order to allow EF to be made open source and for it to be able to evolve at a different pace from .NET Framework. The consequence of this is that applications will need to be rebuilt against the moved types.
+
+This should be straightforward for applications that make use of DbContext as shipped in EF 4.1 and later. A little more work is required for applications that make use of ObjectContext but it still isn’t hard to do.
+
+Here is a checklist of the things you need to do to upgrade an existing application to EF6.
+
+## 1. Install the EF6 NuGet package
+
+You need to upgrade to the new Entity Framework 6 runtime.
+
+1. Right-click on your project and select **Manage NuGet Packages...**  
+2. Under the **Online** tab select **EntityFramework** and click **Install**  
+   > [!NOTE]
+   > If a previous version of the EntityFramework NuGet package was installed this will upgrade it to EF6.
+
+Alternatively, you can run the following command from Package Manager Console:
+
+``` powershell
+Install-Package EntityFramework
+```
+
+## 2. Ensure that assembly references to System.Data.Entity.dll are removed
+
+Installing the EF6 NuGet package should automatically remove any references to System.Data.Entity from your project for you.
+
+## 3. Swap any EF Designer (EDMX) models to use EF 6.x code generation
+
+If you have any models created with the EF Designer, you will need to update the code generation templates to generate EF6 compatible code.
+
+> [!NOTE]
+> There are currently only EF 6.x DbContext Generator templates available for Visual Studio 2012 and 2013.
+
+1. Delete existing code-generation templates. These files will typically be named **\<edmx_file_name\>.tt** and **\<edmx_file_name\>.Context.tt** and be nested under your edmx file in Solution Explorer. You can select the templates in Solution Explorer and press the **Del** key to delete them.  
+   > [!NOTE]
+   > In Web Site projects the templates will not be nested under your edmx file, but listed alongside it in Solution Explorer.  
+
+   > [!NOTE]
+   > In VB.NET projects you will need to enable 'Show All Files' to be able to see the nested template files.
+2. Add the appropriate EF 6.x code generation template. Open your model in the EF Designer, right-click on the design surface and select **Add Code Generation Item...**
+    - If you are using the DbContext API (recommended) then **EF 6.x DbContext Generator** will be available under the **Data** tab.  
+      > [!NOTE]
+      > If you are using Visual Studio 2012, you will need to install the EF 6 Tools to have this template. See [Get Entity Framework](xref:ef6/fundamentals/install) for details.  
+
+    - If you are using the ObjectContext API then you will need to select the **Online** tab and search for **EF 6.x EntityObject Generator**.  
+3. If you applied any customizations to the code generation templates you will need to re-apply them to the updated templates.
+
+## 4. Update namespaces for any core EF types being used
+
+The namespaces for DbContext and Code First types have not changed. This means for many applications that use EF 4.1 or later you will not need to change anything.
+
+Types like ObjectContext that were previously in System.Data.Entity.dll have been moved to new namespaces. This means you may need to update your *using* or *Import* directives to build against EF6.
+
+The general rule for namespace changes is that any type in System.Data.* is moved to System.Data.Entity.Core.*. In other words, just insert **Entity.Core.** after System.Data. For example:
+
+- System.Data.EntityException => System.Data.**Entity.Core**.EntityException  
+- System.Data.Objects.ObjectContext => System.Data.**Entity.Core**.Objects.ObjectContext  
+- System.Data.Objects.DataClasses.RelationshipManager => System.Data.**Entity.Core**.Objects.DataClasses.RelationshipManager  
+
+These types are in the *Core* namespaces because they are not used directly for most DbContext-based applications. Some types that were part of System.Data.Entity.dll are still used commonly and directly for DbContext-based applications and so have not been moved into the *Core* namespaces. These are:
+
+- System.Data.EntityState => System.Data.**Entity**.EntityState  
+- System.Data.Objects.DataClasses.EdmFunctionAttribute => System.Data.**Entity.DbFunctionAttribute**  
+  > [!NOTE]
+  > This class has been renamed; a class with the old name still exists and works, but it now marked as obsolete.  
+- System.Data.Objects.EntityFunctions => System.Data.**Entity.DbFunctions**  
+  > [!NOTE]
+  > This class has been renamed; a class with the old name still exists and works, but it now marked as obsolete.)  
+- Spatial classes (for example, DbGeography, DbGeometry) have moved from System.Data.Spatial => System.Data.**Entity**.Spatial
+
+> [!NOTE]
+> Some types in the System.Data namespace are in System.Data.dll which is not an EF assembly. These types have not moved and so their namespaces remain unchanged.
diff --git a/entity-framework/ef6/what-is-new/visual-studio.md b/entity-framework/ef6/what-is-new/visual-studio.md
new file mode 100644
index 0000000000..d5fcf98c61
--- /dev/null
+++ b/entity-framework/ef6/what-is-new/visual-studio.md
@@ -0,0 +1,68 @@
+---
+title: Visual Studio Releases - EF6
+description: Visual Studio Releases and Entity Framework 6
+author: SamMonoRT
+ms.date: 07/05/2018
+uid: ef6/what-is-new/visual-studio
+---
+# Visual Studio Releases
+
+We recommend to always use the latest version of Visual Studio because it contains the latest tools for .NET, NuGet, and Entity Framework.
+In fact, the various samples and walkthroughs across the Entity Framework documentation assume that you are using a recent version of Visual Studio.
+
+It is possible however to use older versions of Visual Studio with different versions of Entity Framework as long as you take into account some differences:
+
+## Visual Studio 2017 15.7 and newer
+
+- This version of Visual Studio includes the latest release of Entity Framework tools and the EF 6.2 runtime, and does not require additional setup steps.
+See [What's New](xref:ef6/what-is-new/index) for more details on these releases.
+- Adding Entity Framework to new projects using the EF tools will automatically add the EF 6.2 NuGet package.
+You can manually install or upgrade to any EF NuGet package available online.
+- By default, the SQL Server instance available with this version of Visual Studio is a LocalDB instance called MSSQLLocalDB.
+The server section of connection string you should use is "(localdb)\\MSSQLLocalDB".
+Remember to use a verbatim string prefixed with `@` or double back-slashes "\\\\" when specifying a connection string in C# code.  
+
+
+## Visual Studio 2015 to Visual Studio 2017 15.6
+
+- These versions of Visual Studio include Entity Framework tools and runtime 6.1.3.
+See [Past Releases](xref:ef6/what-is-new/past-releases#ef-613) for more details on these releases.
+- Adding Entity Framework to new projects using the EF tools will automatically add the EF 6.1.3 NuGet package.
+You can manually install or upgrade to any EF NuGet package available online.
+- By default, the SQL Server instance available with this version of Visual Studio is a LocalDB instance called MSSQLLocalDB.
+The server section of connection string you should use is "(localdb)\\MSSQLLocalDB".
+Remember to use a verbatim string prefixed with `@` or double back-slashes "\\\\" when specifying a connection string in C# code.  
+
+
+## Visual Studio 2013
+- This version of Visual Studio includes and older version of Entity Framework tools and runtime.
+It is recommended that you upgrade to Entity Framework Tools 6.1.3, using the installer.
+See [Past Releases](xref:ef6/what-is-new/past-releases#ef-613) for more details on these releases.
+- Adding Entity Framework to new projects using the upgraded EF tools will automatically add the EF 6.1.3 NuGet package.
+You can manually install or upgrade to any EF NuGet package available online.
+- By default, the SQL Server instance available with this version of Visual Studio is a LocalDB instance called MSSQLLocalDB.
+The server section of connection string you should use is "(localdb)\\MSSQLLocalDB".
+Remember to use a verbatim string prefixed with `@` or double back-slashes "\\\\" when specifying a connection string in C# code.  
+
+## Visual Studio 2012
+
+- This version of Visual Studio includes and older version of Entity Framework tools and runtime.
+It is recommended that you upgrade to Entity Framework Tools 6.1.3, using the installer.
+See [Past Releases](xref:ef6/what-is-new/past-releases#ef-613) for more details on these releases.
+- Adding Entity Framework to new projects using the upgraded EF tools will automatically add the EF 6.1.3 NuGet package.
+You can manually install or upgrade to any EF NuGet package available online.
+- By default, the SQL Server instance available with this version of Visual Studio is a LocalDB instance called v11.0.
+The server section of connection string you should use is "(localdb)\\v11.0".
+Remember to use a verbatim string prefixed with `@` or double back-slashes "\\\\" when specifying a connection string in C# code.  
+
+## Visual Studio 2010
+
+- The version of Entity Framework Tools available with this version of Visual Studio is not compatible with the Entity Framework 6 runtime and cannot be upgraded.
+- By default, the Entity Framework tools will add Entity Framework 4.0 to your projects.
+In order to create applications using any newer versions of EF, you will first need to install the [NuGet Package Manager extension](https://marketplace.visualstudio.com/items?itemName=NuGetTeam.NuGetPackageManager).
+- By default, all code generation in the version of EF tools is based on EntityObject and Entity Framework 4.
+We recommend that you switch the code generation to be based on DbContext and Entity Framework 5, by installing the DbContext code generation templates for [C#](https://marketplace.visualstudio.com/items?itemName=EntityFrameworkTeam.EF5xDbContextGeneratorforC) or [Visual Basic](https://marketplace.visualstudio.com/items?itemName=EntityFrameworkTeam.EF5xDbContextGeneratorforVBNET).
+- Once you have installed the NuGet Package Manager extensions, you can manually install or upgrade to any EF NuGet package available online and use EF6 with Code First, which does not require a designer.
+- By default, the SQL Server instance available with this version of Visual Studio is SQL Server Express named SQLEXPRESS.
+The server section of connection string you should use is ".\\SQLEXPRESS".
+Remember to use a verbatim string prefixed with `@` or double back-slashes "\\\\" when specifying a connection string in C# code.
diff --git a/entity-framework/efcore-and-ef6/index.md b/entity-framework/efcore-and-ef6/index.md
new file mode 100644
index 0000000000..f0e16d8ea0
--- /dev/null
+++ b/entity-framework/efcore-and-ef6/index.md
@@ -0,0 +1,155 @@
+---
+title: Compare EF6 and EF Core
+description: Guidance on how to choose between EF6 and EF Core.
+author: SamMonoRT
+ms.date: 01/23/2019
+uid: efcore-and-ef6/index
+---
+
+# Compare EF Core & EF6
+
+## EF Core
+
+Entity Framework Core ([EF Core](xref:core/index)) is a modern object-database mapper for .NET. It supports LINQ queries, change tracking, updates, and schema migrations.
+
+EF Core works with SQL Server/Azure SQL Database, SQLite, Azure Cosmos DB, MySQL, PostgreSQL, and many more databases through a [database provider plugin model](xref:core/providers/index).
+
+## EF6
+
+Entity Framework 6 ([EF6](xref:ef6/index)) is an object-relational mapper designed for .NET Framework but with support for .NET Core. EF6 is a stable, supported product, but is no longer being actively developed.
+
+## Feature comparison
+
+EF Core offers new features that won't be implemented in EF6. However, not all EF6 features are currently implemented in EF Core.
+
+The following tables compare the features available in EF Core and EF6. This is a high-level comparison and doesn't list every feature or explain differences between the same feature in different EF versions.
+
+The EF Core column indicates the product version in which the feature first appeared.
+
+### Creating a model
+
+| **Feature**                                           | **EF6.4**| **EF Core**                           |
+|:------------------------------------------------------|:---------|:--------------------------------------|
+| Basic class mapping                                   | Yes      | 1.0                                   |
+| Constructors with parameters                          |          | 2.1                                   |
+| Property value conversions                            |          | 2.1                                   |
+| Mapped types with no keys                             |          | 2.1                                   |
+| Conventions                                           | Yes      | 1.0                                   |
+| Custom conventions                                    | Yes      | 7.0                                   |
+| Data annotations                                      | Yes      | 1.0                                   |
+| Fluent API                                            | Yes      | 1.0                                   |
+| Inheritance: Table per hierarchy (TPH)                | Yes      | 1.0                                   |
+| Inheritance: Table per type (TPT)                     | Yes      | 5.0                                   |
+| Inheritance: Table per concrete class (TPC)           | Yes      | 7.0                                   |
+| Shadow state properties                               |          | 1.0                                   |
+| Alternate keys                                        |          | 1.0                                   |
+| Many-to-many navigations                              | Yes      | 5.0                                   |
+| Many-to-many without join entity                      | Yes      | 5.0                                   |
+| Key generation: Database                              | Yes      | 1.0                                   |
+| Key generation: Client                                |          | 1.0                                   |
+| Complex/owned types                                   | Yes      | 2.0                                   |
+| Spatial data                                          | Yes      | 2.2                                   |
+| Model format: Code                                    | Yes      | 1.0                                   |
+| Create model from database: Command line              | Yes      | 1.0                                   |
+| Update model from database                            | Partial  | On the backlog ([#831](https://github.com/dotnet/efcore/issues/831)) |
+| Global query filters                                  |          | 2.0                                   |
+| Table splitting                                       | Yes      | 2.0                                   |
+| Entity splitting                                      | Yes      | 7.0                                   |
+| Database scalar function mapping                      | Poor     | 2.0                                   |
+| Database table valued function mapping                | Poor     | 5.0                                   |
+| Field mapping                                         |          | 1.1                                   |
+| Nullable reference types (C# 8.0)                     |          | 3.0                                   |
+| Graphical visualization of model                      | Yes      | No support planned <sup>(1)</sup>     |
+| Graphical model editor                                | Yes      | No support planned <sup>(1)</sup>     |
+| Model format: EDMX (XML)                              | Yes      | No support planned <sup>(1)</sup>     |
+| Create model from database: VS wizard                 | Yes      | No support planned <sup>(1)</sup>     |
+
+### Querying data
+
+| **Feature**                                           | **EF6.4**| **EF Core**                           |
+|:------------------------------------------------------|:---------|:--------------------------------------|
+| LINQ queries                                          | Yes      | 1.0                                   |
+| Readable generated SQL                                | Poor     | 1.0                                   |
+| GroupBy translation                                   | Yes      | 2.1                                   |
+| Loading related data: Eager                           | Yes      | 1.0                                   |
+| Loading related data: Eager loading for derived types |          | 2.1                                   |
+| Loading related data: Lazy                            | Yes      | 2.1                                   |
+| Loading related data: Explicit                        | Yes      | 1.1                                   |
+| Raw SQL queries: Entity types                         | Yes      | 1.0                                   |
+| Raw SQL queries: Keyless entity types                 | Yes      | 2.1                                   |
+| Raw SQL queries: Composing with LINQ                  |          | 1.0                                   |
+| Explicitly compiled queries                           | Poor     | 2.0                                   |
+| await foreach (C# 8.0)                                |          | 3.0                                   |
+| Text-based query language (Entity SQL)                | Yes      | No support planned <sup>(1)</sup>     |
+
+### Saving data
+
+| **Feature**                                           | **EF6.4**| **EF Core**                           |
+|:------------------------------------------------------|:---------|:--------------------------------------|
+| Change tracking: Snapshot                             | Yes      | 1.0                                   |
+| Change tracking: Notification                         | Yes      | 1.0                                   |
+| Change tracking: Proxies                              | Yes      | 5.0                                   |
+| Accessing tracked state                               | Yes      | 1.0                                   |
+| Optimistic concurrency                                | Yes      | 1.0                                   |
+| Transactions                                          | Yes      | 1.0                                   |
+| Batching of statements                                |          | 1.0                                   |
+| Stored procedure mapping                              | Yes      | 7.0                                   |
+| Disconnected graph low-level APIs                     | Poor     | 1.0                                   |
+| Disconnected graph End-to-end                         |          | 1.0 (partial; [#5536](https://github.com/dotnet/efcore/issues/5536)) |
+
+### Other features
+
+| **Feature**                                           | **EF6.4**| **EF Core**                           |
+|:------------------------------------------------------|:---------|:--------------------------------------|
+| Migrations                                            | Yes      | 1.0                                   |
+| Database creation/deletion APIs                       | Yes      | 1.0                                   |
+| Seed data                                             | Yes      | 2.1                                   |
+| Connection resiliency                                 | Yes      | 1.1                                   |
+| Interceptors                                          | Yes      | 3.0                                   |
+| Events                                                | Yes      | 3.0 (partial; [#626](https://github.com/dotnet/efcore/issues/626)) |
+| Simple Logging (Database.Log)                         | Yes      | 5.0                                   |
+| DbContext pooling                                     |          | 2.0                                   |
+
+### Database providers <sup>(2)</sup>
+
+| **Feature**                                           | **EF6.4**| **EF Core**                           |
+|:------------------------------------------------------|:---------|:--------------------------------------|
+| SQL Server                                            | Yes      | 1.0                                   |
+| MySQL                                                 | Yes      | 1.0                                   |
+| PostgreSQL                                            | Yes      | 1.0                                   |
+| Oracle                                                | Yes      | 1.0                                   |
+| SQLite                                                | Yes      | 1.0                                   |
+| SQL Server Compact                                    | Yes      | 1.0 <sup>(3)</sup>                    |
+| DB2                                                   | Yes      | 1.0                                   |
+| Firebird                                              | Yes      | 2.0                                   |
+| Jet (Microsoft Access)                                |          | 2.0 <sup>(3)</sup>                    |
+| Azure Cosmos DB                                       |          | 3.0                                   |
+| In-memory (for testing)                               |          | 1.0                                   |
+
+<sup>1</sup> Some EF6 features will not be implemented in EF Core. These features either depend on EF6's underlying Entity Data Model (EDM) and/or are complex features with relatively low return on investment. We always welcome feedback, but while EF Core enables many things not possible in EF6, it is conversely not feasible for EF Core to support all the features of EF6.
+
+<sup>2</sup> EF Core database providers implemented by third-parties may be delayed in updating to new major versions of EF Core. See [Database Providers](xref:core/providers/index) for more information.
+
+<sup>3</sup> The SQL Server Compact and Jet providers only work on .NET Framework (not on .NET Core).
+
+### Supported platforms
+
+EF Core 3.1 runs on .NET Core and .NET Framework, through the use of .NET Standard 2.0. However, EF Core 5.0 does not run on .NET Framework. See [Platforms](xref:core/miscellaneous/platforms) for more details.
+
+EF6.4 runs on .NET Core and .NET Framework, through multi-targeting.
+
+## Guidance for new applications
+
+Use EF Core on .NET Core for all new applications unless the app needs something that is [only supported on .NET Framework](/dotnet/standard/choosing-core-framework-server).
+
+## Guidance for existing EF6 applications
+
+EF Core is not a drop-in replacement for EF6. Moving from EF6 to EF Core will likely require changes to your application.
+
+When moving an EF6 app to .NET Core:
+
+* Keep using EF6 if the data access code is stable and not likely to evolve or need new features.
+* Port to EF Core if the data access code is evolving or if the app needs new features only available in EF Core.
+* Porting to EF Core is also often done for performance. However, not all scenarios are faster, so do some profiling first.
+
+See [Porting from EF6 to EF Core](xref:efcore-and-ef6/porting/index) for more information.
diff --git a/entity-framework/efcore-and-ef6/porting/index.md b/entity-framework/efcore-and-ef6/porting/index.md
new file mode 100644
index 0000000000..434766a0f9
--- /dev/null
+++ b/entity-framework/efcore-and-ef6/porting/index.md
@@ -0,0 +1,90 @@
+---
+title: Port from EF6 to EF Core - EF
+description: A detailed guide to port your EF6 apps to EF Core
+author: jeremylikness
+ms.alias: jeliknes
+ms.date: 12/09/2021
+uid: efcore-and-ef6/porting/index
+---
+# Port from EF6 to EF Core
+
+Entity Framework Core, or EF Core for short, is a total rewrite of Entity Framework for modern application architectures. Due to fundamental changes, there is not a direct upgrade path. The purpose of this documentation is to provide an end-to-end guide for porting your EF6 applications to EF Core.
+
+> [!IMPORTANT]
+> Before you start the porting process it is important to validate that EF Core meets the data access requirements for your application. You can find everything you need in the [EF Core documentation](xref:core/index).
+
+> [!WARNING]
+> EF Core only supports modern .NET, and does not support .NET Framework.
+> As such, if your project is still targeting .NET Framework, you will have to migrate to modern .NET before you can start your migration from EF6 to EF Core. Note that EF6 supports modern .NET, so you can migrate to modern .NET first while keeping EF6, and then tackle the migration from EF6 to EF Core.
+
+## Reasons to upgrade
+
+All new Entity Framework development is happening in EF Core. There are no plans to backport any new features to EF6. EF Core runs on the latest .NET runtimes and takes full advantage of runtime, platform-specific (such as ASP.NET Core or WPF) and language-specific features. Here are a few of the benefits you gain from upgrading:
+
+- Take advantage of the ongoing **performance improvements** in EF Core. For example, one customer who migrated from EF6 to EF Core 6 saw a 40x reduction in use of a heavy query due to the [query splitting feature](xref:core/querying/single-split-queries). Many customers report enormous performance gains simply by moving to the latest EF Core.
+- Use **new features** in EF Core. There will be no new features added to EF6. All of the new functionality, for example the [Azure Cosmos DB provider](xref:core/providers/cosmos/index) and [`DbContextFactory`](xref:core/what-is-new/ef-core-5.0/whatsnew#dbcontextfactory), will only be added to EF Core. For a full comparison of EF6 to EF Core, including several features exclusive to EF Core, see: [Compare EF Core & EF6](xref:efcore-and-ef6/index).
+- **Modernize your application stack** by using dependency injection and seamlessly integrate your data access with technologies like gRPC and GraphQL.
+
+## A note on migrations
+
+This documentation uses the terms _port_ and _upgrade_ to avoid confusion with the term [_migrations_](xref:core/managing-schemas/migrations/index) as a feature of EF Core. Migrations in EF Core are not compatible with [EF6 Code First migrations](xref:ef6/modeling/code-first/migrations/index) due to significant improvements to how migrations are handled. There is not a recommended approach to port your migrations history, so plan to start "fresh" in EF Core. You can maintain the codebase and data from your EF6 migrations. Apply your final migration in EF6, then create an initial migration in EF Core. You will be able to track history in EF Core moving forward.
+
+## Upgrade steps
+
+The upgrade path has been split into several documents that are organized by the phase of your upgrade and the type of application.
+
+### Determine your EF Core "flavor"
+
+There are several approaches to how EF Core works with your domain model and database implementation. In general, most apps will follow one of these patterns and how you approach your port will depend on the application "flavor".
+
+**Code as the source of truth** is an approach in which everything is modeled through code and classes, whether through data attributes, fluent configuration, or a combination of both. The database is initially generated based on the model defined in EF Core and further updates are typically handled through migrations. This is often referred to as "code first," but the name isn't entirely accurate because one approach is to start with an existing database, generate your entities, and then maintain with code moving forward.
+
+The **Database as source of truth** approach involves reverse-engineering or scaffolding your code from the database. When schema changes are made, the code is either regenerated or updated to reflect the changes. This is often called "database first."
+
+Finally, a more advanced **Hybrid mapping** approach follows the philosophy that the code and database are managed separately, and EF Core is used to map between the two. This approach typically eschews migrations.
+
+The following table summarizes some high level differences:
+
+|**Approach**|**Developer role**|**DBA role**|**Migrations**|**Scaffolding**|**Repo**|
+|---|---|---|---|---|---|
+|**Code first**|Design entities and verify/customize generated migrations|Verify schema definitions and changes|Per commit|N/A|Track entities, DbContext, and migrations|
+|**Database first**|Reverse engineer after changes and verify generated entities|Inform developers when the database changes to re-scaffold|N/A|Per schema change|Track extensions/partial classes that extend the generated entities|
+|**Hybrid**|Update fluent configuration to map whenever entities or database change|Inform developers when the database has changed so they can update entities and model configuration|N/A|N/A|Track entities and DbContext|
+
+The hybrid approach is a more advanced approach with additional overhead compared to the traditional code and database approaches.
+
+### Understand the impact of moving away from EDMX
+
+EF6 supported a special model definition format named _Entity Data Model XML (EDMX)_. EDMX files contain multiple definitions, including conceptual schema definitions (CSDL), mapping specifications (MSL), and store schema definitions (SSDL). EF Core tracks the domain, mapping, and database schemas through internal model graphs and does not support the EDMX format. Many blog posts and articles mistakenly state this means EF Core only supports "code first." EF Core supports all three application models described in the previous section. You can rebuild the model in EF Core by [reverse-engineering the database](xref:core/managing-schemas/scaffolding). If you use EDMX for a visual representation of your entity model, consider using the open source [EF Core Power Tools](https://github.com/ErikEJ/EFCorePowerTools) that provide similar capabilities for EF Core.
+
+For more information on the impact of lack of support for EDMX files, read the [porting EDMX](xref:efcore-and-ef6/porting/port-edmx#other-considerations) guide.
+
+### Perform the upgrade steps
+
+It is not a requirement to port the entire application. EF6 and EF Core can run in the same application (see: [using EF Core and EF6 in the same application](xref:efcore-and-ef6/side-by-side)). To minimize risk, you might consider:
+
+1. Move to EF6 on .NET Core if you haven't already.
+1. Migrate a small portion of your app to EF Core and run it side-by-side with EF6.
+1. Eventually bring the rest of the codebase to EF Core and retire the EF6 code.
+
+As for the port itself, at a high level, you will:
+
+1. [Review behavior changes between EF6 and EF Core](xref:efcore-and-ef6/porting/port-behavior).
+1. Perform your final migrations, if any, in EF6.
+1. Create your EF Core project.
+1. Either copy code to the new project, run reverse-engineering, or a combination of both.
+1. Rename references and entities and update behaviors:
+    - `System.Data.Entity` to `Microsoft.EntityFrameworkCore`
+    - Change `DbContext` constructor to consume options and/or override `OnConfiguring`
+    - `DbModelBuilder` to `ModelBuilder`
+    - Rename `DbEntityEntry<T>` to `EntityEntry<T>`
+    - Move from `Database.Log` to `Microsoft.Extensions.Logging` (advanced) or `DbContextOptionsBuilder.LogTo` (simple) APIs
+    - Apply changes for `WithRequired` and `WithOptional` (see [here](xref:efcore-and-ef6/porting/port-detailed-cases#required-and-optional))
+    - Update validation code. There is no data validation built into EF Core, but you can [do it yourself](/dotnet/architecture/microservices/microservice-ddd-cqrs-patterns/domain-model-layer-validations#use-validation-attributes-in-the-model-based-on-data-annotations).
+    - Follow any necessary steps to [port from EDMX](xref:efcore-and-ef6/porting/port-edmx).
+1. Perform specific steps based on your EF Core approach:
+    - [Code as source of truth](xref:efcore-and-ef6/porting/port-code)
+    - [Database as source of truth](xref:efcore-and-ef6/porting/port-database)
+    - [Hybrid model](xref:efcore-and-ef6/porting/port-hybrid)
+
+There are many considerations that relate to all of the approaches, so you will also want to review ways to address and work around the [detailed differences between EF6 and EF Core](xref:efcore-and-ef6/porting/port-detailed-cases).
diff --git a/entity-framework/efcore-and-ef6/porting/port-behavior.md b/entity-framework/efcore-and-ef6/porting/port-behavior.md
new file mode 100644
index 0000000000..a83d7aeecd
--- /dev/null
+++ b/entity-framework/efcore-and-ef6/porting/port-behavior.md
@@ -0,0 +1,56 @@
+---
+title: Porting from EF6 to EF Core - Behavior changes
+description: A non-exhaustive list of some changes in behavior between EF6 and EF Core.
+author: SamMonoRT
+ms.date: 12/09/2021
+uid: efcore-and-ef6/porting/port-behavior
+---
+# Behavior Changes between EF6 and EF Core
+
+This is a non-exhaustive list of changes in behavior between EF6 and EF Core. It is important to keep these in mind as your port your application as they may change the way your application behaves, but will not show up as compilation errors after swapping to EF Core.
+
+This is meant as a high level review to consider as part of the porting process. For more detailed, case-by-case instructions, read the [detailed cases](xref:efcore-and-ef6/porting/port-detailed-cases).
+
+## DbSet.Add/Attach and graph behavior
+
+In EF6, calling `DbSet.Add()` on an entity results in a recursive search for all entities referenced in its navigation properties. Any entities that are found, and are not already tracked by the context, are also marked as added. `DbSet.Attach()` behaves the same, except all entities are marked as unchanged.
+
+**EF Core performs a similar recursive search, but with some slightly different rules.**
+
+- If the root entity is configured for a generated key and the key is not set, it will be put into the `Added` state.
+- **For entities that are found during the recursive search of navigation properties:**
+  - **If the primary key of the entity is store generated**
+    - If the primary key is not set to a value, the state is set to added. The primary key value is considered "not set" if it is assigned the CLR default value for the property type (for example, `0` for `int`, `null` for `string`, etc.).
+    - If the primary key is set to a value, the state is set to unchanged.
+  - If the primary key is not database generated, the entity is put in the same state as the root.
+- This change of behavior only applies to the `Attach` and `Update` method groups. `Add` always puts entities in the `Added` state, even if the key is set.
+- `Attach` methods put entities with keys set into the `Unchanged` state. This facilitates "insert it if new, otherwise leave it alone." `Update` methods put entities with keys set into the `Modified` state. This facilitates "insert it if new, otherwise update it."
+
+The general philosophy here is that `Update` is a very simple way to handle inserts and updates of disconnected entities. It ensures any new entities are inserted, and any existing entities are updated.
+
+At the same time, `Add` still provides an easy way force entities to be inserted. Add is mostly useful only when not using store-generated keys, such that EF doesn't know if the entity is new or not.
+
+For more information on these behaviors in EF Core, read [Change Tracking in EF Core](xref:core/change-tracking/index).
+
+## Code First database initialization
+
+**EF6 has a significant amount of magic it performs around selecting the database connection and initializing the database. Some of these rules include:**
+
+- If no configuration is performed, EF6 will select a database on SQL Express or LocalDb.
+- If a connection string with the same name as the context is in the application's `App/Web.config` file, this connection will be used.
+- If the database does not exist, it is created.
+- If none of the tables from the model exist in the database, the schema for the current model is added to the database. If migrations are enabled, then they are used to create the database.
+- If the database exists and EF6 had previously created the schema, then the schema is checked for compatibility with the current model. An exception is thrown if the model has changed since the schema was created.
+
+**EF Core does not perform any of this magic.**
+
+- The database connection must be explicitly configured in code.
+- No initialization is performed. You must use `DbContext.Database.Migrate()` to apply migrations (or `DbContext.Database.EnsureCreated()` and `EnsureDeleted()` to create/delete the database without using migrations).
+
+## Code First table naming convention
+
+EF6 runs the entity class name through a pluralization service to calculate the default table name that the entity is mapped to.
+
+EF Core uses the name of the `DbSet` property that the entity is exposed in on the derived context. If the entity does not have a `DbSet` property, then the class name is used.
+
+For more information, read [Managing Database Schemas](xref:core/managing-schemas/index).
diff --git a/entity-framework/efcore-and-ef6/porting/port-code.md b/entity-framework/efcore-and-ef6/porting/port-code.md
new file mode 100644
index 0000000000..16259f9eaf
--- /dev/null
+++ b/entity-framework/efcore-and-ef6/porting/port-code.md
@@ -0,0 +1,61 @@
+---
+title: Porting from EF6 to EF Core - Porting a Code-Based Model - EF
+description: Specific information on porting an Entity Framework 6 code-based model application to Entity Framework Core
+author: SamMonoRT
+ms.date: 12/09/2021
+uid: efcore-and-ef6/porting/port-code
+ms.custom: sfi-ropc-nochange
+---
+# Porting an EF6 Code-Based Model to EF Core
+
+If you've read all the caveats and you are ready to port, then here are some guidelines to help you get started.
+
+## Install EF Core NuGet packages
+
+To use EF Core, you install the NuGet package for the database provider you want to use. For example, when targeting SQL Server, you would install `Microsoft.EntityFrameworkCore.SqlServer`. See [Database Providers](xref:core/providers/index) for details.
+
+If you are planning to use migrations, then you should also install the `Microsoft.EntityFrameworkCore.Tools` package.
+
+It is fine to leave the EF6 NuGet package (EntityFramework) installed, as EF Core and EF6 can be used side-by-side in the same application. However, if you aren't intending to use EF6 in any areas of your application, then uninstalling the package will help give compile errors on pieces of code that need attention.
+
+## Swap namespaces
+
+Most APIs that you use in EF6 are in the `System.Data.Entity` namespace (and related sub-namespaces). The first code change is to swap to the `Microsoft.EntityFrameworkCore` namespace. You would typically start with your derived context code file and then work out from there, addressing compilation errors as they occur.
+
+## Context configuration (connection etc.)
+
+As described in [configuring the database  connection](xref:efcore-and-ef6/porting/port-detailed-cases#configuring-the-database-connection), EF Core has less magic around detecting the database to connect to. You will need to override the `OnConfiguring` method on your derived context, and use the database provider specific API to setup the connection to the database.
+
+Most EF6 applications store the connection string in the applications `App/Web.config` file. In EF Core, you read this connection string using the `ConfigurationManager` API. You may need to add a reference to the `System.Configuration` framework assembly to be able to use this API:
+
+```csharp
+public class BloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+      optionsBuilder.UseSqlServer(ConfigurationManager.ConnectionStrings["BloggingDatabase"].ConnectionString);
+    }
+}
+```
+
+> Warning
+> Never store passwords or other sensitive data in source code or configuration files. Production secrets shouldn't be used for development or test. Secrets shouldn't be deployed with the app. Production secrets should be accessed through a controlled means like Azure Key Vault. Azure test and production secrets can be stored and protected with the [Azure Key Vault configuration provider](/aspnet/core/security/key-vault-configuration).
+
+## Update your code
+
+At this point, it's a matter of addressing compilation errors and reviewing code to see if the behavior changes will impact you.
+
+## Existing migrations
+
+There isn't really a feasible way to port existing EF6 migrations to EF Core.
+
+If possible, it is best to assume that all previous migrations from EF6 have been applied to the database and then start migrating the schema from that point using EF Core. To do this, you would use the `Add-Migration` command to add a migration once the model is ported to EF Core. You would then remove all code from the `Up` and `Down` methods of the scaffolded migration. Subsequent migrations will compare to the model when that initial migration was scaffolded.
+
+## Test the port
+
+Just because your application compiles, does not mean it is successfully ported to EF Core. You will need to test all areas of your application to ensure that none of the behavior changes have adversely impacted your application.
+
+Finally, review the [detailed cases to consider when porting](xref:efcore-and-ef6/porting/port-detailed-cases) for more advice on specific cases and scenarios in your code.
diff --git a/entity-framework/efcore-and-ef6/porting/port-database.md b/entity-framework/efcore-and-ef6/porting/port-database.md
new file mode 100644
index 0000000000..20eb1d3413
--- /dev/null
+++ b/entity-framework/efcore-and-ef6/porting/port-database.md
@@ -0,0 +1,39 @@
+---
+title: Port from EF6 to EF Core - Database as Source of Truth
+description: How to port from EF6 to EF Core when you generate your model from the database.
+author: jeremylikness
+ms.alias: jeliknes
+ms.date: 12/09/2021
+uid: efcore-and-ef6/porting/port-database
+---
+
+# Port from EF6 to EF Core - Database as Source of Truth
+
+If you're using the database as the source of truth, the upgrade will mostly involve addressing any changes to the shape of entities generated. The steps to migrate include:
+
+1. Pick a point-in-time to model the database.
+1. Ensure your EF6 projects are up to date and in-sync with the database.
+1. Create the EF Core project.
+1. Use the [scaffolding tools](xref:core/managing-schemas/scaffolding) to reverse-engineer your database to code.
+1. Validate that the EF Core generated classes are compatible with your code.
+1. For exceptions, either modify the generated classes and update the [model configuration](xref:core/modeling/index) or adapt your code to the model.
+
+Note that although EF Core currently scaffolds everything needed to successfully generate a copy of the database, much of the code is not needed for the database-first approach. A fix for this is tracked in [Issue #10890](https://github.com/dotnet/efcore/issues/10890). Things that you can safely ignore as not needed include: sequences, constraint names, non-unique indexes and index filters.
+
+## Handling schema changes
+
+When your database is the source of truth, EF Core pulls schema information from the database rather than pushing it via migrations. The typical workflow is to re-run the reverse-engineering step whenever the database schema changes. A comprehensive test suite is valuable for this approach because you can automate the scaffolding process and verify the changes by running your tests.
+
+## Tips for handling model differences
+
+For various reasons, you may want your C# domain model to be shaped differently from the one generated in reverse engineering. In many cases, this means manually updating the code that is auto-generated after every schema change. One way to prevent extra effort when the code is regenerated is to use partial classes for your DbContext and related entities. Then you can keep code related to business logic and properties not tracked in the database in a separate set of class files that won't get overwritten.
+
+ If your model is significantly different from the generated one, but doesn't change frequently, one option to consider is use of the [repository pattern](/dotnet/architecture/microservices/microservice-ddd-cqrs-patterns/infrastructure-persistence-layer-design) as an adapter. The repository can consume the EF Core generated classes and publish the custom classes you use. This may reduce the impact of changes by isolating them to the repository code, rather than having to perform an application-wide refactoring each time the schema changes.
+
+You may want to consider an alternate workflow and follow steps similar to the [hybrid approach](xref:efcore-and-ef6/porting/port-hybrid). Instead of generating a new set of classes each time, you indicate specific tables to only generate new classes. You keep existing classes "as is" and directly add or remove properties that changed. You then update the model configuration to address any changes in how the database maps to your existing classes.
+
+## Customize the code generation
+
+EF Core 6 currently does not support customization of the generated code. There are third party solutions like [EF Core Power Tools](https://github.com/ErikEJ/EFCorePowerTools/wiki) that are available. For a list of featured community tools and extensions, see: [EF Core Tools and Extensions](xref:core/extensions/index).
+
+Finally, review the [detailed list of differences between EF6 and EF Core](xref:efcore-and-ef6/porting/port-detailed-cases) to address any remaining issues with porting.
diff --git a/entity-framework/efcore-and-ef6/porting/port-detailed-cases.md b/entity-framework/efcore-and-ef6/porting/port-detailed-cases.md
new file mode 100644
index 0000000000..50a0a9aa22
--- /dev/null
+++ b/entity-framework/efcore-and-ef6/porting/port-detailed-cases.md
@@ -0,0 +1,161 @@
+---
+title: Port from EF6 to EF Core - Detailed Cases
+description: Guide to solutions, fixes, and workarounds for common issues that come up during the port from EF 6 to EF Core.
+author: jeremylikness
+ms.alias: jeliknes
+ms.date: 12/09/2021
+uid: efcore-and-ef6/porting/port-detailed-cases
+---
+# Detailed Cases for Porting from EF6 to EF Core
+
+This document details some specific differences between EF6 and EF Core. Consult this guide when porting your code.
+
+## Configuring the database connection
+
+There are several differences between how EF6 connects to various data sources compared to EF Core. They are important to understand when you port your code.
+
+- **Connection strings**: EF Core does not directly support multiple constructor overloads for different connection strings as EF6 does. Instead, it relies on [DbContextOptions](xref:core/dbcontext-configuration/index#dbcontextoptions). You can still provide multiple constructor overloads in derived types, but will need to map connections through the options.
+- **Configuration and cache**: EF Core supports a more robust and flexible implementation of dependency injection with an internal infrastructure that can connect to external service providers. This can be managed by the application to handle situations when the caches must be flushed. The EF6 version was limited and could not be flushed.
+- **Configuration files**: EF6 supports configuration via config files that can include the provider. EF Core requires a direct reference to the provider assembly and explicit provider registration (i.e. `UseSqlServer`).
+- **Connection factories**: EF6 supported connection factories. EF Core does not support connection factories and always requires a connection string.
+- **Logging**: in general, [logging in EF Core](xref:core/logging-events-diagnostics/index) is far more robust and has multiple options for fine-tuned configuration.
+
+## Conventions
+
+EF6 supported custom ("lightweight") conventions and model conventions. The lightweight conventions are similar to EF Core's [pre-convention model configuration](xref:core/what-is-new/ef-core-6.0/whatsnew#pre-convention-model-configuration). Other conventions are supported as part of model building.
+
+EF6 runs conventions after the model is built. EF Core applies them as the model is being built. In EF Core, you can decouple model building from active sessions with a DbContext. It is possible to create a model initialized with the conventions.
+
+## Data validation
+
+EF Core does not support data validation and only uses data annotations for building the model and migrations. Most client libraries from web/MVC to WinForms and WPF provide a data validation implementation to use.
+
+## Features that are coming soon
+
+There are a few features in EF6 that don't exist yet in EF Core, but are on the product roadmap.
+
+- **Table-per-concrete type (TPC)** was supported in EF6 along with "entity splitting." TPC is on the roadmap for EF7.
+- **Stored procedure mapping** in EF6 allows you to delegate create, update, and delete operations to stored procedures. EF Core currently only allows mapping to stored procedures for reads. Create, update, and delete (CUD) support is on the roadmap for EF7.
+- **Complex types** in EF6 are similar to owned types in EF Core. However, the full set of capabilities will be addressed with value objects in EF7.
+
+## Leave ObjectContext behind
+
+EF Core uses a [DbContext](xref:core/dbcontext-configuration/index) instead of an `ObjectContext`. You will have to update code that uses [IObjectContextAdapter](xref:System.Data.Entity.Infrastructure.IObjectContextAdapter). This was sometimes used for queries with `PreserveChanges` or `OverwriteChanges` merge option. For similar capabilities in EF Core, look into the [Reload](xref:Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntry.Reload) method.
+
+## Model configuration
+
+There are many important differences between how models in EF6 and EF Core are designed. EF Core lacks full support for conditional mapping. It does not have model builder versions.
+
+Other differences include:
+
+### Type discovery
+
+In EF Core, Entity Types are discovered by the engine in three ways:
+
+- Expose a `DbSet<TEntity>` on your `DbContext` where `TEntity` is the type you wish to track.
+- Reference a `Set<TEntity>` from somewhere in your code.
+- Complex types referenced by discovered types are recursively discovered (for example, if your `Blog` references a `Post` and `Blog` is discoverable, `Post` will be discovered as well)
+
+Assemblies are _not_ scanned for derived types.
+
+### Mapping
+
+The `.Map()` extension in EF6 has been replaced with overloads and extension methods in EF Core. For example, you can use '.HasDiscriminator()` to configure table-per-hierarchy (TPH). See: [Modeling Inheritance](xref:core/modeling/inheritance).
+
+### Inheritance mapping
+
+EF6 supported table-per-hierarchy (TPH), table-per-type (TPT) and table-per-concrete-class (TPC) and enabled hybrid mapping of different flavors at different levels of the hierarchy. EF Core will continue to require an inheritance chain to modeled one way (TPT or TPH) and the plan is to add support for TPC in EF7.
+
+See: [Modeling Inheritance](xref:core/modeling/inheritance).
+
+### Attributes
+
+EF6 supported index attributes on properties. In EF Core, they are applied at the type level which should make it easier for scenarios that require composite indexes. EF Core doesn't support composite keys with data annotations (i.e. using Order in `ColumnAttribute` together with `KeyAttribute`).
+
+For more information, see: [Indexes and constraints](xref:core/modeling/indexes).
+
+### Required and optional
+
+In EF Core model-building, `IsRequired` only configures the what is required on the principal end. `HasForeignKey` now configures the principal end. To port your code, it will be more straightforward to use `.Navigation().IsRequired()` instead. For example:
+
+**EF6:**
+
+```csharp
+modelBuilder.Entity<Instructor>()
+    .HasRequired(t => t.OfficeAssignment)
+    .WithRequiredPrincipal(t => t.Instructor);
+```
+
+**EF Core 6:**
+
+```csharp
+modelBuilder.Entity<Instructor>()
+    .HasOne(t => t.OfficeAssignment)
+    .WithOne(t => t.Instructor)
+    .HasForeignKey<OfficeAssignment>();
+
+modelBuilder.Entity<Instructor>()
+    .Navigation(t => t.OfficeAssignment)
+    .IsRequired();
+
+modelBuilder.Entity<OfficeAssignment>()
+    .Navigation(t => t.Instructor)
+    .IsRequired();
+```
+
+By default everything is optional, so usually it's not necessary to call `.IsRequired(false)`.
+
+### Spatial support
+
+EF Core integrates with the third-party library community library [NetTopologySuite](https://github.com/NetTopologySuite/NetTopologySuite) to provide spatial support.
+
+### Independent associations
+
+EF Core does not support independent associations (an EDM concept that allows the relationship between two entities to be defined independent from the entities themselves). A similar concept supported in EF Core is [shadow properties](xref:core/modeling/shadow-properties).
+
+## Migrations
+
+EF Core does not support database initializers or automatic migrations. Although there is no `migrate.exe` in EF Core, you can produce [migration bundles](xref:core/what-is-new/ef-core-6.0/whatsnew#migration-bundles).
+
+## Visual Studio Tooling
+
+EF Core has no designer, no functionality to update the model from the database and no model-first flow. There is no reverse-engineering wizard and no built-in templates.
+
+Although these features do not ship with EF Core, there are OSS community projects that provide additional tooling. Specifically, [EF Core Power Tools](https://github.com/ErikEJ/EFCorePowerTools) provides:
+
+- Reverse engineering from inside Visual Studio with support for database projects (`.dacpac`). Includes template-based code customizations.
+- Visual inspection of DbContext with model graphing and scripting.
+- Management of migrations from within Visual Studio using a GUI.
+
+For a complete list of community tools and extensions, see: [EF Core Tools and Extensions](xref:core/extensions/index).
+
+## Change tracking
+
+There are several differences between how EF6 and EF Core deal with change tracking. These are summarized in the following table:
+
+|Feature|EF6|EF Core|
+|---|---|---|
+|Entity State|Adds/attaches entire graph|Supports navigations to detached entities|
+|Orphans|Preserved|Deleted|
+|Disconnected, self-tracking entities|Supported|Not supported|
+|Mutations|Performed on properties|Performed on backing fields*|
+|Data-binding|`.Local`|`.Local` plus `.ToObservableCollection` or `.ToBindingList`|
+|Change detection|Full graph|Per entity|
+
+\* By default, property notification will not be triggered in EF Core so it's important to [configure notification entities](xref:core/change-tracking/change-detection#notification-entities).
+
+Note that EF Core does not call change detection automatically as often as EF6.
+
+EF Core introduces a detailed `DebugView` for the change tracker. To learn more, read [Change Tracker Debugging](xref:core/change-tracking/debug-views).
+
+## Queries
+
+EF6 has some query capabilities that do not exist in EF Core. These include:
+
+- Some common C# function and SQL function mappings.
+- Interception of the command tree for queries and updates.
+- Support for table-valued parameters (TVPs).
+
+EF6 has built-in support for lazy-loading proxies. This is an opt-in package for EF Core (see [Lazy Loading of Related Data](xref:core/querying/related-data/lazy)).
+
+EF Core allows you to compose over raw SQL using `FromSQL`.
diff --git a/entity-framework/efcore-and-ef6/porting/port-edmx.md b/entity-framework/efcore-and-ef6/porting/port-edmx.md
new file mode 100644
index 0000000000..efea705272
--- /dev/null
+++ b/entity-framework/efcore-and-ef6/porting/port-edmx.md
@@ -0,0 +1,52 @@
+---
+title: Porting from EF6 to EF Core - Porting an EDMX-Based Model - EF
+description: Specific information on porting an Entity Framework 6 EDMX-based model application to Entity Framework Core
+author: SamMonoRT
+ms.date: 12/09/2021
+uid: efcore-and-ef6/porting/port-edmx
+---
+# Porting an EF6 EDMX-Based Model to EF Core
+
+EF Core does not support the EDMX file format for models. The best option to port these models, is to generate a new code-based model from the database for your application.
+
+## Install EF Core NuGet packages
+
+Install the `Microsoft.EntityFrameworkCore.Tools` NuGet package.
+
+## Regenerate the model
+
+You can now use the reverse engineer functionality to create a model based on your existing database.
+
+Run the following command in Package Manager Console (Tools –> NuGet Package Manager –> Package Manager Console). See [Package Manager Console (Visual Studio)](xref:core/cli/powershell) for command options to scaffold a subset of tables etc.
+
+```powershell
+Scaffold-DbContext "<connection string>" <database provider name>
+```
+
+For example, here is the command to scaffold a model from the Blogging database on your SQL Server LocalDB instance.
+
+```powershell
+Scaffold-DbContext "Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;" Microsoft.EntityFrameworkCore.SqlServer
+```
+
+## Remove EF6 model
+
+You would now remove the EF6 model from your application.
+
+It is fine to leave the EF6 NuGet package (EntityFramework) installed, as EF Core and EF6 can be used side-by-side in the same application. However, if you aren't intending to use EF6 in any areas of your application, then uninstalling the package will help focus compiler errors on pieces of code that need attention.
+
+## Update your code
+
+At this point, it's a matter of addressing compilation errors and reviewing code to see if the behavior changes between EF6 and EF Core will impact you.
+
+## Test the port
+
+Just because your application compiles, does not mean it is successfully ported to EF Core. You will need to test all areas of your application to ensure that none of the behavior changes have adversely impacted your application.
+
+## Other considerations
+
+EF Core does not support the `EntityClient` provider and therefore any [EntitySQL](/dotnet/framework/data/adonet/ef/language-reference/entity-sql-language) queries must be migrated to LINQ or `FromRawSql`.
+
+Furthermore, there is no support for [EntityClient connection strings](xref:ef6/fundamentals/configuring/connection-strings#databasemodel-first-with-connection-string-in-appconfigwebconfig-file).
+
+For more considerations, read the complete guide to [differences between EF6 and EF Core](xref:efcore-and-ef6/porting/port-detailed-cases).
diff --git a/entity-framework/efcore-and-ef6/porting/port-hybrid.md b/entity-framework/efcore-and-ef6/porting/port-hybrid.md
new file mode 100644
index 0000000000..0152f45f70
--- /dev/null
+++ b/entity-framework/efcore-and-ef6/porting/port-hybrid.md
@@ -0,0 +1,18 @@
+---
+title: Port from EF6 to EF Core - Hybrid Approach
+description: How to port from EF6 to EF Core when you iterate your domain model and database separately and use mapping to connect the two.
+author: jeremylikness
+ms.alias: jeliknes
+ms.date: 12/09/2021
+uid: efcore-and-ef6/porting/port-hybrid
+---
+
+# Port from EF6 to EF Core - the Hybrid Approach
+
+Two common approaches are to generate your database from code and use migrations, or generate your entities from the database using reverse-engineering. In the hybrid approach, you don't generate anything. Instead, you let the database and codebase evolve and use model configuration to keep the two in sync. This page contains some tips for success using the hybrid approach:
+
+1. First, read the guides for [code as source of truth](xref:efcore-and-ef6/porting/port-code) and [database as source of truth](xref:efcore-and-ef6/porting/port-database) to familiarize yourself with some of the considerations to be aware of.
+1. Because you won't be using migrations, there is no need to model sequences, non-primary indexes, constraints and index filters.
+1. An integration test suite is valuable in this approach for validating a proper handoff between code and the database as the code and database evolve.
+1. One approach to test that your mappings are correct is to generate a dummy database using a "throwaway" migration, then use a tool to compare the generated database to the actual database. You can quickly flag differences in schema and act on them.
+1. If you prefer, you can consider generating partial classes from the database and use extensions to those classes to configure your custom code.
diff --git a/entity-framework/efcore-and-ef6/side-by-side.md b/entity-framework/efcore-and-ef6/side-by-side.md
new file mode 100644
index 0000000000..6e0271f1cc
--- /dev/null
+++ b/entity-framework/efcore-and-ef6/side-by-side.md
@@ -0,0 +1,19 @@
+---
+title: EF6 and EF Core - Using them in the Same Application
+description: Guidance on using both Entity Framework Core and Entity Framework 6 in the same application
+author: SamMonoRT
+ms.date: 01/23/2019
+uid: efcore-and-ef6/side-by-side
+---
+# Using EF Core and EF6 in the Same Application
+
+It is possible to use EF Core and EF6 in the same application or library by installing both NuGet packages.
+
+Some types have the same names in EF Core and EF6 and differ only by namespace, which may complicate using both EF Core and EF6 in the same code file. The ambiguity can be easily removed using namespace alias directives. For example:
+
+```csharp
+using Microsoft.EntityFrameworkCore; // use DbContext for EF Core
+using EF6 = System.Data.Entity; // use EF6.DbContext for the EF6 version
+```
+
+If you are porting an existing application that has multiple EF models, you can choose to selectively port some of them to EF Core, and continue using EF6 for the others.
diff --git a/entity-framework/efcore-and-ef6/support.md b/entity-framework/efcore-and-ef6/support.md
new file mode 100644
index 0000000000..a7e895f282
--- /dev/null
+++ b/entity-framework/efcore-and-ef6/support.md
@@ -0,0 +1,49 @@
+---
+title: Entity Framework Support Policies
+description: Support policies for every evolution of Entity Framework
+author: SamMonoRT
+ms.date: 05/22/2024
+uid: efcore-and-ef6/support
+---
+
+# Entity Framework Support Policies
+
+Entity Framework was first released in 2008 as part of the .NET Framework. Since then it has gone through several evolutions:
+
+- The first version of Entity Framework and Entity Framework 4 are fully contained in the .NET Framework
+- Entity Framework 4.1, 4.2, 4.3, and 5.0 have some code in the .NET Framework, and some code shipped as NuGet packages
+- Entity Framework 6.0, 6.1, 6.2, 6.3, 6.4, and 6.5 are shipped entirely as NuGet packages
+- Entity Framework Core (all versions) is an entirely separate codebase and ships as NuGet packages
+
+Support policies for each of these variations is described in this document. In all cases, the support policy applies to the latest patch of the given versions.
+
+## Entity Framework Core
+
+New versions of Entity Framework Core are shipped at the same time as new .NET versions. The Entity Framework Core support policy aligns with the [.NET support policy](https://dotnet.microsoft.com/platform/support/policy/dotnet-core). See [current and planned releases](xref:core/what-is-new/index) for more information.
+
+Entity Framework Core is the only actively developed version of Entity Framework and we recommend using it for all new code.
+
+## Entity Framework 6.0, 6.1, 6.2, 6.3, 6.4, and 6.5
+
+Entity Framework 6.x follows the [Modern Lifecycle Policy](/lifecycle/policies/modern). This means that only the latest patch of the latest released version is supported. At this time the latest version is 6.5. This version can always [be found on NuGet](https://www.nuget.org/packages/EntityFramework/).
+Versions 6.0, 6.1, 6.2, 6.3, and 6.4 are no longer supported.
+
+Although Entity Framework 6.x is still supported, it is no longer being developed and will only receive fixes for security issues. The Entity Framework 6.x codebase is very stable, and it is a priority to preserve this stability by not making any unnecessary changes to the code. It is strongly encouraged that new applications and existing applications that are in active development [use Entity Framework Core](xref:efcore-and-ef6/index).
+
+Microsoft will provide a minimum of 12 months notification prior to ending support for Entity Framework 6. There are currently no plans to end support.
+
+## Entity Framework 4.1, 4.2, 4.3, and 5.0
+
+> [!WARNING]
+> Entity Framework 4.1, 4.2, 4.3, and 5.0 and all patches of these versions are out-of-support and should not be used.
+The NuGet packages for Entity Framework 4.1, 4.2, 4.3, and 5.0 are no longer supported. Applications using these versions should be updated to use Entity Framework 6, or [ported to use Entity Framework Core](xref:efcore-and-ef6/porting/index).
+
+Some of the code for Entity Framework 4.x and 5.0 is contained in the .NET Framework. As such, this code is supported as long as [.NET Framework is supported](/lifecycle/products/microsoft-net-framework). However, note that this code is intended to be used in conjunction with the NuGet packages for these Entity Framework versions. The .NET Framework code should not be used independently.
+
+## Entity Framework 1 and 4
+
+> [!WARNING]
+> Entity Framework 1 and 4 are considered legacy and should not be used.
+The first version of Entity Framework and Entity Framework 4 are fully contained in the .NET Framework. As such, these versions contained in the .NET Framework are supported as a part of the .NET Framework as long as [.NET Framework is supported](/lifecycle/products/microsoft-net-framework). However, only security bugs will be fixed. These versions are legacy code and should not be used.
+
+Applications using these versions should be updated to use Entity Framework 6, or [ported to use Entity Framework Core](xref:efcore-and-ef6/porting/index).
diff --git a/entity-framework/index.yml b/entity-framework/index.yml
new file mode 100644
index 0000000000..dceb7a7fe0
--- /dev/null
+++ b/entity-framework/index.yml
@@ -0,0 +1,221 @@
+### YamlMime:Hub
+
+title: Entity Framework documentation hub 
+summary: Entity Framework is a modern object-relation mapper that lets you build a clean, portable, and high-level data access layer with .NET (C#) across a variety of databases, including SQL Database (on-premises and Azure), SQLite, MySQL, PostgreSQL, and Azure Cosmos DB. It supports LINQ queries, change tracking, updates, and schema migrations.
+brand: dotnet
+
+metadata:
+  title: Entity Framework documentation hub
+  description: Entity Framework is a modern object-relation mapper that lets you build a clean, portable, and high-level data access layer with .NET (C#) across a variety of databases, including SQL Database (on-premises and Azure), SQLite, MySQL, PostgreSQL, and Azure Cosmos DB. It supports LINQ queries, change tracking, updates, and schema migrations.
+  ms.topic: hub-page
+  author: jcjiang
+  ms.date: 03/08/2023
+
+# highlightedContent section (optional)
+# Maximum of 8 items
+highlightedContent:
+# itemType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | video | whats-new
+  items:
+    # Card
+    - title: "Tutorial: Access a relational database using C# (Entity Framework Core)"
+      itemType: get-started
+      url: core/get-started/overview/first-app.md
+    # Card
+    - title: "Supported database management systems"
+      itemType: overview
+      url: core/providers/index.md
+    # Card
+    - title: "Which version should I use - EF Core or EF 6?"
+      itemType: overview
+      url: efcore-and-ef6/index.md
+    # Card
+    - title: "API reference browser"
+      itemType: reference
+      url: /dotnet/api/?view=efcore-8.0&preserve-view=true
+    # Card
+    - title: ".NET (C#) data documentation hub"
+      itemType: reference
+      url: dotnet-data/index.yml
+    # Card
+    - title: "Releases and platforms"
+      itemType: whats-new
+      url: core/what-is-new/index.md
+
+# Card with summary style
+additionalContent:
+  # Supports up to 3 sections
+  sections:
+    - title: Develop with Entity Framework Core # < 60 chars (optional)
+      items:
+      # Card
+      - title: Develop your first app
+        links:
+          - url: /training/modules/persist-data-ef-core/
+            text: "Hands-on Training (44 minutes): Persist and retrieve relational data by using Entity Framework Core"
+          - url: core/get-started/overview/first-app.md
+            text: ".NET Core console app accessing SQLite with EF Core"
+          - url: /aspnet/core/data/ef-rp/
+            text: "ASP.NET Core Razor Pages web app accessing  SQL Server LocalDB or SQLite with EF Core"
+          - url: /aspnet/core/data/ef-mvc/
+            text: "ASP.NET Core MVC web app accessing SQL Server with EF Core"
+          - url: core/get-started/wpf.md
+            text: "WPF .NET Core app accessing SQLite with EF Core"
+          - url: core/get-started/winforms.md
+            text: "Windows Forms .NET Core app accessing SQLite with EF Core"
+      # Card
+      - title: Supported databases
+        links:
+          - url: core/providers/sql-server/index.md
+            text: "SQL Server"
+          - url: core/providers/sqlite/index.md
+            text: "SQLite"
+          - url: http://www.npgsql.org/efcore/index.html
+            text: "PostgreSQL"
+          - url: https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql
+            text: "MySQL and MariaDB"
+          - url: core/providers/cosmos/index.md
+            text: "Azure Cosmos DB for NoSQL"
+          - url: https://www.mongodb.com/docs/entity-framework/current/
+            text: "MongoDB"            
+          - url: https://github.com/FirebirdSQL/NETProvider
+            text: "Firebird"
+          - url: core/providers/in-memory/index.md
+            text: "In memory (testing)"
+          - url: core/providers/index.md
+            text: "All current Database Providers"
+      # Card
+      - title: Platforms
+        links:
+          - url: core/miscellaneous/platforms.md
+            text: "All supported platforms"
+          - url: /aspnet/core/data/ef-rp/intro
+            text: "ASP.NET Core Razor Pages"
+          - url: /aspnet/core/data/ef-mvc/
+            text: "ASP.NET Core MVC"
+          - url: /aspnet/core/blazor/blazor-server-ef-core
+            text: "Blazor Server"
+          - url: core/get-started/wpf.md
+            text: "Windows Presentation Foundation (WPF)"
+          - url: core/get-started/winforms.md
+            text: "Windows Forms (WinForms)"
+      # Card
+      - title: Fundamentals
+        links:
+          - url: core/miscellaneous/connection-strings.md
+            text: "Connection strings"
+          - url: core/logging-events-diagnostics/index.md
+            text: "Logging"
+          - url: core/miscellaneous/connection-resiliency.md
+            text: "Connection resiliency"
+          - url: core/testing/index.md
+            text: "Testing"
+          - url: core/dbcontext-configuration/index.md
+            text: "Configure a DbContext"
+          - url: core/miscellaneous/nullable-reference-types.md
+            text: "Nullable reference types"
+          - url: core/miscellaneous/collations-and-case-sensitivity.md
+            text: "Collations and case sensitivity"
+      # Card
+      - title: Create a model
+        links:
+          - url: core/modeling/index.md
+            text: "Overview"
+          - url: core/modeling/entity-types.md
+            text: "Entity types"
+          - url: core/modeling/entity-properties.md
+            text: "Entity properties"
+          - url: core/modeling/keys.md
+            text: "Keys"
+          - url: core/modeling/generated-properties.md
+            text: "Generated values"
+          - url: core/modeling/relationships.md
+            text: "Relationships"
+          - url: core/modeling/data-seeding.md
+            text: "Data seeding"
+          - url: core/modeling/owned-entities.md
+            text: "Owned entity types"
+          - url: core/modeling/keyless-entity-types.md
+            text: "Keyless entity types"
+      # Card
+      - title: Query
+        links:
+          - url: core/querying/index.md
+            text: "Overview"
+          - url: core/querying/client-eval.md
+            text: "Client vs. server evaluation"
+          - url: core/querying/tracking.md
+            text: "Tracking vs. no-tracking"
+          - url: core/querying/complex-query-operators.md
+            text: "Complex query operators"
+          - url: core/querying/related-data/index.md
+            text: "Load related data"
+          - url: core/querying/async.md
+            text: "Asynchronous queries"
+          - url: core/querying/raw-sql.md
+            text: "Raw SQL queries"
+          - url: core/querying/user-defined-function-mapping.md
+            text: "User-defined function mapping"
+          - url: core/querying/filters.md
+            text: "Global query filters"
+          - url: core/querying/null-comparisons.md
+            text: "Comparisons with null values in queries"
+      # Card
+      - title: Manage database schemas
+        links:
+          - url: core/managing-schemas/index.md
+            text: "Overview"
+          - url: core/managing-schemas/migrations/index.md
+            text: "Migration overview"
+          - url: core/managing-schemas/migrations/teams.md
+            text: "Migration of team environments"
+          - url: core/managing-schemas/migrations/operations.md
+            text: "Migration - custom  operations"
+          - url: core/managing-schemas/migrations/projects.md
+            text: "Migration - Use a separate project"
+          - url: core/managing-schemas/migrations/providers.md
+            text: "Migration - multiple providers"
+          - url: core/managing-schemas/migrations/history-table.md
+            text: "Migration - custom history table"
+          - url: core/managing-schemas/ensure-created.md
+            text: "Create and drop APIs"
+          - url: core/managing-schemas/scaffolding/index.md
+            text: "Reverse engineering (scaffolding)"
+      # Card
+      - title: Save data
+        links:
+          - url: core/saving/index.md
+            text: "Overview"
+          - url: core/saving/basic.md
+            text: "Basic save"
+          - url: core/saving/related-data.md
+            text: "Related data"
+          - url: core/saving/cascade-delete.md
+            text: "Cascade delete"
+          - url: core/saving/concurrency.md
+            text: "Concurrency conflicts"
+          - url: core/saving/transactions.md
+            text: "Transactions"
+          - url: core/saving/async.md
+            text: "Asynchronous saving"
+          - url: core/saving/disconnected-entities.md
+            text: "Disconnected entities"
+      # Card
+      - title: Command-line reference
+        links:
+          - url: core/cli/index.md
+            text: "Overview"
+          - url: core/cli/powershell.md
+            text: "Package Manager Console (Visual Studio)"
+          - url: core/cli/dotnet.md
+            text: ".NET Core CLI"
+          - url: core/cli/dbcontext-creation.md
+            text: "Design-time DbContext creation"
+          - url: core/cli/services.md
+            text: "Design-time services"
+      # Card
+      - title: Previous versions
+        links:
+          - url: ef6/get-started.md
+            text: "Entity Framework 6"
+  # footer (optional)
+  footer: "Contribute to Entity Framework docs. Read our [contributor guide](https://github.com/dotnet/EntityFramework.Docs/blob/main/CONTRIBUTING.md)."
diff --git a/entity-framework/toc.yml b/entity-framework/toc.yml
new file mode 100644
index 0000000000..c52a89e4ce
--- /dev/null
+++ b/entity-framework/toc.yml
@@ -0,0 +1,806 @@
+- name: .NET data
+  href: dotnet-data/index.yml
+- name: Entity Framework
+  href: index.yml
+  items:
+  - name: EF Core & EF6
+    items:
+    - name: Entity Framework Support Policies
+      href: efcore-and-ef6/support.md
+    - name: Compare EF Core & EF6
+      href: efcore-and-ef6/index.md
+    - name: Port from EF6 to EF Core
+      items:
+      - name: Overview
+        href: efcore-and-ef6/porting/index.md
+      - name: Porting an EDMX-based model
+        href: efcore-and-ef6/porting/port-edmx.md
+      - name: Porting a Code-based model
+        href: efcore-and-ef6/porting/port-code.md
+      - name: Porting a Database-first project
+        href: efcore-and-ef6/porting/port-database.md
+      - name: Porting to a hybrid model
+        href: efcore-and-ef6/porting/port-hybrid.md
+      - name: Behavior Changes between EF6 and EF Core
+        href: efcore-and-ef6/porting/port-behavior.md
+      - name: Detailed cases to consider when Porting
+        href: efcore-and-ef6/porting/port-detailed-cases.md
+    - name: Use EF6 and EF Core in the same application
+      href: efcore-and-ef6/side-by-side.md
+
+  - name: Entity Framework Core
+    items:
+    - name: Welcome!
+      href: core/index.md
+    - name: "What's new in EF Core 10.0"
+      href: core/what-is-new/ef-core-10.0/whatsnew.md
+    - name: "Breaking changes in EF Core 10.0"
+      href: core/what-is-new/ef-core-10.0/breaking-changes.md
+    - name: Getting started
+      items:
+      - name: EF Core Overview
+        items:
+        #- name: What is EF Core?
+        - name: Install EF Core
+          href: core/get-started/overview/install.md
+        - name: Your first EF Core App
+          href: core/get-started/overview/first-app.md
+        - name: NuGet packages
+          href: core/what-is-new/nuget-packages.md
+      - name: ASP.NET Core tutorial >>
+        href: /aspnet/core/data/ef-rp/intro
+      - name: Blazor Server with EF Core guidance >>
+        href: /aspnet/core/blazor/blazor-server-ef-core
+      - name: WPF .NET Core tutorial
+        href: core/get-started/wpf.md
+      - name: Windows Forms tutorial
+        href: core/get-started/winforms.md
+    - name: "Releases and planning (roadmap)"
+      items:
+      - name: Current and planned releases
+        href: core/what-is-new/index.md
+      - name: Release planning process
+        href: core/what-is-new/release-planning.md
+      - name: EF Core 11.0
+        items:
+          - name: "What's new?"
+            href: core/what-is-new/ef-core-11.0/whatsnew.md
+          - name: Breaking changes
+            href: core/what-is-new/ef-core-11.0/breaking-changes.md
+          - name: Provider-facing changes
+            href: core/what-is-new/ef-core-11.0/provider-facing-changes.md
+      - name: EF Core 10.0
+        items:
+          - name: "What's new?"
+            href: core/what-is-new/ef-core-10.0/whatsnew.md
+          - name: Breaking changes
+            href: core/what-is-new/ef-core-10.0/breaking-changes.md
+      - name: EF Core 9.0
+        items:
+          - name: "What's new?"
+            href: core/what-is-new/ef-core-9.0/whatsnew.md
+          - name: Breaking changes
+            href: core/what-is-new/ef-core-9.0/breaking-changes.md
+      - name: EF Core 8.0
+        items:
+          - name: "What's new?"
+            href: core/what-is-new/ef-core-8.0/whatsnew.md
+          - name: Breaking changes
+            href: core/what-is-new/ef-core-8.0/breaking-changes.md
+          - name: High-level plan
+            href: core/what-is-new/ef-core-8.0/plan.md
+      - name: Out of support
+        items:
+        - name: EF Core 7.0
+          items:
+            - name: "What's new?"
+              href: core/what-is-new/ef-core-7.0/whatsnew.md
+            - name: Breaking changes
+              href: core/what-is-new/ef-core-7.0/breaking-changes.md
+            - name: High-level plan
+              href: core/what-is-new/ef-core-7.0/plan.md
+        - name: EF Core 6.0
+          items:
+            - name: "What's new?"
+              href: core/what-is-new/ef-core-6.0/whatsnew.md
+            - name: Breaking changes
+              href: core/what-is-new/ef-core-6.0/breaking-changes.md
+            - name: High-level plan
+              href: core/what-is-new/ef-core-6.0/plan.md
+        - name: EF Core 5.0
+          items:
+            - name: "What's new?"
+              href: core/what-is-new/ef-core-5.0/whatsnew.md
+            - name: Breaking changes
+              href: core/what-is-new/ef-core-5.0/breaking-changes.md
+            - name: High-level plan
+              href: core/what-is-new/ef-core-5.0/plan.md
+        - name: EF Core 3.1
+          items:
+            - name: New features
+              href: core/what-is-new/ef-core-3.x/index.md
+            - name: Breaking changes
+              href: core/what-is-new/ef-core-3.x/breaking-changes.md
+        - name: EF Core 3.0
+          href: core/what-is-new/ef-core-3.0.md
+        - name: EF Core 2.2
+          href: core/what-is-new/ef-core-2.2.md
+        - name: EF Core 2.1
+          href: core/what-is-new/ef-core-2.1.md
+        - name: EF Core 2.0
+          items:
+            - name: New features
+              href: core/what-is-new/ef-core-2.0/index.md
+            - name: Upgrade from 1.x
+              href: core/what-is-new/ef-core-2.0/upgrade.md
+        - name: EF Core 1.1
+          href: core/what-is-new/ef-core-1.1.md
+        - name: EF Core 1.0
+          href: core/what-is-new/ef-core-1.0.md
+
+    - name: DbContext configuration and initialization
+      items:
+      - name: Overview
+        href: core/dbcontext-configuration/index.md
+      - name: Context pooling
+        href: core/performance/advanced-performance-topics.md#dbcontext-pooling
+
+    - name: Create a model
+      items:
+      - name: Overview
+        href: core/modeling/index.md
+      - name: Entity types
+        href: core/modeling/entity-types.md
+      - name: Entity properties
+        href: core/modeling/entity-properties.md
+      - name: Keys
+        href: core/modeling/keys.md
+      - name: Generated values
+        href: core/modeling/generated-properties.md
+      - name: Shadow and indexer properties
+        href: core/modeling/shadow-properties.md
+      - name: Relationships
+        items:
+        - name: Overview
+          href: core/modeling/relationships.md
+        - name: One-to-many
+          href: core/modeling/relationships/one-to-many.md
+        - name: One-to-one
+          href: core/modeling/relationships/one-to-one.md
+        - name: Many-to-many
+          href: core/modeling/relationships/many-to-many.md
+        - name: Foreign and principal keys
+          href: core/modeling/relationships/foreign-and-principal-keys.md
+        - name: Navigations
+          href: core/modeling/relationships/navigations.md
+        - name: Conventions
+          href: core/modeling/relationships/conventions.md
+        - name: Mapping attributes
+          href: core/modeling/relationships/mapping-attributes.md
+        - name: Glossary
+          href: core/modeling/relationships/glossary.md
+      - name: Indexes and constraints
+        href: core/modeling/indexes.md
+      - name: Inheritance
+        href: core/modeling/inheritance.md
+      - name: Sequences
+        href: core/modeling/sequences.md
+      - name: Backing fields
+        href: core/modeling/backing-field.md
+      - name: Value conversions
+        href: core/modeling/value-conversions.md
+      - name: Value comparers
+        href: core/modeling/value-comparers.md
+      - name: Data seeding
+        href: core/modeling/data-seeding.md
+      - name: Entity type constructors
+        href: core/modeling/constructors.md
+      - name: Advanced table mapping
+        href: core/modeling/table-splitting.md
+      - name: Owned entity types
+        href: core/modeling/owned-entities.md
+      - name: Keyless entity types
+        href: core/modeling/keyless-entity-types.md
+      - name: Spatial data
+        displayName: GIS
+        href: core/modeling/spatial.md
+      - name: Bulk configuration
+        href: core/modeling/bulk-configuration.md
+      - name: Alternating models with same DbContext
+        href: core/modeling/dynamic-model.md
+
+    - name: Manage database schemas
+      items:
+      - name: Overview
+        href: core/managing-schemas/index.md
+      - name: Migrations
+        items:
+        - name: Overview
+          href: core/managing-schemas/migrations/index.md
+        - name: Managing migrations
+          href: core/managing-schemas/migrations/managing.md
+        - name: Applying migrations
+          href: core/managing-schemas/migrations/applying.md
+        - name: Team environments
+          href: core/managing-schemas/migrations/teams.md
+        - name: Custom operations
+          href: core/managing-schemas/migrations/operations.md
+        - name: Use a separate project
+          href: core/managing-schemas/migrations/projects.md
+        - name: Multiple providers
+          href: core/managing-schemas/migrations/providers.md
+        - name: Custom history table
+          href: core/managing-schemas/migrations/history-table.md
+      - name: Create and drop APIs
+        href: core/managing-schemas/ensure-created.md
+      - name: Reverse engineering (scaffolding)
+        items:
+        - name: Overview
+          href: core/managing-schemas/scaffolding/index.md
+        - name: Custom templates
+          href: core/managing-schemas/scaffolding/templates.md
+
+    - name: Query data
+      items:
+      - name: Overview
+        href: core/querying/index.md
+      - name: Client vs. server evaluation
+        href: core/querying/client-eval.md
+      - name: Tracking vs. no-tracking
+        href: core/querying/tracking.md
+      - name: Load related data
+        items:
+          - name: Overview
+            href: core/querying/related-data/index.md
+          - name: Eager loading
+            href: core/querying/related-data/eager.md
+          - name: Explicit loading
+            href: core/querying/related-data/explicit.md
+          - name: Lazy loading
+            href: core/querying/related-data/lazy.md
+          - name: Related data and serialization
+            href: core/querying/related-data/serialization.md
+      - name: Split queries
+        href: core/querying/single-split-queries.md
+      - name: Complex query operators
+        href: core/querying/complex-query-operators.md
+      - name: Pagination
+        href: core/querying/pagination.md
+      - name: SQL queries
+        href: core/querying/sql-queries.md
+      - name: Database functions
+        href: core/querying/database-functions.md
+      - name: User-defined function mapping
+        href: core/querying/user-defined-function-mapping.md
+      - name: Global query filters
+        href: core/querying/filters.md
+      - name: Query tags
+        href: core/querying/tags.md
+      - name: Comparisons with null values in queries
+        href: core/querying/null-comparisons.md
+      - name: How queries work
+        href: core/querying/how-query-works.md
+
+    - name: Save data
+      items:
+      - name: Overview
+        href: core/saving/index.md
+      - name: Basic save
+        href: core/saving/basic.md
+      - name: Related data
+        href: core/saving/related-data.md
+      - name: Cascade delete
+        href: core/saving/cascade-delete.md
+      - name: Concurrency conflicts
+        href: core/saving/concurrency.md
+      - name: ExecuteUpdate and ExecuteDelete
+        href: core/saving/execute-insert-update-delete.md
+      - name: Transactions
+        href: core/saving/transactions.md
+      - name: Disconnected entities
+        href: core/saving/disconnected-entities.md
+
+    - name: Change tracking
+      items:
+      - name: Overview
+        href: core/change-tracking/index.md
+      - name: Explicitly tracking entities
+        href: core/change-tracking/explicit-tracking.md
+      - name: Accessing tracked entities
+        href: core/change-tracking/entity-entries.md
+      - name: Changing foreign keys and navigations
+        href: core/change-tracking/relationship-changes.md
+      - name: Change detection and notifications
+        href: core/change-tracking/change-detection.md
+      - name: Identity resolution
+        href: core/change-tracking/identity-resolution.md
+      - name: Additional change tracking features
+        href: core/change-tracking/miscellaneous.md
+      - name: Change tracker debugging
+        href: core/change-tracking/debug-views.md
+
+    - name: Logging, events, and diagnostics
+      items:
+      - name: Overview
+        href: core/logging-events-diagnostics/index.md
+      - name: Simple logging
+        href: core/logging-events-diagnostics/simple-logging.md
+      - name: Microsoft.Extensions.Logging
+        href: core/logging-events-diagnostics/extensions-logging.md
+      #- name: ToQueryString
+      - name: Events
+        href: core/logging-events-diagnostics/events.md
+      - name: Interceptors
+        href: core/logging-events-diagnostics/interceptors.md
+      - name: Diagnostic listeners
+        href: core/logging-events-diagnostics/diagnostic-listeners.md
+      #- name: Debug views
+      - name: Metrics
+        href: core/logging-events-diagnostics/metrics.md
+
+    - name: Testing
+      items:
+      - name: Introduction to testing
+        href: core/testing/index.md
+      - name: Choosing a testing strategy
+        href: core/testing/choosing-a-testing-strategy.md
+      - name: Testing against your production database system
+        href: core/testing/testing-with-the-database.md
+      - name: Testing without your production database system
+        href: core/testing/testing-without-the-database.md
+      - name: Advanced testing topics
+        href: core/testing/advanced-topics.md
+
+    - name: Performance
+      items:
+      - name: Introduction
+        href: core/performance/index.md
+      - name: Performance diagnosis
+        href: core/performance/performance-diagnosis.md
+      - name: Efficient querying
+        href: core/performance/efficient-querying.md
+      - name: Efficient updating
+        href: core/performance/efficient-updating.md
+      - name: Modeling for performance
+        href: core/performance/modeling-for-performance.md
+      - name: NativeAOT and precompiled queries
+        href: core/performance/nativeaot-and-precompiled-queries.md
+      - name: Advanced performance topics
+        href: core/performance/advanced-performance-topics.md
+
+    - name: Miscellaneous
+      items:
+      - name: Supported .NET implementations
+        href: core/miscellaneous/platforms.md
+      - name: Asynchronous programming
+        href: core/miscellaneous/async.md
+      - name: Nullable reference types
+        href: core/miscellaneous/nullable-reference-types.md
+      - name: Collations and case sensitivity
+        href: core/miscellaneous/collations-and-case-sensitivity.md
+      - name: Connection resiliency
+        href: core/miscellaneous/connection-resiliency.md
+      - name: Connection strings
+        href: core/miscellaneous/connection-strings.md
+      - name: Context pooling
+        href: core/miscellaneous/context-pooling.md
+      - name: Support multi-tenant databases
+        href: core/miscellaneous/multitenancy.md
+      - name: Plug-in APIs
+        href: core/miscellaneous/plugins.md
+      - name: EF Core Architecture
+        displayName: Internals
+        items:
+        - name: Overview
+          href: core/miscellaneous/internals/index.md
+        - name: Design-time tools
+          href: core/miscellaneous/internals/tools.md
+
+    - name: Database providers
+      items:
+      - name: Overview
+        href: core/providers/index.md
+      - name: Microsoft SQL Server and Azure SQL
+        items:
+        - name: Overview
+          href: core/providers/sql-server/index.md
+        - name: Function mappings
+          href: core/providers/sql-server/functions.md
+        - name: Columns
+          href: core/providers/sql-server/columns.md
+        - name: Indexes
+          href: core/providers/sql-server/indexes.md
+        - name: Value generation
+          href: core/providers/sql-server/value-generation.md
+        - name: Full-text search
+          href: core/providers/sql-server/full-text-search.md
+        - name: Vector search
+          href: core/providers/sql-server/vector-search.md
+        - name: Temporal tables
+          href: core/providers/sql-server/temporal-tables.md
+        - name: Memory-optimized tables
+          href: core/providers/sql-server/memory-optimized-tables.md
+        - name: Hierarchical data
+          href: core/providers/sql-server/hierarchyid.md
+        - name: Spatial data
+          displayName: GIS
+          href: core/providers/sql-server/spatial.md
+        - name: Miscellaneous
+          href: core/providers/sql-server/misc.md
+      - name: SQLite
+        items:
+        - name: Overview
+          href: core/providers/sqlite/index.md
+        - name: SQLite limitations
+          href: core/providers/sqlite/limitations.md
+        - name: Function mappings
+          href: core/providers/sqlite/functions.md
+        - name: Value generation
+          href: core/providers/sqlite/value-generation.md
+        - name: Spatial data
+          displayName: GIS
+          href: core/providers/sqlite/spatial.md
+        - name: Miscellaneous
+          href: core/providers/sqlite/misc.md
+        - name: Microsoft.Data.Sqlite >>
+          href: /dotnet/standard/data/sqlite/
+      - name: Azure Cosmos DB
+        items:
+        - name: Overview
+          href: core/providers/cosmos/index.md
+        - name: Modeling
+          href: core/providers/cosmos/modeling.md
+        - name: Querying
+          href: core/providers/cosmos/querying.md
+        - name: Saving data
+          href: core/providers/cosmos/saving.md
+        - name: Work with unstructured data
+          href: core/providers/cosmos/unstructured-data.md
+        - name: Vector search
+          href: core/providers/cosmos/vector-search.md
+        - name: Full text search
+          href: core/providers/cosmos/full-text-search.md
+        - name: Azure Cosmos DB limitations
+          href: core/providers/cosmos/limitations.md
+        - name: End-to-end sample
+          href: core/providers/cosmos/planetary-docs-sample.md
+      - name: In-memory (not recommended)
+        href: core/providers/in-memory/index.md
+      - name: Write a database provider
+        href: core/providers/writing-a-provider.md
+
+    - name: Tools & extensions
+      href: core/extensions/index.md
+
+    - name: Design-time tools reference
+      items:
+      - name: Overview
+        href: core/cli/index.md
+      - name: Package Manager Console (Visual Studio)
+        href: core/cli/powershell.md
+      - name: .NET Core CLI
+        href: core/cli/dotnet.md
+      - name: MSBuild Tasks
+        href: core/cli/msbuild.md
+      - name: Design-time DbContext creation
+        href: core/cli/dbcontext-creation.md
+      - name: Design-time services
+        href: core/cli/services.md
+
+    - name: Learn more
+      items:
+        - name: EF Core API reference >>
+          href: /dotnet/api/?view=efcore-9.0&preserve-view=true
+        - name: .NET Data Community Standups
+          href: core/learn-more/community-standups.md
+
+  - name: Entity Framework 6
+    items:
+    - name: Overview
+      href: ef6/index.md
+    - name: "What's new"
+      items:
+      - name: Overview
+        href: ef6/what-is-new/index.md
+      - name: Past releases
+        href: ef6/what-is-new/past-releases.md
+      - name: Upgrade to EF6
+        href: ef6/what-is-new/upgrading-to-ef6.md
+      - name: Visual Studio Releases
+        href: ef6/what-is-new/visual-studio.md
+      - name: Microsoft.Data.SqlClient support
+        href: ef6/what-is-new/microsoft-ef6-sqlserver.md
+    - name: Get started
+      href: ef6/get-started.md
+    - name: Fundamentals
+      items:
+      - name: Get Entity Framework
+        href: ef6/fundamentals/install.md
+      - name: Work with DbContext
+        href: ef6/fundamentals/working-with-dbcontext.md
+      - name: Understand relationships
+        href: ef6/fundamentals/relationships.md
+      - name: Async query & save
+        href: ef6/fundamentals/async.md
+      - name: Configuration
+        items:
+        - name: Code-based
+          href: ef6/fundamentals/configuring/code-based.md
+        - name: Config file
+          href: ef6/fundamentals/configuring/config-file.md
+        - name: Connection strings
+          href: ef6/fundamentals/configuring/connection-strings.md
+        - name: Dependency resolution
+          href: ef6/fundamentals/configuring/dependency-resolution.md
+      - name: Connection management
+        href: ef6/fundamentals/connection-management.md
+      - name: Connection resiliency
+        items:
+        - name: Retry logic
+          href: ef6/fundamentals/connection-resiliency/retry-logic.md
+        - name: Transaction commit failures
+          href: ef6/fundamentals/connection-resiliency/commit-failures.md
+      - name: Data binding
+        items:
+        - name: WinForms
+          href: ef6/fundamentals/databinding/winforms.md
+        - name: WPF
+          href: ef6/fundamentals/databinding/wpf.md
+      - name: Disconnected entities
+        items:
+        - name: Overview
+          href: ef6/fundamentals/disconnected-entities/index.md
+        - name: Self-tracking entities
+          items:
+          - name: Overview
+            href: ef6/fundamentals/disconnected-entities/self-tracking-entities/index.md
+          - name: Walkthrough
+            href: ef6/fundamentals/disconnected-entities/self-tracking-entities/walkthrough.md
+      - name: Logging & interception
+        href: ef6/fundamentals/logging-and-interception.md
+      - name: Performance
+        items:
+        - name: Performance considerations (whitepaper)
+          href: ef6/fundamentals/performance/perf-whitepaper.md
+        - name: Use NGEN
+          href: ef6/fundamentals/performance/ngen.md
+        - name: Use pre-generated views
+          href: ef6/fundamentals/performance/pre-generated-views.md
+      - name: Providers
+        items:
+        - name: Overview
+          href: ef6/fundamentals/providers/index.md
+        - name: EF6 provider model
+          href: ef6/fundamentals/providers/provider-model.md
+        - name: Spatial support in providers
+          href: ef6/fundamentals/providers/spatial-support.md
+      - name: Use proxies
+        href: ef6/fundamentals/proxies.md
+      - name: Testing with EF6
+        items:
+        - name: Use mocking
+          href: ef6/fundamentals/testing/mocking.md
+        - name: Write your own test doubles
+          href: ef6/fundamentals/testing/writing-test-doubles.md
+        - name: Testability with EF4 (article)
+          href: ef6/fundamentals/testing/testability-article.md
+    - name: Create a model
+      items:
+      - name: Overview
+        href: ef6/modeling/index.md
+      - name: Use Code First
+        items:
+        - name: Workflows
+          items:
+          - name: With a new database
+            href: ef6/modeling/code-first/workflows/new-database.md
+          - name: With an existing database
+            href: ef6/modeling/code-first/workflows/existing-database.md
+        - name: Data annotations
+          href: ef6/modeling/code-first/data-annotations.md
+        - name: DbSets
+          href: ef6/modeling/code-first/dbsets.md
+        - name: Data types
+          items:
+          - name: Enums
+            href: ef6/modeling/code-first/data-types/enums.md
+          - name: Spatial
+            href: ef6/modeling/code-first/data-types/spatial.md
+        - name: Conventions
+          items:
+          - name: Built-in conventions
+            href: ef6/modeling/code-first/conventions/built-in.md
+          - name: Custom conventions
+            href: ef6/modeling/code-first/conventions/custom.md
+          - name: Model conventions
+            href: ef6/modeling/code-first/conventions/model.md
+        - name: Fluent configuration
+          items:
+          - name: Relationships
+            href: ef6/modeling/code-first/fluent/relationships.md
+          - name: Types and properties
+            href: ef6/modeling/code-first/fluent/types-and-properties.md
+          - name: Use in Visual Basic
+            href: ef6/modeling/code-first/fluent/vb.md
+          - name: Stored procedure mapping
+            href: ef6/modeling/code-first/fluent/cud-stored-procedures.md
+        - name: Migrations
+          items:
+          - name: Overview
+            href: ef6/modeling/code-first/migrations/index.md
+          - name: Automatic migrations
+            href: ef6/modeling/code-first/migrations/automatic.md
+          - name: Work with existing databases
+            href: ef6/modeling/code-first/migrations/existing-database.md
+          - name: Customize Migrations history
+            href: ef6/modeling/code-first/migrations/history-customization.md
+          - name: Use Migrate.exe
+            href: ef6/modeling/code-first/migrations/migrate-exe.md
+          - name: Migrations in team environments
+            href: ef6/modeling/code-first/migrations/teams.md
+      - name: Use EF Designer
+        items:
+        - name: Workflows
+          items:
+          - name: Model-First
+            href: ef6/modeling/designer/workflows/model-first.md
+          - name: Database-First
+            href: ef6/modeling/designer/workflows/database-first.md
+        - name: Data types
+          items:
+          - name: Complex types
+            href: ef6/modeling/designer/data-types/complex-types.md
+          - name: Enums
+            href: ef6/modeling/designer/data-types/enums.md
+          - name: Spatial
+            href: ef6/modeling/designer/data-types/spatial.md
+        - name: Split mappings
+          items:
+          - name: Entity splitting
+            href: ef6/modeling/designer/entity-splitting.md
+          - name: Table splitting
+            href: ef6/modeling/designer/table-splitting.md
+        - name: Inheritance mappings
+          items:
+          - name: Table per hierarchy
+            href: ef6/modeling/designer/inheritance/tph.md
+          - name: Table per type
+            href: ef6/modeling/designer/inheritance/tpt.md
+        - name: Map stored procedures
+          items:
+          - name: Query
+            href: ef6/modeling/designer/stored-procedures/query.md
+          - name: Update
+            href: ef6/modeling/designer/stored-procedures/cud.md
+        - name: Map relationships
+          href: ef6/modeling/designer/relationships.md
+        - name: Multiple diagrams
+          href: ef6/modeling/designer/multiple-diagrams.md
+        - name: Select runtime version
+          href: ef6/modeling/designer/select-runtime-version.md
+        - name: Code generation
+          items:
+          - name: Overview
+            href: ef6/modeling/designer/codegen/index.md
+          - name: Legacy ObjectContext
+            href: ef6/modeling/designer/codegen/legacy-objectcontext.md
+        - name: Advanced
+          items:
+          - name: EDMX file format
+            items:
+            - name: CSDL specification
+              href: ef6/modeling/designer/advanced/edmx/csdl-spec.md
+            - name: MSL specification
+              href: ef6/modeling/designer/advanced/edmx/msl-spec.md
+            - name: SSDL specification
+              href: ef6/modeling/designer/advanced/edmx/ssdl-spec.md
+          - name: Defining query
+            href: ef6/modeling/designer/advanced/defining-query.md
+          - name: Multiple result sets
+            href: ef6/modeling/designer/advanced/multiple-result-sets.md
+          - name: Table-valued functions
+            href: ef6/modeling/designer/advanced/tvfs.md
+        - name: Keyboard shortcuts
+          href: ef6/modeling/designer/keyboard-shortcuts.md
+    - name: Query data
+      items:
+      - name: Overview
+        href: ef6/querying/index.md
+      - name: Load method
+        href: ef6/querying/load-method.md
+      - name: Local data
+        href: ef6/querying/local-data.md
+      - name: Tracking and no-tracking queries
+        href: ef6/querying/no-tracking.md
+      - name: Use raw SQL queries
+        href: ef6/querying/raw-sql.md
+      - name: Query related data
+        href: ef6/querying/related-data.md
+    - name: Save data
+      items:
+      - name: Overview
+        href: ef6/saving/index.md
+      - name: Change tracking
+        items:
+        - name: Auto detect changes
+          href: ef6/saving/change-tracking/auto-detect-changes.md
+        - name: Entity state
+          href: ef6/saving/change-tracking/entity-state.md
+        - name: Property values
+          href: ef6/saving/change-tracking/property-values.md
+      - name: Handle concurrency conflicts
+        href: ef6/saving/concurrency.md
+      - name: Use transactions
+        href: ef6/saving/transactions.md
+      - name: Data validation
+        href: ef6/saving/validation.md
+    - name: Additional resources
+      items:
+      - name: Blogs
+        href: ef6/resources/blogs.md
+      - name: Case studies
+        href: ef6/resources/case-studies.md
+      - name: Contribute
+        href: ef6/resources/contribute.md
+      - name: Get help
+        href: ef6/resources/get-help.md
+      - name: Glossary
+        href: ef6/resources/glossary.md
+      - name: School sample database
+        href: ef6/resources/school-database.md
+      - name: "Tools & extensions"
+        href: ef6/resources/tools.md
+      - name: Licenses
+        items:
+        - name: EF5
+          items:
+          - name: Chinese simplified
+            href: ef6/resources/licenses/ef5/chs.md
+          - name: Chinese traditional
+            href: ef6/resources/licenses/ef5/cht.md
+          - name: German
+            href: ef6/resources/licenses/ef5/deu.md
+          - name: English
+            href: ef6/resources/licenses/ef5/enu.md
+          - name: Spanish
+            href: ef6/resources/licenses/ef5/esn.md
+          - name: French
+            href: ef6/resources/licenses/ef5/fra.md
+          - name: Italian
+            href: ef6/resources/licenses/ef5/ita.md
+          - name: Japanese
+            href: ef6/resources/licenses/ef5/jpn.md
+          - name: Korean
+            href: ef6/resources/licenses/ef5/kor.md
+          - name: Russian
+            href: ef6/resources/licenses/ef5/rus.md
+        - name: EF6
+          items:
+          - name: Prerelease
+            items:
+            - name: Alpha
+              href: ef6/resources/licenses/ef6/prerelease/alpha.md
+            - name: Beta - release candidate
+              href: ef6/resources/licenses/ef6/prerelease/beta-rc.md
+          - name: Chinese simplified
+            href: ef6/resources/licenses/ef6/chs.md
+          - name: Chinese traditional
+            href: ef6/resources/licenses/ef6/cht.md
+          - name: German
+            href: ef6/resources/licenses/ef6/deu.md
+          - name: English
+            href: ef6/resources/licenses/ef6/enu.md
+          - name: Spanish
+            href: ef6/resources/licenses/ef6/esn.md
+          - name: French
+            href: ef6/resources/licenses/ef6/fra.md
+          - name: Italian
+            href: ef6/resources/licenses/ef6/ita.md
+          - name: Japanese
+            href: ef6/resources/licenses/ef6/jpn.md
+          - name: Korean
+            href: ef6/resources/licenses/ef6/kor.md
+          - name: Russian
+            href: ef6/resources/licenses/ef6/rus.md
+    - name: EF6 API reference >>
+      href: /dotnet/api/?view=entity-framework-6.2.0&preserve-view=true
diff --git a/samples/NuGet.Config b/samples/NuGet.Config
new file mode 100644
index 0000000000..6548586147
--- /dev/null
+++ b/samples/NuGet.Config
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<configuration>
+  <packageSources>
+    <clear />
+    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
+  </packageSources>
+  <disabledPackageSources>
+    <clear />
+  </disabledPackageSources>
+</configuration>
diff --git a/samples/core/.DS_Store b/samples/core/.DS_Store
new file mode 100644
index 0000000000..63eba61765
Binary files /dev/null and b/samples/core/.DS_Store differ
diff --git a/samples/core/.editorconfig b/samples/core/.editorconfig
new file mode 100644
index 0000000000..dfe64dad4a
--- /dev/null
+++ b/samples/core/.editorconfig
@@ -0,0 +1,257 @@
+# Schema: http://EditorConfig.org
+# Docs: https://docs.microsoft.com/en-us/visualstudio/ide/editorconfig-code-style-settings-reference
+
+# top-most EditorConfig file
+root = true
+
+# Don't use tabs for indentation.
+[*]
+indent_style = space
+trim_trailing_whitespace = true
+guidelines = 140
+max_line_length = 140
+
+# Code files
+[*.{cs,csx,vb,vbx}]
+indent_size = 4
+insert_final_newline = true
+#charset = utf-8-bom
+
+# Xml project files
+[*.{csproj,vbproj,vcxproj,vcxproj.filters,proj,projitems,shproj}]
+indent_size = 2
+
+# Xml config files
+[*.{props,targets,ruleset,config,nuspec,resx,vsixmanifest,vsct,xml,stylecop}]
+indent_size = 2
+
+# JSON files
+[*.json]
+indent_size = 2
+
+# Powershell files
+[*.ps1]
+indent_size = 2
+
+# Shell scripts
+[*.sh]
+end_of_line = lf
+indent_size = 2
+
+[*.{cmd,bat}]
+end_of_line = crlf
+indent_size = 2
+
+## Language conventions
+# Dotnet code style settings:
+[*.{cs,vb}]
+# "This." and "Me." qualifiers
+dotnet_style_qualification_for_field = false:suggestion
+dotnet_style_qualification_for_property = false:suggestion
+dotnet_style_qualification_for_method = false:suggestion
+dotnet_style_qualification_for_event = false:suggestion
+
+# Language keywords instead of framework type names for type references
+dotnet_style_predefined_type_for_locals_parameters_members = true:suggestion
+dotnet_style_predefined_type_for_member_access = true:suggestion
+
+# Modifier preferences
+dotnet_style_require_accessibility_modifiers = always:suggestion
+dotnet_style_readonly_field = true:warning
+
+# Parentheses preferences
+dotnet_style_parentheses_in_arithmetic_binary_operators = always_for_clarity:silent
+dotnet_style_parentheses_in_relational_binary_operators = always_for_clarity:silent
+dotnet_style_parentheses_in_other_binary_operators = always_for_clarity:silent
+dotnet_style_parentheses_in_other_operators = never_if_unnecessary:silent
+
+# Expression-level preferences
+dotnet_style_object_initializer = true:suggestion
+dotnet_style_collection_initializer = true:suggestion
+dotnet_style_explicit_tuple_names = true:suggestion
+dotnet_style_prefer_inferred_tuple_names = true:suggestion
+dotnet_style_prefer_inferred_anonymous_type_member_names = true:suggestion
+dotnet_style_prefer_auto_properties = true:silent
+dotnet_style_prefer_conditional_expression_over_assignment = true:suggestion
+dotnet_style_prefer_conditional_expression_over_return = true:suggestion
+
+# Null-checking preferences
+dotnet_style_coalesce_expression = true:suggestion
+dotnet_style_null_propagation = true:suggestion
+
+# CSharp code style settings:
+[*.cs]
+# Modifier preferences
+csharp_preferred_modifier_order = public, private, protected, internal, const, static, extern, new, virtual, abstract, sealed, override, readonly, unsafe, volatile, async:suggestion
+
+# Implicit and explicit types
+csharp_style_var_for_built_in_types = true:suggestion
+csharp_style_var_when_type_is_apparent = true:suggestion
+csharp_style_var_elsewhere = true:suggestion
+
+# Expression-bodied members
+# Explicitly disabled due to difference in coding style between source and tests
+#csharp_style_expression_bodied_methods = false:silent
+#csharp_style_expression_bodied_constructors = false:silent
+csharp_style_expression_bodied_operators = false:silent
+csharp_style_expression_bodied_properties = true:suggestion
+csharp_style_expression_bodied_indexers = true:suggestion
+csharp_style_expression_bodied_accessors = true:suggestion
+
+# Pattern matching
+csharp_style_pattern_matching_over_is_with_cast_check = true:suggestion
+csharp_style_pattern_matching_over_as_with_null_check = true:suggestion
+
+# Inlined variable declarations
+csharp_style_inlined_variable_declaration = true:suggestion
+
+# Expression-level preferences
+csharp_prefer_simple_default_expression = true:suggestion
+csharp_style_deconstructed_variable_declaration = true:suggestion
+csharp_style_pattern_local_over_anonymous_function = true:suggestion
+
+# Null-checking preference
+csharp_style_throw_expression = true:suggestion
+csharp_style_conditional_delegate_call = true:suggestion
+
+# Code block preferences
+csharp_prefer_braces = true:suggestion
+
+## Formatting conventions
+# Dotnet formatting settings:
+[*.{cs,vb}]
+# Organize usings
+dotnet_sort_system_directives_first = true
+dotnet_separate_import_directive_groups = false
+
+# CSharp formatting settings:
+[*.cs]
+# Newline options
+csharp_new_line_before_open_brace = all
+csharp_new_line_before_else = true
+csharp_new_line_before_catch = true
+csharp_new_line_before_finally = true
+csharp_new_line_before_members_in_object_initializers = true
+csharp_new_line_before_members_in_anonymous_types = true
+csharp_new_line_between_query_expression_clauses = true
+
+# Identation options
+csharp_indent_block_contents = true
+csharp_indent_braces = false
+csharp_indent_case_contents_when_block = false
+csharp_indent_switch_labels = true
+csharp_indent_case_contents = true
+csharp_indent_labels = no_change
+
+# Spacing options
+csharp_space_after_cast = false
+csharp_space_after_keywords_in_control_flow_statements = true
+csharp_space_between_method_declaration_parameter_list_parentheses = false
+csharp_space_between_method_call_parameter_list_parentheses = false
+csharp_space_between_parentheses = false
+csharp_space_before_colon_in_inheritance_clause = true
+csharp_space_after_colon_in_inheritance_clause = true
+csharp_space_around_binary_operators = before_and_after
+csharp_space_between_method_declaration_empty_parameter_list_parentheses = false
+csharp_space_between_method_call_name_and_opening_parenthesis = false
+csharp_space_between_method_call_empty_parameter_list_parentheses = false
+csharp_space_after_comma = true
+csharp_space_after_dot = false
+csharp_space_after_semicolon_in_for_statement = true
+csharp_space_around_declaration_statements = do_not_ignore
+csharp_space_before_comma = false
+csharp_space_before_dot = false
+csharp_space_before_open_square_brackets = false
+csharp_space_before_semicolon_in_for_statement = false
+csharp_space_between_empty_square_brackets = false
+csharp_space_between_method_declaration_name_and_open_parenthesis = false
+csharp_space_between_square_brackets = false
+
+# Wrap options
+csharp_preserve_single_line_statements = true
+csharp_preserve_single_line_blocks = true
+
+## Naming conventions
+[*.{cs,vb}]
+
+## Naming styles
+
+dotnet_naming_style.pascal_case_style.capitalization = pascal_case
+dotnet_naming_style.camel_case_style.capitalization = camel_case
+
+# PascalCase with I prefix
+dotnet_naming_style.interface_style.capitalization = pascal_case
+dotnet_naming_style.interface_style.required_prefix = I
+
+# PascalCase with T prefix
+dotnet_naming_style.type_parameter_style.capitalization = pascal_case
+dotnet_naming_style.type_parameter_style.required_prefix = T
+
+# camelCase with _ prefix
+dotnet_naming_style._camelCase.capitalization = camel_case
+dotnet_naming_style._camelCase.required_prefix = _
+
+## Rules
+# Interfaces
+dotnet_naming_symbols.interface_symbol.applicable_kinds = interface
+dotnet_naming_symbols.interface_symbol.applicable_accessibilities = *
+dotnet_naming_rule.interface_naming.symbols = interface_symbol
+dotnet_naming_rule.interface_naming.style = interface_style
+dotnet_naming_rule.interface_naming.severity = suggestion
+
+# Classes, Structs, Enums, Properties, Methods, Local Functions, Events, Namespaces
+dotnet_naming_symbols.class_symbol.applicable_kinds = class, struct, enum, property, method, local_function, event, namespace, delegate
+dotnet_naming_symbols.class_symbol.applicable_accessibilities = *
+
+dotnet_naming_rule.class_naming.symbols = class_symbol
+dotnet_naming_rule.class_naming.style = pascal_case_style
+dotnet_naming_rule.class_naming.severity = suggestion
+
+# Type Parameters
+dotnet_naming_symbols.type_parameter_symbol.applicable_kinds = type_parameter
+dotnet_naming_symbols.type_parameter_symbol.applicable_accessibilities = *
+
+dotnet_naming_rule.type_parameter_naming.symbols = type_parameter_symbol
+dotnet_naming_rule.type_parameter_naming.style = type_parameter_style
+dotnet_naming_rule.type_parameter_naming.severity = suggestion
+
+# Visible Fields
+dotnet_naming_symbols.public_field_symbol.applicable_kinds = field
+dotnet_naming_symbols.public_field_symbol.applicable_accessibilities = public, internal, protected, protected_internal, private_protected
+
+dotnet_naming_rule.public_field_naming.symbols = public_field_symbol
+dotnet_naming_rule.public_field_naming.style = pascal_case_style
+dotnet_naming_rule.public_field_naming.severity = suggestion
+
+# Private constant Fields
+dotnet_naming_symbols.const_field_symbol.applicable_kinds = field
+dotnet_naming_symbols.const_field_symbol.applicable_accessibilities = private
+dotnet_naming_symbols.const_field_symbol.required_modifiers = const
+
+dotnet_naming_rule.const_field_naming.symbols = const_field_symbol
+dotnet_naming_rule.const_field_naming.style = pascal_case_style
+dotnet_naming_rule.const_field_naming.severity = suggestion
+
+# Private Fields
+dotnet_naming_symbols.private_field_symbol.applicable_kinds = field
+dotnet_naming_symbols.private_field_symbol.applicable_accessibilities = private
+
+dotnet_naming_rule.private_field_naming.symbols = private_field_symbol
+dotnet_naming_rule.private_field_naming.style = _camelCase
+dotnet_naming_rule.private_field_naming.severity = suggestion
+
+# Parameters
+dotnet_naming_symbols.parameter_symbol.applicable_kinds = parameter
+dotnet_naming_symbols.parameter_symbol.applicable_accessibilities = *
+
+dotnet_naming_rule.parameter_naming.symbols = parameter_symbol
+dotnet_naming_rule.parameter_naming.style = camel_case_style
+dotnet_naming_rule.parameter_naming.severity = suggestion
+
+# Everything Local
+dotnet_naming_symbols.everything_else.applicable_kinds = local
+dotnet_naming_symbols.everything_else.applicable_accessibilities = *
+
+dotnet_naming_rule.everything_else_naming.symbols = everything_else
+dotnet_naming_rule.everything_else_naming.style = camel_case_style
+dotnet_naming_rule.everything_else_naming.severity = suggestion
diff --git a/samples/core/Benchmarks/AverageBlogRanking.cs b/samples/core/Benchmarks/AverageBlogRanking.cs
new file mode 100644
index 0000000000..08ee415350
--- /dev/null
+++ b/samples/core/Benchmarks/AverageBlogRanking.cs
@@ -0,0 +1,109 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using BenchmarkDotNet.Attributes;
+using Microsoft.EntityFrameworkCore;
+
+[MemoryDiagnoser]
+public class AverageBlogRanking
+{
+    [Params(1000)]
+    public int NumBlogs; // number of records to write [once], and read [each pass]
+
+    [GlobalSetup]
+    public async Task Setup()
+    {
+        using var context = new BloggingContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.SeedData(NumBlogs);
+    }
+
+    #region LoadEntities
+    [Benchmark]
+    public async Task<double> LoadEntities()
+    {
+        var sum = 0;
+        var count = 0;
+        using var ctx = new BloggingContext();
+        await foreach (var blog in ctx.Blogs.AsAsyncEnumerable())
+        {
+            sum += blog.Rating;
+            count++;
+        }
+
+        return (double)sum / count;
+    }
+    #endregion
+
+    #region LoadEntitiesNoTracking
+    [Benchmark]
+    public async Task<double> LoadEntitiesNoTracking()
+    {
+        var sum = 0;
+        var count = 0;
+        using var ctx = new BloggingContext();
+        await foreach (var blog in ctx.Blogs.AsNoTracking().AsAsyncEnumerable())
+        {
+            sum += blog.Rating;
+            count++;
+        }
+
+        return (double)sum / count;
+    }
+    #endregion
+
+    #region ProjectOnlyRanking
+    [Benchmark]
+    public async Task<double> ProjectOnlyRanking()
+    {
+        var sum = 0;
+        var count = 0;
+        using var ctx = new BloggingContext();
+        await foreach (var rating in ctx.Blogs.Select(b => b.Rating).AsAsyncEnumerable())
+        {
+            sum += rating;
+            count++;
+        }
+
+        return (double)sum / count;
+    }
+    #endregion
+
+    #region CalculateInDatabase
+    [Benchmark(Baseline = true)]
+    public async Task<double> CalculateInDatabase()
+    {
+        using var ctx = new BloggingContext();
+        return await ctx.Blogs.AverageAsync(b => b.Rating);
+    }
+    #endregion
+
+    public class BloggingContext : DbContext
+    {
+        public DbSet<Blog> Blogs { get; set; }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder.UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;ConnectRetryCount=0");
+
+        public async Task SeedData(int numblogs)
+        {
+            Blogs.AddRange(
+                Enumerable.Range(0, numblogs).Select(
+                    i => new Blog
+                    {
+                        Name = $"Blog{i}", Url = $"blog{i}.blogs.net", CreationTime = new DateTime(2020, 1, 1), Rating = i % 5
+                    }));
+            await SaveChangesAsync();
+        }
+    }
+
+    public class Blog
+    {
+        public int BlogId { get; set; }
+        public string Name { get; set; }
+        public string Url { get; set; }
+        public DateTime CreationTime { get; set; }
+        public int Rating { get; set; }
+    }
+}
diff --git a/samples/core/Benchmarks/Benchmarks.csproj b/samples/core/Benchmarks/Benchmarks.csproj
new file mode 100644
index 0000000000..b0d5c1679e
--- /dev/null
+++ b/samples/core/Benchmarks/Benchmarks.csproj
@@ -0,0 +1,13 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <Optimize>true</Optimize>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="BenchmarkDotNet" Version="0.13.2" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Proxies" Version="10.0.0" />
+  </ItemGroup>
+</Project>
diff --git a/samples/core/Benchmarks/CompiledQueries.cs b/samples/core/Benchmarks/CompiledQueries.cs
new file mode 100644
index 0000000000..aa10ed1a29
--- /dev/null
+++ b/samples/core/Benchmarks/CompiledQueries.cs
@@ -0,0 +1,80 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using BenchmarkDotNet.Attributes;
+using Microsoft.EntityFrameworkCore;
+
+[MemoryDiagnoser]
+public class CompiledQueries
+{
+    private static readonly Func<BloggingContext, IAsyncEnumerable<Blog>> _compiledQuery
+        = EF.CompileAsyncQuery((BloggingContext context) => context.Blogs.Where(b => b.Url.StartsWith("http://")));
+
+    private BloggingContext _context;
+
+    [Params(1, 10)]
+    public int NumBlogs { get; set; }
+
+    [GlobalSetup]
+    public async Task Setup()
+    {
+        using var context = new BloggingContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.SeedDataAsync(NumBlogs);
+
+        _context = new BloggingContext();
+    }
+
+    [Benchmark]
+    public async ValueTask<int> WithCompiledQuery()
+    {
+        var idSum = 0;
+
+        await foreach (var blog in _compiledQuery(_context))
+        {
+            idSum += blog.Id;
+        }
+
+        return idSum;
+    }
+
+    [Benchmark]
+    public async ValueTask<int> WithoutCompiledQuery()
+    {
+        var idSum = 0;
+
+        await foreach (var blog in _context.Blogs.Where(b => b.Url.StartsWith("http://")).AsAsyncEnumerable())
+        {
+            idSum += blog.Id;
+        }
+
+        return idSum;
+    }
+
+    [GlobalCleanup]
+    public ValueTask Cleanup() => _context.DisposeAsync();
+
+    public class BloggingContext : DbContext
+    {
+        public DbSet<Blog> Blogs { get; set; }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;ConnectRetryCount=0")
+                .UseQueryTrackingBehavior(QueryTrackingBehavior.NoTracking);
+
+        public async Task SeedDataAsync(int numBlogs)
+        {
+            Blogs.AddRange(Enumerable.Range(0, numBlogs).Select(i => new Blog { Url = $"http://www.someblog{i}.com"}));
+            await SaveChangesAsync();
+        }
+    }
+
+    public class Blog
+    {
+        public int Id { get; set; }
+        public string Url { get; set; }
+    }
+}
diff --git a/samples/core/Benchmarks/ContextPooling.cs b/samples/core/Benchmarks/ContextPooling.cs
new file mode 100644
index 0000000000..a03605780f
--- /dev/null
+++ b/samples/core/Benchmarks/ContextPooling.cs
@@ -0,0 +1,67 @@
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using BenchmarkDotNet.Attributes;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+
+[MemoryDiagnoser]
+public class ContextPooling
+{
+    private DbContextOptions<BloggingContext> _options;
+    private PooledDbContextFactory<BloggingContext> _poolingFactory;
+
+    [Params(1)]
+    public int NumBlogs { get; set; }
+
+    [GlobalSetup]
+    public async Task Setup()
+    {
+        _options = new DbContextOptionsBuilder<BloggingContext>()
+            .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;ConnectRetryCount=0")
+            .Options;
+
+        using var context = new BloggingContext(_options);
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.SeedData(NumBlogs);
+
+        _poolingFactory = new PooledDbContextFactory<BloggingContext>(_options);
+    }
+
+    [Benchmark]
+    public async Task<List<Blog>> WithoutContextPooling()
+    {
+        using var context = new BloggingContext(_options);
+
+        return await context.Blogs.ToListAsync();
+    }
+
+    [Benchmark]
+    public async Task<List<Blog>> WithContextPooling()
+    {
+        using var context = _poolingFactory.CreateDbContext();
+
+        return await context.Blogs.ToListAsync();
+    }
+
+    public class BloggingContext : DbContext
+    {
+        public DbSet<Blog> Blogs { get; set; }
+
+        public BloggingContext(DbContextOptions options) : base(options) {}
+
+        public async Task SeedData(int numBlogs)
+        {
+            Blogs.AddRange(Enumerable.Range(0, numBlogs).Select(i => new Blog { Url = $"http://www.someblog{i}.com"}));
+            await SaveChangesAsync();
+        }
+    }
+
+    public class Blog
+    {
+        public int BlogId { get; set; }
+        public string Url { get; set; }
+        public int Rating { get; set; }
+    }
+}
diff --git a/samples/core/Benchmarks/DynamicallyConstructedQueries.cs b/samples/core/Benchmarks/DynamicallyConstructedQueries.cs
new file mode 100644
index 0000000000..c969e9a5e3
--- /dev/null
+++ b/samples/core/Benchmarks/DynamicallyConstructedQueries.cs
@@ -0,0 +1,133 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Linq.Expressions;
+using System.Threading;
+using System.Threading.Tasks;
+using BenchmarkDotNet.Attributes;
+using Microsoft.EntityFrameworkCore;
+
+[MemoryDiagnoser]
+public class DynamicallyConstructedQueries
+{
+    private int _blogNumber;
+    private bool _addWhereClause = true;
+
+    [GlobalSetup]
+    public static async Task GlobalSetup()
+    {
+        using var context = new BloggingContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    #region ExpressionApiWithConstant
+    [Benchmark]
+    public async Task<int> ExpressionApiWithConstant()
+    {
+        var url = "blog" + Interlocked.Increment(ref _blogNumber);
+        using var context = new BloggingContext();
+
+        IQueryable<Blog> query = context.Blogs;
+
+        if (_addWhereClause)
+        {
+            var blogParam = Expression.Parameter(typeof(Blog), "b");
+            var whereLambda = Expression.Lambda<Func<Blog, bool>>(
+                Expression.Equal(
+                    Expression.MakeMemberAccess(
+                        blogParam,
+                        typeof(Blog).GetMember(nameof(Blog.Url)).Single()),
+                    Expression.Constant(url)),
+                blogParam);
+
+            query = query.Where(whereLambda);
+        }
+
+        return await query.CountAsync();
+    }
+    #endregion
+
+    #region ExpressionApiWithParameter
+    [Benchmark]
+    public async Task<int> ExpressionApiWithParameter()
+    {
+        var url = "blog" + Interlocked.Increment(ref _blogNumber);
+        using var context = new BloggingContext();
+
+        IQueryable<Blog> query = context.Blogs;
+
+        if (_addWhereClause)
+        {
+            var blogParam = Expression.Parameter(typeof(Blog), "b");
+
+            // This creates a lambda expression whose body is identical to the url captured closure variable in the non-dynamic query:
+            // blogs.Where(b => b.Url == url)
+            // This dynamically creates an expression node which EF can properly recognize and parameterize in the database query.
+            // We then extract that body and use it in our dynamically-constructed query.
+            Expression<Func<string>> urlParameterLambda = () => url;
+            var urlParamExpression = urlParameterLambda.Body;
+
+            var whereLambda = Expression.Lambda<Func<Blog, bool>>(
+                Expression.Equal(
+                    Expression.MakeMemberAccess(
+                        blogParam,
+                        typeof(Blog).GetMember(nameof(Blog.Url)).Single()),
+                    urlParamExpression),
+                blogParam);
+
+            query = query.Where(whereLambda);
+        }
+
+        return await query.CountAsync();
+    }
+    #endregion
+
+    #region SimpleWithParameter
+    [Benchmark]
+    public async Task<int> SimpleWithParameter()
+    {
+        var url = "blog" + Interlocked.Increment(ref _blogNumber);
+
+        using var context = new BloggingContext();
+
+        IQueryable<Blog> query = context.Blogs;
+
+        if (_addWhereClause)
+        {
+            Expression<Func<Blog, bool>> whereLambda = b => b.Url == url;
+
+            query = query.Where(whereLambda);
+        }
+
+        return await query.CountAsync();
+    }
+    #endregion
+
+    public class BloggingContext : DbContext
+    {
+        public DbSet<Blog> Blogs { get; set; }
+        public DbSet<Post> Posts { get; set; }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder.UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;ConnectRetryCount=0");
+    }
+
+    public class Blog
+    {
+        public int BlogId { get; set; }
+        public string Url { get; set; }
+        public int Rating { get; set; }
+        public List<Post> Posts { get; set; }
+    }
+
+    public class Post
+    {
+        public int PostId { get; set; }
+        public string Title { get; set; }
+        public string Content { get; set; }
+
+        public int BlogId { get; set; }
+        public Blog Blog { get; set; }
+    }
+}
diff --git a/samples/core/Benchmarks/Inheritance.cs b/samples/core/Benchmarks/Inheritance.cs
new file mode 100644
index 0000000000..42e97b84e0
--- /dev/null
+++ b/samples/core/Benchmarks/Inheritance.cs
@@ -0,0 +1,158 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using BenchmarkDotNet.Attributes;
+using Microsoft.EntityFrameworkCore;
+
+[MemoryDiagnoser]
+public class Inheritance
+{
+    [Params(5000)]
+    public int RowsPerEntityType { get; set; }
+
+    [GlobalSetup(Target = nameof(TPH))]
+    public async Task SetupTPH()
+    {
+        Console.WriteLine("Setting up database...");
+        using var context = new TPHContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.SeedData(RowsPerEntityType);
+        Console.WriteLine("Setup complete.");
+    }
+
+    [GlobalSetup(Target = nameof(TPT))]
+    public async Task SetupTPT()
+    {
+        Console.WriteLine("Setting up database...");
+        using var context = new TPTContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.SeedData(RowsPerEntityType);
+        Console.WriteLine("Setup complete.");
+    }
+
+    [GlobalSetup(Target = nameof(TPC))]
+    public async Task SetupTPC()
+    {
+        Console.WriteLine("Setting up database...");
+        using var context = new TPCContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.SeedData(RowsPerEntityType);
+        Console.WriteLine("Setup complete.");
+    }
+
+    [Benchmark]
+    public async Task<List<Root>> TPH()
+    {
+        using var context = new TPHContext();
+
+        return await context.Roots.ToListAsync();
+    }
+
+    [Benchmark]
+    public async Task<List<Root>> TPT()
+    {
+        using var context = new TPTContext();
+
+        return await context.Roots.ToListAsync();
+    }
+
+    [Benchmark]
+    public async Task<List<Root>> TPC()
+    {
+        using var context = new TPCContext();
+
+        return await context.Roots.ToListAsync();
+    }
+
+    public abstract class InheritanceContext : DbContext
+    {
+        public DbSet<Root> Roots { get; set; }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder.UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;ConnectRetryCount=0");
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Child1>();
+            modelBuilder.Entity<Child1A>();
+            modelBuilder.Entity<Child1B>();
+            modelBuilder.Entity<Child2>();
+            modelBuilder.Entity<Child2A>();
+            modelBuilder.Entity<Child2B>();
+        }
+
+        public async Task SeedData(int rowsPerEntityType)
+        {
+            Set<Root>().AddRange(Enumerable.Range(0, rowsPerEntityType).Select(i => new Root { RootProperty = i }));
+            Set<Child1>().AddRange(Enumerable.Range(0, rowsPerEntityType).Select(i => new Child1 { Child1Property = i }));
+            Set<Child1A>().AddRange(Enumerable.Range(0, rowsPerEntityType).Select(i => new Child1A { Child1AProperty = i }));
+            Set<Child1B>().AddRange(Enumerable.Range(0, rowsPerEntityType).Select(i => new Child1B { Child1BProperty = i }));
+            Set<Child2>().AddRange(Enumerable.Range(0, rowsPerEntityType).Select(i => new Child2 { Child2Property = i }));
+            Set<Child2A>().AddRange(Enumerable.Range(0, rowsPerEntityType).Select(i => new Child2A { Child2AProperty = i }));
+            Set<Child2B>().AddRange(Enumerable.Range(0, rowsPerEntityType).Select(i => new Child2B { Child2BProperty = i }));
+            await SaveChangesAsync();
+        }
+    }
+
+    public class TPHContext : InheritanceContext
+    {
+    }
+
+    public class TPTContext : InheritanceContext
+    {
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            base.OnModelCreating(modelBuilder);
+            modelBuilder.Entity<Root>().UseTptMappingStrategy();
+        }
+    }
+
+    public class TPCContext : InheritanceContext
+    {
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            base.OnModelCreating(modelBuilder);
+            modelBuilder.Entity<Root>().UseTpcMappingStrategy();
+        }
+    }
+
+    public class Root
+    {
+        public int Id { get; set; }
+        public int RootProperty { get; set; }
+    }
+
+    public class Child1 : Root
+    {
+        public int Child1Property { get; set; }
+    }
+
+    public class Child1A : Root
+    {
+        public int Child1AProperty { get; set; }
+    }
+
+    public class Child1B : Root
+    {
+        public int Child1BProperty { get; set; }
+    }
+
+    public class Child2 : Root
+    {
+        public int Child2Property { get; set; }
+    }
+
+    public class Child2A : Root
+    {
+        public int Child2AProperty { get; set; }
+    }
+
+    public class Child2B : Root
+    {
+        public int Child2BProperty { get; set; }
+    }
+}
diff --git a/samples/core/Benchmarks/Program.cs b/samples/core/Benchmarks/Program.cs
new file mode 100644
index 0000000000..26ee04d39e
--- /dev/null
+++ b/samples/core/Benchmarks/Program.cs
@@ -0,0 +1,6 @@
+using BenchmarkDotNet.Running;
+
+public class Program
+{
+    public static void Main(string[] args) => BenchmarkSwitcher.FromAssembly(typeof(Program).Assembly).Run(args);
+}
diff --git a/samples/core/Benchmarks/QueryTrackingBehavior.cs b/samples/core/Benchmarks/QueryTrackingBehavior.cs
new file mode 100644
index 0000000000..e7f303a53e
--- /dev/null
+++ b/samples/core/Benchmarks/QueryTrackingBehavior.cs
@@ -0,0 +1,82 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using BenchmarkDotNet.Attributes;
+using Microsoft.EntityFrameworkCore;
+
+namespace Benchmarks;
+
+[MemoryDiagnoser]
+public class QueryTrackingBehavior
+{
+    [Params(10)]
+    public int NumBlogs { get; set; }
+
+    [Params(20)]
+    public int NumPostsPerBlog { get; set; }
+
+    [GlobalSetup]
+    public async Task Setup()
+    {
+        Console.WriteLine("Setting up database...");
+        using var context = new BloggingContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await BloggingContext.SeedData(NumBlogs, NumPostsPerBlog);
+        Console.WriteLine("Setup complete.");
+    }
+
+    [Benchmark(Baseline = true)]
+    public async Task<List<Post>> AsTracking()
+    {
+        using var context = new BloggingContext();
+
+        return await context.Posts.AsTracking().Include(p => p.Blog).ToListAsync();
+    }
+
+    [Benchmark]
+    public async Task<List<Post>> AsNoTracking()
+    {
+        using var context = new BloggingContext();
+
+        return await context.Posts.AsNoTracking().Include(p => p.Blog).ToListAsync();
+    }
+
+    public class BloggingContext : DbContext
+    {
+        public DbSet<Blog> Blogs { get; set; }
+        public DbSet<Post> Posts { get; set; }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder.UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;ConnectRetryCount=0");
+
+        public static async Task SeedData(int numBlogs, int numPostsPerBlog)
+        {
+            using var context = new BloggingContext();
+            context.AddRange(
+                Enumerable.Range(0, numBlogs)
+                    .Select(_ => new Blog { Url = "Some URL", Posts = Enumerable.Range(0, numPostsPerBlog)
+                    .Select(_ => new Post() { Title = "Some Title", Content = "Some Content"}).ToList() }));
+            await context.SaveChangesAsync();
+        }
+    }
+
+    public class Blog
+    {
+        public int BlogId { get; set; }
+        public string Url { get; set; }
+        public int Rating { get; set; }
+        public List<Post> Posts { get; set; }
+    }
+
+    public class Post
+    {
+        public int PostId { get; set; }
+        public string Title { get; set; }
+        public string Content { get; set; }
+
+        public int BlogId { get; set; }
+        public Blog Blog { get; set; }
+    }
+}
diff --git a/samples/core/CascadeDeletes/CascadeDeletes.csproj b/samples/core/CascadeDeletes/CascadeDeletes.csproj
new file mode 100644
index 0000000000..52d146ef8f
--- /dev/null
+++ b/samples/core/CascadeDeletes/CascadeDeletes.csproj
@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <TargetFramework>net10.0</TargetFramework>
+        <RootNamespace />
+    </PropertyGroup>
+
+    <ItemGroup>
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.0" />
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+        <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+    </ItemGroup>
+
+</Project>
diff --git a/samples/core/CascadeDeletes/IntroOptionalSamples.cs b/samples/core/CascadeDeletes/IntroOptionalSamples.cs
new file mode 100644
index 0000000000..04717d76a5
--- /dev/null
+++ b/samples/core/CascadeDeletes/IntroOptionalSamples.cs
@@ -0,0 +1,171 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace IntroOptional;
+
+public static class IntroOptionalSamples
+{
+    public static async Task Deleting_principal_parent_1b()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Deleting_principal_parent_1b)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Deleting_principal_parent_1b
+        using var context = new BlogsContext();
+
+        var blog = await context.Blogs.OrderBy(e => e.Name).Include(e => e.Posts).FirstAsync();
+
+        context.Remove(blog);
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Severing_a_relationship_1b()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Severing_a_relationship_1b)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Severing_a_relationship_1b
+        using var context = new BlogsContext();
+
+        var blog = await context.Blogs.OrderBy(e => e.Name).Include(e => e.Posts).FirstAsync();
+
+        foreach (var post in blog.Posts)
+        {
+            post.Blog = null;
+        }
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Severing_a_relationship_2b()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Severing_a_relationship_2b)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Severing_a_relationship_2b
+        using var context = new BlogsContext();
+
+        var blog = await context.Blogs.OrderBy(e => e.Name).Include(e => e.Posts).FirstAsync();
+
+        blog.Posts.Clear();
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        Console.WriteLine();
+    }
+}
+
+public static class Helpers
+{
+    public static async Task RecreateCleanDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    public static async Task PopulateDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        context.Add(
+            new Blog
+            {
+                Name = ".NET Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    },
+                }
+            });
+
+        await context.SaveChangesAsync();
+    }
+}
+
+#region Model
+public class Blog
+{
+    public int Id { get; set; }
+
+    public string Name { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>();
+}
+
+public class Post
+{
+    public int Id { get; set; }
+
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int? BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
+#endregion
+
+public class BlogsContext : DbContext
+{
+    private readonly bool _quiet;
+
+    public BlogsContext(bool quiet = false)
+    {
+        _quiet = quiet;
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder
+            .Entity<Blog>()
+            .HasMany(e => e.Posts)
+            .WithOne(e => e.Blog)
+            .OnDelete(DeleteBehavior.ClientSetNull);
+    }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .EnableSensitiveDataLogging()
+            .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Scratch;Trusted_Connection=True;ConnectRetryCount=0");
+        //.UseSqlite("DataSource=test.db");
+
+        if (!_quiet)
+        {
+            optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+        }
+    }
+}
diff --git a/samples/core/CascadeDeletes/IntroRequiredSamples.cs b/samples/core/CascadeDeletes/IntroRequiredSamples.cs
new file mode 100644
index 0000000000..2ccf07c516
--- /dev/null
+++ b/samples/core/CascadeDeletes/IntroRequiredSamples.cs
@@ -0,0 +1,188 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace IntroRequired;
+
+public static class IntroRequiredSamples
+{
+    public static async Task Deleting_principal_parent_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Deleting_principal_parent_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Deleting_principal_parent_1
+        using var context = new BlogsContext();
+
+        var blog = await context.Blogs.OrderBy(e => e.Name).Include(e => e.Posts).FirstAsync();
+
+        context.Remove(blog);
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Severing_a_relationship_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Severing_a_relationship_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Severing_a_relationship_1
+        using var context = new BlogsContext();
+
+        var blog = await context.Blogs.OrderBy(e => e.Name).Include(e => e.Posts).FirstAsync();
+
+        foreach (var post in blog.Posts)
+        {
+            post.Blog = null;
+        }
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Severing_a_relationship_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Severing_a_relationship_2)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Severing_a_relationship_2
+        using var context = new BlogsContext();
+
+        var blog = await context.Blogs.OrderBy(e => e.Name).Include(e => e.Posts).FirstAsync();
+
+        blog.Posts.Clear();
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Where_cascading_behaviors_happen_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Where_cascading_behaviors_happen_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Where_cascading_behaviors_happen_1
+        using var context = new BlogsContext();
+
+        var blog = await context.Blogs.OrderBy(e => e.Name).FirstAsync();
+
+        context.Remove(blog);
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        Console.WriteLine();
+    }
+}
+
+public static class Helpers
+{
+    public static async Task RecreateCleanDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    public static async Task PopulateDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        context.Add(
+            new Blog
+            {
+                Name = ".NET Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    },
+                }
+            });
+
+        await context.SaveChangesAsync();
+    }
+}
+
+#region Model
+public class Blog
+{
+    public int Id { get; set; }
+
+    public string Name { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>();
+}
+
+public class Post
+{
+    public int Id { get; set; }
+
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
+#endregion
+
+public class BlogsContext : DbContext
+{
+    private readonly bool _quiet;
+
+    public BlogsContext(bool quiet = false)
+    {
+        _quiet = quiet;
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>().HasMany(e => e.Posts).WithOne(e => e.Blog); //.OnDelete(DeleteBehavior.ClientSetNull);
+    }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .EnableSensitiveDataLogging()
+            .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Scratch;Trusted_Connection=True;ConnectRetryCount=0");
+        //.UseSqlite("DataSource=test.db");
+
+        if (!_quiet)
+        {
+            optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+        }
+    }
+}
diff --git a/samples/core/CascadeDeletes/OptionalDependentsSamples.cs b/samples/core/CascadeDeletes/OptionalDependentsSamples.cs
new file mode 100644
index 0000000000..4b8d9d55c7
--- /dev/null
+++ b/samples/core/CascadeDeletes/OptionalDependentsSamples.cs
@@ -0,0 +1,200 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace Optional;
+
+public static class OptionalDependentsSamples
+{
+    public static async Task Optional_relationship_with_dependents_children_loaded()
+    {
+        Console.WriteLine("#### Optional relationship with dependents/children loaded");
+        Console.WriteLine();
+
+        var deleteResults = await Helpers.GatherData(async c => c.Remove(await c.Blogs.Include(e => e.Posts).SingleAsync()));
+        var severResults = await Helpers.GatherData(async c => (await c.Blogs.Include(e => e.Posts).SingleAsync()).Posts.Clear());
+
+        Console.WriteLine(
+            $"| `{"DeleteBehavior".PadRight(16)} | {"On deleting principal/parent".PadRight(40)} | On severing from principal/parent");
+        Console.WriteLine("|:------------------|------------------------------------------|----------------------------------------");
+        foreach (var deleteBehavior in DeleteBehaviors)
+        {
+            Console.WriteLine(
+                $"| `{(deleteBehavior + "`").PadRight(16)} | {deleteResults[deleteBehavior].PadRight(40)} | {severResults[deleteBehavior]}");
+        }
+
+        Console.WriteLine();
+    }
+
+    public static async Task Optional_relationship_with_dependents_children_not_loaded()
+    {
+        Console.WriteLine("#### Optional relationship with dependents/children not loaded");
+        Console.WriteLine();
+
+        var deleteResults = await Helpers.GatherData(async c => c.Remove(await c.Blogs.SingleAsync()));
+
+        Console.WriteLine(
+            $"| `{"DeleteBehavior".PadRight(16)} | {"On deleting principal/parent".PadRight(40)} | On severing from principal/parent");
+        Console.WriteLine("|:------------------|------------------------------------------|----------------------------------------");
+        foreach (var deleteBehavior in DeleteBehaviors)
+        {
+            Console.WriteLine($"| `{(deleteBehavior + "`").PadRight(16)} | {deleteResults[deleteBehavior].PadRight(40)} | N/A");
+        }
+
+        Console.WriteLine();
+    }
+
+    public static DeleteBehavior[] DeleteBehaviors { get; }
+        =
+        {
+            DeleteBehavior.Cascade, DeleteBehavior.Restrict, DeleteBehavior.NoAction, DeleteBehavior.SetNull,
+            DeleteBehavior.ClientSetNull, DeleteBehavior.ClientCascade, DeleteBehavior.ClientNoAction
+        };
+
+    #region Model
+    public class Blog
+    {
+        public int Id { get; set; }
+
+        public string Name { get; set; }
+
+        public IList<Post> Posts { get; } = new List<Post>();
+    }
+
+    public class Post
+    {
+        public int Id { get; set; }
+
+        public string Title { get; set; }
+        public string Content { get; set; }
+
+        #region NullableBlogId
+        public int? BlogId { get; set; }
+        #endregion
+
+        public Blog Blog { get; set; }
+    }
+    #endregion
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase(OptionalBlogsContext context)
+        {
+            using (context)
+            {
+                await context.Database.EnsureDeletedAsync();
+                await context.Database.EnsureCreatedAsync();
+            }
+        }
+
+        public static async Task PopulateDatabase(OptionalBlogsContext context)
+        {
+            using (context)
+            {
+                context.Add(
+                    new Blog
+                    {
+                        Name = ".NET Blog",
+                        Posts =
+                        {
+                            new Post
+                            {
+                                Title = "Announcing the Release of EF Core 5.0",
+                                Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                            },
+                            new Post
+                            {
+                                Title = "Announcing F# 5",
+                                Content = "F# 5 is the latest version of F#, the functional programming language..."
+                            },
+                        }
+                    });
+
+                await context.SaveChangesAsync();
+            }
+        }
+
+        public static async Task<Dictionary<DeleteBehavior, string>> GatherData(Func<OptionalBlogsContext, Task> action)
+        {
+            var results = new Dictionary<DeleteBehavior, string>();
+
+            foreach (var deleteBehavior in DeleteBehaviors)
+            {
+                await RecreateCleanDatabase(new OptionalBlogsContext(deleteBehavior));
+                await PopulateDatabase(new OptionalBlogsContext(deleteBehavior));
+
+                try
+                {
+                    using var context = new OptionalBlogsContext(deleteBehavior);
+
+                    await action(context);
+
+                    context.ChangeTracker.DetectChanges();
+
+                    var deletingPosts = context.ChangeTracker.Entries<Post>().Any(e => e.State == EntityState.Deleted);
+                    var settingFksToNull = context.ChangeTracker.Entries<Post>().Any(e => e.State == EntityState.Modified);
+
+                    await context.SaveChangesAsync();
+
+                    var deletedPosts = !(await context.Posts.AsNoTracking().AnyAsync());
+
+                    results[deleteBehavior] =
+                        deletingPosts
+                            ? "Dependents deleted by EF Core"
+                            : deletedPosts
+                                ? "Dependents deleted by database"
+                                : settingFksToNull
+                                    ? "Dependent FKs set to null by EF Core"
+                                    : "Dependent FKs set to null by database";
+                }
+                catch (Exception e)
+                {
+                    results[deleteBehavior] = $"`{e.GetType().Name}`";
+                }
+            }
+
+            return results;
+        }
+    }
+
+    public class OptionalBlogsContext : DbContext
+    {
+        private readonly DeleteBehavior _deleteBehavior;
+        private readonly bool _quiet;
+
+        public OptionalBlogsContext(DeleteBehavior deleteBehavior, bool quiet = true)
+        {
+            _deleteBehavior = deleteBehavior;
+            _quiet = quiet;
+        }
+
+        public DbSet<Blog> Blogs { get; set; }
+        public DbSet<Post> Posts { get; set; }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder
+                .Entity<Blog>()
+                .HasMany(e => e.Posts)
+                .WithOne(e => e.Blog)
+                .OnDelete(_deleteBehavior);
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableServiceProviderCaching(false)
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Scratch;Trusted_Connection=True;ConnectRetryCount=0");
+            //.UseSqlite("DataSource=test.db");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+    }
+}
diff --git a/samples/core/CascadeDeletes/Program.cs b/samples/core/CascadeDeletes/Program.cs
new file mode 100644
index 0000000000..3237432b46
--- /dev/null
+++ b/samples/core/CascadeDeletes/Program.cs
@@ -0,0 +1,33 @@
+using System;
+using System.Threading.Tasks;
+using DatabaseCycles;
+using IntroOptional;
+using IntroRequired;
+using Optional;
+using Required;
+
+public class Program
+{
+    public static async Task Main()
+    {
+        Console.WriteLine("Samples for _Cascade Delete_");
+        Console.WriteLine();
+
+        await IntroRequiredSamples.Deleting_principal_parent_1();
+        await IntroRequiredSamples.Severing_a_relationship_1();
+        await IntroRequiredSamples.Severing_a_relationship_2();
+        await IntroRequiredSamples.Where_cascading_behaviors_happen_1();
+
+        await WithDatabaseCycleSamples.Database_cascade_limitations_1();
+        await WithDatabaseCycleSamples.Database_cascade_limitations_2();
+
+        await IntroOptionalSamples.Deleting_principal_parent_1b();
+        await IntroOptionalSamples.Severing_a_relationship_1b();
+        await IntroOptionalSamples.Severing_a_relationship_2b();
+
+        await RequiredDependentsSamples.Required_relationship_with_dependents_children_loaded();
+        await RequiredDependentsSamples.Required_relationship_with_dependents_children_not_loaded();
+        await OptionalDependentsSamples.Optional_relationship_with_dependents_children_loaded();
+        await OptionalDependentsSamples.Optional_relationship_with_dependents_children_not_loaded();
+    }
+}
diff --git a/samples/core/CascadeDeletes/RequiredDependentsSamples.cs b/samples/core/CascadeDeletes/RequiredDependentsSamples.cs
new file mode 100644
index 0000000000..d7f4bf0352
--- /dev/null
+++ b/samples/core/CascadeDeletes/RequiredDependentsSamples.cs
@@ -0,0 +1,205 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace Required;
+
+public static class RequiredDependentsSamples
+{
+    public static async Task Required_relationship_with_dependents_children_loaded()
+    {
+        Console.WriteLine("#### Required relationship with dependents/children loaded");
+        Console.WriteLine();
+
+        var deleteResults = await Helpers.GatherData(async c => c.Remove(await c.Blogs.Include(e => e.Posts).SingleAsync()));
+        var severResults = await Helpers.GatherData(async c => (await c.Blogs.Include(e => e.Posts).SingleAsync()).Posts.Clear());
+
+        Console.WriteLine(
+            $"| `{"DeleteBehavior".PadRight(16)} | {"On deleting principal/parent".PadRight(40)} | On severing from principal/parent");
+        Console.WriteLine("|:------------------|------------------------------------------|----------------------------------------");
+        foreach (var deleteBehavior in DeleteBehaviors)
+        {
+            Console.WriteLine(
+                $"| `{(deleteBehavior + "`").PadRight(16)} | {deleteResults[deleteBehavior].PadRight(40)} | {severResults[deleteBehavior]}");
+        }
+
+        Console.WriteLine();
+    }
+
+    public static async Task Required_relationship_with_dependents_children_not_loaded()
+    {
+        Console.WriteLine("#### Required relationship with dependents/children not loaded");
+        Console.WriteLine();
+
+        var deleteResults = await Helpers.GatherData(async c => c.Remove(await c.Blogs.SingleAsync()));
+
+        Console.WriteLine(
+            $"| `{"DeleteBehavior".PadRight(16)} | {"On deleting principal/parent".PadRight(40)} | On severing from principal/parent");
+        Console.WriteLine("|:------------------|------------------------------------------|----------------------------------------");
+        foreach (var deleteBehavior in DeleteBehaviors)
+        {
+            Console.WriteLine($"| `{(deleteBehavior + "`").PadRight(16)} | {deleteResults[deleteBehavior].PadRight(40)} | N/A");
+        }
+
+        Console.WriteLine();
+    }
+
+    public static DeleteBehavior[] DeleteBehaviors { get; }
+        =
+        {
+            DeleteBehavior.Cascade, DeleteBehavior.Restrict, DeleteBehavior.NoAction, DeleteBehavior.SetNull,
+            DeleteBehavior.ClientSetNull, DeleteBehavior.ClientCascade, DeleteBehavior.ClientNoAction
+        };
+
+    #region Model
+    public class Blog
+    {
+        public int Id { get; set; }
+
+        public string Name { get; set; }
+
+        public IList<Post> Posts { get; } = new List<Post>();
+    }
+
+    public class Post
+    {
+        public int Id { get; set; }
+
+        public string Title { get; set; }
+        public string Content { get; set; }
+
+        public int BlogId { get; set; }
+        public Blog Blog { get; set; }
+    }
+    #endregion
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase(RequiredBlogsContext context)
+        {
+            using (context)
+            {
+                await context.Database.EnsureDeletedAsync();
+                await context.Database.EnsureCreatedAsync();
+            }
+        }
+
+        public static async Task PopulateDatabase(RequiredBlogsContext context)
+        {
+            using (context)
+            {
+                context.Add(
+                    new Blog
+                    {
+                        Name = ".NET Blog",
+                        Posts =
+                        {
+                            new Post
+                            {
+                                Title = "Announcing the Release of EF Core 5.0",
+                                Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                            },
+                            new Post
+                            {
+                                Title = "Announcing F# 5",
+                                Content = "F# 5 is the latest version of F#, the functional programming language..."
+                            },
+                        }
+                    });
+
+                await context.SaveChangesAsync();
+            }
+        }
+
+        public static async Task<Dictionary<DeleteBehavior, string>> GatherData(Func<RequiredBlogsContext, Task> action)
+        {
+            var results = new Dictionary<DeleteBehavior, string>();
+
+            foreach (var deleteBehavior in DeleteBehaviors)
+            {
+                try
+                {
+                    await RecreateCleanDatabase(new RequiredBlogsContext(deleteBehavior));
+                    await PopulateDatabase(new RequiredBlogsContext(deleteBehavior));
+                }
+                catch (Exception e)
+                {
+                    results[deleteBehavior] = $"`{e.GetType().Name}`";
+                    continue;
+                }
+
+                try
+                {
+                    using var context = new RequiredBlogsContext(deleteBehavior);
+
+                    await action(context);
+
+                    context.ChangeTracker.DetectChanges();
+
+                    var deletingPosts = context.ChangeTracker.Entries<Post>().Any(e => e.State == EntityState.Deleted);
+                    var settingFksToNull = context.ChangeTracker.Entries<Post>().Any(e => e.State == EntityState.Modified);
+
+                    await context.SaveChangesAsync();
+
+                    var deletedPosts = !(await context.Posts.AsNoTracking().AnyAsync());
+
+                    results[deleteBehavior] =
+                        deletingPosts
+                            ? "Dependents deleted by EF Core"
+                            : deletedPosts
+                                ? "Dependents deleted by database"
+                                : settingFksToNull
+                                    ? "Dependent FKs set to null by EF Core"
+                                    : "Dependent FKs set to null by database";
+                }
+                catch (Exception e)
+                {
+                    results[deleteBehavior] = $"`{e.GetType().Name}`";
+                }
+            }
+
+            return results;
+        }
+    }
+
+    public class RequiredBlogsContext : DbContext
+    {
+        private readonly DeleteBehavior _deleteBehavior;
+        private readonly bool _quiet;
+
+        public RequiredBlogsContext(DeleteBehavior deleteBehavior, bool quiet = true)
+        {
+            _deleteBehavior = deleteBehavior;
+            _quiet = quiet;
+        }
+
+        public DbSet<Blog> Blogs { get; set; }
+        public DbSet<Post> Posts { get; set; }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder
+                .Entity<Blog>()
+                .HasMany(e => e.Posts)
+                .WithOne(e => e.Blog)
+                .OnDelete(_deleteBehavior);
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableServiceProviderCaching(false)
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Scratch;Trusted_Connection=True;ConnectRetryCount=0");
+            //.UseSqlite("DataSource=test.db");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+    }
+}
diff --git a/samples/core/CascadeDeletes/WithDatabaseCycleSamples.cs b/samples/core/CascadeDeletes/WithDatabaseCycleSamples.cs
new file mode 100644
index 0000000000..76c59babd5
--- /dev/null
+++ b/samples/core/CascadeDeletes/WithDatabaseCycleSamples.cs
@@ -0,0 +1,181 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace DatabaseCycles;
+
+public static class WithDatabaseCycleSamples
+{
+    public static async Task Database_cascade_limitations_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Database_cascade_limitations_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Database_cascade_limitations_1
+        using var context = new BlogsContext();
+
+        var owner = await context.People.SingleAsync(e => e.Name == "ajcvickers");
+        var blog = await context.Blogs.SingleAsync(e => e.Owner == owner);
+
+        context.Remove(owner);
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Database_cascade_limitations_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Database_cascade_limitations_2)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        try
+        {
+            #region Database_cascade_limitations_2
+            using var context = new BlogsContext();
+
+            var owner = await context.People.SingleAsync(e => e.Name == "ajcvickers");
+
+            context.Remove(owner);
+
+            await context.SaveChangesAsync();
+            #endregion
+        }
+        catch (Exception e)
+        {
+            Console.WriteLine($"{e.GetType().FullName}: {e.Message}");
+            if (e.InnerException != null)
+            {
+                Console.WriteLine($"{e.InnerException.GetType().FullName}: {e.InnerException.Message}");
+            }
+        }
+
+        Console.WriteLine();
+    }
+}
+
+public static class Helpers
+{
+    public static async Task RecreateCleanDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    public static async Task PopulateDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        var person = new Person { Name = "ajcvickers" };
+
+        context.Add(
+            new Blog
+            {
+                Owner = person,
+                Name = ".NET Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform...",
+                        Author = person
+                    },
+                    new Post
+                    {
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language...",
+                        Author = person
+                    },
+                }
+            });
+
+        await context.SaveChangesAsync();
+    }
+}
+
+#region Model
+public class Blog
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>();
+
+    public int OwnerId { get; set; }
+    public Person Owner { get; set; }
+}
+
+public class Post
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int BlogId { get; set; }
+    public Blog Blog { get; set; }
+
+    public int AuthorId { get; set; }
+    public Person Author { get; set; }
+}
+
+public class Person
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>();
+
+    public Blog OwnedBlog { get; set; }
+}
+#endregion
+
+public class BlogsContext : DbContext
+{
+    private readonly bool _quiet;
+
+    public BlogsContext(bool quiet = false)
+    {
+        _quiet = quiet;
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+    public DbSet<Person> People { get; set; }
+
+    #region OnModelCreating
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder
+            .Entity<Blog>()
+            .HasOne(e => e.Owner)
+            .WithOne(e => e.OwnedBlog)
+            .OnDelete(DeleteBehavior.ClientCascade);
+    }
+    #endregion
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .EnableSensitiveDataLogging()
+            .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Scratch;Trusted_Connection=True;ConnectRetryCount=0");
+        //.UseSqlite("DataSource=test.db");
+
+        if (!_quiet)
+        {
+            optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+        }
+    }
+}
diff --git a/samples/core/ChangeTracking/AccessingTrackedEntities/AccessingTrackedEntities.csproj b/samples/core/ChangeTracking/AccessingTrackedEntities/AccessingTrackedEntities.csproj
new file mode 100644
index 0000000000..e5eaa12b40
--- /dev/null
+++ b/samples/core/ChangeTracking/AccessingTrackedEntities/AccessingTrackedEntities.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <TargetFramework>net10.0</TargetFramework>
+        <RootNamespace />
+    </PropertyGroup>
+
+    <ItemGroup>
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.0" />
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+    </ItemGroup>
+
+</Project>
diff --git a/samples/core/ChangeTracking/AccessingTrackedEntities/Program.cs b/samples/core/ChangeTracking/AccessingTrackedEntities/Program.cs
new file mode 100644
index 0000000000..ff72565641
--- /dev/null
+++ b/samples/core/ChangeTracking/AccessingTrackedEntities/Program.cs
@@ -0,0 +1,31 @@
+using System;
+using System.Threading.Tasks;
+
+public class Program
+{
+    public static async Task Main()
+    {
+        Console.WriteLine("Samples for _Accessing Tracked Entities_");
+        Console.WriteLine();
+
+        await Samples.Using_DbContext_Entry_and_EntityEntry_instances_1();
+        await Samples.Work_with_the_entity_1();
+        await Samples.Work_with_the_entity_2();
+        await Samples.Work_with_a_single_property_1();
+        await Samples.Work_with_a_single_navigation_1();
+        await Samples.Work_with_a_single_navigation_2();
+        await Samples.Work_with_all_properties_of_an_entity_1();
+        await Samples.Work_with_all_navigations_of_an_entity_1();
+        await Samples.Work_with_all_members_of_an_entity_1();
+
+        await Samples.Find_and_FindAsync_1();
+        await Samples.Find_and_FindAsync_2();
+
+        await Samples.Using_ChangeTracker_Entries_to_access_all_tracked_entities_1();
+
+        await Samples.Using_DbSet_Local_to_query_tracked_entities_1();
+        await Samples.Using_DbSet_Local_to_query_tracked_entities_2();
+        await Samples.Using_DbSet_Local_to_query_tracked_entities_3();
+        await Samples.Using_DbSet_Local_to_query_tracked_entities_4();
+    }
+}
diff --git a/samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs b/samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs
new file mode 100644
index 0000000000..527c58944d
--- /dev/null
+++ b/samples/core/ChangeTracking/AccessingTrackedEntities/Samples.cs
@@ -0,0 +1,631 @@
+using System;
+using System.Collections.Generic;
+using System.Collections.ObjectModel;
+using System.ComponentModel;
+using System.Diagnostics;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.ChangeTracking;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+
+public static class Samples
+{
+    public static async Task Using_DbContext_Entry_and_EntityEntry_instances_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Using_DbContext_Entry_and_EntityEntry_instances_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Using_DbContext_Entry_and_EntityEntry_instances_1
+        using var context = new BlogsContext();
+
+        var blog = await context.Blogs.SingleAsync(e => e.Id == 1);
+        var entityEntry = context.Entry(blog);
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Work_with_the_entity_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Work_with_the_entity_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var blog = await context.Blogs.SingleAsync(e => e.Id == 1);
+
+        #region Work_with_the_entity_1
+        var currentState = context.Entry(blog).State;
+        if (currentState == EntityState.Unchanged)
+        {
+            context.Entry(blog).State = EntityState.Modified;
+        }
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Work_with_the_entity_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Work_with_the_entity_2)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        #region Work_with_the_entity_2
+        var newBlog = new Blog();
+        Debug.Assert(context.Entry(newBlog).State == EntityState.Detached);
+
+        context.Entry(newBlog).State = EntityState.Added;
+        Debug.Assert(context.Entry(newBlog).State == EntityState.Added);
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Work_with_a_single_property_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Work_with_a_single_property_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        {
+            var blog = await context.Blogs.SingleAsync(e => e.Id == 1);
+
+            #region Work_with_a_single_property_1a
+            PropertyEntry<Blog, string> propertyEntry = context.Entry(blog).Property(e => e.Name);
+            #endregion
+        }
+
+        {
+            var blog = await context.Blogs.SingleAsync(e => e.Id == 1);
+
+            #region Work_with_a_single_property_1b
+            PropertyEntry<Blog, string> propertyEntry = context.Entry(blog).Property<string>("Name");
+            #endregion
+        }
+
+        {
+            var blog = await context.Blogs.SingleAsync(e => e.Id == 1);
+
+            #region Work_with_a_single_property_1c
+            PropertyEntry propertyEntry = context.Entry(blog).Property("Name");
+            #endregion
+        }
+
+        {
+            var blog = await context.Blogs.SingleAsync(e => e.Id == 1);
+
+            #region Work_with_a_single_property_1d
+            string currentValue = context.Entry(blog).Property(e => e.Name).CurrentValue;
+            context.Entry(blog).Property(e => e.Name).CurrentValue = "1unicorn2";
+            #endregion
+        }
+
+        {
+            #region Work_with_a_single_property_1e
+            object blog = await context.Blogs.SingleAsync(e => e.Id == 1);
+
+            object currentValue = context.Entry(blog).Property("Name").CurrentValue;
+            context.Entry(blog).Property("Name").CurrentValue = "1unicorn2";
+            #endregion
+        }
+
+        Console.WriteLine();
+    }
+
+    public static async Task Work_with_a_single_navigation_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Work_with_a_single_navigation_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var post = await context.Posts.Include(e => e.Blog).SingleAsync(e => e.Id == 1);
+
+        #region Work_with_a_single_navigation_1
+        ReferenceEntry<Post, Blog> referenceEntry1 = context.Entry(post).Reference(e => e.Blog);
+        ReferenceEntry<Post, Blog> referenceEntry2 = context.Entry(post).Reference<Blog>("Blog");
+        ReferenceEntry referenceEntry3 = context.Entry(post).Reference("Blog");
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Work_with_a_single_navigation_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Work_with_a_single_navigation_2)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var blog = await context.Blogs.Include(e => e.Posts).SingleAsync(e => e.Id == 1);
+
+        #region Work_with_a_single_navigation_2a
+        CollectionEntry<Blog, Post> collectionEntry1 = context.Entry(blog).Collection(e => e.Posts);
+        CollectionEntry<Blog, Post> collectionEntry2 = context.Entry(blog).Collection<Post>("Posts");
+        CollectionEntry collectionEntry3 = context.Entry(blog).Collection("Posts");
+        #endregion
+
+        #region Work_with_a_single_navigation_2b
+        NavigationEntry navigationEntry = context.Entry(blog).Navigation("Posts");
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Work_with_all_properties_of_an_entity_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Work_with_all_properties_of_an_entity_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var blog = await context.Blogs.Include(e => e.Posts).SingleAsync(e => e.Id == 1);
+
+        #region Work_with_all_properties_of_an_entity_1
+        foreach (var propertyEntry in context.Entry(blog).Properties)
+        {
+            if (propertyEntry.Metadata.ClrType == typeof(DateTime))
+            {
+                propertyEntry.CurrentValue = DateTime.Now;
+            }
+        }
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Work_with_all_properties_of_an_entity_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Work_with_all_properties_of_an_entity_2)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var blog = await context.Blogs.Include(e => e.Posts).SingleAsync(e => e.Id == 1);
+
+        {
+            #region Work_with_all_properties_of_an_entity_2a
+            var currentValues = context.Entry(blog).CurrentValues;
+            var originalValues = context.Entry(blog).OriginalValues;
+            var databaseValues = await context.Entry(blog).GetDatabaseValuesAsync();
+            #endregion
+        }
+
+        {
+            #region Work_with_all_properties_of_an_entity_2b
+            var blogDto = new BlogDto { Id = 1, Name = "1unicorn2" };
+
+            context.Entry(blog).CurrentValues.SetValues(blogDto);
+            #endregion
+        }
+
+        {
+            #region Work_with_all_properties_of_an_entity_2c
+            var databaseValues = await context.Entry(blog).GetDatabaseValuesAsync();
+            context.Entry(blog).CurrentValues.SetValues(databaseValues);
+            context.Entry(blog).OriginalValues.SetValues(databaseValues);
+            #endregion
+        }
+
+        {
+            #region Work_with_all_properties_of_an_entity_2d
+            var blogDictionary = new Dictionary<string, object> { ["Id"] = 1, ["Name"] = "1unicorn2" };
+
+            context.Entry(blog).CurrentValues.SetValues(blogDictionary);
+            #endregion
+        }
+
+        {
+            #region Work_with_all_properties_of_an_entity_2e
+            var clonedBlog = (await context.Entry(blog).GetDatabaseValuesAsync()).ToObject();
+            #endregion
+        }
+
+        Console.WriteLine();
+    }
+
+    public static async Task Work_with_all_navigations_of_an_entity_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Work_with_all_navigations_of_an_entity_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var blog = await context.Blogs.SingleAsync(e => e.Id == 1);
+
+        #region Work_with_all_navigations_of_an_entity_1
+        foreach (var navigationEntry in context.Entry(blog).Navigations)
+        {
+            navigationEntry.Load();
+        }
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Work_with_all_members_of_an_entity_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Work_with_all_members_of_an_entity_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var blog = await context.Blogs.SingleAsync(e => e.Id == 1);
+
+        #region Work_with_all_members_of_an_entity_1
+        foreach (var memberEntry in context.Entry(blog).Members)
+        {
+            Console.WriteLine(
+                $"Member {memberEntry.Metadata.Name} is of type {memberEntry.Metadata.ClrType.ShortDisplayName()} and has value {memberEntry.CurrentValue}");
+        }
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Find_and_FindAsync_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Find_and_FindAsync_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Find_and_FindAsync_1
+        using var context = new BlogsContext();
+
+        Console.WriteLine("First call to Find...");
+        var blog1 = await context.Blogs.FindAsync(1);
+
+        Console.WriteLine($"...found blog {blog1.Name}");
+
+        Console.WriteLine();
+        Console.WriteLine("Second call to Find...");
+        var blog2 = await context.Blogs.FindAsync(1);
+        Debug.Assert(blog1 == blog2);
+
+        Console.WriteLine("...returned the same instance without executing a query.");
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Find_and_FindAsync_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Find_and_FindAsync_2)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+        var orderId = 1;
+        var productId = 2;
+
+        #region Find_and_FindAsync_2
+        var orderline = await context.OrderLines.FindAsync(orderId, productId);
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Using_ChangeTracker_Entries_to_access_all_tracked_entities_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Using_ChangeTracker_Entries_to_access_all_tracked_entities_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Using_ChangeTracker_Entries_to_access_all_tracked_entities_1a
+        using var context = new BlogsContext();
+        var blogs = await context.Blogs.Include(e => e.Posts).ToListAsync();
+
+        foreach (var entityEntry in context.ChangeTracker.Entries())
+        {
+            Console.WriteLine($"Found {entityEntry.Metadata.Name} entity with ID {entityEntry.Property("Id").CurrentValue}");
+        }
+        #endregion
+
+        Console.WriteLine();
+
+        #region Using_ChangeTracker_Entries_to_access_all_tracked_entities_1b
+        foreach (var entityEntry in context.ChangeTracker.Entries<Post>())
+        {
+            Console.WriteLine(
+                $"Found {entityEntry.Metadata.Name} entity with ID {entityEntry.Property(e => e.Id).CurrentValue}");
+        }
+        #endregion
+
+        Console.WriteLine();
+
+        #region Using_ChangeTracker_Entries_to_access_all_tracked_entities_1c
+        foreach (var entityEntry in context.ChangeTracker.Entries<IEntityWithKey>())
+        {
+            Console.WriteLine(
+                $"Found {entityEntry.Metadata.Name} entity with ID {entityEntry.Property(e => e.Id).CurrentValue}");
+        }
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Using_DbSet_Local_to_query_tracked_entities_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Using_DbSet_Local_to_query_tracked_entities_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Using_DbSet_Local_to_query_tracked_entities_1
+        using var context = new BlogsContext();
+
+        await context.Blogs.Include(e => e.Posts).LoadAsync();
+
+        foreach (var blog in context.Blogs.Local)
+        {
+            Console.WriteLine($"Blog: {blog.Name}");
+        }
+
+        foreach (var post in context.Posts.Local)
+        {
+            Console.WriteLine($"Post: {post.Title}");
+        }
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Using_DbSet_Local_to_query_tracked_entities_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Using_DbSet_Local_to_query_tracked_entities_2)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Using_DbSet_Local_to_query_tracked_entities_2
+        using var context = new BlogsContext();
+
+        var posts = await context.Posts.Include(e => e.Blog).ToListAsync();
+
+        Console.WriteLine("Local view after loading posts:");
+
+        foreach (var post in context.Posts.Local)
+        {
+            Console.WriteLine($"  Post: {post.Title}");
+        }
+
+        context.Remove(posts[1]);
+
+        context.Add(
+            new Post
+            {
+                Title = "What’s next for System.Text.Json?",
+                Content = ".NET 5.0 was released recently and has come with many...",
+                Blog = posts[0].Blog
+            });
+
+        Console.WriteLine("Local view after adding and deleting posts:");
+
+        foreach (var post in context.Posts.Local)
+        {
+            Console.WriteLine($"  Post: {post.Title}");
+        }
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Using_DbSet_Local_to_query_tracked_entities_3()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Using_DbSet_Local_to_query_tracked_entities_3)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Using_DbSet_Local_to_query_tracked_entities_3
+        using var context = new BlogsContext();
+
+        var posts = await context.Posts.Include(e => e.Blog).ToListAsync();
+
+        Console.WriteLine("Local view after loading posts:");
+
+        foreach (var post in context.Posts.Local)
+        {
+            Console.WriteLine($"  Post: {post.Title}");
+        }
+
+        context.Posts.Local.Remove(posts[1]);
+
+        context.Posts.Local.Add(
+            new Post
+            {
+                Title = "What’s next for System.Text.Json?",
+                Content = ".NET 5.0 was released recently and has come with many...",
+                Blog = posts[0].Blog
+            });
+
+        Console.WriteLine("Local view after adding and deleting posts:");
+
+        foreach (var post in context.Posts.Local)
+        {
+            Console.WriteLine($"  Post: {post.Title}");
+        }
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Using_DbSet_Local_to_query_tracked_entities_4()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Using_DbSet_Local_to_query_tracked_entities_4)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        await context.Posts.Include(e => e.Blog).LoadAsync();
+
+        #region Using_DbSet_Local_to_query_tracked_entities_4
+        ObservableCollection<Post> observableCollection = context.Posts.Local.ToObservableCollection();
+        BindingList<Post> bindingList = context.Posts.Local.ToBindingList();
+        #endregion
+
+        Console.WriteLine();
+    }
+}
+
+public static class Helpers
+{
+    public static async Task RecreateCleanDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    public static async Task PopulateDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        context.Add(
+            new Blog
+            {
+                Name = ".NET Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    },
+                }
+            });
+
+        await context.SaveChangesAsync();
+    }
+}
+
+#region OrderLine
+public class OrderLine
+{
+    public int OrderId { get; set; }
+    public int ProductId { get; set; }
+
+    //...
+}
+#endregion
+
+#region BlogDto
+public class BlogDto
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+}
+#endregion
+
+public class Blog : IEntityWithKey
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>();
+}
+
+public class Post : IEntityWithKey
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int? BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
+
+#region IEntityWithKey
+public interface IEntityWithKey
+{
+    int Id { get; set; }
+}
+#endregion
+
+public class BlogsContext : DbContext
+{
+    private readonly bool _quiet;
+
+    public BlogsContext(bool quiet = false)
+    {
+        _quiet = quiet;
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+    public DbSet<OrderLine> OrderLines { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .EnableSensitiveDataLogging()
+            .UseSqlite("DataSource=test.db");
+
+        if (!_quiet)
+        {
+            optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+        }
+    }
+
+    #region OnModelCreating
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder
+            .Entity<OrderLine>()
+            .HasKey(e => new { e.OrderId, e.ProductId });
+    }
+    #endregion
+}
diff --git a/samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/AdditionalChangeTrackingFeatures.csproj b/samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/AdditionalChangeTrackingFeatures.csproj
new file mode 100644
index 0000000000..e5eaa12b40
--- /dev/null
+++ b/samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/AdditionalChangeTrackingFeatures.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <TargetFramework>net10.0</TargetFramework>
+        <RootNamespace />
+    </PropertyGroup>
+
+    <ItemGroup>
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.0" />
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+    </ItemGroup>
+
+</Project>
diff --git a/samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/DefaultValueSamples.cs b/samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/DefaultValueSamples.cs
new file mode 100644
index 0000000000..ed1fa5ec04
--- /dev/null
+++ b/samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/DefaultValueSamples.cs
@@ -0,0 +1,272 @@
+using System;
+using System.Diagnostics;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace DefaultValues;
+
+public class DefaultValueSamples
+{
+    public static async Task Working_with_default_values_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Working_with_default_values_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        #region Working_with_default_values_1
+        using var context = new BlogsContext();
+
+        context.AddRange(
+            new Token { Name = "A" },
+            new Token { Name = "B", ValidFrom = new DateTime(1111, 11, 11, 11, 11, 11) });
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Working_with_default_values_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Working_with_default_values_2)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        #region Working_with_default_values_2
+        using var context = new BlogsContext();
+
+        var fooA = new Foo1 { Count = 10 };
+        var fooB = new Foo1 { Count = 0 };
+        var fooC = new Foo1();
+
+        context.AddRange(fooA, fooB, fooC);
+        await context.SaveChangesAsync();
+
+        Debug.Assert(fooA.Count == 10);
+        Debug.Assert(fooB.Count == -1); // Not what we want!
+        Debug.Assert(fooC.Count == -1);
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Working_with_default_values_3()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Working_with_default_values_3)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        #region Working_with_default_values_3
+        using var context = new BlogsContext();
+
+        var fooA = new Foo2 { Count = 10 };
+        var fooB = new Foo2 { Count = 0 };
+        var fooC = new Foo2();
+
+        context.AddRange(fooA, fooB, fooC);
+        await context.SaveChangesAsync();
+
+        Debug.Assert(fooA.Count == 10);
+        Debug.Assert(fooB.Count == 0);
+        Debug.Assert(fooC.Count == -1);
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Working_with_default_values_4()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Working_with_default_values_4)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        #region Working_with_default_values_4
+        using var context = new BlogsContext();
+
+        var fooA = new Foo3 { Count = 10 };
+        var fooB = new Foo3 { Count = 0 };
+        var fooC = new Foo3();
+
+        context.AddRange(fooA, fooB, fooC);
+        await context.SaveChangesAsync();
+
+        Debug.Assert(fooA.Count == 10);
+        Debug.Assert(fooB.Count == 0);
+        Debug.Assert(fooC.Count == -1);
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Working_with_default_values_5()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Working_with_default_values_5)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        #region Working_with_default_values_5
+        using var context = new BlogsContext();
+
+        var userA = new User { Name = "Mac" };
+        var userB = new User { Name = "Alice", IsAuthorized = true };
+        var userC = new User { Name = "Baxter", IsAuthorized = false }; // Always deny Baxter access!
+
+        context.AddRange(userA, userB, userC);
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        Console.WriteLine();
+    }
+}
+
+public static class Helpers
+{
+    public static async Task RecreateCleanDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+}
+
+#region Token
+public class Token
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+    public DateTime ValidFrom { get; set; }
+}
+#endregion
+
+#region Foo1
+public class Foo1
+{
+    public int Id { get; set; }
+    public int Count { get; set; }
+}
+#endregion
+
+#region Foo2
+public class Foo2
+{
+    public int Id { get; set; }
+    public int? Count { get; set; }
+}
+#endregion
+
+#region Foo3
+public class Foo3
+{
+    public int Id { get; set; }
+
+    private int? _count;
+
+    public int Count
+    {
+        get => _count ?? -1;
+        set => _count = value;
+    }
+}
+#endregion
+
+#region Bar
+public class Bar
+{
+    public int Id { get; set; }
+    public int Count { get; set; }
+}
+#endregion
+
+#region User
+public class User
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+
+    private bool? _isAuthorized;
+
+    public bool IsAuthorized
+    {
+        get => _isAuthorized ?? true;
+        set => _isAuthorized = value;
+    }
+}
+#endregion
+
+public class BlogsContext : DbContext
+{
+    private readonly bool _quiet;
+
+    public BlogsContext(bool quiet = false)
+    {
+        _quiet = quiet;
+    }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .EnableSensitiveDataLogging()
+            .UseSqlite("DataSource=test.db");
+
+        if (!_quiet)
+        {
+            optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+        }
+    }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        #region OnModelCreating_Token
+        modelBuilder
+            .Entity<Token>()
+            .Property(e => e.ValidFrom)
+            .HasDefaultValueSql("CURRENT_TIMESTAMP");
+        #endregion
+
+        #region OnModelCreating_Foo1
+        modelBuilder
+            .Entity<Foo1>()
+            .Property(e => e.Count)
+            .HasDefaultValue(-1);
+        #endregion
+
+        #region OnModelCreating_Foo2
+        modelBuilder
+            .Entity<Foo2>()
+            .Property(e => e.Count)
+            .HasDefaultValue(-1);
+        #endregion
+
+        #region OnModelCreating_Foo3
+        modelBuilder
+            .Entity<Foo3>()
+            .Property(e => e.Count)
+            .HasDefaultValue(-1);
+        #endregion
+
+        #region OnModelCreating_User
+        modelBuilder
+            .Entity<User>()
+            .Property(e => e.IsAuthorized)
+            .HasDefaultValue(true);
+        #endregion
+
+        #region OnModelCreating_Bar
+        modelBuilder
+            .Entity<Bar>()
+            .Property(e => e.Count)
+            .HasDefaultValue(-1)
+            .ValueGeneratedNever();
+        #endregion
+    }
+}
diff --git a/samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/Program.cs b/samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/Program.cs
new file mode 100644
index 0000000000..9ab29ed7e0
--- /dev/null
+++ b/samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/Program.cs
@@ -0,0 +1,23 @@
+using System;
+using System.Threading.Tasks;
+using DefaultValues;
+using Optional;
+
+public class Program
+{
+    public static async Task Main()
+    {
+        Console.WriteLine("Samples for _Identity Resolution in EF Core_");
+        Console.WriteLine();
+
+        await Samples.DbContext_versus_DbSet_methods_1();
+        await Samples.Temporary_values_1();
+        await Samples.Temporary_values_2();
+
+        await DefaultValueSamples.Working_with_default_values_1();
+        await DefaultValueSamples.Working_with_default_values_2();
+        await DefaultValueSamples.Working_with_default_values_3();
+        await DefaultValueSamples.Working_with_default_values_4();
+        await DefaultValueSamples.Working_with_default_values_5();
+    }
+}
diff --git a/samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/Samples.cs b/samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/Samples.cs
new file mode 100644
index 0000000000..696969296f
--- /dev/null
+++ b/samples/core/ChangeTracking/AdditionalChangeTrackingFeatures/Samples.cs
@@ -0,0 +1,245 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace Optional;
+
+public class Samples
+{
+    public static async Task DbContext_versus_DbSet_methods_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(DbContext_versus_DbSet_methods_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region DbContext_versus_DbSet_methods_1
+        using var context = new BlogsContext();
+
+        var post = await context.Posts.SingleAsync(e => e.Id == 3);
+        var tag = await context.Tags.SingleAsync(e => e.Id == 1);
+
+        var joinEntitySet = context.Set<Dictionary<string, int>>("PostTag");
+        var joinEntity = new Dictionary<string, int> { ["PostId"] = post.Id, ["TagId"] = tag.Id };
+        joinEntitySet.Add(joinEntity);
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Temporary_values_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Temporary_values_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Temporary_values_1
+        using var context = new BlogsContext();
+
+        var blog = new Blog { Name = ".NET Blog" };
+
+        context.Add(blog);
+
+        Console.WriteLine($"Blog.Id set on entity is {blog.Id}");
+        Console.WriteLine($"Blog.Id tracked by EF is {context.Entry(blog).Property(e => e.Id).CurrentValue}");
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Temporary_values_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Temporary_values_2)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        #region Temporary_values_2
+        var blogs = new List<Blog> { new Blog { Id = -1, Name = ".NET Blog" }, new Blog { Id = -2, Name = "Visual Studio Blog" } };
+
+        var posts = new List<Post>
+        {
+            new Post
+            {
+                Id = -1,
+                BlogId = -1,
+                Title = "Announcing the Release of EF Core 5.0",
+                Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+            },
+            new Post
+            {
+                Id = -2,
+                BlogId = -2,
+                Title = "Disassembly improvements for optimized managed debugging",
+                Content = "If you are focused on squeezing out the last bits of performance for your .NET service or..."
+            }
+        };
+
+        using var context = new BlogsContext();
+
+        foreach (var blog in blogs)
+        {
+            context.Add(blog).Property(e => e.Id).IsTemporary = true;
+        }
+
+        foreach (var post in posts)
+        {
+            context.Add(post).Property(e => e.Id).IsTemporary = true;
+        }
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+        #endregion
+
+        Console.WriteLine();
+    }
+}
+
+public static class Helpers
+{
+    public static async Task RecreateCleanDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    public static async Task PopulateDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        context.AddRange(
+            new Blog
+            {
+                Name = ".NET Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    },
+                },
+            },
+            new Blog
+            {
+                Name = "Visual Studio Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Disassembly improvements for optimized managed debugging",
+                        Content =
+                            "If you are focused on squeezing out the last bits of performance for your .NET service or..."
+                    },
+                    new Post
+                    {
+                        Title = "Database Profiling with Visual Studio",
+                        Content = "Examine when database queries were executed and measure how long the take using..."
+                    },
+                }
+            },
+            new Tag { Text = ".NET" },
+            new Tag { Text = "Visual Studio" },
+            new Tag { Text = "EF Core" });
+
+        await context.SaveChangesAsync();
+    }
+}
+
+#region Model
+public class Blog
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>();
+}
+
+public class Post
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int? BlogId { get; set; }
+    public Blog Blog { get; set; }
+
+    public IList<Tag> Tags { get; } = new List<Tag>();
+}
+
+public class Tag
+{
+    public int Id { get; set; } // Primary key
+    public string Text { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>(); // Collection navigation
+}
+#endregion
+
+public class BlogsContext : DbContext
+{
+    private readonly bool _quiet;
+
+    public BlogsContext(bool quiet = false)
+    {
+        _quiet = quiet;
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+    public DbSet<Tag> Tags { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .EnableSensitiveDataLogging()
+            .UseSqlite("DataSource=test.db");
+
+        if (!_quiet)
+        {
+            optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+        }
+    }
+
+    #region OnModelCreating
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder
+            .SharedTypeEntity<Dictionary<string, int>>(
+                "PostTag",
+                b =>
+                {
+                    b.IndexerProperty<int>("TagId");
+                    b.IndexerProperty<int>("PostId");
+                });
+
+        modelBuilder.Entity<Post>()
+            .HasMany(p => p.Tags)
+            .WithMany(p => p.Posts)
+            .UsingEntity<Dictionary<string, int>>(
+                "PostTag",
+                j => j.HasOne<Tag>().WithMany(),
+                j => j.HasOne<Post>().WithMany());
+    }
+    #endregion
+}
diff --git a/samples/core/ChangeTracking/ChangeDetectionAndNotifications/ChangeDetectionAndNotifications.csproj b/samples/core/ChangeTracking/ChangeDetectionAndNotifications/ChangeDetectionAndNotifications.csproj
new file mode 100644
index 0000000000..e198a361b6
--- /dev/null
+++ b/samples/core/ChangeTracking/ChangeDetectionAndNotifications/ChangeDetectionAndNotifications.csproj
@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <TargetFramework>net10.0</TargetFramework>
+        <RootNamespace />
+    </PropertyGroup>
+
+    <ItemGroup>
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.0" />
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Proxies" Version="10.0.0" />
+    </ItemGroup>
+
+</Project>
diff --git a/samples/core/ChangeTracking/ChangeDetectionAndNotifications/ChangeTrackingProxiesSamples.cs b/samples/core/ChangeTracking/ChangeDetectionAndNotifications/ChangeTrackingProxiesSamples.cs
new file mode 100644
index 0000000000..548717fc87
--- /dev/null
+++ b/samples/core/ChangeTracking/ChangeDetectionAndNotifications/ChangeTrackingProxiesSamples.cs
@@ -0,0 +1,156 @@
+using System;
+using System.Collections.Generic;
+using System.Collections.ObjectModel;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace Proxies;
+
+public class ChangeTrackingProxiesSamples
+{
+    public static async Task Change_tracking_proxies_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Change_tracking_proxies_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Change_tracking_proxies_1
+        using var context = new BlogsContext();
+        var blog = await context.Blogs.Include(e => e.Posts).FirstAsync(e => e.Name == ".NET Blog");
+
+        // Change a property value
+        blog.Name = ".NET Blog (Updated!)";
+
+        // Add a new entity to a navigation
+        blog.Posts.Add(
+            context.CreateProxy<Post>(
+                p =>
+                {
+                    p.Title = "What’s next for System.Text.Json?";
+                    p.Content = ".NET 5.0 was released recently and has come with many...";
+                }));
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+        #endregion
+
+        Console.WriteLine();
+    }
+}
+
+public static class Helpers
+{
+    public static async Task RecreateCleanDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    public static async Task PopulateDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        context.AddRange(
+            context.CreateProxy<Blog>(
+                b =>
+                {
+                    b.Name = ".NET Blog";
+                    b.Posts.Add(
+                        context.CreateProxy<Post>(
+                            p =>
+                            {
+                                p.Title = "Announcing the Release of EF Core 5.0";
+                                p.Content = "Announcing the release of EF Core 5.0, a full featured cross-platform...";
+                            }));
+                    b.Posts.Add(
+                        context.CreateProxy<Post>(
+                            p =>
+                            {
+                                p.Title = "Announcing F# 5";
+                                p.Content = "F# 5 is the latest version of F#, the functional programming language...";
+                            }));
+                }),
+            context.CreateProxy<Blog>(
+                b =>
+                {
+                    b.Name = "Visual Studio Blog";
+                    b.Posts.Add(
+                        context.CreateProxy<Post>(
+                            p =>
+                            {
+                                p.Title = "Disassembly improvements for optimized managed debugging";
+                                p.Content =
+                                    "If you are focused on squeezing out the last bits of performance for your .NET service or...";
+                            }));
+                    b.Posts.Add(
+                        context.CreateProxy<Post>(
+                            p =>
+                            {
+                                p.Title = "Database Profiling with Visual Studio";
+                                p.Content = "Examine when database queries were executed and measure how long the take using...";
+                            }));
+                }));
+
+        await context.SaveChangesAsync();
+    }
+}
+
+#region Model
+public class Blog
+{
+    public virtual int Id { get; set; }
+    public virtual string Name { get; set; }
+
+    public virtual IList<Post> Posts { get; } = new ObservableCollection<Post>();
+}
+
+public class Post
+{
+    public virtual int Id { get; set; }
+    public virtual string Title { get; set; }
+    public virtual string Content { get; set; }
+
+    public virtual int BlogId { get; set; }
+    public virtual Blog Blog { get; set; }
+}
+#endregion
+
+public class BlogsContextBase : DbContext
+{
+    #region OnConfiguring
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.UseChangeTrackingProxies();
+    #endregion
+}
+
+public class BlogsContext : BlogsContextBase
+{
+    private readonly bool _quiet;
+
+    public BlogsContext(bool quiet = false)
+    {
+        _quiet = quiet;
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .EnableSensitiveDataLogging()
+            .UseSqlite("DataSource=test.db");
+
+        if (!_quiet)
+        {
+            optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+        }
+
+        base.OnConfiguring(optionsBuilder);
+    }
+}
diff --git a/samples/core/ChangeTracking/ChangeDetectionAndNotifications/NotificationEntitiesSamples.cs b/samples/core/ChangeTracking/ChangeDetectionAndNotifications/NotificationEntitiesSamples.cs
new file mode 100644
index 0000000000..61091f861f
--- /dev/null
+++ b/samples/core/ChangeTracking/ChangeDetectionAndNotifications/NotificationEntitiesSamples.cs
@@ -0,0 +1,233 @@
+using System;
+using System.Collections.Generic;
+using System.Collections.ObjectModel;
+using System.ComponentModel;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace Notification;
+
+public class NotificationEntitiesSamples
+{
+    public static async Task Notification_entities_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Notification_entities_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Notification_entities_1
+        using var context = new BlogsContext();
+        var blog = await context.Blogs.Include(e => e.Posts).FirstAsync(e => e.Name == ".NET Blog");
+
+        // Change a property value
+        blog.Name = ".NET Blog (Updated!)";
+
+        // Add a new entity to a navigation
+        blog.Posts.Add(
+            new Post
+            {
+                Title = "What’s next for System.Text.Json?", Content = ".NET 5.0 was released recently and has come with many..."
+            });
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+        #endregion
+
+        Console.WriteLine();
+    }
+}
+
+public static class Helpers
+{
+    public static async Task RecreateCleanDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    public static async Task PopulateDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        context.AddRange(
+            new Blog
+            {
+                Name = ".NET Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    },
+                },
+            },
+            new Blog
+            {
+                Name = "Visual Studio Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Disassembly improvements for optimized managed debugging",
+                        Content =
+                            "If you are focused on squeezing out the last bits of performance for your .NET service or..."
+                    },
+                    new Post
+                    {
+                        Title = "Database Profiling with Visual Studio",
+                        Content = "Examine when database queries were executed and measure how long the take using..."
+                    },
+                }
+            });
+
+        await context.SaveChangesAsync();
+    }
+}
+
+#region Model
+public class Blog : INotifyPropertyChanging, INotifyPropertyChanged
+{
+    public event PropertyChangingEventHandler PropertyChanging;
+    public event PropertyChangedEventHandler PropertyChanged;
+
+    private int _id;
+
+    public int Id
+    {
+        get => _id;
+        set
+        {
+            PropertyChanging?.Invoke(this, new PropertyChangingEventArgs(nameof(Id)));
+            _id = value;
+            PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nameof(Id)));
+        }
+    }
+
+    private string _name;
+
+    public string Name
+    {
+        get => _name;
+        set
+        {
+            PropertyChanging?.Invoke(this, new PropertyChangingEventArgs(nameof(Name)));
+            _name = value;
+            PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nameof(Name)));
+        }
+    }
+
+    public IList<Post> Posts { get; } = new ObservableCollection<Post>();
+}
+#endregion
+
+public class Post : INotifyPropertyChanging, INotifyPropertyChanged
+{
+    public event PropertyChangingEventHandler PropertyChanging;
+    public event PropertyChangedEventHandler PropertyChanged;
+
+    private int _id;
+
+    public int Id
+    {
+        get => _id;
+        set
+        {
+            PropertyChanging?.Invoke(this, new PropertyChangingEventArgs(nameof(Id)));
+            _id = value;
+            PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nameof(Id)));
+        }
+    }
+
+    private string _title;
+
+    public string Title
+    {
+        get => _title;
+        set
+        {
+            PropertyChanging?.Invoke(this, new PropertyChangingEventArgs(nameof(Title)));
+            _title = value;
+            PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nameof(Title)));
+        }
+    }
+
+    private string _content;
+
+    public string Content
+    {
+        get => _content;
+        set
+        {
+            PropertyChanging?.Invoke(this, new PropertyChangingEventArgs(nameof(Content)));
+            _content = value;
+            PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nameof(Content)));
+        }
+    }
+
+    private int? _blogId;
+
+    public int? BlogId
+    {
+        get => _blogId;
+        set
+        {
+            PropertyChanging?.Invoke(this, new PropertyChangingEventArgs(nameof(BlogId)));
+            _blogId = value;
+            PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nameof(BlogId)));
+        }
+    }
+
+    private Blog _blog;
+
+    public Blog Blog
+    {
+        get => _blog;
+        set
+        {
+            PropertyChanging?.Invoke(this, new PropertyChangingEventArgs(nameof(Blog)));
+            _blog = value;
+            PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nameof(Blog)));
+        }
+    }
+}
+
+public class BlogsContext : DbContext
+{
+    private readonly bool _quiet;
+
+    public BlogsContext(bool quiet = false)
+    {
+        _quiet = quiet;
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .EnableSensitiveDataLogging()
+            .UseSqlite("DataSource=test.db");
+
+        if (!_quiet)
+        {
+            optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+        }
+    }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.HasChangeTrackingStrategy(ChangeTrackingStrategy.ChangingAndChangedNotifications);
+    }
+}
diff --git a/samples/core/ChangeTracking/ChangeDetectionAndNotifications/NotificationWithBaseSamples.cs b/samples/core/ChangeTracking/ChangeDetectionAndNotifications/NotificationWithBaseSamples.cs
new file mode 100644
index 0000000000..5eb2c6aa97
--- /dev/null
+++ b/samples/core/ChangeTracking/ChangeDetectionAndNotifications/NotificationWithBaseSamples.cs
@@ -0,0 +1,210 @@
+using System;
+using System.Collections.Generic;
+using System.Collections.ObjectModel;
+using System.ComponentModel;
+using System.Linq;
+using System.Runtime.CompilerServices;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace NotificationWithBase;
+
+public class NotificationWithBaseSamples
+{
+    public static async Task Notification_entities_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Notification_entities_2)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Notification_entities_2
+        using var context = new BlogsContext();
+        var blog = await context.Blogs.Include(e => e.Posts).FirstAsync(e => e.Name == ".NET Blog");
+
+        // Change a property value
+        blog.Name = ".NET Blog (Updated!)";
+
+        // Add a new entity to a navigation
+        blog.Posts.Add(
+            new Post
+            {
+                Title = "What’s next for System.Text.Json?", Content = ".NET 5.0 was released recently and has come with many..."
+            });
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+        #endregion
+
+        Console.WriteLine();
+    }
+}
+
+public static class Helpers
+{
+    public static async Task RecreateCleanDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    public static async Task PopulateDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        context.AddRange(
+            new Blog
+            {
+                Name = ".NET Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    },
+                },
+            },
+            new Blog
+            {
+                Name = "Visual Studio Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Disassembly improvements for optimized managed debugging",
+                        Content =
+                            "If you are focused on squeezing out the last bits of performance for your .NET service or..."
+                    },
+                    new Post
+                    {
+                        Title = "Database Profiling with Visual Studio",
+                        Content = "Examine when database queries were executed and measure how long the take using..."
+                    },
+                }
+            });
+
+        await context.SaveChangesAsync();
+    }
+}
+
+public class Post : NotifyingEntity
+{
+    private int _id;
+    private string _title;
+    private string _content;
+    private int? _blogId;
+    private Blog _blog;
+
+    public int Id
+    {
+        get => _id;
+        set => SetWithNotify(value, out _id);
+    }
+
+    public string Title
+    {
+        get => _title;
+        set => SetWithNotify(value, out _title);
+    }
+
+    public string Content
+    {
+        get => _content;
+        set => SetWithNotify(value, out _content);
+    }
+
+    public int? BlogId
+    {
+        get => _blogId;
+        set => SetWithNotify(value, out _blogId);
+    }
+
+    public Blog Blog
+    {
+        get => _blog;
+        set => SetWithNotify(value, out _blog);
+    }
+}
+
+#region Model
+public class Blog : NotifyingEntity
+{
+    private int _id;
+
+    public int Id
+    {
+        get => _id;
+        set => SetWithNotify(value, out _id);
+    }
+
+    private string _name;
+
+    public string Name
+    {
+        get => _name;
+        set => SetWithNotify(value, out _name);
+    }
+
+    public IList<Post> Posts { get; } = new ObservableCollection<Post>();
+}
+
+public abstract class NotifyingEntity : INotifyPropertyChanging, INotifyPropertyChanged
+{
+    protected void SetWithNotify<T>(T value, out T field, [CallerMemberName] string propertyName = "")
+    {
+        NotifyChanging(propertyName);
+        field = value;
+        NotifyChanged(propertyName);
+    }
+
+    public event PropertyChangingEventHandler PropertyChanging;
+    public event PropertyChangedEventHandler PropertyChanged;
+
+    private void NotifyChanged(string propertyName)
+        => PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
+
+    private void NotifyChanging(string propertyName)
+        => PropertyChanging?.Invoke(this, new PropertyChangingEventArgs(propertyName));
+}
+#endregion
+
+public class BlogsContext : DbContext
+{
+    private readonly bool _quiet;
+
+    public BlogsContext(bool quiet = false)
+    {
+        _quiet = quiet;
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .EnableSensitiveDataLogging()
+            .UseSqlite("DataSource=test.db");
+
+        if (!_quiet)
+        {
+            optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+        }
+    }
+
+    #region OnModelCreating
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.HasChangeTrackingStrategy(ChangeTrackingStrategy.ChangingAndChangedNotifications);
+    }
+    #endregion
+}
diff --git a/samples/core/ChangeTracking/ChangeDetectionAndNotifications/Program.cs b/samples/core/ChangeTracking/ChangeDetectionAndNotifications/Program.cs
new file mode 100644
index 0000000000..dbb789642b
--- /dev/null
+++ b/samples/core/ChangeTracking/ChangeDetectionAndNotifications/Program.cs
@@ -0,0 +1,23 @@
+using System;
+using System.Threading.Tasks;
+using Notification;
+using NotificationWithBase;
+using Proxies;
+using Snapshot;
+
+public class Program
+{
+    public static async Task Main()
+    {
+        Console.WriteLine("Samples for _Change Detection and Notifications_");
+        Console.WriteLine();
+
+        await SnapshotSamples.Snapshot_change_tracking_1();
+        await SnapshotSamples.Snapshot_change_tracking_2();
+
+        await NotificationEntitiesSamples.Notification_entities_1();
+        await NotificationWithBaseSamples.Notification_entities_2();
+
+        await ChangeTrackingProxiesSamples.Change_tracking_proxies_1();
+    }
+}
diff --git a/samples/core/ChangeTracking/ChangeDetectionAndNotifications/SnapshotSamples.cs b/samples/core/ChangeTracking/ChangeDetectionAndNotifications/SnapshotSamples.cs
new file mode 100644
index 0000000000..f7f49ad910
--- /dev/null
+++ b/samples/core/ChangeTracking/ChangeDetectionAndNotifications/SnapshotSamples.cs
@@ -0,0 +1,208 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace Snapshot;
+
+public class SnapshotSamples
+{
+    public static async Task Snapshot_change_tracking_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Snapshot_change_tracking_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Snapshot_change_tracking_1
+        using var context = new BlogsContext();
+        var blog = await context.Blogs.Include(e => e.Posts).FirstAsync(e => e.Name == ".NET Blog");
+
+        // Change a property value
+        blog.Name = ".NET Blog (Updated!)";
+
+        // Add a new entity to a navigation
+        blog.Posts.Add(
+            new Post
+            {
+                Title = "What’s next for System.Text.Json?", Content = ".NET 5.0 was released recently and has come with many..."
+            });
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+        context.ChangeTracker.DetectChanges();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Snapshot_change_tracking_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Snapshot_change_tracking_2)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Snapshot_change_tracking_2
+        using var context = new BlogsContext();
+        var blog = await context.Blogs.Include(e => e.Posts).FirstAsync(e => e.Name == ".NET Blog");
+
+        // Change a property value
+        context.Entry(blog).Property(e => e.Name).CurrentValue = ".NET Blog (Updated!)";
+
+        // Add a new entity to the DbContext
+        context.Add(
+            new Post
+            {
+                Blog = blog,
+                Title = "What’s next for System.Text.Json?",
+                Content = ".NET 5.0 was released recently and has come with many..."
+            });
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+        #endregion
+
+        Console.WriteLine();
+    }
+}
+
+public static class Helpers
+{
+    public static async Task RecreateCleanDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    public static async Task PopulateDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        context.AddRange(
+            new Blog
+            {
+                Name = ".NET Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    },
+                },
+            },
+            new Blog
+            {
+                Name = "Visual Studio Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Disassembly improvements for optimized managed debugging",
+                        Content =
+                            "If you are focused on squeezing out the last bits of performance for your .NET service or..."
+                    },
+                    new Post
+                    {
+                        Title = "Database Profiling with Visual Studio",
+                        Content = "Examine when database queries were executed and measure how long the take using..."
+                    },
+                }
+            });
+
+        await context.SaveChangesAsync();
+    }
+}
+
+public class Blog
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>();
+}
+
+public class Post
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int? BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
+
+public class PostTag
+{
+    public int PostId { get; set; }
+    public int TagId { get; set; }
+
+    public DateTime TaggedOn { get; set; }
+    public string TaggedBy { get; set; }
+}
+
+public class BlogsContext : DbContext
+{
+    private readonly bool _quiet;
+
+    public BlogsContext(bool quiet = false)
+    {
+        _quiet = quiet;
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .EnableSensitiveDataLogging()
+            .UseSqlite("DataSource=test.db");
+
+        if (!_quiet)
+        {
+            optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+        }
+    }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<PostTag>().HasKey(e => new { e.PostId, e.TagId });
+    }
+
+    #region SaveChanges
+    public override async Task<int> SaveChangesAsync(CancellationToken cancellationToken = default)
+    {
+        foreach (var entityEntry in ChangeTracker.Entries<PostTag>()) // Detects changes automatically
+        {
+            if (entityEntry.State == EntityState.Added)
+            {
+                entityEntry.Entity.TaggedBy = "ajcvickers";
+                entityEntry.Entity.TaggedOn = DateTime.Now;
+            }
+        }
+
+        try
+        {
+            ChangeTracker.AutoDetectChangesEnabled = false;
+            return await base.SaveChangesAsync(cancellationToken); // Avoid automatically detecting changes again here
+        }
+        finally
+        {
+            ChangeTracker.AutoDetectChangesEnabled = true;
+        }
+    }
+    #endregion
+}
diff --git a/samples/core/ChangeTracking/ChangeTrackerDebugging/ChangeTrackerDebugging.csproj b/samples/core/ChangeTracking/ChangeTrackerDebugging/ChangeTrackerDebugging.csproj
new file mode 100644
index 0000000000..e5eaa12b40
--- /dev/null
+++ b/samples/core/ChangeTracking/ChangeTrackerDebugging/ChangeTrackerDebugging.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <TargetFramework>net10.0</TargetFramework>
+        <RootNamespace />
+    </PropertyGroup>
+
+    <ItemGroup>
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.0" />
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+    </ItemGroup>
+
+</Project>
diff --git a/samples/core/ChangeTracking/ChangeTrackerDebugging/Program.cs b/samples/core/ChangeTracking/ChangeTrackerDebugging/Program.cs
new file mode 100644
index 0000000000..1d6eeb0533
--- /dev/null
+++ b/samples/core/ChangeTracking/ChangeTrackerDebugging/Program.cs
@@ -0,0 +1,14 @@
+using System;
+using System.Threading.Tasks;
+
+public class Program
+{
+    public static async Task Main()
+    {
+        Console.WriteLine("Samples for _Change Tracker Debugging_");
+        Console.WriteLine();
+
+        await Samples.Change_tracker_debug_view_1();
+        await Samples.Change_tracker_logging_1();
+    }
+}
diff --git a/samples/core/ChangeTracking/ChangeTrackerDebugging/Samples.cs b/samples/core/ChangeTracking/ChangeTrackerDebugging/Samples.cs
new file mode 100644
index 0000000000..4c2950281e
--- /dev/null
+++ b/samples/core/ChangeTracking/ChangeTrackerDebugging/Samples.cs
@@ -0,0 +1,242 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+using Microsoft.Extensions.Logging;
+
+public class Samples
+{
+    public static async Task Change_tracker_debug_view_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Change_tracker_debug_view_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Change_tracker_debug_view_1a
+        using var context = new BlogsContext();
+
+        var blogs = await context.Blogs
+            .Include(e => e.Posts).ThenInclude(e => e.Tags)
+            .Include(e => e.Assets)
+            .ToListAsync();
+
+        // Mark something Added
+        blogs[0].Posts.Add(
+            new Post
+            {
+                Title = "What’s next for System.Text.Json?",
+                Content = ".NET 5.0 was released recently and has come with many new features and..."
+            });
+
+        // Mark something Deleted
+        blogs[1].Posts.Remove(blogs[1].Posts[1]);
+
+        // Make something Modified
+        blogs[0].Name = ".NET Blog (All new!)";
+
+        context.ChangeTracker.DetectChanges();
+        #endregion
+
+        Console.WriteLine();
+
+        #region Change_tracker_debug_view_1b
+        Console.WriteLine(context.ChangeTracker.DebugView.ShortView);
+        #endregion
+
+        Console.WriteLine();
+
+        #region Change_tracker_debug_view_1c
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Change_tracker_logging_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Change_tracker_logging_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext(LogLevel.Debug);
+
+        var blogs = await context.Blogs
+            .Include(e => e.Posts).ThenInclude(e => e.Tags)
+            .Include(e => e.Assets)
+            .ToListAsync();
+
+        // Mark something Added
+        blogs[0].Posts.Add(
+            new Post
+            {
+                Title = "What’s next for System.Text.Json?",
+                Content = ".NET 5.0 was released recently and has come with many new features and..."
+            });
+
+        // Mark something Deleted
+        blogs[1].Posts.Remove(blogs[1].Posts[1]);
+
+        // Make something Modified
+        blogs[0].Name = ".NET Blog (All new!)";
+
+        context.ChangeTracker.DetectChanges();
+
+        Console.WriteLine();
+    }
+}
+
+public static class Helpers
+{
+    public static async Task RecreateCleanDatabase()
+    {
+        using var context = new BlogsContext(LogLevel.Error);
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    public static async Task PopulateDatabase()
+    {
+        using var context = new BlogsContext(LogLevel.Error);
+
+        var blogs = new[]
+        {
+            new Blog
+            {
+                Name = ".NET Blog",
+                Assets = new BlogAssets(),
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    },
+                },
+            },
+            new Blog
+            {
+                Name = "Visual Studio Blog",
+                Assets = new BlogAssets(),
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Disassembly improvements for optimized managed debugging",
+                        Content =
+                            "If you are focused on squeezing out the last bits of performance for your .NET service or..."
+                    },
+                    new Post
+                    {
+                        Title = "Database Profiling with Visual Studio",
+                        Content = "Examine when database queries were executed and measure how long the take using..."
+                    },
+                }
+            }
+        };
+
+        var tags = new[]
+        {
+            new Tag { Text = ".NET", Posts = { blogs[0].Posts[0], blogs[0].Posts[1] } },
+            new Tag { Text = "Visual Studio", Posts = { blogs[1].Posts[0], blogs[1].Posts[1] } },
+            new Tag { Text = "EF Core", Posts = { blogs[0].Posts[0] } }
+        };
+
+        context.AddRange(blogs);
+        context.AddRange(tags);
+
+        await context.SaveChangesAsync();
+    }
+}
+
+#region Model
+public class Blog
+{
+    public int Id { get; set; } // Primary key
+    public Guid AssetsId { get; set; } // Alternate key
+    public string Name { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>(); // Collection navigation
+    public BlogAssets Assets { get; set; } // Reference navigation
+}
+
+public class BlogAssets
+{
+    public Guid Id { get; set; } // Primary key and foreign key
+    public byte[] Banner { get; set; }
+
+    public Blog Blog { get; set; } // Reference navigation
+}
+
+public class Post
+{
+    public int Id { get; set; } // Primary key
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int BlogId { get; set; } // Foreign key
+    public Blog Blog { get; set; } // Reference navigation
+
+    public IList<Tag> Tags { get; } = new List<Tag>(); // Skip collection navigation
+}
+
+public class Tag
+{
+    public int Id { get; set; } // Primary key
+    public string Text { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>(); // Skip collection navigation
+}
+#endregion
+
+public class BlogsContext : DbContext
+{
+    private readonly LogLevel _logLevel;
+
+    public BlogsContext(LogLevel logLevel = LogLevel.Information)
+    {
+        _logLevel = logLevel;
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+    public DbSet<BlogAssets> Assets { get; set; }
+    public DbSet<Tag> Tags { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .LogTo(Console.WriteLine, _logLevel)
+            .ConfigureWarnings(w => w.Ignore(RelationalEventId.MultipleCollectionIncludeWarning))
+            .EnableSensitiveDataLogging()
+            .UseSqlite("DataSource=test.db");
+    }
+
+    #region OnModelCreating
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder
+            .Entity<Blog>()
+            .Property(e => e.AssetsId)
+            .ValueGeneratedOnAdd();
+
+        modelBuilder
+            .Entity<BlogAssets>()
+            .HasOne(e => e.Blog)
+            .WithOne(e => e.Assets)
+            .HasForeignKey<BlogAssets>(e => e.Id)
+            .HasPrincipalKey<Blog>(e => e.AssetsId);
+    }
+    #endregion
+}
diff --git a/samples/core/ChangeTracking/ChangeTrackingInEFCore/ChangeTrackingInEFCore.csproj b/samples/core/ChangeTracking/ChangeTrackingInEFCore/ChangeTrackingInEFCore.csproj
new file mode 100644
index 0000000000..e5eaa12b40
--- /dev/null
+++ b/samples/core/ChangeTracking/ChangeTrackingInEFCore/ChangeTrackingInEFCore.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <TargetFramework>net10.0</TargetFramework>
+        <RootNamespace />
+    </PropertyGroup>
+
+    <ItemGroup>
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.0" />
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+    </ItemGroup>
+
+</Project>
diff --git a/samples/core/ChangeTracking/ChangeTrackingInEFCore/ExplicitKeysRequiredSamples.cs b/samples/core/ChangeTracking/ChangeTrackingInEFCore/ExplicitKeysRequiredSamples.cs
new file mode 100644
index 0000000000..425e2ec130
--- /dev/null
+++ b/samples/core/ChangeTracking/ChangeTrackingInEFCore/ExplicitKeysRequiredSamples.cs
@@ -0,0 +1,138 @@
+using System;
+using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations.Schema;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace ExplicitKeysRequired;
+
+public static class ExplicitKeysRequiredSamples
+{
+    public static async Task Deleting_principal_parent_entities_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Deleting_principal_parent_entities_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var blog = await GetDisconnectedBlogAndPosts();
+
+        #region Deleting_principal_parent_entities_1
+        // Attach a blog and associated posts
+        context.Attach(blog);
+
+        // Mark the blog as deleted
+        context.Remove(blog);
+        #endregion
+
+        Console.WriteLine("Before SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine("After SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        Console.WriteLine();
+
+        async Task<Blog> GetDisconnectedBlogAndPosts()
+        {
+            using var tempContext = new BlogsContext();
+            return await tempContext.Blogs.Include(e => e.Posts).SingleAsync();
+        }
+    }
+}
+
+public static class Helpers
+{
+    public static async Task RecreateCleanDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    public static async Task PopulateDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        context.Add(
+            new Blog
+            {
+                Id = 1,
+                Name = ".NET Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Id = 1,
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Id = 2,
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    },
+                }
+            });
+
+        await context.SaveChangesAsync();
+    }
+}
+
+#region Model
+public class Blog
+{
+    [DatabaseGenerated(DatabaseGeneratedOption.None)]
+    public int Id { get; set; }
+
+    public string Name { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>();
+}
+
+public class Post
+{
+    [DatabaseGenerated(DatabaseGeneratedOption.None)]
+    public int Id { get; set; }
+
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
+#endregion
+
+public class BlogsContext : DbContext
+{
+    private readonly bool _quiet;
+
+    public BlogsContext(bool quiet = false)
+    {
+        _quiet = quiet;
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .EnableSensitiveDataLogging()
+            .UseSqlite("DataSource=test.db");
+
+        if (!_quiet)
+        {
+            optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+        }
+    }
+}
diff --git a/samples/core/ChangeTracking/ChangeTrackingInEFCore/ExplicitKeysSamples.cs b/samples/core/ChangeTracking/ChangeTrackingInEFCore/ExplicitKeysSamples.cs
new file mode 100644
index 0000000000..254ecebe2f
--- /dev/null
+++ b/samples/core/ChangeTracking/ChangeTrackingInEFCore/ExplicitKeysSamples.cs
@@ -0,0 +1,446 @@
+using System;
+using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations.Schema;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace ExplicitKeys;
+
+public static class ExplicitKeysSamples
+{
+    public static async Task Inserting_new_entities_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Inserting_new_entities_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        using var context = new BlogsContext();
+
+        #region Inserting_new_entities_1
+        context.Add(
+            new Blog { Id = 1, Name = ".NET Blog", });
+        #endregion
+
+        Console.WriteLine("Before SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine("After SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        Console.WriteLine();
+    }
+
+    public static async Task Inserting_new_entities_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Inserting_new_entities_2)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        using var context = new BlogsContext();
+
+        #region Inserting_new_entities_2
+        context.Add(
+            new Blog
+            {
+                Id = 1,
+                Name = ".NET Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Id = 1,
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Id = 2,
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    }
+                }
+            });
+        #endregion
+
+        Console.WriteLine("Before SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine("After SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        Console.WriteLine();
+    }
+
+    public static async Task Attaching_existing_entities_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Attaching_existing_entities_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        #region Attaching_existing_entities_1
+        context.Attach(
+            new Blog { Id = 1, Name = ".NET Blog", });
+        #endregion
+
+        Console.WriteLine("Before SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine("After SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        Console.WriteLine();
+    }
+
+    public static async Task Attaching_existing_entities_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Attaching_existing_entities_2)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        #region Attaching_existing_entities_2
+        context.Attach(
+            new Blog
+            {
+                Id = 1,
+                Name = ".NET Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Id = 1,
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Id = 2,
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    }
+                }
+            });
+        #endregion
+
+        Console.WriteLine("Before SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine("After SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        Console.WriteLine();
+    }
+
+    public static async Task Updating_existing_entities_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Updating_existing_entities_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        #region Updating_existing_entities_1
+        context.Update(
+            new Blog { Id = 1, Name = ".NET Blog", });
+        #endregion
+
+        Console.WriteLine("Before SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine("After SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        Console.WriteLine();
+    }
+
+    public static async Task Updating_existing_entities_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Updating_existing_entities_2)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        #region Updating_existing_entities_2
+        context.Update(
+            new Blog
+            {
+                Id = 1,
+                Name = ".NET Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Id = 1,
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Id = 2,
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    }
+                }
+            });
+        #endregion
+
+        Console.WriteLine("Before SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine("After SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        Console.WriteLine();
+    }
+
+    public static async Task Deleting_existing_entities_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Deleting_existing_entities_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        #region Deleting_existing_entities_1
+        context.Remove(
+            new Post { Id = 2 });
+        #endregion
+
+        Console.WriteLine("Before SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine("After SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        Console.WriteLine();
+    }
+
+    public static async Task Deleting_dependent_child_entities_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Deleting_dependent_child_entities_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var post = await GetDisconnectedPost();
+
+        #region Deleting_dependent_child_entities_1
+        context.Attach(post);
+        context.Remove(post);
+        #endregion
+
+        Console.WriteLine("Before SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine("After SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        Console.WriteLine();
+
+        async Task<Post> GetDisconnectedPost()
+        {
+            using var tempContext = new BlogsContext();
+            return await tempContext.Posts.FindAsync(2);
+        }
+    }
+
+    public static async Task Deleting_dependent_child_entities_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Deleting_dependent_child_entities_2)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var blog = await GetDisconnectedBlogAndPosts();
+
+        #region Deleting_dependent_child_entities_2
+        // Attach a blog and associated posts
+        context.Attach(blog);
+
+        // Mark one post as Deleted
+        context.Remove(blog.Posts[1]);
+        #endregion
+
+        Console.WriteLine("Before SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine("After SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        Console.WriteLine();
+
+        async Task<Blog> GetDisconnectedBlogAndPosts()
+        {
+            using var tempContext = new BlogsContext();
+            return await tempContext.Blogs.Include(e => e.Posts).SingleAsync();
+        }
+    }
+
+    public static async Task Deleting_principal_parent_entities_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Deleting_principal_parent_entities_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var blog = await GetDisconnectedBlogAndPosts();
+
+        #region Deleting_principal_parent_entities_1
+        // Attach a blog and associated posts
+        context.Attach(blog);
+
+        // Mark the blog as deleted
+        context.Remove(blog);
+        #endregion
+
+        Console.WriteLine("Before SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine("After SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        Console.WriteLine();
+
+        async Task<Blog> GetDisconnectedBlogAndPosts()
+        {
+            using var tempContext = new BlogsContext();
+            return await tempContext.Blogs.Include(e => e.Posts).SingleAsync();
+        }
+    }
+}
+
+public static class Helpers
+{
+    public static async Task RecreateCleanDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    public static async Task PopulateDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        context.Add(
+            new Blog
+            {
+                Id = 1,
+                Name = ".NET Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Id = 1,
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Id = 2,
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    },
+                }
+            });
+
+        await context.SaveChangesAsync();
+    }
+}
+
+#region Model
+public class Blog
+{
+    [DatabaseGenerated(DatabaseGeneratedOption.None)]
+    public int Id { get; set; }
+
+    public string Name { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>();
+}
+
+public class Post
+{
+    [DatabaseGenerated(DatabaseGeneratedOption.None)]
+    public int Id { get; set; }
+
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int? BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
+#endregion
+
+public class BlogsContext : DbContext
+{
+    private readonly bool _quiet;
+
+    public BlogsContext(bool quiet = false)
+    {
+        _quiet = quiet;
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .EnableSensitiveDataLogging()
+            .UseSqlite("DataSource=test.db");
+
+        if (!_quiet)
+        {
+            optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+        }
+    }
+}
diff --git a/samples/core/ChangeTracking/ChangeTrackingInEFCore/GeneratedKeysSamples.cs b/samples/core/ChangeTracking/ChangeTrackingInEFCore/GeneratedKeysSamples.cs
new file mode 100644
index 0000000000..7653d775e6
--- /dev/null
+++ b/samples/core/ChangeTracking/ChangeTrackingInEFCore/GeneratedKeysSamples.cs
@@ -0,0 +1,385 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace GeneratedKeys;
+
+public static class GeneratedKeysSamples
+{
+    public static async Task Simple_query_and_update_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Simple_query_and_update_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Simple_query_and_update_1
+        using var context = new BlogsContext();
+
+        var blog = await context.Blogs.Include(e => e.Posts).FirstAsync(e => e.Name == ".NET Blog");
+
+        blog.Name = ".NET Blog (Updated!)";
+
+        await foreach (var post in blog.Posts.AsQueryable().Where(e => !e.Title.Contains("5.0")).AsAsyncEnumerable())
+        {
+            post.Title = post.Title.Replace("5", "5.0");
+        }
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Simple_query_and_update_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Simple_query_and_update_2)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var blog = await context.Blogs.Include(e => e.Posts).FirstAsync(e => e.Name == ".NET Blog");
+
+        blog.Name = ".NET Blog (Updated!)";
+
+        await foreach (var post in blog.Posts.AsQueryable().Where(e => !e.Title.Contains("5.0")).AsAsyncEnumerable())
+        {
+            post.Title = post.Title.Replace("5", "5.0");
+        }
+
+        #region Simple_query_and_update_2
+        context.ChangeTracker.DetectChanges();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+        #endregion
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+    }
+
+    public static async Task Query_then_insert_update_and_delete_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Query_then_insert_update_and_delete_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Query_then_insert_update_and_delete_1
+        using var context = new BlogsContext();
+
+        var blog = await context.Blogs.Include(e => e.Posts).FirstAsync(e => e.Name == ".NET Blog");
+
+        // Modify property values
+        blog.Name = ".NET Blog (Updated!)";
+
+        // Insert a new Post
+        blog.Posts.Add(
+            new Post
+            {
+                Title = "What’s next for System.Text.Json?", Content = ".NET 5.0 was released recently and has come with many..."
+            });
+
+        // Mark an existing Post as Deleted
+        var postToDelete = blog.Posts.Single(e => e.Title == "Announcing F# 5");
+        context.Remove(postToDelete);
+
+        context.ChangeTracker.DetectChanges();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+        #endregion
+    }
+
+    public static async Task Inserting_new_entities_3()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Inserting_new_entities_3)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        using var context = new BlogsContext();
+
+        #region Inserting_new_entities_3
+        context.Add(
+            new Blog
+            {
+                Name = ".NET Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    }
+                }
+            });
+        #endregion
+
+        Console.WriteLine("Before SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine("After SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        Console.WriteLine();
+    }
+
+    public static async Task Attaching_existing_entities_3()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Attaching_existing_entities_3)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        #region Attaching_existing_entities_3
+        context.Attach(
+            new Blog
+            {
+                Id = 1,
+                Name = ".NET Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Id = 1,
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Id = 2,
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    },
+                    new Post
+                    {
+                        Title = "Announcing .NET 5.0",
+                        Content = ".NET 5.0 includes many enhancements, including single file applications, more..."
+                    },
+                }
+            });
+        #endregion
+
+        Console.WriteLine("Before SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine("After SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        Console.WriteLine();
+    }
+
+    public static async Task Updating_existing_entities_3()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Updating_existing_entities_3)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        #region Updating_existing_entities_3
+        context.Update(
+            new Blog
+            {
+                Id = 1,
+                Name = ".NET Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Id = 1,
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Id = 2,
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    },
+                    new Post
+                    {
+                        Title = "Announcing .NET 5.0",
+                        Content = ".NET 5.0 includes many enhancements, including single file applications, more..."
+                    },
+                }
+            });
+        #endregion
+
+        Console.WriteLine("Before SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine("After SaveChanges:");
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        Console.WriteLine();
+    }
+
+    public static async Task Custom_tracking_with_TrackGraph_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Custom_tracking_with_TrackGraph_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var blog = await context.Blogs.AsNoTracking().Include(e => e.Posts).SingleAsync(e => e.Name == ".NET Blog");
+
+        #region Custom_tracking_with_TrackGraph_1a
+        blog.Posts.Add(
+            new Post
+            {
+                Title = "Announcing .NET 5.0",
+                Content = ".NET 5.0 includes many enhancements, including single file applications, more..."
+            }
+        );
+
+        var toDelete = blog.Posts.Single(e => e.Title == "Announcing F# 5");
+        toDelete.Id = -toDelete.Id;
+        #endregion
+
+        await UpdateBlog(blog);
+
+        Console.WriteLine();
+    }
+
+    #region Custom_tracking_with_TrackGraph_1b
+    public static async Task UpdateBlog(Blog blog)
+    {
+        using var context = new BlogsContext();
+
+        context.ChangeTracker.TrackGraph(
+            blog, node =>
+            {
+                var propertyEntry = node.Entry.Property("Id");
+                var keyValue = (int)propertyEntry.CurrentValue;
+
+                if (keyValue == 0)
+                {
+                    node.Entry.State = EntityState.Added;
+                }
+                else if (keyValue < 0)
+                {
+                    propertyEntry.CurrentValue = -keyValue;
+                    node.Entry.State = EntityState.Deleted;
+                }
+                else
+                {
+                    node.Entry.State = EntityState.Modified;
+                }
+
+                Console.WriteLine($"Tracking {node.Entry.Metadata.DisplayName()} with key value {keyValue} as {node.Entry.State}");
+            });
+
+        await context.SaveChangesAsync();
+    }
+    #endregion
+}
+
+public static class Helpers
+{
+    public static async Task RecreateCleanDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    public static async Task PopulateDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        context.Add(
+            new Blog
+            {
+                Name = ".NET Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    },
+                }
+            });
+
+        await context.SaveChangesAsync();
+    }
+}
+
+#region Model
+public class Blog
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>();
+}
+
+public class Post
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int? BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
+#endregion
+
+public class BlogsContext : DbContext
+{
+    private readonly bool _quiet;
+
+    public BlogsContext(bool quiet = false)
+    {
+        _quiet = quiet;
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .EnableSensitiveDataLogging()
+            .UseSqlite("DataSource=test.db");
+
+        if (!_quiet)
+        {
+            optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+        }
+    }
+}
diff --git a/samples/core/ChangeTracking/ChangeTrackingInEFCore/Program.cs b/samples/core/ChangeTracking/ChangeTrackingInEFCore/Program.cs
new file mode 100644
index 0000000000..f705025b5a
--- /dev/null
+++ b/samples/core/ChangeTracking/ChangeTrackingInEFCore/Program.cs
@@ -0,0 +1,38 @@
+using System;
+using System.Threading.Tasks;
+using ExplicitKeys;
+using ExplicitKeysRequired;
+using GeneratedKeys;
+
+public class Program
+{
+    public static async Task Main()
+    {
+        Console.WriteLine("Samples for _Change Tracking in EF Core_");
+        Console.WriteLine();
+
+        await GeneratedKeysSamples.Simple_query_and_update_1();
+        await GeneratedKeysSamples.Simple_query_and_update_2();
+        await GeneratedKeysSamples.Query_then_insert_update_and_delete_1();
+
+        await ExplicitKeysSamples.Inserting_new_entities_1();
+        await ExplicitKeysSamples.Inserting_new_entities_2();
+        await GeneratedKeysSamples.Inserting_new_entities_3();
+
+        await ExplicitKeysSamples.Attaching_existing_entities_1();
+        await ExplicitKeysSamples.Attaching_existing_entities_2();
+        await GeneratedKeysSamples.Attaching_existing_entities_3();
+
+        await ExplicitKeysSamples.Updating_existing_entities_1();
+        await ExplicitKeysSamples.Updating_existing_entities_2();
+        await GeneratedKeysSamples.Updating_existing_entities_3();
+
+        await ExplicitKeysSamples.Deleting_existing_entities_1();
+        await ExplicitKeysSamples.Deleting_dependent_child_entities_1();
+        await ExplicitKeysSamples.Deleting_dependent_child_entities_2();
+        await ExplicitKeysSamples.Deleting_principal_parent_entities_1();
+        await ExplicitKeysRequiredSamples.Deleting_principal_parent_entities_1();
+
+        await GeneratedKeysSamples.Custom_tracking_with_TrackGraph_1();
+    }
+}
diff --git a/samples/core/ChangeTracking/ChangingFKsAndNavigations/ChangingFKsAndNavigations.csproj b/samples/core/ChangeTracking/ChangingFKsAndNavigations/ChangingFKsAndNavigations.csproj
new file mode 100644
index 0000000000..e5eaa12b40
--- /dev/null
+++ b/samples/core/ChangeTracking/ChangingFKsAndNavigations/ChangingFKsAndNavigations.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <TargetFramework>net10.0</TargetFramework>
+        <RootNamespace />
+    </PropertyGroup>
+
+    <ItemGroup>
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.0" />
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+    </ItemGroup>
+
+</Project>
diff --git a/samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntityAndSkipsSamples.cs b/samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntityAndSkipsSamples.cs
new file mode 100644
index 0000000000..0d34d390bc
--- /dev/null
+++ b/samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntityAndSkipsSamples.cs
@@ -0,0 +1,217 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace JoinEntityWithSkips;
+
+public class ExplicitJoinEntityWithSkipsSamples
+{
+    public static async Task Many_to_many_relationships_3()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Many_to_many_relationships_3)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Many_to_many_relationships_3
+        using var context = new BlogsContext();
+
+        var post = await context.Posts.SingleAsync(e => e.Id == 3);
+        var tag = await context.Tags.SingleAsync(e => e.Id == 1);
+
+        post.Tags.Add(tag);
+
+        context.ChangeTracker.DetectChanges();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Many_to_many_relationships_4()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Many_to_many_relationships_4)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var post = await context.Posts.SingleAsync(e => e.Id == 3);
+        var tag = await context.Tags.SingleAsync(e => e.Id == 1);
+
+        #region Many_to_many_relationships_4
+        context.Add(new PostTag { Post = post, Tag = tag });
+        #endregion
+
+        context.ChangeTracker.DetectChanges();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        Console.WriteLine();
+    }
+
+    public static async Task Many_to_many_relationships_5()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Many_to_many_relationships_5)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var post = await context.Posts.SingleAsync(e => e.Id == 3);
+        var tag = await context.Tags.SingleAsync(e => e.Id == 1);
+
+        #region Many_to_many_relationships_5
+        context.Add(new PostTag { PostId = post.Id, TagId = tag.Id });
+        #endregion
+
+        context.ChangeTracker.DetectChanges();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        Console.WriteLine();
+    }
+}
+
+public static class Helpers
+{
+    public static async Task RecreateCleanDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    public static async Task PopulateDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        context.AddRange(
+            new Blog
+            {
+                Name = ".NET Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    },
+                },
+            },
+            new Blog
+            {
+                Name = "Visual Studio Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Disassembly improvements for optimized managed debugging",
+                        Content =
+                            "If you are focused on squeezing out the last bits of performance for your .NET service or..."
+                    },
+                    new Post
+                    {
+                        Title = "Database Profiling with Visual Studio",
+                        Content = "Examine when database queries were executed and measure how long the take using..."
+                    },
+                }
+            },
+            new Tag { Text = ".NET" },
+            new Tag { Text = "Visual Studio" },
+            new Tag { Text = "EF Core" });
+
+        await context.SaveChangesAsync();
+    }
+}
+
+public class Blog
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>();
+}
+
+#region Model
+public class Post
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int? BlogId { get; set; }
+    public Blog Blog { get; set; }
+
+    public IList<Tag> Tags { get; } = new List<Tag>(); // Skip collection navigation
+    public IList<PostTag> PostTags { get; } = new List<PostTag>(); // Collection navigation
+}
+
+public class Tag
+{
+    public int Id { get; set; }
+    public string Text { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>(); // Skip collection navigation
+    public IList<PostTag> PostTags { get; } = new List<PostTag>(); // Collection navigation
+}
+
+public class PostTag
+{
+    public int PostId { get; set; } // First part of composite PK; FK to Post
+    public int TagId { get; set; } // Second part of composite PK; FK to Tag
+
+    public Post Post { get; set; } // Reference navigation
+    public Tag Tag { get; set; } // Reference navigation
+}
+#endregion
+
+public class BlogsContext : DbContext
+{
+    private readonly bool _quiet;
+
+    public BlogsContext(bool quiet = false)
+    {
+        _quiet = quiet;
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+    public DbSet<Tag> Tags { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .EnableSensitiveDataLogging()
+            .UseSqlite("DataSource=test.db");
+
+        if (!_quiet)
+        {
+            optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+        }
+    }
+
+    #region OnModelCreating
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>()
+            .HasMany(p => p.Tags)
+            .WithMany(p => p.Posts)
+            .UsingEntity<PostTag>(
+                j => j.HasOne(t => t.Tag).WithMany(p => p.PostTags),
+                j => j.HasOne(t => t.Post).WithMany(p => p.PostTags));
+    }
+    #endregion
+}
diff --git a/samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntitySamples.cs b/samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntitySamples.cs
new file mode 100644
index 0000000000..ea86b10a85
--- /dev/null
+++ b/samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntitySamples.cs
@@ -0,0 +1,187 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace JoinEntity;
+
+public class ExplicitJoinEntitySamples
+{
+    public static async Task Many_to_many_relationships_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Many_to_many_relationships_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Many_to_many_relationships_1
+        using var context = new BlogsContext();
+
+        var post = await context.Posts.SingleAsync(e => e.Id == 3);
+        var tag = await context.Tags.SingleAsync(e => e.Id == 1);
+
+        context.Add(new PostTag { PostId = post.Id, TagId = tag.Id });
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+        #endregion
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+    }
+
+    public static async Task Many_to_many_relationships_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Many_to_many_relationships_2)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var post = await context.Posts.SingleAsync(e => e.Id == 3);
+        var tag = await context.Tags.SingleAsync(e => e.Id == 1);
+
+        #region Many_to_many_relationships_2
+        context.Add(new PostTag { Post = post, Tag = tag });
+        #endregion
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+    }
+}
+
+public static class Helpers
+{
+    public static async Task RecreateCleanDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    public static async Task PopulateDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        context.AddRange(
+            new Blog
+            {
+                Name = ".NET Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    },
+                },
+            },
+            new Blog
+            {
+                Name = "Visual Studio Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Disassembly improvements for optimized managed debugging",
+                        Content =
+                            "If you are focused on squeezing out the last bits of performance for your .NET service or..."
+                    },
+                    new Post
+                    {
+                        Title = "Database Profiling with Visual Studio",
+                        Content = "Examine when database queries were executed and measure how long the take using..."
+                    },
+                }
+            },
+            new Tag { Text = ".NET" },
+            new Tag { Text = "Visual Studio" },
+            new Tag { Text = "EF Core" });
+
+        await context.SaveChangesAsync();
+    }
+}
+
+public class Blog
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>();
+}
+
+#region Model
+public class Post
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int? BlogId { get; set; }
+    public Blog Blog { get; set; }
+
+    public IList<PostTag> PostTags { get; } = new List<PostTag>(); // Collection navigation
+}
+
+public class Tag
+{
+    public int Id { get; set; }
+    public string Text { get; set; }
+
+    public IList<PostTag> PostTags { get; } = new List<PostTag>(); // Collection navigation
+}
+
+public class PostTag
+{
+    public int PostId { get; set; } // First part of composite PK; FK to Post
+    public int TagId { get; set; } // Second part of composite PK; FK to Tag
+
+    public Post Post { get; set; } // Reference navigation
+    public Tag Tag { get; set; } // Reference navigation
+}
+#endregion
+
+public class BlogsContext : DbContext
+{
+    private readonly bool _quiet;
+
+    public BlogsContext(bool quiet = false)
+    {
+        _quiet = quiet;
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+    public DbSet<Tag> Tags { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .EnableSensitiveDataLogging()
+            .UseSqlite("DataSource=test.db");
+
+        if (!_quiet)
+        {
+            optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+        }
+    }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<PostTag>().HasKey(e => new { e.PostId, e.TagId });
+    }
+}
diff --git a/samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntityWithPayloadSamples.cs b/samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntityWithPayloadSamples.cs
new file mode 100644
index 0000000000..36091c738f
--- /dev/null
+++ b/samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntityWithPayloadSamples.cs
@@ -0,0 +1,170 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace JoinEntityWithPayload;
+
+public class ExplicitJoinEntityWithPayloadSamples
+{
+    public static async Task Many_to_many_relationships_7()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Many_to_many_relationships_7)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Many_to_many_relationships_7
+        using var context = new BlogsContext();
+
+        var post = await context.Posts.SingleAsync(e => e.Id == 3);
+        var tag = await context.Tags.SingleAsync(e => e.Id == 1);
+
+        post.Tags.Add(tag);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+        #endregion
+
+        Console.WriteLine();
+    }
+}
+
+public static class Helpers
+{
+    public static async Task RecreateCleanDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    public static async Task PopulateDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        context.AddRange(
+            new Blog
+            {
+                Name = ".NET Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    },
+                },
+            },
+            new Blog
+            {
+                Name = "Visual Studio Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Disassembly improvements for optimized managed debugging",
+                        Content =
+                            "If you are focused on squeezing out the last bits of performance for your .NET service or..."
+                    },
+                    new Post
+                    {
+                        Title = "Database Profiling with Visual Studio",
+                        Content = "Examine when database queries were executed and measure how long the take using..."
+                    },
+                }
+            },
+            new Tag { Text = ".NET" },
+            new Tag { Text = "Visual Studio" },
+            new Tag { Text = "EF Core" });
+
+        await context.SaveChangesAsync();
+    }
+}
+
+public class Blog
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>();
+}
+
+public class Post
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int? BlogId { get; set; }
+    public Blog Blog { get; set; }
+
+    public IList<Tag> Tags { get; } = new List<Tag>(); // Skip collection navigation
+}
+
+public class Tag
+{
+    public int Id { get; set; }
+    public string Text { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>(); // Skip collection navigation
+}
+
+#region Model
+public class PostTag
+{
+    public int PostId { get; set; } // First part of composite PK; FK to Post
+    public int TagId { get; set; } // Second part of composite PK; FK to Tag
+
+    public DateTime TaggedOn { get; set; } // Payload
+}
+#endregion
+
+public class BlogsContext : DbContext
+{
+    private readonly bool _quiet;
+
+    public BlogsContext(bool quiet = false)
+    {
+        _quiet = quiet;
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+    public DbSet<Tag> Tags { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .EnableSensitiveDataLogging()
+            .UseSqlite("DataSource=test.db");
+
+        if (!_quiet)
+        {
+            optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+        }
+    }
+
+    #region OnModelCreating
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>()
+            .HasMany(p => p.Tags)
+            .WithMany(p => p.Posts)
+            .UsingEntity<PostTag>(
+                j => j.HasOne<Tag>().WithMany(),
+                j => j.HasOne<Post>().WithMany(),
+                j => j.Property(e => e.TaggedOn).HasDefaultValueSql("CURRENT_TIMESTAMP"));
+    }
+    #endregion
+}
diff --git a/samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntityWithStringPayloadSamples.cs b/samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntityWithStringPayloadSamples.cs
new file mode 100644
index 0000000000..ac0d22f45e
--- /dev/null
+++ b/samples/core/ChangeTracking/ChangingFKsAndNavigations/ExplicitJoinEntityWithStringPayloadSamples.cs
@@ -0,0 +1,218 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace JoinEntityWithStringPayload;
+
+public class ExplicitJoinEntityWithStringPayloadSamples
+{
+    public static async Task Many_to_many_relationships_8()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Many_to_many_relationships_8)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Many_to_many_relationships_8
+        using var context = new BlogsContext();
+
+        var post = await context.Posts.SingleAsync(e => e.Id == 3);
+        var tag = await context.Tags.SingleAsync(e => e.Id == 1);
+
+        post.Tags.Add(tag);
+
+        context.ChangeTracker.DetectChanges();
+
+        var joinEntity = await context.Set<PostTag>().FindAsync(post.Id, tag.Id);
+
+        joinEntity.TaggedBy = "ajcvickers";
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Many_to_many_relationships_9()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Many_to_many_relationships_9)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Many_to_many_relationships_9
+        using var context = new BlogsContext();
+
+        var post = context.Posts.SingleAsync(e => e.Id == 3);
+        var tag = context.Tags.SingleAsync(e => e.Id == 1);
+
+        context.Add(
+            new PostTag { PostId = post.Id, TagId = tag.Id, TaggedBy = "ajcvickers" });
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+        #endregion
+
+        Console.WriteLine();
+    }
+}
+
+public static class Helpers
+{
+    public static async Task RecreateCleanDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    public static async Task PopulateDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        context.AddRange(
+            new Blog
+            {
+                Name = ".NET Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    },
+                },
+            },
+            new Blog
+            {
+                Name = "Visual Studio Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Disassembly improvements for optimized managed debugging",
+                        Content =
+                            "If you are focused on squeezing out the last bits of performance for your .NET service or..."
+                    },
+                    new Post
+                    {
+                        Title = "Database Profiling with Visual Studio",
+                        Content = "Examine when database queries were executed and measure how long the take using..."
+                    },
+                }
+            },
+            new Tag { Text = ".NET" },
+            new Tag { Text = "Visual Studio" },
+            new Tag { Text = "EF Core" });
+
+        await context.SaveChangesAsync();
+    }
+}
+
+public class Blog
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>();
+}
+
+public class Post
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int? BlogId { get; set; }
+    public Blog Blog { get; set; }
+
+    public IList<Tag> Tags { get; } = new List<Tag>(); // Skip collection navigation
+}
+
+public class Tag
+{
+    public int Id { get; set; }
+    public string Text { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>(); // Skip collection navigation
+}
+
+#region Model
+public class PostTag
+{
+    public int PostId { get; set; } // First part of composite PK; FK to Post
+    public int TagId { get; set; } // Second part of composite PK; FK to Tag
+
+    public DateTime TaggedOn { get; set; } // Auto-generated payload property
+    public string TaggedBy { get; set; } // Not-generated payload property
+}
+#endregion
+
+public class BlogsContext : DbContext
+{
+    private readonly bool _quiet;
+
+    public BlogsContext(bool quiet = false)
+    {
+        _quiet = quiet;
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+    public DbSet<Tag> Tags { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .EnableSensitiveDataLogging()
+            .UseSqlite("DataSource=test.db");
+
+        if (!_quiet)
+        {
+            optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+        }
+    }
+
+    #region OnModelCreating
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>()
+            .HasMany(p => p.Tags)
+            .WithMany(p => p.Posts)
+            .UsingEntity<PostTag>(
+                j => j.HasOne<Tag>().WithMany(),
+                j => j.HasOne<Post>().WithMany(),
+                j => j.Property(e => e.TaggedOn).HasDefaultValueSql("CURRENT_TIMESTAMP"));
+    }
+    #endregion
+
+    #region SaveChanges
+    public override async Task<int> SaveChangesAsync(CancellationToken cancellationToken = default)
+    {
+        foreach (var entityEntry in ChangeTracker.Entries<PostTag>())
+        {
+            if (entityEntry.State == EntityState.Added)
+            {
+                entityEntry.Entity.TaggedBy = "ajcvickers";
+            }
+        }
+
+        return await base.SaveChangesAsync(cancellationToken);
+    }
+    #endregion
+}
diff --git a/samples/core/ChangeTracking/ChangingFKsAndNavigations/OptionalRelationshipsSamples.cs b/samples/core/ChangeTracking/ChangingFKsAndNavigations/OptionalRelationshipsSamples.cs
new file mode 100644
index 0000000000..39fa02741e
--- /dev/null
+++ b/samples/core/ChangeTracking/ChangingFKsAndNavigations/OptionalRelationshipsSamples.cs
@@ -0,0 +1,429 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace Optional;
+
+public class OptionalRelationshipsSamples
+{
+    public static async Task Relationship_fixup_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Relationship_fixup_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Relationship_fixup_1
+        using var context = new BlogsContext();
+
+        var blogs = await context.Blogs
+            .Include(e => e.Posts)
+            .Include(e => e.Assets)
+            .ToListAsync();
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Relationship_fixup_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Relationship_fixup_2)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Relationship_fixup_2
+        using var context = new BlogsContext();
+
+        var blogs = await context.Blogs.ToListAsync();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        var assets = await context.Assets.ToListAsync();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        var posts = await context.Posts.ToListAsync();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Changing_relationships_using_navigations_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Changing_relationships_using_navigations_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Changing_relationships_using_navigations_1
+        using var context = new BlogsContext();
+
+        var dotNetBlog = await context.Blogs.Include(e => e.Posts).SingleAsync(e => e.Name == ".NET Blog");
+        var vsBlog = await context.Blogs.Include(e => e.Posts).SingleAsync(e => e.Name == "Visual Studio Blog");
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        var post = vsBlog.Posts.Single(e => e.Title.StartsWith("Disassembly improvements"));
+        vsBlog.Posts.Remove(post);
+        dotNetBlog.Posts.Add(post);
+
+        context.ChangeTracker.DetectChanges();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Changing_relationships_using_navigations_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Changing_relationships_using_navigations_2)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var dotNetBlog = await context.Blogs.Include(e => e.Posts).SingleAsync(e => e.Name == ".NET Blog");
+        var vsBlog = await context.Blogs.Include(e => e.Posts).SingleAsync(e => e.Name == "Visual Studio Blog");
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        #region Changing_relationships_using_navigations_2
+        var post = vsBlog.Posts.Single(e => e.Title.StartsWith("Disassembly improvements"));
+        post.Blog = dotNetBlog;
+        #endregion
+
+        context.ChangeTracker.DetectChanges();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+    }
+
+    public static async Task Changing_relationships_using_foreign_key_values_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Changing_relationships_using_foreign_key_values_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var dotNetBlog = await context.Blogs.Include(e => e.Posts).SingleAsync(e => e.Name == ".NET Blog");
+        var vsBlog = await context.Blogs.Include(e => e.Posts).SingleAsync(e => e.Name == "Visual Studio Blog");
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        #region Changing_relationships_using_foreign_key_values_1
+        var post = vsBlog.Posts.Single(e => e.Title.StartsWith("Disassembly improvements"));
+        post.BlogId = dotNetBlog.Id;
+        #endregion
+
+        context.ChangeTracker.DetectChanges();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+    }
+
+    public static async Task Fixup_for_added_or_deleted_entities_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Fixup_for_added_or_deleted_entities_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var dotNetBlog = await context.Blogs.Include(e => e.Posts).SingleAsync(e => e.Name == ".NET Blog");
+        var vsBlog = await context.Blogs.Include(e => e.Posts).SingleAsync(e => e.Name == "Visual Studio Blog");
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        #region Fixup_for_added_or_deleted_entities_1
+        var post = vsBlog.Posts.Single(e => e.Title.StartsWith("Disassembly improvements"));
+        vsBlog.Posts.Remove(post);
+        dotNetBlog.Posts.Add(post);
+        #endregion
+
+        context.ChangeTracker.DetectChanges();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+    }
+
+    public static async Task Fixup_for_added_or_deleted_entities_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Fixup_for_added_or_deleted_entities_2)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var dotNetBlog = await context.Blogs.Include(e => e.Posts).SingleAsync(e => e.Name == ".NET Blog");
+        var vsBlog = await context.Blogs.Include(e => e.Posts).SingleAsync(e => e.Name == "Visual Studio Blog");
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        #region Fixup_for_added_or_deleted_entities_2
+        var post = vsBlog.Posts.Single(e => e.Title.StartsWith("Disassembly improvements"));
+        dotNetBlog.Posts.Add(post);
+        #endregion
+
+        context.ChangeTracker.DetectChanges();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+    }
+
+    public static async Task Fixup_for_added_or_deleted_entities_3()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Fixup_for_added_or_deleted_entities_3)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var dotNetBlog = await context.Blogs.Include(e => e.Posts).SingleAsync(e => e.Name == ".NET Blog");
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        #region Fixup_for_added_or_deleted_entities_3
+        var post = dotNetBlog.Posts.Single(e => e.Title == "Announcing F# 5");
+        dotNetBlog.Posts.Remove(post);
+        #endregion
+
+        context.ChangeTracker.DetectChanges();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+    }
+
+    public static async Task Fixup_for_added_or_deleted_entities_7()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Fixup_for_added_or_deleted_entities_7)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Fixup_for_added_or_deleted_entities_7
+        using var context = new BlogsContext();
+
+        var dotNetBlog = await context.Blogs.Include(e => e.Assets).SingleAsync(e => e.Name == ".NET Blog");
+        dotNetBlog.Assets = new BlogAssets();
+
+        context.ChangeTracker.DetectChanges();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Deleting_an_entity_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Deleting_an_entity_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Deleting_an_entity_1
+        using var context = new BlogsContext();
+
+        var vsBlog = await context.Blogs
+            .Include(e => e.Posts)
+            .Include(e => e.Assets)
+            .SingleAsync(e => e.Name == "Visual Studio Blog");
+
+        context.Remove(vsBlog);
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Many_to_many_relationships_6()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Many_to_many_relationships_6)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Many_to_many_relationships_6
+        using var context = new BlogsContext();
+
+        var post = await context.Posts.SingleAsync(e => e.Id == 3);
+        var tag = await context.Tags.SingleAsync(e => e.Id == 1);
+
+        post.Tags.Add(tag);
+
+        context.ChangeTracker.DetectChanges();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+        #endregion
+
+        Console.WriteLine();
+    }
+}
+
+public static class Helpers
+{
+    public static async Task RecreateCleanDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    public static async Task PopulateDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        context.AddRange(
+            new Blog
+            {
+                Name = ".NET Blog",
+                Assets = new BlogAssets(),
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    },
+                },
+            },
+            new Blog
+            {
+                Name = "Visual Studio Blog",
+                Assets = new BlogAssets(),
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Disassembly improvements for optimized managed debugging",
+                        Content =
+                            "If you are focused on squeezing out the last bits of performance for your .NET service or..."
+                    },
+                    new Post
+                    {
+                        Title = "Database Profiling with Visual Studio",
+                        Content = "Examine when database queries were executed and measure how long the take using..."
+                    },
+                }
+            },
+            new Tag { Text = ".NET" },
+            new Tag { Text = "Visual Studio" },
+            new Tag { Text = "EF Core" });
+
+        await context.SaveChangesAsync();
+    }
+}
+
+#region Model
+public class Blog
+{
+    public int Id { get; set; } // Primary key
+    public string Name { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>(); // Collection navigation
+    public BlogAssets Assets { get; set; } // Reference navigation
+}
+
+public class BlogAssets
+{
+    public int Id { get; set; } // Primary key
+    public byte[] Banner { get; set; }
+
+    public int? BlogId { get; set; } // Foreign key
+    public Blog Blog { get; set; } // Reference navigation
+}
+
+public class Post
+{
+    public int Id { get; set; } // Primary key
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int? BlogId { get; set; } // Foreign key
+    public Blog Blog { get; set; } // Reference navigation
+
+    public IList<Tag> Tags { get; } = new List<Tag>(); // Skip collection navigation
+}
+
+public class Tag
+{
+    public int Id { get; set; } // Primary key
+    public string Text { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>(); // Skip collection navigation
+}
+#endregion
+
+public class BlogsContext : DbContext
+{
+    private readonly bool _quiet;
+
+    public BlogsContext(bool quiet = false)
+    {
+        _quiet = quiet;
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+    public DbSet<BlogAssets> Assets { get; set; }
+    public DbSet<Tag> Tags { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .EnableSensitiveDataLogging()
+            .UseSqlite("DataSource=test.db");
+
+        if (!_quiet)
+        {
+            optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+        }
+    }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+    }
+}
diff --git a/samples/core/ChangeTracking/ChangingFKsAndNavigations/Program.cs b/samples/core/ChangeTracking/ChangingFKsAndNavigations/Program.cs
new file mode 100644
index 0000000000..3974e2c204
--- /dev/null
+++ b/samples/core/ChangeTracking/ChangingFKsAndNavigations/Program.cs
@@ -0,0 +1,47 @@
+using System;
+using System.Threading.Tasks;
+using JoinEntity;
+using JoinEntityWithPayload;
+using JoinEntityWithSkips;
+using JoinEntityWithStringPayload;
+using Optional;
+using Required;
+
+public class Program
+{
+    public static async Task Main()
+    {
+        Console.WriteLine("Samples for _Changing Foreign Keys and Navigations_");
+        Console.WriteLine();
+
+        await OptionalRelationshipsSamples.Relationship_fixup_1();
+        await OptionalRelationshipsSamples.Relationship_fixup_2();
+
+        await OptionalRelationshipsSamples.Changing_relationships_using_navigations_1();
+        await OptionalRelationshipsSamples.Changing_relationships_using_navigations_2();
+
+        await OptionalRelationshipsSamples.Changing_relationships_using_foreign_key_values_1();
+
+        await OptionalRelationshipsSamples.Fixup_for_added_or_deleted_entities_1();
+        await OptionalRelationshipsSamples.Fixup_for_added_or_deleted_entities_2();
+        await OptionalRelationshipsSamples.Fixup_for_added_or_deleted_entities_3();
+        await RequiredRelationshipsSamples.Fixup_for_added_or_deleted_entities_4();
+        await RequiredRelationshipsSamples.Fixup_for_added_or_deleted_entities_5();
+        await RequiredRelationshipsSamples.Fixup_for_added_or_deleted_entities_6();
+        await OptionalRelationshipsSamples.Fixup_for_added_or_deleted_entities_7();
+        await RequiredRelationshipsSamples.Fixup_for_added_or_deleted_entities_8();
+
+        await OptionalRelationshipsSamples.Deleting_an_entity_1();
+        await RequiredRelationshipsSamples.Deleting_an_entity_2();
+
+        await ExplicitJoinEntitySamples.Many_to_many_relationships_1();
+        await ExplicitJoinEntitySamples.Many_to_many_relationships_2();
+        await ExplicitJoinEntityWithSkipsSamples.Many_to_many_relationships_3();
+        await ExplicitJoinEntityWithSkipsSamples.Many_to_many_relationships_4();
+        await ExplicitJoinEntityWithSkipsSamples.Many_to_many_relationships_5();
+        await OptionalRelationshipsSamples.Many_to_many_relationships_6();
+        await ExplicitJoinEntityWithPayloadSamples.Many_to_many_relationships_7();
+        await ExplicitJoinEntityWithStringPayloadSamples.Many_to_many_relationships_8();
+        await ExplicitJoinEntityWithStringPayloadSamples.Many_to_many_relationships_9();
+    }
+}
diff --git a/samples/core/ChangeTracking/ChangingFKsAndNavigations/RequiredRelationshipsSamples.cs b/samples/core/ChangeTracking/ChangingFKsAndNavigations/RequiredRelationshipsSamples.cs
new file mode 100644
index 0000000000..37f9c86ffb
--- /dev/null
+++ b/samples/core/ChangeTracking/ChangingFKsAndNavigations/RequiredRelationshipsSamples.cs
@@ -0,0 +1,283 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.ChangeTracking;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace Required;
+
+public class RequiredRelationshipsSamples
+{
+    public static async Task Fixup_for_added_or_deleted_entities_4()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Fixup_for_added_or_deleted_entities_4)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var dotNetBlog = await context.Blogs.Include(e => e.Posts).SingleAsync(e => e.Name == ".NET Blog");
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        #region Fixup_for_added_or_deleted_entities_4
+        var post = dotNetBlog.Posts.Single(e => e.Title == "Announcing F# 5");
+        dotNetBlog.Posts.Remove(post);
+        #endregion
+
+        context.ChangeTracker.DetectChanges();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+    }
+
+    public static async Task Fixup_for_added_or_deleted_entities_5()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Fixup_for_added_or_deleted_entities_5)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var dotNetBlog = await context.Blogs.Include(e => e.Posts).SingleAsync(e => e.Name == ".NET Blog");
+        var vsBlog = await context.Blogs.Include(e => e.Posts).SingleAsync(e => e.Name == "Visual Studio Blog");
+
+        #region Fixup_for_added_or_deleted_entities_5
+        context.ChangeTracker.DeleteOrphansTiming = CascadeTiming.OnSaveChanges;
+
+        var post = vsBlog.Posts.Single(e => e.Title.StartsWith("Disassembly improvements"));
+        vsBlog.Posts.Remove(post);
+
+        context.ChangeTracker.DetectChanges();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        dotNetBlog.Posts.Add(post);
+
+        context.ChangeTracker.DetectChanges();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Fixup_for_added_or_deleted_entities_6()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Fixup_for_added_or_deleted_entities_6)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        try
+        {
+            #region Fixup_for_added_or_deleted_entities_6
+            var dotNetBlog = await context.Blogs.Include(e => e.Posts).SingleAsync(e => e.Name == ".NET Blog");
+
+            context.ChangeTracker.DeleteOrphansTiming = CascadeTiming.Never;
+
+            var post = dotNetBlog.Posts.Single(e => e.Title == "Announcing F# 5");
+            dotNetBlog.Posts.Remove(post);
+
+            await context.SaveChangesAsync(); // Throws
+            #endregion
+        }
+        catch (Exception e)
+        {
+            Console.WriteLine($"{e.GetType().FullName}: {e.Message}");
+        }
+
+        Console.WriteLine();
+    }
+
+    public static async Task Fixup_for_added_or_deleted_entities_8()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Fixup_for_added_or_deleted_entities_8)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Fixup_for_added_or_deleted_entities_8
+        using var context = new BlogsContext();
+
+        var dotNetBlog = await context.Blogs.Include(e => e.Assets).SingleAsync(e => e.Name == ".NET Blog");
+        dotNetBlog.Assets = new BlogAssets();
+
+        context.ChangeTracker.DetectChanges();
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Deleting_an_entity_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Deleting_an_entity_2)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Deleting_an_entity_2
+        using var context = new BlogsContext();
+
+        var vsBlog = await context.Blogs
+            .Include(e => e.Posts)
+            .Include(e => e.Assets)
+            .SingleAsync(e => e.Name == "Visual Studio Blog");
+
+        context.Remove(vsBlog);
+
+        Console.WriteLine(context.ChangeTracker.DebugView.LongView);
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        Console.WriteLine();
+    }
+}
+
+public static class Helpers
+{
+    public static async Task RecreateCleanDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    public static async Task PopulateDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        context.AddRange(
+            new Blog
+            {
+                Name = ".NET Blog",
+                Assets = new BlogAssets(),
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    },
+                },
+            },
+            new Blog
+            {
+                Name = "Visual Studio Blog",
+                Assets = new BlogAssets(),
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Disassembly improvements for optimized managed debugging",
+                        Content =
+                            "If you are focused on squeezing out the last bits of performance for your .NET service or..."
+                    },
+                    new Post
+                    {
+                        Title = "Database Profiling with Visual Studio",
+                        Content = "Examine when database queries were executed and measure how long the take using..."
+                    },
+                }
+            },
+            new Tag { Text = ".NET" },
+            new Tag { Text = "Visual Studio" },
+            new Tag { Text = "EF Core" });
+
+        await context.SaveChangesAsync();
+    }
+}
+
+#region Model
+public class Blog
+{
+    public int Id { get; set; } // Primary key
+    public string Name { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>(); // Collection navigation
+    public BlogAssets Assets { get; set; } // Reference navigation
+}
+
+public class BlogAssets
+{
+    public int Id { get; set; } // Primary key
+    public byte[] Banner { get; set; }
+
+    public int BlogId { get; set; } // Foreign key
+    public Blog Blog { get; set; } // Reference navigation
+}
+
+public class Post
+{
+    public int Id { get; set; } // Primary key
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int BlogId { get; set; } // Foreign key
+    public Blog Blog { get; set; } // Reference navigation
+
+    public IList<Tag> Tags { get; } = new List<Tag>(); // Collection navigation
+}
+
+public class Tag
+{
+    public int Id { get; set; } // Primary key
+    public string Text { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>(); // Collection navigation
+}
+#endregion
+
+public class BlogsContext : DbContext
+{
+    private readonly bool _quiet;
+
+    public BlogsContext(bool quiet = false)
+    {
+        _quiet = quiet;
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+    public DbSet<BlogAssets> Assets { get; set; }
+    public DbSet<Tag> Tags { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .EnableSensitiveDataLogging()
+            .UseSqlite("DataSource=test.db");
+
+        if (!_quiet)
+        {
+            optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+        }
+    }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+    }
+}
diff --git a/samples/core/ChangeTracking/IdentityResolutionInEFCore/IdentityResolutionInEFCore.csproj b/samples/core/ChangeTracking/IdentityResolutionInEFCore/IdentityResolutionInEFCore.csproj
new file mode 100644
index 0000000000..1599379cee
--- /dev/null
+++ b/samples/core/ChangeTracking/IdentityResolutionInEFCore/IdentityResolutionInEFCore.csproj
@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <TargetFramework>net10.0</TargetFramework>
+        <RootNamespace />
+    </PropertyGroup>
+
+    <ItemGroup>
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.0" />
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+        <PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
+    </ItemGroup>
+
+</Project>
diff --git a/samples/core/ChangeTracking/IdentityResolutionInEFCore/IdentityResolutionSamples.cs b/samples/core/ChangeTracking/IdentityResolutionInEFCore/IdentityResolutionSamples.cs
new file mode 100644
index 0000000000..2d4a85a7c3
--- /dev/null
+++ b/samples/core/ChangeTracking/IdentityResolutionInEFCore/IdentityResolutionSamples.cs
@@ -0,0 +1,332 @@
+using System;
+using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations.Schema;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace Updates;
+
+public static class IdentityResolutionSamples
+{
+    public static async Task Identity_Resolution_in_EF_Core_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Identity_Resolution_in_EF_Core_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Identity_Resolution_in_EF_Core_1
+        using var context = new BlogsContext();
+
+        var blogA = await context.Blogs.SingleAsync(e => e.Id == 1);
+        var blogB = new Blog { Id = 1, Name = ".NET Blog (All new!)" };
+
+        try
+        {
+            context.Update(blogB); // This will throw
+        }
+        catch (Exception e)
+        {
+            Console.WriteLine($"{e.GetType().FullName}: {e.Message}");
+        }
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static async Task Updating_an_entity_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Updating_an_entity_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        await UpdateFromHttpPost1(
+            new Blog { Id = 1, Name = ".NET Blog (All new!)", Summary = "Posts about .NET" });
+
+        Console.WriteLine();
+    }
+
+    #region Updating_an_entity_1
+    public static async Task UpdateFromHttpPost1(Blog blog)
+    {
+        using var context = new BlogsContext();
+
+        context.Update(blog);
+
+        await context.SaveChangesAsync();
+    }
+    #endregion
+
+    public static async Task Updating_an_entity_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Updating_an_entity_2)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        await UpdateFromHttpPost2(
+            new Blog { Id = 1, Name = ".NET Blog (All new!)", Summary = "Posts about .NET" });
+
+        Console.WriteLine();
+    }
+
+    #region Updating_an_entity_2
+    public static async Task UpdateFromHttpPost2(Blog blog)
+    {
+        using var context = new BlogsContext();
+
+        var trackedBlog = await context.Blogs.FindAsync(blog.Id);
+
+        trackedBlog.Name = blog.Name;
+        trackedBlog.Summary = blog.Summary;
+
+        await context.SaveChangesAsync();
+    }
+    #endregion
+
+    public static async Task Updating_an_entity_3()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Updating_an_entity_3)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        await UpdateFromHttpPost3(
+            new Blog { Id = 1, Name = ".NET Blog (All new!)", Summary = "Posts about .NET" });
+
+        Console.WriteLine();
+    }
+
+    #region Updating_an_entity_3
+    public static async Task UpdateFromHttpPost3(Blog blog)
+    {
+        using var context = new BlogsContext();
+
+        var trackedBlog = await context.Blogs.FindAsync(blog.Id);
+
+        context.Entry(trackedBlog).CurrentValues.SetValues(blog);
+
+        await context.SaveChangesAsync();
+    }
+    #endregion
+
+    public static async Task Updating_an_entity_4()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Updating_an_entity_4)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        await UpdateFromHttpPost4(
+            new BlogDto { Id = 1, Name = ".NET Blog (All new!)", Summary = "Posts about .NET" });
+
+        Console.WriteLine();
+    }
+
+    #region Updating_an_entity_4
+    public static async Task UpdateFromHttpPost4(BlogDto dto)
+    {
+        using var context = new BlogsContext();
+
+        var trackedBlog = await context.Blogs.FindAsync(dto.Id);
+
+        context.Entry(trackedBlog).CurrentValues.SetValues(dto);
+
+        await context.SaveChangesAsync();
+    }
+    #endregion
+
+    public static async Task Updating_an_entity_5()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Updating_an_entity_5)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        await UpdateFromHttpPost5(
+            new Dictionary<string, object> { ["Id"] = 1, ["Name"] = ".NET Blog (All new!)", ["Summary"] = "Posts about .NET" });
+
+        Console.WriteLine();
+    }
+
+    #region Updating_an_entity_5
+    public static async Task UpdateFromHttpPost5(Dictionary<string, object> propertyValues)
+    {
+        using var context = new BlogsContext();
+
+        var trackedBlog = await context.Blogs.FindAsync(propertyValues["Id"]);
+
+        context.Entry(trackedBlog).CurrentValues.SetValues(propertyValues);
+
+        await context.SaveChangesAsync();
+    }
+    #endregion
+
+    public static async Task Updating_an_entity_6()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Updating_an_entity_6)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        await UpdateFromHttpPost6(
+            new Blog { Id = 1, Name = ".NET Blog (All new!)", Summary = "Posts about .NET" },
+            new Dictionary<string, object> { ["Id"] = 1, ["Name"] = ".NET Blog", ["Summary"] = "Posts about .NET" });
+
+        Console.WriteLine();
+    }
+
+    #region Updating_an_entity_6
+    public static async Task UpdateFromHttpPost6(Blog blog, Dictionary<string, object> originalValues)
+    {
+        using var context = new BlogsContext();
+
+        context.Attach(blog);
+        context.Entry(blog).OriginalValues.SetValues(originalValues);
+
+        await context.SaveChangesAsync();
+    }
+    #endregion
+
+    public static void Failing_to_set_key_values_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Failing_to_set_key_values_1)}");
+        Console.WriteLine();
+
+        #region Failing_to_set_key_values_1
+        using var context = new BlogsContext();
+
+        context.Add(new Pet { Name = "Smokey" });
+
+        try
+        {
+            context.Add(new Pet { Name = "Clippy" }); // This will throw
+        }
+        catch (Exception e)
+        {
+            Console.WriteLine($"{e.GetType().FullName}: {e.Message}");
+        }
+        #endregion
+    }
+}
+
+public static class Helpers
+{
+    public static async Task RecreateCleanDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    public static async Task PopulateDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        context.Add(
+            new Blog
+            {
+                Name = ".NET Blog",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    },
+                }
+            });
+
+        await context.SaveChangesAsync();
+    }
+}
+
+#region Pet
+public class Pet
+{
+    [DatabaseGenerated(DatabaseGeneratedOption.None)]
+    public int Id { get; set; }
+
+    public string Name { get; set; }
+}
+#endregion
+
+public class Customer
+{
+    #region OrdersCollection
+    public ICollection<Order> Orders { get; set; }
+        = new HashSet<Order>(ReferenceEqualityComparer.Instance);
+    #endregion
+}
+
+public class Order
+{
+}
+
+public class BlogDto
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+    public string Summary { get; set; }
+}
+
+public class Blog
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+    public string Summary { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>();
+}
+
+public class Post
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int? BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
+
+public class BlogsContext : DbContext
+{
+    private readonly bool _quiet;
+
+    public BlogsContext(bool quiet = false)
+    {
+        _quiet = quiet;
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+    public DbSet<Pet> Pets { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .EnableSensitiveDataLogging()
+            .UseSqlite("DataSource=test.db");
+
+        if (!_quiet)
+        {
+            optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+        }
+    }
+}
diff --git a/samples/core/ChangeTracking/IdentityResolutionInEFCore/Program.cs b/samples/core/ChangeTracking/IdentityResolutionInEFCore/Program.cs
new file mode 100644
index 0000000000..c16dc0fe9c
--- /dev/null
+++ b/samples/core/ChangeTracking/IdentityResolutionInEFCore/Program.cs
@@ -0,0 +1,29 @@
+using System;
+using System.Threading.Tasks;
+using Graphs;
+using Updates;
+
+public class Program
+{
+    public static async Task Main()
+    {
+        Console.WriteLine("Samples for _Identity Resolution in EF Core_");
+        Console.WriteLine();
+
+        await IdentityResolutionSamples.Identity_Resolution_in_EF_Core_1();
+        await IdentityResolutionSamples.Updating_an_entity_1();
+        await IdentityResolutionSamples.Updating_an_entity_2();
+        await IdentityResolutionSamples.Updating_an_entity_3();
+        await IdentityResolutionSamples.Updating_an_entity_4();
+        await IdentityResolutionSamples.Updating_an_entity_5();
+        await IdentityResolutionSamples.Updating_an_entity_6();
+
+        await SerializedGraphExamples.Attaching_a_serialized_graph_1();
+        await SerializedGraphExamples.Attaching_a_serialized_graph_2();
+        await SerializedGraphExamples.Attaching_a_serialized_graph_3();
+        await SerializedGraphExamples.Attaching_a_serialized_graph_4();
+        await SerializedGraphExamples.Attaching_a_serialized_graph_5();
+
+        IdentityResolutionSamples.Failing_to_set_key_values_1();
+    }
+}
diff --git a/samples/core/ChangeTracking/IdentityResolutionInEFCore/ReferenceEqualityComparer.cs b/samples/core/ChangeTracking/IdentityResolutionInEFCore/ReferenceEqualityComparer.cs
new file mode 100644
index 0000000000..9a8ba9f62c
--- /dev/null
+++ b/samples/core/ChangeTracking/IdentityResolutionInEFCore/ReferenceEqualityComparer.cs
@@ -0,0 +1,17 @@
+using System.Collections.Generic;
+using System.Runtime.CompilerServices;
+
+#region ReferenceEqualityComparer
+public sealed class ReferenceEqualityComparer : IEqualityComparer<object>
+{
+    private ReferenceEqualityComparer()
+    {
+    }
+
+    public static ReferenceEqualityComparer Instance { get; } = new ReferenceEqualityComparer();
+
+    bool IEqualityComparer<object>.Equals(object x, object y) => x == y;
+
+    int IEqualityComparer<object>.GetHashCode(object obj) => RuntimeHelpers.GetHashCode(obj);
+}
+#endregion
diff --git a/samples/core/ChangeTracking/IdentityResolutionInEFCore/SerializedGraphExamples.cs b/samples/core/ChangeTracking/IdentityResolutionInEFCore/SerializedGraphExamples.cs
new file mode 100644
index 0000000000..6f4c2ce39c
--- /dev/null
+++ b/samples/core/ChangeTracking/IdentityResolutionInEFCore/SerializedGraphExamples.cs
@@ -0,0 +1,321 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+using Newtonsoft.Json;
+using JsonSerializer = System.Text.Json.JsonSerializer;
+
+namespace Graphs;
+
+public static class SerializedGraphExamples
+{
+    public static async Task Attaching_a_serialized_graph_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Attaching_a_serialized_graph_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Attaching_a_serialized_graph_1a
+        using var context = new BlogsContext();
+
+        var blogs = await context.Blogs.Include(e => e.Posts).ToListAsync();
+
+        var serialized = JsonConvert.SerializeObject(
+            blogs,
+            new JsonSerializerSettings { ReferenceLoopHandling = ReferenceLoopHandling.Ignore, Formatting = Formatting.Indented });
+
+        Console.WriteLine(serialized);
+        #endregion
+
+        await UpdateBlogsFromJson(serialized);
+    }
+
+    #region Attaching_a_serialized_graph_1b
+    public static async Task UpdateBlogsFromJson(string json)
+    {
+        using var context = new BlogsContext();
+
+        var blogs = JsonConvert.DeserializeObject<List<Blog>>(json);
+
+        foreach (var blog in blogs)
+        {
+            context.Update(blog);
+        }
+
+        await context.SaveChangesAsync();
+    }
+    #endregion
+
+    public static async Task Attaching_a_serialized_graph_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Attaching_a_serialized_graph_2)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        #region Attaching_a_serialized_graph_2
+        using var context = new BlogsContext();
+
+        var posts = await context.Posts.Include(e => e.Blog).ToListAsync();
+
+        var serialized = JsonConvert.SerializeObject(
+            posts,
+            new JsonSerializerSettings { ReferenceLoopHandling = ReferenceLoopHandling.Ignore, Formatting = Formatting.Indented });
+
+        Console.WriteLine(serialized);
+        #endregion
+
+        await UpdatePostsFromJsonBad(serialized);
+    }
+
+    public static async Task UpdatePostsFromJsonBad(string json)
+    {
+        using var context = new BlogsContext();
+
+        var posts = JsonConvert.DeserializeObject<List<Post>>(json);
+
+        try
+        {
+            foreach (var post in posts)
+            {
+                context.Update(post); // Will throw
+            }
+
+            await context.SaveChangesAsync();
+        }
+        catch (Exception e)
+        {
+            Console.WriteLine($"{e.GetType().FullName}: {e.Message}");
+        }
+    }
+
+    public static async Task Attaching_a_serialized_graph_3()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Attaching_a_serialized_graph_3)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var posts = await context.Posts.Include(e => e.Blog).ToListAsync();
+
+        #region Attaching_a_serialized_graph_3
+        var serialized = JsonConvert.SerializeObject(
+            posts,
+            new JsonSerializerSettings
+            {
+                PreserveReferencesHandling = PreserveReferencesHandling.All, Formatting = Formatting.Indented
+            });
+        #endregion
+
+        Console.WriteLine(serialized);
+
+        await UpdatePostsFromJson(serialized);
+    }
+
+    public static async Task UpdatePostsFromJson(string json)
+    {
+        using var context = new BlogsContext();
+
+        var posts = JsonConvert.DeserializeObject<List<Post>>(json);
+
+        foreach (var post in posts)
+        {
+            context.Update(post);
+        }
+
+        await context.SaveChangesAsync();
+    }
+
+    public static async Task Attaching_a_serialized_graph_4()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Attaching_a_serialized_graph_4)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var posts = await context.Posts.Include(e => e.Blog).ToListAsync();
+
+        #region Attaching_a_serialized_graph_4
+        var serialized = JsonSerializer.Serialize(
+            posts, new JsonSerializerOptions { ReferenceHandler = ReferenceHandler.Preserve, WriteIndented = true });
+        #endregion
+
+        Console.WriteLine(serialized);
+
+        await UpdatePostsFromJson(serialized);
+    }
+
+    public static async Task Attaching_a_serialized_graph_5()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Attaching_a_serialized_graph_4)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BlogsContext();
+
+        var posts = await context.Posts.Include(e => e.Blog).ToListAsync();
+
+        var serialized = JsonConvert.SerializeObject(
+            posts,
+            new JsonSerializerSettings { ReferenceLoopHandling = ReferenceLoopHandling.Ignore, Formatting = Formatting.Indented });
+
+        Console.WriteLine(serialized);
+
+        Console.WriteLine();
+
+        await UpdatePostsFromJsonWithIdentityResolution(serialized);
+    }
+
+    #region Attaching_a_serialized_graph_5
+    public static async Task UpdatePostsFromJsonWithIdentityResolution(string json)
+    {
+        using var context = new BlogsContext();
+
+        var posts = JsonConvert.DeserializeObject<List<Post>>(json);
+
+        foreach (var post in posts)
+        {
+            context.ChangeTracker.TrackGraph(
+                post, node =>
+                {
+                    var keyValue = node.Entry.Property("Id").CurrentValue;
+                    var entityType = node.Entry.Metadata;
+
+                    var existingEntity = node.Entry.Context.ChangeTracker.Entries()
+                        .FirstOrDefault(
+                            e => Equals(e.Metadata, entityType)
+                                 && Equals(e.Property("Id").CurrentValue, keyValue));
+
+                    if (existingEntity == null)
+                    {
+                        Console.WriteLine($"Tracking {entityType.DisplayName()} entity with key value {keyValue}");
+
+                        node.Entry.State = EntityState.Modified;
+                    }
+                    else
+                    {
+                        Console.WriteLine($"Discarding duplicate {entityType.DisplayName()} entity with key value {keyValue}");
+                    }
+                });
+        }
+
+        await context.SaveChangesAsync();
+    }
+    #endregion
+}
+
+public static class Helpers
+{
+    public static async Task RecreateCleanDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    public static async Task PopulateDatabase()
+    {
+        using var context = new BlogsContext(quiet: true);
+
+        context.AddRange(
+            new Blog
+            {
+                Name = ".NET Blog",
+                Summary = "Posts about .NET",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Announcing the Release of EF Core 5.0",
+                        Content = "Announcing the release of EF Core 5.0, a full featured cross-platform..."
+                    },
+                    new Post
+                    {
+                        Title = "Announcing F# 5",
+                        Content = "F# 5 is the latest version of F#, the functional programming language..."
+                    },
+                },
+            },
+            new Blog
+            {
+                Name = "Visual Studio Blog",
+                Summary = "Posts about Visual Studio",
+                Posts =
+                {
+                    new Post
+                    {
+                        Title = "Disassembly improvements for optimized managed debugging",
+                        Content =
+                            "If you are focused on squeezing out the last bits of performance for your .NET service or..."
+                    },
+                    new Post
+                    {
+                        Title = "Database Profiling with Visual Studio",
+                        Content = "Examine when database queries were executed and measure how long the take using..."
+                    },
+                }
+            });
+
+        await context.SaveChangesAsync();
+    }
+}
+
+public class Blog
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+    public string Summary { get; set; }
+
+    public IList<Post> Posts { get; } = new List<Post>();
+}
+
+public class Post
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int? BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
+
+public class BlogsContext : DbContext
+{
+    private readonly bool _quiet;
+
+    public BlogsContext(bool quiet = false)
+    {
+        _quiet = quiet;
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .EnableSensitiveDataLogging()
+            .UseSqlite("DataSource=test.db");
+
+        if (!_quiet)
+        {
+            optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+        }
+    }
+}
diff --git a/samples/core/Cosmos/Cosmos.csproj b/samples/core/Cosmos/Cosmos.csproj
new file mode 100644
index 0000000000..081b2b9a60
--- /dev/null
+++ b/samples/core/Cosmos/Cosmos.csproj
@@ -0,0 +1,12 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Cosmos" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Cosmos/ModelBuilding/Distributor.cs b/samples/core/Cosmos/ModelBuilding/Distributor.cs
new file mode 100644
index 0000000000..4de432e37b
--- /dev/null
+++ b/samples/core/Cosmos/ModelBuilding/Distributor.cs
@@ -0,0 +1,12 @@
+using System.Collections.Generic;
+
+namespace Cosmos.ModelBuilding;
+
+#region Distributor
+public class Distributor
+{
+    public int Id { get; set; }
+    public string ETag { get; set; }
+    public ICollection<StreetAddress> ShippingCenters { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Cosmos/ModelBuilding/OptionsContext.cs b/samples/core/Cosmos/ModelBuilding/OptionsContext.cs
new file mode 100644
index 0000000000..ccdf9d18d9
--- /dev/null
+++ b/samples/core/Cosmos/ModelBuilding/OptionsContext.cs
@@ -0,0 +1,29 @@
+using System;
+using System.Net;
+using Microsoft.Azure.Cosmos;
+using Microsoft.EntityFrameworkCore;
+
+namespace Cosmos.ModelBuilding;
+
+public class OptionsContext : DbContext
+{
+    #region Configuration
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.UseCosmos(
+            "AccountEndpoint=https://localhost:8081/;AccountKey=C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==",
+            databaseName: "OptionsDB",
+            options =>
+            {
+                options.ConnectionMode(ConnectionMode.Gateway);
+                options.WebProxy(new WebProxy());
+                options.LimitToEndpoint();
+                options.Region(Regions.AustraliaCentral);
+                options.GatewayModeMaxConnectionLimit(32);
+                options.MaxRequestsPerTcpConnection(8);
+                options.MaxTcpConnectionsPerEndpoint(16);
+                options.IdleTcpConnectionTimeout(TimeSpan.FromMinutes(1));
+                options.OpenTcpConnectionTimeout(TimeSpan.FromMinutes(1));
+                options.RequestTimeout(TimeSpan.FromMinutes(1));
+            });
+    #endregion
+}
\ No newline at end of file
diff --git a/samples/core/Cosmos/ModelBuilding/Order.cs b/samples/core/Cosmos/ModelBuilding/Order.cs
new file mode 100644
index 0000000000..5300738b44
--- /dev/null
+++ b/samples/core/Cosmos/ModelBuilding/Order.cs
@@ -0,0 +1,11 @@
+namespace Cosmos.ModelBuilding;
+
+#region Order
+public class Order
+{
+    public int Id { get; set; }
+    public int? TrackingNumber { get; set; }
+    public string PartitionKey { get; set; }
+    public StreetAddress ShippingAddress { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Cosmos/ModelBuilding/OrderContext.cs b/samples/core/Cosmos/ModelBuilding/OrderContext.cs
new file mode 100644
index 0000000000..27f49a9fac
--- /dev/null
+++ b/samples/core/Cosmos/ModelBuilding/OrderContext.cs
@@ -0,0 +1,65 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace Cosmos.ModelBuilding;
+
+public class OrderContext : DbContext
+{
+    public DbSet<Order> Orders { get; set; }
+    public DbSet<Distributor> Distributors { get; set; }
+
+    #region Configuration
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.UseCosmos(
+            "https://localhost:8081",
+            "C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==",
+            databaseName: "OrdersDB");
+    #endregion
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        #region DefaultContainer
+        modelBuilder.HasDefaultContainer("Store");
+        #endregion
+
+        #region Container
+        modelBuilder.Entity<Order>()
+            .ToContainer("Orders");
+        #endregion
+
+        #region NoDiscriminator
+        modelBuilder.Entity<Order>()
+            .HasNoDiscriminator();
+        #endregion
+
+        #region PartitionKey
+        modelBuilder.Entity<Order>()
+            .HasPartitionKey(o => o.PartitionKey);
+        #endregion
+
+        #region ETag
+        modelBuilder.Entity<Order>()
+            .UseETagConcurrency();
+        #endregion
+
+        #region PropertyNames
+        modelBuilder.Entity<Order>().OwnsOne(
+            o => o.ShippingAddress,
+            sa =>
+            {
+                sa.ToJsonProperty("Address");
+                sa.Property(p => p.Street).ToJsonProperty("ShipsToStreet");
+                sa.Property(p => p.City).ToJsonProperty("ShipsToCity");
+            });
+        #endregion
+
+        #region OwnsMany
+        modelBuilder.Entity<Distributor>().OwnsMany(p => p.ShippingCenters);
+        #endregion
+
+        #region ETagProperty
+        modelBuilder.Entity<Distributor>()
+            .Property(d => d.ETag)
+            .IsETagConcurrency();
+        #endregion
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Cosmos/ModelBuilding/Sample.cs b/samples/core/Cosmos/ModelBuilding/Sample.cs
new file mode 100644
index 0000000000..82f16ad9aa
--- /dev/null
+++ b/samples/core/Cosmos/ModelBuilding/Sample.cs
@@ -0,0 +1,116 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace Cosmos.ModelBuilding;
+
+public static class Sample
+{
+    public static async Task Run()
+    {
+        Console.WriteLine();
+        Console.WriteLine("Getting started with Cosmos:");
+        Console.WriteLine();
+
+        #region HelloCosmos
+        using (var context = new OrderContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            context.Add(
+                new Order
+                {
+                    Id = 1, ShippingAddress = new StreetAddress { City = "London", Street = "221 B Baker St" }, PartitionKey = "1"
+                });
+
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new OrderContext())
+        {
+            var order = await context.Orders.FirstAsync();
+            Console.WriteLine($"First order will ship to: {order.ShippingAddress.Street}, {order.ShippingAddress.City}");
+            Console.WriteLine();
+        }
+        #endregion
+
+        #region PartitionKey
+        using (var context = new OrderContext())
+        {
+            context.Add(
+                new Order
+                {
+                    Id = 2, ShippingAddress = new StreetAddress { City = "New York", Street = "11 Wall Street" }, PartitionKey = "2"
+                });
+
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new OrderContext())
+        {
+            var order = await context.Orders.WithPartitionKey("2").LastAsync();
+            Console.WriteLine($"Last order will ship to: {order.ShippingAddress.Street}, {order.ShippingAddress.City}");
+            Console.WriteLine();
+        }
+        #endregion
+
+        #region OwnedCollection
+        var distributor = new Distributor
+        {
+            Id = 1,
+            ShippingCenters = new HashSet<StreetAddress>
+            {
+                new StreetAddress { City = "Phoenix", Street = "500 S 48th Street" },
+                new StreetAddress { City = "Anaheim", Street = "5650 Dolly Ave" }
+            }
+        };
+
+        using (var context = new OrderContext())
+        {
+            context.Add(distributor);
+
+            await context.SaveChangesAsync();
+        }
+        #endregion
+
+        #region ImpliedProperties
+        using (var context = new OrderContext())
+        {
+            var firstDistributor = await context.Distributors.FirstAsync();
+            Console.WriteLine($"Number of shipping centers: {firstDistributor.ShippingCenters.Count}");
+
+            var addressEntry = context.Entry(firstDistributor.ShippingCenters.First());
+            var addressPKProperties = addressEntry.Metadata.FindPrimaryKey().Properties;
+
+            Console.WriteLine(
+                $"First shipping center PK: ({addressEntry.Property(addressPKProperties[0].Name).CurrentValue}, {addressEntry.Property(addressPKProperties[1].Name).CurrentValue})");
+            Console.WriteLine();
+        }
+        #endregion
+
+        #region Attach
+        using (var context = new OrderContext())
+        {
+            var distributorEntry = context.Add(distributor);
+            distributorEntry.State = EntityState.Unchanged;
+
+            distributor.ShippingCenters.Remove(distributor.ShippingCenters.Last());
+
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new OrderContext())
+        {
+            var firstDistributor = await context.Distributors.FirstAsync();
+            Console.WriteLine($"Number of shipping centers is now: {firstDistributor.ShippingCenters.Count}");
+
+            var distributorEntry = context.Entry(firstDistributor);
+            var idProperty = distributorEntry.Property<string>("__id");
+            Console.WriteLine($"The distributor 'id' is: {idProperty.CurrentValue}");
+        }
+        #endregion
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Cosmos/ModelBuilding/StreetAddress.cs b/samples/core/Cosmos/ModelBuilding/StreetAddress.cs
new file mode 100644
index 0000000000..31089e8139
--- /dev/null
+++ b/samples/core/Cosmos/ModelBuilding/StreetAddress.cs
@@ -0,0 +1,9 @@
+namespace Cosmos.ModelBuilding;
+
+#region StreetAddress
+public class StreetAddress
+{
+    public string Street { get; set; }
+    public string City { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Cosmos/ModelBuilding/TriggerSample.cs b/samples/core/Cosmos/ModelBuilding/TriggerSample.cs
new file mode 100644
index 0000000000..68a75e5ae9
--- /dev/null
+++ b/samples/core/Cosmos/ModelBuilding/TriggerSample.cs
@@ -0,0 +1,73 @@
+using Microsoft.Azure.Cosmos.Scripts;
+using Microsoft.EntityFrameworkCore;
+using System.Threading.Tasks;
+
+namespace Cosmos.ModelBuilding;
+
+public static class TriggerSample
+{
+    public static async Task ConfigureTriggers()
+    {
+        var contextOptions = new DbContextOptionsBuilder<TriggerContext>()
+            .UseCosmos("https://localhost:8081", "account-key", "sample");
+        
+        using var context = new TriggerContext(contextOptions.Options);
+        
+        // Ensure database is created
+        await context.Database.EnsureCreatedAsync();
+        
+        // Create a new product - this will trigger the PreInsertTrigger
+        var product = new Product 
+        { 
+            Id = 1, 
+            Name = "Sample Product", 
+            Price = 19.99m, 
+            Category = "Electronics" 
+        };
+        
+        context.Products.Add(product);
+        await context.SaveChangesAsync();
+        
+        // Update the product - this will trigger the UpdateTrigger
+        product.Price = 24.99m;
+        await context.SaveChangesAsync();
+        
+        // Delete the product - this will trigger the PostDeleteTrigger
+        context.Products.Remove(product);
+        await context.SaveChangesAsync();
+    }
+}
+
+public class TriggerContext : DbContext
+{
+    public TriggerContext(DbContextOptions options) : base(options) { }
+    
+    public DbSet<Product> Products { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Product>(entity =>
+        {
+            entity.HasPartitionKey(p => p.Category);
+            
+            #region TriggerConfiguration
+            // Configure pre-trigger for create operations
+            entity.HasTrigger("PreInsertTrigger", TriggerType.Pre, TriggerOperation.Create);
+            
+            // Configure post-trigger for delete operations
+            entity.HasTrigger("PostDeleteTrigger", TriggerType.Post, TriggerOperation.Delete);
+            
+            // Configure trigger for replace operations
+            entity.HasTrigger("UpdateTrigger", TriggerType.Pre, TriggerOperation.Replace);
+            #endregion
+        });
+    }
+}
+
+public class Product
+{
+    public int Id { get; set; }
+    public string Name { get; set; } = null!;
+    public decimal Price { get; set; }
+    public string Category { get; set; } = null!;
+}
\ No newline at end of file
diff --git a/samples/core/Cosmos/Program.cs b/samples/core/Cosmos/Program.cs
new file mode 100644
index 0000000000..1fd2003bd2
--- /dev/null
+++ b/samples/core/Cosmos/Program.cs
@@ -0,0 +1,13 @@
+using System.Threading.Tasks;
+using Cosmos.ModelBuilding;
+
+namespace Cosmos;
+
+public class Program
+{
+    private static async Task Main()
+    {
+        await Sample.Run();
+        await UnstructuredData.Sample.Run();
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Cosmos/UnstructuredData/Sample.cs b/samples/core/Cosmos/UnstructuredData/Sample.cs
new file mode 100644
index 0000000000..0e60f1339b
--- /dev/null
+++ b/samples/core/Cosmos/UnstructuredData/Sample.cs
@@ -0,0 +1,87 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Cosmos.ModelBuilding;
+using Microsoft.Azure.Cosmos;
+using Microsoft.EntityFrameworkCore;
+using Newtonsoft.Json.Linq;
+
+namespace Cosmos.UnstructuredData;
+
+public static class Sample
+{
+    public static async Task Run()
+    {
+        Console.WriteLine();
+        Console.WriteLine("Unstructured data:");
+        Console.WriteLine();
+
+        #region Unmapped
+        using (var context = new OrderContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            var order = new Order
+            {
+                Id = 1, ShippingAddress = new StreetAddress { City = "London", Street = "221 B Baker St" }, PartitionKey = "1"
+            };
+
+            context.Add(order);
+
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new OrderContext())
+        {
+            var order = await context.Orders.FirstAsync();
+            var orderEntry = context.Entry(order);
+
+            var jsonProperty = orderEntry.Property<JObject>("__jObject");
+            jsonProperty.CurrentValue["BillingAddress"] = "Clarence House";
+
+            orderEntry.State = EntityState.Modified;
+
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new OrderContext())
+        {
+            var order = await context.Orders.FirstAsync();
+            var orderEntry = context.Entry(order);
+            var jsonProperty = orderEntry.Property<JObject>("__jObject");
+
+            Console.WriteLine($"First order will be billed to: {jsonProperty.CurrentValue["BillingAddress"]}");
+        }
+        #endregion
+
+        #region CosmosClient
+        using (var context = new OrderContext())
+        {
+            var cosmosClient = context.Database.GetCosmosClient();
+            var database = cosmosClient.GetDatabase("OrdersDB");
+            var container = database.GetContainer("Orders");
+
+            var resultSet = container.GetItemQueryIterator<JObject>(new QueryDefinition("select * from o"));
+            var order = (await resultSet.ReadNextAsync()).First();
+
+            Console.WriteLine($"First order JSON: {order}");
+
+            order.Remove("TrackingNumber");
+
+            await container.ReplaceItemAsync(order, order["id"].ToString());
+        }
+        #endregion
+
+        #region MissingProperties
+        using (var context = new OrderContext())
+        {
+            var orders = await context.Orders.ToListAsync();
+            var sortedOrders = await context.Orders.OrderBy(o => o.TrackingNumber).ToListAsync();
+
+            Console.WriteLine($"Number of orders: {orders.Count}");
+            Console.WriteLine($"Number of sorted orders: {sortedOrders.Count}");
+        }
+        #endregion
+    }
+}
\ No newline at end of file
diff --git a/samples/core/DbContextPooling/DbContextPooling.csproj b/samples/core/DbContextPooling/DbContextPooling.csproj
new file mode 100644
index 0000000000..9e6b2d693b
--- /dev/null
+++ b/samples/core/DbContextPooling/DbContextPooling.csproj
@@ -0,0 +1,10 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>Samples</RootNamespace>
+  </PropertyGroup>
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+  </ItemGroup>
+</Project>
diff --git a/samples/core/DbContextPooling/Program.cs b/samples/core/DbContextPooling/Program.cs
new file mode 100644
index 0000000000..2ddc477c2f
--- /dev/null
+++ b/samples/core/DbContextPooling/Program.cs
@@ -0,0 +1,139 @@
+using System;
+using System.Diagnostics;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.DependencyInjection;
+
+namespace Samples;
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Name { get; set; }
+    public string Url { get; set; }
+}
+
+public class BloggingContext : DbContext
+{
+    public static long InstanceCount;
+
+    public BloggingContext(DbContextOptions options)
+        : base(options)
+        => Interlocked.Increment(ref InstanceCount);
+
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+public class BlogController
+{
+    private readonly BloggingContext _context;
+
+    public BlogController(BloggingContext context) => _context = context;
+
+    public async Task ActionAsync() => await _context.Blogs.FirstAsync();
+}
+
+public class Startup
+{
+    private const string ConnectionString
+        = @"Server=(localdb)\mssqllocaldb;Database=Demo.ContextPooling;Trusted_Connection=True;ConnectRetryCount=0";
+
+    public void ConfigureServices(IServiceCollection services)
+    {
+        // Switch the lines below to compare pooling with the traditional instance-per-request approach.
+        //services.AddDbContext<BloggingContext>(c => c.UseSqlServer(ConnectionString));
+        services.AddDbContextPool<BloggingContext>(c => c.UseSqlServer(ConnectionString));
+    }
+}
+
+public class Program
+{
+    private const int Threads = 32;
+    private const int Seconds = 10;
+
+    private static long _requestsProcessed;
+
+    private static async Task Main()
+    {
+        var serviceCollection = new ServiceCollection();
+        new Startup().ConfigureServices(serviceCollection);
+        var serviceProvider = serviceCollection.BuildServiceProvider();
+
+        await SetupDatabase(serviceProvider);
+
+        var stopwatch = new Stopwatch();
+
+        var monitorTask = MonitorResults(TimeSpan.FromSeconds(Seconds), stopwatch);
+
+        await Task.WhenAll(
+            Enumerable
+                .Range(0, Threads)
+                .Select(_ => SimulateRequestsAsync(serviceProvider, stopwatch)));
+
+        await monitorTask;
+    }
+
+    private static async Task SetupDatabase(IServiceProvider serviceProvider)
+    {
+        using var serviceScope = serviceProvider.CreateScope();
+        var context = serviceScope.ServiceProvider.GetService<BloggingContext>();
+
+        if (await context.Database.EnsureCreatedAsync())
+        {
+            context.Blogs.Add(new Blog { Name = "The Dog Blog", Url = "http://sample.com/dogs" });
+            context.Blogs.Add(new Blog { Name = "The Cat Blog", Url = "http://sample.com/cats" });
+            await context.SaveChangesAsync();
+        }
+    }
+
+    private static async Task SimulateRequestsAsync(IServiceProvider serviceProvider, Stopwatch stopwatch)
+    {
+        while (stopwatch.IsRunning)
+        {
+            using (var serviceScope = serviceProvider.CreateScope())
+            {
+                await new BlogController(serviceScope.ServiceProvider.GetService<BloggingContext>()).ActionAsync();
+            }
+
+            Interlocked.Increment(ref _requestsProcessed);
+        }
+    }
+
+    private static async Task MonitorResults(TimeSpan duration, Stopwatch stopwatch)
+    {
+        var lastInstanceCount = 0L;
+        var lastRequestCount = 0L;
+        var lastElapsed = TimeSpan.Zero;
+
+        stopwatch.Start();
+
+        while (stopwatch.Elapsed < duration)
+        {
+            await Task.Delay(TimeSpan.FromSeconds(1));
+
+            var instanceCount = BloggingContext.InstanceCount;
+            var requestCount = _requestsProcessed;
+            var elapsed = stopwatch.Elapsed;
+            var currentElapsed = elapsed - lastElapsed;
+            var currentRequests = requestCount - lastRequestCount;
+
+            Console.WriteLine(
+                $"[{DateTime.Now:HH:mm:ss.fff}] "
+                + $"Context creations/second: {instanceCount - lastInstanceCount} | "
+                + $"Requests/second: {Math.Round(currentRequests / currentElapsed.TotalSeconds)}");
+
+            lastInstanceCount = instanceCount;
+            lastRequestCount = requestCount;
+            lastElapsed = elapsed;
+        }
+
+        Console.WriteLine();
+        Console.WriteLine($"Total context creations: {BloggingContext.InstanceCount}");
+        Console.WriteLine(
+            $"Requests per second:     {Math.Round(_requestsProcessed / stopwatch.Elapsed.TotalSeconds)}");
+
+        stopwatch.Stop();
+    }
+}
diff --git a/samples/core/DbContextPooling/README.md b/samples/core/DbContextPooling/README.md
new file mode 100644
index 0000000000..8d99f557e3
--- /dev/null
+++ b/samples/core/DbContextPooling/README.md
@@ -0,0 +1,3 @@
+# DbContext Pooling
+
+This sample demonstrates DbContext Pooling. The program runs a benchmark test that measures throughput (requests/second) of a simple web-like query scenario.
diff --git a/samples/core/GetStarted/EFGetStarted.csproj b/samples/core/GetStarted/EFGetStarted.csproj
new file mode 100644
index 0000000000..9b8254d35a
--- /dev/null
+++ b/samples/core/GetStarted/EFGetStarted.csproj
@@ -0,0 +1,17 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <StartWorkingDirectory>$(MSBuildProjectDirectory)</StartWorkingDirectory>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="10.0.0">
+      <PrivateAssets>all</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+    </PackageReference>
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/GetStarted/Migrations/20190917222642_InitialCreate.Designer.cs b/samples/core/GetStarted/Migrations/20190917222642_InitialCreate.Designer.cs
new file mode 100644
index 0000000000..1f9c356cc0
--- /dev/null
+++ b/samples/core/GetStarted/Migrations/20190917222642_InitialCreate.Designer.cs
@@ -0,0 +1,67 @@
+// <auto-generated />
+using EFGetStarted;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+namespace EFGetStarted.Migrations
+{
+    [DbContext(typeof(BloggingContext))]
+    [Migration("20190917222642_InitialCreate")]
+    partial class InitialCreate
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "3.0.0-rc1.19456.14");
+
+            modelBuilder.Entity("EFGetStarted.Blog", b =>
+                {
+                    b.Property<int>("BlogId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("INTEGER");
+
+                    b.Property<string>("Url")
+                        .HasColumnType("TEXT");
+
+                    b.HasKey("BlogId");
+
+                    b.ToTable("Blogs");
+                });
+
+            modelBuilder.Entity("EFGetStarted.Post", b =>
+                {
+                    b.Property<int>("PostId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("INTEGER");
+
+                    b.Property<int>("BlogId")
+                        .HasColumnType("INTEGER");
+
+                    b.Property<string>("Content")
+                        .HasColumnType("TEXT");
+
+                    b.Property<string>("Title")
+                        .HasColumnType("TEXT");
+
+                    b.HasKey("PostId");
+
+                    b.HasIndex("BlogId");
+
+                    b.ToTable("Posts");
+                });
+
+            modelBuilder.Entity("EFGetStarted.Post", b =>
+                {
+                    b.HasOne("EFGetStarted.Blog", "Blog")
+                        .WithMany("Posts")
+                        .HasForeignKey("BlogId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/samples/core/GetStarted/Migrations/20190917222642_InitialCreate.cs b/samples/core/GetStarted/Migrations/20190917222642_InitialCreate.cs
new file mode 100644
index 0000000000..fd6529ed9f
--- /dev/null
+++ b/samples/core/GetStarted/Migrations/20190917222642_InitialCreate.cs
@@ -0,0 +1,55 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace EFGetStarted.Migrations
+{
+    public partial class InitialCreate : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.CreateTable(
+                name: "Blogs",
+                columns: table => new
+                {
+                    BlogId = table.Column<int>(nullable: false)
+                        .Annotation("Sqlite:Autoincrement", true),
+                    Url = table.Column<string>(nullable: true)
+                },
+                constraints: table => { table.PrimaryKey("PK_Blogs", x => x.BlogId); });
+
+            migrationBuilder.CreateTable(
+                name: "Posts",
+                columns: table => new
+                {
+                    PostId = table.Column<int>(nullable: false)
+                        .Annotation("Sqlite:Autoincrement", true),
+                    Title = table.Column<string>(nullable: true),
+                    Content = table.Column<string>(nullable: true),
+                    BlogId = table.Column<int>(nullable: false)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_Posts", x => x.PostId);
+                    table.ForeignKey(
+                        name: "FK_Posts_Blogs_BlogId",
+                        column: x => x.BlogId,
+                        principalTable: "Blogs",
+                        principalColumn: "BlogId",
+                        onDelete: ReferentialAction.Cascade);
+                });
+
+            migrationBuilder.CreateIndex(
+                name: "IX_Posts_BlogId",
+                table: "Posts",
+                column: "BlogId");
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropTable(
+                name: "Posts");
+
+            migrationBuilder.DropTable(
+                name: "Blogs");
+        }
+    }
+}
diff --git a/samples/core/GetStarted/Migrations/BloggingContextModelSnapshot.cs b/samples/core/GetStarted/Migrations/BloggingContextModelSnapshot.cs
new file mode 100644
index 0000000000..2f4b81b30f
--- /dev/null
+++ b/samples/core/GetStarted/Migrations/BloggingContextModelSnapshot.cs
@@ -0,0 +1,64 @@
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+
+namespace EFGetStarted.Migrations;
+
+[DbContext(typeof(BloggingContext))]
+internal class BloggingContextModelSnapshot : ModelSnapshot
+{
+    protected override void BuildModel(ModelBuilder modelBuilder)
+    {
+#pragma warning disable 612, 618
+        modelBuilder
+            .HasAnnotation("ProductVersion", "3.0.0-rc1.19456.14");
+
+        modelBuilder.Entity(
+            "EFGetStarted.Blog", b =>
+            {
+                b.Property<int>("BlogId")
+                    .ValueGeneratedOnAdd()
+                    .HasColumnType("INTEGER");
+
+                b.Property<string>("Url")
+                    .HasColumnType("TEXT");
+
+                b.HasKey("BlogId");
+
+                b.ToTable("Blogs");
+            });
+
+        modelBuilder.Entity(
+            "EFGetStarted.Post", b =>
+            {
+                b.Property<int>("PostId")
+                    .ValueGeneratedOnAdd()
+                    .HasColumnType("INTEGER");
+
+                b.Property<int>("BlogId")
+                    .HasColumnType("INTEGER");
+
+                b.Property<string>("Content")
+                    .HasColumnType("TEXT");
+
+                b.Property<string>("Title")
+                    .HasColumnType("TEXT");
+
+                b.HasKey("PostId");
+
+                b.HasIndex("BlogId");
+
+                b.ToTable("Posts");
+            });
+
+        modelBuilder.Entity(
+            "EFGetStarted.Post", b =>
+            {
+                b.HasOne("EFGetStarted.Blog", "Blog")
+                    .WithMany("Posts")
+                    .HasForeignKey("BlogId")
+                    .OnDelete(DeleteBehavior.Cascade)
+                    .IsRequired();
+            });
+#pragma warning restore 612, 618
+    }
+}
\ No newline at end of file
diff --git a/samples/core/GetStarted/Model.cs b/samples/core/GetStarted/Model.cs
new file mode 100644
index 0000000000..9865e3e735
--- /dev/null
+++ b/samples/core/GetStarted/Model.cs
@@ -0,0 +1,41 @@
+using Microsoft.EntityFrameworkCore;
+using System;
+using System.Collections.Generic;
+
+public class BloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    public string DbPath { get; }
+
+    public BloggingContext()
+    {
+        var folder = Environment.SpecialFolder.LocalApplicationData;
+        var path = Environment.GetFolderPath(folder);
+        DbPath = System.IO.Path.Join(path, "blogging.db");
+    }
+
+    // The following configures EF to create a Sqlite database file in the
+    // special "local" folder for your platform.
+    protected override void OnConfiguring(DbContextOptionsBuilder options)
+        => options.UseSqlite($"Data Source={DbPath}");
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public List<Post> Posts { get; } = new();
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/GetStarted/Program.cs b/samples/core/GetStarted/Program.cs
new file mode 100644
index 0000000000..3ca7fcab95
--- /dev/null
+++ b/samples/core/GetStarted/Program.cs
@@ -0,0 +1,31 @@
+using System;
+using System.Linq;
+using Microsoft.EntityFrameworkCore;
+
+using var db = new BloggingContext();
+
+// Note: This sample requires the database to be created before running.
+Console.WriteLine($"Database path: {db.DbPath}.");
+
+// Create
+Console.WriteLine("Inserting a new blog");
+db.Add(new Blog { Url = "http://blogs.msdn.com/adonet" });
+await db.SaveChangesAsync();
+
+// Read
+Console.WriteLine("Querying for a blog");
+var blog = await db.Blogs
+    .OrderBy(b => b.BlogId)
+    .FirstAsync();
+
+// Update
+Console.WriteLine("Updating the blog and adding a post");
+blog.Url = "https://devblogs.microsoft.com/dotnet";
+blog.Posts.Add(
+    new Post { Title = "Hello World", Content = "I wrote an app using EF Core!" });
+await db.SaveChangesAsync();
+
+// Delete
+Console.WriteLine("Delete the blog");
+db.Remove(blog);
+await db.SaveChangesAsync();
diff --git a/samples/core/Intro/Intro.csproj b/samples/core/Intro/Intro.csproj
new file mode 100644
index 0000000000..22956419ed
--- /dev/null
+++ b/samples/core/Intro/Intro.csproj
@@ -0,0 +1,17 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <StartWorkingDirectory>$(MSBuildProjectDirectory)</StartWorkingDirectory>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="10.0.0">
+      <PrivateAssets>all</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+    </PackageReference>
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Intro/Migrations/20191019191556_InitialCreate.Designer.cs b/samples/core/Intro/Migrations/20191019191556_InitialCreate.Designer.cs
new file mode 100644
index 0000000000..44bb7a4bd6
--- /dev/null
+++ b/samples/core/Intro/Migrations/20191019191556_InitialCreate.Designer.cs
@@ -0,0 +1,75 @@
+// <auto-generated />
+using Intro;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+namespace Intro.Migrations
+{
+    [DbContext(typeof(BloggingContext))]
+    [Migration("20191019191556_InitialCreate")]
+    partial class InitialCreate
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "3.0.0")
+                .HasAnnotation("Relational:MaxIdentifierLength", 128)
+                .HasAnnotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn);
+
+            modelBuilder.Entity("Intro.Blog", b =>
+                {
+                    b.Property<int>("BlogId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("int")
+                        .HasAnnotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn);
+
+                    b.Property<int>("Rating")
+                        .HasColumnType("int");
+
+                    b.Property<string>("Url")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.HasKey("BlogId");
+
+                    b.ToTable("Blogs");
+                });
+
+            modelBuilder.Entity("Intro.Post", b =>
+                {
+                    b.Property<int>("PostId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("int")
+                        .HasAnnotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn);
+
+                    b.Property<int>("BlogId")
+                        .HasColumnType("int");
+
+                    b.Property<string>("Content")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("Title")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.HasKey("PostId");
+
+                    b.HasIndex("BlogId");
+
+                    b.ToTable("Posts");
+                });
+
+            modelBuilder.Entity("Intro.Post", b =>
+                {
+                    b.HasOne("Intro.Blog", "Blog")
+                        .WithMany("Posts")
+                        .HasForeignKey("BlogId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/samples/core/Intro/Migrations/20191019191556_InitialCreate.cs b/samples/core/Intro/Migrations/20191019191556_InitialCreate.cs
new file mode 100644
index 0000000000..864f5581ca
--- /dev/null
+++ b/samples/core/Intro/Migrations/20191019191556_InitialCreate.cs
@@ -0,0 +1,56 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace Intro.Migrations
+{
+    public partial class InitialCreate : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.CreateTable(
+                name: "Blogs",
+                columns: table => new
+                {
+                    BlogId = table.Column<int>(nullable: false)
+                        .Annotation("SqlServer:Identity", "1, 1"),
+                    Url = table.Column<string>(nullable: true),
+                    Rating = table.Column<int>(nullable: false)
+                },
+                constraints: table => { table.PrimaryKey("PK_Blogs", x => x.BlogId); });
+
+            migrationBuilder.CreateTable(
+                name: "Posts",
+                columns: table => new
+                {
+                    PostId = table.Column<int>(nullable: false)
+                        .Annotation("SqlServer:Identity", "1, 1"),
+                    Title = table.Column<string>(nullable: true),
+                    Content = table.Column<string>(nullable: true),
+                    BlogId = table.Column<int>(nullable: false)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_Posts", x => x.PostId);
+                    table.ForeignKey(
+                        name: "FK_Posts_Blogs_BlogId",
+                        column: x => x.BlogId,
+                        principalTable: "Blogs",
+                        principalColumn: "BlogId",
+                        onDelete: ReferentialAction.Cascade);
+                });
+
+            migrationBuilder.CreateIndex(
+                name: "IX_Posts_BlogId",
+                table: "Posts",
+                column: "BlogId");
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropTable(
+                name: "Posts");
+
+            migrationBuilder.DropTable(
+                name: "Blogs");
+        }
+    }
+}
diff --git a/samples/core/Intro/Migrations/BloggingContextModelSnapshot.cs b/samples/core/Intro/Migrations/BloggingContextModelSnapshot.cs
new file mode 100644
index 0000000000..73a81ddc71
--- /dev/null
+++ b/samples/core/Intro/Migrations/BloggingContextModelSnapshot.cs
@@ -0,0 +1,72 @@
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+
+namespace Intro.Migrations;
+
+[DbContext(typeof(BloggingContext))]
+internal class BloggingContextModelSnapshot : ModelSnapshot
+{
+    protected override void BuildModel(ModelBuilder modelBuilder)
+    {
+#pragma warning disable 612, 618
+        modelBuilder
+            .HasAnnotation("ProductVersion", "3.0.0")
+            .HasAnnotation("Relational:MaxIdentifierLength", 128)
+            .HasAnnotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn);
+
+        modelBuilder.Entity(
+            "Intro.Blog", b =>
+            {
+                b.Property<int>("BlogId")
+                    .ValueGeneratedOnAdd()
+                    .HasColumnType("int")
+                    .HasAnnotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn);
+
+                b.Property<int>("Rating")
+                    .HasColumnType("int");
+
+                b.Property<string>("Url")
+                    .HasColumnType("nvarchar(max)");
+
+                b.HasKey("BlogId");
+
+                b.ToTable("Blogs");
+            });
+
+        modelBuilder.Entity(
+            "Intro.Post", b =>
+            {
+                b.Property<int>("PostId")
+                    .ValueGeneratedOnAdd()
+                    .HasColumnType("int")
+                    .HasAnnotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn);
+
+                b.Property<int>("BlogId")
+                    .HasColumnType("int");
+
+                b.Property<string>("Content")
+                    .HasColumnType("nvarchar(max)");
+
+                b.Property<string>("Title")
+                    .HasColumnType("nvarchar(max)");
+
+                b.HasKey("PostId");
+
+                b.HasIndex("BlogId");
+
+                b.ToTable("Posts");
+            });
+
+        modelBuilder.Entity(
+            "Intro.Post", b =>
+            {
+                b.HasOne("Intro.Blog", "Blog")
+                    .WithMany("Posts")
+                    .HasForeignKey("BlogId")
+                    .OnDelete(DeleteBehavior.Cascade)
+                    .IsRequired();
+            });
+#pragma warning restore 612, 618
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Intro/Model.cs b/samples/core/Intro/Model.cs
new file mode 100644
index 0000000000..00b0c9250a
--- /dev/null
+++ b/samples/core/Intro/Model.cs
@@ -0,0 +1,34 @@
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace Intro;
+
+public class BloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder.UseSqlServer(
+            @"Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;ConnectRetryCount=0");
+    }
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public int Rating { get; set; }
+    public List<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
diff --git a/samples/core/Intro/Program.cs b/samples/core/Intro/Program.cs
new file mode 100644
index 0000000000..e4d95c825c
--- /dev/null
+++ b/samples/core/Intro/Program.cs
@@ -0,0 +1,37 @@
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace Intro;
+
+internal class Program
+{
+    private static async Task Main()
+    {
+        using (var db = new BloggingContext())
+        {
+            // Remove these lines if you are running migrations from the command line
+            await db.Database.EnsureDeletedAsync();
+            await db.Database.MigrateAsync();
+        }
+
+        #region Querying
+        using (var db = new BloggingContext())
+        {
+            var blogs = await db.Blogs
+                .Where(b => b.Rating > 3)
+                .OrderBy(b => b.Url)
+                .ToListAsync();
+        }
+        #endregion
+
+        #region SavingData
+        using (var db = new BloggingContext())
+        {
+            var blog = new Blog { Url = "http://sample.com" };
+            db.Blogs.Add(blog);
+            await db.SaveChangesAsync();
+        }
+        #endregion
+    }
+}
diff --git a/samples/core/Miscellaneous/.DS_Store b/samples/core/Miscellaneous/.DS_Store
new file mode 100644
index 0000000000..e7b56c671c
Binary files /dev/null and b/samples/core/Miscellaneous/.DS_Store differ
diff --git a/samples/core/Miscellaneous/Async/Async.csproj b/samples/core/Miscellaneous/Async/Async.csproj
new file mode 100644
index 0000000000..c4475eebeb
--- /dev/null
+++ b/samples/core/Miscellaneous/Async/Async.csproj
@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFAsync</RootNamespace>
+    <AssemblyName>EFAsync</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+    <PackageReference Include="Microsoft.Extensions.Logging.Console" Version="7.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/Async/Program.cs b/samples/core/Miscellaneous/Async/Program.cs
new file mode 100644
index 0000000000..5b6c5a847c
--- /dev/null
+++ b/samples/core/Miscellaneous/Async/Program.cs
@@ -0,0 +1,42 @@
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFAsync;
+
+public class Program
+{
+    public static async Task Main(string[] args)
+    {
+        await using var context = new BloggingContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+
+        #region SaveChangesAsync
+        var blog = new Blog { Url = "http://sample.com" };
+        context.Blogs.Add(blog);
+        await context.SaveChangesAsync();
+        #endregion
+
+        #region ToListAsync
+        var blogs = await context.Blogs.Where(b => b.Rating > 3).ToListAsync();
+        #endregion
+    }
+}
+
+public class BloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder.UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFAsync;Trusted_Connection=True;ConnectRetryCount=0");
+    }
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public int Rating { get; set; }
+}
diff --git a/samples/core/Miscellaneous/CachingInterception/CachedDailyMessageDataReader.cs b/samples/core/Miscellaneous/CachingInterception/CachedDailyMessageDataReader.cs
new file mode 100644
index 0000000000..6e3b04fa3e
--- /dev/null
+++ b/samples/core/Miscellaneous/CachingInterception/CachedDailyMessageDataReader.cs
@@ -0,0 +1,109 @@
+using System;
+using System.Collections;
+using System.Data.Common;
+
+public class CachedDailyMessageDataReader : DbDataReader
+{
+    private readonly int _id;
+    private readonly string _message;
+    private bool _read;
+
+    public CachedDailyMessageDataReader(int id, string message)
+    {
+        _id = id;
+        _message = message;
+    }
+
+    public override int FieldCount
+        => throw new NotImplementedException();
+
+    public override int RecordsAffected
+        => 0;
+
+    public override bool HasRows
+        => throw new NotImplementedException();
+
+    public override bool IsClosed
+        => throw new NotImplementedException();
+
+    public override int Depth
+        => throw new NotImplementedException();
+
+    public override bool Read()
+        => _read = !_read;
+
+    public override int GetInt32(int ordinal)
+        => _id;
+
+    public override bool IsDBNull(int ordinal)
+        => false;
+
+    public override string GetString(int ordinal)
+        => _message;
+
+    public override bool GetBoolean(int ordinal)
+        => throw new NotImplementedException();
+
+    public override byte GetByte(int ordinal)
+        => throw new NotImplementedException();
+
+    public override long GetBytes(int ordinal, long dataOffset, byte[] buffer, int bufferOffset, int length)
+        => throw new NotImplementedException();
+
+    public override char GetChar(int ordinal)
+        => throw new NotImplementedException();
+
+    public override long GetChars(int ordinal, long dataOffset, char[] buffer, int bufferOffset, int length)
+        => throw new NotImplementedException();
+
+    public override string GetDataTypeName(int ordinal)
+        => throw new NotImplementedException();
+
+    public override DateTime GetDateTime(int ordinal)
+        => throw new NotImplementedException();
+
+    public override decimal GetDecimal(int ordinal)
+        => throw new NotImplementedException();
+
+    public override double GetDouble(int ordinal)
+        => throw new NotImplementedException();
+
+    public override Type GetFieldType(int ordinal)
+        => throw new NotImplementedException();
+
+    public override float GetFloat(int ordinal)
+        => throw new NotImplementedException();
+
+    public override Guid GetGuid(int ordinal)
+        => throw new NotImplementedException();
+
+    public override short GetInt16(int ordinal)
+        => throw new NotImplementedException();
+
+    public override long GetInt64(int ordinal)
+        => throw new NotImplementedException();
+
+    public override string GetName(int ordinal)
+        => throw new NotImplementedException();
+
+    public override int GetOrdinal(string name)
+        => throw new NotImplementedException();
+
+    public override object GetValue(int ordinal)
+        => throw new NotImplementedException();
+
+    public override int GetValues(object[] values)
+        => throw new NotImplementedException();
+
+    public override object this[int ordinal]
+        => throw new NotImplementedException();
+
+    public override object this[string name]
+        => throw new NotImplementedException();
+
+    public override bool NextResult()
+        => throw new NotImplementedException();
+
+    public override IEnumerator GetEnumerator()
+        => throw new NotImplementedException();
+}
diff --git a/samples/core/Miscellaneous/CachingInterception/CachingCommandInterceptor.cs b/samples/core/Miscellaneous/CachingInterception/CachingCommandInterceptor.cs
new file mode 100644
index 0000000000..464c43b290
--- /dev/null
+++ b/samples/core/Miscellaneous/CachingInterception/CachingCommandInterceptor.cs
@@ -0,0 +1,75 @@
+using System;
+using System.Data.Common;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public class CachingCommandInterceptor : DbCommandInterceptor
+{
+    #region InterceptorState
+    private readonly object _lock = new object();
+    private int _id;
+    private string _message;
+    private DateTime _queriedAt;
+    #endregion
+
+    public override InterceptionResult<DbDataReader> ReaderExecuting(
+        DbCommand command, CommandEventData eventData, InterceptionResult<DbDataReader> result)
+        => throw new InvalidOperationException("Sync interception not implemented; use async queries.");
+
+    #region ReaderExecutingAsync
+    public override ValueTask<InterceptionResult<DbDataReader>> ReaderExecutingAsync(
+        DbCommand command,
+        CommandEventData eventData,
+        InterceptionResult<DbDataReader> result,
+        CancellationToken cancellationToken = default)
+    {
+        if (command.CommandText.StartsWith("-- Get_Daily_Message", StringComparison.Ordinal))
+        {
+            lock (_lock)
+            {
+                if (_message != null
+                    && DateTime.UtcNow < _queriedAt + new TimeSpan(0, 0, 10))
+                {
+                    command.CommandText = "-- Get_Daily_Message: Skipping DB call; using cache.";
+                    result = InterceptionResult<DbDataReader>.SuppressWithResult(new CachedDailyMessageDataReader(_id, _message));
+                }
+            }
+        }
+
+        return new ValueTask<InterceptionResult<DbDataReader>>(result);
+    }
+    #endregion
+
+    #region ReaderExecutedAsync
+    public override async ValueTask<DbDataReader> ReaderExecutedAsync(
+        DbCommand command,
+        CommandExecutedEventData eventData,
+        DbDataReader result,
+        CancellationToken cancellationToken = default)
+    {
+        if (command.CommandText.StartsWith("-- Get_Daily_Message", StringComparison.Ordinal)
+            && !(result is CachedDailyMessageDataReader))
+        {
+            try
+            {
+                await result.ReadAsync(cancellationToken);
+
+                lock (_lock)
+                {
+                    _id = result.GetInt32(0);
+                    _message = result.GetString(1);
+                    _queriedAt = DateTime.UtcNow;
+                    return new CachedDailyMessageDataReader(_id, _message);
+                }
+            }
+            finally
+            {
+                await result.DisposeAsync();
+            }
+        }
+
+        return result;
+    }
+    #endregion
+}
diff --git a/samples/core/Miscellaneous/CachingInterception/CachingInterception.csproj b/samples/core/Miscellaneous/CachingInterception/CachingInterception.csproj
new file mode 100644
index 0000000000..21d10ca0ac
--- /dev/null
+++ b/samples/core/Miscellaneous/CachingInterception/CachingInterception.csproj
@@ -0,0 +1,13 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <TargetFramework>net10.0</TargetFramework>
+        <RootNamespace />
+    </PropertyGroup>
+
+    <ItemGroup>
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+    </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/CachingInterception/DailyMessageContext.cs b/samples/core/Miscellaneous/CachingInterception/DailyMessageContext.cs
new file mode 100644
index 0000000000..3539eabf5b
--- /dev/null
+++ b/samples/core/Miscellaneous/CachingInterception/DailyMessageContext.cs
@@ -0,0 +1,24 @@
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Logging;
+
+public class DailyMessageContext : DbContext
+{
+    private static readonly CachingCommandInterceptor _cachingInterceptor
+        = new CachingCommandInterceptor();
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .EnableSensitiveDataLogging()
+            .AddInterceptors(_cachingInterceptor)
+            .LogTo(Console.WriteLine, LogLevel.Information)
+            .UseSqlite("DataSource=dailymessage.db");
+
+    public DbSet<DailyMessage> DailyMessages { get; set; }
+}
+
+public class DailyMessage
+{
+    public int Id { get; set; }
+    public string Message { get; set; }
+}
diff --git a/samples/core/Miscellaneous/CachingInterception/Program.cs b/samples/core/Miscellaneous/CachingInterception/Program.cs
new file mode 100644
index 0000000000..1bfe38da63
--- /dev/null
+++ b/samples/core/Miscellaneous/CachingInterception/Program.cs
@@ -0,0 +1,60 @@
+using System;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+public class Program
+{
+    private static async Task Main()
+    {
+        #region Main
+        // 1. Initialize the database with some daily messages.
+        using (var context = new DailyMessageContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            context.AddRange(
+                new DailyMessage { Message = "Remember: All builds are GA; no builds are RTM." },
+                new DailyMessage { Message = "Keep calm and drink tea" });
+
+            await context.SaveChangesAsync();
+        }
+
+        // 2. Query for the most recent daily message. It will be cached for 10 seconds.
+        using (var context = new DailyMessageContext())
+        {
+            Console.WriteLine(await GetDailyMessage(context));
+        }
+
+        // 3. Insert a new daily message.
+        using (var context = new DailyMessageContext())
+        {
+            context.Add(new DailyMessage { Message = "Free beer for unicorns" });
+
+            await context.SaveChangesAsync();
+        }
+
+        // 4. Cached message is used until cache expires.
+        using (var context = new DailyMessageContext())
+        {
+            Console.WriteLine(await GetDailyMessage(context));
+        }
+
+        // 5. Pretend it's the next day.
+        Thread.Sleep(10000);
+
+        // 6. Cache is expired, so the last message will not be queried again.
+        using (var context = new DailyMessageContext())
+        {
+            Console.WriteLine(await GetDailyMessage(context));
+        }
+
+        #region GetDailyMessage
+        async Task<string> GetDailyMessage(DailyMessageContext context)
+            => (await context.DailyMessages.TagWith("Get_Daily_Message").OrderBy(e => e.Id).LastAsync()).Message;
+        #endregion
+        #endregion
+    }
+}
diff --git a/samples/core/Miscellaneous/Collations/Collations.csproj b/samples/core/Miscellaneous/Collations/Collations.csproj
new file mode 100644
index 0000000000..598f97e05b
--- /dev/null
+++ b/samples/core/Miscellaneous/Collations/Collations.csproj
@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFCollations</RootNamespace>
+    <AssemblyName>EFCollations</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+    <PackageReference Include="Microsoft.Extensions.Logging.Console" Version="7.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/Collations/Program.cs b/samples/core/Miscellaneous/Collations/Program.cs
new file mode 100644
index 0000000000..098f18d1d8
--- /dev/null
+++ b/samples/core/Miscellaneous/Collations/Program.cs
@@ -0,0 +1,54 @@
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFCollations;
+
+public class Program
+{
+    public static async Task Main(string[] args)
+    {
+        using (var db = new CustomerContext())
+        {
+            await db.Database.EnsureDeletedAsync();
+            await db.Database.EnsureCreatedAsync();
+        }
+
+        using (var context = new CustomerContext())
+        {
+            #region SimpleQueryCollation
+            var customers = await context.Customers
+                .Where(c => EF.Functions.Collate(c.Name, "SQL_Latin1_General_CP1_CS_AS") == "John")
+                .ToListAsync();
+            #endregion
+        }
+    }
+}
+
+public class CustomerContext : DbContext
+{
+    public DbSet<Customer> Customers { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder.UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCollations;Trusted_Connection=True;ConnectRetryCount=0");
+    }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        #region DatabaseCollation
+        modelBuilder.UseCollation("SQL_Latin1_General_CP1_CS_AS");
+        #endregion
+
+        #region ColumnCollation
+        modelBuilder.Entity<Customer>().Property(c => c.Name)
+            .UseCollation("SQL_Latin1_General_CP1_CI_AS");
+        #endregion
+    }
+}
+
+public class Customer
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+}
diff --git a/samples/core/Miscellaneous/CommandInterception/BlogsContext.cs b/samples/core/Miscellaneous/CommandInterception/BlogsContext.cs
new file mode 100644
index 0000000000..f97263fac4
--- /dev/null
+++ b/samples/core/Miscellaneous/CommandInterception/BlogsContext.cs
@@ -0,0 +1,25 @@
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Logging;
+
+public abstract class BlogsContext : DbContext
+{
+    private const string ConnectionString = @"Server=(localdb)\mssqllocaldb;Database=InterceptionTest;Trusted_Connection=True";
+
+    protected BlogsContext()
+        : base(
+            new DbContextOptionsBuilder()
+                .LogTo(Console.WriteLine, LogLevel.Information)
+                .UseSqlServer(ConnectionString)
+                .Options)
+    {
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+public class Blog
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+}
diff --git a/samples/core/Miscellaneous/CommandInterception/CommandInterception.csproj b/samples/core/Miscellaneous/CommandInterception/CommandInterception.csproj
new file mode 100644
index 0000000000..18d0804f27
--- /dev/null
+++ b/samples/core/Miscellaneous/CommandInterception/CommandInterception.csproj
@@ -0,0 +1,13 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <TargetFramework>net10.0</TargetFramework>
+        <RootNamespace />
+    </PropertyGroup>
+
+    <ItemGroup>
+        <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+    </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/CommandInterception/Program.cs b/samples/core/Miscellaneous/CommandInterception/Program.cs
new file mode 100644
index 0000000000..0adff74e27
--- /dev/null
+++ b/samples/core/Miscellaneous/CommandInterception/Program.cs
@@ -0,0 +1,48 @@
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+public class Program
+{
+    public static async Task Main()
+    {
+        using (var context = new TaggedQueryCommandInterceptorContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            context.AddRange(
+                new Blog { Name = "Blog1" },
+                new Blog { Name = "Blog2" });
+
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new TaggedQueryCommandInterceptorContext())
+        {
+            #region TaggedQuery
+            var blogs1 = await context.Blogs.TagWith("Use hint: robust plan").ToListAsync();
+            #endregion
+            var blogs2 = await context.Blogs.ToListAsync();
+        }
+    }
+}
+
+#region RegisterStatelessInterceptor
+public class TaggedQueryCommandInterceptorContext : BlogsContext
+{
+    private static readonly TaggedQueryCommandInterceptor _interceptor
+        = new TaggedQueryCommandInterceptor();
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.AddInterceptors(_interceptor);
+}
+#endregion
+
+#region RegisterInterceptor
+public class ExampleContext : BlogsContext
+{
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.AddInterceptors(new TaggedQueryCommandInterceptor());
+}
+#endregion
diff --git a/samples/core/Miscellaneous/CommandInterception/TaggedQueryCommandInterceptor.cs b/samples/core/Miscellaneous/CommandInterception/TaggedQueryCommandInterceptor.cs
new file mode 100644
index 0000000000..10d2e9cd5c
--- /dev/null
+++ b/samples/core/Miscellaneous/CommandInterception/TaggedQueryCommandInterceptor.cs
@@ -0,0 +1,39 @@
+using System;
+using System.Data.Common;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+#region TaggedQueryCommandInterceptor
+public class TaggedQueryCommandInterceptor : DbCommandInterceptor
+{
+    public override InterceptionResult<DbDataReader> ReaderExecuting(
+        DbCommand command,
+        CommandEventData eventData,
+        InterceptionResult<DbDataReader> result)
+    {
+        ManipulateCommand(command);
+
+        return result;
+    }
+
+    public override ValueTask<InterceptionResult<DbDataReader>> ReaderExecutingAsync(
+        DbCommand command,
+        CommandEventData eventData,
+        InterceptionResult<DbDataReader> result,
+        CancellationToken cancellationToken = default)
+    {
+        ManipulateCommand(command);
+
+        return new ValueTask<InterceptionResult<DbDataReader>>(result);
+    }
+
+    private static void ManipulateCommand(DbCommand command)
+    {
+        if (command.CommandText.StartsWith("-- Use hint: robust plan", StringComparison.Ordinal))
+        {
+            command.CommandText += " OPTION (ROBUST PLAN)";
+        }
+    }
+}
+#endregion
diff --git a/samples/core/Miscellaneous/CommandLine/ApplicationService.cs b/samples/core/Miscellaneous/CommandLine/ApplicationService.cs
new file mode 100644
index 0000000000..03cada3fb8
--- /dev/null
+++ b/samples/core/Miscellaneous/CommandLine/ApplicationService.cs
@@ -0,0 +1,37 @@
+using Microsoft.AspNetCore.Builder;
+using Microsoft.AspNetCore.Hosting;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+
+#region ApplicationService
+public class Program
+{
+    public static void Main(string[] args)
+        => CreateHostBuilder(args).Build().Run();
+
+    // EF Core uses this method at design time to access the DbContext
+    public static IHostBuilder CreateHostBuilder(string[] args)
+        => Host.CreateDefaultBuilder(args)
+            .ConfigureWebHostDefaults(
+                webBuilder => webBuilder.UseStartup<Startup>());
+}
+
+public class Startup
+{
+    public void ConfigureServices(IServiceCollection services)
+        => services.AddDbContext<ApplicationDbContext>();
+
+    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
+    {
+    }
+}
+
+public class ApplicationDbContext : DbContext
+{
+    public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options)
+        : base(options)
+    {
+    }
+}
+#endregion
diff --git a/samples/core/Miscellaneous/CommandLine/BloggingContextFactory.cs b/samples/core/Miscellaneous/CommandLine/BloggingContextFactory.cs
new file mode 100644
index 0000000000..247fc2853e
--- /dev/null
+++ b/samples/core/Miscellaneous/CommandLine/BloggingContextFactory.cs
@@ -0,0 +1,25 @@
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Design;
+
+namespace MyProject;
+
+#region BloggingContextFactory
+public class BloggingContextFactory : IDesignTimeDbContextFactory<BloggingContext>
+{
+    public BloggingContext CreateDbContext(string[] args)
+    {
+        var optionsBuilder = new DbContextOptionsBuilder<BloggingContext>();
+        optionsBuilder.UseSqlite("Data Source=blog.db");
+
+        return new BloggingContext(optionsBuilder.Options);
+    }
+}
+#endregion
+
+public class BloggingContext : DbContext
+{
+    public BloggingContext(DbContextOptions<BloggingContext> options)
+        : base(options)
+    {
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/CommandLine/CommandLine.csproj b/samples/core/Miscellaneous/CommandLine/CommandLine.csproj
new file mode 100644
index 0000000000..7ff8efdfb2
--- /dev/null
+++ b/samples/core/Miscellaneous/CommandLine/CommandLine.csproj
@@ -0,0 +1,12 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.0" PrivateAssets="all" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/CommandLine/CustomTools.cs b/samples/core/Miscellaneous/CommandLine/CustomTools.cs
new file mode 100644
index 0000000000..8450b1c463
--- /dev/null
+++ b/samples/core/Miscellaneous/CommandLine/CustomTools.cs
@@ -0,0 +1,60 @@
+using System;
+using System.IO;
+using System.Reflection;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Design;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations.Design;
+using Microsoft.EntityFrameworkCore.Storage;
+using Microsoft.Extensions.DependencyInjection;
+
+namespace CommandLine;
+
+public class CustomTools
+{
+    public static void AddMigration(string migrationName)
+    {
+        var projectDir = Directory.GetCurrentDirectory();
+        var rootNamespace = "ConsoleApp1";
+        var outputDir = "Migrations";
+
+        #region CustomTools
+        using var db = new MyDbContext();
+
+        // Create design-time services
+        var serviceCollection = new ServiceCollection();
+        serviceCollection.AddDbContextDesignTimeServices(db);
+        
+        var provider = db.GetService<IDatabaseProvider>().Name;
+        var providerAssembly = Assembly.Load(new AssemblyName(provider));
+        var providerServicesAttribute = providerAssembly.GetCustomAttribute<DesignTimeProviderServicesAttribute>();
+        var designTimeServicesType = providerAssembly.GetType(providerServicesAttribute.TypeName, throwOnError: true);
+        ((IDesignTimeServices)Activator.CreateInstance(designTimeServicesType)!).ConfigureDesignTimeServices(serviceCollection);
+
+        serviceCollection.AddEntityFrameworkDesignTimeServices();
+
+        var serviceProvider = serviceCollection.BuildServiceProvider();
+
+        // Add a migration
+        var migrationsScaffolder = serviceProvider.GetRequiredService<IMigrationsScaffolder>();
+        var migration = migrationsScaffolder.ScaffoldMigration(migrationName, rootNamespace);
+        migrationsScaffolder.Save(projectDir, migration, outputDir);
+        #endregion
+    }
+}
+
+internal class MyDbContext : DbContext
+{
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder.UseSqlite(@"Data Source=test.db");
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+internal class Blog
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/CommandLine/DesignTimeServices.cs b/samples/core/Miscellaneous/CommandLine/DesignTimeServices.cs
new file mode 100644
index 0000000000..9e8665f205
--- /dev/null
+++ b/samples/core/Miscellaneous/CommandLine/DesignTimeServices.cs
@@ -0,0 +1,21 @@
+using Microsoft.EntityFrameworkCore.Design;
+using Microsoft.EntityFrameworkCore.Migrations.Design;
+using Microsoft.Extensions.DependencyInjection;
+
+#region DesignTimeServices
+internal class MyDesignTimeServices : IDesignTimeServices
+{
+    public void ConfigureDesignTimeServices(IServiceCollection services)
+        => services.AddSingleton<IMigrationsCodeGenerator, MyMigrationsCodeGenerator>();
+}
+#endregion
+
+internal class MyMigrationsCodeGenerator : CSharpMigrationsGenerator
+{
+    public MyMigrationsCodeGenerator(
+        MigrationsCodeGeneratorDependencies dependencies,
+        CSharpMigrationsGeneratorDependencies csharpDependencies)
+        : base(dependencies, csharpDependencies)
+    {
+    }
+}
diff --git a/samples/core/Miscellaneous/CommandLine/Properties/launchSettings.json b/samples/core/Miscellaneous/CommandLine/Properties/launchSettings.json
new file mode 100644
index 0000000000..b26cc61c35
--- /dev/null
+++ b/samples/core/Miscellaneous/CommandLine/Properties/launchSettings.json
@@ -0,0 +1,12 @@
+{
+  "profiles": {
+    "CommandLine": {
+      "commandName": "Project",
+      "launchBrowser": true,
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      },
+      "applicationUrl": "https://localhost:58213;http://localhost:58218"
+    }
+  }
+}
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/CompiledModels/Blog000.cs b/samples/core/Miscellaneous/CompiledModels/Blog000.cs
new file mode 100644
index 0000000000..c9b186bb05
--- /dev/null
+++ b/samples/core/Miscellaneous/CompiledModels/Blog000.cs
@@ -0,0 +1,4684 @@
+using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations;
+
+namespace CompiledModelTest;
+
+public class Blog0000
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0000> Tags { get; set; }
+
+    public ICollection<Post0000> Posts00 { get; } = new List<Post0000>();
+    public ICollection<Post0000> Posts01 { get; } = new List<Post0000>();
+    public ICollection<Post0000> Posts02 { get; } = new List<Post0000>();
+    public ICollection<Post0000> Posts03 { get; } = new List<Post0000>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0001
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0001> Tags { get; set; }
+
+    public ICollection<Post0001> Posts00 { get; } = new List<Post0001>();
+    public ICollection<Post0001> Posts01 { get; } = new List<Post0001>();
+    public ICollection<Post0001> Posts02 { get; } = new List<Post0001>();
+    public ICollection<Post0001> Posts03 { get; } = new List<Post0001>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0002
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0002> Tags { get; set; }
+
+    public ICollection<Post0002> Posts00 { get; } = new List<Post0002>();
+    public ICollection<Post0002> Posts01 { get; } = new List<Post0002>();
+    public ICollection<Post0002> Posts02 { get; } = new List<Post0002>();
+    public ICollection<Post0002> Posts03 { get; } = new List<Post0002>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0003
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0003> Tags { get; set; }
+
+    public ICollection<Post0003> Posts00 { get; } = new List<Post0003>();
+    public ICollection<Post0003> Posts01 { get; } = new List<Post0003>();
+    public ICollection<Post0003> Posts02 { get; } = new List<Post0003>();
+    public ICollection<Post0003> Posts03 { get; } = new List<Post0003>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0004
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0004> Tags { get; set; }
+
+    public ICollection<Post0004> Posts00 { get; } = new List<Post0004>();
+    public ICollection<Post0004> Posts01 { get; } = new List<Post0004>();
+    public ICollection<Post0004> Posts02 { get; } = new List<Post0004>();
+    public ICollection<Post0004> Posts03 { get; } = new List<Post0004>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0005
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0005> Tags { get; set; }
+
+    public ICollection<Post0005> Posts00 { get; } = new List<Post0005>();
+    public ICollection<Post0005> Posts01 { get; } = new List<Post0005>();
+    public ICollection<Post0005> Posts02 { get; } = new List<Post0005>();
+    public ICollection<Post0005> Posts03 { get; } = new List<Post0005>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0006
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0006> Tags { get; set; }
+
+    public ICollection<Post0006> Posts00 { get; } = new List<Post0006>();
+    public ICollection<Post0006> Posts01 { get; } = new List<Post0006>();
+    public ICollection<Post0006> Posts02 { get; } = new List<Post0006>();
+    public ICollection<Post0006> Posts03 { get; } = new List<Post0006>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0007
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0007> Tags { get; set; }
+
+    public ICollection<Post0007> Posts00 { get; } = new List<Post0007>();
+    public ICollection<Post0007> Posts01 { get; } = new List<Post0007>();
+    public ICollection<Post0007> Posts02 { get; } = new List<Post0007>();
+    public ICollection<Post0007> Posts03 { get; } = new List<Post0007>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0008
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0008> Tags { get; set; }
+
+    public ICollection<Post0008> Posts00 { get; } = new List<Post0008>();
+    public ICollection<Post0008> Posts01 { get; } = new List<Post0008>();
+    public ICollection<Post0008> Posts02 { get; } = new List<Post0008>();
+    public ICollection<Post0008> Posts03 { get; } = new List<Post0008>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0009
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0009> Tags { get; set; }
+
+    public ICollection<Post0009> Posts00 { get; } = new List<Post0009>();
+    public ICollection<Post0009> Posts01 { get; } = new List<Post0009>();
+    public ICollection<Post0009> Posts02 { get; } = new List<Post0009>();
+    public ICollection<Post0009> Posts03 { get; } = new List<Post0009>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0010
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0010> Tags { get; set; }
+
+    public ICollection<Post0010> Posts00 { get; } = new List<Post0010>();
+    public ICollection<Post0010> Posts01 { get; } = new List<Post0010>();
+    public ICollection<Post0010> Posts02 { get; } = new List<Post0010>();
+    public ICollection<Post0010> Posts03 { get; } = new List<Post0010>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0011
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0011> Tags { get; set; }
+
+    public ICollection<Post0011> Posts00 { get; } = new List<Post0011>();
+    public ICollection<Post0011> Posts01 { get; } = new List<Post0011>();
+    public ICollection<Post0011> Posts02 { get; } = new List<Post0011>();
+    public ICollection<Post0011> Posts03 { get; } = new List<Post0011>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0012
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0012> Tags { get; set; }
+
+    public ICollection<Post0012> Posts00 { get; } = new List<Post0012>();
+    public ICollection<Post0012> Posts01 { get; } = new List<Post0012>();
+    public ICollection<Post0012> Posts02 { get; } = new List<Post0012>();
+    public ICollection<Post0012> Posts03 { get; } = new List<Post0012>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0013
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0013> Tags { get; set; }
+
+    public ICollection<Post0013> Posts00 { get; } = new List<Post0013>();
+    public ICollection<Post0013> Posts01 { get; } = new List<Post0013>();
+    public ICollection<Post0013> Posts02 { get; } = new List<Post0013>();
+    public ICollection<Post0013> Posts03 { get; } = new List<Post0013>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0014
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0014> Tags { get; set; }
+
+    public ICollection<Post0014> Posts00 { get; } = new List<Post0014>();
+    public ICollection<Post0014> Posts01 { get; } = new List<Post0014>();
+    public ICollection<Post0014> Posts02 { get; } = new List<Post0014>();
+    public ICollection<Post0014> Posts03 { get; } = new List<Post0014>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0015
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0015> Tags { get; set; }
+
+    public ICollection<Post0015> Posts00 { get; } = new List<Post0015>();
+    public ICollection<Post0015> Posts01 { get; } = new List<Post0015>();
+    public ICollection<Post0015> Posts02 { get; } = new List<Post0015>();
+    public ICollection<Post0015> Posts03 { get; } = new List<Post0015>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0016
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0016> Tags { get; set; }
+
+    public ICollection<Post0016> Posts00 { get; } = new List<Post0016>();
+    public ICollection<Post0016> Posts01 { get; } = new List<Post0016>();
+    public ICollection<Post0016> Posts02 { get; } = new List<Post0016>();
+    public ICollection<Post0016> Posts03 { get; } = new List<Post0016>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0017
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0017> Tags { get; set; }
+
+    public ICollection<Post0017> Posts00 { get; } = new List<Post0017>();
+    public ICollection<Post0017> Posts01 { get; } = new List<Post0017>();
+    public ICollection<Post0017> Posts02 { get; } = new List<Post0017>();
+    public ICollection<Post0017> Posts03 { get; } = new List<Post0017>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0018
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0018> Tags { get; set; }
+
+    public ICollection<Post0018> Posts00 { get; } = new List<Post0018>();
+    public ICollection<Post0018> Posts01 { get; } = new List<Post0018>();
+    public ICollection<Post0018> Posts02 { get; } = new List<Post0018>();
+    public ICollection<Post0018> Posts03 { get; } = new List<Post0018>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0019
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0019> Tags { get; set; }
+
+    public ICollection<Post0019> Posts00 { get; } = new List<Post0019>();
+    public ICollection<Post0019> Posts01 { get; } = new List<Post0019>();
+    public ICollection<Post0019> Posts02 { get; } = new List<Post0019>();
+    public ICollection<Post0019> Posts03 { get; } = new List<Post0019>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0020
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0020> Tags { get; set; }
+
+    public ICollection<Post0020> Posts00 { get; } = new List<Post0020>();
+    public ICollection<Post0020> Posts01 { get; } = new List<Post0020>();
+    public ICollection<Post0020> Posts02 { get; } = new List<Post0020>();
+    public ICollection<Post0020> Posts03 { get; } = new List<Post0020>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0021
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0021> Tags { get; set; }
+
+    public ICollection<Post0021> Posts00 { get; } = new List<Post0021>();
+    public ICollection<Post0021> Posts01 { get; } = new List<Post0021>();
+    public ICollection<Post0021> Posts02 { get; } = new List<Post0021>();
+    public ICollection<Post0021> Posts03 { get; } = new List<Post0021>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0022
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0022> Tags { get; set; }
+
+    public ICollection<Post0022> Posts00 { get; } = new List<Post0022>();
+    public ICollection<Post0022> Posts01 { get; } = new List<Post0022>();
+    public ICollection<Post0022> Posts02 { get; } = new List<Post0022>();
+    public ICollection<Post0022> Posts03 { get; } = new List<Post0022>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0023
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0023> Tags { get; set; }
+
+    public ICollection<Post0023> Posts00 { get; } = new List<Post0023>();
+    public ICollection<Post0023> Posts01 { get; } = new List<Post0023>();
+    public ICollection<Post0023> Posts02 { get; } = new List<Post0023>();
+    public ICollection<Post0023> Posts03 { get; } = new List<Post0023>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0024
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0024> Tags { get; set; }
+
+    public ICollection<Post0024> Posts00 { get; } = new List<Post0024>();
+    public ICollection<Post0024> Posts01 { get; } = new List<Post0024>();
+    public ICollection<Post0024> Posts02 { get; } = new List<Post0024>();
+    public ICollection<Post0024> Posts03 { get; } = new List<Post0024>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0025
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0025> Tags { get; set; }
+
+    public ICollection<Post0025> Posts00 { get; } = new List<Post0025>();
+    public ICollection<Post0025> Posts01 { get; } = new List<Post0025>();
+    public ICollection<Post0025> Posts02 { get; } = new List<Post0025>();
+    public ICollection<Post0025> Posts03 { get; } = new List<Post0025>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0026
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0026> Tags { get; set; }
+
+    public ICollection<Post0026> Posts00 { get; } = new List<Post0026>();
+    public ICollection<Post0026> Posts01 { get; } = new List<Post0026>();
+    public ICollection<Post0026> Posts02 { get; } = new List<Post0026>();
+    public ICollection<Post0026> Posts03 { get; } = new List<Post0026>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0027
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0027> Tags { get; set; }
+
+    public ICollection<Post0027> Posts00 { get; } = new List<Post0027>();
+    public ICollection<Post0027> Posts01 { get; } = new List<Post0027>();
+    public ICollection<Post0027> Posts02 { get; } = new List<Post0027>();
+    public ICollection<Post0027> Posts03 { get; } = new List<Post0027>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0028
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0028> Tags { get; set; }
+
+    public ICollection<Post0028> Posts00 { get; } = new List<Post0028>();
+    public ICollection<Post0028> Posts01 { get; } = new List<Post0028>();
+    public ICollection<Post0028> Posts02 { get; } = new List<Post0028>();
+    public ICollection<Post0028> Posts03 { get; } = new List<Post0028>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0029
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0029> Tags { get; set; }
+
+    public ICollection<Post0029> Posts00 { get; } = new List<Post0029>();
+    public ICollection<Post0029> Posts01 { get; } = new List<Post0029>();
+    public ICollection<Post0029> Posts02 { get; } = new List<Post0029>();
+    public ICollection<Post0029> Posts03 { get; } = new List<Post0029>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0030
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0030> Tags { get; set; }
+
+    public ICollection<Post0030> Posts00 { get; } = new List<Post0030>();
+    public ICollection<Post0030> Posts01 { get; } = new List<Post0030>();
+    public ICollection<Post0030> Posts02 { get; } = new List<Post0030>();
+    public ICollection<Post0030> Posts03 { get; } = new List<Post0030>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0031
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0031> Tags { get; set; }
+
+    public ICollection<Post0031> Posts00 { get; } = new List<Post0031>();
+    public ICollection<Post0031> Posts01 { get; } = new List<Post0031>();
+    public ICollection<Post0031> Posts02 { get; } = new List<Post0031>();
+    public ICollection<Post0031> Posts03 { get; } = new List<Post0031>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0032
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0032> Tags { get; set; }
+
+    public ICollection<Post0032> Posts00 { get; } = new List<Post0032>();
+    public ICollection<Post0032> Posts01 { get; } = new List<Post0032>();
+    public ICollection<Post0032> Posts02 { get; } = new List<Post0032>();
+    public ICollection<Post0032> Posts03 { get; } = new List<Post0032>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0033
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0033> Tags { get; set; }
+
+    public ICollection<Post0033> Posts00 { get; } = new List<Post0033>();
+    public ICollection<Post0033> Posts01 { get; } = new List<Post0033>();
+    public ICollection<Post0033> Posts02 { get; } = new List<Post0033>();
+    public ICollection<Post0033> Posts03 { get; } = new List<Post0033>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0034
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0034> Tags { get; set; }
+
+    public ICollection<Post0034> Posts00 { get; } = new List<Post0034>();
+    public ICollection<Post0034> Posts01 { get; } = new List<Post0034>();
+    public ICollection<Post0034> Posts02 { get; } = new List<Post0034>();
+    public ICollection<Post0034> Posts03 { get; } = new List<Post0034>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0035
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0035> Tags { get; set; }
+
+    public ICollection<Post0035> Posts00 { get; } = new List<Post0035>();
+    public ICollection<Post0035> Posts01 { get; } = new List<Post0035>();
+    public ICollection<Post0035> Posts02 { get; } = new List<Post0035>();
+    public ICollection<Post0035> Posts03 { get; } = new List<Post0035>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0036
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0036> Tags { get; set; }
+
+    public ICollection<Post0036> Posts00 { get; } = new List<Post0036>();
+    public ICollection<Post0036> Posts01 { get; } = new List<Post0036>();
+    public ICollection<Post0036> Posts02 { get; } = new List<Post0036>();
+    public ICollection<Post0036> Posts03 { get; } = new List<Post0036>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0037
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0037> Tags { get; set; }
+
+    public ICollection<Post0037> Posts00 { get; } = new List<Post0037>();
+    public ICollection<Post0037> Posts01 { get; } = new List<Post0037>();
+    public ICollection<Post0037> Posts02 { get; } = new List<Post0037>();
+    public ICollection<Post0037> Posts03 { get; } = new List<Post0037>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0038
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0038> Tags { get; set; }
+
+    public ICollection<Post0038> Posts00 { get; } = new List<Post0038>();
+    public ICollection<Post0038> Posts01 { get; } = new List<Post0038>();
+    public ICollection<Post0038> Posts02 { get; } = new List<Post0038>();
+    public ICollection<Post0038> Posts03 { get; } = new List<Post0038>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0039
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0039> Tags { get; set; }
+
+    public ICollection<Post0039> Posts00 { get; } = new List<Post0039>();
+    public ICollection<Post0039> Posts01 { get; } = new List<Post0039>();
+    public ICollection<Post0039> Posts02 { get; } = new List<Post0039>();
+    public ICollection<Post0039> Posts03 { get; } = new List<Post0039>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0040
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0040> Tags { get; set; }
+
+    public ICollection<Post0040> Posts00 { get; } = new List<Post0040>();
+    public ICollection<Post0040> Posts01 { get; } = new List<Post0040>();
+    public ICollection<Post0040> Posts02 { get; } = new List<Post0040>();
+    public ICollection<Post0040> Posts03 { get; } = new List<Post0040>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0041
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0041> Tags { get; set; }
+
+    public ICollection<Post0041> Posts00 { get; } = new List<Post0041>();
+    public ICollection<Post0041> Posts01 { get; } = new List<Post0041>();
+    public ICollection<Post0041> Posts02 { get; } = new List<Post0041>();
+    public ICollection<Post0041> Posts03 { get; } = new List<Post0041>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0042
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0042> Tags { get; set; }
+
+    public ICollection<Post0042> Posts00 { get; } = new List<Post0042>();
+    public ICollection<Post0042> Posts01 { get; } = new List<Post0042>();
+    public ICollection<Post0042> Posts02 { get; } = new List<Post0042>();
+    public ICollection<Post0042> Posts03 { get; } = new List<Post0042>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0043
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0043> Tags { get; set; }
+
+    public ICollection<Post0043> Posts00 { get; } = new List<Post0043>();
+    public ICollection<Post0043> Posts01 { get; } = new List<Post0043>();
+    public ICollection<Post0043> Posts02 { get; } = new List<Post0043>();
+    public ICollection<Post0043> Posts03 { get; } = new List<Post0043>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0044
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0044> Tags { get; set; }
+
+    public ICollection<Post0044> Posts00 { get; } = new List<Post0044>();
+    public ICollection<Post0044> Posts01 { get; } = new List<Post0044>();
+    public ICollection<Post0044> Posts02 { get; } = new List<Post0044>();
+    public ICollection<Post0044> Posts03 { get; } = new List<Post0044>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0045
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0045> Tags { get; set; }
+
+    public ICollection<Post0045> Posts00 { get; } = new List<Post0045>();
+    public ICollection<Post0045> Posts01 { get; } = new List<Post0045>();
+    public ICollection<Post0045> Posts02 { get; } = new List<Post0045>();
+    public ICollection<Post0045> Posts03 { get; } = new List<Post0045>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0046
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0046> Tags { get; set; }
+
+    public ICollection<Post0046> Posts00 { get; } = new List<Post0046>();
+    public ICollection<Post0046> Posts01 { get; } = new List<Post0046>();
+    public ICollection<Post0046> Posts02 { get; } = new List<Post0046>();
+    public ICollection<Post0046> Posts03 { get; } = new List<Post0046>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0047
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0047> Tags { get; set; }
+
+    public ICollection<Post0047> Posts00 { get; } = new List<Post0047>();
+    public ICollection<Post0047> Posts01 { get; } = new List<Post0047>();
+    public ICollection<Post0047> Posts02 { get; } = new List<Post0047>();
+    public ICollection<Post0047> Posts03 { get; } = new List<Post0047>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0048
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0048> Tags { get; set; }
+
+    public ICollection<Post0048> Posts00 { get; } = new List<Post0048>();
+    public ICollection<Post0048> Posts01 { get; } = new List<Post0048>();
+    public ICollection<Post0048> Posts02 { get; } = new List<Post0048>();
+    public ICollection<Post0048> Posts03 { get; } = new List<Post0048>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0049
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0049> Tags { get; set; }
+
+    public ICollection<Post0049> Posts00 { get; } = new List<Post0049>();
+    public ICollection<Post0049> Posts01 { get; } = new List<Post0049>();
+    public ICollection<Post0049> Posts02 { get; } = new List<Post0049>();
+    public ICollection<Post0049> Posts03 { get; } = new List<Post0049>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0050
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0050> Tags { get; set; }
+
+    public ICollection<Post0050> Posts00 { get; } = new List<Post0050>();
+    public ICollection<Post0050> Posts01 { get; } = new List<Post0050>();
+    public ICollection<Post0050> Posts02 { get; } = new List<Post0050>();
+    public ICollection<Post0050> Posts03 { get; } = new List<Post0050>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0051
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0051> Tags { get; set; }
+
+    public ICollection<Post0051> Posts00 { get; } = new List<Post0051>();
+    public ICollection<Post0051> Posts01 { get; } = new List<Post0051>();
+    public ICollection<Post0051> Posts02 { get; } = new List<Post0051>();
+    public ICollection<Post0051> Posts03 { get; } = new List<Post0051>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0052
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0052> Tags { get; set; }
+
+    public ICollection<Post0052> Posts00 { get; } = new List<Post0052>();
+    public ICollection<Post0052> Posts01 { get; } = new List<Post0052>();
+    public ICollection<Post0052> Posts02 { get; } = new List<Post0052>();
+    public ICollection<Post0052> Posts03 { get; } = new List<Post0052>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0053
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0053> Tags { get; set; }
+
+    public ICollection<Post0053> Posts00 { get; } = new List<Post0053>();
+    public ICollection<Post0053> Posts01 { get; } = new List<Post0053>();
+    public ICollection<Post0053> Posts02 { get; } = new List<Post0053>();
+    public ICollection<Post0053> Posts03 { get; } = new List<Post0053>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0054
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0054> Tags { get; set; }
+
+    public ICollection<Post0054> Posts00 { get; } = new List<Post0054>();
+    public ICollection<Post0054> Posts01 { get; } = new List<Post0054>();
+    public ICollection<Post0054> Posts02 { get; } = new List<Post0054>();
+    public ICollection<Post0054> Posts03 { get; } = new List<Post0054>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0055
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0055> Tags { get; set; }
+
+    public ICollection<Post0055> Posts00 { get; } = new List<Post0055>();
+    public ICollection<Post0055> Posts01 { get; } = new List<Post0055>();
+    public ICollection<Post0055> Posts02 { get; } = new List<Post0055>();
+    public ICollection<Post0055> Posts03 { get; } = new List<Post0055>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0056
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0056> Tags { get; set; }
+
+    public ICollection<Post0056> Posts00 { get; } = new List<Post0056>();
+    public ICollection<Post0056> Posts01 { get; } = new List<Post0056>();
+    public ICollection<Post0056> Posts02 { get; } = new List<Post0056>();
+    public ICollection<Post0056> Posts03 { get; } = new List<Post0056>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0057
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0057> Tags { get; set; }
+
+    public ICollection<Post0057> Posts00 { get; } = new List<Post0057>();
+    public ICollection<Post0057> Posts01 { get; } = new List<Post0057>();
+    public ICollection<Post0057> Posts02 { get; } = new List<Post0057>();
+    public ICollection<Post0057> Posts03 { get; } = new List<Post0057>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0058
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0058> Tags { get; set; }
+
+    public ICollection<Post0058> Posts00 { get; } = new List<Post0058>();
+    public ICollection<Post0058> Posts01 { get; } = new List<Post0058>();
+    public ICollection<Post0058> Posts02 { get; } = new List<Post0058>();
+    public ICollection<Post0058> Posts03 { get; } = new List<Post0058>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0059
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0059> Tags { get; set; }
+
+    public ICollection<Post0059> Posts00 { get; } = new List<Post0059>();
+    public ICollection<Post0059> Posts01 { get; } = new List<Post0059>();
+    public ICollection<Post0059> Posts02 { get; } = new List<Post0059>();
+    public ICollection<Post0059> Posts03 { get; } = new List<Post0059>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0060
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0060> Tags { get; set; }
+
+    public ICollection<Post0060> Posts00 { get; } = new List<Post0060>();
+    public ICollection<Post0060> Posts01 { get; } = new List<Post0060>();
+    public ICollection<Post0060> Posts02 { get; } = new List<Post0060>();
+    public ICollection<Post0060> Posts03 { get; } = new List<Post0060>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0061
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0061> Tags { get; set; }
+
+    public ICollection<Post0061> Posts00 { get; } = new List<Post0061>();
+    public ICollection<Post0061> Posts01 { get; } = new List<Post0061>();
+    public ICollection<Post0061> Posts02 { get; } = new List<Post0061>();
+    public ICollection<Post0061> Posts03 { get; } = new List<Post0061>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0062
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0062> Tags { get; set; }
+
+    public ICollection<Post0062> Posts00 { get; } = new List<Post0062>();
+    public ICollection<Post0062> Posts01 { get; } = new List<Post0062>();
+    public ICollection<Post0062> Posts02 { get; } = new List<Post0062>();
+    public ICollection<Post0062> Posts03 { get; } = new List<Post0062>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0063
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0063> Tags { get; set; }
+
+    public ICollection<Post0063> Posts00 { get; } = new List<Post0063>();
+    public ICollection<Post0063> Posts01 { get; } = new List<Post0063>();
+    public ICollection<Post0063> Posts02 { get; } = new List<Post0063>();
+    public ICollection<Post0063> Posts03 { get; } = new List<Post0063>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0064
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0064> Tags { get; set; }
+
+    public ICollection<Post0064> Posts00 { get; } = new List<Post0064>();
+    public ICollection<Post0064> Posts01 { get; } = new List<Post0064>();
+    public ICollection<Post0064> Posts02 { get; } = new List<Post0064>();
+    public ICollection<Post0064> Posts03 { get; } = new List<Post0064>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0065
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0065> Tags { get; set; }
+
+    public ICollection<Post0065> Posts00 { get; } = new List<Post0065>();
+    public ICollection<Post0065> Posts01 { get; } = new List<Post0065>();
+    public ICollection<Post0065> Posts02 { get; } = new List<Post0065>();
+    public ICollection<Post0065> Posts03 { get; } = new List<Post0065>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0066
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0066> Tags { get; set; }
+
+    public ICollection<Post0066> Posts00 { get; } = new List<Post0066>();
+    public ICollection<Post0066> Posts01 { get; } = new List<Post0066>();
+    public ICollection<Post0066> Posts02 { get; } = new List<Post0066>();
+    public ICollection<Post0066> Posts03 { get; } = new List<Post0066>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0067
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0067> Tags { get; set; }
+
+    public ICollection<Post0067> Posts00 { get; } = new List<Post0067>();
+    public ICollection<Post0067> Posts01 { get; } = new List<Post0067>();
+    public ICollection<Post0067> Posts02 { get; } = new List<Post0067>();
+    public ICollection<Post0067> Posts03 { get; } = new List<Post0067>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0068
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0068> Tags { get; set; }
+
+    public ICollection<Post0068> Posts00 { get; } = new List<Post0068>();
+    public ICollection<Post0068> Posts01 { get; } = new List<Post0068>();
+    public ICollection<Post0068> Posts02 { get; } = new List<Post0068>();
+    public ICollection<Post0068> Posts03 { get; } = new List<Post0068>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0069
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0069> Tags { get; set; }
+
+    public ICollection<Post0069> Posts00 { get; } = new List<Post0069>();
+    public ICollection<Post0069> Posts01 { get; } = new List<Post0069>();
+    public ICollection<Post0069> Posts02 { get; } = new List<Post0069>();
+    public ICollection<Post0069> Posts03 { get; } = new List<Post0069>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0070
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0070> Tags { get; set; }
+
+    public ICollection<Post0070> Posts00 { get; } = new List<Post0070>();
+    public ICollection<Post0070> Posts01 { get; } = new List<Post0070>();
+    public ICollection<Post0070> Posts02 { get; } = new List<Post0070>();
+    public ICollection<Post0070> Posts03 { get; } = new List<Post0070>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0071
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0071> Tags { get; set; }
+
+    public ICollection<Post0071> Posts00 { get; } = new List<Post0071>();
+    public ICollection<Post0071> Posts01 { get; } = new List<Post0071>();
+    public ICollection<Post0071> Posts02 { get; } = new List<Post0071>();
+    public ICollection<Post0071> Posts03 { get; } = new List<Post0071>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0072
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0072> Tags { get; set; }
+
+    public ICollection<Post0072> Posts00 { get; } = new List<Post0072>();
+    public ICollection<Post0072> Posts01 { get; } = new List<Post0072>();
+    public ICollection<Post0072> Posts02 { get; } = new List<Post0072>();
+    public ICollection<Post0072> Posts03 { get; } = new List<Post0072>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0073
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0073> Tags { get; set; }
+
+    public ICollection<Post0073> Posts00 { get; } = new List<Post0073>();
+    public ICollection<Post0073> Posts01 { get; } = new List<Post0073>();
+    public ICollection<Post0073> Posts02 { get; } = new List<Post0073>();
+    public ICollection<Post0073> Posts03 { get; } = new List<Post0073>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0074
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0074> Tags { get; set; }
+
+    public ICollection<Post0074> Posts00 { get; } = new List<Post0074>();
+    public ICollection<Post0074> Posts01 { get; } = new List<Post0074>();
+    public ICollection<Post0074> Posts02 { get; } = new List<Post0074>();
+    public ICollection<Post0074> Posts03 { get; } = new List<Post0074>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0075
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0075> Tags { get; set; }
+
+    public ICollection<Post0075> Posts00 { get; } = new List<Post0075>();
+    public ICollection<Post0075> Posts01 { get; } = new List<Post0075>();
+    public ICollection<Post0075> Posts02 { get; } = new List<Post0075>();
+    public ICollection<Post0075> Posts03 { get; } = new List<Post0075>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0076
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0076> Tags { get; set; }
+
+    public ICollection<Post0076> Posts00 { get; } = new List<Post0076>();
+    public ICollection<Post0076> Posts01 { get; } = new List<Post0076>();
+    public ICollection<Post0076> Posts02 { get; } = new List<Post0076>();
+    public ICollection<Post0076> Posts03 { get; } = new List<Post0076>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0077
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0077> Tags { get; set; }
+
+    public ICollection<Post0077> Posts00 { get; } = new List<Post0077>();
+    public ICollection<Post0077> Posts01 { get; } = new List<Post0077>();
+    public ICollection<Post0077> Posts02 { get; } = new List<Post0077>();
+    public ICollection<Post0077> Posts03 { get; } = new List<Post0077>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0078
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0078> Tags { get; set; }
+
+    public ICollection<Post0078> Posts00 { get; } = new List<Post0078>();
+    public ICollection<Post0078> Posts01 { get; } = new List<Post0078>();
+    public ICollection<Post0078> Posts02 { get; } = new List<Post0078>();
+    public ICollection<Post0078> Posts03 { get; } = new List<Post0078>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0079
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0079> Tags { get; set; }
+
+    public ICollection<Post0079> Posts00 { get; } = new List<Post0079>();
+    public ICollection<Post0079> Posts01 { get; } = new List<Post0079>();
+    public ICollection<Post0079> Posts02 { get; } = new List<Post0079>();
+    public ICollection<Post0079> Posts03 { get; } = new List<Post0079>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0080
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0080> Tags { get; set; }
+
+    public ICollection<Post0080> Posts00 { get; } = new List<Post0080>();
+    public ICollection<Post0080> Posts01 { get; } = new List<Post0080>();
+    public ICollection<Post0080> Posts02 { get; } = new List<Post0080>();
+    public ICollection<Post0080> Posts03 { get; } = new List<Post0080>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0081
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0081> Tags { get; set; }
+
+    public ICollection<Post0081> Posts00 { get; } = new List<Post0081>();
+    public ICollection<Post0081> Posts01 { get; } = new List<Post0081>();
+    public ICollection<Post0081> Posts02 { get; } = new List<Post0081>();
+    public ICollection<Post0081> Posts03 { get; } = new List<Post0081>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0082
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0082> Tags { get; set; }
+
+    public ICollection<Post0082> Posts00 { get; } = new List<Post0082>();
+    public ICollection<Post0082> Posts01 { get; } = new List<Post0082>();
+    public ICollection<Post0082> Posts02 { get; } = new List<Post0082>();
+    public ICollection<Post0082> Posts03 { get; } = new List<Post0082>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0083
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0083> Tags { get; set; }
+
+    public ICollection<Post0083> Posts00 { get; } = new List<Post0083>();
+    public ICollection<Post0083> Posts01 { get; } = new List<Post0083>();
+    public ICollection<Post0083> Posts02 { get; } = new List<Post0083>();
+    public ICollection<Post0083> Posts03 { get; } = new List<Post0083>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0084
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0084> Tags { get; set; }
+
+    public ICollection<Post0084> Posts00 { get; } = new List<Post0084>();
+    public ICollection<Post0084> Posts01 { get; } = new List<Post0084>();
+    public ICollection<Post0084> Posts02 { get; } = new List<Post0084>();
+    public ICollection<Post0084> Posts03 { get; } = new List<Post0084>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0085
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0085> Tags { get; set; }
+
+    public ICollection<Post0085> Posts00 { get; } = new List<Post0085>();
+    public ICollection<Post0085> Posts01 { get; } = new List<Post0085>();
+    public ICollection<Post0085> Posts02 { get; } = new List<Post0085>();
+    public ICollection<Post0085> Posts03 { get; } = new List<Post0085>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0086
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0086> Tags { get; set; }
+
+    public ICollection<Post0086> Posts00 { get; } = new List<Post0086>();
+    public ICollection<Post0086> Posts01 { get; } = new List<Post0086>();
+    public ICollection<Post0086> Posts02 { get; } = new List<Post0086>();
+    public ICollection<Post0086> Posts03 { get; } = new List<Post0086>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0087
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0087> Tags { get; set; }
+
+    public ICollection<Post0087> Posts00 { get; } = new List<Post0087>();
+    public ICollection<Post0087> Posts01 { get; } = new List<Post0087>();
+    public ICollection<Post0087> Posts02 { get; } = new List<Post0087>();
+    public ICollection<Post0087> Posts03 { get; } = new List<Post0087>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0088
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0088> Tags { get; set; }
+
+    public ICollection<Post0088> Posts00 { get; } = new List<Post0088>();
+    public ICollection<Post0088> Posts01 { get; } = new List<Post0088>();
+    public ICollection<Post0088> Posts02 { get; } = new List<Post0088>();
+    public ICollection<Post0088> Posts03 { get; } = new List<Post0088>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Blog0089
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0089> Tags { get; set; }
+
+    public ICollection<Post0089> Posts00 { get; } = new List<Post0089>();
+    public ICollection<Post0089> Posts01 { get; } = new List<Post0089>();
+    public ICollection<Post0089> Posts02 { get; } = new List<Post0089>();
+    public ICollection<Post0089> Posts03 { get; } = new List<Post0089>();
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/CompiledModels/BlogsContext.cs b/samples/core/Miscellaneous/CompiledModels/BlogsContext.cs
new file mode 100644
index 0000000000..2f4b075424
--- /dev/null
+++ b/samples/core/Miscellaneous/CompiledModels/BlogsContext.cs
@@ -0,0 +1,476 @@
+using System;
+using System.IO;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+
+namespace CompiledModelTest;
+
+public class BlogsContext : DbContext
+{
+
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        var currentDirectory = Environment.CurrentDirectory;
+        var location = currentDirectory.Substring(
+            0, currentDirectory.IndexOf("CompiledModels", StringComparison.Ordinal) + "CompiledModels".Length);
+
+        optionsBuilder
+            //.UseModel(MyCompiledModels.BlogsContextModel.Instance)
+            .EnableServiceProviderCaching(false)
+            .UseSqlite(@$"Data Source={Path.Combine(location, "compiled_model.db")}");
+    }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog0000>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0000>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0000>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0000>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0001>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0001>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0001>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0001>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0002>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0002>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0002>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0002>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0003>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0003>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0003>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0003>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0004>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0004>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0004>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0004>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0005>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0005>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0005>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0005>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0006>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0006>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0006>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0006>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0007>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0007>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0007>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0007>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0008>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0008>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0008>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0008>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0009>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0009>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0009>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0009>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0010>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0010>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0010>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0010>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0011>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0011>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0011>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0011>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0012>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0012>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0012>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0012>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0013>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0013>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0013>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0013>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0014>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0014>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0014>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0014>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0015>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0015>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0015>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0015>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0016>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0016>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0016>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0016>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0017>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0017>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0017>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0017>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0018>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0018>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0018>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0018>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0019>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0019>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0019>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0019>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0020>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0020>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0020>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0020>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0021>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0021>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0021>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0021>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0022>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0022>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0022>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0022>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0023>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0023>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0023>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0023>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0024>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0024>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0024>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0024>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0025>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0025>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0025>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0025>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0026>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0026>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0026>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0026>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0027>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0027>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0027>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0027>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0028>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0028>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0028>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0028>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0029>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0029>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0029>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0029>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0030>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0030>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0030>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0030>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0031>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0031>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0031>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0031>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0032>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0032>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0032>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0032>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0033>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0033>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0033>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0033>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0034>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0034>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0034>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0034>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0035>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0035>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0035>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0035>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0036>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0036>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0036>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0036>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0037>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0037>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0037>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0037>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0038>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0038>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0038>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0038>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0039>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0039>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0039>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0039>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0040>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0040>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0040>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0040>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0041>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0041>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0041>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0041>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0042>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0042>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0042>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0042>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0043>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0043>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0043>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0043>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0044>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0044>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0044>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0044>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0045>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0045>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0045>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0045>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0046>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0046>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0046>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0046>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0047>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0047>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0047>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0047>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0048>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0048>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0048>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0048>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0049>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0049>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0049>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0049>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0050>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0050>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0050>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0050>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0051>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0051>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0051>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0051>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0052>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0052>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0052>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0052>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0053>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0053>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0053>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0053>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0054>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0054>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0054>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0054>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0055>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0055>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0055>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0055>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0056>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0056>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0056>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0056>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0057>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0057>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0057>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0057>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0058>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0058>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0058>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0058>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0059>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0059>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0059>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0059>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0060>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0060>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0060>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0060>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0061>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0061>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0061>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0061>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0062>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0062>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0062>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0062>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0063>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0063>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0063>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0063>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0064>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0064>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0064>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0064>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0065>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0065>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0065>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0065>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0066>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0066>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0066>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0066>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0067>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0067>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0067>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0067>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0068>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0068>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0068>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0068>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0069>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0069>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0069>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0069>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0070>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0070>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0070>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0070>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0071>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0071>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0071>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0071>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0072>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0072>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0072>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0072>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0073>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0073>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0073>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0073>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0074>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0074>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0074>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0074>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0075>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0075>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0075>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0075>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0076>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0076>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0076>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0076>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0077>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0077>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0077>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0077>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0078>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0078>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0078>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0078>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0079>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0079>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0079>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0079>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0080>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0080>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0080>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0080>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0081>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0081>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0081>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0081>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0082>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0082>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0082>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0082>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0083>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0083>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0083>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0083>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0084>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0084>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0084>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0084>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0085>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0085>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0085>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0085>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0086>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0086>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0086>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0086>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0087>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0087>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0087>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0087>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0088>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0088>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0088>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0088>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+
+        modelBuilder.Entity<Blog0089>().HasMany(e => e.Posts00).WithOne(e => e.Blog00);
+        modelBuilder.Entity<Blog0089>().HasMany(e => e.Posts01).WithOne(e => e.Blog01);
+        modelBuilder.Entity<Blog0089>().HasMany(e => e.Posts02).WithOne(e => e.Blog02);
+        modelBuilder.Entity<Blog0089>().HasMany(e => e.Posts03).WithOne(e => e.Blog03);
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/CompiledModels/CompiledModels.csproj b/samples/core/Miscellaneous/CompiledModels/CompiledModels.csproj
new file mode 100644
index 0000000000..6f575a50a2
--- /dev/null
+++ b/samples/core/Miscellaneous/CompiledModels/CompiledModels.csproj
@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <TargetFramework>net10.0</TargetFramework>
+        <RootNamespace />
+    </PropertyGroup>
+
+    <ItemGroup>
+        <PackageReference Include="BenchmarkDotNet" Version="0.13.2" />
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.0" />
+    </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/CompiledModels/MultipleRuntimeModels.cs b/samples/core/Miscellaneous/CompiledModels/MultipleRuntimeModels.cs
new file mode 100644
index 0000000000..c4d1a098f5
--- /dev/null
+++ b/samples/core/Miscellaneous/CompiledModels/MultipleRuntimeModels.cs
@@ -0,0 +1,83 @@
+using System;
+using System.Collections.Concurrent;
+using CompiledModelTest;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+
+#pragma warning disable 219, 612, 618
+#nullable disable
+
+namespace MultipleRuntimeModels;
+
+#region RuntimeModelCache
+public static class RuntimeModelCache
+{
+    private static readonly ConcurrentDictionary<string, IModel> _runtimeModels
+        = new();
+
+    public static IModel GetOrCreateModel(string connectionString)
+        => _runtimeModels.GetOrAdd(
+            connectionString, cs =>
+            {
+                if (cs.Contains("X"))
+                {
+                    return BlogsContextModel1.Instance;
+                }
+
+                if (cs.Contains("Y"))
+                {
+                    return BlogsContextModel2.Instance;
+                }
+
+                throw new InvalidOperationException("No appropriate compiled model found.");
+            });
+}
+#endregion
+
+[DbContext(typeof(BlogsContext))]
+partial class BlogsContextModel1 : RuntimeModel
+{
+    private static BlogsContextModel1 _instance;
+    public static IModel Instance
+    {
+        get
+        {
+            if (_instance == null)
+            {
+                _instance = new BlogsContextModel1();
+                _instance.Initialize();
+                _instance.Customize();
+            }
+
+            return _instance;
+        }
+    }
+
+    partial void Initialize();
+
+    partial void Customize();
+}
+    
+[DbContext(typeof(BlogsContext))]
+partial class BlogsContextModel2 : RuntimeModel
+{
+    private static BlogsContextModel2 _instance;
+    public static IModel Instance
+    {
+        get
+        {
+            if (_instance == null)
+            {
+                _instance = new BlogsContextModel2();
+                _instance.Initialize();
+                _instance.Customize();
+            }
+
+            return _instance;
+        }
+    }
+
+    partial void Initialize();
+
+    partial void Customize();
+}
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/CompiledModels/Post000.cs b/samples/core/Miscellaneous/CompiledModels/Post000.cs
new file mode 100644
index 0000000000..2db6b025a0
--- /dev/null
+++ b/samples/core/Miscellaneous/CompiledModels/Post000.cs
@@ -0,0 +1,4685 @@
+using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations;
+using Microsoft.EntityFrameworkCore;
+
+namespace CompiledModelTest;
+
+public class Post0000
+{
+    public int Id { get; set; }
+        
+    public ICollection<Tag0000> Tags { get; set; }
+
+    public Blog0000 Blog00 { get; set; }
+    public Blog0000 Blog01 { get; set; }
+    public Blog0000 Blog02 { get; set; }
+    public Blog0000 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0001
+{
+    public int Id { get; set; }
+        
+    public ICollection<Tag0001> Tags { get; set; }
+
+    public Blog0001 Blog00 { get; set; }
+    public Blog0001 Blog01 { get; set; }
+    public Blog0001 Blog02 { get; set; }
+    public Blog0001 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0002
+{
+    public int Id { get; set; }
+        
+    public ICollection<Tag0002> Tags { get; set; }
+
+    public Blog0002 Blog00 { get; set; }
+    public Blog0002 Blog01 { get; set; }
+    public Blog0002 Blog02 { get; set; }
+    public Blog0002 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0003
+{
+    public int Id { get; set; }
+        
+    public ICollection<Tag0003> Tags { get; set; }
+
+    public Blog0003 Blog00 { get; set; }
+    public Blog0003 Blog01 { get; set; }
+    public Blog0003 Blog02 { get; set; }
+    public Blog0003 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0004
+{
+    public int Id { get; set; }
+        
+    public ICollection<Tag0004> Tags { get; set; }
+
+    public Blog0004 Blog00 { get; set; }
+    public Blog0004 Blog01 { get; set; }
+    public Blog0004 Blog02 { get; set; }
+    public Blog0004 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0005
+{
+    public int Id { get; set; }
+        
+    public ICollection<Tag0005> Tags { get; set; }
+
+    public Blog0005 Blog00 { get; set; }
+    public Blog0005 Blog01 { get; set; }
+    public Blog0005 Blog02 { get; set; }
+    public Blog0005 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0006
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0006> Tags { get; set; }
+        
+    public Blog0006 Blog00 { get; set; }
+    public Blog0006 Blog01 { get; set; }
+    public Blog0006 Blog02 { get; set; }
+    public Blog0006 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0007
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0007> Tags { get; set; }
+
+    public Blog0007 Blog00 { get; set; }
+    public Blog0007 Blog01 { get; set; }
+    public Blog0007 Blog02 { get; set; }
+    public Blog0007 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0008
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0008> Tags { get; set; }
+
+    public Blog0008 Blog00 { get; set; }
+    public Blog0008 Blog01 { get; set; }
+    public Blog0008 Blog02 { get; set; }
+    public Blog0008 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0009
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0009> Tags { get; set; }
+
+    public Blog0009 Blog00 { get; set; }
+    public Blog0009 Blog01 { get; set; }
+    public Blog0009 Blog02 { get; set; }
+    public Blog0009 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0010
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0010> Tags { get; set; }
+
+    public Blog0010 Blog00 { get; set; }
+    public Blog0010 Blog01 { get; set; }
+    public Blog0010 Blog02 { get; set; }
+    public Blog0010 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0011
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0011> Tags { get; set; }
+
+    public Blog0011 Blog00 { get; set; }
+    public Blog0011 Blog01 { get; set; }
+    public Blog0011 Blog02 { get; set; }
+    public Blog0011 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0012
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0012> Tags { get; set; }
+
+    public Blog0012 Blog00 { get; set; }
+    public Blog0012 Blog01 { get; set; }
+    public Blog0012 Blog02 { get; set; }
+    public Blog0012 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0013
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0013> Tags { get; set; }
+
+    public Blog0013 Blog00 { get; set; }
+    public Blog0013 Blog01 { get; set; }
+    public Blog0013 Blog02 { get; set; }
+    public Blog0013 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0014
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0014> Tags { get; set; }
+
+    public Blog0014 Blog00 { get; set; }
+    public Blog0014 Blog01 { get; set; }
+    public Blog0014 Blog02 { get; set; }
+    public Blog0014 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0015
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0015> Tags { get; set; }
+
+    public Blog0015 Blog00 { get; set; }
+    public Blog0015 Blog01 { get; set; }
+    public Blog0015 Blog02 { get; set; }
+    public Blog0015 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0016
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0016> Tags { get; set; }
+
+    public Blog0016 Blog00 { get; set; }
+    public Blog0016 Blog01 { get; set; }
+    public Blog0016 Blog02 { get; set; }
+    public Blog0016 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0017
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0017> Tags { get; set; }
+
+    public Blog0017 Blog00 { get; set; }
+    public Blog0017 Blog01 { get; set; }
+    public Blog0017 Blog02 { get; set; }
+    public Blog0017 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0018
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0018> Tags { get; set; }
+
+    public Blog0018 Blog00 { get; set; }
+    public Blog0018 Blog01 { get; set; }
+    public Blog0018 Blog02 { get; set; }
+    public Blog0018 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0019
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0019> Tags { get; set; }
+
+    public Blog0019 Blog00 { get; set; }
+    public Blog0019 Blog01 { get; set; }
+    public Blog0019 Blog02 { get; set; }
+    public Blog0019 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0020
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0020> Tags { get; set; }
+
+    public Blog0020 Blog00 { get; set; }
+    public Blog0020 Blog01 { get; set; }
+    public Blog0020 Blog02 { get; set; }
+    public Blog0020 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0021
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0021> Tags { get; set; }
+
+    public Blog0021 Blog00 { get; set; }
+    public Blog0021 Blog01 { get; set; }
+    public Blog0021 Blog02 { get; set; }
+    public Blog0021 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0022
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0022> Tags { get; set; }
+
+    public Blog0022 Blog00 { get; set; }
+    public Blog0022 Blog01 { get; set; }
+    public Blog0022 Blog02 { get; set; }
+    public Blog0022 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0023
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0023> Tags { get; set; }
+
+    public Blog0023 Blog00 { get; set; }
+    public Blog0023 Blog01 { get; set; }
+    public Blog0023 Blog02 { get; set; }
+    public Blog0023 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0024
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0024> Tags { get; set; }
+
+    public Blog0024 Blog00 { get; set; }
+    public Blog0024 Blog01 { get; set; }
+    public Blog0024 Blog02 { get; set; }
+    public Blog0024 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0025
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0025> Tags { get; set; }
+
+    public Blog0025 Blog00 { get; set; }
+    public Blog0025 Blog01 { get; set; }
+    public Blog0025 Blog02 { get; set; }
+    public Blog0025 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0026
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0026> Tags { get; set; }
+
+    public Blog0026 Blog00 { get; set; }
+    public Blog0026 Blog01 { get; set; }
+    public Blog0026 Blog02 { get; set; }
+    public Blog0026 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0027
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0027> Tags { get; set; }
+
+    public Blog0027 Blog00 { get; set; }
+    public Blog0027 Blog01 { get; set; }
+    public Blog0027 Blog02 { get; set; }
+    public Blog0027 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0028
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0028> Tags { get; set; }
+
+    public Blog0028 Blog00 { get; set; }
+    public Blog0028 Blog01 { get; set; }
+    public Blog0028 Blog02 { get; set; }
+    public Blog0028 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0029
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0029> Tags { get; set; }
+
+    public Blog0029 Blog00 { get; set; }
+    public Blog0029 Blog01 { get; set; }
+    public Blog0029 Blog02 { get; set; }
+    public Blog0029 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0030
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0030> Tags { get; set; }
+
+    public Blog0030 Blog00 { get; set; }
+    public Blog0030 Blog01 { get; set; }
+    public Blog0030 Blog02 { get; set; }
+    public Blog0030 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0031
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0031> Tags { get; set; }
+
+    public Blog0031 Blog00 { get; set; }
+    public Blog0031 Blog01 { get; set; }
+    public Blog0031 Blog02 { get; set; }
+    public Blog0031 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0032
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0032> Tags { get; set; }
+
+    public Blog0032 Blog00 { get; set; }
+    public Blog0032 Blog01 { get; set; }
+    public Blog0032 Blog02 { get; set; }
+    public Blog0032 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0033
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0033> Tags { get; set; }
+
+    public Blog0033 Blog00 { get; set; }
+    public Blog0033 Blog01 { get; set; }
+    public Blog0033 Blog02 { get; set; }
+    public Blog0033 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0034
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0034> Tags { get; set; }
+
+    public Blog0034 Blog00 { get; set; }
+    public Blog0034 Blog01 { get; set; }
+    public Blog0034 Blog02 { get; set; }
+    public Blog0034 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0035
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0035> Tags { get; set; }
+
+    public Blog0035 Blog00 { get; set; }
+    public Blog0035 Blog01 { get; set; }
+    public Blog0035 Blog02 { get; set; }
+    public Blog0035 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0036
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0036> Tags { get; set; }
+
+    public Blog0036 Blog00 { get; set; }
+    public Blog0036 Blog01 { get; set; }
+    public Blog0036 Blog02 { get; set; }
+    public Blog0036 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0037
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0037> Tags { get; set; }
+
+    public Blog0037 Blog00 { get; set; }
+    public Blog0037 Blog01 { get; set; }
+    public Blog0037 Blog02 { get; set; }
+    public Blog0037 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0038
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0038> Tags { get; set; }
+
+    public Blog0038 Blog00 { get; set; }
+    public Blog0038 Blog01 { get; set; }
+    public Blog0038 Blog02 { get; set; }
+    public Blog0038 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0039
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0039> Tags { get; set; }
+
+    public Blog0039 Blog00 { get; set; }
+    public Blog0039 Blog01 { get; set; }
+    public Blog0039 Blog02 { get; set; }
+    public Blog0039 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0040
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0040> Tags { get; set; }
+
+    public Blog0040 Blog00 { get; set; }
+    public Blog0040 Blog01 { get; set; }
+    public Blog0040 Blog02 { get; set; }
+    public Blog0040 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0041
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0041> Tags { get; set; }
+
+    public Blog0041 Blog00 { get; set; }
+    public Blog0041 Blog01 { get; set; }
+    public Blog0041 Blog02 { get; set; }
+    public Blog0041 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0042
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0042> Tags { get; set; }
+
+    public Blog0042 Blog00 { get; set; }
+    public Blog0042 Blog01 { get; set; }
+    public Blog0042 Blog02 { get; set; }
+    public Blog0042 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0043
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0043> Tags { get; set; }
+
+    public Blog0043 Blog00 { get; set; }
+    public Blog0043 Blog01 { get; set; }
+    public Blog0043 Blog02 { get; set; }
+    public Blog0043 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0044
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0044> Tags { get; set; }
+
+    public Blog0044 Blog00 { get; set; }
+    public Blog0044 Blog01 { get; set; }
+    public Blog0044 Blog02 { get; set; }
+    public Blog0044 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0045
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0045> Tags { get; set; }
+
+    public Blog0045 Blog00 { get; set; }
+    public Blog0045 Blog01 { get; set; }
+    public Blog0045 Blog02 { get; set; }
+    public Blog0045 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0046
+{
+    public int Id { get; set; }
+
+    public Blog0046 Blog00 { get; set; }
+    public Blog0046 Blog01 { get; set; }
+    public Blog0046 Blog02 { get; set; }
+    public Blog0046 Blog03 { get; set; }
+
+    public ICollection<Tag0046> Tags { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0047
+{
+    public int Id { get; set; }
+
+    public Blog0047 Blog00 { get; set; }
+    public Blog0047 Blog01 { get; set; }
+    public Blog0047 Blog02 { get; set; }
+    public Blog0047 Blog03 { get; set; }
+
+    public ICollection<Tag0047> Tags { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0048
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0048> Tags { get; set; }
+
+    public Blog0048 Blog00 { get; set; }
+    public Blog0048 Blog01 { get; set; }
+    public Blog0048 Blog02 { get; set; }
+    public Blog0048 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0049
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0049> Tags { get; set; }
+
+    public Blog0049 Blog00 { get; set; }
+    public Blog0049 Blog01 { get; set; }
+    public Blog0049 Blog02 { get; set; }
+    public Blog0049 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0050
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0050> Tags { get; set; }
+
+    public Blog0050 Blog00 { get; set; }
+    public Blog0050 Blog01 { get; set; }
+    public Blog0050 Blog02 { get; set; }
+    public Blog0050 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0051
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0051> Tags { get; set; }
+
+    public Blog0051 Blog00 { get; set; }
+    public Blog0051 Blog01 { get; set; }
+    public Blog0051 Blog02 { get; set; }
+    public Blog0051 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0052
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0052> Tags { get; set; }
+
+    public Blog0052 Blog00 { get; set; }
+    public Blog0052 Blog01 { get; set; }
+    public Blog0052 Blog02 { get; set; }
+    public Blog0052 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0053
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0053> Tags { get; set; }
+
+    public Blog0053 Blog00 { get; set; }
+    public Blog0053 Blog01 { get; set; }
+    public Blog0053 Blog02 { get; set; }
+    public Blog0053 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0054
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0054> Tags { get; set; }
+
+    public Blog0054 Blog00 { get; set; }
+    public Blog0054 Blog01 { get; set; }
+    public Blog0054 Blog02 { get; set; }
+    public Blog0054 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0055
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0055> Tags { get; set; }
+
+    public Blog0055 Blog00 { get; set; }
+    public Blog0055 Blog01 { get; set; }
+    public Blog0055 Blog02 { get; set; }
+    public Blog0055 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0056
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0056> Tags { get; set; }
+
+    public Blog0056 Blog00 { get; set; }
+    public Blog0056 Blog01 { get; set; }
+    public Blog0056 Blog02 { get; set; }
+    public Blog0056 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0057
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0057> Tags { get; set; }
+
+    public Blog0057 Blog00 { get; set; }
+    public Blog0057 Blog01 { get; set; }
+    public Blog0057 Blog02 { get; set; }
+    public Blog0057 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0058
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0058> Tags { get; set; }
+
+    public Blog0058 Blog00 { get; set; }
+    public Blog0058 Blog01 { get; set; }
+    public Blog0058 Blog02 { get; set; }
+    public Blog0058 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0059
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0059> Tags { get; set; }
+
+    public Blog0059 Blog00 { get; set; }
+    public Blog0059 Blog01 { get; set; }
+    public Blog0059 Blog02 { get; set; }
+    public Blog0059 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0060
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0060> Tags { get; set; }
+
+    public Blog0060 Blog00 { get; set; }
+    public Blog0060 Blog01 { get; set; }
+    public Blog0060 Blog02 { get; set; }
+    public Blog0060 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0061
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0061> Tags { get; set; }
+
+    public Blog0061 Blog00 { get; set; }
+    public Blog0061 Blog01 { get; set; }
+    public Blog0061 Blog02 { get; set; }
+    public Blog0061 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0062
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0062> Tags { get; set; }
+
+    public Blog0062 Blog00 { get; set; }
+    public Blog0062 Blog01 { get; set; }
+    public Blog0062 Blog02 { get; set; }
+    public Blog0062 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0063
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0063> Tags { get; set; }
+
+    public Blog0063 Blog00 { get; set; }
+    public Blog0063 Blog01 { get; set; }
+    public Blog0063 Blog02 { get; set; }
+    public Blog0063 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0064
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0064> Tags { get; set; }
+
+    public Blog0064 Blog00 { get; set; }
+    public Blog0064 Blog01 { get; set; }
+    public Blog0064 Blog02 { get; set; }
+    public Blog0064 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0065
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0065> Tags { get; set; }
+
+    public Blog0065 Blog00 { get; set; }
+    public Blog0065 Blog01 { get; set; }
+    public Blog0065 Blog02 { get; set; }
+    public Blog0065 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0066
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0066> Tags { get; set; }
+
+    public Blog0066 Blog00 { get; set; }
+    public Blog0066 Blog01 { get; set; }
+    public Blog0066 Blog02 { get; set; }
+    public Blog0066 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0067
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0067> Tags { get; set; }
+
+    public Blog0067 Blog00 { get; set; }
+    public Blog0067 Blog01 { get; set; }
+    public Blog0067 Blog02 { get; set; }
+    public Blog0067 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0068
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0068> Tags { get; set; }
+
+    public Blog0068 Blog00 { get; set; }
+    public Blog0068 Blog01 { get; set; }
+    public Blog0068 Blog02 { get; set; }
+    public Blog0068 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0069
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0069> Tags { get; set; }
+
+    public Blog0069 Blog00 { get; set; }
+    public Blog0069 Blog01 { get; set; }
+    public Blog0069 Blog02 { get; set; }
+    public Blog0069 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0070
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0070> Tags { get; set; }
+
+    public Blog0070 Blog00 { get; set; }
+    public Blog0070 Blog01 { get; set; }
+    public Blog0070 Blog02 { get; set; }
+    public Blog0070 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0071
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0071> Tags { get; set; }
+
+    public Blog0071 Blog00 { get; set; }
+    public Blog0071 Blog01 { get; set; }
+    public Blog0071 Blog02 { get; set; }
+    public Blog0071 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0072
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0072> Tags { get; set; }
+
+    public Blog0072 Blog00 { get; set; }
+    public Blog0072 Blog01 { get; set; }
+    public Blog0072 Blog02 { get; set; }
+    public Blog0072 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0073
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0073> Tags { get; set; }
+
+    public Blog0073 Blog00 { get; set; }
+    public Blog0073 Blog01 { get; set; }
+    public Blog0073 Blog02 { get; set; }
+    public Blog0073 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0074
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0074> Tags { get; set; }
+
+    public Blog0074 Blog00 { get; set; }
+    public Blog0074 Blog01 { get; set; }
+    public Blog0074 Blog02 { get; set; }
+    public Blog0074 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0075
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0075> Tags { get; set; }
+
+    public Blog0075 Blog00 { get; set; }
+    public Blog0075 Blog01 { get; set; }
+    public Blog0075 Blog02 { get; set; }
+    public Blog0075 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0076
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0076> Tags { get; set; }
+
+    public Blog0076 Blog00 { get; set; }
+    public Blog0076 Blog01 { get; set; }
+    public Blog0076 Blog02 { get; set; }
+    public Blog0076 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0077
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0077> Tags { get; set; }
+
+    public Blog0077 Blog00 { get; set; }
+    public Blog0077 Blog01 { get; set; }
+    public Blog0077 Blog02 { get; set; }
+    public Blog0077 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0078
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0078> Tags { get; set; }
+
+    public Blog0078 Blog00 { get; set; }
+    public Blog0078 Blog01 { get; set; }
+    public Blog0078 Blog02 { get; set; }
+    public Blog0078 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0079
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0079> Tags { get; set; }
+
+    public Blog0079 Blog00 { get; set; }
+    public Blog0079 Blog01 { get; set; }
+    public Blog0079 Blog02 { get; set; }
+    public Blog0079 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0080
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0080> Tags { get; set; }
+
+    public Blog0080 Blog00 { get; set; }
+    public Blog0080 Blog01 { get; set; }
+    public Blog0080 Blog02 { get; set; }
+    public Blog0080 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0081
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0081> Tags { get; set; }
+
+    public Blog0081 Blog00 { get; set; }
+    public Blog0081 Blog01 { get; set; }
+    public Blog0081 Blog02 { get; set; }
+    public Blog0081 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0082
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0082> Tags { get; set; }
+
+    public Blog0082 Blog00 { get; set; }
+    public Blog0082 Blog01 { get; set; }
+    public Blog0082 Blog02 { get; set; }
+    public Blog0082 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0083
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0083> Tags { get; set; }
+
+    public Blog0083 Blog00 { get; set; }
+    public Blog0083 Blog01 { get; set; }
+    public Blog0083 Blog02 { get; set; }
+    public Blog0083 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0084
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0084> Tags { get; set; }
+
+    public Blog0084 Blog00 { get; set; }
+    public Blog0084 Blog01 { get; set; }
+    public Blog0084 Blog02 { get; set; }
+    public Blog0084 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0085
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0085> Tags { get; set; }
+
+    public Blog0085 Blog00 { get; set; }
+    public Blog0085 Blog01 { get; set; }
+    public Blog0085 Blog02 { get; set; }
+    public Blog0085 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0086
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0086> Tags { get; set; }
+
+    public Blog0086 Blog00 { get; set; }
+    public Blog0086 Blog01 { get; set; }
+    public Blog0086 Blog02 { get; set; }
+    public Blog0086 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0087
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0087> Tags { get; set; }
+
+    public Blog0087 Blog00 { get; set; }
+    public Blog0087 Blog01 { get; set; }
+    public Blog0087 Blog02 { get; set; }
+    public Blog0087 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0088
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0088> Tags { get; set; }
+
+    public Blog0088 Blog00 { get; set; }
+    public Blog0088 Blog01 { get; set; }
+    public Blog0088 Blog02 { get; set; }
+    public Blog0088 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+
+public class Post0089
+{
+    public int Id { get; set; }
+
+    public ICollection<Tag0089> Tags { get; set; }
+
+    public Blog0089 Blog00 { get; set; }
+    public Blog0089 Blog01 { get; set; }
+    public Blog0089 Blog02 { get; set; }
+    public Blog0089 Blog03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/CompiledModels/Program.cs b/samples/core/Miscellaneous/CompiledModels/Program.cs
new file mode 100644
index 0000000000..08a6c80975
--- /dev/null
+++ b/samples/core/Miscellaneous/CompiledModels/Program.cs
@@ -0,0 +1,28 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using BenchmarkDotNet.Running;
+using CompiledModelTest;
+
+public class Program
+{
+    public static async Task Main(string[] args)
+    {
+        await PrintSomeStuff();
+        BenchmarkRunner.Run<Test>();
+    }
+
+    public static async Task PrintSomeStuff()
+    {
+        using var context = new BlogsContext();
+        var model = context.Model;
+
+        Console.WriteLine("Model has:");
+        Console.WriteLine($"  {model.GetEntityTypes().Count()} entity types");
+        Console.WriteLine($"  {model.GetEntityTypes().SelectMany(e => e.GetProperties()).Count()} properties");
+        Console.WriteLine($"  {model.GetEntityTypes().SelectMany(e => e.GetForeignKeys()).Count()} relationships");
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+}
diff --git a/samples/core/Miscellaneous/CompiledModels/README.md b/samples/core/Miscellaneous/CompiledModels/README.md
new file mode 100644
index 0000000000..47a35198a1
--- /dev/null
+++ b/samples/core/Miscellaneous/CompiledModels/README.md
@@ -0,0 +1,24 @@
+# CompiledModelsDemo
+
+1. Run the benchmark
+2. Compile a model - `dotnet ef dbcontext optimize --output-dir MyCompiledModels --namespace MyCompiledModels`
+3. Update OnConfiguring to use the compiled model
+4. Comment out the caching in `BlogsContextModel` as shown below.
+5. Run benchmark again
+
+```csharp
+public static IModel Instance
+{
+    get
+    {
+        //if (_instance == null)
+        {
+            _instance = new BlogsContextModel();
+            _instance.Initialize();
+            _instance.Customize();
+        }
+
+        return _instance;
+    }
+}
+```
diff --git a/samples/core/Miscellaneous/CompiledModels/SingleRuntimeModel.cs b/samples/core/Miscellaneous/CompiledModels/SingleRuntimeModel.cs
new file mode 100644
index 0000000000..2087d6d142
--- /dev/null
+++ b/samples/core/Miscellaneous/CompiledModels/SingleRuntimeModel.cs
@@ -0,0 +1,34 @@
+using CompiledModelTest;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+
+#pragma warning disable 219, 612, 618
+#nullable disable
+
+namespace SingleRuntimeModel;
+
+#region RuntimeModel
+[DbContext(typeof(BlogsContext))]
+partial class BlogsContextModel : RuntimeModel
+{
+    private static BlogsContextModel _instance;
+    public static IModel Instance
+    {
+        get
+        {
+            if (_instance == null)
+            {
+                _instance = new BlogsContextModel();
+                _instance.Initialize();
+                _instance.Customize();
+            }
+
+            return _instance;
+        }
+    }
+
+    partial void Initialize();
+
+    partial void Customize();
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/CompiledModels/Tag0000.cs b/samples/core/Miscellaneous/CompiledModels/Tag0000.cs
new file mode 100644
index 0000000000..6869dd7f2d
--- /dev/null
+++ b/samples/core/Miscellaneous/CompiledModels/Tag0000.cs
@@ -0,0 +1,4324 @@
+using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations;
+
+namespace CompiledModelTest;
+
+public class Tag0000
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0000> Posts { get; set; }
+    public ICollection<Blog0000> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0001
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0001> Posts { get; set; }
+    public ICollection<Blog0001> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0002
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0002> Posts { get; set; }
+    public ICollection<Blog0002> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0003
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0003> Posts { get; set; }
+    public ICollection<Blog0003> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0004
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0004> Posts { get; set; }
+    public ICollection<Blog0004> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0005
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0005> Posts { get; set; }
+    public ICollection<Blog0005> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0006
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0006> Posts { get; set; }
+    public ICollection<Blog0006> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0007
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0007> Posts { get; set; }
+    public ICollection<Blog0007> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0008
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0008> Posts { get; set; }
+    public ICollection<Blog0008> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0009
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0009> Posts { get; set; }
+    public ICollection<Blog0009> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0010
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0010> Posts { get; set; }
+    public ICollection<Blog0010> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0011
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0011> Posts { get; set; }
+    public ICollection<Blog0011> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0012
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0012> Posts { get; set; }
+    public ICollection<Blog0012> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0013
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0013> Posts { get; set; }
+    public ICollection<Blog0013> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0014
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0014> Posts { get; set; }
+    public ICollection<Blog0014> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0015
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0015> Posts { get; set; }
+    public ICollection<Blog0015> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0016
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0016> Posts { get; set; }
+    public ICollection<Blog0016> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0017
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0017> Posts { get; set; }
+    public ICollection<Blog0017> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0018
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0018> Posts { get; set; }
+    public ICollection<Blog0018> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0019
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0019> Posts { get; set; }
+    public ICollection<Blog0019> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0020
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0020> Posts { get; set; }
+    public ICollection<Blog0020> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0021
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0021> Posts { get; set; }
+    public ICollection<Blog0021> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0022
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0022> Posts { get; set; }
+    public ICollection<Blog0022> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0023
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0023> Posts { get; set; }
+    public ICollection<Blog0023> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0024
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0024> Posts { get; set; }
+    public ICollection<Blog0024> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0025
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0025> Posts { get; set; }
+    public ICollection<Blog0025> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0026
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0026> Posts { get; set; }
+    public ICollection<Blog0026> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0027
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0027> Posts { get; set; }
+    public ICollection<Blog0027> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0028
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0028> Posts { get; set; }
+    public ICollection<Blog0028> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0029
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0029> Posts { get; set; }
+    public ICollection<Blog0029> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0030
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0030> Posts { get; set; }
+    public ICollection<Blog0030> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0031
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0031> Posts { get; set; }
+    public ICollection<Blog0031> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0032
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0032> Posts { get; set; }
+    public ICollection<Blog0032> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0033
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0033> Posts { get; set; }
+    public ICollection<Blog0033> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0034
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0034> Posts { get; set; }
+    public ICollection<Blog0034> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0035
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0035> Posts { get; set; }
+    public ICollection<Blog0035> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0036
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0036> Posts { get; set; }
+    public ICollection<Blog0036> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0037
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0037> Posts { get; set; }
+    public ICollection<Blog0037> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0038
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0038> Posts { get; set; }
+    public ICollection<Blog0038> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0039
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0039> Posts { get; set; }
+    public ICollection<Blog0039> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0040
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0040> Posts { get; set; }
+    public ICollection<Blog0040> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0041
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0041> Posts { get; set; }
+    public ICollection<Blog0041> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0042
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0042> Posts { get; set; }
+    public ICollection<Blog0042> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0043
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0043> Posts { get; set; }
+    public ICollection<Blog0043> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0044
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0044> Posts { get; set; }
+    public ICollection<Blog0044> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0045
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0045> Posts { get; set; }
+    public ICollection<Blog0045> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0046
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0046> Posts { get; set; }
+    public ICollection<Blog0046> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0047
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0047> Posts { get; set; }
+    public ICollection<Blog0047> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0048
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0048> Posts { get; set; }
+    public ICollection<Blog0048> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0049
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0049> Posts { get; set; }
+    public ICollection<Blog0039> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0050
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0050> Posts { get; set; }
+    public ICollection<Blog0050> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0051
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0051> Posts { get; set; }
+    public ICollection<Blog0051> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0052
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0052> Posts { get; set; }
+    public ICollection<Blog0052> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0053
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0053> Posts { get; set; }
+    public ICollection<Blog0053> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0054
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0054> Posts { get; set; }
+    public ICollection<Blog0054> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0055
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0055> Posts { get; set; }
+    public ICollection<Blog0055> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0056
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0056> Posts { get; set; }
+    public ICollection<Blog0056> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0057
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0057> Posts { get; set; }
+    public ICollection<Blog0057> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0058
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0058> Posts { get; set; }
+    public ICollection<Blog0058> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0059
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0059> Posts { get; set; }
+    public ICollection<Blog0059> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0060
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0060> Posts { get; set; }
+    public ICollection<Blog0060> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0061
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0061> Posts { get; set; }
+    public ICollection<Blog0061> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0062
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0062> Posts { get; set; }
+    public ICollection<Blog0062> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0063
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0063> Posts { get; set; }
+    public ICollection<Blog0063> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0064
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0064> Posts { get; set; }
+    public ICollection<Blog0064> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0065
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0065> Posts { get; set; }
+    public ICollection<Blog0065> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0066
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0066> Posts { get; set; }
+    public ICollection<Blog0066> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0067
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0067> Posts { get; set; }
+    public ICollection<Blog0067> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0068
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0068> Posts { get; set; }
+    public ICollection<Blog0068> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0069
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0069> Posts { get; set; }
+    public ICollection<Blog0069> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0070
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0070> Posts { get; set; }
+    public ICollection<Blog0070> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0071
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0071> Posts { get; set; }
+    public ICollection<Blog0071> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0072
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0072> Posts { get; set; }
+    public ICollection<Blog0072> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0073
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0073> Posts { get; set; }
+    public ICollection<Blog0073> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0074
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0074> Posts { get; set; }
+    public ICollection<Blog0074> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0075
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0075> Posts { get; set; }
+    public ICollection<Blog0075> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0076
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0076> Posts { get; set; }
+    public ICollection<Blog0076> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0077
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0077> Posts { get; set; }
+    public ICollection<Blog0077> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0078
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0078> Posts { get; set; }
+    public ICollection<Blog0078> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0079
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0079> Posts { get; set; }
+    public ICollection<Blog0079> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0080
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0080> Posts { get; set; }
+    public ICollection<Blog0080> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0081
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0081> Posts { get; set; }
+    public ICollection<Blog0081> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0082
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0082> Posts { get; set; }
+    public ICollection<Blog0082> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0083
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0083> Posts { get; set; }
+    public ICollection<Blog0083> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0084
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0084> Posts { get; set; }
+    public ICollection<Blog0084> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0085
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0085> Posts { get; set; }
+    public ICollection<Blog0085> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0086
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0086> Posts { get; set; }
+    public ICollection<Blog0086> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0087
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0087> Posts { get; set; }
+    public ICollection<Blog0087> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0088
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0088> Posts { get; set; }
+    public ICollection<Blog0088> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
+    
+public class Tag0089
+{
+    public int Id { get; set; }
+        
+    public ICollection<Post0089> Posts { get; set; }
+    public ICollection<Blog0089> Blogs { get; set; }
+        
+    [Required] [StringLength(64)] public string Property00 { get; set; }
+
+    [Required] [StringLength(64)] public string Property01 { get; set; }
+
+    [Required] [StringLength(64)] public string Property02 { get; set; }
+
+    [Required] [StringLength(64)] public string Property03 { get; set; }
+
+    [Required] [StringLength(64)] public string Property04 { get; set; }
+
+    [Required] [StringLength(64)] public string Property05 { get; set; }
+
+    [Required] [StringLength(64)] public string Property06 { get; set; }
+
+    [Required] [StringLength(64)] public string Property07 { get; set; }
+
+    [Required] [StringLength(64)] public string Property08 { get; set; }
+
+    [Required] [StringLength(64)] public string Property09 { get; set; }
+
+    [Required] [StringLength(64)] public string Property10 { get; set; }
+
+    [Required] [StringLength(64)] public string Property11 { get; set; }
+
+    [Required] [StringLength(64)] public string Property12 { get; set; }
+
+    [Required] [StringLength(64)] public string Property13 { get; set; }
+
+    [Required] [StringLength(64)] public string Property14 { get; set; }
+
+    [Required] [StringLength(64)] public string Property15 { get; set; }
+
+    [Required] [StringLength(64)] public string Property16 { get; set; }
+
+    [Required] [StringLength(64)] public string Property17 { get; set; }
+
+    [Required] [StringLength(64)] public string Property18 { get; set; }
+
+    [Required] [StringLength(64)] public string Property19 { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/CompiledModels/Test.cs b/samples/core/Miscellaneous/CompiledModels/Test.cs
new file mode 100644
index 0000000000..980c26c7d4
--- /dev/null
+++ b/samples/core/Miscellaneous/CompiledModels/Test.cs
@@ -0,0 +1,16 @@
+using System.Linq;
+using System.Threading.Tasks;
+using BenchmarkDotNet.Attributes;
+using CompiledModelTest;
+using Microsoft.EntityFrameworkCore;
+
+[SimpleJob(invocationCount: 1, targetCount: 50)]
+public class Test
+{
+    [Benchmark]
+    public async Task TimeToFirstQuery()
+    {
+        using var context = new BlogsContext();
+        var results = await context.Set<Blog0000>().ToListAsync();
+    }
+}
diff --git a/samples/core/Miscellaneous/CompiledModels/dotnet-tools.json b/samples/core/Miscellaneous/CompiledModels/dotnet-tools.json
new file mode 100644
index 0000000000..530896d9cd
--- /dev/null
+++ b/samples/core/Miscellaneous/CompiledModels/dotnet-tools.json
@@ -0,0 +1,12 @@
+{
+  "version": 1,
+  "isRoot": true,
+  "tools": {
+    "dotnet-ef": {
+      "version": "10.0.0",
+      "commands": [
+        "dotnet-ef"
+      ]
+    }
+  }
+}
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/ConfiguringDbContext/AdditionalConfiguration/ApplicationDbContext.cs b/samples/core/Miscellaneous/ConfiguringDbContext/AdditionalConfiguration/ApplicationDbContext.cs
new file mode 100644
index 0000000000..52136616b7
--- /dev/null
+++ b/samples/core/Miscellaneous/ConfiguringDbContext/AdditionalConfiguration/ApplicationDbContext.cs
@@ -0,0 +1,15 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace AdditionalConfiguration;
+
+#region ApplicationDbContext
+public class ApplicationDbContext : DbContext
+{
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .EnableSensitiveDataLogging()
+            .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Test;ConnectRetryCount=0");
+    }
+}
+#endregion
diff --git a/samples/core/Miscellaneous/ConfiguringDbContext/AdditionalProviderConfiguration/ApplicationDbContext.cs b/samples/core/Miscellaneous/ConfiguringDbContext/AdditionalProviderConfiguration/ApplicationDbContext.cs
new file mode 100644
index 0000000000..a622bcfc3c
--- /dev/null
+++ b/samples/core/Miscellaneous/ConfiguringDbContext/AdditionalProviderConfiguration/ApplicationDbContext.cs
@@ -0,0 +1,16 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace AdditionalProviderConfiguration;
+
+#region ApplicationDbContext
+public class ApplicationDbContext : DbContext
+{
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .UseSqlServer(
+                @"Server=(localdb)\mssqllocaldb;Database=Test",
+                providerOptions => { providerOptions.EnableRetryOnFailure(); });
+    }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/ConfiguringDbContext/ConfigureDbContextSample.cs b/samples/core/Miscellaneous/ConfiguringDbContext/ConfigureDbContextSample.cs
new file mode 100644
index 0000000000..71ad0c4b2e
--- /dev/null
+++ b/samples/core/Miscellaneous/ConfiguringDbContext/ConfigureDbContextSample.cs
@@ -0,0 +1,102 @@
+#nullable enable
+
+using System;
+using System.Linq;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.DependencyInjection;
+
+namespace ConfigureDbContextSample;
+
+public class BlogContext : DbContext
+{
+    public BlogContext(DbContextOptions<BlogContext> options) : base(options)
+    {
+    }
+
+    public DbSet<Blog> Blogs => Set<Blog>();
+}
+
+public class Blog
+{
+    public int Id { get; set; }
+    public required string Title { get; set; }
+    public string? Content { get; set; }
+}
+
+public static class ConfigureDbContextSample
+{
+    public static void Run()
+    {
+        BasicConfigureDbContextExample();
+        ProviderSpecificConfigurationExample();
+        ConfigurationCompositionExample();
+    }
+
+    private static void BasicConfigureDbContextExample()
+    {
+        Console.WriteLine("=== Basic ConfigureDbContext Example ===");
+        
+        #region BasicConfigureDbContext
+        var services = new ServiceCollection();
+
+        services.ConfigureDbContext<BlogContext>(options =>
+            options.EnableSensitiveDataLogging()
+                   .EnableDetailedErrors());
+
+        services.AddDbContext<BlogContext>(options =>
+            options.UseInMemoryDatabase("BasicExample"));
+        #endregion
+
+        var serviceProvider = services.BuildServiceProvider();
+        using var scope = serviceProvider.CreateScope();
+        var context = scope.ServiceProvider.GetRequiredService<BlogContext>();
+        
+        Console.WriteLine($"Context configured with provider: {context.Database.ProviderName}");
+        Console.WriteLine();
+    }
+
+    private static void ProviderSpecificConfigurationExample()
+    {
+        Console.WriteLine("=== Provider-Specific Configuration Example ===");
+        
+        #region ProviderSpecificConfiguration
+        var services = new ServiceCollection();
+
+        services.ConfigureDbContext<BlogContext>(options =>
+            options.UseSqlServer(sqlOptions => 
+                sqlOptions.EnableRetryOnFailure()));
+
+        services.AddDbContext<BlogContext>(options =>
+            options.UseSqlServer("connectionString"));
+        #endregion
+
+        var serviceProvider = services.BuildServiceProvider();
+        Console.WriteLine("Provider-specific configuration applied");
+        Console.WriteLine();
+    }
+
+    private static void ConfigurationCompositionExample()
+    {
+        Console.WriteLine("=== Configuration Composition Example ===");
+        
+        #region ConfigurationComposition
+        var services = new ServiceCollection();
+
+        services.ConfigureDbContext<BlogContext>(options =>
+            options.LogTo(Console.WriteLine));
+
+        services.AddDbContext<BlogContext>(options =>
+            options.UseInMemoryDatabase("CompositionExample"));
+
+        services.ConfigureDbContext<BlogContext>(options =>
+            options.EnableSensitiveDataLogging());
+        #endregion
+
+        var serviceProvider = services.BuildServiceProvider();
+        using var scope = serviceProvider.CreateScope();
+        var context = scope.ServiceProvider.GetRequiredService<BlogContext>();
+        
+        Console.WriteLine($"Context configured with provider: {context.Database.ProviderName}");
+        Console.WriteLine();
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/ConfiguringDbContext/ConfiguringDbContext.csproj b/samples/core/Miscellaneous/ConfiguringDbContext/ConfiguringDbContext.csproj
new file mode 100644
index 0000000000..4d14f0d528
--- /dev/null
+++ b/samples/core/Miscellaneous/ConfiguringDbContext/ConfiguringDbContext.csproj
@@ -0,0 +1,17 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+    <PropertyGroup>
+        <TargetFramework>net10.0</TargetFramework>
+        <ImplicitUsings>enable</ImplicitUsings>
+        <RootNamespace />
+    </PropertyGroup>
+
+    <ItemGroup>
+        <PackageReference Include="Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore" Version="10.0.0" />
+        <PackageReference Include="Microsoft.AspNetCore.Identity.EntityFrameworkCore" Version="10.0.0" />
+        <PackageReference Include="Microsoft.AspNetCore.Identity.UI" Version="10.0.0" />
+        <PackageReference Include="Microsoft.EntityFrameworkCore.InMemory" Version="10.0.0" />
+        <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+    </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/ConfiguringDbContext/InheritDbContext/ApplicationDbContext.cs b/samples/core/Miscellaneous/ConfiguringDbContext/InheritDbContext/ApplicationDbContext.cs
new file mode 100644
index 0000000000..cdc1a6ba79
--- /dev/null
+++ b/samples/core/Miscellaneous/ConfiguringDbContext/InheritDbContext/ApplicationDbContext.cs
@@ -0,0 +1,56 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace InheritDbContext;
+
+#region SealedApplicationDbContext
+public sealed class SealedApplicationDbContext : DbContext
+{
+    public SealedApplicationDbContext(DbContextOptions<SealedApplicationDbContext> contextOptions)
+        : base(contextOptions)
+    {
+    }
+}
+#endregion
+
+#region ApplicationDbContextBase
+public abstract class ApplicationDbContextBase : DbContext
+{
+    protected ApplicationDbContextBase(DbContextOptions contextOptions)
+        : base(contextOptions)
+    {
+    }
+}
+#endregion
+
+#region ApplicationDbContext12
+public sealed class ApplicationDbContext1 : ApplicationDbContextBase
+{
+    public ApplicationDbContext1(DbContextOptions<ApplicationDbContext1> contextOptions)
+        : base(contextOptions)
+    {
+    }
+}
+
+public sealed class ApplicationDbContext2 : ApplicationDbContextBase
+{
+    public ApplicationDbContext2(DbContextOptions<ApplicationDbContext2> contextOptions)
+        : base(contextOptions)
+    {
+    }
+}
+#endregion
+
+#region ApplicationDbContext
+public class ApplicationDbContext : DbContext
+{
+    public ApplicationDbContext(DbContextOptions<ApplicationDbContext> contextOptions)
+        : base(contextOptions)
+    {
+    }
+
+    protected ApplicationDbContext(DbContextOptions contextOptions)
+        : base(contextOptions)
+    {
+    }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/ConfiguringDbContext/Properties/launchSettings.json b/samples/core/Miscellaneous/ConfiguringDbContext/Properties/launchSettings.json
new file mode 100644
index 0000000000..a2507be0b6
--- /dev/null
+++ b/samples/core/Miscellaneous/ConfiguringDbContext/Properties/launchSettings.json
@@ -0,0 +1,12 @@
+{
+  "profiles": {
+    "ConfiguringDbContext": {
+      "commandName": "Project",
+      "launchBrowser": true,
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      },
+      "applicationUrl": "https://localhost:58221;http://localhost:58223"
+    }
+  }
+}
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/ConfiguringDbContext/WebApp/ApplicationDbContext.cs b/samples/core/Miscellaneous/ConfiguringDbContext/WebApp/ApplicationDbContext.cs
new file mode 100644
index 0000000000..2a151ad70e
--- /dev/null
+++ b/samples/core/Miscellaneous/ConfiguringDbContext/WebApp/ApplicationDbContext.cs
@@ -0,0 +1,13 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace WebApp;
+
+#region ApplicationDbContext
+public class ApplicationDbContext : DbContext
+{
+    public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options)
+        : base(options)
+    {
+    }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/ConfiguringDbContext/WebApp/Controllers/MyController.cs b/samples/core/Miscellaneous/ConfiguringDbContext/WebApp/Controllers/MyController.cs
new file mode 100644
index 0000000000..60da1cd181
--- /dev/null
+++ b/samples/core/Miscellaneous/ConfiguringDbContext/WebApp/Controllers/MyController.cs
@@ -0,0 +1,13 @@
+namespace WebApp.Controllers;
+
+#region MyController
+public class MyController
+{
+    private readonly ApplicationDbContext _context;
+
+    public MyController(ApplicationDbContext context)
+    {
+        _context = context;
+    }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/ConfiguringDbContext/WebApp/Program.cs b/samples/core/Miscellaneous/ConfiguringDbContext/WebApp/Program.cs
new file mode 100644
index 0000000000..3bad2b496f
--- /dev/null
+++ b/samples/core/Miscellaneous/ConfiguringDbContext/WebApp/Program.cs
@@ -0,0 +1,16 @@
+using Microsoft.AspNetCore.Hosting;
+using Microsoft.Extensions.Hosting;
+
+namespace WebApp;
+
+public class Program
+{
+    public static void Main(string[] args)
+    {
+        CreateHostBuilder(args).Build().Run();
+    }
+
+    public static IHostBuilder CreateHostBuilder(string[] args) =>
+        Host.CreateDefaultBuilder(args)
+            .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseStartup<Startup>(); });
+}
diff --git a/samples/core/Miscellaneous/ConfiguringDbContext/WebApp/Startup.cs b/samples/core/Miscellaneous/ConfiguringDbContext/WebApp/Startup.cs
new file mode 100644
index 0000000000..b9491b6031
--- /dev/null
+++ b/samples/core/Miscellaneous/ConfiguringDbContext/WebApp/Startup.cs
@@ -0,0 +1,46 @@
+using Microsoft.AspNetCore.Builder;
+using Microsoft.AspNetCore.Hosting;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+
+namespace WebApp;
+
+public class Startup
+{
+    public Startup(IConfiguration configuration)
+    {
+        Configuration = configuration;
+    }
+
+    public IConfiguration Configuration { get; }
+
+    // This method gets called by the runtime. Use this method to add services to the container.
+    #region ConfigureServices
+    public void ConfigureServices(IServiceCollection services)
+    {
+        services.AddControllers();
+
+        services.AddDbContext<ApplicationDbContext>(
+            options => options.UseSqlServer("name=ConnectionStrings:DefaultConnection"));
+    }
+    #endregion
+
+    // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
+    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
+    {
+        if (env.IsDevelopment())
+        {
+            app.UseDeveloperExceptionPage();
+        }
+
+        app.UseHttpsRedirection();
+
+        app.UseRouting();
+
+        app.UseAuthorization();
+
+        app.UseEndpoints(endpoints => { endpoints.MapControllers(); });
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/ConfiguringDbContext/WebApp/UseNewForWebApp.cs b/samples/core/Miscellaneous/ConfiguringDbContext/WebApp/UseNewForWebApp.cs
new file mode 100644
index 0000000000..27a4aa1f3e
--- /dev/null
+++ b/samples/core/Miscellaneous/ConfiguringDbContext/WebApp/UseNewForWebApp.cs
@@ -0,0 +1,17 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace WebApp;
+
+public static class UseNewForWebApp
+{
+    public static void Example()
+    {
+        #region UseNewForWebApp
+        var contextOptions = new DbContextOptionsBuilder<ApplicationDbContext>()
+            .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Test;ConnectRetryCount=0")
+            .Options;
+
+        using var context = new ApplicationDbContext(contextOptions);
+        #endregion
+    }
+}
diff --git a/samples/core/Miscellaneous/ConfiguringDbContext/WebApp/appsettings.Development.json b/samples/core/Miscellaneous/ConfiguringDbContext/WebApp/appsettings.Development.json
new file mode 100644
index 0000000000..d2494501e1
--- /dev/null
+++ b/samples/core/Miscellaneous/ConfiguringDbContext/WebApp/appsettings.Development.json
@@ -0,0 +1,12 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft": "Warning",
+      "Microsoft.Hosting.Lifetime": "Information"
+    }
+  },
+  "ConnectionStrings": {
+    "DefaultConnection": "Server=(localdb)\\mssqllocaldb;Database=Test"
+  }
+}
diff --git a/samples/core/Miscellaneous/ConfiguringDbContext/WebApp/appsettings.json b/samples/core/Miscellaneous/ConfiguringDbContext/WebApp/appsettings.json
new file mode 100644
index 0000000000..c0042aab6e
--- /dev/null
+++ b/samples/core/Miscellaneous/ConfiguringDbContext/WebApp/appsettings.json
@@ -0,0 +1,13 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft": "Warning",
+      "Microsoft.Hosting.Lifetime": "Information"
+    }
+  },
+  "ConnectionStrings": {
+    "DefaultConnection": "Server=(localdb)\\mssqllocaldb;Database=Test"
+  },
+  "AllowedHosts": "*"
+}
diff --git a/samples/core/Miscellaneous/ConfiguringDbContext/WebApp9/Program9.cs b/samples/core/Miscellaneous/ConfiguringDbContext/WebApp9/Program9.cs
new file mode 100644
index 0000000000..d78296f09d
--- /dev/null
+++ b/samples/core/Miscellaneous/ConfiguringDbContext/WebApp9/Program9.cs
@@ -0,0 +1,43 @@
+using Microsoft.AspNetCore.Identity;
+using Microsoft.EntityFrameworkCore;
+using WebApp;
+
+var builder = WebApplication.CreateBuilder(args);
+// <snippet_1>
+var connectionString =
+    builder.Configuration.GetConnectionString("DefaultConnection")
+        ?? throw new InvalidOperationException("Connection string"
+        + "'DefaultConnection' not found.");
+
+builder.Services.AddDbContext<ApplicationDbContext>(options =>
+    options.UseSqlServer(connectionString));
+// </snippet_1>
+
+builder.Services.AddDatabaseDeveloperPageExceptionFilter();
+
+builder.Services.AddDefaultIdentity<IdentityUser>(options => options.SignIn.RequireConfirmedAccount = true)
+    .AddEntityFrameworkStores<ApplicationDbContext>();
+builder.Services.AddRazorPages();
+
+var app = builder.Build();
+
+if (app.Environment.IsDevelopment())
+{
+    app.UseMigrationsEndPoint();
+}
+else
+{
+    app.UseExceptionHandler("/Error");
+    app.UseHsts();
+}
+
+app.UseHttpsRedirection();
+app.UseStaticFiles();
+
+app.UseRouting();
+
+app.UseAuthorization();
+
+app.MapRazorPages();
+
+app.Run();
diff --git a/samples/core/Miscellaneous/ConfiguringDbContext/WithContextFactory/FactoryServicesExample.cs b/samples/core/Miscellaneous/ConfiguringDbContext/WithContextFactory/FactoryServicesExample.cs
new file mode 100644
index 0000000000..c31dcf6616
--- /dev/null
+++ b/samples/core/Miscellaneous/ConfiguringDbContext/WithContextFactory/FactoryServicesExample.cs
@@ -0,0 +1,17 @@
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.DependencyInjection;
+using WebApp;
+
+namespace WithContextFactory;
+
+public class FactoryServicesExample
+{
+    #region ConfigureServices
+    public void ConfigureServices(IServiceCollection services)
+    {
+        services.AddDbContextFactory<ApplicationDbContext>(
+            options => options.UseSqlServer(
+                @"Server=(localdb)\mssqllocaldb;Database=Test;ConnectRetryCount=0"));
+    }
+    #endregion
+}
diff --git a/samples/core/Miscellaneous/ConfiguringDbContext/WithContextFactory/MyController.cs b/samples/core/Miscellaneous/ConfiguringDbContext/WithContextFactory/MyController.cs
new file mode 100644
index 0000000000..8734218872
--- /dev/null
+++ b/samples/core/Miscellaneous/ConfiguringDbContext/WithContextFactory/MyController.cs
@@ -0,0 +1,28 @@
+using Microsoft.EntityFrameworkCore;
+using WebApp;
+
+namespace WithContextFactory;
+
+#pragma warning disable CS1998 // This async method lacks 'await' operators and will run synchronously.
+
+public class MyController
+{
+    #region Construct
+    private readonly IDbContextFactory<ApplicationDbContext> _contextFactory;
+
+    public MyController(IDbContextFactory<ApplicationDbContext> contextFactory)
+    {
+        _contextFactory = contextFactory;
+    }
+    #endregion
+
+    #region DoSomething
+    public async Task DoSomething()
+    {
+        using (var context = _contextFactory.CreateDbContext())
+        {
+            // ...
+        }
+    }
+    #endregion
+}
diff --git a/samples/core/Miscellaneous/ConfiguringDbContext/WithNew/ApplicationDbContext.cs b/samples/core/Miscellaneous/ConfiguringDbContext/WithNew/ApplicationDbContext.cs
new file mode 100644
index 0000000000..29e3b9c2f5
--- /dev/null
+++ b/samples/core/Miscellaneous/ConfiguringDbContext/WithNew/ApplicationDbContext.cs
@@ -0,0 +1,14 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace WithNew;
+
+#region ApplicationDbContext
+public class ApplicationDbContext : DbContext
+{
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder.UseSqlServer(
+            @"Server=(localdb)\mssqllocaldb;Database=Test;ConnectRetryCount=0");
+    }
+}
+#endregion
diff --git a/samples/core/Miscellaneous/ConfiguringDbContext/WithNewAndArgs/ApplicationDbContext.cs b/samples/core/Miscellaneous/ConfiguringDbContext/WithNewAndArgs/ApplicationDbContext.cs
new file mode 100644
index 0000000000..6256972459
--- /dev/null
+++ b/samples/core/Miscellaneous/ConfiguringDbContext/WithNewAndArgs/ApplicationDbContext.cs
@@ -0,0 +1,20 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace WithNewAndArgs;
+
+#region ApplicationDbContext
+public class ApplicationDbContext : DbContext
+{
+    private readonly string _connectionString;
+
+    public ApplicationDbContext(string connectionString)
+    {
+        _connectionString = connectionString;
+    }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder.UseSqlServer(_connectionString);
+    }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/ConnectionInterception/AadAuthenticationInterceptor.cs b/samples/core/Miscellaneous/ConnectionInterception/AadAuthenticationInterceptor.cs
new file mode 100644
index 0000000000..66c5cda8ca
--- /dev/null
+++ b/samples/core/Miscellaneous/ConnectionInterception/AadAuthenticationInterceptor.cs
@@ -0,0 +1,34 @@
+using System;
+using System.Data.Common;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.Azure.Services.AppAuthentication;
+using Microsoft.Data.SqlClient;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+#region AadAuthenticationInterceptor
+public class AadAuthenticationInterceptor : DbConnectionInterceptor
+{
+    public override InterceptionResult ConnectionOpening(
+        DbConnection connection,
+        ConnectionEventData eventData,
+        InterceptionResult result)
+        => throw new InvalidOperationException("Open connections asynchronously when using AAD authentication.");
+
+    public override async ValueTask<InterceptionResult> ConnectionOpeningAsync(
+        DbConnection connection,
+        ConnectionEventData eventData,
+        InterceptionResult result,
+        CancellationToken cancellationToken = default)
+    {
+        var sqlConnection = (SqlConnection)connection;
+
+        var provider = new AzureServiceTokenProvider();
+        // Note: in some situations the access token may not be cached automatically the Azure Token Provider.
+        // Depending on the kind of token requested, you may need to implement your own caching here.
+        sqlConnection.AccessToken = await provider.GetAccessTokenAsync("https://database.windows.net/", null, cancellationToken);
+
+        return result;
+    }
+}
+#endregion
diff --git a/samples/core/Miscellaneous/ConnectionInterception/BlogsContext.cs b/samples/core/Miscellaneous/ConnectionInterception/BlogsContext.cs
new file mode 100644
index 0000000000..1fce0ff8a5
--- /dev/null
+++ b/samples/core/Miscellaneous/ConnectionInterception/BlogsContext.cs
@@ -0,0 +1,24 @@
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Logging;
+
+public class BlogsContext : DbContext
+{
+    private const string ConnectionString = @"Server=(localdb)\mssqllocaldb;Database=InterceptionTest;Trusted_Connection=True;ConnectRetryCount=0";
+
+    private static readonly AadAuthenticationInterceptor _interceptor
+        = new AadAuthenticationInterceptor();
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.LogTo(Console.WriteLine, LogLevel.Information)
+            .UseSqlServer(ConnectionString)
+            .AddInterceptors(_interceptor);
+
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+public class Blog
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+}
diff --git a/samples/core/Miscellaneous/ConnectionInterception/ConnectionInterception.csproj b/samples/core/Miscellaneous/ConnectionInterception/ConnectionInterception.csproj
new file mode 100644
index 0000000000..74fd2f4818
--- /dev/null
+++ b/samples/core/Miscellaneous/ConnectionInterception/ConnectionInterception.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <TargetFramework>net10.0</TargetFramework>
+        <RootNamespace />
+    </PropertyGroup>
+
+    <ItemGroup>
+        <PackageReference Include="Microsoft.Azure.Services.AppAuthentication" Version="1.6.2" />
+        <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+    </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/ConnectionInterception/Program.cs b/samples/core/Miscellaneous/ConnectionInterception/Program.cs
new file mode 100644
index 0000000000..2536456f31
--- /dev/null
+++ b/samples/core/Miscellaneous/ConnectionInterception/Program.cs
@@ -0,0 +1,25 @@
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+public class Program
+{
+    public static async Task Main()
+    {
+        using (var context = new BlogsContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            context.AddRange(
+                new Blog { Name = "Blog1" },
+                new Blog { Name = "Blog2" });
+
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new BlogsContext())
+        {
+            var blogs = await context.Blogs.ToListAsync();
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/ConnectionResiliency/ConnectionResiliency.csproj b/samples/core/Miscellaneous/ConnectionResiliency/ConnectionResiliency.csproj
new file mode 100644
index 0000000000..0ab9f9372e
--- /dev/null
+++ b/samples/core/Miscellaneous/ConnectionResiliency/ConnectionResiliency.csproj
@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFConnectionResiliency</RootNamespace>
+    <AssemblyName>EFConnectionResiliency</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+    <PackageReference Include="Microsoft.Extensions.Logging.Console" Version="7.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/ConnectionResiliency/Program.cs b/samples/core/Miscellaneous/ConnectionResiliency/Program.cs
new file mode 100644
index 0000000000..f56f9158a5
--- /dev/null
+++ b/samples/core/Miscellaneous/ConnectionResiliency/Program.cs
@@ -0,0 +1,154 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using System.Transactions;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFConnectionResiliency;
+
+public class Program
+{
+    public static async Task Main(string[] args)
+    {
+        using (var db = new BloggingContext())
+        {
+            await db.Database.EnsureDeletedAsync();
+            await db.Database.EnsureCreatedAsync();
+        }
+
+        await ExecuteWithManualTransaction();
+
+        await ExecuteWithManualAmbientTransaction();
+
+        await ExecuteInTransactionWithVerification();
+
+        await ExecuteInTransactionWithTracking();
+    }
+
+    private static async Task ExecuteWithManualTransaction()
+    {
+        #region ManualTransaction
+
+        using var db = new BloggingContext();
+        var strategy = db.Database.CreateExecutionStrategy();
+
+        await strategy.ExecuteAsync(
+            async () =>
+            {
+                using var context = new BloggingContext();
+                await using var transaction = await context.Database.BeginTransactionAsync();
+
+                context.Blogs.Add(new Blog { Url = "http://blogs.msdn.com/dotnet" });
+                await context.SaveChangesAsync();
+
+                context.Blogs.Add(new Blog { Url = "http://blogs.msdn.com/visualstudio" });
+                await context.SaveChangesAsync();
+
+                await transaction.CommitAsync();
+            });
+
+        #endregion
+    }
+
+    private static async Task ExecuteWithManualAmbientTransaction()
+    {
+        #region AmbientTransaction
+
+        using var context1 = new BloggingContext();
+        context1.Blogs.Add(new Blog { Url = "http://blogs.msdn.com/visualstudio" });
+
+        var strategy = context1.Database.CreateExecutionStrategy();
+
+        await strategy.ExecuteAsync(
+            async () =>
+            {
+                using var context2 = new BloggingContext();
+                using var transaction = new TransactionScope();
+
+                context2.Blogs.Add(new Blog { Url = "http://blogs.msdn.com/dotnet" });
+                await context2.SaveChangesAsync();
+
+                await context1.SaveChangesAsync();
+
+                transaction.Complete();
+            });
+
+        #endregion
+    }
+
+    private static async Task ExecuteInTransactionWithVerification()
+    {
+        #region Verification
+
+        using var db = new BloggingContext();
+        var strategy = db.Database.CreateExecutionStrategy();
+
+        var blogToAdd = new Blog { Url = "http://blogs.msdn.com/dotnet" };
+        db.Blogs.Add(blogToAdd);
+
+        await strategy.ExecuteInTransactionAsync(
+            db,
+            operation: (context, cancellationToken) => context.SaveChangesAsync(acceptAllChangesOnSuccess: false, cancellationToken),
+            verifySucceeded: (context, cancellationToken) => context.Blogs.AsNoTracking().AnyAsync(b => b.BlogId == blogToAdd.BlogId, cancellationToken));
+
+        db.ChangeTracker.AcceptAllChanges();
+
+        #endregion
+    }
+
+    private static async Task ExecuteInTransactionWithTracking()
+    {
+        #region Tracking
+
+        using var db = new BloggingContext();
+        var strategy = db.Database.CreateExecutionStrategy();
+
+        db.Blogs.Add(new Blog { Url = "http://blogs.msdn.com/dotnet" });
+
+        var transaction = new TransactionRow { Id = Guid.NewGuid() };
+        db.Transactions.Add(transaction);
+
+        await strategy.ExecuteInTransactionAsync(
+            db,
+            operation: (context, cancellationToken) => context.SaveChangesAsync(acceptAllChangesOnSuccess: false, cancellationToken),
+            verifySucceeded: (context, cancellationToken) => context.Transactions.AsNoTracking().AnyAsync(t => t.Id == transaction.Id, cancellationToken));
+
+        db.ChangeTracker.AcceptAllChanges();
+        db.Transactions.Remove(transaction);
+        await db.SaveChangesAsync();
+
+        #endregion
+    }
+}
+
+public class BloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<TransactionRow> Transactions { get; set; }
+
+    #region OnConfiguring
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .UseSqlServer(
+                @"Server=(localdb)\mssqllocaldb;Database=EFMiscellanous.ConnectionResiliency;Trusted_Connection=True;ConnectRetryCount=0",
+                options => options.EnableRetryOnFailure());
+    }
+    #endregion
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>().Property(b => b.BlogId).UseHiLo();
+    }
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
+
+public class TransactionRow
+{
+    public Guid Id { get; set; }
+}
diff --git a/samples/core/Miscellaneous/DiagnosticListeners/DiagnosticListeners.csproj b/samples/core/Miscellaneous/DiagnosticListeners/DiagnosticListeners.csproj
new file mode 100644
index 0000000000..21d10ca0ac
--- /dev/null
+++ b/samples/core/Miscellaneous/DiagnosticListeners/DiagnosticListeners.csproj
@@ -0,0 +1,13 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <TargetFramework>net10.0</TargetFramework>
+        <RootNamespace />
+    </PropertyGroup>
+
+    <ItemGroup>
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+    </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/DiagnosticListeners/Program.cs b/samples/core/Miscellaneous/DiagnosticListeners/Program.cs
new file mode 100644
index 0000000000..b61e0b113f
--- /dev/null
+++ b/samples/core/Miscellaneous/DiagnosticListeners/Program.cs
@@ -0,0 +1,110 @@
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+#region DiagnosticObserver
+public class DiagnosticObserver : IObserver<DiagnosticListener>
+{
+    public void OnCompleted()
+        => throw new NotImplementedException();
+
+    public void OnError(Exception error)
+        => throw new NotImplementedException();
+
+    public void OnNext(DiagnosticListener value)
+    {
+        if (value.Name == DbLoggerCategory.Name) // "Microsoft.EntityFrameworkCore"
+        {
+            value.Subscribe(new KeyValueObserver());
+        }
+    }
+}
+#endregion
+
+#region KeyValueObserver
+public class KeyValueObserver : IObserver<KeyValuePair<string, object>>
+{
+    public void OnCompleted()
+        => throw new NotImplementedException();
+
+    public void OnError(Exception error)
+        => throw new NotImplementedException();
+
+    public void OnNext(KeyValuePair<string, object> value)
+    {
+        if (value.Key == CoreEventId.ContextInitialized.Name)
+        {
+            var payload = (ContextInitializedEventData)value.Value;
+            Console.WriteLine($"EF is initializing {payload.Context.GetType().Name} ");
+        }
+
+        if (value.Key == RelationalEventId.ConnectionOpening.Name)
+        {
+            var payload = (ConnectionEventData)value.Value;
+            Console.WriteLine($"EF is opening a connection to {payload.Connection.ConnectionString} ");
+        }
+    }
+}
+#endregion
+
+public class Program
+{
+    #region Program
+    public static async Task Main()
+    {
+        #region RegisterDiagnosticListener
+        DiagnosticListener.AllListeners.Subscribe(new DiagnosticObserver());
+        #endregion
+
+        using (var context = new BlogsContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            context.Add(
+                new Blog { Name = "EF Blog", Posts = { new Post { Title = "EF Core 3.1!" }, new Post { Title = "EF Core 5.0!" } } });
+
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new BlogsContext())
+        {
+            var blog = await context.Blogs.Include(e => e.Posts).SingleAsync();
+
+            blog.Name = "EF Core Blog";
+            context.Remove(blog.Posts.First());
+            blog.Posts.Add(new Post { Title = "EF Core 6.0!" });
+
+            await context.SaveChangesAsync();
+        }
+        #endregion
+    }
+}
+
+public class BlogsContext : DbContext
+{
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.UseSqlite("DataSource=blogs.db");
+
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+public class Blog
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+
+    public ICollection<Post> Posts { get; } = new List<Post>();
+}
+
+public class Post
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+
+    public Blog Blog { get; set; }
+}
diff --git a/samples/core/Miscellaneous/Events/Events.csproj b/samples/core/Miscellaneous/Events/Events.csproj
new file mode 100644
index 0000000000..21d10ca0ac
--- /dev/null
+++ b/samples/core/Miscellaneous/Events/Events.csproj
@@ -0,0 +1,13 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <TargetFramework>net10.0</TargetFramework>
+        <RootNamespace />
+    </PropertyGroup>
+
+    <ItemGroup>
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+    </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/Events/Program.cs b/samples/core/Miscellaneous/Events/Program.cs
new file mode 100644
index 0000000000..2a34131c9f
--- /dev/null
+++ b/samples/core/Miscellaneous/Events/Program.cs
@@ -0,0 +1,138 @@
+using System;
+using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations.Schema;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.ChangeTracking;
+
+public class Program
+{
+    public static async Task Main()
+    {
+        #region Demonstration
+        using (var context = new BlogsContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            context.Add(
+                new Blog
+                {
+                    Id = 1,
+                    Name = "EF Blog",
+                    Posts = { new Post { Id = 1, Title = "EF Core 3.1!" }, new Post { Id = 2, Title = "EF Core 5.0!" } }
+                });
+
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new BlogsContext())
+        {
+            var blog = await context.Blogs.Include(e => e.Posts).SingleAsync();
+
+            blog.Name = "EF Core Blog";
+            context.Remove(blog.Posts.First());
+            blog.Posts.Add(new Post { Id = 3, Title = "EF Core 6.0!" });
+
+            await context.SaveChangesAsync();
+        }
+        #endregion
+    }
+}
+
+#region BlogsContext
+public class BlogsContext : DbContext
+{
+    #region ContextConstructor
+    public BlogsContext()
+    {
+        ChangeTracker.StateChanged += UpdateTimestamps;
+        ChangeTracker.Tracked += UpdateTimestamps;
+    }
+    #endregion
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.UseSqlite("DataSource=blogs.db");
+
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region UpdateTimestamps
+    private static void UpdateTimestamps(object sender, EntityEntryEventArgs e)
+    {
+        if (e.Entry.Entity is IHasTimestamps entityWithTimestamps)
+        {
+            switch (e.Entry.State)
+            {
+                case EntityState.Deleted:
+                    entityWithTimestamps.Deleted = DateTime.UtcNow;
+                    Console.WriteLine($"Stamped for delete: {e.Entry.Entity}");
+                    break;
+                case EntityState.Modified:
+                    entityWithTimestamps.Modified = DateTime.UtcNow;
+                    Console.WriteLine($"Stamped for update: {e.Entry.Entity}");
+                    break;
+                case EntityState.Added:
+                    entityWithTimestamps.Added = DateTime.UtcNow;
+                    Console.WriteLine($"Stamped for insert: {e.Entry.Entity}");
+                    break;
+            }
+        }
+    }
+    #endregion
+}
+
+public static class HasTimestampsExtensions
+{
+    public static string ToStampString(this IHasTimestamps entity)
+    {
+        return $"{GetStamp("Added", entity.Added)}{GetStamp("Modified", entity.Modified)}{GetStamp("Deleted", entity.Deleted)}";
+
+        string GetStamp(string state, DateTime? dateTime)
+            => dateTime == null ? "" : $" {state} on: {dateTime}";
+    }
+}
+
+#region IHasTimestamps
+public interface IHasTimestamps
+{
+    DateTime? Added { get; set; }
+    DateTime? Deleted { get; set; }
+    DateTime? Modified { get; set; }
+}
+#endregion
+
+public class Blog : IHasTimestamps
+{
+    [DatabaseGenerated(DatabaseGeneratedOption.None)]
+    public int Id { get; set; }
+
+    public string Name { get; set; }
+
+    public ICollection<Post> Posts { get; } = new List<Post>();
+
+    public DateTime? Added { get; set; }
+    public DateTime? Deleted { get; set; }
+    public DateTime? Modified { get; set; }
+
+    public override string ToString()
+        => $"Blog {Id}{this.ToStampString()}";
+}
+
+public class Post : IHasTimestamps
+{
+    [DatabaseGenerated(DatabaseGeneratedOption.None)]
+    public int Id { get; set; }
+
+    public string Title { get; set; }
+
+    public Blog Blog { get; set; }
+
+    public DateTime? Added { get; set; }
+    public DateTime? Deleted { get; set; }
+    public DateTime? Modified { get; set; }
+
+    public override string ToString()
+        => $"Post {Id}{this.ToStampString()}";
+}
+#endregion
diff --git a/samples/core/Miscellaneous/Logging/Logging/Blog.cs b/samples/core/Miscellaneous/Logging/Logging/Blog.cs
new file mode 100644
index 0000000000..f7a96df81d
--- /dev/null
+++ b/samples/core/Miscellaneous/Logging/Logging/Blog.cs
@@ -0,0 +1,7 @@
+namespace EFLogging;
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/Logging/Logging/BloggingContext.cs b/samples/core/Miscellaneous/Logging/Logging/BloggingContext.cs
new file mode 100644
index 0000000000..16283d63f9
--- /dev/null
+++ b/samples/core/Miscellaneous/Logging/Logging/BloggingContext.cs
@@ -0,0 +1,68 @@
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+using Microsoft.Extensions.Logging;
+
+namespace EFLogging;
+
+public class BloggingContext : DbContext
+{
+    #region DefineLoggerFactory
+    public static readonly ILoggerFactory MyLoggerFactory
+        = LoggerFactory.Create(builder => { builder.AddConsole(); });
+    #endregion
+
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region RegisterLoggerFactory
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .UseLoggerFactory(MyLoggerFactory)
+            .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFLogging;Trusted_Connection=True;ConnectRetryCount=0");
+    #endregion
+}
+
+public class EnableSensitiveDataLoggingContext : BloggingContext
+{
+    #region EnableSensitiveDataLogging
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.EnableSensitiveDataLogging();
+    #endregion
+}
+
+public class EnableDetailedErrorsContext : BloggingContext
+{
+    #region EnableDetailedErrors
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.EnableDetailedErrors();
+    #endregion
+}
+
+public class ChangeLogLevelContext : BloggingContext
+{
+    #region ChangeLogLevel
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .ConfigureWarnings(
+                b => b.Log(
+                    (RelationalEventId.ConnectionOpened, LogLevel.Information),
+                    (RelationalEventId.ConnectionClosed, LogLevel.Information)));
+    #endregion
+}
+
+public class SuppressMessageContext : BloggingContext
+{
+    #region SuppressMessage
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .ConfigureWarnings(b => b.Ignore(CoreEventId.DetachedLazyLoadingWarning));
+    #endregion
+}
+
+public class ThrowForEventContext : BloggingContext
+{
+    #region ThrowForEvent
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .ConfigureWarnings(b => b.Throw(RelationalEventId.QueryPossibleUnintendedUseOfEqualsWarning));
+    #endregion
+}
diff --git a/samples/core/Miscellaneous/Logging/Logging/BloggingContextWithFiltering.cs b/samples/core/Miscellaneous/Logging/Logging/BloggingContextWithFiltering.cs
new file mode 100644
index 0000000000..164b647265
--- /dev/null
+++ b/samples/core/Miscellaneous/Logging/Logging/BloggingContextWithFiltering.cs
@@ -0,0 +1,31 @@
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Logging;
+
+namespace EFLogging;
+
+public class BloggingContextWithFiltering : DbContext
+{
+    #region DefineLoggerFactory
+    public static readonly ILoggerFactory MyLoggerFactory
+        = LoggerFactory.Create(
+            builder =>
+            {
+                builder
+                    .AddFilter(
+                        (category, level) =>
+                            category == DbLoggerCategory.Database.Command.Name
+                            && level == LogLevel.Information)
+                    .AddConsole();
+            });
+    #endregion
+
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region RegisterLoggerFactory
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .UseLoggerFactory(MyLoggerFactory) // Warning: Do not create a new ILoggerFactory instance each time
+            .UseSqlServer(
+                @"Server=(localdb)\mssqllocaldb;Database=EFLogging;Trusted_Connection=True;ConnectRetryCount=0");
+    #endregion
+}
diff --git a/samples/core/Miscellaneous/Logging/Logging/Logging.csproj b/samples/core/Miscellaneous/Logging/Logging/Logging.csproj
new file mode 100644
index 0000000000..ced1f1128a
--- /dev/null
+++ b/samples/core/Miscellaneous/Logging/Logging/Logging.csproj
@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFLogging</RootNamespace>
+    <AssemblyName>EFLogging</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+    <PackageReference Include="Microsoft.Extensions.Logging.Console" Version="7.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/Logging/Logging/Program.cs b/samples/core/Miscellaneous/Logging/Logging/Program.cs
new file mode 100644
index 0000000000..a1f0f238dc
--- /dev/null
+++ b/samples/core/Miscellaneous/Logging/Logging/Program.cs
@@ -0,0 +1,40 @@
+using System;
+using System.Threading.Tasks;
+
+namespace EFLogging;
+
+public class Program
+{
+    public static async Task Main()
+    {
+        using (var db = new BloggingContext())
+        {
+            await db.Database.EnsureCreatedAsync();
+            db.Blogs.Add(new Blog { Url = "http://sample.com" });
+            await db.SaveChangesAsync();
+        }
+
+        using (var db = new BloggingContext())
+        {
+            foreach (var blog in db.Blogs)
+            {
+                Console.WriteLine(blog.Url);
+            }
+        }
+
+        using (var db = new BloggingContextWithFiltering())
+        {
+            await db.Database.EnsureCreatedAsync();
+            db.Blogs.Add(new Blog { Url = "http://sample.com" });
+            await db.SaveChangesAsync();
+        }
+
+        using (var db = new BloggingContextWithFiltering())
+        {
+            foreach (var blog in db.Blogs)
+            {
+                Console.WriteLine(blog.Url);
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/Logging/SimpleLogging/Program.cs b/samples/core/Miscellaneous/Logging/SimpleLogging/Program.cs
new file mode 100755
index 0000000000..8b919a71c8
--- /dev/null
+++ b/samples/core/Miscellaneous/Logging/SimpleLogging/Program.cs
@@ -0,0 +1,239 @@
+using System;
+using System.Diagnostics;
+using System.IO;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+using Microsoft.Extensions.Logging;
+
+public class Program
+{
+    public static async Task Main()
+    {
+        await TestCode<LogToConsoleContext>();
+        await TestCode<LogToDebugContext>();
+        await TestCode<LogToFileContext>();
+        await TestCode<InfoOnlyContext>();
+        await TestCode<SensitiveDataLoggingContext>();
+        await TestCode<EnableDetailedErrorsContext>();
+        await TestCode<EventIdsContext>();
+        await TestCode<DatabaseCategoryContext>();
+        await TestCode<CustomFilterContext>();
+        await TestCode<ChangeLogLevelContext>();
+        await TestCode<SuppressMessageContext>();
+        await TestCode<ThrowForEventContext>();
+        await TestCode<UtcContext>();
+        await TestCode<SingleLineContext>();
+        await TestCode<TerseLogsContext>();
+        await TestDatabaseLog();
+
+        static async Task TestCode<TContext>()
+            where TContext : BlogsContext, new()
+        {
+            using var context = new TContext();
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        static async Task TestDatabaseLog()
+        {
+            using var context = new DatabaseLogContext();
+
+            await context.Database.EnsureDeletedAsync();
+
+            context.Log = Console.WriteLine;
+
+            await context.Database.EnsureCreatedAsync();
+        }
+    }
+}
+
+public class Blog
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+}
+
+public abstract class BlogsContext : DbContext
+{
+    protected BlogsContext()
+        : base(new DbContextOptionsBuilder().UseSqlite("DataSource=test.db").Options)
+    {
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+public class LogToConsoleContext : BlogsContext
+{
+    #region LogToConsole
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.LogTo(Console.WriteLine);
+    #endregion
+}
+
+public class LogToDebugContext : BlogsContext
+{
+    #region LogToDebug
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.LogTo(message => Debug.WriteLine(message));
+    #endregion
+}
+
+public class LogToFileContext : BlogsContext
+{
+    #region LogToFile
+    private readonly StreamWriter _logStream = new StreamWriter("mylog.txt", append: true);
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.LogTo(_logStream.WriteLine);
+
+    public override void Dispose()
+    {
+        base.Dispose();
+        _logStream.Dispose();
+    }
+
+    public override async ValueTask DisposeAsync()
+    {
+        await base.DisposeAsync();
+        await _logStream.DisposeAsync();
+    }
+    #endregion
+}
+
+public class InfoOnlyContext : BlogsContext
+{
+    #region InfoOnly
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.LogTo(Console.WriteLine, LogLevel.Information);
+    #endregion
+}
+
+public class SensitiveDataLoggingContext : BlogsContext
+{
+    #region SensitiveDataLogging
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .LogTo(Console.WriteLine)
+            .EnableSensitiveDataLogging();
+    #endregion
+}
+
+public class EnableDetailedErrorsContext : BlogsContext
+{
+    #region EnableDetailedErrors
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .LogTo(Console.WriteLine)
+            .EnableDetailedErrors();
+    #endregion
+}
+
+public class EventIdsContext : BlogsContext
+{
+    #region EventIds
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .LogTo(Console.WriteLine, new[] { CoreEventId.ContextDisposed, CoreEventId.ContextInitialized });
+    #endregion
+}
+
+public class DatabaseCategoryContext : BlogsContext
+{
+    #region DatabaseCategory
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .LogTo(Console.WriteLine, new[] { DbLoggerCategory.Database.Name });
+    #endregion
+}
+
+public class CustomFilterContext : BlogsContext
+{
+    #region CustomFilter
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .LogTo(
+                Console.WriteLine,
+                (eventId, logLevel) => logLevel >= LogLevel.Information
+                                       || eventId == RelationalEventId.ConnectionOpened
+                                       || eventId == RelationalEventId.ConnectionClosed);
+    #endregion
+}
+
+public class UtcContext : BlogsContext
+{
+    #region Utc
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.LogTo(
+            Console.WriteLine,
+            LogLevel.Debug,
+            DbContextLoggerOptions.DefaultWithUtcTime);
+    #endregion
+}
+
+public class SingleLineContext : BlogsContext
+{
+    #region SingleLine
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.LogTo(
+            Console.WriteLine,
+            LogLevel.Debug,
+            DbContextLoggerOptions.DefaultWithLocalTime | DbContextLoggerOptions.SingleLine);
+    #endregion
+}
+
+public class TerseLogsContext : BlogsContext
+{
+    #region TerseLogs
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.LogTo(
+            Console.WriteLine,
+            LogLevel.Debug,
+            DbContextLoggerOptions.UtcTime | DbContextLoggerOptions.SingleLine);
+    #endregion
+}
+
+public class DatabaseLogContext : BlogsContext
+{
+    #region DatabaseLog
+    public Action<string> Log { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.LogTo(s => Log?.Invoke(s));
+    #endregion
+}
+
+public class ChangeLogLevelContext : BlogsContext
+{
+    #region ChangeLogLevel
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .ConfigureWarnings(
+                b => b.Log(
+                    (RelationalEventId.ConnectionOpened, LogLevel.Information),
+                    (RelationalEventId.ConnectionClosed, LogLevel.Information)))
+            .LogTo(Console.WriteLine, LogLevel.Information);
+    #endregion
+}
+
+public class SuppressMessageContext : BlogsContext
+{
+    #region SuppressMessage
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .ConfigureWarnings(b => b.Ignore(CoreEventId.DetachedLazyLoadingWarning))
+            .LogTo(Console.WriteLine);
+    #endregion
+}
+
+public class ThrowForEventContext : BlogsContext
+{
+    #region ThrowForEvent
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .ConfigureWarnings(b => b.Throw(RelationalEventId.MultipleCollectionIncludeWarning))
+            .LogTo(Console.WriteLine);
+    #endregion
+}
diff --git a/samples/core/Miscellaneous/Logging/SimpleLogging/SimpleLogging.csproj b/samples/core/Miscellaneous/Logging/SimpleLogging/SimpleLogging.csproj
new file mode 100755
index 0000000000..249c290541
--- /dev/null
+++ b/samples/core/Miscellaneous/Logging/SimpleLogging/SimpleLogging.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace />
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/Multitenancy/.gitignore b/samples/core/Miscellaneous/Multitenancy/.gitignore
new file mode 100644
index 0000000000..5b5d9bfcb5
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/.gitignore
@@ -0,0 +1 @@
+**/*.sqlite*
diff --git a/samples/core/Miscellaneous/Multitenancy/Common/Common.csproj b/samples/core/Miscellaneous/Multitenancy/Common/Common.csproj
new file mode 100644
index 0000000000..9ed914b5ba
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/Common/Common.csproj
@@ -0,0 +1,9 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/Multitenancy/Common/Contact.cs b/samples/core/Miscellaneous/Multitenancy/Common/Contact.cs
new file mode 100644
index 0000000000..7262834591
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/Common/Contact.cs
@@ -0,0 +1,32 @@
+namespace Common;
+public class Contact
+{
+    public Guid Id { get; set; }
+    public string Name { get; set; } = null!;
+    public bool IsUnicorn {get; set; }
+
+    public static Contact[] GeneratedContacts =>
+    new []
+    {
+        new Contact
+        {
+            Name = "Magic Unicorns",
+            IsUnicorn = true
+        },
+        new Contact
+        {
+            Name =  "Unicorns Running",
+            IsUnicorn = true
+        },
+        new Contact
+        {
+            Name = "SQL Server DBA",
+            IsUnicorn = false
+        },
+        new Contact
+        {
+            Name = "Azure Cosmos DB Admin",
+            IsUnicorn = false
+        }
+    };
+}
diff --git a/samples/core/Miscellaneous/Multitenancy/Common/ITenantService.cs b/samples/core/Miscellaneous/Multitenancy/Common/ITenantService.cs
new file mode 100644
index 0000000000..7a422b0bc9
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/Common/ITenantService.cs
@@ -0,0 +1,13 @@
+namespace Common
+{
+    public interface ITenantService
+    {
+        string Tenant { get; }
+
+        void SetTenant(string tenant);
+
+        string[] GetTenants();
+
+        event TenantChangedEventHandler OnTenantChanged;
+    }
+}
diff --git a/samples/core/Miscellaneous/Multitenancy/Common/TenantChangedEventArgs.cs b/samples/core/Miscellaneous/Multitenancy/Common/TenantChangedEventArgs.cs
new file mode 100644
index 0000000000..09ca2587d4
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/Common/TenantChangedEventArgs.cs
@@ -0,0 +1,15 @@
+namespace Common
+{
+    public class TenantChangedEventArgs : EventArgs
+    {
+        public TenantChangedEventArgs(string? oldTenant, string newTenant)
+        {
+            OldTenant = oldTenant;
+            NewTenant = newTenant;
+        }
+
+        public string? OldTenant { get; private set; }
+
+        public string NewTenant { get; private set; }
+    }
+}
diff --git a/samples/core/Miscellaneous/Multitenancy/Common/TenantService.cs b/samples/core/Miscellaneous/Multitenancy/Common/TenantService.cs
new file mode 100644
index 0000000000..b04e73b0ae
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/Common/TenantService.cs
@@ -0,0 +1,32 @@
+namespace Common
+{
+    public delegate void TenantChangedEventHandler(object source, TenantChangedEventArgs args);
+    public class TenantService : ITenantService
+    {
+        public TenantService() => _tenant = GetTenants()[0];
+
+        public TenantService(string tenant) => _tenant = tenant;
+
+        private string _tenant;
+
+        public event TenantChangedEventHandler OnTenantChanged = null!;
+
+        public string Tenant => _tenant;
+
+        public void SetTenant(string tenant)
+        {
+            if (tenant != _tenant)
+            {
+                var old = _tenant;
+                _tenant = tenant;
+                OnTenantChanged?.Invoke(this, new TenantChangedEventArgs(old, _tenant));
+            }
+        }
+        
+        public string[] GetTenants() => new[]
+        {
+            "TenantA",
+            "TenantB",
+        };
+    }
+}
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/App.razor b/samples/core/Miscellaneous/Multitenancy/MultiDb/App.razor
new file mode 100644
index 0000000000..6fd3ed1b5a
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/App.razor
@@ -0,0 +1,12 @@
+<Router AppAssembly="@typeof(App).Assembly">
+    <Found Context="routeData">
+        <RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
+        <FocusOnNavigate RouteData="@routeData" Selector="h1" />
+    </Found>
+    <NotFound>
+        <PageTitle>Not found</PageTitle>
+        <LayoutView Layout="@typeof(MainLayout)">
+            <p role="alert">Sorry, there's nothing at this address.</p>
+        </LayoutView>
+    </NotFound>
+</Router>
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/ContactContext.cs b/samples/core/Miscellaneous/Multitenancy/MultiDb/ContactContext.cs
new file mode 100644
index 0000000000..4613b0a6f0
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/ContactContext.cs
@@ -0,0 +1,47 @@
+using Common;
+using Microsoft.EntityFrameworkCore;
+
+namespace MultiDb
+{
+    public class ContactContext : DbContext
+    {
+        private readonly ITenantService _tenantService;
+        private readonly IConfiguration _configuration;
+
+        public ContactContext(
+            DbContextOptions<ContactContext> opts,
+            IConfiguration config,
+            ITenantService service)
+            : base(opts)
+        {
+            _tenantService = service;
+            _configuration = config;
+        }
+
+        public DbSet<Contact> Contacts { get; set; } = null!;
+
+        public async Task CheckAndSeed()
+        {
+            if (await Database.EnsureCreatedAsync())
+            {
+                foreach (var contact in Contact.GeneratedContacts)
+                {
+                    var isTenantA = _tenantService.Tenant == "TenantA";
+                    if (isTenantA == contact.IsUnicorn)
+                    {
+                        Contacts.Add(contact);
+                    }
+                }
+
+                await SaveChangesAsync();
+            }
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            var tenant = _tenantService.Tenant;
+            var connectionStr = _configuration.GetConnectionString(tenant);
+            optionsBuilder.UseSqlite(connectionStr);
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/MultiDb.csproj b/samples/core/Miscellaneous/Multitenancy/MultiDb/MultiDb.csproj
new file mode 100644
index 0000000000..d9115c5e82
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/MultiDb.csproj
@@ -0,0 +1,18 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\Common\Common.csproj" />
+    <ProjectReference Include="..\TenantControls\TenantControls.csproj" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/MultiDb.sln b/samples/core/Miscellaneous/Multitenancy/MultiDb/MultiDb.sln
new file mode 100644
index 0000000000..bced37a1b9
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/MultiDb.sln
@@ -0,0 +1,37 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.1.31911.260
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "MultiDb", "MultiDb.csproj", "{A5F0571D-647C-4100-AADF-AECDDF9F02FA}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Common", "..\Common\Common.csproj", "{C2E619F6-2404-429D-8966-DB89D3A29314}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "TenantControls", "..\TenantControls\TenantControls.csproj", "{640C6DAF-5C00-463C-8E54-9D042C6F1C23}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{A5F0571D-647C-4100-AADF-AECDDF9F02FA}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{A5F0571D-647C-4100-AADF-AECDDF9F02FA}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{A5F0571D-647C-4100-AADF-AECDDF9F02FA}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{A5F0571D-647C-4100-AADF-AECDDF9F02FA}.Release|Any CPU.Build.0 = Release|Any CPU
+		{C2E619F6-2404-429D-8966-DB89D3A29314}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{C2E619F6-2404-429D-8966-DB89D3A29314}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{C2E619F6-2404-429D-8966-DB89D3A29314}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{C2E619F6-2404-429D-8966-DB89D3A29314}.Release|Any CPU.Build.0 = Release|Any CPU
+		{640C6DAF-5C00-463C-8E54-9D042C6F1C23}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{640C6DAF-5C00-463C-8E54-9D042C6F1C23}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{640C6DAF-5C00-463C-8E54-9D042C6F1C23}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{640C6DAF-5C00-463C-8E54-9D042C6F1C23}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {8AD843ED-6A67-4384-BC8B-5A39647AB713}
+	EndGlobalSection
+EndGlobal
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/Pages/Error.cshtml b/samples/core/Miscellaneous/Multitenancy/MultiDb/Pages/Error.cshtml
new file mode 100644
index 0000000000..83d9726234
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/Pages/Error.cshtml
@@ -0,0 +1,42 @@
+@page
+@model MultiDb.Pages.ErrorModel
+
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no" />
+    <title>Error</title>
+    <link href="~/css/bootstrap/bootstrap.min.css" rel="stylesheet" />
+    <link href="~/css/site.css" rel="stylesheet" asp-append-version="true" />
+</head>
+
+<body>
+    <div class="main">
+        <div class="content px-4">
+            <h1 class="text-danger">Error.</h1>
+            <h2 class="text-danger">An error occurred while processing your request.</h2>
+
+            @if (Model.ShowRequestId)
+            {
+                <p>
+                    <strong>Request ID:</strong> <code>@Model.RequestId</code>
+                </p>
+            }
+
+            <h3>Development Mode</h3>
+            <p>
+                Swapping to the <strong>Development</strong> environment displays detailed information about the error that occurred.
+            </p>
+            <p>
+                <strong>The Development environment shouldn't be enabled for deployed applications.</strong>
+                It can result in displaying sensitive information from exceptions to end users.
+                For local debugging, enable the <strong>Development</strong> environment by setting the <strong>ASPNETCORE_ENVIRONMENT</strong> environment variable to <strong>Development</strong>
+                and restarting the app.
+            </p>
+        </div>
+    </div>
+</body>
+
+</html>
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/Pages/Error.cshtml.cs b/samples/core/Miscellaneous/Multitenancy/MultiDb/Pages/Error.cshtml.cs
new file mode 100644
index 0000000000..fea18238b2
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/Pages/Error.cshtml.cs
@@ -0,0 +1,26 @@
+using System.Diagnostics;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.AspNetCore.Mvc.RazorPages;
+
+namespace MultiDb.Pages;
+
+[ResponseCache(Duration = 0, Location = ResponseCacheLocation.None, NoStore = true)]
+[IgnoreAntiforgeryToken]
+public class ErrorModel : PageModel
+{
+    public string? RequestId { get; set; }
+
+    public bool ShowRequestId => !string.IsNullOrEmpty(RequestId);
+
+    private readonly ILogger<ErrorModel> _logger;
+
+    public ErrorModel(ILogger<ErrorModel> logger)
+    {
+        _logger = logger;
+    }
+
+    public void OnGet()
+    {
+        RequestId = Activity.Current?.Id ?? HttpContext.TraceIdentifier;
+    }
+}
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/Pages/Index.razor b/samples/core/Miscellaneous/Multitenancy/MultiDb/Pages/Index.razor
new file mode 100644
index 0000000000..8a891f2a32
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/Pages/Index.razor
@@ -0,0 +1,21 @@
+@page "/"
+
+@using Common
+@using Microsoft.EntityFrameworkCore
+@using TenantControls
+
+@inject ITenantService Service
+@inject IDbContextFactory<ContactContext> Factory
+
+<PageTitle>Contacts for @Service.Tenant</PageTitle>
+
+<ContactList FetchContacts="RefreshContacts"/>
+
+@code {
+
+    private List<Contact> RefreshContacts()
+    {
+        using var ctx = Factory.CreateDbContext();
+        return new List<Contact>(ctx.Contacts);
+    }
+}
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/Pages/_Host.cshtml b/samples/core/Miscellaneous/Multitenancy/MultiDb/Pages/_Host.cshtml
new file mode 100644
index 0000000000..c754e42ae5
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/Pages/_Host.cshtml
@@ -0,0 +1,8 @@
+@page "/"
+@namespace MultiDb.Pages
+@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers
+@{
+    Layout = "_Layout";
+}
+
+<component type="typeof(App)" render-mode="ServerPrerendered" />
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/Pages/_Layout.cshtml b/samples/core/Miscellaneous/Multitenancy/MultiDb/Pages/_Layout.cshtml
new file mode 100644
index 0000000000..02e7454a4a
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/Pages/_Layout.cshtml
@@ -0,0 +1,32 @@
+@using Microsoft.AspNetCore.Components.Web
+@namespace MultiDb.Pages
+@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers
+
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <base href="~/" />
+    <link rel="stylesheet" href="css/bootstrap/bootstrap.min.css" />
+    <link href="css/site.css" rel="stylesheet" />
+    <link href="MultiDb.styles.css" rel="stylesheet" />
+    <component type="typeof(HeadOutlet)" render-mode="ServerPrerendered" />
+</head>
+<body>
+    @RenderBody()
+
+    <div id="blazor-error-ui">
+        <environment include="Staging,Production">
+            An error has occurred. This application may no longer respond until reloaded.
+        </environment>
+        <environment include="Development">
+            An unhandled exception has occurred. See browser dev tools for details.
+        </environment>
+        <a href="" class="reload">Reload</a>
+        <a class="dismiss">🗙</a>
+    </div>
+
+    <script src="_framework/blazor.server.js"></script>
+</body>
+</html>
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/Program.cs b/samples/core/Miscellaneous/Multitenancy/MultiDb/Program.cs
new file mode 100644
index 0000000000..2404cfad07
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/Program.cs
@@ -0,0 +1,48 @@
+using Common;
+using Microsoft.AspNetCore.Components;
+using Microsoft.AspNetCore.Components.Web;
+using Microsoft.EntityFrameworkCore;
+using MultiDb;
+
+var builder = WebApplication.CreateBuilder(args);
+
+// Add services to the container.
+builder.Services.AddRazorPages();
+builder.Services.AddServerSideBlazor();
+builder.Services.AddScoped<ITenantService, TenantService>();
+builder.Services.AddDbContextFactory<ContactContext>(opt => { }, ServiceLifetime.Scoped);
+
+var app = builder.Build();
+
+// just for demo to avoid migrations, don't do this in production
+var provider = app.Services.CreateScope().ServiceProvider;
+var tenantService = provider.GetService<ITenantService>();
+var factory = provider.GetService<IDbContextFactory<ContactContext>>();
+if (tenantService != null && factory != null)
+{
+    foreach (var tenant in tenantService.GetTenants())
+    {
+        tenantService.SetTenant(tenant);
+        using var ctx = factory.CreateDbContext();
+        await ctx.CheckAndSeed();
+    }
+}
+
+// Configure the HTTP request pipeline.
+if (!app.Environment.IsDevelopment())
+{
+    app.UseExceptionHandler("/Error");
+    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
+    app.UseHsts();
+}
+
+app.UseHttpsRedirection();
+
+app.UseStaticFiles();
+
+app.UseRouting();
+
+app.MapBlazorHub();
+app.MapFallbackToPage("/_Host");
+
+app.Run();
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/Properties/launchSettings.json b/samples/core/Miscellaneous/Multitenancy/MultiDb/Properties/launchSettings.json
new file mode 100644
index 0000000000..0ae2ccadcf
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/Properties/launchSettings.json
@@ -0,0 +1,12 @@
+{
+  "profiles": {
+    "MultiDb": {
+      "commandName": "Project",
+      "launchBrowser": true,
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      },
+      "applicationUrl": "https://localhost:58210;http://localhost:58219"
+    }
+  }
+}
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/Shared/MainLayout.razor b/samples/core/Miscellaneous/Multitenancy/MultiDb/Shared/MainLayout.razor
new file mode 100644
index 0000000000..780fd6d2cc
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/Shared/MainLayout.razor
@@ -0,0 +1,19 @@
+@inherits LayoutComponentBase
+
+<PageTitle>MultiDb</PageTitle>
+
+<div class="page">
+    <div class="sidebar">
+        <NavMenu />
+    </div>
+
+    <main>
+        <div class="top-row px-4">
+            <a href="https://docs.microsoft.com/aspnet/" target="_blank">About</a>
+        </div>
+
+        <article class="content px-4">
+            @Body
+        </article>
+    </main>
+</div>
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/Shared/MainLayout.razor.css b/samples/core/Miscellaneous/Multitenancy/MultiDb/Shared/MainLayout.razor.css
new file mode 100644
index 0000000000..551e4b2767
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/Shared/MainLayout.razor.css
@@ -0,0 +1,70 @@
+.page {
+    position: relative;
+    display: flex;
+    flex-direction: column;
+}
+
+main {
+    flex: 1;
+}
+
+.sidebar {
+    background-image: linear-gradient(180deg, rgb(5, 39, 103) 0%, #3a0647 70%);
+}
+
+.top-row {
+    background-color: #f7f7f7;
+    border-bottom: 1px solid #d6d5d5;
+    justify-content: flex-end;
+    height: 3.5rem;
+    display: flex;
+    align-items: center;
+}
+
+    .top-row ::deep a, .top-row .btn-link {
+        white-space: nowrap;
+        margin-left: 1.5rem;
+    }
+
+    .top-row a:first-child {
+        overflow: hidden;
+        text-overflow: ellipsis;
+    }
+
+@media (max-width: 640.98px) {
+    .top-row:not(.auth) {
+        display: none;
+    }
+
+    .top-row.auth {
+        justify-content: space-between;
+    }
+
+    .top-row a, .top-row .btn-link {
+        margin-left: 0;
+    }
+}
+
+@media (min-width: 641px) {
+    .page {
+        flex-direction: row;
+    }
+
+    .sidebar {
+        width: 250px;
+        height: 100vh;
+        position: sticky;
+        top: 0;
+    }
+
+    .top-row {
+        position: sticky;
+        top: 0;
+        z-index: 1;
+    }
+
+    .top-row, article {
+        padding-left: 2rem !important;
+        padding-right: 1.5rem !important;
+    }
+}
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/Shared/NavMenu.razor b/samples/core/Miscellaneous/Multitenancy/MultiDb/Shared/NavMenu.razor
new file mode 100644
index 0000000000..a011a605fb
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/Shared/NavMenu.razor
@@ -0,0 +1,36 @@
+@using TenantControls
+<div class="top-row ps-3 navbar navbar-dark">
+    <div class="container-fluid">
+        <a class="navbar-brand" href="">Multiple Databases</a>
+        <TenantDisplay TenantClass="white"/>
+        <button title="Navigation menu" class="navbar-toggler" @onclick="ToggleNavMenu">
+            <span class="navbar-toggler-icon"></span>
+        </button>
+    </div>
+</div>
+
+<div class="@NavMenuCssClass" @onclick="ToggleNavMenu">
+    <nav class="flex-column">
+        <div class="nav-item px-3">
+            <NavLink class="nav-link" href="" Match="NavLinkMatch.All">
+                <span class="oi oi-home" aria-hidden="true"></span> Home
+            </NavLink>
+        </div>
+    </nav>
+    <nav class="flex-column">
+        <div class="nav-item px-3">
+            <TenantPicker/>
+        </div>
+    </nav>        
+</div>
+
+@code {
+    private bool collapseNavMenu = true;
+
+    private string? NavMenuCssClass => collapseNavMenu ? "collapse" : null;
+
+    private void ToggleNavMenu()
+    {
+        collapseNavMenu = !collapseNavMenu;
+    }
+}
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/Shared/NavMenu.razor.css b/samples/core/Miscellaneous/Multitenancy/MultiDb/Shared/NavMenu.razor.css
new file mode 100644
index 0000000000..acc5f9f819
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/Shared/NavMenu.razor.css
@@ -0,0 +1,62 @@
+.navbar-toggler {
+    background-color: rgba(255, 255, 255, 0.1);
+}
+
+.top-row {
+    height: 3.5rem;
+    background-color: rgba(0,0,0,0.4);
+}
+
+.navbar-brand {
+    font-size: 1.1rem;
+}
+
+.oi {
+    width: 2rem;
+    font-size: 1.1rem;
+    vertical-align: text-top;
+    top: -2px;
+}
+
+.nav-item {
+    font-size: 0.9rem;
+    padding-bottom: 0.5rem;
+}
+
+    .nav-item:first-of-type {
+        padding-top: 1rem;
+    }
+
+    .nav-item:last-of-type {
+        padding-bottom: 1rem;
+    }
+
+    .nav-item ::deep a {
+        color: #d7d7d7;
+        border-radius: 4px;
+        height: 3rem;
+        display: flex;
+        align-items: center;
+        line-height: 3rem;
+    }
+
+.nav-item ::deep a.active {
+    background-color: rgba(255,255,255,0.25);
+    color: white;
+}
+
+.nav-item ::deep a:hover {
+    background-color: rgba(255,255,255,0.1);
+    color: white;
+}
+
+@media (min-width: 641px) {
+    .navbar-toggler {
+        display: none;
+    }
+
+    .collapse {
+        /* Never collapse the sidebar for wide screens */
+        display: block;
+    }
+}
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/_Imports.razor b/samples/core/Miscellaneous/Multitenancy/MultiDb/_Imports.razor
new file mode 100644
index 0000000000..5ff9e8522e
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/_Imports.razor
@@ -0,0 +1,10 @@
+@using System.Net.Http
+@using Microsoft.AspNetCore.Authorization
+@using Microsoft.AspNetCore.Components.Authorization
+@using Microsoft.AspNetCore.Components.Forms
+@using Microsoft.AspNetCore.Components.Routing
+@using Microsoft.AspNetCore.Components.Web
+@using Microsoft.AspNetCore.Components.Web.Virtualization
+@using Microsoft.JSInterop
+@using MultiDb
+@using MultiDb.Shared
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/appsettings.Development.json b/samples/core/Miscellaneous/Multitenancy/MultiDb/appsettings.Development.json
new file mode 100644
index 0000000000..770d3e9314
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/appsettings.Development.json
@@ -0,0 +1,9 @@
+{
+  "DetailedErrors": true,
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  }
+}
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/appsettings.json b/samples/core/Miscellaneous/Multitenancy/MultiDb/appsettings.json
new file mode 100644
index 0000000000..52af83a97a
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/appsettings.json
@@ -0,0 +1,13 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  },
+  "ConnectionStrings": {
+    "TenantA": "Data Source=tenantacontacts.sqlite",
+    "TenantB": "Data Source=tenantbcontacts.sqlite"
+  },
+  "AllowedHosts": "*"
+}
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/bootstrap/bootstrap.min.css b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/bootstrap/bootstrap.min.css
new file mode 100644
index 0000000000..02ae65b5fe
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/bootstrap/bootstrap.min.css
@@ -0,0 +1,7 @@
+@charset "UTF-8";/*!
+ * Bootstrap v5.1.0 (https://getbootstrap.com/)
+ * Copyright 2011-2021 The Bootstrap Authors
+ * Copyright 2011-2021 Twitter, Inc.
+ * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)
+ */:root{--bs-blue:#0d6efd;--bs-indigo:#6610f2;--bs-purple:#6f42c1;--bs-pink:#d63384;--bs-red:#dc3545;--bs-orange:#fd7e14;--bs-yellow:#ffc107;--bs-green:#198754;--bs-teal:#20c997;--bs-cyan:#0dcaf0;--bs-white:#fff;--bs-gray:#6c757d;--bs-gray-dark:#343a40;--bs-gray-100:#f8f9fa;--bs-gray-200:#e9ecef;--bs-gray-300:#dee2e6;--bs-gray-400:#ced4da;--bs-gray-500:#adb5bd;--bs-gray-600:#6c757d;--bs-gray-700:#495057;--bs-gray-800:#343a40;--bs-gray-900:#212529;--bs-primary:#0d6efd;--bs-secondary:#6c757d;--bs-success:#198754;--bs-info:#0dcaf0;--bs-warning:#ffc107;--bs-danger:#dc3545;--bs-light:#f8f9fa;--bs-dark:#212529;--bs-primary-rgb:13,110,253;--bs-secondary-rgb:108,117,125;--bs-success-rgb:25,135,84;--bs-info-rgb:13,202,240;--bs-warning-rgb:255,193,7;--bs-danger-rgb:220,53,69;--bs-light-rgb:248,249,250;--bs-dark-rgb:33,37,41;--bs-white-rgb:255,255,255;--bs-black-rgb:0,0,0;--bs-body-rgb:33,37,41;--bs-font-sans-serif:system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,"Noto Sans","Liberation Sans",sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";--bs-font-monospace:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace;--bs-gradient:linear-gradient(180deg, rgba(255, 255, 255, 0.15), rgba(255, 255, 255, 0));--bs-body-font-family:var(--bs-font-sans-serif);--bs-body-font-size:1rem;--bs-body-font-weight:400;--bs-body-line-height:1.5;--bs-body-color:#212529;--bs-body-bg:#fff}*,::after,::before{box-sizing:border-box}@media (prefers-reduced-motion:no-preference){:root{scroll-behavior:smooth}}body{margin:0;font-family:var(--bs-body-font-family);font-size:var(--bs-body-font-size);font-weight:var(--bs-body-font-weight);line-height:var(--bs-body-line-height);color:var(--bs-body-color);text-align:var(--bs-body-text-align);background-color:var(--bs-body-bg);-webkit-text-size-adjust:100%;-webkit-tap-highlight-color:transparent}hr{margin:1rem 0;color:inherit;background-color:currentColor;border:0;opacity:.25}hr:not([size]){height:1px}.h1,.h2,.h3,.h4,.h5,.h6,h1,h2,h3,h4,h5,h6{margin-top:0;margin-bottom:.5rem;font-weight:500;line-height:1.2}.h1,h1{font-size:calc(1.375rem + 1.5vw)}@media (min-width:1200px){.h1,h1{font-size:2.5rem}}.h2,h2{font-size:calc(1.325rem + .9vw)}@media (min-width:1200px){.h2,h2{font-size:2rem}}.h3,h3{font-size:calc(1.3rem + .6vw)}@media (min-width:1200px){.h3,h3{font-size:1.75rem}}.h4,h4{font-size:calc(1.275rem + .3vw)}@media (min-width:1200px){.h4,h4{font-size:1.5rem}}.h5,h5{font-size:1.25rem}.h6,h6{font-size:1rem}p{margin-top:0;margin-bottom:1rem}abbr[data-bs-original-title],abbr[title]{-webkit-text-decoration:underline dotted;text-decoration:underline dotted;cursor:help;-webkit-text-decoration-skip-ink:none;text-decoration-skip-ink:none}address{margin-bottom:1rem;font-style:normal;line-height:inherit}ol,ul{padding-left:2rem}dl,ol,ul{margin-top:0;margin-bottom:1rem}ol ol,ol ul,ul ol,ul ul{margin-bottom:0}dt{font-weight:700}dd{margin-bottom:.5rem;margin-left:0}blockquote{margin:0 0 1rem}b,strong{font-weight:bolder}.small,small{font-size:.875em}.mark,mark{padding:.2em;background-color:#fcf8e3}sub,sup{position:relative;font-size:.75em;line-height:0;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}a{color:#0d6efd;text-decoration:underline}a:hover{color:#0a58ca}a:not([href]):not([class]),a:not([href]):not([class]):hover{color:inherit;text-decoration:none}code,kbd,pre,samp{font-family:var(--bs-font-monospace);font-size:1em;direction:ltr;unicode-bidi:bidi-override}pre{display:block;margin-top:0;margin-bottom:1rem;overflow:auto;font-size:.875em}pre code{font-size:inherit;color:inherit;word-break:normal}code{font-size:.875em;color:#d63384;word-wrap:break-word}a>code{color:inherit}kbd{padding:.2rem .4rem;font-size:.875em;color:#fff;background-color:#212529;border-radius:.2rem}kbd kbd{padding:0;font-size:1em;font-weight:700}figure{margin:0 0 1rem}img,svg{vertical-align:middle}table{caption-side:bottom;border-collapse:collapse}caption{padding-top:.5rem;padding-bottom:.5rem;color:#6c757d;text-align:left}th{text-align:inherit;text-align:-webkit-match-parent}tbody,td,tfoot,th,thead,tr{border-color:inherit;border-style:solid;border-width:0}label{display:inline-block}button{border-radius:0}button:focus:not(:focus-visible){outline:0}button,input,optgroup,select,textarea{margin:0;font-family:inherit;font-size:inherit;line-height:inherit}button,select{text-transform:none}[role=button]{cursor:pointer}select{word-wrap:normal}select:disabled{opacity:1}[list]::-webkit-calendar-picker-indicator{display:none}[type=button],[type=reset],[type=submit],button{-webkit-appearance:button}[type=button]:not(:disabled),[type=reset]:not(:disabled),[type=submit]:not(:disabled),button:not(:disabled){cursor:pointer}::-moz-focus-inner{padding:0;border-style:none}textarea{resize:vertical}fieldset{min-width:0;padding:0;margin:0;border:0}legend{float:left;width:100%;padding:0;margin-bottom:.5rem;font-size:calc(1.275rem + .3vw);line-height:inherit}@media (min-width:1200px){legend{font-size:1.5rem}}legend+*{clear:left}::-webkit-datetime-edit-day-field,::-webkit-datetime-edit-fields-wrapper,::-webkit-datetime-edit-hour-field,::-webkit-datetime-edit-minute,::-webkit-datetime-edit-month-field,::-webkit-datetime-edit-text,::-webkit-datetime-edit-year-field{padding:0}::-webkit-inner-spin-button{height:auto}[type=search]{outline-offset:-2px;-webkit-appearance:textfield}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-color-swatch-wrapper{padding:0}::file-selector-button{font:inherit}::-webkit-file-upload-button{font:inherit;-webkit-appearance:button}output{display:inline-block}iframe{border:0}summary{display:list-item;cursor:pointer}progress{vertical-align:baseline}[hidden]{display:none!important}.lead{font-size:1.25rem;font-weight:300}.display-1{font-size:calc(1.625rem + 4.5vw);font-weight:300;line-height:1.2}@media (min-width:1200px){.display-1{font-size:5rem}}.display-2{font-size:calc(1.575rem + 3.9vw);font-weight:300;line-height:1.2}@media (min-width:1200px){.display-2{font-size:4.5rem}}.display-3{font-size:calc(1.525rem + 3.3vw);font-weight:300;line-height:1.2}@media (min-width:1200px){.display-3{font-size:4rem}}.display-4{font-size:calc(1.475rem + 2.7vw);font-weight:300;line-height:1.2}@media (min-width:1200px){.display-4{font-size:3.5rem}}.display-5{font-size:calc(1.425rem + 2.1vw);font-weight:300;line-height:1.2}@media (min-width:1200px){.display-5{font-size:3rem}}.display-6{font-size:calc(1.375rem + 1.5vw);font-weight:300;line-height:1.2}@media (min-width:1200px){.display-6{font-size:2.5rem}}.list-unstyled{padding-left:0;list-style:none}.list-inline{padding-left:0;list-style:none}.list-inline-item{display:inline-block}.list-inline-item:not(:last-child){margin-right:.5rem}.initialism{font-size:.875em;text-transform:uppercase}.blockquote{margin-bottom:1rem;font-size:1.25rem}.blockquote>:last-child{margin-bottom:0}.blockquote-footer{margin-top:-1rem;margin-bottom:1rem;font-size:.875em;color:#6c757d}.blockquote-footer::before{content:"— "}.img-fluid{max-width:100%;height:auto}.img-thumbnail{padding:.25rem;background-color:#fff;border:1px solid #dee2e6;border-radius:.25rem;max-width:100%;height:auto}.figure{display:inline-block}.figure-img{margin-bottom:.5rem;line-height:1}.figure-caption{font-size:.875em;color:#6c757d}.container,.container-fluid,.container-lg,.container-md,.container-sm,.container-xl,.container-xxl{width:100%;padding-right:var(--bs-gutter-x,.75rem);padding-left:var(--bs-gutter-x,.75rem);margin-right:auto;margin-left:auto}@media (min-width:576px){.container,.container-sm{max-width:540px}}@media (min-width:768px){.container,.container-md,.container-sm{max-width:720px}}@media (min-width:992px){.container,.container-lg,.container-md,.container-sm{max-width:960px}}@media (min-width:1200px){.container,.container-lg,.container-md,.container-sm,.container-xl{max-width:1140px}}@media (min-width:1400px){.container,.container-lg,.container-md,.container-sm,.container-xl,.container-xxl{max-width:1320px}}.row{--bs-gutter-x:1.5rem;--bs-gutter-y:0;display:flex;flex-wrap:wrap;margin-top:calc(var(--bs-gutter-y) * -1);margin-right:calc(var(--bs-gutter-x) * -.5);margin-left:calc(var(--bs-gutter-x) * -.5)}.row>*{flex-shrink:0;width:100%;max-width:100%;padding-right:calc(var(--bs-gutter-x) * .5);padding-left:calc(var(--bs-gutter-x) * .5);margin-top:var(--bs-gutter-y)}.col{flex:1 0 0%}.row-cols-auto>*{flex:0 0 auto;width:auto}.row-cols-1>*{flex:0 0 auto;width:100%}.row-cols-2>*{flex:0 0 auto;width:50%}.row-cols-3>*{flex:0 0 auto;width:33.3333333333%}.row-cols-4>*{flex:0 0 auto;width:25%}.row-cols-5>*{flex:0 0 auto;width:20%}.row-cols-6>*{flex:0 0 auto;width:16.6666666667%}.col-auto{flex:0 0 auto;width:auto}.col-1{flex:0 0 auto;width:8.33333333%}.col-2{flex:0 0 auto;width:16.66666667%}.col-3{flex:0 0 auto;width:25%}.col-4{flex:0 0 auto;width:33.33333333%}.col-5{flex:0 0 auto;width:41.66666667%}.col-6{flex:0 0 auto;width:50%}.col-7{flex:0 0 auto;width:58.33333333%}.col-8{flex:0 0 auto;width:66.66666667%}.col-9{flex:0 0 auto;width:75%}.col-10{flex:0 0 auto;width:83.33333333%}.col-11{flex:0 0 auto;width:91.66666667%}.col-12{flex:0 0 auto;width:100%}.offset-1{margin-left:8.33333333%}.offset-2{margin-left:16.66666667%}.offset-3{margin-left:25%}.offset-4{margin-left:33.33333333%}.offset-5{margin-left:41.66666667%}.offset-6{margin-left:50%}.offset-7{margin-left:58.33333333%}.offset-8{margin-left:66.66666667%}.offset-9{margin-left:75%}.offset-10{margin-left:83.33333333%}.offset-11{margin-left:91.66666667%}.g-0,.gx-0{--bs-gutter-x:0}.g-0,.gy-0{--bs-gutter-y:0}.g-1,.gx-1{--bs-gutter-x:0.25rem}.g-1,.gy-1{--bs-gutter-y:0.25rem}.g-2,.gx-2{--bs-gutter-x:0.5rem}.g-2,.gy-2{--bs-gutter-y:0.5rem}.g-3,.gx-3{--bs-gutter-x:1rem}.g-3,.gy-3{--bs-gutter-y:1rem}.g-4,.gx-4{--bs-gutter-x:1.5rem}.g-4,.gy-4{--bs-gutter-y:1.5rem}.g-5,.gx-5{--bs-gutter-x:3rem}.g-5,.gy-5{--bs-gutter-y:3rem}@media (min-width:576px){.col-sm{flex:1 0 0%}.row-cols-sm-auto>*{flex:0 0 auto;width:auto}.row-cols-sm-1>*{flex:0 0 auto;width:100%}.row-cols-sm-2>*{flex:0 0 auto;width:50%}.row-cols-sm-3>*{flex:0 0 auto;width:33.3333333333%}.row-cols-sm-4>*{flex:0 0 auto;width:25%}.row-cols-sm-5>*{flex:0 0 auto;width:20%}.row-cols-sm-6>*{flex:0 0 auto;width:16.6666666667%}.col-sm-auto{flex:0 0 auto;width:auto}.col-sm-1{flex:0 0 auto;width:8.33333333%}.col-sm-2{flex:0 0 auto;width:16.66666667%}.col-sm-3{flex:0 0 auto;width:25%}.col-sm-4{flex:0 0 auto;width:33.33333333%}.col-sm-5{flex:0 0 auto;width:41.66666667%}.col-sm-6{flex:0 0 auto;width:50%}.col-sm-7{flex:0 0 auto;width:58.33333333%}.col-sm-8{flex:0 0 auto;width:66.66666667%}.col-sm-9{flex:0 0 auto;width:75%}.col-sm-10{flex:0 0 auto;width:83.33333333%}.col-sm-11{flex:0 0 auto;width:91.66666667%}.col-sm-12{flex:0 0 auto;width:100%}.offset-sm-0{margin-left:0}.offset-sm-1{margin-left:8.33333333%}.offset-sm-2{margin-left:16.66666667%}.offset-sm-3{margin-left:25%}.offset-sm-4{margin-left:33.33333333%}.offset-sm-5{margin-left:41.66666667%}.offset-sm-6{margin-left:50%}.offset-sm-7{margin-left:58.33333333%}.offset-sm-8{margin-left:66.66666667%}.offset-sm-9{margin-left:75%}.offset-sm-10{margin-left:83.33333333%}.offset-sm-11{margin-left:91.66666667%}.g-sm-0,.gx-sm-0{--bs-gutter-x:0}.g-sm-0,.gy-sm-0{--bs-gutter-y:0}.g-sm-1,.gx-sm-1{--bs-gutter-x:0.25rem}.g-sm-1,.gy-sm-1{--bs-gutter-y:0.25rem}.g-sm-2,.gx-sm-2{--bs-gutter-x:0.5rem}.g-sm-2,.gy-sm-2{--bs-gutter-y:0.5rem}.g-sm-3,.gx-sm-3{--bs-gutter-x:1rem}.g-sm-3,.gy-sm-3{--bs-gutter-y:1rem}.g-sm-4,.gx-sm-4{--bs-gutter-x:1.5rem}.g-sm-4,.gy-sm-4{--bs-gutter-y:1.5rem}.g-sm-5,.gx-sm-5{--bs-gutter-x:3rem}.g-sm-5,.gy-sm-5{--bs-gutter-y:3rem}}@media (min-width:768px){.col-md{flex:1 0 0%}.row-cols-md-auto>*{flex:0 0 auto;width:auto}.row-cols-md-1>*{flex:0 0 auto;width:100%}.row-cols-md-2>*{flex:0 0 auto;width:50%}.row-cols-md-3>*{flex:0 0 auto;width:33.3333333333%}.row-cols-md-4>*{flex:0 0 auto;width:25%}.row-cols-md-5>*{flex:0 0 auto;width:20%}.row-cols-md-6>*{flex:0 0 auto;width:16.6666666667%}.col-md-auto{flex:0 0 auto;width:auto}.col-md-1{flex:0 0 auto;width:8.33333333%}.col-md-2{flex:0 0 auto;width:16.66666667%}.col-md-3{flex:0 0 auto;width:25%}.col-md-4{flex:0 0 auto;width:33.33333333%}.col-md-5{flex:0 0 auto;width:41.66666667%}.col-md-6{flex:0 0 auto;width:50%}.col-md-7{flex:0 0 auto;width:58.33333333%}.col-md-8{flex:0 0 auto;width:66.66666667%}.col-md-9{flex:0 0 auto;width:75%}.col-md-10{flex:0 0 auto;width:83.33333333%}.col-md-11{flex:0 0 auto;width:91.66666667%}.col-md-12{flex:0 0 auto;width:100%}.offset-md-0{margin-left:0}.offset-md-1{margin-left:8.33333333%}.offset-md-2{margin-left:16.66666667%}.offset-md-3{margin-left:25%}.offset-md-4{margin-left:33.33333333%}.offset-md-5{margin-left:41.66666667%}.offset-md-6{margin-left:50%}.offset-md-7{margin-left:58.33333333%}.offset-md-8{margin-left:66.66666667%}.offset-md-9{margin-left:75%}.offset-md-10{margin-left:83.33333333%}.offset-md-11{margin-left:91.66666667%}.g-md-0,.gx-md-0{--bs-gutter-x:0}.g-md-0,.gy-md-0{--bs-gutter-y:0}.g-md-1,.gx-md-1{--bs-gutter-x:0.25rem}.g-md-1,.gy-md-1{--bs-gutter-y:0.25rem}.g-md-2,.gx-md-2{--bs-gutter-x:0.5rem}.g-md-2,.gy-md-2{--bs-gutter-y:0.5rem}.g-md-3,.gx-md-3{--bs-gutter-x:1rem}.g-md-3,.gy-md-3{--bs-gutter-y:1rem}.g-md-4,.gx-md-4{--bs-gutter-x:1.5rem}.g-md-4,.gy-md-4{--bs-gutter-y:1.5rem}.g-md-5,.gx-md-5{--bs-gutter-x:3rem}.g-md-5,.gy-md-5{--bs-gutter-y:3rem}}@media (min-width:992px){.col-lg{flex:1 0 0%}.row-cols-lg-auto>*{flex:0 0 auto;width:auto}.row-cols-lg-1>*{flex:0 0 auto;width:100%}.row-cols-lg-2>*{flex:0 0 auto;width:50%}.row-cols-lg-3>*{flex:0 0 auto;width:33.3333333333%}.row-cols-lg-4>*{flex:0 0 auto;width:25%}.row-cols-lg-5>*{flex:0 0 auto;width:20%}.row-cols-lg-6>*{flex:0 0 auto;width:16.6666666667%}.col-lg-auto{flex:0 0 auto;width:auto}.col-lg-1{flex:0 0 auto;width:8.33333333%}.col-lg-2{flex:0 0 auto;width:16.66666667%}.col-lg-3{flex:0 0 auto;width:25%}.col-lg-4{flex:0 0 auto;width:33.33333333%}.col-lg-5{flex:0 0 auto;width:41.66666667%}.col-lg-6{flex:0 0 auto;width:50%}.col-lg-7{flex:0 0 auto;width:58.33333333%}.col-lg-8{flex:0 0 auto;width:66.66666667%}.col-lg-9{flex:0 0 auto;width:75%}.col-lg-10{flex:0 0 auto;width:83.33333333%}.col-lg-11{flex:0 0 auto;width:91.66666667%}.col-lg-12{flex:0 0 auto;width:100%}.offset-lg-0{margin-left:0}.offset-lg-1{margin-left:8.33333333%}.offset-lg-2{margin-left:16.66666667%}.offset-lg-3{margin-left:25%}.offset-lg-4{margin-left:33.33333333%}.offset-lg-5{margin-left:41.66666667%}.offset-lg-6{margin-left:50%}.offset-lg-7{margin-left:58.33333333%}.offset-lg-8{margin-left:66.66666667%}.offset-lg-9{margin-left:75%}.offset-lg-10{margin-left:83.33333333%}.offset-lg-11{margin-left:91.66666667%}.g-lg-0,.gx-lg-0{--bs-gutter-x:0}.g-lg-0,.gy-lg-0{--bs-gutter-y:0}.g-lg-1,.gx-lg-1{--bs-gutter-x:0.25rem}.g-lg-1,.gy-lg-1{--bs-gutter-y:0.25rem}.g-lg-2,.gx-lg-2{--bs-gutter-x:0.5rem}.g-lg-2,.gy-lg-2{--bs-gutter-y:0.5rem}.g-lg-3,.gx-lg-3{--bs-gutter-x:1rem}.g-lg-3,.gy-lg-3{--bs-gutter-y:1rem}.g-lg-4,.gx-lg-4{--bs-gutter-x:1.5rem}.g-lg-4,.gy-lg-4{--bs-gutter-y:1.5rem}.g-lg-5,.gx-lg-5{--bs-gutter-x:3rem}.g-lg-5,.gy-lg-5{--bs-gutter-y:3rem}}@media (min-width:1200px){.col-xl{flex:1 0 0%}.row-cols-xl-auto>*{flex:0 0 auto;width:auto}.row-cols-xl-1>*{flex:0 0 auto;width:100%}.row-cols-xl-2>*{flex:0 0 auto;width:50%}.row-cols-xl-3>*{flex:0 0 auto;width:33.3333333333%}.row-cols-xl-4>*{flex:0 0 auto;width:25%}.row-cols-xl-5>*{flex:0 0 auto;width:20%}.row-cols-xl-6>*{flex:0 0 auto;width:16.6666666667%}.col-xl-auto{flex:0 0 auto;width:auto}.col-xl-1{flex:0 0 auto;width:8.33333333%}.col-xl-2{flex:0 0 auto;width:16.66666667%}.col-xl-3{flex:0 0 auto;width:25%}.col-xl-4{flex:0 0 auto;width:33.33333333%}.col-xl-5{flex:0 0 auto;width:41.66666667%}.col-xl-6{flex:0 0 auto;width:50%}.col-xl-7{flex:0 0 auto;width:58.33333333%}.col-xl-8{flex:0 0 auto;width:66.66666667%}.col-xl-9{flex:0 0 auto;width:75%}.col-xl-10{flex:0 0 auto;width:83.33333333%}.col-xl-11{flex:0 0 auto;width:91.66666667%}.col-xl-12{flex:0 0 auto;width:100%}.offset-xl-0{margin-left:0}.offset-xl-1{margin-left:8.33333333%}.offset-xl-2{margin-left:16.66666667%}.offset-xl-3{margin-left:25%}.offset-xl-4{margin-left:33.33333333%}.offset-xl-5{margin-left:41.66666667%}.offset-xl-6{margin-left:50%}.offset-xl-7{margin-left:58.33333333%}.offset-xl-8{margin-left:66.66666667%}.offset-xl-9{margin-left:75%}.offset-xl-10{margin-left:83.33333333%}.offset-xl-11{margin-left:91.66666667%}.g-xl-0,.gx-xl-0{--bs-gutter-x:0}.g-xl-0,.gy-xl-0{--bs-gutter-y:0}.g-xl-1,.gx-xl-1{--bs-gutter-x:0.25rem}.g-xl-1,.gy-xl-1{--bs-gutter-y:0.25rem}.g-xl-2,.gx-xl-2{--bs-gutter-x:0.5rem}.g-xl-2,.gy-xl-2{--bs-gutter-y:0.5rem}.g-xl-3,.gx-xl-3{--bs-gutter-x:1rem}.g-xl-3,.gy-xl-3{--bs-gutter-y:1rem}.g-xl-4,.gx-xl-4{--bs-gutter-x:1.5rem}.g-xl-4,.gy-xl-4{--bs-gutter-y:1.5rem}.g-xl-5,.gx-xl-5{--bs-gutter-x:3rem}.g-xl-5,.gy-xl-5{--bs-gutter-y:3rem}}@media (min-width:1400px){.col-xxl{flex:1 0 0%}.row-cols-xxl-auto>*{flex:0 0 auto;width:auto}.row-cols-xxl-1>*{flex:0 0 auto;width:100%}.row-cols-xxl-2>*{flex:0 0 auto;width:50%}.row-cols-xxl-3>*{flex:0 0 auto;width:33.3333333333%}.row-cols-xxl-4>*{flex:0 0 auto;width:25%}.row-cols-xxl-5>*{flex:0 0 auto;width:20%}.row-cols-xxl-6>*{flex:0 0 auto;width:16.6666666667%}.col-xxl-auto{flex:0 0 auto;width:auto}.col-xxl-1{flex:0 0 auto;width:8.33333333%}.col-xxl-2{flex:0 0 auto;width:16.66666667%}.col-xxl-3{flex:0 0 auto;width:25%}.col-xxl-4{flex:0 0 auto;width:33.33333333%}.col-xxl-5{flex:0 0 auto;width:41.66666667%}.col-xxl-6{flex:0 0 auto;width:50%}.col-xxl-7{flex:0 0 auto;width:58.33333333%}.col-xxl-8{flex:0 0 auto;width:66.66666667%}.col-xxl-9{flex:0 0 auto;width:75%}.col-xxl-10{flex:0 0 auto;width:83.33333333%}.col-xxl-11{flex:0 0 auto;width:91.66666667%}.col-xxl-12{flex:0 0 auto;width:100%}.offset-xxl-0{margin-left:0}.offset-xxl-1{margin-left:8.33333333%}.offset-xxl-2{margin-left:16.66666667%}.offset-xxl-3{margin-left:25%}.offset-xxl-4{margin-left:33.33333333%}.offset-xxl-5{margin-left:41.66666667%}.offset-xxl-6{margin-left:50%}.offset-xxl-7{margin-left:58.33333333%}.offset-xxl-8{margin-left:66.66666667%}.offset-xxl-9{margin-left:75%}.offset-xxl-10{margin-left:83.33333333%}.offset-xxl-11{margin-left:91.66666667%}.g-xxl-0,.gx-xxl-0{--bs-gutter-x:0}.g-xxl-0,.gy-xxl-0{--bs-gutter-y:0}.g-xxl-1,.gx-xxl-1{--bs-gutter-x:0.25rem}.g-xxl-1,.gy-xxl-1{--bs-gutter-y:0.25rem}.g-xxl-2,.gx-xxl-2{--bs-gutter-x:0.5rem}.g-xxl-2,.gy-xxl-2{--bs-gutter-y:0.5rem}.g-xxl-3,.gx-xxl-3{--bs-gutter-x:1rem}.g-xxl-3,.gy-xxl-3{--bs-gutter-y:1rem}.g-xxl-4,.gx-xxl-4{--bs-gutter-x:1.5rem}.g-xxl-4,.gy-xxl-4{--bs-gutter-y:1.5rem}.g-xxl-5,.gx-xxl-5{--bs-gutter-x:3rem}.g-xxl-5,.gy-xxl-5{--bs-gutter-y:3rem}}.table{--bs-table-bg:transparent;--bs-table-accent-bg:transparent;--bs-table-striped-color:#212529;--bs-table-striped-bg:rgba(0, 0, 0, 0.05);--bs-table-active-color:#212529;--bs-table-active-bg:rgba(0, 0, 0, 0.1);--bs-table-hover-color:#212529;--bs-table-hover-bg:rgba(0, 0, 0, 0.075);width:100%;margin-bottom:1rem;color:#212529;vertical-align:top;border-color:#dee2e6}.table>:not(caption)>*>*{padding:.5rem .5rem;background-color:var(--bs-table-bg);border-bottom-width:1px;box-shadow:inset 0 0 0 9999px var(--bs-table-accent-bg)}.table>tbody{vertical-align:inherit}.table>thead{vertical-align:bottom}.table>:not(:last-child)>:last-child>*{border-bottom-color:currentColor}.caption-top{caption-side:top}.table-sm>:not(caption)>*>*{padding:.25rem .25rem}.table-bordered>:not(caption)>*{border-width:1px 0}.table-bordered>:not(caption)>*>*{border-width:0 1px}.table-borderless>:not(caption)>*>*{border-bottom-width:0}.table-striped>tbody>tr:nth-of-type(odd){--bs-table-accent-bg:var(--bs-table-striped-bg);color:var(--bs-table-striped-color)}.table-active{--bs-table-accent-bg:var(--bs-table-active-bg);color:var(--bs-table-active-color)}.table-hover>tbody>tr:hover{--bs-table-accent-bg:var(--bs-table-hover-bg);color:var(--bs-table-hover-color)}.table-primary{--bs-table-bg:#cfe2ff;--bs-table-striped-bg:#c5d7f2;--bs-table-striped-color:#000;--bs-table-active-bg:#bacbe6;--bs-table-active-color:#000;--bs-table-hover-bg:#bfd1ec;--bs-table-hover-color:#000;color:#000;border-color:#bacbe6}.table-secondary{--bs-table-bg:#e2e3e5;--bs-table-striped-bg:#d7d8da;--bs-table-striped-color:#000;--bs-table-active-bg:#cbccce;--bs-table-active-color:#000;--bs-table-hover-bg:#d1d2d4;--bs-table-hover-color:#000;color:#000;border-color:#cbccce}.table-success{--bs-table-bg:#d1e7dd;--bs-table-striped-bg:#c7dbd2;--bs-table-striped-color:#000;--bs-table-active-bg:#bcd0c7;--bs-table-active-color:#000;--bs-table-hover-bg:#c1d6cc;--bs-table-hover-color:#000;color:#000;border-color:#bcd0c7}.table-info{--bs-table-bg:#cff4fc;--bs-table-striped-bg:#c5e8ef;--bs-table-striped-color:#000;--bs-table-active-bg:#badce3;--bs-table-active-color:#000;--bs-table-hover-bg:#bfe2e9;--bs-table-hover-color:#000;color:#000;border-color:#badce3}.table-warning{--bs-table-bg:#fff3cd;--bs-table-striped-bg:#f2e7c3;--bs-table-striped-color:#000;--bs-table-active-bg:#e6dbb9;--bs-table-active-color:#000;--bs-table-hover-bg:#ece1be;--bs-table-hover-color:#000;color:#000;border-color:#e6dbb9}.table-danger{--bs-table-bg:#f8d7da;--bs-table-striped-bg:#eccccf;--bs-table-striped-color:#000;--bs-table-active-bg:#dfc2c4;--bs-table-active-color:#000;--bs-table-hover-bg:#e5c7ca;--bs-table-hover-color:#000;color:#000;border-color:#dfc2c4}.table-light{--bs-table-bg:#f8f9fa;--bs-table-striped-bg:#ecedee;--bs-table-striped-color:#000;--bs-table-active-bg:#dfe0e1;--bs-table-active-color:#000;--bs-table-hover-bg:#e5e6e7;--bs-table-hover-color:#000;color:#000;border-color:#dfe0e1}.table-dark{--bs-table-bg:#212529;--bs-table-striped-bg:#2c3034;--bs-table-striped-color:#fff;--bs-table-active-bg:#373b3e;--bs-table-active-color:#fff;--bs-table-hover-bg:#323539;--bs-table-hover-color:#fff;color:#fff;border-color:#373b3e}.table-responsive{overflow-x:auto;-webkit-overflow-scrolling:touch}@media (max-width:575.98px){.table-responsive-sm{overflow-x:auto;-webkit-overflow-scrolling:touch}}@media (max-width:767.98px){.table-responsive-md{overflow-x:auto;-webkit-overflow-scrolling:touch}}@media (max-width:991.98px){.table-responsive-lg{overflow-x:auto;-webkit-overflow-scrolling:touch}}@media (max-width:1199.98px){.table-responsive-xl{overflow-x:auto;-webkit-overflow-scrolling:touch}}@media (max-width:1399.98px){.table-responsive-xxl{overflow-x:auto;-webkit-overflow-scrolling:touch}}.form-label{margin-bottom:.5rem}.col-form-label{padding-top:calc(.375rem + 1px);padding-bottom:calc(.375rem + 1px);margin-bottom:0;font-size:inherit;line-height:1.5}.col-form-label-lg{padding-top:calc(.5rem + 1px);padding-bottom:calc(.5rem + 1px);font-size:1.25rem}.col-form-label-sm{padding-top:calc(.25rem + 1px);padding-bottom:calc(.25rem + 1px);font-size:.875rem}.form-text{margin-top:.25rem;font-size:.875em;color:#6c757d}.form-control{display:block;width:100%;padding:.375rem .75rem;font-size:1rem;font-weight:400;line-height:1.5;color:#212529;background-color:#fff;background-clip:padding-box;border:1px solid #ced4da;-webkit-appearance:none;-moz-appearance:none;appearance:none;border-radius:.25rem;transition:border-color .15s ease-in-out,box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.form-control{transition:none}}.form-control[type=file]{overflow:hidden}.form-control[type=file]:not(:disabled):not([readonly]){cursor:pointer}.form-control:focus{color:#212529;background-color:#fff;border-color:#86b7fe;outline:0;box-shadow:0 0 0 .25rem rgba(13,110,253,.25)}.form-control::-webkit-date-and-time-value{height:1.5em}.form-control::-moz-placeholder{color:#6c757d;opacity:1}.form-control::placeholder{color:#6c757d;opacity:1}.form-control:disabled,.form-control[readonly]{background-color:#e9ecef;opacity:1}.form-control::file-selector-button{padding:.375rem .75rem;margin:-.375rem -.75rem;-webkit-margin-end:.75rem;margin-inline-end:.75rem;color:#212529;background-color:#e9ecef;pointer-events:none;border-color:inherit;border-style:solid;border-width:0;border-inline-end-width:1px;border-radius:0;transition:color .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.form-control::file-selector-button{transition:none}}.form-control:hover:not(:disabled):not([readonly])::file-selector-button{background-color:#dde0e3}.form-control::-webkit-file-upload-button{padding:.375rem .75rem;margin:-.375rem -.75rem;-webkit-margin-end:.75rem;margin-inline-end:.75rem;color:#212529;background-color:#e9ecef;pointer-events:none;border-color:inherit;border-style:solid;border-width:0;border-inline-end-width:1px;border-radius:0;-webkit-transition:color .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;transition:color .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.form-control::-webkit-file-upload-button{-webkit-transition:none;transition:none}}.form-control:hover:not(:disabled):not([readonly])::-webkit-file-upload-button{background-color:#dde0e3}.form-control-plaintext{display:block;width:100%;padding:.375rem 0;margin-bottom:0;line-height:1.5;color:#212529;background-color:transparent;border:solid transparent;border-width:1px 0}.form-control-plaintext.form-control-lg,.form-control-plaintext.form-control-sm{padding-right:0;padding-left:0}.form-control-sm{min-height:calc(1.5em + .5rem + 2px);padding:.25rem .5rem;font-size:.875rem;border-radius:.2rem}.form-control-sm::file-selector-button{padding:.25rem .5rem;margin:-.25rem -.5rem;-webkit-margin-end:.5rem;margin-inline-end:.5rem}.form-control-sm::-webkit-file-upload-button{padding:.25rem .5rem;margin:-.25rem -.5rem;-webkit-margin-end:.5rem;margin-inline-end:.5rem}.form-control-lg{min-height:calc(1.5em + 1rem + 2px);padding:.5rem 1rem;font-size:1.25rem;border-radius:.3rem}.form-control-lg::file-selector-button{padding:.5rem 1rem;margin:-.5rem -1rem;-webkit-margin-end:1rem;margin-inline-end:1rem}.form-control-lg::-webkit-file-upload-button{padding:.5rem 1rem;margin:-.5rem -1rem;-webkit-margin-end:1rem;margin-inline-end:1rem}textarea.form-control{min-height:calc(1.5em + .75rem + 2px)}textarea.form-control-sm{min-height:calc(1.5em + .5rem + 2px)}textarea.form-control-lg{min-height:calc(1.5em + 1rem + 2px)}.form-control-color{width:3rem;height:auto;padding:.375rem}.form-control-color:not(:disabled):not([readonly]){cursor:pointer}.form-control-color::-moz-color-swatch{height:1.5em;border-radius:.25rem}.form-control-color::-webkit-color-swatch{height:1.5em;border-radius:.25rem}.form-select{display:block;width:100%;padding:.375rem 2.25rem .375rem .75rem;-moz-padding-start:calc(0.75rem - 3px);font-size:1rem;font-weight:400;line-height:1.5;color:#212529;background-color:#fff;background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3e%3cpath fill='none' stroke='%23343a40' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M2 5l6 6 6-6'/%3e%3c/svg%3e");background-repeat:no-repeat;background-position:right .75rem center;background-size:16px 12px;border:1px solid #ced4da;border-radius:.25rem;transition:border-color .15s ease-in-out,box-shadow .15s ease-in-out;-webkit-appearance:none;-moz-appearance:none;appearance:none}@media (prefers-reduced-motion:reduce){.form-select{transition:none}}.form-select:focus{border-color:#86b7fe;outline:0;box-shadow:0 0 0 .25rem rgba(13,110,253,.25)}.form-select[multiple],.form-select[size]:not([size="1"]){padding-right:.75rem;background-image:none}.form-select:disabled{background-color:#e9ecef}.form-select:-moz-focusring{color:transparent;text-shadow:0 0 0 #212529}.form-select-sm{padding-top:.25rem;padding-bottom:.25rem;padding-left:.5rem;font-size:.875rem}.form-select-lg{padding-top:.5rem;padding-bottom:.5rem;padding-left:1rem;font-size:1.25rem}.form-check{display:block;min-height:1.5rem;padding-left:1.5em;margin-bottom:.125rem}.form-check .form-check-input{float:left;margin-left:-1.5em}.form-check-input{width:1em;height:1em;margin-top:.25em;vertical-align:top;background-color:#fff;background-repeat:no-repeat;background-position:center;background-size:contain;border:1px solid rgba(0,0,0,.25);-webkit-appearance:none;-moz-appearance:none;appearance:none;-webkit-print-color-adjust:exact;color-adjust:exact}.form-check-input[type=checkbox]{border-radius:.25em}.form-check-input[type=radio]{border-radius:50%}.form-check-input:active{filter:brightness(90%)}.form-check-input:focus{border-color:#86b7fe;outline:0;box-shadow:0 0 0 .25rem rgba(13,110,253,.25)}.form-check-input:checked{background-color:#0d6efd;border-color:#0d6efd}.form-check-input:checked[type=checkbox]{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3e%3cpath fill='none' stroke='%23fff' stroke-linecap='round' stroke-linejoin='round' stroke-width='3' d='M6 10l3 3l6-6'/%3e%3c/svg%3e")}.form-check-input:checked[type=radio]{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='-4 -4 8 8'%3e%3ccircle r='2' fill='%23fff'/%3e%3c/svg%3e")}.form-check-input[type=checkbox]:indeterminate{background-color:#0d6efd;border-color:#0d6efd;background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3e%3cpath fill='none' stroke='%23fff' stroke-linecap='round' stroke-linejoin='round' stroke-width='3' d='M6 10h8'/%3e%3c/svg%3e")}.form-check-input:disabled{pointer-events:none;filter:none;opacity:.5}.form-check-input:disabled~.form-check-label,.form-check-input[disabled]~.form-check-label{opacity:.5}.form-switch{padding-left:2.5em}.form-switch .form-check-input{width:2em;margin-left:-2.5em;background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='-4 -4 8 8'%3e%3ccircle r='3' fill='rgba%280, 0, 0, 0.25%29'/%3e%3c/svg%3e");background-position:left center;border-radius:2em;transition:background-position .15s ease-in-out}@media (prefers-reduced-motion:reduce){.form-switch .form-check-input{transition:none}}.form-switch .form-check-input:focus{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='-4 -4 8 8'%3e%3ccircle r='3' fill='%2386b7fe'/%3e%3c/svg%3e")}.form-switch .form-check-input:checked{background-position:right center;background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='-4 -4 8 8'%3e%3ccircle r='3' fill='%23fff'/%3e%3c/svg%3e")}.form-check-inline{display:inline-block;margin-right:1rem}.btn-check{position:absolute;clip:rect(0,0,0,0);pointer-events:none}.btn-check:disabled+.btn,.btn-check[disabled]+.btn{pointer-events:none;filter:none;opacity:.65}.form-range{width:100%;height:1.5rem;padding:0;background-color:transparent;-webkit-appearance:none;-moz-appearance:none;appearance:none}.form-range:focus{outline:0}.form-range:focus::-webkit-slider-thumb{box-shadow:0 0 0 1px #fff,0 0 0 .25rem rgba(13,110,253,.25)}.form-range:focus::-moz-range-thumb{box-shadow:0 0 0 1px #fff,0 0 0 .25rem rgba(13,110,253,.25)}.form-range::-moz-focus-outer{border:0}.form-range::-webkit-slider-thumb{width:1rem;height:1rem;margin-top:-.25rem;background-color:#0d6efd;border:0;border-radius:1rem;-webkit-transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;-webkit-appearance:none;appearance:none}@media (prefers-reduced-motion:reduce){.form-range::-webkit-slider-thumb{-webkit-transition:none;transition:none}}.form-range::-webkit-slider-thumb:active{background-color:#b6d4fe}.form-range::-webkit-slider-runnable-track{width:100%;height:.5rem;color:transparent;cursor:pointer;background-color:#dee2e6;border-color:transparent;border-radius:1rem}.form-range::-moz-range-thumb{width:1rem;height:1rem;background-color:#0d6efd;border:0;border-radius:1rem;-moz-transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;-moz-appearance:none;appearance:none}@media (prefers-reduced-motion:reduce){.form-range::-moz-range-thumb{-moz-transition:none;transition:none}}.form-range::-moz-range-thumb:active{background-color:#b6d4fe}.form-range::-moz-range-track{width:100%;height:.5rem;color:transparent;cursor:pointer;background-color:#dee2e6;border-color:transparent;border-radius:1rem}.form-range:disabled{pointer-events:none}.form-range:disabled::-webkit-slider-thumb{background-color:#adb5bd}.form-range:disabled::-moz-range-thumb{background-color:#adb5bd}.form-floating{position:relative}.form-floating>.form-control,.form-floating>.form-select{height:calc(3.5rem + 2px);line-height:1.25}.form-floating>label{position:absolute;top:0;left:0;height:100%;padding:1rem .75rem;pointer-events:none;border:1px solid transparent;transform-origin:0 0;transition:opacity .1s ease-in-out,transform .1s ease-in-out}@media (prefers-reduced-motion:reduce){.form-floating>label{transition:none}}.form-floating>.form-control{padding:1rem .75rem}.form-floating>.form-control::-moz-placeholder{color:transparent}.form-floating>.form-control::placeholder{color:transparent}.form-floating>.form-control:not(:-moz-placeholder-shown){padding-top:1.625rem;padding-bottom:.625rem}.form-floating>.form-control:focus,.form-floating>.form-control:not(:placeholder-shown){padding-top:1.625rem;padding-bottom:.625rem}.form-floating>.form-control:-webkit-autofill{padding-top:1.625rem;padding-bottom:.625rem}.form-floating>.form-select{padding-top:1.625rem;padding-bottom:.625rem}.form-floating>.form-control:not(:-moz-placeholder-shown)~label{opacity:.65;transform:scale(.85) translateY(-.5rem) translateX(.15rem)}.form-floating>.form-control:focus~label,.form-floating>.form-control:not(:placeholder-shown)~label,.form-floating>.form-select~label{opacity:.65;transform:scale(.85) translateY(-.5rem) translateX(.15rem)}.form-floating>.form-control:-webkit-autofill~label{opacity:.65;transform:scale(.85) translateY(-.5rem) translateX(.15rem)}.input-group{position:relative;display:flex;flex-wrap:wrap;align-items:stretch;width:100%}.input-group>.form-control,.input-group>.form-select{position:relative;flex:1 1 auto;width:1%;min-width:0}.input-group>.form-control:focus,.input-group>.form-select:focus{z-index:3}.input-group .btn{position:relative;z-index:2}.input-group .btn:focus{z-index:3}.input-group-text{display:flex;align-items:center;padding:.375rem .75rem;font-size:1rem;font-weight:400;line-height:1.5;color:#212529;text-align:center;white-space:nowrap;background-color:#e9ecef;border:1px solid #ced4da;border-radius:.25rem}.input-group-lg>.btn,.input-group-lg>.form-control,.input-group-lg>.form-select,.input-group-lg>.input-group-text{padding:.5rem 1rem;font-size:1.25rem;border-radius:.3rem}.input-group-sm>.btn,.input-group-sm>.form-control,.input-group-sm>.form-select,.input-group-sm>.input-group-text{padding:.25rem .5rem;font-size:.875rem;border-radius:.2rem}.input-group-lg>.form-select,.input-group-sm>.form-select{padding-right:3rem}.input-group:not(.has-validation)>.dropdown-toggle:nth-last-child(n+3),.input-group:not(.has-validation)>:not(:last-child):not(.dropdown-toggle):not(.dropdown-menu){border-top-right-radius:0;border-bottom-right-radius:0}.input-group.has-validation>.dropdown-toggle:nth-last-child(n+4),.input-group.has-validation>:nth-last-child(n+3):not(.dropdown-toggle):not(.dropdown-menu){border-top-right-radius:0;border-bottom-right-radius:0}.input-group>:not(:first-child):not(.dropdown-menu):not(.valid-tooltip):not(.valid-feedback):not(.invalid-tooltip):not(.invalid-feedback){margin-left:-1px;border-top-left-radius:0;border-bottom-left-radius:0}.valid-feedback{display:none;width:100%;margin-top:.25rem;font-size:.875em;color:#198754}.valid-tooltip{position:absolute;top:100%;z-index:5;display:none;max-width:100%;padding:.25rem .5rem;margin-top:.1rem;font-size:.875rem;color:#fff;background-color:rgba(25,135,84,.9);border-radius:.25rem}.is-valid~.valid-feedback,.is-valid~.valid-tooltip,.was-validated :valid~.valid-feedback,.was-validated :valid~.valid-tooltip{display:block}.form-control.is-valid,.was-validated .form-control:valid{border-color:#198754;padding-right:calc(1.5em + .75rem);background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 8 8'%3e%3cpath fill='%23198754' d='M2.3 6.73L.6 4.53c-.4-1.04.46-1.4 1.1-.8l1.1 1.4 3.4-3.8c.6-.63 1.6-.27 1.2.7l-4 4.6c-.43.5-.8.4-1.1.1z'/%3e%3c/svg%3e");background-repeat:no-repeat;background-position:right calc(.375em + .1875rem) center;background-size:calc(.75em + .375rem) calc(.75em + .375rem)}.form-control.is-valid:focus,.was-validated .form-control:valid:focus{border-color:#198754;box-shadow:0 0 0 .25rem rgba(25,135,84,.25)}.was-validated textarea.form-control:valid,textarea.form-control.is-valid{padding-right:calc(1.5em + .75rem);background-position:top calc(.375em + .1875rem) right calc(.375em + .1875rem)}.form-select.is-valid,.was-validated .form-select:valid{border-color:#198754}.form-select.is-valid:not([multiple]):not([size]),.form-select.is-valid:not([multiple])[size="1"],.was-validated .form-select:valid:not([multiple]):not([size]),.was-validated .form-select:valid:not([multiple])[size="1"]{padding-right:4.125rem;background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3e%3cpath fill='none' stroke='%23343a40' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M2 5l6 6 6-6'/%3e%3c/svg%3e"),url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 8 8'%3e%3cpath fill='%23198754' d='M2.3 6.73L.6 4.53c-.4-1.04.46-1.4 1.1-.8l1.1 1.4 3.4-3.8c.6-.63 1.6-.27 1.2.7l-4 4.6c-.43.5-.8.4-1.1.1z'/%3e%3c/svg%3e");background-position:right .75rem center,center right 2.25rem;background-size:16px 12px,calc(.75em + .375rem) calc(.75em + .375rem)}.form-select.is-valid:focus,.was-validated .form-select:valid:focus{border-color:#198754;box-shadow:0 0 0 .25rem rgba(25,135,84,.25)}.form-check-input.is-valid,.was-validated .form-check-input:valid{border-color:#198754}.form-check-input.is-valid:checked,.was-validated .form-check-input:valid:checked{background-color:#198754}.form-check-input.is-valid:focus,.was-validated .form-check-input:valid:focus{box-shadow:0 0 0 .25rem rgba(25,135,84,.25)}.form-check-input.is-valid~.form-check-label,.was-validated .form-check-input:valid~.form-check-label{color:#198754}.form-check-inline .form-check-input~.valid-feedback{margin-left:.5em}.input-group .form-control.is-valid,.input-group .form-select.is-valid,.was-validated .input-group .form-control:valid,.was-validated .input-group .form-select:valid{z-index:1}.input-group .form-control.is-valid:focus,.input-group .form-select.is-valid:focus,.was-validated .input-group .form-control:valid:focus,.was-validated .input-group .form-select:valid:focus{z-index:3}.invalid-feedback{display:none;width:100%;margin-top:.25rem;font-size:.875em;color:#dc3545}.invalid-tooltip{position:absolute;top:100%;z-index:5;display:none;max-width:100%;padding:.25rem .5rem;margin-top:.1rem;font-size:.875rem;color:#fff;background-color:rgba(220,53,69,.9);border-radius:.25rem}.is-invalid~.invalid-feedback,.is-invalid~.invalid-tooltip,.was-validated :invalid~.invalid-feedback,.was-validated :invalid~.invalid-tooltip{display:block}.form-control.is-invalid,.was-validated .form-control:invalid{border-color:#dc3545;padding-right:calc(1.5em + .75rem);background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 12 12' width='12' height='12' fill='none' stroke='%23dc3545'%3e%3ccircle cx='6' cy='6' r='4.5'/%3e%3cpath stroke-linejoin='round' d='M5.8 3.6h.4L6 6.5z'/%3e%3ccircle cx='6' cy='8.2' r='.6' fill='%23dc3545' stroke='none'/%3e%3c/svg%3e");background-repeat:no-repeat;background-position:right calc(.375em + .1875rem) center;background-size:calc(.75em + .375rem) calc(.75em + .375rem)}.form-control.is-invalid:focus,.was-validated .form-control:invalid:focus{border-color:#dc3545;box-shadow:0 0 0 .25rem rgba(220,53,69,.25)}.was-validated textarea.form-control:invalid,textarea.form-control.is-invalid{padding-right:calc(1.5em + .75rem);background-position:top calc(.375em + .1875rem) right calc(.375em + .1875rem)}.form-select.is-invalid,.was-validated .form-select:invalid{border-color:#dc3545}.form-select.is-invalid:not([multiple]):not([size]),.form-select.is-invalid:not([multiple])[size="1"],.was-validated .form-select:invalid:not([multiple]):not([size]),.was-validated .form-select:invalid:not([multiple])[size="1"]{padding-right:4.125rem;background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3e%3cpath fill='none' stroke='%23343a40' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M2 5l6 6 6-6'/%3e%3c/svg%3e"),url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 12 12' width='12' height='12' fill='none' stroke='%23dc3545'%3e%3ccircle cx='6' cy='6' r='4.5'/%3e%3cpath stroke-linejoin='round' d='M5.8 3.6h.4L6 6.5z'/%3e%3ccircle cx='6' cy='8.2' r='.6' fill='%23dc3545' stroke='none'/%3e%3c/svg%3e");background-position:right .75rem center,center right 2.25rem;background-size:16px 12px,calc(.75em + .375rem) calc(.75em + .375rem)}.form-select.is-invalid:focus,.was-validated .form-select:invalid:focus{border-color:#dc3545;box-shadow:0 0 0 .25rem rgba(220,53,69,.25)}.form-check-input.is-invalid,.was-validated .form-check-input:invalid{border-color:#dc3545}.form-check-input.is-invalid:checked,.was-validated .form-check-input:invalid:checked{background-color:#dc3545}.form-check-input.is-invalid:focus,.was-validated .form-check-input:invalid:focus{box-shadow:0 0 0 .25rem rgba(220,53,69,.25)}.form-check-input.is-invalid~.form-check-label,.was-validated .form-check-input:invalid~.form-check-label{color:#dc3545}.form-check-inline .form-check-input~.invalid-feedback{margin-left:.5em}.input-group .form-control.is-invalid,.input-group .form-select.is-invalid,.was-validated .input-group .form-control:invalid,.was-validated .input-group .form-select:invalid{z-index:2}.input-group .form-control.is-invalid:focus,.input-group .form-select.is-invalid:focus,.was-validated .input-group .form-control:invalid:focus,.was-validated .input-group .form-select:invalid:focus{z-index:3}.btn{display:inline-block;font-weight:400;line-height:1.5;color:#212529;text-align:center;text-decoration:none;vertical-align:middle;cursor:pointer;-webkit-user-select:none;-moz-user-select:none;user-select:none;background-color:transparent;border:1px solid transparent;padding:.375rem .75rem;font-size:1rem;border-radius:.25rem;transition:color .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.btn{transition:none}}.btn:hover{color:#212529}.btn-check:focus+.btn,.btn:focus{outline:0;box-shadow:0 0 0 .25rem rgba(13,110,253,.25)}.btn.disabled,.btn:disabled,fieldset:disabled .btn{pointer-events:none;opacity:.65}.btn-primary{color:#fff;background-color:#0d6efd;border-color:#0d6efd}.btn-primary:hover{color:#fff;background-color:#0b5ed7;border-color:#0a58ca}.btn-check:focus+.btn-primary,.btn-primary:focus{color:#fff;background-color:#0b5ed7;border-color:#0a58ca;box-shadow:0 0 0 .25rem rgba(49,132,253,.5)}.btn-check:active+.btn-primary,.btn-check:checked+.btn-primary,.btn-primary.active,.btn-primary:active,.show>.btn-primary.dropdown-toggle{color:#fff;background-color:#0a58ca;border-color:#0a53be}.btn-check:active+.btn-primary:focus,.btn-check:checked+.btn-primary:focus,.btn-primary.active:focus,.btn-primary:active:focus,.show>.btn-primary.dropdown-toggle:focus{box-shadow:0 0 0 .25rem rgba(49,132,253,.5)}.btn-primary.disabled,.btn-primary:disabled{color:#fff;background-color:#0d6efd;border-color:#0d6efd}.btn-secondary{color:#fff;background-color:#6c757d;border-color:#6c757d}.btn-secondary:hover{color:#fff;background-color:#5c636a;border-color:#565e64}.btn-check:focus+.btn-secondary,.btn-secondary:focus{color:#fff;background-color:#5c636a;border-color:#565e64;box-shadow:0 0 0 .25rem rgba(130,138,145,.5)}.btn-check:active+.btn-secondary,.btn-check:checked+.btn-secondary,.btn-secondary.active,.btn-secondary:active,.show>.btn-secondary.dropdown-toggle{color:#fff;background-color:#565e64;border-color:#51585e}.btn-check:active+.btn-secondary:focus,.btn-check:checked+.btn-secondary:focus,.btn-secondary.active:focus,.btn-secondary:active:focus,.show>.btn-secondary.dropdown-toggle:focus{box-shadow:0 0 0 .25rem rgba(130,138,145,.5)}.btn-secondary.disabled,.btn-secondary:disabled{color:#fff;background-color:#6c757d;border-color:#6c757d}.btn-success{color:#fff;background-color:#198754;border-color:#198754}.btn-success:hover{color:#fff;background-color:#157347;border-color:#146c43}.btn-check:focus+.btn-success,.btn-success:focus{color:#fff;background-color:#157347;border-color:#146c43;box-shadow:0 0 0 .25rem rgba(60,153,110,.5)}.btn-check:active+.btn-success,.btn-check:checked+.btn-success,.btn-success.active,.btn-success:active,.show>.btn-success.dropdown-toggle{color:#fff;background-color:#146c43;border-color:#13653f}.btn-check:active+.btn-success:focus,.btn-check:checked+.btn-success:focus,.btn-success.active:focus,.btn-success:active:focus,.show>.btn-success.dropdown-toggle:focus{box-shadow:0 0 0 .25rem rgba(60,153,110,.5)}.btn-success.disabled,.btn-success:disabled{color:#fff;background-color:#198754;border-color:#198754}.btn-info{color:#000;background-color:#0dcaf0;border-color:#0dcaf0}.btn-info:hover{color:#000;background-color:#31d2f2;border-color:#25cff2}.btn-check:focus+.btn-info,.btn-info:focus{color:#000;background-color:#31d2f2;border-color:#25cff2;box-shadow:0 0 0 .25rem rgba(11,172,204,.5)}.btn-check:active+.btn-info,.btn-check:checked+.btn-info,.btn-info.active,.btn-info:active,.show>.btn-info.dropdown-toggle{color:#000;background-color:#3dd5f3;border-color:#25cff2}.btn-check:active+.btn-info:focus,.btn-check:checked+.btn-info:focus,.btn-info.active:focus,.btn-info:active:focus,.show>.btn-info.dropdown-toggle:focus{box-shadow:0 0 0 .25rem rgba(11,172,204,.5)}.btn-info.disabled,.btn-info:disabled{color:#000;background-color:#0dcaf0;border-color:#0dcaf0}.btn-warning{color:#000;background-color:#ffc107;border-color:#ffc107}.btn-warning:hover{color:#000;background-color:#ffca2c;border-color:#ffc720}.btn-check:focus+.btn-warning,.btn-warning:focus{color:#000;background-color:#ffca2c;border-color:#ffc720;box-shadow:0 0 0 .25rem rgba(217,164,6,.5)}.btn-check:active+.btn-warning,.btn-check:checked+.btn-warning,.btn-warning.active,.btn-warning:active,.show>.btn-warning.dropdown-toggle{color:#000;background-color:#ffcd39;border-color:#ffc720}.btn-check:active+.btn-warning:focus,.btn-check:checked+.btn-warning:focus,.btn-warning.active:focus,.btn-warning:active:focus,.show>.btn-warning.dropdown-toggle:focus{box-shadow:0 0 0 .25rem rgba(217,164,6,.5)}.btn-warning.disabled,.btn-warning:disabled{color:#000;background-color:#ffc107;border-color:#ffc107}.btn-danger{color:#fff;background-color:#dc3545;border-color:#dc3545}.btn-danger:hover{color:#fff;background-color:#bb2d3b;border-color:#b02a37}.btn-check:focus+.btn-danger,.btn-danger:focus{color:#fff;background-color:#bb2d3b;border-color:#b02a37;box-shadow:0 0 0 .25rem rgba(225,83,97,.5)}.btn-check:active+.btn-danger,.btn-check:checked+.btn-danger,.btn-danger.active,.btn-danger:active,.show>.btn-danger.dropdown-toggle{color:#fff;background-color:#b02a37;border-color:#a52834}.btn-check:active+.btn-danger:focus,.btn-check:checked+.btn-danger:focus,.btn-danger.active:focus,.btn-danger:active:focus,.show>.btn-danger.dropdown-toggle:focus{box-shadow:0 0 0 .25rem rgba(225,83,97,.5)}.btn-danger.disabled,.btn-danger:disabled{color:#fff;background-color:#dc3545;border-color:#dc3545}.btn-light{color:#000;background-color:#f8f9fa;border-color:#f8f9fa}.btn-light:hover{color:#000;background-color:#f9fafb;border-color:#f9fafb}.btn-check:focus+.btn-light,.btn-light:focus{color:#000;background-color:#f9fafb;border-color:#f9fafb;box-shadow:0 0 0 .25rem rgba(211,212,213,.5)}.btn-check:active+.btn-light,.btn-check:checked+.btn-light,.btn-light.active,.btn-light:active,.show>.btn-light.dropdown-toggle{color:#000;background-color:#f9fafb;border-color:#f9fafb}.btn-check:active+.btn-light:focus,.btn-check:checked+.btn-light:focus,.btn-light.active:focus,.btn-light:active:focus,.show>.btn-light.dropdown-toggle:focus{box-shadow:0 0 0 .25rem rgba(211,212,213,.5)}.btn-light.disabled,.btn-light:disabled{color:#000;background-color:#f8f9fa;border-color:#f8f9fa}.btn-dark{color:#fff;background-color:#212529;border-color:#212529}.btn-dark:hover{color:#fff;background-color:#1c1f23;border-color:#1a1e21}.btn-check:focus+.btn-dark,.btn-dark:focus{color:#fff;background-color:#1c1f23;border-color:#1a1e21;box-shadow:0 0 0 .25rem rgba(66,70,73,.5)}.btn-check:active+.btn-dark,.btn-check:checked+.btn-dark,.btn-dark.active,.btn-dark:active,.show>.btn-dark.dropdown-toggle{color:#fff;background-color:#1a1e21;border-color:#191c1f}.btn-check:active+.btn-dark:focus,.btn-check:checked+.btn-dark:focus,.btn-dark.active:focus,.btn-dark:active:focus,.show>.btn-dark.dropdown-toggle:focus{box-shadow:0 0 0 .25rem rgba(66,70,73,.5)}.btn-dark.disabled,.btn-dark:disabled{color:#fff;background-color:#212529;border-color:#212529}.btn-outline-primary{color:#0d6efd;border-color:#0d6efd}.btn-outline-primary:hover{color:#fff;background-color:#0d6efd;border-color:#0d6efd}.btn-check:focus+.btn-outline-primary,.btn-outline-primary:focus{box-shadow:0 0 0 .25rem rgba(13,110,253,.5)}.btn-check:active+.btn-outline-primary,.btn-check:checked+.btn-outline-primary,.btn-outline-primary.active,.btn-outline-primary.dropdown-toggle.show,.btn-outline-primary:active{color:#fff;background-color:#0d6efd;border-color:#0d6efd}.btn-check:active+.btn-outline-primary:focus,.btn-check:checked+.btn-outline-primary:focus,.btn-outline-primary.active:focus,.btn-outline-primary.dropdown-toggle.show:focus,.btn-outline-primary:active:focus{box-shadow:0 0 0 .25rem rgba(13,110,253,.5)}.btn-outline-primary.disabled,.btn-outline-primary:disabled{color:#0d6efd;background-color:transparent}.btn-outline-secondary{color:#6c757d;border-color:#6c757d}.btn-outline-secondary:hover{color:#fff;background-color:#6c757d;border-color:#6c757d}.btn-check:focus+.btn-outline-secondary,.btn-outline-secondary:focus{box-shadow:0 0 0 .25rem rgba(108,117,125,.5)}.btn-check:active+.btn-outline-secondary,.btn-check:checked+.btn-outline-secondary,.btn-outline-secondary.active,.btn-outline-secondary.dropdown-toggle.show,.btn-outline-secondary:active{color:#fff;background-color:#6c757d;border-color:#6c757d}.btn-check:active+.btn-outline-secondary:focus,.btn-check:checked+.btn-outline-secondary:focus,.btn-outline-secondary.active:focus,.btn-outline-secondary.dropdown-toggle.show:focus,.btn-outline-secondary:active:focus{box-shadow:0 0 0 .25rem rgba(108,117,125,.5)}.btn-outline-secondary.disabled,.btn-outline-secondary:disabled{color:#6c757d;background-color:transparent}.btn-outline-success{color:#198754;border-color:#198754}.btn-outline-success:hover{color:#fff;background-color:#198754;border-color:#198754}.btn-check:focus+.btn-outline-success,.btn-outline-success:focus{box-shadow:0 0 0 .25rem rgba(25,135,84,.5)}.btn-check:active+.btn-outline-success,.btn-check:checked+.btn-outline-success,.btn-outline-success.active,.btn-outline-success.dropdown-toggle.show,.btn-outline-success:active{color:#fff;background-color:#198754;border-color:#198754}.btn-check:active+.btn-outline-success:focus,.btn-check:checked+.btn-outline-success:focus,.btn-outline-success.active:focus,.btn-outline-success.dropdown-toggle.show:focus,.btn-outline-success:active:focus{box-shadow:0 0 0 .25rem rgba(25,135,84,.5)}.btn-outline-success.disabled,.btn-outline-success:disabled{color:#198754;background-color:transparent}.btn-outline-info{color:#0dcaf0;border-color:#0dcaf0}.btn-outline-info:hover{color:#000;background-color:#0dcaf0;border-color:#0dcaf0}.btn-check:focus+.btn-outline-info,.btn-outline-info:focus{box-shadow:0 0 0 .25rem rgba(13,202,240,.5)}.btn-check:active+.btn-outline-info,.btn-check:checked+.btn-outline-info,.btn-outline-info.active,.btn-outline-info.dropdown-toggle.show,.btn-outline-info:active{color:#000;background-color:#0dcaf0;border-color:#0dcaf0}.btn-check:active+.btn-outline-info:focus,.btn-check:checked+.btn-outline-info:focus,.btn-outline-info.active:focus,.btn-outline-info.dropdown-toggle.show:focus,.btn-outline-info:active:focus{box-shadow:0 0 0 .25rem rgba(13,202,240,.5)}.btn-outline-info.disabled,.btn-outline-info:disabled{color:#0dcaf0;background-color:transparent}.btn-outline-warning{color:#ffc107;border-color:#ffc107}.btn-outline-warning:hover{color:#000;background-color:#ffc107;border-color:#ffc107}.btn-check:focus+.btn-outline-warning,.btn-outline-warning:focus{box-shadow:0 0 0 .25rem rgba(255,193,7,.5)}.btn-check:active+.btn-outline-warning,.btn-check:checked+.btn-outline-warning,.btn-outline-warning.active,.btn-outline-warning.dropdown-toggle.show,.btn-outline-warning:active{color:#000;background-color:#ffc107;border-color:#ffc107}.btn-check:active+.btn-outline-warning:focus,.btn-check:checked+.btn-outline-warning:focus,.btn-outline-warning.active:focus,.btn-outline-warning.dropdown-toggle.show:focus,.btn-outline-warning:active:focus{box-shadow:0 0 0 .25rem rgba(255,193,7,.5)}.btn-outline-warning.disabled,.btn-outline-warning:disabled{color:#ffc107;background-color:transparent}.btn-outline-danger{color:#dc3545;border-color:#dc3545}.btn-outline-danger:hover{color:#fff;background-color:#dc3545;border-color:#dc3545}.btn-check:focus+.btn-outline-danger,.btn-outline-danger:focus{box-shadow:0 0 0 .25rem rgba(220,53,69,.5)}.btn-check:active+.btn-outline-danger,.btn-check:checked+.btn-outline-danger,.btn-outline-danger.active,.btn-outline-danger.dropdown-toggle.show,.btn-outline-danger:active{color:#fff;background-color:#dc3545;border-color:#dc3545}.btn-check:active+.btn-outline-danger:focus,.btn-check:checked+.btn-outline-danger:focus,.btn-outline-danger.active:focus,.btn-outline-danger.dropdown-toggle.show:focus,.btn-outline-danger:active:focus{box-shadow:0 0 0 .25rem rgba(220,53,69,.5)}.btn-outline-danger.disabled,.btn-outline-danger:disabled{color:#dc3545;background-color:transparent}.btn-outline-light{color:#f8f9fa;border-color:#f8f9fa}.btn-outline-light:hover{color:#000;background-color:#f8f9fa;border-color:#f8f9fa}.btn-check:focus+.btn-outline-light,.btn-outline-light:focus{box-shadow:0 0 0 .25rem rgba(248,249,250,.5)}.btn-check:active+.btn-outline-light,.btn-check:checked+.btn-outline-light,.btn-outline-light.active,.btn-outline-light.dropdown-toggle.show,.btn-outline-light:active{color:#000;background-color:#f8f9fa;border-color:#f8f9fa}.btn-check:active+.btn-outline-light:focus,.btn-check:checked+.btn-outline-light:focus,.btn-outline-light.active:focus,.btn-outline-light.dropdown-toggle.show:focus,.btn-outline-light:active:focus{box-shadow:0 0 0 .25rem rgba(248,249,250,.5)}.btn-outline-light.disabled,.btn-outline-light:disabled{color:#f8f9fa;background-color:transparent}.btn-outline-dark{color:#212529;border-color:#212529}.btn-outline-dark:hover{color:#fff;background-color:#212529;border-color:#212529}.btn-check:focus+.btn-outline-dark,.btn-outline-dark:focus{box-shadow:0 0 0 .25rem rgba(33,37,41,.5)}.btn-check:active+.btn-outline-dark,.btn-check:checked+.btn-outline-dark,.btn-outline-dark.active,.btn-outline-dark.dropdown-toggle.show,.btn-outline-dark:active{color:#fff;background-color:#212529;border-color:#212529}.btn-check:active+.btn-outline-dark:focus,.btn-check:checked+.btn-outline-dark:focus,.btn-outline-dark.active:focus,.btn-outline-dark.dropdown-toggle.show:focus,.btn-outline-dark:active:focus{box-shadow:0 0 0 .25rem rgba(33,37,41,.5)}.btn-outline-dark.disabled,.btn-outline-dark:disabled{color:#212529;background-color:transparent}.btn-link{font-weight:400;color:#0d6efd;text-decoration:underline}.btn-link:hover{color:#0a58ca}.btn-link.disabled,.btn-link:disabled{color:#6c757d}.btn-group-lg>.btn,.btn-lg{padding:.5rem 1rem;font-size:1.25rem;border-radius:.3rem}.btn-group-sm>.btn,.btn-sm{padding:.25rem .5rem;font-size:.875rem;border-radius:.2rem}.fade{transition:opacity .15s linear}@media (prefers-reduced-motion:reduce){.fade{transition:none}}.fade:not(.show){opacity:0}.collapse:not(.show){display:none}.collapsing{height:0;overflow:hidden;transition:height .35s ease}@media (prefers-reduced-motion:reduce){.collapsing{transition:none}}.collapsing.collapse-horizontal{width:0;height:auto;transition:width .35s ease}@media (prefers-reduced-motion:reduce){.collapsing.collapse-horizontal{transition:none}}.dropdown,.dropend,.dropstart,.dropup{position:relative}.dropdown-toggle{white-space:nowrap}.dropdown-toggle::after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:"";border-top:.3em solid;border-right:.3em solid transparent;border-bottom:0;border-left:.3em solid transparent}.dropdown-toggle:empty::after{margin-left:0}.dropdown-menu{position:absolute;z-index:1000;display:none;min-width:10rem;padding:.5rem 0;margin:0;font-size:1rem;color:#212529;text-align:left;list-style:none;background-color:#fff;background-clip:padding-box;border:1px solid rgba(0,0,0,.15);border-radius:.25rem}.dropdown-menu[data-bs-popper]{top:100%;left:0;margin-top:.125rem}.dropdown-menu-start{--bs-position:start}.dropdown-menu-start[data-bs-popper]{right:auto;left:0}.dropdown-menu-end{--bs-position:end}.dropdown-menu-end[data-bs-popper]{right:0;left:auto}@media (min-width:576px){.dropdown-menu-sm-start{--bs-position:start}.dropdown-menu-sm-start[data-bs-popper]{right:auto;left:0}.dropdown-menu-sm-end{--bs-position:end}.dropdown-menu-sm-end[data-bs-popper]{right:0;left:auto}}@media (min-width:768px){.dropdown-menu-md-start{--bs-position:start}.dropdown-menu-md-start[data-bs-popper]{right:auto;left:0}.dropdown-menu-md-end{--bs-position:end}.dropdown-menu-md-end[data-bs-popper]{right:0;left:auto}}@media (min-width:992px){.dropdown-menu-lg-start{--bs-position:start}.dropdown-menu-lg-start[data-bs-popper]{right:auto;left:0}.dropdown-menu-lg-end{--bs-position:end}.dropdown-menu-lg-end[data-bs-popper]{right:0;left:auto}}@media (min-width:1200px){.dropdown-menu-xl-start{--bs-position:start}.dropdown-menu-xl-start[data-bs-popper]{right:auto;left:0}.dropdown-menu-xl-end{--bs-position:end}.dropdown-menu-xl-end[data-bs-popper]{right:0;left:auto}}@media (min-width:1400px){.dropdown-menu-xxl-start{--bs-position:start}.dropdown-menu-xxl-start[data-bs-popper]{right:auto;left:0}.dropdown-menu-xxl-end{--bs-position:end}.dropdown-menu-xxl-end[data-bs-popper]{right:0;left:auto}}.dropup .dropdown-menu[data-bs-popper]{top:auto;bottom:100%;margin-top:0;margin-bottom:.125rem}.dropup .dropdown-toggle::after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:"";border-top:0;border-right:.3em solid transparent;border-bottom:.3em solid;border-left:.3em solid transparent}.dropup .dropdown-toggle:empty::after{margin-left:0}.dropend .dropdown-menu[data-bs-popper]{top:0;right:auto;left:100%;margin-top:0;margin-left:.125rem}.dropend .dropdown-toggle::after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:"";border-top:.3em solid transparent;border-right:0;border-bottom:.3em solid transparent;border-left:.3em solid}.dropend .dropdown-toggle:empty::after{margin-left:0}.dropend .dropdown-toggle::after{vertical-align:0}.dropstart .dropdown-menu[data-bs-popper]{top:0;right:100%;left:auto;margin-top:0;margin-right:.125rem}.dropstart .dropdown-toggle::after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:""}.dropstart .dropdown-toggle::after{display:none}.dropstart .dropdown-toggle::before{display:inline-block;margin-right:.255em;vertical-align:.255em;content:"";border-top:.3em solid transparent;border-right:.3em solid;border-bottom:.3em solid transparent}.dropstart .dropdown-toggle:empty::after{margin-left:0}.dropstart .dropdown-toggle::before{vertical-align:0}.dropdown-divider{height:0;margin:.5rem 0;overflow:hidden;border-top:1px solid rgba(0,0,0,.15)}.dropdown-item{display:block;width:100%;padding:.25rem 1rem;clear:both;font-weight:400;color:#212529;text-align:inherit;text-decoration:none;white-space:nowrap;background-color:transparent;border:0}.dropdown-item:focus,.dropdown-item:hover{color:#1e2125;background-color:#e9ecef}.dropdown-item.active,.dropdown-item:active{color:#fff;text-decoration:none;background-color:#0d6efd}.dropdown-item.disabled,.dropdown-item:disabled{color:#adb5bd;pointer-events:none;background-color:transparent}.dropdown-menu.show{display:block}.dropdown-header{display:block;padding:.5rem 1rem;margin-bottom:0;font-size:.875rem;color:#6c757d;white-space:nowrap}.dropdown-item-text{display:block;padding:.25rem 1rem;color:#212529}.dropdown-menu-dark{color:#dee2e6;background-color:#343a40;border-color:rgba(0,0,0,.15)}.dropdown-menu-dark .dropdown-item{color:#dee2e6}.dropdown-menu-dark .dropdown-item:focus,.dropdown-menu-dark .dropdown-item:hover{color:#fff;background-color:rgba(255,255,255,.15)}.dropdown-menu-dark .dropdown-item.active,.dropdown-menu-dark .dropdown-item:active{color:#fff;background-color:#0d6efd}.dropdown-menu-dark .dropdown-item.disabled,.dropdown-menu-dark .dropdown-item:disabled{color:#adb5bd}.dropdown-menu-dark .dropdown-divider{border-color:rgba(0,0,0,.15)}.dropdown-menu-dark .dropdown-item-text{color:#dee2e6}.dropdown-menu-dark .dropdown-header{color:#adb5bd}.btn-group,.btn-group-vertical{position:relative;display:inline-flex;vertical-align:middle}.btn-group-vertical>.btn,.btn-group>.btn{position:relative;flex:1 1 auto}.btn-group-vertical>.btn-check:checked+.btn,.btn-group-vertical>.btn-check:focus+.btn,.btn-group-vertical>.btn.active,.btn-group-vertical>.btn:active,.btn-group-vertical>.btn:focus,.btn-group-vertical>.btn:hover,.btn-group>.btn-check:checked+.btn,.btn-group>.btn-check:focus+.btn,.btn-group>.btn.active,.btn-group>.btn:active,.btn-group>.btn:focus,.btn-group>.btn:hover{z-index:1}.btn-toolbar{display:flex;flex-wrap:wrap;justify-content:flex-start}.btn-toolbar .input-group{width:auto}.btn-group>.btn-group:not(:first-child),.btn-group>.btn:not(:first-child){margin-left:-1px}.btn-group>.btn-group:not(:last-child)>.btn,.btn-group>.btn:not(:last-child):not(.dropdown-toggle){border-top-right-radius:0;border-bottom-right-radius:0}.btn-group>.btn-group:not(:first-child)>.btn,.btn-group>.btn:nth-child(n+3),.btn-group>:not(.btn-check)+.btn{border-top-left-radius:0;border-bottom-left-radius:0}.dropdown-toggle-split{padding-right:.5625rem;padding-left:.5625rem}.dropdown-toggle-split::after,.dropend .dropdown-toggle-split::after,.dropup .dropdown-toggle-split::after{margin-left:0}.dropstart .dropdown-toggle-split::before{margin-right:0}.btn-group-sm>.btn+.dropdown-toggle-split,.btn-sm+.dropdown-toggle-split{padding-right:.375rem;padding-left:.375rem}.btn-group-lg>.btn+.dropdown-toggle-split,.btn-lg+.dropdown-toggle-split{padding-right:.75rem;padding-left:.75rem}.btn-group-vertical{flex-direction:column;align-items:flex-start;justify-content:center}.btn-group-vertical>.btn,.btn-group-vertical>.btn-group{width:100%}.btn-group-vertical>.btn-group:not(:first-child),.btn-group-vertical>.btn:not(:first-child){margin-top:-1px}.btn-group-vertical>.btn-group:not(:last-child)>.btn,.btn-group-vertical>.btn:not(:last-child):not(.dropdown-toggle){border-bottom-right-radius:0;border-bottom-left-radius:0}.btn-group-vertical>.btn-group:not(:first-child)>.btn,.btn-group-vertical>.btn~.btn{border-top-left-radius:0;border-top-right-radius:0}.nav{display:flex;flex-wrap:wrap;padding-left:0;margin-bottom:0;list-style:none}.nav-link{display:block;padding:.5rem 1rem;color:#0d6efd;text-decoration:none;transition:color .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out}@media (prefers-reduced-motion:reduce){.nav-link{transition:none}}.nav-link:focus,.nav-link:hover{color:#0a58ca}.nav-link.disabled{color:#6c757d;pointer-events:none;cursor:default}.nav-tabs{border-bottom:1px solid #dee2e6}.nav-tabs .nav-link{margin-bottom:-1px;background:0 0;border:1px solid transparent;border-top-left-radius:.25rem;border-top-right-radius:.25rem}.nav-tabs .nav-link:focus,.nav-tabs .nav-link:hover{border-color:#e9ecef #e9ecef #dee2e6;isolation:isolate}.nav-tabs .nav-link.disabled{color:#6c757d;background-color:transparent;border-color:transparent}.nav-tabs .nav-item.show .nav-link,.nav-tabs .nav-link.active{color:#495057;background-color:#fff;border-color:#dee2e6 #dee2e6 #fff}.nav-tabs .dropdown-menu{margin-top:-1px;border-top-left-radius:0;border-top-right-radius:0}.nav-pills .nav-link{background:0 0;border:0;border-radius:.25rem}.nav-pills .nav-link.active,.nav-pills .show>.nav-link{color:#fff;background-color:#0d6efd}.nav-fill .nav-item,.nav-fill>.nav-link{flex:1 1 auto;text-align:center}.nav-justified .nav-item,.nav-justified>.nav-link{flex-basis:0;flex-grow:1;text-align:center}.nav-fill .nav-item .nav-link,.nav-justified .nav-item .nav-link{width:100%}.tab-content>.tab-pane{display:none}.tab-content>.active{display:block}.navbar{position:relative;display:flex;flex-wrap:wrap;align-items:center;justify-content:space-between;padding-top:.5rem;padding-bottom:.5rem}.navbar>.container,.navbar>.container-fluid,.navbar>.container-lg,.navbar>.container-md,.navbar>.container-sm,.navbar>.container-xl,.navbar>.container-xxl{display:flex;flex-wrap:inherit;align-items:center;justify-content:space-between}.navbar-brand{padding-top:.3125rem;padding-bottom:.3125rem;margin-right:1rem;font-size:1.25rem;text-decoration:none;white-space:nowrap}.navbar-nav{display:flex;flex-direction:column;padding-left:0;margin-bottom:0;list-style:none}.navbar-nav .nav-link{padding-right:0;padding-left:0}.navbar-nav .dropdown-menu{position:static}.navbar-text{padding-top:.5rem;padding-bottom:.5rem}.navbar-collapse{flex-basis:100%;flex-grow:1;align-items:center}.navbar-toggler{padding:.25rem .75rem;font-size:1.25rem;line-height:1;background-color:transparent;border:1px solid transparent;border-radius:.25rem;transition:box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.navbar-toggler{transition:none}}.navbar-toggler:hover{text-decoration:none}.navbar-toggler:focus{text-decoration:none;outline:0;box-shadow:0 0 0 .25rem}.navbar-toggler-icon{display:inline-block;width:1.5em;height:1.5em;vertical-align:middle;background-repeat:no-repeat;background-position:center;background-size:100%}.navbar-nav-scroll{max-height:var(--bs-scroll-height,75vh);overflow-y:auto}@media (min-width:576px){.navbar-expand-sm{flex-wrap:nowrap;justify-content:flex-start}.navbar-expand-sm .navbar-nav{flex-direction:row}.navbar-expand-sm .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-sm .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand-sm .navbar-nav-scroll{overflow:visible}.navbar-expand-sm .navbar-collapse{display:flex!important;flex-basis:auto}.navbar-expand-sm .navbar-toggler{display:none}.navbar-expand-sm .offcanvas-header{display:none}.navbar-expand-sm .offcanvas{position:inherit;bottom:0;z-index:1000;flex-grow:1;visibility:visible!important;background-color:transparent;border-right:0;border-left:0;transition:none;transform:none}.navbar-expand-sm .offcanvas-bottom,.navbar-expand-sm .offcanvas-top{height:auto;border-top:0;border-bottom:0}.navbar-expand-sm .offcanvas-body{display:flex;flex-grow:0;padding:0;overflow-y:visible}}@media (min-width:768px){.navbar-expand-md{flex-wrap:nowrap;justify-content:flex-start}.navbar-expand-md .navbar-nav{flex-direction:row}.navbar-expand-md .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-md .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand-md .navbar-nav-scroll{overflow:visible}.navbar-expand-md .navbar-collapse{display:flex!important;flex-basis:auto}.navbar-expand-md .navbar-toggler{display:none}.navbar-expand-md .offcanvas-header{display:none}.navbar-expand-md .offcanvas{position:inherit;bottom:0;z-index:1000;flex-grow:1;visibility:visible!important;background-color:transparent;border-right:0;border-left:0;transition:none;transform:none}.navbar-expand-md .offcanvas-bottom,.navbar-expand-md .offcanvas-top{height:auto;border-top:0;border-bottom:0}.navbar-expand-md .offcanvas-body{display:flex;flex-grow:0;padding:0;overflow-y:visible}}@media (min-width:992px){.navbar-expand-lg{flex-wrap:nowrap;justify-content:flex-start}.navbar-expand-lg .navbar-nav{flex-direction:row}.navbar-expand-lg .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-lg .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand-lg .navbar-nav-scroll{overflow:visible}.navbar-expand-lg .navbar-collapse{display:flex!important;flex-basis:auto}.navbar-expand-lg .navbar-toggler{display:none}.navbar-expand-lg .offcanvas-header{display:none}.navbar-expand-lg .offcanvas{position:inherit;bottom:0;z-index:1000;flex-grow:1;visibility:visible!important;background-color:transparent;border-right:0;border-left:0;transition:none;transform:none}.navbar-expand-lg .offcanvas-bottom,.navbar-expand-lg .offcanvas-top{height:auto;border-top:0;border-bottom:0}.navbar-expand-lg .offcanvas-body{display:flex;flex-grow:0;padding:0;overflow-y:visible}}@media (min-width:1200px){.navbar-expand-xl{flex-wrap:nowrap;justify-content:flex-start}.navbar-expand-xl .navbar-nav{flex-direction:row}.navbar-expand-xl .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-xl .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand-xl .navbar-nav-scroll{overflow:visible}.navbar-expand-xl .navbar-collapse{display:flex!important;flex-basis:auto}.navbar-expand-xl .navbar-toggler{display:none}.navbar-expand-xl .offcanvas-header{display:none}.navbar-expand-xl .offcanvas{position:inherit;bottom:0;z-index:1000;flex-grow:1;visibility:visible!important;background-color:transparent;border-right:0;border-left:0;transition:none;transform:none}.navbar-expand-xl .offcanvas-bottom,.navbar-expand-xl .offcanvas-top{height:auto;border-top:0;border-bottom:0}.navbar-expand-xl .offcanvas-body{display:flex;flex-grow:0;padding:0;overflow-y:visible}}@media (min-width:1400px){.navbar-expand-xxl{flex-wrap:nowrap;justify-content:flex-start}.navbar-expand-xxl .navbar-nav{flex-direction:row}.navbar-expand-xxl .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-xxl .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand-xxl .navbar-nav-scroll{overflow:visible}.navbar-expand-xxl .navbar-collapse{display:flex!important;flex-basis:auto}.navbar-expand-xxl .navbar-toggler{display:none}.navbar-expand-xxl .offcanvas-header{display:none}.navbar-expand-xxl .offcanvas{position:inherit;bottom:0;z-index:1000;flex-grow:1;visibility:visible!important;background-color:transparent;border-right:0;border-left:0;transition:none;transform:none}.navbar-expand-xxl .offcanvas-bottom,.navbar-expand-xxl .offcanvas-top{height:auto;border-top:0;border-bottom:0}.navbar-expand-xxl .offcanvas-body{display:flex;flex-grow:0;padding:0;overflow-y:visible}}.navbar-expand{flex-wrap:nowrap;justify-content:flex-start}.navbar-expand .navbar-nav{flex-direction:row}.navbar-expand .navbar-nav .dropdown-menu{position:absolute}.navbar-expand .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand .navbar-nav-scroll{overflow:visible}.navbar-expand .navbar-collapse{display:flex!important;flex-basis:auto}.navbar-expand .navbar-toggler{display:none}.navbar-expand .offcanvas-header{display:none}.navbar-expand .offcanvas{position:inherit;bottom:0;z-index:1000;flex-grow:1;visibility:visible!important;background-color:transparent;border-right:0;border-left:0;transition:none;transform:none}.navbar-expand .offcanvas-bottom,.navbar-expand .offcanvas-top{height:auto;border-top:0;border-bottom:0}.navbar-expand .offcanvas-body{display:flex;flex-grow:0;padding:0;overflow-y:visible}.navbar-light .navbar-brand{color:rgba(0,0,0,.9)}.navbar-light .navbar-brand:focus,.navbar-light .navbar-brand:hover{color:rgba(0,0,0,.9)}.navbar-light .navbar-nav .nav-link{color:rgba(0,0,0,.55)}.navbar-light .navbar-nav .nav-link:focus,.navbar-light .navbar-nav .nav-link:hover{color:rgba(0,0,0,.7)}.navbar-light .navbar-nav .nav-link.disabled{color:rgba(0,0,0,.3)}.navbar-light .navbar-nav .nav-link.active,.navbar-light .navbar-nav .show>.nav-link{color:rgba(0,0,0,.9)}.navbar-light .navbar-toggler{color:rgba(0,0,0,.55);border-color:rgba(0,0,0,.1)}.navbar-light .navbar-toggler-icon{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 30 30'%3e%3cpath stroke='rgba%280, 0, 0, 0.55%29' stroke-linecap='round' stroke-miterlimit='10' stroke-width='2' d='M4 7h22M4 15h22M4 23h22'/%3e%3c/svg%3e")}.navbar-light .navbar-text{color:rgba(0,0,0,.55)}.navbar-light .navbar-text a,.navbar-light .navbar-text a:focus,.navbar-light .navbar-text a:hover{color:rgba(0,0,0,.9)}.navbar-dark .navbar-brand{color:#fff}.navbar-dark .navbar-brand:focus,.navbar-dark .navbar-brand:hover{color:#fff}.navbar-dark .navbar-nav .nav-link{color:rgba(255,255,255,.55)}.navbar-dark .navbar-nav .nav-link:focus,.navbar-dark .navbar-nav .nav-link:hover{color:rgba(255,255,255,.75)}.navbar-dark .navbar-nav .nav-link.disabled{color:rgba(255,255,255,.25)}.navbar-dark .navbar-nav .nav-link.active,.navbar-dark .navbar-nav .show>.nav-link{color:#fff}.navbar-dark .navbar-toggler{color:rgba(255,255,255,.55);border-color:rgba(255,255,255,.1)}.navbar-dark .navbar-toggler-icon{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 30 30'%3e%3cpath stroke='rgba%28255, 255, 255, 0.55%29' stroke-linecap='round' stroke-miterlimit='10' stroke-width='2' d='M4 7h22M4 15h22M4 23h22'/%3e%3c/svg%3e")}.navbar-dark .navbar-text{color:rgba(255,255,255,.55)}.navbar-dark .navbar-text a,.navbar-dark .navbar-text a:focus,.navbar-dark .navbar-text a:hover{color:#fff}.card{position:relative;display:flex;flex-direction:column;min-width:0;word-wrap:break-word;background-color:#fff;background-clip:border-box;border:1px solid rgba(0,0,0,.125);border-radius:.25rem}.card>hr{margin-right:0;margin-left:0}.card>.list-group{border-top:inherit;border-bottom:inherit}.card>.list-group:first-child{border-top-width:0;border-top-left-radius:calc(.25rem - 1px);border-top-right-radius:calc(.25rem - 1px)}.card>.list-group:last-child{border-bottom-width:0;border-bottom-right-radius:calc(.25rem - 1px);border-bottom-left-radius:calc(.25rem - 1px)}.card>.card-header+.list-group,.card>.list-group+.card-footer{border-top:0}.card-body{flex:1 1 auto;padding:1rem 1rem}.card-title{margin-bottom:.5rem}.card-subtitle{margin-top:-.25rem;margin-bottom:0}.card-text:last-child{margin-bottom:0}.card-link+.card-link{margin-left:1rem}.card-header{padding:.5rem 1rem;margin-bottom:0;background-color:rgba(0,0,0,.03);border-bottom:1px solid rgba(0,0,0,.125)}.card-header:first-child{border-radius:calc(.25rem - 1px) calc(.25rem - 1px) 0 0}.card-footer{padding:.5rem 1rem;background-color:rgba(0,0,0,.03);border-top:1px solid rgba(0,0,0,.125)}.card-footer:last-child{border-radius:0 0 calc(.25rem - 1px) calc(.25rem - 1px)}.card-header-tabs{margin-right:-.5rem;margin-bottom:-.5rem;margin-left:-.5rem;border-bottom:0}.card-header-pills{margin-right:-.5rem;margin-left:-.5rem}.card-img-overlay{position:absolute;top:0;right:0;bottom:0;left:0;padding:1rem;border-radius:calc(.25rem - 1px)}.card-img,.card-img-bottom,.card-img-top{width:100%}.card-img,.card-img-top{border-top-left-radius:calc(.25rem - 1px);border-top-right-radius:calc(.25rem - 1px)}.card-img,.card-img-bottom{border-bottom-right-radius:calc(.25rem - 1px);border-bottom-left-radius:calc(.25rem - 1px)}.card-group>.card{margin-bottom:.75rem}@media (min-width:576px){.card-group{display:flex;flex-flow:row wrap}.card-group>.card{flex:1 0 0%;margin-bottom:0}.card-group>.card+.card{margin-left:0;border-left:0}.card-group>.card:not(:last-child){border-top-right-radius:0;border-bottom-right-radius:0}.card-group>.card:not(:last-child) .card-header,.card-group>.card:not(:last-child) .card-img-top{border-top-right-radius:0}.card-group>.card:not(:last-child) .card-footer,.card-group>.card:not(:last-child) .card-img-bottom{border-bottom-right-radius:0}.card-group>.card:not(:first-child){border-top-left-radius:0;border-bottom-left-radius:0}.card-group>.card:not(:first-child) .card-header,.card-group>.card:not(:first-child) .card-img-top{border-top-left-radius:0}.card-group>.card:not(:first-child) .card-footer,.card-group>.card:not(:first-child) .card-img-bottom{border-bottom-left-radius:0}}.accordion-button{position:relative;display:flex;align-items:center;width:100%;padding:1rem 1.25rem;font-size:1rem;color:#212529;text-align:left;background-color:#fff;border:0;border-radius:0;overflow-anchor:none;transition:color .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out,border-radius .15s ease}@media (prefers-reduced-motion:reduce){.accordion-button{transition:none}}.accordion-button:not(.collapsed){color:#0c63e4;background-color:#e7f1ff;box-shadow:inset 0 -1px 0 rgba(0,0,0,.125)}.accordion-button:not(.collapsed)::after{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='%230c63e4'%3e%3cpath fill-rule='evenodd' d='M1.646 4.646a.5.5 0 0 1 .708 0L8 10.293l5.646-5.647a.5.5 0 0 1 .708.708l-6 6a.5.5 0 0 1-.708 0l-6-6a.5.5 0 0 1 0-.708z'/%3e%3c/svg%3e");transform:rotate(-180deg)}.accordion-button::after{flex-shrink:0;width:1.25rem;height:1.25rem;margin-left:auto;content:"";background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='%23212529'%3e%3cpath fill-rule='evenodd' d='M1.646 4.646a.5.5 0 0 1 .708 0L8 10.293l5.646-5.647a.5.5 0 0 1 .708.708l-6 6a.5.5 0 0 1-.708 0l-6-6a.5.5 0 0 1 0-.708z'/%3e%3c/svg%3e");background-repeat:no-repeat;background-size:1.25rem;transition:transform .2s ease-in-out}@media (prefers-reduced-motion:reduce){.accordion-button::after{transition:none}}.accordion-button:hover{z-index:2}.accordion-button:focus{z-index:3;border-color:#86b7fe;outline:0;box-shadow:0 0 0 .25rem rgba(13,110,253,.25)}.accordion-header{margin-bottom:0}.accordion-item{background-color:#fff;border:1px solid rgba(0,0,0,.125)}.accordion-item:first-of-type{border-top-left-radius:.25rem;border-top-right-radius:.25rem}.accordion-item:first-of-type .accordion-button{border-top-left-radius:calc(.25rem - 1px);border-top-right-radius:calc(.25rem - 1px)}.accordion-item:not(:first-of-type){border-top:0}.accordion-item:last-of-type{border-bottom-right-radius:.25rem;border-bottom-left-radius:.25rem}.accordion-item:last-of-type .accordion-button.collapsed{border-bottom-right-radius:calc(.25rem - 1px);border-bottom-left-radius:calc(.25rem - 1px)}.accordion-item:last-of-type .accordion-collapse{border-bottom-right-radius:.25rem;border-bottom-left-radius:.25rem}.accordion-body{padding:1rem 1.25rem}.accordion-flush .accordion-collapse{border-width:0}.accordion-flush .accordion-item{border-right:0;border-left:0;border-radius:0}.accordion-flush .accordion-item:first-child{border-top:0}.accordion-flush .accordion-item:last-child{border-bottom:0}.accordion-flush .accordion-item .accordion-button{border-radius:0}.breadcrumb{display:flex;flex-wrap:wrap;padding:0 0;margin-bottom:1rem;list-style:none}.breadcrumb-item+.breadcrumb-item{padding-left:.5rem}.breadcrumb-item+.breadcrumb-item::before{float:left;padding-right:.5rem;color:#6c757d;content:var(--bs-breadcrumb-divider, "/")}.breadcrumb-item.active{color:#6c757d}.pagination{display:flex;padding-left:0;list-style:none}.page-link{position:relative;display:block;color:#0d6efd;text-decoration:none;background-color:#fff;border:1px solid #dee2e6;transition:color .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.page-link{transition:none}}.page-link:hover{z-index:2;color:#0a58ca;background-color:#e9ecef;border-color:#dee2e6}.page-link:focus{z-index:3;color:#0a58ca;background-color:#e9ecef;outline:0;box-shadow:0 0 0 .25rem rgba(13,110,253,.25)}.page-item:not(:first-child) .page-link{margin-left:-1px}.page-item.active .page-link{z-index:3;color:#fff;background-color:#0d6efd;border-color:#0d6efd}.page-item.disabled .page-link{color:#6c757d;pointer-events:none;background-color:#fff;border-color:#dee2e6}.page-link{padding:.375rem .75rem}.page-item:first-child .page-link{border-top-left-radius:.25rem;border-bottom-left-radius:.25rem}.page-item:last-child .page-link{border-top-right-radius:.25rem;border-bottom-right-radius:.25rem}.pagination-lg .page-link{padding:.75rem 1.5rem;font-size:1.25rem}.pagination-lg .page-item:first-child .page-link{border-top-left-radius:.3rem;border-bottom-left-radius:.3rem}.pagination-lg .page-item:last-child .page-link{border-top-right-radius:.3rem;border-bottom-right-radius:.3rem}.pagination-sm .page-link{padding:.25rem .5rem;font-size:.875rem}.pagination-sm .page-item:first-child .page-link{border-top-left-radius:.2rem;border-bottom-left-radius:.2rem}.pagination-sm .page-item:last-child .page-link{border-top-right-radius:.2rem;border-bottom-right-radius:.2rem}.badge{display:inline-block;padding:.35em .65em;font-size:.75em;font-weight:700;line-height:1;color:#fff;text-align:center;white-space:nowrap;vertical-align:baseline;border-radius:.25rem}.badge:empty{display:none}.btn .badge{position:relative;top:-1px}.alert{position:relative;padding:1rem 1rem;margin-bottom:1rem;border:1px solid transparent;border-radius:.25rem}.alert-heading{color:inherit}.alert-link{font-weight:700}.alert-dismissible{padding-right:3rem}.alert-dismissible .btn-close{position:absolute;top:0;right:0;z-index:2;padding:1.25rem 1rem}.alert-primary{color:#084298;background-color:#cfe2ff;border-color:#b6d4fe}.alert-primary .alert-link{color:#06357a}.alert-secondary{color:#41464b;background-color:#e2e3e5;border-color:#d3d6d8}.alert-secondary .alert-link{color:#34383c}.alert-success{color:#0f5132;background-color:#d1e7dd;border-color:#badbcc}.alert-success .alert-link{color:#0c4128}.alert-info{color:#055160;background-color:#cff4fc;border-color:#b6effb}.alert-info .alert-link{color:#04414d}.alert-warning{color:#664d03;background-color:#fff3cd;border-color:#ffecb5}.alert-warning .alert-link{color:#523e02}.alert-danger{color:#842029;background-color:#f8d7da;border-color:#f5c2c7}.alert-danger .alert-link{color:#6a1a21}.alert-light{color:#636464;background-color:#fefefe;border-color:#fdfdfe}.alert-light .alert-link{color:#4f5050}.alert-dark{color:#141619;background-color:#d3d3d4;border-color:#bcbebf}.alert-dark .alert-link{color:#101214}@-webkit-keyframes progress-bar-stripes{0%{background-position-x:1rem}}@keyframes progress-bar-stripes{0%{background-position-x:1rem}}.progress{display:flex;height:1rem;overflow:hidden;font-size:.75rem;background-color:#e9ecef;border-radius:.25rem}.progress-bar{display:flex;flex-direction:column;justify-content:center;overflow:hidden;color:#fff;text-align:center;white-space:nowrap;background-color:#0d6efd;transition:width .6s ease}@media (prefers-reduced-motion:reduce){.progress-bar{transition:none}}.progress-bar-striped{background-image:linear-gradient(45deg,rgba(255,255,255,.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,.15) 50%,rgba(255,255,255,.15) 75%,transparent 75%,transparent);background-size:1rem 1rem}.progress-bar-animated{-webkit-animation:1s linear infinite progress-bar-stripes;animation:1s linear infinite progress-bar-stripes}@media (prefers-reduced-motion:reduce){.progress-bar-animated{-webkit-animation:none;animation:none}}.list-group{display:flex;flex-direction:column;padding-left:0;margin-bottom:0;border-radius:.25rem}.list-group-numbered{list-style-type:none;counter-reset:section}.list-group-numbered>li::before{content:counters(section, ".") ". ";counter-increment:section}.list-group-item-action{width:100%;color:#495057;text-align:inherit}.list-group-item-action:focus,.list-group-item-action:hover{z-index:1;color:#495057;text-decoration:none;background-color:#f8f9fa}.list-group-item-action:active{color:#212529;background-color:#e9ecef}.list-group-item{position:relative;display:block;padding:.5rem 1rem;color:#212529;text-decoration:none;background-color:#fff;border:1px solid rgba(0,0,0,.125)}.list-group-item:first-child{border-top-left-radius:inherit;border-top-right-radius:inherit}.list-group-item:last-child{border-bottom-right-radius:inherit;border-bottom-left-radius:inherit}.list-group-item.disabled,.list-group-item:disabled{color:#6c757d;pointer-events:none;background-color:#fff}.list-group-item.active{z-index:2;color:#fff;background-color:#0d6efd;border-color:#0d6efd}.list-group-item+.list-group-item{border-top-width:0}.list-group-item+.list-group-item.active{margin-top:-1px;border-top-width:1px}.list-group-horizontal{flex-direction:row}.list-group-horizontal>.list-group-item:first-child{border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal>.list-group-item:last-child{border-top-right-radius:.25rem;border-bottom-left-radius:0}.list-group-horizontal>.list-group-item.active{margin-top:0}.list-group-horizontal>.list-group-item+.list-group-item{border-top-width:1px;border-left-width:0}.list-group-horizontal>.list-group-item+.list-group-item.active{margin-left:-1px;border-left-width:1px}@media (min-width:576px){.list-group-horizontal-sm{flex-direction:row}.list-group-horizontal-sm>.list-group-item:first-child{border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal-sm>.list-group-item:last-child{border-top-right-radius:.25rem;border-bottom-left-radius:0}.list-group-horizontal-sm>.list-group-item.active{margin-top:0}.list-group-horizontal-sm>.list-group-item+.list-group-item{border-top-width:1px;border-left-width:0}.list-group-horizontal-sm>.list-group-item+.list-group-item.active{margin-left:-1px;border-left-width:1px}}@media (min-width:768px){.list-group-horizontal-md{flex-direction:row}.list-group-horizontal-md>.list-group-item:first-child{border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal-md>.list-group-item:last-child{border-top-right-radius:.25rem;border-bottom-left-radius:0}.list-group-horizontal-md>.list-group-item.active{margin-top:0}.list-group-horizontal-md>.list-group-item+.list-group-item{border-top-width:1px;border-left-width:0}.list-group-horizontal-md>.list-group-item+.list-group-item.active{margin-left:-1px;border-left-width:1px}}@media (min-width:992px){.list-group-horizontal-lg{flex-direction:row}.list-group-horizontal-lg>.list-group-item:first-child{border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal-lg>.list-group-item:last-child{border-top-right-radius:.25rem;border-bottom-left-radius:0}.list-group-horizontal-lg>.list-group-item.active{margin-top:0}.list-group-horizontal-lg>.list-group-item+.list-group-item{border-top-width:1px;border-left-width:0}.list-group-horizontal-lg>.list-group-item+.list-group-item.active{margin-left:-1px;border-left-width:1px}}@media (min-width:1200px){.list-group-horizontal-xl{flex-direction:row}.list-group-horizontal-xl>.list-group-item:first-child{border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal-xl>.list-group-item:last-child{border-top-right-radius:.25rem;border-bottom-left-radius:0}.list-group-horizontal-xl>.list-group-item.active{margin-top:0}.list-group-horizontal-xl>.list-group-item+.list-group-item{border-top-width:1px;border-left-width:0}.list-group-horizontal-xl>.list-group-item+.list-group-item.active{margin-left:-1px;border-left-width:1px}}@media (min-width:1400px){.list-group-horizontal-xxl{flex-direction:row}.list-group-horizontal-xxl>.list-group-item:first-child{border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal-xxl>.list-group-item:last-child{border-top-right-radius:.25rem;border-bottom-left-radius:0}.list-group-horizontal-xxl>.list-group-item.active{margin-top:0}.list-group-horizontal-xxl>.list-group-item+.list-group-item{border-top-width:1px;border-left-width:0}.list-group-horizontal-xxl>.list-group-item+.list-group-item.active{margin-left:-1px;border-left-width:1px}}.list-group-flush{border-radius:0}.list-group-flush>.list-group-item{border-width:0 0 1px}.list-group-flush>.list-group-item:last-child{border-bottom-width:0}.list-group-item-primary{color:#084298;background-color:#cfe2ff}.list-group-item-primary.list-group-item-action:focus,.list-group-item-primary.list-group-item-action:hover{color:#084298;background-color:#bacbe6}.list-group-item-primary.list-group-item-action.active{color:#fff;background-color:#084298;border-color:#084298}.list-group-item-secondary{color:#41464b;background-color:#e2e3e5}.list-group-item-secondary.list-group-item-action:focus,.list-group-item-secondary.list-group-item-action:hover{color:#41464b;background-color:#cbccce}.list-group-item-secondary.list-group-item-action.active{color:#fff;background-color:#41464b;border-color:#41464b}.list-group-item-success{color:#0f5132;background-color:#d1e7dd}.list-group-item-success.list-group-item-action:focus,.list-group-item-success.list-group-item-action:hover{color:#0f5132;background-color:#bcd0c7}.list-group-item-success.list-group-item-action.active{color:#fff;background-color:#0f5132;border-color:#0f5132}.list-group-item-info{color:#055160;background-color:#cff4fc}.list-group-item-info.list-group-item-action:focus,.list-group-item-info.list-group-item-action:hover{color:#055160;background-color:#badce3}.list-group-item-info.list-group-item-action.active{color:#fff;background-color:#055160;border-color:#055160}.list-group-item-warning{color:#664d03;background-color:#fff3cd}.list-group-item-warning.list-group-item-action:focus,.list-group-item-warning.list-group-item-action:hover{color:#664d03;background-color:#e6dbb9}.list-group-item-warning.list-group-item-action.active{color:#fff;background-color:#664d03;border-color:#664d03}.list-group-item-danger{color:#842029;background-color:#f8d7da}.list-group-item-danger.list-group-item-action:focus,.list-group-item-danger.list-group-item-action:hover{color:#842029;background-color:#dfc2c4}.list-group-item-danger.list-group-item-action.active{color:#fff;background-color:#842029;border-color:#842029}.list-group-item-light{color:#636464;background-color:#fefefe}.list-group-item-light.list-group-item-action:focus,.list-group-item-light.list-group-item-action:hover{color:#636464;background-color:#e5e5e5}.list-group-item-light.list-group-item-action.active{color:#fff;background-color:#636464;border-color:#636464}.list-group-item-dark{color:#141619;background-color:#d3d3d4}.list-group-item-dark.list-group-item-action:focus,.list-group-item-dark.list-group-item-action:hover{color:#141619;background-color:#bebebf}.list-group-item-dark.list-group-item-action.active{color:#fff;background-color:#141619;border-color:#141619}.btn-close{box-sizing:content-box;width:1em;height:1em;padding:.25em .25em;color:#000;background:transparent url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='%23000'%3e%3cpath d='M.293.293a1 1 0 011.414 0L8 6.586 14.293.293a1 1 0 111.414 1.414L9.414 8l6.293 6.293a1 1 0 01-1.414 1.414L8 9.414l-6.293 6.293a1 1 0 01-1.414-1.414L6.586 8 .293 1.707a1 1 0 010-1.414z'/%3e%3c/svg%3e") center/1em auto no-repeat;border:0;border-radius:.25rem;opacity:.5}.btn-close:hover{color:#000;text-decoration:none;opacity:.75}.btn-close:focus{outline:0;box-shadow:0 0 0 .25rem rgba(13,110,253,.25);opacity:1}.btn-close.disabled,.btn-close:disabled{pointer-events:none;-webkit-user-select:none;-moz-user-select:none;user-select:none;opacity:.25}.btn-close-white{filter:invert(1) grayscale(100%) brightness(200%)}.toast{width:350px;max-width:100%;font-size:.875rem;pointer-events:auto;background-color:rgba(255,255,255,.85);background-clip:padding-box;border:1px solid rgba(0,0,0,.1);box-shadow:0 .5rem 1rem rgba(0,0,0,.15);border-radius:.25rem}.toast.showing{opacity:0}.toast:not(.show){display:none}.toast-container{width:-webkit-max-content;width:-moz-max-content;width:max-content;max-width:100%;pointer-events:none}.toast-container>:not(:last-child){margin-bottom:.75rem}.toast-header{display:flex;align-items:center;padding:.5rem .75rem;color:#6c757d;background-color:rgba(255,255,255,.85);background-clip:padding-box;border-bottom:1px solid rgba(0,0,0,.05);border-top-left-radius:calc(.25rem - 1px);border-top-right-radius:calc(.25rem - 1px)}.toast-header .btn-close{margin-right:-.375rem;margin-left:.75rem}.toast-body{padding:.75rem;word-wrap:break-word}.modal{position:fixed;top:0;left:0;z-index:1055;display:none;width:100%;height:100%;overflow-x:hidden;overflow-y:auto;outline:0}.modal-dialog{position:relative;width:auto;margin:.5rem;pointer-events:none}.modal.fade .modal-dialog{transition:transform .3s ease-out;transform:translate(0,-50px)}@media (prefers-reduced-motion:reduce){.modal.fade .modal-dialog{transition:none}}.modal.show .modal-dialog{transform:none}.modal.modal-static .modal-dialog{transform:scale(1.02)}.modal-dialog-scrollable{height:calc(100% - 1rem)}.modal-dialog-scrollable .modal-content{max-height:100%;overflow:hidden}.modal-dialog-scrollable .modal-body{overflow-y:auto}.modal-dialog-centered{display:flex;align-items:center;min-height:calc(100% - 1rem)}.modal-content{position:relative;display:flex;flex-direction:column;width:100%;pointer-events:auto;background-color:#fff;background-clip:padding-box;border:1px solid rgba(0,0,0,.2);border-radius:.3rem;outline:0}.modal-backdrop{position:fixed;top:0;left:0;z-index:1050;width:100vw;height:100vh;background-color:#000}.modal-backdrop.fade{opacity:0}.modal-backdrop.show{opacity:.5}.modal-header{display:flex;flex-shrink:0;align-items:center;justify-content:space-between;padding:1rem 1rem;border-bottom:1px solid #dee2e6;border-top-left-radius:calc(.3rem - 1px);border-top-right-radius:calc(.3rem - 1px)}.modal-header .btn-close{padding:.5rem .5rem;margin:-.5rem -.5rem -.5rem auto}.modal-title{margin-bottom:0;line-height:1.5}.modal-body{position:relative;flex:1 1 auto;padding:1rem}.modal-footer{display:flex;flex-wrap:wrap;flex-shrink:0;align-items:center;justify-content:flex-end;padding:.75rem;border-top:1px solid #dee2e6;border-bottom-right-radius:calc(.3rem - 1px);border-bottom-left-radius:calc(.3rem - 1px)}.modal-footer>*{margin:.25rem}@media (min-width:576px){.modal-dialog{max-width:500px;margin:1.75rem auto}.modal-dialog-scrollable{height:calc(100% - 3.5rem)}.modal-dialog-centered{min-height:calc(100% - 3.5rem)}.modal-sm{max-width:300px}}@media (min-width:992px){.modal-lg,.modal-xl{max-width:800px}}@media (min-width:1200px){.modal-xl{max-width:1140px}}.modal-fullscreen{width:100vw;max-width:none;height:100%;margin:0}.modal-fullscreen .modal-content{height:100%;border:0;border-radius:0}.modal-fullscreen .modal-header{border-radius:0}.modal-fullscreen .modal-body{overflow-y:auto}.modal-fullscreen .modal-footer{border-radius:0}@media (max-width:575.98px){.modal-fullscreen-sm-down{width:100vw;max-width:none;height:100%;margin:0}.modal-fullscreen-sm-down .modal-content{height:100%;border:0;border-radius:0}.modal-fullscreen-sm-down .modal-header{border-radius:0}.modal-fullscreen-sm-down .modal-body{overflow-y:auto}.modal-fullscreen-sm-down .modal-footer{border-radius:0}}@media (max-width:767.98px){.modal-fullscreen-md-down{width:100vw;max-width:none;height:100%;margin:0}.modal-fullscreen-md-down .modal-content{height:100%;border:0;border-radius:0}.modal-fullscreen-md-down .modal-header{border-radius:0}.modal-fullscreen-md-down .modal-body{overflow-y:auto}.modal-fullscreen-md-down .modal-footer{border-radius:0}}@media (max-width:991.98px){.modal-fullscreen-lg-down{width:100vw;max-width:none;height:100%;margin:0}.modal-fullscreen-lg-down .modal-content{height:100%;border:0;border-radius:0}.modal-fullscreen-lg-down .modal-header{border-radius:0}.modal-fullscreen-lg-down .modal-body{overflow-y:auto}.modal-fullscreen-lg-down .modal-footer{border-radius:0}}@media (max-width:1199.98px){.modal-fullscreen-xl-down{width:100vw;max-width:none;height:100%;margin:0}.modal-fullscreen-xl-down .modal-content{height:100%;border:0;border-radius:0}.modal-fullscreen-xl-down .modal-header{border-radius:0}.modal-fullscreen-xl-down .modal-body{overflow-y:auto}.modal-fullscreen-xl-down .modal-footer{border-radius:0}}@media (max-width:1399.98px){.modal-fullscreen-xxl-down{width:100vw;max-width:none;height:100%;margin:0}.modal-fullscreen-xxl-down .modal-content{height:100%;border:0;border-radius:0}.modal-fullscreen-xxl-down .modal-header{border-radius:0}.modal-fullscreen-xxl-down .modal-body{overflow-y:auto}.modal-fullscreen-xxl-down .modal-footer{border-radius:0}}.tooltip{position:absolute;z-index:1080;display:block;margin:0;font-family:var(--bs-font-sans-serif);font-style:normal;font-weight:400;line-height:1.5;text-align:left;text-align:start;text-decoration:none;text-shadow:none;text-transform:none;letter-spacing:normal;word-break:normal;word-spacing:normal;white-space:normal;line-break:auto;font-size:.875rem;word-wrap:break-word;opacity:0}.tooltip.show{opacity:.9}.tooltip .tooltip-arrow{position:absolute;display:block;width:.8rem;height:.4rem}.tooltip .tooltip-arrow::before{position:absolute;content:"";border-color:transparent;border-style:solid}.bs-tooltip-auto[data-popper-placement^=top],.bs-tooltip-top{padding:.4rem 0}.bs-tooltip-auto[data-popper-placement^=top] .tooltip-arrow,.bs-tooltip-top .tooltip-arrow{bottom:0}.bs-tooltip-auto[data-popper-placement^=top] .tooltip-arrow::before,.bs-tooltip-top .tooltip-arrow::before{top:-1px;border-width:.4rem .4rem 0;border-top-color:#000}.bs-tooltip-auto[data-popper-placement^=right],.bs-tooltip-end{padding:0 .4rem}.bs-tooltip-auto[data-popper-placement^=right] .tooltip-arrow,.bs-tooltip-end .tooltip-arrow{left:0;width:.4rem;height:.8rem}.bs-tooltip-auto[data-popper-placement^=right] .tooltip-arrow::before,.bs-tooltip-end .tooltip-arrow::before{right:-1px;border-width:.4rem .4rem .4rem 0;border-right-color:#000}.bs-tooltip-auto[data-popper-placement^=bottom],.bs-tooltip-bottom{padding:.4rem 0}.bs-tooltip-auto[data-popper-placement^=bottom] .tooltip-arrow,.bs-tooltip-bottom .tooltip-arrow{top:0}.bs-tooltip-auto[data-popper-placement^=bottom] .tooltip-arrow::before,.bs-tooltip-bottom .tooltip-arrow::before{bottom:-1px;border-width:0 .4rem .4rem;border-bottom-color:#000}.bs-tooltip-auto[data-popper-placement^=left],.bs-tooltip-start{padding:0 .4rem}.bs-tooltip-auto[data-popper-placement^=left] .tooltip-arrow,.bs-tooltip-start .tooltip-arrow{right:0;width:.4rem;height:.8rem}.bs-tooltip-auto[data-popper-placement^=left] .tooltip-arrow::before,.bs-tooltip-start .tooltip-arrow::before{left:-1px;border-width:.4rem 0 .4rem .4rem;border-left-color:#000}.tooltip-inner{max-width:200px;padding:.25rem .5rem;color:#fff;text-align:center;background-color:#000;border-radius:.25rem}.popover{position:absolute;top:0;left:0;z-index:1070;display:block;max-width:276px;font-family:var(--bs-font-sans-serif);font-style:normal;font-weight:400;line-height:1.5;text-align:left;text-align:start;text-decoration:none;text-shadow:none;text-transform:none;letter-spacing:normal;word-break:normal;word-spacing:normal;white-space:normal;line-break:auto;font-size:.875rem;word-wrap:break-word;background-color:#fff;background-clip:padding-box;border:1px solid rgba(0,0,0,.2);border-radius:.3rem}.popover .popover-arrow{position:absolute;display:block;width:1rem;height:.5rem}.popover .popover-arrow::after,.popover .popover-arrow::before{position:absolute;display:block;content:"";border-color:transparent;border-style:solid}.bs-popover-auto[data-popper-placement^=top]>.popover-arrow,.bs-popover-top>.popover-arrow{bottom:calc(-.5rem - 1px)}.bs-popover-auto[data-popper-placement^=top]>.popover-arrow::before,.bs-popover-top>.popover-arrow::before{bottom:0;border-width:.5rem .5rem 0;border-top-color:rgba(0,0,0,.25)}.bs-popover-auto[data-popper-placement^=top]>.popover-arrow::after,.bs-popover-top>.popover-arrow::after{bottom:1px;border-width:.5rem .5rem 0;border-top-color:#fff}.bs-popover-auto[data-popper-placement^=right]>.popover-arrow,.bs-popover-end>.popover-arrow{left:calc(-.5rem - 1px);width:.5rem;height:1rem}.bs-popover-auto[data-popper-placement^=right]>.popover-arrow::before,.bs-popover-end>.popover-arrow::before{left:0;border-width:.5rem .5rem .5rem 0;border-right-color:rgba(0,0,0,.25)}.bs-popover-auto[data-popper-placement^=right]>.popover-arrow::after,.bs-popover-end>.popover-arrow::after{left:1px;border-width:.5rem .5rem .5rem 0;border-right-color:#fff}.bs-popover-auto[data-popper-placement^=bottom]>.popover-arrow,.bs-popover-bottom>.popover-arrow{top:calc(-.5rem - 1px)}.bs-popover-auto[data-popper-placement^=bottom]>.popover-arrow::before,.bs-popover-bottom>.popover-arrow::before{top:0;border-width:0 .5rem .5rem .5rem;border-bottom-color:rgba(0,0,0,.25)}.bs-popover-auto[data-popper-placement^=bottom]>.popover-arrow::after,.bs-popover-bottom>.popover-arrow::after{top:1px;border-width:0 .5rem .5rem .5rem;border-bottom-color:#fff}.bs-popover-auto[data-popper-placement^=bottom] .popover-header::before,.bs-popover-bottom .popover-header::before{position:absolute;top:0;left:50%;display:block;width:1rem;margin-left:-.5rem;content:"";border-bottom:1px solid #f0f0f0}.bs-popover-auto[data-popper-placement^=left]>.popover-arrow,.bs-popover-start>.popover-arrow{right:calc(-.5rem - 1px);width:.5rem;height:1rem}.bs-popover-auto[data-popper-placement^=left]>.popover-arrow::before,.bs-popover-start>.popover-arrow::before{right:0;border-width:.5rem 0 .5rem .5rem;border-left-color:rgba(0,0,0,.25)}.bs-popover-auto[data-popper-placement^=left]>.popover-arrow::after,.bs-popover-start>.popover-arrow::after{right:1px;border-width:.5rem 0 .5rem .5rem;border-left-color:#fff}.popover-header{padding:.5rem 1rem;margin-bottom:0;font-size:1rem;background-color:#f0f0f0;border-bottom:1px solid rgba(0,0,0,.2);border-top-left-radius:calc(.3rem - 1px);border-top-right-radius:calc(.3rem - 1px)}.popover-header:empty{display:none}.popover-body{padding:1rem 1rem;color:#212529}.carousel{position:relative}.carousel.pointer-event{touch-action:pan-y}.carousel-inner{position:relative;width:100%;overflow:hidden}.carousel-inner::after{display:block;clear:both;content:""}.carousel-item{position:relative;display:none;float:left;width:100%;margin-right:-100%;-webkit-backface-visibility:hidden;backface-visibility:hidden;transition:transform .6s ease-in-out}@media (prefers-reduced-motion:reduce){.carousel-item{transition:none}}.carousel-item-next,.carousel-item-prev,.carousel-item.active{display:block}.active.carousel-item-end,.carousel-item-next:not(.carousel-item-start){transform:translateX(100%)}.active.carousel-item-start,.carousel-item-prev:not(.carousel-item-end){transform:translateX(-100%)}.carousel-fade .carousel-item{opacity:0;transition-property:opacity;transform:none}.carousel-fade .carousel-item-next.carousel-item-start,.carousel-fade .carousel-item-prev.carousel-item-end,.carousel-fade .carousel-item.active{z-index:1;opacity:1}.carousel-fade .active.carousel-item-end,.carousel-fade .active.carousel-item-start{z-index:0;opacity:0;transition:opacity 0s .6s}@media (prefers-reduced-motion:reduce){.carousel-fade .active.carousel-item-end,.carousel-fade .active.carousel-item-start{transition:none}}.carousel-control-next,.carousel-control-prev{position:absolute;top:0;bottom:0;z-index:1;display:flex;align-items:center;justify-content:center;width:15%;padding:0;color:#fff;text-align:center;background:0 0;border:0;opacity:.5;transition:opacity .15s ease}@media (prefers-reduced-motion:reduce){.carousel-control-next,.carousel-control-prev{transition:none}}.carousel-control-next:focus,.carousel-control-next:hover,.carousel-control-prev:focus,.carousel-control-prev:hover{color:#fff;text-decoration:none;outline:0;opacity:.9}.carousel-control-prev{left:0}.carousel-control-next{right:0}.carousel-control-next-icon,.carousel-control-prev-icon{display:inline-block;width:2rem;height:2rem;background-repeat:no-repeat;background-position:50%;background-size:100% 100%}.carousel-control-prev-icon{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='%23fff'%3e%3cpath d='M11.354 1.646a.5.5 0 0 1 0 .708L5.707 8l5.647 5.646a.5.5 0 0 1-.708.708l-6-6a.5.5 0 0 1 0-.708l6-6a.5.5 0 0 1 .708 0z'/%3e%3c/svg%3e")}.carousel-control-next-icon{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='%23fff'%3e%3cpath d='M4.646 1.646a.5.5 0 0 1 .708 0l6 6a.5.5 0 0 1 0 .708l-6 6a.5.5 0 0 1-.708-.708L10.293 8 4.646 2.354a.5.5 0 0 1 0-.708z'/%3e%3c/svg%3e")}.carousel-indicators{position:absolute;right:0;bottom:0;left:0;z-index:2;display:flex;justify-content:center;padding:0;margin-right:15%;margin-bottom:1rem;margin-left:15%;list-style:none}.carousel-indicators [data-bs-target]{box-sizing:content-box;flex:0 1 auto;width:30px;height:3px;padding:0;margin-right:3px;margin-left:3px;text-indent:-999px;cursor:pointer;background-color:#fff;background-clip:padding-box;border:0;border-top:10px solid transparent;border-bottom:10px solid transparent;opacity:.5;transition:opacity .6s ease}@media (prefers-reduced-motion:reduce){.carousel-indicators [data-bs-target]{transition:none}}.carousel-indicators .active{opacity:1}.carousel-caption{position:absolute;right:15%;bottom:1.25rem;left:15%;padding-top:1.25rem;padding-bottom:1.25rem;color:#fff;text-align:center}.carousel-dark .carousel-control-next-icon,.carousel-dark .carousel-control-prev-icon{filter:invert(1) grayscale(100)}.carousel-dark .carousel-indicators [data-bs-target]{background-color:#000}.carousel-dark .carousel-caption{color:#000}@-webkit-keyframes spinner-border{to{transform:rotate(360deg)}}@keyframes spinner-border{to{transform:rotate(360deg)}}.spinner-border{display:inline-block;width:2rem;height:2rem;vertical-align:-.125em;border:.25em solid currentColor;border-right-color:transparent;border-radius:50%;-webkit-animation:.75s linear infinite spinner-border;animation:.75s linear infinite spinner-border}.spinner-border-sm{width:1rem;height:1rem;border-width:.2em}@-webkit-keyframes spinner-grow{0%{transform:scale(0)}50%{opacity:1;transform:none}}@keyframes spinner-grow{0%{transform:scale(0)}50%{opacity:1;transform:none}}.spinner-grow{display:inline-block;width:2rem;height:2rem;vertical-align:-.125em;background-color:currentColor;border-radius:50%;opacity:0;-webkit-animation:.75s linear infinite spinner-grow;animation:.75s linear infinite spinner-grow}.spinner-grow-sm{width:1rem;height:1rem}@media (prefers-reduced-motion:reduce){.spinner-border,.spinner-grow{-webkit-animation-duration:1.5s;animation-duration:1.5s}}.offcanvas{position:fixed;bottom:0;z-index:1045;display:flex;flex-direction:column;max-width:100%;visibility:hidden;background-color:#fff;background-clip:padding-box;outline:0;transition:transform .3s ease-in-out}@media (prefers-reduced-motion:reduce){.offcanvas{transition:none}}.offcanvas-backdrop{position:fixed;top:0;left:0;z-index:1040;width:100vw;height:100vh;background-color:#000}.offcanvas-backdrop.fade{opacity:0}.offcanvas-backdrop.show{opacity:.5}.offcanvas-header{display:flex;align-items:center;justify-content:space-between;padding:1rem 1rem}.offcanvas-header .btn-close{padding:.5rem .5rem;margin-top:-.5rem;margin-right:-.5rem;margin-bottom:-.5rem}.offcanvas-title{margin-bottom:0;line-height:1.5}.offcanvas-body{flex-grow:1;padding:1rem 1rem;overflow-y:auto}.offcanvas-start{top:0;left:0;width:400px;border-right:1px solid rgba(0,0,0,.2);transform:translateX(-100%)}.offcanvas-end{top:0;right:0;width:400px;border-left:1px solid rgba(0,0,0,.2);transform:translateX(100%)}.offcanvas-top{top:0;right:0;left:0;height:30vh;max-height:100%;border-bottom:1px solid rgba(0,0,0,.2);transform:translateY(-100%)}.offcanvas-bottom{right:0;left:0;height:30vh;max-height:100%;border-top:1px solid rgba(0,0,0,.2);transform:translateY(100%)}.offcanvas.show{transform:none}.placeholder{display:inline-block;min-height:1em;vertical-align:middle;cursor:wait;background-color:currentColor;opacity:.5}.placeholder.btn::before{display:inline-block;content:""}.placeholder-xs{min-height:.6em}.placeholder-sm{min-height:.8em}.placeholder-lg{min-height:1.2em}.placeholder-glow .placeholder{-webkit-animation:placeholder-glow 2s ease-in-out infinite;animation:placeholder-glow 2s ease-in-out infinite}@-webkit-keyframes placeholder-glow{50%{opacity:.2}}@keyframes placeholder-glow{50%{opacity:.2}}.placeholder-wave{-webkit-mask-image:linear-gradient(130deg,#000 55%,rgba(0,0,0,0.8) 75%,#000 95%);mask-image:linear-gradient(130deg,#000 55%,rgba(0,0,0,0.8) 75%,#000 95%);-webkit-mask-size:200% 100%;mask-size:200% 100%;-webkit-animation:placeholder-wave 2s linear infinite;animation:placeholder-wave 2s linear infinite}@-webkit-keyframes placeholder-wave{100%{-webkit-mask-position:-200% 0%;mask-position:-200% 0%}}@keyframes placeholder-wave{100%{-webkit-mask-position:-200% 0%;mask-position:-200% 0%}}.clearfix::after{display:block;clear:both;content:""}.link-primary{color:#0d6efd}.link-primary:focus,.link-primary:hover{color:#0a58ca}.link-secondary{color:#6c757d}.link-secondary:focus,.link-secondary:hover{color:#565e64}.link-success{color:#198754}.link-success:focus,.link-success:hover{color:#146c43}.link-info{color:#0dcaf0}.link-info:focus,.link-info:hover{color:#3dd5f3}.link-warning{color:#ffc107}.link-warning:focus,.link-warning:hover{color:#ffcd39}.link-danger{color:#dc3545}.link-danger:focus,.link-danger:hover{color:#b02a37}.link-light{color:#f8f9fa}.link-light:focus,.link-light:hover{color:#f9fafb}.link-dark{color:#212529}.link-dark:focus,.link-dark:hover{color:#1a1e21}.ratio{position:relative;width:100%}.ratio::before{display:block;padding-top:var(--bs-aspect-ratio);content:""}.ratio>*{position:absolute;top:0;left:0;width:100%;height:100%}.ratio-1x1{--bs-aspect-ratio:100%}.ratio-4x3{--bs-aspect-ratio:calc(3 / 4 * 100%)}.ratio-16x9{--bs-aspect-ratio:calc(9 / 16 * 100%)}.ratio-21x9{--bs-aspect-ratio:calc(9 / 21 * 100%)}.fixed-top{position:fixed;top:0;right:0;left:0;z-index:1030}.fixed-bottom{position:fixed;right:0;bottom:0;left:0;z-index:1030}.sticky-top{position:-webkit-sticky;position:sticky;top:0;z-index:1020}@media (min-width:576px){.sticky-sm-top{position:-webkit-sticky;position:sticky;top:0;z-index:1020}}@media (min-width:768px){.sticky-md-top{position:-webkit-sticky;position:sticky;top:0;z-index:1020}}@media (min-width:992px){.sticky-lg-top{position:-webkit-sticky;position:sticky;top:0;z-index:1020}}@media (min-width:1200px){.sticky-xl-top{position:-webkit-sticky;position:sticky;top:0;z-index:1020}}@media (min-width:1400px){.sticky-xxl-top{position:-webkit-sticky;position:sticky;top:0;z-index:1020}}.hstack{display:flex;flex-direction:row;align-items:center;align-self:stretch}.vstack{display:flex;flex:1 1 auto;flex-direction:column;align-self:stretch}.visually-hidden,.visually-hidden-focusable:not(:focus):not(:focus-within){position:absolute!important;width:1px!important;height:1px!important;padding:0!important;margin:-1px!important;overflow:hidden!important;clip:rect(0,0,0,0)!important;white-space:nowrap!important;border:0!important}.stretched-link::after{position:absolute;top:0;right:0;bottom:0;left:0;z-index:1;content:""}.text-truncate{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.vr{display:inline-block;align-self:stretch;width:1px;min-height:1em;background-color:currentColor;opacity:.25}.align-baseline{vertical-align:baseline!important}.align-top{vertical-align:top!important}.align-middle{vertical-align:middle!important}.align-bottom{vertical-align:bottom!important}.align-text-bottom{vertical-align:text-bottom!important}.align-text-top{vertical-align:text-top!important}.float-start{float:left!important}.float-end{float:right!important}.float-none{float:none!important}.opacity-0{opacity:0!important}.opacity-25{opacity:.25!important}.opacity-50{opacity:.5!important}.opacity-75{opacity:.75!important}.opacity-100{opacity:1!important}.overflow-auto{overflow:auto!important}.overflow-hidden{overflow:hidden!important}.overflow-visible{overflow:visible!important}.overflow-scroll{overflow:scroll!important}.d-inline{display:inline!important}.d-inline-block{display:inline-block!important}.d-block{display:block!important}.d-grid{display:grid!important}.d-table{display:table!important}.d-table-row{display:table-row!important}.d-table-cell{display:table-cell!important}.d-flex{display:flex!important}.d-inline-flex{display:inline-flex!important}.d-none{display:none!important}.shadow{box-shadow:0 .5rem 1rem rgba(0,0,0,.15)!important}.shadow-sm{box-shadow:0 .125rem .25rem rgba(0,0,0,.075)!important}.shadow-lg{box-shadow:0 1rem 3rem rgba(0,0,0,.175)!important}.shadow-none{box-shadow:none!important}.position-static{position:static!important}.position-relative{position:relative!important}.position-absolute{position:absolute!important}.position-fixed{position:fixed!important}.position-sticky{position:-webkit-sticky!important;position:sticky!important}.top-0{top:0!important}.top-50{top:50%!important}.top-100{top:100%!important}.bottom-0{bottom:0!important}.bottom-50{bottom:50%!important}.bottom-100{bottom:100%!important}.start-0{left:0!important}.start-50{left:50%!important}.start-100{left:100%!important}.end-0{right:0!important}.end-50{right:50%!important}.end-100{right:100%!important}.translate-middle{transform:translate(-50%,-50%)!important}.translate-middle-x{transform:translateX(-50%)!important}.translate-middle-y{transform:translateY(-50%)!important}.border{border:1px solid #dee2e6!important}.border-0{border:0!important}.border-top{border-top:1px solid #dee2e6!important}.border-top-0{border-top:0!important}.border-end{border-right:1px solid #dee2e6!important}.border-end-0{border-right:0!important}.border-bottom{border-bottom:1px solid #dee2e6!important}.border-bottom-0{border-bottom:0!important}.border-start{border-left:1px solid #dee2e6!important}.border-start-0{border-left:0!important}.border-primary{border-color:#0d6efd!important}.border-secondary{border-color:#6c757d!important}.border-success{border-color:#198754!important}.border-info{border-color:#0dcaf0!important}.border-warning{border-color:#ffc107!important}.border-danger{border-color:#dc3545!important}.border-light{border-color:#f8f9fa!important}.border-dark{border-color:#212529!important}.border-white{border-color:#fff!important}.border-1{border-width:1px!important}.border-2{border-width:2px!important}.border-3{border-width:3px!important}.border-4{border-width:4px!important}.border-5{border-width:5px!important}.w-25{width:25%!important}.w-50{width:50%!important}.w-75{width:75%!important}.w-100{width:100%!important}.w-auto{width:auto!important}.mw-100{max-width:100%!important}.vw-100{width:100vw!important}.min-vw-100{min-width:100vw!important}.h-25{height:25%!important}.h-50{height:50%!important}.h-75{height:75%!important}.h-100{height:100%!important}.h-auto{height:auto!important}.mh-100{max-height:100%!important}.vh-100{height:100vh!important}.min-vh-100{min-height:100vh!important}.flex-fill{flex:1 1 auto!important}.flex-row{flex-direction:row!important}.flex-column{flex-direction:column!important}.flex-row-reverse{flex-direction:row-reverse!important}.flex-column-reverse{flex-direction:column-reverse!important}.flex-grow-0{flex-grow:0!important}.flex-grow-1{flex-grow:1!important}.flex-shrink-0{flex-shrink:0!important}.flex-shrink-1{flex-shrink:1!important}.flex-wrap{flex-wrap:wrap!important}.flex-nowrap{flex-wrap:nowrap!important}.flex-wrap-reverse{flex-wrap:wrap-reverse!important}.gap-0{gap:0!important}.gap-1{gap:.25rem!important}.gap-2{gap:.5rem!important}.gap-3{gap:1rem!important}.gap-4{gap:1.5rem!important}.gap-5{gap:3rem!important}.justify-content-start{justify-content:flex-start!important}.justify-content-end{justify-content:flex-end!important}.justify-content-center{justify-content:center!important}.justify-content-between{justify-content:space-between!important}.justify-content-around{justify-content:space-around!important}.justify-content-evenly{justify-content:space-evenly!important}.align-items-start{align-items:flex-start!important}.align-items-end{align-items:flex-end!important}.align-items-center{align-items:center!important}.align-items-baseline{align-items:baseline!important}.align-items-stretch{align-items:stretch!important}.align-content-start{align-content:flex-start!important}.align-content-end{align-content:flex-end!important}.align-content-center{align-content:center!important}.align-content-between{align-content:space-between!important}.align-content-around{align-content:space-around!important}.align-content-stretch{align-content:stretch!important}.align-self-auto{align-self:auto!important}.align-self-start{align-self:flex-start!important}.align-self-end{align-self:flex-end!important}.align-self-center{align-self:center!important}.align-self-baseline{align-self:baseline!important}.align-self-stretch{align-self:stretch!important}.order-first{order:-1!important}.order-0{order:0!important}.order-1{order:1!important}.order-2{order:2!important}.order-3{order:3!important}.order-4{order:4!important}.order-5{order:5!important}.order-last{order:6!important}.m-0{margin:0!important}.m-1{margin:.25rem!important}.m-2{margin:.5rem!important}.m-3{margin:1rem!important}.m-4{margin:1.5rem!important}.m-5{margin:3rem!important}.m-auto{margin:auto!important}.mx-0{margin-right:0!important;margin-left:0!important}.mx-1{margin-right:.25rem!important;margin-left:.25rem!important}.mx-2{margin-right:.5rem!important;margin-left:.5rem!important}.mx-3{margin-right:1rem!important;margin-left:1rem!important}.mx-4{margin-right:1.5rem!important;margin-left:1.5rem!important}.mx-5{margin-right:3rem!important;margin-left:3rem!important}.mx-auto{margin-right:auto!important;margin-left:auto!important}.my-0{margin-top:0!important;margin-bottom:0!important}.my-1{margin-top:.25rem!important;margin-bottom:.25rem!important}.my-2{margin-top:.5rem!important;margin-bottom:.5rem!important}.my-3{margin-top:1rem!important;margin-bottom:1rem!important}.my-4{margin-top:1.5rem!important;margin-bottom:1.5rem!important}.my-5{margin-top:3rem!important;margin-bottom:3rem!important}.my-auto{margin-top:auto!important;margin-bottom:auto!important}.mt-0{margin-top:0!important}.mt-1{margin-top:.25rem!important}.mt-2{margin-top:.5rem!important}.mt-3{margin-top:1rem!important}.mt-4{margin-top:1.5rem!important}.mt-5{margin-top:3rem!important}.mt-auto{margin-top:auto!important}.me-0{margin-right:0!important}.me-1{margin-right:.25rem!important}.me-2{margin-right:.5rem!important}.me-3{margin-right:1rem!important}.me-4{margin-right:1.5rem!important}.me-5{margin-right:3rem!important}.me-auto{margin-right:auto!important}.mb-0{margin-bottom:0!important}.mb-1{margin-bottom:.25rem!important}.mb-2{margin-bottom:.5rem!important}.mb-3{margin-bottom:1rem!important}.mb-4{margin-bottom:1.5rem!important}.mb-5{margin-bottom:3rem!important}.mb-auto{margin-bottom:auto!important}.ms-0{margin-left:0!important}.ms-1{margin-left:.25rem!important}.ms-2{margin-left:.5rem!important}.ms-3{margin-left:1rem!important}.ms-4{margin-left:1.5rem!important}.ms-5{margin-left:3rem!important}.ms-auto{margin-left:auto!important}.p-0{padding:0!important}.p-1{padding:.25rem!important}.p-2{padding:.5rem!important}.p-3{padding:1rem!important}.p-4{padding:1.5rem!important}.p-5{padding:3rem!important}.px-0{padding-right:0!important;padding-left:0!important}.px-1{padding-right:.25rem!important;padding-left:.25rem!important}.px-2{padding-right:.5rem!important;padding-left:.5rem!important}.px-3{padding-right:1rem!important;padding-left:1rem!important}.px-4{padding-right:1.5rem!important;padding-left:1.5rem!important}.px-5{padding-right:3rem!important;padding-left:3rem!important}.py-0{padding-top:0!important;padding-bottom:0!important}.py-1{padding-top:.25rem!important;padding-bottom:.25rem!important}.py-2{padding-top:.5rem!important;padding-bottom:.5rem!important}.py-3{padding-top:1rem!important;padding-bottom:1rem!important}.py-4{padding-top:1.5rem!important;padding-bottom:1.5rem!important}.py-5{padding-top:3rem!important;padding-bottom:3rem!important}.pt-0{padding-top:0!important}.pt-1{padding-top:.25rem!important}.pt-2{padding-top:.5rem!important}.pt-3{padding-top:1rem!important}.pt-4{padding-top:1.5rem!important}.pt-5{padding-top:3rem!important}.pe-0{padding-right:0!important}.pe-1{padding-right:.25rem!important}.pe-2{padding-right:.5rem!important}.pe-3{padding-right:1rem!important}.pe-4{padding-right:1.5rem!important}.pe-5{padding-right:3rem!important}.pb-0{padding-bottom:0!important}.pb-1{padding-bottom:.25rem!important}.pb-2{padding-bottom:.5rem!important}.pb-3{padding-bottom:1rem!important}.pb-4{padding-bottom:1.5rem!important}.pb-5{padding-bottom:3rem!important}.ps-0{padding-left:0!important}.ps-1{padding-left:.25rem!important}.ps-2{padding-left:.5rem!important}.ps-3{padding-left:1rem!important}.ps-4{padding-left:1.5rem!important}.ps-5{padding-left:3rem!important}.font-monospace{font-family:var(--bs-font-monospace)!important}.fs-1{font-size:calc(1.375rem + 1.5vw)!important}.fs-2{font-size:calc(1.325rem + .9vw)!important}.fs-3{font-size:calc(1.3rem + .6vw)!important}.fs-4{font-size:calc(1.275rem + .3vw)!important}.fs-5{font-size:1.25rem!important}.fs-6{font-size:1rem!important}.fst-italic{font-style:italic!important}.fst-normal{font-style:normal!important}.fw-light{font-weight:300!important}.fw-lighter{font-weight:lighter!important}.fw-normal{font-weight:400!important}.fw-bold{font-weight:700!important}.fw-bolder{font-weight:bolder!important}.lh-1{line-height:1!important}.lh-sm{line-height:1.25!important}.lh-base{line-height:1.5!important}.lh-lg{line-height:2!important}.text-start{text-align:left!important}.text-end{text-align:right!important}.text-center{text-align:center!important}.text-decoration-none{text-decoration:none!important}.text-decoration-underline{text-decoration:underline!important}.text-decoration-line-through{text-decoration:line-through!important}.text-lowercase{text-transform:lowercase!important}.text-uppercase{text-transform:uppercase!important}.text-capitalize{text-transform:capitalize!important}.text-wrap{white-space:normal!important}.text-nowrap{white-space:nowrap!important}.text-break{word-wrap:break-word!important;word-break:break-word!important}.text-primary{--bs-text-opacity:1;color:rgba(var(--bs-primary-rgb),var(--bs-text-opacity))!important}.text-secondary{--bs-text-opacity:1;color:rgba(var(--bs-secondary-rgb),var(--bs-text-opacity))!important}.text-success{--bs-text-opacity:1;color:rgba(var(--bs-success-rgb),var(--bs-text-opacity))!important}.text-info{--bs-text-opacity:1;color:rgba(var(--bs-info-rgb),var(--bs-text-opacity))!important}.text-warning{--bs-text-opacity:1;color:rgba(var(--bs-warning-rgb),var(--bs-text-opacity))!important}.text-danger{--bs-text-opacity:1;color:rgba(var(--bs-danger-rgb),var(--bs-text-opacity))!important}.text-light{--bs-text-opacity:1;color:rgba(var(--bs-light-rgb),var(--bs-text-opacity))!important}.text-dark{--bs-text-opacity:1;color:rgba(var(--bs-dark-rgb),var(--bs-text-opacity))!important}.text-black{--bs-text-opacity:1;color:rgba(var(--bs-black-rgb),var(--bs-text-opacity))!important}.text-white{--bs-text-opacity:1;color:rgba(var(--bs-white-rgb),var(--bs-text-opacity))!important}.text-body{--bs-text-opacity:1;color:rgba(var(--bs-body-rgb),var(--bs-text-opacity))!important}.text-muted{--bs-text-opacity:1;color:#6c757d!important}.text-black-50{--bs-text-opacity:1;color:rgba(0,0,0,.5)!important}.text-white-50{--bs-text-opacity:1;color:rgba(255,255,255,.5)!important}.text-reset{--bs-text-opacity:1;color:inherit!important}.text-opacity-25{--bs-text-opacity:0.25}.text-opacity-50{--bs-text-opacity:0.5}.text-opacity-75{--bs-text-opacity:0.75}.text-opacity-100{--bs-text-opacity:1}.bg-primary{--bs-bg-opacity:1;background-color:rgba(var(--bs-primary-rgb),var(--bs-bg-opacity))!important}.bg-secondary{--bs-bg-opacity:1;background-color:rgba(var(--bs-secondary-rgb),var(--bs-bg-opacity))!important}.bg-success{--bs-bg-opacity:1;background-color:rgba(var(--bs-success-rgb),var(--bs-bg-opacity))!important}.bg-info{--bs-bg-opacity:1;background-color:rgba(var(--bs-info-rgb),var(--bs-bg-opacity))!important}.bg-warning{--bs-bg-opacity:1;background-color:rgba(var(--bs-warning-rgb),var(--bs-bg-opacity))!important}.bg-danger{--bs-bg-opacity:1;background-color:rgba(var(--bs-danger-rgb),var(--bs-bg-opacity))!important}.bg-light{--bs-bg-opacity:1;background-color:rgba(var(--bs-light-rgb),var(--bs-bg-opacity))!important}.bg-dark{--bs-bg-opacity:1;background-color:rgba(var(--bs-dark-rgb),var(--bs-bg-opacity))!important}.bg-black{--bs-bg-opacity:1;background-color:rgba(var(--bs-black-rgb),var(--bs-bg-opacity))!important}.bg-white{--bs-bg-opacity:1;background-color:rgba(var(--bs-white-rgb),var(--bs-bg-opacity))!important}.bg-body{--bs-bg-opacity:1;background-color:rgba(var(--bs-body-rgb),var(--bs-bg-opacity))!important}.bg-transparent{--bs-bg-opacity:1;background-color:transparent!important}.bg-opacity-10{--bs-bg-opacity:0.1}.bg-opacity-25{--bs-bg-opacity:0.25}.bg-opacity-50{--bs-bg-opacity:0.5}.bg-opacity-75{--bs-bg-opacity:0.75}.bg-opacity-100{--bs-bg-opacity:1}.bg-gradient{background-image:var(--bs-gradient)!important}.user-select-all{-webkit-user-select:all!important;-moz-user-select:all!important;user-select:all!important}.user-select-auto{-webkit-user-select:auto!important;-moz-user-select:auto!important;user-select:auto!important}.user-select-none{-webkit-user-select:none!important;-moz-user-select:none!important;user-select:none!important}.pe-none{pointer-events:none!important}.pe-auto{pointer-events:auto!important}.rounded{border-radius:.25rem!important}.rounded-0{border-radius:0!important}.rounded-1{border-radius:.2rem!important}.rounded-2{border-radius:.25rem!important}.rounded-3{border-radius:.3rem!important}.rounded-circle{border-radius:50%!important}.rounded-pill{border-radius:50rem!important}.rounded-top{border-top-left-radius:.25rem!important;border-top-right-radius:.25rem!important}.rounded-end{border-top-right-radius:.25rem!important;border-bottom-right-radius:.25rem!important}.rounded-bottom{border-bottom-right-radius:.25rem!important;border-bottom-left-radius:.25rem!important}.rounded-start{border-bottom-left-radius:.25rem!important;border-top-left-radius:.25rem!important}.visible{visibility:visible!important}.invisible{visibility:hidden!important}@media (min-width:576px){.float-sm-start{float:left!important}.float-sm-end{float:right!important}.float-sm-none{float:none!important}.d-sm-inline{display:inline!important}.d-sm-inline-block{display:inline-block!important}.d-sm-block{display:block!important}.d-sm-grid{display:grid!important}.d-sm-table{display:table!important}.d-sm-table-row{display:table-row!important}.d-sm-table-cell{display:table-cell!important}.d-sm-flex{display:flex!important}.d-sm-inline-flex{display:inline-flex!important}.d-sm-none{display:none!important}.flex-sm-fill{flex:1 1 auto!important}.flex-sm-row{flex-direction:row!important}.flex-sm-column{flex-direction:column!important}.flex-sm-row-reverse{flex-direction:row-reverse!important}.flex-sm-column-reverse{flex-direction:column-reverse!important}.flex-sm-grow-0{flex-grow:0!important}.flex-sm-grow-1{flex-grow:1!important}.flex-sm-shrink-0{flex-shrink:0!important}.flex-sm-shrink-1{flex-shrink:1!important}.flex-sm-wrap{flex-wrap:wrap!important}.flex-sm-nowrap{flex-wrap:nowrap!important}.flex-sm-wrap-reverse{flex-wrap:wrap-reverse!important}.gap-sm-0{gap:0!important}.gap-sm-1{gap:.25rem!important}.gap-sm-2{gap:.5rem!important}.gap-sm-3{gap:1rem!important}.gap-sm-4{gap:1.5rem!important}.gap-sm-5{gap:3rem!important}.justify-content-sm-start{justify-content:flex-start!important}.justify-content-sm-end{justify-content:flex-end!important}.justify-content-sm-center{justify-content:center!important}.justify-content-sm-between{justify-content:space-between!important}.justify-content-sm-around{justify-content:space-around!important}.justify-content-sm-evenly{justify-content:space-evenly!important}.align-items-sm-start{align-items:flex-start!important}.align-items-sm-end{align-items:flex-end!important}.align-items-sm-center{align-items:center!important}.align-items-sm-baseline{align-items:baseline!important}.align-items-sm-stretch{align-items:stretch!important}.align-content-sm-start{align-content:flex-start!important}.align-content-sm-end{align-content:flex-end!important}.align-content-sm-center{align-content:center!important}.align-content-sm-between{align-content:space-between!important}.align-content-sm-around{align-content:space-around!important}.align-content-sm-stretch{align-content:stretch!important}.align-self-sm-auto{align-self:auto!important}.align-self-sm-start{align-self:flex-start!important}.align-self-sm-end{align-self:flex-end!important}.align-self-sm-center{align-self:center!important}.align-self-sm-baseline{align-self:baseline!important}.align-self-sm-stretch{align-self:stretch!important}.order-sm-first{order:-1!important}.order-sm-0{order:0!important}.order-sm-1{order:1!important}.order-sm-2{order:2!important}.order-sm-3{order:3!important}.order-sm-4{order:4!important}.order-sm-5{order:5!important}.order-sm-last{order:6!important}.m-sm-0{margin:0!important}.m-sm-1{margin:.25rem!important}.m-sm-2{margin:.5rem!important}.m-sm-3{margin:1rem!important}.m-sm-4{margin:1.5rem!important}.m-sm-5{margin:3rem!important}.m-sm-auto{margin:auto!important}.mx-sm-0{margin-right:0!important;margin-left:0!important}.mx-sm-1{margin-right:.25rem!important;margin-left:.25rem!important}.mx-sm-2{margin-right:.5rem!important;margin-left:.5rem!important}.mx-sm-3{margin-right:1rem!important;margin-left:1rem!important}.mx-sm-4{margin-right:1.5rem!important;margin-left:1.5rem!important}.mx-sm-5{margin-right:3rem!important;margin-left:3rem!important}.mx-sm-auto{margin-right:auto!important;margin-left:auto!important}.my-sm-0{margin-top:0!important;margin-bottom:0!important}.my-sm-1{margin-top:.25rem!important;margin-bottom:.25rem!important}.my-sm-2{margin-top:.5rem!important;margin-bottom:.5rem!important}.my-sm-3{margin-top:1rem!important;margin-bottom:1rem!important}.my-sm-4{margin-top:1.5rem!important;margin-bottom:1.5rem!important}.my-sm-5{margin-top:3rem!important;margin-bottom:3rem!important}.my-sm-auto{margin-top:auto!important;margin-bottom:auto!important}.mt-sm-0{margin-top:0!important}.mt-sm-1{margin-top:.25rem!important}.mt-sm-2{margin-top:.5rem!important}.mt-sm-3{margin-top:1rem!important}.mt-sm-4{margin-top:1.5rem!important}.mt-sm-5{margin-top:3rem!important}.mt-sm-auto{margin-top:auto!important}.me-sm-0{margin-right:0!important}.me-sm-1{margin-right:.25rem!important}.me-sm-2{margin-right:.5rem!important}.me-sm-3{margin-right:1rem!important}.me-sm-4{margin-right:1.5rem!important}.me-sm-5{margin-right:3rem!important}.me-sm-auto{margin-right:auto!important}.mb-sm-0{margin-bottom:0!important}.mb-sm-1{margin-bottom:.25rem!important}.mb-sm-2{margin-bottom:.5rem!important}.mb-sm-3{margin-bottom:1rem!important}.mb-sm-4{margin-bottom:1.5rem!important}.mb-sm-5{margin-bottom:3rem!important}.mb-sm-auto{margin-bottom:auto!important}.ms-sm-0{margin-left:0!important}.ms-sm-1{margin-left:.25rem!important}.ms-sm-2{margin-left:.5rem!important}.ms-sm-3{margin-left:1rem!important}.ms-sm-4{margin-left:1.5rem!important}.ms-sm-5{margin-left:3rem!important}.ms-sm-auto{margin-left:auto!important}.p-sm-0{padding:0!important}.p-sm-1{padding:.25rem!important}.p-sm-2{padding:.5rem!important}.p-sm-3{padding:1rem!important}.p-sm-4{padding:1.5rem!important}.p-sm-5{padding:3rem!important}.px-sm-0{padding-right:0!important;padding-left:0!important}.px-sm-1{padding-right:.25rem!important;padding-left:.25rem!important}.px-sm-2{padding-right:.5rem!important;padding-left:.5rem!important}.px-sm-3{padding-right:1rem!important;padding-left:1rem!important}.px-sm-4{padding-right:1.5rem!important;padding-left:1.5rem!important}.px-sm-5{padding-right:3rem!important;padding-left:3rem!important}.py-sm-0{padding-top:0!important;padding-bottom:0!important}.py-sm-1{padding-top:.25rem!important;padding-bottom:.25rem!important}.py-sm-2{padding-top:.5rem!important;padding-bottom:.5rem!important}.py-sm-3{padding-top:1rem!important;padding-bottom:1rem!important}.py-sm-4{padding-top:1.5rem!important;padding-bottom:1.5rem!important}.py-sm-5{padding-top:3rem!important;padding-bottom:3rem!important}.pt-sm-0{padding-top:0!important}.pt-sm-1{padding-top:.25rem!important}.pt-sm-2{padding-top:.5rem!important}.pt-sm-3{padding-top:1rem!important}.pt-sm-4{padding-top:1.5rem!important}.pt-sm-5{padding-top:3rem!important}.pe-sm-0{padding-right:0!important}.pe-sm-1{padding-right:.25rem!important}.pe-sm-2{padding-right:.5rem!important}.pe-sm-3{padding-right:1rem!important}.pe-sm-4{padding-right:1.5rem!important}.pe-sm-5{padding-right:3rem!important}.pb-sm-0{padding-bottom:0!important}.pb-sm-1{padding-bottom:.25rem!important}.pb-sm-2{padding-bottom:.5rem!important}.pb-sm-3{padding-bottom:1rem!important}.pb-sm-4{padding-bottom:1.5rem!important}.pb-sm-5{padding-bottom:3rem!important}.ps-sm-0{padding-left:0!important}.ps-sm-1{padding-left:.25rem!important}.ps-sm-2{padding-left:.5rem!important}.ps-sm-3{padding-left:1rem!important}.ps-sm-4{padding-left:1.5rem!important}.ps-sm-5{padding-left:3rem!important}.text-sm-start{text-align:left!important}.text-sm-end{text-align:right!important}.text-sm-center{text-align:center!important}}@media (min-width:768px){.float-md-start{float:left!important}.float-md-end{float:right!important}.float-md-none{float:none!important}.d-md-inline{display:inline!important}.d-md-inline-block{display:inline-block!important}.d-md-block{display:block!important}.d-md-grid{display:grid!important}.d-md-table{display:table!important}.d-md-table-row{display:table-row!important}.d-md-table-cell{display:table-cell!important}.d-md-flex{display:flex!important}.d-md-inline-flex{display:inline-flex!important}.d-md-none{display:none!important}.flex-md-fill{flex:1 1 auto!important}.flex-md-row{flex-direction:row!important}.flex-md-column{flex-direction:column!important}.flex-md-row-reverse{flex-direction:row-reverse!important}.flex-md-column-reverse{flex-direction:column-reverse!important}.flex-md-grow-0{flex-grow:0!important}.flex-md-grow-1{flex-grow:1!important}.flex-md-shrink-0{flex-shrink:0!important}.flex-md-shrink-1{flex-shrink:1!important}.flex-md-wrap{flex-wrap:wrap!important}.flex-md-nowrap{flex-wrap:nowrap!important}.flex-md-wrap-reverse{flex-wrap:wrap-reverse!important}.gap-md-0{gap:0!important}.gap-md-1{gap:.25rem!important}.gap-md-2{gap:.5rem!important}.gap-md-3{gap:1rem!important}.gap-md-4{gap:1.5rem!important}.gap-md-5{gap:3rem!important}.justify-content-md-start{justify-content:flex-start!important}.justify-content-md-end{justify-content:flex-end!important}.justify-content-md-center{justify-content:center!important}.justify-content-md-between{justify-content:space-between!important}.justify-content-md-around{justify-content:space-around!important}.justify-content-md-evenly{justify-content:space-evenly!important}.align-items-md-start{align-items:flex-start!important}.align-items-md-end{align-items:flex-end!important}.align-items-md-center{align-items:center!important}.align-items-md-baseline{align-items:baseline!important}.align-items-md-stretch{align-items:stretch!important}.align-content-md-start{align-content:flex-start!important}.align-content-md-end{align-content:flex-end!important}.align-content-md-center{align-content:center!important}.align-content-md-between{align-content:space-between!important}.align-content-md-around{align-content:space-around!important}.align-content-md-stretch{align-content:stretch!important}.align-self-md-auto{align-self:auto!important}.align-self-md-start{align-self:flex-start!important}.align-self-md-end{align-self:flex-end!important}.align-self-md-center{align-self:center!important}.align-self-md-baseline{align-self:baseline!important}.align-self-md-stretch{align-self:stretch!important}.order-md-first{order:-1!important}.order-md-0{order:0!important}.order-md-1{order:1!important}.order-md-2{order:2!important}.order-md-3{order:3!important}.order-md-4{order:4!important}.order-md-5{order:5!important}.order-md-last{order:6!important}.m-md-0{margin:0!important}.m-md-1{margin:.25rem!important}.m-md-2{margin:.5rem!important}.m-md-3{margin:1rem!important}.m-md-4{margin:1.5rem!important}.m-md-5{margin:3rem!important}.m-md-auto{margin:auto!important}.mx-md-0{margin-right:0!important;margin-left:0!important}.mx-md-1{margin-right:.25rem!important;margin-left:.25rem!important}.mx-md-2{margin-right:.5rem!important;margin-left:.5rem!important}.mx-md-3{margin-right:1rem!important;margin-left:1rem!important}.mx-md-4{margin-right:1.5rem!important;margin-left:1.5rem!important}.mx-md-5{margin-right:3rem!important;margin-left:3rem!important}.mx-md-auto{margin-right:auto!important;margin-left:auto!important}.my-md-0{margin-top:0!important;margin-bottom:0!important}.my-md-1{margin-top:.25rem!important;margin-bottom:.25rem!important}.my-md-2{margin-top:.5rem!important;margin-bottom:.5rem!important}.my-md-3{margin-top:1rem!important;margin-bottom:1rem!important}.my-md-4{margin-top:1.5rem!important;margin-bottom:1.5rem!important}.my-md-5{margin-top:3rem!important;margin-bottom:3rem!important}.my-md-auto{margin-top:auto!important;margin-bottom:auto!important}.mt-md-0{margin-top:0!important}.mt-md-1{margin-top:.25rem!important}.mt-md-2{margin-top:.5rem!important}.mt-md-3{margin-top:1rem!important}.mt-md-4{margin-top:1.5rem!important}.mt-md-5{margin-top:3rem!important}.mt-md-auto{margin-top:auto!important}.me-md-0{margin-right:0!important}.me-md-1{margin-right:.25rem!important}.me-md-2{margin-right:.5rem!important}.me-md-3{margin-right:1rem!important}.me-md-4{margin-right:1.5rem!important}.me-md-5{margin-right:3rem!important}.me-md-auto{margin-right:auto!important}.mb-md-0{margin-bottom:0!important}.mb-md-1{margin-bottom:.25rem!important}.mb-md-2{margin-bottom:.5rem!important}.mb-md-3{margin-bottom:1rem!important}.mb-md-4{margin-bottom:1.5rem!important}.mb-md-5{margin-bottom:3rem!important}.mb-md-auto{margin-bottom:auto!important}.ms-md-0{margin-left:0!important}.ms-md-1{margin-left:.25rem!important}.ms-md-2{margin-left:.5rem!important}.ms-md-3{margin-left:1rem!important}.ms-md-4{margin-left:1.5rem!important}.ms-md-5{margin-left:3rem!important}.ms-md-auto{margin-left:auto!important}.p-md-0{padding:0!important}.p-md-1{padding:.25rem!important}.p-md-2{padding:.5rem!important}.p-md-3{padding:1rem!important}.p-md-4{padding:1.5rem!important}.p-md-5{padding:3rem!important}.px-md-0{padding-right:0!important;padding-left:0!important}.px-md-1{padding-right:.25rem!important;padding-left:.25rem!important}.px-md-2{padding-right:.5rem!important;padding-left:.5rem!important}.px-md-3{padding-right:1rem!important;padding-left:1rem!important}.px-md-4{padding-right:1.5rem!important;padding-left:1.5rem!important}.px-md-5{padding-right:3rem!important;padding-left:3rem!important}.py-md-0{padding-top:0!important;padding-bottom:0!important}.py-md-1{padding-top:.25rem!important;padding-bottom:.25rem!important}.py-md-2{padding-top:.5rem!important;padding-bottom:.5rem!important}.py-md-3{padding-top:1rem!important;padding-bottom:1rem!important}.py-md-4{padding-top:1.5rem!important;padding-bottom:1.5rem!important}.py-md-5{padding-top:3rem!important;padding-bottom:3rem!important}.pt-md-0{padding-top:0!important}.pt-md-1{padding-top:.25rem!important}.pt-md-2{padding-top:.5rem!important}.pt-md-3{padding-top:1rem!important}.pt-md-4{padding-top:1.5rem!important}.pt-md-5{padding-top:3rem!important}.pe-md-0{padding-right:0!important}.pe-md-1{padding-right:.25rem!important}.pe-md-2{padding-right:.5rem!important}.pe-md-3{padding-right:1rem!important}.pe-md-4{padding-right:1.5rem!important}.pe-md-5{padding-right:3rem!important}.pb-md-0{padding-bottom:0!important}.pb-md-1{padding-bottom:.25rem!important}.pb-md-2{padding-bottom:.5rem!important}.pb-md-3{padding-bottom:1rem!important}.pb-md-4{padding-bottom:1.5rem!important}.pb-md-5{padding-bottom:3rem!important}.ps-md-0{padding-left:0!important}.ps-md-1{padding-left:.25rem!important}.ps-md-2{padding-left:.5rem!important}.ps-md-3{padding-left:1rem!important}.ps-md-4{padding-left:1.5rem!important}.ps-md-5{padding-left:3rem!important}.text-md-start{text-align:left!important}.text-md-end{text-align:right!important}.text-md-center{text-align:center!important}}@media (min-width:992px){.float-lg-start{float:left!important}.float-lg-end{float:right!important}.float-lg-none{float:none!important}.d-lg-inline{display:inline!important}.d-lg-inline-block{display:inline-block!important}.d-lg-block{display:block!important}.d-lg-grid{display:grid!important}.d-lg-table{display:table!important}.d-lg-table-row{display:table-row!important}.d-lg-table-cell{display:table-cell!important}.d-lg-flex{display:flex!important}.d-lg-inline-flex{display:inline-flex!important}.d-lg-none{display:none!important}.flex-lg-fill{flex:1 1 auto!important}.flex-lg-row{flex-direction:row!important}.flex-lg-column{flex-direction:column!important}.flex-lg-row-reverse{flex-direction:row-reverse!important}.flex-lg-column-reverse{flex-direction:column-reverse!important}.flex-lg-grow-0{flex-grow:0!important}.flex-lg-grow-1{flex-grow:1!important}.flex-lg-shrink-0{flex-shrink:0!important}.flex-lg-shrink-1{flex-shrink:1!important}.flex-lg-wrap{flex-wrap:wrap!important}.flex-lg-nowrap{flex-wrap:nowrap!important}.flex-lg-wrap-reverse{flex-wrap:wrap-reverse!important}.gap-lg-0{gap:0!important}.gap-lg-1{gap:.25rem!important}.gap-lg-2{gap:.5rem!important}.gap-lg-3{gap:1rem!important}.gap-lg-4{gap:1.5rem!important}.gap-lg-5{gap:3rem!important}.justify-content-lg-start{justify-content:flex-start!important}.justify-content-lg-end{justify-content:flex-end!important}.justify-content-lg-center{justify-content:center!important}.justify-content-lg-between{justify-content:space-between!important}.justify-content-lg-around{justify-content:space-around!important}.justify-content-lg-evenly{justify-content:space-evenly!important}.align-items-lg-start{align-items:flex-start!important}.align-items-lg-end{align-items:flex-end!important}.align-items-lg-center{align-items:center!important}.align-items-lg-baseline{align-items:baseline!important}.align-items-lg-stretch{align-items:stretch!important}.align-content-lg-start{align-content:flex-start!important}.align-content-lg-end{align-content:flex-end!important}.align-content-lg-center{align-content:center!important}.align-content-lg-between{align-content:space-between!important}.align-content-lg-around{align-content:space-around!important}.align-content-lg-stretch{align-content:stretch!important}.align-self-lg-auto{align-self:auto!important}.align-self-lg-start{align-self:flex-start!important}.align-self-lg-end{align-self:flex-end!important}.align-self-lg-center{align-self:center!important}.align-self-lg-baseline{align-self:baseline!important}.align-self-lg-stretch{align-self:stretch!important}.order-lg-first{order:-1!important}.order-lg-0{order:0!important}.order-lg-1{order:1!important}.order-lg-2{order:2!important}.order-lg-3{order:3!important}.order-lg-4{order:4!important}.order-lg-5{order:5!important}.order-lg-last{order:6!important}.m-lg-0{margin:0!important}.m-lg-1{margin:.25rem!important}.m-lg-2{margin:.5rem!important}.m-lg-3{margin:1rem!important}.m-lg-4{margin:1.5rem!important}.m-lg-5{margin:3rem!important}.m-lg-auto{margin:auto!important}.mx-lg-0{margin-right:0!important;margin-left:0!important}.mx-lg-1{margin-right:.25rem!important;margin-left:.25rem!important}.mx-lg-2{margin-right:.5rem!important;margin-left:.5rem!important}.mx-lg-3{margin-right:1rem!important;margin-left:1rem!important}.mx-lg-4{margin-right:1.5rem!important;margin-left:1.5rem!important}.mx-lg-5{margin-right:3rem!important;margin-left:3rem!important}.mx-lg-auto{margin-right:auto!important;margin-left:auto!important}.my-lg-0{margin-top:0!important;margin-bottom:0!important}.my-lg-1{margin-top:.25rem!important;margin-bottom:.25rem!important}.my-lg-2{margin-top:.5rem!important;margin-bottom:.5rem!important}.my-lg-3{margin-top:1rem!important;margin-bottom:1rem!important}.my-lg-4{margin-top:1.5rem!important;margin-bottom:1.5rem!important}.my-lg-5{margin-top:3rem!important;margin-bottom:3rem!important}.my-lg-auto{margin-top:auto!important;margin-bottom:auto!important}.mt-lg-0{margin-top:0!important}.mt-lg-1{margin-top:.25rem!important}.mt-lg-2{margin-top:.5rem!important}.mt-lg-3{margin-top:1rem!important}.mt-lg-4{margin-top:1.5rem!important}.mt-lg-5{margin-top:3rem!important}.mt-lg-auto{margin-top:auto!important}.me-lg-0{margin-right:0!important}.me-lg-1{margin-right:.25rem!important}.me-lg-2{margin-right:.5rem!important}.me-lg-3{margin-right:1rem!important}.me-lg-4{margin-right:1.5rem!important}.me-lg-5{margin-right:3rem!important}.me-lg-auto{margin-right:auto!important}.mb-lg-0{margin-bottom:0!important}.mb-lg-1{margin-bottom:.25rem!important}.mb-lg-2{margin-bottom:.5rem!important}.mb-lg-3{margin-bottom:1rem!important}.mb-lg-4{margin-bottom:1.5rem!important}.mb-lg-5{margin-bottom:3rem!important}.mb-lg-auto{margin-bottom:auto!important}.ms-lg-0{margin-left:0!important}.ms-lg-1{margin-left:.25rem!important}.ms-lg-2{margin-left:.5rem!important}.ms-lg-3{margin-left:1rem!important}.ms-lg-4{margin-left:1.5rem!important}.ms-lg-5{margin-left:3rem!important}.ms-lg-auto{margin-left:auto!important}.p-lg-0{padding:0!important}.p-lg-1{padding:.25rem!important}.p-lg-2{padding:.5rem!important}.p-lg-3{padding:1rem!important}.p-lg-4{padding:1.5rem!important}.p-lg-5{padding:3rem!important}.px-lg-0{padding-right:0!important;padding-left:0!important}.px-lg-1{padding-right:.25rem!important;padding-left:.25rem!important}.px-lg-2{padding-right:.5rem!important;padding-left:.5rem!important}.px-lg-3{padding-right:1rem!important;padding-left:1rem!important}.px-lg-4{padding-right:1.5rem!important;padding-left:1.5rem!important}.px-lg-5{padding-right:3rem!important;padding-left:3rem!important}.py-lg-0{padding-top:0!important;padding-bottom:0!important}.py-lg-1{padding-top:.25rem!important;padding-bottom:.25rem!important}.py-lg-2{padding-top:.5rem!important;padding-bottom:.5rem!important}.py-lg-3{padding-top:1rem!important;padding-bottom:1rem!important}.py-lg-4{padding-top:1.5rem!important;padding-bottom:1.5rem!important}.py-lg-5{padding-top:3rem!important;padding-bottom:3rem!important}.pt-lg-0{padding-top:0!important}.pt-lg-1{padding-top:.25rem!important}.pt-lg-2{padding-top:.5rem!important}.pt-lg-3{padding-top:1rem!important}.pt-lg-4{padding-top:1.5rem!important}.pt-lg-5{padding-top:3rem!important}.pe-lg-0{padding-right:0!important}.pe-lg-1{padding-right:.25rem!important}.pe-lg-2{padding-right:.5rem!important}.pe-lg-3{padding-right:1rem!important}.pe-lg-4{padding-right:1.5rem!important}.pe-lg-5{padding-right:3rem!important}.pb-lg-0{padding-bottom:0!important}.pb-lg-1{padding-bottom:.25rem!important}.pb-lg-2{padding-bottom:.5rem!important}.pb-lg-3{padding-bottom:1rem!important}.pb-lg-4{padding-bottom:1.5rem!important}.pb-lg-5{padding-bottom:3rem!important}.ps-lg-0{padding-left:0!important}.ps-lg-1{padding-left:.25rem!important}.ps-lg-2{padding-left:.5rem!important}.ps-lg-3{padding-left:1rem!important}.ps-lg-4{padding-left:1.5rem!important}.ps-lg-5{padding-left:3rem!important}.text-lg-start{text-align:left!important}.text-lg-end{text-align:right!important}.text-lg-center{text-align:center!important}}@media (min-width:1200px){.float-xl-start{float:left!important}.float-xl-end{float:right!important}.float-xl-none{float:none!important}.d-xl-inline{display:inline!important}.d-xl-inline-block{display:inline-block!important}.d-xl-block{display:block!important}.d-xl-grid{display:grid!important}.d-xl-table{display:table!important}.d-xl-table-row{display:table-row!important}.d-xl-table-cell{display:table-cell!important}.d-xl-flex{display:flex!important}.d-xl-inline-flex{display:inline-flex!important}.d-xl-none{display:none!important}.flex-xl-fill{flex:1 1 auto!important}.flex-xl-row{flex-direction:row!important}.flex-xl-column{flex-direction:column!important}.flex-xl-row-reverse{flex-direction:row-reverse!important}.flex-xl-column-reverse{flex-direction:column-reverse!important}.flex-xl-grow-0{flex-grow:0!important}.flex-xl-grow-1{flex-grow:1!important}.flex-xl-shrink-0{flex-shrink:0!important}.flex-xl-shrink-1{flex-shrink:1!important}.flex-xl-wrap{flex-wrap:wrap!important}.flex-xl-nowrap{flex-wrap:nowrap!important}.flex-xl-wrap-reverse{flex-wrap:wrap-reverse!important}.gap-xl-0{gap:0!important}.gap-xl-1{gap:.25rem!important}.gap-xl-2{gap:.5rem!important}.gap-xl-3{gap:1rem!important}.gap-xl-4{gap:1.5rem!important}.gap-xl-5{gap:3rem!important}.justify-content-xl-start{justify-content:flex-start!important}.justify-content-xl-end{justify-content:flex-end!important}.justify-content-xl-center{justify-content:center!important}.justify-content-xl-between{justify-content:space-between!important}.justify-content-xl-around{justify-content:space-around!important}.justify-content-xl-evenly{justify-content:space-evenly!important}.align-items-xl-start{align-items:flex-start!important}.align-items-xl-end{align-items:flex-end!important}.align-items-xl-center{align-items:center!important}.align-items-xl-baseline{align-items:baseline!important}.align-items-xl-stretch{align-items:stretch!important}.align-content-xl-start{align-content:flex-start!important}.align-content-xl-end{align-content:flex-end!important}.align-content-xl-center{align-content:center!important}.align-content-xl-between{align-content:space-between!important}.align-content-xl-around{align-content:space-around!important}.align-content-xl-stretch{align-content:stretch!important}.align-self-xl-auto{align-self:auto!important}.align-self-xl-start{align-self:flex-start!important}.align-self-xl-end{align-self:flex-end!important}.align-self-xl-center{align-self:center!important}.align-self-xl-baseline{align-self:baseline!important}.align-self-xl-stretch{align-self:stretch!important}.order-xl-first{order:-1!important}.order-xl-0{order:0!important}.order-xl-1{order:1!important}.order-xl-2{order:2!important}.order-xl-3{order:3!important}.order-xl-4{order:4!important}.order-xl-5{order:5!important}.order-xl-last{order:6!important}.m-xl-0{margin:0!important}.m-xl-1{margin:.25rem!important}.m-xl-2{margin:.5rem!important}.m-xl-3{margin:1rem!important}.m-xl-4{margin:1.5rem!important}.m-xl-5{margin:3rem!important}.m-xl-auto{margin:auto!important}.mx-xl-0{margin-right:0!important;margin-left:0!important}.mx-xl-1{margin-right:.25rem!important;margin-left:.25rem!important}.mx-xl-2{margin-right:.5rem!important;margin-left:.5rem!important}.mx-xl-3{margin-right:1rem!important;margin-left:1rem!important}.mx-xl-4{margin-right:1.5rem!important;margin-left:1.5rem!important}.mx-xl-5{margin-right:3rem!important;margin-left:3rem!important}.mx-xl-auto{margin-right:auto!important;margin-left:auto!important}.my-xl-0{margin-top:0!important;margin-bottom:0!important}.my-xl-1{margin-top:.25rem!important;margin-bottom:.25rem!important}.my-xl-2{margin-top:.5rem!important;margin-bottom:.5rem!important}.my-xl-3{margin-top:1rem!important;margin-bottom:1rem!important}.my-xl-4{margin-top:1.5rem!important;margin-bottom:1.5rem!important}.my-xl-5{margin-top:3rem!important;margin-bottom:3rem!important}.my-xl-auto{margin-top:auto!important;margin-bottom:auto!important}.mt-xl-0{margin-top:0!important}.mt-xl-1{margin-top:.25rem!important}.mt-xl-2{margin-top:.5rem!important}.mt-xl-3{margin-top:1rem!important}.mt-xl-4{margin-top:1.5rem!important}.mt-xl-5{margin-top:3rem!important}.mt-xl-auto{margin-top:auto!important}.me-xl-0{margin-right:0!important}.me-xl-1{margin-right:.25rem!important}.me-xl-2{margin-right:.5rem!important}.me-xl-3{margin-right:1rem!important}.me-xl-4{margin-right:1.5rem!important}.me-xl-5{margin-right:3rem!important}.me-xl-auto{margin-right:auto!important}.mb-xl-0{margin-bottom:0!important}.mb-xl-1{margin-bottom:.25rem!important}.mb-xl-2{margin-bottom:.5rem!important}.mb-xl-3{margin-bottom:1rem!important}.mb-xl-4{margin-bottom:1.5rem!important}.mb-xl-5{margin-bottom:3rem!important}.mb-xl-auto{margin-bottom:auto!important}.ms-xl-0{margin-left:0!important}.ms-xl-1{margin-left:.25rem!important}.ms-xl-2{margin-left:.5rem!important}.ms-xl-3{margin-left:1rem!important}.ms-xl-4{margin-left:1.5rem!important}.ms-xl-5{margin-left:3rem!important}.ms-xl-auto{margin-left:auto!important}.p-xl-0{padding:0!important}.p-xl-1{padding:.25rem!important}.p-xl-2{padding:.5rem!important}.p-xl-3{padding:1rem!important}.p-xl-4{padding:1.5rem!important}.p-xl-5{padding:3rem!important}.px-xl-0{padding-right:0!important;padding-left:0!important}.px-xl-1{padding-right:.25rem!important;padding-left:.25rem!important}.px-xl-2{padding-right:.5rem!important;padding-left:.5rem!important}.px-xl-3{padding-right:1rem!important;padding-left:1rem!important}.px-xl-4{padding-right:1.5rem!important;padding-left:1.5rem!important}.px-xl-5{padding-right:3rem!important;padding-left:3rem!important}.py-xl-0{padding-top:0!important;padding-bottom:0!important}.py-xl-1{padding-top:.25rem!important;padding-bottom:.25rem!important}.py-xl-2{padding-top:.5rem!important;padding-bottom:.5rem!important}.py-xl-3{padding-top:1rem!important;padding-bottom:1rem!important}.py-xl-4{padding-top:1.5rem!important;padding-bottom:1.5rem!important}.py-xl-5{padding-top:3rem!important;padding-bottom:3rem!important}.pt-xl-0{padding-top:0!important}.pt-xl-1{padding-top:.25rem!important}.pt-xl-2{padding-top:.5rem!important}.pt-xl-3{padding-top:1rem!important}.pt-xl-4{padding-top:1.5rem!important}.pt-xl-5{padding-top:3rem!important}.pe-xl-0{padding-right:0!important}.pe-xl-1{padding-right:.25rem!important}.pe-xl-2{padding-right:.5rem!important}.pe-xl-3{padding-right:1rem!important}.pe-xl-4{padding-right:1.5rem!important}.pe-xl-5{padding-right:3rem!important}.pb-xl-0{padding-bottom:0!important}.pb-xl-1{padding-bottom:.25rem!important}.pb-xl-2{padding-bottom:.5rem!important}.pb-xl-3{padding-bottom:1rem!important}.pb-xl-4{padding-bottom:1.5rem!important}.pb-xl-5{padding-bottom:3rem!important}.ps-xl-0{padding-left:0!important}.ps-xl-1{padding-left:.25rem!important}.ps-xl-2{padding-left:.5rem!important}.ps-xl-3{padding-left:1rem!important}.ps-xl-4{padding-left:1.5rem!important}.ps-xl-5{padding-left:3rem!important}.text-xl-start{text-align:left!important}.text-xl-end{text-align:right!important}.text-xl-center{text-align:center!important}}@media (min-width:1400px){.float-xxl-start{float:left!important}.float-xxl-end{float:right!important}.float-xxl-none{float:none!important}.d-xxl-inline{display:inline!important}.d-xxl-inline-block{display:inline-block!important}.d-xxl-block{display:block!important}.d-xxl-grid{display:grid!important}.d-xxl-table{display:table!important}.d-xxl-table-row{display:table-row!important}.d-xxl-table-cell{display:table-cell!important}.d-xxl-flex{display:flex!important}.d-xxl-inline-flex{display:inline-flex!important}.d-xxl-none{display:none!important}.flex-xxl-fill{flex:1 1 auto!important}.flex-xxl-row{flex-direction:row!important}.flex-xxl-column{flex-direction:column!important}.flex-xxl-row-reverse{flex-direction:row-reverse!important}.flex-xxl-column-reverse{flex-direction:column-reverse!important}.flex-xxl-grow-0{flex-grow:0!important}.flex-xxl-grow-1{flex-grow:1!important}.flex-xxl-shrink-0{flex-shrink:0!important}.flex-xxl-shrink-1{flex-shrink:1!important}.flex-xxl-wrap{flex-wrap:wrap!important}.flex-xxl-nowrap{flex-wrap:nowrap!important}.flex-xxl-wrap-reverse{flex-wrap:wrap-reverse!important}.gap-xxl-0{gap:0!important}.gap-xxl-1{gap:.25rem!important}.gap-xxl-2{gap:.5rem!important}.gap-xxl-3{gap:1rem!important}.gap-xxl-4{gap:1.5rem!important}.gap-xxl-5{gap:3rem!important}.justify-content-xxl-start{justify-content:flex-start!important}.justify-content-xxl-end{justify-content:flex-end!important}.justify-content-xxl-center{justify-content:center!important}.justify-content-xxl-between{justify-content:space-between!important}.justify-content-xxl-around{justify-content:space-around!important}.justify-content-xxl-evenly{justify-content:space-evenly!important}.align-items-xxl-start{align-items:flex-start!important}.align-items-xxl-end{align-items:flex-end!important}.align-items-xxl-center{align-items:center!important}.align-items-xxl-baseline{align-items:baseline!important}.align-items-xxl-stretch{align-items:stretch!important}.align-content-xxl-start{align-content:flex-start!important}.align-content-xxl-end{align-content:flex-end!important}.align-content-xxl-center{align-content:center!important}.align-content-xxl-between{align-content:space-between!important}.align-content-xxl-around{align-content:space-around!important}.align-content-xxl-stretch{align-content:stretch!important}.align-self-xxl-auto{align-self:auto!important}.align-self-xxl-start{align-self:flex-start!important}.align-self-xxl-end{align-self:flex-end!important}.align-self-xxl-center{align-self:center!important}.align-self-xxl-baseline{align-self:baseline!important}.align-self-xxl-stretch{align-self:stretch!important}.order-xxl-first{order:-1!important}.order-xxl-0{order:0!important}.order-xxl-1{order:1!important}.order-xxl-2{order:2!important}.order-xxl-3{order:3!important}.order-xxl-4{order:4!important}.order-xxl-5{order:5!important}.order-xxl-last{order:6!important}.m-xxl-0{margin:0!important}.m-xxl-1{margin:.25rem!important}.m-xxl-2{margin:.5rem!important}.m-xxl-3{margin:1rem!important}.m-xxl-4{margin:1.5rem!important}.m-xxl-5{margin:3rem!important}.m-xxl-auto{margin:auto!important}.mx-xxl-0{margin-right:0!important;margin-left:0!important}.mx-xxl-1{margin-right:.25rem!important;margin-left:.25rem!important}.mx-xxl-2{margin-right:.5rem!important;margin-left:.5rem!important}.mx-xxl-3{margin-right:1rem!important;margin-left:1rem!important}.mx-xxl-4{margin-right:1.5rem!important;margin-left:1.5rem!important}.mx-xxl-5{margin-right:3rem!important;margin-left:3rem!important}.mx-xxl-auto{margin-right:auto!important;margin-left:auto!important}.my-xxl-0{margin-top:0!important;margin-bottom:0!important}.my-xxl-1{margin-top:.25rem!important;margin-bottom:.25rem!important}.my-xxl-2{margin-top:.5rem!important;margin-bottom:.5rem!important}.my-xxl-3{margin-top:1rem!important;margin-bottom:1rem!important}.my-xxl-4{margin-top:1.5rem!important;margin-bottom:1.5rem!important}.my-xxl-5{margin-top:3rem!important;margin-bottom:3rem!important}.my-xxl-auto{margin-top:auto!important;margin-bottom:auto!important}.mt-xxl-0{margin-top:0!important}.mt-xxl-1{margin-top:.25rem!important}.mt-xxl-2{margin-top:.5rem!important}.mt-xxl-3{margin-top:1rem!important}.mt-xxl-4{margin-top:1.5rem!important}.mt-xxl-5{margin-top:3rem!important}.mt-xxl-auto{margin-top:auto!important}.me-xxl-0{margin-right:0!important}.me-xxl-1{margin-right:.25rem!important}.me-xxl-2{margin-right:.5rem!important}.me-xxl-3{margin-right:1rem!important}.me-xxl-4{margin-right:1.5rem!important}.me-xxl-5{margin-right:3rem!important}.me-xxl-auto{margin-right:auto!important}.mb-xxl-0{margin-bottom:0!important}.mb-xxl-1{margin-bottom:.25rem!important}.mb-xxl-2{margin-bottom:.5rem!important}.mb-xxl-3{margin-bottom:1rem!important}.mb-xxl-4{margin-bottom:1.5rem!important}.mb-xxl-5{margin-bottom:3rem!important}.mb-xxl-auto{margin-bottom:auto!important}.ms-xxl-0{margin-left:0!important}.ms-xxl-1{margin-left:.25rem!important}.ms-xxl-2{margin-left:.5rem!important}.ms-xxl-3{margin-left:1rem!important}.ms-xxl-4{margin-left:1.5rem!important}.ms-xxl-5{margin-left:3rem!important}.ms-xxl-auto{margin-left:auto!important}.p-xxl-0{padding:0!important}.p-xxl-1{padding:.25rem!important}.p-xxl-2{padding:.5rem!important}.p-xxl-3{padding:1rem!important}.p-xxl-4{padding:1.5rem!important}.p-xxl-5{padding:3rem!important}.px-xxl-0{padding-right:0!important;padding-left:0!important}.px-xxl-1{padding-right:.25rem!important;padding-left:.25rem!important}.px-xxl-2{padding-right:.5rem!important;padding-left:.5rem!important}.px-xxl-3{padding-right:1rem!important;padding-left:1rem!important}.px-xxl-4{padding-right:1.5rem!important;padding-left:1.5rem!important}.px-xxl-5{padding-right:3rem!important;padding-left:3rem!important}.py-xxl-0{padding-top:0!important;padding-bottom:0!important}.py-xxl-1{padding-top:.25rem!important;padding-bottom:.25rem!important}.py-xxl-2{padding-top:.5rem!important;padding-bottom:.5rem!important}.py-xxl-3{padding-top:1rem!important;padding-bottom:1rem!important}.py-xxl-4{padding-top:1.5rem!important;padding-bottom:1.5rem!important}.py-xxl-5{padding-top:3rem!important;padding-bottom:3rem!important}.pt-xxl-0{padding-top:0!important}.pt-xxl-1{padding-top:.25rem!important}.pt-xxl-2{padding-top:.5rem!important}.pt-xxl-3{padding-top:1rem!important}.pt-xxl-4{padding-top:1.5rem!important}.pt-xxl-5{padding-top:3rem!important}.pe-xxl-0{padding-right:0!important}.pe-xxl-1{padding-right:.25rem!important}.pe-xxl-2{padding-right:.5rem!important}.pe-xxl-3{padding-right:1rem!important}.pe-xxl-4{padding-right:1.5rem!important}.pe-xxl-5{padding-right:3rem!important}.pb-xxl-0{padding-bottom:0!important}.pb-xxl-1{padding-bottom:.25rem!important}.pb-xxl-2{padding-bottom:.5rem!important}.pb-xxl-3{padding-bottom:1rem!important}.pb-xxl-4{padding-bottom:1.5rem!important}.pb-xxl-5{padding-bottom:3rem!important}.ps-xxl-0{padding-left:0!important}.ps-xxl-1{padding-left:.25rem!important}.ps-xxl-2{padding-left:.5rem!important}.ps-xxl-3{padding-left:1rem!important}.ps-xxl-4{padding-left:1.5rem!important}.ps-xxl-5{padding-left:3rem!important}.text-xxl-start{text-align:left!important}.text-xxl-end{text-align:right!important}.text-xxl-center{text-align:center!important}}@media (min-width:1200px){.fs-1{font-size:2.5rem!important}.fs-2{font-size:2rem!important}.fs-3{font-size:1.75rem!important}.fs-4{font-size:1.5rem!important}}@media print{.d-print-inline{display:inline!important}.d-print-inline-block{display:inline-block!important}.d-print-block{display:block!important}.d-print-grid{display:grid!important}.d-print-table{display:table!important}.d-print-table-row{display:table-row!important}.d-print-table-cell{display:table-cell!important}.d-print-flex{display:flex!important}.d-print-inline-flex{display:inline-flex!important}.d-print-none{display:none!important}}
+/*# sourceMappingURL=bootstrap.min.css.map */
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/bootstrap/bootstrap.min.css.map b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/bootstrap/bootstrap.min.css.map
new file mode 100644
index 0000000000..afcd9e33e9
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/bootstrap/bootstrap.min.css.map
@@ -0,0 +1 @@
+{"version":3,"sources":["../../scss/bootstrap.scss","../../scss/_root.scss","../../scss/_reboot.scss","dist/css/bootstrap.css","../../scss/vendor/_rfs.scss","../../scss/mixins/_border-radius.scss","../../scss/_type.scss","../../scss/mixins/_lists.scss","../../scss/_images.scss","../../scss/mixins/_image.scss","../../scss/_containers.scss","../../scss/mixins/_container.scss","../../scss/mixins/_breakpoints.scss","../../scss/_grid.scss","../../scss/mixins/_grid.scss","../../scss/_tables.scss","../../scss/mixins/_table-variants.scss","../../scss/forms/_labels.scss","../../scss/forms/_form-text.scss","../../scss/forms/_form-control.scss","../../scss/mixins/_transition.scss","../../scss/mixins/_gradients.scss","../../scss/forms/_form-select.scss","../../scss/forms/_form-check.scss","../../scss/forms/_form-range.scss","../../scss/forms/_floating-labels.scss","../../scss/forms/_input-group.scss","../../scss/mixins/_forms.scss","../../scss/_buttons.scss","../../scss/mixins/_buttons.scss","../../scss/_transitions.scss","../../scss/_dropdown.scss","../../scss/mixins/_caret.scss","../../scss/_button-group.scss","../../scss/_nav.scss","../../scss/_navbar.scss","../../scss/_card.scss","../../scss/_accordion.scss","../../scss/_breadcrumb.scss","../../scss/_pagination.scss","../../scss/mixins/_pagination.scss","../../scss/_badge.scss","../../scss/_alert.scss","../../scss/mixins/_alert.scss","../../scss/_progress.scss","../../scss/_list-group.scss","../../scss/mixins/_list-group.scss","../../scss/_close.scss","../../scss/_toasts.scss","../../scss/_modal.scss","../../scss/mixins/_backdrop.scss","../../scss/_tooltip.scss","../../scss/mixins/_reset-text.scss","../../scss/_popover.scss","../../scss/_carousel.scss","../../scss/mixins/_clearfix.scss","../../scss/_spinners.scss","../../scss/_offcanvas.scss","../../scss/_placeholders.scss","../../scss/helpers/_colored-links.scss","../../scss/helpers/_ratio.scss","../../scss/helpers/_position.scss","../../scss/helpers/_stacks.scss","../../scss/helpers/_visually-hidden.scss","../../scss/mixins/_visually-hidden.scss","../../scss/helpers/_stretched-link.scss","../../scss/helpers/_text-truncation.scss","../../scss/mixins/_text-truncate.scss","../../scss/helpers/_vr.scss","../../scss/mixins/_utilities.scss","../../scss/utilities/_api.scss"],"names":[],"mappings":"iBAAA;;;;;ACAA,MAQI,UAAA,QAAA,YAAA,QAAA,YAAA,QAAA,UAAA,QAAA,SAAA,QAAA,YAAA,QAAA,YAAA,QAAA,WAAA,QAAA,UAAA,QAAA,UAAA,QAAA,WAAA,KAAA,UAAA,QAAA,eAAA,QAIA,cAAA,QAAA,cAAA,QAAA,cAAA,QAAA,cAAA,QAAA,cAAA,QAAA,cAAA,QAAA,cAAA,QAAA,cAAA,QAAA,cAAA,QAIA,aAAA,QAAA,eAAA,QAAA,aAAA,QAAA,UAAA,QAAA,aAAA,QAAA,YAAA,QAAA,WAAA,QAAA,UAAA,QAIA,iBAAA,EAAA,CAAA,GAAA,CAAA,IAAA,mBAAA,GAAA,CAAA,GAAA,CAAA,IAAA,iBAAA,EAAA,CAAA,GAAA,CAAA,GAAA,cAAA,EAAA,CAAA,GAAA,CAAA,IAAA,iBAAA,GAAA,CAAA,GAAA,CAAA,EAAA,gBAAA,GAAA,CAAA,EAAA,CAAA,GAAA,eAAA,GAAA,CAAA,GAAA,CAAA,IAAA,cAAA,EAAA,CAAA,EAAA,CAAA,GAGF,eAAA,GAAA,CAAA,GAAA,CAAA,IACA,eAAA,CAAA,CAAA,CAAA,CAAA,EACA,cAAA,EAAA,CAAA,EAAA,CAAA,GAMA,qBAAA,SAAA,CAAA,aAAA,CAAA,UAAA,CAAA,MAAA,CAAA,gBAAA,CAAA,KAAA,CAAA,WAAA,CAAA,iBAAA,CAAA,UAAA,CAAA,mBAAA,CAAA,gBAAA,CAAA,iBAAA,CAAA,mBACA,oBAAA,cAAA,CAAA,KAAA,CAAA,MAAA,CAAA,QAAA,CAAA,iBAAA,CAAA,aAAA,CAAA,UACA,cAAA,2EAQA,sBAAA,0BACA,oBAAA,KACA,sBAAA,IACA,sBAAA,IACA,gBAAA,QAIA,aAAA,KClCF,EC+CA,QADA,SD3CE,WAAA,WAeE,8CANJ,MAOM,gBAAA,QAcN,KACE,OAAA,EACA,YAAA,2BEmPI,UAAA,yBFjPJ,YAAA,2BACA,YAAA,2BACA,MAAA,qBACA,WAAA,0BACA,iBAAA,kBACA,yBAAA,KACA,4BAAA,YAUF,GACE,OAAA,KAAA,EACA,MAAA,QACA,iBAAA,aACA,OAAA,EACA,QAAA,IAGF,eACE,OAAA,IAUF,IAAA,IAAA,IAAA,IAAA,IAAA,IAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GACE,WAAA,EACA,cAAA,MAGA,YAAA,IACA,YAAA,IAIF,IAAA,GEwMQ,UAAA,uBAlKJ,0BFtCJ,IAAA,GE+MQ,UAAA,QF1MR,IAAA,GEmMQ,UAAA,sBAlKJ,0BFjCJ,IAAA,GE0MQ,UAAA,MFrMR,IAAA,GE8LQ,UAAA,oBAlKJ,0BF5BJ,IAAA,GEqMQ,UAAA,SFhMR,IAAA,GEyLQ,UAAA,sBAlKJ,0BFvBJ,IAAA,GEgMQ,UAAA,QF3LR,IAAA,GEgLM,UAAA,QF3KN,IAAA,GE2KM,UAAA,KFhKN,EACE,WAAA,EACA,cAAA,KCmBF,6BDRA,YAEE,wBAAA,UAAA,OAAA,gBAAA,UAAA,OACA,OAAA,KACA,iCAAA,KAAA,yBAAA,KAMF,QACE,cAAA,KACA,WAAA,OACA,YAAA,QAMF,GCIA,GDFE,aAAA,KCQF,GDLA,GCIA,GDDE,WAAA,EACA,cAAA,KAGF,MCKA,MACA,MAFA,MDAE,cAAA,EAGF,GACE,YAAA,IAKF,GACE,cAAA,MACA,YAAA,EAMF,WACE,OAAA,EAAA,EAAA,KAQF,ECNA,ODQE,YAAA,OAQF,OAAA,ME4EM,UAAA,OFrEN,MAAA,KACE,QAAA,KACA,iBAAA,QASF,ICpBA,IDsBE,SAAA,SEwDI,UAAA,MFtDJ,YAAA,EACA,eAAA,SAGF,IAAM,OAAA,OACN,IAAM,IAAA,MAKN,EACE,MAAA,QACA,gBAAA,UAEA,QACE,MAAA,QAWF,2BAAA,iCAEE,MAAA,QACA,gBAAA,KCxBJ,KACA,ID8BA,IC7BA,KDiCE,YAAA,yBEcI,UAAA,IFZJ,UAAA,IACA,aAAA,cAOF,IACE,QAAA,MACA,WAAA,EACA,cAAA,KACA,SAAA,KEAI,UAAA,OFKJ,SELI,UAAA,QFOF,MAAA,QACA,WAAA,OAIJ,KEZM,UAAA,OFcJ,MAAA,QACA,UAAA,WAGA,OACE,MAAA,QAIJ,IACE,QAAA,MAAA,MExBI,UAAA,OF0BJ,MAAA,KACA,iBAAA,QG7SE,cAAA,MHgTF,QACE,QAAA,EE/BE,UAAA,IFiCF,YAAA,IASJ,OACE,OAAA,EAAA,EAAA,KAMF,ICjDA,IDmDE,eAAA,OAQF,MACE,aAAA,OACA,gBAAA,SAGF,QACE,YAAA,MACA,eAAA,MACA,MAAA,QACA,WAAA,KAOF,GAEE,WAAA,QACA,WAAA,qBCxDF,MAGA,GAFA,MAGA,GDuDA,MCzDA,GD+DE,aAAA,QACA,aAAA,MACA,aAAA,EAQF,MACE,QAAA,aAMF,OAEE,cAAA,EAQF,iCACE,QAAA,ECtEF,OD2EA,MCzEA,SADA,OAEA,SD6EE,OAAA,EACA,YAAA,QE9HI,UAAA,QFgIJ,YAAA,QAIF,OC5EA,OD8EE,eAAA,KAKF,cACE,OAAA,QAGF,OAGE,UAAA,OAGA,gBACE,QAAA,EAOJ,0CACE,QAAA,KClFF,cACA,aACA,cDwFA,OAIE,mBAAA,OCxFF,6BACA,4BACA,6BDyFI,sBACE,OAAA,QAON,mBACE,QAAA,EACA,aAAA,KAKF,SACE,OAAA,SAUF,SACE,UAAA,EACA,QAAA,EACA,OAAA,EACA,OAAA,EAQF,OACE,MAAA,KACA,MAAA,KACA,QAAA,EACA,cAAA,MEnNM,UAAA,sBFsNN,YAAA,QExXE,0BFiXJ,OExMQ,UAAA,QFiNN,SACE,MAAA,KChGJ,kCDuGA,uCCxGA,mCADA,+BAGA,oCAJA,6BAKA,mCD4GE,QAAA,EAGF,4BACE,OAAA,KASF,cACE,eAAA,KACA,mBAAA,UAmBF,4BACE,mBAAA,KAKF,+BACE,QAAA,EAMF,uBACE,KAAA,QAMF,6BACE,KAAA,QACA,mBAAA,OAKF,OACE,QAAA,aAKF,OACE,OAAA,EAOF,QACE,QAAA,UACA,OAAA,QAQF,SACE,eAAA,SAQF,SACE,QAAA,eInlBF,MFyQM,UAAA,QEvQJ,YAAA,IAKA,WFsQM,UAAA,uBEpQJ,YAAA,IACA,YAAA,IFiGA,0BEpGF,WF6QM,UAAA,ME7QN,WFsQM,UAAA,uBEpQJ,YAAA,IACA,YAAA,IFiGA,0BEpGF,WF6QM,UAAA,QE7QN,WFsQM,UAAA,uBEpQJ,YAAA,IACA,YAAA,IFiGA,0BEpGF,WF6QM,UAAA,ME7QN,WFsQM,UAAA,uBEpQJ,YAAA,IACA,YAAA,IFiGA,0BEpGF,WF6QM,UAAA,QE7QN,WFsQM,UAAA,uBEpQJ,YAAA,IACA,YAAA,IFiGA,0BEpGF,WF6QM,UAAA,ME7QN,WFsQM,UAAA,uBEpQJ,YAAA,IACA,YAAA,IFiGA,0BEpGF,WF6QM,UAAA,QEvPR,eCrDE,aAAA,EACA,WAAA,KDyDF,aC1DE,aAAA,EACA,WAAA,KD4DF,kBACE,QAAA,aAEA,mCACE,aAAA,MAUJ,YFsNM,UAAA,OEpNJ,eAAA,UAIF,YACE,cAAA,KF+MI,UAAA,QE5MJ,wBACE,cAAA,EAIJ,mBACE,WAAA,MACA,cAAA,KFqMI,UAAA,OEnMJ,MAAA,QAEA,2BACE,QAAA,KE9FJ,WCIE,UAAA,KAGA,OAAA,KDDF,eACE,QAAA,OACA,iBAAA,KACA,OAAA,IAAA,MAAA,QHGE,cAAA,OIRF,UAAA,KAGA,OAAA,KDcF,QAEE,QAAA,aAGF,YACE,cAAA,MACA,YAAA,EAGF,gBJ+PM,UAAA,OI7PJ,MAAA,QElCA,WPqmBF,iBAGA,cACA,cACA,cAHA,cADA,eQzmBE,MAAA,KACA,cAAA,0BACA,aAAA,0BACA,aAAA,KACA,YAAA,KCwDE,yBF5CE,WAAA,cACE,UAAA,OE2CJ,yBF5CE,WAAA,cAAA,cACE,UAAA,OE2CJ,yBF5CE,WAAA,cAAA,cAAA,cACE,UAAA,OE2CJ,0BF5CE,WAAA,cAAA,cAAA,cAAA,cACE,UAAA,QE2CJ,0BF5CE,WAAA,cAAA,cAAA,cAAA,cAAA,eACE,UAAA,QGfN,KCAA,cAAA,OACA,cAAA,EACA,QAAA,KACA,UAAA,KACA,WAAA,8BACA,aAAA,+BACA,YAAA,+BDHE,OCYF,YAAA,EACA,MAAA,KACA,UAAA,KACA,cAAA,8BACA,aAAA,8BACA,WAAA,mBA+CI,KACE,KAAA,EAAA,EAAA,GAGF,iBApCJ,KAAA,EAAA,EAAA,KACA,MAAA,KAcA,cACE,KAAA,EAAA,EAAA,KACA,MAAA,KAFF,cACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,cACE,KAAA,EAAA,EAAA,KACA,MAAA,eAFF,cACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,cACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,cACE,KAAA,EAAA,EAAA,KACA,MAAA,eA+BE,UAhDJ,KAAA,EAAA,EAAA,KACA,MAAA,KAqDQ,OAhEN,KAAA,EAAA,EAAA,KACA,MAAA,YA+DM,OAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,OAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,OAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,OAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,OAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,OAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,OAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,OAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,QAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,QAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,QAhEN,KAAA,EAAA,EAAA,KACA,MAAA,KAuEQ,UAxDV,YAAA,YAwDU,UAxDV,YAAA,aAwDU,UAxDV,YAAA,IAwDU,UAxDV,YAAA,aAwDU,UAxDV,YAAA,aAwDU,UAxDV,YAAA,IAwDU,UAxDV,YAAA,aAwDU,UAxDV,YAAA,aAwDU,UAxDV,YAAA,IAwDU,WAxDV,YAAA,aAwDU,WAxDV,YAAA,aAmEM,KXusBR,MWrsBU,cAAA,EAGF,KXusBR,MWrsBU,cAAA,EAPF,KXitBR,MW/sBU,cAAA,QAGF,KXitBR,MW/sBU,cAAA,QAPF,KX2tBR,MWztBU,cAAA,OAGF,KX2tBR,MWztBU,cAAA,OAPF,KXquBR,MWnuBU,cAAA,KAGF,KXquBR,MWnuBU,cAAA,KAPF,KX+uBR,MW7uBU,cAAA,OAGF,KX+uBR,MW7uBU,cAAA,OAPF,KXyvBR,MWvvBU,cAAA,KAGF,KXyvBR,MWvvBU,cAAA,KFzDN,yBESE,QACE,KAAA,EAAA,EAAA,GAGF,oBApCJ,KAAA,EAAA,EAAA,KACA,MAAA,KAcA,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,KAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,eAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,eA+BE,aAhDJ,KAAA,EAAA,EAAA,KACA,MAAA,KAqDQ,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,YA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,KAuEQ,aAxDV,YAAA,EAwDU,aAxDV,YAAA,YAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,IAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,IAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,IAwDU,cAxDV,YAAA,aAwDU,cAxDV,YAAA,aAmEM,QX45BR,SW15BU,cAAA,EAGF,QX45BR,SW15BU,cAAA,EAPF,QXs6BR,SWp6BU,cAAA,QAGF,QXs6BR,SWp6BU,cAAA,QAPF,QXg7BR,SW96BU,cAAA,OAGF,QXg7BR,SW96BU,cAAA,OAPF,QX07BR,SWx7BU,cAAA,KAGF,QX07BR,SWx7BU,cAAA,KAPF,QXo8BR,SWl8BU,cAAA,OAGF,QXo8BR,SWl8BU,cAAA,OAPF,QX88BR,SW58BU,cAAA,KAGF,QX88BR,SW58BU,cAAA,MFzDN,yBESE,QACE,KAAA,EAAA,EAAA,GAGF,oBApCJ,KAAA,EAAA,EAAA,KACA,MAAA,KAcA,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,KAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,eAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,eA+BE,aAhDJ,KAAA,EAAA,EAAA,KACA,MAAA,KAqDQ,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,YA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,KAuEQ,aAxDV,YAAA,EAwDU,aAxDV,YAAA,YAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,IAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,IAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,IAwDU,cAxDV,YAAA,aAwDU,cAxDV,YAAA,aAmEM,QXinCR,SW/mCU,cAAA,EAGF,QXinCR,SW/mCU,cAAA,EAPF,QX2nCR,SWznCU,cAAA,QAGF,QX2nCR,SWznCU,cAAA,QAPF,QXqoCR,SWnoCU,cAAA,OAGF,QXqoCR,SWnoCU,cAAA,OAPF,QX+oCR,SW7oCU,cAAA,KAGF,QX+oCR,SW7oCU,cAAA,KAPF,QXypCR,SWvpCU,cAAA,OAGF,QXypCR,SWvpCU,cAAA,OAPF,QXmqCR,SWjqCU,cAAA,KAGF,QXmqCR,SWjqCU,cAAA,MFzDN,yBESE,QACE,KAAA,EAAA,EAAA,GAGF,oBApCJ,KAAA,EAAA,EAAA,KACA,MAAA,KAcA,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,KAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,eAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,eA+BE,aAhDJ,KAAA,EAAA,EAAA,KACA,MAAA,KAqDQ,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,YA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,KAuEQ,aAxDV,YAAA,EAwDU,aAxDV,YAAA,YAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,IAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,IAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,IAwDU,cAxDV,YAAA,aAwDU,cAxDV,YAAA,aAmEM,QXs0CR,SWp0CU,cAAA,EAGF,QXs0CR,SWp0CU,cAAA,EAPF,QXg1CR,SW90CU,cAAA,QAGF,QXg1CR,SW90CU,cAAA,QAPF,QX01CR,SWx1CU,cAAA,OAGF,QX01CR,SWx1CU,cAAA,OAPF,QXo2CR,SWl2CU,cAAA,KAGF,QXo2CR,SWl2CU,cAAA,KAPF,QX82CR,SW52CU,cAAA,OAGF,QX82CR,SW52CU,cAAA,OAPF,QXw3CR,SWt3CU,cAAA,KAGF,QXw3CR,SWt3CU,cAAA,MFzDN,0BESE,QACE,KAAA,EAAA,EAAA,GAGF,oBApCJ,KAAA,EAAA,EAAA,KACA,MAAA,KAcA,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,KAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,eAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,eA+BE,aAhDJ,KAAA,EAAA,EAAA,KACA,MAAA,KAqDQ,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,YA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,KAuEQ,aAxDV,YAAA,EAwDU,aAxDV,YAAA,YAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,IAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,IAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,IAwDU,cAxDV,YAAA,aAwDU,cAxDV,YAAA,aAmEM,QX2hDR,SWzhDU,cAAA,EAGF,QX2hDR,SWzhDU,cAAA,EAPF,QXqiDR,SWniDU,cAAA,QAGF,QXqiDR,SWniDU,cAAA,QAPF,QX+iDR,SW7iDU,cAAA,OAGF,QX+iDR,SW7iDU,cAAA,OAPF,QXyjDR,SWvjDU,cAAA,KAGF,QXyjDR,SWvjDU,cAAA,KAPF,QXmkDR,SWjkDU,cAAA,OAGF,QXmkDR,SWjkDU,cAAA,OAPF,QX6kDR,SW3kDU,cAAA,KAGF,QX6kDR,SW3kDU,cAAA,MFzDN,0BESE,SACE,KAAA,EAAA,EAAA,GAGF,qBApCJ,KAAA,EAAA,EAAA,KACA,MAAA,KAcA,kBACE,KAAA,EAAA,EAAA,KACA,MAAA,KAFF,kBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,kBACE,KAAA,EAAA,EAAA,KACA,MAAA,eAFF,kBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,kBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,kBACE,KAAA,EAAA,EAAA,KACA,MAAA,eA+BE,cAhDJ,KAAA,EAAA,EAAA,KACA,MAAA,KAqDQ,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,YA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,YAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,YAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,YAhEN,KAAA,EAAA,EAAA,KACA,MAAA,KAuEQ,cAxDV,YAAA,EAwDU,cAxDV,YAAA,YAwDU,cAxDV,YAAA,aAwDU,cAxDV,YAAA,IAwDU,cAxDV,YAAA,aAwDU,cAxDV,YAAA,aAwDU,cAxDV,YAAA,IAwDU,cAxDV,YAAA,aAwDU,cAxDV,YAAA,aAwDU,cAxDV,YAAA,IAwDU,eAxDV,YAAA,aAwDU,eAxDV,YAAA,aAmEM,SXgvDR,UW9uDU,cAAA,EAGF,SXgvDR,UW9uDU,cAAA,EAPF,SX0vDR,UWxvDU,cAAA,QAGF,SX0vDR,UWxvDU,cAAA,QAPF,SXowDR,UWlwDU,cAAA,OAGF,SXowDR,UWlwDU,cAAA,OAPF,SX8wDR,UW5wDU,cAAA,KAGF,SX8wDR,UW5wDU,cAAA,KAPF,SXwxDR,UWtxDU,cAAA,OAGF,SXwxDR,UWtxDU,cAAA,OAPF,SXkyDR,UWhyDU,cAAA,KAGF,SXkyDR,UWhyDU,cAAA,MCpHV,OACE,cAAA,YACA,qBAAA,YACA,yBAAA,QACA,sBAAA,oBACA,wBAAA,QACA,qBAAA,mBACA,uBAAA,QACA,oBAAA,qBAEA,MAAA,KACA,cAAA,KACA,MAAA,QACA,eAAA,IACA,aAAA,QAOA,yBACE,QAAA,MAAA,MACA,iBAAA,mBACA,oBAAA,IACA,WAAA,MAAA,EAAA,EAAA,EAAA,OAAA,0BAGF,aACE,eAAA,QAGF,aACE,eAAA,OAIF,uCACE,oBAAA,aASJ,aACE,aAAA,IAUA,4BACE,QAAA,OAAA,OAeF,gCACE,aAAA,IAAA,EAGA,kCACE,aAAA,EAAA,IAOJ,oCACE,oBAAA,EASF,yCACE,qBAAA,2BACA,MAAA,8BAQJ,cACE,qBAAA,0BACA,MAAA,6BAQA,4BACE,qBAAA,yBACA,MAAA,4BCxHF,eAME,cAAA,QACA,sBAAA,QACA,yBAAA,KACA,qBAAA,QACA,wBAAA,KACA,oBAAA,QACA,uBAAA,KAEA,MAAA,KACA,aAAA,QAfF,iBAME,cAAA,QACA,sBAAA,QACA,yBAAA,KACA,qBAAA,QACA,wBAAA,KACA,oBAAA,QACA,uBAAA,KAEA,MAAA,KACA,aAAA,QAfF,eAME,cAAA,QACA,sBAAA,QACA,yBAAA,KACA,qBAAA,QACA,wBAAA,KACA,oBAAA,QACA,uBAAA,KAEA,MAAA,KACA,aAAA,QAfF,YAME,cAAA,QACA,sBAAA,QACA,yBAAA,KACA,qBAAA,QACA,wBAAA,KACA,oBAAA,QACA,uBAAA,KAEA,MAAA,KACA,aAAA,QAfF,eAME,cAAA,QACA,sBAAA,QACA,yBAAA,KACA,qBAAA,QACA,wBAAA,KACA,oBAAA,QACA,uBAAA,KAEA,MAAA,KACA,aAAA,QAfF,cAME,cAAA,QACA,sBAAA,QACA,yBAAA,KACA,qBAAA,QACA,wBAAA,KACA,oBAAA,QACA,uBAAA,KAEA,MAAA,KACA,aAAA,QAfF,aAME,cAAA,QACA,sBAAA,QACA,yBAAA,KACA,qBAAA,QACA,wBAAA,KACA,oBAAA,QACA,uBAAA,KAEA,MAAA,KACA,aAAA,QAfF,YAME,cAAA,QACA,sBAAA,QACA,yBAAA,KACA,qBAAA,QACA,wBAAA,KACA,oBAAA,QACA,uBAAA,KAEA,MAAA,KACA,aAAA,QDgIA,kBACE,WAAA,KACA,2BAAA,MHvEF,4BGqEA,qBACE,WAAA,KACA,2BAAA,OHvEF,4BGqEA,qBACE,WAAA,KACA,2BAAA,OHvEF,4BGqEA,qBACE,WAAA,KACA,2BAAA,OHvEF,6BGqEA,qBACE,WAAA,KACA,2BAAA,OHvEF,6BGqEA,sBACE,WAAA,KACA,2BAAA,OE/IN,YACE,cAAA,MASF,gBACE,YAAA,oBACA,eAAA,oBACA,cAAA,EboRI,UAAA,QahRJ,YAAA,IAIF,mBACE,YAAA,kBACA,eAAA,kBb0QI,UAAA,QatQN,mBACE,YAAA,mBACA,eAAA,mBboQI,UAAA,QcjSN,WACE,WAAA,OdgSI,UAAA,Oc5RJ,MAAA,QCLF,cACE,QAAA,MACA,MAAA,KACA,QAAA,QAAA,Of8RI,UAAA,Ke3RJ,YAAA,IACA,YAAA,IACA,MAAA,QACA,iBAAA,KACA,gBAAA,YACA,OAAA,IAAA,MAAA,QACA,mBAAA,KAAA,gBAAA,KAAA,WAAA,KdGE,cAAA,OeHE,WAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YAIA,uCDhBN,cCiBQ,WAAA,MDGN,yBACE,SAAA,OAEA,wDACE,OAAA,QAKJ,oBACE,MAAA,QACA,iBAAA,KACA,aAAA,QACA,QAAA,EAKE,WAAA,EAAA,EAAA,EAAA,OAAA,qBAOJ,2CAEE,OAAA,MAIF,gCACE,MAAA,QAEA,QAAA,EAHF,2BACE,MAAA,QAEA,QAAA,EAQF,uBAAA,wBAEE,iBAAA,QAGA,QAAA,EAIF,oCACE,QAAA,QAAA,OACA,OAAA,SAAA,QACA,mBAAA,OAAA,kBAAA,OACA,MAAA,QE3EF,iBAAA,QF6EE,eAAA,KACA,aAAA,QACA,aAAA,MACA,aAAA,EACA,wBAAA,IACA,cAAA,ECtEE,WAAA,MAAA,KAAA,WAAA,CAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YAIA,uCDuDJ,oCCtDM,WAAA,MDqEN,yEACE,iBAAA,QAGF,0CACE,QAAA,QAAA,OACA,OAAA,SAAA,QACA,mBAAA,OAAA,kBAAA,OACA,MAAA,QE9FF,iBAAA,QFgGE,eAAA,KACA,aAAA,QACA,aAAA,MACA,aAAA,EACA,wBAAA,IACA,cAAA,ECzFE,mBAAA,MAAA,KAAA,WAAA,CAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YAAA,WAAA,MAAA,KAAA,WAAA,CAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YAIA,uCD0EJ,0CCzEM,mBAAA,KAAA,WAAA,MDwFN,+EACE,iBAAA,QASJ,wBACE,QAAA,MACA,MAAA,KACA,QAAA,QAAA,EACA,cAAA,EACA,YAAA,IACA,MAAA,QACA,iBAAA,YACA,OAAA,MAAA,YACA,aAAA,IAAA,EAEA,wCAAA,wCAEE,cAAA,EACA,aAAA,EAWJ,iBACE,WAAA,0BACA,QAAA,OAAA,MfmJI,UAAA,QClRF,cAAA,McmIF,uCACE,QAAA,OAAA,MACA,OAAA,QAAA,OACA,mBAAA,MAAA,kBAAA,MAGF,6CACE,QAAA,OAAA,MACA,OAAA,QAAA,OACA,mBAAA,MAAA,kBAAA,MAIJ,iBACE,WAAA,yBACA,QAAA,MAAA,KfgII,UAAA,QClRF,cAAA,McsJF,uCACE,QAAA,MAAA,KACA,OAAA,OAAA,MACA,mBAAA,KAAA,kBAAA,KAGF,6CACE,QAAA,MAAA,KACA,OAAA,OAAA,MACA,mBAAA,KAAA,kBAAA,KAQF,sBACE,WAAA,2BAGF,yBACE,WAAA,0BAGF,yBACE,WAAA,yBAKJ,oBACE,MAAA,KACA,OAAA,KACA,QAAA,QAEA,mDACE,OAAA,QAGF,uCACE,OAAA,Md/LA,cAAA,OcmMF,0CACE,OAAA,MdpMA,cAAA,OiBdJ,aACE,QAAA,MACA,MAAA,KACA,QAAA,QAAA,QAAA,QAAA,OAEA,mBAAA,oBlB2RI,UAAA,KkBxRJ,YAAA,IACA,YAAA,IACA,MAAA,QACA,iBAAA,KACA,iBAAA,gOACA,kBAAA,UACA,oBAAA,MAAA,OAAA,OACA,gBAAA,KAAA,KACA,OAAA,IAAA,MAAA,QjBFE,cAAA,OeHE,WAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YESJ,mBAAA,KAAA,gBAAA,KAAA,WAAA,KFLI,uCEfN,aFgBQ,WAAA,MEMN,mBACE,aAAA,QACA,QAAA,EAKE,WAAA,EAAA,EAAA,EAAA,OAAA,qBAIJ,uBAAA,mCAEE,cAAA,OACA,iBAAA,KAGF,sBAEE,iBAAA,QAKF,4BACE,MAAA,YACA,YAAA,EAAA,EAAA,EAAA,QAIJ,gBACE,YAAA,OACA,eAAA,OACA,aAAA,MlByOI,UAAA,QkBrON,gBACE,YAAA,MACA,eAAA,MACA,aAAA,KlBkOI,UAAA,QmBjSN,YACE,QAAA,MACA,WAAA,OACA,aAAA,MACA,cAAA,QAEA,8BACE,MAAA,KACA,YAAA,OAIJ,kBACE,MAAA,IACA,OAAA,IACA,WAAA,MACA,eAAA,IACA,iBAAA,KACA,kBAAA,UACA,oBAAA,OACA,gBAAA,QACA,OAAA,IAAA,MAAA,gBACA,mBAAA,KAAA,gBAAA,KAAA,WAAA,KACA,2BAAA,MAAA,aAAA,MAGA,iClBXE,cAAA,MkBeF,8BAEE,cAAA,IAGF,yBACE,OAAA,gBAGF,wBACE,aAAA,QACA,QAAA,EACA,WAAA,EAAA,EAAA,EAAA,OAAA,qBAGF,0BACE,iBAAA,QACA,aAAA,QAEA,yCAII,iBAAA,8NAIJ,sCAII,iBAAA,sIAKN,+CACE,iBAAA,QACA,aAAA,QAKE,iBAAA,wNAIJ,2BACE,eAAA,KACA,OAAA,KACA,QAAA,GAOA,6CAAA,8CACE,QAAA,GAcN,aACE,aAAA,MAEA,+BACE,MAAA,IACA,YAAA,OACA,iBAAA,uJACA,oBAAA,KAAA,OlB9FA,cAAA,IeHE,WAAA,oBAAA,KAAA,YAIA,uCGyFJ,+BHxFM,WAAA,MGgGJ,qCACE,iBAAA,yIAGF,uCACE,oBAAA,MAAA,OAKE,iBAAA,sIAMR,mBACE,QAAA,aACA,aAAA,KAGF,WACE,SAAA,SACA,KAAA,cACA,eAAA,KAIE,yBAAA,0BACE,eAAA,KACA,OAAA,KACA,QAAA,IC9IN,YACE,MAAA,KACA,OAAA,OACA,QAAA,EACA,iBAAA,YACA,mBAAA,KAAA,gBAAA,KAAA,WAAA,KAEA,kBACE,QAAA,EAIA,wCAA0B,WAAA,EAAA,EAAA,EAAA,IAAA,IAAA,CAAA,EAAA,EAAA,EAAA,OAAA,qBAC1B,oCAA0B,WAAA,EAAA,EAAA,EAAA,IAAA,IAAA,CAAA,EAAA,EAAA,EAAA,OAAA,qBAG5B,8BACE,OAAA,EAGF,kCACE,MAAA,KACA,OAAA,KACA,WAAA,QHzBF,iBAAA,QG2BE,OAAA,EnBZA,cAAA,KeHE,mBAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YAAA,WAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YImBF,mBAAA,KAAA,WAAA,KJfE,uCIMJ,kCJLM,mBAAA,KAAA,WAAA,MIgBJ,yCHjCF,iBAAA,QGsCA,2CACE,MAAA,KACA,OAAA,MACA,MAAA,YACA,OAAA,QACA,iBAAA,QACA,aAAA,YnB7BA,cAAA,KmBkCF,8BACE,MAAA,KACA,OAAA,KHnDF,iBAAA,QGqDE,OAAA,EnBtCA,cAAA,KeHE,gBAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YAAA,WAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YI6CF,gBAAA,KAAA,WAAA,KJzCE,uCIiCJ,8BJhCM,gBAAA,KAAA,WAAA,MI0CJ,qCH3DF,iBAAA,QGgEA,8BACE,MAAA,KACA,OAAA,MACA,MAAA,YACA,OAAA,QACA,iBAAA,QACA,aAAA,YnBvDA,cAAA,KmB4DF,qBACE,eAAA,KAEA,2CACE,iBAAA,QAGF,uCACE,iBAAA,QCvFN,eACE,SAAA,SAEA,6BtB+iFF,4BsB7iFI,OAAA,mBACA,YAAA,KAGF,qBACE,SAAA,SACA,IAAA,EACA,KAAA,EACA,OAAA,KACA,QAAA,KAAA,OACA,eAAA,KACA,OAAA,IAAA,MAAA,YACA,iBAAA,EAAA,ELDE,WAAA,QAAA,IAAA,WAAA,CAAA,UAAA,IAAA,YAIA,uCKXJ,qBLYM,WAAA,MKCN,6BACE,QAAA,KAAA,OAEA,+CACE,MAAA,YADF,0CACE,MAAA,YAGF,0DAEE,YAAA,SACA,eAAA,QAHF,mCAAA,qDAEE,YAAA,SACA,eAAA,QAGF,8CACE,YAAA,SACA,eAAA,QAIJ,4BACE,YAAA,SACA,eAAA,QAMA,gEACE,QAAA,IACA,UAAA,WAAA,mBAAA,mBAFF,yCtBmjFJ,2DACA,kCsBnjFM,QAAA,IACA,UAAA,WAAA,mBAAA,mBAKF,oDACE,QAAA,IACA,UAAA,WAAA,mBAAA,mBCtDN,aACE,SAAA,SACA,QAAA,KACA,UAAA,KACA,YAAA,QACA,MAAA,KAEA,2BvB2mFF,0BuBzmFI,SAAA,SACA,KAAA,EAAA,EAAA,KACA,MAAA,GACA,UAAA,EAIF,iCvBymFF,gCuBvmFI,QAAA,EAMF,kBACE,SAAA,SACA,QAAA,EAEA,wBACE,QAAA,EAWN,kBACE,QAAA,KACA,YAAA,OACA,QAAA,QAAA,OtBsPI,UAAA,KsBpPJ,YAAA,IACA,YAAA,IACA,MAAA,QACA,WAAA,OACA,YAAA,OACA,iBAAA,QACA,OAAA,IAAA,MAAA,QrBpCE,cAAA,OFuoFJ,qBuBzlFA,8BvBulFA,6BACA,kCuBplFE,QAAA,MAAA,KtBgOI,UAAA,QClRF,cAAA,MFgpFJ,qBuBzlFA,8BvBulFA,6BACA,kCuBplFE,QAAA,OAAA,MtBuNI,UAAA,QClRF,cAAA,MqBgEJ,6BvBulFA,6BuBrlFE,cAAA,KvB0lFF,uEuB7kFI,8FrB/DA,wBAAA,EACA,2BAAA,EFgpFJ,iEuB3kFI,2FrBtEA,wBAAA,EACA,2BAAA,EqBgFF,0IACE,YAAA,KrBpEA,uBAAA,EACA,0BAAA,EsBzBF,gBACE,QAAA,KACA,MAAA,KACA,WAAA,OvByQE,UAAA,OuBtQF,MAAA,QAGF,eACE,SAAA,SACA,IAAA,KACA,QAAA,EACA,QAAA,KACA,UAAA,KACA,QAAA,OAAA,MACA,WAAA,MvB4PE,UAAA,QuBzPF,MAAA,KACA,iBAAA,mBtB1BA,cAAA,OFmsFJ,0BACA,yBwBrqFI,sCxBmqFJ,qCwBjqFM,QAAA,MA9CF,uBAAA,mCAoDE,aAAA,QAGE,cAAA,qBACA,iBAAA,2OACA,kBAAA,UACA,oBAAA,MAAA,wBAAA,OACA,gBAAA,sBAAA,sBAGF,6BAAA,yCACE,aAAA,QACA,WAAA,EAAA,EAAA,EAAA,OAAA,oBAhEJ,2CAAA,+BAyEI,cAAA,qBACA,oBAAA,IAAA,wBAAA,MAAA,wBA1EJ,sBAAA,kCAiFE,aAAA,QAGE,kDAAA,gDAAA,8DAAA,4DAEE,cAAA,SACA,iBAAA,+NAAA,CAAA,2OACA,oBAAA,MAAA,OAAA,MAAA,CAAA,OAAA,MAAA,QACA,gBAAA,KAAA,IAAA,CAAA,sBAAA,sBAIJ,4BAAA,wCACE,aAAA,QACA,WAAA,EAAA,EAAA,EAAA,OAAA,oBA/FJ,2BAAA,uCAsGE,aAAA,QAEA,mCAAA,+CACE,iBAAA,QAGF,iCAAA,6CACE,WAAA,EAAA,EAAA,EAAA,OAAA,oBAGF,6CAAA,yDACE,MAAA,QAKJ,qDACE,YAAA,KAvHF,oCxBwwFJ,mCwBxwFI,gDxBuwFJ,+CwBxoFQ,QAAA,EAIF,0CxB0oFN,yCwB1oFM,sDxByoFN,qDwBxoFQ,QAAA,EAjHN,kBACE,QAAA,KACA,MAAA,KACA,WAAA,OvByQE,UAAA,OuBtQF,MAAA,QAGF,iBACE,SAAA,SACA,IAAA,KACA,QAAA,EACA,QAAA,KACA,UAAA,KACA,QAAA,OAAA,MACA,WAAA,MvB4PE,UAAA,QuBzPF,MAAA,KACA,iBAAA,mBtB1BA,cAAA,OF4xFJ,8BACA,6BwB9vFI,0CxB4vFJ,yCwB1vFM,QAAA,MA9CF,yBAAA,qCAoDE,aAAA,QAGE,cAAA,qBACA,iBAAA,2TACA,kBAAA,UACA,oBAAA,MAAA,wBAAA,OACA,gBAAA,sBAAA,sBAGF,+BAAA,2CACE,aAAA,QACA,WAAA,EAAA,EAAA,EAAA,OAAA,oBAhEJ,6CAAA,iCAyEI,cAAA,qBACA,oBAAA,IAAA,wBAAA,MAAA,wBA1EJ,wBAAA,oCAiFE,aAAA,QAGE,oDAAA,kDAAA,gEAAA,8DAEE,cAAA,SACA,iBAAA,+NAAA,CAAA,2TACA,oBAAA,MAAA,OAAA,MAAA,CAAA,OAAA,MAAA,QACA,gBAAA,KAAA,IAAA,CAAA,sBAAA,sBAIJ,8BAAA,0CACE,aAAA,QACA,WAAA,EAAA,EAAA,EAAA,OAAA,oBA/FJ,6BAAA,yCAsGE,aAAA,QAEA,qCAAA,iDACE,iBAAA,QAGF,mCAAA,+CACE,WAAA,EAAA,EAAA,EAAA,OAAA,oBAGF,+CAAA,2DACE,MAAA,QAKJ,uDACE,YAAA,KAvHF,sCxBi2FJ,qCwBj2FI,kDxBg2FJ,iDwB/tFQ,QAAA,EAEF,4CxBmuFN,2CwBnuFM,wDxBkuFN,uDwBjuFQ,QAAA,ECtIR,KACE,QAAA,aAEA,YAAA,IACA,YAAA,IACA,MAAA,QACA,WAAA,OACA,gBAAA,KAEA,eAAA,OACA,OAAA,QACA,oBAAA,KAAA,iBAAA,KAAA,YAAA,KACA,iBAAA,YACA,OAAA,IAAA,MAAA,YC8GA,QAAA,QAAA,OzBsKI,UAAA,KClRF,cAAA,OeHE,WAAA,MAAA,KAAA,WAAA,CAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YAIA,uCQhBN,KRiBQ,WAAA,MQAN,WACE,MAAA,QAIF,sBAAA,WAEE,QAAA,EACA,WAAA,EAAA,EAAA,EAAA,OAAA,qBAcF,cAAA,cAAA,uBAGE,eAAA,KACA,QAAA,IAYF,aCvCA,MAAA,KRhBA,iBAAA,QQkBA,aAAA,QAGA,mBACE,MAAA,KRtBF,iBAAA,QQwBE,aAAA,QAGF,8BAAA,mBAEE,MAAA,KR7BF,iBAAA,QQ+BE,aAAA,QAKE,WAAA,EAAA,EAAA,EAAA,OAAA,oBAIJ,+BAAA,gCAAA,oBAAA,oBAAA,mCAKE,MAAA,KACA,iBAAA,QAGA,aAAA,QAEA,qCAAA,sCAAA,0BAAA,0BAAA,yCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,oBAKN,sBAAA,sBAEE,MAAA,KACA,iBAAA,QAGA,aAAA,QDZF,eCvCA,MAAA,KRhBA,iBAAA,QQkBA,aAAA,QAGA,qBACE,MAAA,KRtBF,iBAAA,QQwBE,aAAA,QAGF,gCAAA,qBAEE,MAAA,KR7BF,iBAAA,QQ+BE,aAAA,QAKE,WAAA,EAAA,EAAA,EAAA,OAAA,qBAIJ,iCAAA,kCAAA,sBAAA,sBAAA,qCAKE,MAAA,KACA,iBAAA,QAGA,aAAA,QAEA,uCAAA,wCAAA,4BAAA,4BAAA,2CAKI,WAAA,EAAA,EAAA,EAAA,OAAA,qBAKN,wBAAA,wBAEE,MAAA,KACA,iBAAA,QAGA,aAAA,QDZF,aCvCA,MAAA,KRhBA,iBAAA,QQkBA,aAAA,QAGA,mBACE,MAAA,KRtBF,iBAAA,QQwBE,aAAA,QAGF,8BAAA,mBAEE,MAAA,KR7BF,iBAAA,QQ+BE,aAAA,QAKE,WAAA,EAAA,EAAA,EAAA,OAAA,oBAIJ,+BAAA,gCAAA,oBAAA,oBAAA,mCAKE,MAAA,KACA,iBAAA,QAGA,aAAA,QAEA,qCAAA,sCAAA,0BAAA,0BAAA,yCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,oBAKN,sBAAA,sBAEE,MAAA,KACA,iBAAA,QAGA,aAAA,QDZF,UCvCA,MAAA,KRhBA,iBAAA,QQkBA,aAAA,QAGA,gBACE,MAAA,KRtBF,iBAAA,QQwBE,aAAA,QAGF,2BAAA,gBAEE,MAAA,KR7BF,iBAAA,QQ+BE,aAAA,QAKE,WAAA,EAAA,EAAA,EAAA,OAAA,oBAIJ,4BAAA,6BAAA,iBAAA,iBAAA,gCAKE,MAAA,KACA,iBAAA,QAGA,aAAA,QAEA,kCAAA,mCAAA,uBAAA,uBAAA,sCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,oBAKN,mBAAA,mBAEE,MAAA,KACA,iBAAA,QAGA,aAAA,QDZF,aCvCA,MAAA,KRhBA,iBAAA,QQkBA,aAAA,QAGA,mBACE,MAAA,KRtBF,iBAAA,QQwBE,aAAA,QAGF,8BAAA,mBAEE,MAAA,KR7BF,iBAAA,QQ+BE,aAAA,QAKE,WAAA,EAAA,EAAA,EAAA,OAAA,mBAIJ,+BAAA,gCAAA,oBAAA,oBAAA,mCAKE,MAAA,KACA,iBAAA,QAGA,aAAA,QAEA,qCAAA,sCAAA,0BAAA,0BAAA,yCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,mBAKN,sBAAA,sBAEE,MAAA,KACA,iBAAA,QAGA,aAAA,QDZF,YCvCA,MAAA,KRhBA,iBAAA,QQkBA,aAAA,QAGA,kBACE,MAAA,KRtBF,iBAAA,QQwBE,aAAA,QAGF,6BAAA,kBAEE,MAAA,KR7BF,iBAAA,QQ+BE,aAAA,QAKE,WAAA,EAAA,EAAA,EAAA,OAAA,mBAIJ,8BAAA,+BAAA,mBAAA,mBAAA,kCAKE,MAAA,KACA,iBAAA,QAGA,aAAA,QAEA,oCAAA,qCAAA,yBAAA,yBAAA,wCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,mBAKN,qBAAA,qBAEE,MAAA,KACA,iBAAA,QAGA,aAAA,QDZF,WCvCA,MAAA,KRhBA,iBAAA,QQkBA,aAAA,QAGA,iBACE,MAAA,KRtBF,iBAAA,QQwBE,aAAA,QAGF,4BAAA,iBAEE,MAAA,KR7BF,iBAAA,QQ+BE,aAAA,QAKE,WAAA,EAAA,EAAA,EAAA,OAAA,qBAIJ,6BAAA,8BAAA,kBAAA,kBAAA,iCAKE,MAAA,KACA,iBAAA,QAGA,aAAA,QAEA,mCAAA,oCAAA,wBAAA,wBAAA,uCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,qBAKN,oBAAA,oBAEE,MAAA,KACA,iBAAA,QAGA,aAAA,QDZF,UCvCA,MAAA,KRhBA,iBAAA,QQkBA,aAAA,QAGA,gBACE,MAAA,KRtBF,iBAAA,QQwBE,aAAA,QAGF,2BAAA,gBAEE,MAAA,KR7BF,iBAAA,QQ+BE,aAAA,QAKE,WAAA,EAAA,EAAA,EAAA,OAAA,kBAIJ,4BAAA,6BAAA,iBAAA,iBAAA,gCAKE,MAAA,KACA,iBAAA,QAGA,aAAA,QAEA,kCAAA,mCAAA,uBAAA,uBAAA,sCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,kBAKN,mBAAA,mBAEE,MAAA,KACA,iBAAA,QAGA,aAAA,QDNF,qBCmBA,MAAA,QACA,aAAA,QAEA,2BACE,MAAA,KACA,iBAAA,QACA,aAAA,QAGF,sCAAA,2BAEE,WAAA,EAAA,EAAA,EAAA,OAAA,oBAGF,uCAAA,wCAAA,4BAAA,0CAAA,4BAKE,MAAA,KACA,iBAAA,QACA,aAAA,QAEA,6CAAA,8CAAA,kCAAA,gDAAA,kCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,oBAKN,8BAAA,8BAEE,MAAA,QACA,iBAAA,YDvDF,uBCmBA,MAAA,QACA,aAAA,QAEA,6BACE,MAAA,KACA,iBAAA,QACA,aAAA,QAGF,wCAAA,6BAEE,WAAA,EAAA,EAAA,EAAA,OAAA,qBAGF,yCAAA,0CAAA,8BAAA,4CAAA,8BAKE,MAAA,KACA,iBAAA,QACA,aAAA,QAEA,+CAAA,gDAAA,oCAAA,kDAAA,oCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,qBAKN,gCAAA,gCAEE,MAAA,QACA,iBAAA,YDvDF,qBCmBA,MAAA,QACA,aAAA,QAEA,2BACE,MAAA,KACA,iBAAA,QACA,aAAA,QAGF,sCAAA,2BAEE,WAAA,EAAA,EAAA,EAAA,OAAA,mBAGF,uCAAA,wCAAA,4BAAA,0CAAA,4BAKE,MAAA,KACA,iBAAA,QACA,aAAA,QAEA,6CAAA,8CAAA,kCAAA,gDAAA,kCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,mBAKN,8BAAA,8BAEE,MAAA,QACA,iBAAA,YDvDF,kBCmBA,MAAA,QACA,aAAA,QAEA,wBACE,MAAA,KACA,iBAAA,QACA,aAAA,QAGF,mCAAA,wBAEE,WAAA,EAAA,EAAA,EAAA,OAAA,oBAGF,oCAAA,qCAAA,yBAAA,uCAAA,yBAKE,MAAA,KACA,iBAAA,QACA,aAAA,QAEA,0CAAA,2CAAA,+BAAA,6CAAA,+BAKI,WAAA,EAAA,EAAA,EAAA,OAAA,oBAKN,2BAAA,2BAEE,MAAA,QACA,iBAAA,YDvDF,qBCmBA,MAAA,QACA,aAAA,QAEA,2BACE,MAAA,KACA,iBAAA,QACA,aAAA,QAGF,sCAAA,2BAEE,WAAA,EAAA,EAAA,EAAA,OAAA,mBAGF,uCAAA,wCAAA,4BAAA,0CAAA,4BAKE,MAAA,KACA,iBAAA,QACA,aAAA,QAEA,6CAAA,8CAAA,kCAAA,gDAAA,kCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,mBAKN,8BAAA,8BAEE,MAAA,QACA,iBAAA,YDvDF,oBCmBA,MAAA,QACA,aAAA,QAEA,0BACE,MAAA,KACA,iBAAA,QACA,aAAA,QAGF,qCAAA,0BAEE,WAAA,EAAA,EAAA,EAAA,OAAA,mBAGF,sCAAA,uCAAA,2BAAA,yCAAA,2BAKE,MAAA,KACA,iBAAA,QACA,aAAA,QAEA,4CAAA,6CAAA,iCAAA,+CAAA,iCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,mBAKN,6BAAA,6BAEE,MAAA,QACA,iBAAA,YDvDF,mBCmBA,MAAA,QACA,aAAA,QAEA,yBACE,MAAA,KACA,iBAAA,QACA,aAAA,QAGF,oCAAA,yBAEE,WAAA,EAAA,EAAA,EAAA,OAAA,qBAGF,qCAAA,sCAAA,0BAAA,wCAAA,0BAKE,MAAA,KACA,iBAAA,QACA,aAAA,QAEA,2CAAA,4CAAA,gCAAA,8CAAA,gCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,qBAKN,4BAAA,4BAEE,MAAA,QACA,iBAAA,YDvDF,kBCmBA,MAAA,QACA,aAAA,QAEA,wBACE,MAAA,KACA,iBAAA,QACA,aAAA,QAGF,mCAAA,wBAEE,WAAA,EAAA,EAAA,EAAA,OAAA,kBAGF,oCAAA,qCAAA,yBAAA,uCAAA,yBAKE,MAAA,KACA,iBAAA,QACA,aAAA,QAEA,0CAAA,2CAAA,+BAAA,6CAAA,+BAKI,WAAA,EAAA,EAAA,EAAA,OAAA,kBAKN,2BAAA,2BAEE,MAAA,QACA,iBAAA,YD3CJ,UACE,YAAA,IACA,MAAA,QACA,gBAAA,UAEA,gBACE,MAAA,QAQF,mBAAA,mBAEE,MAAA,QAWJ,mBAAA,QCuBE,QAAA,MAAA,KzBsKI,UAAA,QClRF,cAAA,MuByFJ,mBAAA,QCmBE,QAAA,OAAA,MzBsKI,UAAA,QClRF,cAAA,MyBnBJ,MVgBM,WAAA,QAAA,KAAA,OAIA,uCUpBN,MVqBQ,WAAA,MUlBN,iBACE,QAAA,EAMF,qBACE,QAAA,KAIJ,YACE,OAAA,EACA,SAAA,OVDI,WAAA,OAAA,KAAA,KAIA,uCULN,YVMQ,WAAA,MUDN,gCACE,MAAA,EACA,OAAA,KVNE,WAAA,MAAA,KAAA,KAIA,uCUAJ,gCVCM,WAAA,MjBs3GR,UADA,SAEA,W4B34GA,QAIE,SAAA,SAGF,iBACE,YAAA,OCqBE,wBACE,QAAA,aACA,YAAA,OACA,eAAA,OACA,QAAA,GAhCJ,WAAA,KAAA,MACA,aAAA,KAAA,MAAA,YACA,cAAA,EACA,YAAA,KAAA,MAAA,YAqDE,8BACE,YAAA,ED3CN,eACE,SAAA,SACA,QAAA,KACA,QAAA,KACA,UAAA,MACA,QAAA,MAAA,EACA,OAAA,E3B+QI,UAAA,K2B7QJ,MAAA,QACA,WAAA,KACA,WAAA,KACA,iBAAA,KACA,gBAAA,YACA,OAAA,IAAA,MAAA,gB1BVE,cAAA,O0BcF,+BACE,IAAA,KACA,KAAA,EACA,WAAA,QAYA,qBACE,cAAA,MAEA,qCACE,MAAA,KACA,KAAA,EAIJ,mBACE,cAAA,IAEA,mCACE,MAAA,EACA,KAAA,KnBCJ,yBmBfA,wBACE,cAAA,MAEA,wCACE,MAAA,KACA,KAAA,EAIJ,sBACE,cAAA,IAEA,sCACE,MAAA,EACA,KAAA,MnBCJ,yBmBfA,wBACE,cAAA,MAEA,wCACE,MAAA,KACA,KAAA,EAIJ,sBACE,cAAA,IAEA,sCACE,MAAA,EACA,KAAA,MnBCJ,yBmBfA,wBACE,cAAA,MAEA,wCACE,MAAA,KACA,KAAA,EAIJ,sBACE,cAAA,IAEA,sCACE,MAAA,EACA,KAAA,MnBCJ,0BmBfA,wBACE,cAAA,MAEA,wCACE,MAAA,KACA,KAAA,EAIJ,sBACE,cAAA,IAEA,sCACE,MAAA,EACA,KAAA,MnBCJ,0BmBfA,yBACE,cAAA,MAEA,yCACE,MAAA,KACA,KAAA,EAIJ,uBACE,cAAA,IAEA,uCACE,MAAA,EACA,KAAA,MAUN,uCACE,IAAA,KACA,OAAA,KACA,WAAA,EACA,cAAA,QC9CA,gCACE,QAAA,aACA,YAAA,OACA,eAAA,OACA,QAAA,GAzBJ,WAAA,EACA,aAAA,KAAA,MAAA,YACA,cAAA,KAAA,MACA,YAAA,KAAA,MAAA,YA8CE,sCACE,YAAA,ED0BJ,wCACE,IAAA,EACA,MAAA,KACA,KAAA,KACA,WAAA,EACA,YAAA,QC5DA,iCACE,QAAA,aACA,YAAA,OACA,eAAA,OACA,QAAA,GAlBJ,WAAA,KAAA,MAAA,YACA,aAAA,EACA,cAAA,KAAA,MAAA,YACA,YAAA,KAAA,MAuCE,uCACE,YAAA,EDoCF,iCACE,eAAA,EAMJ,0CACE,IAAA,EACA,MAAA,KACA,KAAA,KACA,WAAA,EACA,aAAA,QC7EA,mCACE,QAAA,aACA,YAAA,OACA,eAAA,OACA,QAAA,GAWA,mCACE,QAAA,KAGF,oCACE,QAAA,aACA,aAAA,OACA,eAAA,OACA,QAAA,GA9BN,WAAA,KAAA,MAAA,YACA,aAAA,KAAA,MACA,cAAA,KAAA,MAAA,YAiCE,yCACE,YAAA,EDqDF,oCACE,eAAA,EAON,kBACE,OAAA,EACA,OAAA,MAAA,EACA,SAAA,OACA,WAAA,IAAA,MAAA,gBAMF,eACE,QAAA,MACA,MAAA,KACA,QAAA,OAAA,KACA,MAAA,KACA,YAAA,IACA,MAAA,QACA,WAAA,QACA,gBAAA,KACA,YAAA,OACA,iBAAA,YACA,OAAA,EAcA,qBAAA,qBAEE,MAAA,QVzJF,iBAAA,QU8JA,sBAAA,sBAEE,MAAA,KACA,gBAAA,KVjKF,iBAAA,QUqKA,wBAAA,wBAEE,MAAA,QACA,eAAA,KACA,iBAAA,YAMJ,oBACE,QAAA,MAIF,iBACE,QAAA,MACA,QAAA,MAAA,KACA,cAAA,E3B0GI,UAAA,Q2BxGJ,MAAA,QACA,YAAA,OAIF,oBACE,QAAA,MACA,QAAA,OAAA,KACA,MAAA,QAIF,oBACE,MAAA,QACA,iBAAA,QACA,aAAA,gBAGA,mCACE,MAAA,QAEA,yCAAA,yCAEE,MAAA,KVhNJ,iBAAA,sBUoNE,0CAAA,0CAEE,MAAA,KVtNJ,iBAAA,QU0NE,4CAAA,4CAEE,MAAA,QAIJ,sCACE,aAAA,gBAGF,wCACE,MAAA,QAGF,qCACE,MAAA,QE5OJ,W9B2rHA,oB8BzrHE,SAAA,SACA,QAAA,YACA,eAAA,O9B6rHF,yB8B3rHE,gBACE,SAAA,SACA,KAAA,EAAA,EAAA,K9BmsHJ,4CACA,0CAIA,gCADA,gCADA,+BADA,+B8BhsHE,mC9ByrHF,iCAIA,uBADA,uBADA,sBADA,sB8BprHI,QAAA,EAKJ,aACE,QAAA,KACA,UAAA,KACA,gBAAA,WAEA,0BACE,MAAA,K9BgsHJ,wC8B1rHE,kCAEE,YAAA,K9B4rHJ,4C8BxrHE,uD5BRE,wBAAA,EACA,2BAAA,EFqsHJ,6C8BrrHE,+B9BorHF,iCEvrHI,uBAAA,EACA,0BAAA,E4BqBJ,uBACE,cAAA,SACA,aAAA,SAEA,8BAAA,uCAAA,sCAGE,YAAA,EAGF,0CACE,aAAA,EAIJ,0CAAA,+BACE,cAAA,QACA,aAAA,QAGF,0CAAA,+BACE,cAAA,OACA,aAAA,OAoBF,oBACE,eAAA,OACA,YAAA,WACA,gBAAA,OAEA,yB9BmpHF,+B8BjpHI,MAAA,K9BqpHJ,iD8BlpHE,2CAEE,WAAA,K9BopHJ,qD8BhpHE,gE5BvFE,2BAAA,EACA,0BAAA,EF2uHJ,sD8BhpHE,8B5B1GE,uBAAA,EACA,wBAAA,E6BxBJ,KACE,QAAA,KACA,UAAA,KACA,aAAA,EACA,cAAA,EACA,WAAA,KAGF,UACE,QAAA,MACA,QAAA,MAAA,KAGA,MAAA,QACA,gBAAA,KdHI,WAAA,MAAA,KAAA,WAAA,CAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,YAIA,uCcPN,UdQQ,WAAA,McCN,gBAAA,gBAEE,MAAA,QAKF,mBACE,MAAA,QACA,eAAA,KACA,OAAA,QAQJ,UACE,cAAA,IAAA,MAAA,QAEA,oBACE,cAAA,KACA,WAAA,IACA,OAAA,IAAA,MAAA,Y7BlBA,uBAAA,OACA,wBAAA,O6BoBA,0BAAA,0BAEE,aAAA,QAAA,QAAA,QAEA,UAAA,QAGF,6BACE,MAAA,QACA,iBAAA,YACA,aAAA,Y/BixHN,mC+B7wHE,2BAEE,MAAA,QACA,iBAAA,KACA,aAAA,QAAA,QAAA,KAGF,yBAEE,WAAA,K7B5CA,uBAAA,EACA,wBAAA,E6BuDF,qBACE,WAAA,IACA,OAAA,E7BnEA,cAAA,O6BuEF,4B/BmwHF,2B+BjwHI,MAAA,KbxFF,iBAAA,QlB+1HF,oB+B5vHE,oBAEE,KAAA,EAAA,EAAA,KACA,WAAA,O/B+vHJ,yB+B1vHE,yBAEE,WAAA,EACA,UAAA,EACA,WAAA,OAMF,8B/BuvHF,mC+BtvHI,MAAA,KAUF,uBACE,QAAA,KAEF,qBACE,QAAA,MCxHJ,QACE,SAAA,SACA,QAAA,KACA,UAAA,KACA,YAAA,OACA,gBAAA,cACA,YAAA,MAEA,eAAA,MAOA,mBhCs2HF,yBAGA,sBADA,sBADA,sBAGA,sBACA,uBgC12HI,QAAA,KACA,UAAA,QACA,YAAA,OACA,gBAAA,cAoBJ,cACE,YAAA,SACA,eAAA,SACA,aAAA,K/B2OI,UAAA,Q+BzOJ,gBAAA,KACA,YAAA,OAaF,YACE,QAAA,KACA,eAAA,OACA,aAAA,EACA,cAAA,EACA,WAAA,KAEA,sBACE,cAAA,EACA,aAAA,EAGF,2BACE,SAAA,OASJ,aACE,YAAA,MACA,eAAA,MAYF,iBACE,WAAA,KACA,UAAA,EAGA,YAAA,OAIF,gBACE,QAAA,OAAA,O/B6KI,UAAA,Q+B3KJ,YAAA,EACA,iBAAA,YACA,OAAA,IAAA,MAAA,Y9BzGE,cAAA,OeHE,WAAA,WAAA,KAAA,YAIA,uCemGN,gBflGQ,WAAA,Me2GN,sBACE,gBAAA,KAGF,sBACE,gBAAA,KACA,QAAA,EACA,WAAA,EAAA,EAAA,EAAA,OAMJ,qBACE,QAAA,aACA,MAAA,MACA,OAAA,MACA,eAAA,OACA,kBAAA,UACA,oBAAA,OACA,gBAAA,KAGF,mBACE,WAAA,6BACA,WAAA,KvB1FE,yBuBsGA,kBAEI,UAAA,OACA,gBAAA,WAEA,8BACE,eAAA,IAEA,6CACE,SAAA,SAGF,wCACE,cAAA,MACA,aAAA,MAIJ,qCACE,SAAA,QAGF,mCACE,QAAA,eACA,WAAA,KAGF,kCACE,QAAA,KAGF,oCACE,QAAA,KAGF,6BACE,SAAA,QACA,OAAA,EACA,QAAA,KACA,UAAA,EACA,WAAA,kBACA,iBAAA,YACA,aAAA,EACA,YAAA,EfhMJ,WAAA,KekMI,UAAA,KhC+yHV,oCgC7yHQ,iCAEE,OAAA,KACA,WAAA,EACA,cAAA,EAGF,kCACE,QAAA,KACA,UAAA,EACA,QAAA,EACA,WAAA,SvBhKN,yBuBsGA,kBAEI,UAAA,OACA,gBAAA,WAEA,8BACE,eAAA,IAEA,6CACE,SAAA,SAGF,wCACE,cAAA,MACA,aAAA,MAIJ,qCACE,SAAA,QAGF,mCACE,QAAA,eACA,WAAA,KAGF,kCACE,QAAA,KAGF,oCACE,QAAA,KAGF,6BACE,SAAA,QACA,OAAA,EACA,QAAA,KACA,UAAA,EACA,WAAA,kBACA,iBAAA,YACA,aAAA,EACA,YAAA,EfhMJ,WAAA,KekMI,UAAA,KhCo2HV,oCgCl2HQ,iCAEE,OAAA,KACA,WAAA,EACA,cAAA,EAGF,kCACE,QAAA,KACA,UAAA,EACA,QAAA,EACA,WAAA,SvBhKN,yBuBsGA,kBAEI,UAAA,OACA,gBAAA,WAEA,8BACE,eAAA,IAEA,6CACE,SAAA,SAGF,wCACE,cAAA,MACA,aAAA,MAIJ,qCACE,SAAA,QAGF,mCACE,QAAA,eACA,WAAA,KAGF,kCACE,QAAA,KAGF,oCACE,QAAA,KAGF,6BACE,SAAA,QACA,OAAA,EACA,QAAA,KACA,UAAA,EACA,WAAA,kBACA,iBAAA,YACA,aAAA,EACA,YAAA,EfhMJ,WAAA,KekMI,UAAA,KhCy5HV,oCgCv5HQ,iCAEE,OAAA,KACA,WAAA,EACA,cAAA,EAGF,kCACE,QAAA,KACA,UAAA,EACA,QAAA,EACA,WAAA,SvBhKN,0BuBsGA,kBAEI,UAAA,OACA,gBAAA,WAEA,8BACE,eAAA,IAEA,6CACE,SAAA,SAGF,wCACE,cAAA,MACA,aAAA,MAIJ,qCACE,SAAA,QAGF,mCACE,QAAA,eACA,WAAA,KAGF,kCACE,QAAA,KAGF,oCACE,QAAA,KAGF,6BACE,SAAA,QACA,OAAA,EACA,QAAA,KACA,UAAA,EACA,WAAA,kBACA,iBAAA,YACA,aAAA,EACA,YAAA,EfhMJ,WAAA,KekMI,UAAA,KhC88HV,oCgC58HQ,iCAEE,OAAA,KACA,WAAA,EACA,cAAA,EAGF,kCACE,QAAA,KACA,UAAA,EACA,QAAA,EACA,WAAA,SvBhKN,0BuBsGA,mBAEI,UAAA,OACA,gBAAA,WAEA,+BACE,eAAA,IAEA,8CACE,SAAA,SAGF,yCACE,cAAA,MACA,aAAA,MAIJ,sCACE,SAAA,QAGF,oCACE,QAAA,eACA,WAAA,KAGF,mCACE,QAAA,KAGF,qCACE,QAAA,KAGF,8BACE,SAAA,QACA,OAAA,EACA,QAAA,KACA,UAAA,EACA,WAAA,kBACA,iBAAA,YACA,aAAA,EACA,YAAA,EfhMJ,WAAA,KekMI,UAAA,KhCmgIV,qCgCjgIQ,kCAEE,OAAA,KACA,WAAA,EACA,cAAA,EAGF,mCACE,QAAA,KACA,UAAA,EACA,QAAA,EACA,WAAA,SA1DN,eAEI,UAAA,OACA,gBAAA,WAEA,2BACE,eAAA,IAEA,0CACE,SAAA,SAGF,qCACE,cAAA,MACA,aAAA,MAIJ,kCACE,SAAA,QAGF,gCACE,QAAA,eACA,WAAA,KAGF,+BACE,QAAA,KAGF,iCACE,QAAA,KAGF,0BACE,SAAA,QACA,OAAA,EACA,QAAA,KACA,UAAA,EACA,WAAA,kBACA,iBAAA,YACA,aAAA,EACA,YAAA,EfhMJ,WAAA,KekMI,UAAA,KhCujIV,iCgCrjIQ,8BAEE,OAAA,KACA,WAAA,EACA,cAAA,EAGF,+BACE,QAAA,KACA,UAAA,EACA,QAAA,EACA,WAAA,QAcR,4BACE,MAAA,eAEA,kCAAA,kCAEE,MAAA,eAKF,oCACE,MAAA,gBAEA,0CAAA,0CAEE,MAAA,eAGF,6CACE,MAAA,ehCqiIR,2CgCjiII,0CAEE,MAAA,eAIJ,8BACE,MAAA,gBACA,aAAA,eAGF,mCACE,iBAAA,4OAGF,2BACE,MAAA,gBAEA,6BhC8hIJ,mCADA,mCgC1hIM,MAAA,eAOJ,2BACE,MAAA,KAEA,iCAAA,iCAEE,MAAA,KAKF,mCACE,MAAA,sBAEA,yCAAA,yCAEE,MAAA,sBAGF,4CACE,MAAA,sBhCqhIR,0CgCjhII,yCAEE,MAAA,KAIJ,6BACE,MAAA,sBACA,aAAA,qBAGF,kCACE,iBAAA,kPAGF,0BACE,MAAA,sBACA,4BhC+gIJ,kCADA,kCgC3gIM,MAAA,KCvUN,MACE,SAAA,SACA,QAAA,KACA,eAAA,OACA,UAAA,EAEA,UAAA,WACA,iBAAA,KACA,gBAAA,WACA,OAAA,IAAA,MAAA,iB/BME,cAAA,O+BFF,SACE,aAAA,EACA,YAAA,EAGF,kBACE,WAAA,QACA,cAAA,QAEA,8BACE,iBAAA,E/BCF,uBAAA,mBACA,wBAAA,mB+BEA,6BACE,oBAAA,E/BUF,2BAAA,mBACA,0BAAA,mB+BJF,+BjCk1IF,+BiCh1II,WAAA,EAIJ,WAGE,KAAA,EAAA,EAAA,KACA,QAAA,KAAA,KAIF,YACE,cAAA,MAGF,eACE,WAAA,QACA,cAAA,EAGF,sBACE,cAAA,EAQA,sBACE,YAAA,KAQJ,aACE,QAAA,MAAA,KACA,cAAA,EAEA,iBAAA,gBACA,cAAA,IAAA,MAAA,iBAEA,yB/BpEE,cAAA,mBAAA,mBAAA,EAAA,E+ByEJ,aACE,QAAA,MAAA,KAEA,iBAAA,gBACA,WAAA,IAAA,MAAA,iBAEA,wB/B/EE,cAAA,EAAA,EAAA,mBAAA,mB+ByFJ,kBACE,aAAA,OACA,cAAA,OACA,YAAA,OACA,cAAA,EAUF,mBACE,aAAA,OACA,YAAA,OAIF,kBACE,SAAA,SACA,IAAA,EACA,MAAA,EACA,OAAA,EACA,KAAA,EACA,QAAA,K/BnHE,cAAA,mB+BuHJ,UjCozIA,iBADA,ciChzIE,MAAA,KAGF,UjCmzIA,cEv6II,uBAAA,mBACA,wBAAA,mB+BwHJ,UjCozIA,iBE/5II,2BAAA,mBACA,0BAAA,mB+BuHF,kBACE,cAAA,OxBpGA,yBwBgGJ,YAQI,QAAA,KACA,UAAA,IAAA,KAGA,kBAEE,KAAA,EAAA,EAAA,GACA,cAAA,EAEA,wBACE,YAAA,EACA,YAAA,EAKA,mC/BpJJ,wBAAA,EACA,2BAAA,EF+7IJ,gDiCzyIU,iDAGE,wBAAA,EjC0yIZ,gDiCxyIU,oDAGE,2BAAA,EAIJ,oC/BrJJ,uBAAA,EACA,0BAAA,EF67IJ,iDiCtyIU,kDAGE,uBAAA,EjCuyIZ,iDiCryIU,qDAGE,0BAAA,GC7MZ,kBACE,SAAA,SACA,QAAA,KACA,YAAA,OACA,MAAA,KACA,QAAA,KAAA,QjC4RI,UAAA,KiC1RJ,MAAA,QACA,WAAA,KACA,iBAAA,KACA,OAAA,EhCKE,cAAA,EgCHF,gBAAA,KjBAI,WAAA,MAAA,KAAA,WAAA,CAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,WAAA,CAAA,cAAA,KAAA,KAIA,uCiBhBN,kBjBiBQ,WAAA,MiBFN,kCACE,MAAA,QACA,iBAAA,QACA,WAAA,MAAA,EAAA,KAAA,EAAA,iBAEA,yCACE,iBAAA,gRACA,UAAA,gBAKJ,yBACE,YAAA,EACA,MAAA,QACA,OAAA,QACA,YAAA,KACA,QAAA,GACA,iBAAA,gRACA,kBAAA,UACA,gBAAA,QjBvBE,WAAA,UAAA,IAAA,YAIA,uCiBWJ,yBjBVM,WAAA,MiBsBN,wBACE,QAAA,EAGF,wBACE,QAAA,EACA,aAAA,QACA,QAAA,EACA,WAAA,EAAA,EAAA,EAAA,OAAA,qBAIJ,kBACE,cAAA,EAGF,gBACE,iBAAA,KACA,OAAA,IAAA,MAAA,iBAEA,8BhCnCE,uBAAA,OACA,wBAAA,OgCqCA,gDhCtCA,uBAAA,mBACA,wBAAA,mBgC0CF,oCACE,WAAA,EAIF,6BhClCE,2BAAA,OACA,0BAAA,OgCqCE,yDhCtCF,2BAAA,mBACA,0BAAA,mBgC0CA,iDhC3CA,2BAAA,OACA,0BAAA,OgCgDJ,gBACE,QAAA,KAAA,QASA,qCACE,aAAA,EAGF,iCACE,aAAA,EACA,YAAA,EhCxFA,cAAA,EgC2FA,6CAAgB,WAAA,EAChB,4CAAe,cAAA,EAEf,mDhC9FA,cAAA,EiCnBJ,YACE,QAAA,KACA,UAAA,KACA,QAAA,EAAA,EACA,cAAA,KAEA,WAAA,KAOA,kCACE,aAAA,MAEA,0CACE,MAAA,KACA,cAAA,MACA,MAAA,QACA,QAAA,kCAIJ,wBACE,MAAA,QCzBJ,YACE,QAAA,KhCGA,aAAA,EACA,WAAA,KgCAF,WACE,SAAA,SACA,QAAA,MACA,MAAA,QACA,gBAAA,KACA,iBAAA,KACA,OAAA,IAAA,MAAA,QnBKI,WAAA,MAAA,KAAA,WAAA,CAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YAIA,uCmBfN,WnBgBQ,WAAA,MmBPN,iBACE,QAAA,EACA,MAAA,QAEA,iBAAA,QACA,aAAA,QAGF,iBACE,QAAA,EACA,MAAA,QACA,iBAAA,QACA,QAAA,EACA,WAAA,EAAA,EAAA,EAAA,OAAA,qBAKF,wCACE,YAAA,KAGF,6BACE,QAAA,EACA,MAAA,KlBlCF,iBAAA,QkBoCE,aAAA,QAGF,+BACE,MAAA,QACA,eAAA,KACA,iBAAA,KACA,aAAA,QC3CF,WACE,QAAA,QAAA,OAOI,kCnCqCJ,uBAAA,OACA,0BAAA,OmChCI,iCnCiBJ,wBAAA,OACA,2BAAA,OmChCF,0BACE,QAAA,OAAA,OpCgSE,UAAA,QoCzRE,iDnCqCJ,uBAAA,MACA,0BAAA,MmChCI,gDnCiBJ,wBAAA,MACA,2BAAA,MmChCF,0BACE,QAAA,OAAA,MpCgSE,UAAA,QoCzRE,iDnCqCJ,uBAAA,MACA,0BAAA,MmChCI,gDnCiBJ,wBAAA,MACA,2BAAA,MoC/BJ,OACE,QAAA,aACA,QAAA,MAAA,MrC8RI,UAAA,MqC5RJ,YAAA,IACA,YAAA,EACA,MAAA,KACA,WAAA,OACA,YAAA,OACA,eAAA,SpCKE,cAAA,OoCAF,aACE,QAAA,KAKJ,YACE,SAAA,SACA,IAAA,KCvBF,OACE,SAAA,SACA,QAAA,KAAA,KACA,cAAA,KACA,OAAA,IAAA,MAAA,YrCWE,cAAA,OqCNJ,eAEE,MAAA,QAIF,YACE,YAAA,IAQF,mBACE,cAAA,KAGA,8BACE,SAAA,SACA,IAAA,EACA,MAAA,EACA,QAAA,EACA,QAAA,QAAA,KAeF,eClDA,MAAA,QtBEA,iBAAA,QsBAA,aAAA,QAEA,2BACE,MAAA,QD6CF,iBClDA,MAAA,QtBEA,iBAAA,QsBAA,aAAA,QAEA,6BACE,MAAA,QD6CF,eClDA,MAAA,QtBEA,iBAAA,QsBAA,aAAA,QAEA,2BACE,MAAA,QD6CF,YClDA,MAAA,QtBEA,iBAAA,QsBAA,aAAA,QAEA,wBACE,MAAA,QD6CF,eClDA,MAAA,QtBEA,iBAAA,QsBAA,aAAA,QAEA,2BACE,MAAA,QD6CF,cClDA,MAAA,QtBEA,iBAAA,QsBAA,aAAA,QAEA,0BACE,MAAA,QD6CF,aClDA,MAAA,QtBEA,iBAAA,QsBAA,aAAA,QAEA,yBACE,MAAA,QD6CF,YClDA,MAAA,QtBEA,iBAAA,QsBAA,aAAA,QAEA,wBACE,MAAA,QCHF,wCACE,GAAK,sBAAA,MADP,gCACE,GAAK,sBAAA,MAKT,UACE,QAAA,KACA,OAAA,KACA,SAAA,OxCwRI,UAAA,OwCtRJ,iBAAA,QvCIE,cAAA,OuCCJ,cACE,QAAA,KACA,eAAA,OACA,gBAAA,OACA,SAAA,OACA,MAAA,KACA,WAAA,OACA,YAAA,OACA,iBAAA,QxBZI,WAAA,MAAA,IAAA,KAIA,uCwBAN,cxBCQ,WAAA,MwBWR,sBvBYE,iBAAA,iKuBVA,gBAAA,KAAA,KAIA,uBACE,kBAAA,GAAA,OAAA,SAAA,qBAAA,UAAA,GAAA,OAAA,SAAA,qBAGE,uCAJJ,uBAKM,kBAAA,KAAA,UAAA,MCvCR,YACE,QAAA,KACA,eAAA,OAGA,aAAA,EACA,cAAA,ExCSE,cAAA,OwCLJ,qBACE,gBAAA,KACA,cAAA,QAEA,gCAEE,QAAA,uBAAA,KACA,kBAAA,QAUJ,wBACE,MAAA,KACA,MAAA,QACA,WAAA,QAGA,8BAAA,8BAEE,QAAA,EACA,MAAA,QACA,gBAAA,KACA,iBAAA,QAGF,+BACE,MAAA,QACA,iBAAA,QASJ,iBACE,SAAA,SACA,QAAA,MACA,QAAA,MAAA,KACA,MAAA,QACA,gBAAA,KACA,iBAAA,KACA,OAAA,IAAA,MAAA,iBAEA,6BxCrCE,uBAAA,QACA,wBAAA,QwCwCF,4BxC3BE,2BAAA,QACA,0BAAA,QwC8BF,0BAAA,0BAEE,MAAA,QACA,eAAA,KACA,iBAAA,KAIF,wBACE,QAAA,EACA,MAAA,KACA,iBAAA,QACA,aAAA,QAGF,kCACE,iBAAA,EAEA,yCACE,WAAA,KACA,iBAAA,IAcF,uBACE,eAAA,IAGE,oDxCrCJ,0BAAA,OAZA,wBAAA,EwCsDI,mDxCtDJ,wBAAA,OAYA,0BAAA,EwC+CI,+CACE,WAAA,EAGF,yDACE,iBAAA,IACA,kBAAA,EAEA,gEACE,YAAA,KACA,kBAAA,IjCpER,yBiC4CA,0BACE,eAAA,IAGE,uDxCrCJ,0BAAA,OAZA,wBAAA,EwCsDI,sDxCtDJ,wBAAA,OAYA,0BAAA,EwC+CI,kDACE,WAAA,EAGF,4DACE,iBAAA,IACA,kBAAA,EAEA,mEACE,YAAA,KACA,kBAAA,KjCpER,yBiC4CA,0BACE,eAAA,IAGE,uDxCrCJ,0BAAA,OAZA,wBAAA,EwCsDI,sDxCtDJ,wBAAA,OAYA,0BAAA,EwC+CI,kDACE,WAAA,EAGF,4DACE,iBAAA,IACA,kBAAA,EAEA,mEACE,YAAA,KACA,kBAAA,KjCpER,yBiC4CA,0BACE,eAAA,IAGE,uDxCrCJ,0BAAA,OAZA,wBAAA,EwCsDI,sDxCtDJ,wBAAA,OAYA,0BAAA,EwC+CI,kDACE,WAAA,EAGF,4DACE,iBAAA,IACA,kBAAA,EAEA,mEACE,YAAA,KACA,kBAAA,KjCpER,0BiC4CA,0BACE,eAAA,IAGE,uDxCrCJ,0BAAA,OAZA,wBAAA,EwCsDI,sDxCtDJ,wBAAA,OAYA,0BAAA,EwC+CI,kDACE,WAAA,EAGF,4DACE,iBAAA,IACA,kBAAA,EAEA,mEACE,YAAA,KACA,kBAAA,KjCpER,0BiC4CA,2BACE,eAAA,IAGE,wDxCrCJ,0BAAA,OAZA,wBAAA,EwCsDI,uDxCtDJ,wBAAA,OAYA,0BAAA,EwC+CI,mDACE,WAAA,EAGF,6DACE,iBAAA,IACA,kBAAA,EAEA,oEACE,YAAA,KACA,kBAAA,KAcZ,kBxC9HI,cAAA,EwCiIF,mCACE,aAAA,EAAA,EAAA,IAEA,8CACE,oBAAA,ECpJJ,yBACE,MAAA,QACA,iBAAA,QAGE,sDAAA,sDAEE,MAAA,QACA,iBAAA,QAGF,uDACE,MAAA,KACA,iBAAA,QACA,aAAA,QAdN,2BACE,MAAA,QACA,iBAAA,QAGE,wDAAA,wDAEE,MAAA,QACA,iBAAA,QAGF,yDACE,MAAA,KACA,iBAAA,QACA,aAAA,QAdN,yBACE,MAAA,QACA,iBAAA,QAGE,sDAAA,sDAEE,MAAA,QACA,iBAAA,QAGF,uDACE,MAAA,KACA,iBAAA,QACA,aAAA,QAdN,sBACE,MAAA,QACA,iBAAA,QAGE,mDAAA,mDAEE,MAAA,QACA,iBAAA,QAGF,oDACE,MAAA,KACA,iBAAA,QACA,aAAA,QAdN,yBACE,MAAA,QACA,iBAAA,QAGE,sDAAA,sDAEE,MAAA,QACA,iBAAA,QAGF,uDACE,MAAA,KACA,iBAAA,QACA,aAAA,QAdN,wBACE,MAAA,QACA,iBAAA,QAGE,qDAAA,qDAEE,MAAA,QACA,iBAAA,QAGF,sDACE,MAAA,KACA,iBAAA,QACA,aAAA,QAdN,uBACE,MAAA,QACA,iBAAA,QAGE,oDAAA,oDAEE,MAAA,QACA,iBAAA,QAGF,qDACE,MAAA,KACA,iBAAA,QACA,aAAA,QAdN,sBACE,MAAA,QACA,iBAAA,QAGE,mDAAA,mDAEE,MAAA,QACA,iBAAA,QAGF,oDACE,MAAA,KACA,iBAAA,QACA,aAAA,QCbR,WACE,WAAA,YACA,MAAA,IACA,OAAA,IACA,QAAA,MAAA,MACA,MAAA,KACA,WAAA,YAAA,0TAAA,MAAA,CAAA,IAAA,KAAA,UACA,OAAA,E1COE,cAAA,O0CLF,QAAA,GAGA,iBACE,MAAA,KACA,gBAAA,KACA,QAAA,IAGF,iBACE,QAAA,EACA,WAAA,EAAA,EAAA,EAAA,OAAA,qBACA,QAAA,EAGF,oBAAA,oBAEE,eAAA,KACA,oBAAA,KAAA,iBAAA,KAAA,YAAA,KACA,QAAA,IAIJ,iBACE,OAAA,UAAA,gBAAA,iBCtCF,OACE,MAAA,MACA,UAAA,K5CmSI,UAAA,Q4ChSJ,eAAA,KACA,iBAAA,sBACA,gBAAA,YACA,OAAA,IAAA,MAAA,eACA,WAAA,EAAA,MAAA,KAAA,gB3CUE,cAAA,O2CPF,eACE,QAAA,EAGF,kBACE,QAAA,KAIJ,iBACE,MAAA,oBAAA,MAAA,iBAAA,MAAA,YACA,UAAA,KACA,eAAA,KAEA,mCACE,cAAA,OAIJ,cACE,QAAA,KACA,YAAA,OACA,QAAA,MAAA,OACA,MAAA,QACA,iBAAA,sBACA,gBAAA,YACA,cAAA,IAAA,MAAA,gB3CVE,uBAAA,mBACA,wBAAA,mB2CYF,yBACE,aAAA,SACA,YAAA,OAIJ,YACE,QAAA,OACA,UAAA,WC1CF,OACE,SAAA,MACA,IAAA,EACA,KAAA,EACA,QAAA,KACA,QAAA,KACA,MAAA,KACA,OAAA,KACA,WAAA,OACA,WAAA,KAGA,QAAA,EAOF,cACE,SAAA,SACA,MAAA,KACA,OAAA,MAEA,eAAA,KAGA,0B7BlBI,WAAA,UAAA,IAAA,S6BoBF,UAAA,mB7BhBE,uC6BcJ,0B7BbM,WAAA,M6BiBN,0BACE,UAAA,KAIF,kCACE,UAAA,YAIJ,yBACE,OAAA,kBAEA,wCACE,WAAA,KACA,SAAA,OAGF,qCACE,WAAA,KAIJ,uBACE,QAAA,KACA,YAAA,OACA,WAAA,kBAIF,eACE,SAAA,SACA,QAAA,KACA,eAAA,OACA,MAAA,KAGA,eAAA,KACA,iBAAA,KACA,gBAAA,YACA,OAAA,IAAA,MAAA,e5C3DE,cAAA,M4C+DF,QAAA,EAIF,gBCpFE,SAAA,MACA,IAAA,EACA,KAAA,EACA,QAAA,KACA,MAAA,MACA,OAAA,MACA,iBAAA,KAGA,qBAAS,QAAA,EACT,qBAAS,QAAA,GDgFX,cACE,QAAA,KACA,YAAA,EACA,YAAA,OACA,gBAAA,cACA,QAAA,KAAA,KACA,cAAA,IAAA,MAAA,Q5CtEE,uBAAA,kBACA,wBAAA,kB4CwEF,yBACE,QAAA,MAAA,MACA,OAAA,OAAA,OAAA,OAAA,KAKJ,aACE,cAAA,EACA,YAAA,IAKF,YACE,SAAA,SAGA,KAAA,EAAA,EAAA,KACA,QAAA,KAIF,cACE,QAAA,KACA,UAAA,KACA,YAAA,EACA,YAAA,OACA,gBAAA,SACA,QAAA,OACA,WAAA,IAAA,MAAA,Q5CzFE,2BAAA,kBACA,0BAAA,kB4C8FF,gBACE,OAAA,OrC3EA,yBqCkFF,cACE,UAAA,MACA,OAAA,QAAA,KAGF,yBACE,OAAA,oBAGF,uBACE,WAAA,oBAOF,UAAY,UAAA,OrCnGV,yBqCuGF,U9CywKF,U8CvwKI,UAAA,OrCzGA,0BqC8GF,UAAY,UAAA,QASV,kBACE,MAAA,MACA,UAAA,KACA,OAAA,KACA,OAAA,EAEA,iCACE,OAAA,KACA,OAAA,E5C3KJ,cAAA,E4C+KE,gC5C/KF,cAAA,E4CmLE,8BACE,WAAA,KAGF,gC5CvLF,cAAA,EOyDA,4BqC0GA,0BACE,MAAA,MACA,UAAA,KACA,OAAA,KACA,OAAA,EAEA,yCACE,OAAA,KACA,OAAA,E5C3KJ,cAAA,E4C+KE,wC5C/KF,cAAA,E4CmLE,sCACE,WAAA,KAGF,wC5CvLF,cAAA,GOyDA,4BqC0GA,0BACE,MAAA,MACA,UAAA,KACA,OAAA,KACA,OAAA,EAEA,yCACE,OAAA,KACA,OAAA,E5C3KJ,cAAA,E4C+KE,wC5C/KF,cAAA,E4CmLE,sCACE,WAAA,KAGF,wC5CvLF,cAAA,GOyDA,4BqC0GA,0BACE,MAAA,MACA,UAAA,KACA,OAAA,KACA,OAAA,EAEA,yCACE,OAAA,KACA,OAAA,E5C3KJ,cAAA,E4C+KE,wC5C/KF,cAAA,E4CmLE,sCACE,WAAA,KAGF,wC5CvLF,cAAA,GOyDA,6BqC0GA,0BACE,MAAA,MACA,UAAA,KACA,OAAA,KACA,OAAA,EAEA,yCACE,OAAA,KACA,OAAA,E5C3KJ,cAAA,E4C+KE,wC5C/KF,cAAA,E4CmLE,sCACE,WAAA,KAGF,wC5CvLF,cAAA,GOyDA,6BqC0GA,2BACE,MAAA,MACA,UAAA,KACA,OAAA,KACA,OAAA,EAEA,0CACE,OAAA,KACA,OAAA,E5C3KJ,cAAA,E4C+KE,yC5C/KF,cAAA,E4CmLE,uCACE,WAAA,KAGF,yC5CvLF,cAAA,G8ClBJ,SACE,SAAA,SACA,QAAA,KACA,QAAA,MACA,OAAA,ECJA,YAAA,0BAEA,WAAA,OACA,YAAA,IACA,YAAA,IACA,WAAA,KACA,WAAA,MACA,gBAAA,KACA,YAAA,KACA,eAAA,KACA,eAAA,OACA,WAAA,OACA,aAAA,OACA,YAAA,OACA,WAAA,KhDsRI,UAAA,Q+C1RJ,UAAA,WACA,QAAA,EAEA,cAAS,QAAA,GAET,wBACE,SAAA,SACA,QAAA,MACA,MAAA,MACA,OAAA,MAEA,gCACE,SAAA,SACA,QAAA,GACA,aAAA,YACA,aAAA,MAKN,6CAAA,gBACE,QAAA,MAAA,EAEA,4DAAA,+BACE,OAAA,EAEA,oEAAA,uCACE,IAAA,KACA,aAAA,MAAA,MAAA,EACA,iBAAA,KAKN,+CAAA,gBACE,QAAA,EAAA,MAEA,8DAAA,+BACE,KAAA,EACA,MAAA,MACA,OAAA,MAEA,sEAAA,uCACE,MAAA,KACA,aAAA,MAAA,MAAA,MAAA,EACA,mBAAA,KAKN,gDAAA,mBACE,QAAA,MAAA,EAEA,+DAAA,kCACE,IAAA,EAEA,uEAAA,0CACE,OAAA,KACA,aAAA,EAAA,MAAA,MACA,oBAAA,KAKN,8CAAA,kBACE,QAAA,EAAA,MAEA,6DAAA,iCACE,MAAA,EACA,MAAA,MACA,OAAA,MAEA,qEAAA,yCACE,KAAA,KACA,aAAA,MAAA,EAAA,MAAA,MACA,kBAAA,KAqBN,eACE,UAAA,MACA,QAAA,OAAA,MACA,MAAA,KACA,WAAA,OACA,iBAAA,K9C7FE,cAAA,OgDnBJ,SACE,SAAA,SACA,IAAA,EACA,KAAA,EACA,QAAA,KACA,QAAA,MACA,UAAA,MDLA,YAAA,0BAEA,WAAA,OACA,YAAA,IACA,YAAA,IACA,WAAA,KACA,WAAA,MACA,gBAAA,KACA,YAAA,KACA,eAAA,KACA,eAAA,OACA,WAAA,OACA,aAAA,OACA,YAAA,OACA,WAAA,KhDsRI,UAAA,QiDzRJ,UAAA,WACA,iBAAA,KACA,gBAAA,YACA,OAAA,IAAA,MAAA,ehDIE,cAAA,MgDAF,wBACE,SAAA,SACA,QAAA,MACA,MAAA,KACA,OAAA,MAEA,+BAAA,gCAEE,SAAA,SACA,QAAA,MACA,QAAA,GACA,aAAA,YACA,aAAA,MAMJ,4DAAA,+BACE,OAAA,mBAEA,oEAAA,uCACE,OAAA,EACA,aAAA,MAAA,MAAA,EACA,iBAAA,gBAGF,mEAAA,sCACE,OAAA,IACA,aAAA,MAAA,MAAA,EACA,iBAAA,KAMJ,8DAAA,+BACE,KAAA,mBACA,MAAA,MACA,OAAA,KAEA,sEAAA,uCACE,KAAA,EACA,aAAA,MAAA,MAAA,MAAA,EACA,mBAAA,gBAGF,qEAAA,sCACE,KAAA,IACA,aAAA,MAAA,MAAA,MAAA,EACA,mBAAA,KAMJ,+DAAA,kCACE,IAAA,mBAEA,uEAAA,0CACE,IAAA,EACA,aAAA,EAAA,MAAA,MAAA,MACA,oBAAA,gBAGF,sEAAA,yCACE,IAAA,IACA,aAAA,EAAA,MAAA,MAAA,MACA,oBAAA,KAKJ,wEAAA,2CACE,SAAA,SACA,IAAA,EACA,KAAA,IACA,QAAA,MACA,MAAA,KACA,YAAA,OACA,QAAA,GACA,cAAA,IAAA,MAAA,QAKF,6DAAA,iCACE,MAAA,mBACA,MAAA,MACA,OAAA,KAEA,qEAAA,yCACE,MAAA,EACA,aAAA,MAAA,EAAA,MAAA,MACA,kBAAA,gBAGF,oEAAA,wCACE,MAAA,IACA,aAAA,MAAA,EAAA,MAAA,MACA,kBAAA,KAqBN,gBACE,QAAA,MAAA,KACA,cAAA,EjDuJI,UAAA,KiDpJJ,iBAAA,QACA,cAAA,IAAA,MAAA,ehDtHE,uBAAA,kBACA,wBAAA,kBgDwHF,sBACE,QAAA,KAIJ,cACE,QAAA,KAAA,KACA,MAAA,QC/IF,UACE,SAAA,SAGF,wBACE,aAAA,MAGF,gBACE,SAAA,SACA,MAAA,KACA,SAAA,OCtBA,uBACE,QAAA,MACA,MAAA,KACA,QAAA,GDuBJ,eACE,SAAA,SACA,QAAA,KACA,MAAA,KACA,MAAA,KACA,aAAA,MACA,4BAAA,OAAA,oBAAA,OlClBI,WAAA,UAAA,IAAA,YAIA,uCkCQN,elCPQ,WAAA,MjBgzLR,oBACA,oBmDhyLA,sBAGE,QAAA,MnDmyLF,0BmD/xLA,8CAEE,UAAA,iBnDkyLF,4BmD/xLA,4CAEE,UAAA,kBAWA,8BACE,QAAA,EACA,oBAAA,QACA,UAAA,KnD0xLJ,uDACA,qDmDxxLE,qCAGE,QAAA,EACA,QAAA,EnDyxLJ,yCmDtxLE,2CAEE,QAAA,EACA,QAAA,ElC/DE,WAAA,QAAA,GAAA,IAIA,uCjBq1LN,yCmD7xLE,2ClCvDM,WAAA,MjB01LR,uBmDtxLA,uBAEE,SAAA,SACA,IAAA,EACA,OAAA,EACA,QAAA,EAEA,QAAA,KACA,YAAA,OACA,gBAAA,OACA,MAAA,IACA,QAAA,EACA,MAAA,KACA,WAAA,OACA,WAAA,IACA,OAAA,EACA,QAAA,GlCzFI,WAAA,QAAA,KAAA,KAIA,uCjB82LN,uBmDzyLA,uBlCpEQ,WAAA,MjBm3LR,6BADA,6BmD1xLE,6BAAA,6BAEE,MAAA,KACA,gBAAA,KACA,QAAA,EACA,QAAA,GAGJ,uBACE,KAAA,EAGF,uBACE,MAAA,EnD8xLF,4BmDzxLA,4BAEE,QAAA,aACA,MAAA,KACA,OAAA,KACA,kBAAA,UACA,oBAAA,IACA,gBAAA,KAAA,KAWF,4BACE,iBAAA,wPAEF,4BACE,iBAAA,yPAQF,qBACE,SAAA,SACA,MAAA,EACA,OAAA,EACA,KAAA,EACA,QAAA,EACA,QAAA,KACA,gBAAA,OACA,QAAA,EAEA,aAAA,IACA,cAAA,KACA,YAAA,IACA,WAAA,KAEA,sCACE,WAAA,YACA,KAAA,EAAA,EAAA,KACA,MAAA,KACA,OAAA,IACA,QAAA,EACA,aAAA,IACA,YAAA,IACA,YAAA,OACA,OAAA,QACA,iBAAA,KACA,gBAAA,YACA,OAAA,EAEA,WAAA,KAAA,MAAA,YACA,cAAA,KAAA,MAAA,YACA,QAAA,GlC5KE,WAAA,QAAA,IAAA,KAIA,uCkCwJJ,sClCvJM,WAAA,MkC2KN,6BACE,QAAA,EASJ,kBACE,SAAA,SACA,MAAA,IACA,OAAA,QACA,KAAA,IACA,YAAA,QACA,eAAA,QACA,MAAA,KACA,WAAA,OnDoxLF,2CmD9wLE,2CAEE,OAAA,UAAA,eAGF,qDACE,iBAAA,KAGF,iCACE,MAAA,KE7NJ,kCACE,GAAK,UAAA,gBADP,0BACE,GAAK,UAAA,gBAIP,gBACE,QAAA,aACA,MAAA,KACA,OAAA,KACA,eAAA,QACA,OAAA,MAAA,MAAA,aACA,mBAAA,YAEA,cAAA,IACA,kBAAA,KAAA,OAAA,SAAA,eAAA,UAAA,KAAA,OAAA,SAAA,eAGF,mBACE,MAAA,KACA,OAAA,KACA,aAAA,KAQF,gCACE,GACE,UAAA,SAEF,IACE,QAAA,EACA,UAAA,MANJ,wBACE,GACE,UAAA,SAEF,IACE,QAAA,EACA,UAAA,MAKJ,cACE,QAAA,aACA,MAAA,KACA,OAAA,KACA,eAAA,QACA,iBAAA,aAEA,cAAA,IACA,QAAA,EACA,kBAAA,KAAA,OAAA,SAAA,aAAA,UAAA,KAAA,OAAA,SAAA,aAGF,iBACE,MAAA,KACA,OAAA,KAIA,uCACE,gBrDo/LJ,cqDl/LM,2BAAA,KAAA,mBAAA,MCjEN,WACE,SAAA,MACA,OAAA,EACA,QAAA,KACA,QAAA,KACA,eAAA,OACA,UAAA,KAEA,WAAA,OACA,iBAAA,KACA,gBAAA,YACA,QAAA,ErCKI,WAAA,UAAA,IAAA,YAIA,uCqCpBN,WrCqBQ,WAAA,MqCLR,oBPdE,SAAA,MACA,IAAA,EACA,KAAA,EACA,QAAA,KACA,MAAA,MACA,OAAA,MACA,iBAAA,KAGA,yBAAS,QAAA,EACT,yBAAS,QAAA,GOQX,kBACE,QAAA,KACA,YAAA,OACA,gBAAA,cACA,QAAA,KAAA,KAEA,6BACE,QAAA,MAAA,MACA,WAAA,OACA,aAAA,OACA,cAAA,OAIJ,iBACE,cAAA,EACA,YAAA,IAGF,gBACE,UAAA,EACA,QAAA,KAAA,KACA,WAAA,KAGF,iBACE,IAAA,EACA,KAAA,EACA,MAAA,MACA,aAAA,IAAA,MAAA,eACA,UAAA,kBAGF,eACE,IAAA,EACA,MAAA,EACA,MAAA,MACA,YAAA,IAAA,MAAA,eACA,UAAA,iBAGF,eACE,IAAA,EACA,MAAA,EACA,KAAA,EACA,OAAA,KACA,WAAA,KACA,cAAA,IAAA,MAAA,eACA,UAAA,kBAGF,kBACE,MAAA,EACA,KAAA,EACA,OAAA,KACA,WAAA,KACA,WAAA,IAAA,MAAA,eACA,UAAA,iBAGF,gBACE,UAAA,KCjFF,aACE,QAAA,aACA,WAAA,IACA,eAAA,OACA,OAAA,KACA,iBAAA,aACA,QAAA,GAEA,yBACE,QAAA,aACA,QAAA,GAKJ,gBACE,WAAA,KAGF,gBACE,WAAA,KAGF,gBACE,WAAA,MAKA,+BACE,kBAAA,iBAAA,GAAA,YAAA,SAAA,UAAA,iBAAA,GAAA,YAAA,SAIJ,oCACE,IACE,QAAA,IAFJ,4BACE,IACE,QAAA,IAIJ,kBACE,mBAAA,8DAAA,WAAA,8DACA,kBAAA,KAAA,KAAA,UAAA,KAAA,KACA,kBAAA,iBAAA,GAAA,OAAA,SAAA,UAAA,iBAAA,GAAA,OAAA,SAGF,oCACE,KACE,sBAAA,MAAA,GAAA,cAAA,MAAA,IAFJ,4BACE,KACE,sBAAA,MAAA,GAAA,cAAA,MAAA,IH9CF,iBACE,QAAA,MACA,MAAA,KACA,QAAA,GIJF,cACE,MAAA,QAGE,oBAAA,oBAEE,MAAA,QANN,gBACE,MAAA,QAGE,sBAAA,sBAEE,MAAA,QANN,cACE,MAAA,QAGE,oBAAA,oBAEE,MAAA,QANN,WACE,MAAA,QAGE,iBAAA,iBAEE,MAAA,QANN,cACE,MAAA,QAGE,oBAAA,oBAEE,MAAA,QANN,aACE,MAAA,QAGE,mBAAA,mBAEE,MAAA,QANN,YACE,MAAA,QAGE,kBAAA,kBAEE,MAAA,QANN,WACE,MAAA,QAGE,iBAAA,iBAEE,MAAA,QCLR,OACE,SAAA,SACA,MAAA,KAEA,eACE,QAAA,MACA,YAAA,uBACA,QAAA,GAGF,SACE,SAAA,SACA,IAAA,EACA,KAAA,EACA,MAAA,KACA,OAAA,KAKF,WACE,kBAAA,KADF,WACE,kBAAA,mBADF,YACE,kBAAA,oBADF,YACE,kBAAA,oBCrBJ,WACE,SAAA,MACA,IAAA,EACA,MAAA,EACA,KAAA,EACA,QAAA,KAGF,cACE,SAAA,MACA,MAAA,EACA,OAAA,EACA,KAAA,EACA,QAAA,KAQE,YACE,SAAA,eAAA,SAAA,OACA,IAAA,EACA,QAAA,KjDqCF,yBiDxCA,eACE,SAAA,eAAA,SAAA,OACA,IAAA,EACA,QAAA,MjDqCF,yBiDxCA,eACE,SAAA,eAAA,SAAA,OACA,IAAA,EACA,QAAA,MjDqCF,yBiDxCA,eACE,SAAA,eAAA,SAAA,OACA,IAAA,EACA,QAAA,MjDqCF,0BiDxCA,eACE,SAAA,eAAA,SAAA,OACA,IAAA,EACA,QAAA,MjDqCF,0BiDxCA,gBACE,SAAA,eAAA,SAAA,OACA,IAAA,EACA,QAAA,MCzBN,QACE,QAAA,KACA,eAAA,IACA,YAAA,OACA,WAAA,QAGF,QACE,QAAA,KACA,KAAA,EAAA,EAAA,KACA,eAAA,OACA,WAAA,QCRF,iB5Dk4MA,0D6D93ME,SAAA,mBACA,MAAA,cACA,OAAA,cACA,QAAA,YACA,OAAA,eACA,SAAA,iBACA,KAAA,wBACA,YAAA,iBACA,OAAA,YCXA,uBACE,SAAA,SACA,IAAA,EACA,MAAA,EACA,OAAA,EACA,KAAA,EACA,QAAA,EACA,QAAA,GCRJ,eCAE,SAAA,OACA,cAAA,SACA,YAAA,OCNF,IACE,QAAA,aACA,WAAA,QACA,MAAA,IACA,WAAA,IACA,iBAAA,aACA,QAAA,ICyDM,gBAOI,eAAA,mBAPJ,WAOI,eAAA,cAPJ,cAOI,eAAA,iBAPJ,cAOI,eAAA,iBAPJ,mBAOI,eAAA,sBAPJ,gBAOI,eAAA,mBAPJ,aAOI,MAAA,eAPJ,WAOI,MAAA,gBAPJ,YAOI,MAAA,eAPJ,WAOI,QAAA,YAPJ,YAOI,QAAA,cAPJ,YAOI,QAAA,aAPJ,YAOI,QAAA,cAPJ,aAOI,QAAA,YAPJ,eAOI,SAAA,eAPJ,iBAOI,SAAA,iBAPJ,kBAOI,SAAA,kBAPJ,iBAOI,SAAA,iBAPJ,UAOI,QAAA,iBAPJ,gBAOI,QAAA,uBAPJ,SAOI,QAAA,gBAPJ,QAOI,QAAA,eAPJ,SAOI,QAAA,gBAPJ,aAOI,QAAA,oBAPJ,cAOI,QAAA,qBAPJ,QAOI,QAAA,eAPJ,eAOI,QAAA,sBAPJ,QAOI,QAAA,eAPJ,QAOI,WAAA,EAAA,MAAA,KAAA,0BAPJ,WAOI,WAAA,EAAA,QAAA,OAAA,2BAPJ,WAOI,WAAA,EAAA,KAAA,KAAA,2BAPJ,aAOI,WAAA,eAPJ,iBAOI,SAAA,iBAPJ,mBAOI,SAAA,mBAPJ,mBAOI,SAAA,mBAPJ,gBAOI,SAAA,gBAPJ,iBAOI,SAAA,yBAAA,SAAA,iBAPJ,OAOI,IAAA,YAPJ,QAOI,IAAA,cAPJ,SAOI,IAAA,eAPJ,UAOI,OAAA,YAPJ,WAOI,OAAA,cAPJ,YAOI,OAAA,eAPJ,SAOI,KAAA,YAPJ,UAOI,KAAA,cAPJ,WAOI,KAAA,eAPJ,OAOI,MAAA,YAPJ,QAOI,MAAA,cAPJ,SAOI,MAAA,eAPJ,kBAOI,UAAA,+BAPJ,oBAOI,UAAA,2BAPJ,oBAOI,UAAA,2BAPJ,QAOI,OAAA,IAAA,MAAA,kBAPJ,UAOI,OAAA,YAPJ,YAOI,WAAA,IAAA,MAAA,kBAPJ,cAOI,WAAA,YAPJ,YAOI,aAAA,IAAA,MAAA,kBAPJ,cAOI,aAAA,YAPJ,eAOI,cAAA,IAAA,MAAA,kBAPJ,iBAOI,cAAA,YAPJ,cAOI,YAAA,IAAA,MAAA,kBAPJ,gBAOI,YAAA,YAPJ,gBAOI,aAAA,kBAPJ,kBAOI,aAAA,kBAPJ,gBAOI,aAAA,kBAPJ,aAOI,aAAA,kBAPJ,gBAOI,aAAA,kBAPJ,eAOI,aAAA,kBAPJ,cAOI,aAAA,kBAPJ,aAOI,aAAA,kBAPJ,cAOI,aAAA,eAPJ,UAOI,aAAA,cAPJ,UAOI,aAAA,cAPJ,UAOI,aAAA,cAPJ,UAOI,aAAA,cAPJ,UAOI,aAAA,cAPJ,MAOI,MAAA,cAPJ,MAOI,MAAA,cAPJ,MAOI,MAAA,cAPJ,OAOI,MAAA,eAPJ,QAOI,MAAA,eAPJ,QAOI,UAAA,eAPJ,QAOI,MAAA,gBAPJ,YAOI,UAAA,gBAPJ,MAOI,OAAA,cAPJ,MAOI,OAAA,cAPJ,MAOI,OAAA,cAPJ,OAOI,OAAA,eAPJ,QAOI,OAAA,eAPJ,QAOI,WAAA,eAPJ,QAOI,OAAA,gBAPJ,YAOI,WAAA,gBAPJ,WAOI,KAAA,EAAA,EAAA,eAPJ,UAOI,eAAA,cAPJ,aAOI,eAAA,iBAPJ,kBAOI,eAAA,sBAPJ,qBAOI,eAAA,yBAPJ,aAOI,UAAA,YAPJ,aAOI,UAAA,YAPJ,eAOI,YAAA,YAPJ,eAOI,YAAA,YAPJ,WAOI,UAAA,eAPJ,aAOI,UAAA,iBAPJ,mBAOI,UAAA,uBAPJ,OAOI,IAAA,YAPJ,OAOI,IAAA,iBAPJ,OAOI,IAAA,gBAPJ,OAOI,IAAA,eAPJ,OAOI,IAAA,iBAPJ,OAOI,IAAA,eAPJ,uBAOI,gBAAA,qBAPJ,qBAOI,gBAAA,mBAPJ,wBAOI,gBAAA,iBAPJ,yBAOI,gBAAA,wBAPJ,wBAOI,gBAAA,uBAPJ,wBAOI,gBAAA,uBAPJ,mBAOI,YAAA,qBAPJ,iBAOI,YAAA,mBAPJ,oBAOI,YAAA,iBAPJ,sBAOI,YAAA,mBAPJ,qBAOI,YAAA,kBAPJ,qBAOI,cAAA,qBAPJ,mBAOI,cAAA,mBAPJ,sBAOI,cAAA,iBAPJ,uBAOI,cAAA,wBAPJ,sBAOI,cAAA,uBAPJ,uBAOI,cAAA,kBAPJ,iBAOI,WAAA,eAPJ,kBAOI,WAAA,qBAPJ,gBAOI,WAAA,mBAPJ,mBAOI,WAAA,iBAPJ,qBAOI,WAAA,mBAPJ,oBAOI,WAAA,kBAPJ,aAOI,MAAA,aAPJ,SAOI,MAAA,YAPJ,SAOI,MAAA,YAPJ,SAOI,MAAA,YAPJ,SAOI,MAAA,YAPJ,SAOI,MAAA,YAPJ,SAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,KAOI,OAAA,YAPJ,KAOI,OAAA,iBAPJ,KAOI,OAAA,gBAPJ,KAOI,OAAA,eAPJ,KAOI,OAAA,iBAPJ,KAOI,OAAA,eAPJ,QAOI,OAAA,eAPJ,MAOI,aAAA,YAAA,YAAA,YAPJ,MAOI,aAAA,iBAAA,YAAA,iBAPJ,MAOI,aAAA,gBAAA,YAAA,gBAPJ,MAOI,aAAA,eAAA,YAAA,eAPJ,MAOI,aAAA,iBAAA,YAAA,iBAPJ,MAOI,aAAA,eAAA,YAAA,eAPJ,SAOI,aAAA,eAAA,YAAA,eAPJ,MAOI,WAAA,YAAA,cAAA,YAPJ,MAOI,WAAA,iBAAA,cAAA,iBAPJ,MAOI,WAAA,gBAAA,cAAA,gBAPJ,MAOI,WAAA,eAAA,cAAA,eAPJ,MAOI,WAAA,iBAAA,cAAA,iBAPJ,MAOI,WAAA,eAAA,cAAA,eAPJ,SAOI,WAAA,eAAA,cAAA,eAPJ,MAOI,WAAA,YAPJ,MAOI,WAAA,iBAPJ,MAOI,WAAA,gBAPJ,MAOI,WAAA,eAPJ,MAOI,WAAA,iBAPJ,MAOI,WAAA,eAPJ,SAOI,WAAA,eAPJ,MAOI,aAAA,YAPJ,MAOI,aAAA,iBAPJ,MAOI,aAAA,gBAPJ,MAOI,aAAA,eAPJ,MAOI,aAAA,iBAPJ,MAOI,aAAA,eAPJ,SAOI,aAAA,eAPJ,MAOI,cAAA,YAPJ,MAOI,cAAA,iBAPJ,MAOI,cAAA,gBAPJ,MAOI,cAAA,eAPJ,MAOI,cAAA,iBAPJ,MAOI,cAAA,eAPJ,SAOI,cAAA,eAPJ,MAOI,YAAA,YAPJ,MAOI,YAAA,iBAPJ,MAOI,YAAA,gBAPJ,MAOI,YAAA,eAPJ,MAOI,YAAA,iBAPJ,MAOI,YAAA,eAPJ,SAOI,YAAA,eAPJ,KAOI,QAAA,YAPJ,KAOI,QAAA,iBAPJ,KAOI,QAAA,gBAPJ,KAOI,QAAA,eAPJ,KAOI,QAAA,iBAPJ,KAOI,QAAA,eAPJ,MAOI,cAAA,YAAA,aAAA,YAPJ,MAOI,cAAA,iBAAA,aAAA,iBAPJ,MAOI,cAAA,gBAAA,aAAA,gBAPJ,MAOI,cAAA,eAAA,aAAA,eAPJ,MAOI,cAAA,iBAAA,aAAA,iBAPJ,MAOI,cAAA,eAAA,aAAA,eAPJ,MAOI,YAAA,YAAA,eAAA,YAPJ,MAOI,YAAA,iBAAA,eAAA,iBAPJ,MAOI,YAAA,gBAAA,eAAA,gBAPJ,MAOI,YAAA,eAAA,eAAA,eAPJ,MAOI,YAAA,iBAAA,eAAA,iBAPJ,MAOI,YAAA,eAAA,eAAA,eAPJ,MAOI,YAAA,YAPJ,MAOI,YAAA,iBAPJ,MAOI,YAAA,gBAPJ,MAOI,YAAA,eAPJ,MAOI,YAAA,iBAPJ,MAOI,YAAA,eAPJ,MAOI,cAAA,YAPJ,MAOI,cAAA,iBAPJ,MAOI,cAAA,gBAPJ,MAOI,cAAA,eAPJ,MAOI,cAAA,iBAPJ,MAOI,cAAA,eAPJ,MAOI,eAAA,YAPJ,MAOI,eAAA,iBAPJ,MAOI,eAAA,gBAPJ,MAOI,eAAA,eAPJ,MAOI,eAAA,iBAPJ,MAOI,eAAA,eAPJ,MAOI,aAAA,YAPJ,MAOI,aAAA,iBAPJ,MAOI,aAAA,gBAPJ,MAOI,aAAA,eAPJ,MAOI,aAAA,iBAPJ,MAOI,aAAA,eAPJ,gBAOI,YAAA,mCAPJ,MAOI,UAAA,iCAPJ,MAOI,UAAA,gCAPJ,MAOI,UAAA,8BAPJ,MAOI,UAAA,gCAPJ,MAOI,UAAA,kBAPJ,MAOI,UAAA,eAPJ,YAOI,WAAA,iBAPJ,YAOI,WAAA,iBAPJ,UAOI,YAAA,cAPJ,YAOI,YAAA,kBAPJ,WAOI,YAAA,cAPJ,SAOI,YAAA,cAPJ,WAOI,YAAA,iBAPJ,MAOI,YAAA,YAPJ,OAOI,YAAA,eAPJ,SAOI,YAAA,cAPJ,OAOI,YAAA,YAPJ,YAOI,WAAA,eAPJ,UAOI,WAAA,gBAPJ,aAOI,WAAA,iBAPJ,sBAOI,gBAAA,eAPJ,2BAOI,gBAAA,oBAPJ,8BAOI,gBAAA,uBAPJ,gBAOI,eAAA,oBAPJ,gBAOI,eAAA,oBAPJ,iBAOI,eAAA,qBAPJ,WAOI,YAAA,iBAPJ,aAOI,YAAA,iBAPJ,YAOI,UAAA,qBAAA,WAAA,qBAPJ,cAIQ,kBAAA,EAGJ,MAAA,6DAPJ,gBAIQ,kBAAA,EAGJ,MAAA,+DAPJ,cAIQ,kBAAA,EAGJ,MAAA,6DAPJ,WAIQ,kBAAA,EAGJ,MAAA,0DAPJ,cAIQ,kBAAA,EAGJ,MAAA,6DAPJ,aAIQ,kBAAA,EAGJ,MAAA,4DAPJ,YAIQ,kBAAA,EAGJ,MAAA,2DAPJ,WAIQ,kBAAA,EAGJ,MAAA,0DAPJ,YAIQ,kBAAA,EAGJ,MAAA,2DAPJ,YAIQ,kBAAA,EAGJ,MAAA,2DAPJ,WAIQ,kBAAA,EAGJ,MAAA,0DAPJ,YAIQ,kBAAA,EAGJ,MAAA,kBAPJ,eAIQ,kBAAA,EAGJ,MAAA,yBAPJ,eAIQ,kBAAA,EAGJ,MAAA,+BAPJ,YAIQ,kBAAA,EAGJ,MAAA,kBAjBJ,iBACE,kBAAA,KADF,iBACE,kBAAA,IADF,iBACE,kBAAA,KADF,kBACE,kBAAA,EASF,YAIQ,gBAAA,EAGJ,iBAAA,2DAPJ,cAIQ,gBAAA,EAGJ,iBAAA,6DAPJ,YAIQ,gBAAA,EAGJ,iBAAA,2DAPJ,SAIQ,gBAAA,EAGJ,iBAAA,wDAPJ,YAIQ,gBAAA,EAGJ,iBAAA,2DAPJ,WAIQ,gBAAA,EAGJ,iBAAA,0DAPJ,UAIQ,gBAAA,EAGJ,iBAAA,yDAPJ,SAIQ,gBAAA,EAGJ,iBAAA,wDAPJ,UAIQ,gBAAA,EAGJ,iBAAA,yDAPJ,UAIQ,gBAAA,EAGJ,iBAAA,yDAPJ,SAIQ,gBAAA,EAGJ,iBAAA,wDAPJ,gBAIQ,gBAAA,EAGJ,iBAAA,sBAjBJ,eACE,gBAAA,IADF,eACE,gBAAA,KADF,eACE,gBAAA,IADF,eACE,gBAAA,KADF,gBACE,gBAAA,EASF,aAOI,iBAAA,6BAPJ,iBAOI,oBAAA,cAAA,iBAAA,cAAA,YAAA,cAPJ,kBAOI,oBAAA,eAAA,iBAAA,eAAA,YAAA,eAPJ,kBAOI,oBAAA,eAAA,iBAAA,eAAA,YAAA,eAPJ,SAOI,eAAA,eAPJ,SAOI,eAAA,eAPJ,SAOI,cAAA,iBAPJ,WAOI,cAAA,YAPJ,WAOI,cAAA,gBAPJ,WAOI,cAAA,iBAPJ,WAOI,cAAA,gBAPJ,gBAOI,cAAA,cAPJ,cAOI,cAAA,gBAPJ,aAOI,uBAAA,iBAAA,wBAAA,iBAPJ,aAOI,wBAAA,iBAAA,2BAAA,iBAPJ,gBAOI,2BAAA,iBAAA,0BAAA,iBAPJ,eAOI,0BAAA,iBAAA,uBAAA,iBAPJ,SAOI,WAAA,kBAPJ,WAOI,WAAA,iBzDPR,yByDAI,gBAOI,MAAA,eAPJ,cAOI,MAAA,gBAPJ,eAOI,MAAA,eAPJ,aAOI,QAAA,iBAPJ,mBAOI,QAAA,uBAPJ,YAOI,QAAA,gBAPJ,WAOI,QAAA,eAPJ,YAOI,QAAA,gBAPJ,gBAOI,QAAA,oBAPJ,iBAOI,QAAA,qBAPJ,WAOI,QAAA,eAPJ,kBAOI,QAAA,sBAPJ,WAOI,QAAA,eAPJ,cAOI,KAAA,EAAA,EAAA,eAPJ,aAOI,eAAA,cAPJ,gBAOI,eAAA,iBAPJ,qBAOI,eAAA,sBAPJ,wBAOI,eAAA,yBAPJ,gBAOI,UAAA,YAPJ,gBAOI,UAAA,YAPJ,kBAOI,YAAA,YAPJ,kBAOI,YAAA,YAPJ,cAOI,UAAA,eAPJ,gBAOI,UAAA,iBAPJ,sBAOI,UAAA,uBAPJ,UAOI,IAAA,YAPJ,UAOI,IAAA,iBAPJ,UAOI,IAAA,gBAPJ,UAOI,IAAA,eAPJ,UAOI,IAAA,iBAPJ,UAOI,IAAA,eAPJ,0BAOI,gBAAA,qBAPJ,wBAOI,gBAAA,mBAPJ,2BAOI,gBAAA,iBAPJ,4BAOI,gBAAA,wBAPJ,2BAOI,gBAAA,uBAPJ,2BAOI,gBAAA,uBAPJ,sBAOI,YAAA,qBAPJ,oBAOI,YAAA,mBAPJ,uBAOI,YAAA,iBAPJ,yBAOI,YAAA,mBAPJ,wBAOI,YAAA,kBAPJ,wBAOI,cAAA,qBAPJ,sBAOI,cAAA,mBAPJ,yBAOI,cAAA,iBAPJ,0BAOI,cAAA,wBAPJ,yBAOI,cAAA,uBAPJ,0BAOI,cAAA,kBAPJ,oBAOI,WAAA,eAPJ,qBAOI,WAAA,qBAPJ,mBAOI,WAAA,mBAPJ,sBAOI,WAAA,iBAPJ,wBAOI,WAAA,mBAPJ,uBAOI,WAAA,kBAPJ,gBAOI,MAAA,aAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,eAOI,MAAA,YAPJ,QAOI,OAAA,YAPJ,QAOI,OAAA,iBAPJ,QAOI,OAAA,gBAPJ,QAOI,OAAA,eAPJ,QAOI,OAAA,iBAPJ,QAOI,OAAA,eAPJ,WAOI,OAAA,eAPJ,SAOI,aAAA,YAAA,YAAA,YAPJ,SAOI,aAAA,iBAAA,YAAA,iBAPJ,SAOI,aAAA,gBAAA,YAAA,gBAPJ,SAOI,aAAA,eAAA,YAAA,eAPJ,SAOI,aAAA,iBAAA,YAAA,iBAPJ,SAOI,aAAA,eAAA,YAAA,eAPJ,YAOI,aAAA,eAAA,YAAA,eAPJ,SAOI,WAAA,YAAA,cAAA,YAPJ,SAOI,WAAA,iBAAA,cAAA,iBAPJ,SAOI,WAAA,gBAAA,cAAA,gBAPJ,SAOI,WAAA,eAAA,cAAA,eAPJ,SAOI,WAAA,iBAAA,cAAA,iBAPJ,SAOI,WAAA,eAAA,cAAA,eAPJ,YAOI,WAAA,eAAA,cAAA,eAPJ,SAOI,WAAA,YAPJ,SAOI,WAAA,iBAPJ,SAOI,WAAA,gBAPJ,SAOI,WAAA,eAPJ,SAOI,WAAA,iBAPJ,SAOI,WAAA,eAPJ,YAOI,WAAA,eAPJ,SAOI,aAAA,YAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,gBAPJ,SAOI,aAAA,eAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,eAPJ,YAOI,aAAA,eAPJ,SAOI,cAAA,YAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,gBAPJ,SAOI,cAAA,eAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,eAPJ,YAOI,cAAA,eAPJ,SAOI,YAAA,YAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,gBAPJ,SAOI,YAAA,eAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,eAPJ,YAOI,YAAA,eAPJ,QAOI,QAAA,YAPJ,QAOI,QAAA,iBAPJ,QAOI,QAAA,gBAPJ,QAOI,QAAA,eAPJ,QAOI,QAAA,iBAPJ,QAOI,QAAA,eAPJ,SAOI,cAAA,YAAA,aAAA,YAPJ,SAOI,cAAA,iBAAA,aAAA,iBAPJ,SAOI,cAAA,gBAAA,aAAA,gBAPJ,SAOI,cAAA,eAAA,aAAA,eAPJ,SAOI,cAAA,iBAAA,aAAA,iBAPJ,SAOI,cAAA,eAAA,aAAA,eAPJ,SAOI,YAAA,YAAA,eAAA,YAPJ,SAOI,YAAA,iBAAA,eAAA,iBAPJ,SAOI,YAAA,gBAAA,eAAA,gBAPJ,SAOI,YAAA,eAAA,eAAA,eAPJ,SAOI,YAAA,iBAAA,eAAA,iBAPJ,SAOI,YAAA,eAAA,eAAA,eAPJ,SAOI,YAAA,YAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,gBAPJ,SAOI,YAAA,eAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,eAPJ,SAOI,cAAA,YAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,gBAPJ,SAOI,cAAA,eAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,eAPJ,SAOI,eAAA,YAPJ,SAOI,eAAA,iBAPJ,SAOI,eAAA,gBAPJ,SAOI,eAAA,eAPJ,SAOI,eAAA,iBAPJ,SAOI,eAAA,eAPJ,SAOI,aAAA,YAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,gBAPJ,SAOI,aAAA,eAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,eAPJ,eAOI,WAAA,eAPJ,aAOI,WAAA,gBAPJ,gBAOI,WAAA,kBzDPR,yByDAI,gBAOI,MAAA,eAPJ,cAOI,MAAA,gBAPJ,eAOI,MAAA,eAPJ,aAOI,QAAA,iBAPJ,mBAOI,QAAA,uBAPJ,YAOI,QAAA,gBAPJ,WAOI,QAAA,eAPJ,YAOI,QAAA,gBAPJ,gBAOI,QAAA,oBAPJ,iBAOI,QAAA,qBAPJ,WAOI,QAAA,eAPJ,kBAOI,QAAA,sBAPJ,WAOI,QAAA,eAPJ,cAOI,KAAA,EAAA,EAAA,eAPJ,aAOI,eAAA,cAPJ,gBAOI,eAAA,iBAPJ,qBAOI,eAAA,sBAPJ,wBAOI,eAAA,yBAPJ,gBAOI,UAAA,YAPJ,gBAOI,UAAA,YAPJ,kBAOI,YAAA,YAPJ,kBAOI,YAAA,YAPJ,cAOI,UAAA,eAPJ,gBAOI,UAAA,iBAPJ,sBAOI,UAAA,uBAPJ,UAOI,IAAA,YAPJ,UAOI,IAAA,iBAPJ,UAOI,IAAA,gBAPJ,UAOI,IAAA,eAPJ,UAOI,IAAA,iBAPJ,UAOI,IAAA,eAPJ,0BAOI,gBAAA,qBAPJ,wBAOI,gBAAA,mBAPJ,2BAOI,gBAAA,iBAPJ,4BAOI,gBAAA,wBAPJ,2BAOI,gBAAA,uBAPJ,2BAOI,gBAAA,uBAPJ,sBAOI,YAAA,qBAPJ,oBAOI,YAAA,mBAPJ,uBAOI,YAAA,iBAPJ,yBAOI,YAAA,mBAPJ,wBAOI,YAAA,kBAPJ,wBAOI,cAAA,qBAPJ,sBAOI,cAAA,mBAPJ,yBAOI,cAAA,iBAPJ,0BAOI,cAAA,wBAPJ,yBAOI,cAAA,uBAPJ,0BAOI,cAAA,kBAPJ,oBAOI,WAAA,eAPJ,qBAOI,WAAA,qBAPJ,mBAOI,WAAA,mBAPJ,sBAOI,WAAA,iBAPJ,wBAOI,WAAA,mBAPJ,uBAOI,WAAA,kBAPJ,gBAOI,MAAA,aAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,eAOI,MAAA,YAPJ,QAOI,OAAA,YAPJ,QAOI,OAAA,iBAPJ,QAOI,OAAA,gBAPJ,QAOI,OAAA,eAPJ,QAOI,OAAA,iBAPJ,QAOI,OAAA,eAPJ,WAOI,OAAA,eAPJ,SAOI,aAAA,YAAA,YAAA,YAPJ,SAOI,aAAA,iBAAA,YAAA,iBAPJ,SAOI,aAAA,gBAAA,YAAA,gBAPJ,SAOI,aAAA,eAAA,YAAA,eAPJ,SAOI,aAAA,iBAAA,YAAA,iBAPJ,SAOI,aAAA,eAAA,YAAA,eAPJ,YAOI,aAAA,eAAA,YAAA,eAPJ,SAOI,WAAA,YAAA,cAAA,YAPJ,SAOI,WAAA,iBAAA,cAAA,iBAPJ,SAOI,WAAA,gBAAA,cAAA,gBAPJ,SAOI,WAAA,eAAA,cAAA,eAPJ,SAOI,WAAA,iBAAA,cAAA,iBAPJ,SAOI,WAAA,eAAA,cAAA,eAPJ,YAOI,WAAA,eAAA,cAAA,eAPJ,SAOI,WAAA,YAPJ,SAOI,WAAA,iBAPJ,SAOI,WAAA,gBAPJ,SAOI,WAAA,eAPJ,SAOI,WAAA,iBAPJ,SAOI,WAAA,eAPJ,YAOI,WAAA,eAPJ,SAOI,aAAA,YAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,gBAPJ,SAOI,aAAA,eAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,eAPJ,YAOI,aAAA,eAPJ,SAOI,cAAA,YAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,gBAPJ,SAOI,cAAA,eAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,eAPJ,YAOI,cAAA,eAPJ,SAOI,YAAA,YAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,gBAPJ,SAOI,YAAA,eAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,eAPJ,YAOI,YAAA,eAPJ,QAOI,QAAA,YAPJ,QAOI,QAAA,iBAPJ,QAOI,QAAA,gBAPJ,QAOI,QAAA,eAPJ,QAOI,QAAA,iBAPJ,QAOI,QAAA,eAPJ,SAOI,cAAA,YAAA,aAAA,YAPJ,SAOI,cAAA,iBAAA,aAAA,iBAPJ,SAOI,cAAA,gBAAA,aAAA,gBAPJ,SAOI,cAAA,eAAA,aAAA,eAPJ,SAOI,cAAA,iBAAA,aAAA,iBAPJ,SAOI,cAAA,eAAA,aAAA,eAPJ,SAOI,YAAA,YAAA,eAAA,YAPJ,SAOI,YAAA,iBAAA,eAAA,iBAPJ,SAOI,YAAA,gBAAA,eAAA,gBAPJ,SAOI,YAAA,eAAA,eAAA,eAPJ,SAOI,YAAA,iBAAA,eAAA,iBAPJ,SAOI,YAAA,eAAA,eAAA,eAPJ,SAOI,YAAA,YAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,gBAPJ,SAOI,YAAA,eAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,eAPJ,SAOI,cAAA,YAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,gBAPJ,SAOI,cAAA,eAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,eAPJ,SAOI,eAAA,YAPJ,SAOI,eAAA,iBAPJ,SAOI,eAAA,gBAPJ,SAOI,eAAA,eAPJ,SAOI,eAAA,iBAPJ,SAOI,eAAA,eAPJ,SAOI,aAAA,YAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,gBAPJ,SAOI,aAAA,eAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,eAPJ,eAOI,WAAA,eAPJ,aAOI,WAAA,gBAPJ,gBAOI,WAAA,kBzDPR,yByDAI,gBAOI,MAAA,eAPJ,cAOI,MAAA,gBAPJ,eAOI,MAAA,eAPJ,aAOI,QAAA,iBAPJ,mBAOI,QAAA,uBAPJ,YAOI,QAAA,gBAPJ,WAOI,QAAA,eAPJ,YAOI,QAAA,gBAPJ,gBAOI,QAAA,oBAPJ,iBAOI,QAAA,qBAPJ,WAOI,QAAA,eAPJ,kBAOI,QAAA,sBAPJ,WAOI,QAAA,eAPJ,cAOI,KAAA,EAAA,EAAA,eAPJ,aAOI,eAAA,cAPJ,gBAOI,eAAA,iBAPJ,qBAOI,eAAA,sBAPJ,wBAOI,eAAA,yBAPJ,gBAOI,UAAA,YAPJ,gBAOI,UAAA,YAPJ,kBAOI,YAAA,YAPJ,kBAOI,YAAA,YAPJ,cAOI,UAAA,eAPJ,gBAOI,UAAA,iBAPJ,sBAOI,UAAA,uBAPJ,UAOI,IAAA,YAPJ,UAOI,IAAA,iBAPJ,UAOI,IAAA,gBAPJ,UAOI,IAAA,eAPJ,UAOI,IAAA,iBAPJ,UAOI,IAAA,eAPJ,0BAOI,gBAAA,qBAPJ,wBAOI,gBAAA,mBAPJ,2BAOI,gBAAA,iBAPJ,4BAOI,gBAAA,wBAPJ,2BAOI,gBAAA,uBAPJ,2BAOI,gBAAA,uBAPJ,sBAOI,YAAA,qBAPJ,oBAOI,YAAA,mBAPJ,uBAOI,YAAA,iBAPJ,yBAOI,YAAA,mBAPJ,wBAOI,YAAA,kBAPJ,wBAOI,cAAA,qBAPJ,sBAOI,cAAA,mBAPJ,yBAOI,cAAA,iBAPJ,0BAOI,cAAA,wBAPJ,yBAOI,cAAA,uBAPJ,0BAOI,cAAA,kBAPJ,oBAOI,WAAA,eAPJ,qBAOI,WAAA,qBAPJ,mBAOI,WAAA,mBAPJ,sBAOI,WAAA,iBAPJ,wBAOI,WAAA,mBAPJ,uBAOI,WAAA,kBAPJ,gBAOI,MAAA,aAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,eAOI,MAAA,YAPJ,QAOI,OAAA,YAPJ,QAOI,OAAA,iBAPJ,QAOI,OAAA,gBAPJ,QAOI,OAAA,eAPJ,QAOI,OAAA,iBAPJ,QAOI,OAAA,eAPJ,WAOI,OAAA,eAPJ,SAOI,aAAA,YAAA,YAAA,YAPJ,SAOI,aAAA,iBAAA,YAAA,iBAPJ,SAOI,aAAA,gBAAA,YAAA,gBAPJ,SAOI,aAAA,eAAA,YAAA,eAPJ,SAOI,aAAA,iBAAA,YAAA,iBAPJ,SAOI,aAAA,eAAA,YAAA,eAPJ,YAOI,aAAA,eAAA,YAAA,eAPJ,SAOI,WAAA,YAAA,cAAA,YAPJ,SAOI,WAAA,iBAAA,cAAA,iBAPJ,SAOI,WAAA,gBAAA,cAAA,gBAPJ,SAOI,WAAA,eAAA,cAAA,eAPJ,SAOI,WAAA,iBAAA,cAAA,iBAPJ,SAOI,WAAA,eAAA,cAAA,eAPJ,YAOI,WAAA,eAAA,cAAA,eAPJ,SAOI,WAAA,YAPJ,SAOI,WAAA,iBAPJ,SAOI,WAAA,gBAPJ,SAOI,WAAA,eAPJ,SAOI,WAAA,iBAPJ,SAOI,WAAA,eAPJ,YAOI,WAAA,eAPJ,SAOI,aAAA,YAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,gBAPJ,SAOI,aAAA,eAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,eAPJ,YAOI,aAAA,eAPJ,SAOI,cAAA,YAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,gBAPJ,SAOI,cAAA,eAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,eAPJ,YAOI,cAAA,eAPJ,SAOI,YAAA,YAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,gBAPJ,SAOI,YAAA,eAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,eAPJ,YAOI,YAAA,eAPJ,QAOI,QAAA,YAPJ,QAOI,QAAA,iBAPJ,QAOI,QAAA,gBAPJ,QAOI,QAAA,eAPJ,QAOI,QAAA,iBAPJ,QAOI,QAAA,eAPJ,SAOI,cAAA,YAAA,aAAA,YAPJ,SAOI,cAAA,iBAAA,aAAA,iBAPJ,SAOI,cAAA,gBAAA,aAAA,gBAPJ,SAOI,cAAA,eAAA,aAAA,eAPJ,SAOI,cAAA,iBAAA,aAAA,iBAPJ,SAOI,cAAA,eAAA,aAAA,eAPJ,SAOI,YAAA,YAAA,eAAA,YAPJ,SAOI,YAAA,iBAAA,eAAA,iBAPJ,SAOI,YAAA,gBAAA,eAAA,gBAPJ,SAOI,YAAA,eAAA,eAAA,eAPJ,SAOI,YAAA,iBAAA,eAAA,iBAPJ,SAOI,YAAA,eAAA,eAAA,eAPJ,SAOI,YAAA,YAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,gBAPJ,SAOI,YAAA,eAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,eAPJ,SAOI,cAAA,YAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,gBAPJ,SAOI,cAAA,eAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,eAPJ,SAOI,eAAA,YAPJ,SAOI,eAAA,iBAPJ,SAOI,eAAA,gBAPJ,SAOI,eAAA,eAPJ,SAOI,eAAA,iBAPJ,SAOI,eAAA,eAPJ,SAOI,aAAA,YAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,gBAPJ,SAOI,aAAA,eAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,eAPJ,eAOI,WAAA,eAPJ,aAOI,WAAA,gBAPJ,gBAOI,WAAA,kBzDPR,0ByDAI,gBAOI,MAAA,eAPJ,cAOI,MAAA,gBAPJ,eAOI,MAAA,eAPJ,aAOI,QAAA,iBAPJ,mBAOI,QAAA,uBAPJ,YAOI,QAAA,gBAPJ,WAOI,QAAA,eAPJ,YAOI,QAAA,gBAPJ,gBAOI,QAAA,oBAPJ,iBAOI,QAAA,qBAPJ,WAOI,QAAA,eAPJ,kBAOI,QAAA,sBAPJ,WAOI,QAAA,eAPJ,cAOI,KAAA,EAAA,EAAA,eAPJ,aAOI,eAAA,cAPJ,gBAOI,eAAA,iBAPJ,qBAOI,eAAA,sBAPJ,wBAOI,eAAA,yBAPJ,gBAOI,UAAA,YAPJ,gBAOI,UAAA,YAPJ,kBAOI,YAAA,YAPJ,kBAOI,YAAA,YAPJ,cAOI,UAAA,eAPJ,gBAOI,UAAA,iBAPJ,sBAOI,UAAA,uBAPJ,UAOI,IAAA,YAPJ,UAOI,IAAA,iBAPJ,UAOI,IAAA,gBAPJ,UAOI,IAAA,eAPJ,UAOI,IAAA,iBAPJ,UAOI,IAAA,eAPJ,0BAOI,gBAAA,qBAPJ,wBAOI,gBAAA,mBAPJ,2BAOI,gBAAA,iBAPJ,4BAOI,gBAAA,wBAPJ,2BAOI,gBAAA,uBAPJ,2BAOI,gBAAA,uBAPJ,sBAOI,YAAA,qBAPJ,oBAOI,YAAA,mBAPJ,uBAOI,YAAA,iBAPJ,yBAOI,YAAA,mBAPJ,wBAOI,YAAA,kBAPJ,wBAOI,cAAA,qBAPJ,sBAOI,cAAA,mBAPJ,yBAOI,cAAA,iBAPJ,0BAOI,cAAA,wBAPJ,yBAOI,cAAA,uBAPJ,0BAOI,cAAA,kBAPJ,oBAOI,WAAA,eAPJ,qBAOI,WAAA,qBAPJ,mBAOI,WAAA,mBAPJ,sBAOI,WAAA,iBAPJ,wBAOI,WAAA,mBAPJ,uBAOI,WAAA,kBAPJ,gBAOI,MAAA,aAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,eAOI,MAAA,YAPJ,QAOI,OAAA,YAPJ,QAOI,OAAA,iBAPJ,QAOI,OAAA,gBAPJ,QAOI,OAAA,eAPJ,QAOI,OAAA,iBAPJ,QAOI,OAAA,eAPJ,WAOI,OAAA,eAPJ,SAOI,aAAA,YAAA,YAAA,YAPJ,SAOI,aAAA,iBAAA,YAAA,iBAPJ,SAOI,aAAA,gBAAA,YAAA,gBAPJ,SAOI,aAAA,eAAA,YAAA,eAPJ,SAOI,aAAA,iBAAA,YAAA,iBAPJ,SAOI,aAAA,eAAA,YAAA,eAPJ,YAOI,aAAA,eAAA,YAAA,eAPJ,SAOI,WAAA,YAAA,cAAA,YAPJ,SAOI,WAAA,iBAAA,cAAA,iBAPJ,SAOI,WAAA,gBAAA,cAAA,gBAPJ,SAOI,WAAA,eAAA,cAAA,eAPJ,SAOI,WAAA,iBAAA,cAAA,iBAPJ,SAOI,WAAA,eAAA,cAAA,eAPJ,YAOI,WAAA,eAAA,cAAA,eAPJ,SAOI,WAAA,YAPJ,SAOI,WAAA,iBAPJ,SAOI,WAAA,gBAPJ,SAOI,WAAA,eAPJ,SAOI,WAAA,iBAPJ,SAOI,WAAA,eAPJ,YAOI,WAAA,eAPJ,SAOI,aAAA,YAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,gBAPJ,SAOI,aAAA,eAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,eAPJ,YAOI,aAAA,eAPJ,SAOI,cAAA,YAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,gBAPJ,SAOI,cAAA,eAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,eAPJ,YAOI,cAAA,eAPJ,SAOI,YAAA,YAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,gBAPJ,SAOI,YAAA,eAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,eAPJ,YAOI,YAAA,eAPJ,QAOI,QAAA,YAPJ,QAOI,QAAA,iBAPJ,QAOI,QAAA,gBAPJ,QAOI,QAAA,eAPJ,QAOI,QAAA,iBAPJ,QAOI,QAAA,eAPJ,SAOI,cAAA,YAAA,aAAA,YAPJ,SAOI,cAAA,iBAAA,aAAA,iBAPJ,SAOI,cAAA,gBAAA,aAAA,gBAPJ,SAOI,cAAA,eAAA,aAAA,eAPJ,SAOI,cAAA,iBAAA,aAAA,iBAPJ,SAOI,cAAA,eAAA,aAAA,eAPJ,SAOI,YAAA,YAAA,eAAA,YAPJ,SAOI,YAAA,iBAAA,eAAA,iBAPJ,SAOI,YAAA,gBAAA,eAAA,gBAPJ,SAOI,YAAA,eAAA,eAAA,eAPJ,SAOI,YAAA,iBAAA,eAAA,iBAPJ,SAOI,YAAA,eAAA,eAAA,eAPJ,SAOI,YAAA,YAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,gBAPJ,SAOI,YAAA,eAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,eAPJ,SAOI,cAAA,YAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,gBAPJ,SAOI,cAAA,eAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,eAPJ,SAOI,eAAA,YAPJ,SAOI,eAAA,iBAPJ,SAOI,eAAA,gBAPJ,SAOI,eAAA,eAPJ,SAOI,eAAA,iBAPJ,SAOI,eAAA,eAPJ,SAOI,aAAA,YAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,gBAPJ,SAOI,aAAA,eAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,eAPJ,eAOI,WAAA,eAPJ,aAOI,WAAA,gBAPJ,gBAOI,WAAA,kBzDPR,0ByDAI,iBAOI,MAAA,eAPJ,eAOI,MAAA,gBAPJ,gBAOI,MAAA,eAPJ,cAOI,QAAA,iBAPJ,oBAOI,QAAA,uBAPJ,aAOI,QAAA,gBAPJ,YAOI,QAAA,eAPJ,aAOI,QAAA,gBAPJ,iBAOI,QAAA,oBAPJ,kBAOI,QAAA,qBAPJ,YAOI,QAAA,eAPJ,mBAOI,QAAA,sBAPJ,YAOI,QAAA,eAPJ,eAOI,KAAA,EAAA,EAAA,eAPJ,cAOI,eAAA,cAPJ,iBAOI,eAAA,iBAPJ,sBAOI,eAAA,sBAPJ,yBAOI,eAAA,yBAPJ,iBAOI,UAAA,YAPJ,iBAOI,UAAA,YAPJ,mBAOI,YAAA,YAPJ,mBAOI,YAAA,YAPJ,eAOI,UAAA,eAPJ,iBAOI,UAAA,iBAPJ,uBAOI,UAAA,uBAPJ,WAOI,IAAA,YAPJ,WAOI,IAAA,iBAPJ,WAOI,IAAA,gBAPJ,WAOI,IAAA,eAPJ,WAOI,IAAA,iBAPJ,WAOI,IAAA,eAPJ,2BAOI,gBAAA,qBAPJ,yBAOI,gBAAA,mBAPJ,4BAOI,gBAAA,iBAPJ,6BAOI,gBAAA,wBAPJ,4BAOI,gBAAA,uBAPJ,4BAOI,gBAAA,uBAPJ,uBAOI,YAAA,qBAPJ,qBAOI,YAAA,mBAPJ,wBAOI,YAAA,iBAPJ,0BAOI,YAAA,mBAPJ,yBAOI,YAAA,kBAPJ,yBAOI,cAAA,qBAPJ,uBAOI,cAAA,mBAPJ,0BAOI,cAAA,iBAPJ,2BAOI,cAAA,wBAPJ,0BAOI,cAAA,uBAPJ,2BAOI,cAAA,kBAPJ,qBAOI,WAAA,eAPJ,sBAOI,WAAA,qBAPJ,oBAOI,WAAA,mBAPJ,uBAOI,WAAA,iBAPJ,yBAOI,WAAA,mBAPJ,wBAOI,WAAA,kBAPJ,iBAOI,MAAA,aAPJ,aAOI,MAAA,YAPJ,aAOI,MAAA,YAPJ,aAOI,MAAA,YAPJ,aAOI,MAAA,YAPJ,aAOI,MAAA,YAPJ,aAOI,MAAA,YAPJ,gBAOI,MAAA,YAPJ,SAOI,OAAA,YAPJ,SAOI,OAAA,iBAPJ,SAOI,OAAA,gBAPJ,SAOI,OAAA,eAPJ,SAOI,OAAA,iBAPJ,SAOI,OAAA,eAPJ,YAOI,OAAA,eAPJ,UAOI,aAAA,YAAA,YAAA,YAPJ,UAOI,aAAA,iBAAA,YAAA,iBAPJ,UAOI,aAAA,gBAAA,YAAA,gBAPJ,UAOI,aAAA,eAAA,YAAA,eAPJ,UAOI,aAAA,iBAAA,YAAA,iBAPJ,UAOI,aAAA,eAAA,YAAA,eAPJ,aAOI,aAAA,eAAA,YAAA,eAPJ,UAOI,WAAA,YAAA,cAAA,YAPJ,UAOI,WAAA,iBAAA,cAAA,iBAPJ,UAOI,WAAA,gBAAA,cAAA,gBAPJ,UAOI,WAAA,eAAA,cAAA,eAPJ,UAOI,WAAA,iBAAA,cAAA,iBAPJ,UAOI,WAAA,eAAA,cAAA,eAPJ,aAOI,WAAA,eAAA,cAAA,eAPJ,UAOI,WAAA,YAPJ,UAOI,WAAA,iBAPJ,UAOI,WAAA,gBAPJ,UAOI,WAAA,eAPJ,UAOI,WAAA,iBAPJ,UAOI,WAAA,eAPJ,aAOI,WAAA,eAPJ,UAOI,aAAA,YAPJ,UAOI,aAAA,iBAPJ,UAOI,aAAA,gBAPJ,UAOI,aAAA,eAPJ,UAOI,aAAA,iBAPJ,UAOI,aAAA,eAPJ,aAOI,aAAA,eAPJ,UAOI,cAAA,YAPJ,UAOI,cAAA,iBAPJ,UAOI,cAAA,gBAPJ,UAOI,cAAA,eAPJ,UAOI,cAAA,iBAPJ,UAOI,cAAA,eAPJ,aAOI,cAAA,eAPJ,UAOI,YAAA,YAPJ,UAOI,YAAA,iBAPJ,UAOI,YAAA,gBAPJ,UAOI,YAAA,eAPJ,UAOI,YAAA,iBAPJ,UAOI,YAAA,eAPJ,aAOI,YAAA,eAPJ,SAOI,QAAA,YAPJ,SAOI,QAAA,iBAPJ,SAOI,QAAA,gBAPJ,SAOI,QAAA,eAPJ,SAOI,QAAA,iBAPJ,SAOI,QAAA,eAPJ,UAOI,cAAA,YAAA,aAAA,YAPJ,UAOI,cAAA,iBAAA,aAAA,iBAPJ,UAOI,cAAA,gBAAA,aAAA,gBAPJ,UAOI,cAAA,eAAA,aAAA,eAPJ,UAOI,cAAA,iBAAA,aAAA,iBAPJ,UAOI,cAAA,eAAA,aAAA,eAPJ,UAOI,YAAA,YAAA,eAAA,YAPJ,UAOI,YAAA,iBAAA,eAAA,iBAPJ,UAOI,YAAA,gBAAA,eAAA,gBAPJ,UAOI,YAAA,eAAA,eAAA,eAPJ,UAOI,YAAA,iBAAA,eAAA,iBAPJ,UAOI,YAAA,eAAA,eAAA,eAPJ,UAOI,YAAA,YAPJ,UAOI,YAAA,iBAPJ,UAOI,YAAA,gBAPJ,UAOI,YAAA,eAPJ,UAOI,YAAA,iBAPJ,UAOI,YAAA,eAPJ,UAOI,cAAA,YAPJ,UAOI,cAAA,iBAPJ,UAOI,cAAA,gBAPJ,UAOI,cAAA,eAPJ,UAOI,cAAA,iBAPJ,UAOI,cAAA,eAPJ,UAOI,eAAA,YAPJ,UAOI,eAAA,iBAPJ,UAOI,eAAA,gBAPJ,UAOI,eAAA,eAPJ,UAOI,eAAA,iBAPJ,UAOI,eAAA,eAPJ,UAOI,aAAA,YAPJ,UAOI,aAAA,iBAPJ,UAOI,aAAA,gBAPJ,UAOI,aAAA,eAPJ,UAOI,aAAA,iBAPJ,UAOI,aAAA,eAPJ,gBAOI,WAAA,eAPJ,cAOI,WAAA,gBAPJ,iBAOI,WAAA,kBCnDZ,0BD4CQ,MAOI,UAAA,iBAPJ,MAOI,UAAA,eAPJ,MAOI,UAAA,kBAPJ,MAOI,UAAA,kBChCZ,aDyBQ,gBAOI,QAAA,iBAPJ,sBAOI,QAAA,uBAPJ,eAOI,QAAA,gBAPJ,cAOI,QAAA,eAPJ,eAOI,QAAA,gBAPJ,mBAOI,QAAA,oBAPJ,oBAOI,QAAA,qBAPJ,cAOI,QAAA,eAPJ,qBAOI,QAAA,sBAPJ,cAOI,QAAA","sourcesContent":["/*!\n * Bootstrap v5.1.0 (https://getbootstrap.com/)\n * Copyright 2011-2021 The Bootstrap Authors\n * Copyright 2011-2021 Twitter, Inc.\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n */\n\n// scss-docs-start import-stack\n// Configuration\n@import \"functions\";\n@import \"variables\";\n@import \"mixins\";\n@import \"utilities\";\n\n// Layout & components\n@import \"root\";\n@import \"reboot\";\n@import \"type\";\n@import \"images\";\n@import \"containers\";\n@import \"grid\";\n@import \"tables\";\n@import \"forms\";\n@import \"buttons\";\n@import \"transitions\";\n@import \"dropdown\";\n@import \"button-group\";\n@import \"nav\";\n@import \"navbar\";\n@import \"card\";\n@import \"accordion\";\n@import \"breadcrumb\";\n@import \"pagination\";\n@import \"badge\";\n@import \"alert\";\n@import \"progress\";\n@import \"list-group\";\n@import \"close\";\n@import \"toasts\";\n@import \"modal\";\n@import \"tooltip\";\n@import \"popover\";\n@import \"carousel\";\n@import \"spinners\";\n@import \"offcanvas\";\n@import \"placeholders\";\n\n// Helpers\n@import \"helpers\";\n\n// Utilities\n@import \"utilities/api\";\n// scss-docs-end import-stack\n",":root {\n  // Note: Custom variable values only support SassScript inside `#{}`.\n\n  // Colors\n  //\n  // Generate palettes for full colors, grays, and theme colors.\n\n  @each $color, $value in $colors {\n    --#{$variable-prefix}#{$color}: #{$value};\n  }\n\n  @each $color, $value in $grays {\n    --#{$variable-prefix}gray-#{$color}: #{$value};\n  }\n\n  @each $color, $value in $theme-colors {\n    --#{$variable-prefix}#{$color}: #{$value};\n  }\n\n  @each $color, $value in $theme-colors-rgb {\n    --#{$variable-prefix}#{$color}-rgb: #{$value};\n  }\n\n  --#{$variable-prefix}white-rgb: #{to-rgb($white)};\n  --#{$variable-prefix}black-rgb: #{to-rgb($black)};\n  --#{$variable-prefix}body-rgb: #{to-rgb($body-color)};\n\n  // Fonts\n\n  // Note: Use `inspect` for lists so that quoted items keep the quotes.\n  // See https://github.com/sass/sass/issues/2383#issuecomment-336349172\n  --#{$variable-prefix}font-sans-serif: #{inspect($font-family-sans-serif)};\n  --#{$variable-prefix}font-monospace: #{inspect($font-family-monospace)};\n  --#{$variable-prefix}gradient: #{$gradient};\n\n  // Root and body\n  // stylelint-disable custom-property-empty-line-before\n  // scss-docs-start root-body-variables\n  @if $font-size-root != null {\n    --#{$variable-prefix}root-font-size: #{$font-size-root};\n  }\n  --#{$variable-prefix}body-font-family: #{$font-family-base};\n  --#{$variable-prefix}body-font-size: #{$font-size-base};\n  --#{$variable-prefix}body-font-weight: #{$font-weight-base};\n  --#{$variable-prefix}body-line-height: #{$line-height-base};\n  --#{$variable-prefix}body-color: #{$body-color};\n  @if $body-text-align != null {\n    --#{$variable-prefix}body-text-align: #{$body-text-align};\n  }\n  --#{$variable-prefix}body-bg: #{$body-bg};\n  // scss-docs-end root-body-variables\n  // stylelint-enable custom-property-empty-line-before\n}\n","// stylelint-disable declaration-no-important, selector-no-qualifying-type, property-no-vendor-prefix\n\n\n// Reboot\n//\n// Normalization of HTML elements, manually forked from Normalize.css to remove\n// styles targeting irrelevant browsers while applying new styles.\n//\n// Normalize is licensed MIT. https://github.com/necolas/normalize.css\n\n\n// Document\n//\n// Change from `box-sizing: content-box` so that `width` is not affected by `padding` or `border`.\n\n*,\n*::before,\n*::after {\n  box-sizing: border-box;\n}\n\n\n// Root\n//\n// Ability to the value of the root font sizes, affecting the value of `rem`.\n// null by default, thus nothing is generated.\n\n:root {\n  @if $font-size-root != null {\n    font-size: var(--#{$variable-prefix}-root-font-size);\n  }\n\n  @if $enable-smooth-scroll {\n    @media (prefers-reduced-motion: no-preference) {\n      scroll-behavior: smooth;\n    }\n  }\n}\n\n\n// Body\n//\n// 1. Remove the margin in all browsers.\n// 2. As a best practice, apply a default `background-color`.\n// 3. Prevent adjustments of font size after orientation changes in iOS.\n// 4. Change the default tap highlight to be completely transparent in iOS.\n\n// scss-docs-start reboot-body-rules\nbody {\n  margin: 0; // 1\n  font-family: var(--#{$variable-prefix}body-font-family);\n  @include font-size(var(--#{$variable-prefix}body-font-size));\n  font-weight: var(--#{$variable-prefix}body-font-weight);\n  line-height: var(--#{$variable-prefix}body-line-height);\n  color: var(--#{$variable-prefix}body-color);\n  text-align: var(--#{$variable-prefix}body-text-align);\n  background-color: var(--#{$variable-prefix}body-bg); // 2\n  -webkit-text-size-adjust: 100%; // 3\n  -webkit-tap-highlight-color: rgba($black, 0); // 4\n}\n// scss-docs-end reboot-body-rules\n\n\n// Content grouping\n//\n// 1. Reset Firefox's gray color\n// 2. Set correct height and prevent the `size` attribute to make the `hr` look like an input field\n\nhr {\n  margin: $hr-margin-y 0;\n  color: $hr-color; // 1\n  background-color: currentColor;\n  border: 0;\n  opacity: $hr-opacity;\n}\n\nhr:not([size]) {\n  height: $hr-height; // 2\n}\n\n\n// Typography\n//\n// 1. Remove top margins from headings\n//    By default, `<h1>`-`<h6>` all receive top and bottom margins. We nuke the top\n//    margin for easier control within type scales as it avoids margin collapsing.\n\n%heading {\n  margin-top: 0; // 1\n  margin-bottom: $headings-margin-bottom;\n  font-family: $headings-font-family;\n  font-style: $headings-font-style;\n  font-weight: $headings-font-weight;\n  line-height: $headings-line-height;\n  color: $headings-color;\n}\n\nh1 {\n  @extend %heading;\n  @include font-size($h1-font-size);\n}\n\nh2 {\n  @extend %heading;\n  @include font-size($h2-font-size);\n}\n\nh3 {\n  @extend %heading;\n  @include font-size($h3-font-size);\n}\n\nh4 {\n  @extend %heading;\n  @include font-size($h4-font-size);\n}\n\nh5 {\n  @extend %heading;\n  @include font-size($h5-font-size);\n}\n\nh6 {\n  @extend %heading;\n  @include font-size($h6-font-size);\n}\n\n\n// Reset margins on paragraphs\n//\n// Similarly, the top margin on `<p>`s get reset. However, we also reset the\n// bottom margin to use `rem` units instead of `em`.\n\np {\n  margin-top: 0;\n  margin-bottom: $paragraph-margin-bottom;\n}\n\n\n// Abbreviations\n//\n// 1. Duplicate behavior to the data-bs-* attribute for our tooltip plugin\n// 2. Add the correct text decoration in Chrome, Edge, Opera, and Safari.\n// 3. Add explicit cursor to indicate changed behavior.\n// 4. Prevent the text-decoration to be skipped.\n\nabbr[title],\nabbr[data-bs-original-title] { // 1\n  text-decoration: underline dotted; // 2\n  cursor: help; // 3\n  text-decoration-skip-ink: none; // 4\n}\n\n\n// Address\n\naddress {\n  margin-bottom: 1rem;\n  font-style: normal;\n  line-height: inherit;\n}\n\n\n// Lists\n\nol,\nul {\n  padding-left: 2rem;\n}\n\nol,\nul,\ndl {\n  margin-top: 0;\n  margin-bottom: 1rem;\n}\n\nol ol,\nul ul,\nol ul,\nul ol {\n  margin-bottom: 0;\n}\n\ndt {\n  font-weight: $dt-font-weight;\n}\n\n// 1. Undo browser default\n\ndd {\n  margin-bottom: .5rem;\n  margin-left: 0; // 1\n}\n\n\n// Blockquote\n\nblockquote {\n  margin: 0 0 1rem;\n}\n\n\n// Strong\n//\n// Add the correct font weight in Chrome, Edge, and Safari\n\nb,\nstrong {\n  font-weight: $font-weight-bolder;\n}\n\n\n// Small\n//\n// Add the correct font size in all browsers\n\nsmall {\n  @include font-size($small-font-size);\n}\n\n\n// Mark\n\nmark {\n  padding: $mark-padding;\n  background-color: $mark-bg;\n}\n\n\n// Sub and Sup\n//\n// Prevent `sub` and `sup` elements from affecting the line height in\n// all browsers.\n\nsub,\nsup {\n  position: relative;\n  @include font-size($sub-sup-font-size);\n  line-height: 0;\n  vertical-align: baseline;\n}\n\nsub { bottom: -.25em; }\nsup { top: -.5em; }\n\n\n// Links\n\na {\n  color: $link-color;\n  text-decoration: $link-decoration;\n\n  &:hover {\n    color: $link-hover-color;\n    text-decoration: $link-hover-decoration;\n  }\n}\n\n// And undo these styles for placeholder links/named anchors (without href).\n// It would be more straightforward to just use a[href] in previous block, but that\n// causes specificity issues in many other styles that are too complex to fix.\n// See https://github.com/twbs/bootstrap/issues/19402\n\na:not([href]):not([class]) {\n  &,\n  &:hover {\n    color: inherit;\n    text-decoration: none;\n  }\n}\n\n\n// Code\n\npre,\ncode,\nkbd,\nsamp {\n  font-family: $font-family-code;\n  @include font-size(1em); // Correct the odd `em` font sizing in all browsers.\n  direction: ltr #{\"/* rtl:ignore */\"};\n  unicode-bidi: bidi-override;\n}\n\n// 1. Remove browser default top margin\n// 2. Reset browser default of `1em` to use `rem`s\n// 3. Don't allow content to break outside\n\npre {\n  display: block;\n  margin-top: 0; // 1\n  margin-bottom: 1rem; // 2\n  overflow: auto; // 3\n  @include font-size($code-font-size);\n  color: $pre-color;\n\n  // Account for some code outputs that place code tags in pre tags\n  code {\n    @include font-size(inherit);\n    color: inherit;\n    word-break: normal;\n  }\n}\n\ncode {\n  @include font-size($code-font-size);\n  color: $code-color;\n  word-wrap: break-word;\n\n  // Streamline the style when inside anchors to avoid broken underline and more\n  a > & {\n    color: inherit;\n  }\n}\n\nkbd {\n  padding: $kbd-padding-y $kbd-padding-x;\n  @include font-size($kbd-font-size);\n  color: $kbd-color;\n  background-color: $kbd-bg;\n  @include border-radius($border-radius-sm);\n\n  kbd {\n    padding: 0;\n    @include font-size(1em);\n    font-weight: $nested-kbd-font-weight;\n  }\n}\n\n\n// Figures\n//\n// Apply a consistent margin strategy (matches our type styles).\n\nfigure {\n  margin: 0 0 1rem;\n}\n\n\n// Images and content\n\nimg,\nsvg {\n  vertical-align: middle;\n}\n\n\n// Tables\n//\n// Prevent double borders\n\ntable {\n  caption-side: bottom;\n  border-collapse: collapse;\n}\n\ncaption {\n  padding-top: $table-cell-padding-y;\n  padding-bottom: $table-cell-padding-y;\n  color: $table-caption-color;\n  text-align: left;\n}\n\n// 1. Removes font-weight bold by inheriting\n// 2. Matches default `<td>` alignment by inheriting `text-align`.\n// 3. Fix alignment for Safari\n\nth {\n  font-weight: $table-th-font-weight; // 1\n  text-align: inherit; // 2\n  text-align: -webkit-match-parent; // 3\n}\n\nthead,\ntbody,\ntfoot,\ntr,\ntd,\nth {\n  border-color: inherit;\n  border-style: solid;\n  border-width: 0;\n}\n\n\n// Forms\n//\n// 1. Allow labels to use `margin` for spacing.\n\nlabel {\n  display: inline-block; // 1\n}\n\n// Remove the default `border-radius` that macOS Chrome adds.\n// See https://github.com/twbs/bootstrap/issues/24093\n\nbutton {\n  // stylelint-disable-next-line property-disallowed-list\n  border-radius: 0;\n}\n\n// Explicitly remove focus outline in Chromium when it shouldn't be\n// visible (e.g. as result of mouse click or touch tap). It already\n// should be doing this automatically, but seems to currently be\n// confused and applies its very visible two-tone outline anyway.\n\nbutton:focus:not(:focus-visible) {\n  outline: 0;\n}\n\n// 1. Remove the margin in Firefox and Safari\n\ninput,\nbutton,\nselect,\noptgroup,\ntextarea {\n  margin: 0; // 1\n  font-family: inherit;\n  @include font-size(inherit);\n  line-height: inherit;\n}\n\n// Remove the inheritance of text transform in Firefox\nbutton,\nselect {\n  text-transform: none;\n}\n// Set the cursor for non-`<button>` buttons\n//\n// Details at https://github.com/twbs/bootstrap/pull/30562\n[role=\"button\"] {\n  cursor: pointer;\n}\n\nselect {\n  // Remove the inheritance of word-wrap in Safari.\n  // See https://github.com/twbs/bootstrap/issues/24990\n  word-wrap: normal;\n\n  // Undo the opacity change from Chrome\n  &:disabled {\n    opacity: 1;\n  }\n}\n\n// Remove the dropdown arrow in Chrome from inputs built with datalists.\n// See https://stackoverflow.com/a/54997118\n\n[list]::-webkit-calendar-picker-indicator {\n  display: none;\n}\n\n// 1. Prevent a WebKit bug where (2) destroys native `audio` and `video`\n//    controls in Android 4.\n// 2. Correct the inability to style clickable types in iOS and Safari.\n// 3. Opinionated: add \"hand\" cursor to non-disabled button elements.\n\nbutton,\n[type=\"button\"], // 1\n[type=\"reset\"],\n[type=\"submit\"] {\n  -webkit-appearance: button; // 2\n\n  @if $enable-button-pointers {\n    &:not(:disabled) {\n      cursor: pointer; // 3\n    }\n  }\n}\n\n// Remove inner border and padding from Firefox, but don't restore the outline like Normalize.\n\n::-moz-focus-inner {\n  padding: 0;\n  border-style: none;\n}\n\n// 1. Textareas should really only resize vertically so they don't break their (horizontal) containers.\n\ntextarea {\n  resize: vertical; // 1\n}\n\n// 1. Browsers set a default `min-width: min-content;` on fieldsets,\n//    unlike e.g. `<div>`s, which have `min-width: 0;` by default.\n//    So we reset that to ensure fieldsets behave more like a standard block element.\n//    See https://github.com/twbs/bootstrap/issues/12359\n//    and https://html.spec.whatwg.org/multipage/#the-fieldset-and-legend-elements\n// 2. Reset the default outline behavior of fieldsets so they don't affect page layout.\n\nfieldset {\n  min-width: 0; // 1\n  padding: 0; // 2\n  margin: 0; // 2\n  border: 0; // 2\n}\n\n// 1. By using `float: left`, the legend will behave like a block element.\n//    This way the border of a fieldset wraps around the legend if present.\n// 2. Fix wrapping bug.\n//    See https://github.com/twbs/bootstrap/issues/29712\n\nlegend {\n  float: left; // 1\n  width: 100%;\n  padding: 0;\n  margin-bottom: $legend-margin-bottom;\n  @include font-size($legend-font-size);\n  font-weight: $legend-font-weight;\n  line-height: inherit;\n\n  + * {\n    clear: left; // 2\n  }\n}\n\n// Fix height of inputs with a type of datetime-local, date, month, week, or time\n// See https://github.com/twbs/bootstrap/issues/18842\n\n::-webkit-datetime-edit-fields-wrapper,\n::-webkit-datetime-edit-text,\n::-webkit-datetime-edit-minute,\n::-webkit-datetime-edit-hour-field,\n::-webkit-datetime-edit-day-field,\n::-webkit-datetime-edit-month-field,\n::-webkit-datetime-edit-year-field {\n  padding: 0;\n}\n\n::-webkit-inner-spin-button {\n  height: auto;\n}\n\n// 1. Correct the outline style in Safari.\n// 2. This overrides the extra rounded corners on search inputs in iOS so that our\n//    `.form-control` class can properly style them. Note that this cannot simply\n//    be added to `.form-control` as it's not specific enough. For details, see\n//    https://github.com/twbs/bootstrap/issues/11586.\n\n[type=\"search\"] {\n  outline-offset: -2px; // 1\n  -webkit-appearance: textfield; // 2\n}\n\n// 1. A few input types should stay LTR\n// See https://rtlstyling.com/posts/rtl-styling#form-inputs\n// 2. RTL only output\n// See https://rtlcss.com/learn/usage-guide/control-directives/#raw\n\n/* rtl:raw:\n[type=\"tel\"],\n[type=\"url\"],\n[type=\"email\"],\n[type=\"number\"] {\n  direction: ltr;\n}\n*/\n\n// Remove the inner padding in Chrome and Safari on macOS.\n\n::-webkit-search-decoration {\n  -webkit-appearance: none;\n}\n\n// Remove padding around color pickers in webkit browsers\n\n::-webkit-color-swatch-wrapper {\n  padding: 0;\n}\n\n\n// Inherit font family and line height for file input buttons\n\n::file-selector-button {\n  font: inherit;\n}\n\n// 1. Change font properties to `inherit`\n// 2. Correct the inability to style clickable types in iOS and Safari.\n\n::-webkit-file-upload-button {\n  font: inherit; // 1\n  -webkit-appearance: button; // 2\n}\n\n// Correct element displays\n\noutput {\n  display: inline-block;\n}\n\n// Remove border from iframe\n\niframe {\n  border: 0;\n}\n\n// Summary\n//\n// 1. Add the correct display in all browsers\n\nsummary {\n  display: list-item; // 1\n  cursor: pointer;\n}\n\n\n// Progress\n//\n// Add the correct vertical alignment in Chrome, Firefox, and Opera.\n\nprogress {\n  vertical-align: baseline;\n}\n\n\n// Hidden attribute\n//\n// Always hide an element with the `hidden` HTML attribute.\n\n[hidden] {\n  display: none !important;\n}\n","@charset \"UTF-8\";\n/*!\n * Bootstrap v5.1.0 (https://getbootstrap.com/)\n * Copyright 2011-2021 The Bootstrap Authors\n * Copyright 2011-2021 Twitter, Inc.\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n */\n:root {\n  --bs-blue: #0d6efd;\n  --bs-indigo: #6610f2;\n  --bs-purple: #6f42c1;\n  --bs-pink: #d63384;\n  --bs-red: #dc3545;\n  --bs-orange: #fd7e14;\n  --bs-yellow: #ffc107;\n  --bs-green: #198754;\n  --bs-teal: #20c997;\n  --bs-cyan: #0dcaf0;\n  --bs-white: #fff;\n  --bs-gray: #6c757d;\n  --bs-gray-dark: #343a40;\n  --bs-gray-100: #f8f9fa;\n  --bs-gray-200: #e9ecef;\n  --bs-gray-300: #dee2e6;\n  --bs-gray-400: #ced4da;\n  --bs-gray-500: #adb5bd;\n  --bs-gray-600: #6c757d;\n  --bs-gray-700: #495057;\n  --bs-gray-800: #343a40;\n  --bs-gray-900: #212529;\n  --bs-primary: #0d6efd;\n  --bs-secondary: #6c757d;\n  --bs-success: #198754;\n  --bs-info: #0dcaf0;\n  --bs-warning: #ffc107;\n  --bs-danger: #dc3545;\n  --bs-light: #f8f9fa;\n  --bs-dark: #212529;\n  --bs-primary-rgb: 13, 110, 253;\n  --bs-secondary-rgb: 108, 117, 125;\n  --bs-success-rgb: 25, 135, 84;\n  --bs-info-rgb: 13, 202, 240;\n  --bs-warning-rgb: 255, 193, 7;\n  --bs-danger-rgb: 220, 53, 69;\n  --bs-light-rgb: 248, 249, 250;\n  --bs-dark-rgb: 33, 37, 41;\n  --bs-white-rgb: 255, 255, 255;\n  --bs-black-rgb: 0, 0, 0;\n  --bs-body-rgb: 33, 37, 41;\n  --bs-font-sans-serif: system-ui, -apple-system, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, \"Noto Sans\", \"Liberation Sans\", sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\", \"Noto Color Emoji\";\n  --bs-font-monospace: SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\", \"Courier New\", monospace;\n  --bs-gradient: linear-gradient(180deg, rgba(255, 255, 255, 0.15), rgba(255, 255, 255, 0));\n  --bs-body-font-family: var(--bs-font-sans-serif);\n  --bs-body-font-size: 1rem;\n  --bs-body-font-weight: 400;\n  --bs-body-line-height: 1.5;\n  --bs-body-color: #212529;\n  --bs-body-bg: #fff;\n}\n\n*,\n*::before,\n*::after {\n  box-sizing: border-box;\n}\n\n@media (prefers-reduced-motion: no-preference) {\n  :root {\n    scroll-behavior: smooth;\n  }\n}\n\nbody {\n  margin: 0;\n  font-family: var(--bs-body-font-family);\n  font-size: var(--bs-body-font-size);\n  font-weight: var(--bs-body-font-weight);\n  line-height: var(--bs-body-line-height);\n  color: var(--bs-body-color);\n  text-align: var(--bs-body-text-align);\n  background-color: var(--bs-body-bg);\n  -webkit-text-size-adjust: 100%;\n  -webkit-tap-highlight-color: rgba(0, 0, 0, 0);\n}\n\nhr {\n  margin: 1rem 0;\n  color: inherit;\n  background-color: currentColor;\n  border: 0;\n  opacity: 0.25;\n}\n\nhr:not([size]) {\n  height: 1px;\n}\n\nh6, .h6, h5, .h5, h4, .h4, h3, .h3, h2, .h2, h1, .h1 {\n  margin-top: 0;\n  margin-bottom: 0.5rem;\n  font-weight: 500;\n  line-height: 1.2;\n}\n\nh1, .h1 {\n  font-size: calc(1.375rem + 1.5vw);\n}\n@media (min-width: 1200px) {\n  h1, .h1 {\n    font-size: 2.5rem;\n  }\n}\n\nh2, .h2 {\n  font-size: calc(1.325rem + 0.9vw);\n}\n@media (min-width: 1200px) {\n  h2, .h2 {\n    font-size: 2rem;\n  }\n}\n\nh3, .h3 {\n  font-size: calc(1.3rem + 0.6vw);\n}\n@media (min-width: 1200px) {\n  h3, .h3 {\n    font-size: 1.75rem;\n  }\n}\n\nh4, .h4 {\n  font-size: calc(1.275rem + 0.3vw);\n}\n@media (min-width: 1200px) {\n  h4, .h4 {\n    font-size: 1.5rem;\n  }\n}\n\nh5, .h5 {\n  font-size: 1.25rem;\n}\n\nh6, .h6 {\n  font-size: 1rem;\n}\n\np {\n  margin-top: 0;\n  margin-bottom: 1rem;\n}\n\nabbr[title],\nabbr[data-bs-original-title] {\n  -webkit-text-decoration: underline dotted;\n  text-decoration: underline dotted;\n  cursor: help;\n  -webkit-text-decoration-skip-ink: none;\n  text-decoration-skip-ink: none;\n}\n\naddress {\n  margin-bottom: 1rem;\n  font-style: normal;\n  line-height: inherit;\n}\n\nol,\nul {\n  padding-left: 2rem;\n}\n\nol,\nul,\ndl {\n  margin-top: 0;\n  margin-bottom: 1rem;\n}\n\nol ol,\nul ul,\nol ul,\nul ol {\n  margin-bottom: 0;\n}\n\ndt {\n  font-weight: 700;\n}\n\ndd {\n  margin-bottom: 0.5rem;\n  margin-left: 0;\n}\n\nblockquote {\n  margin: 0 0 1rem;\n}\n\nb,\nstrong {\n  font-weight: bolder;\n}\n\nsmall, .small {\n  font-size: 0.875em;\n}\n\nmark, .mark {\n  padding: 0.2em;\n  background-color: #fcf8e3;\n}\n\nsub,\nsup {\n  position: relative;\n  font-size: 0.75em;\n  line-height: 0;\n  vertical-align: baseline;\n}\n\nsub {\n  bottom: -0.25em;\n}\n\nsup {\n  top: -0.5em;\n}\n\na {\n  color: #0d6efd;\n  text-decoration: underline;\n}\na:hover {\n  color: #0a58ca;\n}\n\na:not([href]):not([class]), a:not([href]):not([class]):hover {\n  color: inherit;\n  text-decoration: none;\n}\n\npre,\ncode,\nkbd,\nsamp {\n  font-family: var(--bs-font-monospace);\n  font-size: 1em;\n  direction: ltr /* rtl:ignore */;\n  unicode-bidi: bidi-override;\n}\n\npre {\n  display: block;\n  margin-top: 0;\n  margin-bottom: 1rem;\n  overflow: auto;\n  font-size: 0.875em;\n}\npre code {\n  font-size: inherit;\n  color: inherit;\n  word-break: normal;\n}\n\ncode {\n  font-size: 0.875em;\n  color: #d63384;\n  word-wrap: break-word;\n}\na > code {\n  color: inherit;\n}\n\nkbd {\n  padding: 0.2rem 0.4rem;\n  font-size: 0.875em;\n  color: #fff;\n  background-color: #212529;\n  border-radius: 0.2rem;\n}\nkbd kbd {\n  padding: 0;\n  font-size: 1em;\n  font-weight: 700;\n}\n\nfigure {\n  margin: 0 0 1rem;\n}\n\nimg,\nsvg {\n  vertical-align: middle;\n}\n\ntable {\n  caption-side: bottom;\n  border-collapse: collapse;\n}\n\ncaption {\n  padding-top: 0.5rem;\n  padding-bottom: 0.5rem;\n  color: #6c757d;\n  text-align: left;\n}\n\nth {\n  text-align: inherit;\n  text-align: -webkit-match-parent;\n}\n\nthead,\ntbody,\ntfoot,\ntr,\ntd,\nth {\n  border-color: inherit;\n  border-style: solid;\n  border-width: 0;\n}\n\nlabel {\n  display: inline-block;\n}\n\nbutton {\n  border-radius: 0;\n}\n\nbutton:focus:not(:focus-visible) {\n  outline: 0;\n}\n\ninput,\nbutton,\nselect,\noptgroup,\ntextarea {\n  margin: 0;\n  font-family: inherit;\n  font-size: inherit;\n  line-height: inherit;\n}\n\nbutton,\nselect {\n  text-transform: none;\n}\n\n[role=button] {\n  cursor: pointer;\n}\n\nselect {\n  word-wrap: normal;\n}\nselect:disabled {\n  opacity: 1;\n}\n\n[list]::-webkit-calendar-picker-indicator {\n  display: none;\n}\n\nbutton,\n[type=button],\n[type=reset],\n[type=submit] {\n  -webkit-appearance: button;\n}\nbutton:not(:disabled),\n[type=button]:not(:disabled),\n[type=reset]:not(:disabled),\n[type=submit]:not(:disabled) {\n  cursor: pointer;\n}\n\n::-moz-focus-inner {\n  padding: 0;\n  border-style: none;\n}\n\ntextarea {\n  resize: vertical;\n}\n\nfieldset {\n  min-width: 0;\n  padding: 0;\n  margin: 0;\n  border: 0;\n}\n\nlegend {\n  float: left;\n  width: 100%;\n  padding: 0;\n  margin-bottom: 0.5rem;\n  font-size: calc(1.275rem + 0.3vw);\n  line-height: inherit;\n}\n@media (min-width: 1200px) {\n  legend {\n    font-size: 1.5rem;\n  }\n}\nlegend + * {\n  clear: left;\n}\n\n::-webkit-datetime-edit-fields-wrapper,\n::-webkit-datetime-edit-text,\n::-webkit-datetime-edit-minute,\n::-webkit-datetime-edit-hour-field,\n::-webkit-datetime-edit-day-field,\n::-webkit-datetime-edit-month-field,\n::-webkit-datetime-edit-year-field {\n  padding: 0;\n}\n\n::-webkit-inner-spin-button {\n  height: auto;\n}\n\n[type=search] {\n  outline-offset: -2px;\n  -webkit-appearance: textfield;\n}\n\n/* rtl:raw:\n[type=\"tel\"],\n[type=\"url\"],\n[type=\"email\"],\n[type=\"number\"] {\n  direction: ltr;\n}\n*/\n::-webkit-search-decoration {\n  -webkit-appearance: none;\n}\n\n::-webkit-color-swatch-wrapper {\n  padding: 0;\n}\n\n::file-selector-button {\n  font: inherit;\n}\n\n::-webkit-file-upload-button {\n  font: inherit;\n  -webkit-appearance: button;\n}\n\noutput {\n  display: inline-block;\n}\n\niframe {\n  border: 0;\n}\n\nsummary {\n  display: list-item;\n  cursor: pointer;\n}\n\nprogress {\n  vertical-align: baseline;\n}\n\n[hidden] {\n  display: none !important;\n}\n\n.lead {\n  font-size: 1.25rem;\n  font-weight: 300;\n}\n\n.display-1 {\n  font-size: calc(1.625rem + 4.5vw);\n  font-weight: 300;\n  line-height: 1.2;\n}\n@media (min-width: 1200px) {\n  .display-1 {\n    font-size: 5rem;\n  }\n}\n\n.display-2 {\n  font-size: calc(1.575rem + 3.9vw);\n  font-weight: 300;\n  line-height: 1.2;\n}\n@media (min-width: 1200px) {\n  .display-2 {\n    font-size: 4.5rem;\n  }\n}\n\n.display-3 {\n  font-size: calc(1.525rem + 3.3vw);\n  font-weight: 300;\n  line-height: 1.2;\n}\n@media (min-width: 1200px) {\n  .display-3 {\n    font-size: 4rem;\n  }\n}\n\n.display-4 {\n  font-size: calc(1.475rem + 2.7vw);\n  font-weight: 300;\n  line-height: 1.2;\n}\n@media (min-width: 1200px) {\n  .display-4 {\n    font-size: 3.5rem;\n  }\n}\n\n.display-5 {\n  font-size: calc(1.425rem + 2.1vw);\n  font-weight: 300;\n  line-height: 1.2;\n}\n@media (min-width: 1200px) {\n  .display-5 {\n    font-size: 3rem;\n  }\n}\n\n.display-6 {\n  font-size: calc(1.375rem + 1.5vw);\n  font-weight: 300;\n  line-height: 1.2;\n}\n@media (min-width: 1200px) {\n  .display-6 {\n    font-size: 2.5rem;\n  }\n}\n\n.list-unstyled {\n  padding-left: 0;\n  list-style: none;\n}\n\n.list-inline {\n  padding-left: 0;\n  list-style: none;\n}\n\n.list-inline-item {\n  display: inline-block;\n}\n.list-inline-item:not(:last-child) {\n  margin-right: 0.5rem;\n}\n\n.initialism {\n  font-size: 0.875em;\n  text-transform: uppercase;\n}\n\n.blockquote {\n  margin-bottom: 1rem;\n  font-size: 1.25rem;\n}\n.blockquote > :last-child {\n  margin-bottom: 0;\n}\n\n.blockquote-footer {\n  margin-top: -1rem;\n  margin-bottom: 1rem;\n  font-size: 0.875em;\n  color: #6c757d;\n}\n.blockquote-footer::before {\n  content: \"— \";\n}\n\n.img-fluid {\n  max-width: 100%;\n  height: auto;\n}\n\n.img-thumbnail {\n  padding: 0.25rem;\n  background-color: #fff;\n  border: 1px solid #dee2e6;\n  border-radius: 0.25rem;\n  max-width: 100%;\n  height: auto;\n}\n\n.figure {\n  display: inline-block;\n}\n\n.figure-img {\n  margin-bottom: 0.5rem;\n  line-height: 1;\n}\n\n.figure-caption {\n  font-size: 0.875em;\n  color: #6c757d;\n}\n\n.container,\n.container-fluid,\n.container-xxl,\n.container-xl,\n.container-lg,\n.container-md,\n.container-sm {\n  width: 100%;\n  padding-right: var(--bs-gutter-x, 0.75rem);\n  padding-left: var(--bs-gutter-x, 0.75rem);\n  margin-right: auto;\n  margin-left: auto;\n}\n\n@media (min-width: 576px) {\n  .container-sm, .container {\n    max-width: 540px;\n  }\n}\n@media (min-width: 768px) {\n  .container-md, .container-sm, .container {\n    max-width: 720px;\n  }\n}\n@media (min-width: 992px) {\n  .container-lg, .container-md, .container-sm, .container {\n    max-width: 960px;\n  }\n}\n@media (min-width: 1200px) {\n  .container-xl, .container-lg, .container-md, .container-sm, .container {\n    max-width: 1140px;\n  }\n}\n@media (min-width: 1400px) {\n  .container-xxl, .container-xl, .container-lg, .container-md, .container-sm, .container {\n    max-width: 1320px;\n  }\n}\n.row {\n  --bs-gutter-x: 1.5rem;\n  --bs-gutter-y: 0;\n  display: flex;\n  flex-wrap: wrap;\n  margin-top: calc(var(--bs-gutter-y) * -1);\n  margin-right: calc(var(--bs-gutter-x) * -.5);\n  margin-left: calc(var(--bs-gutter-x) * -.5);\n}\n.row > * {\n  flex-shrink: 0;\n  width: 100%;\n  max-width: 100%;\n  padding-right: calc(var(--bs-gutter-x) * .5);\n  padding-left: calc(var(--bs-gutter-x) * .5);\n  margin-top: var(--bs-gutter-y);\n}\n\n.col {\n  flex: 1 0 0%;\n}\n\n.row-cols-auto > * {\n  flex: 0 0 auto;\n  width: auto;\n}\n\n.row-cols-1 > * {\n  flex: 0 0 auto;\n  width: 100%;\n}\n\n.row-cols-2 > * {\n  flex: 0 0 auto;\n  width: 50%;\n}\n\n.row-cols-3 > * {\n  flex: 0 0 auto;\n  width: 33.3333333333%;\n}\n\n.row-cols-4 > * {\n  flex: 0 0 auto;\n  width: 25%;\n}\n\n.row-cols-5 > * {\n  flex: 0 0 auto;\n  width: 20%;\n}\n\n.row-cols-6 > * {\n  flex: 0 0 auto;\n  width: 16.6666666667%;\n}\n\n.col-auto {\n  flex: 0 0 auto;\n  width: auto;\n}\n\n.col-1 {\n  flex: 0 0 auto;\n  width: 8.33333333%;\n}\n\n.col-2 {\n  flex: 0 0 auto;\n  width: 16.66666667%;\n}\n\n.col-3 {\n  flex: 0 0 auto;\n  width: 25%;\n}\n\n.col-4 {\n  flex: 0 0 auto;\n  width: 33.33333333%;\n}\n\n.col-5 {\n  flex: 0 0 auto;\n  width: 41.66666667%;\n}\n\n.col-6 {\n  flex: 0 0 auto;\n  width: 50%;\n}\n\n.col-7 {\n  flex: 0 0 auto;\n  width: 58.33333333%;\n}\n\n.col-8 {\n  flex: 0 0 auto;\n  width: 66.66666667%;\n}\n\n.col-9 {\n  flex: 0 0 auto;\n  width: 75%;\n}\n\n.col-10 {\n  flex: 0 0 auto;\n  width: 83.33333333%;\n}\n\n.col-11 {\n  flex: 0 0 auto;\n  width: 91.66666667%;\n}\n\n.col-12 {\n  flex: 0 0 auto;\n  width: 100%;\n}\n\n.offset-1 {\n  margin-left: 8.33333333%;\n}\n\n.offset-2 {\n  margin-left: 16.66666667%;\n}\n\n.offset-3 {\n  margin-left: 25%;\n}\n\n.offset-4 {\n  margin-left: 33.33333333%;\n}\n\n.offset-5 {\n  margin-left: 41.66666667%;\n}\n\n.offset-6 {\n  margin-left: 50%;\n}\n\n.offset-7 {\n  margin-left: 58.33333333%;\n}\n\n.offset-8 {\n  margin-left: 66.66666667%;\n}\n\n.offset-9 {\n  margin-left: 75%;\n}\n\n.offset-10 {\n  margin-left: 83.33333333%;\n}\n\n.offset-11 {\n  margin-left: 91.66666667%;\n}\n\n.g-0,\n.gx-0 {\n  --bs-gutter-x: 0;\n}\n\n.g-0,\n.gy-0 {\n  --bs-gutter-y: 0;\n}\n\n.g-1,\n.gx-1 {\n  --bs-gutter-x: 0.25rem;\n}\n\n.g-1,\n.gy-1 {\n  --bs-gutter-y: 0.25rem;\n}\n\n.g-2,\n.gx-2 {\n  --bs-gutter-x: 0.5rem;\n}\n\n.g-2,\n.gy-2 {\n  --bs-gutter-y: 0.5rem;\n}\n\n.g-3,\n.gx-3 {\n  --bs-gutter-x: 1rem;\n}\n\n.g-3,\n.gy-3 {\n  --bs-gutter-y: 1rem;\n}\n\n.g-4,\n.gx-4 {\n  --bs-gutter-x: 1.5rem;\n}\n\n.g-4,\n.gy-4 {\n  --bs-gutter-y: 1.5rem;\n}\n\n.g-5,\n.gx-5 {\n  --bs-gutter-x: 3rem;\n}\n\n.g-5,\n.gy-5 {\n  --bs-gutter-y: 3rem;\n}\n\n@media (min-width: 576px) {\n  .col-sm {\n    flex: 1 0 0%;\n  }\n\n  .row-cols-sm-auto > * {\n    flex: 0 0 auto;\n    width: auto;\n  }\n\n  .row-cols-sm-1 > * {\n    flex: 0 0 auto;\n    width: 100%;\n  }\n\n  .row-cols-sm-2 > * {\n    flex: 0 0 auto;\n    width: 50%;\n  }\n\n  .row-cols-sm-3 > * {\n    flex: 0 0 auto;\n    width: 33.3333333333%;\n  }\n\n  .row-cols-sm-4 > * {\n    flex: 0 0 auto;\n    width: 25%;\n  }\n\n  .row-cols-sm-5 > * {\n    flex: 0 0 auto;\n    width: 20%;\n  }\n\n  .row-cols-sm-6 > * {\n    flex: 0 0 auto;\n    width: 16.6666666667%;\n  }\n\n  .col-sm-auto {\n    flex: 0 0 auto;\n    width: auto;\n  }\n\n  .col-sm-1 {\n    flex: 0 0 auto;\n    width: 8.33333333%;\n  }\n\n  .col-sm-2 {\n    flex: 0 0 auto;\n    width: 16.66666667%;\n  }\n\n  .col-sm-3 {\n    flex: 0 0 auto;\n    width: 25%;\n  }\n\n  .col-sm-4 {\n    flex: 0 0 auto;\n    width: 33.33333333%;\n  }\n\n  .col-sm-5 {\n    flex: 0 0 auto;\n    width: 41.66666667%;\n  }\n\n  .col-sm-6 {\n    flex: 0 0 auto;\n    width: 50%;\n  }\n\n  .col-sm-7 {\n    flex: 0 0 auto;\n    width: 58.33333333%;\n  }\n\n  .col-sm-8 {\n    flex: 0 0 auto;\n    width: 66.66666667%;\n  }\n\n  .col-sm-9 {\n    flex: 0 0 auto;\n    width: 75%;\n  }\n\n  .col-sm-10 {\n    flex: 0 0 auto;\n    width: 83.33333333%;\n  }\n\n  .col-sm-11 {\n    flex: 0 0 auto;\n    width: 91.66666667%;\n  }\n\n  .col-sm-12 {\n    flex: 0 0 auto;\n    width: 100%;\n  }\n\n  .offset-sm-0 {\n    margin-left: 0;\n  }\n\n  .offset-sm-1 {\n    margin-left: 8.33333333%;\n  }\n\n  .offset-sm-2 {\n    margin-left: 16.66666667%;\n  }\n\n  .offset-sm-3 {\n    margin-left: 25%;\n  }\n\n  .offset-sm-4 {\n    margin-left: 33.33333333%;\n  }\n\n  .offset-sm-5 {\n    margin-left: 41.66666667%;\n  }\n\n  .offset-sm-6 {\n    margin-left: 50%;\n  }\n\n  .offset-sm-7 {\n    margin-left: 58.33333333%;\n  }\n\n  .offset-sm-8 {\n    margin-left: 66.66666667%;\n  }\n\n  .offset-sm-9 {\n    margin-left: 75%;\n  }\n\n  .offset-sm-10 {\n    margin-left: 83.33333333%;\n  }\n\n  .offset-sm-11 {\n    margin-left: 91.66666667%;\n  }\n\n  .g-sm-0,\n.gx-sm-0 {\n    --bs-gutter-x: 0;\n  }\n\n  .g-sm-0,\n.gy-sm-0 {\n    --bs-gutter-y: 0;\n  }\n\n  .g-sm-1,\n.gx-sm-1 {\n    --bs-gutter-x: 0.25rem;\n  }\n\n  .g-sm-1,\n.gy-sm-1 {\n    --bs-gutter-y: 0.25rem;\n  }\n\n  .g-sm-2,\n.gx-sm-2 {\n    --bs-gutter-x: 0.5rem;\n  }\n\n  .g-sm-2,\n.gy-sm-2 {\n    --bs-gutter-y: 0.5rem;\n  }\n\n  .g-sm-3,\n.gx-sm-3 {\n    --bs-gutter-x: 1rem;\n  }\n\n  .g-sm-3,\n.gy-sm-3 {\n    --bs-gutter-y: 1rem;\n  }\n\n  .g-sm-4,\n.gx-sm-4 {\n    --bs-gutter-x: 1.5rem;\n  }\n\n  .g-sm-4,\n.gy-sm-4 {\n    --bs-gutter-y: 1.5rem;\n  }\n\n  .g-sm-5,\n.gx-sm-5 {\n    --bs-gutter-x: 3rem;\n  }\n\n  .g-sm-5,\n.gy-sm-5 {\n    --bs-gutter-y: 3rem;\n  }\n}\n@media (min-width: 768px) {\n  .col-md {\n    flex: 1 0 0%;\n  }\n\n  .row-cols-md-auto > * {\n    flex: 0 0 auto;\n    width: auto;\n  }\n\n  .row-cols-md-1 > * {\n    flex: 0 0 auto;\n    width: 100%;\n  }\n\n  .row-cols-md-2 > * {\n    flex: 0 0 auto;\n    width: 50%;\n  }\n\n  .row-cols-md-3 > * {\n    flex: 0 0 auto;\n    width: 33.3333333333%;\n  }\n\n  .row-cols-md-4 > * {\n    flex: 0 0 auto;\n    width: 25%;\n  }\n\n  .row-cols-md-5 > * {\n    flex: 0 0 auto;\n    width: 20%;\n  }\n\n  .row-cols-md-6 > * {\n    flex: 0 0 auto;\n    width: 16.6666666667%;\n  }\n\n  .col-md-auto {\n    flex: 0 0 auto;\n    width: auto;\n  }\n\n  .col-md-1 {\n    flex: 0 0 auto;\n    width: 8.33333333%;\n  }\n\n  .col-md-2 {\n    flex: 0 0 auto;\n    width: 16.66666667%;\n  }\n\n  .col-md-3 {\n    flex: 0 0 auto;\n    width: 25%;\n  }\n\n  .col-md-4 {\n    flex: 0 0 auto;\n    width: 33.33333333%;\n  }\n\n  .col-md-5 {\n    flex: 0 0 auto;\n    width: 41.66666667%;\n  }\n\n  .col-md-6 {\n    flex: 0 0 auto;\n    width: 50%;\n  }\n\n  .col-md-7 {\n    flex: 0 0 auto;\n    width: 58.33333333%;\n  }\n\n  .col-md-8 {\n    flex: 0 0 auto;\n    width: 66.66666667%;\n  }\n\n  .col-md-9 {\n    flex: 0 0 auto;\n    width: 75%;\n  }\n\n  .col-md-10 {\n    flex: 0 0 auto;\n    width: 83.33333333%;\n  }\n\n  .col-md-11 {\n    flex: 0 0 auto;\n    width: 91.66666667%;\n  }\n\n  .col-md-12 {\n    flex: 0 0 auto;\n    width: 100%;\n  }\n\n  .offset-md-0 {\n    margin-left: 0;\n  }\n\n  .offset-md-1 {\n    margin-left: 8.33333333%;\n  }\n\n  .offset-md-2 {\n    margin-left: 16.66666667%;\n  }\n\n  .offset-md-3 {\n    margin-left: 25%;\n  }\n\n  .offset-md-4 {\n    margin-left: 33.33333333%;\n  }\n\n  .offset-md-5 {\n    margin-left: 41.66666667%;\n  }\n\n  .offset-md-6 {\n    margin-left: 50%;\n  }\n\n  .offset-md-7 {\n    margin-left: 58.33333333%;\n  }\n\n  .offset-md-8 {\n    margin-left: 66.66666667%;\n  }\n\n  .offset-md-9 {\n    margin-left: 75%;\n  }\n\n  .offset-md-10 {\n    margin-left: 83.33333333%;\n  }\n\n  .offset-md-11 {\n    margin-left: 91.66666667%;\n  }\n\n  .g-md-0,\n.gx-md-0 {\n    --bs-gutter-x: 0;\n  }\n\n  .g-md-0,\n.gy-md-0 {\n    --bs-gutter-y: 0;\n  }\n\n  .g-md-1,\n.gx-md-1 {\n    --bs-gutter-x: 0.25rem;\n  }\n\n  .g-md-1,\n.gy-md-1 {\n    --bs-gutter-y: 0.25rem;\n  }\n\n  .g-md-2,\n.gx-md-2 {\n    --bs-gutter-x: 0.5rem;\n  }\n\n  .g-md-2,\n.gy-md-2 {\n    --bs-gutter-y: 0.5rem;\n  }\n\n  .g-md-3,\n.gx-md-3 {\n    --bs-gutter-x: 1rem;\n  }\n\n  .g-md-3,\n.gy-md-3 {\n    --bs-gutter-y: 1rem;\n  }\n\n  .g-md-4,\n.gx-md-4 {\n    --bs-gutter-x: 1.5rem;\n  }\n\n  .g-md-4,\n.gy-md-4 {\n    --bs-gutter-y: 1.5rem;\n  }\n\n  .g-md-5,\n.gx-md-5 {\n    --bs-gutter-x: 3rem;\n  }\n\n  .g-md-5,\n.gy-md-5 {\n    --bs-gutter-y: 3rem;\n  }\n}\n@media (min-width: 992px) {\n  .col-lg {\n    flex: 1 0 0%;\n  }\n\n  .row-cols-lg-auto > * {\n    flex: 0 0 auto;\n    width: auto;\n  }\n\n  .row-cols-lg-1 > * {\n    flex: 0 0 auto;\n    width: 100%;\n  }\n\n  .row-cols-lg-2 > * {\n    flex: 0 0 auto;\n    width: 50%;\n  }\n\n  .row-cols-lg-3 > * {\n    flex: 0 0 auto;\n    width: 33.3333333333%;\n  }\n\n  .row-cols-lg-4 > * {\n    flex: 0 0 auto;\n    width: 25%;\n  }\n\n  .row-cols-lg-5 > * {\n    flex: 0 0 auto;\n    width: 20%;\n  }\n\n  .row-cols-lg-6 > * {\n    flex: 0 0 auto;\n    width: 16.6666666667%;\n  }\n\n  .col-lg-auto {\n    flex: 0 0 auto;\n    width: auto;\n  }\n\n  .col-lg-1 {\n    flex: 0 0 auto;\n    width: 8.33333333%;\n  }\n\n  .col-lg-2 {\n    flex: 0 0 auto;\n    width: 16.66666667%;\n  }\n\n  .col-lg-3 {\n    flex: 0 0 auto;\n    width: 25%;\n  }\n\n  .col-lg-4 {\n    flex: 0 0 auto;\n    width: 33.33333333%;\n  }\n\n  .col-lg-5 {\n    flex: 0 0 auto;\n    width: 41.66666667%;\n  }\n\n  .col-lg-6 {\n    flex: 0 0 auto;\n    width: 50%;\n  }\n\n  .col-lg-7 {\n    flex: 0 0 auto;\n    width: 58.33333333%;\n  }\n\n  .col-lg-8 {\n    flex: 0 0 auto;\n    width: 66.66666667%;\n  }\n\n  .col-lg-9 {\n    flex: 0 0 auto;\n    width: 75%;\n  }\n\n  .col-lg-10 {\n    flex: 0 0 auto;\n    width: 83.33333333%;\n  }\n\n  .col-lg-11 {\n    flex: 0 0 auto;\n    width: 91.66666667%;\n  }\n\n  .col-lg-12 {\n    flex: 0 0 auto;\n    width: 100%;\n  }\n\n  .offset-lg-0 {\n    margin-left: 0;\n  }\n\n  .offset-lg-1 {\n    margin-left: 8.33333333%;\n  }\n\n  .offset-lg-2 {\n    margin-left: 16.66666667%;\n  }\n\n  .offset-lg-3 {\n    margin-left: 25%;\n  }\n\n  .offset-lg-4 {\n    margin-left: 33.33333333%;\n  }\n\n  .offset-lg-5 {\n    margin-left: 41.66666667%;\n  }\n\n  .offset-lg-6 {\n    margin-left: 50%;\n  }\n\n  .offset-lg-7 {\n    margin-left: 58.33333333%;\n  }\n\n  .offset-lg-8 {\n    margin-left: 66.66666667%;\n  }\n\n  .offset-lg-9 {\n    margin-left: 75%;\n  }\n\n  .offset-lg-10 {\n    margin-left: 83.33333333%;\n  }\n\n  .offset-lg-11 {\n    margin-left: 91.66666667%;\n  }\n\n  .g-lg-0,\n.gx-lg-0 {\n    --bs-gutter-x: 0;\n  }\n\n  .g-lg-0,\n.gy-lg-0 {\n    --bs-gutter-y: 0;\n  }\n\n  .g-lg-1,\n.gx-lg-1 {\n    --bs-gutter-x: 0.25rem;\n  }\n\n  .g-lg-1,\n.gy-lg-1 {\n    --bs-gutter-y: 0.25rem;\n  }\n\n  .g-lg-2,\n.gx-lg-2 {\n    --bs-gutter-x: 0.5rem;\n  }\n\n  .g-lg-2,\n.gy-lg-2 {\n    --bs-gutter-y: 0.5rem;\n  }\n\n  .g-lg-3,\n.gx-lg-3 {\n    --bs-gutter-x: 1rem;\n  }\n\n  .g-lg-3,\n.gy-lg-3 {\n    --bs-gutter-y: 1rem;\n  }\n\n  .g-lg-4,\n.gx-lg-4 {\n    --bs-gutter-x: 1.5rem;\n  }\n\n  .g-lg-4,\n.gy-lg-4 {\n    --bs-gutter-y: 1.5rem;\n  }\n\n  .g-lg-5,\n.gx-lg-5 {\n    --bs-gutter-x: 3rem;\n  }\n\n  .g-lg-5,\n.gy-lg-5 {\n    --bs-gutter-y: 3rem;\n  }\n}\n@media (min-width: 1200px) {\n  .col-xl {\n    flex: 1 0 0%;\n  }\n\n  .row-cols-xl-auto > * {\n    flex: 0 0 auto;\n    width: auto;\n  }\n\n  .row-cols-xl-1 > * {\n    flex: 0 0 auto;\n    width: 100%;\n  }\n\n  .row-cols-xl-2 > * {\n    flex: 0 0 auto;\n    width: 50%;\n  }\n\n  .row-cols-xl-3 > * {\n    flex: 0 0 auto;\n    width: 33.3333333333%;\n  }\n\n  .row-cols-xl-4 > * {\n    flex: 0 0 auto;\n    width: 25%;\n  }\n\n  .row-cols-xl-5 > * {\n    flex: 0 0 auto;\n    width: 20%;\n  }\n\n  .row-cols-xl-6 > * {\n    flex: 0 0 auto;\n    width: 16.6666666667%;\n  }\n\n  .col-xl-auto {\n    flex: 0 0 auto;\n    width: auto;\n  }\n\n  .col-xl-1 {\n    flex: 0 0 auto;\n    width: 8.33333333%;\n  }\n\n  .col-xl-2 {\n    flex: 0 0 auto;\n    width: 16.66666667%;\n  }\n\n  .col-xl-3 {\n    flex: 0 0 auto;\n    width: 25%;\n  }\n\n  .col-xl-4 {\n    flex: 0 0 auto;\n    width: 33.33333333%;\n  }\n\n  .col-xl-5 {\n    flex: 0 0 auto;\n    width: 41.66666667%;\n  }\n\n  .col-xl-6 {\n    flex: 0 0 auto;\n    width: 50%;\n  }\n\n  .col-xl-7 {\n    flex: 0 0 auto;\n    width: 58.33333333%;\n  }\n\n  .col-xl-8 {\n    flex: 0 0 auto;\n    width: 66.66666667%;\n  }\n\n  .col-xl-9 {\n    flex: 0 0 auto;\n    width: 75%;\n  }\n\n  .col-xl-10 {\n    flex: 0 0 auto;\n    width: 83.33333333%;\n  }\n\n  .col-xl-11 {\n    flex: 0 0 auto;\n    width: 91.66666667%;\n  }\n\n  .col-xl-12 {\n    flex: 0 0 auto;\n    width: 100%;\n  }\n\n  .offset-xl-0 {\n    margin-left: 0;\n  }\n\n  .offset-xl-1 {\n    margin-left: 8.33333333%;\n  }\n\n  .offset-xl-2 {\n    margin-left: 16.66666667%;\n  }\n\n  .offset-xl-3 {\n    margin-left: 25%;\n  }\n\n  .offset-xl-4 {\n    margin-left: 33.33333333%;\n  }\n\n  .offset-xl-5 {\n    margin-left: 41.66666667%;\n  }\n\n  .offset-xl-6 {\n    margin-left: 50%;\n  }\n\n  .offset-xl-7 {\n    margin-left: 58.33333333%;\n  }\n\n  .offset-xl-8 {\n    margin-left: 66.66666667%;\n  }\n\n  .offset-xl-9 {\n    margin-left: 75%;\n  }\n\n  .offset-xl-10 {\n    margin-left: 83.33333333%;\n  }\n\n  .offset-xl-11 {\n    margin-left: 91.66666667%;\n  }\n\n  .g-xl-0,\n.gx-xl-0 {\n    --bs-gutter-x: 0;\n  }\n\n  .g-xl-0,\n.gy-xl-0 {\n    --bs-gutter-y: 0;\n  }\n\n  .g-xl-1,\n.gx-xl-1 {\n    --bs-gutter-x: 0.25rem;\n  }\n\n  .g-xl-1,\n.gy-xl-1 {\n    --bs-gutter-y: 0.25rem;\n  }\n\n  .g-xl-2,\n.gx-xl-2 {\n    --bs-gutter-x: 0.5rem;\n  }\n\n  .g-xl-2,\n.gy-xl-2 {\n    --bs-gutter-y: 0.5rem;\n  }\n\n  .g-xl-3,\n.gx-xl-3 {\n    --bs-gutter-x: 1rem;\n  }\n\n  .g-xl-3,\n.gy-xl-3 {\n    --bs-gutter-y: 1rem;\n  }\n\n  .g-xl-4,\n.gx-xl-4 {\n    --bs-gutter-x: 1.5rem;\n  }\n\n  .g-xl-4,\n.gy-xl-4 {\n    --bs-gutter-y: 1.5rem;\n  }\n\n  .g-xl-5,\n.gx-xl-5 {\n    --bs-gutter-x: 3rem;\n  }\n\n  .g-xl-5,\n.gy-xl-5 {\n    --bs-gutter-y: 3rem;\n  }\n}\n@media (min-width: 1400px) {\n  .col-xxl {\n    flex: 1 0 0%;\n  }\n\n  .row-cols-xxl-auto > * {\n    flex: 0 0 auto;\n    width: auto;\n  }\n\n  .row-cols-xxl-1 > * {\n    flex: 0 0 auto;\n    width: 100%;\n  }\n\n  .row-cols-xxl-2 > * {\n    flex: 0 0 auto;\n    width: 50%;\n  }\n\n  .row-cols-xxl-3 > * {\n    flex: 0 0 auto;\n    width: 33.3333333333%;\n  }\n\n  .row-cols-xxl-4 > * {\n    flex: 0 0 auto;\n    width: 25%;\n  }\n\n  .row-cols-xxl-5 > * {\n    flex: 0 0 auto;\n    width: 20%;\n  }\n\n  .row-cols-xxl-6 > * {\n    flex: 0 0 auto;\n    width: 16.6666666667%;\n  }\n\n  .col-xxl-auto {\n    flex: 0 0 auto;\n    width: auto;\n  }\n\n  .col-xxl-1 {\n    flex: 0 0 auto;\n    width: 8.33333333%;\n  }\n\n  .col-xxl-2 {\n    flex: 0 0 auto;\n    width: 16.66666667%;\n  }\n\n  .col-xxl-3 {\n    flex: 0 0 auto;\n    width: 25%;\n  }\n\n  .col-xxl-4 {\n    flex: 0 0 auto;\n    width: 33.33333333%;\n  }\n\n  .col-xxl-5 {\n    flex: 0 0 auto;\n    width: 41.66666667%;\n  }\n\n  .col-xxl-6 {\n    flex: 0 0 auto;\n    width: 50%;\n  }\n\n  .col-xxl-7 {\n    flex: 0 0 auto;\n    width: 58.33333333%;\n  }\n\n  .col-xxl-8 {\n    flex: 0 0 auto;\n    width: 66.66666667%;\n  }\n\n  .col-xxl-9 {\n    flex: 0 0 auto;\n    width: 75%;\n  }\n\n  .col-xxl-10 {\n    flex: 0 0 auto;\n    width: 83.33333333%;\n  }\n\n  .col-xxl-11 {\n    flex: 0 0 auto;\n    width: 91.66666667%;\n  }\n\n  .col-xxl-12 {\n    flex: 0 0 auto;\n    width: 100%;\n  }\n\n  .offset-xxl-0 {\n    margin-left: 0;\n  }\n\n  .offset-xxl-1 {\n    margin-left: 8.33333333%;\n  }\n\n  .offset-xxl-2 {\n    margin-left: 16.66666667%;\n  }\n\n  .offset-xxl-3 {\n    margin-left: 25%;\n  }\n\n  .offset-xxl-4 {\n    margin-left: 33.33333333%;\n  }\n\n  .offset-xxl-5 {\n    margin-left: 41.66666667%;\n  }\n\n  .offset-xxl-6 {\n    margin-left: 50%;\n  }\n\n  .offset-xxl-7 {\n    margin-left: 58.33333333%;\n  }\n\n  .offset-xxl-8 {\n    margin-left: 66.66666667%;\n  }\n\n  .offset-xxl-9 {\n    margin-left: 75%;\n  }\n\n  .offset-xxl-10 {\n    margin-left: 83.33333333%;\n  }\n\n  .offset-xxl-11 {\n    margin-left: 91.66666667%;\n  }\n\n  .g-xxl-0,\n.gx-xxl-0 {\n    --bs-gutter-x: 0;\n  }\n\n  .g-xxl-0,\n.gy-xxl-0 {\n    --bs-gutter-y: 0;\n  }\n\n  .g-xxl-1,\n.gx-xxl-1 {\n    --bs-gutter-x: 0.25rem;\n  }\n\n  .g-xxl-1,\n.gy-xxl-1 {\n    --bs-gutter-y: 0.25rem;\n  }\n\n  .g-xxl-2,\n.gx-xxl-2 {\n    --bs-gutter-x: 0.5rem;\n  }\n\n  .g-xxl-2,\n.gy-xxl-2 {\n    --bs-gutter-y: 0.5rem;\n  }\n\n  .g-xxl-3,\n.gx-xxl-3 {\n    --bs-gutter-x: 1rem;\n  }\n\n  .g-xxl-3,\n.gy-xxl-3 {\n    --bs-gutter-y: 1rem;\n  }\n\n  .g-xxl-4,\n.gx-xxl-4 {\n    --bs-gutter-x: 1.5rem;\n  }\n\n  .g-xxl-4,\n.gy-xxl-4 {\n    --bs-gutter-y: 1.5rem;\n  }\n\n  .g-xxl-5,\n.gx-xxl-5 {\n    --bs-gutter-x: 3rem;\n  }\n\n  .g-xxl-5,\n.gy-xxl-5 {\n    --bs-gutter-y: 3rem;\n  }\n}\n.table {\n  --bs-table-bg: transparent;\n  --bs-table-accent-bg: transparent;\n  --bs-table-striped-color: #212529;\n  --bs-table-striped-bg: rgba(0, 0, 0, 0.05);\n  --bs-table-active-color: #212529;\n  --bs-table-active-bg: rgba(0, 0, 0, 0.1);\n  --bs-table-hover-color: #212529;\n  --bs-table-hover-bg: rgba(0, 0, 0, 0.075);\n  width: 100%;\n  margin-bottom: 1rem;\n  color: #212529;\n  vertical-align: top;\n  border-color: #dee2e6;\n}\n.table > :not(caption) > * > * {\n  padding: 0.5rem 0.5rem;\n  background-color: var(--bs-table-bg);\n  border-bottom-width: 1px;\n  box-shadow: inset 0 0 0 9999px var(--bs-table-accent-bg);\n}\n.table > tbody {\n  vertical-align: inherit;\n}\n.table > thead {\n  vertical-align: bottom;\n}\n.table > :not(:last-child) > :last-child > * {\n  border-bottom-color: currentColor;\n}\n\n.caption-top {\n  caption-side: top;\n}\n\n.table-sm > :not(caption) > * > * {\n  padding: 0.25rem 0.25rem;\n}\n\n.table-bordered > :not(caption) > * {\n  border-width: 1px 0;\n}\n.table-bordered > :not(caption) > * > * {\n  border-width: 0 1px;\n}\n\n.table-borderless > :not(caption) > * > * {\n  border-bottom-width: 0;\n}\n\n.table-striped > tbody > tr:nth-of-type(odd) {\n  --bs-table-accent-bg: var(--bs-table-striped-bg);\n  color: var(--bs-table-striped-color);\n}\n\n.table-active {\n  --bs-table-accent-bg: var(--bs-table-active-bg);\n  color: var(--bs-table-active-color);\n}\n\n.table-hover > tbody > tr:hover {\n  --bs-table-accent-bg: var(--bs-table-hover-bg);\n  color: var(--bs-table-hover-color);\n}\n\n.table-primary {\n  --bs-table-bg: #cfe2ff;\n  --bs-table-striped-bg: #c5d7f2;\n  --bs-table-striped-color: #000;\n  --bs-table-active-bg: #bacbe6;\n  --bs-table-active-color: #000;\n  --bs-table-hover-bg: #bfd1ec;\n  --bs-table-hover-color: #000;\n  color: #000;\n  border-color: #bacbe6;\n}\n\n.table-secondary {\n  --bs-table-bg: #e2e3e5;\n  --bs-table-striped-bg: #d7d8da;\n  --bs-table-striped-color: #000;\n  --bs-table-active-bg: #cbccce;\n  --bs-table-active-color: #000;\n  --bs-table-hover-bg: #d1d2d4;\n  --bs-table-hover-color: #000;\n  color: #000;\n  border-color: #cbccce;\n}\n\n.table-success {\n  --bs-table-bg: #d1e7dd;\n  --bs-table-striped-bg: #c7dbd2;\n  --bs-table-striped-color: #000;\n  --bs-table-active-bg: #bcd0c7;\n  --bs-table-active-color: #000;\n  --bs-table-hover-bg: #c1d6cc;\n  --bs-table-hover-color: #000;\n  color: #000;\n  border-color: #bcd0c7;\n}\n\n.table-info {\n  --bs-table-bg: #cff4fc;\n  --bs-table-striped-bg: #c5e8ef;\n  --bs-table-striped-color: #000;\n  --bs-table-active-bg: #badce3;\n  --bs-table-active-color: #000;\n  --bs-table-hover-bg: #bfe2e9;\n  --bs-table-hover-color: #000;\n  color: #000;\n  border-color: #badce3;\n}\n\n.table-warning {\n  --bs-table-bg: #fff3cd;\n  --bs-table-striped-bg: #f2e7c3;\n  --bs-table-striped-color: #000;\n  --bs-table-active-bg: #e6dbb9;\n  --bs-table-active-color: #000;\n  --bs-table-hover-bg: #ece1be;\n  --bs-table-hover-color: #000;\n  color: #000;\n  border-color: #e6dbb9;\n}\n\n.table-danger {\n  --bs-table-bg: #f8d7da;\n  --bs-table-striped-bg: #eccccf;\n  --bs-table-striped-color: #000;\n  --bs-table-active-bg: #dfc2c4;\n  --bs-table-active-color: #000;\n  --bs-table-hover-bg: #e5c7ca;\n  --bs-table-hover-color: #000;\n  color: #000;\n  border-color: #dfc2c4;\n}\n\n.table-light {\n  --bs-table-bg: #f8f9fa;\n  --bs-table-striped-bg: #ecedee;\n  --bs-table-striped-color: #000;\n  --bs-table-active-bg: #dfe0e1;\n  --bs-table-active-color: #000;\n  --bs-table-hover-bg: #e5e6e7;\n  --bs-table-hover-color: #000;\n  color: #000;\n  border-color: #dfe0e1;\n}\n\n.table-dark {\n  --bs-table-bg: #212529;\n  --bs-table-striped-bg: #2c3034;\n  --bs-table-striped-color: #fff;\n  --bs-table-active-bg: #373b3e;\n  --bs-table-active-color: #fff;\n  --bs-table-hover-bg: #323539;\n  --bs-table-hover-color: #fff;\n  color: #fff;\n  border-color: #373b3e;\n}\n\n.table-responsive {\n  overflow-x: auto;\n  -webkit-overflow-scrolling: touch;\n}\n\n@media (max-width: 575.98px) {\n  .table-responsive-sm {\n    overflow-x: auto;\n    -webkit-overflow-scrolling: touch;\n  }\n}\n@media (max-width: 767.98px) {\n  .table-responsive-md {\n    overflow-x: auto;\n    -webkit-overflow-scrolling: touch;\n  }\n}\n@media (max-width: 991.98px) {\n  .table-responsive-lg {\n    overflow-x: auto;\n    -webkit-overflow-scrolling: touch;\n  }\n}\n@media (max-width: 1199.98px) {\n  .table-responsive-xl {\n    overflow-x: auto;\n    -webkit-overflow-scrolling: touch;\n  }\n}\n@media (max-width: 1399.98px) {\n  .table-responsive-xxl {\n    overflow-x: auto;\n    -webkit-overflow-scrolling: touch;\n  }\n}\n.form-label {\n  margin-bottom: 0.5rem;\n}\n\n.col-form-label {\n  padding-top: calc(0.375rem + 1px);\n  padding-bottom: calc(0.375rem + 1px);\n  margin-bottom: 0;\n  font-size: inherit;\n  line-height: 1.5;\n}\n\n.col-form-label-lg {\n  padding-top: calc(0.5rem + 1px);\n  padding-bottom: calc(0.5rem + 1px);\n  font-size: 1.25rem;\n}\n\n.col-form-label-sm {\n  padding-top: calc(0.25rem + 1px);\n  padding-bottom: calc(0.25rem + 1px);\n  font-size: 0.875rem;\n}\n\n.form-text {\n  margin-top: 0.25rem;\n  font-size: 0.875em;\n  color: #6c757d;\n}\n\n.form-control {\n  display: block;\n  width: 100%;\n  padding: 0.375rem 0.75rem;\n  font-size: 1rem;\n  font-weight: 400;\n  line-height: 1.5;\n  color: #212529;\n  background-color: #fff;\n  background-clip: padding-box;\n  border: 1px solid #ced4da;\n  -webkit-appearance: none;\n  -moz-appearance: none;\n  appearance: none;\n  border-radius: 0.25rem;\n  transition: border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n}\n@media (prefers-reduced-motion: reduce) {\n  .form-control {\n    transition: none;\n  }\n}\n.form-control[type=file] {\n  overflow: hidden;\n}\n.form-control[type=file]:not(:disabled):not([readonly]) {\n  cursor: pointer;\n}\n.form-control:focus {\n  color: #212529;\n  background-color: #fff;\n  border-color: #86b7fe;\n  outline: 0;\n  box-shadow: 0 0 0 0.25rem rgba(13, 110, 253, 0.25);\n}\n.form-control::-webkit-date-and-time-value {\n  height: 1.5em;\n}\n.form-control::-moz-placeholder {\n  color: #6c757d;\n  opacity: 1;\n}\n.form-control::placeholder {\n  color: #6c757d;\n  opacity: 1;\n}\n.form-control:disabled, .form-control[readonly] {\n  background-color: #e9ecef;\n  opacity: 1;\n}\n.form-control::file-selector-button {\n  padding: 0.375rem 0.75rem;\n  margin: -0.375rem -0.75rem;\n  -webkit-margin-end: 0.75rem;\n  margin-inline-end: 0.75rem;\n  color: #212529;\n  background-color: #e9ecef;\n  pointer-events: none;\n  border-color: inherit;\n  border-style: solid;\n  border-width: 0;\n  border-inline-end-width: 1px;\n  border-radius: 0;\n  transition: color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n}\n@media (prefers-reduced-motion: reduce) {\n  .form-control::file-selector-button {\n    transition: none;\n  }\n}\n.form-control:hover:not(:disabled):not([readonly])::file-selector-button {\n  background-color: #dde0e3;\n}\n.form-control::-webkit-file-upload-button {\n  padding: 0.375rem 0.75rem;\n  margin: -0.375rem -0.75rem;\n  -webkit-margin-end: 0.75rem;\n  margin-inline-end: 0.75rem;\n  color: #212529;\n  background-color: #e9ecef;\n  pointer-events: none;\n  border-color: inherit;\n  border-style: solid;\n  border-width: 0;\n  border-inline-end-width: 1px;\n  border-radius: 0;\n  -webkit-transition: color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n  transition: color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n}\n@media (prefers-reduced-motion: reduce) {\n  .form-control::-webkit-file-upload-button {\n    -webkit-transition: none;\n    transition: none;\n  }\n}\n.form-control:hover:not(:disabled):not([readonly])::-webkit-file-upload-button {\n  background-color: #dde0e3;\n}\n\n.form-control-plaintext {\n  display: block;\n  width: 100%;\n  padding: 0.375rem 0;\n  margin-bottom: 0;\n  line-height: 1.5;\n  color: #212529;\n  background-color: transparent;\n  border: solid transparent;\n  border-width: 1px 0;\n}\n.form-control-plaintext.form-control-sm, .form-control-plaintext.form-control-lg {\n  padding-right: 0;\n  padding-left: 0;\n}\n\n.form-control-sm {\n  min-height: calc(1.5em + 0.5rem + 2px);\n  padding: 0.25rem 0.5rem;\n  font-size: 0.875rem;\n  border-radius: 0.2rem;\n}\n.form-control-sm::file-selector-button {\n  padding: 0.25rem 0.5rem;\n  margin: -0.25rem -0.5rem;\n  -webkit-margin-end: 0.5rem;\n  margin-inline-end: 0.5rem;\n}\n.form-control-sm::-webkit-file-upload-button {\n  padding: 0.25rem 0.5rem;\n  margin: -0.25rem -0.5rem;\n  -webkit-margin-end: 0.5rem;\n  margin-inline-end: 0.5rem;\n}\n\n.form-control-lg {\n  min-height: calc(1.5em + 1rem + 2px);\n  padding: 0.5rem 1rem;\n  font-size: 1.25rem;\n  border-radius: 0.3rem;\n}\n.form-control-lg::file-selector-button {\n  padding: 0.5rem 1rem;\n  margin: -0.5rem -1rem;\n  -webkit-margin-end: 1rem;\n  margin-inline-end: 1rem;\n}\n.form-control-lg::-webkit-file-upload-button {\n  padding: 0.5rem 1rem;\n  margin: -0.5rem -1rem;\n  -webkit-margin-end: 1rem;\n  margin-inline-end: 1rem;\n}\n\ntextarea.form-control {\n  min-height: calc(1.5em + 0.75rem + 2px);\n}\ntextarea.form-control-sm {\n  min-height: calc(1.5em + 0.5rem + 2px);\n}\ntextarea.form-control-lg {\n  min-height: calc(1.5em + 1rem + 2px);\n}\n\n.form-control-color {\n  width: 3rem;\n  height: auto;\n  padding: 0.375rem;\n}\n.form-control-color:not(:disabled):not([readonly]) {\n  cursor: pointer;\n}\n.form-control-color::-moz-color-swatch {\n  height: 1.5em;\n  border-radius: 0.25rem;\n}\n.form-control-color::-webkit-color-swatch {\n  height: 1.5em;\n  border-radius: 0.25rem;\n}\n\n.form-select {\n  display: block;\n  width: 100%;\n  padding: 0.375rem 2.25rem 0.375rem 0.75rem;\n  -moz-padding-start: calc(0.75rem - 3px);\n  font-size: 1rem;\n  font-weight: 400;\n  line-height: 1.5;\n  color: #212529;\n  background-color: #fff;\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3e%3cpath fill='none' stroke='%23343a40' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M2 5l6 6 6-6'/%3e%3c/svg%3e\");\n  background-repeat: no-repeat;\n  background-position: right 0.75rem center;\n  background-size: 16px 12px;\n  border: 1px solid #ced4da;\n  border-radius: 0.25rem;\n  transition: border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n  -webkit-appearance: none;\n  -moz-appearance: none;\n  appearance: none;\n}\n@media (prefers-reduced-motion: reduce) {\n  .form-select {\n    transition: none;\n  }\n}\n.form-select:focus {\n  border-color: #86b7fe;\n  outline: 0;\n  box-shadow: 0 0 0 0.25rem rgba(13, 110, 253, 0.25);\n}\n.form-select[multiple], .form-select[size]:not([size=\"1\"]) {\n  padding-right: 0.75rem;\n  background-image: none;\n}\n.form-select:disabled {\n  background-color: #e9ecef;\n}\n.form-select:-moz-focusring {\n  color: transparent;\n  text-shadow: 0 0 0 #212529;\n}\n\n.form-select-sm {\n  padding-top: 0.25rem;\n  padding-bottom: 0.25rem;\n  padding-left: 0.5rem;\n  font-size: 0.875rem;\n}\n\n.form-select-lg {\n  padding-top: 0.5rem;\n  padding-bottom: 0.5rem;\n  padding-left: 1rem;\n  font-size: 1.25rem;\n}\n\n.form-check {\n  display: block;\n  min-height: 1.5rem;\n  padding-left: 1.5em;\n  margin-bottom: 0.125rem;\n}\n.form-check .form-check-input {\n  float: left;\n  margin-left: -1.5em;\n}\n\n.form-check-input {\n  width: 1em;\n  height: 1em;\n  margin-top: 0.25em;\n  vertical-align: top;\n  background-color: #fff;\n  background-repeat: no-repeat;\n  background-position: center;\n  background-size: contain;\n  border: 1px solid rgba(0, 0, 0, 0.25);\n  -webkit-appearance: none;\n  -moz-appearance: none;\n  appearance: none;\n  -webkit-print-color-adjust: exact;\n  color-adjust: exact;\n}\n.form-check-input[type=checkbox] {\n  border-radius: 0.25em;\n}\n.form-check-input[type=radio] {\n  border-radius: 50%;\n}\n.form-check-input:active {\n  filter: brightness(90%);\n}\n.form-check-input:focus {\n  border-color: #86b7fe;\n  outline: 0;\n  box-shadow: 0 0 0 0.25rem rgba(13, 110, 253, 0.25);\n}\n.form-check-input:checked {\n  background-color: #0d6efd;\n  border-color: #0d6efd;\n}\n.form-check-input:checked[type=checkbox] {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3e%3cpath fill='none' stroke='%23fff' stroke-linecap='round' stroke-linejoin='round' stroke-width='3' d='M6 10l3 3l6-6'/%3e%3c/svg%3e\");\n}\n.form-check-input:checked[type=radio] {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='-4 -4 8 8'%3e%3ccircle r='2' fill='%23fff'/%3e%3c/svg%3e\");\n}\n.form-check-input[type=checkbox]:indeterminate {\n  background-color: #0d6efd;\n  border-color: #0d6efd;\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3e%3cpath fill='none' stroke='%23fff' stroke-linecap='round' stroke-linejoin='round' stroke-width='3' d='M6 10h8'/%3e%3c/svg%3e\");\n}\n.form-check-input:disabled {\n  pointer-events: none;\n  filter: none;\n  opacity: 0.5;\n}\n.form-check-input[disabled] ~ .form-check-label, .form-check-input:disabled ~ .form-check-label {\n  opacity: 0.5;\n}\n\n.form-switch {\n  padding-left: 2.5em;\n}\n.form-switch .form-check-input {\n  width: 2em;\n  margin-left: -2.5em;\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='-4 -4 8 8'%3e%3ccircle r='3' fill='rgba%280, 0, 0, 0.25%29'/%3e%3c/svg%3e\");\n  background-position: left center;\n  border-radius: 2em;\n  transition: background-position 0.15s ease-in-out;\n}\n@media (prefers-reduced-motion: reduce) {\n  .form-switch .form-check-input {\n    transition: none;\n  }\n}\n.form-switch .form-check-input:focus {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='-4 -4 8 8'%3e%3ccircle r='3' fill='%2386b7fe'/%3e%3c/svg%3e\");\n}\n.form-switch .form-check-input:checked {\n  background-position: right center;\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='-4 -4 8 8'%3e%3ccircle r='3' fill='%23fff'/%3e%3c/svg%3e\");\n}\n\n.form-check-inline {\n  display: inline-block;\n  margin-right: 1rem;\n}\n\n.btn-check {\n  position: absolute;\n  clip: rect(0, 0, 0, 0);\n  pointer-events: none;\n}\n.btn-check[disabled] + .btn, .btn-check:disabled + .btn {\n  pointer-events: none;\n  filter: none;\n  opacity: 0.65;\n}\n\n.form-range {\n  width: 100%;\n  height: 1.5rem;\n  padding: 0;\n  background-color: transparent;\n  -webkit-appearance: none;\n  -moz-appearance: none;\n  appearance: none;\n}\n.form-range:focus {\n  outline: 0;\n}\n.form-range:focus::-webkit-slider-thumb {\n  box-shadow: 0 0 0 1px #fff, 0 0 0 0.25rem rgba(13, 110, 253, 0.25);\n}\n.form-range:focus::-moz-range-thumb {\n  box-shadow: 0 0 0 1px #fff, 0 0 0 0.25rem rgba(13, 110, 253, 0.25);\n}\n.form-range::-moz-focus-outer {\n  border: 0;\n}\n.form-range::-webkit-slider-thumb {\n  width: 1rem;\n  height: 1rem;\n  margin-top: -0.25rem;\n  background-color: #0d6efd;\n  border: 0;\n  border-radius: 1rem;\n  -webkit-transition: background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n  transition: background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n  -webkit-appearance: none;\n  appearance: none;\n}\n@media (prefers-reduced-motion: reduce) {\n  .form-range::-webkit-slider-thumb {\n    -webkit-transition: none;\n    transition: none;\n  }\n}\n.form-range::-webkit-slider-thumb:active {\n  background-color: #b6d4fe;\n}\n.form-range::-webkit-slider-runnable-track {\n  width: 100%;\n  height: 0.5rem;\n  color: transparent;\n  cursor: pointer;\n  background-color: #dee2e6;\n  border-color: transparent;\n  border-radius: 1rem;\n}\n.form-range::-moz-range-thumb {\n  width: 1rem;\n  height: 1rem;\n  background-color: #0d6efd;\n  border: 0;\n  border-radius: 1rem;\n  -moz-transition: background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n  transition: background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n  -moz-appearance: none;\n  appearance: none;\n}\n@media (prefers-reduced-motion: reduce) {\n  .form-range::-moz-range-thumb {\n    -moz-transition: none;\n    transition: none;\n  }\n}\n.form-range::-moz-range-thumb:active {\n  background-color: #b6d4fe;\n}\n.form-range::-moz-range-track {\n  width: 100%;\n  height: 0.5rem;\n  color: transparent;\n  cursor: pointer;\n  background-color: #dee2e6;\n  border-color: transparent;\n  border-radius: 1rem;\n}\n.form-range:disabled {\n  pointer-events: none;\n}\n.form-range:disabled::-webkit-slider-thumb {\n  background-color: #adb5bd;\n}\n.form-range:disabled::-moz-range-thumb {\n  background-color: #adb5bd;\n}\n\n.form-floating {\n  position: relative;\n}\n.form-floating > .form-control,\n.form-floating > .form-select {\n  height: calc(3.5rem + 2px);\n  line-height: 1.25;\n}\n.form-floating > label {\n  position: absolute;\n  top: 0;\n  left: 0;\n  height: 100%;\n  padding: 1rem 0.75rem;\n  pointer-events: none;\n  border: 1px solid transparent;\n  transform-origin: 0 0;\n  transition: opacity 0.1s ease-in-out, transform 0.1s ease-in-out;\n}\n@media (prefers-reduced-motion: reduce) {\n  .form-floating > label {\n    transition: none;\n  }\n}\n.form-floating > .form-control {\n  padding: 1rem 0.75rem;\n}\n.form-floating > .form-control::-moz-placeholder {\n  color: transparent;\n}\n.form-floating > .form-control::placeholder {\n  color: transparent;\n}\n.form-floating > .form-control:not(:-moz-placeholder-shown) {\n  padding-top: 1.625rem;\n  padding-bottom: 0.625rem;\n}\n.form-floating > .form-control:focus, .form-floating > .form-control:not(:placeholder-shown) {\n  padding-top: 1.625rem;\n  padding-bottom: 0.625rem;\n}\n.form-floating > .form-control:-webkit-autofill {\n  padding-top: 1.625rem;\n  padding-bottom: 0.625rem;\n}\n.form-floating > .form-select {\n  padding-top: 1.625rem;\n  padding-bottom: 0.625rem;\n}\n.form-floating > .form-control:not(:-moz-placeholder-shown) ~ label {\n  opacity: 0.65;\n  transform: scale(0.85) translateY(-0.5rem) translateX(0.15rem);\n}\n.form-floating > .form-control:focus ~ label,\n.form-floating > .form-control:not(:placeholder-shown) ~ label,\n.form-floating > .form-select ~ label {\n  opacity: 0.65;\n  transform: scale(0.85) translateY(-0.5rem) translateX(0.15rem);\n}\n.form-floating > .form-control:-webkit-autofill ~ label {\n  opacity: 0.65;\n  transform: scale(0.85) translateY(-0.5rem) translateX(0.15rem);\n}\n\n.input-group {\n  position: relative;\n  display: flex;\n  flex-wrap: wrap;\n  align-items: stretch;\n  width: 100%;\n}\n.input-group > .form-control,\n.input-group > .form-select {\n  position: relative;\n  flex: 1 1 auto;\n  width: 1%;\n  min-width: 0;\n}\n.input-group > .form-control:focus,\n.input-group > .form-select:focus {\n  z-index: 3;\n}\n.input-group .btn {\n  position: relative;\n  z-index: 2;\n}\n.input-group .btn:focus {\n  z-index: 3;\n}\n\n.input-group-text {\n  display: flex;\n  align-items: center;\n  padding: 0.375rem 0.75rem;\n  font-size: 1rem;\n  font-weight: 400;\n  line-height: 1.5;\n  color: #212529;\n  text-align: center;\n  white-space: nowrap;\n  background-color: #e9ecef;\n  border: 1px solid #ced4da;\n  border-radius: 0.25rem;\n}\n\n.input-group-lg > .form-control,\n.input-group-lg > .form-select,\n.input-group-lg > .input-group-text,\n.input-group-lg > .btn {\n  padding: 0.5rem 1rem;\n  font-size: 1.25rem;\n  border-radius: 0.3rem;\n}\n\n.input-group-sm > .form-control,\n.input-group-sm > .form-select,\n.input-group-sm > .input-group-text,\n.input-group-sm > .btn {\n  padding: 0.25rem 0.5rem;\n  font-size: 0.875rem;\n  border-radius: 0.2rem;\n}\n\n.input-group-lg > .form-select,\n.input-group-sm > .form-select {\n  padding-right: 3rem;\n}\n\n.input-group:not(.has-validation) > :not(:last-child):not(.dropdown-toggle):not(.dropdown-menu),\n.input-group:not(.has-validation) > .dropdown-toggle:nth-last-child(n+3) {\n  border-top-right-radius: 0;\n  border-bottom-right-radius: 0;\n}\n.input-group.has-validation > :nth-last-child(n+3):not(.dropdown-toggle):not(.dropdown-menu),\n.input-group.has-validation > .dropdown-toggle:nth-last-child(n+4) {\n  border-top-right-radius: 0;\n  border-bottom-right-radius: 0;\n}\n.input-group > :not(:first-child):not(.dropdown-menu):not(.valid-tooltip):not(.valid-feedback):not(.invalid-tooltip):not(.invalid-feedback) {\n  margin-left: -1px;\n  border-top-left-radius: 0;\n  border-bottom-left-radius: 0;\n}\n\n.valid-feedback {\n  display: none;\n  width: 100%;\n  margin-top: 0.25rem;\n  font-size: 0.875em;\n  color: #198754;\n}\n\n.valid-tooltip {\n  position: absolute;\n  top: 100%;\n  z-index: 5;\n  display: none;\n  max-width: 100%;\n  padding: 0.25rem 0.5rem;\n  margin-top: 0.1rem;\n  font-size: 0.875rem;\n  color: #fff;\n  background-color: rgba(25, 135, 84, 0.9);\n  border-radius: 0.25rem;\n}\n\n.was-validated :valid ~ .valid-feedback,\n.was-validated :valid ~ .valid-tooltip,\n.is-valid ~ .valid-feedback,\n.is-valid ~ .valid-tooltip {\n  display: block;\n}\n\n.was-validated .form-control:valid, .form-control.is-valid {\n  border-color: #198754;\n  padding-right: calc(1.5em + 0.75rem);\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 8 8'%3e%3cpath fill='%23198754' d='M2.3 6.73L.6 4.53c-.4-1.04.46-1.4 1.1-.8l1.1 1.4 3.4-3.8c.6-.63 1.6-.27 1.2.7l-4 4.6c-.43.5-.8.4-1.1.1z'/%3e%3c/svg%3e\");\n  background-repeat: no-repeat;\n  background-position: right calc(0.375em + 0.1875rem) center;\n  background-size: calc(0.75em + 0.375rem) calc(0.75em + 0.375rem);\n}\n.was-validated .form-control:valid:focus, .form-control.is-valid:focus {\n  border-color: #198754;\n  box-shadow: 0 0 0 0.25rem rgba(25, 135, 84, 0.25);\n}\n\n.was-validated textarea.form-control:valid, textarea.form-control.is-valid {\n  padding-right: calc(1.5em + 0.75rem);\n  background-position: top calc(0.375em + 0.1875rem) right calc(0.375em + 0.1875rem);\n}\n\n.was-validated .form-select:valid, .form-select.is-valid {\n  border-color: #198754;\n}\n.was-validated .form-select:valid:not([multiple]):not([size]), .was-validated .form-select:valid:not([multiple])[size=\"1\"], .form-select.is-valid:not([multiple]):not([size]), .form-select.is-valid:not([multiple])[size=\"1\"] {\n  padding-right: 4.125rem;\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3e%3cpath fill='none' stroke='%23343a40' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M2 5l6 6 6-6'/%3e%3c/svg%3e\"), url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 8 8'%3e%3cpath fill='%23198754' d='M2.3 6.73L.6 4.53c-.4-1.04.46-1.4 1.1-.8l1.1 1.4 3.4-3.8c.6-.63 1.6-.27 1.2.7l-4 4.6c-.43.5-.8.4-1.1.1z'/%3e%3c/svg%3e\");\n  background-position: right 0.75rem center, center right 2.25rem;\n  background-size: 16px 12px, calc(0.75em + 0.375rem) calc(0.75em + 0.375rem);\n}\n.was-validated .form-select:valid:focus, .form-select.is-valid:focus {\n  border-color: #198754;\n  box-shadow: 0 0 0 0.25rem rgba(25, 135, 84, 0.25);\n}\n\n.was-validated .form-check-input:valid, .form-check-input.is-valid {\n  border-color: #198754;\n}\n.was-validated .form-check-input:valid:checked, .form-check-input.is-valid:checked {\n  background-color: #198754;\n}\n.was-validated .form-check-input:valid:focus, .form-check-input.is-valid:focus {\n  box-shadow: 0 0 0 0.25rem rgba(25, 135, 84, 0.25);\n}\n.was-validated .form-check-input:valid ~ .form-check-label, .form-check-input.is-valid ~ .form-check-label {\n  color: #198754;\n}\n\n.form-check-inline .form-check-input ~ .valid-feedback {\n  margin-left: 0.5em;\n}\n\n.was-validated .input-group .form-control:valid, .input-group .form-control.is-valid,\n.was-validated .input-group .form-select:valid,\n.input-group .form-select.is-valid {\n  z-index: 1;\n}\n.was-validated .input-group .form-control:valid:focus, .input-group .form-control.is-valid:focus,\n.was-validated .input-group .form-select:valid:focus,\n.input-group .form-select.is-valid:focus {\n  z-index: 3;\n}\n\n.invalid-feedback {\n  display: none;\n  width: 100%;\n  margin-top: 0.25rem;\n  font-size: 0.875em;\n  color: #dc3545;\n}\n\n.invalid-tooltip {\n  position: absolute;\n  top: 100%;\n  z-index: 5;\n  display: none;\n  max-width: 100%;\n  padding: 0.25rem 0.5rem;\n  margin-top: 0.1rem;\n  font-size: 0.875rem;\n  color: #fff;\n  background-color: rgba(220, 53, 69, 0.9);\n  border-radius: 0.25rem;\n}\n\n.was-validated :invalid ~ .invalid-feedback,\n.was-validated :invalid ~ .invalid-tooltip,\n.is-invalid ~ .invalid-feedback,\n.is-invalid ~ .invalid-tooltip {\n  display: block;\n}\n\n.was-validated .form-control:invalid, .form-control.is-invalid {\n  border-color: #dc3545;\n  padding-right: calc(1.5em + 0.75rem);\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 12 12' width='12' height='12' fill='none' stroke='%23dc3545'%3e%3ccircle cx='6' cy='6' r='4.5'/%3e%3cpath stroke-linejoin='round' d='M5.8 3.6h.4L6 6.5z'/%3e%3ccircle cx='6' cy='8.2' r='.6' fill='%23dc3545' stroke='none'/%3e%3c/svg%3e\");\n  background-repeat: no-repeat;\n  background-position: right calc(0.375em + 0.1875rem) center;\n  background-size: calc(0.75em + 0.375rem) calc(0.75em + 0.375rem);\n}\n.was-validated .form-control:invalid:focus, .form-control.is-invalid:focus {\n  border-color: #dc3545;\n  box-shadow: 0 0 0 0.25rem rgba(220, 53, 69, 0.25);\n}\n\n.was-validated textarea.form-control:invalid, textarea.form-control.is-invalid {\n  padding-right: calc(1.5em + 0.75rem);\n  background-position: top calc(0.375em + 0.1875rem) right calc(0.375em + 0.1875rem);\n}\n\n.was-validated .form-select:invalid, .form-select.is-invalid {\n  border-color: #dc3545;\n}\n.was-validated .form-select:invalid:not([multiple]):not([size]), .was-validated .form-select:invalid:not([multiple])[size=\"1\"], .form-select.is-invalid:not([multiple]):not([size]), .form-select.is-invalid:not([multiple])[size=\"1\"] {\n  padding-right: 4.125rem;\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3e%3cpath fill='none' stroke='%23343a40' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M2 5l6 6 6-6'/%3e%3c/svg%3e\"), url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 12 12' width='12' height='12' fill='none' stroke='%23dc3545'%3e%3ccircle cx='6' cy='6' r='4.5'/%3e%3cpath stroke-linejoin='round' d='M5.8 3.6h.4L6 6.5z'/%3e%3ccircle cx='6' cy='8.2' r='.6' fill='%23dc3545' stroke='none'/%3e%3c/svg%3e\");\n  background-position: right 0.75rem center, center right 2.25rem;\n  background-size: 16px 12px, calc(0.75em + 0.375rem) calc(0.75em + 0.375rem);\n}\n.was-validated .form-select:invalid:focus, .form-select.is-invalid:focus {\n  border-color: #dc3545;\n  box-shadow: 0 0 0 0.25rem rgba(220, 53, 69, 0.25);\n}\n\n.was-validated .form-check-input:invalid, .form-check-input.is-invalid {\n  border-color: #dc3545;\n}\n.was-validated .form-check-input:invalid:checked, .form-check-input.is-invalid:checked {\n  background-color: #dc3545;\n}\n.was-validated .form-check-input:invalid:focus, .form-check-input.is-invalid:focus {\n  box-shadow: 0 0 0 0.25rem rgba(220, 53, 69, 0.25);\n}\n.was-validated .form-check-input:invalid ~ .form-check-label, .form-check-input.is-invalid ~ .form-check-label {\n  color: #dc3545;\n}\n\n.form-check-inline .form-check-input ~ .invalid-feedback {\n  margin-left: 0.5em;\n}\n\n.was-validated .input-group .form-control:invalid, .input-group .form-control.is-invalid,\n.was-validated .input-group .form-select:invalid,\n.input-group .form-select.is-invalid {\n  z-index: 2;\n}\n.was-validated .input-group .form-control:invalid:focus, .input-group .form-control.is-invalid:focus,\n.was-validated .input-group .form-select:invalid:focus,\n.input-group .form-select.is-invalid:focus {\n  z-index: 3;\n}\n\n.btn {\n  display: inline-block;\n  font-weight: 400;\n  line-height: 1.5;\n  color: #212529;\n  text-align: center;\n  text-decoration: none;\n  vertical-align: middle;\n  cursor: pointer;\n  -webkit-user-select: none;\n  -moz-user-select: none;\n  user-select: none;\n  background-color: transparent;\n  border: 1px solid transparent;\n  padding: 0.375rem 0.75rem;\n  font-size: 1rem;\n  border-radius: 0.25rem;\n  transition: color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n}\n@media (prefers-reduced-motion: reduce) {\n  .btn {\n    transition: none;\n  }\n}\n.btn:hover {\n  color: #212529;\n}\n.btn-check:focus + .btn, .btn:focus {\n  outline: 0;\n  box-shadow: 0 0 0 0.25rem rgba(13, 110, 253, 0.25);\n}\n.btn:disabled, .btn.disabled, fieldset:disabled .btn {\n  pointer-events: none;\n  opacity: 0.65;\n}\n\n.btn-primary {\n  color: #fff;\n  background-color: #0d6efd;\n  border-color: #0d6efd;\n}\n.btn-primary:hover {\n  color: #fff;\n  background-color: #0b5ed7;\n  border-color: #0a58ca;\n}\n.btn-check:focus + .btn-primary, .btn-primary:focus {\n  color: #fff;\n  background-color: #0b5ed7;\n  border-color: #0a58ca;\n  box-shadow: 0 0 0 0.25rem rgba(49, 132, 253, 0.5);\n}\n.btn-check:checked + .btn-primary, .btn-check:active + .btn-primary, .btn-primary:active, .btn-primary.active, .show > .btn-primary.dropdown-toggle {\n  color: #fff;\n  background-color: #0a58ca;\n  border-color: #0a53be;\n}\n.btn-check:checked + .btn-primary:focus, .btn-check:active + .btn-primary:focus, .btn-primary:active:focus, .btn-primary.active:focus, .show > .btn-primary.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.25rem rgba(49, 132, 253, 0.5);\n}\n.btn-primary:disabled, .btn-primary.disabled {\n  color: #fff;\n  background-color: #0d6efd;\n  border-color: #0d6efd;\n}\n\n.btn-secondary {\n  color: #fff;\n  background-color: #6c757d;\n  border-color: #6c757d;\n}\n.btn-secondary:hover {\n  color: #fff;\n  background-color: #5c636a;\n  border-color: #565e64;\n}\n.btn-check:focus + .btn-secondary, .btn-secondary:focus {\n  color: #fff;\n  background-color: #5c636a;\n  border-color: #565e64;\n  box-shadow: 0 0 0 0.25rem rgba(130, 138, 145, 0.5);\n}\n.btn-check:checked + .btn-secondary, .btn-check:active + .btn-secondary, .btn-secondary:active, .btn-secondary.active, .show > .btn-secondary.dropdown-toggle {\n  color: #fff;\n  background-color: #565e64;\n  border-color: #51585e;\n}\n.btn-check:checked + .btn-secondary:focus, .btn-check:active + .btn-secondary:focus, .btn-secondary:active:focus, .btn-secondary.active:focus, .show > .btn-secondary.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.25rem rgba(130, 138, 145, 0.5);\n}\n.btn-secondary:disabled, .btn-secondary.disabled {\n  color: #fff;\n  background-color: #6c757d;\n  border-color: #6c757d;\n}\n\n.btn-success {\n  color: #fff;\n  background-color: #198754;\n  border-color: #198754;\n}\n.btn-success:hover {\n  color: #fff;\n  background-color: #157347;\n  border-color: #146c43;\n}\n.btn-check:focus + .btn-success, .btn-success:focus {\n  color: #fff;\n  background-color: #157347;\n  border-color: #146c43;\n  box-shadow: 0 0 0 0.25rem rgba(60, 153, 110, 0.5);\n}\n.btn-check:checked + .btn-success, .btn-check:active + .btn-success, .btn-success:active, .btn-success.active, .show > .btn-success.dropdown-toggle {\n  color: #fff;\n  background-color: #146c43;\n  border-color: #13653f;\n}\n.btn-check:checked + .btn-success:focus, .btn-check:active + .btn-success:focus, .btn-success:active:focus, .btn-success.active:focus, .show > .btn-success.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.25rem rgba(60, 153, 110, 0.5);\n}\n.btn-success:disabled, .btn-success.disabled {\n  color: #fff;\n  background-color: #198754;\n  border-color: #198754;\n}\n\n.btn-info {\n  color: #000;\n  background-color: #0dcaf0;\n  border-color: #0dcaf0;\n}\n.btn-info:hover {\n  color: #000;\n  background-color: #31d2f2;\n  border-color: #25cff2;\n}\n.btn-check:focus + .btn-info, .btn-info:focus {\n  color: #000;\n  background-color: #31d2f2;\n  border-color: #25cff2;\n  box-shadow: 0 0 0 0.25rem rgba(11, 172, 204, 0.5);\n}\n.btn-check:checked + .btn-info, .btn-check:active + .btn-info, .btn-info:active, .btn-info.active, .show > .btn-info.dropdown-toggle {\n  color: #000;\n  background-color: #3dd5f3;\n  border-color: #25cff2;\n}\n.btn-check:checked + .btn-info:focus, .btn-check:active + .btn-info:focus, .btn-info:active:focus, .btn-info.active:focus, .show > .btn-info.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.25rem rgba(11, 172, 204, 0.5);\n}\n.btn-info:disabled, .btn-info.disabled {\n  color: #000;\n  background-color: #0dcaf0;\n  border-color: #0dcaf0;\n}\n\n.btn-warning {\n  color: #000;\n  background-color: #ffc107;\n  border-color: #ffc107;\n}\n.btn-warning:hover {\n  color: #000;\n  background-color: #ffca2c;\n  border-color: #ffc720;\n}\n.btn-check:focus + .btn-warning, .btn-warning:focus {\n  color: #000;\n  background-color: #ffca2c;\n  border-color: #ffc720;\n  box-shadow: 0 0 0 0.25rem rgba(217, 164, 6, 0.5);\n}\n.btn-check:checked + .btn-warning, .btn-check:active + .btn-warning, .btn-warning:active, .btn-warning.active, .show > .btn-warning.dropdown-toggle {\n  color: #000;\n  background-color: #ffcd39;\n  border-color: #ffc720;\n}\n.btn-check:checked + .btn-warning:focus, .btn-check:active + .btn-warning:focus, .btn-warning:active:focus, .btn-warning.active:focus, .show > .btn-warning.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.25rem rgba(217, 164, 6, 0.5);\n}\n.btn-warning:disabled, .btn-warning.disabled {\n  color: #000;\n  background-color: #ffc107;\n  border-color: #ffc107;\n}\n\n.btn-danger {\n  color: #fff;\n  background-color: #dc3545;\n  border-color: #dc3545;\n}\n.btn-danger:hover {\n  color: #fff;\n  background-color: #bb2d3b;\n  border-color: #b02a37;\n}\n.btn-check:focus + .btn-danger, .btn-danger:focus {\n  color: #fff;\n  background-color: #bb2d3b;\n  border-color: #b02a37;\n  box-shadow: 0 0 0 0.25rem rgba(225, 83, 97, 0.5);\n}\n.btn-check:checked + .btn-danger, .btn-check:active + .btn-danger, .btn-danger:active, .btn-danger.active, .show > .btn-danger.dropdown-toggle {\n  color: #fff;\n  background-color: #b02a37;\n  border-color: #a52834;\n}\n.btn-check:checked + .btn-danger:focus, .btn-check:active + .btn-danger:focus, .btn-danger:active:focus, .btn-danger.active:focus, .show > .btn-danger.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.25rem rgba(225, 83, 97, 0.5);\n}\n.btn-danger:disabled, .btn-danger.disabled {\n  color: #fff;\n  background-color: #dc3545;\n  border-color: #dc3545;\n}\n\n.btn-light {\n  color: #000;\n  background-color: #f8f9fa;\n  border-color: #f8f9fa;\n}\n.btn-light:hover {\n  color: #000;\n  background-color: #f9fafb;\n  border-color: #f9fafb;\n}\n.btn-check:focus + .btn-light, .btn-light:focus {\n  color: #000;\n  background-color: #f9fafb;\n  border-color: #f9fafb;\n  box-shadow: 0 0 0 0.25rem rgba(211, 212, 213, 0.5);\n}\n.btn-check:checked + .btn-light, .btn-check:active + .btn-light, .btn-light:active, .btn-light.active, .show > .btn-light.dropdown-toggle {\n  color: #000;\n  background-color: #f9fafb;\n  border-color: #f9fafb;\n}\n.btn-check:checked + .btn-light:focus, .btn-check:active + .btn-light:focus, .btn-light:active:focus, .btn-light.active:focus, .show > .btn-light.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.25rem rgba(211, 212, 213, 0.5);\n}\n.btn-light:disabled, .btn-light.disabled {\n  color: #000;\n  background-color: #f8f9fa;\n  border-color: #f8f9fa;\n}\n\n.btn-dark {\n  color: #fff;\n  background-color: #212529;\n  border-color: #212529;\n}\n.btn-dark:hover {\n  color: #fff;\n  background-color: #1c1f23;\n  border-color: #1a1e21;\n}\n.btn-check:focus + .btn-dark, .btn-dark:focus {\n  color: #fff;\n  background-color: #1c1f23;\n  border-color: #1a1e21;\n  box-shadow: 0 0 0 0.25rem rgba(66, 70, 73, 0.5);\n}\n.btn-check:checked + .btn-dark, .btn-check:active + .btn-dark, .btn-dark:active, .btn-dark.active, .show > .btn-dark.dropdown-toggle {\n  color: #fff;\n  background-color: #1a1e21;\n  border-color: #191c1f;\n}\n.btn-check:checked + .btn-dark:focus, .btn-check:active + .btn-dark:focus, .btn-dark:active:focus, .btn-dark.active:focus, .show > .btn-dark.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.25rem rgba(66, 70, 73, 0.5);\n}\n.btn-dark:disabled, .btn-dark.disabled {\n  color: #fff;\n  background-color: #212529;\n  border-color: #212529;\n}\n\n.btn-outline-primary {\n  color: #0d6efd;\n  border-color: #0d6efd;\n}\n.btn-outline-primary:hover {\n  color: #fff;\n  background-color: #0d6efd;\n  border-color: #0d6efd;\n}\n.btn-check:focus + .btn-outline-primary, .btn-outline-primary:focus {\n  box-shadow: 0 0 0 0.25rem rgba(13, 110, 253, 0.5);\n}\n.btn-check:checked + .btn-outline-primary, .btn-check:active + .btn-outline-primary, .btn-outline-primary:active, .btn-outline-primary.active, .btn-outline-primary.dropdown-toggle.show {\n  color: #fff;\n  background-color: #0d6efd;\n  border-color: #0d6efd;\n}\n.btn-check:checked + .btn-outline-primary:focus, .btn-check:active + .btn-outline-primary:focus, .btn-outline-primary:active:focus, .btn-outline-primary.active:focus, .btn-outline-primary.dropdown-toggle.show:focus {\n  box-shadow: 0 0 0 0.25rem rgba(13, 110, 253, 0.5);\n}\n.btn-outline-primary:disabled, .btn-outline-primary.disabled {\n  color: #0d6efd;\n  background-color: transparent;\n}\n\n.btn-outline-secondary {\n  color: #6c757d;\n  border-color: #6c757d;\n}\n.btn-outline-secondary:hover {\n  color: #fff;\n  background-color: #6c757d;\n  border-color: #6c757d;\n}\n.btn-check:focus + .btn-outline-secondary, .btn-outline-secondary:focus {\n  box-shadow: 0 0 0 0.25rem rgba(108, 117, 125, 0.5);\n}\n.btn-check:checked + .btn-outline-secondary, .btn-check:active + .btn-outline-secondary, .btn-outline-secondary:active, .btn-outline-secondary.active, .btn-outline-secondary.dropdown-toggle.show {\n  color: #fff;\n  background-color: #6c757d;\n  border-color: #6c757d;\n}\n.btn-check:checked + .btn-outline-secondary:focus, .btn-check:active + .btn-outline-secondary:focus, .btn-outline-secondary:active:focus, .btn-outline-secondary.active:focus, .btn-outline-secondary.dropdown-toggle.show:focus {\n  box-shadow: 0 0 0 0.25rem rgba(108, 117, 125, 0.5);\n}\n.btn-outline-secondary:disabled, .btn-outline-secondary.disabled {\n  color: #6c757d;\n  background-color: transparent;\n}\n\n.btn-outline-success {\n  color: #198754;\n  border-color: #198754;\n}\n.btn-outline-success:hover {\n  color: #fff;\n  background-color: #198754;\n  border-color: #198754;\n}\n.btn-check:focus + .btn-outline-success, .btn-outline-success:focus {\n  box-shadow: 0 0 0 0.25rem rgba(25, 135, 84, 0.5);\n}\n.btn-check:checked + .btn-outline-success, .btn-check:active + .btn-outline-success, .btn-outline-success:active, .btn-outline-success.active, .btn-outline-success.dropdown-toggle.show {\n  color: #fff;\n  background-color: #198754;\n  border-color: #198754;\n}\n.btn-check:checked + .btn-outline-success:focus, .btn-check:active + .btn-outline-success:focus, .btn-outline-success:active:focus, .btn-outline-success.active:focus, .btn-outline-success.dropdown-toggle.show:focus {\n  box-shadow: 0 0 0 0.25rem rgba(25, 135, 84, 0.5);\n}\n.btn-outline-success:disabled, .btn-outline-success.disabled {\n  color: #198754;\n  background-color: transparent;\n}\n\n.btn-outline-info {\n  color: #0dcaf0;\n  border-color: #0dcaf0;\n}\n.btn-outline-info:hover {\n  color: #000;\n  background-color: #0dcaf0;\n  border-color: #0dcaf0;\n}\n.btn-check:focus + .btn-outline-info, .btn-outline-info:focus {\n  box-shadow: 0 0 0 0.25rem rgba(13, 202, 240, 0.5);\n}\n.btn-check:checked + .btn-outline-info, .btn-check:active + .btn-outline-info, .btn-outline-info:active, .btn-outline-info.active, .btn-outline-info.dropdown-toggle.show {\n  color: #000;\n  background-color: #0dcaf0;\n  border-color: #0dcaf0;\n}\n.btn-check:checked + .btn-outline-info:focus, .btn-check:active + .btn-outline-info:focus, .btn-outline-info:active:focus, .btn-outline-info.active:focus, .btn-outline-info.dropdown-toggle.show:focus {\n  box-shadow: 0 0 0 0.25rem rgba(13, 202, 240, 0.5);\n}\n.btn-outline-info:disabled, .btn-outline-info.disabled {\n  color: #0dcaf0;\n  background-color: transparent;\n}\n\n.btn-outline-warning {\n  color: #ffc107;\n  border-color: #ffc107;\n}\n.btn-outline-warning:hover {\n  color: #000;\n  background-color: #ffc107;\n  border-color: #ffc107;\n}\n.btn-check:focus + .btn-outline-warning, .btn-outline-warning:focus {\n  box-shadow: 0 0 0 0.25rem rgba(255, 193, 7, 0.5);\n}\n.btn-check:checked + .btn-outline-warning, .btn-check:active + .btn-outline-warning, .btn-outline-warning:active, .btn-outline-warning.active, .btn-outline-warning.dropdown-toggle.show {\n  color: #000;\n  background-color: #ffc107;\n  border-color: #ffc107;\n}\n.btn-check:checked + .btn-outline-warning:focus, .btn-check:active + .btn-outline-warning:focus, .btn-outline-warning:active:focus, .btn-outline-warning.active:focus, .btn-outline-warning.dropdown-toggle.show:focus {\n  box-shadow: 0 0 0 0.25rem rgba(255, 193, 7, 0.5);\n}\n.btn-outline-warning:disabled, .btn-outline-warning.disabled {\n  color: #ffc107;\n  background-color: transparent;\n}\n\n.btn-outline-danger {\n  color: #dc3545;\n  border-color: #dc3545;\n}\n.btn-outline-danger:hover {\n  color: #fff;\n  background-color: #dc3545;\n  border-color: #dc3545;\n}\n.btn-check:focus + .btn-outline-danger, .btn-outline-danger:focus {\n  box-shadow: 0 0 0 0.25rem rgba(220, 53, 69, 0.5);\n}\n.btn-check:checked + .btn-outline-danger, .btn-check:active + .btn-outline-danger, .btn-outline-danger:active, .btn-outline-danger.active, .btn-outline-danger.dropdown-toggle.show {\n  color: #fff;\n  background-color: #dc3545;\n  border-color: #dc3545;\n}\n.btn-check:checked + .btn-outline-danger:focus, .btn-check:active + .btn-outline-danger:focus, .btn-outline-danger:active:focus, .btn-outline-danger.active:focus, .btn-outline-danger.dropdown-toggle.show:focus {\n  box-shadow: 0 0 0 0.25rem rgba(220, 53, 69, 0.5);\n}\n.btn-outline-danger:disabled, .btn-outline-danger.disabled {\n  color: #dc3545;\n  background-color: transparent;\n}\n\n.btn-outline-light {\n  color: #f8f9fa;\n  border-color: #f8f9fa;\n}\n.btn-outline-light:hover {\n  color: #000;\n  background-color: #f8f9fa;\n  border-color: #f8f9fa;\n}\n.btn-check:focus + .btn-outline-light, .btn-outline-light:focus {\n  box-shadow: 0 0 0 0.25rem rgba(248, 249, 250, 0.5);\n}\n.btn-check:checked + .btn-outline-light, .btn-check:active + .btn-outline-light, .btn-outline-light:active, .btn-outline-light.active, .btn-outline-light.dropdown-toggle.show {\n  color: #000;\n  background-color: #f8f9fa;\n  border-color: #f8f9fa;\n}\n.btn-check:checked + .btn-outline-light:focus, .btn-check:active + .btn-outline-light:focus, .btn-outline-light:active:focus, .btn-outline-light.active:focus, .btn-outline-light.dropdown-toggle.show:focus {\n  box-shadow: 0 0 0 0.25rem rgba(248, 249, 250, 0.5);\n}\n.btn-outline-light:disabled, .btn-outline-light.disabled {\n  color: #f8f9fa;\n  background-color: transparent;\n}\n\n.btn-outline-dark {\n  color: #212529;\n  border-color: #212529;\n}\n.btn-outline-dark:hover {\n  color: #fff;\n  background-color: #212529;\n  border-color: #212529;\n}\n.btn-check:focus + .btn-outline-dark, .btn-outline-dark:focus {\n  box-shadow: 0 0 0 0.25rem rgba(33, 37, 41, 0.5);\n}\n.btn-check:checked + .btn-outline-dark, .btn-check:active + .btn-outline-dark, .btn-outline-dark:active, .btn-outline-dark.active, .btn-outline-dark.dropdown-toggle.show {\n  color: #fff;\n  background-color: #212529;\n  border-color: #212529;\n}\n.btn-check:checked + .btn-outline-dark:focus, .btn-check:active + .btn-outline-dark:focus, .btn-outline-dark:active:focus, .btn-outline-dark.active:focus, .btn-outline-dark.dropdown-toggle.show:focus {\n  box-shadow: 0 0 0 0.25rem rgba(33, 37, 41, 0.5);\n}\n.btn-outline-dark:disabled, .btn-outline-dark.disabled {\n  color: #212529;\n  background-color: transparent;\n}\n\n.btn-link {\n  font-weight: 400;\n  color: #0d6efd;\n  text-decoration: underline;\n}\n.btn-link:hover {\n  color: #0a58ca;\n}\n.btn-link:disabled, .btn-link.disabled {\n  color: #6c757d;\n}\n\n.btn-lg, .btn-group-lg > .btn {\n  padding: 0.5rem 1rem;\n  font-size: 1.25rem;\n  border-radius: 0.3rem;\n}\n\n.btn-sm, .btn-group-sm > .btn {\n  padding: 0.25rem 0.5rem;\n  font-size: 0.875rem;\n  border-radius: 0.2rem;\n}\n\n.fade {\n  transition: opacity 0.15s linear;\n}\n@media (prefers-reduced-motion: reduce) {\n  .fade {\n    transition: none;\n  }\n}\n.fade:not(.show) {\n  opacity: 0;\n}\n\n.collapse:not(.show) {\n  display: none;\n}\n\n.collapsing {\n  height: 0;\n  overflow: hidden;\n  transition: height 0.35s ease;\n}\n@media (prefers-reduced-motion: reduce) {\n  .collapsing {\n    transition: none;\n  }\n}\n.collapsing.collapse-horizontal {\n  width: 0;\n  height: auto;\n  transition: width 0.35s ease;\n}\n@media (prefers-reduced-motion: reduce) {\n  .collapsing.collapse-horizontal {\n    transition: none;\n  }\n}\n\n.dropup,\n.dropend,\n.dropdown,\n.dropstart {\n  position: relative;\n}\n\n.dropdown-toggle {\n  white-space: nowrap;\n}\n.dropdown-toggle::after {\n  display: inline-block;\n  margin-left: 0.255em;\n  vertical-align: 0.255em;\n  content: \"\";\n  border-top: 0.3em solid;\n  border-right: 0.3em solid transparent;\n  border-bottom: 0;\n  border-left: 0.3em solid transparent;\n}\n.dropdown-toggle:empty::after {\n  margin-left: 0;\n}\n\n.dropdown-menu {\n  position: absolute;\n  z-index: 1000;\n  display: none;\n  min-width: 10rem;\n  padding: 0.5rem 0;\n  margin: 0;\n  font-size: 1rem;\n  color: #212529;\n  text-align: left;\n  list-style: none;\n  background-color: #fff;\n  background-clip: padding-box;\n  border: 1px solid rgba(0, 0, 0, 0.15);\n  border-radius: 0.25rem;\n}\n.dropdown-menu[data-bs-popper] {\n  top: 100%;\n  left: 0;\n  margin-top: 0.125rem;\n}\n\n.dropdown-menu-start {\n  --bs-position: start;\n}\n.dropdown-menu-start[data-bs-popper] {\n  right: auto;\n  left: 0;\n}\n\n.dropdown-menu-end {\n  --bs-position: end;\n}\n.dropdown-menu-end[data-bs-popper] {\n  right: 0;\n  left: auto;\n}\n\n@media (min-width: 576px) {\n  .dropdown-menu-sm-start {\n    --bs-position: start;\n  }\n  .dropdown-menu-sm-start[data-bs-popper] {\n    right: auto;\n    left: 0;\n  }\n\n  .dropdown-menu-sm-end {\n    --bs-position: end;\n  }\n  .dropdown-menu-sm-end[data-bs-popper] {\n    right: 0;\n    left: auto;\n  }\n}\n@media (min-width: 768px) {\n  .dropdown-menu-md-start {\n    --bs-position: start;\n  }\n  .dropdown-menu-md-start[data-bs-popper] {\n    right: auto;\n    left: 0;\n  }\n\n  .dropdown-menu-md-end {\n    --bs-position: end;\n  }\n  .dropdown-menu-md-end[data-bs-popper] {\n    right: 0;\n    left: auto;\n  }\n}\n@media (min-width: 992px) {\n  .dropdown-menu-lg-start {\n    --bs-position: start;\n  }\n  .dropdown-menu-lg-start[data-bs-popper] {\n    right: auto;\n    left: 0;\n  }\n\n  .dropdown-menu-lg-end {\n    --bs-position: end;\n  }\n  .dropdown-menu-lg-end[data-bs-popper] {\n    right: 0;\n    left: auto;\n  }\n}\n@media (min-width: 1200px) {\n  .dropdown-menu-xl-start {\n    --bs-position: start;\n  }\n  .dropdown-menu-xl-start[data-bs-popper] {\n    right: auto;\n    left: 0;\n  }\n\n  .dropdown-menu-xl-end {\n    --bs-position: end;\n  }\n  .dropdown-menu-xl-end[data-bs-popper] {\n    right: 0;\n    left: auto;\n  }\n}\n@media (min-width: 1400px) {\n  .dropdown-menu-xxl-start {\n    --bs-position: start;\n  }\n  .dropdown-menu-xxl-start[data-bs-popper] {\n    right: auto;\n    left: 0;\n  }\n\n  .dropdown-menu-xxl-end {\n    --bs-position: end;\n  }\n  .dropdown-menu-xxl-end[data-bs-popper] {\n    right: 0;\n    left: auto;\n  }\n}\n.dropup .dropdown-menu[data-bs-popper] {\n  top: auto;\n  bottom: 100%;\n  margin-top: 0;\n  margin-bottom: 0.125rem;\n}\n.dropup .dropdown-toggle::after {\n  display: inline-block;\n  margin-left: 0.255em;\n  vertical-align: 0.255em;\n  content: \"\";\n  border-top: 0;\n  border-right: 0.3em solid transparent;\n  border-bottom: 0.3em solid;\n  border-left: 0.3em solid transparent;\n}\n.dropup .dropdown-toggle:empty::after {\n  margin-left: 0;\n}\n\n.dropend .dropdown-menu[data-bs-popper] {\n  top: 0;\n  right: auto;\n  left: 100%;\n  margin-top: 0;\n  margin-left: 0.125rem;\n}\n.dropend .dropdown-toggle::after {\n  display: inline-block;\n  margin-left: 0.255em;\n  vertical-align: 0.255em;\n  content: \"\";\n  border-top: 0.3em solid transparent;\n  border-right: 0;\n  border-bottom: 0.3em solid transparent;\n  border-left: 0.3em solid;\n}\n.dropend .dropdown-toggle:empty::after {\n  margin-left: 0;\n}\n.dropend .dropdown-toggle::after {\n  vertical-align: 0;\n}\n\n.dropstart .dropdown-menu[data-bs-popper] {\n  top: 0;\n  right: 100%;\n  left: auto;\n  margin-top: 0;\n  margin-right: 0.125rem;\n}\n.dropstart .dropdown-toggle::after {\n  display: inline-block;\n  margin-left: 0.255em;\n  vertical-align: 0.255em;\n  content: \"\";\n}\n.dropstart .dropdown-toggle::after {\n  display: none;\n}\n.dropstart .dropdown-toggle::before {\n  display: inline-block;\n  margin-right: 0.255em;\n  vertical-align: 0.255em;\n  content: \"\";\n  border-top: 0.3em solid transparent;\n  border-right: 0.3em solid;\n  border-bottom: 0.3em solid transparent;\n}\n.dropstart .dropdown-toggle:empty::after {\n  margin-left: 0;\n}\n.dropstart .dropdown-toggle::before {\n  vertical-align: 0;\n}\n\n.dropdown-divider {\n  height: 0;\n  margin: 0.5rem 0;\n  overflow: hidden;\n  border-top: 1px solid rgba(0, 0, 0, 0.15);\n}\n\n.dropdown-item {\n  display: block;\n  width: 100%;\n  padding: 0.25rem 1rem;\n  clear: both;\n  font-weight: 400;\n  color: #212529;\n  text-align: inherit;\n  text-decoration: none;\n  white-space: nowrap;\n  background-color: transparent;\n  border: 0;\n}\n.dropdown-item:hover, .dropdown-item:focus {\n  color: #1e2125;\n  background-color: #e9ecef;\n}\n.dropdown-item.active, .dropdown-item:active {\n  color: #fff;\n  text-decoration: none;\n  background-color: #0d6efd;\n}\n.dropdown-item.disabled, .dropdown-item:disabled {\n  color: #adb5bd;\n  pointer-events: none;\n  background-color: transparent;\n}\n\n.dropdown-menu.show {\n  display: block;\n}\n\n.dropdown-header {\n  display: block;\n  padding: 0.5rem 1rem;\n  margin-bottom: 0;\n  font-size: 0.875rem;\n  color: #6c757d;\n  white-space: nowrap;\n}\n\n.dropdown-item-text {\n  display: block;\n  padding: 0.25rem 1rem;\n  color: #212529;\n}\n\n.dropdown-menu-dark {\n  color: #dee2e6;\n  background-color: #343a40;\n  border-color: rgba(0, 0, 0, 0.15);\n}\n.dropdown-menu-dark .dropdown-item {\n  color: #dee2e6;\n}\n.dropdown-menu-dark .dropdown-item:hover, .dropdown-menu-dark .dropdown-item:focus {\n  color: #fff;\n  background-color: rgba(255, 255, 255, 0.15);\n}\n.dropdown-menu-dark .dropdown-item.active, .dropdown-menu-dark .dropdown-item:active {\n  color: #fff;\n  background-color: #0d6efd;\n}\n.dropdown-menu-dark .dropdown-item.disabled, .dropdown-menu-dark .dropdown-item:disabled {\n  color: #adb5bd;\n}\n.dropdown-menu-dark .dropdown-divider {\n  border-color: rgba(0, 0, 0, 0.15);\n}\n.dropdown-menu-dark .dropdown-item-text {\n  color: #dee2e6;\n}\n.dropdown-menu-dark .dropdown-header {\n  color: #adb5bd;\n}\n\n.btn-group,\n.btn-group-vertical {\n  position: relative;\n  display: inline-flex;\n  vertical-align: middle;\n}\n.btn-group > .btn,\n.btn-group-vertical > .btn {\n  position: relative;\n  flex: 1 1 auto;\n}\n.btn-group > .btn-check:checked + .btn,\n.btn-group > .btn-check:focus + .btn,\n.btn-group > .btn:hover,\n.btn-group > .btn:focus,\n.btn-group > .btn:active,\n.btn-group > .btn.active,\n.btn-group-vertical > .btn-check:checked + .btn,\n.btn-group-vertical > .btn-check:focus + .btn,\n.btn-group-vertical > .btn:hover,\n.btn-group-vertical > .btn:focus,\n.btn-group-vertical > .btn:active,\n.btn-group-vertical > .btn.active {\n  z-index: 1;\n}\n\n.btn-toolbar {\n  display: flex;\n  flex-wrap: wrap;\n  justify-content: flex-start;\n}\n.btn-toolbar .input-group {\n  width: auto;\n}\n\n.btn-group > .btn:not(:first-child),\n.btn-group > .btn-group:not(:first-child) {\n  margin-left: -1px;\n}\n.btn-group > .btn:not(:last-child):not(.dropdown-toggle),\n.btn-group > .btn-group:not(:last-child) > .btn {\n  border-top-right-radius: 0;\n  border-bottom-right-radius: 0;\n}\n.btn-group > .btn:nth-child(n+3),\n.btn-group > :not(.btn-check) + .btn,\n.btn-group > .btn-group:not(:first-child) > .btn {\n  border-top-left-radius: 0;\n  border-bottom-left-radius: 0;\n}\n\n.dropdown-toggle-split {\n  padding-right: 0.5625rem;\n  padding-left: 0.5625rem;\n}\n.dropdown-toggle-split::after, .dropup .dropdown-toggle-split::after, .dropend .dropdown-toggle-split::after {\n  margin-left: 0;\n}\n.dropstart .dropdown-toggle-split::before {\n  margin-right: 0;\n}\n\n.btn-sm + .dropdown-toggle-split, .btn-group-sm > .btn + .dropdown-toggle-split {\n  padding-right: 0.375rem;\n  padding-left: 0.375rem;\n}\n\n.btn-lg + .dropdown-toggle-split, .btn-group-lg > .btn + .dropdown-toggle-split {\n  padding-right: 0.75rem;\n  padding-left: 0.75rem;\n}\n\n.btn-group-vertical {\n  flex-direction: column;\n  align-items: flex-start;\n  justify-content: center;\n}\n.btn-group-vertical > .btn,\n.btn-group-vertical > .btn-group {\n  width: 100%;\n}\n.btn-group-vertical > .btn:not(:first-child),\n.btn-group-vertical > .btn-group:not(:first-child) {\n  margin-top: -1px;\n}\n.btn-group-vertical > .btn:not(:last-child):not(.dropdown-toggle),\n.btn-group-vertical > .btn-group:not(:last-child) > .btn {\n  border-bottom-right-radius: 0;\n  border-bottom-left-radius: 0;\n}\n.btn-group-vertical > .btn ~ .btn,\n.btn-group-vertical > .btn-group:not(:first-child) > .btn {\n  border-top-left-radius: 0;\n  border-top-right-radius: 0;\n}\n\n.nav {\n  display: flex;\n  flex-wrap: wrap;\n  padding-left: 0;\n  margin-bottom: 0;\n  list-style: none;\n}\n\n.nav-link {\n  display: block;\n  padding: 0.5rem 1rem;\n  color: #0d6efd;\n  text-decoration: none;\n  transition: color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out;\n}\n@media (prefers-reduced-motion: reduce) {\n  .nav-link {\n    transition: none;\n  }\n}\n.nav-link:hover, .nav-link:focus {\n  color: #0a58ca;\n}\n.nav-link.disabled {\n  color: #6c757d;\n  pointer-events: none;\n  cursor: default;\n}\n\n.nav-tabs {\n  border-bottom: 1px solid #dee2e6;\n}\n.nav-tabs .nav-link {\n  margin-bottom: -1px;\n  background: none;\n  border: 1px solid transparent;\n  border-top-left-radius: 0.25rem;\n  border-top-right-radius: 0.25rem;\n}\n.nav-tabs .nav-link:hover, .nav-tabs .nav-link:focus {\n  border-color: #e9ecef #e9ecef #dee2e6;\n  isolation: isolate;\n}\n.nav-tabs .nav-link.disabled {\n  color: #6c757d;\n  background-color: transparent;\n  border-color: transparent;\n}\n.nav-tabs .nav-link.active,\n.nav-tabs .nav-item.show .nav-link {\n  color: #495057;\n  background-color: #fff;\n  border-color: #dee2e6 #dee2e6 #fff;\n}\n.nav-tabs .dropdown-menu {\n  margin-top: -1px;\n  border-top-left-radius: 0;\n  border-top-right-radius: 0;\n}\n\n.nav-pills .nav-link {\n  background: none;\n  border: 0;\n  border-radius: 0.25rem;\n}\n.nav-pills .nav-link.active,\n.nav-pills .show > .nav-link {\n  color: #fff;\n  background-color: #0d6efd;\n}\n\n.nav-fill > .nav-link,\n.nav-fill .nav-item {\n  flex: 1 1 auto;\n  text-align: center;\n}\n\n.nav-justified > .nav-link,\n.nav-justified .nav-item {\n  flex-basis: 0;\n  flex-grow: 1;\n  text-align: center;\n}\n\n.nav-fill .nav-item .nav-link,\n.nav-justified .nav-item .nav-link {\n  width: 100%;\n}\n\n.tab-content > .tab-pane {\n  display: none;\n}\n.tab-content > .active {\n  display: block;\n}\n\n.navbar {\n  position: relative;\n  display: flex;\n  flex-wrap: wrap;\n  align-items: center;\n  justify-content: space-between;\n  padding-top: 0.5rem;\n  padding-bottom: 0.5rem;\n}\n.navbar > .container,\n.navbar > .container-fluid,\n.navbar > .container-sm,\n.navbar > .container-md,\n.navbar > .container-lg,\n.navbar > .container-xl,\n.navbar > .container-xxl {\n  display: flex;\n  flex-wrap: inherit;\n  align-items: center;\n  justify-content: space-between;\n}\n.navbar-brand {\n  padding-top: 0.3125rem;\n  padding-bottom: 0.3125rem;\n  margin-right: 1rem;\n  font-size: 1.25rem;\n  text-decoration: none;\n  white-space: nowrap;\n}\n.navbar-nav {\n  display: flex;\n  flex-direction: column;\n  padding-left: 0;\n  margin-bottom: 0;\n  list-style: none;\n}\n.navbar-nav .nav-link {\n  padding-right: 0;\n  padding-left: 0;\n}\n.navbar-nav .dropdown-menu {\n  position: static;\n}\n\n.navbar-text {\n  padding-top: 0.5rem;\n  padding-bottom: 0.5rem;\n}\n\n.navbar-collapse {\n  flex-basis: 100%;\n  flex-grow: 1;\n  align-items: center;\n}\n\n.navbar-toggler {\n  padding: 0.25rem 0.75rem;\n  font-size: 1.25rem;\n  line-height: 1;\n  background-color: transparent;\n  border: 1px solid transparent;\n  border-radius: 0.25rem;\n  transition: box-shadow 0.15s ease-in-out;\n}\n@media (prefers-reduced-motion: reduce) {\n  .navbar-toggler {\n    transition: none;\n  }\n}\n.navbar-toggler:hover {\n  text-decoration: none;\n}\n.navbar-toggler:focus {\n  text-decoration: none;\n  outline: 0;\n  box-shadow: 0 0 0 0.25rem;\n}\n\n.navbar-toggler-icon {\n  display: inline-block;\n  width: 1.5em;\n  height: 1.5em;\n  vertical-align: middle;\n  background-repeat: no-repeat;\n  background-position: center;\n  background-size: 100%;\n}\n\n.navbar-nav-scroll {\n  max-height: var(--bs-scroll-height, 75vh);\n  overflow-y: auto;\n}\n\n@media (min-width: 576px) {\n  .navbar-expand-sm {\n    flex-wrap: nowrap;\n    justify-content: flex-start;\n  }\n  .navbar-expand-sm .navbar-nav {\n    flex-direction: row;\n  }\n  .navbar-expand-sm .navbar-nav .dropdown-menu {\n    position: absolute;\n  }\n  .navbar-expand-sm .navbar-nav .nav-link {\n    padding-right: 0.5rem;\n    padding-left: 0.5rem;\n  }\n  .navbar-expand-sm .navbar-nav-scroll {\n    overflow: visible;\n  }\n  .navbar-expand-sm .navbar-collapse {\n    display: flex !important;\n    flex-basis: auto;\n  }\n  .navbar-expand-sm .navbar-toggler {\n    display: none;\n  }\n  .navbar-expand-sm .offcanvas-header {\n    display: none;\n  }\n  .navbar-expand-sm .offcanvas {\n    position: inherit;\n    bottom: 0;\n    z-index: 1000;\n    flex-grow: 1;\n    visibility: visible !important;\n    background-color: transparent;\n    border-right: 0;\n    border-left: 0;\n    transition: none;\n    transform: none;\n  }\n  .navbar-expand-sm .offcanvas-top,\n.navbar-expand-sm .offcanvas-bottom {\n    height: auto;\n    border-top: 0;\n    border-bottom: 0;\n  }\n  .navbar-expand-sm .offcanvas-body {\n    display: flex;\n    flex-grow: 0;\n    padding: 0;\n    overflow-y: visible;\n  }\n}\n@media (min-width: 768px) {\n  .navbar-expand-md {\n    flex-wrap: nowrap;\n    justify-content: flex-start;\n  }\n  .navbar-expand-md .navbar-nav {\n    flex-direction: row;\n  }\n  .navbar-expand-md .navbar-nav .dropdown-menu {\n    position: absolute;\n  }\n  .navbar-expand-md .navbar-nav .nav-link {\n    padding-right: 0.5rem;\n    padding-left: 0.5rem;\n  }\n  .navbar-expand-md .navbar-nav-scroll {\n    overflow: visible;\n  }\n  .navbar-expand-md .navbar-collapse {\n    display: flex !important;\n    flex-basis: auto;\n  }\n  .navbar-expand-md .navbar-toggler {\n    display: none;\n  }\n  .navbar-expand-md .offcanvas-header {\n    display: none;\n  }\n  .navbar-expand-md .offcanvas {\n    position: inherit;\n    bottom: 0;\n    z-index: 1000;\n    flex-grow: 1;\n    visibility: visible !important;\n    background-color: transparent;\n    border-right: 0;\n    border-left: 0;\n    transition: none;\n    transform: none;\n  }\n  .navbar-expand-md .offcanvas-top,\n.navbar-expand-md .offcanvas-bottom {\n    height: auto;\n    border-top: 0;\n    border-bottom: 0;\n  }\n  .navbar-expand-md .offcanvas-body {\n    display: flex;\n    flex-grow: 0;\n    padding: 0;\n    overflow-y: visible;\n  }\n}\n@media (min-width: 992px) {\n  .navbar-expand-lg {\n    flex-wrap: nowrap;\n    justify-content: flex-start;\n  }\n  .navbar-expand-lg .navbar-nav {\n    flex-direction: row;\n  }\n  .navbar-expand-lg .navbar-nav .dropdown-menu {\n    position: absolute;\n  }\n  .navbar-expand-lg .navbar-nav .nav-link {\n    padding-right: 0.5rem;\n    padding-left: 0.5rem;\n  }\n  .navbar-expand-lg .navbar-nav-scroll {\n    overflow: visible;\n  }\n  .navbar-expand-lg .navbar-collapse {\n    display: flex !important;\n    flex-basis: auto;\n  }\n  .navbar-expand-lg .navbar-toggler {\n    display: none;\n  }\n  .navbar-expand-lg .offcanvas-header {\n    display: none;\n  }\n  .navbar-expand-lg .offcanvas {\n    position: inherit;\n    bottom: 0;\n    z-index: 1000;\n    flex-grow: 1;\n    visibility: visible !important;\n    background-color: transparent;\n    border-right: 0;\n    border-left: 0;\n    transition: none;\n    transform: none;\n  }\n  .navbar-expand-lg .offcanvas-top,\n.navbar-expand-lg .offcanvas-bottom {\n    height: auto;\n    border-top: 0;\n    border-bottom: 0;\n  }\n  .navbar-expand-lg .offcanvas-body {\n    display: flex;\n    flex-grow: 0;\n    padding: 0;\n    overflow-y: visible;\n  }\n}\n@media (min-width: 1200px) {\n  .navbar-expand-xl {\n    flex-wrap: nowrap;\n    justify-content: flex-start;\n  }\n  .navbar-expand-xl .navbar-nav {\n    flex-direction: row;\n  }\n  .navbar-expand-xl .navbar-nav .dropdown-menu {\n    position: absolute;\n  }\n  .navbar-expand-xl .navbar-nav .nav-link {\n    padding-right: 0.5rem;\n    padding-left: 0.5rem;\n  }\n  .navbar-expand-xl .navbar-nav-scroll {\n    overflow: visible;\n  }\n  .navbar-expand-xl .navbar-collapse {\n    display: flex !important;\n    flex-basis: auto;\n  }\n  .navbar-expand-xl .navbar-toggler {\n    display: none;\n  }\n  .navbar-expand-xl .offcanvas-header {\n    display: none;\n  }\n  .navbar-expand-xl .offcanvas {\n    position: inherit;\n    bottom: 0;\n    z-index: 1000;\n    flex-grow: 1;\n    visibility: visible !important;\n    background-color: transparent;\n    border-right: 0;\n    border-left: 0;\n    transition: none;\n    transform: none;\n  }\n  .navbar-expand-xl .offcanvas-top,\n.navbar-expand-xl .offcanvas-bottom {\n    height: auto;\n    border-top: 0;\n    border-bottom: 0;\n  }\n  .navbar-expand-xl .offcanvas-body {\n    display: flex;\n    flex-grow: 0;\n    padding: 0;\n    overflow-y: visible;\n  }\n}\n@media (min-width: 1400px) {\n  .navbar-expand-xxl {\n    flex-wrap: nowrap;\n    justify-content: flex-start;\n  }\n  .navbar-expand-xxl .navbar-nav {\n    flex-direction: row;\n  }\n  .navbar-expand-xxl .navbar-nav .dropdown-menu {\n    position: absolute;\n  }\n  .navbar-expand-xxl .navbar-nav .nav-link {\n    padding-right: 0.5rem;\n    padding-left: 0.5rem;\n  }\n  .navbar-expand-xxl .navbar-nav-scroll {\n    overflow: visible;\n  }\n  .navbar-expand-xxl .navbar-collapse {\n    display: flex !important;\n    flex-basis: auto;\n  }\n  .navbar-expand-xxl .navbar-toggler {\n    display: none;\n  }\n  .navbar-expand-xxl .offcanvas-header {\n    display: none;\n  }\n  .navbar-expand-xxl .offcanvas {\n    position: inherit;\n    bottom: 0;\n    z-index: 1000;\n    flex-grow: 1;\n    visibility: visible !important;\n    background-color: transparent;\n    border-right: 0;\n    border-left: 0;\n    transition: none;\n    transform: none;\n  }\n  .navbar-expand-xxl .offcanvas-top,\n.navbar-expand-xxl .offcanvas-bottom {\n    height: auto;\n    border-top: 0;\n    border-bottom: 0;\n  }\n  .navbar-expand-xxl .offcanvas-body {\n    display: flex;\n    flex-grow: 0;\n    padding: 0;\n    overflow-y: visible;\n  }\n}\n.navbar-expand {\n  flex-wrap: nowrap;\n  justify-content: flex-start;\n}\n.navbar-expand .navbar-nav {\n  flex-direction: row;\n}\n.navbar-expand .navbar-nav .dropdown-menu {\n  position: absolute;\n}\n.navbar-expand .navbar-nav .nav-link {\n  padding-right: 0.5rem;\n  padding-left: 0.5rem;\n}\n.navbar-expand .navbar-nav-scroll {\n  overflow: visible;\n}\n.navbar-expand .navbar-collapse {\n  display: flex !important;\n  flex-basis: auto;\n}\n.navbar-expand .navbar-toggler {\n  display: none;\n}\n.navbar-expand .offcanvas-header {\n  display: none;\n}\n.navbar-expand .offcanvas {\n  position: inherit;\n  bottom: 0;\n  z-index: 1000;\n  flex-grow: 1;\n  visibility: visible !important;\n  background-color: transparent;\n  border-right: 0;\n  border-left: 0;\n  transition: none;\n  transform: none;\n}\n.navbar-expand .offcanvas-top,\n.navbar-expand .offcanvas-bottom {\n  height: auto;\n  border-top: 0;\n  border-bottom: 0;\n}\n.navbar-expand .offcanvas-body {\n  display: flex;\n  flex-grow: 0;\n  padding: 0;\n  overflow-y: visible;\n}\n\n.navbar-light .navbar-brand {\n  color: rgba(0, 0, 0, 0.9);\n}\n.navbar-light .navbar-brand:hover, .navbar-light .navbar-brand:focus {\n  color: rgba(0, 0, 0, 0.9);\n}\n.navbar-light .navbar-nav .nav-link {\n  color: rgba(0, 0, 0, 0.55);\n}\n.navbar-light .navbar-nav .nav-link:hover, .navbar-light .navbar-nav .nav-link:focus {\n  color: rgba(0, 0, 0, 0.7);\n}\n.navbar-light .navbar-nav .nav-link.disabled {\n  color: rgba(0, 0, 0, 0.3);\n}\n.navbar-light .navbar-nav .show > .nav-link,\n.navbar-light .navbar-nav .nav-link.active {\n  color: rgba(0, 0, 0, 0.9);\n}\n.navbar-light .navbar-toggler {\n  color: rgba(0, 0, 0, 0.55);\n  border-color: rgba(0, 0, 0, 0.1);\n}\n.navbar-light .navbar-toggler-icon {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 30 30'%3e%3cpath stroke='rgba%280, 0, 0, 0.55%29' stroke-linecap='round' stroke-miterlimit='10' stroke-width='2' d='M4 7h22M4 15h22M4 23h22'/%3e%3c/svg%3e\");\n}\n.navbar-light .navbar-text {\n  color: rgba(0, 0, 0, 0.55);\n}\n.navbar-light .navbar-text a,\n.navbar-light .navbar-text a:hover,\n.navbar-light .navbar-text a:focus {\n  color: rgba(0, 0, 0, 0.9);\n}\n\n.navbar-dark .navbar-brand {\n  color: #fff;\n}\n.navbar-dark .navbar-brand:hover, .navbar-dark .navbar-brand:focus {\n  color: #fff;\n}\n.navbar-dark .navbar-nav .nav-link {\n  color: rgba(255, 255, 255, 0.55);\n}\n.navbar-dark .navbar-nav .nav-link:hover, .navbar-dark .navbar-nav .nav-link:focus {\n  color: rgba(255, 255, 255, 0.75);\n}\n.navbar-dark .navbar-nav .nav-link.disabled {\n  color: rgba(255, 255, 255, 0.25);\n}\n.navbar-dark .navbar-nav .show > .nav-link,\n.navbar-dark .navbar-nav .nav-link.active {\n  color: #fff;\n}\n.navbar-dark .navbar-toggler {\n  color: rgba(255, 255, 255, 0.55);\n  border-color: rgba(255, 255, 255, 0.1);\n}\n.navbar-dark .navbar-toggler-icon {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 30 30'%3e%3cpath stroke='rgba%28255, 255, 255, 0.55%29' stroke-linecap='round' stroke-miterlimit='10' stroke-width='2' d='M4 7h22M4 15h22M4 23h22'/%3e%3c/svg%3e\");\n}\n.navbar-dark .navbar-text {\n  color: rgba(255, 255, 255, 0.55);\n}\n.navbar-dark .navbar-text a,\n.navbar-dark .navbar-text a:hover,\n.navbar-dark .navbar-text a:focus {\n  color: #fff;\n}\n\n.card {\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  min-width: 0;\n  word-wrap: break-word;\n  background-color: #fff;\n  background-clip: border-box;\n  border: 1px solid rgba(0, 0, 0, 0.125);\n  border-radius: 0.25rem;\n}\n.card > hr {\n  margin-right: 0;\n  margin-left: 0;\n}\n.card > .list-group {\n  border-top: inherit;\n  border-bottom: inherit;\n}\n.card > .list-group:first-child {\n  border-top-width: 0;\n  border-top-left-radius: calc(0.25rem - 1px);\n  border-top-right-radius: calc(0.25rem - 1px);\n}\n.card > .list-group:last-child {\n  border-bottom-width: 0;\n  border-bottom-right-radius: calc(0.25rem - 1px);\n  border-bottom-left-radius: calc(0.25rem - 1px);\n}\n.card > .card-header + .list-group,\n.card > .list-group + .card-footer {\n  border-top: 0;\n}\n\n.card-body {\n  flex: 1 1 auto;\n  padding: 1rem 1rem;\n}\n\n.card-title {\n  margin-bottom: 0.5rem;\n}\n\n.card-subtitle {\n  margin-top: -0.25rem;\n  margin-bottom: 0;\n}\n\n.card-text:last-child {\n  margin-bottom: 0;\n}\n\n.card-link + .card-link {\n  margin-left: 1rem;\n}\n\n.card-header {\n  padding: 0.5rem 1rem;\n  margin-bottom: 0;\n  background-color: rgba(0, 0, 0, 0.03);\n  border-bottom: 1px solid rgba(0, 0, 0, 0.125);\n}\n.card-header:first-child {\n  border-radius: calc(0.25rem - 1px) calc(0.25rem - 1px) 0 0;\n}\n\n.card-footer {\n  padding: 0.5rem 1rem;\n  background-color: rgba(0, 0, 0, 0.03);\n  border-top: 1px solid rgba(0, 0, 0, 0.125);\n}\n.card-footer:last-child {\n  border-radius: 0 0 calc(0.25rem - 1px) calc(0.25rem - 1px);\n}\n\n.card-header-tabs {\n  margin-right: -0.5rem;\n  margin-bottom: -0.5rem;\n  margin-left: -0.5rem;\n  border-bottom: 0;\n}\n\n.card-header-pills {\n  margin-right: -0.5rem;\n  margin-left: -0.5rem;\n}\n\n.card-img-overlay {\n  position: absolute;\n  top: 0;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  padding: 1rem;\n  border-radius: calc(0.25rem - 1px);\n}\n\n.card-img,\n.card-img-top,\n.card-img-bottom {\n  width: 100%;\n}\n\n.card-img,\n.card-img-top {\n  border-top-left-radius: calc(0.25rem - 1px);\n  border-top-right-radius: calc(0.25rem - 1px);\n}\n\n.card-img,\n.card-img-bottom {\n  border-bottom-right-radius: calc(0.25rem - 1px);\n  border-bottom-left-radius: calc(0.25rem - 1px);\n}\n\n.card-group > .card {\n  margin-bottom: 0.75rem;\n}\n@media (min-width: 576px) {\n  .card-group {\n    display: flex;\n    flex-flow: row wrap;\n  }\n  .card-group > .card {\n    flex: 1 0 0%;\n    margin-bottom: 0;\n  }\n  .card-group > .card + .card {\n    margin-left: 0;\n    border-left: 0;\n  }\n  .card-group > .card:not(:last-child) {\n    border-top-right-radius: 0;\n    border-bottom-right-radius: 0;\n  }\n  .card-group > .card:not(:last-child) .card-img-top,\n.card-group > .card:not(:last-child) .card-header {\n    border-top-right-radius: 0;\n  }\n  .card-group > .card:not(:last-child) .card-img-bottom,\n.card-group > .card:not(:last-child) .card-footer {\n    border-bottom-right-radius: 0;\n  }\n  .card-group > .card:not(:first-child) {\n    border-top-left-radius: 0;\n    border-bottom-left-radius: 0;\n  }\n  .card-group > .card:not(:first-child) .card-img-top,\n.card-group > .card:not(:first-child) .card-header {\n    border-top-left-radius: 0;\n  }\n  .card-group > .card:not(:first-child) .card-img-bottom,\n.card-group > .card:not(:first-child) .card-footer {\n    border-bottom-left-radius: 0;\n  }\n}\n\n.accordion-button {\n  position: relative;\n  display: flex;\n  align-items: center;\n  width: 100%;\n  padding: 1rem 1.25rem;\n  font-size: 1rem;\n  color: #212529;\n  text-align: left;\n  background-color: #fff;\n  border: 0;\n  border-radius: 0;\n  overflow-anchor: none;\n  transition: color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out, border-radius 0.15s ease;\n}\n@media (prefers-reduced-motion: reduce) {\n  .accordion-button {\n    transition: none;\n  }\n}\n.accordion-button:not(.collapsed) {\n  color: #0c63e4;\n  background-color: #e7f1ff;\n  box-shadow: inset 0 -1px 0 rgba(0, 0, 0, 0.125);\n}\n.accordion-button:not(.collapsed)::after {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='%230c63e4'%3e%3cpath fill-rule='evenodd' d='M1.646 4.646a.5.5 0 0 1 .708 0L8 10.293l5.646-5.647a.5.5 0 0 1 .708.708l-6 6a.5.5 0 0 1-.708 0l-6-6a.5.5 0 0 1 0-.708z'/%3e%3c/svg%3e\");\n  transform: rotate(-180deg);\n}\n.accordion-button::after {\n  flex-shrink: 0;\n  width: 1.25rem;\n  height: 1.25rem;\n  margin-left: auto;\n  content: \"\";\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='%23212529'%3e%3cpath fill-rule='evenodd' d='M1.646 4.646a.5.5 0 0 1 .708 0L8 10.293l5.646-5.647a.5.5 0 0 1 .708.708l-6 6a.5.5 0 0 1-.708 0l-6-6a.5.5 0 0 1 0-.708z'/%3e%3c/svg%3e\");\n  background-repeat: no-repeat;\n  background-size: 1.25rem;\n  transition: transform 0.2s ease-in-out;\n}\n@media (prefers-reduced-motion: reduce) {\n  .accordion-button::after {\n    transition: none;\n  }\n}\n.accordion-button:hover {\n  z-index: 2;\n}\n.accordion-button:focus {\n  z-index: 3;\n  border-color: #86b7fe;\n  outline: 0;\n  box-shadow: 0 0 0 0.25rem rgba(13, 110, 253, 0.25);\n}\n\n.accordion-header {\n  margin-bottom: 0;\n}\n\n.accordion-item {\n  background-color: #fff;\n  border: 1px solid rgba(0, 0, 0, 0.125);\n}\n.accordion-item:first-of-type {\n  border-top-left-radius: 0.25rem;\n  border-top-right-radius: 0.25rem;\n}\n.accordion-item:first-of-type .accordion-button {\n  border-top-left-radius: calc(0.25rem - 1px);\n  border-top-right-radius: calc(0.25rem - 1px);\n}\n.accordion-item:not(:first-of-type) {\n  border-top: 0;\n}\n.accordion-item:last-of-type {\n  border-bottom-right-radius: 0.25rem;\n  border-bottom-left-radius: 0.25rem;\n}\n.accordion-item:last-of-type .accordion-button.collapsed {\n  border-bottom-right-radius: calc(0.25rem - 1px);\n  border-bottom-left-radius: calc(0.25rem - 1px);\n}\n.accordion-item:last-of-type .accordion-collapse {\n  border-bottom-right-radius: 0.25rem;\n  border-bottom-left-radius: 0.25rem;\n}\n\n.accordion-body {\n  padding: 1rem 1.25rem;\n}\n\n.accordion-flush .accordion-collapse {\n  border-width: 0;\n}\n.accordion-flush .accordion-item {\n  border-right: 0;\n  border-left: 0;\n  border-radius: 0;\n}\n.accordion-flush .accordion-item:first-child {\n  border-top: 0;\n}\n.accordion-flush .accordion-item:last-child {\n  border-bottom: 0;\n}\n.accordion-flush .accordion-item .accordion-button {\n  border-radius: 0;\n}\n\n.breadcrumb {\n  display: flex;\n  flex-wrap: wrap;\n  padding: 0 0;\n  margin-bottom: 1rem;\n  list-style: none;\n}\n\n.breadcrumb-item + .breadcrumb-item {\n  padding-left: 0.5rem;\n}\n.breadcrumb-item + .breadcrumb-item::before {\n  float: left;\n  padding-right: 0.5rem;\n  color: #6c757d;\n  content: var(--bs-breadcrumb-divider, \"/\") /* rtl: var(--bs-breadcrumb-divider, \"/\") */;\n}\n.breadcrumb-item.active {\n  color: #6c757d;\n}\n\n.pagination {\n  display: flex;\n  padding-left: 0;\n  list-style: none;\n}\n\n.page-link {\n  position: relative;\n  display: block;\n  color: #0d6efd;\n  text-decoration: none;\n  background-color: #fff;\n  border: 1px solid #dee2e6;\n  transition: color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n}\n@media (prefers-reduced-motion: reduce) {\n  .page-link {\n    transition: none;\n  }\n}\n.page-link:hover {\n  z-index: 2;\n  color: #0a58ca;\n  background-color: #e9ecef;\n  border-color: #dee2e6;\n}\n.page-link:focus {\n  z-index: 3;\n  color: #0a58ca;\n  background-color: #e9ecef;\n  outline: 0;\n  box-shadow: 0 0 0 0.25rem rgba(13, 110, 253, 0.25);\n}\n\n.page-item:not(:first-child) .page-link {\n  margin-left: -1px;\n}\n.page-item.active .page-link {\n  z-index: 3;\n  color: #fff;\n  background-color: #0d6efd;\n  border-color: #0d6efd;\n}\n.page-item.disabled .page-link {\n  color: #6c757d;\n  pointer-events: none;\n  background-color: #fff;\n  border-color: #dee2e6;\n}\n\n.page-link {\n  padding: 0.375rem 0.75rem;\n}\n\n.page-item:first-child .page-link {\n  border-top-left-radius: 0.25rem;\n  border-bottom-left-radius: 0.25rem;\n}\n.page-item:last-child .page-link {\n  border-top-right-radius: 0.25rem;\n  border-bottom-right-radius: 0.25rem;\n}\n\n.pagination-lg .page-link {\n  padding: 0.75rem 1.5rem;\n  font-size: 1.25rem;\n}\n.pagination-lg .page-item:first-child .page-link {\n  border-top-left-radius: 0.3rem;\n  border-bottom-left-radius: 0.3rem;\n}\n.pagination-lg .page-item:last-child .page-link {\n  border-top-right-radius: 0.3rem;\n  border-bottom-right-radius: 0.3rem;\n}\n\n.pagination-sm .page-link {\n  padding: 0.25rem 0.5rem;\n  font-size: 0.875rem;\n}\n.pagination-sm .page-item:first-child .page-link {\n  border-top-left-radius: 0.2rem;\n  border-bottom-left-radius: 0.2rem;\n}\n.pagination-sm .page-item:last-child .page-link {\n  border-top-right-radius: 0.2rem;\n  border-bottom-right-radius: 0.2rem;\n}\n\n.badge {\n  display: inline-block;\n  padding: 0.35em 0.65em;\n  font-size: 0.75em;\n  font-weight: 700;\n  line-height: 1;\n  color: #fff;\n  text-align: center;\n  white-space: nowrap;\n  vertical-align: baseline;\n  border-radius: 0.25rem;\n}\n.badge:empty {\n  display: none;\n}\n\n.btn .badge {\n  position: relative;\n  top: -1px;\n}\n\n.alert {\n  position: relative;\n  padding: 1rem 1rem;\n  margin-bottom: 1rem;\n  border: 1px solid transparent;\n  border-radius: 0.25rem;\n}\n\n.alert-heading {\n  color: inherit;\n}\n\n.alert-link {\n  font-weight: 700;\n}\n\n.alert-dismissible {\n  padding-right: 3rem;\n}\n.alert-dismissible .btn-close {\n  position: absolute;\n  top: 0;\n  right: 0;\n  z-index: 2;\n  padding: 1.25rem 1rem;\n}\n\n.alert-primary {\n  color: #084298;\n  background-color: #cfe2ff;\n  border-color: #b6d4fe;\n}\n.alert-primary .alert-link {\n  color: #06357a;\n}\n\n.alert-secondary {\n  color: #41464b;\n  background-color: #e2e3e5;\n  border-color: #d3d6d8;\n}\n.alert-secondary .alert-link {\n  color: #34383c;\n}\n\n.alert-success {\n  color: #0f5132;\n  background-color: #d1e7dd;\n  border-color: #badbcc;\n}\n.alert-success .alert-link {\n  color: #0c4128;\n}\n\n.alert-info {\n  color: #055160;\n  background-color: #cff4fc;\n  border-color: #b6effb;\n}\n.alert-info .alert-link {\n  color: #04414d;\n}\n\n.alert-warning {\n  color: #664d03;\n  background-color: #fff3cd;\n  border-color: #ffecb5;\n}\n.alert-warning .alert-link {\n  color: #523e02;\n}\n\n.alert-danger {\n  color: #842029;\n  background-color: #f8d7da;\n  border-color: #f5c2c7;\n}\n.alert-danger .alert-link {\n  color: #6a1a21;\n}\n\n.alert-light {\n  color: #636464;\n  background-color: #fefefe;\n  border-color: #fdfdfe;\n}\n.alert-light .alert-link {\n  color: #4f5050;\n}\n\n.alert-dark {\n  color: #141619;\n  background-color: #d3d3d4;\n  border-color: #bcbebf;\n}\n.alert-dark .alert-link {\n  color: #101214;\n}\n\n@-webkit-keyframes progress-bar-stripes {\n  0% {\n    background-position-x: 1rem;\n  }\n}\n\n@keyframes progress-bar-stripes {\n  0% {\n    background-position-x: 1rem;\n  }\n}\n.progress {\n  display: flex;\n  height: 1rem;\n  overflow: hidden;\n  font-size: 0.75rem;\n  background-color: #e9ecef;\n  border-radius: 0.25rem;\n}\n\n.progress-bar {\n  display: flex;\n  flex-direction: column;\n  justify-content: center;\n  overflow: hidden;\n  color: #fff;\n  text-align: center;\n  white-space: nowrap;\n  background-color: #0d6efd;\n  transition: width 0.6s ease;\n}\n@media (prefers-reduced-motion: reduce) {\n  .progress-bar {\n    transition: none;\n  }\n}\n\n.progress-bar-striped {\n  background-image: linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent);\n  background-size: 1rem 1rem;\n}\n\n.progress-bar-animated {\n  -webkit-animation: 1s linear infinite progress-bar-stripes;\n  animation: 1s linear infinite progress-bar-stripes;\n}\n@media (prefers-reduced-motion: reduce) {\n  .progress-bar-animated {\n    -webkit-animation: none;\n    animation: none;\n  }\n}\n\n.list-group {\n  display: flex;\n  flex-direction: column;\n  padding-left: 0;\n  margin-bottom: 0;\n  border-radius: 0.25rem;\n}\n\n.list-group-numbered {\n  list-style-type: none;\n  counter-reset: section;\n}\n.list-group-numbered > li::before {\n  content: counters(section, \".\") \". \";\n  counter-increment: section;\n}\n\n.list-group-item-action {\n  width: 100%;\n  color: #495057;\n  text-align: inherit;\n}\n.list-group-item-action:hover, .list-group-item-action:focus {\n  z-index: 1;\n  color: #495057;\n  text-decoration: none;\n  background-color: #f8f9fa;\n}\n.list-group-item-action:active {\n  color: #212529;\n  background-color: #e9ecef;\n}\n\n.list-group-item {\n  position: relative;\n  display: block;\n  padding: 0.5rem 1rem;\n  color: #212529;\n  text-decoration: none;\n  background-color: #fff;\n  border: 1px solid rgba(0, 0, 0, 0.125);\n}\n.list-group-item:first-child {\n  border-top-left-radius: inherit;\n  border-top-right-radius: inherit;\n}\n.list-group-item:last-child {\n  border-bottom-right-radius: inherit;\n  border-bottom-left-radius: inherit;\n}\n.list-group-item.disabled, .list-group-item:disabled {\n  color: #6c757d;\n  pointer-events: none;\n  background-color: #fff;\n}\n.list-group-item.active {\n  z-index: 2;\n  color: #fff;\n  background-color: #0d6efd;\n  border-color: #0d6efd;\n}\n.list-group-item + .list-group-item {\n  border-top-width: 0;\n}\n.list-group-item + .list-group-item.active {\n  margin-top: -1px;\n  border-top-width: 1px;\n}\n\n.list-group-horizontal {\n  flex-direction: row;\n}\n.list-group-horizontal > .list-group-item:first-child {\n  border-bottom-left-radius: 0.25rem;\n  border-top-right-radius: 0;\n}\n.list-group-horizontal > .list-group-item:last-child {\n  border-top-right-radius: 0.25rem;\n  border-bottom-left-radius: 0;\n}\n.list-group-horizontal > .list-group-item.active {\n  margin-top: 0;\n}\n.list-group-horizontal > .list-group-item + .list-group-item {\n  border-top-width: 1px;\n  border-left-width: 0;\n}\n.list-group-horizontal > .list-group-item + .list-group-item.active {\n  margin-left: -1px;\n  border-left-width: 1px;\n}\n\n@media (min-width: 576px) {\n  .list-group-horizontal-sm {\n    flex-direction: row;\n  }\n  .list-group-horizontal-sm > .list-group-item:first-child {\n    border-bottom-left-radius: 0.25rem;\n    border-top-right-radius: 0;\n  }\n  .list-group-horizontal-sm > .list-group-item:last-child {\n    border-top-right-radius: 0.25rem;\n    border-bottom-left-radius: 0;\n  }\n  .list-group-horizontal-sm > .list-group-item.active {\n    margin-top: 0;\n  }\n  .list-group-horizontal-sm > .list-group-item + .list-group-item {\n    border-top-width: 1px;\n    border-left-width: 0;\n  }\n  .list-group-horizontal-sm > .list-group-item + .list-group-item.active {\n    margin-left: -1px;\n    border-left-width: 1px;\n  }\n}\n@media (min-width: 768px) {\n  .list-group-horizontal-md {\n    flex-direction: row;\n  }\n  .list-group-horizontal-md > .list-group-item:first-child {\n    border-bottom-left-radius: 0.25rem;\n    border-top-right-radius: 0;\n  }\n  .list-group-horizontal-md > .list-group-item:last-child {\n    border-top-right-radius: 0.25rem;\n    border-bottom-left-radius: 0;\n  }\n  .list-group-horizontal-md > .list-group-item.active {\n    margin-top: 0;\n  }\n  .list-group-horizontal-md > .list-group-item + .list-group-item {\n    border-top-width: 1px;\n    border-left-width: 0;\n  }\n  .list-group-horizontal-md > .list-group-item + .list-group-item.active {\n    margin-left: -1px;\n    border-left-width: 1px;\n  }\n}\n@media (min-width: 992px) {\n  .list-group-horizontal-lg {\n    flex-direction: row;\n  }\n  .list-group-horizontal-lg > .list-group-item:first-child {\n    border-bottom-left-radius: 0.25rem;\n    border-top-right-radius: 0;\n  }\n  .list-group-horizontal-lg > .list-group-item:last-child {\n    border-top-right-radius: 0.25rem;\n    border-bottom-left-radius: 0;\n  }\n  .list-group-horizontal-lg > .list-group-item.active {\n    margin-top: 0;\n  }\n  .list-group-horizontal-lg > .list-group-item + .list-group-item {\n    border-top-width: 1px;\n    border-left-width: 0;\n  }\n  .list-group-horizontal-lg > .list-group-item + .list-group-item.active {\n    margin-left: -1px;\n    border-left-width: 1px;\n  }\n}\n@media (min-width: 1200px) {\n  .list-group-horizontal-xl {\n    flex-direction: row;\n  }\n  .list-group-horizontal-xl > .list-group-item:first-child {\n    border-bottom-left-radius: 0.25rem;\n    border-top-right-radius: 0;\n  }\n  .list-group-horizontal-xl > .list-group-item:last-child {\n    border-top-right-radius: 0.25rem;\n    border-bottom-left-radius: 0;\n  }\n  .list-group-horizontal-xl > .list-group-item.active {\n    margin-top: 0;\n  }\n  .list-group-horizontal-xl > .list-group-item + .list-group-item {\n    border-top-width: 1px;\n    border-left-width: 0;\n  }\n  .list-group-horizontal-xl > .list-group-item + .list-group-item.active {\n    margin-left: -1px;\n    border-left-width: 1px;\n  }\n}\n@media (min-width: 1400px) {\n  .list-group-horizontal-xxl {\n    flex-direction: row;\n  }\n  .list-group-horizontal-xxl > .list-group-item:first-child {\n    border-bottom-left-radius: 0.25rem;\n    border-top-right-radius: 0;\n  }\n  .list-group-horizontal-xxl > .list-group-item:last-child {\n    border-top-right-radius: 0.25rem;\n    border-bottom-left-radius: 0;\n  }\n  .list-group-horizontal-xxl > .list-group-item.active {\n    margin-top: 0;\n  }\n  .list-group-horizontal-xxl > .list-group-item + .list-group-item {\n    border-top-width: 1px;\n    border-left-width: 0;\n  }\n  .list-group-horizontal-xxl > .list-group-item + .list-group-item.active {\n    margin-left: -1px;\n    border-left-width: 1px;\n  }\n}\n.list-group-flush {\n  border-radius: 0;\n}\n.list-group-flush > .list-group-item {\n  border-width: 0 0 1px;\n}\n.list-group-flush > .list-group-item:last-child {\n  border-bottom-width: 0;\n}\n\n.list-group-item-primary {\n  color: #084298;\n  background-color: #cfe2ff;\n}\n.list-group-item-primary.list-group-item-action:hover, .list-group-item-primary.list-group-item-action:focus {\n  color: #084298;\n  background-color: #bacbe6;\n}\n.list-group-item-primary.list-group-item-action.active {\n  color: #fff;\n  background-color: #084298;\n  border-color: #084298;\n}\n\n.list-group-item-secondary {\n  color: #41464b;\n  background-color: #e2e3e5;\n}\n.list-group-item-secondary.list-group-item-action:hover, .list-group-item-secondary.list-group-item-action:focus {\n  color: #41464b;\n  background-color: #cbccce;\n}\n.list-group-item-secondary.list-group-item-action.active {\n  color: #fff;\n  background-color: #41464b;\n  border-color: #41464b;\n}\n\n.list-group-item-success {\n  color: #0f5132;\n  background-color: #d1e7dd;\n}\n.list-group-item-success.list-group-item-action:hover, .list-group-item-success.list-group-item-action:focus {\n  color: #0f5132;\n  background-color: #bcd0c7;\n}\n.list-group-item-success.list-group-item-action.active {\n  color: #fff;\n  background-color: #0f5132;\n  border-color: #0f5132;\n}\n\n.list-group-item-info {\n  color: #055160;\n  background-color: #cff4fc;\n}\n.list-group-item-info.list-group-item-action:hover, .list-group-item-info.list-group-item-action:focus {\n  color: #055160;\n  background-color: #badce3;\n}\n.list-group-item-info.list-group-item-action.active {\n  color: #fff;\n  background-color: #055160;\n  border-color: #055160;\n}\n\n.list-group-item-warning {\n  color: #664d03;\n  background-color: #fff3cd;\n}\n.list-group-item-warning.list-group-item-action:hover, .list-group-item-warning.list-group-item-action:focus {\n  color: #664d03;\n  background-color: #e6dbb9;\n}\n.list-group-item-warning.list-group-item-action.active {\n  color: #fff;\n  background-color: #664d03;\n  border-color: #664d03;\n}\n\n.list-group-item-danger {\n  color: #842029;\n  background-color: #f8d7da;\n}\n.list-group-item-danger.list-group-item-action:hover, .list-group-item-danger.list-group-item-action:focus {\n  color: #842029;\n  background-color: #dfc2c4;\n}\n.list-group-item-danger.list-group-item-action.active {\n  color: #fff;\n  background-color: #842029;\n  border-color: #842029;\n}\n\n.list-group-item-light {\n  color: #636464;\n  background-color: #fefefe;\n}\n.list-group-item-light.list-group-item-action:hover, .list-group-item-light.list-group-item-action:focus {\n  color: #636464;\n  background-color: #e5e5e5;\n}\n.list-group-item-light.list-group-item-action.active {\n  color: #fff;\n  background-color: #636464;\n  border-color: #636464;\n}\n\n.list-group-item-dark {\n  color: #141619;\n  background-color: #d3d3d4;\n}\n.list-group-item-dark.list-group-item-action:hover, .list-group-item-dark.list-group-item-action:focus {\n  color: #141619;\n  background-color: #bebebf;\n}\n.list-group-item-dark.list-group-item-action.active {\n  color: #fff;\n  background-color: #141619;\n  border-color: #141619;\n}\n\n.btn-close {\n  box-sizing: content-box;\n  width: 1em;\n  height: 1em;\n  padding: 0.25em 0.25em;\n  color: #000;\n  background: transparent url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='%23000'%3e%3cpath d='M.293.293a1 1 0 011.414 0L8 6.586 14.293.293a1 1 0 111.414 1.414L9.414 8l6.293 6.293a1 1 0 01-1.414 1.414L8 9.414l-6.293 6.293a1 1 0 01-1.414-1.414L6.586 8 .293 1.707a1 1 0 010-1.414z'/%3e%3c/svg%3e\") center/1em auto no-repeat;\n  border: 0;\n  border-radius: 0.25rem;\n  opacity: 0.5;\n}\n.btn-close:hover {\n  color: #000;\n  text-decoration: none;\n  opacity: 0.75;\n}\n.btn-close:focus {\n  outline: 0;\n  box-shadow: 0 0 0 0.25rem rgba(13, 110, 253, 0.25);\n  opacity: 1;\n}\n.btn-close:disabled, .btn-close.disabled {\n  pointer-events: none;\n  -webkit-user-select: none;\n  -moz-user-select: none;\n  user-select: none;\n  opacity: 0.25;\n}\n\n.btn-close-white {\n  filter: invert(1) grayscale(100%) brightness(200%);\n}\n\n.toast {\n  width: 350px;\n  max-width: 100%;\n  font-size: 0.875rem;\n  pointer-events: auto;\n  background-color: rgba(255, 255, 255, 0.85);\n  background-clip: padding-box;\n  border: 1px solid rgba(0, 0, 0, 0.1);\n  box-shadow: 0 0.5rem 1rem rgba(0, 0, 0, 0.15);\n  border-radius: 0.25rem;\n}\n.toast.showing {\n  opacity: 0;\n}\n.toast:not(.show) {\n  display: none;\n}\n\n.toast-container {\n  width: -webkit-max-content;\n  width: -moz-max-content;\n  width: max-content;\n  max-width: 100%;\n  pointer-events: none;\n}\n.toast-container > :not(:last-child) {\n  margin-bottom: 0.75rem;\n}\n\n.toast-header {\n  display: flex;\n  align-items: center;\n  padding: 0.5rem 0.75rem;\n  color: #6c757d;\n  background-color: rgba(255, 255, 255, 0.85);\n  background-clip: padding-box;\n  border-bottom: 1px solid rgba(0, 0, 0, 0.05);\n  border-top-left-radius: calc(0.25rem - 1px);\n  border-top-right-radius: calc(0.25rem - 1px);\n}\n.toast-header .btn-close {\n  margin-right: -0.375rem;\n  margin-left: 0.75rem;\n}\n\n.toast-body {\n  padding: 0.75rem;\n  word-wrap: break-word;\n}\n\n.modal {\n  position: fixed;\n  top: 0;\n  left: 0;\n  z-index: 1055;\n  display: none;\n  width: 100%;\n  height: 100%;\n  overflow-x: hidden;\n  overflow-y: auto;\n  outline: 0;\n}\n\n.modal-dialog {\n  position: relative;\n  width: auto;\n  margin: 0.5rem;\n  pointer-events: none;\n}\n.modal.fade .modal-dialog {\n  transition: transform 0.3s ease-out;\n  transform: translate(0, -50px);\n}\n@media (prefers-reduced-motion: reduce) {\n  .modal.fade .modal-dialog {\n    transition: none;\n  }\n}\n.modal.show .modal-dialog {\n  transform: none;\n}\n.modal.modal-static .modal-dialog {\n  transform: scale(1.02);\n}\n\n.modal-dialog-scrollable {\n  height: calc(100% - 1rem);\n}\n.modal-dialog-scrollable .modal-content {\n  max-height: 100%;\n  overflow: hidden;\n}\n.modal-dialog-scrollable .modal-body {\n  overflow-y: auto;\n}\n\n.modal-dialog-centered {\n  display: flex;\n  align-items: center;\n  min-height: calc(100% - 1rem);\n}\n\n.modal-content {\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  width: 100%;\n  pointer-events: auto;\n  background-color: #fff;\n  background-clip: padding-box;\n  border: 1px solid rgba(0, 0, 0, 0.2);\n  border-radius: 0.3rem;\n  outline: 0;\n}\n\n.modal-backdrop {\n  position: fixed;\n  top: 0;\n  left: 0;\n  z-index: 1050;\n  width: 100vw;\n  height: 100vh;\n  background-color: #000;\n}\n.modal-backdrop.fade {\n  opacity: 0;\n}\n.modal-backdrop.show {\n  opacity: 0.5;\n}\n\n.modal-header {\n  display: flex;\n  flex-shrink: 0;\n  align-items: center;\n  justify-content: space-between;\n  padding: 1rem 1rem;\n  border-bottom: 1px solid #dee2e6;\n  border-top-left-radius: calc(0.3rem - 1px);\n  border-top-right-radius: calc(0.3rem - 1px);\n}\n.modal-header .btn-close {\n  padding: 0.5rem 0.5rem;\n  margin: -0.5rem -0.5rem -0.5rem auto;\n}\n\n.modal-title {\n  margin-bottom: 0;\n  line-height: 1.5;\n}\n\n.modal-body {\n  position: relative;\n  flex: 1 1 auto;\n  padding: 1rem;\n}\n\n.modal-footer {\n  display: flex;\n  flex-wrap: wrap;\n  flex-shrink: 0;\n  align-items: center;\n  justify-content: flex-end;\n  padding: 0.75rem;\n  border-top: 1px solid #dee2e6;\n  border-bottom-right-radius: calc(0.3rem - 1px);\n  border-bottom-left-radius: calc(0.3rem - 1px);\n}\n.modal-footer > * {\n  margin: 0.25rem;\n}\n\n@media (min-width: 576px) {\n  .modal-dialog {\n    max-width: 500px;\n    margin: 1.75rem auto;\n  }\n\n  .modal-dialog-scrollable {\n    height: calc(100% - 3.5rem);\n  }\n\n  .modal-dialog-centered {\n    min-height: calc(100% - 3.5rem);\n  }\n\n  .modal-sm {\n    max-width: 300px;\n  }\n}\n@media (min-width: 992px) {\n  .modal-lg,\n.modal-xl {\n    max-width: 800px;\n  }\n}\n@media (min-width: 1200px) {\n  .modal-xl {\n    max-width: 1140px;\n  }\n}\n.modal-fullscreen {\n  width: 100vw;\n  max-width: none;\n  height: 100%;\n  margin: 0;\n}\n.modal-fullscreen .modal-content {\n  height: 100%;\n  border: 0;\n  border-radius: 0;\n}\n.modal-fullscreen .modal-header {\n  border-radius: 0;\n}\n.modal-fullscreen .modal-body {\n  overflow-y: auto;\n}\n.modal-fullscreen .modal-footer {\n  border-radius: 0;\n}\n\n@media (max-width: 575.98px) {\n  .modal-fullscreen-sm-down {\n    width: 100vw;\n    max-width: none;\n    height: 100%;\n    margin: 0;\n  }\n  .modal-fullscreen-sm-down .modal-content {\n    height: 100%;\n    border: 0;\n    border-radius: 0;\n  }\n  .modal-fullscreen-sm-down .modal-header {\n    border-radius: 0;\n  }\n  .modal-fullscreen-sm-down .modal-body {\n    overflow-y: auto;\n  }\n  .modal-fullscreen-sm-down .modal-footer {\n    border-radius: 0;\n  }\n}\n@media (max-width: 767.98px) {\n  .modal-fullscreen-md-down {\n    width: 100vw;\n    max-width: none;\n    height: 100%;\n    margin: 0;\n  }\n  .modal-fullscreen-md-down .modal-content {\n    height: 100%;\n    border: 0;\n    border-radius: 0;\n  }\n  .modal-fullscreen-md-down .modal-header {\n    border-radius: 0;\n  }\n  .modal-fullscreen-md-down .modal-body {\n    overflow-y: auto;\n  }\n  .modal-fullscreen-md-down .modal-footer {\n    border-radius: 0;\n  }\n}\n@media (max-width: 991.98px) {\n  .modal-fullscreen-lg-down {\n    width: 100vw;\n    max-width: none;\n    height: 100%;\n    margin: 0;\n  }\n  .modal-fullscreen-lg-down .modal-content {\n    height: 100%;\n    border: 0;\n    border-radius: 0;\n  }\n  .modal-fullscreen-lg-down .modal-header {\n    border-radius: 0;\n  }\n  .modal-fullscreen-lg-down .modal-body {\n    overflow-y: auto;\n  }\n  .modal-fullscreen-lg-down .modal-footer {\n    border-radius: 0;\n  }\n}\n@media (max-width: 1199.98px) {\n  .modal-fullscreen-xl-down {\n    width: 100vw;\n    max-width: none;\n    height: 100%;\n    margin: 0;\n  }\n  .modal-fullscreen-xl-down .modal-content {\n    height: 100%;\n    border: 0;\n    border-radius: 0;\n  }\n  .modal-fullscreen-xl-down .modal-header {\n    border-radius: 0;\n  }\n  .modal-fullscreen-xl-down .modal-body {\n    overflow-y: auto;\n  }\n  .modal-fullscreen-xl-down .modal-footer {\n    border-radius: 0;\n  }\n}\n@media (max-width: 1399.98px) {\n  .modal-fullscreen-xxl-down {\n    width: 100vw;\n    max-width: none;\n    height: 100%;\n    margin: 0;\n  }\n  .modal-fullscreen-xxl-down .modal-content {\n    height: 100%;\n    border: 0;\n    border-radius: 0;\n  }\n  .modal-fullscreen-xxl-down .modal-header {\n    border-radius: 0;\n  }\n  .modal-fullscreen-xxl-down .modal-body {\n    overflow-y: auto;\n  }\n  .modal-fullscreen-xxl-down .modal-footer {\n    border-radius: 0;\n  }\n}\n.tooltip {\n  position: absolute;\n  z-index: 1080;\n  display: block;\n  margin: 0;\n  font-family: var(--bs-font-sans-serif);\n  font-style: normal;\n  font-weight: 400;\n  line-height: 1.5;\n  text-align: left;\n  text-align: start;\n  text-decoration: none;\n  text-shadow: none;\n  text-transform: none;\n  letter-spacing: normal;\n  word-break: normal;\n  word-spacing: normal;\n  white-space: normal;\n  line-break: auto;\n  font-size: 0.875rem;\n  word-wrap: break-word;\n  opacity: 0;\n}\n.tooltip.show {\n  opacity: 0.9;\n}\n.tooltip .tooltip-arrow {\n  position: absolute;\n  display: block;\n  width: 0.8rem;\n  height: 0.4rem;\n}\n.tooltip .tooltip-arrow::before {\n  position: absolute;\n  content: \"\";\n  border-color: transparent;\n  border-style: solid;\n}\n\n.bs-tooltip-top, .bs-tooltip-auto[data-popper-placement^=top] {\n  padding: 0.4rem 0;\n}\n.bs-tooltip-top .tooltip-arrow, .bs-tooltip-auto[data-popper-placement^=top] .tooltip-arrow {\n  bottom: 0;\n}\n.bs-tooltip-top .tooltip-arrow::before, .bs-tooltip-auto[data-popper-placement^=top] .tooltip-arrow::before {\n  top: -1px;\n  border-width: 0.4rem 0.4rem 0;\n  border-top-color: #000;\n}\n\n.bs-tooltip-end, .bs-tooltip-auto[data-popper-placement^=right] {\n  padding: 0 0.4rem;\n}\n.bs-tooltip-end .tooltip-arrow, .bs-tooltip-auto[data-popper-placement^=right] .tooltip-arrow {\n  left: 0;\n  width: 0.4rem;\n  height: 0.8rem;\n}\n.bs-tooltip-end .tooltip-arrow::before, .bs-tooltip-auto[data-popper-placement^=right] .tooltip-arrow::before {\n  right: -1px;\n  border-width: 0.4rem 0.4rem 0.4rem 0;\n  border-right-color: #000;\n}\n\n.bs-tooltip-bottom, .bs-tooltip-auto[data-popper-placement^=bottom] {\n  padding: 0.4rem 0;\n}\n.bs-tooltip-bottom .tooltip-arrow, .bs-tooltip-auto[data-popper-placement^=bottom] .tooltip-arrow {\n  top: 0;\n}\n.bs-tooltip-bottom .tooltip-arrow::before, .bs-tooltip-auto[data-popper-placement^=bottom] .tooltip-arrow::before {\n  bottom: -1px;\n  border-width: 0 0.4rem 0.4rem;\n  border-bottom-color: #000;\n}\n\n.bs-tooltip-start, .bs-tooltip-auto[data-popper-placement^=left] {\n  padding: 0 0.4rem;\n}\n.bs-tooltip-start .tooltip-arrow, .bs-tooltip-auto[data-popper-placement^=left] .tooltip-arrow {\n  right: 0;\n  width: 0.4rem;\n  height: 0.8rem;\n}\n.bs-tooltip-start .tooltip-arrow::before, .bs-tooltip-auto[data-popper-placement^=left] .tooltip-arrow::before {\n  left: -1px;\n  border-width: 0.4rem 0 0.4rem 0.4rem;\n  border-left-color: #000;\n}\n\n.tooltip-inner {\n  max-width: 200px;\n  padding: 0.25rem 0.5rem;\n  color: #fff;\n  text-align: center;\n  background-color: #000;\n  border-radius: 0.25rem;\n}\n\n.popover {\n  position: absolute;\n  top: 0;\n  left: 0 /* rtl:ignore */;\n  z-index: 1070;\n  display: block;\n  max-width: 276px;\n  font-family: var(--bs-font-sans-serif);\n  font-style: normal;\n  font-weight: 400;\n  line-height: 1.5;\n  text-align: left;\n  text-align: start;\n  text-decoration: none;\n  text-shadow: none;\n  text-transform: none;\n  letter-spacing: normal;\n  word-break: normal;\n  word-spacing: normal;\n  white-space: normal;\n  line-break: auto;\n  font-size: 0.875rem;\n  word-wrap: break-word;\n  background-color: #fff;\n  background-clip: padding-box;\n  border: 1px solid rgba(0, 0, 0, 0.2);\n  border-radius: 0.3rem;\n}\n.popover .popover-arrow {\n  position: absolute;\n  display: block;\n  width: 1rem;\n  height: 0.5rem;\n}\n.popover .popover-arrow::before, .popover .popover-arrow::after {\n  position: absolute;\n  display: block;\n  content: \"\";\n  border-color: transparent;\n  border-style: solid;\n}\n\n.bs-popover-top > .popover-arrow, .bs-popover-auto[data-popper-placement^=top] > .popover-arrow {\n  bottom: calc(-0.5rem - 1px);\n}\n.bs-popover-top > .popover-arrow::before, .bs-popover-auto[data-popper-placement^=top] > .popover-arrow::before {\n  bottom: 0;\n  border-width: 0.5rem 0.5rem 0;\n  border-top-color: rgba(0, 0, 0, 0.25);\n}\n.bs-popover-top > .popover-arrow::after, .bs-popover-auto[data-popper-placement^=top] > .popover-arrow::after {\n  bottom: 1px;\n  border-width: 0.5rem 0.5rem 0;\n  border-top-color: #fff;\n}\n\n.bs-popover-end > .popover-arrow, .bs-popover-auto[data-popper-placement^=right] > .popover-arrow {\n  left: calc(-0.5rem - 1px);\n  width: 0.5rem;\n  height: 1rem;\n}\n.bs-popover-end > .popover-arrow::before, .bs-popover-auto[data-popper-placement^=right] > .popover-arrow::before {\n  left: 0;\n  border-width: 0.5rem 0.5rem 0.5rem 0;\n  border-right-color: rgba(0, 0, 0, 0.25);\n}\n.bs-popover-end > .popover-arrow::after, .bs-popover-auto[data-popper-placement^=right] > .popover-arrow::after {\n  left: 1px;\n  border-width: 0.5rem 0.5rem 0.5rem 0;\n  border-right-color: #fff;\n}\n\n.bs-popover-bottom > .popover-arrow, .bs-popover-auto[data-popper-placement^=bottom] > .popover-arrow {\n  top: calc(-0.5rem - 1px);\n}\n.bs-popover-bottom > .popover-arrow::before, .bs-popover-auto[data-popper-placement^=bottom] > .popover-arrow::before {\n  top: 0;\n  border-width: 0 0.5rem 0.5rem 0.5rem;\n  border-bottom-color: rgba(0, 0, 0, 0.25);\n}\n.bs-popover-bottom > .popover-arrow::after, .bs-popover-auto[data-popper-placement^=bottom] > .popover-arrow::after {\n  top: 1px;\n  border-width: 0 0.5rem 0.5rem 0.5rem;\n  border-bottom-color: #fff;\n}\n.bs-popover-bottom .popover-header::before, .bs-popover-auto[data-popper-placement^=bottom] .popover-header::before {\n  position: absolute;\n  top: 0;\n  left: 50%;\n  display: block;\n  width: 1rem;\n  margin-left: -0.5rem;\n  content: \"\";\n  border-bottom: 1px solid #f0f0f0;\n}\n\n.bs-popover-start > .popover-arrow, .bs-popover-auto[data-popper-placement^=left] > .popover-arrow {\n  right: calc(-0.5rem - 1px);\n  width: 0.5rem;\n  height: 1rem;\n}\n.bs-popover-start > .popover-arrow::before, .bs-popover-auto[data-popper-placement^=left] > .popover-arrow::before {\n  right: 0;\n  border-width: 0.5rem 0 0.5rem 0.5rem;\n  border-left-color: rgba(0, 0, 0, 0.25);\n}\n.bs-popover-start > .popover-arrow::after, .bs-popover-auto[data-popper-placement^=left] > .popover-arrow::after {\n  right: 1px;\n  border-width: 0.5rem 0 0.5rem 0.5rem;\n  border-left-color: #fff;\n}\n\n.popover-header {\n  padding: 0.5rem 1rem;\n  margin-bottom: 0;\n  font-size: 1rem;\n  background-color: #f0f0f0;\n  border-bottom: 1px solid rgba(0, 0, 0, 0.2);\n  border-top-left-radius: calc(0.3rem - 1px);\n  border-top-right-radius: calc(0.3rem - 1px);\n}\n.popover-header:empty {\n  display: none;\n}\n\n.popover-body {\n  padding: 1rem 1rem;\n  color: #212529;\n}\n\n.carousel {\n  position: relative;\n}\n\n.carousel.pointer-event {\n  touch-action: pan-y;\n}\n\n.carousel-inner {\n  position: relative;\n  width: 100%;\n  overflow: hidden;\n}\n.carousel-inner::after {\n  display: block;\n  clear: both;\n  content: \"\";\n}\n\n.carousel-item {\n  position: relative;\n  display: none;\n  float: left;\n  width: 100%;\n  margin-right: -100%;\n  -webkit-backface-visibility: hidden;\n  backface-visibility: hidden;\n  transition: transform 0.6s ease-in-out;\n}\n@media (prefers-reduced-motion: reduce) {\n  .carousel-item {\n    transition: none;\n  }\n}\n\n.carousel-item.active,\n.carousel-item-next,\n.carousel-item-prev {\n  display: block;\n}\n\n/* rtl:begin:ignore */\n.carousel-item-next:not(.carousel-item-start),\n.active.carousel-item-end {\n  transform: translateX(100%);\n}\n\n.carousel-item-prev:not(.carousel-item-end),\n.active.carousel-item-start {\n  transform: translateX(-100%);\n}\n\n/* rtl:end:ignore */\n.carousel-fade .carousel-item {\n  opacity: 0;\n  transition-property: opacity;\n  transform: none;\n}\n.carousel-fade .carousel-item.active,\n.carousel-fade .carousel-item-next.carousel-item-start,\n.carousel-fade .carousel-item-prev.carousel-item-end {\n  z-index: 1;\n  opacity: 1;\n}\n.carousel-fade .active.carousel-item-start,\n.carousel-fade .active.carousel-item-end {\n  z-index: 0;\n  opacity: 0;\n  transition: opacity 0s 0.6s;\n}\n@media (prefers-reduced-motion: reduce) {\n  .carousel-fade .active.carousel-item-start,\n.carousel-fade .active.carousel-item-end {\n    transition: none;\n  }\n}\n\n.carousel-control-prev,\n.carousel-control-next {\n  position: absolute;\n  top: 0;\n  bottom: 0;\n  z-index: 1;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  width: 15%;\n  padding: 0;\n  color: #fff;\n  text-align: center;\n  background: none;\n  border: 0;\n  opacity: 0.5;\n  transition: opacity 0.15s ease;\n}\n@media (prefers-reduced-motion: reduce) {\n  .carousel-control-prev,\n.carousel-control-next {\n    transition: none;\n  }\n}\n.carousel-control-prev:hover, .carousel-control-prev:focus,\n.carousel-control-next:hover,\n.carousel-control-next:focus {\n  color: #fff;\n  text-decoration: none;\n  outline: 0;\n  opacity: 0.9;\n}\n\n.carousel-control-prev {\n  left: 0;\n}\n\n.carousel-control-next {\n  right: 0;\n}\n\n.carousel-control-prev-icon,\n.carousel-control-next-icon {\n  display: inline-block;\n  width: 2rem;\n  height: 2rem;\n  background-repeat: no-repeat;\n  background-position: 50%;\n  background-size: 100% 100%;\n}\n\n/* rtl:options: {\n  \"autoRename\": true,\n  \"stringMap\":[ {\n    \"name\"    : \"prev-next\",\n    \"search\"  : \"prev\",\n    \"replace\" : \"next\"\n  } ]\n} */\n.carousel-control-prev-icon {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='%23fff'%3e%3cpath d='M11.354 1.646a.5.5 0 0 1 0 .708L5.707 8l5.647 5.646a.5.5 0 0 1-.708.708l-6-6a.5.5 0 0 1 0-.708l6-6a.5.5 0 0 1 .708 0z'/%3e%3c/svg%3e\");\n}\n\n.carousel-control-next-icon {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='%23fff'%3e%3cpath d='M4.646 1.646a.5.5 0 0 1 .708 0l6 6a.5.5 0 0 1 0 .708l-6 6a.5.5 0 0 1-.708-.708L10.293 8 4.646 2.354a.5.5 0 0 1 0-.708z'/%3e%3c/svg%3e\");\n}\n\n.carousel-indicators {\n  position: absolute;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  z-index: 2;\n  display: flex;\n  justify-content: center;\n  padding: 0;\n  margin-right: 15%;\n  margin-bottom: 1rem;\n  margin-left: 15%;\n  list-style: none;\n}\n.carousel-indicators [data-bs-target] {\n  box-sizing: content-box;\n  flex: 0 1 auto;\n  width: 30px;\n  height: 3px;\n  padding: 0;\n  margin-right: 3px;\n  margin-left: 3px;\n  text-indent: -999px;\n  cursor: pointer;\n  background-color: #fff;\n  background-clip: padding-box;\n  border: 0;\n  border-top: 10px solid transparent;\n  border-bottom: 10px solid transparent;\n  opacity: 0.5;\n  transition: opacity 0.6s ease;\n}\n@media (prefers-reduced-motion: reduce) {\n  .carousel-indicators [data-bs-target] {\n    transition: none;\n  }\n}\n.carousel-indicators .active {\n  opacity: 1;\n}\n\n.carousel-caption {\n  position: absolute;\n  right: 15%;\n  bottom: 1.25rem;\n  left: 15%;\n  padding-top: 1.25rem;\n  padding-bottom: 1.25rem;\n  color: #fff;\n  text-align: center;\n}\n\n.carousel-dark .carousel-control-prev-icon,\n.carousel-dark .carousel-control-next-icon {\n  filter: invert(1) grayscale(100);\n}\n.carousel-dark .carousel-indicators [data-bs-target] {\n  background-color: #000;\n}\n.carousel-dark .carousel-caption {\n  color: #000;\n}\n\n@-webkit-keyframes spinner-border {\n  to {\n    transform: rotate(360deg) /* rtl:ignore */;\n  }\n}\n\n@keyframes spinner-border {\n  to {\n    transform: rotate(360deg) /* rtl:ignore */;\n  }\n}\n.spinner-border {\n  display: inline-block;\n  width: 2rem;\n  height: 2rem;\n  vertical-align: -0.125em;\n  border: 0.25em solid currentColor;\n  border-right-color: transparent;\n  border-radius: 50%;\n  -webkit-animation: 0.75s linear infinite spinner-border;\n  animation: 0.75s linear infinite spinner-border;\n}\n\n.spinner-border-sm {\n  width: 1rem;\n  height: 1rem;\n  border-width: 0.2em;\n}\n\n@-webkit-keyframes spinner-grow {\n  0% {\n    transform: scale(0);\n  }\n  50% {\n    opacity: 1;\n    transform: none;\n  }\n}\n\n@keyframes spinner-grow {\n  0% {\n    transform: scale(0);\n  }\n  50% {\n    opacity: 1;\n    transform: none;\n  }\n}\n.spinner-grow {\n  display: inline-block;\n  width: 2rem;\n  height: 2rem;\n  vertical-align: -0.125em;\n  background-color: currentColor;\n  border-radius: 50%;\n  opacity: 0;\n  -webkit-animation: 0.75s linear infinite spinner-grow;\n  animation: 0.75s linear infinite spinner-grow;\n}\n\n.spinner-grow-sm {\n  width: 1rem;\n  height: 1rem;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .spinner-border,\n.spinner-grow {\n    -webkit-animation-duration: 1.5s;\n    animation-duration: 1.5s;\n  }\n}\n.offcanvas {\n  position: fixed;\n  bottom: 0;\n  z-index: 1045;\n  display: flex;\n  flex-direction: column;\n  max-width: 100%;\n  visibility: hidden;\n  background-color: #fff;\n  background-clip: padding-box;\n  outline: 0;\n  transition: transform 0.3s ease-in-out;\n}\n@media (prefers-reduced-motion: reduce) {\n  .offcanvas {\n    transition: none;\n  }\n}\n\n.offcanvas-backdrop {\n  position: fixed;\n  top: 0;\n  left: 0;\n  z-index: 1040;\n  width: 100vw;\n  height: 100vh;\n  background-color: #000;\n}\n.offcanvas-backdrop.fade {\n  opacity: 0;\n}\n.offcanvas-backdrop.show {\n  opacity: 0.5;\n}\n\n.offcanvas-header {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  padding: 1rem 1rem;\n}\n.offcanvas-header .btn-close {\n  padding: 0.5rem 0.5rem;\n  margin-top: -0.5rem;\n  margin-right: -0.5rem;\n  margin-bottom: -0.5rem;\n}\n\n.offcanvas-title {\n  margin-bottom: 0;\n  line-height: 1.5;\n}\n\n.offcanvas-body {\n  flex-grow: 1;\n  padding: 1rem 1rem;\n  overflow-y: auto;\n}\n\n.offcanvas-start {\n  top: 0;\n  left: 0;\n  width: 400px;\n  border-right: 1px solid rgba(0, 0, 0, 0.2);\n  transform: translateX(-100%);\n}\n\n.offcanvas-end {\n  top: 0;\n  right: 0;\n  width: 400px;\n  border-left: 1px solid rgba(0, 0, 0, 0.2);\n  transform: translateX(100%);\n}\n\n.offcanvas-top {\n  top: 0;\n  right: 0;\n  left: 0;\n  height: 30vh;\n  max-height: 100%;\n  border-bottom: 1px solid rgba(0, 0, 0, 0.2);\n  transform: translateY(-100%);\n}\n\n.offcanvas-bottom {\n  right: 0;\n  left: 0;\n  height: 30vh;\n  max-height: 100%;\n  border-top: 1px solid rgba(0, 0, 0, 0.2);\n  transform: translateY(100%);\n}\n\n.offcanvas.show {\n  transform: none;\n}\n\n.placeholder {\n  display: inline-block;\n  min-height: 1em;\n  vertical-align: middle;\n  cursor: wait;\n  background-color: currentColor;\n  opacity: 0.5;\n}\n.placeholder.btn::before {\n  display: inline-block;\n  content: \"\";\n}\n\n.placeholder-xs {\n  min-height: 0.6em;\n}\n\n.placeholder-sm {\n  min-height: 0.8em;\n}\n\n.placeholder-lg {\n  min-height: 1.2em;\n}\n\n.placeholder-glow .placeholder {\n  -webkit-animation: placeholder-glow 2s ease-in-out infinite;\n  animation: placeholder-glow 2s ease-in-out infinite;\n}\n\n@-webkit-keyframes placeholder-glow {\n  50% {\n    opacity: 0.2;\n  }\n}\n\n@keyframes placeholder-glow {\n  50% {\n    opacity: 0.2;\n  }\n}\n.placeholder-wave {\n  -webkit-mask-image: linear-gradient(130deg, #000 55%, rgba(0, 0, 0, 0.8) 75%, #000 95%);\n  mask-image: linear-gradient(130deg, #000 55%, rgba(0, 0, 0, 0.8) 75%, #000 95%);\n  -webkit-mask-size: 200% 100%;\n  mask-size: 200% 100%;\n  -webkit-animation: placeholder-wave 2s linear infinite;\n  animation: placeholder-wave 2s linear infinite;\n}\n\n@-webkit-keyframes placeholder-wave {\n  100% {\n    -webkit-mask-position: -200% 0%;\n    mask-position: -200% 0%;\n  }\n}\n\n@keyframes placeholder-wave {\n  100% {\n    -webkit-mask-position: -200% 0%;\n    mask-position: -200% 0%;\n  }\n}\n.clearfix::after {\n  display: block;\n  clear: both;\n  content: \"\";\n}\n\n.link-primary {\n  color: #0d6efd;\n}\n.link-primary:hover, .link-primary:focus {\n  color: #0a58ca;\n}\n\n.link-secondary {\n  color: #6c757d;\n}\n.link-secondary:hover, .link-secondary:focus {\n  color: #565e64;\n}\n\n.link-success {\n  color: #198754;\n}\n.link-success:hover, .link-success:focus {\n  color: #146c43;\n}\n\n.link-info {\n  color: #0dcaf0;\n}\n.link-info:hover, .link-info:focus {\n  color: #3dd5f3;\n}\n\n.link-warning {\n  color: #ffc107;\n}\n.link-warning:hover, .link-warning:focus {\n  color: #ffcd39;\n}\n\n.link-danger {\n  color: #dc3545;\n}\n.link-danger:hover, .link-danger:focus {\n  color: #b02a37;\n}\n\n.link-light {\n  color: #f8f9fa;\n}\n.link-light:hover, .link-light:focus {\n  color: #f9fafb;\n}\n\n.link-dark {\n  color: #212529;\n}\n.link-dark:hover, .link-dark:focus {\n  color: #1a1e21;\n}\n\n.ratio {\n  position: relative;\n  width: 100%;\n}\n.ratio::before {\n  display: block;\n  padding-top: var(--bs-aspect-ratio);\n  content: \"\";\n}\n.ratio > * {\n  position: absolute;\n  top: 0;\n  left: 0;\n  width: 100%;\n  height: 100%;\n}\n\n.ratio-1x1 {\n  --bs-aspect-ratio: 100%;\n}\n\n.ratio-4x3 {\n  --bs-aspect-ratio: calc(3 / 4 * 100%);\n}\n\n.ratio-16x9 {\n  --bs-aspect-ratio: calc(9 / 16 * 100%);\n}\n\n.ratio-21x9 {\n  --bs-aspect-ratio: calc(9 / 21 * 100%);\n}\n\n.fixed-top {\n  position: fixed;\n  top: 0;\n  right: 0;\n  left: 0;\n  z-index: 1030;\n}\n\n.fixed-bottom {\n  position: fixed;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  z-index: 1030;\n}\n\n.sticky-top {\n  position: -webkit-sticky;\n  position: sticky;\n  top: 0;\n  z-index: 1020;\n}\n\n@media (min-width: 576px) {\n  .sticky-sm-top {\n    position: -webkit-sticky;\n    position: sticky;\n    top: 0;\n    z-index: 1020;\n  }\n}\n@media (min-width: 768px) {\n  .sticky-md-top {\n    position: -webkit-sticky;\n    position: sticky;\n    top: 0;\n    z-index: 1020;\n  }\n}\n@media (min-width: 992px) {\n  .sticky-lg-top {\n    position: -webkit-sticky;\n    position: sticky;\n    top: 0;\n    z-index: 1020;\n  }\n}\n@media (min-width: 1200px) {\n  .sticky-xl-top {\n    position: -webkit-sticky;\n    position: sticky;\n    top: 0;\n    z-index: 1020;\n  }\n}\n@media (min-width: 1400px) {\n  .sticky-xxl-top {\n    position: -webkit-sticky;\n    position: sticky;\n    top: 0;\n    z-index: 1020;\n  }\n}\n.hstack {\n  display: flex;\n  flex-direction: row;\n  align-items: center;\n  align-self: stretch;\n}\n\n.vstack {\n  display: flex;\n  flex: 1 1 auto;\n  flex-direction: column;\n  align-self: stretch;\n}\n\n.visually-hidden,\n.visually-hidden-focusable:not(:focus):not(:focus-within) {\n  position: absolute !important;\n  width: 1px !important;\n  height: 1px !important;\n  padding: 0 !important;\n  margin: -1px !important;\n  overflow: hidden !important;\n  clip: rect(0, 0, 0, 0) !important;\n  white-space: nowrap !important;\n  border: 0 !important;\n}\n\n.stretched-link::after {\n  position: absolute;\n  top: 0;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  z-index: 1;\n  content: \"\";\n}\n\n.text-truncate {\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n\n.vr {\n  display: inline-block;\n  align-self: stretch;\n  width: 1px;\n  min-height: 1em;\n  background-color: currentColor;\n  opacity: 0.25;\n}\n\n.align-baseline {\n  vertical-align: baseline !important;\n}\n\n.align-top {\n  vertical-align: top !important;\n}\n\n.align-middle {\n  vertical-align: middle !important;\n}\n\n.align-bottom {\n  vertical-align: bottom !important;\n}\n\n.align-text-bottom {\n  vertical-align: text-bottom !important;\n}\n\n.align-text-top {\n  vertical-align: text-top !important;\n}\n\n.float-start {\n  float: left !important;\n}\n\n.float-end {\n  float: right !important;\n}\n\n.float-none {\n  float: none !important;\n}\n\n.opacity-0 {\n  opacity: 0 !important;\n}\n\n.opacity-25 {\n  opacity: 0.25 !important;\n}\n\n.opacity-50 {\n  opacity: 0.5 !important;\n}\n\n.opacity-75 {\n  opacity: 0.75 !important;\n}\n\n.opacity-100 {\n  opacity: 1 !important;\n}\n\n.overflow-auto {\n  overflow: auto !important;\n}\n\n.overflow-hidden {\n  overflow: hidden !important;\n}\n\n.overflow-visible {\n  overflow: visible !important;\n}\n\n.overflow-scroll {\n  overflow: scroll !important;\n}\n\n.d-inline {\n  display: inline !important;\n}\n\n.d-inline-block {\n  display: inline-block !important;\n}\n\n.d-block {\n  display: block !important;\n}\n\n.d-grid {\n  display: grid !important;\n}\n\n.d-table {\n  display: table !important;\n}\n\n.d-table-row {\n  display: table-row !important;\n}\n\n.d-table-cell {\n  display: table-cell !important;\n}\n\n.d-flex {\n  display: flex !important;\n}\n\n.d-inline-flex {\n  display: inline-flex !important;\n}\n\n.d-none {\n  display: none !important;\n}\n\n.shadow {\n  box-shadow: 0 0.5rem 1rem rgba(0, 0, 0, 0.15) !important;\n}\n\n.shadow-sm {\n  box-shadow: 0 0.125rem 0.25rem rgba(0, 0, 0, 0.075) !important;\n}\n\n.shadow-lg {\n  box-shadow: 0 1rem 3rem rgba(0, 0, 0, 0.175) !important;\n}\n\n.shadow-none {\n  box-shadow: none !important;\n}\n\n.position-static {\n  position: static !important;\n}\n\n.position-relative {\n  position: relative !important;\n}\n\n.position-absolute {\n  position: absolute !important;\n}\n\n.position-fixed {\n  position: fixed !important;\n}\n\n.position-sticky {\n  position: -webkit-sticky !important;\n  position: sticky !important;\n}\n\n.top-0 {\n  top: 0 !important;\n}\n\n.top-50 {\n  top: 50% !important;\n}\n\n.top-100 {\n  top: 100% !important;\n}\n\n.bottom-0 {\n  bottom: 0 !important;\n}\n\n.bottom-50 {\n  bottom: 50% !important;\n}\n\n.bottom-100 {\n  bottom: 100% !important;\n}\n\n.start-0 {\n  left: 0 !important;\n}\n\n.start-50 {\n  left: 50% !important;\n}\n\n.start-100 {\n  left: 100% !important;\n}\n\n.end-0 {\n  right: 0 !important;\n}\n\n.end-50 {\n  right: 50% !important;\n}\n\n.end-100 {\n  right: 100% !important;\n}\n\n.translate-middle {\n  transform: translate(-50%, -50%) !important;\n}\n\n.translate-middle-x {\n  transform: translateX(-50%) !important;\n}\n\n.translate-middle-y {\n  transform: translateY(-50%) !important;\n}\n\n.border {\n  border: 1px solid #dee2e6 !important;\n}\n\n.border-0 {\n  border: 0 !important;\n}\n\n.border-top {\n  border-top: 1px solid #dee2e6 !important;\n}\n\n.border-top-0 {\n  border-top: 0 !important;\n}\n\n.border-end {\n  border-right: 1px solid #dee2e6 !important;\n}\n\n.border-end-0 {\n  border-right: 0 !important;\n}\n\n.border-bottom {\n  border-bottom: 1px solid #dee2e6 !important;\n}\n\n.border-bottom-0 {\n  border-bottom: 0 !important;\n}\n\n.border-start {\n  border-left: 1px solid #dee2e6 !important;\n}\n\n.border-start-0 {\n  border-left: 0 !important;\n}\n\n.border-primary {\n  border-color: #0d6efd !important;\n}\n\n.border-secondary {\n  border-color: #6c757d !important;\n}\n\n.border-success {\n  border-color: #198754 !important;\n}\n\n.border-info {\n  border-color: #0dcaf0 !important;\n}\n\n.border-warning {\n  border-color: #ffc107 !important;\n}\n\n.border-danger {\n  border-color: #dc3545 !important;\n}\n\n.border-light {\n  border-color: #f8f9fa !important;\n}\n\n.border-dark {\n  border-color: #212529 !important;\n}\n\n.border-white {\n  border-color: #fff !important;\n}\n\n.border-1 {\n  border-width: 1px !important;\n}\n\n.border-2 {\n  border-width: 2px !important;\n}\n\n.border-3 {\n  border-width: 3px !important;\n}\n\n.border-4 {\n  border-width: 4px !important;\n}\n\n.border-5 {\n  border-width: 5px !important;\n}\n\n.w-25 {\n  width: 25% !important;\n}\n\n.w-50 {\n  width: 50% !important;\n}\n\n.w-75 {\n  width: 75% !important;\n}\n\n.w-100 {\n  width: 100% !important;\n}\n\n.w-auto {\n  width: auto !important;\n}\n\n.mw-100 {\n  max-width: 100% !important;\n}\n\n.vw-100 {\n  width: 100vw !important;\n}\n\n.min-vw-100 {\n  min-width: 100vw !important;\n}\n\n.h-25 {\n  height: 25% !important;\n}\n\n.h-50 {\n  height: 50% !important;\n}\n\n.h-75 {\n  height: 75% !important;\n}\n\n.h-100 {\n  height: 100% !important;\n}\n\n.h-auto {\n  height: auto !important;\n}\n\n.mh-100 {\n  max-height: 100% !important;\n}\n\n.vh-100 {\n  height: 100vh !important;\n}\n\n.min-vh-100 {\n  min-height: 100vh !important;\n}\n\n.flex-fill {\n  flex: 1 1 auto !important;\n}\n\n.flex-row {\n  flex-direction: row !important;\n}\n\n.flex-column {\n  flex-direction: column !important;\n}\n\n.flex-row-reverse {\n  flex-direction: row-reverse !important;\n}\n\n.flex-column-reverse {\n  flex-direction: column-reverse !important;\n}\n\n.flex-grow-0 {\n  flex-grow: 0 !important;\n}\n\n.flex-grow-1 {\n  flex-grow: 1 !important;\n}\n\n.flex-shrink-0 {\n  flex-shrink: 0 !important;\n}\n\n.flex-shrink-1 {\n  flex-shrink: 1 !important;\n}\n\n.flex-wrap {\n  flex-wrap: wrap !important;\n}\n\n.flex-nowrap {\n  flex-wrap: nowrap !important;\n}\n\n.flex-wrap-reverse {\n  flex-wrap: wrap-reverse !important;\n}\n\n.gap-0 {\n  gap: 0 !important;\n}\n\n.gap-1 {\n  gap: 0.25rem !important;\n}\n\n.gap-2 {\n  gap: 0.5rem !important;\n}\n\n.gap-3 {\n  gap: 1rem !important;\n}\n\n.gap-4 {\n  gap: 1.5rem !important;\n}\n\n.gap-5 {\n  gap: 3rem !important;\n}\n\n.justify-content-start {\n  justify-content: flex-start !important;\n}\n\n.justify-content-end {\n  justify-content: flex-end !important;\n}\n\n.justify-content-center {\n  justify-content: center !important;\n}\n\n.justify-content-between {\n  justify-content: space-between !important;\n}\n\n.justify-content-around {\n  justify-content: space-around !important;\n}\n\n.justify-content-evenly {\n  justify-content: space-evenly !important;\n}\n\n.align-items-start {\n  align-items: flex-start !important;\n}\n\n.align-items-end {\n  align-items: flex-end !important;\n}\n\n.align-items-center {\n  align-items: center !important;\n}\n\n.align-items-baseline {\n  align-items: baseline !important;\n}\n\n.align-items-stretch {\n  align-items: stretch !important;\n}\n\n.align-content-start {\n  align-content: flex-start !important;\n}\n\n.align-content-end {\n  align-content: flex-end !important;\n}\n\n.align-content-center {\n  align-content: center !important;\n}\n\n.align-content-between {\n  align-content: space-between !important;\n}\n\n.align-content-around {\n  align-content: space-around !important;\n}\n\n.align-content-stretch {\n  align-content: stretch !important;\n}\n\n.align-self-auto {\n  align-self: auto !important;\n}\n\n.align-self-start {\n  align-self: flex-start !important;\n}\n\n.align-self-end {\n  align-self: flex-end !important;\n}\n\n.align-self-center {\n  align-self: center !important;\n}\n\n.align-self-baseline {\n  align-self: baseline !important;\n}\n\n.align-self-stretch {\n  align-self: stretch !important;\n}\n\n.order-first {\n  order: -1 !important;\n}\n\n.order-0 {\n  order: 0 !important;\n}\n\n.order-1 {\n  order: 1 !important;\n}\n\n.order-2 {\n  order: 2 !important;\n}\n\n.order-3 {\n  order: 3 !important;\n}\n\n.order-4 {\n  order: 4 !important;\n}\n\n.order-5 {\n  order: 5 !important;\n}\n\n.order-last {\n  order: 6 !important;\n}\n\n.m-0 {\n  margin: 0 !important;\n}\n\n.m-1 {\n  margin: 0.25rem !important;\n}\n\n.m-2 {\n  margin: 0.5rem !important;\n}\n\n.m-3 {\n  margin: 1rem !important;\n}\n\n.m-4 {\n  margin: 1.5rem !important;\n}\n\n.m-5 {\n  margin: 3rem !important;\n}\n\n.m-auto {\n  margin: auto !important;\n}\n\n.mx-0 {\n  margin-right: 0 !important;\n  margin-left: 0 !important;\n}\n\n.mx-1 {\n  margin-right: 0.25rem !important;\n  margin-left: 0.25rem !important;\n}\n\n.mx-2 {\n  margin-right: 0.5rem !important;\n  margin-left: 0.5rem !important;\n}\n\n.mx-3 {\n  margin-right: 1rem !important;\n  margin-left: 1rem !important;\n}\n\n.mx-4 {\n  margin-right: 1.5rem !important;\n  margin-left: 1.5rem !important;\n}\n\n.mx-5 {\n  margin-right: 3rem !important;\n  margin-left: 3rem !important;\n}\n\n.mx-auto {\n  margin-right: auto !important;\n  margin-left: auto !important;\n}\n\n.my-0 {\n  margin-top: 0 !important;\n  margin-bottom: 0 !important;\n}\n\n.my-1 {\n  margin-top: 0.25rem !important;\n  margin-bottom: 0.25rem !important;\n}\n\n.my-2 {\n  margin-top: 0.5rem !important;\n  margin-bottom: 0.5rem !important;\n}\n\n.my-3 {\n  margin-top: 1rem !important;\n  margin-bottom: 1rem !important;\n}\n\n.my-4 {\n  margin-top: 1.5rem !important;\n  margin-bottom: 1.5rem !important;\n}\n\n.my-5 {\n  margin-top: 3rem !important;\n  margin-bottom: 3rem !important;\n}\n\n.my-auto {\n  margin-top: auto !important;\n  margin-bottom: auto !important;\n}\n\n.mt-0 {\n  margin-top: 0 !important;\n}\n\n.mt-1 {\n  margin-top: 0.25rem !important;\n}\n\n.mt-2 {\n  margin-top: 0.5rem !important;\n}\n\n.mt-3 {\n  margin-top: 1rem !important;\n}\n\n.mt-4 {\n  margin-top: 1.5rem !important;\n}\n\n.mt-5 {\n  margin-top: 3rem !important;\n}\n\n.mt-auto {\n  margin-top: auto !important;\n}\n\n.me-0 {\n  margin-right: 0 !important;\n}\n\n.me-1 {\n  margin-right: 0.25rem !important;\n}\n\n.me-2 {\n  margin-right: 0.5rem !important;\n}\n\n.me-3 {\n  margin-right: 1rem !important;\n}\n\n.me-4 {\n  margin-right: 1.5rem !important;\n}\n\n.me-5 {\n  margin-right: 3rem !important;\n}\n\n.me-auto {\n  margin-right: auto !important;\n}\n\n.mb-0 {\n  margin-bottom: 0 !important;\n}\n\n.mb-1 {\n  margin-bottom: 0.25rem !important;\n}\n\n.mb-2 {\n  margin-bottom: 0.5rem !important;\n}\n\n.mb-3 {\n  margin-bottom: 1rem !important;\n}\n\n.mb-4 {\n  margin-bottom: 1.5rem !important;\n}\n\n.mb-5 {\n  margin-bottom: 3rem !important;\n}\n\n.mb-auto {\n  margin-bottom: auto !important;\n}\n\n.ms-0 {\n  margin-left: 0 !important;\n}\n\n.ms-1 {\n  margin-left: 0.25rem !important;\n}\n\n.ms-2 {\n  margin-left: 0.5rem !important;\n}\n\n.ms-3 {\n  margin-left: 1rem !important;\n}\n\n.ms-4 {\n  margin-left: 1.5rem !important;\n}\n\n.ms-5 {\n  margin-left: 3rem !important;\n}\n\n.ms-auto {\n  margin-left: auto !important;\n}\n\n.p-0 {\n  padding: 0 !important;\n}\n\n.p-1 {\n  padding: 0.25rem !important;\n}\n\n.p-2 {\n  padding: 0.5rem !important;\n}\n\n.p-3 {\n  padding: 1rem !important;\n}\n\n.p-4 {\n  padding: 1.5rem !important;\n}\n\n.p-5 {\n  padding: 3rem !important;\n}\n\n.px-0 {\n  padding-right: 0 !important;\n  padding-left: 0 !important;\n}\n\n.px-1 {\n  padding-right: 0.25rem !important;\n  padding-left: 0.25rem !important;\n}\n\n.px-2 {\n  padding-right: 0.5rem !important;\n  padding-left: 0.5rem !important;\n}\n\n.px-3 {\n  padding-right: 1rem !important;\n  padding-left: 1rem !important;\n}\n\n.px-4 {\n  padding-right: 1.5rem !important;\n  padding-left: 1.5rem !important;\n}\n\n.px-5 {\n  padding-right: 3rem !important;\n  padding-left: 3rem !important;\n}\n\n.py-0 {\n  padding-top: 0 !important;\n  padding-bottom: 0 !important;\n}\n\n.py-1 {\n  padding-top: 0.25rem !important;\n  padding-bottom: 0.25rem !important;\n}\n\n.py-2 {\n  padding-top: 0.5rem !important;\n  padding-bottom: 0.5rem !important;\n}\n\n.py-3 {\n  padding-top: 1rem !important;\n  padding-bottom: 1rem !important;\n}\n\n.py-4 {\n  padding-top: 1.5rem !important;\n  padding-bottom: 1.5rem !important;\n}\n\n.py-5 {\n  padding-top: 3rem !important;\n  padding-bottom: 3rem !important;\n}\n\n.pt-0 {\n  padding-top: 0 !important;\n}\n\n.pt-1 {\n  padding-top: 0.25rem !important;\n}\n\n.pt-2 {\n  padding-top: 0.5rem !important;\n}\n\n.pt-3 {\n  padding-top: 1rem !important;\n}\n\n.pt-4 {\n  padding-top: 1.5rem !important;\n}\n\n.pt-5 {\n  padding-top: 3rem !important;\n}\n\n.pe-0 {\n  padding-right: 0 !important;\n}\n\n.pe-1 {\n  padding-right: 0.25rem !important;\n}\n\n.pe-2 {\n  padding-right: 0.5rem !important;\n}\n\n.pe-3 {\n  padding-right: 1rem !important;\n}\n\n.pe-4 {\n  padding-right: 1.5rem !important;\n}\n\n.pe-5 {\n  padding-right: 3rem !important;\n}\n\n.pb-0 {\n  padding-bottom: 0 !important;\n}\n\n.pb-1 {\n  padding-bottom: 0.25rem !important;\n}\n\n.pb-2 {\n  padding-bottom: 0.5rem !important;\n}\n\n.pb-3 {\n  padding-bottom: 1rem !important;\n}\n\n.pb-4 {\n  padding-bottom: 1.5rem !important;\n}\n\n.pb-5 {\n  padding-bottom: 3rem !important;\n}\n\n.ps-0 {\n  padding-left: 0 !important;\n}\n\n.ps-1 {\n  padding-left: 0.25rem !important;\n}\n\n.ps-2 {\n  padding-left: 0.5rem !important;\n}\n\n.ps-3 {\n  padding-left: 1rem !important;\n}\n\n.ps-4 {\n  padding-left: 1.5rem !important;\n}\n\n.ps-5 {\n  padding-left: 3rem !important;\n}\n\n.font-monospace {\n  font-family: var(--bs-font-monospace) !important;\n}\n\n.fs-1 {\n  font-size: calc(1.375rem + 1.5vw) !important;\n}\n\n.fs-2 {\n  font-size: calc(1.325rem + 0.9vw) !important;\n}\n\n.fs-3 {\n  font-size: calc(1.3rem + 0.6vw) !important;\n}\n\n.fs-4 {\n  font-size: calc(1.275rem + 0.3vw) !important;\n}\n\n.fs-5 {\n  font-size: 1.25rem !important;\n}\n\n.fs-6 {\n  font-size: 1rem !important;\n}\n\n.fst-italic {\n  font-style: italic !important;\n}\n\n.fst-normal {\n  font-style: normal !important;\n}\n\n.fw-light {\n  font-weight: 300 !important;\n}\n\n.fw-lighter {\n  font-weight: lighter !important;\n}\n\n.fw-normal {\n  font-weight: 400 !important;\n}\n\n.fw-bold {\n  font-weight: 700 !important;\n}\n\n.fw-bolder {\n  font-weight: bolder !important;\n}\n\n.lh-1 {\n  line-height: 1 !important;\n}\n\n.lh-sm {\n  line-height: 1.25 !important;\n}\n\n.lh-base {\n  line-height: 1.5 !important;\n}\n\n.lh-lg {\n  line-height: 2 !important;\n}\n\n.text-start {\n  text-align: left !important;\n}\n\n.text-end {\n  text-align: right !important;\n}\n\n.text-center {\n  text-align: center !important;\n}\n\n.text-decoration-none {\n  text-decoration: none !important;\n}\n\n.text-decoration-underline {\n  text-decoration: underline !important;\n}\n\n.text-decoration-line-through {\n  text-decoration: line-through !important;\n}\n\n.text-lowercase {\n  text-transform: lowercase !important;\n}\n\n.text-uppercase {\n  text-transform: uppercase !important;\n}\n\n.text-capitalize {\n  text-transform: capitalize !important;\n}\n\n.text-wrap {\n  white-space: normal !important;\n}\n\n.text-nowrap {\n  white-space: nowrap !important;\n}\n\n/* rtl:begin:remove */\n.text-break {\n  word-wrap: break-word !important;\n  word-break: break-word !important;\n}\n\n/* rtl:end:remove */\n.text-primary {\n  --bs-text-opacity: 1;\n  color: rgba(var(--bs-primary-rgb), var(--bs-text-opacity)) !important;\n}\n\n.text-secondary {\n  --bs-text-opacity: 1;\n  color: rgba(var(--bs-secondary-rgb), var(--bs-text-opacity)) !important;\n}\n\n.text-success {\n  --bs-text-opacity: 1;\n  color: rgba(var(--bs-success-rgb), var(--bs-text-opacity)) !important;\n}\n\n.text-info {\n  --bs-text-opacity: 1;\n  color: rgba(var(--bs-info-rgb), var(--bs-text-opacity)) !important;\n}\n\n.text-warning {\n  --bs-text-opacity: 1;\n  color: rgba(var(--bs-warning-rgb), var(--bs-text-opacity)) !important;\n}\n\n.text-danger {\n  --bs-text-opacity: 1;\n  color: rgba(var(--bs-danger-rgb), var(--bs-text-opacity)) !important;\n}\n\n.text-light {\n  --bs-text-opacity: 1;\n  color: rgba(var(--bs-light-rgb), var(--bs-text-opacity)) !important;\n}\n\n.text-dark {\n  --bs-text-opacity: 1;\n  color: rgba(var(--bs-dark-rgb), var(--bs-text-opacity)) !important;\n}\n\n.text-black {\n  --bs-text-opacity: 1;\n  color: rgba(var(--bs-black-rgb), var(--bs-text-opacity)) !important;\n}\n\n.text-white {\n  --bs-text-opacity: 1;\n  color: rgba(var(--bs-white-rgb), var(--bs-text-opacity)) !important;\n}\n\n.text-body {\n  --bs-text-opacity: 1;\n  color: rgba(var(--bs-body-rgb), var(--bs-text-opacity)) !important;\n}\n\n.text-muted {\n  --bs-text-opacity: 1;\n  color: #6c757d !important;\n}\n\n.text-black-50 {\n  --bs-text-opacity: 1;\n  color: rgba(0, 0, 0, 0.5) !important;\n}\n\n.text-white-50 {\n  --bs-text-opacity: 1;\n  color: rgba(255, 255, 255, 0.5) !important;\n}\n\n.text-reset {\n  --bs-text-opacity: 1;\n  color: inherit !important;\n}\n\n.text-opacity-25 {\n  --bs-text-opacity: 0.25;\n}\n\n.text-opacity-50 {\n  --bs-text-opacity: 0.5;\n}\n\n.text-opacity-75 {\n  --bs-text-opacity: 0.75;\n}\n\n.text-opacity-100 {\n  --bs-text-opacity: 1;\n}\n\n.bg-primary {\n  --bs-bg-opacity: 1;\n  background-color: rgba(var(--bs-primary-rgb), var(--bs-bg-opacity)) !important;\n}\n\n.bg-secondary {\n  --bs-bg-opacity: 1;\n  background-color: rgba(var(--bs-secondary-rgb), var(--bs-bg-opacity)) !important;\n}\n\n.bg-success {\n  --bs-bg-opacity: 1;\n  background-color: rgba(var(--bs-success-rgb), var(--bs-bg-opacity)) !important;\n}\n\n.bg-info {\n  --bs-bg-opacity: 1;\n  background-color: rgba(var(--bs-info-rgb), var(--bs-bg-opacity)) !important;\n}\n\n.bg-warning {\n  --bs-bg-opacity: 1;\n  background-color: rgba(var(--bs-warning-rgb), var(--bs-bg-opacity)) !important;\n}\n\n.bg-danger {\n  --bs-bg-opacity: 1;\n  background-color: rgba(var(--bs-danger-rgb), var(--bs-bg-opacity)) !important;\n}\n\n.bg-light {\n  --bs-bg-opacity: 1;\n  background-color: rgba(var(--bs-light-rgb), var(--bs-bg-opacity)) !important;\n}\n\n.bg-dark {\n  --bs-bg-opacity: 1;\n  background-color: rgba(var(--bs-dark-rgb), var(--bs-bg-opacity)) !important;\n}\n\n.bg-black {\n  --bs-bg-opacity: 1;\n  background-color: rgba(var(--bs-black-rgb), var(--bs-bg-opacity)) !important;\n}\n\n.bg-white {\n  --bs-bg-opacity: 1;\n  background-color: rgba(var(--bs-white-rgb), var(--bs-bg-opacity)) !important;\n}\n\n.bg-body {\n  --bs-bg-opacity: 1;\n  background-color: rgba(var(--bs-body-rgb), var(--bs-bg-opacity)) !important;\n}\n\n.bg-transparent {\n  --bs-bg-opacity: 1;\n  background-color: transparent !important;\n}\n\n.bg-opacity-10 {\n  --bs-bg-opacity: 0.1;\n}\n\n.bg-opacity-25 {\n  --bs-bg-opacity: 0.25;\n}\n\n.bg-opacity-50 {\n  --bs-bg-opacity: 0.5;\n}\n\n.bg-opacity-75 {\n  --bs-bg-opacity: 0.75;\n}\n\n.bg-opacity-100 {\n  --bs-bg-opacity: 1;\n}\n\n.bg-gradient {\n  background-image: var(--bs-gradient) !important;\n}\n\n.user-select-all {\n  -webkit-user-select: all !important;\n  -moz-user-select: all !important;\n  user-select: all !important;\n}\n\n.user-select-auto {\n  -webkit-user-select: auto !important;\n  -moz-user-select: auto !important;\n  user-select: auto !important;\n}\n\n.user-select-none {\n  -webkit-user-select: none !important;\n  -moz-user-select: none !important;\n  user-select: none !important;\n}\n\n.pe-none {\n  pointer-events: none !important;\n}\n\n.pe-auto {\n  pointer-events: auto !important;\n}\n\n.rounded {\n  border-radius: 0.25rem !important;\n}\n\n.rounded-0 {\n  border-radius: 0 !important;\n}\n\n.rounded-1 {\n  border-radius: 0.2rem !important;\n}\n\n.rounded-2 {\n  border-radius: 0.25rem !important;\n}\n\n.rounded-3 {\n  border-radius: 0.3rem !important;\n}\n\n.rounded-circle {\n  border-radius: 50% !important;\n}\n\n.rounded-pill {\n  border-radius: 50rem !important;\n}\n\n.rounded-top {\n  border-top-left-radius: 0.25rem !important;\n  border-top-right-radius: 0.25rem !important;\n}\n\n.rounded-end {\n  border-top-right-radius: 0.25rem !important;\n  border-bottom-right-radius: 0.25rem !important;\n}\n\n.rounded-bottom {\n  border-bottom-right-radius: 0.25rem !important;\n  border-bottom-left-radius: 0.25rem !important;\n}\n\n.rounded-start {\n  border-bottom-left-radius: 0.25rem !important;\n  border-top-left-radius: 0.25rem !important;\n}\n\n.visible {\n  visibility: visible !important;\n}\n\n.invisible {\n  visibility: hidden !important;\n}\n\n@media (min-width: 576px) {\n  .float-sm-start {\n    float: left !important;\n  }\n\n  .float-sm-end {\n    float: right !important;\n  }\n\n  .float-sm-none {\n    float: none !important;\n  }\n\n  .d-sm-inline {\n    display: inline !important;\n  }\n\n  .d-sm-inline-block {\n    display: inline-block !important;\n  }\n\n  .d-sm-block {\n    display: block !important;\n  }\n\n  .d-sm-grid {\n    display: grid !important;\n  }\n\n  .d-sm-table {\n    display: table !important;\n  }\n\n  .d-sm-table-row {\n    display: table-row !important;\n  }\n\n  .d-sm-table-cell {\n    display: table-cell !important;\n  }\n\n  .d-sm-flex {\n    display: flex !important;\n  }\n\n  .d-sm-inline-flex {\n    display: inline-flex !important;\n  }\n\n  .d-sm-none {\n    display: none !important;\n  }\n\n  .flex-sm-fill {\n    flex: 1 1 auto !important;\n  }\n\n  .flex-sm-row {\n    flex-direction: row !important;\n  }\n\n  .flex-sm-column {\n    flex-direction: column !important;\n  }\n\n  .flex-sm-row-reverse {\n    flex-direction: row-reverse !important;\n  }\n\n  .flex-sm-column-reverse {\n    flex-direction: column-reverse !important;\n  }\n\n  .flex-sm-grow-0 {\n    flex-grow: 0 !important;\n  }\n\n  .flex-sm-grow-1 {\n    flex-grow: 1 !important;\n  }\n\n  .flex-sm-shrink-0 {\n    flex-shrink: 0 !important;\n  }\n\n  .flex-sm-shrink-1 {\n    flex-shrink: 1 !important;\n  }\n\n  .flex-sm-wrap {\n    flex-wrap: wrap !important;\n  }\n\n  .flex-sm-nowrap {\n    flex-wrap: nowrap !important;\n  }\n\n  .flex-sm-wrap-reverse {\n    flex-wrap: wrap-reverse !important;\n  }\n\n  .gap-sm-0 {\n    gap: 0 !important;\n  }\n\n  .gap-sm-1 {\n    gap: 0.25rem !important;\n  }\n\n  .gap-sm-2 {\n    gap: 0.5rem !important;\n  }\n\n  .gap-sm-3 {\n    gap: 1rem !important;\n  }\n\n  .gap-sm-4 {\n    gap: 1.5rem !important;\n  }\n\n  .gap-sm-5 {\n    gap: 3rem !important;\n  }\n\n  .justify-content-sm-start {\n    justify-content: flex-start !important;\n  }\n\n  .justify-content-sm-end {\n    justify-content: flex-end !important;\n  }\n\n  .justify-content-sm-center {\n    justify-content: center !important;\n  }\n\n  .justify-content-sm-between {\n    justify-content: space-between !important;\n  }\n\n  .justify-content-sm-around {\n    justify-content: space-around !important;\n  }\n\n  .justify-content-sm-evenly {\n    justify-content: space-evenly !important;\n  }\n\n  .align-items-sm-start {\n    align-items: flex-start !important;\n  }\n\n  .align-items-sm-end {\n    align-items: flex-end !important;\n  }\n\n  .align-items-sm-center {\n    align-items: center !important;\n  }\n\n  .align-items-sm-baseline {\n    align-items: baseline !important;\n  }\n\n  .align-items-sm-stretch {\n    align-items: stretch !important;\n  }\n\n  .align-content-sm-start {\n    align-content: flex-start !important;\n  }\n\n  .align-content-sm-end {\n    align-content: flex-end !important;\n  }\n\n  .align-content-sm-center {\n    align-content: center !important;\n  }\n\n  .align-content-sm-between {\n    align-content: space-between !important;\n  }\n\n  .align-content-sm-around {\n    align-content: space-around !important;\n  }\n\n  .align-content-sm-stretch {\n    align-content: stretch !important;\n  }\n\n  .align-self-sm-auto {\n    align-self: auto !important;\n  }\n\n  .align-self-sm-start {\n    align-self: flex-start !important;\n  }\n\n  .align-self-sm-end {\n    align-self: flex-end !important;\n  }\n\n  .align-self-sm-center {\n    align-self: center !important;\n  }\n\n  .align-self-sm-baseline {\n    align-self: baseline !important;\n  }\n\n  .align-self-sm-stretch {\n    align-self: stretch !important;\n  }\n\n  .order-sm-first {\n    order: -1 !important;\n  }\n\n  .order-sm-0 {\n    order: 0 !important;\n  }\n\n  .order-sm-1 {\n    order: 1 !important;\n  }\n\n  .order-sm-2 {\n    order: 2 !important;\n  }\n\n  .order-sm-3 {\n    order: 3 !important;\n  }\n\n  .order-sm-4 {\n    order: 4 !important;\n  }\n\n  .order-sm-5 {\n    order: 5 !important;\n  }\n\n  .order-sm-last {\n    order: 6 !important;\n  }\n\n  .m-sm-0 {\n    margin: 0 !important;\n  }\n\n  .m-sm-1 {\n    margin: 0.25rem !important;\n  }\n\n  .m-sm-2 {\n    margin: 0.5rem !important;\n  }\n\n  .m-sm-3 {\n    margin: 1rem !important;\n  }\n\n  .m-sm-4 {\n    margin: 1.5rem !important;\n  }\n\n  .m-sm-5 {\n    margin: 3rem !important;\n  }\n\n  .m-sm-auto {\n    margin: auto !important;\n  }\n\n  .mx-sm-0 {\n    margin-right: 0 !important;\n    margin-left: 0 !important;\n  }\n\n  .mx-sm-1 {\n    margin-right: 0.25rem !important;\n    margin-left: 0.25rem !important;\n  }\n\n  .mx-sm-2 {\n    margin-right: 0.5rem !important;\n    margin-left: 0.5rem !important;\n  }\n\n  .mx-sm-3 {\n    margin-right: 1rem !important;\n    margin-left: 1rem !important;\n  }\n\n  .mx-sm-4 {\n    margin-right: 1.5rem !important;\n    margin-left: 1.5rem !important;\n  }\n\n  .mx-sm-5 {\n    margin-right: 3rem !important;\n    margin-left: 3rem !important;\n  }\n\n  .mx-sm-auto {\n    margin-right: auto !important;\n    margin-left: auto !important;\n  }\n\n  .my-sm-0 {\n    margin-top: 0 !important;\n    margin-bottom: 0 !important;\n  }\n\n  .my-sm-1 {\n    margin-top: 0.25rem !important;\n    margin-bottom: 0.25rem !important;\n  }\n\n  .my-sm-2 {\n    margin-top: 0.5rem !important;\n    margin-bottom: 0.5rem !important;\n  }\n\n  .my-sm-3 {\n    margin-top: 1rem !important;\n    margin-bottom: 1rem !important;\n  }\n\n  .my-sm-4 {\n    margin-top: 1.5rem !important;\n    margin-bottom: 1.5rem !important;\n  }\n\n  .my-sm-5 {\n    margin-top: 3rem !important;\n    margin-bottom: 3rem !important;\n  }\n\n  .my-sm-auto {\n    margin-top: auto !important;\n    margin-bottom: auto !important;\n  }\n\n  .mt-sm-0 {\n    margin-top: 0 !important;\n  }\n\n  .mt-sm-1 {\n    margin-top: 0.25rem !important;\n  }\n\n  .mt-sm-2 {\n    margin-top: 0.5rem !important;\n  }\n\n  .mt-sm-3 {\n    margin-top: 1rem !important;\n  }\n\n  .mt-sm-4 {\n    margin-top: 1.5rem !important;\n  }\n\n  .mt-sm-5 {\n    margin-top: 3rem !important;\n  }\n\n  .mt-sm-auto {\n    margin-top: auto !important;\n  }\n\n  .me-sm-0 {\n    margin-right: 0 !important;\n  }\n\n  .me-sm-1 {\n    margin-right: 0.25rem !important;\n  }\n\n  .me-sm-2 {\n    margin-right: 0.5rem !important;\n  }\n\n  .me-sm-3 {\n    margin-right: 1rem !important;\n  }\n\n  .me-sm-4 {\n    margin-right: 1.5rem !important;\n  }\n\n  .me-sm-5 {\n    margin-right: 3rem !important;\n  }\n\n  .me-sm-auto {\n    margin-right: auto !important;\n  }\n\n  .mb-sm-0 {\n    margin-bottom: 0 !important;\n  }\n\n  .mb-sm-1 {\n    margin-bottom: 0.25rem !important;\n  }\n\n  .mb-sm-2 {\n    margin-bottom: 0.5rem !important;\n  }\n\n  .mb-sm-3 {\n    margin-bottom: 1rem !important;\n  }\n\n  .mb-sm-4 {\n    margin-bottom: 1.5rem !important;\n  }\n\n  .mb-sm-5 {\n    margin-bottom: 3rem !important;\n  }\n\n  .mb-sm-auto {\n    margin-bottom: auto !important;\n  }\n\n  .ms-sm-0 {\n    margin-left: 0 !important;\n  }\n\n  .ms-sm-1 {\n    margin-left: 0.25rem !important;\n  }\n\n  .ms-sm-2 {\n    margin-left: 0.5rem !important;\n  }\n\n  .ms-sm-3 {\n    margin-left: 1rem !important;\n  }\n\n  .ms-sm-4 {\n    margin-left: 1.5rem !important;\n  }\n\n  .ms-sm-5 {\n    margin-left: 3rem !important;\n  }\n\n  .ms-sm-auto {\n    margin-left: auto !important;\n  }\n\n  .p-sm-0 {\n    padding: 0 !important;\n  }\n\n  .p-sm-1 {\n    padding: 0.25rem !important;\n  }\n\n  .p-sm-2 {\n    padding: 0.5rem !important;\n  }\n\n  .p-sm-3 {\n    padding: 1rem !important;\n  }\n\n  .p-sm-4 {\n    padding: 1.5rem !important;\n  }\n\n  .p-sm-5 {\n    padding: 3rem !important;\n  }\n\n  .px-sm-0 {\n    padding-right: 0 !important;\n    padding-left: 0 !important;\n  }\n\n  .px-sm-1 {\n    padding-right: 0.25rem !important;\n    padding-left: 0.25rem !important;\n  }\n\n  .px-sm-2 {\n    padding-right: 0.5rem !important;\n    padding-left: 0.5rem !important;\n  }\n\n  .px-sm-3 {\n    padding-right: 1rem !important;\n    padding-left: 1rem !important;\n  }\n\n  .px-sm-4 {\n    padding-right: 1.5rem !important;\n    padding-left: 1.5rem !important;\n  }\n\n  .px-sm-5 {\n    padding-right: 3rem !important;\n    padding-left: 3rem !important;\n  }\n\n  .py-sm-0 {\n    padding-top: 0 !important;\n    padding-bottom: 0 !important;\n  }\n\n  .py-sm-1 {\n    padding-top: 0.25rem !important;\n    padding-bottom: 0.25rem !important;\n  }\n\n  .py-sm-2 {\n    padding-top: 0.5rem !important;\n    padding-bottom: 0.5rem !important;\n  }\n\n  .py-sm-3 {\n    padding-top: 1rem !important;\n    padding-bottom: 1rem !important;\n  }\n\n  .py-sm-4 {\n    padding-top: 1.5rem !important;\n    padding-bottom: 1.5rem !important;\n  }\n\n  .py-sm-5 {\n    padding-top: 3rem !important;\n    padding-bottom: 3rem !important;\n  }\n\n  .pt-sm-0 {\n    padding-top: 0 !important;\n  }\n\n  .pt-sm-1 {\n    padding-top: 0.25rem !important;\n  }\n\n  .pt-sm-2 {\n    padding-top: 0.5rem !important;\n  }\n\n  .pt-sm-3 {\n    padding-top: 1rem !important;\n  }\n\n  .pt-sm-4 {\n    padding-top: 1.5rem !important;\n  }\n\n  .pt-sm-5 {\n    padding-top: 3rem !important;\n  }\n\n  .pe-sm-0 {\n    padding-right: 0 !important;\n  }\n\n  .pe-sm-1 {\n    padding-right: 0.25rem !important;\n  }\n\n  .pe-sm-2 {\n    padding-right: 0.5rem !important;\n  }\n\n  .pe-sm-3 {\n    padding-right: 1rem !important;\n  }\n\n  .pe-sm-4 {\n    padding-right: 1.5rem !important;\n  }\n\n  .pe-sm-5 {\n    padding-right: 3rem !important;\n  }\n\n  .pb-sm-0 {\n    padding-bottom: 0 !important;\n  }\n\n  .pb-sm-1 {\n    padding-bottom: 0.25rem !important;\n  }\n\n  .pb-sm-2 {\n    padding-bottom: 0.5rem !important;\n  }\n\n  .pb-sm-3 {\n    padding-bottom: 1rem !important;\n  }\n\n  .pb-sm-4 {\n    padding-bottom: 1.5rem !important;\n  }\n\n  .pb-sm-5 {\n    padding-bottom: 3rem !important;\n  }\n\n  .ps-sm-0 {\n    padding-left: 0 !important;\n  }\n\n  .ps-sm-1 {\n    padding-left: 0.25rem !important;\n  }\n\n  .ps-sm-2 {\n    padding-left: 0.5rem !important;\n  }\n\n  .ps-sm-3 {\n    padding-left: 1rem !important;\n  }\n\n  .ps-sm-4 {\n    padding-left: 1.5rem !important;\n  }\n\n  .ps-sm-5 {\n    padding-left: 3rem !important;\n  }\n\n  .text-sm-start {\n    text-align: left !important;\n  }\n\n  .text-sm-end {\n    text-align: right !important;\n  }\n\n  .text-sm-center {\n    text-align: center !important;\n  }\n}\n@media (min-width: 768px) {\n  .float-md-start {\n    float: left !important;\n  }\n\n  .float-md-end {\n    float: right !important;\n  }\n\n  .float-md-none {\n    float: none !important;\n  }\n\n  .d-md-inline {\n    display: inline !important;\n  }\n\n  .d-md-inline-block {\n    display: inline-block !important;\n  }\n\n  .d-md-block {\n    display: block !important;\n  }\n\n  .d-md-grid {\n    display: grid !important;\n  }\n\n  .d-md-table {\n    display: table !important;\n  }\n\n  .d-md-table-row {\n    display: table-row !important;\n  }\n\n  .d-md-table-cell {\n    display: table-cell !important;\n  }\n\n  .d-md-flex {\n    display: flex !important;\n  }\n\n  .d-md-inline-flex {\n    display: inline-flex !important;\n  }\n\n  .d-md-none {\n    display: none !important;\n  }\n\n  .flex-md-fill {\n    flex: 1 1 auto !important;\n  }\n\n  .flex-md-row {\n    flex-direction: row !important;\n  }\n\n  .flex-md-column {\n    flex-direction: column !important;\n  }\n\n  .flex-md-row-reverse {\n    flex-direction: row-reverse !important;\n  }\n\n  .flex-md-column-reverse {\n    flex-direction: column-reverse !important;\n  }\n\n  .flex-md-grow-0 {\n    flex-grow: 0 !important;\n  }\n\n  .flex-md-grow-1 {\n    flex-grow: 1 !important;\n  }\n\n  .flex-md-shrink-0 {\n    flex-shrink: 0 !important;\n  }\n\n  .flex-md-shrink-1 {\n    flex-shrink: 1 !important;\n  }\n\n  .flex-md-wrap {\n    flex-wrap: wrap !important;\n  }\n\n  .flex-md-nowrap {\n    flex-wrap: nowrap !important;\n  }\n\n  .flex-md-wrap-reverse {\n    flex-wrap: wrap-reverse !important;\n  }\n\n  .gap-md-0 {\n    gap: 0 !important;\n  }\n\n  .gap-md-1 {\n    gap: 0.25rem !important;\n  }\n\n  .gap-md-2 {\n    gap: 0.5rem !important;\n  }\n\n  .gap-md-3 {\n    gap: 1rem !important;\n  }\n\n  .gap-md-4 {\n    gap: 1.5rem !important;\n  }\n\n  .gap-md-5 {\n    gap: 3rem !important;\n  }\n\n  .justify-content-md-start {\n    justify-content: flex-start !important;\n  }\n\n  .justify-content-md-end {\n    justify-content: flex-end !important;\n  }\n\n  .justify-content-md-center {\n    justify-content: center !important;\n  }\n\n  .justify-content-md-between {\n    justify-content: space-between !important;\n  }\n\n  .justify-content-md-around {\n    justify-content: space-around !important;\n  }\n\n  .justify-content-md-evenly {\n    justify-content: space-evenly !important;\n  }\n\n  .align-items-md-start {\n    align-items: flex-start !important;\n  }\n\n  .align-items-md-end {\n    align-items: flex-end !important;\n  }\n\n  .align-items-md-center {\n    align-items: center !important;\n  }\n\n  .align-items-md-baseline {\n    align-items: baseline !important;\n  }\n\n  .align-items-md-stretch {\n    align-items: stretch !important;\n  }\n\n  .align-content-md-start {\n    align-content: flex-start !important;\n  }\n\n  .align-content-md-end {\n    align-content: flex-end !important;\n  }\n\n  .align-content-md-center {\n    align-content: center !important;\n  }\n\n  .align-content-md-between {\n    align-content: space-between !important;\n  }\n\n  .align-content-md-around {\n    align-content: space-around !important;\n  }\n\n  .align-content-md-stretch {\n    align-content: stretch !important;\n  }\n\n  .align-self-md-auto {\n    align-self: auto !important;\n  }\n\n  .align-self-md-start {\n    align-self: flex-start !important;\n  }\n\n  .align-self-md-end {\n    align-self: flex-end !important;\n  }\n\n  .align-self-md-center {\n    align-self: center !important;\n  }\n\n  .align-self-md-baseline {\n    align-self: baseline !important;\n  }\n\n  .align-self-md-stretch {\n    align-self: stretch !important;\n  }\n\n  .order-md-first {\n    order: -1 !important;\n  }\n\n  .order-md-0 {\n    order: 0 !important;\n  }\n\n  .order-md-1 {\n    order: 1 !important;\n  }\n\n  .order-md-2 {\n    order: 2 !important;\n  }\n\n  .order-md-3 {\n    order: 3 !important;\n  }\n\n  .order-md-4 {\n    order: 4 !important;\n  }\n\n  .order-md-5 {\n    order: 5 !important;\n  }\n\n  .order-md-last {\n    order: 6 !important;\n  }\n\n  .m-md-0 {\n    margin: 0 !important;\n  }\n\n  .m-md-1 {\n    margin: 0.25rem !important;\n  }\n\n  .m-md-2 {\n    margin: 0.5rem !important;\n  }\n\n  .m-md-3 {\n    margin: 1rem !important;\n  }\n\n  .m-md-4 {\n    margin: 1.5rem !important;\n  }\n\n  .m-md-5 {\n    margin: 3rem !important;\n  }\n\n  .m-md-auto {\n    margin: auto !important;\n  }\n\n  .mx-md-0 {\n    margin-right: 0 !important;\n    margin-left: 0 !important;\n  }\n\n  .mx-md-1 {\n    margin-right: 0.25rem !important;\n    margin-left: 0.25rem !important;\n  }\n\n  .mx-md-2 {\n    margin-right: 0.5rem !important;\n    margin-left: 0.5rem !important;\n  }\n\n  .mx-md-3 {\n    margin-right: 1rem !important;\n    margin-left: 1rem !important;\n  }\n\n  .mx-md-4 {\n    margin-right: 1.5rem !important;\n    margin-left: 1.5rem !important;\n  }\n\n  .mx-md-5 {\n    margin-right: 3rem !important;\n    margin-left: 3rem !important;\n  }\n\n  .mx-md-auto {\n    margin-right: auto !important;\n    margin-left: auto !important;\n  }\n\n  .my-md-0 {\n    margin-top: 0 !important;\n    margin-bottom: 0 !important;\n  }\n\n  .my-md-1 {\n    margin-top: 0.25rem !important;\n    margin-bottom: 0.25rem !important;\n  }\n\n  .my-md-2 {\n    margin-top: 0.5rem !important;\n    margin-bottom: 0.5rem !important;\n  }\n\n  .my-md-3 {\n    margin-top: 1rem !important;\n    margin-bottom: 1rem !important;\n  }\n\n  .my-md-4 {\n    margin-top: 1.5rem !important;\n    margin-bottom: 1.5rem !important;\n  }\n\n  .my-md-5 {\n    margin-top: 3rem !important;\n    margin-bottom: 3rem !important;\n  }\n\n  .my-md-auto {\n    margin-top: auto !important;\n    margin-bottom: auto !important;\n  }\n\n  .mt-md-0 {\n    margin-top: 0 !important;\n  }\n\n  .mt-md-1 {\n    margin-top: 0.25rem !important;\n  }\n\n  .mt-md-2 {\n    margin-top: 0.5rem !important;\n  }\n\n  .mt-md-3 {\n    margin-top: 1rem !important;\n  }\n\n  .mt-md-4 {\n    margin-top: 1.5rem !important;\n  }\n\n  .mt-md-5 {\n    margin-top: 3rem !important;\n  }\n\n  .mt-md-auto {\n    margin-top: auto !important;\n  }\n\n  .me-md-0 {\n    margin-right: 0 !important;\n  }\n\n  .me-md-1 {\n    margin-right: 0.25rem !important;\n  }\n\n  .me-md-2 {\n    margin-right: 0.5rem !important;\n  }\n\n  .me-md-3 {\n    margin-right: 1rem !important;\n  }\n\n  .me-md-4 {\n    margin-right: 1.5rem !important;\n  }\n\n  .me-md-5 {\n    margin-right: 3rem !important;\n  }\n\n  .me-md-auto {\n    margin-right: auto !important;\n  }\n\n  .mb-md-0 {\n    margin-bottom: 0 !important;\n  }\n\n  .mb-md-1 {\n    margin-bottom: 0.25rem !important;\n  }\n\n  .mb-md-2 {\n    margin-bottom: 0.5rem !important;\n  }\n\n  .mb-md-3 {\n    margin-bottom: 1rem !important;\n  }\n\n  .mb-md-4 {\n    margin-bottom: 1.5rem !important;\n  }\n\n  .mb-md-5 {\n    margin-bottom: 3rem !important;\n  }\n\n  .mb-md-auto {\n    margin-bottom: auto !important;\n  }\n\n  .ms-md-0 {\n    margin-left: 0 !important;\n  }\n\n  .ms-md-1 {\n    margin-left: 0.25rem !important;\n  }\n\n  .ms-md-2 {\n    margin-left: 0.5rem !important;\n  }\n\n  .ms-md-3 {\n    margin-left: 1rem !important;\n  }\n\n  .ms-md-4 {\n    margin-left: 1.5rem !important;\n  }\n\n  .ms-md-5 {\n    margin-left: 3rem !important;\n  }\n\n  .ms-md-auto {\n    margin-left: auto !important;\n  }\n\n  .p-md-0 {\n    padding: 0 !important;\n  }\n\n  .p-md-1 {\n    padding: 0.25rem !important;\n  }\n\n  .p-md-2 {\n    padding: 0.5rem !important;\n  }\n\n  .p-md-3 {\n    padding: 1rem !important;\n  }\n\n  .p-md-4 {\n    padding: 1.5rem !important;\n  }\n\n  .p-md-5 {\n    padding: 3rem !important;\n  }\n\n  .px-md-0 {\n    padding-right: 0 !important;\n    padding-left: 0 !important;\n  }\n\n  .px-md-1 {\n    padding-right: 0.25rem !important;\n    padding-left: 0.25rem !important;\n  }\n\n  .px-md-2 {\n    padding-right: 0.5rem !important;\n    padding-left: 0.5rem !important;\n  }\n\n  .px-md-3 {\n    padding-right: 1rem !important;\n    padding-left: 1rem !important;\n  }\n\n  .px-md-4 {\n    padding-right: 1.5rem !important;\n    padding-left: 1.5rem !important;\n  }\n\n  .px-md-5 {\n    padding-right: 3rem !important;\n    padding-left: 3rem !important;\n  }\n\n  .py-md-0 {\n    padding-top: 0 !important;\n    padding-bottom: 0 !important;\n  }\n\n  .py-md-1 {\n    padding-top: 0.25rem !important;\n    padding-bottom: 0.25rem !important;\n  }\n\n  .py-md-2 {\n    padding-top: 0.5rem !important;\n    padding-bottom: 0.5rem !important;\n  }\n\n  .py-md-3 {\n    padding-top: 1rem !important;\n    padding-bottom: 1rem !important;\n  }\n\n  .py-md-4 {\n    padding-top: 1.5rem !important;\n    padding-bottom: 1.5rem !important;\n  }\n\n  .py-md-5 {\n    padding-top: 3rem !important;\n    padding-bottom: 3rem !important;\n  }\n\n  .pt-md-0 {\n    padding-top: 0 !important;\n  }\n\n  .pt-md-1 {\n    padding-top: 0.25rem !important;\n  }\n\n  .pt-md-2 {\n    padding-top: 0.5rem !important;\n  }\n\n  .pt-md-3 {\n    padding-top: 1rem !important;\n  }\n\n  .pt-md-4 {\n    padding-top: 1.5rem !important;\n  }\n\n  .pt-md-5 {\n    padding-top: 3rem !important;\n  }\n\n  .pe-md-0 {\n    padding-right: 0 !important;\n  }\n\n  .pe-md-1 {\n    padding-right: 0.25rem !important;\n  }\n\n  .pe-md-2 {\n    padding-right: 0.5rem !important;\n  }\n\n  .pe-md-3 {\n    padding-right: 1rem !important;\n  }\n\n  .pe-md-4 {\n    padding-right: 1.5rem !important;\n  }\n\n  .pe-md-5 {\n    padding-right: 3rem !important;\n  }\n\n  .pb-md-0 {\n    padding-bottom: 0 !important;\n  }\n\n  .pb-md-1 {\n    padding-bottom: 0.25rem !important;\n  }\n\n  .pb-md-2 {\n    padding-bottom: 0.5rem !important;\n  }\n\n  .pb-md-3 {\n    padding-bottom: 1rem !important;\n  }\n\n  .pb-md-4 {\n    padding-bottom: 1.5rem !important;\n  }\n\n  .pb-md-5 {\n    padding-bottom: 3rem !important;\n  }\n\n  .ps-md-0 {\n    padding-left: 0 !important;\n  }\n\n  .ps-md-1 {\n    padding-left: 0.25rem !important;\n  }\n\n  .ps-md-2 {\n    padding-left: 0.5rem !important;\n  }\n\n  .ps-md-3 {\n    padding-left: 1rem !important;\n  }\n\n  .ps-md-4 {\n    padding-left: 1.5rem !important;\n  }\n\n  .ps-md-5 {\n    padding-left: 3rem !important;\n  }\n\n  .text-md-start {\n    text-align: left !important;\n  }\n\n  .text-md-end {\n    text-align: right !important;\n  }\n\n  .text-md-center {\n    text-align: center !important;\n  }\n}\n@media (min-width: 992px) {\n  .float-lg-start {\n    float: left !important;\n  }\n\n  .float-lg-end {\n    float: right !important;\n  }\n\n  .float-lg-none {\n    float: none !important;\n  }\n\n  .d-lg-inline {\n    display: inline !important;\n  }\n\n  .d-lg-inline-block {\n    display: inline-block !important;\n  }\n\n  .d-lg-block {\n    display: block !important;\n  }\n\n  .d-lg-grid {\n    display: grid !important;\n  }\n\n  .d-lg-table {\n    display: table !important;\n  }\n\n  .d-lg-table-row {\n    display: table-row !important;\n  }\n\n  .d-lg-table-cell {\n    display: table-cell !important;\n  }\n\n  .d-lg-flex {\n    display: flex !important;\n  }\n\n  .d-lg-inline-flex {\n    display: inline-flex !important;\n  }\n\n  .d-lg-none {\n    display: none !important;\n  }\n\n  .flex-lg-fill {\n    flex: 1 1 auto !important;\n  }\n\n  .flex-lg-row {\n    flex-direction: row !important;\n  }\n\n  .flex-lg-column {\n    flex-direction: column !important;\n  }\n\n  .flex-lg-row-reverse {\n    flex-direction: row-reverse !important;\n  }\n\n  .flex-lg-column-reverse {\n    flex-direction: column-reverse !important;\n  }\n\n  .flex-lg-grow-0 {\n    flex-grow: 0 !important;\n  }\n\n  .flex-lg-grow-1 {\n    flex-grow: 1 !important;\n  }\n\n  .flex-lg-shrink-0 {\n    flex-shrink: 0 !important;\n  }\n\n  .flex-lg-shrink-1 {\n    flex-shrink: 1 !important;\n  }\n\n  .flex-lg-wrap {\n    flex-wrap: wrap !important;\n  }\n\n  .flex-lg-nowrap {\n    flex-wrap: nowrap !important;\n  }\n\n  .flex-lg-wrap-reverse {\n    flex-wrap: wrap-reverse !important;\n  }\n\n  .gap-lg-0 {\n    gap: 0 !important;\n  }\n\n  .gap-lg-1 {\n    gap: 0.25rem !important;\n  }\n\n  .gap-lg-2 {\n    gap: 0.5rem !important;\n  }\n\n  .gap-lg-3 {\n    gap: 1rem !important;\n  }\n\n  .gap-lg-4 {\n    gap: 1.5rem !important;\n  }\n\n  .gap-lg-5 {\n    gap: 3rem !important;\n  }\n\n  .justify-content-lg-start {\n    justify-content: flex-start !important;\n  }\n\n  .justify-content-lg-end {\n    justify-content: flex-end !important;\n  }\n\n  .justify-content-lg-center {\n    justify-content: center !important;\n  }\n\n  .justify-content-lg-between {\n    justify-content: space-between !important;\n  }\n\n  .justify-content-lg-around {\n    justify-content: space-around !important;\n  }\n\n  .justify-content-lg-evenly {\n    justify-content: space-evenly !important;\n  }\n\n  .align-items-lg-start {\n    align-items: flex-start !important;\n  }\n\n  .align-items-lg-end {\n    align-items: flex-end !important;\n  }\n\n  .align-items-lg-center {\n    align-items: center !important;\n  }\n\n  .align-items-lg-baseline {\n    align-items: baseline !important;\n  }\n\n  .align-items-lg-stretch {\n    align-items: stretch !important;\n  }\n\n  .align-content-lg-start {\n    align-content: flex-start !important;\n  }\n\n  .align-content-lg-end {\n    align-content: flex-end !important;\n  }\n\n  .align-content-lg-center {\n    align-content: center !important;\n  }\n\n  .align-content-lg-between {\n    align-content: space-between !important;\n  }\n\n  .align-content-lg-around {\n    align-content: space-around !important;\n  }\n\n  .align-content-lg-stretch {\n    align-content: stretch !important;\n  }\n\n  .align-self-lg-auto {\n    align-self: auto !important;\n  }\n\n  .align-self-lg-start {\n    align-self: flex-start !important;\n  }\n\n  .align-self-lg-end {\n    align-self: flex-end !important;\n  }\n\n  .align-self-lg-center {\n    align-self: center !important;\n  }\n\n  .align-self-lg-baseline {\n    align-self: baseline !important;\n  }\n\n  .align-self-lg-stretch {\n    align-self: stretch !important;\n  }\n\n  .order-lg-first {\n    order: -1 !important;\n  }\n\n  .order-lg-0 {\n    order: 0 !important;\n  }\n\n  .order-lg-1 {\n    order: 1 !important;\n  }\n\n  .order-lg-2 {\n    order: 2 !important;\n  }\n\n  .order-lg-3 {\n    order: 3 !important;\n  }\n\n  .order-lg-4 {\n    order: 4 !important;\n  }\n\n  .order-lg-5 {\n    order: 5 !important;\n  }\n\n  .order-lg-last {\n    order: 6 !important;\n  }\n\n  .m-lg-0 {\n    margin: 0 !important;\n  }\n\n  .m-lg-1 {\n    margin: 0.25rem !important;\n  }\n\n  .m-lg-2 {\n    margin: 0.5rem !important;\n  }\n\n  .m-lg-3 {\n    margin: 1rem !important;\n  }\n\n  .m-lg-4 {\n    margin: 1.5rem !important;\n  }\n\n  .m-lg-5 {\n    margin: 3rem !important;\n  }\n\n  .m-lg-auto {\n    margin: auto !important;\n  }\n\n  .mx-lg-0 {\n    margin-right: 0 !important;\n    margin-left: 0 !important;\n  }\n\n  .mx-lg-1 {\n    margin-right: 0.25rem !important;\n    margin-left: 0.25rem !important;\n  }\n\n  .mx-lg-2 {\n    margin-right: 0.5rem !important;\n    margin-left: 0.5rem !important;\n  }\n\n  .mx-lg-3 {\n    margin-right: 1rem !important;\n    margin-left: 1rem !important;\n  }\n\n  .mx-lg-4 {\n    margin-right: 1.5rem !important;\n    margin-left: 1.5rem !important;\n  }\n\n  .mx-lg-5 {\n    margin-right: 3rem !important;\n    margin-left: 3rem !important;\n  }\n\n  .mx-lg-auto {\n    margin-right: auto !important;\n    margin-left: auto !important;\n  }\n\n  .my-lg-0 {\n    margin-top: 0 !important;\n    margin-bottom: 0 !important;\n  }\n\n  .my-lg-1 {\n    margin-top: 0.25rem !important;\n    margin-bottom: 0.25rem !important;\n  }\n\n  .my-lg-2 {\n    margin-top: 0.5rem !important;\n    margin-bottom: 0.5rem !important;\n  }\n\n  .my-lg-3 {\n    margin-top: 1rem !important;\n    margin-bottom: 1rem !important;\n  }\n\n  .my-lg-4 {\n    margin-top: 1.5rem !important;\n    margin-bottom: 1.5rem !important;\n  }\n\n  .my-lg-5 {\n    margin-top: 3rem !important;\n    margin-bottom: 3rem !important;\n  }\n\n  .my-lg-auto {\n    margin-top: auto !important;\n    margin-bottom: auto !important;\n  }\n\n  .mt-lg-0 {\n    margin-top: 0 !important;\n  }\n\n  .mt-lg-1 {\n    margin-top: 0.25rem !important;\n  }\n\n  .mt-lg-2 {\n    margin-top: 0.5rem !important;\n  }\n\n  .mt-lg-3 {\n    margin-top: 1rem !important;\n  }\n\n  .mt-lg-4 {\n    margin-top: 1.5rem !important;\n  }\n\n  .mt-lg-5 {\n    margin-top: 3rem !important;\n  }\n\n  .mt-lg-auto {\n    margin-top: auto !important;\n  }\n\n  .me-lg-0 {\n    margin-right: 0 !important;\n  }\n\n  .me-lg-1 {\n    margin-right: 0.25rem !important;\n  }\n\n  .me-lg-2 {\n    margin-right: 0.5rem !important;\n  }\n\n  .me-lg-3 {\n    margin-right: 1rem !important;\n  }\n\n  .me-lg-4 {\n    margin-right: 1.5rem !important;\n  }\n\n  .me-lg-5 {\n    margin-right: 3rem !important;\n  }\n\n  .me-lg-auto {\n    margin-right: auto !important;\n  }\n\n  .mb-lg-0 {\n    margin-bottom: 0 !important;\n  }\n\n  .mb-lg-1 {\n    margin-bottom: 0.25rem !important;\n  }\n\n  .mb-lg-2 {\n    margin-bottom: 0.5rem !important;\n  }\n\n  .mb-lg-3 {\n    margin-bottom: 1rem !important;\n  }\n\n  .mb-lg-4 {\n    margin-bottom: 1.5rem !important;\n  }\n\n  .mb-lg-5 {\n    margin-bottom: 3rem !important;\n  }\n\n  .mb-lg-auto {\n    margin-bottom: auto !important;\n  }\n\n  .ms-lg-0 {\n    margin-left: 0 !important;\n  }\n\n  .ms-lg-1 {\n    margin-left: 0.25rem !important;\n  }\n\n  .ms-lg-2 {\n    margin-left: 0.5rem !important;\n  }\n\n  .ms-lg-3 {\n    margin-left: 1rem !important;\n  }\n\n  .ms-lg-4 {\n    margin-left: 1.5rem !important;\n  }\n\n  .ms-lg-5 {\n    margin-left: 3rem !important;\n  }\n\n  .ms-lg-auto {\n    margin-left: auto !important;\n  }\n\n  .p-lg-0 {\n    padding: 0 !important;\n  }\n\n  .p-lg-1 {\n    padding: 0.25rem !important;\n  }\n\n  .p-lg-2 {\n    padding: 0.5rem !important;\n  }\n\n  .p-lg-3 {\n    padding: 1rem !important;\n  }\n\n  .p-lg-4 {\n    padding: 1.5rem !important;\n  }\n\n  .p-lg-5 {\n    padding: 3rem !important;\n  }\n\n  .px-lg-0 {\n    padding-right: 0 !important;\n    padding-left: 0 !important;\n  }\n\n  .px-lg-1 {\n    padding-right: 0.25rem !important;\n    padding-left: 0.25rem !important;\n  }\n\n  .px-lg-2 {\n    padding-right: 0.5rem !important;\n    padding-left: 0.5rem !important;\n  }\n\n  .px-lg-3 {\n    padding-right: 1rem !important;\n    padding-left: 1rem !important;\n  }\n\n  .px-lg-4 {\n    padding-right: 1.5rem !important;\n    padding-left: 1.5rem !important;\n  }\n\n  .px-lg-5 {\n    padding-right: 3rem !important;\n    padding-left: 3rem !important;\n  }\n\n  .py-lg-0 {\n    padding-top: 0 !important;\n    padding-bottom: 0 !important;\n  }\n\n  .py-lg-1 {\n    padding-top: 0.25rem !important;\n    padding-bottom: 0.25rem !important;\n  }\n\n  .py-lg-2 {\n    padding-top: 0.5rem !important;\n    padding-bottom: 0.5rem !important;\n  }\n\n  .py-lg-3 {\n    padding-top: 1rem !important;\n    padding-bottom: 1rem !important;\n  }\n\n  .py-lg-4 {\n    padding-top: 1.5rem !important;\n    padding-bottom: 1.5rem !important;\n  }\n\n  .py-lg-5 {\n    padding-top: 3rem !important;\n    padding-bottom: 3rem !important;\n  }\n\n  .pt-lg-0 {\n    padding-top: 0 !important;\n  }\n\n  .pt-lg-1 {\n    padding-top: 0.25rem !important;\n  }\n\n  .pt-lg-2 {\n    padding-top: 0.5rem !important;\n  }\n\n  .pt-lg-3 {\n    padding-top: 1rem !important;\n  }\n\n  .pt-lg-4 {\n    padding-top: 1.5rem !important;\n  }\n\n  .pt-lg-5 {\n    padding-top: 3rem !important;\n  }\n\n  .pe-lg-0 {\n    padding-right: 0 !important;\n  }\n\n  .pe-lg-1 {\n    padding-right: 0.25rem !important;\n  }\n\n  .pe-lg-2 {\n    padding-right: 0.5rem !important;\n  }\n\n  .pe-lg-3 {\n    padding-right: 1rem !important;\n  }\n\n  .pe-lg-4 {\n    padding-right: 1.5rem !important;\n  }\n\n  .pe-lg-5 {\n    padding-right: 3rem !important;\n  }\n\n  .pb-lg-0 {\n    padding-bottom: 0 !important;\n  }\n\n  .pb-lg-1 {\n    padding-bottom: 0.25rem !important;\n  }\n\n  .pb-lg-2 {\n    padding-bottom: 0.5rem !important;\n  }\n\n  .pb-lg-3 {\n    padding-bottom: 1rem !important;\n  }\n\n  .pb-lg-4 {\n    padding-bottom: 1.5rem !important;\n  }\n\n  .pb-lg-5 {\n    padding-bottom: 3rem !important;\n  }\n\n  .ps-lg-0 {\n    padding-left: 0 !important;\n  }\n\n  .ps-lg-1 {\n    padding-left: 0.25rem !important;\n  }\n\n  .ps-lg-2 {\n    padding-left: 0.5rem !important;\n  }\n\n  .ps-lg-3 {\n    padding-left: 1rem !important;\n  }\n\n  .ps-lg-4 {\n    padding-left: 1.5rem !important;\n  }\n\n  .ps-lg-5 {\n    padding-left: 3rem !important;\n  }\n\n  .text-lg-start {\n    text-align: left !important;\n  }\n\n  .text-lg-end {\n    text-align: right !important;\n  }\n\n  .text-lg-center {\n    text-align: center !important;\n  }\n}\n@media (min-width: 1200px) {\n  .float-xl-start {\n    float: left !important;\n  }\n\n  .float-xl-end {\n    float: right !important;\n  }\n\n  .float-xl-none {\n    float: none !important;\n  }\n\n  .d-xl-inline {\n    display: inline !important;\n  }\n\n  .d-xl-inline-block {\n    display: inline-block !important;\n  }\n\n  .d-xl-block {\n    display: block !important;\n  }\n\n  .d-xl-grid {\n    display: grid !important;\n  }\n\n  .d-xl-table {\n    display: table !important;\n  }\n\n  .d-xl-table-row {\n    display: table-row !important;\n  }\n\n  .d-xl-table-cell {\n    display: table-cell !important;\n  }\n\n  .d-xl-flex {\n    display: flex !important;\n  }\n\n  .d-xl-inline-flex {\n    display: inline-flex !important;\n  }\n\n  .d-xl-none {\n    display: none !important;\n  }\n\n  .flex-xl-fill {\n    flex: 1 1 auto !important;\n  }\n\n  .flex-xl-row {\n    flex-direction: row !important;\n  }\n\n  .flex-xl-column {\n    flex-direction: column !important;\n  }\n\n  .flex-xl-row-reverse {\n    flex-direction: row-reverse !important;\n  }\n\n  .flex-xl-column-reverse {\n    flex-direction: column-reverse !important;\n  }\n\n  .flex-xl-grow-0 {\n    flex-grow: 0 !important;\n  }\n\n  .flex-xl-grow-1 {\n    flex-grow: 1 !important;\n  }\n\n  .flex-xl-shrink-0 {\n    flex-shrink: 0 !important;\n  }\n\n  .flex-xl-shrink-1 {\n    flex-shrink: 1 !important;\n  }\n\n  .flex-xl-wrap {\n    flex-wrap: wrap !important;\n  }\n\n  .flex-xl-nowrap {\n    flex-wrap: nowrap !important;\n  }\n\n  .flex-xl-wrap-reverse {\n    flex-wrap: wrap-reverse !important;\n  }\n\n  .gap-xl-0 {\n    gap: 0 !important;\n  }\n\n  .gap-xl-1 {\n    gap: 0.25rem !important;\n  }\n\n  .gap-xl-2 {\n    gap: 0.5rem !important;\n  }\n\n  .gap-xl-3 {\n    gap: 1rem !important;\n  }\n\n  .gap-xl-4 {\n    gap: 1.5rem !important;\n  }\n\n  .gap-xl-5 {\n    gap: 3rem !important;\n  }\n\n  .justify-content-xl-start {\n    justify-content: flex-start !important;\n  }\n\n  .justify-content-xl-end {\n    justify-content: flex-end !important;\n  }\n\n  .justify-content-xl-center {\n    justify-content: center !important;\n  }\n\n  .justify-content-xl-between {\n    justify-content: space-between !important;\n  }\n\n  .justify-content-xl-around {\n    justify-content: space-around !important;\n  }\n\n  .justify-content-xl-evenly {\n    justify-content: space-evenly !important;\n  }\n\n  .align-items-xl-start {\n    align-items: flex-start !important;\n  }\n\n  .align-items-xl-end {\n    align-items: flex-end !important;\n  }\n\n  .align-items-xl-center {\n    align-items: center !important;\n  }\n\n  .align-items-xl-baseline {\n    align-items: baseline !important;\n  }\n\n  .align-items-xl-stretch {\n    align-items: stretch !important;\n  }\n\n  .align-content-xl-start {\n    align-content: flex-start !important;\n  }\n\n  .align-content-xl-end {\n    align-content: flex-end !important;\n  }\n\n  .align-content-xl-center {\n    align-content: center !important;\n  }\n\n  .align-content-xl-between {\n    align-content: space-between !important;\n  }\n\n  .align-content-xl-around {\n    align-content: space-around !important;\n  }\n\n  .align-content-xl-stretch {\n    align-content: stretch !important;\n  }\n\n  .align-self-xl-auto {\n    align-self: auto !important;\n  }\n\n  .align-self-xl-start {\n    align-self: flex-start !important;\n  }\n\n  .align-self-xl-end {\n    align-self: flex-end !important;\n  }\n\n  .align-self-xl-center {\n    align-self: center !important;\n  }\n\n  .align-self-xl-baseline {\n    align-self: baseline !important;\n  }\n\n  .align-self-xl-stretch {\n    align-self: stretch !important;\n  }\n\n  .order-xl-first {\n    order: -1 !important;\n  }\n\n  .order-xl-0 {\n    order: 0 !important;\n  }\n\n  .order-xl-1 {\n    order: 1 !important;\n  }\n\n  .order-xl-2 {\n    order: 2 !important;\n  }\n\n  .order-xl-3 {\n    order: 3 !important;\n  }\n\n  .order-xl-4 {\n    order: 4 !important;\n  }\n\n  .order-xl-5 {\n    order: 5 !important;\n  }\n\n  .order-xl-last {\n    order: 6 !important;\n  }\n\n  .m-xl-0 {\n    margin: 0 !important;\n  }\n\n  .m-xl-1 {\n    margin: 0.25rem !important;\n  }\n\n  .m-xl-2 {\n    margin: 0.5rem !important;\n  }\n\n  .m-xl-3 {\n    margin: 1rem !important;\n  }\n\n  .m-xl-4 {\n    margin: 1.5rem !important;\n  }\n\n  .m-xl-5 {\n    margin: 3rem !important;\n  }\n\n  .m-xl-auto {\n    margin: auto !important;\n  }\n\n  .mx-xl-0 {\n    margin-right: 0 !important;\n    margin-left: 0 !important;\n  }\n\n  .mx-xl-1 {\n    margin-right: 0.25rem !important;\n    margin-left: 0.25rem !important;\n  }\n\n  .mx-xl-2 {\n    margin-right: 0.5rem !important;\n    margin-left: 0.5rem !important;\n  }\n\n  .mx-xl-3 {\n    margin-right: 1rem !important;\n    margin-left: 1rem !important;\n  }\n\n  .mx-xl-4 {\n    margin-right: 1.5rem !important;\n    margin-left: 1.5rem !important;\n  }\n\n  .mx-xl-5 {\n    margin-right: 3rem !important;\n    margin-left: 3rem !important;\n  }\n\n  .mx-xl-auto {\n    margin-right: auto !important;\n    margin-left: auto !important;\n  }\n\n  .my-xl-0 {\n    margin-top: 0 !important;\n    margin-bottom: 0 !important;\n  }\n\n  .my-xl-1 {\n    margin-top: 0.25rem !important;\n    margin-bottom: 0.25rem !important;\n  }\n\n  .my-xl-2 {\n    margin-top: 0.5rem !important;\n    margin-bottom: 0.5rem !important;\n  }\n\n  .my-xl-3 {\n    margin-top: 1rem !important;\n    margin-bottom: 1rem !important;\n  }\n\n  .my-xl-4 {\n    margin-top: 1.5rem !important;\n    margin-bottom: 1.5rem !important;\n  }\n\n  .my-xl-5 {\n    margin-top: 3rem !important;\n    margin-bottom: 3rem !important;\n  }\n\n  .my-xl-auto {\n    margin-top: auto !important;\n    margin-bottom: auto !important;\n  }\n\n  .mt-xl-0 {\n    margin-top: 0 !important;\n  }\n\n  .mt-xl-1 {\n    margin-top: 0.25rem !important;\n  }\n\n  .mt-xl-2 {\n    margin-top: 0.5rem !important;\n  }\n\n  .mt-xl-3 {\n    margin-top: 1rem !important;\n  }\n\n  .mt-xl-4 {\n    margin-top: 1.5rem !important;\n  }\n\n  .mt-xl-5 {\n    margin-top: 3rem !important;\n  }\n\n  .mt-xl-auto {\n    margin-top: auto !important;\n  }\n\n  .me-xl-0 {\n    margin-right: 0 !important;\n  }\n\n  .me-xl-1 {\n    margin-right: 0.25rem !important;\n  }\n\n  .me-xl-2 {\n    margin-right: 0.5rem !important;\n  }\n\n  .me-xl-3 {\n    margin-right: 1rem !important;\n  }\n\n  .me-xl-4 {\n    margin-right: 1.5rem !important;\n  }\n\n  .me-xl-5 {\n    margin-right: 3rem !important;\n  }\n\n  .me-xl-auto {\n    margin-right: auto !important;\n  }\n\n  .mb-xl-0 {\n    margin-bottom: 0 !important;\n  }\n\n  .mb-xl-1 {\n    margin-bottom: 0.25rem !important;\n  }\n\n  .mb-xl-2 {\n    margin-bottom: 0.5rem !important;\n  }\n\n  .mb-xl-3 {\n    margin-bottom: 1rem !important;\n  }\n\n  .mb-xl-4 {\n    margin-bottom: 1.5rem !important;\n  }\n\n  .mb-xl-5 {\n    margin-bottom: 3rem !important;\n  }\n\n  .mb-xl-auto {\n    margin-bottom: auto !important;\n  }\n\n  .ms-xl-0 {\n    margin-left: 0 !important;\n  }\n\n  .ms-xl-1 {\n    margin-left: 0.25rem !important;\n  }\n\n  .ms-xl-2 {\n    margin-left: 0.5rem !important;\n  }\n\n  .ms-xl-3 {\n    margin-left: 1rem !important;\n  }\n\n  .ms-xl-4 {\n    margin-left: 1.5rem !important;\n  }\n\n  .ms-xl-5 {\n    margin-left: 3rem !important;\n  }\n\n  .ms-xl-auto {\n    margin-left: auto !important;\n  }\n\n  .p-xl-0 {\n    padding: 0 !important;\n  }\n\n  .p-xl-1 {\n    padding: 0.25rem !important;\n  }\n\n  .p-xl-2 {\n    padding: 0.5rem !important;\n  }\n\n  .p-xl-3 {\n    padding: 1rem !important;\n  }\n\n  .p-xl-4 {\n    padding: 1.5rem !important;\n  }\n\n  .p-xl-5 {\n    padding: 3rem !important;\n  }\n\n  .px-xl-0 {\n    padding-right: 0 !important;\n    padding-left: 0 !important;\n  }\n\n  .px-xl-1 {\n    padding-right: 0.25rem !important;\n    padding-left: 0.25rem !important;\n  }\n\n  .px-xl-2 {\n    padding-right: 0.5rem !important;\n    padding-left: 0.5rem !important;\n  }\n\n  .px-xl-3 {\n    padding-right: 1rem !important;\n    padding-left: 1rem !important;\n  }\n\n  .px-xl-4 {\n    padding-right: 1.5rem !important;\n    padding-left: 1.5rem !important;\n  }\n\n  .px-xl-5 {\n    padding-right: 3rem !important;\n    padding-left: 3rem !important;\n  }\n\n  .py-xl-0 {\n    padding-top: 0 !important;\n    padding-bottom: 0 !important;\n  }\n\n  .py-xl-1 {\n    padding-top: 0.25rem !important;\n    padding-bottom: 0.25rem !important;\n  }\n\n  .py-xl-2 {\n    padding-top: 0.5rem !important;\n    padding-bottom: 0.5rem !important;\n  }\n\n  .py-xl-3 {\n    padding-top: 1rem !important;\n    padding-bottom: 1rem !important;\n  }\n\n  .py-xl-4 {\n    padding-top: 1.5rem !important;\n    padding-bottom: 1.5rem !important;\n  }\n\n  .py-xl-5 {\n    padding-top: 3rem !important;\n    padding-bottom: 3rem !important;\n  }\n\n  .pt-xl-0 {\n    padding-top: 0 !important;\n  }\n\n  .pt-xl-1 {\n    padding-top: 0.25rem !important;\n  }\n\n  .pt-xl-2 {\n    padding-top: 0.5rem !important;\n  }\n\n  .pt-xl-3 {\n    padding-top: 1rem !important;\n  }\n\n  .pt-xl-4 {\n    padding-top: 1.5rem !important;\n  }\n\n  .pt-xl-5 {\n    padding-top: 3rem !important;\n  }\n\n  .pe-xl-0 {\n    padding-right: 0 !important;\n  }\n\n  .pe-xl-1 {\n    padding-right: 0.25rem !important;\n  }\n\n  .pe-xl-2 {\n    padding-right: 0.5rem !important;\n  }\n\n  .pe-xl-3 {\n    padding-right: 1rem !important;\n  }\n\n  .pe-xl-4 {\n    padding-right: 1.5rem !important;\n  }\n\n  .pe-xl-5 {\n    padding-right: 3rem !important;\n  }\n\n  .pb-xl-0 {\n    padding-bottom: 0 !important;\n  }\n\n  .pb-xl-1 {\n    padding-bottom: 0.25rem !important;\n  }\n\n  .pb-xl-2 {\n    padding-bottom: 0.5rem !important;\n  }\n\n  .pb-xl-3 {\n    padding-bottom: 1rem !important;\n  }\n\n  .pb-xl-4 {\n    padding-bottom: 1.5rem !important;\n  }\n\n  .pb-xl-5 {\n    padding-bottom: 3rem !important;\n  }\n\n  .ps-xl-0 {\n    padding-left: 0 !important;\n  }\n\n  .ps-xl-1 {\n    padding-left: 0.25rem !important;\n  }\n\n  .ps-xl-2 {\n    padding-left: 0.5rem !important;\n  }\n\n  .ps-xl-3 {\n    padding-left: 1rem !important;\n  }\n\n  .ps-xl-4 {\n    padding-left: 1.5rem !important;\n  }\n\n  .ps-xl-5 {\n    padding-left: 3rem !important;\n  }\n\n  .text-xl-start {\n    text-align: left !important;\n  }\n\n  .text-xl-end {\n    text-align: right !important;\n  }\n\n  .text-xl-center {\n    text-align: center !important;\n  }\n}\n@media (min-width: 1400px) {\n  .float-xxl-start {\n    float: left !important;\n  }\n\n  .float-xxl-end {\n    float: right !important;\n  }\n\n  .float-xxl-none {\n    float: none !important;\n  }\n\n  .d-xxl-inline {\n    display: inline !important;\n  }\n\n  .d-xxl-inline-block {\n    display: inline-block !important;\n  }\n\n  .d-xxl-block {\n    display: block !important;\n  }\n\n  .d-xxl-grid {\n    display: grid !important;\n  }\n\n  .d-xxl-table {\n    display: table !important;\n  }\n\n  .d-xxl-table-row {\n    display: table-row !important;\n  }\n\n  .d-xxl-table-cell {\n    display: table-cell !important;\n  }\n\n  .d-xxl-flex {\n    display: flex !important;\n  }\n\n  .d-xxl-inline-flex {\n    display: inline-flex !important;\n  }\n\n  .d-xxl-none {\n    display: none !important;\n  }\n\n  .flex-xxl-fill {\n    flex: 1 1 auto !important;\n  }\n\n  .flex-xxl-row {\n    flex-direction: row !important;\n  }\n\n  .flex-xxl-column {\n    flex-direction: column !important;\n  }\n\n  .flex-xxl-row-reverse {\n    flex-direction: row-reverse !important;\n  }\n\n  .flex-xxl-column-reverse {\n    flex-direction: column-reverse !important;\n  }\n\n  .flex-xxl-grow-0 {\n    flex-grow: 0 !important;\n  }\n\n  .flex-xxl-grow-1 {\n    flex-grow: 1 !important;\n  }\n\n  .flex-xxl-shrink-0 {\n    flex-shrink: 0 !important;\n  }\n\n  .flex-xxl-shrink-1 {\n    flex-shrink: 1 !important;\n  }\n\n  .flex-xxl-wrap {\n    flex-wrap: wrap !important;\n  }\n\n  .flex-xxl-nowrap {\n    flex-wrap: nowrap !important;\n  }\n\n  .flex-xxl-wrap-reverse {\n    flex-wrap: wrap-reverse !important;\n  }\n\n  .gap-xxl-0 {\n    gap: 0 !important;\n  }\n\n  .gap-xxl-1 {\n    gap: 0.25rem !important;\n  }\n\n  .gap-xxl-2 {\n    gap: 0.5rem !important;\n  }\n\n  .gap-xxl-3 {\n    gap: 1rem !important;\n  }\n\n  .gap-xxl-4 {\n    gap: 1.5rem !important;\n  }\n\n  .gap-xxl-5 {\n    gap: 3rem !important;\n  }\n\n  .justify-content-xxl-start {\n    justify-content: flex-start !important;\n  }\n\n  .justify-content-xxl-end {\n    justify-content: flex-end !important;\n  }\n\n  .justify-content-xxl-center {\n    justify-content: center !important;\n  }\n\n  .justify-content-xxl-between {\n    justify-content: space-between !important;\n  }\n\n  .justify-content-xxl-around {\n    justify-content: space-around !important;\n  }\n\n  .justify-content-xxl-evenly {\n    justify-content: space-evenly !important;\n  }\n\n  .align-items-xxl-start {\n    align-items: flex-start !important;\n  }\n\n  .align-items-xxl-end {\n    align-items: flex-end !important;\n  }\n\n  .align-items-xxl-center {\n    align-items: center !important;\n  }\n\n  .align-items-xxl-baseline {\n    align-items: baseline !important;\n  }\n\n  .align-items-xxl-stretch {\n    align-items: stretch !important;\n  }\n\n  .align-content-xxl-start {\n    align-content: flex-start !important;\n  }\n\n  .align-content-xxl-end {\n    align-content: flex-end !important;\n  }\n\n  .align-content-xxl-center {\n    align-content: center !important;\n  }\n\n  .align-content-xxl-between {\n    align-content: space-between !important;\n  }\n\n  .align-content-xxl-around {\n    align-content: space-around !important;\n  }\n\n  .align-content-xxl-stretch {\n    align-content: stretch !important;\n  }\n\n  .align-self-xxl-auto {\n    align-self: auto !important;\n  }\n\n  .align-self-xxl-start {\n    align-self: flex-start !important;\n  }\n\n  .align-self-xxl-end {\n    align-self: flex-end !important;\n  }\n\n  .align-self-xxl-center {\n    align-self: center !important;\n  }\n\n  .align-self-xxl-baseline {\n    align-self: baseline !important;\n  }\n\n  .align-self-xxl-stretch {\n    align-self: stretch !important;\n  }\n\n  .order-xxl-first {\n    order: -1 !important;\n  }\n\n  .order-xxl-0 {\n    order: 0 !important;\n  }\n\n  .order-xxl-1 {\n    order: 1 !important;\n  }\n\n  .order-xxl-2 {\n    order: 2 !important;\n  }\n\n  .order-xxl-3 {\n    order: 3 !important;\n  }\n\n  .order-xxl-4 {\n    order: 4 !important;\n  }\n\n  .order-xxl-5 {\n    order: 5 !important;\n  }\n\n  .order-xxl-last {\n    order: 6 !important;\n  }\n\n  .m-xxl-0 {\n    margin: 0 !important;\n  }\n\n  .m-xxl-1 {\n    margin: 0.25rem !important;\n  }\n\n  .m-xxl-2 {\n    margin: 0.5rem !important;\n  }\n\n  .m-xxl-3 {\n    margin: 1rem !important;\n  }\n\n  .m-xxl-4 {\n    margin: 1.5rem !important;\n  }\n\n  .m-xxl-5 {\n    margin: 3rem !important;\n  }\n\n  .m-xxl-auto {\n    margin: auto !important;\n  }\n\n  .mx-xxl-0 {\n    margin-right: 0 !important;\n    margin-left: 0 !important;\n  }\n\n  .mx-xxl-1 {\n    margin-right: 0.25rem !important;\n    margin-left: 0.25rem !important;\n  }\n\n  .mx-xxl-2 {\n    margin-right: 0.5rem !important;\n    margin-left: 0.5rem !important;\n  }\n\n  .mx-xxl-3 {\n    margin-right: 1rem !important;\n    margin-left: 1rem !important;\n  }\n\n  .mx-xxl-4 {\n    margin-right: 1.5rem !important;\n    margin-left: 1.5rem !important;\n  }\n\n  .mx-xxl-5 {\n    margin-right: 3rem !important;\n    margin-left: 3rem !important;\n  }\n\n  .mx-xxl-auto {\n    margin-right: auto !important;\n    margin-left: auto !important;\n  }\n\n  .my-xxl-0 {\n    margin-top: 0 !important;\n    margin-bottom: 0 !important;\n  }\n\n  .my-xxl-1 {\n    margin-top: 0.25rem !important;\n    margin-bottom: 0.25rem !important;\n  }\n\n  .my-xxl-2 {\n    margin-top: 0.5rem !important;\n    margin-bottom: 0.5rem !important;\n  }\n\n  .my-xxl-3 {\n    margin-top: 1rem !important;\n    margin-bottom: 1rem !important;\n  }\n\n  .my-xxl-4 {\n    margin-top: 1.5rem !important;\n    margin-bottom: 1.5rem !important;\n  }\n\n  .my-xxl-5 {\n    margin-top: 3rem !important;\n    margin-bottom: 3rem !important;\n  }\n\n  .my-xxl-auto {\n    margin-top: auto !important;\n    margin-bottom: auto !important;\n  }\n\n  .mt-xxl-0 {\n    margin-top: 0 !important;\n  }\n\n  .mt-xxl-1 {\n    margin-top: 0.25rem !important;\n  }\n\n  .mt-xxl-2 {\n    margin-top: 0.5rem !important;\n  }\n\n  .mt-xxl-3 {\n    margin-top: 1rem !important;\n  }\n\n  .mt-xxl-4 {\n    margin-top: 1.5rem !important;\n  }\n\n  .mt-xxl-5 {\n    margin-top: 3rem !important;\n  }\n\n  .mt-xxl-auto {\n    margin-top: auto !important;\n  }\n\n  .me-xxl-0 {\n    margin-right: 0 !important;\n  }\n\n  .me-xxl-1 {\n    margin-right: 0.25rem !important;\n  }\n\n  .me-xxl-2 {\n    margin-right: 0.5rem !important;\n  }\n\n  .me-xxl-3 {\n    margin-right: 1rem !important;\n  }\n\n  .me-xxl-4 {\n    margin-right: 1.5rem !important;\n  }\n\n  .me-xxl-5 {\n    margin-right: 3rem !important;\n  }\n\n  .me-xxl-auto {\n    margin-right: auto !important;\n  }\n\n  .mb-xxl-0 {\n    margin-bottom: 0 !important;\n  }\n\n  .mb-xxl-1 {\n    margin-bottom: 0.25rem !important;\n  }\n\n  .mb-xxl-2 {\n    margin-bottom: 0.5rem !important;\n  }\n\n  .mb-xxl-3 {\n    margin-bottom: 1rem !important;\n  }\n\n  .mb-xxl-4 {\n    margin-bottom: 1.5rem !important;\n  }\n\n  .mb-xxl-5 {\n    margin-bottom: 3rem !important;\n  }\n\n  .mb-xxl-auto {\n    margin-bottom: auto !important;\n  }\n\n  .ms-xxl-0 {\n    margin-left: 0 !important;\n  }\n\n  .ms-xxl-1 {\n    margin-left: 0.25rem !important;\n  }\n\n  .ms-xxl-2 {\n    margin-left: 0.5rem !important;\n  }\n\n  .ms-xxl-3 {\n    margin-left: 1rem !important;\n  }\n\n  .ms-xxl-4 {\n    margin-left: 1.5rem !important;\n  }\n\n  .ms-xxl-5 {\n    margin-left: 3rem !important;\n  }\n\n  .ms-xxl-auto {\n    margin-left: auto !important;\n  }\n\n  .p-xxl-0 {\n    padding: 0 !important;\n  }\n\n  .p-xxl-1 {\n    padding: 0.25rem !important;\n  }\n\n  .p-xxl-2 {\n    padding: 0.5rem !important;\n  }\n\n  .p-xxl-3 {\n    padding: 1rem !important;\n  }\n\n  .p-xxl-4 {\n    padding: 1.5rem !important;\n  }\n\n  .p-xxl-5 {\n    padding: 3rem !important;\n  }\n\n  .px-xxl-0 {\n    padding-right: 0 !important;\n    padding-left: 0 !important;\n  }\n\n  .px-xxl-1 {\n    padding-right: 0.25rem !important;\n    padding-left: 0.25rem !important;\n  }\n\n  .px-xxl-2 {\n    padding-right: 0.5rem !important;\n    padding-left: 0.5rem !important;\n  }\n\n  .px-xxl-3 {\n    padding-right: 1rem !important;\n    padding-left: 1rem !important;\n  }\n\n  .px-xxl-4 {\n    padding-right: 1.5rem !important;\n    padding-left: 1.5rem !important;\n  }\n\n  .px-xxl-5 {\n    padding-right: 3rem !important;\n    padding-left: 3rem !important;\n  }\n\n  .py-xxl-0 {\n    padding-top: 0 !important;\n    padding-bottom: 0 !important;\n  }\n\n  .py-xxl-1 {\n    padding-top: 0.25rem !important;\n    padding-bottom: 0.25rem !important;\n  }\n\n  .py-xxl-2 {\n    padding-top: 0.5rem !important;\n    padding-bottom: 0.5rem !important;\n  }\n\n  .py-xxl-3 {\n    padding-top: 1rem !important;\n    padding-bottom: 1rem !important;\n  }\n\n  .py-xxl-4 {\n    padding-top: 1.5rem !important;\n    padding-bottom: 1.5rem !important;\n  }\n\n  .py-xxl-5 {\n    padding-top: 3rem !important;\n    padding-bottom: 3rem !important;\n  }\n\n  .pt-xxl-0 {\n    padding-top: 0 !important;\n  }\n\n  .pt-xxl-1 {\n    padding-top: 0.25rem !important;\n  }\n\n  .pt-xxl-2 {\n    padding-top: 0.5rem !important;\n  }\n\n  .pt-xxl-3 {\n    padding-top: 1rem !important;\n  }\n\n  .pt-xxl-4 {\n    padding-top: 1.5rem !important;\n  }\n\n  .pt-xxl-5 {\n    padding-top: 3rem !important;\n  }\n\n  .pe-xxl-0 {\n    padding-right: 0 !important;\n  }\n\n  .pe-xxl-1 {\n    padding-right: 0.25rem !important;\n  }\n\n  .pe-xxl-2 {\n    padding-right: 0.5rem !important;\n  }\n\n  .pe-xxl-3 {\n    padding-right: 1rem !important;\n  }\n\n  .pe-xxl-4 {\n    padding-right: 1.5rem !important;\n  }\n\n  .pe-xxl-5 {\n    padding-right: 3rem !important;\n  }\n\n  .pb-xxl-0 {\n    padding-bottom: 0 !important;\n  }\n\n  .pb-xxl-1 {\n    padding-bottom: 0.25rem !important;\n  }\n\n  .pb-xxl-2 {\n    padding-bottom: 0.5rem !important;\n  }\n\n  .pb-xxl-3 {\n    padding-bottom: 1rem !important;\n  }\n\n  .pb-xxl-4 {\n    padding-bottom: 1.5rem !important;\n  }\n\n  .pb-xxl-5 {\n    padding-bottom: 3rem !important;\n  }\n\n  .ps-xxl-0 {\n    padding-left: 0 !important;\n  }\n\n  .ps-xxl-1 {\n    padding-left: 0.25rem !important;\n  }\n\n  .ps-xxl-2 {\n    padding-left: 0.5rem !important;\n  }\n\n  .ps-xxl-3 {\n    padding-left: 1rem !important;\n  }\n\n  .ps-xxl-4 {\n    padding-left: 1.5rem !important;\n  }\n\n  .ps-xxl-5 {\n    padding-left: 3rem !important;\n  }\n\n  .text-xxl-start {\n    text-align: left !important;\n  }\n\n  .text-xxl-end {\n    text-align: right !important;\n  }\n\n  .text-xxl-center {\n    text-align: center !important;\n  }\n}\n@media (min-width: 1200px) {\n  .fs-1 {\n    font-size: 2.5rem !important;\n  }\n\n  .fs-2 {\n    font-size: 2rem !important;\n  }\n\n  .fs-3 {\n    font-size: 1.75rem !important;\n  }\n\n  .fs-4 {\n    font-size: 1.5rem !important;\n  }\n}\n@media print {\n  .d-print-inline {\n    display: inline !important;\n  }\n\n  .d-print-inline-block {\n    display: inline-block !important;\n  }\n\n  .d-print-block {\n    display: block !important;\n  }\n\n  .d-print-grid {\n    display: grid !important;\n  }\n\n  .d-print-table {\n    display: table !important;\n  }\n\n  .d-print-table-row {\n    display: table-row !important;\n  }\n\n  .d-print-table-cell {\n    display: table-cell !important;\n  }\n\n  .d-print-flex {\n    display: flex !important;\n  }\n\n  .d-print-inline-flex {\n    display: inline-flex !important;\n  }\n\n  .d-print-none {\n    display: none !important;\n  }\n}\n\n/*# sourceMappingURL=bootstrap.css.map */","// stylelint-disable property-blacklist, scss/dollar-variable-default\n\n// SCSS RFS mixin\n//\n// Automated responsive values for font sizes, paddings, margins and much more\n//\n// Licensed under MIT (https://github.com/twbs/rfs/blob/main/LICENSE)\n\n// Configuration\n\n// Base value\n$rfs-base-value: 1.25rem !default;\n$rfs-unit: rem !default;\n\n@if $rfs-unit != rem and $rfs-unit != px {\n  @error \"`#{$rfs-unit}` is not a valid unit for $rfs-unit. Use `px` or `rem`.\";\n}\n\n// Breakpoint at where values start decreasing if screen width is smaller\n$rfs-breakpoint: 1200px !default;\n$rfs-breakpoint-unit: px !default;\n\n@if $rfs-breakpoint-unit != px and $rfs-breakpoint-unit != em and $rfs-breakpoint-unit != rem {\n  @error \"`#{$rfs-breakpoint-unit}` is not a valid unit for $rfs-breakpoint-unit. Use `px`, `em` or `rem`.\";\n}\n\n// Resize values based on screen height and width\n$rfs-two-dimensional: false !default;\n\n// Factor of decrease\n$rfs-factor: 10 !default;\n\n@if type-of($rfs-factor) != number or $rfs-factor <= 1 {\n  @error \"`#{$rfs-factor}` is not a valid  $rfs-factor, it must be greater than 1.\";\n}\n\n// Mode. Possibilities: \"min-media-query\", \"max-media-query\"\n$rfs-mode: min-media-query !default;\n\n// Generate enable or disable classes. Possibilities: false, \"enable\" or \"disable\"\n$rfs-class: false !default;\n\n// 1 rem = $rfs-rem-value px\n$rfs-rem-value: 16 !default;\n\n// Safari iframe resize bug: https://github.com/twbs/rfs/issues/14\n$rfs-safari-iframe-resize-bug-fix: false !default;\n\n// Disable RFS by setting $enable-rfs to false\n$enable-rfs: true !default;\n\n// Cache $rfs-base-value unit\n$rfs-base-value-unit: unit($rfs-base-value);\n\n@function divide($dividend, $divisor, $precision: 10) {\n  $sign: if($dividend > 0 and $divisor > 0 or $dividend < 0 and $divisor < 0, 1, -1);\n  $dividend: abs($dividend);\n  $divisor: abs($divisor);\n  @if $dividend == 0 {\n    @return 0;\n  }\n  @if $divisor == 0 {\n    @error \"Cannot divide by 0\";\n  }\n  $remainder: $dividend;\n  $result: 0;\n  $factor: 10;\n  @while ($remainder > 0 and $precision >= 0) {\n    $quotient: 0;\n    @while ($remainder >= $divisor) {\n      $remainder: $remainder - $divisor;\n      $quotient: $quotient + 1;\n    }\n    $result: $result * 10 + $quotient;\n    $factor: $factor * .1;\n    $remainder: $remainder * 10;\n    $precision: $precision - 1;\n    @if ($precision < 0 and $remainder >= $divisor * 5) {\n      $result: $result + 1;\n    }\n  }\n  $result: $result * $factor * $sign;\n  $dividend-unit: unit($dividend);\n  $divisor-unit: unit($divisor);\n  $unit-map: (\n    \"px\": 1px,\n    \"rem\": 1rem,\n    \"em\": 1em,\n    \"%\": 1%\n  );\n  @if ($dividend-unit != $divisor-unit and map-has-key($unit-map, $dividend-unit)) {\n    $result: $result * map-get($unit-map, $dividend-unit);\n  }\n  @return $result;\n}\n\n// Remove px-unit from $rfs-base-value for calculations\n@if $rfs-base-value-unit == px {\n  $rfs-base-value: divide($rfs-base-value, $rfs-base-value * 0 + 1);\n}\n@else if $rfs-base-value-unit == rem {\n  $rfs-base-value: divide($rfs-base-value, divide($rfs-base-value * 0 + 1, $rfs-rem-value));\n}\n\n// Cache $rfs-breakpoint unit to prevent multiple calls\n$rfs-breakpoint-unit-cache: unit($rfs-breakpoint);\n\n// Remove unit from $rfs-breakpoint for calculations\n@if $rfs-breakpoint-unit-cache == px {\n  $rfs-breakpoint: divide($rfs-breakpoint, $rfs-breakpoint * 0 + 1);\n}\n@else if $rfs-breakpoint-unit-cache == rem or $rfs-breakpoint-unit-cache == \"em\" {\n  $rfs-breakpoint: divide($rfs-breakpoint, divide($rfs-breakpoint * 0 + 1, $rfs-rem-value));\n}\n\n// Calculate the media query value\n$rfs-mq-value: if($rfs-breakpoint-unit == px, #{$rfs-breakpoint}px, #{divide($rfs-breakpoint, $rfs-rem-value)}#{$rfs-breakpoint-unit});\n$rfs-mq-property-width: if($rfs-mode == max-media-query, max-width, min-width);\n$rfs-mq-property-height: if($rfs-mode == max-media-query, max-height, min-height);\n\n// Internal mixin used to determine which media query needs to be used\n@mixin _rfs-media-query {\n  @if $rfs-two-dimensional {\n    @if $rfs-mode == max-media-query {\n      @media (#{$rfs-mq-property-width}: #{$rfs-mq-value}), (#{$rfs-mq-property-height}: #{$rfs-mq-value}) {\n        @content;\n      }\n    }\n    @else {\n      @media (#{$rfs-mq-property-width}: #{$rfs-mq-value}) and (#{$rfs-mq-property-height}: #{$rfs-mq-value}) {\n        @content;\n      }\n    }\n  }\n  @else {\n    @media (#{$rfs-mq-property-width}: #{$rfs-mq-value}) {\n      @content;\n    }\n  }\n}\n\n// Internal mixin that adds disable classes to the selector if needed.\n@mixin _rfs-rule {\n  @if $rfs-class == disable and $rfs-mode == max-media-query {\n    // Adding an extra class increases specificity, which prevents the media query to override the property\n    &,\n    .disable-rfs &,\n    &.disable-rfs {\n      @content;\n    }\n  }\n  @else if $rfs-class == enable and $rfs-mode == min-media-query {\n    .enable-rfs &,\n    &.enable-rfs {\n      @content;\n    }\n  }\n  @else {\n    @content;\n  }\n}\n\n// Internal mixin that adds enable classes to the selector if needed.\n@mixin _rfs-media-query-rule {\n\n  @if $rfs-class == enable {\n    @if $rfs-mode == min-media-query {\n      @content;\n    }\n\n    @include _rfs-media-query {\n      .enable-rfs &,\n      &.enable-rfs {\n        @content;\n      }\n    }\n  }\n  @else {\n    @if $rfs-class == disable and $rfs-mode == min-media-query {\n      .disable-rfs &,\n      &.disable-rfs {\n        @content;\n      }\n    }\n    @include _rfs-media-query {\n      @content;\n    }\n  }\n}\n\n// Helper function to get the formatted non-responsive value\n@function rfs-value($values) {\n  // Convert to list\n  $values: if(type-of($values) != list, ($values,), $values);\n\n  $val: '';\n\n  // Loop over each value and calculate value\n  @each $value in $values {\n    @if $value == 0 {\n      $val: $val + ' 0';\n    }\n    @else {\n      // Cache $value unit\n      $unit: if(type-of($value) == \"number\", unit($value), false);\n\n      @if $unit == px {\n        // Convert to rem if needed\n        $val: $val + ' ' + if($rfs-unit == rem, #{divide($value, $value * 0 + $rfs-rem-value)}rem, $value);\n      }\n      @else if $unit == rem {\n        // Convert to px if needed\n        $val: $val + ' ' + if($rfs-unit == px, #{divide($value, $value * 0 + 1) * $rfs-rem-value}px, $value);\n      }\n      @else {\n        // If $value isn't a number (like inherit) or $value has a unit (not px or rem, like 1.5em) or $ is 0, just print the value\n        $val: $val + ' ' + $value;\n      }\n    }\n  }\n\n  // Remove first space\n  @return unquote(str-slice($val, 2));\n}\n\n// Helper function to get the responsive value calculated by RFS\n@function rfs-fluid-value($values) {\n  // Convert to list\n  $values: if(type-of($values) != list, ($values,), $values);\n\n  $val: '';\n\n  // Loop over each value and calculate value\n  @each $value in $values {\n    @if $value == 0 {\n      $val: $val + ' 0';\n    }\n\n    @else {\n      // Cache $value unit\n      $unit: if(type-of($value) == \"number\", unit($value), false);\n\n      // If $value isn't a number (like inherit) or $value has a unit (not px or rem, like 1.5em) or $ is 0, just print the value\n      @if not $unit or $unit != px and $unit != rem {\n        $val: $val + ' ' + $value;\n      }\n\n      @else {\n        // Remove unit from $value for calculations\n        $value: divide($value, $value * 0 + if($unit == px, 1, divide(1, $rfs-rem-value)));\n\n        // Only add the media query if the value is greater than the minimum value\n        @if abs($value) <= $rfs-base-value or not $enable-rfs {\n          $val: $val + ' ' +  if($rfs-unit == rem, #{divide($value, $rfs-rem-value)}rem, #{$value}px);\n        }\n        @else {\n          // Calculate the minimum value\n          $value-min: $rfs-base-value + divide(abs($value) - $rfs-base-value, $rfs-factor);\n\n          // Calculate difference between $value and the minimum value\n          $value-diff: abs($value) - $value-min;\n\n          // Base value formatting\n          $min-width: if($rfs-unit == rem, #{divide($value-min, $rfs-rem-value)}rem, #{$value-min}px);\n\n          // Use negative value if needed\n          $min-width: if($value < 0, -$min-width, $min-width);\n\n          // Use `vmin` if two-dimensional is enabled\n          $variable-unit: if($rfs-two-dimensional, vmin, vw);\n\n          // Calculate the variable width between 0 and $rfs-breakpoint\n          $variable-width: #{divide($value-diff * 100, $rfs-breakpoint)}#{$variable-unit};\n\n          // Return the calculated value\n          $val: $val + ' calc(' + $min-width + if($value < 0, ' - ', ' + ') + $variable-width + ')';\n        }\n      }\n    }\n  }\n\n  // Remove first space\n  @return unquote(str-slice($val, 2));\n}\n\n// RFS mixin\n@mixin rfs($values, $property: font-size) {\n  @if $values != null {\n    $val: rfs-value($values);\n    $fluidVal: rfs-fluid-value($values);\n\n    // Do not print the media query if responsive & non-responsive values are the same\n    @if $val == $fluidVal {\n      #{$property}: $val;\n    }\n    @else {\n      @include _rfs-rule {\n        #{$property}: if($rfs-mode == max-media-query, $val, $fluidVal);\n\n        // Include safari iframe resize fix if needed\n        min-width: if($rfs-safari-iframe-resize-bug-fix, (0 * 1vw), null);\n      }\n\n      @include _rfs-media-query-rule {\n        #{$property}: if($rfs-mode == max-media-query, $fluidVal, $val);\n      }\n    }\n  }\n}\n\n// Shorthand helper mixins\n@mixin font-size($value) {\n  @include rfs($value);\n}\n\n@mixin padding($value) {\n  @include rfs($value, padding);\n}\n\n@mixin padding-top($value) {\n  @include rfs($value, padding-top);\n}\n\n@mixin padding-right($value) {\n  @include rfs($value, padding-right);\n}\n\n@mixin padding-bottom($value) {\n  @include rfs($value, padding-bottom);\n}\n\n@mixin padding-left($value) {\n  @include rfs($value, padding-left);\n}\n\n@mixin margin($value) {\n  @include rfs($value, margin);\n}\n\n@mixin margin-top($value) {\n  @include rfs($value, margin-top);\n}\n\n@mixin margin-right($value) {\n  @include rfs($value, margin-right);\n}\n\n@mixin margin-bottom($value) {\n  @include rfs($value, margin-bottom);\n}\n\n@mixin margin-left($value) {\n  @include rfs($value, margin-left);\n}\n","// stylelint-disable property-disallowed-list\n// Single side border-radius\n\n// Helper function to replace negative values with 0\n@function valid-radius($radius) {\n  $return: ();\n  @each $value in $radius {\n    @if type-of($value) == number {\n      $return: append($return, max($value, 0));\n    } @else {\n      $return: append($return, $value);\n    }\n  }\n  @return $return;\n}\n\n// scss-docs-start border-radius-mixins\n@mixin border-radius($radius: $border-radius, $fallback-border-radius: false) {\n  @if $enable-rounded {\n    border-radius: valid-radius($radius);\n  }\n  @else if $fallback-border-radius != false {\n    border-radius: $fallback-border-radius;\n  }\n}\n\n@mixin border-top-radius($radius: $border-radius) {\n  @if $enable-rounded {\n    border-top-left-radius: valid-radius($radius);\n    border-top-right-radius: valid-radius($radius);\n  }\n}\n\n@mixin border-end-radius($radius: $border-radius) {\n  @if $enable-rounded {\n    border-top-right-radius: valid-radius($radius);\n    border-bottom-right-radius: valid-radius($radius);\n  }\n}\n\n@mixin border-bottom-radius($radius: $border-radius) {\n  @if $enable-rounded {\n    border-bottom-right-radius: valid-radius($radius);\n    border-bottom-left-radius: valid-radius($radius);\n  }\n}\n\n@mixin border-start-radius($radius: $border-radius) {\n  @if $enable-rounded {\n    border-top-left-radius: valid-radius($radius);\n    border-bottom-left-radius: valid-radius($radius);\n  }\n}\n\n@mixin border-top-start-radius($radius: $border-radius) {\n  @if $enable-rounded {\n    border-top-left-radius: valid-radius($radius);\n  }\n}\n\n@mixin border-top-end-radius($radius: $border-radius) {\n  @if $enable-rounded {\n    border-top-right-radius: valid-radius($radius);\n  }\n}\n\n@mixin border-bottom-end-radius($radius: $border-radius) {\n  @if $enable-rounded {\n    border-bottom-right-radius: valid-radius($radius);\n  }\n}\n\n@mixin border-bottom-start-radius($radius: $border-radius) {\n  @if $enable-rounded {\n    border-bottom-left-radius: valid-radius($radius);\n  }\n}\n// scss-docs-end border-radius-mixins\n","//\n// Headings\n//\n.h1 {\n  @extend h1;\n}\n\n.h2 {\n  @extend h2;\n}\n\n.h3 {\n  @extend h3;\n}\n\n.h4 {\n  @extend h4;\n}\n\n.h5 {\n  @extend h5;\n}\n\n.h6 {\n  @extend h6;\n}\n\n\n.lead {\n  @include font-size($lead-font-size);\n  font-weight: $lead-font-weight;\n}\n\n// Type display classes\n@each $display, $font-size in $display-font-sizes {\n  .display-#{$display} {\n    @include font-size($font-size);\n    font-weight: $display-font-weight;\n    line-height: $display-line-height;\n  }\n}\n\n//\n// Emphasis\n//\n.small {\n  @extend small;\n}\n\n.mark {\n  @extend mark;\n}\n\n//\n// Lists\n//\n\n.list-unstyled {\n  @include list-unstyled();\n}\n\n// Inline turns list items into inline-block\n.list-inline {\n  @include list-unstyled();\n}\n.list-inline-item {\n  display: inline-block;\n\n  &:not(:last-child) {\n    margin-right: $list-inline-padding;\n  }\n}\n\n\n//\n// Misc\n//\n\n// Builds on `abbr`\n.initialism {\n  @include font-size($initialism-font-size);\n  text-transform: uppercase;\n}\n\n// Blockquotes\n.blockquote {\n  margin-bottom: $blockquote-margin-y;\n  @include font-size($blockquote-font-size);\n\n  > :last-child {\n    margin-bottom: 0;\n  }\n}\n\n.blockquote-footer {\n  margin-top: -$blockquote-margin-y;\n  margin-bottom: $blockquote-margin-y;\n  @include font-size($blockquote-footer-font-size);\n  color: $blockquote-footer-color;\n\n  &::before {\n    content: \"\\2014\\00A0\"; // em dash, nbsp\n  }\n}\n","// Lists\n\n// Unstyled keeps list items block level, just removes default browser padding and list-style\n@mixin list-unstyled {\n  padding-left: 0;\n  list-style: none;\n}\n","// Responsive images (ensure images don't scale beyond their parents)\n//\n// This is purposefully opt-in via an explicit class rather than being the default for all `<img>`s.\n// We previously tried the \"images are responsive by default\" approach in Bootstrap v2,\n// and abandoned it in Bootstrap v3 because it breaks lots of third-party widgets (including Google Maps)\n// which weren't expecting the images within themselves to be involuntarily resized.\n// See also https://github.com/twbs/bootstrap/issues/18178\n.img-fluid {\n  @include img-fluid();\n}\n\n\n// Image thumbnails\n.img-thumbnail {\n  padding: $thumbnail-padding;\n  background-color: $thumbnail-bg;\n  border: $thumbnail-border-width solid $thumbnail-border-color;\n  @include border-radius($thumbnail-border-radius);\n  @include box-shadow($thumbnail-box-shadow);\n\n  // Keep them at most 100% wide\n  @include img-fluid();\n}\n\n//\n// Figures\n//\n\n.figure {\n  // Ensures the caption's text aligns with the image.\n  display: inline-block;\n}\n\n.figure-img {\n  margin-bottom: $spacer * .5;\n  line-height: 1;\n}\n\n.figure-caption {\n  @include font-size($figure-caption-font-size);\n  color: $figure-caption-color;\n}\n","// Image Mixins\n// - Responsive image\n// - Retina image\n\n\n// Responsive image\n//\n// Keep images from scaling beyond the width of their parents.\n\n@mixin img-fluid {\n  // Part 1: Set a maximum relative to the parent\n  max-width: 100%;\n  // Part 2: Override the height to auto, otherwise images will be stretched\n  // when setting a width and height attribute on the img element.\n  height: auto;\n}\n","// Container widths\n//\n// Set the container width, and override it for fixed navbars in media queries.\n\n@if $enable-grid-classes {\n  // Single container class with breakpoint max-widths\n  .container,\n  // 100% wide container at all breakpoints\n  .container-fluid {\n    @include make-container();\n  }\n\n  // Responsive containers that are 100% wide until a breakpoint\n  @each $breakpoint, $container-max-width in $container-max-widths {\n    .container-#{$breakpoint} {\n      @extend .container-fluid;\n    }\n\n    @include media-breakpoint-up($breakpoint, $grid-breakpoints) {\n      %responsive-container-#{$breakpoint} {\n        max-width: $container-max-width;\n      }\n\n      // Extend each breakpoint which is smaller or equal to the current breakpoint\n      $extend-breakpoint: true;\n\n      @each $name, $width in $grid-breakpoints {\n        @if ($extend-breakpoint) {\n          .container#{breakpoint-infix($name, $grid-breakpoints)} {\n            @extend %responsive-container-#{$breakpoint};\n          }\n\n          // Once the current breakpoint is reached, stop extending\n          @if ($breakpoint == $name) {\n            $extend-breakpoint: false;\n          }\n        }\n      }\n    }\n  }\n}\n","// Container mixins\n\n@mixin make-container($gutter: $container-padding-x) {\n  width: 100%;\n  padding-right: var(--#{$variable-prefix}gutter-x, #{$gutter});\n  padding-left: var(--#{$variable-prefix}gutter-x, #{$gutter});\n  margin-right: auto;\n  margin-left: auto;\n}\n","// Breakpoint viewport sizes and media queries.\n//\n// Breakpoints are defined as a map of (name: minimum width), order from small to large:\n//\n//    (xs: 0, sm: 576px, md: 768px, lg: 992px, xl: 1200px)\n//\n// The map defined in the `$grid-breakpoints` global variable is used as the `$breakpoints` argument by default.\n\n// Name of the next breakpoint, or null for the last breakpoint.\n//\n//    >> breakpoint-next(sm)\n//    md\n//    >> breakpoint-next(sm, (xs: 0, sm: 576px, md: 768px, lg: 992px, xl: 1200px))\n//    md\n//    >> breakpoint-next(sm, $breakpoint-names: (xs sm md lg xl))\n//    md\n@function breakpoint-next($name, $breakpoints: $grid-breakpoints, $breakpoint-names: map-keys($breakpoints)) {\n  $n: index($breakpoint-names, $name);\n  @if not $n {\n    @error \"breakpoint `#{$name}` not found in `#{$breakpoints}`\";\n  }\n  @return if($n < length($breakpoint-names), nth($breakpoint-names, $n + 1), null);\n}\n\n// Minimum breakpoint width. Null for the smallest (first) breakpoint.\n//\n//    >> breakpoint-min(sm, (xs: 0, sm: 576px, md: 768px, lg: 992px, xl: 1200px))\n//    576px\n@function breakpoint-min($name, $breakpoints: $grid-breakpoints) {\n  $min: map-get($breakpoints, $name);\n  @return if($min != 0, $min, null);\n}\n\n// Maximum breakpoint width.\n// The maximum value is reduced by 0.02px to work around the limitations of\n// `min-` and `max-` prefixes and viewports with fractional widths.\n// See https://www.w3.org/TR/mediaqueries-4/#mq-min-max\n// Uses 0.02px rather than 0.01px to work around a current rounding bug in Safari.\n// See https://bugs.webkit.org/show_bug.cgi?id=178261\n//\n//    >> breakpoint-max(md, (xs: 0, sm: 576px, md: 768px, lg: 992px, xl: 1200px))\n//    767.98px\n@function breakpoint-max($name, $breakpoints: $grid-breakpoints) {\n  $max: map-get($breakpoints, $name);\n  @return if($max and $max > 0, $max - .02, null);\n}\n\n// Returns a blank string if smallest breakpoint, otherwise returns the name with a dash in front.\n// Useful for making responsive utilities.\n//\n//    >> breakpoint-infix(xs, (xs: 0, sm: 576px, md: 768px, lg: 992px, xl: 1200px))\n//    \"\"  (Returns a blank string)\n//    >> breakpoint-infix(sm, (xs: 0, sm: 576px, md: 768px, lg: 992px, xl: 1200px))\n//    \"-sm\"\n@function breakpoint-infix($name, $breakpoints: $grid-breakpoints) {\n  @return if(breakpoint-min($name, $breakpoints) == null, \"\", \"-#{$name}\");\n}\n\n// Media of at least the minimum breakpoint width. No query for the smallest breakpoint.\n// Makes the @content apply to the given breakpoint and wider.\n@mixin media-breakpoint-up($name, $breakpoints: $grid-breakpoints) {\n  $min: breakpoint-min($name, $breakpoints);\n  @if $min {\n    @media (min-width: $min) {\n      @content;\n    }\n  } @else {\n    @content;\n  }\n}\n\n// Media of at most the maximum breakpoint width. No query for the largest breakpoint.\n// Makes the @content apply to the given breakpoint and narrower.\n@mixin media-breakpoint-down($name, $breakpoints: $grid-breakpoints) {\n  $max: breakpoint-max($name, $breakpoints);\n  @if $max {\n    @media (max-width: $max) {\n      @content;\n    }\n  } @else {\n    @content;\n  }\n}\n\n// Media that spans multiple breakpoint widths.\n// Makes the @content apply between the min and max breakpoints\n@mixin media-breakpoint-between($lower, $upper, $breakpoints: $grid-breakpoints) {\n  $min: breakpoint-min($lower, $breakpoints);\n  $max: breakpoint-max($upper, $breakpoints);\n\n  @if $min != null and $max != null {\n    @media (min-width: $min) and (max-width: $max) {\n      @content;\n    }\n  } @else if $max == null {\n    @include media-breakpoint-up($lower, $breakpoints) {\n      @content;\n    }\n  } @else if $min == null {\n    @include media-breakpoint-down($upper, $breakpoints) {\n      @content;\n    }\n  }\n}\n\n// Media between the breakpoint's minimum and maximum widths.\n// No minimum for the smallest breakpoint, and no maximum for the largest one.\n// Makes the @content apply only to the given breakpoint, not viewports any wider or narrower.\n@mixin media-breakpoint-only($name, $breakpoints: $grid-breakpoints) {\n  $min:  breakpoint-min($name, $breakpoints);\n  $next: breakpoint-next($name, $breakpoints);\n  $max:  breakpoint-max($next);\n\n  @if $min != null and $max != null {\n    @media (min-width: $min) and (max-width: $max) {\n      @content;\n    }\n  } @else if $max == null {\n    @include media-breakpoint-up($name, $breakpoints) {\n      @content;\n    }\n  } @else if $min == null {\n    @include media-breakpoint-down($next, $breakpoints) {\n      @content;\n    }\n  }\n}\n","// Row\n//\n// Rows contain your columns.\n\n@if $enable-grid-classes {\n  .row {\n    @include make-row();\n\n    > * {\n      @include make-col-ready();\n    }\n  }\n}\n\n@if $enable-cssgrid {\n  .grid {\n    display: grid;\n    grid-template-rows: repeat(var(--#{$variable-prefix}rows, 1), 1fr);\n    grid-template-columns: repeat(var(--#{$variable-prefix}columns, #{$grid-columns}), 1fr);\n    gap: var(--#{$variable-prefix}gap, #{$grid-gutter-width});\n\n    @include make-cssgrid();\n  }\n}\n\n\n// Columns\n//\n// Common styles for small and large grid columns\n\n@if $enable-grid-classes {\n  @include make-grid-columns();\n}\n","// Grid system\n//\n// Generate semantic grid columns with these mixins.\n\n@mixin make-row($gutter: $grid-gutter-width) {\n  --#{$variable-prefix}gutter-x: #{$gutter};\n  --#{$variable-prefix}gutter-y: 0;\n  display: flex;\n  flex-wrap: wrap;\n  margin-top: calc(var(--#{$variable-prefix}gutter-y) * -1); // stylelint-disable-line function-disallowed-list\n  margin-right: calc(var(--#{$variable-prefix}gutter-x) * -.5); // stylelint-disable-line function-disallowed-list\n  margin-left: calc(var(--#{$variable-prefix}gutter-x) * -.5); // stylelint-disable-line function-disallowed-list\n}\n\n@mixin make-col-ready($gutter: $grid-gutter-width) {\n  // Add box sizing if only the grid is loaded\n  box-sizing: if(variable-exists(include-column-box-sizing) and $include-column-box-sizing, border-box, null);\n  // Prevent columns from becoming too narrow when at smaller grid tiers by\n  // always setting `width: 100%;`. This works because we set the width\n  // later on to override this initial width.\n  flex-shrink: 0;\n  width: 100%;\n  max-width: 100%; // Prevent `.col-auto`, `.col` (& responsive variants) from breaking out the grid\n  padding-right: calc(var(--#{$variable-prefix}gutter-x) * .5); // stylelint-disable-line function-disallowed-list\n  padding-left: calc(var(--#{$variable-prefix}gutter-x) * .5); // stylelint-disable-line function-disallowed-list\n  margin-top: var(--#{$variable-prefix}gutter-y);\n}\n\n@mixin make-col($size: false, $columns: $grid-columns) {\n  @if $size {\n    flex: 0 0 auto;\n    width: percentage(divide($size, $columns));\n\n  } @else {\n    flex: 1 1 0;\n    max-width: 100%;\n  }\n}\n\n@mixin make-col-auto() {\n  flex: 0 0 auto;\n  width: auto;\n}\n\n@mixin make-col-offset($size, $columns: $grid-columns) {\n  $num: divide($size, $columns);\n  margin-left: if($num == 0, 0, percentage($num));\n}\n\n// Row columns\n//\n// Specify on a parent element(e.g., .row) to force immediate children into NN\n// numberof columns. Supports wrapping to new lines, but does not do a Masonry\n// style grid.\n@mixin row-cols($count) {\n  > * {\n    flex: 0 0 auto;\n    width: divide(100%, $count);\n  }\n}\n\n// Framework grid generation\n//\n// Used only by Bootstrap to generate the correct number of grid classes given\n// any value of `$grid-columns`.\n\n@mixin make-grid-columns($columns: $grid-columns, $gutter: $grid-gutter-width, $breakpoints: $grid-breakpoints) {\n  @each $breakpoint in map-keys($breakpoints) {\n    $infix: breakpoint-infix($breakpoint, $breakpoints);\n\n    @include media-breakpoint-up($breakpoint, $breakpoints) {\n      // Provide basic `.col-{bp}` classes for equal-width flexbox columns\n      .col#{$infix} {\n        flex: 1 0 0%; // Flexbugs #4: https://github.com/philipwalton/flexbugs#flexbug-4\n      }\n\n      .row-cols#{$infix}-auto > * {\n        @include make-col-auto();\n      }\n\n      @if $grid-row-columns > 0 {\n        @for $i from 1 through $grid-row-columns {\n          .row-cols#{$infix}-#{$i} {\n            @include row-cols($i);\n          }\n        }\n      }\n\n      .col#{$infix}-auto {\n        @include make-col-auto();\n      }\n\n      @if $columns > 0 {\n        @for $i from 1 through $columns {\n          .col#{$infix}-#{$i} {\n            @include make-col($i, $columns);\n          }\n        }\n\n        // `$columns - 1` because offsetting by the width of an entire row isn't possible\n        @for $i from 0 through ($columns - 1) {\n          @if not ($infix == \"\" and $i == 0) { // Avoid emitting useless .offset-0\n            .offset#{$infix}-#{$i} {\n              @include make-col-offset($i, $columns);\n            }\n          }\n        }\n      }\n\n      // Gutters\n      //\n      // Make use of `.g-*`, `.gx-*` or `.gy-*` utilities to change spacing between the columns.\n      @each $key, $value in $gutters {\n        .g#{$infix}-#{$key},\n        .gx#{$infix}-#{$key} {\n          --#{$variable-prefix}gutter-x: #{$value};\n        }\n\n        .g#{$infix}-#{$key},\n        .gy#{$infix}-#{$key} {\n          --#{$variable-prefix}gutter-y: #{$value};\n        }\n      }\n    }\n  }\n}\n\n@mixin make-cssgrid($columns: $grid-columns, $breakpoints: $grid-breakpoints) {\n  @each $breakpoint in map-keys($breakpoints) {\n    $infix: breakpoint-infix($breakpoint, $breakpoints);\n\n    @include media-breakpoint-up($breakpoint, $breakpoints) {\n      @if $columns > 0 {\n        @for $i from 1 through $columns {\n          .g-col#{$infix}-#{$i} {\n            grid-column: auto / span $i;\n          }\n        }\n\n        // Start with `1` because `0` is and invalid value.\n        // Ends with `$columns - 1` because offsetting by the width of an entire row isn't possible.\n        @for $i from 1 through ($columns - 1) {\n          .g-start#{$infix}-#{$i} {\n            grid-column-start: $i;\n          }\n        }\n      }\n    }\n  }\n}\n","//\n// Basic Bootstrap table\n//\n\n.table {\n  --#{$variable-prefix}table-bg: #{$table-bg};\n  --#{$variable-prefix}table-accent-bg: #{$table-accent-bg};\n  --#{$variable-prefix}table-striped-color: #{$table-striped-color};\n  --#{$variable-prefix}table-striped-bg: #{$table-striped-bg};\n  --#{$variable-prefix}table-active-color: #{$table-active-color};\n  --#{$variable-prefix}table-active-bg: #{$table-active-bg};\n  --#{$variable-prefix}table-hover-color: #{$table-hover-color};\n  --#{$variable-prefix}table-hover-bg: #{$table-hover-bg};\n\n  width: 100%;\n  margin-bottom: $spacer;\n  color: $table-color;\n  vertical-align: $table-cell-vertical-align;\n  border-color: $table-border-color;\n\n  // Target th & td\n  // We need the child combinator to prevent styles leaking to nested tables which doesn't have a `.table` class.\n  // We use the universal selectors here to simplify the selector (else we would need 6 different selectors).\n  // Another advantage is that this generates less code and makes the selector less specific making it easier to override.\n  // stylelint-disable-next-line selector-max-universal\n  > :not(caption) > * > * {\n    padding: $table-cell-padding-y $table-cell-padding-x;\n    background-color: var(--#{$variable-prefix}table-bg);\n    border-bottom-width: $table-border-width;\n    box-shadow: inset 0 0 0 9999px var(--#{$variable-prefix}table-accent-bg);\n  }\n\n  > tbody {\n    vertical-align: inherit;\n  }\n\n  > thead {\n    vertical-align: bottom;\n  }\n\n  // Highlight border color between thead, tbody and tfoot.\n  > :not(:last-child) > :last-child > * {\n    border-bottom-color: $table-group-separator-color;\n  }\n}\n\n\n//\n// Change placement of captions with a class\n//\n\n.caption-top {\n  caption-side: top;\n}\n\n\n//\n// Condensed table w/ half padding\n//\n\n.table-sm {\n  // stylelint-disable-next-line selector-max-universal\n  > :not(caption) > * > * {\n    padding: $table-cell-padding-y-sm $table-cell-padding-x-sm;\n  }\n}\n\n\n// Border versions\n//\n// Add or remove borders all around the table and between all the columns.\n//\n// When borders are added on all sides of the cells, the corners can render odd when\n// these borders do not have the same color or if they are semi-transparent.\n// Therefor we add top and border bottoms to the `tr`s and left and right borders\n// to the `td`s or `th`s\n\n.table-bordered {\n  > :not(caption) > * {\n    border-width: $table-border-width 0;\n\n    // stylelint-disable-next-line selector-max-universal\n    > * {\n      border-width: 0 $table-border-width;\n    }\n  }\n}\n\n.table-borderless {\n  // stylelint-disable-next-line selector-max-universal\n  > :not(caption) > * > * {\n    border-bottom-width: 0;\n  }\n}\n\n// Zebra-striping\n//\n// Default zebra-stripe styles (alternating gray and transparent backgrounds)\n\n.table-striped {\n  > tbody > tr:nth-of-type(#{$table-striped-order}) {\n    --#{$variable-prefix}table-accent-bg: var(--#{$variable-prefix}table-striped-bg);\n    color: var(--#{$variable-prefix}table-striped-color);\n  }\n}\n\n// Active table\n//\n// The `.table-active` class can be added to highlight rows or cells\n\n.table-active {\n  --#{$variable-prefix}table-accent-bg: var(--#{$variable-prefix}table-active-bg);\n  color: var(--#{$variable-prefix}table-active-color);\n}\n\n// Hover effect\n//\n// Placed here since it has to come after the potential zebra striping\n\n.table-hover {\n  > tbody > tr:hover {\n    --#{$variable-prefix}table-accent-bg: var(--#{$variable-prefix}table-hover-bg);\n    color: var(--#{$variable-prefix}table-hover-color);\n  }\n}\n\n\n// Table variants\n//\n// Table variants set the table cell backgrounds, border colors\n// and the colors of the striped, hovered & active tables\n\n@each $color, $value in $table-variants {\n  @include table-variant($color, $value);\n}\n\n// Responsive tables\n//\n// Generate series of `.table-responsive-*` classes for configuring the screen\n// size of where your table will overflow.\n\n@each $breakpoint in map-keys($grid-breakpoints) {\n  $infix: breakpoint-infix($breakpoint, $grid-breakpoints);\n\n  @include media-breakpoint-down($breakpoint) {\n    .table-responsive#{$infix} {\n      overflow-x: auto;\n      -webkit-overflow-scrolling: touch;\n    }\n  }\n}\n","// scss-docs-start table-variant\n@mixin table-variant($state, $background) {\n  .table-#{$state} {\n    $color: color-contrast(opaque($body-bg, $background));\n    $hover-bg: mix($color, $background, percentage($table-hover-bg-factor));\n    $striped-bg: mix($color, $background, percentage($table-striped-bg-factor));\n    $active-bg: mix($color, $background, percentage($table-active-bg-factor));\n\n    --#{$variable-prefix}table-bg: #{$background};\n    --#{$variable-prefix}table-striped-bg: #{$striped-bg};\n    --#{$variable-prefix}table-striped-color: #{color-contrast($striped-bg)};\n    --#{$variable-prefix}table-active-bg: #{$active-bg};\n    --#{$variable-prefix}table-active-color: #{color-contrast($active-bg)};\n    --#{$variable-prefix}table-hover-bg: #{$hover-bg};\n    --#{$variable-prefix}table-hover-color: #{color-contrast($hover-bg)};\n\n    color: $color;\n    border-color: mix($color, $background, percentage($table-border-factor));\n  }\n}\n// scss-docs-end table-variant\n","//\n// Labels\n//\n\n.form-label {\n  margin-bottom: $form-label-margin-bottom;\n  @include font-size($form-label-font-size);\n  font-style: $form-label-font-style;\n  font-weight: $form-label-font-weight;\n  color: $form-label-color;\n}\n\n// For use with horizontal and inline forms, when you need the label (or legend)\n// text to align with the form controls.\n.col-form-label {\n  padding-top: add($input-padding-y, $input-border-width);\n  padding-bottom: add($input-padding-y, $input-border-width);\n  margin-bottom: 0; // Override the `<legend>` default\n  @include font-size(inherit); // Override the `<legend>` default\n  font-style: $form-label-font-style;\n  font-weight: $form-label-font-weight;\n  line-height: $input-line-height;\n  color: $form-label-color;\n}\n\n.col-form-label-lg {\n  padding-top: add($input-padding-y-lg, $input-border-width);\n  padding-bottom: add($input-padding-y-lg, $input-border-width);\n  @include font-size($input-font-size-lg);\n}\n\n.col-form-label-sm {\n  padding-top: add($input-padding-y-sm, $input-border-width);\n  padding-bottom: add($input-padding-y-sm, $input-border-width);\n  @include font-size($input-font-size-sm);\n}\n","//\n// Form text\n//\n\n.form-text {\n  margin-top: $form-text-margin-top;\n  @include font-size($form-text-font-size);\n  font-style: $form-text-font-style;\n  font-weight: $form-text-font-weight;\n  color: $form-text-color;\n}\n","//\n// General form controls (plus a few specific high-level interventions)\n//\n\n.form-control {\n  display: block;\n  width: 100%;\n  padding: $input-padding-y $input-padding-x;\n  font-family: $input-font-family;\n  @include font-size($input-font-size);\n  font-weight: $input-font-weight;\n  line-height: $input-line-height;\n  color: $input-color;\n  background-color: $input-bg;\n  background-clip: padding-box;\n  border: $input-border-width solid $input-border-color;\n  appearance: none; // Fix appearance for date inputs in Safari\n\n  // Note: This has no effect on <select>s in some browsers, due to the limited stylability of `<select>`s in CSS.\n  @include border-radius($input-border-radius, 0);\n\n  @include box-shadow($input-box-shadow);\n  @include transition($input-transition);\n\n  &[type=\"file\"] {\n    overflow: hidden; // prevent pseudo element button overlap\n\n    &:not(:disabled):not([readonly]) {\n      cursor: pointer;\n    }\n  }\n\n  // Customize the `:focus` state to imitate native WebKit styles.\n  &:focus {\n    color: $input-focus-color;\n    background-color: $input-focus-bg;\n    border-color: $input-focus-border-color;\n    outline: 0;\n    @if $enable-shadows {\n      @include box-shadow($input-box-shadow, $input-focus-box-shadow);\n    } @else {\n      // Avoid using mixin so we can pass custom focus shadow properly\n      box-shadow: $input-focus-box-shadow;\n    }\n  }\n\n  // Add some height to date inputs on iOS\n  // https://github.com/twbs/bootstrap/issues/23307\n  // TODO: we can remove this workaround once https://bugs.webkit.org/show_bug.cgi?id=198959 is resolved\n  &::-webkit-date-and-time-value {\n    // Multiply line-height by 1em if it has no unit\n    height: if(unit($input-line-height) == \"\", $input-line-height * 1em, $input-line-height);\n  }\n\n  // Placeholder\n  &::placeholder {\n    color: $input-placeholder-color;\n    // Override Firefox's unusual default opacity; see https://github.com/twbs/bootstrap/pull/11526.\n    opacity: 1;\n  }\n\n  // Disabled and read-only inputs\n  //\n  // HTML5 says that controls under a fieldset > legend:first-child won't be\n  // disabled if the fieldset is disabled. Due to implementation difficulty, we\n  // don't honor that edge case; we style them as disabled anyway.\n  &:disabled,\n  &[readonly] {\n    background-color: $input-disabled-bg;\n    border-color: $input-disabled-border-color;\n    // iOS fix for unreadable disabled content; see https://github.com/twbs/bootstrap/issues/11655.\n    opacity: 1;\n  }\n\n  // File input buttons theming\n  &::file-selector-button {\n    padding: $input-padding-y $input-padding-x;\n    margin: (-$input-padding-y) (-$input-padding-x);\n    margin-inline-end: $input-padding-x;\n    color: $form-file-button-color;\n    @include gradient-bg($form-file-button-bg);\n    pointer-events: none;\n    border-color: inherit;\n    border-style: solid;\n    border-width: 0;\n    border-inline-end-width: $input-border-width;\n    border-radius: 0; // stylelint-disable-line property-disallowed-list\n    @include transition($btn-transition);\n  }\n\n  &:hover:not(:disabled):not([readonly])::file-selector-button {\n    background-color: $form-file-button-hover-bg;\n  }\n\n  &::-webkit-file-upload-button {\n    padding: $input-padding-y $input-padding-x;\n    margin: (-$input-padding-y) (-$input-padding-x);\n    margin-inline-end: $input-padding-x;\n    color: $form-file-button-color;\n    @include gradient-bg($form-file-button-bg);\n    pointer-events: none;\n    border-color: inherit;\n    border-style: solid;\n    border-width: 0;\n    border-inline-end-width: $input-border-width;\n    border-radius: 0; // stylelint-disable-line property-disallowed-list\n    @include transition($btn-transition);\n  }\n\n  &:hover:not(:disabled):not([readonly])::-webkit-file-upload-button {\n    background-color: $form-file-button-hover-bg;\n  }\n}\n\n// Readonly controls as plain text\n//\n// Apply class to a readonly input to make it appear like regular plain\n// text (without any border, background color, focus indicator)\n\n.form-control-plaintext {\n  display: block;\n  width: 100%;\n  padding: $input-padding-y 0;\n  margin-bottom: 0; // match inputs if this class comes on inputs with default margins\n  line-height: $input-line-height;\n  color: $input-plaintext-color;\n  background-color: transparent;\n  border: solid transparent;\n  border-width: $input-border-width 0;\n\n  &.form-control-sm,\n  &.form-control-lg {\n    padding-right: 0;\n    padding-left: 0;\n  }\n}\n\n// Form control sizing\n//\n// Build on `.form-control` with modifier classes to decrease or increase the\n// height and font-size of form controls.\n//\n// Repeated in `_input_group.scss` to avoid Sass extend issues.\n\n.form-control-sm {\n  min-height: $input-height-sm;\n  padding: $input-padding-y-sm $input-padding-x-sm;\n  @include font-size($input-font-size-sm);\n  @include border-radius($input-border-radius-sm);\n\n  &::file-selector-button {\n    padding: $input-padding-y-sm $input-padding-x-sm;\n    margin: (-$input-padding-y-sm) (-$input-padding-x-sm);\n    margin-inline-end: $input-padding-x-sm;\n  }\n\n  &::-webkit-file-upload-button {\n    padding: $input-padding-y-sm $input-padding-x-sm;\n    margin: (-$input-padding-y-sm) (-$input-padding-x-sm);\n    margin-inline-end: $input-padding-x-sm;\n  }\n}\n\n.form-control-lg {\n  min-height: $input-height-lg;\n  padding: $input-padding-y-lg $input-padding-x-lg;\n  @include font-size($input-font-size-lg);\n  @include border-radius($input-border-radius-lg);\n\n  &::file-selector-button {\n    padding: $input-padding-y-lg $input-padding-x-lg;\n    margin: (-$input-padding-y-lg) (-$input-padding-x-lg);\n    margin-inline-end: $input-padding-x-lg;\n  }\n\n  &::-webkit-file-upload-button {\n    padding: $input-padding-y-lg $input-padding-x-lg;\n    margin: (-$input-padding-y-lg) (-$input-padding-x-lg);\n    margin-inline-end: $input-padding-x-lg;\n  }\n}\n\n// Make sure textareas don't shrink too much when resized\n// https://github.com/twbs/bootstrap/pull/29124\n// stylelint-disable selector-no-qualifying-type\ntextarea {\n  &.form-control {\n    min-height: $input-height;\n  }\n\n  &.form-control-sm {\n    min-height: $input-height-sm;\n  }\n\n  &.form-control-lg {\n    min-height: $input-height-lg;\n  }\n}\n// stylelint-enable selector-no-qualifying-type\n\n.form-control-color {\n  width: $form-color-width;\n  height: auto; // Override fixed browser height\n  padding: $input-padding-y;\n\n  &:not(:disabled):not([readonly]) {\n    cursor: pointer;\n  }\n\n  &::-moz-color-swatch {\n    height: if(unit($input-line-height) == \"\", $input-line-height * 1em, $input-line-height);\n    @include border-radius($input-border-radius);\n  }\n\n  &::-webkit-color-swatch {\n    height: if(unit($input-line-height) == \"\", $input-line-height * 1em, $input-line-height);\n    @include border-radius($input-border-radius);\n  }\n}\n","// stylelint-disable property-disallowed-list\n@mixin transition($transition...) {\n  @if length($transition) == 0 {\n    $transition: $transition-base;\n  }\n\n  @if length($transition) > 1 {\n    @each $value in $transition {\n      @if $value == null or $value == none {\n        @warn \"The keyword 'none' or 'null' must be used as a single argument.\";\n      }\n    }\n  }\n\n  @if $enable-transitions {\n    @if nth($transition, 1) != null {\n      transition: $transition;\n    }\n\n    @if $enable-reduced-motion and nth($transition, 1) != null and nth($transition, 1) != none {\n      @media (prefers-reduced-motion: reduce) {\n        transition: none;\n      }\n    }\n  }\n}\n","// Gradients\n\n// scss-docs-start gradient-bg-mixin\n@mixin gradient-bg($color: null) {\n  background-color: $color;\n\n  @if $enable-gradients {\n    background-image: var(--#{$variable-prefix}gradient);\n  }\n}\n// scss-docs-end gradient-bg-mixin\n\n// scss-docs-start gradient-mixins\n// Horizontal gradient, from left to right\n//\n// Creates two color stops, start and end, by specifying a color and position for each color stop.\n@mixin gradient-x($start-color: $gray-700, $end-color: $gray-800, $start-percent: 0%, $end-percent: 100%) {\n  background-image: linear-gradient(to right, $start-color $start-percent, $end-color $end-percent);\n}\n\n// Vertical gradient, from top to bottom\n//\n// Creates two color stops, start and end, by specifying a color and position for each color stop.\n@mixin gradient-y($start-color: $gray-700, $end-color: $gray-800, $start-percent: null, $end-percent: null) {\n  background-image: linear-gradient(to bottom, $start-color $start-percent, $end-color $end-percent);\n}\n\n@mixin gradient-directional($start-color: $gray-700, $end-color: $gray-800, $deg: 45deg) {\n  background-image: linear-gradient($deg, $start-color, $end-color);\n}\n\n@mixin gradient-x-three-colors($start-color: $blue, $mid-color: $purple, $color-stop: 50%, $end-color: $red) {\n  background-image: linear-gradient(to right, $start-color, $mid-color $color-stop, $end-color);\n}\n\n@mixin gradient-y-three-colors($start-color: $blue, $mid-color: $purple, $color-stop: 50%, $end-color: $red) {\n  background-image: linear-gradient($start-color, $mid-color $color-stop, $end-color);\n}\n\n@mixin gradient-radial($inner-color: $gray-700, $outer-color: $gray-800) {\n  background-image: radial-gradient(circle, $inner-color, $outer-color);\n}\n\n@mixin gradient-striped($color: rgba($white, .15), $angle: 45deg) {\n  background-image: linear-gradient($angle, $color 25%, transparent 25%, transparent 50%, $color 50%, $color 75%, transparent 75%, transparent);\n}\n// scss-docs-end gradient-mixins\n","// Select\n//\n// Replaces the browser default select with a custom one, mostly pulled from\n// https://primer.github.io/.\n\n.form-select {\n  display: block;\n  width: 100%;\n  padding: $form-select-padding-y $form-select-indicator-padding $form-select-padding-y $form-select-padding-x;\n  // stylelint-disable-next-line property-no-vendor-prefix\n  -moz-padding-start: subtract($form-select-padding-x, 3px); // See https://github.com/twbs/bootstrap/issues/32636\n  font-family: $form-select-font-family;\n  @include font-size($form-select-font-size);\n  font-weight: $form-select-font-weight;\n  line-height: $form-select-line-height;\n  color: $form-select-color;\n  background-color: $form-select-bg;\n  background-image: escape-svg($form-select-indicator);\n  background-repeat: no-repeat;\n  background-position: $form-select-bg-position;\n  background-size: $form-select-bg-size;\n  border: $form-select-border-width solid $form-select-border-color;\n  @include border-radius($form-select-border-radius, 0);\n  @include box-shadow($form-select-box-shadow);\n  @include transition($form-select-transition);\n  appearance: none;\n\n  &:focus {\n    border-color: $form-select-focus-border-color;\n    outline: 0;\n    @if $enable-shadows {\n      @include box-shadow($form-select-box-shadow, $form-select-focus-box-shadow);\n    } @else {\n      // Avoid using mixin so we can pass custom focus shadow properly\n      box-shadow: $form-select-focus-box-shadow;\n    }\n  }\n\n  &[multiple],\n  &[size]:not([size=\"1\"]) {\n    padding-right: $form-select-padding-x;\n    background-image: none;\n  }\n\n  &:disabled {\n    color: $form-select-disabled-color;\n    background-color: $form-select-disabled-bg;\n    border-color: $form-select-disabled-border-color;\n  }\n\n  // Remove outline from select box in FF\n  &:-moz-focusring {\n    color: transparent;\n    text-shadow: 0 0 0 $form-select-color;\n  }\n}\n\n.form-select-sm {\n  padding-top: $form-select-padding-y-sm;\n  padding-bottom: $form-select-padding-y-sm;\n  padding-left: $form-select-padding-x-sm;\n  @include font-size($form-select-font-size-sm);\n}\n\n.form-select-lg {\n  padding-top: $form-select-padding-y-lg;\n  padding-bottom: $form-select-padding-y-lg;\n  padding-left: $form-select-padding-x-lg;\n  @include font-size($form-select-font-size-lg);\n}\n","//\n// Check/radio\n//\n\n.form-check {\n  display: block;\n  min-height: $form-check-min-height;\n  padding-left: $form-check-padding-start;\n  margin-bottom: $form-check-margin-bottom;\n\n  .form-check-input {\n    float: left;\n    margin-left: $form-check-padding-start * -1;\n  }\n}\n\n.form-check-input {\n  width: $form-check-input-width;\n  height: $form-check-input-width;\n  margin-top: ($line-height-base - $form-check-input-width) * .5; // line-height minus check height\n  vertical-align: top;\n  background-color: $form-check-input-bg;\n  background-repeat: no-repeat;\n  background-position: center;\n  background-size: contain;\n  border: $form-check-input-border;\n  appearance: none;\n  color-adjust: exact; // Keep themed appearance for print\n  @include transition($form-check-transition);\n\n  &[type=\"checkbox\"] {\n    @include border-radius($form-check-input-border-radius);\n  }\n\n  &[type=\"radio\"] {\n    // stylelint-disable-next-line property-disallowed-list\n    border-radius: $form-check-radio-border-radius;\n  }\n\n  &:active {\n    filter: $form-check-input-active-filter;\n  }\n\n  &:focus {\n    border-color: $form-check-input-focus-border;\n    outline: 0;\n    box-shadow: $form-check-input-focus-box-shadow;\n  }\n\n  &:checked {\n    background-color: $form-check-input-checked-bg-color;\n    border-color: $form-check-input-checked-border-color;\n\n    &[type=\"checkbox\"] {\n      @if $enable-gradients {\n        background-image: escape-svg($form-check-input-checked-bg-image), var(--#{$variable-prefix}gradient);\n      } @else {\n        background-image: escape-svg($form-check-input-checked-bg-image);\n      }\n    }\n\n    &[type=\"radio\"] {\n      @if $enable-gradients {\n        background-image: escape-svg($form-check-radio-checked-bg-image), var(--#{$variable-prefix}gradient);\n      } @else {\n        background-image: escape-svg($form-check-radio-checked-bg-image);\n      }\n    }\n  }\n\n  &[type=\"checkbox\"]:indeterminate {\n    background-color: $form-check-input-indeterminate-bg-color;\n    border-color: $form-check-input-indeterminate-border-color;\n\n    @if $enable-gradients {\n      background-image: escape-svg($form-check-input-indeterminate-bg-image), var(--#{$variable-prefix}gradient);\n    } @else {\n      background-image: escape-svg($form-check-input-indeterminate-bg-image);\n    }\n  }\n\n  &:disabled {\n    pointer-events: none;\n    filter: none;\n    opacity: $form-check-input-disabled-opacity;\n  }\n\n  // Use disabled attribute in addition of :disabled pseudo-class\n  // See: https://github.com/twbs/bootstrap/issues/28247\n  &[disabled],\n  &:disabled {\n    ~ .form-check-label {\n      opacity: $form-check-label-disabled-opacity;\n    }\n  }\n}\n\n.form-check-label {\n  color: $form-check-label-color;\n  cursor: $form-check-label-cursor;\n}\n\n//\n// Switch\n//\n\n.form-switch {\n  padding-left: $form-switch-padding-start;\n\n  .form-check-input {\n    width: $form-switch-width;\n    margin-left: $form-switch-padding-start * -1;\n    background-image: escape-svg($form-switch-bg-image);\n    background-position: left center;\n    @include border-radius($form-switch-border-radius);\n    @include transition($form-switch-transition);\n\n    &:focus {\n      background-image: escape-svg($form-switch-focus-bg-image);\n    }\n\n    &:checked {\n      background-position: $form-switch-checked-bg-position;\n\n      @if $enable-gradients {\n        background-image: escape-svg($form-switch-checked-bg-image), var(--#{$variable-prefix}gradient);\n      } @else {\n        background-image: escape-svg($form-switch-checked-bg-image);\n      }\n    }\n  }\n}\n\n.form-check-inline {\n  display: inline-block;\n  margin-right: $form-check-inline-margin-end;\n}\n\n.btn-check {\n  position: absolute;\n  clip: rect(0, 0, 0, 0);\n  pointer-events: none;\n\n  &[disabled],\n  &:disabled {\n    + .btn {\n      pointer-events: none;\n      filter: none;\n      opacity: $form-check-btn-check-disabled-opacity;\n    }\n  }\n}\n","// Range\n//\n// Style range inputs the same across browsers. Vendor-specific rules for pseudo\n// elements cannot be mixed. As such, there are no shared styles for focus or\n// active states on prefixed selectors.\n\n.form-range {\n  width: 100%;\n  height: add($form-range-thumb-height, $form-range-thumb-focus-box-shadow-width * 2);\n  padding: 0; // Need to reset padding\n  background-color: transparent;\n  appearance: none;\n\n  &:focus {\n    outline: 0;\n\n    // Pseudo-elements must be split across multiple rulesets to have an effect.\n    // No box-shadow() mixin for focus accessibility.\n    &::-webkit-slider-thumb { box-shadow: $form-range-thumb-focus-box-shadow; }\n    &::-moz-range-thumb     { box-shadow: $form-range-thumb-focus-box-shadow; }\n  }\n\n  &::-moz-focus-outer {\n    border: 0;\n  }\n\n  &::-webkit-slider-thumb {\n    width: $form-range-thumb-width;\n    height: $form-range-thumb-height;\n    margin-top: ($form-range-track-height - $form-range-thumb-height) * .5; // Webkit specific\n    @include gradient-bg($form-range-thumb-bg);\n    border: $form-range-thumb-border;\n    @include border-radius($form-range-thumb-border-radius);\n    @include box-shadow($form-range-thumb-box-shadow);\n    @include transition($form-range-thumb-transition);\n    appearance: none;\n\n    &:active {\n      @include gradient-bg($form-range-thumb-active-bg);\n    }\n  }\n\n  &::-webkit-slider-runnable-track {\n    width: $form-range-track-width;\n    height: $form-range-track-height;\n    color: transparent; // Why?\n    cursor: $form-range-track-cursor;\n    background-color: $form-range-track-bg;\n    border-color: transparent;\n    @include border-radius($form-range-track-border-radius);\n    @include box-shadow($form-range-track-box-shadow);\n  }\n\n  &::-moz-range-thumb {\n    width: $form-range-thumb-width;\n    height: $form-range-thumb-height;\n    @include gradient-bg($form-range-thumb-bg);\n    border: $form-range-thumb-border;\n    @include border-radius($form-range-thumb-border-radius);\n    @include box-shadow($form-range-thumb-box-shadow);\n    @include transition($form-range-thumb-transition);\n    appearance: none;\n\n    &:active {\n      @include gradient-bg($form-range-thumb-active-bg);\n    }\n  }\n\n  &::-moz-range-track {\n    width: $form-range-track-width;\n    height: $form-range-track-height;\n    color: transparent;\n    cursor: $form-range-track-cursor;\n    background-color: $form-range-track-bg;\n    border-color: transparent; // Firefox specific?\n    @include border-radius($form-range-track-border-radius);\n    @include box-shadow($form-range-track-box-shadow);\n  }\n\n  &:disabled {\n    pointer-events: none;\n\n    &::-webkit-slider-thumb {\n      background-color: $form-range-thumb-disabled-bg;\n    }\n\n    &::-moz-range-thumb {\n      background-color: $form-range-thumb-disabled-bg;\n    }\n  }\n}\n",".form-floating {\n  position: relative;\n\n  > .form-control,\n  > .form-select {\n    height: $form-floating-height;\n    line-height: $form-floating-line-height;\n  }\n\n  > label {\n    position: absolute;\n    top: 0;\n    left: 0;\n    height: 100%; // allow textareas\n    padding: $form-floating-padding-y $form-floating-padding-x;\n    pointer-events: none;\n    border: $input-border-width solid transparent; // Required for aligning label's text with the input as it affects inner box model\n    transform-origin: 0 0;\n    @include transition($form-floating-transition);\n  }\n\n  // stylelint-disable no-duplicate-selectors\n  > .form-control {\n    padding: $form-floating-padding-y $form-floating-padding-x;\n\n    &::placeholder {\n      color: transparent;\n    }\n\n    &:focus,\n    &:not(:placeholder-shown) {\n      padding-top: $form-floating-input-padding-t;\n      padding-bottom: $form-floating-input-padding-b;\n    }\n    // Duplicated because `:-webkit-autofill` invalidates other selectors when grouped\n    &:-webkit-autofill {\n      padding-top: $form-floating-input-padding-t;\n      padding-bottom: $form-floating-input-padding-b;\n    }\n  }\n\n  > .form-select {\n    padding-top: $form-floating-input-padding-t;\n    padding-bottom: $form-floating-input-padding-b;\n  }\n\n  > .form-control:focus,\n  > .form-control:not(:placeholder-shown),\n  > .form-select {\n    ~ label {\n      opacity: $form-floating-label-opacity;\n      transform: $form-floating-label-transform;\n    }\n  }\n  // Duplicated because `:-webkit-autofill` invalidates other selectors when grouped\n  > .form-control:-webkit-autofill {\n    ~ label {\n      opacity: $form-floating-label-opacity;\n      transform: $form-floating-label-transform;\n    }\n  }\n  // stylelint-enable no-duplicate-selectors\n}\n","//\n// Base styles\n//\n\n.input-group {\n  position: relative;\n  display: flex;\n  flex-wrap: wrap; // For form validation feedback\n  align-items: stretch;\n  width: 100%;\n\n  > .form-control,\n  > .form-select {\n    position: relative; // For focus state's z-index\n    flex: 1 1 auto;\n    width: 1%;\n    min-width: 0; // https://stackoverflow.com/questions/36247140/why-dont-flex-items-shrink-past-content-size\n  }\n\n  // Bring the \"active\" form control to the top of surrounding elements\n  > .form-control:focus,\n  > .form-select:focus {\n    z-index: 3;\n  }\n\n  // Ensure buttons are always above inputs for more visually pleasing borders.\n  // This isn't needed for `.input-group-text` since it shares the same border-color\n  // as our inputs.\n  .btn {\n    position: relative;\n    z-index: 2;\n\n    &:focus {\n      z-index: 3;\n    }\n  }\n}\n\n\n// Textual addons\n//\n// Serves as a catch-all element for any text or radio/checkbox input you wish\n// to prepend or append to an input.\n\n.input-group-text {\n  display: flex;\n  align-items: center;\n  padding: $input-group-addon-padding-y $input-group-addon-padding-x;\n  @include font-size($input-font-size); // Match inputs\n  font-weight: $input-group-addon-font-weight;\n  line-height: $input-line-height;\n  color: $input-group-addon-color;\n  text-align: center;\n  white-space: nowrap;\n  background-color: $input-group-addon-bg;\n  border: $input-border-width solid $input-group-addon-border-color;\n  @include border-radius($input-border-radius);\n}\n\n\n// Sizing\n//\n// Remix the default form control sizing classes into new ones for easier\n// manipulation.\n\n.input-group-lg > .form-control,\n.input-group-lg > .form-select,\n.input-group-lg > .input-group-text,\n.input-group-lg > .btn {\n  padding: $input-padding-y-lg $input-padding-x-lg;\n  @include font-size($input-font-size-lg);\n  @include border-radius($input-border-radius-lg);\n}\n\n.input-group-sm > .form-control,\n.input-group-sm > .form-select,\n.input-group-sm > .input-group-text,\n.input-group-sm > .btn {\n  padding: $input-padding-y-sm $input-padding-x-sm;\n  @include font-size($input-font-size-sm);\n  @include border-radius($input-border-radius-sm);\n}\n\n.input-group-lg > .form-select,\n.input-group-sm > .form-select {\n  padding-right: $form-select-padding-x + $form-select-indicator-padding;\n}\n\n\n// Rounded corners\n//\n// These rulesets must come after the sizing ones to properly override sm and lg\n// border-radius values when extending. They're more specific than we'd like\n// with the `.input-group >` part, but without it, we cannot override the sizing.\n\n// stylelint-disable-next-line no-duplicate-selectors\n.input-group {\n  &:not(.has-validation) {\n    > :not(:last-child):not(.dropdown-toggle):not(.dropdown-menu),\n    > .dropdown-toggle:nth-last-child(n + 3) {\n      @include border-end-radius(0);\n    }\n  }\n\n  &.has-validation {\n    > :nth-last-child(n + 3):not(.dropdown-toggle):not(.dropdown-menu),\n    > .dropdown-toggle:nth-last-child(n + 4) {\n      @include border-end-radius(0);\n    }\n  }\n\n  $validation-messages: \"\";\n  @each $state in map-keys($form-validation-states) {\n    $validation-messages: $validation-messages + \":not(.\" + unquote($state) + \"-tooltip)\" + \":not(.\" + unquote($state) + \"-feedback)\";\n  }\n\n  > :not(:first-child):not(.dropdown-menu)#{$validation-messages} {\n    margin-left: -$input-border-width;\n    @include border-start-radius(0);\n  }\n}\n","// This mixin uses an `if()` technique to be compatible with Dart Sass\n// See https://github.com/sass/sass/issues/1873#issuecomment-152293725 for more details\n\n// scss-docs-start form-validation-mixins\n@mixin form-validation-state-selector($state) {\n  @if ($state == \"valid\" or $state == \"invalid\") {\n    .was-validated #{if(&, \"&\", \"\")}:#{$state},\n    #{if(&, \"&\", \"\")}.is-#{$state} {\n      @content;\n    }\n  } @else {\n    #{if(&, \"&\", \"\")}.is-#{$state} {\n      @content;\n    }\n  }\n}\n\n@mixin form-validation-state(\n  $state,\n  $color,\n  $icon,\n  $tooltip-color: color-contrast($color),\n  $tooltip-bg-color: rgba($color, $form-feedback-tooltip-opacity),\n  $focus-box-shadow: 0 0 $input-btn-focus-blur $input-focus-width rgba($color, $input-btn-focus-color-opacity)\n) {\n  .#{$state}-feedback {\n    display: none;\n    width: 100%;\n    margin-top: $form-feedback-margin-top;\n    @include font-size($form-feedback-font-size);\n    font-style: $form-feedback-font-style;\n    color: $color;\n  }\n\n  .#{$state}-tooltip {\n    position: absolute;\n    top: 100%;\n    z-index: 5;\n    display: none;\n    max-width: 100%; // Contain to parent when possible\n    padding: $form-feedback-tooltip-padding-y $form-feedback-tooltip-padding-x;\n    margin-top: .1rem;\n    @include font-size($form-feedback-tooltip-font-size);\n    line-height: $form-feedback-tooltip-line-height;\n    color: $tooltip-color;\n    background-color: $tooltip-bg-color;\n    @include border-radius($form-feedback-tooltip-border-radius);\n  }\n\n  @include form-validation-state-selector($state) {\n    ~ .#{$state}-feedback,\n    ~ .#{$state}-tooltip {\n      display: block;\n    }\n  }\n\n  .form-control {\n    @include form-validation-state-selector($state) {\n      border-color: $color;\n\n      @if $enable-validation-icons {\n        padding-right: $input-height-inner;\n        background-image: escape-svg($icon);\n        background-repeat: no-repeat;\n        background-position: right $input-height-inner-quarter center;\n        background-size: $input-height-inner-half $input-height-inner-half;\n      }\n\n      &:focus {\n        border-color: $color;\n        box-shadow: $focus-box-shadow;\n      }\n    }\n  }\n\n  // stylelint-disable-next-line selector-no-qualifying-type\n  textarea.form-control {\n    @include form-validation-state-selector($state) {\n      @if $enable-validation-icons {\n        padding-right: $input-height-inner;\n        background-position: top $input-height-inner-quarter right $input-height-inner-quarter;\n      }\n    }\n  }\n\n  .form-select {\n    @include form-validation-state-selector($state) {\n      border-color: $color;\n\n      @if $enable-validation-icons {\n        &:not([multiple]):not([size]),\n        &:not([multiple])[size=\"1\"] {\n          padding-right: $form-select-feedback-icon-padding-end;\n          background-image: escape-svg($form-select-indicator), escape-svg($icon);\n          background-position: $form-select-bg-position, $form-select-feedback-icon-position;\n          background-size: $form-select-bg-size, $form-select-feedback-icon-size;\n        }\n      }\n\n      &:focus {\n        border-color: $color;\n        box-shadow: $focus-box-shadow;\n      }\n    }\n  }\n\n  .form-check-input {\n    @include form-validation-state-selector($state) {\n      border-color: $color;\n\n      &:checked {\n        background-color: $color;\n      }\n\n      &:focus {\n        box-shadow: $focus-box-shadow;\n      }\n\n      ~ .form-check-label {\n        color: $color;\n      }\n    }\n  }\n  .form-check-inline .form-check-input {\n    ~ .#{$state}-feedback {\n      margin-left: .5em;\n    }\n  }\n\n  .input-group .form-control,\n  .input-group .form-select {\n    @include form-validation-state-selector($state) {\n      @if $state == \"valid\" {\n        z-index: 1;\n      } @else if $state == \"invalid\" {\n        z-index: 2;\n      }\n      &:focus {\n        z-index: 3;\n      }\n    }\n  }\n}\n// scss-docs-end form-validation-mixins\n","//\n// Base styles\n//\n\n.btn {\n  display: inline-block;\n  font-family: $btn-font-family;\n  font-weight: $btn-font-weight;\n  line-height: $btn-line-height;\n  color: $body-color;\n  text-align: center;\n  text-decoration: if($link-decoration == none, null, none);\n  white-space: $btn-white-space;\n  vertical-align: middle;\n  cursor: if($enable-button-pointers, pointer, null);\n  user-select: none;\n  background-color: transparent;\n  border: $btn-border-width solid transparent;\n  @include button-size($btn-padding-y, $btn-padding-x, $btn-font-size, $btn-border-radius);\n  @include transition($btn-transition);\n\n  &:hover {\n    color: $body-color;\n    text-decoration: if($link-hover-decoration == underline, none, null);\n  }\n\n  .btn-check:focus + &,\n  &:focus {\n    outline: 0;\n    box-shadow: $btn-focus-box-shadow;\n  }\n\n  .btn-check:checked + &,\n  .btn-check:active + &,\n  &:active,\n  &.active {\n    @include box-shadow($btn-active-box-shadow);\n\n    &:focus {\n      @include box-shadow($btn-focus-box-shadow, $btn-active-box-shadow);\n    }\n  }\n\n  &:disabled,\n  &.disabled,\n  fieldset:disabled & {\n    pointer-events: none;\n    opacity: $btn-disabled-opacity;\n    @include box-shadow(none);\n  }\n}\n\n\n//\n// Alternate buttons\n//\n\n// scss-docs-start btn-variant-loops\n@each $color, $value in $theme-colors {\n  .btn-#{$color} {\n    @include button-variant($value, $value);\n  }\n}\n\n@each $color, $value in $theme-colors {\n  .btn-outline-#{$color} {\n    @include button-outline-variant($value);\n  }\n}\n// scss-docs-end btn-variant-loops\n\n\n//\n// Link buttons\n//\n\n// Make a button look and behave like a link\n.btn-link {\n  font-weight: $font-weight-normal;\n  color: $btn-link-color;\n  text-decoration: $link-decoration;\n\n  &:hover {\n    color: $btn-link-hover-color;\n    text-decoration: $link-hover-decoration;\n  }\n\n  &:focus {\n    text-decoration: $link-hover-decoration;\n  }\n\n  &:disabled,\n  &.disabled {\n    color: $btn-link-disabled-color;\n  }\n\n  // No need for an active state here\n}\n\n\n//\n// Button Sizes\n//\n\n.btn-lg {\n  @include button-size($btn-padding-y-lg, $btn-padding-x-lg, $btn-font-size-lg, $btn-border-radius-lg);\n}\n\n.btn-sm {\n  @include button-size($btn-padding-y-sm, $btn-padding-x-sm, $btn-font-size-sm, $btn-border-radius-sm);\n}\n","// Button variants\n//\n// Easily pump out default styles, as well as :hover, :focus, :active,\n// and disabled options for all buttons\n\n// scss-docs-start btn-variant-mixin\n@mixin button-variant(\n  $background,\n  $border,\n  $color: color-contrast($background),\n  $hover-background: if($color == $color-contrast-light, shade-color($background, $btn-hover-bg-shade-amount), tint-color($background, $btn-hover-bg-tint-amount)),\n  $hover-border: if($color == $color-contrast-light, shade-color($border, $btn-hover-border-shade-amount), tint-color($border, $btn-hover-border-tint-amount)),\n  $hover-color: color-contrast($hover-background),\n  $active-background: if($color == $color-contrast-light, shade-color($background, $btn-active-bg-shade-amount), tint-color($background, $btn-active-bg-tint-amount)),\n  $active-border: if($color == $color-contrast-light, shade-color($border, $btn-active-border-shade-amount), tint-color($border, $btn-active-border-tint-amount)),\n  $active-color: color-contrast($active-background),\n  $disabled-background: $background,\n  $disabled-border: $border,\n  $disabled-color: color-contrast($disabled-background)\n) {\n  color: $color;\n  @include gradient-bg($background);\n  border-color: $border;\n  @include box-shadow($btn-box-shadow);\n\n  &:hover {\n    color: $hover-color;\n    @include gradient-bg($hover-background);\n    border-color: $hover-border;\n  }\n\n  .btn-check:focus + &,\n  &:focus {\n    color: $hover-color;\n    @include gradient-bg($hover-background);\n    border-color: $hover-border;\n    @if $enable-shadows {\n      @include box-shadow($btn-box-shadow, 0 0 0 $btn-focus-width rgba(mix($color, $border, 15%), .5));\n    } @else {\n      // Avoid using mixin so we can pass custom focus shadow properly\n      box-shadow: 0 0 0 $btn-focus-width rgba(mix($color, $border, 15%), .5);\n    }\n  }\n\n  .btn-check:checked + &,\n  .btn-check:active + &,\n  &:active,\n  &.active,\n  .show > &.dropdown-toggle {\n    color: $active-color;\n    background-color: $active-background;\n    // Remove CSS gradients if they're enabled\n    background-image: if($enable-gradients, none, null);\n    border-color: $active-border;\n\n    &:focus {\n      @if $enable-shadows {\n        @include box-shadow($btn-active-box-shadow, 0 0 0 $btn-focus-width rgba(mix($color, $border, 15%), .5));\n      } @else {\n        // Avoid using mixin so we can pass custom focus shadow properly\n        box-shadow: 0 0 0 $btn-focus-width rgba(mix($color, $border, 15%), .5);\n      }\n    }\n  }\n\n  &:disabled,\n  &.disabled {\n    color: $disabled-color;\n    background-color: $disabled-background;\n    // Remove CSS gradients if they're enabled\n    background-image: if($enable-gradients, none, null);\n    border-color: $disabled-border;\n  }\n}\n// scss-docs-end btn-variant-mixin\n\n// scss-docs-start btn-outline-variant-mixin\n@mixin button-outline-variant(\n  $color,\n  $color-hover: color-contrast($color),\n  $active-background: $color,\n  $active-border: $color,\n  $active-color: color-contrast($active-background)\n) {\n  color: $color;\n  border-color: $color;\n\n  &:hover {\n    color: $color-hover;\n    background-color: $active-background;\n    border-color: $active-border;\n  }\n\n  .btn-check:focus + &,\n  &:focus {\n    box-shadow: 0 0 0 $btn-focus-width rgba($color, .5);\n  }\n\n  .btn-check:checked + &,\n  .btn-check:active + &,\n  &:active,\n  &.active,\n  &.dropdown-toggle.show {\n    color: $active-color;\n    background-color: $active-background;\n    border-color: $active-border;\n\n    &:focus {\n      @if $enable-shadows {\n        @include box-shadow($btn-active-box-shadow, 0 0 0 $btn-focus-width rgba($color, .5));\n      } @else {\n        // Avoid using mixin so we can pass custom focus shadow properly\n        box-shadow: 0 0 0 $btn-focus-width rgba($color, .5);\n      }\n    }\n  }\n\n  &:disabled,\n  &.disabled {\n    color: $color;\n    background-color: transparent;\n  }\n}\n// scss-docs-end btn-outline-variant-mixin\n\n// scss-docs-start btn-size-mixin\n@mixin button-size($padding-y, $padding-x, $font-size, $border-radius) {\n  padding: $padding-y $padding-x;\n  @include font-size($font-size);\n  // Manually declare to provide an override to the browser default\n  @include border-radius($border-radius, 0);\n}\n// scss-docs-end btn-size-mixin\n",".fade {\n  @include transition($transition-fade);\n\n  &:not(.show) {\n    opacity: 0;\n  }\n}\n\n// scss-docs-start collapse-classes\n.collapse {\n  &:not(.show) {\n    display: none;\n  }\n}\n\n.collapsing {\n  height: 0;\n  overflow: hidden;\n  @include transition($transition-collapse);\n\n  &.collapse-horizontal {\n    width: 0;\n    height: auto;\n    @include transition($transition-collapse-width);\n  }\n}\n// scss-docs-end collapse-classes\n","// The dropdown wrapper (`<div>`)\n.dropup,\n.dropend,\n.dropdown,\n.dropstart {\n  position: relative;\n}\n\n.dropdown-toggle {\n  white-space: nowrap;\n\n  // Generate the caret automatically\n  @include caret();\n}\n\n// The dropdown menu\n.dropdown-menu {\n  position: absolute;\n  z-index: $zindex-dropdown;\n  display: none; // none by default, but block on \"open\" of the menu\n  min-width: $dropdown-min-width;\n  padding: $dropdown-padding-y $dropdown-padding-x;\n  margin: 0; // Override default margin of ul\n  @include font-size($dropdown-font-size);\n  color: $dropdown-color;\n  text-align: left; // Ensures proper alignment if parent has it changed (e.g., modal footer)\n  list-style: none;\n  background-color: $dropdown-bg;\n  background-clip: padding-box;\n  border: $dropdown-border-width solid $dropdown-border-color;\n  @include border-radius($dropdown-border-radius);\n  @include box-shadow($dropdown-box-shadow);\n\n  &[data-bs-popper] {\n    top: 100%;\n    left: 0;\n    margin-top: $dropdown-spacer;\n  }\n}\n\n// scss-docs-start responsive-breakpoints\n// We deliberately hardcode the `bs-` prefix because we check\n// this custom property in JS to determine Popper's positioning\n\n@each $breakpoint in map-keys($grid-breakpoints) {\n  @include media-breakpoint-up($breakpoint) {\n    $infix: breakpoint-infix($breakpoint, $grid-breakpoints);\n\n    .dropdown-menu#{$infix}-start {\n      --bs-position: start;\n\n      &[data-bs-popper] {\n        right: auto;\n        left: 0;\n      }\n    }\n\n    .dropdown-menu#{$infix}-end {\n      --bs-position: end;\n\n      &[data-bs-popper] {\n        right: 0;\n        left: auto;\n      }\n    }\n  }\n}\n// scss-docs-end responsive-breakpoints\n\n// Allow for dropdowns to go bottom up (aka, dropup-menu)\n// Just add .dropup after the standard .dropdown class and you're set.\n.dropup {\n  .dropdown-menu[data-bs-popper] {\n    top: auto;\n    bottom: 100%;\n    margin-top: 0;\n    margin-bottom: $dropdown-spacer;\n  }\n\n  .dropdown-toggle {\n    @include caret(up);\n  }\n}\n\n.dropend {\n  .dropdown-menu[data-bs-popper] {\n    top: 0;\n    right: auto;\n    left: 100%;\n    margin-top: 0;\n    margin-left: $dropdown-spacer;\n  }\n\n  .dropdown-toggle {\n    @include caret(end);\n    &::after {\n      vertical-align: 0;\n    }\n  }\n}\n\n.dropstart {\n  .dropdown-menu[data-bs-popper] {\n    top: 0;\n    right: 100%;\n    left: auto;\n    margin-top: 0;\n    margin-right: $dropdown-spacer;\n  }\n\n  .dropdown-toggle {\n    @include caret(start);\n    &::before {\n      vertical-align: 0;\n    }\n  }\n}\n\n\n// Dividers (basically an `<hr>`) within the dropdown\n.dropdown-divider {\n  height: 0;\n  margin: $dropdown-divider-margin-y 0;\n  overflow: hidden;\n  border-top: 1px solid $dropdown-divider-bg;\n}\n\n// Links, buttons, and more within the dropdown menu\n//\n// `<button>`-specific styles are denoted with `// For <button>s`\n.dropdown-item {\n  display: block;\n  width: 100%; // For `<button>`s\n  padding: $dropdown-item-padding-y $dropdown-item-padding-x;\n  clear: both;\n  font-weight: $font-weight-normal;\n  color: $dropdown-link-color;\n  text-align: inherit; // For `<button>`s\n  text-decoration: if($link-decoration == none, null, none);\n  white-space: nowrap; // prevent links from randomly breaking onto new lines\n  background-color: transparent; // For `<button>`s\n  border: 0; // For `<button>`s\n\n  // Prevent dropdown overflow if there's no padding\n  // See https://github.com/twbs/bootstrap/pull/27703\n  @if $dropdown-padding-y == 0 {\n    &:first-child {\n      @include border-top-radius($dropdown-inner-border-radius);\n    }\n\n    &:last-child {\n      @include border-bottom-radius($dropdown-inner-border-radius);\n    }\n  }\n\n  &:hover,\n  &:focus {\n    color: $dropdown-link-hover-color;\n    text-decoration: if($link-hover-decoration == underline, none, null);\n    @include gradient-bg($dropdown-link-hover-bg);\n  }\n\n  &.active,\n  &:active {\n    color: $dropdown-link-active-color;\n    text-decoration: none;\n    @include gradient-bg($dropdown-link-active-bg);\n  }\n\n  &.disabled,\n  &:disabled {\n    color: $dropdown-link-disabled-color;\n    pointer-events: none;\n    background-color: transparent;\n    // Remove CSS gradients if they're enabled\n    background-image: if($enable-gradients, none, null);\n  }\n}\n\n.dropdown-menu.show {\n  display: block;\n}\n\n// Dropdown section headers\n.dropdown-header {\n  display: block;\n  padding: $dropdown-header-padding;\n  margin-bottom: 0; // for use with heading elements\n  @include font-size($font-size-sm);\n  color: $dropdown-header-color;\n  white-space: nowrap; // as with > li > a\n}\n\n// Dropdown text\n.dropdown-item-text {\n  display: block;\n  padding: $dropdown-item-padding-y $dropdown-item-padding-x;\n  color: $dropdown-link-color;\n}\n\n// Dark dropdowns\n.dropdown-menu-dark {\n  color: $dropdown-dark-color;\n  background-color: $dropdown-dark-bg;\n  border-color: $dropdown-dark-border-color;\n  @include box-shadow($dropdown-dark-box-shadow);\n\n  .dropdown-item {\n    color: $dropdown-dark-link-color;\n\n    &:hover,\n    &:focus {\n      color: $dropdown-dark-link-hover-color;\n      @include gradient-bg($dropdown-dark-link-hover-bg);\n    }\n\n    &.active,\n    &:active {\n      color: $dropdown-dark-link-active-color;\n      @include gradient-bg($dropdown-dark-link-active-bg);\n    }\n\n    &.disabled,\n    &:disabled {\n      color: $dropdown-dark-link-disabled-color;\n    }\n  }\n\n  .dropdown-divider {\n    border-color: $dropdown-dark-divider-bg;\n  }\n\n  .dropdown-item-text {\n    color: $dropdown-dark-link-color;\n  }\n\n  .dropdown-header {\n    color: $dropdown-dark-header-color;\n  }\n}\n","// scss-docs-start caret-mixins\n@mixin caret-down {\n  border-top: $caret-width solid;\n  border-right: $caret-width solid transparent;\n  border-bottom: 0;\n  border-left: $caret-width solid transparent;\n}\n\n@mixin caret-up {\n  border-top: 0;\n  border-right: $caret-width solid transparent;\n  border-bottom: $caret-width solid;\n  border-left: $caret-width solid transparent;\n}\n\n@mixin caret-end {\n  border-top: $caret-width solid transparent;\n  border-right: 0;\n  border-bottom: $caret-width solid transparent;\n  border-left: $caret-width solid;\n}\n\n@mixin caret-start {\n  border-top: $caret-width solid transparent;\n  border-right: $caret-width solid;\n  border-bottom: $caret-width solid transparent;\n}\n\n@mixin caret($direction: down) {\n  @if $enable-caret {\n    &::after {\n      display: inline-block;\n      margin-left: $caret-spacing;\n      vertical-align: $caret-vertical-align;\n      content: \"\";\n      @if $direction == down {\n        @include caret-down();\n      } @else if $direction == up {\n        @include caret-up();\n      } @else if $direction == end {\n        @include caret-end();\n      }\n    }\n\n    @if $direction == start {\n      &::after {\n        display: none;\n      }\n\n      &::before {\n        display: inline-block;\n        margin-right: $caret-spacing;\n        vertical-align: $caret-vertical-align;\n        content: \"\";\n        @include caret-start();\n      }\n    }\n\n    &:empty::after {\n      margin-left: 0;\n    }\n  }\n}\n// scss-docs-end caret-mixins\n","// Make the div behave like a button\n.btn-group,\n.btn-group-vertical {\n  position: relative;\n  display: inline-flex;\n  vertical-align: middle; // match .btn alignment given font-size hack above\n\n  > .btn {\n    position: relative;\n    flex: 1 1 auto;\n  }\n\n  // Bring the hover, focused, and \"active\" buttons to the front to overlay\n  // the borders properly\n  > .btn-check:checked + .btn,\n  > .btn-check:focus + .btn,\n  > .btn:hover,\n  > .btn:focus,\n  > .btn:active,\n  > .btn.active {\n    z-index: 1;\n  }\n}\n\n// Optional: Group multiple button groups together for a toolbar\n.btn-toolbar {\n  display: flex;\n  flex-wrap: wrap;\n  justify-content: flex-start;\n\n  .input-group {\n    width: auto;\n  }\n}\n\n.btn-group {\n  // Prevent double borders when buttons are next to each other\n  > .btn:not(:first-child),\n  > .btn-group:not(:first-child) {\n    margin-left: -$btn-border-width;\n  }\n\n  // Reset rounded corners\n  > .btn:not(:last-child):not(.dropdown-toggle),\n  > .btn-group:not(:last-child) > .btn {\n    @include border-end-radius(0);\n  }\n\n  // The left radius should be 0 if the button is:\n  // - the \"third or more\" child\n  // - the second child and the previous element isn't `.btn-check` (making it the first child visually)\n  // - part of a btn-group which isn't the first child\n  > .btn:nth-child(n + 3),\n  > :not(.btn-check) + .btn,\n  > .btn-group:not(:first-child) > .btn {\n    @include border-start-radius(0);\n  }\n}\n\n// Sizing\n//\n// Remix the default button sizing classes into new ones for easier manipulation.\n\n.btn-group-sm > .btn { @extend .btn-sm; }\n.btn-group-lg > .btn { @extend .btn-lg; }\n\n\n//\n// Split button dropdowns\n//\n\n.dropdown-toggle-split {\n  padding-right: $btn-padding-x * .75;\n  padding-left: $btn-padding-x * .75;\n\n  &::after,\n  .dropup &::after,\n  .dropend &::after {\n    margin-left: 0;\n  }\n\n  .dropstart &::before {\n    margin-right: 0;\n  }\n}\n\n.btn-sm + .dropdown-toggle-split {\n  padding-right: $btn-padding-x-sm * .75;\n  padding-left: $btn-padding-x-sm * .75;\n}\n\n.btn-lg + .dropdown-toggle-split {\n  padding-right: $btn-padding-x-lg * .75;\n  padding-left: $btn-padding-x-lg * .75;\n}\n\n\n// The clickable button for toggling the menu\n// Set the same inset shadow as the :active state\n.btn-group.show .dropdown-toggle {\n  @include box-shadow($btn-active-box-shadow);\n\n  // Show no shadow for `.btn-link` since it has no other button styles.\n  &.btn-link {\n    @include box-shadow(none);\n  }\n}\n\n\n//\n// Vertical button groups\n//\n\n.btn-group-vertical {\n  flex-direction: column;\n  align-items: flex-start;\n  justify-content: center;\n\n  > .btn,\n  > .btn-group {\n    width: 100%;\n  }\n\n  > .btn:not(:first-child),\n  > .btn-group:not(:first-child) {\n    margin-top: -$btn-border-width;\n  }\n\n  // Reset rounded corners\n  > .btn:not(:last-child):not(.dropdown-toggle),\n  > .btn-group:not(:last-child) > .btn {\n    @include border-bottom-radius(0);\n  }\n\n  > .btn ~ .btn,\n  > .btn-group:not(:first-child) > .btn {\n    @include border-top-radius(0);\n  }\n}\n","// Base class\n//\n// Kickstart any navigation component with a set of style resets. Works with\n// `<nav>`s, `<ul>`s or `<ol>`s.\n\n.nav {\n  display: flex;\n  flex-wrap: wrap;\n  padding-left: 0;\n  margin-bottom: 0;\n  list-style: none;\n}\n\n.nav-link {\n  display: block;\n  padding: $nav-link-padding-y $nav-link-padding-x;\n  @include font-size($nav-link-font-size);\n  font-weight: $nav-link-font-weight;\n  color: $nav-link-color;\n  text-decoration: if($link-decoration == none, null, none);\n  @include transition($nav-link-transition);\n\n  &:hover,\n  &:focus {\n    color: $nav-link-hover-color;\n    text-decoration: if($link-hover-decoration == underline, none, null);\n  }\n\n  // Disabled state lightens text\n  &.disabled {\n    color: $nav-link-disabled-color;\n    pointer-events: none;\n    cursor: default;\n  }\n}\n\n//\n// Tabs\n//\n\n.nav-tabs {\n  border-bottom: $nav-tabs-border-width solid $nav-tabs-border-color;\n\n  .nav-link {\n    margin-bottom: -$nav-tabs-border-width;\n    background: none;\n    border: $nav-tabs-border-width solid transparent;\n    @include border-top-radius($nav-tabs-border-radius);\n\n    &:hover,\n    &:focus {\n      border-color: $nav-tabs-link-hover-border-color;\n      // Prevents active .nav-link tab overlapping focus outline of previous/next .nav-link\n      isolation: isolate;\n    }\n\n    &.disabled {\n      color: $nav-link-disabled-color;\n      background-color: transparent;\n      border-color: transparent;\n    }\n  }\n\n  .nav-link.active,\n  .nav-item.show .nav-link {\n    color: $nav-tabs-link-active-color;\n    background-color: $nav-tabs-link-active-bg;\n    border-color: $nav-tabs-link-active-border-color;\n  }\n\n  .dropdown-menu {\n    // Make dropdown border overlap tab border\n    margin-top: -$nav-tabs-border-width;\n    // Remove the top rounded corners here since there is a hard edge above the menu\n    @include border-top-radius(0);\n  }\n}\n\n\n//\n// Pills\n//\n\n.nav-pills {\n  .nav-link {\n    background: none;\n    border: 0;\n    @include border-radius($nav-pills-border-radius);\n  }\n\n  .nav-link.active,\n  .show > .nav-link {\n    color: $nav-pills-link-active-color;\n    @include gradient-bg($nav-pills-link-active-bg);\n  }\n}\n\n\n//\n// Justified variants\n//\n\n.nav-fill {\n  > .nav-link,\n  .nav-item {\n    flex: 1 1 auto;\n    text-align: center;\n  }\n}\n\n.nav-justified {\n  > .nav-link,\n  .nav-item {\n    flex-basis: 0;\n    flex-grow: 1;\n    text-align: center;\n  }\n}\n\n.nav-fill,\n.nav-justified {\n  .nav-item .nav-link {\n    width: 100%; // Make sure button will grow\n  }\n}\n\n\n// Tabbable tabs\n//\n// Hide tabbable panes to start, show them when `.active`\n\n.tab-content {\n  > .tab-pane {\n    display: none;\n  }\n  > .active {\n    display: block;\n  }\n}\n","// Contents\n//\n// Navbar\n// Navbar brand\n// Navbar nav\n// Navbar text\n// Responsive navbar\n// Navbar position\n// Navbar themes\n\n\n// Navbar\n//\n// Provide a static navbar from which we expand to create full-width, fixed, and\n// other navbar variations.\n\n.navbar {\n  position: relative;\n  display: flex;\n  flex-wrap: wrap; // allow us to do the line break for collapsing content\n  align-items: center;\n  justify-content: space-between; // space out brand from logo\n  padding-top: $navbar-padding-y;\n  padding-right: $navbar-padding-x; // default: null\n  padding-bottom: $navbar-padding-y;\n  padding-left: $navbar-padding-x; // default: null\n  @include gradient-bg();\n\n  // Because flex properties aren't inherited, we need to redeclare these first\n  // few properties so that content nested within behave properly.\n  // The `flex-wrap` property is inherited to simplify the expanded navbars\n  %container-flex-properties {\n    display: flex;\n    flex-wrap: inherit;\n    align-items: center;\n    justify-content: space-between;\n  }\n\n  > .container,\n  > .container-fluid {\n    @extend %container-flex-properties;\n  }\n\n  @each $breakpoint, $container-max-width in $container-max-widths {\n    > .container#{breakpoint-infix($breakpoint, $container-max-widths)} {\n      @extend %container-flex-properties;\n    }\n  }\n}\n\n\n// Navbar brand\n//\n// Used for brand, project, or site names.\n\n.navbar-brand {\n  padding-top: $navbar-brand-padding-y;\n  padding-bottom: $navbar-brand-padding-y;\n  margin-right: $navbar-brand-margin-end;\n  @include font-size($navbar-brand-font-size);\n  text-decoration: if($link-decoration == none, null, none);\n  white-space: nowrap;\n\n  &:hover,\n  &:focus {\n    text-decoration: if($link-hover-decoration == underline, none, null);\n  }\n}\n\n\n// Navbar nav\n//\n// Custom navbar navigation (doesn't require `.nav`, but does make use of `.nav-link`).\n\n.navbar-nav {\n  display: flex;\n  flex-direction: column; // cannot use `inherit` to get the `.navbar`s value\n  padding-left: 0;\n  margin-bottom: 0;\n  list-style: none;\n\n  .nav-link {\n    padding-right: 0;\n    padding-left: 0;\n  }\n\n  .dropdown-menu {\n    position: static;\n  }\n}\n\n\n// Navbar text\n//\n//\n\n.navbar-text {\n  padding-top: $nav-link-padding-y;\n  padding-bottom: $nav-link-padding-y;\n}\n\n\n// Responsive navbar\n//\n// Custom styles for responsive collapsing and toggling of navbar contents.\n// Powered by the collapse Bootstrap JavaScript plugin.\n\n// When collapsed, prevent the toggleable navbar contents from appearing in\n// the default flexbox row orientation. Requires the use of `flex-wrap: wrap`\n// on the `.navbar` parent.\n.navbar-collapse {\n  flex-basis: 100%;\n  flex-grow: 1;\n  // For always expanded or extra full navbars, ensure content aligns itself\n  // properly vertically. Can be easily overridden with flex utilities.\n  align-items: center;\n}\n\n// Button for toggling the navbar when in its collapsed state\n.navbar-toggler {\n  padding: $navbar-toggler-padding-y $navbar-toggler-padding-x;\n  @include font-size($navbar-toggler-font-size);\n  line-height: 1;\n  background-color: transparent; // remove default button style\n  border: $border-width solid transparent; // remove default button style\n  @include border-radius($navbar-toggler-border-radius);\n  @include transition($navbar-toggler-transition);\n\n  &:hover {\n    text-decoration: none;\n  }\n\n  &:focus {\n    text-decoration: none;\n    outline: 0;\n    box-shadow: 0 0 0 $navbar-toggler-focus-width;\n  }\n}\n\n// Keep as a separate element so folks can easily override it with another icon\n// or image file as needed.\n.navbar-toggler-icon {\n  display: inline-block;\n  width: 1.5em;\n  height: 1.5em;\n  vertical-align: middle;\n  background-repeat: no-repeat;\n  background-position: center;\n  background-size: 100%;\n}\n\n.navbar-nav-scroll {\n  max-height: var(--#{$variable-prefix}scroll-height, 75vh);\n  overflow-y: auto;\n}\n\n// scss-docs-start navbar-expand-loop\n// Generate series of `.navbar-expand-*` responsive classes for configuring\n// where your navbar collapses.\n.navbar-expand {\n  @each $breakpoint in map-keys($grid-breakpoints) {\n    $next: breakpoint-next($breakpoint, $grid-breakpoints);\n    $infix: breakpoint-infix($next, $grid-breakpoints);\n\n    // stylelint-disable-next-line scss/selector-no-union-class-name\n    &#{$infix} {\n      @include media-breakpoint-up($next) {\n        flex-wrap: nowrap;\n        justify-content: flex-start;\n\n        .navbar-nav {\n          flex-direction: row;\n\n          .dropdown-menu {\n            position: absolute;\n          }\n\n          .nav-link {\n            padding-right: $navbar-nav-link-padding-x;\n            padding-left: $navbar-nav-link-padding-x;\n          }\n        }\n\n        .navbar-nav-scroll {\n          overflow: visible;\n        }\n\n        .navbar-collapse {\n          display: flex !important; // stylelint-disable-line declaration-no-important\n          flex-basis: auto;\n        }\n\n        .navbar-toggler {\n          display: none;\n        }\n\n        .offcanvas-header {\n          display: none;\n        }\n\n        .offcanvas {\n          position: inherit;\n          bottom: 0;\n          z-index: 1000;\n          flex-grow: 1;\n          visibility: visible !important; // stylelint-disable-line declaration-no-important\n          background-color: transparent;\n          border-right: 0;\n          border-left: 0;\n          @include transition(none);\n          transform: none;\n        }\n        .offcanvas-top,\n        .offcanvas-bottom {\n          height: auto;\n          border-top: 0;\n          border-bottom: 0;\n        }\n\n        .offcanvas-body {\n          display: flex;\n          flex-grow: 0;\n          padding: 0;\n          overflow-y: visible;\n        }\n      }\n    }\n  }\n}\n// scss-docs-end navbar-expand-loop\n\n// Navbar themes\n//\n// Styles for switching between navbars with light or dark background.\n\n// Dark links against a light background\n.navbar-light {\n  .navbar-brand {\n    color: $navbar-light-brand-color;\n\n    &:hover,\n    &:focus {\n      color: $navbar-light-brand-hover-color;\n    }\n  }\n\n  .navbar-nav {\n    .nav-link {\n      color: $navbar-light-color;\n\n      &:hover,\n      &:focus {\n        color: $navbar-light-hover-color;\n      }\n\n      &.disabled {\n        color: $navbar-light-disabled-color;\n      }\n    }\n\n    .show > .nav-link,\n    .nav-link.active {\n      color: $navbar-light-active-color;\n    }\n  }\n\n  .navbar-toggler {\n    color: $navbar-light-color;\n    border-color: $navbar-light-toggler-border-color;\n  }\n\n  .navbar-toggler-icon {\n    background-image: escape-svg($navbar-light-toggler-icon-bg);\n  }\n\n  .navbar-text {\n    color: $navbar-light-color;\n\n    a,\n    a:hover,\n    a:focus  {\n      color: $navbar-light-active-color;\n    }\n  }\n}\n\n// White links against a dark background\n.navbar-dark {\n  .navbar-brand {\n    color: $navbar-dark-brand-color;\n\n    &:hover,\n    &:focus {\n      color: $navbar-dark-brand-hover-color;\n    }\n  }\n\n  .navbar-nav {\n    .nav-link {\n      color: $navbar-dark-color;\n\n      &:hover,\n      &:focus {\n        color: $navbar-dark-hover-color;\n      }\n\n      &.disabled {\n        color: $navbar-dark-disabled-color;\n      }\n    }\n\n    .show > .nav-link,\n    .nav-link.active {\n      color: $navbar-dark-active-color;\n    }\n  }\n\n  .navbar-toggler {\n    color: $navbar-dark-color;\n    border-color: $navbar-dark-toggler-border-color;\n  }\n\n  .navbar-toggler-icon {\n    background-image: escape-svg($navbar-dark-toggler-icon-bg);\n  }\n\n  .navbar-text {\n    color: $navbar-dark-color;\n    a,\n    a:hover,\n    a:focus {\n      color: $navbar-dark-active-color;\n    }\n  }\n}\n","//\n// Base styles\n//\n\n.card {\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  min-width: 0; // See https://github.com/twbs/bootstrap/pull/22740#issuecomment-305868106\n  height: $card-height;\n  word-wrap: break-word;\n  background-color: $card-bg;\n  background-clip: border-box;\n  border: $card-border-width solid $card-border-color;\n  @include border-radius($card-border-radius);\n  @include box-shadow($card-box-shadow);\n\n  > hr {\n    margin-right: 0;\n    margin-left: 0;\n  }\n\n  > .list-group {\n    border-top: inherit;\n    border-bottom: inherit;\n\n    &:first-child {\n      border-top-width: 0;\n      @include border-top-radius($card-inner-border-radius);\n    }\n\n    &:last-child  {\n      border-bottom-width: 0;\n      @include border-bottom-radius($card-inner-border-radius);\n    }\n  }\n\n  // Due to specificity of the above selector (`.card > .list-group`), we must\n  // use a child selector here to prevent double borders.\n  > .card-header + .list-group,\n  > .list-group + .card-footer {\n    border-top: 0;\n  }\n}\n\n.card-body {\n  // Enable `flex-grow: 1` for decks and groups so that card blocks take up\n  // as much space as possible, ensuring footers are aligned to the bottom.\n  flex: 1 1 auto;\n  padding: $card-spacer-y $card-spacer-x;\n  color: $card-color;\n}\n\n.card-title {\n  margin-bottom: $card-title-spacer-y;\n}\n\n.card-subtitle {\n  margin-top: -$card-title-spacer-y * .5;\n  margin-bottom: 0;\n}\n\n.card-text:last-child {\n  margin-bottom: 0;\n}\n\n.card-link {\n  &:hover {\n    text-decoration: if($link-hover-decoration == underline, none, null);\n  }\n\n  + .card-link {\n    margin-left: $card-spacer-x;\n  }\n}\n\n//\n// Optional textual caps\n//\n\n.card-header {\n  padding: $card-cap-padding-y $card-cap-padding-x;\n  margin-bottom: 0; // Removes the default margin-bottom of <hN>\n  color: $card-cap-color;\n  background-color: $card-cap-bg;\n  border-bottom: $card-border-width solid $card-border-color;\n\n  &:first-child {\n    @include border-radius($card-inner-border-radius $card-inner-border-radius 0 0);\n  }\n}\n\n.card-footer {\n  padding: $card-cap-padding-y $card-cap-padding-x;\n  color: $card-cap-color;\n  background-color: $card-cap-bg;\n  border-top: $card-border-width solid $card-border-color;\n\n  &:last-child {\n    @include border-radius(0 0 $card-inner-border-radius $card-inner-border-radius);\n  }\n}\n\n\n//\n// Header navs\n//\n\n.card-header-tabs {\n  margin-right: -$card-cap-padding-x * .5;\n  margin-bottom: -$card-cap-padding-y;\n  margin-left: -$card-cap-padding-x * .5;\n  border-bottom: 0;\n\n  @if $nav-tabs-link-active-bg != $card-bg {\n    .nav-link.active {\n      background-color: $card-bg;\n      border-bottom-color: $card-bg;\n    }\n  }\n}\n\n.card-header-pills {\n  margin-right: -$card-cap-padding-x * .5;\n  margin-left: -$card-cap-padding-x * .5;\n}\n\n// Card image\n.card-img-overlay {\n  position: absolute;\n  top: 0;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  padding: $card-img-overlay-padding;\n  @include border-radius($card-inner-border-radius);\n}\n\n.card-img,\n.card-img-top,\n.card-img-bottom {\n  width: 100%; // Required because we use flexbox and this inherently applies align-self: stretch\n}\n\n.card-img,\n.card-img-top {\n  @include border-top-radius($card-inner-border-radius);\n}\n\n.card-img,\n.card-img-bottom {\n  @include border-bottom-radius($card-inner-border-radius);\n}\n\n\n//\n// Card groups\n//\n\n.card-group {\n  // The child selector allows nested `.card` within `.card-group`\n  // to display properly.\n  > .card {\n    margin-bottom: $card-group-margin;\n  }\n\n  @include media-breakpoint-up(sm) {\n    display: flex;\n    flex-flow: row wrap;\n    // The child selector allows nested `.card` within `.card-group`\n    // to display properly.\n    > .card {\n      // Flexbugs #4: https://github.com/philipwalton/flexbugs#flexbug-4\n      flex: 1 0 0%;\n      margin-bottom: 0;\n\n      + .card {\n        margin-left: 0;\n        border-left: 0;\n      }\n\n      // Handle rounded corners\n      @if $enable-rounded {\n        &:not(:last-child) {\n          @include border-end-radius(0);\n\n          .card-img-top,\n          .card-header {\n            // stylelint-disable-next-line property-disallowed-list\n            border-top-right-radius: 0;\n          }\n          .card-img-bottom,\n          .card-footer {\n            // stylelint-disable-next-line property-disallowed-list\n            border-bottom-right-radius: 0;\n          }\n        }\n\n        &:not(:first-child) {\n          @include border-start-radius(0);\n\n          .card-img-top,\n          .card-header {\n            // stylelint-disable-next-line property-disallowed-list\n            border-top-left-radius: 0;\n          }\n          .card-img-bottom,\n          .card-footer {\n            // stylelint-disable-next-line property-disallowed-list\n            border-bottom-left-radius: 0;\n          }\n        }\n      }\n    }\n  }\n}\n","//\n// Base styles\n//\n\n.accordion-button {\n  position: relative;\n  display: flex;\n  align-items: center;\n  width: 100%;\n  padding: $accordion-button-padding-y $accordion-button-padding-x;\n  @include font-size($font-size-base);\n  color: $accordion-button-color;\n  text-align: left; // Reset button style\n  background-color: $accordion-button-bg;\n  border: 0;\n  @include border-radius(0);\n  overflow-anchor: none;\n  @include transition($accordion-transition);\n\n  &:not(.collapsed) {\n    color: $accordion-button-active-color;\n    background-color: $accordion-button-active-bg;\n    box-shadow: inset 0 ($accordion-border-width * -1) 0 $accordion-border-color;\n\n    &::after {\n      background-image: escape-svg($accordion-button-active-icon);\n      transform: $accordion-icon-transform;\n    }\n  }\n\n  // Accordion icon\n  &::after {\n    flex-shrink: 0;\n    width: $accordion-icon-width;\n    height: $accordion-icon-width;\n    margin-left: auto;\n    content: \"\";\n    background-image: escape-svg($accordion-button-icon);\n    background-repeat: no-repeat;\n    background-size: $accordion-icon-width;\n    @include transition($accordion-icon-transition);\n  }\n\n  &:hover {\n    z-index: 2;\n  }\n\n  &:focus {\n    z-index: 3;\n    border-color: $accordion-button-focus-border-color;\n    outline: 0;\n    box-shadow: $accordion-button-focus-box-shadow;\n  }\n}\n\n.accordion-header {\n  margin-bottom: 0;\n}\n\n.accordion-item {\n  background-color: $accordion-bg;\n  border: $accordion-border-width solid $accordion-border-color;\n\n  &:first-of-type {\n    @include border-top-radius($accordion-border-radius);\n\n    .accordion-button {\n      @include border-top-radius($accordion-inner-border-radius);\n    }\n  }\n\n  &:not(:first-of-type) {\n    border-top: 0;\n  }\n\n  // Only set a border-radius on the last item if the accordion is collapsed\n  &:last-of-type {\n    @include border-bottom-radius($accordion-border-radius);\n\n    .accordion-button {\n      &.collapsed {\n        @include border-bottom-radius($accordion-inner-border-radius);\n      }\n    }\n\n    .accordion-collapse {\n      @include border-bottom-radius($accordion-border-radius);\n    }\n  }\n}\n\n.accordion-body {\n  padding: $accordion-body-padding-y $accordion-body-padding-x;\n}\n\n\n// Flush accordion items\n//\n// Remove borders and border-radius to keep accordion items edge-to-edge.\n\n.accordion-flush {\n  .accordion-collapse {\n    border-width: 0;\n  }\n\n  .accordion-item {\n    border-right: 0;\n    border-left: 0;\n    @include border-radius(0);\n\n    &:first-child { border-top: 0; }\n    &:last-child { border-bottom: 0; }\n\n    .accordion-button {\n      @include border-radius(0);\n    }\n  }\n}\n",".breadcrumb {\n  display: flex;\n  flex-wrap: wrap;\n  padding: $breadcrumb-padding-y $breadcrumb-padding-x;\n  margin-bottom: $breadcrumb-margin-bottom;\n  @include font-size($breadcrumb-font-size);\n  list-style: none;\n  background-color: $breadcrumb-bg;\n  @include border-radius($breadcrumb-border-radius);\n}\n\n.breadcrumb-item {\n  // The separator between breadcrumbs (by default, a forward-slash: \"/\")\n  + .breadcrumb-item {\n    padding-left: $breadcrumb-item-padding-x;\n\n    &::before {\n      float: left; // Suppress inline spacings and underlining of the separator\n      padding-right: $breadcrumb-item-padding-x;\n      color: $breadcrumb-divider-color;\n      content: var(--#{$variable-prefix}breadcrumb-divider, escape-svg($breadcrumb-divider)) #{\"/* rtl:\"} var(--#{$variable-prefix}breadcrumb-divider, escape-svg($breadcrumb-divider-flipped)) #{\"*/\"};\n    }\n  }\n\n  &.active {\n    color: $breadcrumb-active-color;\n  }\n}\n",".pagination {\n  display: flex;\n  @include list-unstyled();\n}\n\n.page-link {\n  position: relative;\n  display: block;\n  color: $pagination-color;\n  text-decoration: if($link-decoration == none, null, none);\n  background-color: $pagination-bg;\n  border: $pagination-border-width solid $pagination-border-color;\n  @include transition($pagination-transition);\n\n  &:hover {\n    z-index: 2;\n    color: $pagination-hover-color;\n    text-decoration: if($link-hover-decoration == underline, none, null);\n    background-color: $pagination-hover-bg;\n    border-color: $pagination-hover-border-color;\n  }\n\n  &:focus {\n    z-index: 3;\n    color: $pagination-focus-color;\n    background-color: $pagination-focus-bg;\n    outline: $pagination-focus-outline;\n    box-shadow: $pagination-focus-box-shadow;\n  }\n}\n\n.page-item {\n  &:not(:first-child) .page-link {\n    margin-left: $pagination-margin-start;\n  }\n\n  &.active .page-link {\n    z-index: 3;\n    color: $pagination-active-color;\n    @include gradient-bg($pagination-active-bg);\n    border-color: $pagination-active-border-color;\n  }\n\n  &.disabled .page-link {\n    color: $pagination-disabled-color;\n    pointer-events: none;\n    background-color: $pagination-disabled-bg;\n    border-color: $pagination-disabled-border-color;\n  }\n}\n\n\n//\n// Sizing\n//\n@include pagination-size($pagination-padding-y, $pagination-padding-x, null, $pagination-border-radius);\n\n.pagination-lg {\n  @include pagination-size($pagination-padding-y-lg, $pagination-padding-x-lg, $font-size-lg, $pagination-border-radius-lg);\n}\n\n.pagination-sm {\n  @include pagination-size($pagination-padding-y-sm, $pagination-padding-x-sm, $font-size-sm, $pagination-border-radius-sm);\n}\n","// Pagination\n\n// scss-docs-start pagination-mixin\n@mixin pagination-size($padding-y, $padding-x, $font-size, $border-radius) {\n  .page-link {\n    padding: $padding-y $padding-x;\n    @include font-size($font-size);\n  }\n\n  .page-item {\n    @if $pagination-margin-start == (-$pagination-border-width) {\n      &:first-child {\n        .page-link {\n          @include border-start-radius($border-radius);\n        }\n      }\n\n      &:last-child {\n        .page-link {\n          @include border-end-radius($border-radius);\n        }\n      }\n    } @else {\n      //Add border-radius to all pageLinks in case they have left margin\n      .page-link {\n        @include border-radius($border-radius);\n      }\n    }\n  }\n}\n// scss-docs-end pagination-mixin\n","// Base class\n//\n// Requires one of the contextual, color modifier classes for `color` and\n// `background-color`.\n\n.badge {\n  display: inline-block;\n  padding: $badge-padding-y $badge-padding-x;\n  @include font-size($badge-font-size);\n  font-weight: $badge-font-weight;\n  line-height: 1;\n  color: $badge-color;\n  text-align: center;\n  white-space: nowrap;\n  vertical-align: baseline;\n  @include border-radius($badge-border-radius);\n  @include gradient-bg();\n\n  // Empty badges collapse automatically\n  &:empty {\n    display: none;\n  }\n}\n\n// Quick fix for badges in buttons\n.btn .badge {\n  position: relative;\n  top: -1px;\n}\n","//\n// Base styles\n//\n\n.alert {\n  position: relative;\n  padding: $alert-padding-y $alert-padding-x;\n  margin-bottom: $alert-margin-bottom;\n  border: $alert-border-width solid transparent;\n  @include border-radius($alert-border-radius);\n}\n\n// Headings for larger alerts\n.alert-heading {\n  // Specified to prevent conflicts of changing $headings-color\n  color: inherit;\n}\n\n// Provide class for links that match alerts\n.alert-link {\n  font-weight: $alert-link-font-weight;\n}\n\n\n// Dismissible alerts\n//\n// Expand the right padding and account for the close button's positioning.\n\n.alert-dismissible {\n  padding-right: $alert-dismissible-padding-r;\n\n  // Adjust close link position\n  .btn-close {\n    position: absolute;\n    top: 0;\n    right: 0;\n    z-index: $stretched-link-z-index + 1;\n    padding: $alert-padding-y * 1.25 $alert-padding-x;\n  }\n}\n\n\n// scss-docs-start alert-modifiers\n// Generate contextual modifier classes for colorizing the alert.\n\n@each $state, $value in $theme-colors {\n  $alert-background: shift-color($value, $alert-bg-scale);\n  $alert-border: shift-color($value, $alert-border-scale);\n  $alert-color: shift-color($value, $alert-color-scale);\n  @if (contrast-ratio($alert-background, $alert-color) < $min-contrast-ratio) {\n    $alert-color: mix($value, color-contrast($alert-background), abs($alert-color-scale));\n  }\n  .alert-#{$state} {\n    @include alert-variant($alert-background, $alert-border, $alert-color);\n  }\n}\n// scss-docs-end alert-modifiers\n","// scss-docs-start alert-variant-mixin\n@mixin alert-variant($background, $border, $color) {\n  color: $color;\n  @include gradient-bg($background);\n  border-color: $border;\n\n  .alert-link {\n    color: shade-color($color, 20%);\n  }\n}\n// scss-docs-end alert-variant-mixin\n","// Disable animation if transitions are disabled\n\n// scss-docs-start progress-keyframes\n@if $enable-transitions {\n  @keyframes progress-bar-stripes {\n    0% { background-position-x: $progress-height; }\n  }\n}\n// scss-docs-end progress-keyframes\n\n.progress {\n  display: flex;\n  height: $progress-height;\n  overflow: hidden; // force rounded corners by cropping it\n  @include font-size($progress-font-size);\n  background-color: $progress-bg;\n  @include border-radius($progress-border-radius);\n  @include box-shadow($progress-box-shadow);\n}\n\n.progress-bar {\n  display: flex;\n  flex-direction: column;\n  justify-content: center;\n  overflow: hidden;\n  color: $progress-bar-color;\n  text-align: center;\n  white-space: nowrap;\n  background-color: $progress-bar-bg;\n  @include transition($progress-bar-transition);\n}\n\n.progress-bar-striped {\n  @include gradient-striped();\n  background-size: $progress-height $progress-height;\n}\n\n@if $enable-transitions {\n  .progress-bar-animated {\n    animation: $progress-bar-animation-timing progress-bar-stripes;\n\n    @if $enable-reduced-motion {\n      @media (prefers-reduced-motion: reduce) {\n        animation: none;\n      }\n    }\n  }\n}\n","// Base class\n//\n// Easily usable on <ul>, <ol>, or <div>.\n\n.list-group {\n  display: flex;\n  flex-direction: column;\n\n  // No need to set list-style: none; since .list-group-item is block level\n  padding-left: 0; // reset padding because ul and ol\n  margin-bottom: 0;\n  @include border-radius($list-group-border-radius);\n}\n\n.list-group-numbered {\n  list-style-type: none;\n  counter-reset: section;\n\n  > li::before {\n    // Increments only this instance of the section counter\n    content: counters(section, \".\") \". \";\n    counter-increment: section;\n  }\n}\n\n\n// Interactive list items\n//\n// Use anchor or button elements instead of `li`s or `div`s to create interactive\n// list items. Includes an extra `.active` modifier class for selected items.\n\n.list-group-item-action {\n  width: 100%; // For `<button>`s (anchors become 100% by default though)\n  color: $list-group-action-color;\n  text-align: inherit; // For `<button>`s (anchors inherit)\n\n  // Hover state\n  &:hover,\n  &:focus {\n    z-index: 1; // Place hover/focus items above their siblings for proper border styling\n    color: $list-group-action-hover-color;\n    text-decoration: none;\n    background-color: $list-group-hover-bg;\n  }\n\n  &:active {\n    color: $list-group-action-active-color;\n    background-color: $list-group-action-active-bg;\n  }\n}\n\n\n// Individual list items\n//\n// Use on `li`s or `div`s within the `.list-group` parent.\n\n.list-group-item {\n  position: relative;\n  display: block;\n  padding: $list-group-item-padding-y $list-group-item-padding-x;\n  color: $list-group-color;\n  text-decoration: if($link-decoration == none, null, none);\n  background-color: $list-group-bg;\n  border: $list-group-border-width solid $list-group-border-color;\n\n  &:first-child {\n    @include border-top-radius(inherit);\n  }\n\n  &:last-child {\n    @include border-bottom-radius(inherit);\n  }\n\n  &.disabled,\n  &:disabled {\n    color: $list-group-disabled-color;\n    pointer-events: none;\n    background-color: $list-group-disabled-bg;\n  }\n\n  // Include both here for `<a>`s and `<button>`s\n  &.active {\n    z-index: 2; // Place active items above their siblings for proper border styling\n    color: $list-group-active-color;\n    background-color: $list-group-active-bg;\n    border-color: $list-group-active-border-color;\n  }\n\n  & + & {\n    border-top-width: 0;\n\n    &.active {\n      margin-top: -$list-group-border-width;\n      border-top-width: $list-group-border-width;\n    }\n  }\n}\n\n\n// Horizontal\n//\n// Change the layout of list group items from vertical (default) to horizontal.\n\n@each $breakpoint in map-keys($grid-breakpoints) {\n  @include media-breakpoint-up($breakpoint) {\n    $infix: breakpoint-infix($breakpoint, $grid-breakpoints);\n\n    .list-group-horizontal#{$infix} {\n      flex-direction: row;\n\n      > .list-group-item {\n        &:first-child {\n          @include border-bottom-start-radius($list-group-border-radius);\n          @include border-top-end-radius(0);\n        }\n\n        &:last-child {\n          @include border-top-end-radius($list-group-border-radius);\n          @include border-bottom-start-radius(0);\n        }\n\n        &.active {\n          margin-top: 0;\n        }\n\n        + .list-group-item {\n          border-top-width: $list-group-border-width;\n          border-left-width: 0;\n\n          &.active {\n            margin-left: -$list-group-border-width;\n            border-left-width: $list-group-border-width;\n          }\n        }\n      }\n    }\n  }\n}\n\n\n// Flush list items\n//\n// Remove borders and border-radius to keep list group items edge-to-edge. Most\n// useful within other components (e.g., cards).\n\n.list-group-flush {\n  @include border-radius(0);\n\n  > .list-group-item {\n    border-width: 0 0 $list-group-border-width;\n\n    &:last-child {\n      border-bottom-width: 0;\n    }\n  }\n}\n\n\n// scss-docs-start list-group-modifiers\n// List group contextual variants\n//\n// Add modifier classes to change text and background color on individual items.\n// Organizationally, this must come after the `:hover` states.\n\n@each $state, $value in $theme-colors {\n  $list-group-variant-bg: shift-color($value, $list-group-item-bg-scale);\n  $list-group-variant-color: shift-color($value, $list-group-item-color-scale);\n  @if (contrast-ratio($list-group-variant-bg, $list-group-variant-color) < $min-contrast-ratio) {\n    $list-group-variant-color: mix($value, color-contrast($list-group-variant-bg), abs($list-group-item-color-scale));\n  }\n\n  @include list-group-item-variant($state, $list-group-variant-bg, $list-group-variant-color);\n}\n// scss-docs-end list-group-modifiers\n","// List Groups\n\n// scss-docs-start list-group-mixin\n@mixin list-group-item-variant($state, $background, $color) {\n  .list-group-item-#{$state} {\n    color: $color;\n    background-color: $background;\n\n    &.list-group-item-action {\n      &:hover,\n      &:focus {\n        color: $color;\n        background-color: shade-color($background, 10%);\n      }\n\n      &.active {\n        color: $white;\n        background-color: $color;\n        border-color: $color;\n      }\n    }\n  }\n}\n// scss-docs-end list-group-mixin\n","// transparent background and border properties included for button version.\n// iOS requires the button element instead of an anchor tag.\n// If you want the anchor version, it requires `href=\"#\"`.\n// See https://developer.mozilla.org/en-US/docs/Web/Events/click#Safari_Mobile\n\n.btn-close {\n  box-sizing: content-box;\n  width: $btn-close-width;\n  height: $btn-close-height;\n  padding: $btn-close-padding-y $btn-close-padding-x;\n  color: $btn-close-color;\n  background: transparent escape-svg($btn-close-bg) center / $btn-close-width auto no-repeat; // include transparent for button elements\n  border: 0; // for button elements\n  @include border-radius();\n  opacity: $btn-close-opacity;\n\n  // Override <a>'s hover style\n  &:hover {\n    color: $btn-close-color;\n    text-decoration: none;\n    opacity: $btn-close-hover-opacity;\n  }\n\n  &:focus {\n    outline: 0;\n    box-shadow: $btn-close-focus-shadow;\n    opacity: $btn-close-focus-opacity;\n  }\n\n  &:disabled,\n  &.disabled {\n    pointer-events: none;\n    user-select: none;\n    opacity: $btn-close-disabled-opacity;\n  }\n}\n\n.btn-close-white {\n  filter: $btn-close-white-filter;\n}\n",".toast {\n  width: $toast-max-width;\n  max-width: 100%;\n  @include font-size($toast-font-size);\n  color: $toast-color;\n  pointer-events: auto;\n  background-color: $toast-background-color;\n  background-clip: padding-box;\n  border: $toast-border-width solid $toast-border-color;\n  box-shadow: $toast-box-shadow;\n  @include border-radius($toast-border-radius);\n\n  &.showing {\n    opacity: 0;\n  }\n\n  &:not(.show) {\n    display: none;\n  }\n}\n\n.toast-container {\n  width: max-content;\n  max-width: 100%;\n  pointer-events: none;\n\n  > :not(:last-child) {\n    margin-bottom: $toast-spacing;\n  }\n}\n\n.toast-header {\n  display: flex;\n  align-items: center;\n  padding: $toast-padding-y $toast-padding-x;\n  color: $toast-header-color;\n  background-color: $toast-header-background-color;\n  background-clip: padding-box;\n  border-bottom: $toast-border-width solid $toast-header-border-color;\n  @include border-top-radius(subtract($toast-border-radius, $toast-border-width));\n\n  .btn-close {\n    margin-right: $toast-padding-x * -.5;\n    margin-left: $toast-padding-x;\n  }\n}\n\n.toast-body {\n  padding: $toast-padding-x; // apply to both vertical and horizontal\n  word-wrap: break-word;\n}\n","// .modal-open      - body class for killing the scroll\n// .modal           - container to scroll within\n// .modal-dialog    - positioning shell for the actual modal\n// .modal-content   - actual modal w/ bg and corners and stuff\n\n\n// Container that the modal scrolls within\n.modal {\n  position: fixed;\n  top: 0;\n  left: 0;\n  z-index: $zindex-modal;\n  display: none;\n  width: 100%;\n  height: 100%;\n  overflow-x: hidden;\n  overflow-y: auto;\n  // Prevent Chrome on Windows from adding a focus outline. For details, see\n  // https://github.com/twbs/bootstrap/pull/10951.\n  outline: 0;\n  // We deliberately don't use `-webkit-overflow-scrolling: touch;` due to a\n  // gnarly iOS Safari bug: https://bugs.webkit.org/show_bug.cgi?id=158342\n  // See also https://github.com/twbs/bootstrap/issues/17695\n}\n\n// Shell div to position the modal with bottom padding\n.modal-dialog {\n  position: relative;\n  width: auto;\n  margin: $modal-dialog-margin;\n  // allow clicks to pass through for custom click handling to close modal\n  pointer-events: none;\n\n  // When fading in the modal, animate it to slide down\n  .modal.fade & {\n    @include transition($modal-transition);\n    transform: $modal-fade-transform;\n  }\n  .modal.show & {\n    transform: $modal-show-transform;\n  }\n\n  // When trying to close, animate focus to scale\n  .modal.modal-static & {\n    transform: $modal-scale-transform;\n  }\n}\n\n.modal-dialog-scrollable {\n  height: subtract(100%, $modal-dialog-margin * 2);\n\n  .modal-content {\n    max-height: 100%;\n    overflow: hidden;\n  }\n\n  .modal-body {\n    overflow-y: auto;\n  }\n}\n\n.modal-dialog-centered {\n  display: flex;\n  align-items: center;\n  min-height: subtract(100%, $modal-dialog-margin * 2);\n}\n\n// Actual modal\n.modal-content {\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  width: 100%; // Ensure `.modal-content` extends the full width of the parent `.modal-dialog`\n  // counteract the pointer-events: none; in the .modal-dialog\n  color: $modal-content-color;\n  pointer-events: auto;\n  background-color: $modal-content-bg;\n  background-clip: padding-box;\n  border: $modal-content-border-width solid $modal-content-border-color;\n  @include border-radius($modal-content-border-radius);\n  @include box-shadow($modal-content-box-shadow-xs);\n  // Remove focus outline from opened modal\n  outline: 0;\n}\n\n// Modal background\n.modal-backdrop {\n  @include overlay-backdrop($zindex-modal-backdrop, $modal-backdrop-bg, $modal-backdrop-opacity);\n}\n\n// Modal header\n// Top section of the modal w/ title and dismiss\n.modal-header {\n  display: flex;\n  flex-shrink: 0;\n  align-items: center;\n  justify-content: space-between; // Put modal header elements (title and dismiss) on opposite ends\n  padding: $modal-header-padding;\n  border-bottom: $modal-header-border-width solid $modal-header-border-color;\n  @include border-top-radius($modal-content-inner-border-radius);\n\n  .btn-close {\n    padding: ($modal-header-padding-y * .5) ($modal-header-padding-x * .5);\n    margin: ($modal-header-padding-y * -.5) ($modal-header-padding-x * -.5) ($modal-header-padding-y * -.5) auto;\n  }\n}\n\n// Title text within header\n.modal-title {\n  margin-bottom: 0;\n  line-height: $modal-title-line-height;\n}\n\n// Modal body\n// Where all modal content resides (sibling of .modal-header and .modal-footer)\n.modal-body {\n  position: relative;\n  // Enable `flex-grow: 1` so that the body take up as much space as possible\n  // when there should be a fixed height on `.modal-dialog`.\n  flex: 1 1 auto;\n  padding: $modal-inner-padding;\n}\n\n// Footer (for actions)\n.modal-footer {\n  display: flex;\n  flex-wrap: wrap;\n  flex-shrink: 0;\n  align-items: center; // vertically center\n  justify-content: flex-end; // Right align buttons with flex property because text-align doesn't work on flex items\n  padding: $modal-inner-padding - $modal-footer-margin-between * .5;\n  border-top: $modal-footer-border-width solid $modal-footer-border-color;\n  @include border-bottom-radius($modal-content-inner-border-radius);\n\n  // Place margin between footer elements\n  // This solution is far from ideal because of the universal selector usage,\n  // but is needed to fix https://github.com/twbs/bootstrap/issues/24800\n  > * {\n    margin: $modal-footer-margin-between * .5;\n  }\n}\n\n// Scale up the modal\n@include media-breakpoint-up(sm) {\n  // Automatically set modal's width for larger viewports\n  .modal-dialog {\n    max-width: $modal-md;\n    margin: $modal-dialog-margin-y-sm-up auto;\n  }\n\n  .modal-dialog-scrollable {\n    height: subtract(100%, $modal-dialog-margin-y-sm-up * 2);\n  }\n\n  .modal-dialog-centered {\n    min-height: subtract(100%, $modal-dialog-margin-y-sm-up * 2);\n  }\n\n  .modal-content {\n    @include box-shadow($modal-content-box-shadow-sm-up);\n  }\n\n  .modal-sm { max-width: $modal-sm; }\n}\n\n@include media-breakpoint-up(lg) {\n  .modal-lg,\n  .modal-xl {\n    max-width: $modal-lg;\n  }\n}\n\n@include media-breakpoint-up(xl) {\n  .modal-xl { max-width: $modal-xl; }\n}\n\n// scss-docs-start modal-fullscreen-loop\n@each $breakpoint in map-keys($grid-breakpoints) {\n  $infix: breakpoint-infix($breakpoint, $grid-breakpoints);\n  $postfix: if($infix != \"\", $infix + \"-down\", \"\");\n\n  @include media-breakpoint-down($breakpoint) {\n    .modal-fullscreen#{$postfix} {\n      width: 100vw;\n      max-width: none;\n      height: 100%;\n      margin: 0;\n\n      .modal-content {\n        height: 100%;\n        border: 0;\n        @include border-radius(0);\n      }\n\n      .modal-header {\n        @include border-radius(0);\n      }\n\n      .modal-body {\n        overflow-y: auto;\n      }\n\n      .modal-footer {\n        @include border-radius(0);\n      }\n    }\n  }\n}\n// scss-docs-end modal-fullscreen-loop\n","// Shared between modals and offcanvases\n@mixin overlay-backdrop($zindex, $backdrop-bg, $backdrop-opacity) {\n  position: fixed;\n  top: 0;\n  left: 0;\n  z-index: $zindex;\n  width: 100vw;\n  height: 100vh;\n  background-color: $backdrop-bg;\n\n  // Fade for backdrop\n  &.fade { opacity: 0; }\n  &.show { opacity: $backdrop-opacity; }\n}\n","// Base class\n.tooltip {\n  position: absolute;\n  z-index: $zindex-tooltip;\n  display: block;\n  margin: $tooltip-margin;\n  // Our parent element can be arbitrary since tooltips are by default inserted as a sibling of their target element.\n  // So reset our font and text properties to avoid inheriting weird values.\n  @include reset-text();\n  @include font-size($tooltip-font-size);\n  // Allow breaking very long words so they don't overflow the tooltip's bounds\n  word-wrap: break-word;\n  opacity: 0;\n\n  &.show { opacity: $tooltip-opacity; }\n\n  .tooltip-arrow {\n    position: absolute;\n    display: block;\n    width: $tooltip-arrow-width;\n    height: $tooltip-arrow-height;\n\n    &::before {\n      position: absolute;\n      content: \"\";\n      border-color: transparent;\n      border-style: solid;\n    }\n  }\n}\n\n.bs-tooltip-top {\n  padding: $tooltip-arrow-height 0;\n\n  .tooltip-arrow {\n    bottom: 0;\n\n    &::before {\n      top: -1px;\n      border-width: $tooltip-arrow-height ($tooltip-arrow-width * .5) 0;\n      border-top-color: $tooltip-arrow-color;\n    }\n  }\n}\n\n.bs-tooltip-end {\n  padding: 0 $tooltip-arrow-height;\n\n  .tooltip-arrow {\n    left: 0;\n    width: $tooltip-arrow-height;\n    height: $tooltip-arrow-width;\n\n    &::before {\n      right: -1px;\n      border-width: ($tooltip-arrow-width * .5) $tooltip-arrow-height ($tooltip-arrow-width * .5) 0;\n      border-right-color: $tooltip-arrow-color;\n    }\n  }\n}\n\n.bs-tooltip-bottom {\n  padding: $tooltip-arrow-height 0;\n\n  .tooltip-arrow {\n    top: 0;\n\n    &::before {\n      bottom: -1px;\n      border-width: 0 ($tooltip-arrow-width * .5) $tooltip-arrow-height;\n      border-bottom-color: $tooltip-arrow-color;\n    }\n  }\n}\n\n.bs-tooltip-start {\n  padding: 0 $tooltip-arrow-height;\n\n  .tooltip-arrow {\n    right: 0;\n    width: $tooltip-arrow-height;\n    height: $tooltip-arrow-width;\n\n    &::before {\n      left: -1px;\n      border-width: ($tooltip-arrow-width * .5) 0 ($tooltip-arrow-width * .5) $tooltip-arrow-height;\n      border-left-color: $tooltip-arrow-color;\n    }\n  }\n}\n\n.bs-tooltip-auto {\n  &[data-popper-placement^=\"top\"] {\n    @extend .bs-tooltip-top;\n  }\n  &[data-popper-placement^=\"right\"] {\n    @extend .bs-tooltip-end;\n  }\n  &[data-popper-placement^=\"bottom\"] {\n    @extend .bs-tooltip-bottom;\n  }\n  &[data-popper-placement^=\"left\"] {\n    @extend .bs-tooltip-start;\n  }\n}\n\n// Wrapper for the tooltip content\n.tooltip-inner {\n  max-width: $tooltip-max-width;\n  padding: $tooltip-padding-y $tooltip-padding-x;\n  color: $tooltip-color;\n  text-align: center;\n  background-color: $tooltip-bg;\n  @include border-radius($tooltip-border-radius);\n}\n","@mixin reset-text {\n  font-family: $font-family-base;\n  // We deliberately do NOT reset font-size or overflow-wrap / word-wrap.\n  font-style: normal;\n  font-weight: $font-weight-normal;\n  line-height: $line-height-base;\n  text-align: left; // Fallback for where `start` is not supported\n  text-align: start;\n  text-decoration: none;\n  text-shadow: none;\n  text-transform: none;\n  letter-spacing: normal;\n  word-break: normal;\n  word-spacing: normal;\n  white-space: normal;\n  line-break: auto;\n}\n",".popover {\n  position: absolute;\n  top: 0;\n  left: 0 #{\"/* rtl:ignore */\"};\n  z-index: $zindex-popover;\n  display: block;\n  max-width: $popover-max-width;\n  // Our parent element can be arbitrary since tooltips are by default inserted as a sibling of their target element.\n  // So reset our font and text properties to avoid inheriting weird values.\n  @include reset-text();\n  @include font-size($popover-font-size);\n  // Allow breaking very long words so they don't overflow the popover's bounds\n  word-wrap: break-word;\n  background-color: $popover-bg;\n  background-clip: padding-box;\n  border: $popover-border-width solid $popover-border-color;\n  @include border-radius($popover-border-radius);\n  @include box-shadow($popover-box-shadow);\n\n  .popover-arrow {\n    position: absolute;\n    display: block;\n    width: $popover-arrow-width;\n    height: $popover-arrow-height;\n\n    &::before,\n    &::after {\n      position: absolute;\n      display: block;\n      content: \"\";\n      border-color: transparent;\n      border-style: solid;\n    }\n  }\n}\n\n.bs-popover-top {\n  > .popover-arrow {\n    bottom: subtract(-$popover-arrow-height, $popover-border-width);\n\n    &::before {\n      bottom: 0;\n      border-width: $popover-arrow-height ($popover-arrow-width * .5) 0;\n      border-top-color: $popover-arrow-outer-color;\n    }\n\n    &::after {\n      bottom: $popover-border-width;\n      border-width: $popover-arrow-height ($popover-arrow-width * .5) 0;\n      border-top-color: $popover-arrow-color;\n    }\n  }\n}\n\n.bs-popover-end {\n  > .popover-arrow {\n    left: subtract(-$popover-arrow-height, $popover-border-width);\n    width: $popover-arrow-height;\n    height: $popover-arrow-width;\n\n    &::before {\n      left: 0;\n      border-width: ($popover-arrow-width * .5) $popover-arrow-height ($popover-arrow-width * .5) 0;\n      border-right-color: $popover-arrow-outer-color;\n    }\n\n    &::after {\n      left: $popover-border-width;\n      border-width: ($popover-arrow-width * .5) $popover-arrow-height ($popover-arrow-width * .5) 0;\n      border-right-color: $popover-arrow-color;\n    }\n  }\n}\n\n.bs-popover-bottom {\n  > .popover-arrow {\n    top: subtract(-$popover-arrow-height, $popover-border-width);\n\n    &::before {\n      top: 0;\n      border-width: 0 ($popover-arrow-width * .5) $popover-arrow-height ($popover-arrow-width * .5);\n      border-bottom-color: $popover-arrow-outer-color;\n    }\n\n    &::after {\n      top: $popover-border-width;\n      border-width: 0 ($popover-arrow-width * .5) $popover-arrow-height ($popover-arrow-width * .5);\n      border-bottom-color: $popover-arrow-color;\n    }\n  }\n\n  // This will remove the popover-header's border just below the arrow\n  .popover-header::before {\n    position: absolute;\n    top: 0;\n    left: 50%;\n    display: block;\n    width: $popover-arrow-width;\n    margin-left: -$popover-arrow-width * .5;\n    content: \"\";\n    border-bottom: $popover-border-width solid $popover-header-bg;\n  }\n}\n\n.bs-popover-start {\n  > .popover-arrow {\n    right: subtract(-$popover-arrow-height, $popover-border-width);\n    width: $popover-arrow-height;\n    height: $popover-arrow-width;\n\n    &::before {\n      right: 0;\n      border-width: ($popover-arrow-width * .5) 0 ($popover-arrow-width * .5) $popover-arrow-height;\n      border-left-color: $popover-arrow-outer-color;\n    }\n\n    &::after {\n      right: $popover-border-width;\n      border-width: ($popover-arrow-width * .5) 0 ($popover-arrow-width * .5) $popover-arrow-height;\n      border-left-color: $popover-arrow-color;\n    }\n  }\n}\n\n.bs-popover-auto {\n  &[data-popper-placement^=\"top\"] {\n    @extend .bs-popover-top;\n  }\n  &[data-popper-placement^=\"right\"] {\n    @extend .bs-popover-end;\n  }\n  &[data-popper-placement^=\"bottom\"] {\n    @extend .bs-popover-bottom;\n  }\n  &[data-popper-placement^=\"left\"] {\n    @extend .bs-popover-start;\n  }\n}\n\n// Offset the popover to account for the popover arrow\n.popover-header {\n  padding: $popover-header-padding-y $popover-header-padding-x;\n  margin-bottom: 0; // Reset the default from Reboot\n  @include font-size($font-size-base);\n  color: $popover-header-color;\n  background-color: $popover-header-bg;\n  border-bottom: $popover-border-width solid $popover-border-color;\n  @include border-top-radius($popover-inner-border-radius);\n\n  &:empty {\n    display: none;\n  }\n}\n\n.popover-body {\n  padding: $popover-body-padding-y $popover-body-padding-x;\n  color: $popover-body-color;\n}\n","// Notes on the classes:\n//\n// 1. .carousel.pointer-event should ideally be pan-y (to allow for users to scroll vertically)\n//    even when their scroll action started on a carousel, but for compatibility (with Firefox)\n//    we're preventing all actions instead\n// 2. The .carousel-item-start and .carousel-item-end is used to indicate where\n//    the active slide is heading.\n// 3. .active.carousel-item is the current slide.\n// 4. .active.carousel-item-start and .active.carousel-item-end is the current\n//    slide in its in-transition state. Only one of these occurs at a time.\n// 5. .carousel-item-next.carousel-item-start and .carousel-item-prev.carousel-item-end\n//    is the upcoming slide in transition.\n\n.carousel {\n  position: relative;\n}\n\n.carousel.pointer-event {\n  touch-action: pan-y;\n}\n\n.carousel-inner {\n  position: relative;\n  width: 100%;\n  overflow: hidden;\n  @include clearfix();\n}\n\n.carousel-item {\n  position: relative;\n  display: none;\n  float: left;\n  width: 100%;\n  margin-right: -100%;\n  backface-visibility: hidden;\n  @include transition($carousel-transition);\n}\n\n.carousel-item.active,\n.carousel-item-next,\n.carousel-item-prev {\n  display: block;\n}\n\n/* rtl:begin:ignore */\n.carousel-item-next:not(.carousel-item-start),\n.active.carousel-item-end {\n  transform: translateX(100%);\n}\n\n.carousel-item-prev:not(.carousel-item-end),\n.active.carousel-item-start {\n  transform: translateX(-100%);\n}\n\n/* rtl:end:ignore */\n\n\n//\n// Alternate transitions\n//\n\n.carousel-fade {\n  .carousel-item {\n    opacity: 0;\n    transition-property: opacity;\n    transform: none;\n  }\n\n  .carousel-item.active,\n  .carousel-item-next.carousel-item-start,\n  .carousel-item-prev.carousel-item-end {\n    z-index: 1;\n    opacity: 1;\n  }\n\n  .active.carousel-item-start,\n  .active.carousel-item-end {\n    z-index: 0;\n    opacity: 0;\n    @include transition(opacity 0s $carousel-transition-duration);\n  }\n}\n\n\n//\n// Left/right controls for nav\n//\n\n.carousel-control-prev,\n.carousel-control-next {\n  position: absolute;\n  top: 0;\n  bottom: 0;\n  z-index: 1;\n  // Use flex for alignment (1-3)\n  display: flex; // 1. allow flex styles\n  align-items: center; // 2. vertically center contents\n  justify-content: center; // 3. horizontally center contents\n  width: $carousel-control-width;\n  padding: 0;\n  color: $carousel-control-color;\n  text-align: center;\n  background: none;\n  border: 0;\n  opacity: $carousel-control-opacity;\n  @include transition($carousel-control-transition);\n\n  // Hover/focus state\n  &:hover,\n  &:focus {\n    color: $carousel-control-color;\n    text-decoration: none;\n    outline: 0;\n    opacity: $carousel-control-hover-opacity;\n  }\n}\n.carousel-control-prev {\n  left: 0;\n  background-image: if($enable-gradients, linear-gradient(90deg, rgba($black, .25), rgba($black, .001)), null);\n}\n.carousel-control-next {\n  right: 0;\n  background-image: if($enable-gradients, linear-gradient(270deg, rgba($black, .25), rgba($black, .001)), null);\n}\n\n// Icons for within\n.carousel-control-prev-icon,\n.carousel-control-next-icon {\n  display: inline-block;\n  width: $carousel-control-icon-width;\n  height: $carousel-control-icon-width;\n  background-repeat: no-repeat;\n  background-position: 50%;\n  background-size: 100% 100%;\n}\n\n/* rtl:options: {\n  \"autoRename\": true,\n  \"stringMap\":[ {\n    \"name\"    : \"prev-next\",\n    \"search\"  : \"prev\",\n    \"replace\" : \"next\"\n  } ]\n} */\n.carousel-control-prev-icon {\n  background-image: escape-svg($carousel-control-prev-icon-bg);\n}\n.carousel-control-next-icon {\n  background-image: escape-svg($carousel-control-next-icon-bg);\n}\n\n// Optional indicator pips/controls\n//\n// Add a container (such as a list) with the following class and add an item (ideally a focusable control,\n// like a button) with data-bs-target for each slide your carousel holds.\n\n.carousel-indicators {\n  position: absolute;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  z-index: 2;\n  display: flex;\n  justify-content: center;\n  padding: 0;\n  // Use the .carousel-control's width as margin so we don't overlay those\n  margin-right: $carousel-control-width;\n  margin-bottom: 1rem;\n  margin-left: $carousel-control-width;\n  list-style: none;\n\n  [data-bs-target] {\n    box-sizing: content-box;\n    flex: 0 1 auto;\n    width: $carousel-indicator-width;\n    height: $carousel-indicator-height;\n    padding: 0;\n    margin-right: $carousel-indicator-spacer;\n    margin-left: $carousel-indicator-spacer;\n    text-indent: -999px;\n    cursor: pointer;\n    background-color: $carousel-indicator-active-bg;\n    background-clip: padding-box;\n    border: 0;\n    // Use transparent borders to increase the hit area by 10px on top and bottom.\n    border-top: $carousel-indicator-hit-area-height solid transparent;\n    border-bottom: $carousel-indicator-hit-area-height solid transparent;\n    opacity: $carousel-indicator-opacity;\n    @include transition($carousel-indicator-transition);\n  }\n\n  .active {\n    opacity: $carousel-indicator-active-opacity;\n  }\n}\n\n\n// Optional captions\n//\n//\n\n.carousel-caption {\n  position: absolute;\n  right: (100% - $carousel-caption-width) * .5;\n  bottom: $carousel-caption-spacer;\n  left: (100% - $carousel-caption-width) * .5;\n  padding-top: $carousel-caption-padding-y;\n  padding-bottom: $carousel-caption-padding-y;\n  color: $carousel-caption-color;\n  text-align: center;\n}\n\n// Dark mode carousel\n\n.carousel-dark {\n  .carousel-control-prev-icon,\n  .carousel-control-next-icon {\n    filter: $carousel-dark-control-icon-filter;\n  }\n\n  .carousel-indicators [data-bs-target] {\n    background-color: $carousel-dark-indicator-active-bg;\n  }\n\n  .carousel-caption {\n    color: $carousel-dark-caption-color;\n  }\n}\n","// scss-docs-start clearfix\n@mixin clearfix() {\n  &::after {\n    display: block;\n    clear: both;\n    content: \"\";\n  }\n}\n// scss-docs-end clearfix\n","//\n// Rotating border\n//\n\n// scss-docs-start spinner-border-keyframes\n@keyframes spinner-border {\n  to { transform: rotate(360deg) #{\"/* rtl:ignore */\"}; }\n}\n// scss-docs-end spinner-border-keyframes\n\n.spinner-border {\n  display: inline-block;\n  width: $spinner-width;\n  height: $spinner-height;\n  vertical-align: $spinner-vertical-align;\n  border: $spinner-border-width solid currentColor;\n  border-right-color: transparent;\n  // stylelint-disable-next-line property-disallowed-list\n  border-radius: 50%;\n  animation: $spinner-animation-speed linear infinite spinner-border;\n}\n\n.spinner-border-sm {\n  width: $spinner-width-sm;\n  height: $spinner-height-sm;\n  border-width: $spinner-border-width-sm;\n}\n\n//\n// Growing circle\n//\n\n// scss-docs-start spinner-grow-keyframes\n@keyframes spinner-grow {\n  0% {\n    transform: scale(0);\n  }\n  50% {\n    opacity: 1;\n    transform: none;\n  }\n}\n// scss-docs-end spinner-grow-keyframes\n\n.spinner-grow {\n  display: inline-block;\n  width: $spinner-width;\n  height: $spinner-height;\n  vertical-align: $spinner-vertical-align;\n  background-color: currentColor;\n  // stylelint-disable-next-line property-disallowed-list\n  border-radius: 50%;\n  opacity: 0;\n  animation: $spinner-animation-speed linear infinite spinner-grow;\n}\n\n.spinner-grow-sm {\n  width: $spinner-width-sm;\n  height: $spinner-height-sm;\n}\n\n@if $enable-reduced-motion {\n  @media (prefers-reduced-motion: reduce) {\n    .spinner-border,\n    .spinner-grow {\n      animation-duration: $spinner-animation-speed * 2;\n    }\n  }\n}\n",".offcanvas {\n  position: fixed;\n  bottom: 0;\n  z-index: $zindex-offcanvas;\n  display: flex;\n  flex-direction: column;\n  max-width: 100%;\n  color: $offcanvas-color;\n  visibility: hidden;\n  background-color: $offcanvas-bg-color;\n  background-clip: padding-box;\n  outline: 0;\n  @include box-shadow($offcanvas-box-shadow);\n  @include transition(transform $offcanvas-transition-duration ease-in-out);\n}\n\n.offcanvas-backdrop {\n  @include overlay-backdrop($zindex-offcanvas-backdrop, $offcanvas-backdrop-bg, $offcanvas-backdrop-opacity);\n}\n\n.offcanvas-header {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  padding: $offcanvas-padding-y $offcanvas-padding-x;\n\n  .btn-close {\n    padding: ($offcanvas-padding-y * .5) ($offcanvas-padding-x * .5);\n    margin-top: $offcanvas-padding-y * -.5;\n    margin-right: $offcanvas-padding-x * -.5;\n    margin-bottom: $offcanvas-padding-y * -.5;\n  }\n}\n\n.offcanvas-title {\n  margin-bottom: 0;\n  line-height: $offcanvas-title-line-height;\n}\n\n.offcanvas-body {\n  flex-grow: 1;\n  padding: $offcanvas-padding-y $offcanvas-padding-x;\n  overflow-y: auto;\n}\n\n.offcanvas-start {\n  top: 0;\n  left: 0;\n  width: $offcanvas-horizontal-width;\n  border-right: $offcanvas-border-width solid $offcanvas-border-color;\n  transform: translateX(-100%);\n}\n\n.offcanvas-end {\n  top: 0;\n  right: 0;\n  width: $offcanvas-horizontal-width;\n  border-left: $offcanvas-border-width solid $offcanvas-border-color;\n  transform: translateX(100%);\n}\n\n.offcanvas-top {\n  top: 0;\n  right: 0;\n  left: 0;\n  height: $offcanvas-vertical-height;\n  max-height: 100%;\n  border-bottom: $offcanvas-border-width solid $offcanvas-border-color;\n  transform: translateY(-100%);\n}\n\n.offcanvas-bottom {\n  right: 0;\n  left: 0;\n  height: $offcanvas-vertical-height;\n  max-height: 100%;\n  border-top: $offcanvas-border-width solid $offcanvas-border-color;\n  transform: translateY(100%);\n}\n\n.offcanvas.show {\n  transform: none;\n}\n",".placeholder {\n  display: inline-block;\n  min-height: 1em;\n  vertical-align: middle;\n  cursor: wait;\n  background-color: currentColor;\n  opacity: $placeholder-opacity-max;\n\n  &.btn::before {\n    display: inline-block;\n    content: \"\";\n  }\n}\n\n// Sizing\n.placeholder-xs {\n  min-height: .6em;\n}\n\n.placeholder-sm {\n  min-height: .8em;\n}\n\n.placeholder-lg {\n  min-height: 1.2em;\n}\n\n// Animation\n.placeholder-glow {\n  .placeholder {\n    animation: placeholder-glow 2s ease-in-out infinite;\n  }\n}\n\n@keyframes placeholder-glow {\n  50% {\n    opacity: $placeholder-opacity-min;\n  }\n}\n\n.placeholder-wave {\n  mask-image: linear-gradient(130deg, $black 55%, rgba(0, 0, 0, (1 - $placeholder-opacity-min)) 75%, $black 95%);\n  mask-size: 200% 100%;\n  animation: placeholder-wave 2s linear infinite;\n}\n\n@keyframes placeholder-wave {\n  100% {\n    mask-position: -200% 0%;\n  }\n}\n","@each $color, $value in $theme-colors {\n  .link-#{$color} {\n    color: $value;\n\n    @if $link-shade-percentage != 0 {\n      &:hover,\n      &:focus {\n        color: if(color-contrast($value) == $color-contrast-light, shade-color($value, $link-shade-percentage), tint-color($value, $link-shade-percentage));\n      }\n    }\n  }\n}\n","// Credit: Nicolas Gallagher and SUIT CSS.\n\n.ratio {\n  position: relative;\n  width: 100%;\n\n  &::before {\n    display: block;\n    padding-top: var(--#{$variable-prefix}aspect-ratio);\n    content: \"\";\n  }\n\n  > * {\n    position: absolute;\n    top: 0;\n    left: 0;\n    width: 100%;\n    height: 100%;\n  }\n}\n\n@each $key, $ratio in $aspect-ratios {\n  .ratio-#{$key} {\n    --#{$variable-prefix}aspect-ratio: #{$ratio};\n  }\n}\n","// Shorthand\n\n.fixed-top {\n  position: fixed;\n  top: 0;\n  right: 0;\n  left: 0;\n  z-index: $zindex-fixed;\n}\n\n.fixed-bottom {\n  position: fixed;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  z-index: $zindex-fixed;\n}\n\n// Responsive sticky top\n@each $breakpoint in map-keys($grid-breakpoints) {\n  @include media-breakpoint-up($breakpoint) {\n    $infix: breakpoint-infix($breakpoint, $grid-breakpoints);\n\n    .sticky#{$infix}-top {\n      position: sticky;\n      top: 0;\n      z-index: $zindex-sticky;\n    }\n  }\n}\n","// scss-docs-start stacks\n.hstack {\n  display: flex;\n  flex-direction: row;\n  align-items: center;\n  align-self: stretch;\n}\n\n.vstack {\n  display: flex;\n  flex: 1 1 auto;\n  flex-direction: column;\n  align-self: stretch;\n}\n// scss-docs-end stacks\n","//\n// Visually hidden\n//\n\n.visually-hidden,\n.visually-hidden-focusable:not(:focus):not(:focus-within) {\n  @include visually-hidden();\n}\n","// stylelint-disable declaration-no-important\n\n// Hide content visually while keeping it accessible to assistive technologies\n//\n// See: https://www.a11yproject.com/posts/2013-01-11-how-to-hide-content/\n// See: https://hugogiraudel.com/2016/10/13/css-hide-and-seek/\n\n@mixin visually-hidden() {\n  position: absolute !important;\n  width: 1px !important;\n  height: 1px !important;\n  padding: 0 !important;\n  margin: -1px !important; // Fix for https://github.com/twbs/bootstrap/issues/25686\n  overflow: hidden !important;\n  clip: rect(0, 0, 0, 0) !important;\n  white-space: nowrap !important;\n  border: 0 !important;\n}\n\n// Use to only display content when it's focused, or one of its child elements is focused\n// (i.e. when focus is within the element/container that the class was applied to)\n//\n// Useful for \"Skip to main content\" links; see https://www.w3.org/TR/2013/NOTE-WCAG20-TECHS-20130905/G1\n\n@mixin visually-hidden-focusable() {\n  &:not(:focus):not(:focus-within) {\n    @include visually-hidden();\n  }\n}\n","//\n// Stretched link\n//\n\n.stretched-link {\n  &::#{$stretched-link-pseudo-element} {\n    position: absolute;\n    top: 0;\n    right: 0;\n    bottom: 0;\n    left: 0;\n    z-index: $stretched-link-z-index;\n    content: \"\";\n  }\n}\n","//\n// Text truncation\n//\n\n.text-truncate {\n  @include text-truncate();\n}\n","// Text truncate\n// Requires inline-block or block for proper styling\n\n@mixin text-truncate() {\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n",".vr {\n  display: inline-block;\n  align-self: stretch;\n  width: 1px;\n  min-height: 1em;\n  background-color: currentColor;\n  opacity: $hr-opacity;\n}\n","// Utility generator\n// Used to generate utilities & print utilities\n@mixin generate-utility($utility, $infix, $is-rfs-media-query: false) {\n  $values: map-get($utility, values);\n\n  // If the values are a list or string, convert it into a map\n  @if type-of($values) == \"string\" or type-of(nth($values, 1)) != \"list\" {\n    $values: zip($values, $values);\n  }\n\n  @each $key, $value in $values {\n    $properties: map-get($utility, property);\n\n    // Multiple properties are possible, for example with vertical or horizontal margins or paddings\n    @if type-of($properties) == \"string\" {\n      $properties: append((), $properties);\n    }\n\n    // Use custom class if present\n    $property-class: if(map-has-key($utility, class), map-get($utility, class), nth($properties, 1));\n    $property-class: if($property-class == null, \"\", $property-class);\n\n    // State params to generate pseudo-classes\n    $state: if(map-has-key($utility, state), map-get($utility, state), ());\n\n    $infix: if($property-class == \"\" and str-slice($infix, 1, 1) == \"-\", str-slice($infix, 2), $infix);\n\n    // Don't prefix if value key is null (eg. with shadow class)\n    $property-class-modifier: if($key, if($property-class == \"\" and $infix == \"\", \"\", \"-\") + $key, \"\");\n\n    @if map-get($utility, rfs) {\n      // Inside the media query\n      @if $is-rfs-media-query {\n        $val: rfs-value($value);\n\n        // Do not render anything if fluid and non fluid values are the same\n        $value: if($val == rfs-fluid-value($value), null, $val);\n      }\n      @else {\n        $value: rfs-fluid-value($value);\n      }\n    }\n\n    $is-css-var: map-get($utility, css-var);\n    $is-local-vars: map-get($utility, local-vars);\n    $is-rtl: map-get($utility, rtl);\n\n    @if $value != null {\n      @if $is-rtl == false {\n        /* rtl:begin:remove */\n      }\n\n      @if $is-css-var {\n        .#{$property-class + $infix + $property-class-modifier} {\n          --#{$variable-prefix}#{$property-class}: #{$value};\n        }\n\n        @each $pseudo in $state {\n          .#{$property-class + $infix + $property-class-modifier}-#{$pseudo}:#{$pseudo} {\n            --#{$variable-prefix}#{$property-class}: #{$value};\n          }\n        }\n      } @else {\n        .#{$property-class + $infix + $property-class-modifier} {\n          @each $property in $properties {\n            @if $is-local-vars {\n              @each $local-var, $value in $is-local-vars {\n                --#{$variable-prefix}#{$local-var}: #{$value};\n              }\n            }\n            #{$property}: $value if($enable-important-utilities, !important, null);\n          }\n        }\n\n        @each $pseudo in $state {\n          .#{$property-class + $infix + $property-class-modifier}-#{$pseudo}:#{$pseudo} {\n            @each $property in $properties {\n              #{$property}: $value if($enable-important-utilities, !important, null);\n            }\n          }\n        }\n      }\n\n      @if $is-rtl == false {\n        /* rtl:end:remove */\n      }\n    }\n  }\n}\n","// Loop over each breakpoint\n@each $breakpoint in map-keys($grid-breakpoints) {\n\n  // Generate media query if needed\n  @include media-breakpoint-up($breakpoint) {\n    $infix: breakpoint-infix($breakpoint, $grid-breakpoints);\n\n    // Loop over each utility property\n    @each $key, $utility in $utilities {\n      // The utility can be disabled with `false`, thus check if the utility is a map first\n      // Only proceed if responsive media queries are enabled or if it's the base media query\n      @if type-of($utility) == \"map\" and (map-get($utility, responsive) or $infix == \"\") {\n        @include generate-utility($utility, $infix);\n      }\n    }\n  }\n}\n\n// RFS rescaling\n@media (min-width: $rfs-mq-value) {\n  @each $breakpoint in map-keys($grid-breakpoints) {\n    $infix: breakpoint-infix($breakpoint, $grid-breakpoints);\n\n    @if (map-get($grid-breakpoints, $breakpoint) < $rfs-breakpoint) {\n      // Loop over each utility property\n      @each $key, $utility in $utilities {\n        // The utility can be disabled with `false`, thus check if the utility is a map first\n        // Only proceed if responsive media queries are enabled or if it's the base media query\n        @if type-of($utility) == \"map\" and map-get($utility, rfs) and (map-get($utility, responsive) or $infix == \"\") {\n          @include generate-utility($utility, $infix, true);\n        }\n      }\n    }\n  }\n}\n\n\n// Print utilities\n@media print {\n  @each $key, $utility in $utilities {\n    // The utility can be disabled with `false`, thus check if the utility is a map first\n    // Then check if the utility needs print styles\n    @if type-of($utility) == \"map\" and map-get($utility, print) == true {\n      @include generate-utility($utility, \"-print\");\n    }\n  }\n}\n"]}
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/FONT-LICENSE b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/FONT-LICENSE
new file mode 100644
index 0000000000..a1dc03f35c
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/FONT-LICENSE
@@ -0,0 +1,86 @@
+SIL OPEN FONT LICENSE Version 1.1
+
+Copyright (c) 2014 Waybury
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/ICON-LICENSE b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/ICON-LICENSE
new file mode 100644
index 0000000000..2199f4a694
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/ICON-LICENSE
@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Waybury
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/README.md.txt b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/README.md.txt
new file mode 100644
index 0000000000..6b810e4796
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/README.md.txt
@@ -0,0 +1,114 @@
+[Open Iconic v1.1.1](http://useiconic.com/open)
+===========
+
+### Open Iconic is the open source sibling of [Iconic](http://useiconic.com). It is a hyper-legible collection of 223 icons with a tiny footprint&mdash;ready to use with Bootstrap and Foundation. [View the collection](http://useiconic.com/open#icons)
+
+
+
+## What's in Open Iconic?
+
+* 223 icons designed to be legible down to 8 pixels
+* Super-light SVG files - 61.8 for the entire set 
+* SVG sprite&mdash;the modern replacement for icon fonts
+* Webfont (EOT, OTF, SVG, TTF, WOFF), PNG and WebP formats
+* Webfont stylesheets (including versions for Bootstrap and Foundation) in CSS, LESS, SCSS and Stylus formats
+* PNG and WebP raster images in 8px, 16px, 24px, 32px, 48px and 64px.
+
+
+## Getting Started
+
+#### For code samples and everything else you need to get started with Open Iconic, check out our [Icons](http://useiconic.com/open#icons) and [Reference](http://useiconic.com/open#reference) sections.
+
+### General Usage
+
+#### Using Open Iconic's SVGs
+
+We like SVGs and we think they're the way to display icons on the web. Since Open Iconic are just basic SVGs, we suggest you display them like you would any other image (don't forget the `alt` attribute).
+
+```
+<img src="/open-iconic/svg/icon-name.svg" alt="icon name">
+```
+
+#### Using Open Iconic's SVG Sprite
+
+Open Iconic also comes in a SVG sprite which allows you to display all the icons in the set with a single request. It's like an icon font, without being a hack.
+
+Adding an icon from an SVG sprite is a little different than what you're used to, but it's still a piece of cake. *Tip: To make your icons easily style able, we suggest adding a general class to the* `<svg>` *tag and a unique class name for each different icon in the* `<use>` *tag.*  
+
+```
+<svg class="icon">
+  <use xlink:href="open-iconic.svg#account-login" class="icon-account-login"></use>
+</svg>
+```
+
+Sizing icons only needs basic CSS. All the icons are in a square format, so just set the `<svg>` tag with equal width and height dimensions.
+
+```
+.icon {
+  width: 16px;
+  height: 16px;
+}
+```
+
+Coloring icons is even easier. All you need to do is set the `fill` rule on the `<use>` tag.
+
+```
+.icon-account-login {
+  fill: #f00;
+}
+```
+
+To learn more about SVG Sprites, read [Chris Coyier's guide](http://css-tricks.com/svg-sprites-use-better-icon-fonts/).
+
+#### Using Open Iconic's Icon Font...
+
+
+##### …with Bootstrap
+
+You can find our Bootstrap stylesheets in `font/css/open-iconic-bootstrap.{css, less, scss, styl}`
+
+
+```
+<link href="/open-iconic/font/css/open-iconic-bootstrap.css" rel="stylesheet">
+```
+
+
+```
+<span class="oi oi-icon-name" title="icon name" aria-hidden="true"></span>
+```
+
+##### …with Foundation
+
+You can find our Foundation stylesheets in `font/css/open-iconic-foundation.{css, less, scss, styl}`
+
+```
+<link href="/open-iconic/font/css/open-iconic-foundation.css" rel="stylesheet">
+```
+
+
+```
+<span class="fi-icon-name" title="icon name" aria-hidden="true"></span>
+```
+
+##### …on its own
+
+You can find our default stylesheets in `font/css/open-iconic.{css, less, scss, styl}`
+
+```
+<link href="/open-iconic/font/css/open-iconic.css" rel="stylesheet">
+```
+
+```
+<span class="oi" data-glyph="icon-name" title="icon name" aria-hidden="true"></span>
+```
+
+
+## License
+
+### Icons
+
+All code (including SVG markup) is under the [MIT License](http://opensource.org/licenses/MIT).
+
+### Fonts
+
+All fonts are under the [SIL Licensed](http://scripts.sil.org/cms/scripts/page.php?item_id=OFL_web).
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/font/css/open-iconic-bootstrap.min.css b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/font/css/open-iconic-bootstrap.min.css
new file mode 100644
index 0000000000..4664f2e8ca
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/font/css/open-iconic-bootstrap.min.css
@@ -0,0 +1 @@
+@font-face{font-family:Icons;src:url(../fonts/open-iconic.eot);src:url(../fonts/open-iconic.eot?#iconic-sm) format('embedded-opentype'),url(../fonts/open-iconic.woff) format('woff'),url(../fonts/open-iconic.ttf) format('truetype'),url(../fonts/open-iconic.otf) format('opentype'),url(../fonts/open-iconic.svg#iconic-sm) format('svg');font-weight:400;font-style:normal}.oi{position:relative;top:1px;display:inline-block;speak:none;font-family:Icons;font-style:normal;font-weight:400;line-height:1;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.oi:empty:before{width:1em;text-align:center;box-sizing:content-box}.oi.oi-align-center:before{text-align:center}.oi.oi-align-left:before{text-align:left}.oi.oi-align-right:before{text-align:right}.oi.oi-flip-horizontal:before{-webkit-transform:scale(-1,1);-ms-transform:scale(-1,1);transform:scale(-1,1)}.oi.oi-flip-vertical:before{-webkit-transform:scale(1,-1);-ms-transform:scale(-1,1);transform:scale(1,-1)}.oi.oi-flip-horizontal-vertical:before{-webkit-transform:scale(-1,-1);-ms-transform:scale(-1,1);transform:scale(-1,-1)}.oi-account-login:before{content:'\e000'}.oi-account-logout:before{content:'\e001'}.oi-action-redo:before{content:'\e002'}.oi-action-undo:before{content:'\e003'}.oi-align-center:before{content:'\e004'}.oi-align-left:before{content:'\e005'}.oi-align-right:before{content:'\e006'}.oi-aperture:before{content:'\e007'}.oi-arrow-bottom:before{content:'\e008'}.oi-arrow-circle-bottom:before{content:'\e009'}.oi-arrow-circle-left:before{content:'\e00a'}.oi-arrow-circle-right:before{content:'\e00b'}.oi-arrow-circle-top:before{content:'\e00c'}.oi-arrow-left:before{content:'\e00d'}.oi-arrow-right:before{content:'\e00e'}.oi-arrow-thick-bottom:before{content:'\e00f'}.oi-arrow-thick-left:before{content:'\e010'}.oi-arrow-thick-right:before{content:'\e011'}.oi-arrow-thick-top:before{content:'\e012'}.oi-arrow-top:before{content:'\e013'}.oi-audio-spectrum:before{content:'\e014'}.oi-audio:before{content:'\e015'}.oi-badge:before{content:'\e016'}.oi-ban:before{content:'\e017'}.oi-bar-chart:before{content:'\e018'}.oi-basket:before{content:'\e019'}.oi-battery-empty:before{content:'\e01a'}.oi-battery-full:before{content:'\e01b'}.oi-beaker:before{content:'\e01c'}.oi-bell:before{content:'\e01d'}.oi-bluetooth:before{content:'\e01e'}.oi-bold:before{content:'\e01f'}.oi-bolt:before{content:'\e020'}.oi-book:before{content:'\e021'}.oi-bookmark:before{content:'\e022'}.oi-box:before{content:'\e023'}.oi-briefcase:before{content:'\e024'}.oi-british-pound:before{content:'\e025'}.oi-browser:before{content:'\e026'}.oi-brush:before{content:'\e027'}.oi-bug:before{content:'\e028'}.oi-bullhorn:before{content:'\e029'}.oi-calculator:before{content:'\e02a'}.oi-calendar:before{content:'\e02b'}.oi-camera-slr:before{content:'\e02c'}.oi-caret-bottom:before{content:'\e02d'}.oi-caret-left:before{content:'\e02e'}.oi-caret-right:before{content:'\e02f'}.oi-caret-top:before{content:'\e030'}.oi-cart:before{content:'\e031'}.oi-chat:before{content:'\e032'}.oi-check:before{content:'\e033'}.oi-chevron-bottom:before{content:'\e034'}.oi-chevron-left:before{content:'\e035'}.oi-chevron-right:before{content:'\e036'}.oi-chevron-top:before{content:'\e037'}.oi-circle-check:before{content:'\e038'}.oi-circle-x:before{content:'\e039'}.oi-clipboard:before{content:'\e03a'}.oi-clock:before{content:'\e03b'}.oi-cloud-download:before{content:'\e03c'}.oi-cloud-upload:before{content:'\e03d'}.oi-cloud:before{content:'\e03e'}.oi-cloudy:before{content:'\e03f'}.oi-code:before{content:'\e040'}.oi-cog:before{content:'\e041'}.oi-collapse-down:before{content:'\e042'}.oi-collapse-left:before{content:'\e043'}.oi-collapse-right:before{content:'\e044'}.oi-collapse-up:before{content:'\e045'}.oi-command:before{content:'\e046'}.oi-comment-square:before{content:'\e047'}.oi-compass:before{content:'\e048'}.oi-contrast:before{content:'\e049'}.oi-copywriting:before{content:'\e04a'}.oi-credit-card:before{content:'\e04b'}.oi-crop:before{content:'\e04c'}.oi-dashboard:before{content:'\e04d'}.oi-data-transfer-download:before{content:'\e04e'}.oi-data-transfer-upload:before{content:'\e04f'}.oi-delete:before{content:'\e050'}.oi-dial:before{content:'\e051'}.oi-document:before{content:'\e052'}.oi-dollar:before{content:'\e053'}.oi-double-quote-sans-left:before{content:'\e054'}.oi-double-quote-sans-right:before{content:'\e055'}.oi-double-quote-serif-left:before{content:'\e056'}.oi-double-quote-serif-right:before{content:'\e057'}.oi-droplet:before{content:'\e058'}.oi-eject:before{content:'\e059'}.oi-elevator:before{content:'\e05a'}.oi-ellipses:before{content:'\e05b'}.oi-envelope-closed:before{content:'\e05c'}.oi-envelope-open:before{content:'\e05d'}.oi-euro:before{content:'\e05e'}.oi-excerpt:before{content:'\e05f'}.oi-expand-down:before{content:'\e060'}.oi-expand-left:before{content:'\e061'}.oi-expand-right:before{content:'\e062'}.oi-expand-up:before{content:'\e063'}.oi-external-link:before{content:'\e064'}.oi-eye:before{content:'\e065'}.oi-eyedropper:before{content:'\e066'}.oi-file:before{content:'\e067'}.oi-fire:before{content:'\e068'}.oi-flag:before{content:'\e069'}.oi-flash:before{content:'\e06a'}.oi-folder:before{content:'\e06b'}.oi-fork:before{content:'\e06c'}.oi-fullscreen-enter:before{content:'\e06d'}.oi-fullscreen-exit:before{content:'\e06e'}.oi-globe:before{content:'\e06f'}.oi-graph:before{content:'\e070'}.oi-grid-four-up:before{content:'\e071'}.oi-grid-three-up:before{content:'\e072'}.oi-grid-two-up:before{content:'\e073'}.oi-hard-drive:before{content:'\e074'}.oi-header:before{content:'\e075'}.oi-headphones:before{content:'\e076'}.oi-heart:before{content:'\e077'}.oi-home:before{content:'\e078'}.oi-image:before{content:'\e079'}.oi-inbox:before{content:'\e07a'}.oi-infinity:before{content:'\e07b'}.oi-info:before{content:'\e07c'}.oi-italic:before{content:'\e07d'}.oi-justify-center:before{content:'\e07e'}.oi-justify-left:before{content:'\e07f'}.oi-justify-right:before{content:'\e080'}.oi-key:before{content:'\e081'}.oi-laptop:before{content:'\e082'}.oi-layers:before{content:'\e083'}.oi-lightbulb:before{content:'\e084'}.oi-link-broken:before{content:'\e085'}.oi-link-intact:before{content:'\e086'}.oi-list-rich:before{content:'\e087'}.oi-list:before{content:'\e088'}.oi-location:before{content:'\e089'}.oi-lock-locked:before{content:'\e08a'}.oi-lock-unlocked:before{content:'\e08b'}.oi-loop-circular:before{content:'\e08c'}.oi-loop-square:before{content:'\e08d'}.oi-loop:before{content:'\e08e'}.oi-magnifying-glass:before{content:'\e08f'}.oi-map-marker:before{content:'\e090'}.oi-map:before{content:'\e091'}.oi-media-pause:before{content:'\e092'}.oi-media-play:before{content:'\e093'}.oi-media-record:before{content:'\e094'}.oi-media-skip-backward:before{content:'\e095'}.oi-media-skip-forward:before{content:'\e096'}.oi-media-step-backward:before{content:'\e097'}.oi-media-step-forward:before{content:'\e098'}.oi-media-stop:before{content:'\e099'}.oi-medical-cross:before{content:'\e09a'}.oi-menu:before{content:'\e09b'}.oi-microphone:before{content:'\e09c'}.oi-minus:before{content:'\e09d'}.oi-monitor:before{content:'\e09e'}.oi-moon:before{content:'\e09f'}.oi-move:before{content:'\e0a0'}.oi-musical-note:before{content:'\e0a1'}.oi-paperclip:before{content:'\e0a2'}.oi-pencil:before{content:'\e0a3'}.oi-people:before{content:'\e0a4'}.oi-person:before{content:'\e0a5'}.oi-phone:before{content:'\e0a6'}.oi-pie-chart:before{content:'\e0a7'}.oi-pin:before{content:'\e0a8'}.oi-play-circle:before{content:'\e0a9'}.oi-plus:before{content:'\e0aa'}.oi-power-standby:before{content:'\e0ab'}.oi-print:before{content:'\e0ac'}.oi-project:before{content:'\e0ad'}.oi-pulse:before{content:'\e0ae'}.oi-puzzle-piece:before{content:'\e0af'}.oi-question-mark:before{content:'\e0b0'}.oi-rain:before{content:'\e0b1'}.oi-random:before{content:'\e0b2'}.oi-reload:before{content:'\e0b3'}.oi-resize-both:before{content:'\e0b4'}.oi-resize-height:before{content:'\e0b5'}.oi-resize-width:before{content:'\e0b6'}.oi-rss-alt:before{content:'\e0b7'}.oi-rss:before{content:'\e0b8'}.oi-script:before{content:'\e0b9'}.oi-share-boxed:before{content:'\e0ba'}.oi-share:before{content:'\e0bb'}.oi-shield:before{content:'\e0bc'}.oi-signal:before{content:'\e0bd'}.oi-signpost:before{content:'\e0be'}.oi-sort-ascending:before{content:'\e0bf'}.oi-sort-descending:before{content:'\e0c0'}.oi-spreadsheet:before{content:'\e0c1'}.oi-star:before{content:'\e0c2'}.oi-sun:before{content:'\e0c3'}.oi-tablet:before{content:'\e0c4'}.oi-tag:before{content:'\e0c5'}.oi-tags:before{content:'\e0c6'}.oi-target:before{content:'\e0c7'}.oi-task:before{content:'\e0c8'}.oi-terminal:before{content:'\e0c9'}.oi-text:before{content:'\e0ca'}.oi-thumb-down:before{content:'\e0cb'}.oi-thumb-up:before{content:'\e0cc'}.oi-timer:before{content:'\e0cd'}.oi-transfer:before{content:'\e0ce'}.oi-trash:before{content:'\e0cf'}.oi-underline:before{content:'\e0d0'}.oi-vertical-align-bottom:before{content:'\e0d1'}.oi-vertical-align-center:before{content:'\e0d2'}.oi-vertical-align-top:before{content:'\e0d3'}.oi-video:before{content:'\e0d4'}.oi-volume-high:before{content:'\e0d5'}.oi-volume-low:before{content:'\e0d6'}.oi-volume-off:before{content:'\e0d7'}.oi-warning:before{content:'\e0d8'}.oi-wifi:before{content:'\e0d9'}.oi-wrench:before{content:'\e0da'}.oi-x:before{content:'\e0db'}.oi-yen:before{content:'\e0dc'}.oi-zoom-in:before{content:'\e0dd'}.oi-zoom-out:before{content:'\e0de'}
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/font/fonts/open-iconic.eot b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/font/fonts/open-iconic.eot
new file mode 100644
index 0000000000..f98177dbf7
Binary files /dev/null and b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/font/fonts/open-iconic.eot differ
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/font/fonts/open-iconic.otf b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/font/fonts/open-iconic.otf
new file mode 100644
index 0000000000..f6bd6846a2
Binary files /dev/null and b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/font/fonts/open-iconic.otf differ
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/font/fonts/open-iconic.svg b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/font/fonts/open-iconic.svg
new file mode 100644
index 0000000000..32b2c4e99b
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/font/fonts/open-iconic.svg
@@ -0,0 +1,543 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd" >
+<!--
+2014-7-1: Created.
+-->
+<svg xmlns="http://www.w3.org/2000/svg">
+<metadata>
+Created by FontForge 20120731 at Tue Jul  1 20:39:22 2014
+ By P.J. Onori
+Created by P.J. Onori with FontForge 2.0 (http://fontforge.sf.net)
+</metadata>
+<defs>
+<font id="open-iconic" horiz-adv-x="800" >
+  <font-face 
+    font-family="Icons"
+    font-weight="400"
+    font-stretch="normal"
+    units-per-em="800"
+    panose-1="2 0 5 3 0 0 0 0 0 0"
+    ascent="800"
+    descent="0"
+    bbox="-0.5 -101 802 800.126"
+    underline-thickness="50"
+    underline-position="-100"
+    unicode-range="U+E000-E0DE"
+  />
+    <missing-glyph />
+    <glyph glyph-name="" unicode="&#xe000;" 
+d="M300 700h500v-700h-500v100h400v500h-400v100zM400 500l200 -150l-200 -150v100h-400v100h400v100z" />
+    <glyph glyph-name="1" unicode="&#xe001;" 
+d="M300 700h500v-700h-500v100h400v500h-400v100zM200 500v-100h400v-100h-400v-100l-200 150z" />
+    <glyph glyph-name="2" unicode="&#xe002;" 
+d="M350 700c193 0 350 -157 350 -350v-50h100l-200 -200l-200 200h100v50c0 138 -112 250 -250 250s-250 -112 -250 -250c0 193 157 350 350 350z" />
+    <glyph glyph-name="3" unicode="&#xe003;" 
+d="M450 700c193 0 350 -157 350 -350c0 138 -112 250 -250 250s-250 -112 -250 -250v-50h100l-200 -200l-200 200h100v50c0 193 157 350 350 350z" />
+    <glyph glyph-name="4" unicode="&#xe004;" 
+d="M0 700h800v-100h-800v100zM100 500h600v-100h-600v100zM0 300h800v-100h-800v100zM100 100h600v-100h-600v100z" />
+    <glyph glyph-name="5" unicode="&#xe005;" 
+d="M0 700h800v-100h-800v100zM0 500h600v-100h-600v100zM0 300h800v-100h-800v100zM0 100h600v-100h-600v100z" />
+    <glyph glyph-name="6" unicode="&#xe006;" 
+d="M0 700h800v-100h-800v100zM200 500h600v-100h-600v100zM0 300h800v-100h-800v100zM200 100h600v-100h-600v100z" />
+    <glyph glyph-name="7" unicode="&#xe007;" 
+d="M400 700c75 0 146 -23 206 -59l-75 -225l-322 234c57 31 122 50 191 50zM125 588l191 -138l-310 -222c-4 24 -6 47 -6 72c0 114 49 215 125 288zM688 575c69 -72 112 -168 112 -275c0 -35 -8 -68 -16 -100h-218zM216 253l112 -347c-128 23 -232 109 -287 222zM372 100
+h372c-64 -109 -177 -185 -310 -197z" />
+    <glyph glyph-name="8" unicode="&#xe008;" horiz-adv-x="600" 
+d="M200 800h100v-500h200l-247 -300l-253 300h200v500z" />
+    <glyph glyph-name="9" unicode="&#xe009;" 
+d="M400 800c221 0 400 -179 400 -400s-179 -400 -400 -400s-400 179 -400 400s179 400 400 400zM300 700v-300h-200l300 -300l300 300h-200v300h-200z" />
+    <glyph glyph-name="a" unicode="&#xe00a;" 
+d="M400 800c221 0 400 -179 400 -400s-179 -400 -400 -400s-400 179 -400 400s179 400 400 400zM400 700l-300 -300l300 -300v200h300v200h-300v200z" />
+    <glyph glyph-name="b" unicode="&#xe00b;" 
+d="M400 800c221 0 400 -179 400 -400s-179 -400 -400 -400s-400 179 -400 400s179 400 400 400zM400 700v-200h-300v-200h300v-200l300 300z" />
+    <glyph glyph-name="c" unicode="&#xe00c;" 
+d="M400 800c221 0 400 -179 400 -400s-179 -400 -400 -400s-400 179 -400 400s179 400 400 400zM400 700l-300 -300h200v-300h200v300h200z" />
+    <glyph glyph-name="d" unicode="&#xe00d;" 
+d="M300 600v-200h500v-100h-500v-200l-300 247z" />
+    <glyph glyph-name="e" unicode="&#xe00e;" 
+d="M500 600l300 -247l-300 -253v200h-500v100h500v200z" />
+    <glyph glyph-name="f" unicode="&#xe00f;" horiz-adv-x="600" 
+d="M200 800h200v-500h200l-297 -300l-303 300h200v500z" />
+    <glyph glyph-name="10" unicode="&#xe010;" 
+d="M300 700v-200h500v-200h-500v-200l-300 297z" />
+    <glyph glyph-name="11" unicode="&#xe011;" 
+d="M500 700l300 -297l-300 -303v200h-500v200h500v200z" />
+    <glyph glyph-name="12" unicode="&#xe012;" horiz-adv-x="600" 
+d="M297 800l303 -300h-200v-500h-200v500h-200z" />
+    <glyph glyph-name="13" unicode="&#xe013;" horiz-adv-x="600" 
+d="M247 800l253 -300h-200v-500h-100v500h-200z" />
+    <glyph glyph-name="14" unicode="&#xe014;" 
+d="M400 800h100v-800h-100v800zM200 700h100v-600h-100v600zM600 600h100v-400h-100v400zM0 500h100v-200h-100v200z" />
+    <glyph glyph-name="15" unicode="&#xe015;" 
+d="M116 600l72 -72c-54 -54 -88 -126 -88 -209s34 -159 88 -213l-72 -72c-72 72 -116 175 -116 285s44 209 116 281zM684 600c72 -72 116 -171 116 -281s-44 -213 -116 -285l-72 72c54 54 88 130 88 213s-34 155 -88 209zM259 460l69 -72c-18 -18 -28 -41 -28 -69
+s10 -54 28 -72l-69 -72c-36 36 -59 89 -59 144s23 105 59 141zM541 459c36 -36 59 -85 59 -140s-23 -108 -59 -144l-69 72c18 18 28 44 28 72s-10 51 -28 69z" />
+    <glyph glyph-name="16" unicode="&#xe016;" horiz-adv-x="400" 
+d="M200 800c110 0 200 -90 200 -200s-90 -200 -200 -200s-200 90 -200 200s90 200 200 200zM100 319c31 -11 65 -19 100 -19s68 8 100 19v-319l-100 100l-100 -100v319z" />
+    <glyph glyph-name="17" unicode="&#xe017;" 
+d="M400 800c220 0 400 -180 400 -400s-180 -400 -400 -400s-400 180 -400 400s180 400 400 400zM400 700c-166 0 -300 -134 -300 -300c0 -66 21 -126 56 -175l419 419c-49 35 -109 56 -175 56zM644 575l-419 -419c49 -35 109 -56 175 -56c166 0 300 134 300 300
+c0 66 -21 126 -56 175z" />
+    <glyph glyph-name="18" unicode="&#xe018;" 
+d="M0 700h100v-600h700v-100h-800v700zM500 700h200v-500h-200v500zM200 500h200v-300h-200v300z" />
+    <glyph glyph-name="19" unicode="&#xe019;" 
+d="M397 800c13 1 23 -4 34 -13c2 -2 214 -254 241 -287h128v-100h-100v-366c0 -18 -16 -34 -34 -34h-532c-18 0 -34 16 -34 34v366h-100v100h128l234 281c9 11 22 18 35 19zM400 672l-144 -172h288zM250 300c-28 0 -50 -22 -50 -50v-100c0 -28 22 -50 50 -50s50 22 50 50
+v100c0 28 -22 50 -50 50zM550 300c-28 0 -50 -22 -50 -50v-100c0 -28 22 -50 50 -50s50 22 50 50v100c0 28 -22 50 -50 50z" />
+    <glyph glyph-name="1a" unicode="&#xe01a;" 
+d="M9 700h682c6 0 9 -4 9 -10v-190h100v-200h-100v-191c0 -6 -3 -9 -9 -9h-682c-6 0 -9 3 -9 9v582c0 6 3 9 9 9zM100 600v-400h500v400h-500z" />
+    <glyph glyph-name="1b" unicode="&#xe01b;" 
+d="M9 700h682c6 0 9 -4 9 -10v-190h100v-200h-100v-191c0 -6 -3 -9 -9 -9h-682c-6 0 -9 3 -9 9v582c0 6 3 9 9 9z" />
+    <glyph glyph-name="1c" unicode="&#xe01c;" 
+d="M92 650c0 23 19 50 45 50h3h5h5h500c28 0 50 -22 50 -50s-22 -50 -50 -50h-50v-141c9 -17 120 -231 166 -309c16 -26 34 -61 34 -106c0 -39 -15 -77 -41 -103h-3c-26 -25 -62 -41 -100 -41h-512c-39 0 -77 15 -103 41s-41 64 -41 103c0 46 18 80 34 106
+c46 78 157 292 166 309v141h-50c-2 0 -6 -1 -8 -1c-28 0 -50 23 -50 51zM500 600h-200v-162l-6 -10s-63 -123 -119 -228h450c-56 105 -119 228 -119 228l-6 10v162z" />
+    <glyph glyph-name="1d" unicode="&#xe01d;" 
+d="M400 800c110 0 200 -90 200 -200c0 -104 52 -198 134 -266c41 -34 66 -82 66 -134h-800c0 52 25 100 66 134c82 68 134 162 134 266c0 110 90 200 200 200zM300 100h200c0 -55 -45 -100 -100 -100s-100 45 -100 100z" />
+    <glyph glyph-name="1e" unicode="&#xe01e;" horiz-adv-x="600" 
+d="M150 800h50l350 -250l-225 -147l225 -153l-350 -250h-50v250l-75 -75l-75 75l150 150l-150 150l75 75l75 -75v250zM250 650v-200l150 100zM250 350v-200l150 100z" />
+    <glyph glyph-name="1f" unicode="&#xe01f;" 
+d="M0 800h500c110 0 200 -90 200 -200c0 -47 -17 -91 -44 -125c85 -40 144 -125 144 -225c0 -138 -112 -250 -250 -250h-550v100c55 0 100 45 100 100v400c0 55 -45 100 -100 100v100zM300 700v-200h100c55 0 100 45 100 100s-45 100 -100 100h-100zM300 400v-300h150
+c83 0 150 67 150 150s-67 150 -150 150h-150z" />
+    <glyph glyph-name="20" unicode="&#xe020;" horiz-adv-x="600" 
+d="M300 800v-300h200l-300 -500v300h-200z" />
+    <glyph glyph-name="21" unicode="&#xe021;" 
+d="M100 800h300v-300l100 100l100 -100v300h50c28 0 50 -22 50 -50v-550h-550c-28 0 -50 -22 -50 -50s22 -50 50 -50h550v-100h-550c-83 0 -150 67 -150 150v550l3 19c8 39 39 70 78 78z" />
+    <glyph glyph-name="22" unicode="&#xe022;" horiz-adv-x="400" 
+d="M0 800h400v-800l-200 200l-200 -200v800z" />
+    <glyph glyph-name="23" unicode="&#xe023;" 
+d="M0 800h800v-100h-800v100zM0 600h300v-103h203v103h297v-591c0 -6 -3 -9 -9 -9h-782c-6 0 -9 3 -9 9v591z" />
+    <glyph glyph-name="24" unicode="&#xe024;" 
+d="M300 800h200c55 0 100 -45 100 -100v-100h191c6 0 9 -3 9 -9v-241c0 -28 -22 -50 -50 -50h-700c-28 0 -50 22 -50 50v241c0 6 3 9 9 9h191v100c0 55 45 100 100 100zM300 700v-100h200v100h-200zM0 209c16 -6 32 -9 50 -9h700c18 0 34 3 50 9v-200c0 -6 -3 -9 -9 -9h-782
+c-6 0 -9 3 -9 9v200z" />
+    <glyph glyph-name="25" unicode="&#xe025;" horiz-adv-x="600" 
+d="M300 800c58 0 110 -16 147 -53s53 -89 53 -147h-100c0 39 -11 61 -25 75s-36 25 -75 25c-35 0 -55 -10 -72 -31s-28 -55 -28 -94c0 -51 20 -107 28 -175h172v-100h-178c-14 -60 -49 -127 -113 -200h491v-100h-600v122l16 12c69 69 95 121 106 166h-122v100h125
+c-8 50 -25 106 -25 175c0 58 16 114 50 156c34 43 88 69 150 69z" />
+    <glyph glyph-name="26" unicode="&#xe026;" 
+d="M34 700h4h3h4h5h700c28 0 50 -22 50 -50v-700c0 -28 -22 -50 -50 -50h-700c-28 0 -50 22 -50 50v700v2c0 20 15 42 34 48zM150 600c-28 0 -50 -22 -50 -50s22 -50 50 -50s50 22 50 50s-22 50 -50 50zM350 600c-28 0 -50 -22 -50 -50s22 -50 50 -50h300c28 0 50 22 50 50
+s-22 50 -50 50h-300zM100 400v-400h600v400h-600z" />
+    <glyph glyph-name="27" unicode="&#xe027;" 
+d="M744 797l6 -3l44 -44c4 -4 3 -8 0 -12l-266 -375l-15 -13l-25 -12c-23 72 -78 127 -150 150l12 25l13 15l375 266zM266 400c74 0 134 -60 134 -134c0 -147 -119 -266 -266 -266c-48 0 -95 12 -134 34c80 46 134 133 134 232c0 74 58 134 132 134z" />
+    <glyph glyph-name="28" unicode="&#xe028;" 
+d="M9 451c0 23 19 50 46 50c8 0 19 -3 26 -7l131 -66l29 22c-79 81 -1 250 118 250s197 -167 119 -250l28 -22l131 66c6 4 12 7 21 7c28 0 50 -22 50 -50c0 -17 -12 -37 -27 -45l-115 -56c9 -16 19 -33 25 -50h68c28 0 50 -22 50 -50s-22 -50 -50 -50h-50
+c0 -23 -2 -45 -6 -66l78 -40c21 -5 37 -28 37 -49c0 -28 -22 -50 -50 -50c-10 0 -23 5 -31 11l-65 35c-24 -46 -62 -86 -103 -110c-35 19 -60 45 -60 72v135v4v5v6v5v5v87c0 28 -22 50 -50 50c-24 0 -45 -17 -50 -40c1 -3 1 -8 1 -11s0 -8 -1 -11v-82v-4v-5v-144
+c0 -28 -24 -53 -59 -72c-41 25 -79 64 -103 110l-66 -35c-8 -6 -21 -11 -31 -11c-28 0 -50 22 -50 50c0 21 16 44 37 49l78 40c-4 21 -6 43 -6 66h-50h-5c-28 0 -50 22 -50 50c0 26 22 50 50 50h5h69c6 17 16 34 25 50l-116 56c-16 7 -28 27 -28 45z" />
+    <glyph glyph-name="29" unicode="&#xe029;" 
+d="M600 700h91c6 0 9 -3 9 -9v-582c0 -6 -3 -9 -9 -9h-91v600zM210 503l290 147v-500l-250 125v-3c-15 0 -25 -8 -28 -22l75 -178c11 -25 0 -58 -25 -69s-58 0 -69 25l-103 272h-91c-6 0 -9 3 -9 9v182c0 6 3 9 9 9h182z" />
+    <glyph glyph-name="2a" unicode="&#xe02a;" 
+d="M9 800h682c6 0 9 -3 9 -9v-782c0 -6 -3 -9 -9 -9h-682c-6 0 -9 3 -9 9v782c0 6 3 9 9 9zM100 700v-200h500v200h-500zM100 400v-100h100v100h-100zM300 400v-100h100v100h-100zM500 400v-300h100v300h-100zM100 200v-100h100v100h-100zM300 200v-100h100v100h-100z" />
+    <glyph glyph-name="2b" unicode="&#xe02b;" 
+d="M0 800h700v-200h-700v200zM0 500h700v-491c0 -6 -3 -9 -9 -9h-682c-6 0 -9 3 -9 9v491zM100 400v-100h100v100h-100zM300 400v-100h100v100h-100zM500 400v-100h100v100h-100zM100 200v-100h100v100h-100zM300 200v-100h100v100h-100z" />
+    <glyph glyph-name="2c" unicode="&#xe02c;" 
+d="M409 800h182c6 0 10 -4 12 -9l94 -182c2 -5 6 -9 12 -9h82c6 0 9 -3 9 -9v-582c0 -6 -3 -9 -9 -9h-782c-6 0 -9 3 -9 9v441c0 83 67 150 150 150h141c6 0 10 4 12 9l94 182c2 5 6 9 12 9zM150 500c-28 0 -50 -22 -50 -50s22 -50 50 -50s50 22 50 50s-22 50 -50 50z
+M500 500c-110 0 -200 -90 -200 -200s90 -200 200 -200s200 90 200 200s-90 200 -200 200zM500 400c55 0 100 -45 100 -100s-45 -100 -100 -100s-100 45 -100 100s45 100 100 100z" />
+    <glyph glyph-name="2d" unicode="&#xe02d;" 
+d="M0 600h800l-400 -400z" />
+    <glyph glyph-name="2e" unicode="&#xe02e;" horiz-adv-x="400" 
+d="M400 800v-800l-400 400z" />
+    <glyph glyph-name="2f" unicode="&#xe02f;" horiz-adv-x="400" 
+d="M0 800l400 -400l-400 -400v800z" />
+    <glyph glyph-name="30" unicode="&#xe030;" 
+d="M400 600l400 -400h-800z" />
+    <glyph glyph-name="31" unicode="&#xe031;" 
+d="M0 550c0 23 20 50 46 50h3h5h4h200c17 0 37 -13 44 -28l38 -72h444c14 0 19 -12 15 -25l-81 -250c-4 -13 -21 -25 -35 -25h-350c-14 0 -30 12 -34 25c-27 83 -54 167 -81 250l-10 25h-150c-2 0 -5 -1 -7 -1c-28 0 -51 23 -51 51zM358 100c28 0 50 -22 50 -50
+s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM658 100c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50z" />
+    <glyph glyph-name="32" unicode="&#xe032;" 
+d="M0 700h500v-100h-300v-300h-100l-100 -100v500zM300 500h500v-500l-100 100h-400v400z" />
+    <glyph glyph-name="33" unicode="&#xe033;" 
+d="M641 700l143 -141l-493 -493c-71 76 -146 148 -219 222l-72 71l141 141c50 -51 101 -101 153 -150c116 117 234 231 347 350z" />
+    <glyph glyph-name="34" unicode="&#xe034;" 
+d="M150 600l250 -250l250 250l150 -150l-400 -400l-400 400z" />
+    <glyph glyph-name="35" unicode="&#xe035;" horiz-adv-x="600" 
+d="M400 800l150 -150l-250 -250l250 -250l-150 -150l-400 400z" />
+    <glyph glyph-name="36" unicode="&#xe036;" horiz-adv-x="600" 
+d="M150 800l400 -400l-400 -400l-150 150l250 250l-250 250z" />
+    <glyph glyph-name="37" unicode="&#xe037;" 
+d="M400 600l400 -400l-150 -150l-250 250l-250 -250l-150 150z" />
+    <glyph glyph-name="38" unicode="&#xe038;" 
+d="M400 800c221 0 400 -179 400 -400s-179 -400 -400 -400s-400 179 -400 400s179 400 400 400zM600 622l-250 -250l-100 100l-72 -72l172 -172l322 322z" />
+    <glyph glyph-name="39" unicode="&#xe039;" 
+d="M400 800c221 0 400 -179 400 -400s-179 -400 -400 -400s-400 179 -400 400s179 400 400 400zM250 622l-72 -72l150 -150l-150 -150l72 -72l150 150l150 -150l72 72l-150 150l150 150l-72 72l-150 -150z" />
+    <glyph glyph-name="3a" unicode="&#xe03a;" 
+d="M350 800c28 0 50 -22 50 -50v-50h75c14 0 25 -11 25 -25v-75h-300v75c0 14 11 25 25 25h75v50c0 28 22 50 50 50zM25 700h75v-200h500v200h75c14 0 25 -11 25 -25v-650c0 -14 -11 -25 -25 -25h-650c-14 0 -25 11 -25 25v650c0 14 11 25 25 25z" />
+    <glyph glyph-name="3b" unicode="&#xe03b;" 
+d="M400 800c220 0 400 -180 400 -400s-180 -400 -400 -400s-400 180 -400 400s180 400 400 400zM400 700c-166 0 -300 -134 -300 -300s134 -300 300 -300s300 134 300 300s-134 300 -300 300zM350 600h100v-181c23 -24 47 -47 72 -69l-72 -72c-27 30 -55 59 -84 88l-16 12
+v222z" />
+    <glyph glyph-name="3c" unicode="&#xe03c;" 
+d="M450 800c138 0 250 -112 250 -250v-50c58 -21 100 -85 100 -150c0 -18 -3 -34 -9 -50h-191v50c0 83 -67 150 -150 150s-150 -67 -150 -150v-50h-272c-17 30 -28 63 -28 100c0 110 90 200 200 200c23 114 129 200 250 200zM434 400h3h4c3 0 6 1 9 1c28 0 50 -22 50 -50v-1
+v-150h150l-200 -200l-200 200h150v150v2c0 20 15 42 34 48z" />
+    <glyph glyph-name="3d" unicode="&#xe03d;" 
+d="M450 800c138 0 250 -112 250 -250v-50c58 -21 100 -85 100 -150c0 -18 -3 -34 -9 -50h-141l-200 200l-200 -200h-222c-17 30 -28 63 -28 100c0 110 90 200 200 200c23 114 129 200 250 200zM450 350l250 -250h-200v-50c0 -28 -22 -50 -50 -50s-50 22 -50 50v50h-200z" />
+    <glyph glyph-name="3e" unicode="&#xe03e;" 
+d="M450 700c138 0 250 -112 250 -250v-50c58 -21 100 -85 100 -150c0 -83 -67 -150 -150 -150h-450c-110 0 -200 90 -200 200s90 200 200 200c23 114 129 200 250 200z" />
+    <glyph glyph-name="3f" unicode="&#xe03f;" 
+d="M250 800c82 0 154 -40 200 -100c-143 0 -270 -85 -325 -209c-36 -10 -70 -25 -100 -47c-16 33 -25 67 -25 106c0 138 112 250 250 250zM450 600c138 0 250 -112 250 -250v-50c58 -21 100 -85 100 -150c0 -83 -67 -150 -150 -150h-450c-110 0 -200 90 -200 200
+s90 200 200 200c23 114 129 200 250 200z" />
+    <glyph glyph-name="40" unicode="&#xe040;" 
+d="M500 700h100l-300 -600h-100zM100 600h100l-100 -200l100 -200h-100l-100 200zM600 600h100l100 -200l-100 -200h-100l100 200z" />
+    <glyph glyph-name="41" unicode="&#xe041;" 
+d="M350 800h100l50 -119l28 -12l119 50l72 -72l-50 -119l12 -28l119 -50v-100l-119 -50l-12 -28l50 -119l-72 -72l-119 50l-28 -12l-50 -119h-100l-50 119l-28 12l-119 -50l-72 72l50 119l-12 28l-119 50v100l119 50l12 28l-50 119l72 72l119 -50l28 12zM400 550
+c-83 0 -150 -67 -150 -150s67 -150 150 -150s150 67 150 150s-67 150 -150 150z" />
+    <glyph glyph-name="42" unicode="&#xe042;" 
+d="M0 800h800v-200h-800v200zM200 500h400l-200 -200zM0 100h800v-100h-800v100z" />
+    <glyph glyph-name="43" unicode="&#xe043;" 
+d="M0 800h100v-800h-100v800zM600 800h200v-800h-200v800zM500 600v-400l-200 200z" />
+    <glyph glyph-name="44" unicode="&#xe044;" 
+d="M0 800h200v-800h-200v800zM700 800h100v-800h-100v800zM300 600l200 -200l-200 -200v400z" />
+    <glyph glyph-name="45" unicode="&#xe045;" 
+d="M0 800h800v-100h-800v100zM400 500l200 -200h-400zM0 200h800v-200h-800v200z" />
+    <glyph glyph-name="46" unicode="&#xe046;" 
+d="M150 700c83 0 150 -67 150 -150v-50h100v50c0 83 67 150 150 150s150 -67 150 -150s-67 -150 -150 -150h-50v-100h50c83 0 150 -67 150 -150s-67 -150 -150 -150s-150 67 -150 150v50h-100v-50c0 -83 -67 -150 -150 -150s-150 67 -150 150s67 150 150 150h50v100h-50
+c-83 0 -150 67 -150 150s67 150 150 150zM150 600c-28 0 -50 -22 -50 -50s22 -50 50 -50h50v50c0 28 -22 50 -50 50zM550 600c-28 0 -50 -22 -50 -50v-50h50c28 0 50 22 50 50s-22 50 -50 50zM300 400v-100h100v100h-100zM150 200c-28 0 -50 -22 -50 -50s22 -50 50 -50
+s50 22 50 50v50h-50zM500 200v-50c0 -28 22 -50 50 -50s50 22 50 50s-22 50 -50 50h-50z" />
+    <glyph glyph-name="47" unicode="&#xe047;" 
+d="M0 791c0 5 4 9 9 9h782c6 0 9 -4 9 -10v-790l-200 200h-591c-6 0 -9 3 -9 9v582z" />
+    <glyph glyph-name="48" unicode="&#xe048;" 
+d="M400 800c220 0 400 -180 400 -400s-180 -400 -400 -400s-400 180 -400 400s180 400 400 400zM400 700c-166 0 -300 -134 -300 -300s134 -300 300 -300s300 134 300 300s-134 300 -300 300zM600 600l-100 -300l-300 -100l100 300zM400 450c-28 0 -50 -22 -50 -50
+s22 -50 50 -50s50 22 50 50s-22 50 -50 50z" />
+    <glyph glyph-name="49" unicode="&#xe049;" 
+d="M400 800c220 0 400 -180 400 -400s-180 -400 -400 -400s-400 180 -400 400s180 400 400 400zM400 700v-600c166 0 300 134 300 300s-134 300 -300 300z" />
+    <glyph glyph-name="4a" unicode="&#xe04a;" 
+d="M0 800h800v-100h-800v100zM0 600h500v-100h-500v100zM0 300h800v-100h-800v100zM0 100h600v-100h-600v100zM750 100c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50z" />
+    <glyph glyph-name="4b" unicode="&#xe04b;" 
+d="M25 700h750c14 0 25 -11 25 -25v-75h-800v75c0 14 11 25 25 25zM0 500h800v-375c0 -14 -11 -25 -25 -25h-750c-14 0 -25 11 -25 25v375zM100 300v-100h100v100h-100zM300 300v-100h100v100h-100z" />
+    <glyph glyph-name="4c" unicode="&#xe04c;" 
+d="M100 800h100v-100h450l100 100l50 -50l-100 -100v-450h100v-100h-100v-100h-100v100h-500v500h-100v100h100v100zM200 600v-350l350 350h-350zM600 550l-350 -350h350v350z" />
+    <glyph glyph-name="4d" unicode="&#xe04d;" 
+d="M400 800c220 0 400 -180 400 -400s-180 -400 -400 -400s-400 180 -400 400s180 400 400 400zM400 700c-166 0 -300 -134 -300 -300s134 -300 300 -300s300 134 300 300s-134 300 -300 300zM400 600c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50z
+M200 452c0 20 15 42 34 48h3h3h8c12 0 28 -7 36 -16l91 -90l25 6c55 0 100 -45 100 -100s-45 -100 -100 -100s-100 45 -100 100l6 25l-90 91c-9 8 -16 24 -16 36zM550 500c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50z" />
+    <glyph glyph-name="4e" unicode="&#xe04e;" 
+d="M300 800h200v-300h200l-300 -300l-300 300h200v300zM0 100h800v-100h-800v100z" />
+    <glyph glyph-name="4f" unicode="&#xe04f;" 
+d="M0 800h800v-100h-800v100zM400 600l300 -300h-200v-300h-200v300h-200z" />
+    <glyph glyph-name="50" unicode="&#xe050;" 
+d="M200 700h600v-600h-600l-200 300zM350 622l-72 -72l150 -150l-150 -150l72 -72l150 150l150 -150l72 72l-150 150l150 150l-72 72l-150 -150z" />
+    <glyph glyph-name="51" unicode="&#xe051;" 
+d="M400 700c220 0 400 -180 400 -400h-100c0 166 -134 300 -300 300s-300 -134 -300 -300h-100c0 220 180 400 400 400zM341 491l59 -88l59 88c81 -25 141 -101 141 -191c0 -110 -90 -200 -200 -200s-200 90 -200 200c0 90 60 166 141 191z" />
+    <glyph glyph-name="52" unicode="&#xe052;" 
+d="M0 800h300v-400h400v-400h-700v800zM400 800l300 -300h-300v300zM100 600v-100h100v100h-100zM100 400v-100h100v100h-100zM100 200v-100h400v100h-400z" />
+    <glyph glyph-name="53" unicode="&#xe053;" horiz-adv-x="600" 
+d="M200 700h100v-100h75c30 0 58 -6 81 -22s44 -44 44 -78v-100h-100v94c-4 3 -13 6 -25 6h-250c-14 0 -25 -11 -25 -25v-50c0 -15 20 -40 34 -44l257 -65c66 -16 109 -73 109 -141v-50c0 -68 -57 -125 -125 -125h-75v-100h-100v100h-75c-30 0 -58 6 -81 22s-44 44 -44 78
+v100h100v-94c4 -3 13 -6 25 -6h250c14 0 25 11 25 25v50c0 15 -20 40 -34 44l-257 65c-66 16 -109 73 -109 141v50c0 68 57 125 125 125h75v100z" />
+    <glyph glyph-name="54" unicode="&#xe054;" 
+d="M0 700h300v-300l-300 -300v600zM500 700h300v-300l-300 -300v600z" />
+    <glyph glyph-name="55" unicode="&#xe055;" 
+d="M300 700v-600h-300v300zM800 700v-600h-300v300z" />
+    <glyph glyph-name="56" unicode="&#xe056;" 
+d="M300 700v-100c-111 0 -200 -89 -200 -200h200v-300h-300v300c0 165 135 300 300 300zM800 700v-100c-111 0 -200 -89 -200 -200h200v-300h-300v300c0 165 135 300 300 300z" />
+    <glyph glyph-name="57" unicode="&#xe057;" 
+d="M0 700h300v-300c0 -165 -135 -300 -300 -300v100c111 0 200 89 200 200h-200v300zM500 700h300v-300c0 -165 -135 -300 -300 -300v100c111 0 200 89 200 200h-200v300z" />
+    <glyph glyph-name="58" unicode="&#xe058;" horiz-adv-x="600" 
+d="M300 800l34 -34c11 -11 266 -270 266 -488c0 -165 -135 -300 -300 -300s-300 135 -300 300c0 218 255 477 266 488zM150 328c-28 0 -50 -22 -50 -50c0 -110 90 -200 200 -200c28 0 50 22 50 50s-22 50 -50 50c-55 0 -100 45 -100 100c0 28 -22 50 -50 50z" />
+    <glyph glyph-name="59" unicode="&#xe059;" 
+d="M400 800l400 -500h-800zM0 200h800v-200h-800v200z" />
+    <glyph glyph-name="5a" unicode="&#xe05a;" horiz-adv-x="600" 
+d="M300 800l300 -300h-600zM0 300h600l-300 -300z" />
+    <glyph glyph-name="5b" unicode="&#xe05b;" 
+d="M0 500h200v-200h-200v200zM300 500h200v-200h-200v200zM600 500h200v-200h-200v200z" />
+    <glyph glyph-name="5c" unicode="&#xe05c;" 
+d="M0 700h800v-100l-400 -200l-400 200v100zM0 500l400 -200l400 200v-400h-800v400z" />
+    <glyph glyph-name="5d" unicode="&#xe05d;" 
+d="M400 800l400 -200v-600h-800v600zM400 688l-300 -150v-188l300 -150l300 150v188zM200 500h400v-100l-200 -100l-200 100v100z" />
+    <glyph glyph-name="5e" unicode="&#xe05e;" 
+d="M600 700c69 0 134 -19 191 -50l-16 -106c-49 35 -109 56 -175 56c-131 0 -240 -84 -281 -200h331l-16 -100h-334c0 -36 8 -68 19 -100h297l-16 -100h-222c55 -61 133 -100 222 -100c78 0 147 30 200 78v-122c-59 -35 -127 -56 -200 -56c-147 0 -274 82 -344 200h-256
+l19 100h197c-8 32 -16 66 -16 100h-200l25 100h191c45 172 198 300 384 300z" />
+    <glyph glyph-name="5f" unicode="&#xe05f;" 
+d="M0 700h700v-100h-700v100zM0 500h500v-100h-500v100zM0 300h800v-100h-800v100zM0 100h100v-100h-100v100zM200 100h100v-100h-100v100zM400 100h100v-100h-100v100z" />
+    <glyph glyph-name="60" unicode="&#xe060;" 
+d="M0 800h800v-100h-800v100zM200 600h400l-200 -200zM0 200h800v-200h-800v200z" />
+    <glyph glyph-name="61" unicode="&#xe061;" 
+d="M0 800h100v-800h-100v800zM600 800h200v-800h-200v800zM200 600l200 -200l-200 -200v400z" />
+    <glyph glyph-name="62" unicode="&#xe062;" 
+d="M0 800h200v-800h-200v800zM700 800h100v-800h-100v800zM600 600v-400l-200 200z" />
+    <glyph glyph-name="63" unicode="&#xe063;" 
+d="M0 800h800v-200h-800v200zM400 400l200 -200h-400zM0 100h800v-100h-800v100z" />
+    <glyph glyph-name="64" unicode="&#xe064;" 
+d="M0 800h200v-100h-100v-600h600v100h100v-200h-800v800zM400 800h400v-400l-150 150l-250 -250l-100 100l250 250z" />
+    <glyph glyph-name="65" unicode="&#xe065;" 
+d="M403 700c247 0 397 -300 397 -300s-150 -300 -397 -300c-253 0 -403 300 -403 300s150 300 403 300zM400 600c-110 0 -200 -90 -200 -200s90 -200 200 -200s200 90 200 200s-90 200 -200 200zM400 500c10 0 19 -3 28 -6c-16 -8 -28 -24 -28 -44c0 -28 22 -50 50 -50
+c20 0 36 12 44 28c3 -9 6 -18 6 -28c0 -55 -45 -100 -100 -100s-100 45 -100 100s45 100 100 100z" />
+    <glyph glyph-name="66" unicode="&#xe066;" horiz-adv-x="900" 
+d="M331 700h3h3c3 1 7 1 10 1c12 0 29 -8 37 -17l94 -93l66 65c57 57 155 57 212 0c58 -58 58 -154 0 -212l-65 -66l93 -94c10 -8 18 -25 18 -38c0 -28 -22 -50 -50 -50c-13 0 -32 9 -40 20l-62 65l-381 -381h-269v272l375 381l-63 63c-9 8 -16 24 -16 36c0 20 16 42 35 48z
+M447 481l-313 -315l128 -132l316 316z" />
+    <glyph glyph-name="67" unicode="&#xe067;" 
+d="M0 800h300v-400h400v-400h-700v800zM400 800l300 -300h-300v300z" />
+    <glyph glyph-name="68" unicode="&#xe068;" 
+d="M200 800c0 0 200 -100 200 -300s-298 -302 -200 -500c0 0 -200 100 -200 300s300 300 200 500zM500 500c0 0 200 -100 200 -300c0 -150 -60 -200 -100 -200h-300c0 200 300 300 200 500z" />
+    <glyph glyph-name="69" unicode="&#xe069;" 
+d="M0 800h100v-800h-100v800zM200 800h300v-100h300l-200 -203l200 -197h-400v100h-200v400z" />
+    <glyph glyph-name="6a" unicode="&#xe06a;" horiz-adv-x="400" 
+d="M150 800h150l-100 -200h200l-150 -300h150l-300 -300l-100 300h134l66 200h-200z" />
+    <glyph glyph-name="6b" unicode="&#xe06b;" 
+d="M0 800h300v-100h500v-100h-800v200zM0 500h800v-450c0 -28 -22 -50 -50 -50h-700c-28 0 -50 22 -50 50v450z" />
+    <glyph glyph-name="6c" unicode="&#xe06c;" 
+d="M150 800c83 0 150 -67 150 -150c0 -66 -41 -121 -100 -141v-118c15 5 33 9 50 9h200c28 0 50 22 50 50v59c-59 20 -100 75 -100 141c0 83 67 150 150 150s150 -67 150 -150c0 -66 -41 -121 -100 -141v-59c0 -82 -68 -150 -150 -150h-200c-14 0 -25 -7 -34 -16
+c50 -24 84 -74 84 -134c0 -83 -67 -150 -150 -150s-150 67 -150 150c0 66 41 121 100 141v218c-59 20 -100 75 -100 141c0 83 67 150 150 150z" />
+    <glyph glyph-name="6d" unicode="&#xe06d;" 
+d="M0 800h400l-150 -150l150 -150l-100 -100l-150 150l-150 -150v400zM500 400l150 -150l150 150v-400h-400l150 150l-150 150z" />
+    <glyph glyph-name="6e" unicode="&#xe06e;" 
+d="M100 800l150 -150l150 150v-400h-400l150 150l-150 150zM400 400h400l-150 -150l150 -150l-100 -100l-150 150l-150 -150v400z" />
+    <glyph glyph-name="6f" unicode="&#xe06f;" 
+d="M400 800c221 0 400 -179 400 -400s-179 -400 -400 -400s-400 179 -400 400s179 400 400 400zM400 700c-56 0 -108 -17 -153 -44l22 -19c33 -18 13 -48 -13 -59c-30 -13 -77 10 -65 -41c13 -55 -27 -3 -47 -15c-42 -26 49 -152 31 -156l-59 34c-8 0 -13 -5 -16 -10
+c1 -30 10 -57 19 -84c28 -11 77 -2 100 -25c47 -28 97 -115 75 -159c34 -13 68 -22 106 -22c101 0 193 48 247 125c3 24 -8 44 -50 44c-69 0 -156 13 -153 97c2 46 101 108 66 143c-30 30 12 39 12 66c0 37 -65 32 -69 50s20 36 41 56c-30 10 -60 19 -94 19zM631 591
+c-38 -11 -94 -35 -87 -53c6 -15 52 -1 65 -13c11 -10 16 -59 44 -31l22 22v3c-11 26 -26 50 -44 72z" />
+    <glyph glyph-name="70" unicode="&#xe070;" 
+d="M703 800l97 -100l-400 -400l-100 100l-200 -203l-100 100l300 303l100 -100zM0 100h800v-100h-800v100z" />
+    <glyph glyph-name="71" unicode="&#xe071;" 
+d="M0 700h100v-100h-100v100zM200 700h100v-100h-100v100zM400 700h100v-100h-100v100zM600 700h100v-100h-100v100zM0 500h100v-100h-100v100zM200 500h100v-100h-100v100zM400 500h100v-100h-100v100zM600 500h100v-100h-100v100zM0 300h100v-100h-100v100zM200 300h100
+v-100h-100v100zM400 300h100v-100h-100v100zM600 300h100v-100h-100v100zM0 100h100v-100h-100v100zM200 100h100v-100h-100v100zM400 100h100v-100h-100v100zM600 100h100v-100h-100v100z" />
+    <glyph glyph-name="72" unicode="&#xe072;" 
+d="M0 800h200v-200h-200v200zM300 800h200v-200h-200v200zM600 800h200v-200h-200v200zM0 500h200v-200h-200v200zM300 500h200v-200h-200v200zM600 500h200v-200h-200v200zM0 200h200v-200h-200v200zM300 200h200v-200h-200v200zM600 200h200v-200h-200v200z" />
+    <glyph glyph-name="73" unicode="&#xe073;" 
+d="M0 800h300v-300h-300v300zM500 800h300v-300h-300v300zM0 300h300v-300h-300v300zM500 300h300v-300h-300v300z" />
+    <glyph glyph-name="74" unicode="&#xe074;" 
+d="M19 800h662c11 0 19 -8 19 -19v-331c0 -28 -22 -50 -50 -50h-600c-28 0 -50 22 -50 50v331c0 11 8 19 19 19zM0 309c16 -6 32 -9 50 -9h600c18 0 34 3 50 9v-290c0 -11 -8 -19 -19 -19h-662c-11 0 -19 8 -19 19v290zM550 200c-28 0 -50 -22 -50 -50s22 -50 50 -50
+s50 22 50 50s-22 50 -50 50z" />
+    <glyph glyph-name="75" unicode="&#xe075;" 
+d="M0 700h300v-100h-50c-28 0 -50 -22 -50 -50v-150h300v150c0 28 -22 50 -50 50h-50v100h300v-100h-50c-28 0 -50 -22 -50 -50v-400c0 -28 22 -50 50 -50h50v-100h-300v100h50c28 0 50 22 50 50v150h-300v-150c0 -28 22 -50 50 -50h50v-100h-300v100h50c28 0 50 22 50 50
+v400c0 28 -22 50 -50 50h-50v100z" />
+    <glyph glyph-name="76" unicode="&#xe076;" 
+d="M400 700c165 0 300 -135 300 -300v-100h50c28 0 50 -22 50 -50v-200c0 -28 -22 -50 -50 -50h-100c-28 0 -50 22 -50 50v350c0 111 -89 200 -200 200s-200 -89 -200 -200v-350c0 -28 -22 -50 -50 -50h-100c-28 0 -50 22 -50 50v200c0 28 22 50 50 50h50v100
+c0 165 135 300 300 300z" />
+    <glyph glyph-name="77" unicode="&#xe077;" 
+d="M0 500c0 109 91 200 200 200s200 -91 200 -200c0 109 91 200 200 200s200 -91 200 -200c0 -55 -23 -105 -59 -141l-341 -340l-341 340c-36 36 -59 86 -59 141z" />
+    <glyph glyph-name="78" unicode="&#xe078;" 
+d="M400 700l400 -300l-100 3v-403h-200v200h-200v-200h-200v400h-100z" />
+    <glyph glyph-name="79" unicode="&#xe079;" 
+d="M0 800h800v-800h-800v800zM100 700v-300l100 100l400 -400h100v100l-200 200l100 100l100 -100v300h-600z" />
+    <glyph glyph-name="7a" unicode="&#xe07a;" 
+d="M19 800h762c11 0 19 -8 19 -19v-762c0 -11 -8 -19 -19 -19h-762c-11 0 -19 8 -19 19v762c0 11 8 19 19 19zM100 600v-300h100l100 -100h200l100 100h100v300h-600z" />
+    <glyph glyph-name="7b" unicode="&#xe07b;" 
+d="M200 600c80 0 142 -56 200 -122c58 66 119 122 200 122c131 0 200 -101 200 -200s-69 -200 -200 -200c-81 0 -142 56 -200 122c-58 -66 -121 -122 -200 -122c-131 0 -200 101 -200 200s69 200 200 200zM200 500c-74 0 -100 -54 -100 -100s26 -100 100 -100
+c42 0 88 47 134 100c-46 53 -92 100 -134 100zM600 500c-43 0 -88 -47 -134 -100c46 -53 91 -100 134 -100c74 0 100 54 100 100s-26 100 -100 100z" />
+    <glyph glyph-name="7c" unicode="&#xe07c;" horiz-adv-x="400" 
+d="M300 800c55 0 100 -45 100 -100s-45 -100 -100 -100s-100 45 -100 100s45 100 100 100zM150 550c83 0 150 -69 150 -150c0 -66 -100 -214 -100 -250c0 -28 22 -50 50 -50s50 22 50 50h100c0 -83 -67 -150 -150 -150s-150 64 -150 150s100 222 100 250s-22 50 -50 50
+s-50 -22 -50 -50h-100c0 83 67 150 150 150z" />
+    <glyph glyph-name="7d" unicode="&#xe07d;" 
+d="M200 800h500v-100h-122c-77 -197 -156 -392 -234 -588l-6 -12h162v-100h-500v100h122c77 197 156 392 234 588l7 12h-163v100z" />
+    <glyph glyph-name="7e" unicode="&#xe07e;" 
+d="M0 700h800v-100h-800v100zM0 500h800v-100h-800v100zM0 300h800v-100h-800v100zM100 100h600v-100h-600v100z" />
+    <glyph glyph-name="7f" unicode="&#xe07f;" 
+d="M0 700h800v-100h-800v100zM0 500h800v-100h-800v100zM0 300h800v-100h-800v100zM0 100h600v-100h-600v100z" />
+    <glyph glyph-name="80" unicode="&#xe080;" 
+d="M0 700h800v-100h-800v100zM0 500h800v-100h-800v100zM0 300h800v-100h-800v100zM200 100h600v-100h-600v100z" />
+    <glyph glyph-name="81" unicode="&#xe081;" 
+d="M550 800c138 0 250 -112 250 -250s-112 -250 -250 -250c-16 0 -32 0 -47 3l-3 -3v-100h-200v-200h-300v200l303 303c-3 15 -3 31 -3 47c0 138 112 250 250 250zM600 700c-55 0 -100 -45 -100 -100s45 -100 100 -100s100 45 100 100s-45 100 -100 100z" />
+    <glyph glyph-name="82" unicode="&#xe082;" 
+d="M134 600h3h4h4h5h500c28 0 50 -22 50 -50v-350h100v-150c0 -28 -22 -50 -50 -50h-700c-28 0 -50 22 -50 50v150h100v350v2c0 20 15 42 34 48zM200 500v-300h100v-100h200v100h100v300h-400z" />
+    <glyph glyph-name="83" unicode="&#xe083;" 
+d="M0 800h400v-400h-400v400zM500 600h100v-400h-400v100h300v300zM700 400h100v-400h-400v100h300v300z" />
+    <glyph glyph-name="84" unicode="&#xe084;" horiz-adv-x="600" 
+d="M337 694c6 4 12 7 21 7c28 0 50 -22 50 -50c0 -17 -12 -37 -27 -45l-300 -150c-8 -6 -21 -11 -31 -11c-28 0 -50 22 -50 50c0 21 16 44 37 49zM437 544c6 4 12 7 21 7c28 0 50 -22 50 -50c0 -17 -12 -37 -27 -45l-400 -200c-8 -6 -21 -11 -31 -11c-28 0 -50 22 -50 50
+c0 21 16 44 37 49zM437 344c6 4 12 7 21 7c28 0 50 -22 50 -50c0 -17 -12 -37 -27 -45l-106 -56c24 -4 43 -26 43 -50c0 -28 -23 -51 -51 -51c-2 0 -6 1 -8 1h-200c-26 1 -48 24 -48 50c0 16 12 36 26 44zM151 -50c0 23 20 50 46 50h3h4h5h100c28 0 50 -22 50 -50
+s-22 -50 -50 -50h-100c-2 0 -6 -1 -8 -1c-28 0 -50 23 -50 51z" />
+    <glyph glyph-name="85" unicode="&#xe085;" 
+d="M199 800h100v-200h-200v100h100v100zM586 797h1c18 1 38 1 56 -3c36 -8 69 -26 97 -54c78 -78 78 -203 0 -281l-150 -150c-8 -13 -28 -24 -43 -24c-28 0 -50 22 -50 50c0 15 11 35 24 43l150 150c40 40 39 105 0 144c-41 41 -110 34 -144 0l-44 -44
+c-8 -13 -27 -24 -42 -24c-28 0 -50 22 -50 50c0 15 11 35 24 43l43 44c32 33 72 53 128 56zM208 490c4 5 14 16 22 16h3c2 0 6 1 8 1c28 0 50 -22 50 -50c0 -11 -6 -27 -14 -35l-150 -150c-40 -40 -39 -105 0 -144c41 -41 110 -34 144 0l44 44c8 13 27 24 42 24
+c28 0 50 -22 50 -50c0 -15 -11 -35 -24 -43l-43 -44c-22 -22 -48 -37 -75 -47c-70 -25 -151 -9 -207 47c-78 78 -78 203 0 281zM499 200h200v-100h-100v-100h-100v200z" />
+    <glyph glyph-name="86" unicode="&#xe086;" 
+d="M586 797c18 1 39 1 57 -3c36 -8 69 -26 97 -54c78 -78 78 -203 0 -281l-150 -150c-62 -62 -132 -81 -182 -78s-69 17 -84 25s-26 27 -26 44c0 28 22 51 50 51c8 0 19 -3 26 -7c0 0 15 -11 41 -13s62 3 106 47l150 150c40 40 39 105 0 144c-41 41 -110 34 -144 0
+c-8 -13 -28 -24 -43 -24c-28 0 -50 22 -50 50c0 15 11 35 24 43c32 33 72 53 128 56zM386 566c50 -2 64 -17 85 -22s37 -28 37 -49c0 -28 -22 -50 -50 -50c-10 0 -23 5 -31 11c0 0 -19 9 -47 10s-63 -4 -103 -44l-150 -150c-40 -40 -39 -105 0 -144c41 -41 110 -34 144 0
+c8 13 27 24 42 24c28 0 50 -22 50 -50c0 -15 -10 -35 -23 -43c-22 -22 -48 -37 -75 -47c-70 -25 -151 -9 -207 47c-78 78 -78 203 0 281l150 150c60 60 128 78 178 76z" />
+    <glyph glyph-name="87" unicode="&#xe087;" 
+d="M0 700h300v-300h-300v300zM400 700h400v-100h-400v100zM400 500h300v-100h-300v100zM0 300h300v-300h-300v300zM400 300h400v-100h-400v100zM400 100h300v-100h-300v100z" />
+    <glyph glyph-name="88" unicode="&#xe088;" 
+d="M50 700c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM200 700h600v-100h-600v100zM50 500c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM200 500h600v-100h-600v100zM50 300c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50
+s22 50 50 50zM200 300h600v-100h-600v100zM50 100c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM200 100h600v-100h-600v100z" />
+    <glyph glyph-name="89" unicode="&#xe089;" 
+d="M800 800l-400 -800l-100 300l-300 100z" />
+    <glyph glyph-name="8a" unicode="&#xe08a;" horiz-adv-x="600" 
+d="M300 700c110 0 200 -90 200 -200v-100h100v-400h-600v400h100v100c0 110 90 200 200 200zM300 600c-56 0 -100 -44 -100 -100v-100h200v100c0 56 -44 100 -100 100z" />
+    <glyph glyph-name="8b" unicode="&#xe08b;" horiz-adv-x="600" 
+d="M300 800c110 0 200 -90 200 -200v-200h100v-400h-600v400h400v200c0 56 -44 100 -100 100s-100 -44 -100 -100h-100c0 110 90 200 200 200z" />
+    <glyph glyph-name="8c" unicode="&#xe08c;" 
+d="M400 700v-100c-111 0 -200 -89 -200 -200h100l-150 -200l-150 200h100c0 165 135 300 300 300zM650 600l150 -200h-100c0 -165 -135 -300 -300 -300v100c111 0 200 89 200 200h-100z" />
+    <glyph glyph-name="8d" unicode="&#xe08d;" 
+d="M100 800h600v-300h100l-150 -250l-150 250h100v200h-400v-100h-100v200zM150 550l150 -250h-100v-200h400v100h100v-200h-600v300h-100z" />
+    <glyph glyph-name="8e" unicode="&#xe08e;" 
+d="M600 700l200 -150l-200 -150v100h-500v-100h-100v100c0 55 45 100 100 100h500v100zM200 300v-100h500v100h100v-100c0 -55 -45 -100 -100 -100h-500v-100l-200 150z" />
+    <glyph glyph-name="8f" unicode="&#xe08f;" horiz-adv-x="900" 
+d="M350 800c193 0 350 -157 350 -350c0 -60 -17 -117 -44 -166c5 -3 12 -8 16 -12l100 -100c16 -16 30 -49 30 -72c0 -56 -46 -102 -102 -102c-23 0 -56 14 -72 30l-100 100c-4 3 -9 9 -12 13c-49 -26 -107 -41 -166 -41c-193 0 -350 157 -350 350s157 350 350 350zM350 200
+c142 0 250 108 250 250c0 139 -111 250 -250 250s-250 -111 -250 -250s111 -250 250 -250z" />
+    <glyph glyph-name="90" unicode="&#xe090;" horiz-adv-x="600" 
+d="M300 800c166 0 300 -134 300 -300c0 -200 -300 -500 -300 -500s-300 300 -300 500c0 166 134 300 300 300zM300 700c-110 0 -200 -90 -200 -200s90 -200 200 -200s200 90 200 200s-90 200 -200 200z" />
+    <glyph glyph-name="91" unicode="&#xe091;" horiz-adv-x="900" 
+d="M0 800h800v-541c1 -3 1 -8 1 -11s0 -7 -1 -10v-238h-800v800zM495 250c0 26 22 50 50 50h5h150v400h-600v-600h600v100h-150h-5c-28 0 -50 22 -50 50zM350 600c83 0 150 -67 150 -150c0 -100 -150 -250 -150 -250s-150 150 -150 250c0 83 67 150 150 150zM350 500
+c-28 0 -50 -22 -50 -50s22 -50 50 -50s50 22 50 50s-22 50 -50 50z" />
+    <glyph glyph-name="92" unicode="&#xe092;" horiz-adv-x="600" 
+d="M0 700h200v-600h-200v600zM400 700h200v-600h-200v600z" />
+    <glyph glyph-name="93" unicode="&#xe093;" horiz-adv-x="600" 
+d="M0 700l600 -300l-600 -300v600z" />
+    <glyph glyph-name="94" unicode="&#xe094;" horiz-adv-x="600" 
+d="M300 700c166 0 300 -134 300 -300s-134 -300 -300 -300s-300 134 -300 300s134 300 300 300z" />
+    <glyph glyph-name="95" unicode="&#xe095;" 
+d="M400 700v-600l-400 300zM400 400l400 300v-600z" />
+    <glyph glyph-name="96" unicode="&#xe096;" 
+d="M0 700l400 -300l-400 -300v600zM400 100v600l400 -300z" />
+    <glyph glyph-name="97" unicode="&#xe097;" 
+d="M0 700h200v-600h-200v600zM200 400l500 300v-600z" />
+    <glyph glyph-name="98" unicode="&#xe098;" 
+d="M0 700l500 -300l-500 -300v600zM500 100v600h200v-600h-200z" />
+    <glyph glyph-name="99" unicode="&#xe099;" horiz-adv-x="600" 
+d="M0 700h600v-600h-600v600z" />
+    <glyph glyph-name="9a" unicode="&#xe09a;" 
+d="M200 800h400v-200h200v-400h-200v-200h-400v200h-200v400h200v200z" />
+    <glyph glyph-name="9b" unicode="&#xe09b;" 
+d="M0 700h800v-100h-800v100zM0 403h800v-100h-800v100zM0 103h800v-100h-800v100z" />
+    <glyph glyph-name="9c" unicode="&#xe09c;" horiz-adv-x="600" 
+d="M278 700c7 2 13 4 22 4c55 0 100 -45 100 -100v-4v-200c0 -55 -45 -100 -100 -100s-100 45 -100 100v200v2c0 44 35 88 78 98zM34 500h4h3c3 0 6 1 9 1c28 0 50 -22 50 -50v-1v-50c0 -111 89 -200 200 -200s200 89 200 200v50c0 28 22 50 50 50s50 -22 50 -50v-50
+c0 -148 -109 -270 -250 -294v-106h50c55 0 100 -45 100 -100h-400c0 55 45 100 100 100h50v106c-141 24 -250 146 -250 294v50v2c0 20 15 42 34 48z" />
+    <glyph glyph-name="9d" unicode="&#xe09d;" 
+d="M0 500h800v-200h-800v200z" />
+    <glyph glyph-name="9e" unicode="&#xe09e;" 
+d="M34 700h4h3h4h5h700c28 0 50 -22 50 -50v-500c0 -28 -22 -50 -50 -50h-250v-100h100c55 0 100 -45 100 -100h-600c0 55 45 100 100 100h100v100h-250c-28 0 -50 22 -50 50v500v2c0 20 15 42 34 48zM100 600v-400h600v400h-600z" />
+    <glyph glyph-name="9f" unicode="&#xe09f;" 
+d="M272 700c-14 -40 -22 -83 -22 -128c0 -221 179 -400 400 -400c45 0 88 8 128 22c-53 -158 -202 -272 -378 -272c-221 0 -400 179 -400 400c0 176 114 325 272 378z" />
+    <glyph glyph-name="a0" unicode="&#xe0a0;" 
+d="M350 700l150 -150h-100v-150h150v100l150 -150l-150 -150v100h-150v-150h100l-150 -150l-150 150h100v150h-150v-100l-150 150l150 150v-100h150v150h-100z" />
+    <glyph glyph-name="a1" unicode="&#xe0a1;" 
+d="M800 800v-550c0 -83 -67 -150 -150 -150s-150 67 -150 150s67 150 150 150c17 0 35 -4 50 -9v206c-201 -6 -327 -27 -400 -50v-397c0 -83 -67 -150 -150 -150s-150 67 -150 150s67 150 150 150c17 0 35 -4 50 -9v409s100 100 600 100z" />
+    <glyph glyph-name="a2" unicode="&#xe0a2;" horiz-adv-x="700" 
+d="M499 700c51 0 102 -20 141 -59c78 -78 78 -203 0 -281l-250 -244c-48 -48 -127 -48 -175 0s-48 127 0 175l96 97l69 -69l-90 -94l-7 -3c-10 -10 -10 -28 0 -38s28 -10 38 0l250 247c37 40 39 102 0 141s-104 40 -144 0l-278 -275c-66 -69 -68 -179 0 -247
+c69 -69 181 -69 250 0l9 12l116 113l69 -69l-125 -125c-107 -107 -281 -107 -388 0s-107 281 0 388l278 272c39 39 90 59 141 59z" />
+    <glyph glyph-name="a3" unicode="&#xe0a3;" 
+d="M600 800l200 -200l-100 -100l-200 200zM400 600l200 -200l-400 -400h-200v200z" />
+    <glyph glyph-name="a4" unicode="&#xe0a4;" 
+d="M550 800c83 0 150 -90 150 -200s-67 -200 -150 -200c-22 0 -40 8 -59 19c6 26 9 52 9 81c0 84 -27 158 -72 212c27 52 71 88 122 88zM250 700c83 0 150 -90 150 -200s-67 -200 -150 -200s-150 90 -150 200s67 200 150 200zM725 384c44 -22 75 -66 75 -118v-166h-200v66
+c0 50 -17 96 -44 134c66 2 126 33 169 84zM75 284c45 -53 106 -84 175 -84s130 31 175 84c44 -22 75 -66 75 -118v-166h-500v166c0 52 31 96 75 118z" />
+    <glyph glyph-name="a5" unicode="&#xe0a5;" 
+d="M400 800c110 0 200 -112 200 -250s-90 -250 -200 -250s-200 112 -200 250s90 250 200 250zM191 300c54 -61 128 -100 209 -100s155 39 209 100c106 -5 191 -92 191 -200v-100h-800v100c0 108 85 195 191 200z" />
+    <glyph glyph-name="a6" unicode="&#xe0a6;" horiz-adv-x="600" 
+d="M19 800h462c11 0 19 -8 19 -19v-762c0 -11 -8 -19 -19 -19h-462c-11 0 -19 8 -19 19v762c0 11 8 19 19 19zM100 700v-500h300v500h-300zM250 150c-28 0 -50 -22 -50 -50s22 -50 50 -50s50 22 50 50s-22 50 -50 50z" />
+    <glyph glyph-name="a7" unicode="&#xe0a7;" 
+d="M350 800c17 0 34 -1 50 -3v-397l-297 297c63 64 150 103 247 103zM500 694c169 -25 300 -168 300 -344c0 -193 -157 -350 -350 -350c-85 0 -161 31 -222 81l272 272v341zM91 562l237 -234l-212 -212c-70 55 -116 138 -116 234c0 84 35 158 91 212z" />
+    <glyph glyph-name="a8" unicode="&#xe0a8;" 
+d="M92 650c0 23 20 50 46 50h3h4h5h400c28 0 50 -22 50 -50s-22 -50 -50 -50h-50v-200h100c55 0 100 -45 100 -100h-300v-300l-56 -100l-44 100v300h-300c0 55 45 100 100 100h100v200h-50c-2 0 -6 -1 -8 -1c-28 0 -50 23 -50 51z" />
+    <glyph glyph-name="a9" unicode="&#xe0a9;" 
+d="M400 800c221 0 400 -179 400 -400s-179 -400 -400 -400s-400 179 -400 400s179 400 400 400zM300 600v-400l300 200z" />
+    <glyph glyph-name="aa" unicode="&#xe0aa;" 
+d="M300 800h200v-300h300v-200h-300v-300h-200v300h-300v200h300v300z" />
+    <glyph glyph-name="ab" unicode="&#xe0ab;" 
+d="M300 800h100v-400h-100v400zM172 656l62 -78l-40 -31c-58 -46 -94 -117 -94 -197c0 -139 111 -250 250 -250s250 111 250 250c0 80 -39 151 -97 197l-37 31l62 78l38 -31c82 -64 134 -164 134 -275c0 -193 -157 -350 -350 -350s-350 157 -350 350c0 111 53 211 134 275z
+" />
+    <glyph glyph-name="ac" unicode="&#xe0ac;" 
+d="M200 800h400v-200h-400v200zM9 500h782c6 0 9 -3 9 -9v-282c0 -6 -3 -9 -9 -9h-91v200h-600v-200h-91c-6 0 -9 3 -9 9v282c0 6 3 9 9 9zM200 300h400v-300h-400v300z" />
+    <glyph glyph-name="ad" unicode="&#xe0ad;" 
+d="M0 700h100v-700h-100v700zM700 700h100v-700h-100v700zM200 600h200v-100h-200v100zM300 400h200v-100h-200v100zM400 200h200v-100h-200v100z" />
+    <glyph glyph-name="ae" unicode="&#xe0ae;" 
+d="M325 700c42 -141 87 -280 131 -419c29 74 59 148 88 222c30 -57 58 -114 87 -172h169v-100h-231l-13 28c-37 -92 -74 -184 -112 -275c-38 129 -79 257 -119 385c-42 -133 -83 -267 -125 -400c-28 88 -56 175 -84 262h-116v100h188l9 -34l3 -6c42 137 83 273 125 409z" />
+    <glyph glyph-name="af" unicode="&#xe0af;" 
+d="M200 600c0 57 43 100 100 100s100 -43 100 -100c0 -28 -18 -48 -28 -72c-3 -6 -3 -16 -3 -28h231v-231c12 0 22 0 28 3c24 10 44 28 72 28c57 0 100 -43 100 -100s-43 -100 -100 -100c-28 0 -48 18 -72 28c-6 3 -16 3 -28 3v-231h-231c0 12 0 22 3 28c10 24 28 44 28 72
+c0 57 -43 100 -100 100s-100 -43 -100 -100c0 -28 18 -48 28 -72c3 -6 3 -16 3 -28h-231v600h231c0 12 0 22 -3 28c-10 24 -28 44 -28 72z" />
+    <glyph glyph-name="b0" unicode="&#xe0b0;" horiz-adv-x="500" 
+d="M247 700c84 0 148 -20 191 -59s59 -93 59 -141c0 -117 -69 -181 -119 -225s-81 -67 -81 -150v-25h-100v25c0 117 65 181 115 225s85 67 85 150c0 25 -8 48 -28 66s-56 34 -122 34s-97 -18 -116 -37s-27 -43 -31 -69l-100 12c5 38 19 88 59 128s103 66 188 66zM197 0h100
+v-100h-100v100z" />
+    <glyph glyph-name="b1" unicode="&#xe0b1;" 
+d="M450 800c138 0 250 -112 250 -250v-50c58 -21 100 -85 100 -150c0 -69 -48 -127 -112 -144c-22 55 -75 94 -138 94c-20 0 -39 -5 -56 -12c-17 64 -75 112 -144 112s-127 -48 -144 -112c-17 7 -36 12 -56 12c-37 0 -71 -12 -97 -34c-33 36 -53 82 -53 134
+c0 110 90 200 200 200c23 114 129 200 250 200zM334 300h4h3c3 0 6 1 9 1c28 0 50 -22 50 -50v-1v-200c0 -28 -22 -50 -50 -50s-50 22 -50 50v200v2c0 20 15 42 34 48zM134 200h4h3c3 0 6 1 9 1c28 0 50 -22 50 -50v-1v-100c0 -28 -22 -50 -50 -50s-50 22 -50 50v100v2
+c0 20 15 42 34 48zM534 200h3h4c3 0 6 1 9 1c28 0 50 -22 50 -50v-1v-100c0 -28 -22 -50 -50 -50s-50 22 -50 50v100v2c0 20 15 42 34 48z" />
+    <glyph glyph-name="b2" unicode="&#xe0b2;" 
+d="M600 800l200 -150l-200 -150v100h-50l-153 -191l175 -206l6 -3h22v100l200 -150l-200 -150v100h-25c-35 0 -56 12 -78 38l-166 190l-153 -190c-22 -27 -43 -38 -78 -38h-100v100h100l166 206l-163 191l-3 3h-100v100h100c34 0 56 -12 78 -38l153 -178l141 178
+c22 27 43 38 78 38h50v100z" />
+    <glyph glyph-name="b3" unicode="&#xe0b3;" 
+d="M400 800c110 0 209 -47 281 -119l119 119v-300h-300l109 109c-54 55 -126 91 -209 91c-166 0 -300 -134 -300 -300s134 -300 300 -300c83 0 158 34 212 88l72 -72c-72 -72 -174 -116 -284 -116c-220 0 -400 180 -400 400s180 400 400 400z" />
+    <glyph glyph-name="b4" unicode="&#xe0b4;" 
+d="M400 800h400v-400l-166 166l-400 -400l166 -166h-400v400l166 -166l400 400z" />
+    <glyph glyph-name="b5" unicode="&#xe0b5;" horiz-adv-x="600" 
+d="M250 800l250 -300h-200v-200h200l-250 -300l-250 300h200v200h-200z" />
+    <glyph glyph-name="b6" unicode="&#xe0b6;" 
+d="M300 600v-200h200v200l300 -250l-300 -250v200h-200v-200l-300 250z" />
+    <glyph glyph-name="b7" unicode="&#xe0b7;" 
+d="M0 800c441 0 800 -359 800 -800h-200c0 333 -267 600 -600 600v200zM0 500c275 0 500 -225 500 -500h-200c0 167 -133 300 -300 300v200zM0 200c110 0 200 -90 200 -200h-200v200z" />
+    <glyph glyph-name="b8" unicode="&#xe0b8;" 
+d="M100 800c386 0 700 -314 700 -700h-100c0 332 -268 600 -600 600v100zM100 600c276 0 500 -224 500 -500h-100c0 222 -178 400 -400 400v100zM100 400c165 0 300 -135 300 -300h-100c0 111 -89 200 -200 200v100zM100 200c55 0 100 -45 100 -100s-45 -100 -100 -100
+s-100 45 -100 100s45 100 100 100z" />
+    <glyph glyph-name="b9" unicode="&#xe0b9;" 
+d="M300 800h400c55 0 100 -45 100 -100v-200h-400v150c0 28 -22 50 -50 50s-50 -22 -50 -50v-250h400v-300c0 -55 -45 -100 -100 -100h-500c-55 0 -100 45 -100 100v200h100v-150c0 -28 22 -50 50 -50s50 22 50 50v550c0 55 45 100 100 100z" />
+    <glyph glyph-name="ba" unicode="&#xe0ba;" 
+d="M75 700h225v-100h-200v-500h400v100h100v-125c0 -41 -34 -75 -75 -75h-450c-41 0 -75 34 -75 75v550c0 41 34 75 75 75zM600 700l200 -200l-200 -200v100h-200c-94 0 -173 -65 -194 -153c23 199 189 353 394 353v100z" />
+    <glyph glyph-name="bb" unicode="&#xe0bb;" 
+d="M500 700l300 -284l-300 -316v200h-100c-200 0 -348 -102 -400 -300c0 295 100 500 500 500v200z" />
+    <glyph glyph-name="bc" unicode="&#xe0bc;" 
+d="M381 791l19 9l19 -9c127 -53 253 -108 381 -160v-31c0 -166 -67 -313 -147 -419c-40 -53 -83 -97 -125 -128s-82 -53 -128 -53s-86 22 -128 53s-85 75 -125 128c-80 107 -147 253 -147 419v31c128 52 254 107 381 160zM400 100v591l-294 -122c8 -126 58 -243 122 -328
+c35 -46 73 -86 106 -110s62 -31 66 -31z" />
+    <glyph glyph-name="bd" unicode="&#xe0bd;" 
+d="M600 800h100v-800h-100v800zM400 700h100v-700h-100v700zM200 500h100v-500h-100v500zM0 300h100v-300h-100v300z" />
+    <glyph glyph-name="be" unicode="&#xe0be;" 
+d="M300 800h100v-200h200l100 -100l-100 -100h-200v-400h-100v500h-200l-100 100l100 100h200v100z" />
+    <glyph glyph-name="bf" unicode="&#xe0bf;" 
+d="M200 800h100v-600h200l-250 -200l-250 200h200v600zM400 800h200v-100h-200v100zM400 600h300v-100h-300v100zM400 400h400v-100h-400v100z" />
+    <glyph glyph-name="c0" unicode="&#xe0c0;" 
+d="M200 800h100v-600h200l-250 -200l-250 200h200v600zM400 800h400v-100h-400v100zM400 600h300v-100h-300v100zM400 400h200v-100h-200v100z" />
+    <glyph glyph-name="c1" unicode="&#xe0c1;" 
+d="M75 700h650c41 0 75 -34 75 -75v-550c0 -41 -34 -75 -75 -75h-650c-41 0 -75 34 -75 75v550c0 41 34 75 75 75zM100 600v-100h100v100h-100zM300 600v-100h400v100h-400zM100 400v-100h100v100h-100zM300 400v-100h400v100h-400zM100 200v-100h100v100h-100zM300 200
+v-100h400v100h-400z" />
+    <glyph glyph-name="c2" unicode="&#xe0c2;" 
+d="M400 800l100 -300h300l-250 -200l100 -300l-250 200l-250 -200l100 300l-250 200h300z" />
+    <glyph glyph-name="c3" unicode="&#xe0c3;" 
+d="M400 800c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM150 700c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM650 700c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM400 600c110 0 200 -90 200 -200
+s-90 -200 -200 -200s-200 90 -200 200s90 200 200 200zM50 450c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM750 450c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM150 200c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50
+s22 50 50 50zM650 200c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM400 100c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50z" />
+    <glyph glyph-name="c4" unicode="&#xe0c4;" 
+d="M34 800h632c18 0 34 -16 34 -34v-732c0 -18 -16 -34 -34 -34h-632c-18 0 -34 16 -34 34v732c0 18 16 34 34 34zM100 700v-500h500v500h-500zM350 150c-38 0 -63 -42 -44 -75s69 -33 88 0s-6 75 -44 75z" />
+    <glyph glyph-name="c5" unicode="&#xe0c5;" 
+d="M0 800h300l500 -500l-300 -300l-500 500v300zM200 700c-55 0 -100 -45 -100 -100s45 -100 100 -100s100 45 100 100s-45 100 -100 100z" />
+    <glyph glyph-name="c6" unicode="&#xe0c6;" 
+d="M0 600h200l300 -300l-200 -200l-300 300v200zM340 600h160l300 -300l-200 -200l-78 78l119 122zM150 500c-28 0 -50 -22 -50 -50s22 -50 50 -50s50 22 50 50s-22 50 -50 50z" />
+    <glyph glyph-name="c7" unicode="&#xe0c7;" 
+d="M400 800c220 0 400 -180 400 -400s-180 -400 -400 -400s-400 180 -400 400s180 400 400 400zM400 700c-166 0 -300 -134 -300 -300s134 -300 300 -300s300 134 300 300s-134 300 -300 300zM400 600c110 0 200 -90 200 -200s-90 -200 -200 -200s-200 90 -200 200
+s90 200 200 200zM400 500c-56 0 -100 -44 -100 -100s44 -100 100 -100s100 44 100 100s-44 100 -100 100z" />
+    <glyph glyph-name="c8" unicode="&#xe0c8;" 
+d="M0 700h559l-100 -100h-359v-500h500v159l100 100v-359h-700v700zM700 700l100 -100l-400 -400l-200 200l100 100l100 -100z" />
+    <glyph glyph-name="c9" unicode="&#xe0c9;" 
+d="M9 800h782c6 0 9 -3 9 -9v-782c0 -6 -3 -9 -9 -9h-782c-6 0 -9 3 -9 9v782c0 6 3 9 9 9zM150 722l-72 -72l100 -100l-100 -100l72 -72l172 172zM400 500v-100h300v100h-300z" />
+    <glyph glyph-name="ca" unicode="&#xe0ca;" 
+d="M0 800h800v-200h-50c0 55 -45 100 -100 100h-150v-550c0 -28 22 -50 50 -50h50v-100h-400v100h50c28 0 50 22 50 50v550h-150c-55 0 -100 -45 -100 -100h-50v200z" />
+    <glyph glyph-name="cb" unicode="&#xe0cb;" 
+d="M0 700h100v-400h-100v400zM200 700h350c21 0 39 -13 47 -31c0 0 103 -291 103 -319s-22 -50 -50 -50h-150c-28 0 -50 -25 -50 -50s39 -158 47 -184s-5 -55 -31 -63s-52 5 -66 31s-109 219 -128 238s-44 28 -72 28v400z" />
+    <glyph glyph-name="cc" unicode="&#xe0cc;" 
+d="M400 666c10 19 28 32 47 34l19 -3c26 -8 39 -37 31 -63s-47 -159 -47 -184s22 -50 50 -50h150c28 0 50 -22 50 -50s-103 -319 -103 -319c-8 -18 -26 -31 -47 -31h-350v400c28 0 53 9 72 28s114 212 128 238zM0 400h100v-400h-100v400z" />
+    <glyph glyph-name="cd" unicode="&#xe0cd;" 
+d="M200 700h300v-100h-100v-6c25 -4 50 -8 72 -16l-34 -94c-28 11 -58 16 -88 16c-139 0 -250 -111 -250 -250s111 -250 250 -250s250 111 250 250c0 31 -5 60 -16 88l91 37c14 -38 25 -81 25 -125c0 -193 -157 -350 -350 -350s-350 157 -350 350c0 176 130 323 300 347v3
+h-100v100zM700 584c0 0 -296 -348 -316 -368s-48 -20 -68 0s-20 48 0 68s384 300 384 300z" />
+    <glyph glyph-name="ce" unicode="&#xe0ce;" 
+d="M600 700l200 -150l-200 -150v100h-600v100h600v100zM200 300v-100h600v-100h-600v-100l-200 150z" />
+    <glyph glyph-name="cf" unicode="&#xe0cf;" 
+d="M300 800h100c55 0 100 -45 100 -100h100c55 0 100 -45 100 -100h-700c0 55 45 100 100 100h100c0 55 45 100 100 100zM100 500h100v-350c0 -28 22 -50 50 -50s50 22 50 50v350h100v-350c0 -28 22 -50 50 -50s50 22 50 50v350h100v-481c0 -11 -8 -19 -19 -19h-462
+c-11 0 -19 8 -19 19v481z" />
+    <glyph glyph-name="d0" unicode="&#xe0d0;" 
+d="M100 800h200v-400c0 -55 45 -100 100 -100s100 45 100 100v400h100v-400c0 -110 -90 -200 -200 -200h-50c-138 0 -250 90 -250 200v400zM0 100h700v-100h-700v100z" />
+    <glyph glyph-name="d1" unicode="&#xe0d1;" 
+d="M9 700h182c6 0 9 -3 9 -9v-482c0 -6 -3 -9 -9 -9h-182c-6 0 -9 3 -9 9v482c0 6 3 9 9 9zM609 700h182c6 0 9 -3 9 -9v-482c0 -6 -3 -9 -9 -9h-182c-6 0 -9 3 -9 9v482c0 6 3 9 9 9zM309 500h182c6 0 9 -3 9 -9v-282c0 -6 -3 -9 -9 -9h-182c-6 0 -9 3 -9 9v282
+c0 6 3 9 9 9zM0 100h800v-100h-800v100z" />
+    <glyph glyph-name="d2" unicode="&#xe0d2;" 
+d="M10 700h181c6 0 9 -3 9 -9v-191h-200v191c0 6 4 9 10 9zM610 700h181c6 0 9 -3 9 -9v-191h-200v191c0 6 5 9 10 9zM310 600h181c6 0 9 -3 9 -9v-91h-200v91c0 6 4 9 10 9zM0 400h800v-100h-800v100zM0 200h200v-191c0 -6 -3 -9 -9 -9h-182c-6 0 -9 3 -9 9v191zM300 200
+h200v-91c0 -6 -3 -9 -9 -9h-181c-6 0 -10 3 -10 9v91zM600 200h200v-191c0 -6 -3 -9 -9 -9h-181c-6 0 -10 3 -10 9v191z" />
+    <glyph glyph-name="d3" unicode="&#xe0d3;" 
+d="M0 700h800v-100h-800v100zM9 500h182c6 0 9 -3 9 -9v-482c0 -6 -3 -9 -9 -9h-182c-6 0 -9 3 -9 9v482c0 6 3 9 9 9zM309 500h182c6 0 9 -3 9 -9v-282c0 -6 -3 -9 -9 -9h-182c-6 0 -9 3 -9 9v282c0 6 3 9 9 9zM609 500h182c6 0 9 -3 9 -9v-482c0 -6 -3 -9 -9 -9h-182
+c-6 0 -9 3 -9 9v482c0 6 3 9 9 9z" />
+    <glyph glyph-name="d4" unicode="&#xe0d4;" 
+d="M50 600h500c28 0 50 -22 50 -50v-150l100 100h100v-300h-100l-100 100v-150c0 -28 -22 -50 -50 -50h-500c-28 0 -50 22 -50 50v400c0 28 22 50 50 50z" />
+    <glyph glyph-name="d5" unicode="&#xe0d5;" 
+d="M334 800h66v-800h-66l-134 200h-200v400h200zM500 600v100c26 0 52 -4 75 -10c130 -33 225 -150 225 -290s-95 -258 -225 -291h-3c-23 -6 -47 -9 -72 -9v100c17 0 34 2 50 6c86 22 150 100 150 194s-64 172 -150 194c-16 4 -33 6 -50 6zM500 500l25 -3
+c44 -11 75 -51 75 -97s-32 -86 -75 -97l-25 -3v200z" />
+    <glyph glyph-name="d6" unicode="&#xe0d6;" horiz-adv-x="600" 
+d="M334 800h66v-800h-66l-134 200h-200v400h200zM500 500l25 -3c44 -11 75 -51 75 -97s-32 -86 -75 -97l-25 -3v200z" />
+    <glyph glyph-name="d7" unicode="&#xe0d7;" horiz-adv-x="400" 
+d="M334 800h66v-800h-66l-134 200h-200v400h200z" />
+    <glyph glyph-name="d8" unicode="&#xe0d8;" 
+d="M309 800h82c6 0 10 -4 12 -9l294 -682l3 -19v-81c0 -6 -3 -9 -9 -9h-682c-6 0 -9 3 -9 9v81l3 19l294 682c2 5 6 9 12 9zM300 500v-200h100v200h-100zM300 200v-100h100v100h-100z" />
+    <glyph glyph-name="d9" unicode="&#xe0d9;" 
+d="M375 800c138 0 269 -39 378 -109l-53 -82c-93 60 -205 91 -325 91c-119 0 -229 -32 -322 -91l-53 82c109 70 237 109 375 109zM375 500c78 0 154 -23 216 -62l-53 -85c-46 30 -104 47 -163 47c-60 0 -112 -17 -159 -47l-54 85c62 40 134 62 213 62zM375 200
+c55 0 100 -45 100 -100s-45 -100 -100 -100s-100 45 -100 100s45 100 100 100z" />
+    <glyph glyph-name="da" unicode="&#xe0da;" horiz-adv-x="900" 
+d="M551 800c16 0 32 0 47 -3l-97 -97v-200h200l97 97c3 -15 3 -31 3 -47c0 -138 -112 -250 -250 -250c-32 0 -62 8 -90 19l-288 -291c-20 -20 -46 -28 -72 -28s-52 8 -72 28c-39 39 -39 105 0 144l291 287c-11 28 -19 59 -19 91c0 138 112 250 250 250zM101 150
+c-28 0 -50 -22 -50 -50s22 -50 50 -50s50 22 50 50s-22 50 -50 50z" />
+    <glyph glyph-name="db" unicode="&#xe0db;" 
+d="M141 700c84 -84 169 -167 253 -250c82 83 167 165 247 250l143 -141l-253 -253c84 -82 167 -166 253 -247l-143 -143c-81 86 -165 169 -247 253l-253 -253l-141 143c85 80 167 164 250 247c-83 84 -166 169 -250 253z" />
+    <glyph glyph-name="dc" unicode="&#xe0dc;" 
+d="M0 800h100l231 -300h38l231 300h100l-225 -300h225v-100h-300v-100h300v-100h-300v-200h-100v200h-300v100h300v100h-300v100h225z" />
+    <glyph glyph-name="dd" unicode="&#xe0dd;" horiz-adv-x="900" 
+d="M350 800c193 0 350 -157 350 -350c0 -61 -17 -119 -44 -169c4 -2 10 -6 13 -9l103 -100c16 -16 30 -49 30 -72c0 -56 -46 -102 -102 -102c-23 0 -56 14 -72 30l-100 103c-3 3 -7 9 -9 13c-50 -28 -108 -44 -169 -44c-193 0 -350 157 -350 350s157 350 350 350zM350 700
+c-139 0 -250 -111 -250 -250s111 -250 250 -250c62 0 119 23 163 60c7 11 19 25 31 31l3 3c34 43 53 97 53 156c0 139 -111 250 -250 250zM300 600h100v-100h100v-100h-100v-100h-100v100h-100v100h100v100z" />
+    <glyph glyph-name="de" unicode="&#xe0de;" horiz-adv-x="900" 
+d="M350 800c193 0 350 -157 350 -350c0 -61 -17 -119 -44 -169c4 -2 10 -6 13 -9l103 -100c16 -16 30 -49 30 -72c0 -56 -46 -102 -102 -102c-23 0 -56 14 -72 30l-100 103c-3 3 -7 9 -9 13c-50 -28 -108 -44 -169 -44c-193 0 -350 157 -350 350s157 350 350 350zM350 700
+c-139 0 -250 -111 -250 -250s111 -250 250 -250c62 0 119 23 163 60c7 11 19 25 31 31l3 3c34 43 53 97 53 156c0 139 -111 250 -250 250zM200 500h300v-100h-300v100z" />
+  </font>
+</defs></svg>
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/font/fonts/open-iconic.ttf b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/font/fonts/open-iconic.ttf
new file mode 100644
index 0000000000..fab604866c
Binary files /dev/null and b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/font/fonts/open-iconic.ttf differ
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/font/fonts/open-iconic.woff b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/font/fonts/open-iconic.woff
new file mode 100644
index 0000000000..f9309988ae
Binary files /dev/null and b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/open-iconic/font/fonts/open-iconic.woff differ
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/site.css b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/site.css
new file mode 100644
index 0000000000..1f4b8cf316
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/css/site.css
@@ -0,0 +1,64 @@
+@import url('open-iconic/font/css/open-iconic-bootstrap.min.css');
+
+html, body {
+    font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif;
+}
+
+h1:focus {
+    outline: none;
+}
+
+a, .btn-link {
+    color: #0071c1;
+}
+
+.btn-primary {
+    color: #fff;
+    background-color: #1b6ec2;
+    border-color: #1861ac;
+}
+
+.content {
+    padding-top: 1.1rem;
+}
+
+.valid.modified:not([type=checkbox]) {
+    outline: 1px solid #26b050;
+}
+
+.invalid {
+    outline: 1px solid red;
+}
+
+.validation-message {
+    color: red;
+}
+
+#blazor-error-ui {
+    background: lightyellow;
+    bottom: 0;
+    box-shadow: 0 -1px 2px rgba(0, 0, 0, 0.2);
+    display: none;
+    left: 0;
+    padding: 0.6rem 1.25rem 0.7rem 1.25rem;
+    position: fixed;
+    width: 100%;
+    z-index: 1000;
+}
+
+    #blazor-error-ui .dismiss {
+        cursor: pointer;
+        position: absolute;
+        right: 0.75rem;
+        top: 0.5rem;
+    }
+
+.blazor-error-boundary {
+    background: url(data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNTYiIGhlaWdodD0iNDkiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgeG1sbnM6eGxpbms9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkveGxpbmsiIG92ZXJmbG93PSJoaWRkZW4iPjxkZWZzPjxjbGlwUGF0aCBpZD0iY2xpcDAiPjxyZWN0IHg9IjIzNSIgeT0iNTEiIHdpZHRoPSI1NiIgaGVpZ2h0PSI0OSIvPjwvY2xpcFBhdGg+PC9kZWZzPjxnIGNsaXAtcGF0aD0idXJsKCNjbGlwMCkiIHRyYW5zZm9ybT0idHJhbnNsYXRlKC0yMzUgLTUxKSI+PHBhdGggZD0iTTI2My41MDYgNTFDMjY0LjcxNyA1MSAyNjUuODEzIDUxLjQ4MzcgMjY2LjYwNiA1Mi4yNjU4TDI2Ny4wNTIgNTIuNzk4NyAyNjcuNTM5IDUzLjYyODMgMjkwLjE4NSA5Mi4xODMxIDI5MC41NDUgOTIuNzk1IDI5MC42NTYgOTIuOTk2QzI5MC44NzcgOTMuNTEzIDI5MSA5NC4wODE1IDI5MSA5NC42NzgyIDI5MSA5Ny4wNjUxIDI4OS4wMzggOTkgMjg2LjYxNyA5OUwyNDAuMzgzIDk5QzIzNy45NjMgOTkgMjM2IDk3LjA2NTEgMjM2IDk0LjY3ODIgMjM2IDk0LjM3OTkgMjM2LjAzMSA5NC4wODg2IDIzNi4wODkgOTMuODA3MkwyMzYuMzM4IDkzLjAxNjIgMjM2Ljg1OCA5Mi4xMzE0IDI1OS40NzMgNTMuNjI5NCAyNTkuOTYxIDUyLjc5ODUgMjYwLjQwNyA1Mi4yNjU4QzI2MS4yIDUxLjQ4MzcgMjYyLjI5NiA1MSAyNjMuNTA2IDUxWk0yNjMuNTg2IDY2LjAxODNDMjYwLjczNyA2Ni4wMTgzIDI1OS4zMTMgNjcuMTI0NSAyNTkuMzEzIDY5LjMzNyAyNTkuMzEzIDY5LjYxMDIgMjU5LjMzMiA2OS44NjA4IDI1OS4zNzEgNzAuMDg4N0wyNjEuNzk1IDg0LjAxNjEgMjY1LjM4IDg0LjAxNjEgMjY3LjgyMSA2OS43NDc1QzI2Ny44NiA2OS43MzA5IDI2Ny44NzkgNjkuNTg3NyAyNjcuODc5IDY5LjMxNzkgMjY3Ljg3OSA2Ny4xMTgyIDI2Ni40NDggNjYuMDE4MyAyNjMuNTg2IDY2LjAxODNaTTI2My41NzYgODYuMDU0N0MyNjEuMDQ5IDg2LjA1NDcgMjU5Ljc4NiA4Ny4zMDA1IDI1OS43ODYgODkuNzkyMSAyNTkuNzg2IDkyLjI4MzcgMjYxLjA0OSA5My41Mjk1IDI2My41NzYgOTMuNTI5NSAyNjYuMTE2IDkzLjUyOTUgMjY3LjM4NyA5Mi4yODM3IDI2Ny4zODcgODkuNzkyMSAyNjcuMzg3IDg3LjMwMDUgMjY2LjExNiA4Ni4wNTQ3IDI2My41NzYgODYuMDU0N1oiIGZpbGw9IiNGRkU1MDAiIGZpbGwtcnVsZT0iZXZlbm9kZCIvPjwvZz48L3N2Zz4=) no-repeat 1rem/1.8rem, #b32121;
+    padding: 1rem 1rem 1rem 3.7rem;
+    color: white;
+}
+
+    .blazor-error-boundary::after {
+        content: "An error has occurred."
+    }
diff --git a/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/favicon.ico b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/favicon.ico
new file mode 100644
index 0000000000..63e859b476
Binary files /dev/null and b/samples/core/Miscellaneous/Multitenancy/MultiDb/wwwroot/favicon.ico differ
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/App.razor b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/App.razor
new file mode 100644
index 0000000000..6fd3ed1b5a
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/App.razor
@@ -0,0 +1,12 @@
+<Router AppAssembly="@typeof(App).Assembly">
+    <Found Context="routeData">
+        <RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
+        <FocusOnNavigate RouteData="@routeData" Selector="h1" />
+    </Found>
+    <NotFound>
+        <PageTitle>Not found</PageTitle>
+        <LayoutView Layout="@typeof(MainLayout)">
+            <p role="alert">Sorry, there's nothing at this address.</p>
+        </LayoutView>
+    </NotFound>
+</Router>
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Data/ContactContext.cs b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Data/ContactContext.cs
new file mode 100644
index 0000000000..8765ad8806
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Data/ContactContext.cs
@@ -0,0 +1,36 @@
+using Common;
+using Microsoft.EntityFrameworkCore;
+using System.Threading.Tasks;
+
+namespace SingleDbSingleTable.Data
+{
+    public class ContactContext : DbContext
+    {
+        private readonly string _tenant = string.Empty;
+
+        public ContactContext(
+            DbContextOptions<ContactContext> opts,
+            ITenantService service)
+            : base(opts) => _tenant = service.Tenant;
+
+        public DbSet<MultitenantContact> Contacts { get; set; } = null!;
+
+        public async Task CheckAndSeedAsync()
+        {
+            if (await Database.EnsureCreatedAsync())
+            {
+                foreach (var contact in Contact.GeneratedContacts)
+                {
+                    var tenant = contact.IsUnicorn ? "TenantA" : "TenantB";
+                    Contacts.Add(new MultitenantContact(contact, tenant));
+                }
+
+                await SaveChangesAsync();
+            }
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+            => modelBuilder.Entity<MultitenantContact>()
+                .HasQueryFilter(mt => mt.Tenant == _tenant);
+    }
+}
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Data/MultitenantContact.cs b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Data/MultitenantContact.cs
new file mode 100644
index 0000000000..906bc33a27
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Data/MultitenantContact.cs
@@ -0,0 +1,17 @@
+using Common;
+
+namespace SingleDbSingleTable.Data
+{
+    public class MultitenantContact : Contact
+    {
+        public MultitenantContact() { }
+
+        public MultitenantContact(Contact contact, string tenant)
+        {
+            IsUnicorn = contact.IsUnicorn;
+            Name = contact.Name;
+            Tenant = tenant;
+        }
+        public string Tenant { get; set; } = null!;
+    }
+}
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Pages/Error.cshtml b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Pages/Error.cshtml
new file mode 100644
index 0000000000..a83bcf995e
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Pages/Error.cshtml
@@ -0,0 +1,42 @@
+@page
+@model SingleDbSingleTable.Pages.ErrorModel
+
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no" />
+    <title>Error</title>
+    <link href="~/css/bootstrap/bootstrap.min.css" rel="stylesheet" />
+    <link href="~/css/site.css" rel="stylesheet" asp-append-version="true" />
+</head>
+
+<body>
+    <div class="main">
+        <div class="content px-4">
+            <h1 class="text-danger">Error.</h1>
+            <h2 class="text-danger">An error occurred while processing your request.</h2>
+
+            @if (Model.ShowRequestId)
+            {
+                <p>
+                    <strong>Request ID:</strong> <code>@Model.RequestId</code>
+                </p>
+            }
+
+            <h3>Development Mode</h3>
+            <p>
+                Swapping to the <strong>Development</strong> environment displays detailed information about the error that occurred.
+            </p>
+            <p>
+                <strong>The Development environment shouldn't be enabled for deployed applications.</strong>
+                It can result in displaying sensitive information from exceptions to end users.
+                For local debugging, enable the <strong>Development</strong> environment by setting the <strong>ASPNETCORE_ENVIRONMENT</strong> environment variable to <strong>Development</strong>
+                and restarting the app.
+            </p>
+        </div>
+    </div>
+</body>
+
+</html>
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Pages/Error.cshtml.cs b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Pages/Error.cshtml.cs
new file mode 100644
index 0000000000..7f83979fbd
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Pages/Error.cshtml.cs
@@ -0,0 +1,26 @@
+using System.Diagnostics;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.AspNetCore.Mvc.RazorPages;
+
+namespace SingleDbSingleTable.Pages;
+
+[ResponseCache(Duration = 0, Location = ResponseCacheLocation.None, NoStore = true)]
+[IgnoreAntiforgeryToken]
+public class ErrorModel : PageModel
+{
+    public string? RequestId { get; set; }
+
+    public bool ShowRequestId => !string.IsNullOrEmpty(RequestId);
+
+    private readonly ILogger<ErrorModel> _logger;
+
+    public ErrorModel(ILogger<ErrorModel> logger)
+    {
+        _logger = logger;
+    }
+
+    public void OnGet()
+    {
+        RequestId = Activity.Current?.Id ?? HttpContext.TraceIdentifier;
+    }
+}
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Pages/Index.razor b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Pages/Index.razor
new file mode 100644
index 0000000000..91dcf97db9
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Pages/Index.razor
@@ -0,0 +1,19 @@
+@page "/"
+@using Common;
+@using Microsoft.EntityFrameworkCore
+@using SingleDbSingleTable.Data
+@inject ITenantService Service
+@inject IDbContextFactory<ContactContext> Factory
+
+<PageTitle>Contacts for @Service.Tenant</PageTitle>
+
+<ContactList FetchContacts="RefreshContacts"/>
+
+@code
+{
+    private List<Contact> RefreshContacts()
+    {
+        var list = Factory.CreateDbContext();        
+        return new List<Contact>(list.Contacts);
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Pages/_Host.cshtml b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Pages/_Host.cshtml
new file mode 100644
index 0000000000..100d4b65b0
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Pages/_Host.cshtml
@@ -0,0 +1,8 @@
+@page "/"
+@namespace SingleDbSingleTable.Pages
+@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers
+@{
+    Layout = "_Layout";
+}
+
+<component type="typeof(App)" render-mode="ServerPrerendered" />
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Pages/_Layout.cshtml b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Pages/_Layout.cshtml
new file mode 100644
index 0000000000..b3ae4124e8
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Pages/_Layout.cshtml
@@ -0,0 +1,32 @@
+@using Microsoft.AspNetCore.Components.Web
+@namespace SingleDbSingleTable.Pages
+@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers
+
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <base href="~/" />
+    <link rel="stylesheet" href="css/bootstrap/bootstrap.min.css" />
+    <link href="css/site.css" rel="stylesheet" />
+    <link href="SingleDbSingleTable.styles.css" rel="stylesheet" />
+    <component type="typeof(HeadOutlet)" render-mode="ServerPrerendered" />
+</head>
+<body>
+    @RenderBody()
+
+    <div id="blazor-error-ui">
+        <environment include="Staging,Production">
+            An error has occurred. This application may no longer respond until reloaded.
+        </environment>
+        <environment include="Development">
+            An unhandled exception has occurred. See browser dev tools for details.
+        </environment>
+        <a href="" class="reload">Reload</a>
+        <a class="dismiss">🗙</a>
+    </div>
+
+    <script src="_framework/blazor.server.js"></script>
+</body>
+</html>
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Program.cs b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Program.cs
new file mode 100644
index 0000000000..ebcad63b98
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Program.cs
@@ -0,0 +1,39 @@
+using Common;
+using Microsoft.AspNetCore.Components;
+using Microsoft.AspNetCore.Components.Web;
+using Microsoft.EntityFrameworkCore;
+using SingleDbSingleTable.Data;
+
+var builder = WebApplication.CreateBuilder(args);
+
+// Add services to the container.
+builder.Services.AddRazorPages();
+builder.Services.AddServerSideBlazor();
+builder.Services.AddScoped<ITenantService, TenantService>();
+builder.Services.AddDbContextFactory<ContactContext>(
+    opt => opt.UseSqlite("Data Source=singledb.sqlite"), ServiceLifetime.Scoped);
+
+var app = builder.Build();
+
+// seed the database so demo is simple and doesn't require migrations
+using var ctx = app.Services.CreateScope().ServiceProvider.GetRequiredService<ContactContext>();
+await ctx.CheckAndSeedAsync();
+
+// Configure the HTTP request pipeline.
+if (!app.Environment.IsDevelopment())
+{
+    app.UseExceptionHandler("/Error");
+    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
+    app.UseHsts();
+}
+
+app.UseHttpsRedirection();
+
+app.UseStaticFiles();
+
+app.UseRouting();
+
+app.MapBlazorHub();
+app.MapFallbackToPage("/_Host");
+
+app.Run();
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Properties/launchSettings.json b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Properties/launchSettings.json
new file mode 100644
index 0000000000..d273faadba
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Properties/launchSettings.json
@@ -0,0 +1,12 @@
+{
+  "profiles": {
+    "SingleDbSingleTable": {
+      "commandName": "Project",
+      "launchBrowser": true,
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      },
+      "applicationUrl": "https://localhost:58209;http://localhost:58217"
+    }
+  }
+}
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Shared/MainLayout.razor b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Shared/MainLayout.razor
new file mode 100644
index 0000000000..4d688d5467
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Shared/MainLayout.razor
@@ -0,0 +1,19 @@
+@inherits LayoutComponentBase
+
+<PageTitle>Single Db Single Table Multitenant</PageTitle>
+
+<div class="page">
+    <div class="sidebar">
+        <NavMenu />
+    </div>
+
+    <main>
+        <div class="top-row px-4">
+            <a href="https://docs.microsoft.com/aspnet/" target="_blank">About</a>
+        </div>
+
+        <article class="content px-4">
+            @Body
+        </article>
+    </main>
+</div>
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Shared/MainLayout.razor.css b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Shared/MainLayout.razor.css
new file mode 100644
index 0000000000..551e4b2767
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Shared/MainLayout.razor.css
@@ -0,0 +1,70 @@
+.page {
+    position: relative;
+    display: flex;
+    flex-direction: column;
+}
+
+main {
+    flex: 1;
+}
+
+.sidebar {
+    background-image: linear-gradient(180deg, rgb(5, 39, 103) 0%, #3a0647 70%);
+}
+
+.top-row {
+    background-color: #f7f7f7;
+    border-bottom: 1px solid #d6d5d5;
+    justify-content: flex-end;
+    height: 3.5rem;
+    display: flex;
+    align-items: center;
+}
+
+    .top-row ::deep a, .top-row .btn-link {
+        white-space: nowrap;
+        margin-left: 1.5rem;
+    }
+
+    .top-row a:first-child {
+        overflow: hidden;
+        text-overflow: ellipsis;
+    }
+
+@media (max-width: 640.98px) {
+    .top-row:not(.auth) {
+        display: none;
+    }
+
+    .top-row.auth {
+        justify-content: space-between;
+    }
+
+    .top-row a, .top-row .btn-link {
+        margin-left: 0;
+    }
+}
+
+@media (min-width: 641px) {
+    .page {
+        flex-direction: row;
+    }
+
+    .sidebar {
+        width: 250px;
+        height: 100vh;
+        position: sticky;
+        top: 0;
+    }
+
+    .top-row {
+        position: sticky;
+        top: 0;
+        z-index: 1;
+    }
+
+    .top-row, article {
+        padding-left: 2rem !important;
+        padding-right: 1.5rem !important;
+    }
+}
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Shared/NavMenu.razor b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Shared/NavMenu.razor
new file mode 100644
index 0000000000..cb721242a7
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Shared/NavMenu.razor
@@ -0,0 +1,35 @@
+<div class="top-row ps-3 navbar navbar-dark">
+    <div class="container-fluid">
+        <a class="navbar-brand" href="">Single Db Single Table</a>
+        <TenantDisplay TenantClass="white"/>
+        <button title="Navigation menu" class="navbar-toggler" @onclick="ToggleNavMenu">
+            <span class="navbar-toggler-icon"></span>
+        </button>
+    </div>
+</div>
+
+<div class="@NavMenuCssClass" @onclick="ToggleNavMenu">
+    <nav class="flex-column">
+        <div class="nav-item px-3">
+            <NavLink class="nav-link" href="" Match="NavLinkMatch.All">
+                <span class="oi oi-home" aria-hidden="true"></span> Home
+            </NavLink>
+        </div>
+    </nav>
+    <nav class="flex-column">
+        <div class="nav-item px-3">
+            <TenantPicker/>
+        </div>
+    </nav>        
+</div>
+
+@code {
+    private bool collapseNavMenu = true;
+
+    private string? NavMenuCssClass => collapseNavMenu ? "collapse" : null;
+
+    private void ToggleNavMenu()
+    {
+        collapseNavMenu = !collapseNavMenu;
+    }
+}
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Shared/NavMenu.razor.css b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Shared/NavMenu.razor.css
new file mode 100644
index 0000000000..acc5f9f819
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/Shared/NavMenu.razor.css
@@ -0,0 +1,62 @@
+.navbar-toggler {
+    background-color: rgba(255, 255, 255, 0.1);
+}
+
+.top-row {
+    height: 3.5rem;
+    background-color: rgba(0,0,0,0.4);
+}
+
+.navbar-brand {
+    font-size: 1.1rem;
+}
+
+.oi {
+    width: 2rem;
+    font-size: 1.1rem;
+    vertical-align: text-top;
+    top: -2px;
+}
+
+.nav-item {
+    font-size: 0.9rem;
+    padding-bottom: 0.5rem;
+}
+
+    .nav-item:first-of-type {
+        padding-top: 1rem;
+    }
+
+    .nav-item:last-of-type {
+        padding-bottom: 1rem;
+    }
+
+    .nav-item ::deep a {
+        color: #d7d7d7;
+        border-radius: 4px;
+        height: 3rem;
+        display: flex;
+        align-items: center;
+        line-height: 3rem;
+    }
+
+.nav-item ::deep a.active {
+    background-color: rgba(255,255,255,0.25);
+    color: white;
+}
+
+.nav-item ::deep a:hover {
+    background-color: rgba(255,255,255,0.1);
+    color: white;
+}
+
+@media (min-width: 641px) {
+    .navbar-toggler {
+        display: none;
+    }
+
+    .collapse {
+        /* Never collapse the sidebar for wide screens */
+        display: block;
+    }
+}
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/SingleDbSingleTable.csproj b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/SingleDbSingleTable.csproj
new file mode 100644
index 0000000000..d9115c5e82
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/SingleDbSingleTable.csproj
@@ -0,0 +1,18 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\Common\Common.csproj" />
+    <ProjectReference Include="..\TenantControls\TenantControls.csproj" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/SingleDbSingleTable.sln b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/SingleDbSingleTable.sln
new file mode 100644
index 0000000000..8254953d5c
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/SingleDbSingleTable.sln
@@ -0,0 +1,37 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.1.31911.260
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SingleDbSingleTable", "SingleDbSingleTable.csproj", "{82E4B32D-0E8A-4D23-9C24-61004C5FF1CA}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Common", "..\Common\Common.csproj", "{EB3478E1-0264-479D-84ED-615653657379}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "TenantControls", "..\TenantControls\TenantControls.csproj", "{BB014658-C50A-4A8B-A1D1-DD52BB41B4F8}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{82E4B32D-0E8A-4D23-9C24-61004C5FF1CA}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{82E4B32D-0E8A-4D23-9C24-61004C5FF1CA}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{82E4B32D-0E8A-4D23-9C24-61004C5FF1CA}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{82E4B32D-0E8A-4D23-9C24-61004C5FF1CA}.Release|Any CPU.Build.0 = Release|Any CPU
+		{EB3478E1-0264-479D-84ED-615653657379}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{EB3478E1-0264-479D-84ED-615653657379}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{EB3478E1-0264-479D-84ED-615653657379}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{EB3478E1-0264-479D-84ED-615653657379}.Release|Any CPU.Build.0 = Release|Any CPU
+		{BB014658-C50A-4A8B-A1D1-DD52BB41B4F8}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{BB014658-C50A-4A8B-A1D1-DD52BB41B4F8}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{BB014658-C50A-4A8B-A1D1-DD52BB41B4F8}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{BB014658-C50A-4A8B-A1D1-DD52BB41B4F8}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {97533647-85BD-4298-922B-BD7907B22A7E}
+	EndGlobalSection
+EndGlobal
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/_Imports.razor b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/_Imports.razor
new file mode 100644
index 0000000000..81aee43de3
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/_Imports.razor
@@ -0,0 +1,11 @@
+@using System.Net.Http
+@using Microsoft.AspNetCore.Authorization
+@using Microsoft.AspNetCore.Components.Authorization
+@using Microsoft.AspNetCore.Components.Forms
+@using Microsoft.AspNetCore.Components.Routing
+@using Microsoft.AspNetCore.Components.Web
+@using Microsoft.AspNetCore.Components.Web.Virtualization
+@using Microsoft.JSInterop
+@using SingleDbSingleTable
+@using SingleDbSingleTable.Shared
+@using TenantControls
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/appsettings.Development.json b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/appsettings.Development.json
new file mode 100644
index 0000000000..770d3e9314
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/appsettings.Development.json
@@ -0,0 +1,9 @@
+{
+  "DetailedErrors": true,
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  }
+}
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/appsettings.json b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/appsettings.json
new file mode 100644
index 0000000000..10f68b8c8b
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/appsettings.json
@@ -0,0 +1,9 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  },
+  "AllowedHosts": "*"
+}
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/bootstrap/bootstrap.min.css b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/bootstrap/bootstrap.min.css
new file mode 100644
index 0000000000..02ae65b5fe
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/bootstrap/bootstrap.min.css
@@ -0,0 +1,7 @@
+@charset "UTF-8";/*!
+ * Bootstrap v5.1.0 (https://getbootstrap.com/)
+ * Copyright 2011-2021 The Bootstrap Authors
+ * Copyright 2011-2021 Twitter, Inc.
+ * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)
+ */:root{--bs-blue:#0d6efd;--bs-indigo:#6610f2;--bs-purple:#6f42c1;--bs-pink:#d63384;--bs-red:#dc3545;--bs-orange:#fd7e14;--bs-yellow:#ffc107;--bs-green:#198754;--bs-teal:#20c997;--bs-cyan:#0dcaf0;--bs-white:#fff;--bs-gray:#6c757d;--bs-gray-dark:#343a40;--bs-gray-100:#f8f9fa;--bs-gray-200:#e9ecef;--bs-gray-300:#dee2e6;--bs-gray-400:#ced4da;--bs-gray-500:#adb5bd;--bs-gray-600:#6c757d;--bs-gray-700:#495057;--bs-gray-800:#343a40;--bs-gray-900:#212529;--bs-primary:#0d6efd;--bs-secondary:#6c757d;--bs-success:#198754;--bs-info:#0dcaf0;--bs-warning:#ffc107;--bs-danger:#dc3545;--bs-light:#f8f9fa;--bs-dark:#212529;--bs-primary-rgb:13,110,253;--bs-secondary-rgb:108,117,125;--bs-success-rgb:25,135,84;--bs-info-rgb:13,202,240;--bs-warning-rgb:255,193,7;--bs-danger-rgb:220,53,69;--bs-light-rgb:248,249,250;--bs-dark-rgb:33,37,41;--bs-white-rgb:255,255,255;--bs-black-rgb:0,0,0;--bs-body-rgb:33,37,41;--bs-font-sans-serif:system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,"Noto Sans","Liberation Sans",sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";--bs-font-monospace:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace;--bs-gradient:linear-gradient(180deg, rgba(255, 255, 255, 0.15), rgba(255, 255, 255, 0));--bs-body-font-family:var(--bs-font-sans-serif);--bs-body-font-size:1rem;--bs-body-font-weight:400;--bs-body-line-height:1.5;--bs-body-color:#212529;--bs-body-bg:#fff}*,::after,::before{box-sizing:border-box}@media (prefers-reduced-motion:no-preference){:root{scroll-behavior:smooth}}body{margin:0;font-family:var(--bs-body-font-family);font-size:var(--bs-body-font-size);font-weight:var(--bs-body-font-weight);line-height:var(--bs-body-line-height);color:var(--bs-body-color);text-align:var(--bs-body-text-align);background-color:var(--bs-body-bg);-webkit-text-size-adjust:100%;-webkit-tap-highlight-color:transparent}hr{margin:1rem 0;color:inherit;background-color:currentColor;border:0;opacity:.25}hr:not([size]){height:1px}.h1,.h2,.h3,.h4,.h5,.h6,h1,h2,h3,h4,h5,h6{margin-top:0;margin-bottom:.5rem;font-weight:500;line-height:1.2}.h1,h1{font-size:calc(1.375rem + 1.5vw)}@media (min-width:1200px){.h1,h1{font-size:2.5rem}}.h2,h2{font-size:calc(1.325rem + .9vw)}@media (min-width:1200px){.h2,h2{font-size:2rem}}.h3,h3{font-size:calc(1.3rem + .6vw)}@media (min-width:1200px){.h3,h3{font-size:1.75rem}}.h4,h4{font-size:calc(1.275rem + .3vw)}@media (min-width:1200px){.h4,h4{font-size:1.5rem}}.h5,h5{font-size:1.25rem}.h6,h6{font-size:1rem}p{margin-top:0;margin-bottom:1rem}abbr[data-bs-original-title],abbr[title]{-webkit-text-decoration:underline dotted;text-decoration:underline dotted;cursor:help;-webkit-text-decoration-skip-ink:none;text-decoration-skip-ink:none}address{margin-bottom:1rem;font-style:normal;line-height:inherit}ol,ul{padding-left:2rem}dl,ol,ul{margin-top:0;margin-bottom:1rem}ol ol,ol ul,ul ol,ul ul{margin-bottom:0}dt{font-weight:700}dd{margin-bottom:.5rem;margin-left:0}blockquote{margin:0 0 1rem}b,strong{font-weight:bolder}.small,small{font-size:.875em}.mark,mark{padding:.2em;background-color:#fcf8e3}sub,sup{position:relative;font-size:.75em;line-height:0;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}a{color:#0d6efd;text-decoration:underline}a:hover{color:#0a58ca}a:not([href]):not([class]),a:not([href]):not([class]):hover{color:inherit;text-decoration:none}code,kbd,pre,samp{font-family:var(--bs-font-monospace);font-size:1em;direction:ltr;unicode-bidi:bidi-override}pre{display:block;margin-top:0;margin-bottom:1rem;overflow:auto;font-size:.875em}pre code{font-size:inherit;color:inherit;word-break:normal}code{font-size:.875em;color:#d63384;word-wrap:break-word}a>code{color:inherit}kbd{padding:.2rem .4rem;font-size:.875em;color:#fff;background-color:#212529;border-radius:.2rem}kbd kbd{padding:0;font-size:1em;font-weight:700}figure{margin:0 0 1rem}img,svg{vertical-align:middle}table{caption-side:bottom;border-collapse:collapse}caption{padding-top:.5rem;padding-bottom:.5rem;color:#6c757d;text-align:left}th{text-align:inherit;text-align:-webkit-match-parent}tbody,td,tfoot,th,thead,tr{border-color:inherit;border-style:solid;border-width:0}label{display:inline-block}button{border-radius:0}button:focus:not(:focus-visible){outline:0}button,input,optgroup,select,textarea{margin:0;font-family:inherit;font-size:inherit;line-height:inherit}button,select{text-transform:none}[role=button]{cursor:pointer}select{word-wrap:normal}select:disabled{opacity:1}[list]::-webkit-calendar-picker-indicator{display:none}[type=button],[type=reset],[type=submit],button{-webkit-appearance:button}[type=button]:not(:disabled),[type=reset]:not(:disabled),[type=submit]:not(:disabled),button:not(:disabled){cursor:pointer}::-moz-focus-inner{padding:0;border-style:none}textarea{resize:vertical}fieldset{min-width:0;padding:0;margin:0;border:0}legend{float:left;width:100%;padding:0;margin-bottom:.5rem;font-size:calc(1.275rem + .3vw);line-height:inherit}@media (min-width:1200px){legend{font-size:1.5rem}}legend+*{clear:left}::-webkit-datetime-edit-day-field,::-webkit-datetime-edit-fields-wrapper,::-webkit-datetime-edit-hour-field,::-webkit-datetime-edit-minute,::-webkit-datetime-edit-month-field,::-webkit-datetime-edit-text,::-webkit-datetime-edit-year-field{padding:0}::-webkit-inner-spin-button{height:auto}[type=search]{outline-offset:-2px;-webkit-appearance:textfield}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-color-swatch-wrapper{padding:0}::file-selector-button{font:inherit}::-webkit-file-upload-button{font:inherit;-webkit-appearance:button}output{display:inline-block}iframe{border:0}summary{display:list-item;cursor:pointer}progress{vertical-align:baseline}[hidden]{display:none!important}.lead{font-size:1.25rem;font-weight:300}.display-1{font-size:calc(1.625rem + 4.5vw);font-weight:300;line-height:1.2}@media (min-width:1200px){.display-1{font-size:5rem}}.display-2{font-size:calc(1.575rem + 3.9vw);font-weight:300;line-height:1.2}@media (min-width:1200px){.display-2{font-size:4.5rem}}.display-3{font-size:calc(1.525rem + 3.3vw);font-weight:300;line-height:1.2}@media (min-width:1200px){.display-3{font-size:4rem}}.display-4{font-size:calc(1.475rem + 2.7vw);font-weight:300;line-height:1.2}@media (min-width:1200px){.display-4{font-size:3.5rem}}.display-5{font-size:calc(1.425rem + 2.1vw);font-weight:300;line-height:1.2}@media (min-width:1200px){.display-5{font-size:3rem}}.display-6{font-size:calc(1.375rem + 1.5vw);font-weight:300;line-height:1.2}@media (min-width:1200px){.display-6{font-size:2.5rem}}.list-unstyled{padding-left:0;list-style:none}.list-inline{padding-left:0;list-style:none}.list-inline-item{display:inline-block}.list-inline-item:not(:last-child){margin-right:.5rem}.initialism{font-size:.875em;text-transform:uppercase}.blockquote{margin-bottom:1rem;font-size:1.25rem}.blockquote>:last-child{margin-bottom:0}.blockquote-footer{margin-top:-1rem;margin-bottom:1rem;font-size:.875em;color:#6c757d}.blockquote-footer::before{content:"— "}.img-fluid{max-width:100%;height:auto}.img-thumbnail{padding:.25rem;background-color:#fff;border:1px solid #dee2e6;border-radius:.25rem;max-width:100%;height:auto}.figure{display:inline-block}.figure-img{margin-bottom:.5rem;line-height:1}.figure-caption{font-size:.875em;color:#6c757d}.container,.container-fluid,.container-lg,.container-md,.container-sm,.container-xl,.container-xxl{width:100%;padding-right:var(--bs-gutter-x,.75rem);padding-left:var(--bs-gutter-x,.75rem);margin-right:auto;margin-left:auto}@media (min-width:576px){.container,.container-sm{max-width:540px}}@media (min-width:768px){.container,.container-md,.container-sm{max-width:720px}}@media (min-width:992px){.container,.container-lg,.container-md,.container-sm{max-width:960px}}@media (min-width:1200px){.container,.container-lg,.container-md,.container-sm,.container-xl{max-width:1140px}}@media (min-width:1400px){.container,.container-lg,.container-md,.container-sm,.container-xl,.container-xxl{max-width:1320px}}.row{--bs-gutter-x:1.5rem;--bs-gutter-y:0;display:flex;flex-wrap:wrap;margin-top:calc(var(--bs-gutter-y) * -1);margin-right:calc(var(--bs-gutter-x) * -.5);margin-left:calc(var(--bs-gutter-x) * -.5)}.row>*{flex-shrink:0;width:100%;max-width:100%;padding-right:calc(var(--bs-gutter-x) * .5);padding-left:calc(var(--bs-gutter-x) * .5);margin-top:var(--bs-gutter-y)}.col{flex:1 0 0%}.row-cols-auto>*{flex:0 0 auto;width:auto}.row-cols-1>*{flex:0 0 auto;width:100%}.row-cols-2>*{flex:0 0 auto;width:50%}.row-cols-3>*{flex:0 0 auto;width:33.3333333333%}.row-cols-4>*{flex:0 0 auto;width:25%}.row-cols-5>*{flex:0 0 auto;width:20%}.row-cols-6>*{flex:0 0 auto;width:16.6666666667%}.col-auto{flex:0 0 auto;width:auto}.col-1{flex:0 0 auto;width:8.33333333%}.col-2{flex:0 0 auto;width:16.66666667%}.col-3{flex:0 0 auto;width:25%}.col-4{flex:0 0 auto;width:33.33333333%}.col-5{flex:0 0 auto;width:41.66666667%}.col-6{flex:0 0 auto;width:50%}.col-7{flex:0 0 auto;width:58.33333333%}.col-8{flex:0 0 auto;width:66.66666667%}.col-9{flex:0 0 auto;width:75%}.col-10{flex:0 0 auto;width:83.33333333%}.col-11{flex:0 0 auto;width:91.66666667%}.col-12{flex:0 0 auto;width:100%}.offset-1{margin-left:8.33333333%}.offset-2{margin-left:16.66666667%}.offset-3{margin-left:25%}.offset-4{margin-left:33.33333333%}.offset-5{margin-left:41.66666667%}.offset-6{margin-left:50%}.offset-7{margin-left:58.33333333%}.offset-8{margin-left:66.66666667%}.offset-9{margin-left:75%}.offset-10{margin-left:83.33333333%}.offset-11{margin-left:91.66666667%}.g-0,.gx-0{--bs-gutter-x:0}.g-0,.gy-0{--bs-gutter-y:0}.g-1,.gx-1{--bs-gutter-x:0.25rem}.g-1,.gy-1{--bs-gutter-y:0.25rem}.g-2,.gx-2{--bs-gutter-x:0.5rem}.g-2,.gy-2{--bs-gutter-y:0.5rem}.g-3,.gx-3{--bs-gutter-x:1rem}.g-3,.gy-3{--bs-gutter-y:1rem}.g-4,.gx-4{--bs-gutter-x:1.5rem}.g-4,.gy-4{--bs-gutter-y:1.5rem}.g-5,.gx-5{--bs-gutter-x:3rem}.g-5,.gy-5{--bs-gutter-y:3rem}@media (min-width:576px){.col-sm{flex:1 0 0%}.row-cols-sm-auto>*{flex:0 0 auto;width:auto}.row-cols-sm-1>*{flex:0 0 auto;width:100%}.row-cols-sm-2>*{flex:0 0 auto;width:50%}.row-cols-sm-3>*{flex:0 0 auto;width:33.3333333333%}.row-cols-sm-4>*{flex:0 0 auto;width:25%}.row-cols-sm-5>*{flex:0 0 auto;width:20%}.row-cols-sm-6>*{flex:0 0 auto;width:16.6666666667%}.col-sm-auto{flex:0 0 auto;width:auto}.col-sm-1{flex:0 0 auto;width:8.33333333%}.col-sm-2{flex:0 0 auto;width:16.66666667%}.col-sm-3{flex:0 0 auto;width:25%}.col-sm-4{flex:0 0 auto;width:33.33333333%}.col-sm-5{flex:0 0 auto;width:41.66666667%}.col-sm-6{flex:0 0 auto;width:50%}.col-sm-7{flex:0 0 auto;width:58.33333333%}.col-sm-8{flex:0 0 auto;width:66.66666667%}.col-sm-9{flex:0 0 auto;width:75%}.col-sm-10{flex:0 0 auto;width:83.33333333%}.col-sm-11{flex:0 0 auto;width:91.66666667%}.col-sm-12{flex:0 0 auto;width:100%}.offset-sm-0{margin-left:0}.offset-sm-1{margin-left:8.33333333%}.offset-sm-2{margin-left:16.66666667%}.offset-sm-3{margin-left:25%}.offset-sm-4{margin-left:33.33333333%}.offset-sm-5{margin-left:41.66666667%}.offset-sm-6{margin-left:50%}.offset-sm-7{margin-left:58.33333333%}.offset-sm-8{margin-left:66.66666667%}.offset-sm-9{margin-left:75%}.offset-sm-10{margin-left:83.33333333%}.offset-sm-11{margin-left:91.66666667%}.g-sm-0,.gx-sm-0{--bs-gutter-x:0}.g-sm-0,.gy-sm-0{--bs-gutter-y:0}.g-sm-1,.gx-sm-1{--bs-gutter-x:0.25rem}.g-sm-1,.gy-sm-1{--bs-gutter-y:0.25rem}.g-sm-2,.gx-sm-2{--bs-gutter-x:0.5rem}.g-sm-2,.gy-sm-2{--bs-gutter-y:0.5rem}.g-sm-3,.gx-sm-3{--bs-gutter-x:1rem}.g-sm-3,.gy-sm-3{--bs-gutter-y:1rem}.g-sm-4,.gx-sm-4{--bs-gutter-x:1.5rem}.g-sm-4,.gy-sm-4{--bs-gutter-y:1.5rem}.g-sm-5,.gx-sm-5{--bs-gutter-x:3rem}.g-sm-5,.gy-sm-5{--bs-gutter-y:3rem}}@media (min-width:768px){.col-md{flex:1 0 0%}.row-cols-md-auto>*{flex:0 0 auto;width:auto}.row-cols-md-1>*{flex:0 0 auto;width:100%}.row-cols-md-2>*{flex:0 0 auto;width:50%}.row-cols-md-3>*{flex:0 0 auto;width:33.3333333333%}.row-cols-md-4>*{flex:0 0 auto;width:25%}.row-cols-md-5>*{flex:0 0 auto;width:20%}.row-cols-md-6>*{flex:0 0 auto;width:16.6666666667%}.col-md-auto{flex:0 0 auto;width:auto}.col-md-1{flex:0 0 auto;width:8.33333333%}.col-md-2{flex:0 0 auto;width:16.66666667%}.col-md-3{flex:0 0 auto;width:25%}.col-md-4{flex:0 0 auto;width:33.33333333%}.col-md-5{flex:0 0 auto;width:41.66666667%}.col-md-6{flex:0 0 auto;width:50%}.col-md-7{flex:0 0 auto;width:58.33333333%}.col-md-8{flex:0 0 auto;width:66.66666667%}.col-md-9{flex:0 0 auto;width:75%}.col-md-10{flex:0 0 auto;width:83.33333333%}.col-md-11{flex:0 0 auto;width:91.66666667%}.col-md-12{flex:0 0 auto;width:100%}.offset-md-0{margin-left:0}.offset-md-1{margin-left:8.33333333%}.offset-md-2{margin-left:16.66666667%}.offset-md-3{margin-left:25%}.offset-md-4{margin-left:33.33333333%}.offset-md-5{margin-left:41.66666667%}.offset-md-6{margin-left:50%}.offset-md-7{margin-left:58.33333333%}.offset-md-8{margin-left:66.66666667%}.offset-md-9{margin-left:75%}.offset-md-10{margin-left:83.33333333%}.offset-md-11{margin-left:91.66666667%}.g-md-0,.gx-md-0{--bs-gutter-x:0}.g-md-0,.gy-md-0{--bs-gutter-y:0}.g-md-1,.gx-md-1{--bs-gutter-x:0.25rem}.g-md-1,.gy-md-1{--bs-gutter-y:0.25rem}.g-md-2,.gx-md-2{--bs-gutter-x:0.5rem}.g-md-2,.gy-md-2{--bs-gutter-y:0.5rem}.g-md-3,.gx-md-3{--bs-gutter-x:1rem}.g-md-3,.gy-md-3{--bs-gutter-y:1rem}.g-md-4,.gx-md-4{--bs-gutter-x:1.5rem}.g-md-4,.gy-md-4{--bs-gutter-y:1.5rem}.g-md-5,.gx-md-5{--bs-gutter-x:3rem}.g-md-5,.gy-md-5{--bs-gutter-y:3rem}}@media (min-width:992px){.col-lg{flex:1 0 0%}.row-cols-lg-auto>*{flex:0 0 auto;width:auto}.row-cols-lg-1>*{flex:0 0 auto;width:100%}.row-cols-lg-2>*{flex:0 0 auto;width:50%}.row-cols-lg-3>*{flex:0 0 auto;width:33.3333333333%}.row-cols-lg-4>*{flex:0 0 auto;width:25%}.row-cols-lg-5>*{flex:0 0 auto;width:20%}.row-cols-lg-6>*{flex:0 0 auto;width:16.6666666667%}.col-lg-auto{flex:0 0 auto;width:auto}.col-lg-1{flex:0 0 auto;width:8.33333333%}.col-lg-2{flex:0 0 auto;width:16.66666667%}.col-lg-3{flex:0 0 auto;width:25%}.col-lg-4{flex:0 0 auto;width:33.33333333%}.col-lg-5{flex:0 0 auto;width:41.66666667%}.col-lg-6{flex:0 0 auto;width:50%}.col-lg-7{flex:0 0 auto;width:58.33333333%}.col-lg-8{flex:0 0 auto;width:66.66666667%}.col-lg-9{flex:0 0 auto;width:75%}.col-lg-10{flex:0 0 auto;width:83.33333333%}.col-lg-11{flex:0 0 auto;width:91.66666667%}.col-lg-12{flex:0 0 auto;width:100%}.offset-lg-0{margin-left:0}.offset-lg-1{margin-left:8.33333333%}.offset-lg-2{margin-left:16.66666667%}.offset-lg-3{margin-left:25%}.offset-lg-4{margin-left:33.33333333%}.offset-lg-5{margin-left:41.66666667%}.offset-lg-6{margin-left:50%}.offset-lg-7{margin-left:58.33333333%}.offset-lg-8{margin-left:66.66666667%}.offset-lg-9{margin-left:75%}.offset-lg-10{margin-left:83.33333333%}.offset-lg-11{margin-left:91.66666667%}.g-lg-0,.gx-lg-0{--bs-gutter-x:0}.g-lg-0,.gy-lg-0{--bs-gutter-y:0}.g-lg-1,.gx-lg-1{--bs-gutter-x:0.25rem}.g-lg-1,.gy-lg-1{--bs-gutter-y:0.25rem}.g-lg-2,.gx-lg-2{--bs-gutter-x:0.5rem}.g-lg-2,.gy-lg-2{--bs-gutter-y:0.5rem}.g-lg-3,.gx-lg-3{--bs-gutter-x:1rem}.g-lg-3,.gy-lg-3{--bs-gutter-y:1rem}.g-lg-4,.gx-lg-4{--bs-gutter-x:1.5rem}.g-lg-4,.gy-lg-4{--bs-gutter-y:1.5rem}.g-lg-5,.gx-lg-5{--bs-gutter-x:3rem}.g-lg-5,.gy-lg-5{--bs-gutter-y:3rem}}@media (min-width:1200px){.col-xl{flex:1 0 0%}.row-cols-xl-auto>*{flex:0 0 auto;width:auto}.row-cols-xl-1>*{flex:0 0 auto;width:100%}.row-cols-xl-2>*{flex:0 0 auto;width:50%}.row-cols-xl-3>*{flex:0 0 auto;width:33.3333333333%}.row-cols-xl-4>*{flex:0 0 auto;width:25%}.row-cols-xl-5>*{flex:0 0 auto;width:20%}.row-cols-xl-6>*{flex:0 0 auto;width:16.6666666667%}.col-xl-auto{flex:0 0 auto;width:auto}.col-xl-1{flex:0 0 auto;width:8.33333333%}.col-xl-2{flex:0 0 auto;width:16.66666667%}.col-xl-3{flex:0 0 auto;width:25%}.col-xl-4{flex:0 0 auto;width:33.33333333%}.col-xl-5{flex:0 0 auto;width:41.66666667%}.col-xl-6{flex:0 0 auto;width:50%}.col-xl-7{flex:0 0 auto;width:58.33333333%}.col-xl-8{flex:0 0 auto;width:66.66666667%}.col-xl-9{flex:0 0 auto;width:75%}.col-xl-10{flex:0 0 auto;width:83.33333333%}.col-xl-11{flex:0 0 auto;width:91.66666667%}.col-xl-12{flex:0 0 auto;width:100%}.offset-xl-0{margin-left:0}.offset-xl-1{margin-left:8.33333333%}.offset-xl-2{margin-left:16.66666667%}.offset-xl-3{margin-left:25%}.offset-xl-4{margin-left:33.33333333%}.offset-xl-5{margin-left:41.66666667%}.offset-xl-6{margin-left:50%}.offset-xl-7{margin-left:58.33333333%}.offset-xl-8{margin-left:66.66666667%}.offset-xl-9{margin-left:75%}.offset-xl-10{margin-left:83.33333333%}.offset-xl-11{margin-left:91.66666667%}.g-xl-0,.gx-xl-0{--bs-gutter-x:0}.g-xl-0,.gy-xl-0{--bs-gutter-y:0}.g-xl-1,.gx-xl-1{--bs-gutter-x:0.25rem}.g-xl-1,.gy-xl-1{--bs-gutter-y:0.25rem}.g-xl-2,.gx-xl-2{--bs-gutter-x:0.5rem}.g-xl-2,.gy-xl-2{--bs-gutter-y:0.5rem}.g-xl-3,.gx-xl-3{--bs-gutter-x:1rem}.g-xl-3,.gy-xl-3{--bs-gutter-y:1rem}.g-xl-4,.gx-xl-4{--bs-gutter-x:1.5rem}.g-xl-4,.gy-xl-4{--bs-gutter-y:1.5rem}.g-xl-5,.gx-xl-5{--bs-gutter-x:3rem}.g-xl-5,.gy-xl-5{--bs-gutter-y:3rem}}@media (min-width:1400px){.col-xxl{flex:1 0 0%}.row-cols-xxl-auto>*{flex:0 0 auto;width:auto}.row-cols-xxl-1>*{flex:0 0 auto;width:100%}.row-cols-xxl-2>*{flex:0 0 auto;width:50%}.row-cols-xxl-3>*{flex:0 0 auto;width:33.3333333333%}.row-cols-xxl-4>*{flex:0 0 auto;width:25%}.row-cols-xxl-5>*{flex:0 0 auto;width:20%}.row-cols-xxl-6>*{flex:0 0 auto;width:16.6666666667%}.col-xxl-auto{flex:0 0 auto;width:auto}.col-xxl-1{flex:0 0 auto;width:8.33333333%}.col-xxl-2{flex:0 0 auto;width:16.66666667%}.col-xxl-3{flex:0 0 auto;width:25%}.col-xxl-4{flex:0 0 auto;width:33.33333333%}.col-xxl-5{flex:0 0 auto;width:41.66666667%}.col-xxl-6{flex:0 0 auto;width:50%}.col-xxl-7{flex:0 0 auto;width:58.33333333%}.col-xxl-8{flex:0 0 auto;width:66.66666667%}.col-xxl-9{flex:0 0 auto;width:75%}.col-xxl-10{flex:0 0 auto;width:83.33333333%}.col-xxl-11{flex:0 0 auto;width:91.66666667%}.col-xxl-12{flex:0 0 auto;width:100%}.offset-xxl-0{margin-left:0}.offset-xxl-1{margin-left:8.33333333%}.offset-xxl-2{margin-left:16.66666667%}.offset-xxl-3{margin-left:25%}.offset-xxl-4{margin-left:33.33333333%}.offset-xxl-5{margin-left:41.66666667%}.offset-xxl-6{margin-left:50%}.offset-xxl-7{margin-left:58.33333333%}.offset-xxl-8{margin-left:66.66666667%}.offset-xxl-9{margin-left:75%}.offset-xxl-10{margin-left:83.33333333%}.offset-xxl-11{margin-left:91.66666667%}.g-xxl-0,.gx-xxl-0{--bs-gutter-x:0}.g-xxl-0,.gy-xxl-0{--bs-gutter-y:0}.g-xxl-1,.gx-xxl-1{--bs-gutter-x:0.25rem}.g-xxl-1,.gy-xxl-1{--bs-gutter-y:0.25rem}.g-xxl-2,.gx-xxl-2{--bs-gutter-x:0.5rem}.g-xxl-2,.gy-xxl-2{--bs-gutter-y:0.5rem}.g-xxl-3,.gx-xxl-3{--bs-gutter-x:1rem}.g-xxl-3,.gy-xxl-3{--bs-gutter-y:1rem}.g-xxl-4,.gx-xxl-4{--bs-gutter-x:1.5rem}.g-xxl-4,.gy-xxl-4{--bs-gutter-y:1.5rem}.g-xxl-5,.gx-xxl-5{--bs-gutter-x:3rem}.g-xxl-5,.gy-xxl-5{--bs-gutter-y:3rem}}.table{--bs-table-bg:transparent;--bs-table-accent-bg:transparent;--bs-table-striped-color:#212529;--bs-table-striped-bg:rgba(0, 0, 0, 0.05);--bs-table-active-color:#212529;--bs-table-active-bg:rgba(0, 0, 0, 0.1);--bs-table-hover-color:#212529;--bs-table-hover-bg:rgba(0, 0, 0, 0.075);width:100%;margin-bottom:1rem;color:#212529;vertical-align:top;border-color:#dee2e6}.table>:not(caption)>*>*{padding:.5rem .5rem;background-color:var(--bs-table-bg);border-bottom-width:1px;box-shadow:inset 0 0 0 9999px var(--bs-table-accent-bg)}.table>tbody{vertical-align:inherit}.table>thead{vertical-align:bottom}.table>:not(:last-child)>:last-child>*{border-bottom-color:currentColor}.caption-top{caption-side:top}.table-sm>:not(caption)>*>*{padding:.25rem .25rem}.table-bordered>:not(caption)>*{border-width:1px 0}.table-bordered>:not(caption)>*>*{border-width:0 1px}.table-borderless>:not(caption)>*>*{border-bottom-width:0}.table-striped>tbody>tr:nth-of-type(odd){--bs-table-accent-bg:var(--bs-table-striped-bg);color:var(--bs-table-striped-color)}.table-active{--bs-table-accent-bg:var(--bs-table-active-bg);color:var(--bs-table-active-color)}.table-hover>tbody>tr:hover{--bs-table-accent-bg:var(--bs-table-hover-bg);color:var(--bs-table-hover-color)}.table-primary{--bs-table-bg:#cfe2ff;--bs-table-striped-bg:#c5d7f2;--bs-table-striped-color:#000;--bs-table-active-bg:#bacbe6;--bs-table-active-color:#000;--bs-table-hover-bg:#bfd1ec;--bs-table-hover-color:#000;color:#000;border-color:#bacbe6}.table-secondary{--bs-table-bg:#e2e3e5;--bs-table-striped-bg:#d7d8da;--bs-table-striped-color:#000;--bs-table-active-bg:#cbccce;--bs-table-active-color:#000;--bs-table-hover-bg:#d1d2d4;--bs-table-hover-color:#000;color:#000;border-color:#cbccce}.table-success{--bs-table-bg:#d1e7dd;--bs-table-striped-bg:#c7dbd2;--bs-table-striped-color:#000;--bs-table-active-bg:#bcd0c7;--bs-table-active-color:#000;--bs-table-hover-bg:#c1d6cc;--bs-table-hover-color:#000;color:#000;border-color:#bcd0c7}.table-info{--bs-table-bg:#cff4fc;--bs-table-striped-bg:#c5e8ef;--bs-table-striped-color:#000;--bs-table-active-bg:#badce3;--bs-table-active-color:#000;--bs-table-hover-bg:#bfe2e9;--bs-table-hover-color:#000;color:#000;border-color:#badce3}.table-warning{--bs-table-bg:#fff3cd;--bs-table-striped-bg:#f2e7c3;--bs-table-striped-color:#000;--bs-table-active-bg:#e6dbb9;--bs-table-active-color:#000;--bs-table-hover-bg:#ece1be;--bs-table-hover-color:#000;color:#000;border-color:#e6dbb9}.table-danger{--bs-table-bg:#f8d7da;--bs-table-striped-bg:#eccccf;--bs-table-striped-color:#000;--bs-table-active-bg:#dfc2c4;--bs-table-active-color:#000;--bs-table-hover-bg:#e5c7ca;--bs-table-hover-color:#000;color:#000;border-color:#dfc2c4}.table-light{--bs-table-bg:#f8f9fa;--bs-table-striped-bg:#ecedee;--bs-table-striped-color:#000;--bs-table-active-bg:#dfe0e1;--bs-table-active-color:#000;--bs-table-hover-bg:#e5e6e7;--bs-table-hover-color:#000;color:#000;border-color:#dfe0e1}.table-dark{--bs-table-bg:#212529;--bs-table-striped-bg:#2c3034;--bs-table-striped-color:#fff;--bs-table-active-bg:#373b3e;--bs-table-active-color:#fff;--bs-table-hover-bg:#323539;--bs-table-hover-color:#fff;color:#fff;border-color:#373b3e}.table-responsive{overflow-x:auto;-webkit-overflow-scrolling:touch}@media (max-width:575.98px){.table-responsive-sm{overflow-x:auto;-webkit-overflow-scrolling:touch}}@media (max-width:767.98px){.table-responsive-md{overflow-x:auto;-webkit-overflow-scrolling:touch}}@media (max-width:991.98px){.table-responsive-lg{overflow-x:auto;-webkit-overflow-scrolling:touch}}@media (max-width:1199.98px){.table-responsive-xl{overflow-x:auto;-webkit-overflow-scrolling:touch}}@media (max-width:1399.98px){.table-responsive-xxl{overflow-x:auto;-webkit-overflow-scrolling:touch}}.form-label{margin-bottom:.5rem}.col-form-label{padding-top:calc(.375rem + 1px);padding-bottom:calc(.375rem + 1px);margin-bottom:0;font-size:inherit;line-height:1.5}.col-form-label-lg{padding-top:calc(.5rem + 1px);padding-bottom:calc(.5rem + 1px);font-size:1.25rem}.col-form-label-sm{padding-top:calc(.25rem + 1px);padding-bottom:calc(.25rem + 1px);font-size:.875rem}.form-text{margin-top:.25rem;font-size:.875em;color:#6c757d}.form-control{display:block;width:100%;padding:.375rem .75rem;font-size:1rem;font-weight:400;line-height:1.5;color:#212529;background-color:#fff;background-clip:padding-box;border:1px solid #ced4da;-webkit-appearance:none;-moz-appearance:none;appearance:none;border-radius:.25rem;transition:border-color .15s ease-in-out,box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.form-control{transition:none}}.form-control[type=file]{overflow:hidden}.form-control[type=file]:not(:disabled):not([readonly]){cursor:pointer}.form-control:focus{color:#212529;background-color:#fff;border-color:#86b7fe;outline:0;box-shadow:0 0 0 .25rem rgba(13,110,253,.25)}.form-control::-webkit-date-and-time-value{height:1.5em}.form-control::-moz-placeholder{color:#6c757d;opacity:1}.form-control::placeholder{color:#6c757d;opacity:1}.form-control:disabled,.form-control[readonly]{background-color:#e9ecef;opacity:1}.form-control::file-selector-button{padding:.375rem .75rem;margin:-.375rem -.75rem;-webkit-margin-end:.75rem;margin-inline-end:.75rem;color:#212529;background-color:#e9ecef;pointer-events:none;border-color:inherit;border-style:solid;border-width:0;border-inline-end-width:1px;border-radius:0;transition:color .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.form-control::file-selector-button{transition:none}}.form-control:hover:not(:disabled):not([readonly])::file-selector-button{background-color:#dde0e3}.form-control::-webkit-file-upload-button{padding:.375rem .75rem;margin:-.375rem -.75rem;-webkit-margin-end:.75rem;margin-inline-end:.75rem;color:#212529;background-color:#e9ecef;pointer-events:none;border-color:inherit;border-style:solid;border-width:0;border-inline-end-width:1px;border-radius:0;-webkit-transition:color .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;transition:color .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.form-control::-webkit-file-upload-button{-webkit-transition:none;transition:none}}.form-control:hover:not(:disabled):not([readonly])::-webkit-file-upload-button{background-color:#dde0e3}.form-control-plaintext{display:block;width:100%;padding:.375rem 0;margin-bottom:0;line-height:1.5;color:#212529;background-color:transparent;border:solid transparent;border-width:1px 0}.form-control-plaintext.form-control-lg,.form-control-plaintext.form-control-sm{padding-right:0;padding-left:0}.form-control-sm{min-height:calc(1.5em + .5rem + 2px);padding:.25rem .5rem;font-size:.875rem;border-radius:.2rem}.form-control-sm::file-selector-button{padding:.25rem .5rem;margin:-.25rem -.5rem;-webkit-margin-end:.5rem;margin-inline-end:.5rem}.form-control-sm::-webkit-file-upload-button{padding:.25rem .5rem;margin:-.25rem -.5rem;-webkit-margin-end:.5rem;margin-inline-end:.5rem}.form-control-lg{min-height:calc(1.5em + 1rem + 2px);padding:.5rem 1rem;font-size:1.25rem;border-radius:.3rem}.form-control-lg::file-selector-button{padding:.5rem 1rem;margin:-.5rem -1rem;-webkit-margin-end:1rem;margin-inline-end:1rem}.form-control-lg::-webkit-file-upload-button{padding:.5rem 1rem;margin:-.5rem -1rem;-webkit-margin-end:1rem;margin-inline-end:1rem}textarea.form-control{min-height:calc(1.5em + .75rem + 2px)}textarea.form-control-sm{min-height:calc(1.5em + .5rem + 2px)}textarea.form-control-lg{min-height:calc(1.5em + 1rem + 2px)}.form-control-color{width:3rem;height:auto;padding:.375rem}.form-control-color:not(:disabled):not([readonly]){cursor:pointer}.form-control-color::-moz-color-swatch{height:1.5em;border-radius:.25rem}.form-control-color::-webkit-color-swatch{height:1.5em;border-radius:.25rem}.form-select{display:block;width:100%;padding:.375rem 2.25rem .375rem .75rem;-moz-padding-start:calc(0.75rem - 3px);font-size:1rem;font-weight:400;line-height:1.5;color:#212529;background-color:#fff;background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3e%3cpath fill='none' stroke='%23343a40' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M2 5l6 6 6-6'/%3e%3c/svg%3e");background-repeat:no-repeat;background-position:right .75rem center;background-size:16px 12px;border:1px solid #ced4da;border-radius:.25rem;transition:border-color .15s ease-in-out,box-shadow .15s ease-in-out;-webkit-appearance:none;-moz-appearance:none;appearance:none}@media (prefers-reduced-motion:reduce){.form-select{transition:none}}.form-select:focus{border-color:#86b7fe;outline:0;box-shadow:0 0 0 .25rem rgba(13,110,253,.25)}.form-select[multiple],.form-select[size]:not([size="1"]){padding-right:.75rem;background-image:none}.form-select:disabled{background-color:#e9ecef}.form-select:-moz-focusring{color:transparent;text-shadow:0 0 0 #212529}.form-select-sm{padding-top:.25rem;padding-bottom:.25rem;padding-left:.5rem;font-size:.875rem}.form-select-lg{padding-top:.5rem;padding-bottom:.5rem;padding-left:1rem;font-size:1.25rem}.form-check{display:block;min-height:1.5rem;padding-left:1.5em;margin-bottom:.125rem}.form-check .form-check-input{float:left;margin-left:-1.5em}.form-check-input{width:1em;height:1em;margin-top:.25em;vertical-align:top;background-color:#fff;background-repeat:no-repeat;background-position:center;background-size:contain;border:1px solid rgba(0,0,0,.25);-webkit-appearance:none;-moz-appearance:none;appearance:none;-webkit-print-color-adjust:exact;color-adjust:exact}.form-check-input[type=checkbox]{border-radius:.25em}.form-check-input[type=radio]{border-radius:50%}.form-check-input:active{filter:brightness(90%)}.form-check-input:focus{border-color:#86b7fe;outline:0;box-shadow:0 0 0 .25rem rgba(13,110,253,.25)}.form-check-input:checked{background-color:#0d6efd;border-color:#0d6efd}.form-check-input:checked[type=checkbox]{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3e%3cpath fill='none' stroke='%23fff' stroke-linecap='round' stroke-linejoin='round' stroke-width='3' d='M6 10l3 3l6-6'/%3e%3c/svg%3e")}.form-check-input:checked[type=radio]{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='-4 -4 8 8'%3e%3ccircle r='2' fill='%23fff'/%3e%3c/svg%3e")}.form-check-input[type=checkbox]:indeterminate{background-color:#0d6efd;border-color:#0d6efd;background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3e%3cpath fill='none' stroke='%23fff' stroke-linecap='round' stroke-linejoin='round' stroke-width='3' d='M6 10h8'/%3e%3c/svg%3e")}.form-check-input:disabled{pointer-events:none;filter:none;opacity:.5}.form-check-input:disabled~.form-check-label,.form-check-input[disabled]~.form-check-label{opacity:.5}.form-switch{padding-left:2.5em}.form-switch .form-check-input{width:2em;margin-left:-2.5em;background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='-4 -4 8 8'%3e%3ccircle r='3' fill='rgba%280, 0, 0, 0.25%29'/%3e%3c/svg%3e");background-position:left center;border-radius:2em;transition:background-position .15s ease-in-out}@media (prefers-reduced-motion:reduce){.form-switch .form-check-input{transition:none}}.form-switch .form-check-input:focus{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='-4 -4 8 8'%3e%3ccircle r='3' fill='%2386b7fe'/%3e%3c/svg%3e")}.form-switch .form-check-input:checked{background-position:right center;background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='-4 -4 8 8'%3e%3ccircle r='3' fill='%23fff'/%3e%3c/svg%3e")}.form-check-inline{display:inline-block;margin-right:1rem}.btn-check{position:absolute;clip:rect(0,0,0,0);pointer-events:none}.btn-check:disabled+.btn,.btn-check[disabled]+.btn{pointer-events:none;filter:none;opacity:.65}.form-range{width:100%;height:1.5rem;padding:0;background-color:transparent;-webkit-appearance:none;-moz-appearance:none;appearance:none}.form-range:focus{outline:0}.form-range:focus::-webkit-slider-thumb{box-shadow:0 0 0 1px #fff,0 0 0 .25rem rgba(13,110,253,.25)}.form-range:focus::-moz-range-thumb{box-shadow:0 0 0 1px #fff,0 0 0 .25rem rgba(13,110,253,.25)}.form-range::-moz-focus-outer{border:0}.form-range::-webkit-slider-thumb{width:1rem;height:1rem;margin-top:-.25rem;background-color:#0d6efd;border:0;border-radius:1rem;-webkit-transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;-webkit-appearance:none;appearance:none}@media (prefers-reduced-motion:reduce){.form-range::-webkit-slider-thumb{-webkit-transition:none;transition:none}}.form-range::-webkit-slider-thumb:active{background-color:#b6d4fe}.form-range::-webkit-slider-runnable-track{width:100%;height:.5rem;color:transparent;cursor:pointer;background-color:#dee2e6;border-color:transparent;border-radius:1rem}.form-range::-moz-range-thumb{width:1rem;height:1rem;background-color:#0d6efd;border:0;border-radius:1rem;-moz-transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;-moz-appearance:none;appearance:none}@media (prefers-reduced-motion:reduce){.form-range::-moz-range-thumb{-moz-transition:none;transition:none}}.form-range::-moz-range-thumb:active{background-color:#b6d4fe}.form-range::-moz-range-track{width:100%;height:.5rem;color:transparent;cursor:pointer;background-color:#dee2e6;border-color:transparent;border-radius:1rem}.form-range:disabled{pointer-events:none}.form-range:disabled::-webkit-slider-thumb{background-color:#adb5bd}.form-range:disabled::-moz-range-thumb{background-color:#adb5bd}.form-floating{position:relative}.form-floating>.form-control,.form-floating>.form-select{height:calc(3.5rem + 2px);line-height:1.25}.form-floating>label{position:absolute;top:0;left:0;height:100%;padding:1rem .75rem;pointer-events:none;border:1px solid transparent;transform-origin:0 0;transition:opacity .1s ease-in-out,transform .1s ease-in-out}@media (prefers-reduced-motion:reduce){.form-floating>label{transition:none}}.form-floating>.form-control{padding:1rem .75rem}.form-floating>.form-control::-moz-placeholder{color:transparent}.form-floating>.form-control::placeholder{color:transparent}.form-floating>.form-control:not(:-moz-placeholder-shown){padding-top:1.625rem;padding-bottom:.625rem}.form-floating>.form-control:focus,.form-floating>.form-control:not(:placeholder-shown){padding-top:1.625rem;padding-bottom:.625rem}.form-floating>.form-control:-webkit-autofill{padding-top:1.625rem;padding-bottom:.625rem}.form-floating>.form-select{padding-top:1.625rem;padding-bottom:.625rem}.form-floating>.form-control:not(:-moz-placeholder-shown)~label{opacity:.65;transform:scale(.85) translateY(-.5rem) translateX(.15rem)}.form-floating>.form-control:focus~label,.form-floating>.form-control:not(:placeholder-shown)~label,.form-floating>.form-select~label{opacity:.65;transform:scale(.85) translateY(-.5rem) translateX(.15rem)}.form-floating>.form-control:-webkit-autofill~label{opacity:.65;transform:scale(.85) translateY(-.5rem) translateX(.15rem)}.input-group{position:relative;display:flex;flex-wrap:wrap;align-items:stretch;width:100%}.input-group>.form-control,.input-group>.form-select{position:relative;flex:1 1 auto;width:1%;min-width:0}.input-group>.form-control:focus,.input-group>.form-select:focus{z-index:3}.input-group .btn{position:relative;z-index:2}.input-group .btn:focus{z-index:3}.input-group-text{display:flex;align-items:center;padding:.375rem .75rem;font-size:1rem;font-weight:400;line-height:1.5;color:#212529;text-align:center;white-space:nowrap;background-color:#e9ecef;border:1px solid #ced4da;border-radius:.25rem}.input-group-lg>.btn,.input-group-lg>.form-control,.input-group-lg>.form-select,.input-group-lg>.input-group-text{padding:.5rem 1rem;font-size:1.25rem;border-radius:.3rem}.input-group-sm>.btn,.input-group-sm>.form-control,.input-group-sm>.form-select,.input-group-sm>.input-group-text{padding:.25rem .5rem;font-size:.875rem;border-radius:.2rem}.input-group-lg>.form-select,.input-group-sm>.form-select{padding-right:3rem}.input-group:not(.has-validation)>.dropdown-toggle:nth-last-child(n+3),.input-group:not(.has-validation)>:not(:last-child):not(.dropdown-toggle):not(.dropdown-menu){border-top-right-radius:0;border-bottom-right-radius:0}.input-group.has-validation>.dropdown-toggle:nth-last-child(n+4),.input-group.has-validation>:nth-last-child(n+3):not(.dropdown-toggle):not(.dropdown-menu){border-top-right-radius:0;border-bottom-right-radius:0}.input-group>:not(:first-child):not(.dropdown-menu):not(.valid-tooltip):not(.valid-feedback):not(.invalid-tooltip):not(.invalid-feedback){margin-left:-1px;border-top-left-radius:0;border-bottom-left-radius:0}.valid-feedback{display:none;width:100%;margin-top:.25rem;font-size:.875em;color:#198754}.valid-tooltip{position:absolute;top:100%;z-index:5;display:none;max-width:100%;padding:.25rem .5rem;margin-top:.1rem;font-size:.875rem;color:#fff;background-color:rgba(25,135,84,.9);border-radius:.25rem}.is-valid~.valid-feedback,.is-valid~.valid-tooltip,.was-validated :valid~.valid-feedback,.was-validated :valid~.valid-tooltip{display:block}.form-control.is-valid,.was-validated .form-control:valid{border-color:#198754;padding-right:calc(1.5em + .75rem);background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 8 8'%3e%3cpath fill='%23198754' d='M2.3 6.73L.6 4.53c-.4-1.04.46-1.4 1.1-.8l1.1 1.4 3.4-3.8c.6-.63 1.6-.27 1.2.7l-4 4.6c-.43.5-.8.4-1.1.1z'/%3e%3c/svg%3e");background-repeat:no-repeat;background-position:right calc(.375em + .1875rem) center;background-size:calc(.75em + .375rem) calc(.75em + .375rem)}.form-control.is-valid:focus,.was-validated .form-control:valid:focus{border-color:#198754;box-shadow:0 0 0 .25rem rgba(25,135,84,.25)}.was-validated textarea.form-control:valid,textarea.form-control.is-valid{padding-right:calc(1.5em + .75rem);background-position:top calc(.375em + .1875rem) right calc(.375em + .1875rem)}.form-select.is-valid,.was-validated .form-select:valid{border-color:#198754}.form-select.is-valid:not([multiple]):not([size]),.form-select.is-valid:not([multiple])[size="1"],.was-validated .form-select:valid:not([multiple]):not([size]),.was-validated .form-select:valid:not([multiple])[size="1"]{padding-right:4.125rem;background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3e%3cpath fill='none' stroke='%23343a40' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M2 5l6 6 6-6'/%3e%3c/svg%3e"),url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 8 8'%3e%3cpath fill='%23198754' d='M2.3 6.73L.6 4.53c-.4-1.04.46-1.4 1.1-.8l1.1 1.4 3.4-3.8c.6-.63 1.6-.27 1.2.7l-4 4.6c-.43.5-.8.4-1.1.1z'/%3e%3c/svg%3e");background-position:right .75rem center,center right 2.25rem;background-size:16px 12px,calc(.75em + .375rem) calc(.75em + .375rem)}.form-select.is-valid:focus,.was-validated .form-select:valid:focus{border-color:#198754;box-shadow:0 0 0 .25rem rgba(25,135,84,.25)}.form-check-input.is-valid,.was-validated .form-check-input:valid{border-color:#198754}.form-check-input.is-valid:checked,.was-validated .form-check-input:valid:checked{background-color:#198754}.form-check-input.is-valid:focus,.was-validated .form-check-input:valid:focus{box-shadow:0 0 0 .25rem rgba(25,135,84,.25)}.form-check-input.is-valid~.form-check-label,.was-validated .form-check-input:valid~.form-check-label{color:#198754}.form-check-inline .form-check-input~.valid-feedback{margin-left:.5em}.input-group .form-control.is-valid,.input-group .form-select.is-valid,.was-validated .input-group .form-control:valid,.was-validated .input-group .form-select:valid{z-index:1}.input-group .form-control.is-valid:focus,.input-group .form-select.is-valid:focus,.was-validated .input-group .form-control:valid:focus,.was-validated .input-group .form-select:valid:focus{z-index:3}.invalid-feedback{display:none;width:100%;margin-top:.25rem;font-size:.875em;color:#dc3545}.invalid-tooltip{position:absolute;top:100%;z-index:5;display:none;max-width:100%;padding:.25rem .5rem;margin-top:.1rem;font-size:.875rem;color:#fff;background-color:rgba(220,53,69,.9);border-radius:.25rem}.is-invalid~.invalid-feedback,.is-invalid~.invalid-tooltip,.was-validated :invalid~.invalid-feedback,.was-validated :invalid~.invalid-tooltip{display:block}.form-control.is-invalid,.was-validated .form-control:invalid{border-color:#dc3545;padding-right:calc(1.5em + .75rem);background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 12 12' width='12' height='12' fill='none' stroke='%23dc3545'%3e%3ccircle cx='6' cy='6' r='4.5'/%3e%3cpath stroke-linejoin='round' d='M5.8 3.6h.4L6 6.5z'/%3e%3ccircle cx='6' cy='8.2' r='.6' fill='%23dc3545' stroke='none'/%3e%3c/svg%3e");background-repeat:no-repeat;background-position:right calc(.375em + .1875rem) center;background-size:calc(.75em + .375rem) calc(.75em + .375rem)}.form-control.is-invalid:focus,.was-validated .form-control:invalid:focus{border-color:#dc3545;box-shadow:0 0 0 .25rem rgba(220,53,69,.25)}.was-validated textarea.form-control:invalid,textarea.form-control.is-invalid{padding-right:calc(1.5em + .75rem);background-position:top calc(.375em + .1875rem) right calc(.375em + .1875rem)}.form-select.is-invalid,.was-validated .form-select:invalid{border-color:#dc3545}.form-select.is-invalid:not([multiple]):not([size]),.form-select.is-invalid:not([multiple])[size="1"],.was-validated .form-select:invalid:not([multiple]):not([size]),.was-validated .form-select:invalid:not([multiple])[size="1"]{padding-right:4.125rem;background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3e%3cpath fill='none' stroke='%23343a40' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M2 5l6 6 6-6'/%3e%3c/svg%3e"),url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 12 12' width='12' height='12' fill='none' stroke='%23dc3545'%3e%3ccircle cx='6' cy='6' r='4.5'/%3e%3cpath stroke-linejoin='round' d='M5.8 3.6h.4L6 6.5z'/%3e%3ccircle cx='6' cy='8.2' r='.6' fill='%23dc3545' stroke='none'/%3e%3c/svg%3e");background-position:right .75rem center,center right 2.25rem;background-size:16px 12px,calc(.75em + .375rem) calc(.75em + .375rem)}.form-select.is-invalid:focus,.was-validated .form-select:invalid:focus{border-color:#dc3545;box-shadow:0 0 0 .25rem rgba(220,53,69,.25)}.form-check-input.is-invalid,.was-validated .form-check-input:invalid{border-color:#dc3545}.form-check-input.is-invalid:checked,.was-validated .form-check-input:invalid:checked{background-color:#dc3545}.form-check-input.is-invalid:focus,.was-validated .form-check-input:invalid:focus{box-shadow:0 0 0 .25rem rgba(220,53,69,.25)}.form-check-input.is-invalid~.form-check-label,.was-validated .form-check-input:invalid~.form-check-label{color:#dc3545}.form-check-inline .form-check-input~.invalid-feedback{margin-left:.5em}.input-group .form-control.is-invalid,.input-group .form-select.is-invalid,.was-validated .input-group .form-control:invalid,.was-validated .input-group .form-select:invalid{z-index:2}.input-group .form-control.is-invalid:focus,.input-group .form-select.is-invalid:focus,.was-validated .input-group .form-control:invalid:focus,.was-validated .input-group .form-select:invalid:focus{z-index:3}.btn{display:inline-block;font-weight:400;line-height:1.5;color:#212529;text-align:center;text-decoration:none;vertical-align:middle;cursor:pointer;-webkit-user-select:none;-moz-user-select:none;user-select:none;background-color:transparent;border:1px solid transparent;padding:.375rem .75rem;font-size:1rem;border-radius:.25rem;transition:color .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.btn{transition:none}}.btn:hover{color:#212529}.btn-check:focus+.btn,.btn:focus{outline:0;box-shadow:0 0 0 .25rem rgba(13,110,253,.25)}.btn.disabled,.btn:disabled,fieldset:disabled .btn{pointer-events:none;opacity:.65}.btn-primary{color:#fff;background-color:#0d6efd;border-color:#0d6efd}.btn-primary:hover{color:#fff;background-color:#0b5ed7;border-color:#0a58ca}.btn-check:focus+.btn-primary,.btn-primary:focus{color:#fff;background-color:#0b5ed7;border-color:#0a58ca;box-shadow:0 0 0 .25rem rgba(49,132,253,.5)}.btn-check:active+.btn-primary,.btn-check:checked+.btn-primary,.btn-primary.active,.btn-primary:active,.show>.btn-primary.dropdown-toggle{color:#fff;background-color:#0a58ca;border-color:#0a53be}.btn-check:active+.btn-primary:focus,.btn-check:checked+.btn-primary:focus,.btn-primary.active:focus,.btn-primary:active:focus,.show>.btn-primary.dropdown-toggle:focus{box-shadow:0 0 0 .25rem rgba(49,132,253,.5)}.btn-primary.disabled,.btn-primary:disabled{color:#fff;background-color:#0d6efd;border-color:#0d6efd}.btn-secondary{color:#fff;background-color:#6c757d;border-color:#6c757d}.btn-secondary:hover{color:#fff;background-color:#5c636a;border-color:#565e64}.btn-check:focus+.btn-secondary,.btn-secondary:focus{color:#fff;background-color:#5c636a;border-color:#565e64;box-shadow:0 0 0 .25rem rgba(130,138,145,.5)}.btn-check:active+.btn-secondary,.btn-check:checked+.btn-secondary,.btn-secondary.active,.btn-secondary:active,.show>.btn-secondary.dropdown-toggle{color:#fff;background-color:#565e64;border-color:#51585e}.btn-check:active+.btn-secondary:focus,.btn-check:checked+.btn-secondary:focus,.btn-secondary.active:focus,.btn-secondary:active:focus,.show>.btn-secondary.dropdown-toggle:focus{box-shadow:0 0 0 .25rem rgba(130,138,145,.5)}.btn-secondary.disabled,.btn-secondary:disabled{color:#fff;background-color:#6c757d;border-color:#6c757d}.btn-success{color:#fff;background-color:#198754;border-color:#198754}.btn-success:hover{color:#fff;background-color:#157347;border-color:#146c43}.btn-check:focus+.btn-success,.btn-success:focus{color:#fff;background-color:#157347;border-color:#146c43;box-shadow:0 0 0 .25rem rgba(60,153,110,.5)}.btn-check:active+.btn-success,.btn-check:checked+.btn-success,.btn-success.active,.btn-success:active,.show>.btn-success.dropdown-toggle{color:#fff;background-color:#146c43;border-color:#13653f}.btn-check:active+.btn-success:focus,.btn-check:checked+.btn-success:focus,.btn-success.active:focus,.btn-success:active:focus,.show>.btn-success.dropdown-toggle:focus{box-shadow:0 0 0 .25rem rgba(60,153,110,.5)}.btn-success.disabled,.btn-success:disabled{color:#fff;background-color:#198754;border-color:#198754}.btn-info{color:#000;background-color:#0dcaf0;border-color:#0dcaf0}.btn-info:hover{color:#000;background-color:#31d2f2;border-color:#25cff2}.btn-check:focus+.btn-info,.btn-info:focus{color:#000;background-color:#31d2f2;border-color:#25cff2;box-shadow:0 0 0 .25rem rgba(11,172,204,.5)}.btn-check:active+.btn-info,.btn-check:checked+.btn-info,.btn-info.active,.btn-info:active,.show>.btn-info.dropdown-toggle{color:#000;background-color:#3dd5f3;border-color:#25cff2}.btn-check:active+.btn-info:focus,.btn-check:checked+.btn-info:focus,.btn-info.active:focus,.btn-info:active:focus,.show>.btn-info.dropdown-toggle:focus{box-shadow:0 0 0 .25rem rgba(11,172,204,.5)}.btn-info.disabled,.btn-info:disabled{color:#000;background-color:#0dcaf0;border-color:#0dcaf0}.btn-warning{color:#000;background-color:#ffc107;border-color:#ffc107}.btn-warning:hover{color:#000;background-color:#ffca2c;border-color:#ffc720}.btn-check:focus+.btn-warning,.btn-warning:focus{color:#000;background-color:#ffca2c;border-color:#ffc720;box-shadow:0 0 0 .25rem rgba(217,164,6,.5)}.btn-check:active+.btn-warning,.btn-check:checked+.btn-warning,.btn-warning.active,.btn-warning:active,.show>.btn-warning.dropdown-toggle{color:#000;background-color:#ffcd39;border-color:#ffc720}.btn-check:active+.btn-warning:focus,.btn-check:checked+.btn-warning:focus,.btn-warning.active:focus,.btn-warning:active:focus,.show>.btn-warning.dropdown-toggle:focus{box-shadow:0 0 0 .25rem rgba(217,164,6,.5)}.btn-warning.disabled,.btn-warning:disabled{color:#000;background-color:#ffc107;border-color:#ffc107}.btn-danger{color:#fff;background-color:#dc3545;border-color:#dc3545}.btn-danger:hover{color:#fff;background-color:#bb2d3b;border-color:#b02a37}.btn-check:focus+.btn-danger,.btn-danger:focus{color:#fff;background-color:#bb2d3b;border-color:#b02a37;box-shadow:0 0 0 .25rem rgba(225,83,97,.5)}.btn-check:active+.btn-danger,.btn-check:checked+.btn-danger,.btn-danger.active,.btn-danger:active,.show>.btn-danger.dropdown-toggle{color:#fff;background-color:#b02a37;border-color:#a52834}.btn-check:active+.btn-danger:focus,.btn-check:checked+.btn-danger:focus,.btn-danger.active:focus,.btn-danger:active:focus,.show>.btn-danger.dropdown-toggle:focus{box-shadow:0 0 0 .25rem rgba(225,83,97,.5)}.btn-danger.disabled,.btn-danger:disabled{color:#fff;background-color:#dc3545;border-color:#dc3545}.btn-light{color:#000;background-color:#f8f9fa;border-color:#f8f9fa}.btn-light:hover{color:#000;background-color:#f9fafb;border-color:#f9fafb}.btn-check:focus+.btn-light,.btn-light:focus{color:#000;background-color:#f9fafb;border-color:#f9fafb;box-shadow:0 0 0 .25rem rgba(211,212,213,.5)}.btn-check:active+.btn-light,.btn-check:checked+.btn-light,.btn-light.active,.btn-light:active,.show>.btn-light.dropdown-toggle{color:#000;background-color:#f9fafb;border-color:#f9fafb}.btn-check:active+.btn-light:focus,.btn-check:checked+.btn-light:focus,.btn-light.active:focus,.btn-light:active:focus,.show>.btn-light.dropdown-toggle:focus{box-shadow:0 0 0 .25rem rgba(211,212,213,.5)}.btn-light.disabled,.btn-light:disabled{color:#000;background-color:#f8f9fa;border-color:#f8f9fa}.btn-dark{color:#fff;background-color:#212529;border-color:#212529}.btn-dark:hover{color:#fff;background-color:#1c1f23;border-color:#1a1e21}.btn-check:focus+.btn-dark,.btn-dark:focus{color:#fff;background-color:#1c1f23;border-color:#1a1e21;box-shadow:0 0 0 .25rem rgba(66,70,73,.5)}.btn-check:active+.btn-dark,.btn-check:checked+.btn-dark,.btn-dark.active,.btn-dark:active,.show>.btn-dark.dropdown-toggle{color:#fff;background-color:#1a1e21;border-color:#191c1f}.btn-check:active+.btn-dark:focus,.btn-check:checked+.btn-dark:focus,.btn-dark.active:focus,.btn-dark:active:focus,.show>.btn-dark.dropdown-toggle:focus{box-shadow:0 0 0 .25rem rgba(66,70,73,.5)}.btn-dark.disabled,.btn-dark:disabled{color:#fff;background-color:#212529;border-color:#212529}.btn-outline-primary{color:#0d6efd;border-color:#0d6efd}.btn-outline-primary:hover{color:#fff;background-color:#0d6efd;border-color:#0d6efd}.btn-check:focus+.btn-outline-primary,.btn-outline-primary:focus{box-shadow:0 0 0 .25rem rgba(13,110,253,.5)}.btn-check:active+.btn-outline-primary,.btn-check:checked+.btn-outline-primary,.btn-outline-primary.active,.btn-outline-primary.dropdown-toggle.show,.btn-outline-primary:active{color:#fff;background-color:#0d6efd;border-color:#0d6efd}.btn-check:active+.btn-outline-primary:focus,.btn-check:checked+.btn-outline-primary:focus,.btn-outline-primary.active:focus,.btn-outline-primary.dropdown-toggle.show:focus,.btn-outline-primary:active:focus{box-shadow:0 0 0 .25rem rgba(13,110,253,.5)}.btn-outline-primary.disabled,.btn-outline-primary:disabled{color:#0d6efd;background-color:transparent}.btn-outline-secondary{color:#6c757d;border-color:#6c757d}.btn-outline-secondary:hover{color:#fff;background-color:#6c757d;border-color:#6c757d}.btn-check:focus+.btn-outline-secondary,.btn-outline-secondary:focus{box-shadow:0 0 0 .25rem rgba(108,117,125,.5)}.btn-check:active+.btn-outline-secondary,.btn-check:checked+.btn-outline-secondary,.btn-outline-secondary.active,.btn-outline-secondary.dropdown-toggle.show,.btn-outline-secondary:active{color:#fff;background-color:#6c757d;border-color:#6c757d}.btn-check:active+.btn-outline-secondary:focus,.btn-check:checked+.btn-outline-secondary:focus,.btn-outline-secondary.active:focus,.btn-outline-secondary.dropdown-toggle.show:focus,.btn-outline-secondary:active:focus{box-shadow:0 0 0 .25rem rgba(108,117,125,.5)}.btn-outline-secondary.disabled,.btn-outline-secondary:disabled{color:#6c757d;background-color:transparent}.btn-outline-success{color:#198754;border-color:#198754}.btn-outline-success:hover{color:#fff;background-color:#198754;border-color:#198754}.btn-check:focus+.btn-outline-success,.btn-outline-success:focus{box-shadow:0 0 0 .25rem rgba(25,135,84,.5)}.btn-check:active+.btn-outline-success,.btn-check:checked+.btn-outline-success,.btn-outline-success.active,.btn-outline-success.dropdown-toggle.show,.btn-outline-success:active{color:#fff;background-color:#198754;border-color:#198754}.btn-check:active+.btn-outline-success:focus,.btn-check:checked+.btn-outline-success:focus,.btn-outline-success.active:focus,.btn-outline-success.dropdown-toggle.show:focus,.btn-outline-success:active:focus{box-shadow:0 0 0 .25rem rgba(25,135,84,.5)}.btn-outline-success.disabled,.btn-outline-success:disabled{color:#198754;background-color:transparent}.btn-outline-info{color:#0dcaf0;border-color:#0dcaf0}.btn-outline-info:hover{color:#000;background-color:#0dcaf0;border-color:#0dcaf0}.btn-check:focus+.btn-outline-info,.btn-outline-info:focus{box-shadow:0 0 0 .25rem rgba(13,202,240,.5)}.btn-check:active+.btn-outline-info,.btn-check:checked+.btn-outline-info,.btn-outline-info.active,.btn-outline-info.dropdown-toggle.show,.btn-outline-info:active{color:#000;background-color:#0dcaf0;border-color:#0dcaf0}.btn-check:active+.btn-outline-info:focus,.btn-check:checked+.btn-outline-info:focus,.btn-outline-info.active:focus,.btn-outline-info.dropdown-toggle.show:focus,.btn-outline-info:active:focus{box-shadow:0 0 0 .25rem rgba(13,202,240,.5)}.btn-outline-info.disabled,.btn-outline-info:disabled{color:#0dcaf0;background-color:transparent}.btn-outline-warning{color:#ffc107;border-color:#ffc107}.btn-outline-warning:hover{color:#000;background-color:#ffc107;border-color:#ffc107}.btn-check:focus+.btn-outline-warning,.btn-outline-warning:focus{box-shadow:0 0 0 .25rem rgba(255,193,7,.5)}.btn-check:active+.btn-outline-warning,.btn-check:checked+.btn-outline-warning,.btn-outline-warning.active,.btn-outline-warning.dropdown-toggle.show,.btn-outline-warning:active{color:#000;background-color:#ffc107;border-color:#ffc107}.btn-check:active+.btn-outline-warning:focus,.btn-check:checked+.btn-outline-warning:focus,.btn-outline-warning.active:focus,.btn-outline-warning.dropdown-toggle.show:focus,.btn-outline-warning:active:focus{box-shadow:0 0 0 .25rem rgba(255,193,7,.5)}.btn-outline-warning.disabled,.btn-outline-warning:disabled{color:#ffc107;background-color:transparent}.btn-outline-danger{color:#dc3545;border-color:#dc3545}.btn-outline-danger:hover{color:#fff;background-color:#dc3545;border-color:#dc3545}.btn-check:focus+.btn-outline-danger,.btn-outline-danger:focus{box-shadow:0 0 0 .25rem rgba(220,53,69,.5)}.btn-check:active+.btn-outline-danger,.btn-check:checked+.btn-outline-danger,.btn-outline-danger.active,.btn-outline-danger.dropdown-toggle.show,.btn-outline-danger:active{color:#fff;background-color:#dc3545;border-color:#dc3545}.btn-check:active+.btn-outline-danger:focus,.btn-check:checked+.btn-outline-danger:focus,.btn-outline-danger.active:focus,.btn-outline-danger.dropdown-toggle.show:focus,.btn-outline-danger:active:focus{box-shadow:0 0 0 .25rem rgba(220,53,69,.5)}.btn-outline-danger.disabled,.btn-outline-danger:disabled{color:#dc3545;background-color:transparent}.btn-outline-light{color:#f8f9fa;border-color:#f8f9fa}.btn-outline-light:hover{color:#000;background-color:#f8f9fa;border-color:#f8f9fa}.btn-check:focus+.btn-outline-light,.btn-outline-light:focus{box-shadow:0 0 0 .25rem rgba(248,249,250,.5)}.btn-check:active+.btn-outline-light,.btn-check:checked+.btn-outline-light,.btn-outline-light.active,.btn-outline-light.dropdown-toggle.show,.btn-outline-light:active{color:#000;background-color:#f8f9fa;border-color:#f8f9fa}.btn-check:active+.btn-outline-light:focus,.btn-check:checked+.btn-outline-light:focus,.btn-outline-light.active:focus,.btn-outline-light.dropdown-toggle.show:focus,.btn-outline-light:active:focus{box-shadow:0 0 0 .25rem rgba(248,249,250,.5)}.btn-outline-light.disabled,.btn-outline-light:disabled{color:#f8f9fa;background-color:transparent}.btn-outline-dark{color:#212529;border-color:#212529}.btn-outline-dark:hover{color:#fff;background-color:#212529;border-color:#212529}.btn-check:focus+.btn-outline-dark,.btn-outline-dark:focus{box-shadow:0 0 0 .25rem rgba(33,37,41,.5)}.btn-check:active+.btn-outline-dark,.btn-check:checked+.btn-outline-dark,.btn-outline-dark.active,.btn-outline-dark.dropdown-toggle.show,.btn-outline-dark:active{color:#fff;background-color:#212529;border-color:#212529}.btn-check:active+.btn-outline-dark:focus,.btn-check:checked+.btn-outline-dark:focus,.btn-outline-dark.active:focus,.btn-outline-dark.dropdown-toggle.show:focus,.btn-outline-dark:active:focus{box-shadow:0 0 0 .25rem rgba(33,37,41,.5)}.btn-outline-dark.disabled,.btn-outline-dark:disabled{color:#212529;background-color:transparent}.btn-link{font-weight:400;color:#0d6efd;text-decoration:underline}.btn-link:hover{color:#0a58ca}.btn-link.disabled,.btn-link:disabled{color:#6c757d}.btn-group-lg>.btn,.btn-lg{padding:.5rem 1rem;font-size:1.25rem;border-radius:.3rem}.btn-group-sm>.btn,.btn-sm{padding:.25rem .5rem;font-size:.875rem;border-radius:.2rem}.fade{transition:opacity .15s linear}@media (prefers-reduced-motion:reduce){.fade{transition:none}}.fade:not(.show){opacity:0}.collapse:not(.show){display:none}.collapsing{height:0;overflow:hidden;transition:height .35s ease}@media (prefers-reduced-motion:reduce){.collapsing{transition:none}}.collapsing.collapse-horizontal{width:0;height:auto;transition:width .35s ease}@media (prefers-reduced-motion:reduce){.collapsing.collapse-horizontal{transition:none}}.dropdown,.dropend,.dropstart,.dropup{position:relative}.dropdown-toggle{white-space:nowrap}.dropdown-toggle::after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:"";border-top:.3em solid;border-right:.3em solid transparent;border-bottom:0;border-left:.3em solid transparent}.dropdown-toggle:empty::after{margin-left:0}.dropdown-menu{position:absolute;z-index:1000;display:none;min-width:10rem;padding:.5rem 0;margin:0;font-size:1rem;color:#212529;text-align:left;list-style:none;background-color:#fff;background-clip:padding-box;border:1px solid rgba(0,0,0,.15);border-radius:.25rem}.dropdown-menu[data-bs-popper]{top:100%;left:0;margin-top:.125rem}.dropdown-menu-start{--bs-position:start}.dropdown-menu-start[data-bs-popper]{right:auto;left:0}.dropdown-menu-end{--bs-position:end}.dropdown-menu-end[data-bs-popper]{right:0;left:auto}@media (min-width:576px){.dropdown-menu-sm-start{--bs-position:start}.dropdown-menu-sm-start[data-bs-popper]{right:auto;left:0}.dropdown-menu-sm-end{--bs-position:end}.dropdown-menu-sm-end[data-bs-popper]{right:0;left:auto}}@media (min-width:768px){.dropdown-menu-md-start{--bs-position:start}.dropdown-menu-md-start[data-bs-popper]{right:auto;left:0}.dropdown-menu-md-end{--bs-position:end}.dropdown-menu-md-end[data-bs-popper]{right:0;left:auto}}@media (min-width:992px){.dropdown-menu-lg-start{--bs-position:start}.dropdown-menu-lg-start[data-bs-popper]{right:auto;left:0}.dropdown-menu-lg-end{--bs-position:end}.dropdown-menu-lg-end[data-bs-popper]{right:0;left:auto}}@media (min-width:1200px){.dropdown-menu-xl-start{--bs-position:start}.dropdown-menu-xl-start[data-bs-popper]{right:auto;left:0}.dropdown-menu-xl-end{--bs-position:end}.dropdown-menu-xl-end[data-bs-popper]{right:0;left:auto}}@media (min-width:1400px){.dropdown-menu-xxl-start{--bs-position:start}.dropdown-menu-xxl-start[data-bs-popper]{right:auto;left:0}.dropdown-menu-xxl-end{--bs-position:end}.dropdown-menu-xxl-end[data-bs-popper]{right:0;left:auto}}.dropup .dropdown-menu[data-bs-popper]{top:auto;bottom:100%;margin-top:0;margin-bottom:.125rem}.dropup .dropdown-toggle::after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:"";border-top:0;border-right:.3em solid transparent;border-bottom:.3em solid;border-left:.3em solid transparent}.dropup .dropdown-toggle:empty::after{margin-left:0}.dropend .dropdown-menu[data-bs-popper]{top:0;right:auto;left:100%;margin-top:0;margin-left:.125rem}.dropend .dropdown-toggle::after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:"";border-top:.3em solid transparent;border-right:0;border-bottom:.3em solid transparent;border-left:.3em solid}.dropend .dropdown-toggle:empty::after{margin-left:0}.dropend .dropdown-toggle::after{vertical-align:0}.dropstart .dropdown-menu[data-bs-popper]{top:0;right:100%;left:auto;margin-top:0;margin-right:.125rem}.dropstart .dropdown-toggle::after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:""}.dropstart .dropdown-toggle::after{display:none}.dropstart .dropdown-toggle::before{display:inline-block;margin-right:.255em;vertical-align:.255em;content:"";border-top:.3em solid transparent;border-right:.3em solid;border-bottom:.3em solid transparent}.dropstart .dropdown-toggle:empty::after{margin-left:0}.dropstart .dropdown-toggle::before{vertical-align:0}.dropdown-divider{height:0;margin:.5rem 0;overflow:hidden;border-top:1px solid rgba(0,0,0,.15)}.dropdown-item{display:block;width:100%;padding:.25rem 1rem;clear:both;font-weight:400;color:#212529;text-align:inherit;text-decoration:none;white-space:nowrap;background-color:transparent;border:0}.dropdown-item:focus,.dropdown-item:hover{color:#1e2125;background-color:#e9ecef}.dropdown-item.active,.dropdown-item:active{color:#fff;text-decoration:none;background-color:#0d6efd}.dropdown-item.disabled,.dropdown-item:disabled{color:#adb5bd;pointer-events:none;background-color:transparent}.dropdown-menu.show{display:block}.dropdown-header{display:block;padding:.5rem 1rem;margin-bottom:0;font-size:.875rem;color:#6c757d;white-space:nowrap}.dropdown-item-text{display:block;padding:.25rem 1rem;color:#212529}.dropdown-menu-dark{color:#dee2e6;background-color:#343a40;border-color:rgba(0,0,0,.15)}.dropdown-menu-dark .dropdown-item{color:#dee2e6}.dropdown-menu-dark .dropdown-item:focus,.dropdown-menu-dark .dropdown-item:hover{color:#fff;background-color:rgba(255,255,255,.15)}.dropdown-menu-dark .dropdown-item.active,.dropdown-menu-dark .dropdown-item:active{color:#fff;background-color:#0d6efd}.dropdown-menu-dark .dropdown-item.disabled,.dropdown-menu-dark .dropdown-item:disabled{color:#adb5bd}.dropdown-menu-dark .dropdown-divider{border-color:rgba(0,0,0,.15)}.dropdown-menu-dark .dropdown-item-text{color:#dee2e6}.dropdown-menu-dark .dropdown-header{color:#adb5bd}.btn-group,.btn-group-vertical{position:relative;display:inline-flex;vertical-align:middle}.btn-group-vertical>.btn,.btn-group>.btn{position:relative;flex:1 1 auto}.btn-group-vertical>.btn-check:checked+.btn,.btn-group-vertical>.btn-check:focus+.btn,.btn-group-vertical>.btn.active,.btn-group-vertical>.btn:active,.btn-group-vertical>.btn:focus,.btn-group-vertical>.btn:hover,.btn-group>.btn-check:checked+.btn,.btn-group>.btn-check:focus+.btn,.btn-group>.btn.active,.btn-group>.btn:active,.btn-group>.btn:focus,.btn-group>.btn:hover{z-index:1}.btn-toolbar{display:flex;flex-wrap:wrap;justify-content:flex-start}.btn-toolbar .input-group{width:auto}.btn-group>.btn-group:not(:first-child),.btn-group>.btn:not(:first-child){margin-left:-1px}.btn-group>.btn-group:not(:last-child)>.btn,.btn-group>.btn:not(:last-child):not(.dropdown-toggle){border-top-right-radius:0;border-bottom-right-radius:0}.btn-group>.btn-group:not(:first-child)>.btn,.btn-group>.btn:nth-child(n+3),.btn-group>:not(.btn-check)+.btn{border-top-left-radius:0;border-bottom-left-radius:0}.dropdown-toggle-split{padding-right:.5625rem;padding-left:.5625rem}.dropdown-toggle-split::after,.dropend .dropdown-toggle-split::after,.dropup .dropdown-toggle-split::after{margin-left:0}.dropstart .dropdown-toggle-split::before{margin-right:0}.btn-group-sm>.btn+.dropdown-toggle-split,.btn-sm+.dropdown-toggle-split{padding-right:.375rem;padding-left:.375rem}.btn-group-lg>.btn+.dropdown-toggle-split,.btn-lg+.dropdown-toggle-split{padding-right:.75rem;padding-left:.75rem}.btn-group-vertical{flex-direction:column;align-items:flex-start;justify-content:center}.btn-group-vertical>.btn,.btn-group-vertical>.btn-group{width:100%}.btn-group-vertical>.btn-group:not(:first-child),.btn-group-vertical>.btn:not(:first-child){margin-top:-1px}.btn-group-vertical>.btn-group:not(:last-child)>.btn,.btn-group-vertical>.btn:not(:last-child):not(.dropdown-toggle){border-bottom-right-radius:0;border-bottom-left-radius:0}.btn-group-vertical>.btn-group:not(:first-child)>.btn,.btn-group-vertical>.btn~.btn{border-top-left-radius:0;border-top-right-radius:0}.nav{display:flex;flex-wrap:wrap;padding-left:0;margin-bottom:0;list-style:none}.nav-link{display:block;padding:.5rem 1rem;color:#0d6efd;text-decoration:none;transition:color .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out}@media (prefers-reduced-motion:reduce){.nav-link{transition:none}}.nav-link:focus,.nav-link:hover{color:#0a58ca}.nav-link.disabled{color:#6c757d;pointer-events:none;cursor:default}.nav-tabs{border-bottom:1px solid #dee2e6}.nav-tabs .nav-link{margin-bottom:-1px;background:0 0;border:1px solid transparent;border-top-left-radius:.25rem;border-top-right-radius:.25rem}.nav-tabs .nav-link:focus,.nav-tabs .nav-link:hover{border-color:#e9ecef #e9ecef #dee2e6;isolation:isolate}.nav-tabs .nav-link.disabled{color:#6c757d;background-color:transparent;border-color:transparent}.nav-tabs .nav-item.show .nav-link,.nav-tabs .nav-link.active{color:#495057;background-color:#fff;border-color:#dee2e6 #dee2e6 #fff}.nav-tabs .dropdown-menu{margin-top:-1px;border-top-left-radius:0;border-top-right-radius:0}.nav-pills .nav-link{background:0 0;border:0;border-radius:.25rem}.nav-pills .nav-link.active,.nav-pills .show>.nav-link{color:#fff;background-color:#0d6efd}.nav-fill .nav-item,.nav-fill>.nav-link{flex:1 1 auto;text-align:center}.nav-justified .nav-item,.nav-justified>.nav-link{flex-basis:0;flex-grow:1;text-align:center}.nav-fill .nav-item .nav-link,.nav-justified .nav-item .nav-link{width:100%}.tab-content>.tab-pane{display:none}.tab-content>.active{display:block}.navbar{position:relative;display:flex;flex-wrap:wrap;align-items:center;justify-content:space-between;padding-top:.5rem;padding-bottom:.5rem}.navbar>.container,.navbar>.container-fluid,.navbar>.container-lg,.navbar>.container-md,.navbar>.container-sm,.navbar>.container-xl,.navbar>.container-xxl{display:flex;flex-wrap:inherit;align-items:center;justify-content:space-between}.navbar-brand{padding-top:.3125rem;padding-bottom:.3125rem;margin-right:1rem;font-size:1.25rem;text-decoration:none;white-space:nowrap}.navbar-nav{display:flex;flex-direction:column;padding-left:0;margin-bottom:0;list-style:none}.navbar-nav .nav-link{padding-right:0;padding-left:0}.navbar-nav .dropdown-menu{position:static}.navbar-text{padding-top:.5rem;padding-bottom:.5rem}.navbar-collapse{flex-basis:100%;flex-grow:1;align-items:center}.navbar-toggler{padding:.25rem .75rem;font-size:1.25rem;line-height:1;background-color:transparent;border:1px solid transparent;border-radius:.25rem;transition:box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.navbar-toggler{transition:none}}.navbar-toggler:hover{text-decoration:none}.navbar-toggler:focus{text-decoration:none;outline:0;box-shadow:0 0 0 .25rem}.navbar-toggler-icon{display:inline-block;width:1.5em;height:1.5em;vertical-align:middle;background-repeat:no-repeat;background-position:center;background-size:100%}.navbar-nav-scroll{max-height:var(--bs-scroll-height,75vh);overflow-y:auto}@media (min-width:576px){.navbar-expand-sm{flex-wrap:nowrap;justify-content:flex-start}.navbar-expand-sm .navbar-nav{flex-direction:row}.navbar-expand-sm .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-sm .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand-sm .navbar-nav-scroll{overflow:visible}.navbar-expand-sm .navbar-collapse{display:flex!important;flex-basis:auto}.navbar-expand-sm .navbar-toggler{display:none}.navbar-expand-sm .offcanvas-header{display:none}.navbar-expand-sm .offcanvas{position:inherit;bottom:0;z-index:1000;flex-grow:1;visibility:visible!important;background-color:transparent;border-right:0;border-left:0;transition:none;transform:none}.navbar-expand-sm .offcanvas-bottom,.navbar-expand-sm .offcanvas-top{height:auto;border-top:0;border-bottom:0}.navbar-expand-sm .offcanvas-body{display:flex;flex-grow:0;padding:0;overflow-y:visible}}@media (min-width:768px){.navbar-expand-md{flex-wrap:nowrap;justify-content:flex-start}.navbar-expand-md .navbar-nav{flex-direction:row}.navbar-expand-md .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-md .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand-md .navbar-nav-scroll{overflow:visible}.navbar-expand-md .navbar-collapse{display:flex!important;flex-basis:auto}.navbar-expand-md .navbar-toggler{display:none}.navbar-expand-md .offcanvas-header{display:none}.navbar-expand-md .offcanvas{position:inherit;bottom:0;z-index:1000;flex-grow:1;visibility:visible!important;background-color:transparent;border-right:0;border-left:0;transition:none;transform:none}.navbar-expand-md .offcanvas-bottom,.navbar-expand-md .offcanvas-top{height:auto;border-top:0;border-bottom:0}.navbar-expand-md .offcanvas-body{display:flex;flex-grow:0;padding:0;overflow-y:visible}}@media (min-width:992px){.navbar-expand-lg{flex-wrap:nowrap;justify-content:flex-start}.navbar-expand-lg .navbar-nav{flex-direction:row}.navbar-expand-lg .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-lg .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand-lg .navbar-nav-scroll{overflow:visible}.navbar-expand-lg .navbar-collapse{display:flex!important;flex-basis:auto}.navbar-expand-lg .navbar-toggler{display:none}.navbar-expand-lg .offcanvas-header{display:none}.navbar-expand-lg .offcanvas{position:inherit;bottom:0;z-index:1000;flex-grow:1;visibility:visible!important;background-color:transparent;border-right:0;border-left:0;transition:none;transform:none}.navbar-expand-lg .offcanvas-bottom,.navbar-expand-lg .offcanvas-top{height:auto;border-top:0;border-bottom:0}.navbar-expand-lg .offcanvas-body{display:flex;flex-grow:0;padding:0;overflow-y:visible}}@media (min-width:1200px){.navbar-expand-xl{flex-wrap:nowrap;justify-content:flex-start}.navbar-expand-xl .navbar-nav{flex-direction:row}.navbar-expand-xl .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-xl .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand-xl .navbar-nav-scroll{overflow:visible}.navbar-expand-xl .navbar-collapse{display:flex!important;flex-basis:auto}.navbar-expand-xl .navbar-toggler{display:none}.navbar-expand-xl .offcanvas-header{display:none}.navbar-expand-xl .offcanvas{position:inherit;bottom:0;z-index:1000;flex-grow:1;visibility:visible!important;background-color:transparent;border-right:0;border-left:0;transition:none;transform:none}.navbar-expand-xl .offcanvas-bottom,.navbar-expand-xl .offcanvas-top{height:auto;border-top:0;border-bottom:0}.navbar-expand-xl .offcanvas-body{display:flex;flex-grow:0;padding:0;overflow-y:visible}}@media (min-width:1400px){.navbar-expand-xxl{flex-wrap:nowrap;justify-content:flex-start}.navbar-expand-xxl .navbar-nav{flex-direction:row}.navbar-expand-xxl .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-xxl .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand-xxl .navbar-nav-scroll{overflow:visible}.navbar-expand-xxl .navbar-collapse{display:flex!important;flex-basis:auto}.navbar-expand-xxl .navbar-toggler{display:none}.navbar-expand-xxl .offcanvas-header{display:none}.navbar-expand-xxl .offcanvas{position:inherit;bottom:0;z-index:1000;flex-grow:1;visibility:visible!important;background-color:transparent;border-right:0;border-left:0;transition:none;transform:none}.navbar-expand-xxl .offcanvas-bottom,.navbar-expand-xxl .offcanvas-top{height:auto;border-top:0;border-bottom:0}.navbar-expand-xxl .offcanvas-body{display:flex;flex-grow:0;padding:0;overflow-y:visible}}.navbar-expand{flex-wrap:nowrap;justify-content:flex-start}.navbar-expand .navbar-nav{flex-direction:row}.navbar-expand .navbar-nav .dropdown-menu{position:absolute}.navbar-expand .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand .navbar-nav-scroll{overflow:visible}.navbar-expand .navbar-collapse{display:flex!important;flex-basis:auto}.navbar-expand .navbar-toggler{display:none}.navbar-expand .offcanvas-header{display:none}.navbar-expand .offcanvas{position:inherit;bottom:0;z-index:1000;flex-grow:1;visibility:visible!important;background-color:transparent;border-right:0;border-left:0;transition:none;transform:none}.navbar-expand .offcanvas-bottom,.navbar-expand .offcanvas-top{height:auto;border-top:0;border-bottom:0}.navbar-expand .offcanvas-body{display:flex;flex-grow:0;padding:0;overflow-y:visible}.navbar-light .navbar-brand{color:rgba(0,0,0,.9)}.navbar-light .navbar-brand:focus,.navbar-light .navbar-brand:hover{color:rgba(0,0,0,.9)}.navbar-light .navbar-nav .nav-link{color:rgba(0,0,0,.55)}.navbar-light .navbar-nav .nav-link:focus,.navbar-light .navbar-nav .nav-link:hover{color:rgba(0,0,0,.7)}.navbar-light .navbar-nav .nav-link.disabled{color:rgba(0,0,0,.3)}.navbar-light .navbar-nav .nav-link.active,.navbar-light .navbar-nav .show>.nav-link{color:rgba(0,0,0,.9)}.navbar-light .navbar-toggler{color:rgba(0,0,0,.55);border-color:rgba(0,0,0,.1)}.navbar-light .navbar-toggler-icon{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 30 30'%3e%3cpath stroke='rgba%280, 0, 0, 0.55%29' stroke-linecap='round' stroke-miterlimit='10' stroke-width='2' d='M4 7h22M4 15h22M4 23h22'/%3e%3c/svg%3e")}.navbar-light .navbar-text{color:rgba(0,0,0,.55)}.navbar-light .navbar-text a,.navbar-light .navbar-text a:focus,.navbar-light .navbar-text a:hover{color:rgba(0,0,0,.9)}.navbar-dark .navbar-brand{color:#fff}.navbar-dark .navbar-brand:focus,.navbar-dark .navbar-brand:hover{color:#fff}.navbar-dark .navbar-nav .nav-link{color:rgba(255,255,255,.55)}.navbar-dark .navbar-nav .nav-link:focus,.navbar-dark .navbar-nav .nav-link:hover{color:rgba(255,255,255,.75)}.navbar-dark .navbar-nav .nav-link.disabled{color:rgba(255,255,255,.25)}.navbar-dark .navbar-nav .nav-link.active,.navbar-dark .navbar-nav .show>.nav-link{color:#fff}.navbar-dark .navbar-toggler{color:rgba(255,255,255,.55);border-color:rgba(255,255,255,.1)}.navbar-dark .navbar-toggler-icon{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 30 30'%3e%3cpath stroke='rgba%28255, 255, 255, 0.55%29' stroke-linecap='round' stroke-miterlimit='10' stroke-width='2' d='M4 7h22M4 15h22M4 23h22'/%3e%3c/svg%3e")}.navbar-dark .navbar-text{color:rgba(255,255,255,.55)}.navbar-dark .navbar-text a,.navbar-dark .navbar-text a:focus,.navbar-dark .navbar-text a:hover{color:#fff}.card{position:relative;display:flex;flex-direction:column;min-width:0;word-wrap:break-word;background-color:#fff;background-clip:border-box;border:1px solid rgba(0,0,0,.125);border-radius:.25rem}.card>hr{margin-right:0;margin-left:0}.card>.list-group{border-top:inherit;border-bottom:inherit}.card>.list-group:first-child{border-top-width:0;border-top-left-radius:calc(.25rem - 1px);border-top-right-radius:calc(.25rem - 1px)}.card>.list-group:last-child{border-bottom-width:0;border-bottom-right-radius:calc(.25rem - 1px);border-bottom-left-radius:calc(.25rem - 1px)}.card>.card-header+.list-group,.card>.list-group+.card-footer{border-top:0}.card-body{flex:1 1 auto;padding:1rem 1rem}.card-title{margin-bottom:.5rem}.card-subtitle{margin-top:-.25rem;margin-bottom:0}.card-text:last-child{margin-bottom:0}.card-link+.card-link{margin-left:1rem}.card-header{padding:.5rem 1rem;margin-bottom:0;background-color:rgba(0,0,0,.03);border-bottom:1px solid rgba(0,0,0,.125)}.card-header:first-child{border-radius:calc(.25rem - 1px) calc(.25rem - 1px) 0 0}.card-footer{padding:.5rem 1rem;background-color:rgba(0,0,0,.03);border-top:1px solid rgba(0,0,0,.125)}.card-footer:last-child{border-radius:0 0 calc(.25rem - 1px) calc(.25rem - 1px)}.card-header-tabs{margin-right:-.5rem;margin-bottom:-.5rem;margin-left:-.5rem;border-bottom:0}.card-header-pills{margin-right:-.5rem;margin-left:-.5rem}.card-img-overlay{position:absolute;top:0;right:0;bottom:0;left:0;padding:1rem;border-radius:calc(.25rem - 1px)}.card-img,.card-img-bottom,.card-img-top{width:100%}.card-img,.card-img-top{border-top-left-radius:calc(.25rem - 1px);border-top-right-radius:calc(.25rem - 1px)}.card-img,.card-img-bottom{border-bottom-right-radius:calc(.25rem - 1px);border-bottom-left-radius:calc(.25rem - 1px)}.card-group>.card{margin-bottom:.75rem}@media (min-width:576px){.card-group{display:flex;flex-flow:row wrap}.card-group>.card{flex:1 0 0%;margin-bottom:0}.card-group>.card+.card{margin-left:0;border-left:0}.card-group>.card:not(:last-child){border-top-right-radius:0;border-bottom-right-radius:0}.card-group>.card:not(:last-child) .card-header,.card-group>.card:not(:last-child) .card-img-top{border-top-right-radius:0}.card-group>.card:not(:last-child) .card-footer,.card-group>.card:not(:last-child) .card-img-bottom{border-bottom-right-radius:0}.card-group>.card:not(:first-child){border-top-left-radius:0;border-bottom-left-radius:0}.card-group>.card:not(:first-child) .card-header,.card-group>.card:not(:first-child) .card-img-top{border-top-left-radius:0}.card-group>.card:not(:first-child) .card-footer,.card-group>.card:not(:first-child) .card-img-bottom{border-bottom-left-radius:0}}.accordion-button{position:relative;display:flex;align-items:center;width:100%;padding:1rem 1.25rem;font-size:1rem;color:#212529;text-align:left;background-color:#fff;border:0;border-radius:0;overflow-anchor:none;transition:color .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out,border-radius .15s ease}@media (prefers-reduced-motion:reduce){.accordion-button{transition:none}}.accordion-button:not(.collapsed){color:#0c63e4;background-color:#e7f1ff;box-shadow:inset 0 -1px 0 rgba(0,0,0,.125)}.accordion-button:not(.collapsed)::after{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='%230c63e4'%3e%3cpath fill-rule='evenodd' d='M1.646 4.646a.5.5 0 0 1 .708 0L8 10.293l5.646-5.647a.5.5 0 0 1 .708.708l-6 6a.5.5 0 0 1-.708 0l-6-6a.5.5 0 0 1 0-.708z'/%3e%3c/svg%3e");transform:rotate(-180deg)}.accordion-button::after{flex-shrink:0;width:1.25rem;height:1.25rem;margin-left:auto;content:"";background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='%23212529'%3e%3cpath fill-rule='evenodd' d='M1.646 4.646a.5.5 0 0 1 .708 0L8 10.293l5.646-5.647a.5.5 0 0 1 .708.708l-6 6a.5.5 0 0 1-.708 0l-6-6a.5.5 0 0 1 0-.708z'/%3e%3c/svg%3e");background-repeat:no-repeat;background-size:1.25rem;transition:transform .2s ease-in-out}@media (prefers-reduced-motion:reduce){.accordion-button::after{transition:none}}.accordion-button:hover{z-index:2}.accordion-button:focus{z-index:3;border-color:#86b7fe;outline:0;box-shadow:0 0 0 .25rem rgba(13,110,253,.25)}.accordion-header{margin-bottom:0}.accordion-item{background-color:#fff;border:1px solid rgba(0,0,0,.125)}.accordion-item:first-of-type{border-top-left-radius:.25rem;border-top-right-radius:.25rem}.accordion-item:first-of-type .accordion-button{border-top-left-radius:calc(.25rem - 1px);border-top-right-radius:calc(.25rem - 1px)}.accordion-item:not(:first-of-type){border-top:0}.accordion-item:last-of-type{border-bottom-right-radius:.25rem;border-bottom-left-radius:.25rem}.accordion-item:last-of-type .accordion-button.collapsed{border-bottom-right-radius:calc(.25rem - 1px);border-bottom-left-radius:calc(.25rem - 1px)}.accordion-item:last-of-type .accordion-collapse{border-bottom-right-radius:.25rem;border-bottom-left-radius:.25rem}.accordion-body{padding:1rem 1.25rem}.accordion-flush .accordion-collapse{border-width:0}.accordion-flush .accordion-item{border-right:0;border-left:0;border-radius:0}.accordion-flush .accordion-item:first-child{border-top:0}.accordion-flush .accordion-item:last-child{border-bottom:0}.accordion-flush .accordion-item .accordion-button{border-radius:0}.breadcrumb{display:flex;flex-wrap:wrap;padding:0 0;margin-bottom:1rem;list-style:none}.breadcrumb-item+.breadcrumb-item{padding-left:.5rem}.breadcrumb-item+.breadcrumb-item::before{float:left;padding-right:.5rem;color:#6c757d;content:var(--bs-breadcrumb-divider, "/")}.breadcrumb-item.active{color:#6c757d}.pagination{display:flex;padding-left:0;list-style:none}.page-link{position:relative;display:block;color:#0d6efd;text-decoration:none;background-color:#fff;border:1px solid #dee2e6;transition:color .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.page-link{transition:none}}.page-link:hover{z-index:2;color:#0a58ca;background-color:#e9ecef;border-color:#dee2e6}.page-link:focus{z-index:3;color:#0a58ca;background-color:#e9ecef;outline:0;box-shadow:0 0 0 .25rem rgba(13,110,253,.25)}.page-item:not(:first-child) .page-link{margin-left:-1px}.page-item.active .page-link{z-index:3;color:#fff;background-color:#0d6efd;border-color:#0d6efd}.page-item.disabled .page-link{color:#6c757d;pointer-events:none;background-color:#fff;border-color:#dee2e6}.page-link{padding:.375rem .75rem}.page-item:first-child .page-link{border-top-left-radius:.25rem;border-bottom-left-radius:.25rem}.page-item:last-child .page-link{border-top-right-radius:.25rem;border-bottom-right-radius:.25rem}.pagination-lg .page-link{padding:.75rem 1.5rem;font-size:1.25rem}.pagination-lg .page-item:first-child .page-link{border-top-left-radius:.3rem;border-bottom-left-radius:.3rem}.pagination-lg .page-item:last-child .page-link{border-top-right-radius:.3rem;border-bottom-right-radius:.3rem}.pagination-sm .page-link{padding:.25rem .5rem;font-size:.875rem}.pagination-sm .page-item:first-child .page-link{border-top-left-radius:.2rem;border-bottom-left-radius:.2rem}.pagination-sm .page-item:last-child .page-link{border-top-right-radius:.2rem;border-bottom-right-radius:.2rem}.badge{display:inline-block;padding:.35em .65em;font-size:.75em;font-weight:700;line-height:1;color:#fff;text-align:center;white-space:nowrap;vertical-align:baseline;border-radius:.25rem}.badge:empty{display:none}.btn .badge{position:relative;top:-1px}.alert{position:relative;padding:1rem 1rem;margin-bottom:1rem;border:1px solid transparent;border-radius:.25rem}.alert-heading{color:inherit}.alert-link{font-weight:700}.alert-dismissible{padding-right:3rem}.alert-dismissible .btn-close{position:absolute;top:0;right:0;z-index:2;padding:1.25rem 1rem}.alert-primary{color:#084298;background-color:#cfe2ff;border-color:#b6d4fe}.alert-primary .alert-link{color:#06357a}.alert-secondary{color:#41464b;background-color:#e2e3e5;border-color:#d3d6d8}.alert-secondary .alert-link{color:#34383c}.alert-success{color:#0f5132;background-color:#d1e7dd;border-color:#badbcc}.alert-success .alert-link{color:#0c4128}.alert-info{color:#055160;background-color:#cff4fc;border-color:#b6effb}.alert-info .alert-link{color:#04414d}.alert-warning{color:#664d03;background-color:#fff3cd;border-color:#ffecb5}.alert-warning .alert-link{color:#523e02}.alert-danger{color:#842029;background-color:#f8d7da;border-color:#f5c2c7}.alert-danger .alert-link{color:#6a1a21}.alert-light{color:#636464;background-color:#fefefe;border-color:#fdfdfe}.alert-light .alert-link{color:#4f5050}.alert-dark{color:#141619;background-color:#d3d3d4;border-color:#bcbebf}.alert-dark .alert-link{color:#101214}@-webkit-keyframes progress-bar-stripes{0%{background-position-x:1rem}}@keyframes progress-bar-stripes{0%{background-position-x:1rem}}.progress{display:flex;height:1rem;overflow:hidden;font-size:.75rem;background-color:#e9ecef;border-radius:.25rem}.progress-bar{display:flex;flex-direction:column;justify-content:center;overflow:hidden;color:#fff;text-align:center;white-space:nowrap;background-color:#0d6efd;transition:width .6s ease}@media (prefers-reduced-motion:reduce){.progress-bar{transition:none}}.progress-bar-striped{background-image:linear-gradient(45deg,rgba(255,255,255,.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,.15) 50%,rgba(255,255,255,.15) 75%,transparent 75%,transparent);background-size:1rem 1rem}.progress-bar-animated{-webkit-animation:1s linear infinite progress-bar-stripes;animation:1s linear infinite progress-bar-stripes}@media (prefers-reduced-motion:reduce){.progress-bar-animated{-webkit-animation:none;animation:none}}.list-group{display:flex;flex-direction:column;padding-left:0;margin-bottom:0;border-radius:.25rem}.list-group-numbered{list-style-type:none;counter-reset:section}.list-group-numbered>li::before{content:counters(section, ".") ". ";counter-increment:section}.list-group-item-action{width:100%;color:#495057;text-align:inherit}.list-group-item-action:focus,.list-group-item-action:hover{z-index:1;color:#495057;text-decoration:none;background-color:#f8f9fa}.list-group-item-action:active{color:#212529;background-color:#e9ecef}.list-group-item{position:relative;display:block;padding:.5rem 1rem;color:#212529;text-decoration:none;background-color:#fff;border:1px solid rgba(0,0,0,.125)}.list-group-item:first-child{border-top-left-radius:inherit;border-top-right-radius:inherit}.list-group-item:last-child{border-bottom-right-radius:inherit;border-bottom-left-radius:inherit}.list-group-item.disabled,.list-group-item:disabled{color:#6c757d;pointer-events:none;background-color:#fff}.list-group-item.active{z-index:2;color:#fff;background-color:#0d6efd;border-color:#0d6efd}.list-group-item+.list-group-item{border-top-width:0}.list-group-item+.list-group-item.active{margin-top:-1px;border-top-width:1px}.list-group-horizontal{flex-direction:row}.list-group-horizontal>.list-group-item:first-child{border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal>.list-group-item:last-child{border-top-right-radius:.25rem;border-bottom-left-radius:0}.list-group-horizontal>.list-group-item.active{margin-top:0}.list-group-horizontal>.list-group-item+.list-group-item{border-top-width:1px;border-left-width:0}.list-group-horizontal>.list-group-item+.list-group-item.active{margin-left:-1px;border-left-width:1px}@media (min-width:576px){.list-group-horizontal-sm{flex-direction:row}.list-group-horizontal-sm>.list-group-item:first-child{border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal-sm>.list-group-item:last-child{border-top-right-radius:.25rem;border-bottom-left-radius:0}.list-group-horizontal-sm>.list-group-item.active{margin-top:0}.list-group-horizontal-sm>.list-group-item+.list-group-item{border-top-width:1px;border-left-width:0}.list-group-horizontal-sm>.list-group-item+.list-group-item.active{margin-left:-1px;border-left-width:1px}}@media (min-width:768px){.list-group-horizontal-md{flex-direction:row}.list-group-horizontal-md>.list-group-item:first-child{border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal-md>.list-group-item:last-child{border-top-right-radius:.25rem;border-bottom-left-radius:0}.list-group-horizontal-md>.list-group-item.active{margin-top:0}.list-group-horizontal-md>.list-group-item+.list-group-item{border-top-width:1px;border-left-width:0}.list-group-horizontal-md>.list-group-item+.list-group-item.active{margin-left:-1px;border-left-width:1px}}@media (min-width:992px){.list-group-horizontal-lg{flex-direction:row}.list-group-horizontal-lg>.list-group-item:first-child{border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal-lg>.list-group-item:last-child{border-top-right-radius:.25rem;border-bottom-left-radius:0}.list-group-horizontal-lg>.list-group-item.active{margin-top:0}.list-group-horizontal-lg>.list-group-item+.list-group-item{border-top-width:1px;border-left-width:0}.list-group-horizontal-lg>.list-group-item+.list-group-item.active{margin-left:-1px;border-left-width:1px}}@media (min-width:1200px){.list-group-horizontal-xl{flex-direction:row}.list-group-horizontal-xl>.list-group-item:first-child{border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal-xl>.list-group-item:last-child{border-top-right-radius:.25rem;border-bottom-left-radius:0}.list-group-horizontal-xl>.list-group-item.active{margin-top:0}.list-group-horizontal-xl>.list-group-item+.list-group-item{border-top-width:1px;border-left-width:0}.list-group-horizontal-xl>.list-group-item+.list-group-item.active{margin-left:-1px;border-left-width:1px}}@media (min-width:1400px){.list-group-horizontal-xxl{flex-direction:row}.list-group-horizontal-xxl>.list-group-item:first-child{border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal-xxl>.list-group-item:last-child{border-top-right-radius:.25rem;border-bottom-left-radius:0}.list-group-horizontal-xxl>.list-group-item.active{margin-top:0}.list-group-horizontal-xxl>.list-group-item+.list-group-item{border-top-width:1px;border-left-width:0}.list-group-horizontal-xxl>.list-group-item+.list-group-item.active{margin-left:-1px;border-left-width:1px}}.list-group-flush{border-radius:0}.list-group-flush>.list-group-item{border-width:0 0 1px}.list-group-flush>.list-group-item:last-child{border-bottom-width:0}.list-group-item-primary{color:#084298;background-color:#cfe2ff}.list-group-item-primary.list-group-item-action:focus,.list-group-item-primary.list-group-item-action:hover{color:#084298;background-color:#bacbe6}.list-group-item-primary.list-group-item-action.active{color:#fff;background-color:#084298;border-color:#084298}.list-group-item-secondary{color:#41464b;background-color:#e2e3e5}.list-group-item-secondary.list-group-item-action:focus,.list-group-item-secondary.list-group-item-action:hover{color:#41464b;background-color:#cbccce}.list-group-item-secondary.list-group-item-action.active{color:#fff;background-color:#41464b;border-color:#41464b}.list-group-item-success{color:#0f5132;background-color:#d1e7dd}.list-group-item-success.list-group-item-action:focus,.list-group-item-success.list-group-item-action:hover{color:#0f5132;background-color:#bcd0c7}.list-group-item-success.list-group-item-action.active{color:#fff;background-color:#0f5132;border-color:#0f5132}.list-group-item-info{color:#055160;background-color:#cff4fc}.list-group-item-info.list-group-item-action:focus,.list-group-item-info.list-group-item-action:hover{color:#055160;background-color:#badce3}.list-group-item-info.list-group-item-action.active{color:#fff;background-color:#055160;border-color:#055160}.list-group-item-warning{color:#664d03;background-color:#fff3cd}.list-group-item-warning.list-group-item-action:focus,.list-group-item-warning.list-group-item-action:hover{color:#664d03;background-color:#e6dbb9}.list-group-item-warning.list-group-item-action.active{color:#fff;background-color:#664d03;border-color:#664d03}.list-group-item-danger{color:#842029;background-color:#f8d7da}.list-group-item-danger.list-group-item-action:focus,.list-group-item-danger.list-group-item-action:hover{color:#842029;background-color:#dfc2c4}.list-group-item-danger.list-group-item-action.active{color:#fff;background-color:#842029;border-color:#842029}.list-group-item-light{color:#636464;background-color:#fefefe}.list-group-item-light.list-group-item-action:focus,.list-group-item-light.list-group-item-action:hover{color:#636464;background-color:#e5e5e5}.list-group-item-light.list-group-item-action.active{color:#fff;background-color:#636464;border-color:#636464}.list-group-item-dark{color:#141619;background-color:#d3d3d4}.list-group-item-dark.list-group-item-action:focus,.list-group-item-dark.list-group-item-action:hover{color:#141619;background-color:#bebebf}.list-group-item-dark.list-group-item-action.active{color:#fff;background-color:#141619;border-color:#141619}.btn-close{box-sizing:content-box;width:1em;height:1em;padding:.25em .25em;color:#000;background:transparent url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='%23000'%3e%3cpath d='M.293.293a1 1 0 011.414 0L8 6.586 14.293.293a1 1 0 111.414 1.414L9.414 8l6.293 6.293a1 1 0 01-1.414 1.414L8 9.414l-6.293 6.293a1 1 0 01-1.414-1.414L6.586 8 .293 1.707a1 1 0 010-1.414z'/%3e%3c/svg%3e") center/1em auto no-repeat;border:0;border-radius:.25rem;opacity:.5}.btn-close:hover{color:#000;text-decoration:none;opacity:.75}.btn-close:focus{outline:0;box-shadow:0 0 0 .25rem rgba(13,110,253,.25);opacity:1}.btn-close.disabled,.btn-close:disabled{pointer-events:none;-webkit-user-select:none;-moz-user-select:none;user-select:none;opacity:.25}.btn-close-white{filter:invert(1) grayscale(100%) brightness(200%)}.toast{width:350px;max-width:100%;font-size:.875rem;pointer-events:auto;background-color:rgba(255,255,255,.85);background-clip:padding-box;border:1px solid rgba(0,0,0,.1);box-shadow:0 .5rem 1rem rgba(0,0,0,.15);border-radius:.25rem}.toast.showing{opacity:0}.toast:not(.show){display:none}.toast-container{width:-webkit-max-content;width:-moz-max-content;width:max-content;max-width:100%;pointer-events:none}.toast-container>:not(:last-child){margin-bottom:.75rem}.toast-header{display:flex;align-items:center;padding:.5rem .75rem;color:#6c757d;background-color:rgba(255,255,255,.85);background-clip:padding-box;border-bottom:1px solid rgba(0,0,0,.05);border-top-left-radius:calc(.25rem - 1px);border-top-right-radius:calc(.25rem - 1px)}.toast-header .btn-close{margin-right:-.375rem;margin-left:.75rem}.toast-body{padding:.75rem;word-wrap:break-word}.modal{position:fixed;top:0;left:0;z-index:1055;display:none;width:100%;height:100%;overflow-x:hidden;overflow-y:auto;outline:0}.modal-dialog{position:relative;width:auto;margin:.5rem;pointer-events:none}.modal.fade .modal-dialog{transition:transform .3s ease-out;transform:translate(0,-50px)}@media (prefers-reduced-motion:reduce){.modal.fade .modal-dialog{transition:none}}.modal.show .modal-dialog{transform:none}.modal.modal-static .modal-dialog{transform:scale(1.02)}.modal-dialog-scrollable{height:calc(100% - 1rem)}.modal-dialog-scrollable .modal-content{max-height:100%;overflow:hidden}.modal-dialog-scrollable .modal-body{overflow-y:auto}.modal-dialog-centered{display:flex;align-items:center;min-height:calc(100% - 1rem)}.modal-content{position:relative;display:flex;flex-direction:column;width:100%;pointer-events:auto;background-color:#fff;background-clip:padding-box;border:1px solid rgba(0,0,0,.2);border-radius:.3rem;outline:0}.modal-backdrop{position:fixed;top:0;left:0;z-index:1050;width:100vw;height:100vh;background-color:#000}.modal-backdrop.fade{opacity:0}.modal-backdrop.show{opacity:.5}.modal-header{display:flex;flex-shrink:0;align-items:center;justify-content:space-between;padding:1rem 1rem;border-bottom:1px solid #dee2e6;border-top-left-radius:calc(.3rem - 1px);border-top-right-radius:calc(.3rem - 1px)}.modal-header .btn-close{padding:.5rem .5rem;margin:-.5rem -.5rem -.5rem auto}.modal-title{margin-bottom:0;line-height:1.5}.modal-body{position:relative;flex:1 1 auto;padding:1rem}.modal-footer{display:flex;flex-wrap:wrap;flex-shrink:0;align-items:center;justify-content:flex-end;padding:.75rem;border-top:1px solid #dee2e6;border-bottom-right-radius:calc(.3rem - 1px);border-bottom-left-radius:calc(.3rem - 1px)}.modal-footer>*{margin:.25rem}@media (min-width:576px){.modal-dialog{max-width:500px;margin:1.75rem auto}.modal-dialog-scrollable{height:calc(100% - 3.5rem)}.modal-dialog-centered{min-height:calc(100% - 3.5rem)}.modal-sm{max-width:300px}}@media (min-width:992px){.modal-lg,.modal-xl{max-width:800px}}@media (min-width:1200px){.modal-xl{max-width:1140px}}.modal-fullscreen{width:100vw;max-width:none;height:100%;margin:0}.modal-fullscreen .modal-content{height:100%;border:0;border-radius:0}.modal-fullscreen .modal-header{border-radius:0}.modal-fullscreen .modal-body{overflow-y:auto}.modal-fullscreen .modal-footer{border-radius:0}@media (max-width:575.98px){.modal-fullscreen-sm-down{width:100vw;max-width:none;height:100%;margin:0}.modal-fullscreen-sm-down .modal-content{height:100%;border:0;border-radius:0}.modal-fullscreen-sm-down .modal-header{border-radius:0}.modal-fullscreen-sm-down .modal-body{overflow-y:auto}.modal-fullscreen-sm-down .modal-footer{border-radius:0}}@media (max-width:767.98px){.modal-fullscreen-md-down{width:100vw;max-width:none;height:100%;margin:0}.modal-fullscreen-md-down .modal-content{height:100%;border:0;border-radius:0}.modal-fullscreen-md-down .modal-header{border-radius:0}.modal-fullscreen-md-down .modal-body{overflow-y:auto}.modal-fullscreen-md-down .modal-footer{border-radius:0}}@media (max-width:991.98px){.modal-fullscreen-lg-down{width:100vw;max-width:none;height:100%;margin:0}.modal-fullscreen-lg-down .modal-content{height:100%;border:0;border-radius:0}.modal-fullscreen-lg-down .modal-header{border-radius:0}.modal-fullscreen-lg-down .modal-body{overflow-y:auto}.modal-fullscreen-lg-down .modal-footer{border-radius:0}}@media (max-width:1199.98px){.modal-fullscreen-xl-down{width:100vw;max-width:none;height:100%;margin:0}.modal-fullscreen-xl-down .modal-content{height:100%;border:0;border-radius:0}.modal-fullscreen-xl-down .modal-header{border-radius:0}.modal-fullscreen-xl-down .modal-body{overflow-y:auto}.modal-fullscreen-xl-down .modal-footer{border-radius:0}}@media (max-width:1399.98px){.modal-fullscreen-xxl-down{width:100vw;max-width:none;height:100%;margin:0}.modal-fullscreen-xxl-down .modal-content{height:100%;border:0;border-radius:0}.modal-fullscreen-xxl-down .modal-header{border-radius:0}.modal-fullscreen-xxl-down .modal-body{overflow-y:auto}.modal-fullscreen-xxl-down .modal-footer{border-radius:0}}.tooltip{position:absolute;z-index:1080;display:block;margin:0;font-family:var(--bs-font-sans-serif);font-style:normal;font-weight:400;line-height:1.5;text-align:left;text-align:start;text-decoration:none;text-shadow:none;text-transform:none;letter-spacing:normal;word-break:normal;word-spacing:normal;white-space:normal;line-break:auto;font-size:.875rem;word-wrap:break-word;opacity:0}.tooltip.show{opacity:.9}.tooltip .tooltip-arrow{position:absolute;display:block;width:.8rem;height:.4rem}.tooltip .tooltip-arrow::before{position:absolute;content:"";border-color:transparent;border-style:solid}.bs-tooltip-auto[data-popper-placement^=top],.bs-tooltip-top{padding:.4rem 0}.bs-tooltip-auto[data-popper-placement^=top] .tooltip-arrow,.bs-tooltip-top .tooltip-arrow{bottom:0}.bs-tooltip-auto[data-popper-placement^=top] .tooltip-arrow::before,.bs-tooltip-top .tooltip-arrow::before{top:-1px;border-width:.4rem .4rem 0;border-top-color:#000}.bs-tooltip-auto[data-popper-placement^=right],.bs-tooltip-end{padding:0 .4rem}.bs-tooltip-auto[data-popper-placement^=right] .tooltip-arrow,.bs-tooltip-end .tooltip-arrow{left:0;width:.4rem;height:.8rem}.bs-tooltip-auto[data-popper-placement^=right] .tooltip-arrow::before,.bs-tooltip-end .tooltip-arrow::before{right:-1px;border-width:.4rem .4rem .4rem 0;border-right-color:#000}.bs-tooltip-auto[data-popper-placement^=bottom],.bs-tooltip-bottom{padding:.4rem 0}.bs-tooltip-auto[data-popper-placement^=bottom] .tooltip-arrow,.bs-tooltip-bottom .tooltip-arrow{top:0}.bs-tooltip-auto[data-popper-placement^=bottom] .tooltip-arrow::before,.bs-tooltip-bottom .tooltip-arrow::before{bottom:-1px;border-width:0 .4rem .4rem;border-bottom-color:#000}.bs-tooltip-auto[data-popper-placement^=left],.bs-tooltip-start{padding:0 .4rem}.bs-tooltip-auto[data-popper-placement^=left] .tooltip-arrow,.bs-tooltip-start .tooltip-arrow{right:0;width:.4rem;height:.8rem}.bs-tooltip-auto[data-popper-placement^=left] .tooltip-arrow::before,.bs-tooltip-start .tooltip-arrow::before{left:-1px;border-width:.4rem 0 .4rem .4rem;border-left-color:#000}.tooltip-inner{max-width:200px;padding:.25rem .5rem;color:#fff;text-align:center;background-color:#000;border-radius:.25rem}.popover{position:absolute;top:0;left:0;z-index:1070;display:block;max-width:276px;font-family:var(--bs-font-sans-serif);font-style:normal;font-weight:400;line-height:1.5;text-align:left;text-align:start;text-decoration:none;text-shadow:none;text-transform:none;letter-spacing:normal;word-break:normal;word-spacing:normal;white-space:normal;line-break:auto;font-size:.875rem;word-wrap:break-word;background-color:#fff;background-clip:padding-box;border:1px solid rgba(0,0,0,.2);border-radius:.3rem}.popover .popover-arrow{position:absolute;display:block;width:1rem;height:.5rem}.popover .popover-arrow::after,.popover .popover-arrow::before{position:absolute;display:block;content:"";border-color:transparent;border-style:solid}.bs-popover-auto[data-popper-placement^=top]>.popover-arrow,.bs-popover-top>.popover-arrow{bottom:calc(-.5rem - 1px)}.bs-popover-auto[data-popper-placement^=top]>.popover-arrow::before,.bs-popover-top>.popover-arrow::before{bottom:0;border-width:.5rem .5rem 0;border-top-color:rgba(0,0,0,.25)}.bs-popover-auto[data-popper-placement^=top]>.popover-arrow::after,.bs-popover-top>.popover-arrow::after{bottom:1px;border-width:.5rem .5rem 0;border-top-color:#fff}.bs-popover-auto[data-popper-placement^=right]>.popover-arrow,.bs-popover-end>.popover-arrow{left:calc(-.5rem - 1px);width:.5rem;height:1rem}.bs-popover-auto[data-popper-placement^=right]>.popover-arrow::before,.bs-popover-end>.popover-arrow::before{left:0;border-width:.5rem .5rem .5rem 0;border-right-color:rgba(0,0,0,.25)}.bs-popover-auto[data-popper-placement^=right]>.popover-arrow::after,.bs-popover-end>.popover-arrow::after{left:1px;border-width:.5rem .5rem .5rem 0;border-right-color:#fff}.bs-popover-auto[data-popper-placement^=bottom]>.popover-arrow,.bs-popover-bottom>.popover-arrow{top:calc(-.5rem - 1px)}.bs-popover-auto[data-popper-placement^=bottom]>.popover-arrow::before,.bs-popover-bottom>.popover-arrow::before{top:0;border-width:0 .5rem .5rem .5rem;border-bottom-color:rgba(0,0,0,.25)}.bs-popover-auto[data-popper-placement^=bottom]>.popover-arrow::after,.bs-popover-bottom>.popover-arrow::after{top:1px;border-width:0 .5rem .5rem .5rem;border-bottom-color:#fff}.bs-popover-auto[data-popper-placement^=bottom] .popover-header::before,.bs-popover-bottom .popover-header::before{position:absolute;top:0;left:50%;display:block;width:1rem;margin-left:-.5rem;content:"";border-bottom:1px solid #f0f0f0}.bs-popover-auto[data-popper-placement^=left]>.popover-arrow,.bs-popover-start>.popover-arrow{right:calc(-.5rem - 1px);width:.5rem;height:1rem}.bs-popover-auto[data-popper-placement^=left]>.popover-arrow::before,.bs-popover-start>.popover-arrow::before{right:0;border-width:.5rem 0 .5rem .5rem;border-left-color:rgba(0,0,0,.25)}.bs-popover-auto[data-popper-placement^=left]>.popover-arrow::after,.bs-popover-start>.popover-arrow::after{right:1px;border-width:.5rem 0 .5rem .5rem;border-left-color:#fff}.popover-header{padding:.5rem 1rem;margin-bottom:0;font-size:1rem;background-color:#f0f0f0;border-bottom:1px solid rgba(0,0,0,.2);border-top-left-radius:calc(.3rem - 1px);border-top-right-radius:calc(.3rem - 1px)}.popover-header:empty{display:none}.popover-body{padding:1rem 1rem;color:#212529}.carousel{position:relative}.carousel.pointer-event{touch-action:pan-y}.carousel-inner{position:relative;width:100%;overflow:hidden}.carousel-inner::after{display:block;clear:both;content:""}.carousel-item{position:relative;display:none;float:left;width:100%;margin-right:-100%;-webkit-backface-visibility:hidden;backface-visibility:hidden;transition:transform .6s ease-in-out}@media (prefers-reduced-motion:reduce){.carousel-item{transition:none}}.carousel-item-next,.carousel-item-prev,.carousel-item.active{display:block}.active.carousel-item-end,.carousel-item-next:not(.carousel-item-start){transform:translateX(100%)}.active.carousel-item-start,.carousel-item-prev:not(.carousel-item-end){transform:translateX(-100%)}.carousel-fade .carousel-item{opacity:0;transition-property:opacity;transform:none}.carousel-fade .carousel-item-next.carousel-item-start,.carousel-fade .carousel-item-prev.carousel-item-end,.carousel-fade .carousel-item.active{z-index:1;opacity:1}.carousel-fade .active.carousel-item-end,.carousel-fade .active.carousel-item-start{z-index:0;opacity:0;transition:opacity 0s .6s}@media (prefers-reduced-motion:reduce){.carousel-fade .active.carousel-item-end,.carousel-fade .active.carousel-item-start{transition:none}}.carousel-control-next,.carousel-control-prev{position:absolute;top:0;bottom:0;z-index:1;display:flex;align-items:center;justify-content:center;width:15%;padding:0;color:#fff;text-align:center;background:0 0;border:0;opacity:.5;transition:opacity .15s ease}@media (prefers-reduced-motion:reduce){.carousel-control-next,.carousel-control-prev{transition:none}}.carousel-control-next:focus,.carousel-control-next:hover,.carousel-control-prev:focus,.carousel-control-prev:hover{color:#fff;text-decoration:none;outline:0;opacity:.9}.carousel-control-prev{left:0}.carousel-control-next{right:0}.carousel-control-next-icon,.carousel-control-prev-icon{display:inline-block;width:2rem;height:2rem;background-repeat:no-repeat;background-position:50%;background-size:100% 100%}.carousel-control-prev-icon{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='%23fff'%3e%3cpath d='M11.354 1.646a.5.5 0 0 1 0 .708L5.707 8l5.647 5.646a.5.5 0 0 1-.708.708l-6-6a.5.5 0 0 1 0-.708l6-6a.5.5 0 0 1 .708 0z'/%3e%3c/svg%3e")}.carousel-control-next-icon{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='%23fff'%3e%3cpath d='M4.646 1.646a.5.5 0 0 1 .708 0l6 6a.5.5 0 0 1 0 .708l-6 6a.5.5 0 0 1-.708-.708L10.293 8 4.646 2.354a.5.5 0 0 1 0-.708z'/%3e%3c/svg%3e")}.carousel-indicators{position:absolute;right:0;bottom:0;left:0;z-index:2;display:flex;justify-content:center;padding:0;margin-right:15%;margin-bottom:1rem;margin-left:15%;list-style:none}.carousel-indicators [data-bs-target]{box-sizing:content-box;flex:0 1 auto;width:30px;height:3px;padding:0;margin-right:3px;margin-left:3px;text-indent:-999px;cursor:pointer;background-color:#fff;background-clip:padding-box;border:0;border-top:10px solid transparent;border-bottom:10px solid transparent;opacity:.5;transition:opacity .6s ease}@media (prefers-reduced-motion:reduce){.carousel-indicators [data-bs-target]{transition:none}}.carousel-indicators .active{opacity:1}.carousel-caption{position:absolute;right:15%;bottom:1.25rem;left:15%;padding-top:1.25rem;padding-bottom:1.25rem;color:#fff;text-align:center}.carousel-dark .carousel-control-next-icon,.carousel-dark .carousel-control-prev-icon{filter:invert(1) grayscale(100)}.carousel-dark .carousel-indicators [data-bs-target]{background-color:#000}.carousel-dark .carousel-caption{color:#000}@-webkit-keyframes spinner-border{to{transform:rotate(360deg)}}@keyframes spinner-border{to{transform:rotate(360deg)}}.spinner-border{display:inline-block;width:2rem;height:2rem;vertical-align:-.125em;border:.25em solid currentColor;border-right-color:transparent;border-radius:50%;-webkit-animation:.75s linear infinite spinner-border;animation:.75s linear infinite spinner-border}.spinner-border-sm{width:1rem;height:1rem;border-width:.2em}@-webkit-keyframes spinner-grow{0%{transform:scale(0)}50%{opacity:1;transform:none}}@keyframes spinner-grow{0%{transform:scale(0)}50%{opacity:1;transform:none}}.spinner-grow{display:inline-block;width:2rem;height:2rem;vertical-align:-.125em;background-color:currentColor;border-radius:50%;opacity:0;-webkit-animation:.75s linear infinite spinner-grow;animation:.75s linear infinite spinner-grow}.spinner-grow-sm{width:1rem;height:1rem}@media (prefers-reduced-motion:reduce){.spinner-border,.spinner-grow{-webkit-animation-duration:1.5s;animation-duration:1.5s}}.offcanvas{position:fixed;bottom:0;z-index:1045;display:flex;flex-direction:column;max-width:100%;visibility:hidden;background-color:#fff;background-clip:padding-box;outline:0;transition:transform .3s ease-in-out}@media (prefers-reduced-motion:reduce){.offcanvas{transition:none}}.offcanvas-backdrop{position:fixed;top:0;left:0;z-index:1040;width:100vw;height:100vh;background-color:#000}.offcanvas-backdrop.fade{opacity:0}.offcanvas-backdrop.show{opacity:.5}.offcanvas-header{display:flex;align-items:center;justify-content:space-between;padding:1rem 1rem}.offcanvas-header .btn-close{padding:.5rem .5rem;margin-top:-.5rem;margin-right:-.5rem;margin-bottom:-.5rem}.offcanvas-title{margin-bottom:0;line-height:1.5}.offcanvas-body{flex-grow:1;padding:1rem 1rem;overflow-y:auto}.offcanvas-start{top:0;left:0;width:400px;border-right:1px solid rgba(0,0,0,.2);transform:translateX(-100%)}.offcanvas-end{top:0;right:0;width:400px;border-left:1px solid rgba(0,0,0,.2);transform:translateX(100%)}.offcanvas-top{top:0;right:0;left:0;height:30vh;max-height:100%;border-bottom:1px solid rgba(0,0,0,.2);transform:translateY(-100%)}.offcanvas-bottom{right:0;left:0;height:30vh;max-height:100%;border-top:1px solid rgba(0,0,0,.2);transform:translateY(100%)}.offcanvas.show{transform:none}.placeholder{display:inline-block;min-height:1em;vertical-align:middle;cursor:wait;background-color:currentColor;opacity:.5}.placeholder.btn::before{display:inline-block;content:""}.placeholder-xs{min-height:.6em}.placeholder-sm{min-height:.8em}.placeholder-lg{min-height:1.2em}.placeholder-glow .placeholder{-webkit-animation:placeholder-glow 2s ease-in-out infinite;animation:placeholder-glow 2s ease-in-out infinite}@-webkit-keyframes placeholder-glow{50%{opacity:.2}}@keyframes placeholder-glow{50%{opacity:.2}}.placeholder-wave{-webkit-mask-image:linear-gradient(130deg,#000 55%,rgba(0,0,0,0.8) 75%,#000 95%);mask-image:linear-gradient(130deg,#000 55%,rgba(0,0,0,0.8) 75%,#000 95%);-webkit-mask-size:200% 100%;mask-size:200% 100%;-webkit-animation:placeholder-wave 2s linear infinite;animation:placeholder-wave 2s linear infinite}@-webkit-keyframes placeholder-wave{100%{-webkit-mask-position:-200% 0%;mask-position:-200% 0%}}@keyframes placeholder-wave{100%{-webkit-mask-position:-200% 0%;mask-position:-200% 0%}}.clearfix::after{display:block;clear:both;content:""}.link-primary{color:#0d6efd}.link-primary:focus,.link-primary:hover{color:#0a58ca}.link-secondary{color:#6c757d}.link-secondary:focus,.link-secondary:hover{color:#565e64}.link-success{color:#198754}.link-success:focus,.link-success:hover{color:#146c43}.link-info{color:#0dcaf0}.link-info:focus,.link-info:hover{color:#3dd5f3}.link-warning{color:#ffc107}.link-warning:focus,.link-warning:hover{color:#ffcd39}.link-danger{color:#dc3545}.link-danger:focus,.link-danger:hover{color:#b02a37}.link-light{color:#f8f9fa}.link-light:focus,.link-light:hover{color:#f9fafb}.link-dark{color:#212529}.link-dark:focus,.link-dark:hover{color:#1a1e21}.ratio{position:relative;width:100%}.ratio::before{display:block;padding-top:var(--bs-aspect-ratio);content:""}.ratio>*{position:absolute;top:0;left:0;width:100%;height:100%}.ratio-1x1{--bs-aspect-ratio:100%}.ratio-4x3{--bs-aspect-ratio:calc(3 / 4 * 100%)}.ratio-16x9{--bs-aspect-ratio:calc(9 / 16 * 100%)}.ratio-21x9{--bs-aspect-ratio:calc(9 / 21 * 100%)}.fixed-top{position:fixed;top:0;right:0;left:0;z-index:1030}.fixed-bottom{position:fixed;right:0;bottom:0;left:0;z-index:1030}.sticky-top{position:-webkit-sticky;position:sticky;top:0;z-index:1020}@media (min-width:576px){.sticky-sm-top{position:-webkit-sticky;position:sticky;top:0;z-index:1020}}@media (min-width:768px){.sticky-md-top{position:-webkit-sticky;position:sticky;top:0;z-index:1020}}@media (min-width:992px){.sticky-lg-top{position:-webkit-sticky;position:sticky;top:0;z-index:1020}}@media (min-width:1200px){.sticky-xl-top{position:-webkit-sticky;position:sticky;top:0;z-index:1020}}@media (min-width:1400px){.sticky-xxl-top{position:-webkit-sticky;position:sticky;top:0;z-index:1020}}.hstack{display:flex;flex-direction:row;align-items:center;align-self:stretch}.vstack{display:flex;flex:1 1 auto;flex-direction:column;align-self:stretch}.visually-hidden,.visually-hidden-focusable:not(:focus):not(:focus-within){position:absolute!important;width:1px!important;height:1px!important;padding:0!important;margin:-1px!important;overflow:hidden!important;clip:rect(0,0,0,0)!important;white-space:nowrap!important;border:0!important}.stretched-link::after{position:absolute;top:0;right:0;bottom:0;left:0;z-index:1;content:""}.text-truncate{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.vr{display:inline-block;align-self:stretch;width:1px;min-height:1em;background-color:currentColor;opacity:.25}.align-baseline{vertical-align:baseline!important}.align-top{vertical-align:top!important}.align-middle{vertical-align:middle!important}.align-bottom{vertical-align:bottom!important}.align-text-bottom{vertical-align:text-bottom!important}.align-text-top{vertical-align:text-top!important}.float-start{float:left!important}.float-end{float:right!important}.float-none{float:none!important}.opacity-0{opacity:0!important}.opacity-25{opacity:.25!important}.opacity-50{opacity:.5!important}.opacity-75{opacity:.75!important}.opacity-100{opacity:1!important}.overflow-auto{overflow:auto!important}.overflow-hidden{overflow:hidden!important}.overflow-visible{overflow:visible!important}.overflow-scroll{overflow:scroll!important}.d-inline{display:inline!important}.d-inline-block{display:inline-block!important}.d-block{display:block!important}.d-grid{display:grid!important}.d-table{display:table!important}.d-table-row{display:table-row!important}.d-table-cell{display:table-cell!important}.d-flex{display:flex!important}.d-inline-flex{display:inline-flex!important}.d-none{display:none!important}.shadow{box-shadow:0 .5rem 1rem rgba(0,0,0,.15)!important}.shadow-sm{box-shadow:0 .125rem .25rem rgba(0,0,0,.075)!important}.shadow-lg{box-shadow:0 1rem 3rem rgba(0,0,0,.175)!important}.shadow-none{box-shadow:none!important}.position-static{position:static!important}.position-relative{position:relative!important}.position-absolute{position:absolute!important}.position-fixed{position:fixed!important}.position-sticky{position:-webkit-sticky!important;position:sticky!important}.top-0{top:0!important}.top-50{top:50%!important}.top-100{top:100%!important}.bottom-0{bottom:0!important}.bottom-50{bottom:50%!important}.bottom-100{bottom:100%!important}.start-0{left:0!important}.start-50{left:50%!important}.start-100{left:100%!important}.end-0{right:0!important}.end-50{right:50%!important}.end-100{right:100%!important}.translate-middle{transform:translate(-50%,-50%)!important}.translate-middle-x{transform:translateX(-50%)!important}.translate-middle-y{transform:translateY(-50%)!important}.border{border:1px solid #dee2e6!important}.border-0{border:0!important}.border-top{border-top:1px solid #dee2e6!important}.border-top-0{border-top:0!important}.border-end{border-right:1px solid #dee2e6!important}.border-end-0{border-right:0!important}.border-bottom{border-bottom:1px solid #dee2e6!important}.border-bottom-0{border-bottom:0!important}.border-start{border-left:1px solid #dee2e6!important}.border-start-0{border-left:0!important}.border-primary{border-color:#0d6efd!important}.border-secondary{border-color:#6c757d!important}.border-success{border-color:#198754!important}.border-info{border-color:#0dcaf0!important}.border-warning{border-color:#ffc107!important}.border-danger{border-color:#dc3545!important}.border-light{border-color:#f8f9fa!important}.border-dark{border-color:#212529!important}.border-white{border-color:#fff!important}.border-1{border-width:1px!important}.border-2{border-width:2px!important}.border-3{border-width:3px!important}.border-4{border-width:4px!important}.border-5{border-width:5px!important}.w-25{width:25%!important}.w-50{width:50%!important}.w-75{width:75%!important}.w-100{width:100%!important}.w-auto{width:auto!important}.mw-100{max-width:100%!important}.vw-100{width:100vw!important}.min-vw-100{min-width:100vw!important}.h-25{height:25%!important}.h-50{height:50%!important}.h-75{height:75%!important}.h-100{height:100%!important}.h-auto{height:auto!important}.mh-100{max-height:100%!important}.vh-100{height:100vh!important}.min-vh-100{min-height:100vh!important}.flex-fill{flex:1 1 auto!important}.flex-row{flex-direction:row!important}.flex-column{flex-direction:column!important}.flex-row-reverse{flex-direction:row-reverse!important}.flex-column-reverse{flex-direction:column-reverse!important}.flex-grow-0{flex-grow:0!important}.flex-grow-1{flex-grow:1!important}.flex-shrink-0{flex-shrink:0!important}.flex-shrink-1{flex-shrink:1!important}.flex-wrap{flex-wrap:wrap!important}.flex-nowrap{flex-wrap:nowrap!important}.flex-wrap-reverse{flex-wrap:wrap-reverse!important}.gap-0{gap:0!important}.gap-1{gap:.25rem!important}.gap-2{gap:.5rem!important}.gap-3{gap:1rem!important}.gap-4{gap:1.5rem!important}.gap-5{gap:3rem!important}.justify-content-start{justify-content:flex-start!important}.justify-content-end{justify-content:flex-end!important}.justify-content-center{justify-content:center!important}.justify-content-between{justify-content:space-between!important}.justify-content-around{justify-content:space-around!important}.justify-content-evenly{justify-content:space-evenly!important}.align-items-start{align-items:flex-start!important}.align-items-end{align-items:flex-end!important}.align-items-center{align-items:center!important}.align-items-baseline{align-items:baseline!important}.align-items-stretch{align-items:stretch!important}.align-content-start{align-content:flex-start!important}.align-content-end{align-content:flex-end!important}.align-content-center{align-content:center!important}.align-content-between{align-content:space-between!important}.align-content-around{align-content:space-around!important}.align-content-stretch{align-content:stretch!important}.align-self-auto{align-self:auto!important}.align-self-start{align-self:flex-start!important}.align-self-end{align-self:flex-end!important}.align-self-center{align-self:center!important}.align-self-baseline{align-self:baseline!important}.align-self-stretch{align-self:stretch!important}.order-first{order:-1!important}.order-0{order:0!important}.order-1{order:1!important}.order-2{order:2!important}.order-3{order:3!important}.order-4{order:4!important}.order-5{order:5!important}.order-last{order:6!important}.m-0{margin:0!important}.m-1{margin:.25rem!important}.m-2{margin:.5rem!important}.m-3{margin:1rem!important}.m-4{margin:1.5rem!important}.m-5{margin:3rem!important}.m-auto{margin:auto!important}.mx-0{margin-right:0!important;margin-left:0!important}.mx-1{margin-right:.25rem!important;margin-left:.25rem!important}.mx-2{margin-right:.5rem!important;margin-left:.5rem!important}.mx-3{margin-right:1rem!important;margin-left:1rem!important}.mx-4{margin-right:1.5rem!important;margin-left:1.5rem!important}.mx-5{margin-right:3rem!important;margin-left:3rem!important}.mx-auto{margin-right:auto!important;margin-left:auto!important}.my-0{margin-top:0!important;margin-bottom:0!important}.my-1{margin-top:.25rem!important;margin-bottom:.25rem!important}.my-2{margin-top:.5rem!important;margin-bottom:.5rem!important}.my-3{margin-top:1rem!important;margin-bottom:1rem!important}.my-4{margin-top:1.5rem!important;margin-bottom:1.5rem!important}.my-5{margin-top:3rem!important;margin-bottom:3rem!important}.my-auto{margin-top:auto!important;margin-bottom:auto!important}.mt-0{margin-top:0!important}.mt-1{margin-top:.25rem!important}.mt-2{margin-top:.5rem!important}.mt-3{margin-top:1rem!important}.mt-4{margin-top:1.5rem!important}.mt-5{margin-top:3rem!important}.mt-auto{margin-top:auto!important}.me-0{margin-right:0!important}.me-1{margin-right:.25rem!important}.me-2{margin-right:.5rem!important}.me-3{margin-right:1rem!important}.me-4{margin-right:1.5rem!important}.me-5{margin-right:3rem!important}.me-auto{margin-right:auto!important}.mb-0{margin-bottom:0!important}.mb-1{margin-bottom:.25rem!important}.mb-2{margin-bottom:.5rem!important}.mb-3{margin-bottom:1rem!important}.mb-4{margin-bottom:1.5rem!important}.mb-5{margin-bottom:3rem!important}.mb-auto{margin-bottom:auto!important}.ms-0{margin-left:0!important}.ms-1{margin-left:.25rem!important}.ms-2{margin-left:.5rem!important}.ms-3{margin-left:1rem!important}.ms-4{margin-left:1.5rem!important}.ms-5{margin-left:3rem!important}.ms-auto{margin-left:auto!important}.p-0{padding:0!important}.p-1{padding:.25rem!important}.p-2{padding:.5rem!important}.p-3{padding:1rem!important}.p-4{padding:1.5rem!important}.p-5{padding:3rem!important}.px-0{padding-right:0!important;padding-left:0!important}.px-1{padding-right:.25rem!important;padding-left:.25rem!important}.px-2{padding-right:.5rem!important;padding-left:.5rem!important}.px-3{padding-right:1rem!important;padding-left:1rem!important}.px-4{padding-right:1.5rem!important;padding-left:1.5rem!important}.px-5{padding-right:3rem!important;padding-left:3rem!important}.py-0{padding-top:0!important;padding-bottom:0!important}.py-1{padding-top:.25rem!important;padding-bottom:.25rem!important}.py-2{padding-top:.5rem!important;padding-bottom:.5rem!important}.py-3{padding-top:1rem!important;padding-bottom:1rem!important}.py-4{padding-top:1.5rem!important;padding-bottom:1.5rem!important}.py-5{padding-top:3rem!important;padding-bottom:3rem!important}.pt-0{padding-top:0!important}.pt-1{padding-top:.25rem!important}.pt-2{padding-top:.5rem!important}.pt-3{padding-top:1rem!important}.pt-4{padding-top:1.5rem!important}.pt-5{padding-top:3rem!important}.pe-0{padding-right:0!important}.pe-1{padding-right:.25rem!important}.pe-2{padding-right:.5rem!important}.pe-3{padding-right:1rem!important}.pe-4{padding-right:1.5rem!important}.pe-5{padding-right:3rem!important}.pb-0{padding-bottom:0!important}.pb-1{padding-bottom:.25rem!important}.pb-2{padding-bottom:.5rem!important}.pb-3{padding-bottom:1rem!important}.pb-4{padding-bottom:1.5rem!important}.pb-5{padding-bottom:3rem!important}.ps-0{padding-left:0!important}.ps-1{padding-left:.25rem!important}.ps-2{padding-left:.5rem!important}.ps-3{padding-left:1rem!important}.ps-4{padding-left:1.5rem!important}.ps-5{padding-left:3rem!important}.font-monospace{font-family:var(--bs-font-monospace)!important}.fs-1{font-size:calc(1.375rem + 1.5vw)!important}.fs-2{font-size:calc(1.325rem + .9vw)!important}.fs-3{font-size:calc(1.3rem + .6vw)!important}.fs-4{font-size:calc(1.275rem + .3vw)!important}.fs-5{font-size:1.25rem!important}.fs-6{font-size:1rem!important}.fst-italic{font-style:italic!important}.fst-normal{font-style:normal!important}.fw-light{font-weight:300!important}.fw-lighter{font-weight:lighter!important}.fw-normal{font-weight:400!important}.fw-bold{font-weight:700!important}.fw-bolder{font-weight:bolder!important}.lh-1{line-height:1!important}.lh-sm{line-height:1.25!important}.lh-base{line-height:1.5!important}.lh-lg{line-height:2!important}.text-start{text-align:left!important}.text-end{text-align:right!important}.text-center{text-align:center!important}.text-decoration-none{text-decoration:none!important}.text-decoration-underline{text-decoration:underline!important}.text-decoration-line-through{text-decoration:line-through!important}.text-lowercase{text-transform:lowercase!important}.text-uppercase{text-transform:uppercase!important}.text-capitalize{text-transform:capitalize!important}.text-wrap{white-space:normal!important}.text-nowrap{white-space:nowrap!important}.text-break{word-wrap:break-word!important;word-break:break-word!important}.text-primary{--bs-text-opacity:1;color:rgba(var(--bs-primary-rgb),var(--bs-text-opacity))!important}.text-secondary{--bs-text-opacity:1;color:rgba(var(--bs-secondary-rgb),var(--bs-text-opacity))!important}.text-success{--bs-text-opacity:1;color:rgba(var(--bs-success-rgb),var(--bs-text-opacity))!important}.text-info{--bs-text-opacity:1;color:rgba(var(--bs-info-rgb),var(--bs-text-opacity))!important}.text-warning{--bs-text-opacity:1;color:rgba(var(--bs-warning-rgb),var(--bs-text-opacity))!important}.text-danger{--bs-text-opacity:1;color:rgba(var(--bs-danger-rgb),var(--bs-text-opacity))!important}.text-light{--bs-text-opacity:1;color:rgba(var(--bs-light-rgb),var(--bs-text-opacity))!important}.text-dark{--bs-text-opacity:1;color:rgba(var(--bs-dark-rgb),var(--bs-text-opacity))!important}.text-black{--bs-text-opacity:1;color:rgba(var(--bs-black-rgb),var(--bs-text-opacity))!important}.text-white{--bs-text-opacity:1;color:rgba(var(--bs-white-rgb),var(--bs-text-opacity))!important}.text-body{--bs-text-opacity:1;color:rgba(var(--bs-body-rgb),var(--bs-text-opacity))!important}.text-muted{--bs-text-opacity:1;color:#6c757d!important}.text-black-50{--bs-text-opacity:1;color:rgba(0,0,0,.5)!important}.text-white-50{--bs-text-opacity:1;color:rgba(255,255,255,.5)!important}.text-reset{--bs-text-opacity:1;color:inherit!important}.text-opacity-25{--bs-text-opacity:0.25}.text-opacity-50{--bs-text-opacity:0.5}.text-opacity-75{--bs-text-opacity:0.75}.text-opacity-100{--bs-text-opacity:1}.bg-primary{--bs-bg-opacity:1;background-color:rgba(var(--bs-primary-rgb),var(--bs-bg-opacity))!important}.bg-secondary{--bs-bg-opacity:1;background-color:rgba(var(--bs-secondary-rgb),var(--bs-bg-opacity))!important}.bg-success{--bs-bg-opacity:1;background-color:rgba(var(--bs-success-rgb),var(--bs-bg-opacity))!important}.bg-info{--bs-bg-opacity:1;background-color:rgba(var(--bs-info-rgb),var(--bs-bg-opacity))!important}.bg-warning{--bs-bg-opacity:1;background-color:rgba(var(--bs-warning-rgb),var(--bs-bg-opacity))!important}.bg-danger{--bs-bg-opacity:1;background-color:rgba(var(--bs-danger-rgb),var(--bs-bg-opacity))!important}.bg-light{--bs-bg-opacity:1;background-color:rgba(var(--bs-light-rgb),var(--bs-bg-opacity))!important}.bg-dark{--bs-bg-opacity:1;background-color:rgba(var(--bs-dark-rgb),var(--bs-bg-opacity))!important}.bg-black{--bs-bg-opacity:1;background-color:rgba(var(--bs-black-rgb),var(--bs-bg-opacity))!important}.bg-white{--bs-bg-opacity:1;background-color:rgba(var(--bs-white-rgb),var(--bs-bg-opacity))!important}.bg-body{--bs-bg-opacity:1;background-color:rgba(var(--bs-body-rgb),var(--bs-bg-opacity))!important}.bg-transparent{--bs-bg-opacity:1;background-color:transparent!important}.bg-opacity-10{--bs-bg-opacity:0.1}.bg-opacity-25{--bs-bg-opacity:0.25}.bg-opacity-50{--bs-bg-opacity:0.5}.bg-opacity-75{--bs-bg-opacity:0.75}.bg-opacity-100{--bs-bg-opacity:1}.bg-gradient{background-image:var(--bs-gradient)!important}.user-select-all{-webkit-user-select:all!important;-moz-user-select:all!important;user-select:all!important}.user-select-auto{-webkit-user-select:auto!important;-moz-user-select:auto!important;user-select:auto!important}.user-select-none{-webkit-user-select:none!important;-moz-user-select:none!important;user-select:none!important}.pe-none{pointer-events:none!important}.pe-auto{pointer-events:auto!important}.rounded{border-radius:.25rem!important}.rounded-0{border-radius:0!important}.rounded-1{border-radius:.2rem!important}.rounded-2{border-radius:.25rem!important}.rounded-3{border-radius:.3rem!important}.rounded-circle{border-radius:50%!important}.rounded-pill{border-radius:50rem!important}.rounded-top{border-top-left-radius:.25rem!important;border-top-right-radius:.25rem!important}.rounded-end{border-top-right-radius:.25rem!important;border-bottom-right-radius:.25rem!important}.rounded-bottom{border-bottom-right-radius:.25rem!important;border-bottom-left-radius:.25rem!important}.rounded-start{border-bottom-left-radius:.25rem!important;border-top-left-radius:.25rem!important}.visible{visibility:visible!important}.invisible{visibility:hidden!important}@media (min-width:576px){.float-sm-start{float:left!important}.float-sm-end{float:right!important}.float-sm-none{float:none!important}.d-sm-inline{display:inline!important}.d-sm-inline-block{display:inline-block!important}.d-sm-block{display:block!important}.d-sm-grid{display:grid!important}.d-sm-table{display:table!important}.d-sm-table-row{display:table-row!important}.d-sm-table-cell{display:table-cell!important}.d-sm-flex{display:flex!important}.d-sm-inline-flex{display:inline-flex!important}.d-sm-none{display:none!important}.flex-sm-fill{flex:1 1 auto!important}.flex-sm-row{flex-direction:row!important}.flex-sm-column{flex-direction:column!important}.flex-sm-row-reverse{flex-direction:row-reverse!important}.flex-sm-column-reverse{flex-direction:column-reverse!important}.flex-sm-grow-0{flex-grow:0!important}.flex-sm-grow-1{flex-grow:1!important}.flex-sm-shrink-0{flex-shrink:0!important}.flex-sm-shrink-1{flex-shrink:1!important}.flex-sm-wrap{flex-wrap:wrap!important}.flex-sm-nowrap{flex-wrap:nowrap!important}.flex-sm-wrap-reverse{flex-wrap:wrap-reverse!important}.gap-sm-0{gap:0!important}.gap-sm-1{gap:.25rem!important}.gap-sm-2{gap:.5rem!important}.gap-sm-3{gap:1rem!important}.gap-sm-4{gap:1.5rem!important}.gap-sm-5{gap:3rem!important}.justify-content-sm-start{justify-content:flex-start!important}.justify-content-sm-end{justify-content:flex-end!important}.justify-content-sm-center{justify-content:center!important}.justify-content-sm-between{justify-content:space-between!important}.justify-content-sm-around{justify-content:space-around!important}.justify-content-sm-evenly{justify-content:space-evenly!important}.align-items-sm-start{align-items:flex-start!important}.align-items-sm-end{align-items:flex-end!important}.align-items-sm-center{align-items:center!important}.align-items-sm-baseline{align-items:baseline!important}.align-items-sm-stretch{align-items:stretch!important}.align-content-sm-start{align-content:flex-start!important}.align-content-sm-end{align-content:flex-end!important}.align-content-sm-center{align-content:center!important}.align-content-sm-between{align-content:space-between!important}.align-content-sm-around{align-content:space-around!important}.align-content-sm-stretch{align-content:stretch!important}.align-self-sm-auto{align-self:auto!important}.align-self-sm-start{align-self:flex-start!important}.align-self-sm-end{align-self:flex-end!important}.align-self-sm-center{align-self:center!important}.align-self-sm-baseline{align-self:baseline!important}.align-self-sm-stretch{align-self:stretch!important}.order-sm-first{order:-1!important}.order-sm-0{order:0!important}.order-sm-1{order:1!important}.order-sm-2{order:2!important}.order-sm-3{order:3!important}.order-sm-4{order:4!important}.order-sm-5{order:5!important}.order-sm-last{order:6!important}.m-sm-0{margin:0!important}.m-sm-1{margin:.25rem!important}.m-sm-2{margin:.5rem!important}.m-sm-3{margin:1rem!important}.m-sm-4{margin:1.5rem!important}.m-sm-5{margin:3rem!important}.m-sm-auto{margin:auto!important}.mx-sm-0{margin-right:0!important;margin-left:0!important}.mx-sm-1{margin-right:.25rem!important;margin-left:.25rem!important}.mx-sm-2{margin-right:.5rem!important;margin-left:.5rem!important}.mx-sm-3{margin-right:1rem!important;margin-left:1rem!important}.mx-sm-4{margin-right:1.5rem!important;margin-left:1.5rem!important}.mx-sm-5{margin-right:3rem!important;margin-left:3rem!important}.mx-sm-auto{margin-right:auto!important;margin-left:auto!important}.my-sm-0{margin-top:0!important;margin-bottom:0!important}.my-sm-1{margin-top:.25rem!important;margin-bottom:.25rem!important}.my-sm-2{margin-top:.5rem!important;margin-bottom:.5rem!important}.my-sm-3{margin-top:1rem!important;margin-bottom:1rem!important}.my-sm-4{margin-top:1.5rem!important;margin-bottom:1.5rem!important}.my-sm-5{margin-top:3rem!important;margin-bottom:3rem!important}.my-sm-auto{margin-top:auto!important;margin-bottom:auto!important}.mt-sm-0{margin-top:0!important}.mt-sm-1{margin-top:.25rem!important}.mt-sm-2{margin-top:.5rem!important}.mt-sm-3{margin-top:1rem!important}.mt-sm-4{margin-top:1.5rem!important}.mt-sm-5{margin-top:3rem!important}.mt-sm-auto{margin-top:auto!important}.me-sm-0{margin-right:0!important}.me-sm-1{margin-right:.25rem!important}.me-sm-2{margin-right:.5rem!important}.me-sm-3{margin-right:1rem!important}.me-sm-4{margin-right:1.5rem!important}.me-sm-5{margin-right:3rem!important}.me-sm-auto{margin-right:auto!important}.mb-sm-0{margin-bottom:0!important}.mb-sm-1{margin-bottom:.25rem!important}.mb-sm-2{margin-bottom:.5rem!important}.mb-sm-3{margin-bottom:1rem!important}.mb-sm-4{margin-bottom:1.5rem!important}.mb-sm-5{margin-bottom:3rem!important}.mb-sm-auto{margin-bottom:auto!important}.ms-sm-0{margin-left:0!important}.ms-sm-1{margin-left:.25rem!important}.ms-sm-2{margin-left:.5rem!important}.ms-sm-3{margin-left:1rem!important}.ms-sm-4{margin-left:1.5rem!important}.ms-sm-5{margin-left:3rem!important}.ms-sm-auto{margin-left:auto!important}.p-sm-0{padding:0!important}.p-sm-1{padding:.25rem!important}.p-sm-2{padding:.5rem!important}.p-sm-3{padding:1rem!important}.p-sm-4{padding:1.5rem!important}.p-sm-5{padding:3rem!important}.px-sm-0{padding-right:0!important;padding-left:0!important}.px-sm-1{padding-right:.25rem!important;padding-left:.25rem!important}.px-sm-2{padding-right:.5rem!important;padding-left:.5rem!important}.px-sm-3{padding-right:1rem!important;padding-left:1rem!important}.px-sm-4{padding-right:1.5rem!important;padding-left:1.5rem!important}.px-sm-5{padding-right:3rem!important;padding-left:3rem!important}.py-sm-0{padding-top:0!important;padding-bottom:0!important}.py-sm-1{padding-top:.25rem!important;padding-bottom:.25rem!important}.py-sm-2{padding-top:.5rem!important;padding-bottom:.5rem!important}.py-sm-3{padding-top:1rem!important;padding-bottom:1rem!important}.py-sm-4{padding-top:1.5rem!important;padding-bottom:1.5rem!important}.py-sm-5{padding-top:3rem!important;padding-bottom:3rem!important}.pt-sm-0{padding-top:0!important}.pt-sm-1{padding-top:.25rem!important}.pt-sm-2{padding-top:.5rem!important}.pt-sm-3{padding-top:1rem!important}.pt-sm-4{padding-top:1.5rem!important}.pt-sm-5{padding-top:3rem!important}.pe-sm-0{padding-right:0!important}.pe-sm-1{padding-right:.25rem!important}.pe-sm-2{padding-right:.5rem!important}.pe-sm-3{padding-right:1rem!important}.pe-sm-4{padding-right:1.5rem!important}.pe-sm-5{padding-right:3rem!important}.pb-sm-0{padding-bottom:0!important}.pb-sm-1{padding-bottom:.25rem!important}.pb-sm-2{padding-bottom:.5rem!important}.pb-sm-3{padding-bottom:1rem!important}.pb-sm-4{padding-bottom:1.5rem!important}.pb-sm-5{padding-bottom:3rem!important}.ps-sm-0{padding-left:0!important}.ps-sm-1{padding-left:.25rem!important}.ps-sm-2{padding-left:.5rem!important}.ps-sm-3{padding-left:1rem!important}.ps-sm-4{padding-left:1.5rem!important}.ps-sm-5{padding-left:3rem!important}.text-sm-start{text-align:left!important}.text-sm-end{text-align:right!important}.text-sm-center{text-align:center!important}}@media (min-width:768px){.float-md-start{float:left!important}.float-md-end{float:right!important}.float-md-none{float:none!important}.d-md-inline{display:inline!important}.d-md-inline-block{display:inline-block!important}.d-md-block{display:block!important}.d-md-grid{display:grid!important}.d-md-table{display:table!important}.d-md-table-row{display:table-row!important}.d-md-table-cell{display:table-cell!important}.d-md-flex{display:flex!important}.d-md-inline-flex{display:inline-flex!important}.d-md-none{display:none!important}.flex-md-fill{flex:1 1 auto!important}.flex-md-row{flex-direction:row!important}.flex-md-column{flex-direction:column!important}.flex-md-row-reverse{flex-direction:row-reverse!important}.flex-md-column-reverse{flex-direction:column-reverse!important}.flex-md-grow-0{flex-grow:0!important}.flex-md-grow-1{flex-grow:1!important}.flex-md-shrink-0{flex-shrink:0!important}.flex-md-shrink-1{flex-shrink:1!important}.flex-md-wrap{flex-wrap:wrap!important}.flex-md-nowrap{flex-wrap:nowrap!important}.flex-md-wrap-reverse{flex-wrap:wrap-reverse!important}.gap-md-0{gap:0!important}.gap-md-1{gap:.25rem!important}.gap-md-2{gap:.5rem!important}.gap-md-3{gap:1rem!important}.gap-md-4{gap:1.5rem!important}.gap-md-5{gap:3rem!important}.justify-content-md-start{justify-content:flex-start!important}.justify-content-md-end{justify-content:flex-end!important}.justify-content-md-center{justify-content:center!important}.justify-content-md-between{justify-content:space-between!important}.justify-content-md-around{justify-content:space-around!important}.justify-content-md-evenly{justify-content:space-evenly!important}.align-items-md-start{align-items:flex-start!important}.align-items-md-end{align-items:flex-end!important}.align-items-md-center{align-items:center!important}.align-items-md-baseline{align-items:baseline!important}.align-items-md-stretch{align-items:stretch!important}.align-content-md-start{align-content:flex-start!important}.align-content-md-end{align-content:flex-end!important}.align-content-md-center{align-content:center!important}.align-content-md-between{align-content:space-between!important}.align-content-md-around{align-content:space-around!important}.align-content-md-stretch{align-content:stretch!important}.align-self-md-auto{align-self:auto!important}.align-self-md-start{align-self:flex-start!important}.align-self-md-end{align-self:flex-end!important}.align-self-md-center{align-self:center!important}.align-self-md-baseline{align-self:baseline!important}.align-self-md-stretch{align-self:stretch!important}.order-md-first{order:-1!important}.order-md-0{order:0!important}.order-md-1{order:1!important}.order-md-2{order:2!important}.order-md-3{order:3!important}.order-md-4{order:4!important}.order-md-5{order:5!important}.order-md-last{order:6!important}.m-md-0{margin:0!important}.m-md-1{margin:.25rem!important}.m-md-2{margin:.5rem!important}.m-md-3{margin:1rem!important}.m-md-4{margin:1.5rem!important}.m-md-5{margin:3rem!important}.m-md-auto{margin:auto!important}.mx-md-0{margin-right:0!important;margin-left:0!important}.mx-md-1{margin-right:.25rem!important;margin-left:.25rem!important}.mx-md-2{margin-right:.5rem!important;margin-left:.5rem!important}.mx-md-3{margin-right:1rem!important;margin-left:1rem!important}.mx-md-4{margin-right:1.5rem!important;margin-left:1.5rem!important}.mx-md-5{margin-right:3rem!important;margin-left:3rem!important}.mx-md-auto{margin-right:auto!important;margin-left:auto!important}.my-md-0{margin-top:0!important;margin-bottom:0!important}.my-md-1{margin-top:.25rem!important;margin-bottom:.25rem!important}.my-md-2{margin-top:.5rem!important;margin-bottom:.5rem!important}.my-md-3{margin-top:1rem!important;margin-bottom:1rem!important}.my-md-4{margin-top:1.5rem!important;margin-bottom:1.5rem!important}.my-md-5{margin-top:3rem!important;margin-bottom:3rem!important}.my-md-auto{margin-top:auto!important;margin-bottom:auto!important}.mt-md-0{margin-top:0!important}.mt-md-1{margin-top:.25rem!important}.mt-md-2{margin-top:.5rem!important}.mt-md-3{margin-top:1rem!important}.mt-md-4{margin-top:1.5rem!important}.mt-md-5{margin-top:3rem!important}.mt-md-auto{margin-top:auto!important}.me-md-0{margin-right:0!important}.me-md-1{margin-right:.25rem!important}.me-md-2{margin-right:.5rem!important}.me-md-3{margin-right:1rem!important}.me-md-4{margin-right:1.5rem!important}.me-md-5{margin-right:3rem!important}.me-md-auto{margin-right:auto!important}.mb-md-0{margin-bottom:0!important}.mb-md-1{margin-bottom:.25rem!important}.mb-md-2{margin-bottom:.5rem!important}.mb-md-3{margin-bottom:1rem!important}.mb-md-4{margin-bottom:1.5rem!important}.mb-md-5{margin-bottom:3rem!important}.mb-md-auto{margin-bottom:auto!important}.ms-md-0{margin-left:0!important}.ms-md-1{margin-left:.25rem!important}.ms-md-2{margin-left:.5rem!important}.ms-md-3{margin-left:1rem!important}.ms-md-4{margin-left:1.5rem!important}.ms-md-5{margin-left:3rem!important}.ms-md-auto{margin-left:auto!important}.p-md-0{padding:0!important}.p-md-1{padding:.25rem!important}.p-md-2{padding:.5rem!important}.p-md-3{padding:1rem!important}.p-md-4{padding:1.5rem!important}.p-md-5{padding:3rem!important}.px-md-0{padding-right:0!important;padding-left:0!important}.px-md-1{padding-right:.25rem!important;padding-left:.25rem!important}.px-md-2{padding-right:.5rem!important;padding-left:.5rem!important}.px-md-3{padding-right:1rem!important;padding-left:1rem!important}.px-md-4{padding-right:1.5rem!important;padding-left:1.5rem!important}.px-md-5{padding-right:3rem!important;padding-left:3rem!important}.py-md-0{padding-top:0!important;padding-bottom:0!important}.py-md-1{padding-top:.25rem!important;padding-bottom:.25rem!important}.py-md-2{padding-top:.5rem!important;padding-bottom:.5rem!important}.py-md-3{padding-top:1rem!important;padding-bottom:1rem!important}.py-md-4{padding-top:1.5rem!important;padding-bottom:1.5rem!important}.py-md-5{padding-top:3rem!important;padding-bottom:3rem!important}.pt-md-0{padding-top:0!important}.pt-md-1{padding-top:.25rem!important}.pt-md-2{padding-top:.5rem!important}.pt-md-3{padding-top:1rem!important}.pt-md-4{padding-top:1.5rem!important}.pt-md-5{padding-top:3rem!important}.pe-md-0{padding-right:0!important}.pe-md-1{padding-right:.25rem!important}.pe-md-2{padding-right:.5rem!important}.pe-md-3{padding-right:1rem!important}.pe-md-4{padding-right:1.5rem!important}.pe-md-5{padding-right:3rem!important}.pb-md-0{padding-bottom:0!important}.pb-md-1{padding-bottom:.25rem!important}.pb-md-2{padding-bottom:.5rem!important}.pb-md-3{padding-bottom:1rem!important}.pb-md-4{padding-bottom:1.5rem!important}.pb-md-5{padding-bottom:3rem!important}.ps-md-0{padding-left:0!important}.ps-md-1{padding-left:.25rem!important}.ps-md-2{padding-left:.5rem!important}.ps-md-3{padding-left:1rem!important}.ps-md-4{padding-left:1.5rem!important}.ps-md-5{padding-left:3rem!important}.text-md-start{text-align:left!important}.text-md-end{text-align:right!important}.text-md-center{text-align:center!important}}@media (min-width:992px){.float-lg-start{float:left!important}.float-lg-end{float:right!important}.float-lg-none{float:none!important}.d-lg-inline{display:inline!important}.d-lg-inline-block{display:inline-block!important}.d-lg-block{display:block!important}.d-lg-grid{display:grid!important}.d-lg-table{display:table!important}.d-lg-table-row{display:table-row!important}.d-lg-table-cell{display:table-cell!important}.d-lg-flex{display:flex!important}.d-lg-inline-flex{display:inline-flex!important}.d-lg-none{display:none!important}.flex-lg-fill{flex:1 1 auto!important}.flex-lg-row{flex-direction:row!important}.flex-lg-column{flex-direction:column!important}.flex-lg-row-reverse{flex-direction:row-reverse!important}.flex-lg-column-reverse{flex-direction:column-reverse!important}.flex-lg-grow-0{flex-grow:0!important}.flex-lg-grow-1{flex-grow:1!important}.flex-lg-shrink-0{flex-shrink:0!important}.flex-lg-shrink-1{flex-shrink:1!important}.flex-lg-wrap{flex-wrap:wrap!important}.flex-lg-nowrap{flex-wrap:nowrap!important}.flex-lg-wrap-reverse{flex-wrap:wrap-reverse!important}.gap-lg-0{gap:0!important}.gap-lg-1{gap:.25rem!important}.gap-lg-2{gap:.5rem!important}.gap-lg-3{gap:1rem!important}.gap-lg-4{gap:1.5rem!important}.gap-lg-5{gap:3rem!important}.justify-content-lg-start{justify-content:flex-start!important}.justify-content-lg-end{justify-content:flex-end!important}.justify-content-lg-center{justify-content:center!important}.justify-content-lg-between{justify-content:space-between!important}.justify-content-lg-around{justify-content:space-around!important}.justify-content-lg-evenly{justify-content:space-evenly!important}.align-items-lg-start{align-items:flex-start!important}.align-items-lg-end{align-items:flex-end!important}.align-items-lg-center{align-items:center!important}.align-items-lg-baseline{align-items:baseline!important}.align-items-lg-stretch{align-items:stretch!important}.align-content-lg-start{align-content:flex-start!important}.align-content-lg-end{align-content:flex-end!important}.align-content-lg-center{align-content:center!important}.align-content-lg-between{align-content:space-between!important}.align-content-lg-around{align-content:space-around!important}.align-content-lg-stretch{align-content:stretch!important}.align-self-lg-auto{align-self:auto!important}.align-self-lg-start{align-self:flex-start!important}.align-self-lg-end{align-self:flex-end!important}.align-self-lg-center{align-self:center!important}.align-self-lg-baseline{align-self:baseline!important}.align-self-lg-stretch{align-self:stretch!important}.order-lg-first{order:-1!important}.order-lg-0{order:0!important}.order-lg-1{order:1!important}.order-lg-2{order:2!important}.order-lg-3{order:3!important}.order-lg-4{order:4!important}.order-lg-5{order:5!important}.order-lg-last{order:6!important}.m-lg-0{margin:0!important}.m-lg-1{margin:.25rem!important}.m-lg-2{margin:.5rem!important}.m-lg-3{margin:1rem!important}.m-lg-4{margin:1.5rem!important}.m-lg-5{margin:3rem!important}.m-lg-auto{margin:auto!important}.mx-lg-0{margin-right:0!important;margin-left:0!important}.mx-lg-1{margin-right:.25rem!important;margin-left:.25rem!important}.mx-lg-2{margin-right:.5rem!important;margin-left:.5rem!important}.mx-lg-3{margin-right:1rem!important;margin-left:1rem!important}.mx-lg-4{margin-right:1.5rem!important;margin-left:1.5rem!important}.mx-lg-5{margin-right:3rem!important;margin-left:3rem!important}.mx-lg-auto{margin-right:auto!important;margin-left:auto!important}.my-lg-0{margin-top:0!important;margin-bottom:0!important}.my-lg-1{margin-top:.25rem!important;margin-bottom:.25rem!important}.my-lg-2{margin-top:.5rem!important;margin-bottom:.5rem!important}.my-lg-3{margin-top:1rem!important;margin-bottom:1rem!important}.my-lg-4{margin-top:1.5rem!important;margin-bottom:1.5rem!important}.my-lg-5{margin-top:3rem!important;margin-bottom:3rem!important}.my-lg-auto{margin-top:auto!important;margin-bottom:auto!important}.mt-lg-0{margin-top:0!important}.mt-lg-1{margin-top:.25rem!important}.mt-lg-2{margin-top:.5rem!important}.mt-lg-3{margin-top:1rem!important}.mt-lg-4{margin-top:1.5rem!important}.mt-lg-5{margin-top:3rem!important}.mt-lg-auto{margin-top:auto!important}.me-lg-0{margin-right:0!important}.me-lg-1{margin-right:.25rem!important}.me-lg-2{margin-right:.5rem!important}.me-lg-3{margin-right:1rem!important}.me-lg-4{margin-right:1.5rem!important}.me-lg-5{margin-right:3rem!important}.me-lg-auto{margin-right:auto!important}.mb-lg-0{margin-bottom:0!important}.mb-lg-1{margin-bottom:.25rem!important}.mb-lg-2{margin-bottom:.5rem!important}.mb-lg-3{margin-bottom:1rem!important}.mb-lg-4{margin-bottom:1.5rem!important}.mb-lg-5{margin-bottom:3rem!important}.mb-lg-auto{margin-bottom:auto!important}.ms-lg-0{margin-left:0!important}.ms-lg-1{margin-left:.25rem!important}.ms-lg-2{margin-left:.5rem!important}.ms-lg-3{margin-left:1rem!important}.ms-lg-4{margin-left:1.5rem!important}.ms-lg-5{margin-left:3rem!important}.ms-lg-auto{margin-left:auto!important}.p-lg-0{padding:0!important}.p-lg-1{padding:.25rem!important}.p-lg-2{padding:.5rem!important}.p-lg-3{padding:1rem!important}.p-lg-4{padding:1.5rem!important}.p-lg-5{padding:3rem!important}.px-lg-0{padding-right:0!important;padding-left:0!important}.px-lg-1{padding-right:.25rem!important;padding-left:.25rem!important}.px-lg-2{padding-right:.5rem!important;padding-left:.5rem!important}.px-lg-3{padding-right:1rem!important;padding-left:1rem!important}.px-lg-4{padding-right:1.5rem!important;padding-left:1.5rem!important}.px-lg-5{padding-right:3rem!important;padding-left:3rem!important}.py-lg-0{padding-top:0!important;padding-bottom:0!important}.py-lg-1{padding-top:.25rem!important;padding-bottom:.25rem!important}.py-lg-2{padding-top:.5rem!important;padding-bottom:.5rem!important}.py-lg-3{padding-top:1rem!important;padding-bottom:1rem!important}.py-lg-4{padding-top:1.5rem!important;padding-bottom:1.5rem!important}.py-lg-5{padding-top:3rem!important;padding-bottom:3rem!important}.pt-lg-0{padding-top:0!important}.pt-lg-1{padding-top:.25rem!important}.pt-lg-2{padding-top:.5rem!important}.pt-lg-3{padding-top:1rem!important}.pt-lg-4{padding-top:1.5rem!important}.pt-lg-5{padding-top:3rem!important}.pe-lg-0{padding-right:0!important}.pe-lg-1{padding-right:.25rem!important}.pe-lg-2{padding-right:.5rem!important}.pe-lg-3{padding-right:1rem!important}.pe-lg-4{padding-right:1.5rem!important}.pe-lg-5{padding-right:3rem!important}.pb-lg-0{padding-bottom:0!important}.pb-lg-1{padding-bottom:.25rem!important}.pb-lg-2{padding-bottom:.5rem!important}.pb-lg-3{padding-bottom:1rem!important}.pb-lg-4{padding-bottom:1.5rem!important}.pb-lg-5{padding-bottom:3rem!important}.ps-lg-0{padding-left:0!important}.ps-lg-1{padding-left:.25rem!important}.ps-lg-2{padding-left:.5rem!important}.ps-lg-3{padding-left:1rem!important}.ps-lg-4{padding-left:1.5rem!important}.ps-lg-5{padding-left:3rem!important}.text-lg-start{text-align:left!important}.text-lg-end{text-align:right!important}.text-lg-center{text-align:center!important}}@media (min-width:1200px){.float-xl-start{float:left!important}.float-xl-end{float:right!important}.float-xl-none{float:none!important}.d-xl-inline{display:inline!important}.d-xl-inline-block{display:inline-block!important}.d-xl-block{display:block!important}.d-xl-grid{display:grid!important}.d-xl-table{display:table!important}.d-xl-table-row{display:table-row!important}.d-xl-table-cell{display:table-cell!important}.d-xl-flex{display:flex!important}.d-xl-inline-flex{display:inline-flex!important}.d-xl-none{display:none!important}.flex-xl-fill{flex:1 1 auto!important}.flex-xl-row{flex-direction:row!important}.flex-xl-column{flex-direction:column!important}.flex-xl-row-reverse{flex-direction:row-reverse!important}.flex-xl-column-reverse{flex-direction:column-reverse!important}.flex-xl-grow-0{flex-grow:0!important}.flex-xl-grow-1{flex-grow:1!important}.flex-xl-shrink-0{flex-shrink:0!important}.flex-xl-shrink-1{flex-shrink:1!important}.flex-xl-wrap{flex-wrap:wrap!important}.flex-xl-nowrap{flex-wrap:nowrap!important}.flex-xl-wrap-reverse{flex-wrap:wrap-reverse!important}.gap-xl-0{gap:0!important}.gap-xl-1{gap:.25rem!important}.gap-xl-2{gap:.5rem!important}.gap-xl-3{gap:1rem!important}.gap-xl-4{gap:1.5rem!important}.gap-xl-5{gap:3rem!important}.justify-content-xl-start{justify-content:flex-start!important}.justify-content-xl-end{justify-content:flex-end!important}.justify-content-xl-center{justify-content:center!important}.justify-content-xl-between{justify-content:space-between!important}.justify-content-xl-around{justify-content:space-around!important}.justify-content-xl-evenly{justify-content:space-evenly!important}.align-items-xl-start{align-items:flex-start!important}.align-items-xl-end{align-items:flex-end!important}.align-items-xl-center{align-items:center!important}.align-items-xl-baseline{align-items:baseline!important}.align-items-xl-stretch{align-items:stretch!important}.align-content-xl-start{align-content:flex-start!important}.align-content-xl-end{align-content:flex-end!important}.align-content-xl-center{align-content:center!important}.align-content-xl-between{align-content:space-between!important}.align-content-xl-around{align-content:space-around!important}.align-content-xl-stretch{align-content:stretch!important}.align-self-xl-auto{align-self:auto!important}.align-self-xl-start{align-self:flex-start!important}.align-self-xl-end{align-self:flex-end!important}.align-self-xl-center{align-self:center!important}.align-self-xl-baseline{align-self:baseline!important}.align-self-xl-stretch{align-self:stretch!important}.order-xl-first{order:-1!important}.order-xl-0{order:0!important}.order-xl-1{order:1!important}.order-xl-2{order:2!important}.order-xl-3{order:3!important}.order-xl-4{order:4!important}.order-xl-5{order:5!important}.order-xl-last{order:6!important}.m-xl-0{margin:0!important}.m-xl-1{margin:.25rem!important}.m-xl-2{margin:.5rem!important}.m-xl-3{margin:1rem!important}.m-xl-4{margin:1.5rem!important}.m-xl-5{margin:3rem!important}.m-xl-auto{margin:auto!important}.mx-xl-0{margin-right:0!important;margin-left:0!important}.mx-xl-1{margin-right:.25rem!important;margin-left:.25rem!important}.mx-xl-2{margin-right:.5rem!important;margin-left:.5rem!important}.mx-xl-3{margin-right:1rem!important;margin-left:1rem!important}.mx-xl-4{margin-right:1.5rem!important;margin-left:1.5rem!important}.mx-xl-5{margin-right:3rem!important;margin-left:3rem!important}.mx-xl-auto{margin-right:auto!important;margin-left:auto!important}.my-xl-0{margin-top:0!important;margin-bottom:0!important}.my-xl-1{margin-top:.25rem!important;margin-bottom:.25rem!important}.my-xl-2{margin-top:.5rem!important;margin-bottom:.5rem!important}.my-xl-3{margin-top:1rem!important;margin-bottom:1rem!important}.my-xl-4{margin-top:1.5rem!important;margin-bottom:1.5rem!important}.my-xl-5{margin-top:3rem!important;margin-bottom:3rem!important}.my-xl-auto{margin-top:auto!important;margin-bottom:auto!important}.mt-xl-0{margin-top:0!important}.mt-xl-1{margin-top:.25rem!important}.mt-xl-2{margin-top:.5rem!important}.mt-xl-3{margin-top:1rem!important}.mt-xl-4{margin-top:1.5rem!important}.mt-xl-5{margin-top:3rem!important}.mt-xl-auto{margin-top:auto!important}.me-xl-0{margin-right:0!important}.me-xl-1{margin-right:.25rem!important}.me-xl-2{margin-right:.5rem!important}.me-xl-3{margin-right:1rem!important}.me-xl-4{margin-right:1.5rem!important}.me-xl-5{margin-right:3rem!important}.me-xl-auto{margin-right:auto!important}.mb-xl-0{margin-bottom:0!important}.mb-xl-1{margin-bottom:.25rem!important}.mb-xl-2{margin-bottom:.5rem!important}.mb-xl-3{margin-bottom:1rem!important}.mb-xl-4{margin-bottom:1.5rem!important}.mb-xl-5{margin-bottom:3rem!important}.mb-xl-auto{margin-bottom:auto!important}.ms-xl-0{margin-left:0!important}.ms-xl-1{margin-left:.25rem!important}.ms-xl-2{margin-left:.5rem!important}.ms-xl-3{margin-left:1rem!important}.ms-xl-4{margin-left:1.5rem!important}.ms-xl-5{margin-left:3rem!important}.ms-xl-auto{margin-left:auto!important}.p-xl-0{padding:0!important}.p-xl-1{padding:.25rem!important}.p-xl-2{padding:.5rem!important}.p-xl-3{padding:1rem!important}.p-xl-4{padding:1.5rem!important}.p-xl-5{padding:3rem!important}.px-xl-0{padding-right:0!important;padding-left:0!important}.px-xl-1{padding-right:.25rem!important;padding-left:.25rem!important}.px-xl-2{padding-right:.5rem!important;padding-left:.5rem!important}.px-xl-3{padding-right:1rem!important;padding-left:1rem!important}.px-xl-4{padding-right:1.5rem!important;padding-left:1.5rem!important}.px-xl-5{padding-right:3rem!important;padding-left:3rem!important}.py-xl-0{padding-top:0!important;padding-bottom:0!important}.py-xl-1{padding-top:.25rem!important;padding-bottom:.25rem!important}.py-xl-2{padding-top:.5rem!important;padding-bottom:.5rem!important}.py-xl-3{padding-top:1rem!important;padding-bottom:1rem!important}.py-xl-4{padding-top:1.5rem!important;padding-bottom:1.5rem!important}.py-xl-5{padding-top:3rem!important;padding-bottom:3rem!important}.pt-xl-0{padding-top:0!important}.pt-xl-1{padding-top:.25rem!important}.pt-xl-2{padding-top:.5rem!important}.pt-xl-3{padding-top:1rem!important}.pt-xl-4{padding-top:1.5rem!important}.pt-xl-5{padding-top:3rem!important}.pe-xl-0{padding-right:0!important}.pe-xl-1{padding-right:.25rem!important}.pe-xl-2{padding-right:.5rem!important}.pe-xl-3{padding-right:1rem!important}.pe-xl-4{padding-right:1.5rem!important}.pe-xl-5{padding-right:3rem!important}.pb-xl-0{padding-bottom:0!important}.pb-xl-1{padding-bottom:.25rem!important}.pb-xl-2{padding-bottom:.5rem!important}.pb-xl-3{padding-bottom:1rem!important}.pb-xl-4{padding-bottom:1.5rem!important}.pb-xl-5{padding-bottom:3rem!important}.ps-xl-0{padding-left:0!important}.ps-xl-1{padding-left:.25rem!important}.ps-xl-2{padding-left:.5rem!important}.ps-xl-3{padding-left:1rem!important}.ps-xl-4{padding-left:1.5rem!important}.ps-xl-5{padding-left:3rem!important}.text-xl-start{text-align:left!important}.text-xl-end{text-align:right!important}.text-xl-center{text-align:center!important}}@media (min-width:1400px){.float-xxl-start{float:left!important}.float-xxl-end{float:right!important}.float-xxl-none{float:none!important}.d-xxl-inline{display:inline!important}.d-xxl-inline-block{display:inline-block!important}.d-xxl-block{display:block!important}.d-xxl-grid{display:grid!important}.d-xxl-table{display:table!important}.d-xxl-table-row{display:table-row!important}.d-xxl-table-cell{display:table-cell!important}.d-xxl-flex{display:flex!important}.d-xxl-inline-flex{display:inline-flex!important}.d-xxl-none{display:none!important}.flex-xxl-fill{flex:1 1 auto!important}.flex-xxl-row{flex-direction:row!important}.flex-xxl-column{flex-direction:column!important}.flex-xxl-row-reverse{flex-direction:row-reverse!important}.flex-xxl-column-reverse{flex-direction:column-reverse!important}.flex-xxl-grow-0{flex-grow:0!important}.flex-xxl-grow-1{flex-grow:1!important}.flex-xxl-shrink-0{flex-shrink:0!important}.flex-xxl-shrink-1{flex-shrink:1!important}.flex-xxl-wrap{flex-wrap:wrap!important}.flex-xxl-nowrap{flex-wrap:nowrap!important}.flex-xxl-wrap-reverse{flex-wrap:wrap-reverse!important}.gap-xxl-0{gap:0!important}.gap-xxl-1{gap:.25rem!important}.gap-xxl-2{gap:.5rem!important}.gap-xxl-3{gap:1rem!important}.gap-xxl-4{gap:1.5rem!important}.gap-xxl-5{gap:3rem!important}.justify-content-xxl-start{justify-content:flex-start!important}.justify-content-xxl-end{justify-content:flex-end!important}.justify-content-xxl-center{justify-content:center!important}.justify-content-xxl-between{justify-content:space-between!important}.justify-content-xxl-around{justify-content:space-around!important}.justify-content-xxl-evenly{justify-content:space-evenly!important}.align-items-xxl-start{align-items:flex-start!important}.align-items-xxl-end{align-items:flex-end!important}.align-items-xxl-center{align-items:center!important}.align-items-xxl-baseline{align-items:baseline!important}.align-items-xxl-stretch{align-items:stretch!important}.align-content-xxl-start{align-content:flex-start!important}.align-content-xxl-end{align-content:flex-end!important}.align-content-xxl-center{align-content:center!important}.align-content-xxl-between{align-content:space-between!important}.align-content-xxl-around{align-content:space-around!important}.align-content-xxl-stretch{align-content:stretch!important}.align-self-xxl-auto{align-self:auto!important}.align-self-xxl-start{align-self:flex-start!important}.align-self-xxl-end{align-self:flex-end!important}.align-self-xxl-center{align-self:center!important}.align-self-xxl-baseline{align-self:baseline!important}.align-self-xxl-stretch{align-self:stretch!important}.order-xxl-first{order:-1!important}.order-xxl-0{order:0!important}.order-xxl-1{order:1!important}.order-xxl-2{order:2!important}.order-xxl-3{order:3!important}.order-xxl-4{order:4!important}.order-xxl-5{order:5!important}.order-xxl-last{order:6!important}.m-xxl-0{margin:0!important}.m-xxl-1{margin:.25rem!important}.m-xxl-2{margin:.5rem!important}.m-xxl-3{margin:1rem!important}.m-xxl-4{margin:1.5rem!important}.m-xxl-5{margin:3rem!important}.m-xxl-auto{margin:auto!important}.mx-xxl-0{margin-right:0!important;margin-left:0!important}.mx-xxl-1{margin-right:.25rem!important;margin-left:.25rem!important}.mx-xxl-2{margin-right:.5rem!important;margin-left:.5rem!important}.mx-xxl-3{margin-right:1rem!important;margin-left:1rem!important}.mx-xxl-4{margin-right:1.5rem!important;margin-left:1.5rem!important}.mx-xxl-5{margin-right:3rem!important;margin-left:3rem!important}.mx-xxl-auto{margin-right:auto!important;margin-left:auto!important}.my-xxl-0{margin-top:0!important;margin-bottom:0!important}.my-xxl-1{margin-top:.25rem!important;margin-bottom:.25rem!important}.my-xxl-2{margin-top:.5rem!important;margin-bottom:.5rem!important}.my-xxl-3{margin-top:1rem!important;margin-bottom:1rem!important}.my-xxl-4{margin-top:1.5rem!important;margin-bottom:1.5rem!important}.my-xxl-5{margin-top:3rem!important;margin-bottom:3rem!important}.my-xxl-auto{margin-top:auto!important;margin-bottom:auto!important}.mt-xxl-0{margin-top:0!important}.mt-xxl-1{margin-top:.25rem!important}.mt-xxl-2{margin-top:.5rem!important}.mt-xxl-3{margin-top:1rem!important}.mt-xxl-4{margin-top:1.5rem!important}.mt-xxl-5{margin-top:3rem!important}.mt-xxl-auto{margin-top:auto!important}.me-xxl-0{margin-right:0!important}.me-xxl-1{margin-right:.25rem!important}.me-xxl-2{margin-right:.5rem!important}.me-xxl-3{margin-right:1rem!important}.me-xxl-4{margin-right:1.5rem!important}.me-xxl-5{margin-right:3rem!important}.me-xxl-auto{margin-right:auto!important}.mb-xxl-0{margin-bottom:0!important}.mb-xxl-1{margin-bottom:.25rem!important}.mb-xxl-2{margin-bottom:.5rem!important}.mb-xxl-3{margin-bottom:1rem!important}.mb-xxl-4{margin-bottom:1.5rem!important}.mb-xxl-5{margin-bottom:3rem!important}.mb-xxl-auto{margin-bottom:auto!important}.ms-xxl-0{margin-left:0!important}.ms-xxl-1{margin-left:.25rem!important}.ms-xxl-2{margin-left:.5rem!important}.ms-xxl-3{margin-left:1rem!important}.ms-xxl-4{margin-left:1.5rem!important}.ms-xxl-5{margin-left:3rem!important}.ms-xxl-auto{margin-left:auto!important}.p-xxl-0{padding:0!important}.p-xxl-1{padding:.25rem!important}.p-xxl-2{padding:.5rem!important}.p-xxl-3{padding:1rem!important}.p-xxl-4{padding:1.5rem!important}.p-xxl-5{padding:3rem!important}.px-xxl-0{padding-right:0!important;padding-left:0!important}.px-xxl-1{padding-right:.25rem!important;padding-left:.25rem!important}.px-xxl-2{padding-right:.5rem!important;padding-left:.5rem!important}.px-xxl-3{padding-right:1rem!important;padding-left:1rem!important}.px-xxl-4{padding-right:1.5rem!important;padding-left:1.5rem!important}.px-xxl-5{padding-right:3rem!important;padding-left:3rem!important}.py-xxl-0{padding-top:0!important;padding-bottom:0!important}.py-xxl-1{padding-top:.25rem!important;padding-bottom:.25rem!important}.py-xxl-2{padding-top:.5rem!important;padding-bottom:.5rem!important}.py-xxl-3{padding-top:1rem!important;padding-bottom:1rem!important}.py-xxl-4{padding-top:1.5rem!important;padding-bottom:1.5rem!important}.py-xxl-5{padding-top:3rem!important;padding-bottom:3rem!important}.pt-xxl-0{padding-top:0!important}.pt-xxl-1{padding-top:.25rem!important}.pt-xxl-2{padding-top:.5rem!important}.pt-xxl-3{padding-top:1rem!important}.pt-xxl-4{padding-top:1.5rem!important}.pt-xxl-5{padding-top:3rem!important}.pe-xxl-0{padding-right:0!important}.pe-xxl-1{padding-right:.25rem!important}.pe-xxl-2{padding-right:.5rem!important}.pe-xxl-3{padding-right:1rem!important}.pe-xxl-4{padding-right:1.5rem!important}.pe-xxl-5{padding-right:3rem!important}.pb-xxl-0{padding-bottom:0!important}.pb-xxl-1{padding-bottom:.25rem!important}.pb-xxl-2{padding-bottom:.5rem!important}.pb-xxl-3{padding-bottom:1rem!important}.pb-xxl-4{padding-bottom:1.5rem!important}.pb-xxl-5{padding-bottom:3rem!important}.ps-xxl-0{padding-left:0!important}.ps-xxl-1{padding-left:.25rem!important}.ps-xxl-2{padding-left:.5rem!important}.ps-xxl-3{padding-left:1rem!important}.ps-xxl-4{padding-left:1.5rem!important}.ps-xxl-5{padding-left:3rem!important}.text-xxl-start{text-align:left!important}.text-xxl-end{text-align:right!important}.text-xxl-center{text-align:center!important}}@media (min-width:1200px){.fs-1{font-size:2.5rem!important}.fs-2{font-size:2rem!important}.fs-3{font-size:1.75rem!important}.fs-4{font-size:1.5rem!important}}@media print{.d-print-inline{display:inline!important}.d-print-inline-block{display:inline-block!important}.d-print-block{display:block!important}.d-print-grid{display:grid!important}.d-print-table{display:table!important}.d-print-table-row{display:table-row!important}.d-print-table-cell{display:table-cell!important}.d-print-flex{display:flex!important}.d-print-inline-flex{display:inline-flex!important}.d-print-none{display:none!important}}
+/*# sourceMappingURL=bootstrap.min.css.map */
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/bootstrap/bootstrap.min.css.map b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/bootstrap/bootstrap.min.css.map
new file mode 100644
index 0000000000..afcd9e33e9
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/bootstrap/bootstrap.min.css.map
@@ -0,0 +1 @@
+{"version":3,"sources":["../../scss/bootstrap.scss","../../scss/_root.scss","../../scss/_reboot.scss","dist/css/bootstrap.css","../../scss/vendor/_rfs.scss","../../scss/mixins/_border-radius.scss","../../scss/_type.scss","../../scss/mixins/_lists.scss","../../scss/_images.scss","../../scss/mixins/_image.scss","../../scss/_containers.scss","../../scss/mixins/_container.scss","../../scss/mixins/_breakpoints.scss","../../scss/_grid.scss","../../scss/mixins/_grid.scss","../../scss/_tables.scss","../../scss/mixins/_table-variants.scss","../../scss/forms/_labels.scss","../../scss/forms/_form-text.scss","../../scss/forms/_form-control.scss","../../scss/mixins/_transition.scss","../../scss/mixins/_gradients.scss","../../scss/forms/_form-select.scss","../../scss/forms/_form-check.scss","../../scss/forms/_form-range.scss","../../scss/forms/_floating-labels.scss","../../scss/forms/_input-group.scss","../../scss/mixins/_forms.scss","../../scss/_buttons.scss","../../scss/mixins/_buttons.scss","../../scss/_transitions.scss","../../scss/_dropdown.scss","../../scss/mixins/_caret.scss","../../scss/_button-group.scss","../../scss/_nav.scss","../../scss/_navbar.scss","../../scss/_card.scss","../../scss/_accordion.scss","../../scss/_breadcrumb.scss","../../scss/_pagination.scss","../../scss/mixins/_pagination.scss","../../scss/_badge.scss","../../scss/_alert.scss","../../scss/mixins/_alert.scss","../../scss/_progress.scss","../../scss/_list-group.scss","../../scss/mixins/_list-group.scss","../../scss/_close.scss","../../scss/_toasts.scss","../../scss/_modal.scss","../../scss/mixins/_backdrop.scss","../../scss/_tooltip.scss","../../scss/mixins/_reset-text.scss","../../scss/_popover.scss","../../scss/_carousel.scss","../../scss/mixins/_clearfix.scss","../../scss/_spinners.scss","../../scss/_offcanvas.scss","../../scss/_placeholders.scss","../../scss/helpers/_colored-links.scss","../../scss/helpers/_ratio.scss","../../scss/helpers/_position.scss","../../scss/helpers/_stacks.scss","../../scss/helpers/_visually-hidden.scss","../../scss/mixins/_visually-hidden.scss","../../scss/helpers/_stretched-link.scss","../../scss/helpers/_text-truncation.scss","../../scss/mixins/_text-truncate.scss","../../scss/helpers/_vr.scss","../../scss/mixins/_utilities.scss","../../scss/utilities/_api.scss"],"names":[],"mappings":"iBAAA;;;;;ACAA,MAQI,UAAA,QAAA,YAAA,QAAA,YAAA,QAAA,UAAA,QAAA,SAAA,QAAA,YAAA,QAAA,YAAA,QAAA,WAAA,QAAA,UAAA,QAAA,UAAA,QAAA,WAAA,KAAA,UAAA,QAAA,eAAA,QAIA,cAAA,QAAA,cAAA,QAAA,cAAA,QAAA,cAAA,QAAA,cAAA,QAAA,cAAA,QAAA,cAAA,QAAA,cAAA,QAAA,cAAA,QAIA,aAAA,QAAA,eAAA,QAAA,aAAA,QAAA,UAAA,QAAA,aAAA,QAAA,YAAA,QAAA,WAAA,QAAA,UAAA,QAIA,iBAAA,EAAA,CAAA,GAAA,CAAA,IAAA,mBAAA,GAAA,CAAA,GAAA,CAAA,IAAA,iBAAA,EAAA,CAAA,GAAA,CAAA,GAAA,cAAA,EAAA,CAAA,GAAA,CAAA,IAAA,iBAAA,GAAA,CAAA,GAAA,CAAA,EAAA,gBAAA,GAAA,CAAA,EAAA,CAAA,GAAA,eAAA,GAAA,CAAA,GAAA,CAAA,IAAA,cAAA,EAAA,CAAA,EAAA,CAAA,GAGF,eAAA,GAAA,CAAA,GAAA,CAAA,IACA,eAAA,CAAA,CAAA,CAAA,CAAA,EACA,cAAA,EAAA,CAAA,EAAA,CAAA,GAMA,qBAAA,SAAA,CAAA,aAAA,CAAA,UAAA,CAAA,MAAA,CAAA,gBAAA,CAAA,KAAA,CAAA,WAAA,CAAA,iBAAA,CAAA,UAAA,CAAA,mBAAA,CAAA,gBAAA,CAAA,iBAAA,CAAA,mBACA,oBAAA,cAAA,CAAA,KAAA,CAAA,MAAA,CAAA,QAAA,CAAA,iBAAA,CAAA,aAAA,CAAA,UACA,cAAA,2EAQA,sBAAA,0BACA,oBAAA,KACA,sBAAA,IACA,sBAAA,IACA,gBAAA,QAIA,aAAA,KClCF,EC+CA,QADA,SD3CE,WAAA,WAeE,8CANJ,MAOM,gBAAA,QAcN,KACE,OAAA,EACA,YAAA,2BEmPI,UAAA,yBFjPJ,YAAA,2BACA,YAAA,2BACA,MAAA,qBACA,WAAA,0BACA,iBAAA,kBACA,yBAAA,KACA,4BAAA,YAUF,GACE,OAAA,KAAA,EACA,MAAA,QACA,iBAAA,aACA,OAAA,EACA,QAAA,IAGF,eACE,OAAA,IAUF,IAAA,IAAA,IAAA,IAAA,IAAA,IAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GACE,WAAA,EACA,cAAA,MAGA,YAAA,IACA,YAAA,IAIF,IAAA,GEwMQ,UAAA,uBAlKJ,0BFtCJ,IAAA,GE+MQ,UAAA,QF1MR,IAAA,GEmMQ,UAAA,sBAlKJ,0BFjCJ,IAAA,GE0MQ,UAAA,MFrMR,IAAA,GE8LQ,UAAA,oBAlKJ,0BF5BJ,IAAA,GEqMQ,UAAA,SFhMR,IAAA,GEyLQ,UAAA,sBAlKJ,0BFvBJ,IAAA,GEgMQ,UAAA,QF3LR,IAAA,GEgLM,UAAA,QF3KN,IAAA,GE2KM,UAAA,KFhKN,EACE,WAAA,EACA,cAAA,KCmBF,6BDRA,YAEE,wBAAA,UAAA,OAAA,gBAAA,UAAA,OACA,OAAA,KACA,iCAAA,KAAA,yBAAA,KAMF,QACE,cAAA,KACA,WAAA,OACA,YAAA,QAMF,GCIA,GDFE,aAAA,KCQF,GDLA,GCIA,GDDE,WAAA,EACA,cAAA,KAGF,MCKA,MACA,MAFA,MDAE,cAAA,EAGF,GACE,YAAA,IAKF,GACE,cAAA,MACA,YAAA,EAMF,WACE,OAAA,EAAA,EAAA,KAQF,ECNA,ODQE,YAAA,OAQF,OAAA,ME4EM,UAAA,OFrEN,MAAA,KACE,QAAA,KACA,iBAAA,QASF,ICpBA,IDsBE,SAAA,SEwDI,UAAA,MFtDJ,YAAA,EACA,eAAA,SAGF,IAAM,OAAA,OACN,IAAM,IAAA,MAKN,EACE,MAAA,QACA,gBAAA,UAEA,QACE,MAAA,QAWF,2BAAA,iCAEE,MAAA,QACA,gBAAA,KCxBJ,KACA,ID8BA,IC7BA,KDiCE,YAAA,yBEcI,UAAA,IFZJ,UAAA,IACA,aAAA,cAOF,IACE,QAAA,MACA,WAAA,EACA,cAAA,KACA,SAAA,KEAI,UAAA,OFKJ,SELI,UAAA,QFOF,MAAA,QACA,WAAA,OAIJ,KEZM,UAAA,OFcJ,MAAA,QACA,UAAA,WAGA,OACE,MAAA,QAIJ,IACE,QAAA,MAAA,MExBI,UAAA,OF0BJ,MAAA,KACA,iBAAA,QG7SE,cAAA,MHgTF,QACE,QAAA,EE/BE,UAAA,IFiCF,YAAA,IASJ,OACE,OAAA,EAAA,EAAA,KAMF,ICjDA,IDmDE,eAAA,OAQF,MACE,aAAA,OACA,gBAAA,SAGF,QACE,YAAA,MACA,eAAA,MACA,MAAA,QACA,WAAA,KAOF,GAEE,WAAA,QACA,WAAA,qBCxDF,MAGA,GAFA,MAGA,GDuDA,MCzDA,GD+DE,aAAA,QACA,aAAA,MACA,aAAA,EAQF,MACE,QAAA,aAMF,OAEE,cAAA,EAQF,iCACE,QAAA,ECtEF,OD2EA,MCzEA,SADA,OAEA,SD6EE,OAAA,EACA,YAAA,QE9HI,UAAA,QFgIJ,YAAA,QAIF,OC5EA,OD8EE,eAAA,KAKF,cACE,OAAA,QAGF,OAGE,UAAA,OAGA,gBACE,QAAA,EAOJ,0CACE,QAAA,KClFF,cACA,aACA,cDwFA,OAIE,mBAAA,OCxFF,6BACA,4BACA,6BDyFI,sBACE,OAAA,QAON,mBACE,QAAA,EACA,aAAA,KAKF,SACE,OAAA,SAUF,SACE,UAAA,EACA,QAAA,EACA,OAAA,EACA,OAAA,EAQF,OACE,MAAA,KACA,MAAA,KACA,QAAA,EACA,cAAA,MEnNM,UAAA,sBFsNN,YAAA,QExXE,0BFiXJ,OExMQ,UAAA,QFiNN,SACE,MAAA,KChGJ,kCDuGA,uCCxGA,mCADA,+BAGA,oCAJA,6BAKA,mCD4GE,QAAA,EAGF,4BACE,OAAA,KASF,cACE,eAAA,KACA,mBAAA,UAmBF,4BACE,mBAAA,KAKF,+BACE,QAAA,EAMF,uBACE,KAAA,QAMF,6BACE,KAAA,QACA,mBAAA,OAKF,OACE,QAAA,aAKF,OACE,OAAA,EAOF,QACE,QAAA,UACA,OAAA,QAQF,SACE,eAAA,SAQF,SACE,QAAA,eInlBF,MFyQM,UAAA,QEvQJ,YAAA,IAKA,WFsQM,UAAA,uBEpQJ,YAAA,IACA,YAAA,IFiGA,0BEpGF,WF6QM,UAAA,ME7QN,WFsQM,UAAA,uBEpQJ,YAAA,IACA,YAAA,IFiGA,0BEpGF,WF6QM,UAAA,QE7QN,WFsQM,UAAA,uBEpQJ,YAAA,IACA,YAAA,IFiGA,0BEpGF,WF6QM,UAAA,ME7QN,WFsQM,UAAA,uBEpQJ,YAAA,IACA,YAAA,IFiGA,0BEpGF,WF6QM,UAAA,QE7QN,WFsQM,UAAA,uBEpQJ,YAAA,IACA,YAAA,IFiGA,0BEpGF,WF6QM,UAAA,ME7QN,WFsQM,UAAA,uBEpQJ,YAAA,IACA,YAAA,IFiGA,0BEpGF,WF6QM,UAAA,QEvPR,eCrDE,aAAA,EACA,WAAA,KDyDF,aC1DE,aAAA,EACA,WAAA,KD4DF,kBACE,QAAA,aAEA,mCACE,aAAA,MAUJ,YFsNM,UAAA,OEpNJ,eAAA,UAIF,YACE,cAAA,KF+MI,UAAA,QE5MJ,wBACE,cAAA,EAIJ,mBACE,WAAA,MACA,cAAA,KFqMI,UAAA,OEnMJ,MAAA,QAEA,2BACE,QAAA,KE9FJ,WCIE,UAAA,KAGA,OAAA,KDDF,eACE,QAAA,OACA,iBAAA,KACA,OAAA,IAAA,MAAA,QHGE,cAAA,OIRF,UAAA,KAGA,OAAA,KDcF,QAEE,QAAA,aAGF,YACE,cAAA,MACA,YAAA,EAGF,gBJ+PM,UAAA,OI7PJ,MAAA,QElCA,WPqmBF,iBAGA,cACA,cACA,cAHA,cADA,eQzmBE,MAAA,KACA,cAAA,0BACA,aAAA,0BACA,aAAA,KACA,YAAA,KCwDE,yBF5CE,WAAA,cACE,UAAA,OE2CJ,yBF5CE,WAAA,cAAA,cACE,UAAA,OE2CJ,yBF5CE,WAAA,cAAA,cAAA,cACE,UAAA,OE2CJ,0BF5CE,WAAA,cAAA,cAAA,cAAA,cACE,UAAA,QE2CJ,0BF5CE,WAAA,cAAA,cAAA,cAAA,cAAA,eACE,UAAA,QGfN,KCAA,cAAA,OACA,cAAA,EACA,QAAA,KACA,UAAA,KACA,WAAA,8BACA,aAAA,+BACA,YAAA,+BDHE,OCYF,YAAA,EACA,MAAA,KACA,UAAA,KACA,cAAA,8BACA,aAAA,8BACA,WAAA,mBA+CI,KACE,KAAA,EAAA,EAAA,GAGF,iBApCJ,KAAA,EAAA,EAAA,KACA,MAAA,KAcA,cACE,KAAA,EAAA,EAAA,KACA,MAAA,KAFF,cACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,cACE,KAAA,EAAA,EAAA,KACA,MAAA,eAFF,cACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,cACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,cACE,KAAA,EAAA,EAAA,KACA,MAAA,eA+BE,UAhDJ,KAAA,EAAA,EAAA,KACA,MAAA,KAqDQ,OAhEN,KAAA,EAAA,EAAA,KACA,MAAA,YA+DM,OAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,OAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,OAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,OAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,OAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,OAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,OAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,OAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,QAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,QAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,QAhEN,KAAA,EAAA,EAAA,KACA,MAAA,KAuEQ,UAxDV,YAAA,YAwDU,UAxDV,YAAA,aAwDU,UAxDV,YAAA,IAwDU,UAxDV,YAAA,aAwDU,UAxDV,YAAA,aAwDU,UAxDV,YAAA,IAwDU,UAxDV,YAAA,aAwDU,UAxDV,YAAA,aAwDU,UAxDV,YAAA,IAwDU,WAxDV,YAAA,aAwDU,WAxDV,YAAA,aAmEM,KXusBR,MWrsBU,cAAA,EAGF,KXusBR,MWrsBU,cAAA,EAPF,KXitBR,MW/sBU,cAAA,QAGF,KXitBR,MW/sBU,cAAA,QAPF,KX2tBR,MWztBU,cAAA,OAGF,KX2tBR,MWztBU,cAAA,OAPF,KXquBR,MWnuBU,cAAA,KAGF,KXquBR,MWnuBU,cAAA,KAPF,KX+uBR,MW7uBU,cAAA,OAGF,KX+uBR,MW7uBU,cAAA,OAPF,KXyvBR,MWvvBU,cAAA,KAGF,KXyvBR,MWvvBU,cAAA,KFzDN,yBESE,QACE,KAAA,EAAA,EAAA,GAGF,oBApCJ,KAAA,EAAA,EAAA,KACA,MAAA,KAcA,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,KAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,eAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,eA+BE,aAhDJ,KAAA,EAAA,EAAA,KACA,MAAA,KAqDQ,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,YA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,KAuEQ,aAxDV,YAAA,EAwDU,aAxDV,YAAA,YAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,IAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,IAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,IAwDU,cAxDV,YAAA,aAwDU,cAxDV,YAAA,aAmEM,QX45BR,SW15BU,cAAA,EAGF,QX45BR,SW15BU,cAAA,EAPF,QXs6BR,SWp6BU,cAAA,QAGF,QXs6BR,SWp6BU,cAAA,QAPF,QXg7BR,SW96BU,cAAA,OAGF,QXg7BR,SW96BU,cAAA,OAPF,QX07BR,SWx7BU,cAAA,KAGF,QX07BR,SWx7BU,cAAA,KAPF,QXo8BR,SWl8BU,cAAA,OAGF,QXo8BR,SWl8BU,cAAA,OAPF,QX88BR,SW58BU,cAAA,KAGF,QX88BR,SW58BU,cAAA,MFzDN,yBESE,QACE,KAAA,EAAA,EAAA,GAGF,oBApCJ,KAAA,EAAA,EAAA,KACA,MAAA,KAcA,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,KAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,eAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,eA+BE,aAhDJ,KAAA,EAAA,EAAA,KACA,MAAA,KAqDQ,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,YA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,KAuEQ,aAxDV,YAAA,EAwDU,aAxDV,YAAA,YAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,IAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,IAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,IAwDU,cAxDV,YAAA,aAwDU,cAxDV,YAAA,aAmEM,QXinCR,SW/mCU,cAAA,EAGF,QXinCR,SW/mCU,cAAA,EAPF,QX2nCR,SWznCU,cAAA,QAGF,QX2nCR,SWznCU,cAAA,QAPF,QXqoCR,SWnoCU,cAAA,OAGF,QXqoCR,SWnoCU,cAAA,OAPF,QX+oCR,SW7oCU,cAAA,KAGF,QX+oCR,SW7oCU,cAAA,KAPF,QXypCR,SWvpCU,cAAA,OAGF,QXypCR,SWvpCU,cAAA,OAPF,QXmqCR,SWjqCU,cAAA,KAGF,QXmqCR,SWjqCU,cAAA,MFzDN,yBESE,QACE,KAAA,EAAA,EAAA,GAGF,oBApCJ,KAAA,EAAA,EAAA,KACA,MAAA,KAcA,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,KAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,eAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,eA+BE,aAhDJ,KAAA,EAAA,EAAA,KACA,MAAA,KAqDQ,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,YA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,KAuEQ,aAxDV,YAAA,EAwDU,aAxDV,YAAA,YAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,IAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,IAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,IAwDU,cAxDV,YAAA,aAwDU,cAxDV,YAAA,aAmEM,QXs0CR,SWp0CU,cAAA,EAGF,QXs0CR,SWp0CU,cAAA,EAPF,QXg1CR,SW90CU,cAAA,QAGF,QXg1CR,SW90CU,cAAA,QAPF,QX01CR,SWx1CU,cAAA,OAGF,QX01CR,SWx1CU,cAAA,OAPF,QXo2CR,SWl2CU,cAAA,KAGF,QXo2CR,SWl2CU,cAAA,KAPF,QX82CR,SW52CU,cAAA,OAGF,QX82CR,SW52CU,cAAA,OAPF,QXw3CR,SWt3CU,cAAA,KAGF,QXw3CR,SWt3CU,cAAA,MFzDN,0BESE,QACE,KAAA,EAAA,EAAA,GAGF,oBApCJ,KAAA,EAAA,EAAA,KACA,MAAA,KAcA,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,KAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,eAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,iBACE,KAAA,EAAA,EAAA,KACA,MAAA,eA+BE,aAhDJ,KAAA,EAAA,EAAA,KACA,MAAA,KAqDQ,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,YA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,UAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,KAuEQ,aAxDV,YAAA,EAwDU,aAxDV,YAAA,YAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,IAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,IAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,aAwDU,aAxDV,YAAA,IAwDU,cAxDV,YAAA,aAwDU,cAxDV,YAAA,aAmEM,QX2hDR,SWzhDU,cAAA,EAGF,QX2hDR,SWzhDU,cAAA,EAPF,QXqiDR,SWniDU,cAAA,QAGF,QXqiDR,SWniDU,cAAA,QAPF,QX+iDR,SW7iDU,cAAA,OAGF,QX+iDR,SW7iDU,cAAA,OAPF,QXyjDR,SWvjDU,cAAA,KAGF,QXyjDR,SWvjDU,cAAA,KAPF,QXmkDR,SWjkDU,cAAA,OAGF,QXmkDR,SWjkDU,cAAA,OAPF,QX6kDR,SW3kDU,cAAA,KAGF,QX6kDR,SW3kDU,cAAA,MFzDN,0BESE,SACE,KAAA,EAAA,EAAA,GAGF,qBApCJ,KAAA,EAAA,EAAA,KACA,MAAA,KAcA,kBACE,KAAA,EAAA,EAAA,KACA,MAAA,KAFF,kBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,kBACE,KAAA,EAAA,EAAA,KACA,MAAA,eAFF,kBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,kBACE,KAAA,EAAA,EAAA,KACA,MAAA,IAFF,kBACE,KAAA,EAAA,EAAA,KACA,MAAA,eA+BE,cAhDJ,KAAA,EAAA,EAAA,KACA,MAAA,KAqDQ,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,YA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,WAhEN,KAAA,EAAA,EAAA,KACA,MAAA,IA+DM,YAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,YAhEN,KAAA,EAAA,EAAA,KACA,MAAA,aA+DM,YAhEN,KAAA,EAAA,EAAA,KACA,MAAA,KAuEQ,cAxDV,YAAA,EAwDU,cAxDV,YAAA,YAwDU,cAxDV,YAAA,aAwDU,cAxDV,YAAA,IAwDU,cAxDV,YAAA,aAwDU,cAxDV,YAAA,aAwDU,cAxDV,YAAA,IAwDU,cAxDV,YAAA,aAwDU,cAxDV,YAAA,aAwDU,cAxDV,YAAA,IAwDU,eAxDV,YAAA,aAwDU,eAxDV,YAAA,aAmEM,SXgvDR,UW9uDU,cAAA,EAGF,SXgvDR,UW9uDU,cAAA,EAPF,SX0vDR,UWxvDU,cAAA,QAGF,SX0vDR,UWxvDU,cAAA,QAPF,SXowDR,UWlwDU,cAAA,OAGF,SXowDR,UWlwDU,cAAA,OAPF,SX8wDR,UW5wDU,cAAA,KAGF,SX8wDR,UW5wDU,cAAA,KAPF,SXwxDR,UWtxDU,cAAA,OAGF,SXwxDR,UWtxDU,cAAA,OAPF,SXkyDR,UWhyDU,cAAA,KAGF,SXkyDR,UWhyDU,cAAA,MCpHV,OACE,cAAA,YACA,qBAAA,YACA,yBAAA,QACA,sBAAA,oBACA,wBAAA,QACA,qBAAA,mBACA,uBAAA,QACA,oBAAA,qBAEA,MAAA,KACA,cAAA,KACA,MAAA,QACA,eAAA,IACA,aAAA,QAOA,yBACE,QAAA,MAAA,MACA,iBAAA,mBACA,oBAAA,IACA,WAAA,MAAA,EAAA,EAAA,EAAA,OAAA,0BAGF,aACE,eAAA,QAGF,aACE,eAAA,OAIF,uCACE,oBAAA,aASJ,aACE,aAAA,IAUA,4BACE,QAAA,OAAA,OAeF,gCACE,aAAA,IAAA,EAGA,kCACE,aAAA,EAAA,IAOJ,oCACE,oBAAA,EASF,yCACE,qBAAA,2BACA,MAAA,8BAQJ,cACE,qBAAA,0BACA,MAAA,6BAQA,4BACE,qBAAA,yBACA,MAAA,4BCxHF,eAME,cAAA,QACA,sBAAA,QACA,yBAAA,KACA,qBAAA,QACA,wBAAA,KACA,oBAAA,QACA,uBAAA,KAEA,MAAA,KACA,aAAA,QAfF,iBAME,cAAA,QACA,sBAAA,QACA,yBAAA,KACA,qBAAA,QACA,wBAAA,KACA,oBAAA,QACA,uBAAA,KAEA,MAAA,KACA,aAAA,QAfF,eAME,cAAA,QACA,sBAAA,QACA,yBAAA,KACA,qBAAA,QACA,wBAAA,KACA,oBAAA,QACA,uBAAA,KAEA,MAAA,KACA,aAAA,QAfF,YAME,cAAA,QACA,sBAAA,QACA,yBAAA,KACA,qBAAA,QACA,wBAAA,KACA,oBAAA,QACA,uBAAA,KAEA,MAAA,KACA,aAAA,QAfF,eAME,cAAA,QACA,sBAAA,QACA,yBAAA,KACA,qBAAA,QACA,wBAAA,KACA,oBAAA,QACA,uBAAA,KAEA,MAAA,KACA,aAAA,QAfF,cAME,cAAA,QACA,sBAAA,QACA,yBAAA,KACA,qBAAA,QACA,wBAAA,KACA,oBAAA,QACA,uBAAA,KAEA,MAAA,KACA,aAAA,QAfF,aAME,cAAA,QACA,sBAAA,QACA,yBAAA,KACA,qBAAA,QACA,wBAAA,KACA,oBAAA,QACA,uBAAA,KAEA,MAAA,KACA,aAAA,QAfF,YAME,cAAA,QACA,sBAAA,QACA,yBAAA,KACA,qBAAA,QACA,wBAAA,KACA,oBAAA,QACA,uBAAA,KAEA,MAAA,KACA,aAAA,QDgIA,kBACE,WAAA,KACA,2BAAA,MHvEF,4BGqEA,qBACE,WAAA,KACA,2BAAA,OHvEF,4BGqEA,qBACE,WAAA,KACA,2BAAA,OHvEF,4BGqEA,qBACE,WAAA,KACA,2BAAA,OHvEF,6BGqEA,qBACE,WAAA,KACA,2BAAA,OHvEF,6BGqEA,sBACE,WAAA,KACA,2BAAA,OE/IN,YACE,cAAA,MASF,gBACE,YAAA,oBACA,eAAA,oBACA,cAAA,EboRI,UAAA,QahRJ,YAAA,IAIF,mBACE,YAAA,kBACA,eAAA,kBb0QI,UAAA,QatQN,mBACE,YAAA,mBACA,eAAA,mBboQI,UAAA,QcjSN,WACE,WAAA,OdgSI,UAAA,Oc5RJ,MAAA,QCLF,cACE,QAAA,MACA,MAAA,KACA,QAAA,QAAA,Of8RI,UAAA,Ke3RJ,YAAA,IACA,YAAA,IACA,MAAA,QACA,iBAAA,KACA,gBAAA,YACA,OAAA,IAAA,MAAA,QACA,mBAAA,KAAA,gBAAA,KAAA,WAAA,KdGE,cAAA,OeHE,WAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YAIA,uCDhBN,cCiBQ,WAAA,MDGN,yBACE,SAAA,OAEA,wDACE,OAAA,QAKJ,oBACE,MAAA,QACA,iBAAA,KACA,aAAA,QACA,QAAA,EAKE,WAAA,EAAA,EAAA,EAAA,OAAA,qBAOJ,2CAEE,OAAA,MAIF,gCACE,MAAA,QAEA,QAAA,EAHF,2BACE,MAAA,QAEA,QAAA,EAQF,uBAAA,wBAEE,iBAAA,QAGA,QAAA,EAIF,oCACE,QAAA,QAAA,OACA,OAAA,SAAA,QACA,mBAAA,OAAA,kBAAA,OACA,MAAA,QE3EF,iBAAA,QF6EE,eAAA,KACA,aAAA,QACA,aAAA,MACA,aAAA,EACA,wBAAA,IACA,cAAA,ECtEE,WAAA,MAAA,KAAA,WAAA,CAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YAIA,uCDuDJ,oCCtDM,WAAA,MDqEN,yEACE,iBAAA,QAGF,0CACE,QAAA,QAAA,OACA,OAAA,SAAA,QACA,mBAAA,OAAA,kBAAA,OACA,MAAA,QE9FF,iBAAA,QFgGE,eAAA,KACA,aAAA,QACA,aAAA,MACA,aAAA,EACA,wBAAA,IACA,cAAA,ECzFE,mBAAA,MAAA,KAAA,WAAA,CAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YAAA,WAAA,MAAA,KAAA,WAAA,CAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YAIA,uCD0EJ,0CCzEM,mBAAA,KAAA,WAAA,MDwFN,+EACE,iBAAA,QASJ,wBACE,QAAA,MACA,MAAA,KACA,QAAA,QAAA,EACA,cAAA,EACA,YAAA,IACA,MAAA,QACA,iBAAA,YACA,OAAA,MAAA,YACA,aAAA,IAAA,EAEA,wCAAA,wCAEE,cAAA,EACA,aAAA,EAWJ,iBACE,WAAA,0BACA,QAAA,OAAA,MfmJI,UAAA,QClRF,cAAA,McmIF,uCACE,QAAA,OAAA,MACA,OAAA,QAAA,OACA,mBAAA,MAAA,kBAAA,MAGF,6CACE,QAAA,OAAA,MACA,OAAA,QAAA,OACA,mBAAA,MAAA,kBAAA,MAIJ,iBACE,WAAA,yBACA,QAAA,MAAA,KfgII,UAAA,QClRF,cAAA,McsJF,uCACE,QAAA,MAAA,KACA,OAAA,OAAA,MACA,mBAAA,KAAA,kBAAA,KAGF,6CACE,QAAA,MAAA,KACA,OAAA,OAAA,MACA,mBAAA,KAAA,kBAAA,KAQF,sBACE,WAAA,2BAGF,yBACE,WAAA,0BAGF,yBACE,WAAA,yBAKJ,oBACE,MAAA,KACA,OAAA,KACA,QAAA,QAEA,mDACE,OAAA,QAGF,uCACE,OAAA,Md/LA,cAAA,OcmMF,0CACE,OAAA,MdpMA,cAAA,OiBdJ,aACE,QAAA,MACA,MAAA,KACA,QAAA,QAAA,QAAA,QAAA,OAEA,mBAAA,oBlB2RI,UAAA,KkBxRJ,YAAA,IACA,YAAA,IACA,MAAA,QACA,iBAAA,KACA,iBAAA,gOACA,kBAAA,UACA,oBAAA,MAAA,OAAA,OACA,gBAAA,KAAA,KACA,OAAA,IAAA,MAAA,QjBFE,cAAA,OeHE,WAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YESJ,mBAAA,KAAA,gBAAA,KAAA,WAAA,KFLI,uCEfN,aFgBQ,WAAA,MEMN,mBACE,aAAA,QACA,QAAA,EAKE,WAAA,EAAA,EAAA,EAAA,OAAA,qBAIJ,uBAAA,mCAEE,cAAA,OACA,iBAAA,KAGF,sBAEE,iBAAA,QAKF,4BACE,MAAA,YACA,YAAA,EAAA,EAAA,EAAA,QAIJ,gBACE,YAAA,OACA,eAAA,OACA,aAAA,MlByOI,UAAA,QkBrON,gBACE,YAAA,MACA,eAAA,MACA,aAAA,KlBkOI,UAAA,QmBjSN,YACE,QAAA,MACA,WAAA,OACA,aAAA,MACA,cAAA,QAEA,8BACE,MAAA,KACA,YAAA,OAIJ,kBACE,MAAA,IACA,OAAA,IACA,WAAA,MACA,eAAA,IACA,iBAAA,KACA,kBAAA,UACA,oBAAA,OACA,gBAAA,QACA,OAAA,IAAA,MAAA,gBACA,mBAAA,KAAA,gBAAA,KAAA,WAAA,KACA,2BAAA,MAAA,aAAA,MAGA,iClBXE,cAAA,MkBeF,8BAEE,cAAA,IAGF,yBACE,OAAA,gBAGF,wBACE,aAAA,QACA,QAAA,EACA,WAAA,EAAA,EAAA,EAAA,OAAA,qBAGF,0BACE,iBAAA,QACA,aAAA,QAEA,yCAII,iBAAA,8NAIJ,sCAII,iBAAA,sIAKN,+CACE,iBAAA,QACA,aAAA,QAKE,iBAAA,wNAIJ,2BACE,eAAA,KACA,OAAA,KACA,QAAA,GAOA,6CAAA,8CACE,QAAA,GAcN,aACE,aAAA,MAEA,+BACE,MAAA,IACA,YAAA,OACA,iBAAA,uJACA,oBAAA,KAAA,OlB9FA,cAAA,IeHE,WAAA,oBAAA,KAAA,YAIA,uCGyFJ,+BHxFM,WAAA,MGgGJ,qCACE,iBAAA,yIAGF,uCACE,oBAAA,MAAA,OAKE,iBAAA,sIAMR,mBACE,QAAA,aACA,aAAA,KAGF,WACE,SAAA,SACA,KAAA,cACA,eAAA,KAIE,yBAAA,0BACE,eAAA,KACA,OAAA,KACA,QAAA,IC9IN,YACE,MAAA,KACA,OAAA,OACA,QAAA,EACA,iBAAA,YACA,mBAAA,KAAA,gBAAA,KAAA,WAAA,KAEA,kBACE,QAAA,EAIA,wCAA0B,WAAA,EAAA,EAAA,EAAA,IAAA,IAAA,CAAA,EAAA,EAAA,EAAA,OAAA,qBAC1B,oCAA0B,WAAA,EAAA,EAAA,EAAA,IAAA,IAAA,CAAA,EAAA,EAAA,EAAA,OAAA,qBAG5B,8BACE,OAAA,EAGF,kCACE,MAAA,KACA,OAAA,KACA,WAAA,QHzBF,iBAAA,QG2BE,OAAA,EnBZA,cAAA,KeHE,mBAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YAAA,WAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YImBF,mBAAA,KAAA,WAAA,KJfE,uCIMJ,kCJLM,mBAAA,KAAA,WAAA,MIgBJ,yCHjCF,iBAAA,QGsCA,2CACE,MAAA,KACA,OAAA,MACA,MAAA,YACA,OAAA,QACA,iBAAA,QACA,aAAA,YnB7BA,cAAA,KmBkCF,8BACE,MAAA,KACA,OAAA,KHnDF,iBAAA,QGqDE,OAAA,EnBtCA,cAAA,KeHE,gBAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YAAA,WAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YI6CF,gBAAA,KAAA,WAAA,KJzCE,uCIiCJ,8BJhCM,gBAAA,KAAA,WAAA,MI0CJ,qCH3DF,iBAAA,QGgEA,8BACE,MAAA,KACA,OAAA,MACA,MAAA,YACA,OAAA,QACA,iBAAA,QACA,aAAA,YnBvDA,cAAA,KmB4DF,qBACE,eAAA,KAEA,2CACE,iBAAA,QAGF,uCACE,iBAAA,QCvFN,eACE,SAAA,SAEA,6BtB+iFF,4BsB7iFI,OAAA,mBACA,YAAA,KAGF,qBACE,SAAA,SACA,IAAA,EACA,KAAA,EACA,OAAA,KACA,QAAA,KAAA,OACA,eAAA,KACA,OAAA,IAAA,MAAA,YACA,iBAAA,EAAA,ELDE,WAAA,QAAA,IAAA,WAAA,CAAA,UAAA,IAAA,YAIA,uCKXJ,qBLYM,WAAA,MKCN,6BACE,QAAA,KAAA,OAEA,+CACE,MAAA,YADF,0CACE,MAAA,YAGF,0DAEE,YAAA,SACA,eAAA,QAHF,mCAAA,qDAEE,YAAA,SACA,eAAA,QAGF,8CACE,YAAA,SACA,eAAA,QAIJ,4BACE,YAAA,SACA,eAAA,QAMA,gEACE,QAAA,IACA,UAAA,WAAA,mBAAA,mBAFF,yCtBmjFJ,2DACA,kCsBnjFM,QAAA,IACA,UAAA,WAAA,mBAAA,mBAKF,oDACE,QAAA,IACA,UAAA,WAAA,mBAAA,mBCtDN,aACE,SAAA,SACA,QAAA,KACA,UAAA,KACA,YAAA,QACA,MAAA,KAEA,2BvB2mFF,0BuBzmFI,SAAA,SACA,KAAA,EAAA,EAAA,KACA,MAAA,GACA,UAAA,EAIF,iCvBymFF,gCuBvmFI,QAAA,EAMF,kBACE,SAAA,SACA,QAAA,EAEA,wBACE,QAAA,EAWN,kBACE,QAAA,KACA,YAAA,OACA,QAAA,QAAA,OtBsPI,UAAA,KsBpPJ,YAAA,IACA,YAAA,IACA,MAAA,QACA,WAAA,OACA,YAAA,OACA,iBAAA,QACA,OAAA,IAAA,MAAA,QrBpCE,cAAA,OFuoFJ,qBuBzlFA,8BvBulFA,6BACA,kCuBplFE,QAAA,MAAA,KtBgOI,UAAA,QClRF,cAAA,MFgpFJ,qBuBzlFA,8BvBulFA,6BACA,kCuBplFE,QAAA,OAAA,MtBuNI,UAAA,QClRF,cAAA,MqBgEJ,6BvBulFA,6BuBrlFE,cAAA,KvB0lFF,uEuB7kFI,8FrB/DA,wBAAA,EACA,2BAAA,EFgpFJ,iEuB3kFI,2FrBtEA,wBAAA,EACA,2BAAA,EqBgFF,0IACE,YAAA,KrBpEA,uBAAA,EACA,0BAAA,EsBzBF,gBACE,QAAA,KACA,MAAA,KACA,WAAA,OvByQE,UAAA,OuBtQF,MAAA,QAGF,eACE,SAAA,SACA,IAAA,KACA,QAAA,EACA,QAAA,KACA,UAAA,KACA,QAAA,OAAA,MACA,WAAA,MvB4PE,UAAA,QuBzPF,MAAA,KACA,iBAAA,mBtB1BA,cAAA,OFmsFJ,0BACA,yBwBrqFI,sCxBmqFJ,qCwBjqFM,QAAA,MA9CF,uBAAA,mCAoDE,aAAA,QAGE,cAAA,qBACA,iBAAA,2OACA,kBAAA,UACA,oBAAA,MAAA,wBAAA,OACA,gBAAA,sBAAA,sBAGF,6BAAA,yCACE,aAAA,QACA,WAAA,EAAA,EAAA,EAAA,OAAA,oBAhEJ,2CAAA,+BAyEI,cAAA,qBACA,oBAAA,IAAA,wBAAA,MAAA,wBA1EJ,sBAAA,kCAiFE,aAAA,QAGE,kDAAA,gDAAA,8DAAA,4DAEE,cAAA,SACA,iBAAA,+NAAA,CAAA,2OACA,oBAAA,MAAA,OAAA,MAAA,CAAA,OAAA,MAAA,QACA,gBAAA,KAAA,IAAA,CAAA,sBAAA,sBAIJ,4BAAA,wCACE,aAAA,QACA,WAAA,EAAA,EAAA,EAAA,OAAA,oBA/FJ,2BAAA,uCAsGE,aAAA,QAEA,mCAAA,+CACE,iBAAA,QAGF,iCAAA,6CACE,WAAA,EAAA,EAAA,EAAA,OAAA,oBAGF,6CAAA,yDACE,MAAA,QAKJ,qDACE,YAAA,KAvHF,oCxBwwFJ,mCwBxwFI,gDxBuwFJ,+CwBxoFQ,QAAA,EAIF,0CxB0oFN,yCwB1oFM,sDxByoFN,qDwBxoFQ,QAAA,EAjHN,kBACE,QAAA,KACA,MAAA,KACA,WAAA,OvByQE,UAAA,OuBtQF,MAAA,QAGF,iBACE,SAAA,SACA,IAAA,KACA,QAAA,EACA,QAAA,KACA,UAAA,KACA,QAAA,OAAA,MACA,WAAA,MvB4PE,UAAA,QuBzPF,MAAA,KACA,iBAAA,mBtB1BA,cAAA,OF4xFJ,8BACA,6BwB9vFI,0CxB4vFJ,yCwB1vFM,QAAA,MA9CF,yBAAA,qCAoDE,aAAA,QAGE,cAAA,qBACA,iBAAA,2TACA,kBAAA,UACA,oBAAA,MAAA,wBAAA,OACA,gBAAA,sBAAA,sBAGF,+BAAA,2CACE,aAAA,QACA,WAAA,EAAA,EAAA,EAAA,OAAA,oBAhEJ,6CAAA,iCAyEI,cAAA,qBACA,oBAAA,IAAA,wBAAA,MAAA,wBA1EJ,wBAAA,oCAiFE,aAAA,QAGE,oDAAA,kDAAA,gEAAA,8DAEE,cAAA,SACA,iBAAA,+NAAA,CAAA,2TACA,oBAAA,MAAA,OAAA,MAAA,CAAA,OAAA,MAAA,QACA,gBAAA,KAAA,IAAA,CAAA,sBAAA,sBAIJ,8BAAA,0CACE,aAAA,QACA,WAAA,EAAA,EAAA,EAAA,OAAA,oBA/FJ,6BAAA,yCAsGE,aAAA,QAEA,qCAAA,iDACE,iBAAA,QAGF,mCAAA,+CACE,WAAA,EAAA,EAAA,EAAA,OAAA,oBAGF,+CAAA,2DACE,MAAA,QAKJ,uDACE,YAAA,KAvHF,sCxBi2FJ,qCwBj2FI,kDxBg2FJ,iDwB/tFQ,QAAA,EAEF,4CxBmuFN,2CwBnuFM,wDxBkuFN,uDwBjuFQ,QAAA,ECtIR,KACE,QAAA,aAEA,YAAA,IACA,YAAA,IACA,MAAA,QACA,WAAA,OACA,gBAAA,KAEA,eAAA,OACA,OAAA,QACA,oBAAA,KAAA,iBAAA,KAAA,YAAA,KACA,iBAAA,YACA,OAAA,IAAA,MAAA,YC8GA,QAAA,QAAA,OzBsKI,UAAA,KClRF,cAAA,OeHE,WAAA,MAAA,KAAA,WAAA,CAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YAIA,uCQhBN,KRiBQ,WAAA,MQAN,WACE,MAAA,QAIF,sBAAA,WAEE,QAAA,EACA,WAAA,EAAA,EAAA,EAAA,OAAA,qBAcF,cAAA,cAAA,uBAGE,eAAA,KACA,QAAA,IAYF,aCvCA,MAAA,KRhBA,iBAAA,QQkBA,aAAA,QAGA,mBACE,MAAA,KRtBF,iBAAA,QQwBE,aAAA,QAGF,8BAAA,mBAEE,MAAA,KR7BF,iBAAA,QQ+BE,aAAA,QAKE,WAAA,EAAA,EAAA,EAAA,OAAA,oBAIJ,+BAAA,gCAAA,oBAAA,oBAAA,mCAKE,MAAA,KACA,iBAAA,QAGA,aAAA,QAEA,qCAAA,sCAAA,0BAAA,0BAAA,yCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,oBAKN,sBAAA,sBAEE,MAAA,KACA,iBAAA,QAGA,aAAA,QDZF,eCvCA,MAAA,KRhBA,iBAAA,QQkBA,aAAA,QAGA,qBACE,MAAA,KRtBF,iBAAA,QQwBE,aAAA,QAGF,gCAAA,qBAEE,MAAA,KR7BF,iBAAA,QQ+BE,aAAA,QAKE,WAAA,EAAA,EAAA,EAAA,OAAA,qBAIJ,iCAAA,kCAAA,sBAAA,sBAAA,qCAKE,MAAA,KACA,iBAAA,QAGA,aAAA,QAEA,uCAAA,wCAAA,4BAAA,4BAAA,2CAKI,WAAA,EAAA,EAAA,EAAA,OAAA,qBAKN,wBAAA,wBAEE,MAAA,KACA,iBAAA,QAGA,aAAA,QDZF,aCvCA,MAAA,KRhBA,iBAAA,QQkBA,aAAA,QAGA,mBACE,MAAA,KRtBF,iBAAA,QQwBE,aAAA,QAGF,8BAAA,mBAEE,MAAA,KR7BF,iBAAA,QQ+BE,aAAA,QAKE,WAAA,EAAA,EAAA,EAAA,OAAA,oBAIJ,+BAAA,gCAAA,oBAAA,oBAAA,mCAKE,MAAA,KACA,iBAAA,QAGA,aAAA,QAEA,qCAAA,sCAAA,0BAAA,0BAAA,yCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,oBAKN,sBAAA,sBAEE,MAAA,KACA,iBAAA,QAGA,aAAA,QDZF,UCvCA,MAAA,KRhBA,iBAAA,QQkBA,aAAA,QAGA,gBACE,MAAA,KRtBF,iBAAA,QQwBE,aAAA,QAGF,2BAAA,gBAEE,MAAA,KR7BF,iBAAA,QQ+BE,aAAA,QAKE,WAAA,EAAA,EAAA,EAAA,OAAA,oBAIJ,4BAAA,6BAAA,iBAAA,iBAAA,gCAKE,MAAA,KACA,iBAAA,QAGA,aAAA,QAEA,kCAAA,mCAAA,uBAAA,uBAAA,sCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,oBAKN,mBAAA,mBAEE,MAAA,KACA,iBAAA,QAGA,aAAA,QDZF,aCvCA,MAAA,KRhBA,iBAAA,QQkBA,aAAA,QAGA,mBACE,MAAA,KRtBF,iBAAA,QQwBE,aAAA,QAGF,8BAAA,mBAEE,MAAA,KR7BF,iBAAA,QQ+BE,aAAA,QAKE,WAAA,EAAA,EAAA,EAAA,OAAA,mBAIJ,+BAAA,gCAAA,oBAAA,oBAAA,mCAKE,MAAA,KACA,iBAAA,QAGA,aAAA,QAEA,qCAAA,sCAAA,0BAAA,0BAAA,yCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,mBAKN,sBAAA,sBAEE,MAAA,KACA,iBAAA,QAGA,aAAA,QDZF,YCvCA,MAAA,KRhBA,iBAAA,QQkBA,aAAA,QAGA,kBACE,MAAA,KRtBF,iBAAA,QQwBE,aAAA,QAGF,6BAAA,kBAEE,MAAA,KR7BF,iBAAA,QQ+BE,aAAA,QAKE,WAAA,EAAA,EAAA,EAAA,OAAA,mBAIJ,8BAAA,+BAAA,mBAAA,mBAAA,kCAKE,MAAA,KACA,iBAAA,QAGA,aAAA,QAEA,oCAAA,qCAAA,yBAAA,yBAAA,wCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,mBAKN,qBAAA,qBAEE,MAAA,KACA,iBAAA,QAGA,aAAA,QDZF,WCvCA,MAAA,KRhBA,iBAAA,QQkBA,aAAA,QAGA,iBACE,MAAA,KRtBF,iBAAA,QQwBE,aAAA,QAGF,4BAAA,iBAEE,MAAA,KR7BF,iBAAA,QQ+BE,aAAA,QAKE,WAAA,EAAA,EAAA,EAAA,OAAA,qBAIJ,6BAAA,8BAAA,kBAAA,kBAAA,iCAKE,MAAA,KACA,iBAAA,QAGA,aAAA,QAEA,mCAAA,oCAAA,wBAAA,wBAAA,uCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,qBAKN,oBAAA,oBAEE,MAAA,KACA,iBAAA,QAGA,aAAA,QDZF,UCvCA,MAAA,KRhBA,iBAAA,QQkBA,aAAA,QAGA,gBACE,MAAA,KRtBF,iBAAA,QQwBE,aAAA,QAGF,2BAAA,gBAEE,MAAA,KR7BF,iBAAA,QQ+BE,aAAA,QAKE,WAAA,EAAA,EAAA,EAAA,OAAA,kBAIJ,4BAAA,6BAAA,iBAAA,iBAAA,gCAKE,MAAA,KACA,iBAAA,QAGA,aAAA,QAEA,kCAAA,mCAAA,uBAAA,uBAAA,sCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,kBAKN,mBAAA,mBAEE,MAAA,KACA,iBAAA,QAGA,aAAA,QDNF,qBCmBA,MAAA,QACA,aAAA,QAEA,2BACE,MAAA,KACA,iBAAA,QACA,aAAA,QAGF,sCAAA,2BAEE,WAAA,EAAA,EAAA,EAAA,OAAA,oBAGF,uCAAA,wCAAA,4BAAA,0CAAA,4BAKE,MAAA,KACA,iBAAA,QACA,aAAA,QAEA,6CAAA,8CAAA,kCAAA,gDAAA,kCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,oBAKN,8BAAA,8BAEE,MAAA,QACA,iBAAA,YDvDF,uBCmBA,MAAA,QACA,aAAA,QAEA,6BACE,MAAA,KACA,iBAAA,QACA,aAAA,QAGF,wCAAA,6BAEE,WAAA,EAAA,EAAA,EAAA,OAAA,qBAGF,yCAAA,0CAAA,8BAAA,4CAAA,8BAKE,MAAA,KACA,iBAAA,QACA,aAAA,QAEA,+CAAA,gDAAA,oCAAA,kDAAA,oCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,qBAKN,gCAAA,gCAEE,MAAA,QACA,iBAAA,YDvDF,qBCmBA,MAAA,QACA,aAAA,QAEA,2BACE,MAAA,KACA,iBAAA,QACA,aAAA,QAGF,sCAAA,2BAEE,WAAA,EAAA,EAAA,EAAA,OAAA,mBAGF,uCAAA,wCAAA,4BAAA,0CAAA,4BAKE,MAAA,KACA,iBAAA,QACA,aAAA,QAEA,6CAAA,8CAAA,kCAAA,gDAAA,kCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,mBAKN,8BAAA,8BAEE,MAAA,QACA,iBAAA,YDvDF,kBCmBA,MAAA,QACA,aAAA,QAEA,wBACE,MAAA,KACA,iBAAA,QACA,aAAA,QAGF,mCAAA,wBAEE,WAAA,EAAA,EAAA,EAAA,OAAA,oBAGF,oCAAA,qCAAA,yBAAA,uCAAA,yBAKE,MAAA,KACA,iBAAA,QACA,aAAA,QAEA,0CAAA,2CAAA,+BAAA,6CAAA,+BAKI,WAAA,EAAA,EAAA,EAAA,OAAA,oBAKN,2BAAA,2BAEE,MAAA,QACA,iBAAA,YDvDF,qBCmBA,MAAA,QACA,aAAA,QAEA,2BACE,MAAA,KACA,iBAAA,QACA,aAAA,QAGF,sCAAA,2BAEE,WAAA,EAAA,EAAA,EAAA,OAAA,mBAGF,uCAAA,wCAAA,4BAAA,0CAAA,4BAKE,MAAA,KACA,iBAAA,QACA,aAAA,QAEA,6CAAA,8CAAA,kCAAA,gDAAA,kCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,mBAKN,8BAAA,8BAEE,MAAA,QACA,iBAAA,YDvDF,oBCmBA,MAAA,QACA,aAAA,QAEA,0BACE,MAAA,KACA,iBAAA,QACA,aAAA,QAGF,qCAAA,0BAEE,WAAA,EAAA,EAAA,EAAA,OAAA,mBAGF,sCAAA,uCAAA,2BAAA,yCAAA,2BAKE,MAAA,KACA,iBAAA,QACA,aAAA,QAEA,4CAAA,6CAAA,iCAAA,+CAAA,iCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,mBAKN,6BAAA,6BAEE,MAAA,QACA,iBAAA,YDvDF,mBCmBA,MAAA,QACA,aAAA,QAEA,yBACE,MAAA,KACA,iBAAA,QACA,aAAA,QAGF,oCAAA,yBAEE,WAAA,EAAA,EAAA,EAAA,OAAA,qBAGF,qCAAA,sCAAA,0BAAA,wCAAA,0BAKE,MAAA,KACA,iBAAA,QACA,aAAA,QAEA,2CAAA,4CAAA,gCAAA,8CAAA,gCAKI,WAAA,EAAA,EAAA,EAAA,OAAA,qBAKN,4BAAA,4BAEE,MAAA,QACA,iBAAA,YDvDF,kBCmBA,MAAA,QACA,aAAA,QAEA,wBACE,MAAA,KACA,iBAAA,QACA,aAAA,QAGF,mCAAA,wBAEE,WAAA,EAAA,EAAA,EAAA,OAAA,kBAGF,oCAAA,qCAAA,yBAAA,uCAAA,yBAKE,MAAA,KACA,iBAAA,QACA,aAAA,QAEA,0CAAA,2CAAA,+BAAA,6CAAA,+BAKI,WAAA,EAAA,EAAA,EAAA,OAAA,kBAKN,2BAAA,2BAEE,MAAA,QACA,iBAAA,YD3CJ,UACE,YAAA,IACA,MAAA,QACA,gBAAA,UAEA,gBACE,MAAA,QAQF,mBAAA,mBAEE,MAAA,QAWJ,mBAAA,QCuBE,QAAA,MAAA,KzBsKI,UAAA,QClRF,cAAA,MuByFJ,mBAAA,QCmBE,QAAA,OAAA,MzBsKI,UAAA,QClRF,cAAA,MyBnBJ,MVgBM,WAAA,QAAA,KAAA,OAIA,uCUpBN,MVqBQ,WAAA,MUlBN,iBACE,QAAA,EAMF,qBACE,QAAA,KAIJ,YACE,OAAA,EACA,SAAA,OVDI,WAAA,OAAA,KAAA,KAIA,uCULN,YVMQ,WAAA,MUDN,gCACE,MAAA,EACA,OAAA,KVNE,WAAA,MAAA,KAAA,KAIA,uCUAJ,gCVCM,WAAA,MjBs3GR,UADA,SAEA,W4B34GA,QAIE,SAAA,SAGF,iBACE,YAAA,OCqBE,wBACE,QAAA,aACA,YAAA,OACA,eAAA,OACA,QAAA,GAhCJ,WAAA,KAAA,MACA,aAAA,KAAA,MAAA,YACA,cAAA,EACA,YAAA,KAAA,MAAA,YAqDE,8BACE,YAAA,ED3CN,eACE,SAAA,SACA,QAAA,KACA,QAAA,KACA,UAAA,MACA,QAAA,MAAA,EACA,OAAA,E3B+QI,UAAA,K2B7QJ,MAAA,QACA,WAAA,KACA,WAAA,KACA,iBAAA,KACA,gBAAA,YACA,OAAA,IAAA,MAAA,gB1BVE,cAAA,O0BcF,+BACE,IAAA,KACA,KAAA,EACA,WAAA,QAYA,qBACE,cAAA,MAEA,qCACE,MAAA,KACA,KAAA,EAIJ,mBACE,cAAA,IAEA,mCACE,MAAA,EACA,KAAA,KnBCJ,yBmBfA,wBACE,cAAA,MAEA,wCACE,MAAA,KACA,KAAA,EAIJ,sBACE,cAAA,IAEA,sCACE,MAAA,EACA,KAAA,MnBCJ,yBmBfA,wBACE,cAAA,MAEA,wCACE,MAAA,KACA,KAAA,EAIJ,sBACE,cAAA,IAEA,sCACE,MAAA,EACA,KAAA,MnBCJ,yBmBfA,wBACE,cAAA,MAEA,wCACE,MAAA,KACA,KAAA,EAIJ,sBACE,cAAA,IAEA,sCACE,MAAA,EACA,KAAA,MnBCJ,0BmBfA,wBACE,cAAA,MAEA,wCACE,MAAA,KACA,KAAA,EAIJ,sBACE,cAAA,IAEA,sCACE,MAAA,EACA,KAAA,MnBCJ,0BmBfA,yBACE,cAAA,MAEA,yCACE,MAAA,KACA,KAAA,EAIJ,uBACE,cAAA,IAEA,uCACE,MAAA,EACA,KAAA,MAUN,uCACE,IAAA,KACA,OAAA,KACA,WAAA,EACA,cAAA,QC9CA,gCACE,QAAA,aACA,YAAA,OACA,eAAA,OACA,QAAA,GAzBJ,WAAA,EACA,aAAA,KAAA,MAAA,YACA,cAAA,KAAA,MACA,YAAA,KAAA,MAAA,YA8CE,sCACE,YAAA,ED0BJ,wCACE,IAAA,EACA,MAAA,KACA,KAAA,KACA,WAAA,EACA,YAAA,QC5DA,iCACE,QAAA,aACA,YAAA,OACA,eAAA,OACA,QAAA,GAlBJ,WAAA,KAAA,MAAA,YACA,aAAA,EACA,cAAA,KAAA,MAAA,YACA,YAAA,KAAA,MAuCE,uCACE,YAAA,EDoCF,iCACE,eAAA,EAMJ,0CACE,IAAA,EACA,MAAA,KACA,KAAA,KACA,WAAA,EACA,aAAA,QC7EA,mCACE,QAAA,aACA,YAAA,OACA,eAAA,OACA,QAAA,GAWA,mCACE,QAAA,KAGF,oCACE,QAAA,aACA,aAAA,OACA,eAAA,OACA,QAAA,GA9BN,WAAA,KAAA,MAAA,YACA,aAAA,KAAA,MACA,cAAA,KAAA,MAAA,YAiCE,yCACE,YAAA,EDqDF,oCACE,eAAA,EAON,kBACE,OAAA,EACA,OAAA,MAAA,EACA,SAAA,OACA,WAAA,IAAA,MAAA,gBAMF,eACE,QAAA,MACA,MAAA,KACA,QAAA,OAAA,KACA,MAAA,KACA,YAAA,IACA,MAAA,QACA,WAAA,QACA,gBAAA,KACA,YAAA,OACA,iBAAA,YACA,OAAA,EAcA,qBAAA,qBAEE,MAAA,QVzJF,iBAAA,QU8JA,sBAAA,sBAEE,MAAA,KACA,gBAAA,KVjKF,iBAAA,QUqKA,wBAAA,wBAEE,MAAA,QACA,eAAA,KACA,iBAAA,YAMJ,oBACE,QAAA,MAIF,iBACE,QAAA,MACA,QAAA,MAAA,KACA,cAAA,E3B0GI,UAAA,Q2BxGJ,MAAA,QACA,YAAA,OAIF,oBACE,QAAA,MACA,QAAA,OAAA,KACA,MAAA,QAIF,oBACE,MAAA,QACA,iBAAA,QACA,aAAA,gBAGA,mCACE,MAAA,QAEA,yCAAA,yCAEE,MAAA,KVhNJ,iBAAA,sBUoNE,0CAAA,0CAEE,MAAA,KVtNJ,iBAAA,QU0NE,4CAAA,4CAEE,MAAA,QAIJ,sCACE,aAAA,gBAGF,wCACE,MAAA,QAGF,qCACE,MAAA,QE5OJ,W9B2rHA,oB8BzrHE,SAAA,SACA,QAAA,YACA,eAAA,O9B6rHF,yB8B3rHE,gBACE,SAAA,SACA,KAAA,EAAA,EAAA,K9BmsHJ,4CACA,0CAIA,gCADA,gCADA,+BADA,+B8BhsHE,mC9ByrHF,iCAIA,uBADA,uBADA,sBADA,sB8BprHI,QAAA,EAKJ,aACE,QAAA,KACA,UAAA,KACA,gBAAA,WAEA,0BACE,MAAA,K9BgsHJ,wC8B1rHE,kCAEE,YAAA,K9B4rHJ,4C8BxrHE,uD5BRE,wBAAA,EACA,2BAAA,EFqsHJ,6C8BrrHE,+B9BorHF,iCEvrHI,uBAAA,EACA,0BAAA,E4BqBJ,uBACE,cAAA,SACA,aAAA,SAEA,8BAAA,uCAAA,sCAGE,YAAA,EAGF,0CACE,aAAA,EAIJ,0CAAA,+BACE,cAAA,QACA,aAAA,QAGF,0CAAA,+BACE,cAAA,OACA,aAAA,OAoBF,oBACE,eAAA,OACA,YAAA,WACA,gBAAA,OAEA,yB9BmpHF,+B8BjpHI,MAAA,K9BqpHJ,iD8BlpHE,2CAEE,WAAA,K9BopHJ,qD8BhpHE,gE5BvFE,2BAAA,EACA,0BAAA,EF2uHJ,sD8BhpHE,8B5B1GE,uBAAA,EACA,wBAAA,E6BxBJ,KACE,QAAA,KACA,UAAA,KACA,aAAA,EACA,cAAA,EACA,WAAA,KAGF,UACE,QAAA,MACA,QAAA,MAAA,KAGA,MAAA,QACA,gBAAA,KdHI,WAAA,MAAA,KAAA,WAAA,CAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,YAIA,uCcPN,UdQQ,WAAA,McCN,gBAAA,gBAEE,MAAA,QAKF,mBACE,MAAA,QACA,eAAA,KACA,OAAA,QAQJ,UACE,cAAA,IAAA,MAAA,QAEA,oBACE,cAAA,KACA,WAAA,IACA,OAAA,IAAA,MAAA,Y7BlBA,uBAAA,OACA,wBAAA,O6BoBA,0BAAA,0BAEE,aAAA,QAAA,QAAA,QAEA,UAAA,QAGF,6BACE,MAAA,QACA,iBAAA,YACA,aAAA,Y/BixHN,mC+B7wHE,2BAEE,MAAA,QACA,iBAAA,KACA,aAAA,QAAA,QAAA,KAGF,yBAEE,WAAA,K7B5CA,uBAAA,EACA,wBAAA,E6BuDF,qBACE,WAAA,IACA,OAAA,E7BnEA,cAAA,O6BuEF,4B/BmwHF,2B+BjwHI,MAAA,KbxFF,iBAAA,QlB+1HF,oB+B5vHE,oBAEE,KAAA,EAAA,EAAA,KACA,WAAA,O/B+vHJ,yB+B1vHE,yBAEE,WAAA,EACA,UAAA,EACA,WAAA,OAMF,8B/BuvHF,mC+BtvHI,MAAA,KAUF,uBACE,QAAA,KAEF,qBACE,QAAA,MCxHJ,QACE,SAAA,SACA,QAAA,KACA,UAAA,KACA,YAAA,OACA,gBAAA,cACA,YAAA,MAEA,eAAA,MAOA,mBhCs2HF,yBAGA,sBADA,sBADA,sBAGA,sBACA,uBgC12HI,QAAA,KACA,UAAA,QACA,YAAA,OACA,gBAAA,cAoBJ,cACE,YAAA,SACA,eAAA,SACA,aAAA,K/B2OI,UAAA,Q+BzOJ,gBAAA,KACA,YAAA,OAaF,YACE,QAAA,KACA,eAAA,OACA,aAAA,EACA,cAAA,EACA,WAAA,KAEA,sBACE,cAAA,EACA,aAAA,EAGF,2BACE,SAAA,OASJ,aACE,YAAA,MACA,eAAA,MAYF,iBACE,WAAA,KACA,UAAA,EAGA,YAAA,OAIF,gBACE,QAAA,OAAA,O/B6KI,UAAA,Q+B3KJ,YAAA,EACA,iBAAA,YACA,OAAA,IAAA,MAAA,Y9BzGE,cAAA,OeHE,WAAA,WAAA,KAAA,YAIA,uCemGN,gBflGQ,WAAA,Me2GN,sBACE,gBAAA,KAGF,sBACE,gBAAA,KACA,QAAA,EACA,WAAA,EAAA,EAAA,EAAA,OAMJ,qBACE,QAAA,aACA,MAAA,MACA,OAAA,MACA,eAAA,OACA,kBAAA,UACA,oBAAA,OACA,gBAAA,KAGF,mBACE,WAAA,6BACA,WAAA,KvB1FE,yBuBsGA,kBAEI,UAAA,OACA,gBAAA,WAEA,8BACE,eAAA,IAEA,6CACE,SAAA,SAGF,wCACE,cAAA,MACA,aAAA,MAIJ,qCACE,SAAA,QAGF,mCACE,QAAA,eACA,WAAA,KAGF,kCACE,QAAA,KAGF,oCACE,QAAA,KAGF,6BACE,SAAA,QACA,OAAA,EACA,QAAA,KACA,UAAA,EACA,WAAA,kBACA,iBAAA,YACA,aAAA,EACA,YAAA,EfhMJ,WAAA,KekMI,UAAA,KhC+yHV,oCgC7yHQ,iCAEE,OAAA,KACA,WAAA,EACA,cAAA,EAGF,kCACE,QAAA,KACA,UAAA,EACA,QAAA,EACA,WAAA,SvBhKN,yBuBsGA,kBAEI,UAAA,OACA,gBAAA,WAEA,8BACE,eAAA,IAEA,6CACE,SAAA,SAGF,wCACE,cAAA,MACA,aAAA,MAIJ,qCACE,SAAA,QAGF,mCACE,QAAA,eACA,WAAA,KAGF,kCACE,QAAA,KAGF,oCACE,QAAA,KAGF,6BACE,SAAA,QACA,OAAA,EACA,QAAA,KACA,UAAA,EACA,WAAA,kBACA,iBAAA,YACA,aAAA,EACA,YAAA,EfhMJ,WAAA,KekMI,UAAA,KhCo2HV,oCgCl2HQ,iCAEE,OAAA,KACA,WAAA,EACA,cAAA,EAGF,kCACE,QAAA,KACA,UAAA,EACA,QAAA,EACA,WAAA,SvBhKN,yBuBsGA,kBAEI,UAAA,OACA,gBAAA,WAEA,8BACE,eAAA,IAEA,6CACE,SAAA,SAGF,wCACE,cAAA,MACA,aAAA,MAIJ,qCACE,SAAA,QAGF,mCACE,QAAA,eACA,WAAA,KAGF,kCACE,QAAA,KAGF,oCACE,QAAA,KAGF,6BACE,SAAA,QACA,OAAA,EACA,QAAA,KACA,UAAA,EACA,WAAA,kBACA,iBAAA,YACA,aAAA,EACA,YAAA,EfhMJ,WAAA,KekMI,UAAA,KhCy5HV,oCgCv5HQ,iCAEE,OAAA,KACA,WAAA,EACA,cAAA,EAGF,kCACE,QAAA,KACA,UAAA,EACA,QAAA,EACA,WAAA,SvBhKN,0BuBsGA,kBAEI,UAAA,OACA,gBAAA,WAEA,8BACE,eAAA,IAEA,6CACE,SAAA,SAGF,wCACE,cAAA,MACA,aAAA,MAIJ,qCACE,SAAA,QAGF,mCACE,QAAA,eACA,WAAA,KAGF,kCACE,QAAA,KAGF,oCACE,QAAA,KAGF,6BACE,SAAA,QACA,OAAA,EACA,QAAA,KACA,UAAA,EACA,WAAA,kBACA,iBAAA,YACA,aAAA,EACA,YAAA,EfhMJ,WAAA,KekMI,UAAA,KhC88HV,oCgC58HQ,iCAEE,OAAA,KACA,WAAA,EACA,cAAA,EAGF,kCACE,QAAA,KACA,UAAA,EACA,QAAA,EACA,WAAA,SvBhKN,0BuBsGA,mBAEI,UAAA,OACA,gBAAA,WAEA,+BACE,eAAA,IAEA,8CACE,SAAA,SAGF,yCACE,cAAA,MACA,aAAA,MAIJ,sCACE,SAAA,QAGF,oCACE,QAAA,eACA,WAAA,KAGF,mCACE,QAAA,KAGF,qCACE,QAAA,KAGF,8BACE,SAAA,QACA,OAAA,EACA,QAAA,KACA,UAAA,EACA,WAAA,kBACA,iBAAA,YACA,aAAA,EACA,YAAA,EfhMJ,WAAA,KekMI,UAAA,KhCmgIV,qCgCjgIQ,kCAEE,OAAA,KACA,WAAA,EACA,cAAA,EAGF,mCACE,QAAA,KACA,UAAA,EACA,QAAA,EACA,WAAA,SA1DN,eAEI,UAAA,OACA,gBAAA,WAEA,2BACE,eAAA,IAEA,0CACE,SAAA,SAGF,qCACE,cAAA,MACA,aAAA,MAIJ,kCACE,SAAA,QAGF,gCACE,QAAA,eACA,WAAA,KAGF,+BACE,QAAA,KAGF,iCACE,QAAA,KAGF,0BACE,SAAA,QACA,OAAA,EACA,QAAA,KACA,UAAA,EACA,WAAA,kBACA,iBAAA,YACA,aAAA,EACA,YAAA,EfhMJ,WAAA,KekMI,UAAA,KhCujIV,iCgCrjIQ,8BAEE,OAAA,KACA,WAAA,EACA,cAAA,EAGF,+BACE,QAAA,KACA,UAAA,EACA,QAAA,EACA,WAAA,QAcR,4BACE,MAAA,eAEA,kCAAA,kCAEE,MAAA,eAKF,oCACE,MAAA,gBAEA,0CAAA,0CAEE,MAAA,eAGF,6CACE,MAAA,ehCqiIR,2CgCjiII,0CAEE,MAAA,eAIJ,8BACE,MAAA,gBACA,aAAA,eAGF,mCACE,iBAAA,4OAGF,2BACE,MAAA,gBAEA,6BhC8hIJ,mCADA,mCgC1hIM,MAAA,eAOJ,2BACE,MAAA,KAEA,iCAAA,iCAEE,MAAA,KAKF,mCACE,MAAA,sBAEA,yCAAA,yCAEE,MAAA,sBAGF,4CACE,MAAA,sBhCqhIR,0CgCjhII,yCAEE,MAAA,KAIJ,6BACE,MAAA,sBACA,aAAA,qBAGF,kCACE,iBAAA,kPAGF,0BACE,MAAA,sBACA,4BhC+gIJ,kCADA,kCgC3gIM,MAAA,KCvUN,MACE,SAAA,SACA,QAAA,KACA,eAAA,OACA,UAAA,EAEA,UAAA,WACA,iBAAA,KACA,gBAAA,WACA,OAAA,IAAA,MAAA,iB/BME,cAAA,O+BFF,SACE,aAAA,EACA,YAAA,EAGF,kBACE,WAAA,QACA,cAAA,QAEA,8BACE,iBAAA,E/BCF,uBAAA,mBACA,wBAAA,mB+BEA,6BACE,oBAAA,E/BUF,2BAAA,mBACA,0BAAA,mB+BJF,+BjCk1IF,+BiCh1II,WAAA,EAIJ,WAGE,KAAA,EAAA,EAAA,KACA,QAAA,KAAA,KAIF,YACE,cAAA,MAGF,eACE,WAAA,QACA,cAAA,EAGF,sBACE,cAAA,EAQA,sBACE,YAAA,KAQJ,aACE,QAAA,MAAA,KACA,cAAA,EAEA,iBAAA,gBACA,cAAA,IAAA,MAAA,iBAEA,yB/BpEE,cAAA,mBAAA,mBAAA,EAAA,E+ByEJ,aACE,QAAA,MAAA,KAEA,iBAAA,gBACA,WAAA,IAAA,MAAA,iBAEA,wB/B/EE,cAAA,EAAA,EAAA,mBAAA,mB+ByFJ,kBACE,aAAA,OACA,cAAA,OACA,YAAA,OACA,cAAA,EAUF,mBACE,aAAA,OACA,YAAA,OAIF,kBACE,SAAA,SACA,IAAA,EACA,MAAA,EACA,OAAA,EACA,KAAA,EACA,QAAA,K/BnHE,cAAA,mB+BuHJ,UjCozIA,iBADA,ciChzIE,MAAA,KAGF,UjCmzIA,cEv6II,uBAAA,mBACA,wBAAA,mB+BwHJ,UjCozIA,iBE/5II,2BAAA,mBACA,0BAAA,mB+BuHF,kBACE,cAAA,OxBpGA,yBwBgGJ,YAQI,QAAA,KACA,UAAA,IAAA,KAGA,kBAEE,KAAA,EAAA,EAAA,GACA,cAAA,EAEA,wBACE,YAAA,EACA,YAAA,EAKA,mC/BpJJ,wBAAA,EACA,2BAAA,EF+7IJ,gDiCzyIU,iDAGE,wBAAA,EjC0yIZ,gDiCxyIU,oDAGE,2BAAA,EAIJ,oC/BrJJ,uBAAA,EACA,0BAAA,EF67IJ,iDiCtyIU,kDAGE,uBAAA,EjCuyIZ,iDiCryIU,qDAGE,0BAAA,GC7MZ,kBACE,SAAA,SACA,QAAA,KACA,YAAA,OACA,MAAA,KACA,QAAA,KAAA,QjC4RI,UAAA,KiC1RJ,MAAA,QACA,WAAA,KACA,iBAAA,KACA,OAAA,EhCKE,cAAA,EgCHF,gBAAA,KjBAI,WAAA,MAAA,KAAA,WAAA,CAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,WAAA,CAAA,cAAA,KAAA,KAIA,uCiBhBN,kBjBiBQ,WAAA,MiBFN,kCACE,MAAA,QACA,iBAAA,QACA,WAAA,MAAA,EAAA,KAAA,EAAA,iBAEA,yCACE,iBAAA,gRACA,UAAA,gBAKJ,yBACE,YAAA,EACA,MAAA,QACA,OAAA,QACA,YAAA,KACA,QAAA,GACA,iBAAA,gRACA,kBAAA,UACA,gBAAA,QjBvBE,WAAA,UAAA,IAAA,YAIA,uCiBWJ,yBjBVM,WAAA,MiBsBN,wBACE,QAAA,EAGF,wBACE,QAAA,EACA,aAAA,QACA,QAAA,EACA,WAAA,EAAA,EAAA,EAAA,OAAA,qBAIJ,kBACE,cAAA,EAGF,gBACE,iBAAA,KACA,OAAA,IAAA,MAAA,iBAEA,8BhCnCE,uBAAA,OACA,wBAAA,OgCqCA,gDhCtCA,uBAAA,mBACA,wBAAA,mBgC0CF,oCACE,WAAA,EAIF,6BhClCE,2BAAA,OACA,0BAAA,OgCqCE,yDhCtCF,2BAAA,mBACA,0BAAA,mBgC0CA,iDhC3CA,2BAAA,OACA,0BAAA,OgCgDJ,gBACE,QAAA,KAAA,QASA,qCACE,aAAA,EAGF,iCACE,aAAA,EACA,YAAA,EhCxFA,cAAA,EgC2FA,6CAAgB,WAAA,EAChB,4CAAe,cAAA,EAEf,mDhC9FA,cAAA,EiCnBJ,YACE,QAAA,KACA,UAAA,KACA,QAAA,EAAA,EACA,cAAA,KAEA,WAAA,KAOA,kCACE,aAAA,MAEA,0CACE,MAAA,KACA,cAAA,MACA,MAAA,QACA,QAAA,kCAIJ,wBACE,MAAA,QCzBJ,YACE,QAAA,KhCGA,aAAA,EACA,WAAA,KgCAF,WACE,SAAA,SACA,QAAA,MACA,MAAA,QACA,gBAAA,KACA,iBAAA,KACA,OAAA,IAAA,MAAA,QnBKI,WAAA,MAAA,KAAA,WAAA,CAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YAIA,uCmBfN,WnBgBQ,WAAA,MmBPN,iBACE,QAAA,EACA,MAAA,QAEA,iBAAA,QACA,aAAA,QAGF,iBACE,QAAA,EACA,MAAA,QACA,iBAAA,QACA,QAAA,EACA,WAAA,EAAA,EAAA,EAAA,OAAA,qBAKF,wCACE,YAAA,KAGF,6BACE,QAAA,EACA,MAAA,KlBlCF,iBAAA,QkBoCE,aAAA,QAGF,+BACE,MAAA,QACA,eAAA,KACA,iBAAA,KACA,aAAA,QC3CF,WACE,QAAA,QAAA,OAOI,kCnCqCJ,uBAAA,OACA,0BAAA,OmChCI,iCnCiBJ,wBAAA,OACA,2BAAA,OmChCF,0BACE,QAAA,OAAA,OpCgSE,UAAA,QoCzRE,iDnCqCJ,uBAAA,MACA,0BAAA,MmChCI,gDnCiBJ,wBAAA,MACA,2BAAA,MmChCF,0BACE,QAAA,OAAA,MpCgSE,UAAA,QoCzRE,iDnCqCJ,uBAAA,MACA,0BAAA,MmChCI,gDnCiBJ,wBAAA,MACA,2BAAA,MoC/BJ,OACE,QAAA,aACA,QAAA,MAAA,MrC8RI,UAAA,MqC5RJ,YAAA,IACA,YAAA,EACA,MAAA,KACA,WAAA,OACA,YAAA,OACA,eAAA,SpCKE,cAAA,OoCAF,aACE,QAAA,KAKJ,YACE,SAAA,SACA,IAAA,KCvBF,OACE,SAAA,SACA,QAAA,KAAA,KACA,cAAA,KACA,OAAA,IAAA,MAAA,YrCWE,cAAA,OqCNJ,eAEE,MAAA,QAIF,YACE,YAAA,IAQF,mBACE,cAAA,KAGA,8BACE,SAAA,SACA,IAAA,EACA,MAAA,EACA,QAAA,EACA,QAAA,QAAA,KAeF,eClDA,MAAA,QtBEA,iBAAA,QsBAA,aAAA,QAEA,2BACE,MAAA,QD6CF,iBClDA,MAAA,QtBEA,iBAAA,QsBAA,aAAA,QAEA,6BACE,MAAA,QD6CF,eClDA,MAAA,QtBEA,iBAAA,QsBAA,aAAA,QAEA,2BACE,MAAA,QD6CF,YClDA,MAAA,QtBEA,iBAAA,QsBAA,aAAA,QAEA,wBACE,MAAA,QD6CF,eClDA,MAAA,QtBEA,iBAAA,QsBAA,aAAA,QAEA,2BACE,MAAA,QD6CF,cClDA,MAAA,QtBEA,iBAAA,QsBAA,aAAA,QAEA,0BACE,MAAA,QD6CF,aClDA,MAAA,QtBEA,iBAAA,QsBAA,aAAA,QAEA,yBACE,MAAA,QD6CF,YClDA,MAAA,QtBEA,iBAAA,QsBAA,aAAA,QAEA,wBACE,MAAA,QCHF,wCACE,GAAK,sBAAA,MADP,gCACE,GAAK,sBAAA,MAKT,UACE,QAAA,KACA,OAAA,KACA,SAAA,OxCwRI,UAAA,OwCtRJ,iBAAA,QvCIE,cAAA,OuCCJ,cACE,QAAA,KACA,eAAA,OACA,gBAAA,OACA,SAAA,OACA,MAAA,KACA,WAAA,OACA,YAAA,OACA,iBAAA,QxBZI,WAAA,MAAA,IAAA,KAIA,uCwBAN,cxBCQ,WAAA,MwBWR,sBvBYE,iBAAA,iKuBVA,gBAAA,KAAA,KAIA,uBACE,kBAAA,GAAA,OAAA,SAAA,qBAAA,UAAA,GAAA,OAAA,SAAA,qBAGE,uCAJJ,uBAKM,kBAAA,KAAA,UAAA,MCvCR,YACE,QAAA,KACA,eAAA,OAGA,aAAA,EACA,cAAA,ExCSE,cAAA,OwCLJ,qBACE,gBAAA,KACA,cAAA,QAEA,gCAEE,QAAA,uBAAA,KACA,kBAAA,QAUJ,wBACE,MAAA,KACA,MAAA,QACA,WAAA,QAGA,8BAAA,8BAEE,QAAA,EACA,MAAA,QACA,gBAAA,KACA,iBAAA,QAGF,+BACE,MAAA,QACA,iBAAA,QASJ,iBACE,SAAA,SACA,QAAA,MACA,QAAA,MAAA,KACA,MAAA,QACA,gBAAA,KACA,iBAAA,KACA,OAAA,IAAA,MAAA,iBAEA,6BxCrCE,uBAAA,QACA,wBAAA,QwCwCF,4BxC3BE,2BAAA,QACA,0BAAA,QwC8BF,0BAAA,0BAEE,MAAA,QACA,eAAA,KACA,iBAAA,KAIF,wBACE,QAAA,EACA,MAAA,KACA,iBAAA,QACA,aAAA,QAGF,kCACE,iBAAA,EAEA,yCACE,WAAA,KACA,iBAAA,IAcF,uBACE,eAAA,IAGE,oDxCrCJ,0BAAA,OAZA,wBAAA,EwCsDI,mDxCtDJ,wBAAA,OAYA,0BAAA,EwC+CI,+CACE,WAAA,EAGF,yDACE,iBAAA,IACA,kBAAA,EAEA,gEACE,YAAA,KACA,kBAAA,IjCpER,yBiC4CA,0BACE,eAAA,IAGE,uDxCrCJ,0BAAA,OAZA,wBAAA,EwCsDI,sDxCtDJ,wBAAA,OAYA,0BAAA,EwC+CI,kDACE,WAAA,EAGF,4DACE,iBAAA,IACA,kBAAA,EAEA,mEACE,YAAA,KACA,kBAAA,KjCpER,yBiC4CA,0BACE,eAAA,IAGE,uDxCrCJ,0BAAA,OAZA,wBAAA,EwCsDI,sDxCtDJ,wBAAA,OAYA,0BAAA,EwC+CI,kDACE,WAAA,EAGF,4DACE,iBAAA,IACA,kBAAA,EAEA,mEACE,YAAA,KACA,kBAAA,KjCpER,yBiC4CA,0BACE,eAAA,IAGE,uDxCrCJ,0BAAA,OAZA,wBAAA,EwCsDI,sDxCtDJ,wBAAA,OAYA,0BAAA,EwC+CI,kDACE,WAAA,EAGF,4DACE,iBAAA,IACA,kBAAA,EAEA,mEACE,YAAA,KACA,kBAAA,KjCpER,0BiC4CA,0BACE,eAAA,IAGE,uDxCrCJ,0BAAA,OAZA,wBAAA,EwCsDI,sDxCtDJ,wBAAA,OAYA,0BAAA,EwC+CI,kDACE,WAAA,EAGF,4DACE,iBAAA,IACA,kBAAA,EAEA,mEACE,YAAA,KACA,kBAAA,KjCpER,0BiC4CA,2BACE,eAAA,IAGE,wDxCrCJ,0BAAA,OAZA,wBAAA,EwCsDI,uDxCtDJ,wBAAA,OAYA,0BAAA,EwC+CI,mDACE,WAAA,EAGF,6DACE,iBAAA,IACA,kBAAA,EAEA,oEACE,YAAA,KACA,kBAAA,KAcZ,kBxC9HI,cAAA,EwCiIF,mCACE,aAAA,EAAA,EAAA,IAEA,8CACE,oBAAA,ECpJJ,yBACE,MAAA,QACA,iBAAA,QAGE,sDAAA,sDAEE,MAAA,QACA,iBAAA,QAGF,uDACE,MAAA,KACA,iBAAA,QACA,aAAA,QAdN,2BACE,MAAA,QACA,iBAAA,QAGE,wDAAA,wDAEE,MAAA,QACA,iBAAA,QAGF,yDACE,MAAA,KACA,iBAAA,QACA,aAAA,QAdN,yBACE,MAAA,QACA,iBAAA,QAGE,sDAAA,sDAEE,MAAA,QACA,iBAAA,QAGF,uDACE,MAAA,KACA,iBAAA,QACA,aAAA,QAdN,sBACE,MAAA,QACA,iBAAA,QAGE,mDAAA,mDAEE,MAAA,QACA,iBAAA,QAGF,oDACE,MAAA,KACA,iBAAA,QACA,aAAA,QAdN,yBACE,MAAA,QACA,iBAAA,QAGE,sDAAA,sDAEE,MAAA,QACA,iBAAA,QAGF,uDACE,MAAA,KACA,iBAAA,QACA,aAAA,QAdN,wBACE,MAAA,QACA,iBAAA,QAGE,qDAAA,qDAEE,MAAA,QACA,iBAAA,QAGF,sDACE,MAAA,KACA,iBAAA,QACA,aAAA,QAdN,uBACE,MAAA,QACA,iBAAA,QAGE,oDAAA,oDAEE,MAAA,QACA,iBAAA,QAGF,qDACE,MAAA,KACA,iBAAA,QACA,aAAA,QAdN,sBACE,MAAA,QACA,iBAAA,QAGE,mDAAA,mDAEE,MAAA,QACA,iBAAA,QAGF,oDACE,MAAA,KACA,iBAAA,QACA,aAAA,QCbR,WACE,WAAA,YACA,MAAA,IACA,OAAA,IACA,QAAA,MAAA,MACA,MAAA,KACA,WAAA,YAAA,0TAAA,MAAA,CAAA,IAAA,KAAA,UACA,OAAA,E1COE,cAAA,O0CLF,QAAA,GAGA,iBACE,MAAA,KACA,gBAAA,KACA,QAAA,IAGF,iBACE,QAAA,EACA,WAAA,EAAA,EAAA,EAAA,OAAA,qBACA,QAAA,EAGF,oBAAA,oBAEE,eAAA,KACA,oBAAA,KAAA,iBAAA,KAAA,YAAA,KACA,QAAA,IAIJ,iBACE,OAAA,UAAA,gBAAA,iBCtCF,OACE,MAAA,MACA,UAAA,K5CmSI,UAAA,Q4ChSJ,eAAA,KACA,iBAAA,sBACA,gBAAA,YACA,OAAA,IAAA,MAAA,eACA,WAAA,EAAA,MAAA,KAAA,gB3CUE,cAAA,O2CPF,eACE,QAAA,EAGF,kBACE,QAAA,KAIJ,iBACE,MAAA,oBAAA,MAAA,iBAAA,MAAA,YACA,UAAA,KACA,eAAA,KAEA,mCACE,cAAA,OAIJ,cACE,QAAA,KACA,YAAA,OACA,QAAA,MAAA,OACA,MAAA,QACA,iBAAA,sBACA,gBAAA,YACA,cAAA,IAAA,MAAA,gB3CVE,uBAAA,mBACA,wBAAA,mB2CYF,yBACE,aAAA,SACA,YAAA,OAIJ,YACE,QAAA,OACA,UAAA,WC1CF,OACE,SAAA,MACA,IAAA,EACA,KAAA,EACA,QAAA,KACA,QAAA,KACA,MAAA,KACA,OAAA,KACA,WAAA,OACA,WAAA,KAGA,QAAA,EAOF,cACE,SAAA,SACA,MAAA,KACA,OAAA,MAEA,eAAA,KAGA,0B7BlBI,WAAA,UAAA,IAAA,S6BoBF,UAAA,mB7BhBE,uC6BcJ,0B7BbM,WAAA,M6BiBN,0BACE,UAAA,KAIF,kCACE,UAAA,YAIJ,yBACE,OAAA,kBAEA,wCACE,WAAA,KACA,SAAA,OAGF,qCACE,WAAA,KAIJ,uBACE,QAAA,KACA,YAAA,OACA,WAAA,kBAIF,eACE,SAAA,SACA,QAAA,KACA,eAAA,OACA,MAAA,KAGA,eAAA,KACA,iBAAA,KACA,gBAAA,YACA,OAAA,IAAA,MAAA,e5C3DE,cAAA,M4C+DF,QAAA,EAIF,gBCpFE,SAAA,MACA,IAAA,EACA,KAAA,EACA,QAAA,KACA,MAAA,MACA,OAAA,MACA,iBAAA,KAGA,qBAAS,QAAA,EACT,qBAAS,QAAA,GDgFX,cACE,QAAA,KACA,YAAA,EACA,YAAA,OACA,gBAAA,cACA,QAAA,KAAA,KACA,cAAA,IAAA,MAAA,Q5CtEE,uBAAA,kBACA,wBAAA,kB4CwEF,yBACE,QAAA,MAAA,MACA,OAAA,OAAA,OAAA,OAAA,KAKJ,aACE,cAAA,EACA,YAAA,IAKF,YACE,SAAA,SAGA,KAAA,EAAA,EAAA,KACA,QAAA,KAIF,cACE,QAAA,KACA,UAAA,KACA,YAAA,EACA,YAAA,OACA,gBAAA,SACA,QAAA,OACA,WAAA,IAAA,MAAA,Q5CzFE,2BAAA,kBACA,0BAAA,kB4C8FF,gBACE,OAAA,OrC3EA,yBqCkFF,cACE,UAAA,MACA,OAAA,QAAA,KAGF,yBACE,OAAA,oBAGF,uBACE,WAAA,oBAOF,UAAY,UAAA,OrCnGV,yBqCuGF,U9CywKF,U8CvwKI,UAAA,OrCzGA,0BqC8GF,UAAY,UAAA,QASV,kBACE,MAAA,MACA,UAAA,KACA,OAAA,KACA,OAAA,EAEA,iCACE,OAAA,KACA,OAAA,E5C3KJ,cAAA,E4C+KE,gC5C/KF,cAAA,E4CmLE,8BACE,WAAA,KAGF,gC5CvLF,cAAA,EOyDA,4BqC0GA,0BACE,MAAA,MACA,UAAA,KACA,OAAA,KACA,OAAA,EAEA,yCACE,OAAA,KACA,OAAA,E5C3KJ,cAAA,E4C+KE,wC5C/KF,cAAA,E4CmLE,sCACE,WAAA,KAGF,wC5CvLF,cAAA,GOyDA,4BqC0GA,0BACE,MAAA,MACA,UAAA,KACA,OAAA,KACA,OAAA,EAEA,yCACE,OAAA,KACA,OAAA,E5C3KJ,cAAA,E4C+KE,wC5C/KF,cAAA,E4CmLE,sCACE,WAAA,KAGF,wC5CvLF,cAAA,GOyDA,4BqC0GA,0BACE,MAAA,MACA,UAAA,KACA,OAAA,KACA,OAAA,EAEA,yCACE,OAAA,KACA,OAAA,E5C3KJ,cAAA,E4C+KE,wC5C/KF,cAAA,E4CmLE,sCACE,WAAA,KAGF,wC5CvLF,cAAA,GOyDA,6BqC0GA,0BACE,MAAA,MACA,UAAA,KACA,OAAA,KACA,OAAA,EAEA,yCACE,OAAA,KACA,OAAA,E5C3KJ,cAAA,E4C+KE,wC5C/KF,cAAA,E4CmLE,sCACE,WAAA,KAGF,wC5CvLF,cAAA,GOyDA,6BqC0GA,2BACE,MAAA,MACA,UAAA,KACA,OAAA,KACA,OAAA,EAEA,0CACE,OAAA,KACA,OAAA,E5C3KJ,cAAA,E4C+KE,yC5C/KF,cAAA,E4CmLE,uCACE,WAAA,KAGF,yC5CvLF,cAAA,G8ClBJ,SACE,SAAA,SACA,QAAA,KACA,QAAA,MACA,OAAA,ECJA,YAAA,0BAEA,WAAA,OACA,YAAA,IACA,YAAA,IACA,WAAA,KACA,WAAA,MACA,gBAAA,KACA,YAAA,KACA,eAAA,KACA,eAAA,OACA,WAAA,OACA,aAAA,OACA,YAAA,OACA,WAAA,KhDsRI,UAAA,Q+C1RJ,UAAA,WACA,QAAA,EAEA,cAAS,QAAA,GAET,wBACE,SAAA,SACA,QAAA,MACA,MAAA,MACA,OAAA,MAEA,gCACE,SAAA,SACA,QAAA,GACA,aAAA,YACA,aAAA,MAKN,6CAAA,gBACE,QAAA,MAAA,EAEA,4DAAA,+BACE,OAAA,EAEA,oEAAA,uCACE,IAAA,KACA,aAAA,MAAA,MAAA,EACA,iBAAA,KAKN,+CAAA,gBACE,QAAA,EAAA,MAEA,8DAAA,+BACE,KAAA,EACA,MAAA,MACA,OAAA,MAEA,sEAAA,uCACE,MAAA,KACA,aAAA,MAAA,MAAA,MAAA,EACA,mBAAA,KAKN,gDAAA,mBACE,QAAA,MAAA,EAEA,+DAAA,kCACE,IAAA,EAEA,uEAAA,0CACE,OAAA,KACA,aAAA,EAAA,MAAA,MACA,oBAAA,KAKN,8CAAA,kBACE,QAAA,EAAA,MAEA,6DAAA,iCACE,MAAA,EACA,MAAA,MACA,OAAA,MAEA,qEAAA,yCACE,KAAA,KACA,aAAA,MAAA,EAAA,MAAA,MACA,kBAAA,KAqBN,eACE,UAAA,MACA,QAAA,OAAA,MACA,MAAA,KACA,WAAA,OACA,iBAAA,K9C7FE,cAAA,OgDnBJ,SACE,SAAA,SACA,IAAA,EACA,KAAA,EACA,QAAA,KACA,QAAA,MACA,UAAA,MDLA,YAAA,0BAEA,WAAA,OACA,YAAA,IACA,YAAA,IACA,WAAA,KACA,WAAA,MACA,gBAAA,KACA,YAAA,KACA,eAAA,KACA,eAAA,OACA,WAAA,OACA,aAAA,OACA,YAAA,OACA,WAAA,KhDsRI,UAAA,QiDzRJ,UAAA,WACA,iBAAA,KACA,gBAAA,YACA,OAAA,IAAA,MAAA,ehDIE,cAAA,MgDAF,wBACE,SAAA,SACA,QAAA,MACA,MAAA,KACA,OAAA,MAEA,+BAAA,gCAEE,SAAA,SACA,QAAA,MACA,QAAA,GACA,aAAA,YACA,aAAA,MAMJ,4DAAA,+BACE,OAAA,mBAEA,oEAAA,uCACE,OAAA,EACA,aAAA,MAAA,MAAA,EACA,iBAAA,gBAGF,mEAAA,sCACE,OAAA,IACA,aAAA,MAAA,MAAA,EACA,iBAAA,KAMJ,8DAAA,+BACE,KAAA,mBACA,MAAA,MACA,OAAA,KAEA,sEAAA,uCACE,KAAA,EACA,aAAA,MAAA,MAAA,MAAA,EACA,mBAAA,gBAGF,qEAAA,sCACE,KAAA,IACA,aAAA,MAAA,MAAA,MAAA,EACA,mBAAA,KAMJ,+DAAA,kCACE,IAAA,mBAEA,uEAAA,0CACE,IAAA,EACA,aAAA,EAAA,MAAA,MAAA,MACA,oBAAA,gBAGF,sEAAA,yCACE,IAAA,IACA,aAAA,EAAA,MAAA,MAAA,MACA,oBAAA,KAKJ,wEAAA,2CACE,SAAA,SACA,IAAA,EACA,KAAA,IACA,QAAA,MACA,MAAA,KACA,YAAA,OACA,QAAA,GACA,cAAA,IAAA,MAAA,QAKF,6DAAA,iCACE,MAAA,mBACA,MAAA,MACA,OAAA,KAEA,qEAAA,yCACE,MAAA,EACA,aAAA,MAAA,EAAA,MAAA,MACA,kBAAA,gBAGF,oEAAA,wCACE,MAAA,IACA,aAAA,MAAA,EAAA,MAAA,MACA,kBAAA,KAqBN,gBACE,QAAA,MAAA,KACA,cAAA,EjDuJI,UAAA,KiDpJJ,iBAAA,QACA,cAAA,IAAA,MAAA,ehDtHE,uBAAA,kBACA,wBAAA,kBgDwHF,sBACE,QAAA,KAIJ,cACE,QAAA,KAAA,KACA,MAAA,QC/IF,UACE,SAAA,SAGF,wBACE,aAAA,MAGF,gBACE,SAAA,SACA,MAAA,KACA,SAAA,OCtBA,uBACE,QAAA,MACA,MAAA,KACA,QAAA,GDuBJ,eACE,SAAA,SACA,QAAA,KACA,MAAA,KACA,MAAA,KACA,aAAA,MACA,4BAAA,OAAA,oBAAA,OlClBI,WAAA,UAAA,IAAA,YAIA,uCkCQN,elCPQ,WAAA,MjBgzLR,oBACA,oBmDhyLA,sBAGE,QAAA,MnDmyLF,0BmD/xLA,8CAEE,UAAA,iBnDkyLF,4BmD/xLA,4CAEE,UAAA,kBAWA,8BACE,QAAA,EACA,oBAAA,QACA,UAAA,KnD0xLJ,uDACA,qDmDxxLE,qCAGE,QAAA,EACA,QAAA,EnDyxLJ,yCmDtxLE,2CAEE,QAAA,EACA,QAAA,ElC/DE,WAAA,QAAA,GAAA,IAIA,uCjBq1LN,yCmD7xLE,2ClCvDM,WAAA,MjB01LR,uBmDtxLA,uBAEE,SAAA,SACA,IAAA,EACA,OAAA,EACA,QAAA,EAEA,QAAA,KACA,YAAA,OACA,gBAAA,OACA,MAAA,IACA,QAAA,EACA,MAAA,KACA,WAAA,OACA,WAAA,IACA,OAAA,EACA,QAAA,GlCzFI,WAAA,QAAA,KAAA,KAIA,uCjB82LN,uBmDzyLA,uBlCpEQ,WAAA,MjBm3LR,6BADA,6BmD1xLE,6BAAA,6BAEE,MAAA,KACA,gBAAA,KACA,QAAA,EACA,QAAA,GAGJ,uBACE,KAAA,EAGF,uBACE,MAAA,EnD8xLF,4BmDzxLA,4BAEE,QAAA,aACA,MAAA,KACA,OAAA,KACA,kBAAA,UACA,oBAAA,IACA,gBAAA,KAAA,KAWF,4BACE,iBAAA,wPAEF,4BACE,iBAAA,yPAQF,qBACE,SAAA,SACA,MAAA,EACA,OAAA,EACA,KAAA,EACA,QAAA,EACA,QAAA,KACA,gBAAA,OACA,QAAA,EAEA,aAAA,IACA,cAAA,KACA,YAAA,IACA,WAAA,KAEA,sCACE,WAAA,YACA,KAAA,EAAA,EAAA,KACA,MAAA,KACA,OAAA,IACA,QAAA,EACA,aAAA,IACA,YAAA,IACA,YAAA,OACA,OAAA,QACA,iBAAA,KACA,gBAAA,YACA,OAAA,EAEA,WAAA,KAAA,MAAA,YACA,cAAA,KAAA,MAAA,YACA,QAAA,GlC5KE,WAAA,QAAA,IAAA,KAIA,uCkCwJJ,sClCvJM,WAAA,MkC2KN,6BACE,QAAA,EASJ,kBACE,SAAA,SACA,MAAA,IACA,OAAA,QACA,KAAA,IACA,YAAA,QACA,eAAA,QACA,MAAA,KACA,WAAA,OnDoxLF,2CmD9wLE,2CAEE,OAAA,UAAA,eAGF,qDACE,iBAAA,KAGF,iCACE,MAAA,KE7NJ,kCACE,GAAK,UAAA,gBADP,0BACE,GAAK,UAAA,gBAIP,gBACE,QAAA,aACA,MAAA,KACA,OAAA,KACA,eAAA,QACA,OAAA,MAAA,MAAA,aACA,mBAAA,YAEA,cAAA,IACA,kBAAA,KAAA,OAAA,SAAA,eAAA,UAAA,KAAA,OAAA,SAAA,eAGF,mBACE,MAAA,KACA,OAAA,KACA,aAAA,KAQF,gCACE,GACE,UAAA,SAEF,IACE,QAAA,EACA,UAAA,MANJ,wBACE,GACE,UAAA,SAEF,IACE,QAAA,EACA,UAAA,MAKJ,cACE,QAAA,aACA,MAAA,KACA,OAAA,KACA,eAAA,QACA,iBAAA,aAEA,cAAA,IACA,QAAA,EACA,kBAAA,KAAA,OAAA,SAAA,aAAA,UAAA,KAAA,OAAA,SAAA,aAGF,iBACE,MAAA,KACA,OAAA,KAIA,uCACE,gBrDo/LJ,cqDl/LM,2BAAA,KAAA,mBAAA,MCjEN,WACE,SAAA,MACA,OAAA,EACA,QAAA,KACA,QAAA,KACA,eAAA,OACA,UAAA,KAEA,WAAA,OACA,iBAAA,KACA,gBAAA,YACA,QAAA,ErCKI,WAAA,UAAA,IAAA,YAIA,uCqCpBN,WrCqBQ,WAAA,MqCLR,oBPdE,SAAA,MACA,IAAA,EACA,KAAA,EACA,QAAA,KACA,MAAA,MACA,OAAA,MACA,iBAAA,KAGA,yBAAS,QAAA,EACT,yBAAS,QAAA,GOQX,kBACE,QAAA,KACA,YAAA,OACA,gBAAA,cACA,QAAA,KAAA,KAEA,6BACE,QAAA,MAAA,MACA,WAAA,OACA,aAAA,OACA,cAAA,OAIJ,iBACE,cAAA,EACA,YAAA,IAGF,gBACE,UAAA,EACA,QAAA,KAAA,KACA,WAAA,KAGF,iBACE,IAAA,EACA,KAAA,EACA,MAAA,MACA,aAAA,IAAA,MAAA,eACA,UAAA,kBAGF,eACE,IAAA,EACA,MAAA,EACA,MAAA,MACA,YAAA,IAAA,MAAA,eACA,UAAA,iBAGF,eACE,IAAA,EACA,MAAA,EACA,KAAA,EACA,OAAA,KACA,WAAA,KACA,cAAA,IAAA,MAAA,eACA,UAAA,kBAGF,kBACE,MAAA,EACA,KAAA,EACA,OAAA,KACA,WAAA,KACA,WAAA,IAAA,MAAA,eACA,UAAA,iBAGF,gBACE,UAAA,KCjFF,aACE,QAAA,aACA,WAAA,IACA,eAAA,OACA,OAAA,KACA,iBAAA,aACA,QAAA,GAEA,yBACE,QAAA,aACA,QAAA,GAKJ,gBACE,WAAA,KAGF,gBACE,WAAA,KAGF,gBACE,WAAA,MAKA,+BACE,kBAAA,iBAAA,GAAA,YAAA,SAAA,UAAA,iBAAA,GAAA,YAAA,SAIJ,oCACE,IACE,QAAA,IAFJ,4BACE,IACE,QAAA,IAIJ,kBACE,mBAAA,8DAAA,WAAA,8DACA,kBAAA,KAAA,KAAA,UAAA,KAAA,KACA,kBAAA,iBAAA,GAAA,OAAA,SAAA,UAAA,iBAAA,GAAA,OAAA,SAGF,oCACE,KACE,sBAAA,MAAA,GAAA,cAAA,MAAA,IAFJ,4BACE,KACE,sBAAA,MAAA,GAAA,cAAA,MAAA,IH9CF,iBACE,QAAA,MACA,MAAA,KACA,QAAA,GIJF,cACE,MAAA,QAGE,oBAAA,oBAEE,MAAA,QANN,gBACE,MAAA,QAGE,sBAAA,sBAEE,MAAA,QANN,cACE,MAAA,QAGE,oBAAA,oBAEE,MAAA,QANN,WACE,MAAA,QAGE,iBAAA,iBAEE,MAAA,QANN,cACE,MAAA,QAGE,oBAAA,oBAEE,MAAA,QANN,aACE,MAAA,QAGE,mBAAA,mBAEE,MAAA,QANN,YACE,MAAA,QAGE,kBAAA,kBAEE,MAAA,QANN,WACE,MAAA,QAGE,iBAAA,iBAEE,MAAA,QCLR,OACE,SAAA,SACA,MAAA,KAEA,eACE,QAAA,MACA,YAAA,uBACA,QAAA,GAGF,SACE,SAAA,SACA,IAAA,EACA,KAAA,EACA,MAAA,KACA,OAAA,KAKF,WACE,kBAAA,KADF,WACE,kBAAA,mBADF,YACE,kBAAA,oBADF,YACE,kBAAA,oBCrBJ,WACE,SAAA,MACA,IAAA,EACA,MAAA,EACA,KAAA,EACA,QAAA,KAGF,cACE,SAAA,MACA,MAAA,EACA,OAAA,EACA,KAAA,EACA,QAAA,KAQE,YACE,SAAA,eAAA,SAAA,OACA,IAAA,EACA,QAAA,KjDqCF,yBiDxCA,eACE,SAAA,eAAA,SAAA,OACA,IAAA,EACA,QAAA,MjDqCF,yBiDxCA,eACE,SAAA,eAAA,SAAA,OACA,IAAA,EACA,QAAA,MjDqCF,yBiDxCA,eACE,SAAA,eAAA,SAAA,OACA,IAAA,EACA,QAAA,MjDqCF,0BiDxCA,eACE,SAAA,eAAA,SAAA,OACA,IAAA,EACA,QAAA,MjDqCF,0BiDxCA,gBACE,SAAA,eAAA,SAAA,OACA,IAAA,EACA,QAAA,MCzBN,QACE,QAAA,KACA,eAAA,IACA,YAAA,OACA,WAAA,QAGF,QACE,QAAA,KACA,KAAA,EAAA,EAAA,KACA,eAAA,OACA,WAAA,QCRF,iB5Dk4MA,0D6D93ME,SAAA,mBACA,MAAA,cACA,OAAA,cACA,QAAA,YACA,OAAA,eACA,SAAA,iBACA,KAAA,wBACA,YAAA,iBACA,OAAA,YCXA,uBACE,SAAA,SACA,IAAA,EACA,MAAA,EACA,OAAA,EACA,KAAA,EACA,QAAA,EACA,QAAA,GCRJ,eCAE,SAAA,OACA,cAAA,SACA,YAAA,OCNF,IACE,QAAA,aACA,WAAA,QACA,MAAA,IACA,WAAA,IACA,iBAAA,aACA,QAAA,ICyDM,gBAOI,eAAA,mBAPJ,WAOI,eAAA,cAPJ,cAOI,eAAA,iBAPJ,cAOI,eAAA,iBAPJ,mBAOI,eAAA,sBAPJ,gBAOI,eAAA,mBAPJ,aAOI,MAAA,eAPJ,WAOI,MAAA,gBAPJ,YAOI,MAAA,eAPJ,WAOI,QAAA,YAPJ,YAOI,QAAA,cAPJ,YAOI,QAAA,aAPJ,YAOI,QAAA,cAPJ,aAOI,QAAA,YAPJ,eAOI,SAAA,eAPJ,iBAOI,SAAA,iBAPJ,kBAOI,SAAA,kBAPJ,iBAOI,SAAA,iBAPJ,UAOI,QAAA,iBAPJ,gBAOI,QAAA,uBAPJ,SAOI,QAAA,gBAPJ,QAOI,QAAA,eAPJ,SAOI,QAAA,gBAPJ,aAOI,QAAA,oBAPJ,cAOI,QAAA,qBAPJ,QAOI,QAAA,eAPJ,eAOI,QAAA,sBAPJ,QAOI,QAAA,eAPJ,QAOI,WAAA,EAAA,MAAA,KAAA,0BAPJ,WAOI,WAAA,EAAA,QAAA,OAAA,2BAPJ,WAOI,WAAA,EAAA,KAAA,KAAA,2BAPJ,aAOI,WAAA,eAPJ,iBAOI,SAAA,iBAPJ,mBAOI,SAAA,mBAPJ,mBAOI,SAAA,mBAPJ,gBAOI,SAAA,gBAPJ,iBAOI,SAAA,yBAAA,SAAA,iBAPJ,OAOI,IAAA,YAPJ,QAOI,IAAA,cAPJ,SAOI,IAAA,eAPJ,UAOI,OAAA,YAPJ,WAOI,OAAA,cAPJ,YAOI,OAAA,eAPJ,SAOI,KAAA,YAPJ,UAOI,KAAA,cAPJ,WAOI,KAAA,eAPJ,OAOI,MAAA,YAPJ,QAOI,MAAA,cAPJ,SAOI,MAAA,eAPJ,kBAOI,UAAA,+BAPJ,oBAOI,UAAA,2BAPJ,oBAOI,UAAA,2BAPJ,QAOI,OAAA,IAAA,MAAA,kBAPJ,UAOI,OAAA,YAPJ,YAOI,WAAA,IAAA,MAAA,kBAPJ,cAOI,WAAA,YAPJ,YAOI,aAAA,IAAA,MAAA,kBAPJ,cAOI,aAAA,YAPJ,eAOI,cAAA,IAAA,MAAA,kBAPJ,iBAOI,cAAA,YAPJ,cAOI,YAAA,IAAA,MAAA,kBAPJ,gBAOI,YAAA,YAPJ,gBAOI,aAAA,kBAPJ,kBAOI,aAAA,kBAPJ,gBAOI,aAAA,kBAPJ,aAOI,aAAA,kBAPJ,gBAOI,aAAA,kBAPJ,eAOI,aAAA,kBAPJ,cAOI,aAAA,kBAPJ,aAOI,aAAA,kBAPJ,cAOI,aAAA,eAPJ,UAOI,aAAA,cAPJ,UAOI,aAAA,cAPJ,UAOI,aAAA,cAPJ,UAOI,aAAA,cAPJ,UAOI,aAAA,cAPJ,MAOI,MAAA,cAPJ,MAOI,MAAA,cAPJ,MAOI,MAAA,cAPJ,OAOI,MAAA,eAPJ,QAOI,MAAA,eAPJ,QAOI,UAAA,eAPJ,QAOI,MAAA,gBAPJ,YAOI,UAAA,gBAPJ,MAOI,OAAA,cAPJ,MAOI,OAAA,cAPJ,MAOI,OAAA,cAPJ,OAOI,OAAA,eAPJ,QAOI,OAAA,eAPJ,QAOI,WAAA,eAPJ,QAOI,OAAA,gBAPJ,YAOI,WAAA,gBAPJ,WAOI,KAAA,EAAA,EAAA,eAPJ,UAOI,eAAA,cAPJ,aAOI,eAAA,iBAPJ,kBAOI,eAAA,sBAPJ,qBAOI,eAAA,yBAPJ,aAOI,UAAA,YAPJ,aAOI,UAAA,YAPJ,eAOI,YAAA,YAPJ,eAOI,YAAA,YAPJ,WAOI,UAAA,eAPJ,aAOI,UAAA,iBAPJ,mBAOI,UAAA,uBAPJ,OAOI,IAAA,YAPJ,OAOI,IAAA,iBAPJ,OAOI,IAAA,gBAPJ,OAOI,IAAA,eAPJ,OAOI,IAAA,iBAPJ,OAOI,IAAA,eAPJ,uBAOI,gBAAA,qBAPJ,qBAOI,gBAAA,mBAPJ,wBAOI,gBAAA,iBAPJ,yBAOI,gBAAA,wBAPJ,wBAOI,gBAAA,uBAPJ,wBAOI,gBAAA,uBAPJ,mBAOI,YAAA,qBAPJ,iBAOI,YAAA,mBAPJ,oBAOI,YAAA,iBAPJ,sBAOI,YAAA,mBAPJ,qBAOI,YAAA,kBAPJ,qBAOI,cAAA,qBAPJ,mBAOI,cAAA,mBAPJ,sBAOI,cAAA,iBAPJ,uBAOI,cAAA,wBAPJ,sBAOI,cAAA,uBAPJ,uBAOI,cAAA,kBAPJ,iBAOI,WAAA,eAPJ,kBAOI,WAAA,qBAPJ,gBAOI,WAAA,mBAPJ,mBAOI,WAAA,iBAPJ,qBAOI,WAAA,mBAPJ,oBAOI,WAAA,kBAPJ,aAOI,MAAA,aAPJ,SAOI,MAAA,YAPJ,SAOI,MAAA,YAPJ,SAOI,MAAA,YAPJ,SAOI,MAAA,YAPJ,SAOI,MAAA,YAPJ,SAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,KAOI,OAAA,YAPJ,KAOI,OAAA,iBAPJ,KAOI,OAAA,gBAPJ,KAOI,OAAA,eAPJ,KAOI,OAAA,iBAPJ,KAOI,OAAA,eAPJ,QAOI,OAAA,eAPJ,MAOI,aAAA,YAAA,YAAA,YAPJ,MAOI,aAAA,iBAAA,YAAA,iBAPJ,MAOI,aAAA,gBAAA,YAAA,gBAPJ,MAOI,aAAA,eAAA,YAAA,eAPJ,MAOI,aAAA,iBAAA,YAAA,iBAPJ,MAOI,aAAA,eAAA,YAAA,eAPJ,SAOI,aAAA,eAAA,YAAA,eAPJ,MAOI,WAAA,YAAA,cAAA,YAPJ,MAOI,WAAA,iBAAA,cAAA,iBAPJ,MAOI,WAAA,gBAAA,cAAA,gBAPJ,MAOI,WAAA,eAAA,cAAA,eAPJ,MAOI,WAAA,iBAAA,cAAA,iBAPJ,MAOI,WAAA,eAAA,cAAA,eAPJ,SAOI,WAAA,eAAA,cAAA,eAPJ,MAOI,WAAA,YAPJ,MAOI,WAAA,iBAPJ,MAOI,WAAA,gBAPJ,MAOI,WAAA,eAPJ,MAOI,WAAA,iBAPJ,MAOI,WAAA,eAPJ,SAOI,WAAA,eAPJ,MAOI,aAAA,YAPJ,MAOI,aAAA,iBAPJ,MAOI,aAAA,gBAPJ,MAOI,aAAA,eAPJ,MAOI,aAAA,iBAPJ,MAOI,aAAA,eAPJ,SAOI,aAAA,eAPJ,MAOI,cAAA,YAPJ,MAOI,cAAA,iBAPJ,MAOI,cAAA,gBAPJ,MAOI,cAAA,eAPJ,MAOI,cAAA,iBAPJ,MAOI,cAAA,eAPJ,SAOI,cAAA,eAPJ,MAOI,YAAA,YAPJ,MAOI,YAAA,iBAPJ,MAOI,YAAA,gBAPJ,MAOI,YAAA,eAPJ,MAOI,YAAA,iBAPJ,MAOI,YAAA,eAPJ,SAOI,YAAA,eAPJ,KAOI,QAAA,YAPJ,KAOI,QAAA,iBAPJ,KAOI,QAAA,gBAPJ,KAOI,QAAA,eAPJ,KAOI,QAAA,iBAPJ,KAOI,QAAA,eAPJ,MAOI,cAAA,YAAA,aAAA,YAPJ,MAOI,cAAA,iBAAA,aAAA,iBAPJ,MAOI,cAAA,gBAAA,aAAA,gBAPJ,MAOI,cAAA,eAAA,aAAA,eAPJ,MAOI,cAAA,iBAAA,aAAA,iBAPJ,MAOI,cAAA,eAAA,aAAA,eAPJ,MAOI,YAAA,YAAA,eAAA,YAPJ,MAOI,YAAA,iBAAA,eAAA,iBAPJ,MAOI,YAAA,gBAAA,eAAA,gBAPJ,MAOI,YAAA,eAAA,eAAA,eAPJ,MAOI,YAAA,iBAAA,eAAA,iBAPJ,MAOI,YAAA,eAAA,eAAA,eAPJ,MAOI,YAAA,YAPJ,MAOI,YAAA,iBAPJ,MAOI,YAAA,gBAPJ,MAOI,YAAA,eAPJ,MAOI,YAAA,iBAPJ,MAOI,YAAA,eAPJ,MAOI,cAAA,YAPJ,MAOI,cAAA,iBAPJ,MAOI,cAAA,gBAPJ,MAOI,cAAA,eAPJ,MAOI,cAAA,iBAPJ,MAOI,cAAA,eAPJ,MAOI,eAAA,YAPJ,MAOI,eAAA,iBAPJ,MAOI,eAAA,gBAPJ,MAOI,eAAA,eAPJ,MAOI,eAAA,iBAPJ,MAOI,eAAA,eAPJ,MAOI,aAAA,YAPJ,MAOI,aAAA,iBAPJ,MAOI,aAAA,gBAPJ,MAOI,aAAA,eAPJ,MAOI,aAAA,iBAPJ,MAOI,aAAA,eAPJ,gBAOI,YAAA,mCAPJ,MAOI,UAAA,iCAPJ,MAOI,UAAA,gCAPJ,MAOI,UAAA,8BAPJ,MAOI,UAAA,gCAPJ,MAOI,UAAA,kBAPJ,MAOI,UAAA,eAPJ,YAOI,WAAA,iBAPJ,YAOI,WAAA,iBAPJ,UAOI,YAAA,cAPJ,YAOI,YAAA,kBAPJ,WAOI,YAAA,cAPJ,SAOI,YAAA,cAPJ,WAOI,YAAA,iBAPJ,MAOI,YAAA,YAPJ,OAOI,YAAA,eAPJ,SAOI,YAAA,cAPJ,OAOI,YAAA,YAPJ,YAOI,WAAA,eAPJ,UAOI,WAAA,gBAPJ,aAOI,WAAA,iBAPJ,sBAOI,gBAAA,eAPJ,2BAOI,gBAAA,oBAPJ,8BAOI,gBAAA,uBAPJ,gBAOI,eAAA,oBAPJ,gBAOI,eAAA,oBAPJ,iBAOI,eAAA,qBAPJ,WAOI,YAAA,iBAPJ,aAOI,YAAA,iBAPJ,YAOI,UAAA,qBAAA,WAAA,qBAPJ,cAIQ,kBAAA,EAGJ,MAAA,6DAPJ,gBAIQ,kBAAA,EAGJ,MAAA,+DAPJ,cAIQ,kBAAA,EAGJ,MAAA,6DAPJ,WAIQ,kBAAA,EAGJ,MAAA,0DAPJ,cAIQ,kBAAA,EAGJ,MAAA,6DAPJ,aAIQ,kBAAA,EAGJ,MAAA,4DAPJ,YAIQ,kBAAA,EAGJ,MAAA,2DAPJ,WAIQ,kBAAA,EAGJ,MAAA,0DAPJ,YAIQ,kBAAA,EAGJ,MAAA,2DAPJ,YAIQ,kBAAA,EAGJ,MAAA,2DAPJ,WAIQ,kBAAA,EAGJ,MAAA,0DAPJ,YAIQ,kBAAA,EAGJ,MAAA,kBAPJ,eAIQ,kBAAA,EAGJ,MAAA,yBAPJ,eAIQ,kBAAA,EAGJ,MAAA,+BAPJ,YAIQ,kBAAA,EAGJ,MAAA,kBAjBJ,iBACE,kBAAA,KADF,iBACE,kBAAA,IADF,iBACE,kBAAA,KADF,kBACE,kBAAA,EASF,YAIQ,gBAAA,EAGJ,iBAAA,2DAPJ,cAIQ,gBAAA,EAGJ,iBAAA,6DAPJ,YAIQ,gBAAA,EAGJ,iBAAA,2DAPJ,SAIQ,gBAAA,EAGJ,iBAAA,wDAPJ,YAIQ,gBAAA,EAGJ,iBAAA,2DAPJ,WAIQ,gBAAA,EAGJ,iBAAA,0DAPJ,UAIQ,gBAAA,EAGJ,iBAAA,yDAPJ,SAIQ,gBAAA,EAGJ,iBAAA,wDAPJ,UAIQ,gBAAA,EAGJ,iBAAA,yDAPJ,UAIQ,gBAAA,EAGJ,iBAAA,yDAPJ,SAIQ,gBAAA,EAGJ,iBAAA,wDAPJ,gBAIQ,gBAAA,EAGJ,iBAAA,sBAjBJ,eACE,gBAAA,IADF,eACE,gBAAA,KADF,eACE,gBAAA,IADF,eACE,gBAAA,KADF,gBACE,gBAAA,EASF,aAOI,iBAAA,6BAPJ,iBAOI,oBAAA,cAAA,iBAAA,cAAA,YAAA,cAPJ,kBAOI,oBAAA,eAAA,iBAAA,eAAA,YAAA,eAPJ,kBAOI,oBAAA,eAAA,iBAAA,eAAA,YAAA,eAPJ,SAOI,eAAA,eAPJ,SAOI,eAAA,eAPJ,SAOI,cAAA,iBAPJ,WAOI,cAAA,YAPJ,WAOI,cAAA,gBAPJ,WAOI,cAAA,iBAPJ,WAOI,cAAA,gBAPJ,gBAOI,cAAA,cAPJ,cAOI,cAAA,gBAPJ,aAOI,uBAAA,iBAAA,wBAAA,iBAPJ,aAOI,wBAAA,iBAAA,2BAAA,iBAPJ,gBAOI,2BAAA,iBAAA,0BAAA,iBAPJ,eAOI,0BAAA,iBAAA,uBAAA,iBAPJ,SAOI,WAAA,kBAPJ,WAOI,WAAA,iBzDPR,yByDAI,gBAOI,MAAA,eAPJ,cAOI,MAAA,gBAPJ,eAOI,MAAA,eAPJ,aAOI,QAAA,iBAPJ,mBAOI,QAAA,uBAPJ,YAOI,QAAA,gBAPJ,WAOI,QAAA,eAPJ,YAOI,QAAA,gBAPJ,gBAOI,QAAA,oBAPJ,iBAOI,QAAA,qBAPJ,WAOI,QAAA,eAPJ,kBAOI,QAAA,sBAPJ,WAOI,QAAA,eAPJ,cAOI,KAAA,EAAA,EAAA,eAPJ,aAOI,eAAA,cAPJ,gBAOI,eAAA,iBAPJ,qBAOI,eAAA,sBAPJ,wBAOI,eAAA,yBAPJ,gBAOI,UAAA,YAPJ,gBAOI,UAAA,YAPJ,kBAOI,YAAA,YAPJ,kBAOI,YAAA,YAPJ,cAOI,UAAA,eAPJ,gBAOI,UAAA,iBAPJ,sBAOI,UAAA,uBAPJ,UAOI,IAAA,YAPJ,UAOI,IAAA,iBAPJ,UAOI,IAAA,gBAPJ,UAOI,IAAA,eAPJ,UAOI,IAAA,iBAPJ,UAOI,IAAA,eAPJ,0BAOI,gBAAA,qBAPJ,wBAOI,gBAAA,mBAPJ,2BAOI,gBAAA,iBAPJ,4BAOI,gBAAA,wBAPJ,2BAOI,gBAAA,uBAPJ,2BAOI,gBAAA,uBAPJ,sBAOI,YAAA,qBAPJ,oBAOI,YAAA,mBAPJ,uBAOI,YAAA,iBAPJ,yBAOI,YAAA,mBAPJ,wBAOI,YAAA,kBAPJ,wBAOI,cAAA,qBAPJ,sBAOI,cAAA,mBAPJ,yBAOI,cAAA,iBAPJ,0BAOI,cAAA,wBAPJ,yBAOI,cAAA,uBAPJ,0BAOI,cAAA,kBAPJ,oBAOI,WAAA,eAPJ,qBAOI,WAAA,qBAPJ,mBAOI,WAAA,mBAPJ,sBAOI,WAAA,iBAPJ,wBAOI,WAAA,mBAPJ,uBAOI,WAAA,kBAPJ,gBAOI,MAAA,aAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,eAOI,MAAA,YAPJ,QAOI,OAAA,YAPJ,QAOI,OAAA,iBAPJ,QAOI,OAAA,gBAPJ,QAOI,OAAA,eAPJ,QAOI,OAAA,iBAPJ,QAOI,OAAA,eAPJ,WAOI,OAAA,eAPJ,SAOI,aAAA,YAAA,YAAA,YAPJ,SAOI,aAAA,iBAAA,YAAA,iBAPJ,SAOI,aAAA,gBAAA,YAAA,gBAPJ,SAOI,aAAA,eAAA,YAAA,eAPJ,SAOI,aAAA,iBAAA,YAAA,iBAPJ,SAOI,aAAA,eAAA,YAAA,eAPJ,YAOI,aAAA,eAAA,YAAA,eAPJ,SAOI,WAAA,YAAA,cAAA,YAPJ,SAOI,WAAA,iBAAA,cAAA,iBAPJ,SAOI,WAAA,gBAAA,cAAA,gBAPJ,SAOI,WAAA,eAAA,cAAA,eAPJ,SAOI,WAAA,iBAAA,cAAA,iBAPJ,SAOI,WAAA,eAAA,cAAA,eAPJ,YAOI,WAAA,eAAA,cAAA,eAPJ,SAOI,WAAA,YAPJ,SAOI,WAAA,iBAPJ,SAOI,WAAA,gBAPJ,SAOI,WAAA,eAPJ,SAOI,WAAA,iBAPJ,SAOI,WAAA,eAPJ,YAOI,WAAA,eAPJ,SAOI,aAAA,YAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,gBAPJ,SAOI,aAAA,eAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,eAPJ,YAOI,aAAA,eAPJ,SAOI,cAAA,YAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,gBAPJ,SAOI,cAAA,eAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,eAPJ,YAOI,cAAA,eAPJ,SAOI,YAAA,YAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,gBAPJ,SAOI,YAAA,eAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,eAPJ,YAOI,YAAA,eAPJ,QAOI,QAAA,YAPJ,QAOI,QAAA,iBAPJ,QAOI,QAAA,gBAPJ,QAOI,QAAA,eAPJ,QAOI,QAAA,iBAPJ,QAOI,QAAA,eAPJ,SAOI,cAAA,YAAA,aAAA,YAPJ,SAOI,cAAA,iBAAA,aAAA,iBAPJ,SAOI,cAAA,gBAAA,aAAA,gBAPJ,SAOI,cAAA,eAAA,aAAA,eAPJ,SAOI,cAAA,iBAAA,aAAA,iBAPJ,SAOI,cAAA,eAAA,aAAA,eAPJ,SAOI,YAAA,YAAA,eAAA,YAPJ,SAOI,YAAA,iBAAA,eAAA,iBAPJ,SAOI,YAAA,gBAAA,eAAA,gBAPJ,SAOI,YAAA,eAAA,eAAA,eAPJ,SAOI,YAAA,iBAAA,eAAA,iBAPJ,SAOI,YAAA,eAAA,eAAA,eAPJ,SAOI,YAAA,YAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,gBAPJ,SAOI,YAAA,eAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,eAPJ,SAOI,cAAA,YAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,gBAPJ,SAOI,cAAA,eAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,eAPJ,SAOI,eAAA,YAPJ,SAOI,eAAA,iBAPJ,SAOI,eAAA,gBAPJ,SAOI,eAAA,eAPJ,SAOI,eAAA,iBAPJ,SAOI,eAAA,eAPJ,SAOI,aAAA,YAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,gBAPJ,SAOI,aAAA,eAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,eAPJ,eAOI,WAAA,eAPJ,aAOI,WAAA,gBAPJ,gBAOI,WAAA,kBzDPR,yByDAI,gBAOI,MAAA,eAPJ,cAOI,MAAA,gBAPJ,eAOI,MAAA,eAPJ,aAOI,QAAA,iBAPJ,mBAOI,QAAA,uBAPJ,YAOI,QAAA,gBAPJ,WAOI,QAAA,eAPJ,YAOI,QAAA,gBAPJ,gBAOI,QAAA,oBAPJ,iBAOI,QAAA,qBAPJ,WAOI,QAAA,eAPJ,kBAOI,QAAA,sBAPJ,WAOI,QAAA,eAPJ,cAOI,KAAA,EAAA,EAAA,eAPJ,aAOI,eAAA,cAPJ,gBAOI,eAAA,iBAPJ,qBAOI,eAAA,sBAPJ,wBAOI,eAAA,yBAPJ,gBAOI,UAAA,YAPJ,gBAOI,UAAA,YAPJ,kBAOI,YAAA,YAPJ,kBAOI,YAAA,YAPJ,cAOI,UAAA,eAPJ,gBAOI,UAAA,iBAPJ,sBAOI,UAAA,uBAPJ,UAOI,IAAA,YAPJ,UAOI,IAAA,iBAPJ,UAOI,IAAA,gBAPJ,UAOI,IAAA,eAPJ,UAOI,IAAA,iBAPJ,UAOI,IAAA,eAPJ,0BAOI,gBAAA,qBAPJ,wBAOI,gBAAA,mBAPJ,2BAOI,gBAAA,iBAPJ,4BAOI,gBAAA,wBAPJ,2BAOI,gBAAA,uBAPJ,2BAOI,gBAAA,uBAPJ,sBAOI,YAAA,qBAPJ,oBAOI,YAAA,mBAPJ,uBAOI,YAAA,iBAPJ,yBAOI,YAAA,mBAPJ,wBAOI,YAAA,kBAPJ,wBAOI,cAAA,qBAPJ,sBAOI,cAAA,mBAPJ,yBAOI,cAAA,iBAPJ,0BAOI,cAAA,wBAPJ,yBAOI,cAAA,uBAPJ,0BAOI,cAAA,kBAPJ,oBAOI,WAAA,eAPJ,qBAOI,WAAA,qBAPJ,mBAOI,WAAA,mBAPJ,sBAOI,WAAA,iBAPJ,wBAOI,WAAA,mBAPJ,uBAOI,WAAA,kBAPJ,gBAOI,MAAA,aAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,eAOI,MAAA,YAPJ,QAOI,OAAA,YAPJ,QAOI,OAAA,iBAPJ,QAOI,OAAA,gBAPJ,QAOI,OAAA,eAPJ,QAOI,OAAA,iBAPJ,QAOI,OAAA,eAPJ,WAOI,OAAA,eAPJ,SAOI,aAAA,YAAA,YAAA,YAPJ,SAOI,aAAA,iBAAA,YAAA,iBAPJ,SAOI,aAAA,gBAAA,YAAA,gBAPJ,SAOI,aAAA,eAAA,YAAA,eAPJ,SAOI,aAAA,iBAAA,YAAA,iBAPJ,SAOI,aAAA,eAAA,YAAA,eAPJ,YAOI,aAAA,eAAA,YAAA,eAPJ,SAOI,WAAA,YAAA,cAAA,YAPJ,SAOI,WAAA,iBAAA,cAAA,iBAPJ,SAOI,WAAA,gBAAA,cAAA,gBAPJ,SAOI,WAAA,eAAA,cAAA,eAPJ,SAOI,WAAA,iBAAA,cAAA,iBAPJ,SAOI,WAAA,eAAA,cAAA,eAPJ,YAOI,WAAA,eAAA,cAAA,eAPJ,SAOI,WAAA,YAPJ,SAOI,WAAA,iBAPJ,SAOI,WAAA,gBAPJ,SAOI,WAAA,eAPJ,SAOI,WAAA,iBAPJ,SAOI,WAAA,eAPJ,YAOI,WAAA,eAPJ,SAOI,aAAA,YAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,gBAPJ,SAOI,aAAA,eAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,eAPJ,YAOI,aAAA,eAPJ,SAOI,cAAA,YAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,gBAPJ,SAOI,cAAA,eAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,eAPJ,YAOI,cAAA,eAPJ,SAOI,YAAA,YAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,gBAPJ,SAOI,YAAA,eAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,eAPJ,YAOI,YAAA,eAPJ,QAOI,QAAA,YAPJ,QAOI,QAAA,iBAPJ,QAOI,QAAA,gBAPJ,QAOI,QAAA,eAPJ,QAOI,QAAA,iBAPJ,QAOI,QAAA,eAPJ,SAOI,cAAA,YAAA,aAAA,YAPJ,SAOI,cAAA,iBAAA,aAAA,iBAPJ,SAOI,cAAA,gBAAA,aAAA,gBAPJ,SAOI,cAAA,eAAA,aAAA,eAPJ,SAOI,cAAA,iBAAA,aAAA,iBAPJ,SAOI,cAAA,eAAA,aAAA,eAPJ,SAOI,YAAA,YAAA,eAAA,YAPJ,SAOI,YAAA,iBAAA,eAAA,iBAPJ,SAOI,YAAA,gBAAA,eAAA,gBAPJ,SAOI,YAAA,eAAA,eAAA,eAPJ,SAOI,YAAA,iBAAA,eAAA,iBAPJ,SAOI,YAAA,eAAA,eAAA,eAPJ,SAOI,YAAA,YAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,gBAPJ,SAOI,YAAA,eAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,eAPJ,SAOI,cAAA,YAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,gBAPJ,SAOI,cAAA,eAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,eAPJ,SAOI,eAAA,YAPJ,SAOI,eAAA,iBAPJ,SAOI,eAAA,gBAPJ,SAOI,eAAA,eAPJ,SAOI,eAAA,iBAPJ,SAOI,eAAA,eAPJ,SAOI,aAAA,YAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,gBAPJ,SAOI,aAAA,eAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,eAPJ,eAOI,WAAA,eAPJ,aAOI,WAAA,gBAPJ,gBAOI,WAAA,kBzDPR,yByDAI,gBAOI,MAAA,eAPJ,cAOI,MAAA,gBAPJ,eAOI,MAAA,eAPJ,aAOI,QAAA,iBAPJ,mBAOI,QAAA,uBAPJ,YAOI,QAAA,gBAPJ,WAOI,QAAA,eAPJ,YAOI,QAAA,gBAPJ,gBAOI,QAAA,oBAPJ,iBAOI,QAAA,qBAPJ,WAOI,QAAA,eAPJ,kBAOI,QAAA,sBAPJ,WAOI,QAAA,eAPJ,cAOI,KAAA,EAAA,EAAA,eAPJ,aAOI,eAAA,cAPJ,gBAOI,eAAA,iBAPJ,qBAOI,eAAA,sBAPJ,wBAOI,eAAA,yBAPJ,gBAOI,UAAA,YAPJ,gBAOI,UAAA,YAPJ,kBAOI,YAAA,YAPJ,kBAOI,YAAA,YAPJ,cAOI,UAAA,eAPJ,gBAOI,UAAA,iBAPJ,sBAOI,UAAA,uBAPJ,UAOI,IAAA,YAPJ,UAOI,IAAA,iBAPJ,UAOI,IAAA,gBAPJ,UAOI,IAAA,eAPJ,UAOI,IAAA,iBAPJ,UAOI,IAAA,eAPJ,0BAOI,gBAAA,qBAPJ,wBAOI,gBAAA,mBAPJ,2BAOI,gBAAA,iBAPJ,4BAOI,gBAAA,wBAPJ,2BAOI,gBAAA,uBAPJ,2BAOI,gBAAA,uBAPJ,sBAOI,YAAA,qBAPJ,oBAOI,YAAA,mBAPJ,uBAOI,YAAA,iBAPJ,yBAOI,YAAA,mBAPJ,wBAOI,YAAA,kBAPJ,wBAOI,cAAA,qBAPJ,sBAOI,cAAA,mBAPJ,yBAOI,cAAA,iBAPJ,0BAOI,cAAA,wBAPJ,yBAOI,cAAA,uBAPJ,0BAOI,cAAA,kBAPJ,oBAOI,WAAA,eAPJ,qBAOI,WAAA,qBAPJ,mBAOI,WAAA,mBAPJ,sBAOI,WAAA,iBAPJ,wBAOI,WAAA,mBAPJ,uBAOI,WAAA,kBAPJ,gBAOI,MAAA,aAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,eAOI,MAAA,YAPJ,QAOI,OAAA,YAPJ,QAOI,OAAA,iBAPJ,QAOI,OAAA,gBAPJ,QAOI,OAAA,eAPJ,QAOI,OAAA,iBAPJ,QAOI,OAAA,eAPJ,WAOI,OAAA,eAPJ,SAOI,aAAA,YAAA,YAAA,YAPJ,SAOI,aAAA,iBAAA,YAAA,iBAPJ,SAOI,aAAA,gBAAA,YAAA,gBAPJ,SAOI,aAAA,eAAA,YAAA,eAPJ,SAOI,aAAA,iBAAA,YAAA,iBAPJ,SAOI,aAAA,eAAA,YAAA,eAPJ,YAOI,aAAA,eAAA,YAAA,eAPJ,SAOI,WAAA,YAAA,cAAA,YAPJ,SAOI,WAAA,iBAAA,cAAA,iBAPJ,SAOI,WAAA,gBAAA,cAAA,gBAPJ,SAOI,WAAA,eAAA,cAAA,eAPJ,SAOI,WAAA,iBAAA,cAAA,iBAPJ,SAOI,WAAA,eAAA,cAAA,eAPJ,YAOI,WAAA,eAAA,cAAA,eAPJ,SAOI,WAAA,YAPJ,SAOI,WAAA,iBAPJ,SAOI,WAAA,gBAPJ,SAOI,WAAA,eAPJ,SAOI,WAAA,iBAPJ,SAOI,WAAA,eAPJ,YAOI,WAAA,eAPJ,SAOI,aAAA,YAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,gBAPJ,SAOI,aAAA,eAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,eAPJ,YAOI,aAAA,eAPJ,SAOI,cAAA,YAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,gBAPJ,SAOI,cAAA,eAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,eAPJ,YAOI,cAAA,eAPJ,SAOI,YAAA,YAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,gBAPJ,SAOI,YAAA,eAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,eAPJ,YAOI,YAAA,eAPJ,QAOI,QAAA,YAPJ,QAOI,QAAA,iBAPJ,QAOI,QAAA,gBAPJ,QAOI,QAAA,eAPJ,QAOI,QAAA,iBAPJ,QAOI,QAAA,eAPJ,SAOI,cAAA,YAAA,aAAA,YAPJ,SAOI,cAAA,iBAAA,aAAA,iBAPJ,SAOI,cAAA,gBAAA,aAAA,gBAPJ,SAOI,cAAA,eAAA,aAAA,eAPJ,SAOI,cAAA,iBAAA,aAAA,iBAPJ,SAOI,cAAA,eAAA,aAAA,eAPJ,SAOI,YAAA,YAAA,eAAA,YAPJ,SAOI,YAAA,iBAAA,eAAA,iBAPJ,SAOI,YAAA,gBAAA,eAAA,gBAPJ,SAOI,YAAA,eAAA,eAAA,eAPJ,SAOI,YAAA,iBAAA,eAAA,iBAPJ,SAOI,YAAA,eAAA,eAAA,eAPJ,SAOI,YAAA,YAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,gBAPJ,SAOI,YAAA,eAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,eAPJ,SAOI,cAAA,YAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,gBAPJ,SAOI,cAAA,eAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,eAPJ,SAOI,eAAA,YAPJ,SAOI,eAAA,iBAPJ,SAOI,eAAA,gBAPJ,SAOI,eAAA,eAPJ,SAOI,eAAA,iBAPJ,SAOI,eAAA,eAPJ,SAOI,aAAA,YAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,gBAPJ,SAOI,aAAA,eAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,eAPJ,eAOI,WAAA,eAPJ,aAOI,WAAA,gBAPJ,gBAOI,WAAA,kBzDPR,0ByDAI,gBAOI,MAAA,eAPJ,cAOI,MAAA,gBAPJ,eAOI,MAAA,eAPJ,aAOI,QAAA,iBAPJ,mBAOI,QAAA,uBAPJ,YAOI,QAAA,gBAPJ,WAOI,QAAA,eAPJ,YAOI,QAAA,gBAPJ,gBAOI,QAAA,oBAPJ,iBAOI,QAAA,qBAPJ,WAOI,QAAA,eAPJ,kBAOI,QAAA,sBAPJ,WAOI,QAAA,eAPJ,cAOI,KAAA,EAAA,EAAA,eAPJ,aAOI,eAAA,cAPJ,gBAOI,eAAA,iBAPJ,qBAOI,eAAA,sBAPJ,wBAOI,eAAA,yBAPJ,gBAOI,UAAA,YAPJ,gBAOI,UAAA,YAPJ,kBAOI,YAAA,YAPJ,kBAOI,YAAA,YAPJ,cAOI,UAAA,eAPJ,gBAOI,UAAA,iBAPJ,sBAOI,UAAA,uBAPJ,UAOI,IAAA,YAPJ,UAOI,IAAA,iBAPJ,UAOI,IAAA,gBAPJ,UAOI,IAAA,eAPJ,UAOI,IAAA,iBAPJ,UAOI,IAAA,eAPJ,0BAOI,gBAAA,qBAPJ,wBAOI,gBAAA,mBAPJ,2BAOI,gBAAA,iBAPJ,4BAOI,gBAAA,wBAPJ,2BAOI,gBAAA,uBAPJ,2BAOI,gBAAA,uBAPJ,sBAOI,YAAA,qBAPJ,oBAOI,YAAA,mBAPJ,uBAOI,YAAA,iBAPJ,yBAOI,YAAA,mBAPJ,wBAOI,YAAA,kBAPJ,wBAOI,cAAA,qBAPJ,sBAOI,cAAA,mBAPJ,yBAOI,cAAA,iBAPJ,0BAOI,cAAA,wBAPJ,yBAOI,cAAA,uBAPJ,0BAOI,cAAA,kBAPJ,oBAOI,WAAA,eAPJ,qBAOI,WAAA,qBAPJ,mBAOI,WAAA,mBAPJ,sBAOI,WAAA,iBAPJ,wBAOI,WAAA,mBAPJ,uBAOI,WAAA,kBAPJ,gBAOI,MAAA,aAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,YAOI,MAAA,YAPJ,eAOI,MAAA,YAPJ,QAOI,OAAA,YAPJ,QAOI,OAAA,iBAPJ,QAOI,OAAA,gBAPJ,QAOI,OAAA,eAPJ,QAOI,OAAA,iBAPJ,QAOI,OAAA,eAPJ,WAOI,OAAA,eAPJ,SAOI,aAAA,YAAA,YAAA,YAPJ,SAOI,aAAA,iBAAA,YAAA,iBAPJ,SAOI,aAAA,gBAAA,YAAA,gBAPJ,SAOI,aAAA,eAAA,YAAA,eAPJ,SAOI,aAAA,iBAAA,YAAA,iBAPJ,SAOI,aAAA,eAAA,YAAA,eAPJ,YAOI,aAAA,eAAA,YAAA,eAPJ,SAOI,WAAA,YAAA,cAAA,YAPJ,SAOI,WAAA,iBAAA,cAAA,iBAPJ,SAOI,WAAA,gBAAA,cAAA,gBAPJ,SAOI,WAAA,eAAA,cAAA,eAPJ,SAOI,WAAA,iBAAA,cAAA,iBAPJ,SAOI,WAAA,eAAA,cAAA,eAPJ,YAOI,WAAA,eAAA,cAAA,eAPJ,SAOI,WAAA,YAPJ,SAOI,WAAA,iBAPJ,SAOI,WAAA,gBAPJ,SAOI,WAAA,eAPJ,SAOI,WAAA,iBAPJ,SAOI,WAAA,eAPJ,YAOI,WAAA,eAPJ,SAOI,aAAA,YAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,gBAPJ,SAOI,aAAA,eAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,eAPJ,YAOI,aAAA,eAPJ,SAOI,cAAA,YAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,gBAPJ,SAOI,cAAA,eAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,eAPJ,YAOI,cAAA,eAPJ,SAOI,YAAA,YAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,gBAPJ,SAOI,YAAA,eAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,eAPJ,YAOI,YAAA,eAPJ,QAOI,QAAA,YAPJ,QAOI,QAAA,iBAPJ,QAOI,QAAA,gBAPJ,QAOI,QAAA,eAPJ,QAOI,QAAA,iBAPJ,QAOI,QAAA,eAPJ,SAOI,cAAA,YAAA,aAAA,YAPJ,SAOI,cAAA,iBAAA,aAAA,iBAPJ,SAOI,cAAA,gBAAA,aAAA,gBAPJ,SAOI,cAAA,eAAA,aAAA,eAPJ,SAOI,cAAA,iBAAA,aAAA,iBAPJ,SAOI,cAAA,eAAA,aAAA,eAPJ,SAOI,YAAA,YAAA,eAAA,YAPJ,SAOI,YAAA,iBAAA,eAAA,iBAPJ,SAOI,YAAA,gBAAA,eAAA,gBAPJ,SAOI,YAAA,eAAA,eAAA,eAPJ,SAOI,YAAA,iBAAA,eAAA,iBAPJ,SAOI,YAAA,eAAA,eAAA,eAPJ,SAOI,YAAA,YAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,gBAPJ,SAOI,YAAA,eAPJ,SAOI,YAAA,iBAPJ,SAOI,YAAA,eAPJ,SAOI,cAAA,YAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,gBAPJ,SAOI,cAAA,eAPJ,SAOI,cAAA,iBAPJ,SAOI,cAAA,eAPJ,SAOI,eAAA,YAPJ,SAOI,eAAA,iBAPJ,SAOI,eAAA,gBAPJ,SAOI,eAAA,eAPJ,SAOI,eAAA,iBAPJ,SAOI,eAAA,eAPJ,SAOI,aAAA,YAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,gBAPJ,SAOI,aAAA,eAPJ,SAOI,aAAA,iBAPJ,SAOI,aAAA,eAPJ,eAOI,WAAA,eAPJ,aAOI,WAAA,gBAPJ,gBAOI,WAAA,kBzDPR,0ByDAI,iBAOI,MAAA,eAPJ,eAOI,MAAA,gBAPJ,gBAOI,MAAA,eAPJ,cAOI,QAAA,iBAPJ,oBAOI,QAAA,uBAPJ,aAOI,QAAA,gBAPJ,YAOI,QAAA,eAPJ,aAOI,QAAA,gBAPJ,iBAOI,QAAA,oBAPJ,kBAOI,QAAA,qBAPJ,YAOI,QAAA,eAPJ,mBAOI,QAAA,sBAPJ,YAOI,QAAA,eAPJ,eAOI,KAAA,EAAA,EAAA,eAPJ,cAOI,eAAA,cAPJ,iBAOI,eAAA,iBAPJ,sBAOI,eAAA,sBAPJ,yBAOI,eAAA,yBAPJ,iBAOI,UAAA,YAPJ,iBAOI,UAAA,YAPJ,mBAOI,YAAA,YAPJ,mBAOI,YAAA,YAPJ,eAOI,UAAA,eAPJ,iBAOI,UAAA,iBAPJ,uBAOI,UAAA,uBAPJ,WAOI,IAAA,YAPJ,WAOI,IAAA,iBAPJ,WAOI,IAAA,gBAPJ,WAOI,IAAA,eAPJ,WAOI,IAAA,iBAPJ,WAOI,IAAA,eAPJ,2BAOI,gBAAA,qBAPJ,yBAOI,gBAAA,mBAPJ,4BAOI,gBAAA,iBAPJ,6BAOI,gBAAA,wBAPJ,4BAOI,gBAAA,uBAPJ,4BAOI,gBAAA,uBAPJ,uBAOI,YAAA,qBAPJ,qBAOI,YAAA,mBAPJ,wBAOI,YAAA,iBAPJ,0BAOI,YAAA,mBAPJ,yBAOI,YAAA,kBAPJ,yBAOI,cAAA,qBAPJ,uBAOI,cAAA,mBAPJ,0BAOI,cAAA,iBAPJ,2BAOI,cAAA,wBAPJ,0BAOI,cAAA,uBAPJ,2BAOI,cAAA,kBAPJ,qBAOI,WAAA,eAPJ,sBAOI,WAAA,qBAPJ,oBAOI,WAAA,mBAPJ,uBAOI,WAAA,iBAPJ,yBAOI,WAAA,mBAPJ,wBAOI,WAAA,kBAPJ,iBAOI,MAAA,aAPJ,aAOI,MAAA,YAPJ,aAOI,MAAA,YAPJ,aAOI,MAAA,YAPJ,aAOI,MAAA,YAPJ,aAOI,MAAA,YAPJ,aAOI,MAAA,YAPJ,gBAOI,MAAA,YAPJ,SAOI,OAAA,YAPJ,SAOI,OAAA,iBAPJ,SAOI,OAAA,gBAPJ,SAOI,OAAA,eAPJ,SAOI,OAAA,iBAPJ,SAOI,OAAA,eAPJ,YAOI,OAAA,eAPJ,UAOI,aAAA,YAAA,YAAA,YAPJ,UAOI,aAAA,iBAAA,YAAA,iBAPJ,UAOI,aAAA,gBAAA,YAAA,gBAPJ,UAOI,aAAA,eAAA,YAAA,eAPJ,UAOI,aAAA,iBAAA,YAAA,iBAPJ,UAOI,aAAA,eAAA,YAAA,eAPJ,aAOI,aAAA,eAAA,YAAA,eAPJ,UAOI,WAAA,YAAA,cAAA,YAPJ,UAOI,WAAA,iBAAA,cAAA,iBAPJ,UAOI,WAAA,gBAAA,cAAA,gBAPJ,UAOI,WAAA,eAAA,cAAA,eAPJ,UAOI,WAAA,iBAAA,cAAA,iBAPJ,UAOI,WAAA,eAAA,cAAA,eAPJ,aAOI,WAAA,eAAA,cAAA,eAPJ,UAOI,WAAA,YAPJ,UAOI,WAAA,iBAPJ,UAOI,WAAA,gBAPJ,UAOI,WAAA,eAPJ,UAOI,WAAA,iBAPJ,UAOI,WAAA,eAPJ,aAOI,WAAA,eAPJ,UAOI,aAAA,YAPJ,UAOI,aAAA,iBAPJ,UAOI,aAAA,gBAPJ,UAOI,aAAA,eAPJ,UAOI,aAAA,iBAPJ,UAOI,aAAA,eAPJ,aAOI,aAAA,eAPJ,UAOI,cAAA,YAPJ,UAOI,cAAA,iBAPJ,UAOI,cAAA,gBAPJ,UAOI,cAAA,eAPJ,UAOI,cAAA,iBAPJ,UAOI,cAAA,eAPJ,aAOI,cAAA,eAPJ,UAOI,YAAA,YAPJ,UAOI,YAAA,iBAPJ,UAOI,YAAA,gBAPJ,UAOI,YAAA,eAPJ,UAOI,YAAA,iBAPJ,UAOI,YAAA,eAPJ,aAOI,YAAA,eAPJ,SAOI,QAAA,YAPJ,SAOI,QAAA,iBAPJ,SAOI,QAAA,gBAPJ,SAOI,QAAA,eAPJ,SAOI,QAAA,iBAPJ,SAOI,QAAA,eAPJ,UAOI,cAAA,YAAA,aAAA,YAPJ,UAOI,cAAA,iBAAA,aAAA,iBAPJ,UAOI,cAAA,gBAAA,aAAA,gBAPJ,UAOI,cAAA,eAAA,aAAA,eAPJ,UAOI,cAAA,iBAAA,aAAA,iBAPJ,UAOI,cAAA,eAAA,aAAA,eAPJ,UAOI,YAAA,YAAA,eAAA,YAPJ,UAOI,YAAA,iBAAA,eAAA,iBAPJ,UAOI,YAAA,gBAAA,eAAA,gBAPJ,UAOI,YAAA,eAAA,eAAA,eAPJ,UAOI,YAAA,iBAAA,eAAA,iBAPJ,UAOI,YAAA,eAAA,eAAA,eAPJ,UAOI,YAAA,YAPJ,UAOI,YAAA,iBAPJ,UAOI,YAAA,gBAPJ,UAOI,YAAA,eAPJ,UAOI,YAAA,iBAPJ,UAOI,YAAA,eAPJ,UAOI,cAAA,YAPJ,UAOI,cAAA,iBAPJ,UAOI,cAAA,gBAPJ,UAOI,cAAA,eAPJ,UAOI,cAAA,iBAPJ,UAOI,cAAA,eAPJ,UAOI,eAAA,YAPJ,UAOI,eAAA,iBAPJ,UAOI,eAAA,gBAPJ,UAOI,eAAA,eAPJ,UAOI,eAAA,iBAPJ,UAOI,eAAA,eAPJ,UAOI,aAAA,YAPJ,UAOI,aAAA,iBAPJ,UAOI,aAAA,gBAPJ,UAOI,aAAA,eAPJ,UAOI,aAAA,iBAPJ,UAOI,aAAA,eAPJ,gBAOI,WAAA,eAPJ,cAOI,WAAA,gBAPJ,iBAOI,WAAA,kBCnDZ,0BD4CQ,MAOI,UAAA,iBAPJ,MAOI,UAAA,eAPJ,MAOI,UAAA,kBAPJ,MAOI,UAAA,kBChCZ,aDyBQ,gBAOI,QAAA,iBAPJ,sBAOI,QAAA,uBAPJ,eAOI,QAAA,gBAPJ,cAOI,QAAA,eAPJ,eAOI,QAAA,gBAPJ,mBAOI,QAAA,oBAPJ,oBAOI,QAAA,qBAPJ,cAOI,QAAA,eAPJ,qBAOI,QAAA,sBAPJ,cAOI,QAAA","sourcesContent":["/*!\n * Bootstrap v5.1.0 (https://getbootstrap.com/)\n * Copyright 2011-2021 The Bootstrap Authors\n * Copyright 2011-2021 Twitter, Inc.\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n */\n\n// scss-docs-start import-stack\n// Configuration\n@import \"functions\";\n@import \"variables\";\n@import \"mixins\";\n@import \"utilities\";\n\n// Layout & components\n@import \"root\";\n@import \"reboot\";\n@import \"type\";\n@import \"images\";\n@import \"containers\";\n@import \"grid\";\n@import \"tables\";\n@import \"forms\";\n@import \"buttons\";\n@import \"transitions\";\n@import \"dropdown\";\n@import \"button-group\";\n@import \"nav\";\n@import \"navbar\";\n@import \"card\";\n@import \"accordion\";\n@import \"breadcrumb\";\n@import \"pagination\";\n@import \"badge\";\n@import \"alert\";\n@import \"progress\";\n@import \"list-group\";\n@import \"close\";\n@import \"toasts\";\n@import \"modal\";\n@import \"tooltip\";\n@import \"popover\";\n@import \"carousel\";\n@import \"spinners\";\n@import \"offcanvas\";\n@import \"placeholders\";\n\n// Helpers\n@import \"helpers\";\n\n// Utilities\n@import \"utilities/api\";\n// scss-docs-end import-stack\n",":root {\n  // Note: Custom variable values only support SassScript inside `#{}`.\n\n  // Colors\n  //\n  // Generate palettes for full colors, grays, and theme colors.\n\n  @each $color, $value in $colors {\n    --#{$variable-prefix}#{$color}: #{$value};\n  }\n\n  @each $color, $value in $grays {\n    --#{$variable-prefix}gray-#{$color}: #{$value};\n  }\n\n  @each $color, $value in $theme-colors {\n    --#{$variable-prefix}#{$color}: #{$value};\n  }\n\n  @each $color, $value in $theme-colors-rgb {\n    --#{$variable-prefix}#{$color}-rgb: #{$value};\n  }\n\n  --#{$variable-prefix}white-rgb: #{to-rgb($white)};\n  --#{$variable-prefix}black-rgb: #{to-rgb($black)};\n  --#{$variable-prefix}body-rgb: #{to-rgb($body-color)};\n\n  // Fonts\n\n  // Note: Use `inspect` for lists so that quoted items keep the quotes.\n  // See https://github.com/sass/sass/issues/2383#issuecomment-336349172\n  --#{$variable-prefix}font-sans-serif: #{inspect($font-family-sans-serif)};\n  --#{$variable-prefix}font-monospace: #{inspect($font-family-monospace)};\n  --#{$variable-prefix}gradient: #{$gradient};\n\n  // Root and body\n  // stylelint-disable custom-property-empty-line-before\n  // scss-docs-start root-body-variables\n  @if $font-size-root != null {\n    --#{$variable-prefix}root-font-size: #{$font-size-root};\n  }\n  --#{$variable-prefix}body-font-family: #{$font-family-base};\n  --#{$variable-prefix}body-font-size: #{$font-size-base};\n  --#{$variable-prefix}body-font-weight: #{$font-weight-base};\n  --#{$variable-prefix}body-line-height: #{$line-height-base};\n  --#{$variable-prefix}body-color: #{$body-color};\n  @if $body-text-align != null {\n    --#{$variable-prefix}body-text-align: #{$body-text-align};\n  }\n  --#{$variable-prefix}body-bg: #{$body-bg};\n  // scss-docs-end root-body-variables\n  // stylelint-enable custom-property-empty-line-before\n}\n","// stylelint-disable declaration-no-important, selector-no-qualifying-type, property-no-vendor-prefix\n\n\n// Reboot\n//\n// Normalization of HTML elements, manually forked from Normalize.css to remove\n// styles targeting irrelevant browsers while applying new styles.\n//\n// Normalize is licensed MIT. https://github.com/necolas/normalize.css\n\n\n// Document\n//\n// Change from `box-sizing: content-box` so that `width` is not affected by `padding` or `border`.\n\n*,\n*::before,\n*::after {\n  box-sizing: border-box;\n}\n\n\n// Root\n//\n// Ability to the value of the root font sizes, affecting the value of `rem`.\n// null by default, thus nothing is generated.\n\n:root {\n  @if $font-size-root != null {\n    font-size: var(--#{$variable-prefix}-root-font-size);\n  }\n\n  @if $enable-smooth-scroll {\n    @media (prefers-reduced-motion: no-preference) {\n      scroll-behavior: smooth;\n    }\n  }\n}\n\n\n// Body\n//\n// 1. Remove the margin in all browsers.\n// 2. As a best practice, apply a default `background-color`.\n// 3. Prevent adjustments of font size after orientation changes in iOS.\n// 4. Change the default tap highlight to be completely transparent in iOS.\n\n// scss-docs-start reboot-body-rules\nbody {\n  margin: 0; // 1\n  font-family: var(--#{$variable-prefix}body-font-family);\n  @include font-size(var(--#{$variable-prefix}body-font-size));\n  font-weight: var(--#{$variable-prefix}body-font-weight);\n  line-height: var(--#{$variable-prefix}body-line-height);\n  color: var(--#{$variable-prefix}body-color);\n  text-align: var(--#{$variable-prefix}body-text-align);\n  background-color: var(--#{$variable-prefix}body-bg); // 2\n  -webkit-text-size-adjust: 100%; // 3\n  -webkit-tap-highlight-color: rgba($black, 0); // 4\n}\n// scss-docs-end reboot-body-rules\n\n\n// Content grouping\n//\n// 1. Reset Firefox's gray color\n// 2. Set correct height and prevent the `size` attribute to make the `hr` look like an input field\n\nhr {\n  margin: $hr-margin-y 0;\n  color: $hr-color; // 1\n  background-color: currentColor;\n  border: 0;\n  opacity: $hr-opacity;\n}\n\nhr:not([size]) {\n  height: $hr-height; // 2\n}\n\n\n// Typography\n//\n// 1. Remove top margins from headings\n//    By default, `<h1>`-`<h6>` all receive top and bottom margins. We nuke the top\n//    margin for easier control within type scales as it avoids margin collapsing.\n\n%heading {\n  margin-top: 0; // 1\n  margin-bottom: $headings-margin-bottom;\n  font-family: $headings-font-family;\n  font-style: $headings-font-style;\n  font-weight: $headings-font-weight;\n  line-height: $headings-line-height;\n  color: $headings-color;\n}\n\nh1 {\n  @extend %heading;\n  @include font-size($h1-font-size);\n}\n\nh2 {\n  @extend %heading;\n  @include font-size($h2-font-size);\n}\n\nh3 {\n  @extend %heading;\n  @include font-size($h3-font-size);\n}\n\nh4 {\n  @extend %heading;\n  @include font-size($h4-font-size);\n}\n\nh5 {\n  @extend %heading;\n  @include font-size($h5-font-size);\n}\n\nh6 {\n  @extend %heading;\n  @include font-size($h6-font-size);\n}\n\n\n// Reset margins on paragraphs\n//\n// Similarly, the top margin on `<p>`s get reset. However, we also reset the\n// bottom margin to use `rem` units instead of `em`.\n\np {\n  margin-top: 0;\n  margin-bottom: $paragraph-margin-bottom;\n}\n\n\n// Abbreviations\n//\n// 1. Duplicate behavior to the data-bs-* attribute for our tooltip plugin\n// 2. Add the correct text decoration in Chrome, Edge, Opera, and Safari.\n// 3. Add explicit cursor to indicate changed behavior.\n// 4. Prevent the text-decoration to be skipped.\n\nabbr[title],\nabbr[data-bs-original-title] { // 1\n  text-decoration: underline dotted; // 2\n  cursor: help; // 3\n  text-decoration-skip-ink: none; // 4\n}\n\n\n// Address\n\naddress {\n  margin-bottom: 1rem;\n  font-style: normal;\n  line-height: inherit;\n}\n\n\n// Lists\n\nol,\nul {\n  padding-left: 2rem;\n}\n\nol,\nul,\ndl {\n  margin-top: 0;\n  margin-bottom: 1rem;\n}\n\nol ol,\nul ul,\nol ul,\nul ol {\n  margin-bottom: 0;\n}\n\ndt {\n  font-weight: $dt-font-weight;\n}\n\n// 1. Undo browser default\n\ndd {\n  margin-bottom: .5rem;\n  margin-left: 0; // 1\n}\n\n\n// Blockquote\n\nblockquote {\n  margin: 0 0 1rem;\n}\n\n\n// Strong\n//\n// Add the correct font weight in Chrome, Edge, and Safari\n\nb,\nstrong {\n  font-weight: $font-weight-bolder;\n}\n\n\n// Small\n//\n// Add the correct font size in all browsers\n\nsmall {\n  @include font-size($small-font-size);\n}\n\n\n// Mark\n\nmark {\n  padding: $mark-padding;\n  background-color: $mark-bg;\n}\n\n\n// Sub and Sup\n//\n// Prevent `sub` and `sup` elements from affecting the line height in\n// all browsers.\n\nsub,\nsup {\n  position: relative;\n  @include font-size($sub-sup-font-size);\n  line-height: 0;\n  vertical-align: baseline;\n}\n\nsub { bottom: -.25em; }\nsup { top: -.5em; }\n\n\n// Links\n\na {\n  color: $link-color;\n  text-decoration: $link-decoration;\n\n  &:hover {\n    color: $link-hover-color;\n    text-decoration: $link-hover-decoration;\n  }\n}\n\n// And undo these styles for placeholder links/named anchors (without href).\n// It would be more straightforward to just use a[href] in previous block, but that\n// causes specificity issues in many other styles that are too complex to fix.\n// See https://github.com/twbs/bootstrap/issues/19402\n\na:not([href]):not([class]) {\n  &,\n  &:hover {\n    color: inherit;\n    text-decoration: none;\n  }\n}\n\n\n// Code\n\npre,\ncode,\nkbd,\nsamp {\n  font-family: $font-family-code;\n  @include font-size(1em); // Correct the odd `em` font sizing in all browsers.\n  direction: ltr #{\"/* rtl:ignore */\"};\n  unicode-bidi: bidi-override;\n}\n\n// 1. Remove browser default top margin\n// 2. Reset browser default of `1em` to use `rem`s\n// 3. Don't allow content to break outside\n\npre {\n  display: block;\n  margin-top: 0; // 1\n  margin-bottom: 1rem; // 2\n  overflow: auto; // 3\n  @include font-size($code-font-size);\n  color: $pre-color;\n\n  // Account for some code outputs that place code tags in pre tags\n  code {\n    @include font-size(inherit);\n    color: inherit;\n    word-break: normal;\n  }\n}\n\ncode {\n  @include font-size($code-font-size);\n  color: $code-color;\n  word-wrap: break-word;\n\n  // Streamline the style when inside anchors to avoid broken underline and more\n  a > & {\n    color: inherit;\n  }\n}\n\nkbd {\n  padding: $kbd-padding-y $kbd-padding-x;\n  @include font-size($kbd-font-size);\n  color: $kbd-color;\n  background-color: $kbd-bg;\n  @include border-radius($border-radius-sm);\n\n  kbd {\n    padding: 0;\n    @include font-size(1em);\n    font-weight: $nested-kbd-font-weight;\n  }\n}\n\n\n// Figures\n//\n// Apply a consistent margin strategy (matches our type styles).\n\nfigure {\n  margin: 0 0 1rem;\n}\n\n\n// Images and content\n\nimg,\nsvg {\n  vertical-align: middle;\n}\n\n\n// Tables\n//\n// Prevent double borders\n\ntable {\n  caption-side: bottom;\n  border-collapse: collapse;\n}\n\ncaption {\n  padding-top: $table-cell-padding-y;\n  padding-bottom: $table-cell-padding-y;\n  color: $table-caption-color;\n  text-align: left;\n}\n\n// 1. Removes font-weight bold by inheriting\n// 2. Matches default `<td>` alignment by inheriting `text-align`.\n// 3. Fix alignment for Safari\n\nth {\n  font-weight: $table-th-font-weight; // 1\n  text-align: inherit; // 2\n  text-align: -webkit-match-parent; // 3\n}\n\nthead,\ntbody,\ntfoot,\ntr,\ntd,\nth {\n  border-color: inherit;\n  border-style: solid;\n  border-width: 0;\n}\n\n\n// Forms\n//\n// 1. Allow labels to use `margin` for spacing.\n\nlabel {\n  display: inline-block; // 1\n}\n\n// Remove the default `border-radius` that macOS Chrome adds.\n// See https://github.com/twbs/bootstrap/issues/24093\n\nbutton {\n  // stylelint-disable-next-line property-disallowed-list\n  border-radius: 0;\n}\n\n// Explicitly remove focus outline in Chromium when it shouldn't be\n// visible (e.g. as result of mouse click or touch tap). It already\n// should be doing this automatically, but seems to currently be\n// confused and applies its very visible two-tone outline anyway.\n\nbutton:focus:not(:focus-visible) {\n  outline: 0;\n}\n\n// 1. Remove the margin in Firefox and Safari\n\ninput,\nbutton,\nselect,\noptgroup,\ntextarea {\n  margin: 0; // 1\n  font-family: inherit;\n  @include font-size(inherit);\n  line-height: inherit;\n}\n\n// Remove the inheritance of text transform in Firefox\nbutton,\nselect {\n  text-transform: none;\n}\n// Set the cursor for non-`<button>` buttons\n//\n// Details at https://github.com/twbs/bootstrap/pull/30562\n[role=\"button\"] {\n  cursor: pointer;\n}\n\nselect {\n  // Remove the inheritance of word-wrap in Safari.\n  // See https://github.com/twbs/bootstrap/issues/24990\n  word-wrap: normal;\n\n  // Undo the opacity change from Chrome\n  &:disabled {\n    opacity: 1;\n  }\n}\n\n// Remove the dropdown arrow in Chrome from inputs built with datalists.\n// See https://stackoverflow.com/a/54997118\n\n[list]::-webkit-calendar-picker-indicator {\n  display: none;\n}\n\n// 1. Prevent a WebKit bug where (2) destroys native `audio` and `video`\n//    controls in Android 4.\n// 2. Correct the inability to style clickable types in iOS and Safari.\n// 3. Opinionated: add \"hand\" cursor to non-disabled button elements.\n\nbutton,\n[type=\"button\"], // 1\n[type=\"reset\"],\n[type=\"submit\"] {\n  -webkit-appearance: button; // 2\n\n  @if $enable-button-pointers {\n    &:not(:disabled) {\n      cursor: pointer; // 3\n    }\n  }\n}\n\n// Remove inner border and padding from Firefox, but don't restore the outline like Normalize.\n\n::-moz-focus-inner {\n  padding: 0;\n  border-style: none;\n}\n\n// 1. Textareas should really only resize vertically so they don't break their (horizontal) containers.\n\ntextarea {\n  resize: vertical; // 1\n}\n\n// 1. Browsers set a default `min-width: min-content;` on fieldsets,\n//    unlike e.g. `<div>`s, which have `min-width: 0;` by default.\n//    So we reset that to ensure fieldsets behave more like a standard block element.\n//    See https://github.com/twbs/bootstrap/issues/12359\n//    and https://html.spec.whatwg.org/multipage/#the-fieldset-and-legend-elements\n// 2. Reset the default outline behavior of fieldsets so they don't affect page layout.\n\nfieldset {\n  min-width: 0; // 1\n  padding: 0; // 2\n  margin: 0; // 2\n  border: 0; // 2\n}\n\n// 1. By using `float: left`, the legend will behave like a block element.\n//    This way the border of a fieldset wraps around the legend if present.\n// 2. Fix wrapping bug.\n//    See https://github.com/twbs/bootstrap/issues/29712\n\nlegend {\n  float: left; // 1\n  width: 100%;\n  padding: 0;\n  margin-bottom: $legend-margin-bottom;\n  @include font-size($legend-font-size);\n  font-weight: $legend-font-weight;\n  line-height: inherit;\n\n  + * {\n    clear: left; // 2\n  }\n}\n\n// Fix height of inputs with a type of datetime-local, date, month, week, or time\n// See https://github.com/twbs/bootstrap/issues/18842\n\n::-webkit-datetime-edit-fields-wrapper,\n::-webkit-datetime-edit-text,\n::-webkit-datetime-edit-minute,\n::-webkit-datetime-edit-hour-field,\n::-webkit-datetime-edit-day-field,\n::-webkit-datetime-edit-month-field,\n::-webkit-datetime-edit-year-field {\n  padding: 0;\n}\n\n::-webkit-inner-spin-button {\n  height: auto;\n}\n\n// 1. Correct the outline style in Safari.\n// 2. This overrides the extra rounded corners on search inputs in iOS so that our\n//    `.form-control` class can properly style them. Note that this cannot simply\n//    be added to `.form-control` as it's not specific enough. For details, see\n//    https://github.com/twbs/bootstrap/issues/11586.\n\n[type=\"search\"] {\n  outline-offset: -2px; // 1\n  -webkit-appearance: textfield; // 2\n}\n\n// 1. A few input types should stay LTR\n// See https://rtlstyling.com/posts/rtl-styling#form-inputs\n// 2. RTL only output\n// See https://rtlcss.com/learn/usage-guide/control-directives/#raw\n\n/* rtl:raw:\n[type=\"tel\"],\n[type=\"url\"],\n[type=\"email\"],\n[type=\"number\"] {\n  direction: ltr;\n}\n*/\n\n// Remove the inner padding in Chrome and Safari on macOS.\n\n::-webkit-search-decoration {\n  -webkit-appearance: none;\n}\n\n// Remove padding around color pickers in webkit browsers\n\n::-webkit-color-swatch-wrapper {\n  padding: 0;\n}\n\n\n// Inherit font family and line height for file input buttons\n\n::file-selector-button {\n  font: inherit;\n}\n\n// 1. Change font properties to `inherit`\n// 2. Correct the inability to style clickable types in iOS and Safari.\n\n::-webkit-file-upload-button {\n  font: inherit; // 1\n  -webkit-appearance: button; // 2\n}\n\n// Correct element displays\n\noutput {\n  display: inline-block;\n}\n\n// Remove border from iframe\n\niframe {\n  border: 0;\n}\n\n// Summary\n//\n// 1. Add the correct display in all browsers\n\nsummary {\n  display: list-item; // 1\n  cursor: pointer;\n}\n\n\n// Progress\n//\n// Add the correct vertical alignment in Chrome, Firefox, and Opera.\n\nprogress {\n  vertical-align: baseline;\n}\n\n\n// Hidden attribute\n//\n// Always hide an element with the `hidden` HTML attribute.\n\n[hidden] {\n  display: none !important;\n}\n","@charset \"UTF-8\";\n/*!\n * Bootstrap v5.1.0 (https://getbootstrap.com/)\n * Copyright 2011-2021 The Bootstrap Authors\n * Copyright 2011-2021 Twitter, Inc.\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n */\n:root {\n  --bs-blue: #0d6efd;\n  --bs-indigo: #6610f2;\n  --bs-purple: #6f42c1;\n  --bs-pink: #d63384;\n  --bs-red: #dc3545;\n  --bs-orange: #fd7e14;\n  --bs-yellow: #ffc107;\n  --bs-green: #198754;\n  --bs-teal: #20c997;\n  --bs-cyan: #0dcaf0;\n  --bs-white: #fff;\n  --bs-gray: #6c757d;\n  --bs-gray-dark: #343a40;\n  --bs-gray-100: #f8f9fa;\n  --bs-gray-200: #e9ecef;\n  --bs-gray-300: #dee2e6;\n  --bs-gray-400: #ced4da;\n  --bs-gray-500: #adb5bd;\n  --bs-gray-600: #6c757d;\n  --bs-gray-700: #495057;\n  --bs-gray-800: #343a40;\n  --bs-gray-900: #212529;\n  --bs-primary: #0d6efd;\n  --bs-secondary: #6c757d;\n  --bs-success: #198754;\n  --bs-info: #0dcaf0;\n  --bs-warning: #ffc107;\n  --bs-danger: #dc3545;\n  --bs-light: #f8f9fa;\n  --bs-dark: #212529;\n  --bs-primary-rgb: 13, 110, 253;\n  --bs-secondary-rgb: 108, 117, 125;\n  --bs-success-rgb: 25, 135, 84;\n  --bs-info-rgb: 13, 202, 240;\n  --bs-warning-rgb: 255, 193, 7;\n  --bs-danger-rgb: 220, 53, 69;\n  --bs-light-rgb: 248, 249, 250;\n  --bs-dark-rgb: 33, 37, 41;\n  --bs-white-rgb: 255, 255, 255;\n  --bs-black-rgb: 0, 0, 0;\n  --bs-body-rgb: 33, 37, 41;\n  --bs-font-sans-serif: system-ui, -apple-system, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, \"Noto Sans\", \"Liberation Sans\", sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\", \"Noto Color Emoji\";\n  --bs-font-monospace: SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\", \"Courier New\", monospace;\n  --bs-gradient: linear-gradient(180deg, rgba(255, 255, 255, 0.15), rgba(255, 255, 255, 0));\n  --bs-body-font-family: var(--bs-font-sans-serif);\n  --bs-body-font-size: 1rem;\n  --bs-body-font-weight: 400;\n  --bs-body-line-height: 1.5;\n  --bs-body-color: #212529;\n  --bs-body-bg: #fff;\n}\n\n*,\n*::before,\n*::after {\n  box-sizing: border-box;\n}\n\n@media (prefers-reduced-motion: no-preference) {\n  :root {\n    scroll-behavior: smooth;\n  }\n}\n\nbody {\n  margin: 0;\n  font-family: var(--bs-body-font-family);\n  font-size: var(--bs-body-font-size);\n  font-weight: var(--bs-body-font-weight);\n  line-height: var(--bs-body-line-height);\n  color: var(--bs-body-color);\n  text-align: var(--bs-body-text-align);\n  background-color: var(--bs-body-bg);\n  -webkit-text-size-adjust: 100%;\n  -webkit-tap-highlight-color: rgba(0, 0, 0, 0);\n}\n\nhr {\n  margin: 1rem 0;\n  color: inherit;\n  background-color: currentColor;\n  border: 0;\n  opacity: 0.25;\n}\n\nhr:not([size]) {\n  height: 1px;\n}\n\nh6, .h6, h5, .h5, h4, .h4, h3, .h3, h2, .h2, h1, .h1 {\n  margin-top: 0;\n  margin-bottom: 0.5rem;\n  font-weight: 500;\n  line-height: 1.2;\n}\n\nh1, .h1 {\n  font-size: calc(1.375rem + 1.5vw);\n}\n@media (min-width: 1200px) {\n  h1, .h1 {\n    font-size: 2.5rem;\n  }\n}\n\nh2, .h2 {\n  font-size: calc(1.325rem + 0.9vw);\n}\n@media (min-width: 1200px) {\n  h2, .h2 {\n    font-size: 2rem;\n  }\n}\n\nh3, .h3 {\n  font-size: calc(1.3rem + 0.6vw);\n}\n@media (min-width: 1200px) {\n  h3, .h3 {\n    font-size: 1.75rem;\n  }\n}\n\nh4, .h4 {\n  font-size: calc(1.275rem + 0.3vw);\n}\n@media (min-width: 1200px) {\n  h4, .h4 {\n    font-size: 1.5rem;\n  }\n}\n\nh5, .h5 {\n  font-size: 1.25rem;\n}\n\nh6, .h6 {\n  font-size: 1rem;\n}\n\np {\n  margin-top: 0;\n  margin-bottom: 1rem;\n}\n\nabbr[title],\nabbr[data-bs-original-title] {\n  -webkit-text-decoration: underline dotted;\n  text-decoration: underline dotted;\n  cursor: help;\n  -webkit-text-decoration-skip-ink: none;\n  text-decoration-skip-ink: none;\n}\n\naddress {\n  margin-bottom: 1rem;\n  font-style: normal;\n  line-height: inherit;\n}\n\nol,\nul {\n  padding-left: 2rem;\n}\n\nol,\nul,\ndl {\n  margin-top: 0;\n  margin-bottom: 1rem;\n}\n\nol ol,\nul ul,\nol ul,\nul ol {\n  margin-bottom: 0;\n}\n\ndt {\n  font-weight: 700;\n}\n\ndd {\n  margin-bottom: 0.5rem;\n  margin-left: 0;\n}\n\nblockquote {\n  margin: 0 0 1rem;\n}\n\nb,\nstrong {\n  font-weight: bolder;\n}\n\nsmall, .small {\n  font-size: 0.875em;\n}\n\nmark, .mark {\n  padding: 0.2em;\n  background-color: #fcf8e3;\n}\n\nsub,\nsup {\n  position: relative;\n  font-size: 0.75em;\n  line-height: 0;\n  vertical-align: baseline;\n}\n\nsub {\n  bottom: -0.25em;\n}\n\nsup {\n  top: -0.5em;\n}\n\na {\n  color: #0d6efd;\n  text-decoration: underline;\n}\na:hover {\n  color: #0a58ca;\n}\n\na:not([href]):not([class]), a:not([href]):not([class]):hover {\n  color: inherit;\n  text-decoration: none;\n}\n\npre,\ncode,\nkbd,\nsamp {\n  font-family: var(--bs-font-monospace);\n  font-size: 1em;\n  direction: ltr /* rtl:ignore */;\n  unicode-bidi: bidi-override;\n}\n\npre {\n  display: block;\n  margin-top: 0;\n  margin-bottom: 1rem;\n  overflow: auto;\n  font-size: 0.875em;\n}\npre code {\n  font-size: inherit;\n  color: inherit;\n  word-break: normal;\n}\n\ncode {\n  font-size: 0.875em;\n  color: #d63384;\n  word-wrap: break-word;\n}\na > code {\n  color: inherit;\n}\n\nkbd {\n  padding: 0.2rem 0.4rem;\n  font-size: 0.875em;\n  color: #fff;\n  background-color: #212529;\n  border-radius: 0.2rem;\n}\nkbd kbd {\n  padding: 0;\n  font-size: 1em;\n  font-weight: 700;\n}\n\nfigure {\n  margin: 0 0 1rem;\n}\n\nimg,\nsvg {\n  vertical-align: middle;\n}\n\ntable {\n  caption-side: bottom;\n  border-collapse: collapse;\n}\n\ncaption {\n  padding-top: 0.5rem;\n  padding-bottom: 0.5rem;\n  color: #6c757d;\n  text-align: left;\n}\n\nth {\n  text-align: inherit;\n  text-align: -webkit-match-parent;\n}\n\nthead,\ntbody,\ntfoot,\ntr,\ntd,\nth {\n  border-color: inherit;\n  border-style: solid;\n  border-width: 0;\n}\n\nlabel {\n  display: inline-block;\n}\n\nbutton {\n  border-radius: 0;\n}\n\nbutton:focus:not(:focus-visible) {\n  outline: 0;\n}\n\ninput,\nbutton,\nselect,\noptgroup,\ntextarea {\n  margin: 0;\n  font-family: inherit;\n  font-size: inherit;\n  line-height: inherit;\n}\n\nbutton,\nselect {\n  text-transform: none;\n}\n\n[role=button] {\n  cursor: pointer;\n}\n\nselect {\n  word-wrap: normal;\n}\nselect:disabled {\n  opacity: 1;\n}\n\n[list]::-webkit-calendar-picker-indicator {\n  display: none;\n}\n\nbutton,\n[type=button],\n[type=reset],\n[type=submit] {\n  -webkit-appearance: button;\n}\nbutton:not(:disabled),\n[type=button]:not(:disabled),\n[type=reset]:not(:disabled),\n[type=submit]:not(:disabled) {\n  cursor: pointer;\n}\n\n::-moz-focus-inner {\n  padding: 0;\n  border-style: none;\n}\n\ntextarea {\n  resize: vertical;\n}\n\nfieldset {\n  min-width: 0;\n  padding: 0;\n  margin: 0;\n  border: 0;\n}\n\nlegend {\n  float: left;\n  width: 100%;\n  padding: 0;\n  margin-bottom: 0.5rem;\n  font-size: calc(1.275rem + 0.3vw);\n  line-height: inherit;\n}\n@media (min-width: 1200px) {\n  legend {\n    font-size: 1.5rem;\n  }\n}\nlegend + * {\n  clear: left;\n}\n\n::-webkit-datetime-edit-fields-wrapper,\n::-webkit-datetime-edit-text,\n::-webkit-datetime-edit-minute,\n::-webkit-datetime-edit-hour-field,\n::-webkit-datetime-edit-day-field,\n::-webkit-datetime-edit-month-field,\n::-webkit-datetime-edit-year-field {\n  padding: 0;\n}\n\n::-webkit-inner-spin-button {\n  height: auto;\n}\n\n[type=search] {\n  outline-offset: -2px;\n  -webkit-appearance: textfield;\n}\n\n/* rtl:raw:\n[type=\"tel\"],\n[type=\"url\"],\n[type=\"email\"],\n[type=\"number\"] {\n  direction: ltr;\n}\n*/\n::-webkit-search-decoration {\n  -webkit-appearance: none;\n}\n\n::-webkit-color-swatch-wrapper {\n  padding: 0;\n}\n\n::file-selector-button {\n  font: inherit;\n}\n\n::-webkit-file-upload-button {\n  font: inherit;\n  -webkit-appearance: button;\n}\n\noutput {\n  display: inline-block;\n}\n\niframe {\n  border: 0;\n}\n\nsummary {\n  display: list-item;\n  cursor: pointer;\n}\n\nprogress {\n  vertical-align: baseline;\n}\n\n[hidden] {\n  display: none !important;\n}\n\n.lead {\n  font-size: 1.25rem;\n  font-weight: 300;\n}\n\n.display-1 {\n  font-size: calc(1.625rem + 4.5vw);\n  font-weight: 300;\n  line-height: 1.2;\n}\n@media (min-width: 1200px) {\n  .display-1 {\n    font-size: 5rem;\n  }\n}\n\n.display-2 {\n  font-size: calc(1.575rem + 3.9vw);\n  font-weight: 300;\n  line-height: 1.2;\n}\n@media (min-width: 1200px) {\n  .display-2 {\n    font-size: 4.5rem;\n  }\n}\n\n.display-3 {\n  font-size: calc(1.525rem + 3.3vw);\n  font-weight: 300;\n  line-height: 1.2;\n}\n@media (min-width: 1200px) {\n  .display-3 {\n    font-size: 4rem;\n  }\n}\n\n.display-4 {\n  font-size: calc(1.475rem + 2.7vw);\n  font-weight: 300;\n  line-height: 1.2;\n}\n@media (min-width: 1200px) {\n  .display-4 {\n    font-size: 3.5rem;\n  }\n}\n\n.display-5 {\n  font-size: calc(1.425rem + 2.1vw);\n  font-weight: 300;\n  line-height: 1.2;\n}\n@media (min-width: 1200px) {\n  .display-5 {\n    font-size: 3rem;\n  }\n}\n\n.display-6 {\n  font-size: calc(1.375rem + 1.5vw);\n  font-weight: 300;\n  line-height: 1.2;\n}\n@media (min-width: 1200px) {\n  .display-6 {\n    font-size: 2.5rem;\n  }\n}\n\n.list-unstyled {\n  padding-left: 0;\n  list-style: none;\n}\n\n.list-inline {\n  padding-left: 0;\n  list-style: none;\n}\n\n.list-inline-item {\n  display: inline-block;\n}\n.list-inline-item:not(:last-child) {\n  margin-right: 0.5rem;\n}\n\n.initialism {\n  font-size: 0.875em;\n  text-transform: uppercase;\n}\n\n.blockquote {\n  margin-bottom: 1rem;\n  font-size: 1.25rem;\n}\n.blockquote > :last-child {\n  margin-bottom: 0;\n}\n\n.blockquote-footer {\n  margin-top: -1rem;\n  margin-bottom: 1rem;\n  font-size: 0.875em;\n  color: #6c757d;\n}\n.blockquote-footer::before {\n  content: \"— \";\n}\n\n.img-fluid {\n  max-width: 100%;\n  height: auto;\n}\n\n.img-thumbnail {\n  padding: 0.25rem;\n  background-color: #fff;\n  border: 1px solid #dee2e6;\n  border-radius: 0.25rem;\n  max-width: 100%;\n  height: auto;\n}\n\n.figure {\n  display: inline-block;\n}\n\n.figure-img {\n  margin-bottom: 0.5rem;\n  line-height: 1;\n}\n\n.figure-caption {\n  font-size: 0.875em;\n  color: #6c757d;\n}\n\n.container,\n.container-fluid,\n.container-xxl,\n.container-xl,\n.container-lg,\n.container-md,\n.container-sm {\n  width: 100%;\n  padding-right: var(--bs-gutter-x, 0.75rem);\n  padding-left: var(--bs-gutter-x, 0.75rem);\n  margin-right: auto;\n  margin-left: auto;\n}\n\n@media (min-width: 576px) {\n  .container-sm, .container {\n    max-width: 540px;\n  }\n}\n@media (min-width: 768px) {\n  .container-md, .container-sm, .container {\n    max-width: 720px;\n  }\n}\n@media (min-width: 992px) {\n  .container-lg, .container-md, .container-sm, .container {\n    max-width: 960px;\n  }\n}\n@media (min-width: 1200px) {\n  .container-xl, .container-lg, .container-md, .container-sm, .container {\n    max-width: 1140px;\n  }\n}\n@media (min-width: 1400px) {\n  .container-xxl, .container-xl, .container-lg, .container-md, .container-sm, .container {\n    max-width: 1320px;\n  }\n}\n.row {\n  --bs-gutter-x: 1.5rem;\n  --bs-gutter-y: 0;\n  display: flex;\n  flex-wrap: wrap;\n  margin-top: calc(var(--bs-gutter-y) * -1);\n  margin-right: calc(var(--bs-gutter-x) * -.5);\n  margin-left: calc(var(--bs-gutter-x) * -.5);\n}\n.row > * {\n  flex-shrink: 0;\n  width: 100%;\n  max-width: 100%;\n  padding-right: calc(var(--bs-gutter-x) * .5);\n  padding-left: calc(var(--bs-gutter-x) * .5);\n  margin-top: var(--bs-gutter-y);\n}\n\n.col {\n  flex: 1 0 0%;\n}\n\n.row-cols-auto > * {\n  flex: 0 0 auto;\n  width: auto;\n}\n\n.row-cols-1 > * {\n  flex: 0 0 auto;\n  width: 100%;\n}\n\n.row-cols-2 > * {\n  flex: 0 0 auto;\n  width: 50%;\n}\n\n.row-cols-3 > * {\n  flex: 0 0 auto;\n  width: 33.3333333333%;\n}\n\n.row-cols-4 > * {\n  flex: 0 0 auto;\n  width: 25%;\n}\n\n.row-cols-5 > * {\n  flex: 0 0 auto;\n  width: 20%;\n}\n\n.row-cols-6 > * {\n  flex: 0 0 auto;\n  width: 16.6666666667%;\n}\n\n.col-auto {\n  flex: 0 0 auto;\n  width: auto;\n}\n\n.col-1 {\n  flex: 0 0 auto;\n  width: 8.33333333%;\n}\n\n.col-2 {\n  flex: 0 0 auto;\n  width: 16.66666667%;\n}\n\n.col-3 {\n  flex: 0 0 auto;\n  width: 25%;\n}\n\n.col-4 {\n  flex: 0 0 auto;\n  width: 33.33333333%;\n}\n\n.col-5 {\n  flex: 0 0 auto;\n  width: 41.66666667%;\n}\n\n.col-6 {\n  flex: 0 0 auto;\n  width: 50%;\n}\n\n.col-7 {\n  flex: 0 0 auto;\n  width: 58.33333333%;\n}\n\n.col-8 {\n  flex: 0 0 auto;\n  width: 66.66666667%;\n}\n\n.col-9 {\n  flex: 0 0 auto;\n  width: 75%;\n}\n\n.col-10 {\n  flex: 0 0 auto;\n  width: 83.33333333%;\n}\n\n.col-11 {\n  flex: 0 0 auto;\n  width: 91.66666667%;\n}\n\n.col-12 {\n  flex: 0 0 auto;\n  width: 100%;\n}\n\n.offset-1 {\n  margin-left: 8.33333333%;\n}\n\n.offset-2 {\n  margin-left: 16.66666667%;\n}\n\n.offset-3 {\n  margin-left: 25%;\n}\n\n.offset-4 {\n  margin-left: 33.33333333%;\n}\n\n.offset-5 {\n  margin-left: 41.66666667%;\n}\n\n.offset-6 {\n  margin-left: 50%;\n}\n\n.offset-7 {\n  margin-left: 58.33333333%;\n}\n\n.offset-8 {\n  margin-left: 66.66666667%;\n}\n\n.offset-9 {\n  margin-left: 75%;\n}\n\n.offset-10 {\n  margin-left: 83.33333333%;\n}\n\n.offset-11 {\n  margin-left: 91.66666667%;\n}\n\n.g-0,\n.gx-0 {\n  --bs-gutter-x: 0;\n}\n\n.g-0,\n.gy-0 {\n  --bs-gutter-y: 0;\n}\n\n.g-1,\n.gx-1 {\n  --bs-gutter-x: 0.25rem;\n}\n\n.g-1,\n.gy-1 {\n  --bs-gutter-y: 0.25rem;\n}\n\n.g-2,\n.gx-2 {\n  --bs-gutter-x: 0.5rem;\n}\n\n.g-2,\n.gy-2 {\n  --bs-gutter-y: 0.5rem;\n}\n\n.g-3,\n.gx-3 {\n  --bs-gutter-x: 1rem;\n}\n\n.g-3,\n.gy-3 {\n  --bs-gutter-y: 1rem;\n}\n\n.g-4,\n.gx-4 {\n  --bs-gutter-x: 1.5rem;\n}\n\n.g-4,\n.gy-4 {\n  --bs-gutter-y: 1.5rem;\n}\n\n.g-5,\n.gx-5 {\n  --bs-gutter-x: 3rem;\n}\n\n.g-5,\n.gy-5 {\n  --bs-gutter-y: 3rem;\n}\n\n@media (min-width: 576px) {\n  .col-sm {\n    flex: 1 0 0%;\n  }\n\n  .row-cols-sm-auto > * {\n    flex: 0 0 auto;\n    width: auto;\n  }\n\n  .row-cols-sm-1 > * {\n    flex: 0 0 auto;\n    width: 100%;\n  }\n\n  .row-cols-sm-2 > * {\n    flex: 0 0 auto;\n    width: 50%;\n  }\n\n  .row-cols-sm-3 > * {\n    flex: 0 0 auto;\n    width: 33.3333333333%;\n  }\n\n  .row-cols-sm-4 > * {\n    flex: 0 0 auto;\n    width: 25%;\n  }\n\n  .row-cols-sm-5 > * {\n    flex: 0 0 auto;\n    width: 20%;\n  }\n\n  .row-cols-sm-6 > * {\n    flex: 0 0 auto;\n    width: 16.6666666667%;\n  }\n\n  .col-sm-auto {\n    flex: 0 0 auto;\n    width: auto;\n  }\n\n  .col-sm-1 {\n    flex: 0 0 auto;\n    width: 8.33333333%;\n  }\n\n  .col-sm-2 {\n    flex: 0 0 auto;\n    width: 16.66666667%;\n  }\n\n  .col-sm-3 {\n    flex: 0 0 auto;\n    width: 25%;\n  }\n\n  .col-sm-4 {\n    flex: 0 0 auto;\n    width: 33.33333333%;\n  }\n\n  .col-sm-5 {\n    flex: 0 0 auto;\n    width: 41.66666667%;\n  }\n\n  .col-sm-6 {\n    flex: 0 0 auto;\n    width: 50%;\n  }\n\n  .col-sm-7 {\n    flex: 0 0 auto;\n    width: 58.33333333%;\n  }\n\n  .col-sm-8 {\n    flex: 0 0 auto;\n    width: 66.66666667%;\n  }\n\n  .col-sm-9 {\n    flex: 0 0 auto;\n    width: 75%;\n  }\n\n  .col-sm-10 {\n    flex: 0 0 auto;\n    width: 83.33333333%;\n  }\n\n  .col-sm-11 {\n    flex: 0 0 auto;\n    width: 91.66666667%;\n  }\n\n  .col-sm-12 {\n    flex: 0 0 auto;\n    width: 100%;\n  }\n\n  .offset-sm-0 {\n    margin-left: 0;\n  }\n\n  .offset-sm-1 {\n    margin-left: 8.33333333%;\n  }\n\n  .offset-sm-2 {\n    margin-left: 16.66666667%;\n  }\n\n  .offset-sm-3 {\n    margin-left: 25%;\n  }\n\n  .offset-sm-4 {\n    margin-left: 33.33333333%;\n  }\n\n  .offset-sm-5 {\n    margin-left: 41.66666667%;\n  }\n\n  .offset-sm-6 {\n    margin-left: 50%;\n  }\n\n  .offset-sm-7 {\n    margin-left: 58.33333333%;\n  }\n\n  .offset-sm-8 {\n    margin-left: 66.66666667%;\n  }\n\n  .offset-sm-9 {\n    margin-left: 75%;\n  }\n\n  .offset-sm-10 {\n    margin-left: 83.33333333%;\n  }\n\n  .offset-sm-11 {\n    margin-left: 91.66666667%;\n  }\n\n  .g-sm-0,\n.gx-sm-0 {\n    --bs-gutter-x: 0;\n  }\n\n  .g-sm-0,\n.gy-sm-0 {\n    --bs-gutter-y: 0;\n  }\n\n  .g-sm-1,\n.gx-sm-1 {\n    --bs-gutter-x: 0.25rem;\n  }\n\n  .g-sm-1,\n.gy-sm-1 {\n    --bs-gutter-y: 0.25rem;\n  }\n\n  .g-sm-2,\n.gx-sm-2 {\n    --bs-gutter-x: 0.5rem;\n  }\n\n  .g-sm-2,\n.gy-sm-2 {\n    --bs-gutter-y: 0.5rem;\n  }\n\n  .g-sm-3,\n.gx-sm-3 {\n    --bs-gutter-x: 1rem;\n  }\n\n  .g-sm-3,\n.gy-sm-3 {\n    --bs-gutter-y: 1rem;\n  }\n\n  .g-sm-4,\n.gx-sm-4 {\n    --bs-gutter-x: 1.5rem;\n  }\n\n  .g-sm-4,\n.gy-sm-4 {\n    --bs-gutter-y: 1.5rem;\n  }\n\n  .g-sm-5,\n.gx-sm-5 {\n    --bs-gutter-x: 3rem;\n  }\n\n  .g-sm-5,\n.gy-sm-5 {\n    --bs-gutter-y: 3rem;\n  }\n}\n@media (min-width: 768px) {\n  .col-md {\n    flex: 1 0 0%;\n  }\n\n  .row-cols-md-auto > * {\n    flex: 0 0 auto;\n    width: auto;\n  }\n\n  .row-cols-md-1 > * {\n    flex: 0 0 auto;\n    width: 100%;\n  }\n\n  .row-cols-md-2 > * {\n    flex: 0 0 auto;\n    width: 50%;\n  }\n\n  .row-cols-md-3 > * {\n    flex: 0 0 auto;\n    width: 33.3333333333%;\n  }\n\n  .row-cols-md-4 > * {\n    flex: 0 0 auto;\n    width: 25%;\n  }\n\n  .row-cols-md-5 > * {\n    flex: 0 0 auto;\n    width: 20%;\n  }\n\n  .row-cols-md-6 > * {\n    flex: 0 0 auto;\n    width: 16.6666666667%;\n  }\n\n  .col-md-auto {\n    flex: 0 0 auto;\n    width: auto;\n  }\n\n  .col-md-1 {\n    flex: 0 0 auto;\n    width: 8.33333333%;\n  }\n\n  .col-md-2 {\n    flex: 0 0 auto;\n    width: 16.66666667%;\n  }\n\n  .col-md-3 {\n    flex: 0 0 auto;\n    width: 25%;\n  }\n\n  .col-md-4 {\n    flex: 0 0 auto;\n    width: 33.33333333%;\n  }\n\n  .col-md-5 {\n    flex: 0 0 auto;\n    width: 41.66666667%;\n  }\n\n  .col-md-6 {\n    flex: 0 0 auto;\n    width: 50%;\n  }\n\n  .col-md-7 {\n    flex: 0 0 auto;\n    width: 58.33333333%;\n  }\n\n  .col-md-8 {\n    flex: 0 0 auto;\n    width: 66.66666667%;\n  }\n\n  .col-md-9 {\n    flex: 0 0 auto;\n    width: 75%;\n  }\n\n  .col-md-10 {\n    flex: 0 0 auto;\n    width: 83.33333333%;\n  }\n\n  .col-md-11 {\n    flex: 0 0 auto;\n    width: 91.66666667%;\n  }\n\n  .col-md-12 {\n    flex: 0 0 auto;\n    width: 100%;\n  }\n\n  .offset-md-0 {\n    margin-left: 0;\n  }\n\n  .offset-md-1 {\n    margin-left: 8.33333333%;\n  }\n\n  .offset-md-2 {\n    margin-left: 16.66666667%;\n  }\n\n  .offset-md-3 {\n    margin-left: 25%;\n  }\n\n  .offset-md-4 {\n    margin-left: 33.33333333%;\n  }\n\n  .offset-md-5 {\n    margin-left: 41.66666667%;\n  }\n\n  .offset-md-6 {\n    margin-left: 50%;\n  }\n\n  .offset-md-7 {\n    margin-left: 58.33333333%;\n  }\n\n  .offset-md-8 {\n    margin-left: 66.66666667%;\n  }\n\n  .offset-md-9 {\n    margin-left: 75%;\n  }\n\n  .offset-md-10 {\n    margin-left: 83.33333333%;\n  }\n\n  .offset-md-11 {\n    margin-left: 91.66666667%;\n  }\n\n  .g-md-0,\n.gx-md-0 {\n    --bs-gutter-x: 0;\n  }\n\n  .g-md-0,\n.gy-md-0 {\n    --bs-gutter-y: 0;\n  }\n\n  .g-md-1,\n.gx-md-1 {\n    --bs-gutter-x: 0.25rem;\n  }\n\n  .g-md-1,\n.gy-md-1 {\n    --bs-gutter-y: 0.25rem;\n  }\n\n  .g-md-2,\n.gx-md-2 {\n    --bs-gutter-x: 0.5rem;\n  }\n\n  .g-md-2,\n.gy-md-2 {\n    --bs-gutter-y: 0.5rem;\n  }\n\n  .g-md-3,\n.gx-md-3 {\n    --bs-gutter-x: 1rem;\n  }\n\n  .g-md-3,\n.gy-md-3 {\n    --bs-gutter-y: 1rem;\n  }\n\n  .g-md-4,\n.gx-md-4 {\n    --bs-gutter-x: 1.5rem;\n  }\n\n  .g-md-4,\n.gy-md-4 {\n    --bs-gutter-y: 1.5rem;\n  }\n\n  .g-md-5,\n.gx-md-5 {\n    --bs-gutter-x: 3rem;\n  }\n\n  .g-md-5,\n.gy-md-5 {\n    --bs-gutter-y: 3rem;\n  }\n}\n@media (min-width: 992px) {\n  .col-lg {\n    flex: 1 0 0%;\n  }\n\n  .row-cols-lg-auto > * {\n    flex: 0 0 auto;\n    width: auto;\n  }\n\n  .row-cols-lg-1 > * {\n    flex: 0 0 auto;\n    width: 100%;\n  }\n\n  .row-cols-lg-2 > * {\n    flex: 0 0 auto;\n    width: 50%;\n  }\n\n  .row-cols-lg-3 > * {\n    flex: 0 0 auto;\n    width: 33.3333333333%;\n  }\n\n  .row-cols-lg-4 > * {\n    flex: 0 0 auto;\n    width: 25%;\n  }\n\n  .row-cols-lg-5 > * {\n    flex: 0 0 auto;\n    width: 20%;\n  }\n\n  .row-cols-lg-6 > * {\n    flex: 0 0 auto;\n    width: 16.6666666667%;\n  }\n\n  .col-lg-auto {\n    flex: 0 0 auto;\n    width: auto;\n  }\n\n  .col-lg-1 {\n    flex: 0 0 auto;\n    width: 8.33333333%;\n  }\n\n  .col-lg-2 {\n    flex: 0 0 auto;\n    width: 16.66666667%;\n  }\n\n  .col-lg-3 {\n    flex: 0 0 auto;\n    width: 25%;\n  }\n\n  .col-lg-4 {\n    flex: 0 0 auto;\n    width: 33.33333333%;\n  }\n\n  .col-lg-5 {\n    flex: 0 0 auto;\n    width: 41.66666667%;\n  }\n\n  .col-lg-6 {\n    flex: 0 0 auto;\n    width: 50%;\n  }\n\n  .col-lg-7 {\n    flex: 0 0 auto;\n    width: 58.33333333%;\n  }\n\n  .col-lg-8 {\n    flex: 0 0 auto;\n    width: 66.66666667%;\n  }\n\n  .col-lg-9 {\n    flex: 0 0 auto;\n    width: 75%;\n  }\n\n  .col-lg-10 {\n    flex: 0 0 auto;\n    width: 83.33333333%;\n  }\n\n  .col-lg-11 {\n    flex: 0 0 auto;\n    width: 91.66666667%;\n  }\n\n  .col-lg-12 {\n    flex: 0 0 auto;\n    width: 100%;\n  }\n\n  .offset-lg-0 {\n    margin-left: 0;\n  }\n\n  .offset-lg-1 {\n    margin-left: 8.33333333%;\n  }\n\n  .offset-lg-2 {\n    margin-left: 16.66666667%;\n  }\n\n  .offset-lg-3 {\n    margin-left: 25%;\n  }\n\n  .offset-lg-4 {\n    margin-left: 33.33333333%;\n  }\n\n  .offset-lg-5 {\n    margin-left: 41.66666667%;\n  }\n\n  .offset-lg-6 {\n    margin-left: 50%;\n  }\n\n  .offset-lg-7 {\n    margin-left: 58.33333333%;\n  }\n\n  .offset-lg-8 {\n    margin-left: 66.66666667%;\n  }\n\n  .offset-lg-9 {\n    margin-left: 75%;\n  }\n\n  .offset-lg-10 {\n    margin-left: 83.33333333%;\n  }\n\n  .offset-lg-11 {\n    margin-left: 91.66666667%;\n  }\n\n  .g-lg-0,\n.gx-lg-0 {\n    --bs-gutter-x: 0;\n  }\n\n  .g-lg-0,\n.gy-lg-0 {\n    --bs-gutter-y: 0;\n  }\n\n  .g-lg-1,\n.gx-lg-1 {\n    --bs-gutter-x: 0.25rem;\n  }\n\n  .g-lg-1,\n.gy-lg-1 {\n    --bs-gutter-y: 0.25rem;\n  }\n\n  .g-lg-2,\n.gx-lg-2 {\n    --bs-gutter-x: 0.5rem;\n  }\n\n  .g-lg-2,\n.gy-lg-2 {\n    --bs-gutter-y: 0.5rem;\n  }\n\n  .g-lg-3,\n.gx-lg-3 {\n    --bs-gutter-x: 1rem;\n  }\n\n  .g-lg-3,\n.gy-lg-3 {\n    --bs-gutter-y: 1rem;\n  }\n\n  .g-lg-4,\n.gx-lg-4 {\n    --bs-gutter-x: 1.5rem;\n  }\n\n  .g-lg-4,\n.gy-lg-4 {\n    --bs-gutter-y: 1.5rem;\n  }\n\n  .g-lg-5,\n.gx-lg-5 {\n    --bs-gutter-x: 3rem;\n  }\n\n  .g-lg-5,\n.gy-lg-5 {\n    --bs-gutter-y: 3rem;\n  }\n}\n@media (min-width: 1200px) {\n  .col-xl {\n    flex: 1 0 0%;\n  }\n\n  .row-cols-xl-auto > * {\n    flex: 0 0 auto;\n    width: auto;\n  }\n\n  .row-cols-xl-1 > * {\n    flex: 0 0 auto;\n    width: 100%;\n  }\n\n  .row-cols-xl-2 > * {\n    flex: 0 0 auto;\n    width: 50%;\n  }\n\n  .row-cols-xl-3 > * {\n    flex: 0 0 auto;\n    width: 33.3333333333%;\n  }\n\n  .row-cols-xl-4 > * {\n    flex: 0 0 auto;\n    width: 25%;\n  }\n\n  .row-cols-xl-5 > * {\n    flex: 0 0 auto;\n    width: 20%;\n  }\n\n  .row-cols-xl-6 > * {\n    flex: 0 0 auto;\n    width: 16.6666666667%;\n  }\n\n  .col-xl-auto {\n    flex: 0 0 auto;\n    width: auto;\n  }\n\n  .col-xl-1 {\n    flex: 0 0 auto;\n    width: 8.33333333%;\n  }\n\n  .col-xl-2 {\n    flex: 0 0 auto;\n    width: 16.66666667%;\n  }\n\n  .col-xl-3 {\n    flex: 0 0 auto;\n    width: 25%;\n  }\n\n  .col-xl-4 {\n    flex: 0 0 auto;\n    width: 33.33333333%;\n  }\n\n  .col-xl-5 {\n    flex: 0 0 auto;\n    width: 41.66666667%;\n  }\n\n  .col-xl-6 {\n    flex: 0 0 auto;\n    width: 50%;\n  }\n\n  .col-xl-7 {\n    flex: 0 0 auto;\n    width: 58.33333333%;\n  }\n\n  .col-xl-8 {\n    flex: 0 0 auto;\n    width: 66.66666667%;\n  }\n\n  .col-xl-9 {\n    flex: 0 0 auto;\n    width: 75%;\n  }\n\n  .col-xl-10 {\n    flex: 0 0 auto;\n    width: 83.33333333%;\n  }\n\n  .col-xl-11 {\n    flex: 0 0 auto;\n    width: 91.66666667%;\n  }\n\n  .col-xl-12 {\n    flex: 0 0 auto;\n    width: 100%;\n  }\n\n  .offset-xl-0 {\n    margin-left: 0;\n  }\n\n  .offset-xl-1 {\n    margin-left: 8.33333333%;\n  }\n\n  .offset-xl-2 {\n    margin-left: 16.66666667%;\n  }\n\n  .offset-xl-3 {\n    margin-left: 25%;\n  }\n\n  .offset-xl-4 {\n    margin-left: 33.33333333%;\n  }\n\n  .offset-xl-5 {\n    margin-left: 41.66666667%;\n  }\n\n  .offset-xl-6 {\n    margin-left: 50%;\n  }\n\n  .offset-xl-7 {\n    margin-left: 58.33333333%;\n  }\n\n  .offset-xl-8 {\n    margin-left: 66.66666667%;\n  }\n\n  .offset-xl-9 {\n    margin-left: 75%;\n  }\n\n  .offset-xl-10 {\n    margin-left: 83.33333333%;\n  }\n\n  .offset-xl-11 {\n    margin-left: 91.66666667%;\n  }\n\n  .g-xl-0,\n.gx-xl-0 {\n    --bs-gutter-x: 0;\n  }\n\n  .g-xl-0,\n.gy-xl-0 {\n    --bs-gutter-y: 0;\n  }\n\n  .g-xl-1,\n.gx-xl-1 {\n    --bs-gutter-x: 0.25rem;\n  }\n\n  .g-xl-1,\n.gy-xl-1 {\n    --bs-gutter-y: 0.25rem;\n  }\n\n  .g-xl-2,\n.gx-xl-2 {\n    --bs-gutter-x: 0.5rem;\n  }\n\n  .g-xl-2,\n.gy-xl-2 {\n    --bs-gutter-y: 0.5rem;\n  }\n\n  .g-xl-3,\n.gx-xl-3 {\n    --bs-gutter-x: 1rem;\n  }\n\n  .g-xl-3,\n.gy-xl-3 {\n    --bs-gutter-y: 1rem;\n  }\n\n  .g-xl-4,\n.gx-xl-4 {\n    --bs-gutter-x: 1.5rem;\n  }\n\n  .g-xl-4,\n.gy-xl-4 {\n    --bs-gutter-y: 1.5rem;\n  }\n\n  .g-xl-5,\n.gx-xl-5 {\n    --bs-gutter-x: 3rem;\n  }\n\n  .g-xl-5,\n.gy-xl-5 {\n    --bs-gutter-y: 3rem;\n  }\n}\n@media (min-width: 1400px) {\n  .col-xxl {\n    flex: 1 0 0%;\n  }\n\n  .row-cols-xxl-auto > * {\n    flex: 0 0 auto;\n    width: auto;\n  }\n\n  .row-cols-xxl-1 > * {\n    flex: 0 0 auto;\n    width: 100%;\n  }\n\n  .row-cols-xxl-2 > * {\n    flex: 0 0 auto;\n    width: 50%;\n  }\n\n  .row-cols-xxl-3 > * {\n    flex: 0 0 auto;\n    width: 33.3333333333%;\n  }\n\n  .row-cols-xxl-4 > * {\n    flex: 0 0 auto;\n    width: 25%;\n  }\n\n  .row-cols-xxl-5 > * {\n    flex: 0 0 auto;\n    width: 20%;\n  }\n\n  .row-cols-xxl-6 > * {\n    flex: 0 0 auto;\n    width: 16.6666666667%;\n  }\n\n  .col-xxl-auto {\n    flex: 0 0 auto;\n    width: auto;\n  }\n\n  .col-xxl-1 {\n    flex: 0 0 auto;\n    width: 8.33333333%;\n  }\n\n  .col-xxl-2 {\n    flex: 0 0 auto;\n    width: 16.66666667%;\n  }\n\n  .col-xxl-3 {\n    flex: 0 0 auto;\n    width: 25%;\n  }\n\n  .col-xxl-4 {\n    flex: 0 0 auto;\n    width: 33.33333333%;\n  }\n\n  .col-xxl-5 {\n    flex: 0 0 auto;\n    width: 41.66666667%;\n  }\n\n  .col-xxl-6 {\n    flex: 0 0 auto;\n    width: 50%;\n  }\n\n  .col-xxl-7 {\n    flex: 0 0 auto;\n    width: 58.33333333%;\n  }\n\n  .col-xxl-8 {\n    flex: 0 0 auto;\n    width: 66.66666667%;\n  }\n\n  .col-xxl-9 {\n    flex: 0 0 auto;\n    width: 75%;\n  }\n\n  .col-xxl-10 {\n    flex: 0 0 auto;\n    width: 83.33333333%;\n  }\n\n  .col-xxl-11 {\n    flex: 0 0 auto;\n    width: 91.66666667%;\n  }\n\n  .col-xxl-12 {\n    flex: 0 0 auto;\n    width: 100%;\n  }\n\n  .offset-xxl-0 {\n    margin-left: 0;\n  }\n\n  .offset-xxl-1 {\n    margin-left: 8.33333333%;\n  }\n\n  .offset-xxl-2 {\n    margin-left: 16.66666667%;\n  }\n\n  .offset-xxl-3 {\n    margin-left: 25%;\n  }\n\n  .offset-xxl-4 {\n    margin-left: 33.33333333%;\n  }\n\n  .offset-xxl-5 {\n    margin-left: 41.66666667%;\n  }\n\n  .offset-xxl-6 {\n    margin-left: 50%;\n  }\n\n  .offset-xxl-7 {\n    margin-left: 58.33333333%;\n  }\n\n  .offset-xxl-8 {\n    margin-left: 66.66666667%;\n  }\n\n  .offset-xxl-9 {\n    margin-left: 75%;\n  }\n\n  .offset-xxl-10 {\n    margin-left: 83.33333333%;\n  }\n\n  .offset-xxl-11 {\n    margin-left: 91.66666667%;\n  }\n\n  .g-xxl-0,\n.gx-xxl-0 {\n    --bs-gutter-x: 0;\n  }\n\n  .g-xxl-0,\n.gy-xxl-0 {\n    --bs-gutter-y: 0;\n  }\n\n  .g-xxl-1,\n.gx-xxl-1 {\n    --bs-gutter-x: 0.25rem;\n  }\n\n  .g-xxl-1,\n.gy-xxl-1 {\n    --bs-gutter-y: 0.25rem;\n  }\n\n  .g-xxl-2,\n.gx-xxl-2 {\n    --bs-gutter-x: 0.5rem;\n  }\n\n  .g-xxl-2,\n.gy-xxl-2 {\n    --bs-gutter-y: 0.5rem;\n  }\n\n  .g-xxl-3,\n.gx-xxl-3 {\n    --bs-gutter-x: 1rem;\n  }\n\n  .g-xxl-3,\n.gy-xxl-3 {\n    --bs-gutter-y: 1rem;\n  }\n\n  .g-xxl-4,\n.gx-xxl-4 {\n    --bs-gutter-x: 1.5rem;\n  }\n\n  .g-xxl-4,\n.gy-xxl-4 {\n    --bs-gutter-y: 1.5rem;\n  }\n\n  .g-xxl-5,\n.gx-xxl-5 {\n    --bs-gutter-x: 3rem;\n  }\n\n  .g-xxl-5,\n.gy-xxl-5 {\n    --bs-gutter-y: 3rem;\n  }\n}\n.table {\n  --bs-table-bg: transparent;\n  --bs-table-accent-bg: transparent;\n  --bs-table-striped-color: #212529;\n  --bs-table-striped-bg: rgba(0, 0, 0, 0.05);\n  --bs-table-active-color: #212529;\n  --bs-table-active-bg: rgba(0, 0, 0, 0.1);\n  --bs-table-hover-color: #212529;\n  --bs-table-hover-bg: rgba(0, 0, 0, 0.075);\n  width: 100%;\n  margin-bottom: 1rem;\n  color: #212529;\n  vertical-align: top;\n  border-color: #dee2e6;\n}\n.table > :not(caption) > * > * {\n  padding: 0.5rem 0.5rem;\n  background-color: var(--bs-table-bg);\n  border-bottom-width: 1px;\n  box-shadow: inset 0 0 0 9999px var(--bs-table-accent-bg);\n}\n.table > tbody {\n  vertical-align: inherit;\n}\n.table > thead {\n  vertical-align: bottom;\n}\n.table > :not(:last-child) > :last-child > * {\n  border-bottom-color: currentColor;\n}\n\n.caption-top {\n  caption-side: top;\n}\n\n.table-sm > :not(caption) > * > * {\n  padding: 0.25rem 0.25rem;\n}\n\n.table-bordered > :not(caption) > * {\n  border-width: 1px 0;\n}\n.table-bordered > :not(caption) > * > * {\n  border-width: 0 1px;\n}\n\n.table-borderless > :not(caption) > * > * {\n  border-bottom-width: 0;\n}\n\n.table-striped > tbody > tr:nth-of-type(odd) {\n  --bs-table-accent-bg: var(--bs-table-striped-bg);\n  color: var(--bs-table-striped-color);\n}\n\n.table-active {\n  --bs-table-accent-bg: var(--bs-table-active-bg);\n  color: var(--bs-table-active-color);\n}\n\n.table-hover > tbody > tr:hover {\n  --bs-table-accent-bg: var(--bs-table-hover-bg);\n  color: var(--bs-table-hover-color);\n}\n\n.table-primary {\n  --bs-table-bg: #cfe2ff;\n  --bs-table-striped-bg: #c5d7f2;\n  --bs-table-striped-color: #000;\n  --bs-table-active-bg: #bacbe6;\n  --bs-table-active-color: #000;\n  --bs-table-hover-bg: #bfd1ec;\n  --bs-table-hover-color: #000;\n  color: #000;\n  border-color: #bacbe6;\n}\n\n.table-secondary {\n  --bs-table-bg: #e2e3e5;\n  --bs-table-striped-bg: #d7d8da;\n  --bs-table-striped-color: #000;\n  --bs-table-active-bg: #cbccce;\n  --bs-table-active-color: #000;\n  --bs-table-hover-bg: #d1d2d4;\n  --bs-table-hover-color: #000;\n  color: #000;\n  border-color: #cbccce;\n}\n\n.table-success {\n  --bs-table-bg: #d1e7dd;\n  --bs-table-striped-bg: #c7dbd2;\n  --bs-table-striped-color: #000;\n  --bs-table-active-bg: #bcd0c7;\n  --bs-table-active-color: #000;\n  --bs-table-hover-bg: #c1d6cc;\n  --bs-table-hover-color: #000;\n  color: #000;\n  border-color: #bcd0c7;\n}\n\n.table-info {\n  --bs-table-bg: #cff4fc;\n  --bs-table-striped-bg: #c5e8ef;\n  --bs-table-striped-color: #000;\n  --bs-table-active-bg: #badce3;\n  --bs-table-active-color: #000;\n  --bs-table-hover-bg: #bfe2e9;\n  --bs-table-hover-color: #000;\n  color: #000;\n  border-color: #badce3;\n}\n\n.table-warning {\n  --bs-table-bg: #fff3cd;\n  --bs-table-striped-bg: #f2e7c3;\n  --bs-table-striped-color: #000;\n  --bs-table-active-bg: #e6dbb9;\n  --bs-table-active-color: #000;\n  --bs-table-hover-bg: #ece1be;\n  --bs-table-hover-color: #000;\n  color: #000;\n  border-color: #e6dbb9;\n}\n\n.table-danger {\n  --bs-table-bg: #f8d7da;\n  --bs-table-striped-bg: #eccccf;\n  --bs-table-striped-color: #000;\n  --bs-table-active-bg: #dfc2c4;\n  --bs-table-active-color: #000;\n  --bs-table-hover-bg: #e5c7ca;\n  --bs-table-hover-color: #000;\n  color: #000;\n  border-color: #dfc2c4;\n}\n\n.table-light {\n  --bs-table-bg: #f8f9fa;\n  --bs-table-striped-bg: #ecedee;\n  --bs-table-striped-color: #000;\n  --bs-table-active-bg: #dfe0e1;\n  --bs-table-active-color: #000;\n  --bs-table-hover-bg: #e5e6e7;\n  --bs-table-hover-color: #000;\n  color: #000;\n  border-color: #dfe0e1;\n}\n\n.table-dark {\n  --bs-table-bg: #212529;\n  --bs-table-striped-bg: #2c3034;\n  --bs-table-striped-color: #fff;\n  --bs-table-active-bg: #373b3e;\n  --bs-table-active-color: #fff;\n  --bs-table-hover-bg: #323539;\n  --bs-table-hover-color: #fff;\n  color: #fff;\n  border-color: #373b3e;\n}\n\n.table-responsive {\n  overflow-x: auto;\n  -webkit-overflow-scrolling: touch;\n}\n\n@media (max-width: 575.98px) {\n  .table-responsive-sm {\n    overflow-x: auto;\n    -webkit-overflow-scrolling: touch;\n  }\n}\n@media (max-width: 767.98px) {\n  .table-responsive-md {\n    overflow-x: auto;\n    -webkit-overflow-scrolling: touch;\n  }\n}\n@media (max-width: 991.98px) {\n  .table-responsive-lg {\n    overflow-x: auto;\n    -webkit-overflow-scrolling: touch;\n  }\n}\n@media (max-width: 1199.98px) {\n  .table-responsive-xl {\n    overflow-x: auto;\n    -webkit-overflow-scrolling: touch;\n  }\n}\n@media (max-width: 1399.98px) {\n  .table-responsive-xxl {\n    overflow-x: auto;\n    -webkit-overflow-scrolling: touch;\n  }\n}\n.form-label {\n  margin-bottom: 0.5rem;\n}\n\n.col-form-label {\n  padding-top: calc(0.375rem + 1px);\n  padding-bottom: calc(0.375rem + 1px);\n  margin-bottom: 0;\n  font-size: inherit;\n  line-height: 1.5;\n}\n\n.col-form-label-lg {\n  padding-top: calc(0.5rem + 1px);\n  padding-bottom: calc(0.5rem + 1px);\n  font-size: 1.25rem;\n}\n\n.col-form-label-sm {\n  padding-top: calc(0.25rem + 1px);\n  padding-bottom: calc(0.25rem + 1px);\n  font-size: 0.875rem;\n}\n\n.form-text {\n  margin-top: 0.25rem;\n  font-size: 0.875em;\n  color: #6c757d;\n}\n\n.form-control {\n  display: block;\n  width: 100%;\n  padding: 0.375rem 0.75rem;\n  font-size: 1rem;\n  font-weight: 400;\n  line-height: 1.5;\n  color: #212529;\n  background-color: #fff;\n  background-clip: padding-box;\n  border: 1px solid #ced4da;\n  -webkit-appearance: none;\n  -moz-appearance: none;\n  appearance: none;\n  border-radius: 0.25rem;\n  transition: border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n}\n@media (prefers-reduced-motion: reduce) {\n  .form-control {\n    transition: none;\n  }\n}\n.form-control[type=file] {\n  overflow: hidden;\n}\n.form-control[type=file]:not(:disabled):not([readonly]) {\n  cursor: pointer;\n}\n.form-control:focus {\n  color: #212529;\n  background-color: #fff;\n  border-color: #86b7fe;\n  outline: 0;\n  box-shadow: 0 0 0 0.25rem rgba(13, 110, 253, 0.25);\n}\n.form-control::-webkit-date-and-time-value {\n  height: 1.5em;\n}\n.form-control::-moz-placeholder {\n  color: #6c757d;\n  opacity: 1;\n}\n.form-control::placeholder {\n  color: #6c757d;\n  opacity: 1;\n}\n.form-control:disabled, .form-control[readonly] {\n  background-color: #e9ecef;\n  opacity: 1;\n}\n.form-control::file-selector-button {\n  padding: 0.375rem 0.75rem;\n  margin: -0.375rem -0.75rem;\n  -webkit-margin-end: 0.75rem;\n  margin-inline-end: 0.75rem;\n  color: #212529;\n  background-color: #e9ecef;\n  pointer-events: none;\n  border-color: inherit;\n  border-style: solid;\n  border-width: 0;\n  border-inline-end-width: 1px;\n  border-radius: 0;\n  transition: color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n}\n@media (prefers-reduced-motion: reduce) {\n  .form-control::file-selector-button {\n    transition: none;\n  }\n}\n.form-control:hover:not(:disabled):not([readonly])::file-selector-button {\n  background-color: #dde0e3;\n}\n.form-control::-webkit-file-upload-button {\n  padding: 0.375rem 0.75rem;\n  margin: -0.375rem -0.75rem;\n  -webkit-margin-end: 0.75rem;\n  margin-inline-end: 0.75rem;\n  color: #212529;\n  background-color: #e9ecef;\n  pointer-events: none;\n  border-color: inherit;\n  border-style: solid;\n  border-width: 0;\n  border-inline-end-width: 1px;\n  border-radius: 0;\n  -webkit-transition: color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n  transition: color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n}\n@media (prefers-reduced-motion: reduce) {\n  .form-control::-webkit-file-upload-button {\n    -webkit-transition: none;\n    transition: none;\n  }\n}\n.form-control:hover:not(:disabled):not([readonly])::-webkit-file-upload-button {\n  background-color: #dde0e3;\n}\n\n.form-control-plaintext {\n  display: block;\n  width: 100%;\n  padding: 0.375rem 0;\n  margin-bottom: 0;\n  line-height: 1.5;\n  color: #212529;\n  background-color: transparent;\n  border: solid transparent;\n  border-width: 1px 0;\n}\n.form-control-plaintext.form-control-sm, .form-control-plaintext.form-control-lg {\n  padding-right: 0;\n  padding-left: 0;\n}\n\n.form-control-sm {\n  min-height: calc(1.5em + 0.5rem + 2px);\n  padding: 0.25rem 0.5rem;\n  font-size: 0.875rem;\n  border-radius: 0.2rem;\n}\n.form-control-sm::file-selector-button {\n  padding: 0.25rem 0.5rem;\n  margin: -0.25rem -0.5rem;\n  -webkit-margin-end: 0.5rem;\n  margin-inline-end: 0.5rem;\n}\n.form-control-sm::-webkit-file-upload-button {\n  padding: 0.25rem 0.5rem;\n  margin: -0.25rem -0.5rem;\n  -webkit-margin-end: 0.5rem;\n  margin-inline-end: 0.5rem;\n}\n\n.form-control-lg {\n  min-height: calc(1.5em + 1rem + 2px);\n  padding: 0.5rem 1rem;\n  font-size: 1.25rem;\n  border-radius: 0.3rem;\n}\n.form-control-lg::file-selector-button {\n  padding: 0.5rem 1rem;\n  margin: -0.5rem -1rem;\n  -webkit-margin-end: 1rem;\n  margin-inline-end: 1rem;\n}\n.form-control-lg::-webkit-file-upload-button {\n  padding: 0.5rem 1rem;\n  margin: -0.5rem -1rem;\n  -webkit-margin-end: 1rem;\n  margin-inline-end: 1rem;\n}\n\ntextarea.form-control {\n  min-height: calc(1.5em + 0.75rem + 2px);\n}\ntextarea.form-control-sm {\n  min-height: calc(1.5em + 0.5rem + 2px);\n}\ntextarea.form-control-lg {\n  min-height: calc(1.5em + 1rem + 2px);\n}\n\n.form-control-color {\n  width: 3rem;\n  height: auto;\n  padding: 0.375rem;\n}\n.form-control-color:not(:disabled):not([readonly]) {\n  cursor: pointer;\n}\n.form-control-color::-moz-color-swatch {\n  height: 1.5em;\n  border-radius: 0.25rem;\n}\n.form-control-color::-webkit-color-swatch {\n  height: 1.5em;\n  border-radius: 0.25rem;\n}\n\n.form-select {\n  display: block;\n  width: 100%;\n  padding: 0.375rem 2.25rem 0.375rem 0.75rem;\n  -moz-padding-start: calc(0.75rem - 3px);\n  font-size: 1rem;\n  font-weight: 400;\n  line-height: 1.5;\n  color: #212529;\n  background-color: #fff;\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3e%3cpath fill='none' stroke='%23343a40' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M2 5l6 6 6-6'/%3e%3c/svg%3e\");\n  background-repeat: no-repeat;\n  background-position: right 0.75rem center;\n  background-size: 16px 12px;\n  border: 1px solid #ced4da;\n  border-radius: 0.25rem;\n  transition: border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n  -webkit-appearance: none;\n  -moz-appearance: none;\n  appearance: none;\n}\n@media (prefers-reduced-motion: reduce) {\n  .form-select {\n    transition: none;\n  }\n}\n.form-select:focus {\n  border-color: #86b7fe;\n  outline: 0;\n  box-shadow: 0 0 0 0.25rem rgba(13, 110, 253, 0.25);\n}\n.form-select[multiple], .form-select[size]:not([size=\"1\"]) {\n  padding-right: 0.75rem;\n  background-image: none;\n}\n.form-select:disabled {\n  background-color: #e9ecef;\n}\n.form-select:-moz-focusring {\n  color: transparent;\n  text-shadow: 0 0 0 #212529;\n}\n\n.form-select-sm {\n  padding-top: 0.25rem;\n  padding-bottom: 0.25rem;\n  padding-left: 0.5rem;\n  font-size: 0.875rem;\n}\n\n.form-select-lg {\n  padding-top: 0.5rem;\n  padding-bottom: 0.5rem;\n  padding-left: 1rem;\n  font-size: 1.25rem;\n}\n\n.form-check {\n  display: block;\n  min-height: 1.5rem;\n  padding-left: 1.5em;\n  margin-bottom: 0.125rem;\n}\n.form-check .form-check-input {\n  float: left;\n  margin-left: -1.5em;\n}\n\n.form-check-input {\n  width: 1em;\n  height: 1em;\n  margin-top: 0.25em;\n  vertical-align: top;\n  background-color: #fff;\n  background-repeat: no-repeat;\n  background-position: center;\n  background-size: contain;\n  border: 1px solid rgba(0, 0, 0, 0.25);\n  -webkit-appearance: none;\n  -moz-appearance: none;\n  appearance: none;\n  -webkit-print-color-adjust: exact;\n  color-adjust: exact;\n}\n.form-check-input[type=checkbox] {\n  border-radius: 0.25em;\n}\n.form-check-input[type=radio] {\n  border-radius: 50%;\n}\n.form-check-input:active {\n  filter: brightness(90%);\n}\n.form-check-input:focus {\n  border-color: #86b7fe;\n  outline: 0;\n  box-shadow: 0 0 0 0.25rem rgba(13, 110, 253, 0.25);\n}\n.form-check-input:checked {\n  background-color: #0d6efd;\n  border-color: #0d6efd;\n}\n.form-check-input:checked[type=checkbox] {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3e%3cpath fill='none' stroke='%23fff' stroke-linecap='round' stroke-linejoin='round' stroke-width='3' d='M6 10l3 3l6-6'/%3e%3c/svg%3e\");\n}\n.form-check-input:checked[type=radio] {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='-4 -4 8 8'%3e%3ccircle r='2' fill='%23fff'/%3e%3c/svg%3e\");\n}\n.form-check-input[type=checkbox]:indeterminate {\n  background-color: #0d6efd;\n  border-color: #0d6efd;\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3e%3cpath fill='none' stroke='%23fff' stroke-linecap='round' stroke-linejoin='round' stroke-width='3' d='M6 10h8'/%3e%3c/svg%3e\");\n}\n.form-check-input:disabled {\n  pointer-events: none;\n  filter: none;\n  opacity: 0.5;\n}\n.form-check-input[disabled] ~ .form-check-label, .form-check-input:disabled ~ .form-check-label {\n  opacity: 0.5;\n}\n\n.form-switch {\n  padding-left: 2.5em;\n}\n.form-switch .form-check-input {\n  width: 2em;\n  margin-left: -2.5em;\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='-4 -4 8 8'%3e%3ccircle r='3' fill='rgba%280, 0, 0, 0.25%29'/%3e%3c/svg%3e\");\n  background-position: left center;\n  border-radius: 2em;\n  transition: background-position 0.15s ease-in-out;\n}\n@media (prefers-reduced-motion: reduce) {\n  .form-switch .form-check-input {\n    transition: none;\n  }\n}\n.form-switch .form-check-input:focus {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='-4 -4 8 8'%3e%3ccircle r='3' fill='%2386b7fe'/%3e%3c/svg%3e\");\n}\n.form-switch .form-check-input:checked {\n  background-position: right center;\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='-4 -4 8 8'%3e%3ccircle r='3' fill='%23fff'/%3e%3c/svg%3e\");\n}\n\n.form-check-inline {\n  display: inline-block;\n  margin-right: 1rem;\n}\n\n.btn-check {\n  position: absolute;\n  clip: rect(0, 0, 0, 0);\n  pointer-events: none;\n}\n.btn-check[disabled] + .btn, .btn-check:disabled + .btn {\n  pointer-events: none;\n  filter: none;\n  opacity: 0.65;\n}\n\n.form-range {\n  width: 100%;\n  height: 1.5rem;\n  padding: 0;\n  background-color: transparent;\n  -webkit-appearance: none;\n  -moz-appearance: none;\n  appearance: none;\n}\n.form-range:focus {\n  outline: 0;\n}\n.form-range:focus::-webkit-slider-thumb {\n  box-shadow: 0 0 0 1px #fff, 0 0 0 0.25rem rgba(13, 110, 253, 0.25);\n}\n.form-range:focus::-moz-range-thumb {\n  box-shadow: 0 0 0 1px #fff, 0 0 0 0.25rem rgba(13, 110, 253, 0.25);\n}\n.form-range::-moz-focus-outer {\n  border: 0;\n}\n.form-range::-webkit-slider-thumb {\n  width: 1rem;\n  height: 1rem;\n  margin-top: -0.25rem;\n  background-color: #0d6efd;\n  border: 0;\n  border-radius: 1rem;\n  -webkit-transition: background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n  transition: background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n  -webkit-appearance: none;\n  appearance: none;\n}\n@media (prefers-reduced-motion: reduce) {\n  .form-range::-webkit-slider-thumb {\n    -webkit-transition: none;\n    transition: none;\n  }\n}\n.form-range::-webkit-slider-thumb:active {\n  background-color: #b6d4fe;\n}\n.form-range::-webkit-slider-runnable-track {\n  width: 100%;\n  height: 0.5rem;\n  color: transparent;\n  cursor: pointer;\n  background-color: #dee2e6;\n  border-color: transparent;\n  border-radius: 1rem;\n}\n.form-range::-moz-range-thumb {\n  width: 1rem;\n  height: 1rem;\n  background-color: #0d6efd;\n  border: 0;\n  border-radius: 1rem;\n  -moz-transition: background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n  transition: background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n  -moz-appearance: none;\n  appearance: none;\n}\n@media (prefers-reduced-motion: reduce) {\n  .form-range::-moz-range-thumb {\n    -moz-transition: none;\n    transition: none;\n  }\n}\n.form-range::-moz-range-thumb:active {\n  background-color: #b6d4fe;\n}\n.form-range::-moz-range-track {\n  width: 100%;\n  height: 0.5rem;\n  color: transparent;\n  cursor: pointer;\n  background-color: #dee2e6;\n  border-color: transparent;\n  border-radius: 1rem;\n}\n.form-range:disabled {\n  pointer-events: none;\n}\n.form-range:disabled::-webkit-slider-thumb {\n  background-color: #adb5bd;\n}\n.form-range:disabled::-moz-range-thumb {\n  background-color: #adb5bd;\n}\n\n.form-floating {\n  position: relative;\n}\n.form-floating > .form-control,\n.form-floating > .form-select {\n  height: calc(3.5rem + 2px);\n  line-height: 1.25;\n}\n.form-floating > label {\n  position: absolute;\n  top: 0;\n  left: 0;\n  height: 100%;\n  padding: 1rem 0.75rem;\n  pointer-events: none;\n  border: 1px solid transparent;\n  transform-origin: 0 0;\n  transition: opacity 0.1s ease-in-out, transform 0.1s ease-in-out;\n}\n@media (prefers-reduced-motion: reduce) {\n  .form-floating > label {\n    transition: none;\n  }\n}\n.form-floating > .form-control {\n  padding: 1rem 0.75rem;\n}\n.form-floating > .form-control::-moz-placeholder {\n  color: transparent;\n}\n.form-floating > .form-control::placeholder {\n  color: transparent;\n}\n.form-floating > .form-control:not(:-moz-placeholder-shown) {\n  padding-top: 1.625rem;\n  padding-bottom: 0.625rem;\n}\n.form-floating > .form-control:focus, .form-floating > .form-control:not(:placeholder-shown) {\n  padding-top: 1.625rem;\n  padding-bottom: 0.625rem;\n}\n.form-floating > .form-control:-webkit-autofill {\n  padding-top: 1.625rem;\n  padding-bottom: 0.625rem;\n}\n.form-floating > .form-select {\n  padding-top: 1.625rem;\n  padding-bottom: 0.625rem;\n}\n.form-floating > .form-control:not(:-moz-placeholder-shown) ~ label {\n  opacity: 0.65;\n  transform: scale(0.85) translateY(-0.5rem) translateX(0.15rem);\n}\n.form-floating > .form-control:focus ~ label,\n.form-floating > .form-control:not(:placeholder-shown) ~ label,\n.form-floating > .form-select ~ label {\n  opacity: 0.65;\n  transform: scale(0.85) translateY(-0.5rem) translateX(0.15rem);\n}\n.form-floating > .form-control:-webkit-autofill ~ label {\n  opacity: 0.65;\n  transform: scale(0.85) translateY(-0.5rem) translateX(0.15rem);\n}\n\n.input-group {\n  position: relative;\n  display: flex;\n  flex-wrap: wrap;\n  align-items: stretch;\n  width: 100%;\n}\n.input-group > .form-control,\n.input-group > .form-select {\n  position: relative;\n  flex: 1 1 auto;\n  width: 1%;\n  min-width: 0;\n}\n.input-group > .form-control:focus,\n.input-group > .form-select:focus {\n  z-index: 3;\n}\n.input-group .btn {\n  position: relative;\n  z-index: 2;\n}\n.input-group .btn:focus {\n  z-index: 3;\n}\n\n.input-group-text {\n  display: flex;\n  align-items: center;\n  padding: 0.375rem 0.75rem;\n  font-size: 1rem;\n  font-weight: 400;\n  line-height: 1.5;\n  color: #212529;\n  text-align: center;\n  white-space: nowrap;\n  background-color: #e9ecef;\n  border: 1px solid #ced4da;\n  border-radius: 0.25rem;\n}\n\n.input-group-lg > .form-control,\n.input-group-lg > .form-select,\n.input-group-lg > .input-group-text,\n.input-group-lg > .btn {\n  padding: 0.5rem 1rem;\n  font-size: 1.25rem;\n  border-radius: 0.3rem;\n}\n\n.input-group-sm > .form-control,\n.input-group-sm > .form-select,\n.input-group-sm > .input-group-text,\n.input-group-sm > .btn {\n  padding: 0.25rem 0.5rem;\n  font-size: 0.875rem;\n  border-radius: 0.2rem;\n}\n\n.input-group-lg > .form-select,\n.input-group-sm > .form-select {\n  padding-right: 3rem;\n}\n\n.input-group:not(.has-validation) > :not(:last-child):not(.dropdown-toggle):not(.dropdown-menu),\n.input-group:not(.has-validation) > .dropdown-toggle:nth-last-child(n+3) {\n  border-top-right-radius: 0;\n  border-bottom-right-radius: 0;\n}\n.input-group.has-validation > :nth-last-child(n+3):not(.dropdown-toggle):not(.dropdown-menu),\n.input-group.has-validation > .dropdown-toggle:nth-last-child(n+4) {\n  border-top-right-radius: 0;\n  border-bottom-right-radius: 0;\n}\n.input-group > :not(:first-child):not(.dropdown-menu):not(.valid-tooltip):not(.valid-feedback):not(.invalid-tooltip):not(.invalid-feedback) {\n  margin-left: -1px;\n  border-top-left-radius: 0;\n  border-bottom-left-radius: 0;\n}\n\n.valid-feedback {\n  display: none;\n  width: 100%;\n  margin-top: 0.25rem;\n  font-size: 0.875em;\n  color: #198754;\n}\n\n.valid-tooltip {\n  position: absolute;\n  top: 100%;\n  z-index: 5;\n  display: none;\n  max-width: 100%;\n  padding: 0.25rem 0.5rem;\n  margin-top: 0.1rem;\n  font-size: 0.875rem;\n  color: #fff;\n  background-color: rgba(25, 135, 84, 0.9);\n  border-radius: 0.25rem;\n}\n\n.was-validated :valid ~ .valid-feedback,\n.was-validated :valid ~ .valid-tooltip,\n.is-valid ~ .valid-feedback,\n.is-valid ~ .valid-tooltip {\n  display: block;\n}\n\n.was-validated .form-control:valid, .form-control.is-valid {\n  border-color: #198754;\n  padding-right: calc(1.5em + 0.75rem);\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 8 8'%3e%3cpath fill='%23198754' d='M2.3 6.73L.6 4.53c-.4-1.04.46-1.4 1.1-.8l1.1 1.4 3.4-3.8c.6-.63 1.6-.27 1.2.7l-4 4.6c-.43.5-.8.4-1.1.1z'/%3e%3c/svg%3e\");\n  background-repeat: no-repeat;\n  background-position: right calc(0.375em + 0.1875rem) center;\n  background-size: calc(0.75em + 0.375rem) calc(0.75em + 0.375rem);\n}\n.was-validated .form-control:valid:focus, .form-control.is-valid:focus {\n  border-color: #198754;\n  box-shadow: 0 0 0 0.25rem rgba(25, 135, 84, 0.25);\n}\n\n.was-validated textarea.form-control:valid, textarea.form-control.is-valid {\n  padding-right: calc(1.5em + 0.75rem);\n  background-position: top calc(0.375em + 0.1875rem) right calc(0.375em + 0.1875rem);\n}\n\n.was-validated .form-select:valid, .form-select.is-valid {\n  border-color: #198754;\n}\n.was-validated .form-select:valid:not([multiple]):not([size]), .was-validated .form-select:valid:not([multiple])[size=\"1\"], .form-select.is-valid:not([multiple]):not([size]), .form-select.is-valid:not([multiple])[size=\"1\"] {\n  padding-right: 4.125rem;\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3e%3cpath fill='none' stroke='%23343a40' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M2 5l6 6 6-6'/%3e%3c/svg%3e\"), url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 8 8'%3e%3cpath fill='%23198754' d='M2.3 6.73L.6 4.53c-.4-1.04.46-1.4 1.1-.8l1.1 1.4 3.4-3.8c.6-.63 1.6-.27 1.2.7l-4 4.6c-.43.5-.8.4-1.1.1z'/%3e%3c/svg%3e\");\n  background-position: right 0.75rem center, center right 2.25rem;\n  background-size: 16px 12px, calc(0.75em + 0.375rem) calc(0.75em + 0.375rem);\n}\n.was-validated .form-select:valid:focus, .form-select.is-valid:focus {\n  border-color: #198754;\n  box-shadow: 0 0 0 0.25rem rgba(25, 135, 84, 0.25);\n}\n\n.was-validated .form-check-input:valid, .form-check-input.is-valid {\n  border-color: #198754;\n}\n.was-validated .form-check-input:valid:checked, .form-check-input.is-valid:checked {\n  background-color: #198754;\n}\n.was-validated .form-check-input:valid:focus, .form-check-input.is-valid:focus {\n  box-shadow: 0 0 0 0.25rem rgba(25, 135, 84, 0.25);\n}\n.was-validated .form-check-input:valid ~ .form-check-label, .form-check-input.is-valid ~ .form-check-label {\n  color: #198754;\n}\n\n.form-check-inline .form-check-input ~ .valid-feedback {\n  margin-left: 0.5em;\n}\n\n.was-validated .input-group .form-control:valid, .input-group .form-control.is-valid,\n.was-validated .input-group .form-select:valid,\n.input-group .form-select.is-valid {\n  z-index: 1;\n}\n.was-validated .input-group .form-control:valid:focus, .input-group .form-control.is-valid:focus,\n.was-validated .input-group .form-select:valid:focus,\n.input-group .form-select.is-valid:focus {\n  z-index: 3;\n}\n\n.invalid-feedback {\n  display: none;\n  width: 100%;\n  margin-top: 0.25rem;\n  font-size: 0.875em;\n  color: #dc3545;\n}\n\n.invalid-tooltip {\n  position: absolute;\n  top: 100%;\n  z-index: 5;\n  display: none;\n  max-width: 100%;\n  padding: 0.25rem 0.5rem;\n  margin-top: 0.1rem;\n  font-size: 0.875rem;\n  color: #fff;\n  background-color: rgba(220, 53, 69, 0.9);\n  border-radius: 0.25rem;\n}\n\n.was-validated :invalid ~ .invalid-feedback,\n.was-validated :invalid ~ .invalid-tooltip,\n.is-invalid ~ .invalid-feedback,\n.is-invalid ~ .invalid-tooltip {\n  display: block;\n}\n\n.was-validated .form-control:invalid, .form-control.is-invalid {\n  border-color: #dc3545;\n  padding-right: calc(1.5em + 0.75rem);\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 12 12' width='12' height='12' fill='none' stroke='%23dc3545'%3e%3ccircle cx='6' cy='6' r='4.5'/%3e%3cpath stroke-linejoin='round' d='M5.8 3.6h.4L6 6.5z'/%3e%3ccircle cx='6' cy='8.2' r='.6' fill='%23dc3545' stroke='none'/%3e%3c/svg%3e\");\n  background-repeat: no-repeat;\n  background-position: right calc(0.375em + 0.1875rem) center;\n  background-size: calc(0.75em + 0.375rem) calc(0.75em + 0.375rem);\n}\n.was-validated .form-control:invalid:focus, .form-control.is-invalid:focus {\n  border-color: #dc3545;\n  box-shadow: 0 0 0 0.25rem rgba(220, 53, 69, 0.25);\n}\n\n.was-validated textarea.form-control:invalid, textarea.form-control.is-invalid {\n  padding-right: calc(1.5em + 0.75rem);\n  background-position: top calc(0.375em + 0.1875rem) right calc(0.375em + 0.1875rem);\n}\n\n.was-validated .form-select:invalid, .form-select.is-invalid {\n  border-color: #dc3545;\n}\n.was-validated .form-select:invalid:not([multiple]):not([size]), .was-validated .form-select:invalid:not([multiple])[size=\"1\"], .form-select.is-invalid:not([multiple]):not([size]), .form-select.is-invalid:not([multiple])[size=\"1\"] {\n  padding-right: 4.125rem;\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3e%3cpath fill='none' stroke='%23343a40' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M2 5l6 6 6-6'/%3e%3c/svg%3e\"), url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 12 12' width='12' height='12' fill='none' stroke='%23dc3545'%3e%3ccircle cx='6' cy='6' r='4.5'/%3e%3cpath stroke-linejoin='round' d='M5.8 3.6h.4L6 6.5z'/%3e%3ccircle cx='6' cy='8.2' r='.6' fill='%23dc3545' stroke='none'/%3e%3c/svg%3e\");\n  background-position: right 0.75rem center, center right 2.25rem;\n  background-size: 16px 12px, calc(0.75em + 0.375rem) calc(0.75em + 0.375rem);\n}\n.was-validated .form-select:invalid:focus, .form-select.is-invalid:focus {\n  border-color: #dc3545;\n  box-shadow: 0 0 0 0.25rem rgba(220, 53, 69, 0.25);\n}\n\n.was-validated .form-check-input:invalid, .form-check-input.is-invalid {\n  border-color: #dc3545;\n}\n.was-validated .form-check-input:invalid:checked, .form-check-input.is-invalid:checked {\n  background-color: #dc3545;\n}\n.was-validated .form-check-input:invalid:focus, .form-check-input.is-invalid:focus {\n  box-shadow: 0 0 0 0.25rem rgba(220, 53, 69, 0.25);\n}\n.was-validated .form-check-input:invalid ~ .form-check-label, .form-check-input.is-invalid ~ .form-check-label {\n  color: #dc3545;\n}\n\n.form-check-inline .form-check-input ~ .invalid-feedback {\n  margin-left: 0.5em;\n}\n\n.was-validated .input-group .form-control:invalid, .input-group .form-control.is-invalid,\n.was-validated .input-group .form-select:invalid,\n.input-group .form-select.is-invalid {\n  z-index: 2;\n}\n.was-validated .input-group .form-control:invalid:focus, .input-group .form-control.is-invalid:focus,\n.was-validated .input-group .form-select:invalid:focus,\n.input-group .form-select.is-invalid:focus {\n  z-index: 3;\n}\n\n.btn {\n  display: inline-block;\n  font-weight: 400;\n  line-height: 1.5;\n  color: #212529;\n  text-align: center;\n  text-decoration: none;\n  vertical-align: middle;\n  cursor: pointer;\n  -webkit-user-select: none;\n  -moz-user-select: none;\n  user-select: none;\n  background-color: transparent;\n  border: 1px solid transparent;\n  padding: 0.375rem 0.75rem;\n  font-size: 1rem;\n  border-radius: 0.25rem;\n  transition: color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n}\n@media (prefers-reduced-motion: reduce) {\n  .btn {\n    transition: none;\n  }\n}\n.btn:hover {\n  color: #212529;\n}\n.btn-check:focus + .btn, .btn:focus {\n  outline: 0;\n  box-shadow: 0 0 0 0.25rem rgba(13, 110, 253, 0.25);\n}\n.btn:disabled, .btn.disabled, fieldset:disabled .btn {\n  pointer-events: none;\n  opacity: 0.65;\n}\n\n.btn-primary {\n  color: #fff;\n  background-color: #0d6efd;\n  border-color: #0d6efd;\n}\n.btn-primary:hover {\n  color: #fff;\n  background-color: #0b5ed7;\n  border-color: #0a58ca;\n}\n.btn-check:focus + .btn-primary, .btn-primary:focus {\n  color: #fff;\n  background-color: #0b5ed7;\n  border-color: #0a58ca;\n  box-shadow: 0 0 0 0.25rem rgba(49, 132, 253, 0.5);\n}\n.btn-check:checked + .btn-primary, .btn-check:active + .btn-primary, .btn-primary:active, .btn-primary.active, .show > .btn-primary.dropdown-toggle {\n  color: #fff;\n  background-color: #0a58ca;\n  border-color: #0a53be;\n}\n.btn-check:checked + .btn-primary:focus, .btn-check:active + .btn-primary:focus, .btn-primary:active:focus, .btn-primary.active:focus, .show > .btn-primary.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.25rem rgba(49, 132, 253, 0.5);\n}\n.btn-primary:disabled, .btn-primary.disabled {\n  color: #fff;\n  background-color: #0d6efd;\n  border-color: #0d6efd;\n}\n\n.btn-secondary {\n  color: #fff;\n  background-color: #6c757d;\n  border-color: #6c757d;\n}\n.btn-secondary:hover {\n  color: #fff;\n  background-color: #5c636a;\n  border-color: #565e64;\n}\n.btn-check:focus + .btn-secondary, .btn-secondary:focus {\n  color: #fff;\n  background-color: #5c636a;\n  border-color: #565e64;\n  box-shadow: 0 0 0 0.25rem rgba(130, 138, 145, 0.5);\n}\n.btn-check:checked + .btn-secondary, .btn-check:active + .btn-secondary, .btn-secondary:active, .btn-secondary.active, .show > .btn-secondary.dropdown-toggle {\n  color: #fff;\n  background-color: #565e64;\n  border-color: #51585e;\n}\n.btn-check:checked + .btn-secondary:focus, .btn-check:active + .btn-secondary:focus, .btn-secondary:active:focus, .btn-secondary.active:focus, .show > .btn-secondary.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.25rem rgba(130, 138, 145, 0.5);\n}\n.btn-secondary:disabled, .btn-secondary.disabled {\n  color: #fff;\n  background-color: #6c757d;\n  border-color: #6c757d;\n}\n\n.btn-success {\n  color: #fff;\n  background-color: #198754;\n  border-color: #198754;\n}\n.btn-success:hover {\n  color: #fff;\n  background-color: #157347;\n  border-color: #146c43;\n}\n.btn-check:focus + .btn-success, .btn-success:focus {\n  color: #fff;\n  background-color: #157347;\n  border-color: #146c43;\n  box-shadow: 0 0 0 0.25rem rgba(60, 153, 110, 0.5);\n}\n.btn-check:checked + .btn-success, .btn-check:active + .btn-success, .btn-success:active, .btn-success.active, .show > .btn-success.dropdown-toggle {\n  color: #fff;\n  background-color: #146c43;\n  border-color: #13653f;\n}\n.btn-check:checked + .btn-success:focus, .btn-check:active + .btn-success:focus, .btn-success:active:focus, .btn-success.active:focus, .show > .btn-success.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.25rem rgba(60, 153, 110, 0.5);\n}\n.btn-success:disabled, .btn-success.disabled {\n  color: #fff;\n  background-color: #198754;\n  border-color: #198754;\n}\n\n.btn-info {\n  color: #000;\n  background-color: #0dcaf0;\n  border-color: #0dcaf0;\n}\n.btn-info:hover {\n  color: #000;\n  background-color: #31d2f2;\n  border-color: #25cff2;\n}\n.btn-check:focus + .btn-info, .btn-info:focus {\n  color: #000;\n  background-color: #31d2f2;\n  border-color: #25cff2;\n  box-shadow: 0 0 0 0.25rem rgba(11, 172, 204, 0.5);\n}\n.btn-check:checked + .btn-info, .btn-check:active + .btn-info, .btn-info:active, .btn-info.active, .show > .btn-info.dropdown-toggle {\n  color: #000;\n  background-color: #3dd5f3;\n  border-color: #25cff2;\n}\n.btn-check:checked + .btn-info:focus, .btn-check:active + .btn-info:focus, .btn-info:active:focus, .btn-info.active:focus, .show > .btn-info.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.25rem rgba(11, 172, 204, 0.5);\n}\n.btn-info:disabled, .btn-info.disabled {\n  color: #000;\n  background-color: #0dcaf0;\n  border-color: #0dcaf0;\n}\n\n.btn-warning {\n  color: #000;\n  background-color: #ffc107;\n  border-color: #ffc107;\n}\n.btn-warning:hover {\n  color: #000;\n  background-color: #ffca2c;\n  border-color: #ffc720;\n}\n.btn-check:focus + .btn-warning, .btn-warning:focus {\n  color: #000;\n  background-color: #ffca2c;\n  border-color: #ffc720;\n  box-shadow: 0 0 0 0.25rem rgba(217, 164, 6, 0.5);\n}\n.btn-check:checked + .btn-warning, .btn-check:active + .btn-warning, .btn-warning:active, .btn-warning.active, .show > .btn-warning.dropdown-toggle {\n  color: #000;\n  background-color: #ffcd39;\n  border-color: #ffc720;\n}\n.btn-check:checked + .btn-warning:focus, .btn-check:active + .btn-warning:focus, .btn-warning:active:focus, .btn-warning.active:focus, .show > .btn-warning.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.25rem rgba(217, 164, 6, 0.5);\n}\n.btn-warning:disabled, .btn-warning.disabled {\n  color: #000;\n  background-color: #ffc107;\n  border-color: #ffc107;\n}\n\n.btn-danger {\n  color: #fff;\n  background-color: #dc3545;\n  border-color: #dc3545;\n}\n.btn-danger:hover {\n  color: #fff;\n  background-color: #bb2d3b;\n  border-color: #b02a37;\n}\n.btn-check:focus + .btn-danger, .btn-danger:focus {\n  color: #fff;\n  background-color: #bb2d3b;\n  border-color: #b02a37;\n  box-shadow: 0 0 0 0.25rem rgba(225, 83, 97, 0.5);\n}\n.btn-check:checked + .btn-danger, .btn-check:active + .btn-danger, .btn-danger:active, .btn-danger.active, .show > .btn-danger.dropdown-toggle {\n  color: #fff;\n  background-color: #b02a37;\n  border-color: #a52834;\n}\n.btn-check:checked + .btn-danger:focus, .btn-check:active + .btn-danger:focus, .btn-danger:active:focus, .btn-danger.active:focus, .show > .btn-danger.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.25rem rgba(225, 83, 97, 0.5);\n}\n.btn-danger:disabled, .btn-danger.disabled {\n  color: #fff;\n  background-color: #dc3545;\n  border-color: #dc3545;\n}\n\n.btn-light {\n  color: #000;\n  background-color: #f8f9fa;\n  border-color: #f8f9fa;\n}\n.btn-light:hover {\n  color: #000;\n  background-color: #f9fafb;\n  border-color: #f9fafb;\n}\n.btn-check:focus + .btn-light, .btn-light:focus {\n  color: #000;\n  background-color: #f9fafb;\n  border-color: #f9fafb;\n  box-shadow: 0 0 0 0.25rem rgba(211, 212, 213, 0.5);\n}\n.btn-check:checked + .btn-light, .btn-check:active + .btn-light, .btn-light:active, .btn-light.active, .show > .btn-light.dropdown-toggle {\n  color: #000;\n  background-color: #f9fafb;\n  border-color: #f9fafb;\n}\n.btn-check:checked + .btn-light:focus, .btn-check:active + .btn-light:focus, .btn-light:active:focus, .btn-light.active:focus, .show > .btn-light.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.25rem rgba(211, 212, 213, 0.5);\n}\n.btn-light:disabled, .btn-light.disabled {\n  color: #000;\n  background-color: #f8f9fa;\n  border-color: #f8f9fa;\n}\n\n.btn-dark {\n  color: #fff;\n  background-color: #212529;\n  border-color: #212529;\n}\n.btn-dark:hover {\n  color: #fff;\n  background-color: #1c1f23;\n  border-color: #1a1e21;\n}\n.btn-check:focus + .btn-dark, .btn-dark:focus {\n  color: #fff;\n  background-color: #1c1f23;\n  border-color: #1a1e21;\n  box-shadow: 0 0 0 0.25rem rgba(66, 70, 73, 0.5);\n}\n.btn-check:checked + .btn-dark, .btn-check:active + .btn-dark, .btn-dark:active, .btn-dark.active, .show > .btn-dark.dropdown-toggle {\n  color: #fff;\n  background-color: #1a1e21;\n  border-color: #191c1f;\n}\n.btn-check:checked + .btn-dark:focus, .btn-check:active + .btn-dark:focus, .btn-dark:active:focus, .btn-dark.active:focus, .show > .btn-dark.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.25rem rgba(66, 70, 73, 0.5);\n}\n.btn-dark:disabled, .btn-dark.disabled {\n  color: #fff;\n  background-color: #212529;\n  border-color: #212529;\n}\n\n.btn-outline-primary {\n  color: #0d6efd;\n  border-color: #0d6efd;\n}\n.btn-outline-primary:hover {\n  color: #fff;\n  background-color: #0d6efd;\n  border-color: #0d6efd;\n}\n.btn-check:focus + .btn-outline-primary, .btn-outline-primary:focus {\n  box-shadow: 0 0 0 0.25rem rgba(13, 110, 253, 0.5);\n}\n.btn-check:checked + .btn-outline-primary, .btn-check:active + .btn-outline-primary, .btn-outline-primary:active, .btn-outline-primary.active, .btn-outline-primary.dropdown-toggle.show {\n  color: #fff;\n  background-color: #0d6efd;\n  border-color: #0d6efd;\n}\n.btn-check:checked + .btn-outline-primary:focus, .btn-check:active + .btn-outline-primary:focus, .btn-outline-primary:active:focus, .btn-outline-primary.active:focus, .btn-outline-primary.dropdown-toggle.show:focus {\n  box-shadow: 0 0 0 0.25rem rgba(13, 110, 253, 0.5);\n}\n.btn-outline-primary:disabled, .btn-outline-primary.disabled {\n  color: #0d6efd;\n  background-color: transparent;\n}\n\n.btn-outline-secondary {\n  color: #6c757d;\n  border-color: #6c757d;\n}\n.btn-outline-secondary:hover {\n  color: #fff;\n  background-color: #6c757d;\n  border-color: #6c757d;\n}\n.btn-check:focus + .btn-outline-secondary, .btn-outline-secondary:focus {\n  box-shadow: 0 0 0 0.25rem rgba(108, 117, 125, 0.5);\n}\n.btn-check:checked + .btn-outline-secondary, .btn-check:active + .btn-outline-secondary, .btn-outline-secondary:active, .btn-outline-secondary.active, .btn-outline-secondary.dropdown-toggle.show {\n  color: #fff;\n  background-color: #6c757d;\n  border-color: #6c757d;\n}\n.btn-check:checked + .btn-outline-secondary:focus, .btn-check:active + .btn-outline-secondary:focus, .btn-outline-secondary:active:focus, .btn-outline-secondary.active:focus, .btn-outline-secondary.dropdown-toggle.show:focus {\n  box-shadow: 0 0 0 0.25rem rgba(108, 117, 125, 0.5);\n}\n.btn-outline-secondary:disabled, .btn-outline-secondary.disabled {\n  color: #6c757d;\n  background-color: transparent;\n}\n\n.btn-outline-success {\n  color: #198754;\n  border-color: #198754;\n}\n.btn-outline-success:hover {\n  color: #fff;\n  background-color: #198754;\n  border-color: #198754;\n}\n.btn-check:focus + .btn-outline-success, .btn-outline-success:focus {\n  box-shadow: 0 0 0 0.25rem rgba(25, 135, 84, 0.5);\n}\n.btn-check:checked + .btn-outline-success, .btn-check:active + .btn-outline-success, .btn-outline-success:active, .btn-outline-success.active, .btn-outline-success.dropdown-toggle.show {\n  color: #fff;\n  background-color: #198754;\n  border-color: #198754;\n}\n.btn-check:checked + .btn-outline-success:focus, .btn-check:active + .btn-outline-success:focus, .btn-outline-success:active:focus, .btn-outline-success.active:focus, .btn-outline-success.dropdown-toggle.show:focus {\n  box-shadow: 0 0 0 0.25rem rgba(25, 135, 84, 0.5);\n}\n.btn-outline-success:disabled, .btn-outline-success.disabled {\n  color: #198754;\n  background-color: transparent;\n}\n\n.btn-outline-info {\n  color: #0dcaf0;\n  border-color: #0dcaf0;\n}\n.btn-outline-info:hover {\n  color: #000;\n  background-color: #0dcaf0;\n  border-color: #0dcaf0;\n}\n.btn-check:focus + .btn-outline-info, .btn-outline-info:focus {\n  box-shadow: 0 0 0 0.25rem rgba(13, 202, 240, 0.5);\n}\n.btn-check:checked + .btn-outline-info, .btn-check:active + .btn-outline-info, .btn-outline-info:active, .btn-outline-info.active, .btn-outline-info.dropdown-toggle.show {\n  color: #000;\n  background-color: #0dcaf0;\n  border-color: #0dcaf0;\n}\n.btn-check:checked + .btn-outline-info:focus, .btn-check:active + .btn-outline-info:focus, .btn-outline-info:active:focus, .btn-outline-info.active:focus, .btn-outline-info.dropdown-toggle.show:focus {\n  box-shadow: 0 0 0 0.25rem rgba(13, 202, 240, 0.5);\n}\n.btn-outline-info:disabled, .btn-outline-info.disabled {\n  color: #0dcaf0;\n  background-color: transparent;\n}\n\n.btn-outline-warning {\n  color: #ffc107;\n  border-color: #ffc107;\n}\n.btn-outline-warning:hover {\n  color: #000;\n  background-color: #ffc107;\n  border-color: #ffc107;\n}\n.btn-check:focus + .btn-outline-warning, .btn-outline-warning:focus {\n  box-shadow: 0 0 0 0.25rem rgba(255, 193, 7, 0.5);\n}\n.btn-check:checked + .btn-outline-warning, .btn-check:active + .btn-outline-warning, .btn-outline-warning:active, .btn-outline-warning.active, .btn-outline-warning.dropdown-toggle.show {\n  color: #000;\n  background-color: #ffc107;\n  border-color: #ffc107;\n}\n.btn-check:checked + .btn-outline-warning:focus, .btn-check:active + .btn-outline-warning:focus, .btn-outline-warning:active:focus, .btn-outline-warning.active:focus, .btn-outline-warning.dropdown-toggle.show:focus {\n  box-shadow: 0 0 0 0.25rem rgba(255, 193, 7, 0.5);\n}\n.btn-outline-warning:disabled, .btn-outline-warning.disabled {\n  color: #ffc107;\n  background-color: transparent;\n}\n\n.btn-outline-danger {\n  color: #dc3545;\n  border-color: #dc3545;\n}\n.btn-outline-danger:hover {\n  color: #fff;\n  background-color: #dc3545;\n  border-color: #dc3545;\n}\n.btn-check:focus + .btn-outline-danger, .btn-outline-danger:focus {\n  box-shadow: 0 0 0 0.25rem rgba(220, 53, 69, 0.5);\n}\n.btn-check:checked + .btn-outline-danger, .btn-check:active + .btn-outline-danger, .btn-outline-danger:active, .btn-outline-danger.active, .btn-outline-danger.dropdown-toggle.show {\n  color: #fff;\n  background-color: #dc3545;\n  border-color: #dc3545;\n}\n.btn-check:checked + .btn-outline-danger:focus, .btn-check:active + .btn-outline-danger:focus, .btn-outline-danger:active:focus, .btn-outline-danger.active:focus, .btn-outline-danger.dropdown-toggle.show:focus {\n  box-shadow: 0 0 0 0.25rem rgba(220, 53, 69, 0.5);\n}\n.btn-outline-danger:disabled, .btn-outline-danger.disabled {\n  color: #dc3545;\n  background-color: transparent;\n}\n\n.btn-outline-light {\n  color: #f8f9fa;\n  border-color: #f8f9fa;\n}\n.btn-outline-light:hover {\n  color: #000;\n  background-color: #f8f9fa;\n  border-color: #f8f9fa;\n}\n.btn-check:focus + .btn-outline-light, .btn-outline-light:focus {\n  box-shadow: 0 0 0 0.25rem rgba(248, 249, 250, 0.5);\n}\n.btn-check:checked + .btn-outline-light, .btn-check:active + .btn-outline-light, .btn-outline-light:active, .btn-outline-light.active, .btn-outline-light.dropdown-toggle.show {\n  color: #000;\n  background-color: #f8f9fa;\n  border-color: #f8f9fa;\n}\n.btn-check:checked + .btn-outline-light:focus, .btn-check:active + .btn-outline-light:focus, .btn-outline-light:active:focus, .btn-outline-light.active:focus, .btn-outline-light.dropdown-toggle.show:focus {\n  box-shadow: 0 0 0 0.25rem rgba(248, 249, 250, 0.5);\n}\n.btn-outline-light:disabled, .btn-outline-light.disabled {\n  color: #f8f9fa;\n  background-color: transparent;\n}\n\n.btn-outline-dark {\n  color: #212529;\n  border-color: #212529;\n}\n.btn-outline-dark:hover {\n  color: #fff;\n  background-color: #212529;\n  border-color: #212529;\n}\n.btn-check:focus + .btn-outline-dark, .btn-outline-dark:focus {\n  box-shadow: 0 0 0 0.25rem rgba(33, 37, 41, 0.5);\n}\n.btn-check:checked + .btn-outline-dark, .btn-check:active + .btn-outline-dark, .btn-outline-dark:active, .btn-outline-dark.active, .btn-outline-dark.dropdown-toggle.show {\n  color: #fff;\n  background-color: #212529;\n  border-color: #212529;\n}\n.btn-check:checked + .btn-outline-dark:focus, .btn-check:active + .btn-outline-dark:focus, .btn-outline-dark:active:focus, .btn-outline-dark.active:focus, .btn-outline-dark.dropdown-toggle.show:focus {\n  box-shadow: 0 0 0 0.25rem rgba(33, 37, 41, 0.5);\n}\n.btn-outline-dark:disabled, .btn-outline-dark.disabled {\n  color: #212529;\n  background-color: transparent;\n}\n\n.btn-link {\n  font-weight: 400;\n  color: #0d6efd;\n  text-decoration: underline;\n}\n.btn-link:hover {\n  color: #0a58ca;\n}\n.btn-link:disabled, .btn-link.disabled {\n  color: #6c757d;\n}\n\n.btn-lg, .btn-group-lg > .btn {\n  padding: 0.5rem 1rem;\n  font-size: 1.25rem;\n  border-radius: 0.3rem;\n}\n\n.btn-sm, .btn-group-sm > .btn {\n  padding: 0.25rem 0.5rem;\n  font-size: 0.875rem;\n  border-radius: 0.2rem;\n}\n\n.fade {\n  transition: opacity 0.15s linear;\n}\n@media (prefers-reduced-motion: reduce) {\n  .fade {\n    transition: none;\n  }\n}\n.fade:not(.show) {\n  opacity: 0;\n}\n\n.collapse:not(.show) {\n  display: none;\n}\n\n.collapsing {\n  height: 0;\n  overflow: hidden;\n  transition: height 0.35s ease;\n}\n@media (prefers-reduced-motion: reduce) {\n  .collapsing {\n    transition: none;\n  }\n}\n.collapsing.collapse-horizontal {\n  width: 0;\n  height: auto;\n  transition: width 0.35s ease;\n}\n@media (prefers-reduced-motion: reduce) {\n  .collapsing.collapse-horizontal {\n    transition: none;\n  }\n}\n\n.dropup,\n.dropend,\n.dropdown,\n.dropstart {\n  position: relative;\n}\n\n.dropdown-toggle {\n  white-space: nowrap;\n}\n.dropdown-toggle::after {\n  display: inline-block;\n  margin-left: 0.255em;\n  vertical-align: 0.255em;\n  content: \"\";\n  border-top: 0.3em solid;\n  border-right: 0.3em solid transparent;\n  border-bottom: 0;\n  border-left: 0.3em solid transparent;\n}\n.dropdown-toggle:empty::after {\n  margin-left: 0;\n}\n\n.dropdown-menu {\n  position: absolute;\n  z-index: 1000;\n  display: none;\n  min-width: 10rem;\n  padding: 0.5rem 0;\n  margin: 0;\n  font-size: 1rem;\n  color: #212529;\n  text-align: left;\n  list-style: none;\n  background-color: #fff;\n  background-clip: padding-box;\n  border: 1px solid rgba(0, 0, 0, 0.15);\n  border-radius: 0.25rem;\n}\n.dropdown-menu[data-bs-popper] {\n  top: 100%;\n  left: 0;\n  margin-top: 0.125rem;\n}\n\n.dropdown-menu-start {\n  --bs-position: start;\n}\n.dropdown-menu-start[data-bs-popper] {\n  right: auto;\n  left: 0;\n}\n\n.dropdown-menu-end {\n  --bs-position: end;\n}\n.dropdown-menu-end[data-bs-popper] {\n  right: 0;\n  left: auto;\n}\n\n@media (min-width: 576px) {\n  .dropdown-menu-sm-start {\n    --bs-position: start;\n  }\n  .dropdown-menu-sm-start[data-bs-popper] {\n    right: auto;\n    left: 0;\n  }\n\n  .dropdown-menu-sm-end {\n    --bs-position: end;\n  }\n  .dropdown-menu-sm-end[data-bs-popper] {\n    right: 0;\n    left: auto;\n  }\n}\n@media (min-width: 768px) {\n  .dropdown-menu-md-start {\n    --bs-position: start;\n  }\n  .dropdown-menu-md-start[data-bs-popper] {\n    right: auto;\n    left: 0;\n  }\n\n  .dropdown-menu-md-end {\n    --bs-position: end;\n  }\n  .dropdown-menu-md-end[data-bs-popper] {\n    right: 0;\n    left: auto;\n  }\n}\n@media (min-width: 992px) {\n  .dropdown-menu-lg-start {\n    --bs-position: start;\n  }\n  .dropdown-menu-lg-start[data-bs-popper] {\n    right: auto;\n    left: 0;\n  }\n\n  .dropdown-menu-lg-end {\n    --bs-position: end;\n  }\n  .dropdown-menu-lg-end[data-bs-popper] {\n    right: 0;\n    left: auto;\n  }\n}\n@media (min-width: 1200px) {\n  .dropdown-menu-xl-start {\n    --bs-position: start;\n  }\n  .dropdown-menu-xl-start[data-bs-popper] {\n    right: auto;\n    left: 0;\n  }\n\n  .dropdown-menu-xl-end {\n    --bs-position: end;\n  }\n  .dropdown-menu-xl-end[data-bs-popper] {\n    right: 0;\n    left: auto;\n  }\n}\n@media (min-width: 1400px) {\n  .dropdown-menu-xxl-start {\n    --bs-position: start;\n  }\n  .dropdown-menu-xxl-start[data-bs-popper] {\n    right: auto;\n    left: 0;\n  }\n\n  .dropdown-menu-xxl-end {\n    --bs-position: end;\n  }\n  .dropdown-menu-xxl-end[data-bs-popper] {\n    right: 0;\n    left: auto;\n  }\n}\n.dropup .dropdown-menu[data-bs-popper] {\n  top: auto;\n  bottom: 100%;\n  margin-top: 0;\n  margin-bottom: 0.125rem;\n}\n.dropup .dropdown-toggle::after {\n  display: inline-block;\n  margin-left: 0.255em;\n  vertical-align: 0.255em;\n  content: \"\";\n  border-top: 0;\n  border-right: 0.3em solid transparent;\n  border-bottom: 0.3em solid;\n  border-left: 0.3em solid transparent;\n}\n.dropup .dropdown-toggle:empty::after {\n  margin-left: 0;\n}\n\n.dropend .dropdown-menu[data-bs-popper] {\n  top: 0;\n  right: auto;\n  left: 100%;\n  margin-top: 0;\n  margin-left: 0.125rem;\n}\n.dropend .dropdown-toggle::after {\n  display: inline-block;\n  margin-left: 0.255em;\n  vertical-align: 0.255em;\n  content: \"\";\n  border-top: 0.3em solid transparent;\n  border-right: 0;\n  border-bottom: 0.3em solid transparent;\n  border-left: 0.3em solid;\n}\n.dropend .dropdown-toggle:empty::after {\n  margin-left: 0;\n}\n.dropend .dropdown-toggle::after {\n  vertical-align: 0;\n}\n\n.dropstart .dropdown-menu[data-bs-popper] {\n  top: 0;\n  right: 100%;\n  left: auto;\n  margin-top: 0;\n  margin-right: 0.125rem;\n}\n.dropstart .dropdown-toggle::after {\n  display: inline-block;\n  margin-left: 0.255em;\n  vertical-align: 0.255em;\n  content: \"\";\n}\n.dropstart .dropdown-toggle::after {\n  display: none;\n}\n.dropstart .dropdown-toggle::before {\n  display: inline-block;\n  margin-right: 0.255em;\n  vertical-align: 0.255em;\n  content: \"\";\n  border-top: 0.3em solid transparent;\n  border-right: 0.3em solid;\n  border-bottom: 0.3em solid transparent;\n}\n.dropstart .dropdown-toggle:empty::after {\n  margin-left: 0;\n}\n.dropstart .dropdown-toggle::before {\n  vertical-align: 0;\n}\n\n.dropdown-divider {\n  height: 0;\n  margin: 0.5rem 0;\n  overflow: hidden;\n  border-top: 1px solid rgba(0, 0, 0, 0.15);\n}\n\n.dropdown-item {\n  display: block;\n  width: 100%;\n  padding: 0.25rem 1rem;\n  clear: both;\n  font-weight: 400;\n  color: #212529;\n  text-align: inherit;\n  text-decoration: none;\n  white-space: nowrap;\n  background-color: transparent;\n  border: 0;\n}\n.dropdown-item:hover, .dropdown-item:focus {\n  color: #1e2125;\n  background-color: #e9ecef;\n}\n.dropdown-item.active, .dropdown-item:active {\n  color: #fff;\n  text-decoration: none;\n  background-color: #0d6efd;\n}\n.dropdown-item.disabled, .dropdown-item:disabled {\n  color: #adb5bd;\n  pointer-events: none;\n  background-color: transparent;\n}\n\n.dropdown-menu.show {\n  display: block;\n}\n\n.dropdown-header {\n  display: block;\n  padding: 0.5rem 1rem;\n  margin-bottom: 0;\n  font-size: 0.875rem;\n  color: #6c757d;\n  white-space: nowrap;\n}\n\n.dropdown-item-text {\n  display: block;\n  padding: 0.25rem 1rem;\n  color: #212529;\n}\n\n.dropdown-menu-dark {\n  color: #dee2e6;\n  background-color: #343a40;\n  border-color: rgba(0, 0, 0, 0.15);\n}\n.dropdown-menu-dark .dropdown-item {\n  color: #dee2e6;\n}\n.dropdown-menu-dark .dropdown-item:hover, .dropdown-menu-dark .dropdown-item:focus {\n  color: #fff;\n  background-color: rgba(255, 255, 255, 0.15);\n}\n.dropdown-menu-dark .dropdown-item.active, .dropdown-menu-dark .dropdown-item:active {\n  color: #fff;\n  background-color: #0d6efd;\n}\n.dropdown-menu-dark .dropdown-item.disabled, .dropdown-menu-dark .dropdown-item:disabled {\n  color: #adb5bd;\n}\n.dropdown-menu-dark .dropdown-divider {\n  border-color: rgba(0, 0, 0, 0.15);\n}\n.dropdown-menu-dark .dropdown-item-text {\n  color: #dee2e6;\n}\n.dropdown-menu-dark .dropdown-header {\n  color: #adb5bd;\n}\n\n.btn-group,\n.btn-group-vertical {\n  position: relative;\n  display: inline-flex;\n  vertical-align: middle;\n}\n.btn-group > .btn,\n.btn-group-vertical > .btn {\n  position: relative;\n  flex: 1 1 auto;\n}\n.btn-group > .btn-check:checked + .btn,\n.btn-group > .btn-check:focus + .btn,\n.btn-group > .btn:hover,\n.btn-group > .btn:focus,\n.btn-group > .btn:active,\n.btn-group > .btn.active,\n.btn-group-vertical > .btn-check:checked + .btn,\n.btn-group-vertical > .btn-check:focus + .btn,\n.btn-group-vertical > .btn:hover,\n.btn-group-vertical > .btn:focus,\n.btn-group-vertical > .btn:active,\n.btn-group-vertical > .btn.active {\n  z-index: 1;\n}\n\n.btn-toolbar {\n  display: flex;\n  flex-wrap: wrap;\n  justify-content: flex-start;\n}\n.btn-toolbar .input-group {\n  width: auto;\n}\n\n.btn-group > .btn:not(:first-child),\n.btn-group > .btn-group:not(:first-child) {\n  margin-left: -1px;\n}\n.btn-group > .btn:not(:last-child):not(.dropdown-toggle),\n.btn-group > .btn-group:not(:last-child) > .btn {\n  border-top-right-radius: 0;\n  border-bottom-right-radius: 0;\n}\n.btn-group > .btn:nth-child(n+3),\n.btn-group > :not(.btn-check) + .btn,\n.btn-group > .btn-group:not(:first-child) > .btn {\n  border-top-left-radius: 0;\n  border-bottom-left-radius: 0;\n}\n\n.dropdown-toggle-split {\n  padding-right: 0.5625rem;\n  padding-left: 0.5625rem;\n}\n.dropdown-toggle-split::after, .dropup .dropdown-toggle-split::after, .dropend .dropdown-toggle-split::after {\n  margin-left: 0;\n}\n.dropstart .dropdown-toggle-split::before {\n  margin-right: 0;\n}\n\n.btn-sm + .dropdown-toggle-split, .btn-group-sm > .btn + .dropdown-toggle-split {\n  padding-right: 0.375rem;\n  padding-left: 0.375rem;\n}\n\n.btn-lg + .dropdown-toggle-split, .btn-group-lg > .btn + .dropdown-toggle-split {\n  padding-right: 0.75rem;\n  padding-left: 0.75rem;\n}\n\n.btn-group-vertical {\n  flex-direction: column;\n  align-items: flex-start;\n  justify-content: center;\n}\n.btn-group-vertical > .btn,\n.btn-group-vertical > .btn-group {\n  width: 100%;\n}\n.btn-group-vertical > .btn:not(:first-child),\n.btn-group-vertical > .btn-group:not(:first-child) {\n  margin-top: -1px;\n}\n.btn-group-vertical > .btn:not(:last-child):not(.dropdown-toggle),\n.btn-group-vertical > .btn-group:not(:last-child) > .btn {\n  border-bottom-right-radius: 0;\n  border-bottom-left-radius: 0;\n}\n.btn-group-vertical > .btn ~ .btn,\n.btn-group-vertical > .btn-group:not(:first-child) > .btn {\n  border-top-left-radius: 0;\n  border-top-right-radius: 0;\n}\n\n.nav {\n  display: flex;\n  flex-wrap: wrap;\n  padding-left: 0;\n  margin-bottom: 0;\n  list-style: none;\n}\n\n.nav-link {\n  display: block;\n  padding: 0.5rem 1rem;\n  color: #0d6efd;\n  text-decoration: none;\n  transition: color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out;\n}\n@media (prefers-reduced-motion: reduce) {\n  .nav-link {\n    transition: none;\n  }\n}\n.nav-link:hover, .nav-link:focus {\n  color: #0a58ca;\n}\n.nav-link.disabled {\n  color: #6c757d;\n  pointer-events: none;\n  cursor: default;\n}\n\n.nav-tabs {\n  border-bottom: 1px solid #dee2e6;\n}\n.nav-tabs .nav-link {\n  margin-bottom: -1px;\n  background: none;\n  border: 1px solid transparent;\n  border-top-left-radius: 0.25rem;\n  border-top-right-radius: 0.25rem;\n}\n.nav-tabs .nav-link:hover, .nav-tabs .nav-link:focus {\n  border-color: #e9ecef #e9ecef #dee2e6;\n  isolation: isolate;\n}\n.nav-tabs .nav-link.disabled {\n  color: #6c757d;\n  background-color: transparent;\n  border-color: transparent;\n}\n.nav-tabs .nav-link.active,\n.nav-tabs .nav-item.show .nav-link {\n  color: #495057;\n  background-color: #fff;\n  border-color: #dee2e6 #dee2e6 #fff;\n}\n.nav-tabs .dropdown-menu {\n  margin-top: -1px;\n  border-top-left-radius: 0;\n  border-top-right-radius: 0;\n}\n\n.nav-pills .nav-link {\n  background: none;\n  border: 0;\n  border-radius: 0.25rem;\n}\n.nav-pills .nav-link.active,\n.nav-pills .show > .nav-link {\n  color: #fff;\n  background-color: #0d6efd;\n}\n\n.nav-fill > .nav-link,\n.nav-fill .nav-item {\n  flex: 1 1 auto;\n  text-align: center;\n}\n\n.nav-justified > .nav-link,\n.nav-justified .nav-item {\n  flex-basis: 0;\n  flex-grow: 1;\n  text-align: center;\n}\n\n.nav-fill .nav-item .nav-link,\n.nav-justified .nav-item .nav-link {\n  width: 100%;\n}\n\n.tab-content > .tab-pane {\n  display: none;\n}\n.tab-content > .active {\n  display: block;\n}\n\n.navbar {\n  position: relative;\n  display: flex;\n  flex-wrap: wrap;\n  align-items: center;\n  justify-content: space-between;\n  padding-top: 0.5rem;\n  padding-bottom: 0.5rem;\n}\n.navbar > .container,\n.navbar > .container-fluid,\n.navbar > .container-sm,\n.navbar > .container-md,\n.navbar > .container-lg,\n.navbar > .container-xl,\n.navbar > .container-xxl {\n  display: flex;\n  flex-wrap: inherit;\n  align-items: center;\n  justify-content: space-between;\n}\n.navbar-brand {\n  padding-top: 0.3125rem;\n  padding-bottom: 0.3125rem;\n  margin-right: 1rem;\n  font-size: 1.25rem;\n  text-decoration: none;\n  white-space: nowrap;\n}\n.navbar-nav {\n  display: flex;\n  flex-direction: column;\n  padding-left: 0;\n  margin-bottom: 0;\n  list-style: none;\n}\n.navbar-nav .nav-link {\n  padding-right: 0;\n  padding-left: 0;\n}\n.navbar-nav .dropdown-menu {\n  position: static;\n}\n\n.navbar-text {\n  padding-top: 0.5rem;\n  padding-bottom: 0.5rem;\n}\n\n.navbar-collapse {\n  flex-basis: 100%;\n  flex-grow: 1;\n  align-items: center;\n}\n\n.navbar-toggler {\n  padding: 0.25rem 0.75rem;\n  font-size: 1.25rem;\n  line-height: 1;\n  background-color: transparent;\n  border: 1px solid transparent;\n  border-radius: 0.25rem;\n  transition: box-shadow 0.15s ease-in-out;\n}\n@media (prefers-reduced-motion: reduce) {\n  .navbar-toggler {\n    transition: none;\n  }\n}\n.navbar-toggler:hover {\n  text-decoration: none;\n}\n.navbar-toggler:focus {\n  text-decoration: none;\n  outline: 0;\n  box-shadow: 0 0 0 0.25rem;\n}\n\n.navbar-toggler-icon {\n  display: inline-block;\n  width: 1.5em;\n  height: 1.5em;\n  vertical-align: middle;\n  background-repeat: no-repeat;\n  background-position: center;\n  background-size: 100%;\n}\n\n.navbar-nav-scroll {\n  max-height: var(--bs-scroll-height, 75vh);\n  overflow-y: auto;\n}\n\n@media (min-width: 576px) {\n  .navbar-expand-sm {\n    flex-wrap: nowrap;\n    justify-content: flex-start;\n  }\n  .navbar-expand-sm .navbar-nav {\n    flex-direction: row;\n  }\n  .navbar-expand-sm .navbar-nav .dropdown-menu {\n    position: absolute;\n  }\n  .navbar-expand-sm .navbar-nav .nav-link {\n    padding-right: 0.5rem;\n    padding-left: 0.5rem;\n  }\n  .navbar-expand-sm .navbar-nav-scroll {\n    overflow: visible;\n  }\n  .navbar-expand-sm .navbar-collapse {\n    display: flex !important;\n    flex-basis: auto;\n  }\n  .navbar-expand-sm .navbar-toggler {\n    display: none;\n  }\n  .navbar-expand-sm .offcanvas-header {\n    display: none;\n  }\n  .navbar-expand-sm .offcanvas {\n    position: inherit;\n    bottom: 0;\n    z-index: 1000;\n    flex-grow: 1;\n    visibility: visible !important;\n    background-color: transparent;\n    border-right: 0;\n    border-left: 0;\n    transition: none;\n    transform: none;\n  }\n  .navbar-expand-sm .offcanvas-top,\n.navbar-expand-sm .offcanvas-bottom {\n    height: auto;\n    border-top: 0;\n    border-bottom: 0;\n  }\n  .navbar-expand-sm .offcanvas-body {\n    display: flex;\n    flex-grow: 0;\n    padding: 0;\n    overflow-y: visible;\n  }\n}\n@media (min-width: 768px) {\n  .navbar-expand-md {\n    flex-wrap: nowrap;\n    justify-content: flex-start;\n  }\n  .navbar-expand-md .navbar-nav {\n    flex-direction: row;\n  }\n  .navbar-expand-md .navbar-nav .dropdown-menu {\n    position: absolute;\n  }\n  .navbar-expand-md .navbar-nav .nav-link {\n    padding-right: 0.5rem;\n    padding-left: 0.5rem;\n  }\n  .navbar-expand-md .navbar-nav-scroll {\n    overflow: visible;\n  }\n  .navbar-expand-md .navbar-collapse {\n    display: flex !important;\n    flex-basis: auto;\n  }\n  .navbar-expand-md .navbar-toggler {\n    display: none;\n  }\n  .navbar-expand-md .offcanvas-header {\n    display: none;\n  }\n  .navbar-expand-md .offcanvas {\n    position: inherit;\n    bottom: 0;\n    z-index: 1000;\n    flex-grow: 1;\n    visibility: visible !important;\n    background-color: transparent;\n    border-right: 0;\n    border-left: 0;\n    transition: none;\n    transform: none;\n  }\n  .navbar-expand-md .offcanvas-top,\n.navbar-expand-md .offcanvas-bottom {\n    height: auto;\n    border-top: 0;\n    border-bottom: 0;\n  }\n  .navbar-expand-md .offcanvas-body {\n    display: flex;\n    flex-grow: 0;\n    padding: 0;\n    overflow-y: visible;\n  }\n}\n@media (min-width: 992px) {\n  .navbar-expand-lg {\n    flex-wrap: nowrap;\n    justify-content: flex-start;\n  }\n  .navbar-expand-lg .navbar-nav {\n    flex-direction: row;\n  }\n  .navbar-expand-lg .navbar-nav .dropdown-menu {\n    position: absolute;\n  }\n  .navbar-expand-lg .navbar-nav .nav-link {\n    padding-right: 0.5rem;\n    padding-left: 0.5rem;\n  }\n  .navbar-expand-lg .navbar-nav-scroll {\n    overflow: visible;\n  }\n  .navbar-expand-lg .navbar-collapse {\n    display: flex !important;\n    flex-basis: auto;\n  }\n  .navbar-expand-lg .navbar-toggler {\n    display: none;\n  }\n  .navbar-expand-lg .offcanvas-header {\n    display: none;\n  }\n  .navbar-expand-lg .offcanvas {\n    position: inherit;\n    bottom: 0;\n    z-index: 1000;\n    flex-grow: 1;\n    visibility: visible !important;\n    background-color: transparent;\n    border-right: 0;\n    border-left: 0;\n    transition: none;\n    transform: none;\n  }\n  .navbar-expand-lg .offcanvas-top,\n.navbar-expand-lg .offcanvas-bottom {\n    height: auto;\n    border-top: 0;\n    border-bottom: 0;\n  }\n  .navbar-expand-lg .offcanvas-body {\n    display: flex;\n    flex-grow: 0;\n    padding: 0;\n    overflow-y: visible;\n  }\n}\n@media (min-width: 1200px) {\n  .navbar-expand-xl {\n    flex-wrap: nowrap;\n    justify-content: flex-start;\n  }\n  .navbar-expand-xl .navbar-nav {\n    flex-direction: row;\n  }\n  .navbar-expand-xl .navbar-nav .dropdown-menu {\n    position: absolute;\n  }\n  .navbar-expand-xl .navbar-nav .nav-link {\n    padding-right: 0.5rem;\n    padding-left: 0.5rem;\n  }\n  .navbar-expand-xl .navbar-nav-scroll {\n    overflow: visible;\n  }\n  .navbar-expand-xl .navbar-collapse {\n    display: flex !important;\n    flex-basis: auto;\n  }\n  .navbar-expand-xl .navbar-toggler {\n    display: none;\n  }\n  .navbar-expand-xl .offcanvas-header {\n    display: none;\n  }\n  .navbar-expand-xl .offcanvas {\n    position: inherit;\n    bottom: 0;\n    z-index: 1000;\n    flex-grow: 1;\n    visibility: visible !important;\n    background-color: transparent;\n    border-right: 0;\n    border-left: 0;\n    transition: none;\n    transform: none;\n  }\n  .navbar-expand-xl .offcanvas-top,\n.navbar-expand-xl .offcanvas-bottom {\n    height: auto;\n    border-top: 0;\n    border-bottom: 0;\n  }\n  .navbar-expand-xl .offcanvas-body {\n    display: flex;\n    flex-grow: 0;\n    padding: 0;\n    overflow-y: visible;\n  }\n}\n@media (min-width: 1400px) {\n  .navbar-expand-xxl {\n    flex-wrap: nowrap;\n    justify-content: flex-start;\n  }\n  .navbar-expand-xxl .navbar-nav {\n    flex-direction: row;\n  }\n  .navbar-expand-xxl .navbar-nav .dropdown-menu {\n    position: absolute;\n  }\n  .navbar-expand-xxl .navbar-nav .nav-link {\n    padding-right: 0.5rem;\n    padding-left: 0.5rem;\n  }\n  .navbar-expand-xxl .navbar-nav-scroll {\n    overflow: visible;\n  }\n  .navbar-expand-xxl .navbar-collapse {\n    display: flex !important;\n    flex-basis: auto;\n  }\n  .navbar-expand-xxl .navbar-toggler {\n    display: none;\n  }\n  .navbar-expand-xxl .offcanvas-header {\n    display: none;\n  }\n  .navbar-expand-xxl .offcanvas {\n    position: inherit;\n    bottom: 0;\n    z-index: 1000;\n    flex-grow: 1;\n    visibility: visible !important;\n    background-color: transparent;\n    border-right: 0;\n    border-left: 0;\n    transition: none;\n    transform: none;\n  }\n  .navbar-expand-xxl .offcanvas-top,\n.navbar-expand-xxl .offcanvas-bottom {\n    height: auto;\n    border-top: 0;\n    border-bottom: 0;\n  }\n  .navbar-expand-xxl .offcanvas-body {\n    display: flex;\n    flex-grow: 0;\n    padding: 0;\n    overflow-y: visible;\n  }\n}\n.navbar-expand {\n  flex-wrap: nowrap;\n  justify-content: flex-start;\n}\n.navbar-expand .navbar-nav {\n  flex-direction: row;\n}\n.navbar-expand .navbar-nav .dropdown-menu {\n  position: absolute;\n}\n.navbar-expand .navbar-nav .nav-link {\n  padding-right: 0.5rem;\n  padding-left: 0.5rem;\n}\n.navbar-expand .navbar-nav-scroll {\n  overflow: visible;\n}\n.navbar-expand .navbar-collapse {\n  display: flex !important;\n  flex-basis: auto;\n}\n.navbar-expand .navbar-toggler {\n  display: none;\n}\n.navbar-expand .offcanvas-header {\n  display: none;\n}\n.navbar-expand .offcanvas {\n  position: inherit;\n  bottom: 0;\n  z-index: 1000;\n  flex-grow: 1;\n  visibility: visible !important;\n  background-color: transparent;\n  border-right: 0;\n  border-left: 0;\n  transition: none;\n  transform: none;\n}\n.navbar-expand .offcanvas-top,\n.navbar-expand .offcanvas-bottom {\n  height: auto;\n  border-top: 0;\n  border-bottom: 0;\n}\n.navbar-expand .offcanvas-body {\n  display: flex;\n  flex-grow: 0;\n  padding: 0;\n  overflow-y: visible;\n}\n\n.navbar-light .navbar-brand {\n  color: rgba(0, 0, 0, 0.9);\n}\n.navbar-light .navbar-brand:hover, .navbar-light .navbar-brand:focus {\n  color: rgba(0, 0, 0, 0.9);\n}\n.navbar-light .navbar-nav .nav-link {\n  color: rgba(0, 0, 0, 0.55);\n}\n.navbar-light .navbar-nav .nav-link:hover, .navbar-light .navbar-nav .nav-link:focus {\n  color: rgba(0, 0, 0, 0.7);\n}\n.navbar-light .navbar-nav .nav-link.disabled {\n  color: rgba(0, 0, 0, 0.3);\n}\n.navbar-light .navbar-nav .show > .nav-link,\n.navbar-light .navbar-nav .nav-link.active {\n  color: rgba(0, 0, 0, 0.9);\n}\n.navbar-light .navbar-toggler {\n  color: rgba(0, 0, 0, 0.55);\n  border-color: rgba(0, 0, 0, 0.1);\n}\n.navbar-light .navbar-toggler-icon {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 30 30'%3e%3cpath stroke='rgba%280, 0, 0, 0.55%29' stroke-linecap='round' stroke-miterlimit='10' stroke-width='2' d='M4 7h22M4 15h22M4 23h22'/%3e%3c/svg%3e\");\n}\n.navbar-light .navbar-text {\n  color: rgba(0, 0, 0, 0.55);\n}\n.navbar-light .navbar-text a,\n.navbar-light .navbar-text a:hover,\n.navbar-light .navbar-text a:focus {\n  color: rgba(0, 0, 0, 0.9);\n}\n\n.navbar-dark .navbar-brand {\n  color: #fff;\n}\n.navbar-dark .navbar-brand:hover, .navbar-dark .navbar-brand:focus {\n  color: #fff;\n}\n.navbar-dark .navbar-nav .nav-link {\n  color: rgba(255, 255, 255, 0.55);\n}\n.navbar-dark .navbar-nav .nav-link:hover, .navbar-dark .navbar-nav .nav-link:focus {\n  color: rgba(255, 255, 255, 0.75);\n}\n.navbar-dark .navbar-nav .nav-link.disabled {\n  color: rgba(255, 255, 255, 0.25);\n}\n.navbar-dark .navbar-nav .show > .nav-link,\n.navbar-dark .navbar-nav .nav-link.active {\n  color: #fff;\n}\n.navbar-dark .navbar-toggler {\n  color: rgba(255, 255, 255, 0.55);\n  border-color: rgba(255, 255, 255, 0.1);\n}\n.navbar-dark .navbar-toggler-icon {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 30 30'%3e%3cpath stroke='rgba%28255, 255, 255, 0.55%29' stroke-linecap='round' stroke-miterlimit='10' stroke-width='2' d='M4 7h22M4 15h22M4 23h22'/%3e%3c/svg%3e\");\n}\n.navbar-dark .navbar-text {\n  color: rgba(255, 255, 255, 0.55);\n}\n.navbar-dark .navbar-text a,\n.navbar-dark .navbar-text a:hover,\n.navbar-dark .navbar-text a:focus {\n  color: #fff;\n}\n\n.card {\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  min-width: 0;\n  word-wrap: break-word;\n  background-color: #fff;\n  background-clip: border-box;\n  border: 1px solid rgba(0, 0, 0, 0.125);\n  border-radius: 0.25rem;\n}\n.card > hr {\n  margin-right: 0;\n  margin-left: 0;\n}\n.card > .list-group {\n  border-top: inherit;\n  border-bottom: inherit;\n}\n.card > .list-group:first-child {\n  border-top-width: 0;\n  border-top-left-radius: calc(0.25rem - 1px);\n  border-top-right-radius: calc(0.25rem - 1px);\n}\n.card > .list-group:last-child {\n  border-bottom-width: 0;\n  border-bottom-right-radius: calc(0.25rem - 1px);\n  border-bottom-left-radius: calc(0.25rem - 1px);\n}\n.card > .card-header + .list-group,\n.card > .list-group + .card-footer {\n  border-top: 0;\n}\n\n.card-body {\n  flex: 1 1 auto;\n  padding: 1rem 1rem;\n}\n\n.card-title {\n  margin-bottom: 0.5rem;\n}\n\n.card-subtitle {\n  margin-top: -0.25rem;\n  margin-bottom: 0;\n}\n\n.card-text:last-child {\n  margin-bottom: 0;\n}\n\n.card-link + .card-link {\n  margin-left: 1rem;\n}\n\n.card-header {\n  padding: 0.5rem 1rem;\n  margin-bottom: 0;\n  background-color: rgba(0, 0, 0, 0.03);\n  border-bottom: 1px solid rgba(0, 0, 0, 0.125);\n}\n.card-header:first-child {\n  border-radius: calc(0.25rem - 1px) calc(0.25rem - 1px) 0 0;\n}\n\n.card-footer {\n  padding: 0.5rem 1rem;\n  background-color: rgba(0, 0, 0, 0.03);\n  border-top: 1px solid rgba(0, 0, 0, 0.125);\n}\n.card-footer:last-child {\n  border-radius: 0 0 calc(0.25rem - 1px) calc(0.25rem - 1px);\n}\n\n.card-header-tabs {\n  margin-right: -0.5rem;\n  margin-bottom: -0.5rem;\n  margin-left: -0.5rem;\n  border-bottom: 0;\n}\n\n.card-header-pills {\n  margin-right: -0.5rem;\n  margin-left: -0.5rem;\n}\n\n.card-img-overlay {\n  position: absolute;\n  top: 0;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  padding: 1rem;\n  border-radius: calc(0.25rem - 1px);\n}\n\n.card-img,\n.card-img-top,\n.card-img-bottom {\n  width: 100%;\n}\n\n.card-img,\n.card-img-top {\n  border-top-left-radius: calc(0.25rem - 1px);\n  border-top-right-radius: calc(0.25rem - 1px);\n}\n\n.card-img,\n.card-img-bottom {\n  border-bottom-right-radius: calc(0.25rem - 1px);\n  border-bottom-left-radius: calc(0.25rem - 1px);\n}\n\n.card-group > .card {\n  margin-bottom: 0.75rem;\n}\n@media (min-width: 576px) {\n  .card-group {\n    display: flex;\n    flex-flow: row wrap;\n  }\n  .card-group > .card {\n    flex: 1 0 0%;\n    margin-bottom: 0;\n  }\n  .card-group > .card + .card {\n    margin-left: 0;\n    border-left: 0;\n  }\n  .card-group > .card:not(:last-child) {\n    border-top-right-radius: 0;\n    border-bottom-right-radius: 0;\n  }\n  .card-group > .card:not(:last-child) .card-img-top,\n.card-group > .card:not(:last-child) .card-header {\n    border-top-right-radius: 0;\n  }\n  .card-group > .card:not(:last-child) .card-img-bottom,\n.card-group > .card:not(:last-child) .card-footer {\n    border-bottom-right-radius: 0;\n  }\n  .card-group > .card:not(:first-child) {\n    border-top-left-radius: 0;\n    border-bottom-left-radius: 0;\n  }\n  .card-group > .card:not(:first-child) .card-img-top,\n.card-group > .card:not(:first-child) .card-header {\n    border-top-left-radius: 0;\n  }\n  .card-group > .card:not(:first-child) .card-img-bottom,\n.card-group > .card:not(:first-child) .card-footer {\n    border-bottom-left-radius: 0;\n  }\n}\n\n.accordion-button {\n  position: relative;\n  display: flex;\n  align-items: center;\n  width: 100%;\n  padding: 1rem 1.25rem;\n  font-size: 1rem;\n  color: #212529;\n  text-align: left;\n  background-color: #fff;\n  border: 0;\n  border-radius: 0;\n  overflow-anchor: none;\n  transition: color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out, border-radius 0.15s ease;\n}\n@media (prefers-reduced-motion: reduce) {\n  .accordion-button {\n    transition: none;\n  }\n}\n.accordion-button:not(.collapsed) {\n  color: #0c63e4;\n  background-color: #e7f1ff;\n  box-shadow: inset 0 -1px 0 rgba(0, 0, 0, 0.125);\n}\n.accordion-button:not(.collapsed)::after {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='%230c63e4'%3e%3cpath fill-rule='evenodd' d='M1.646 4.646a.5.5 0 0 1 .708 0L8 10.293l5.646-5.647a.5.5 0 0 1 .708.708l-6 6a.5.5 0 0 1-.708 0l-6-6a.5.5 0 0 1 0-.708z'/%3e%3c/svg%3e\");\n  transform: rotate(-180deg);\n}\n.accordion-button::after {\n  flex-shrink: 0;\n  width: 1.25rem;\n  height: 1.25rem;\n  margin-left: auto;\n  content: \"\";\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='%23212529'%3e%3cpath fill-rule='evenodd' d='M1.646 4.646a.5.5 0 0 1 .708 0L8 10.293l5.646-5.647a.5.5 0 0 1 .708.708l-6 6a.5.5 0 0 1-.708 0l-6-6a.5.5 0 0 1 0-.708z'/%3e%3c/svg%3e\");\n  background-repeat: no-repeat;\n  background-size: 1.25rem;\n  transition: transform 0.2s ease-in-out;\n}\n@media (prefers-reduced-motion: reduce) {\n  .accordion-button::after {\n    transition: none;\n  }\n}\n.accordion-button:hover {\n  z-index: 2;\n}\n.accordion-button:focus {\n  z-index: 3;\n  border-color: #86b7fe;\n  outline: 0;\n  box-shadow: 0 0 0 0.25rem rgba(13, 110, 253, 0.25);\n}\n\n.accordion-header {\n  margin-bottom: 0;\n}\n\n.accordion-item {\n  background-color: #fff;\n  border: 1px solid rgba(0, 0, 0, 0.125);\n}\n.accordion-item:first-of-type {\n  border-top-left-radius: 0.25rem;\n  border-top-right-radius: 0.25rem;\n}\n.accordion-item:first-of-type .accordion-button {\n  border-top-left-radius: calc(0.25rem - 1px);\n  border-top-right-radius: calc(0.25rem - 1px);\n}\n.accordion-item:not(:first-of-type) {\n  border-top: 0;\n}\n.accordion-item:last-of-type {\n  border-bottom-right-radius: 0.25rem;\n  border-bottom-left-radius: 0.25rem;\n}\n.accordion-item:last-of-type .accordion-button.collapsed {\n  border-bottom-right-radius: calc(0.25rem - 1px);\n  border-bottom-left-radius: calc(0.25rem - 1px);\n}\n.accordion-item:last-of-type .accordion-collapse {\n  border-bottom-right-radius: 0.25rem;\n  border-bottom-left-radius: 0.25rem;\n}\n\n.accordion-body {\n  padding: 1rem 1.25rem;\n}\n\n.accordion-flush .accordion-collapse {\n  border-width: 0;\n}\n.accordion-flush .accordion-item {\n  border-right: 0;\n  border-left: 0;\n  border-radius: 0;\n}\n.accordion-flush .accordion-item:first-child {\n  border-top: 0;\n}\n.accordion-flush .accordion-item:last-child {\n  border-bottom: 0;\n}\n.accordion-flush .accordion-item .accordion-button {\n  border-radius: 0;\n}\n\n.breadcrumb {\n  display: flex;\n  flex-wrap: wrap;\n  padding: 0 0;\n  margin-bottom: 1rem;\n  list-style: none;\n}\n\n.breadcrumb-item + .breadcrumb-item {\n  padding-left: 0.5rem;\n}\n.breadcrumb-item + .breadcrumb-item::before {\n  float: left;\n  padding-right: 0.5rem;\n  color: #6c757d;\n  content: var(--bs-breadcrumb-divider, \"/\") /* rtl: var(--bs-breadcrumb-divider, \"/\") */;\n}\n.breadcrumb-item.active {\n  color: #6c757d;\n}\n\n.pagination {\n  display: flex;\n  padding-left: 0;\n  list-style: none;\n}\n\n.page-link {\n  position: relative;\n  display: block;\n  color: #0d6efd;\n  text-decoration: none;\n  background-color: #fff;\n  border: 1px solid #dee2e6;\n  transition: color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n}\n@media (prefers-reduced-motion: reduce) {\n  .page-link {\n    transition: none;\n  }\n}\n.page-link:hover {\n  z-index: 2;\n  color: #0a58ca;\n  background-color: #e9ecef;\n  border-color: #dee2e6;\n}\n.page-link:focus {\n  z-index: 3;\n  color: #0a58ca;\n  background-color: #e9ecef;\n  outline: 0;\n  box-shadow: 0 0 0 0.25rem rgba(13, 110, 253, 0.25);\n}\n\n.page-item:not(:first-child) .page-link {\n  margin-left: -1px;\n}\n.page-item.active .page-link {\n  z-index: 3;\n  color: #fff;\n  background-color: #0d6efd;\n  border-color: #0d6efd;\n}\n.page-item.disabled .page-link {\n  color: #6c757d;\n  pointer-events: none;\n  background-color: #fff;\n  border-color: #dee2e6;\n}\n\n.page-link {\n  padding: 0.375rem 0.75rem;\n}\n\n.page-item:first-child .page-link {\n  border-top-left-radius: 0.25rem;\n  border-bottom-left-radius: 0.25rem;\n}\n.page-item:last-child .page-link {\n  border-top-right-radius: 0.25rem;\n  border-bottom-right-radius: 0.25rem;\n}\n\n.pagination-lg .page-link {\n  padding: 0.75rem 1.5rem;\n  font-size: 1.25rem;\n}\n.pagination-lg .page-item:first-child .page-link {\n  border-top-left-radius: 0.3rem;\n  border-bottom-left-radius: 0.3rem;\n}\n.pagination-lg .page-item:last-child .page-link {\n  border-top-right-radius: 0.3rem;\n  border-bottom-right-radius: 0.3rem;\n}\n\n.pagination-sm .page-link {\n  padding: 0.25rem 0.5rem;\n  font-size: 0.875rem;\n}\n.pagination-sm .page-item:first-child .page-link {\n  border-top-left-radius: 0.2rem;\n  border-bottom-left-radius: 0.2rem;\n}\n.pagination-sm .page-item:last-child .page-link {\n  border-top-right-radius: 0.2rem;\n  border-bottom-right-radius: 0.2rem;\n}\n\n.badge {\n  display: inline-block;\n  padding: 0.35em 0.65em;\n  font-size: 0.75em;\n  font-weight: 700;\n  line-height: 1;\n  color: #fff;\n  text-align: center;\n  white-space: nowrap;\n  vertical-align: baseline;\n  border-radius: 0.25rem;\n}\n.badge:empty {\n  display: none;\n}\n\n.btn .badge {\n  position: relative;\n  top: -1px;\n}\n\n.alert {\n  position: relative;\n  padding: 1rem 1rem;\n  margin-bottom: 1rem;\n  border: 1px solid transparent;\n  border-radius: 0.25rem;\n}\n\n.alert-heading {\n  color: inherit;\n}\n\n.alert-link {\n  font-weight: 700;\n}\n\n.alert-dismissible {\n  padding-right: 3rem;\n}\n.alert-dismissible .btn-close {\n  position: absolute;\n  top: 0;\n  right: 0;\n  z-index: 2;\n  padding: 1.25rem 1rem;\n}\n\n.alert-primary {\n  color: #084298;\n  background-color: #cfe2ff;\n  border-color: #b6d4fe;\n}\n.alert-primary .alert-link {\n  color: #06357a;\n}\n\n.alert-secondary {\n  color: #41464b;\n  background-color: #e2e3e5;\n  border-color: #d3d6d8;\n}\n.alert-secondary .alert-link {\n  color: #34383c;\n}\n\n.alert-success {\n  color: #0f5132;\n  background-color: #d1e7dd;\n  border-color: #badbcc;\n}\n.alert-success .alert-link {\n  color: #0c4128;\n}\n\n.alert-info {\n  color: #055160;\n  background-color: #cff4fc;\n  border-color: #b6effb;\n}\n.alert-info .alert-link {\n  color: #04414d;\n}\n\n.alert-warning {\n  color: #664d03;\n  background-color: #fff3cd;\n  border-color: #ffecb5;\n}\n.alert-warning .alert-link {\n  color: #523e02;\n}\n\n.alert-danger {\n  color: #842029;\n  background-color: #f8d7da;\n  border-color: #f5c2c7;\n}\n.alert-danger .alert-link {\n  color: #6a1a21;\n}\n\n.alert-light {\n  color: #636464;\n  background-color: #fefefe;\n  border-color: #fdfdfe;\n}\n.alert-light .alert-link {\n  color: #4f5050;\n}\n\n.alert-dark {\n  color: #141619;\n  background-color: #d3d3d4;\n  border-color: #bcbebf;\n}\n.alert-dark .alert-link {\n  color: #101214;\n}\n\n@-webkit-keyframes progress-bar-stripes {\n  0% {\n    background-position-x: 1rem;\n  }\n}\n\n@keyframes progress-bar-stripes {\n  0% {\n    background-position-x: 1rem;\n  }\n}\n.progress {\n  display: flex;\n  height: 1rem;\n  overflow: hidden;\n  font-size: 0.75rem;\n  background-color: #e9ecef;\n  border-radius: 0.25rem;\n}\n\n.progress-bar {\n  display: flex;\n  flex-direction: column;\n  justify-content: center;\n  overflow: hidden;\n  color: #fff;\n  text-align: center;\n  white-space: nowrap;\n  background-color: #0d6efd;\n  transition: width 0.6s ease;\n}\n@media (prefers-reduced-motion: reduce) {\n  .progress-bar {\n    transition: none;\n  }\n}\n\n.progress-bar-striped {\n  background-image: linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent);\n  background-size: 1rem 1rem;\n}\n\n.progress-bar-animated {\n  -webkit-animation: 1s linear infinite progress-bar-stripes;\n  animation: 1s linear infinite progress-bar-stripes;\n}\n@media (prefers-reduced-motion: reduce) {\n  .progress-bar-animated {\n    -webkit-animation: none;\n    animation: none;\n  }\n}\n\n.list-group {\n  display: flex;\n  flex-direction: column;\n  padding-left: 0;\n  margin-bottom: 0;\n  border-radius: 0.25rem;\n}\n\n.list-group-numbered {\n  list-style-type: none;\n  counter-reset: section;\n}\n.list-group-numbered > li::before {\n  content: counters(section, \".\") \". \";\n  counter-increment: section;\n}\n\n.list-group-item-action {\n  width: 100%;\n  color: #495057;\n  text-align: inherit;\n}\n.list-group-item-action:hover, .list-group-item-action:focus {\n  z-index: 1;\n  color: #495057;\n  text-decoration: none;\n  background-color: #f8f9fa;\n}\n.list-group-item-action:active {\n  color: #212529;\n  background-color: #e9ecef;\n}\n\n.list-group-item {\n  position: relative;\n  display: block;\n  padding: 0.5rem 1rem;\n  color: #212529;\n  text-decoration: none;\n  background-color: #fff;\n  border: 1px solid rgba(0, 0, 0, 0.125);\n}\n.list-group-item:first-child {\n  border-top-left-radius: inherit;\n  border-top-right-radius: inherit;\n}\n.list-group-item:last-child {\n  border-bottom-right-radius: inherit;\n  border-bottom-left-radius: inherit;\n}\n.list-group-item.disabled, .list-group-item:disabled {\n  color: #6c757d;\n  pointer-events: none;\n  background-color: #fff;\n}\n.list-group-item.active {\n  z-index: 2;\n  color: #fff;\n  background-color: #0d6efd;\n  border-color: #0d6efd;\n}\n.list-group-item + .list-group-item {\n  border-top-width: 0;\n}\n.list-group-item + .list-group-item.active {\n  margin-top: -1px;\n  border-top-width: 1px;\n}\n\n.list-group-horizontal {\n  flex-direction: row;\n}\n.list-group-horizontal > .list-group-item:first-child {\n  border-bottom-left-radius: 0.25rem;\n  border-top-right-radius: 0;\n}\n.list-group-horizontal > .list-group-item:last-child {\n  border-top-right-radius: 0.25rem;\n  border-bottom-left-radius: 0;\n}\n.list-group-horizontal > .list-group-item.active {\n  margin-top: 0;\n}\n.list-group-horizontal > .list-group-item + .list-group-item {\n  border-top-width: 1px;\n  border-left-width: 0;\n}\n.list-group-horizontal > .list-group-item + .list-group-item.active {\n  margin-left: -1px;\n  border-left-width: 1px;\n}\n\n@media (min-width: 576px) {\n  .list-group-horizontal-sm {\n    flex-direction: row;\n  }\n  .list-group-horizontal-sm > .list-group-item:first-child {\n    border-bottom-left-radius: 0.25rem;\n    border-top-right-radius: 0;\n  }\n  .list-group-horizontal-sm > .list-group-item:last-child {\n    border-top-right-radius: 0.25rem;\n    border-bottom-left-radius: 0;\n  }\n  .list-group-horizontal-sm > .list-group-item.active {\n    margin-top: 0;\n  }\n  .list-group-horizontal-sm > .list-group-item + .list-group-item {\n    border-top-width: 1px;\n    border-left-width: 0;\n  }\n  .list-group-horizontal-sm > .list-group-item + .list-group-item.active {\n    margin-left: -1px;\n    border-left-width: 1px;\n  }\n}\n@media (min-width: 768px) {\n  .list-group-horizontal-md {\n    flex-direction: row;\n  }\n  .list-group-horizontal-md > .list-group-item:first-child {\n    border-bottom-left-radius: 0.25rem;\n    border-top-right-radius: 0;\n  }\n  .list-group-horizontal-md > .list-group-item:last-child {\n    border-top-right-radius: 0.25rem;\n    border-bottom-left-radius: 0;\n  }\n  .list-group-horizontal-md > .list-group-item.active {\n    margin-top: 0;\n  }\n  .list-group-horizontal-md > .list-group-item + .list-group-item {\n    border-top-width: 1px;\n    border-left-width: 0;\n  }\n  .list-group-horizontal-md > .list-group-item + .list-group-item.active {\n    margin-left: -1px;\n    border-left-width: 1px;\n  }\n}\n@media (min-width: 992px) {\n  .list-group-horizontal-lg {\n    flex-direction: row;\n  }\n  .list-group-horizontal-lg > .list-group-item:first-child {\n    border-bottom-left-radius: 0.25rem;\n    border-top-right-radius: 0;\n  }\n  .list-group-horizontal-lg > .list-group-item:last-child {\n    border-top-right-radius: 0.25rem;\n    border-bottom-left-radius: 0;\n  }\n  .list-group-horizontal-lg > .list-group-item.active {\n    margin-top: 0;\n  }\n  .list-group-horizontal-lg > .list-group-item + .list-group-item {\n    border-top-width: 1px;\n    border-left-width: 0;\n  }\n  .list-group-horizontal-lg > .list-group-item + .list-group-item.active {\n    margin-left: -1px;\n    border-left-width: 1px;\n  }\n}\n@media (min-width: 1200px) {\n  .list-group-horizontal-xl {\n    flex-direction: row;\n  }\n  .list-group-horizontal-xl > .list-group-item:first-child {\n    border-bottom-left-radius: 0.25rem;\n    border-top-right-radius: 0;\n  }\n  .list-group-horizontal-xl > .list-group-item:last-child {\n    border-top-right-radius: 0.25rem;\n    border-bottom-left-radius: 0;\n  }\n  .list-group-horizontal-xl > .list-group-item.active {\n    margin-top: 0;\n  }\n  .list-group-horizontal-xl > .list-group-item + .list-group-item {\n    border-top-width: 1px;\n    border-left-width: 0;\n  }\n  .list-group-horizontal-xl > .list-group-item + .list-group-item.active {\n    margin-left: -1px;\n    border-left-width: 1px;\n  }\n}\n@media (min-width: 1400px) {\n  .list-group-horizontal-xxl {\n    flex-direction: row;\n  }\n  .list-group-horizontal-xxl > .list-group-item:first-child {\n    border-bottom-left-radius: 0.25rem;\n    border-top-right-radius: 0;\n  }\n  .list-group-horizontal-xxl > .list-group-item:last-child {\n    border-top-right-radius: 0.25rem;\n    border-bottom-left-radius: 0;\n  }\n  .list-group-horizontal-xxl > .list-group-item.active {\n    margin-top: 0;\n  }\n  .list-group-horizontal-xxl > .list-group-item + .list-group-item {\n    border-top-width: 1px;\n    border-left-width: 0;\n  }\n  .list-group-horizontal-xxl > .list-group-item + .list-group-item.active {\n    margin-left: -1px;\n    border-left-width: 1px;\n  }\n}\n.list-group-flush {\n  border-radius: 0;\n}\n.list-group-flush > .list-group-item {\n  border-width: 0 0 1px;\n}\n.list-group-flush > .list-group-item:last-child {\n  border-bottom-width: 0;\n}\n\n.list-group-item-primary {\n  color: #084298;\n  background-color: #cfe2ff;\n}\n.list-group-item-primary.list-group-item-action:hover, .list-group-item-primary.list-group-item-action:focus {\n  color: #084298;\n  background-color: #bacbe6;\n}\n.list-group-item-primary.list-group-item-action.active {\n  color: #fff;\n  background-color: #084298;\n  border-color: #084298;\n}\n\n.list-group-item-secondary {\n  color: #41464b;\n  background-color: #e2e3e5;\n}\n.list-group-item-secondary.list-group-item-action:hover, .list-group-item-secondary.list-group-item-action:focus {\n  color: #41464b;\n  background-color: #cbccce;\n}\n.list-group-item-secondary.list-group-item-action.active {\n  color: #fff;\n  background-color: #41464b;\n  border-color: #41464b;\n}\n\n.list-group-item-success {\n  color: #0f5132;\n  background-color: #d1e7dd;\n}\n.list-group-item-success.list-group-item-action:hover, .list-group-item-success.list-group-item-action:focus {\n  color: #0f5132;\n  background-color: #bcd0c7;\n}\n.list-group-item-success.list-group-item-action.active {\n  color: #fff;\n  background-color: #0f5132;\n  border-color: #0f5132;\n}\n\n.list-group-item-info {\n  color: #055160;\n  background-color: #cff4fc;\n}\n.list-group-item-info.list-group-item-action:hover, .list-group-item-info.list-group-item-action:focus {\n  color: #055160;\n  background-color: #badce3;\n}\n.list-group-item-info.list-group-item-action.active {\n  color: #fff;\n  background-color: #055160;\n  border-color: #055160;\n}\n\n.list-group-item-warning {\n  color: #664d03;\n  background-color: #fff3cd;\n}\n.list-group-item-warning.list-group-item-action:hover, .list-group-item-warning.list-group-item-action:focus {\n  color: #664d03;\n  background-color: #e6dbb9;\n}\n.list-group-item-warning.list-group-item-action.active {\n  color: #fff;\n  background-color: #664d03;\n  border-color: #664d03;\n}\n\n.list-group-item-danger {\n  color: #842029;\n  background-color: #f8d7da;\n}\n.list-group-item-danger.list-group-item-action:hover, .list-group-item-danger.list-group-item-action:focus {\n  color: #842029;\n  background-color: #dfc2c4;\n}\n.list-group-item-danger.list-group-item-action.active {\n  color: #fff;\n  background-color: #842029;\n  border-color: #842029;\n}\n\n.list-group-item-light {\n  color: #636464;\n  background-color: #fefefe;\n}\n.list-group-item-light.list-group-item-action:hover, .list-group-item-light.list-group-item-action:focus {\n  color: #636464;\n  background-color: #e5e5e5;\n}\n.list-group-item-light.list-group-item-action.active {\n  color: #fff;\n  background-color: #636464;\n  border-color: #636464;\n}\n\n.list-group-item-dark {\n  color: #141619;\n  background-color: #d3d3d4;\n}\n.list-group-item-dark.list-group-item-action:hover, .list-group-item-dark.list-group-item-action:focus {\n  color: #141619;\n  background-color: #bebebf;\n}\n.list-group-item-dark.list-group-item-action.active {\n  color: #fff;\n  background-color: #141619;\n  border-color: #141619;\n}\n\n.btn-close {\n  box-sizing: content-box;\n  width: 1em;\n  height: 1em;\n  padding: 0.25em 0.25em;\n  color: #000;\n  background: transparent url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='%23000'%3e%3cpath d='M.293.293a1 1 0 011.414 0L8 6.586 14.293.293a1 1 0 111.414 1.414L9.414 8l6.293 6.293a1 1 0 01-1.414 1.414L8 9.414l-6.293 6.293a1 1 0 01-1.414-1.414L6.586 8 .293 1.707a1 1 0 010-1.414z'/%3e%3c/svg%3e\") center/1em auto no-repeat;\n  border: 0;\n  border-radius: 0.25rem;\n  opacity: 0.5;\n}\n.btn-close:hover {\n  color: #000;\n  text-decoration: none;\n  opacity: 0.75;\n}\n.btn-close:focus {\n  outline: 0;\n  box-shadow: 0 0 0 0.25rem rgba(13, 110, 253, 0.25);\n  opacity: 1;\n}\n.btn-close:disabled, .btn-close.disabled {\n  pointer-events: none;\n  -webkit-user-select: none;\n  -moz-user-select: none;\n  user-select: none;\n  opacity: 0.25;\n}\n\n.btn-close-white {\n  filter: invert(1) grayscale(100%) brightness(200%);\n}\n\n.toast {\n  width: 350px;\n  max-width: 100%;\n  font-size: 0.875rem;\n  pointer-events: auto;\n  background-color: rgba(255, 255, 255, 0.85);\n  background-clip: padding-box;\n  border: 1px solid rgba(0, 0, 0, 0.1);\n  box-shadow: 0 0.5rem 1rem rgba(0, 0, 0, 0.15);\n  border-radius: 0.25rem;\n}\n.toast.showing {\n  opacity: 0;\n}\n.toast:not(.show) {\n  display: none;\n}\n\n.toast-container {\n  width: -webkit-max-content;\n  width: -moz-max-content;\n  width: max-content;\n  max-width: 100%;\n  pointer-events: none;\n}\n.toast-container > :not(:last-child) {\n  margin-bottom: 0.75rem;\n}\n\n.toast-header {\n  display: flex;\n  align-items: center;\n  padding: 0.5rem 0.75rem;\n  color: #6c757d;\n  background-color: rgba(255, 255, 255, 0.85);\n  background-clip: padding-box;\n  border-bottom: 1px solid rgba(0, 0, 0, 0.05);\n  border-top-left-radius: calc(0.25rem - 1px);\n  border-top-right-radius: calc(0.25rem - 1px);\n}\n.toast-header .btn-close {\n  margin-right: -0.375rem;\n  margin-left: 0.75rem;\n}\n\n.toast-body {\n  padding: 0.75rem;\n  word-wrap: break-word;\n}\n\n.modal {\n  position: fixed;\n  top: 0;\n  left: 0;\n  z-index: 1055;\n  display: none;\n  width: 100%;\n  height: 100%;\n  overflow-x: hidden;\n  overflow-y: auto;\n  outline: 0;\n}\n\n.modal-dialog {\n  position: relative;\n  width: auto;\n  margin: 0.5rem;\n  pointer-events: none;\n}\n.modal.fade .modal-dialog {\n  transition: transform 0.3s ease-out;\n  transform: translate(0, -50px);\n}\n@media (prefers-reduced-motion: reduce) {\n  .modal.fade .modal-dialog {\n    transition: none;\n  }\n}\n.modal.show .modal-dialog {\n  transform: none;\n}\n.modal.modal-static .modal-dialog {\n  transform: scale(1.02);\n}\n\n.modal-dialog-scrollable {\n  height: calc(100% - 1rem);\n}\n.modal-dialog-scrollable .modal-content {\n  max-height: 100%;\n  overflow: hidden;\n}\n.modal-dialog-scrollable .modal-body {\n  overflow-y: auto;\n}\n\n.modal-dialog-centered {\n  display: flex;\n  align-items: center;\n  min-height: calc(100% - 1rem);\n}\n\n.modal-content {\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  width: 100%;\n  pointer-events: auto;\n  background-color: #fff;\n  background-clip: padding-box;\n  border: 1px solid rgba(0, 0, 0, 0.2);\n  border-radius: 0.3rem;\n  outline: 0;\n}\n\n.modal-backdrop {\n  position: fixed;\n  top: 0;\n  left: 0;\n  z-index: 1050;\n  width: 100vw;\n  height: 100vh;\n  background-color: #000;\n}\n.modal-backdrop.fade {\n  opacity: 0;\n}\n.modal-backdrop.show {\n  opacity: 0.5;\n}\n\n.modal-header {\n  display: flex;\n  flex-shrink: 0;\n  align-items: center;\n  justify-content: space-between;\n  padding: 1rem 1rem;\n  border-bottom: 1px solid #dee2e6;\n  border-top-left-radius: calc(0.3rem - 1px);\n  border-top-right-radius: calc(0.3rem - 1px);\n}\n.modal-header .btn-close {\n  padding: 0.5rem 0.5rem;\n  margin: -0.5rem -0.5rem -0.5rem auto;\n}\n\n.modal-title {\n  margin-bottom: 0;\n  line-height: 1.5;\n}\n\n.modal-body {\n  position: relative;\n  flex: 1 1 auto;\n  padding: 1rem;\n}\n\n.modal-footer {\n  display: flex;\n  flex-wrap: wrap;\n  flex-shrink: 0;\n  align-items: center;\n  justify-content: flex-end;\n  padding: 0.75rem;\n  border-top: 1px solid #dee2e6;\n  border-bottom-right-radius: calc(0.3rem - 1px);\n  border-bottom-left-radius: calc(0.3rem - 1px);\n}\n.modal-footer > * {\n  margin: 0.25rem;\n}\n\n@media (min-width: 576px) {\n  .modal-dialog {\n    max-width: 500px;\n    margin: 1.75rem auto;\n  }\n\n  .modal-dialog-scrollable {\n    height: calc(100% - 3.5rem);\n  }\n\n  .modal-dialog-centered {\n    min-height: calc(100% - 3.5rem);\n  }\n\n  .modal-sm {\n    max-width: 300px;\n  }\n}\n@media (min-width: 992px) {\n  .modal-lg,\n.modal-xl {\n    max-width: 800px;\n  }\n}\n@media (min-width: 1200px) {\n  .modal-xl {\n    max-width: 1140px;\n  }\n}\n.modal-fullscreen {\n  width: 100vw;\n  max-width: none;\n  height: 100%;\n  margin: 0;\n}\n.modal-fullscreen .modal-content {\n  height: 100%;\n  border: 0;\n  border-radius: 0;\n}\n.modal-fullscreen .modal-header {\n  border-radius: 0;\n}\n.modal-fullscreen .modal-body {\n  overflow-y: auto;\n}\n.modal-fullscreen .modal-footer {\n  border-radius: 0;\n}\n\n@media (max-width: 575.98px) {\n  .modal-fullscreen-sm-down {\n    width: 100vw;\n    max-width: none;\n    height: 100%;\n    margin: 0;\n  }\n  .modal-fullscreen-sm-down .modal-content {\n    height: 100%;\n    border: 0;\n    border-radius: 0;\n  }\n  .modal-fullscreen-sm-down .modal-header {\n    border-radius: 0;\n  }\n  .modal-fullscreen-sm-down .modal-body {\n    overflow-y: auto;\n  }\n  .modal-fullscreen-sm-down .modal-footer {\n    border-radius: 0;\n  }\n}\n@media (max-width: 767.98px) {\n  .modal-fullscreen-md-down {\n    width: 100vw;\n    max-width: none;\n    height: 100%;\n    margin: 0;\n  }\n  .modal-fullscreen-md-down .modal-content {\n    height: 100%;\n    border: 0;\n    border-radius: 0;\n  }\n  .modal-fullscreen-md-down .modal-header {\n    border-radius: 0;\n  }\n  .modal-fullscreen-md-down .modal-body {\n    overflow-y: auto;\n  }\n  .modal-fullscreen-md-down .modal-footer {\n    border-radius: 0;\n  }\n}\n@media (max-width: 991.98px) {\n  .modal-fullscreen-lg-down {\n    width: 100vw;\n    max-width: none;\n    height: 100%;\n    margin: 0;\n  }\n  .modal-fullscreen-lg-down .modal-content {\n    height: 100%;\n    border: 0;\n    border-radius: 0;\n  }\n  .modal-fullscreen-lg-down .modal-header {\n    border-radius: 0;\n  }\n  .modal-fullscreen-lg-down .modal-body {\n    overflow-y: auto;\n  }\n  .modal-fullscreen-lg-down .modal-footer {\n    border-radius: 0;\n  }\n}\n@media (max-width: 1199.98px) {\n  .modal-fullscreen-xl-down {\n    width: 100vw;\n    max-width: none;\n    height: 100%;\n    margin: 0;\n  }\n  .modal-fullscreen-xl-down .modal-content {\n    height: 100%;\n    border: 0;\n    border-radius: 0;\n  }\n  .modal-fullscreen-xl-down .modal-header {\n    border-radius: 0;\n  }\n  .modal-fullscreen-xl-down .modal-body {\n    overflow-y: auto;\n  }\n  .modal-fullscreen-xl-down .modal-footer {\n    border-radius: 0;\n  }\n}\n@media (max-width: 1399.98px) {\n  .modal-fullscreen-xxl-down {\n    width: 100vw;\n    max-width: none;\n    height: 100%;\n    margin: 0;\n  }\n  .modal-fullscreen-xxl-down .modal-content {\n    height: 100%;\n    border: 0;\n    border-radius: 0;\n  }\n  .modal-fullscreen-xxl-down .modal-header {\n    border-radius: 0;\n  }\n  .modal-fullscreen-xxl-down .modal-body {\n    overflow-y: auto;\n  }\n  .modal-fullscreen-xxl-down .modal-footer {\n    border-radius: 0;\n  }\n}\n.tooltip {\n  position: absolute;\n  z-index: 1080;\n  display: block;\n  margin: 0;\n  font-family: var(--bs-font-sans-serif);\n  font-style: normal;\n  font-weight: 400;\n  line-height: 1.5;\n  text-align: left;\n  text-align: start;\n  text-decoration: none;\n  text-shadow: none;\n  text-transform: none;\n  letter-spacing: normal;\n  word-break: normal;\n  word-spacing: normal;\n  white-space: normal;\n  line-break: auto;\n  font-size: 0.875rem;\n  word-wrap: break-word;\n  opacity: 0;\n}\n.tooltip.show {\n  opacity: 0.9;\n}\n.tooltip .tooltip-arrow {\n  position: absolute;\n  display: block;\n  width: 0.8rem;\n  height: 0.4rem;\n}\n.tooltip .tooltip-arrow::before {\n  position: absolute;\n  content: \"\";\n  border-color: transparent;\n  border-style: solid;\n}\n\n.bs-tooltip-top, .bs-tooltip-auto[data-popper-placement^=top] {\n  padding: 0.4rem 0;\n}\n.bs-tooltip-top .tooltip-arrow, .bs-tooltip-auto[data-popper-placement^=top] .tooltip-arrow {\n  bottom: 0;\n}\n.bs-tooltip-top .tooltip-arrow::before, .bs-tooltip-auto[data-popper-placement^=top] .tooltip-arrow::before {\n  top: -1px;\n  border-width: 0.4rem 0.4rem 0;\n  border-top-color: #000;\n}\n\n.bs-tooltip-end, .bs-tooltip-auto[data-popper-placement^=right] {\n  padding: 0 0.4rem;\n}\n.bs-tooltip-end .tooltip-arrow, .bs-tooltip-auto[data-popper-placement^=right] .tooltip-arrow {\n  left: 0;\n  width: 0.4rem;\n  height: 0.8rem;\n}\n.bs-tooltip-end .tooltip-arrow::before, .bs-tooltip-auto[data-popper-placement^=right] .tooltip-arrow::before {\n  right: -1px;\n  border-width: 0.4rem 0.4rem 0.4rem 0;\n  border-right-color: #000;\n}\n\n.bs-tooltip-bottom, .bs-tooltip-auto[data-popper-placement^=bottom] {\n  padding: 0.4rem 0;\n}\n.bs-tooltip-bottom .tooltip-arrow, .bs-tooltip-auto[data-popper-placement^=bottom] .tooltip-arrow {\n  top: 0;\n}\n.bs-tooltip-bottom .tooltip-arrow::before, .bs-tooltip-auto[data-popper-placement^=bottom] .tooltip-arrow::before {\n  bottom: -1px;\n  border-width: 0 0.4rem 0.4rem;\n  border-bottom-color: #000;\n}\n\n.bs-tooltip-start, .bs-tooltip-auto[data-popper-placement^=left] {\n  padding: 0 0.4rem;\n}\n.bs-tooltip-start .tooltip-arrow, .bs-tooltip-auto[data-popper-placement^=left] .tooltip-arrow {\n  right: 0;\n  width: 0.4rem;\n  height: 0.8rem;\n}\n.bs-tooltip-start .tooltip-arrow::before, .bs-tooltip-auto[data-popper-placement^=left] .tooltip-arrow::before {\n  left: -1px;\n  border-width: 0.4rem 0 0.4rem 0.4rem;\n  border-left-color: #000;\n}\n\n.tooltip-inner {\n  max-width: 200px;\n  padding: 0.25rem 0.5rem;\n  color: #fff;\n  text-align: center;\n  background-color: #000;\n  border-radius: 0.25rem;\n}\n\n.popover {\n  position: absolute;\n  top: 0;\n  left: 0 /* rtl:ignore */;\n  z-index: 1070;\n  display: block;\n  max-width: 276px;\n  font-family: var(--bs-font-sans-serif);\n  font-style: normal;\n  font-weight: 400;\n  line-height: 1.5;\n  text-align: left;\n  text-align: start;\n  text-decoration: none;\n  text-shadow: none;\n  text-transform: none;\n  letter-spacing: normal;\n  word-break: normal;\n  word-spacing: normal;\n  white-space: normal;\n  line-break: auto;\n  font-size: 0.875rem;\n  word-wrap: break-word;\n  background-color: #fff;\n  background-clip: padding-box;\n  border: 1px solid rgba(0, 0, 0, 0.2);\n  border-radius: 0.3rem;\n}\n.popover .popover-arrow {\n  position: absolute;\n  display: block;\n  width: 1rem;\n  height: 0.5rem;\n}\n.popover .popover-arrow::before, .popover .popover-arrow::after {\n  position: absolute;\n  display: block;\n  content: \"\";\n  border-color: transparent;\n  border-style: solid;\n}\n\n.bs-popover-top > .popover-arrow, .bs-popover-auto[data-popper-placement^=top] > .popover-arrow {\n  bottom: calc(-0.5rem - 1px);\n}\n.bs-popover-top > .popover-arrow::before, .bs-popover-auto[data-popper-placement^=top] > .popover-arrow::before {\n  bottom: 0;\n  border-width: 0.5rem 0.5rem 0;\n  border-top-color: rgba(0, 0, 0, 0.25);\n}\n.bs-popover-top > .popover-arrow::after, .bs-popover-auto[data-popper-placement^=top] > .popover-arrow::after {\n  bottom: 1px;\n  border-width: 0.5rem 0.5rem 0;\n  border-top-color: #fff;\n}\n\n.bs-popover-end > .popover-arrow, .bs-popover-auto[data-popper-placement^=right] > .popover-arrow {\n  left: calc(-0.5rem - 1px);\n  width: 0.5rem;\n  height: 1rem;\n}\n.bs-popover-end > .popover-arrow::before, .bs-popover-auto[data-popper-placement^=right] > .popover-arrow::before {\n  left: 0;\n  border-width: 0.5rem 0.5rem 0.5rem 0;\n  border-right-color: rgba(0, 0, 0, 0.25);\n}\n.bs-popover-end > .popover-arrow::after, .bs-popover-auto[data-popper-placement^=right] > .popover-arrow::after {\n  left: 1px;\n  border-width: 0.5rem 0.5rem 0.5rem 0;\n  border-right-color: #fff;\n}\n\n.bs-popover-bottom > .popover-arrow, .bs-popover-auto[data-popper-placement^=bottom] > .popover-arrow {\n  top: calc(-0.5rem - 1px);\n}\n.bs-popover-bottom > .popover-arrow::before, .bs-popover-auto[data-popper-placement^=bottom] > .popover-arrow::before {\n  top: 0;\n  border-width: 0 0.5rem 0.5rem 0.5rem;\n  border-bottom-color: rgba(0, 0, 0, 0.25);\n}\n.bs-popover-bottom > .popover-arrow::after, .bs-popover-auto[data-popper-placement^=bottom] > .popover-arrow::after {\n  top: 1px;\n  border-width: 0 0.5rem 0.5rem 0.5rem;\n  border-bottom-color: #fff;\n}\n.bs-popover-bottom .popover-header::before, .bs-popover-auto[data-popper-placement^=bottom] .popover-header::before {\n  position: absolute;\n  top: 0;\n  left: 50%;\n  display: block;\n  width: 1rem;\n  margin-left: -0.5rem;\n  content: \"\";\n  border-bottom: 1px solid #f0f0f0;\n}\n\n.bs-popover-start > .popover-arrow, .bs-popover-auto[data-popper-placement^=left] > .popover-arrow {\n  right: calc(-0.5rem - 1px);\n  width: 0.5rem;\n  height: 1rem;\n}\n.bs-popover-start > .popover-arrow::before, .bs-popover-auto[data-popper-placement^=left] > .popover-arrow::before {\n  right: 0;\n  border-width: 0.5rem 0 0.5rem 0.5rem;\n  border-left-color: rgba(0, 0, 0, 0.25);\n}\n.bs-popover-start > .popover-arrow::after, .bs-popover-auto[data-popper-placement^=left] > .popover-arrow::after {\n  right: 1px;\n  border-width: 0.5rem 0 0.5rem 0.5rem;\n  border-left-color: #fff;\n}\n\n.popover-header {\n  padding: 0.5rem 1rem;\n  margin-bottom: 0;\n  font-size: 1rem;\n  background-color: #f0f0f0;\n  border-bottom: 1px solid rgba(0, 0, 0, 0.2);\n  border-top-left-radius: calc(0.3rem - 1px);\n  border-top-right-radius: calc(0.3rem - 1px);\n}\n.popover-header:empty {\n  display: none;\n}\n\n.popover-body {\n  padding: 1rem 1rem;\n  color: #212529;\n}\n\n.carousel {\n  position: relative;\n}\n\n.carousel.pointer-event {\n  touch-action: pan-y;\n}\n\n.carousel-inner {\n  position: relative;\n  width: 100%;\n  overflow: hidden;\n}\n.carousel-inner::after {\n  display: block;\n  clear: both;\n  content: \"\";\n}\n\n.carousel-item {\n  position: relative;\n  display: none;\n  float: left;\n  width: 100%;\n  margin-right: -100%;\n  -webkit-backface-visibility: hidden;\n  backface-visibility: hidden;\n  transition: transform 0.6s ease-in-out;\n}\n@media (prefers-reduced-motion: reduce) {\n  .carousel-item {\n    transition: none;\n  }\n}\n\n.carousel-item.active,\n.carousel-item-next,\n.carousel-item-prev {\n  display: block;\n}\n\n/* rtl:begin:ignore */\n.carousel-item-next:not(.carousel-item-start),\n.active.carousel-item-end {\n  transform: translateX(100%);\n}\n\n.carousel-item-prev:not(.carousel-item-end),\n.active.carousel-item-start {\n  transform: translateX(-100%);\n}\n\n/* rtl:end:ignore */\n.carousel-fade .carousel-item {\n  opacity: 0;\n  transition-property: opacity;\n  transform: none;\n}\n.carousel-fade .carousel-item.active,\n.carousel-fade .carousel-item-next.carousel-item-start,\n.carousel-fade .carousel-item-prev.carousel-item-end {\n  z-index: 1;\n  opacity: 1;\n}\n.carousel-fade .active.carousel-item-start,\n.carousel-fade .active.carousel-item-end {\n  z-index: 0;\n  opacity: 0;\n  transition: opacity 0s 0.6s;\n}\n@media (prefers-reduced-motion: reduce) {\n  .carousel-fade .active.carousel-item-start,\n.carousel-fade .active.carousel-item-end {\n    transition: none;\n  }\n}\n\n.carousel-control-prev,\n.carousel-control-next {\n  position: absolute;\n  top: 0;\n  bottom: 0;\n  z-index: 1;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  width: 15%;\n  padding: 0;\n  color: #fff;\n  text-align: center;\n  background: none;\n  border: 0;\n  opacity: 0.5;\n  transition: opacity 0.15s ease;\n}\n@media (prefers-reduced-motion: reduce) {\n  .carousel-control-prev,\n.carousel-control-next {\n    transition: none;\n  }\n}\n.carousel-control-prev:hover, .carousel-control-prev:focus,\n.carousel-control-next:hover,\n.carousel-control-next:focus {\n  color: #fff;\n  text-decoration: none;\n  outline: 0;\n  opacity: 0.9;\n}\n\n.carousel-control-prev {\n  left: 0;\n}\n\n.carousel-control-next {\n  right: 0;\n}\n\n.carousel-control-prev-icon,\n.carousel-control-next-icon {\n  display: inline-block;\n  width: 2rem;\n  height: 2rem;\n  background-repeat: no-repeat;\n  background-position: 50%;\n  background-size: 100% 100%;\n}\n\n/* rtl:options: {\n  \"autoRename\": true,\n  \"stringMap\":[ {\n    \"name\"    : \"prev-next\",\n    \"search\"  : \"prev\",\n    \"replace\" : \"next\"\n  } ]\n} */\n.carousel-control-prev-icon {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='%23fff'%3e%3cpath d='M11.354 1.646a.5.5 0 0 1 0 .708L5.707 8l5.647 5.646a.5.5 0 0 1-.708.708l-6-6a.5.5 0 0 1 0-.708l6-6a.5.5 0 0 1 .708 0z'/%3e%3c/svg%3e\");\n}\n\n.carousel-control-next-icon {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='%23fff'%3e%3cpath d='M4.646 1.646a.5.5 0 0 1 .708 0l6 6a.5.5 0 0 1 0 .708l-6 6a.5.5 0 0 1-.708-.708L10.293 8 4.646 2.354a.5.5 0 0 1 0-.708z'/%3e%3c/svg%3e\");\n}\n\n.carousel-indicators {\n  position: absolute;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  z-index: 2;\n  display: flex;\n  justify-content: center;\n  padding: 0;\n  margin-right: 15%;\n  margin-bottom: 1rem;\n  margin-left: 15%;\n  list-style: none;\n}\n.carousel-indicators [data-bs-target] {\n  box-sizing: content-box;\n  flex: 0 1 auto;\n  width: 30px;\n  height: 3px;\n  padding: 0;\n  margin-right: 3px;\n  margin-left: 3px;\n  text-indent: -999px;\n  cursor: pointer;\n  background-color: #fff;\n  background-clip: padding-box;\n  border: 0;\n  border-top: 10px solid transparent;\n  border-bottom: 10px solid transparent;\n  opacity: 0.5;\n  transition: opacity 0.6s ease;\n}\n@media (prefers-reduced-motion: reduce) {\n  .carousel-indicators [data-bs-target] {\n    transition: none;\n  }\n}\n.carousel-indicators .active {\n  opacity: 1;\n}\n\n.carousel-caption {\n  position: absolute;\n  right: 15%;\n  bottom: 1.25rem;\n  left: 15%;\n  padding-top: 1.25rem;\n  padding-bottom: 1.25rem;\n  color: #fff;\n  text-align: center;\n}\n\n.carousel-dark .carousel-control-prev-icon,\n.carousel-dark .carousel-control-next-icon {\n  filter: invert(1) grayscale(100);\n}\n.carousel-dark .carousel-indicators [data-bs-target] {\n  background-color: #000;\n}\n.carousel-dark .carousel-caption {\n  color: #000;\n}\n\n@-webkit-keyframes spinner-border {\n  to {\n    transform: rotate(360deg) /* rtl:ignore */;\n  }\n}\n\n@keyframes spinner-border {\n  to {\n    transform: rotate(360deg) /* rtl:ignore */;\n  }\n}\n.spinner-border {\n  display: inline-block;\n  width: 2rem;\n  height: 2rem;\n  vertical-align: -0.125em;\n  border: 0.25em solid currentColor;\n  border-right-color: transparent;\n  border-radius: 50%;\n  -webkit-animation: 0.75s linear infinite spinner-border;\n  animation: 0.75s linear infinite spinner-border;\n}\n\n.spinner-border-sm {\n  width: 1rem;\n  height: 1rem;\n  border-width: 0.2em;\n}\n\n@-webkit-keyframes spinner-grow {\n  0% {\n    transform: scale(0);\n  }\n  50% {\n    opacity: 1;\n    transform: none;\n  }\n}\n\n@keyframes spinner-grow {\n  0% {\n    transform: scale(0);\n  }\n  50% {\n    opacity: 1;\n    transform: none;\n  }\n}\n.spinner-grow {\n  display: inline-block;\n  width: 2rem;\n  height: 2rem;\n  vertical-align: -0.125em;\n  background-color: currentColor;\n  border-radius: 50%;\n  opacity: 0;\n  -webkit-animation: 0.75s linear infinite spinner-grow;\n  animation: 0.75s linear infinite spinner-grow;\n}\n\n.spinner-grow-sm {\n  width: 1rem;\n  height: 1rem;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .spinner-border,\n.spinner-grow {\n    -webkit-animation-duration: 1.5s;\n    animation-duration: 1.5s;\n  }\n}\n.offcanvas {\n  position: fixed;\n  bottom: 0;\n  z-index: 1045;\n  display: flex;\n  flex-direction: column;\n  max-width: 100%;\n  visibility: hidden;\n  background-color: #fff;\n  background-clip: padding-box;\n  outline: 0;\n  transition: transform 0.3s ease-in-out;\n}\n@media (prefers-reduced-motion: reduce) {\n  .offcanvas {\n    transition: none;\n  }\n}\n\n.offcanvas-backdrop {\n  position: fixed;\n  top: 0;\n  left: 0;\n  z-index: 1040;\n  width: 100vw;\n  height: 100vh;\n  background-color: #000;\n}\n.offcanvas-backdrop.fade {\n  opacity: 0;\n}\n.offcanvas-backdrop.show {\n  opacity: 0.5;\n}\n\n.offcanvas-header {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  padding: 1rem 1rem;\n}\n.offcanvas-header .btn-close {\n  padding: 0.5rem 0.5rem;\n  margin-top: -0.5rem;\n  margin-right: -0.5rem;\n  margin-bottom: -0.5rem;\n}\n\n.offcanvas-title {\n  margin-bottom: 0;\n  line-height: 1.5;\n}\n\n.offcanvas-body {\n  flex-grow: 1;\n  padding: 1rem 1rem;\n  overflow-y: auto;\n}\n\n.offcanvas-start {\n  top: 0;\n  left: 0;\n  width: 400px;\n  border-right: 1px solid rgba(0, 0, 0, 0.2);\n  transform: translateX(-100%);\n}\n\n.offcanvas-end {\n  top: 0;\n  right: 0;\n  width: 400px;\n  border-left: 1px solid rgba(0, 0, 0, 0.2);\n  transform: translateX(100%);\n}\n\n.offcanvas-top {\n  top: 0;\n  right: 0;\n  left: 0;\n  height: 30vh;\n  max-height: 100%;\n  border-bottom: 1px solid rgba(0, 0, 0, 0.2);\n  transform: translateY(-100%);\n}\n\n.offcanvas-bottom {\n  right: 0;\n  left: 0;\n  height: 30vh;\n  max-height: 100%;\n  border-top: 1px solid rgba(0, 0, 0, 0.2);\n  transform: translateY(100%);\n}\n\n.offcanvas.show {\n  transform: none;\n}\n\n.placeholder {\n  display: inline-block;\n  min-height: 1em;\n  vertical-align: middle;\n  cursor: wait;\n  background-color: currentColor;\n  opacity: 0.5;\n}\n.placeholder.btn::before {\n  display: inline-block;\n  content: \"\";\n}\n\n.placeholder-xs {\n  min-height: 0.6em;\n}\n\n.placeholder-sm {\n  min-height: 0.8em;\n}\n\n.placeholder-lg {\n  min-height: 1.2em;\n}\n\n.placeholder-glow .placeholder {\n  -webkit-animation: placeholder-glow 2s ease-in-out infinite;\n  animation: placeholder-glow 2s ease-in-out infinite;\n}\n\n@-webkit-keyframes placeholder-glow {\n  50% {\n    opacity: 0.2;\n  }\n}\n\n@keyframes placeholder-glow {\n  50% {\n    opacity: 0.2;\n  }\n}\n.placeholder-wave {\n  -webkit-mask-image: linear-gradient(130deg, #000 55%, rgba(0, 0, 0, 0.8) 75%, #000 95%);\n  mask-image: linear-gradient(130deg, #000 55%, rgba(0, 0, 0, 0.8) 75%, #000 95%);\n  -webkit-mask-size: 200% 100%;\n  mask-size: 200% 100%;\n  -webkit-animation: placeholder-wave 2s linear infinite;\n  animation: placeholder-wave 2s linear infinite;\n}\n\n@-webkit-keyframes placeholder-wave {\n  100% {\n    -webkit-mask-position: -200% 0%;\n    mask-position: -200% 0%;\n  }\n}\n\n@keyframes placeholder-wave {\n  100% {\n    -webkit-mask-position: -200% 0%;\n    mask-position: -200% 0%;\n  }\n}\n.clearfix::after {\n  display: block;\n  clear: both;\n  content: \"\";\n}\n\n.link-primary {\n  color: #0d6efd;\n}\n.link-primary:hover, .link-primary:focus {\n  color: #0a58ca;\n}\n\n.link-secondary {\n  color: #6c757d;\n}\n.link-secondary:hover, .link-secondary:focus {\n  color: #565e64;\n}\n\n.link-success {\n  color: #198754;\n}\n.link-success:hover, .link-success:focus {\n  color: #146c43;\n}\n\n.link-info {\n  color: #0dcaf0;\n}\n.link-info:hover, .link-info:focus {\n  color: #3dd5f3;\n}\n\n.link-warning {\n  color: #ffc107;\n}\n.link-warning:hover, .link-warning:focus {\n  color: #ffcd39;\n}\n\n.link-danger {\n  color: #dc3545;\n}\n.link-danger:hover, .link-danger:focus {\n  color: #b02a37;\n}\n\n.link-light {\n  color: #f8f9fa;\n}\n.link-light:hover, .link-light:focus {\n  color: #f9fafb;\n}\n\n.link-dark {\n  color: #212529;\n}\n.link-dark:hover, .link-dark:focus {\n  color: #1a1e21;\n}\n\n.ratio {\n  position: relative;\n  width: 100%;\n}\n.ratio::before {\n  display: block;\n  padding-top: var(--bs-aspect-ratio);\n  content: \"\";\n}\n.ratio > * {\n  position: absolute;\n  top: 0;\n  left: 0;\n  width: 100%;\n  height: 100%;\n}\n\n.ratio-1x1 {\n  --bs-aspect-ratio: 100%;\n}\n\n.ratio-4x3 {\n  --bs-aspect-ratio: calc(3 / 4 * 100%);\n}\n\n.ratio-16x9 {\n  --bs-aspect-ratio: calc(9 / 16 * 100%);\n}\n\n.ratio-21x9 {\n  --bs-aspect-ratio: calc(9 / 21 * 100%);\n}\n\n.fixed-top {\n  position: fixed;\n  top: 0;\n  right: 0;\n  left: 0;\n  z-index: 1030;\n}\n\n.fixed-bottom {\n  position: fixed;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  z-index: 1030;\n}\n\n.sticky-top {\n  position: -webkit-sticky;\n  position: sticky;\n  top: 0;\n  z-index: 1020;\n}\n\n@media (min-width: 576px) {\n  .sticky-sm-top {\n    position: -webkit-sticky;\n    position: sticky;\n    top: 0;\n    z-index: 1020;\n  }\n}\n@media (min-width: 768px) {\n  .sticky-md-top {\n    position: -webkit-sticky;\n    position: sticky;\n    top: 0;\n    z-index: 1020;\n  }\n}\n@media (min-width: 992px) {\n  .sticky-lg-top {\n    position: -webkit-sticky;\n    position: sticky;\n    top: 0;\n    z-index: 1020;\n  }\n}\n@media (min-width: 1200px) {\n  .sticky-xl-top {\n    position: -webkit-sticky;\n    position: sticky;\n    top: 0;\n    z-index: 1020;\n  }\n}\n@media (min-width: 1400px) {\n  .sticky-xxl-top {\n    position: -webkit-sticky;\n    position: sticky;\n    top: 0;\n    z-index: 1020;\n  }\n}\n.hstack {\n  display: flex;\n  flex-direction: row;\n  align-items: center;\n  align-self: stretch;\n}\n\n.vstack {\n  display: flex;\n  flex: 1 1 auto;\n  flex-direction: column;\n  align-self: stretch;\n}\n\n.visually-hidden,\n.visually-hidden-focusable:not(:focus):not(:focus-within) {\n  position: absolute !important;\n  width: 1px !important;\n  height: 1px !important;\n  padding: 0 !important;\n  margin: -1px !important;\n  overflow: hidden !important;\n  clip: rect(0, 0, 0, 0) !important;\n  white-space: nowrap !important;\n  border: 0 !important;\n}\n\n.stretched-link::after {\n  position: absolute;\n  top: 0;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  z-index: 1;\n  content: \"\";\n}\n\n.text-truncate {\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n\n.vr {\n  display: inline-block;\n  align-self: stretch;\n  width: 1px;\n  min-height: 1em;\n  background-color: currentColor;\n  opacity: 0.25;\n}\n\n.align-baseline {\n  vertical-align: baseline !important;\n}\n\n.align-top {\n  vertical-align: top !important;\n}\n\n.align-middle {\n  vertical-align: middle !important;\n}\n\n.align-bottom {\n  vertical-align: bottom !important;\n}\n\n.align-text-bottom {\n  vertical-align: text-bottom !important;\n}\n\n.align-text-top {\n  vertical-align: text-top !important;\n}\n\n.float-start {\n  float: left !important;\n}\n\n.float-end {\n  float: right !important;\n}\n\n.float-none {\n  float: none !important;\n}\n\n.opacity-0 {\n  opacity: 0 !important;\n}\n\n.opacity-25 {\n  opacity: 0.25 !important;\n}\n\n.opacity-50 {\n  opacity: 0.5 !important;\n}\n\n.opacity-75 {\n  opacity: 0.75 !important;\n}\n\n.opacity-100 {\n  opacity: 1 !important;\n}\n\n.overflow-auto {\n  overflow: auto !important;\n}\n\n.overflow-hidden {\n  overflow: hidden !important;\n}\n\n.overflow-visible {\n  overflow: visible !important;\n}\n\n.overflow-scroll {\n  overflow: scroll !important;\n}\n\n.d-inline {\n  display: inline !important;\n}\n\n.d-inline-block {\n  display: inline-block !important;\n}\n\n.d-block {\n  display: block !important;\n}\n\n.d-grid {\n  display: grid !important;\n}\n\n.d-table {\n  display: table !important;\n}\n\n.d-table-row {\n  display: table-row !important;\n}\n\n.d-table-cell {\n  display: table-cell !important;\n}\n\n.d-flex {\n  display: flex !important;\n}\n\n.d-inline-flex {\n  display: inline-flex !important;\n}\n\n.d-none {\n  display: none !important;\n}\n\n.shadow {\n  box-shadow: 0 0.5rem 1rem rgba(0, 0, 0, 0.15) !important;\n}\n\n.shadow-sm {\n  box-shadow: 0 0.125rem 0.25rem rgba(0, 0, 0, 0.075) !important;\n}\n\n.shadow-lg {\n  box-shadow: 0 1rem 3rem rgba(0, 0, 0, 0.175) !important;\n}\n\n.shadow-none {\n  box-shadow: none !important;\n}\n\n.position-static {\n  position: static !important;\n}\n\n.position-relative {\n  position: relative !important;\n}\n\n.position-absolute {\n  position: absolute !important;\n}\n\n.position-fixed {\n  position: fixed !important;\n}\n\n.position-sticky {\n  position: -webkit-sticky !important;\n  position: sticky !important;\n}\n\n.top-0 {\n  top: 0 !important;\n}\n\n.top-50 {\n  top: 50% !important;\n}\n\n.top-100 {\n  top: 100% !important;\n}\n\n.bottom-0 {\n  bottom: 0 !important;\n}\n\n.bottom-50 {\n  bottom: 50% !important;\n}\n\n.bottom-100 {\n  bottom: 100% !important;\n}\n\n.start-0 {\n  left: 0 !important;\n}\n\n.start-50 {\n  left: 50% !important;\n}\n\n.start-100 {\n  left: 100% !important;\n}\n\n.end-0 {\n  right: 0 !important;\n}\n\n.end-50 {\n  right: 50% !important;\n}\n\n.end-100 {\n  right: 100% !important;\n}\n\n.translate-middle {\n  transform: translate(-50%, -50%) !important;\n}\n\n.translate-middle-x {\n  transform: translateX(-50%) !important;\n}\n\n.translate-middle-y {\n  transform: translateY(-50%) !important;\n}\n\n.border {\n  border: 1px solid #dee2e6 !important;\n}\n\n.border-0 {\n  border: 0 !important;\n}\n\n.border-top {\n  border-top: 1px solid #dee2e6 !important;\n}\n\n.border-top-0 {\n  border-top: 0 !important;\n}\n\n.border-end {\n  border-right: 1px solid #dee2e6 !important;\n}\n\n.border-end-0 {\n  border-right: 0 !important;\n}\n\n.border-bottom {\n  border-bottom: 1px solid #dee2e6 !important;\n}\n\n.border-bottom-0 {\n  border-bottom: 0 !important;\n}\n\n.border-start {\n  border-left: 1px solid #dee2e6 !important;\n}\n\n.border-start-0 {\n  border-left: 0 !important;\n}\n\n.border-primary {\n  border-color: #0d6efd !important;\n}\n\n.border-secondary {\n  border-color: #6c757d !important;\n}\n\n.border-success {\n  border-color: #198754 !important;\n}\n\n.border-info {\n  border-color: #0dcaf0 !important;\n}\n\n.border-warning {\n  border-color: #ffc107 !important;\n}\n\n.border-danger {\n  border-color: #dc3545 !important;\n}\n\n.border-light {\n  border-color: #f8f9fa !important;\n}\n\n.border-dark {\n  border-color: #212529 !important;\n}\n\n.border-white {\n  border-color: #fff !important;\n}\n\n.border-1 {\n  border-width: 1px !important;\n}\n\n.border-2 {\n  border-width: 2px !important;\n}\n\n.border-3 {\n  border-width: 3px !important;\n}\n\n.border-4 {\n  border-width: 4px !important;\n}\n\n.border-5 {\n  border-width: 5px !important;\n}\n\n.w-25 {\n  width: 25% !important;\n}\n\n.w-50 {\n  width: 50% !important;\n}\n\n.w-75 {\n  width: 75% !important;\n}\n\n.w-100 {\n  width: 100% !important;\n}\n\n.w-auto {\n  width: auto !important;\n}\n\n.mw-100 {\n  max-width: 100% !important;\n}\n\n.vw-100 {\n  width: 100vw !important;\n}\n\n.min-vw-100 {\n  min-width: 100vw !important;\n}\n\n.h-25 {\n  height: 25% !important;\n}\n\n.h-50 {\n  height: 50% !important;\n}\n\n.h-75 {\n  height: 75% !important;\n}\n\n.h-100 {\n  height: 100% !important;\n}\n\n.h-auto {\n  height: auto !important;\n}\n\n.mh-100 {\n  max-height: 100% !important;\n}\n\n.vh-100 {\n  height: 100vh !important;\n}\n\n.min-vh-100 {\n  min-height: 100vh !important;\n}\n\n.flex-fill {\n  flex: 1 1 auto !important;\n}\n\n.flex-row {\n  flex-direction: row !important;\n}\n\n.flex-column {\n  flex-direction: column !important;\n}\n\n.flex-row-reverse {\n  flex-direction: row-reverse !important;\n}\n\n.flex-column-reverse {\n  flex-direction: column-reverse !important;\n}\n\n.flex-grow-0 {\n  flex-grow: 0 !important;\n}\n\n.flex-grow-1 {\n  flex-grow: 1 !important;\n}\n\n.flex-shrink-0 {\n  flex-shrink: 0 !important;\n}\n\n.flex-shrink-1 {\n  flex-shrink: 1 !important;\n}\n\n.flex-wrap {\n  flex-wrap: wrap !important;\n}\n\n.flex-nowrap {\n  flex-wrap: nowrap !important;\n}\n\n.flex-wrap-reverse {\n  flex-wrap: wrap-reverse !important;\n}\n\n.gap-0 {\n  gap: 0 !important;\n}\n\n.gap-1 {\n  gap: 0.25rem !important;\n}\n\n.gap-2 {\n  gap: 0.5rem !important;\n}\n\n.gap-3 {\n  gap: 1rem !important;\n}\n\n.gap-4 {\n  gap: 1.5rem !important;\n}\n\n.gap-5 {\n  gap: 3rem !important;\n}\n\n.justify-content-start {\n  justify-content: flex-start !important;\n}\n\n.justify-content-end {\n  justify-content: flex-end !important;\n}\n\n.justify-content-center {\n  justify-content: center !important;\n}\n\n.justify-content-between {\n  justify-content: space-between !important;\n}\n\n.justify-content-around {\n  justify-content: space-around !important;\n}\n\n.justify-content-evenly {\n  justify-content: space-evenly !important;\n}\n\n.align-items-start {\n  align-items: flex-start !important;\n}\n\n.align-items-end {\n  align-items: flex-end !important;\n}\n\n.align-items-center {\n  align-items: center !important;\n}\n\n.align-items-baseline {\n  align-items: baseline !important;\n}\n\n.align-items-stretch {\n  align-items: stretch !important;\n}\n\n.align-content-start {\n  align-content: flex-start !important;\n}\n\n.align-content-end {\n  align-content: flex-end !important;\n}\n\n.align-content-center {\n  align-content: center !important;\n}\n\n.align-content-between {\n  align-content: space-between !important;\n}\n\n.align-content-around {\n  align-content: space-around !important;\n}\n\n.align-content-stretch {\n  align-content: stretch !important;\n}\n\n.align-self-auto {\n  align-self: auto !important;\n}\n\n.align-self-start {\n  align-self: flex-start !important;\n}\n\n.align-self-end {\n  align-self: flex-end !important;\n}\n\n.align-self-center {\n  align-self: center !important;\n}\n\n.align-self-baseline {\n  align-self: baseline !important;\n}\n\n.align-self-stretch {\n  align-self: stretch !important;\n}\n\n.order-first {\n  order: -1 !important;\n}\n\n.order-0 {\n  order: 0 !important;\n}\n\n.order-1 {\n  order: 1 !important;\n}\n\n.order-2 {\n  order: 2 !important;\n}\n\n.order-3 {\n  order: 3 !important;\n}\n\n.order-4 {\n  order: 4 !important;\n}\n\n.order-5 {\n  order: 5 !important;\n}\n\n.order-last {\n  order: 6 !important;\n}\n\n.m-0 {\n  margin: 0 !important;\n}\n\n.m-1 {\n  margin: 0.25rem !important;\n}\n\n.m-2 {\n  margin: 0.5rem !important;\n}\n\n.m-3 {\n  margin: 1rem !important;\n}\n\n.m-4 {\n  margin: 1.5rem !important;\n}\n\n.m-5 {\n  margin: 3rem !important;\n}\n\n.m-auto {\n  margin: auto !important;\n}\n\n.mx-0 {\n  margin-right: 0 !important;\n  margin-left: 0 !important;\n}\n\n.mx-1 {\n  margin-right: 0.25rem !important;\n  margin-left: 0.25rem !important;\n}\n\n.mx-2 {\n  margin-right: 0.5rem !important;\n  margin-left: 0.5rem !important;\n}\n\n.mx-3 {\n  margin-right: 1rem !important;\n  margin-left: 1rem !important;\n}\n\n.mx-4 {\n  margin-right: 1.5rem !important;\n  margin-left: 1.5rem !important;\n}\n\n.mx-5 {\n  margin-right: 3rem !important;\n  margin-left: 3rem !important;\n}\n\n.mx-auto {\n  margin-right: auto !important;\n  margin-left: auto !important;\n}\n\n.my-0 {\n  margin-top: 0 !important;\n  margin-bottom: 0 !important;\n}\n\n.my-1 {\n  margin-top: 0.25rem !important;\n  margin-bottom: 0.25rem !important;\n}\n\n.my-2 {\n  margin-top: 0.5rem !important;\n  margin-bottom: 0.5rem !important;\n}\n\n.my-3 {\n  margin-top: 1rem !important;\n  margin-bottom: 1rem !important;\n}\n\n.my-4 {\n  margin-top: 1.5rem !important;\n  margin-bottom: 1.5rem !important;\n}\n\n.my-5 {\n  margin-top: 3rem !important;\n  margin-bottom: 3rem !important;\n}\n\n.my-auto {\n  margin-top: auto !important;\n  margin-bottom: auto !important;\n}\n\n.mt-0 {\n  margin-top: 0 !important;\n}\n\n.mt-1 {\n  margin-top: 0.25rem !important;\n}\n\n.mt-2 {\n  margin-top: 0.5rem !important;\n}\n\n.mt-3 {\n  margin-top: 1rem !important;\n}\n\n.mt-4 {\n  margin-top: 1.5rem !important;\n}\n\n.mt-5 {\n  margin-top: 3rem !important;\n}\n\n.mt-auto {\n  margin-top: auto !important;\n}\n\n.me-0 {\n  margin-right: 0 !important;\n}\n\n.me-1 {\n  margin-right: 0.25rem !important;\n}\n\n.me-2 {\n  margin-right: 0.5rem !important;\n}\n\n.me-3 {\n  margin-right: 1rem !important;\n}\n\n.me-4 {\n  margin-right: 1.5rem !important;\n}\n\n.me-5 {\n  margin-right: 3rem !important;\n}\n\n.me-auto {\n  margin-right: auto !important;\n}\n\n.mb-0 {\n  margin-bottom: 0 !important;\n}\n\n.mb-1 {\n  margin-bottom: 0.25rem !important;\n}\n\n.mb-2 {\n  margin-bottom: 0.5rem !important;\n}\n\n.mb-3 {\n  margin-bottom: 1rem !important;\n}\n\n.mb-4 {\n  margin-bottom: 1.5rem !important;\n}\n\n.mb-5 {\n  margin-bottom: 3rem !important;\n}\n\n.mb-auto {\n  margin-bottom: auto !important;\n}\n\n.ms-0 {\n  margin-left: 0 !important;\n}\n\n.ms-1 {\n  margin-left: 0.25rem !important;\n}\n\n.ms-2 {\n  margin-left: 0.5rem !important;\n}\n\n.ms-3 {\n  margin-left: 1rem !important;\n}\n\n.ms-4 {\n  margin-left: 1.5rem !important;\n}\n\n.ms-5 {\n  margin-left: 3rem !important;\n}\n\n.ms-auto {\n  margin-left: auto !important;\n}\n\n.p-0 {\n  padding: 0 !important;\n}\n\n.p-1 {\n  padding: 0.25rem !important;\n}\n\n.p-2 {\n  padding: 0.5rem !important;\n}\n\n.p-3 {\n  padding: 1rem !important;\n}\n\n.p-4 {\n  padding: 1.5rem !important;\n}\n\n.p-5 {\n  padding: 3rem !important;\n}\n\n.px-0 {\n  padding-right: 0 !important;\n  padding-left: 0 !important;\n}\n\n.px-1 {\n  padding-right: 0.25rem !important;\n  padding-left: 0.25rem !important;\n}\n\n.px-2 {\n  padding-right: 0.5rem !important;\n  padding-left: 0.5rem !important;\n}\n\n.px-3 {\n  padding-right: 1rem !important;\n  padding-left: 1rem !important;\n}\n\n.px-4 {\n  padding-right: 1.5rem !important;\n  padding-left: 1.5rem !important;\n}\n\n.px-5 {\n  padding-right: 3rem !important;\n  padding-left: 3rem !important;\n}\n\n.py-0 {\n  padding-top: 0 !important;\n  padding-bottom: 0 !important;\n}\n\n.py-1 {\n  padding-top: 0.25rem !important;\n  padding-bottom: 0.25rem !important;\n}\n\n.py-2 {\n  padding-top: 0.5rem !important;\n  padding-bottom: 0.5rem !important;\n}\n\n.py-3 {\n  padding-top: 1rem !important;\n  padding-bottom: 1rem !important;\n}\n\n.py-4 {\n  padding-top: 1.5rem !important;\n  padding-bottom: 1.5rem !important;\n}\n\n.py-5 {\n  padding-top: 3rem !important;\n  padding-bottom: 3rem !important;\n}\n\n.pt-0 {\n  padding-top: 0 !important;\n}\n\n.pt-1 {\n  padding-top: 0.25rem !important;\n}\n\n.pt-2 {\n  padding-top: 0.5rem !important;\n}\n\n.pt-3 {\n  padding-top: 1rem !important;\n}\n\n.pt-4 {\n  padding-top: 1.5rem !important;\n}\n\n.pt-5 {\n  padding-top: 3rem !important;\n}\n\n.pe-0 {\n  padding-right: 0 !important;\n}\n\n.pe-1 {\n  padding-right: 0.25rem !important;\n}\n\n.pe-2 {\n  padding-right: 0.5rem !important;\n}\n\n.pe-3 {\n  padding-right: 1rem !important;\n}\n\n.pe-4 {\n  padding-right: 1.5rem !important;\n}\n\n.pe-5 {\n  padding-right: 3rem !important;\n}\n\n.pb-0 {\n  padding-bottom: 0 !important;\n}\n\n.pb-1 {\n  padding-bottom: 0.25rem !important;\n}\n\n.pb-2 {\n  padding-bottom: 0.5rem !important;\n}\n\n.pb-3 {\n  padding-bottom: 1rem !important;\n}\n\n.pb-4 {\n  padding-bottom: 1.5rem !important;\n}\n\n.pb-5 {\n  padding-bottom: 3rem !important;\n}\n\n.ps-0 {\n  padding-left: 0 !important;\n}\n\n.ps-1 {\n  padding-left: 0.25rem !important;\n}\n\n.ps-2 {\n  padding-left: 0.5rem !important;\n}\n\n.ps-3 {\n  padding-left: 1rem !important;\n}\n\n.ps-4 {\n  padding-left: 1.5rem !important;\n}\n\n.ps-5 {\n  padding-left: 3rem !important;\n}\n\n.font-monospace {\n  font-family: var(--bs-font-monospace) !important;\n}\n\n.fs-1 {\n  font-size: calc(1.375rem + 1.5vw) !important;\n}\n\n.fs-2 {\n  font-size: calc(1.325rem + 0.9vw) !important;\n}\n\n.fs-3 {\n  font-size: calc(1.3rem + 0.6vw) !important;\n}\n\n.fs-4 {\n  font-size: calc(1.275rem + 0.3vw) !important;\n}\n\n.fs-5 {\n  font-size: 1.25rem !important;\n}\n\n.fs-6 {\n  font-size: 1rem !important;\n}\n\n.fst-italic {\n  font-style: italic !important;\n}\n\n.fst-normal {\n  font-style: normal !important;\n}\n\n.fw-light {\n  font-weight: 300 !important;\n}\n\n.fw-lighter {\n  font-weight: lighter !important;\n}\n\n.fw-normal {\n  font-weight: 400 !important;\n}\n\n.fw-bold {\n  font-weight: 700 !important;\n}\n\n.fw-bolder {\n  font-weight: bolder !important;\n}\n\n.lh-1 {\n  line-height: 1 !important;\n}\n\n.lh-sm {\n  line-height: 1.25 !important;\n}\n\n.lh-base {\n  line-height: 1.5 !important;\n}\n\n.lh-lg {\n  line-height: 2 !important;\n}\n\n.text-start {\n  text-align: left !important;\n}\n\n.text-end {\n  text-align: right !important;\n}\n\n.text-center {\n  text-align: center !important;\n}\n\n.text-decoration-none {\n  text-decoration: none !important;\n}\n\n.text-decoration-underline {\n  text-decoration: underline !important;\n}\n\n.text-decoration-line-through {\n  text-decoration: line-through !important;\n}\n\n.text-lowercase {\n  text-transform: lowercase !important;\n}\n\n.text-uppercase {\n  text-transform: uppercase !important;\n}\n\n.text-capitalize {\n  text-transform: capitalize !important;\n}\n\n.text-wrap {\n  white-space: normal !important;\n}\n\n.text-nowrap {\n  white-space: nowrap !important;\n}\n\n/* rtl:begin:remove */\n.text-break {\n  word-wrap: break-word !important;\n  word-break: break-word !important;\n}\n\n/* rtl:end:remove */\n.text-primary {\n  --bs-text-opacity: 1;\n  color: rgba(var(--bs-primary-rgb), var(--bs-text-opacity)) !important;\n}\n\n.text-secondary {\n  --bs-text-opacity: 1;\n  color: rgba(var(--bs-secondary-rgb), var(--bs-text-opacity)) !important;\n}\n\n.text-success {\n  --bs-text-opacity: 1;\n  color: rgba(var(--bs-success-rgb), var(--bs-text-opacity)) !important;\n}\n\n.text-info {\n  --bs-text-opacity: 1;\n  color: rgba(var(--bs-info-rgb), var(--bs-text-opacity)) !important;\n}\n\n.text-warning {\n  --bs-text-opacity: 1;\n  color: rgba(var(--bs-warning-rgb), var(--bs-text-opacity)) !important;\n}\n\n.text-danger {\n  --bs-text-opacity: 1;\n  color: rgba(var(--bs-danger-rgb), var(--bs-text-opacity)) !important;\n}\n\n.text-light {\n  --bs-text-opacity: 1;\n  color: rgba(var(--bs-light-rgb), var(--bs-text-opacity)) !important;\n}\n\n.text-dark {\n  --bs-text-opacity: 1;\n  color: rgba(var(--bs-dark-rgb), var(--bs-text-opacity)) !important;\n}\n\n.text-black {\n  --bs-text-opacity: 1;\n  color: rgba(var(--bs-black-rgb), var(--bs-text-opacity)) !important;\n}\n\n.text-white {\n  --bs-text-opacity: 1;\n  color: rgba(var(--bs-white-rgb), var(--bs-text-opacity)) !important;\n}\n\n.text-body {\n  --bs-text-opacity: 1;\n  color: rgba(var(--bs-body-rgb), var(--bs-text-opacity)) !important;\n}\n\n.text-muted {\n  --bs-text-opacity: 1;\n  color: #6c757d !important;\n}\n\n.text-black-50 {\n  --bs-text-opacity: 1;\n  color: rgba(0, 0, 0, 0.5) !important;\n}\n\n.text-white-50 {\n  --bs-text-opacity: 1;\n  color: rgba(255, 255, 255, 0.5) !important;\n}\n\n.text-reset {\n  --bs-text-opacity: 1;\n  color: inherit !important;\n}\n\n.text-opacity-25 {\n  --bs-text-opacity: 0.25;\n}\n\n.text-opacity-50 {\n  --bs-text-opacity: 0.5;\n}\n\n.text-opacity-75 {\n  --bs-text-opacity: 0.75;\n}\n\n.text-opacity-100 {\n  --bs-text-opacity: 1;\n}\n\n.bg-primary {\n  --bs-bg-opacity: 1;\n  background-color: rgba(var(--bs-primary-rgb), var(--bs-bg-opacity)) !important;\n}\n\n.bg-secondary {\n  --bs-bg-opacity: 1;\n  background-color: rgba(var(--bs-secondary-rgb), var(--bs-bg-opacity)) !important;\n}\n\n.bg-success {\n  --bs-bg-opacity: 1;\n  background-color: rgba(var(--bs-success-rgb), var(--bs-bg-opacity)) !important;\n}\n\n.bg-info {\n  --bs-bg-opacity: 1;\n  background-color: rgba(var(--bs-info-rgb), var(--bs-bg-opacity)) !important;\n}\n\n.bg-warning {\n  --bs-bg-opacity: 1;\n  background-color: rgba(var(--bs-warning-rgb), var(--bs-bg-opacity)) !important;\n}\n\n.bg-danger {\n  --bs-bg-opacity: 1;\n  background-color: rgba(var(--bs-danger-rgb), var(--bs-bg-opacity)) !important;\n}\n\n.bg-light {\n  --bs-bg-opacity: 1;\n  background-color: rgba(var(--bs-light-rgb), var(--bs-bg-opacity)) !important;\n}\n\n.bg-dark {\n  --bs-bg-opacity: 1;\n  background-color: rgba(var(--bs-dark-rgb), var(--bs-bg-opacity)) !important;\n}\n\n.bg-black {\n  --bs-bg-opacity: 1;\n  background-color: rgba(var(--bs-black-rgb), var(--bs-bg-opacity)) !important;\n}\n\n.bg-white {\n  --bs-bg-opacity: 1;\n  background-color: rgba(var(--bs-white-rgb), var(--bs-bg-opacity)) !important;\n}\n\n.bg-body {\n  --bs-bg-opacity: 1;\n  background-color: rgba(var(--bs-body-rgb), var(--bs-bg-opacity)) !important;\n}\n\n.bg-transparent {\n  --bs-bg-opacity: 1;\n  background-color: transparent !important;\n}\n\n.bg-opacity-10 {\n  --bs-bg-opacity: 0.1;\n}\n\n.bg-opacity-25 {\n  --bs-bg-opacity: 0.25;\n}\n\n.bg-opacity-50 {\n  --bs-bg-opacity: 0.5;\n}\n\n.bg-opacity-75 {\n  --bs-bg-opacity: 0.75;\n}\n\n.bg-opacity-100 {\n  --bs-bg-opacity: 1;\n}\n\n.bg-gradient {\n  background-image: var(--bs-gradient) !important;\n}\n\n.user-select-all {\n  -webkit-user-select: all !important;\n  -moz-user-select: all !important;\n  user-select: all !important;\n}\n\n.user-select-auto {\n  -webkit-user-select: auto !important;\n  -moz-user-select: auto !important;\n  user-select: auto !important;\n}\n\n.user-select-none {\n  -webkit-user-select: none !important;\n  -moz-user-select: none !important;\n  user-select: none !important;\n}\n\n.pe-none {\n  pointer-events: none !important;\n}\n\n.pe-auto {\n  pointer-events: auto !important;\n}\n\n.rounded {\n  border-radius: 0.25rem !important;\n}\n\n.rounded-0 {\n  border-radius: 0 !important;\n}\n\n.rounded-1 {\n  border-radius: 0.2rem !important;\n}\n\n.rounded-2 {\n  border-radius: 0.25rem !important;\n}\n\n.rounded-3 {\n  border-radius: 0.3rem !important;\n}\n\n.rounded-circle {\n  border-radius: 50% !important;\n}\n\n.rounded-pill {\n  border-radius: 50rem !important;\n}\n\n.rounded-top {\n  border-top-left-radius: 0.25rem !important;\n  border-top-right-radius: 0.25rem !important;\n}\n\n.rounded-end {\n  border-top-right-radius: 0.25rem !important;\n  border-bottom-right-radius: 0.25rem !important;\n}\n\n.rounded-bottom {\n  border-bottom-right-radius: 0.25rem !important;\n  border-bottom-left-radius: 0.25rem !important;\n}\n\n.rounded-start {\n  border-bottom-left-radius: 0.25rem !important;\n  border-top-left-radius: 0.25rem !important;\n}\n\n.visible {\n  visibility: visible !important;\n}\n\n.invisible {\n  visibility: hidden !important;\n}\n\n@media (min-width: 576px) {\n  .float-sm-start {\n    float: left !important;\n  }\n\n  .float-sm-end {\n    float: right !important;\n  }\n\n  .float-sm-none {\n    float: none !important;\n  }\n\n  .d-sm-inline {\n    display: inline !important;\n  }\n\n  .d-sm-inline-block {\n    display: inline-block !important;\n  }\n\n  .d-sm-block {\n    display: block !important;\n  }\n\n  .d-sm-grid {\n    display: grid !important;\n  }\n\n  .d-sm-table {\n    display: table !important;\n  }\n\n  .d-sm-table-row {\n    display: table-row !important;\n  }\n\n  .d-sm-table-cell {\n    display: table-cell !important;\n  }\n\n  .d-sm-flex {\n    display: flex !important;\n  }\n\n  .d-sm-inline-flex {\n    display: inline-flex !important;\n  }\n\n  .d-sm-none {\n    display: none !important;\n  }\n\n  .flex-sm-fill {\n    flex: 1 1 auto !important;\n  }\n\n  .flex-sm-row {\n    flex-direction: row !important;\n  }\n\n  .flex-sm-column {\n    flex-direction: column !important;\n  }\n\n  .flex-sm-row-reverse {\n    flex-direction: row-reverse !important;\n  }\n\n  .flex-sm-column-reverse {\n    flex-direction: column-reverse !important;\n  }\n\n  .flex-sm-grow-0 {\n    flex-grow: 0 !important;\n  }\n\n  .flex-sm-grow-1 {\n    flex-grow: 1 !important;\n  }\n\n  .flex-sm-shrink-0 {\n    flex-shrink: 0 !important;\n  }\n\n  .flex-sm-shrink-1 {\n    flex-shrink: 1 !important;\n  }\n\n  .flex-sm-wrap {\n    flex-wrap: wrap !important;\n  }\n\n  .flex-sm-nowrap {\n    flex-wrap: nowrap !important;\n  }\n\n  .flex-sm-wrap-reverse {\n    flex-wrap: wrap-reverse !important;\n  }\n\n  .gap-sm-0 {\n    gap: 0 !important;\n  }\n\n  .gap-sm-1 {\n    gap: 0.25rem !important;\n  }\n\n  .gap-sm-2 {\n    gap: 0.5rem !important;\n  }\n\n  .gap-sm-3 {\n    gap: 1rem !important;\n  }\n\n  .gap-sm-4 {\n    gap: 1.5rem !important;\n  }\n\n  .gap-sm-5 {\n    gap: 3rem !important;\n  }\n\n  .justify-content-sm-start {\n    justify-content: flex-start !important;\n  }\n\n  .justify-content-sm-end {\n    justify-content: flex-end !important;\n  }\n\n  .justify-content-sm-center {\n    justify-content: center !important;\n  }\n\n  .justify-content-sm-between {\n    justify-content: space-between !important;\n  }\n\n  .justify-content-sm-around {\n    justify-content: space-around !important;\n  }\n\n  .justify-content-sm-evenly {\n    justify-content: space-evenly !important;\n  }\n\n  .align-items-sm-start {\n    align-items: flex-start !important;\n  }\n\n  .align-items-sm-end {\n    align-items: flex-end !important;\n  }\n\n  .align-items-sm-center {\n    align-items: center !important;\n  }\n\n  .align-items-sm-baseline {\n    align-items: baseline !important;\n  }\n\n  .align-items-sm-stretch {\n    align-items: stretch !important;\n  }\n\n  .align-content-sm-start {\n    align-content: flex-start !important;\n  }\n\n  .align-content-sm-end {\n    align-content: flex-end !important;\n  }\n\n  .align-content-sm-center {\n    align-content: center !important;\n  }\n\n  .align-content-sm-between {\n    align-content: space-between !important;\n  }\n\n  .align-content-sm-around {\n    align-content: space-around !important;\n  }\n\n  .align-content-sm-stretch {\n    align-content: stretch !important;\n  }\n\n  .align-self-sm-auto {\n    align-self: auto !important;\n  }\n\n  .align-self-sm-start {\n    align-self: flex-start !important;\n  }\n\n  .align-self-sm-end {\n    align-self: flex-end !important;\n  }\n\n  .align-self-sm-center {\n    align-self: center !important;\n  }\n\n  .align-self-sm-baseline {\n    align-self: baseline !important;\n  }\n\n  .align-self-sm-stretch {\n    align-self: stretch !important;\n  }\n\n  .order-sm-first {\n    order: -1 !important;\n  }\n\n  .order-sm-0 {\n    order: 0 !important;\n  }\n\n  .order-sm-1 {\n    order: 1 !important;\n  }\n\n  .order-sm-2 {\n    order: 2 !important;\n  }\n\n  .order-sm-3 {\n    order: 3 !important;\n  }\n\n  .order-sm-4 {\n    order: 4 !important;\n  }\n\n  .order-sm-5 {\n    order: 5 !important;\n  }\n\n  .order-sm-last {\n    order: 6 !important;\n  }\n\n  .m-sm-0 {\n    margin: 0 !important;\n  }\n\n  .m-sm-1 {\n    margin: 0.25rem !important;\n  }\n\n  .m-sm-2 {\n    margin: 0.5rem !important;\n  }\n\n  .m-sm-3 {\n    margin: 1rem !important;\n  }\n\n  .m-sm-4 {\n    margin: 1.5rem !important;\n  }\n\n  .m-sm-5 {\n    margin: 3rem !important;\n  }\n\n  .m-sm-auto {\n    margin: auto !important;\n  }\n\n  .mx-sm-0 {\n    margin-right: 0 !important;\n    margin-left: 0 !important;\n  }\n\n  .mx-sm-1 {\n    margin-right: 0.25rem !important;\n    margin-left: 0.25rem !important;\n  }\n\n  .mx-sm-2 {\n    margin-right: 0.5rem !important;\n    margin-left: 0.5rem !important;\n  }\n\n  .mx-sm-3 {\n    margin-right: 1rem !important;\n    margin-left: 1rem !important;\n  }\n\n  .mx-sm-4 {\n    margin-right: 1.5rem !important;\n    margin-left: 1.5rem !important;\n  }\n\n  .mx-sm-5 {\n    margin-right: 3rem !important;\n    margin-left: 3rem !important;\n  }\n\n  .mx-sm-auto {\n    margin-right: auto !important;\n    margin-left: auto !important;\n  }\n\n  .my-sm-0 {\n    margin-top: 0 !important;\n    margin-bottom: 0 !important;\n  }\n\n  .my-sm-1 {\n    margin-top: 0.25rem !important;\n    margin-bottom: 0.25rem !important;\n  }\n\n  .my-sm-2 {\n    margin-top: 0.5rem !important;\n    margin-bottom: 0.5rem !important;\n  }\n\n  .my-sm-3 {\n    margin-top: 1rem !important;\n    margin-bottom: 1rem !important;\n  }\n\n  .my-sm-4 {\n    margin-top: 1.5rem !important;\n    margin-bottom: 1.5rem !important;\n  }\n\n  .my-sm-5 {\n    margin-top: 3rem !important;\n    margin-bottom: 3rem !important;\n  }\n\n  .my-sm-auto {\n    margin-top: auto !important;\n    margin-bottom: auto !important;\n  }\n\n  .mt-sm-0 {\n    margin-top: 0 !important;\n  }\n\n  .mt-sm-1 {\n    margin-top: 0.25rem !important;\n  }\n\n  .mt-sm-2 {\n    margin-top: 0.5rem !important;\n  }\n\n  .mt-sm-3 {\n    margin-top: 1rem !important;\n  }\n\n  .mt-sm-4 {\n    margin-top: 1.5rem !important;\n  }\n\n  .mt-sm-5 {\n    margin-top: 3rem !important;\n  }\n\n  .mt-sm-auto {\n    margin-top: auto !important;\n  }\n\n  .me-sm-0 {\n    margin-right: 0 !important;\n  }\n\n  .me-sm-1 {\n    margin-right: 0.25rem !important;\n  }\n\n  .me-sm-2 {\n    margin-right: 0.5rem !important;\n  }\n\n  .me-sm-3 {\n    margin-right: 1rem !important;\n  }\n\n  .me-sm-4 {\n    margin-right: 1.5rem !important;\n  }\n\n  .me-sm-5 {\n    margin-right: 3rem !important;\n  }\n\n  .me-sm-auto {\n    margin-right: auto !important;\n  }\n\n  .mb-sm-0 {\n    margin-bottom: 0 !important;\n  }\n\n  .mb-sm-1 {\n    margin-bottom: 0.25rem !important;\n  }\n\n  .mb-sm-2 {\n    margin-bottom: 0.5rem !important;\n  }\n\n  .mb-sm-3 {\n    margin-bottom: 1rem !important;\n  }\n\n  .mb-sm-4 {\n    margin-bottom: 1.5rem !important;\n  }\n\n  .mb-sm-5 {\n    margin-bottom: 3rem !important;\n  }\n\n  .mb-sm-auto {\n    margin-bottom: auto !important;\n  }\n\n  .ms-sm-0 {\n    margin-left: 0 !important;\n  }\n\n  .ms-sm-1 {\n    margin-left: 0.25rem !important;\n  }\n\n  .ms-sm-2 {\n    margin-left: 0.5rem !important;\n  }\n\n  .ms-sm-3 {\n    margin-left: 1rem !important;\n  }\n\n  .ms-sm-4 {\n    margin-left: 1.5rem !important;\n  }\n\n  .ms-sm-5 {\n    margin-left: 3rem !important;\n  }\n\n  .ms-sm-auto {\n    margin-left: auto !important;\n  }\n\n  .p-sm-0 {\n    padding: 0 !important;\n  }\n\n  .p-sm-1 {\n    padding: 0.25rem !important;\n  }\n\n  .p-sm-2 {\n    padding: 0.5rem !important;\n  }\n\n  .p-sm-3 {\n    padding: 1rem !important;\n  }\n\n  .p-sm-4 {\n    padding: 1.5rem !important;\n  }\n\n  .p-sm-5 {\n    padding: 3rem !important;\n  }\n\n  .px-sm-0 {\n    padding-right: 0 !important;\n    padding-left: 0 !important;\n  }\n\n  .px-sm-1 {\n    padding-right: 0.25rem !important;\n    padding-left: 0.25rem !important;\n  }\n\n  .px-sm-2 {\n    padding-right: 0.5rem !important;\n    padding-left: 0.5rem !important;\n  }\n\n  .px-sm-3 {\n    padding-right: 1rem !important;\n    padding-left: 1rem !important;\n  }\n\n  .px-sm-4 {\n    padding-right: 1.5rem !important;\n    padding-left: 1.5rem !important;\n  }\n\n  .px-sm-5 {\n    padding-right: 3rem !important;\n    padding-left: 3rem !important;\n  }\n\n  .py-sm-0 {\n    padding-top: 0 !important;\n    padding-bottom: 0 !important;\n  }\n\n  .py-sm-1 {\n    padding-top: 0.25rem !important;\n    padding-bottom: 0.25rem !important;\n  }\n\n  .py-sm-2 {\n    padding-top: 0.5rem !important;\n    padding-bottom: 0.5rem !important;\n  }\n\n  .py-sm-3 {\n    padding-top: 1rem !important;\n    padding-bottom: 1rem !important;\n  }\n\n  .py-sm-4 {\n    padding-top: 1.5rem !important;\n    padding-bottom: 1.5rem !important;\n  }\n\n  .py-sm-5 {\n    padding-top: 3rem !important;\n    padding-bottom: 3rem !important;\n  }\n\n  .pt-sm-0 {\n    padding-top: 0 !important;\n  }\n\n  .pt-sm-1 {\n    padding-top: 0.25rem !important;\n  }\n\n  .pt-sm-2 {\n    padding-top: 0.5rem !important;\n  }\n\n  .pt-sm-3 {\n    padding-top: 1rem !important;\n  }\n\n  .pt-sm-4 {\n    padding-top: 1.5rem !important;\n  }\n\n  .pt-sm-5 {\n    padding-top: 3rem !important;\n  }\n\n  .pe-sm-0 {\n    padding-right: 0 !important;\n  }\n\n  .pe-sm-1 {\n    padding-right: 0.25rem !important;\n  }\n\n  .pe-sm-2 {\n    padding-right: 0.5rem !important;\n  }\n\n  .pe-sm-3 {\n    padding-right: 1rem !important;\n  }\n\n  .pe-sm-4 {\n    padding-right: 1.5rem !important;\n  }\n\n  .pe-sm-5 {\n    padding-right: 3rem !important;\n  }\n\n  .pb-sm-0 {\n    padding-bottom: 0 !important;\n  }\n\n  .pb-sm-1 {\n    padding-bottom: 0.25rem !important;\n  }\n\n  .pb-sm-2 {\n    padding-bottom: 0.5rem !important;\n  }\n\n  .pb-sm-3 {\n    padding-bottom: 1rem !important;\n  }\n\n  .pb-sm-4 {\n    padding-bottom: 1.5rem !important;\n  }\n\n  .pb-sm-5 {\n    padding-bottom: 3rem !important;\n  }\n\n  .ps-sm-0 {\n    padding-left: 0 !important;\n  }\n\n  .ps-sm-1 {\n    padding-left: 0.25rem !important;\n  }\n\n  .ps-sm-2 {\n    padding-left: 0.5rem !important;\n  }\n\n  .ps-sm-3 {\n    padding-left: 1rem !important;\n  }\n\n  .ps-sm-4 {\n    padding-left: 1.5rem !important;\n  }\n\n  .ps-sm-5 {\n    padding-left: 3rem !important;\n  }\n\n  .text-sm-start {\n    text-align: left !important;\n  }\n\n  .text-sm-end {\n    text-align: right !important;\n  }\n\n  .text-sm-center {\n    text-align: center !important;\n  }\n}\n@media (min-width: 768px) {\n  .float-md-start {\n    float: left !important;\n  }\n\n  .float-md-end {\n    float: right !important;\n  }\n\n  .float-md-none {\n    float: none !important;\n  }\n\n  .d-md-inline {\n    display: inline !important;\n  }\n\n  .d-md-inline-block {\n    display: inline-block !important;\n  }\n\n  .d-md-block {\n    display: block !important;\n  }\n\n  .d-md-grid {\n    display: grid !important;\n  }\n\n  .d-md-table {\n    display: table !important;\n  }\n\n  .d-md-table-row {\n    display: table-row !important;\n  }\n\n  .d-md-table-cell {\n    display: table-cell !important;\n  }\n\n  .d-md-flex {\n    display: flex !important;\n  }\n\n  .d-md-inline-flex {\n    display: inline-flex !important;\n  }\n\n  .d-md-none {\n    display: none !important;\n  }\n\n  .flex-md-fill {\n    flex: 1 1 auto !important;\n  }\n\n  .flex-md-row {\n    flex-direction: row !important;\n  }\n\n  .flex-md-column {\n    flex-direction: column !important;\n  }\n\n  .flex-md-row-reverse {\n    flex-direction: row-reverse !important;\n  }\n\n  .flex-md-column-reverse {\n    flex-direction: column-reverse !important;\n  }\n\n  .flex-md-grow-0 {\n    flex-grow: 0 !important;\n  }\n\n  .flex-md-grow-1 {\n    flex-grow: 1 !important;\n  }\n\n  .flex-md-shrink-0 {\n    flex-shrink: 0 !important;\n  }\n\n  .flex-md-shrink-1 {\n    flex-shrink: 1 !important;\n  }\n\n  .flex-md-wrap {\n    flex-wrap: wrap !important;\n  }\n\n  .flex-md-nowrap {\n    flex-wrap: nowrap !important;\n  }\n\n  .flex-md-wrap-reverse {\n    flex-wrap: wrap-reverse !important;\n  }\n\n  .gap-md-0 {\n    gap: 0 !important;\n  }\n\n  .gap-md-1 {\n    gap: 0.25rem !important;\n  }\n\n  .gap-md-2 {\n    gap: 0.5rem !important;\n  }\n\n  .gap-md-3 {\n    gap: 1rem !important;\n  }\n\n  .gap-md-4 {\n    gap: 1.5rem !important;\n  }\n\n  .gap-md-5 {\n    gap: 3rem !important;\n  }\n\n  .justify-content-md-start {\n    justify-content: flex-start !important;\n  }\n\n  .justify-content-md-end {\n    justify-content: flex-end !important;\n  }\n\n  .justify-content-md-center {\n    justify-content: center !important;\n  }\n\n  .justify-content-md-between {\n    justify-content: space-between !important;\n  }\n\n  .justify-content-md-around {\n    justify-content: space-around !important;\n  }\n\n  .justify-content-md-evenly {\n    justify-content: space-evenly !important;\n  }\n\n  .align-items-md-start {\n    align-items: flex-start !important;\n  }\n\n  .align-items-md-end {\n    align-items: flex-end !important;\n  }\n\n  .align-items-md-center {\n    align-items: center !important;\n  }\n\n  .align-items-md-baseline {\n    align-items: baseline !important;\n  }\n\n  .align-items-md-stretch {\n    align-items: stretch !important;\n  }\n\n  .align-content-md-start {\n    align-content: flex-start !important;\n  }\n\n  .align-content-md-end {\n    align-content: flex-end !important;\n  }\n\n  .align-content-md-center {\n    align-content: center !important;\n  }\n\n  .align-content-md-between {\n    align-content: space-between !important;\n  }\n\n  .align-content-md-around {\n    align-content: space-around !important;\n  }\n\n  .align-content-md-stretch {\n    align-content: stretch !important;\n  }\n\n  .align-self-md-auto {\n    align-self: auto !important;\n  }\n\n  .align-self-md-start {\n    align-self: flex-start !important;\n  }\n\n  .align-self-md-end {\n    align-self: flex-end !important;\n  }\n\n  .align-self-md-center {\n    align-self: center !important;\n  }\n\n  .align-self-md-baseline {\n    align-self: baseline !important;\n  }\n\n  .align-self-md-stretch {\n    align-self: stretch !important;\n  }\n\n  .order-md-first {\n    order: -1 !important;\n  }\n\n  .order-md-0 {\n    order: 0 !important;\n  }\n\n  .order-md-1 {\n    order: 1 !important;\n  }\n\n  .order-md-2 {\n    order: 2 !important;\n  }\n\n  .order-md-3 {\n    order: 3 !important;\n  }\n\n  .order-md-4 {\n    order: 4 !important;\n  }\n\n  .order-md-5 {\n    order: 5 !important;\n  }\n\n  .order-md-last {\n    order: 6 !important;\n  }\n\n  .m-md-0 {\n    margin: 0 !important;\n  }\n\n  .m-md-1 {\n    margin: 0.25rem !important;\n  }\n\n  .m-md-2 {\n    margin: 0.5rem !important;\n  }\n\n  .m-md-3 {\n    margin: 1rem !important;\n  }\n\n  .m-md-4 {\n    margin: 1.5rem !important;\n  }\n\n  .m-md-5 {\n    margin: 3rem !important;\n  }\n\n  .m-md-auto {\n    margin: auto !important;\n  }\n\n  .mx-md-0 {\n    margin-right: 0 !important;\n    margin-left: 0 !important;\n  }\n\n  .mx-md-1 {\n    margin-right: 0.25rem !important;\n    margin-left: 0.25rem !important;\n  }\n\n  .mx-md-2 {\n    margin-right: 0.5rem !important;\n    margin-left: 0.5rem !important;\n  }\n\n  .mx-md-3 {\n    margin-right: 1rem !important;\n    margin-left: 1rem !important;\n  }\n\n  .mx-md-4 {\n    margin-right: 1.5rem !important;\n    margin-left: 1.5rem !important;\n  }\n\n  .mx-md-5 {\n    margin-right: 3rem !important;\n    margin-left: 3rem !important;\n  }\n\n  .mx-md-auto {\n    margin-right: auto !important;\n    margin-left: auto !important;\n  }\n\n  .my-md-0 {\n    margin-top: 0 !important;\n    margin-bottom: 0 !important;\n  }\n\n  .my-md-1 {\n    margin-top: 0.25rem !important;\n    margin-bottom: 0.25rem !important;\n  }\n\n  .my-md-2 {\n    margin-top: 0.5rem !important;\n    margin-bottom: 0.5rem !important;\n  }\n\n  .my-md-3 {\n    margin-top: 1rem !important;\n    margin-bottom: 1rem !important;\n  }\n\n  .my-md-4 {\n    margin-top: 1.5rem !important;\n    margin-bottom: 1.5rem !important;\n  }\n\n  .my-md-5 {\n    margin-top: 3rem !important;\n    margin-bottom: 3rem !important;\n  }\n\n  .my-md-auto {\n    margin-top: auto !important;\n    margin-bottom: auto !important;\n  }\n\n  .mt-md-0 {\n    margin-top: 0 !important;\n  }\n\n  .mt-md-1 {\n    margin-top: 0.25rem !important;\n  }\n\n  .mt-md-2 {\n    margin-top: 0.5rem !important;\n  }\n\n  .mt-md-3 {\n    margin-top: 1rem !important;\n  }\n\n  .mt-md-4 {\n    margin-top: 1.5rem !important;\n  }\n\n  .mt-md-5 {\n    margin-top: 3rem !important;\n  }\n\n  .mt-md-auto {\n    margin-top: auto !important;\n  }\n\n  .me-md-0 {\n    margin-right: 0 !important;\n  }\n\n  .me-md-1 {\n    margin-right: 0.25rem !important;\n  }\n\n  .me-md-2 {\n    margin-right: 0.5rem !important;\n  }\n\n  .me-md-3 {\n    margin-right: 1rem !important;\n  }\n\n  .me-md-4 {\n    margin-right: 1.5rem !important;\n  }\n\n  .me-md-5 {\n    margin-right: 3rem !important;\n  }\n\n  .me-md-auto {\n    margin-right: auto !important;\n  }\n\n  .mb-md-0 {\n    margin-bottom: 0 !important;\n  }\n\n  .mb-md-1 {\n    margin-bottom: 0.25rem !important;\n  }\n\n  .mb-md-2 {\n    margin-bottom: 0.5rem !important;\n  }\n\n  .mb-md-3 {\n    margin-bottom: 1rem !important;\n  }\n\n  .mb-md-4 {\n    margin-bottom: 1.5rem !important;\n  }\n\n  .mb-md-5 {\n    margin-bottom: 3rem !important;\n  }\n\n  .mb-md-auto {\n    margin-bottom: auto !important;\n  }\n\n  .ms-md-0 {\n    margin-left: 0 !important;\n  }\n\n  .ms-md-1 {\n    margin-left: 0.25rem !important;\n  }\n\n  .ms-md-2 {\n    margin-left: 0.5rem !important;\n  }\n\n  .ms-md-3 {\n    margin-left: 1rem !important;\n  }\n\n  .ms-md-4 {\n    margin-left: 1.5rem !important;\n  }\n\n  .ms-md-5 {\n    margin-left: 3rem !important;\n  }\n\n  .ms-md-auto {\n    margin-left: auto !important;\n  }\n\n  .p-md-0 {\n    padding: 0 !important;\n  }\n\n  .p-md-1 {\n    padding: 0.25rem !important;\n  }\n\n  .p-md-2 {\n    padding: 0.5rem !important;\n  }\n\n  .p-md-3 {\n    padding: 1rem !important;\n  }\n\n  .p-md-4 {\n    padding: 1.5rem !important;\n  }\n\n  .p-md-5 {\n    padding: 3rem !important;\n  }\n\n  .px-md-0 {\n    padding-right: 0 !important;\n    padding-left: 0 !important;\n  }\n\n  .px-md-1 {\n    padding-right: 0.25rem !important;\n    padding-left: 0.25rem !important;\n  }\n\n  .px-md-2 {\n    padding-right: 0.5rem !important;\n    padding-left: 0.5rem !important;\n  }\n\n  .px-md-3 {\n    padding-right: 1rem !important;\n    padding-left: 1rem !important;\n  }\n\n  .px-md-4 {\n    padding-right: 1.5rem !important;\n    padding-left: 1.5rem !important;\n  }\n\n  .px-md-5 {\n    padding-right: 3rem !important;\n    padding-left: 3rem !important;\n  }\n\n  .py-md-0 {\n    padding-top: 0 !important;\n    padding-bottom: 0 !important;\n  }\n\n  .py-md-1 {\n    padding-top: 0.25rem !important;\n    padding-bottom: 0.25rem !important;\n  }\n\n  .py-md-2 {\n    padding-top: 0.5rem !important;\n    padding-bottom: 0.5rem !important;\n  }\n\n  .py-md-3 {\n    padding-top: 1rem !important;\n    padding-bottom: 1rem !important;\n  }\n\n  .py-md-4 {\n    padding-top: 1.5rem !important;\n    padding-bottom: 1.5rem !important;\n  }\n\n  .py-md-5 {\n    padding-top: 3rem !important;\n    padding-bottom: 3rem !important;\n  }\n\n  .pt-md-0 {\n    padding-top: 0 !important;\n  }\n\n  .pt-md-1 {\n    padding-top: 0.25rem !important;\n  }\n\n  .pt-md-2 {\n    padding-top: 0.5rem !important;\n  }\n\n  .pt-md-3 {\n    padding-top: 1rem !important;\n  }\n\n  .pt-md-4 {\n    padding-top: 1.5rem !important;\n  }\n\n  .pt-md-5 {\n    padding-top: 3rem !important;\n  }\n\n  .pe-md-0 {\n    padding-right: 0 !important;\n  }\n\n  .pe-md-1 {\n    padding-right: 0.25rem !important;\n  }\n\n  .pe-md-2 {\n    padding-right: 0.5rem !important;\n  }\n\n  .pe-md-3 {\n    padding-right: 1rem !important;\n  }\n\n  .pe-md-4 {\n    padding-right: 1.5rem !important;\n  }\n\n  .pe-md-5 {\n    padding-right: 3rem !important;\n  }\n\n  .pb-md-0 {\n    padding-bottom: 0 !important;\n  }\n\n  .pb-md-1 {\n    padding-bottom: 0.25rem !important;\n  }\n\n  .pb-md-2 {\n    padding-bottom: 0.5rem !important;\n  }\n\n  .pb-md-3 {\n    padding-bottom: 1rem !important;\n  }\n\n  .pb-md-4 {\n    padding-bottom: 1.5rem !important;\n  }\n\n  .pb-md-5 {\n    padding-bottom: 3rem !important;\n  }\n\n  .ps-md-0 {\n    padding-left: 0 !important;\n  }\n\n  .ps-md-1 {\n    padding-left: 0.25rem !important;\n  }\n\n  .ps-md-2 {\n    padding-left: 0.5rem !important;\n  }\n\n  .ps-md-3 {\n    padding-left: 1rem !important;\n  }\n\n  .ps-md-4 {\n    padding-left: 1.5rem !important;\n  }\n\n  .ps-md-5 {\n    padding-left: 3rem !important;\n  }\n\n  .text-md-start {\n    text-align: left !important;\n  }\n\n  .text-md-end {\n    text-align: right !important;\n  }\n\n  .text-md-center {\n    text-align: center !important;\n  }\n}\n@media (min-width: 992px) {\n  .float-lg-start {\n    float: left !important;\n  }\n\n  .float-lg-end {\n    float: right !important;\n  }\n\n  .float-lg-none {\n    float: none !important;\n  }\n\n  .d-lg-inline {\n    display: inline !important;\n  }\n\n  .d-lg-inline-block {\n    display: inline-block !important;\n  }\n\n  .d-lg-block {\n    display: block !important;\n  }\n\n  .d-lg-grid {\n    display: grid !important;\n  }\n\n  .d-lg-table {\n    display: table !important;\n  }\n\n  .d-lg-table-row {\n    display: table-row !important;\n  }\n\n  .d-lg-table-cell {\n    display: table-cell !important;\n  }\n\n  .d-lg-flex {\n    display: flex !important;\n  }\n\n  .d-lg-inline-flex {\n    display: inline-flex !important;\n  }\n\n  .d-lg-none {\n    display: none !important;\n  }\n\n  .flex-lg-fill {\n    flex: 1 1 auto !important;\n  }\n\n  .flex-lg-row {\n    flex-direction: row !important;\n  }\n\n  .flex-lg-column {\n    flex-direction: column !important;\n  }\n\n  .flex-lg-row-reverse {\n    flex-direction: row-reverse !important;\n  }\n\n  .flex-lg-column-reverse {\n    flex-direction: column-reverse !important;\n  }\n\n  .flex-lg-grow-0 {\n    flex-grow: 0 !important;\n  }\n\n  .flex-lg-grow-1 {\n    flex-grow: 1 !important;\n  }\n\n  .flex-lg-shrink-0 {\n    flex-shrink: 0 !important;\n  }\n\n  .flex-lg-shrink-1 {\n    flex-shrink: 1 !important;\n  }\n\n  .flex-lg-wrap {\n    flex-wrap: wrap !important;\n  }\n\n  .flex-lg-nowrap {\n    flex-wrap: nowrap !important;\n  }\n\n  .flex-lg-wrap-reverse {\n    flex-wrap: wrap-reverse !important;\n  }\n\n  .gap-lg-0 {\n    gap: 0 !important;\n  }\n\n  .gap-lg-1 {\n    gap: 0.25rem !important;\n  }\n\n  .gap-lg-2 {\n    gap: 0.5rem !important;\n  }\n\n  .gap-lg-3 {\n    gap: 1rem !important;\n  }\n\n  .gap-lg-4 {\n    gap: 1.5rem !important;\n  }\n\n  .gap-lg-5 {\n    gap: 3rem !important;\n  }\n\n  .justify-content-lg-start {\n    justify-content: flex-start !important;\n  }\n\n  .justify-content-lg-end {\n    justify-content: flex-end !important;\n  }\n\n  .justify-content-lg-center {\n    justify-content: center !important;\n  }\n\n  .justify-content-lg-between {\n    justify-content: space-between !important;\n  }\n\n  .justify-content-lg-around {\n    justify-content: space-around !important;\n  }\n\n  .justify-content-lg-evenly {\n    justify-content: space-evenly !important;\n  }\n\n  .align-items-lg-start {\n    align-items: flex-start !important;\n  }\n\n  .align-items-lg-end {\n    align-items: flex-end !important;\n  }\n\n  .align-items-lg-center {\n    align-items: center !important;\n  }\n\n  .align-items-lg-baseline {\n    align-items: baseline !important;\n  }\n\n  .align-items-lg-stretch {\n    align-items: stretch !important;\n  }\n\n  .align-content-lg-start {\n    align-content: flex-start !important;\n  }\n\n  .align-content-lg-end {\n    align-content: flex-end !important;\n  }\n\n  .align-content-lg-center {\n    align-content: center !important;\n  }\n\n  .align-content-lg-between {\n    align-content: space-between !important;\n  }\n\n  .align-content-lg-around {\n    align-content: space-around !important;\n  }\n\n  .align-content-lg-stretch {\n    align-content: stretch !important;\n  }\n\n  .align-self-lg-auto {\n    align-self: auto !important;\n  }\n\n  .align-self-lg-start {\n    align-self: flex-start !important;\n  }\n\n  .align-self-lg-end {\n    align-self: flex-end !important;\n  }\n\n  .align-self-lg-center {\n    align-self: center !important;\n  }\n\n  .align-self-lg-baseline {\n    align-self: baseline !important;\n  }\n\n  .align-self-lg-stretch {\n    align-self: stretch !important;\n  }\n\n  .order-lg-first {\n    order: -1 !important;\n  }\n\n  .order-lg-0 {\n    order: 0 !important;\n  }\n\n  .order-lg-1 {\n    order: 1 !important;\n  }\n\n  .order-lg-2 {\n    order: 2 !important;\n  }\n\n  .order-lg-3 {\n    order: 3 !important;\n  }\n\n  .order-lg-4 {\n    order: 4 !important;\n  }\n\n  .order-lg-5 {\n    order: 5 !important;\n  }\n\n  .order-lg-last {\n    order: 6 !important;\n  }\n\n  .m-lg-0 {\n    margin: 0 !important;\n  }\n\n  .m-lg-1 {\n    margin: 0.25rem !important;\n  }\n\n  .m-lg-2 {\n    margin: 0.5rem !important;\n  }\n\n  .m-lg-3 {\n    margin: 1rem !important;\n  }\n\n  .m-lg-4 {\n    margin: 1.5rem !important;\n  }\n\n  .m-lg-5 {\n    margin: 3rem !important;\n  }\n\n  .m-lg-auto {\n    margin: auto !important;\n  }\n\n  .mx-lg-0 {\n    margin-right: 0 !important;\n    margin-left: 0 !important;\n  }\n\n  .mx-lg-1 {\n    margin-right: 0.25rem !important;\n    margin-left: 0.25rem !important;\n  }\n\n  .mx-lg-2 {\n    margin-right: 0.5rem !important;\n    margin-left: 0.5rem !important;\n  }\n\n  .mx-lg-3 {\n    margin-right: 1rem !important;\n    margin-left: 1rem !important;\n  }\n\n  .mx-lg-4 {\n    margin-right: 1.5rem !important;\n    margin-left: 1.5rem !important;\n  }\n\n  .mx-lg-5 {\n    margin-right: 3rem !important;\n    margin-left: 3rem !important;\n  }\n\n  .mx-lg-auto {\n    margin-right: auto !important;\n    margin-left: auto !important;\n  }\n\n  .my-lg-0 {\n    margin-top: 0 !important;\n    margin-bottom: 0 !important;\n  }\n\n  .my-lg-1 {\n    margin-top: 0.25rem !important;\n    margin-bottom: 0.25rem !important;\n  }\n\n  .my-lg-2 {\n    margin-top: 0.5rem !important;\n    margin-bottom: 0.5rem !important;\n  }\n\n  .my-lg-3 {\n    margin-top: 1rem !important;\n    margin-bottom: 1rem !important;\n  }\n\n  .my-lg-4 {\n    margin-top: 1.5rem !important;\n    margin-bottom: 1.5rem !important;\n  }\n\n  .my-lg-5 {\n    margin-top: 3rem !important;\n    margin-bottom: 3rem !important;\n  }\n\n  .my-lg-auto {\n    margin-top: auto !important;\n    margin-bottom: auto !important;\n  }\n\n  .mt-lg-0 {\n    margin-top: 0 !important;\n  }\n\n  .mt-lg-1 {\n    margin-top: 0.25rem !important;\n  }\n\n  .mt-lg-2 {\n    margin-top: 0.5rem !important;\n  }\n\n  .mt-lg-3 {\n    margin-top: 1rem !important;\n  }\n\n  .mt-lg-4 {\n    margin-top: 1.5rem !important;\n  }\n\n  .mt-lg-5 {\n    margin-top: 3rem !important;\n  }\n\n  .mt-lg-auto {\n    margin-top: auto !important;\n  }\n\n  .me-lg-0 {\n    margin-right: 0 !important;\n  }\n\n  .me-lg-1 {\n    margin-right: 0.25rem !important;\n  }\n\n  .me-lg-2 {\n    margin-right: 0.5rem !important;\n  }\n\n  .me-lg-3 {\n    margin-right: 1rem !important;\n  }\n\n  .me-lg-4 {\n    margin-right: 1.5rem !important;\n  }\n\n  .me-lg-5 {\n    margin-right: 3rem !important;\n  }\n\n  .me-lg-auto {\n    margin-right: auto !important;\n  }\n\n  .mb-lg-0 {\n    margin-bottom: 0 !important;\n  }\n\n  .mb-lg-1 {\n    margin-bottom: 0.25rem !important;\n  }\n\n  .mb-lg-2 {\n    margin-bottom: 0.5rem !important;\n  }\n\n  .mb-lg-3 {\n    margin-bottom: 1rem !important;\n  }\n\n  .mb-lg-4 {\n    margin-bottom: 1.5rem !important;\n  }\n\n  .mb-lg-5 {\n    margin-bottom: 3rem !important;\n  }\n\n  .mb-lg-auto {\n    margin-bottom: auto !important;\n  }\n\n  .ms-lg-0 {\n    margin-left: 0 !important;\n  }\n\n  .ms-lg-1 {\n    margin-left: 0.25rem !important;\n  }\n\n  .ms-lg-2 {\n    margin-left: 0.5rem !important;\n  }\n\n  .ms-lg-3 {\n    margin-left: 1rem !important;\n  }\n\n  .ms-lg-4 {\n    margin-left: 1.5rem !important;\n  }\n\n  .ms-lg-5 {\n    margin-left: 3rem !important;\n  }\n\n  .ms-lg-auto {\n    margin-left: auto !important;\n  }\n\n  .p-lg-0 {\n    padding: 0 !important;\n  }\n\n  .p-lg-1 {\n    padding: 0.25rem !important;\n  }\n\n  .p-lg-2 {\n    padding: 0.5rem !important;\n  }\n\n  .p-lg-3 {\n    padding: 1rem !important;\n  }\n\n  .p-lg-4 {\n    padding: 1.5rem !important;\n  }\n\n  .p-lg-5 {\n    padding: 3rem !important;\n  }\n\n  .px-lg-0 {\n    padding-right: 0 !important;\n    padding-left: 0 !important;\n  }\n\n  .px-lg-1 {\n    padding-right: 0.25rem !important;\n    padding-left: 0.25rem !important;\n  }\n\n  .px-lg-2 {\n    padding-right: 0.5rem !important;\n    padding-left: 0.5rem !important;\n  }\n\n  .px-lg-3 {\n    padding-right: 1rem !important;\n    padding-left: 1rem !important;\n  }\n\n  .px-lg-4 {\n    padding-right: 1.5rem !important;\n    padding-left: 1.5rem !important;\n  }\n\n  .px-lg-5 {\n    padding-right: 3rem !important;\n    padding-left: 3rem !important;\n  }\n\n  .py-lg-0 {\n    padding-top: 0 !important;\n    padding-bottom: 0 !important;\n  }\n\n  .py-lg-1 {\n    padding-top: 0.25rem !important;\n    padding-bottom: 0.25rem !important;\n  }\n\n  .py-lg-2 {\n    padding-top: 0.5rem !important;\n    padding-bottom: 0.5rem !important;\n  }\n\n  .py-lg-3 {\n    padding-top: 1rem !important;\n    padding-bottom: 1rem !important;\n  }\n\n  .py-lg-4 {\n    padding-top: 1.5rem !important;\n    padding-bottom: 1.5rem !important;\n  }\n\n  .py-lg-5 {\n    padding-top: 3rem !important;\n    padding-bottom: 3rem !important;\n  }\n\n  .pt-lg-0 {\n    padding-top: 0 !important;\n  }\n\n  .pt-lg-1 {\n    padding-top: 0.25rem !important;\n  }\n\n  .pt-lg-2 {\n    padding-top: 0.5rem !important;\n  }\n\n  .pt-lg-3 {\n    padding-top: 1rem !important;\n  }\n\n  .pt-lg-4 {\n    padding-top: 1.5rem !important;\n  }\n\n  .pt-lg-5 {\n    padding-top: 3rem !important;\n  }\n\n  .pe-lg-0 {\n    padding-right: 0 !important;\n  }\n\n  .pe-lg-1 {\n    padding-right: 0.25rem !important;\n  }\n\n  .pe-lg-2 {\n    padding-right: 0.5rem !important;\n  }\n\n  .pe-lg-3 {\n    padding-right: 1rem !important;\n  }\n\n  .pe-lg-4 {\n    padding-right: 1.5rem !important;\n  }\n\n  .pe-lg-5 {\n    padding-right: 3rem !important;\n  }\n\n  .pb-lg-0 {\n    padding-bottom: 0 !important;\n  }\n\n  .pb-lg-1 {\n    padding-bottom: 0.25rem !important;\n  }\n\n  .pb-lg-2 {\n    padding-bottom: 0.5rem !important;\n  }\n\n  .pb-lg-3 {\n    padding-bottom: 1rem !important;\n  }\n\n  .pb-lg-4 {\n    padding-bottom: 1.5rem !important;\n  }\n\n  .pb-lg-5 {\n    padding-bottom: 3rem !important;\n  }\n\n  .ps-lg-0 {\n    padding-left: 0 !important;\n  }\n\n  .ps-lg-1 {\n    padding-left: 0.25rem !important;\n  }\n\n  .ps-lg-2 {\n    padding-left: 0.5rem !important;\n  }\n\n  .ps-lg-3 {\n    padding-left: 1rem !important;\n  }\n\n  .ps-lg-4 {\n    padding-left: 1.5rem !important;\n  }\n\n  .ps-lg-5 {\n    padding-left: 3rem !important;\n  }\n\n  .text-lg-start {\n    text-align: left !important;\n  }\n\n  .text-lg-end {\n    text-align: right !important;\n  }\n\n  .text-lg-center {\n    text-align: center !important;\n  }\n}\n@media (min-width: 1200px) {\n  .float-xl-start {\n    float: left !important;\n  }\n\n  .float-xl-end {\n    float: right !important;\n  }\n\n  .float-xl-none {\n    float: none !important;\n  }\n\n  .d-xl-inline {\n    display: inline !important;\n  }\n\n  .d-xl-inline-block {\n    display: inline-block !important;\n  }\n\n  .d-xl-block {\n    display: block !important;\n  }\n\n  .d-xl-grid {\n    display: grid !important;\n  }\n\n  .d-xl-table {\n    display: table !important;\n  }\n\n  .d-xl-table-row {\n    display: table-row !important;\n  }\n\n  .d-xl-table-cell {\n    display: table-cell !important;\n  }\n\n  .d-xl-flex {\n    display: flex !important;\n  }\n\n  .d-xl-inline-flex {\n    display: inline-flex !important;\n  }\n\n  .d-xl-none {\n    display: none !important;\n  }\n\n  .flex-xl-fill {\n    flex: 1 1 auto !important;\n  }\n\n  .flex-xl-row {\n    flex-direction: row !important;\n  }\n\n  .flex-xl-column {\n    flex-direction: column !important;\n  }\n\n  .flex-xl-row-reverse {\n    flex-direction: row-reverse !important;\n  }\n\n  .flex-xl-column-reverse {\n    flex-direction: column-reverse !important;\n  }\n\n  .flex-xl-grow-0 {\n    flex-grow: 0 !important;\n  }\n\n  .flex-xl-grow-1 {\n    flex-grow: 1 !important;\n  }\n\n  .flex-xl-shrink-0 {\n    flex-shrink: 0 !important;\n  }\n\n  .flex-xl-shrink-1 {\n    flex-shrink: 1 !important;\n  }\n\n  .flex-xl-wrap {\n    flex-wrap: wrap !important;\n  }\n\n  .flex-xl-nowrap {\n    flex-wrap: nowrap !important;\n  }\n\n  .flex-xl-wrap-reverse {\n    flex-wrap: wrap-reverse !important;\n  }\n\n  .gap-xl-0 {\n    gap: 0 !important;\n  }\n\n  .gap-xl-1 {\n    gap: 0.25rem !important;\n  }\n\n  .gap-xl-2 {\n    gap: 0.5rem !important;\n  }\n\n  .gap-xl-3 {\n    gap: 1rem !important;\n  }\n\n  .gap-xl-4 {\n    gap: 1.5rem !important;\n  }\n\n  .gap-xl-5 {\n    gap: 3rem !important;\n  }\n\n  .justify-content-xl-start {\n    justify-content: flex-start !important;\n  }\n\n  .justify-content-xl-end {\n    justify-content: flex-end !important;\n  }\n\n  .justify-content-xl-center {\n    justify-content: center !important;\n  }\n\n  .justify-content-xl-between {\n    justify-content: space-between !important;\n  }\n\n  .justify-content-xl-around {\n    justify-content: space-around !important;\n  }\n\n  .justify-content-xl-evenly {\n    justify-content: space-evenly !important;\n  }\n\n  .align-items-xl-start {\n    align-items: flex-start !important;\n  }\n\n  .align-items-xl-end {\n    align-items: flex-end !important;\n  }\n\n  .align-items-xl-center {\n    align-items: center !important;\n  }\n\n  .align-items-xl-baseline {\n    align-items: baseline !important;\n  }\n\n  .align-items-xl-stretch {\n    align-items: stretch !important;\n  }\n\n  .align-content-xl-start {\n    align-content: flex-start !important;\n  }\n\n  .align-content-xl-end {\n    align-content: flex-end !important;\n  }\n\n  .align-content-xl-center {\n    align-content: center !important;\n  }\n\n  .align-content-xl-between {\n    align-content: space-between !important;\n  }\n\n  .align-content-xl-around {\n    align-content: space-around !important;\n  }\n\n  .align-content-xl-stretch {\n    align-content: stretch !important;\n  }\n\n  .align-self-xl-auto {\n    align-self: auto !important;\n  }\n\n  .align-self-xl-start {\n    align-self: flex-start !important;\n  }\n\n  .align-self-xl-end {\n    align-self: flex-end !important;\n  }\n\n  .align-self-xl-center {\n    align-self: center !important;\n  }\n\n  .align-self-xl-baseline {\n    align-self: baseline !important;\n  }\n\n  .align-self-xl-stretch {\n    align-self: stretch !important;\n  }\n\n  .order-xl-first {\n    order: -1 !important;\n  }\n\n  .order-xl-0 {\n    order: 0 !important;\n  }\n\n  .order-xl-1 {\n    order: 1 !important;\n  }\n\n  .order-xl-2 {\n    order: 2 !important;\n  }\n\n  .order-xl-3 {\n    order: 3 !important;\n  }\n\n  .order-xl-4 {\n    order: 4 !important;\n  }\n\n  .order-xl-5 {\n    order: 5 !important;\n  }\n\n  .order-xl-last {\n    order: 6 !important;\n  }\n\n  .m-xl-0 {\n    margin: 0 !important;\n  }\n\n  .m-xl-1 {\n    margin: 0.25rem !important;\n  }\n\n  .m-xl-2 {\n    margin: 0.5rem !important;\n  }\n\n  .m-xl-3 {\n    margin: 1rem !important;\n  }\n\n  .m-xl-4 {\n    margin: 1.5rem !important;\n  }\n\n  .m-xl-5 {\n    margin: 3rem !important;\n  }\n\n  .m-xl-auto {\n    margin: auto !important;\n  }\n\n  .mx-xl-0 {\n    margin-right: 0 !important;\n    margin-left: 0 !important;\n  }\n\n  .mx-xl-1 {\n    margin-right: 0.25rem !important;\n    margin-left: 0.25rem !important;\n  }\n\n  .mx-xl-2 {\n    margin-right: 0.5rem !important;\n    margin-left: 0.5rem !important;\n  }\n\n  .mx-xl-3 {\n    margin-right: 1rem !important;\n    margin-left: 1rem !important;\n  }\n\n  .mx-xl-4 {\n    margin-right: 1.5rem !important;\n    margin-left: 1.5rem !important;\n  }\n\n  .mx-xl-5 {\n    margin-right: 3rem !important;\n    margin-left: 3rem !important;\n  }\n\n  .mx-xl-auto {\n    margin-right: auto !important;\n    margin-left: auto !important;\n  }\n\n  .my-xl-0 {\n    margin-top: 0 !important;\n    margin-bottom: 0 !important;\n  }\n\n  .my-xl-1 {\n    margin-top: 0.25rem !important;\n    margin-bottom: 0.25rem !important;\n  }\n\n  .my-xl-2 {\n    margin-top: 0.5rem !important;\n    margin-bottom: 0.5rem !important;\n  }\n\n  .my-xl-3 {\n    margin-top: 1rem !important;\n    margin-bottom: 1rem !important;\n  }\n\n  .my-xl-4 {\n    margin-top: 1.5rem !important;\n    margin-bottom: 1.5rem !important;\n  }\n\n  .my-xl-5 {\n    margin-top: 3rem !important;\n    margin-bottom: 3rem !important;\n  }\n\n  .my-xl-auto {\n    margin-top: auto !important;\n    margin-bottom: auto !important;\n  }\n\n  .mt-xl-0 {\n    margin-top: 0 !important;\n  }\n\n  .mt-xl-1 {\n    margin-top: 0.25rem !important;\n  }\n\n  .mt-xl-2 {\n    margin-top: 0.5rem !important;\n  }\n\n  .mt-xl-3 {\n    margin-top: 1rem !important;\n  }\n\n  .mt-xl-4 {\n    margin-top: 1.5rem !important;\n  }\n\n  .mt-xl-5 {\n    margin-top: 3rem !important;\n  }\n\n  .mt-xl-auto {\n    margin-top: auto !important;\n  }\n\n  .me-xl-0 {\n    margin-right: 0 !important;\n  }\n\n  .me-xl-1 {\n    margin-right: 0.25rem !important;\n  }\n\n  .me-xl-2 {\n    margin-right: 0.5rem !important;\n  }\n\n  .me-xl-3 {\n    margin-right: 1rem !important;\n  }\n\n  .me-xl-4 {\n    margin-right: 1.5rem !important;\n  }\n\n  .me-xl-5 {\n    margin-right: 3rem !important;\n  }\n\n  .me-xl-auto {\n    margin-right: auto !important;\n  }\n\n  .mb-xl-0 {\n    margin-bottom: 0 !important;\n  }\n\n  .mb-xl-1 {\n    margin-bottom: 0.25rem !important;\n  }\n\n  .mb-xl-2 {\n    margin-bottom: 0.5rem !important;\n  }\n\n  .mb-xl-3 {\n    margin-bottom: 1rem !important;\n  }\n\n  .mb-xl-4 {\n    margin-bottom: 1.5rem !important;\n  }\n\n  .mb-xl-5 {\n    margin-bottom: 3rem !important;\n  }\n\n  .mb-xl-auto {\n    margin-bottom: auto !important;\n  }\n\n  .ms-xl-0 {\n    margin-left: 0 !important;\n  }\n\n  .ms-xl-1 {\n    margin-left: 0.25rem !important;\n  }\n\n  .ms-xl-2 {\n    margin-left: 0.5rem !important;\n  }\n\n  .ms-xl-3 {\n    margin-left: 1rem !important;\n  }\n\n  .ms-xl-4 {\n    margin-left: 1.5rem !important;\n  }\n\n  .ms-xl-5 {\n    margin-left: 3rem !important;\n  }\n\n  .ms-xl-auto {\n    margin-left: auto !important;\n  }\n\n  .p-xl-0 {\n    padding: 0 !important;\n  }\n\n  .p-xl-1 {\n    padding: 0.25rem !important;\n  }\n\n  .p-xl-2 {\n    padding: 0.5rem !important;\n  }\n\n  .p-xl-3 {\n    padding: 1rem !important;\n  }\n\n  .p-xl-4 {\n    padding: 1.5rem !important;\n  }\n\n  .p-xl-5 {\n    padding: 3rem !important;\n  }\n\n  .px-xl-0 {\n    padding-right: 0 !important;\n    padding-left: 0 !important;\n  }\n\n  .px-xl-1 {\n    padding-right: 0.25rem !important;\n    padding-left: 0.25rem !important;\n  }\n\n  .px-xl-2 {\n    padding-right: 0.5rem !important;\n    padding-left: 0.5rem !important;\n  }\n\n  .px-xl-3 {\n    padding-right: 1rem !important;\n    padding-left: 1rem !important;\n  }\n\n  .px-xl-4 {\n    padding-right: 1.5rem !important;\n    padding-left: 1.5rem !important;\n  }\n\n  .px-xl-5 {\n    padding-right: 3rem !important;\n    padding-left: 3rem !important;\n  }\n\n  .py-xl-0 {\n    padding-top: 0 !important;\n    padding-bottom: 0 !important;\n  }\n\n  .py-xl-1 {\n    padding-top: 0.25rem !important;\n    padding-bottom: 0.25rem !important;\n  }\n\n  .py-xl-2 {\n    padding-top: 0.5rem !important;\n    padding-bottom: 0.5rem !important;\n  }\n\n  .py-xl-3 {\n    padding-top: 1rem !important;\n    padding-bottom: 1rem !important;\n  }\n\n  .py-xl-4 {\n    padding-top: 1.5rem !important;\n    padding-bottom: 1.5rem !important;\n  }\n\n  .py-xl-5 {\n    padding-top: 3rem !important;\n    padding-bottom: 3rem !important;\n  }\n\n  .pt-xl-0 {\n    padding-top: 0 !important;\n  }\n\n  .pt-xl-1 {\n    padding-top: 0.25rem !important;\n  }\n\n  .pt-xl-2 {\n    padding-top: 0.5rem !important;\n  }\n\n  .pt-xl-3 {\n    padding-top: 1rem !important;\n  }\n\n  .pt-xl-4 {\n    padding-top: 1.5rem !important;\n  }\n\n  .pt-xl-5 {\n    padding-top: 3rem !important;\n  }\n\n  .pe-xl-0 {\n    padding-right: 0 !important;\n  }\n\n  .pe-xl-1 {\n    padding-right: 0.25rem !important;\n  }\n\n  .pe-xl-2 {\n    padding-right: 0.5rem !important;\n  }\n\n  .pe-xl-3 {\n    padding-right: 1rem !important;\n  }\n\n  .pe-xl-4 {\n    padding-right: 1.5rem !important;\n  }\n\n  .pe-xl-5 {\n    padding-right: 3rem !important;\n  }\n\n  .pb-xl-0 {\n    padding-bottom: 0 !important;\n  }\n\n  .pb-xl-1 {\n    padding-bottom: 0.25rem !important;\n  }\n\n  .pb-xl-2 {\n    padding-bottom: 0.5rem !important;\n  }\n\n  .pb-xl-3 {\n    padding-bottom: 1rem !important;\n  }\n\n  .pb-xl-4 {\n    padding-bottom: 1.5rem !important;\n  }\n\n  .pb-xl-5 {\n    padding-bottom: 3rem !important;\n  }\n\n  .ps-xl-0 {\n    padding-left: 0 !important;\n  }\n\n  .ps-xl-1 {\n    padding-left: 0.25rem !important;\n  }\n\n  .ps-xl-2 {\n    padding-left: 0.5rem !important;\n  }\n\n  .ps-xl-3 {\n    padding-left: 1rem !important;\n  }\n\n  .ps-xl-4 {\n    padding-left: 1.5rem !important;\n  }\n\n  .ps-xl-5 {\n    padding-left: 3rem !important;\n  }\n\n  .text-xl-start {\n    text-align: left !important;\n  }\n\n  .text-xl-end {\n    text-align: right !important;\n  }\n\n  .text-xl-center {\n    text-align: center !important;\n  }\n}\n@media (min-width: 1400px) {\n  .float-xxl-start {\n    float: left !important;\n  }\n\n  .float-xxl-end {\n    float: right !important;\n  }\n\n  .float-xxl-none {\n    float: none !important;\n  }\n\n  .d-xxl-inline {\n    display: inline !important;\n  }\n\n  .d-xxl-inline-block {\n    display: inline-block !important;\n  }\n\n  .d-xxl-block {\n    display: block !important;\n  }\n\n  .d-xxl-grid {\n    display: grid !important;\n  }\n\n  .d-xxl-table {\n    display: table !important;\n  }\n\n  .d-xxl-table-row {\n    display: table-row !important;\n  }\n\n  .d-xxl-table-cell {\n    display: table-cell !important;\n  }\n\n  .d-xxl-flex {\n    display: flex !important;\n  }\n\n  .d-xxl-inline-flex {\n    display: inline-flex !important;\n  }\n\n  .d-xxl-none {\n    display: none !important;\n  }\n\n  .flex-xxl-fill {\n    flex: 1 1 auto !important;\n  }\n\n  .flex-xxl-row {\n    flex-direction: row !important;\n  }\n\n  .flex-xxl-column {\n    flex-direction: column !important;\n  }\n\n  .flex-xxl-row-reverse {\n    flex-direction: row-reverse !important;\n  }\n\n  .flex-xxl-column-reverse {\n    flex-direction: column-reverse !important;\n  }\n\n  .flex-xxl-grow-0 {\n    flex-grow: 0 !important;\n  }\n\n  .flex-xxl-grow-1 {\n    flex-grow: 1 !important;\n  }\n\n  .flex-xxl-shrink-0 {\n    flex-shrink: 0 !important;\n  }\n\n  .flex-xxl-shrink-1 {\n    flex-shrink: 1 !important;\n  }\n\n  .flex-xxl-wrap {\n    flex-wrap: wrap !important;\n  }\n\n  .flex-xxl-nowrap {\n    flex-wrap: nowrap !important;\n  }\n\n  .flex-xxl-wrap-reverse {\n    flex-wrap: wrap-reverse !important;\n  }\n\n  .gap-xxl-0 {\n    gap: 0 !important;\n  }\n\n  .gap-xxl-1 {\n    gap: 0.25rem !important;\n  }\n\n  .gap-xxl-2 {\n    gap: 0.5rem !important;\n  }\n\n  .gap-xxl-3 {\n    gap: 1rem !important;\n  }\n\n  .gap-xxl-4 {\n    gap: 1.5rem !important;\n  }\n\n  .gap-xxl-5 {\n    gap: 3rem !important;\n  }\n\n  .justify-content-xxl-start {\n    justify-content: flex-start !important;\n  }\n\n  .justify-content-xxl-end {\n    justify-content: flex-end !important;\n  }\n\n  .justify-content-xxl-center {\n    justify-content: center !important;\n  }\n\n  .justify-content-xxl-between {\n    justify-content: space-between !important;\n  }\n\n  .justify-content-xxl-around {\n    justify-content: space-around !important;\n  }\n\n  .justify-content-xxl-evenly {\n    justify-content: space-evenly !important;\n  }\n\n  .align-items-xxl-start {\n    align-items: flex-start !important;\n  }\n\n  .align-items-xxl-end {\n    align-items: flex-end !important;\n  }\n\n  .align-items-xxl-center {\n    align-items: center !important;\n  }\n\n  .align-items-xxl-baseline {\n    align-items: baseline !important;\n  }\n\n  .align-items-xxl-stretch {\n    align-items: stretch !important;\n  }\n\n  .align-content-xxl-start {\n    align-content: flex-start !important;\n  }\n\n  .align-content-xxl-end {\n    align-content: flex-end !important;\n  }\n\n  .align-content-xxl-center {\n    align-content: center !important;\n  }\n\n  .align-content-xxl-between {\n    align-content: space-between !important;\n  }\n\n  .align-content-xxl-around {\n    align-content: space-around !important;\n  }\n\n  .align-content-xxl-stretch {\n    align-content: stretch !important;\n  }\n\n  .align-self-xxl-auto {\n    align-self: auto !important;\n  }\n\n  .align-self-xxl-start {\n    align-self: flex-start !important;\n  }\n\n  .align-self-xxl-end {\n    align-self: flex-end !important;\n  }\n\n  .align-self-xxl-center {\n    align-self: center !important;\n  }\n\n  .align-self-xxl-baseline {\n    align-self: baseline !important;\n  }\n\n  .align-self-xxl-stretch {\n    align-self: stretch !important;\n  }\n\n  .order-xxl-first {\n    order: -1 !important;\n  }\n\n  .order-xxl-0 {\n    order: 0 !important;\n  }\n\n  .order-xxl-1 {\n    order: 1 !important;\n  }\n\n  .order-xxl-2 {\n    order: 2 !important;\n  }\n\n  .order-xxl-3 {\n    order: 3 !important;\n  }\n\n  .order-xxl-4 {\n    order: 4 !important;\n  }\n\n  .order-xxl-5 {\n    order: 5 !important;\n  }\n\n  .order-xxl-last {\n    order: 6 !important;\n  }\n\n  .m-xxl-0 {\n    margin: 0 !important;\n  }\n\n  .m-xxl-1 {\n    margin: 0.25rem !important;\n  }\n\n  .m-xxl-2 {\n    margin: 0.5rem !important;\n  }\n\n  .m-xxl-3 {\n    margin: 1rem !important;\n  }\n\n  .m-xxl-4 {\n    margin: 1.5rem !important;\n  }\n\n  .m-xxl-5 {\n    margin: 3rem !important;\n  }\n\n  .m-xxl-auto {\n    margin: auto !important;\n  }\n\n  .mx-xxl-0 {\n    margin-right: 0 !important;\n    margin-left: 0 !important;\n  }\n\n  .mx-xxl-1 {\n    margin-right: 0.25rem !important;\n    margin-left: 0.25rem !important;\n  }\n\n  .mx-xxl-2 {\n    margin-right: 0.5rem !important;\n    margin-left: 0.5rem !important;\n  }\n\n  .mx-xxl-3 {\n    margin-right: 1rem !important;\n    margin-left: 1rem !important;\n  }\n\n  .mx-xxl-4 {\n    margin-right: 1.5rem !important;\n    margin-left: 1.5rem !important;\n  }\n\n  .mx-xxl-5 {\n    margin-right: 3rem !important;\n    margin-left: 3rem !important;\n  }\n\n  .mx-xxl-auto {\n    margin-right: auto !important;\n    margin-left: auto !important;\n  }\n\n  .my-xxl-0 {\n    margin-top: 0 !important;\n    margin-bottom: 0 !important;\n  }\n\n  .my-xxl-1 {\n    margin-top: 0.25rem !important;\n    margin-bottom: 0.25rem !important;\n  }\n\n  .my-xxl-2 {\n    margin-top: 0.5rem !important;\n    margin-bottom: 0.5rem !important;\n  }\n\n  .my-xxl-3 {\n    margin-top: 1rem !important;\n    margin-bottom: 1rem !important;\n  }\n\n  .my-xxl-4 {\n    margin-top: 1.5rem !important;\n    margin-bottom: 1.5rem !important;\n  }\n\n  .my-xxl-5 {\n    margin-top: 3rem !important;\n    margin-bottom: 3rem !important;\n  }\n\n  .my-xxl-auto {\n    margin-top: auto !important;\n    margin-bottom: auto !important;\n  }\n\n  .mt-xxl-0 {\n    margin-top: 0 !important;\n  }\n\n  .mt-xxl-1 {\n    margin-top: 0.25rem !important;\n  }\n\n  .mt-xxl-2 {\n    margin-top: 0.5rem !important;\n  }\n\n  .mt-xxl-3 {\n    margin-top: 1rem !important;\n  }\n\n  .mt-xxl-4 {\n    margin-top: 1.5rem !important;\n  }\n\n  .mt-xxl-5 {\n    margin-top: 3rem !important;\n  }\n\n  .mt-xxl-auto {\n    margin-top: auto !important;\n  }\n\n  .me-xxl-0 {\n    margin-right: 0 !important;\n  }\n\n  .me-xxl-1 {\n    margin-right: 0.25rem !important;\n  }\n\n  .me-xxl-2 {\n    margin-right: 0.5rem !important;\n  }\n\n  .me-xxl-3 {\n    margin-right: 1rem !important;\n  }\n\n  .me-xxl-4 {\n    margin-right: 1.5rem !important;\n  }\n\n  .me-xxl-5 {\n    margin-right: 3rem !important;\n  }\n\n  .me-xxl-auto {\n    margin-right: auto !important;\n  }\n\n  .mb-xxl-0 {\n    margin-bottom: 0 !important;\n  }\n\n  .mb-xxl-1 {\n    margin-bottom: 0.25rem !important;\n  }\n\n  .mb-xxl-2 {\n    margin-bottom: 0.5rem !important;\n  }\n\n  .mb-xxl-3 {\n    margin-bottom: 1rem !important;\n  }\n\n  .mb-xxl-4 {\n    margin-bottom: 1.5rem !important;\n  }\n\n  .mb-xxl-5 {\n    margin-bottom: 3rem !important;\n  }\n\n  .mb-xxl-auto {\n    margin-bottom: auto !important;\n  }\n\n  .ms-xxl-0 {\n    margin-left: 0 !important;\n  }\n\n  .ms-xxl-1 {\n    margin-left: 0.25rem !important;\n  }\n\n  .ms-xxl-2 {\n    margin-left: 0.5rem !important;\n  }\n\n  .ms-xxl-3 {\n    margin-left: 1rem !important;\n  }\n\n  .ms-xxl-4 {\n    margin-left: 1.5rem !important;\n  }\n\n  .ms-xxl-5 {\n    margin-left: 3rem !important;\n  }\n\n  .ms-xxl-auto {\n    margin-left: auto !important;\n  }\n\n  .p-xxl-0 {\n    padding: 0 !important;\n  }\n\n  .p-xxl-1 {\n    padding: 0.25rem !important;\n  }\n\n  .p-xxl-2 {\n    padding: 0.5rem !important;\n  }\n\n  .p-xxl-3 {\n    padding: 1rem !important;\n  }\n\n  .p-xxl-4 {\n    padding: 1.5rem !important;\n  }\n\n  .p-xxl-5 {\n    padding: 3rem !important;\n  }\n\n  .px-xxl-0 {\n    padding-right: 0 !important;\n    padding-left: 0 !important;\n  }\n\n  .px-xxl-1 {\n    padding-right: 0.25rem !important;\n    padding-left: 0.25rem !important;\n  }\n\n  .px-xxl-2 {\n    padding-right: 0.5rem !important;\n    padding-left: 0.5rem !important;\n  }\n\n  .px-xxl-3 {\n    padding-right: 1rem !important;\n    padding-left: 1rem !important;\n  }\n\n  .px-xxl-4 {\n    padding-right: 1.5rem !important;\n    padding-left: 1.5rem !important;\n  }\n\n  .px-xxl-5 {\n    padding-right: 3rem !important;\n    padding-left: 3rem !important;\n  }\n\n  .py-xxl-0 {\n    padding-top: 0 !important;\n    padding-bottom: 0 !important;\n  }\n\n  .py-xxl-1 {\n    padding-top: 0.25rem !important;\n    padding-bottom: 0.25rem !important;\n  }\n\n  .py-xxl-2 {\n    padding-top: 0.5rem !important;\n    padding-bottom: 0.5rem !important;\n  }\n\n  .py-xxl-3 {\n    padding-top: 1rem !important;\n    padding-bottom: 1rem !important;\n  }\n\n  .py-xxl-4 {\n    padding-top: 1.5rem !important;\n    padding-bottom: 1.5rem !important;\n  }\n\n  .py-xxl-5 {\n    padding-top: 3rem !important;\n    padding-bottom: 3rem !important;\n  }\n\n  .pt-xxl-0 {\n    padding-top: 0 !important;\n  }\n\n  .pt-xxl-1 {\n    padding-top: 0.25rem !important;\n  }\n\n  .pt-xxl-2 {\n    padding-top: 0.5rem !important;\n  }\n\n  .pt-xxl-3 {\n    padding-top: 1rem !important;\n  }\n\n  .pt-xxl-4 {\n    padding-top: 1.5rem !important;\n  }\n\n  .pt-xxl-5 {\n    padding-top: 3rem !important;\n  }\n\n  .pe-xxl-0 {\n    padding-right: 0 !important;\n  }\n\n  .pe-xxl-1 {\n    padding-right: 0.25rem !important;\n  }\n\n  .pe-xxl-2 {\n    padding-right: 0.5rem !important;\n  }\n\n  .pe-xxl-3 {\n    padding-right: 1rem !important;\n  }\n\n  .pe-xxl-4 {\n    padding-right: 1.5rem !important;\n  }\n\n  .pe-xxl-5 {\n    padding-right: 3rem !important;\n  }\n\n  .pb-xxl-0 {\n    padding-bottom: 0 !important;\n  }\n\n  .pb-xxl-1 {\n    padding-bottom: 0.25rem !important;\n  }\n\n  .pb-xxl-2 {\n    padding-bottom: 0.5rem !important;\n  }\n\n  .pb-xxl-3 {\n    padding-bottom: 1rem !important;\n  }\n\n  .pb-xxl-4 {\n    padding-bottom: 1.5rem !important;\n  }\n\n  .pb-xxl-5 {\n    padding-bottom: 3rem !important;\n  }\n\n  .ps-xxl-0 {\n    padding-left: 0 !important;\n  }\n\n  .ps-xxl-1 {\n    padding-left: 0.25rem !important;\n  }\n\n  .ps-xxl-2 {\n    padding-left: 0.5rem !important;\n  }\n\n  .ps-xxl-3 {\n    padding-left: 1rem !important;\n  }\n\n  .ps-xxl-4 {\n    padding-left: 1.5rem !important;\n  }\n\n  .ps-xxl-5 {\n    padding-left: 3rem !important;\n  }\n\n  .text-xxl-start {\n    text-align: left !important;\n  }\n\n  .text-xxl-end {\n    text-align: right !important;\n  }\n\n  .text-xxl-center {\n    text-align: center !important;\n  }\n}\n@media (min-width: 1200px) {\n  .fs-1 {\n    font-size: 2.5rem !important;\n  }\n\n  .fs-2 {\n    font-size: 2rem !important;\n  }\n\n  .fs-3 {\n    font-size: 1.75rem !important;\n  }\n\n  .fs-4 {\n    font-size: 1.5rem !important;\n  }\n}\n@media print {\n  .d-print-inline {\n    display: inline !important;\n  }\n\n  .d-print-inline-block {\n    display: inline-block !important;\n  }\n\n  .d-print-block {\n    display: block !important;\n  }\n\n  .d-print-grid {\n    display: grid !important;\n  }\n\n  .d-print-table {\n    display: table !important;\n  }\n\n  .d-print-table-row {\n    display: table-row !important;\n  }\n\n  .d-print-table-cell {\n    display: table-cell !important;\n  }\n\n  .d-print-flex {\n    display: flex !important;\n  }\n\n  .d-print-inline-flex {\n    display: inline-flex !important;\n  }\n\n  .d-print-none {\n    display: none !important;\n  }\n}\n\n/*# sourceMappingURL=bootstrap.css.map */","// stylelint-disable property-blacklist, scss/dollar-variable-default\n\n// SCSS RFS mixin\n//\n// Automated responsive values for font sizes, paddings, margins and much more\n//\n// Licensed under MIT (https://github.com/twbs/rfs/blob/main/LICENSE)\n\n// Configuration\n\n// Base value\n$rfs-base-value: 1.25rem !default;\n$rfs-unit: rem !default;\n\n@if $rfs-unit != rem and $rfs-unit != px {\n  @error \"`#{$rfs-unit}` is not a valid unit for $rfs-unit. Use `px` or `rem`.\";\n}\n\n// Breakpoint at where values start decreasing if screen width is smaller\n$rfs-breakpoint: 1200px !default;\n$rfs-breakpoint-unit: px !default;\n\n@if $rfs-breakpoint-unit != px and $rfs-breakpoint-unit != em and $rfs-breakpoint-unit != rem {\n  @error \"`#{$rfs-breakpoint-unit}` is not a valid unit for $rfs-breakpoint-unit. Use `px`, `em` or `rem`.\";\n}\n\n// Resize values based on screen height and width\n$rfs-two-dimensional: false !default;\n\n// Factor of decrease\n$rfs-factor: 10 !default;\n\n@if type-of($rfs-factor) != number or $rfs-factor <= 1 {\n  @error \"`#{$rfs-factor}` is not a valid  $rfs-factor, it must be greater than 1.\";\n}\n\n// Mode. Possibilities: \"min-media-query\", \"max-media-query\"\n$rfs-mode: min-media-query !default;\n\n// Generate enable or disable classes. Possibilities: false, \"enable\" or \"disable\"\n$rfs-class: false !default;\n\n// 1 rem = $rfs-rem-value px\n$rfs-rem-value: 16 !default;\n\n// Safari iframe resize bug: https://github.com/twbs/rfs/issues/14\n$rfs-safari-iframe-resize-bug-fix: false !default;\n\n// Disable RFS by setting $enable-rfs to false\n$enable-rfs: true !default;\n\n// Cache $rfs-base-value unit\n$rfs-base-value-unit: unit($rfs-base-value);\n\n@function divide($dividend, $divisor, $precision: 10) {\n  $sign: if($dividend > 0 and $divisor > 0 or $dividend < 0 and $divisor < 0, 1, -1);\n  $dividend: abs($dividend);\n  $divisor: abs($divisor);\n  @if $dividend == 0 {\n    @return 0;\n  }\n  @if $divisor == 0 {\n    @error \"Cannot divide by 0\";\n  }\n  $remainder: $dividend;\n  $result: 0;\n  $factor: 10;\n  @while ($remainder > 0 and $precision >= 0) {\n    $quotient: 0;\n    @while ($remainder >= $divisor) {\n      $remainder: $remainder - $divisor;\n      $quotient: $quotient + 1;\n    }\n    $result: $result * 10 + $quotient;\n    $factor: $factor * .1;\n    $remainder: $remainder * 10;\n    $precision: $precision - 1;\n    @if ($precision < 0 and $remainder >= $divisor * 5) {\n      $result: $result + 1;\n    }\n  }\n  $result: $result * $factor * $sign;\n  $dividend-unit: unit($dividend);\n  $divisor-unit: unit($divisor);\n  $unit-map: (\n    \"px\": 1px,\n    \"rem\": 1rem,\n    \"em\": 1em,\n    \"%\": 1%\n  );\n  @if ($dividend-unit != $divisor-unit and map-has-key($unit-map, $dividend-unit)) {\n    $result: $result * map-get($unit-map, $dividend-unit);\n  }\n  @return $result;\n}\n\n// Remove px-unit from $rfs-base-value for calculations\n@if $rfs-base-value-unit == px {\n  $rfs-base-value: divide($rfs-base-value, $rfs-base-value * 0 + 1);\n}\n@else if $rfs-base-value-unit == rem {\n  $rfs-base-value: divide($rfs-base-value, divide($rfs-base-value * 0 + 1, $rfs-rem-value));\n}\n\n// Cache $rfs-breakpoint unit to prevent multiple calls\n$rfs-breakpoint-unit-cache: unit($rfs-breakpoint);\n\n// Remove unit from $rfs-breakpoint for calculations\n@if $rfs-breakpoint-unit-cache == px {\n  $rfs-breakpoint: divide($rfs-breakpoint, $rfs-breakpoint * 0 + 1);\n}\n@else if $rfs-breakpoint-unit-cache == rem or $rfs-breakpoint-unit-cache == \"em\" {\n  $rfs-breakpoint: divide($rfs-breakpoint, divide($rfs-breakpoint * 0 + 1, $rfs-rem-value));\n}\n\n// Calculate the media query value\n$rfs-mq-value: if($rfs-breakpoint-unit == px, #{$rfs-breakpoint}px, #{divide($rfs-breakpoint, $rfs-rem-value)}#{$rfs-breakpoint-unit});\n$rfs-mq-property-width: if($rfs-mode == max-media-query, max-width, min-width);\n$rfs-mq-property-height: if($rfs-mode == max-media-query, max-height, min-height);\n\n// Internal mixin used to determine which media query needs to be used\n@mixin _rfs-media-query {\n  @if $rfs-two-dimensional {\n    @if $rfs-mode == max-media-query {\n      @media (#{$rfs-mq-property-width}: #{$rfs-mq-value}), (#{$rfs-mq-property-height}: #{$rfs-mq-value}) {\n        @content;\n      }\n    }\n    @else {\n      @media (#{$rfs-mq-property-width}: #{$rfs-mq-value}) and (#{$rfs-mq-property-height}: #{$rfs-mq-value}) {\n        @content;\n      }\n    }\n  }\n  @else {\n    @media (#{$rfs-mq-property-width}: #{$rfs-mq-value}) {\n      @content;\n    }\n  }\n}\n\n// Internal mixin that adds disable classes to the selector if needed.\n@mixin _rfs-rule {\n  @if $rfs-class == disable and $rfs-mode == max-media-query {\n    // Adding an extra class increases specificity, which prevents the media query to override the property\n    &,\n    .disable-rfs &,\n    &.disable-rfs {\n      @content;\n    }\n  }\n  @else if $rfs-class == enable and $rfs-mode == min-media-query {\n    .enable-rfs &,\n    &.enable-rfs {\n      @content;\n    }\n  }\n  @else {\n    @content;\n  }\n}\n\n// Internal mixin that adds enable classes to the selector if needed.\n@mixin _rfs-media-query-rule {\n\n  @if $rfs-class == enable {\n    @if $rfs-mode == min-media-query {\n      @content;\n    }\n\n    @include _rfs-media-query {\n      .enable-rfs &,\n      &.enable-rfs {\n        @content;\n      }\n    }\n  }\n  @else {\n    @if $rfs-class == disable and $rfs-mode == min-media-query {\n      .disable-rfs &,\n      &.disable-rfs {\n        @content;\n      }\n    }\n    @include _rfs-media-query {\n      @content;\n    }\n  }\n}\n\n// Helper function to get the formatted non-responsive value\n@function rfs-value($values) {\n  // Convert to list\n  $values: if(type-of($values) != list, ($values,), $values);\n\n  $val: '';\n\n  // Loop over each value and calculate value\n  @each $value in $values {\n    @if $value == 0 {\n      $val: $val + ' 0';\n    }\n    @else {\n      // Cache $value unit\n      $unit: if(type-of($value) == \"number\", unit($value), false);\n\n      @if $unit == px {\n        // Convert to rem if needed\n        $val: $val + ' ' + if($rfs-unit == rem, #{divide($value, $value * 0 + $rfs-rem-value)}rem, $value);\n      }\n      @else if $unit == rem {\n        // Convert to px if needed\n        $val: $val + ' ' + if($rfs-unit == px, #{divide($value, $value * 0 + 1) * $rfs-rem-value}px, $value);\n      }\n      @else {\n        // If $value isn't a number (like inherit) or $value has a unit (not px or rem, like 1.5em) or $ is 0, just print the value\n        $val: $val + ' ' + $value;\n      }\n    }\n  }\n\n  // Remove first space\n  @return unquote(str-slice($val, 2));\n}\n\n// Helper function to get the responsive value calculated by RFS\n@function rfs-fluid-value($values) {\n  // Convert to list\n  $values: if(type-of($values) != list, ($values,), $values);\n\n  $val: '';\n\n  // Loop over each value and calculate value\n  @each $value in $values {\n    @if $value == 0 {\n      $val: $val + ' 0';\n    }\n\n    @else {\n      // Cache $value unit\n      $unit: if(type-of($value) == \"number\", unit($value), false);\n\n      // If $value isn't a number (like inherit) or $value has a unit (not px or rem, like 1.5em) or $ is 0, just print the value\n      @if not $unit or $unit != px and $unit != rem {\n        $val: $val + ' ' + $value;\n      }\n\n      @else {\n        // Remove unit from $value for calculations\n        $value: divide($value, $value * 0 + if($unit == px, 1, divide(1, $rfs-rem-value)));\n\n        // Only add the media query if the value is greater than the minimum value\n        @if abs($value) <= $rfs-base-value or not $enable-rfs {\n          $val: $val + ' ' +  if($rfs-unit == rem, #{divide($value, $rfs-rem-value)}rem, #{$value}px);\n        }\n        @else {\n          // Calculate the minimum value\n          $value-min: $rfs-base-value + divide(abs($value) - $rfs-base-value, $rfs-factor);\n\n          // Calculate difference between $value and the minimum value\n          $value-diff: abs($value) - $value-min;\n\n          // Base value formatting\n          $min-width: if($rfs-unit == rem, #{divide($value-min, $rfs-rem-value)}rem, #{$value-min}px);\n\n          // Use negative value if needed\n          $min-width: if($value < 0, -$min-width, $min-width);\n\n          // Use `vmin` if two-dimensional is enabled\n          $variable-unit: if($rfs-two-dimensional, vmin, vw);\n\n          // Calculate the variable width between 0 and $rfs-breakpoint\n          $variable-width: #{divide($value-diff * 100, $rfs-breakpoint)}#{$variable-unit};\n\n          // Return the calculated value\n          $val: $val + ' calc(' + $min-width + if($value < 0, ' - ', ' + ') + $variable-width + ')';\n        }\n      }\n    }\n  }\n\n  // Remove first space\n  @return unquote(str-slice($val, 2));\n}\n\n// RFS mixin\n@mixin rfs($values, $property: font-size) {\n  @if $values != null {\n    $val: rfs-value($values);\n    $fluidVal: rfs-fluid-value($values);\n\n    // Do not print the media query if responsive & non-responsive values are the same\n    @if $val == $fluidVal {\n      #{$property}: $val;\n    }\n    @else {\n      @include _rfs-rule {\n        #{$property}: if($rfs-mode == max-media-query, $val, $fluidVal);\n\n        // Include safari iframe resize fix if needed\n        min-width: if($rfs-safari-iframe-resize-bug-fix, (0 * 1vw), null);\n      }\n\n      @include _rfs-media-query-rule {\n        #{$property}: if($rfs-mode == max-media-query, $fluidVal, $val);\n      }\n    }\n  }\n}\n\n// Shorthand helper mixins\n@mixin font-size($value) {\n  @include rfs($value);\n}\n\n@mixin padding($value) {\n  @include rfs($value, padding);\n}\n\n@mixin padding-top($value) {\n  @include rfs($value, padding-top);\n}\n\n@mixin padding-right($value) {\n  @include rfs($value, padding-right);\n}\n\n@mixin padding-bottom($value) {\n  @include rfs($value, padding-bottom);\n}\n\n@mixin padding-left($value) {\n  @include rfs($value, padding-left);\n}\n\n@mixin margin($value) {\n  @include rfs($value, margin);\n}\n\n@mixin margin-top($value) {\n  @include rfs($value, margin-top);\n}\n\n@mixin margin-right($value) {\n  @include rfs($value, margin-right);\n}\n\n@mixin margin-bottom($value) {\n  @include rfs($value, margin-bottom);\n}\n\n@mixin margin-left($value) {\n  @include rfs($value, margin-left);\n}\n","// stylelint-disable property-disallowed-list\n// Single side border-radius\n\n// Helper function to replace negative values with 0\n@function valid-radius($radius) {\n  $return: ();\n  @each $value in $radius {\n    @if type-of($value) == number {\n      $return: append($return, max($value, 0));\n    } @else {\n      $return: append($return, $value);\n    }\n  }\n  @return $return;\n}\n\n// scss-docs-start border-radius-mixins\n@mixin border-radius($radius: $border-radius, $fallback-border-radius: false) {\n  @if $enable-rounded {\n    border-radius: valid-radius($radius);\n  }\n  @else if $fallback-border-radius != false {\n    border-radius: $fallback-border-radius;\n  }\n}\n\n@mixin border-top-radius($radius: $border-radius) {\n  @if $enable-rounded {\n    border-top-left-radius: valid-radius($radius);\n    border-top-right-radius: valid-radius($radius);\n  }\n}\n\n@mixin border-end-radius($radius: $border-radius) {\n  @if $enable-rounded {\n    border-top-right-radius: valid-radius($radius);\n    border-bottom-right-radius: valid-radius($radius);\n  }\n}\n\n@mixin border-bottom-radius($radius: $border-radius) {\n  @if $enable-rounded {\n    border-bottom-right-radius: valid-radius($radius);\n    border-bottom-left-radius: valid-radius($radius);\n  }\n}\n\n@mixin border-start-radius($radius: $border-radius) {\n  @if $enable-rounded {\n    border-top-left-radius: valid-radius($radius);\n    border-bottom-left-radius: valid-radius($radius);\n  }\n}\n\n@mixin border-top-start-radius($radius: $border-radius) {\n  @if $enable-rounded {\n    border-top-left-radius: valid-radius($radius);\n  }\n}\n\n@mixin border-top-end-radius($radius: $border-radius) {\n  @if $enable-rounded {\n    border-top-right-radius: valid-radius($radius);\n  }\n}\n\n@mixin border-bottom-end-radius($radius: $border-radius) {\n  @if $enable-rounded {\n    border-bottom-right-radius: valid-radius($radius);\n  }\n}\n\n@mixin border-bottom-start-radius($radius: $border-radius) {\n  @if $enable-rounded {\n    border-bottom-left-radius: valid-radius($radius);\n  }\n}\n// scss-docs-end border-radius-mixins\n","//\n// Headings\n//\n.h1 {\n  @extend h1;\n}\n\n.h2 {\n  @extend h2;\n}\n\n.h3 {\n  @extend h3;\n}\n\n.h4 {\n  @extend h4;\n}\n\n.h5 {\n  @extend h5;\n}\n\n.h6 {\n  @extend h6;\n}\n\n\n.lead {\n  @include font-size($lead-font-size);\n  font-weight: $lead-font-weight;\n}\n\n// Type display classes\n@each $display, $font-size in $display-font-sizes {\n  .display-#{$display} {\n    @include font-size($font-size);\n    font-weight: $display-font-weight;\n    line-height: $display-line-height;\n  }\n}\n\n//\n// Emphasis\n//\n.small {\n  @extend small;\n}\n\n.mark {\n  @extend mark;\n}\n\n//\n// Lists\n//\n\n.list-unstyled {\n  @include list-unstyled();\n}\n\n// Inline turns list items into inline-block\n.list-inline {\n  @include list-unstyled();\n}\n.list-inline-item {\n  display: inline-block;\n\n  &:not(:last-child) {\n    margin-right: $list-inline-padding;\n  }\n}\n\n\n//\n// Misc\n//\n\n// Builds on `abbr`\n.initialism {\n  @include font-size($initialism-font-size);\n  text-transform: uppercase;\n}\n\n// Blockquotes\n.blockquote {\n  margin-bottom: $blockquote-margin-y;\n  @include font-size($blockquote-font-size);\n\n  > :last-child {\n    margin-bottom: 0;\n  }\n}\n\n.blockquote-footer {\n  margin-top: -$blockquote-margin-y;\n  margin-bottom: $blockquote-margin-y;\n  @include font-size($blockquote-footer-font-size);\n  color: $blockquote-footer-color;\n\n  &::before {\n    content: \"\\2014\\00A0\"; // em dash, nbsp\n  }\n}\n","// Lists\n\n// Unstyled keeps list items block level, just removes default browser padding and list-style\n@mixin list-unstyled {\n  padding-left: 0;\n  list-style: none;\n}\n","// Responsive images (ensure images don't scale beyond their parents)\n//\n// This is purposefully opt-in via an explicit class rather than being the default for all `<img>`s.\n// We previously tried the \"images are responsive by default\" approach in Bootstrap v2,\n// and abandoned it in Bootstrap v3 because it breaks lots of third-party widgets (including Google Maps)\n// which weren't expecting the images within themselves to be involuntarily resized.\n// See also https://github.com/twbs/bootstrap/issues/18178\n.img-fluid {\n  @include img-fluid();\n}\n\n\n// Image thumbnails\n.img-thumbnail {\n  padding: $thumbnail-padding;\n  background-color: $thumbnail-bg;\n  border: $thumbnail-border-width solid $thumbnail-border-color;\n  @include border-radius($thumbnail-border-radius);\n  @include box-shadow($thumbnail-box-shadow);\n\n  // Keep them at most 100% wide\n  @include img-fluid();\n}\n\n//\n// Figures\n//\n\n.figure {\n  // Ensures the caption's text aligns with the image.\n  display: inline-block;\n}\n\n.figure-img {\n  margin-bottom: $spacer * .5;\n  line-height: 1;\n}\n\n.figure-caption {\n  @include font-size($figure-caption-font-size);\n  color: $figure-caption-color;\n}\n","// Image Mixins\n// - Responsive image\n// - Retina image\n\n\n// Responsive image\n//\n// Keep images from scaling beyond the width of their parents.\n\n@mixin img-fluid {\n  // Part 1: Set a maximum relative to the parent\n  max-width: 100%;\n  // Part 2: Override the height to auto, otherwise images will be stretched\n  // when setting a width and height attribute on the img element.\n  height: auto;\n}\n","// Container widths\n//\n// Set the container width, and override it for fixed navbars in media queries.\n\n@if $enable-grid-classes {\n  // Single container class with breakpoint max-widths\n  .container,\n  // 100% wide container at all breakpoints\n  .container-fluid {\n    @include make-container();\n  }\n\n  // Responsive containers that are 100% wide until a breakpoint\n  @each $breakpoint, $container-max-width in $container-max-widths {\n    .container-#{$breakpoint} {\n      @extend .container-fluid;\n    }\n\n    @include media-breakpoint-up($breakpoint, $grid-breakpoints) {\n      %responsive-container-#{$breakpoint} {\n        max-width: $container-max-width;\n      }\n\n      // Extend each breakpoint which is smaller or equal to the current breakpoint\n      $extend-breakpoint: true;\n\n      @each $name, $width in $grid-breakpoints {\n        @if ($extend-breakpoint) {\n          .container#{breakpoint-infix($name, $grid-breakpoints)} {\n            @extend %responsive-container-#{$breakpoint};\n          }\n\n          // Once the current breakpoint is reached, stop extending\n          @if ($breakpoint == $name) {\n            $extend-breakpoint: false;\n          }\n        }\n      }\n    }\n  }\n}\n","// Container mixins\n\n@mixin make-container($gutter: $container-padding-x) {\n  width: 100%;\n  padding-right: var(--#{$variable-prefix}gutter-x, #{$gutter});\n  padding-left: var(--#{$variable-prefix}gutter-x, #{$gutter});\n  margin-right: auto;\n  margin-left: auto;\n}\n","// Breakpoint viewport sizes and media queries.\n//\n// Breakpoints are defined as a map of (name: minimum width), order from small to large:\n//\n//    (xs: 0, sm: 576px, md: 768px, lg: 992px, xl: 1200px)\n//\n// The map defined in the `$grid-breakpoints` global variable is used as the `$breakpoints` argument by default.\n\n// Name of the next breakpoint, or null for the last breakpoint.\n//\n//    >> breakpoint-next(sm)\n//    md\n//    >> breakpoint-next(sm, (xs: 0, sm: 576px, md: 768px, lg: 992px, xl: 1200px))\n//    md\n//    >> breakpoint-next(sm, $breakpoint-names: (xs sm md lg xl))\n//    md\n@function breakpoint-next($name, $breakpoints: $grid-breakpoints, $breakpoint-names: map-keys($breakpoints)) {\n  $n: index($breakpoint-names, $name);\n  @if not $n {\n    @error \"breakpoint `#{$name}` not found in `#{$breakpoints}`\";\n  }\n  @return if($n < length($breakpoint-names), nth($breakpoint-names, $n + 1), null);\n}\n\n// Minimum breakpoint width. Null for the smallest (first) breakpoint.\n//\n//    >> breakpoint-min(sm, (xs: 0, sm: 576px, md: 768px, lg: 992px, xl: 1200px))\n//    576px\n@function breakpoint-min($name, $breakpoints: $grid-breakpoints) {\n  $min: map-get($breakpoints, $name);\n  @return if($min != 0, $min, null);\n}\n\n// Maximum breakpoint width.\n// The maximum value is reduced by 0.02px to work around the limitations of\n// `min-` and `max-` prefixes and viewports with fractional widths.\n// See https://www.w3.org/TR/mediaqueries-4/#mq-min-max\n// Uses 0.02px rather than 0.01px to work around a current rounding bug in Safari.\n// See https://bugs.webkit.org/show_bug.cgi?id=178261\n//\n//    >> breakpoint-max(md, (xs: 0, sm: 576px, md: 768px, lg: 992px, xl: 1200px))\n//    767.98px\n@function breakpoint-max($name, $breakpoints: $grid-breakpoints) {\n  $max: map-get($breakpoints, $name);\n  @return if($max and $max > 0, $max - .02, null);\n}\n\n// Returns a blank string if smallest breakpoint, otherwise returns the name with a dash in front.\n// Useful for making responsive utilities.\n//\n//    >> breakpoint-infix(xs, (xs: 0, sm: 576px, md: 768px, lg: 992px, xl: 1200px))\n//    \"\"  (Returns a blank string)\n//    >> breakpoint-infix(sm, (xs: 0, sm: 576px, md: 768px, lg: 992px, xl: 1200px))\n//    \"-sm\"\n@function breakpoint-infix($name, $breakpoints: $grid-breakpoints) {\n  @return if(breakpoint-min($name, $breakpoints) == null, \"\", \"-#{$name}\");\n}\n\n// Media of at least the minimum breakpoint width. No query for the smallest breakpoint.\n// Makes the @content apply to the given breakpoint and wider.\n@mixin media-breakpoint-up($name, $breakpoints: $grid-breakpoints) {\n  $min: breakpoint-min($name, $breakpoints);\n  @if $min {\n    @media (min-width: $min) {\n      @content;\n    }\n  } @else {\n    @content;\n  }\n}\n\n// Media of at most the maximum breakpoint width. No query for the largest breakpoint.\n// Makes the @content apply to the given breakpoint and narrower.\n@mixin media-breakpoint-down($name, $breakpoints: $grid-breakpoints) {\n  $max: breakpoint-max($name, $breakpoints);\n  @if $max {\n    @media (max-width: $max) {\n      @content;\n    }\n  } @else {\n    @content;\n  }\n}\n\n// Media that spans multiple breakpoint widths.\n// Makes the @content apply between the min and max breakpoints\n@mixin media-breakpoint-between($lower, $upper, $breakpoints: $grid-breakpoints) {\n  $min: breakpoint-min($lower, $breakpoints);\n  $max: breakpoint-max($upper, $breakpoints);\n\n  @if $min != null and $max != null {\n    @media (min-width: $min) and (max-width: $max) {\n      @content;\n    }\n  } @else if $max == null {\n    @include media-breakpoint-up($lower, $breakpoints) {\n      @content;\n    }\n  } @else if $min == null {\n    @include media-breakpoint-down($upper, $breakpoints) {\n      @content;\n    }\n  }\n}\n\n// Media between the breakpoint's minimum and maximum widths.\n// No minimum for the smallest breakpoint, and no maximum for the largest one.\n// Makes the @content apply only to the given breakpoint, not viewports any wider or narrower.\n@mixin media-breakpoint-only($name, $breakpoints: $grid-breakpoints) {\n  $min:  breakpoint-min($name, $breakpoints);\n  $next: breakpoint-next($name, $breakpoints);\n  $max:  breakpoint-max($next);\n\n  @if $min != null and $max != null {\n    @media (min-width: $min) and (max-width: $max) {\n      @content;\n    }\n  } @else if $max == null {\n    @include media-breakpoint-up($name, $breakpoints) {\n      @content;\n    }\n  } @else if $min == null {\n    @include media-breakpoint-down($next, $breakpoints) {\n      @content;\n    }\n  }\n}\n","// Row\n//\n// Rows contain your columns.\n\n@if $enable-grid-classes {\n  .row {\n    @include make-row();\n\n    > * {\n      @include make-col-ready();\n    }\n  }\n}\n\n@if $enable-cssgrid {\n  .grid {\n    display: grid;\n    grid-template-rows: repeat(var(--#{$variable-prefix}rows, 1), 1fr);\n    grid-template-columns: repeat(var(--#{$variable-prefix}columns, #{$grid-columns}), 1fr);\n    gap: var(--#{$variable-prefix}gap, #{$grid-gutter-width});\n\n    @include make-cssgrid();\n  }\n}\n\n\n// Columns\n//\n// Common styles for small and large grid columns\n\n@if $enable-grid-classes {\n  @include make-grid-columns();\n}\n","// Grid system\n//\n// Generate semantic grid columns with these mixins.\n\n@mixin make-row($gutter: $grid-gutter-width) {\n  --#{$variable-prefix}gutter-x: #{$gutter};\n  --#{$variable-prefix}gutter-y: 0;\n  display: flex;\n  flex-wrap: wrap;\n  margin-top: calc(var(--#{$variable-prefix}gutter-y) * -1); // stylelint-disable-line function-disallowed-list\n  margin-right: calc(var(--#{$variable-prefix}gutter-x) * -.5); // stylelint-disable-line function-disallowed-list\n  margin-left: calc(var(--#{$variable-prefix}gutter-x) * -.5); // stylelint-disable-line function-disallowed-list\n}\n\n@mixin make-col-ready($gutter: $grid-gutter-width) {\n  // Add box sizing if only the grid is loaded\n  box-sizing: if(variable-exists(include-column-box-sizing) and $include-column-box-sizing, border-box, null);\n  // Prevent columns from becoming too narrow when at smaller grid tiers by\n  // always setting `width: 100%;`. This works because we set the width\n  // later on to override this initial width.\n  flex-shrink: 0;\n  width: 100%;\n  max-width: 100%; // Prevent `.col-auto`, `.col` (& responsive variants) from breaking out the grid\n  padding-right: calc(var(--#{$variable-prefix}gutter-x) * .5); // stylelint-disable-line function-disallowed-list\n  padding-left: calc(var(--#{$variable-prefix}gutter-x) * .5); // stylelint-disable-line function-disallowed-list\n  margin-top: var(--#{$variable-prefix}gutter-y);\n}\n\n@mixin make-col($size: false, $columns: $grid-columns) {\n  @if $size {\n    flex: 0 0 auto;\n    width: percentage(divide($size, $columns));\n\n  } @else {\n    flex: 1 1 0;\n    max-width: 100%;\n  }\n}\n\n@mixin make-col-auto() {\n  flex: 0 0 auto;\n  width: auto;\n}\n\n@mixin make-col-offset($size, $columns: $grid-columns) {\n  $num: divide($size, $columns);\n  margin-left: if($num == 0, 0, percentage($num));\n}\n\n// Row columns\n//\n// Specify on a parent element(e.g., .row) to force immediate children into NN\n// numberof columns. Supports wrapping to new lines, but does not do a Masonry\n// style grid.\n@mixin row-cols($count) {\n  > * {\n    flex: 0 0 auto;\n    width: divide(100%, $count);\n  }\n}\n\n// Framework grid generation\n//\n// Used only by Bootstrap to generate the correct number of grid classes given\n// any value of `$grid-columns`.\n\n@mixin make-grid-columns($columns: $grid-columns, $gutter: $grid-gutter-width, $breakpoints: $grid-breakpoints) {\n  @each $breakpoint in map-keys($breakpoints) {\n    $infix: breakpoint-infix($breakpoint, $breakpoints);\n\n    @include media-breakpoint-up($breakpoint, $breakpoints) {\n      // Provide basic `.col-{bp}` classes for equal-width flexbox columns\n      .col#{$infix} {\n        flex: 1 0 0%; // Flexbugs #4: https://github.com/philipwalton/flexbugs#flexbug-4\n      }\n\n      .row-cols#{$infix}-auto > * {\n        @include make-col-auto();\n      }\n\n      @if $grid-row-columns > 0 {\n        @for $i from 1 through $grid-row-columns {\n          .row-cols#{$infix}-#{$i} {\n            @include row-cols($i);\n          }\n        }\n      }\n\n      .col#{$infix}-auto {\n        @include make-col-auto();\n      }\n\n      @if $columns > 0 {\n        @for $i from 1 through $columns {\n          .col#{$infix}-#{$i} {\n            @include make-col($i, $columns);\n          }\n        }\n\n        // `$columns - 1` because offsetting by the width of an entire row isn't possible\n        @for $i from 0 through ($columns - 1) {\n          @if not ($infix == \"\" and $i == 0) { // Avoid emitting useless .offset-0\n            .offset#{$infix}-#{$i} {\n              @include make-col-offset($i, $columns);\n            }\n          }\n        }\n      }\n\n      // Gutters\n      //\n      // Make use of `.g-*`, `.gx-*` or `.gy-*` utilities to change spacing between the columns.\n      @each $key, $value in $gutters {\n        .g#{$infix}-#{$key},\n        .gx#{$infix}-#{$key} {\n          --#{$variable-prefix}gutter-x: #{$value};\n        }\n\n        .g#{$infix}-#{$key},\n        .gy#{$infix}-#{$key} {\n          --#{$variable-prefix}gutter-y: #{$value};\n        }\n      }\n    }\n  }\n}\n\n@mixin make-cssgrid($columns: $grid-columns, $breakpoints: $grid-breakpoints) {\n  @each $breakpoint in map-keys($breakpoints) {\n    $infix: breakpoint-infix($breakpoint, $breakpoints);\n\n    @include media-breakpoint-up($breakpoint, $breakpoints) {\n      @if $columns > 0 {\n        @for $i from 1 through $columns {\n          .g-col#{$infix}-#{$i} {\n            grid-column: auto / span $i;\n          }\n        }\n\n        // Start with `1` because `0` is and invalid value.\n        // Ends with `$columns - 1` because offsetting by the width of an entire row isn't possible.\n        @for $i from 1 through ($columns - 1) {\n          .g-start#{$infix}-#{$i} {\n            grid-column-start: $i;\n          }\n        }\n      }\n    }\n  }\n}\n","//\n// Basic Bootstrap table\n//\n\n.table {\n  --#{$variable-prefix}table-bg: #{$table-bg};\n  --#{$variable-prefix}table-accent-bg: #{$table-accent-bg};\n  --#{$variable-prefix}table-striped-color: #{$table-striped-color};\n  --#{$variable-prefix}table-striped-bg: #{$table-striped-bg};\n  --#{$variable-prefix}table-active-color: #{$table-active-color};\n  --#{$variable-prefix}table-active-bg: #{$table-active-bg};\n  --#{$variable-prefix}table-hover-color: #{$table-hover-color};\n  --#{$variable-prefix}table-hover-bg: #{$table-hover-bg};\n\n  width: 100%;\n  margin-bottom: $spacer;\n  color: $table-color;\n  vertical-align: $table-cell-vertical-align;\n  border-color: $table-border-color;\n\n  // Target th & td\n  // We need the child combinator to prevent styles leaking to nested tables which doesn't have a `.table` class.\n  // We use the universal selectors here to simplify the selector (else we would need 6 different selectors).\n  // Another advantage is that this generates less code and makes the selector less specific making it easier to override.\n  // stylelint-disable-next-line selector-max-universal\n  > :not(caption) > * > * {\n    padding: $table-cell-padding-y $table-cell-padding-x;\n    background-color: var(--#{$variable-prefix}table-bg);\n    border-bottom-width: $table-border-width;\n    box-shadow: inset 0 0 0 9999px var(--#{$variable-prefix}table-accent-bg);\n  }\n\n  > tbody {\n    vertical-align: inherit;\n  }\n\n  > thead {\n    vertical-align: bottom;\n  }\n\n  // Highlight border color between thead, tbody and tfoot.\n  > :not(:last-child) > :last-child > * {\n    border-bottom-color: $table-group-separator-color;\n  }\n}\n\n\n//\n// Change placement of captions with a class\n//\n\n.caption-top {\n  caption-side: top;\n}\n\n\n//\n// Condensed table w/ half padding\n//\n\n.table-sm {\n  // stylelint-disable-next-line selector-max-universal\n  > :not(caption) > * > * {\n    padding: $table-cell-padding-y-sm $table-cell-padding-x-sm;\n  }\n}\n\n\n// Border versions\n//\n// Add or remove borders all around the table and between all the columns.\n//\n// When borders are added on all sides of the cells, the corners can render odd when\n// these borders do not have the same color or if they are semi-transparent.\n// Therefor we add top and border bottoms to the `tr`s and left and right borders\n// to the `td`s or `th`s\n\n.table-bordered {\n  > :not(caption) > * {\n    border-width: $table-border-width 0;\n\n    // stylelint-disable-next-line selector-max-universal\n    > * {\n      border-width: 0 $table-border-width;\n    }\n  }\n}\n\n.table-borderless {\n  // stylelint-disable-next-line selector-max-universal\n  > :not(caption) > * > * {\n    border-bottom-width: 0;\n  }\n}\n\n// Zebra-striping\n//\n// Default zebra-stripe styles (alternating gray and transparent backgrounds)\n\n.table-striped {\n  > tbody > tr:nth-of-type(#{$table-striped-order}) {\n    --#{$variable-prefix}table-accent-bg: var(--#{$variable-prefix}table-striped-bg);\n    color: var(--#{$variable-prefix}table-striped-color);\n  }\n}\n\n// Active table\n//\n// The `.table-active` class can be added to highlight rows or cells\n\n.table-active {\n  --#{$variable-prefix}table-accent-bg: var(--#{$variable-prefix}table-active-bg);\n  color: var(--#{$variable-prefix}table-active-color);\n}\n\n// Hover effect\n//\n// Placed here since it has to come after the potential zebra striping\n\n.table-hover {\n  > tbody > tr:hover {\n    --#{$variable-prefix}table-accent-bg: var(--#{$variable-prefix}table-hover-bg);\n    color: var(--#{$variable-prefix}table-hover-color);\n  }\n}\n\n\n// Table variants\n//\n// Table variants set the table cell backgrounds, border colors\n// and the colors of the striped, hovered & active tables\n\n@each $color, $value in $table-variants {\n  @include table-variant($color, $value);\n}\n\n// Responsive tables\n//\n// Generate series of `.table-responsive-*` classes for configuring the screen\n// size of where your table will overflow.\n\n@each $breakpoint in map-keys($grid-breakpoints) {\n  $infix: breakpoint-infix($breakpoint, $grid-breakpoints);\n\n  @include media-breakpoint-down($breakpoint) {\n    .table-responsive#{$infix} {\n      overflow-x: auto;\n      -webkit-overflow-scrolling: touch;\n    }\n  }\n}\n","// scss-docs-start table-variant\n@mixin table-variant($state, $background) {\n  .table-#{$state} {\n    $color: color-contrast(opaque($body-bg, $background));\n    $hover-bg: mix($color, $background, percentage($table-hover-bg-factor));\n    $striped-bg: mix($color, $background, percentage($table-striped-bg-factor));\n    $active-bg: mix($color, $background, percentage($table-active-bg-factor));\n\n    --#{$variable-prefix}table-bg: #{$background};\n    --#{$variable-prefix}table-striped-bg: #{$striped-bg};\n    --#{$variable-prefix}table-striped-color: #{color-contrast($striped-bg)};\n    --#{$variable-prefix}table-active-bg: #{$active-bg};\n    --#{$variable-prefix}table-active-color: #{color-contrast($active-bg)};\n    --#{$variable-prefix}table-hover-bg: #{$hover-bg};\n    --#{$variable-prefix}table-hover-color: #{color-contrast($hover-bg)};\n\n    color: $color;\n    border-color: mix($color, $background, percentage($table-border-factor));\n  }\n}\n// scss-docs-end table-variant\n","//\n// Labels\n//\n\n.form-label {\n  margin-bottom: $form-label-margin-bottom;\n  @include font-size($form-label-font-size);\n  font-style: $form-label-font-style;\n  font-weight: $form-label-font-weight;\n  color: $form-label-color;\n}\n\n// For use with horizontal and inline forms, when you need the label (or legend)\n// text to align with the form controls.\n.col-form-label {\n  padding-top: add($input-padding-y, $input-border-width);\n  padding-bottom: add($input-padding-y, $input-border-width);\n  margin-bottom: 0; // Override the `<legend>` default\n  @include font-size(inherit); // Override the `<legend>` default\n  font-style: $form-label-font-style;\n  font-weight: $form-label-font-weight;\n  line-height: $input-line-height;\n  color: $form-label-color;\n}\n\n.col-form-label-lg {\n  padding-top: add($input-padding-y-lg, $input-border-width);\n  padding-bottom: add($input-padding-y-lg, $input-border-width);\n  @include font-size($input-font-size-lg);\n}\n\n.col-form-label-sm {\n  padding-top: add($input-padding-y-sm, $input-border-width);\n  padding-bottom: add($input-padding-y-sm, $input-border-width);\n  @include font-size($input-font-size-sm);\n}\n","//\n// Form text\n//\n\n.form-text {\n  margin-top: $form-text-margin-top;\n  @include font-size($form-text-font-size);\n  font-style: $form-text-font-style;\n  font-weight: $form-text-font-weight;\n  color: $form-text-color;\n}\n","//\n// General form controls (plus a few specific high-level interventions)\n//\n\n.form-control {\n  display: block;\n  width: 100%;\n  padding: $input-padding-y $input-padding-x;\n  font-family: $input-font-family;\n  @include font-size($input-font-size);\n  font-weight: $input-font-weight;\n  line-height: $input-line-height;\n  color: $input-color;\n  background-color: $input-bg;\n  background-clip: padding-box;\n  border: $input-border-width solid $input-border-color;\n  appearance: none; // Fix appearance for date inputs in Safari\n\n  // Note: This has no effect on <select>s in some browsers, due to the limited stylability of `<select>`s in CSS.\n  @include border-radius($input-border-radius, 0);\n\n  @include box-shadow($input-box-shadow);\n  @include transition($input-transition);\n\n  &[type=\"file\"] {\n    overflow: hidden; // prevent pseudo element button overlap\n\n    &:not(:disabled):not([readonly]) {\n      cursor: pointer;\n    }\n  }\n\n  // Customize the `:focus` state to imitate native WebKit styles.\n  &:focus {\n    color: $input-focus-color;\n    background-color: $input-focus-bg;\n    border-color: $input-focus-border-color;\n    outline: 0;\n    @if $enable-shadows {\n      @include box-shadow($input-box-shadow, $input-focus-box-shadow);\n    } @else {\n      // Avoid using mixin so we can pass custom focus shadow properly\n      box-shadow: $input-focus-box-shadow;\n    }\n  }\n\n  // Add some height to date inputs on iOS\n  // https://github.com/twbs/bootstrap/issues/23307\n  // TODO: we can remove this workaround once https://bugs.webkit.org/show_bug.cgi?id=198959 is resolved\n  &::-webkit-date-and-time-value {\n    // Multiply line-height by 1em if it has no unit\n    height: if(unit($input-line-height) == \"\", $input-line-height * 1em, $input-line-height);\n  }\n\n  // Placeholder\n  &::placeholder {\n    color: $input-placeholder-color;\n    // Override Firefox's unusual default opacity; see https://github.com/twbs/bootstrap/pull/11526.\n    opacity: 1;\n  }\n\n  // Disabled and read-only inputs\n  //\n  // HTML5 says that controls under a fieldset > legend:first-child won't be\n  // disabled if the fieldset is disabled. Due to implementation difficulty, we\n  // don't honor that edge case; we style them as disabled anyway.\n  &:disabled,\n  &[readonly] {\n    background-color: $input-disabled-bg;\n    border-color: $input-disabled-border-color;\n    // iOS fix for unreadable disabled content; see https://github.com/twbs/bootstrap/issues/11655.\n    opacity: 1;\n  }\n\n  // File input buttons theming\n  &::file-selector-button {\n    padding: $input-padding-y $input-padding-x;\n    margin: (-$input-padding-y) (-$input-padding-x);\n    margin-inline-end: $input-padding-x;\n    color: $form-file-button-color;\n    @include gradient-bg($form-file-button-bg);\n    pointer-events: none;\n    border-color: inherit;\n    border-style: solid;\n    border-width: 0;\n    border-inline-end-width: $input-border-width;\n    border-radius: 0; // stylelint-disable-line property-disallowed-list\n    @include transition($btn-transition);\n  }\n\n  &:hover:not(:disabled):not([readonly])::file-selector-button {\n    background-color: $form-file-button-hover-bg;\n  }\n\n  &::-webkit-file-upload-button {\n    padding: $input-padding-y $input-padding-x;\n    margin: (-$input-padding-y) (-$input-padding-x);\n    margin-inline-end: $input-padding-x;\n    color: $form-file-button-color;\n    @include gradient-bg($form-file-button-bg);\n    pointer-events: none;\n    border-color: inherit;\n    border-style: solid;\n    border-width: 0;\n    border-inline-end-width: $input-border-width;\n    border-radius: 0; // stylelint-disable-line property-disallowed-list\n    @include transition($btn-transition);\n  }\n\n  &:hover:not(:disabled):not([readonly])::-webkit-file-upload-button {\n    background-color: $form-file-button-hover-bg;\n  }\n}\n\n// Readonly controls as plain text\n//\n// Apply class to a readonly input to make it appear like regular plain\n// text (without any border, background color, focus indicator)\n\n.form-control-plaintext {\n  display: block;\n  width: 100%;\n  padding: $input-padding-y 0;\n  margin-bottom: 0; // match inputs if this class comes on inputs with default margins\n  line-height: $input-line-height;\n  color: $input-plaintext-color;\n  background-color: transparent;\n  border: solid transparent;\n  border-width: $input-border-width 0;\n\n  &.form-control-sm,\n  &.form-control-lg {\n    padding-right: 0;\n    padding-left: 0;\n  }\n}\n\n// Form control sizing\n//\n// Build on `.form-control` with modifier classes to decrease or increase the\n// height and font-size of form controls.\n//\n// Repeated in `_input_group.scss` to avoid Sass extend issues.\n\n.form-control-sm {\n  min-height: $input-height-sm;\n  padding: $input-padding-y-sm $input-padding-x-sm;\n  @include font-size($input-font-size-sm);\n  @include border-radius($input-border-radius-sm);\n\n  &::file-selector-button {\n    padding: $input-padding-y-sm $input-padding-x-sm;\n    margin: (-$input-padding-y-sm) (-$input-padding-x-sm);\n    margin-inline-end: $input-padding-x-sm;\n  }\n\n  &::-webkit-file-upload-button {\n    padding: $input-padding-y-sm $input-padding-x-sm;\n    margin: (-$input-padding-y-sm) (-$input-padding-x-sm);\n    margin-inline-end: $input-padding-x-sm;\n  }\n}\n\n.form-control-lg {\n  min-height: $input-height-lg;\n  padding: $input-padding-y-lg $input-padding-x-lg;\n  @include font-size($input-font-size-lg);\n  @include border-radius($input-border-radius-lg);\n\n  &::file-selector-button {\n    padding: $input-padding-y-lg $input-padding-x-lg;\n    margin: (-$input-padding-y-lg) (-$input-padding-x-lg);\n    margin-inline-end: $input-padding-x-lg;\n  }\n\n  &::-webkit-file-upload-button {\n    padding: $input-padding-y-lg $input-padding-x-lg;\n    margin: (-$input-padding-y-lg) (-$input-padding-x-lg);\n    margin-inline-end: $input-padding-x-lg;\n  }\n}\n\n// Make sure textareas don't shrink too much when resized\n// https://github.com/twbs/bootstrap/pull/29124\n// stylelint-disable selector-no-qualifying-type\ntextarea {\n  &.form-control {\n    min-height: $input-height;\n  }\n\n  &.form-control-sm {\n    min-height: $input-height-sm;\n  }\n\n  &.form-control-lg {\n    min-height: $input-height-lg;\n  }\n}\n// stylelint-enable selector-no-qualifying-type\n\n.form-control-color {\n  width: $form-color-width;\n  height: auto; // Override fixed browser height\n  padding: $input-padding-y;\n\n  &:not(:disabled):not([readonly]) {\n    cursor: pointer;\n  }\n\n  &::-moz-color-swatch {\n    height: if(unit($input-line-height) == \"\", $input-line-height * 1em, $input-line-height);\n    @include border-radius($input-border-radius);\n  }\n\n  &::-webkit-color-swatch {\n    height: if(unit($input-line-height) == \"\", $input-line-height * 1em, $input-line-height);\n    @include border-radius($input-border-radius);\n  }\n}\n","// stylelint-disable property-disallowed-list\n@mixin transition($transition...) {\n  @if length($transition) == 0 {\n    $transition: $transition-base;\n  }\n\n  @if length($transition) > 1 {\n    @each $value in $transition {\n      @if $value == null or $value == none {\n        @warn \"The keyword 'none' or 'null' must be used as a single argument.\";\n      }\n    }\n  }\n\n  @if $enable-transitions {\n    @if nth($transition, 1) != null {\n      transition: $transition;\n    }\n\n    @if $enable-reduced-motion and nth($transition, 1) != null and nth($transition, 1) != none {\n      @media (prefers-reduced-motion: reduce) {\n        transition: none;\n      }\n    }\n  }\n}\n","// Gradients\n\n// scss-docs-start gradient-bg-mixin\n@mixin gradient-bg($color: null) {\n  background-color: $color;\n\n  @if $enable-gradients {\n    background-image: var(--#{$variable-prefix}gradient);\n  }\n}\n// scss-docs-end gradient-bg-mixin\n\n// scss-docs-start gradient-mixins\n// Horizontal gradient, from left to right\n//\n// Creates two color stops, start and end, by specifying a color and position for each color stop.\n@mixin gradient-x($start-color: $gray-700, $end-color: $gray-800, $start-percent: 0%, $end-percent: 100%) {\n  background-image: linear-gradient(to right, $start-color $start-percent, $end-color $end-percent);\n}\n\n// Vertical gradient, from top to bottom\n//\n// Creates two color stops, start and end, by specifying a color and position for each color stop.\n@mixin gradient-y($start-color: $gray-700, $end-color: $gray-800, $start-percent: null, $end-percent: null) {\n  background-image: linear-gradient(to bottom, $start-color $start-percent, $end-color $end-percent);\n}\n\n@mixin gradient-directional($start-color: $gray-700, $end-color: $gray-800, $deg: 45deg) {\n  background-image: linear-gradient($deg, $start-color, $end-color);\n}\n\n@mixin gradient-x-three-colors($start-color: $blue, $mid-color: $purple, $color-stop: 50%, $end-color: $red) {\n  background-image: linear-gradient(to right, $start-color, $mid-color $color-stop, $end-color);\n}\n\n@mixin gradient-y-three-colors($start-color: $blue, $mid-color: $purple, $color-stop: 50%, $end-color: $red) {\n  background-image: linear-gradient($start-color, $mid-color $color-stop, $end-color);\n}\n\n@mixin gradient-radial($inner-color: $gray-700, $outer-color: $gray-800) {\n  background-image: radial-gradient(circle, $inner-color, $outer-color);\n}\n\n@mixin gradient-striped($color: rgba($white, .15), $angle: 45deg) {\n  background-image: linear-gradient($angle, $color 25%, transparent 25%, transparent 50%, $color 50%, $color 75%, transparent 75%, transparent);\n}\n// scss-docs-end gradient-mixins\n","// Select\n//\n// Replaces the browser default select with a custom one, mostly pulled from\n// https://primer.github.io/.\n\n.form-select {\n  display: block;\n  width: 100%;\n  padding: $form-select-padding-y $form-select-indicator-padding $form-select-padding-y $form-select-padding-x;\n  // stylelint-disable-next-line property-no-vendor-prefix\n  -moz-padding-start: subtract($form-select-padding-x, 3px); // See https://github.com/twbs/bootstrap/issues/32636\n  font-family: $form-select-font-family;\n  @include font-size($form-select-font-size);\n  font-weight: $form-select-font-weight;\n  line-height: $form-select-line-height;\n  color: $form-select-color;\n  background-color: $form-select-bg;\n  background-image: escape-svg($form-select-indicator);\n  background-repeat: no-repeat;\n  background-position: $form-select-bg-position;\n  background-size: $form-select-bg-size;\n  border: $form-select-border-width solid $form-select-border-color;\n  @include border-radius($form-select-border-radius, 0);\n  @include box-shadow($form-select-box-shadow);\n  @include transition($form-select-transition);\n  appearance: none;\n\n  &:focus {\n    border-color: $form-select-focus-border-color;\n    outline: 0;\n    @if $enable-shadows {\n      @include box-shadow($form-select-box-shadow, $form-select-focus-box-shadow);\n    } @else {\n      // Avoid using mixin so we can pass custom focus shadow properly\n      box-shadow: $form-select-focus-box-shadow;\n    }\n  }\n\n  &[multiple],\n  &[size]:not([size=\"1\"]) {\n    padding-right: $form-select-padding-x;\n    background-image: none;\n  }\n\n  &:disabled {\n    color: $form-select-disabled-color;\n    background-color: $form-select-disabled-bg;\n    border-color: $form-select-disabled-border-color;\n  }\n\n  // Remove outline from select box in FF\n  &:-moz-focusring {\n    color: transparent;\n    text-shadow: 0 0 0 $form-select-color;\n  }\n}\n\n.form-select-sm {\n  padding-top: $form-select-padding-y-sm;\n  padding-bottom: $form-select-padding-y-sm;\n  padding-left: $form-select-padding-x-sm;\n  @include font-size($form-select-font-size-sm);\n}\n\n.form-select-lg {\n  padding-top: $form-select-padding-y-lg;\n  padding-bottom: $form-select-padding-y-lg;\n  padding-left: $form-select-padding-x-lg;\n  @include font-size($form-select-font-size-lg);\n}\n","//\n// Check/radio\n//\n\n.form-check {\n  display: block;\n  min-height: $form-check-min-height;\n  padding-left: $form-check-padding-start;\n  margin-bottom: $form-check-margin-bottom;\n\n  .form-check-input {\n    float: left;\n    margin-left: $form-check-padding-start * -1;\n  }\n}\n\n.form-check-input {\n  width: $form-check-input-width;\n  height: $form-check-input-width;\n  margin-top: ($line-height-base - $form-check-input-width) * .5; // line-height minus check height\n  vertical-align: top;\n  background-color: $form-check-input-bg;\n  background-repeat: no-repeat;\n  background-position: center;\n  background-size: contain;\n  border: $form-check-input-border;\n  appearance: none;\n  color-adjust: exact; // Keep themed appearance for print\n  @include transition($form-check-transition);\n\n  &[type=\"checkbox\"] {\n    @include border-radius($form-check-input-border-radius);\n  }\n\n  &[type=\"radio\"] {\n    // stylelint-disable-next-line property-disallowed-list\n    border-radius: $form-check-radio-border-radius;\n  }\n\n  &:active {\n    filter: $form-check-input-active-filter;\n  }\n\n  &:focus {\n    border-color: $form-check-input-focus-border;\n    outline: 0;\n    box-shadow: $form-check-input-focus-box-shadow;\n  }\n\n  &:checked {\n    background-color: $form-check-input-checked-bg-color;\n    border-color: $form-check-input-checked-border-color;\n\n    &[type=\"checkbox\"] {\n      @if $enable-gradients {\n        background-image: escape-svg($form-check-input-checked-bg-image), var(--#{$variable-prefix}gradient);\n      } @else {\n        background-image: escape-svg($form-check-input-checked-bg-image);\n      }\n    }\n\n    &[type=\"radio\"] {\n      @if $enable-gradients {\n        background-image: escape-svg($form-check-radio-checked-bg-image), var(--#{$variable-prefix}gradient);\n      } @else {\n        background-image: escape-svg($form-check-radio-checked-bg-image);\n      }\n    }\n  }\n\n  &[type=\"checkbox\"]:indeterminate {\n    background-color: $form-check-input-indeterminate-bg-color;\n    border-color: $form-check-input-indeterminate-border-color;\n\n    @if $enable-gradients {\n      background-image: escape-svg($form-check-input-indeterminate-bg-image), var(--#{$variable-prefix}gradient);\n    } @else {\n      background-image: escape-svg($form-check-input-indeterminate-bg-image);\n    }\n  }\n\n  &:disabled {\n    pointer-events: none;\n    filter: none;\n    opacity: $form-check-input-disabled-opacity;\n  }\n\n  // Use disabled attribute in addition of :disabled pseudo-class\n  // See: https://github.com/twbs/bootstrap/issues/28247\n  &[disabled],\n  &:disabled {\n    ~ .form-check-label {\n      opacity: $form-check-label-disabled-opacity;\n    }\n  }\n}\n\n.form-check-label {\n  color: $form-check-label-color;\n  cursor: $form-check-label-cursor;\n}\n\n//\n// Switch\n//\n\n.form-switch {\n  padding-left: $form-switch-padding-start;\n\n  .form-check-input {\n    width: $form-switch-width;\n    margin-left: $form-switch-padding-start * -1;\n    background-image: escape-svg($form-switch-bg-image);\n    background-position: left center;\n    @include border-radius($form-switch-border-radius);\n    @include transition($form-switch-transition);\n\n    &:focus {\n      background-image: escape-svg($form-switch-focus-bg-image);\n    }\n\n    &:checked {\n      background-position: $form-switch-checked-bg-position;\n\n      @if $enable-gradients {\n        background-image: escape-svg($form-switch-checked-bg-image), var(--#{$variable-prefix}gradient);\n      } @else {\n        background-image: escape-svg($form-switch-checked-bg-image);\n      }\n    }\n  }\n}\n\n.form-check-inline {\n  display: inline-block;\n  margin-right: $form-check-inline-margin-end;\n}\n\n.btn-check {\n  position: absolute;\n  clip: rect(0, 0, 0, 0);\n  pointer-events: none;\n\n  &[disabled],\n  &:disabled {\n    + .btn {\n      pointer-events: none;\n      filter: none;\n      opacity: $form-check-btn-check-disabled-opacity;\n    }\n  }\n}\n","// Range\n//\n// Style range inputs the same across browsers. Vendor-specific rules for pseudo\n// elements cannot be mixed. As such, there are no shared styles for focus or\n// active states on prefixed selectors.\n\n.form-range {\n  width: 100%;\n  height: add($form-range-thumb-height, $form-range-thumb-focus-box-shadow-width * 2);\n  padding: 0; // Need to reset padding\n  background-color: transparent;\n  appearance: none;\n\n  &:focus {\n    outline: 0;\n\n    // Pseudo-elements must be split across multiple rulesets to have an effect.\n    // No box-shadow() mixin for focus accessibility.\n    &::-webkit-slider-thumb { box-shadow: $form-range-thumb-focus-box-shadow; }\n    &::-moz-range-thumb     { box-shadow: $form-range-thumb-focus-box-shadow; }\n  }\n\n  &::-moz-focus-outer {\n    border: 0;\n  }\n\n  &::-webkit-slider-thumb {\n    width: $form-range-thumb-width;\n    height: $form-range-thumb-height;\n    margin-top: ($form-range-track-height - $form-range-thumb-height) * .5; // Webkit specific\n    @include gradient-bg($form-range-thumb-bg);\n    border: $form-range-thumb-border;\n    @include border-radius($form-range-thumb-border-radius);\n    @include box-shadow($form-range-thumb-box-shadow);\n    @include transition($form-range-thumb-transition);\n    appearance: none;\n\n    &:active {\n      @include gradient-bg($form-range-thumb-active-bg);\n    }\n  }\n\n  &::-webkit-slider-runnable-track {\n    width: $form-range-track-width;\n    height: $form-range-track-height;\n    color: transparent; // Why?\n    cursor: $form-range-track-cursor;\n    background-color: $form-range-track-bg;\n    border-color: transparent;\n    @include border-radius($form-range-track-border-radius);\n    @include box-shadow($form-range-track-box-shadow);\n  }\n\n  &::-moz-range-thumb {\n    width: $form-range-thumb-width;\n    height: $form-range-thumb-height;\n    @include gradient-bg($form-range-thumb-bg);\n    border: $form-range-thumb-border;\n    @include border-radius($form-range-thumb-border-radius);\n    @include box-shadow($form-range-thumb-box-shadow);\n    @include transition($form-range-thumb-transition);\n    appearance: none;\n\n    &:active {\n      @include gradient-bg($form-range-thumb-active-bg);\n    }\n  }\n\n  &::-moz-range-track {\n    width: $form-range-track-width;\n    height: $form-range-track-height;\n    color: transparent;\n    cursor: $form-range-track-cursor;\n    background-color: $form-range-track-bg;\n    border-color: transparent; // Firefox specific?\n    @include border-radius($form-range-track-border-radius);\n    @include box-shadow($form-range-track-box-shadow);\n  }\n\n  &:disabled {\n    pointer-events: none;\n\n    &::-webkit-slider-thumb {\n      background-color: $form-range-thumb-disabled-bg;\n    }\n\n    &::-moz-range-thumb {\n      background-color: $form-range-thumb-disabled-bg;\n    }\n  }\n}\n",".form-floating {\n  position: relative;\n\n  > .form-control,\n  > .form-select {\n    height: $form-floating-height;\n    line-height: $form-floating-line-height;\n  }\n\n  > label {\n    position: absolute;\n    top: 0;\n    left: 0;\n    height: 100%; // allow textareas\n    padding: $form-floating-padding-y $form-floating-padding-x;\n    pointer-events: none;\n    border: $input-border-width solid transparent; // Required for aligning label's text with the input as it affects inner box model\n    transform-origin: 0 0;\n    @include transition($form-floating-transition);\n  }\n\n  // stylelint-disable no-duplicate-selectors\n  > .form-control {\n    padding: $form-floating-padding-y $form-floating-padding-x;\n\n    &::placeholder {\n      color: transparent;\n    }\n\n    &:focus,\n    &:not(:placeholder-shown) {\n      padding-top: $form-floating-input-padding-t;\n      padding-bottom: $form-floating-input-padding-b;\n    }\n    // Duplicated because `:-webkit-autofill` invalidates other selectors when grouped\n    &:-webkit-autofill {\n      padding-top: $form-floating-input-padding-t;\n      padding-bottom: $form-floating-input-padding-b;\n    }\n  }\n\n  > .form-select {\n    padding-top: $form-floating-input-padding-t;\n    padding-bottom: $form-floating-input-padding-b;\n  }\n\n  > .form-control:focus,\n  > .form-control:not(:placeholder-shown),\n  > .form-select {\n    ~ label {\n      opacity: $form-floating-label-opacity;\n      transform: $form-floating-label-transform;\n    }\n  }\n  // Duplicated because `:-webkit-autofill` invalidates other selectors when grouped\n  > .form-control:-webkit-autofill {\n    ~ label {\n      opacity: $form-floating-label-opacity;\n      transform: $form-floating-label-transform;\n    }\n  }\n  // stylelint-enable no-duplicate-selectors\n}\n","//\n// Base styles\n//\n\n.input-group {\n  position: relative;\n  display: flex;\n  flex-wrap: wrap; // For form validation feedback\n  align-items: stretch;\n  width: 100%;\n\n  > .form-control,\n  > .form-select {\n    position: relative; // For focus state's z-index\n    flex: 1 1 auto;\n    width: 1%;\n    min-width: 0; // https://stackoverflow.com/questions/36247140/why-dont-flex-items-shrink-past-content-size\n  }\n\n  // Bring the \"active\" form control to the top of surrounding elements\n  > .form-control:focus,\n  > .form-select:focus {\n    z-index: 3;\n  }\n\n  // Ensure buttons are always above inputs for more visually pleasing borders.\n  // This isn't needed for `.input-group-text` since it shares the same border-color\n  // as our inputs.\n  .btn {\n    position: relative;\n    z-index: 2;\n\n    &:focus {\n      z-index: 3;\n    }\n  }\n}\n\n\n// Textual addons\n//\n// Serves as a catch-all element for any text or radio/checkbox input you wish\n// to prepend or append to an input.\n\n.input-group-text {\n  display: flex;\n  align-items: center;\n  padding: $input-group-addon-padding-y $input-group-addon-padding-x;\n  @include font-size($input-font-size); // Match inputs\n  font-weight: $input-group-addon-font-weight;\n  line-height: $input-line-height;\n  color: $input-group-addon-color;\n  text-align: center;\n  white-space: nowrap;\n  background-color: $input-group-addon-bg;\n  border: $input-border-width solid $input-group-addon-border-color;\n  @include border-radius($input-border-radius);\n}\n\n\n// Sizing\n//\n// Remix the default form control sizing classes into new ones for easier\n// manipulation.\n\n.input-group-lg > .form-control,\n.input-group-lg > .form-select,\n.input-group-lg > .input-group-text,\n.input-group-lg > .btn {\n  padding: $input-padding-y-lg $input-padding-x-lg;\n  @include font-size($input-font-size-lg);\n  @include border-radius($input-border-radius-lg);\n}\n\n.input-group-sm > .form-control,\n.input-group-sm > .form-select,\n.input-group-sm > .input-group-text,\n.input-group-sm > .btn {\n  padding: $input-padding-y-sm $input-padding-x-sm;\n  @include font-size($input-font-size-sm);\n  @include border-radius($input-border-radius-sm);\n}\n\n.input-group-lg > .form-select,\n.input-group-sm > .form-select {\n  padding-right: $form-select-padding-x + $form-select-indicator-padding;\n}\n\n\n// Rounded corners\n//\n// These rulesets must come after the sizing ones to properly override sm and lg\n// border-radius values when extending. They're more specific than we'd like\n// with the `.input-group >` part, but without it, we cannot override the sizing.\n\n// stylelint-disable-next-line no-duplicate-selectors\n.input-group {\n  &:not(.has-validation) {\n    > :not(:last-child):not(.dropdown-toggle):not(.dropdown-menu),\n    > .dropdown-toggle:nth-last-child(n + 3) {\n      @include border-end-radius(0);\n    }\n  }\n\n  &.has-validation {\n    > :nth-last-child(n + 3):not(.dropdown-toggle):not(.dropdown-menu),\n    > .dropdown-toggle:nth-last-child(n + 4) {\n      @include border-end-radius(0);\n    }\n  }\n\n  $validation-messages: \"\";\n  @each $state in map-keys($form-validation-states) {\n    $validation-messages: $validation-messages + \":not(.\" + unquote($state) + \"-tooltip)\" + \":not(.\" + unquote($state) + \"-feedback)\";\n  }\n\n  > :not(:first-child):not(.dropdown-menu)#{$validation-messages} {\n    margin-left: -$input-border-width;\n    @include border-start-radius(0);\n  }\n}\n","// This mixin uses an `if()` technique to be compatible with Dart Sass\n// See https://github.com/sass/sass/issues/1873#issuecomment-152293725 for more details\n\n// scss-docs-start form-validation-mixins\n@mixin form-validation-state-selector($state) {\n  @if ($state == \"valid\" or $state == \"invalid\") {\n    .was-validated #{if(&, \"&\", \"\")}:#{$state},\n    #{if(&, \"&\", \"\")}.is-#{$state} {\n      @content;\n    }\n  } @else {\n    #{if(&, \"&\", \"\")}.is-#{$state} {\n      @content;\n    }\n  }\n}\n\n@mixin form-validation-state(\n  $state,\n  $color,\n  $icon,\n  $tooltip-color: color-contrast($color),\n  $tooltip-bg-color: rgba($color, $form-feedback-tooltip-opacity),\n  $focus-box-shadow: 0 0 $input-btn-focus-blur $input-focus-width rgba($color, $input-btn-focus-color-opacity)\n) {\n  .#{$state}-feedback {\n    display: none;\n    width: 100%;\n    margin-top: $form-feedback-margin-top;\n    @include font-size($form-feedback-font-size);\n    font-style: $form-feedback-font-style;\n    color: $color;\n  }\n\n  .#{$state}-tooltip {\n    position: absolute;\n    top: 100%;\n    z-index: 5;\n    display: none;\n    max-width: 100%; // Contain to parent when possible\n    padding: $form-feedback-tooltip-padding-y $form-feedback-tooltip-padding-x;\n    margin-top: .1rem;\n    @include font-size($form-feedback-tooltip-font-size);\n    line-height: $form-feedback-tooltip-line-height;\n    color: $tooltip-color;\n    background-color: $tooltip-bg-color;\n    @include border-radius($form-feedback-tooltip-border-radius);\n  }\n\n  @include form-validation-state-selector($state) {\n    ~ .#{$state}-feedback,\n    ~ .#{$state}-tooltip {\n      display: block;\n    }\n  }\n\n  .form-control {\n    @include form-validation-state-selector($state) {\n      border-color: $color;\n\n      @if $enable-validation-icons {\n        padding-right: $input-height-inner;\n        background-image: escape-svg($icon);\n        background-repeat: no-repeat;\n        background-position: right $input-height-inner-quarter center;\n        background-size: $input-height-inner-half $input-height-inner-half;\n      }\n\n      &:focus {\n        border-color: $color;\n        box-shadow: $focus-box-shadow;\n      }\n    }\n  }\n\n  // stylelint-disable-next-line selector-no-qualifying-type\n  textarea.form-control {\n    @include form-validation-state-selector($state) {\n      @if $enable-validation-icons {\n        padding-right: $input-height-inner;\n        background-position: top $input-height-inner-quarter right $input-height-inner-quarter;\n      }\n    }\n  }\n\n  .form-select {\n    @include form-validation-state-selector($state) {\n      border-color: $color;\n\n      @if $enable-validation-icons {\n        &:not([multiple]):not([size]),\n        &:not([multiple])[size=\"1\"] {\n          padding-right: $form-select-feedback-icon-padding-end;\n          background-image: escape-svg($form-select-indicator), escape-svg($icon);\n          background-position: $form-select-bg-position, $form-select-feedback-icon-position;\n          background-size: $form-select-bg-size, $form-select-feedback-icon-size;\n        }\n      }\n\n      &:focus {\n        border-color: $color;\n        box-shadow: $focus-box-shadow;\n      }\n    }\n  }\n\n  .form-check-input {\n    @include form-validation-state-selector($state) {\n      border-color: $color;\n\n      &:checked {\n        background-color: $color;\n      }\n\n      &:focus {\n        box-shadow: $focus-box-shadow;\n      }\n\n      ~ .form-check-label {\n        color: $color;\n      }\n    }\n  }\n  .form-check-inline .form-check-input {\n    ~ .#{$state}-feedback {\n      margin-left: .5em;\n    }\n  }\n\n  .input-group .form-control,\n  .input-group .form-select {\n    @include form-validation-state-selector($state) {\n      @if $state == \"valid\" {\n        z-index: 1;\n      } @else if $state == \"invalid\" {\n        z-index: 2;\n      }\n      &:focus {\n        z-index: 3;\n      }\n    }\n  }\n}\n// scss-docs-end form-validation-mixins\n","//\n// Base styles\n//\n\n.btn {\n  display: inline-block;\n  font-family: $btn-font-family;\n  font-weight: $btn-font-weight;\n  line-height: $btn-line-height;\n  color: $body-color;\n  text-align: center;\n  text-decoration: if($link-decoration == none, null, none);\n  white-space: $btn-white-space;\n  vertical-align: middle;\n  cursor: if($enable-button-pointers, pointer, null);\n  user-select: none;\n  background-color: transparent;\n  border: $btn-border-width solid transparent;\n  @include button-size($btn-padding-y, $btn-padding-x, $btn-font-size, $btn-border-radius);\n  @include transition($btn-transition);\n\n  &:hover {\n    color: $body-color;\n    text-decoration: if($link-hover-decoration == underline, none, null);\n  }\n\n  .btn-check:focus + &,\n  &:focus {\n    outline: 0;\n    box-shadow: $btn-focus-box-shadow;\n  }\n\n  .btn-check:checked + &,\n  .btn-check:active + &,\n  &:active,\n  &.active {\n    @include box-shadow($btn-active-box-shadow);\n\n    &:focus {\n      @include box-shadow($btn-focus-box-shadow, $btn-active-box-shadow);\n    }\n  }\n\n  &:disabled,\n  &.disabled,\n  fieldset:disabled & {\n    pointer-events: none;\n    opacity: $btn-disabled-opacity;\n    @include box-shadow(none);\n  }\n}\n\n\n//\n// Alternate buttons\n//\n\n// scss-docs-start btn-variant-loops\n@each $color, $value in $theme-colors {\n  .btn-#{$color} {\n    @include button-variant($value, $value);\n  }\n}\n\n@each $color, $value in $theme-colors {\n  .btn-outline-#{$color} {\n    @include button-outline-variant($value);\n  }\n}\n// scss-docs-end btn-variant-loops\n\n\n//\n// Link buttons\n//\n\n// Make a button look and behave like a link\n.btn-link {\n  font-weight: $font-weight-normal;\n  color: $btn-link-color;\n  text-decoration: $link-decoration;\n\n  &:hover {\n    color: $btn-link-hover-color;\n    text-decoration: $link-hover-decoration;\n  }\n\n  &:focus {\n    text-decoration: $link-hover-decoration;\n  }\n\n  &:disabled,\n  &.disabled {\n    color: $btn-link-disabled-color;\n  }\n\n  // No need for an active state here\n}\n\n\n//\n// Button Sizes\n//\n\n.btn-lg {\n  @include button-size($btn-padding-y-lg, $btn-padding-x-lg, $btn-font-size-lg, $btn-border-radius-lg);\n}\n\n.btn-sm {\n  @include button-size($btn-padding-y-sm, $btn-padding-x-sm, $btn-font-size-sm, $btn-border-radius-sm);\n}\n","// Button variants\n//\n// Easily pump out default styles, as well as :hover, :focus, :active,\n// and disabled options for all buttons\n\n// scss-docs-start btn-variant-mixin\n@mixin button-variant(\n  $background,\n  $border,\n  $color: color-contrast($background),\n  $hover-background: if($color == $color-contrast-light, shade-color($background, $btn-hover-bg-shade-amount), tint-color($background, $btn-hover-bg-tint-amount)),\n  $hover-border: if($color == $color-contrast-light, shade-color($border, $btn-hover-border-shade-amount), tint-color($border, $btn-hover-border-tint-amount)),\n  $hover-color: color-contrast($hover-background),\n  $active-background: if($color == $color-contrast-light, shade-color($background, $btn-active-bg-shade-amount), tint-color($background, $btn-active-bg-tint-amount)),\n  $active-border: if($color == $color-contrast-light, shade-color($border, $btn-active-border-shade-amount), tint-color($border, $btn-active-border-tint-amount)),\n  $active-color: color-contrast($active-background),\n  $disabled-background: $background,\n  $disabled-border: $border,\n  $disabled-color: color-contrast($disabled-background)\n) {\n  color: $color;\n  @include gradient-bg($background);\n  border-color: $border;\n  @include box-shadow($btn-box-shadow);\n\n  &:hover {\n    color: $hover-color;\n    @include gradient-bg($hover-background);\n    border-color: $hover-border;\n  }\n\n  .btn-check:focus + &,\n  &:focus {\n    color: $hover-color;\n    @include gradient-bg($hover-background);\n    border-color: $hover-border;\n    @if $enable-shadows {\n      @include box-shadow($btn-box-shadow, 0 0 0 $btn-focus-width rgba(mix($color, $border, 15%), .5));\n    } @else {\n      // Avoid using mixin so we can pass custom focus shadow properly\n      box-shadow: 0 0 0 $btn-focus-width rgba(mix($color, $border, 15%), .5);\n    }\n  }\n\n  .btn-check:checked + &,\n  .btn-check:active + &,\n  &:active,\n  &.active,\n  .show > &.dropdown-toggle {\n    color: $active-color;\n    background-color: $active-background;\n    // Remove CSS gradients if they're enabled\n    background-image: if($enable-gradients, none, null);\n    border-color: $active-border;\n\n    &:focus {\n      @if $enable-shadows {\n        @include box-shadow($btn-active-box-shadow, 0 0 0 $btn-focus-width rgba(mix($color, $border, 15%), .5));\n      } @else {\n        // Avoid using mixin so we can pass custom focus shadow properly\n        box-shadow: 0 0 0 $btn-focus-width rgba(mix($color, $border, 15%), .5);\n      }\n    }\n  }\n\n  &:disabled,\n  &.disabled {\n    color: $disabled-color;\n    background-color: $disabled-background;\n    // Remove CSS gradients if they're enabled\n    background-image: if($enable-gradients, none, null);\n    border-color: $disabled-border;\n  }\n}\n// scss-docs-end btn-variant-mixin\n\n// scss-docs-start btn-outline-variant-mixin\n@mixin button-outline-variant(\n  $color,\n  $color-hover: color-contrast($color),\n  $active-background: $color,\n  $active-border: $color,\n  $active-color: color-contrast($active-background)\n) {\n  color: $color;\n  border-color: $color;\n\n  &:hover {\n    color: $color-hover;\n    background-color: $active-background;\n    border-color: $active-border;\n  }\n\n  .btn-check:focus + &,\n  &:focus {\n    box-shadow: 0 0 0 $btn-focus-width rgba($color, .5);\n  }\n\n  .btn-check:checked + &,\n  .btn-check:active + &,\n  &:active,\n  &.active,\n  &.dropdown-toggle.show {\n    color: $active-color;\n    background-color: $active-background;\n    border-color: $active-border;\n\n    &:focus {\n      @if $enable-shadows {\n        @include box-shadow($btn-active-box-shadow, 0 0 0 $btn-focus-width rgba($color, .5));\n      } @else {\n        // Avoid using mixin so we can pass custom focus shadow properly\n        box-shadow: 0 0 0 $btn-focus-width rgba($color, .5);\n      }\n    }\n  }\n\n  &:disabled,\n  &.disabled {\n    color: $color;\n    background-color: transparent;\n  }\n}\n// scss-docs-end btn-outline-variant-mixin\n\n// scss-docs-start btn-size-mixin\n@mixin button-size($padding-y, $padding-x, $font-size, $border-radius) {\n  padding: $padding-y $padding-x;\n  @include font-size($font-size);\n  // Manually declare to provide an override to the browser default\n  @include border-radius($border-radius, 0);\n}\n// scss-docs-end btn-size-mixin\n",".fade {\n  @include transition($transition-fade);\n\n  &:not(.show) {\n    opacity: 0;\n  }\n}\n\n// scss-docs-start collapse-classes\n.collapse {\n  &:not(.show) {\n    display: none;\n  }\n}\n\n.collapsing {\n  height: 0;\n  overflow: hidden;\n  @include transition($transition-collapse);\n\n  &.collapse-horizontal {\n    width: 0;\n    height: auto;\n    @include transition($transition-collapse-width);\n  }\n}\n// scss-docs-end collapse-classes\n","// The dropdown wrapper (`<div>`)\n.dropup,\n.dropend,\n.dropdown,\n.dropstart {\n  position: relative;\n}\n\n.dropdown-toggle {\n  white-space: nowrap;\n\n  // Generate the caret automatically\n  @include caret();\n}\n\n// The dropdown menu\n.dropdown-menu {\n  position: absolute;\n  z-index: $zindex-dropdown;\n  display: none; // none by default, but block on \"open\" of the menu\n  min-width: $dropdown-min-width;\n  padding: $dropdown-padding-y $dropdown-padding-x;\n  margin: 0; // Override default margin of ul\n  @include font-size($dropdown-font-size);\n  color: $dropdown-color;\n  text-align: left; // Ensures proper alignment if parent has it changed (e.g., modal footer)\n  list-style: none;\n  background-color: $dropdown-bg;\n  background-clip: padding-box;\n  border: $dropdown-border-width solid $dropdown-border-color;\n  @include border-radius($dropdown-border-radius);\n  @include box-shadow($dropdown-box-shadow);\n\n  &[data-bs-popper] {\n    top: 100%;\n    left: 0;\n    margin-top: $dropdown-spacer;\n  }\n}\n\n// scss-docs-start responsive-breakpoints\n// We deliberately hardcode the `bs-` prefix because we check\n// this custom property in JS to determine Popper's positioning\n\n@each $breakpoint in map-keys($grid-breakpoints) {\n  @include media-breakpoint-up($breakpoint) {\n    $infix: breakpoint-infix($breakpoint, $grid-breakpoints);\n\n    .dropdown-menu#{$infix}-start {\n      --bs-position: start;\n\n      &[data-bs-popper] {\n        right: auto;\n        left: 0;\n      }\n    }\n\n    .dropdown-menu#{$infix}-end {\n      --bs-position: end;\n\n      &[data-bs-popper] {\n        right: 0;\n        left: auto;\n      }\n    }\n  }\n}\n// scss-docs-end responsive-breakpoints\n\n// Allow for dropdowns to go bottom up (aka, dropup-menu)\n// Just add .dropup after the standard .dropdown class and you're set.\n.dropup {\n  .dropdown-menu[data-bs-popper] {\n    top: auto;\n    bottom: 100%;\n    margin-top: 0;\n    margin-bottom: $dropdown-spacer;\n  }\n\n  .dropdown-toggle {\n    @include caret(up);\n  }\n}\n\n.dropend {\n  .dropdown-menu[data-bs-popper] {\n    top: 0;\n    right: auto;\n    left: 100%;\n    margin-top: 0;\n    margin-left: $dropdown-spacer;\n  }\n\n  .dropdown-toggle {\n    @include caret(end);\n    &::after {\n      vertical-align: 0;\n    }\n  }\n}\n\n.dropstart {\n  .dropdown-menu[data-bs-popper] {\n    top: 0;\n    right: 100%;\n    left: auto;\n    margin-top: 0;\n    margin-right: $dropdown-spacer;\n  }\n\n  .dropdown-toggle {\n    @include caret(start);\n    &::before {\n      vertical-align: 0;\n    }\n  }\n}\n\n\n// Dividers (basically an `<hr>`) within the dropdown\n.dropdown-divider {\n  height: 0;\n  margin: $dropdown-divider-margin-y 0;\n  overflow: hidden;\n  border-top: 1px solid $dropdown-divider-bg;\n}\n\n// Links, buttons, and more within the dropdown menu\n//\n// `<button>`-specific styles are denoted with `// For <button>s`\n.dropdown-item {\n  display: block;\n  width: 100%; // For `<button>`s\n  padding: $dropdown-item-padding-y $dropdown-item-padding-x;\n  clear: both;\n  font-weight: $font-weight-normal;\n  color: $dropdown-link-color;\n  text-align: inherit; // For `<button>`s\n  text-decoration: if($link-decoration == none, null, none);\n  white-space: nowrap; // prevent links from randomly breaking onto new lines\n  background-color: transparent; // For `<button>`s\n  border: 0; // For `<button>`s\n\n  // Prevent dropdown overflow if there's no padding\n  // See https://github.com/twbs/bootstrap/pull/27703\n  @if $dropdown-padding-y == 0 {\n    &:first-child {\n      @include border-top-radius($dropdown-inner-border-radius);\n    }\n\n    &:last-child {\n      @include border-bottom-radius($dropdown-inner-border-radius);\n    }\n  }\n\n  &:hover,\n  &:focus {\n    color: $dropdown-link-hover-color;\n    text-decoration: if($link-hover-decoration == underline, none, null);\n    @include gradient-bg($dropdown-link-hover-bg);\n  }\n\n  &.active,\n  &:active {\n    color: $dropdown-link-active-color;\n    text-decoration: none;\n    @include gradient-bg($dropdown-link-active-bg);\n  }\n\n  &.disabled,\n  &:disabled {\n    color: $dropdown-link-disabled-color;\n    pointer-events: none;\n    background-color: transparent;\n    // Remove CSS gradients if they're enabled\n    background-image: if($enable-gradients, none, null);\n  }\n}\n\n.dropdown-menu.show {\n  display: block;\n}\n\n// Dropdown section headers\n.dropdown-header {\n  display: block;\n  padding: $dropdown-header-padding;\n  margin-bottom: 0; // for use with heading elements\n  @include font-size($font-size-sm);\n  color: $dropdown-header-color;\n  white-space: nowrap; // as with > li > a\n}\n\n// Dropdown text\n.dropdown-item-text {\n  display: block;\n  padding: $dropdown-item-padding-y $dropdown-item-padding-x;\n  color: $dropdown-link-color;\n}\n\n// Dark dropdowns\n.dropdown-menu-dark {\n  color: $dropdown-dark-color;\n  background-color: $dropdown-dark-bg;\n  border-color: $dropdown-dark-border-color;\n  @include box-shadow($dropdown-dark-box-shadow);\n\n  .dropdown-item {\n    color: $dropdown-dark-link-color;\n\n    &:hover,\n    &:focus {\n      color: $dropdown-dark-link-hover-color;\n      @include gradient-bg($dropdown-dark-link-hover-bg);\n    }\n\n    &.active,\n    &:active {\n      color: $dropdown-dark-link-active-color;\n      @include gradient-bg($dropdown-dark-link-active-bg);\n    }\n\n    &.disabled,\n    &:disabled {\n      color: $dropdown-dark-link-disabled-color;\n    }\n  }\n\n  .dropdown-divider {\n    border-color: $dropdown-dark-divider-bg;\n  }\n\n  .dropdown-item-text {\n    color: $dropdown-dark-link-color;\n  }\n\n  .dropdown-header {\n    color: $dropdown-dark-header-color;\n  }\n}\n","// scss-docs-start caret-mixins\n@mixin caret-down {\n  border-top: $caret-width solid;\n  border-right: $caret-width solid transparent;\n  border-bottom: 0;\n  border-left: $caret-width solid transparent;\n}\n\n@mixin caret-up {\n  border-top: 0;\n  border-right: $caret-width solid transparent;\n  border-bottom: $caret-width solid;\n  border-left: $caret-width solid transparent;\n}\n\n@mixin caret-end {\n  border-top: $caret-width solid transparent;\n  border-right: 0;\n  border-bottom: $caret-width solid transparent;\n  border-left: $caret-width solid;\n}\n\n@mixin caret-start {\n  border-top: $caret-width solid transparent;\n  border-right: $caret-width solid;\n  border-bottom: $caret-width solid transparent;\n}\n\n@mixin caret($direction: down) {\n  @if $enable-caret {\n    &::after {\n      display: inline-block;\n      margin-left: $caret-spacing;\n      vertical-align: $caret-vertical-align;\n      content: \"\";\n      @if $direction == down {\n        @include caret-down();\n      } @else if $direction == up {\n        @include caret-up();\n      } @else if $direction == end {\n        @include caret-end();\n      }\n    }\n\n    @if $direction == start {\n      &::after {\n        display: none;\n      }\n\n      &::before {\n        display: inline-block;\n        margin-right: $caret-spacing;\n        vertical-align: $caret-vertical-align;\n        content: \"\";\n        @include caret-start();\n      }\n    }\n\n    &:empty::after {\n      margin-left: 0;\n    }\n  }\n}\n// scss-docs-end caret-mixins\n","// Make the div behave like a button\n.btn-group,\n.btn-group-vertical {\n  position: relative;\n  display: inline-flex;\n  vertical-align: middle; // match .btn alignment given font-size hack above\n\n  > .btn {\n    position: relative;\n    flex: 1 1 auto;\n  }\n\n  // Bring the hover, focused, and \"active\" buttons to the front to overlay\n  // the borders properly\n  > .btn-check:checked + .btn,\n  > .btn-check:focus + .btn,\n  > .btn:hover,\n  > .btn:focus,\n  > .btn:active,\n  > .btn.active {\n    z-index: 1;\n  }\n}\n\n// Optional: Group multiple button groups together for a toolbar\n.btn-toolbar {\n  display: flex;\n  flex-wrap: wrap;\n  justify-content: flex-start;\n\n  .input-group {\n    width: auto;\n  }\n}\n\n.btn-group {\n  // Prevent double borders when buttons are next to each other\n  > .btn:not(:first-child),\n  > .btn-group:not(:first-child) {\n    margin-left: -$btn-border-width;\n  }\n\n  // Reset rounded corners\n  > .btn:not(:last-child):not(.dropdown-toggle),\n  > .btn-group:not(:last-child) > .btn {\n    @include border-end-radius(0);\n  }\n\n  // The left radius should be 0 if the button is:\n  // - the \"third or more\" child\n  // - the second child and the previous element isn't `.btn-check` (making it the first child visually)\n  // - part of a btn-group which isn't the first child\n  > .btn:nth-child(n + 3),\n  > :not(.btn-check) + .btn,\n  > .btn-group:not(:first-child) > .btn {\n    @include border-start-radius(0);\n  }\n}\n\n// Sizing\n//\n// Remix the default button sizing classes into new ones for easier manipulation.\n\n.btn-group-sm > .btn { @extend .btn-sm; }\n.btn-group-lg > .btn { @extend .btn-lg; }\n\n\n//\n// Split button dropdowns\n//\n\n.dropdown-toggle-split {\n  padding-right: $btn-padding-x * .75;\n  padding-left: $btn-padding-x * .75;\n\n  &::after,\n  .dropup &::after,\n  .dropend &::after {\n    margin-left: 0;\n  }\n\n  .dropstart &::before {\n    margin-right: 0;\n  }\n}\n\n.btn-sm + .dropdown-toggle-split {\n  padding-right: $btn-padding-x-sm * .75;\n  padding-left: $btn-padding-x-sm * .75;\n}\n\n.btn-lg + .dropdown-toggle-split {\n  padding-right: $btn-padding-x-lg * .75;\n  padding-left: $btn-padding-x-lg * .75;\n}\n\n\n// The clickable button for toggling the menu\n// Set the same inset shadow as the :active state\n.btn-group.show .dropdown-toggle {\n  @include box-shadow($btn-active-box-shadow);\n\n  // Show no shadow for `.btn-link` since it has no other button styles.\n  &.btn-link {\n    @include box-shadow(none);\n  }\n}\n\n\n//\n// Vertical button groups\n//\n\n.btn-group-vertical {\n  flex-direction: column;\n  align-items: flex-start;\n  justify-content: center;\n\n  > .btn,\n  > .btn-group {\n    width: 100%;\n  }\n\n  > .btn:not(:first-child),\n  > .btn-group:not(:first-child) {\n    margin-top: -$btn-border-width;\n  }\n\n  // Reset rounded corners\n  > .btn:not(:last-child):not(.dropdown-toggle),\n  > .btn-group:not(:last-child) > .btn {\n    @include border-bottom-radius(0);\n  }\n\n  > .btn ~ .btn,\n  > .btn-group:not(:first-child) > .btn {\n    @include border-top-radius(0);\n  }\n}\n","// Base class\n//\n// Kickstart any navigation component with a set of style resets. Works with\n// `<nav>`s, `<ul>`s or `<ol>`s.\n\n.nav {\n  display: flex;\n  flex-wrap: wrap;\n  padding-left: 0;\n  margin-bottom: 0;\n  list-style: none;\n}\n\n.nav-link {\n  display: block;\n  padding: $nav-link-padding-y $nav-link-padding-x;\n  @include font-size($nav-link-font-size);\n  font-weight: $nav-link-font-weight;\n  color: $nav-link-color;\n  text-decoration: if($link-decoration == none, null, none);\n  @include transition($nav-link-transition);\n\n  &:hover,\n  &:focus {\n    color: $nav-link-hover-color;\n    text-decoration: if($link-hover-decoration == underline, none, null);\n  }\n\n  // Disabled state lightens text\n  &.disabled {\n    color: $nav-link-disabled-color;\n    pointer-events: none;\n    cursor: default;\n  }\n}\n\n//\n// Tabs\n//\n\n.nav-tabs {\n  border-bottom: $nav-tabs-border-width solid $nav-tabs-border-color;\n\n  .nav-link {\n    margin-bottom: -$nav-tabs-border-width;\n    background: none;\n    border: $nav-tabs-border-width solid transparent;\n    @include border-top-radius($nav-tabs-border-radius);\n\n    &:hover,\n    &:focus {\n      border-color: $nav-tabs-link-hover-border-color;\n      // Prevents active .nav-link tab overlapping focus outline of previous/next .nav-link\n      isolation: isolate;\n    }\n\n    &.disabled {\n      color: $nav-link-disabled-color;\n      background-color: transparent;\n      border-color: transparent;\n    }\n  }\n\n  .nav-link.active,\n  .nav-item.show .nav-link {\n    color: $nav-tabs-link-active-color;\n    background-color: $nav-tabs-link-active-bg;\n    border-color: $nav-tabs-link-active-border-color;\n  }\n\n  .dropdown-menu {\n    // Make dropdown border overlap tab border\n    margin-top: -$nav-tabs-border-width;\n    // Remove the top rounded corners here since there is a hard edge above the menu\n    @include border-top-radius(0);\n  }\n}\n\n\n//\n// Pills\n//\n\n.nav-pills {\n  .nav-link {\n    background: none;\n    border: 0;\n    @include border-radius($nav-pills-border-radius);\n  }\n\n  .nav-link.active,\n  .show > .nav-link {\n    color: $nav-pills-link-active-color;\n    @include gradient-bg($nav-pills-link-active-bg);\n  }\n}\n\n\n//\n// Justified variants\n//\n\n.nav-fill {\n  > .nav-link,\n  .nav-item {\n    flex: 1 1 auto;\n    text-align: center;\n  }\n}\n\n.nav-justified {\n  > .nav-link,\n  .nav-item {\n    flex-basis: 0;\n    flex-grow: 1;\n    text-align: center;\n  }\n}\n\n.nav-fill,\n.nav-justified {\n  .nav-item .nav-link {\n    width: 100%; // Make sure button will grow\n  }\n}\n\n\n// Tabbable tabs\n//\n// Hide tabbable panes to start, show them when `.active`\n\n.tab-content {\n  > .tab-pane {\n    display: none;\n  }\n  > .active {\n    display: block;\n  }\n}\n","// Contents\n//\n// Navbar\n// Navbar brand\n// Navbar nav\n// Navbar text\n// Responsive navbar\n// Navbar position\n// Navbar themes\n\n\n// Navbar\n//\n// Provide a static navbar from which we expand to create full-width, fixed, and\n// other navbar variations.\n\n.navbar {\n  position: relative;\n  display: flex;\n  flex-wrap: wrap; // allow us to do the line break for collapsing content\n  align-items: center;\n  justify-content: space-between; // space out brand from logo\n  padding-top: $navbar-padding-y;\n  padding-right: $navbar-padding-x; // default: null\n  padding-bottom: $navbar-padding-y;\n  padding-left: $navbar-padding-x; // default: null\n  @include gradient-bg();\n\n  // Because flex properties aren't inherited, we need to redeclare these first\n  // few properties so that content nested within behave properly.\n  // The `flex-wrap` property is inherited to simplify the expanded navbars\n  %container-flex-properties {\n    display: flex;\n    flex-wrap: inherit;\n    align-items: center;\n    justify-content: space-between;\n  }\n\n  > .container,\n  > .container-fluid {\n    @extend %container-flex-properties;\n  }\n\n  @each $breakpoint, $container-max-width in $container-max-widths {\n    > .container#{breakpoint-infix($breakpoint, $container-max-widths)} {\n      @extend %container-flex-properties;\n    }\n  }\n}\n\n\n// Navbar brand\n//\n// Used for brand, project, or site names.\n\n.navbar-brand {\n  padding-top: $navbar-brand-padding-y;\n  padding-bottom: $navbar-brand-padding-y;\n  margin-right: $navbar-brand-margin-end;\n  @include font-size($navbar-brand-font-size);\n  text-decoration: if($link-decoration == none, null, none);\n  white-space: nowrap;\n\n  &:hover,\n  &:focus {\n    text-decoration: if($link-hover-decoration == underline, none, null);\n  }\n}\n\n\n// Navbar nav\n//\n// Custom navbar navigation (doesn't require `.nav`, but does make use of `.nav-link`).\n\n.navbar-nav {\n  display: flex;\n  flex-direction: column; // cannot use `inherit` to get the `.navbar`s value\n  padding-left: 0;\n  margin-bottom: 0;\n  list-style: none;\n\n  .nav-link {\n    padding-right: 0;\n    padding-left: 0;\n  }\n\n  .dropdown-menu {\n    position: static;\n  }\n}\n\n\n// Navbar text\n//\n//\n\n.navbar-text {\n  padding-top: $nav-link-padding-y;\n  padding-bottom: $nav-link-padding-y;\n}\n\n\n// Responsive navbar\n//\n// Custom styles for responsive collapsing and toggling of navbar contents.\n// Powered by the collapse Bootstrap JavaScript plugin.\n\n// When collapsed, prevent the toggleable navbar contents from appearing in\n// the default flexbox row orientation. Requires the use of `flex-wrap: wrap`\n// on the `.navbar` parent.\n.navbar-collapse {\n  flex-basis: 100%;\n  flex-grow: 1;\n  // For always expanded or extra full navbars, ensure content aligns itself\n  // properly vertically. Can be easily overridden with flex utilities.\n  align-items: center;\n}\n\n// Button for toggling the navbar when in its collapsed state\n.navbar-toggler {\n  padding: $navbar-toggler-padding-y $navbar-toggler-padding-x;\n  @include font-size($navbar-toggler-font-size);\n  line-height: 1;\n  background-color: transparent; // remove default button style\n  border: $border-width solid transparent; // remove default button style\n  @include border-radius($navbar-toggler-border-radius);\n  @include transition($navbar-toggler-transition);\n\n  &:hover {\n    text-decoration: none;\n  }\n\n  &:focus {\n    text-decoration: none;\n    outline: 0;\n    box-shadow: 0 0 0 $navbar-toggler-focus-width;\n  }\n}\n\n// Keep as a separate element so folks can easily override it with another icon\n// or image file as needed.\n.navbar-toggler-icon {\n  display: inline-block;\n  width: 1.5em;\n  height: 1.5em;\n  vertical-align: middle;\n  background-repeat: no-repeat;\n  background-position: center;\n  background-size: 100%;\n}\n\n.navbar-nav-scroll {\n  max-height: var(--#{$variable-prefix}scroll-height, 75vh);\n  overflow-y: auto;\n}\n\n// scss-docs-start navbar-expand-loop\n// Generate series of `.navbar-expand-*` responsive classes for configuring\n// where your navbar collapses.\n.navbar-expand {\n  @each $breakpoint in map-keys($grid-breakpoints) {\n    $next: breakpoint-next($breakpoint, $grid-breakpoints);\n    $infix: breakpoint-infix($next, $grid-breakpoints);\n\n    // stylelint-disable-next-line scss/selector-no-union-class-name\n    &#{$infix} {\n      @include media-breakpoint-up($next) {\n        flex-wrap: nowrap;\n        justify-content: flex-start;\n\n        .navbar-nav {\n          flex-direction: row;\n\n          .dropdown-menu {\n            position: absolute;\n          }\n\n          .nav-link {\n            padding-right: $navbar-nav-link-padding-x;\n            padding-left: $navbar-nav-link-padding-x;\n          }\n        }\n\n        .navbar-nav-scroll {\n          overflow: visible;\n        }\n\n        .navbar-collapse {\n          display: flex !important; // stylelint-disable-line declaration-no-important\n          flex-basis: auto;\n        }\n\n        .navbar-toggler {\n          display: none;\n        }\n\n        .offcanvas-header {\n          display: none;\n        }\n\n        .offcanvas {\n          position: inherit;\n          bottom: 0;\n          z-index: 1000;\n          flex-grow: 1;\n          visibility: visible !important; // stylelint-disable-line declaration-no-important\n          background-color: transparent;\n          border-right: 0;\n          border-left: 0;\n          @include transition(none);\n          transform: none;\n        }\n        .offcanvas-top,\n        .offcanvas-bottom {\n          height: auto;\n          border-top: 0;\n          border-bottom: 0;\n        }\n\n        .offcanvas-body {\n          display: flex;\n          flex-grow: 0;\n          padding: 0;\n          overflow-y: visible;\n        }\n      }\n    }\n  }\n}\n// scss-docs-end navbar-expand-loop\n\n// Navbar themes\n//\n// Styles for switching between navbars with light or dark background.\n\n// Dark links against a light background\n.navbar-light {\n  .navbar-brand {\n    color: $navbar-light-brand-color;\n\n    &:hover,\n    &:focus {\n      color: $navbar-light-brand-hover-color;\n    }\n  }\n\n  .navbar-nav {\n    .nav-link {\n      color: $navbar-light-color;\n\n      &:hover,\n      &:focus {\n        color: $navbar-light-hover-color;\n      }\n\n      &.disabled {\n        color: $navbar-light-disabled-color;\n      }\n    }\n\n    .show > .nav-link,\n    .nav-link.active {\n      color: $navbar-light-active-color;\n    }\n  }\n\n  .navbar-toggler {\n    color: $navbar-light-color;\n    border-color: $navbar-light-toggler-border-color;\n  }\n\n  .navbar-toggler-icon {\n    background-image: escape-svg($navbar-light-toggler-icon-bg);\n  }\n\n  .navbar-text {\n    color: $navbar-light-color;\n\n    a,\n    a:hover,\n    a:focus  {\n      color: $navbar-light-active-color;\n    }\n  }\n}\n\n// White links against a dark background\n.navbar-dark {\n  .navbar-brand {\n    color: $navbar-dark-brand-color;\n\n    &:hover,\n    &:focus {\n      color: $navbar-dark-brand-hover-color;\n    }\n  }\n\n  .navbar-nav {\n    .nav-link {\n      color: $navbar-dark-color;\n\n      &:hover,\n      &:focus {\n        color: $navbar-dark-hover-color;\n      }\n\n      &.disabled {\n        color: $navbar-dark-disabled-color;\n      }\n    }\n\n    .show > .nav-link,\n    .nav-link.active {\n      color: $navbar-dark-active-color;\n    }\n  }\n\n  .navbar-toggler {\n    color: $navbar-dark-color;\n    border-color: $navbar-dark-toggler-border-color;\n  }\n\n  .navbar-toggler-icon {\n    background-image: escape-svg($navbar-dark-toggler-icon-bg);\n  }\n\n  .navbar-text {\n    color: $navbar-dark-color;\n    a,\n    a:hover,\n    a:focus {\n      color: $navbar-dark-active-color;\n    }\n  }\n}\n","//\n// Base styles\n//\n\n.card {\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  min-width: 0; // See https://github.com/twbs/bootstrap/pull/22740#issuecomment-305868106\n  height: $card-height;\n  word-wrap: break-word;\n  background-color: $card-bg;\n  background-clip: border-box;\n  border: $card-border-width solid $card-border-color;\n  @include border-radius($card-border-radius);\n  @include box-shadow($card-box-shadow);\n\n  > hr {\n    margin-right: 0;\n    margin-left: 0;\n  }\n\n  > .list-group {\n    border-top: inherit;\n    border-bottom: inherit;\n\n    &:first-child {\n      border-top-width: 0;\n      @include border-top-radius($card-inner-border-radius);\n    }\n\n    &:last-child  {\n      border-bottom-width: 0;\n      @include border-bottom-radius($card-inner-border-radius);\n    }\n  }\n\n  // Due to specificity of the above selector (`.card > .list-group`), we must\n  // use a child selector here to prevent double borders.\n  > .card-header + .list-group,\n  > .list-group + .card-footer {\n    border-top: 0;\n  }\n}\n\n.card-body {\n  // Enable `flex-grow: 1` for decks and groups so that card blocks take up\n  // as much space as possible, ensuring footers are aligned to the bottom.\n  flex: 1 1 auto;\n  padding: $card-spacer-y $card-spacer-x;\n  color: $card-color;\n}\n\n.card-title {\n  margin-bottom: $card-title-spacer-y;\n}\n\n.card-subtitle {\n  margin-top: -$card-title-spacer-y * .5;\n  margin-bottom: 0;\n}\n\n.card-text:last-child {\n  margin-bottom: 0;\n}\n\n.card-link {\n  &:hover {\n    text-decoration: if($link-hover-decoration == underline, none, null);\n  }\n\n  + .card-link {\n    margin-left: $card-spacer-x;\n  }\n}\n\n//\n// Optional textual caps\n//\n\n.card-header {\n  padding: $card-cap-padding-y $card-cap-padding-x;\n  margin-bottom: 0; // Removes the default margin-bottom of <hN>\n  color: $card-cap-color;\n  background-color: $card-cap-bg;\n  border-bottom: $card-border-width solid $card-border-color;\n\n  &:first-child {\n    @include border-radius($card-inner-border-radius $card-inner-border-radius 0 0);\n  }\n}\n\n.card-footer {\n  padding: $card-cap-padding-y $card-cap-padding-x;\n  color: $card-cap-color;\n  background-color: $card-cap-bg;\n  border-top: $card-border-width solid $card-border-color;\n\n  &:last-child {\n    @include border-radius(0 0 $card-inner-border-radius $card-inner-border-radius);\n  }\n}\n\n\n//\n// Header navs\n//\n\n.card-header-tabs {\n  margin-right: -$card-cap-padding-x * .5;\n  margin-bottom: -$card-cap-padding-y;\n  margin-left: -$card-cap-padding-x * .5;\n  border-bottom: 0;\n\n  @if $nav-tabs-link-active-bg != $card-bg {\n    .nav-link.active {\n      background-color: $card-bg;\n      border-bottom-color: $card-bg;\n    }\n  }\n}\n\n.card-header-pills {\n  margin-right: -$card-cap-padding-x * .5;\n  margin-left: -$card-cap-padding-x * .5;\n}\n\n// Card image\n.card-img-overlay {\n  position: absolute;\n  top: 0;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  padding: $card-img-overlay-padding;\n  @include border-radius($card-inner-border-radius);\n}\n\n.card-img,\n.card-img-top,\n.card-img-bottom {\n  width: 100%; // Required because we use flexbox and this inherently applies align-self: stretch\n}\n\n.card-img,\n.card-img-top {\n  @include border-top-radius($card-inner-border-radius);\n}\n\n.card-img,\n.card-img-bottom {\n  @include border-bottom-radius($card-inner-border-radius);\n}\n\n\n//\n// Card groups\n//\n\n.card-group {\n  // The child selector allows nested `.card` within `.card-group`\n  // to display properly.\n  > .card {\n    margin-bottom: $card-group-margin;\n  }\n\n  @include media-breakpoint-up(sm) {\n    display: flex;\n    flex-flow: row wrap;\n    // The child selector allows nested `.card` within `.card-group`\n    // to display properly.\n    > .card {\n      // Flexbugs #4: https://github.com/philipwalton/flexbugs#flexbug-4\n      flex: 1 0 0%;\n      margin-bottom: 0;\n\n      + .card {\n        margin-left: 0;\n        border-left: 0;\n      }\n\n      // Handle rounded corners\n      @if $enable-rounded {\n        &:not(:last-child) {\n          @include border-end-radius(0);\n\n          .card-img-top,\n          .card-header {\n            // stylelint-disable-next-line property-disallowed-list\n            border-top-right-radius: 0;\n          }\n          .card-img-bottom,\n          .card-footer {\n            // stylelint-disable-next-line property-disallowed-list\n            border-bottom-right-radius: 0;\n          }\n        }\n\n        &:not(:first-child) {\n          @include border-start-radius(0);\n\n          .card-img-top,\n          .card-header {\n            // stylelint-disable-next-line property-disallowed-list\n            border-top-left-radius: 0;\n          }\n          .card-img-bottom,\n          .card-footer {\n            // stylelint-disable-next-line property-disallowed-list\n            border-bottom-left-radius: 0;\n          }\n        }\n      }\n    }\n  }\n}\n","//\n// Base styles\n//\n\n.accordion-button {\n  position: relative;\n  display: flex;\n  align-items: center;\n  width: 100%;\n  padding: $accordion-button-padding-y $accordion-button-padding-x;\n  @include font-size($font-size-base);\n  color: $accordion-button-color;\n  text-align: left; // Reset button style\n  background-color: $accordion-button-bg;\n  border: 0;\n  @include border-radius(0);\n  overflow-anchor: none;\n  @include transition($accordion-transition);\n\n  &:not(.collapsed) {\n    color: $accordion-button-active-color;\n    background-color: $accordion-button-active-bg;\n    box-shadow: inset 0 ($accordion-border-width * -1) 0 $accordion-border-color;\n\n    &::after {\n      background-image: escape-svg($accordion-button-active-icon);\n      transform: $accordion-icon-transform;\n    }\n  }\n\n  // Accordion icon\n  &::after {\n    flex-shrink: 0;\n    width: $accordion-icon-width;\n    height: $accordion-icon-width;\n    margin-left: auto;\n    content: \"\";\n    background-image: escape-svg($accordion-button-icon);\n    background-repeat: no-repeat;\n    background-size: $accordion-icon-width;\n    @include transition($accordion-icon-transition);\n  }\n\n  &:hover {\n    z-index: 2;\n  }\n\n  &:focus {\n    z-index: 3;\n    border-color: $accordion-button-focus-border-color;\n    outline: 0;\n    box-shadow: $accordion-button-focus-box-shadow;\n  }\n}\n\n.accordion-header {\n  margin-bottom: 0;\n}\n\n.accordion-item {\n  background-color: $accordion-bg;\n  border: $accordion-border-width solid $accordion-border-color;\n\n  &:first-of-type {\n    @include border-top-radius($accordion-border-radius);\n\n    .accordion-button {\n      @include border-top-radius($accordion-inner-border-radius);\n    }\n  }\n\n  &:not(:first-of-type) {\n    border-top: 0;\n  }\n\n  // Only set a border-radius on the last item if the accordion is collapsed\n  &:last-of-type {\n    @include border-bottom-radius($accordion-border-radius);\n\n    .accordion-button {\n      &.collapsed {\n        @include border-bottom-radius($accordion-inner-border-radius);\n      }\n    }\n\n    .accordion-collapse {\n      @include border-bottom-radius($accordion-border-radius);\n    }\n  }\n}\n\n.accordion-body {\n  padding: $accordion-body-padding-y $accordion-body-padding-x;\n}\n\n\n// Flush accordion items\n//\n// Remove borders and border-radius to keep accordion items edge-to-edge.\n\n.accordion-flush {\n  .accordion-collapse {\n    border-width: 0;\n  }\n\n  .accordion-item {\n    border-right: 0;\n    border-left: 0;\n    @include border-radius(0);\n\n    &:first-child { border-top: 0; }\n    &:last-child { border-bottom: 0; }\n\n    .accordion-button {\n      @include border-radius(0);\n    }\n  }\n}\n",".breadcrumb {\n  display: flex;\n  flex-wrap: wrap;\n  padding: $breadcrumb-padding-y $breadcrumb-padding-x;\n  margin-bottom: $breadcrumb-margin-bottom;\n  @include font-size($breadcrumb-font-size);\n  list-style: none;\n  background-color: $breadcrumb-bg;\n  @include border-radius($breadcrumb-border-radius);\n}\n\n.breadcrumb-item {\n  // The separator between breadcrumbs (by default, a forward-slash: \"/\")\n  + .breadcrumb-item {\n    padding-left: $breadcrumb-item-padding-x;\n\n    &::before {\n      float: left; // Suppress inline spacings and underlining of the separator\n      padding-right: $breadcrumb-item-padding-x;\n      color: $breadcrumb-divider-color;\n      content: var(--#{$variable-prefix}breadcrumb-divider, escape-svg($breadcrumb-divider)) #{\"/* rtl:\"} var(--#{$variable-prefix}breadcrumb-divider, escape-svg($breadcrumb-divider-flipped)) #{\"*/\"};\n    }\n  }\n\n  &.active {\n    color: $breadcrumb-active-color;\n  }\n}\n",".pagination {\n  display: flex;\n  @include list-unstyled();\n}\n\n.page-link {\n  position: relative;\n  display: block;\n  color: $pagination-color;\n  text-decoration: if($link-decoration == none, null, none);\n  background-color: $pagination-bg;\n  border: $pagination-border-width solid $pagination-border-color;\n  @include transition($pagination-transition);\n\n  &:hover {\n    z-index: 2;\n    color: $pagination-hover-color;\n    text-decoration: if($link-hover-decoration == underline, none, null);\n    background-color: $pagination-hover-bg;\n    border-color: $pagination-hover-border-color;\n  }\n\n  &:focus {\n    z-index: 3;\n    color: $pagination-focus-color;\n    background-color: $pagination-focus-bg;\n    outline: $pagination-focus-outline;\n    box-shadow: $pagination-focus-box-shadow;\n  }\n}\n\n.page-item {\n  &:not(:first-child) .page-link {\n    margin-left: $pagination-margin-start;\n  }\n\n  &.active .page-link {\n    z-index: 3;\n    color: $pagination-active-color;\n    @include gradient-bg($pagination-active-bg);\n    border-color: $pagination-active-border-color;\n  }\n\n  &.disabled .page-link {\n    color: $pagination-disabled-color;\n    pointer-events: none;\n    background-color: $pagination-disabled-bg;\n    border-color: $pagination-disabled-border-color;\n  }\n}\n\n\n//\n// Sizing\n//\n@include pagination-size($pagination-padding-y, $pagination-padding-x, null, $pagination-border-radius);\n\n.pagination-lg {\n  @include pagination-size($pagination-padding-y-lg, $pagination-padding-x-lg, $font-size-lg, $pagination-border-radius-lg);\n}\n\n.pagination-sm {\n  @include pagination-size($pagination-padding-y-sm, $pagination-padding-x-sm, $font-size-sm, $pagination-border-radius-sm);\n}\n","// Pagination\n\n// scss-docs-start pagination-mixin\n@mixin pagination-size($padding-y, $padding-x, $font-size, $border-radius) {\n  .page-link {\n    padding: $padding-y $padding-x;\n    @include font-size($font-size);\n  }\n\n  .page-item {\n    @if $pagination-margin-start == (-$pagination-border-width) {\n      &:first-child {\n        .page-link {\n          @include border-start-radius($border-radius);\n        }\n      }\n\n      &:last-child {\n        .page-link {\n          @include border-end-radius($border-radius);\n        }\n      }\n    } @else {\n      //Add border-radius to all pageLinks in case they have left margin\n      .page-link {\n        @include border-radius($border-radius);\n      }\n    }\n  }\n}\n// scss-docs-end pagination-mixin\n","// Base class\n//\n// Requires one of the contextual, color modifier classes for `color` and\n// `background-color`.\n\n.badge {\n  display: inline-block;\n  padding: $badge-padding-y $badge-padding-x;\n  @include font-size($badge-font-size);\n  font-weight: $badge-font-weight;\n  line-height: 1;\n  color: $badge-color;\n  text-align: center;\n  white-space: nowrap;\n  vertical-align: baseline;\n  @include border-radius($badge-border-radius);\n  @include gradient-bg();\n\n  // Empty badges collapse automatically\n  &:empty {\n    display: none;\n  }\n}\n\n// Quick fix for badges in buttons\n.btn .badge {\n  position: relative;\n  top: -1px;\n}\n","//\n// Base styles\n//\n\n.alert {\n  position: relative;\n  padding: $alert-padding-y $alert-padding-x;\n  margin-bottom: $alert-margin-bottom;\n  border: $alert-border-width solid transparent;\n  @include border-radius($alert-border-radius);\n}\n\n// Headings for larger alerts\n.alert-heading {\n  // Specified to prevent conflicts of changing $headings-color\n  color: inherit;\n}\n\n// Provide class for links that match alerts\n.alert-link {\n  font-weight: $alert-link-font-weight;\n}\n\n\n// Dismissible alerts\n//\n// Expand the right padding and account for the close button's positioning.\n\n.alert-dismissible {\n  padding-right: $alert-dismissible-padding-r;\n\n  // Adjust close link position\n  .btn-close {\n    position: absolute;\n    top: 0;\n    right: 0;\n    z-index: $stretched-link-z-index + 1;\n    padding: $alert-padding-y * 1.25 $alert-padding-x;\n  }\n}\n\n\n// scss-docs-start alert-modifiers\n// Generate contextual modifier classes for colorizing the alert.\n\n@each $state, $value in $theme-colors {\n  $alert-background: shift-color($value, $alert-bg-scale);\n  $alert-border: shift-color($value, $alert-border-scale);\n  $alert-color: shift-color($value, $alert-color-scale);\n  @if (contrast-ratio($alert-background, $alert-color) < $min-contrast-ratio) {\n    $alert-color: mix($value, color-contrast($alert-background), abs($alert-color-scale));\n  }\n  .alert-#{$state} {\n    @include alert-variant($alert-background, $alert-border, $alert-color);\n  }\n}\n// scss-docs-end alert-modifiers\n","// scss-docs-start alert-variant-mixin\n@mixin alert-variant($background, $border, $color) {\n  color: $color;\n  @include gradient-bg($background);\n  border-color: $border;\n\n  .alert-link {\n    color: shade-color($color, 20%);\n  }\n}\n// scss-docs-end alert-variant-mixin\n","// Disable animation if transitions are disabled\n\n// scss-docs-start progress-keyframes\n@if $enable-transitions {\n  @keyframes progress-bar-stripes {\n    0% { background-position-x: $progress-height; }\n  }\n}\n// scss-docs-end progress-keyframes\n\n.progress {\n  display: flex;\n  height: $progress-height;\n  overflow: hidden; // force rounded corners by cropping it\n  @include font-size($progress-font-size);\n  background-color: $progress-bg;\n  @include border-radius($progress-border-radius);\n  @include box-shadow($progress-box-shadow);\n}\n\n.progress-bar {\n  display: flex;\n  flex-direction: column;\n  justify-content: center;\n  overflow: hidden;\n  color: $progress-bar-color;\n  text-align: center;\n  white-space: nowrap;\n  background-color: $progress-bar-bg;\n  @include transition($progress-bar-transition);\n}\n\n.progress-bar-striped {\n  @include gradient-striped();\n  background-size: $progress-height $progress-height;\n}\n\n@if $enable-transitions {\n  .progress-bar-animated {\n    animation: $progress-bar-animation-timing progress-bar-stripes;\n\n    @if $enable-reduced-motion {\n      @media (prefers-reduced-motion: reduce) {\n        animation: none;\n      }\n    }\n  }\n}\n","// Base class\n//\n// Easily usable on <ul>, <ol>, or <div>.\n\n.list-group {\n  display: flex;\n  flex-direction: column;\n\n  // No need to set list-style: none; since .list-group-item is block level\n  padding-left: 0; // reset padding because ul and ol\n  margin-bottom: 0;\n  @include border-radius($list-group-border-radius);\n}\n\n.list-group-numbered {\n  list-style-type: none;\n  counter-reset: section;\n\n  > li::before {\n    // Increments only this instance of the section counter\n    content: counters(section, \".\") \". \";\n    counter-increment: section;\n  }\n}\n\n\n// Interactive list items\n//\n// Use anchor or button elements instead of `li`s or `div`s to create interactive\n// list items. Includes an extra `.active` modifier class for selected items.\n\n.list-group-item-action {\n  width: 100%; // For `<button>`s (anchors become 100% by default though)\n  color: $list-group-action-color;\n  text-align: inherit; // For `<button>`s (anchors inherit)\n\n  // Hover state\n  &:hover,\n  &:focus {\n    z-index: 1; // Place hover/focus items above their siblings for proper border styling\n    color: $list-group-action-hover-color;\n    text-decoration: none;\n    background-color: $list-group-hover-bg;\n  }\n\n  &:active {\n    color: $list-group-action-active-color;\n    background-color: $list-group-action-active-bg;\n  }\n}\n\n\n// Individual list items\n//\n// Use on `li`s or `div`s within the `.list-group` parent.\n\n.list-group-item {\n  position: relative;\n  display: block;\n  padding: $list-group-item-padding-y $list-group-item-padding-x;\n  color: $list-group-color;\n  text-decoration: if($link-decoration == none, null, none);\n  background-color: $list-group-bg;\n  border: $list-group-border-width solid $list-group-border-color;\n\n  &:first-child {\n    @include border-top-radius(inherit);\n  }\n\n  &:last-child {\n    @include border-bottom-radius(inherit);\n  }\n\n  &.disabled,\n  &:disabled {\n    color: $list-group-disabled-color;\n    pointer-events: none;\n    background-color: $list-group-disabled-bg;\n  }\n\n  // Include both here for `<a>`s and `<button>`s\n  &.active {\n    z-index: 2; // Place active items above their siblings for proper border styling\n    color: $list-group-active-color;\n    background-color: $list-group-active-bg;\n    border-color: $list-group-active-border-color;\n  }\n\n  & + & {\n    border-top-width: 0;\n\n    &.active {\n      margin-top: -$list-group-border-width;\n      border-top-width: $list-group-border-width;\n    }\n  }\n}\n\n\n// Horizontal\n//\n// Change the layout of list group items from vertical (default) to horizontal.\n\n@each $breakpoint in map-keys($grid-breakpoints) {\n  @include media-breakpoint-up($breakpoint) {\n    $infix: breakpoint-infix($breakpoint, $grid-breakpoints);\n\n    .list-group-horizontal#{$infix} {\n      flex-direction: row;\n\n      > .list-group-item {\n        &:first-child {\n          @include border-bottom-start-radius($list-group-border-radius);\n          @include border-top-end-radius(0);\n        }\n\n        &:last-child {\n          @include border-top-end-radius($list-group-border-radius);\n          @include border-bottom-start-radius(0);\n        }\n\n        &.active {\n          margin-top: 0;\n        }\n\n        + .list-group-item {\n          border-top-width: $list-group-border-width;\n          border-left-width: 0;\n\n          &.active {\n            margin-left: -$list-group-border-width;\n            border-left-width: $list-group-border-width;\n          }\n        }\n      }\n    }\n  }\n}\n\n\n// Flush list items\n//\n// Remove borders and border-radius to keep list group items edge-to-edge. Most\n// useful within other components (e.g., cards).\n\n.list-group-flush {\n  @include border-radius(0);\n\n  > .list-group-item {\n    border-width: 0 0 $list-group-border-width;\n\n    &:last-child {\n      border-bottom-width: 0;\n    }\n  }\n}\n\n\n// scss-docs-start list-group-modifiers\n// List group contextual variants\n//\n// Add modifier classes to change text and background color on individual items.\n// Organizationally, this must come after the `:hover` states.\n\n@each $state, $value in $theme-colors {\n  $list-group-variant-bg: shift-color($value, $list-group-item-bg-scale);\n  $list-group-variant-color: shift-color($value, $list-group-item-color-scale);\n  @if (contrast-ratio($list-group-variant-bg, $list-group-variant-color) < $min-contrast-ratio) {\n    $list-group-variant-color: mix($value, color-contrast($list-group-variant-bg), abs($list-group-item-color-scale));\n  }\n\n  @include list-group-item-variant($state, $list-group-variant-bg, $list-group-variant-color);\n}\n// scss-docs-end list-group-modifiers\n","// List Groups\n\n// scss-docs-start list-group-mixin\n@mixin list-group-item-variant($state, $background, $color) {\n  .list-group-item-#{$state} {\n    color: $color;\n    background-color: $background;\n\n    &.list-group-item-action {\n      &:hover,\n      &:focus {\n        color: $color;\n        background-color: shade-color($background, 10%);\n      }\n\n      &.active {\n        color: $white;\n        background-color: $color;\n        border-color: $color;\n      }\n    }\n  }\n}\n// scss-docs-end list-group-mixin\n","// transparent background and border properties included for button version.\n// iOS requires the button element instead of an anchor tag.\n// If you want the anchor version, it requires `href=\"#\"`.\n// See https://developer.mozilla.org/en-US/docs/Web/Events/click#Safari_Mobile\n\n.btn-close {\n  box-sizing: content-box;\n  width: $btn-close-width;\n  height: $btn-close-height;\n  padding: $btn-close-padding-y $btn-close-padding-x;\n  color: $btn-close-color;\n  background: transparent escape-svg($btn-close-bg) center / $btn-close-width auto no-repeat; // include transparent for button elements\n  border: 0; // for button elements\n  @include border-radius();\n  opacity: $btn-close-opacity;\n\n  // Override <a>'s hover style\n  &:hover {\n    color: $btn-close-color;\n    text-decoration: none;\n    opacity: $btn-close-hover-opacity;\n  }\n\n  &:focus {\n    outline: 0;\n    box-shadow: $btn-close-focus-shadow;\n    opacity: $btn-close-focus-opacity;\n  }\n\n  &:disabled,\n  &.disabled {\n    pointer-events: none;\n    user-select: none;\n    opacity: $btn-close-disabled-opacity;\n  }\n}\n\n.btn-close-white {\n  filter: $btn-close-white-filter;\n}\n",".toast {\n  width: $toast-max-width;\n  max-width: 100%;\n  @include font-size($toast-font-size);\n  color: $toast-color;\n  pointer-events: auto;\n  background-color: $toast-background-color;\n  background-clip: padding-box;\n  border: $toast-border-width solid $toast-border-color;\n  box-shadow: $toast-box-shadow;\n  @include border-radius($toast-border-radius);\n\n  &.showing {\n    opacity: 0;\n  }\n\n  &:not(.show) {\n    display: none;\n  }\n}\n\n.toast-container {\n  width: max-content;\n  max-width: 100%;\n  pointer-events: none;\n\n  > :not(:last-child) {\n    margin-bottom: $toast-spacing;\n  }\n}\n\n.toast-header {\n  display: flex;\n  align-items: center;\n  padding: $toast-padding-y $toast-padding-x;\n  color: $toast-header-color;\n  background-color: $toast-header-background-color;\n  background-clip: padding-box;\n  border-bottom: $toast-border-width solid $toast-header-border-color;\n  @include border-top-radius(subtract($toast-border-radius, $toast-border-width));\n\n  .btn-close {\n    margin-right: $toast-padding-x * -.5;\n    margin-left: $toast-padding-x;\n  }\n}\n\n.toast-body {\n  padding: $toast-padding-x; // apply to both vertical and horizontal\n  word-wrap: break-word;\n}\n","// .modal-open      - body class for killing the scroll\n// .modal           - container to scroll within\n// .modal-dialog    - positioning shell for the actual modal\n// .modal-content   - actual modal w/ bg and corners and stuff\n\n\n// Container that the modal scrolls within\n.modal {\n  position: fixed;\n  top: 0;\n  left: 0;\n  z-index: $zindex-modal;\n  display: none;\n  width: 100%;\n  height: 100%;\n  overflow-x: hidden;\n  overflow-y: auto;\n  // Prevent Chrome on Windows from adding a focus outline. For details, see\n  // https://github.com/twbs/bootstrap/pull/10951.\n  outline: 0;\n  // We deliberately don't use `-webkit-overflow-scrolling: touch;` due to a\n  // gnarly iOS Safari bug: https://bugs.webkit.org/show_bug.cgi?id=158342\n  // See also https://github.com/twbs/bootstrap/issues/17695\n}\n\n// Shell div to position the modal with bottom padding\n.modal-dialog {\n  position: relative;\n  width: auto;\n  margin: $modal-dialog-margin;\n  // allow clicks to pass through for custom click handling to close modal\n  pointer-events: none;\n\n  // When fading in the modal, animate it to slide down\n  .modal.fade & {\n    @include transition($modal-transition);\n    transform: $modal-fade-transform;\n  }\n  .modal.show & {\n    transform: $modal-show-transform;\n  }\n\n  // When trying to close, animate focus to scale\n  .modal.modal-static & {\n    transform: $modal-scale-transform;\n  }\n}\n\n.modal-dialog-scrollable {\n  height: subtract(100%, $modal-dialog-margin * 2);\n\n  .modal-content {\n    max-height: 100%;\n    overflow: hidden;\n  }\n\n  .modal-body {\n    overflow-y: auto;\n  }\n}\n\n.modal-dialog-centered {\n  display: flex;\n  align-items: center;\n  min-height: subtract(100%, $modal-dialog-margin * 2);\n}\n\n// Actual modal\n.modal-content {\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  width: 100%; // Ensure `.modal-content` extends the full width of the parent `.modal-dialog`\n  // counteract the pointer-events: none; in the .modal-dialog\n  color: $modal-content-color;\n  pointer-events: auto;\n  background-color: $modal-content-bg;\n  background-clip: padding-box;\n  border: $modal-content-border-width solid $modal-content-border-color;\n  @include border-radius($modal-content-border-radius);\n  @include box-shadow($modal-content-box-shadow-xs);\n  // Remove focus outline from opened modal\n  outline: 0;\n}\n\n// Modal background\n.modal-backdrop {\n  @include overlay-backdrop($zindex-modal-backdrop, $modal-backdrop-bg, $modal-backdrop-opacity);\n}\n\n// Modal header\n// Top section of the modal w/ title and dismiss\n.modal-header {\n  display: flex;\n  flex-shrink: 0;\n  align-items: center;\n  justify-content: space-between; // Put modal header elements (title and dismiss) on opposite ends\n  padding: $modal-header-padding;\n  border-bottom: $modal-header-border-width solid $modal-header-border-color;\n  @include border-top-radius($modal-content-inner-border-radius);\n\n  .btn-close {\n    padding: ($modal-header-padding-y * .5) ($modal-header-padding-x * .5);\n    margin: ($modal-header-padding-y * -.5) ($modal-header-padding-x * -.5) ($modal-header-padding-y * -.5) auto;\n  }\n}\n\n// Title text within header\n.modal-title {\n  margin-bottom: 0;\n  line-height: $modal-title-line-height;\n}\n\n// Modal body\n// Where all modal content resides (sibling of .modal-header and .modal-footer)\n.modal-body {\n  position: relative;\n  // Enable `flex-grow: 1` so that the body take up as much space as possible\n  // when there should be a fixed height on `.modal-dialog`.\n  flex: 1 1 auto;\n  padding: $modal-inner-padding;\n}\n\n// Footer (for actions)\n.modal-footer {\n  display: flex;\n  flex-wrap: wrap;\n  flex-shrink: 0;\n  align-items: center; // vertically center\n  justify-content: flex-end; // Right align buttons with flex property because text-align doesn't work on flex items\n  padding: $modal-inner-padding - $modal-footer-margin-between * .5;\n  border-top: $modal-footer-border-width solid $modal-footer-border-color;\n  @include border-bottom-radius($modal-content-inner-border-radius);\n\n  // Place margin between footer elements\n  // This solution is far from ideal because of the universal selector usage,\n  // but is needed to fix https://github.com/twbs/bootstrap/issues/24800\n  > * {\n    margin: $modal-footer-margin-between * .5;\n  }\n}\n\n// Scale up the modal\n@include media-breakpoint-up(sm) {\n  // Automatically set modal's width for larger viewports\n  .modal-dialog {\n    max-width: $modal-md;\n    margin: $modal-dialog-margin-y-sm-up auto;\n  }\n\n  .modal-dialog-scrollable {\n    height: subtract(100%, $modal-dialog-margin-y-sm-up * 2);\n  }\n\n  .modal-dialog-centered {\n    min-height: subtract(100%, $modal-dialog-margin-y-sm-up * 2);\n  }\n\n  .modal-content {\n    @include box-shadow($modal-content-box-shadow-sm-up);\n  }\n\n  .modal-sm { max-width: $modal-sm; }\n}\n\n@include media-breakpoint-up(lg) {\n  .modal-lg,\n  .modal-xl {\n    max-width: $modal-lg;\n  }\n}\n\n@include media-breakpoint-up(xl) {\n  .modal-xl { max-width: $modal-xl; }\n}\n\n// scss-docs-start modal-fullscreen-loop\n@each $breakpoint in map-keys($grid-breakpoints) {\n  $infix: breakpoint-infix($breakpoint, $grid-breakpoints);\n  $postfix: if($infix != \"\", $infix + \"-down\", \"\");\n\n  @include media-breakpoint-down($breakpoint) {\n    .modal-fullscreen#{$postfix} {\n      width: 100vw;\n      max-width: none;\n      height: 100%;\n      margin: 0;\n\n      .modal-content {\n        height: 100%;\n        border: 0;\n        @include border-radius(0);\n      }\n\n      .modal-header {\n        @include border-radius(0);\n      }\n\n      .modal-body {\n        overflow-y: auto;\n      }\n\n      .modal-footer {\n        @include border-radius(0);\n      }\n    }\n  }\n}\n// scss-docs-end modal-fullscreen-loop\n","// Shared between modals and offcanvases\n@mixin overlay-backdrop($zindex, $backdrop-bg, $backdrop-opacity) {\n  position: fixed;\n  top: 0;\n  left: 0;\n  z-index: $zindex;\n  width: 100vw;\n  height: 100vh;\n  background-color: $backdrop-bg;\n\n  // Fade for backdrop\n  &.fade { opacity: 0; }\n  &.show { opacity: $backdrop-opacity; }\n}\n","// Base class\n.tooltip {\n  position: absolute;\n  z-index: $zindex-tooltip;\n  display: block;\n  margin: $tooltip-margin;\n  // Our parent element can be arbitrary since tooltips are by default inserted as a sibling of their target element.\n  // So reset our font and text properties to avoid inheriting weird values.\n  @include reset-text();\n  @include font-size($tooltip-font-size);\n  // Allow breaking very long words so they don't overflow the tooltip's bounds\n  word-wrap: break-word;\n  opacity: 0;\n\n  &.show { opacity: $tooltip-opacity; }\n\n  .tooltip-arrow {\n    position: absolute;\n    display: block;\n    width: $tooltip-arrow-width;\n    height: $tooltip-arrow-height;\n\n    &::before {\n      position: absolute;\n      content: \"\";\n      border-color: transparent;\n      border-style: solid;\n    }\n  }\n}\n\n.bs-tooltip-top {\n  padding: $tooltip-arrow-height 0;\n\n  .tooltip-arrow {\n    bottom: 0;\n\n    &::before {\n      top: -1px;\n      border-width: $tooltip-arrow-height ($tooltip-arrow-width * .5) 0;\n      border-top-color: $tooltip-arrow-color;\n    }\n  }\n}\n\n.bs-tooltip-end {\n  padding: 0 $tooltip-arrow-height;\n\n  .tooltip-arrow {\n    left: 0;\n    width: $tooltip-arrow-height;\n    height: $tooltip-arrow-width;\n\n    &::before {\n      right: -1px;\n      border-width: ($tooltip-arrow-width * .5) $tooltip-arrow-height ($tooltip-arrow-width * .5) 0;\n      border-right-color: $tooltip-arrow-color;\n    }\n  }\n}\n\n.bs-tooltip-bottom {\n  padding: $tooltip-arrow-height 0;\n\n  .tooltip-arrow {\n    top: 0;\n\n    &::before {\n      bottom: -1px;\n      border-width: 0 ($tooltip-arrow-width * .5) $tooltip-arrow-height;\n      border-bottom-color: $tooltip-arrow-color;\n    }\n  }\n}\n\n.bs-tooltip-start {\n  padding: 0 $tooltip-arrow-height;\n\n  .tooltip-arrow {\n    right: 0;\n    width: $tooltip-arrow-height;\n    height: $tooltip-arrow-width;\n\n    &::before {\n      left: -1px;\n      border-width: ($tooltip-arrow-width * .5) 0 ($tooltip-arrow-width * .5) $tooltip-arrow-height;\n      border-left-color: $tooltip-arrow-color;\n    }\n  }\n}\n\n.bs-tooltip-auto {\n  &[data-popper-placement^=\"top\"] {\n    @extend .bs-tooltip-top;\n  }\n  &[data-popper-placement^=\"right\"] {\n    @extend .bs-tooltip-end;\n  }\n  &[data-popper-placement^=\"bottom\"] {\n    @extend .bs-tooltip-bottom;\n  }\n  &[data-popper-placement^=\"left\"] {\n    @extend .bs-tooltip-start;\n  }\n}\n\n// Wrapper for the tooltip content\n.tooltip-inner {\n  max-width: $tooltip-max-width;\n  padding: $tooltip-padding-y $tooltip-padding-x;\n  color: $tooltip-color;\n  text-align: center;\n  background-color: $tooltip-bg;\n  @include border-radius($tooltip-border-radius);\n}\n","@mixin reset-text {\n  font-family: $font-family-base;\n  // We deliberately do NOT reset font-size or overflow-wrap / word-wrap.\n  font-style: normal;\n  font-weight: $font-weight-normal;\n  line-height: $line-height-base;\n  text-align: left; // Fallback for where `start` is not supported\n  text-align: start;\n  text-decoration: none;\n  text-shadow: none;\n  text-transform: none;\n  letter-spacing: normal;\n  word-break: normal;\n  word-spacing: normal;\n  white-space: normal;\n  line-break: auto;\n}\n",".popover {\n  position: absolute;\n  top: 0;\n  left: 0 #{\"/* rtl:ignore */\"};\n  z-index: $zindex-popover;\n  display: block;\n  max-width: $popover-max-width;\n  // Our parent element can be arbitrary since tooltips are by default inserted as a sibling of their target element.\n  // So reset our font and text properties to avoid inheriting weird values.\n  @include reset-text();\n  @include font-size($popover-font-size);\n  // Allow breaking very long words so they don't overflow the popover's bounds\n  word-wrap: break-word;\n  background-color: $popover-bg;\n  background-clip: padding-box;\n  border: $popover-border-width solid $popover-border-color;\n  @include border-radius($popover-border-radius);\n  @include box-shadow($popover-box-shadow);\n\n  .popover-arrow {\n    position: absolute;\n    display: block;\n    width: $popover-arrow-width;\n    height: $popover-arrow-height;\n\n    &::before,\n    &::after {\n      position: absolute;\n      display: block;\n      content: \"\";\n      border-color: transparent;\n      border-style: solid;\n    }\n  }\n}\n\n.bs-popover-top {\n  > .popover-arrow {\n    bottom: subtract(-$popover-arrow-height, $popover-border-width);\n\n    &::before {\n      bottom: 0;\n      border-width: $popover-arrow-height ($popover-arrow-width * .5) 0;\n      border-top-color: $popover-arrow-outer-color;\n    }\n\n    &::after {\n      bottom: $popover-border-width;\n      border-width: $popover-arrow-height ($popover-arrow-width * .5) 0;\n      border-top-color: $popover-arrow-color;\n    }\n  }\n}\n\n.bs-popover-end {\n  > .popover-arrow {\n    left: subtract(-$popover-arrow-height, $popover-border-width);\n    width: $popover-arrow-height;\n    height: $popover-arrow-width;\n\n    &::before {\n      left: 0;\n      border-width: ($popover-arrow-width * .5) $popover-arrow-height ($popover-arrow-width * .5) 0;\n      border-right-color: $popover-arrow-outer-color;\n    }\n\n    &::after {\n      left: $popover-border-width;\n      border-width: ($popover-arrow-width * .5) $popover-arrow-height ($popover-arrow-width * .5) 0;\n      border-right-color: $popover-arrow-color;\n    }\n  }\n}\n\n.bs-popover-bottom {\n  > .popover-arrow {\n    top: subtract(-$popover-arrow-height, $popover-border-width);\n\n    &::before {\n      top: 0;\n      border-width: 0 ($popover-arrow-width * .5) $popover-arrow-height ($popover-arrow-width * .5);\n      border-bottom-color: $popover-arrow-outer-color;\n    }\n\n    &::after {\n      top: $popover-border-width;\n      border-width: 0 ($popover-arrow-width * .5) $popover-arrow-height ($popover-arrow-width * .5);\n      border-bottom-color: $popover-arrow-color;\n    }\n  }\n\n  // This will remove the popover-header's border just below the arrow\n  .popover-header::before {\n    position: absolute;\n    top: 0;\n    left: 50%;\n    display: block;\n    width: $popover-arrow-width;\n    margin-left: -$popover-arrow-width * .5;\n    content: \"\";\n    border-bottom: $popover-border-width solid $popover-header-bg;\n  }\n}\n\n.bs-popover-start {\n  > .popover-arrow {\n    right: subtract(-$popover-arrow-height, $popover-border-width);\n    width: $popover-arrow-height;\n    height: $popover-arrow-width;\n\n    &::before {\n      right: 0;\n      border-width: ($popover-arrow-width * .5) 0 ($popover-arrow-width * .5) $popover-arrow-height;\n      border-left-color: $popover-arrow-outer-color;\n    }\n\n    &::after {\n      right: $popover-border-width;\n      border-width: ($popover-arrow-width * .5) 0 ($popover-arrow-width * .5) $popover-arrow-height;\n      border-left-color: $popover-arrow-color;\n    }\n  }\n}\n\n.bs-popover-auto {\n  &[data-popper-placement^=\"top\"] {\n    @extend .bs-popover-top;\n  }\n  &[data-popper-placement^=\"right\"] {\n    @extend .bs-popover-end;\n  }\n  &[data-popper-placement^=\"bottom\"] {\n    @extend .bs-popover-bottom;\n  }\n  &[data-popper-placement^=\"left\"] {\n    @extend .bs-popover-start;\n  }\n}\n\n// Offset the popover to account for the popover arrow\n.popover-header {\n  padding: $popover-header-padding-y $popover-header-padding-x;\n  margin-bottom: 0; // Reset the default from Reboot\n  @include font-size($font-size-base);\n  color: $popover-header-color;\n  background-color: $popover-header-bg;\n  border-bottom: $popover-border-width solid $popover-border-color;\n  @include border-top-radius($popover-inner-border-radius);\n\n  &:empty {\n    display: none;\n  }\n}\n\n.popover-body {\n  padding: $popover-body-padding-y $popover-body-padding-x;\n  color: $popover-body-color;\n}\n","// Notes on the classes:\n//\n// 1. .carousel.pointer-event should ideally be pan-y (to allow for users to scroll vertically)\n//    even when their scroll action started on a carousel, but for compatibility (with Firefox)\n//    we're preventing all actions instead\n// 2. The .carousel-item-start and .carousel-item-end is used to indicate where\n//    the active slide is heading.\n// 3. .active.carousel-item is the current slide.\n// 4. .active.carousel-item-start and .active.carousel-item-end is the current\n//    slide in its in-transition state. Only one of these occurs at a time.\n// 5. .carousel-item-next.carousel-item-start and .carousel-item-prev.carousel-item-end\n//    is the upcoming slide in transition.\n\n.carousel {\n  position: relative;\n}\n\n.carousel.pointer-event {\n  touch-action: pan-y;\n}\n\n.carousel-inner {\n  position: relative;\n  width: 100%;\n  overflow: hidden;\n  @include clearfix();\n}\n\n.carousel-item {\n  position: relative;\n  display: none;\n  float: left;\n  width: 100%;\n  margin-right: -100%;\n  backface-visibility: hidden;\n  @include transition($carousel-transition);\n}\n\n.carousel-item.active,\n.carousel-item-next,\n.carousel-item-prev {\n  display: block;\n}\n\n/* rtl:begin:ignore */\n.carousel-item-next:not(.carousel-item-start),\n.active.carousel-item-end {\n  transform: translateX(100%);\n}\n\n.carousel-item-prev:not(.carousel-item-end),\n.active.carousel-item-start {\n  transform: translateX(-100%);\n}\n\n/* rtl:end:ignore */\n\n\n//\n// Alternate transitions\n//\n\n.carousel-fade {\n  .carousel-item {\n    opacity: 0;\n    transition-property: opacity;\n    transform: none;\n  }\n\n  .carousel-item.active,\n  .carousel-item-next.carousel-item-start,\n  .carousel-item-prev.carousel-item-end {\n    z-index: 1;\n    opacity: 1;\n  }\n\n  .active.carousel-item-start,\n  .active.carousel-item-end {\n    z-index: 0;\n    opacity: 0;\n    @include transition(opacity 0s $carousel-transition-duration);\n  }\n}\n\n\n//\n// Left/right controls for nav\n//\n\n.carousel-control-prev,\n.carousel-control-next {\n  position: absolute;\n  top: 0;\n  bottom: 0;\n  z-index: 1;\n  // Use flex for alignment (1-3)\n  display: flex; // 1. allow flex styles\n  align-items: center; // 2. vertically center contents\n  justify-content: center; // 3. horizontally center contents\n  width: $carousel-control-width;\n  padding: 0;\n  color: $carousel-control-color;\n  text-align: center;\n  background: none;\n  border: 0;\n  opacity: $carousel-control-opacity;\n  @include transition($carousel-control-transition);\n\n  // Hover/focus state\n  &:hover,\n  &:focus {\n    color: $carousel-control-color;\n    text-decoration: none;\n    outline: 0;\n    opacity: $carousel-control-hover-opacity;\n  }\n}\n.carousel-control-prev {\n  left: 0;\n  background-image: if($enable-gradients, linear-gradient(90deg, rgba($black, .25), rgba($black, .001)), null);\n}\n.carousel-control-next {\n  right: 0;\n  background-image: if($enable-gradients, linear-gradient(270deg, rgba($black, .25), rgba($black, .001)), null);\n}\n\n// Icons for within\n.carousel-control-prev-icon,\n.carousel-control-next-icon {\n  display: inline-block;\n  width: $carousel-control-icon-width;\n  height: $carousel-control-icon-width;\n  background-repeat: no-repeat;\n  background-position: 50%;\n  background-size: 100% 100%;\n}\n\n/* rtl:options: {\n  \"autoRename\": true,\n  \"stringMap\":[ {\n    \"name\"    : \"prev-next\",\n    \"search\"  : \"prev\",\n    \"replace\" : \"next\"\n  } ]\n} */\n.carousel-control-prev-icon {\n  background-image: escape-svg($carousel-control-prev-icon-bg);\n}\n.carousel-control-next-icon {\n  background-image: escape-svg($carousel-control-next-icon-bg);\n}\n\n// Optional indicator pips/controls\n//\n// Add a container (such as a list) with the following class and add an item (ideally a focusable control,\n// like a button) with data-bs-target for each slide your carousel holds.\n\n.carousel-indicators {\n  position: absolute;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  z-index: 2;\n  display: flex;\n  justify-content: center;\n  padding: 0;\n  // Use the .carousel-control's width as margin so we don't overlay those\n  margin-right: $carousel-control-width;\n  margin-bottom: 1rem;\n  margin-left: $carousel-control-width;\n  list-style: none;\n\n  [data-bs-target] {\n    box-sizing: content-box;\n    flex: 0 1 auto;\n    width: $carousel-indicator-width;\n    height: $carousel-indicator-height;\n    padding: 0;\n    margin-right: $carousel-indicator-spacer;\n    margin-left: $carousel-indicator-spacer;\n    text-indent: -999px;\n    cursor: pointer;\n    background-color: $carousel-indicator-active-bg;\n    background-clip: padding-box;\n    border: 0;\n    // Use transparent borders to increase the hit area by 10px on top and bottom.\n    border-top: $carousel-indicator-hit-area-height solid transparent;\n    border-bottom: $carousel-indicator-hit-area-height solid transparent;\n    opacity: $carousel-indicator-opacity;\n    @include transition($carousel-indicator-transition);\n  }\n\n  .active {\n    opacity: $carousel-indicator-active-opacity;\n  }\n}\n\n\n// Optional captions\n//\n//\n\n.carousel-caption {\n  position: absolute;\n  right: (100% - $carousel-caption-width) * .5;\n  bottom: $carousel-caption-spacer;\n  left: (100% - $carousel-caption-width) * .5;\n  padding-top: $carousel-caption-padding-y;\n  padding-bottom: $carousel-caption-padding-y;\n  color: $carousel-caption-color;\n  text-align: center;\n}\n\n// Dark mode carousel\n\n.carousel-dark {\n  .carousel-control-prev-icon,\n  .carousel-control-next-icon {\n    filter: $carousel-dark-control-icon-filter;\n  }\n\n  .carousel-indicators [data-bs-target] {\n    background-color: $carousel-dark-indicator-active-bg;\n  }\n\n  .carousel-caption {\n    color: $carousel-dark-caption-color;\n  }\n}\n","// scss-docs-start clearfix\n@mixin clearfix() {\n  &::after {\n    display: block;\n    clear: both;\n    content: \"\";\n  }\n}\n// scss-docs-end clearfix\n","//\n// Rotating border\n//\n\n// scss-docs-start spinner-border-keyframes\n@keyframes spinner-border {\n  to { transform: rotate(360deg) #{\"/* rtl:ignore */\"}; }\n}\n// scss-docs-end spinner-border-keyframes\n\n.spinner-border {\n  display: inline-block;\n  width: $spinner-width;\n  height: $spinner-height;\n  vertical-align: $spinner-vertical-align;\n  border: $spinner-border-width solid currentColor;\n  border-right-color: transparent;\n  // stylelint-disable-next-line property-disallowed-list\n  border-radius: 50%;\n  animation: $spinner-animation-speed linear infinite spinner-border;\n}\n\n.spinner-border-sm {\n  width: $spinner-width-sm;\n  height: $spinner-height-sm;\n  border-width: $spinner-border-width-sm;\n}\n\n//\n// Growing circle\n//\n\n// scss-docs-start spinner-grow-keyframes\n@keyframes spinner-grow {\n  0% {\n    transform: scale(0);\n  }\n  50% {\n    opacity: 1;\n    transform: none;\n  }\n}\n// scss-docs-end spinner-grow-keyframes\n\n.spinner-grow {\n  display: inline-block;\n  width: $spinner-width;\n  height: $spinner-height;\n  vertical-align: $spinner-vertical-align;\n  background-color: currentColor;\n  // stylelint-disable-next-line property-disallowed-list\n  border-radius: 50%;\n  opacity: 0;\n  animation: $spinner-animation-speed linear infinite spinner-grow;\n}\n\n.spinner-grow-sm {\n  width: $spinner-width-sm;\n  height: $spinner-height-sm;\n}\n\n@if $enable-reduced-motion {\n  @media (prefers-reduced-motion: reduce) {\n    .spinner-border,\n    .spinner-grow {\n      animation-duration: $spinner-animation-speed * 2;\n    }\n  }\n}\n",".offcanvas {\n  position: fixed;\n  bottom: 0;\n  z-index: $zindex-offcanvas;\n  display: flex;\n  flex-direction: column;\n  max-width: 100%;\n  color: $offcanvas-color;\n  visibility: hidden;\n  background-color: $offcanvas-bg-color;\n  background-clip: padding-box;\n  outline: 0;\n  @include box-shadow($offcanvas-box-shadow);\n  @include transition(transform $offcanvas-transition-duration ease-in-out);\n}\n\n.offcanvas-backdrop {\n  @include overlay-backdrop($zindex-offcanvas-backdrop, $offcanvas-backdrop-bg, $offcanvas-backdrop-opacity);\n}\n\n.offcanvas-header {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  padding: $offcanvas-padding-y $offcanvas-padding-x;\n\n  .btn-close {\n    padding: ($offcanvas-padding-y * .5) ($offcanvas-padding-x * .5);\n    margin-top: $offcanvas-padding-y * -.5;\n    margin-right: $offcanvas-padding-x * -.5;\n    margin-bottom: $offcanvas-padding-y * -.5;\n  }\n}\n\n.offcanvas-title {\n  margin-bottom: 0;\n  line-height: $offcanvas-title-line-height;\n}\n\n.offcanvas-body {\n  flex-grow: 1;\n  padding: $offcanvas-padding-y $offcanvas-padding-x;\n  overflow-y: auto;\n}\n\n.offcanvas-start {\n  top: 0;\n  left: 0;\n  width: $offcanvas-horizontal-width;\n  border-right: $offcanvas-border-width solid $offcanvas-border-color;\n  transform: translateX(-100%);\n}\n\n.offcanvas-end {\n  top: 0;\n  right: 0;\n  width: $offcanvas-horizontal-width;\n  border-left: $offcanvas-border-width solid $offcanvas-border-color;\n  transform: translateX(100%);\n}\n\n.offcanvas-top {\n  top: 0;\n  right: 0;\n  left: 0;\n  height: $offcanvas-vertical-height;\n  max-height: 100%;\n  border-bottom: $offcanvas-border-width solid $offcanvas-border-color;\n  transform: translateY(-100%);\n}\n\n.offcanvas-bottom {\n  right: 0;\n  left: 0;\n  height: $offcanvas-vertical-height;\n  max-height: 100%;\n  border-top: $offcanvas-border-width solid $offcanvas-border-color;\n  transform: translateY(100%);\n}\n\n.offcanvas.show {\n  transform: none;\n}\n",".placeholder {\n  display: inline-block;\n  min-height: 1em;\n  vertical-align: middle;\n  cursor: wait;\n  background-color: currentColor;\n  opacity: $placeholder-opacity-max;\n\n  &.btn::before {\n    display: inline-block;\n    content: \"\";\n  }\n}\n\n// Sizing\n.placeholder-xs {\n  min-height: .6em;\n}\n\n.placeholder-sm {\n  min-height: .8em;\n}\n\n.placeholder-lg {\n  min-height: 1.2em;\n}\n\n// Animation\n.placeholder-glow {\n  .placeholder {\n    animation: placeholder-glow 2s ease-in-out infinite;\n  }\n}\n\n@keyframes placeholder-glow {\n  50% {\n    opacity: $placeholder-opacity-min;\n  }\n}\n\n.placeholder-wave {\n  mask-image: linear-gradient(130deg, $black 55%, rgba(0, 0, 0, (1 - $placeholder-opacity-min)) 75%, $black 95%);\n  mask-size: 200% 100%;\n  animation: placeholder-wave 2s linear infinite;\n}\n\n@keyframes placeholder-wave {\n  100% {\n    mask-position: -200% 0%;\n  }\n}\n","@each $color, $value in $theme-colors {\n  .link-#{$color} {\n    color: $value;\n\n    @if $link-shade-percentage != 0 {\n      &:hover,\n      &:focus {\n        color: if(color-contrast($value) == $color-contrast-light, shade-color($value, $link-shade-percentage), tint-color($value, $link-shade-percentage));\n      }\n    }\n  }\n}\n","// Credit: Nicolas Gallagher and SUIT CSS.\n\n.ratio {\n  position: relative;\n  width: 100%;\n\n  &::before {\n    display: block;\n    padding-top: var(--#{$variable-prefix}aspect-ratio);\n    content: \"\";\n  }\n\n  > * {\n    position: absolute;\n    top: 0;\n    left: 0;\n    width: 100%;\n    height: 100%;\n  }\n}\n\n@each $key, $ratio in $aspect-ratios {\n  .ratio-#{$key} {\n    --#{$variable-prefix}aspect-ratio: #{$ratio};\n  }\n}\n","// Shorthand\n\n.fixed-top {\n  position: fixed;\n  top: 0;\n  right: 0;\n  left: 0;\n  z-index: $zindex-fixed;\n}\n\n.fixed-bottom {\n  position: fixed;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  z-index: $zindex-fixed;\n}\n\n// Responsive sticky top\n@each $breakpoint in map-keys($grid-breakpoints) {\n  @include media-breakpoint-up($breakpoint) {\n    $infix: breakpoint-infix($breakpoint, $grid-breakpoints);\n\n    .sticky#{$infix}-top {\n      position: sticky;\n      top: 0;\n      z-index: $zindex-sticky;\n    }\n  }\n}\n","// scss-docs-start stacks\n.hstack {\n  display: flex;\n  flex-direction: row;\n  align-items: center;\n  align-self: stretch;\n}\n\n.vstack {\n  display: flex;\n  flex: 1 1 auto;\n  flex-direction: column;\n  align-self: stretch;\n}\n// scss-docs-end stacks\n","//\n// Visually hidden\n//\n\n.visually-hidden,\n.visually-hidden-focusable:not(:focus):not(:focus-within) {\n  @include visually-hidden();\n}\n","// stylelint-disable declaration-no-important\n\n// Hide content visually while keeping it accessible to assistive technologies\n//\n// See: https://www.a11yproject.com/posts/2013-01-11-how-to-hide-content/\n// See: https://hugogiraudel.com/2016/10/13/css-hide-and-seek/\n\n@mixin visually-hidden() {\n  position: absolute !important;\n  width: 1px !important;\n  height: 1px !important;\n  padding: 0 !important;\n  margin: -1px !important; // Fix for https://github.com/twbs/bootstrap/issues/25686\n  overflow: hidden !important;\n  clip: rect(0, 0, 0, 0) !important;\n  white-space: nowrap !important;\n  border: 0 !important;\n}\n\n// Use to only display content when it's focused, or one of its child elements is focused\n// (i.e. when focus is within the element/container that the class was applied to)\n//\n// Useful for \"Skip to main content\" links; see https://www.w3.org/TR/2013/NOTE-WCAG20-TECHS-20130905/G1\n\n@mixin visually-hidden-focusable() {\n  &:not(:focus):not(:focus-within) {\n    @include visually-hidden();\n  }\n}\n","//\n// Stretched link\n//\n\n.stretched-link {\n  &::#{$stretched-link-pseudo-element} {\n    position: absolute;\n    top: 0;\n    right: 0;\n    bottom: 0;\n    left: 0;\n    z-index: $stretched-link-z-index;\n    content: \"\";\n  }\n}\n","//\n// Text truncation\n//\n\n.text-truncate {\n  @include text-truncate();\n}\n","// Text truncate\n// Requires inline-block or block for proper styling\n\n@mixin text-truncate() {\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n",".vr {\n  display: inline-block;\n  align-self: stretch;\n  width: 1px;\n  min-height: 1em;\n  background-color: currentColor;\n  opacity: $hr-opacity;\n}\n","// Utility generator\n// Used to generate utilities & print utilities\n@mixin generate-utility($utility, $infix, $is-rfs-media-query: false) {\n  $values: map-get($utility, values);\n\n  // If the values are a list or string, convert it into a map\n  @if type-of($values) == \"string\" or type-of(nth($values, 1)) != \"list\" {\n    $values: zip($values, $values);\n  }\n\n  @each $key, $value in $values {\n    $properties: map-get($utility, property);\n\n    // Multiple properties are possible, for example with vertical or horizontal margins or paddings\n    @if type-of($properties) == \"string\" {\n      $properties: append((), $properties);\n    }\n\n    // Use custom class if present\n    $property-class: if(map-has-key($utility, class), map-get($utility, class), nth($properties, 1));\n    $property-class: if($property-class == null, \"\", $property-class);\n\n    // State params to generate pseudo-classes\n    $state: if(map-has-key($utility, state), map-get($utility, state), ());\n\n    $infix: if($property-class == \"\" and str-slice($infix, 1, 1) == \"-\", str-slice($infix, 2), $infix);\n\n    // Don't prefix if value key is null (eg. with shadow class)\n    $property-class-modifier: if($key, if($property-class == \"\" and $infix == \"\", \"\", \"-\") + $key, \"\");\n\n    @if map-get($utility, rfs) {\n      // Inside the media query\n      @if $is-rfs-media-query {\n        $val: rfs-value($value);\n\n        // Do not render anything if fluid and non fluid values are the same\n        $value: if($val == rfs-fluid-value($value), null, $val);\n      }\n      @else {\n        $value: rfs-fluid-value($value);\n      }\n    }\n\n    $is-css-var: map-get($utility, css-var);\n    $is-local-vars: map-get($utility, local-vars);\n    $is-rtl: map-get($utility, rtl);\n\n    @if $value != null {\n      @if $is-rtl == false {\n        /* rtl:begin:remove */\n      }\n\n      @if $is-css-var {\n        .#{$property-class + $infix + $property-class-modifier} {\n          --#{$variable-prefix}#{$property-class}: #{$value};\n        }\n\n        @each $pseudo in $state {\n          .#{$property-class + $infix + $property-class-modifier}-#{$pseudo}:#{$pseudo} {\n            --#{$variable-prefix}#{$property-class}: #{$value};\n          }\n        }\n      } @else {\n        .#{$property-class + $infix + $property-class-modifier} {\n          @each $property in $properties {\n            @if $is-local-vars {\n              @each $local-var, $value in $is-local-vars {\n                --#{$variable-prefix}#{$local-var}: #{$value};\n              }\n            }\n            #{$property}: $value if($enable-important-utilities, !important, null);\n          }\n        }\n\n        @each $pseudo in $state {\n          .#{$property-class + $infix + $property-class-modifier}-#{$pseudo}:#{$pseudo} {\n            @each $property in $properties {\n              #{$property}: $value if($enable-important-utilities, !important, null);\n            }\n          }\n        }\n      }\n\n      @if $is-rtl == false {\n        /* rtl:end:remove */\n      }\n    }\n  }\n}\n","// Loop over each breakpoint\n@each $breakpoint in map-keys($grid-breakpoints) {\n\n  // Generate media query if needed\n  @include media-breakpoint-up($breakpoint) {\n    $infix: breakpoint-infix($breakpoint, $grid-breakpoints);\n\n    // Loop over each utility property\n    @each $key, $utility in $utilities {\n      // The utility can be disabled with `false`, thus check if the utility is a map first\n      // Only proceed if responsive media queries are enabled or if it's the base media query\n      @if type-of($utility) == \"map\" and (map-get($utility, responsive) or $infix == \"\") {\n        @include generate-utility($utility, $infix);\n      }\n    }\n  }\n}\n\n// RFS rescaling\n@media (min-width: $rfs-mq-value) {\n  @each $breakpoint in map-keys($grid-breakpoints) {\n    $infix: breakpoint-infix($breakpoint, $grid-breakpoints);\n\n    @if (map-get($grid-breakpoints, $breakpoint) < $rfs-breakpoint) {\n      // Loop over each utility property\n      @each $key, $utility in $utilities {\n        // The utility can be disabled with `false`, thus check if the utility is a map first\n        // Only proceed if responsive media queries are enabled or if it's the base media query\n        @if type-of($utility) == \"map\" and map-get($utility, rfs) and (map-get($utility, responsive) or $infix == \"\") {\n          @include generate-utility($utility, $infix, true);\n        }\n      }\n    }\n  }\n}\n\n\n// Print utilities\n@media print {\n  @each $key, $utility in $utilities {\n    // The utility can be disabled with `false`, thus check if the utility is a map first\n    // Then check if the utility needs print styles\n    @if type-of($utility) == \"map\" and map-get($utility, print) == true {\n      @include generate-utility($utility, \"-print\");\n    }\n  }\n}\n"]}
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/FONT-LICENSE b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/FONT-LICENSE
new file mode 100644
index 0000000000..a1dc03f35c
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/FONT-LICENSE
@@ -0,0 +1,86 @@
+SIL OPEN FONT LICENSE Version 1.1
+
+Copyright (c) 2014 Waybury
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/ICON-LICENSE b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/ICON-LICENSE
new file mode 100644
index 0000000000..2199f4a694
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/ICON-LICENSE
@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Waybury
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/README.md.txt b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/README.md.txt
new file mode 100644
index 0000000000..6b810e4796
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/README.md.txt
@@ -0,0 +1,114 @@
+[Open Iconic v1.1.1](http://useiconic.com/open)
+===========
+
+### Open Iconic is the open source sibling of [Iconic](http://useiconic.com). It is a hyper-legible collection of 223 icons with a tiny footprint&mdash;ready to use with Bootstrap and Foundation. [View the collection](http://useiconic.com/open#icons)
+
+
+
+## What's in Open Iconic?
+
+* 223 icons designed to be legible down to 8 pixels
+* Super-light SVG files - 61.8 for the entire set 
+* SVG sprite&mdash;the modern replacement for icon fonts
+* Webfont (EOT, OTF, SVG, TTF, WOFF), PNG and WebP formats
+* Webfont stylesheets (including versions for Bootstrap and Foundation) in CSS, LESS, SCSS and Stylus formats
+* PNG and WebP raster images in 8px, 16px, 24px, 32px, 48px and 64px.
+
+
+## Getting Started
+
+#### For code samples and everything else you need to get started with Open Iconic, check out our [Icons](http://useiconic.com/open#icons) and [Reference](http://useiconic.com/open#reference) sections.
+
+### General Usage
+
+#### Using Open Iconic's SVGs
+
+We like SVGs and we think they're the way to display icons on the web. Since Open Iconic are just basic SVGs, we suggest you display them like you would any other image (don't forget the `alt` attribute).
+
+```
+<img src="/open-iconic/svg/icon-name.svg" alt="icon name">
+```
+
+#### Using Open Iconic's SVG Sprite
+
+Open Iconic also comes in a SVG sprite which allows you to display all the icons in the set with a single request. It's like an icon font, without being a hack.
+
+Adding an icon from an SVG sprite is a little different than what you're used to, but it's still a piece of cake. *Tip: To make your icons easily style able, we suggest adding a general class to the* `<svg>` *tag and a unique class name for each different icon in the* `<use>` *tag.*  
+
+```
+<svg class="icon">
+  <use xlink:href="open-iconic.svg#account-login" class="icon-account-login"></use>
+</svg>
+```
+
+Sizing icons only needs basic CSS. All the icons are in a square format, so just set the `<svg>` tag with equal width and height dimensions.
+
+```
+.icon {
+  width: 16px;
+  height: 16px;
+}
+```
+
+Coloring icons is even easier. All you need to do is set the `fill` rule on the `<use>` tag.
+
+```
+.icon-account-login {
+  fill: #f00;
+}
+```
+
+To learn more about SVG Sprites, read [Chris Coyier's guide](http://css-tricks.com/svg-sprites-use-better-icon-fonts/).
+
+#### Using Open Iconic's Icon Font...
+
+
+##### …with Bootstrap
+
+You can find our Bootstrap stylesheets in `font/css/open-iconic-bootstrap.{css, less, scss, styl}`
+
+
+```
+<link href="/open-iconic/font/css/open-iconic-bootstrap.css" rel="stylesheet">
+```
+
+
+```
+<span class="oi oi-icon-name" title="icon name" aria-hidden="true"></span>
+```
+
+##### …with Foundation
+
+You can find our Foundation stylesheets in `font/css/open-iconic-foundation.{css, less, scss, styl}`
+
+```
+<link href="/open-iconic/font/css/open-iconic-foundation.css" rel="stylesheet">
+```
+
+
+```
+<span class="fi-icon-name" title="icon name" aria-hidden="true"></span>
+```
+
+##### …on its own
+
+You can find our default stylesheets in `font/css/open-iconic.{css, less, scss, styl}`
+
+```
+<link href="/open-iconic/font/css/open-iconic.css" rel="stylesheet">
+```
+
+```
+<span class="oi" data-glyph="icon-name" title="icon name" aria-hidden="true"></span>
+```
+
+
+## License
+
+### Icons
+
+All code (including SVG markup) is under the [MIT License](http://opensource.org/licenses/MIT).
+
+### Fonts
+
+All fonts are under the [SIL Licensed](http://scripts.sil.org/cms/scripts/page.php?item_id=OFL_web).
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/font/css/open-iconic-bootstrap.min.css b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/font/css/open-iconic-bootstrap.min.css
new file mode 100644
index 0000000000..4664f2e8ca
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/font/css/open-iconic-bootstrap.min.css
@@ -0,0 +1 @@
+@font-face{font-family:Icons;src:url(../fonts/open-iconic.eot);src:url(../fonts/open-iconic.eot?#iconic-sm) format('embedded-opentype'),url(../fonts/open-iconic.woff) format('woff'),url(../fonts/open-iconic.ttf) format('truetype'),url(../fonts/open-iconic.otf) format('opentype'),url(../fonts/open-iconic.svg#iconic-sm) format('svg');font-weight:400;font-style:normal}.oi{position:relative;top:1px;display:inline-block;speak:none;font-family:Icons;font-style:normal;font-weight:400;line-height:1;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.oi:empty:before{width:1em;text-align:center;box-sizing:content-box}.oi.oi-align-center:before{text-align:center}.oi.oi-align-left:before{text-align:left}.oi.oi-align-right:before{text-align:right}.oi.oi-flip-horizontal:before{-webkit-transform:scale(-1,1);-ms-transform:scale(-1,1);transform:scale(-1,1)}.oi.oi-flip-vertical:before{-webkit-transform:scale(1,-1);-ms-transform:scale(-1,1);transform:scale(1,-1)}.oi.oi-flip-horizontal-vertical:before{-webkit-transform:scale(-1,-1);-ms-transform:scale(-1,1);transform:scale(-1,-1)}.oi-account-login:before{content:'\e000'}.oi-account-logout:before{content:'\e001'}.oi-action-redo:before{content:'\e002'}.oi-action-undo:before{content:'\e003'}.oi-align-center:before{content:'\e004'}.oi-align-left:before{content:'\e005'}.oi-align-right:before{content:'\e006'}.oi-aperture:before{content:'\e007'}.oi-arrow-bottom:before{content:'\e008'}.oi-arrow-circle-bottom:before{content:'\e009'}.oi-arrow-circle-left:before{content:'\e00a'}.oi-arrow-circle-right:before{content:'\e00b'}.oi-arrow-circle-top:before{content:'\e00c'}.oi-arrow-left:before{content:'\e00d'}.oi-arrow-right:before{content:'\e00e'}.oi-arrow-thick-bottom:before{content:'\e00f'}.oi-arrow-thick-left:before{content:'\e010'}.oi-arrow-thick-right:before{content:'\e011'}.oi-arrow-thick-top:before{content:'\e012'}.oi-arrow-top:before{content:'\e013'}.oi-audio-spectrum:before{content:'\e014'}.oi-audio:before{content:'\e015'}.oi-badge:before{content:'\e016'}.oi-ban:before{content:'\e017'}.oi-bar-chart:before{content:'\e018'}.oi-basket:before{content:'\e019'}.oi-battery-empty:before{content:'\e01a'}.oi-battery-full:before{content:'\e01b'}.oi-beaker:before{content:'\e01c'}.oi-bell:before{content:'\e01d'}.oi-bluetooth:before{content:'\e01e'}.oi-bold:before{content:'\e01f'}.oi-bolt:before{content:'\e020'}.oi-book:before{content:'\e021'}.oi-bookmark:before{content:'\e022'}.oi-box:before{content:'\e023'}.oi-briefcase:before{content:'\e024'}.oi-british-pound:before{content:'\e025'}.oi-browser:before{content:'\e026'}.oi-brush:before{content:'\e027'}.oi-bug:before{content:'\e028'}.oi-bullhorn:before{content:'\e029'}.oi-calculator:before{content:'\e02a'}.oi-calendar:before{content:'\e02b'}.oi-camera-slr:before{content:'\e02c'}.oi-caret-bottom:before{content:'\e02d'}.oi-caret-left:before{content:'\e02e'}.oi-caret-right:before{content:'\e02f'}.oi-caret-top:before{content:'\e030'}.oi-cart:before{content:'\e031'}.oi-chat:before{content:'\e032'}.oi-check:before{content:'\e033'}.oi-chevron-bottom:before{content:'\e034'}.oi-chevron-left:before{content:'\e035'}.oi-chevron-right:before{content:'\e036'}.oi-chevron-top:before{content:'\e037'}.oi-circle-check:before{content:'\e038'}.oi-circle-x:before{content:'\e039'}.oi-clipboard:before{content:'\e03a'}.oi-clock:before{content:'\e03b'}.oi-cloud-download:before{content:'\e03c'}.oi-cloud-upload:before{content:'\e03d'}.oi-cloud:before{content:'\e03e'}.oi-cloudy:before{content:'\e03f'}.oi-code:before{content:'\e040'}.oi-cog:before{content:'\e041'}.oi-collapse-down:before{content:'\e042'}.oi-collapse-left:before{content:'\e043'}.oi-collapse-right:before{content:'\e044'}.oi-collapse-up:before{content:'\e045'}.oi-command:before{content:'\e046'}.oi-comment-square:before{content:'\e047'}.oi-compass:before{content:'\e048'}.oi-contrast:before{content:'\e049'}.oi-copywriting:before{content:'\e04a'}.oi-credit-card:before{content:'\e04b'}.oi-crop:before{content:'\e04c'}.oi-dashboard:before{content:'\e04d'}.oi-data-transfer-download:before{content:'\e04e'}.oi-data-transfer-upload:before{content:'\e04f'}.oi-delete:before{content:'\e050'}.oi-dial:before{content:'\e051'}.oi-document:before{content:'\e052'}.oi-dollar:before{content:'\e053'}.oi-double-quote-sans-left:before{content:'\e054'}.oi-double-quote-sans-right:before{content:'\e055'}.oi-double-quote-serif-left:before{content:'\e056'}.oi-double-quote-serif-right:before{content:'\e057'}.oi-droplet:before{content:'\e058'}.oi-eject:before{content:'\e059'}.oi-elevator:before{content:'\e05a'}.oi-ellipses:before{content:'\e05b'}.oi-envelope-closed:before{content:'\e05c'}.oi-envelope-open:before{content:'\e05d'}.oi-euro:before{content:'\e05e'}.oi-excerpt:before{content:'\e05f'}.oi-expand-down:before{content:'\e060'}.oi-expand-left:before{content:'\e061'}.oi-expand-right:before{content:'\e062'}.oi-expand-up:before{content:'\e063'}.oi-external-link:before{content:'\e064'}.oi-eye:before{content:'\e065'}.oi-eyedropper:before{content:'\e066'}.oi-file:before{content:'\e067'}.oi-fire:before{content:'\e068'}.oi-flag:before{content:'\e069'}.oi-flash:before{content:'\e06a'}.oi-folder:before{content:'\e06b'}.oi-fork:before{content:'\e06c'}.oi-fullscreen-enter:before{content:'\e06d'}.oi-fullscreen-exit:before{content:'\e06e'}.oi-globe:before{content:'\e06f'}.oi-graph:before{content:'\e070'}.oi-grid-four-up:before{content:'\e071'}.oi-grid-three-up:before{content:'\e072'}.oi-grid-two-up:before{content:'\e073'}.oi-hard-drive:before{content:'\e074'}.oi-header:before{content:'\e075'}.oi-headphones:before{content:'\e076'}.oi-heart:before{content:'\e077'}.oi-home:before{content:'\e078'}.oi-image:before{content:'\e079'}.oi-inbox:before{content:'\e07a'}.oi-infinity:before{content:'\e07b'}.oi-info:before{content:'\e07c'}.oi-italic:before{content:'\e07d'}.oi-justify-center:before{content:'\e07e'}.oi-justify-left:before{content:'\e07f'}.oi-justify-right:before{content:'\e080'}.oi-key:before{content:'\e081'}.oi-laptop:before{content:'\e082'}.oi-layers:before{content:'\e083'}.oi-lightbulb:before{content:'\e084'}.oi-link-broken:before{content:'\e085'}.oi-link-intact:before{content:'\e086'}.oi-list-rich:before{content:'\e087'}.oi-list:before{content:'\e088'}.oi-location:before{content:'\e089'}.oi-lock-locked:before{content:'\e08a'}.oi-lock-unlocked:before{content:'\e08b'}.oi-loop-circular:before{content:'\e08c'}.oi-loop-square:before{content:'\e08d'}.oi-loop:before{content:'\e08e'}.oi-magnifying-glass:before{content:'\e08f'}.oi-map-marker:before{content:'\e090'}.oi-map:before{content:'\e091'}.oi-media-pause:before{content:'\e092'}.oi-media-play:before{content:'\e093'}.oi-media-record:before{content:'\e094'}.oi-media-skip-backward:before{content:'\e095'}.oi-media-skip-forward:before{content:'\e096'}.oi-media-step-backward:before{content:'\e097'}.oi-media-step-forward:before{content:'\e098'}.oi-media-stop:before{content:'\e099'}.oi-medical-cross:before{content:'\e09a'}.oi-menu:before{content:'\e09b'}.oi-microphone:before{content:'\e09c'}.oi-minus:before{content:'\e09d'}.oi-monitor:before{content:'\e09e'}.oi-moon:before{content:'\e09f'}.oi-move:before{content:'\e0a0'}.oi-musical-note:before{content:'\e0a1'}.oi-paperclip:before{content:'\e0a2'}.oi-pencil:before{content:'\e0a3'}.oi-people:before{content:'\e0a4'}.oi-person:before{content:'\e0a5'}.oi-phone:before{content:'\e0a6'}.oi-pie-chart:before{content:'\e0a7'}.oi-pin:before{content:'\e0a8'}.oi-play-circle:before{content:'\e0a9'}.oi-plus:before{content:'\e0aa'}.oi-power-standby:before{content:'\e0ab'}.oi-print:before{content:'\e0ac'}.oi-project:before{content:'\e0ad'}.oi-pulse:before{content:'\e0ae'}.oi-puzzle-piece:before{content:'\e0af'}.oi-question-mark:before{content:'\e0b0'}.oi-rain:before{content:'\e0b1'}.oi-random:before{content:'\e0b2'}.oi-reload:before{content:'\e0b3'}.oi-resize-both:before{content:'\e0b4'}.oi-resize-height:before{content:'\e0b5'}.oi-resize-width:before{content:'\e0b6'}.oi-rss-alt:before{content:'\e0b7'}.oi-rss:before{content:'\e0b8'}.oi-script:before{content:'\e0b9'}.oi-share-boxed:before{content:'\e0ba'}.oi-share:before{content:'\e0bb'}.oi-shield:before{content:'\e0bc'}.oi-signal:before{content:'\e0bd'}.oi-signpost:before{content:'\e0be'}.oi-sort-ascending:before{content:'\e0bf'}.oi-sort-descending:before{content:'\e0c0'}.oi-spreadsheet:before{content:'\e0c1'}.oi-star:before{content:'\e0c2'}.oi-sun:before{content:'\e0c3'}.oi-tablet:before{content:'\e0c4'}.oi-tag:before{content:'\e0c5'}.oi-tags:before{content:'\e0c6'}.oi-target:before{content:'\e0c7'}.oi-task:before{content:'\e0c8'}.oi-terminal:before{content:'\e0c9'}.oi-text:before{content:'\e0ca'}.oi-thumb-down:before{content:'\e0cb'}.oi-thumb-up:before{content:'\e0cc'}.oi-timer:before{content:'\e0cd'}.oi-transfer:before{content:'\e0ce'}.oi-trash:before{content:'\e0cf'}.oi-underline:before{content:'\e0d0'}.oi-vertical-align-bottom:before{content:'\e0d1'}.oi-vertical-align-center:before{content:'\e0d2'}.oi-vertical-align-top:before{content:'\e0d3'}.oi-video:before{content:'\e0d4'}.oi-volume-high:before{content:'\e0d5'}.oi-volume-low:before{content:'\e0d6'}.oi-volume-off:before{content:'\e0d7'}.oi-warning:before{content:'\e0d8'}.oi-wifi:before{content:'\e0d9'}.oi-wrench:before{content:'\e0da'}.oi-x:before{content:'\e0db'}.oi-yen:before{content:'\e0dc'}.oi-zoom-in:before{content:'\e0dd'}.oi-zoom-out:before{content:'\e0de'}
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/font/fonts/open-iconic.eot b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/font/fonts/open-iconic.eot
new file mode 100644
index 0000000000..f98177dbf7
Binary files /dev/null and b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/font/fonts/open-iconic.eot differ
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/font/fonts/open-iconic.otf b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/font/fonts/open-iconic.otf
new file mode 100644
index 0000000000..f6bd6846a2
Binary files /dev/null and b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/font/fonts/open-iconic.otf differ
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/font/fonts/open-iconic.svg b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/font/fonts/open-iconic.svg
new file mode 100644
index 0000000000..32b2c4e99b
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/font/fonts/open-iconic.svg
@@ -0,0 +1,543 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd" >
+<!--
+2014-7-1: Created.
+-->
+<svg xmlns="http://www.w3.org/2000/svg">
+<metadata>
+Created by FontForge 20120731 at Tue Jul  1 20:39:22 2014
+ By P.J. Onori
+Created by P.J. Onori with FontForge 2.0 (http://fontforge.sf.net)
+</metadata>
+<defs>
+<font id="open-iconic" horiz-adv-x="800" >
+  <font-face 
+    font-family="Icons"
+    font-weight="400"
+    font-stretch="normal"
+    units-per-em="800"
+    panose-1="2 0 5 3 0 0 0 0 0 0"
+    ascent="800"
+    descent="0"
+    bbox="-0.5 -101 802 800.126"
+    underline-thickness="50"
+    underline-position="-100"
+    unicode-range="U+E000-E0DE"
+  />
+    <missing-glyph />
+    <glyph glyph-name="" unicode="&#xe000;" 
+d="M300 700h500v-700h-500v100h400v500h-400v100zM400 500l200 -150l-200 -150v100h-400v100h400v100z" />
+    <glyph glyph-name="1" unicode="&#xe001;" 
+d="M300 700h500v-700h-500v100h400v500h-400v100zM200 500v-100h400v-100h-400v-100l-200 150z" />
+    <glyph glyph-name="2" unicode="&#xe002;" 
+d="M350 700c193 0 350 -157 350 -350v-50h100l-200 -200l-200 200h100v50c0 138 -112 250 -250 250s-250 -112 -250 -250c0 193 157 350 350 350z" />
+    <glyph glyph-name="3" unicode="&#xe003;" 
+d="M450 700c193 0 350 -157 350 -350c0 138 -112 250 -250 250s-250 -112 -250 -250v-50h100l-200 -200l-200 200h100v50c0 193 157 350 350 350z" />
+    <glyph glyph-name="4" unicode="&#xe004;" 
+d="M0 700h800v-100h-800v100zM100 500h600v-100h-600v100zM0 300h800v-100h-800v100zM100 100h600v-100h-600v100z" />
+    <glyph glyph-name="5" unicode="&#xe005;" 
+d="M0 700h800v-100h-800v100zM0 500h600v-100h-600v100zM0 300h800v-100h-800v100zM0 100h600v-100h-600v100z" />
+    <glyph glyph-name="6" unicode="&#xe006;" 
+d="M0 700h800v-100h-800v100zM200 500h600v-100h-600v100zM0 300h800v-100h-800v100zM200 100h600v-100h-600v100z" />
+    <glyph glyph-name="7" unicode="&#xe007;" 
+d="M400 700c75 0 146 -23 206 -59l-75 -225l-322 234c57 31 122 50 191 50zM125 588l191 -138l-310 -222c-4 24 -6 47 -6 72c0 114 49 215 125 288zM688 575c69 -72 112 -168 112 -275c0 -35 -8 -68 -16 -100h-218zM216 253l112 -347c-128 23 -232 109 -287 222zM372 100
+h372c-64 -109 -177 -185 -310 -197z" />
+    <glyph glyph-name="8" unicode="&#xe008;" horiz-adv-x="600" 
+d="M200 800h100v-500h200l-247 -300l-253 300h200v500z" />
+    <glyph glyph-name="9" unicode="&#xe009;" 
+d="M400 800c221 0 400 -179 400 -400s-179 -400 -400 -400s-400 179 -400 400s179 400 400 400zM300 700v-300h-200l300 -300l300 300h-200v300h-200z" />
+    <glyph glyph-name="a" unicode="&#xe00a;" 
+d="M400 800c221 0 400 -179 400 -400s-179 -400 -400 -400s-400 179 -400 400s179 400 400 400zM400 700l-300 -300l300 -300v200h300v200h-300v200z" />
+    <glyph glyph-name="b" unicode="&#xe00b;" 
+d="M400 800c221 0 400 -179 400 -400s-179 -400 -400 -400s-400 179 -400 400s179 400 400 400zM400 700v-200h-300v-200h300v-200l300 300z" />
+    <glyph glyph-name="c" unicode="&#xe00c;" 
+d="M400 800c221 0 400 -179 400 -400s-179 -400 -400 -400s-400 179 -400 400s179 400 400 400zM400 700l-300 -300h200v-300h200v300h200z" />
+    <glyph glyph-name="d" unicode="&#xe00d;" 
+d="M300 600v-200h500v-100h-500v-200l-300 247z" />
+    <glyph glyph-name="e" unicode="&#xe00e;" 
+d="M500 600l300 -247l-300 -253v200h-500v100h500v200z" />
+    <glyph glyph-name="f" unicode="&#xe00f;" horiz-adv-x="600" 
+d="M200 800h200v-500h200l-297 -300l-303 300h200v500z" />
+    <glyph glyph-name="10" unicode="&#xe010;" 
+d="M300 700v-200h500v-200h-500v-200l-300 297z" />
+    <glyph glyph-name="11" unicode="&#xe011;" 
+d="M500 700l300 -297l-300 -303v200h-500v200h500v200z" />
+    <glyph glyph-name="12" unicode="&#xe012;" horiz-adv-x="600" 
+d="M297 800l303 -300h-200v-500h-200v500h-200z" />
+    <glyph glyph-name="13" unicode="&#xe013;" horiz-adv-x="600" 
+d="M247 800l253 -300h-200v-500h-100v500h-200z" />
+    <glyph glyph-name="14" unicode="&#xe014;" 
+d="M400 800h100v-800h-100v800zM200 700h100v-600h-100v600zM600 600h100v-400h-100v400zM0 500h100v-200h-100v200z" />
+    <glyph glyph-name="15" unicode="&#xe015;" 
+d="M116 600l72 -72c-54 -54 -88 -126 -88 -209s34 -159 88 -213l-72 -72c-72 72 -116 175 -116 285s44 209 116 281zM684 600c72 -72 116 -171 116 -281s-44 -213 -116 -285l-72 72c54 54 88 130 88 213s-34 155 -88 209zM259 460l69 -72c-18 -18 -28 -41 -28 -69
+s10 -54 28 -72l-69 -72c-36 36 -59 89 -59 144s23 105 59 141zM541 459c36 -36 59 -85 59 -140s-23 -108 -59 -144l-69 72c18 18 28 44 28 72s-10 51 -28 69z" />
+    <glyph glyph-name="16" unicode="&#xe016;" horiz-adv-x="400" 
+d="M200 800c110 0 200 -90 200 -200s-90 -200 -200 -200s-200 90 -200 200s90 200 200 200zM100 319c31 -11 65 -19 100 -19s68 8 100 19v-319l-100 100l-100 -100v319z" />
+    <glyph glyph-name="17" unicode="&#xe017;" 
+d="M400 800c220 0 400 -180 400 -400s-180 -400 -400 -400s-400 180 -400 400s180 400 400 400zM400 700c-166 0 -300 -134 -300 -300c0 -66 21 -126 56 -175l419 419c-49 35 -109 56 -175 56zM644 575l-419 -419c49 -35 109 -56 175 -56c166 0 300 134 300 300
+c0 66 -21 126 -56 175z" />
+    <glyph glyph-name="18" unicode="&#xe018;" 
+d="M0 700h100v-600h700v-100h-800v700zM500 700h200v-500h-200v500zM200 500h200v-300h-200v300z" />
+    <glyph glyph-name="19" unicode="&#xe019;" 
+d="M397 800c13 1 23 -4 34 -13c2 -2 214 -254 241 -287h128v-100h-100v-366c0 -18 -16 -34 -34 -34h-532c-18 0 -34 16 -34 34v366h-100v100h128l234 281c9 11 22 18 35 19zM400 672l-144 -172h288zM250 300c-28 0 -50 -22 -50 -50v-100c0 -28 22 -50 50 -50s50 22 50 50
+v100c0 28 -22 50 -50 50zM550 300c-28 0 -50 -22 -50 -50v-100c0 -28 22 -50 50 -50s50 22 50 50v100c0 28 -22 50 -50 50z" />
+    <glyph glyph-name="1a" unicode="&#xe01a;" 
+d="M9 700h682c6 0 9 -4 9 -10v-190h100v-200h-100v-191c0 -6 -3 -9 -9 -9h-682c-6 0 -9 3 -9 9v582c0 6 3 9 9 9zM100 600v-400h500v400h-500z" />
+    <glyph glyph-name="1b" unicode="&#xe01b;" 
+d="M9 700h682c6 0 9 -4 9 -10v-190h100v-200h-100v-191c0 -6 -3 -9 -9 -9h-682c-6 0 -9 3 -9 9v582c0 6 3 9 9 9z" />
+    <glyph glyph-name="1c" unicode="&#xe01c;" 
+d="M92 650c0 23 19 50 45 50h3h5h5h500c28 0 50 -22 50 -50s-22 -50 -50 -50h-50v-141c9 -17 120 -231 166 -309c16 -26 34 -61 34 -106c0 -39 -15 -77 -41 -103h-3c-26 -25 -62 -41 -100 -41h-512c-39 0 -77 15 -103 41s-41 64 -41 103c0 46 18 80 34 106
+c46 78 157 292 166 309v141h-50c-2 0 -6 -1 -8 -1c-28 0 -50 23 -50 51zM500 600h-200v-162l-6 -10s-63 -123 -119 -228h450c-56 105 -119 228 -119 228l-6 10v162z" />
+    <glyph glyph-name="1d" unicode="&#xe01d;" 
+d="M400 800c110 0 200 -90 200 -200c0 -104 52 -198 134 -266c41 -34 66 -82 66 -134h-800c0 52 25 100 66 134c82 68 134 162 134 266c0 110 90 200 200 200zM300 100h200c0 -55 -45 -100 -100 -100s-100 45 -100 100z" />
+    <glyph glyph-name="1e" unicode="&#xe01e;" horiz-adv-x="600" 
+d="M150 800h50l350 -250l-225 -147l225 -153l-350 -250h-50v250l-75 -75l-75 75l150 150l-150 150l75 75l75 -75v250zM250 650v-200l150 100zM250 350v-200l150 100z" />
+    <glyph glyph-name="1f" unicode="&#xe01f;" 
+d="M0 800h500c110 0 200 -90 200 -200c0 -47 -17 -91 -44 -125c85 -40 144 -125 144 -225c0 -138 -112 -250 -250 -250h-550v100c55 0 100 45 100 100v400c0 55 -45 100 -100 100v100zM300 700v-200h100c55 0 100 45 100 100s-45 100 -100 100h-100zM300 400v-300h150
+c83 0 150 67 150 150s-67 150 -150 150h-150z" />
+    <glyph glyph-name="20" unicode="&#xe020;" horiz-adv-x="600" 
+d="M300 800v-300h200l-300 -500v300h-200z" />
+    <glyph glyph-name="21" unicode="&#xe021;" 
+d="M100 800h300v-300l100 100l100 -100v300h50c28 0 50 -22 50 -50v-550h-550c-28 0 -50 -22 -50 -50s22 -50 50 -50h550v-100h-550c-83 0 -150 67 -150 150v550l3 19c8 39 39 70 78 78z" />
+    <glyph glyph-name="22" unicode="&#xe022;" horiz-adv-x="400" 
+d="M0 800h400v-800l-200 200l-200 -200v800z" />
+    <glyph glyph-name="23" unicode="&#xe023;" 
+d="M0 800h800v-100h-800v100zM0 600h300v-103h203v103h297v-591c0 -6 -3 -9 -9 -9h-782c-6 0 -9 3 -9 9v591z" />
+    <glyph glyph-name="24" unicode="&#xe024;" 
+d="M300 800h200c55 0 100 -45 100 -100v-100h191c6 0 9 -3 9 -9v-241c0 -28 -22 -50 -50 -50h-700c-28 0 -50 22 -50 50v241c0 6 3 9 9 9h191v100c0 55 45 100 100 100zM300 700v-100h200v100h-200zM0 209c16 -6 32 -9 50 -9h700c18 0 34 3 50 9v-200c0 -6 -3 -9 -9 -9h-782
+c-6 0 -9 3 -9 9v200z" />
+    <glyph glyph-name="25" unicode="&#xe025;" horiz-adv-x="600" 
+d="M300 800c58 0 110 -16 147 -53s53 -89 53 -147h-100c0 39 -11 61 -25 75s-36 25 -75 25c-35 0 -55 -10 -72 -31s-28 -55 -28 -94c0 -51 20 -107 28 -175h172v-100h-178c-14 -60 -49 -127 -113 -200h491v-100h-600v122l16 12c69 69 95 121 106 166h-122v100h125
+c-8 50 -25 106 -25 175c0 58 16 114 50 156c34 43 88 69 150 69z" />
+    <glyph glyph-name="26" unicode="&#xe026;" 
+d="M34 700h4h3h4h5h700c28 0 50 -22 50 -50v-700c0 -28 -22 -50 -50 -50h-700c-28 0 -50 22 -50 50v700v2c0 20 15 42 34 48zM150 600c-28 0 -50 -22 -50 -50s22 -50 50 -50s50 22 50 50s-22 50 -50 50zM350 600c-28 0 -50 -22 -50 -50s22 -50 50 -50h300c28 0 50 22 50 50
+s-22 50 -50 50h-300zM100 400v-400h600v400h-600z" />
+    <glyph glyph-name="27" unicode="&#xe027;" 
+d="M744 797l6 -3l44 -44c4 -4 3 -8 0 -12l-266 -375l-15 -13l-25 -12c-23 72 -78 127 -150 150l12 25l13 15l375 266zM266 400c74 0 134 -60 134 -134c0 -147 -119 -266 -266 -266c-48 0 -95 12 -134 34c80 46 134 133 134 232c0 74 58 134 132 134z" />
+    <glyph glyph-name="28" unicode="&#xe028;" 
+d="M9 451c0 23 19 50 46 50c8 0 19 -3 26 -7l131 -66l29 22c-79 81 -1 250 118 250s197 -167 119 -250l28 -22l131 66c6 4 12 7 21 7c28 0 50 -22 50 -50c0 -17 -12 -37 -27 -45l-115 -56c9 -16 19 -33 25 -50h68c28 0 50 -22 50 -50s-22 -50 -50 -50h-50
+c0 -23 -2 -45 -6 -66l78 -40c21 -5 37 -28 37 -49c0 -28 -22 -50 -50 -50c-10 0 -23 5 -31 11l-65 35c-24 -46 -62 -86 -103 -110c-35 19 -60 45 -60 72v135v4v5v6v5v5v87c0 28 -22 50 -50 50c-24 0 -45 -17 -50 -40c1 -3 1 -8 1 -11s0 -8 -1 -11v-82v-4v-5v-144
+c0 -28 -24 -53 -59 -72c-41 25 -79 64 -103 110l-66 -35c-8 -6 -21 -11 -31 -11c-28 0 -50 22 -50 50c0 21 16 44 37 49l78 40c-4 21 -6 43 -6 66h-50h-5c-28 0 -50 22 -50 50c0 26 22 50 50 50h5h69c6 17 16 34 25 50l-116 56c-16 7 -28 27 -28 45z" />
+    <glyph glyph-name="29" unicode="&#xe029;" 
+d="M600 700h91c6 0 9 -3 9 -9v-582c0 -6 -3 -9 -9 -9h-91v600zM210 503l290 147v-500l-250 125v-3c-15 0 -25 -8 -28 -22l75 -178c11 -25 0 -58 -25 -69s-58 0 -69 25l-103 272h-91c-6 0 -9 3 -9 9v182c0 6 3 9 9 9h182z" />
+    <glyph glyph-name="2a" unicode="&#xe02a;" 
+d="M9 800h682c6 0 9 -3 9 -9v-782c0 -6 -3 -9 -9 -9h-682c-6 0 -9 3 -9 9v782c0 6 3 9 9 9zM100 700v-200h500v200h-500zM100 400v-100h100v100h-100zM300 400v-100h100v100h-100zM500 400v-300h100v300h-100zM100 200v-100h100v100h-100zM300 200v-100h100v100h-100z" />
+    <glyph glyph-name="2b" unicode="&#xe02b;" 
+d="M0 800h700v-200h-700v200zM0 500h700v-491c0 -6 -3 -9 -9 -9h-682c-6 0 -9 3 -9 9v491zM100 400v-100h100v100h-100zM300 400v-100h100v100h-100zM500 400v-100h100v100h-100zM100 200v-100h100v100h-100zM300 200v-100h100v100h-100z" />
+    <glyph glyph-name="2c" unicode="&#xe02c;" 
+d="M409 800h182c6 0 10 -4 12 -9l94 -182c2 -5 6 -9 12 -9h82c6 0 9 -3 9 -9v-582c0 -6 -3 -9 -9 -9h-782c-6 0 -9 3 -9 9v441c0 83 67 150 150 150h141c6 0 10 4 12 9l94 182c2 5 6 9 12 9zM150 500c-28 0 -50 -22 -50 -50s22 -50 50 -50s50 22 50 50s-22 50 -50 50z
+M500 500c-110 0 -200 -90 -200 -200s90 -200 200 -200s200 90 200 200s-90 200 -200 200zM500 400c55 0 100 -45 100 -100s-45 -100 -100 -100s-100 45 -100 100s45 100 100 100z" />
+    <glyph glyph-name="2d" unicode="&#xe02d;" 
+d="M0 600h800l-400 -400z" />
+    <glyph glyph-name="2e" unicode="&#xe02e;" horiz-adv-x="400" 
+d="M400 800v-800l-400 400z" />
+    <glyph glyph-name="2f" unicode="&#xe02f;" horiz-adv-x="400" 
+d="M0 800l400 -400l-400 -400v800z" />
+    <glyph glyph-name="30" unicode="&#xe030;" 
+d="M400 600l400 -400h-800z" />
+    <glyph glyph-name="31" unicode="&#xe031;" 
+d="M0 550c0 23 20 50 46 50h3h5h4h200c17 0 37 -13 44 -28l38 -72h444c14 0 19 -12 15 -25l-81 -250c-4 -13 -21 -25 -35 -25h-350c-14 0 -30 12 -34 25c-27 83 -54 167 -81 250l-10 25h-150c-2 0 -5 -1 -7 -1c-28 0 -51 23 -51 51zM358 100c28 0 50 -22 50 -50
+s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM658 100c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50z" />
+    <glyph glyph-name="32" unicode="&#xe032;" 
+d="M0 700h500v-100h-300v-300h-100l-100 -100v500zM300 500h500v-500l-100 100h-400v400z" />
+    <glyph glyph-name="33" unicode="&#xe033;" 
+d="M641 700l143 -141l-493 -493c-71 76 -146 148 -219 222l-72 71l141 141c50 -51 101 -101 153 -150c116 117 234 231 347 350z" />
+    <glyph glyph-name="34" unicode="&#xe034;" 
+d="M150 600l250 -250l250 250l150 -150l-400 -400l-400 400z" />
+    <glyph glyph-name="35" unicode="&#xe035;" horiz-adv-x="600" 
+d="M400 800l150 -150l-250 -250l250 -250l-150 -150l-400 400z" />
+    <glyph glyph-name="36" unicode="&#xe036;" horiz-adv-x="600" 
+d="M150 800l400 -400l-400 -400l-150 150l250 250l-250 250z" />
+    <glyph glyph-name="37" unicode="&#xe037;" 
+d="M400 600l400 -400l-150 -150l-250 250l-250 -250l-150 150z" />
+    <glyph glyph-name="38" unicode="&#xe038;" 
+d="M400 800c221 0 400 -179 400 -400s-179 -400 -400 -400s-400 179 -400 400s179 400 400 400zM600 622l-250 -250l-100 100l-72 -72l172 -172l322 322z" />
+    <glyph glyph-name="39" unicode="&#xe039;" 
+d="M400 800c221 0 400 -179 400 -400s-179 -400 -400 -400s-400 179 -400 400s179 400 400 400zM250 622l-72 -72l150 -150l-150 -150l72 -72l150 150l150 -150l72 72l-150 150l150 150l-72 72l-150 -150z" />
+    <glyph glyph-name="3a" unicode="&#xe03a;" 
+d="M350 800c28 0 50 -22 50 -50v-50h75c14 0 25 -11 25 -25v-75h-300v75c0 14 11 25 25 25h75v50c0 28 22 50 50 50zM25 700h75v-200h500v200h75c14 0 25 -11 25 -25v-650c0 -14 -11 -25 -25 -25h-650c-14 0 -25 11 -25 25v650c0 14 11 25 25 25z" />
+    <glyph glyph-name="3b" unicode="&#xe03b;" 
+d="M400 800c220 0 400 -180 400 -400s-180 -400 -400 -400s-400 180 -400 400s180 400 400 400zM400 700c-166 0 -300 -134 -300 -300s134 -300 300 -300s300 134 300 300s-134 300 -300 300zM350 600h100v-181c23 -24 47 -47 72 -69l-72 -72c-27 30 -55 59 -84 88l-16 12
+v222z" />
+    <glyph glyph-name="3c" unicode="&#xe03c;" 
+d="M450 800c138 0 250 -112 250 -250v-50c58 -21 100 -85 100 -150c0 -18 -3 -34 -9 -50h-191v50c0 83 -67 150 -150 150s-150 -67 -150 -150v-50h-272c-17 30 -28 63 -28 100c0 110 90 200 200 200c23 114 129 200 250 200zM434 400h3h4c3 0 6 1 9 1c28 0 50 -22 50 -50v-1
+v-150h150l-200 -200l-200 200h150v150v2c0 20 15 42 34 48z" />
+    <glyph glyph-name="3d" unicode="&#xe03d;" 
+d="M450 800c138 0 250 -112 250 -250v-50c58 -21 100 -85 100 -150c0 -18 -3 -34 -9 -50h-141l-200 200l-200 -200h-222c-17 30 -28 63 -28 100c0 110 90 200 200 200c23 114 129 200 250 200zM450 350l250 -250h-200v-50c0 -28 -22 -50 -50 -50s-50 22 -50 50v50h-200z" />
+    <glyph glyph-name="3e" unicode="&#xe03e;" 
+d="M450 700c138 0 250 -112 250 -250v-50c58 -21 100 -85 100 -150c0 -83 -67 -150 -150 -150h-450c-110 0 -200 90 -200 200s90 200 200 200c23 114 129 200 250 200z" />
+    <glyph glyph-name="3f" unicode="&#xe03f;" 
+d="M250 800c82 0 154 -40 200 -100c-143 0 -270 -85 -325 -209c-36 -10 -70 -25 -100 -47c-16 33 -25 67 -25 106c0 138 112 250 250 250zM450 600c138 0 250 -112 250 -250v-50c58 -21 100 -85 100 -150c0 -83 -67 -150 -150 -150h-450c-110 0 -200 90 -200 200
+s90 200 200 200c23 114 129 200 250 200z" />
+    <glyph glyph-name="40" unicode="&#xe040;" 
+d="M500 700h100l-300 -600h-100zM100 600h100l-100 -200l100 -200h-100l-100 200zM600 600h100l100 -200l-100 -200h-100l100 200z" />
+    <glyph glyph-name="41" unicode="&#xe041;" 
+d="M350 800h100l50 -119l28 -12l119 50l72 -72l-50 -119l12 -28l119 -50v-100l-119 -50l-12 -28l50 -119l-72 -72l-119 50l-28 -12l-50 -119h-100l-50 119l-28 12l-119 -50l-72 72l50 119l-12 28l-119 50v100l119 50l12 28l-50 119l72 72l119 -50l28 12zM400 550
+c-83 0 -150 -67 -150 -150s67 -150 150 -150s150 67 150 150s-67 150 -150 150z" />
+    <glyph glyph-name="42" unicode="&#xe042;" 
+d="M0 800h800v-200h-800v200zM200 500h400l-200 -200zM0 100h800v-100h-800v100z" />
+    <glyph glyph-name="43" unicode="&#xe043;" 
+d="M0 800h100v-800h-100v800zM600 800h200v-800h-200v800zM500 600v-400l-200 200z" />
+    <glyph glyph-name="44" unicode="&#xe044;" 
+d="M0 800h200v-800h-200v800zM700 800h100v-800h-100v800zM300 600l200 -200l-200 -200v400z" />
+    <glyph glyph-name="45" unicode="&#xe045;" 
+d="M0 800h800v-100h-800v100zM400 500l200 -200h-400zM0 200h800v-200h-800v200z" />
+    <glyph glyph-name="46" unicode="&#xe046;" 
+d="M150 700c83 0 150 -67 150 -150v-50h100v50c0 83 67 150 150 150s150 -67 150 -150s-67 -150 -150 -150h-50v-100h50c83 0 150 -67 150 -150s-67 -150 -150 -150s-150 67 -150 150v50h-100v-50c0 -83 -67 -150 -150 -150s-150 67 -150 150s67 150 150 150h50v100h-50
+c-83 0 -150 67 -150 150s67 150 150 150zM150 600c-28 0 -50 -22 -50 -50s22 -50 50 -50h50v50c0 28 -22 50 -50 50zM550 600c-28 0 -50 -22 -50 -50v-50h50c28 0 50 22 50 50s-22 50 -50 50zM300 400v-100h100v100h-100zM150 200c-28 0 -50 -22 -50 -50s22 -50 50 -50
+s50 22 50 50v50h-50zM500 200v-50c0 -28 22 -50 50 -50s50 22 50 50s-22 50 -50 50h-50z" />
+    <glyph glyph-name="47" unicode="&#xe047;" 
+d="M0 791c0 5 4 9 9 9h782c6 0 9 -4 9 -10v-790l-200 200h-591c-6 0 -9 3 -9 9v582z" />
+    <glyph glyph-name="48" unicode="&#xe048;" 
+d="M400 800c220 0 400 -180 400 -400s-180 -400 -400 -400s-400 180 -400 400s180 400 400 400zM400 700c-166 0 -300 -134 -300 -300s134 -300 300 -300s300 134 300 300s-134 300 -300 300zM600 600l-100 -300l-300 -100l100 300zM400 450c-28 0 -50 -22 -50 -50
+s22 -50 50 -50s50 22 50 50s-22 50 -50 50z" />
+    <glyph glyph-name="49" unicode="&#xe049;" 
+d="M400 800c220 0 400 -180 400 -400s-180 -400 -400 -400s-400 180 -400 400s180 400 400 400zM400 700v-600c166 0 300 134 300 300s-134 300 -300 300z" />
+    <glyph glyph-name="4a" unicode="&#xe04a;" 
+d="M0 800h800v-100h-800v100zM0 600h500v-100h-500v100zM0 300h800v-100h-800v100zM0 100h600v-100h-600v100zM750 100c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50z" />
+    <glyph glyph-name="4b" unicode="&#xe04b;" 
+d="M25 700h750c14 0 25 -11 25 -25v-75h-800v75c0 14 11 25 25 25zM0 500h800v-375c0 -14 -11 -25 -25 -25h-750c-14 0 -25 11 -25 25v375zM100 300v-100h100v100h-100zM300 300v-100h100v100h-100z" />
+    <glyph glyph-name="4c" unicode="&#xe04c;" 
+d="M100 800h100v-100h450l100 100l50 -50l-100 -100v-450h100v-100h-100v-100h-100v100h-500v500h-100v100h100v100zM200 600v-350l350 350h-350zM600 550l-350 -350h350v350z" />
+    <glyph glyph-name="4d" unicode="&#xe04d;" 
+d="M400 800c220 0 400 -180 400 -400s-180 -400 -400 -400s-400 180 -400 400s180 400 400 400zM400 700c-166 0 -300 -134 -300 -300s134 -300 300 -300s300 134 300 300s-134 300 -300 300zM400 600c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50z
+M200 452c0 20 15 42 34 48h3h3h8c12 0 28 -7 36 -16l91 -90l25 6c55 0 100 -45 100 -100s-45 -100 -100 -100s-100 45 -100 100l6 25l-90 91c-9 8 -16 24 -16 36zM550 500c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50z" />
+    <glyph glyph-name="4e" unicode="&#xe04e;" 
+d="M300 800h200v-300h200l-300 -300l-300 300h200v300zM0 100h800v-100h-800v100z" />
+    <glyph glyph-name="4f" unicode="&#xe04f;" 
+d="M0 800h800v-100h-800v100zM400 600l300 -300h-200v-300h-200v300h-200z" />
+    <glyph glyph-name="50" unicode="&#xe050;" 
+d="M200 700h600v-600h-600l-200 300zM350 622l-72 -72l150 -150l-150 -150l72 -72l150 150l150 -150l72 72l-150 150l150 150l-72 72l-150 -150z" />
+    <glyph glyph-name="51" unicode="&#xe051;" 
+d="M400 700c220 0 400 -180 400 -400h-100c0 166 -134 300 -300 300s-300 -134 -300 -300h-100c0 220 180 400 400 400zM341 491l59 -88l59 88c81 -25 141 -101 141 -191c0 -110 -90 -200 -200 -200s-200 90 -200 200c0 90 60 166 141 191z" />
+    <glyph glyph-name="52" unicode="&#xe052;" 
+d="M0 800h300v-400h400v-400h-700v800zM400 800l300 -300h-300v300zM100 600v-100h100v100h-100zM100 400v-100h100v100h-100zM100 200v-100h400v100h-400z" />
+    <glyph glyph-name="53" unicode="&#xe053;" horiz-adv-x="600" 
+d="M200 700h100v-100h75c30 0 58 -6 81 -22s44 -44 44 -78v-100h-100v94c-4 3 -13 6 -25 6h-250c-14 0 -25 -11 -25 -25v-50c0 -15 20 -40 34 -44l257 -65c66 -16 109 -73 109 -141v-50c0 -68 -57 -125 -125 -125h-75v-100h-100v100h-75c-30 0 -58 6 -81 22s-44 44 -44 78
+v100h100v-94c4 -3 13 -6 25 -6h250c14 0 25 11 25 25v50c0 15 -20 40 -34 44l-257 65c-66 16 -109 73 -109 141v50c0 68 57 125 125 125h75v100z" />
+    <glyph glyph-name="54" unicode="&#xe054;" 
+d="M0 700h300v-300l-300 -300v600zM500 700h300v-300l-300 -300v600z" />
+    <glyph glyph-name="55" unicode="&#xe055;" 
+d="M300 700v-600h-300v300zM800 700v-600h-300v300z" />
+    <glyph glyph-name="56" unicode="&#xe056;" 
+d="M300 700v-100c-111 0 -200 -89 -200 -200h200v-300h-300v300c0 165 135 300 300 300zM800 700v-100c-111 0 -200 -89 -200 -200h200v-300h-300v300c0 165 135 300 300 300z" />
+    <glyph glyph-name="57" unicode="&#xe057;" 
+d="M0 700h300v-300c0 -165 -135 -300 -300 -300v100c111 0 200 89 200 200h-200v300zM500 700h300v-300c0 -165 -135 -300 -300 -300v100c111 0 200 89 200 200h-200v300z" />
+    <glyph glyph-name="58" unicode="&#xe058;" horiz-adv-x="600" 
+d="M300 800l34 -34c11 -11 266 -270 266 -488c0 -165 -135 -300 -300 -300s-300 135 -300 300c0 218 255 477 266 488zM150 328c-28 0 -50 -22 -50 -50c0 -110 90 -200 200 -200c28 0 50 22 50 50s-22 50 -50 50c-55 0 -100 45 -100 100c0 28 -22 50 -50 50z" />
+    <glyph glyph-name="59" unicode="&#xe059;" 
+d="M400 800l400 -500h-800zM0 200h800v-200h-800v200z" />
+    <glyph glyph-name="5a" unicode="&#xe05a;" horiz-adv-x="600" 
+d="M300 800l300 -300h-600zM0 300h600l-300 -300z" />
+    <glyph glyph-name="5b" unicode="&#xe05b;" 
+d="M0 500h200v-200h-200v200zM300 500h200v-200h-200v200zM600 500h200v-200h-200v200z" />
+    <glyph glyph-name="5c" unicode="&#xe05c;" 
+d="M0 700h800v-100l-400 -200l-400 200v100zM0 500l400 -200l400 200v-400h-800v400z" />
+    <glyph glyph-name="5d" unicode="&#xe05d;" 
+d="M400 800l400 -200v-600h-800v600zM400 688l-300 -150v-188l300 -150l300 150v188zM200 500h400v-100l-200 -100l-200 100v100z" />
+    <glyph glyph-name="5e" unicode="&#xe05e;" 
+d="M600 700c69 0 134 -19 191 -50l-16 -106c-49 35 -109 56 -175 56c-131 0 -240 -84 -281 -200h331l-16 -100h-334c0 -36 8 -68 19 -100h297l-16 -100h-222c55 -61 133 -100 222 -100c78 0 147 30 200 78v-122c-59 -35 -127 -56 -200 -56c-147 0 -274 82 -344 200h-256
+l19 100h197c-8 32 -16 66 -16 100h-200l25 100h191c45 172 198 300 384 300z" />
+    <glyph glyph-name="5f" unicode="&#xe05f;" 
+d="M0 700h700v-100h-700v100zM0 500h500v-100h-500v100zM0 300h800v-100h-800v100zM0 100h100v-100h-100v100zM200 100h100v-100h-100v100zM400 100h100v-100h-100v100z" />
+    <glyph glyph-name="60" unicode="&#xe060;" 
+d="M0 800h800v-100h-800v100zM200 600h400l-200 -200zM0 200h800v-200h-800v200z" />
+    <glyph glyph-name="61" unicode="&#xe061;" 
+d="M0 800h100v-800h-100v800zM600 800h200v-800h-200v800zM200 600l200 -200l-200 -200v400z" />
+    <glyph glyph-name="62" unicode="&#xe062;" 
+d="M0 800h200v-800h-200v800zM700 800h100v-800h-100v800zM600 600v-400l-200 200z" />
+    <glyph glyph-name="63" unicode="&#xe063;" 
+d="M0 800h800v-200h-800v200zM400 400l200 -200h-400zM0 100h800v-100h-800v100z" />
+    <glyph glyph-name="64" unicode="&#xe064;" 
+d="M0 800h200v-100h-100v-600h600v100h100v-200h-800v800zM400 800h400v-400l-150 150l-250 -250l-100 100l250 250z" />
+    <glyph glyph-name="65" unicode="&#xe065;" 
+d="M403 700c247 0 397 -300 397 -300s-150 -300 -397 -300c-253 0 -403 300 -403 300s150 300 403 300zM400 600c-110 0 -200 -90 -200 -200s90 -200 200 -200s200 90 200 200s-90 200 -200 200zM400 500c10 0 19 -3 28 -6c-16 -8 -28 -24 -28 -44c0 -28 22 -50 50 -50
+c20 0 36 12 44 28c3 -9 6 -18 6 -28c0 -55 -45 -100 -100 -100s-100 45 -100 100s45 100 100 100z" />
+    <glyph glyph-name="66" unicode="&#xe066;" horiz-adv-x="900" 
+d="M331 700h3h3c3 1 7 1 10 1c12 0 29 -8 37 -17l94 -93l66 65c57 57 155 57 212 0c58 -58 58 -154 0 -212l-65 -66l93 -94c10 -8 18 -25 18 -38c0 -28 -22 -50 -50 -50c-13 0 -32 9 -40 20l-62 65l-381 -381h-269v272l375 381l-63 63c-9 8 -16 24 -16 36c0 20 16 42 35 48z
+M447 481l-313 -315l128 -132l316 316z" />
+    <glyph glyph-name="67" unicode="&#xe067;" 
+d="M0 800h300v-400h400v-400h-700v800zM400 800l300 -300h-300v300z" />
+    <glyph glyph-name="68" unicode="&#xe068;" 
+d="M200 800c0 0 200 -100 200 -300s-298 -302 -200 -500c0 0 -200 100 -200 300s300 300 200 500zM500 500c0 0 200 -100 200 -300c0 -150 -60 -200 -100 -200h-300c0 200 300 300 200 500z" />
+    <glyph glyph-name="69" unicode="&#xe069;" 
+d="M0 800h100v-800h-100v800zM200 800h300v-100h300l-200 -203l200 -197h-400v100h-200v400z" />
+    <glyph glyph-name="6a" unicode="&#xe06a;" horiz-adv-x="400" 
+d="M150 800h150l-100 -200h200l-150 -300h150l-300 -300l-100 300h134l66 200h-200z" />
+    <glyph glyph-name="6b" unicode="&#xe06b;" 
+d="M0 800h300v-100h500v-100h-800v200zM0 500h800v-450c0 -28 -22 -50 -50 -50h-700c-28 0 -50 22 -50 50v450z" />
+    <glyph glyph-name="6c" unicode="&#xe06c;" 
+d="M150 800c83 0 150 -67 150 -150c0 -66 -41 -121 -100 -141v-118c15 5 33 9 50 9h200c28 0 50 22 50 50v59c-59 20 -100 75 -100 141c0 83 67 150 150 150s150 -67 150 -150c0 -66 -41 -121 -100 -141v-59c0 -82 -68 -150 -150 -150h-200c-14 0 -25 -7 -34 -16
+c50 -24 84 -74 84 -134c0 -83 -67 -150 -150 -150s-150 67 -150 150c0 66 41 121 100 141v218c-59 20 -100 75 -100 141c0 83 67 150 150 150z" />
+    <glyph glyph-name="6d" unicode="&#xe06d;" 
+d="M0 800h400l-150 -150l150 -150l-100 -100l-150 150l-150 -150v400zM500 400l150 -150l150 150v-400h-400l150 150l-150 150z" />
+    <glyph glyph-name="6e" unicode="&#xe06e;" 
+d="M100 800l150 -150l150 150v-400h-400l150 150l-150 150zM400 400h400l-150 -150l150 -150l-100 -100l-150 150l-150 -150v400z" />
+    <glyph glyph-name="6f" unicode="&#xe06f;" 
+d="M400 800c221 0 400 -179 400 -400s-179 -400 -400 -400s-400 179 -400 400s179 400 400 400zM400 700c-56 0 -108 -17 -153 -44l22 -19c33 -18 13 -48 -13 -59c-30 -13 -77 10 -65 -41c13 -55 -27 -3 -47 -15c-42 -26 49 -152 31 -156l-59 34c-8 0 -13 -5 -16 -10
+c1 -30 10 -57 19 -84c28 -11 77 -2 100 -25c47 -28 97 -115 75 -159c34 -13 68 -22 106 -22c101 0 193 48 247 125c3 24 -8 44 -50 44c-69 0 -156 13 -153 97c2 46 101 108 66 143c-30 30 12 39 12 66c0 37 -65 32 -69 50s20 36 41 56c-30 10 -60 19 -94 19zM631 591
+c-38 -11 -94 -35 -87 -53c6 -15 52 -1 65 -13c11 -10 16 -59 44 -31l22 22v3c-11 26 -26 50 -44 72z" />
+    <glyph glyph-name="70" unicode="&#xe070;" 
+d="M703 800l97 -100l-400 -400l-100 100l-200 -203l-100 100l300 303l100 -100zM0 100h800v-100h-800v100z" />
+    <glyph glyph-name="71" unicode="&#xe071;" 
+d="M0 700h100v-100h-100v100zM200 700h100v-100h-100v100zM400 700h100v-100h-100v100zM600 700h100v-100h-100v100zM0 500h100v-100h-100v100zM200 500h100v-100h-100v100zM400 500h100v-100h-100v100zM600 500h100v-100h-100v100zM0 300h100v-100h-100v100zM200 300h100
+v-100h-100v100zM400 300h100v-100h-100v100zM600 300h100v-100h-100v100zM0 100h100v-100h-100v100zM200 100h100v-100h-100v100zM400 100h100v-100h-100v100zM600 100h100v-100h-100v100z" />
+    <glyph glyph-name="72" unicode="&#xe072;" 
+d="M0 800h200v-200h-200v200zM300 800h200v-200h-200v200zM600 800h200v-200h-200v200zM0 500h200v-200h-200v200zM300 500h200v-200h-200v200zM600 500h200v-200h-200v200zM0 200h200v-200h-200v200zM300 200h200v-200h-200v200zM600 200h200v-200h-200v200z" />
+    <glyph glyph-name="73" unicode="&#xe073;" 
+d="M0 800h300v-300h-300v300zM500 800h300v-300h-300v300zM0 300h300v-300h-300v300zM500 300h300v-300h-300v300z" />
+    <glyph glyph-name="74" unicode="&#xe074;" 
+d="M19 800h662c11 0 19 -8 19 -19v-331c0 -28 -22 -50 -50 -50h-600c-28 0 -50 22 -50 50v331c0 11 8 19 19 19zM0 309c16 -6 32 -9 50 -9h600c18 0 34 3 50 9v-290c0 -11 -8 -19 -19 -19h-662c-11 0 -19 8 -19 19v290zM550 200c-28 0 -50 -22 -50 -50s22 -50 50 -50
+s50 22 50 50s-22 50 -50 50z" />
+    <glyph glyph-name="75" unicode="&#xe075;" 
+d="M0 700h300v-100h-50c-28 0 -50 -22 -50 -50v-150h300v150c0 28 -22 50 -50 50h-50v100h300v-100h-50c-28 0 -50 -22 -50 -50v-400c0 -28 22 -50 50 -50h50v-100h-300v100h50c28 0 50 22 50 50v150h-300v-150c0 -28 22 -50 50 -50h50v-100h-300v100h50c28 0 50 22 50 50
+v400c0 28 -22 50 -50 50h-50v100z" />
+    <glyph glyph-name="76" unicode="&#xe076;" 
+d="M400 700c165 0 300 -135 300 -300v-100h50c28 0 50 -22 50 -50v-200c0 -28 -22 -50 -50 -50h-100c-28 0 -50 22 -50 50v350c0 111 -89 200 -200 200s-200 -89 -200 -200v-350c0 -28 -22 -50 -50 -50h-100c-28 0 -50 22 -50 50v200c0 28 22 50 50 50h50v100
+c0 165 135 300 300 300z" />
+    <glyph glyph-name="77" unicode="&#xe077;" 
+d="M0 500c0 109 91 200 200 200s200 -91 200 -200c0 109 91 200 200 200s200 -91 200 -200c0 -55 -23 -105 -59 -141l-341 -340l-341 340c-36 36 -59 86 -59 141z" />
+    <glyph glyph-name="78" unicode="&#xe078;" 
+d="M400 700l400 -300l-100 3v-403h-200v200h-200v-200h-200v400h-100z" />
+    <glyph glyph-name="79" unicode="&#xe079;" 
+d="M0 800h800v-800h-800v800zM100 700v-300l100 100l400 -400h100v100l-200 200l100 100l100 -100v300h-600z" />
+    <glyph glyph-name="7a" unicode="&#xe07a;" 
+d="M19 800h762c11 0 19 -8 19 -19v-762c0 -11 -8 -19 -19 -19h-762c-11 0 -19 8 -19 19v762c0 11 8 19 19 19zM100 600v-300h100l100 -100h200l100 100h100v300h-600z" />
+    <glyph glyph-name="7b" unicode="&#xe07b;" 
+d="M200 600c80 0 142 -56 200 -122c58 66 119 122 200 122c131 0 200 -101 200 -200s-69 -200 -200 -200c-81 0 -142 56 -200 122c-58 -66 -121 -122 -200 -122c-131 0 -200 101 -200 200s69 200 200 200zM200 500c-74 0 -100 -54 -100 -100s26 -100 100 -100
+c42 0 88 47 134 100c-46 53 -92 100 -134 100zM600 500c-43 0 -88 -47 -134 -100c46 -53 91 -100 134 -100c74 0 100 54 100 100s-26 100 -100 100z" />
+    <glyph glyph-name="7c" unicode="&#xe07c;" horiz-adv-x="400" 
+d="M300 800c55 0 100 -45 100 -100s-45 -100 -100 -100s-100 45 -100 100s45 100 100 100zM150 550c83 0 150 -69 150 -150c0 -66 -100 -214 -100 -250c0 -28 22 -50 50 -50s50 22 50 50h100c0 -83 -67 -150 -150 -150s-150 64 -150 150s100 222 100 250s-22 50 -50 50
+s-50 -22 -50 -50h-100c0 83 67 150 150 150z" />
+    <glyph glyph-name="7d" unicode="&#xe07d;" 
+d="M200 800h500v-100h-122c-77 -197 -156 -392 -234 -588l-6 -12h162v-100h-500v100h122c77 197 156 392 234 588l7 12h-163v100z" />
+    <glyph glyph-name="7e" unicode="&#xe07e;" 
+d="M0 700h800v-100h-800v100zM0 500h800v-100h-800v100zM0 300h800v-100h-800v100zM100 100h600v-100h-600v100z" />
+    <glyph glyph-name="7f" unicode="&#xe07f;" 
+d="M0 700h800v-100h-800v100zM0 500h800v-100h-800v100zM0 300h800v-100h-800v100zM0 100h600v-100h-600v100z" />
+    <glyph glyph-name="80" unicode="&#xe080;" 
+d="M0 700h800v-100h-800v100zM0 500h800v-100h-800v100zM0 300h800v-100h-800v100zM200 100h600v-100h-600v100z" />
+    <glyph glyph-name="81" unicode="&#xe081;" 
+d="M550 800c138 0 250 -112 250 -250s-112 -250 -250 -250c-16 0 -32 0 -47 3l-3 -3v-100h-200v-200h-300v200l303 303c-3 15 -3 31 -3 47c0 138 112 250 250 250zM600 700c-55 0 -100 -45 -100 -100s45 -100 100 -100s100 45 100 100s-45 100 -100 100z" />
+    <glyph glyph-name="82" unicode="&#xe082;" 
+d="M134 600h3h4h4h5h500c28 0 50 -22 50 -50v-350h100v-150c0 -28 -22 -50 -50 -50h-700c-28 0 -50 22 -50 50v150h100v350v2c0 20 15 42 34 48zM200 500v-300h100v-100h200v100h100v300h-400z" />
+    <glyph glyph-name="83" unicode="&#xe083;" 
+d="M0 800h400v-400h-400v400zM500 600h100v-400h-400v100h300v300zM700 400h100v-400h-400v100h300v300z" />
+    <glyph glyph-name="84" unicode="&#xe084;" horiz-adv-x="600" 
+d="M337 694c6 4 12 7 21 7c28 0 50 -22 50 -50c0 -17 -12 -37 -27 -45l-300 -150c-8 -6 -21 -11 -31 -11c-28 0 -50 22 -50 50c0 21 16 44 37 49zM437 544c6 4 12 7 21 7c28 0 50 -22 50 -50c0 -17 -12 -37 -27 -45l-400 -200c-8 -6 -21 -11 -31 -11c-28 0 -50 22 -50 50
+c0 21 16 44 37 49zM437 344c6 4 12 7 21 7c28 0 50 -22 50 -50c0 -17 -12 -37 -27 -45l-106 -56c24 -4 43 -26 43 -50c0 -28 -23 -51 -51 -51c-2 0 -6 1 -8 1h-200c-26 1 -48 24 -48 50c0 16 12 36 26 44zM151 -50c0 23 20 50 46 50h3h4h5h100c28 0 50 -22 50 -50
+s-22 -50 -50 -50h-100c-2 0 -6 -1 -8 -1c-28 0 -50 23 -50 51z" />
+    <glyph glyph-name="85" unicode="&#xe085;" 
+d="M199 800h100v-200h-200v100h100v100zM586 797h1c18 1 38 1 56 -3c36 -8 69 -26 97 -54c78 -78 78 -203 0 -281l-150 -150c-8 -13 -28 -24 -43 -24c-28 0 -50 22 -50 50c0 15 11 35 24 43l150 150c40 40 39 105 0 144c-41 41 -110 34 -144 0l-44 -44
+c-8 -13 -27 -24 -42 -24c-28 0 -50 22 -50 50c0 15 11 35 24 43l43 44c32 33 72 53 128 56zM208 490c4 5 14 16 22 16h3c2 0 6 1 8 1c28 0 50 -22 50 -50c0 -11 -6 -27 -14 -35l-150 -150c-40 -40 -39 -105 0 -144c41 -41 110 -34 144 0l44 44c8 13 27 24 42 24
+c28 0 50 -22 50 -50c0 -15 -11 -35 -24 -43l-43 -44c-22 -22 -48 -37 -75 -47c-70 -25 -151 -9 -207 47c-78 78 -78 203 0 281zM499 200h200v-100h-100v-100h-100v200z" />
+    <glyph glyph-name="86" unicode="&#xe086;" 
+d="M586 797c18 1 39 1 57 -3c36 -8 69 -26 97 -54c78 -78 78 -203 0 -281l-150 -150c-62 -62 -132 -81 -182 -78s-69 17 -84 25s-26 27 -26 44c0 28 22 51 50 51c8 0 19 -3 26 -7c0 0 15 -11 41 -13s62 3 106 47l150 150c40 40 39 105 0 144c-41 41 -110 34 -144 0
+c-8 -13 -28 -24 -43 -24c-28 0 -50 22 -50 50c0 15 11 35 24 43c32 33 72 53 128 56zM386 566c50 -2 64 -17 85 -22s37 -28 37 -49c0 -28 -22 -50 -50 -50c-10 0 -23 5 -31 11c0 0 -19 9 -47 10s-63 -4 -103 -44l-150 -150c-40 -40 -39 -105 0 -144c41 -41 110 -34 144 0
+c8 13 27 24 42 24c28 0 50 -22 50 -50c0 -15 -10 -35 -23 -43c-22 -22 -48 -37 -75 -47c-70 -25 -151 -9 -207 47c-78 78 -78 203 0 281l150 150c60 60 128 78 178 76z" />
+    <glyph glyph-name="87" unicode="&#xe087;" 
+d="M0 700h300v-300h-300v300zM400 700h400v-100h-400v100zM400 500h300v-100h-300v100zM0 300h300v-300h-300v300zM400 300h400v-100h-400v100zM400 100h300v-100h-300v100z" />
+    <glyph glyph-name="88" unicode="&#xe088;" 
+d="M50 700c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM200 700h600v-100h-600v100zM50 500c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM200 500h600v-100h-600v100zM50 300c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50
+s22 50 50 50zM200 300h600v-100h-600v100zM50 100c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM200 100h600v-100h-600v100z" />
+    <glyph glyph-name="89" unicode="&#xe089;" 
+d="M800 800l-400 -800l-100 300l-300 100z" />
+    <glyph glyph-name="8a" unicode="&#xe08a;" horiz-adv-x="600" 
+d="M300 700c110 0 200 -90 200 -200v-100h100v-400h-600v400h100v100c0 110 90 200 200 200zM300 600c-56 0 -100 -44 -100 -100v-100h200v100c0 56 -44 100 -100 100z" />
+    <glyph glyph-name="8b" unicode="&#xe08b;" horiz-adv-x="600" 
+d="M300 800c110 0 200 -90 200 -200v-200h100v-400h-600v400h400v200c0 56 -44 100 -100 100s-100 -44 -100 -100h-100c0 110 90 200 200 200z" />
+    <glyph glyph-name="8c" unicode="&#xe08c;" 
+d="M400 700v-100c-111 0 -200 -89 -200 -200h100l-150 -200l-150 200h100c0 165 135 300 300 300zM650 600l150 -200h-100c0 -165 -135 -300 -300 -300v100c111 0 200 89 200 200h-100z" />
+    <glyph glyph-name="8d" unicode="&#xe08d;" 
+d="M100 800h600v-300h100l-150 -250l-150 250h100v200h-400v-100h-100v200zM150 550l150 -250h-100v-200h400v100h100v-200h-600v300h-100z" />
+    <glyph glyph-name="8e" unicode="&#xe08e;" 
+d="M600 700l200 -150l-200 -150v100h-500v-100h-100v100c0 55 45 100 100 100h500v100zM200 300v-100h500v100h100v-100c0 -55 -45 -100 -100 -100h-500v-100l-200 150z" />
+    <glyph glyph-name="8f" unicode="&#xe08f;" horiz-adv-x="900" 
+d="M350 800c193 0 350 -157 350 -350c0 -60 -17 -117 -44 -166c5 -3 12 -8 16 -12l100 -100c16 -16 30 -49 30 -72c0 -56 -46 -102 -102 -102c-23 0 -56 14 -72 30l-100 100c-4 3 -9 9 -12 13c-49 -26 -107 -41 -166 -41c-193 0 -350 157 -350 350s157 350 350 350zM350 200
+c142 0 250 108 250 250c0 139 -111 250 -250 250s-250 -111 -250 -250s111 -250 250 -250z" />
+    <glyph glyph-name="90" unicode="&#xe090;" horiz-adv-x="600" 
+d="M300 800c166 0 300 -134 300 -300c0 -200 -300 -500 -300 -500s-300 300 -300 500c0 166 134 300 300 300zM300 700c-110 0 -200 -90 -200 -200s90 -200 200 -200s200 90 200 200s-90 200 -200 200z" />
+    <glyph glyph-name="91" unicode="&#xe091;" horiz-adv-x="900" 
+d="M0 800h800v-541c1 -3 1 -8 1 -11s0 -7 -1 -10v-238h-800v800zM495 250c0 26 22 50 50 50h5h150v400h-600v-600h600v100h-150h-5c-28 0 -50 22 -50 50zM350 600c83 0 150 -67 150 -150c0 -100 -150 -250 -150 -250s-150 150 -150 250c0 83 67 150 150 150zM350 500
+c-28 0 -50 -22 -50 -50s22 -50 50 -50s50 22 50 50s-22 50 -50 50z" />
+    <glyph glyph-name="92" unicode="&#xe092;" horiz-adv-x="600" 
+d="M0 700h200v-600h-200v600zM400 700h200v-600h-200v600z" />
+    <glyph glyph-name="93" unicode="&#xe093;" horiz-adv-x="600" 
+d="M0 700l600 -300l-600 -300v600z" />
+    <glyph glyph-name="94" unicode="&#xe094;" horiz-adv-x="600" 
+d="M300 700c166 0 300 -134 300 -300s-134 -300 -300 -300s-300 134 -300 300s134 300 300 300z" />
+    <glyph glyph-name="95" unicode="&#xe095;" 
+d="M400 700v-600l-400 300zM400 400l400 300v-600z" />
+    <glyph glyph-name="96" unicode="&#xe096;" 
+d="M0 700l400 -300l-400 -300v600zM400 100v600l400 -300z" />
+    <glyph glyph-name="97" unicode="&#xe097;" 
+d="M0 700h200v-600h-200v600zM200 400l500 300v-600z" />
+    <glyph glyph-name="98" unicode="&#xe098;" 
+d="M0 700l500 -300l-500 -300v600zM500 100v600h200v-600h-200z" />
+    <glyph glyph-name="99" unicode="&#xe099;" horiz-adv-x="600" 
+d="M0 700h600v-600h-600v600z" />
+    <glyph glyph-name="9a" unicode="&#xe09a;" 
+d="M200 800h400v-200h200v-400h-200v-200h-400v200h-200v400h200v200z" />
+    <glyph glyph-name="9b" unicode="&#xe09b;" 
+d="M0 700h800v-100h-800v100zM0 403h800v-100h-800v100zM0 103h800v-100h-800v100z" />
+    <glyph glyph-name="9c" unicode="&#xe09c;" horiz-adv-x="600" 
+d="M278 700c7 2 13 4 22 4c55 0 100 -45 100 -100v-4v-200c0 -55 -45 -100 -100 -100s-100 45 -100 100v200v2c0 44 35 88 78 98zM34 500h4h3c3 0 6 1 9 1c28 0 50 -22 50 -50v-1v-50c0 -111 89 -200 200 -200s200 89 200 200v50c0 28 22 50 50 50s50 -22 50 -50v-50
+c0 -148 -109 -270 -250 -294v-106h50c55 0 100 -45 100 -100h-400c0 55 45 100 100 100h50v106c-141 24 -250 146 -250 294v50v2c0 20 15 42 34 48z" />
+    <glyph glyph-name="9d" unicode="&#xe09d;" 
+d="M0 500h800v-200h-800v200z" />
+    <glyph glyph-name="9e" unicode="&#xe09e;" 
+d="M34 700h4h3h4h5h700c28 0 50 -22 50 -50v-500c0 -28 -22 -50 -50 -50h-250v-100h100c55 0 100 -45 100 -100h-600c0 55 45 100 100 100h100v100h-250c-28 0 -50 22 -50 50v500v2c0 20 15 42 34 48zM100 600v-400h600v400h-600z" />
+    <glyph glyph-name="9f" unicode="&#xe09f;" 
+d="M272 700c-14 -40 -22 -83 -22 -128c0 -221 179 -400 400 -400c45 0 88 8 128 22c-53 -158 -202 -272 -378 -272c-221 0 -400 179 -400 400c0 176 114 325 272 378z" />
+    <glyph glyph-name="a0" unicode="&#xe0a0;" 
+d="M350 700l150 -150h-100v-150h150v100l150 -150l-150 -150v100h-150v-150h100l-150 -150l-150 150h100v150h-150v-100l-150 150l150 150v-100h150v150h-100z" />
+    <glyph glyph-name="a1" unicode="&#xe0a1;" 
+d="M800 800v-550c0 -83 -67 -150 -150 -150s-150 67 -150 150s67 150 150 150c17 0 35 -4 50 -9v206c-201 -6 -327 -27 -400 -50v-397c0 -83 -67 -150 -150 -150s-150 67 -150 150s67 150 150 150c17 0 35 -4 50 -9v409s100 100 600 100z" />
+    <glyph glyph-name="a2" unicode="&#xe0a2;" horiz-adv-x="700" 
+d="M499 700c51 0 102 -20 141 -59c78 -78 78 -203 0 -281l-250 -244c-48 -48 -127 -48 -175 0s-48 127 0 175l96 97l69 -69l-90 -94l-7 -3c-10 -10 -10 -28 0 -38s28 -10 38 0l250 247c37 40 39 102 0 141s-104 40 -144 0l-278 -275c-66 -69 -68 -179 0 -247
+c69 -69 181 -69 250 0l9 12l116 113l69 -69l-125 -125c-107 -107 -281 -107 -388 0s-107 281 0 388l278 272c39 39 90 59 141 59z" />
+    <glyph glyph-name="a3" unicode="&#xe0a3;" 
+d="M600 800l200 -200l-100 -100l-200 200zM400 600l200 -200l-400 -400h-200v200z" />
+    <glyph glyph-name="a4" unicode="&#xe0a4;" 
+d="M550 800c83 0 150 -90 150 -200s-67 -200 -150 -200c-22 0 -40 8 -59 19c6 26 9 52 9 81c0 84 -27 158 -72 212c27 52 71 88 122 88zM250 700c83 0 150 -90 150 -200s-67 -200 -150 -200s-150 90 -150 200s67 200 150 200zM725 384c44 -22 75 -66 75 -118v-166h-200v66
+c0 50 -17 96 -44 134c66 2 126 33 169 84zM75 284c45 -53 106 -84 175 -84s130 31 175 84c44 -22 75 -66 75 -118v-166h-500v166c0 52 31 96 75 118z" />
+    <glyph glyph-name="a5" unicode="&#xe0a5;" 
+d="M400 800c110 0 200 -112 200 -250s-90 -250 -200 -250s-200 112 -200 250s90 250 200 250zM191 300c54 -61 128 -100 209 -100s155 39 209 100c106 -5 191 -92 191 -200v-100h-800v100c0 108 85 195 191 200z" />
+    <glyph glyph-name="a6" unicode="&#xe0a6;" horiz-adv-x="600" 
+d="M19 800h462c11 0 19 -8 19 -19v-762c0 -11 -8 -19 -19 -19h-462c-11 0 -19 8 -19 19v762c0 11 8 19 19 19zM100 700v-500h300v500h-300zM250 150c-28 0 -50 -22 -50 -50s22 -50 50 -50s50 22 50 50s-22 50 -50 50z" />
+    <glyph glyph-name="a7" unicode="&#xe0a7;" 
+d="M350 800c17 0 34 -1 50 -3v-397l-297 297c63 64 150 103 247 103zM500 694c169 -25 300 -168 300 -344c0 -193 -157 -350 -350 -350c-85 0 -161 31 -222 81l272 272v341zM91 562l237 -234l-212 -212c-70 55 -116 138 -116 234c0 84 35 158 91 212z" />
+    <glyph glyph-name="a8" unicode="&#xe0a8;" 
+d="M92 650c0 23 20 50 46 50h3h4h5h400c28 0 50 -22 50 -50s-22 -50 -50 -50h-50v-200h100c55 0 100 -45 100 -100h-300v-300l-56 -100l-44 100v300h-300c0 55 45 100 100 100h100v200h-50c-2 0 -6 -1 -8 -1c-28 0 -50 23 -50 51z" />
+    <glyph glyph-name="a9" unicode="&#xe0a9;" 
+d="M400 800c221 0 400 -179 400 -400s-179 -400 -400 -400s-400 179 -400 400s179 400 400 400zM300 600v-400l300 200z" />
+    <glyph glyph-name="aa" unicode="&#xe0aa;" 
+d="M300 800h200v-300h300v-200h-300v-300h-200v300h-300v200h300v300z" />
+    <glyph glyph-name="ab" unicode="&#xe0ab;" 
+d="M300 800h100v-400h-100v400zM172 656l62 -78l-40 -31c-58 -46 -94 -117 -94 -197c0 -139 111 -250 250 -250s250 111 250 250c0 80 -39 151 -97 197l-37 31l62 78l38 -31c82 -64 134 -164 134 -275c0 -193 -157 -350 -350 -350s-350 157 -350 350c0 111 53 211 134 275z
+" />
+    <glyph glyph-name="ac" unicode="&#xe0ac;" 
+d="M200 800h400v-200h-400v200zM9 500h782c6 0 9 -3 9 -9v-282c0 -6 -3 -9 -9 -9h-91v200h-600v-200h-91c-6 0 -9 3 -9 9v282c0 6 3 9 9 9zM200 300h400v-300h-400v300z" />
+    <glyph glyph-name="ad" unicode="&#xe0ad;" 
+d="M0 700h100v-700h-100v700zM700 700h100v-700h-100v700zM200 600h200v-100h-200v100zM300 400h200v-100h-200v100zM400 200h200v-100h-200v100z" />
+    <glyph glyph-name="ae" unicode="&#xe0ae;" 
+d="M325 700c42 -141 87 -280 131 -419c29 74 59 148 88 222c30 -57 58 -114 87 -172h169v-100h-231l-13 28c-37 -92 -74 -184 -112 -275c-38 129 -79 257 -119 385c-42 -133 -83 -267 -125 -400c-28 88 -56 175 -84 262h-116v100h188l9 -34l3 -6c42 137 83 273 125 409z" />
+    <glyph glyph-name="af" unicode="&#xe0af;" 
+d="M200 600c0 57 43 100 100 100s100 -43 100 -100c0 -28 -18 -48 -28 -72c-3 -6 -3 -16 -3 -28h231v-231c12 0 22 0 28 3c24 10 44 28 72 28c57 0 100 -43 100 -100s-43 -100 -100 -100c-28 0 -48 18 -72 28c-6 3 -16 3 -28 3v-231h-231c0 12 0 22 3 28c10 24 28 44 28 72
+c0 57 -43 100 -100 100s-100 -43 -100 -100c0 -28 18 -48 28 -72c3 -6 3 -16 3 -28h-231v600h231c0 12 0 22 -3 28c-10 24 -28 44 -28 72z" />
+    <glyph glyph-name="b0" unicode="&#xe0b0;" horiz-adv-x="500" 
+d="M247 700c84 0 148 -20 191 -59s59 -93 59 -141c0 -117 -69 -181 -119 -225s-81 -67 -81 -150v-25h-100v25c0 117 65 181 115 225s85 67 85 150c0 25 -8 48 -28 66s-56 34 -122 34s-97 -18 -116 -37s-27 -43 -31 -69l-100 12c5 38 19 88 59 128s103 66 188 66zM197 0h100
+v-100h-100v100z" />
+    <glyph glyph-name="b1" unicode="&#xe0b1;" 
+d="M450 800c138 0 250 -112 250 -250v-50c58 -21 100 -85 100 -150c0 -69 -48 -127 -112 -144c-22 55 -75 94 -138 94c-20 0 -39 -5 -56 -12c-17 64 -75 112 -144 112s-127 -48 -144 -112c-17 7 -36 12 -56 12c-37 0 -71 -12 -97 -34c-33 36 -53 82 -53 134
+c0 110 90 200 200 200c23 114 129 200 250 200zM334 300h4h3c3 0 6 1 9 1c28 0 50 -22 50 -50v-1v-200c0 -28 -22 -50 -50 -50s-50 22 -50 50v200v2c0 20 15 42 34 48zM134 200h4h3c3 0 6 1 9 1c28 0 50 -22 50 -50v-1v-100c0 -28 -22 -50 -50 -50s-50 22 -50 50v100v2
+c0 20 15 42 34 48zM534 200h3h4c3 0 6 1 9 1c28 0 50 -22 50 -50v-1v-100c0 -28 -22 -50 -50 -50s-50 22 -50 50v100v2c0 20 15 42 34 48z" />
+    <glyph glyph-name="b2" unicode="&#xe0b2;" 
+d="M600 800l200 -150l-200 -150v100h-50l-153 -191l175 -206l6 -3h22v100l200 -150l-200 -150v100h-25c-35 0 -56 12 -78 38l-166 190l-153 -190c-22 -27 -43 -38 -78 -38h-100v100h100l166 206l-163 191l-3 3h-100v100h100c34 0 56 -12 78 -38l153 -178l141 178
+c22 27 43 38 78 38h50v100z" />
+    <glyph glyph-name="b3" unicode="&#xe0b3;" 
+d="M400 800c110 0 209 -47 281 -119l119 119v-300h-300l109 109c-54 55 -126 91 -209 91c-166 0 -300 -134 -300 -300s134 -300 300 -300c83 0 158 34 212 88l72 -72c-72 -72 -174 -116 -284 -116c-220 0 -400 180 -400 400s180 400 400 400z" />
+    <glyph glyph-name="b4" unicode="&#xe0b4;" 
+d="M400 800h400v-400l-166 166l-400 -400l166 -166h-400v400l166 -166l400 400z" />
+    <glyph glyph-name="b5" unicode="&#xe0b5;" horiz-adv-x="600" 
+d="M250 800l250 -300h-200v-200h200l-250 -300l-250 300h200v200h-200z" />
+    <glyph glyph-name="b6" unicode="&#xe0b6;" 
+d="M300 600v-200h200v200l300 -250l-300 -250v200h-200v-200l-300 250z" />
+    <glyph glyph-name="b7" unicode="&#xe0b7;" 
+d="M0 800c441 0 800 -359 800 -800h-200c0 333 -267 600 -600 600v200zM0 500c275 0 500 -225 500 -500h-200c0 167 -133 300 -300 300v200zM0 200c110 0 200 -90 200 -200h-200v200z" />
+    <glyph glyph-name="b8" unicode="&#xe0b8;" 
+d="M100 800c386 0 700 -314 700 -700h-100c0 332 -268 600 -600 600v100zM100 600c276 0 500 -224 500 -500h-100c0 222 -178 400 -400 400v100zM100 400c165 0 300 -135 300 -300h-100c0 111 -89 200 -200 200v100zM100 200c55 0 100 -45 100 -100s-45 -100 -100 -100
+s-100 45 -100 100s45 100 100 100z" />
+    <glyph glyph-name="b9" unicode="&#xe0b9;" 
+d="M300 800h400c55 0 100 -45 100 -100v-200h-400v150c0 28 -22 50 -50 50s-50 -22 -50 -50v-250h400v-300c0 -55 -45 -100 -100 -100h-500c-55 0 -100 45 -100 100v200h100v-150c0 -28 22 -50 50 -50s50 22 50 50v550c0 55 45 100 100 100z" />
+    <glyph glyph-name="ba" unicode="&#xe0ba;" 
+d="M75 700h225v-100h-200v-500h400v100h100v-125c0 -41 -34 -75 -75 -75h-450c-41 0 -75 34 -75 75v550c0 41 34 75 75 75zM600 700l200 -200l-200 -200v100h-200c-94 0 -173 -65 -194 -153c23 199 189 353 394 353v100z" />
+    <glyph glyph-name="bb" unicode="&#xe0bb;" 
+d="M500 700l300 -284l-300 -316v200h-100c-200 0 -348 -102 -400 -300c0 295 100 500 500 500v200z" />
+    <glyph glyph-name="bc" unicode="&#xe0bc;" 
+d="M381 791l19 9l19 -9c127 -53 253 -108 381 -160v-31c0 -166 -67 -313 -147 -419c-40 -53 -83 -97 -125 -128s-82 -53 -128 -53s-86 22 -128 53s-85 75 -125 128c-80 107 -147 253 -147 419v31c128 52 254 107 381 160zM400 100v591l-294 -122c8 -126 58 -243 122 -328
+c35 -46 73 -86 106 -110s62 -31 66 -31z" />
+    <glyph glyph-name="bd" unicode="&#xe0bd;" 
+d="M600 800h100v-800h-100v800zM400 700h100v-700h-100v700zM200 500h100v-500h-100v500zM0 300h100v-300h-100v300z" />
+    <glyph glyph-name="be" unicode="&#xe0be;" 
+d="M300 800h100v-200h200l100 -100l-100 -100h-200v-400h-100v500h-200l-100 100l100 100h200v100z" />
+    <glyph glyph-name="bf" unicode="&#xe0bf;" 
+d="M200 800h100v-600h200l-250 -200l-250 200h200v600zM400 800h200v-100h-200v100zM400 600h300v-100h-300v100zM400 400h400v-100h-400v100z" />
+    <glyph glyph-name="c0" unicode="&#xe0c0;" 
+d="M200 800h100v-600h200l-250 -200l-250 200h200v600zM400 800h400v-100h-400v100zM400 600h300v-100h-300v100zM400 400h200v-100h-200v100z" />
+    <glyph glyph-name="c1" unicode="&#xe0c1;" 
+d="M75 700h650c41 0 75 -34 75 -75v-550c0 -41 -34 -75 -75 -75h-650c-41 0 -75 34 -75 75v550c0 41 34 75 75 75zM100 600v-100h100v100h-100zM300 600v-100h400v100h-400zM100 400v-100h100v100h-100zM300 400v-100h400v100h-400zM100 200v-100h100v100h-100zM300 200
+v-100h400v100h-400z" />
+    <glyph glyph-name="c2" unicode="&#xe0c2;" 
+d="M400 800l100 -300h300l-250 -200l100 -300l-250 200l-250 -200l100 300l-250 200h300z" />
+    <glyph glyph-name="c3" unicode="&#xe0c3;" 
+d="M400 800c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM150 700c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM650 700c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM400 600c110 0 200 -90 200 -200
+s-90 -200 -200 -200s-200 90 -200 200s90 200 200 200zM50 450c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM750 450c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM150 200c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50
+s22 50 50 50zM650 200c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM400 100c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50z" />
+    <glyph glyph-name="c4" unicode="&#xe0c4;" 
+d="M34 800h632c18 0 34 -16 34 -34v-732c0 -18 -16 -34 -34 -34h-632c-18 0 -34 16 -34 34v732c0 18 16 34 34 34zM100 700v-500h500v500h-500zM350 150c-38 0 -63 -42 -44 -75s69 -33 88 0s-6 75 -44 75z" />
+    <glyph glyph-name="c5" unicode="&#xe0c5;" 
+d="M0 800h300l500 -500l-300 -300l-500 500v300zM200 700c-55 0 -100 -45 -100 -100s45 -100 100 -100s100 45 100 100s-45 100 -100 100z" />
+    <glyph glyph-name="c6" unicode="&#xe0c6;" 
+d="M0 600h200l300 -300l-200 -200l-300 300v200zM340 600h160l300 -300l-200 -200l-78 78l119 122zM150 500c-28 0 -50 -22 -50 -50s22 -50 50 -50s50 22 50 50s-22 50 -50 50z" />
+    <glyph glyph-name="c7" unicode="&#xe0c7;" 
+d="M400 800c220 0 400 -180 400 -400s-180 -400 -400 -400s-400 180 -400 400s180 400 400 400zM400 700c-166 0 -300 -134 -300 -300s134 -300 300 -300s300 134 300 300s-134 300 -300 300zM400 600c110 0 200 -90 200 -200s-90 -200 -200 -200s-200 90 -200 200
+s90 200 200 200zM400 500c-56 0 -100 -44 -100 -100s44 -100 100 -100s100 44 100 100s-44 100 -100 100z" />
+    <glyph glyph-name="c8" unicode="&#xe0c8;" 
+d="M0 700h559l-100 -100h-359v-500h500v159l100 100v-359h-700v700zM700 700l100 -100l-400 -400l-200 200l100 100l100 -100z" />
+    <glyph glyph-name="c9" unicode="&#xe0c9;" 
+d="M9 800h782c6 0 9 -3 9 -9v-782c0 -6 -3 -9 -9 -9h-782c-6 0 -9 3 -9 9v782c0 6 3 9 9 9zM150 722l-72 -72l100 -100l-100 -100l72 -72l172 172zM400 500v-100h300v100h-300z" />
+    <glyph glyph-name="ca" unicode="&#xe0ca;" 
+d="M0 800h800v-200h-50c0 55 -45 100 -100 100h-150v-550c0 -28 22 -50 50 -50h50v-100h-400v100h50c28 0 50 22 50 50v550h-150c-55 0 -100 -45 -100 -100h-50v200z" />
+    <glyph glyph-name="cb" unicode="&#xe0cb;" 
+d="M0 700h100v-400h-100v400zM200 700h350c21 0 39 -13 47 -31c0 0 103 -291 103 -319s-22 -50 -50 -50h-150c-28 0 -50 -25 -50 -50s39 -158 47 -184s-5 -55 -31 -63s-52 5 -66 31s-109 219 -128 238s-44 28 -72 28v400z" />
+    <glyph glyph-name="cc" unicode="&#xe0cc;" 
+d="M400 666c10 19 28 32 47 34l19 -3c26 -8 39 -37 31 -63s-47 -159 -47 -184s22 -50 50 -50h150c28 0 50 -22 50 -50s-103 -319 -103 -319c-8 -18 -26 -31 -47 -31h-350v400c28 0 53 9 72 28s114 212 128 238zM0 400h100v-400h-100v400z" />
+    <glyph glyph-name="cd" unicode="&#xe0cd;" 
+d="M200 700h300v-100h-100v-6c25 -4 50 -8 72 -16l-34 -94c-28 11 -58 16 -88 16c-139 0 -250 -111 -250 -250s111 -250 250 -250s250 111 250 250c0 31 -5 60 -16 88l91 37c14 -38 25 -81 25 -125c0 -193 -157 -350 -350 -350s-350 157 -350 350c0 176 130 323 300 347v3
+h-100v100zM700 584c0 0 -296 -348 -316 -368s-48 -20 -68 0s-20 48 0 68s384 300 384 300z" />
+    <glyph glyph-name="ce" unicode="&#xe0ce;" 
+d="M600 700l200 -150l-200 -150v100h-600v100h600v100zM200 300v-100h600v-100h-600v-100l-200 150z" />
+    <glyph glyph-name="cf" unicode="&#xe0cf;" 
+d="M300 800h100c55 0 100 -45 100 -100h100c55 0 100 -45 100 -100h-700c0 55 45 100 100 100h100c0 55 45 100 100 100zM100 500h100v-350c0 -28 22 -50 50 -50s50 22 50 50v350h100v-350c0 -28 22 -50 50 -50s50 22 50 50v350h100v-481c0 -11 -8 -19 -19 -19h-462
+c-11 0 -19 8 -19 19v481z" />
+    <glyph glyph-name="d0" unicode="&#xe0d0;" 
+d="M100 800h200v-400c0 -55 45 -100 100 -100s100 45 100 100v400h100v-400c0 -110 -90 -200 -200 -200h-50c-138 0 -250 90 -250 200v400zM0 100h700v-100h-700v100z" />
+    <glyph glyph-name="d1" unicode="&#xe0d1;" 
+d="M9 700h182c6 0 9 -3 9 -9v-482c0 -6 -3 -9 -9 -9h-182c-6 0 -9 3 -9 9v482c0 6 3 9 9 9zM609 700h182c6 0 9 -3 9 -9v-482c0 -6 -3 -9 -9 -9h-182c-6 0 -9 3 -9 9v482c0 6 3 9 9 9zM309 500h182c6 0 9 -3 9 -9v-282c0 -6 -3 -9 -9 -9h-182c-6 0 -9 3 -9 9v282
+c0 6 3 9 9 9zM0 100h800v-100h-800v100z" />
+    <glyph glyph-name="d2" unicode="&#xe0d2;" 
+d="M10 700h181c6 0 9 -3 9 -9v-191h-200v191c0 6 4 9 10 9zM610 700h181c6 0 9 -3 9 -9v-191h-200v191c0 6 5 9 10 9zM310 600h181c6 0 9 -3 9 -9v-91h-200v91c0 6 4 9 10 9zM0 400h800v-100h-800v100zM0 200h200v-191c0 -6 -3 -9 -9 -9h-182c-6 0 -9 3 -9 9v191zM300 200
+h200v-91c0 -6 -3 -9 -9 -9h-181c-6 0 -10 3 -10 9v91zM600 200h200v-191c0 -6 -3 -9 -9 -9h-181c-6 0 -10 3 -10 9v191z" />
+    <glyph glyph-name="d3" unicode="&#xe0d3;" 
+d="M0 700h800v-100h-800v100zM9 500h182c6 0 9 -3 9 -9v-482c0 -6 -3 -9 -9 -9h-182c-6 0 -9 3 -9 9v482c0 6 3 9 9 9zM309 500h182c6 0 9 -3 9 -9v-282c0 -6 -3 -9 -9 -9h-182c-6 0 -9 3 -9 9v282c0 6 3 9 9 9zM609 500h182c6 0 9 -3 9 -9v-482c0 -6 -3 -9 -9 -9h-182
+c-6 0 -9 3 -9 9v482c0 6 3 9 9 9z" />
+    <glyph glyph-name="d4" unicode="&#xe0d4;" 
+d="M50 600h500c28 0 50 -22 50 -50v-150l100 100h100v-300h-100l-100 100v-150c0 -28 -22 -50 -50 -50h-500c-28 0 -50 22 -50 50v400c0 28 22 50 50 50z" />
+    <glyph glyph-name="d5" unicode="&#xe0d5;" 
+d="M334 800h66v-800h-66l-134 200h-200v400h200zM500 600v100c26 0 52 -4 75 -10c130 -33 225 -150 225 -290s-95 -258 -225 -291h-3c-23 -6 -47 -9 -72 -9v100c17 0 34 2 50 6c86 22 150 100 150 194s-64 172 -150 194c-16 4 -33 6 -50 6zM500 500l25 -3
+c44 -11 75 -51 75 -97s-32 -86 -75 -97l-25 -3v200z" />
+    <glyph glyph-name="d6" unicode="&#xe0d6;" horiz-adv-x="600" 
+d="M334 800h66v-800h-66l-134 200h-200v400h200zM500 500l25 -3c44 -11 75 -51 75 -97s-32 -86 -75 -97l-25 -3v200z" />
+    <glyph glyph-name="d7" unicode="&#xe0d7;" horiz-adv-x="400" 
+d="M334 800h66v-800h-66l-134 200h-200v400h200z" />
+    <glyph glyph-name="d8" unicode="&#xe0d8;" 
+d="M309 800h82c6 0 10 -4 12 -9l294 -682l3 -19v-81c0 -6 -3 -9 -9 -9h-682c-6 0 -9 3 -9 9v81l3 19l294 682c2 5 6 9 12 9zM300 500v-200h100v200h-100zM300 200v-100h100v100h-100z" />
+    <glyph glyph-name="d9" unicode="&#xe0d9;" 
+d="M375 800c138 0 269 -39 378 -109l-53 -82c-93 60 -205 91 -325 91c-119 0 -229 -32 -322 -91l-53 82c109 70 237 109 375 109zM375 500c78 0 154 -23 216 -62l-53 -85c-46 30 -104 47 -163 47c-60 0 -112 -17 -159 -47l-54 85c62 40 134 62 213 62zM375 200
+c55 0 100 -45 100 -100s-45 -100 -100 -100s-100 45 -100 100s45 100 100 100z" />
+    <glyph glyph-name="da" unicode="&#xe0da;" horiz-adv-x="900" 
+d="M551 800c16 0 32 0 47 -3l-97 -97v-200h200l97 97c3 -15 3 -31 3 -47c0 -138 -112 -250 -250 -250c-32 0 -62 8 -90 19l-288 -291c-20 -20 -46 -28 -72 -28s-52 8 -72 28c-39 39 -39 105 0 144l291 287c-11 28 -19 59 -19 91c0 138 112 250 250 250zM101 150
+c-28 0 -50 -22 -50 -50s22 -50 50 -50s50 22 50 50s-22 50 -50 50z" />
+    <glyph glyph-name="db" unicode="&#xe0db;" 
+d="M141 700c84 -84 169 -167 253 -250c82 83 167 165 247 250l143 -141l-253 -253c84 -82 167 -166 253 -247l-143 -143c-81 86 -165 169 -247 253l-253 -253l-141 143c85 80 167 164 250 247c-83 84 -166 169 -250 253z" />
+    <glyph glyph-name="dc" unicode="&#xe0dc;" 
+d="M0 800h100l231 -300h38l231 300h100l-225 -300h225v-100h-300v-100h300v-100h-300v-200h-100v200h-300v100h300v100h-300v100h225z" />
+    <glyph glyph-name="dd" unicode="&#xe0dd;" horiz-adv-x="900" 
+d="M350 800c193 0 350 -157 350 -350c0 -61 -17 -119 -44 -169c4 -2 10 -6 13 -9l103 -100c16 -16 30 -49 30 -72c0 -56 -46 -102 -102 -102c-23 0 -56 14 -72 30l-100 103c-3 3 -7 9 -9 13c-50 -28 -108 -44 -169 -44c-193 0 -350 157 -350 350s157 350 350 350zM350 700
+c-139 0 -250 -111 -250 -250s111 -250 250 -250c62 0 119 23 163 60c7 11 19 25 31 31l3 3c34 43 53 97 53 156c0 139 -111 250 -250 250zM300 600h100v-100h100v-100h-100v-100h-100v100h-100v100h100v100z" />
+    <glyph glyph-name="de" unicode="&#xe0de;" horiz-adv-x="900" 
+d="M350 800c193 0 350 -157 350 -350c0 -61 -17 -119 -44 -169c4 -2 10 -6 13 -9l103 -100c16 -16 30 -49 30 -72c0 -56 -46 -102 -102 -102c-23 0 -56 14 -72 30l-100 103c-3 3 -7 9 -9 13c-50 -28 -108 -44 -169 -44c-193 0 -350 157 -350 350s157 350 350 350zM350 700
+c-139 0 -250 -111 -250 -250s111 -250 250 -250c62 0 119 23 163 60c7 11 19 25 31 31l3 3c34 43 53 97 53 156c0 139 -111 250 -250 250zM200 500h300v-100h-300v100z" />
+  </font>
+</defs></svg>
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/font/fonts/open-iconic.ttf b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/font/fonts/open-iconic.ttf
new file mode 100644
index 0000000000..fab604866c
Binary files /dev/null and b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/font/fonts/open-iconic.ttf differ
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/font/fonts/open-iconic.woff b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/font/fonts/open-iconic.woff
new file mode 100644
index 0000000000..f9309988ae
Binary files /dev/null and b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/open-iconic/font/fonts/open-iconic.woff differ
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/site.css b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/site.css
new file mode 100644
index 0000000000..1f4b8cf316
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/css/site.css
@@ -0,0 +1,64 @@
+@import url('open-iconic/font/css/open-iconic-bootstrap.min.css');
+
+html, body {
+    font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif;
+}
+
+h1:focus {
+    outline: none;
+}
+
+a, .btn-link {
+    color: #0071c1;
+}
+
+.btn-primary {
+    color: #fff;
+    background-color: #1b6ec2;
+    border-color: #1861ac;
+}
+
+.content {
+    padding-top: 1.1rem;
+}
+
+.valid.modified:not([type=checkbox]) {
+    outline: 1px solid #26b050;
+}
+
+.invalid {
+    outline: 1px solid red;
+}
+
+.validation-message {
+    color: red;
+}
+
+#blazor-error-ui {
+    background: lightyellow;
+    bottom: 0;
+    box-shadow: 0 -1px 2px rgba(0, 0, 0, 0.2);
+    display: none;
+    left: 0;
+    padding: 0.6rem 1.25rem 0.7rem 1.25rem;
+    position: fixed;
+    width: 100%;
+    z-index: 1000;
+}
+
+    #blazor-error-ui .dismiss {
+        cursor: pointer;
+        position: absolute;
+        right: 0.75rem;
+        top: 0.5rem;
+    }
+
+.blazor-error-boundary {
+    background: url(data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNTYiIGhlaWdodD0iNDkiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgeG1sbnM6eGxpbms9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkveGxpbmsiIG92ZXJmbG93PSJoaWRkZW4iPjxkZWZzPjxjbGlwUGF0aCBpZD0iY2xpcDAiPjxyZWN0IHg9IjIzNSIgeT0iNTEiIHdpZHRoPSI1NiIgaGVpZ2h0PSI0OSIvPjwvY2xpcFBhdGg+PC9kZWZzPjxnIGNsaXAtcGF0aD0idXJsKCNjbGlwMCkiIHRyYW5zZm9ybT0idHJhbnNsYXRlKC0yMzUgLTUxKSI+PHBhdGggZD0iTTI2My41MDYgNTFDMjY0LjcxNyA1MSAyNjUuODEzIDUxLjQ4MzcgMjY2LjYwNiA1Mi4yNjU4TDI2Ny4wNTIgNTIuNzk4NyAyNjcuNTM5IDUzLjYyODMgMjkwLjE4NSA5Mi4xODMxIDI5MC41NDUgOTIuNzk1IDI5MC42NTYgOTIuOTk2QzI5MC44NzcgOTMuNTEzIDI5MSA5NC4wODE1IDI5MSA5NC42NzgyIDI5MSA5Ny4wNjUxIDI4OS4wMzggOTkgMjg2LjYxNyA5OUwyNDAuMzgzIDk5QzIzNy45NjMgOTkgMjM2IDk3LjA2NTEgMjM2IDk0LjY3ODIgMjM2IDk0LjM3OTkgMjM2LjAzMSA5NC4wODg2IDIzNi4wODkgOTMuODA3MkwyMzYuMzM4IDkzLjAxNjIgMjM2Ljg1OCA5Mi4xMzE0IDI1OS40NzMgNTMuNjI5NCAyNTkuOTYxIDUyLjc5ODUgMjYwLjQwNyA1Mi4yNjU4QzI2MS4yIDUxLjQ4MzcgMjYyLjI5NiA1MSAyNjMuNTA2IDUxWk0yNjMuNTg2IDY2LjAxODNDMjYwLjczNyA2Ni4wMTgzIDI1OS4zMTMgNjcuMTI0NSAyNTkuMzEzIDY5LjMzNyAyNTkuMzEzIDY5LjYxMDIgMjU5LjMzMiA2OS44NjA4IDI1OS4zNzEgNzAuMDg4N0wyNjEuNzk1IDg0LjAxNjEgMjY1LjM4IDg0LjAxNjEgMjY3LjgyMSA2OS43NDc1QzI2Ny44NiA2OS43MzA5IDI2Ny44NzkgNjkuNTg3NyAyNjcuODc5IDY5LjMxNzkgMjY3Ljg3OSA2Ny4xMTgyIDI2Ni40NDggNjYuMDE4MyAyNjMuNTg2IDY2LjAxODNaTTI2My41NzYgODYuMDU0N0MyNjEuMDQ5IDg2LjA1NDcgMjU5Ljc4NiA4Ny4zMDA1IDI1OS43ODYgODkuNzkyMSAyNTkuNzg2IDkyLjI4MzcgMjYxLjA0OSA5My41Mjk1IDI2My41NzYgOTMuNTI5NSAyNjYuMTE2IDkzLjUyOTUgMjY3LjM4NyA5Mi4yODM3IDI2Ny4zODcgODkuNzkyMSAyNjcuMzg3IDg3LjMwMDUgMjY2LjExNiA4Ni4wNTQ3IDI2My41NzYgODYuMDU0N1oiIGZpbGw9IiNGRkU1MDAiIGZpbGwtcnVsZT0iZXZlbm9kZCIvPjwvZz48L3N2Zz4=) no-repeat 1rem/1.8rem, #b32121;
+    padding: 1rem 1rem 1rem 3.7rem;
+    color: white;
+}
+
+    .blazor-error-boundary::after {
+        content: "An error has occurred."
+    }
diff --git a/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/favicon.ico b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/favicon.ico
new file mode 100644
index 0000000000..63e859b476
Binary files /dev/null and b/samples/core/Miscellaneous/Multitenancy/SingleDbSingleTable/wwwroot/favicon.ico differ
diff --git a/samples/core/Miscellaneous/Multitenancy/TenantControls/ContactList.razor b/samples/core/Miscellaneous/Multitenancy/TenantControls/ContactList.razor
new file mode 100644
index 0000000000..d8c70e5d7f
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/TenantControls/ContactList.razor
@@ -0,0 +1,59 @@
+@inject ITenantService Service
+
+<h1>Contacts for @Service.Tenant</h1>
+
+@if (Contacts == null)
+{
+    <p class="alert alert-info">Loading...</p>
+}
+else
+{
+    if (Contacts.Count < 1)
+    {
+        <p class="alert alert-warning">No contacts found.</p>
+    }
+    else
+    {
+        <ul>
+            @foreach (var contact in Contacts)
+            {
+                <li>
+                    @contact.Name
+                    @if (contact.IsUnicorn)
+                    {
+                        <span>&nbsp;🦄</span>
+                    }
+                </li>
+            }
+        </ul>    
+    }
+}
+
+@code {
+    [Parameter]
+    public Func<List<Contact>>? FetchContacts { get; set; }             
+
+    [Parameter]
+    public Func<Task<List<Contact>>> FetchContactsAsync { get; set; } =
+            async () => await Task.FromResult(new List<Contact>());
+
+    private List<Contact>? Contacts = null;
+
+    protected override async Task OnInitializedAsync()
+    {
+        await base.OnInitializedAsync();
+        Service.OnTenantChanged += async (o, e) =>
+        {
+            await RefreshContactsAsync();
+            StateHasChanged();
+        };
+        await RefreshContactsAsync();
+    }
+
+    private async Task RefreshContactsAsync()
+    {
+        Contacts = null;
+        var list = FetchContacts == null ? await FetchContactsAsync() : FetchContacts();
+        Contacts = new List<Contact>(list);
+    }
+}
diff --git a/samples/core/Miscellaneous/Multitenancy/TenantControls/TenantControls.csproj b/samples/core/Miscellaneous/Multitenancy/TenantControls/TenantControls.csproj
new file mode 100644
index 0000000000..31d4564fbc
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/TenantControls/TenantControls.csproj
@@ -0,0 +1,22 @@
+<Project Sdk="Microsoft.NET.Sdk.Razor">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+  </PropertyGroup>
+
+
+  <ItemGroup>
+    <SupportedPlatform Include="browser" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.AspNetCore.Components.Web" Version="10.0.0" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\Common\Common.csproj" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/Multitenancy/TenantControls/TenantDisplay.razor b/samples/core/Miscellaneous/Multitenancy/TenantControls/TenantDisplay.razor
new file mode 100644
index 0000000000..dc77f19b24
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/TenantControls/TenantDisplay.razor
@@ -0,0 +1,23 @@
+@inject ITenantService TenantService
+
+<div class="@TenantClass">@_tenant</div>
+
+@code
+{
+    private string _tenant = null!;
+
+    [Parameter]
+    public string TenantClass { get; set; } = string.Empty;
+
+    protected override void OnInitialized()
+    {
+        _tenant = TenantService.Tenant;
+        TenantService.OnTenantChanged += (o, e) =>
+        {
+            _tenant = e.NewTenant;
+            StateHasChanged();
+        };
+
+        base.OnInitialized();
+    }
+}
diff --git a/samples/core/Miscellaneous/Multitenancy/TenantControls/TenantDisplay.razor.css b/samples/core/Miscellaneous/Multitenancy/TenantControls/TenantDisplay.razor.css
new file mode 100644
index 0000000000..19a4d84326
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/TenantControls/TenantDisplay.razor.css
@@ -0,0 +1,3 @@
+.white {
+    color: white;
+}
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/Multitenancy/TenantControls/TenantPicker.razor b/samples/core/Miscellaneous/Multitenancy/TenantControls/TenantPicker.razor
new file mode 100644
index 0000000000..685c228336
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/TenantControls/TenantPicker.razor
@@ -0,0 +1,24 @@
+@inject ITenantService TenantService
+
+<p>Choose your tenant:
+    <select @onchange="OnTenantChanged">
+        @foreach(var tenant in TenantService.GetTenants())
+        {
+            <option value="@tenant" selected="@(tenant == _tenant)">@tenant</option>
+        }
+    </select>        
+</p>
+
+@code
+{
+    private string _tenant = null!;
+
+    protected override void OnInitialized()
+    {
+        _tenant = TenantService.Tenant;
+        base.OnInitialized();
+    }
+
+    private void OnTenantChanged(ChangeEventArgs e) =>
+    TenantService.SetTenant(e.Value as string ?? _tenant);
+}
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/Multitenancy/TenantControls/TenantPicker.razor.css b/samples/core/Miscellaneous/Multitenancy/TenantControls/TenantPicker.razor.css
new file mode 100644
index 0000000000..9261b0bf81
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/TenantControls/TenantPicker.razor.css
@@ -0,0 +1,10 @@
+p {
+    color: white;    
+}
+
+.my-component {
+    border: 2px dashed red;
+    padding: 1em;
+    margin: 1em 0;
+    background-image: url('background.png');
+}
diff --git a/samples/core/Miscellaneous/Multitenancy/TenantControls/_Imports.razor b/samples/core/Miscellaneous/Multitenancy/TenantControls/_Imports.razor
new file mode 100644
index 0000000000..b8d00d533f
--- /dev/null
+++ b/samples/core/Miscellaneous/Multitenancy/TenantControls/_Imports.razor
@@ -0,0 +1,2 @@
+@using Microsoft.AspNetCore.Components.Web
+@using Common
diff --git a/samples/core/Miscellaneous/NewInEFCore6.Cosmos/.config/dotnet-tools.json b/samples/core/Miscellaneous/NewInEFCore6.Cosmos/.config/dotnet-tools.json
new file mode 100644
index 0000000000..530896d9cd
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6.Cosmos/.config/dotnet-tools.json
@@ -0,0 +1,12 @@
+{
+  "version": 1,
+  "isRoot": true,
+  "tools": {
+    "dotnet-ef": {
+      "version": "10.0.0",
+      "commands": [
+        "dotnet-ef"
+      ]
+    }
+  }
+}
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosDiagnosticsSample.cs b/samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosDiagnosticsSample.cs
new file mode 100644
index 0000000000..3942e95ee8
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosDiagnosticsSample.cs
@@ -0,0 +1,162 @@
+using System;
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class CosmosDiagnosticsSample
+{
+    public static async Task Cosmos_diagnostics()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Cosmos_diagnostics)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new ShapesContext();
+
+        Console.WriteLine();
+        Console.WriteLine("Insert diagnostic events:");
+        Console.WriteLine();
+
+        #region InsertEvents
+        var triangle = new Triangle
+        {
+            Name = "Impossible",
+            PartitionKey = "TrianglesPartition",
+            Angle1 = 90,
+            Angle2 = 90,
+            InsertedOn = DateTime.UtcNow
+        };
+        context.Add(triangle);
+        await context.SaveChangesAsync();
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine("Query diagnostic events:");
+        Console.WriteLine();
+
+        #region QueryEvents
+        var equilateral = await context.Triangles.SingleAsync(e => e.Name == "Equilateral");
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine("Find diagnostic events:");
+        Console.WriteLine();
+
+        #region FindEvents
+        var isosceles = await context.Triangles.FindAsync("Isosceles", "TrianglesPartition");
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine("Update diagnostic events:");
+        Console.WriteLine();
+
+        #region UpdateEvents
+        triangle.Angle2 = 89;
+        await context.SaveChangesAsync();
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine("Delete diagnostic events:");
+        Console.WriteLine();
+
+        #region DeleteEvents
+        context.Remove(triangle);
+        await context.SaveChangesAsync();
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using var context = new ShapesContext(quiet: true);
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        public static async Task PopulateDatabase()
+        {
+            using var context = new ShapesContext(quiet: true);
+
+            var triangles = new List<Triangle>
+            {
+                new() { Name = "Acute", PartitionKey = "TrianglesPartition", Angle1 = 75, Angle2 = 85, InsertedOn = DateTime.UtcNow },
+                new() { Name = " Obtuse ", PartitionKey = "TrianglesPartition", Angle1 = 110, Angle2 = 35, InsertedOn = DateTime.UtcNow },
+                new() { Name = "Right", PartitionKey = "TrianglesPartition", Angle1 = 90, Angle2 = 45, InsertedOn = DateTime.UtcNow },
+                new() { Name = "Isosceles", PartitionKey = "TrianglesPartition", Angle1 = 75, Angle2 = 75, InsertedOn = DateTime.UtcNow },
+                new() { Name = "Equilateral", PartitionKey = "TrianglesPartition", Angle1 = 60, Angle2 = 60, InsertedOn = DateTime.UtcNow }
+            };
+
+            context.AddRange(triangles);
+            await context.SaveChangesAsync();
+        }
+    }
+
+    #region TriangleEntity
+    public class Triangle
+    {
+        public string PartitionKey { get; set; }
+        public string Name { get; set; }
+        public double Angle1 { get; set; }
+        public double Angle2 { get; set; }
+        public DateTime InsertedOn { get; set; }
+    }
+    #endregion
+
+    public class ShapesContext : DbContext
+    {
+        public DbSet<Triangle> Triangles { get; set; }
+
+        private readonly bool _quiet;
+
+        public ShapesContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Triangle>(
+                b =>
+                {
+                    b.ToContainer("Shapes");
+                    b.HasPartitionKey(e => e.PartitionKey);
+                    b.HasKey(e => new { e.Name, e.PartitionKey });
+                    b.Property(c => c.Name).ToJsonProperty("id");
+                    b.Property(c => c.PartitionKey).ToJsonProperty("pk");
+                });
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseCosmos(
+                    "https://localhost:8081",
+                    "C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==",
+                    "Triangles");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(
+                    Console.WriteLine,
+                    new[]
+                    {
+                        CosmosEventId.ExecutedCreateItem,
+                        CosmosEventId.ExecutedDeleteItem,
+                        CosmosEventId.ExecutedReadItem,
+                        CosmosEventId.ExecutedReadNext,
+                        CosmosEventId.ExecutedReplaceItem,
+                        CosmosEventId.ExecutingReadItem,
+                        CosmosEventId.ExecutingSqlQuery
+                    });
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosImplicitOwnershipSample.cs b/samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosImplicitOwnershipSample.cs
new file mode 100644
index 0000000000..54592e885c
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosImplicitOwnershipSample.cs
@@ -0,0 +1,198 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text.Json.Serialization;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class CosmosImplicitOwnershipSample
+{
+    public static async Task Cosmos_models_use_implicit_ownership_by_default()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Cosmos_models_use_implicit_ownership_by_default)}");
+        Console.WriteLine();
+
+        using (var context = new FamilyContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            context.AddRange(
+                new Family
+                {
+                    Id = "Andersen.1",
+                    LastName = "Andersen",
+                    Parents =
+                    {
+                        new() { FirstName = "Thomas" }, new() { FirstName = "Mary Kay" }
+                    },
+                    Children =
+                    {
+                        new()
+                        {
+                            FirstName = "Henriette Thaulow",
+                            Gender = "female",
+                            Grade = 5,
+                            Pets = { new() { GivenName = "Fluffy" } }
+                        }
+                    },
+                    Address = new Address { State = "WA", County = "King", City = "Seattle" },
+                },
+                new Family
+                {
+                    Id = "Wakefield.7",
+                    LastName = "Wakefield",
+                    Parents =
+                    {
+                        new() { FamilyName = "Wakefield", FirstName = "Robin" },
+                        new() { FamilyName = "Miller", FirstName = "Ben" }
+                    },
+                    Children =
+                    {
+                        new()
+                        {
+                            FamilyName = "Merriam",
+                            FirstName = "Jesse",
+                            Gender = "female",
+                            Grade = 8,
+                            Pets = { new() { GivenName = "Goofy" }, new() { GivenName = "Shadow" } }
+                        },
+                        new Child
+                        {
+                            FamilyName = "Miller",
+                            FirstName = "Lisa",
+                            Gender = "female",
+                            Grade = 1
+                        }
+                    },
+                    Address = new Address { State = "NY", County = "Manhattan", City = "NY" },
+                    IsRegistered = true
+                });
+
+            await context.SaveChangesAsync();
+        }
+
+        Console.WriteLine();
+
+        using (var context = new FamilyContext())
+        {
+            var families = await context.Families.ToListAsync();
+
+            Console.WriteLine();
+
+            foreach (var family in families)
+            {
+                Console.WriteLine($"{family.LastName} family:");
+                Console.WriteLine($"    From {family.Address.City}, {family.Address.State}");
+                Console.WriteLine($"    With {family.Children.Count} children and {family.Children.SelectMany(e => e.Pets).Count()} pets.");
+            }
+        }
+
+        Console.WriteLine();
+    }
+
+    #region Model
+    public class Family
+    {
+        [JsonPropertyName("id")]
+        public string Id { get; set; }
+
+        public string LastName { get; set; }
+        public bool IsRegistered { get; set; }
+
+        public Address Address { get; set; }
+
+        public IList<Parent> Parents { get; } = new List<Parent>();
+        public IList<Child> Children { get; } = new List<Child>();
+    }
+
+    public class Parent
+    {
+        public string FamilyName { get; set; }
+        public string FirstName { get; set; }
+    }
+
+    public class Child
+    {
+        public string FamilyName { get; set; }
+        public string FirstName { get; set; }
+        public int Grade { get; set; }
+
+        public string Gender { get; set; }
+
+        public IList<Pet> Pets { get; } = new List<Pet>();
+    }
+    #endregion
+
+    public class Pet
+    {
+        public string GivenName { get; set; }
+    }
+
+    public class Address
+    {
+        public string State { get; set; }
+        public string County { get; set; }
+        public string City { get; set; }
+    }
+
+    public class FamilyContext : DbContext
+    {
+        public DbSet<Family> Families { get; set; }
+
+        private readonly bool _quiet;
+
+        public FamilyContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region OnModelCreating
+            modelBuilder.Entity<Family>().HasPartitionKey(e => e.LastName);
+            #endregion
+        }
+
+        // Never called; just for documentation.
+        private void OldOnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region OldOnModelCreating
+            modelBuilder.Entity<Family>()
+                .HasPartitionKey(e => e.LastName)
+                .OwnsMany(f => f.Parents);
+
+            modelBuilder.Entity<Family>()
+                .OwnsMany(f => f.Children)
+                .OwnsMany(c => c.Pets);
+
+            modelBuilder.Entity<Family>()
+                .OwnsOne(f => f.Address);
+            #endregion
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseCosmos(
+                    "https://localhost:8081",
+                    "C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==",
+                    "TODOImplicit");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(
+                    Console.WriteLine, new[]
+                    {
+                        CosmosEventId.ExecutedCreateItem,
+                        CosmosEventId.ExecutedDeleteItem,
+                        CosmosEventId.ExecutedReadItem,
+                        CosmosEventId.ExecutedReadNext,
+                        CosmosEventId.ExecutedReplaceItem,
+                    });
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosMinimalApiSample.cs b/samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosMinimalApiSample.cs
new file mode 100644
index 0000000000..8911a2e004
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosMinimalApiSample.cs
@@ -0,0 +1,58 @@
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.DependencyInjection;
+
+public static class CosmosMinimalApiSample
+{
+    public static void Add_a_DbContext_and_provider()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Add_a_DbContext_and_provider)}");
+        
+        CosmosMinimal(null);
+        CosmosNormal(null);
+    }
+
+    private static void CosmosMinimal(string[] args)
+    {
+        #region CosmosMinimal
+        var builder = WebApplication.CreateBuilder(args);
+
+        builder.Services.AddCosmos<MyDbContext>(
+            "https://localhost:8081",
+            "C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==");
+        #endregion
+    }
+
+    private static void CosmosNormal(string[] args)
+    {
+        #region CosmosNormal
+        var builder = WebApplication.CreateBuilder(args);
+
+        builder.Services.AddDbContext<MyDbContext>(
+            options => options.UseCosmos(
+                "https://localhost:8081",
+                "C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw=="));
+        #endregion
+    }
+
+    // This is a fake implementation of WebApplicationBuilder  uses to show the EF Core minimal APIs
+    private class FakeWebApplicationBuilder
+    {
+        public ServiceCollection Services { get; } = new();
+    }
+
+    // This is a fake implementation of WebApplication uses to show the EF Core minimal APIs
+    private static class WebApplication
+    {
+        public static FakeWebApplicationBuilder CreateBuilder(string[] args)
+            => new();
+    }
+
+    public class MyDbContext : DbContext
+    {
+        public MyDbContext(DbContextOptions<MyDbContext> options)
+            : base(options)
+        {
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosModelConfigurationSample.cs b/samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosModelConfigurationSample.cs
new file mode 100644
index 0000000000..f87410aed0
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosModelConfigurationSample.cs
@@ -0,0 +1,196 @@
+using System;
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+using Microsoft.Extensions.Logging;
+
+public static class CosmosModelConfigurationSample
+{
+    public static void Cosmos_configure_time_to_live()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Cosmos_configure_time_to_live)}");
+        Console.WriteLine();
+
+        using var context = new FamilyContext();
+
+        // Don't run on the emulator since some options are not supported there.
+        Console.WriteLine(context.Model.ToDebugString());
+
+        Console.WriteLine();
+    }
+
+    public static async Task Cosmos_configure_time_to_live_per_instance()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Cosmos_configure_time_to_live_per_instance)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await using var context = new PlacesContext();
+
+        #region SetTtl
+        var village = new Village { Id = "DN41", Name = "Healing", TimeToLive = 60 };
+        context.Add(village);
+        await context.SaveChangesAsync();
+        #endregion
+
+        #region SetTtlShadow
+        var hamlet = new Hamlet { Id = "DN37", Name = "Irby" };
+        context.Add(hamlet);
+        context.Entry(hamlet).Property("TimeToLive").CurrentValue = 60;
+        await context.SaveChangesAsync();
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public class Family
+    {
+        public string Id { get; set; }
+        public string LastName { get; set; }
+        public IList<Parent> Parents { get; set; }
+        public IList<Child> Children { get; set; }
+        public Address Address { get; set; }
+        public bool IsRegistered { get; set; }
+    }
+
+    public class Village
+    {
+        public string Id { get; set; }
+        public string Name { get; set; }
+        public int TimeToLive { get; set; }
+    }
+
+    public class Hamlet
+    {
+        public string Id { get; set; }
+        public string Name { get; set; }
+    }
+
+    public class Parent
+    {
+        public string FamilyName { get; set; }
+        public string FirstName { get; set; }
+    }
+
+    public class Child
+    {
+        public string FamilyName { get; set; }
+        public string FirstName { get; set; }
+        public string Gender { get; set; }
+        public int Grade { get; set; }
+        public IList<Pet> Pets { get; set; }
+    }
+
+    public class Pet
+    {
+        public string GivenName { get; set; }
+    }
+
+    public class Address
+    {
+        public string State { get; set; }
+        public string County { get; set; }
+        public string City { get; set; }
+    }
+
+    public class FamilyContext : DbContext
+    {
+        public DbSet<Family> Families { get; set; }
+
+        private readonly bool _quiet;
+
+        public FamilyContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Family>(
+                entityTypeBuilder =>
+                {
+                    entityTypeBuilder.Property(e => e.Id).ToJsonProperty("id");
+                    entityTypeBuilder.HasPartitionKey(e => e.LastName);
+                });
+
+            #region ModelThroughput
+            modelBuilder.HasManualThroughput(2000);
+            modelBuilder.HasAutoscaleThroughput(4000);
+            #endregion
+
+            #region EntityTypeThroughput
+            modelBuilder.Entity<Family>(
+                entityTypeBuilder =>
+                {
+                    entityTypeBuilder.HasManualThroughput(5000);
+                    entityTypeBuilder.HasAutoscaleThroughput(3000);
+                });
+            #endregion
+
+            #region TimeToLive
+            modelBuilder.Entity<Family>(
+                entityTypeBuilder =>
+                {
+                    entityTypeBuilder.HasDefaultTimeToLive(100);
+                    entityTypeBuilder.HasAnalyticalStoreTimeToLive(200);
+                });
+            #endregion
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseCosmos(
+                    "https://localhost:8081",
+                    "C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==",
+                    "TODO");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { CosmosEventId.ExecutingSqlQuery });
+            }
+        }
+    }
+
+    public class PlacesContext : DbContext
+    {
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region TimeToLiveProperty
+            modelBuilder.Entity<Village>()
+                .HasDefaultTimeToLive(3600)
+                .Property(e => e.TimeToLive)
+                .ToJsonProperty("ttl");
+            #endregion
+
+            #region TimeToLiveShadowProperty
+            modelBuilder.Entity<Hamlet>()
+                .HasDefaultTimeToLive(3600)
+                .Property<int>("TimeToLive")
+                .ToJsonProperty("ttl");
+            #endregion
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .EnableSensitiveDataLogging()
+                .LogTo(Console.WriteLine, LogLevel.Information)
+                .UseCosmos(
+                    "https://localhost:8081",
+                    "C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==",
+                    "Places");
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            await using var context = new PlacesContext();
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosPrimitiveTypesSample.cs b/samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosPrimitiveTypesSample.cs
new file mode 100644
index 0000000000..9613eeb2ee
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosPrimitiveTypesSample.cs
@@ -0,0 +1,118 @@
+using System;
+using System.Collections.Generic;
+using System.Net.Http;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class CosmosPrimitiveTypesSample
+{
+    public static async Task Collections_and_dictionaries_of_primitive_types()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Collections_and_dictionaries_of_primitive_types)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        #region Insert
+        using var context = new BooksContext();
+
+        var book = new Book
+        {
+            Title = "How It Works: Incredible History",
+            Quotes = new List<string>
+            {
+                "Thomas (Tommy) Flowers was the British engineer behind the design of the Colossus computer.",
+                "Invented originally for Guinness, plastic widgets are nitrogen-filled spheres.",
+                "For 20 years after its introduction in 1979, the Walkman dominated the personal stereo market."
+            },
+            Notes = new Dictionary<string, string>
+            {
+                { "121", "Fridges" },
+                { "144", "Peter Higgs" },
+                { "48", "Saint Mark's Basilica" },
+                { "36", "The Terracotta Army" }
+            }
+        };
+
+        context.Add(book);
+        await context.SaveChangesAsync();
+        #endregion
+
+        #region Updates
+        book.Quotes.Add("Pressing the emergency button lowered the rods again.");
+        book.Notes["48"] = "Chiesa d'Oro";
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using var context = new BooksContext(quiet: true);
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+    }
+
+    #region BookEntity
+    public class Book
+    {
+        public Guid Id { get; set; }
+        public string Title { get; set; }
+        public IList<string> Quotes { get; set; }
+        public IDictionary<string, string> Notes { get; set; }
+    }
+    #endregion
+
+    public class BooksContext : DbContext
+    {
+        public DbSet<Book> Books { get; set; }
+
+        private readonly bool _quiet;
+
+        public BooksContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Book>().ToContainer("Shapes");
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            #region HttpClientFactory
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseCosmos(
+                    "https://localhost:8081",
+                    "C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==",
+                    "PrimitiveCollections",
+                    cosmosOptionsBuilder =>
+                    {
+                        cosmosOptionsBuilder.HttpClientFactory(
+                            () => new HttpClient(
+                                new HttpClientHandler
+                                {
+                                    ServerCertificateCustomValidationCallback =
+                                        HttpClientHandler.DangerousAcceptAnyServerCertificateValidator
+                                }));
+                    });
+            #endregion
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(
+                    Console.WriteLine,
+                    new[] { CosmosEventId.ExecutedCreateItem, CosmosEventId.ExecutingSqlQuery, CoreEventId.SaveChangesCompleted });
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosQueriesSample.cs b/samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosQueriesSample.cs
new file mode 100644
index 0000000000..99bfb78ee7
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6.Cosmos/CosmosQueriesSample.cs
@@ -0,0 +1,182 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class CosmosQueriesSample
+{
+    public static async Task Cosmos_queries()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Cosmos_queries)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new ShapesContext();
+
+        #region StringTranslations
+        var stringResults = await context.Triangles.Where(
+                e => e.Name.Length > 4
+                     && e.Name.Trim().ToLower() != "obtuse"
+                     && e.Name.TrimStart().Substring(2, 2).Equals("uT", StringComparison.OrdinalIgnoreCase))
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var result in stringResults)
+        {
+            Console.WriteLine($" {result.Name}");
+        }
+        Console.WriteLine();
+
+        #region MathTranslations
+        var hypotenuse = 42.42;
+        var mathResults = await context.Triangles.Where(
+                e => (Math.Round(e.Angle1) == 90.0
+                      || Math.Round(e.Angle2) == 90.0)
+                     && (hypotenuse * Math.Sin(e.Angle1) > 30.0
+                         || hypotenuse * Math.Cos(e.Angle2) > 30.0))
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var result in mathResults)
+        {
+            Console.WriteLine($" {result.Name}");
+        }
+        Console.WriteLine();
+
+        #region TimeTranslations
+        var timeResults = await context.Triangles.Where(
+                e => e.InsertedOn <= DateTime.UtcNow)
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var result in timeResults)
+        {
+            Console.WriteLine($" {result.Name}");
+        }
+        Console.WriteLine();
+
+        #region DistictTranslation
+        var distinctResults = await context.Triangles
+            .Select(e => e.Angle1).OrderBy(e => e).Distinct()
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var result in distinctResults)
+        {
+            Console.WriteLine($" {result}");
+        }
+        Console.WriteLine();
+
+        {
+            #region FromSql
+            var maxAngle = 60;
+            var results = await context.Triangles.FromSqlRaw(
+                    @"SELECT * FROM root c WHERE c[""Angle1""] <= {0} OR c[""Angle2""] <= {0}", maxAngle)
+                .ToListAsync();
+            #endregion
+
+            Console.WriteLine();
+            foreach (var result in results)
+            {
+                Console.WriteLine($" {result.Name}");
+            }
+
+            Console.WriteLine();
+        }
+
+        {
+            #region FromSqlComposed
+            var maxAngle = 60;
+            var results = await context.Triangles.FromSqlRaw(
+                    @"SELECT * FROM root c WHERE c[""Angle1""] <= {0} OR c[""Angle2""] <= {0}", maxAngle)
+                .Where(e => e.InsertedOn <= DateTime.UtcNow)
+                .Select(e => e.Angle1).Distinct()
+                .ToListAsync();
+            #endregion
+
+            Console.WriteLine();
+            foreach (var result in results)
+            {
+                Console.WriteLine($" {result}");
+            }
+
+            Console.WriteLine();
+        }
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            await using var context = new ShapesContext(quiet: true);
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        public static async Task PopulateDatabase()
+        {
+            await using var context = new ShapesContext(quiet: true);
+
+            context.AddRange(
+                new Triangle { Name = "Acute", Angle1 = 75, Angle2 = 85, InsertedOn = DateTime.UtcNow - TimeSpan.FromDays(2) },
+                new Triangle { Name = " Obtuse ", Angle1 = 110, Angle2 = 35, InsertedOn = DateTime.UtcNow - TimeSpan.FromDays(1) },
+                new Triangle { Name = "Right", Angle1 = 90, Angle2 = 45, InsertedOn = DateTime.UtcNow },
+                new Triangle { Name = "Isosceles", Angle1 = 75, Angle2 = 75, InsertedOn = DateTime.UtcNow + TimeSpan.FromDays(1) },
+                new Triangle { Name = "Equilateral", Angle1 = 60, Angle2 = 60, InsertedOn = DateTime.UtcNow + TimeSpan.FromDays(2) }
+            );
+
+            await context.SaveChangesAsync();
+        }
+    }
+
+    #region TriangleEntity
+    public class Triangle
+    {
+        public Guid Id { get; set; }
+        public string Name { get; set; }
+        public double Angle1 { get; set; }
+        public double Angle2 { get; set; }
+        public DateTime InsertedOn { get; set; }
+    }
+    #endregion
+
+    public class ShapesContext : DbContext
+    {
+        public DbSet<Triangle> Triangles { get; set; }
+
+        private readonly bool _quiet;
+
+        public ShapesContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Triangle>().ToContainer("Shapes");
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseCosmos(
+                    "https://localhost:8081",
+                    "C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==",
+                    "Queries");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { CosmosEventId.ExecutingSqlQuery });
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6.Cosmos/NewInEFCore6.Cosmos.csproj b/samples/core/Miscellaneous/NewInEFCore6.Cosmos/NewInEFCore6.Cosmos.csproj
new file mode 100644
index 0000000000..c30f939001
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6.Cosmos/NewInEFCore6.Cosmos.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net6.0</TargetFramework>
+    <RootNamespace />
+    <NoWarn>$(NoWarn);NETSDK1138</NoWarn> <!-- The target framework 'net6.0' is out of support -->
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Cosmos" Version="6.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/NewInEFCore6.Cosmos/Program.cs b/samples/core/Miscellaneous/NewInEFCore6.Cosmos/Program.cs
new file mode 100644
index 0000000000..a7fe86192e
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6.Cosmos/Program.cs
@@ -0,0 +1,16 @@
+using System.Threading.Tasks;
+
+public class Program
+{
+    public static async Task Main()
+    {
+        // Note: These samples requires the Cosmos DB emulator to be installed and running
+        await CosmosPrimitiveTypesSample.Collections_and_dictionaries_of_primitive_types();
+        await CosmosQueriesSample.Cosmos_queries();
+        await CosmosDiagnosticsSample.Cosmos_diagnostics();
+        CosmosModelConfigurationSample.Cosmos_configure_time_to_live();
+        await CosmosModelConfigurationSample.Cosmos_configure_time_to_live_per_instance();
+        await CosmosImplicitOwnershipSample.Cosmos_models_use_implicit_ownership_by_default();
+        CosmosMinimalApiSample.Add_a_DbContext_and_provider();
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/.config/dotnet-tools.json b/samples/core/Miscellaneous/NewInEFCore6/.config/dotnet-tools.json
new file mode 100644
index 0000000000..530896d9cd
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/.config/dotnet-tools.json
@@ -0,0 +1,12 @@
+{
+  "version": 1,
+  "isRoot": true,
+  "tools": {
+    "dotnet-ef": {
+      "version": "10.0.0",
+      "commands": [
+        "dotnet-ef"
+      ]
+    }
+  }
+}
\ No newline at end of file
diff --git a/samples/core/Miscellaneous/NewInEFCore6/ArrayParametersSample.cs b/samples/core/Miscellaneous/NewInEFCore6/ArrayParametersSample.cs
new file mode 100644
index 0000000000..e2e55ee04c
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/ArrayParametersSample.cs
@@ -0,0 +1,73 @@
+using System;
+using System.Data;
+using System.Threading.Tasks;
+using Microsoft.Data.SqlClient;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class ArrayParametersSample
+{
+    public static async Task Array_parameters_are_logged_in_readable_form()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Array_parameters_are_logged_in_readable_form)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        using var context = new SomeDbContext();
+
+        try
+        {
+            await context.Database.ExecuteSqlRawAsync(
+                "SELECT * FROM Blogs WHERE Data = {0}",
+                new SqlParameter
+                {
+                    DbType = DbType.String, Value = new[] { "First", "Second", "Third", "Fourth", "Fifth", "Sixth", "Seventh" }
+                });
+        }
+        catch
+        {
+            // Exception is expected as array parameters are not valid on SQL Server.
+            // However, log output shows the parameter logging.
+            //
+            // dbug: 8/2/2021 11:34:16.880 RelationalEventId.CommandExecuting[20100] (Microsoft.EntityFrameworkCore.Database.Command)
+            // Executing DbCommand [Parameters=[@p0={ 'First', 'Second', 'Third', 'Fourth', 'Fifth', ... } (Nullable = false) (DbType = String)], CommandType='Text', CommandTimeout='30']
+            // SELECT * FROM Blogs WHERE Data = @p0
+        }
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using var context = new IsNullOrWhitespaceSample.BooksContext(quiet: true);
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+    }
+
+    public class SomeDbContext : DbContext
+    {
+        private readonly bool _quiet;
+
+        public SomeDbContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuting });
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/BoolToStringTranslationSample.cs b/samples/core/Miscellaneous/NewInEFCore6/BoolToStringTranslationSample.cs
new file mode 100644
index 0000000000..707257b5c6
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/BoolToStringTranslationSample.cs
@@ -0,0 +1,107 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class BoolToStringTranslationSample
+{
+    public static async Task Translate_bool_to_string_on_SQL_Server()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Translate_bool_to_string_on_SQL_Server)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new CustomersContext();
+
+        var results1 = await context.Customers.Select(c => new { c.Name, IsActive = c.IsActive.ToString() }).ToListAsync();
+
+        Console.WriteLine();
+
+        foreach (var customer in results1)
+        {
+            Console.WriteLine($"{customer.Name} is active: {customer.IsActive}");
+        }
+
+        Console.WriteLine();
+
+        var results2 = await context.Customers.Where(b => b.IsActive.ToString() == "true").ToListAsync();
+
+        Console.WriteLine();
+
+        foreach (var customer in results2)
+        {
+            Console.WriteLine($"{customer.Name} is active: {customer.IsActive}");
+        }
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using var context = new CustomersContext(quiet: true);
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        public static async Task PopulateDatabase()
+        {
+            using var context = new CustomersContext(quiet: true);
+
+            context.AddRange(
+                new Customer
+                {
+                    Name = "Arthur",
+                    IsActive = true
+                },
+                new Customer
+                {
+                    Name = "Alan",
+                    IsActive = false
+                },
+                new Customer
+                {
+                    Name = "Andrew",
+                    IsActive = true
+                });
+
+            await context.SaveChangesAsync();
+        }
+    }
+
+    public class Customer
+    {
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public bool IsActive { get; set; }
+    }
+
+    public class CustomersContext : DbContext
+    {
+        public DbSet<Customer> Customers { get; set; }
+
+        private readonly bool _quiet;
+
+        public CustomersContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/ColumnOrderSample.cs b/samples/core/Miscellaneous/NewInEFCore6/ColumnOrderSample.cs
new file mode 100644
index 0000000000..7cc616bde1
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/ColumnOrderSample.cs
@@ -0,0 +1,197 @@
+using System;
+using System.ComponentModel.DataAnnotations;
+using System.ComponentModel.DataAnnotations.Schema;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class ColumnOrderSample
+{
+    public static async Task Can_use_ColumnAttribute_to_set_column_order()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Can_use_ColumnAttribute_to_set_column_order)}");
+        Console.WriteLine();
+
+        using var context = new EmployeeContext();
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+
+        Console.WriteLine();
+    }
+
+    public static class WithOrdering
+    {
+        #region WithOrdering
+        public class EntityBase
+        {
+            [Column(Order = 1)]
+            public int Id { get; set; }
+
+            [Column(Order = 98)]
+            public DateTime UpdatedOn { get; set; }
+
+            [Column(Order = 99)]
+            public DateTime CreatedOn { get; set; }
+        }
+
+        public class PersonBase : EntityBase
+        {
+            [Column(Order = 2)]
+            public string FirstName { get; set; }
+
+            [Column(Order = 3)]
+            public string LastName { get; set; }
+        }
+
+        public class Employee : PersonBase
+        {
+            [Column(Order = 20)]
+            public string Department { get; set; }
+
+            [Column(Order = 21)]
+            public decimal AnnualSalary { get; set; }
+
+            public Address Address { get; set; }
+        }
+
+        [Owned]
+        public class Address
+        {
+            [Column("House", Order = 10)]
+            public string House { get; set; }
+
+            [Column("Street", Order = 11)]
+            public string Street { get; set; }
+
+            [Column("City", Order = 12)]
+            public string City { get; set; }
+
+            [Required]
+            [Column("Postcode", Order = 13)]
+            public string Postcode { get; set; }
+        }
+        #endregion
+    }
+
+    public static class WithoutOrdering
+    {
+        #region WithoutOrdering
+        public class EntityBase
+        {
+            public int Id { get; set; }
+            public DateTime UpdatedOn { get; set; }
+            public DateTime CreatedOn { get; set; }
+        }
+
+        public class PersonBase : EntityBase
+        {
+            public string FirstName { get; set; }
+            public string LastName { get; set; }
+        }
+
+        public class Employee : PersonBase
+        {
+            public string Department { get; set; }
+            public decimal AnnualSalary { get; set; }
+            public Address Address { get; set; }
+        }
+
+        [Owned]
+        public class Address
+        {
+            public string House { get; set; }
+            public string Street { get; set; }
+            public string City { get; set; }
+
+            [Required]
+            public string Postcode { get; set; }
+        }
+        #endregion
+    }
+
+    public static class UsingModelBuilder
+    {
+        public class EntityBase
+        {
+            public int Id { get; set; }
+            public DateTime UpdatedOn { get; set; }
+            public DateTime CreatedOn { get; set; }
+        }
+
+        public class PersonBase : EntityBase
+        {
+            public string FirstName { get; set; }
+            public string LastName { get; set; }
+        }
+
+        public class Employee : PersonBase
+        {
+            public string Department { get; set; }
+            public decimal AnnualSalary { get; set; }
+            public Address Address { get; set; }
+        }
+
+        public class Address
+        {
+            public string House { get; set; }
+            public string Street { get; set; }
+            public string City { get; set; }
+            public string Postcode { get; set; }
+        }
+    }
+
+    public class EmployeeContext : DbContext
+    {
+        private readonly bool _quiet;
+
+        public EmployeeContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+
+        public DbSet<WithoutOrdering.Employee> EmployeesWithoutOrdering { get; set; }
+        public DbSet<WithOrdering.Employee> EmployeesWithOrdering { get; set; }
+        public DbSet<UsingModelBuilder.Employee> EmployeesOrderedInModelBuilder { get; set; }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region UsingModelBuilder
+            modelBuilder.Entity<UsingModelBuilder.Employee>(
+                entityBuilder =>
+                {
+                    entityBuilder.Property(e => e.Id).HasColumnOrder(1);
+                    entityBuilder.Property(e => e.FirstName).HasColumnOrder(2);
+                    entityBuilder.Property(e => e.LastName).HasColumnOrder(3);
+
+                    entityBuilder.OwnsOne(
+                        e => e.Address,
+                        ownedBuilder =>
+                        {
+                            ownedBuilder.Property(e => e.House).HasColumnName("House").HasColumnOrder(4);
+                            ownedBuilder.Property(e => e.Street).HasColumnName("Street").HasColumnOrder(5);
+                            ownedBuilder.Property(e => e.City).HasColumnName("City").HasColumnOrder(6);
+                            ownedBuilder.Property(e => e.Postcode).HasColumnName("Postcode").HasColumnOrder(7).IsRequired();
+                        });
+
+                    entityBuilder.Property(e => e.Department).HasColumnOrder(8);
+                    entityBuilder.Property(e => e.AnnualSalary).HasColumnOrder(9);
+                    entityBuilder.Property(e => e.UpdatedOn).HasColumnOrder(10);
+                    entityBuilder.Property(e => e.CreatedOn).HasColumnOrder(11);
+                });
+            #endregion
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/ContainsFreeTextSample.cs b/samples/core/Miscellaneous/NewInEFCore6/ContainsFreeTextSample.cs
new file mode 100644
index 0000000000..2bebe40d74
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/ContainsFreeTextSample.cs
@@ -0,0 +1,136 @@
+using System;
+using System.Linq;
+using System.Text.Json;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class ContainsFreeTextSample
+{
+    public static async Task Contains_with_non_string()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Contains_with_non_string)}");
+        Console.WriteLine($">>>> Note: does not work with SQL Server LocalDb");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new CustomerContext();
+
+        #region Query
+        var result = await context.Customers.Where(e => EF.Functions.Contains(e.Name, "Martin")).ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using var context = new CustomerContext(quiet: true);
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            await context.Database.ExecuteSqlRawAsync(
+                @"CREATE FULLTEXT CATALOG CustomersAndNames AS DEFAULT;
+    CREATE FULLTEXT INDEX ON Customers (Name) KEY INDEX IX_Names;");
+        }
+
+        public static async Task PopulateDatabase()
+        {
+            using var context = new CustomerContext(quiet: true);
+
+            context.AddRange(
+                new Customer
+                {
+                    Name = new Name
+                    {
+                        First = "Arthur",
+                        MiddleInitial = "J",
+                        Last = "Vickers"
+                    }
+                },
+                new Customer
+                {
+                    Name = new Name
+                    {
+                        First = "Wendy",
+                        MiddleInitial = "F",
+                        Last = "Vickers"
+                    }
+                },
+                new Customer
+                {
+                    Name = new Name
+                    {
+                        First = "George",
+                        Last = "Martin"
+                    }
+                },
+                new Customer
+                {
+                    Name = new Name
+                    {
+                        First = "Martin",
+                        Last = "Clunes"
+                    }
+                });
+
+            await context.SaveChangesAsync();
+        }
+    }
+
+    #region EntityType
+    public class Customer
+    {
+        public int Id { get; set; }
+
+        public Name Name{ get; set; }
+    }
+
+    public class Name
+    {
+        public string First { get; set; }
+        public string MiddleInitial { get; set; }
+        public string Last { get; set; }
+    }
+    #endregion
+
+    public class CustomerContext : DbContext
+    {
+        public DbSet<Customer> Customers { get; set; }
+
+        private readonly bool _quiet;
+
+        public CustomerContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region ConfigureCompositeValueObject
+            modelBuilder.Entity<Customer>()
+                .Property(e => e.Name)
+                .HasConversion(
+                    v => JsonSerializer.Serialize(v, (JsonSerializerOptions)null),
+                    v => JsonSerializer.Deserialize<Name>(v, (JsonSerializerOptions)null));
+            #endregion
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/ConvertNullsSample.cs b/samples/core/Miscellaneous/NewInEFCore6/ConvertNullsSample.cs
new file mode 100644
index 0000000000..df8c33847f
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/ConvertNullsSample.cs
@@ -0,0 +1,352 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+public static class ConvertNullsSample
+{
+    public static async Task Value_converters_can_convert_nulls()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Value_converters_can_convert_nulls)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        using (var context = new CatsContext())
+        {
+            #region InsertCats
+            context.AddRange(
+                new Cat { Name = "Mac", Breed = Breed.Unknown },
+                new Cat { Name = "Clippy", Breed = Breed.Burmese },
+                new Cat { Name = "Sid", Breed = Breed.Tonkinese });
+
+            await context.SaveChangesAsync();
+            #endregion
+
+            Console.WriteLine();
+        }
+
+        using (var context = new CatsContext())
+        {
+            var cats = await context.Cats.ToListAsync();
+
+            Console.WriteLine();
+
+            foreach (var cat in cats)
+            {
+                Console.WriteLine($"{cat.Name} has breed '{cat.Breed}'.");
+            }
+        }
+
+        Console.WriteLine();
+    }
+
+    public static async Task Value_converters_can_convert_nulls_in_FKs()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Value_converters_can_convert_nulls_in_FKs)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        using (var context = new CarsContext())
+        {
+            context.AddRange(
+                new Car
+                {
+                    Model = "Toyota Yaris",
+                    Owner = new() { Name = "Wendy" }
+                },
+                new Car
+                {
+                    Model = "Kia Soul"
+                });
+
+            await context.SaveChangesAsync();
+
+            Console.WriteLine();
+        }
+
+        using (var context = new CarsContext())
+        {
+            // Not currently working
+            var cars = await context.Cars.Where(e => e.OwnerId == null).ToListAsync();
+
+            Console.WriteLine();
+
+            foreach (var car in cars)
+            {
+                Console.WriteLine($"The {car.Model} does not have an owner.");
+            }
+        }
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using (var context = new CarsContext(quiet: true))
+            {
+                await context.Database.EnsureDeletedAsync();
+                await context.Database.MigrateAsync();
+            }
+
+            using (var context = new CatsContext(quiet: true))
+            {
+                await context.Database.EnsureDeletedAsync();
+                await context.Database.EnsureCreatedAsync();
+            }
+        }
+    }
+
+    #region PersonAndCar
+    public class Person
+    {
+        public int Id { get; set; }
+        public string Name { get; set; }
+
+        public ICollection<Car> Cars { get; set; }
+    }
+
+    public class Car
+    {
+        public int Id { get; set; }
+        public string Model { get; set; }
+
+        public int? OwnerId { get; set; }
+        public Person Owner { get; set; }
+    }
+    #endregion
+
+    public class ZeroToNullConverter : ValueConverter<int?, int>
+    {
+#pragma warning disable EF1001
+        public ZeroToNullConverter()
+            : base(
+                v => v ?? 0,
+                v => v == 0 ? null : v,
+                convertsNulls: true)
+        {
+        }
+#pragma warning restore EF1001
+    }
+
+    public class CarsContext : DbContext
+    {
+        private readonly bool _quiet;
+
+        public CarsContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        public DbSet<Car> Cars { get; set; }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder
+                .Entity<Car>()
+                .Property(e => e.OwnerId)
+                .HasConversion<ZeroToNullConverter>();
+        }
+    }
+
+    public class Cat
+    {
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public Breed? Breed { get; set; }
+    }
+
+    #region Breed
+    public enum Breed
+    {
+        Unknown,
+        Burmese,
+        Tonkinese
+    }
+    #endregion
+
+    #region BreedConverter
+    public class BreedConverter : ValueConverter<Breed, string>
+    {
+#pragma warning disable EF1001
+        public BreedConverter()
+            : base(
+                v => v == Breed.Unknown ? null : v.ToString(),
+                v => v == null ? Breed.Unknown : Enum.Parse<Breed>(v),
+                convertsNulls: true)
+        {
+        }
+#pragma warning restore EF1001
+    }
+    #endregion
+
+    public class CatsContext : DbContext
+    {
+        private readonly bool _quiet;
+
+        public CatsContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        public DbSet<Cat> Cats { get; set; }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder
+                .Entity<Cat>()
+                .Property(e => e.Breed)
+                .HasConversion<BreedConverter>();
+        }
+    }
+}
+
+namespace CarsMigrations
+{
+    [DbContext(typeof(ConvertNullsSample.CarsContext))]
+    [Migration("20210927174004_Cars")]
+    public partial class Cars : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.CreateTable(
+                name: "Person",
+                columns: table => new
+                {
+                    Id = table.Column<int>(type: "int", nullable: false)
+                        .Annotation("SqlServer:Identity", "1, 1"),
+                    Name = table.Column<string>(type: "nvarchar(max)", nullable: true)
+                },
+                constraints: table =>
+                    {
+                        table.PrimaryKey("PK_Person", x => x.Id);
+                    });
+
+            migrationBuilder.CreateTable(
+                name: "Cars",
+                columns: table => new
+                {
+                    Id = table.Column<int>(type: "int", nullable: false)
+                        .Annotation("SqlServer:Identity", "1, 1"),
+                    Model = table.Column<string>(type: "nvarchar(max)", nullable: true),
+                    OwnerId = table.Column<int>(type: "int", nullable: true)
+                },
+                constraints: table =>
+                    {
+                        table.PrimaryKey("PK_Cars", x => x.Id);
+                    });
+
+            migrationBuilder.CreateIndex(
+                name: "IX_Cars_OwnerId",
+                table: "Cars",
+                column: "OwnerId");
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropTable(
+                name: "Cars");
+
+            migrationBuilder.DropTable(
+                name: "Person");
+        }
+    }
+
+    [DbContext(typeof(ConvertNullsSample.CarsContext))]
+    partial class CarsContextModelSnapshot : ModelSnapshot
+    {
+        protected override void BuildModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "6.0.0-rc.1.21452.10")
+                .HasAnnotation("Relational:MaxIdentifierLength", 128);
+
+            SqlServerModelBuilderExtensions.UseIdentityColumns(modelBuilder, 1L, 1);
+
+            modelBuilder.Entity("ConvertNullsSample+Car", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("int");
+
+                    SqlServerPropertyBuilderExtensions.UseIdentityColumn(b.Property<int>("Id"), 1L, 1);
+
+                    b.Property<string>("Model")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<int?>("OwnerId")
+                        .HasColumnType("int");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("OwnerId");
+
+                    b.ToTable("Cars");
+                });
+
+            modelBuilder.Entity("ConvertNullsSample+Person", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("int");
+
+                    SqlServerPropertyBuilderExtensions.UseIdentityColumn(b.Property<int>("Id"), 1L, 1);
+
+                    b.Property<string>("Name")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.HasKey("Id");
+
+                    b.ToTable("Person");
+                });
+
+            modelBuilder.Entity("ConvertNullsSample+Car", b =>
+                {
+                    b.HasOne("ConvertNullsSample+Person", "Owner")
+                        .WithMany("Cars")
+                        .HasForeignKey("OwnerId");
+
+                    b.Navigation("Owner");
+                });
+
+            modelBuilder.Entity("ConvertNullsSample+Person", b =>
+                {
+                    b.Navigation("Cars");
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/DbContextFactorySample.cs b/samples/core/Miscellaneous/NewInEFCore6/DbContextFactorySample.cs
new file mode 100644
index 0000000000..ea1b5229fb
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/DbContextFactorySample.cs
@@ -0,0 +1,123 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.DependencyInjection;
+
+public static class DbContextFactorySample
+{
+    public static void Ignore_parameterless_constructor_when_creating_DbContext_from_factory()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Ignore_parameterless_constructor_when_creating_DbContext_from_factory)}");
+        Console.WriteLine();
+
+        var services = new ServiceCollection()
+            .AddDbContextFactory<SomeDbContext>(
+                builder => builder.UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0"))
+            .BuildServiceProvider();
+
+        var factory = services.GetService<IDbContextFactory<SomeDbContext>>();
+
+        using var context = factory.CreateDbContext();
+
+        Console.WriteLine();
+    }
+
+    public static void AddDbContextFactory_also_registers_scoped_DbContext_instance()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(AddDbContextFactory_also_registers_scoped_DbContext_instance)}");
+        Console.WriteLine();
+
+        var services = new ServiceCollection();
+
+        #region Registration
+        var container = services
+            .AddDbContextFactory<SomeDbContext>(
+                builder => builder.UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0"))
+            .BuildServiceProvider();
+        #endregion
+
+        // Factory can be obtained from the root container
+        #region ResolveFactory
+        var factory = container.GetService<IDbContextFactory<SomeDbContext>>();
+        using (var context = factory.CreateDbContext())
+        {
+            // Contexts obtained from the factory must be explicitly disposed
+        }
+        #endregion
+
+        // DbContext can only be obtained from a container scope
+        #region ResolveContext
+        using (var scope = container.CreateScope())
+        {
+            var context = scope.ServiceProvider.GetService<SomeDbContext>();
+            // Context is disposed when the scope is disposed
+        }
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    #region InjectContext
+    private class MyController1
+    {
+        private readonly SomeDbContext _context;
+
+        public MyController1(SomeDbContext context)
+        {
+            _context = context;
+        }
+
+        public async Task DoSomething()
+        {
+            var results = await _context.Blogs.ToListAsync();
+
+            // Injected context is disposed when the request scope is disposed
+        }
+    }
+    #endregion
+
+    #region InjectFactory
+    private class MyController2
+    {
+        private readonly IDbContextFactory<SomeDbContext> _contextFactory;
+
+        public MyController2(IDbContextFactory<SomeDbContext> contextFactory)
+        {
+            _contextFactory = contextFactory;
+        }
+
+        public async Task DoSomething()
+        {
+            using var context1 = _contextFactory.CreateDbContext();
+            using var context2 = _contextFactory.CreateDbContext();
+
+            var results1 = await context1.Blogs.ToListAsync();
+            var results2 = await context2.Blogs.ToListAsync();
+
+            // Contexts obtained from the factory must be explicitly disposed
+        }
+    }
+    #endregion
+
+    public class Blog
+    {
+        public int Id { get; set; }
+    }
+
+    #region Context
+    public class SomeDbContext : DbContext
+    {
+        public SomeDbContext()
+        {
+        }
+
+        public SomeDbContext(DbContextOptions<SomeDbContext> options)
+            : base(options)
+        {
+        }
+
+        public DbSet<Blog> Blogs { get; set; }
+    }
+    #endregion
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/EntityTypeConfigurationAttributeSample.cs b/samples/core/Miscellaneous/NewInEFCore6/EntityTypeConfigurationAttributeSample.cs
new file mode 100644
index 0000000000..041f79840f
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/EntityTypeConfigurationAttributeSample.cs
@@ -0,0 +1,96 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+using Microsoft.EntityFrameworkCore.Metadata.Builders;
+
+public static class EntityTypeConfigurationAttributeSample
+{
+    public static async Task Using_EntityTypeConfigurationAttribute()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Using_EntityTypeConfigurationAttribute)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BooksContext();
+
+        var book = await context.Books.SingleAsync(e => e.Id == 1);
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using var context = new BooksContext();
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        public static async Task PopulateDatabase()
+        {
+            using var context = new BooksContext();
+
+            context.Add(
+                new Book() { Isbn = "978-0-39-481823-8", Title = "What Do People Do All Day?" });
+
+            await context.SaveChangesAsync();
+        }
+    }
+
+    #region BookEntityType
+    [EntityTypeConfiguration(typeof(BookConfiguration))]
+    public class Book
+    {
+        public int Id { get; set; }
+        public string Title { get; set; }
+        public string Isbn { get; set; }
+    }
+    #endregion
+
+    #region BookConfiguration
+    public class BookConfiguration : IEntityTypeConfiguration<Book>
+    {
+        public void Configure(EntityTypeBuilder<Book> builder)
+        {
+            builder
+                .Property(e => e.Isbn)
+                .IsUnicode(false)
+                .HasMaxLength(22);
+        }
+    }
+    #endregion
+
+    #region DbContext
+    public class BooksContext : DbContext
+    {
+        public DbSet<Book> Books { get; set; }
+
+        //...
+        #endregion
+
+        private readonly bool _quiet;
+
+        public BooksContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/GroupBySample.cs b/samples/core/Miscellaneous/NewInEFCore6/GroupBySample.cs
new file mode 100644
index 0000000000..016264ded5
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/GroupBySample.cs
@@ -0,0 +1,565 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class GroupBySample
+{
+    public static async Task Translate_GroupBy_followed_by_FirstOrDefault_over_group()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Translate_GroupBy_followed_by_FirstOrDefault_over_group)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        // Example 1. From #12088
+        using (var context = new ShoesContext())
+        {
+            #region GroupBy1
+            var people = await context.People
+                .Include(e => e.Shoes)
+                .GroupBy(e => e.FirstName)
+                .Select(
+                    g => g.OrderBy(e => e.FirstName)
+                        .ThenBy(e => e.LastName)
+                        .FirstOrDefault())
+                .ToListAsync();
+            #endregion
+
+            Console.WriteLine();
+
+            foreach (var person in people)
+            {
+                Console.WriteLine($"{person.FirstName} {person.MiddleInitial} {person.LastName} has {person.Shoes.Count} pairs of shoes.");
+            }
+
+            Console.WriteLine();
+        }
+
+        // Example 2. From #16648
+        using (var context = new ShoesContext())
+        {
+            #region GroupBy2
+            var group = await context.People
+                .Select(
+                    p => new
+                    {
+                        p.FirstName,
+                        FullName = p.FirstName + " " + p.MiddleInitial + " " + p.LastName
+                    })
+                .GroupBy(p => p.FirstName)
+                .Select(g => g.First())
+                .FirstAsync();
+            #endregion
+
+            Console.WriteLine();
+            Console.WriteLine($"First name: {group.FirstName} Full name: {group.FullName}");
+            Console.WriteLine();
+        }
+
+        // Example 3. From #12640
+        using (var context = new ShoesContext())
+        {
+            #region GroupBy3
+            var people = await context.People
+                .Where(e => e.MiddleInitial == "Q" && e.Age == 20)
+                .GroupBy(e => e.LastName)
+                .Select(g => g.First().LastName)
+                .OrderBy(e => e.Length)
+                .ToListAsync();
+            #endregion
+
+            Console.WriteLine();
+
+            foreach (var person in people)
+            {
+                Console.WriteLine(person);
+            }
+
+            Console.WriteLine();
+        }
+
+        // Example 4: From #18037
+        using (var context = new ShoesContext())
+        {
+            #region GroupBy4
+            var results = await (from person in context.People
+                           join shoes in context.Shoes on person.Age equals shoes.Age
+                           group shoes by shoes.Style
+                           into people
+                           select new
+                           {
+                               people.Key,
+                               Style = people.Select(p => p.Style).FirstOrDefault(),
+                               Count = people.Count()
+                           })
+                .ToListAsync();
+            #endregion
+
+            Console.WriteLine();
+
+            foreach (var result in results)
+            {
+                Console.WriteLine($"{result.Key}: {result.Style} Count: {result.Count}");
+            }
+
+            Console.WriteLine();
+        }
+
+        // Example 5. From #12601
+        using (var context = new ShoesContext())
+        {
+            #region GroupBy5
+            var results = await context.People
+                .GroupBy(e => e.FirstName)
+                .Select(g => g.First().LastName)
+                .OrderBy(e => e)
+                .ToListAsync();
+            #endregion
+
+            Console.WriteLine();
+
+            foreach (var result in results)
+            {
+                Console.WriteLine(result);
+            }
+
+            Console.WriteLine();
+        }
+
+        // Example 6. From #12600
+        using (var context = new ShoesContext())
+        {
+            #region GroupBy6
+            var results = await context.People
+                .Where(e => e.Age == 20)
+                .GroupBy(e => e.Id)
+                .Select(g => g.First().MiddleInitial)
+                .OrderBy(e => e)
+                .ToListAsync();
+            #endregion
+
+            Console.WriteLine();
+
+            foreach (var result in results)
+            {
+                Console.WriteLine(result);
+            }
+
+            Console.WriteLine();
+        }
+
+        // Example 7. From #25460
+        using (var context = new ShoesContext())
+        {
+            #region GroupBy7
+            var size = 11;
+            var results
+                = await context.People
+                    .Where(
+                        p => p.Feet.Size == size
+                             && p.MiddleInitial != null
+                             && p.Feet.Id != 1)
+                    .GroupBy(
+                        p => new
+                        {
+                            p.Feet.Size,
+                            p.Feet.Person.LastName
+                        })
+                    .Select(
+                        g => new
+                        {
+                            g.Key.LastName,
+                            g.Key.Size,
+                            Min = g.Min(p => p.Feet.Size),
+                        })
+                    .ToListAsync();
+            #endregion
+
+            Console.WriteLine();
+
+            foreach (var result in results)
+            {
+                Console.WriteLine($"Last name = {result.LastName} Min = {result.Min} Size = {result.Size}");
+            }
+
+            Console.WriteLine();
+        }
+
+        // Example 8. From #24869
+        using (var context = new ShoesContext())
+        {
+            #region GroupBy8
+            var result = await context.People
+                .Include(x => x.Shoes)
+                .Include(x => x.Feet)
+                .GroupBy(
+                    x => new
+                    {
+                        x.Feet.Id,
+                        x.Feet.Size
+                    })
+                .Select(
+                    x => new
+                    {
+                        Key = x.Key.Id + x.Key.Size,
+                        Count = x.Count(),
+                        Sum = x.Sum(el => el.Id),
+                        SumOver60 = x.Sum(el => el.Id) / (decimal)60,
+                        TotalCallOutCharges = x.Sum(el => el.Feet.Size == 11 ? 1 : 0)
+                    })
+                .CountAsync();
+            #endregion
+
+            Console.WriteLine();
+            Console.WriteLine($"Count = {result}");
+            Console.WriteLine();
+        }
+
+        // Example 9. From #24591
+        using (var context = new ShoesContext())
+        {
+            #region GroupBy9
+            var results = await context.People
+                .GroupBy(n => n.FirstName)
+                .Select(g => new
+                {
+                    Feet = g.Key,
+                    Total = g.Sum(n => n.Feet.Size)
+                })
+                .ToListAsync();
+            #endregion
+
+            Console.WriteLine();
+
+            foreach (var result in results)
+            {
+                Console.WriteLine($"{result.Feet}: {result.Total}");
+            }
+
+            Console.WriteLine();
+        }
+
+        // Sample 10. From #24695 closed as duplicate of #13805.
+        using (var context = new ShoesContext())
+        {
+            #region GroupBy10
+            var results = from Person person1
+                              in from Person person2
+                                     in context.People
+                                 select person2
+                          join Shoes shoes
+                              in context.Shoes
+                              on person1.Age equals shoes.Age
+                          group shoes by
+                              new
+                              {
+                                  person1.Id,
+                                  shoes.Style,
+                                  shoes.Age
+                              }
+                          into temp
+                          select
+                              new
+                              {
+                                  temp.Key.Id,
+                                  temp.Key.Age,
+                                  temp.Key.Style,
+                                  Values = from t
+                                               in temp
+                                           select
+                                               new
+                                               {
+                                                   t.Id,
+                                                   t.Style,
+                                                   t.Age
+                                               }
+                              };
+            #endregion
+
+            Console.WriteLine();
+
+            await foreach (var result in results.AsAsyncEnumerable())
+            {
+                Console.WriteLine($"{result.Id}: {result.Age} year old {result.Style}");
+                foreach (var value in result.Values)
+                {
+                    Console.WriteLine($"    {value.Id}: {value.Age} year old {value.Style}");
+                }
+            }
+
+            Console.WriteLine();
+        }
+
+        // Sample 11. From #19506 closed as duplicate of #13805.
+        using (var context = new ShoesContext())
+        {
+            #region GroupBy11
+            var grouping = await context.People
+                .GroupBy(i => i.LastName)
+                .Select(g => new { LastName = g.Key, Count = g.Count() , First = g.FirstOrDefault(), Take = g.Take(2)})
+                .OrderByDescending(e => e.LastName)
+                .ToListAsync();
+            #endregion
+
+            Console.WriteLine();
+
+            foreach (var group in grouping)
+            {
+                Console.WriteLine($"LastName: {group.LastName} Count: {group.Count} First: {group.First.FirstName} {group.First.MiddleInitial} {group.First.LastName}");
+
+                foreach (var person in group.Take)
+                {
+                    Console.WriteLine($"    {person.FirstName} {person.MiddleInitial} {person.LastName}");
+                }
+            }
+
+            Console.WriteLine();
+        }
+
+        // Sample 12. From #13805
+        using (var context = new ShoesContext())
+        {
+            #region GroupBy12
+            var grouping = await context.People
+                .Include(e => e.Shoes)
+                .OrderBy(e => e.FirstName)
+                .ThenBy(e => e.LastName)
+                .GroupBy(e => e.FirstName)
+                .Select(g => new { Name = g.Key, People = g.ToList()})
+                .ToListAsync();
+            #endregion
+
+            Console.WriteLine();
+
+            foreach (var group in grouping)
+            {
+                foreach (var person in group.People)
+                {
+                    Console.WriteLine($"{person.FirstName} {person.LastName} has {person.Shoes.Count} pairs of shoes.");
+                }
+            }
+
+            Console.WriteLine();
+        }
+
+        // Sample 13. From #12088
+        using (var context = new ShoesContext())
+        {
+            #region GroupBy13
+            var grouping = await context.People
+                .GroupBy(m => new {m.FirstName, m.MiddleInitial })
+                .Select(am => new
+                {
+                    Key = am.Key,
+                    Items = am.ToList()
+                })
+                .ToListAsync();
+            #endregion
+
+            Console.WriteLine();
+
+            foreach (var group in grouping)
+            {
+                Console.WriteLine($"Group: {group.Key}");
+
+                foreach (var person in group.Items)
+                {
+                    Console.WriteLine($"    {person.FirstName} {person.MiddleInitial} {person.LastName}");
+                }
+            }
+
+            Console.WriteLine();
+        }
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using var context = new ShoesContext(quiet: true);
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        public static async Task PopulateDatabase()
+        {
+            using var context = new ShoesContext(quiet: true);
+
+            context.AddRange(
+                new Person
+                {
+                    FirstName = "Jim",
+                    MiddleInitial = "A",
+                    LastName = "Bob",
+                    Age = 20,
+                    Feet = new Feet { Size = 11 },
+                    Shoes = { new() { Style = "Sneakers", Age = 19 }, new() { Style = "Dress", Age = 20 } }
+                },
+                new Person
+                {
+                    FirstName = "Tom",
+                    MiddleInitial = "A",
+                    LastName = "Bob",
+                    Age = 20,
+                    Feet = new Feet { Size = 12 },
+                    Shoes = { new() { Style = "Sneakers", Age = 21 }, new() { Style = "Dress", Age = 19 } }
+                },
+                new Person
+                {
+                    FirstName = "Ben",
+                    MiddleInitial = "Q",
+                    LastName = "Bob",
+                    Age = 20,
+                    Feet = new Feet { Size = 12 },
+                    Shoes = { new() { Style = "Sneakers", Age = 20 }, new() { Style = "Dress", Age = 21 } }
+                },
+                new Person
+                {
+                    FirstName = "Jim",
+                    MiddleInitial = "Q",
+                    LastName = "Jon",
+                    Age = 20,
+                    Feet = new Feet { Size = 11 },
+                    Shoes = { new() { Style = "Sneakers", Age = 19 }, new() { Style = "Dress", Age = 20 } }
+                },
+                new Person
+                {
+                    FirstName = "Tom",
+                    MiddleInitial = "A",
+                    LastName = "Jon",
+                    Age = 21,
+                    Feet = new Feet { Size = 11 },
+                    Shoes = { new() { Style = "Sneakers", Age = 21 }, new() { Style = "Dress", Age = 19 } }
+                },
+                new Person
+                {
+                    FirstName = "Ben",
+                    MiddleInitial = "A",
+                    LastName = "Jon",
+                    Age = 21,
+                    Feet = new Feet { Size = 12 },
+                    Shoes = { new() { Style = "Sneakers", Age = 20 }, new() { Style = "Dress", Age = 21 } }
+                },
+                new Person
+                {
+                    FirstName = "Jim",
+                    MiddleInitial = "Q",
+                    LastName = "Don",
+                    Age = 21,
+                    Feet = new Feet { Size = 12 },
+                    Shoes = { new() { Style = "Sneakers", Age = 19 }, new() { Style = "Dress", Age = 20 } }
+                },
+                new Person
+                {
+                    FirstName = "Tom",
+                    MiddleInitial = "Q",
+                    LastName = "Don",
+                    Age = 21,
+                    Feet = new Feet { Size = 11 },
+                    Shoes = { new() { Style = "Sneakers", Age = 21 }, new() { Style = "Dress", Age = 19 } }
+                },
+                new Person
+                {
+                    FirstName = "Ben",
+                    MiddleInitial = "A",
+                    LastName = "Don",
+                    Age = 21,
+                    Feet = new Feet { Size = 11 },
+                    Shoes = { new() { Style = "Sneakers", Age = 20 }, new() { Style = "Dress", Age = 21 } }
+                },
+                new Person
+                {
+                    FirstName = "Jim",
+                    MiddleInitial = "A",
+                    LastName = "Zee",
+                    Age = 21,
+                    Feet = new Feet { Size = 12 },
+                    Shoes = { new() { Style = "Sneakers", Age = 19 }, new() { Style = "Dress", Age = 20 } }
+                },
+                new Person
+                {
+                    FirstName = "Tom",
+                    MiddleInitial = "Q",
+                    LastName = "Zee",
+                    Age = 21,
+                    Feet = new Feet { Size = 12 },
+                    Shoes = { new() { Style = "Sneakers", Age = 21 }, new() { Style = "Dress", Age = 19 } }
+                },
+                new Person
+                {
+                    FirstName = "Ben",
+                    MiddleInitial = "Q",
+                    LastName = "Zee",
+                    Age = 21,
+                    Feet = new Feet { Size = 11 },
+                    Shoes = { new() { Style = "Sneakers", Age = 20 }, new() { Style = "Dress", Age = 21 } }
+                });
+
+            await context.SaveChangesAsync();
+        }
+    }
+
+    #region Model
+    public class Person
+    {
+        public int Id { get; set; }
+        public int Age { get; set; }
+        public string FirstName { get; set; }
+        public string LastName { get; set; }
+        public string MiddleInitial { get; set; }
+        public Feet Feet { get; set; }
+        public ICollection<Shoes> Shoes { get; } = new List<Shoes>();
+    }
+
+    public class Shoes
+    {
+        public int Id { get; set; }
+        public int Age { get; set; }
+        public string Style { get; set; }
+        public Person Person { get; set; }
+    }
+
+    public class Feet
+    {
+        public int Id { get; set; }
+        public int Size { get; set; }
+        public Person Person { get; set; }
+    }
+    #endregion
+
+    public class ShoesContext : DbContext
+    {
+        public DbSet<Person> People { get; set; }
+        public DbSet<Shoes> Shoes { get; set; }
+        public DbSet<Feet> Feet { get; set; }
+
+        private readonly bool _quiet;
+
+        public ShoesContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Feet>().HasOne(e => e.Person).WithOne(e => e.Feet).HasForeignKey<Feet>();
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/HasConversionSample.cs b/samples/core/Miscellaneous/NewInEFCore6/HasConversionSample.cs
new file mode 100644
index 0000000000..b8aa5881f1
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/HasConversionSample.cs
@@ -0,0 +1,157 @@
+using System;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+public static class HasConversionSample
+{
+    public static async Task Can_set_value_converter_type_using_generic_method()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Can_set_value_converter_type_using_generic_method)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using var context = new CurrencyContext(quiet: true);
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        public static async Task PopulateDatabase()
+        {
+            using var context = new CurrencyContext();
+
+            context.AddRange(
+                new TestEntity1
+                {
+                    Currency = Currency.UsDollars
+                },
+                new TestEntity1
+                {
+                    Currency = Currency.Euros
+                },
+                new TestEntity1
+                {
+                    Currency = Currency.PoundsSterling
+                },
+                new TestEntity2
+                {
+                    Currency = Currency.UsDollars
+                },
+                new TestEntity2
+                {
+                    Currency = Currency.Euros
+                },
+                new TestEntity2
+                {
+                    Currency = Currency.PoundsSterling
+                },
+                new TestEntity3
+                {
+                    Currency = Currency.UsDollars
+                },
+                new TestEntity3
+                {
+                    Currency = Currency.Euros
+                },
+                new TestEntity3
+                {
+                    Currency = Currency.PoundsSterling
+                });
+
+            await context.SaveChangesAsync();
+        }
+    }
+
+    public class TestEntity1
+    {
+        public int Id { get; set; }
+        public Currency Currency{ get; set; }
+    }
+
+    public class TestEntity2
+    {
+        public int Id { get; set; }
+        public Currency Currency{ get; set; }
+    }
+
+    public class TestEntity3
+    {
+        public int Id { get; set; }
+        public Currency Currency{ get; set; }
+    }
+
+    #region CurrencyEnum
+    public enum Currency
+    {
+        UsDollars,
+        PoundsSterling,
+        Euros
+    }
+    #endregion
+
+    #region CurrencyConverter
+    public class CurrencyToSymbolConverter : ValueConverter<Currency, string>
+    {
+        public CurrencyToSymbolConverter()
+            : base(
+                v => v == Currency.PoundsSterling ? "£" : v == Currency.Euros ? "€" : "$",
+                v => v == "£" ? Currency.PoundsSterling : v == "€" ? Currency.Euros : Currency.UsDollars)
+        {
+        }
+    }
+    #endregion
+
+    public class CurrencyContext : DbContext
+    {
+        private readonly bool _quiet;
+
+        public CurrencyContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region AsString
+            modelBuilder.Entity<TestEntity1>()
+                .Property(e => e.Currency)
+                .HasConversion<string>();
+            #endregion
+
+            #region AsShort
+            modelBuilder.Entity<TestEntity2>()
+                .Property(e => e.Currency)
+                .HasConversion<EnumToNumberConverter<Currency, short>>();
+            #endregion
+
+            #region AsSymbol
+            modelBuilder.Entity<TestEntity3>()
+                .Property(e => e.Currency)
+                .HasConversion<CurrencyToSymbolConverter>();
+            #endregion
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/InMemoryRequiredPropertiesSample.cs b/samples/core/Miscellaneous/NewInEFCore6/InMemoryRequiredPropertiesSample.cs
new file mode 100644
index 0000000000..caf9a2d9e1
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/InMemoryRequiredPropertiesSample.cs
@@ -0,0 +1,80 @@
+using System;
+using System.ComponentModel.DataAnnotations;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class InMemoryRequiredPropertiesSample
+{
+    public static async Task Required_properties_validated_with_in_memory_database()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Required_properties_validated_with_in_memory_database)}");
+        Console.WriteLine();
+
+        using var context = new UserContext();
+
+        context.Add(new User());
+
+        try
+        {
+            await context.SaveChangesAsync();
+        }
+        catch (Exception e)
+        {
+            Console.WriteLine($"{e.GetType().FullName}: {e.Message}");
+        }
+
+        Console.WriteLine();
+    }
+
+    public static async Task Required_property_validation_with_in_memory_database_can_be_disabled()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Required_property_validation_with_in_memory_database_can_be_disabled)}");
+        Console.WriteLine();
+
+        using var context = new UserContextWithNullCheckingDisabled();
+
+        context.Add(new User());
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+    }
+
+    #region UserEntityType
+    public class User
+    {
+        public int Id { get; set; }
+
+        [Required]
+        public string Username { get; set; }
+    }
+    #endregion
+
+    public class UserContext : DbContext
+    {
+        public DbSet<User> Users { get; set; }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .LogTo(Console.WriteLine, new[] { InMemoryEventId.ChangesSaved })
+                .EnableSensitiveDataLogging()
+                .UseInMemoryDatabase("UserContext");
+        }
+    }
+
+    public class UserContextWithNullCheckingDisabled : DbContext
+    {
+        public DbSet<User> Users { get; set; }
+
+        #region OnConfiguring
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .LogTo(Console.WriteLine, new[] { InMemoryEventId.ChangesSaved })
+                .UseInMemoryDatabase("UserContextWithNullCheckingDisabled", b => b.EnableNullChecks(false));
+        }
+        #endregion
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/IsNullOrWhitespaceSample.cs b/samples/core/Miscellaneous/NewInEFCore6/IsNullOrWhitespaceSample.cs
new file mode 100644
index 0000000000..647d6a9907
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/IsNullOrWhitespaceSample.cs
@@ -0,0 +1,110 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class IsNullOrWhitespaceSample
+{
+    public static async Task Translate_IsNullOrWhitespace()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Translate_IsNullOrWhitespace)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BooksContext();
+
+        #region Query
+        var users = await context.Users.Where(
+            e => string.IsNullOrWhiteSpace(e.FirstName)
+                 || string.IsNullOrWhiteSpace(e.LastName)).ToListAsync();
+        #endregion
+
+        foreach (var user in users)
+        {
+            Console.WriteLine($"Found '{user.FirstName}' '{user.LastName}'");
+        }
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using var context = new BooksContext(quiet: true);
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        public static async Task PopulateDatabase()
+        {
+            using var context = new BooksContext(quiet: true);
+
+            context.AddRange(
+                new User
+                {
+                    FirstName = "Arthur"
+                },
+                new User
+                {
+                    FirstName = "Arthur",
+                    LastName = "Vickers"
+                },
+                new User
+                {
+                    FirstName = "",
+                    LastName = "Vickers"
+                },
+                new User
+                {
+                    FirstName = " ",
+                    LastName = "Vickers"
+                },
+                new User
+                {
+                    FirstName = "Arthur",
+                    LastName = "\t"
+                });
+
+            await context.SaveChangesAsync();
+        }
+    }
+
+    #region ProductEntityType
+    public class User
+    {
+        public int Id { get; set; }
+
+        public string FirstName { get; set; }
+        public string LastName { get; set; }
+    }
+    #endregion
+
+    public class BooksContext : DbContext
+    {
+        public DbSet<User> Users { get; set; }
+
+        private readonly bool _quiet;
+
+        public BooksContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/ManyToManyConfigurationSample.cs b/samples/core/Miscellaneous/NewInEFCore6/ManyToManyConfigurationSample.cs
new file mode 100644
index 0000000000..4e27a760b8
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/ManyToManyConfigurationSample.cs
@@ -0,0 +1,185 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class ManyToManyConfigurationSample
+{
+    public static async Task Many_to_many_relationships_may_need_less_configuration()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Many_to_many_relationships_may_need_less_configuration)}");
+        Console.WriteLine();
+
+        await ManyToManyTest<NoConfigContext>();
+        await ManyToManyTest<JustNavigationsContext>();
+        await ManyToManyTest<SpecifySharedEntityTypeContext>();
+        await ManyToManyTest<SpecifyEntityTypeContext>();
+        // await ManyToManyTest<SpecifyEntityTypeAndKeyContext>();
+        await ManyToManyTest<SpecifyEntityTypeAndFksContext>();
+    }
+
+    public static async Task ManyToManyTest<TContext>()
+        where TContext : BaseContext, new()
+    {
+        Console.WriteLine($"{typeof(TContext).Name}: ");
+        Console.WriteLine();
+
+        using (var context = new TContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+
+            Console.WriteLine(context.Model.ToDebugString());
+            Console.WriteLine();
+
+            context.Log = true;
+            await context.Database.EnsureCreatedAsync();
+            context.Log = false;
+
+            var cats = new List<Cat>
+            {
+                new() { Name = "Alice" },
+                new() { Name = "Mac" }
+            };
+
+            context.AddRange(new List<Human>
+            {
+                new() { Name = "Wendy", Cats = { cats[0], cats[1] } },
+                new() { Name = "Arthur", Cats = { cats[0], cats[1] } }
+            });
+
+            await context.SaveChangesAsync();
+        }
+
+        Console.WriteLine();
+
+        using (var context = new TContext())
+        {
+            var cats = await context.Cats.Include(e => e.Humans).ToListAsync();
+            foreach (var cat in cats)
+            {
+                Console.WriteLine($"{cat.Name} has {cat.Humans.Count} humans.");
+            }
+        }
+        Console.WriteLine();
+    }
+
+    public class Cat
+    {
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public ICollection<Human> Humans { get; } = new List<Human>();
+    }
+
+    public class Human
+    {
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public ICollection<Cat> Cats { get; } = new List<Cat>();
+    }
+
+    public class CatHuman
+    {
+        public int CatsId { get; set; }
+        public int HumansId { get; set; }
+        //
+        // public Cat Cat { get; set; }
+        // public Human Human { get; set; }
+    }
+
+    public class NoConfigContext : BaseContext
+    {
+    }
+
+    public class JustNavigationsContext : BaseContext
+    {
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region JustNavigation
+            modelBuilder.Entity<Cat>()
+                .HasMany(e => e.Humans)
+                .WithMany(e => e.Cats);
+            #endregion
+        }
+    }
+
+    public class SpecifySharedEntityTypeContext : BaseContext
+    {
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Cat>()
+                .HasMany(e => e.Humans)
+                .WithMany(e => e.Cats)
+                .UsingEntity<Dictionary<string, object>>();
+        }
+    }
+
+    public class SpecifyEntityTypeContext : BaseContext
+    {
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region SpecifyEntityType
+            modelBuilder.Entity<Cat>()
+                .HasMany(e => e.Humans)
+                .WithMany(e => e.Cats)
+                .UsingEntity<CatHuman>();
+            #endregion
+        }
+    }
+
+    public class SpecifyEntityTypeAndKeyContext : BaseContext
+    {
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region SpecifyEntityTypeAndKey
+            modelBuilder.Entity<Cat>()
+                .HasMany(e => e.Humans)
+                .WithMany(e => e.Cats)
+                .UsingEntity<CatHuman>(
+                    e => e.HasKey(e => new { e.CatsId, e.HumansId }));
+            #endregion
+        }
+    }
+
+    public class SpecifyEntityTypeAndFksContext : BaseContext
+    {
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region SpecifyEntityTypeAndFks
+            modelBuilder.Entity<Cat>()
+                .HasMany(e => e.Humans)
+                .WithMany(e => e.Cats)
+                .UsingEntity<CatHuman>(
+                    e => e.HasOne<Human>().WithMany().HasForeignKey(e => e.CatsId),
+                    e => e.HasOne<Cat>().WithMany().HasForeignKey(e => e.HumansId),
+                    e => e.HasKey(e => new { e.CatsId, e.HumansId }));
+            #endregion
+        }
+    }
+
+    public abstract class BaseContext : DbContext
+    {
+        public bool Log { get; set; }
+
+        public DbSet<Cat> Cats { get; set; }
+        public DbSet<Human> Humans { get; set; }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            optionsBuilder.LogTo(
+                s =>
+                    {
+                        if (Log)
+                        {
+                            Console.WriteLine(s);
+                        }
+                    },
+                new[] { RelationalEventId.CommandExecuted });
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/MathFTranslationSample.cs b/samples/core/Miscellaneous/NewInEFCore6/MathFTranslationSample.cs
new file mode 100644
index 0000000000..64d32baadd
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/MathFTranslationSample.cs
@@ -0,0 +1,103 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class MathFTranslationSample
+{
+    public static async Task Translate_MathF_methods()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Translate_MathF_methods)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new CustomersContext();
+
+        // Fails; see #25421
+        // var result = await context.Reviews
+        //     .Select(e => new
+        //     {
+        //         e.Title,
+        //         Rating = MathF.Truncate(e.Rating)
+        //     })
+        //     .OrderBy(e => e.Rating)
+        //     .FirstAsync();
+
+        Console.WriteLine();
+        // Console.WriteLine($"Found {result.Title} with rating {result.Rating}.");
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using var context = new CustomersContext(quiet: true);
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        public static async Task PopulateDatabase()
+        {
+            using var context = new CustomersContext(quiet: true);
+
+            context.AddRange(
+                new Review
+                {
+                    Title = "My yellow kettle",
+                    Description = "Awesome!",
+                    Rating = 5.0f
+                },
+                new Review
+                {
+                    Title = "My TV",
+                    Description = "Would be nice if it didn't keep switching to German.",
+                    Rating = 2.0f
+                },
+                new Review
+                {
+                    Title = "Big bed",
+                    Description = "Good, but hard to put together",
+                    Rating = 3.5f
+                });
+
+            await context.SaveChangesAsync();
+        }
+    }
+
+    public class Review
+    {
+        public int Id { get; set; }
+        public string Title { get; set; }
+        public string Description { get; set; }
+        public float Rating { get; set; }
+    }
+
+    public class CustomersContext : DbContext
+    {
+        public DbSet<Review> Reviews { get; set; }
+
+        private readonly bool _quiet;
+
+        public CustomersContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/MinimalApiSample.cs b/samples/core/Miscellaneous/NewInEFCore6/MinimalApiSample.cs
new file mode 100644
index 0000000000..8d6729ceee
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/MinimalApiSample.cs
@@ -0,0 +1,76 @@
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.DependencyInjection;
+
+public static class MinimalApiSample
+{
+    public static void Add_a_DbContext_and_provider()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Add_a_DbContext_and_provider)}");
+
+        SqliteMinimal(null);
+        SqliteNormal(null);
+
+        SqlServerMinimal(null);
+        SqlServerNormal(null);
+    }
+
+    private static void SqliteMinimal(string[] args)
+    {
+        #region SqliteMinimal
+        var builder = WebApplication.CreateBuilder(args);
+
+        builder.Services.AddSqlite<MyDbContext>("Data Source=mydatabase.db");
+        #endregion
+    }
+
+    private static void SqliteNormal(string[] args)
+    {
+        #region SqliteNormal
+        var builder = WebApplication.CreateBuilder(args);
+
+        builder.Services.AddDbContext<MyDbContext>(
+            options => options.UseSqlite("Data Source=mydatabase.db"));
+        #endregion
+    }
+
+    private static void SqlServerMinimal(string[] args)
+    {
+        #region SqlServerMinimal
+        var builder = WebApplication.CreateBuilder(args);
+
+        builder.Services.AddSqlServer<MyDbContext>(@"Server=(localdb)\mssqllocaldb;Database=MyDatabase");
+        #endregion
+    }
+
+    private static void SqlServerNormal(string[] args)
+    {
+        #region SqlServerNormal
+        var builder = WebApplication.CreateBuilder(args);
+
+        builder.Services.AddDbContext<MyDbContext>(
+            options => options.UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=MyDatabase;ConnectRetryCount=0"));
+        #endregion
+    }
+
+    // This is a fake implementation of WebApplicationBuilder  uses to show the EF Core minimal APIs
+    private class FakeWebApplicationBuilder
+    {
+        public ServiceCollection Services { get; } = new();
+    }
+
+    // This is a fake implementation of WebApplication uses to show the EF Core minimal APIs
+    private static class WebApplication
+    {
+        public static FakeWebApplicationBuilder CreateBuilder(string[] args)
+            => new();
+    }
+
+    public class MyDbContext : DbContext
+    {
+        public MyDbContext(DbContextOptions<MyDbContext> options)
+            : base(options)
+        {
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/NewInEFCore6.csproj b/samples/core/Miscellaneous/NewInEFCore6/NewInEFCore6.csproj
new file mode 100644
index 0000000000..83605662c2
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/NewInEFCore6.csproj
@@ -0,0 +1,17 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net6.0</TargetFramework>
+    <RootNamespace />
+    <NoWarn>$(NoWarn);NETSDK1138</NoWarn> <!-- The target framework 'net6.0' is out of support -->
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="6.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="6.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="6.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.InMemory" Version="6.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/NewInEFCore6/OptionalDependentsSample.cs b/samples/core/Miscellaneous/NewInEFCore6/OptionalDependentsSample.cs
new file mode 100644
index 0000000000..b9d9c92f2d
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/OptionalDependentsSample.cs
@@ -0,0 +1,592 @@
+using System;
+using System.ComponentModel.DataAnnotations;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Logging;
+
+public static class OptionalDependentsSample
+{
+    public static async Task Optional_dependents_with_a_required_property()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Optional_dependents_with_a_required_property)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        using (var context = new SomeDbContext())
+        {
+            #region NoAddress
+            context.Customers1.Add(
+                new()
+                {
+                    Name = "Foul Ole Ron"
+                });
+            #endregion
+
+            #region PostcodeOnly
+            context.Customers1.Add(
+                new()
+                {
+                    Name = "Havelock Vetinari",
+                    Address = new()
+                    {
+                        Postcode = "AN1 1PL",
+                    }
+                });
+            #endregion
+
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SomeDbContext())
+        {
+            #region CheckForNullAddress
+            await foreach (var customer in context.Customers1.AsAsyncEnumerable())
+            {
+                Console.Write(customer.Name);
+
+                if (customer.Address == null)
+                {
+                    Console.WriteLine(" has no address.");
+                }
+                else
+                {
+                    Console.WriteLine($" has postcode {customer.Address.Postcode}.");
+                }
+            }
+            #endregion
+        }
+
+        Console.WriteLine();
+    }
+
+    public static async Task Optional_dependents_without_a_required_property()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Optional_dependents_without_a_required_property)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        using (var context = new SomeDbContext())
+        {
+            #region AllNull
+            context.Customers2.Add(
+                new()
+                {
+                    Name = "Foul Ole Ron"
+                });
+
+            context.Customers2.Add(
+                new()
+                {
+                    Name = "Havelock Vetinari",
+                    Address = new()
+                });
+
+            #endregion
+
+            await context.SaveChangesAsync();
+        }
+
+        Console.WriteLine();
+
+        using (var context = new SomeDbContext())
+        {
+            var connection = context.Database.GetDbConnection();
+            await connection.OpenAsync();
+
+            await using var command = connection.CreateCommand();
+            command.CommandText = "SELECT Id, Name, Address_House, Address_Street, Address_City, Address_Postcode FROM Customers2";
+
+            Console.WriteLine($"Id  Name               House   Street  City    Postcode");
+
+            await using var reader = await command.ExecuteReaderAsync();
+            while (await reader.ReadAsync())
+            {
+                Console.Write($"{reader.GetInt32(0)}   {reader.GetString(1).PadRight(17)}  ");
+                for (int i = 2; i <= 5; i++)
+                {
+                    Console.Write(reader.IsDBNull(i) ? "NULL    " : reader.GetString(i).PadRight(8));
+                }
+                Console.WriteLine();
+            }
+
+            await connection.CloseAsync();
+        }
+
+        Console.WriteLine();
+    }
+
+    public static async Task Handling_optional_dependents_sharing_table_with_principal_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Handling_optional_dependents_sharing_table_with_principal_1)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        using (var context = new SomeDbContext())
+        {
+            var principal = new PrincipalWithOptionalDependents();
+            context.Add(principal);
+
+            Console.WriteLine("Saving principal with all null dependent objects:");
+            Console.WriteLine($"  Dependent with only optional properties is {(principal.DependentWithOnlyOptionalProperties != null ? "not " : "")}null.");
+            Console.WriteLine($"  Dependent with only required properties is {(principal.DependentWithOnlyRequiredProperties != null ? "not " : "")}null.");
+            Console.WriteLine($"  Dependent with both optional and required properties is {(principal.DependentWithOptionalAndRequiredProperties != null ? "not " : "")}null.");
+
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SomeDbContext())
+        {
+            var principal = await context.PrincipalsWithOptionalDependents.SingleAsync();
+            Console.WriteLine("After querying back principal and dependents saved above:");
+            Console.WriteLine($"  Dependent with only optional properties is {(principal.DependentWithOnlyOptionalProperties != null ? "not " : "")}null.");
+            Console.WriteLine($"  Dependent with only required properties is {(principal.DependentWithOnlyRequiredProperties != null ? "not " : "")}null.");
+            Console.WriteLine($"  Dependent with both optional and required properties is {(principal.DependentWithOptionalAndRequiredProperties != null ? "not " : "")}null.");
+        }
+
+        Console.WriteLine();
+    }
+
+    public static async Task Handling_optional_dependents_sharing_table_with_principal_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Handling_optional_dependents_sharing_table_with_principal_2)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        using (var context = new SomeDbContext())
+        {
+            var principal = new PrincipalWithOptionalDependents
+            {
+                DependentWithOnlyOptionalProperties = new(),
+                DependentWithOnlyRequiredProperties = new(),
+                DependentWithOptionalAndRequiredProperties = new(),
+            };
+
+            context.Add(principal);
+
+            Console.WriteLine("Saving principal with all non-null dependent objects:");
+            Console.WriteLine($"  Dependent with only optional properties is {(principal.DependentWithOnlyOptionalProperties != null ? "not " : "")}null.");
+            Console.WriteLine($"  Dependent with only required properties is {(principal.DependentWithOnlyRequiredProperties != null ? "not " : "")}null.");
+            Console.WriteLine($"  Dependent with both optional and required properties is {(principal.DependentWithOptionalAndRequiredProperties != null ? "not " : "")}null.");
+
+            Console.WriteLine();
+            Console.WriteLine("SaveChanges will warn:");
+            Console.WriteLine();
+            await context.SaveChangesAsync();
+            Console.WriteLine();
+        }
+
+        using (var context = new SomeDbContext())
+        {
+            var principal = await context.PrincipalsWithOptionalDependents.SingleAsync();
+            Console.WriteLine("After querying back principal and dependents saved above:");
+            Console.WriteLine($"  Dependent with only optional properties is {(principal.DependentWithOnlyOptionalProperties != null ? "not " : "")}null. <-- Note dependent is null here.");
+            Console.WriteLine($"  Dependent with only required properties is {(principal.DependentWithOnlyRequiredProperties != null ? "not " : "")}null.");
+            Console.WriteLine($"  Dependent with both optional and required properties is {(principal.DependentWithOptionalAndRequiredProperties != null ? "not " : "")}null.");
+        }
+
+        Console.WriteLine();
+    }
+
+    public static async Task Handling_required_dependents_sharing_table_with_principal()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Handling_required_dependents_sharing_table_with_principal)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        using (var context = new SomeDbContext())
+        {
+            var principal = new PrincipalWithRequiredDependents
+            {
+                DependentWithOnlyOptionalProperties = new(),
+                DependentWithOnlyRequiredProperties = new(),
+                DependentWithOptionalAndRequiredProperties = new(),
+            };
+            context.Add(principal);
+
+            Console.WriteLine("Saving principal with all non-null dependent objects:");
+            Console.WriteLine($"  Dependent with only optional properties is {(principal.DependentWithOnlyOptionalProperties != null ? "not " : "")}null.");
+            Console.WriteLine($"  Dependent with only required properties is {(principal.DependentWithOnlyRequiredProperties != null ? "not " : "")}null.");
+            Console.WriteLine($"  Dependent with both optional and required properties is {(principal.DependentWithOptionalAndRequiredProperties != null ? "not " : "")}null.");
+
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SomeDbContext())
+        {
+            var principal = await context.PrincipalsWithRequiredDependents.SingleAsync();
+            Console.WriteLine("After querying back principal and dependents saved above:");
+            Console.WriteLine($"  Dependent with only optional properties is {(principal.DependentWithOnlyOptionalProperties != null ? "not " : "")}null.");
+            Console.WriteLine($"  Dependent with only required properties is {(principal.DependentWithOnlyRequiredProperties != null ? "not " : "")}null.");
+            Console.WriteLine($"  Dependent with both optional and required properties is {(principal.DependentWithOptionalAndRequiredProperties != null ? "not " : "")}null.");
+        }
+
+        Console.WriteLine();
+    }
+
+    public static async Task Handling_nested_optional_dependents_sharing_table_with_principal()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Handling_nested_optional_dependents_sharing_table_with_principal)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        using (var context = new SomeDbContext())
+        {
+            var principal = new PrincipalWithNestedOptionalDependents()
+            {
+                DependentWithOptionalNestedDependents = new()
+                {
+                    Nested = new()
+                }
+            };
+
+            context.Add(principal);
+
+            Console.WriteLine("Saving principal with all non-null required dependent objects:");
+            Console.WriteLine($"  Dependent with only optional properties is {(principal.DependentWithOptionalNestedDependents != null ? "not " : "")}null.");
+            Console.WriteLine($"  Nested dependent with only optional properties is {(principal.DependentWithOptionalNestedDependents?.Nested != null ? "not " : "")}null.");
+
+
+            Console.WriteLine();
+            Console.WriteLine("SaveChanges will warn:");
+            Console.WriteLine();
+            await context.SaveChangesAsync();
+            Console.WriteLine();
+        }
+
+        using (var context = new SomeDbContext())
+        {
+            var principal = await context.PrincipalsWithNestedOptionalDependents.SingleAsync();
+            Console.WriteLine("After querying back principal and dependents saved above:");
+            Console.WriteLine($"  Dependent with only optional properties is {(principal.DependentWithOptionalNestedDependents != null ? "not " : "")}null.");
+            Console.WriteLine($"  Nested dependent with only optional properties is {(principal.DependentWithOptionalNestedDependents?.Nested != null ? "not " : "")}null. <-- Note nested dependent is null here.");
+        }
+
+        Console.WriteLine();
+    }
+
+    public static async Task Handling_nested_required_dependents_sharing_table_with_principal()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Handling_nested_required_dependents_sharing_table_with_principal)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        using (var context = new SomeDbContext())
+        {
+            var principal = new PrincipalWithNestedRequiredDependents()
+            {
+                DependentWithRequiredNestedDependents = new()
+                {
+                    Nested = new()
+                }
+            };
+
+            context.Add(principal);
+
+            Console.WriteLine("Saving principal with all non-null required dependent objects:");
+            Console.WriteLine($"  Dependent with only optional properties is {(principal.DependentWithRequiredNestedDependents != null ? "not " : "")}null.");
+            Console.WriteLine($"  Nested dependent with only optional properties is {(principal.DependentWithRequiredNestedDependents?.Nested != null ? "not " : "")}null.");
+
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SomeDbContext())
+        {
+            var principal = await context.PrincipalsWithNestedRequiredDependents.SingleAsync();
+            Console.WriteLine("After querying back principal and dependents saved above:");
+            Console.WriteLine($"  Dependent with only optional properties is {(principal.DependentWithRequiredNestedDependents != null ? "not " : "")}null.");
+            Console.WriteLine($"  Nested dependent with only optional properties is {(principal.DependentWithRequiredNestedDependents?.Nested != null ? "not " : "")}null.");
+        }
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using var context = new SomeDbContext(quiet: true);
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+    }
+
+    public class PrincipalWithOptionalDependents
+    {
+        public int Id { get; set; }
+
+        public DependentWithOptionalAndRequiredProperties DependentWithOptionalAndRequiredProperties { get; set; }
+        public DependentWithOnlyOptionalProperties DependentWithOnlyOptionalProperties { get; set; }
+        public DependentWithOnlyRequiredProperties DependentWithOnlyRequiredProperties { get; set; }
+    }
+
+    public class PrincipalWithRequiredDependents
+    {
+        public int Id { get; set; }
+
+        public DependentWithOptionalAndRequiredProperties DependentWithOptionalAndRequiredProperties { get; set; }
+        public DependentWithOnlyOptionalProperties DependentWithOnlyOptionalProperties { get; set; }
+        public DependentWithOnlyRequiredProperties DependentWithOnlyRequiredProperties { get; set; }
+    }
+
+    public class DependentWithOptionalAndRequiredProperties
+    {
+        public int? Optional { get; set; }
+        public int Required { get; set; }
+    }
+
+    public class DependentWithOnlyOptionalProperties
+    {
+        public int? Optional { get; set; }
+    }
+
+    public class DependentWithOnlyRequiredProperties
+    {
+        public int Required { get; set; }
+    }
+
+    public class PrincipalWithNestedOptionalDependents
+    {
+        public int Id { get; set; }
+
+        public DependentWithOptionalNestedDependents DependentWithOptionalNestedDependents { get; set; }
+    }
+
+    public class DependentWithOptionalNestedDependents
+    {
+        public int Required { get; set; }
+        public DependentWithOnlyOptionalProperties Nested { get; set; }
+    }
+
+    public class PrincipalWithNestedRequiredDependents
+    {
+        public int Id { get; set; }
+
+        public DependentWithRequiredNestedDependents DependentWithRequiredNestedDependents { get; set; }
+    }
+
+    public class DependentWithRequiredNestedDependents
+    {
+        public int? Optional { get; set; }
+        public DependentWithOnlyOptionalProperties Nested { get; set; }
+    }
+
+    public class WithRequiredProperty
+    {
+        #region AddressWithRequiredProperty
+        public class Customer
+        {
+            public int Id { get; set; }
+            public string Name { get; set; }
+            public Address Address { get; set; }
+        }
+
+        public class Address
+        {
+            public string House { get; set; }
+            public string Street { get; set; }
+            public string City { get; set; }
+
+            [Required]
+            public string Postcode { get; set; }
+        }
+        #endregion
+    }
+
+    public class WithoutRequiredProperty
+    {
+        #region AddressWithoutRequiredProperty
+        public class Customer
+        {
+            public int Id { get; set; }
+            public string Name { get; set; }
+            public Address Address { get; set; }
+        }
+
+        public class Address
+        {
+            public string House { get; set; }
+            public string Street { get; set; }
+            public string City { get; set; }
+            public string Postcode { get; set; }
+        }
+        #endregion
+    }
+
+    public class WithRequiredNavigation
+    {
+        #region AddressWithRequiredNavigation
+        public class Customer
+        {
+            public int Id { get; set; }
+            public string Name { get; set; }
+
+            [Required]
+            public Address Address { get; set; }
+        }
+
+        public class Address
+        {
+            public string House { get; set; }
+            public string Street { get; set; }
+            public string City { get; set; }
+            public string Postcode { get; set; }
+        }
+        #endregion
+    }
+
+    public class WithDifferentTable
+    {
+        #region AddressWithDifferentTable
+        public class Customer
+        {
+            public int Id { get; set; }
+            public string Name { get; set; }
+            public Address Address { get; set; }
+        }
+
+        public class Address
+        {
+            public string House { get; set; }
+            public string Street { get; set; }
+            public string City { get; set; }
+            public string Postcode { get; set; }
+        }
+        #endregion
+    }
+
+    public class NestedWithoutRequiredProperty
+    {
+        #region NestedWithoutRequiredProperty
+        public class Customer
+        {
+            public int Id { get; set; }
+            public string Name { get; set; }
+            public ContactInfo ContactInfo { get; set; }
+        }
+
+        public class ContactInfo
+        {
+            public string Phone { get; set; }
+            public Address Address { get; set; }
+        }
+
+        public class Address
+        {
+            public string House { get; set; }
+            public string Street { get; set; }
+            public string City { get; set; }
+            public string Postcode { get; set; }
+        }
+        #endregion
+    }
+
+    public class SomeDbContext : DbContext
+    {
+        public DbSet<PrincipalWithOptionalDependents> PrincipalsWithOptionalDependents { get; set; }
+        public DbSet<PrincipalWithRequiredDependents> PrincipalsWithRequiredDependents { get; set; }
+        public DbSet<PrincipalWithNestedOptionalDependents> PrincipalsWithNestedOptionalDependents { get; set; }
+        public DbSet<PrincipalWithNestedRequiredDependents> PrincipalsWithNestedRequiredDependents { get; set; }
+
+        public DbSet<WithRequiredProperty.Customer> Customers1 { get; set; }
+        public DbSet<WithoutRequiredProperty.Customer> Customers2 { get; set; }
+
+        private readonly bool _quiet;
+
+        public SomeDbContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder
+                .Entity<WithRequiredProperty.Customer>()
+                .OwnsOne(e => e.Address);
+
+            modelBuilder
+                .Entity<WithoutRequiredProperty.Customer>()
+                .OwnsOne(e => e.Address);
+
+            #region RequiredInModel
+            modelBuilder.Entity<WithRequiredNavigation.Customer>(
+                b =>
+                    {
+                        b.OwnsOne(e => e.Address);
+                        b.Navigation(e => e.Address).IsRequired();
+                    });
+            #endregion
+
+            #region WithDifferentTable
+            modelBuilder
+                .Entity<WithDifferentTable.Customer>(
+                    b =>
+                        {
+                            b.ToTable("Customers");
+                            b.OwnsOne(
+                                e => e.Address,
+                                b => b.ToTable("CustomerAddresses"));
+                        });
+            #endregion
+
+            modelBuilder.Entity<PrincipalWithOptionalDependents>(
+                b =>
+                {
+                    b.OwnsOne(e => e.DependentWithOptionalAndRequiredProperties);
+                    b.OwnsOne(e => e.DependentWithOnlyOptionalProperties);
+                    b.OwnsOne(e => e.DependentWithOnlyRequiredProperties);
+                });
+
+            modelBuilder.Entity<PrincipalWithRequiredDependents>(
+                b =>
+                {
+                    b.OwnsOne(e => e.DependentWithOptionalAndRequiredProperties);
+                    b.Navigation(e => e.DependentWithOptionalAndRequiredProperties).IsRequired();
+                    b.OwnsOne(e => e.DependentWithOnlyOptionalProperties);
+                    b.Navigation(e => e.DependentWithOnlyOptionalProperties).IsRequired();
+                    b.OwnsOne(e => e.DependentWithOnlyRequiredProperties);
+                    b.Navigation(e => e.DependentWithOnlyRequiredProperties).IsRequired();
+                });
+
+            modelBuilder.Entity<PrincipalWithNestedOptionalDependents>(
+                b =>
+                {
+                    b.OwnsOne(e => e.DependentWithOptionalNestedDependents, b =>
+                    {
+                        b.OwnsOne(e => e.Nested);
+                    });
+                });
+
+            modelBuilder.Entity<PrincipalWithNestedRequiredDependents>(
+                b =>
+                {
+                    b.OwnsOne(e => e.DependentWithRequiredNestedDependents, b =>
+                    {
+                        b.OwnsOne(e => e.Nested);
+                        b.Navigation(e => e.Nested).IsRequired();
+                    });
+                    b.Navigation(e => e.DependentWithRequiredNestedDependents).IsRequired();
+                });
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, LogLevel.Warning);
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/PreConventionModelConfigurationSample.cs b/samples/core/Miscellaneous/NewInEFCore6/PreConventionModelConfigurationSample.cs
new file mode 100644
index 0000000000..20bde36622
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/PreConventionModelConfigurationSample.cs
@@ -0,0 +1,225 @@
+using System;
+using System.Collections.Generic;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+public static class PreConventionModelConfigurationSample
+{
+    public static async Task Configure_property_types_and_value_converter_in_one_place()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Configure_property_types_and_value_converter_in_one_place)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new CustomersContext();
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using var context = new CustomersContext(quiet: true);
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        public static async Task PopulateDatabase()
+        {
+            using var context = new CustomersContext(quiet: true);
+
+            context.AddRange(
+                new Customer
+                {
+                    Name = "Arthur",
+                    IsActive = true,
+                    AccountValue = new Money(1090.0m, Currency.PoundsSterling),
+                    Orders =
+                    {
+                        new()
+                        {
+                            OrderDate = new DateTime(2021, 7, 31),
+                            Price = new Money(29.0m, Currency.PoundsSterling),
+                            Discount = new Money(5.0m, Currency.PoundsSterling)
+                        }
+                    }
+                },
+                new Customer
+                {
+                    Name = "Alan",
+                    AccountValue = new Money(0.0m, Currency.UsDollars),
+                    Orders =
+                    {
+                        new()
+                        {
+                            OrderDate = new DateTime(2021, 7, 21),
+                            Price = new Money(2.99m, Currency.UsDollars)
+                        }
+                    }
+                },
+                new Customer
+                {
+                    Name = "Andrew",
+                });
+
+            await context.SaveChangesAsync();
+        }
+    }
+
+    #region EntityTypes
+    public class Customer
+    {
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public bool IsActive { get; set; }
+        public Money AccountValue { get; set; }
+
+        public Session CurrentSession { get; set; }
+
+        public ICollection<Order> Orders { get; } = new List<Order>();
+    }
+
+    public class Order
+    {
+        public int Id { get; set; }
+        public string SpecialInstructions { get; set; }
+        public DateTime OrderDate { get; set; }
+        public bool IsComplete { get; set; }
+        public Money Price { get; set; }
+        public Money? Discount { get; set; }
+
+        public Customer Customer { get; set; }
+    }
+    #endregion
+
+    #region MoneyType
+    public readonly struct Money
+    {
+        [JsonConstructor]
+        public Money(decimal amount, Currency currency)
+        {
+            Amount = amount;
+            Currency = currency;
+        }
+
+        public override string ToString()
+            => (Currency == Currency.UsDollars ? "$" : "£") + Amount;
+
+        public decimal Amount { get; }
+        public Currency Currency { get; }
+    }
+
+    public enum Currency
+    {
+        UsDollars,
+        PoundsSterling
+    }
+    #endregion
+
+    public class Session
+    {
+        public string SessionData { get; set; }
+        public string SessionCookies { get; set; }
+    }
+
+    public class CustomersContext : DbContext
+    {
+        public DbSet<Customer> Customers { get; set; }
+
+        private readonly bool _quiet;
+
+        public CustomersContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            //if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+
+        protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+        {
+            #region BoolConversion
+            configurationBuilder
+                .Properties<bool>()
+                .HaveConversion<BoolToZeroOneConverter<int>>();
+            #endregion
+
+            #region MoneyConversion
+            configurationBuilder
+                .Properties<Money>()
+                .HaveConversion<MoneyConverter>()
+                .HaveMaxLength(64);
+            #endregion
+
+            // See #25416
+            configurationBuilder
+                .Properties<Money?>()
+                .HaveConversion<MoneyConverter>()
+                .HaveMaxLength(64);
+
+            #region DateTimeConversion
+            configurationBuilder
+                .Properties<DateTime>()
+                .HaveConversion<long>();
+            #endregion
+
+            #region StringFacets
+            configurationBuilder
+                .Properties<string>()
+                .AreUnicode(false)
+                .HaveMaxLength(1024);
+            #endregion
+
+            #region IgnoreSession
+            configurationBuilder
+                .IgnoreAny<Session>();
+            #endregion
+
+            #region DefaultTypeMapping
+            configurationBuilder
+                .DefaultTypeMapping<string>()
+                .IsUnicode(false);
+            #endregion
+        }
+    }
+
+    #region MoneyConverter
+    public class MoneyConverter : ValueConverter<Money, string>
+    {
+        public MoneyConverter()
+            : base(
+                v => JsonSerializer.Serialize(v, (JsonSerializerOptions)null),
+                v => JsonSerializer.Deserialize<Money>(v, (JsonSerializerOptions)null))
+        {
+        }
+    }
+    #endregion
+
+    #region WhereItGoes
+    public class SomeDbContext : DbContext
+    {
+        protected override void ConfigureConventions(
+            ModelConfigurationBuilder configurationBuilder)
+        {
+            // Pre-convention model configuration goes here
+        }
+    }
+    #endregion
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/PrecisionAttributeSample.cs b/samples/core/Miscellaneous/NewInEFCore6/PrecisionAttributeSample.cs
new file mode 100644
index 0000000000..e33b510d39
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/PrecisionAttributeSample.cs
@@ -0,0 +1,77 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class PrecisionAttributeSample
+{
+    public static async Task Using_PrecisionAttribute()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Using_PrecisionAttribute)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BooksContext();
+
+        _ = await context.Products.SingleAsync(e => e.Id == 1);
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using var context = new BooksContext();
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        public static async Task PopulateDatabase()
+        {
+            using var context = new BooksContext();
+
+            context.Add(new Product { Price = 3.99m });
+
+            await context.SaveChangesAsync();
+        }
+    }
+
+    #region ProductEntityType
+    public class Product
+    {
+        public int Id { get; set; }
+
+        [Precision(precision: 10, scale: 2)]
+        public decimal Price { get; set; }
+    }
+    #endregion
+
+    public class BooksContext : DbContext
+    {
+        public DbSet<Product> Products { get; set; }
+
+        private readonly bool _quiet;
+
+        public BooksContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/Program.cs b/samples/core/Miscellaneous/NewInEFCore6/Program.cs
new file mode 100644
index 0000000000..826dc646c6
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/Program.cs
@@ -0,0 +1,55 @@
+using System.Threading.Tasks;
+
+public class Program
+{
+    public static async Task Main()
+    {
+        await EntityTypeConfigurationAttributeSample.Using_EntityTypeConfigurationAttribute();
+        await UnicodeAttributeSample.Using_UnicodeAttribute();
+        await PrecisionAttributeSample.Using_PrecisionAttribute();
+        await ToStringTranslationSample.Using_ToString_in_queries();
+        await RandomFunctionSample.Call_EF_Functions_Random();
+        await SparseColumnsSample.Use_sparse_columns();
+        await InMemoryRequiredPropertiesSample.Required_properties_validated_with_in_memory_database();
+        await InMemoryRequiredPropertiesSample.Required_property_validation_with_in_memory_database_can_be_disabled();
+        await IsNullOrWhitespaceSample.Translate_IsNullOrWhitespace();
+        await StringConcatSample.Concat_with_multiple_args();
+        await ArrayParametersSample.Array_parameters_are_logged_in_readable_form();
+        await TemporaryValuesSample.Explicit_temporary_values_can_be_stored_in_entity_instance_1();
+        await TemporaryValuesSample.Explicit_temporary_values_can_be_stored_in_entity_instance_2();
+        await TrailingUnderscoresSample.Backing_fields_with_trailing_underscores_are_matched();
+        await OptionalDependentsSample.Optional_dependents_with_a_required_property();
+        await OptionalDependentsSample.Optional_dependents_without_a_required_property();
+        await OptionalDependentsSample.Handling_optional_dependents_sharing_table_with_principal_1();
+        await OptionalDependentsSample.Handling_optional_dependents_sharing_table_with_principal_2();
+        await OptionalDependentsSample.Handling_required_dependents_sharing_table_with_principal();
+        await OptionalDependentsSample.Handling_nested_optional_dependents_sharing_table_with_principal();
+        await OptionalDependentsSample.Handling_nested_required_dependents_sharing_table_with_principal();
+        PublicPooledDbContextFactorySample.Can_create_pooled_DbContext_factory();
+        DbContextFactorySample.Ignore_parameterless_constructor_when_creating_DbContext_from_factory();
+        DbContextFactorySample.AddDbContextFactory_also_registers_scoped_DbContext_instance();
+        await SplitQuerySample.Split_query_for_non_navigation_collections();
+        await SplitQuerySample.Last_column_in_ORDER_BY_removed_when_joining_for_collection();
+        await SubstringTranslationSample.Translate_Substring_with_single_parameter();
+        await BoolToStringTranslationSample.Translate_bool_to_string_on_SQL_Server();
+        await TagWithFileAndLineSample.Queries_can_be_tagged_with_filename_and_line_number();
+        await PreConventionModelConfigurationSample.Configure_property_types_and_value_converter_in_one_place();
+        await MathFTranslationSample.Translate_MathF_methods();
+        await TemporalTablesSample.Use_SQL_Server_temporal_tables();
+        await GroupBySample.Translate_GroupBy_followed_by_FirstOrDefault_over_group();
+        await HasConversionSample.Can_set_value_converter_type_using_generic_method();
+        MinimalApiSample.Add_a_DbContext_and_provider();
+        await ToInMemoryQuerySample.Can_query_keyless_types_from_in_memory_database();
+        await ScaffoldingSample.Reverse_engineer_from_database();
+        await ManyToManyConfigurationSample.Many_to_many_relationships_may_need_less_configuration();
+        await ConvertNullsSample.Value_converters_can_convert_nulls();
+        await ColumnOrderSample.Can_use_ColumnAttribute_to_set_column_order();
+
+        await SqliteSamples.SavepointsApi();
+        await SqliteSamples.ConnectionPooling();
+        await SqliteSamples.DateOnly_and_TimeOnly();
+
+        // Note: this sample requires a full version of SQL Server. It does not work with LocalDb
+        // ContainsFreeTextSample.Contains_with_non_string();
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/PublicPooledDbContextFactorySample.cs b/samples/core/Miscellaneous/NewInEFCore6/PublicPooledDbContextFactorySample.cs
new file mode 100644
index 0000000000..2ffad55c0f
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/PublicPooledDbContextFactorySample.cs
@@ -0,0 +1,49 @@
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+
+public static class PublicPooledDbContextFactorySample
+{
+    public static void Can_create_pooled_DbContext_factory()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Can_create_pooled_DbContext_factory)}");
+        Console.WriteLine();
+
+        #region CreatePool
+        var options = new DbContextOptionsBuilder<SomeDbContext>()
+            .EnableSensitiveDataLogging()
+            .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0")
+            .Options;
+
+        var factory = new PooledDbContextFactory<SomeDbContext>(options);
+        #endregion
+
+        #region UsePool
+        for (var i = 0; i < 2; i++)
+        {
+            using var context1 = factory.CreateDbContext();
+            Console.WriteLine($"Created DbContext with ID {context1.ContextId}");
+
+            using var context2 = factory.CreateDbContext();
+            Console.WriteLine($"Created DbContext with ID {context2.ContextId}");
+        }
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public class SomeDbContext : DbContext
+    {
+        public SomeDbContext(DbContextOptions<SomeDbContext> options)
+            : base(options)
+        {
+        }
+
+        public override void Dispose()
+        {
+            base.Dispose();
+
+            Console.WriteLine($"Disposing DbContext with ID {ContextId}");
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/RandomFunctionSample.cs b/samples/core/Miscellaneous/NewInEFCore6/RandomFunctionSample.cs
new file mode 100644
index 0000000000..4716ce75cd
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/RandomFunctionSample.cs
@@ -0,0 +1,91 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class RandomFunctionSample
+{
+    public static async Task Call_EF_Functions_Random()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Call_EF_Functions_Random)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BooksContext();
+
+        #region Query
+        var users = await context.Users.Where(u => u.Popularity == (int)(EF.Functions.Random() * 4.0) + 1).ToListAsync();
+        #endregion
+
+        foreach (var user in users)
+        {
+            Console.WriteLine($"  Found '{user.Username}' with popularity '{user.Popularity}'");
+        }
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using var context = new BooksContext(quiet: true);
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        public static async Task PopulateDatabase()
+        {
+            using var context = new BooksContext(quiet: true);
+
+            context.AddRange(
+                new User { Popularity = 1, Username = "arthur" },
+                new User { Popularity = 2, Username = "wendy" },
+                new User { Popularity = 3, Username = "smokey" },
+                new User { Popularity = 4, Username = "alice" },
+                new User { Popularity = 5, Username = "mac" },
+                new User { Popularity = 1, Username = "baxter" },
+                new User { Popularity = 2, Username = "olive" },
+                new User { Popularity = 3, Username = "toast" });
+
+            await context.SaveChangesAsync();
+        }
+    }
+
+    #region UserEntityType
+    public class User
+    {
+        public int Id { get; set; }
+        public string Username { get; set; }
+        public int Popularity { get; set; }
+    }
+    #endregion
+
+    public class BooksContext : DbContext
+    {
+        public DbSet<User> Users { get; set; }
+
+        private readonly bool _quiet;
+
+        public BooksContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/ScaffoldingSample.cs b/samples/core/Miscellaneous/NewInEFCore6/ScaffoldingSample.cs
new file mode 100644
index 0000000000..58f39d147a
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/ScaffoldingSample.cs
@@ -0,0 +1,135 @@
+using System;
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+#nullable enable
+
+public static class ScaffoldingSample
+{
+    public static async Task Reverse_engineer_from_database()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Reverse_engineer_from_database)}");
+        Console.WriteLine();
+
+        using var context = new BloggingWithNRTsContext();
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    // The code below was scaffolded from an existing database.
+    // To replicate this, run this sample to create the database and then use the command line as documented in the text.
+
+    #region Blog
+    public partial class Blog
+    {
+        public Blog()
+        {
+            Posts = new HashSet<Post>();
+        }
+
+        public int Id { get; set; }
+        public string Name { get; set; } = null!;
+
+        public virtual ICollection<Post> Posts { get; set; }
+    }
+    #endregion
+
+    #region Post
+    public partial class Post
+    {
+        public Post()
+        {
+            Tags = new HashSet<Tag>();
+        }
+
+        public int Id { get; set; }
+        public string Title { get; set; } = null!;
+        public string Contents { get; set; } = null!;
+        public DateTime PostedOn { get; set; }
+        public DateTime? UpdatedOn { get; set; }
+        public int BlogId { get; set; }
+
+        public virtual Blog Blog { get; set; } = null!;
+
+        public virtual ICollection<Tag> Tags { get; set; }
+    }
+    #endregion
+
+    #region Tag
+    public partial class Tag
+    {
+        public Tag()
+        {
+            Posts = new HashSet<Post>();
+        }
+
+        public int Id { get; set; }
+        public string Name { get; set; } = null!;
+        public string? Description { get; set; }
+
+        public virtual ICollection<Post> Posts { get; set; }
+    }
+    #endregion
+
+    public partial class BloggingWithNRTsContext : DbContext
+    {
+        public BloggingWithNRTsContext()
+        {
+        }
+
+        public BloggingWithNRTsContext(DbContextOptions<BloggingWithNRTsContext> options)
+            : base(options)
+        {
+        }
+
+        #region DbSets
+        public virtual DbSet<Blog> Blogs { get; set; } = null!;
+        public virtual DbSet<Post> Posts { get; set; } = null!;
+        public virtual DbSet<Tag> Tags { get; set; } = null!;
+        #endregion
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            if (!optionsBuilder.IsConfigured)
+            {
+// #warning To protect potentially sensitive information in your connection string, you should move it out of source code. You can avoid scaffolding the connection string by using the Name= syntax to read it from configuration - see https://go.microsoft.com/fwlink/?linkid=2131148. For more guidance on storing connection strings, see http://go.microsoft.com/fwlink/?LinkId=723263.
+                optionsBuilder.UseSqlServer("Data Source=(localdb)\\MSSQLLocalDB;Initial Catalog=BloggingWithNRTs");
+            }
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Post>(
+                entity =>
+                    {
+                        entity.HasIndex(e => e.BlogId, "IX_Posts_BlogId");
+
+                        entity.HasOne(d => d.Blog)
+                            .WithMany(p => p.Posts)
+                            .HasForeignKey(d => d.BlogId)
+                            .OnDelete(DeleteBehavior.ClientSetNull);
+
+                        #region ManyToMany
+                        entity.HasMany(d => d.Tags)
+                            .WithMany(p => p.Posts)
+                            .UsingEntity<Dictionary<string, object>>(
+                                "PostTag",
+                                l => l.HasOne<Tag>().WithMany().HasForeignKey("PostsId"),
+                                r => r.HasOne<Post>().WithMany().HasForeignKey("TagsId"),
+                                j =>
+                                    {
+                                        j.HasKey("PostsId", "TagsId");
+                                        j.ToTable("PostTag");
+                                        j.HasIndex(new[] { "TagsId" }, "IX_PostTag_TagsId");
+                                    });
+                        #endregion
+                    });
+
+            OnModelCreatingPartial(modelBuilder);
+        }
+
+        partial void OnModelCreatingPartial(ModelBuilder modelBuilder);
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/SparseColumnsSample.cs b/samples/core/Miscellaneous/NewInEFCore6/SparseColumnsSample.cs
new file mode 100644
index 0000000000..f99bf969c5
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/SparseColumnsSample.cs
@@ -0,0 +1,100 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class SparseColumnsSample
+{
+    public static async Task Use_sparse_columns()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Use_sparse_columns)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BooksContext();
+
+        #region Query
+        _ = await context.Users.ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using var context = new BooksContext();
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        public static async Task PopulateDatabase()
+        {
+            using var context = new BooksContext();
+
+            context.AddRange(
+                new ForumUser { Username = "arthur" },
+                new ForumUser { Username = "wendy" },
+                new ForumUser { Username = "smokey" },
+                new ForumUser { Username = "alice" },
+                new ForumUser { Username = "mac" },
+                new ForumModerator { Username = "baxter", ForumName = "Viral Cats"},
+                new ForumUser { Username = "olive" },
+                new ForumUser { Username = "toast" });
+
+            await context.SaveChangesAsync();
+        }
+    }
+
+    #region UserEntityType
+    public class ForumUser
+    {
+        public int Id { get; set; }
+        public string Username { get; set; }
+    }
+
+    public class ForumModerator : ForumUser
+    {
+        public string ForumName { get; set; }
+    }
+    #endregion
+
+    public class BooksContext : DbContext
+    {
+        public DbSet<ForumUser> Users { get; set; }
+
+        private readonly bool _quiet;
+
+        public BooksContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+
+        #region OnModelCreating
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder
+                .Entity<ForumModerator>()
+                .Property(e => e.ForumName)
+                .IsSparse();
+        }
+        #endregion
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/SplitQuerySample.cs b/samples/core/Miscellaneous/NewInEFCore6/SplitQuerySample.cs
new file mode 100644
index 0000000000..3acf64a32d
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/SplitQuerySample.cs
@@ -0,0 +1,188 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class SplitQuerySample
+{
+    public static async Task Split_query_for_non_navigation_collections()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Split_query_for_non_navigation_collections)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new CustomersContext();
+
+        Console.WriteLine("LINQ query: 'context.Customers.Select(c => new { c, Orders = c.Orders.Where(o => o.Id > 1) })'");
+        Console.WriteLine();
+        Console.WriteLine("Executed as a single query:");
+
+        #region SplitQuery1
+        await context.Customers
+            .Select(
+                c => new
+                {
+                    c,
+                    Orders = c.Orders
+                        .Where(o => o.Id > 1)
+                })
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine("Executed as split queries:");
+        await context.Customers.AsSplitQuery().Select(c => new { c, Orders = c.Orders.Where(o => o.Id > 1) }).ToListAsync();
+
+        Console.WriteLine();
+        Console.WriteLine("LINQ query: 'context.Customers.Select(c => new { c, OrderDates = c.Orders.Where(o => o.Id > 1).Select(o => o.OrderDate) })'");
+        Console.WriteLine();
+        Console.WriteLine("Executed as a single query:");
+
+        #region SplitQuery2
+        await context.Customers
+            .Select(
+                c => new
+                {
+                    c,
+                    OrderDates = c.Orders
+                        .Where(o => o.Id > 1)
+                        .Select(o => o.OrderDate)
+                })
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine("Executed as split queries:");
+        await context.Customers.AsSplitQuery().Select(c => new { c, OrderDates = c.Orders.Where(o => o.Id > 1).Select(o => o.OrderDate) }).ToListAsync();
+
+        Console.WriteLine();
+        Console.WriteLine("LINQ query: 'context.Customers.Select(c => new { c, OrderDates = c.Orders.Where(o => o.Id > 1).Select(o => o.OrderDate).Distinct() })'");
+        Console.WriteLine();
+        Console.WriteLine("Executed as a single query:");
+
+        #region SplitQuery3
+        await context.Customers
+            .Select(
+                c => new
+                {
+                    c,
+                    OrderDates = c.Orders
+                        .Where(o => o.Id > 1)
+                        .Select(o => o.OrderDate)
+                        .Distinct()
+                })
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine("Executed as split queries:");
+        await context.Customers.AsSplitQuery().Select(c => new { c, OrderDates = c.Orders.Where(o => o.Id > 1).Select(o => o.OrderDate).Distinct() }).ToListAsync();
+
+        Console.WriteLine();
+    }
+
+    public static async Task Last_column_in_ORDER_BY_removed_when_joining_for_collection()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Last_column_in_ORDER_BY_removed_when_joining_for_collection)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new CustomersContext();
+
+        #region OrderBy
+        await context.Customers
+            .Select(
+                e => new
+                {
+                    e.Id,
+                    FirstOrder = e.Orders.Where(i => i.Id == 1).ToList()
+                })
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using var context = new CustomersContext(quiet: true);
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        public static async Task PopulateDatabase()
+        {
+            using var context = new CustomersContext(quiet: true);
+
+            context.AddRange(
+                new Customer
+                {
+                    Orders =
+                    {
+                        new()
+                        {
+                            OrderDate = new DateTime(2021, 7, 31)
+                        },
+                        new()
+                        {
+                            OrderDate = new DateTime(2021, 8, 1)
+                        },
+                        new()
+                        {
+                            OrderDate = new DateTime(2021, 8, 2)
+                        }
+                    }
+                });
+
+            await context.SaveChangesAsync();
+        }
+    }
+
+    public class Customer
+    {
+        public int Id { get; set; }
+        public ICollection<Order> Orders { get; } = new List<Order>();
+    }
+
+    public class Order
+    {
+        public int Id { get; set; }
+        public DateTime OrderDate { get; set; }
+
+        public int CustomerId { get; set; }
+        public Customer Customer { get; set; }
+    }
+
+    public class CustomersContext : DbContext
+    {
+        public DbSet<Customer> Customers { get; set; }
+
+        private readonly bool _quiet;
+
+        public CustomersContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/SqliteSamples.cs b/samples/core/Miscellaneous/NewInEFCore6/SqliteSamples.cs
new file mode 100644
index 0000000000..cf37803dea
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/SqliteSamples.cs
@@ -0,0 +1,226 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.Data.Sqlite;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class SqliteSamples
+{
+    public static async Task SavepointsApi()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(SavepointsApi)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        Console.WriteLine("Before update:");
+
+        using (var context = new UsersContext())
+        {
+            await foreach (var user in context.Users.AsAsyncEnumerable())
+            {
+                Console.WriteLine($"  Found '{user.Username}'");
+            }
+        }
+
+        await PerformUpdates();
+
+        Console.WriteLine();
+        Console.WriteLine("After update:");
+
+        using (var context = new UsersContext())
+        {
+            await foreach (var user in context.Users.AsAsyncEnumerable())
+            {
+                Console.WriteLine($"  Found '{user.Username}'");
+            }
+        }
+    }
+
+    public static async Task DateOnly_and_TimeOnly()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(DateOnly_and_TimeOnly)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new UsersContext();
+
+        #region DateOnlyQuery
+        var users = await context.Users.Where(u => u.Birthday < new DateOnly(1900, 1, 1)).ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+
+        foreach (var user in users)
+        {
+            Console.WriteLine($"  Found '{user.Username}'");
+            user.Birthday = new(user.Birthday.Year + 100, user.Birthday.Month, user.Birthday.Day);
+        }
+
+        Console.WriteLine();
+
+        await context.SaveChangesAsync();
+    }
+
+    private static async Task PerformUpdates()
+    {
+        #region PerformUpdates
+        using var connection = new SqliteConnection("Command Timeout=60;DataSource=test.db");
+        await connection.OpenAsync();
+
+        await using var transaction = await connection.BeginTransactionAsync();
+
+        using (var command = connection.CreateCommand())
+        {
+            command.CommandText = @"UPDATE Users SET Username = 'ajcvickers' WHERE Id = 1";
+            await command.ExecuteNonQueryAsync();
+        }
+
+        await transaction.SaveAsync("MySavepoint");
+
+        using (var command = connection.CreateCommand())
+        {
+            command.CommandText = @"UPDATE Users SET Username = 'wfvickers' WHERE Id = 2";
+            await command.ExecuteNonQueryAsync();
+        }
+
+        await transaction.RollbackAsync("MySavepoint");
+
+        await transaction.CommitAsync();
+        #endregion
+    }
+
+    public static async Task ConnectionPooling()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(ConnectionPooling)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using (var context = new UsersContext(quiet: false, connectionEvents: true))
+        {
+            #region ConnectionExample
+            Console.WriteLine("Starting query...");
+            Console.WriteLine();
+
+            var users = await context.Users.ToListAsync();
+
+            Console.WriteLine();
+            Console.WriteLine("Query finished.");
+            Console.WriteLine();
+
+            foreach (var user in users)
+            {
+                if (user.Username.Contains("microsoft"))
+                {
+                    user.Username = "msft:" + user.Username;
+
+                    Console.WriteLine("Starting SaveChanges...");
+                    Console.WriteLine();
+
+                    await context.SaveChangesAsync();
+
+                    Console.WriteLine();
+                    Console.WriteLine("SaveChanges finished.");
+                }
+            }
+            #endregion
+        }
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using var context = new UsersContext(quiet: true);
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        public static async Task PopulateDatabase()
+        {
+            using var context = new UsersContext(quiet: true);
+
+            context.AddRange(
+                new User
+                {
+                    Username = "arthur",
+                    Birthday = new(1869, 9, 3),
+                    TokensRenewed = new(16, 30)
+                },
+                new User
+                {
+                    Username = "wendy",
+                    Birthday = new(1873, 8, 3),
+                    TokensRenewed = new(9, 25)
+                },
+                new User
+                {
+                    Username = "microsoft",
+                    Birthday = new(1975, 4, 4),
+                    TokensRenewed = new(0, 0)
+                });
+
+            await context.SaveChangesAsync();
+
+            context.ChangeTracker.Entries<User>().First().Entity.Username = "ajcvickers";
+            await context.SaveChangesAsync();
+        }
+    }
+
+    #region UserEntityType
+    public class User
+    {
+        public int Id { get; set; }
+        public string Username { get; set; }
+
+        public DateOnly Birthday { get; set; }
+        public TimeOnly TokensRenewed { get; set; }
+    }
+    #endregion
+
+    public class UsersContext : DbContext
+    {
+        public DbSet<User> Users { get; set; }
+
+        private readonly bool _quiet;
+        private readonly bool _connectionEvents;
+
+        public UsersContext(
+            bool quiet = false,
+            bool connectionEvents = false)
+        {
+            _quiet = quiet;
+            _connectionEvents = connectionEvents;
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlite("Command Timeout=60;DataSource=test.db");
+
+            if (!_quiet)
+            {
+                if (_connectionEvents)
+                {
+                    optionsBuilder.LogTo(
+                        Console.WriteLine,
+                        new[] { RelationalEventId.ConnectionOpened, RelationalEventId.ConnectionClosed });
+                }
+                else
+                {
+                    optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+                }
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/StringConcatSample.cs b/samples/core/Miscellaneous/NewInEFCore6/StringConcatSample.cs
new file mode 100644
index 0000000000..aef1a414cb
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/StringConcatSample.cs
@@ -0,0 +1,128 @@
+using System;
+using System.ComponentModel.DataAnnotations;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class StringConcatSample
+{
+    public static async Task Concat_with_multiple_args()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Concat_with_multiple_args)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BooksContext();
+
+        #region StringConcat
+        var shards = await context.Shards
+            .Where(e => string.Concat(e.Token1, e.Token2, e.Token3) != e.TokensProcessed).ToListAsync();
+        #endregion
+
+        foreach (var shard in shards)
+        {
+            Console.WriteLine($"Found shard {shard.Id} with unprocessed tokens.");
+        }
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using var context = new BooksContext(quiet: true);
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        public static async Task PopulateDatabase()
+        {
+            using var context = new BooksContext(quiet: true);
+
+            context.AddRange(
+                new Shard
+                {
+                    Token1 = "A",
+                    Token2 = "B",
+                    Token3 = "C",
+                    TokensProcessed = "ABC"
+                },
+                new Shard
+                {
+                    Token1 = "D",
+                    Token2 = "H",
+                    Token3 = "C",
+                    TokensProcessed = "DH"
+                },
+                new Shard
+                {
+                    Token1 = "A",
+                    Token2 = "B",
+                    Token3 = "C"
+                },
+                new Shard
+                {
+                    Token1 = "D",
+                    Token2 = "E",
+                    Token3 = "F",
+                    TokensProcessed = "DEF"
+                },
+                new Shard
+                {
+                    Token1 = "J",
+                    Token2 = "A",
+                    Token3 = "M",
+                    TokensProcessed = "JAM"
+                });
+
+            await context.SaveChangesAsync();
+        }
+    }
+
+    #region ProductEntityType
+    public class Shard
+    {
+        public int Id { get; set; }
+
+        [Required]
+        public string Token1 { get; set; }
+
+        [Required]
+        public string Token2 { get; set; }
+
+        [Required]
+        public string Token3 { get; set; }
+
+        public string TokensProcessed { get; set; }
+    }
+    #endregion
+
+    public class BooksContext : DbContext
+    {
+        public DbSet<Shard> Shards { get; set; }
+
+        private readonly bool _quiet;
+
+        public BooksContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/SubstringTranslationSample.cs b/samples/core/Miscellaneous/NewInEFCore6/SubstringTranslationSample.cs
new file mode 100644
index 0000000000..b8aadeb298
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/SubstringTranslationSample.cs
@@ -0,0 +1,91 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class SubstringTranslationSample
+{
+    public static async Task Translate_Substring_with_single_parameter()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Translate_Substring_with_single_parameter)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new CustomersContext();
+
+        #region Substring
+        var result = await context.Customers
+            .Select(a => new { Name = a.Name.Substring(3) })
+            .FirstOrDefaultAsync(a => a.Name == "hur");
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine($"Found {result.Name}.");
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using var context = new CustomersContext(quiet: true);
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        public static async Task PopulateDatabase()
+        {
+            using var context = new CustomersContext(quiet: true);
+
+            context.AddRange(
+                new Customer
+                {
+                    Name = "Arthur"
+                },
+                new Customer
+                {
+                    Name = "Alan"
+                },
+                new Customer
+                {
+                    Name = "Andrew"
+                });
+
+            await context.SaveChangesAsync();
+        }
+    }
+
+    public class Customer
+    {
+        public int Id { get; set; }
+        public string Name { get; set; }
+    }
+
+    public class CustomersContext : DbContext
+    {
+        public DbSet<Customer> Customers { get; set; }
+
+        private readonly bool _quiet;
+
+        public CustomersContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/TagWithFileAndLineSample.cs b/samples/core/Miscellaneous/NewInEFCore6/TagWithFileAndLineSample.cs
new file mode 100644
index 0000000000..4ea6644323
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/TagWithFileAndLineSample.cs
@@ -0,0 +1,100 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class TagWithFileAndLineSample
+{
+    public static async Task Queries_can_be_tagged_with_filename_and_line_number()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Queries_can_be_tagged_with_filename_and_line_number)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new CustomersContext();
+
+        #region TagWithCallSite
+        var results1 = await context
+            .Customers
+            .TagWithCallSite()
+            .Where(c => c.Name.StartsWith("A"))
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+
+        var results2 = await context
+            .Customers
+            .OrderBy(c => c.Name)
+            .TagWith("Ordering query")
+            .TagWithCallSite()
+            .ToListAsync();
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using var context = new CustomersContext(quiet: true);
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        public static async Task PopulateDatabase()
+        {
+            using var context = new CustomersContext(quiet: true);
+
+            context.AddRange(
+                new Customer
+                {
+                    Name = "Arthur",
+                },
+                new Customer
+                {
+                    Name = "Alan",
+                },
+                new Customer
+                {
+                    Name = "Andrew",
+                });
+
+            await context.SaveChangesAsync();
+        }
+    }
+
+    public class Customer
+    {
+        public int Id { get; set; }
+        public string Name { get; set; }
+    }
+
+    public class CustomersContext : DbContext
+    {
+        public DbSet<Customer> Customers { get; set; }
+
+        private readonly bool _quiet;
+
+        public CustomersContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/TemporalTablesSample.cs b/samples/core/Miscellaneous/NewInEFCore6/TemporalTablesSample.cs
new file mode 100644
index 0000000000..fcaf5f9362
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/TemporalTablesSample.cs
@@ -0,0 +1,336 @@
+using System;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class TemporalTablesSample
+{
+    public static async Task Use_SQL_Server_temporal_tables()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Use_SQL_Server_temporal_tables)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        DateTime timeStamp1;
+        DateTime timeStamp2;
+        DateTime timeStamp3;
+        DateTime timeStamp4;
+
+        using (var context = new EmployeeContext(quiet: true))
+        {
+            #region InsertData
+            context.AddRange(
+                new Employee
+                {
+                    Name = "Pinky Pie",
+                    Address = "Sugarcube Corner, Ponyville, Equestria",
+                    Department = "DevDiv",
+                    Position = "Party Organizer",
+                    AnnualSalary = 100.0m
+                },
+                new Employee
+                {
+                    Name = "Rainbow Dash",
+                    Address = "Cloudominium, Ponyville, Equestria",
+                    Department = "DevDiv",
+                    Position = "Ponyville weather patrol",
+                    AnnualSalary = 900.0m
+                },
+                new Employee
+                {
+                    Name = "Fluttershy",
+                    Address = "Everfree Forest, Equestria",
+                    Department = "DevDiv",
+                    Position = "Animal caretaker",
+                    AnnualSalary = 30.0m
+                });
+
+            await context.SaveChangesAsync();
+            #endregion
+        }
+
+        using (var context = new EmployeeContext(quiet: true))
+        {
+            Console.WriteLine();
+            Console.WriteLine("Starting data:");
+
+            var employees = await context.Employees.ToListAsync();
+            foreach (var employee in employees)
+            {
+                var employeeEntry = context.Entry(employee);
+                var validFrom = employeeEntry.Property<DateTime>("ValidFrom").CurrentValue;
+                var validTo = employeeEntry.Property<DateTime>("ValidTo").CurrentValue;
+
+                Console.WriteLine($"  Employee {employee.Name} valid from {validFrom} to {validTo}");
+            }
+        }
+
+        using (var context = new EmployeeContext(quiet: true))
+        {
+            // Change the sleep values to emphasize the temporal nature of the data.
+            const int millisecondsDelay = 100;
+
+            Thread.Sleep(millisecondsDelay);
+            timeStamp1 = DateTime.UtcNow;
+            Thread.Sleep(millisecondsDelay);
+
+            var employee = await context.Employees.SingleAsync(e => e.Name == "Rainbow Dash");
+            employee.Position = "Wonderbolt Trainee";
+            await context.SaveChangesAsync();
+
+            Thread.Sleep(millisecondsDelay);
+            timeStamp2 = DateTime.UtcNow;
+            Thread.Sleep(millisecondsDelay);
+
+            employee.Position = "Wonderbolt Reservist";
+            await context.SaveChangesAsync();
+
+            Thread.Sleep(millisecondsDelay);
+            timeStamp3 = DateTime.UtcNow;
+            Thread.Sleep(millisecondsDelay);
+
+            employee.Position = "Wonderbolt";
+            await context.SaveChangesAsync();
+
+            Thread.Sleep(millisecondsDelay);
+            timeStamp4 = DateTime.UtcNow;
+            Thread.Sleep(millisecondsDelay);
+        }
+
+        using (var context = new EmployeeContext(quiet: true))
+        {
+            #region NormalQuery
+            var employee = await context.Employees.SingleAsync(e => e.Name == "Rainbow Dash");
+            context.Remove(employee);
+            await context.SaveChangesAsync();
+            #endregion
+        }
+
+        using (var context = new EmployeeContext(quiet: true))
+        {
+            Console.WriteLine();
+            Console.WriteLine("After updates and delete:");
+
+            #region TrackingQuery
+            var employees = await context.Employees.ToListAsync();
+            foreach (var employee in employees)
+            {
+                var employeeEntry = context.Entry(employee);
+                var validFrom = employeeEntry.Property<DateTime>("ValidFrom").CurrentValue;
+                var validTo = employeeEntry.Property<DateTime>("ValidTo").CurrentValue;
+
+                Console.WriteLine($"  Employee {employee.Name} valid from {validFrom} to {validTo}");
+            }
+            #endregion
+
+            Console.WriteLine();
+            Console.WriteLine("Historical data for Rainbow Dash:");
+
+            #region TemporalAll
+            var history = await context
+                .Employees
+                .TemporalAll()
+                .Where(e => e.Name == "Rainbow Dash")
+                .OrderBy(e => EF.Property<DateTime>(e, "ValidFrom"))
+                .Select(
+                    e => new
+                    {
+                        Employee = e,
+                        ValidFrom = EF.Property<DateTime>(e, "ValidFrom"),
+                        ValidTo = EF.Property<DateTime>(e, "ValidTo")
+                    })
+                .ToListAsync();
+
+            foreach (var pointInTime in history)
+            {
+                Console.WriteLine(
+                    $"  Employee {pointInTime.Employee.Name} was '{pointInTime.Employee.Position}' from {pointInTime.ValidFrom} to {pointInTime.ValidTo}");
+            }
+            #endregion
+        }
+
+        using (var context = new EmployeeContext(quiet: true))
+        {
+            Console.WriteLine();
+            Console.WriteLine($"Historical data for Rainbow Dash between {timeStamp2} and {timeStamp3}:");
+
+            #region TemporalBetween
+            var history = await context
+                .Employees
+                .TemporalBetween(timeStamp2, timeStamp3)
+                .Where(e => e.Name == "Rainbow Dash")
+                .OrderBy(e => EF.Property<DateTime>(e, "ValidFrom"))
+                .Select(
+                    e => new
+                    {
+                        Employee = e,
+                        ValidFrom = EF.Property<DateTime>(e, "ValidFrom"),
+                        ValidTo = EF.Property<DateTime>(e, "ValidTo")
+                    })
+                .ToListAsync();
+            #endregion
+
+            foreach (var pointInTime in history)
+            {
+                Console.WriteLine(
+                    $"  Employee {pointInTime.Employee.Name} was '{pointInTime.Employee.Position}' from {pointInTime.ValidFrom} to {pointInTime.ValidTo}");
+            }
+        }
+
+        using (var context = new EmployeeContext(quiet: true))
+        {
+            Console.WriteLine();
+            Console.WriteLine($"Historical data for Rainbow Dash as of {timeStamp2}:");
+
+            var history = await context
+                .Employees
+                .TemporalAsOf(timeStamp2)
+                .Where(e => e.Name == "Rainbow Dash")
+                .OrderBy(e => EF.Property<DateTime>(e, "ValidFrom"))
+                .Select(
+                    e => new
+                    {
+                        Employee = e,
+                        ValidFrom = EF.Property<DateTime>(e, "ValidFrom"),
+                        ValidTo = EF.Property<DateTime>(e, "ValidTo")
+                    })
+                .ToListAsync();
+
+            foreach (var pointInTime in history)
+            {
+                Console.WriteLine(
+                    $"  Employee {pointInTime.Employee.Name} was '{pointInTime.Employee.Position}' from {pointInTime.ValidFrom} to {pointInTime.ValidTo}");
+            }
+        }
+
+        using (var context = new EmployeeContext(quiet: true))
+        {
+            Console.WriteLine();
+            Console.WriteLine($"Restoring Rainbow Dash from {timeStamp2}...");
+
+            #region RestoreData
+            var employee = await context
+                .Employees
+                .TemporalAsOf(timeStamp2)
+                .SingleAsync(e => e.Name == "Rainbow Dash");
+
+            context.Add(employee);
+            await context.SaveChangesAsync();
+            #endregion
+
+            Console.WriteLine();
+            Console.WriteLine($"Historical data for Rainbow Dash between:");
+
+            var history = await context
+                .Employees
+                .TemporalAll()
+                .Where(e => e.Name == "Rainbow Dash")
+                .OrderBy(e => EF.Property<DateTime>(e, "ValidFrom"))
+                .Select(
+                    e => new
+                    {
+                        Employee = e,
+                        ValidFrom = EF.Property<DateTime>(e, "ValidFrom"),
+                        ValidTo = EF.Property<DateTime>(e, "ValidTo")
+                    })
+                .ToListAsync();
+
+            foreach (var pointInTime in history)
+            {
+                Console.WriteLine(
+                    $"  Employee {pointInTime.Employee.Name} was '{pointInTime.Employee.Position}' from {pointInTime.ValidFrom} to {pointInTime.ValidTo}");
+            }
+        }
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using (var context = new EmployeeContext(quiet: true))
+            {
+                await context.Database.EnsureDeletedAsync();
+            }
+
+            using (var context = new EmployeeContext())
+            {
+                await context.Database.EnsureCreatedAsync();
+            }
+        }
+    }
+
+    #region Employee
+    public class Employee
+    {
+        public Guid EmployeeId { get; set; }
+        public string Name { get; set; }
+        public string Position { get; set; }
+        public string Department { get; set; }
+        public string Address { get; set; }
+        public decimal AnnualSalary { get; set; }
+    }
+    #endregion
+
+    public class EmployeeContext : DbContext
+    {
+        public DbSet<Employee> Employees { get; set; }
+
+        private readonly bool _quiet;
+
+        public EmployeeContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region SimpleConfig
+            modelBuilder
+                .Entity<Employee>()
+                .ToTable("Employees", b => b.IsTemporal());
+            #endregion
+
+            #region AdvancedConfig
+            modelBuilder
+                .Entity<Employee>()
+                .ToTable(
+                    "Employees",
+                    b => b.IsTemporal(
+                        b =>
+                        {
+                            b.HasPeriodStart("ValidFrom");
+                            b.HasPeriodEnd("ValidTo");
+                            b.UseHistoryTable("EmployeeHistoricalData");
+                        }));
+            #endregion
+
+            modelBuilder
+                .Entity<Employee>(
+                    b =>
+                    {
+                        b.Property(e => e.Name).HasMaxLength(100);
+                        b.Property(e => e.Position).HasMaxLength(100);
+                        b.Property(e => e.Department).HasMaxLength(100);
+                        b.Property(e => e.Address).HasMaxLength(1024);
+                        b.Property(e => e.AnnualSalary).HasPrecision(10, 2);
+                    });
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/TemporaryValuesSample.cs b/samples/core/Miscellaneous/NewInEFCore6/TemporaryValuesSample.cs
new file mode 100644
index 0000000000..d64e42180d
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/TemporaryValuesSample.cs
@@ -0,0 +1,152 @@
+using System;
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+public static class TemporaryValuesSample
+{
+    public static async Task Explicit_temporary_values_can_be_stored_in_entity_instance_1()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Explicit_temporary_values_can_be_stored_in_entity_instance_1)}");
+        Console.WriteLine(">>>> Shows using explicit temporary values with FK values to relate posts to a blog.");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        using var context = new SomeDbContext();
+
+        #region MarkTemporary
+        var blog = new Blog { Id = -1 };
+        var post1 = new Post { Id = -1, BlogId = -1 };
+        var post2 = new Post { Id = -2, BlogId = -1 };
+
+        context.Add(blog).Property(e => e.Id).IsTemporary = true;
+        context.Add(post1).Property(e => e.Id).IsTemporary = true;
+        context.Add(post2).Property(e => e.Id).IsTemporary = true;
+
+        Console.WriteLine($"Blog has explicit temporary ID = {blog.Id}");
+        Console.WriteLine($"Post 1 has explicit temporary ID = {post1.Id} and FK to Blog = {post1.BlogId}");
+        Console.WriteLine($"Post 2 has explicit temporary ID = {post2.Id} and FK to Blog = {post2.BlogId}");
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine("SavingChanges...");
+        await context.SaveChangesAsync();
+        Console.WriteLine();
+
+        Console.WriteLine($"Blog has ID = {blog.Id}");
+        Console.WriteLine($"Post 1 has ID = {post1.Id} and FK to Blog = {post1.BlogId}");
+        Console.WriteLine($"Post 2 has ID = {post2.Id} and FK to Blog = {post2.BlogId}");
+
+        Console.WriteLine();
+    }
+
+    public static async Task Explicit_temporary_values_can_be_stored_in_entity_instance_2()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Explicit_temporary_values_can_be_stored_in_entity_instance_2)}");
+        Console.WriteLine(">>>> Shows taking generated temporary values and setting them into entity instances.");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        using var context = new SomeDbContext();
+
+        #region AddBlog
+        var blog = new Blog();
+        context.Add(blog);
+        #endregion
+
+        #region ShowValues
+        Console.WriteLine($"Blog.Id value on entity instance = {blog.Id}");
+        Console.WriteLine($"Blog.Id value tracked by EF = {context.Entry(blog).Property(e => e.Id).CurrentValue}");
+        #endregion
+
+        Console.WriteLine();
+
+        #region ExplicitManipulation
+        var post1 = new Post();
+        var post2 = new Post();
+
+        var blogIdEntry = context.Entry(blog).Property(e => e.Id);
+        blog.Id = blogIdEntry.CurrentValue;
+        blogIdEntry.IsTemporary = true;
+
+        var post1IdEntry = context.Add(post1).Property(e => e.Id);
+        post1.Id = post1IdEntry.CurrentValue;
+        post1IdEntry.IsTemporary = true;
+        post1.BlogId = blog.Id;
+
+        var post2IdEntry = context.Add(post2).Property(e => e.Id);
+        post2.Id = post2IdEntry.CurrentValue;
+        post2IdEntry.IsTemporary = true;
+        post2.BlogId = blog.Id;
+
+        Console.WriteLine($"Blog has generated temporary ID = {blog.Id}");
+        Console.WriteLine($"Post 1 has generated temporary ID = {post1.Id} and FK to Blog = {post1.BlogId}");
+        Console.WriteLine($"Post 2 has generated temporary ID = {post2.Id} and FK to Blog = {post2.BlogId}");
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine("SavingChanges...");
+        await context.SaveChangesAsync();
+        Console.WriteLine();
+
+        Console.WriteLine($"Blog has ID = {blog.Id}");
+        Console.WriteLine($"Post 1 has ID = {post1.Id} and FK to Blog = {post1.BlogId}");
+        Console.WriteLine($"Post 2 has ID = {post2.Id} and FK to Blog = {post2.BlogId}");
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using var context = new SomeDbContext(quiet: true);
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+    }
+
+    #region Blog
+    public class Blog
+    {
+        public int Id { get; set; }
+
+        public ICollection<Post> Posts { get; } = new List<Post>();
+    }
+    #endregion
+
+    public class Post
+    {
+        public int Id { get; set; }
+
+        public int? BlogId { get; set; }
+        public Blog Blog { get; set; }
+    }
+
+    public class SomeDbContext : DbContext
+    {
+        public DbSet<Blog> Blogs { get; set; }
+
+        private readonly bool _quiet;
+
+        public SomeDbContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            if (!_quiet)
+            {
+                //optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/ToInMemoryQuerySample.cs b/samples/core/Miscellaneous/NewInEFCore6/ToInMemoryQuerySample.cs
new file mode 100644
index 0000000000..83311eff9d
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/ToInMemoryQuerySample.cs
@@ -0,0 +1,178 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+public static class ToInMemoryQuerySample
+{
+    public static async Task Can_query_keyless_types_from_in_memory_database()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Can_query_keyless_types_from_in_memory_database)}");
+        Console.WriteLine();
+
+        await Helpers.PopulateDatabase();
+
+        using var context = new CustomerContext();
+
+        #region Query
+        var results = await context.CustomerDensities.ToListAsync();
+        #endregion
+
+        foreach (var customerDensity in results)
+        {
+            Console.WriteLine($"Postcodes in {customerDensity.Postcode} have {customerDensity.CustomerCount} customers.");
+        }
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task PopulateDatabase()
+        {
+            using var context = new CustomerContext();
+
+            context.AddRange(
+                new Customer
+                {
+                    Name = "Gimick",
+                    Address = new()
+                    {
+                        House = "4c",
+                        Street = "Cable Street",
+                        City = "Ankh",
+                        Postcode = "AN1 5CS",
+                    }
+                },
+                new Customer
+                {
+                    Name = "Extremelia Mume",
+                    Address = new()
+                    {
+                        House = "The Temple of Anoia",
+                        Street = "Cable Street",
+                        City = "Ankh",
+                        Postcode = "AN1 3CS",
+                    }
+                },
+                new Customer
+                {
+                    Name = "Gimlet Gimlet",
+                    Address = new()
+                    {
+                        House = "Gimlet's Hole Food Delicatessen",
+                        Street = "Cable Street",
+                        City = "Ankh",
+                        Postcode = "AN1 9CD",
+                    }
+                },
+                new Customer
+                {
+                    Name = "Agnes Nitt",
+                    Address = new()
+                    {
+                        House = "4",
+                        Street = "Treacle Mine Road",
+                        City = "Morpork",
+                        Postcode = "MK3 1TM",
+                    }
+                },
+                new Customer
+                {
+                    Name = "Kroll Thighbiter",
+                    Address = new()
+                    {
+                        House = "Kroll Thighbiter’s Rat Pie & Chips",
+                        Street = "Treacle Mine Road",
+                        City = "Morpork",
+                        Postcode = "MK3 8RP",
+                    }
+                },
+                new Customer
+                {
+                    Name = "John Keel",
+                    Address = new()
+                    {
+                        House = "Watch House",
+                        Street = "Treacle Mine Road",
+                        City = "Morpork",
+                        Postcode = "MK3 8WH",
+                    }
+                },
+                new Customer
+                {
+                    Name = "Albert Spangler",
+                    Address = new()
+                    {
+                        House = "Post Office",
+                        Street = "Treacle Mine Road",
+                        City = "Morpork",
+                        Postcode = "MK3 2ND",
+                    }
+                });
+            await context.SaveChangesAsync();
+        }
+    }
+
+    #region ViewType
+    public class CustomerDensity
+    {
+        public string Postcode { get; set; }
+        public int CustomerCount { get; set; }
+    }
+    #endregion
+
+    #region EntityTypes
+    public class Customer
+    {
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public Address Address { get; set; }
+    }
+
+    public class Address
+    {
+        public int Id { get; set; }
+        public string House { get; set; }
+        public string Street { get; set; }
+        public string City { get; set; }
+        public string Postcode { get; set; }
+    }
+    #endregion
+
+    public class CustomerContext : DbContext
+    {
+        public DbSet<Customer> Users { get; set; }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseInMemoryDatabase(nameof(CustomerContext));
+        }
+
+        #region ToInMemoryQuery
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder
+                .Entity<CustomerDensity>()
+                .HasNoKey()
+                .ToInMemoryQuery(
+                    () => Customers
+                        .GroupBy(c => c.Address.Postcode.Substring(0, 3))
+                        .Select(
+                            g =>
+                                new CustomerDensity
+                                {
+                                    Postcode = g.Key,
+                                    CustomerCount = g.Count()
+                                }));
+        }
+        #endregion
+
+        #region DbSets
+        public DbSet<Customer> Customers { get; set; }
+        public DbSet<CustomerDensity> CustomerDensities { get; set; }
+        #endregion
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/ToStringTranslationSample.cs b/samples/core/Miscellaneous/NewInEFCore6/ToStringTranslationSample.cs
new file mode 100644
index 0000000000..bdc513cf97
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/ToStringTranslationSample.cs
@@ -0,0 +1,86 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class ToStringTranslationSample
+{
+    public static async Task Using_ToString_in_queries()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Using_ToString_in_queries)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BooksContext();
+
+        #region Query
+        var users = await context.Users.Where(u => EF.Functions.Like(u.PhoneNumber.ToString(), "%555%")).ToListAsync();
+        #endregion
+
+        foreach (var user in users)
+        {
+            Console.WriteLine($"  Found '{user.Username}' with phone number '{user.PhoneNumber}'");
+        }
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using var context = new BooksContext(quiet: true);
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        public static async Task PopulateDatabase()
+        {
+            using var context = new BooksContext(quiet: true);
+
+            context.AddRange(
+                new User { PhoneNumber = 4255551234, Username = "arthur" },
+                new User { PhoneNumber = 5155552234, Username = "wendy" },
+                new User { PhoneNumber = 18005525123, Username = "microsoft" });
+
+            await context.SaveChangesAsync();
+        }
+    }
+
+    #region UserEntityType
+    public class User
+    {
+        public int Id { get; set; }
+        public string Username { get; set; }
+        public long PhoneNumber { get; set; }
+    }
+    #endregion
+
+    public class BooksContext : DbContext
+    {
+        public DbSet<User> Users { get; set; }
+
+        private readonly bool _quiet;
+
+        public BooksContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlite("Command Timeout=60;DataSource=test.db");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/TrailingUnderscoresSample.cs b/samples/core/Miscellaneous/NewInEFCore6/TrailingUnderscoresSample.cs
new file mode 100644
index 0000000000..13f3520cb8
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/TrailingUnderscoresSample.cs
@@ -0,0 +1,86 @@
+using System;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+public static class TrailingUnderscoresSample
+{
+    public static async Task Backing_fields_with_trailing_underscores_are_matched()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Backing_fields_with_trailing_underscores_are_matched)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        using var context = new SomeDbContext();
+
+        var userEntityType = context.Model.FindEntityType(typeof(User));
+
+        var idProperty = userEntityType.FindProperty(nameof(User.Id));
+        Console.WriteLine($"User entity detected backing field '{idProperty.FieldInfo.Name}' for property '{idProperty.Name}'");
+
+        var nameProperty = userEntityType.FindProperty(nameof(User.Name));
+        Console.WriteLine($"User entity detected backing field '{nameProperty.FieldInfo.Name}' for property '{nameProperty.Name}'");
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using var context = new SomeDbContext(quiet: true);
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+    }
+
+    public class User
+    {
+        private readonly int id_;
+        private readonly int name_;
+
+        public User(int id, int name)
+        {
+            id_ = id;
+            name_ = name;
+        }
+
+        public int Id => id_;
+        public int Name => name_;
+    }
+
+    public class SomeDbContext : DbContext
+    {
+        public DbSet<User> Users { get; set; }
+
+        private readonly bool _quiet;
+
+        public SomeDbContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<User>(
+                b =>
+                {
+                    b.Property(e => e.Id);
+                    b.Property(e => e.Name);
+                });
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            if (!_quiet)
+            {
+                //optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore6/UnicodeAttributeSample.cs b/samples/core/Miscellaneous/NewInEFCore6/UnicodeAttributeSample.cs
new file mode 100644
index 0000000000..273ec9c6fe
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore6/UnicodeAttributeSample.cs
@@ -0,0 +1,81 @@
+using System;
+using System.ComponentModel.DataAnnotations;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class UnicodeAttributeSample
+{
+    public static async Task Using_UnicodeAttribute()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Using_UnicodeAttribute)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+        await Helpers.PopulateDatabase();
+
+        using var context = new BooksContext();
+
+        var book = await context.Books.SingleAsync(e => e.Id == 1);
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            using var context = new BooksContext();
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        public static async Task PopulateDatabase()
+        {
+            using var context = new BooksContext();
+
+            context.Add(
+                new Book() { Isbn = "978-0-39-481823-8", Title = "What Do People Do All Day?" });
+
+            await context.SaveChangesAsync();
+        }
+    }
+
+    #region BookEntityType
+    public class Book
+    {
+        public int Id { get; set; }
+        public string Title { get; set; }
+
+        [Unicode(false)]
+        [MaxLength(22)]
+        public string Isbn { get; set; }
+    }
+    #endregion
+
+    public class BooksContext : DbContext
+    {
+        public DbSet<Book> Books { get; set; }
+
+        private readonly bool _quiet;
+
+        public BooksContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFCoreSample;ConnectRetryCount=0");
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted });
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/.config/dotnet-tools.json b/samples/core/Miscellaneous/NewInEFCore7/.config/dotnet-tools.json
new file mode 100644
index 0000000000..c854abd51f
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/.config/dotnet-tools.json
@@ -0,0 +1,12 @@
+{
+  "version": 1,
+  "isRoot": true,
+  "tools": {
+    "dotnet-ef": {
+      "version": "10.0.0",
+      "commands": [
+        "dotnet-ef"
+      ]
+    }
+  }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/BlogsContext.cs b/samples/core/Miscellaneous/NewInEFCore7/BlogsContext.cs
new file mode 100644
index 0000000000..64e04e5a06
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/BlogsContext.cs
@@ -0,0 +1,428 @@
+using System.Net;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+namespace NewInEfCore7;
+
+#region BlogsModel
+public class Blog
+{
+    public Blog(string name)
+    {
+        Name = name;
+    }
+
+    public int Id { get; private set; }
+    public string Name { get; set; }
+    public List<Post> Posts { get; } = new();
+}
+
+public class Post
+{
+    public Post(string title, string content, DateTime publishedOn)
+    {
+        Title = title;
+        Content = content;
+        PublishedOn = publishedOn;
+    }
+
+    public int Id { get; private set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+    public DateTime PublishedOn { get; set; }
+    public Blog Blog { get; set; } = null!;
+    public List<Tag> Tags { get; } = new();
+    public Author? Author { get; set; }
+    public PostMetadata? Metadata { get; set; }
+}
+
+public class FeaturedPost : Post
+{
+    public FeaturedPost(string title, string content, DateTime publishedOn, string promoText)
+        : base(title, content, publishedOn)
+    {
+        PromoText = promoText;
+    }
+
+    public string PromoText { get; set; }
+}
+
+public class Tag
+{
+    public Tag(string id, string text)
+    {
+        Id = id;
+        Text = text;
+    }
+
+    public string Id { get; private set; }
+    public string Text { get; set; }
+    public List<Post> Posts { get; } = new();
+}
+
+public class Author
+{
+    public Author(string name)
+    {
+        Name = name;
+    }
+
+    public int Id { get; private set; }
+    public string Name { get; set; }
+    public ContactDetails Contact { get; set; } = null!;
+    public List<Post> Posts { get; } = new();
+}
+#endregion
+
+#region ContactDetailsAggregate
+public class ContactDetails
+{
+    public Address Address { get; set; } = null!;
+    public string? Phone { get; set; }
+}
+
+public class Address
+{
+    public Address(string street, string city, string postcode, string country)
+    {
+        Street = street;
+        City = city;
+        Postcode = postcode;
+        Country = country;
+    }
+
+    public string Street { get; set; }
+    public string City { get; set; }
+    public string Postcode { get; set; }
+    public string Country { get; set; }
+}
+#endregion
+
+#region PostMetadataAggregate
+public class PostMetadata
+{
+    public PostMetadata(int views)
+    {
+        Views = views;
+    }
+
+    public int Views { get; set; }
+    public List<SearchTerm> TopSearches { get; } = new();
+    public List<Visits> TopGeographies { get; } = new();
+    public List<PostUpdate> Updates { get; } = new();
+}
+
+public class SearchTerm
+{
+    public SearchTerm(string term, int count)
+    {
+        Term = term;
+        Count = count;
+    }
+
+    public string Term { get; private set; }
+    public int Count { get; private set; }
+}
+
+public class Visits
+{
+    public Visits(double latitude, double longitude, int count)
+    {
+        Latitude = latitude;
+        Longitude = longitude;
+        Count = count;
+    }
+
+    public double Latitude { get; private set; }
+    public double Longitude { get; private set; }
+    public int Count { get; private set; }
+    public List<string>? Browsers { get; set; }
+}
+
+public class PostUpdate
+{
+    public PostUpdate(IPAddress postedFrom, DateTime updatedOn)
+    {
+        PostedFrom = postedFrom;
+        UpdatedOn = updatedOn;
+    }
+
+    public IPAddress PostedFrom { get; private set; }
+    public string? UpdatedBy { get; init; }
+    public DateTime UpdatedOn { get; private set; }
+    public List<Commit> Commits { get; } = new();
+}
+
+public class Commit
+{
+    public Commit(DateTime committedOn, string comment)
+    {
+        CommittedOn = committedOn;
+        Comment = comment;
+    }
+
+    public DateTime CommittedOn { get; private set; }
+    public string Comment { get; set; }
+}
+#endregion
+
+public abstract class BlogsContext : DbContext
+{
+    protected BlogsContext(bool useSqlite = false)
+    {
+        UseSqlite = useSqlite;
+    }
+
+    public bool UseSqlite { get; }
+    public bool LoggingEnabled { get; set; }
+    public virtual MappingStrategy MappingStrategy => MappingStrategy.Tph;
+
+    public DbSet<Blog> Blogs => Set<Blog>();
+    public DbSet<Tag> Tags => Set<Tag>();
+    public DbSet<Post> Posts => Set<Post>();
+    public DbSet<Author> Authors => Set<Author>();
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => (UseSqlite
+                ? optionsBuilder.UseSqlite(@$"DataSource={GetType().Name}.db")
+                : optionsBuilder.UseSqlServer(
+                    @$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0",
+                    sqlServerOptionsBuilder => sqlServerOptionsBuilder.UseNetTopologySuite()))
+            .EnableSensitiveDataLogging()
+            .LogTo(
+                s =>
+                {
+                    if (LoggingEnabled)
+                    {
+                        Console.WriteLine(s);
+                    }
+                }, LogLevel.Information);
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<FeaturedPost>();
+    }
+
+    protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+    {
+        configurationBuilder.Properties<List<string>>().HaveConversion<StringListConverter>();
+
+        base.ConfigureConventions(configurationBuilder);
+    }
+
+    private class StringListConverter : ValueConverter<List<string>, string>
+    {
+        public StringListConverter()
+            : base(v => string.Join(", ", v!), v => v.Split(',', StringSplitOptions.TrimEntries).ToList())
+        {
+        }
+    }
+
+    public async Task Seed()
+    {
+        var tagEntityFramework = new Tag("TagEF", "Entity Framework");
+        var tagDotNet = new Tag("TagNet", ".NET");
+        var tagDotNetMaui = new Tag("TagMaui", ".NET MAUI");
+        var tagAspDotNet = new Tag("TagAsp", "ASP.NET");
+        var tagAspDotNetCore = new Tag("TagAspC", "ASP.NET Core");
+        var tagDotNetCore = new Tag("TagC", ".NET Core");
+        var tagHacking = new Tag("TagHx", "Hacking");
+        var tagLinux = new Tag("TagLin", "Linux");
+        var tagSqlite = new Tag("TagLite", "SQLite");
+        var tagVisualStudio = new Tag("TagVS", "Visual Studio");
+        var tagGraphQl = new Tag("TagQL", "GraphQL");
+        var tagCosmosDb = new Tag("TagCos", "CosmosDB");
+        var tagBlazor = new Tag("TagBl", "Blazor");
+
+        var maddy = new Author("Maddy Montaquila")
+        {
+            Contact = new() { Address = new("1 Main St", "Camberwick Green", "CW1 5ZH", "UK"), Phone = "01632 12345" }
+        };
+        var jeremy = new Author("Jeremy Likness")
+        {
+            Contact = new() { Address = new("2 Main St", "Chigley", "CW1 5ZH", "UK"), Phone = "01632 12346" }
+        };
+        var dan = new Author("Daniel Roth")
+        {
+            Contact = new() { Address = new("3 Main St", "Camberwick Green", "CW1 5ZH", "UK"), Phone = "01632 12347" }
+        };
+        var arthur = new Author("Arthur Vickers")
+        {
+            Contact = new() { Address = new("15a Main St", "Chigley", "CW1 5ZH", "UK"), Phone = "01632 12348" }
+        };
+        var brice = new Author("Brice Lambson")
+        {
+            Contact = new() { Address = new("4 Main St", "Chigley", "CW1 5ZH", "UK"), Phone = "01632 12349" }
+        };
+
+        var blogs = new List<Blog>
+        {
+            new(".NET Blog")
+            {
+                Posts =
+                {
+                    new Post(
+                        "Productivity comes to .NET MAUI in Visual Studio 2022",
+                        "Visual Studio 2022 17.3 is now available and...",
+                        new DateTime(2022, 8, 9)) { Tags = { tagDotNetMaui, tagDotNet }, Author = maddy, Metadata = BuildPostMetadata() },
+                    new Post(
+                        "Announcing .NET 7 Preview 7", ".NET 7 Preview 7 is now available with improvements to System.LINQ, Unix...",
+                        new DateTime(2022, 8, 9)) { Tags = { tagDotNet }, Author = jeremy, Metadata = BuildPostMetadata() },
+                    new Post(
+                        "ASP.NET Core updates in .NET 7 Preview 7", ".NET 7 Preview 7 is now available! Check out what's new in...",
+                        new DateTime(2022, 8, 9))
+                    {
+                        Tags = { tagDotNet, tagAspDotNet, tagAspDotNetCore }, Author = dan, Metadata = BuildPostMetadata()
+                    },
+                    new FeaturedPost(
+                        "Announcing Entity Framework 7 Preview 7: Interceptors!",
+                        "Announcing EF7 Preview 7 with new and improved interceptors, and...",
+                        new DateTime(2022, 8, 9),
+                        "Loads of runnable code!")
+                    {
+                        Tags = { tagEntityFramework, tagDotNet, tagDotNetCore }, Author = arthur, Metadata = BuildPostMetadata()
+                    }
+                },
+            },
+            new("1unicorn2")
+            {
+                Posts =
+                {
+                    new Post(
+                        "Hacking my Sixth Form College network in 1991",
+                        "Back in 1991 I was a student at Franklin Sixth Form College...",
+                        new DateTime(2020, 4, 10)) { Tags = { tagHacking }, Author = arthur, Metadata = BuildPostMetadata() },
+                    new FeaturedPost(
+                        "All your versions are belong to us",
+                        "Totally made up conversations about choosing Entity Framework version numbers...",
+                        new DateTime(2020, 3, 26),
+                        "Way funny!") { Tags = { tagEntityFramework }, Author = arthur, Metadata = BuildPostMetadata() },
+                    new Post(
+                        "Moving to Linux", "A few weeks ago, I decided to move from Windows to Linux as...",
+                        new DateTime(2020, 3, 7)) { Tags = { tagLinux }, Author = arthur, Metadata = BuildPostMetadata() },
+                    new Post(
+                        "Welcome to One Unicorn 2.0!", "I created my first blog back in 2011..",
+                        new DateTime(2020, 2, 29)) { Tags = { tagEntityFramework }, Author = arthur, Metadata = BuildPostMetadata() }
+                }
+            },
+            new("Brice's Blog")
+            {
+                Posts =
+                {
+                    new FeaturedPost(
+                        "SQLite in Visual Studio 2022", "A couple of years ago, I was thinking of ways...",
+                        new DateTime(2022, 7, 26), "Love for VS!")
+                    {
+                        Tags = { tagSqlite, tagVisualStudio }, Author = brice, Metadata = BuildPostMetadata()
+                    },
+                    new Post(
+                        "On .NET - Entity Framework Migrations Explained",
+                        "This week, @JamesMontemagno invited me onto the On .NET show...",
+                        new DateTime(2022, 5, 4))
+                    {
+                        Tags = { tagEntityFramework, tagDotNet }, Author = brice, Metadata = BuildPostMetadata()
+                    },
+                    new Post(
+                        "Dear DBA: A silly idea", "We have fun on the Entity Framework team...",
+                        new DateTime(2022, 3, 31)) { Tags = { tagEntityFramework }, Author = brice, Metadata = BuildPostMetadata() },
+                    new Post(
+                        "Microsoft.Data.Sqlite 6", "It’s that time of year again. Microsoft.Data.Sqlite version...",
+                        new DateTime(2021, 11, 8)) { Tags = { tagSqlite, tagDotNet }, Author = brice, Metadata = BuildPostMetadata() }
+                }
+            },
+            new("Developer for Life")
+            {
+                Posts =
+                {
+                    new Post(
+                        "GraphQL for .NET Developers", "A comprehensive overview of GraphQL as...",
+                        new DateTime(2021, 7, 1))
+                    {
+                        Tags = { tagDotNet, tagGraphQl, tagAspDotNetCore }, Author = jeremy, Metadata = BuildPostMetadata()
+                    },
+                    new FeaturedPost(
+                        "Azure Cosmos DB With EF Core on Blazor Server",
+                        "Learn how to build Azure Cosmos DB apps using Entity Framework Core...",
+                        new DateTime(2021, 5, 16),
+                        "Blazor FTW!")
+                    {
+                        Tags =
+                        {
+                            tagDotNet,
+                            tagEntityFramework,
+                            tagAspDotNetCore,
+                            tagCosmosDb,
+                            tagBlazor
+                        },
+                        Author = jeremy,
+                        Metadata = BuildPostMetadata()
+                    },
+                    new Post(
+                        "Multi-tenancy with EF Core in Blazor Server Apps",
+                        "Learn several ways to implement multi-tenant databases in Blazor Server apps...",
+                        new DateTime(2021, 4, 29))
+                    {
+                        Tags = { tagDotNet, tagEntityFramework, tagAspDotNetCore, tagBlazor },
+                        Author = jeremy,
+                        Metadata = BuildPostMetadata()
+                    },
+                    new Post(
+                        "An Easier Blazor Debounce", "Where I propose a simple method to debounce input without...",
+                        new DateTime(2021, 4, 12))
+                    {
+                        Tags = { tagDotNet, tagAspDotNetCore, tagBlazor }, Author = jeremy, Metadata = BuildPostMetadata()
+                    }
+                }
+            }
+        };
+
+        await AddRangeAsync(blogs);
+        await SaveChangesAsync();
+
+        PostMetadata BuildPostMetadata()
+        {
+            var random = new Random(Guid.NewGuid().GetHashCode());
+
+            var metadata = new PostMetadata(random.Next(10000));
+
+            for (var i = 0; i < random.Next(5); i++)
+            {
+                var update = new PostUpdate(IPAddress.Loopback, DateTime.UtcNow - TimeSpan.FromDays(random.Next(1, 10000)))
+                {
+                    UpdatedBy = "Admin"
+                };
+
+                for (var j = 0; j < random.Next(3); j++)
+                {
+                    update.Commits.Add(new(DateTime.Today, $"Commit #{j + 1}"));
+                }
+
+                metadata.Updates.Add(update);
+            }
+
+            for (var i = 0; i < random.Next(5); i++)
+            {
+                metadata.TopSearches.Add(new($"Search #{i + 1}", 10000 - random.Next(i * 1000, i * 1000 + 900)));
+            }
+
+            for (var i = 0; i < random.Next(5); i++)
+            {
+                metadata.TopGeographies.Add(
+                    new(
+                        // Issue https://github.com/dotnet/efcore/issues/28811 (Support spatial types in JSON columns)
+                        // new Point(115.7930 + 20 - random.Next(40), 37.2431 + 10 - random.Next(20)) { SRID = 4326 },
+                        115.7930 + 20 - random.Next(40),
+                        37.2431 + 10 - random.Next(20),
+                        1000 - random.Next(i * 100, i * 100 + 90)) { Browsers = new() { "Firefox", "Netscape" } });
+            }
+
+            return metadata;
+        }
+    }
+}
+
+public enum MappingStrategy
+{
+    Tph,
+    Tpt,
+    Tpc,
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/CosmosQueriesSample.cs b/samples/core/Miscellaneous/NewInEFCore7/CosmosQueriesSample.cs
new file mode 100644
index 0000000000..3580bea3a0
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/CosmosQueriesSample.cs
@@ -0,0 +1,82 @@
+using System.Text.RegularExpressions;
+
+namespace NewInEfCore7;
+
+public static class CosmosQueriesSample
+{
+    public static async Task Cosmos_translations_for_RegEx_Match()
+    {
+        PrintSampleName();
+
+        await using var context = new ShapesContext();
+
+        try
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+        catch (HttpRequestException exception)
+        {
+            Console.WriteLine($"Cosmos emulator not found: '{exception.Message}'");
+            return;
+        }
+
+        await context.AddRangeAsync(
+            new Triangle { Name = "Acute", Angle1 = 75, Angle2 = 85, InsertedOn = DateTime.UtcNow - TimeSpan.FromDays(2) },
+            new Triangle { Name = "Obtuse", Angle1 = 110, Angle2 = 35, InsertedOn = DateTime.UtcNow - TimeSpan.FromDays(1) },
+            new Triangle { Name = "Right", Angle1 = 90, Angle2 = 45, InsertedOn = DateTime.UtcNow },
+            new Triangle { Name = "Isosceles", Angle1 = 75, Angle2 = 75, InsertedOn = DateTime.UtcNow + TimeSpan.FromDays(1) },
+            new Triangle { Name = "Equilateral", Angle1 = 60, Angle2 = 60, InsertedOn = DateTime.UtcNow + TimeSpan.FromDays(2) }
+        );
+
+        await context.SaveChangesAsync();
+        context.ChangeTracker.Clear();
+
+        #region RegexIsMatch
+        var containsInnerT = await context.Triangles
+            .Where(o => Regex.IsMatch(o.Name, "[a-z]t[a-z]", RegexOptions.IgnoreCase))
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var result in containsInnerT)
+        {
+            Console.WriteLine($" {result.Name}");
+        }
+        Console.WriteLine();
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public class Triangle
+    {
+        public Guid Id { get; set; }
+        public string Name { get; set; } = null!;
+        public double Angle1 { get; set; }
+        public double Angle2 { get; set; }
+        public DateTime InsertedOn { get; set; }
+    }
+
+    public class ShapesContext : DbContext
+    {
+        public DbSet<Triangle> Triangles => Set<Triangle>();
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Triangle>().ToContainer("Shapes");
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .UseCosmos(
+                    "https://localhost:8081",
+                    "C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==",
+                    "Queries")
+                .LogTo(Console.WriteLine, LogLevel.Information)
+                .EnableSensitiveDataLogging();
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/DbContextApiSample.cs b/samples/core/Miscellaneous/NewInEFCore7/DbContextApiSample.cs
new file mode 100644
index 0000000000..1a80f563de
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/DbContextApiSample.cs
@@ -0,0 +1,228 @@
+using System.Text.Json;
+using Microsoft.EntityFrameworkCore.ChangeTracking;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+namespace NewInEfCore7;
+
+public static class DbContextApiSample
+{
+    public static async Task Find_siblings()
+    {
+        PrintSampleName();
+
+        await using var context = new BlogsContext();
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+        context.ChangeTracker.Clear();
+
+        var blogs = await context.Blogs.Include(blog => blog.Posts).ToListAsync();
+        var post = blogs.First().Posts.First();
+
+        #region UseFindSiblings
+
+        Console.WriteLine($"Siblings to {post.Id}: '{post.Title}' are...");
+        foreach (var sibling in context.FindSiblings(post, nameof(post.Blog)))
+        {
+            Console.WriteLine($"    {sibling.Id}: '{sibling.Title}'");
+        }
+
+        #endregion
+    }
+
+    public static async Task Get_entry_for_shared_type_entity_type()
+    {
+        PrintSampleName();
+
+        await using (var context = new BlogsContext { LoggingEnabled = true })
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            var builds = new List<Dictionary<string, object>>
+            {
+                new()
+                {
+                    { "Tag", "v6.0.9" },
+                    { "Version", new Version(6, 0, 9) },
+                    { "Prerelease", false },
+                    { "Hash", "33e3c950af2eb996c0b3c48e30eb4471138da675" }
+                },
+                new()
+                {
+                    { "Tag", "v3.1.29" },
+                    { "Version", new Version(3, 1, 29) },
+                    { "Prerelease", false },
+                    { "Hash", "6e3b6bb213c8360c3a1e26f91c66234710535962" }
+                },
+                new()
+                {
+                    { "Tag", "v7.0.0-rc.1.22426.7" },
+                    { "Version", new Version(7, 0, 0) },
+                    { "Prerelease", true },
+                    { "Hash", "dc0f3e8ef10eb1464b27f0fd4704f53c01226036" }
+                }
+            };
+
+            ListBuilds(context, builds);
+
+            await context.BuildMetadata.AddRangeAsync(builds);
+            ListBuilds(context, builds);
+
+            await context.SaveChangesAsync();
+            ListBuilds(context, builds);
+        }
+
+        await using (var context = new BlogsContext { LoggingEnabled = true })
+        {
+            #region BuildMetadataQuery
+            var builds = await context.BuildMetadata
+                .Where(metadata => !EF.Property<bool>(metadata, "Prerelease"))
+                .OrderBy(metadata => EF.Property<string>(metadata, "Tag"))
+                .ToListAsync();
+            #endregion
+
+            ListBuilds(context, builds);
+        }
+
+        void ListBuilds(BlogsContext context, List<Dictionary<string, object>> builds)
+        {
+            Console.WriteLine();
+            Console.WriteLine("Builds:");
+
+            foreach (var build in builds)
+            {
+                #region GetEntry
+                var state = context.BuildMetadata.Entry(build).State;
+                #endregion
+
+                Console.WriteLine(
+                    $"  Build {build["Tag"]} for {build["Version"]} with hash '{build["Hash"]}' with state '{state}'");
+            }
+
+            Console.WriteLine();
+        }
+    }
+
+    public static async Task Use_IEntityEntryGraphIterator()
+    {
+        PrintSampleName();
+
+        await using var context = new BlogsContext();
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        #region IEntityEntryGraphIterator
+        var blogEntry = context.ChangeTracker.Entries<Blog>().First();
+        var found = new HashSet<object>();
+        var iterator = context.GetService<IEntityEntryGraphIterator>();
+        iterator.TraverseGraph(new EntityEntryGraphNode<HashSet<object>>(blogEntry, found, null, null), node =>
+        {
+            if (node.NodeState.Contains(node.Entry.Entity))
+            {
+                return false;
+            }
+
+            Console.Write($"Found with '{node.Entry.Entity.GetType().Name}'");
+
+            if (node.InboundNavigation != null)
+            {
+                Console.Write($" by traversing '{node.InboundNavigation.Name}' from '{node.SourceEntry!.Entity.GetType().Name}'");
+            }
+
+            Console.WriteLine();
+
+            node.NodeState.Add(node.Entry.Entity);
+
+            return true;
+        });
+
+        Console.WriteLine();
+        Console.WriteLine($"Finished iterating. Found {found.Count} entities.");
+        Console.WriteLine();
+        #endregion
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public class BlogsContext : ModelBuildingBlogsContextBase
+    {
+        #region BuildMetadataSet
+        public DbSet<Dictionary<string, object>> BuildMetadata
+            => Set<Dictionary<string, object>>("BuildMetadata");
+        #endregion
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            #region ContextInitializedLog
+            optionsBuilder.ConfigureWarnings(
+                builder =>
+                {
+                    builder.Log((CoreEventId.ContextInitialized, LogLevel.Information));
+                });
+            #endregion
+
+            base.OnConfiguring(optionsBuilder);
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            base.OnModelCreating(modelBuilder);
+
+            #region BuildMetadata
+            modelBuilder.SharedTypeEntity<Dictionary<string, object>>(
+                "BuildMetadata", b =>
+                {
+                    b.IndexerProperty<int>("Id");
+                    b.IndexerProperty<string>("Tag");
+                    b.IndexerProperty<Version>("Version");
+                    b.IndexerProperty<string>("Hash");
+                    b.IndexerProperty<bool>("Prerelease");
+                });
+            #endregion
+        }
+
+        protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+        {
+            base.ConfigureConventions(configurationBuilder);
+
+            configurationBuilder.Properties<Version>().HaveConversion<VersionConverter>();
+        }
+
+        private class VersionConverter : ValueConverter<Version, string>
+        {
+            public VersionConverter()
+                : base(v => v.ToString(), v => new Version(v))
+            {
+            }
+        }
+    }
+}
+
+public static class BlogsContextExtensions
+{
+    #region FindSiblings
+    public static IEnumerable<TEntity> FindSiblings<TEntity>(
+        this DbContext context, TEntity entity, string navigationToParent)
+        where TEntity : class
+    {
+        var parentEntry = context.Entry(entity).Reference(navigationToParent);
+
+        return context.Entry(parentEntry.CurrentValue!)
+            .Collection(parentEntry.Metadata.Inverse!)
+            .CurrentValue!
+            .OfType<TEntity>()
+            .Where(e => !ReferenceEquals(e, entity));
+    }
+    #endregion
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/DocumentsContext.cs b/samples/core/Miscellaneous/NewInEFCore7/DocumentsContext.cs
new file mode 100644
index 0000000000..4b0127bffa
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/DocumentsContext.cs
@@ -0,0 +1,648 @@
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace NewInEfCore7;
+
+public abstract class Document
+{
+    protected Document(string title, int numberOfPages, DateTime publicationDate, byte[]? coverArt)
+    {
+        Title = title;
+        NumberOfPages = numberOfPages;
+        PublicationDate = publicationDate;
+        CoverArt = coverArt;
+    }
+
+    public int Id { get; private set; }
+
+    [Timestamp]
+    public byte[]? RowVersion { get; set; }
+
+    public string Title { get; set; }
+    public int NumberOfPages { get; set; }
+    public DateTime PublicationDate { get; set; }
+    public byte[]? CoverArt { get; set; }
+
+    public DateTime FirstRecordedOn { get; private set; }
+    public DateTime RetrievedOn { get; private set; }
+}
+
+public class Book : Document
+{
+    public Book(string title, int numberOfPages, DateTime publicationDate, byte[]? coverArt)
+        : base(title, numberOfPages, publicationDate, coverArt)
+    {
+    }
+
+    public string? Isbn { get; set; }
+
+    public List<Person> Authors { get; } = new();
+}
+
+public class Magazine : Document
+{
+    public Magazine(string title, int numberOfPages, DateTime publicationDate, byte[]? coverArt, int issueNumber)
+        : base(title, numberOfPages, publicationDate, coverArt)
+    {
+        IssueNumber = issueNumber;
+    }
+
+    public int IssueNumber { get; set; }
+    public decimal? CoverPrice { get; set; }
+    public Person Editor { get; set; } = null!;
+}
+
+public class Person
+{
+    public Person(string name)
+    {
+        Name = name;
+    }
+
+    public int Id { get; private set; }
+
+    [ConcurrencyCheck]
+    public string Name { get; set; }
+
+    public ContactDetails Contact { get; set; } = null!;
+
+    public List<Book> PublishedWorks { get; } = new();
+    public List<Magazine> Edited { get; } = new();
+}
+
+public abstract class DocumentsContext : DbContext
+{
+    public bool LoggingEnabled { get; set; }
+    public abstract MappingStrategy MappingStrategy { get; }
+    public virtual bool UseStoredProcedures => true;
+
+    public DbSet<Document> Documents => Set<Document>();
+    public DbSet<Book> Books => Set<Book>();
+    public DbSet<Magazine> Magazines => Set<Magazine>();
+    public DbSet<Person> People => Set<Person>();
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.UseSqlServer(@$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0")
+            .EnableSensitiveDataLogging()
+            .LogTo(
+                s =>
+                {
+                    if (LoggingEnabled)
+                    {
+                        Console.WriteLine(s);
+                    }
+                }, new List<EventId> { RelationalEventId.CommandExecuted });
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Document>(
+            entityTypeBuilder =>
+            {
+                entityTypeBuilder.Property(document => document.FirstRecordedOn).HasDefaultValueSql("getutcdate()");
+                entityTypeBuilder.Property(document => document.RetrievedOn).HasComputedColumnSql("getutcdate()");
+            });
+
+        if (UseStoredProcedures)
+        {
+            #region PersonSprocs
+            modelBuilder.Entity<Person>()
+                .InsertUsingStoredProcedure(
+                    "People_Insert",
+                    storedProcedureBuilder =>
+                    {
+                        storedProcedureBuilder.HasParameter(a => a.Name);
+                        storedProcedureBuilder.HasResultColumn(a => a.Id);
+                    })
+                .UpdateUsingStoredProcedure(
+                    "People_Update",
+                    storedProcedureBuilder =>
+                    {
+                        storedProcedureBuilder.HasOriginalValueParameter(person => person.Id);
+                        storedProcedureBuilder.HasOriginalValueParameter(person => person.Name);
+                        storedProcedureBuilder.HasParameter(person => person.Name);
+                        storedProcedureBuilder.HasRowsAffectedResultColumn();
+                    })
+                .DeleteUsingStoredProcedure(
+                    "People_Delete",
+                    storedProcedureBuilder =>
+                    {
+                        storedProcedureBuilder.HasOriginalValueParameter(person => person.Id);
+                        storedProcedureBuilder.HasOriginalValueParameter(person => person.Name);
+                        storedProcedureBuilder.HasRowsAffectedResultColumn();
+                    });
+            #endregion
+        }
+
+        modelBuilder.Entity<Person>(
+            entityTypeBuilder =>
+            {
+                entityTypeBuilder.OwnsOne(
+                    author => author.Contact,
+                    ownedNavigationBuilder =>
+                    {
+                        ownedNavigationBuilder.ToTable("Contacts");
+
+                        if (UseStoredProcedures)
+                        {
+                            ownedNavigationBuilder
+                                .InsertUsingStoredProcedure(
+                                    storedProcedureBuilder =>
+                                    {
+                                        storedProcedureBuilder.HasParameter("PersonId");
+                                        storedProcedureBuilder.HasParameter(contactDetails => contactDetails.Phone);
+                                    })
+                                .UpdateUsingStoredProcedure(
+                                    storedProcedureBuilder =>
+                                    {
+                                        storedProcedureBuilder.HasOriginalValueParameter("PersonId");
+                                        storedProcedureBuilder.HasParameter(contactDetails => contactDetails.Phone);
+                                        storedProcedureBuilder.HasRowsAffectedResultColumn();
+                                    })
+                                .DeleteUsingStoredProcedure(
+                                    storedProcedureBuilder =>
+                                    {
+                                        storedProcedureBuilder.HasOriginalValueParameter("PersonId");
+                                        storedProcedureBuilder.HasRowsAffectedResultColumn();
+                                    });
+                        }
+
+                        ownedNavigationBuilder.OwnsOne(
+                            contactDetails => contactDetails.Address,
+                            ownedOwnedNavigationBuilder =>
+                            {
+                                ownedOwnedNavigationBuilder.ToTable("Addresses");
+
+                                if (UseStoredProcedures)
+                                {
+                                    ownedOwnedNavigationBuilder
+                                        .InsertUsingStoredProcedure(
+                                            storedProcedureBuilder =>
+                                            {
+                                                storedProcedureBuilder.HasParameter("ContactDetailsPersonId");
+                                                storedProcedureBuilder.HasParameter(address => address.Street);
+                                                storedProcedureBuilder.HasParameter(address => address.City);
+                                                storedProcedureBuilder.HasParameter(address => address.Postcode);
+                                                storedProcedureBuilder.HasParameter(address => address.Country);
+                                            })
+                                        .UpdateUsingStoredProcedure(
+                                            storedProcedureBuilder =>
+                                            {
+                                                storedProcedureBuilder.HasOriginalValueParameter("ContactDetailsPersonId");
+                                                storedProcedureBuilder.HasParameter(address => address.Street);
+                                                storedProcedureBuilder.HasParameter(address => address.City);
+                                                storedProcedureBuilder.HasParameter(address => address.Postcode);
+                                                storedProcedureBuilder.HasParameter(address => address.Country);
+                                                storedProcedureBuilder.HasRowsAffectedResultColumn();
+                                            })
+                                        .DeleteUsingStoredProcedure(
+                                            storedProcedureBuilder =>
+                                            {
+                                                storedProcedureBuilder.HasOriginalValueParameter("ContactDetailsPersonId");
+                                                storedProcedureBuilder.HasRowsAffectedResultColumn();
+                                            });
+                                }
+                            });
+                    });
+            });
+    }
+
+    public async Task Seed()
+    {
+        var kentBeck = new Person("Kent Beck")
+        {
+            Contact = new() { Address = new Address("1 Smalltalk Ave", "Camberwick Green", "CW1 5ZH", "UK"), Phone = "01632 12346" }
+        };
+
+        var joshuaBloch = new Person("Joshua Bloch")
+        {
+            Contact = new() { Address = new Address("1 AFS Walk", "Chigley", "CW1 5ZH", "UK"), Phone = "01632 12347" }
+        };
+
+        var nealGafter = new Person("Neal Gafter")
+        {
+            Contact = new() { Address = new Address("1 Merlin Closure", "Chigley", "CW1 5ZH", "UK"), Phone = "01632 12348" }
+        };
+
+        var simonRockman = new Person("Simon Rockman")
+        {
+            Contact = new() { Address = new Address("1 Copper Run", "Camberwick Green", "CW1 5ZH", "UK"), Phone = "01632 12349" }
+        };
+
+        var documents = new List<Document>
+        {
+            new Book("Extreme Programming Explained", 190, new DateTime(2000, 1, 1), null)
+            {
+                Isbn = "201-61641-6", Authors = { kentBeck }
+            },
+            new Book("Java Puzzlers", 283, new DateTime(2005, 1, 1), null)
+            {
+                Isbn = "0-321-33678-X", Authors = { joshuaBloch, nealGafter }
+            },
+            new Book("Effective Java", 252, new DateTime(2001, 1, 1), new byte[] { 1, 2, 3, 4, 5, 6, 7, 8, 9 })
+            {
+                Isbn = "0-201-31005-8", Authors = { joshuaBloch }
+            },
+            new Book("Test-Driven Development By Example", 220, new DateTime(2003, 1, 1), null)
+            {
+                Isbn = "0-321-14653-0", Authors = { kentBeck }
+            },
+            new Magazine("Amstrad Computer User", 95, new DateTime(1986, 1, 12), new byte[] { 1, 2, 3 }, 15)
+            {
+                CoverPrice = 0.95m, Editor = simonRockman
+            },
+            new Magazine("Amiga Computing", 90, new DateTime(1988, 5, 16), null, 1) { CoverPrice = 1.95m, Editor = simonRockman }
+        };
+
+        await AddRangeAsync(documents);
+        await SaveChangesAsync();
+    }
+}
+
+public class TphDocumentsContext : DocumentsContext
+{
+    public override MappingStrategy MappingStrategy => MappingStrategy.Tph;
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Document>(
+            entityTypeBuilder =>
+            {
+                if (UseStoredProcedures)
+                {
+                    entityTypeBuilder.InsertUsingStoredProcedure(
+                            storedProcedureBuilder =>
+                            {
+                                storedProcedureBuilder.HasParameter("Discriminator");
+                                storedProcedureBuilder.HasParameter(document => document.Title);
+                                storedProcedureBuilder.HasParameter(document => document.NumberOfPages);
+                                storedProcedureBuilder.HasParameter(document => document.PublicationDate);
+                                storedProcedureBuilder.HasParameter(document => document.CoverArt);
+                                storedProcedureBuilder.HasResultColumn(document => document.Id);
+                                storedProcedureBuilder.HasParameter((Book document) => document.Isbn);
+                                storedProcedureBuilder.HasParameter((Magazine document) => document.CoverPrice);
+                                storedProcedureBuilder.HasParameter((Magazine document) => document.IssueNumber);
+                                storedProcedureBuilder.HasParameter("EditorId");
+                                storedProcedureBuilder.HasResultColumn(document => document.FirstRecordedOn);
+                                storedProcedureBuilder.HasResultColumn(document => document.RetrievedOn);
+                                storedProcedureBuilder.HasResultColumn(document => document.RowVersion);
+                            })
+                        .UpdateUsingStoredProcedure(
+                            storedProcedureBuilder =>
+                            {
+                                storedProcedureBuilder.HasOriginalValueParameter(document => document.Id);
+                                storedProcedureBuilder.HasOriginalValueParameter(document => document.RowVersion);
+                                storedProcedureBuilder.HasParameter(document => document.Title);
+                                storedProcedureBuilder.HasParameter(document => document.NumberOfPages);
+                                storedProcedureBuilder.HasParameter(document => document.PublicationDate);
+                                storedProcedureBuilder.HasParameter(document => document.CoverArt);
+                                storedProcedureBuilder.HasParameter(document => ((Book)document).Isbn);
+                                storedProcedureBuilder.HasParameter(document => ((Magazine)document).CoverPrice);
+                                storedProcedureBuilder.HasParameter(document => ((Magazine)document).IssueNumber);
+                                storedProcedureBuilder.HasParameter("EditorId");
+                                storedProcedureBuilder.HasParameter(document => document.FirstRecordedOn);
+                                storedProcedureBuilder.HasParameter(
+                                    document => document.RetrievedOn, parameterBuilder => parameterBuilder.IsOutput());
+                                storedProcedureBuilder.HasParameter(
+                                    document => document.RowVersion, parameterBuilder => parameterBuilder.IsOutput());
+                                storedProcedureBuilder.HasRowsAffectedResultColumn();
+                            })
+                        .DeleteUsingStoredProcedure(
+                            storedProcedureBuilder =>
+                            {
+                                storedProcedureBuilder.HasOriginalValueParameter(document => document.Id);
+                                storedProcedureBuilder.HasOriginalValueParameter(document => document.RowVersion);
+                                storedProcedureBuilder.HasRowsAffectedResultColumn();
+                            });
+                }
+            });
+
+        if (UseStoredProcedures)
+        {
+            #region JoinSprocs
+            modelBuilder.Entity<Book>(
+                entityTypeBuilder =>
+                {
+                    entityTypeBuilder
+                        .HasMany(document => document.Authors)
+                        .WithMany(author => author.PublishedWorks)
+                        .UsingEntity<Dictionary<string, object>>(
+                            "BookPerson",
+                            builder => builder.HasOne<Person>().WithMany().OnDelete(DeleteBehavior.Cascade),
+                            builder => builder.HasOne<Book>().WithMany().OnDelete(DeleteBehavior.ClientCascade),
+                            joinTypeBuilder =>
+                            {
+                                joinTypeBuilder
+                                    .InsertUsingStoredProcedure(
+                                        storedProcedureBuilder =>
+                                        {
+                                            storedProcedureBuilder.HasParameter("AuthorsId");
+                                            storedProcedureBuilder.HasParameter("PublishedWorksId");
+                                        })
+                                    .DeleteUsingStoredProcedure(
+                                        storedProcedureBuilder =>
+                                        {
+                                            storedProcedureBuilder.HasOriginalValueParameter("AuthorsId");
+                                            storedProcedureBuilder.HasOriginalValueParameter("PublishedWorksId");
+                                            storedProcedureBuilder.HasRowsAffectedResultColumn();
+                                        });
+                            });
+                });
+            #endregion
+        }
+
+        base.OnModelCreating(modelBuilder);
+    }
+}
+
+public class TptDocumentsContext : DocumentsContext
+{
+    public override MappingStrategy MappingStrategy => MappingStrategy.Tpt;
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Document>().UseTptMappingStrategy();
+
+        modelBuilder.Entity<Document>(
+            entityTypeBuilder =>
+            {
+                if (UseStoredProcedures)
+                {
+                    entityTypeBuilder
+                        .InsertUsingStoredProcedure(
+                            "Document_Insert_TPT",
+                            storedProcedureBuilder =>
+                            {
+                                storedProcedureBuilder.HasParameter(document => document.Title);
+                                storedProcedureBuilder.HasParameter(document => document.NumberOfPages);
+                                storedProcedureBuilder.HasParameter(document => document.PublicationDate);
+                                storedProcedureBuilder.HasParameter(document => document.CoverArt);
+                                storedProcedureBuilder.HasResultColumn(document => document.Id);
+                                storedProcedureBuilder.HasResultColumn(document => document.FirstRecordedOn);
+                                storedProcedureBuilder.HasResultColumn(document => document.RetrievedOn);
+                                storedProcedureBuilder.HasResultColumn(document => document.RowVersion);
+                            })
+                        .UpdateUsingStoredProcedure(
+                            "Document_Update_TPT",
+                            storedProcedureBuilder =>
+                            {
+                                storedProcedureBuilder.HasOriginalValueParameter(document => document.Id);
+                                storedProcedureBuilder.HasOriginalValueParameter(document => document.RowVersion);
+                                storedProcedureBuilder.HasParameter(document => document.Title);
+                                storedProcedureBuilder.HasParameter(document => document.NumberOfPages);
+                                storedProcedureBuilder.HasParameter(document => document.PublicationDate);
+                                storedProcedureBuilder.HasParameter(document => document.CoverArt);
+                                storedProcedureBuilder.HasParameter(document => document.FirstRecordedOn);
+                                storedProcedureBuilder.HasParameter(
+                                    magazine => magazine.RetrievedOn, parameterBuilder => parameterBuilder.IsOutput());
+                                storedProcedureBuilder.HasParameter(
+                                    magazine => magazine.RowVersion, parameterBuilder => parameterBuilder.IsOutput());
+                                storedProcedureBuilder.HasRowsAffectedResultColumn();
+                            })
+                        .DeleteUsingStoredProcedure(
+                            "Document_Delete_TPT",
+                            storedProcedureBuilder =>
+                            {
+                                storedProcedureBuilder.HasOriginalValueParameter(document => document.Id);
+                                storedProcedureBuilder.HasOriginalValueParameter(document => document.RowVersion);
+                                storedProcedureBuilder.HasRowsAffectedResultColumn();
+                            });
+                }
+            });
+
+        modelBuilder.Entity<Book>(
+            entityTypeBuilder =>
+            {
+                entityTypeBuilder
+                    .HasMany(document => document.Authors)
+                    .WithMany(author => author.PublishedWorks)
+                    .UsingEntity<Dictionary<string, object>>(
+                        "BookPerson",
+                        builder => builder.HasOne<Person>().WithMany().OnDelete(DeleteBehavior.Cascade),
+                        builder => builder.HasOne<Book>().WithMany().OnDelete(DeleteBehavior.ClientCascade),
+                        joinTypeBuilder =>
+                        {
+                            if (UseStoredProcedures)
+                            {
+                                joinTypeBuilder
+                                    .InsertUsingStoredProcedure(
+                                        storedProcedureBuilder =>
+                                        {
+                                            storedProcedureBuilder.HasParameter("AuthorsId");
+                                            storedProcedureBuilder.HasParameter("PublishedWorksId");
+                                        })
+                                    .DeleteUsingStoredProcedure(
+                                        storedProcedureBuilder =>
+                                        {
+                                            storedProcedureBuilder.HasOriginalValueParameter("AuthorsId");
+                                            storedProcedureBuilder.HasOriginalValueParameter("PublishedWorksId");
+                                            storedProcedureBuilder.HasRowsAffectedResultColumn();
+                                        });
+                            }
+                        });
+
+                if (UseStoredProcedures)
+                {
+                    entityTypeBuilder
+                        .InsertUsingStoredProcedure(
+                            "Book_Insert_TPT",
+                            storedProcedureBuilder =>
+                            {
+                                storedProcedureBuilder.HasParameter(book => book.Id);
+                                storedProcedureBuilder.HasParameter(book => book.Isbn);
+                            })
+                        .UpdateUsingStoredProcedure(
+                            "Book_Update_TPT",
+                            storedProcedureBuilder =>
+                            {
+                                storedProcedureBuilder.HasOriginalValueParameter(book => book.Id);
+                                storedProcedureBuilder.HasParameter(book => book.Isbn);
+                                storedProcedureBuilder.HasRowsAffectedResultColumn();
+                            })
+                        .DeleteUsingStoredProcedure(
+                            "Book_Delete_TPT",
+                            storedProcedureBuilder =>
+                            {
+                                storedProcedureBuilder.HasOriginalValueParameter(book => book.Id);
+                                storedProcedureBuilder.HasRowsAffectedResultColumn();
+                            });
+                }
+            });
+
+        modelBuilder.Entity<Magazine>(
+            entityTypeBuilder =>
+            {
+                if (UseStoredProcedures)
+                {
+                    entityTypeBuilder
+                        .InsertUsingStoredProcedure(
+                            "Magazine_Insert_TPT",
+                            storedProcedureBuilder =>
+                            {
+                                storedProcedureBuilder.HasParameter(magazine => magazine.Id);
+                                storedProcedureBuilder.HasParameter(magazine => magazine.CoverPrice);
+                                storedProcedureBuilder.HasParameter(magazine => magazine.IssueNumber);
+                                storedProcedureBuilder.HasParameter("EditorId");
+                            })
+                        .UpdateUsingStoredProcedure(
+                            "Magazine_Update_TPT",
+                            storedProcedureBuilder =>
+                            {
+                                storedProcedureBuilder.HasOriginalValueParameter(magazine => magazine.Id);
+                                storedProcedureBuilder.HasParameter(magazine => magazine.CoverPrice);
+                                storedProcedureBuilder.HasParameter(magazine => magazine.IssueNumber);
+                                storedProcedureBuilder.HasParameter("EditorId");
+                                storedProcedureBuilder.HasRowsAffectedResultColumn();
+                            })
+                        .DeleteUsingStoredProcedure(
+                            "Magazine_Delete_TPT",
+                            storedProcedureBuilder =>
+                            {
+                                storedProcedureBuilder.HasOriginalValueParameter(magazine => magazine.Id);
+                                storedProcedureBuilder.HasRowsAffectedResultColumn();
+                            });
+                }
+            });
+
+        base.OnModelCreating(modelBuilder);
+    }
+}
+
+public class TpcDocumentsContext : DocumentsContext
+{
+    public override MappingStrategy MappingStrategy => MappingStrategy.Tpc;
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Document>().UseTpcMappingStrategy();
+
+        modelBuilder.Entity<Book>(
+            entityTypeBuilder =>
+            {
+                entityTypeBuilder
+                    .HasMany(document => document.Authors)
+                    .WithMany(author => author.PublishedWorks)
+                    .UsingEntity<Dictionary<string, object>>(
+                        "BookPerson",
+                        builder => builder.HasOne<Person>().WithMany().OnDelete(DeleteBehavior.Cascade),
+                        builder => builder.HasOne<Book>().WithMany().OnDelete(DeleteBehavior.ClientCascade),
+                        joinTypeBuilder =>
+                        {
+                            if (UseStoredProcedures)
+                            {
+                                joinTypeBuilder
+                                    .InsertUsingStoredProcedure(
+                                        storedProcedureBuilder =>
+                                        {
+                                            storedProcedureBuilder.HasParameter("AuthorsId");
+                                            storedProcedureBuilder.HasParameter("PublishedWorksId");
+                                        })
+                                    .DeleteUsingStoredProcedure(
+                                        storedProcedureBuilder =>
+                                        {
+                                            storedProcedureBuilder.HasOriginalValueParameter("AuthorsId");
+                                            storedProcedureBuilder.HasOriginalValueParameter("PublishedWorksId");
+                                            storedProcedureBuilder.HasRowsAffectedResultColumn();
+                                        });
+                            }
+                        });
+
+                if (UseStoredProcedures)
+                {
+                    entityTypeBuilder.InsertUsingStoredProcedure(
+                            "Book_Insert_TPC",
+                            storedProcedureBuilder =>
+                            {
+                                storedProcedureBuilder.HasParameter(book => book.Title);
+                                storedProcedureBuilder.HasParameter(book => book.NumberOfPages);
+                                storedProcedureBuilder.HasParameter(book => book.PublicationDate);
+                                storedProcedureBuilder.HasParameter(book => book.CoverArt);
+                                storedProcedureBuilder.HasParameter(book => book.Isbn);
+                                storedProcedureBuilder.HasResultColumn(book => book.Id);
+                                storedProcedureBuilder.HasResultColumn(book => book.FirstRecordedOn);
+                                storedProcedureBuilder.HasResultColumn(book => book.RetrievedOn);
+                                storedProcedureBuilder.HasResultColumn(book => book.RowVersion);
+                            })
+                        .UpdateUsingStoredProcedure(
+                            "Book_Update_TPC",
+                            storedProcedureBuilder =>
+                            {
+                                storedProcedureBuilder.HasOriginalValueParameter(book => book.Id);
+                                storedProcedureBuilder.HasOriginalValueParameter(magazine => magazine.RowVersion);
+                                storedProcedureBuilder.HasParameter(book => book.Title);
+                                storedProcedureBuilder.HasParameter(book => book.NumberOfPages);
+                                storedProcedureBuilder.HasParameter(book => book.PublicationDate);
+                                storedProcedureBuilder.HasParameter(book => book.CoverArt);
+                                storedProcedureBuilder.HasParameter(book => book.FirstRecordedOn);
+                                storedProcedureBuilder.HasParameter(book => book.Isbn);
+                                storedProcedureBuilder.HasParameter(
+                                    magazine => magazine.RetrievedOn, parameterBuilder => parameterBuilder.IsOutput());
+                                storedProcedureBuilder.HasParameter(
+                                    magazine => magazine.RowVersion, parameterBuilder => parameterBuilder.IsOutput());
+                                storedProcedureBuilder.HasRowsAffectedResultColumn();
+                            })
+                        .DeleteUsingStoredProcedure(
+                            "Book_Delete_TPC",
+                            storedProcedureBuilder =>
+                            {
+                                storedProcedureBuilder.HasOriginalValueParameter(book => book.Id);
+                                storedProcedureBuilder.HasOriginalValueParameter(book => book.RowVersion);
+                                storedProcedureBuilder.HasRowsAffectedResultColumn();
+                            });
+                }
+            });
+
+        modelBuilder.Entity<Magazine>(
+            entityTypeBuilder =>
+            {
+                if (UseStoredProcedures)
+                {
+                    entityTypeBuilder
+                        .InsertUsingStoredProcedure(
+                            "Magazine_Insert_TPC",
+                            storedProcedureBuilder =>
+                            {
+                                storedProcedureBuilder.HasParameter(magazine => magazine.Title);
+                                storedProcedureBuilder.HasParameter(magazine => magazine.NumberOfPages);
+                                storedProcedureBuilder.HasParameter(magazine => magazine.PublicationDate);
+                                storedProcedureBuilder.HasParameter(magazine => magazine.CoverArt);
+                                storedProcedureBuilder.HasResultColumn(magazine => magazine.Id);
+                                storedProcedureBuilder.HasParameter(magazine => magazine.CoverPrice);
+                                storedProcedureBuilder.HasParameter(magazine => magazine.IssueNumber);
+                                storedProcedureBuilder.HasParameter("EditorId");
+                                storedProcedureBuilder.HasResultColumn(magazine => magazine.FirstRecordedOn);
+                                storedProcedureBuilder.HasResultColumn(magazine => magazine.RetrievedOn);
+                                storedProcedureBuilder.HasResultColumn(magazine => magazine.RowVersion);
+                            })
+                        .UpdateUsingStoredProcedure(
+                            "Magazine_Update_TPC",
+                            storedProcedureBuilder =>
+                            {
+                                storedProcedureBuilder.HasOriginalValueParameter(magazine => magazine.Id);
+                                storedProcedureBuilder.HasOriginalValueParameter(magazine => magazine.RowVersion);
+                                storedProcedureBuilder.HasParameter(magazine => magazine.Title);
+                                storedProcedureBuilder.HasParameter(magazine => magazine.NumberOfPages);
+                                storedProcedureBuilder.HasParameter(magazine => magazine.PublicationDate);
+                                storedProcedureBuilder.HasParameter(magazine => magazine.CoverArt);
+                                storedProcedureBuilder.HasParameter(magazine => magazine.CoverPrice);
+                                storedProcedureBuilder.HasParameter(magazine => magazine.IssueNumber);
+                                storedProcedureBuilder.HasParameter("EditorId");
+                                storedProcedureBuilder.HasParameter(magazine => magazine.FirstRecordedOn);
+                                storedProcedureBuilder.HasParameter(
+                                    magazine => magazine.RetrievedOn, parameterBuilder => parameterBuilder.IsOutput());
+                                storedProcedureBuilder.HasParameter(
+                                    magazine => magazine.RowVersion, parameterBuilder => parameterBuilder.IsOutput());
+                                storedProcedureBuilder.HasRowsAffectedResultColumn();
+                            })
+                        .DeleteUsingStoredProcedure(
+                            "Magazine_Delete_TPC",
+                            storedProcedureBuilder =>
+                            {
+                                storedProcedureBuilder.HasOriginalValueParameter(magazine => magazine.Id);
+                                storedProcedureBuilder.HasOriginalValueParameter(magazine => magazine.RowVersion);
+                                storedProcedureBuilder.HasRowsAffectedResultColumn();
+                            });
+                }
+            });
+
+        base.OnModelCreating(modelBuilder);
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/DocumentsContextStoredProcedures.cs b/samples/core/Miscellaneous/NewInEFCore7/DocumentsContextStoredProcedures.cs
new file mode 100644
index 0000000000..c52e46c43a
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/DocumentsContextStoredProcedures.cs
@@ -0,0 +1,481 @@
+namespace NewInEfCore7;
+
+public static class DocumentsContextStoredProcedures
+{
+    public static async Task CreateStoredProcedures(this DocumentsContext context)
+    {
+        switch (context.MappingStrategy)
+        {
+            case MappingStrategy.Tph:
+                // Document
+                await context.Database.ExecuteSqlRawAsync(
+                    @"
+CREATE PROCEDURE [dbo].[Documents_Insert]
+    @Discriminator [nvarchar](max),
+    @Title [nvarchar](max),
+    @NumberOfPages [int],
+    @PublicationDate [datetime2],
+    @CoverArt [varbinary](max),
+    @Isbn [nvarchar](max),
+    @CoverPrice [decimal](18,2),
+    @IssueNumber [int],
+    @EditorId [int]
+AS
+BEGIN
+    INSERT INTO [Documents] ([Discriminator], [CoverArt], [NumberOfPages], [PublicationDate], [Title], [Isbn], [CoverPrice], [IssueNumber], [EditorId])
+    OUTPUT INSERTED.[Id], INSERTED.[FirstRecordedOn], INSERTED.[RetrievedOn], INSERTED.[RowVersion]
+    VALUES (@Discriminator, @CoverArt, @NumberOfPages, @PublicationDate, @Title, @Isbn, @CoverPrice, @IssueNumber, @EditorId);
+END");
+
+                await context.Database.ExecuteSqlRawAsync(
+                    @"
+CREATE PROCEDURE [dbo].[Documents_Update]
+    @Id [int],
+    @RowVersion_Original [rowversion],
+    @Title [nvarchar](max),
+    @NumberOfPages [int],
+    @PublicationDate [datetime2],
+    @CoverArt [varbinary](max),
+    @Isbn [nvarchar](max),
+    @CoverPrice [decimal](18,2),
+    @IssueNumber [int],
+    @EditorId [int],
+    @FirstRecordedOn [datetime2],
+    @RetrievedOn [datetime2] OUT,
+    @RowVersion [rowversion] OUT
+AS
+BEGIN
+    DECLARE @TempTable table ([RetrievedOn] datetime2, [RowVersion] varbinary(8));
+    UPDATE [Documents] SET
+        [Title] = @Title,
+        [NumberOfPages] = @NumberOfPages,
+        [PublicationDate] = @PublicationDate,
+        [CoverArt] = @CoverArt,
+        [FirstRecordedOn] = @FirstRecordedOn,
+        [Isbn] = @Isbn,
+        [CoverPrice] = @CoverPrice,
+        [IssueNumber] = @IssueNumber,
+        [EditorId] = @EditorId
+    OUTPUT INSERTED.[RetrievedOn], INSERTED.[RowVersion] INTO @TempTable
+    WHERE [Id] = @Id AND [RowVersion] = @RowVersion_Original
+    SELECT @@ROWCOUNT;
+    SELECT @RetrievedOn = [RetrievedOn] FROM @TempTable;
+    SELECT @RowVersion = [RowVersion] FROM @TempTable;
+END");
+
+                await context.Database.ExecuteSqlRawAsync(
+                    @"
+CREATE PROCEDURE [dbo].[Documents_Delete]
+    @Id [int],
+    @RowVersion_Original [rowversion]
+AS
+BEGIN
+    DELETE FROM [Documents]
+    OUTPUT 1
+    WHERE [Id] = @Id AND [RowVersion] = @RowVersion_Original;
+END");
+                break;
+            case MappingStrategy.Tpt:
+                // Document
+                await context.Database.ExecuteSqlRawAsync(
+                    @"
+CREATE PROCEDURE [dbo].[Document_Insert_TPT]
+    @Title [nvarchar](max),
+    @NumberOfPages [int],
+    @PublicationDate [datetime2],
+    @CoverArt [varbinary](max)
+AS
+BEGIN
+    INSERT INTO [Documents] ([CoverArt], [NumberOfPages], [PublicationDate], [Title])
+    OUTPUT INSERTED.[Id], INSERTED.[FirstRecordedOn], INSERTED.[RetrievedOn], INSERTED.[RowVersion]
+    VALUES (@CoverArt, @NumberOfPages, @PublicationDate, @Title);
+END");
+
+                await context.Database.ExecuteSqlRawAsync(
+                    @"
+CREATE PROCEDURE [dbo].[Document_Update_TPT]
+    @Id [int],
+    @RowVersion_Original [rowversion],
+    @Title [nvarchar](max),
+    @NumberOfPages [int],
+    @PublicationDate [datetime2],
+    @CoverArt [varbinary](max),
+    @FirstRecordedOn [datetime2],
+    @RetrievedOn [datetime2] OUT,
+    @RowVersion [rowversion] OUT
+AS
+BEGIN
+    DECLARE @TempTable table ([RetrievedOn] datetime2, [RowVersion] varbinary(8));
+    UPDATE [Documents] SET
+        [Title] = @Title,
+        [NumberOfPages] = @NumberOfPages,
+        [PublicationDate] = @PublicationDate,
+        [CoverArt] = @CoverArt,
+        [FirstRecordedOn] = @FirstRecordedOn
+    OUTPUT INSERTED.[RetrievedOn], INSERTED.[RowVersion] INTO @TempTable
+    WHERE [Id] = @Id AND [RowVersion] = @RowVersion_Original
+    SELECT @@ROWCOUNT;
+    SELECT @RetrievedOn = [RetrievedOn] FROM @TempTable;
+    SELECT @RowVersion = [RowVersion] FROM @TempTable;
+END");
+
+                await context.Database.ExecuteSqlRawAsync(
+                    @"
+CREATE PROCEDURE [dbo].[Document_Delete_TPT]
+    @Id [int],
+    @RowVersion_Original [rowversion]
+AS
+BEGIN
+    DELETE FROM [Documents]
+    OUTPUT 1
+    WHERE [Id] = @Id AND [RowVersion] = @RowVersion_Original;
+END");
+
+                // Book
+                await context.Database.ExecuteSqlRawAsync(
+                    @"
+CREATE PROCEDURE [dbo].[Book_Insert_TPT]
+    @Id [int],
+    @Isbn [nvarchar](max)
+AS
+BEGIN
+    INSERT INTO [Books] ([Id], [Isbn])
+    VALUES (@Id, @Isbn);
+END");
+
+                await context.Database.ExecuteSqlRawAsync(
+                    @"
+CREATE PROCEDURE [dbo].[Book_Update_TPT]
+    @Id [int],
+    @Isbn [nvarchar](max)
+AS
+BEGIN
+    UPDATE [Books] SET
+        [Isbn] = @Isbn
+    WHERE [Id] = @Id
+    SELECT @@ROWCOUNT;
+END");
+
+                await context.Database.ExecuteSqlRawAsync(
+                    @"
+CREATE PROCEDURE [dbo].[Book_Delete_TPT]
+    @Id [int]
+AS
+BEGIN
+    DELETE FROM [Books]
+    OUTPUT 1
+    WHERE [Id] = @Id;
+END");
+
+                // Magazine
+                await context.Database.ExecuteSqlRawAsync(
+                    @"
+CREATE PROCEDURE [dbo].[Magazine_Insert_TPT]
+    @Id [int],
+    @CoverPrice [decimal](18,2),
+    @IssueNumber [int],
+    @EditorId [int]
+AS
+BEGIN
+    INSERT INTO [Magazines] ([Id], [CoverPrice], [IssueNumber], [EditorId])
+    VALUES (@Id, @CoverPrice, @IssueNumber, @EditorId);
+END");
+
+                await context.Database.ExecuteSqlRawAsync(
+                    @"
+CREATE PROCEDURE [dbo].[Magazine_Update_TPT]
+    @Id [int],
+    @CoverPrice [decimal](18,2),
+    @IssueNumber [int],
+    @EditorId [int]
+AS
+BEGIN
+    UPDATE [Magazines] SET
+        [CoverPrice] = @CoverPrice,
+        [IssueNumber] = @IssueNumber,
+        [EditorId] = @EditorId
+    WHERE [Id] = @Id
+    SELECT @@ROWCOUNT;
+END");
+
+                await context.Database.ExecuteSqlRawAsync(
+                    @"
+CREATE PROCEDURE [dbo].[Magazine_Delete_TPT]
+    @Id [int]
+AS
+BEGIN
+    DELETE FROM [Magazines]
+    OUTPUT 1
+    WHERE [Id] = @Id;
+END");
+                break;
+            case MappingStrategy.Tpc:
+                // Book
+                await context.Database.ExecuteSqlRawAsync(
+                    @"
+CREATE PROCEDURE [dbo].[Book_Insert_TPC]
+    @Title [nvarchar](max),
+    @NumberOfPages [int],
+    @PublicationDate [datetime2],
+    @CoverArt [varbinary](max),
+    @Isbn [nvarchar](max)
+AS
+BEGIN
+    INSERT INTO [Books] ([CoverArt], [Isbn], [NumberOfPages], [PublicationDate], [Title])
+    OUTPUT INSERTED.[Id], INSERTED.[FirstRecordedOn], INSERTED.[RetrievedOn], INSERTED.[RowVersion]
+    VALUES (@CoverArt, @Isbn, @NumberOfPages, @PublicationDate, @Title);
+END");
+
+                await context.Database.ExecuteSqlRawAsync(
+                    @"
+CREATE PROCEDURE [dbo].[Book_Update_TPC]
+    @Id [int],
+    @RowVersion_Original [rowversion],
+    @Title [nvarchar](max),
+    @NumberOfPages [int],
+    @PublicationDate [datetime2],
+    @CoverArt [varbinary](max),
+    @FirstRecordedOn [datetime2],
+    @Isbn [nvarchar](max),
+    @RetrievedOn [datetime2] OUT,
+    @RowVersion [rowversion] OUT
+AS
+BEGIN
+    DECLARE @TempTable table ([RetrievedOn] datetime2, [RowVersion] varbinary(8));
+    UPDATE [Books] SET
+        [Title] = @Title,
+        [NumberOfPages] = @NumberOfPages,
+        [PublicationDate] = @PublicationDate,
+        [CoverArt] = @CoverArt,
+        [FirstRecordedOn] = @FirstRecordedOn,
+        [Isbn] = @Isbn
+    OUTPUT INSERTED.[RetrievedOn], INSERTED.[RowVersion] INTO @TempTable
+    WHERE [Id] = @Id AND [RowVersion] = @RowVersion_Original
+    SELECT @@ROWCOUNT;
+    SELECT @RetrievedOn = [RetrievedOn] FROM @TempTable;
+    SELECT @RowVersion = [RowVersion] FROM @TempTable;
+END");
+
+                await context.Database.ExecuteSqlRawAsync(
+                    @"
+CREATE PROCEDURE [dbo].[Book_Delete_TPC]
+    @Id [int],
+    @RowVersion_Original [rowversion]
+AS
+BEGIN
+    DELETE FROM [Books]
+    OUTPUT 1
+    WHERE [Id] = @Id AND [RowVersion] = @RowVersion_Original;
+END");
+
+                // Magazine
+                await context.Database.ExecuteSqlRawAsync(
+                    @"
+CREATE PROCEDURE [dbo].[Magazine_Insert_TPC]
+    @Title [nvarchar](max),
+    @NumberOfPages [int],
+    @PublicationDate [datetime2],
+    @CoverArt [varbinary](max),
+    @CoverPrice [decimal](18,2),
+    @IssueNumber [int],
+    @EditorId [int]
+AS
+BEGIN
+    INSERT INTO [Magazines] ([CoverArt], [NumberOfPages], [PublicationDate], [Title], [CoverPrice], [IssueNumber], [EditorId])
+    OUTPUT INSERTED.[Id], INSERTED.[FirstRecordedOn], INSERTED.[RetrievedOn], INSERTED.[RowVersion]
+    VALUES (@CoverArt, @NumberOfPages, @PublicationDate, @Title, @CoverPrice, @IssueNumber, @EditorId);
+END");
+
+                await context.Database.ExecuteSqlRawAsync(
+                    @"
+CREATE PROCEDURE [dbo].[Magazine_Update_TPC]
+    @Id [int],
+    @RowVersion_Original [rowversion],
+    @Title [nvarchar](max),
+    @NumberOfPages [int],
+    @PublicationDate [datetime2],
+    @CoverArt [varbinary](max),
+    @CoverPrice [decimal](18,2),
+    @IssueNumber [int],
+    @EditorId [int],
+    @FirstRecordedOn [datetime2],
+    @RetrievedOn [datetime2] OUT,
+    @RowVersion [rowversion] OUT
+AS
+BEGIN
+    DECLARE @TempTable table ([RetrievedOn] datetime2, [RowVersion] varbinary(8));
+    UPDATE [Magazines] SET
+        [Title] = @Title,
+        [NumberOfPages] = @NumberOfPages,
+        [PublicationDate] = @PublicationDate,
+        [CoverArt] = @CoverArt,
+        [FirstRecordedOn] = @FirstRecordedOn,
+        [CoverPrice] = @CoverPrice,
+        [IssueNumber] = @IssueNumber,
+        [EditorId] = @EditorId
+    OUTPUT INSERTED.[RetrievedOn], INSERTED.[RowVersion] INTO @TempTable
+    WHERE [Id] = @Id AND [RowVersion] = @RowVersion_Original
+    SELECT @@ROWCOUNT;
+    SELECT @RetrievedOn = [RetrievedOn] FROM @TempTable;
+    SELECT @RowVersion = [RowVersion] FROM @TempTable;
+END");
+
+                await context.Database.ExecuteSqlRawAsync(
+                    @"
+CREATE PROCEDURE [dbo].[Magazine_Delete_TPC]
+    @Id [int],
+    @RowVersion_Original [rowversion]
+AS
+BEGIN
+    DELETE FROM [Magazines]
+    OUTPUT 1
+    WHERE [Id] = @Id AND [RowVersion] = @RowVersion_Original;
+END");
+                break;
+            default:
+                throw new ArgumentOutOfRangeException();
+        }
+
+        // Person
+        await context.Database.ExecuteSqlRawAsync(
+            @"
+CREATE PROCEDURE [dbo].[People_Insert]
+    @Name [nvarchar](max)
+AS
+BEGIN
+      INSERT INTO [People] ([Name])
+      OUTPUT INSERTED.[Id]
+      VALUES (@Name);
+END");
+
+        await context.Database.ExecuteSqlRawAsync(
+            @"
+CREATE PROCEDURE [dbo].[People_Update]
+    @Id [int],
+    @Name_Original [nvarchar](max),
+    @Name [nvarchar](max)
+AS
+BEGIN
+    UPDATE [People] SET [Name] = @Name
+    WHERE [Id] = @Id AND [Name] = @Name_Original
+    SELECT @@ROWCOUNT
+END");
+
+        await context.Database.ExecuteSqlRawAsync(
+            @"
+CREATE PROCEDURE [dbo].[People_Delete]
+    @Id [int],
+    @Name_Original [nvarchar](max)
+AS
+BEGIN
+    DELETE FROM [People]
+    OUTPUT 1
+    WHERE [Id] = @Id AND [Name] = @Name_Original;
+END");
+
+        // Contacts
+        await context.Database.ExecuteSqlRawAsync(
+            @"
+CREATE PROCEDURE [dbo].[Contacts_Insert]
+    @PersonId [int],
+    @Phone [nvarchar](max)
+AS
+BEGIN
+      INSERT INTO [Contacts] ([PersonId], [Phone])
+      VALUES (@PersonId, @Phone);
+END");
+
+        await context.Database.ExecuteSqlRawAsync(
+            @"
+CREATE PROCEDURE [dbo].[Contacts_Update]
+    @PersonId [int],
+    @Phone [nvarchar](max)
+AS
+BEGIN
+    UPDATE [Contacts] SET
+        [Phone] = @Phone
+    WHERE [PersonId] = @PersonId
+    SELECT @@ROWCOUNT;
+END");
+
+        await context.Database.ExecuteSqlRawAsync(
+            @"
+CREATE PROCEDURE [dbo].[Contacts_Delete]
+    @PersonId [int]
+AS
+BEGIN
+    DELETE FROM [Contacts]
+    OUTPUT 1
+    WHERE [PersonId] = @PersonId;
+END");
+
+        // Addresses
+        await context.Database.ExecuteSqlRawAsync(
+            @"
+CREATE PROCEDURE [dbo].[Addresses_Insert]
+    @ContactDetailsPersonId [int],
+    @Street [nvarchar](max),
+    @City [nvarchar](max),
+    @Postcode [nvarchar](max),
+    @Country [nvarchar](max)
+AS
+BEGIN
+      INSERT INTO [Addresses] ([ContactDetailsPersonId], [City], [Country], [Postcode], [Street])
+      VALUES (@ContactDetailsPersonId, @City, @Country, @Postcode, @Street);
+END");
+
+        await context.Database.ExecuteSqlRawAsync(
+            @"
+CREATE PROCEDURE [dbo].[Addresses_Update]
+    @ContactDetailsPersonId [int],
+    @Street [nvarchar](max),
+    @City [nvarchar](max),
+    @Postcode [nvarchar](max),
+    @Country [nvarchar](max)
+AS
+BEGIN
+    UPDATE [Addresses] SET
+        [Street] = @Street,
+        [City] = @City,
+        [Postcode] = @Postcode,
+        [Country] = @Country
+    WHERE [ContactDetailsPersonId] = @ContactDetailsPersonId
+    SELECT @@ROWCOUNT;
+END");
+
+        await context.Database.ExecuteSqlRawAsync(
+            @"
+CREATE PROCEDURE [dbo].[Addresses_Delete]
+    @ContactDetailsPersonId [int]
+AS
+BEGIN
+    DELETE FROM [Addresses]
+    OUTPUT 1
+    WHERE [ContactDetailsPersonId] = @ContactDetailsPersonId;
+END");
+
+        // BookPerson join table
+        await context.Database.ExecuteSqlRawAsync(
+            @"
+CREATE PROCEDURE [dbo].[BookPerson_Insert]
+    @AuthorsId [int],
+    @PublishedWorksId [int]
+AS
+BEGIN
+      INSERT INTO [BookPerson] ([AuthorsId], [PublishedWorksId])
+      VALUES (@AuthorsId, @PublishedWorksId);
+END");
+
+        await context.Database.ExecuteSqlRawAsync(
+            @"
+CREATE PROCEDURE [dbo].[BookPerson_Delete]
+    @AuthorsId [int],
+    @PublishedWorksId [int]
+AS
+BEGIN
+    DELETE FROM [BookPerson]
+    OUTPUT 1
+    WHERE [AuthorsId] = @AuthorsId AND [PublishedWorksId] = @PublishedWorksId;
+END");
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/ExecuteDeleteSample.cs b/samples/core/Miscellaneous/NewInEFCore7/ExecuteDeleteSample.cs
new file mode 100644
index 0000000000..17cd415362
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/ExecuteDeleteSample.cs
@@ -0,0 +1,331 @@
+namespace NewInEfCore7;
+
+public static class ExecuteDeleteSample
+{
+    public static Task ExecuteDelete()
+    {
+        PrintSampleName();
+        return ExecuteDeleteTest<TphBlogsContext>();
+    }
+
+    public static Task ExecuteDeleteTpt()
+    {
+        PrintSampleName();
+        return ExecuteDeleteTest<TptBlogsContext>();
+    }
+
+    public static Task ExecuteDeleteTpc()
+    {
+        PrintSampleName();
+        return ExecuteDeleteTest<TpcBlogsContext>();
+    }
+
+    public static Task ExecuteDeleteSqlite()
+    {
+        PrintSampleName();
+        return ExecuteDeleteTest<TphSqliteBlogsContext>();
+    }
+
+    private static async Task ExecuteDeleteTest<TContext>()
+        where TContext : BlogsContext, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        await DeleteAllTags<TContext>();
+        await DeleteTagsContainingDotNet<TContext>();
+        await DeleteTagsFromOldPosts<TContext>();
+
+        if (context.MappingStrategy == MappingStrategy.Tph)
+        {
+            await DeleteAllAuthors<TContext>();
+            await DeleteAuthorsWithOnePost<TContext>();
+        }
+
+        if (context.MappingStrategy != MappingStrategy.Tpt)
+        {
+            await DeleteFeaturedPosts<TContext>();
+        }
+
+        if (context.MappingStrategy == MappingStrategy.Tph
+            && !context.UseSqlite)
+        {
+            await DeletePostsForGivenAuthor<TContext>();
+        }
+
+        if (context.MappingStrategy != MappingStrategy.Tpt)
+        {
+            // https://github.com/dotnet/efcore/issues/28532
+            await DeleteAllBlogsAndPosts<TContext>();
+        }
+
+        Console.WriteLine();
+    }
+
+    private static async Task DeleteAllTags<TContext>()
+        where TContext : BlogsContext, new()
+    {
+        await using var context = new TContext();
+        await context.Database.BeginTransactionAsync();
+
+        Console.WriteLine("Delete all tags...");
+        Console.WriteLine(
+            $"Tags before delete: {string.Join(", ", await context.Tags.AsNoTracking().Select(e => "'" + e.Text + "'").ToListAsync())}");
+        Console.WriteLine();
+
+        context.LoggingEnabled = true;
+
+        #region DeleteAllTags
+        await context.Tags.ExecuteDeleteAsync();
+        #endregion
+
+        context.LoggingEnabled = false;
+
+        Console.WriteLine();
+        Console.WriteLine(
+            $"Tags after delete: {string.Join(", ", await context.Tags.AsNoTracking().Select(e => "'" + e.Text + "'").ToListAsync())}");
+        Console.WriteLine();
+    }
+
+    private static async Task DeleteTagsContainingDotNet<TContext>()
+        where TContext : BlogsContext, new()
+    {
+        await using var context = new TContext();
+        await context.Database.BeginTransactionAsync();
+
+        Console.WriteLine("Delete tags containing '.NET'...");
+        Console.WriteLine(
+            $"Tags before delete: {string.Join(", ", await context.Tags.AsNoTracking().Select(e => "'" + e.Text + "'").ToListAsync())}");
+        Console.WriteLine();
+
+        context.LoggingEnabled = true;
+
+        #region DeleteTagsContainingDotNet
+        await context.Tags.Where(t => t.Text.Contains(".NET")).ExecuteDeleteAsync();
+        #endregion
+
+        context.LoggingEnabled = false;
+
+        Console.WriteLine();
+        Console.WriteLine(
+            $"Tags after delete: {string.Join(", ", await context.Tags.AsNoTracking().Select(e => "'" + e.Text + "'").ToListAsync())}");
+        Console.WriteLine();
+    }
+
+    private static async Task DeleteTagsFromOldPosts<TContext>()
+        where TContext : BlogsContext, new()
+    {
+        await using var context = new TContext();
+        await context.Database.BeginTransactionAsync();
+
+        Console.WriteLine("Delete tags from old posts...");
+        Console.WriteLine(
+            $"Tags before delete: {string.Join(", ", await context.Tags.AsNoTracking().Select(e => "'" + e.Text + "'").ToListAsync())}");
+        Console.WriteLine();
+
+        context.LoggingEnabled = true;
+
+        #region DeleteTagsFromOldPosts
+        await context.Tags.Where(t => t.Posts.All(e => e.PublishedOn.Year < 2022)).ExecuteDeleteAsync();
+        #endregion
+
+        context.LoggingEnabled = false;
+
+        Console.WriteLine();
+        Console.WriteLine(
+            $"Tags after delete: {string.Join(", ", await context.Tags.AsNoTracking().Select(e => "'" + e.Text + "'").ToListAsync())}");
+        Console.WriteLine();
+    }
+
+    private static async Task DeleteAllAuthors<TContext>()
+        where TContext : BlogsContext, new()
+    {
+        await using var context = new TContext();
+        await context.Database.BeginTransactionAsync();
+
+        Console.WriteLine("Delete all authors...");
+        Console.WriteLine(
+            $"Authors before delete: {string.Join(", ", await context.Authors.AsNoTracking().Select(e => "'" + e.Name + "'").ToListAsync())}");
+        Console.WriteLine();
+
+        context.LoggingEnabled = true;
+
+        #region DeleteAllAuthors
+        await context.Posts.TagWith("Deleting posts...").ExecuteDeleteAsync();
+        await context.Authors.TagWith("Deleting authors...").ExecuteDeleteAsync();
+        #endregion
+
+        context.LoggingEnabled = false;
+
+        Console.WriteLine();
+        Console.WriteLine(
+            $"Authors after delete: {string.Join(", ", await context.Authors.AsNoTracking().Select(e => "'" + e.Name + "'").ToListAsync())}");
+        Console.WriteLine();
+    }
+
+    private static async Task DeleteFeaturedPosts<TContext>()
+        where TContext : BlogsContext, new()
+    {
+        await using var context = new TContext();
+        await context.Database.BeginTransactionAsync();
+
+        Console.WriteLine("Delete featured posts...");
+        Console.WriteLine(
+            $"Posts before delete: {string.Join(", ", await context.Posts.AsNoTracking().Select(e => "'" + e.Id + "'").ToListAsync())}");
+        Console.WriteLine();
+
+        context.LoggingEnabled = true;
+
+        #region DeleteFeaturedPosts
+        await context.Set<FeaturedPost>().ExecuteDeleteAsync();
+        #endregion
+
+        context.LoggingEnabled = false;
+
+        Console.WriteLine();
+        Console.WriteLine(
+            $"Posts after delete: {string.Join(", ", await context.Posts.AsNoTracking().Select(e => "'" + e.Id + "'").ToListAsync())}");
+        Console.WriteLine();
+    }
+
+    private static async Task DeletePostsForGivenAuthor<TContext>()
+        where TContext : BlogsContext, new()
+    {
+        await using var context = new TContext();
+        await context.Database.BeginTransactionAsync();
+
+        Console.WriteLine("Delete posts for given author...");
+        Console.WriteLine(
+            $"Posts before delete: {string.Join(", ", await context.Posts.AsNoTracking().Select(e => "'" + e.Id + "'").ToListAsync())}");
+        Console.WriteLine();
+
+        context.LoggingEnabled = true;
+
+        #region DeletePostsForGivenAuthor
+        await context.Posts.Where(p => p.Author!.Name.StartsWith("Arthur")).ExecuteDeleteAsync();
+        #endregion
+
+        context.LoggingEnabled = false;
+
+        Console.WriteLine();
+        Console.WriteLine(
+            $"Posts after delete: {string.Join(", ", await context.Posts.AsNoTracking().Select(e => "'" + e.Id + "'").ToListAsync())}");
+        Console.WriteLine();
+    }
+
+    private static async Task DeleteAllBlogsAndPosts<TContext>()
+        where TContext : BlogsContext, new()
+    {
+        await using var context = new TContext();
+        await context.Database.BeginTransactionAsync();
+
+        Console.WriteLine("Delete all blogs and posts...");
+        Console.WriteLine(
+            $"Blogs before delete: {string.Join(", ", await context.Blogs.AsNoTracking().Select(e => "'" + e.Id + "'").ToListAsync())}");
+        Console.WriteLine(
+            $"Posts before delete: {string.Join(", ", await context.Posts.AsNoTracking().Select(e => "'" + e.Id + "'").ToListAsync())}");
+        Console.WriteLine();
+
+        context.LoggingEnabled = true;
+
+        #region DeleteAllBlogsAndPosts
+        await context.Blogs.ExecuteDeleteAsync();
+        #endregion
+
+        context.LoggingEnabled = false;
+
+        Console.WriteLine();
+        Console.WriteLine(
+            $"Blogs after delete: {string.Join(", ", await context.Blogs.AsNoTracking().Select(e => "'" + e.Id + "'").ToListAsync())}");
+        Console.WriteLine(
+            $"Posts after delete: {string.Join(", ", await context.Posts.AsNoTracking().Select(e => "'" + e.Id + "'").ToListAsync())}");
+        Console.WriteLine();
+    }
+
+    private static async Task DeleteAuthorsWithOnePost<TContext>()
+        where TContext : BlogsContext, new()
+    {
+        await using var context = new TContext();
+        await context.Database.BeginTransactionAsync();
+
+        Console.WriteLine("Delete authors with only one post...");
+        Console.WriteLine(
+            $"Authors before delete: {string.Join(", ", await context.Authors.AsNoTracking().Select(e => "'" + e.Name + "'").ToListAsync())}");
+        Console.WriteLine();
+
+        context.LoggingEnabled = true;
+        await context.Posts.Where(p => p.Author!.Posts.Count <= 1)
+            .ExecuteUpdateAsync(s => s.SetProperty(p => EF.Property<int?>(p, "AuthorId"), p => null));
+        await context.Authors.Where(a => a.Posts.Count <= 1).ExecuteDeleteAsync();
+        context.LoggingEnabled = false;
+
+        Console.WriteLine();
+        Console.WriteLine(
+            $"Authors after delete: {string.Join(", ", await context.Authors.AsNoTracking().Select(e => "'" + e.Name + "'").ToListAsync())}");
+        Console.WriteLine();
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+}
+
+public class TphBlogsContext : BlogsContext
+{
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>().Ignore(e => e.Metadata);
+        modelBuilder.Entity<Author>().OwnsOne(e => e.Contact).OwnsOne(e => e.Address);
+
+        base.OnModelCreating(modelBuilder);
+    }
+}
+
+public class TphSqliteBlogsContext : BlogsContext
+{
+    public TphSqliteBlogsContext()
+        : base(useSqlite: true)
+    {
+    }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>().Ignore(e => e.Metadata);
+        modelBuilder.Entity<Author>().OwnsOne(e => e.Contact).OwnsOne(e => e.Address);
+
+        base.OnModelCreating(modelBuilder);
+    }
+}
+
+public class TptBlogsContext : BlogsContext
+{
+    public override MappingStrategy MappingStrategy => MappingStrategy.Tpt;
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<FeaturedPost>().ToTable("FeaturedPosts");
+        modelBuilder.Entity<Post>().Ignore(e => e.Metadata);
+        modelBuilder.Entity<Author>().OwnsOne(e => e.Contact).OwnsOne(e => e.Address);
+
+        base.OnModelCreating(modelBuilder);
+    }
+}
+
+public class TpcBlogsContext : BlogsContext
+{
+    public override MappingStrategy MappingStrategy => MappingStrategy.Tpc;
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>().UseTpcMappingStrategy();
+        modelBuilder.Entity<FeaturedPost>().ToTable("FeaturedPosts");
+        modelBuilder.Entity<Post>().Ignore(e => e.Metadata);
+        modelBuilder.Entity<Author>().OwnsOne(e => e.Contact).OwnsOne(e => e.Address);
+
+        base.OnModelCreating(modelBuilder);
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/ExecuteUpdateSample.cs b/samples/core/Miscellaneous/NewInEFCore7/ExecuteUpdateSample.cs
new file mode 100644
index 0000000000..8f066a011d
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/ExecuteUpdateSample.cs
@@ -0,0 +1,165 @@
+namespace NewInEfCore7;
+
+public static class ExecuteUpdateSample
+{
+    public static Task ExecuteUpdate()
+    {
+        PrintSampleName();
+        return ExecuteUpdateTest<TphBlogsContext>();
+    }
+
+    public static Task ExecuteUpdateTpt()
+    {
+        PrintSampleName();
+        return ExecuteUpdateTest<TptBlogsContext>();
+    }
+
+    public static Task ExecuteUpdateTpc()
+    {
+        PrintSampleName();
+        return ExecuteUpdateTest<TpcBlogsContext>();
+    }
+
+    public static Task ExecuteUpdateSqlite()
+    {
+        PrintSampleName();
+        return ExecuteUpdateTest<TphSqliteBlogsContext>();
+    }
+
+    private static async Task ExecuteUpdateTest<TContext>()
+        where TContext : BlogsContext, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        await UpdateAllBlogs<TContext>();
+
+        if (context.MappingStrategy == MappingStrategy.Tph)
+        {
+            await UpdateOldPosts<TContext>();
+        }
+
+        if (context.MappingStrategy != MappingStrategy.Tpt)
+        {
+            await UpdateFeaturedPosts<TContext>();
+        }
+
+        await UpdateTagsOnOldPosts<TContext>();
+
+        Console.WriteLine();
+    }
+
+    private static async Task UpdateAllBlogs<TContext>()
+        where TContext : BlogsContext, new()
+    {
+        await using var context = new TContext();
+        await context.Database.BeginTransactionAsync();
+
+        Console.WriteLine("Update names for all blogs...");
+        Console.WriteLine(
+            $"Blogs before update: {string.Join(", ", await context.Blogs.AsNoTracking().Select(e => "'" + e.Name + "'").ToListAsync())}");
+        Console.WriteLine();
+
+        context.LoggingEnabled = true;
+
+        #region UpdateAllBlogs
+        await context.Blogs.ExecuteUpdateAsync(
+            s => s.SetProperty(b => b.Name, b => b.Name + " *Featured!*"));
+        #endregion
+
+        context.LoggingEnabled = false;
+
+        Console.WriteLine();
+        Console.WriteLine(
+            $"Blogs after update: {string.Join(", ", await context.Blogs.AsNoTracking().Select(e => "'" + e.Name + "'").ToListAsync())}");
+        Console.WriteLine();
+    }
+
+    private static async Task UpdateOldPosts<TContext>()
+        where TContext : BlogsContext, new()
+    {
+        await using var context = new TContext();
+        await context.Database.BeginTransactionAsync();
+
+        Console.WriteLine("Update title and content for old posts...");
+        Console.WriteLine(
+            $"Posts before update: {string.Join(", ", await context.Posts.AsNoTracking().Select(e => "'..." + e.Title.Substring(e.Title.Length - 12) + "'").ToListAsync())}");
+        Console.WriteLine();
+
+        context.LoggingEnabled = true;
+
+        #region UpdateOldPosts
+        await context.Posts
+            .Where(p => p.PublishedOn.Year < 2022)
+            .ExecuteUpdateAsync(s => s
+                .SetProperty(b => b.Title, b => b.Title + " (" + b.PublishedOn.Year + ")")
+                .SetProperty(b => b.Content, b => b.Content + " ( This content was published in " + b.PublishedOn.Year + ")"));
+        #endregion
+
+        context.LoggingEnabled = false;
+
+        Console.WriteLine();
+        Console.WriteLine(
+            $"Posts after update: {string.Join(", ", await context.Posts.AsNoTracking().Select(e => "'..." + e.Title.Substring(e.Title.Length - 12) + "'").ToListAsync())}");
+        Console.WriteLine();
+    }
+
+    private static async Task UpdateFeaturedPosts<TContext>()
+        where TContext : BlogsContext, new()
+    {
+        await using var context = new TContext();
+        await context.Database.BeginTransactionAsync();
+
+        Console.WriteLine("Update title and content for featured posts...");
+        Console.WriteLine(
+            $"Posts before update: {string.Join(", ", await context.Posts.AsNoTracking().Select(e => "'..." + e.Title.Substring(e.Title.Length - 12) + "'").ToListAsync())}");
+        Console.WriteLine();
+
+        context.LoggingEnabled = true;
+        await context.Set<FeaturedPost>()
+            .ExecuteUpdateAsync(
+                s => s.SetProperty(b => b.Title, b => b.Title + " *Featured!*")
+                    .SetProperty(b => b.Content, b => "Featured: " + b.Content));
+        context.LoggingEnabled = false;
+
+        Console.WriteLine();
+        Console.WriteLine(
+            $"Posts after update: {string.Join(", ", await context.Posts.AsNoTracking().Select(e => "'..." + e.Title.Substring(e.Title.Length - 12) + "'").ToListAsync())}");
+        Console.WriteLine();
+    }
+
+    private static async Task UpdateTagsOnOldPosts<TContext>()
+        where TContext : BlogsContext, new()
+    {
+        await using var context = new TContext();
+        await context.Database.BeginTransactionAsync();
+
+        Console.WriteLine("Update tags on old posts");
+        Console.WriteLine(
+            $"Tags before update: {string.Join(", ", await context.Tags.AsNoTracking().Select(e => "'" + e.Text + "'").ToListAsync())}");
+        Console.WriteLine();
+
+        context.LoggingEnabled = true;
+
+        #region UpdateTagsOnOldPosts
+        await context.Tags
+            .Where(t => t.Posts.All(e => e.PublishedOn.Year < 2022))
+            .ExecuteUpdateAsync(s => s.SetProperty(t => t.Text, t => t.Text + " (old)"));
+        #endregion
+
+        context.LoggingEnabled = false;
+
+        Console.WriteLine();
+        Console.WriteLine(
+            $"Tags after update: {string.Join(", ", await context.Tags.AsNoTracking().Select(e => "'" + e.Text + "'").ToListAsync())}");
+        Console.WriteLine();
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/GroupByEntityTypeSample.cs b/samples/core/Miscellaneous/NewInEFCore7/GroupByEntityTypeSample.cs
new file mode 100644
index 0000000000..3b22c4ae7f
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/GroupByEntityTypeSample.cs
@@ -0,0 +1,123 @@
+namespace NewInEfCore7;
+
+public static class GroupByEntityTypeSample
+{
+    public static Task GroupBy_entity_type_SqlServer()
+    {
+        PrintSampleName();
+        return QueryTest<BookContextSqlServer>();
+    }
+
+    public static Task GroupBy_entity_type_Sqlite()
+    {
+        PrintSampleName();
+        return QueryTest<BookContextSqlite>();
+    }
+
+    public static Task GroupBy_entity_type_InMemory()
+    {
+        PrintSampleName();
+        return QueryTest<BookContextInMemory>();
+    }
+
+    private static async Task QueryTest<TContext>()
+        where TContext : BookContext, new()
+    {
+        await using (var context = new TContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            var toast = new Author { Name = "Toast" };
+            var alice = new Author { Name = "Alice" };
+
+            await context.AddRangeAsync(
+                new Book { Author = alice, Price = 10 },
+                new Book { Author = alice, Price = 11 },
+                new Book { Author = toast, Price = 12 },
+                new Book { Author = toast, Price = 13 },
+                new Book { Author = toast, Price = 14 });
+
+            await context.SaveChangesAsync();
+        }
+
+        await using (var context = new TContext())
+        {
+            #region GroupByEntityType
+            var query = context.Books
+                .GroupBy(s => s.Author)
+                .Select(s => new { Author = s.Key, MaxPrice = s.Max(p => p.Price) });
+            #endregion
+
+            await foreach (var group in query.AsAsyncEnumerable())
+            {
+                Console.WriteLine($"Author: {group.Author.Name}; MaxPrice = {group.MaxPrice}");
+            }
+        }
+
+        await using (var context = new TContext())
+        {
+            #region GroupByEntityTypeReversed
+            var query = context.Authors
+                .Select(a => new { Author = a, MaxPrice = a.Books.Max(b => b.Price) });
+            #endregion
+
+            await foreach (var group in query.AsAsyncEnumerable())
+            {
+                Console.WriteLine($"Author: {group.Author.Name}; MaxPrice = {group.MaxPrice}");
+            }
+        }
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public abstract class BookContext : DbContext
+    {
+        public DbSet<Book> Books => Set<Book>();
+        public DbSet<Author> Authors => Set<Author>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .LogTo(Console.WriteLine, LogLevel.Information)
+                .EnableSensitiveDataLogging();
+    }
+
+    public class BookContextSqlServer : BookContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => base.OnConfiguring(
+                optionsBuilder.UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Books;ConnectRetryCount=0"));
+    }
+
+    public class BookContextSqlite : BookContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => base.OnConfiguring(
+                optionsBuilder.UseSqlite("Data Source = books.db"));
+    }
+
+    public class BookContextInMemory : BookContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => base.OnConfiguring(
+                optionsBuilder.UseInMemoryDatabase(nameof(BookContextInMemory)));
+    }
+
+    public class Author
+    {
+        public int Id { get; set; }
+        public string Name { get; set; } = default!;
+        public ICollection<Book> Books { get; } = new List<Book>();
+    }
+
+    public class Book
+    {
+        public int Id { get; set; }
+        public Author Author { get; set; } = default!;
+        public int Price { get; set; }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/GroupByFinalOperatorSample.cs b/samples/core/Miscellaneous/NewInEFCore7/GroupByFinalOperatorSample.cs
new file mode 100644
index 0000000000..dafe9ba50e
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/GroupByFinalOperatorSample.cs
@@ -0,0 +1,107 @@
+namespace NewInEfCore7;
+
+public static class GroupByFinalOperatorSample
+{
+    public static Task GroupBy_final_operator_SqlServer()
+    {
+        PrintSampleName();
+        return QueryTest<BookContextSqlServer>();
+    }
+
+    public static Task GroupBy_final_operator_Sqlite()
+    {
+        PrintSampleName();
+        return QueryTest<BookContextSqlite>();
+    }
+
+    public static Task GroupBy_final_operator_InMemory()
+    {
+        PrintSampleName();
+        return QueryTest<BookContextInMemory>();
+    }
+
+    private static async Task QueryTest<TContext>()
+        where TContext : BookContext, new()
+    {
+        await using (var context = new TContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            var toast = new Author { Name = "Toast" };
+            var alice = new Author { Name = "Alice" };
+
+            await context.AddRangeAsync(
+                new Book { Author = alice, Price = 10 },
+                new Book { Author = alice, Price = 10 },
+                new Book { Author = toast, Price = 12 },
+                new Book { Author = toast, Price = 12 },
+                new Book { Author = toast, Price = 14 });
+
+            await context.SaveChangesAsync();
+        }
+
+        await using (var context = new TContext())
+        {
+            #region GroupByFinalOperator
+            var query = context.Books.GroupBy(s => s.Price);
+            #endregion
+
+            await foreach (var group in query.AsAsyncEnumerable())
+            {
+                Console.WriteLine($"Price: {group.Key}; Count = {group.Count()}");
+            }
+        }
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public abstract class BookContext : DbContext
+    {
+        public DbSet<Book> Books => Set<Book>();
+        public DbSet<Author> Authors => Set<Author>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .LogTo(Console.WriteLine, LogLevel.Information)
+                .EnableSensitiveDataLogging();
+    }
+
+    public class BookContextSqlServer : BookContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => base.OnConfiguring(
+                optionsBuilder.UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Books;ConnectRetryCount=0"));
+    }
+
+    public class BookContextSqlite : BookContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => base.OnConfiguring(
+                optionsBuilder.UseSqlite("Data Source = books.db"));
+    }
+
+    public class BookContextInMemory : BookContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => base.OnConfiguring(
+                optionsBuilder.UseInMemoryDatabase(nameof(BookContextInMemory)));
+    }
+
+    public class Author
+    {
+        public int Id { get; set; }
+        public string Name { get; set; } = default!;
+    }
+
+    public class Book
+    {
+        public int Id { get; set; }
+        public Author Author { get; set; } = default!;
+        public int? Price { get; set; }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/GroupJoinFinalOperatorSample.cs b/samples/core/Miscellaneous/NewInEFCore7/GroupJoinFinalOperatorSample.cs
new file mode 100644
index 0000000000..56bb973af2
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/GroupJoinFinalOperatorSample.cs
@@ -0,0 +1,147 @@
+namespace NewInEfCore7;
+
+public static class GroupJoinFinalOperatorSample
+{
+    public static Task GroupJoin_final_operator_SqlServer()
+    {
+        PrintSampleName();
+        return QueryTest<GroupJoinContextSqlServer>();
+    }
+
+    public static Task GroupJoin_final_operator_Sqlite()
+    {
+        PrintSampleName();
+        return QueryTest<GroupJoinContextSqlite>();
+    }
+
+    public static Task GroupJoin_final_operator_InMemory()
+    {
+        PrintSampleName();
+        return QueryTest<GroupJoinContextInMemory>();
+    }
+
+    private static async Task QueryTest<TContext>()
+        where TContext : GroupJoinContext, new()
+    {
+        await using (var context = new TContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            var toast = new Customer { Name = "Toast" };
+            var alice = new Customer { Name = "Alice" };
+
+            await context.AddRangeAsync(
+                new Order { Customer = alice, Amount = 10 },
+                new Order { Customer = alice, Amount = 10 },
+                new Order { Customer = toast, Amount = 12 },
+                new Order { Customer = toast, Amount = 12 },
+                new Order { Customer = toast, Amount = 14 });
+
+            await context.SaveChangesAsync();
+        }
+
+        await using (var context = new TContext())
+        {
+            #region GroupJoinFinalOperator
+            var query = context.Customers.GroupJoin(
+                context.Orders, c => c.Id, o => o.CustomerId, (c, os) => new { Customer = c, Orders = os });
+            #endregion
+
+            await foreach (var group in query.AsAsyncEnumerable())
+            {
+                Console.WriteLine($"Customer: {group.Customer.Name}; Count = {group.Orders.Count()}");
+            }
+        }
+
+        await using (var context = new TContext())
+        {
+            var query = context.Customers
+                .GroupJoin(
+                    context.Orders,
+                    o => o.Id,
+                    bt => bt.CustomerId,
+                    (o, bt) => new { Customer = o, BotTasks = bt, });
+
+            await foreach (var group in query.AsAsyncEnumerable())
+            {
+                Console.WriteLine($"Customer: {group.Customer.Name}; Count = {group.BotTasks.Count()}");
+            }
+        }
+
+        await using (var context = new TContext())
+        {
+            var query =
+                from customer in context.Customers
+                join order in context.Orders on customer.Id equals order.CustomerId into orderDetails
+                select new CustomerWithNavigationProperties { Customer = customer, Orders = orderDetails.ToList() };
+
+            await foreach (var group in query.AsAsyncEnumerable())
+            {
+                Console.WriteLine($"Customer: {group.Customer.Name}; Count = {group.Orders.Count()}");
+            }
+        }
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public abstract class GroupJoinContext : DbContext
+    {
+        public DbSet<Customer> Customers => Set<Customer>();
+        public DbSet<Order> Orders => Set<Order>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .LogTo(Console.WriteLine, LogLevel.Information)
+                .EnableSensitiveDataLogging();
+    }
+
+    public class GroupJoinContextSqlServer : GroupJoinContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => base.OnConfiguring(
+                optionsBuilder.UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Customers;ConnectRetryCount=0"));
+    }
+
+    public class GroupJoinContextSqlite : GroupJoinContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => base.OnConfiguring(
+                optionsBuilder.UseSqlite("Data Source = customers.db"));
+    }
+
+    public class GroupJoinContextInMemory : GroupJoinContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => base.OnConfiguring(
+                optionsBuilder.UseInMemoryDatabase(nameof(GroupJoinContextInMemory)));
+    }
+
+    public class Customer
+    {
+        public int Id { get; set; }
+        public string Name { get; set; } = default!;
+        public List<Order> Orders { get; } = new();
+    }
+
+    public class Order
+    {
+        public int Id { get; set; }
+
+        public int? CustomerId { get; set; }
+        public Customer? Customer { get; set; }
+
+        [Precision(18, 2)]
+        public decimal Amount { get; set; }
+    }
+
+    public class CustomerWithNavigationProperties
+    {
+        public Customer Customer { get; set; } = null!;
+        public List<Order> Orders { get; set; } = null!;
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/JsonColumnsSample.cs b/samples/core/Miscellaneous/NewInEFCore7/JsonColumnsSample.cs
new file mode 100644
index 0000000000..44f6c3e60e
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/JsonColumnsSample.cs
@@ -0,0 +1,264 @@
+using System.Net;
+
+namespace NewInEfCore7;
+
+public static class JsonColumnsSample
+{
+    public static Task Json_columns_with_TPH()
+    {
+        PrintSampleName();
+        return JsonColumnsTest<JsonBlogsContext>();
+    }
+
+    public static Task Json_columns_with_TPH_on_SQLite()
+    {
+        PrintSampleName();
+        return JsonColumnsTest<JsonBlogsContextSqlite>();
+    }
+
+    private static async Task JsonColumnsTest<TContext>()
+        where TContext : BlogsContext, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.LoggingEnabled = true;
+        context.ChangeTracker.Clear();
+
+        #region AuthorsInChigley
+        var authorsInChigley = await context.Authors
+            .Where(author => author.Contact.Address.City == "Chigley")
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var author in authorsInChigley)
+        {
+            Console.WriteLine($"{author.Name} lives at '{author.Contact.Address.Street}' in Chigley.");
+        }
+
+        Console.WriteLine();
+
+        #region PostcodesInChigley
+        var postcodesInChigley = await context.Authors
+            .Where(author => author.Contact.Address.City == "Chigley")
+            .Select(author => author.Contact.Address.Postcode)
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine($"Postcodes in Chigley are '{string.Join("', '", postcodesInChigley)}'");
+        Console.WriteLine();
+
+        #region OrderedAddresses
+        var orderedAddresses = await context.Authors
+            .Where(
+                author => (author.Contact.Address.City == "Chigley"
+                           && author.Contact.Phone != null)
+                          || author.Name.StartsWith("D"))
+            .OrderBy(author => author.Contact.Phone)
+            .Select(
+                author => author.Name + " (" + author.Contact.Address.Street
+                          + ", " + author.Contact.Address.City
+                          + " " + author.Contact.Address.Postcode + ")")
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var address in orderedAddresses)
+        {
+            Console.WriteLine(address);
+        }
+
+        Console.WriteLine();
+
+        var authorsInChigleyWithPosts = await context.Authors
+            .Where(
+                author => author.Contact.Address.City == "Chigley"
+                          && author.Posts.Count > 1)
+            .Include(author => author.Posts)
+            .ToListAsync();
+
+        Console.WriteLine();
+        foreach (var author in authorsInChigleyWithPosts)
+        {
+            Console.WriteLine($"{author.Name} has {author.Posts.Count} posts");
+        }
+
+        Console.WriteLine();
+
+        #region PostsWithViews
+        var postsWithViews = await context.Posts.Where(post => post.Metadata!.Views > 3000)
+            .AsNoTracking()
+            .Select(
+                post => new
+                {
+                    post.Author!.Name, post.Metadata!.Views, Searches = post.Metadata.TopSearches, Commits = post.Metadata.Updates
+                })
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var postWithViews in postsWithViews)
+        {
+            Console.WriteLine(
+                $"Post by {postWithViews.Name} with {postWithViews.Views} views had {postWithViews.Commits.Count} commits with {postWithViews.Searches.Sum(term => term.Count)} searches");
+        }
+
+        Console.WriteLine();
+
+        context.ChangeTracker.Clear();
+
+        Console.WriteLine("Updating a 'Contact' JSON document...");
+        Console.WriteLine();
+
+        #region UpdateDocument
+        var jeremy = await context.Authors.SingleAsync(author => author.Name.StartsWith("Jeremy"));
+
+        jeremy.Contact = new() { Address = new("2 Riverside", "Trimbridge", "TB1 5ZS", "UK"), Phone = "01632 88346" };
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        context.ChangeTracker.Clear();
+
+        Console.WriteLine("Updating an 'Address' inside the 'Contact' JSON document...");
+        Console.WriteLine();
+
+        #region UpdateSubDocument
+        var brice = await context.Authors.SingleAsync(author => author.Name.StartsWith("Brice"));
+
+        brice.Contact.Address = new("4 Riverside", "Trimbridge", "TB1 5ZS", "UK");
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        context.ChangeTracker.Clear();
+
+        Console.WriteLine();
+        Console.WriteLine("Updating only 'Country' in a 'Contact' JSON document...");
+        Console.WriteLine();
+
+        #region UpdateProperty
+        var arthur = await context.Authors.SingleAsync(author => author.Name.StartsWith("Arthur"));
+
+        arthur.Contact.Address.Country = "United Kingdom";
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        Console.WriteLine();
+
+        context.ChangeTracker.Clear();
+
+        var post = await context.Posts.SingleAsync(post => post.Title.StartsWith("Hacking"));
+
+        post.Metadata!.Updates.Add(new PostUpdate(IPAddress.Broadcast, DateTime.UtcNow) { UpdatedBy = "User" });
+        post.Metadata!.TopGeographies.Clear();
+
+        await context.SaveChangesAsync();
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+}
+
+public abstract class JsonBlogsContextBase : BlogsContext
+{
+    protected JsonBlogsContextBase(bool useSqlite = false)
+        : base(useSqlite)
+    {
+    }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Author>().OwnsOne(
+            author => author.Contact, ownedNavigationBuilder =>
+            {
+                ownedNavigationBuilder.ToJson();
+                ownedNavigationBuilder.OwnsOne(contactDetails => contactDetails.Address);
+            });
+
+        #region PostMetadataConfig
+        modelBuilder.Entity<Post>().OwnsOne(
+            post => post.Metadata, ownedNavigationBuilder =>
+            {
+                ownedNavigationBuilder.ToJson();
+                ownedNavigationBuilder.OwnsMany(metadata => metadata.TopSearches);
+                ownedNavigationBuilder.OwnsMany(metadata => metadata.TopGeographies);
+                ownedNavigationBuilder.OwnsMany(
+                    metadata => metadata.Updates,
+                    ownedOwnedNavigationBuilder => ownedOwnedNavigationBuilder.OwnsMany(update => update.Commits));
+            });
+        #endregion
+
+        base.OnModelCreating(modelBuilder);
+    }
+}
+
+public class JsonBlogsContext : JsonBlogsContextBase
+{
+}
+
+public class JsonBlogsContextSqlite : JsonBlogsContextBase
+{
+    public JsonBlogsContextSqlite()
+        : base(useSqlite: true)
+    {
+    }
+}
+
+// Used only for code snippets:
+
+public abstract class TableSharingAggregateContext : TphBlogsContext
+{
+    #region TableSharingAggregate
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Author>().OwnsOne(
+            author => author.Contact, ownedNavigationBuilder =>
+            {
+                ownedNavigationBuilder.OwnsOne(contactDetails => contactDetails.Address);
+            });
+    }
+    #endregion
+}
+
+public abstract class TableMappedAggregateContext : TphBlogsContext
+{
+    #region TableMappedAggregate
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Author>().OwnsOne(
+            author => author.Contact, ownedNavigationBuilder =>
+            {
+                ownedNavigationBuilder.ToTable("Contacts");
+                ownedNavigationBuilder.OwnsOne(
+                    contactDetails => contactDetails.Address, ownedOwnedNavigationBuilder =>
+                    {
+                        ownedOwnedNavigationBuilder.ToTable("Addresses");
+                    });
+            });
+    }
+    #endregion
+}
+
+public abstract class JsonColumnAggregateContext : TphBlogsContext
+{
+    #region JsonColumnAggregate
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Author>().OwnsOne(
+            author => author.Contact, ownedNavigationBuilder =>
+            {
+                ownedNavigationBuilder.ToJson();
+                ownedNavigationBuilder.OwnsOne(contactDetails => contactDetails.Address);
+            });
+    }
+    #endregion
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/MiscellaneousTranslationsSample.cs b/samples/core/Miscellaneous/NewInEFCore7/MiscellaneousTranslationsSample.cs
new file mode 100644
index 0000000000..6e4f5fd636
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/MiscellaneousTranslationsSample.cs
@@ -0,0 +1,119 @@
+namespace NewInEfCore7;
+
+public static class MiscellaneousTranslationsSample
+{
+    public static async Task Translate_string_IndexOf()
+    {
+        PrintSampleName();
+
+        await using (var context = new BlogsContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+            await context.Seed();
+        }
+
+        await using (var context = new BlogsContext { LoggingEnabled = true })
+        {
+            #region StringIndexOf
+            var query = context.Posts
+                .Select(post => new { post.Title, IndexOfEntity = post.Content.IndexOf("Entity") })
+                .Where(post => post.IndexOfEntity > 0);
+            #endregion
+
+            await foreach (var post in query.AsAsyncEnumerable())
+            {
+                Console.WriteLine(post);
+            }
+
+            Console.WriteLine();
+        }
+
+        await using (var context = new BlogsContext { LoggingEnabled = true })
+        {
+            #region GetType
+            var query = context.Posts.Where(post => post.GetType() == typeof(Post));
+            #endregion
+
+            await foreach (var post in query.AsAsyncEnumerable())
+            {
+                Console.WriteLine($"{post.GetType().Name} : {post.Title}");
+            }
+
+            Console.WriteLine();
+        }
+
+        await using (var context = new BlogsContext { LoggingEnabled = true })
+        {
+            #region OfType
+            var query = context.Posts.OfType<Post>();
+            #endregion
+
+            await foreach (var post in query.AsAsyncEnumerable())
+            {
+                Console.WriteLine($"{post.GetType().Name} : {post.Title}");
+            }
+
+            Console.WriteLine();
+        }
+
+        await using (var context = new BlogsContext { LoggingEnabled = true })
+        {
+            #region AtTimeZone
+            var query = context.Posts
+                .Select(
+                    post => new
+                    {
+                        post.Title,
+                        PacificTime = EF.Functions.AtTimeZone(post.PublishedOn, "Pacific Standard Time"),
+                        UkTime = EF.Functions.AtTimeZone(post.PublishedOn, "GMT Standard Time"),
+                    });
+            #endregion
+
+            await foreach (var post in query.AsAsyncEnumerable())
+            {
+                Console.WriteLine(post);
+            }
+
+            Console.WriteLine();
+        }
+
+        await using (var context = new BlogsContext { LoggingEnabled = true })
+        {
+            #region FilteredInclude
+            var query = context.Blogs.Include(
+                blog => EF.Property<ICollection<Post>>(blog, "Posts")
+                    .Where(post => post.Content.Contains(".NET"))
+                    .OrderBy(post => post.Title));
+            #endregion
+
+            await foreach (var blog in query.AsAsyncEnumerable())
+            {
+                Console.WriteLine($"Blog {blog.Name}:");
+
+                foreach (var post in blog.Posts)
+                {
+                    Console.WriteLine($"  Post {post.Title}");
+                }
+            }
+
+            Console.WriteLine();
+        }
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public class BlogsContext : NewInEfCore7.BlogsContext
+    {
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Author>().Ignore(author => author.Contact);
+            modelBuilder.Entity<Post>().Ignore(post => post.Metadata);
+            base.OnModelCreating(modelBuilder);
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/ModelBuildingConventionsSample.cs b/samples/core/Miscellaneous/NewInEFCore7/ModelBuildingConventionsSample.cs
new file mode 100644
index 0000000000..8e8c34c3b5
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/ModelBuildingConventionsSample.cs
@@ -0,0 +1,439 @@
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Metadata.Builders;
+using Microsoft.EntityFrameworkCore.Metadata.Conventions;
+using Microsoft.EntityFrameworkCore.Metadata.Conventions.Infrastructure;
+
+#pragma warning disable CS0169
+
+namespace NewInEfCore7;
+
+public static class ModelBuildingConventionsSample
+{
+    public static Task No_foreign_key_index_convention()
+    {
+        PrintSampleName();
+        return ConventionsTest<NoForeignKeyIndexBlogsContext>();
+    }
+
+    public static Task Discriminator_length_convention()
+    {
+        PrintSampleName();
+        return ConventionsTest<DiscriminatorLengthBlogsContext>();
+    }
+
+    public static Task Max_string_length_convention()
+    {
+        PrintSampleName();
+        return ConventionsTest<MaxStringLengthBlogsContext>();
+    }
+
+    public static async Task Map_members_explicitly_by_attribute_convention()
+    {
+        PrintSampleName();
+
+        await using var context = new LaundryContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        Console.WriteLine(context.Model.ToDebugString());
+        Console.WriteLine();
+    }
+
+    public static async Task Custom_model_validation_convention()
+    {
+        PrintSampleName();
+
+        await using var context = new TenantIdValidatingContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        Console.WriteLine(context.Model.ToDebugString());
+        Console.WriteLine();
+    }
+
+    public static Task No_cascade_delete_convention()
+    {
+        PrintSampleName();
+        return ConventionsTest<NoCascadeDeleteBlogsContext>();
+    }
+
+    private static async Task ConventionsTest<TContext>()
+        where TContext : BlogsContext, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+        context.ChangeTracker.Clear();
+
+        Console.WriteLine(context.Model.ToDebugString());
+
+        var blogs = await context.Blogs
+            .Include(blog => blog.Posts).ThenInclude(post => post.Author)
+            .Include(blog => blog.Posts).ThenInclude(post => post.Tags)
+            .ToListAsync();
+
+        blogs[0].Name += "Changed";
+        blogs[1].Posts[2].Content += "Changed";
+        blogs[2].Posts[0].Author!.Contact.Address.Country = "United Kingdon";
+        blogs[3].Posts[1].Tags.Add(new Tag("TagNt", "New Tag"));
+        blogs[2].Posts[1].Tags.Remove(blogs[2].Posts[1].Tags[0]);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+}
+
+public abstract class ModelBuildingBlogsContextBase : BlogsContext
+{
+    protected ModelBuildingBlogsContextBase(bool useSqlite = false)
+        : base(useSqlite)
+    {
+    }
+
+    public override MappingStrategy MappingStrategy => MappingStrategy.Tph;
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Author>().OwnsOne(
+            author => author.Contact, ownedNavigationBuilder =>
+            {
+                ownedNavigationBuilder.OwnsOne(contactDetails => contactDetails.Address);
+            });
+
+        modelBuilder.Entity<Post>().OwnsOne(
+            post => post.Metadata, ownedNavigationBuilder =>
+            {
+                ownedNavigationBuilder.OwnsMany(metadata => metadata.TopSearches);
+                ownedNavigationBuilder.OwnsMany(metadata => metadata.TopGeographies);
+                ownedNavigationBuilder.OwnsMany(
+                    metadata => metadata.Updates,
+                    ownedOwnedNavigationBuilder => ownedOwnedNavigationBuilder.OwnsMany(update => update.Commits));
+            });
+
+        base.OnModelCreating(modelBuilder);
+    }
+}
+
+public class NoForeignKeyIndexBlogsContext : ModelBuildingBlogsContextBase
+{
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>(entityTypeBuilder => entityTypeBuilder.HasIndex("BlogId"));
+
+        base.OnModelCreating(modelBuilder);
+    }
+
+    protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+    {
+        configurationBuilder.Conventions.Remove(typeof(ForeignKeyIndexConvention));
+
+        base.ConfigureConventions(configurationBuilder);
+    }
+}
+
+public class DiscriminatorLengthBlogsContext : ModelBuildingBlogsContextBase
+{
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        base.OnModelCreating(modelBuilder);
+
+        modelBuilder.Entity<Post>()
+            .HasDiscriminator<string>("PostTypeDiscriminator")
+            .HasValue<Post>("Post")
+            .HasValue<FeaturedPost>("Featured");
+    }
+
+    protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+    {
+        configurationBuilder.Conventions.Add(_ => new DiscriminatorLengthConvention3());
+
+        base.ConfigureConventions(configurationBuilder);
+    }
+}
+
+#region DiscriminatorLengthConvention1
+public class DiscriminatorLengthConvention1 : IEntityTypeBaseTypeChangedConvention
+{
+    public void ProcessEntityTypeBaseTypeChanged(
+        IConventionEntityTypeBuilder entityTypeBuilder,
+        IConventionEntityType? newBaseType,
+        IConventionEntityType? oldBaseType,
+        IConventionContext<IConventionEntityType> context)
+    {
+        var discriminatorProperty = entityTypeBuilder.Metadata.FindDiscriminatorProperty();
+        if (discriminatorProperty != null
+            && discriminatorProperty.ClrType == typeof(string))
+        {
+            discriminatorProperty.Builder.HasMaxLength(24);
+        }
+    }
+}
+#endregion
+
+#region DiscriminatorLengthConvention2
+public class DiscriminatorLengthConvention2 : IModelFinalizingConvention
+{
+    public void ProcessModelFinalizing(IConventionModelBuilder modelBuilder, IConventionContext<IConventionModelBuilder> context)
+    {
+        foreach (var entityType in modelBuilder.Metadata.GetEntityTypes()
+                     .Where(entityType => entityType.BaseType == null))
+        {
+            var discriminatorProperty = entityType.FindDiscriminatorProperty();
+            if (discriminatorProperty != null
+                && discriminatorProperty.ClrType == typeof(string))
+            {
+                discriminatorProperty.Builder.HasMaxLength(24);
+            }
+        }
+    }
+}
+#endregion
+
+#region DiscriminatorLengthConvention3
+public class DiscriminatorLengthConvention3 : IModelFinalizingConvention
+{
+    public void ProcessModelFinalizing(IConventionModelBuilder modelBuilder, IConventionContext<IConventionModelBuilder> context)
+    {
+        foreach (var entityType in modelBuilder.Metadata.GetEntityTypes()
+                     .Where(entityType => entityType.BaseType == null))
+        {
+            var discriminatorProperty = entityType.FindDiscriminatorProperty();
+            if (discriminatorProperty != null
+                && discriminatorProperty.ClrType == typeof(string))
+            {
+                var maxDiscriminatorValueLength =
+                    entityType.GetDerivedTypesInclusive().Select(e => ((string)e.GetDiscriminatorValue()!).Length).Max();
+
+                discriminatorProperty.Builder.HasMaxLength(maxDiscriminatorValueLength);
+            }
+        }
+    }
+}
+#endregion
+
+public class MaxStringLengthBlogsContext : ModelBuildingBlogsContextBase
+{
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>()
+            .Property(post => post.Content)
+            .HasMaxLength(4000);
+
+        base.OnModelCreating(modelBuilder);
+    }
+
+    protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+    {
+        configurationBuilder.Conventions.Add(_ => new MaxStringLengthConvention());
+        configurationBuilder.Conventions.Add(_ => new DiscriminatorLengthConvention3());
+
+        base.ConfigureConventions(configurationBuilder);
+    }
+}
+
+#region MaxStringLengthConvention
+public class MaxStringLengthConvention : IModelFinalizingConvention
+{
+    public void ProcessModelFinalizing(IConventionModelBuilder modelBuilder, IConventionContext<IConventionModelBuilder> context)
+    {
+        foreach (var property in modelBuilder.Metadata.GetEntityTypes()
+                     .SelectMany(
+                         entityType => entityType.GetDeclaredProperties()
+                             .Where(
+                                 property => property.ClrType == typeof(string))))
+        {
+            property.Builder.HasMaxLength(512);
+        }
+    }
+}
+#endregion
+
+public class LaundryContext : DbContext
+{
+    public DbSet<LaundryBasket> LaundryBaskets => Set<LaundryBasket>();
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.UseSqlServer(@$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0");
+
+    #region ReplaceConvention
+    protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+    {
+        configurationBuilder.Conventions.Replace<PropertyDiscoveryConvention>(
+            serviceProvider => new AttributeBasedPropertyDiscoveryConvention(
+                serviceProvider.GetRequiredService<ProviderConventionSetBuilderDependencies>()));
+    }
+    #endregion
+}
+
+#region PersistAttribute
+[AttributeUsage(AttributeTargets.Property | AttributeTargets.Field)]
+public sealed class PersistAttribute : Attribute
+{
+}
+#endregion
+
+#region LaundryBasket
+public class LaundryBasket
+{
+    [Persist]
+    [Key]
+    private readonly int _id;
+
+    [Persist]
+    public int TenantId { get; init; }
+
+    public bool IsClean { get; set; }
+
+    public List<Garment> Garments { get; } = new();
+}
+
+public class Garment
+{
+    public Garment(string name, string color)
+    {
+        Name = name;
+        Color = color;
+    }
+
+    [Persist]
+    [Key]
+    private readonly int _id;
+
+    [Persist]
+    public int TenantId { get; init; }
+
+    [Persist]
+    public string Name { get; }
+
+    [Persist]
+    public string Color { get; }
+
+    public bool IsClean { get; set; }
+
+    public LaundryBasket? Basket { get; set; }
+}
+#endregion
+
+#region AttributeBasedPropertyDiscoveryConvention
+public class AttributeBasedPropertyDiscoveryConvention : PropertyDiscoveryConvention
+{
+    public AttributeBasedPropertyDiscoveryConvention(ProviderConventionSetBuilderDependencies dependencies)
+        : base(dependencies)
+    {
+    }
+
+    public override void ProcessEntityTypeAdded(
+        IConventionEntityTypeBuilder entityTypeBuilder,
+        IConventionContext<IConventionEntityTypeBuilder> context)
+        => Process(entityTypeBuilder);
+
+    public override void ProcessEntityTypeBaseTypeChanged(
+        IConventionEntityTypeBuilder entityTypeBuilder,
+        IConventionEntityType? newBaseType,
+        IConventionEntityType? oldBaseType,
+        IConventionContext<IConventionEntityType> context)
+    {
+        if ((newBaseType == null
+             || oldBaseType != null)
+            && entityTypeBuilder.Metadata.BaseType == newBaseType)
+        {
+            Process(entityTypeBuilder);
+        }
+    }
+
+    private void Process(IConventionEntityTypeBuilder entityTypeBuilder)
+    {
+        foreach (var memberInfo in GetRuntimeMembers())
+        {
+            if (Attribute.IsDefined(memberInfo, typeof(PersistAttribute), inherit: true))
+            {
+                entityTypeBuilder.Property(memberInfo);
+            }
+            else if (memberInfo is PropertyInfo propertyInfo
+                     && Dependencies.TypeMappingSource.FindMapping(propertyInfo) != null)
+            {
+                entityTypeBuilder.Ignore(propertyInfo.Name);
+            }
+        }
+
+        IEnumerable<MemberInfo> GetRuntimeMembers()
+        {
+            var clrType = entityTypeBuilder.Metadata.ClrType;
+
+            foreach (var property in clrType.GetRuntimeProperties()
+                         .Where(p => p.GetMethod != null && !p.GetMethod.IsStatic))
+            {
+                yield return property;
+            }
+
+            foreach (var property in clrType.GetRuntimeFields())
+            {
+                yield return property;
+            }
+        }
+    }
+}
+#endregion
+
+public class TenantIdValidatingContext : DbContext
+{
+    public DbSet<LaundryBasket> LaundryBaskets => Set<LaundryBasket>();
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.UseSqlServer(@$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0");
+
+    protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+    {
+        configurationBuilder.Conventions.Replace<PropertyDiscoveryConvention>(
+            serviceProvider => new AttributeBasedPropertyDiscoveryConvention(
+                serviceProvider.GetRequiredService<ProviderConventionSetBuilderDependencies>()));
+
+        configurationBuilder.Conventions.Add(_ => new ValidateTenantIdConvention());
+    }
+}
+
+public class ValidateTenantIdConvention : IModelFinalizedConvention
+{
+    public IModel ProcessModelFinalized(IModel model)
+    {
+        foreach (var entityType in model.GetEntityTypes())
+        {
+            var tenantIdProperty = entityType.FindProperty("TenantId");
+            if (tenantIdProperty == null
+                || tenantIdProperty.ClrType != typeof(int))
+            {
+                throw new InvalidOperationException($"Entity type {entityType.DisplayName()} does not have an int TenantId property.");
+            }
+        }
+
+        return model;
+    }
+}
+
+public class NoCascadeDeleteBlogsContext : ModelBuildingBlogsContextBase
+{
+    protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+    {
+        configurationBuilder.Conventions.Add(_ => new NoCascadeDeleteConvention());
+
+        base.ConfigureConventions(configurationBuilder);
+    }
+}
+
+public class NoCascadeDeleteConvention : IModelFinalizingConvention
+{
+    public void ProcessModelFinalizing(IConventionModelBuilder modelBuilder, IConventionContext<IConventionModelBuilder> context)
+    {
+        foreach (var foreignKey in modelBuilder.Metadata.GetEntityTypes()
+                     .SelectMany(entityType => entityType.GetDeclaredForeignKeys()))
+        {
+            foreignKey.Builder.Metadata.SetDeleteBehavior(DeleteBehavior.ClientSetNull);
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs b/samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs
new file mode 100644
index 0000000000..073b6420fc
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/ModelBuildingSample.cs
@@ -0,0 +1,592 @@
+namespace NewInEfCore7;
+
+public static class ModelBuildingSample
+{
+    public static async Task Indexes_can_be_ordered()
+    {
+        PrintSampleName();
+
+        await using var context = new BlogsContext();
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    public static async Task Property_can_be_mapped_to_different_column_names_TPT()
+    {
+        PrintSampleName();
+
+        await using var context = new AnimalsTptContext();
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    public static async Task Property_can_be_mapped_to_different_column_names_TPC()
+    {
+        PrintSampleName();
+
+        await using var context = new AnimalsTpcContext();
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    public static async Task Entity_splitting()
+    {
+        PrintSampleName();
+
+        await using (var context = new EntitySplittingContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            await context.AddRangeAsync(
+                new Customer("Alice", "1 Main St", "Chigley", "CW1 5ZH", "UK") { PhoneNumber = "01632 12348" },
+                new Customer("Mac", "2 Main St", "Chigley", "CW1 5ZH", "UK"),
+                new Customer("Toast", "3 Main St", "Chigley", null, "UK") { PhoneNumber = "01632 12348" });
+
+            await context.SaveChangesAsync();
+        }
+
+        await using (var context = new EntitySplittingContext())
+        {
+            var customers = await context.Customers
+                .Where(customer => customer.PhoneNumber!.StartsWith("01632") && customer.City == "Chigley")
+                .OrderBy(customer => customer.PostCode)
+                .ThenBy(customer => customer.Name)
+                .ToListAsync();
+
+            foreach (var customer in customers)
+            {
+                Console.WriteLine($"{customer.Name} from {customer.City} with phone {customer.PhoneNumber}");
+            }
+        }
+    }
+
+    public static async Task Temporal_tables_with_owned_types()
+    {
+        PrintSampleName();
+
+        DateTime timeStamp1;
+        DateTime timeStamp2;
+        DateTime timeStamp3;
+        DateTime timeStamp4;
+
+        await using (var context = new EntitySplittingContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            await context.AddRangeAsync(
+                new Employee
+                {
+                    Name = "Pinky Pie",
+                    Info = new()
+                    {
+                        Address = "Sugarcube Corner, Ponyville, Equestria",
+                        Department = "DevDiv",
+                        Position = "Party Organizer",
+                        AnnualSalary = 100.0m
+                    }
+                },
+                new Employee
+                {
+                    Name = "Rainbow Dash",
+                    Info = new()
+                    {
+                        Address = "Cloudominium, Ponyville, Equestria",
+                        Department = "DevDiv",
+                        Position = "Ponyville weather patrol",
+                        AnnualSalary = 900.0m
+                    }
+                },
+                new Employee
+                {
+                    Name = "Fluttershy",
+                    Info = new()
+                    {
+                        Address = "Everfree Forest, Equestria",
+                        Department = "DevDiv",
+                        Position = "Animal caretaker",
+                        AnnualSalary = 30.0m
+                    }
+                });
+
+            await context.SaveChangesAsync();
+        }
+
+        await using (var context = new EntitySplittingContext())
+        {
+            Console.WriteLine();
+            Console.WriteLine("Starting data:");
+
+            var employees = await context.Employees.ToListAsync();
+            foreach (var employee in employees)
+            {
+                var employeeEntry = context.Entry(employee);
+                var periodStart = employeeEntry.Property<DateTime>("PeriodStart").CurrentValue;
+                var periodEnd = employeeEntry.Property<DateTime>("PeriodEnd").CurrentValue;
+
+                Console.WriteLine($"  Employee {employee.Name} valid from {periodStart} to {periodEnd}");
+            }
+        }
+
+        await using (var context = new EntitySplittingContext())
+        {
+            // Change the sleep values to emphasize the temporal nature of the data.
+            const int millisecondsDelay = 100;
+
+            Thread.Sleep(millisecondsDelay);
+            timeStamp1 = DateTime.UtcNow;
+            Thread.Sleep(millisecondsDelay);
+
+            var employee = await context.Employees.SingleAsync(e => e.Name == "Rainbow Dash");
+            employee.Info.Position = "Wonderbolt Trainee";
+            await context.SaveChangesAsync();
+
+            Thread.Sleep(millisecondsDelay);
+            timeStamp2 = DateTime.UtcNow;
+            Thread.Sleep(millisecondsDelay);
+
+            employee.Info.Position = "Wonderbolt Reservist";
+            await context.SaveChangesAsync();
+
+            Thread.Sleep(millisecondsDelay);
+            timeStamp3 = DateTime.UtcNow;
+            Thread.Sleep(millisecondsDelay);
+
+            employee.Info.Position = "Wonderbolt";
+            await context.SaveChangesAsync();
+
+            Thread.Sleep(millisecondsDelay);
+            timeStamp4 = DateTime.UtcNow;
+            Thread.Sleep(millisecondsDelay);
+        }
+
+        await using (var context = new EntitySplittingContext())
+        {
+            #region NormalQuery
+            var employee = await context.Employees.SingleAsync(e => e.Name == "Rainbow Dash");
+            context.Remove(employee);
+            await context.SaveChangesAsync();
+            #endregion
+        }
+
+        await using (var context = new EntitySplittingContext())
+        {
+            Console.WriteLine();
+            Console.WriteLine("After updates and delete:");
+
+            #region TrackingQuery
+            var employees = await context.Employees.ToListAsync();
+            foreach (var employee in employees)
+            {
+                var employeeEntry = context.Entry(employee);
+                var periodStart = employeeEntry.Property<DateTime>("PeriodStart").CurrentValue;
+                var periodEnd = employeeEntry.Property<DateTime>("PeriodEnd").CurrentValue;
+
+                Console.WriteLine($"  Employee {employee.Name} valid from {periodStart} to {periodEnd}");
+            }
+            #endregion
+
+            Console.WriteLine();
+            Console.WriteLine("Historical data for Rainbow Dash:");
+
+            #region TemporalAll
+            var history = await context
+                .Employees
+                .TemporalAll()
+                .Where(e => e.Name == "Rainbow Dash")
+                .OrderBy(e => EF.Property<DateTime>(e, "PeriodStart"))
+                .Select(
+                    e => new
+                    {
+                        Employee = e,
+                        PeriodStart = EF.Property<DateTime>(e, "PeriodStart"),
+                        PeriodEnd = EF.Property<DateTime>(e, "PeriodEnd")
+                    })
+                .ToListAsync();
+
+            foreach (var pointInTime in history)
+            {
+                Console.WriteLine(
+                    $"  Employee {pointInTime.Employee.Name} was '{pointInTime.Employee.Info.Position}' from {pointInTime.PeriodStart} to {pointInTime.PeriodEnd}");
+            }
+            #endregion
+        }
+
+        await using (var context = new EntitySplittingContext())
+        {
+            Console.WriteLine();
+            Console.WriteLine($"Historical data for Rainbow Dash between {timeStamp2} and {timeStamp3}:");
+
+            #region TemporalBetween
+            var history = await context
+                .Employees
+                .TemporalBetween(timeStamp2, timeStamp3)
+                .Where(e => e.Name == "Rainbow Dash")
+                .OrderBy(e => EF.Property<DateTime>(e, "PeriodStart"))
+                .Select(
+                    e => new
+                    {
+                        Employee = e,
+                        PeriodStart = EF.Property<DateTime>(e, "PeriodStart"),
+                        PeriodEnd = EF.Property<DateTime>(e, "PeriodEnd")
+                    })
+                .ToListAsync();
+            #endregion
+
+            foreach (var pointInTime in history)
+            {
+                Console.WriteLine(
+                    $"  Employee {pointInTime.Employee.Name} was '{pointInTime.Employee.Info.Position}' from {pointInTime.PeriodStart} to {pointInTime.PeriodEnd}");
+            }
+        }
+
+        await using (var context = new EntitySplittingContext())
+        {
+            Console.WriteLine();
+            Console.WriteLine($"Historical data for Rainbow Dash as of {timeStamp2}:");
+
+            var history = await context
+                .Employees
+                .TemporalAsOf(timeStamp2)
+                .Where(e => e.Name == "Rainbow Dash")
+                .OrderBy(e => EF.Property<DateTime>(e, "PeriodStart"))
+                .Select(
+                    e => new
+                    {
+                        Employee = e, PeriodStart = EF.Property<DateTime>(e, "PeriodStart"), PeriodEnd = EF.Property<DateTime>(e, "PeriodEnd")
+                    })
+                .ToListAsync();
+
+            foreach (var pointInTime in history)
+            {
+                Console.WriteLine(
+                    $"  Employee {pointInTime.Employee.Name} was '{pointInTime.Employee.Info.Position}' from {pointInTime.PeriodStart} to {pointInTime.PeriodEnd}");
+            }
+        }
+    }
+
+    public static async Task Unidirectional_many_to_many()
+    {
+        PrintSampleName();
+
+        await using var context = new BlogsContext();
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+
+        #region InsertPostsAndTags
+        var tags = new Tag[] { new() { TagName = "Tag1" }, new() { TagName = "Tag2" }, new() { TagName = "Tag2" }, };
+
+        await context.AddRangeAsync(new Blog { Posts =
+        {
+            new Post { Tags = { tags[0], tags[1] } },
+            new Post { Tags = { tags[1], tags[0], tags[2] } },
+            new Post()
+        } });
+
+        await context.SaveChangesAsync();
+        #endregion
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public class BlogsContext : DbContext
+    {
+        public DbSet<Blog> Blogs => Set<Blog>();
+        public DbSet<Post> Posts => Set<Post>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .UseSqlServer(@$"Server=(localdb)\mssqllocaldb;Database=Blogs;ConnectRetryCount=0")
+                .LogTo(Console.WriteLine, LogLevel.Information)
+                .EnableSensitiveDataLogging();
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region CompositeIndex
+            modelBuilder
+                .Entity<Blog>()
+                .HasIndex(blog => new { blog.Name, blog.Owner })
+                .IsDescending(false, true);
+            #endregion
+
+            #region TwoIndexes
+            modelBuilder
+                .Entity<Blog>()
+                .HasIndex(blog => new { blog.Name, blog.Owner }, "IX_Blogs_Name_Owner_1")
+                .IsDescending(false, true);
+
+            modelBuilder
+                .Entity<Blog>()
+                .HasIndex(blog => new { blog.Name, blog.Owner }, "IX_Blogs_Name_Owner_2")
+                .IsDescending(true, true);
+            #endregion
+
+            #region ManyToMany
+            modelBuilder
+                .Entity<Post>()
+                .HasMany(post => post.Tags)
+                .WithMany();
+            #endregion
+
+            #region Utf8
+            modelBuilder
+                .Entity<Comment>()
+                .Property(comment => comment.CommentText)
+                .HasColumnType("varchar(max)")
+                .UseCollation("LATIN1_GENERAL_100_CI_AS_SC_UTF8");
+            #endregion
+
+            base.OnModelCreating(modelBuilder);
+        }
+    }
+
+    #region CompositeIndexByAttribute
+    [Index(nameof(Name), nameof(Owner), IsDescending = new[] { false, true }, Name = "IX_Blogs_Name_Owner_1")]
+    [Index(nameof(Name), nameof(Owner), IsDescending = new[] { true, true }, Name = "IX_Blogs_Name_Owner_2")]
+    public class Blog
+    {
+        public int Id { get; set; }
+
+        [MaxLength(64)]
+        public string? Name { get; set; }
+
+        [MaxLength(64)]
+        public string? Owner { get; set; }
+
+        public List<Post> Posts { get; } = new();
+    }
+    #endregion
+
+    public class Post
+    {
+        public int Id { get; set; }
+
+        [MaxLength(64)]
+        public string? Title { get; set; }
+
+        [DeleteBehavior(DeleteBehavior.NoAction)]
+        public Blog Blog { get; set; } = null!;
+
+        public List<Tag> Tags { get; } = new();
+    }
+
+    #region CompositePrimaryKey
+    [PrimaryKey(nameof(PostId), nameof(CommentId))]
+    public class Comment
+    {
+        public int PostId { get; set; }
+        public int CommentId { get; set; }
+        public string CommentText { get; set; } = null!;
+    }
+    #endregion
+
+    #region Tag
+    public class Tag
+    {
+        public int Id { get; set; }
+        public string TagName { get; set; } = null!;
+    }
+    #endregion
+
+    public class AnimalsTptContext : DbContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .UseSqlServer(@$"Server=(localdb)\mssqllocaldb;Database=AnimalsTpt;ConnectRetryCount=0")
+                .LogTo(Console.WriteLine, LogLevel.Information)
+                .EnableSensitiveDataLogging();
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region AnimalsTpt
+            modelBuilder.Entity<Animal>().ToTable("Animals");
+
+            modelBuilder.Entity<Cat>()
+                .ToTable(
+                    "Cats",
+                    tableBuilder => tableBuilder.Property(cat => cat.Id).HasColumnName("CatId"));
+
+            modelBuilder.Entity<Dog>()
+                .ToTable(
+                    "Dogs",
+                    tableBuilder => tableBuilder.Property(dog => dog.Id).HasColumnName("DogId"));
+            #endregion
+        }
+    }
+
+    public class AnimalsTpcContext : DbContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .UseSqlServer(@$"Server=(localdb)\mssqllocaldb;Database=AnimalsTpc;ConnectRetryCount=0")
+                .LogTo(Console.WriteLine, LogLevel.Information)
+                .EnableSensitiveDataLogging();
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region AnimalsTpc
+            modelBuilder.Entity<Animal>().UseTpcMappingStrategy();
+
+            modelBuilder.Entity<Cat>()
+                .ToTable(
+                    "Cats",
+                    builder =>
+                    {
+                        builder.Property(cat => cat.Id).HasColumnName("CatId");
+                        builder.Property(cat => cat.Breed).HasColumnName("CatBreed");
+                    });
+
+            modelBuilder.Entity<Dog>()
+                .ToTable(
+                    "Dogs",
+                    builder =>
+                    {
+                        builder.Property(dog => dog.Id).HasColumnName("DogId");
+                        builder.Property(dog => dog.Breed).HasColumnName("DogBreed");
+                    });
+            #endregion
+        }
+    }
+
+    #region Animals
+    public abstract class Animal
+    {
+        public int Id { get; set; }
+        public string Breed { get; set; } = null!;
+    }
+
+    public class Cat : Animal
+    {
+        public string? EducationalLevel { get; set; }
+    }
+
+    public class Dog : Animal
+    {
+        public string? FavoriteToy { get; set; }
+    }
+    #endregion
+
+    public class EntitySplittingContext : DbContext
+    {
+        public DbSet<Customer> Customers
+            => Set<Customer>();
+
+        public DbSet<Employee> Employees
+            => Set<Employee>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .UseSqlServer(@$"Server=(localdb)\mssqllocaldb;Database=Images;ConnectRetryCount=0")
+                .LogTo(Console.WriteLine, LogLevel.Information)
+                .EnableSensitiveDataLogging();
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region EntitySplitting
+            modelBuilder.Entity<Customer>(
+                entityBuilder =>
+                {
+                    entityBuilder
+                        .ToTable("Customers")
+                        .SplitToTable(
+                            "PhoneNumbers",
+                            tableBuilder =>
+                            {
+                                tableBuilder.Property(customer => customer.Id).HasColumnName("CustomerId");
+                                tableBuilder.Property(customer => customer.PhoneNumber);
+                            })
+                        .SplitToTable(
+                            "Addresses",
+                            tableBuilder =>
+                            {
+                                tableBuilder.Property(customer => customer.Id).HasColumnName("CustomerId");
+                                tableBuilder.Property(customer => customer.Street);
+                                tableBuilder.Property(customer => customer.City);
+                                tableBuilder.Property(customer => customer.PostCode);
+                                tableBuilder.Property(customer => customer.Country);
+                            });
+                });
+            #endregion
+
+            #region LinkingForeignKey
+            modelBuilder.Entity<Customer>()
+                .HasOne<Customer>()
+                .WithOne()
+                .HasForeignKey<Customer>(a => a.Id)
+                .OnDelete(DeleteBehavior.Restrict);
+            #endregion
+
+            #region OwnedTemporalTable
+            modelBuilder
+                .Entity<Employee>()
+                .ToTable(
+                    "Employees",
+                    tableBuilder =>
+                    {
+                        tableBuilder.IsTemporal();
+                        tableBuilder.Property<DateTime>("PeriodStart").HasColumnName("PeriodStart");
+                        tableBuilder.Property<DateTime>("PeriodEnd").HasColumnName("PeriodEnd");
+                    })
+                .OwnsOne(
+                    employee => employee.Info,
+                    ownedBuilder => ownedBuilder.ToTable(
+                        "Employees",
+                        tableBuilder =>
+                        {
+                            tableBuilder.IsTemporal();
+                            tableBuilder.Property<DateTime>("PeriodStart").HasColumnName("PeriodStart");
+                            tableBuilder.Property<DateTime>("PeriodEnd").HasColumnName("PeriodEnd");
+                        }));
+            #endregion
+        }
+    }
+
+    #region CombinedCustomer
+    public class Customer
+    {
+        public Customer(string name, string street, string city, string? postCode, string country)
+        {
+            Name = name;
+            Street = street;
+            City = city;
+            PostCode = postCode;
+            Country = country;
+        }
+
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public string? PhoneNumber { get; set; }
+        public string Street { get; set; }
+        public string City { get; set; }
+        public string? PostCode { get; set; }
+        public string Country { get; set; }
+    }
+    #endregion
+
+    #region EmployeeAndEmployeeInfo
+    public class Employee
+    {
+        public Guid EmployeeId { get; set; }
+        public string Name { get; set; } = null!;
+
+        public EmployeeInfo Info { get; set; } = null!;
+    }
+
+    public class EmployeeInfo
+    {
+        public string Position { get; set; } = null!;
+        public string Department { get; set; } = null!;
+        public string? Address { get; set; }
+        public decimal? AnnualSalary { get; set; }
+    }
+    #endregion
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/NewInEFCore7.csproj b/samples/core/Miscellaneous/NewInEFCore7/NewInEFCore7.csproj
new file mode 100644
index 0000000000..f33979e55f
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/NewInEFCore7.csproj
@@ -0,0 +1,35 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net7.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <RootNamespace>NewInEfCore7</RootNamespace>
+    <NoWarn>$(NoWarn);NETSDK1138</NoWarn> <!-- The target framework 'net7.0' is out of support -->
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Cosmos" Version="7.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="7.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="7.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="7.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer.NetTopologySuite" Version="7.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.NetTopologySuite" Version="7.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.InMemory" Version="7.0.0" />
+    <PackageReference Include="Microsoft.Extensions.Logging.Console" Version="7.0.0" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <Using Include="System.ComponentModel.DataAnnotations" />
+    <Using Include="System.ComponentModel.DataAnnotations.Schema" />
+    <Using Include="System.Data.Common" />
+    <Using Include="System.Linq.Expressions" />
+    <Using Include="System.Reflection" />
+    <Using Include="System.Runtime.CompilerServices" />
+    <Using Include="Microsoft.EntityFrameworkCore" />
+    <Using Include="Microsoft.Extensions.Logging" />
+    <Using Include="Microsoft.Extensions.DependencyInjection" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/NewInEFCore7/Program.cs b/samples/core/Miscellaneous/NewInEFCore7/Program.cs
new file mode 100644
index 0000000000..ec587c479f
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/Program.cs
@@ -0,0 +1,82 @@
+using NewInEfCore7;
+
+public class Program
+{
+    public static async Task Main()
+    {
+        await TpcInheritanceSample.Inheritance_with_TPH();
+        await TpcInheritanceSample.Inheritance_with_TPT();
+        await TpcInheritanceSample.Inheritance_with_TPC();
+        await TpcInheritanceSample.Inheritance_with_TPC_using_HiLo();
+        await TpcInheritanceSample.Inheritance_with_TPC_using_Identity();
+
+        await ExecuteDeleteSample.ExecuteDelete();
+        await ExecuteDeleteSample.ExecuteDeleteTpt();
+        await ExecuteDeleteSample.ExecuteDeleteTpc();
+        await ExecuteDeleteSample.ExecuteDeleteSqlite();
+
+        await ExecuteUpdateSample.ExecuteUpdate();
+        await ExecuteUpdateSample.ExecuteUpdateTpt();
+        await ExecuteUpdateSample.ExecuteUpdateTpc();
+        await ExecuteUpdateSample.ExecuteUpdateSqlite();
+
+        await JsonColumnsSample.Json_columns_with_TPH();
+
+        await ModelBuildingConventionsSample.No_foreign_key_index_convention();
+        await ModelBuildingConventionsSample.Discriminator_length_convention();
+        await ModelBuildingConventionsSample.Max_string_length_convention();
+        await ModelBuildingConventionsSample.Map_members_explicitly_by_attribute_convention();
+        await ModelBuildingConventionsSample.Custom_model_validation_convention();
+        await ModelBuildingConventionsSample.No_cascade_delete_convention();
+
+        await StoredProcedureMappingSample.Insert_Update_and_Delete_using_stored_procedures_with_TPH();
+        await StoredProcedureMappingSample.Insert_Update_and_Delete_using_stored_procedures_with_TPT();
+        await StoredProcedureMappingSample.Insert_Update_and_Delete_using_stored_procedures_with_TPC();
+
+        await SimpleMaterializationSample.Simple_actions_on_entity_creation();
+
+        await UngroupedColumnsQuerySample.Subqueries_dont_reference_ungrouped_columns_from_outer_query_SqlServer();
+
+        await GroupByEntityTypeSample.GroupBy_entity_type_Sqlite();
+        await GroupByEntityTypeSample.GroupBy_entity_type_SqlServer();
+        await GroupByEntityTypeSample.GroupBy_entity_type_InMemory();
+
+        await GroupByFinalOperatorSample.GroupBy_final_operator_SqlServer();
+        await GroupByFinalOperatorSample.GroupBy_final_operator_Sqlite();
+
+        await GroupJoinFinalOperatorSample.GroupJoin_final_operator_SqlServer();
+        await GroupJoinFinalOperatorSample.GroupJoin_final_operator_InMemory();
+
+        await ReadOnlySetQuerySample.Use_Contains_with_IReadOnlySet_SqlServer();
+        await ReadOnlySetQuerySample.Use_Contains_with_IReadOnlySet_Sqlite();
+        await ReadOnlySetQuerySample.Use_Contains_with_IReadOnlySet_InMemory();
+
+        await StringAggregateFunctionsSample.Translate_string_Concat_and_string_Join();
+
+        await SpatialAggregateFunctionsSample.Translate_spatial_aggregate_functions_SqlServer();
+        await SpatialAggregateFunctionsSample.Translate_spatial_aggregate_functions_InMemory();
+
+        await StatisticalAggregateFunctionsSample.Translate_statistical_aggregate_functions();
+
+        await MiscellaneousTranslationsSample.Translate_string_IndexOf();
+
+        await SaveChangesPerformanceSample.SaveChanges_SQL_generation_samples_SqlServer();
+        await SaveChangesPerformanceSample.SaveChanges_SQL_generation_samples_Sqlite();
+
+        await DbContextApiSample.Find_siblings();
+        await DbContextApiSample.Get_entry_for_shared_type_entity_type();
+        await DbContextApiSample.Use_IEntityEntryGraphIterator();
+
+        await ModelBuildingSample.Indexes_can_be_ordered();
+        await ModelBuildingSample.Property_can_be_mapped_to_different_column_names_TPT();
+        await ModelBuildingSample.Property_can_be_mapped_to_different_column_names_TPC();
+        await ModelBuildingSample.Unidirectional_many_to_many();
+        await ModelBuildingSample.Entity_splitting();
+        await ModelBuildingSample.Temporal_tables_with_owned_types();
+
+        await ValueGenerationSample.Can_use_value_generation_with_converted_types();
+
+        // // Requires the Cosmos emulator
+        // await CosmosQueriesSample.Cosmos_translations_for_RegEx_Match();
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/ReadOnlySetQuerySample.cs b/samples/core/Miscellaneous/NewInEFCore7/ReadOnlySetQuerySample.cs
new file mode 100644
index 0000000000..7423cce829
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/ReadOnlySetQuerySample.cs
@@ -0,0 +1,171 @@
+using System.Collections.ObjectModel;
+
+namespace NewInEfCore7;
+
+public static class ReadOnlySetQuerySample
+{
+    public static Task Use_Contains_with_IReadOnlySet_SqlServer()
+    {
+        PrintSampleName();
+        return QueryTest<ReadOnlySetContextSqlServer>();
+    }
+
+    public static Task Use_Contains_with_IReadOnlySet_Sqlite()
+    {
+        PrintSampleName();
+        return QueryTest<ReadOnlySetContextSqlite>();
+    }
+
+    public static Task Use_Contains_with_IReadOnlySet_InMemory()
+    {
+        PrintSampleName();
+        return QueryTest<ReadOnlySetContextInMemory>();
+    }
+
+    private static async Task QueryTest<TContext>()
+        where TContext : ReadOnlySetContext, new()
+    {
+        await using (var context = new TContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            var toast = new Customer1 { Name = "Toast" };
+            var alice = new Customer2 { Name = "Alice" };
+            var mac = new Customer3 { Name = "Mac" };
+
+            await context.AddRangeAsync(
+                new Order { Customer1 = toast, Customer2 = alice, Customer3 = mac, Amount = 10 },
+                new Order { Customer1 = toast, Customer2 = alice, Customer3 = mac, Amount = 10 },
+                new Order { Customer1 = toast, Customer2 = alice, Customer3 = mac, Amount = 12 },
+                new Order { Customer1 = toast, Customer2 = alice, Customer3 = mac, Amount = 12 },
+                new Order { Customer1 = toast, Customer2 = alice, Customer3 = mac, Amount = 14 });
+
+            await context.SaveChangesAsync();
+        }
+
+        await using (var context = new TContext())
+        {
+            #region ReadOnlySetQuery
+            IReadOnlySet<int> searchIds = new HashSet<int> { 1, 3, 5 };
+            var query = context.Customers.Where(p => p.Orders.Any(l => searchIds.Contains(l.Id)));
+            #endregion
+
+            await foreach (var customer in query.AsAsyncEnumerable())
+            {
+                Console.WriteLine($"Customer: {customer.Name}");
+            }
+        }
+
+        await using (var context = new TContext())
+        {
+            IReadOnlyCollection<int> searchIds = new ReadOnlyCollection<int>(new Collection<int> { 1, 3, 5 });
+            var query = context.Customers.Where(p => p.Orders.Any(l => searchIds.Contains(l.Id)));
+
+            await foreach (var customer in query.AsAsyncEnumerable())
+            {
+                Console.WriteLine($"Customer: {customer.Name}");
+            }
+        }
+
+        await using (var context = new TContext())
+        {
+            var searchIds = new ReadOnlyCollection<int>(new Collection<int> { 1, 3, 5 });
+            var query = context.Customer2s.Where(p => p.Orders.Any(l => searchIds.Contains(l.Id)));
+
+            await foreach (var customer in query.AsAsyncEnumerable())
+            {
+                Console.WriteLine($"Customer: {customer.Name}");
+            }
+        }
+
+        await using (var context = new TContext())
+        {
+            IReadOnlyList<int> searchIds = new List<int> { 1, 3, 5 };
+            var query = context.Customer3s.Where(p => p.Orders.Any(l => searchIds.Contains(l.Id)));
+
+            await foreach (var customer in query.AsAsyncEnumerable())
+            {
+                Console.WriteLine($"Customer: {customer.Name}");
+            }
+        }
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public abstract class ReadOnlySetContext : DbContext
+    {
+        public DbSet<Customer1> Customers => Set<Customer1>();
+        public DbSet<Customer2> Customer2s => Set<Customer2>();
+        public DbSet<Customer3> Customer3s => Set<Customer3>();
+        public DbSet<Order> Orders => Set<Order>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .LogTo(Console.WriteLine, LogLevel.Information)
+                .EnableSensitiveDataLogging();
+    }
+
+    public class ReadOnlySetContextSqlServer : ReadOnlySetContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => base.OnConfiguring(
+                optionsBuilder.UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Customers;ConnectRetryCount=0"));
+    }
+
+    public class ReadOnlySetContextSqlite : ReadOnlySetContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => base.OnConfiguring(
+                optionsBuilder.UseSqlite("Data Source = customers.db"));
+    }
+
+    public class ReadOnlySetContextInMemory : ReadOnlySetContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => base.OnConfiguring(
+                optionsBuilder.UseInMemoryDatabase(nameof(ReadOnlySetContextInMemory)));
+    }
+
+    public class Customer1
+    {
+        public int Id { get; set; }
+        public string Name { get; set; } = default!;
+        public IReadOnlySet<Order> Orders { get; } = new HashSet<Order>();
+    }
+
+    public class Customer2
+    {
+        public int Id { get; set; }
+        public string Name { get; set; } = default!;
+        public IReadOnlyCollection<Order> Orders { get; } = new HashSet<Order>();
+    }
+
+    public class Customer3
+    {
+        public int Id { get; set; }
+        public string Name { get; set; } = default!;
+        public IReadOnlyList<Order> Orders { get; } = new List<Order>();
+    }
+
+    public class Order
+    {
+        public int Id { get; set; }
+
+        public int? Customer1Id { get; set; }
+        public Customer1? Customer1 { get; set; }
+
+        public int Customer2Id { get; set; }
+        public Customer2 Customer2 { get; set; } = null!;
+
+        public int Customer3Id { get; set; }
+        public Customer3 Customer3 { get; set; } = null!;
+
+        [Precision(18, 2)]
+        public decimal Amount { get; set; }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/SaveChangesPerformanceSample.cs b/samples/core/Miscellaneous/NewInEFCore7/SaveChangesPerformanceSample.cs
new file mode 100644
index 0000000000..2daca432ff
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/SaveChangesPerformanceSample.cs
@@ -0,0 +1,180 @@
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace NewInEfCore7;
+
+public static class SaveChangesPerformanceSample
+{
+    public static Task SaveChanges_SQL_generation_samples_SqlServer()
+    {
+        PrintSampleName();
+        return SaveChangesTest<PerfContextSqlServer>();
+    }
+
+    public static Task SaveChanges_SQL_generation_samples_Sqlite()
+    {
+        PrintSampleName();
+        return SaveChangesTest<PerfContextSqlite>();
+    }
+
+    private static async Task SaveChangesTest<TContext>()
+        where TContext : PerfContext, new()
+    {
+        await using (var context = new TContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            if (context.Database.IsSqlServer())
+            {
+                context.Database.ExecuteSqlRaw(
+                    @"
+CREATE TRIGGER TRG_InsertUpdateBlog
+ON BlogsWithTriggers
+AFTER INSERT, UPDATE AS
+BEGIN
+	IF @@ROWCOUNT = 0
+		return
+	SET nocount on;
+
+    UPDATE BlogsWithTriggers set StoreUpdated = StoreUpdated + 1
+    WHERE Id IN(SELECT INSERTED.Id FROM INSERTED);
+END");
+            }
+        }
+
+        await using (var context = new TContext())
+        {
+            #region SimpleInsert
+            await context.AddAsync(new Blog { Name = "MyBlog" });
+            await context.SaveChangesAsync();
+            #endregion
+        }
+
+        await using (var context = new TContext())
+        {
+            #region MultipleInsert
+            for (var i = 0; i < 4; i++)
+            {
+                await context.AddAsync(new Blog { Name = "Foo" + i });
+            }
+
+            await context.SaveChangesAsync();
+            #endregion
+        }
+
+        await using (var context = new TContext())
+        {
+            await context.AddAsync(new BlogWithTrigger { Name = "MyBlog" });
+            await context.SaveChangesAsync();
+        }
+
+        await using (var context = new TContext())
+        {
+            for (var i = 0; i < 4; i++)
+            {
+                await context.AddAsync(new BlogWithTrigger { Name = "Foo" + i });
+            }
+
+            await context.SaveChangesAsync();
+        }
+
+        await using (var context = new TContext())
+        {
+            #region InsertGraph
+            await context.AddAsync(
+                new Blog { Name = "MyBlog", Posts = { new() { Title = "My first post" }, new() { Title = "My second post" } } });
+            await context.SaveChangesAsync();
+            #endregion
+        }
+
+        await using (var context = new TContext())
+        {
+            #region InsertGraph
+            await context.AddAsync(
+                new Blog { Name = "MyBlog", Posts = { new() { Title = "My first post" }, new() { Title = "My second post" } } });
+            await context.SaveChangesAsync();
+            #endregion
+        }
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public abstract class PerfContext : DbContext
+    {
+        public DbSet<Blog> Blogs => Set<Blog>();
+        public DbSet<Post> Posts => Set<Post>();
+        public DbSet<BlogWithTrigger> BlogsWithTriggers => Set<BlogWithTrigger>();
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder
+                .Entity<BlogWithTrigger>()
+                .Property(e => e.StoreUpdated)
+                .HasDefaultValue(0)
+                .ValueGeneratedOnAddOrUpdate();
+
+            if (Database.IsSqlServer())
+            {
+                #region HasTrigger
+                modelBuilder
+                    .Entity<BlogWithTrigger>()
+                    .ToTable(tb => tb.HasTrigger("TRG_InsertUpdateBlog"));
+                #endregion
+
+                #region UseHiLo
+                modelBuilder.Entity<Blog>().Property(e => e.Id).UseHiLo();
+                modelBuilder.Entity<Post>().Property(e => e.Id).UseHiLo();
+                #endregion
+            }
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .LogTo(
+                    Console.WriteLine,
+                    new[]
+                    {
+                        RelationalEventId.CommandExecuted, RelationalEventId.TransactionStarted, RelationalEventId.TransactionCommitted
+                    })
+                .EnableSensitiveDataLogging();
+    }
+
+    public class PerfContextSqlServer : PerfContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => base.OnConfiguring(
+                optionsBuilder.UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=SaveChangesPerf;ConnectRetryCount=0"));
+    }
+
+    public class PerfContextSqlite : PerfContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => base.OnConfiguring(
+                optionsBuilder.UseSqlite("Data Source = savechangesperf.db"));
+    }
+
+    public class Blog
+    {
+        public int Id { get; set; }
+        public string Name { get; set; } = default!;
+        public List<Post> Posts { get; } = new();
+    }
+
+    public class Post
+    {
+        public int Id { get; set; }
+        public string Title { get; set; } = default!;
+        public Blog Blog { get; set; } = default!;
+    }
+
+    public class BlogWithTrigger
+    {
+        public int Id { get; set; }
+        public string Name { get; set; } = default!;
+        public virtual int StoreUpdated { get; set; }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/SimpleMaterializationSample.cs b/samples/core/Miscellaneous/NewInEFCore7/SimpleMaterializationSample.cs
new file mode 100644
index 0000000000..fb1f8b2e82
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/SimpleMaterializationSample.cs
@@ -0,0 +1,86 @@
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace NewInEfCore7;
+
+public static class SimpleMaterializationSample
+{
+    public static async Task Simple_actions_on_entity_creation()
+    {
+        PrintSampleName();
+
+        await using (var context = new CustomerContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            await context.AddRangeAsync(
+                new Customer { Name = "Alice", PhoneNumber = "+1 515 555 0123" },
+                new Customer { Name = "Mac", PhoneNumber = "+1 515 555 0124" });
+
+            await context.SaveChangesAsync();
+        }
+
+        #region QueryCustomer
+        await using (var context = new CustomerContext())
+        {
+            var customer = await context.Customers.SingleAsync(e => e.Name == "Alice");
+            Console.WriteLine($"Customer '{customer.Name}' was retrieved at '{customer.Retrieved.ToLocalTime()}'");
+        }
+        #endregion
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    #region CustomerContext
+    public class CustomerContext : DbContext
+    {
+        private static readonly SetRetrievedInterceptor _setRetrievedInterceptor = new();
+
+        public DbSet<Customer> Customers
+            => Set<Customer>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .AddInterceptors(_setRetrievedInterceptor)
+                .UseSqlite("Data Source = customers.db");
+    }
+    #endregion
+
+    #region SetRetrievedInterceptor
+    public class SetRetrievedInterceptor : IMaterializationInterceptor
+    {
+        public object InitializedInstance(MaterializationInterceptionData materializationData, object instance)
+        {
+            if (instance is IHasRetrieved hasRetrieved)
+            {
+                hasRetrieved.Retrieved = DateTime.UtcNow;
+            }
+
+            return instance;
+        }
+    }
+    #endregion
+
+    #region IHasRetrieved
+    public interface IHasRetrieved
+    {
+        DateTime Retrieved { get; set; }
+    }
+    #endregion
+
+    #region Customer
+    public class Customer : IHasRetrieved
+    {
+        public int Id { get; set; }
+        public string Name { get; set; } = null!;
+        public string? PhoneNumber { get; set; }
+
+        [NotMapped]
+        public DateTime Retrieved { get; set; }
+    }
+    #endregion
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/SpatialAggregateFunctionsSample.cs b/samples/core/Miscellaneous/NewInEFCore7/SpatialAggregateFunctionsSample.cs
new file mode 100644
index 0000000000..77732fb353
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/SpatialAggregateFunctionsSample.cs
@@ -0,0 +1,179 @@
+using NetTopologySuite.Algorithm;
+using NetTopologySuite.Geometries;
+using NetTopologySuite.Geometries.Utilities;
+using NetTopologySuite.Operation.Union;
+
+namespace NewInEfCore7;
+
+public static class SpatialAggregateFunctionsSample
+{
+    public static Task Translate_spatial_aggregate_functions_SqlServer()
+    {
+        PrintSampleName();
+        return QueryTest<GeoCacheContextSqlServer>();
+    }
+
+    public static Task Translate_spatial_aggregate_functions_Sqlite()
+    {
+        PrintSampleName();
+        return QueryTest<GeoCacheContextSqlite>();
+    }
+
+    public static Task Translate_spatial_aggregate_functions_InMemory()
+    {
+        PrintSampleName();
+        return QueryTest<GeoCacheContextInMemory>();
+    }
+
+    private static async Task QueryTest<TContext>()
+        where TContext : GeoCacheContext, new()
+    {
+        await using (var context = new TContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            await context.AddRangeAsync(
+                new GeoCache
+                {
+                    Name = "Sandpiper Cache", Owner = "Nilwob Inc.", Location = new Point(-93.71855, 41.760783) { SRID = 4326 }
+                },
+                new GeoCache
+                {
+                    Name = "Paddy's Pot-O-Gold", Owner = "Nilwob Inc.", Location = new Point(-93.733633, 41.775633) { SRID = 4326 }
+                },
+                new GeoCache { Name = "Blazing Beacon", Owner = "The Spokes", Location = new Point(-1.606483, 55.392433) { SRID = 4326 } },
+                new GeoCache
+                {
+                    Name = "133 Steps to Relaxation",
+                    Owner = "Team isuforester",
+                    Location = new Point(-93.854733, 41.9389) { SRID = 4326 }
+                },
+                new EuclideanPoint { Name = "A", Point = new Point(1.0, 1.0) },
+                new EuclideanPoint { Name = "A", Point = new Point(1.0, 2.0) },
+                new EuclideanPoint { Name = "B", Point = new Point(2.0, 1.0) },
+                new EuclideanPoint { Name = "B", Point = new Point(2.0, 2.0) });
+
+            await context.SaveChangesAsync();
+        }
+
+        await using (var context = new TContext())
+        {
+            #region GeometryCombinerCombine
+            var query = context.Caches
+                .Where(cache => cache.Location.X < -90)
+                .GroupBy(cache => cache.Owner)
+                .Select(
+                    grouping => new { Id = grouping.Key, Combined = GeometryCombiner.Combine(grouping.Select(cache => cache.Location)) });
+            #endregion
+
+            await foreach (var group in query.AsAsyncEnumerable())
+            {
+                Console.WriteLine(group);
+            }
+        }
+
+        await using (var context = new TContext())
+        {
+            var query = context.Caches
+                .Where(cache => cache.Location.X < -90)
+                .GroupBy(cache => cache.Owner)
+                .Select(grouping => new { Id = grouping.Key, ConvexHull = ConvexHull.Create(grouping.Select(cache => cache.Location)) });
+
+            await foreach (var group in query.AsAsyncEnumerable())
+            {
+                Console.WriteLine(group);
+            }
+        }
+
+        await using (var context = new TContext())
+        {
+            var query = context.Caches
+                .Where(cache => cache.Location.X < -90)
+                .GroupBy(cache => cache.Owner)
+                .Select(grouping => new { Id = grouping.Key, Union = UnaryUnionOp.Union(grouping.Select(cache => cache.Location)) });
+
+            await foreach (var group in query.AsAsyncEnumerable())
+            {
+                Console.WriteLine(group);
+            }
+        }
+
+        await using (var context = new TContext())
+        {
+            var query = context.Points
+                .GroupBy(point => point.Name)
+                .Select(
+                    grouping => new
+                    {
+                        Id = grouping.Key, Combined = EnvelopeCombiner.CombineAsGeometry(grouping.Select(point => point.Point))
+                    });
+
+            await foreach (var group in query.AsAsyncEnumerable())
+            {
+                Console.WriteLine(group);
+            }
+        }
+
+        Console.WriteLine();
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public abstract class GeoCacheContext : DbContext
+    {
+        public DbSet<GeoCache> Caches => Set<GeoCache>();
+        public DbSet<EuclideanPoint> Points => Set<EuclideanPoint>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .LogTo(Console.WriteLine, LogLevel.Information)
+                .EnableSensitiveDataLogging();
+    }
+
+    public class GeoCacheContextSqlServer : GeoCacheContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => base.OnConfiguring(
+                optionsBuilder.UseSqlServer(
+                    @"Server=(localdb)\mssqllocaldb;Database=GeoCaches",
+                    b => b.UseNetTopologySuite()));
+    }
+
+    public class GeoCacheContextSqlite : GeoCacheContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => base.OnConfiguring(
+                optionsBuilder.UseSqlite(
+                    "Data Source = geocaches.db",
+                    b => b.UseNetTopologySuite()));
+    }
+
+    public class GeoCacheContextInMemory : GeoCacheContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => base.OnConfiguring(
+                optionsBuilder.UseInMemoryDatabase(nameof(GeoCacheContextInMemory)));
+    }
+
+    public class GeoCache
+    {
+        public int Id { get; set; }
+        public string? Owner { get; set; }
+        public string Name { get; set; } = null!;
+        public Point Location { get; set; } = null!;
+    }
+
+    public class EuclideanPoint
+    {
+        public int Id { get; set; }
+        public string Name { get; set; } = null!;
+
+        [Column(TypeName = "geometry")]
+        public Point Point { get; set; } = null!;
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/StatisticalAggregateFunctionsSample.cs b/samples/core/Miscellaneous/NewInEFCore7/StatisticalAggregateFunctionsSample.cs
new file mode 100644
index 0000000000..9bd247f1b7
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/StatisticalAggregateFunctionsSample.cs
@@ -0,0 +1,81 @@
+namespace NewInEfCore7;
+
+public static class StatisticalAggregateFunctionsSample
+{
+    public static async Task Translate_statistical_aggregate_functions()
+    {
+        PrintSampleName();
+
+        await using (var context = new StatisticsContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            var toast = new Uploader { Name = "Toast" };
+            var alice = new Uploader { Name = "Alice" };
+
+            await context.AddRangeAsync(
+                new Download { Uploader = alice, DownloadCount = 1024 },
+                new Download { Uploader = alice, DownloadCount = 2048 },
+                new Download { Uploader = toast, DownloadCount = 4096 },
+                new Download { Uploader = toast, DownloadCount = 8192 },
+                new Download { Uploader = toast, DownloadCount = 16384 });
+
+            await context.SaveChangesAsync();
+
+            #region StatsForAll
+            var query = context.Downloads
+                .GroupBy(download => download.Uploader.Id)
+                .Select(
+                    grouping => new
+                    {
+                        Author = grouping.Key,
+                        TotalCost = grouping.Sum(d => d.DownloadCount),
+                        AverageViews = grouping.Average(d => d.DownloadCount),
+                        VariancePopulation = EF.Functions.VariancePopulation(grouping.Select(d => d.DownloadCount)),
+                        VarianceSample = EF.Functions.VarianceSample(grouping.Select(d => d.DownloadCount)),
+                        StandardDeviationPopulation = EF.Functions.StandardDeviationPopulation(grouping.Select(d => d.DownloadCount)),
+                        StandardDeviationSample = EF.Functions.StandardDeviationSample(grouping.Select(d => d.DownloadCount))
+                    });
+            #endregion
+
+            await foreach (var group in query.AsAsyncEnumerable())
+            {
+                Console.WriteLine(group);
+            }
+        }
+
+        Console.WriteLine();
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public class StatisticsContext : DbContext
+    {
+        public DbSet<Download> Downloads => Set<Download>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Downloads;ConnectRetryCount=0")
+                .LogTo(Console.WriteLine, LogLevel.Information)
+                .EnableSensitiveDataLogging();
+    }
+
+    public class Uploader
+    {
+        public int Id { get; set; }
+        public string Name { get; set; } = default!;
+        public ICollection<Download> Downloads { get; } = new List<Download>();
+    }
+
+    public class Download
+    {
+        public int Id { get; set; }
+        public Uploader Uploader { get; set; } = default!;
+        public int DownloadCount { get; set; }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/StoredProcedureMappingSample.cs b/samples/core/Miscellaneous/NewInEFCore7/StoredProcedureMappingSample.cs
new file mode 100644
index 0000000000..a70bce9403
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/StoredProcedureMappingSample.cs
@@ -0,0 +1,153 @@
+namespace NewInEfCore7;
+
+public static class StoredProcedureMappingSample
+{
+    public static Task Insert_Update_and_Delete_using_stored_procedures_with_TPH()
+    {
+        PrintSampleName();
+        return SprocMappingTest<TphDocumentsContext>();
+    }
+
+    public static Task Insert_Update_and_Delete_using_stored_procedures_with_TPT()
+    {
+        PrintSampleName();
+        return SprocMappingTest<TptDocumentsContext>();
+    }
+
+    public static Task Insert_Update_and_Delete_using_stored_procedures_with_TPC()
+    {
+        PrintSampleName();
+        return SprocMappingTest<TpcDocumentsContext>();
+    }
+
+    private static async Task SprocMappingTest<TContext>()
+        where TContext : DocumentsContext, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        context.LoggingEnabled = true;
+
+        Console.WriteLine("Creating database tables...");
+        Console.WriteLine();
+
+        await context.Database.EnsureCreatedAsync();
+
+        Console.WriteLine();
+        Console.WriteLine("Creating stored procedures...");
+        Console.WriteLine();
+
+        await context.CreateStoredProcedures();
+
+        context.LoggingEnabled = true;
+
+        Console.WriteLine();
+        Console.WriteLine("Seeding the database...");
+        Console.WriteLine();
+
+        await context.Seed();
+        context.ChangeTracker.Clear();
+
+        Console.WriteLine();
+        Console.WriteLine("Loading data...");
+        Console.WriteLine();
+
+        await context.Documents
+            .Include(document => ((Book)document).Authors)
+            .Include(document => ((Magazine)document).Editor)
+            .LoadAsync();
+
+        Console.WriteLine();
+        Console.WriteLine("Updating data...");
+        Console.WriteLine();
+
+        context.RemoveRange(context.People.Local.Where(person => person.Contact.Address.City == "Chigley"));
+        context.RemoveRange(context.Magazines.Local.Where(magazine => magazine.Title.Contains("Amstrad")));
+        context.RemoveRange(context.Books.Local.Where(book => book.NumberOfPages < 200));
+
+        foreach (var magazine in context.Magazines.Local)
+        {
+            magazine.CoverPrice += 1.0m;
+        }
+
+        foreach (var book in context.Books.Local)
+        {
+            book.Title += " (New Edition!)";
+        }
+
+        foreach (var person in context.People.Local.Where(person => person.Contact.Address.Country == "UK"))
+        {
+            person.Name = "Dr. " + person.Name;
+            person.Contact.Phone = "+44 " + person.Contact.Phone!.Substring(1);
+            person.Contact.Address.Country = "United Kingdom";
+        }
+
+        context.ChangeTracker.DetectChanges();
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+        Console.WriteLine("Optimistic concurrency test 1...");
+        Console.WriteLine();
+
+        try
+        {
+            await using var context2 = new TContext();
+            (await context2.Books.SingleAsync(book => book.Title.StartsWith("Test"))).Isbn = "Mod1";
+
+            context.Books.Local.Single(book => book.Title.StartsWith("Test", StringComparison.Ordinal)).Isbn = null;
+            context.ChangeTracker.DetectChanges();
+            await context.SaveChangesAsync();
+
+            await context2.SaveChangesAsync();
+        }
+        catch (DbUpdateConcurrencyException exception)
+        {
+            Console.WriteLine($"Caught expected: {exception.Message}");
+        }
+
+        Console.WriteLine();
+        Console.WriteLine("Optimistic concurrency test 2...");
+        Console.WriteLine();
+
+        try
+        {
+            await using var context2 = new TContext();
+            (await context2.People.SingleAsync(person => person.Name.StartsWith("Dr. Kent"))).Name += ": Legend!";
+
+            context.People.Local.Single(person => person.Name.StartsWith("Dr. Kent", StringComparison.Ordinal)).Name += ": Hero!";
+            await context.SaveChangesAsync();
+
+            await context2.SaveChangesAsync();
+        }
+        catch (DbUpdateConcurrencyException exception)
+        {
+            Console.WriteLine($"Caught expected: {exception.Message}");
+        }
+
+        Console.WriteLine();
+        Console.WriteLine("Optimistic concurrency test 3...");
+        Console.WriteLine();
+
+        try
+        {
+            await using var context2 = new TContext();
+            (await context2.People.SingleAsync(person => person.Name.StartsWith("Dr. Kent"))).PublishedWorks.Clear();
+
+            context.People.Local.Single(person => person.Name.StartsWith("Dr. Kent", StringComparison.Ordinal)).PublishedWorks.Clear();
+            await context.SaveChangesAsync();
+
+            await context2.SaveChangesAsync();
+        }
+        catch (DbUpdateConcurrencyException exception)
+        {
+            Console.WriteLine($"Caught expected: {exception.Message}");
+        }
+
+        Console.WriteLine();
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/StringAggregateFunctionsSample.cs b/samples/core/Miscellaneous/NewInEFCore7/StringAggregateFunctionsSample.cs
new file mode 100644
index 0000000000..f7016ea4a5
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/StringAggregateFunctionsSample.cs
@@ -0,0 +1,72 @@
+namespace NewInEfCore7;
+
+public static class StringAggregateFunctionsSample
+{
+    public static async Task Translate_string_Concat_and_string_Join()
+    {
+        PrintSampleName();
+
+        await using (var context = new BlogsContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+            await context.Seed();
+            context.ChangeTracker.Clear();
+            context.LoggingEnabled = true;
+
+            #region Join
+            var query = context.Posts
+                .GroupBy(post => post.Author)
+                .Select(grouping => new { Author = grouping.Key, Books = string.Join("|", grouping.Select(post => post.Title)) });
+            #endregion
+
+            await foreach (var author in query.AsAsyncEnumerable())
+            {
+                Console.WriteLine($"{author}");
+            }
+
+            Console.WriteLine();
+        }
+
+        await using (var context = new BlogsContext { LoggingEnabled = true })
+        {
+            #region ConcatAndJoin
+            var query = context.Posts
+                .GroupBy(post => post.Author!.Name)
+                .Select(
+                    grouping =>
+                        new
+                        {
+                            PostAuthor = grouping.Key,
+                            Blogs = string.Concat(
+                                grouping
+                                    .Select(post => post.Blog.Name)
+                                    .Distinct()
+                                    .Select(postName => "'" + postName + "' ")),
+                            ContentSummaries = string.Join(
+                                " | ",
+                                grouping
+                                    .Where(post => post.Content.Length >= 10)
+                                    .Select(post => "'" + post.Content.Substring(0, 10) + "' "))
+                        });
+            #endregion
+
+            await foreach (var author in query.AsAsyncEnumerable())
+            {
+                Console.WriteLine($"{author}");
+            }
+
+            Console.WriteLine();
+        }
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public class BlogsContext : ModelBuildingBlogsContextBase
+    {
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/TpcInheritanceSample.cs b/samples/core/Miscellaneous/NewInEFCore7/TpcInheritanceSample.cs
new file mode 100644
index 0000000000..436316a1a0
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/TpcInheritanceSample.cs
@@ -0,0 +1,433 @@
+namespace NewInEfCore7;
+
+public static class TpcInheritanceSample
+{
+    public static Task Inheritance_with_TPH()
+    {
+        PrintSampleName();
+        return ManyToManyTest<TphAnimalsContext>();
+    }
+
+    public static Task Inheritance_with_TPT()
+    {
+        PrintSampleName();
+        return ManyToManyTest<TptAnimalsContext>();
+    }
+
+    public static Task Inheritance_with_TPC()
+    {
+        PrintSampleName();
+        return ManyToManyTest<TpcAnimalsContext>();
+    }
+
+    public static Task Inheritance_with_TPC_using_HiLo()
+    {
+        PrintSampleName();
+        return ManyToManyTest<TpcHiLoAnimalsContext>();
+    }
+
+    public static Task Inheritance_with_TPC_using_Identity()
+    {
+        PrintSampleName();
+        return ManyToManyTest<TpcIdentityAnimalsContext>();
+    }
+
+    public static async Task ManyToManyTest<TContext>()
+        where TContext : AnimalsContext, new()
+    {
+        using (var context = new TContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+
+            Console.WriteLine(context.Model.ToDebugString());
+            Console.WriteLine();
+
+            await context.Database.EnsureCreatedAsync();
+
+            var catFood = new PetFood("Lily's Kitchen", LifeStage.Adult);
+            var dogFood = new PetFood("Canagan", LifeStage.Adult);
+            var hay = new FarmFood("Hay");
+            var sushi = new HumanFood("Sushi", 670);
+
+            var arthur = new Human("Arthur") { Food = sushi };
+            var wendy = new Human("Wendy");
+            var christi = new Human("Christi");
+
+            var alice = new Cat("Alice", "MBA") { Vet = "Pengelly", Food = catFood, Humans = { arthur, wendy } };
+
+            var mac = new Cat("Mac", "Preschool") { Vet = "Pengelly", Food = catFood, Humans = { arthur, wendy } };
+
+            var toast = new Dog("Toast", "Mr. Squirrel") { Vet = "Pengelly", Food = dogFood, Humans = { arthur, wendy } };
+
+            var clyde = new FarmAnimal("Clyde", "Equus africanus asinus") { Value = 100.0m, Food = hay };
+
+            wendy.FavoriteAnimal = toast;
+            arthur.FavoriteAnimal = alice;
+            christi.FavoriteAnimal = clyde;
+
+            await context.AddRangeAsync(wendy, arthur, christi, alice, mac, toast, clyde);
+            await context.SaveChangesAsync();
+        }
+
+        Console.WriteLine();
+
+        using (var context = new TContext())
+        {
+            Console.WriteLine("All foods:");
+            foreach (var food in await context.Foods.ToListAsync())
+            {
+                Console.WriteLine($"  >> {food}");
+            }
+
+            Console.WriteLine();
+
+            Console.WriteLine("All animals:");
+            foreach (var animal in await context.Animals.ToListAsync())
+            {
+                Console.WriteLine($"  >> {animal}");
+            }
+
+            Console.WriteLine();
+
+            Console.WriteLine("Only pets:");
+            foreach (var pet in await context.Pets.ToListAsync())
+            {
+                Console.WriteLine($"  >> {pet}");
+            }
+
+            Console.WriteLine();
+
+            Console.WriteLine("Only cats:");
+            foreach (var cat in await context.Cats.ToListAsync())
+            {
+                Console.WriteLine($"  >> {cat}");
+            }
+
+            Console.WriteLine();
+
+            Console.WriteLine("Make some changes and save to the database.");
+
+            var baxter = context.Add(
+                new Cat("Baxter", "BSc") { Vet = "Bothell Pet Hospital", Food = new HumanFood("Blueberry scones", 900) }).Entity;
+
+            context.Add(new Human("Katie") { Pets = { baxter }, FavoriteAnimal = baxter });
+
+            context.Remove(context.Animals.Local.Single(e => e.Name == "Christi"));
+            context.Humans.Local.Single(e => e.Name == "Wendy").Food = new HumanFood("White pizza", 400);
+
+            var sushi = await context.Foods.OfType<HumanFood>().SingleAsync(e => e.Name == "Sushi");
+            sushi.Calories -= 100;
+
+            await context.SaveChangesAsync();
+
+            Console.WriteLine();
+        }
+
+        using (var context = new TContext())
+        {
+            Console.WriteLine("All animals including foods, pets, humans, and favorite animals:");
+            foreach (var animal in await context.Animals
+                         .AsNoTracking()
+                         .Include(e => e.Food)
+                         .Include(e => ((Human)e).Pets).ThenInclude(e => e.Food)
+                         .Include(e => ((Pet)e).Humans).ThenInclude(e => e.Food)
+                         .Include(e => ((Human)e).FavoriteAnimal).ThenInclude(e => e!.Food)
+                         .ToListAsync())
+            {
+                Console.Write($"  >> {animal}");
+
+                if (animal is Pet pet
+                    && pet.Humans.Any())
+                {
+                    Console.WriteLine($" has humans {string.Join(", ", pet.Humans.Select(e => e.Name))}");
+                }
+                else if (animal is Human human
+                         && human.Pets.Any())
+                {
+                    Console.WriteLine($" has pets {string.Join(", ", human.Pets.Select(e => e.Name))}");
+                }
+                else
+                {
+                    Console.WriteLine();
+                }
+            }
+
+            Console.WriteLine();
+        }
+
+        Console.WriteLine();
+    }
+
+    #region AnimalsHierarchy
+    public abstract class Animal
+    {
+        protected Animal(string name)
+        {
+            Name = name;
+        }
+
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public abstract string Species { get; }
+
+        public Food? Food { get; set; }
+    }
+
+    public abstract class Pet : Animal
+    {
+        protected Pet(string name)
+            : base(name)
+        {
+        }
+
+        public string? Vet { get; set; }
+
+        public ICollection<Human> Humans { get; } = new List<Human>();
+    }
+
+    public class FarmAnimal : Animal
+    {
+        public FarmAnimal(string name, string species)
+            : base(name)
+        {
+            Species = species;
+        }
+
+        public override string Species { get; }
+
+        [Precision(18, 2)]
+        public decimal Value { get; set; }
+
+        public override string ToString()
+            => $"Farm animal '{Name}' ({Species}/{Id}) worth {Value:C} eats {Food?.ToString() ?? "<Unknown>"}";
+    }
+
+    public class Cat : Pet
+    {
+        public Cat(string name, string educationLevel)
+            : base(name)
+        {
+            EducationLevel = educationLevel;
+        }
+
+        public string EducationLevel { get; set; }
+        public override string Species => "Felis catus";
+
+        public override string ToString()
+            => $"Cat '{Name}' ({Species}/{Id}) with education '{EducationLevel}' eats {Food?.ToString() ?? "<Unknown>"}";
+    }
+
+    public class Dog : Pet
+    {
+        public Dog(string name, string favoriteToy)
+            : base(name)
+        {
+            FavoriteToy = favoriteToy;
+        }
+
+        public string FavoriteToy { get; set; }
+        public override string Species => "Canis familiaris";
+
+        public override string ToString()
+            => $"Dog '{Name}' ({Species}/{Id}) with favorite toy '{FavoriteToy}' eats {Food?.ToString() ?? "<Unknown>"}";
+    }
+
+    public class Human : Animal
+    {
+        public Human(string name)
+            : base(name)
+        {
+        }
+
+        public override string Species => "Homo sapiens";
+
+        public Animal? FavoriteAnimal { get; set; }
+        public ICollection<Pet> Pets { get; } = new List<Pet>();
+
+        public override string ToString()
+            => $"Human '{Name}' ({Species}/{Id}) with favorite animal '{FavoriteAnimal?.Name ?? "<Unknown>"}'" +
+               $" eats {Food?.ToString() ?? "<Unknown>"}";
+    }
+    #endregion
+
+    public abstract class Food
+    {
+        public Guid Id { get; set; }
+    }
+
+    public class PetFood : Food
+    {
+        public PetFood(string brand, LifeStage lifeStage)
+        {
+            Brand = brand;
+            LifeStage = lifeStage;
+        }
+
+        public string Brand { get; set; }
+        public LifeStage LifeStage { get; set; }
+
+        public override string ToString()
+            => $"Pet food by '{Brand}' ({Id}) for life stage {LifeStage}";
+    }
+
+    public enum LifeStage
+    {
+        Juvenile,
+        Adult,
+        Senior
+    }
+
+    public class HumanFood : Food
+    {
+        public HumanFood(string name, int calories)
+        {
+            Name = name;
+            Calories = calories;
+        }
+
+        [Column("Name")]
+        public string Name { get; set; }
+
+        public int Calories { get; set; }
+
+        public override string ToString()
+            => $"{Name} ({Id}) with calories {Calories}";
+    }
+
+    public class FarmFood : Food
+    {
+        public FarmFood(string name)
+        {
+            Name = name;
+        }
+
+        [Column("Name")]
+        public string Name { get; set; }
+
+        public override string ToString()
+            => $"{Name} ({Id})";
+    }
+
+    public class TphAnimalsContext : AnimalsContext
+    {
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region UseTphMappingStrategy
+            modelBuilder.Entity<Animal>().UseTphMappingStrategy();
+            #endregion
+
+            modelBuilder.Entity<Food>().UseTpcMappingStrategy();
+            base.OnModelCreating(modelBuilder);
+        }
+    }
+
+    public class TptAnimalsContext : AnimalsContext
+    {
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region UseTptMappingStrategy
+            modelBuilder.Entity<Animal>().UseTptMappingStrategy();
+            #endregion
+
+            modelBuilder.Entity<Food>().UseTpcMappingStrategy();
+            base.OnModelCreating(modelBuilder);
+        }
+    }
+
+    public class TpcAnimalsContext : AnimalsContext
+    {
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region UseTpcMappingStrategy
+            modelBuilder.Entity<Animal>().UseTpcMappingStrategy();
+            #endregion
+
+            modelBuilder.Entity<Food>().UseTpcMappingStrategy();
+            base.OnModelCreating(modelBuilder);
+        }
+    }
+
+    public class TpcHiLoAnimalsContext : AnimalsContext
+    {
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.UseHiLo();
+            modelBuilder.Entity<Animal>().UseTpcMappingStrategy();
+            modelBuilder.Entity<Food>().UseTpcMappingStrategy();
+            base.OnModelCreating(modelBuilder);
+        }
+    }
+
+    public class TpcIdentityAnimalsContext : AnimalsContext
+    {
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Animal>().UseTpcMappingStrategy();
+
+            #region UsingIdentity
+            modelBuilder.Entity<Cat>().ToTable("Cats", tb => tb.Property(e => e.Id).UseIdentityColumn(1, 4));
+            modelBuilder.Entity<Dog>().ToTable("Dogs", tb => tb.Property(e => e.Id).UseIdentityColumn(2, 4));
+            modelBuilder.Entity<FarmAnimal>().ToTable("FarmAnimals", tb => tb.Property(e => e.Id).UseIdentityColumn(3, 4));
+            modelBuilder.Entity<Human>().ToTable("Humans", tb => tb.Property(e => e.Id).UseIdentityColumn(4, 4));
+            #endregion
+
+            modelBuilder.Entity<Food>().UseTpcMappingStrategy();
+
+            base.OnModelCreating(modelBuilder);
+        }
+    }
+
+    public abstract class AnimalsContext : DbContext
+    {
+        #region AnimalSets
+        public DbSet<Animal> Animals => Set<Animal>();
+        public DbSet<Pet> Pets => Set<Pet>();
+        public DbSet<FarmAnimal> FarmAnimals => Set<FarmAnimal>();
+        public DbSet<Cat> Cats => Set<Cat>();
+        public DbSet<Dog> Dogs => Set<Dog>();
+        public DbSet<Human> Humans => Set<Human>();
+        #endregion
+
+        public DbSet<Food> Foods => Set<Food>();
+        public DbSet<PetFood> PetFoods => Set<PetFood>();
+        public DbSet<FarmFood> FarmFoods => Set<FarmFood>();
+        public DbSet<HumanFood> HumanFoods => Set<HumanFood>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseSqlServer(@$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0");
+
+            optionsBuilder.LogTo(Console.WriteLine, LogLevel.Information);
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region AnimalsInModelBuilder
+            modelBuilder.Entity<Animal>();
+            modelBuilder.Entity<Pet>();
+            modelBuilder.Entity<Cat>();
+            modelBuilder.Entity<Dog>();
+            modelBuilder.Entity<FarmAnimal>();
+            modelBuilder.Entity<Human>();
+            #endregion
+
+            modelBuilder.Entity<FarmAnimal>().Property(e => e.Species);
+
+            modelBuilder.Entity<Human>()
+                .HasMany(e => e.Pets)
+                .WithMany(e => e.Humans)
+                .UsingEntity<Dictionary<object, string>>(
+                    "PetsHumans",
+                    r => r.HasOne<Pet>().WithMany().OnDelete(DeleteBehavior.Cascade),
+                    l => l.HasOne<Human>().WithMany().OnDelete(DeleteBehavior.ClientCascade));
+        }
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/UngroupedColumnsQuerySample.cs b/samples/core/Miscellaneous/NewInEFCore7/UngroupedColumnsQuerySample.cs
new file mode 100644
index 0000000000..d81ff01d85
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/UngroupedColumnsQuerySample.cs
@@ -0,0 +1,102 @@
+namespace NewInEfCore7;
+
+public static class UngroupedColumnsQuerySample
+{
+    public static Task Subqueries_dont_reference_ungrouped_columns_from_outer_query_SqlServer()
+    {
+        PrintSampleName();
+        return QueryTest<InvoiceContextSqlServer>();
+    }
+
+    private static async Task QueryTest<TContext>()
+        where TContext : InvoiceContext, new()
+    {
+        await using (var context = new TContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            await context.AddRangeAsync(
+                new Invoice { Amount = 10.20m, History = new DateTime(1973, 9, 3) },
+                new Invoice { Amount = 11.20m, History = new DateTime(1973, 9, 13) },
+                new Invoice { Amount = 12.20m, History = new DateTime(1973, 10, 3) },
+                new Invoice { Amount = 13.20m, History = new DateTime(1973, 11, 3) });
+
+            await context.AddRangeAsync(
+                new Payment { Amount = 0.20m, History = new DateTime(1973, 9, 5) },
+                new Payment { Amount = 1.20m, History = new DateTime(1973, 10, 13) },
+                new Payment { Amount = 2.20m, History = new DateTime(1973, 10, 5) },
+                new Payment { Amount = 3.20m, History = new DateTime(1973, 11, 7) });
+
+            await context.SaveChangesAsync();
+        }
+
+        await using (var context = new TContext())
+        {
+            #region UngroupedColumns
+            var query = from s in (from i in context.Invoices
+                                   group i by i.History.Month
+                                   into g
+                                   select new { Month = g.Key, Total = g.Sum(p => p.Amount), })
+                        select new
+                        {
+                            s.Month, s.Total, Payment = context.Payments.Where(p => p.History.Month == s.Month).Sum(p => p.Amount)
+                        };
+            #endregion
+
+            await foreach (var group in query.AsAsyncEnumerable())
+            {
+                Console.WriteLine($"Month: {group.Month}; Total = {group.Total}; Payment = {group.Payment}");
+            }
+        }
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public abstract class InvoiceContext : DbContext
+    {
+        public DbSet<Invoice> Invoices => Set<Invoice>();
+        public DbSet<Payment> Payments => Set<Payment>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .LogTo(Console.WriteLine, LogLevel.Information)
+                .EnableSensitiveDataLogging();
+    }
+
+    public class InvoiceContextSqlServer : InvoiceContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => base.OnConfiguring(
+                optionsBuilder.UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Invoices;ConnectRetryCount=0"));
+    }
+
+    public class InvoiceContextSqlite : InvoiceContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => base.OnConfiguring(
+                optionsBuilder.UseSqlite("Data Source = invoices.db"));
+    }
+
+    public class Invoice
+    {
+        public int Id { get; set; }
+        public DateTime History { get; set; }
+
+        [Precision(18, 2)]
+        public decimal Amount { get; set; }
+    }
+
+    public class Payment
+    {
+        public int Id { get; set; }
+        public DateTime History { get; set; }
+
+        [Precision(18, 2)]
+        public decimal Amount { get; set; }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore7/ValueGenerationSample.cs b/samples/core/Miscellaneous/NewInEFCore7/ValueGenerationSample.cs
new file mode 100644
index 0000000000..64380bee68
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore7/ValueGenerationSample.cs
@@ -0,0 +1,133 @@
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+namespace NewInEfCore7;
+
+public static class ValueGenerationSample
+{
+    public static async Task Can_use_value_generation_with_converted_types()
+    {
+        PrintSampleName();
+
+        await using var context = new ProductsContext();
+
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+
+        await context.AddRangeAsync(
+            new Category("Foods") { Products = { new("Marmite"), new("Toast"), new("Butter") } },
+            new Category("Beverages") { Products = { new("Tea"), new("Milk") } });
+
+        await context.SaveChangesAsync();
+        context.ChangeTracker.Clear();
+
+        var categoriesAndProducts = await context.Categories.Include(category => category.Products).ToListAsync();
+
+        Console.WriteLine();
+        foreach (var category in categoriesAndProducts)
+        {
+            Console.WriteLine($"Category {category.Id.Value} is '{category.Name}'");
+            foreach (var product in category.Products)
+            {
+                Console.WriteLine($"   Product {product.Id.Value} is '{product.Name}'");
+            }
+        }
+        Console.WriteLine();
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public class ProductsContext : DbContext
+    {
+        public DbSet<Product> Products => Set<Product>();
+        public DbSet<Category> Categories => Set<Category>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .UseSqlServer(@$"Server=(localdb)\mssqllocaldb;Database=Products;ConnectRetryCount=0")
+                .LogTo(Console.WriteLine, LogLevel.Information)
+                .EnableSensitiveDataLogging();
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region ValueGeneratedOnAdd
+            modelBuilder.Entity<Product>().Property(product => product.Id).ValueGeneratedOnAdd();
+            modelBuilder.Entity<Category>().Property(category => category.Id).ValueGeneratedOnAdd();
+            #endregion
+
+            #region ConfigureSequence
+            modelBuilder
+                .HasSequence<int>("ProductsSequence", "northwind")
+                .StartsAt(1000)
+                .IncrementsBy(2);
+            #endregion
+
+            #region Sequence
+            modelBuilder
+                .Entity<Product>()
+                .Property(product => product.Id)
+                .UseSequence("ProductsSequence", "northwind");
+            #endregion
+        }
+
+        #region KeyConverters
+        protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+        {
+            configurationBuilder.Properties<ProductId>().HaveConversion<ProductIdConverter>();
+            configurationBuilder.Properties<CategoryId>().HaveConversion<CategoryIdConverter>();
+        }
+
+        private class ProductIdConverter : ValueConverter<ProductId, int>
+        {
+            public ProductIdConverter()
+                : base(v => v.Value, v => new(v))
+            {
+            }
+        }
+
+        private class CategoryIdConverter : ValueConverter<CategoryId, int>
+        {
+            public CategoryIdConverter()
+                : base(v => v.Value, v => new(v))
+            {
+            }
+        }
+        #endregion
+    }
+
+    #region GuardedKeys
+    public readonly struct ProductId
+    {
+        public ProductId(int value) => Value = value;
+        public int Value { get; }
+    }
+
+    public readonly struct CategoryId
+    {
+        public CategoryId(int value) => Value = value;
+        public int Value { get; }
+    }
+    #endregion
+
+    #region ProductAndCategory
+    public class Product
+    {
+        public Product(string name) => Name = name;
+        public ProductId Id { get; set; }
+        public string Name { get; set; }
+        public CategoryId CategoryId { get; set; }
+        public Category Category { get; set; } = null!;
+    }
+
+    public class Category
+    {
+        public Category(string name) => Name = name;
+        public CategoryId Id { get; set; }
+        public string Name { get; set; }
+        public List<Product> Products { get; } = new();
+    }
+    #endregion
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore8/.config/dotnet-tools.json b/samples/core/Miscellaneous/NewInEFCore8/.config/dotnet-tools.json
new file mode 100644
index 0000000000..c03564f970
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore8/.config/dotnet-tools.json
@@ -0,0 +1,12 @@
+{
+  "version": 1,
+  "isRoot": true,
+  "tools": {
+    "dotnet-ef": {
+      "version": "8.0.0",
+      "commands": [
+        "dotnet-ef"
+      ]
+    }
+  }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore8/BlogsContext.cs b/samples/core/Miscellaneous/NewInEFCore8/BlogsContext.cs
new file mode 100644
index 0000000000..ebf2ce026d
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore8/BlogsContext.cs
@@ -0,0 +1,479 @@
+using System.Net;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+namespace NewInEfCore8;
+
+#region BlogsModel
+public class Blog
+{
+    public Blog(string name)
+    {
+        Name = name;
+    }
+
+    public int Id { get; private set; }
+    public string Name { get; set; }
+    public virtual Uri SiteUri { get; set; } = null!;
+    public virtual Website Site { get; set; } = null!;
+    public virtual List<Post> Posts { get; } = new();
+}
+
+public class Website
+{
+    public Website(Uri uri, string email)
+    {
+        Uri = uri;
+        Email = email;
+    }
+
+    public Guid Id { get; private set; }
+    public Uri Uri { get; private set; }
+    public string Email { get; private set; }
+    public virtual Blog Blog { get; set; } = null!;
+}
+
+public class Post
+{
+    public Post(string title, string content, DateOnly publishedOn)
+    {
+        Title = title;
+        Content = content;
+        PublishedOn = publishedOn;
+    }
+
+    public int Id { get; private set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+    public DateOnly PublishedOn { get; set; }
+    public bool Archived { get; set; }
+    public int BlogId { get; set; }
+    public virtual Blog Blog { get; set; } = null!;
+    public virtual List<Tag> Tags { get; } = new();
+    public virtual Author? Author { get; set; }
+    public PostMetadata? Metadata { get; set; }
+}
+
+public class FeaturedPost : Post
+{
+    public FeaturedPost(string title, string content, DateOnly publishedOn, string promoText)
+        : base(title, content, publishedOn)
+    {
+        PromoText = promoText;
+    }
+
+    public string PromoText { get; set; }
+}
+
+public class Tag
+{
+    public Tag(string id, string text)
+    {
+        Id = id;
+        Text = text;
+    }
+
+    public string Id { get; private set; }
+    public string Text { get; set; }
+    public virtual List<Post> Posts { get; } = new();
+}
+
+public class PostTag
+{
+    public int PostId { get; private set; }
+    public string TagId { get; private set; } = null!;
+}
+
+public class Author
+{
+    public Author(string name)
+    {
+        Name = name;
+    }
+
+    public int Id { get; private set; }
+    public string Name { get; set; }
+    public ContactDetails Contact { get; set; } = null!;
+    public virtual List<Post> Posts { get; } = new();
+}
+#endregion
+
+#region ContactDetailsAggregate
+public class ContactDetails
+{
+    public Address Address { get; set; } = null!;
+    public string? Phone { get; set; }
+}
+
+public class Address
+{
+    public Address(string street, string city, string postcode, string country)
+    {
+        Street = street;
+        City = city;
+        Postcode = postcode;
+        Country = country;
+    }
+
+    public string Street { get; set; }
+    public string City { get; set; }
+    public string Postcode { get; set; }
+    public string Country { get; set; }
+}
+#endregion
+
+#region PostMetadataAggregate
+public class PostMetadata
+{
+    public PostMetadata(int views)
+    {
+        Views = views;
+    }
+
+    public int Views { get; set; }
+    public List<SearchTerm> TopSearches { get; } = new();
+    public List<Visits> TopGeographies { get; } = new();
+    public List<PostUpdate> Updates { get; } = new();
+}
+
+public class SearchTerm
+{
+    public SearchTerm(string term, int count)
+    {
+        Term = term;
+        Count = count;
+    }
+
+    public string Term { get; private set; }
+    public int Count { get; private set; }
+}
+
+public class Visits
+{
+    public Visits(double latitude, double longitude, int count)
+    {
+        Latitude = latitude;
+        Longitude = longitude;
+        Count = count;
+    }
+
+    public double Latitude { get; private set; }
+    public double Longitude { get; private set; }
+    public int Count { get; private set; }
+    public List<string>? Browsers { get; set; }
+}
+
+public class PostUpdate
+{
+    public PostUpdate(IPAddress postedFrom, DateOnly updatedOn)
+    {
+        PostedFrom = postedFrom;
+        UpdatedOn = updatedOn;
+    }
+
+    public IPAddress PostedFrom { get; private set; }
+    public string? UpdatedBy { get; set; }
+    public DateOnly UpdatedOn { get; private set; }
+    public List<Commit> Commits { get; } = new();
+}
+
+public class Commit
+{
+    public Commit(DateOnly committedOn, string comment)
+    {
+        CommittedOn = committedOn;
+        Comment = comment;
+    }
+
+    public DateOnly CommittedOn { get; private set; }
+    public string Comment { get; set; }
+}
+#endregion
+
+public abstract class BlogsContext : DbContext
+{
+    protected BlogsContext(bool useSqlite = false)
+    {
+        UseSqlite = useSqlite;
+    }
+
+    public bool UseSqlite { get; }
+    public bool LoggingEnabled { get; set; }
+    public virtual MappingStrategy MappingStrategy => MappingStrategy.Tph;
+
+    public DbSet<Blog> Blogs => Set<Blog>();
+    public DbSet<Website> Websites => Set<Website>();
+    public DbSet<Tag> Tags => Set<Tag>();
+    public DbSet<Post> Posts => Set<Post>();
+    public DbSet<Author> Authors => Set<Author>();
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => (UseSqlite
+                ? optionsBuilder.UseSqlite(@$"DataSource={GetType().Name}.db")
+                : optionsBuilder.UseSqlServer(
+                    @$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0",
+                    sqlServerOptionsBuilder => sqlServerOptionsBuilder.UseNetTopologySuite()))
+            .EnableSensitiveDataLogging()
+            .LogTo(
+                s =>
+                {
+                    if (LoggingEnabled)
+                    {
+                        Console.WriteLine(s);
+                    }
+                }, LogLevel.Information);
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<FeaturedPost>();
+
+        modelBuilder.Entity<Website>()
+            .HasOne(e => e.Blog)
+            .WithOne(e => e.Site)
+            .HasPrincipalKey<Website>(e => e.Uri)
+            .HasForeignKey<Blog>(e => e.SiteUri);
+
+        modelBuilder.Entity<Post>()
+            .HasMany(e => e.Tags)
+            .WithMany(e => e.Posts)
+            .UsingEntity<PostTag>();
+    }
+
+    protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+    {
+        configurationBuilder.Properties<List<string>>().HaveConversion<StringListConverter>();
+
+        base.ConfigureConventions(configurationBuilder);
+    }
+
+    private class StringListConverter : ValueConverter<List<string>, string>
+    {
+        public StringListConverter()
+            : base(v => string.Join(", ", v!), v => v.Split(',', StringSplitOptions.TrimEntries).ToList())
+        {
+        }
+    }
+
+    public async Task Seed()
+    {
+        var tagEntityFramework = new Tag("TagEF", "Entity Framework");
+        var tagDotNet = new Tag("TagNet", ".NET");
+        var tagDotNetMaui = new Tag("TagMaui", ".NET MAUI");
+        var tagAspDotNet = new Tag("TagAsp", "ASP.NET");
+        var tagAspDotNetCore = new Tag("TagAspC", "ASP.NET Core");
+        var tagDotNetCore = new Tag("TagC", ".NET Core");
+        var tagHacking = new Tag("TagHx", "Hacking");
+        var tagLinux = new Tag("TagLin", "Linux");
+        var tagSqlite = new Tag("TagLite", "SQLite");
+        var tagVisualStudio = new Tag("TagVS", "Visual Studio");
+        var tagGraphQl = new Tag("TagQL", "GraphQL");
+        var tagCosmosDb = new Tag("TagCos", "CosmosDB");
+        var tagBlazor = new Tag("TagBl", "Blazor");
+
+        var maddy = new Author("Maddy Montaquila")
+        {
+            Contact = new() { Address = new("1 Main St", "Camberwick Green", "CW1 5ZH", "UK"), Phone = "01632 12345" }
+        };
+        var jeremy = new Author("Jeremy Likness")
+        {
+            Contact = new() { Address = new("2 Main St", "Chigley", "CW1 5ZH", "UK"), Phone = "01632 12346" }
+        };
+        var dan = new Author("Daniel Roth")
+        {
+            Contact = new() { Address = new("3 Main St", "Camberwick Green", "CW1 5ZH", "UK"), Phone = "01632 12347" }
+        };
+        var arthur = new Author("Arthur Vickers")
+        {
+            Contact = new() { Address = new("15a Main St", "Chigley", "CW1 5ZH", "UK"), Phone = "01632 12348" }
+        };
+        var brice = new Author("Brice Lambson")
+        {
+            Contact = new() { Address = new("4 Main St", "Chigley", "CW1 5ZH", "UK"), Phone = "01632 12349" }
+        };
+
+        var blogs = new List<Blog>
+        {
+            new(".NET Blog")
+            {
+                Posts =
+                {
+                    new Post(
+                        "Productivity comes to .NET MAUI in Visual Studio 2022",
+                        "Visual Studio 2022 17.3 is now available and...",
+                        new DateOnly(2022, 8, 9)) { Tags = { tagDotNetMaui, tagDotNet }, Author = maddy, Metadata = BuildPostMetadata() },
+                    new Post(
+                        "Announcing .NET 7 Preview 7", ".NET 7 Preview 7 is now available with improvements to System.LINQ, Unix...",
+                        new DateOnly(2022, 8, 9)) { Tags = { tagDotNet }, Author = jeremy, Metadata = BuildPostMetadata() },
+                    new Post(
+                        "ASP.NET Core updates in .NET 7 Preview 7", ".NET 7 Preview 7 is now available! Check out what's new in...",
+                        new DateOnly(2022, 8, 9))
+                    {
+                        Tags = { tagDotNet, tagAspDotNet, tagAspDotNetCore }, Author = dan, Metadata = BuildPostMetadata()
+                    },
+                    new FeaturedPost(
+                        "Announcing Entity Framework 7 Preview 7: Interceptors!",
+                        "Announcing EF7 Preview 7 with new and improved interceptors, and...",
+                        new DateOnly(2022, 8, 9),
+                        "Loads of runnable code!")
+                    {
+                        Tags = { tagEntityFramework, tagDotNet, tagDotNetCore }, Author = arthur, Metadata = BuildPostMetadata()
+                    }
+                },
+                Site = new(new("https://devblogs.microsoft.com/dotnet/"), "dotnet@example.com")
+            },
+            new("1unicorn2")
+            {
+                Posts =
+                {
+                    new Post(
+                        "Hacking my Sixth Form College network in 1991",
+                        "Back in 1991 I was a student at Franklin Sixth Form College...",
+                        new DateOnly(2020, 4, 10)) { Tags = { tagHacking }, Author = arthur, Metadata = BuildPostMetadata() },
+                    new FeaturedPost(
+                        "All your versions are belong to us",
+                        "Totally made up conversations about choosing Entity Framework version numbers...",
+                        new DateOnly(2020, 3, 26),
+                        "Way funny!") { Tags = { tagEntityFramework }, Author = arthur, Metadata = BuildPostMetadata() },
+                    new Post(
+                        "Moving to Linux", "A few weeks ago, I decided to move from Windows to Linux as...",
+                        new DateOnly(2020, 3, 7)) { Tags = { tagLinux }, Author = arthur, Metadata = BuildPostMetadata(), Archived = true },
+                    new Post(
+                        "Welcome to One Unicorn 2.0!", "I created my first blog back in 2011..",
+                        new DateOnly(2020, 2, 29)) { Tags = { tagEntityFramework }, Author = arthur, Metadata = BuildPostMetadata() }
+                },
+                Site = new(new("https://blog.oneunicorn.com/"), "unicorn@example.com")
+            },
+            new("Brice's Blog")
+            {
+                Posts =
+                {
+                    new FeaturedPost(
+                        "SQLite in Visual Studio 2022", "A couple of years ago, I was thinking of ways...",
+                        new DateOnly(2022, 7, 26), "Love for VS!")
+                    {
+                        Tags = { tagSqlite, tagVisualStudio }, Author = brice, Metadata = BuildPostMetadata()
+                    },
+                    new Post(
+                        "On .NET - Entity Framework Migrations Explained",
+                        "This week, @JamesMontemagno invited me onto the On .NET show...",
+                        new DateOnly(2022, 5, 4))
+                    {
+                        Tags = { tagEntityFramework, tagDotNet }, Author = brice, Metadata = BuildPostMetadata()
+                    },
+                    new Post(
+                        "Dear DBA: A silly idea", "We have fun on the Entity Framework team...",
+                        new DateOnly(2022, 3, 31)) { Tags = { tagEntityFramework }, Author = brice, Metadata = BuildPostMetadata(), Archived = true },
+                    new Post(
+                        "Microsoft.Data.Sqlite 6", "It’s that time of year again. Microsoft.Data.Sqlite version...",
+                        new DateOnly(2021, 11, 8)) { Tags = { tagSqlite, tagDotNet }, Author = brice, Metadata = BuildPostMetadata() }
+                },
+                Site = new(new("https://www.bricelam.net/"), "brice@example.com")
+            },
+            new("Developer for Life")
+            {
+                Posts =
+                {
+                    new Post(
+                        "GraphQL for .NET Developers", "A comprehensive overview of GraphQL as...",
+                        new DateOnly(2021, 7, 1))
+                    {
+                        Tags = { tagDotNet, tagGraphQl, tagAspDotNetCore }, Author = jeremy, Metadata = BuildPostMetadata()
+                    },
+                    new FeaturedPost(
+                        "Azure Cosmos DB With EF Core on Blazor Server",
+                        "Learn how to build Azure Cosmos DB apps using Entity Framework Core...",
+                        new DateOnly(2021, 5, 16),
+                        "Blazor FTW!")
+                    {
+                        Tags =
+                        {
+                            tagDotNet,
+                            tagEntityFramework,
+                            tagAspDotNetCore,
+                            tagCosmosDb,
+                            tagBlazor
+                        },
+                        Author = jeremy,
+                        Metadata = BuildPostMetadata()
+                    },
+                    new Post(
+                        "Multi-tenancy with EF Core in Blazor Server Apps",
+                        "Learn several ways to implement multi-tenant databases in Blazor Server apps...",
+                        new DateOnly(2021, 4, 29))
+                    {
+                        Tags = { tagDotNet, tagEntityFramework, tagAspDotNetCore, tagBlazor },
+                        Author = jeremy,
+                        Metadata = BuildPostMetadata()
+                    },
+                    new Post(
+                        "An Easier Blazor Debounce", "Where I propose a simple method to debounce input without...",
+                        new DateOnly(2021, 4, 12))
+                    {
+                        Tags = { tagDotNet, tagAspDotNetCore, tagBlazor }, Author = jeremy, Metadata = BuildPostMetadata()
+                    }
+                },
+                Site = new(new("https://blog.jeremylikness.com/"), "jeremy@example.com")
+            }
+        };
+
+        await AddRangeAsync(blogs);
+        await SaveChangesAsync();
+
+        PostMetadata BuildPostMetadata()
+        {
+            var random = new Random(Guid.NewGuid().GetHashCode());
+
+            var metadata = new PostMetadata(random.Next(10000));
+
+            for (var i = 0; i < random.Next(5); i++)
+            {
+                var update = new PostUpdate(IPAddress.Loopback, DateOnly.FromDateTime(DateTime.UtcNow - TimeSpan.FromDays(random.Next(1, 10000))))
+                {
+                    UpdatedBy = "Admin"
+                };
+
+                for (var j = 0; j < random.Next(3); j++)
+                {
+                    update.Commits.Add(new(DateOnly.FromDateTime(DateTime.Today), $"Commit #{j + 1}"));
+                }
+
+                metadata.Updates.Add(update);
+            }
+
+            for (var i = 0; i < random.Next(5); i++)
+            {
+                metadata.TopSearches.Add(new($"Search #{i + 1}", 10000 - random.Next(i * 1000, i * 1000 + 900)));
+            }
+
+            for (var i = 0; i < random.Next(5); i++)
+            {
+                metadata.TopGeographies.Add(
+                    new(
+                        // Issue https://github.com/dotnet/efcore/issues/28811 (Support spatial types in JSON columns)
+                        // new Point(115.7930 + 20 - random.Next(40), 37.2431 + 10 - random.Next(20)) { SRID = 4326 },
+                        115.7930 + 20 - random.Next(40),
+                        37.2431 + 10 - random.Next(20),
+                        1000 - random.Next(i * 100, i * 100 + 90)) { Browsers = new() { "Firefox", "Netscape" } });
+            }
+
+            return metadata;
+        }
+    }
+}
+
+public class TphBlogsContext : BlogsContext
+{
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>().Ignore(e => e.Metadata);
+        modelBuilder.Entity<Author>().OwnsOne(e => e.Contact).OwnsOne(e => e.Address);
+
+        base.OnModelCreating(modelBuilder);
+    }
+}
+
+public enum MappingStrategy
+{
+    Tph,
+    Tpt,
+    Tpc,
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore8/ComplexTypesSample.cs b/samples/core/Miscellaneous/NewInEFCore8/ComplexTypesSample.cs
new file mode 100644
index 0000000000..7f53c731b2
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore8/ComplexTypesSample.cs
@@ -0,0 +1,143 @@
+namespace NewInEfCore8;
+
+public static class ComplexTypesSample
+{
+    public static Task Use_mutable_class_as_complex_type()
+    {
+        PrintSampleName();
+        return ComplexTypeTest<CustomerContext>();
+    }
+
+    public static Task Use_mutable_class_as_complex_type_SQLite()
+    {
+        PrintSampleName();
+        return ComplexTypeTest<CustomerContextSqlite>();
+    }
+
+    private static async Task ComplexTypeTest<TContext>()
+        where TContext : CustomerContextBase, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.LoggingEnabled = true;
+        context.ChangeTracker.Clear();
+
+        #region SaveCustomer
+        var customer = new Customer
+        {
+            Name = "Willow",
+            Address = new() { Line1 = "Barking Gate", City = "Walpole St Peter", Country = "UK", PostCode = "PE14 7AV" }
+        };
+
+        context.Add(customer);
+        await context.SaveChangesAsync();
+        #endregion
+
+        #region CreateOrder
+        customer.Orders.Add(
+            new Order { Contents = "Tesco Tasty Treats", BillingAddress = customer.Address, ShippingAddress = customer.Address, });
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        #region ChangeSharedAddress
+        customer.Address.Line1 = "Peacock Lodge";
+        await context.SaveChangesAsync();
+        #endregion
+
+        context.ChangeTracker.Clear();
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    #region CustomerOrders
+    public class Customer
+    {
+        public int Id { get; set; }
+        public required string Name { get; set; }
+        public required Address Address { get; set; }
+        public List<Order> Orders { get; } = new();
+    }
+
+    public class Order
+    {
+        public int Id { get; set; }
+        public required string Contents { get; set; }
+        public required Address ShippingAddress { get; set; }
+        public required Address BillingAddress { get; set; }
+        public Customer Customer { get; set; } = null!;
+    }
+    #endregion
+
+    #region Address
+    public class Address
+    {
+        public required string Line1 { get; set; }
+        public string? Line2 { get; set; }
+        public required string City { get; set; }
+        public required string Country { get; set; }
+        public required string PostCode { get; set; }
+    }
+    #endregion
+
+    public class CustomerContext : CustomerContextBase
+    {
+    }
+
+    public class CustomerContextSqlite : CustomerContextBase
+    {
+        public CustomerContextSqlite()
+            : base(useSqlite: true)
+        {
+        }
+    }
+
+    public abstract class CustomerContextBase(bool useSqlite = false) : DbContext
+    {
+        public bool UseSqlite { get; } = useSqlite;
+        public bool LoggingEnabled { get; set; }
+
+        public DbSet<Customer> Customers => Set<Customer>();
+        public DbSet<Order> Orders => Set<Order>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => (UseSqlite
+                    ? optionsBuilder.UseSqlite(@$"DataSource={GetType().Name}.db")
+                    : optionsBuilder.UseSqlServer(@$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0"))
+                .EnableSensitiveDataLogging()
+                .LogTo(
+                    s =>
+                    {
+                        if (LoggingEnabled)
+                        {
+                            Console.WriteLine(s);
+                        }
+                    }, LogLevel.Information);
+
+        #region ComplexTypeConfig
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Customer>()
+                .ComplexProperty(e => e.Address);
+
+            modelBuilder.Entity<Order>(b =>
+            {
+                b.ComplexProperty(e => e.BillingAddress);
+                b.ComplexProperty(e => e.ShippingAddress);
+            });
+        }
+        #endregion
+
+        public async Task Seed()
+        {
+            await SaveChangesAsync();
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore8/DateOnlyTimeOnlySample.cs b/samples/core/Miscellaneous/NewInEFCore8/DateOnlyTimeOnlySample.cs
new file mode 100644
index 0000000000..8e5eae9baa
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore8/DateOnlyTimeOnlySample.cs
@@ -0,0 +1,299 @@
+namespace NewInEfCore8;
+
+public static class DateOnlyTimeOnlySample
+{
+    public static Task Can_use_DateOnly_TimeOnly_on_SQL_Server()
+    {
+        PrintSampleName();
+        return DateOnlyTimeOnlyTest<BritishSchoolsContext>();
+    }
+
+    public static Task Can_use_DateOnly_TimeOnly_on_SQL_Server_with_JSON()
+    {
+        PrintSampleName();
+        return DateOnlyTimeOnlyTest<BritishSchoolsContextJson>();
+    }
+
+    public static Task Can_use_DateOnly_TimeOnly_on_SQLite()
+    {
+        PrintSampleName();
+        return DateOnlyTimeOnlyTest<BritishSchoolsContextSqlite>();
+    }
+
+    private static async Task DateOnlyTimeOnlyTest<TContext>()
+        where TContext : BritishSchoolsContextBase, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.LoggingEnabled = true;
+        context.ChangeTracker.Clear();
+
+        var now = TimeZoneInfo.ConvertTimeBySystemTimeZoneId(DateTime.UtcNow, "UTC", "GMT");
+
+        var today = DateOnly.FromDateTime(now);
+        var currentTerms = await context.Schools
+            .Include(s => s.Terms.Where(t => t.FirstDay <= today && t.LastDay >= today))
+            .ToListAsync();
+
+        Console.WriteLine();
+        Console.WriteLine("Current terms:");
+        foreach (var school in currentTerms)
+        {
+            var term = school.Terms.SingleOrDefault();
+            if (term == null)
+            {
+                Console.WriteLine($"  {school.Name} is not current in term.");
+            }
+            else
+            {
+                Console.WriteLine($"  The current term for {school.Name} is '{term.Name}'.");
+            }
+        }
+
+        Console.WriteLine();
+
+        var time = TimeOnly.FromDateTime(now);
+        var dayOfWeek = today.DayOfWeek;
+        List<School> openSchools;
+
+        if (context.UsesJson)
+        {
+            #region OpenSchoolsJson
+            openSchools = await context.Schools
+                .Where(
+                    s => s.Terms.Any(
+                             t => t.FirstDay <= today
+                                  && t.LastDay >= today)
+                         && s.OpeningHours[(int)dayOfWeek].OpensAt < time
+                         && s.OpeningHours[(int)dayOfWeek].ClosesAt >= time)
+                .ToListAsync();
+            #endregion
+        }
+        else
+        {
+            #region OpenSchools
+            openSchools = await context.Schools
+                .Where(
+                    s => s.Terms.Any(
+                             t => t.FirstDay <= today
+                                  && t.LastDay >= today)
+                         && s.OpeningHours.Any(
+                             o => o.DayOfWeek == dayOfWeek
+                                  && o.OpensAt < time && o.ClosesAt >= time))
+                .ToListAsync();
+            #endregion
+        }
+
+        Console.WriteLine();
+        Console.WriteLine("Open schools:");
+        foreach (var school in openSchools)
+        {
+            Console.WriteLine($"  {school.Name} is open and closes at {school.OpeningHours.Single(e => e.DayOfWeek == dayOfWeek).ClosesAt}.");
+        }
+
+        Console.WriteLine();
+
+        context.ChangeTracker.Clear();
+
+        foreach (var school in await context.Schools.Include(e => e.Terms).ToListAsync())
+        {
+            var winter = school.Terms.Single(e => e.LastDay.Year == 2022);
+            winter.LastDay = winter.LastDay.AddDays(1);
+            var friday = school.OpeningHours.Single(e => e.DayOfWeek == DayOfWeek.Friday);
+            friday.OpensAt = friday.OpensAt?.AddHours(-1);
+        }
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+
+        context.ChangeTracker.Clear();
+
+        #region UpdateForSnowDay
+        await context.Schools
+            .Where(e => e.Terms.Any(t => t.LastDay.Year == 2022))
+            .SelectMany(e => e.Terms)
+            .ExecuteUpdateAsync(s => s.SetProperty(t => t.LastDay, t => t.LastDay.AddDays(1)));
+        #endregion
+
+        // Issue https://github.com/dotnet/efcore/issues/30223
+        if (!context.UsesJson
+            && !context.UseSqlite)
+        {
+            await context.Schools
+                .SelectMany(e => e.OpeningHours)
+                .Where(e => e.DayOfWeek == DayOfWeek.Friday)
+                .ExecuteUpdateAsync(s => s.SetProperty(t => t.OpensAt, t => t.OpensAt!.Value.AddHours(-1)));
+        }
+
+        Console.WriteLine();
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+}
+
+public abstract class BritishSchoolsContextBase : DbContext
+{
+    protected BritishSchoolsContextBase(bool useSqlite = false)
+    {
+        UseSqlite = useSqlite;
+    }
+
+    public bool UseSqlite { get; }
+    public virtual bool UsesJson => false;
+    public bool LoggingEnabled { get; set; }
+
+    public DbSet<School> Schools => Set<School>();
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => (UseSqlite
+                ? optionsBuilder.UseSqlite(@$"DataSource={GetType().Name}.db")
+                : optionsBuilder.UseSqlServer(
+                    @$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0",
+                    sqlServerOptionsBuilder => sqlServerOptionsBuilder.UseNetTopologySuite()))
+            .EnableSensitiveDataLogging()
+            .LogTo(
+                s =>
+                {
+                    if (LoggingEnabled)
+                    {
+                        Console.WriteLine(s);
+                    }
+                }, LogLevel.Information);
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+    }
+
+    protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+    {
+    }
+
+    public async Task Seed()
+    {
+        AddRange(
+            new School
+            {
+                Name = "Stowe School",
+                Founded = new(1923, 5, 11),
+                Terms =
+                {
+                    new() { Name = "Michaelmas", FirstDay = new(2022, 9, 7), LastDay = new(2022, 12, 16) },
+                    new() { Name = "Lent", FirstDay = new(2023, 1, 8), LastDay = new(2023, 3, 24) },
+                    new() { Name = "Summer", FirstDay = new(2023, 4, 18), LastDay = new(2023, 7, 8) }
+                },
+                OpeningHours =
+                {
+                    new(DayOfWeek.Sunday, null, null),
+                    new(DayOfWeek.Monday, new(8, 00), new(18, 00)),
+                    new(DayOfWeek.Tuesday, new(8, 00), new(18, 00)),
+                    new(DayOfWeek.Wednesday, new(8, 00), new(18, 00)),
+                    new(DayOfWeek.Thursday, new(8, 00), new(18, 00)),
+                    new(DayOfWeek.Friday, new(8, 00), new(18, 00)),
+                    new(DayOfWeek.Saturday, new(8, 00), new(17, 00))
+                }
+            },
+            new School
+            {
+                Name = "Farr High School",
+                Founded = new(1964, 5, 1),
+                Terms =
+                {
+                    new() { Name = "Autumn", FirstDay = new(2022, 8, 16), LastDay = new(2022, 12, 23) },
+                    new() { Name = "Winter", FirstDay = new(2023, 1, 9), LastDay = new(2023, 3, 31) },
+                    new() { Name = "Summer", FirstDay = new(2023, 4, 17), LastDay = new(2023, 6, 29) }
+                },
+                OpeningHours =
+                {
+                    new(DayOfWeek.Sunday, null, null),
+                    new(DayOfWeek.Monday, new(8, 45), new(15, 35)),
+                    new(DayOfWeek.Tuesday, new(8, 45), new(15, 35)),
+                    new(DayOfWeek.Wednesday, new(8, 45), new(15, 35)),
+                    new(DayOfWeek.Thursday, new(8, 45), new(15, 35)),
+                    new(DayOfWeek.Friday, new(8, 45), new(12, 50)),
+                    new(DayOfWeek.Saturday, null, null)
+                }
+            });
+
+        await SaveChangesAsync();
+    }
+}
+
+public class BritishSchoolsContext : BritishSchoolsContextBase
+{
+}
+
+public class BritishSchoolsContextJson : BritishSchoolsContextBase
+{
+
+    public override bool UsesJson => true;
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        base.OnModelCreating(modelBuilder);
+
+        modelBuilder.Entity<School>().OwnsMany(e => e.OpeningHours).ToJson();
+    }
+}
+
+public class BritishSchoolsContextSqlite : BritishSchoolsContextBase
+{
+    public BritishSchoolsContextSqlite()
+        : base(useSqlite: true)
+    {
+    }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        base.OnModelCreating(modelBuilder);
+
+        modelBuilder.Entity<School>().OwnsMany(
+            e => e.OpeningHours, b =>
+            {
+                b.Property<int>("Id");
+                b.HasKey("Id");
+            });
+    }
+}
+
+#region BritishSchools
+public class School
+{
+    public int Id { get; set; }
+    public string Name { get; set; } = null!;
+    public DateOnly Founded { get; set; }
+    public List<Term> Terms { get; } = new();
+    public List<OpeningHours> OpeningHours { get; } = new();
+}
+
+public class Term
+{
+    public int Id { get; set; }
+    public string Name { get; set; } = null!;
+    public DateOnly FirstDay { get; set; }
+    public DateOnly LastDay { get; set; }
+    public School School { get; set; } = null!;
+}
+
+[Owned]
+public class OpeningHours
+{
+    public OpeningHours(DayOfWeek dayOfWeek, TimeOnly? opensAt, TimeOnly? closesAt)
+    {
+        DayOfWeek = dayOfWeek;
+        OpensAt = opensAt;
+        ClosesAt = closesAt;
+    }
+
+    public DayOfWeek DayOfWeek { get; private set; }
+    public TimeOnly? OpensAt { get; set; }
+    public TimeOnly? ClosesAt { get; set; }
+}
+#endregion
diff --git a/samples/core/Miscellaneous/NewInEFCore8/DefaultConstraintSample.cs b/samples/core/Miscellaneous/NewInEFCore8/DefaultConstraintSample.cs
new file mode 100644
index 0000000000..ca37df95f7
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore8/DefaultConstraintSample.cs
@@ -0,0 +1,196 @@
+namespace NewInEfCore8;
+
+public static class DefaultConstraintSample
+{
+    public static Task Insert_rows_using_database_default_constraint()
+        => DefaultConstraintTest(sqlite: false);
+
+    public static Task Insert_rows_using_database_default_constraint_SQLite()
+        => DefaultConstraintTest(sqlite: true);
+
+    public static async Task DefaultConstraintTest(bool sqlite)
+    {
+        PrintSampleName();
+
+        await using var context = new DatabaseDefaultsContext(useSqlite: sqlite);
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+
+        context.ChangeTracker.Clear();
+
+        Console.WriteLine();
+        Console.WriteLine("Insert user property with int database default:");
+
+        context.AddRange(new User(), new User { Credits = 77 }, new User { Credits = 0 });
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+        Console.WriteLine("Insert user property with enum database default:");
+
+        context.AddRange(new Course(), new Course { Level = Level.Intermediate }, new Course { Level = Level.Beginner });
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+        Console.WriteLine("Insert user property with bool database default:");
+
+        context.AddRange(new Account(), new Account { IsActive = true }, new Account { IsActive = false });
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+        Console.WriteLine("Insert user property with int database default, sentinel configured:");
+
+        context.AddRange(new UserWithSentinel(), new UserWithSentinel { Credits = 77 }, new UserWithSentinel { Credits = 0 });
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+        Console.WriteLine("Insert user property with enum database default, sentinel configured:");
+
+        context.AddRange(new CourseWithSentinel(), new CourseWithSentinel { Level = Level.Intermediate }, new CourseWithSentinel { Level = Level.Beginner });
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+        Console.WriteLine("Insert user property with bool database default, sentinel configured:");
+
+        context.AddRange(new AccountWithSentinel(), new AccountWithSentinel { IsActive = true }, new AccountWithSentinel { IsActive = false });
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+        Console.WriteLine("Insert user property with int database default, nullable backing field:");
+
+        context.AddRange(new UserWithNullableBackingField(), new UserWithNullableBackingField { Credits = 77 }, new UserWithNullableBackingField { Credits = 0 });
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+        Console.WriteLine("Insert user property with enum database default, nullable backing field:");
+
+        context.AddRange(new CourseWithNullableBackingField(), new CourseWithNullableBackingField { Level = Level.Intermediate }, new CourseWithNullableBackingField { Level = Level.Beginner });
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+        Console.WriteLine("Insert user property with bool database default, nullable backing field:");
+
+        context.AddRange(new AccountWithNullableBackingField(), new AccountWithNullableBackingField { IsActive = true }, new AccountWithNullableBackingField { IsActive = false });
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+    }
+
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public class User
+    {
+        public int Id { get; set; }
+        public int Credits { get; set; }
+    }
+
+    public class Account
+    {
+        public int Id { get; set; }
+        public bool IsActive { get; set; }
+    }
+
+    public class Course
+    {
+        public int Id { get; set; }
+        public Level Level { get; set; }
+    }
+
+    public class UserWithSentinel
+    {
+        public int Id { get; set; }
+        public int Credits { get; set; } = -1;
+    }
+
+    public class AccountWithSentinel
+    {
+        public int Id { get; set; }
+        public bool IsActive { get; set; } = true;
+    }
+
+    public class CourseWithSentinel
+    {
+        public int Id { get; set; }
+        public Level Level { get; set; } = Level.Unspecified;
+    }
+
+    public class UserWithNullableBackingField
+    {
+        public int Id { get; set; }
+
+        private int? _credits;
+
+        public int Credits
+        {
+            get => _credits ?? 0;
+            set => _credits = value;
+        }
+    }
+
+    public class AccountWithNullableBackingField
+    {
+        public int Id { get; set; }
+
+        private bool? _isActive;
+
+        public bool IsActive
+        {
+            get => _isActive ?? false;
+            set => _isActive = value;
+        }
+    }
+
+    public class CourseWithNullableBackingField
+    {
+        public int Id { get; set; }
+
+        private Level? _level;
+
+        public Level Level
+        {
+            get => _level ?? Level.Unspecified;
+            set => _level = value;
+        }
+    }
+
+    public enum Level
+    {
+        Beginner,
+        Intermediate,
+        Advanced,
+        Unspecified
+    }
+
+    public class DatabaseDefaultsContext(bool useSqlite = false) : DbContext
+    {
+        public bool UseSqlite { get; } = useSqlite;
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => (UseSqlite
+                    ? optionsBuilder.UseSqlite(@$"DataSource={GetType().Name}.db")
+                    : optionsBuilder.UseSqlServer(
+                        @$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0",
+                        sqlServerOptionsBuilder => sqlServerOptionsBuilder.UseNetTopologySuite()))
+                .EnableSensitiveDataLogging()
+                .LogTo(Console.WriteLine, LogLevel.Information);
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Account>().Property(e => e.IsActive).HasDefaultValueSql("1");
+            modelBuilder.Entity<User>().Property(e => e.Credits).HasDefaultValue(100);
+            modelBuilder.Entity<Course>().Property(e => e.Level).HasDefaultValue(Level.Intermediate);
+
+            modelBuilder.Entity<AccountWithSentinel>().Property(e => e.IsActive).HasDefaultValueSql("1").HasSentinel(true);
+            modelBuilder.Entity<UserWithSentinel>().Property(e => e.Credits).HasDefaultValue(100).HasSentinel(-1);
+            modelBuilder.Entity<CourseWithSentinel>().Property(e => e.Level).HasDefaultValue(Level.Intermediate).HasSentinel(Level.Unspecified);
+
+            modelBuilder.Entity<AccountWithNullableBackingField>().Property(e => e.IsActive).HasDefaultValueSql("1");
+            modelBuilder.Entity<UserWithNullableBackingField>().Property(e => e.Credits).HasDefaultValue(100);
+            modelBuilder.Entity<CourseWithNullableBackingField>().Property(e => e.Level).HasDefaultValue(Level.Intermediate);
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore8/DocumentsContext.cs b/samples/core/Miscellaneous/NewInEFCore8/DocumentsContext.cs
new file mode 100644
index 0000000000..80e72eefb3
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore8/DocumentsContext.cs
@@ -0,0 +1,212 @@
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace NewInEfCore8;
+
+public abstract class Document
+{
+    protected Document(string title, int numberOfPages, DateOnly publicationDate, byte[]? coverArt)
+    {
+        Title = title;
+        NumberOfPages = numberOfPages;
+        PublicationDate = publicationDate;
+        CoverArt = coverArt;
+    }
+
+    public int Id { get; private set; }
+
+    [Timestamp]
+    public byte[]? RowVersion { get; set; }
+
+    public string Title { get; set; }
+    public int NumberOfPages { get; set; }
+    public DateOnly PublicationDate { get; set; }
+    public byte[]? CoverArt { get; set; }
+
+    public DateOnly FirstRecordedOn { get; private set; }
+    public DateOnly RetrievedOn { get; private set; }
+}
+
+public class Book : Document
+{
+    public Book(string title, int numberOfPages, DateOnly publicationDate, byte[]? coverArt)
+        : base(title, numberOfPages, publicationDate, coverArt)
+    {
+    }
+
+    public string? Isbn { get; set; }
+
+    public List<Person> Authors { get; } = new();
+}
+
+public class Magazine : Document
+{
+    public Magazine(string title, int numberOfPages, DateOnly publicationDate, byte[]? coverArt, int issueNumber)
+        : base(title, numberOfPages, publicationDate, coverArt)
+    {
+        IssueNumber = issueNumber;
+    }
+
+    public int IssueNumber { get; set; }
+    public decimal? CoverPrice { get; set; }
+    public Person Editor { get; set; } = null!;
+}
+
+public class Person
+{
+    public Person(string name)
+    {
+        Name = name;
+    }
+
+    public int Id { get; private set; }
+
+    [ConcurrencyCheck]
+    public string Name { get; set; }
+
+    public ContactDetails Contact { get; set; } = null!;
+
+    public List<Book> PublishedWorks { get; } = new();
+    public List<Magazine> Edited { get; } = new();
+}
+
+public abstract class DocumentsContext : DbContext
+{
+    public bool LoggingEnabled { get; set; }
+    public abstract MappingStrategy MappingStrategy { get; }
+
+    public DbSet<Document> Documents => Set<Document>();
+    public DbSet<Book> Books => Set<Book>();
+    public DbSet<Magazine> Magazines => Set<Magazine>();
+    public DbSet<Person> People => Set<Person>();
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.UseSqlServer(@$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0")
+            .EnableSensitiveDataLogging()
+            .LogTo(
+                s =>
+                {
+                    if (LoggingEnabled)
+                    {
+                        Console.WriteLine(s);
+                    }
+                }, new List<EventId> { RelationalEventId.CommandExecuted });
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Document>(
+            entityTypeBuilder =>
+            {
+                entityTypeBuilder.Property(document => document.FirstRecordedOn).HasDefaultValueSql("getutcdate()");
+                entityTypeBuilder.Property(document => document.RetrievedOn).HasComputedColumnSql("getutcdate()");
+            });
+
+        modelBuilder.Entity<Person>(
+            entityTypeBuilder =>
+            {
+                entityTypeBuilder.OwnsOne(
+                    author => author.Contact,
+                    ownedNavigationBuilder =>
+                    {
+                        ownedNavigationBuilder.ToTable("Contacts");
+                        ownedNavigationBuilder.OwnsOne(
+                            contactDetails => contactDetails.Address,
+                            ownedOwnedNavigationBuilder =>
+                            {
+                                ownedOwnedNavigationBuilder.ToTable("Addresses");
+                            });
+                    });
+            });
+
+        modelBuilder.Entity<Book>(
+            entityTypeBuilder =>
+            {
+                entityTypeBuilder
+                    .HasMany(document => document.Authors)
+                    .WithMany(author => author.PublishedWorks)
+                    .UsingEntity<Dictionary<string, object>>(
+                        "BookPerson",
+                        builder => builder.HasOne<Person>().WithMany().OnDelete(DeleteBehavior.Cascade),
+                        builder => builder.HasOne<Book>().WithMany().OnDelete(DeleteBehavior.ClientCascade));
+            });
+    }
+
+    public async Task Seed()
+    {
+        var kentBeck = new Person("Kent Beck")
+        {
+            Contact = new() { Address = new Address("1 Smalltalk Ave", "Camberwick Green", "CW1 5ZH", "UK"), Phone = "01632 12346" }
+        };
+
+        var joshuaBloch = new Person("Joshua Bloch")
+        {
+            Contact = new() { Address = new Address("1 AFS Walk", "Chigley", "CW1 5ZH", "UK"), Phone = "01632 12347" }
+        };
+
+        var nealGafter = new Person("Neal Gafter")
+        {
+            Contact = new() { Address = new Address("1 Merlin Closure", "Chigley", "CW1 5ZH", "UK"), Phone = "01632 12348" }
+        };
+
+        var simonRockman = new Person("Simon Rockman")
+        {
+            Contact = new() { Address = new Address("1 Copper Run", "Camberwick Green", "CW1 5ZH", "UK"), Phone = "01632 12349" }
+        };
+
+        var documents = new List<Document>
+        {
+            new Book("Extreme Programming Explained", 190, new DateOnly(2000, 1, 1), null)
+            {
+                Isbn = "201-61641-6", Authors = { kentBeck }
+            },
+            new Book("Java Puzzlers", 283, new DateOnly(2005, 1, 1), null)
+            {
+                Isbn = "0-321-33678-X", Authors = { joshuaBloch, nealGafter }
+            },
+            new Book("Effective Java", 252, new DateOnly(2001, 1, 1), new byte[] { 1, 2, 3, 4, 5, 6, 7, 8, 9 })
+            {
+                Isbn = "0-201-31005-8", Authors = { joshuaBloch }
+            },
+            new Book("Test-Driven Development By Example", 220, new DateOnly(2003, 1, 1), null)
+            {
+                Isbn = "0-321-14653-0", Authors = { kentBeck }
+            },
+            new Magazine("Amstrad Computer User", 95, new DateOnly(1986, 1, 12), new byte[] { 1, 2, 3 }, 15)
+            {
+                CoverPrice = 0.95m, Editor = simonRockman
+            },
+            new Magazine("Amiga Computing", 90, new DateOnly(1988, 5, 16), null, 1) { CoverPrice = 1.95m, Editor = simonRockman }
+        };
+
+        await AddRangeAsync(documents);
+        await SaveChangesAsync();
+    }
+}
+
+public class TphDocumentsContext : DocumentsContext
+{
+    public override MappingStrategy MappingStrategy => MappingStrategy.Tph;
+}
+
+public class TptDocumentsContext : DocumentsContext
+{
+    public override MappingStrategy MappingStrategy => MappingStrategy.Tpt;
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Document>().UseTptMappingStrategy();
+
+        base.OnModelCreating(modelBuilder);
+    }
+}
+
+public class TpcDocumentsContext : DocumentsContext
+{
+    public override MappingStrategy MappingStrategy => MappingStrategy.Tpc;
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Document>().UseTpcMappingStrategy();
+
+        base.OnModelCreating(modelBuilder);
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore8/ExecuteUpdateDeleteSample.cs b/samples/core/Miscellaneous/NewInEFCore8/ExecuteUpdateDeleteSample.cs
new file mode 100644
index 0000000000..b668184b6a
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore8/ExecuteUpdateDeleteSample.cs
@@ -0,0 +1,171 @@
+namespace NewInEfCore8;
+
+public static class ExecuteUpdateDeleteSample
+{
+    public static Task ExecuteUpdate_ExecuteDelete_with_multiple_entities_targeting_one_table()
+        => ExecuteUpdateDeleteTest(sqlite: false);
+
+    public static Task ExecuteUpdate_ExecuteDelete_with_multiple_entities_targeting_one_table_SQLite()
+        => ExecuteUpdateDeleteTest(sqlite: true);
+
+    public static async Task ExecuteUpdateDeleteTest(bool sqlite)
+    {
+        PrintSampleName();
+
+        await using var context = new CustomerContext(useSqlite: sqlite);
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+
+        context.AddRange(
+            new Store { Customers = { new CustomerWithStores { Name = "Smokey", Region = "France" } }, Region = "France" },
+            new Customer { Name = "Smokey", CustomerInfo = new() { Tag = "EF" } },
+            new CustomerTpt { Name = "Willow" },
+            new SpecialCustomerTpt { Name = "Olive" });
+
+        await context.SaveChangesAsync();
+        context.ChangeTracker.Clear();
+
+        Console.WriteLine();
+        Console.WriteLine("Update properties of owner and owned type mapped to the same table:");
+
+        var name = "Smokey";
+
+        #region UpdateWithOwned
+        await context.Customers
+            .Where(e => e.Name == name)
+            .ExecuteUpdateAsync(
+                s => s.SetProperty(b => b.CustomerInfo.Tag, "Tagged")
+                    .SetProperty(b => b.Name, b => b.Name + "_Tagged"));
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine("Update properties of entities returned by union but targeting a single table:");
+
+        #region UpdateWithUnion
+        await context.CustomersWithStores
+            .Where(e => e.Region == "France")
+            .Union(context.Stores.Where(e => e.Region == "France").SelectMany(e => e.Customers))
+            .ExecuteUpdateAsync(s => s.SetProperty(b => b.Tag, "The French Connection"));
+        #endregion
+
+
+        Console.WriteLine();
+        Console.WriteLine("Update properties of a single table in a TPT hierarchy:");
+
+        #region TptUpdateName
+        await context.TptSpecialCustomers
+            .Where(e => e.Name == name)
+            .ExecuteUpdateAsync(s => s.SetProperty(b => b.Name, b => b.Name + " (Noted)"));
+        #endregion
+
+        #region TptUpdateNote
+        await context.TptSpecialCustomers
+            .Where(e => e.Name == name)
+            .ExecuteUpdateAsync(s => s.SetProperty(b => b.Note, "Noted"));
+        #endregion
+
+        try
+        {
+            Console.WriteLine();
+            Console.WriteLine("Attempt to update properties of two tables in a TPT hierarchy:");
+
+            #region TptUpdateBoth
+            await context.TptSpecialCustomers
+                .Where(e => e.Name == name)
+                .ExecuteUpdateAsync(s => s.SetProperty(b => b.Note, "Noted")
+                    .SetProperty(b => b.Name, b => b.Name + " (Noted)"));
+            #endregion
+        }
+        catch (InvalidOperationException e)
+        {
+            Console.WriteLine(e.Message);
+        }
+
+        Console.WriteLine();
+        Console.WriteLine("Delete owner with  owned type mapped to the same table:");
+
+        await context.Customers.Where(e => e.Name == name).ExecuteDeleteAsync();
+
+        Console.WriteLine();
+        Console.WriteLine("Delete entities returned by union but targeting a single table:");
+
+        await context.CustomersWithStores
+            .Where(e => e.Region == "France")
+            .Union(context.Stores.Where(e => e.Region == "France").SelectMany(e => e.Customers))
+            .ExecuteDeleteAsync();
+
+        Console.WriteLine();
+    }
+
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    #region CustomerTpt
+    [Table("TptSpecialCustomers")]
+    public class SpecialCustomerTpt : CustomerTpt
+    {
+        public string? Note { get; set; }
+    }
+
+    [Table("TptCustomers")]
+    public class CustomerTpt
+    {
+        public int Id { get; set; }
+        public required string Name { get; set; }
+    }
+    #endregion
+
+    #region CustomerAndInfo
+    public class Customer
+    {
+        public int Id { get; set; }
+        public required string Name { get; set; }
+        public required CustomerInfo CustomerInfo { get; set; }
+    }
+
+    [Owned]
+    public class CustomerInfo
+    {
+        public string? Tag { get; set; }
+    }
+    #endregion
+
+    public class CustomerWithStores
+    {
+        public int Id { get; set; }
+        public required string Name { get; set; }
+        public string? Region { get; set; }
+        public string? Tag { get; set; }
+    }
+
+    public class Store
+    {
+        public int Id { get; set; }
+        public List<CustomerWithStores> Customers { get; } = new();
+        public string? Region { get; set; }
+    }
+
+    public class CustomerContext(bool useSqlite = false) : DbContext
+    {
+        public bool UseSqlite { get; } = useSqlite;
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => (UseSqlite
+                    ? optionsBuilder.UseSqlite(@$"DataSource={GetType().Name}.db")
+                    : optionsBuilder.UseSqlServer(
+                        @$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0",
+                        sqlServerOptionsBuilder => sqlServerOptionsBuilder.UseNetTopologySuite()))
+                .EnableSensitiveDataLogging()
+                .LogTo(Console.WriteLine, LogLevel.Information);
+
+        public DbSet<Customer> Customers => Set<Customer>();
+        public DbSet<CustomerWithStores> CustomersWithStores => Set<CustomerWithStores>();
+        public DbSet<Store> Stores => Set<Store>();
+        public DbSet<CustomerTpt> TptCustomers => Set<CustomerTpt>();
+        public DbSet<SpecialCustomerTpt> TptSpecialCustomers => Set<SpecialCustomerTpt>();
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs b/samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs
new file mode 100644
index 0000000000..f319ce386e
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore8/HierarchyIdSample.cs
@@ -0,0 +1,288 @@
+namespace NewInEfCore8;
+
+public static class HierarchyIdSample
+{
+    public static async Task SQL_Server_HierarchyId()
+    {
+        PrintSampleName();
+
+        await using var context = new FamilyTreeContext();
+        await context.Database.EnsureDeletedAsync();
+
+        context.LoggingEnabled = true;
+
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.ChangeTracker.Clear();
+
+        context.LoggingEnabled = false;
+        Console.WriteLine();
+
+        var level = 0;
+        while (true)
+        {
+            #region GetLevel
+            var generation = await context.Halflings.Where(halfling => halfling.PathFromPatriarch.GetLevel() == level).ToListAsync();
+            #endregion
+
+            if (!generation.Any())
+            {
+                break;
+            }
+
+            Console.Write($"Generation {level}: ");
+
+            for (var i = 0; i < generation.Count; i++)
+            {
+                var halfling = generation[i];
+                Console.Write($"{halfling.Name}");
+                if (i < generation.Count - 1)
+                {
+                    Console.Write(", ");
+                }
+            }
+
+            Console.WriteLine();
+
+            level++;
+        }
+
+        Console.WriteLine();
+        context.LoggingEnabled = true;
+
+        var directAncestor = (await FindDirectAncestor("Bilbo"))!;
+        Console.WriteLine();
+        Console.WriteLine($"The direct ancestor of Bilbo is {directAncestor.Name}");
+
+        #region FindDirectAncestor
+        async Task<Halfling?> FindDirectAncestor(string name)
+            => await context.Halflings
+                .SingleOrDefaultAsync(
+                    ancestor => ancestor.PathFromPatriarch == context.Halflings
+                        .Single(descendent => descendent.Name == name).PathFromPatriarch
+                        .GetAncestor(1));
+        #endregion
+
+        Console.WriteLine();
+        var ancestors = await FindAllAncestors("Bilbo").AsNoTracking().ToListAsync();
+
+        Console.WriteLine();
+        Console.WriteLine("Ancestors of Bilbo are:");
+        foreach (var halfling in ancestors)
+        {
+            Console.WriteLine($"  {halfling.Name}");
+        }
+
+        #region FindAllAncestors
+        IQueryable<Halfling> FindAllAncestors(string name)
+            => context.Halflings.Where(
+                    ancestor => context.Halflings
+                        .Single(
+                            descendent =>
+                                descendent.Name == name
+                                && ancestor.Id != descendent.Id)
+                        .PathFromPatriarch.IsDescendantOf(ancestor.PathFromPatriarch))
+                .OrderByDescending(ancestor => ancestor.PathFromPatriarch.GetLevel());
+        #endregion
+
+        Console.WriteLine();
+        var directDescendents = await FindDirectDescendents("Mungo").AsNoTracking().ToListAsync();
+
+        Console.WriteLine();
+        Console.WriteLine("Direct descendents of Mungo:");
+        foreach (var descendent in directDescendents)
+        {
+            Console.WriteLine($"  {descendent.Name}");
+        }
+
+        #region FindDirectDescendents
+        IQueryable<Halfling> FindDirectDescendents(string name)
+            => context.Halflings.Where(
+                descendent => descendent.PathFromPatriarch.GetAncestor(1) == context.Halflings
+                    .Single(ancestor => ancestor.Name == name).PathFromPatriarch);
+        #endregion
+
+        Console.WriteLine();
+        var descendents = await FindAllDescendents("Mungo").AsNoTracking().ToListAsync();
+
+        Console.WriteLine();
+        Console.WriteLine("All descendents of Mungo:");
+        foreach (var descendent in descendents)
+        {
+            Console.WriteLine($"  {descendent.Name}");
+        }
+
+        #region FindAllDescendents
+        IQueryable<Halfling> FindAllDescendents(string name)
+            => context.Halflings.Where(
+                    descendent => descendent.PathFromPatriarch.IsDescendantOf(
+                        context.Halflings
+                            .Single(
+                                ancestor =>
+                                    ancestor.Name == name
+                                    && descendent.Id != ancestor.Id)
+                            .PathFromPatriarch))
+                .OrderBy(descendent => descendent.PathFromPatriarch.GetLevel());
+        #endregion
+
+        context.LoggingEnabled = false;
+
+        Console.WriteLine();
+        Console.WriteLine("All descendents of Ponto:");
+        foreach (var descendent in await FindAllDescendents("Ponto").AsNoTracking().ToListAsync())
+        {
+            Console.WriteLine($"  {descendent.Name}");
+        }
+
+        var mungo = await context.Halflings.SingleAsync(halfling => halfling.Name == "Mungo");
+        var ponto = await context.Halflings.SingleAsync(halfling => halfling.Name == "Ponto" && halfling.YearOfBirth == 1216);
+
+        #region LongoAndDescendents
+        var longoAndDescendents = await context.Halflings.Where(
+                descendent => descendent.PathFromPatriarch.IsDescendantOf(
+                    context.Halflings.Single(ancestor => ancestor.Name == "Longo").PathFromPatriarch))
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine("Reparenting of Longo from Mungo to Ponto:");
+        Console.WriteLine();
+
+        context.LoggingEnabled = true;
+
+        #region GetReparentedValue
+        foreach (var descendent in longoAndDescendents)
+        {
+            descendent.PathFromPatriarch
+                = descendent.PathFromPatriarch.GetReparentedValue(
+                    mungo.PathFromPatriarch, ponto.PathFromPatriarch)!;
+        }
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        context.LoggingEnabled = false;
+
+        Console.WriteLine();
+        Console.WriteLine("All descendents of Mungo:");
+        foreach (var descendent in await FindAllDescendents("Mungo").AsNoTracking().ToListAsync())
+        {
+            Console.WriteLine($"  {descendent.Name}");
+        }
+
+        Console.WriteLine();
+        Console.WriteLine("All descendents of Ponto:");
+        foreach (var descendent in await FindAllDescendents("Ponto").AsNoTracking().ToListAsync())
+        {
+            Console.WriteLine($"  {descendent.Name}");
+        }
+
+        Console.WriteLine();
+        context.LoggingEnabled = true;
+
+        var bilbo = await context.Halflings.SingleAsync(halfling => halfling.Name == "Bilbo");
+        var frodo = await context.Halflings.SingleAsync(halfling => halfling.Name == "Frodo");
+
+        var commonAncestor = (await FindCommonAncestor(bilbo, frodo))!;
+        Console.WriteLine();
+        Console.WriteLine($"The common ancestor of Bilbo and Frodo is {commonAncestor.Name}");
+
+        #region FindCommonAncestor
+        async Task<Halfling?> FindCommonAncestor(Halfling first, Halfling second)
+            => await context.Halflings
+                .Where(
+                    ancestor => first.PathFromPatriarch.IsDescendantOf(ancestor.PathFromPatriarch)
+                                && second.PathFromPatriarch.IsDescendantOf(ancestor.PathFromPatriarch))
+                .OrderByDescending(ancestor => ancestor.PathFromPatriarch.GetLevel())
+                .FirstOrDefaultAsync();
+        #endregion
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    #region Halfling
+    public class Halfling
+    {
+        public Halfling(HierarchyId pathFromPatriarch, string name, int? yearOfBirth = null)
+        {
+            PathFromPatriarch = pathFromPatriarch;
+            Name = name;
+            YearOfBirth = yearOfBirth;
+        }
+
+        public int Id { get; private set; }
+        public HierarchyId PathFromPatriarch { get; set; }
+        public string Name { get; set; }
+        public int? YearOfBirth { get; set; }
+    }
+    #endregion
+
+    public class FamilyTreeContext : DbContext
+    {
+        public bool LoggingEnabled { get; set; }
+
+        public DbSet<Halfling> Halflings => Set<Halfling>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder.UseSqlServer(
+                    @$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0",
+                    sqlServerOptionsBuilder => sqlServerOptionsBuilder.UseHierarchyId())
+                .EnableSensitiveDataLogging()
+                .LogTo(
+                    s =>
+                    {
+                        if (LoggingEnabled)
+                        {
+                            Console.WriteLine(s);
+                        }
+                    }, LogLevel.Information);
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+        }
+
+        public async Task Seed()
+        {
+            #region AddRangeAsync
+            await AddRangeAsync(
+                new Halfling(HierarchyId.Parse("/"), "Balbo", 1167),
+                new Halfling(HierarchyId.Parse("/1/"), "Mungo", 1207),
+                new Halfling(HierarchyId.Parse("/2/"), "Pansy", 1212),
+                new Halfling(HierarchyId.Parse("/3/"), "Ponto", 1216),
+                new Halfling(HierarchyId.Parse("/4/"), "Largo", 1220),
+                new Halfling(HierarchyId.Parse("/5/"), "Lily", 1222),
+                new Halfling(HierarchyId.Parse("/1/1/"), "Bungo", 1246),
+                new Halfling(HierarchyId.Parse("/1/2/"), "Belba", 1256),
+                new Halfling(HierarchyId.Parse("/1/3/"), "Longo", 1260),
+                new Halfling(HierarchyId.Parse("/1/4/"), "Linda", 1262),
+                new Halfling(HierarchyId.Parse("/1/5/"), "Bingo", 1264),
+                new Halfling(HierarchyId.Parse("/3/1/"), "Rosa", 1256),
+                new Halfling(HierarchyId.Parse("/3/2/"), "Polo"),
+                new Halfling(HierarchyId.Parse("/4/1/"), "Fosco", 1264),
+                new Halfling(HierarchyId.Parse("/1/1/1/"), "Bilbo", 1290),
+                new Halfling(HierarchyId.Parse("/1/3/1/"), "Otho", 1310),
+                new Halfling(HierarchyId.Parse("/1/5/1/"), "Falco", 1303),
+                new Halfling(HierarchyId.Parse("/3/2/1/"), "Posco", 1302),
+                new Halfling(HierarchyId.Parse("/3/2/2/"), "Prisca", 1306),
+                new Halfling(HierarchyId.Parse("/4/1/1/"), "Dora", 1302),
+                new Halfling(HierarchyId.Parse("/4/1/2/"), "Drogo", 1308),
+                new Halfling(HierarchyId.Parse("/4/1/3/"), "Dudo", 1311),
+                new Halfling(HierarchyId.Parse("/1/3/1/1/"), "Lotho", 1310),
+                new Halfling(HierarchyId.Parse("/1/5/1/1/"), "Poppy", 1344),
+                new Halfling(HierarchyId.Parse("/3/2/1/1/"), "Ponto", 1346),
+                new Halfling(HierarchyId.Parse("/3/2/1/2/"), "Porto", 1348),
+                new Halfling(HierarchyId.Parse("/3/2/1/3/"), "Peony", 1350),
+                new Halfling(HierarchyId.Parse("/4/1/2/1/"), "Frodo", 1368),
+                new Halfling(HierarchyId.Parse("/4/1/3/1/"), "Daisy", 1350),
+                new Halfling(HierarchyId.Parse("/3/2/1/1/1/"), "Angelica", 1381));
+
+            await SaveChangesAsync();
+            #endregion
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore8/ImmutableComplexTypesSample.cs b/samples/core/Miscellaneous/NewInEFCore8/ImmutableComplexTypesSample.cs
new file mode 100644
index 0000000000..2b43a775dc
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore8/ImmutableComplexTypesSample.cs
@@ -0,0 +1,156 @@
+namespace NewInEfCore8;
+
+public static class ImmutableComplexTypesSample
+{
+    public static Task Use_immutable_class_as_complex_type()
+    {
+        PrintSampleName();
+        return ComplexTypeTest<CustomerContext>();
+    }
+
+    public static Task Use_immutable_class_as_complex_type_SQLite()
+    {
+        PrintSampleName();
+        return ComplexTypeTest<CustomerContextSqlite>();
+    }
+
+    private static async Task ComplexTypeTest<TContext>()
+        where TContext : CustomerContextBase, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.LoggingEnabled = true;
+        context.ChangeTracker.Clear();
+
+        var customer = new Customer() { Name = "Willow", Address = new("Barking Gate", null, "Walpole St Peter", "UK", "PE14 7AV") };
+
+        context.Add(customer);
+        await context.SaveChangesAsync();
+
+        customer.Orders.Add(
+            new Order { Contents = "Tesco Tasty Treats", BillingAddress = customer.Address, ShippingAddress = customer.Address, });
+
+        await context.SaveChangesAsync();
+
+        #region ChangeImmutableAddress
+        var currentAddress = customer.Address;
+        customer.Address = new Address(
+            "Peacock Lodge", currentAddress.Line2, currentAddress.City, currentAddress.Country, currentAddress.PostCode);
+
+        await context.SaveChangesAsync();
+        #endregion
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public class Customer
+    {
+        public int Id { get; set; }
+        public required string Name { get; set; }
+        public required Address Address { get; set; }
+        public List<Order> Orders { get; } = new();
+    }
+
+    public class Order
+    {
+        public int Id { get; set; }
+        public required string Contents { get; set; }
+        public required Address ShippingAddress { get; set; }
+        public required Address BillingAddress { get; set; }
+        public Customer Customer { get; set; } = null!;
+    }
+
+    public class Address(string line1, string? line2, string city, string country, string postCode)
+    {
+        public string Line1 { get; } = line1;
+        public string? Line2 { get; } = line2;
+        public string City { get; } = city;
+        public string Country { get; } = country;
+        public string PostCode { get; } = postCode;
+    }
+
+    public class CustomerContext : CustomerContextBase
+    {
+    }
+
+    public class CustomerContextSqlite : CustomerContextBase
+    {
+        public CustomerContextSqlite()
+            : base(useSqlite: true)
+        {
+        }
+    }
+
+    public abstract class CustomerContextBase(bool useSqlite = false) : DbContext
+    {
+        public bool UseSqlite { get; } = useSqlite;
+        public bool LoggingEnabled { get; set; }
+
+        public DbSet<Customer> Customers => Set<Customer>();
+        public DbSet<Order> Orders => Set<Order>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => (UseSqlite
+                    ? optionsBuilder.UseSqlite(@$"DataSource={GetType().Name}.db")
+                    : optionsBuilder.UseSqlServer(
+                        @$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0"))
+                //sqlServerOptionsBuilder => sqlServerOptionsBuilder.UseCompatibilityLevel(120)))
+                .EnableSensitiveDataLogging()
+                .LogTo(
+                    s =>
+                    {
+                        if (LoggingEnabled)
+                        {
+                            Console.WriteLine(s);
+                        }
+                    }, LogLevel.Information);
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Customer>().ComplexProperty(e => e.Address,
+                b =>
+                {
+                    b.Property(e => e.Line1);
+                    b.Property(e => e.Line2);
+                    b.Property(e => e.City);
+                    b.Property(e => e.Country);
+                    b.Property(e => e.PostCode);
+                });
+
+            modelBuilder.Entity<Order>(b =>
+            {
+                b.ComplexProperty(e => e.BillingAddress,
+                    b =>
+                    {
+                        b.Property(e => e.Line1);
+                        b.Property(e => e.Line2);
+                        b.Property(e => e.City);
+                        b.Property(e => e.Country);
+                        b.Property(e => e.PostCode);
+                    });
+
+                b.ComplexProperty(e => e.ShippingAddress,
+                    b =>
+                    {
+                        b.Property(e => e.Line1);
+                        b.Property(e => e.Line2);
+                        b.Property(e => e.City);
+                        b.Property(e => e.Country);
+                        b.Property(e => e.PostCode);
+                    });
+            });
+        }
+
+        public async Task Seed()
+        {
+            await SaveChangesAsync();
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore8/ImmutableStructComplexTypesSample.cs b/samples/core/Miscellaneous/NewInEFCore8/ImmutableStructComplexTypesSample.cs
new file mode 100644
index 0000000000..8bfb3ed97b
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore8/ImmutableStructComplexTypesSample.cs
@@ -0,0 +1,162 @@
+namespace NewInEfCore8;
+
+public static class ImmutableStructComplexTypesSample
+{
+    public static Task Use_immutable_struct_as_complex_type()
+    {
+        PrintSampleName();
+        return ComplexTypeTest<CustomerContext>();
+    }
+
+    public static Task Use_immutable_struct_as_complex_type_SQLite()
+    {
+        PrintSampleName();
+        return ComplexTypeTest<CustomerContextSqlite>();
+    }
+
+    private static async Task ComplexTypeTest<TContext>()
+        where TContext : CustomerContextBase, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.LoggingEnabled = true;
+        context.ChangeTracker.Clear();
+
+        var customer = new Customer()
+        {
+            Name = "Willow",
+            Address = new("Barking Gate", null, "Walpole St Peter", "UK", "PE14 7AV")
+        };
+
+        context.Add(customer);
+        await context.SaveChangesAsync();
+
+        customer.Orders.Add(
+            new Order { Contents = "Tesco Tasty Treats", BillingAddress = customer.Address, ShippingAddress = customer.Address, });
+
+        await context.SaveChangesAsync();
+
+        #region UpdateImmutableStruct
+        var currentAddress = customer.Address;
+        customer.Address = new Address(
+            "Peacock Lodge", currentAddress.Line2, currentAddress.City, currentAddress.Country, currentAddress.PostCode);
+
+        await context.SaveChangesAsync();
+        #endregion
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public class Customer
+    {
+        public int Id { get; set; }
+        public required string Name { get; set; }
+        public required Address Address { get; set; }
+        public List<Order> Orders { get; } = new();
+    }
+
+    public class Order
+    {
+        public int Id { get; set; }
+        public required string Contents { get; set; }
+        public required Address ShippingAddress { get; set; }
+        public required Address BillingAddress { get; set; }
+        public Customer Customer { get; set; } = null!;
+    }
+
+    #region AddressImmutableStruct
+    public readonly struct Address(string line1, string? line2, string city, string country, string postCode)
+    {
+        public string Line1 { get; } = line1;
+        public string? Line2 { get; } = line2;
+        public string City { get; } = city;
+        public string Country { get; } = country;
+        public string PostCode { get; } = postCode;
+    }
+    #endregion
+
+    public class CustomerContext : CustomerContextBase
+    {
+    }
+
+    public class CustomerContextSqlite : CustomerContextBase
+    {
+        public CustomerContextSqlite()
+            : base(useSqlite: true)
+        {
+        }
+    }
+
+    public abstract class CustomerContextBase(bool useSqlite = false) : DbContext
+    {
+        public bool UseSqlite { get; } = useSqlite;
+        public bool LoggingEnabled { get; set; }
+
+        public DbSet<Customer> Customers => Set<Customer>();
+        public DbSet<Order> Orders => Set<Order>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => (UseSqlite
+                    ? optionsBuilder.UseSqlite(@$"DataSource={GetType().Name}.db")
+                    : optionsBuilder.UseSqlServer(
+                        @$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0"))
+                //sqlServerOptionsBuilder => sqlServerOptionsBuilder.UseCompatibilityLevel(120)))
+                .EnableSensitiveDataLogging()
+                .LogTo(
+                    s =>
+                    {
+                        if (LoggingEnabled)
+                        {
+                            Console.WriteLine(s);
+                        }
+                    }, LogLevel.Information);
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Customer>().ComplexProperty(e => e.Address,
+                b =>
+                {
+                    b.Property(e => e.Line1);
+                    b.Property(e => e.Line2);
+                    b.Property(e => e.City);
+                    b.Property(e => e.Country);
+                    b.Property(e => e.PostCode);
+                });
+
+            modelBuilder.Entity<Order>(b =>
+            {
+                b.ComplexProperty(e => e.BillingAddress,
+                    b =>
+                    {
+                        b.Property(e => e.Line1);
+                        b.Property(e => e.Line2);
+                        b.Property(e => e.City);
+                        b.Property(e => e.Country);
+                        b.Property(e => e.PostCode);
+                    });
+
+                b.ComplexProperty(e => e.ShippingAddress,
+                    b =>
+                    {
+                        b.Property(e => e.Line1);
+                        b.Property(e => e.Line2);
+                        b.Property(e => e.City);
+                        b.Property(e => e.Country);
+                        b.Property(e => e.PostCode);
+                    });
+            });
+        }
+
+        public async Task Seed()
+        {
+            await SaveChangesAsync();
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore8/InheritanceSample.cs b/samples/core/Miscellaneous/NewInEFCore8/InheritanceSample.cs
new file mode 100644
index 0000000000..c8c4d42111
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore8/InheritanceSample.cs
@@ -0,0 +1,30 @@
+namespace NewInEfCore8;
+
+public static class InheritanceSample
+{
+    public static Task Discriminator_length_TPH()
+    {
+        PrintSampleName();
+        return DiscriminatorLengthTest<TphDocumentsContext>();
+    }
+    private static async Task DiscriminatorLengthTest<TContext>()
+        where TContext : DocumentsContext, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        context.LoggingEnabled = true;
+
+        Console.WriteLine("Creating database tables...");
+        Console.WriteLine();
+
+        await context.Database.EnsureCreatedAsync();
+
+        Console.WriteLine();
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore8/JsonColumnsSample.cs b/samples/core/Miscellaneous/NewInEFCore8/JsonColumnsSample.cs
new file mode 100644
index 0000000000..f4f4728b50
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore8/JsonColumnsSample.cs
@@ -0,0 +1,325 @@
+using System.Net;
+
+namespace NewInEfCore8;
+
+public static class JsonColumnsSample
+{
+    public static Task Json_columns_with_TPH()
+    {
+        PrintSampleName();
+        return JsonColumnsTest<JsonBlogsContext>();
+    }
+
+    public static Task Json_columns_with_TPH_on_SQLite()
+    {
+        PrintSampleName();
+        return JsonColumnsTest<JsonBlogsContextSqlite>();
+    }
+
+    private static async Task JsonColumnsTest<TContext>()
+        where TContext : BlogsContext, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.LoggingEnabled = true;
+        context.ChangeTracker.Clear();
+
+        #region CollectionIndexPredicate
+        var cutoff = DateOnly.FromDateTime(DateTime.UtcNow - TimeSpan.FromDays(365));
+        var updatedPosts = await context.Posts
+            .Where(
+                p => p.Metadata!.Updates[0].UpdatedOn < cutoff
+                     && p.Metadata!.Updates[1].UpdatedOn < cutoff)
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var post in updatedPosts)
+        {
+            Console.WriteLine($"Post '{post.Title.Substring(0, 10)}...' with updates on {post.Metadata!.Updates[0].UpdatedOn} and {post.Metadata.Updates[1].UpdatedOn}.");
+        }
+
+        Console.WriteLine();
+
+        #region CollectionIndexNestedPredicate
+        var twentyTen = DateOnly.FromDateTime(new DateTime(2010, 1, 1));
+        var postsWithFirstCommit = await context.Posts
+            .Where(
+                p => p.Metadata!.Updates[0].UpdatedOn > twentyTen
+                     && p.Metadata!.Updates[0].Commits[0].Comment == "Commit #1")
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var post in postsWithFirstCommit)
+        {
+            Console.WriteLine($"Post '{post.Title.Substring(0, 10)}...' with first commit on {post.Metadata!.Updates[0].Commits[0].CommittedOn}.");
+        }
+
+        Console.WriteLine();
+
+        #region CollectionIndexProjectionNullable
+        var postsAndRecentUpdatesNullable = await context.Posts
+            .Select(p => new
+            {
+                p.Title,
+                LatestUpdate = (DateOnly?)p.Metadata!.Updates[0].UpdatedOn,
+                SecondLatestUpdate = (DateOnly?)p.Metadata.Updates[1].UpdatedOn
+            })
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var post in postsAndRecentUpdatesNullable)
+        {
+            Console.WriteLine($"Post '{post.Title.Substring(0, 10)}...' with updates on {post.LatestUpdate?.ToString() ?? "<none>"} and {post.SecondLatestUpdate?.ToString() ?? "<none>"}.");
+        }
+
+        Console.WriteLine();
+
+#pragma warning disable CS8073
+        #region CollectionIndexProjection
+        var postsAndRecentUpdates = await context.Posts
+            .Where(p => p.Metadata!.Updates[0].UpdatedOn != null
+                        && p.Metadata!.Updates[1].UpdatedOn != null)
+            .Select(p => new
+            {
+                p.Title,
+                LatestUpdate = p.Metadata!.Updates[0].UpdatedOn,
+                SecondLatestUpdate = p.Metadata.Updates[1].UpdatedOn
+            })
+            .ToListAsync();
+        #endregion
+#pragma warning restore CS8073
+
+        Console.WriteLine();
+        foreach (var post in postsAndRecentUpdates)
+        {
+            Console.WriteLine($"Post '{post.Title.Substring(0, 10)}...' with updates on {post.LatestUpdate} and {post.SecondLatestUpdate}.");
+        }
+
+        Console.WriteLine();
+
+        #region CollectionIndexNestedProjection
+        var postsAndFirstCommit = await context.Posts
+            .Select(p => new
+            {
+                p.Title,
+                CommitComment = (string?)p.Metadata!.Updates[0].Commits[0].Comment
+            })
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var post in postsAndFirstCommit)
+        {
+            Console.WriteLine($"Post '{post.Title.Substring(0, 10)}...' with commit '{post.CommitComment?.ToString() ?? "<none>"}'.");
+        }
+
+        Console.WriteLine();
+
+        #region AuthorsInChigley
+        var authorsInChigley = await context.Authors
+            .Where(author => author.Contact.Address.City == "Chigley")
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var author in authorsInChigley)
+        {
+            Console.WriteLine($"{author.Name} lives at '{author.Contact.Address.Street}' in Chigley.");
+        }
+
+        Console.WriteLine();
+
+        #region PostcodesInChigley
+        var postcodesInChigley = await context.Authors
+            .Where(author => author.Contact.Address.City == "Chigley")
+            .Select(author => author.Contact.Address.Postcode)
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine($"Postcodes in Chigley are '{string.Join("', '", postcodesInChigley)}'");
+        Console.WriteLine();
+
+        #region OrderedAddresses
+        var orderedAddresses = await context.Authors
+            .Where(
+                author => (author.Contact.Address.City == "Chigley"
+                           && author.Contact.Phone != null)
+                          || author.Name.StartsWith("D"))
+            .OrderBy(author => author.Contact.Phone)
+            .Select(
+                author => author.Name + " (" + author.Contact.Address.Street
+                          + ", " + author.Contact.Address.City
+                          + " " + author.Contact.Address.Postcode + ")")
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var address in orderedAddresses)
+        {
+            Console.WriteLine(address);
+        }
+
+        Console.WriteLine();
+
+        var authorsInChigleyWithPosts = await context.Authors
+            .Where(
+                author => author.Contact.Address.City == "Chigley"
+                          && author.Posts.Count > 1)
+            .Include(author => author.Posts)
+            .ToListAsync();
+
+        Console.WriteLine();
+        foreach (var author in authorsInChigleyWithPosts)
+        {
+            Console.WriteLine($"{author.Name} has {author.Posts.Count} posts");
+        }
+
+        Console.WriteLine();
+
+        #region PostsWithViews
+        var postsWithViews = await context.Posts.Where(post => post.Metadata!.Views > 3000)
+            .AsNoTracking()
+            .Select(
+                post => new
+                {
+                    post.Author!.Name, post.Metadata!.Views, Searches = post.Metadata.TopSearches, Commits = post.Metadata.Updates
+                })
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var postWithViews in postsWithViews)
+        {
+            Console.WriteLine(
+                $"Post by {postWithViews.Name} with {postWithViews.Views} views had {postWithViews.Commits.Count} commits with {postWithViews.Searches.Sum(term => term.Count)} searches");
+        }
+
+        Console.WriteLine();
+
+        #region PostsWithSearchTerms
+        var searchTerms = new[] { "Search #2", "Search #3", "Search #5", "Search #8", "Search #13", "Search #21", "Search #34" };
+
+        var postsWithSearchTerms = await context.Posts
+            .Where(post => post.Metadata!.TopSearches.Any(s => searchTerms.Contains(s.Term)))
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var postWithTerm in postsWithSearchTerms)
+        {
+            Console.WriteLine(
+                $"Post {postWithTerm.Id} with terms '{string.Join("', '", postWithTerm.Metadata!.TopSearches.Select(s => s.Term))}'");
+        }
+
+        Console.WriteLine();
+
+        context.ChangeTracker.Clear();
+
+        Console.WriteLine("Updating a 'Contact' JSON document...");
+        Console.WriteLine();
+
+        #region UpdateDocument
+        var jeremy = await context.Authors.SingleAsync(author => author.Name.StartsWith("Jeremy"));
+
+        jeremy.Contact = new() { Address = new("2 Riverside", "Trimbridge", "TB1 5ZS", "UK"), Phone = "01632 88346" };
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        context.ChangeTracker.Clear();
+
+        Console.WriteLine("Updating an 'Address' inside the 'Contact' JSON document...");
+        Console.WriteLine();
+
+        #region UpdateSubDocument
+        var brice = await context.Authors.SingleAsync(author => author.Name.StartsWith("Brice"));
+
+        brice.Contact.Address = new("4 Riverside", "Trimbridge", "TB1 5ZS", "UK");
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        context.ChangeTracker.Clear();
+
+        Console.WriteLine();
+        Console.WriteLine("Updating only 'Country' in a 'Contact' JSON document...");
+        Console.WriteLine();
+
+        #region UpdateProperty
+        var arthur = await context.Authors.SingleAsync(author => author.Name.StartsWith("Arthur"));
+
+        arthur.Contact.Address.Country = "United Kingdom";
+
+        await context.SaveChangesAsync();
+        #endregion
+
+        Console.WriteLine();
+
+        context.ChangeTracker.Clear();
+
+        var hackingPost = await context.Posts.SingleAsync(post => post.Title.StartsWith("Hacking"));
+
+        hackingPost.Metadata!.Updates.Add(new PostUpdate(IPAddress.Broadcast, DateOnly.FromDateTime(DateTime.UtcNow)) { UpdatedBy = "User" });
+        hackingPost.Metadata!.TopGeographies.Clear();
+
+        await context.SaveChangesAsync();
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+}
+
+public abstract class JsonBlogsContextBase : BlogsContext
+{
+    protected JsonBlogsContextBase(bool useSqlite = false)
+        : base(useSqlite)
+    {
+    }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Author>().OwnsOne(
+            author => author.Contact, ownedNavigationBuilder =>
+            {
+                ownedNavigationBuilder.ToJson();
+                ownedNavigationBuilder.OwnsOne(contactDetails => contactDetails.Address);
+            });
+
+        #region PostMetadataConfig
+        modelBuilder.Entity<Post>().OwnsOne(
+            post => post.Metadata, ownedNavigationBuilder =>
+            {
+                ownedNavigationBuilder.ToJson();
+                ownedNavigationBuilder.OwnsMany(metadata => metadata.TopSearches);
+                ownedNavigationBuilder.OwnsMany(metadata => metadata.TopGeographies);
+                ownedNavigationBuilder.OwnsMany(
+                    metadata => metadata.Updates,
+                    ownedOwnedNavigationBuilder => ownedOwnedNavigationBuilder.OwnsMany(update => update.Commits));
+            });
+        #endregion
+
+        base.OnModelCreating(modelBuilder);
+    }
+}
+
+public class JsonBlogsContext : JsonBlogsContextBase
+{
+}
+
+public class JsonBlogsContextSqlite : JsonBlogsContextBase
+{
+    public JsonBlogsContextSqlite()
+        : base(useSqlite: true)
+    {
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore8/LazyLoadingSample.cs b/samples/core/Miscellaneous/NewInEFCore8/LazyLoadingSample.cs
new file mode 100644
index 0000000000..6efa23470c
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore8/LazyLoadingSample.cs
@@ -0,0 +1,129 @@
+namespace NewInEfCore8;
+
+public static class LazyLoadingSample
+{
+    public static Task Lazy_loading_for_no_tracking_queries()
+    {
+        PrintSampleName();
+        return LazyLoadingTest<LazyLoadingBlogsContext>();
+    }
+
+    public static Task Lazy_loading_for_no_tracking_queries_SQLite()
+    {
+        PrintSampleName();
+        return LazyLoadingTest<LazyLoadingBlogsContextSqlite>();
+    }
+
+    private static async Task LazyLoadingTest<TContext>()
+        where TContext : BlogsContext, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.LoggingEnabled = true;
+        context.ChangeTracker.Clear();
+        var x = 1;
+
+        #region NoTrackingForBlogs
+        var blogs = await context.Blogs.AsNoTracking().ToListAsync();
+        #endregion
+
+        Console.WriteLine("Blogs:");
+        for (var i = 0; i < blogs.Count; i++)
+        {
+            Console.WriteLine($" ({i + 1}) {blogs[i].Name} ");
+        }
+
+        #region ChooseABlog
+        Console.WriteLine();
+        Console.Write("Choose a blog: ");
+        if (int.TryParse(ReadLine(), out var blogId))
+        {
+            Console.WriteLine("Posts:");
+            foreach (var post in blogs[blogId - 1].Posts)
+            {
+                Console.WriteLine($"  {post.Title}");
+            }
+        }
+        #endregion
+
+        Console.WriteLine();
+        Console.Write("Choose another blog: ");
+        if (int.TryParse(ReadLine(), out blogId))
+        {
+            var blog = blogs[blogId - 1];
+            #region ExplicitLoad
+            await context.Entry(blog).Collection(e => e.Posts).LoadAsync();
+            #endregion
+            Console.WriteLine("Posts:");
+            foreach (var post in blog.Posts)
+            {
+                Console.WriteLine($"  {post.Title}");
+            }
+        }
+
+        #region IsLoaded
+        foreach (var blog in blogs)
+        {
+            if (context.Entry(blog).Collection(e => e.Posts).IsLoaded)
+            {
+                Console.WriteLine($" Posts for blog '{blog.Name}' are loaded.");
+            }
+        }
+        #endregion
+
+        string ReadLine()
+        {
+            return (x++).ToString(); // Console.ReadLine();
+        }
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+}
+
+public class LazyLoadingBlogsContextBase : JsonBlogsContextBase
+{
+    protected LazyLoadingBlogsContextBase(bool useSqlite = false)
+        : base(useSqlite)
+    {
+    }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        base.OnConfiguring(optionsBuilder);
+
+        #region IgnoreNonVirtualNavigations
+        optionsBuilder.UseLazyLoadingProxies(b => b.IgnoreNonVirtualNavigations());
+        #endregion
+    }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        #region NoLazyLoading
+        modelBuilder
+            .Entity<Post>()
+            .Navigation(p => p.Author)
+            .EnableLazyLoading(false);
+        #endregion
+
+        base.OnModelCreating(modelBuilder);
+    }
+}
+
+public class LazyLoadingBlogsContext : LazyLoadingBlogsContextBase
+{
+}
+
+public class LazyLoadingBlogsContextSqlite : LazyLoadingBlogsContextBase
+{
+    public LazyLoadingBlogsContextSqlite()
+        : base(useSqlite: true)
+    {
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore8/LookupByKeySample.cs b/samples/core/Miscellaneous/NewInEFCore8/LookupByKeySample.cs
new file mode 100644
index 0000000000..e0637d128f
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore8/LookupByKeySample.cs
@@ -0,0 +1,80 @@
+namespace NewInEfCore8;
+
+public static class LookupByKeySample
+{
+    public static async Task Lookup_tracked_entities_by_key()
+    {
+        PrintSampleName();
+
+        await using var context = new JsonBlogsContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.ChangeTracker.Clear();
+
+        await context.Blogs
+            .Include(e => e.Posts).ThenInclude(e => e.Author)
+            .Include(e => e.Posts).ThenInclude(e => e.Tags)
+            .Include(e => e.Site)
+            .LoadAsync();
+
+        context.LoggingEnabled = true;
+
+        #region LookupByPrimaryKey
+        var blogEntry = context.Blogs.Local.FindEntry(2)!;
+        #endregion
+
+        #region UseEntry
+        Console.WriteLine($"Blog '{blogEntry.Entity.Name}' with key {blogEntry.Entity.Id} is tracked in the '{blogEntry.State}' state.");
+        #endregion
+
+        #region LookupByAlternateKey
+        var siteEntry = context.Websites.Local.FindEntry(nameof(Website.Uri), new Uri("https://www.bricelam.net/"))!;
+        #endregion
+
+        Console.WriteLine($"Website '{siteEntry.Entity.Uri}' can be contacted at '{siteEntry.Entity.Email}'.");
+
+        #region LookupByUniqueForeignKey
+        var blogAtSiteEntry = context.Blogs.Local.FindEntry(nameof(Blog.SiteUri), new Uri("https://www.bricelam.net/"))!;
+        #endregion
+
+        Console.WriteLine($"Website '{blogAtSiteEntry.Entity.SiteUri}' hosts blog '{blogAtSiteEntry.Entity.Name}'.");
+
+        #region LookupByCompositePrimaryKey
+        var postTagEntry = context.Set<PostTag>().Local.FindEntryUntyped(new object[] { 4, "TagEF" });
+        #endregion
+
+        Console.WriteLine($"Found PostTag linking post {postTagEntry!.Entity.PostId} with '{postTagEntry.Entity.TagId}'.");
+
+        Console.WriteLine();
+
+        #region LookupByForeignKey
+        var postEntries = context.Posts.Local.GetEntries(nameof(Post.BlogId), 2);
+        #endregion
+
+        Console.WriteLine("Blog with ID 2 has posts:");
+        foreach (var postEntry in postEntries)
+        {
+            Console.WriteLine($"  {postEntry.Entity.Title}");
+        }
+
+        Console.WriteLine();
+
+        #region LookupByAnyProperty
+        var archivedPostEntries = context.Posts.Local.GetEntries(nameof(Post.Archived), true);
+        #endregion
+
+        Console.WriteLine("Archived posts:");
+        foreach (var postEntry in archivedPostEntries)
+        {
+            Console.WriteLine($"  {postEntry.Entity.Title}");
+        }
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore8/NestedComplexTypesSample.cs b/samples/core/Miscellaneous/NewInEFCore8/NestedComplexTypesSample.cs
new file mode 100644
index 0000000000..ed49aadd21
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore8/NestedComplexTypesSample.cs
@@ -0,0 +1,265 @@
+namespace NewInEfCore8;
+
+public static class NestedComplexTypesSample
+{
+    public static Task Use_mutable_classes_as_complex_types()
+    {
+        PrintSampleName();
+        return ComplexTypeTest<CustomerContext>();
+    }
+
+    public static Task Use_mutable_classes_as_complex_types_SQLite()
+    {
+        PrintSampleName();
+        return ComplexTypeTest<CustomerContextSqlite>();
+    }
+
+    private static async Task ComplexTypeTest<TContext>()
+        where TContext : CustomerContextBase, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.LoggingEnabled = true;
+        context.ChangeTracker.Clear();
+
+        var customerId = 1;
+
+        #region QueryCustomer
+        var customer = await context.Customers.FirstAsync(e => e.Id == customerId);
+        #endregion
+
+        var address = customer.Contact.Address;
+        var phone = customer.Contact.MobilePhone;
+
+        var order = new Order { Contents = "Tesco Tasty Treats", BillingAddress = address, ShippingAddress = address, ContactPhone = phone };
+        customer.Orders.Add(order);
+
+        await context.SaveChangesAsync();
+
+        order.ContactPhone = customer.Contact.WorkPhone;
+
+        await context.SaveChangesAsync();
+
+        context.ChangeTracker.Clear();
+
+        var customers = await context.Customers.Where(e => e.Id == customerId).Include(e => e.Orders).ToListAsync();
+
+        customer = customers.First();
+        order = customer.Orders.First();
+
+        #region BillingAddressCurrentValue
+        var billingAddress = context.Entry(order)
+            .ComplexProperty(e => e.BillingAddress)
+            .CurrentValue;
+        #endregion
+
+        #region PostCodeCurrentValue
+        var postCode = context.Entry(order)
+            .ComplexProperty(e => e.BillingAddress)
+            .Property(e => e.PostCode)
+            .CurrentValue;
+        #endregion
+
+        #region CityCurrentValue
+        var currentCity = context.Entry(customer)
+            .ComplexProperty(e => e.Contact)
+            .ComplexProperty(e => e.Address)
+            .Property(e => e.City)
+            .CurrentValue;
+        #endregion
+
+        #region SetCityCurrentValue
+        context.Entry(customer)
+            .ComplexProperty(e => e.Contact)
+            .ComplexProperty(e => e.Address)
+            .Property(e => e.City)
+            .CurrentValue = "Ames";
+        #endregion
+
+        #region CityOriginalValue
+        var originalCity = context.Entry(customer)
+            .ComplexProperty(e => e.Contact)
+            .ComplexProperty(e => e.Address)
+            .Property(e => e.City)
+            .OriginalValue;
+        #endregion
+
+        #region SetPostCodeIsModified
+        context.Entry(customer)
+            .ComplexProperty(e => e.Contact)
+            .ComplexProperty(e => e.Address)
+            .Property(e => e.PostCode)
+            .IsModified = true;
+        #endregion
+
+        var orderId = 1;
+
+        #region QueryShippingAddress
+        var shippingAddress = await context.Orders
+            .Where(e => e.Id == orderId)
+            .Select(e => e.ShippingAddress)
+            .SingleAsync();
+        #endregion
+
+        var shippingCity = await context.Orders.Where(e => e.Id == orderId).Select(e => e.ShippingAddress.City).SingleAsync();
+
+        var addresses = await context.Orders.Select(e => new { e.ShippingAddress, e.BillingAddress }).ToListAsync();
+
+        #region QueryOrdersInCity
+        var city = "Walpole St Peter";
+        var walpoleOrders = await context.Orders.Where(e => e.ShippingAddress.City == city).ToListAsync();
+        #endregion
+
+        var countryCode = 44;
+        var customersWithUkOrders = await context.Customers
+            .Where(e => e.Orders.Select(e => e.ContactPhone.CountryCode == countryCode).Any())
+            .Select(e => new { e.Name, Phone = e.Orders.FirstOrDefault(e => e.ContactPhone.CountryCode == countryCode) }).ToListAsync();
+
+        #region QueryWithPhoneNumber
+        var phoneNumber = new PhoneNumber(44, 7777555777);
+        var customersWithNumber = await context.Customers
+            .Where(
+                e => e.Contact.MobilePhone == phoneNumber
+                     || e.Contact.WorkPhone == phoneNumber
+                     || e.Contact.HomePhone == phoneNumber)
+            .ToListAsync();
+        #endregion
+
+        await context.Customers
+            .Where(
+                e => e.Contact.MobilePhone == phoneNumber
+                     || e.Contact.WorkPhone == phoneNumber
+                     || e.Contact.HomePhone == phoneNumber)
+            .ExecuteDeleteAsync();
+
+        var allNumbers = await context.Customers
+            .Select(e => e.Contact.MobilePhone)
+            .Distinct()
+            .ToListAsync();
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    #region CustomerWithContact
+    public class Customer
+    {
+        public int Id { get; set; }
+        public required string Name { get; set; }
+        public required Contact Contact { get; set; }
+        public List<Order> Orders { get; } = new();
+    }
+    #endregion
+
+    #region OrderWithPhone
+    public class Order
+    {
+        public int Id { get; set; }
+        public required string Contents { get; set; }
+        public required PhoneNumber ContactPhone { get; set; }
+        public required Address ShippingAddress { get; set; }
+        public required Address BillingAddress { get; set; }
+        public Customer Customer { get; set; } = null!;
+    }
+    #endregion
+
+    #region NestedComplexTypes
+    public record Address(string Line1, string? Line2, string City, string Country, string PostCode);
+
+    public record PhoneNumber(int CountryCode, long Number);
+
+    public record Contact
+    {
+        public required Address Address { get; init; }
+        public required PhoneNumber HomePhone { get; init; }
+        public required PhoneNumber WorkPhone { get; init; }
+        public required PhoneNumber MobilePhone { get; init; }
+    }
+    #endregion
+
+    public class CustomerContext : CustomerContextBase
+    {
+    }
+
+    public class CustomerContextSqlite : CustomerContextBase
+    {
+        public CustomerContextSqlite()
+            : base(useSqlite: true)
+        {
+        }
+    }
+
+    public abstract class CustomerContextBase(bool useSqlite = false) : DbContext
+    {
+        public bool UseSqlite { get; } = useSqlite;
+        public bool LoggingEnabled { get; set; }
+
+        public DbSet<Customer> Customers => Set<Customer>();
+        public DbSet<Order> Orders => Set<Order>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => (UseSqlite
+                    ? optionsBuilder.UseSqlite(@$"DataSource={GetType().Name}.db")
+                    : optionsBuilder.UseSqlServer(@$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0"))
+                .EnableSensitiveDataLogging()
+                .LogTo(
+                    s =>
+                    {
+                        if (LoggingEnabled)
+                        {
+                            Console.WriteLine(s);
+                        }
+                    }, LogLevel.Information);
+
+        #region ConfigureNestedTypes
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Customer>(
+                b =>
+                {
+                    b.ComplexProperty(
+                        e => e.Contact,
+                        b =>
+                        {
+                            b.ComplexProperty(e => e.Address);
+                            b.ComplexProperty(e => e.HomePhone);
+                            b.ComplexProperty(e => e.WorkPhone);
+                            b.ComplexProperty(e => e.MobilePhone);
+                        });
+                });
+
+            modelBuilder.Entity<Order>(
+                b =>
+                {
+                    b.ComplexProperty(e => e.ContactPhone);
+                    b.ComplexProperty(e => e.BillingAddress);
+                    b.ComplexProperty(e => e.ShippingAddress);
+                });
+        }
+        #endregion
+
+        public async Task Seed()
+        {
+            var customer = new Customer
+            {
+                Name = "Willow",
+                Contact = new()
+                {
+                    Address = new("Barking Gate", null, "Walpole St Peter", "UK", "PE14 7AV"),
+                    HomePhone = new(44, 7777555777),
+                    WorkPhone = new(1, 12345678901),
+                    MobilePhone = new(49, 987654321)
+                }
+            };
+
+            Add(customer);
+            await SaveChangesAsync();
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore8/NewInEFCore8.csproj b/samples/core/Miscellaneous/NewInEFCore8/NewInEFCore8.csproj
new file mode 100644
index 0000000000..020c75f040
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore8/NewInEFCore8.csproj
@@ -0,0 +1,37 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net8.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <RootNamespace>NewInEfCore8</RootNamespace>
+    <LangVersion>Preview</LangVersion>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Cosmos" Version="8.0.22" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="8.0.22" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="8.0.22" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="8.0.22" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer.NetTopologySuite" Version="8.0.22" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer.HierarchyId" Version="8.0.22" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.NetTopologySuite" Version="8.0.22" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.InMemory" Version="8.0.22" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Proxies" Version="8.0.22" />
+    <PackageReference Include="Microsoft.Extensions.Logging.Console" Version="8.0.1" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <Using Include="System.ComponentModel.DataAnnotations" />
+    <Using Include="System.ComponentModel.DataAnnotations.Schema" />
+    <Using Include="System.Data.Common" />
+    <Using Include="System.Linq.Expressions" />
+    <Using Include="System.Reflection" />
+    <Using Include="System.Runtime.CompilerServices" />
+    <Using Include="Microsoft.EntityFrameworkCore" />
+    <Using Include="Microsoft.Extensions.Logging" />
+    <Using Include="Microsoft.Extensions.DependencyInjection" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/NewInEFCore8/PrimitiveCollectionToTableSample.cs b/samples/core/Miscellaneous/NewInEFCore8/PrimitiveCollectionToTableSample.cs
new file mode 100644
index 0000000000..ede3b7e5d1
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore8/PrimitiveCollectionToTableSample.cs
@@ -0,0 +1,243 @@
+namespace NewInEfCore8;
+
+public static class PrimitiveCollectionToTableSample
+{
+    public static Task Queries_against_a_table_wrapping_a_primitive_type()
+    {
+        PrintSampleName();
+        return ContainsTest<PubsAndWalksContext>();
+    }
+
+    public static Task Queries_against_a_table_wrapping_a_primitive_type_SQLite()
+    {
+        PrintSampleName();
+        return ContainsTest<PubsAndWalksContextSqlite>();
+    }
+
+    private static async Task ContainsTest<TContext>()
+        where TContext : PubsAndWalksContextBase, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.LoggingEnabled = true;
+        context.ChangeTracker.Clear();
+
+        #region PubsWithHeineken
+        var beer = "Heineken";
+        var pubsWithHeineken = await context.Pubs
+            .Where(e => e.Beers.Any(e => e.Name == beer))
+            .Select(e => e.Name)
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine($"\nPubs with {beer} are {string.Join(", ", pubsWithHeineken)}");
+
+        #region PubsWithLager
+        var beers = new[] { "Carling", "Heineken", "Stella Artois", "Carlsberg" };
+        var pubsWithLager = await context.Pubs
+            .Where(e => beers.Any(b => e.Beers.Any(t => t.Name == b)))
+            .Select(e => e.Name)
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine($"\nPubs with lager are {string.Join(", ", pubsWithLager)}");
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    #region Pub
+    public class Pub
+    {
+        public Pub(string name)
+        {
+            Name = name;
+        }
+
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public List<Beer> Beers { get; set; } = new();
+        public List<DateOnly> DaysVisited { get; private set; } = new();
+    }
+    #endregion
+
+    #region Beer
+    [Owned]
+    public class Beer
+    {
+        public Beer(string name)
+        {
+            Name = name;
+        }
+
+        public string Name { get; private set; }
+    }
+    #endregion
+
+    public class PubsAndWalksContext : PubsAndWalksContextBase
+    {
+    }
+
+    public class PubsAndWalksContextSqlite : PubsAndWalksContextBase
+    {
+        public PubsAndWalksContextSqlite()
+            : base(useSqlite: true)
+        {
+        }
+    }
+
+    public abstract class PubsAndWalksContextBase : DbContext
+    {
+        protected PubsAndWalksContextBase(bool useSqlite = false)
+        {
+            UseSqlite = useSqlite;
+        }
+
+        public bool UseSqlite { get; }
+        public bool LoggingEnabled { get; set; }
+
+        public DbSet<Pub> Pubs => Set<Pub>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => (UseSqlite
+                    ? optionsBuilder.UseSqlite(@$"DataSource={GetType().Name}.db")
+                    : optionsBuilder.UseSqlServer(
+                        @$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0"))
+                .EnableSensitiveDataLogging()
+                .LogTo(
+                    s =>
+                    {
+                        if (LoggingEnabled)
+                        {
+                            Console.WriteLine(s);
+                        }
+                    }, LogLevel.Information);
+
+        public async Task Seed()
+        {
+            await AddRangeAsync(
+                new Pub("The Royal Oak")
+                {
+                    Beers =
+                    {
+                        new("Oakham"),
+                        new("Carling"),
+                        new("Guinness"),
+                        new("John Smiths"),
+                        new("Bathams"),
+                        new("Tennents")
+                    },
+                    DaysVisited =
+                    {
+                        new(2021, 1, 2),
+                        new(2021, 8, 7),
+                        new(2023, 3, 22),
+                        new(2022, 4, 22),
+                        new(2022, 7, 21),
+                        new(2022, 6, 21),
+                    }
+                },
+                new Pub("The Prince of Wales Feathers")
+                {
+                    Beers = { new("Heineken"), new("John Smiths"), new("Stella Artois"), new("Carlsberg") },
+                    DaysVisited =
+                    {
+                        new(2022, 11, 17),
+                        new(2021, 9, 25),
+                        new(2022, 12, 21),
+                        new(2022, 11, 7),
+                        new(2022, 8, 9),
+                        new(2022, 3, 10),
+                        new(2021, 12, 1),
+                        new(2022, 3, 8),
+                        new(2022, 2, 28),
+                        new(2021, 5, 10),
+                        new(2021, 6, 25),
+                    }
+                },
+                new Pub("The White Swan")
+                {
+                    Beers =
+                    {
+                        new("Oakham"),
+                        new("Carling"),
+                        new("Guinness"),
+                        new("Heineken"),
+                        new("Stella Artois"),
+                        new("Carlsberg"),
+                        new("Bathams")
+                    },
+                    DaysVisited =
+                    {
+                        new(2021, 2, 24),
+                        new(2022, 8, 3),
+                        new(2022, 9, 14),
+                        new(2022, 5, 5),
+                        new(2022, 7, 13),
+                        new(2021, 7, 18),
+                        new(2021, 7, 23),
+                    }
+                },
+                new Pub("Farr Bay Inn")
+                {
+                    Beers =
+                    {
+                        new("Guinness"),
+                        new("Heineken"),
+                        new("Carlsberg"),
+                        new("Bathams"),
+                        new("Tennents")
+                    },
+                    DaysVisited =
+                    {
+                        new(2022, 11, 30),
+                        new(2022, 2, 15),
+                        new(2021, 12, 9),
+                        new(2022, 8, 5),
+                        new(2021, 11, 19),
+                        new(2022, 12, 20),
+                        new(2021, 6, 5),
+                        new(2021, 2, 27),
+                        new(2021, 6, 17),
+                        new(2023, 3, 1),
+                        new(2021, 2, 23),
+                        new(2021, 9, 6),
+                        new(2023, 2, 22),
+                        new(2022, 1, 25),
+                    }
+                },
+                new Pub("The Eltisley")
+                {
+                    Beers =
+                    {
+                        new("Oakham"),
+                        new("Carling"),
+                        new("Guinness"),
+                        new("Heineken"),
+                        new("John Smiths"),
+                        new("Stella Artois"),
+                        new("Carlsberg"),
+                        new("Bathams"),
+                        new("Tennents")
+                    },
+                    DaysVisited =
+                    {
+                        new(2022, 6, 19),
+                        new(2021, 1, 15),
+                        new(2022, 3, 24),
+                        new(2023, 2, 26),
+                        new(2021, 1, 11),
+                        new(2022, 3, 19),
+                    }
+                });
+
+            await SaveChangesAsync();
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore8/PrimitiveCollectionsInJsonSample.cs b/samples/core/Miscellaneous/NewInEFCore8/PrimitiveCollectionsInJsonSample.cs
new file mode 100644
index 0000000000..042ac034b8
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore8/PrimitiveCollectionsInJsonSample.cs
@@ -0,0 +1,482 @@
+namespace NewInEfCore8;
+
+public static class PrimitiveCollectionsInJsonSample
+{
+    public static Task Queries_using_primitive_collections_in_JSON_documents()
+    {
+        PrintSampleName();
+        return ContainsTest<PubsAndWalksContext>();
+    }
+
+    public static Task Queries_using_primitive_collections_in_JSON_documents_SQLite()
+    {
+        PrintSampleName();
+        return ContainsTest<PubsAndWalksContextSqlite>();
+    }
+
+    private static async Task ContainsTest<TContext>()
+        where TContext : PubsAndWalksContextBase, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.LoggingEnabled = true;
+        context.ChangeTracker.Clear();
+
+        #region WalksWithTerrain
+        var terrains = new[] { Terrain.River, Terrain.Beach, Terrain.Park };
+        var walksWithTerrain = await context.Walks
+            .Where(e => terrains.Contains(e.Terrain))
+            .Select(e => e.Name)
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine($"\nWalks with given terrain are {string.Join(", ", walksWithTerrain.Select(w => $"\"{w}\""))}");
+
+        #region PubsWithHeineken
+        var beer = "Heineken";
+        var pubsWithHeineken = await context.Pubs
+            .Where(e => e.Beers.Beers.Contains(beer))
+            .Select(e => e.Name)
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine($"\nPubs with {beer} are {string.Join(", ", pubsWithHeineken)}");
+
+        #region PubsWithLager
+        var beers = new[] { "Carling", "Heineken", "Stella Artois", "Carlsberg" };
+        var pubsWithLager = await context.Pubs
+            .Where(e => beers.Any(b => e.Beers.Beers.Contains(b)))
+            .Select(e => e.Name)
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine($"\nPubs with lager are {string.Join(", ", pubsWithLager)}");
+
+        #region PubsVisitedThisYear
+        var thisYear = DateTime.Now.Year;
+        var pubsVisitedThisYear = await context.Pubs
+            .Where(e => e.Visits.DaysVisited.Any(v => v.Year == thisYear))
+            .Select(e => e.Name)
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine($"\nPubs visited this year are {string.Join(", ", pubsVisitedThisYear)}");
+
+        #region PubsVisitedInOrder
+        var pubsVisitedInOrder = await context.Pubs
+            .Select(e => new
+            {
+                e.Name,
+                FirstVisited = e.Visits.DaysVisited.OrderBy(v => v).First(),
+                LastVisited = e.Visits.DaysVisited.OrderByDescending(v => v).First(),
+            })
+            .OrderBy(p => p.FirstVisited)
+            .ToListAsync();
+        #endregion
+
+        foreach (var pub in pubsVisitedInOrder)
+        {
+            Console.WriteLine($"{pub.Name} first visited on {pub.FirstVisited} and last visited on {pub.LastVisited}");
+        }
+
+        #region WalksWithADrink
+        var walksWithADrink = await context.Walks.Select(
+            w => new
+            {
+                WalkName = w.Name,
+                PubName = w.ClosestPub.Name,
+                WalkLocationTag = w.Visits.LocationTag,
+                PubLocationTag = w.ClosestPub.Visits.LocationTag,
+                Count = w.Visits.DaysVisited.Count(v => w.ClosestPub.Visits.DaysVisited.Contains(v)),
+                TotalCount = w.Visits.DaysVisited.Count
+            }).ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var walk in walksWithADrink)
+        {
+            Console.WriteLine($"{walk.PubName} was visited {walk.Count} times in {walk.TotalCount} \"{walk.WalkName}\" walks.");
+        }
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    #region DogWalk
+    public class DogWalk
+    {
+        public DogWalk(string name)
+        {
+            Name = name;
+        }
+
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public Terrain Terrain { get; set; }
+        public Visits Visits { get; set; } = null!;
+        public Pub ClosestPub { get; set; } = null!;
+    }
+
+    public enum Terrain
+    {
+        Forest,
+        River,
+        Hills,
+        Village,
+        Park,
+        Beach,
+    }
+    #endregion
+
+    #region Pub
+    public class Pub
+    {
+        public Pub(string name)
+        {
+            Name = name;
+        }
+
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public BeerData Beers { get; set; } = null!;
+        public Visits Visits { get; set; } = null!;
+    }
+
+    public class Visits
+    {
+        public string? LocationTag { get; set; }
+        public List<DateOnly> DaysVisited { get; set; } = null!;
+    }
+    #endregion
+
+    public class BeerData
+    {
+        public string[] Beers { get; set; } = null!;
+    }
+
+
+    public class PubsAndWalksContext : PubsAndWalksContextBase
+    {
+    }
+
+    public class PubsAndWalksContextSqlite : PubsAndWalksContextBase
+    {
+        public PubsAndWalksContextSqlite()
+            : base(useSqlite: true)
+        {
+        }
+    }
+
+    public abstract class PubsAndWalksContextBase : DbContext
+    {
+        protected PubsAndWalksContextBase(bool useSqlite = false)
+        {
+            UseSqlite = useSqlite;
+        }
+
+        public bool UseSqlite { get; }
+        public bool LoggingEnabled { get; set; }
+
+        public DbSet<DogWalk> Walks => Set<DogWalk>();
+        public DbSet<Pub> Pubs => Set<Pub>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => (UseSqlite
+                    ? optionsBuilder.UseSqlite(@$"DataSource={GetType().Name}.db")
+                    : optionsBuilder.UseSqlServer(
+                        @$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0"))
+                //sqlServerOptionsBuilder => sqlServerOptionsBuilder.UseCompatibilityLevel(120)))
+                .EnableSensitiveDataLogging()
+                .LogTo(
+                    s =>
+                    {
+                        if (LoggingEnabled)
+                        {
+                            Console.WriteLine(s);
+                        }
+                    }, LogLevel.Information);
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Pub>(
+                b =>
+                {
+                    b.OwnsOne(e => e.Beers).ToJson();
+                    b.OwnsOne(e => e.Visits).ToJson();
+                });
+
+            modelBuilder.Entity<DogWalk>().OwnsOne(e => e.Visits).ToJson();
+        }
+
+        public async Task Seed()
+        {
+            var oak = new Pub("The Royal Oak")
+            {
+                Beers = new BeerData { Beers = new[] { "Oakham", "Carling", "Guinness", "John Smiths", "Bathams", "Tennents" } },
+                Visits = new Visits
+                {
+                    LocationTag = "Pub visit",
+                    DaysVisited = new()
+                    {
+                        new(2021, 1, 2),
+                        new(2021, 8, 7),
+                        new(2023, 3, 22),
+                        new(2022, 4, 22),
+                        new(2022, 7, 21),
+                        new(2022, 6, 21),
+                    }
+                }
+            };
+
+            var feathers = new Pub("The Prince of Wales Feathers")
+            {
+                Beers = new BeerData { Beers = new[] { "Heineken", "John Smiths", "Stella Artois", "Carlsberg" } },
+                Visits = new Visits
+                {
+                    LocationTag = "Pub visit",
+                    DaysVisited = new()
+                    {
+                        new(2022, 11, 17),
+                        new(2021, 9, 25),
+                        new(2022, 12, 21),
+                        new(2022, 11, 7),
+                        new(2022, 8, 9),
+                        new(2022, 3, 10),
+                        new(2021, 12, 1),
+                        new(2022, 3, 8),
+                        new(2022, 2, 28),
+                        new(2021, 5, 10),
+                        new(2021, 6, 25),
+                    }
+                }
+            };
+
+            var swan = new Pub("The White Swan")
+            {
+                Beers = new BeerData { Beers = new[] { "Oakham", "Carling", "Guinness", "Heineken", "Stella Artois", "Carlsberg", "Bathams" } },
+                Visits = new Visits
+                {
+                    LocationTag = "Pub visit",
+                    DaysVisited = new()
+                    {
+                        new(2021, 2, 24),
+                        new(2022, 8, 3),
+                        new(2022, 9, 14),
+                        new(2022, 5, 5),
+                        new(2022, 7, 13),
+                        new(2021, 7, 18),
+                        new(2021, 7, 23),
+                    }
+                }
+            };
+
+            var fbi = new Pub("Farr Bay Inn")
+            {
+                Beers = new BeerData { Beers = new[] { "Guinness", "Heineken", "Carlsberg", "Bathams", "Tennents" } },
+                Visits = new Visits
+                {
+                    LocationTag = "Pub visit",
+                    DaysVisited = new()
+                    {
+                        new(2022, 11, 30),
+                        new(2022, 2, 15),
+                        new(2021, 12, 9),
+                        new(2022, 8, 5),
+                        new(2021, 11, 19),
+                        new(2022, 12, 20),
+                        new(2021, 6, 5),
+                        new(2021, 2, 27),
+                        new(2021, 6, 17),
+                        new(2023, 3, 1),
+                        new(2021, 2, 23),
+                        new(2021, 9, 6),
+                        new(2023, 2, 22),
+                        new(2022, 1, 25),
+                    }
+                }
+            };
+
+            var eltisley = new Pub("The Eltisley")
+            {
+                Beers = new BeerData
+                {
+                    Beers = new[]
+                    {
+                        "Oakham", "Carling", "Guinness", "Heineken", "John Smiths", "Stella Artois", "Carlsberg", "Bathams",
+                        "Tennents"
+                    }
+                },
+                Visits = new Visits
+                {
+                    LocationTag = "Pub visit",
+                    DaysVisited = new()
+                    {
+                        new(2022, 6, 19),
+                        new(2021, 1, 15),
+                        new(2022, 3, 24),
+                        new(2023, 2, 26),
+                        new(2021, 1, 11),
+                        new(2022, 3, 19),
+                    }
+                }
+            };
+
+            await AddRangeAsync(
+                new DogWalk("Ailsworth to Nene")
+                {
+                    ClosestPub = feathers,
+                    Terrain = Terrain.River,
+                    Visits = new Visits
+                    {
+                        LocationTag = "Walk",
+                        DaysVisited = new()
+                        {
+                            new(2022, 11, 17),
+                            new(2021, 9, 25),
+                            new(2022, 12, 21),
+                            new(2022, 11, 7),
+                            new(2022, 8, 9),
+                            new(2021, 7, 21),
+                            new(2022, 1, 15),
+                            new(2022, 9, 29),
+                        }
+                    }
+                },
+
+                new DogWalk("Caster Hanglands")
+                {
+                    ClosestPub = feathers,
+                    Terrain = Terrain.Forest,
+                    Visits = new Visits
+                    {
+                        LocationTag = "Walk",
+                        DaysVisited = new()
+                        {
+                            new(2022, 3, 10),
+                            new(2021, 6, 5),
+                            new(2021, 12, 1),
+                            new(2022, 3, 8),
+                            new(2022, 6, 10),
+                            new(2022, 11, 13),
+                            new(2022, 2, 28),
+                            new(2021, 5, 10),
+                            new(2021, 6, 25),
+                        }
+                    }
+                },
+                new DogWalk("Ferry Meadows")
+                {
+                    ClosestPub = oak,
+                    Terrain = Terrain.Park,
+                    Visits = new Visits
+                    {
+                        LocationTag = "Walk",
+                        DaysVisited = new()
+                        {
+                            new(2021, 1, 2),
+                            new(2021, 8, 7),
+                            new(2023, 3, 22),
+                            new(2021, 4, 25),
+                            new(2022, 6, 9),
+                            new(2022, 4, 22),
+                            new(2022, 7, 21),
+                            new(2022, 6, 21),
+                        }
+                    }
+                },
+                new DogWalk("Woodnewton")
+                {
+                    ClosestPub = swan,
+                    Terrain = Terrain.Village,
+                    Visits = new Visits
+                    {
+                        LocationTag = "Walk",
+                        DaysVisited = new()
+                        {
+                            new(2021, 2, 24),
+                            new(2023, 4, 4),
+                            new(2021, 2, 19),
+                            new(2022, 8, 3),
+                            new(2022, 9, 14),
+                            new(2022, 5, 5),
+                            new(2022, 7, 13),
+                            new(2021, 7, 18),
+                            new(2021, 7, 23),
+                        }
+                    }
+                },
+                new DogWalk("Eltisley")
+                {
+                    ClosestPub = eltisley,
+                    Terrain = Terrain.Village,
+                    Visits = new Visits
+                    {
+                        LocationTag = "Walk",
+                        DaysVisited = new()
+                        {
+                            new(2022, 6, 19),
+                            new(2021, 1, 15),
+                            new(2021, 9, 29),
+                            new(2022, 3, 24),
+                            new(2023, 3, 2),
+                            new(2023, 2, 26),
+                            new(2021, 1, 11),
+                            new(2022, 3, 19),
+                        }
+                    }
+                },
+                new DogWalk("Farr Beach")
+                {
+                    ClosestPub = fbi,
+                    Terrain = Terrain.Beach,
+                    Visits = new Visits
+                    {
+                        LocationTag = "Walk",
+                        DaysVisited = new()
+                        {
+                            new(2022, 11, 30),
+                            new(2021, 10, 28),
+                            new(2022, 2, 15),
+                            new(2021, 12, 9),
+                            new(2022, 5, 22),
+                            new(2022, 8, 5),
+                            new(2021, 11, 19),
+                            new(2022, 7, 29),
+                            new(2022, 12, 20),
+                            new(2021, 6, 5),
+                            new(2021, 6, 25),
+                        }
+                    }
+                },
+                new DogWalk("Newlands")
+                {
+                    ClosestPub = fbi,
+                    Terrain = Terrain.Hills,
+                    Visits = new Visits
+                    {
+                        LocationTag = "Walk",
+                        DaysVisited = new()
+                        {
+                            new(2021, 2, 27),
+                            new(2021, 6, 17),
+                            new(2021, 8, 6),
+                            new(2023, 3, 1),
+                            new(2021, 2, 23),
+                            new(2022, 3, 17),
+                            new(2021, 9, 6),
+                            new(2023, 2, 22),
+                            new(2022, 1, 25),
+                        }
+                    }
+                });
+
+            await SaveChangesAsync();
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore8/PrimitiveCollectionsSample.cs b/samples/core/Miscellaneous/NewInEFCore8/PrimitiveCollectionsSample.cs
new file mode 100644
index 0000000000..ffdd96204b
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore8/PrimitiveCollectionsSample.cs
@@ -0,0 +1,529 @@
+using System.Collections;
+using System.Collections.ObjectModel;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+namespace NewInEfCore8;
+
+public static class PrimitiveCollectionsSample
+{
+    public static Task Queries_using_primitive_collections()
+    {
+        PrintSampleName();
+        return ContainsTest<PubsAndWalksContext>();
+    }
+
+    public static Task Queries_using_primitive_collections_SQLite()
+    {
+        PrintSampleName();
+        return ContainsTest<PubsAndWalksContextSqlite>();
+    }
+
+    private static async Task ContainsTest<TContext>()
+        where TContext : PubsAndWalksContextBase, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.LoggingEnabled = true;
+        context.ChangeTracker.Clear();
+
+        #region WalksWithTerrain
+        var terrains = new[] { Terrain.River, Terrain.Beach, Terrain.Park };
+        var walksWithTerrain = await context.Walks
+            .Where(e => terrains.Contains(e.Terrain))
+            .Select(e => e.Name)
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine($"\nWalks with given terrain are {string.Join(", ", walksWithTerrain.Select(w => $"\"{w}\""))}");
+
+        #region PubsWithHeineken
+        var beer = "Heineken";
+        var pubsWithHeineken = await context.Pubs
+            .Where(e => e.Beers.Contains(beer))
+            .Select(e => e.Name)
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine($"\nPubs with {beer} are {string.Join(", ", pubsWithHeineken)}");
+
+        #region PubsWithLager
+        var beers = new[] { "Carling", "Heineken", "Stella Artois", "Carlsberg" };
+        var pubsWithLager = await context.Pubs
+            .Where(e => beers.Any(b => e.Beers.Contains(b)))
+            .Select(e => e.Name)
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine($"\nPubs with lager are {string.Join(", ", pubsWithLager)}");
+
+        #region PubsVisitedThisYear
+        var thisYear = DateTime.Now.Year;
+        var pubsVisitedThisYear = await context.Pubs
+            .Where(e => e.DaysVisited.Any(v => v.Year == thisYear))
+            .Select(e => e.Name)
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine($"\nPubs visited this year are {string.Join(", ", pubsVisitedThisYear)}");
+
+        #region PubsVisitedInOrder
+        var pubsVisitedInOrder = await context.Pubs
+            .Select(e => new
+            {
+                e.Name,
+                FirstVisited = e.DaysVisited.OrderBy(v => v).First(),
+                LastVisited = e.DaysVisited.OrderByDescending(v => v).First(),
+            })
+            .OrderBy(p => p.FirstVisited)
+            .ToListAsync();
+        #endregion
+
+        foreach (var pub in pubsVisitedInOrder)
+        {
+            Console.WriteLine($"{pub.Name} first visited on {pub.FirstVisited} and last visited on {pub.LastVisited}");
+        }
+
+        #region WalksWithADrink
+        var walksWithADrink = await context.Walks.Select(
+            w => new
+            {
+                WalkName = w.Name,
+                PubName = w.ClosestPub.Name,
+                Count = w.DaysVisited.Count(v => w.ClosestPub.DaysVisited.Contains(v)),
+                TotalCount = w.DaysVisited.Count
+            }).ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var walk in walksWithADrink)
+        {
+            Console.WriteLine($"{walk.PubName} was visited {walk.Count} times in {walk.TotalCount} \"{walk.WalkName}\" walks.");
+        }
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public class MyCollection : IList<int>
+    {
+        private readonly List<int> _list = new();
+        public IEnumerator<int> GetEnumerator() => _list.GetEnumerator();
+        IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();
+        public void Add(int item) => _list.Add(item);
+        public void Clear() => _list.Clear();
+        public bool Contains(int item) => _list.Contains(item);
+        public void CopyTo(int[] array, int arrayIndex) => _list.CopyTo(array, arrayIndex);
+        public bool Remove(int item) => _list.Remove(item);
+        public int Count => _list.Count;
+        public bool IsReadOnly => ((ICollection<int>)_list).IsReadOnly;
+        public int IndexOf(int item) => _list.IndexOf(item);
+        public void Insert(int index, int item) => _list.Insert(index, item);
+        public void RemoveAt(int index) => _list.RemoveAt(index);
+        public int this[int index]
+        {
+            get => _list[index];
+            set => _list[index] = value;
+        }
+    }
+
+    public class PrimitiveCollections
+    {
+        public int Id { get; set; }
+        public IEnumerable<int> Ints { get; set; } = null!;
+        public ICollection<string> Strings { get; set; } = null!;
+        public Collection<DateTime> DateTimes { get; set; } = null!;
+        public IList<DateOnly> Dates { get; set; } = null!;
+
+        [MaxLength(2500)]
+        [Unicode(false)]
+        public uint[] UnsignedInts { get; set; } = null!;
+
+        public ObservableCollection<Guid> Guids { get; set; } = null!;
+        public List<bool> Booleans { get; set; } = null!;
+        public List<Uri> Urls { get; set; } = null!;
+
+        // https://github.com/dotnet/efcore/issues/32055
+        // public MyCollection SomeInts { get; set; } = null!;
+
+        public List<int> GetOnlyInts { get; } = new();
+
+        // ReSharper disable once CollectionNeverUpdated.Local
+        private readonly List<int> _intsField = new();
+
+        // public List<DddId> DddIds { get; set; } = null!;
+    }
+
+    public readonly struct DddId
+    {
+        public DddId(int value)
+        {
+            Value = value;
+        }
+
+        public int Value { get; }
+    }
+
+    public class DddIdConverter : ValueConverter<DddId, int>
+    {
+        public DddIdConverter()
+            : base(v => v.Value, v => new DddId())
+        {
+        }
+    }
+
+    #region DogWalk
+    public class DogWalk
+    {
+        public DogWalk(string name)
+        {
+            Name = name;
+        }
+
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public Terrain Terrain { get; set; }
+        public List<DateOnly> DaysVisited { get; private set; } = new();
+        public Pub ClosestPub { get; set; } = null!;
+    }
+
+    public enum Terrain
+    {
+        Forest,
+        River,
+        Hills,
+        Village,
+        Park,
+        Beach,
+    }
+    #endregion
+
+    #region Pub
+    public class Pub
+    {
+        public Pub(string name, string[] beers)
+        {
+            Name = name;
+            Beers = beers;
+        }
+
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public string[] Beers { get; set; }
+        public List<DateOnly> DaysVisited { get; private set; } = new();
+    }
+    #endregion
+
+    public class PubsAndWalksContext : PubsAndWalksContextBase
+    {
+    }
+
+    public class PubsAndWalksContextSqlite : PubsAndWalksContextBase
+    {
+        public PubsAndWalksContextSqlite()
+            : base(useSqlite: true)
+        {
+        }
+    }
+
+    public abstract class PubsAndWalksContextBase : DbContext
+    {
+        protected PubsAndWalksContextBase(bool useSqlite = false)
+        {
+            UseSqlite = useSqlite;
+        }
+
+        public bool UseSqlite { get; }
+        public bool LoggingEnabled { get; set; }
+
+        public DbSet<DogWalk> Walks => Set<DogWalk>();
+        public DbSet<Pub> Pubs => Set<Pub>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => (UseSqlite
+                    ? optionsBuilder.UseSqlite(@$"DataSource={GetType().Name}.db")
+                    : optionsBuilder.UseSqlServer(
+                        @$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0"))
+                        //sqlServerOptionsBuilder => sqlServerOptionsBuilder.UseCompatibilityLevel(120)))
+                .EnableSensitiveDataLogging()
+                .LogTo(
+                    s =>
+                    {
+                        if (LoggingEnabled)
+                        {
+                            Console.WriteLine(s);
+                        }
+                    }, LogLevel.Information);
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder
+                .Entity<PrimitiveCollections>()
+                .Property(e => e.Booleans)
+                .HasMaxLength(1024)
+                .IsUnicode(false);
+
+            // modelBuilder
+            //     .Entity<PrimitiveCollections>()
+            //     .Property(e => e.Guids)
+            //     .HasColumnType("nvarchar(2000)");
+
+            modelBuilder
+                .Entity<PrimitiveCollections>()
+                .Property(e => e.GetOnlyInts);
+
+            // modelBuilder
+            //     .Entity<PrimitiveCollections>()
+            //     .Property(e => e.DddIds);
+
+            modelBuilder
+                .Entity<PrimitiveCollections>()
+                .Property<List<int>>("_intsField");
+
+            //modelBuilder.Entity<DogWalk>().Property(e => e.Terrain).HasConversion<string>();
+        }
+
+        protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+        {
+            configurationBuilder
+                .Properties<List<DateOnly>>()
+                .AreUnicode(false)
+                .HaveMaxLength(4000);
+
+            configurationBuilder
+                .Properties<string[]>()
+                .HaveMaxLength(2000);
+
+            // configurationBuilder
+            //     .DefaultTypeMapping<DddId>()
+            //     .HasConversion<DddIdConverter>();
+        }
+
+        public async Task Seed()
+        {
+            Add(
+                new PrimitiveCollections
+                {
+                    Ints = new[] { 1, 2, 3 },
+                    Strings = new List<string> { "One", "Two", "Three" },
+                    DateTimes = new Collection<DateTime> { new(2023, 1, 1, 1, 1, 1), new(2023, 2, 2, 2, 2, 2), new(2023, 3, 3, 3, 3, 3) },
+                    Dates = new List<DateOnly> { new(2023, 1, 1), new(2023, 2, 2), new(2023, 3, 3) },
+                    UnsignedInts = new uint[] { 1, 2, 3 },
+                    Guids = new() { Guid.NewGuid(), Guid.NewGuid(), Guid.NewGuid() },
+                    Booleans = new() { true, false, true },
+                    Urls = new() { new("https://127.0.0.1/"), new("http://192.168.0.1/"), new("https://devblogs.microsoft.com/dotnet/") },
+                    //SomeInts = new() { 1, 2, 3 },
+                    // DddIds = new() { new(1), new(2), new(3) }
+                });
+
+            var oak = new Pub("The Royal Oak", new[] { "Oakham", "Carling", "Guinness", "John Smiths", "Bathams", "Tennents" })
+            {
+                DaysVisited =
+                {
+                    new(2021, 1, 2),
+                    new(2021, 8, 7),
+                    new(2023, 3, 22),
+                    new(2022, 4, 22),
+                    new(2022, 7, 21),
+                    new(2022, 6, 21),
+                }
+            };
+
+            var feathers = new Pub("The Prince of Wales Feathers", new[] { "Heineken", "John Smiths", "Stella Artois", "Carlsberg" })
+            {
+                DaysVisited =
+                {
+                    new(2022, 11, 17),
+                    new(2021, 9, 25),
+                    new(2022, 12, 21),
+                    new(2022, 11, 7),
+                    new(2022, 8, 9),
+                    new(2022, 3, 10),
+                    new(2021, 12, 1),
+                    new(2022, 3, 8),
+                    new(2022, 2, 28),
+                    new(2021, 5, 10),
+                    new(2021, 6, 25),
+                }
+            };
+
+            var swan = new Pub(
+                "The White Swan", new[] { "Oakham", "Carling", "Guinness", "Heineken", "Stella Artois", "Carlsberg", "Bathams" })
+            {
+                DaysVisited =
+                {
+                    new(2021, 2, 24),
+                    new(2022, 8, 3),
+                    new(2022, 9, 14),
+                    new(2022, 5, 5),
+                    new(2022, 7, 13),
+                    new(2021, 7, 18),
+                    new(2021, 7, 23),
+                }
+            };
+
+            var fbi = new Pub("Farr Bay Inn", new[] { "Guinness", "Heineken", "Carlsberg", "Bathams", "Tennents" })
+            {
+                DaysVisited =
+                {
+                    new(2022, 11, 30),
+                    new(2022, 2, 15),
+                    new(2021, 12, 9),
+                    new(2022, 8, 5),
+                    new(2021, 11, 19),
+                    new(2022, 12, 20),
+                    new(2021, 6, 5),
+                    new(2021, 2, 27),
+                    new(2021, 6, 17),
+                    new(2023, 3, 1),
+                    new(2021, 2, 23),
+                    new(2021, 9, 6),
+                    new(2023, 2, 22),
+                    new(2022, 1, 25),
+                }
+            };
+
+            var eltisley = new Pub(
+                "The Eltisley",
+                new[] { "Oakham", "Carling", "Guinness", "Heineken", "John Smiths", "Stella Artois", "Carlsberg", "Bathams", "Tennents" })
+            {
+                DaysVisited =
+                {
+                    new(2022, 6, 19),
+                    new(2021, 1, 15),
+                    new(2022, 3, 24),
+                    new(2023, 2, 26),
+                    new(2021, 1, 11),
+                    new(2022, 3, 19),
+                }
+            };
+
+            await AddRangeAsync(
+                new DogWalk("Ailsworth to Nene")
+                {
+                    ClosestPub = feathers,
+                    Terrain = Terrain.River,
+                    DaysVisited =
+                    {
+                        new(2022, 11, 17),
+                        new(2021, 9, 25),
+                        new(2022, 12, 21),
+                        new(2022, 11, 7),
+                        new(2022, 8, 9),
+                        new(2021, 7, 21),
+                        new(2022, 1, 15),
+                        new(2022, 9, 29),
+                    }
+                },
+                new DogWalk("Caster Hanglands")
+                {
+                    ClosestPub = feathers,
+                    Terrain = Terrain.Forest,
+                    DaysVisited =
+                    {
+                        new(2022, 3, 10),
+                        new(2021, 6, 5),
+                        new(2021, 12, 1),
+                        new(2022, 3, 8),
+                        new(2022, 6, 10),
+                        new(2022, 11, 13),
+                        new(2022, 2, 28),
+                        new(2021, 5, 10),
+                        new(2021, 6, 25),
+                    }
+                },
+                new DogWalk("Ferry Meadows")
+                {
+                    ClosestPub = oak,
+                    Terrain = Terrain.Park,
+                    DaysVisited =
+                    {
+                        new(2021, 1, 2),
+                        new(2021, 8, 7),
+                        new(2023, 3, 22),
+                        new(2021, 4, 25),
+                        new(2022, 6, 9),
+                        new(2022, 4, 22),
+                        new(2022, 7, 21),
+                        new(2022, 6, 21),
+                    }
+                },
+                new DogWalk("Woodnewton")
+                {
+                    ClosestPub = swan,
+                    Terrain = Terrain.Village,
+                    DaysVisited =
+                    {
+                        new(2021, 2, 24),
+                        new(2023, 4, 4),
+                        new(2021, 2, 19),
+                        new(2022, 8, 3),
+                        new(2022, 9, 14),
+                        new(2022, 5, 5),
+                        new(2022, 7, 13),
+                        new(2021, 7, 18),
+                        new(2021, 7, 23),
+                    }
+                },
+                new DogWalk("Eltisley")
+                {
+                    ClosestPub = eltisley,
+                    Terrain = Terrain.Village,
+                    DaysVisited =
+                    {
+                        new(2022, 6, 19),
+                        new(2021, 1, 15),
+                        new(2021, 9, 29),
+                        new(2022, 3, 24),
+                        new(2023, 3, 2),
+                        new(2023, 2, 26),
+                        new(2021, 1, 11),
+                        new(2022, 3, 19),
+                    }
+                },
+                new DogWalk("Farr Beach")
+                {
+                    ClosestPub = fbi,
+                    Terrain = Terrain.Beach,
+                    DaysVisited =
+                    {
+                        new(2022, 11, 30),
+                        new(2021, 10, 28),
+                        new(2022, 2, 15),
+                        new(2021, 12, 9),
+                        new(2022, 5, 22),
+                        new(2022, 8, 5),
+                        new(2021, 11, 19),
+                        new(2022, 7, 29),
+                        new(2022, 12, 20),
+                        new(2021, 6, 5),
+                        new(2021, 6, 25),
+                    }
+                },
+                new DogWalk("Newlands")
+                {
+                    ClosestPub = fbi,
+                    Terrain = Terrain.Hills,
+                    DaysVisited =
+                    {
+                        new(2021, 2, 27),
+                        new(2021, 6, 17),
+                        new(2021, 8, 6),
+                        new(2023, 3, 1),
+                        new(2021, 2, 23),
+                        new(2022, 3, 17),
+                        new(2021, 9, 6),
+                        new(2023, 2, 22),
+                        new(2022, 1, 25),
+                    }
+                });
+
+            await SaveChangesAsync();
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore8/Program.cs b/samples/core/Miscellaneous/NewInEFCore8/Program.cs
new file mode 100644
index 0000000000..02c38291e6
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore8/Program.cs
@@ -0,0 +1,52 @@
+using NewInEfCore8;
+
+public class Program
+{
+    public static async Task Main()
+    {
+        await ComplexTypesSample.Use_mutable_class_as_complex_type();
+        await ImmutableComplexTypesSample.Use_immutable_class_as_complex_type();
+        await RecordComplexTypesSample.Use_immutable_record_as_complex_type();
+        await StructComplexTypesSample.Use_mutable_struct_as_complex_type();
+        await ImmutableStructComplexTypesSample.Use_immutable_struct_as_complex_type();
+        await NestedComplexTypesSample.Use_mutable_classes_as_complex_types();
+
+        await ComplexTypesSample.Use_mutable_class_as_complex_type_SQLite();
+        await ImmutableComplexTypesSample.Use_immutable_class_as_complex_type_SQLite();
+        await RecordComplexTypesSample.Use_immutable_record_as_complex_type_SQLite();
+        await StructComplexTypesSample.Use_mutable_struct_as_complex_type_SQLite();
+        await ImmutableStructComplexTypesSample.Use_immutable_struct_as_complex_type_SQLite();
+        await NestedComplexTypesSample.Use_mutable_classes_as_complex_types_SQLite();
+
+        await JsonColumnsSample.Json_columns_with_TPH();
+        await JsonColumnsSample.Json_columns_with_TPH_on_SQLite();
+
+        await RawSqlSample.SqlQuery_for_unmapped_types();
+
+        await LazyLoadingSample.Lazy_loading_for_no_tracking_queries();
+
+        await InheritanceSample.Discriminator_length_TPH();
+
+        await LookupByKeySample.Lookup_tracked_entities_by_key();
+
+        await DateOnlyTimeOnlySample.Can_use_DateOnly_TimeOnly_on_SQLite();
+        await DateOnlyTimeOnlySample.Can_use_DateOnly_TimeOnly_on_SQL_Server();
+        await DateOnlyTimeOnlySample.Can_use_DateOnly_TimeOnly_on_SQL_Server_with_JSON();
+
+        await HierarchyIdSample.SQL_Server_HierarchyId();
+
+        await PrimitiveCollectionsSample.Queries_using_primitive_collections();
+        await PrimitiveCollectionsSample.Queries_using_primitive_collections_SQLite();
+
+        await PrimitiveCollectionsInJsonSample.Queries_using_primitive_collections_in_JSON_documents();
+        await PrimitiveCollectionsInJsonSample.Queries_using_primitive_collections_in_JSON_documents_SQLite();
+
+        await PrimitiveCollectionToTableSample.Queries_against_a_table_wrapping_a_primitive_type();
+
+        await DefaultConstraintSample.Insert_rows_using_database_default_constraint();
+        await DefaultConstraintSample.Insert_rows_using_database_default_constraint_SQLite();
+
+        await ExecuteUpdateDeleteSample.ExecuteUpdate_ExecuteDelete_with_multiple_entities_targeting_one_table();
+        await ExecuteUpdateDeleteSample.ExecuteUpdate_ExecuteDelete_with_multiple_entities_targeting_one_table_SQLite();
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore8/RawSqlSample.cs b/samples/core/Miscellaneous/NewInEFCore8/RawSqlSample.cs
new file mode 100644
index 0000000000..fb29500027
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore8/RawSqlSample.cs
@@ -0,0 +1,210 @@
+namespace NewInEfCore8;
+
+public static class RawSqlSample
+{
+    public static async Task SqlQuery_for_unmapped_types()
+    {
+        PrintSampleName();
+
+        await using var context = new TphBlogsContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.Database.ExecuteSql(
+            @$"CREATE PROCEDURE GetRecentPostSummariesProc as
+                      BEGIN
+                          SELECT b.Name AS BlogName, p.Title AS PostTitle, p.PublishedOn
+                          FROM Posts AS p
+                          INNER JOIN Blogs AS b ON p.BlogId = b.Id
+                          ORDER BY PublishedOn
+                      END");
+
+        context.Database.ExecuteSql(
+            @$"CREATE FUNCTION GetPostsPublishedAfter(@publicationDate datetime2)
+                                                    RETURNS @posts table
+                                                    (
+                                                        BlogName nvarchar(max) not null,
+                                                        PostTitle nvarchar(max) not null,
+                                                        PublishedOn date not null
+                                                    )
+                                                    AS
+                                                    BEGIN
+                                                        INSERT INTO @posts
+                                                        SELECT b.Name AS BlogName, p.Title AS PostTitle, p.PublishedOn
+                                                        FROM Posts AS p
+                                                        INNER JOIN Blogs AS b ON p.BlogId = b.Id
+                                                        WHERE p.PublishedOn >= @publicationDate
+                                                        RETURN
+                                                    END");
+
+        context.Database.ExecuteSql(
+            @$"CREATE VIEW PostAndBlogSummariesView as
+                          SELECT b.Name AS BlogName, p.Title AS PostTitle, p.PublishedOn
+                    FROM Posts AS p
+                    INNER JOIN Blogs AS b ON p.BlogId = b.Id");
+
+        context.LoggingEnabled = true;
+        context.ChangeTracker.Clear();
+
+        #region SqlQueryAllColumns
+        var start = new DateOnly(2022, 1, 1);
+        var end = new DateOnly(2023, 1, 1);
+        var postsIn2022 =
+            await context.Database
+                .SqlQuery<BlogPost>($"SELECT * FROM Posts as p WHERE p.PublishedOn >= {start} AND p.PublishedOn < {end}")
+                .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var post in postsIn2022)
+        {
+            Console.WriteLine($"Post '{post.BlogTitle.Substring(0, 10)}...' published on {post.PublishedOn} with FK to Blog '{post.BlogId}'.");
+        }
+
+        Console.WriteLine();
+
+        #region SqlQueryJoin
+
+        var cutoffDate = new DateOnly(2022, 1, 1);
+        var summaries =
+            await context.Database.SqlQuery<PostSummary>(
+                    @$"SELECT b.Name AS BlogName, p.Title AS PostTitle, p.PublishedOn
+                       FROM Posts AS p
+                       INNER JOIN Blogs AS b ON p.BlogId = b.Id
+                       WHERE p.PublishedOn >= {cutoffDate}")
+                .ToListAsync();
+
+        #endregion
+
+        Console.WriteLine();
+        foreach (var post in summaries)
+        {
+            Console.WriteLine($"Post '{post.PostTitle.Substring(0, 10)}...' in blog '{post.BlogName}' published on {post.PublishedOn}.");
+        }
+
+        Console.WriteLine();
+
+        #region SqlQueryJoinComposed
+        var summariesIn2022 =
+            await context.Database.SqlQuery<PostSummary>(
+                    @$"SELECT b.Name AS BlogName, p.Title AS PostTitle, p.PublishedOn
+                       FROM Posts AS p
+                       INNER JOIN Blogs AS b ON p.BlogId = b.Id")
+                .Where(p => p.PublishedOn >= cutoffDate && p.PublishedOn < end)
+                .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var post in summariesIn2022)
+        {
+            Console.WriteLine($"Post '{post.PostTitle.Substring(0, 10)}...' in blog '{post.BlogName}' published on {post.PublishedOn}.");
+        }
+
+        Console.WriteLine();
+
+        #region SqlQueryJoinComposedLinq
+        var summariesByLinq =
+            await context.Posts.Select(
+                    p => new PostSummary
+                    {
+                        BlogName = p.Blog.Name,
+                        PostTitle = p.Title,
+                        PublishedOn = p.PublishedOn,
+                    })
+                .Where(p => p.PublishedOn >= start && p.PublishedOn < end)
+                .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var post in summariesByLinq)
+        {
+            Console.WriteLine($"Post '{post.PostTitle.Substring(0, 10)}...' in blog '{post.BlogName}' published on {post.PublishedOn}.");
+        }
+
+        Console.WriteLine();
+
+        #region SqlQueryView
+        var summariesFromView =
+            await context.Database.SqlQuery<PostSummary>(
+                    @$"SELECT * FROM PostAndBlogSummariesView")
+                .Where(p => p.PublishedOn >= cutoffDate && p.PublishedOn < end)
+                .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var post in summariesFromView)
+        {
+            Console.WriteLine($"Post '{post.PostTitle.Substring(0, 10)}...' in blog '{post.BlogName}' published on {post.PublishedOn}.");
+        }
+
+        Console.WriteLine();
+
+        #region SqlQueryFunction
+        var summariesFromFunc =
+            await context.Database.SqlQuery<PostSummary>(
+                    @$"SELECT * FROM GetPostsPublishedAfter({cutoffDate})")
+                .Where(p => p.PublishedOn < end)
+                .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var post in summariesFromFunc)
+        {
+            Console.WriteLine($"Post '{post.PostTitle.Substring(0, 10)}...' in blog '{post.BlogName}' published on {post.PublishedOn}.");
+        }
+
+        Console.WriteLine();
+
+        #region SqlQueryStoredProc
+        var summariesFromStoredProc =
+            await context.Database.SqlQuery<PostSummary>(
+                    @$"exec GetRecentPostSummariesProc")
+                .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var post in summariesFromStoredProc)
+        {
+            Console.WriteLine($"Post '{post.PostTitle.Substring(0, 10)}...' published on {post.PublishedOn}.");
+        }
+
+        Console.WriteLine();
+    }
+
+    #region BlogPost
+    public class BlogPost
+    {
+        public BlogPost(string blogTitle, string content, DateOnly publishedOn)
+        {
+            BlogTitle = blogTitle;
+            Content = content;
+            PublishedOn = publishedOn;
+        }
+
+        public int Id { get; private set; }
+
+        [Column("Title")]
+        public string BlogTitle { get; set; }
+
+        public string Content { get; set; }
+        public DateOnly PublishedOn { get; set; }
+        public int BlogId { get; set; }
+    }
+    #endregion
+
+    #region PostSummary
+    public class PostSummary
+    {
+        public string BlogName { get; set; } = null!;
+        public string PostTitle { get; set; } = null!;
+        public DateOnly? PublishedOn { get; set; }
+    }
+    #endregion
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore8/RecordComplexTypesSample.cs b/samples/core/Miscellaneous/NewInEFCore8/RecordComplexTypesSample.cs
new file mode 100644
index 0000000000..d495f148dc
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore8/RecordComplexTypesSample.cs
@@ -0,0 +1,301 @@
+namespace NewInEfCore8;
+
+public static class RecordComplexTypesSample
+{
+    public static Task Use_immutable_record_as_complex_type()
+    {
+        PrintSampleName();
+        return ComplexTypeTest<CustomerContext>();
+    }
+
+    public static Task Use_immutable_record_as_complex_type_SQLite()
+    {
+        PrintSampleName();
+        return ComplexTypeTest<CustomerContextSqlite>();
+    }
+
+    private static async Task ComplexTypeTest<TContext>()
+        where TContext : CustomerContextBase, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.LoggingEnabled = true;
+        context.ChangeTracker.Clear();
+
+        var customer = new Customer()
+        {
+            Name = "Willow",
+            Address = new("Barking Gate", null, "Walpole St Peter", "UK", "PE14 7AV")
+        };
+
+        context.Add(customer);
+        await context.SaveChangesAsync();
+
+        customer.Orders.Add(
+            new Order { Contents = "Tesco Tasty Treats", BillingAddress = customer.Address, ShippingAddress = customer.Address, });
+
+        await context.SaveChangesAsync();
+
+        customer.Address = customer.Address with { Line1 = "Peacock Lodge" };
+
+        await context.SaveChangesAsync();
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public class Customer
+    {
+        public int Id { get; set; }
+        public required string Name { get; set; }
+        public required Address Address { get; set; }
+        public List<Order> Orders { get; } = new();
+    }
+
+    public class Order
+    {
+        public int Id { get; set; }
+        public required string Contents { get; set; }
+        public required Address ShippingAddress { get; set; }
+        public required Address BillingAddress { get; set; }
+        public Customer Customer { get; set; } = null!;
+    }
+
+    public record Address(string Line1, string? Line2, string City, string Country, string PostCode);
+
+    public class CustomerContext : CustomerContextBase
+    {
+    }
+
+    public class CustomerContextSqlite : CustomerContextBase
+    {
+        public CustomerContextSqlite()
+            : base(useSqlite: true)
+        {
+        }
+    }
+
+    public abstract class CustomerContextBase(bool useSqlite = false) : DbContext
+    {
+        public bool UseSqlite { get; } = useSqlite;
+        public bool LoggingEnabled { get; set; }
+
+        public DbSet<Customer> Customers => Set<Customer>();
+        public DbSet<Order> Orders => Set<Order>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => (UseSqlite
+                    ? optionsBuilder.UseSqlite(@$"DataSource={GetType().Name}.db")
+                    : optionsBuilder.UseSqlServer(
+                        @$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0"))
+                //sqlServerOptionsBuilder => sqlServerOptionsBuilder.UseCompatibilityLevel(120)))
+                .EnableSensitiveDataLogging()
+                .LogTo(
+                    s =>
+                    {
+                        if (LoggingEnabled)
+                        {
+                            Console.WriteLine(s);
+                        }
+                    }, LogLevel.Information);
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Customer>().ComplexProperty(e => e.Address,
+                b =>
+                {
+                    b.Property(e => e.Line1);
+                    b.Property(e => e.Line2);
+                    b.Property(e => e.City);
+                    b.Property(e => e.Country);
+                    b.Property(e => e.PostCode);
+                });
+
+            modelBuilder.Entity<Order>(b =>
+            {
+                b.ComplexProperty(e => e.BillingAddress,
+                    b =>
+                    {
+                        b.Property(e => e.Line1);
+                        b.Property(e => e.Line2);
+                        b.Property(e => e.City);
+                        b.Property(e => e.Country);
+                        b.Property(e => e.PostCode);
+                    });
+
+                b.ComplexProperty(e => e.ShippingAddress,
+                    b =>
+                    {
+                        b.Property(e => e.Line1);
+                        b.Property(e => e.Line2);
+                        b.Property(e => e.City);
+                        b.Property(e => e.Country);
+                        b.Property(e => e.PostCode);
+                    });
+            });
+        }
+
+        public async Task Seed()
+        {
+            await SaveChangesAsync();
+        }
+    }
+}
+
+public static class StructRecordComplexTypesSample
+{
+    public static Task Use_immutable_struct_record_as_complex_type()
+    {
+        PrintSampleName();
+        return ComplexTypeTest<CustomerContext>();
+    }
+
+    public static Task Use_immutable_struct_record_as_complex_type_SQLite()
+    {
+        PrintSampleName();
+        return ComplexTypeTest<CustomerContextSqlite>();
+    }
+
+    private static async Task ComplexTypeTest<TContext>()
+        where TContext : CustomerContextBase, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.LoggingEnabled = true;
+        context.ChangeTracker.Clear();
+
+        var customer = new Customer()
+        {
+            Name = "Willow",
+            Address = new("Barking Gate", null, "Walpole St Peter", "UK", "PE14 7AV")
+        };
+
+        context.Add(customer);
+        await context.SaveChangesAsync();
+
+        customer.Orders.Add(
+            new Order { Contents = "Tesco Tasty Treats", BillingAddress = customer.Address, ShippingAddress = customer.Address, });
+
+        await context.SaveChangesAsync();
+
+        #region ChangeImmutableRecord
+        customer.Address = customer.Address with { Line1 = "Peacock Lodge" };
+
+        await context.SaveChangesAsync();
+        #endregion
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public class Customer
+    {
+        public int Id { get; set; }
+        public required string Name { get; set; }
+        public required Address Address { get; set; }
+        public List<Order> Orders { get; } = new();
+    }
+
+    public class Order
+    {
+        public int Id { get; set; }
+        public required string Contents { get; set; }
+        public required Address ShippingAddress { get; set; }
+        public required Address BillingAddress { get; set; }
+        public Customer Customer { get; set; } = null!;
+    }
+
+    #region RecordStructAddress
+    public readonly record struct Address(string Line1, string? Line2, string City, string Country, string PostCode);
+    #endregion
+
+    public class CustomerContext : CustomerContextBase
+    {
+    }
+
+    public class CustomerContextSqlite : CustomerContextBase
+    {
+        public CustomerContextSqlite()
+            : base(useSqlite: true)
+        {
+        }
+    }
+
+    public abstract class CustomerContextBase(bool useSqlite = false) : DbContext
+    {
+        public bool UseSqlite { get; } = useSqlite;
+        public bool LoggingEnabled { get; set; }
+
+        public DbSet<Customer> Customers => Set<Customer>();
+        public DbSet<Order> Orders => Set<Order>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => (UseSqlite
+                    ? optionsBuilder.UseSqlite(@$"DataSource={GetType().Name}.db")
+                    : optionsBuilder.UseSqlServer(
+                        @$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0"))
+                //sqlServerOptionsBuilder => sqlServerOptionsBuilder.UseCompatibilityLevel(120)))
+                .EnableSensitiveDataLogging()
+                .LogTo(
+                    s =>
+                    {
+                        if (LoggingEnabled)
+                        {
+                            Console.WriteLine(s);
+                        }
+                    }, LogLevel.Information);
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Customer>().ComplexProperty(e => e.Address,
+                b =>
+                {
+                    b.Property(e => e.Line1);
+                    b.Property(e => e.Line2);
+                    b.Property(e => e.City);
+                    b.Property(e => e.Country);
+                    b.Property(e => e.PostCode);
+                });
+
+            modelBuilder.Entity<Order>(b =>
+            {
+                b.ComplexProperty(e => e.BillingAddress,
+                    b =>
+                    {
+                        b.Property(e => e.Line1);
+                        b.Property(e => e.Line2);
+                        b.Property(e => e.City);
+                        b.Property(e => e.Country);
+                        b.Property(e => e.PostCode);
+                    });
+
+                b.ComplexProperty(e => e.ShippingAddress,
+                    b =>
+                    {
+                        b.Property(e => e.Line1);
+                        b.Property(e => e.Line2);
+                        b.Property(e => e.City);
+                        b.Property(e => e.Country);
+                        b.Property(e => e.PostCode);
+                    });
+            });
+        }
+
+        public async Task Seed()
+        {
+            await SaveChangesAsync();
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore8/StructComplexTypesSample.cs b/samples/core/Miscellaneous/NewInEFCore8/StructComplexTypesSample.cs
new file mode 100644
index 0000000000..8380456fcb
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore8/StructComplexTypesSample.cs
@@ -0,0 +1,163 @@
+namespace NewInEfCore8;
+
+public static class StructComplexTypesSample
+{
+    public static Task Use_mutable_struct_as_complex_type()
+    {
+        PrintSampleName();
+        return ComplexTypeTest<CustomerContext>();
+    }
+
+    public static Task Use_mutable_struct_as_complex_type_SQLite()
+    {
+        PrintSampleName();
+        return ComplexTypeTest<CustomerContextSqlite>();
+    }
+
+    private static async Task ComplexTypeTest<TContext>()
+        where TContext : CustomerContextBase, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.LoggingEnabled = true;
+        context.ChangeTracker.Clear();
+
+        var customer = new Customer()
+        {
+            Name = "Willow",
+            Address = new() { Line1 = "Barking Gate", City = "Walpole St Peter", Country = "UK", PostCode = "PE14 7AV" }
+        };
+
+        context.Add(customer);
+        await context.SaveChangesAsync();
+
+        customer.Orders.Add(
+            new Order { Contents = "Tesco Tasty Treats", BillingAddress = customer.Address, ShippingAddress = customer.Address, });
+
+        await context.SaveChangesAsync();
+
+        var currentAddress = customer.Address;
+        currentAddress.Line1 = "Peacock Lodge";
+        customer.Address = currentAddress;
+        await context.SaveChangesAsync();
+
+        customer.Address = customer.Address with { Line1 = "Peacock Lodge" };
+
+        await context.SaveChangesAsync();
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public class Customer
+    {
+        public int Id { get; set; }
+        public required string Name { get; set; }
+        public Address Address { get; set; }
+        public List<Order> Orders { get; } = new();
+    }
+
+    public class Order
+    {
+        public int Id { get; set; }
+        public required string Contents { get; set; }
+        public required Address ShippingAddress { get; set; }
+        public required Address BillingAddress { get; set; }
+        public Customer Customer { get; set; } = null!;
+    }
+
+    #region AddressStruct
+    public struct Address
+    {
+        public required string Line1 { get; set; }
+        public string? Line2 { get; set; }
+        public required string City { get; set; }
+        public required string Country { get; set; }
+        public required string PostCode { get; set; }
+    }
+    #endregion
+
+    public class CustomerContext : CustomerContextBase
+    {
+    }
+
+    public class CustomerContextSqlite : CustomerContextBase
+    {
+        public CustomerContextSqlite()
+            : base(useSqlite: true)
+        {
+        }
+    }
+
+    public abstract class CustomerContextBase(bool useSqlite = false) : DbContext
+    {
+        public bool UseSqlite { get; } = useSqlite;
+        public bool LoggingEnabled { get; set; }
+
+        public DbSet<Customer> Customers => Set<Customer>();
+        public DbSet<Order> Orders => Set<Order>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => (UseSqlite
+                    ? optionsBuilder.UseSqlite(@$"DataSource={GetType().Name}.db")
+                    : optionsBuilder.UseSqlServer(
+                        @$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0"))
+                //sqlServerOptionsBuilder => sqlServerOptionsBuilder.UseCompatibilityLevel(120)))
+                .EnableSensitiveDataLogging()
+                .LogTo(
+                    s =>
+                    {
+                        if (LoggingEnabled)
+                        {
+                            Console.WriteLine(s);
+                        }
+                    }, LogLevel.Information);
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Customer>().ComplexProperty(e => e.Address,
+                b =>
+                {
+                    b.Property(e => e.Line1);
+                    b.Property(e => e.Line2);
+                    b.Property(e => e.City);
+                    b.Property(e => e.Country);
+                    b.Property(e => e.PostCode);
+                });
+
+            modelBuilder.Entity<Order>(b =>
+            {
+                b.ComplexProperty(e => e.BillingAddress,
+                    b =>
+                    {
+                        b.Property(e => e.Line1);
+                        b.Property(e => e.Line2);
+                        b.Property(e => e.City);
+                        b.Property(e => e.Country);
+                        b.Property(e => e.PostCode);
+                    });
+
+                b.ComplexProperty(e => e.ShippingAddress,
+                    b =>
+                    {
+                        b.Property(e => e.Line1);
+                        b.Property(e => e.Line2);
+                        b.Property(e => e.City);
+                        b.Property(e => e.Country);
+                        b.Property(e => e.PostCode);
+                    });
+            });
+        }
+
+        public async Task Seed()
+        {
+            await SaveChangesAsync();
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore9.CompiledModels/App/App.csproj b/samples/core/Miscellaneous/NewInEFCore9.CompiledModels/App/App.csproj
new file mode 100644
index 0000000000..2f4dda63ad
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore9.CompiledModels/App/App.csproj
@@ -0,0 +1,22 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <TargetFramework>net9.0</TargetFramework>
+        <ImplicitUsings>enable</ImplicitUsings>
+        <Nullable>enable</Nullable>
+        <RootNamespace/>
+    </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="9.0.11">
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+      <PrivateAssets>all</PrivateAssets>
+    </PackageReference>
+  </ItemGroup>
+
+    <ItemGroup>
+      <ProjectReference Include="..\Model\Model.csproj" />
+    </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/NewInEFCore9.CompiledModels/App/Program.cs b/samples/core/Miscellaneous/NewInEFCore9.CompiledModels/App/Program.cs
new file mode 100644
index 0000000000..e951ea4fb4
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore9.CompiledModels/App/Program.cs
@@ -0,0 +1,13 @@
+using NewInEfCore9;
+
+public class Program
+{
+    public static void Main()
+    {
+        Console.WriteLine("Starting application...");
+
+        using var context = new BlogsContext();
+
+        Console.WriteLine($"Model loaded with {context.Model.GetEntityTypes().Count()} entity types.");
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore9.CompiledModels/Model/BlogsContext.cs b/samples/core/Miscellaneous/NewInEFCore9.CompiledModels/Model/BlogsContext.cs
new file mode 100644
index 0000000000..af044eb4a5
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore9.CompiledModels/Model/BlogsContext.cs
@@ -0,0 +1,14 @@
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace NewInEfCore9;
+
+public class BlogsContext : DbContext
+{
+    public DbSet<Blog> Blogs => Set<Blog>();
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EF9CompiledModels;ConnectRetryCount=0")
+            .LogTo(_ => Console.WriteLine(">> EF is building the model..."), [CoreEventId.ShadowPropertyCreated])
+            .EnableSensitiveDataLogging();
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore9.CompiledModels/Model/EntityTypes.cs b/samples/core/Miscellaneous/NewInEFCore9.CompiledModels/Model/EntityTypes.cs
new file mode 100644
index 0000000000..68749a3845
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore9.CompiledModels/Model/EntityTypes.cs
@@ -0,0 +1,16 @@
+namespace NewInEfCore9;
+
+public class Blog
+{
+    public int Id { get; set; }
+
+    public ICollection<Post> Posts { get; } = new List<Post>();
+}
+
+public class Post
+{
+    public int Id { get; set; }
+    public string? Title { get; set; }
+
+    public Blog Blog { get; set; } = null!;
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore9.CompiledModels/Model/Model.csproj b/samples/core/Miscellaneous/NewInEFCore9.CompiledModels/Model/Model.csproj
new file mode 100644
index 0000000000..261bf5a494
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore9.CompiledModels/Model/Model.csproj
@@ -0,0 +1,39 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>library</OutputType>
+    <TargetFramework>net9.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <RootNamespace>NewInEfCore9</RootNamespace>
+    <LangVersion>Preview</LangVersion>
+  </PropertyGroup>
+
+  <PropertyGroup>
+    <EFOptimizeContext>true</EFOptimizeContext>
+    <EFStartupProject>..\App\App.csproj</EFStartupProject>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="9.0.11">
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+      <PrivateAssets>all</PrivateAssets>
+    </PackageReference>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="9.0.11" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="9.0.11" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Tasks" Version="9.0.11" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <Using Include="System.ComponentModel.DataAnnotations" />
+    <Using Include="System.ComponentModel.DataAnnotations.Schema" />
+    <Using Include="System.Data.Common" />
+    <Using Include="System.Linq.Expressions" />
+    <Using Include="System.Reflection" />
+    <Using Include="System.Runtime.CompilerServices" />
+    <Using Include="Microsoft.EntityFrameworkCore" />
+    <Using Include="Microsoft.Extensions.Logging" />
+    <Using Include="Microsoft.Extensions.DependencyInjection" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/NewInEFCore9.Cosmos/CosmosPrimitiveTypesSample.cs b/samples/core/Miscellaneous/NewInEFCore9.Cosmos/CosmosPrimitiveTypesSample.cs
new file mode 100644
index 0000000000..37c3a4bd7d
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore9.Cosmos/CosmosPrimitiveTypesSample.cs
@@ -0,0 +1,116 @@
+using System;
+using System.Collections.Generic;
+using System.Net.Http;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public static class CosmosPrimitiveTypesSample
+{
+    public static async Task Collections_and_dictionaries_of_primitive_types()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Collections_and_dictionaries_of_primitive_types)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        using var context = new BooksContext();
+
+        var book = new Book
+        {
+            Title = "How It Works: Incredible History",
+            Quotes = new List<string>
+            {
+                "Thomas (Tommy) Flowers was the British engineer behind the design of the Colossus computer.",
+                "Invented originally for Guinness, plastic widgets are nitrogen-filled spheres.",
+                "For 20 years after its introduction in 1979, the Walkman dominated the personal stereo market."
+            },
+            Notes = new Dictionary<string, string>
+            {
+                { "121", "Fridges" },
+                { "144", "Peter Higgs" },
+                { "48", "Saint Mark's Basilica" },
+                { "36", "The Terracotta Army" }
+            }
+        };
+
+        context.Add(book);
+        await context.SaveChangesAsync();
+
+        book.Quotes.Add("Pressing the emergency button lowered the rods again.");
+        book.Notes["48"] = "Chiesa d'Oro";
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            await using var context = new BooksContext(quiet: true);
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+    }
+
+    public class Book
+    {
+        public Guid Id { get; set; }
+        public string Title { get; set; }
+        public IList<string> Quotes { get; set; }
+        public IDictionary<string, string> Notes { get; set; }
+    }
+
+    public class BooksContext : DbContext
+    {
+        public DbSet<Book> Books { get; set; }
+
+        private readonly bool _quiet;
+
+        public BooksContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Book>().ToContainer("Shapes");
+
+            #region ConfigureCollection
+            modelBuilder.Entity<Book>()
+                .PrimitiveCollection(e => e.Quotes)
+                .ElementType(b => b.IsRequired());
+            #endregion
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseCosmos(
+                    "https://localhost:8081",
+                    "C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==",
+                    "PrimitiveCollections",
+                    cosmosOptionsBuilder =>
+                    {
+                        cosmosOptionsBuilder.HttpClientFactory(
+                            () => new HttpClient(
+                                new HttpClientHandler
+                                {
+                                    ServerCertificateCustomValidationCallback =
+                                        HttpClientHandler.DangerousAcceptAnyServerCertificateValidator
+                                }));
+                    });
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(
+                    Console.WriteLine,
+                    new[] { CosmosEventId.ExecutedCreateItem, CosmosEventId.ExecutingSqlQuery, CoreEventId.SaveChangesCompleted });
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore9.Cosmos/CosmosSyncApisSample.cs b/samples/core/Miscellaneous/NewInEFCore9.Cosmos/CosmosSyncApisSample.cs
new file mode 100644
index 0000000000..5a19643cdc
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore9.Cosmos/CosmosSyncApisSample.cs
@@ -0,0 +1,111 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+using Microsoft.Extensions.Logging;
+
+public static class CosmosSyncApisSample
+{
+    public static void Cosmos_provider_blocks_sync_APIs()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(Cosmos_provider_blocks_sync_APIs)}");
+        Console.WriteLine();
+
+        Helpers.RecreateCleanDatabase();
+        Helpers.PopulateDatabase();
+
+        using var context = new ShapesContext();
+
+        var triangle = new Triangle
+        {
+            Name = "Impossible",
+            PartitionKey = "TrianglesPartition",
+            Angle1 = 90,
+            Angle2 = 90,
+            InsertedOn = DateTime.UtcNow
+        };
+        context.Add(triangle);
+        context.SaveChanges();
+
+        var equilateral = context.Triangles.Single(e => e.Name == "Equilateral");
+        var isosceles = context.Triangles.Find("Isosceles", "TrianglesPartition");
+
+        triangle.Angle2 = 89;
+        context.SaveChanges();
+
+        context.Remove(triangle);
+        context.SaveChanges();
+    }
+
+    public static class Helpers
+    {
+        public static void RecreateCleanDatabase()
+        {
+            using var context = new ShapesContext(quiet: true);
+
+            context.Database.EnsureDeleted();
+            context.Database.EnsureCreated();
+        }
+
+        public static void PopulateDatabase()
+        {
+            using var context = new ShapesContext(quiet: true);
+
+            var triangles = new List<Triangle>
+            {
+                new() { Name = "Acute", PartitionKey = "TrianglesPartition", Angle1 = 75, Angle2 = 85, InsertedOn = DateTime.UtcNow },
+                new() { Name = " Obtuse ", PartitionKey = "TrianglesPartition", Angle1 = 110, Angle2 = 35, InsertedOn = DateTime.UtcNow },
+                new() { Name = "Right", PartitionKey = "TrianglesPartition", Angle1 = 90, Angle2 = 45, InsertedOn = DateTime.UtcNow },
+                new() { Name = "Isosceles", PartitionKey = "TrianglesPartition", Angle1 = 75, Angle2 = 75, InsertedOn = DateTime.UtcNow },
+                new() { Name = "Equilateral", PartitionKey = "TrianglesPartition", Angle1 = 60, Angle2 = 60, InsertedOn = DateTime.UtcNow }
+            };
+
+            context.AddRange(triangles);
+            context.SaveChanges();
+        }
+    }
+
+    public class Triangle
+    {
+        public string PartitionKey { get; set; }
+        public string Name { get; set; }
+        public double Angle1 { get; set; }
+        public double Angle2 { get; set; }
+        public DateTime InsertedOn { get; set; }
+    }
+
+    public class ShapesContext(bool quiet = false) : DbContext
+    {
+        public DbSet<Triangle> Triangles { get; set; }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Triangle>(
+                b =>
+                {
+                    b.ToContainer("Shapes");
+                    b.HasPartitionKey(e => e.PartitionKey);
+                    b.HasKey(e => new { e.Name, e.PartitionKey });
+                    b.Property(c => c.Name).ToJsonProperty("id");
+                    b.Property(c => c.PartitionKey).ToJsonProperty("pk");
+                });
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder = optionsBuilder
+                .ConfigureWarnings(b => b.Log(CosmosEventId.SyncNotSupported))
+                .EnableSensitiveDataLogging()
+                .UseCosmos(
+                    "https://localhost:8081",
+                    "C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==",
+                    "Triangles");
+
+            if (!quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, LogLevel.Information);
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore9.Cosmos/HierarchicalPartitionKeysSample.cs b/samples/core/Miscellaneous/NewInEFCore9.Cosmos/HierarchicalPartitionKeysSample.cs
new file mode 100644
index 0000000000..e4448501e0
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore9.Cosmos/HierarchicalPartitionKeysSample.cs
@@ -0,0 +1,247 @@
+using System;
+using System.Linq;
+using System.Net.Http;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Logging;
+
+public static class HierarchicalPartitionKeysSample
+{
+    public static async Task UseHierarchicalPartitionKeys()
+    {
+        Console.WriteLine($">>>> Sample: {nameof(UseHierarchicalPartitionKeys)}");
+        Console.WriteLine();
+
+        await Helpers.RecreateCleanDatabase();
+
+        Guid userSessionId;
+
+        using (var context = new UserSessionContext())
+        {
+            #region Inserts
+            var tenantId = "Microsoft";
+            var sessionId = 7;
+
+            context.AddRange(
+                new UserSession
+                {
+                    TenantId = tenantId,
+                    UserId = new Guid("99A410D7-E467-4CC5-92DE-148F3FC53F4C"),
+                    SessionId = sessionId,
+                    Username = "mac"
+                },
+                new UserSession
+                {
+                    TenantId = tenantId,
+                    UserId = new Guid("ADAE5DDE-8A67-432D-9DEC-FD7EC86FD9F6"),
+                    SessionId = sessionId,
+                    Username = "toast"
+                },
+                new UserSession
+                {
+                    TenantId = tenantId,
+                    UserId = new Guid("61967254-AFF8-493A-B7F8-E62DA36D8367"),
+                    SessionId = sessionId,
+                    Username = "willow"
+                },
+                new UserSession
+                {
+                    TenantId = tenantId,
+                    UserId = new Guid("BC0150CF-5147-44B8-8823-865F4F2323E1"),
+                    SessionId = sessionId,
+                    Username = "alice"
+                });
+
+            await context.SaveChangesAsync();
+            #endregion
+
+            userSessionId = context.ChangeTracker.Entries<UserSession>().Single(e => e.Entity.Username == "willow").Entity.Id;
+        }
+
+        Console.WriteLine();
+        Console.WriteLine("Use Find to create a point-read:");
+        Console.WriteLine();
+
+        using (var context = new UserSessionContext())
+        {
+            #region FindAsync
+            var tenantId = "Microsoft";
+            var sessionId = 7;
+            var userId = new Guid("99A410D7-E467-4CC5-92DE-148F3FC53F4C");
+
+            var session = await context.Sessions.FindAsync(
+                userSessionId, tenantId, userId, sessionId);
+            #endregion
+        }
+
+        Console.WriteLine();
+        Console.WriteLine("Execute a query with full hierarchical partition key info:");
+        Console.WriteLine();
+
+        using (var context = new UserSessionContext())
+        {
+            #region FullPartitionKey
+            var tenantId = "Microsoft";
+            var sessionId = 7;
+            var userId = new Guid("99A410D7-E467-4CC5-92DE-148F3FC53F4C");
+
+            var sessions = await context.Sessions
+                .Where(
+                    e => e.TenantId == tenantId
+                         && e.UserId == userId
+                         && e.SessionId == sessionId
+                         && e.Username.Contains("a"))
+                .ToListAsync();
+            #endregion
+        }
+
+        Console.WriteLine();
+        Console.WriteLine("Execute a query with only top two levels of hierarchical partition key:");
+        Console.WriteLine();
+
+        using (var context = new UserSessionContext())
+        {
+            #region TopTwoPartitionKey
+            var tenantId = "Microsoft";
+            var userId = new Guid("99A410D7-E467-4CC5-92DE-148F3FC53F4C");
+
+            var sessions = await context.Sessions
+                .Where(
+                    e => e.TenantId == tenantId
+                         && e.UserId == userId
+                         && e.Username.Contains("a"))
+                .ToListAsync();
+            #endregion
+        }
+
+        Console.WriteLine();
+        Console.WriteLine("Execute a query with only top level of hierarchical partition key:");
+        Console.WriteLine();
+
+        using (var context = new UserSessionContext())
+        {
+            #region TopOnePartitionKey
+            var tenantId = "Microsoft";
+
+            var sessions = await context.Sessions
+                .Where(
+                    e => e.TenantId == tenantId
+                         && e.Username.Contains("a"))
+                .ToListAsync();
+            #endregion
+        }
+
+        Console.WriteLine();
+        Console.WriteLine("Execute a queries with incomplete subkey values:");
+        Console.WriteLine();
+
+        using (var context = new UserSessionContext())
+        {
+            var sessionId = 7;
+            var userId = new Guid("99A410D7-E467-4CC5-92DE-148F3FC53F4C");
+
+            #region BottomPartitionKey
+            var sessions1 = await context.Sessions
+                .Where(
+                    e => e.SessionId == sessionId
+                         && e.Username.Contains("a"))
+                .ToListAsync();
+            #endregion
+
+            #region MiddlePartitionKey
+            var sessions2 = await context.Sessions
+                .Where(
+                    e => e.UserId == userId
+                         && e.Username.Contains("a"))
+                .ToListAsync();
+            #endregion
+
+            #region BottomTwoPartitionKey
+            var sessions3 = await context.Sessions
+                .Where(
+                    e => e.SessionId == sessionId
+                         && e.UserId == userId
+                         && e.Username.Contains("a"))
+                .ToListAsync();
+            #endregion
+        }
+    }
+
+    public static class Helpers
+    {
+        public static async Task RecreateCleanDatabase()
+        {
+            await using var context = new UserSessionContext(quiet: true);
+
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+    }
+
+    #region UserSession
+    public class UserSession
+    {
+        // Item ID
+        public Guid Id { get; set; }
+
+        // Partition Key
+        public string TenantId { get; set; } = null!;
+        public Guid UserId { get; set; }
+        public int SessionId { get; set; }
+
+        // Other members
+        public string Username { get; set; } = null!;
+    }
+    #endregion
+
+    public class UserSessionContext : DbContext
+    {
+        public DbSet<UserSession> Sessions { get; set; }
+
+        private readonly bool _quiet;
+
+        public UserSessionContext(bool quiet = false)
+        {
+            _quiet = quiet;
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region HasPartitionKey
+            modelBuilder
+                .Entity<UserSession>()
+                .HasPartitionKey(e => new { e.TenantId, e.UserId, e.SessionId });
+            #endregion
+
+            // See https://github.com/dotnet/efcore/issues/33961
+            modelBuilder
+                .Entity<UserSession>()
+                .Property(e => e.Id).ValueGeneratedOnAdd();
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .EnableSensitiveDataLogging()
+                .UseCosmos(
+                    "https://localhost:8081",
+                    "C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==",
+                    "HierarchicalPartitionKeys",
+                    cosmosOptionsBuilder =>
+                    {
+                        cosmosOptionsBuilder.HttpClientFactory(
+                            () => new HttpClient(
+                                new HttpClientHandler
+                                {
+                                    ServerCertificateCustomValidationCallback =
+                                        HttpClientHandler.DangerousAcceptAnyServerCertificateValidator
+                                }));
+                    });
+
+            if (!_quiet)
+            {
+                optionsBuilder.LogTo(Console.WriteLine, LogLevel.Information);
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore9.Cosmos/NewInEFCore9.Cosmos.csproj b/samples/core/Miscellaneous/NewInEFCore9.Cosmos/NewInEFCore9.Cosmos.csproj
new file mode 100644
index 0000000000..a90387728a
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore9.Cosmos/NewInEFCore9.Cosmos.csproj
@@ -0,0 +1,13 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace />
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Cosmos" Version="9.0.11" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/NewInEFCore9.Cosmos/Program.cs b/samples/core/Miscellaneous/NewInEFCore9.Cosmos/Program.cs
new file mode 100644
index 0000000000..95a17c33f8
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore9.Cosmos/Program.cs
@@ -0,0 +1,12 @@
+using System.Threading.Tasks;
+
+public class Program
+{
+    public static async Task Main()
+    {
+        // Note: These samples requires the Cosmos DB emulator to be installed and running
+        CosmosSyncApisSample.Cosmos_provider_blocks_sync_APIs();
+        await CosmosPrimitiveTypesSample.Collections_and_dictionaries_of_primitive_types();
+        await HierarchicalPartitionKeysSample.UseHierarchicalPartitionKeys();
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore9/BlogsContext.cs b/samples/core/Miscellaneous/NewInEFCore9/BlogsContext.cs
new file mode 100644
index 0000000000..b88e3baa71
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore9/BlogsContext.cs
@@ -0,0 +1,558 @@
+using System.Net;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+namespace NewInEfCore9;
+
+#region BlogsModel
+public class Blog
+{
+    public Blog(string name)
+    {
+        Name = name;
+    }
+
+    public int Id { get; private set; }
+    public string Name { get; set; }
+    public Language Language { get; set; }
+
+    public virtual Uri SiteUri { get; set; } = null!;
+    public virtual Website Site { get; set; } = null!;
+    public virtual List<Post> Posts { get; } = new();
+}
+
+
+public enum Language
+{
+    English,
+    MandarinChinese,
+    Hindi,
+    Spanish,
+    French,
+    ModernStandardArabic,
+    Other,
+}
+
+public class Website
+{
+    public Website(Uri uri, string email)
+    {
+        Uri = uri;
+        Email = email;
+    }
+
+    public Guid Id { get; private set; }
+    public Uri Uri { get; private set; }
+    public string Email { get; private set; }
+    public virtual Blog Blog { get; set; } = null!;
+}
+
+public class Post
+{
+    public Post(string title, string content, DateOnly publishedOn, decimal rating)
+    {
+        Title = title;
+        Content = content;
+        PublishedOn = publishedOn;
+        Rating = rating;
+    }
+
+    public int Id { get; private set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+    public DateOnly PublishedOn { get; set; }
+    public bool Archived { get; set; }
+    public int BlogId { get; set; }
+    public decimal Rating { get; set; }
+    public virtual Blog Blog { get; set; } = null!;
+    public virtual List<Tag> Tags { get; } = new();
+    public virtual Author? Author { get; set; }
+    public PostMetadata? Metadata { get; set; }
+}
+
+public class FeaturedPost : Post
+{
+    public FeaturedPost(string title, string content, DateOnly publishedOn, decimal rating, string promoText)
+        : base(title, content, publishedOn, rating)
+    {
+        PromoText = promoText;
+    }
+
+    public string PromoText { get; set; }
+}
+
+public class Tag
+{
+    public Tag(string id, params string[] text)
+    {
+        Id = id;
+        Text = text;
+    }
+
+    public string Id { get; private set; }
+    public string[] Text { get; set; }
+    public virtual List<Post> Posts { get; } = new();
+}
+
+public class PostTag
+{
+    public int PostId { get; private set; }
+    public string TagId { get; private set; } = null!;
+}
+
+public class Author
+{
+    public Author(string name)
+    {
+        Name = name;
+    }
+
+    public int Id { get; private set; }
+    public string Name { get; set; }
+    public ContactDetails Contact { get; set; } = null!;
+    public virtual List<Post> Posts { get; } = new();
+}
+#endregion
+
+#region ContactDetailsAggregate
+public class ContactDetails
+{
+    public Address Address { get; set; } = null!;
+    public string? Phone { get; set; }
+}
+
+public class Address
+{
+    public Address(string street, string city, string postcode, string country)
+    {
+        Street = street;
+        City = city;
+        Postcode = postcode;
+        Country = country;
+    }
+
+    public string Street { get; set; }
+    public string City { get; set; }
+    public string Postcode { get; set; }
+    public string Country { get; set; }
+}
+#endregion
+
+#region PostMetadataAggregate
+public class PostMetadata
+{
+    public PostMetadata(int views)
+    {
+        Views = views;
+    }
+
+    public int Views { get; set; }
+    public List<SearchTerm> TopSearches { get; } = new();
+    public List<Visits> TopGeographies { get; } = new();
+    public List<PostUpdate> Updates { get; } = new();
+}
+
+public class SearchTerm
+{
+    public SearchTerm(string term, int count)
+    {
+        Term = term;
+        Count = count;
+    }
+
+    public string Term { get; private set; }
+    public int Count { get; private set; }
+}
+
+public class Visits
+{
+    public Visits(double latitude, double longitude, int count)
+    {
+        Latitude = latitude;
+        Longitude = longitude;
+        Count = count;
+    }
+
+    public double Latitude { get; private set; }
+    public double Longitude { get; private set; }
+    public int Count { get; private set; }
+    public List<string>? Browsers { get; set; }
+}
+
+public class PostUpdate
+{
+    public PostUpdate(IPAddress postedFrom, DateOnly updatedOn)
+    {
+        PostedFrom = postedFrom;
+        UpdatedOn = updatedOn;
+    }
+
+    public IPAddress PostedFrom { get; private set; }
+    public string? UpdatedBy { get; set; }
+    public DateOnly UpdatedOn { get; private set; }
+    public List<Commit> Commits { get; } = new();
+}
+
+public class Commit
+{
+    public Commit(DateOnly committedOn, string comment)
+    {
+        CommittedOn = committedOn;
+        Comment = comment;
+    }
+
+    public DateOnly CommittedOn { get; private set; }
+    public string Comment { get; set; }
+}
+#endregion
+
+public abstract class BlogsContext : DbContext
+{
+    protected BlogsContext(bool useSqlite = false)
+    {
+        UseSqlite = useSqlite;
+    }
+
+    public bool UseSqlite { get; }
+    public bool LoggingEnabled { get; set; }
+    public virtual MappingStrategy MappingStrategy => MappingStrategy.Tph;
+
+    public DbSet<Blog> Blogs => Set<Blog>();
+    public DbSet<Website> Websites => Set<Website>();
+    public DbSet<Tag> Tags => Set<Tag>();
+    public DbSet<Post> Posts => Set<Post>();
+    public DbSet<Author> Authors => Set<Author>();
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => (UseSqlite
+                ? optionsBuilder.UseSqlite(@$"DataSource={GetType().Name}.db")
+                : optionsBuilder.UseSqlServer(
+                    @$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0",
+                    sqlServerOptionsBuilder => sqlServerOptionsBuilder.UseNetTopologySuite()))
+            .EnableSensitiveDataLogging()
+            .LogTo(
+                s =>
+                {
+                    if (LoggingEnabled)
+                    {
+                        Console.WriteLine(s);
+                    }
+                }, LogLevel.Information);
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<FeaturedPost>();
+
+        modelBuilder.Entity<Website>()
+            .HasOne(e => e.Blog)
+            .WithOne(e => e.Site)
+            .HasPrincipalKey<Website>(e => e.Uri)
+            .HasForeignKey<Blog>(e => e.SiteUri);
+
+        modelBuilder.Entity<Post>()
+            .HasMany(e => e.Tags)
+            .WithMany(e => e.Posts)
+            .UsingEntity<PostTag>();
+    }
+
+    protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+    {
+        configurationBuilder.Properties<List<string>>().HaveConversion<StringListConverter>();
+
+        base.ConfigureConventions(configurationBuilder);
+    }
+
+    private class StringListConverter : ValueConverter<List<string>, string>
+    {
+        public StringListConverter()
+            : base(v => string.Join(", ", v!), v => v.Split(',', StringSplitOptions.TrimEntries).ToList())
+        {
+        }
+    }
+
+    public async Task Seed()
+    {
+        var tagEntityFramework = new Tag("TagEF", "Entity Framework");
+        var tagDotNet = new Tag("TagNet", ".NET");
+        var tagDotNetMaui = new Tag("TagMaui", ".NET MAUI");
+        var tagAspDotNet = new Tag("TagAsp", "ASP.NET");
+        var tagAspDotNetCore = new Tag("TagAspC", "ASP.NET Core");
+        var tagDotNetCore = new Tag("TagC", ".NET Core");
+        var tagHacking = new Tag("TagHx", "Hacking");
+        var tagLinux = new Tag("TagLin", "Linux");
+        var tagSqlite = new Tag("TagLite", "SQLite");
+        var tagVisualStudio = new Tag("TagVS", "Visual Studio");
+        var tagGraphQl = new Tag("TagQL", "GraphQL");
+        var tagCosmosDb = new Tag("TagCos", "CosmosDB");
+        var tagBlazor = new Tag("TagBl", "Blazor");
+
+        var maddy = new Author("Maddy Montaquila")
+        {
+            Contact = new() { Address = new("1 Main St", "Camberwick Green", "CW1 5ZH", "UK"), Phone = "01632 12345" }
+        };
+        var jeremy = new Author("Jeremy Likness")
+        {
+            Contact = new() { Address = new("2 Main St", "Chigley", "CW1 5ZH", "UK"), Phone = "01632 12346" }
+        };
+        var dan = new Author("Daniel Roth")
+        {
+            Contact = new() { Address = new("3 Main St", "Camberwick Green", "CW1 5ZH", "UK"), Phone = "01632 12347" }
+        };
+        var arthur = new Author("Arthur Vickers")
+        {
+            Contact = new() { Address = new("15a Main St", "Chigley", "CW1 5ZH", "UK"), Phone = "01632 12348" }
+        };
+        var brice = new Author("Brice Lambson")
+        {
+            Contact = new() { Address = new("4 Main St", "Chigley", "CW1 5ZH", "UK"), Phone = "01632 12349" }
+        };
+
+        var blogs = new List<Blog>
+        {
+            new(".NET Blog")
+            {
+                Posts =
+                {
+                    new Post(
+                        "Productivity comes to .NET MAUI in Visual Studio 2022",
+                        "Visual Studio 2022 17.3 is now available and...",
+                        new DateOnly(2022, 8, 9),
+                        4.0M) { Tags = { tagDotNetMaui, tagDotNet }, Author = maddy, Metadata = BuildPostMetadata() },
+                    new Post(
+                        "Announcing .NET 7 Preview 7", ".NET 7 Preview 7 is now available with improvements to System.LINQ, Unix...",
+                        new DateOnly(2022, 8, 9),
+                        4.2M) { Tags = { tagDotNet }, Author = jeremy, Metadata = BuildPostMetadata() },
+                    new Post(
+                        "ASP.NET Core updates in .NET 7 Preview 7", ".NET 7 Preview 7 is now available! Check out what's new in...",
+                        new DateOnly(2022, 8, 9),
+                        4.1M)
+                    {
+                        Tags = { tagDotNet, tagAspDotNet, tagAspDotNetCore }, Author = dan, Metadata = BuildPostMetadata()
+                    },
+                    new FeaturedPost(
+                        "Announcing Entity Framework 7 Preview 7: Interceptors!",
+                        "Announcing EF7 Preview 7 with new and improved interceptors, and...",
+                        new DateOnly(2022, 8, 9),
+                        4.5M,
+                        "Loads of runnable code!")
+                    {
+                        Tags = { tagEntityFramework, tagDotNet, tagDotNetCore }, Author = arthur, Metadata = BuildPostMetadata()
+                    }
+                },
+                Site = new(new("https://devblogs.microsoft.com/dotnet/"), "dotnet@example.com"),
+                Language = Language.English,
+            },
+            new("1unicorn2")
+            {
+                Posts =
+                {
+                    new Post(
+                        "Hacking my Sixth Form College network in 1991",
+                        "Back in 1991 I was a student at Franklin Sixth Form College...",
+                        new DateOnly(2020, 4, 10),
+                        4.5M) { Tags = { tagHacking }, Author = arthur, Metadata = BuildPostMetadata() },
+                    new FeaturedPost(
+                        "All your versions are belong to us",
+                        "Totally made up conversations about choosing Entity Framework version numbers...",
+                        new DateOnly(2020, 3, 26),
+                        3.9M,
+                        "Way funny!") { Tags = { tagEntityFramework }, Author = arthur, Metadata = BuildPostMetadata() },
+                    new Post(
+                        "Moving to Linux", "A few weeks ago, I decided to move from Windows to Linux as...",
+                        new DateOnly(2020, 3, 7),
+                        3.5M) { Tags = { tagLinux }, Author = arthur, Metadata = BuildPostMetadata(), Archived = true },
+                    new Post(
+                        "Welcome to One Unicorn 2.0!", "I created my first blog back in 2011..",
+                        new DateOnly(2020, 2, 29),
+                        4.8M) { Tags = { tagEntityFramework }, Author = arthur, Metadata = BuildPostMetadata() }
+                },
+                Site = new(new("https://blog.oneunicorn.com/"), "unicorn@example.com"),
+                Language = Language.English,
+            },
+            new("Brice's Blog")
+            {
+                Posts =
+                {
+                    new FeaturedPost(
+                        "SQLite in Visual Studio 2022", "A couple of years ago, I was thinking of ways...",
+                        new DateOnly(2022, 7, 26), 4.5M, "Love for VS!")
+                    {
+                        Tags = { tagSqlite, tagVisualStudio }, Author = brice, Metadata = BuildPostMetadata()
+                    },
+                    new Post(
+                        "On .NET - Entity Framework Migrations Explained",
+                        "This week, @JamesMontemagno invited me onto the On .NET show...",
+                        new DateOnly(2022, 5, 4),
+                        4.7M)
+                    {
+                        Tags = { tagEntityFramework, tagDotNet }, Author = brice, Metadata = BuildPostMetadata()
+                    },
+                    new Post(
+                        "Dear DBA: A silly idea", "We have fun on the Entity Framework team...",
+                        new DateOnly(2022, 3, 31),
+                        3.5M) { Tags = { tagEntityFramework }, Author = brice, Metadata = BuildPostMetadata(), Archived = true },
+                    new Post(
+                        "Microsoft.Data.Sqlite 6", "It’s that time of year again. Microsoft.Data.Sqlite version...",
+                        new DateOnly(2021, 11, 8),
+                        4.2M) { Tags = { tagSqlite, tagDotNet }, Author = brice, Metadata = BuildPostMetadata() }
+                },
+                Site = new(new("https://www.bricelam.net/"), "brice@example.com"),
+                Language = Language.English,
+            },
+            new("Developer for Life")
+            {
+                Posts =
+                {
+                    new Post(
+                        "GraphQL for .NET Developers", "A comprehensive overview of GraphQL as...",
+                        new DateOnly(2021, 7, 1), 4.1M)
+                    {
+                        Tags = { tagDotNet, tagGraphQl, tagAspDotNetCore }, Author = jeremy, Metadata = BuildPostMetadata()
+                    },
+                    new FeaturedPost(
+                        "Azure Cosmos DB With EF Core on Blazor Server",
+                        "Learn how to build Azure Cosmos DB apps using Entity Framework Core...",
+                        new DateOnly(2021, 5, 16),
+                        4.5M,
+                        "Blazor FTW!")
+                    {
+                        Tags =
+                        {
+                            tagDotNet,
+                            tagEntityFramework,
+                            tagAspDotNetCore,
+                            tagCosmosDb,
+                            tagBlazor
+                        },
+                        Author = jeremy,
+                        Metadata = BuildPostMetadata()
+                    },
+                    new Post(
+                        "Multi-tenancy with EF Core in Blazor Server Apps",
+                        "Learn several ways to implement multi-tenant databases in Blazor Server apps...",
+                        new DateOnly(2021, 4, 29),
+                        3.8M)
+                    {
+                        Tags = { tagDotNet, tagEntityFramework, tagAspDotNetCore, tagBlazor },
+                        Author = jeremy,
+                        Metadata = BuildPostMetadata()
+                    },
+                    new Post(
+                        "An Easier Blazor Debounce", "Where I propose a simple method to debounce input without...",
+                        new DateOnly(2021, 4, 12),
+                        4.5M)
+                    {
+                        Tags = { tagDotNet, tagAspDotNetCore, tagBlazor }, Author = jeremy, Metadata = BuildPostMetadata()
+                    }
+                },
+                Site = new(new("https://blog.jeremylikness.com/"), "jeremy@example.com"),
+                Language = Language.English,
+           }
+        };
+
+        await AddRangeAsync(blogs);
+        await SaveChangesAsync();
+
+        PostMetadata BuildPostMetadata()
+        {
+            var random = new Random(Guid.NewGuid().GetHashCode());
+
+            var metadata = new PostMetadata(random.Next(10000));
+
+            for (var i = 0; i < random.Next(5); i++)
+            {
+                var update = new PostUpdate(IPAddress.Loopback, DateOnly.FromDateTime(DateTime.UtcNow - TimeSpan.FromDays(random.Next(1, 10000))))
+                {
+                    UpdatedBy = "Admin"
+                };
+
+                for (var j = 0; j < random.Next(3); j++)
+                {
+                    update.Commits.Add(new(DateOnly.FromDateTime(DateTime.Today), $"Commit #{j + 1}"));
+                }
+
+                metadata.Updates.Add(update);
+            }
+
+            for (var i = 0; i < random.Next(5); i++)
+            {
+                metadata.TopSearches.Add(new($"Search #{i + 1}", 10000 - random.Next(i * 1000, i * 1000 + 900)));
+            }
+
+            for (var i = 0; i < random.Next(5); i++)
+            {
+                metadata.TopGeographies.Add(
+                    new(
+                        // Issue https://github.com/dotnet/efcore/issues/28811 (Support spatial types in JSON columns)
+                        // new Point(115.7930 + 20 - random.Next(40), 37.2431 + 10 - random.Next(20)) { SRID = 4326 },
+                        115.7930 + 20 - random.Next(40),
+                        37.2431 + 10 - random.Next(20),
+                        1000 - random.Next(i * 100, i * 100 + 90)) { Browsers = new() { "Firefox", "Netscape" } });
+            }
+
+            return metadata;
+        }
+    }
+}
+
+public class TphBlogsContext : BlogsContext
+{
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>().Ignore(e => e.Metadata);
+        modelBuilder.Entity<Author>().OwnsOne(e => e.Contact).OwnsOne(e => e.Address);
+
+        base.OnModelCreating(modelBuilder);
+    }
+}
+
+public enum MappingStrategy
+{
+    Tph,
+    Tpt,
+    Tpc,
+}
+
+public abstract class JsonBlogsContextBase : BlogsContext
+{
+    protected JsonBlogsContextBase(bool useSqlite = false)
+        : base(useSqlite)
+    {
+    }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Author>().OwnsOne(
+            author => author.Contact, ownedNavigationBuilder =>
+            {
+                ownedNavigationBuilder.ToJson();
+                ownedNavigationBuilder.OwnsOne(contactDetails => contactDetails.Address);
+            });
+
+        #region PostMetadataConfig
+        modelBuilder.Entity<Post>().OwnsOne(
+            post => post.Metadata, ownedNavigationBuilder =>
+            {
+                ownedNavigationBuilder.ToJson();
+                ownedNavigationBuilder.OwnsMany(metadata => metadata.TopSearches);
+                ownedNavigationBuilder.OwnsMany(metadata => metadata.TopGeographies);
+                ownedNavigationBuilder.OwnsMany(
+                    metadata => metadata.Updates,
+                    ownedOwnedNavigationBuilder => ownedOwnedNavigationBuilder.OwnsMany(update => update.Commits));
+            });
+        #endregion
+
+        base.OnModelCreating(modelBuilder);
+    }
+}
+
+public class JsonBlogsContext : JsonBlogsContextBase
+{
+}
+
+public class JsonBlogsContextSqlite : JsonBlogsContextBase
+{
+    public JsonBlogsContextSqlite()
+        : base(useSqlite: true)
+    {
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore9/ComplexTypesSample.cs b/samples/core/Miscellaneous/NewInEFCore9/ComplexTypesSample.cs
new file mode 100644
index 0000000000..3ced347a37
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore9/ComplexTypesSample.cs
@@ -0,0 +1,148 @@
+namespace NewInEfCore9;
+
+public static class ComplexTypesSample
+{
+    public static Task GropupBy_complex_type_instances()
+        => ExecuteQueries(sqlite: false);
+
+    public static Task GropupBy_complex_type_instances_on_SQLite()
+        => ExecuteQueries(sqlite: true);
+
+    public static async Task ExecuteQueries(bool sqlite)
+    {
+        PrintSampleName();
+
+        await using var context = new CustomerContext(useSqlite: sqlite);
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+
+        context.AddRange(
+            new Store
+            {
+                Customers = { new CustomerWithStores { Name = "Smokey", Region = "Germany" } },
+                Region = "Germany",
+                StoreAddress = new("L1", null, "Ci1", "Co1", "P1")
+            },
+            new Customer
+            {
+                Name = "Smokey",
+                CustomerInfo = new("EF")
+                {
+                    HomeAddress = new("L2", null, "Ci2", "Co2", "P2"), WorkAddress = new("L3", null, "Ci3", "Co3", "P3")
+                },
+            },
+            new CustomerTpt
+            {
+                Name = "Willow",
+                CustomerInfo = new("EF")
+                {
+                    HomeAddress = new("L5", null, "Ci5", "Co5", "P5"), WorkAddress = new("L6", null, "Ci6", "Co6", "P6")
+                },
+            },
+            new SpecialCustomerTpt
+            {
+                Name = "Olive",
+                CustomerInfo = new("EF")
+                {
+                    HomeAddress = new("L7", null, "Ci7", "Co7", "P7"), WorkAddress = new("L8", null, "Ci8", "Co8", "P8")
+                }
+            });
+
+        await context.SaveChangesAsync();
+        context.ChangeTracker.Clear();
+
+        Console.WriteLine();
+        Console.WriteLine("GroupBy complex type:");
+        Console.WriteLine();
+
+        #region GroupByComplexType
+        var groupedAddresses = await context.Stores
+            .GroupBy(b => b.StoreAddress)
+            .Select(g => new { g.Key, Count = g.Count() })
+            .ToListAsync();
+        #endregion
+
+        foreach (var groupedAddress in groupedAddresses)
+        {
+            Console.WriteLine($"{groupedAddress.Key.PostCode}: {groupedAddress.Count}");
+        }
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    [Table("TptSpecialCustomers")]
+    public class SpecialCustomerTpt : CustomerTpt
+    {
+        public string? Note { get; set; }
+    }
+
+    [Table("TptCustomers")]
+    public class CustomerTpt
+    {
+        public int Id { get; set; }
+        public required string Name { get; set; }
+        public required CustomerInfo CustomerInfo { get; set; }
+    }
+
+    public class Customer
+    {
+        public int Id { get; set; }
+        public required string Name { get; set; }
+        public required CustomerInfo CustomerInfo { get; set; }
+    }
+
+    public record struct CustomerInfo(string? Tag)
+    {
+        public required Address HomeAddress { get; init; }
+        public required Address WorkAddress { get; init; }
+    }
+
+    [ComplexType]
+    public record class Address(string Line1, string? Line2, string City, string Country, string PostCode);
+
+    public class CustomerWithStores
+    {
+        public int Id { get; set; }
+        public required string Name { get; set; }
+        public string? Region { get; set; }
+        public string? Tag { get; set; }
+    }
+
+    public class Store
+    {
+        public int Id { get; set; }
+        public List<CustomerWithStores> Customers { get; } = new();
+        public string? Region { get; set; }
+        public required Address StoreAddress { get; set; }
+    }
+
+    public class CustomerContext(bool useSqlite = false) : DbContext
+    {
+        public bool UseSqlite { get; } = useSqlite;
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => (UseSqlite
+                    ? optionsBuilder.UseSqlite(@$"DataSource={GetType().Name}.db",
+                        sqliteOptionsBuilder => sqliteOptionsBuilder.UseNetTopologySuite())
+                    : optionsBuilder.UseSqlServer(
+                        @$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0",
+                        sqlServerOptionsBuilder => sqlServerOptionsBuilder.UseNetTopologySuite()))
+                .EnableSensitiveDataLogging()
+                .LogTo(Console.WriteLine, LogLevel.Information);
+
+        protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+        {
+            configurationBuilder.ComplexProperties<CustomerInfo>();
+        }
+
+        public DbSet<Customer> Customers => Set<Customer>();
+        public DbSet<CustomerWithStores> CustomersWithStores => Set<CustomerWithStores>();
+        public DbSet<Store> Stores => Set<Store>();
+        public DbSet<CustomerTpt> TptCustomers => Set<CustomerTpt>();
+        public DbSet<SpecialCustomerTpt> TptSpecialCustomers => Set<SpecialCustomerTpt>();
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore9/CustomConventionsSample.cs b/samples/core/Miscellaneous/NewInEFCore9/CustomConventionsSample.cs
new file mode 100644
index 0000000000..5566bac029
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore9/CustomConventionsSample.cs
@@ -0,0 +1,120 @@
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Metadata.Builders;
+using Microsoft.EntityFrameworkCore.Metadata.Conventions;
+using Microsoft.EntityFrameworkCore.Metadata.Conventions.Infrastructure;
+using Microsoft.EntityFrameworkCore.Storage;
+
+namespace NewInEfCore9;
+
+public static class CustomConventionsSample
+{
+    public static async Task Conventions_enhancements_in_EF9()
+    {
+        PrintSampleName();
+
+        await using var context = new TestContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.LoggingEnabled = true;
+        context.ChangeTracker.Clear();
+
+        Console.WriteLine(context.Model.ToDebugString());
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public class TestContext : DbContext
+    {
+        public bool LoggingEnabled { get; set; }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder.UseSqlServer(@$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0")
+                .EnableSensitiveDataLogging()
+                .LogTo(
+                    s =>
+                    {
+                        if (LoggingEnabled)
+                        {
+                            Console.WriteLine(s);
+                        }
+                    }, LogLevel.Information);
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.ApplyConfigurationsFromAssembly(GetType().Assembly);
+        }
+
+        protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+        {
+            configurationBuilder.Conventions.Replace<PropertyDiscoveryConvention>(
+                serviceProvider => new AttributeBasedPropertyDiscoveryConvention(
+                    serviceProvider.GetRequiredService<ProviderConventionSetBuilderDependencies>()));
+        }
+
+        public async Task Seed()
+        {
+            await SaveChangesAsync();
+        }
+    }
+
+    #region AttributeBasedPropertyDiscoveryConvention
+    public class AttributeBasedPropertyDiscoveryConvention(ProviderConventionSetBuilderDependencies dependencies)
+        : PropertyDiscoveryConvention(dependencies)
+    {
+        protected override bool IsCandidatePrimitiveProperty(
+            MemberInfo memberInfo, IConventionTypeBase structuralType, out CoreTypeMapping? mapping)
+        {
+            if (base.IsCandidatePrimitiveProperty(memberInfo, structuralType, out mapping))
+            {
+                if (Attribute.IsDefined(memberInfo, typeof(PersistAttribute), inherit: true))
+                {
+                    return true;
+                }
+
+                structuralType.Builder.Ignore(memberInfo.Name);
+            }
+
+            mapping = null;
+            return false;
+        }
+    }
+    #endregion
+
+    #region Country
+    public class Country
+    {
+        [Persist]
+        public int Code { get; set; }
+
+        [Persist]
+        public required string Name { get; set; }
+
+        public bool IsDirty { get; set; } // Will not be mapped by default.
+
+        private class FooConfiguration : IEntityTypeConfiguration<Country>
+        {
+            private FooConfiguration()
+            {
+            }
+
+            public void Configure(EntityTypeBuilder<Country> builder)
+            {
+                builder.HasKey(e => e.Code);
+            }
+        }
+    }
+    #endregion
+}
+
+#region PersistAttribute
+[AttributeUsage(AttributeTargets.Property | AttributeTargets.Field)]
+public sealed class PersistAttribute : Attribute
+{
+}
+#endregion
diff --git a/samples/core/Miscellaneous/NewInEFCore9/DateOnlyTimeOnlySample.cs b/samples/core/Miscellaneous/NewInEFCore9/DateOnlyTimeOnlySample.cs
new file mode 100644
index 0000000000..6a792c8b3a
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore9/DateOnlyTimeOnlySample.cs
@@ -0,0 +1,251 @@
+namespace NewInEfCore9;
+
+public static class DateOnlyTimeOnlySample
+{
+    public static Task Can_use_DateOnly_TimeOnly_on_SQL_Server()
+    {
+        PrintSampleName();
+        return DateOnlyTimeOnlyTest<BritishSchoolsContext>();
+    }
+
+    public static Task Can_use_DateOnly_TimeOnly_on_SQL_Server_with_JSON()
+    {
+        PrintSampleName();
+        return DateOnlyTimeOnlyTest<BritishSchoolsContextJson>();
+    }
+
+    public static Task Can_use_DateOnly_TimeOnly_on_SQLite()
+    {
+        PrintSampleName();
+        return DateOnlyTimeOnlyTest<BritishSchoolsContextSqlite>();
+    }
+
+    private static async Task DateOnlyTimeOnlyTest<TContext>()
+        where TContext : BritishSchoolsContextBase, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.LoggingEnabled = true;
+        context.ChangeTracker.Clear();
+
+        Console.WriteLine();
+
+        // Issue https://github.com/dotnet/efcore/issues/25103
+        if (!context.UseSqlite)
+        {
+            #region FromDateTime
+            var visitedTime = new TimeOnly(12, 0);
+            var visited = await context.Schools
+                .Where(p => TimeOnly.FromDateTime(p.LastVisited) >= visitedTime)
+                .ToListAsync();
+            #endregion
+        }
+
+        Console.WriteLine();
+
+        // Issue https://github.com/dotnet/efcore/issues/25103
+        if (!context.UseSqlite)
+        {
+            #region FromTimeSpan
+            var visitedTime = new TimeOnly(12, 0);
+            var visited = await context.Schools
+                .Where(p => TimeOnly.FromTimeSpan(p.LegacyTime) >= visitedTime)
+                .ToListAsync();
+            #endregion
+        }
+
+        Console.WriteLine();
+
+        // Issue https://github.com/dotnet/efcore/issues/25103
+        if (!context.UseSqlite)
+        {
+            var visitedAt = DateTime.UtcNow;
+            var visitedSchools = await context.Schools
+                .AsNoTracking()
+                .SelectMany(e => e.OpeningHours)
+                .Where(e => e.OpensAt <= TimeOnly.FromDateTime(visitedAt) && e.OpensAt > TimeOnly.FromDateTime(visitedAt))
+                .ToListAsync();
+        }
+
+        // Issue https://github.com/dotnet/efcore/issues/33937
+        // // Issue https://github.com/dotnet/efcore/issues/30223
+        // if (!context.UsesJson
+        //     && !context.UseSqlite)
+        // {
+        //     await context.Schools
+        //         .SelectMany(e => e.OpeningHours)
+        //         .Where(e => e.DayOfWeek == DayOfWeek.Friday)
+        //         .ExecuteUpdateAsync(s => s.SetProperty(t => t.OpensAt, t => t.OpensAt!.Value.AddHours(-1)));
+        // }
+
+        Console.WriteLine();
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public abstract class BritishSchoolsContextBase : DbContext
+    {
+        protected BritishSchoolsContextBase(bool useSqlite = false)
+        {
+            UseSqlite = useSqlite;
+        }
+
+        public bool UseSqlite { get; }
+        public virtual bool UsesJson => false;
+        public bool LoggingEnabled { get; set; }
+
+        public DbSet<School> Schools => Set<School>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => (UseSqlite
+                    ? optionsBuilder.UseSqlite(@$"DataSource={GetType().Name}.db")
+                    : optionsBuilder.UseSqlServer(
+                        @$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0",
+                        sqlServerOptionsBuilder => sqlServerOptionsBuilder.UseNetTopologySuite()))
+                .EnableSensitiveDataLogging()
+                .LogTo(
+                    s =>
+                    {
+                        if (LoggingEnabled)
+                        {
+                            Console.WriteLine(s);
+                        }
+                    }, LogLevel.Information);
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+        }
+
+        protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+        {
+        }
+
+        public async Task Seed()
+        {
+            AddRange(
+                new School
+                {
+                    Name = "Stowe School",
+                    Founded = new(1923, 5, 11),
+                    Terms =
+                    {
+                        new() { Name = "Michaelmas", FirstDay = new(2022, 9, 7), LastDay = new(2022, 12, 16) },
+                        new() { Name = "Lent", FirstDay = new(2023, 1, 8), LastDay = new(2023, 3, 24) },
+                        new() { Name = "Summer", FirstDay = new(2023, 4, 18), LastDay = new(2023, 7, 8) }
+                    },
+                    OpeningHours =
+                    {
+                        new(DayOfWeek.Sunday, null, null),
+                        new(DayOfWeek.Monday, new(8, 00), new(18, 00)),
+                        new(DayOfWeek.Tuesday, new(8, 00), new(18, 00)),
+                        new(DayOfWeek.Wednesday, new(8, 00), new(18, 00)),
+                        new(DayOfWeek.Thursday, new(8, 00), new(18, 00)),
+                        new(DayOfWeek.Friday, new(8, 00), new(18, 00)),
+                        new(DayOfWeek.Saturday, new(8, 00), new(17, 00))
+                    }
+                },
+                new School
+                {
+                    Name = "Farr High School",
+                    Founded = new(1964, 5, 1),
+                    Terms =
+                    {
+                        new() { Name = "Autumn", FirstDay = new(2022, 8, 16), LastDay = new(2022, 12, 23) },
+                        new() { Name = "Winter", FirstDay = new(2023, 1, 9), LastDay = new(2023, 3, 31) },
+                        new() { Name = "Summer", FirstDay = new(2023, 4, 17), LastDay = new(2023, 6, 29) }
+                    },
+                    OpeningHours =
+                    {
+                        new(DayOfWeek.Sunday, null, null),
+                        new(DayOfWeek.Monday, new(8, 45), new(15, 35)),
+                        new(DayOfWeek.Tuesday, new(8, 45), new(15, 35)),
+                        new(DayOfWeek.Wednesday, new(8, 45), new(15, 35)),
+                        new(DayOfWeek.Thursday, new(8, 45), new(15, 35)),
+                        new(DayOfWeek.Friday, new(8, 45), new(12, 50)),
+                        new(DayOfWeek.Saturday, null, null)
+                    }
+                });
+
+            await SaveChangesAsync();
+        }
+    }
+
+    public class BritishSchoolsContext : BritishSchoolsContextBase
+    {
+    }
+
+    public class BritishSchoolsContextJson : BritishSchoolsContextBase
+    {
+
+        public override bool UsesJson => true;
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            base.OnModelCreating(modelBuilder);
+
+            modelBuilder.Entity<School>().OwnsMany(e => e.OpeningHours).ToJson();
+        }
+    }
+
+    public class BritishSchoolsContextSqlite : BritishSchoolsContextBase
+    {
+        public BritishSchoolsContextSqlite()
+            : base(useSqlite: true)
+        {
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            base.OnModelCreating(modelBuilder);
+
+            modelBuilder.Entity<School>().OwnsMany(
+                e => e.OpeningHours, b =>
+                {
+                    b.Property<int>("Id");
+                    b.HasKey("Id");
+                });
+        }
+    }
+
+    public class School
+    {
+        public int Id { get; set; }
+        public string Name { get; set; } = null!;
+        public DateOnly Founded { get; set; }
+        public DateTime LastVisited { get; set; }
+        public TimeSpan LegacyTime { get; set; }
+        public List<Term> Terms { get; } = new();
+        public List<OpeningHours> OpeningHours { get; } = new();
+    }
+
+    public class Term
+    {
+        public int Id { get; set; }
+        public string Name { get; set; } = null!;
+        public DateOnly FirstDay { get; set; }
+        public DateOnly LastDay { get; set; }
+        public School School { get; set; } = null!;
+    }
+
+    [Owned]
+    public class OpeningHours
+    {
+        public OpeningHours(DayOfWeek dayOfWeek, TimeOnly? opensAt, TimeOnly? closesAt)
+        {
+            DayOfWeek = dayOfWeek;
+            OpensAt = opensAt;
+            ClosesAt = closesAt;
+        }
+
+        public DayOfWeek DayOfWeek { get; private set; }
+        public TimeOnly? OpensAt { get; set; }
+        public TimeOnly? ClosesAt { get; set; }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore9/ExecuteUpdateSample.cs b/samples/core/Miscellaneous/NewInEFCore9/ExecuteUpdateSample.cs
new file mode 100644
index 0000000000..6dbbf336e6
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore9/ExecuteUpdateSample.cs
@@ -0,0 +1,244 @@
+namespace NewInEfCore9;
+
+public static class ExecuteUpdateSample
+{
+    public static Task ExecuteUpdate_for_complex_type_instances()
+        => ExecuteUpdateDeleteTest(sqlite: false);
+
+    public static Task ExecuteUpdate_for_complex_type_instances_on_SQLite()
+        => ExecuteUpdateDeleteTest(sqlite: true);
+
+    public static async Task ExecuteUpdateDeleteTest(bool sqlite)
+    {
+        PrintSampleName();
+
+        await using var context = new CustomerContext(useSqlite: sqlite);
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+
+        context.AddRange(
+            new Store
+            {
+                Customers = { new CustomerWithStores { Name = "Smokey", Region = "Germany" } },
+                Region = "Germany",
+                StoreAddress = new("L1", null, "Ci1", "Co1", "P1")
+            },
+            new Customer
+            {
+                Name = "Smokey",
+                CustomerInfo = new("EF")
+                {
+                    HomeAddress = new("L2", null, "Ci2", "Co2", "P2"), WorkAddress = new("L3", null, "Ci3", "Co3", "P3")
+                },
+            },
+            new CustomerTpt
+            {
+                Name = "Willow",
+                CustomerInfo = new("EF")
+                {
+                    HomeAddress = new("L5", null, "Ci5", "Co5", "P5"), WorkAddress = new("L6", null, "Ci6", "Co6", "P6")
+                },
+            },
+            new SpecialCustomerTpt
+            {
+                Name = "Olive",
+                CustomerInfo = new("EF")
+                {
+                    HomeAddress = new("L7", null, "Ci7", "Co7", "P7"), WorkAddress = new("L8", null, "Ci8", "Co8", "P8")
+                }
+            });
+
+        await context.SaveChangesAsync();
+        context.ChangeTracker.Clear();
+
+        Console.WriteLine();
+        Console.WriteLine("Non-complex type update:");
+        Console.WriteLine();
+
+        #region NormalExecuteUpdate
+        await context.Stores
+            .Where(e => e.Region == "Germany")
+            .ExecuteUpdateAsync(s => s.SetProperty(b => b.Region, "Deutschland"));
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine("Update complex type members:");
+        Console.WriteLine();
+
+        {
+            #region UpdateComplexTypeByMember
+            var newAddress = new Address("Gressenhall Farm Shop", null, "Beetley", "Norfolk", "NR20 4DR");
+
+            await context.Stores
+                .Where(e => e.Region == "Deutschland")
+                .ExecuteUpdateAsync(
+                    s => s.SetProperty(b => b.StoreAddress.Line1, newAddress.Line1)
+                        .SetProperty(b => b.StoreAddress.Line2, newAddress.Line2)
+                        .SetProperty(b => b.StoreAddress.City, newAddress.City)
+                        .SetProperty(b => b.StoreAddress.Country, newAddress.Country)
+                        .SetProperty(b => b.StoreAddress.PostCode, newAddress.PostCode));
+            #endregion
+        }
+
+        Console.WriteLine();
+        Console.WriteLine("Update a top-level complex type instance:");
+        Console.WriteLine();
+
+        {
+            #region UpdateComplexType
+            var newAddress = new Address("Gressenhall Farm Shop", null, "Beetley", "Norfolk", "NR20 4DR");
+
+            await context.Stores
+                .Where(e => e.Region == "Germany")
+                .ExecuteUpdateAsync(s => s.SetProperty(b => b.StoreAddress, newAddress));
+            #endregion
+        }
+
+        Console.WriteLine();
+        Console.WriteLine("Update a nested complex type instance:");
+        Console.WriteLine();
+
+        var name = "Smokey";
+
+        #region UpdateNestedComplexType
+        await context.Customers
+            .Where(e => e.Name == name)
+            .ExecuteUpdateAsync(
+                s => s.SetProperty(b => b.CustomerInfo.WorkAddress, new Address("Gressenhall Workhouse", null, "Beetley", "Norfolk", "NR20 4DR")));
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine("Update multiple complex type instances and a normal property:");
+        Console.WriteLine();
+
+        #region UpdateMultipleComplexType
+        await context.Customers
+            .Where(e => e.Name == name)
+            .ExecuteUpdateAsync(
+                s => s.SetProperty(
+                        b => b.CustomerInfo.WorkAddress, new Address("Gressenhall Workhouse", null, "Beetley", "Norfolk", "NR20 4DR"))
+                    .SetProperty(b => b.CustomerInfo.HomeAddress, new Address("Gressenhall Farm", null, "Beetley", "Norfolk", "NR20 4DR"))
+                    .SetProperty(b => b.CustomerInfo.Tag, "Tog"));
+        #endregion
+
+        // Console.WriteLine();
+        // Console.WriteLine("Update a complex type instance using existing values from the table:");
+        // Console.WriteLine();
+
+        #region UpdateWithExistingValues
+        // See https://github.com/dotnet/efcore/issues/32987
+        // await context.Stores
+        //     .Where(e => e.Region == "Germany")
+        //     .ExecuteUpdateAsync(
+        //         s => s.SetProperty(b => b.StoreAddress, b => new Address(b.StoreAddress.Line1, null, "Cib", "Cob", "Pb")));
+        #endregion
+
+        // Console.WriteLine();
+        // Console.WriteLine("Update multiple nested complex type instances using existing values from the table:");
+        // Console.WriteLine();
+
+        #region UpdateMultiplWithExisting
+        // See https://github.com/dotnet/efcore/issues/32987
+        // await context.Customers
+        //     .Where(e => e.Name == name)
+        //     .ExecuteUpdateAsync(
+        //         s => s.SetProperty(
+        //                 b => b.CustomerInfo.HomeAddress,
+        //                 b => new Address(
+        //                     b.CustomerInfo.WorkAddress.Line1, b.CustomerInfo.WorkAddress.Line2, b.CustomerInfo.WorkAddress.City,
+        //                     b.CustomerInfo.WorkAddress.Country, b.CustomerInfo.WorkAddress.PostCode))
+        //             .SetProperty(
+        //                 b => b.CustomerInfo.WorkAddress,
+        //                 b => new Address(
+        //                     b.CustomerInfo.HomeAddress.Line1, b.CustomerInfo.HomeAddress.Line2, b.CustomerInfo.HomeAddress.City,
+        //                     b.CustomerInfo.HomeAddress.Country, b.CustomerInfo.HomeAddress.PostCode)));
+        #endregion
+    }
+
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    [Table("TptSpecialCustomers")]
+    public class SpecialCustomerTpt : CustomerTpt
+    {
+        public string? Note { get; set; }
+    }
+
+    [Table("TptCustomers")]
+    public class CustomerTpt
+    {
+        public int Id { get; set; }
+        public required string Name { get; set; }
+        public required CustomerInfo CustomerInfo { get; set; }
+    }
+
+    public class Customer
+    {
+        public int Id { get; set; }
+        public required string Name { get; set; }
+        public required CustomerInfo CustomerInfo { get; set; }
+    }
+
+    public record struct CustomerInfo(string? Tag)
+    {
+        public required Address HomeAddress { get; init; }
+        public required Address WorkAddress { get; init; }
+    }
+
+    [ComplexType]
+    public record class Address(string Line1, string? Line2, string City, string Country, string PostCode);
+
+    public class CustomerWithStores
+    {
+        public int Id { get; set; }
+        public required string Name { get; set; }
+        public string? Region { get; set; }
+        public string? Tag { get; set; }
+    }
+
+    public class Store
+    {
+        public int Id { get; set; }
+        public List<CustomerWithStores> Customers { get; } = new();
+        public string? Region { get; set; }
+        public required Address StoreAddress { get; set; }
+    }
+
+    public class CustomerContext(bool useSqlite = false) : DbContext
+    {
+        public bool UseSqlite { get; } = useSqlite;
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => (UseSqlite
+                    ? optionsBuilder.UseSqlite(@$"DataSource={GetType().Name}.db",
+                        sqliteOptionsBuilder =>
+                        {
+                            sqliteOptionsBuilder.UseNetTopologySuite();
+                            sqliteOptionsBuilder.CommandTimeout(0);
+                        })
+                    : optionsBuilder.UseSqlServer(
+                        @$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0",
+                        sqlServerOptionsBuilder =>
+                        {
+                            sqlServerOptionsBuilder.UseNetTopologySuite();
+                            sqlServerOptionsBuilder.CommandTimeout(0);
+                        }))
+                .EnableSensitiveDataLogging()
+                .LogTo(Console.WriteLine, LogLevel.Information);
+
+        protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+        {
+            configurationBuilder.ComplexProperties<CustomerInfo>();
+        }
+
+        public DbSet<Customer> Customers => Set<Customer>();
+        public DbSet<CustomerWithStores> CustomersWithStores => Set<CustomerWithStores>();
+        public DbSet<Store> Stores => Set<Store>();
+        public DbSet<CustomerTpt> TptCustomers => Set<CustomerTpt>();
+        public DbSet<SpecialCustomerTpt> TptSpecialCustomers => Set<SpecialCustomerTpt>();
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore9/HierarchyIdSample.cs b/samples/core/Miscellaneous/NewInEFCore9/HierarchyIdSample.cs
new file mode 100644
index 0000000000..07ce56f249
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore9/HierarchyIdSample.cs
@@ -0,0 +1,121 @@
+public static class HierarchyIdSample
+{
+    public static async Task SQL_Server_HierarchyId()
+    {
+        PrintSampleName();
+
+        await using var context = new FamilyTreeContext();
+        await context.Database.EnsureDeletedAsync();
+
+        context.LoggingEnabled = true;
+
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.ChangeTracker.Clear();
+
+        #region HierarchyIdQuery
+        var daisy = await context.Halflings.SingleAsync(e => e.Name == "Daisy");
+        #endregion
+
+        #region HierarchyIdParse1
+        var child1 = new Halfling(HierarchyId.Parse(daisy.PathFromPatriarch, 1), "Toast");
+        var child2 = new Halfling(HierarchyId.Parse(daisy.PathFromPatriarch, 2), "Wills");
+        #endregion
+
+        #region HierarchyIdParse2
+        var child1b = new Halfling(HierarchyId.Parse(daisy.PathFromPatriarch, 1, 5), "Toast");
+        #endregion
+
+        context.AddRange(child1, child2, child1b);
+
+        await context.SaveChangesAsync();
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    #region Halfling
+    public class Halfling
+    {
+        public Halfling(HierarchyId pathFromPatriarch, string name, int? yearOfBirth = null)
+        {
+            PathFromPatriarch = pathFromPatriarch;
+            Name = name;
+            YearOfBirth = yearOfBirth;
+        }
+
+        public int Id { get; private set; }
+        public HierarchyId PathFromPatriarch { get; set; }
+        public string Name { get; set; }
+        public int? YearOfBirth { get; set; }
+    }
+    #endregion
+
+    public class FamilyTreeContext : DbContext
+    {
+        public bool LoggingEnabled { get; set; }
+
+        public DbSet<Halfling> Halflings => Set<Halfling>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder.UseSqlServer(
+                    @$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0",
+                    sqlServerOptionsBuilder => sqlServerOptionsBuilder.UseHierarchyId())
+                .EnableSensitiveDataLogging()
+                .LogTo(
+                    s =>
+                    {
+                        if (LoggingEnabled)
+                        {
+                            Console.WriteLine(s);
+                        }
+                    }, LogLevel.Information);
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+        }
+
+        public async Task Seed()
+        {
+            #region AddRangeAsync
+            await AddRangeAsync(
+                new Halfling(HierarchyId.Parse("/"), "Balbo", 1167),
+                new Halfling(HierarchyId.Parse("/1/"), "Mungo", 1207),
+                new Halfling(HierarchyId.Parse("/2/"), "Pansy", 1212),
+                new Halfling(HierarchyId.Parse("/3/"), "Ponto", 1216),
+                new Halfling(HierarchyId.Parse("/4/"), "Largo", 1220),
+                new Halfling(HierarchyId.Parse("/5/"), "Lily", 1222),
+                new Halfling(HierarchyId.Parse("/1/1/"), "Bungo", 1246),
+                new Halfling(HierarchyId.Parse("/1/2/"), "Belba", 1256),
+                new Halfling(HierarchyId.Parse("/1/3/"), "Longo", 1260),
+                new Halfling(HierarchyId.Parse("/1/4/"), "Linda", 1262),
+                new Halfling(HierarchyId.Parse("/1/5/"), "Bingo", 1264),
+                new Halfling(HierarchyId.Parse("/3/1/"), "Rosa", 1256),
+                new Halfling(HierarchyId.Parse("/3/2/"), "Polo"),
+                new Halfling(HierarchyId.Parse("/4/1/"), "Fosco", 1264),
+                new Halfling(HierarchyId.Parse("/1/1/1/"), "Bilbo", 1290),
+                new Halfling(HierarchyId.Parse("/1/3/1/"), "Otho", 1310),
+                new Halfling(HierarchyId.Parse("/1/5/1/"), "Falco", 1303),
+                new Halfling(HierarchyId.Parse("/3/2/1/"), "Posco", 1302),
+                new Halfling(HierarchyId.Parse("/3/2/2/"), "Prisca", 1306),
+                new Halfling(HierarchyId.Parse("/4/1/1/"), "Dora", 1302),
+                new Halfling(HierarchyId.Parse("/4/1/2/"), "Drogo", 1308),
+                new Halfling(HierarchyId.Parse("/4/1/3/"), "Dudo", 1311),
+                new Halfling(HierarchyId.Parse("/1/3/1/1/"), "Lotho", 1310),
+                new Halfling(HierarchyId.Parse("/1/5/1/1/"), "Poppy", 1344),
+                new Halfling(HierarchyId.Parse("/3/2/1/1/"), "Ponto", 1346),
+                new Halfling(HierarchyId.Parse("/3/2/1/2/"), "Porto", 1348),
+                new Halfling(HierarchyId.Parse("/3/2/1/3/"), "Peony", 1350),
+                new Halfling(HierarchyId.Parse("/4/1/2/1/"), "Frodo", 1368),
+                new Halfling(HierarchyId.Parse("/4/1/3/1/"), "Daisy", 1350),
+                new Halfling(HierarchyId.Parse("/3/2/1/1/1/"), "Angelica", 1381));
+
+            await SaveChangesAsync();
+            #endregion
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore9/JsonColumnsSample.cs b/samples/core/Miscellaneous/NewInEFCore9/JsonColumnsSample.cs
new file mode 100644
index 0000000000..8bef527d67
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore9/JsonColumnsSample.cs
@@ -0,0 +1,56 @@
+using System.Net;
+
+namespace NewInEfCore9;
+
+public static class JsonColumnsSample
+{
+    public static Task Columns_from_JSON_are_pruned_when_needed()
+    {
+        PrintSampleName();
+        return JsonColumnsTest<JsonBlogsContext>();
+    }
+
+    public static Task Columns_from_JSON_are_pruned_when_needed_on_SQLite()
+    {
+        PrintSampleName();
+        return JsonColumnsTest<JsonBlogsContextSqlite>();
+    }
+
+    private static async Task JsonColumnsTest<TContext>()
+        where TContext : BlogsContext, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.LoggingEnabled = true;
+        context.ChangeTracker.Clear();
+
+        Console.WriteLine();
+        Console.WriteLine("JSON column pruning:");
+        Console.WriteLine();
+
+        var date = new DateOnly(2022, 10, 11);
+
+        #region PruneJSON
+        var postsUpdatedOn = await context.Posts
+            .Where(p => p.Metadata!.Updates.Count(e => e.UpdatedOn >= date) == 1)
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine("JSON column pruning in primitive collection count:");
+        Console.WriteLine();
+
+        #region PruneJSONPrimitive
+        var tagsWithCount = await context.Tags.Where(p => p.Text.Length == 1).ToListAsync();
+        #endregion
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore9/LeastGreatestSample.cs b/samples/core/Miscellaneous/NewInEFCore9/LeastGreatestSample.cs
new file mode 100644
index 0000000000..8fde721208
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore9/LeastGreatestSample.cs
@@ -0,0 +1,470 @@
+using System.Collections;
+using System.Collections.ObjectModel;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+namespace NewInEfCore9;
+
+public static class LeastGreatestSample
+{
+    public static Task Queries_using_Least_and_Greatest()
+    {
+        PrintSampleName();
+        return LeastGreatestTest<PubsAndWalksContext>();
+    }
+
+    public static Task Queries_using_Least_and_Greatest_on_SQLite()
+    {
+        PrintSampleName();
+        return LeastGreatestTest<PubsAndWalksContextSqlite>();
+    }
+
+    private static async Task LeastGreatestTest<TContext>()
+        where TContext : PubsAndWalksContextBase, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.LoggingEnabled = true;
+        context.ChangeTracker.Clear();
+
+        Console.WriteLine();
+        Console.WriteLine("Use Math.Min on Azure SQL:");
+        Console.WriteLine();
+
+        #region MathMin
+        var walksUsingMin = await context.Walks
+            .Where(e => Math.Min(e.DaysVisited.Count, e.ClosestPub.Beers.Length) > 4)
+            .ToListAsync();
+        #endregion
+
+        if (!context.UseSqlite)
+        {
+            Console.WriteLine();
+            Console.WriteLine("Use Math.Min on primitive collection values:");
+            Console.WriteLine();
+
+            var threshold = 10;
+            var top = 11;
+
+            #region MathMinPrimitive
+            var pubsInlineMax = await context.Pubs
+                .SelectMany(e => e.Counts)
+                .Where(e => Math.Max(e, threshold) > top)
+                .ToListAsync();
+            #endregion
+        }
+
+        Console.WriteLine();
+        Console.WriteLine("Call Least directly:");
+        Console.WriteLine();
+
+        #region Least
+        var leastCount = await context.Pubs
+            .Select(e => EF.Functions.Least(e.Counts.Length, e.DaysVisited.Count, e.Beers.Length))
+            .ToListAsync();
+        #endregion
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public class MyCollection : IList<int>
+    {
+        private readonly List<int> _list = new();
+        public IEnumerator<int> GetEnumerator() => _list.GetEnumerator();
+        IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();
+        public void Add(int item) => _list.Add(item);
+        public void Clear() => _list.Clear();
+        public bool Contains(int item) => _list.Contains(item);
+        public void CopyTo(int[] array, int arrayIndex) => _list.CopyTo(array, arrayIndex);
+        public bool Remove(int item) => _list.Remove(item);
+        public int Count => _list.Count;
+        public bool IsReadOnly => ((ICollection<int>)_list).IsReadOnly;
+        public int IndexOf(int item) => _list.IndexOf(item);
+        public void Insert(int index, int item) => _list.Insert(index, item);
+        public void RemoveAt(int index) => _list.RemoveAt(index);
+        public int this[int index]
+        {
+            get => _list[index];
+            set => _list[index] = value;
+        }
+    }
+
+    public class PrimitiveCollections
+    {
+        public int Id { get; set; }
+        public IEnumerable<int> Ints { get; set; } = null!;
+        public ICollection<string> Strings { get; set; } = null!;
+        public Collection<DateTime> DateTimes { get; set; } = null!;
+        public IList<DateOnly> Dates { get; set; } = null!;
+
+        [MaxLength(2500)]
+        [Unicode(false)]
+        public uint[] UnsignedInts { get; set; } = null!;
+
+        public ObservableCollection<Guid> Guids { get; set; } = null!;
+        public List<bool> Booleans { get; set; } = null!;
+        public List<Uri> Urls { get; set; } = null!;
+
+        public List<int> GetOnlyInts { get; } = new();
+
+        // ReSharper disable once CollectionNeverUpdated.Local
+        private readonly List<int> _intsField = new();
+    }
+
+    public readonly struct DddId
+    {
+        public DddId(int value)
+        {
+            Value = value;
+        }
+
+        public int Value { get; }
+    }
+
+    public class DddIdConverter : ValueConverter<DddId, int>
+    {
+        public DddIdConverter()
+            : base(v => v.Value, v => new DddId())
+        {
+        }
+    }
+
+    #region DogWalk
+    public class DogWalk
+    {
+        public DogWalk(string name)
+        {
+            Name = name;
+        }
+
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public Terrain Terrain { get; set; }
+        public List<DateOnly> DaysVisited { get; private set; } = new();
+        public Pub ClosestPub { get; set; } = null!;
+    }
+
+    public enum Terrain
+    {
+        Forest,
+        River,
+        Hills,
+        Village,
+        Park,
+        Beach,
+    }
+    #endregion
+
+    #region Pub
+    public class Pub
+    {
+        public Pub(string name, string[] beers)
+        {
+            Name = name;
+            Beers = beers;
+        }
+
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public string[] Beers { get; set; }
+        public int[] Counts { get; set; } = [];
+        public List<DateOnly> DaysVisited { get; private set; } = new();
+    }
+    #endregion
+
+    public class PubsAndWalksContext : PubsAndWalksContextBase
+    {
+    }
+
+    public class PubsAndWalksContextSqlite : PubsAndWalksContextBase
+    {
+        public PubsAndWalksContextSqlite()
+            : base(useSqlite: true)
+        {
+        }
+    }
+
+    public abstract class PubsAndWalksContextBase : DbContext
+    {
+        protected PubsAndWalksContextBase(bool useSqlite = false)
+        {
+            UseSqlite = useSqlite;
+        }
+
+        public bool UseSqlite { get; }
+        public bool LoggingEnabled { get; set; }
+
+        public DbSet<DogWalk> Walks => Set<DogWalk>();
+        public DbSet<Pub> Pubs => Set<Pub>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => (UseSqlite
+                    ? optionsBuilder.UseSqlite(@$"DataSource={GetType().Name}.db")
+                    // Note that SQL Server 2022 is required.
+                    : optionsBuilder.UseSqlServer(@$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0"))
+                .EnableSensitiveDataLogging()
+                .LogTo(
+                    s =>
+                    {
+                        if (LoggingEnabled)
+                        {
+                            Console.WriteLine(s);
+                        }
+                    }, LogLevel.Information);
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder
+                .Entity<PrimitiveCollections>()
+                .Property(e => e.Booleans)
+                .HasMaxLength(1024)
+                .IsUnicode(false);
+
+            modelBuilder
+                .Entity<PrimitiveCollections>()
+                .Property(e => e.GetOnlyInts);
+
+            modelBuilder
+                .Entity<PrimitiveCollections>()
+                .Property<List<int>>("_intsField");
+        }
+
+        protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+        {
+            configurationBuilder
+                .Properties<List<DateOnly>>()
+                .AreUnicode(false)
+                .HaveMaxLength(4000);
+
+            configurationBuilder
+                .Properties<string[]>()
+                .HaveMaxLength(2000);
+        }
+
+        public async Task Seed()
+        {
+            Add(
+                new PrimitiveCollections
+                {
+                    Ints = new[] { 1, 2, 3 },
+                    Strings = new List<string> { "One", "Two", "Three" },
+                    DateTimes = new Collection<DateTime> { new(2023, 1, 1, 1, 1, 1), new(2023, 2, 2, 2, 2, 2), new(2023, 3, 3, 3, 3, 3) },
+                    Dates = new List<DateOnly> { new(2023, 1, 1), new(2023, 2, 2), new(2023, 3, 3) },
+                    UnsignedInts = new uint[] { 1, 2, 3 },
+                    Guids = new() { Guid.NewGuid(), Guid.NewGuid(), Guid.NewGuid() },
+                    Booleans = new() { true, false, true },
+                    Urls = new() { new("https://127.0.0.1/"), new("http://192.168.0.1/"), new("https://devblogs.microsoft.com/dotnet/") },
+                });
+
+            var oak = new Pub("The Royal Oak", new[] { "Oakham", "Carling", "Guinness", "John Smiths", "Bathams", "Tennents" })
+            {
+                DaysVisited =
+                {
+                    new(2021, 1, 2),
+                    new(2021, 8, 7),
+                    new(2023, 3, 22),
+                    new(2022, 4, 22),
+                    new(2022, 7, 21),
+                    new(2022, 6, 21),
+                }
+            };
+
+            var feathers = new Pub("The Prince of Wales Feathers", new[] { "Heineken", "John Smiths", "Stella Artois", "Carlsberg" })
+            {
+                DaysVisited =
+                {
+                    new(2022, 11, 17),
+                    new(2021, 9, 25),
+                    new(2022, 12, 21),
+                    new(2022, 11, 7),
+                    new(2022, 8, 9),
+                    new(2022, 3, 10),
+                    new(2021, 12, 1),
+                    new(2022, 3, 8),
+                    new(2022, 2, 28),
+                    new(2021, 5, 10),
+                    new(2021, 6, 25),
+                }
+            };
+
+            var swan = new Pub(
+                "The White Swan", new[] { "Oakham", "Carling", "Guinness", "Heineken", "Stella Artois", "Carlsberg", "Bathams" })
+            {
+                DaysVisited =
+                {
+                    new(2021, 2, 24),
+                    new(2022, 8, 3),
+                    new(2022, 9, 14),
+                    new(2022, 5, 5),
+                    new(2022, 7, 13),
+                    new(2021, 7, 18),
+                    new(2021, 7, 23),
+                }
+            };
+
+            var fbi = new Pub("Farr Bay Inn", new[] { "Guinness", "Heineken", "Carlsberg", "Bathams", "Tennents" })
+            {
+                DaysVisited =
+                {
+                    new(2022, 11, 30),
+                    new(2022, 2, 15),
+                    new(2021, 12, 9),
+                    new(2022, 8, 5),
+                    new(2021, 11, 19),
+                    new(2022, 12, 20),
+                    new(2021, 6, 5),
+                    new(2021, 2, 27),
+                    new(2021, 6, 17),
+                    new(2023, 3, 1),
+                    new(2021, 2, 23),
+                    new(2021, 9, 6),
+                    new(2023, 2, 22),
+                    new(2022, 1, 25),
+                }
+            };
+
+            var eltisley = new Pub(
+                "The Eltisley",
+                new[] { "Oakham", "Carling", "Guinness", "Heineken", "John Smiths", "Stella Artois", "Carlsberg", "Bathams", "Tennents" })
+            {
+                DaysVisited =
+                {
+                    new(2022, 6, 19),
+                    new(2021, 1, 15),
+                    new(2022, 3, 24),
+                    new(2023, 2, 26),
+                    new(2021, 1, 11),
+                    new(2022, 3, 19),
+                }
+            };
+
+            await AddRangeAsync(
+                new DogWalk("Ailsworth to Nene")
+                {
+                    ClosestPub = feathers,
+                    Terrain = Terrain.River,
+                    DaysVisited =
+                    {
+                        new(2022, 11, 17),
+                        new(2021, 9, 25),
+                        new(2022, 12, 21),
+                        new(2022, 11, 7),
+                        new(2022, 8, 9),
+                        new(2021, 7, 21),
+                        new(2022, 1, 15),
+                        new(2022, 9, 29),
+                    }
+                },
+                new DogWalk("Caster Hanglands")
+                {
+                    ClosestPub = feathers,
+                    Terrain = Terrain.Forest,
+                    DaysVisited =
+                    {
+                        new(2022, 3, 10),
+                        new(2021, 6, 5),
+                        new(2021, 12, 1),
+                        new(2022, 3, 8),
+                        new(2022, 6, 10),
+                        new(2022, 11, 13),
+                        new(2022, 2, 28),
+                        new(2021, 5, 10),
+                        new(2021, 6, 25),
+                    }
+                },
+                new DogWalk("Ferry Meadows")
+                {
+                    ClosestPub = oak,
+                    Terrain = Terrain.Park,
+                    DaysVisited =
+                    {
+                        new(2021, 1, 2),
+                        new(2021, 8, 7),
+                        new(2023, 3, 22),
+                        new(2021, 4, 25),
+                        new(2022, 6, 9),
+                        new(2022, 4, 22),
+                        new(2022, 7, 21),
+                        new(2022, 6, 21),
+                    }
+                },
+                new DogWalk("Woodnewton")
+                {
+                    ClosestPub = swan,
+                    Terrain = Terrain.Village,
+                    DaysVisited =
+                    {
+                        new(2021, 2, 24),
+                        new(2023, 4, 4),
+                        new(2021, 2, 19),
+                        new(2022, 8, 3),
+                        new(2022, 9, 14),
+                        new(2022, 5, 5),
+                        new(2022, 7, 13),
+                        new(2021, 7, 18),
+                        new(2021, 7, 23),
+                    }
+                },
+                new DogWalk("Eltisley")
+                {
+                    ClosestPub = eltisley,
+                    Terrain = Terrain.Village,
+                    DaysVisited =
+                    {
+                        new(2022, 6, 19),
+                        new(2021, 1, 15),
+                        new(2021, 9, 29),
+                        new(2022, 3, 24),
+                        new(2023, 3, 2),
+                        new(2023, 2, 26),
+                        new(2021, 1, 11),
+                        new(2022, 3, 19),
+                    }
+                },
+                new DogWalk("Farr Beach")
+                {
+                    ClosestPub = fbi,
+                    Terrain = Terrain.Beach,
+                    DaysVisited =
+                    {
+                        new(2022, 11, 30),
+                        new(2021, 10, 28),
+                        new(2022, 2, 15),
+                        new(2021, 12, 9),
+                        new(2022, 5, 22),
+                        new(2022, 8, 5),
+                        new(2021, 11, 19),
+                        new(2022, 7, 29),
+                        new(2022, 12, 20),
+                        new(2021, 6, 5),
+                        new(2021, 6, 25),
+                    }
+                },
+                new DogWalk("Newlands")
+                {
+                    ClosestPub = fbi,
+                    Terrain = Terrain.Hills,
+                    DaysVisited =
+                    {
+                        new(2021, 2, 27),
+                        new(2021, 6, 17),
+                        new(2021, 8, 6),
+                        new(2023, 3, 1),
+                        new(2021, 2, 23),
+                        new(2022, 3, 17),
+                        new(2021, 9, 6),
+                        new(2023, 2, 22),
+                        new(2022, 1, 25),
+                    }
+                });
+
+            await SaveChangesAsync();
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore9/ModelBuildingSample.cs b/samples/core/Miscellaneous/NewInEFCore9/ModelBuildingSample.cs
new file mode 100644
index 0000000000..5555917b6a
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore9/ModelBuildingSample.cs
@@ -0,0 +1,76 @@
+namespace NewInEfCore9;
+
+public static class ModelBuildingSample
+{
+    public static async Task Model_building_improvements_in_EF9()
+    {
+        PrintSampleName();
+
+        await using var context = new ModelBuildingContext();
+        await context.Database.EnsureDeletedAsync();
+
+        context.LoggingEnabled = true;
+
+        await context.Database.EnsureCreatedAsync();
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public class ModelBuildingContext : DbContext
+    {
+        public bool LoggingEnabled { get; set; }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder.UseSqlServer(@$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0")
+                .EnableSensitiveDataLogging()
+                .LogTo(
+                    s =>
+                    {
+                        if (LoggingEnabled)
+                        {
+                            Console.WriteLine(s);
+                        }
+                    }, LogLevel.Information);
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region FillFactor
+            modelBuilder.Entity<User>()
+                .HasKey(e => e.Id)
+                .HasFillFactor(80);
+
+            modelBuilder.Entity<User>()
+                .HasAlternateKey(e => new { e.Region, e.Ssn })
+                .HasFillFactor(80);
+
+            modelBuilder.Entity<User>()
+                .HasIndex(e => new { e.Name })
+                .HasFillFactor(80);
+
+            modelBuilder.Entity<User>()
+                .HasIndex(e => new { e.Region, e.Tag })
+                .HasFillFactor(80);
+            #endregion
+
+            #region DefaultCache
+            modelBuilder.HasSequence<int>("MySequence")
+                .HasMin(10).HasMax(255000)
+                .IsCyclic()
+                .StartsAt(11).IncrementsBy(2);
+            #endregion
+        }
+    }
+
+    public class User
+    {
+        public int Id { get; set; }
+        public required string Region { get; set; }
+        public required string Name { get; set; }
+        public string? Ssn { get; set; }
+        public string? Tag { get; set; }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore9/NewInEFCore9.csproj b/samples/core/Miscellaneous/NewInEFCore9/NewInEFCore9.csproj
new file mode 100644
index 0000000000..1c22a5563e
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore9/NewInEFCore9.csproj
@@ -0,0 +1,38 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net9.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <RootNamespace>NewInEfCore9</RootNamespace>
+    <LangVersion>Preview</LangVersion>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Cosmos" Version="9.0.11" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="9.0.11" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="9.0.11" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="9.0.11" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer.NetTopologySuite" Version="9.0.11" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer.HierarchyId" Version="9.0.11" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite.NetTopologySuite" Version="9.0.11" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.InMemory" Version="9.0.11" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Proxies" Version="9.0.11" />
+    <PackageReference Include="Microsoft.Extensions.Logging.Console" Version="9.0.11" />
+    <PackageReference Include="System.Interactive.Async" Version="6.0.1" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <Using Include="System.ComponentModel.DataAnnotations" />
+    <Using Include="System.ComponentModel.DataAnnotations.Schema" />
+    <Using Include="System.Data.Common" />
+    <Using Include="System.Linq.Expressions" />
+    <Using Include="System.Reflection" />
+    <Using Include="System.Runtime.CompilerServices" />
+    <Using Include="Microsoft.EntityFrameworkCore" />
+    <Using Include="Microsoft.Extensions.Logging" />
+    <Using Include="Microsoft.Extensions.DependencyInjection" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/NewInEFCore9/NullSemanticsSample.cs b/samples/core/Miscellaneous/NewInEFCore9/NullSemanticsSample.cs
new file mode 100644
index 0000000000..69225c523c
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore9/NullSemanticsSample.cs
@@ -0,0 +1,156 @@
+namespace NewInEfCore9;
+
+public static class NullSemanticsSample
+{
+    public static Task Null_semantics_improvements_in_EF9()
+    {
+        PrintSampleName();
+        return NullSemanticsInComparisonTest<NullSemanticsContext>();
+    }
+
+    public static Task Null_semantics_improvements_in_EF9_on_SQLite()
+    {
+        PrintSampleName();
+        return NullSemanticsInComparisonTest<NullSemanticsContextSqlite>();
+    }
+
+    private static async Task NullSemanticsInComparisonTest<TContext>()
+        where TContext : NullSemanticsContextBase, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.LoggingEnabled = true;
+        context.ChangeTracker.Clear();
+
+        Console.WriteLine();
+        Console.WriteLine("C# null semantics for comparison operators:");
+        Console.WriteLine();
+
+        #region NegatedNullableComparisonFilter
+        var negatedNullableComparisonFilter = await context.Entities
+            .Where(x => !(x.NullableIntOne > x.NullableIntTwo))
+            .Select(x => new { x.NullableIntOne, x.NullableIntTwo }).ToListAsync();
+        #endregion
+
+        var negatedNullableComparisonFilterL2O = await context.Entities.AsAsyncEnumerable().Where(x => !(x.NullableIntOne > x.NullableIntTwo)).Select(x => new { x.NullableIntOne, x.NullableIntTwo }).ToListAsync();
+
+        #region NullableComparisonProjection
+        var nullableComparisonProjection = await context.Entities.Select(x => new
+        {
+            x.NullableIntOne,
+            x.NullableIntTwo,
+            Operation = x.NullableIntOne > x.NullableIntTwo
+        }).ToListAsync();
+        #endregion
+
+        var nullableComparisonProjectionL2O = await context.Entities.AsAsyncEnumerable().Select(x => new { x.NullableIntOne, x.NullableIntTwo, Operation = x.NullableIntOne > x.NullableIntTwo }).ToListAsync();
+
+        #region NegatedNullableComparisonProjection
+        var negatedNullableComparisonProjection = await context.Entities.Select(x => new
+        {
+            x.NullableIntOne,
+            x.NullableIntTwo,
+            Operation = !(x.NullableIntOne > x.NullableIntTwo)
+        }).ToListAsync();
+        #endregion
+
+        var negatedNullableComparisonProjectionL2O = await context.Entities.AsAsyncEnumerable().Select(x => new { x.NullableIntOne, x.NullableIntTwo, Operation = !(x.NullableIntOne > x.NullableIntTwo) }).ToListAsync();
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public class NullSemanticsEntity
+    {
+        public int Id { get; set; }
+
+        public int? NullableIntOne { get; set; }
+        public int? NullableIntTwo { get; set; }
+        public bool? NullableBoolOne { get; set; }
+        public bool? NullableBoolTwo { get; set; }
+
+        public int Int { get; set; }
+        public bool BoolOne { get; set;}
+        public bool BoolTwo { get; set; }
+
+    }
+
+    public class NullSemanticsContext : NullSemanticsContextBase
+    {
+    }
+
+    public class NullSemanticsContextSqlite : NullSemanticsContextBase
+    {
+        public NullSemanticsContextSqlite()
+            : base(useSqlite: true)
+        {
+        }
+    }
+
+    public abstract class NullSemanticsContextBase : DbContext
+    {
+        protected NullSemanticsContextBase(bool useSqlite = false)
+        {
+            UseSqlite = useSqlite;
+        }
+
+        public bool UseSqlite { get; }
+        public bool LoggingEnabled { get; set; }
+
+        public DbSet<NullSemanticsEntity> Entities => Set<NullSemanticsEntity>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => (UseSqlite
+                    ? optionsBuilder.UseSqlite(@$"DataSource={GetType().Name}.db")
+                    : optionsBuilder.UseSqlServer(@$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0"))
+                .EnableSensitiveDataLogging()
+                .LogTo(
+                    s =>
+                    {
+                        if (LoggingEnabled)
+                        {
+                            Console.WriteLine(s);
+                        }
+                    }, LogLevel.Information);
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<NullSemanticsEntity>().Property(x => x.Id).ValueGeneratedNever();
+        }
+
+        public async Task Seed()
+        {
+            var entities = new List<NullSemanticsEntity>();
+            (int? Int, bool? Bool)[] data = [ (1, true), (2, false), (null, null) ];
+
+            var k = 0;
+            for (var i = 0; i < data.Length; i++)
+            {
+                for (var j = 0; j < data.Length; j++)
+                {
+                    k++;
+                    entities.Add(new NullSemanticsEntity
+                    {
+                        Id = k,
+                        NullableBoolOne = data[i].Bool,
+                        NullableBoolTwo = data[j].Bool,
+                        NullableIntOne = data[i].Int,
+                        NullableIntTwo = data[j].Int,
+                        BoolOne = data[k % 2].Bool!.Value,
+                        BoolTwo = data[(k + 1) % 2].Bool!.Value,
+                        Int = data[k % 2].Int!.Value,
+                    });
+                }
+            }
+
+            await AddRangeAsync(entities);
+            await SaveChangesAsync();
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore9/PrimitiveCollectionsSample.cs b/samples/core/Miscellaneous/NewInEFCore9/PrimitiveCollectionsSample.cs
new file mode 100644
index 0000000000..1667738a16
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore9/PrimitiveCollectionsSample.cs
@@ -0,0 +1,509 @@
+using System.Collections;
+using System.Collections.ObjectModel;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+namespace NewInEfCore9;
+
+public static class PrimitiveCollectionsSample
+{
+    public static Task Queries_using_readonly_primitive_collections()
+    {
+        PrintSampleName();
+        return ContainsTest<PubsAndWalksContext>();
+    }
+
+    public static Task Queries_using_readonly_primitive_collections_SQLite()
+    {
+        PrintSampleName();
+        return ContainsTest<PubsAndWalksContextSqlite>();
+    }
+
+    private static async Task ContainsTest<TContext>()
+        where TContext : PubsAndWalksContextBase, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.LoggingEnabled = true;
+        context.ChangeTracker.Clear();
+
+        var terrains = new[] { Terrain.River, Terrain.Beach, Terrain.Park };
+        var walksWithTerrain = await context.Walks
+            .Where(e => terrains.Contains(e.Terrain))
+            .Select(e => e.Name)
+            .ToListAsync();
+
+        Console.WriteLine($"\nWalks with given terrain are {string.Join(", ", walksWithTerrain.Select(w => $"\"{w}\""))}");
+
+        var beer = "Heineken";
+        var pubsWithHeineken = await context.Pubs
+            .Where(e => e.Beers.Contains(beer))
+            .Select(e => e.Name)
+            .ToListAsync();
+
+        Console.WriteLine($"\nPubs with {beer} are {string.Join(", ", pubsWithHeineken)}");
+
+        var beers = new[] { "Carling", "Heineken", "Stella Artois", "Carlsberg" };
+        var pubsWithLager = await context.Pubs
+            .Where(e => beers.Any(b => e.Beers.Contains(b)))
+            .Select(e => e.Name)
+            .ToListAsync();
+
+        Console.WriteLine($"\nPubs with lager are {string.Join(", ", pubsWithLager)}");
+
+        var thisYear = DateTime.Now.Year;
+        var pubsVisitedThisYear = await context.Pubs
+            .Where(e => e.DaysVisited.Any(v => v.Year == thisYear))
+            .Select(e => e.Name)
+            .ToListAsync();
+
+        Console.WriteLine($"\nPubs visited this year are {string.Join(", ", pubsVisitedThisYear)}");
+
+        var pubsVisitedInOrder = await context.Pubs
+            .Select(
+                e => new
+                {
+                    e.Name,
+                    FirstVisited = e.DaysVisited.OrderBy(v => v).First(),
+                    LastVisited = e.DaysVisited.OrderByDescending(v => v).First(),
+                })
+            .OrderBy(p => p.FirstVisited)
+            .ToListAsync();
+
+        foreach (var pub in pubsVisitedInOrder)
+        {
+            Console.WriteLine($"{pub.Name} first visited on {pub.FirstVisited} and last visited on {pub.LastVisited}");
+        }
+
+        #region WalksWithADrink
+        var walksWithADrink = await context.Walks.Select(
+            w => new
+            {
+                WalkName = w.Name,
+                PubName = w.ClosestPub.Name,
+                Count = w.DaysVisited.Count(v => w.ClosestPub.DaysVisited.Contains(v)),
+                TotalCount = w.DaysVisited.Count
+            }).ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        foreach (var walk in walksWithADrink)
+        {
+            Console.WriteLine($"{walk.PubName} was visited {walk.Count} times in {walk.TotalCount} \"{walk.WalkName}\" walks.");
+        }
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+
+    public class MyCollection : IList<int>
+    {
+        private readonly List<int> _list = new();
+        public IEnumerator<int> GetEnumerator() => _list.GetEnumerator();
+        IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();
+        public void Add(int item) => _list.Add(item);
+        public void Clear() => _list.Clear();
+        public bool Contains(int item) => _list.Contains(item);
+        public void CopyTo(int[] array, int arrayIndex) => _list.CopyTo(array, arrayIndex);
+        public bool Remove(int item) => _list.Remove(item);
+        public int Count => _list.Count;
+        public bool IsReadOnly => ((ICollection<int>)_list).IsReadOnly;
+        public int IndexOf(int item) => _list.IndexOf(item);
+        public void Insert(int index, int item) => _list.Insert(index, item);
+        public void RemoveAt(int index) => _list.RemoveAt(index);
+
+        public int this[int index]
+        {
+            get => _list[index];
+            set => _list[index] = value;
+        }
+    }
+
+    public class PrimitiveCollections
+    {
+        public int Id { get; set; }
+        public IReadOnlyList<int> Ints { get; set; } = null!;
+        public IReadOnlyCollection<string> Strings { get; set; } = null!;
+        public ReadOnlyCollection<DateTime> DateTimes { get; set; } = null!;
+        public IList<DateOnly> Dates { get; set; } = null!;
+
+        [MaxLength(2500)]
+        [Unicode(false)]
+        public uint[] UnsignedInts { get; set; } = null!;
+
+        public ObservableCollection<Guid> Guids { get; set; } = null!;
+        public List<bool> Booleans { get; set; } = null!;
+        public List<Uri> Urls { get; set; } = null!;
+        public MyCollection SomeInts { get; set; } = null!;
+        public List<int> GetOnlyInts { get; } = new();
+
+        // ReSharper disable once CollectionNeverUpdated.Local
+        private readonly List<int> _intsField = new();
+
+        public List<DddId> DddIds { get; set; } = null!;
+    }
+
+    public readonly struct DddId
+    {
+        public DddId(int value)
+        {
+            Value = value;
+        }
+
+        public int Value { get; }
+    }
+
+    public class DddIdConverter : ValueConverter<DddId, int>
+    {
+        public DddIdConverter()
+            : base(v => v.Value, v => new DddId())
+        {
+        }
+    }
+
+    public class DogWalk
+    {
+        public DogWalk(string name)
+        {
+            Name = name;
+        }
+
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public Terrain Terrain { get; set; }
+        public required ReadOnlyCollection<DateOnly> DaysVisited { get; set; }
+        public Pub ClosestPub { get; set; } = null!;
+    }
+
+    public enum Terrain
+    {
+        Forest,
+        River,
+        Hills,
+        Village,
+        Park,
+        Beach,
+    }
+
+    public class Pub
+    {
+        public Pub(string name, IReadOnlyCollection<string> beers)
+        {
+            Name = name;
+            Beers = beers;
+        }
+
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public IReadOnlyCollection<string> Beers { get; set; }
+
+        private List<DateOnly> _daysVisited = new();
+        public IReadOnlyList<DateOnly> DaysVisited => _daysVisited;
+    }
+
+    public class PubsAndWalksContext : PubsAndWalksContextBase
+    {
+    }
+
+    public class PubsAndWalksContextSqlite : PubsAndWalksContextBase
+    {
+        public PubsAndWalksContextSqlite()
+            : base(useSqlite: true)
+        {
+        }
+    }
+
+    public abstract class PubsAndWalksContextBase : DbContext
+    {
+        protected PubsAndWalksContextBase(bool useSqlite = false)
+        {
+            UseSqlite = useSqlite;
+        }
+
+        public bool UseSqlite { get; }
+        public bool LoggingEnabled { get; set; }
+
+        public DbSet<DogWalk> Walks => Set<DogWalk>();
+        public DbSet<Pub> Pubs => Set<Pub>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => (UseSqlite
+                    ? optionsBuilder.UseSqlite(@$"DataSource={GetType().Name}.db")
+                    : optionsBuilder.UseSqlServer(
+                        @$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0"))
+                //sqlServerOptionsBuilder => sqlServerOptionsBuilder.UseCompatibilityLevel(120)))
+                .EnableSensitiveDataLogging()
+                .LogTo(
+                    s =>
+                    {
+                        if (LoggingEnabled)
+                        {
+                            Console.WriteLine(s);
+                        }
+                    }, LogLevel.Information);
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder
+                .Entity<PrimitiveCollections>()
+                .PrimitiveCollection(e => e.Booleans)
+                .HasMaxLength(1024)
+                .IsUnicode(false);
+
+            modelBuilder
+                .Entity<PrimitiveCollections>()
+                .PrimitiveCollection(e => e.Guids)
+                .HasColumnType("nvarchar(2000)");
+
+            modelBuilder
+                .Entity<PrimitiveCollections>()
+                .PrimitiveCollection(e => e.GetOnlyInts);
+
+            modelBuilder
+                .Entity<PrimitiveCollections>()
+                .PrimitiveCollection(e => e.DddIds)
+                .ElementType(b => b.HasConversion<DddIdConverter>());
+
+            modelBuilder
+                .Entity<PrimitiveCollections>()
+                .Property<List<int>>("_intsField");
+
+            modelBuilder.Entity<DogWalk>().Property(e => e.Terrain).HasConversion<string>();
+            modelBuilder.Entity<Pub>().PrimitiveCollection(e => e.DaysVisited);
+        }
+
+        protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+        {
+            configurationBuilder
+                .Properties<List<DateOnly>>()
+                .AreUnicode(false)
+                .HaveMaxLength(4000);
+
+            configurationBuilder
+                .Properties<string[]>()
+                .HaveMaxLength(2000);
+
+            configurationBuilder
+                .DefaultTypeMapping<DddId>()
+                .HasConversion<DddIdConverter>();
+        }
+
+        public async Task Seed()
+        {
+            Add(
+                new PrimitiveCollections
+                {
+                    Ints = new[] { 1, 2, 3 },
+                    Strings = new List<string> { "One", "Two", "Three" },
+                    DateTimes =
+                        new ReadOnlyCollection<DateTime>([new(2023, 1, 1, 1, 1, 1), new(2023, 2, 2, 2, 2, 2), new(2023, 3, 3, 3, 3, 3)]),
+                    Dates = new List<DateOnly> { new(2023, 1, 1), new(2023, 2, 2), new(2023, 3, 3) },
+                    UnsignedInts = new uint[] { 1, 2, 3 },
+                    Guids = new() { Guid.NewGuid(), Guid.NewGuid(), Guid.NewGuid() },
+                    Booleans = new() { true, false, true },
+                    Urls = new() { new("https://127.0.0.1/"), new("http://192.168.0.1/"), new("https://devblogs.microsoft.com/dotnet/") },
+                    SomeInts = new() { 1, 2, 3 },
+                    DddIds = new() { new(1), new(2), new(3) },
+                });
+
+            var oak = new Pub("The Royal Oak", new[] { "Oakham", "Carling", "Guinness", "John Smiths", "Bathams", "Tennents" });
+            ((List<DateOnly>)oak.DaysVisited).AddRange(
+            [
+                new(2021, 1, 2),
+                new(2021, 8, 7),
+                new(2023, 3, 22),
+                new(2022, 4, 22),
+                new(2022, 7, 21),
+                new(2022, 6, 21),
+            ]);
+
+            var feathers = new Pub("The Prince of Wales Feathers", new[] { "Heineken", "John Smiths", "Stella Artois", "Carlsberg" });
+            ((List<DateOnly>)feathers.DaysVisited).AddRange(
+            [
+                new(2022, 11, 17),
+                new(2021, 9, 25),
+                new(2022, 12, 21),
+                new(2022, 11, 7),
+                new(2022, 8, 9),
+                new(2022, 3, 10),
+                new(2021, 12, 1),
+                new(2022, 3, 8),
+                new(2022, 2, 28),
+                new(2021, 5, 10),
+                new(2021, 6, 25),
+            ]);
+
+            var swan = new Pub(
+                "The White Swan", new[] { "Oakham", "Carling", "Guinness", "Heineken", "Stella Artois", "Carlsberg", "Bathams" });
+            ((List<DateOnly>)swan.DaysVisited).AddRange(
+            [
+                new(2021, 2, 24),
+                new(2022, 8, 3),
+                new(2022, 9, 14),
+                new(2022, 5, 5),
+                new(2022, 7, 13),
+                new(2021, 7, 18),
+                new(2021, 7, 23),
+            ]);
+
+            var fbi = new Pub("Farr Bay Inn", new[] { "Guinness", "Heineken", "Carlsberg", "Bathams", "Tennents" });
+            ((List<DateOnly>)fbi.DaysVisited).AddRange(
+            [
+                new(2022, 11, 30),
+                new(2022, 2, 15),
+                new(2021, 12, 9),
+                new(2022, 8, 5),
+                new(2021, 11, 19),
+                new(2022, 12, 20),
+                new(2021, 6, 5),
+                new(2021, 2, 27),
+                new(2021, 6, 17),
+                new(2023, 3, 1),
+                new(2021, 2, 23),
+                new(2021, 9, 6),
+                new(2023, 2, 22),
+                new(2022, 1, 25),
+            ]);
+
+            var eltisley = new Pub(
+                "The Eltisley",
+                new[] { "Oakham", "Carling", "Guinness", "Heineken", "John Smiths", "Stella Artois", "Carlsberg", "Bathams", "Tennents" });
+            ((List<DateOnly>)eltisley.DaysVisited).AddRange(
+            [
+                new(2022, 6, 19),
+                new(2021, 1, 15),
+                new(2022, 3, 24),
+                new(2023, 2, 26),
+                new(2021, 1, 11),
+                new(2022, 3, 19),
+            ]);
+
+            await AddRangeAsync(
+                new DogWalk("Ailsworth to Nene")
+                {
+                    ClosestPub = feathers,
+                    Terrain = Terrain.River,
+                    DaysVisited = new ReadOnlyCollection<DateOnly>(
+                    [
+                        new(2022, 11, 17),
+                        new(2021, 9, 25),
+                        new(2022, 12, 21),
+                        new(2022, 11, 7),
+                        new(2022, 8, 9),
+                        new(2021, 7, 21),
+                        new(2022, 1, 15),
+                        new(2022, 9, 29),
+                    ])
+                },
+                new DogWalk("Caster Hanglands")
+                {
+                    ClosestPub = feathers,
+                    Terrain = Terrain.Forest,
+                    DaysVisited = new ReadOnlyCollection<DateOnly>(
+                    [
+                        new(2022, 3, 10),
+                        new(2021, 6, 5),
+                        new(2021, 12, 1),
+                        new(2022, 3, 8),
+                        new(2022, 6, 10),
+                        new(2022, 11, 13),
+                        new(2022, 2, 28),
+                        new(2021, 5, 10),
+                        new(2021, 6, 25),
+                    ])
+                },
+                new DogWalk("Ferry Meadows")
+                {
+                    ClosestPub = oak,
+                    Terrain = Terrain.Park,
+                    DaysVisited = new ReadOnlyCollection<DateOnly>(
+                    [
+                        new(2021, 1, 2),
+                        new(2021, 8, 7),
+                        new(2023, 3, 22),
+                        new(2021, 4, 25),
+                        new(2022, 6, 9),
+                        new(2022, 4, 22),
+                        new(2022, 7, 21),
+                        new(2022, 6, 21),
+                    ])
+                },
+                new DogWalk("Woodnewton")
+                {
+                    ClosestPub = swan,
+                    Terrain = Terrain.Village,
+                    DaysVisited = new ReadOnlyCollection<DateOnly>(
+                    [
+                        new(2021, 2, 24),
+                        new(2023, 4, 4),
+                        new(2021, 2, 19),
+                        new(2022, 8, 3),
+                        new(2022, 9, 14),
+                        new(2022, 5, 5),
+                        new(2022, 7, 13),
+                        new(2021, 7, 18),
+                        new(2021, 7, 23),
+                    ])
+                },
+                new DogWalk("Eltisley")
+                {
+                    ClosestPub = eltisley,
+                    Terrain = Terrain.Village,
+                    DaysVisited = new ReadOnlyCollection<DateOnly>(
+                    [
+                        new(2022, 6, 19),
+                        new(2021, 1, 15),
+                        new(2021, 9, 29),
+                        new(2022, 3, 24),
+                        new(2023, 3, 2),
+                        new(2023, 2, 26),
+                        new(2021, 1, 11),
+                        new(2022, 3, 19),
+                    ])
+                },
+                new DogWalk("Farr Beach")
+                {
+                    ClosestPub = fbi,
+                    Terrain = Terrain.Beach,
+                    DaysVisited = new ReadOnlyCollection<DateOnly>(
+                    [
+                        new(2022, 11, 30),
+                        new(2021, 10, 28),
+                        new(2022, 2, 15),
+                        new(2021, 12, 9),
+                        new(2022, 5, 22),
+                        new(2022, 8, 5),
+                        new(2021, 11, 19),
+                        new(2022, 7, 29),
+                        new(2022, 12, 20),
+                        new(2021, 6, 5),
+                        new(2021, 6, 25),
+                    ])
+                },
+                new DogWalk("Newlands")
+                {
+                    ClosestPub = fbi,
+                    Terrain = Terrain.Hills,
+                    DaysVisited = new ReadOnlyCollection<DateOnly>(
+                    [
+                        new(2021, 2, 27),
+                        new(2021, 6, 17),
+                        new(2021, 8, 6),
+                        new(2023, 3, 1),
+                        new(2021, 2, 23),
+                        new(2022, 3, 17),
+                        new(2021, 9, 6),
+                        new(2023, 2, 22),
+                        new(2022, 1, 25),
+                    ])
+                });
+
+            await SaveChangesAsync();
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore9/Program.cs b/samples/core/Miscellaneous/NewInEFCore9/Program.cs
new file mode 100644
index 0000000000..e677697b89
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore9/Program.cs
@@ -0,0 +1,39 @@
+using NewInEfCore9;
+
+public class Program
+{
+    public static async Task Main()
+    {
+        await PrimitiveCollectionsSample.Queries_using_readonly_primitive_collections();
+        await PrimitiveCollectionsSample.Queries_using_readonly_primitive_collections_SQLite();
+
+        await ComplexTypesSample.GropupBy_complex_type_instances();
+        await ComplexTypesSample.GropupBy_complex_type_instances_on_SQLite();
+
+        await QuerySample.Query_improvements_in_EF9();
+        await QuerySample.Query_improvements_in_EF9_on_SQLite();
+
+        // Note that SQL Server 2022 is required for Greater and Least queries.
+        // await LeastGreatestSample.Queries_using_Least_and_Greatest();
+        await LeastGreatestSample.Queries_using_Least_and_Greatest_on_SQLite();
+
+        await NullSemanticsSample.Null_semantics_improvements_in_EF9();
+        await NullSemanticsSample.Null_semantics_improvements_in_EF9_on_SQLite();
+
+        await CustomConventionsSample.Conventions_enhancements_in_EF9();
+
+        await JsonColumnsSample.Columns_from_JSON_are_pruned_when_needed();
+        await JsonColumnsSample.Columns_from_JSON_are_pruned_when_needed_on_SQLite();
+
+        await ExecuteUpdateSample.ExecuteUpdate_for_complex_type_instances();
+        await ExecuteUpdateSample.ExecuteUpdate_for_complex_type_instances_on_SQLite();
+
+        await HierarchyIdSample.SQL_Server_HierarchyId();
+
+        await ModelBuildingSample.Model_building_improvements_in_EF9();
+
+        await DateOnlyTimeOnlySample.Can_use_DateOnly_TimeOnly_on_SQLite();
+        await DateOnlyTimeOnlySample.Can_use_DateOnly_TimeOnly_on_SQL_Server();
+        await DateOnlyTimeOnlySample.Can_use_DateOnly_TimeOnly_on_SQL_Server_with_JSON();
+    }
+}
diff --git a/samples/core/Miscellaneous/NewInEFCore9/QuerySample.cs b/samples/core/Miscellaneous/NewInEFCore9/QuerySample.cs
new file mode 100644
index 0000000000..1c1ac72f24
--- /dev/null
+++ b/samples/core/Miscellaneous/NewInEFCore9/QuerySample.cs
@@ -0,0 +1,280 @@
+namespace NewInEfCore9;
+
+public static class QuerySample
+{
+    public static Task Query_improvements_in_EF9()
+    {
+        PrintSampleName();
+        return QueryTest<JsonBlogsContext>();
+    }
+
+    public static Task Query_improvements_in_EF9_on_SQLite()
+    {
+        PrintSampleName();
+        return QueryTest<JsonBlogsContextSqlite>();
+    }
+
+    private static async Task QueryTest<TContext>()
+        where TContext : BlogsContext, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+
+        context.LoggingEnabled = true;
+        context.ChangeTracker.Clear();
+
+        Console.WriteLine();
+        Console.WriteLine("Default parameterization:");
+        Console.WriteLine();
+
+        _ = await GetPosts(1);
+
+        #region DefaultParameterization
+        async Task<List<Post>> GetPosts(int id)
+            => await context.Posts
+                .Where(e => e.Title == ".NET Blog" && e.Id == id)
+                .ToListAsync();
+        #endregion
+
+        _ = await GetPostsPrimitiveCollection([1, 2, 3]);
+
+        #region DefaultParameterizationPrimitiveCollection
+        async Task<List<Post>> GetPostsPrimitiveCollection(int[] ids)
+            => await context.Posts
+                .Where(e => e.Title == ".NET Blog" && ids.Contains(e.Id))
+                .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine("Force parameterization of a constant:");
+        Console.WriteLine();
+
+        _ = await GetPostsForceParameter(1);
+
+        #region ForceParameter
+        async Task<List<Post>> GetPostsForceParameter(int id)
+            => await context.Posts
+                .Where(e => e.Title == EF.Parameter(".NET Blog") && e.Id == id)
+                .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine("Force constant:");
+        Console.WriteLine();
+
+        _ = await GetPostsForceConstant(1);
+
+        #region ForceConstant
+        async Task<List<Post>> GetPostsForceConstant(int id)
+            => await context.Posts
+                .Where(e => e.Title == ".NET Blog" && e.Id == EF.Constant(id))
+                .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine("Force constant primitive collection:");
+        Console.WriteLine();
+
+        _ = await GetPostsForceConstantCollection([1, 2, 3]);
+
+        #region ForceConstantPrimitiveCollection
+        async Task<List<Post>> GetPostsForceConstantCollection(int[] ids)
+            => await context.Posts
+                .Where(
+                    e => e.Title == ".NET Blog" && EF.Constant(ids).Contains(e.Id))
+                .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine("Inline subquery:");
+        Console.WriteLine();
+
+        #region InlinedSubquery
+        var dotnetPosts = context
+            .Posts
+            .Where(p => p.Title.Contains(".NET"));
+
+        var results = await dotnetPosts
+            .Where(p => p.Id > 2)
+            .Select(p => new { Post = p, TotalCount = dotnetPosts.Count() })
+            .Skip(2).Take(10)
+            .ToArrayAsync();
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine("ToHashSetAsync:");
+        Console.WriteLine();
+
+        #region ToHashSetAsync
+        var set1 = await context.Posts
+            .Where(p => p.Tags.Count > 3)
+            .ToHashSetAsync();
+
+        var set2 = await context.Posts
+            .Where(p => p.Tags.Count > 3)
+            .ToHashSetAsync(ReferenceEqualityComparer.Instance);
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine("Normalize Count != 0:");
+        Console.WriteLine();
+
+        #region NormalizeCount
+        var blogsWithPost = await context.Blogs
+            .Where(b => b.Posts.Count > 0)
+            .ToListAsync();
+        #endregion
+
+        if (!context.UseSqlite)
+        {
+            #region PatIndexExample
+            var patIndexExample = await context.Posts.Select(p => new
+            {
+                p.Id,
+                Index = EF.Functions.PatIndex("%.NET%", p.Content)
+            }).ToListAsync();
+            #endregion
+        }
+
+        Console.WriteLine();
+        Console.WriteLine("Case translation improvements:");
+        Console.WriteLine();
+
+        #region CaseTranslationImprovements
+        var caseSimplification = await context.Blogs
+            .Select(b => !(b.Id > 5 ? false : true))
+            .ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine("Negated bool improvements:");
+        Console.WriteLine();
+
+        if (context.UseSqlite)
+        {
+            #region NegatedContainsImprovements
+            var negatedContainsSimplification = await context.Posts
+                .Where(p => !p.Content.Contains("Announcing"))
+                .Select(p => new { p.Content }).ToListAsync();
+            #endregion
+        }
+
+        #region NegatedBoolProjection
+        var negatedBoolProjection = await context.Posts.Select(x => new { x.Title, Active = !x.Archived }).ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine("Enum to string translation:");
+        Console.WriteLine();
+
+        #region EnumToString
+        var englishAndSpanishBlogs = await context.Blogs
+            .Where(x => x.Language.ToString().EndsWith("ish"))
+            .Select(x => x.Name).ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine("Average on decimal:");
+        Console.WriteLine();
+
+        #region AverageOnDecimal
+        var averagePostRating = await context.Blogs.Select(x => new
+        {
+            x.Name,
+            AveragePostRating = x.Posts.Average(xx => xx.Rating)
+        }).ToListAsync();
+        #endregion
+
+        Console.WriteLine();
+        Console.WriteLine("Convert from object:");
+        Console.WriteLine();
+
+        if (!context.UseSqlite)
+        {
+            #region ConvertFromObject
+            var blogWithConversion = await context.Blogs
+            .Where(x => Convert.ToDecimal((object)Convert.ToString(x.Id)) == 1.0M)
+            .ToListAsync();
+            #endregion
+        }
+
+        Console.WriteLine();
+        Console.WriteLine("Xor support:");
+        Console.WriteLine();
+
+        if (!context.UseSqlite)
+        {
+            #region XorSupport
+            var xorSupportBool = await context.Posts.CountAsync(x => x.Archived ^ (x.Rating > 3.5M));
+            var xorSupportInt = await context.Posts.Where(x => (x.Id ^ 7) > 10).ToListAsync();
+            #endregion
+        }
+
+        Console.WriteLine();
+        Console.WriteLine("Aggregate over subquery/aggregate:");
+        Console.WriteLine();
+        #region AggregateOverSubquery
+        var latestPostsAverageRatingByLanguage = await context.Blogs
+            .Select(x => new
+            {
+                x.Language,
+                LatestPostRating = x.Posts.OrderByDescending(xx => xx.PublishedOn).FirstOrDefault()!.Rating
+            })
+            .GroupBy(x => x.Language)
+            .Select(x => x.Average(xx => xx.LatestPostRating))
+            .ToListAsync();
+        #endregion
+
+        // Max over decimal is not supported on Sqlite
+        if (!context.UseSqlite)
+        {
+            #region AggregateOverAggregate
+            var topRatedPostsAverageRatingByLanguage = await context.Blogs.
+            Select(x => new
+            {
+                x.Language,
+                TopRating = x.Posts.Max(x => x.Rating)
+            })
+            .GroupBy(x => x.Language)
+            .Select(x => x.Average(xx => xx.TopRating))
+            .ToListAsync();
+            #endregion
+        }
+
+        Console.WriteLine();
+        Console.WriteLine("Order and OrderDescending:");
+        Console.WriteLine();
+
+        #region OrderOrderDescending
+        var orderOperation = await context.Blogs
+            .Order()
+            .Select(x => new
+            {
+                x.Name,
+                OrderedPosts = x.Posts.OrderDescending().ToList(),
+                OrderedTitles = x.Posts.Select(xx => xx.Title).Order().ToList()
+            })
+            .ToListAsync();
+        #endregion
+
+        #region OrderByEquivalent
+        var orderByEquivalent = await context.Blogs
+            .OrderBy(x => x.Id)
+            .Select(x => new
+            {
+                x.Name,
+                OrderedPosts = x.Posts.OrderByDescending(xx => xx.Id).ToList(),
+                OrderedTitles = x.Posts.Select(xx => xx.Title).OrderBy(xx => xx).ToList()
+            })
+            .ToListAsync();
+        #endregion
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+}
diff --git a/samples/core/Miscellaneous/NullableReferenceTypes/Address.cs b/samples/core/Miscellaneous/NullableReferenceTypes/Address.cs
new file mode 100644
index 0000000000..de42867e91
--- /dev/null
+++ b/samples/core/Miscellaneous/NullableReferenceTypes/Address.cs
@@ -0,0 +1,17 @@
+namespace NullableReferenceTypes
+{
+    #region OrderDetails
+    public class Address
+    {
+        public int Id { get; set; }
+        public string City { get; set; }
+        public string Street { get; set; }
+
+        public Address(string city, string street)
+        {
+            City = city;
+            Street = street;
+        }
+    }
+    #endregion
+}
diff --git a/samples/core/Miscellaneous/NullableReferenceTypes/Customer.cs b/samples/core/Miscellaneous/NullableReferenceTypes/Customer.cs
new file mode 100644
index 0000000000..3263e4c116
--- /dev/null
+++ b/samples/core/Miscellaneous/NullableReferenceTypes/Customer.cs
@@ -0,0 +1,21 @@
+namespace NullableReferenceTypes
+{
+    #region Customer
+    public class Customer
+    {
+        public int Id { get; set; }
+        public string FirstName { get; set; } // Required by convention
+        public string LastName { get; set; } // Required by convention
+        public string? MiddleName { get; set; } // Optional by convention
+
+        // Note the following use of constructor binding, which avoids compiled warnings
+        // for uninitialized non-nullable properties.
+        public Customer(string firstName, string lastName, string? middleName = null)
+        {
+            FirstName = firstName;
+            LastName = lastName;
+            MiddleName = middleName;
+        }
+    }
+    #endregion
+}
diff --git a/samples/core/Miscellaneous/NullableReferenceTypes/CustomerWithConstructorBinding.cs b/samples/core/Miscellaneous/NullableReferenceTypes/CustomerWithConstructorBinding.cs
new file mode 100644
index 0000000000..da54e2065c
--- /dev/null
+++ b/samples/core/Miscellaneous/NullableReferenceTypes/CustomerWithConstructorBinding.cs
@@ -0,0 +1,15 @@
+namespace NullableReferenceTypes
+{
+    #region CustomerWithConstructorBinding
+    public class CustomerWithConstructorBinding
+    {
+        public int Id { get; set; }
+        public string Name { get; set; }
+
+        public CustomerWithConstructorBinding(string name)
+        {
+            Name = name;
+        }
+    }
+    #endregion
+}
diff --git a/samples/core/Miscellaneous/NullableReferenceTypes/CustomerWithoutNullableReferenceTypes.cs b/samples/core/Miscellaneous/NullableReferenceTypes/CustomerWithoutNullableReferenceTypes.cs
new file mode 100644
index 0000000000..57aa61f096
--- /dev/null
+++ b/samples/core/Miscellaneous/NullableReferenceTypes/CustomerWithoutNullableReferenceTypes.cs
@@ -0,0 +1,21 @@
+using System.ComponentModel.DataAnnotations;
+
+#nullable disable
+
+namespace NullableReferenceTypes
+{
+    #region Customer
+    public class CustomerWithoutNullableReferenceTypes
+    {
+        public int Id { get; set; }
+
+        [Required] // Data annotations needed to configure as required
+        public string FirstName { get; set; }
+
+        [Required] // Data annotations needed to configure as required
+        public string LastName { get; set; }
+
+        public string MiddleName { get; set; } // Optional by convention
+    }
+    #endregion
+}
diff --git a/samples/core/Miscellaneous/NullableReferenceTypes/ExtraOptionalOrderInfo.cs b/samples/core/Miscellaneous/NullableReferenceTypes/ExtraOptionalOrderInfo.cs
new file mode 100644
index 0000000000..c35879752c
--- /dev/null
+++ b/samples/core/Miscellaneous/NullableReferenceTypes/ExtraOptionalOrderInfo.cs
@@ -0,0 +1,13 @@
+namespace NullableReferenceTypes
+{
+    public class ExtraOptionalOrderInfo
+    {
+        public int Id { get; set; }
+        public string SomeExtraAdditionalInfo { get; set; }
+
+        public ExtraOptionalOrderInfo(string someExtraAdditionalInfo)
+        {
+            SomeExtraAdditionalInfo = someExtraAdditionalInfo;
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NullableReferenceTypes/NullableReferenceTypes.csproj b/samples/core/Miscellaneous/NullableReferenceTypes/NullableReferenceTypes.csproj
new file mode 100644
index 0000000000..185af6ec77
--- /dev/null
+++ b/samples/core/Miscellaneous/NullableReferenceTypes/NullableReferenceTypes.csproj
@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <LangVersion>8.0</LangVersion>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Miscellaneous/NullableReferenceTypes/NullableReferenceTypesContext.cs b/samples/core/Miscellaneous/NullableReferenceTypes/NullableReferenceTypesContext.cs
new file mode 100644
index 0000000000..d38a0e7461
--- /dev/null
+++ b/samples/core/Miscellaneous/NullableReferenceTypes/NullableReferenceTypesContext.cs
@@ -0,0 +1,17 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace NullableReferenceTypes
+{
+    #region Context
+    public class NullableReferenceTypesContext : DbContext
+    {
+        public DbSet<Customer> Customers => Set<Customer>();
+        public DbSet<Order> Orders => Set<Order>();
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .UseSqlServer(
+                    @"Server=(localdb)\mssqllocaldb;Database=EFNullableReferenceTypes;Trusted_Connection=True;ConnectRetryCount=0");
+    }
+    #endregion
+}
diff --git a/samples/core/Miscellaneous/NullableReferenceTypes/OptionalOrderInfo.cs b/samples/core/Miscellaneous/NullableReferenceTypes/OptionalOrderInfo.cs
new file mode 100644
index 0000000000..803c2c5727
--- /dev/null
+++ b/samples/core/Miscellaneous/NullableReferenceTypes/OptionalOrderInfo.cs
@@ -0,0 +1,14 @@
+namespace NullableReferenceTypes
+{
+    public class OptionalOrderInfo
+    {
+        public int Id { get; set; }
+        public string AdditionalInfo { get; set; }
+        public ExtraOptionalOrderInfo? ExtraAdditionalInfo { get; set; }
+
+        public OptionalOrderInfo(string additionalInfo)
+        {
+            AdditionalInfo = additionalInfo;
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NullableReferenceTypes/Order.cs b/samples/core/Miscellaneous/NullableReferenceTypes/Order.cs
new file mode 100644
index 0000000000..6885fbe34c
--- /dev/null
+++ b/samples/core/Miscellaneous/NullableReferenceTypes/Order.cs
@@ -0,0 +1,24 @@
+using System;
+
+namespace NullableReferenceTypes
+{
+    #region Order
+    public class Order
+    {
+        public int Id { get; set; }
+
+        private Address? _shippingAddress;
+
+        public Address ShippingAddress
+        {
+            set => _shippingAddress = value;
+            get => _shippingAddress
+                   ?? throw new InvalidOperationException("Uninitialized property: " + nameof(ShippingAddress));
+        }
+
+        public Product Product { get; set; } = null!;
+
+        public OptionalOrderInfo? OptionalInfo { get; set; }
+    }
+    #endregion
+}
diff --git a/samples/core/Miscellaneous/NullableReferenceTypes/Product.cs b/samples/core/Miscellaneous/NullableReferenceTypes/Product.cs
new file mode 100644
index 0000000000..f12438a541
--- /dev/null
+++ b/samples/core/Miscellaneous/NullableReferenceTypes/Product.cs
@@ -0,0 +1,13 @@
+namespace NullableReferenceTypes
+{
+    public class Product
+    {
+        public int Id { get; set; }
+        public string Name { get; set; }
+
+        public Product(string name)
+        {
+            Name = name;
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/NullableReferenceTypes/Program.cs b/samples/core/Miscellaneous/NullableReferenceTypes/Program.cs
new file mode 100644
index 0000000000..cfd362f67a
--- /dev/null
+++ b/samples/core/Miscellaneous/NullableReferenceTypes/Program.cs
@@ -0,0 +1,52 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace NullableReferenceTypes
+{
+    public static class Program
+    {
+        private static async Task Main(string[] args)
+        {
+            using (var context = new NullableReferenceTypesContext())
+            {
+                await context.Database.EnsureDeletedAsync();
+                await context.Database.EnsureCreatedAsync();
+
+                context.Add(new Customer("John", "Doe"));
+
+                context.Add(
+                    new Order
+                    {
+                        ShippingAddress = new Address("London", "Downing"),
+                        Product = new Product("Cooking stove"),
+                        OptionalInfo = new OptionalOrderInfo("Some additional info")
+                        {
+                            ExtraAdditionalInfo = new ExtraOptionalOrderInfo("Some extra additional info")
+                        }
+                    });
+
+                await context.SaveChangesAsync();
+            }
+
+            using (var context = new NullableReferenceTypesContext())
+            {
+                var john = await context.Customers.FirstAsync(c => c.FirstName == "John");
+                Console.WriteLine("John's last name: " + john.LastName);
+
+                #region Including
+                var order = await context.Orders
+                    .Include(o => o.OptionalInfo!)
+                    .ThenInclude(op => op.ExtraAdditionalInfo)
+                    .SingleAsync();
+                #endregion
+
+                // The following would be a programming bug: we forgot to include ShippingAddress above. It would throw InvalidOperationException.
+                // Console.WriteLine(order.ShippingAddress.City);
+                // The following would be a programming bug: we forgot to include Product above; will throw NullReferenceException. It would throw NullReferenceException.
+                // Console.WriteLine(order.Product.Name);
+            }
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/SaveChangesInterception/AuditContext.cs b/samples/core/Miscellaneous/SaveChangesInterception/AuditContext.cs
new file mode 100644
index 0000000000..aef608ba1d
--- /dev/null
+++ b/samples/core/Miscellaneous/SaveChangesInterception/AuditContext.cs
@@ -0,0 +1,41 @@
+using System;
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+#region AuditContext
+public class AuditContext : DbContext
+{
+    private readonly string _connectionString;
+
+    public AuditContext(string connectionString)
+    {
+        _connectionString = connectionString;
+    }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.UseSqlite(_connectionString);
+
+    public DbSet<SaveChangesAudit> SaveChangesAudits { get; set; }
+}
+
+public class SaveChangesAudit
+{
+    public int Id { get; set; }
+    public Guid AuditId { get; set; }
+    public DateTime StartTime { get; set; }
+    public DateTime EndTime { get; set; }
+    public bool Succeeded { get; set; }
+    public string ErrorMessage { get; set; }
+
+    public ICollection<EntityAudit> Entities { get; } = new List<EntityAudit>();
+}
+
+public class EntityAudit
+{
+    public int Id { get; set; }
+    public EntityState State { get; set; }
+    public string AuditMessage { get; set; }
+
+    public SaveChangesAudit SaveChangesAudit { get; set; }
+}
+#endregion
diff --git a/samples/core/Miscellaneous/SaveChangesInterception/AuditingInterceptor.cs b/samples/core/Miscellaneous/SaveChangesInterception/AuditingInterceptor.cs
new file mode 100644
index 0000000000..f7c7c81267
--- /dev/null
+++ b/samples/core/Miscellaneous/SaveChangesInterception/AuditingInterceptor.cs
@@ -0,0 +1,149 @@
+using System;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.ChangeTracking;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+public class AuditingInterceptor : ISaveChangesInterceptor
+{
+    private readonly string _connectionString;
+    private SaveChangesAudit _audit;
+
+    public AuditingInterceptor(string connectionString)
+    {
+        _connectionString = connectionString;
+    }
+
+    #region SavingChanges
+    public async ValueTask<InterceptionResult<int>> SavingChangesAsync(
+        DbContextEventData eventData,
+        InterceptionResult<int> result,
+        CancellationToken cancellationToken = default)
+    {
+        _audit = CreateAudit(eventData.Context);
+
+        using var auditContext = new AuditContext(_connectionString);
+
+        auditContext.Add(_audit);
+        await auditContext.SaveChangesAsync();
+
+        return result;
+    }
+
+    public InterceptionResult<int> SavingChanges(
+        DbContextEventData eventData,
+        InterceptionResult<int> result)
+    {
+        _audit = CreateAudit(eventData.Context);
+
+        using var auditContext = new AuditContext(_connectionString);
+        auditContext.Add(_audit);
+        auditContext.SaveChanges();
+
+        return result;
+    }
+    #endregion
+
+    #region SavedChanges
+    public int SavedChanges(SaveChangesCompletedEventData eventData, int result)
+    {
+        using var auditContext = new AuditContext(_connectionString);
+
+        auditContext.Attach(_audit);
+        _audit.Succeeded = true;
+        _audit.EndTime = DateTime.UtcNow;
+
+        auditContext.SaveChanges();
+
+        return result;
+    }
+
+    public async ValueTask<int> SavedChangesAsync(
+        SaveChangesCompletedEventData eventData,
+        int result,
+        CancellationToken cancellationToken = default)
+    {
+        using var auditContext = new AuditContext(_connectionString);
+
+        auditContext.Attach(_audit);
+        _audit.Succeeded = true;
+        _audit.EndTime = DateTime.UtcNow;
+
+        await auditContext.SaveChangesAsync(cancellationToken);
+
+        return result;
+    }
+    #endregion
+
+    #region SaveChangesFailed
+    public void SaveChangesFailed(DbContextErrorEventData eventData)
+    {
+        using var auditContext = new AuditContext(_connectionString);
+
+        auditContext.Attach(_audit);
+        _audit.Succeeded = false;
+        _audit.EndTime = DateTime.UtcNow;
+        _audit.ErrorMessage = eventData.Exception.Message;
+
+        auditContext.SaveChanges();
+    }
+
+    public async Task SaveChangesFailedAsync(
+        DbContextErrorEventData eventData,
+        CancellationToken cancellationToken = default)
+    {
+        using var auditContext = new AuditContext(_connectionString);
+
+        auditContext.Attach(_audit);
+        _audit.Succeeded = false;
+        _audit.EndTime = DateTime.UtcNow;
+        _audit.ErrorMessage = eventData.Exception.InnerException?.Message;
+
+        await auditContext.SaveChangesAsync(cancellationToken);
+    }
+    #endregion
+
+    #region CreateAudit
+    private static SaveChangesAudit CreateAudit(DbContext context)
+    {
+        context.ChangeTracker.DetectChanges();
+
+        var audit = new SaveChangesAudit { AuditId = Guid.NewGuid(), StartTime = DateTime.UtcNow };
+
+        foreach (var entry in context.ChangeTracker.Entries())
+        {
+            var auditMessage = entry.State switch
+            {
+                EntityState.Deleted => CreateDeletedMessage(entry),
+                EntityState.Modified => CreateModifiedMessage(entry),
+                EntityState.Added => CreateAddedMessage(entry),
+                _ => null
+            };
+
+            if (auditMessage != null)
+            {
+                audit.Entities.Add(new EntityAudit { State = entry.State, AuditMessage = auditMessage });
+            }
+        }
+
+        return audit;
+
+        string CreateAddedMessage(EntityEntry entry)
+            => entry.Properties.Aggregate(
+                $"Inserting {entry.Metadata.DisplayName()} with ",
+                (auditString, property) => auditString + $"{property.Metadata.Name}: '{property.CurrentValue}' ");
+
+        string CreateModifiedMessage(EntityEntry entry)
+            => entry.Properties.Where(property => property.IsModified || property.Metadata.IsPrimaryKey()).Aggregate(
+                $"Updating {entry.Metadata.DisplayName()} with ",
+                (auditString, property) => auditString + $"{property.Metadata.Name}: '{property.CurrentValue}' ");
+
+        string CreateDeletedMessage(EntityEntry entry)
+            => entry.Properties.Where(property => property.Metadata.IsPrimaryKey()).Aggregate(
+                $"Deleting {entry.Metadata.DisplayName()} with ",
+                (auditString, property) => auditString + $"{property.Metadata.Name}: '{property.CurrentValue}' ");
+    }
+    #endregion
+}
diff --git a/samples/core/Miscellaneous/SaveChangesInterception/BlogsContext.cs b/samples/core/Miscellaneous/SaveChangesInterception/BlogsContext.cs
new file mode 100644
index 0000000000..692d85fefb
--- /dev/null
+++ b/samples/core/Miscellaneous/SaveChangesInterception/BlogsContext.cs
@@ -0,0 +1,32 @@
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+#region BlogsContext
+public class BlogsContext : DbContext
+{
+    private readonly AuditingInterceptor _auditingInterceptor = new AuditingInterceptor("DataSource=audit.db");
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .AddInterceptors(_auditingInterceptor)
+            .UseSqlite("DataSource=blogs.db");
+
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+public class Blog
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+
+    public ICollection<Post> Posts { get; } = new List<Post>();
+}
+
+public class Post
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+
+    public Blog Blog { get; set; }
+}
+#endregion
diff --git a/samples/core/Miscellaneous/SaveChangesInterception/Program.cs b/samples/core/Miscellaneous/SaveChangesInterception/Program.cs
new file mode 100644
index 0000000000..32bc224c8e
--- /dev/null
+++ b/samples/core/Miscellaneous/SaveChangesInterception/Program.cs
@@ -0,0 +1,86 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+public class Program
+{
+    public static async Task Main()
+    {
+        await CreateDatabases();
+
+        #region Program
+        // Insert, update, and delete some entities
+
+        using (var context = new BlogsContext())
+        {
+            context.Add(
+                new Blog { Name = "EF Blog", Posts = { new Post { Title = "EF Core 3.1!" }, new Post { Title = "EF Core 5.0!" } } });
+
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new BlogsContext())
+        {
+            var blog = await context.Blogs.Include(e => e.Posts).SingleAsync();
+
+            blog.Name = "EF Core Blog";
+            context.Remove(blog.Posts.First());
+            blog.Posts.Add(new Post { Title = "EF Core 6.0!" });
+
+            await context.SaveChangesAsync();
+        }
+
+        // Do an insert that will fail
+
+        using (var context = new BlogsContext())
+        {
+            try
+            {
+                context.Add(new Post { Id = 3, Title = "EF Core 3.1!" });
+
+                await context.SaveChangesAsync();
+            }
+            catch (DbUpdateException)
+            {
+            }
+        }
+
+        // Look at the audit trail
+
+        using (var context = new AuditContext("DataSource=audit.db"))
+        {
+            foreach (var audit in await context.SaveChangesAudits.Include(e => e.Entities).ToListAsync())
+            {
+                Console.WriteLine(
+                    $"Audit {audit.AuditId} from {audit.StartTime} to {audit.EndTime} was{(audit.Succeeded ? "" : " not")} successful.");
+
+                foreach (var entity in audit.Entities)
+                {
+                    Console.WriteLine($"  {entity.AuditMessage}");
+                }
+
+                if (!audit.Succeeded)
+                {
+                    Console.WriteLine($"  Error: {audit.ErrorMessage}");
+                }
+            }
+        }
+        #endregion
+    }
+
+    private static async Task CreateDatabases()
+    {
+        using (var context = new AuditContext("DataSource=audit.db"))
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        using (var context = new BlogsContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+    }
+}
diff --git a/samples/core/Miscellaneous/SaveChangesInterception/SaveChangesInterception.csproj b/samples/core/Miscellaneous/SaveChangesInterception/SaveChangesInterception.csproj
new file mode 100644
index 0000000000..21d10ca0ac
--- /dev/null
+++ b/samples/core/Miscellaneous/SaveChangesInterception/SaveChangesInterception.csproj
@@ -0,0 +1,13 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <TargetFramework>net10.0</TargetFramework>
+        <RootNamespace />
+    </PropertyGroup>
+
+    <ItemGroup>
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+    </ItemGroup>
+
+</Project>
diff --git a/samples/core/Modeling/BackingFields/BackingField.cs b/samples/core/Modeling/BackingFields/BackingField.cs
new file mode 100644
index 0000000000..33a9ace6d4
--- /dev/null
+++ b/samples/core/Modeling/BackingFields/BackingField.cs
@@ -0,0 +1,23 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.BackingFields.BackingField;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+#region Sample
+public class Blog
+{
+    private string _url;
+
+    public int BlogId { get; set; }
+
+    public string Url
+    {
+        get { return _url; }
+        set { _url = value; }
+    }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/BackingFields/BackingFields.csproj b/samples/core/Modeling/BackingFields/BackingFields.csproj
new file mode 100644
index 0000000000..51c96c436b
--- /dev/null
+++ b/samples/core/Modeling/BackingFields/BackingFields.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFModeling.BackingFields</RootNamespace>
+    <AssemblyName>EFModeling.BackingFields</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Modeling/BackingFields/DataAnnotations/BackingField.cs b/samples/core/Modeling/BackingFields/DataAnnotations/BackingField.cs
new file mode 100644
index 0000000000..39e78b9eff
--- /dev/null
+++ b/samples/core/Modeling/BackingFields/DataAnnotations/BackingField.cs
@@ -0,0 +1,30 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.BackingFields.DataAnnotations.BackingField;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+#region BackingField
+public class Blog
+{
+    private string _validatedUrl;
+
+    public int BlogId { get; set; }
+
+    [BackingField(nameof(_validatedUrl))]
+    public string Url
+    {
+        get { return _validatedUrl; }
+    }
+
+    public void SetUrl(string url)
+    {
+        // put your validation code here
+
+        _validatedUrl = url;
+    }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/BackingFields/FluentAPI/BackingField.cs b/samples/core/Modeling/BackingFields/FluentAPI/BackingField.cs
new file mode 100644
index 0000000000..326d6931a2
--- /dev/null
+++ b/samples/core/Modeling/BackingFields/FluentAPI/BackingField.cs
@@ -0,0 +1,36 @@
+using System.Net.Http;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.BackingFields.FluentAPI.BackingField;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region BackingField
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .Property(b => b.Url)
+            .HasField("_validatedUrl");
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+
+    public string Url { get; private set; }
+
+    public void SetUrl(string url)
+    {
+        using (var client = new HttpClient())
+        {
+            var response = client.GetAsync(url).Result;
+            response.EnsureSuccessStatusCode();
+        }
+
+        Url = url;
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/BackingFields/FluentAPI/BackingFieldAccessMode.cs b/samples/core/Modeling/BackingFields/FluentAPI/BackingFieldAccessMode.cs
new file mode 100644
index 0000000000..b1b6655234
--- /dev/null
+++ b/samples/core/Modeling/BackingFields/FluentAPI/BackingFieldAccessMode.cs
@@ -0,0 +1,37 @@
+using System.Net.Http;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.BackingFields.FluentAPI.BackingFieldAccessMode;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region BackingFieldAccessMode
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .Property(b => b.Url)
+            .HasField("_validatedUrl")
+            .UsePropertyAccessMode(PropertyAccessMode.PreferFieldDuringConstruction);
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+
+    public string Url { get; private set; }
+
+    public void SetUrl(string url)
+    {
+        using (var client = new HttpClient())
+        {
+            var response = client.GetAsync(url).Result;
+            response.EnsureSuccessStatusCode();
+        }
+
+        Url = url;
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/BackingFields/FluentAPI/BackingFieldNoProperty.cs b/samples/core/Modeling/BackingFields/FluentAPI/BackingFieldNoProperty.cs
new file mode 100644
index 0000000000..fa840c9d40
--- /dev/null
+++ b/samples/core/Modeling/BackingFields/FluentAPI/BackingFieldNoProperty.cs
@@ -0,0 +1,40 @@
+using System.Net.Http;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.BackingFields.FluentAPI.BackingFieldNoProperty;
+
+#region Sample
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .Property("_validatedUrl");
+    }
+}
+
+public class Blog
+{
+    private string _validatedUrl;
+
+    public int BlogId { get; set; }
+
+    public string GetUrl()
+    {
+        return _validatedUrl;
+    }
+
+    public void SetUrl(string url)
+    {
+        using (var client = new HttpClient())
+        {
+            var response = client.GetAsync(url).Result;
+            response.EnsureSuccessStatusCode();
+        }
+
+        _validatedUrl = url;
+    }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/BackingFields/Program.cs b/samples/core/Modeling/BackingFields/Program.cs
new file mode 100644
index 0000000000..3c8efa70de
--- /dev/null
+++ b/samples/core/Modeling/BackingFields/Program.cs
@@ -0,0 +1,8 @@
+namespace EFModeling.BackingFields;
+
+internal class Program
+{
+    private static void Main(string[] args)
+    {
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/BulkConfiguration/BlogsContext.cs b/samples/core/Modeling/BulkConfiguration/BlogsContext.cs
new file mode 100644
index 0000000000..85a831cf7c
--- /dev/null
+++ b/samples/core/Modeling/BulkConfiguration/BlogsContext.cs
@@ -0,0 +1,425 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Net;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using Microsoft.Extensions.Logging;
+
+namespace EFModeling.BulkConfiguration;
+
+#region BlogsModel
+public class Blog
+{
+    public Blog(string name)
+    {
+        Name = name;
+    }
+
+    public int Id { get; private set; }
+    public string Name { get; set; }
+    public List<Post> Posts { get; } = new();
+}
+
+public class Post
+{
+    public Post(string title, string content, DateTime publishedOn)
+    {
+        Title = title;
+        Content = content;
+        PublishedOn = publishedOn;
+    }
+
+    public int Id { get; private set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+    public DateTime PublishedOn { get; set; }
+    public Blog Blog { get; set; } = null!;
+    public List<Tag> Tags { get; } = new();
+    public Author? Author { get; set; }
+    public PostMetadata? Metadata { get; set; }
+}
+
+public class FeaturedPost : Post
+{
+    public FeaturedPost(string title, string content, DateTime publishedOn, string promoText)
+        : base(title, content, publishedOn)
+    {
+        PromoText = promoText;
+    }
+
+    public string PromoText { get; set; }
+}
+
+public class Tag
+{
+    public Tag(string id, string text)
+    {
+        Id = id;
+        Text = text;
+    }
+
+    public string Id { get; private set; }
+    public string Text { get; set; }
+    public List<Post> Posts { get; } = new();
+}
+
+public class Author
+{
+    public Author(string name)
+    {
+        Name = name;
+    }
+
+    public int Id { get; private set; }
+    public string Name { get; set; }
+    public ContactDetails Contact { get; set; } = null!;
+    public List<Post> Posts { get; } = new();
+}
+#endregion
+
+#region ContactDetailsAggregate
+public class ContactDetails
+{
+    public Address Address { get; set; } = null!;
+    public string? Phone { get; set; }
+}
+
+public class Address
+{
+    public Address(string street, string city, string postcode, string country)
+    {
+        Street = street;
+        City = city;
+        Postcode = postcode;
+        Country = country;
+    }
+
+    public string Street { get; set; }
+    public string City { get; set; }
+    public string Postcode { get; set; }
+    public string Country { get; set; }
+}
+#endregion
+
+#region PostMetadataAggregate
+public class PostMetadata
+{
+    public PostMetadata(int views)
+    {
+        Views = views;
+    }
+
+    public int Views { get; set; }
+    public List<SearchTerm> TopSearches { get; } = new();
+    public List<Visits> TopGeographies { get; } = new();
+    public List<PostUpdate> Updates { get; } = new();
+}
+
+public class SearchTerm
+{
+    public SearchTerm(string term, int count)
+    {
+        Term = term;
+        Count = count;
+    }
+
+    public string Term { get; private set; }
+    public int Count { get; private set; }
+}
+
+public class Visits
+{
+    public Visits(double latitude, double longitude, int count)
+    {
+        Latitude = latitude;
+        Longitude = longitude;
+        Count = count;
+    }
+
+    public double Latitude { get; private set; }
+    public double Longitude { get; private set; }
+    public int Count { get; private set; }
+    public List<string>? Browsers { get; set; }
+}
+
+public class PostUpdate
+{
+    public PostUpdate(IPAddress postedFrom, DateTime updatedOn)
+    {
+        PostedFrom = postedFrom;
+        UpdatedOn = updatedOn;
+    }
+
+    public IPAddress PostedFrom { get; private set; }
+    public string? UpdatedBy { get; init; }
+    public DateTime UpdatedOn { get; private set; }
+    public List<Commit> Commits { get; } = new();
+}
+
+public class Commit
+{
+    public Commit(DateTime committedOn, string comment)
+    {
+        CommittedOn = committedOn;
+        Comment = comment;
+    }
+
+    public DateTime CommittedOn { get; private set; }
+    public string Comment { get; set; }
+}
+#endregion
+
+public abstract class BlogsContext : DbContext
+{
+    public bool LoggingEnabled { get; set; }
+    public virtual MappingStrategy MappingStrategy => MappingStrategy.Tph;
+
+    public DbSet<Blog> Blogs => Set<Blog>();
+    public DbSet<Tag> Tags => Set<Tag>();
+    public DbSet<Post> Posts => Set<Post>();
+    public DbSet<Author> Authors => Set<Author>();
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => (optionsBuilder.UseSqlServer(
+                    @$"Server=(localdb)\mssqllocaldb;Database=EFModeling.BulkConfiguration.{GetType().Name};ConnectRetryCount=0"))
+            .EnableSensitiveDataLogging()
+            .LogTo(
+                s =>
+                {
+                    if (LoggingEnabled)
+                    {
+                        Console.WriteLine(s);
+                    }
+                }, LogLevel.Information);
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<FeaturedPost>();
+    }
+
+    protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+    {
+        configurationBuilder.Properties<List<string>>().HaveConversion<StringListConverter>();
+
+        base.ConfigureConventions(configurationBuilder);
+    }
+
+    private class StringListConverter : ValueConverter<List<string>, string>
+    {
+        public StringListConverter()
+            : base(v => string.Join(", ", v!), v => v.Split(',', StringSplitOptions.TrimEntries).ToList())
+        {
+        }
+    }
+
+    public async Task Seed()
+    {
+        var tagEntityFramework = new Tag("TagEF", "Entity Framework");
+        var tagDotNet = new Tag("TagNet", ".NET");
+        var tagDotNetMaui = new Tag("TagMaui", ".NET MAUI");
+        var tagAspDotNet = new Tag("TagAsp", "ASP.NET");
+        var tagAspDotNetCore = new Tag("TagAspC", "ASP.NET Core");
+        var tagDotNetCore = new Tag("TagC", ".NET Core");
+        var tagHacking = new Tag("TagHx", "Hacking");
+        var tagLinux = new Tag("TagLin", "Linux");
+        var tagSqlite = new Tag("TagLite", "SQLite");
+        var tagVisualStudio = new Tag("TagVS", "Visual Studio");
+        var tagGraphQl = new Tag("TagQL", "GraphQL");
+        var tagCosmosDb = new Tag("TagCos", "CosmosDB");
+        var tagBlazor = new Tag("TagBl", "Blazor");
+
+        var maddy = new Author("Maddy Montaquila")
+        {
+            Contact = new() { Address = new("1 Main St", "Camberwick Green", "CW1 5ZH", "UK"), Phone = "01632 12345" }
+        };
+        var jeremy = new Author("Jeremy Likness")
+        {
+            Contact = new() { Address = new("2 Main St", "Chigley", "CW1 5ZH", "UK"), Phone = "01632 12346" }
+        };
+        var dan = new Author("Daniel Roth")
+        {
+            Contact = new() { Address = new("3 Main St", "Camberwick Green", "CW1 5ZH", "UK"), Phone = "01632 12347" }
+        };
+        var arthur = new Author("Arthur Vickers")
+        {
+            Contact = new() { Address = new("15a Main St", "Chigley", "CW1 5ZH", "UK"), Phone = "01632 12348" }
+        };
+        var brice = new Author("Brice Lambson")
+        {
+            Contact = new() { Address = new("4 Main St", "Chigley", "CW1 5ZH", "UK"), Phone = "01632 12349" }
+        };
+
+        var blogs = new List<Blog>
+        {
+            new(".NET Blog")
+            {
+                Posts =
+                {
+                    new Post(
+                        "Productivity comes to .NET MAUI in Visual Studio 2022",
+                        "Visual Studio 2022 17.3 is now available and...",
+                        new DateTime(2022, 8, 9)) { Tags = { tagDotNetMaui, tagDotNet }, Author = maddy, Metadata = BuildPostMetadata() },
+                    new Post(
+                        "Announcing .NET 7 Preview 7", ".NET 7 Preview 7 is now available with improvements to System.LINQ, Unix...",
+                        new DateTime(2022, 8, 9)) { Tags = { tagDotNet }, Author = jeremy, Metadata = BuildPostMetadata() },
+                    new Post(
+                        "ASP.NET Core updates in .NET 7 Preview 7", ".NET 7 Preview 7 is now available! Check out what's new in...",
+                        new DateTime(2022, 8, 9))
+                    {
+                        Tags = { tagDotNet, tagAspDotNet, tagAspDotNetCore }, Author = dan, Metadata = BuildPostMetadata()
+                    },
+                    new FeaturedPost(
+                        "Announcing Entity Framework 7 Preview 7: Interceptors!",
+                        "Announcing EF7 Preview 7 with new and improved interceptors, and...",
+                        new DateTime(2022, 8, 9),
+                        "Loads of runnable code!")
+                    {
+                        Tags = { tagEntityFramework, tagDotNet, tagDotNetCore }, Author = arthur, Metadata = BuildPostMetadata()
+                    }
+                },
+            },
+            new("1unicorn2")
+            {
+                Posts =
+                {
+                    new Post(
+                        "Hacking my Sixth Form College network in 1991",
+                        "Back in 1991 I was a student at Franklin Sixth Form College...",
+                        new DateTime(2020, 4, 10)) { Tags = { tagHacking }, Author = arthur, Metadata = BuildPostMetadata() },
+                    new FeaturedPost(
+                        "All your versions are belong to us",
+                        "Totally made up conversations about choosing Entity Framework version numbers...",
+                        new DateTime(2020, 3, 26),
+                        "Way funny!") { Tags = { tagEntityFramework }, Author = arthur, Metadata = BuildPostMetadata() },
+                    new Post(
+                        "Moving to Linux", "A few weeks ago, I decided to move from Windows to Linux as...",
+                        new DateTime(2020, 3, 7)) { Tags = { tagLinux }, Author = arthur, Metadata = BuildPostMetadata() },
+                    new Post(
+                        "Welcome to One Unicorn 2.0!", "I created my first blog back in 2011..",
+                        new DateTime(2020, 2, 29)) { Tags = { tagEntityFramework }, Author = arthur, Metadata = BuildPostMetadata() }
+                }
+            },
+            new("Brice's Blog")
+            {
+                Posts =
+                {
+                    new FeaturedPost(
+                        "SQLite in Visual Studio 2022", "A couple of years ago, I was thinking of ways...",
+                        new DateTime(2022, 7, 26), "Love for VS!")
+                    {
+                        Tags = { tagSqlite, tagVisualStudio }, Author = brice, Metadata = BuildPostMetadata()
+                    },
+                    new Post(
+                        "On .NET - Entity Framework Migrations Explained",
+                        "This week, @JamesMontemagno invited me onto the On .NET show...",
+                        new DateTime(2022, 5, 4))
+                    {
+                        Tags = { tagEntityFramework, tagDotNet }, Author = brice, Metadata = BuildPostMetadata()
+                    },
+                    new Post(
+                        "Dear DBA: A silly idea", "We have fun on the Entity Framework team...",
+                        new DateTime(2022, 3, 31)) { Tags = { tagEntityFramework }, Author = brice, Metadata = BuildPostMetadata() },
+                    new Post(
+                        "Microsoft.Data.Sqlite 6", "It’s that time of year again. Microsoft.Data.Sqlite version...",
+                        new DateTime(2021, 11, 8)) { Tags = { tagSqlite, tagDotNet }, Author = brice, Metadata = BuildPostMetadata() }
+                }
+            },
+            new("Developer for Life")
+            {
+                Posts =
+                {
+                    new Post(
+                        "GraphQL for .NET Developers", "A comprehensive overview of GraphQL as...",
+                        new DateTime(2021, 7, 1))
+                    {
+                        Tags = { tagDotNet, tagGraphQl, tagAspDotNetCore }, Author = jeremy, Metadata = BuildPostMetadata()
+                    },
+                    new FeaturedPost(
+                        "Azure Cosmos DB With EF Core on Blazor Server",
+                        "Learn how to build Azure Cosmos DB apps using Entity Framework Core...",
+                        new DateTime(2021, 5, 16),
+                        "Blazor FTW!")
+                    {
+                        Tags =
+                        {
+                            tagDotNet,
+                            tagEntityFramework,
+                            tagAspDotNetCore,
+                            tagCosmosDb,
+                            tagBlazor
+                        },
+                        Author = jeremy,
+                        Metadata = BuildPostMetadata()
+                    },
+                    new Post(
+                        "Multi-tenancy with EF Core in Blazor Server Apps",
+                        "Learn several ways to implement multi-tenant databases in Blazor Server apps...",
+                        new DateTime(2021, 4, 29))
+                    {
+                        Tags = { tagDotNet, tagEntityFramework, tagAspDotNetCore, tagBlazor },
+                        Author = jeremy,
+                        Metadata = BuildPostMetadata()
+                    },
+                    new Post(
+                        "An Easier Blazor Debounce", "Where I propose a simple method to debounce input without...",
+                        new DateTime(2021, 4, 12))
+                    {
+                        Tags = { tagDotNet, tagAspDotNetCore, tagBlazor }, Author = jeremy, Metadata = BuildPostMetadata()
+                    }
+                }
+            }
+        };
+
+        await AddRangeAsync(blogs);
+        await SaveChangesAsync();
+
+        PostMetadata BuildPostMetadata()
+        {
+            var random = new Random(Guid.NewGuid().GetHashCode());
+
+            var metadata = new PostMetadata(random.Next(10000));
+
+            for (var i = 0; i < random.Next(5); i++)
+            {
+                var update = new PostUpdate(IPAddress.Loopback, DateTime.UtcNow - TimeSpan.FromDays(random.Next(1, 10000)))
+                {
+                    UpdatedBy = "Admin"
+                };
+
+                for (var j = 0; j < random.Next(3); j++)
+                {
+                    update.Commits.Add(new(DateTime.Today, $"Commit #{j + 1}"));
+                }
+
+                metadata.Updates.Add(update);
+            }
+
+            for (var i = 0; i < random.Next(5); i++)
+            {
+                metadata.TopSearches.Add(new($"Search #{i + 1}", 10000 - random.Next(i * 1000, i * 1000 + 900)));
+            }
+
+            for (var i = 0; i < random.Next(5); i++)
+            {
+                metadata.TopGeographies.Add(
+                    new(
+                        // Issue https://github.com/dotnet/efcore/issues/28811 (Support spatial types in JSON columns)
+                        // new Point(115.7930 + 20 - random.Next(40), 37.2431 + 10 - random.Next(20)) { SRID = 4326 },
+                        115.7930 + 20 - random.Next(40),
+                        37.2431 + 10 - random.Next(20),
+                        1000 - random.Next(i * 100, i * 100 + 90)) { Browsers = new() { "Firefox", "Netscape" } });
+            }
+
+            return metadata;
+        }
+    }
+}
+
+public enum MappingStrategy
+{
+    Tph,
+    Tpt,
+    Tpc,
+}
diff --git a/samples/core/Modeling/BulkConfiguration/BulkConfiguration.csproj b/samples/core/Modeling/BulkConfiguration/BulkConfiguration.csproj
new file mode 100644
index 0000000000..a6e7034eb6
--- /dev/null
+++ b/samples/core/Modeling/BulkConfiguration/BulkConfiguration.csproj
@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFModeling.BulkConfiguration</RootNamespace>
+    <AssemblyName>EFModeling.BulkConfiguration</AssemblyName>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Modeling/BulkConfiguration/Currency.cs b/samples/core/Modeling/BulkConfiguration/Currency.cs
new file mode 100644
index 0000000000..c1eaeb2f80
--- /dev/null
+++ b/samples/core/Modeling/BulkConfiguration/Currency.cs
@@ -0,0 +1,14 @@
+namespace EFModeling.BulkConfiguration;
+
+#region Currency
+public readonly struct Currency
+{
+    public Currency(decimal amount)
+        => Amount = amount;
+
+    public decimal Amount { get; }
+
+    public override string ToString()
+        => $"${Amount}";
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/BulkConfiguration/CurrencyContext.cs b/samples/core/Modeling/BulkConfiguration/CurrencyContext.cs
new file mode 100644
index 0000000000..97fe4f3dcb
--- /dev/null
+++ b/samples/core/Modeling/BulkConfiguration/CurrencyContext.cs
@@ -0,0 +1,25 @@
+using System;
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.BulkConfiguration;
+
+public class CurrencyContext : DbContext
+{
+    public DbSet<Product> Products { get; set; }
+
+    #region ConfigureConventions
+    protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+    {
+        configurationBuilder
+            .Properties<Currency>()
+            .HaveConversion<CurrencyConverter>();
+    }
+    #endregion
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.UseSqlServer(
+                @"Server=(localdb)\mssqllocaldb;Database=EFModeling.BulkConfiguration.Currency;Trusted_Connection=True;ConnectRetryCount=0")
+            .LogTo(Console.WriteLine, minimumLevel: Microsoft.Extensions.Logging.LogLevel.Information)
+            .EnableSensitiveDataLogging();
+}
diff --git a/samples/core/Modeling/BulkConfiguration/CurrencyConverter.cs b/samples/core/Modeling/BulkConfiguration/CurrencyConverter.cs
new file mode 100644
index 0000000000..d6a90adcfb
--- /dev/null
+++ b/samples/core/Modeling/BulkConfiguration/CurrencyConverter.cs
@@ -0,0 +1,15 @@
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+namespace EFModeling.BulkConfiguration;
+
+#region CurrencyConverter
+public class CurrencyConverter : ValueConverter<Currency, decimal>
+{
+    public CurrencyConverter()
+        : base(
+            v => v.Amount,
+            v => new Currency(v))
+    {
+    }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/BulkConfiguration/MetadataAPIContext.cs b/samples/core/Modeling/BulkConfiguration/MetadataAPIContext.cs
new file mode 100644
index 0000000000..c8f2b87fe2
--- /dev/null
+++ b/samples/core/Modeling/BulkConfiguration/MetadataAPIContext.cs
@@ -0,0 +1,32 @@
+using System;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.BulkConfiguration;
+
+public class MetadataAPIContext : DbContext
+{
+    public DbSet<Product> Products { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        #region MetadataAPI
+        foreach (var entityType in modelBuilder.Model.GetEntityTypes())
+        {
+            foreach (var propertyInfo in entityType.ClrType.GetProperties())
+            {
+                if (propertyInfo.PropertyType == typeof(Currency))
+                {
+                    entityType.AddProperty(propertyInfo)
+                        .SetValueConverter(typeof(CurrencyConverter));
+                }
+            }
+        }
+        #endregion
+    }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.UseSqlServer(
+                @"Server=(localdb)\mssqllocaldb;Database=EFModeling.BulkConfiguration;Trusted_Connection=True;ConnectRetryCount=0")
+            .LogTo(Console.WriteLine, minimumLevel: Microsoft.Extensions.Logging.LogLevel.Information)
+            .EnableSensitiveDataLogging();
+}
diff --git a/samples/core/Modeling/BulkConfiguration/ModelBuildingConventionsSample.cs b/samples/core/Modeling/BulkConfiguration/ModelBuildingConventionsSample.cs
new file mode 100644
index 0000000000..64bcd9d526
--- /dev/null
+++ b/samples/core/Modeling/BulkConfiguration/ModelBuildingConventionsSample.cs
@@ -0,0 +1,396 @@
+using System;
+using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations;
+using System.Linq;
+using System.Reflection;
+using System.Runtime.CompilerServices;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Metadata.Builders;
+using Microsoft.EntityFrameworkCore.Metadata.Conventions;
+using Microsoft.EntityFrameworkCore.Metadata.Conventions.Infrastructure;
+using Microsoft.Extensions.DependencyInjection;
+
+#pragma warning disable CS0169
+
+namespace EFModeling.BulkConfiguration;
+
+public static class ModelBuildingConventionsSample
+{
+    public static Task No_foreign_key_index_convention()
+    {
+        PrintSampleName();
+        return ConventionsTest<NoForeignKeyIndexBlogsContext>();
+    }
+
+    public static Task Discriminator_length_convention()
+    {
+        PrintSampleName();
+        return ConventionsTest<DiscriminatorLengthBlogsContext>();
+    }
+
+    public static Task Max_string_length_convention()
+    {
+        PrintSampleName();
+        return ConventionsTest<MaxStringLengthBlogsContext>();
+    }
+
+    public static async Task Map_members_explicitly_by_attribute_convention()
+    {
+        PrintSampleName();
+
+        await using var context = new LaundryContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        Console.WriteLine(context.Model.ToDebugString());
+        Console.WriteLine();
+    }
+
+    private static async Task ConventionsTest<TContext>()
+        where TContext : BlogsContext, new()
+    {
+        await using var context = new TContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        await context.Seed();
+        context.ChangeTracker.Clear();
+
+        Console.WriteLine(context.Model.ToDebugString());
+
+        var blogs = await context.Blogs
+            .Include(blog => blog.Posts).ThenInclude(post => post.Author)
+            .Include(blog => blog.Posts).ThenInclude(post => post.Tags)
+            .ToListAsync();
+
+        blogs[0].Name += "Changed";
+        blogs[1].Posts[2].Content += "Changed";
+        blogs[2].Posts[0].Author!.Contact.Address.Country = "United Kingdon";
+        blogs[3].Posts[1].Tags.Add(new Tag("TagNt", "New Tag"));
+        blogs[2].Posts[1].Tags.Remove(blogs[2].Posts[1].Tags[0]);
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+    }
+
+    private static void PrintSampleName([CallerMemberName] string? methodName = null)
+    {
+        Console.WriteLine($">>>> Sample: {methodName}");
+        Console.WriteLine();
+    }
+}
+
+public abstract class ModelBuildingBlogsContextBase : BlogsContext
+{
+    protected ModelBuildingBlogsContextBase()
+        : base()
+    {
+    }
+
+    public override MappingStrategy MappingStrategy => MappingStrategy.Tph;
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Author>().OwnsOne(
+            author => author.Contact, ownedNavigationBuilder =>
+            {
+                ownedNavigationBuilder.OwnsOne(contactDetails => contactDetails.Address);
+            });
+
+        modelBuilder.Entity<Post>().OwnsOne(
+            post => post.Metadata, ownedNavigationBuilder =>
+            {
+                ownedNavigationBuilder.OwnsMany(metadata => metadata.TopSearches);
+                ownedNavigationBuilder.OwnsMany(metadata => metadata.TopGeographies);
+                ownedNavigationBuilder.OwnsMany(
+                    metadata => metadata.Updates,
+                    ownedOwnedNavigationBuilder => ownedOwnedNavigationBuilder.OwnsMany(update => update.Commits));
+            });
+
+        base.OnModelCreating(modelBuilder);
+    }
+}
+
+public class NoForeignKeyIndexBlogsContext : ModelBuildingBlogsContextBase
+{
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>(entityTypeBuilder => entityTypeBuilder.HasIndex("BlogId"));
+
+        base.OnModelCreating(modelBuilder);
+    }
+
+    protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+    {
+        configurationBuilder.Conventions.Remove(typeof(ForeignKeyIndexConvention));
+
+        base.ConfigureConventions(configurationBuilder);
+    }
+}
+
+public class DiscriminatorLengthBlogsContext : ModelBuildingBlogsContextBase
+{
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        base.OnModelCreating(modelBuilder);
+
+        modelBuilder.Entity<Post>()
+            .HasDiscriminator<string>("PostTypeDiscriminator")
+            .HasValue<Post>("Post")
+            .HasValue<FeaturedPost>("Featured");
+    }
+
+    protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+    {
+        configurationBuilder.Conventions.Add(_ => new DiscriminatorLengthConvention3());
+
+        base.ConfigureConventions(configurationBuilder);
+    }
+}
+
+#region DiscriminatorLengthConvention1
+public class DiscriminatorLengthConvention1 : IEntityTypeBaseTypeChangedConvention
+{
+    public void ProcessEntityTypeBaseTypeChanged(
+        IConventionEntityTypeBuilder entityTypeBuilder,
+        IConventionEntityType? newBaseType,
+        IConventionEntityType? oldBaseType,
+        IConventionContext<IConventionEntityType> context)
+    {
+        var discriminatorProperty = entityTypeBuilder.Metadata.FindDiscriminatorProperty();
+        if (discriminatorProperty != null
+            && discriminatorProperty.ClrType == typeof(string))
+        {
+            discriminatorProperty.Builder.HasMaxLength(24);
+        }
+    }
+}
+#endregion
+
+#region DiscriminatorLengthConvention2
+public class DiscriminatorLengthConvention2 : IModelFinalizingConvention
+{
+    public void ProcessModelFinalizing(IConventionModelBuilder modelBuilder, IConventionContext<IConventionModelBuilder> context)
+    {
+        foreach (var entityType in modelBuilder.Metadata.GetEntityTypes()
+                     .Where(entityType => entityType.BaseType == null))
+        {
+            var discriminatorProperty = entityType.FindDiscriminatorProperty();
+            if (discriminatorProperty != null
+                && discriminatorProperty.ClrType == typeof(string))
+            {
+                discriminatorProperty.Builder.HasMaxLength(24);
+            }
+        }
+    }
+}
+#endregion
+
+#region DiscriminatorLengthConvention3
+public class DiscriminatorLengthConvention3 : IModelFinalizingConvention
+{
+    public void ProcessModelFinalizing(IConventionModelBuilder modelBuilder, IConventionContext<IConventionModelBuilder> context)
+    {
+        foreach (var entityType in modelBuilder.Metadata.GetEntityTypes()
+                     .Where(entityType => entityType.BaseType == null))
+        {
+            var discriminatorProperty = entityType.FindDiscriminatorProperty();
+            if (discriminatorProperty != null
+                && discriminatorProperty.ClrType == typeof(string))
+            {
+                var maxDiscriminatorValueLength =
+                    entityType.GetDerivedTypesInclusive().Select(e => ((string)e.GetDiscriminatorValue()!).Length).Max();
+
+                discriminatorProperty.Builder.HasMaxLength(maxDiscriminatorValueLength);
+            }
+        }
+    }
+}
+#endregion
+
+public class MaxStringLengthBlogsContext : ModelBuildingBlogsContextBase
+{
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>()
+            .Property(post => post.Content)
+            .HasMaxLength(4000);
+
+        base.OnModelCreating(modelBuilder);
+    }
+
+    protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+    {
+        configurationBuilder.Conventions.Add(_ => new MaxStringLengthConvention());
+        configurationBuilder.Conventions.Add(_ => new DiscriminatorLengthConvention3());
+
+        base.ConfigureConventions(configurationBuilder);
+    }
+}
+
+#region MaxStringLengthConvention
+public class MaxStringLengthConvention : IModelFinalizingConvention
+{
+    public void ProcessModelFinalizing(IConventionModelBuilder modelBuilder, IConventionContext<IConventionModelBuilder> context)
+    {
+        foreach (var property in modelBuilder.Metadata.GetEntityTypes()
+                     .SelectMany(
+                         entityType => entityType.GetDeclaredProperties()
+                             .Where(
+                                 property => property.ClrType == typeof(string))))
+        {
+            property.Builder.HasMaxLength(512);
+        }
+    }
+}
+#endregion
+
+#region MaxStringLengthNonUnicodeConvention
+public class MaxStringLengthNonUnicodeConvention : IModelFinalizingConvention
+{
+    public void ProcessModelFinalizing(IConventionModelBuilder modelBuilder, IConventionContext<IConventionModelBuilder> context)
+    {
+        foreach (var property in modelBuilder.Metadata.GetEntityTypes()
+                     .SelectMany(
+                         entityType => entityType.GetDeclaredProperties()
+                             .Where(
+                                 property => property.ClrType == typeof(string))))
+        {
+            var propertyBuilder = property.Builder;
+            if (propertyBuilder.CanSetMaxLength(512)
+                && propertyBuilder.CanSetIsUnicode(false))
+            {
+                propertyBuilder.HasMaxLength(512)!.IsUnicode(false);
+            }
+        }
+    }
+}
+#endregion
+
+public class LaundryContext : DbContext
+{
+    public DbSet<LaundryBasket> LaundryBaskets => Set<LaundryBasket>();
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.UseSqlServer(@$"Server=(localdb)\mssqllocaldb;Database={GetType().Name};ConnectRetryCount=0");
+
+    #region ReplaceConvention
+    protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+    {
+        configurationBuilder.Conventions.Replace<PropertyDiscoveryConvention>(
+            serviceProvider => new AttributeBasedPropertyDiscoveryConvention(
+                serviceProvider.GetRequiredService<ProviderConventionSetBuilderDependencies>()));
+    }
+    #endregion
+}
+
+#region PersistAttribute
+[AttributeUsage(AttributeTargets.Property | AttributeTargets.Field)]
+public sealed class PersistAttribute : Attribute
+{
+}
+#endregion
+
+#region LaundryBasket
+public class LaundryBasket
+{
+    [Persist]
+    [Key]
+    private readonly int _id;
+
+    [Persist]
+    public int TenantId { get; init; }
+
+    public bool IsClean { get; set; }
+
+    public List<Garment> Garments { get; } = new();
+}
+
+public class Garment
+{
+    public Garment(string name, string color)
+    {
+        Name = name;
+        Color = color;
+    }
+
+    [Persist]
+    [Key]
+    private readonly int _id;
+
+    [Persist]
+    public int TenantId { get; init; }
+
+    [Persist]
+    public string Name { get; }
+
+    [Persist]
+    public string Color { get; }
+
+    public bool IsClean { get; set; }
+
+    public LaundryBasket? Basket { get; set; }
+}
+#endregion
+
+#region AttributeBasedPropertyDiscoveryConvention
+public class AttributeBasedPropertyDiscoveryConvention : PropertyDiscoveryConvention
+{
+    public AttributeBasedPropertyDiscoveryConvention(ProviderConventionSetBuilderDependencies dependencies)
+        : base(dependencies)
+    {
+    }
+
+    public override void ProcessEntityTypeAdded(
+        IConventionEntityTypeBuilder entityTypeBuilder,
+        IConventionContext<IConventionEntityTypeBuilder> context)
+        => Process(entityTypeBuilder);
+
+    public override void ProcessEntityTypeBaseTypeChanged(
+        IConventionEntityTypeBuilder entityTypeBuilder,
+        IConventionEntityType? newBaseType,
+        IConventionEntityType? oldBaseType,
+        IConventionContext<IConventionEntityType> context)
+    {
+        if ((newBaseType == null
+             || oldBaseType != null)
+            && entityTypeBuilder.Metadata.BaseType == newBaseType)
+        {
+            Process(entityTypeBuilder);
+        }
+    }
+
+    private void Process(IConventionEntityTypeBuilder entityTypeBuilder)
+    {
+        foreach (var memberInfo in GetRuntimeMembers())
+        {
+            if (Attribute.IsDefined(memberInfo, typeof(PersistAttribute), inherit: true))
+            {
+                entityTypeBuilder.Property(memberInfo);
+            }
+            else if (memberInfo is PropertyInfo propertyInfo
+                     && Dependencies.TypeMappingSource.FindMapping(propertyInfo) != null)
+            {
+                entityTypeBuilder.Ignore(propertyInfo.Name);
+            }
+        }
+
+        IEnumerable<MemberInfo> GetRuntimeMembers()
+        {
+            var clrType = entityTypeBuilder.Metadata.ClrType;
+
+            foreach (var property in clrType.GetRuntimeProperties()
+                         .Where(p => p.GetMethod != null && !p.GetMethod.IsStatic))
+            {
+                yield return property;
+            }
+
+            foreach (var property in clrType.GetRuntimeFields())
+            {
+                yield return property;
+            }
+        }
+    }
+}
+#endregion
diff --git a/samples/core/Modeling/BulkConfiguration/PreConventionContext.cs b/samples/core/Modeling/BulkConfiguration/PreConventionContext.cs
new file mode 100644
index 0000000000..79e6c944da
--- /dev/null
+++ b/samples/core/Modeling/BulkConfiguration/PreConventionContext.cs
@@ -0,0 +1,43 @@
+using System;
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.BulkConfiguration;
+
+public class PreConventionContext : DbContext
+{
+    public DbSet<Product> Products { get; set; }
+
+    protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
+    {
+        #region CurrencyConversion
+        configurationBuilder
+            .Properties<Currency>()
+            .HaveConversion<CurrencyConverter>();
+        #endregion
+
+        #region StringFacets
+        configurationBuilder
+            .Properties<string>()
+            .AreUnicode(false)
+            .HaveMaxLength(1024);
+        #endregion
+
+        #region IgnoreInterface
+        configurationBuilder
+            .IgnoreAny(typeof(IList<>));
+        #endregion
+
+        #region DefaultTypeMapping
+        configurationBuilder
+            .DefaultTypeMapping<Currency>()
+            .HasConversion<CurrencyConverter>();
+        #endregion
+    }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.UseSqlServer(
+                @"Server=(localdb)\mssqllocaldb;Database=EFModeling.BulkConfiguration;Trusted_Connection=True;ConnectRetryCount=0")
+            .LogTo(Console.WriteLine, minimumLevel: Microsoft.Extensions.Logging.LogLevel.Information)
+            .EnableSensitiveDataLogging();
+}
diff --git a/samples/core/Modeling/BulkConfiguration/Product.cs b/samples/core/Modeling/BulkConfiguration/Product.cs
new file mode 100644
index 0000000000..1dd4878a2f
--- /dev/null
+++ b/samples/core/Modeling/BulkConfiguration/Product.cs
@@ -0,0 +1,7 @@
+namespace EFModeling.BulkConfiguration;
+
+public class Product
+{
+    public int Id { get; set; }
+    public Currency Price { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/BulkConfiguration/Program.cs b/samples/core/Modeling/BulkConfiguration/Program.cs
new file mode 100644
index 0000000000..40106b60b0
--- /dev/null
+++ b/samples/core/Modeling/BulkConfiguration/Program.cs
@@ -0,0 +1,56 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.BulkConfiguration;
+
+internal class Program
+{
+    private static async Task Main()
+    {
+        Console.WriteLine("Samples showing bulk configuration of the model");
+        Console.WriteLine();
+
+        using (var context = new MetadataAPIContext())
+        {
+            await RoundtripValue(context);
+        }
+
+        using (var context = new PreConventionContext())
+        {
+            await RoundtripValue(context);
+        }
+
+        await ModelBuildingConventionsSample.No_foreign_key_index_convention();
+        await ModelBuildingConventionsSample.Discriminator_length_convention();
+        await ModelBuildingConventionsSample.Max_string_length_convention();
+        await ModelBuildingConventionsSample.Map_members_explicitly_by_attribute_convention();
+
+        Console.WriteLine();
+        Console.WriteLine("Sample finished.");
+    }
+
+    private static async Task RoundtripValue(DbContext context)
+    {
+        Console.WriteLine("Using " + context.GetType().Name);
+        Console.WriteLine("Deleting and re-creating database...");
+        Console.WriteLine();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        Console.WriteLine();
+        Console.WriteLine("Done. Database is clean and fresh.");
+
+        var product = new Product { Price = new Currency(3.99m) };
+        context.Add(product);
+
+        Console.WriteLine("Save a new product with price: " + product.Price.Amount);
+        Console.WriteLine();
+
+        await context.SaveChangesAsync();
+
+        Console.WriteLine();
+        Console.WriteLine("Read the entity back with price: " + (await context.Set<Product>().SingleAsync()).Price.Amount);
+        Console.WriteLine();
+    }
+}
diff --git a/samples/core/Modeling/ConcurrencyTokens/ConcurrencyTokens.csproj b/samples/core/Modeling/ConcurrencyTokens/ConcurrencyTokens.csproj
new file mode 100644
index 0000000000..92d7bc1771
--- /dev/null
+++ b/samples/core/Modeling/ConcurrencyTokens/ConcurrencyTokens.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFModeling.ConcurrencyTokens</RootNamespace>
+    <AssemblyName>EFModeling.ConcurrencyTokens</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Modeling/ConcurrencyTokens/DataAnnotations/Timestamp.cs b/samples/core/Modeling/ConcurrencyTokens/DataAnnotations/Timestamp.cs
new file mode 100644
index 0000000000..4bfd7d7875
--- /dev/null
+++ b/samples/core/Modeling/ConcurrencyTokens/DataAnnotations/Timestamp.cs
@@ -0,0 +1,21 @@
+using System.ComponentModel.DataAnnotations;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.ConcurrencyTokens.DataAnnotations.Timestamp;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+#region Timestamp
+public class Blog
+{
+    public int BlogId { get; set; }
+
+    public string Url { get; set; }
+
+    [Timestamp]
+    public byte[] Timestamp { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/ConcurrencyTokens/FluentAPI/Timestamp.cs b/samples/core/Modeling/ConcurrencyTokens/FluentAPI/Timestamp.cs
new file mode 100644
index 0000000000..b833f2bc91
--- /dev/null
+++ b/samples/core/Modeling/ConcurrencyTokens/FluentAPI/Timestamp.cs
@@ -0,0 +1,24 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.ConcurrencyTokens.FluentAPI.Timestamp;
+
+#region Timestamp
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .Property(p => p.Timestamp)
+            .IsRowVersion();
+    }
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public byte[] Timestamp { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/ConcurrencyTokens/Program.cs b/samples/core/Modeling/ConcurrencyTokens/Program.cs
new file mode 100644
index 0000000000..e02b152190
--- /dev/null
+++ b/samples/core/Modeling/ConcurrencyTokens/Program.cs
@@ -0,0 +1,8 @@
+namespace EFModeling.ConcurrencyTokens;
+
+internal class Program
+{
+    private static void Main(string[] args)
+    {
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/DataSeeding/Blog.cs b/samples/core/Modeling/DataSeeding/Blog.cs
new file mode 100644
index 0000000000..048a34240c
--- /dev/null
+++ b/samples/core/Modeling/DataSeeding/Blog.cs
@@ -0,0 +1,11 @@
+using System.Collections.Generic;
+
+namespace EFModeling.DataSeeding;
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public virtual ICollection<Post> Posts { get; set; }
+}
diff --git a/samples/core/Modeling/DataSeeding/City.cs b/samples/core/Modeling/DataSeeding/City.cs
new file mode 100644
index 0000000000..3811f6054d
--- /dev/null
+++ b/samples/core/Modeling/DataSeeding/City.cs
@@ -0,0 +1,9 @@
+namespace EFModeling.DataSeeding;
+
+public class City
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+    public int LocatedInId { get; set; }
+    public Country LocatedIn { get; set; }
+}
diff --git a/samples/core/Modeling/DataSeeding/Country.cs b/samples/core/Modeling/DataSeeding/Country.cs
new file mode 100644
index 0000000000..cecba3ae2f
--- /dev/null
+++ b/samples/core/Modeling/DataSeeding/Country.cs
@@ -0,0 +1,10 @@
+using System.Collections.Generic;
+
+namespace EFModeling.DataSeeding;
+
+public class Country
+{
+    public int CountryId { get; set; }
+    public string Name { get; set; }
+    public virtual ICollection<Language> OfficialLanguages { get; set; }
+}
diff --git a/samples/core/Modeling/DataSeeding/DataSeeding.csproj b/samples/core/Modeling/DataSeeding/DataSeeding.csproj
new file mode 100644
index 0000000000..adc0cf6441
--- /dev/null
+++ b/samples/core/Modeling/DataSeeding/DataSeeding.csproj
@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFModeling.DataSeeding</RootNamespace>
+    <AssemblyName>EFModeling.DataSeeding</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Modeling/DataSeeding/DataSeedingContext.cs b/samples/core/Modeling/DataSeeding/DataSeedingContext.cs
new file mode 100644
index 0000000000..182fa97b31
--- /dev/null
+++ b/samples/core/Modeling/DataSeeding/DataSeedingContext.cs
@@ -0,0 +1,35 @@
+using System.Linq;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.DataSeeding;
+
+public class DataSeedingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    #region ContextOptionSeeding
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFDataSeeding;Trusted_Connection=True;ConnectRetryCount=0")
+            .UseSeeding((context, _) =>
+            {
+                var testBlog = context.Set<Blog>().FirstOrDefault(b => b.Url == "http://test.com");
+                if (testBlog == null)
+                {
+                    context.Set<Blog>().Add(new Blog { Url = "http://test.com" });
+                    context.SaveChanges();
+                }
+            })
+            .UseAsyncSeeding(async (context, _, cancellationToken) =>
+            {
+                var testBlog = await context.Set<Blog>().FirstOrDefaultAsync(b => b.Url == "http://test.com", cancellationToken);
+                if (testBlog == null)
+                {
+                    context.Set<Blog>().Add(new Blog { Url = "http://test.com" });
+                    await context.SaveChangesAsync(cancellationToken);
+                }
+            });
+    #endregion
+}
+
diff --git a/samples/core/Modeling/DataSeeding/Language.cs b/samples/core/Modeling/DataSeeding/Language.cs
new file mode 100644
index 0000000000..03d7dd7554
--- /dev/null
+++ b/samples/core/Modeling/DataSeeding/Language.cs
@@ -0,0 +1,12 @@
+using System.Collections.Generic;
+
+namespace EFModeling.DataSeeding;
+
+public class Language
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+
+    public LanguageDetails Details { get; set; }
+    public List<Country> UsedIn { get; set; }
+}
diff --git a/samples/core/Modeling/DataSeeding/LanguageDetails.cs b/samples/core/Modeling/DataSeeding/LanguageDetails.cs
new file mode 100644
index 0000000000..dc81cf2a84
--- /dev/null
+++ b/samples/core/Modeling/DataSeeding/LanguageDetails.cs
@@ -0,0 +1,9 @@
+namespace EFModeling.DataSeeding;
+
+public class LanguageDetails
+{
+    public bool Phonetic { get; set; }
+    public bool Tonal { get; set; }
+    public int PhonemesCount { get; set; }
+}
+
diff --git a/samples/core/Modeling/DataSeeding/ManagingDataContext.cs b/samples/core/Modeling/DataSeeding/ManagingDataContext.cs
new file mode 100644
index 0000000000..37c3e359fd
--- /dev/null
+++ b/samples/core/Modeling/DataSeeding/ManagingDataContext.cs
@@ -0,0 +1,68 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.DataSeeding;
+
+public class ManagingDataContext : DbContext
+{
+    public DbSet<Country> Countries { get; set; }
+    public DbSet<City> Cites { get; set; }
+    public DbSet<Language> Languages { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFManagingData;Trusted_Connection=True;ConnectRetryCount=0");
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        #region CountrySeed
+        modelBuilder.Entity<Country>(b =>
+        {
+            b.Property(x => x.Name).IsRequired();
+            b.HasData(
+                new Country { CountryId = 1, Name = "USA" },
+                new Country { CountryId = 2, Name = "Canada" },
+                new Country { CountryId = 3, Name = "Mexico" });
+        });
+        #endregion
+
+        #region CitySeed
+        modelBuilder.Entity<City>().HasData(
+            new City { Id = 1, Name = "Seattle", LocatedInId = 1 },
+            new City { Id = 2, Name = "Vancouver", LocatedInId = 2 },
+            new City { Id = 3, Name = "Mexico City", LocatedInId = 3 },
+            new City { Id = 4, Name = "Puebla", LocatedInId = 3 });
+        #endregion
+
+        #region LanguageSeed
+        modelBuilder.Entity<Language>(b =>
+        {
+            b.HasData(
+                new Language { Id = 1, Name = "English" },
+                new Language { Id = 2, Name = "French" },
+                new Language { Id = 3, Name = "Spanish" });
+
+            b.HasMany(x => x.UsedIn)
+                .WithMany(x => x.OfficialLanguages)
+                .UsingEntity(
+                    "LanguageCountry",
+                    r => r.HasOne(typeof(Country)).WithMany().HasForeignKey("CountryId").HasPrincipalKey(nameof(Country.CountryId)),
+                    l => l.HasOne(typeof(Language)).WithMany().HasForeignKey("LanguageId").HasPrincipalKey(nameof(Language.Id)),
+                    je =>
+                    {
+                        je.HasKey("LanguageId", "CountryId");
+                        je.HasData(
+                            new { LanguageId = 1, CountryId = 2 },
+                            new { LanguageId = 2, CountryId = 2 },
+                            new { LanguageId = 3, CountryId = 3 });
+                    });
+        });
+        #endregion
+
+        #region LanguageDetailsSeed
+        modelBuilder.Entity<Language>().OwnsOne(p => p.Details).HasData(
+            new { LanguageId = 1, Phonetic = false, Tonal = false, PhonemesCount = 44 },
+            new { LanguageId = 2, Phonetic = false, Tonal = false, PhonemesCount = 36 },
+            new { LanguageId = 3, Phonetic = true, Tonal = false, PhonemesCount = 24 });
+        #endregion
+    }
+}
diff --git a/samples/core/Modeling/DataSeeding/Migrations/20241016041555_Initial.Designer.cs b/samples/core/Modeling/DataSeeding/Migrations/20241016041555_Initial.Designer.cs
new file mode 100644
index 0000000000..c1789edf15
--- /dev/null
+++ b/samples/core/Modeling/DataSeeding/Migrations/20241016041555_Initial.Designer.cs
@@ -0,0 +1,251 @@
+// <auto-generated />
+using EFModeling.DataSeeding;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+#nullable disable
+
+namespace EFModeling.DataSeeding.Migrations
+{
+    [DbContext(typeof(ManagingDataContext))]
+    [Migration("20241016041555_Initial")]
+    partial class Initial
+    {
+        /// <inheritdoc />
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "9.0.0-rc.1.24451.1")
+                .HasAnnotation("Relational:MaxIdentifierLength", 128);
+
+            SqlServerModelBuilderExtensions.UseIdentityColumns(modelBuilder);
+
+            modelBuilder.Entity("EFModeling.DataSeeding.City", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("int");
+
+                    SqlServerPropertyBuilderExtensions.UseIdentityColumn(b.Property<int>("Id"));
+
+                    b.Property<int>("LocatedInId")
+                        .HasColumnType("int");
+
+                    b.Property<string>("Name")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("LocatedInId");
+
+                    b.ToTable("Cites");
+
+                    b.HasData(
+                        new
+                        {
+                            Id = 1,
+                            LocatedInId = 1,
+                            Name = "Seattle"
+                        },
+                        new
+                        {
+                            Id = 2,
+                            LocatedInId = 2,
+                            Name = "Vancouver"
+                        },
+                        new
+                        {
+                            Id = 3,
+                            LocatedInId = 3,
+                            Name = "Mexico City"
+                        },
+                        new
+                        {
+                            Id = 4,
+                            LocatedInId = 3,
+                            Name = "Puebla"
+                        });
+                });
+
+            modelBuilder.Entity("EFModeling.DataSeeding.Country", b =>
+                {
+                    b.Property<int>("CountryId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("int");
+
+                    SqlServerPropertyBuilderExtensions.UseIdentityColumn(b.Property<int>("CountryId"));
+
+                    b.Property<string>("Name")
+                        .IsRequired()
+                        .HasColumnType("nvarchar(max)");
+
+                    b.HasKey("CountryId");
+
+                    b.ToTable("Countries");
+
+                    b.HasData(
+                        new
+                        {
+                            CountryId = 1,
+                            Name = "USA"
+                        },
+                        new
+                        {
+                            CountryId = 2,
+                            Name = "Canada"
+                        },
+                        new
+                        {
+                            CountryId = 3,
+                            Name = "Mexico"
+                        });
+                });
+
+            modelBuilder.Entity("EFModeling.DataSeeding.Language", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("int");
+
+                    SqlServerPropertyBuilderExtensions.UseIdentityColumn(b.Property<int>("Id"));
+
+                    b.Property<string>("Name")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.HasKey("Id");
+
+                    b.ToTable("Languages");
+
+                    b.HasData(
+                        new
+                        {
+                            Id = 1,
+                            Name = "English"
+                        },
+                        new
+                        {
+                            Id = 2,
+                            Name = "French"
+                        },
+                        new
+                        {
+                            Id = 3,
+                            Name = "Spanish"
+                        });
+                });
+
+            modelBuilder.Entity("LanguageCountry", b =>
+                {
+                    b.Property<int>("LanguageId")
+                        .HasColumnType("int");
+
+                    b.Property<int>("CountryId")
+                        .HasColumnType("int");
+
+                    b.HasKey("LanguageId", "CountryId");
+
+                    b.HasIndex("CountryId");
+
+                    b.ToTable("LanguageCountry");
+
+                    b.HasData(
+                        new
+                        {
+                            LanguageId = 1,
+                            CountryId = 2
+                        },
+                        new
+                        {
+                            LanguageId = 2,
+                            CountryId = 2
+                        },
+                        new
+                        {
+                            LanguageId = 3,
+                            CountryId = 3
+                        });
+                });
+
+            modelBuilder.Entity("EFModeling.DataSeeding.City", b =>
+                {
+                    b.HasOne("EFModeling.DataSeeding.Country", "LocatedIn")
+                        .WithMany()
+                        .HasForeignKey("LocatedInId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("LocatedIn");
+                });
+
+            modelBuilder.Entity("EFModeling.DataSeeding.Language", b =>
+                {
+                    b.OwnsOne("EFModeling.DataSeeding.LanguageDetails", "Details", b1 =>
+                        {
+                            b1.Property<int>("LanguageId")
+                                .HasColumnType("int");
+
+                            b1.Property<int>("PhonemesCount")
+                                .HasColumnType("int");
+
+                            b1.Property<bool>("Phonetic")
+                                .HasColumnType("bit");
+
+                            b1.Property<bool>("Tonal")
+                                .HasColumnType("bit");
+
+                            b1.HasKey("LanguageId");
+
+                            b1.ToTable("Languages");
+
+                            b1.WithOwner()
+                                .HasForeignKey("LanguageId");
+
+                            b1.HasData(
+                                new
+                                {
+                                    LanguageId = 1,
+                                    PhonemesCount = 44,
+                                    Phonetic = false,
+                                    Tonal = false
+                                },
+                                new
+                                {
+                                    LanguageId = 2,
+                                    PhonemesCount = 36,
+                                    Phonetic = false,
+                                    Tonal = false
+                                },
+                                new
+                                {
+                                    LanguageId = 3,
+                                    PhonemesCount = 24,
+                                    Phonetic = true,
+                                    Tonal = false
+                                });
+                        });
+
+                    b.Navigation("Details");
+                });
+
+            modelBuilder.Entity("LanguageCountry", b =>
+                {
+                    b.HasOne("EFModeling.DataSeeding.Country", null)
+                        .WithMany()
+                        .HasForeignKey("CountryId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("EFModeling.DataSeeding.Language", null)
+                        .WithMany()
+                        .HasForeignKey("LanguageId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/samples/core/Modeling/DataSeeding/Migrations/20241016041555_Initial.cs b/samples/core/Modeling/DataSeeding/Migrations/20241016041555_Initial.cs
new file mode 100644
index 0000000000..9151deece9
--- /dev/null
+++ b/samples/core/Modeling/DataSeeding/Migrations/20241016041555_Initial.cs
@@ -0,0 +1,158 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+#pragma warning disable CA1814 // Prefer jagged arrays over multidimensional
+
+namespace EFModeling.DataSeeding.Migrations
+{
+    /// <inheritdoc />
+    public partial class Initial : Migration
+    {
+        /// <inheritdoc />
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.CreateTable(
+                name: "Countries",
+                columns: table => new
+                {
+                    CountryId = table.Column<int>(type: "int", nullable: false)
+                        .Annotation("SqlServer:Identity", "1, 1"),
+                    Name = table.Column<string>(type: "nvarchar(max)", nullable: false)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_Countries", x => x.CountryId);
+                });
+
+            migrationBuilder.CreateTable(
+                name: "Languages",
+                columns: table => new
+                {
+                    Id = table.Column<int>(type: "int", nullable: false)
+                        .Annotation("SqlServer:Identity", "1, 1"),
+                    Name = table.Column<string>(type: "nvarchar(max)", nullable: true),
+                    Details_Phonetic = table.Column<bool>(type: "bit", nullable: true),
+                    Details_Tonal = table.Column<bool>(type: "bit", nullable: true),
+                    Details_PhonemesCount = table.Column<int>(type: "int", nullable: true)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_Languages", x => x.Id);
+                });
+
+            migrationBuilder.CreateTable(
+                name: "Cites",
+                columns: table => new
+                {
+                    Id = table.Column<int>(type: "int", nullable: false)
+                        .Annotation("SqlServer:Identity", "1, 1"),
+                    Name = table.Column<string>(type: "nvarchar(max)", nullable: true),
+                    LocatedInId = table.Column<int>(type: "int", nullable: false)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_Cites", x => x.Id);
+                    table.ForeignKey(
+                        name: "FK_Cites_Countries_LocatedInId",
+                        column: x => x.LocatedInId,
+                        principalTable: "Countries",
+                        principalColumn: "CountryId",
+                        onDelete: ReferentialAction.Cascade);
+                });
+
+            migrationBuilder.CreateTable(
+                name: "LanguageCountry",
+                columns: table => new
+                {
+                    LanguageId = table.Column<int>(type: "int", nullable: false),
+                    CountryId = table.Column<int>(type: "int", nullable: false)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_LanguageCountry", x => new { x.LanguageId, x.CountryId });
+                    table.ForeignKey(
+                        name: "FK_LanguageCountry_Countries_CountryId",
+                        column: x => x.CountryId,
+                        principalTable: "Countries",
+                        principalColumn: "CountryId",
+                        onDelete: ReferentialAction.Cascade);
+                    table.ForeignKey(
+                        name: "FK_LanguageCountry_Languages_LanguageId",
+                        column: x => x.LanguageId,
+                        principalTable: "Languages",
+                        principalColumn: "Id",
+                        onDelete: ReferentialAction.Cascade);
+                });
+
+            #region CustomInsert
+            migrationBuilder.InsertData(
+                table: "Countries",
+                columns: new[] { "CountryId", "Name" },
+                values: new object[,]
+                {
+                    { 1, "USA" },
+                    { 2, "Canada" },
+                    { 3, "Mexico" }
+                });
+
+            migrationBuilder.InsertData(
+                table: "Languages",
+                columns: new[] { "Id", "Name", "Details_PhonemesCount", "Details_Phonetic", "Details_Tonal" },
+                values: new object[,]
+                {
+                    { 1, "English", 44, false, false },
+                    { 2, "French", 36, false, false },
+                    { 3, "Spanish", 24, true, false }
+                });
+
+            migrationBuilder.InsertData(
+                table: "Cites",
+                columns: new[] { "Id", "LocatedInId", "Name" },
+                values: new object[,]
+                {
+                    { 1, 1, "Seattle" },
+                    { 2, 2, "Vancouver" },
+                    { 3, 3, "Mexico City" },
+                    { 4, 3, "Puebla" }
+                });
+
+            migrationBuilder.InsertData(
+                table: "LanguageCountry",
+                columns: new[] { "CountryId", "LanguageId" },
+                values: new object[,]
+                {
+                    { 2, 1 },
+                    { 2, 2 },
+                    { 3, 3 }
+                });
+            #endregion
+
+            migrationBuilder.CreateIndex(
+                name: "IX_Cites_LocatedInId",
+                table: "Cites",
+                column: "LocatedInId");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_LanguageCountry_CountryId",
+                table: "LanguageCountry",
+                column: "CountryId");
+        }
+
+        /// <inheritdoc />
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropTable(
+                name: "Cites");
+
+            migrationBuilder.DropTable(
+                name: "LanguageCountry");
+
+            migrationBuilder.DropTable(
+                name: "Countries");
+
+            migrationBuilder.DropTable(
+                name: "Languages");
+        }
+    }
+}
diff --git a/samples/core/Modeling/DataSeeding/Migrations/ManagingDataContextModelSnapshot.cs b/samples/core/Modeling/DataSeeding/Migrations/ManagingDataContextModelSnapshot.cs
new file mode 100644
index 0000000000..d8afc9ef32
--- /dev/null
+++ b/samples/core/Modeling/DataSeeding/Migrations/ManagingDataContextModelSnapshot.cs
@@ -0,0 +1,248 @@
+// <auto-generated />
+using EFModeling.DataSeeding;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+#nullable disable
+
+namespace EFModeling.DataSeeding.Migrations
+{
+    [DbContext(typeof(ManagingDataContext))]
+    partial class ManagingDataContextModelSnapshot : ModelSnapshot
+    {
+        protected override void BuildModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "9.0.0-rc.1.24451.1")
+                .HasAnnotation("Relational:MaxIdentifierLength", 128);
+
+            SqlServerModelBuilderExtensions.UseIdentityColumns(modelBuilder);
+
+            modelBuilder.Entity("EFModeling.DataSeeding.City", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("int");
+
+                    SqlServerPropertyBuilderExtensions.UseIdentityColumn(b.Property<int>("Id"));
+
+                    b.Property<int>("LocatedInId")
+                        .HasColumnType("int");
+
+                    b.Property<string>("Name")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("LocatedInId");
+
+                    b.ToTable("Cites");
+
+                    b.HasData(
+                        new
+                        {
+                            Id = 1,
+                            LocatedInId = 1,
+                            Name = "Seattle"
+                        },
+                        new
+                        {
+                            Id = 2,
+                            LocatedInId = 2,
+                            Name = "Vancouver"
+                        },
+                        new
+                        {
+                            Id = 3,
+                            LocatedInId = 3,
+                            Name = "Mexico City"
+                        },
+                        new
+                        {
+                            Id = 4,
+                            LocatedInId = 3,
+                            Name = "Puebla"
+                        });
+                });
+
+            modelBuilder.Entity("EFModeling.DataSeeding.Country", b =>
+                {
+                    b.Property<int>("CountryId")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("int");
+
+                    SqlServerPropertyBuilderExtensions.UseIdentityColumn(b.Property<int>("CountryId"));
+
+                    b.Property<string>("Name")
+                        .IsRequired()
+                        .HasColumnType("nvarchar(max)");
+
+                    b.HasKey("CountryId");
+
+                    b.ToTable("Countries");
+
+                    b.HasData(
+                        new
+                        {
+                            CountryId = 1,
+                            Name = "USA"
+                        },
+                        new
+                        {
+                            CountryId = 2,
+                            Name = "Canada"
+                        },
+                        new
+                        {
+                            CountryId = 3,
+                            Name = "Mexico"
+                        });
+                });
+
+            modelBuilder.Entity("EFModeling.DataSeeding.Language", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("int");
+
+                    SqlServerPropertyBuilderExtensions.UseIdentityColumn(b.Property<int>("Id"));
+
+                    b.Property<string>("Name")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.HasKey("Id");
+
+                    b.ToTable("Languages");
+
+                    b.HasData(
+                        new
+                        {
+                            Id = 1,
+                            Name = "English"
+                        },
+                        new
+                        {
+                            Id = 2,
+                            Name = "French"
+                        },
+                        new
+                        {
+                            Id = 3,
+                            Name = "Spanish"
+                        });
+                });
+
+            modelBuilder.Entity("LanguageCountry", b =>
+                {
+                    b.Property<int>("LanguageId")
+                        .HasColumnType("int");
+
+                    b.Property<int>("CountryId")
+                        .HasColumnType("int");
+
+                    b.HasKey("LanguageId", "CountryId");
+
+                    b.HasIndex("CountryId");
+
+                    b.ToTable("LanguageCountry");
+
+                    b.HasData(
+                        new
+                        {
+                            LanguageId = 1,
+                            CountryId = 2
+                        },
+                        new
+                        {
+                            LanguageId = 2,
+                            CountryId = 2
+                        },
+                        new
+                        {
+                            LanguageId = 3,
+                            CountryId = 3
+                        });
+                });
+
+            modelBuilder.Entity("EFModeling.DataSeeding.City", b =>
+                {
+                    b.HasOne("EFModeling.DataSeeding.Country", "LocatedIn")
+                        .WithMany()
+                        .HasForeignKey("LocatedInId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("LocatedIn");
+                });
+
+            modelBuilder.Entity("EFModeling.DataSeeding.Language", b =>
+                {
+                    b.OwnsOne("EFModeling.DataSeeding.LanguageDetails", "Details", b1 =>
+                        {
+                            b1.Property<int>("LanguageId")
+                                .HasColumnType("int");
+
+                            b1.Property<int>("PhonemesCount")
+                                .HasColumnType("int");
+
+                            b1.Property<bool>("Phonetic")
+                                .HasColumnType("bit");
+
+                            b1.Property<bool>("Tonal")
+                                .HasColumnType("bit");
+
+                            b1.HasKey("LanguageId");
+
+                            b1.ToTable("Languages");
+
+                            b1.WithOwner()
+                                .HasForeignKey("LanguageId");
+
+                            b1.HasData(
+                                new
+                                {
+                                    LanguageId = 1,
+                                    PhonemesCount = 44,
+                                    Phonetic = false,
+                                    Tonal = false
+                                },
+                                new
+                                {
+                                    LanguageId = 2,
+                                    PhonemesCount = 36,
+                                    Phonetic = false,
+                                    Tonal = false
+                                },
+                                new
+                                {
+                                    LanguageId = 3,
+                                    PhonemesCount = 24,
+                                    Phonetic = true,
+                                    Tonal = false
+                                });
+                        });
+
+                    b.Navigation("Details");
+                });
+
+            modelBuilder.Entity("LanguageCountry", b =>
+                {
+                    b.HasOne("EFModeling.DataSeeding.Country", null)
+                        .WithMany()
+                        .HasForeignKey("CountryId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("EFModeling.DataSeeding.Language", null)
+                        .WithMany()
+                        .HasForeignKey("LanguageId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/samples/core/Modeling/DataSeeding/Post.cs b/samples/core/Modeling/DataSeeding/Post.cs
new file mode 100644
index 0000000000..e302d77637
--- /dev/null
+++ b/samples/core/Modeling/DataSeeding/Post.cs
@@ -0,0 +1,10 @@
+namespace EFModeling.DataSeeding;
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Content { get; set; }
+    public string Title { get; set; }
+    public int BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
diff --git a/samples/core/Modeling/DataSeeding/Program.cs b/samples/core/Modeling/DataSeeding/Program.cs
new file mode 100644
index 0000000000..2e9c2cbd9c
--- /dev/null
+++ b/samples/core/Modeling/DataSeeding/Program.cs
@@ -0,0 +1,58 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.DataSeeding;
+
+internal static class Program
+{
+    private static async Task Main(string[] args)
+    {
+        using (var context = new ManagingDataContext())
+        {
+            await context.Database.EnsureCreatedAsync();
+
+            await foreach (var country in context.Countries.Include(b => b.OfficialLanguages).AsAsyncEnumerable())
+            {
+                Console.WriteLine($"{country.Name} official language(s):");
+
+                if (!country.OfficialLanguages.Any())
+                {
+                    Console.WriteLine("\tNone");
+                }
+                foreach (var language in country.OfficialLanguages)
+                {
+                    Console.WriteLine($"\t{language.Name} - phenomes count: {language.Details.PhonemesCount}");
+                }
+            }
+        }
+
+        #region CustomSeeding
+        using (var context = new DataSeedingContext())
+        {
+            await context.Database.EnsureCreatedAsync();
+
+            var testBlog = await context.Blogs.FirstOrDefaultAsync(b => b.Url == "http://test.com");
+            if (testBlog == null)
+            {
+                context.Blogs.Add(new Blog { Url = "http://test.com" });
+                await context.SaveChangesAsync();
+            }
+        }
+        #endregion
+
+        using (var context = new DataSeedingContext())
+        {
+            await foreach (var blog in context.Blogs.Include(b => b.Posts).AsAsyncEnumerable())
+            {
+                Console.WriteLine($"Blog {blog.Url}");
+
+                foreach (var post in blog.Posts)
+                {
+                    Console.WriteLine($"\t{post.Title}: {post.Content}");
+                }
+            }
+        }
+    }
+}
diff --git a/samples/core/Modeling/DynamicModel/ConfigurableEntity.cs b/samples/core/Modeling/DynamicModel/ConfigurableEntity.cs
new file mode 100644
index 0000000000..7548c8e672
--- /dev/null
+++ b/samples/core/Modeling/DynamicModel/ConfigurableEntity.cs
@@ -0,0 +1,8 @@
+namespace EFModeling.DynamicModel;
+
+public class ConfigurableEntity
+{
+    public int Id { get; set; }
+    public int IntProperty { get; set; }
+    public string StringProperty { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/DynamicModel/DynamicContext.cs b/samples/core/Modeling/DynamicModel/DynamicContext.cs
new file mode 100644
index 0000000000..343e64f6f7
--- /dev/null
+++ b/samples/core/Modeling/DynamicModel/DynamicContext.cs
@@ -0,0 +1,32 @@
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+
+namespace EFModeling.DynamicModel;
+
+public class DynamicContext : DbContext
+{
+    public bool UseIntProperty { get; set; }
+
+    public DbSet<ConfigurableEntity> Entities { get; set; }
+
+    #region OnConfiguring
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .UseInMemoryDatabase("DynamicContext")
+            .ReplaceService<IModelCacheKeyFactory, DynamicModelCacheKeyFactory>();
+    #endregion
+
+    #region OnModelCreating
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        if (UseIntProperty)
+        {
+            modelBuilder.Entity<ConfigurableEntity>().Ignore(e => e.StringProperty);
+        }
+        else
+        {
+            modelBuilder.Entity<ConfigurableEntity>().Ignore(e => e.IntProperty);
+        }
+    }
+    #endregion
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/DynamicModel/DynamicModel.csproj b/samples/core/Modeling/DynamicModel/DynamicModel.csproj
new file mode 100644
index 0000000000..115b38948a
--- /dev/null
+++ b/samples/core/Modeling/DynamicModel/DynamicModel.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFModeling.DynamicModel</RootNamespace>
+    <AssemblyName>EFModeling.DynamicModel</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.InMemory" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Modeling/DynamicModel/DynamicModelCacheKeyFactory.cs b/samples/core/Modeling/DynamicModel/DynamicModelCacheKeyFactory.cs
new file mode 100644
index 0000000000..f27fbc9686
--- /dev/null
+++ b/samples/core/Modeling/DynamicModel/DynamicModelCacheKeyFactory.cs
@@ -0,0 +1,14 @@
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+
+namespace EFModeling.DynamicModel;
+
+#region DynamicModel
+public class DynamicModelCacheKeyFactory : IModelCacheKeyFactory
+{
+    public object Create(DbContext context, bool designTime)
+        => context is DynamicContext dynamicContext
+            ? (context.GetType(), dynamicContext.UseIntProperty, designTime)
+            : (object)context.GetType();
+}
+#endregion
diff --git a/samples/core/Modeling/DynamicModel/DynamicModelCacheKeyFactoryDesignTimeSupport.cs b/samples/core/Modeling/DynamicModel/DynamicModelCacheKeyFactoryDesignTimeSupport.cs
new file mode 100644
index 0000000000..619e81b50c
--- /dev/null
+++ b/samples/core/Modeling/DynamicModel/DynamicModelCacheKeyFactoryDesignTimeSupport.cs
@@ -0,0 +1,17 @@
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+
+namespace EFModeling.DynamicModel;
+
+#region DynamicModelDesignTimeSupport
+public class DynamicModelCacheKeyFactoryDesignTimeSupport : IModelCacheKeyFactory
+{
+    public object Create(DbContext context, bool designTime)
+        => context is DynamicContext dynamicContext
+            ? (context.GetType(), dynamicContext.UseIntProperty, designTime)
+            : (object)context.GetType();
+
+    public object Create(DbContext context)
+        => Create(context, false);
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/DynamicModel/Program.cs b/samples/core/Modeling/DynamicModel/Program.cs
new file mode 100644
index 0000000000..37b5bc9866
--- /dev/null
+++ b/samples/core/Modeling/DynamicModel/Program.cs
@@ -0,0 +1,42 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.DynamicModel;
+
+public class Program
+{
+    private static async Task Main()
+    {
+        // Note that because this sample uses InMemory as its provider, each model gets it's own separate store.
+
+        using (var context = new DynamicContext { UseIntProperty = true })
+        {
+            context.Entities.Add(new ConfigurableEntity { IntProperty = 44, StringProperty = "Aloha" });
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new DynamicContext { UseIntProperty = false })
+        {
+            context.Entities.Add(new ConfigurableEntity { IntProperty = 43, StringProperty = "Hola" });
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new DynamicContext { UseIntProperty = true })
+        {
+            var entity = await context.Entities.SingleAsync();
+
+            // Writes 44 and an empty string
+            Console.WriteLine($"{entity.IntProperty} {entity.StringProperty}");
+        }
+
+        using (var context = new DynamicContext { UseIntProperty = false })
+        {
+            var entity = await context.Entities.SingleAsync();
+
+            // Writes 0 and an "Hola"
+            Console.WriteLine($"{entity.IntProperty} {entity.StringProperty}");
+        }
+    }
+}
diff --git a/samples/core/Modeling/EntityProperties/DataAnnotations/Annotations.cs b/samples/core/Modeling/EntityProperties/DataAnnotations/Annotations.cs
new file mode 100644
index 0000000000..559f010502
--- /dev/null
+++ b/samples/core/Modeling/EntityProperties/DataAnnotations/Annotations.cs
@@ -0,0 +1,19 @@
+using System.ComponentModel.DataAnnotations;
+using System.ComponentModel.DataAnnotations.Schema;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityProperties.DataAnnotations.Annotations;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+[Table("Blogs")]
+public class Blog
+{
+    public int BlogId { get; set; }
+
+    [Required]
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityProperties/DataAnnotations/ColumnComment.cs b/samples/core/Modeling/EntityProperties/DataAnnotations/ColumnComment.cs
new file mode 100644
index 0000000000..34b50f0699
--- /dev/null
+++ b/samples/core/Modeling/EntityProperties/DataAnnotations/ColumnComment.cs
@@ -0,0 +1,18 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityProperties.DataAnnotations.ColumnComment;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+#region ColumnComment
+public class Blog
+{
+    public int BlogId { get; set; }
+
+    [Comment("The URL of the blog")]
+    public string Url { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityProperties/DataAnnotations/ColumnDataType.cs b/samples/core/Modeling/EntityProperties/DataAnnotations/ColumnDataType.cs
new file mode 100644
index 0000000000..83eaff4d93
--- /dev/null
+++ b/samples/core/Modeling/EntityProperties/DataAnnotations/ColumnDataType.cs
@@ -0,0 +1,22 @@
+using System.ComponentModel.DataAnnotations.Schema;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityProperties.DataAnnotations.ColumnDataType;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+#region ColumnDataType
+public class Blog
+{
+    public int BlogId { get; set; }
+
+    [Column(TypeName = "varchar(200)")]
+    public string Url { get; set; }
+
+    [Column(TypeName = "decimal(5, 2)")]
+    public decimal Rating { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityProperties/DataAnnotations/ColumnName.cs b/samples/core/Modeling/EntityProperties/DataAnnotations/ColumnName.cs
new file mode 100644
index 0000000000..08e375b0fc
--- /dev/null
+++ b/samples/core/Modeling/EntityProperties/DataAnnotations/ColumnName.cs
@@ -0,0 +1,19 @@
+using System.ComponentModel.DataAnnotations.Schema;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityProperties.DataAnnotations.ColumnName;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+#region ColumnName
+public class Blog
+{
+    [Column("blog_id")]
+    public int BlogId { get; set; }
+
+    public string Url { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityProperties/DataAnnotations/ColumnOrder.cs b/samples/core/Modeling/EntityProperties/DataAnnotations/ColumnOrder.cs
new file mode 100644
index 0000000000..f30e21b73e
--- /dev/null
+++ b/samples/core/Modeling/EntityProperties/DataAnnotations/ColumnOrder.cs
@@ -0,0 +1,32 @@
+using System.ComponentModel.DataAnnotations.Schema;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityProperties.DataAnnotations.ColumnOrder;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Employee> Employees { get; set; }
+}
+
+#region snippet_ColumnAttribute
+public class EntityBase
+{
+    [Column(Order = 0)]
+    public int Id { get; set; }
+}
+
+public class PersonBase : EntityBase
+{
+    [Column(Order = 1)]
+    public string FirstName { get; set; }
+
+    [Column(Order = 2)]
+    public string LastName { get; set; }
+}
+
+public class Employee : PersonBase
+{
+    public string Department { get; set; }
+    public decimal AnnualSalary { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityProperties/DataAnnotations/IgnoreProperty.cs b/samples/core/Modeling/EntityProperties/DataAnnotations/IgnoreProperty.cs
new file mode 100644
index 0000000000..5f4d0a3d6a
--- /dev/null
+++ b/samples/core/Modeling/EntityProperties/DataAnnotations/IgnoreProperty.cs
@@ -0,0 +1,21 @@
+using System;
+using System.ComponentModel.DataAnnotations.Schema;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityProperties.DataAnnotations.IgnoreProperty;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+#region IgnoreProperty
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    [NotMapped]
+    public DateTime LoadedFromDatabase { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityProperties/DataAnnotations/MaxLength.cs b/samples/core/Modeling/EntityProperties/DataAnnotations/MaxLength.cs
new file mode 100644
index 0000000000..8e72bea51e
--- /dev/null
+++ b/samples/core/Modeling/EntityProperties/DataAnnotations/MaxLength.cs
@@ -0,0 +1,19 @@
+using System.ComponentModel.DataAnnotations;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityProperties.DataAnnotations.MaxLength;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+#region MaxLength
+public class Blog
+{
+    public int BlogId { get; set; }
+
+    [MaxLength(500)]
+    public string Url { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityProperties/DataAnnotations/PrecisionAndScale.cs b/samples/core/Modeling/EntityProperties/DataAnnotations/PrecisionAndScale.cs
new file mode 100644
index 0000000000..1bf6c8dc02
--- /dev/null
+++ b/samples/core/Modeling/EntityProperties/DataAnnotations/PrecisionAndScale.cs
@@ -0,0 +1,20 @@
+using System;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityProperties.DataAnnotations.PrecisionAndScale;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+#region PrecisionAndScale
+public class Blog
+{
+    public int BlogId { get; set; }
+    [Precision(14, 2)]
+    public decimal Score { get; set; }
+    [Precision(3)]
+    public DateTime LastUpdated { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityProperties/DataAnnotations/Required.cs b/samples/core/Modeling/EntityProperties/DataAnnotations/Required.cs
new file mode 100644
index 0000000000..2e710d0570
--- /dev/null
+++ b/samples/core/Modeling/EntityProperties/DataAnnotations/Required.cs
@@ -0,0 +1,19 @@
+using System.ComponentModel.DataAnnotations;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityProperties.DataAnnotations.Required;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+#region Required
+public class Blog
+{
+    public int BlogId { get; set; }
+
+    [Required]
+    public string Url { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityProperties/DataAnnotations/Unicode.cs b/samples/core/Modeling/EntityProperties/DataAnnotations/Unicode.cs
new file mode 100644
index 0000000000..c78bc29ed2
--- /dev/null
+++ b/samples/core/Modeling/EntityProperties/DataAnnotations/Unicode.cs
@@ -0,0 +1,21 @@
+using System.ComponentModel.DataAnnotations;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityProperties.DataAnnotations.Unicode;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Book> Books { get; set; }
+}
+
+#region Unicode
+public class Book
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+
+    [Unicode(false)]
+    [MaxLength(22)]
+    public string Isbn { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityProperties/EntityProperties.csproj b/samples/core/Modeling/EntityProperties/EntityProperties.csproj
new file mode 100644
index 0000000000..1c79c73e8b
--- /dev/null
+++ b/samples/core/Modeling/EntityProperties/EntityProperties.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFModeling.EntityProperties</RootNamespace>
+    <AssemblyName>EFModeling.EntityProperties</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Modeling/EntityProperties/FluentAPI/ColumnComment.cs b/samples/core/Modeling/EntityProperties/FluentAPI/ColumnComment.cs
new file mode 100644
index 0000000000..e8360ee1a9
--- /dev/null
+++ b/samples/core/Modeling/EntityProperties/FluentAPI/ColumnComment.cs
@@ -0,0 +1,23 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityProperties.FluentAPI.ColumnComment;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region ColumnComment
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .Property(b => b.Url)
+            .HasComment("The URL of the blog");
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityProperties/FluentAPI/ColumnDataType.cs b/samples/core/Modeling/EntityProperties/FluentAPI/ColumnDataType.cs
new file mode 100644
index 0000000000..e355ca8312
--- /dev/null
+++ b/samples/core/Modeling/EntityProperties/FluentAPI/ColumnDataType.cs
@@ -0,0 +1,27 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityProperties.FluentAPI.DataType;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region ColumnDataType
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>(
+            eb =>
+            {
+                eb.Property(b => b.Url).HasColumnType("varchar(200)");
+                eb.Property(b => b.Rating).HasColumnType("decimal(5, 2)");
+            });
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public decimal Rating { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityProperties/FluentAPI/ColumnName.cs b/samples/core/Modeling/EntityProperties/FluentAPI/ColumnName.cs
new file mode 100644
index 0000000000..8a65ee8b80
--- /dev/null
+++ b/samples/core/Modeling/EntityProperties/FluentAPI/ColumnName.cs
@@ -0,0 +1,23 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityProperties.FluentAPI.ColumnName;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region ColumnName
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .Property(b => b.BlogId)
+            .HasColumnName("blog_id");
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityProperties/FluentAPI/ColumnOrder.cs b/samples/core/Modeling/EntityProperties/FluentAPI/ColumnOrder.cs
new file mode 100644
index 0000000000..9d04ea3273
--- /dev/null
+++ b/samples/core/Modeling/EntityProperties/FluentAPI/ColumnOrder.cs
@@ -0,0 +1,42 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityProperties.FluentAPI.ColumnOrder;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Employee> Employees { get; set; }
+
+    #region snippet_HasColumnOrder
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Employee>(x =>
+        {
+            x.Property(b => b.Id)
+                .HasColumnOrder(0);
+
+            x.Property(b => b.FirstName)
+                .HasColumnOrder(1);
+
+            x.Property(b => b.LastName)
+                .HasColumnOrder(2);
+        });
+    }
+    #endregion
+}
+
+public class EntityBase
+{
+    public int Id { get; set; }
+}
+
+public class PersonBase : EntityBase
+{
+    public string FirstName { get; set; }
+    public string LastName { get; set; }
+}
+
+public class Employee : PersonBase
+{
+    public string Department { get; set; }
+    public decimal AnnualSalary { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityProperties/FluentAPI/IgnoreProperty.cs b/samples/core/Modeling/EntityProperties/FluentAPI/IgnoreProperty.cs
new file mode 100644
index 0000000000..16b1fcbbd5
--- /dev/null
+++ b/samples/core/Modeling/EntityProperties/FluentAPI/IgnoreProperty.cs
@@ -0,0 +1,25 @@
+using System;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityProperties.FluentAPI.IgnoreProperty;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region IgnoreProperty
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .Ignore(b => b.LoadedFromDatabase);
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public DateTime LoadedFromDatabase { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityProperties/FluentAPI/MaxLength.cs b/samples/core/Modeling/EntityProperties/FluentAPI/MaxLength.cs
new file mode 100644
index 0000000000..bf724359e0
--- /dev/null
+++ b/samples/core/Modeling/EntityProperties/FluentAPI/MaxLength.cs
@@ -0,0 +1,23 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityProperties.FluentAPI.MaxLength;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region MaxLength
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .Property(b => b.Url)
+            .HasMaxLength(500);
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityProperties/FluentAPI/PrecisionAndScale.cs b/samples/core/Modeling/EntityProperties/FluentAPI/PrecisionAndScale.cs
new file mode 100644
index 0000000000..5164a9476c
--- /dev/null
+++ b/samples/core/Modeling/EntityProperties/FluentAPI/PrecisionAndScale.cs
@@ -0,0 +1,29 @@
+using System;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityProperties.FluentAPI.PrecisionAndScale;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region PrecisionAndScale
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .Property(b => b.Score)
+            .HasPrecision(14, 2);
+
+        modelBuilder.Entity<Blog>()
+            .Property(b => b.LastUpdated)
+            .HasPrecision(3);
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public decimal Score { get; set; }
+    public DateTime LastUpdated { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityProperties/FluentAPI/Required.cs b/samples/core/Modeling/EntityProperties/FluentAPI/Required.cs
new file mode 100644
index 0000000000..494016d0be
--- /dev/null
+++ b/samples/core/Modeling/EntityProperties/FluentAPI/Required.cs
@@ -0,0 +1,23 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityProperties.FluentAPI.Required;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region Required
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .Property(b => b.Url)
+            .IsRequired();
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityProperties/FluentAPI/Unicode.cs b/samples/core/Modeling/EntityProperties/FluentAPI/Unicode.cs
new file mode 100644
index 0000000000..6cd492dad8
--- /dev/null
+++ b/samples/core/Modeling/EntityProperties/FluentAPI/Unicode.cs
@@ -0,0 +1,25 @@
+using System.ComponentModel.DataAnnotations;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityProperties.FluentAPI.Unicode;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Book> Books { get; set; }
+
+    #region Unicode
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Book>()
+            .Property(b => b.Isbn)
+            .IsUnicode(false);
+    }
+    #endregion
+}
+
+public class Book
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+    public string Isbn { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityProperties/Program.cs b/samples/core/Modeling/EntityProperties/Program.cs
new file mode 100644
index 0000000000..b202f1feee
--- /dev/null
+++ b/samples/core/Modeling/EntityProperties/Program.cs
@@ -0,0 +1,8 @@
+namespace EFModeling.EntityProperties;
+
+internal class Program
+{
+    private static void Main(string[] args)
+    {
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityTypes/DataAnnotations/IgnoreType.cs b/samples/core/Modeling/EntityTypes/DataAnnotations/IgnoreType.cs
new file mode 100644
index 0000000000..5581ee3999
--- /dev/null
+++ b/samples/core/Modeling/EntityTypes/DataAnnotations/IgnoreType.cs
@@ -0,0 +1,26 @@
+using System;
+using System.ComponentModel.DataAnnotations.Schema;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityTypes.DataAnnotations.IgnoreType;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public BlogMetadata Metadata { get; set; }
+}
+
+#region IgnoreType
+[NotMapped]
+public class BlogMetadata
+{
+    public DateTime LoadedFromDatabase { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityTypes/DataAnnotations/TableComment.cs b/samples/core/Modeling/EntityTypes/DataAnnotations/TableComment.cs
new file mode 100644
index 0000000000..1da9c2a4d4
--- /dev/null
+++ b/samples/core/Modeling/EntityTypes/DataAnnotations/TableComment.cs
@@ -0,0 +1,17 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityTypes.DataAnnotations.TableComment;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+#region TableComment
+[Comment("Blogs managed on the website")]
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityTypes/DataAnnotations/TableName.cs b/samples/core/Modeling/EntityTypes/DataAnnotations/TableName.cs
new file mode 100644
index 0000000000..090b5c330a
--- /dev/null
+++ b/samples/core/Modeling/EntityTypes/DataAnnotations/TableName.cs
@@ -0,0 +1,18 @@
+using System.ComponentModel.DataAnnotations.Schema;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityTypes.DataAnnotations.TableName;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+#region TableName
+[Table("blogs")]
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityTypes/DataAnnotations/TableNameAndSchema.cs b/samples/core/Modeling/EntityTypes/DataAnnotations/TableNameAndSchema.cs
new file mode 100644
index 0000000000..b89826e259
--- /dev/null
+++ b/samples/core/Modeling/EntityTypes/DataAnnotations/TableNameAndSchema.cs
@@ -0,0 +1,18 @@
+using System.ComponentModel.DataAnnotations.Schema;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityTypes.DataAnnotations.TableNameAndSchema;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+#region TableNameAndSchema
+[Table("blogs", Schema = "blogging")]
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityTypes/EntityTypes.cs b/samples/core/Modeling/EntityTypes/EntityTypes.cs
new file mode 100644
index 0000000000..88b8beb154
--- /dev/null
+++ b/samples/core/Modeling/EntityTypes/EntityTypes.cs
@@ -0,0 +1,67 @@
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityTypes;
+
+#region EntityTypes
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<AuditEntry>();
+    }
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public List<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public Blog Blog { get; set; }
+}
+
+public class AuditEntry
+{
+    public int AuditEntryId { get; set; }
+    public string Username { get; set; }
+    public string Action { get; set; }
+}
+#endregion
+
+#region BlogWithMultiplePostsEntity
+public class BlogWithMultiplePosts
+{
+    public string Url { get; set; }
+    public int PostCount { get; set; }
+}
+#endregion
+
+public class MyContextWithFunctionMapping : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        #region QueryableFunctionConfigurationToFunction
+        modelBuilder.Entity<BlogWithMultiplePosts>().HasNoKey().ToFunction("BlogsWithMultiplePosts");
+        #endregion
+    }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder.UseSqlServer(
+            @"Server=(localdb)\mssqllocaldb;Database=EFModeling.EntityTypeToFunctionMapping;Trusted_Connection=True;ConnectRetryCount=0");
+    }
+}
diff --git a/samples/core/Modeling/EntityTypes/EntityTypes.csproj b/samples/core/Modeling/EntityTypes/EntityTypes.csproj
new file mode 100644
index 0000000000..3f444cbd9a
--- /dev/null
+++ b/samples/core/Modeling/EntityTypes/EntityTypes.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFModeling.EntityTypes</RootNamespace>
+    <AssemblyName>EFModeling.EntityTypes</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Modeling/EntityTypes/FluentAPI/DefaultSchema.cs b/samples/core/Modeling/EntityTypes/FluentAPI/DefaultSchema.cs
new file mode 100644
index 0000000000..7369bb2fae
--- /dev/null
+++ b/samples/core/Modeling/EntityTypes/FluentAPI/DefaultSchema.cs
@@ -0,0 +1,21 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityTypes.FluentAPI.DefaultSchema;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region DefaultSchema
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.HasDefaultSchema("blogging");
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityTypes/FluentAPI/IgnoreType.cs b/samples/core/Modeling/EntityTypes/FluentAPI/IgnoreType.cs
new file mode 100644
index 0000000000..583ed93722
--- /dev/null
+++ b/samples/core/Modeling/EntityTypes/FluentAPI/IgnoreType.cs
@@ -0,0 +1,29 @@
+using System;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityTypes.FluentAPI.IgnoreType;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region IgnoreType
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Ignore<BlogMetadata>();
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public BlogMetadata Metadata { get; set; }
+}
+
+public class BlogMetadata
+{
+    public DateTime LoadedFromDatabase { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityTypes/FluentAPI/TableComment.cs b/samples/core/Modeling/EntityTypes/FluentAPI/TableComment.cs
new file mode 100644
index 0000000000..58fb16a78a
--- /dev/null
+++ b/samples/core/Modeling/EntityTypes/FluentAPI/TableComment.cs
@@ -0,0 +1,22 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityTypes.FluentAPI.TableComment;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region TableComment
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>().ToTable(
+            tableBuilder => tableBuilder.HasComment("Blogs managed on the website"));
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
diff --git a/samples/core/Modeling/EntityTypes/FluentAPI/TableExcludeFromMigrations.cs b/samples/core/Modeling/EntityTypes/FluentAPI/TableExcludeFromMigrations.cs
new file mode 100644
index 0000000000..3d8dce3af1
--- /dev/null
+++ b/samples/core/Modeling/EntityTypes/FluentAPI/TableExcludeFromMigrations.cs
@@ -0,0 +1,22 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityTypes.FluentAPI.TableExcludeFromMigrations;
+
+internal class MyContext : DbContext
+{
+    public DbSet<IdentityUser> Users { get; set; }
+
+    #region TableExcludeFromMigrations
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<IdentityUser>()
+            .ToTable("AspNetUsers", t => t.ExcludeFromMigrations());
+    }
+    #endregion
+}
+
+public class IdentityUser
+{
+    public string Id { get; set; }
+    public string UserName { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityTypes/FluentAPI/TableName.cs b/samples/core/Modeling/EntityTypes/FluentAPI/TableName.cs
new file mode 100644
index 0000000000..16a73077b9
--- /dev/null
+++ b/samples/core/Modeling/EntityTypes/FluentAPI/TableName.cs
@@ -0,0 +1,22 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityTypes.FluentAPI.TableName;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region TableName
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .ToTable("blogs");
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityTypes/FluentAPI/TableNameAndSchema.cs b/samples/core/Modeling/EntityTypes/FluentAPI/TableNameAndSchema.cs
new file mode 100644
index 0000000000..991845d5de
--- /dev/null
+++ b/samples/core/Modeling/EntityTypes/FluentAPI/TableNameAndSchema.cs
@@ -0,0 +1,22 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityTypes.FluentAPI.TableNameAndSchema;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region TableNameAndSchema
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .ToTable("blogs", schema: "blogging");
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityTypes/FluentAPI/ViewNameAndSchema.cs b/samples/core/Modeling/EntityTypes/FluentAPI/ViewNameAndSchema.cs
new file mode 100644
index 0000000000..4e43e7717b
--- /dev/null
+++ b/samples/core/Modeling/EntityTypes/FluentAPI/ViewNameAndSchema.cs
@@ -0,0 +1,22 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityTypes.FluentAPI.ViewNameAndSchema;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        #region ViewNameAndSchema
+        modelBuilder.Entity<Blog>()
+            .ToView("blogsView", schema: "blogging");
+        #endregion
+    }
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/EntityTypes/Program.cs b/samples/core/Modeling/EntityTypes/Program.cs
new file mode 100644
index 0000000000..c6bf4209ec
--- /dev/null
+++ b/samples/core/Modeling/EntityTypes/Program.cs
@@ -0,0 +1,35 @@
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.EntityTypes;
+
+internal class Program
+{
+    private static async Task Main(string[] args)
+    {
+        using var context = new MyContextWithFunctionMapping();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+
+        await context.Database.ExecuteSqlRawAsync(
+            @"CREATE FUNCTION dbo.BlogsWithMultiplePosts()
+                        RETURNS TABLE
+                        AS
+                        RETURN
+                        (
+                            SELECT b.Url, COUNT(p.BlogId) AS PostCount
+                            FROM Blogs AS b
+                            JOIN Posts AS p ON b.BlogId = p.BlogId
+                            GROUP BY b.BlogId, b.Url
+                            HAVING COUNT(p.BlogId) > 1
+                        )");
+
+        #region ToFunctionQuery
+        var query = from b in context.Set<BlogWithMultiplePosts>()
+                    where b.PostCount > 3
+                    select new { b.Url, b.PostCount };
+        #endregion
+        var result = await query.ToListAsync();
+    }
+}
diff --git a/samples/core/Modeling/GeneratedProperties/DataAnnotations/ValueGeneratedNever.cs b/samples/core/Modeling/GeneratedProperties/DataAnnotations/ValueGeneratedNever.cs
new file mode 100644
index 0000000000..f6d88924b7
--- /dev/null
+++ b/samples/core/Modeling/GeneratedProperties/DataAnnotations/ValueGeneratedNever.cs
@@ -0,0 +1,19 @@
+using System.ComponentModel.DataAnnotations.Schema;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.GeneratedProperties.DataAnnotations.ValueGeneratedNever;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+#region ValueGeneratedNever
+public class Blog
+{
+    [DatabaseGenerated(DatabaseGeneratedOption.None)]
+    public int BlogId { get; set; }
+
+    public string Url { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/GeneratedProperties/DataAnnotations/ValueGeneratedOnAdd.cs b/samples/core/Modeling/GeneratedProperties/DataAnnotations/ValueGeneratedOnAdd.cs
new file mode 100644
index 0000000000..3378e99bb1
--- /dev/null
+++ b/samples/core/Modeling/GeneratedProperties/DataAnnotations/ValueGeneratedOnAdd.cs
@@ -0,0 +1,21 @@
+using System;
+using System.ComponentModel.DataAnnotations.Schema;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.GeneratedProperties.DataAnnotations.ValueGeneratedOnAdd;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+#region ValueGeneratedOnAdd
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
+    public DateTime Inserted { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/GeneratedProperties/DataAnnotations/ValueGeneratedOnAddOrUpdate.cs b/samples/core/Modeling/GeneratedProperties/DataAnnotations/ValueGeneratedOnAddOrUpdate.cs
new file mode 100644
index 0000000000..a420c978f0
--- /dev/null
+++ b/samples/core/Modeling/GeneratedProperties/DataAnnotations/ValueGeneratedOnAddOrUpdate.cs
@@ -0,0 +1,21 @@
+using System;
+using System.ComponentModel.DataAnnotations.Schema;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.GeneratedProperties.DataAnnotations.ValueGeneratedOnAddOrUpdate;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+#region ValueGeneratedOnAddOrUpdate
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    [DatabaseGenerated(DatabaseGeneratedOption.Computed)]
+    public DateTime LastUpdated { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/GeneratedProperties/FluentAPI/ComputedColumn.cs b/samples/core/Modeling/GeneratedProperties/FluentAPI/ComputedColumn.cs
new file mode 100644
index 0000000000..3ca48c5f99
--- /dev/null
+++ b/samples/core/Modeling/GeneratedProperties/FluentAPI/ComputedColumn.cs
@@ -0,0 +1,32 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.GeneratedProperties.FluentAPI.ComputedColumn;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Person> People { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        #region DefaultComputedColumn
+        modelBuilder.Entity<Person>()
+            .Property(p => p.DisplayName)
+            .HasComputedColumnSql("[LastName] + ', ' + [FirstName]");
+        #endregion
+
+        #region StoredComputedColumn
+        modelBuilder.Entity<Person>()
+            .Property(p => p.NameLength)
+            .HasComputedColumnSql("LEN([LastName]) + LEN([FirstName])", stored: true);
+        #endregion
+    }
+}
+
+public class Person
+{
+    public int PersonId { get; set; }
+    public string FirstName { get; set; }
+    public string LastName { get; set; }
+    public string DisplayName { get; set; }
+    public int NameLength { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/GeneratedProperties/FluentAPI/DefaultValue.cs b/samples/core/Modeling/GeneratedProperties/FluentAPI/DefaultValue.cs
new file mode 100644
index 0000000000..18495fd83e
--- /dev/null
+++ b/samples/core/Modeling/GeneratedProperties/FluentAPI/DefaultValue.cs
@@ -0,0 +1,30 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.GeneratedProperties.FluentAPI.DefaultValue;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        #region DefaultValue
+        modelBuilder.Entity<Blog>()
+            .Property(b => b.Rating)
+            .HasDefaultValue(3);
+        #endregion
+    
+        #region DefaultValueNamed
+        modelBuilder.Entity<Blog>()
+            .Property(b => b.Rating)
+            .HasDefaultValue(3, "DF_Blog_IsActive");
+        #endregion
+    }
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public int Rating { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/GeneratedProperties/FluentAPI/DefaultValueSql.cs b/samples/core/Modeling/GeneratedProperties/FluentAPI/DefaultValueSql.cs
new file mode 100644
index 0000000000..e222167790
--- /dev/null
+++ b/samples/core/Modeling/GeneratedProperties/FluentAPI/DefaultValueSql.cs
@@ -0,0 +1,31 @@
+using System;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.GeneratedProperties.FluentAPI.DefaultValueSql;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        #region DefaultValueSql
+        modelBuilder.Entity<Blog>()
+            .Property(b => b.Created)
+            .HasDefaultValueSql("getdate()");
+        #endregion
+
+        #region DefaultValueSqlNamed
+        modelBuilder.Entity<Blog>()
+            .Property(b => b.Created)
+            .HasDefaultValueSql("getdate()" , "DF_Blog_IsActive");
+        #endregion
+    }
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public DateTime Created { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/GeneratedProperties/FluentAPI/ValueGeneratedNever.cs b/samples/core/Modeling/GeneratedProperties/FluentAPI/ValueGeneratedNever.cs
new file mode 100644
index 0000000000..2a5a981259
--- /dev/null
+++ b/samples/core/Modeling/GeneratedProperties/FluentAPI/ValueGeneratedNever.cs
@@ -0,0 +1,23 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.GeneratedProperties.FluentAPI.ValueGeneratedNever;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region ValueGeneratedNever
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .Property(b => b.BlogId)
+            .ValueGeneratedNever();
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/GeneratedProperties/FluentAPI/ValueGeneratedOnAdd.cs b/samples/core/Modeling/GeneratedProperties/FluentAPI/ValueGeneratedOnAdd.cs
new file mode 100644
index 0000000000..d38b4dd083
--- /dev/null
+++ b/samples/core/Modeling/GeneratedProperties/FluentAPI/ValueGeneratedOnAdd.cs
@@ -0,0 +1,25 @@
+using System;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.GeneratedProperties.FluentAPI.ValueGeneratedOnAdd;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region ValueGeneratedOnAdd
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .Property(b => b.Inserted)
+            .ValueGeneratedOnAdd();
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public DateTime Inserted { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/GeneratedProperties/FluentAPI/ValueGeneratedOnAddOrUpdate.cs b/samples/core/Modeling/GeneratedProperties/FluentAPI/ValueGeneratedOnAddOrUpdate.cs
new file mode 100644
index 0000000000..3e1b51fe55
--- /dev/null
+++ b/samples/core/Modeling/GeneratedProperties/FluentAPI/ValueGeneratedOnAddOrUpdate.cs
@@ -0,0 +1,25 @@
+using System;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.GeneratedProperties.FluentAPI.ValueGeneratedOnAddOrUpdate;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region ValueGeneratedOnAddOrUpdate
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .Property(b => b.LastUpdated)
+            .ValueGeneratedOnAddOrUpdate();
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public DateTime LastUpdated { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/GeneratedProperties/FluentAPI/ValueGeneratedOnAddOrUpdateWithPropertySaveBehavior.cs b/samples/core/Modeling/GeneratedProperties/FluentAPI/ValueGeneratedOnAddOrUpdateWithPropertySaveBehavior.cs
new file mode 100644
index 0000000000..3b08a68c39
--- /dev/null
+++ b/samples/core/Modeling/GeneratedProperties/FluentAPI/ValueGeneratedOnAddOrUpdateWithPropertySaveBehavior.cs
@@ -0,0 +1,26 @@
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Metadata;
+
+namespace EFModeling.GeneratedProperties.FluentAPI.ValueGeneratedOnAddOrUpdateWithPropertySaveBehavior;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region ValueGeneratedOnAddOrUpdateWithPropertySaveBehavior
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>().Property(b => b.LastUpdated)
+            .ValueGeneratedOnAddOrUpdate()
+            .Metadata.SetAfterSaveBehavior(PropertySaveBehavior.Save);
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public DateTime LastUpdated { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/GeneratedProperties/GeneratedProperties.csproj b/samples/core/Modeling/GeneratedProperties/GeneratedProperties.csproj
new file mode 100644
index 0000000000..65a94c2408
--- /dev/null
+++ b/samples/core/Modeling/GeneratedProperties/GeneratedProperties.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFModeling.GeneratedProperties</RootNamespace>
+    <AssemblyName>EFModeling.GeneratedProperties</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0-preview.5.25277.114" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Modeling/GeneratedProperties/Program.cs b/samples/core/Modeling/GeneratedProperties/Program.cs
new file mode 100644
index 0000000000..8c12a38957
--- /dev/null
+++ b/samples/core/Modeling/GeneratedProperties/Program.cs
@@ -0,0 +1,8 @@
+namespace EFModeling.GeneratedProperties;
+
+internal class Program
+{
+    private static void Main(string[] args)
+    {
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/GeneratedProperties/ValueGeneratedOnAddOrUpdate.sql b/samples/core/Modeling/GeneratedProperties/ValueGeneratedOnAddOrUpdate.sql
new file mode 100644
index 0000000000..93493278a7
--- /dev/null
+++ b/samples/core/Modeling/GeneratedProperties/ValueGeneratedOnAddOrUpdate.sql
@@ -0,0 +1,17 @@
+CREATE TRIGGER [dbo].[Blogs_UPDATE] ON [dbo].[Blogs]
+	AFTER UPDATE
+AS
+BEGIN
+	SET NOCOUNT ON;
+
+	IF ((SELECT TRIGGER_NESTLEVEL()) > 1) RETURN;
+
+	DECLARE @Id INT
+
+	SELECT @Id = INSERTED.BlogId
+	FROM INSERTED
+
+	UPDATE dbo.Blogs
+	SET LastUpdated = GETDATE()
+	WHERE BlogId = @Id
+END
\ No newline at end of file
diff --git a/samples/core/Modeling/IndexesAndConstraints/DataAnnotations/Index.cs b/samples/core/Modeling/IndexesAndConstraints/DataAnnotations/Index.cs
new file mode 100644
index 0000000000..1b4821e3b9
--- /dev/null
+++ b/samples/core/Modeling/IndexesAndConstraints/DataAnnotations/Index.cs
@@ -0,0 +1,17 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.IndexesAndConstraints.DataAnnotations.Index;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+#region Index
+[Index(nameof(Url))]
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/IndexesAndConstraints/DataAnnotations/IndexComposite.cs b/samples/core/Modeling/IndexesAndConstraints/DataAnnotations/IndexComposite.cs
new file mode 100644
index 0000000000..75a72b3abe
--- /dev/null
+++ b/samples/core/Modeling/IndexesAndConstraints/DataAnnotations/IndexComposite.cs
@@ -0,0 +1,18 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.IndexesAndConstraints.DataAnnotations.IndexComposite;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Person> People { get; set; }
+}
+
+#region Composite
+[Index(nameof(FirstName), nameof(LastName))]
+public class Person
+{
+    public int PersonId { get; set; }
+    public string FirstName { get; set; }
+    public string LastName { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/IndexesAndConstraints/DataAnnotations/IndexDescending.cs b/samples/core/Modeling/IndexesAndConstraints/DataAnnotations/IndexDescending.cs
new file mode 100644
index 0000000000..63d62f340d
--- /dev/null
+++ b/samples/core/Modeling/IndexesAndConstraints/DataAnnotations/IndexDescending.cs
@@ -0,0 +1,18 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.IndexesAndConstraints.DataAnnotations.IndexDescending;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+#region IndexDescending
+[Index(nameof(Url), nameof(Rating), AllDescending = true)]
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public int Rating { get; set; }
+}
+#endregion
diff --git a/samples/core/Modeling/IndexesAndConstraints/DataAnnotations/IndexDescendingAscending.cs b/samples/core/Modeling/IndexesAndConstraints/DataAnnotations/IndexDescendingAscending.cs
new file mode 100644
index 0000000000..9f73ca995e
--- /dev/null
+++ b/samples/core/Modeling/IndexesAndConstraints/DataAnnotations/IndexDescendingAscending.cs
@@ -0,0 +1,18 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.IndexesAndConstraints.DataAnnotations.IndexDescendingAscending;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+#region IndexDescendingAscending
+[Index(nameof(Url), nameof(Rating), IsDescending = new[] { false, true })]
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public int Rating { get; set; }
+}
+#endregion
diff --git a/samples/core/Modeling/IndexesAndConstraints/DataAnnotations/IndexName.cs b/samples/core/Modeling/IndexesAndConstraints/DataAnnotations/IndexName.cs
new file mode 100644
index 0000000000..b3a7415712
--- /dev/null
+++ b/samples/core/Modeling/IndexesAndConstraints/DataAnnotations/IndexName.cs
@@ -0,0 +1,17 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.IndexesAndConstraints.DataAnnotations.IndexName;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+#region IndexName
+[Index(nameof(Url), Name = "Index_Url")]
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/IndexesAndConstraints/DataAnnotations/IndexUnique.cs b/samples/core/Modeling/IndexesAndConstraints/DataAnnotations/IndexUnique.cs
new file mode 100644
index 0000000000..245cada726
--- /dev/null
+++ b/samples/core/Modeling/IndexesAndConstraints/DataAnnotations/IndexUnique.cs
@@ -0,0 +1,17 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.IndexesAndConstraints.DataAnnotations.IndexUnique;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+}
+
+#region IndexUnique
+[Index(nameof(Url), IsUnique = true)]
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/IndexesAndConstraints/FluentAPI/CheckConstraint.cs b/samples/core/Modeling/IndexesAndConstraints/FluentAPI/CheckConstraint.cs
new file mode 100644
index 0000000000..08abe83a9b
--- /dev/null
+++ b/samples/core/Modeling/IndexesAndConstraints/FluentAPI/CheckConstraint.cs
@@ -0,0 +1,24 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.IndexesAndConstraints.FluentAPI.CheckConstraint;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Product> Products { get; set; }
+
+    #region CheckConstraint
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder
+            .Entity<Product>()
+            .ToTable(b => b.HasCheckConstraint("CK_Prices", "[Price] > [DiscountedPrice]"));
+    }
+    #endregion
+}
+
+public class Product
+{
+    public int Id { get; set; }
+    public decimal Price { get; set; }
+    public decimal DiscountedPrice { get; set; }
+}
diff --git a/samples/core/Modeling/IndexesAndConstraints/FluentAPI/Index.cs b/samples/core/Modeling/IndexesAndConstraints/FluentAPI/Index.cs
new file mode 100644
index 0000000000..2838ca9a74
--- /dev/null
+++ b/samples/core/Modeling/IndexesAndConstraints/FluentAPI/Index.cs
@@ -0,0 +1,22 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.IndexesAndConstraints.FluentAPI.Index;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region Index
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .HasIndex(b => b.Url);
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexComposite.cs b/samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexComposite.cs
new file mode 100644
index 0000000000..893533dd10
--- /dev/null
+++ b/samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexComposite.cs
@@ -0,0 +1,23 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.IndexesAndConstraints.FluentAPI.IndexComposite;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Person> People { get; set; }
+
+    #region Composite
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Person>()
+            .HasIndex(p => new { p.FirstName, p.LastName });
+    }
+    #endregion
+}
+
+public class Person
+{
+    public int PersonId { get; set; }
+    public string FirstName { get; set; }
+    public string LastName { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexDescending.cs b/samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexDescending.cs
new file mode 100644
index 0000000000..b3e841bcc5
--- /dev/null
+++ b/samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexDescending.cs
@@ -0,0 +1,24 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.IndexesAndConstraints.FluentAPI.IndexDescending;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region IndexDescending
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .HasIndex(b => new { b.Url, b.Rating })
+            .IsDescending();
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public int Rating { get; set; }
+}
diff --git a/samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexDescendingAscending.cs b/samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexDescendingAscending.cs
new file mode 100644
index 0000000000..14fbf75d96
--- /dev/null
+++ b/samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexDescendingAscending.cs
@@ -0,0 +1,24 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.IndexesAndConstraints.FluentAPI.IndexDescendingAscending;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region IndexDescendingAscending
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .HasIndex(b => new { b.Url, b.Rating })
+            .IsDescending(false, true);
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public int Rating { get; set; }
+}
diff --git a/samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexFilter.cs b/samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexFilter.cs
new file mode 100644
index 0000000000..cfa2cf7dc6
--- /dev/null
+++ b/samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexFilter.cs
@@ -0,0 +1,23 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.IndexesAndConstraints.FluentAPI.IndexFilter;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region IndexFilter
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .HasIndex(b => b.Url)
+            .HasFilter("[Url] IS NOT NULL");
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexInclude.cs b/samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexInclude.cs
new file mode 100644
index 0000000000..02e49359fc
--- /dev/null
+++ b/samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexInclude.cs
@@ -0,0 +1,27 @@
+using System;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.IndexesAndConstraints.FluentAPI.IndexInclude;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Post> Posts { get; set; }
+
+    #region IndexInclude
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>()
+            .HasIndex(p => p.Url)
+            .IncludeProperties(
+                p => new { p.Title, p.PublishedOn });
+    }
+    #endregion
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Url { get; set; }
+    public string Title { get; set; }
+    public DateTime PublishedOn { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexName.cs b/samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexName.cs
new file mode 100644
index 0000000000..d3093e7417
--- /dev/null
+++ b/samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexName.cs
@@ -0,0 +1,23 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.IndexesAndConstraints.FluentAPI.IndexName;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region IndexName
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .HasIndex(b => b.Url)
+            .HasDatabaseName("Index_Url");
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexNoFilter.cs b/samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexNoFilter.cs
new file mode 100644
index 0000000000..9e0cdc53c3
--- /dev/null
+++ b/samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexNoFilter.cs
@@ -0,0 +1,24 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.IndexesAndConstraints.FluentAPI.IndexNoFilter;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region IndexNoFilter
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .HasIndex(b => b.Url)
+            .IsUnique()
+            .HasFilter(null);
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexUnique.cs b/samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexUnique.cs
new file mode 100644
index 0000000000..7c11320575
--- /dev/null
+++ b/samples/core/Modeling/IndexesAndConstraints/FluentAPI/IndexUnique.cs
@@ -0,0 +1,23 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.IndexesAndConstraints.FluentAPI.IndexUnique;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region IndexUnique
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .HasIndex(b => b.Url)
+            .IsUnique();
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/IndexesAndConstraints/IndexesAndConstraints.csproj b/samples/core/Modeling/IndexesAndConstraints/IndexesAndConstraints.csproj
new file mode 100644
index 0000000000..beb5d93d11
--- /dev/null
+++ b/samples/core/Modeling/IndexesAndConstraints/IndexesAndConstraints.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFModeling.IndexesAndConstraints</RootNamespace>
+    <AssemblyName>EFModeling.IndexesAndConstraints</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Modeling/IndexesAndConstraints/Program.cs b/samples/core/Modeling/IndexesAndConstraints/Program.cs
new file mode 100644
index 0000000000..db90515f4a
--- /dev/null
+++ b/samples/core/Modeling/IndexesAndConstraints/Program.cs
@@ -0,0 +1,8 @@
+namespace EFModeling.IndexesAndConstraints;
+
+internal class Program
+{
+    private static void Main(string[] args)
+    {
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/Inheritance/FluentAPI/DiscriminatorConfiguration.cs b/samples/core/Modeling/Inheritance/FluentAPI/DiscriminatorConfiguration.cs
new file mode 100644
index 0000000000..bc2a114b07
--- /dev/null
+++ b/samples/core/Modeling/Inheritance/FluentAPI/DiscriminatorConfiguration.cs
@@ -0,0 +1,29 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Inheritance.FluentAPI.DiscriminatorConfiguration;
+
+public class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region DiscriminatorConfiguration
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .HasDiscriminator<string>("blog_type")
+            .HasValue<Blog>("blog_base")
+            .HasValue<RssBlog>("blog_rss");
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
+
+public class RssBlog : Blog
+{
+    public string RssUrl { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/Inheritance/FluentAPI/DiscriminatorMappingIncomplete.cs b/samples/core/Modeling/Inheritance/FluentAPI/DiscriminatorMappingIncomplete.cs
new file mode 100644
index 0000000000..b05a9cd7bb
--- /dev/null
+++ b/samples/core/Modeling/Inheritance/FluentAPI/DiscriminatorMappingIncomplete.cs
@@ -0,0 +1,28 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Inheritance.FluentAPI.DiscriminatorMappingIncomplete;
+
+public class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region DiscriminatorMappingIncomplete
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .HasDiscriminator()
+            .IsComplete(false);
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
+
+public class RssBlog : Blog
+{
+    public string RssUrl { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/Inheritance/FluentAPI/DiscriminatorPropertyConfiguration.cs b/samples/core/Modeling/Inheritance/FluentAPI/DiscriminatorPropertyConfiguration.cs
new file mode 100644
index 0000000000..b046c11ba5
--- /dev/null
+++ b/samples/core/Modeling/Inheritance/FluentAPI/DiscriminatorPropertyConfiguration.cs
@@ -0,0 +1,28 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Inheritance.FluentAPI.DiscriminatorPropertyConfiguration;
+
+public class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region DiscriminatorPropertyConfiguration
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .Property("blog_type")
+            .HasMaxLength(200);
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
+
+public class RssBlog : Blog
+{
+    public string RssUrl { get; set; }
+}
diff --git a/samples/core/Modeling/Inheritance/FluentAPI/NonShadowDiscriminator.cs b/samples/core/Modeling/Inheritance/FluentAPI/NonShadowDiscriminator.cs
new file mode 100644
index 0000000000..e9bd45a656
--- /dev/null
+++ b/samples/core/Modeling/Inheritance/FluentAPI/NonShadowDiscriminator.cs
@@ -0,0 +1,35 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Inheritance.FluentAPI.NonShadowDiscriminator;
+
+public class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region NonShadowDiscriminator
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .HasDiscriminator(b => b.BlogType);
+
+        modelBuilder.Entity<Blog>()
+            .Property(e => e.BlogType)
+            .HasMaxLength(200)
+            .HasColumnName("blog_type");
+            
+        modelBuilder.Entity<RssBlog>();
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public string BlogType { get; set; }
+}
+
+public class RssBlog : Blog
+{
+    public string RssUrl { get; set; }
+}
diff --git a/samples/core/Modeling/Inheritance/FluentAPI/SharedTPHColumns.cs b/samples/core/Modeling/Inheritance/FluentAPI/SharedTPHColumns.cs
new file mode 100644
index 0000000000..e4468f62dc
--- /dev/null
+++ b/samples/core/Modeling/Inheritance/FluentAPI/SharedTPHColumns.cs
@@ -0,0 +1,36 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Inheritance.FluentAPI.SharedTPHColumns;
+
+#region SharedTPHColumns
+public class MyContext : DbContext
+{
+    public DbSet<BlogBase> Blogs { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .Property(b => b.Url)
+            .HasColumnName("Url");
+
+        modelBuilder.Entity<RssBlog>()
+            .Property(b => b.Url)
+            .HasColumnName("Url");
+    }
+}
+
+public abstract class BlogBase
+{
+    public int BlogId { get; set; }
+}
+
+public class Blog : BlogBase
+{
+    public string Url { get; set; }
+}
+
+public class RssBlog : BlogBase
+{
+    public string Url { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/Inheritance/FluentAPI/TPCConfiguration.cs b/samples/core/Modeling/Inheritance/FluentAPI/TPCConfiguration.cs
new file mode 100644
index 0000000000..e14a4a60f0
--- /dev/null
+++ b/samples/core/Modeling/Inheritance/FluentAPI/TPCConfiguration.cs
@@ -0,0 +1,54 @@
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Metadata;
+
+namespace EFModeling.Inheritance.FluentAPI.TPCConfiguration;
+
+public class MyContext : DbContext
+{
+    public MyContext(DbContextOptions<MyContext> options)
+        : base(options)
+    {
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        #region TPCConfiguration
+        modelBuilder.Entity<Blog>().UseTpcMappingStrategy()
+            .ToTable("Blogs");
+        modelBuilder.Entity<RssBlog>()
+            .ToTable("RssBlogs");
+        #endregion
+
+        #region Metadata
+        foreach (var entityType in modelBuilder.Model.GetEntityTypes())
+        {
+            var tableIdentifier = StoreObjectIdentifier.Create(entityType, StoreObjectType.Table);
+
+            Console.WriteLine($"{entityType.DisplayName()}\t\t{tableIdentifier}");
+            Console.WriteLine(" Property\tColumn");
+
+            foreach (var property in entityType.GetProperties())
+            {
+                var columnName = property.GetColumnName(tableIdentifier.Value);
+                Console.WriteLine($" {property.Name,-10}\t{columnName}");
+            }
+
+            Console.WriteLine();
+        }
+        #endregion
+    }
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
+
+public class RssBlog : Blog
+{
+    public string RssUrl { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/Inheritance/FluentAPI/TPTConfiguration.cs b/samples/core/Modeling/Inheritance/FluentAPI/TPTConfiguration.cs
new file mode 100644
index 0000000000..8d8f6bdc8a
--- /dev/null
+++ b/samples/core/Modeling/Inheritance/FluentAPI/TPTConfiguration.cs
@@ -0,0 +1,52 @@
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Metadata;
+
+namespace EFModeling.Inheritance.FluentAPI.TPTConfiguration;
+
+public class MyContext : DbContext
+{
+    public MyContext(DbContextOptions<MyContext> options)
+        : base(options)
+    {
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        #region TPTConfiguration
+        modelBuilder.Entity<Blog>().ToTable("Blogs");
+        modelBuilder.Entity<RssBlog>().ToTable("RssBlogs");
+        #endregion
+
+        #region Metadata
+        foreach (var entityType in modelBuilder.Model.GetEntityTypes())
+        {
+            var tableIdentifier = StoreObjectIdentifier.Create(entityType, StoreObjectType.Table);
+
+            Console.WriteLine($"{entityType.DisplayName()}\t\t{tableIdentifier}");
+            Console.WriteLine(" Property\tColumn");
+
+            foreach (var property in entityType.GetProperties())
+            {
+                var columnName = property.GetColumnName(tableIdentifier.Value);
+                Console.WriteLine($" {property.Name,-10}\t{columnName}");
+            }
+
+            Console.WriteLine();
+        }
+        #endregion
+    }
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
+
+public class RssBlog : Blog
+{
+    public string RssUrl { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/Inheritance/Inheritance.csproj b/samples/core/Modeling/Inheritance/Inheritance.csproj
new file mode 100644
index 0000000000..7bcbffe0eb
--- /dev/null
+++ b/samples/core/Modeling/Inheritance/Inheritance.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFModeling.Inheritance</RootNamespace>
+    <AssemblyName>EFModeling.Inheritance</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Modeling/Inheritance/InheritanceDbSets.cs b/samples/core/Modeling/Inheritance/InheritanceDbSets.cs
new file mode 100644
index 0000000000..1130464a7f
--- /dev/null
+++ b/samples/core/Modeling/Inheritance/InheritanceDbSets.cs
@@ -0,0 +1,22 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Inheritance.InheritanceDbSets;
+
+#region InheritanceDbSets
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<RssBlog> RssBlogs { get; set; }
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
+
+public class RssBlog : Blog
+{
+    public string RssUrl { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/Inheritance/Program.cs b/samples/core/Modeling/Inheritance/Program.cs
new file mode 100644
index 0000000000..487792cbf9
--- /dev/null
+++ b/samples/core/Modeling/Inheritance/Program.cs
@@ -0,0 +1,8 @@
+namespace EFModeling.Inheritance;
+
+internal class Program
+{
+    private static void Main(string[] args)
+    {
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/KeylessEntityTypes/DataAnnotations/Keyless.cs b/samples/core/Modeling/KeylessEntityTypes/DataAnnotations/Keyless.cs
new file mode 100644
index 0000000000..55d63351cf
--- /dev/null
+++ b/samples/core/Modeling/KeylessEntityTypes/DataAnnotations/Keyless.cs
@@ -0,0 +1,17 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.KeylessEntityTypes.DataAnnotations.Keyless;
+
+internal class BlogsContext : DbContext
+{
+    public DbSet<BlogPostsCount> BlogPostCounts { get; set; }
+}
+
+#region Keyless
+[Keyless]
+public class BlogPostsCount
+{
+    public string BlogName { get; set; }
+    public int PostCount { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/KeylessEntityTypes/FluentAPI/Keyless.cs b/samples/core/Modeling/KeylessEntityTypes/FluentAPI/Keyless.cs
new file mode 100644
index 0000000000..061cc36d63
--- /dev/null
+++ b/samples/core/Modeling/KeylessEntityTypes/FluentAPI/Keyless.cs
@@ -0,0 +1,22 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.KeylessEntityTypes.FluentAPI.Keyless;
+
+internal class BlogsContext : DbContext
+{
+    public DbSet<BlogPostsCount> BlogPostCounts { get; set; }
+
+    #region Keyless
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<BlogPostsCount>()
+            .HasNoKey();
+    }
+    #endregion
+}
+
+public class BlogPostsCount
+{
+    public string BlogName { get; set; }
+    public int PostCount { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/KeylessEntityTypes/KeylessEntityTypes.csproj b/samples/core/Modeling/KeylessEntityTypes/KeylessEntityTypes.csproj
new file mode 100644
index 0000000000..fe9970008e
--- /dev/null
+++ b/samples/core/Modeling/KeylessEntityTypes/KeylessEntityTypes.csproj
@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFModeling.KeylessEntityTypes</RootNamespace>
+    <AssemblyName>EFModeling.KeylessEntityTypes</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+    <PackageReference Include="Microsoft.Extensions.Logging.Console" Version="7.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Modeling/KeylessEntityTypes/Program.cs b/samples/core/Modeling/KeylessEntityTypes/Program.cs
new file mode 100644
index 0000000000..eeddf268fa
--- /dev/null
+++ b/samples/core/Modeling/KeylessEntityTypes/Program.cs
@@ -0,0 +1,148 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Logging;
+
+#pragma warning disable 169
+
+namespace EFModeling.KeylessEntityTypes;
+
+public class Program
+{
+    private static async Task Main()
+    {
+        await SetupDatabase();
+
+        using var db = new BloggingContext();
+
+        #region Query
+        var postCounts = await db.BlogPostCounts.ToListAsync();
+
+        foreach (var postCount in postCounts)
+        {
+            Console.WriteLine($"{postCount.BlogName} has {postCount.PostCount} posts.");
+            Console.WriteLine();
+        }
+        #endregion
+    }
+
+    private static async Task SetupDatabase()
+    {
+        using var db = new BloggingContext();
+
+        if (await db.Database.EnsureCreatedAsync())
+        {
+            db.Blogs.Add(
+                new Blog
+                {
+                    Name = "Fish Blog",
+                    Url = "http://sample.com/blogs/fish",
+                    Posts = new List<Post>
+                    {
+                        new Post { Title = "Fish care 101" },
+                        new Post { Title = "Caring for tropical fish" },
+                        new Post { Title = "Types of ornamental fish" }
+                    }
+                });
+
+            db.Blogs.Add(
+                new Blog
+                {
+                    Name = "Cats Blog",
+                    Url = "http://sample.com/blogs/cats",
+                    Posts = new List<Post>
+                    {
+                        new Post { Title = "Cat care 101" },
+                        new Post { Title = "Caring for tropical cats" },
+                        new Post { Title = "Types of ornamental cats" }
+                    }
+                });
+
+            db.Blogs.Add(
+                new Blog
+                {
+                    Name = "Catfish Blog",
+                    Url = "http://sample.com/blogs/catfish",
+                    Posts = new List<Post>
+                    {
+                        new Post { Title = "Catfish care 101" }, new Post { Title = "History of the catfish name" }
+                    }
+                });
+
+            await db.SaveChangesAsync();
+
+            #region View
+            await db.Database.ExecuteSqlRawAsync(
+                @"CREATE VIEW View_BlogPostCounts AS
+                            SELECT b.Name, Count(p.PostId) as PostCount
+                            FROM Blogs b
+                            JOIN Posts p on p.BlogId = b.BlogId
+                            GROUP BY b.Name");
+            #endregion
+        }
+    }
+}
+
+public class BloggingContext : DbContext
+{
+    private static readonly ILoggerFactory _loggerFactory
+        = LoggerFactory.Create(
+            builder => builder.AddConsole().AddFilter((c, l) => l == LogLevel.Information && !c.EndsWith("Connection")));
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    #region DbSet
+    public DbSet<BlogPostsCount> BlogPostCounts { get; set; }
+    #endregion
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .UseSqlServer(
+                @"Server=(localdb)\mssqllocaldb;Database=Sample.KeylessEntityTypes;Trusted_Connection=True;ConnectRetryCount=0")
+            .UseLoggerFactory(_loggerFactory);
+    }
+
+    #region Configuration
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder
+            .Entity<BlogPostsCount>(
+                eb =>
+                {
+                    eb.HasNoKey();
+                    eb.ToView("View_BlogPostCounts");
+                    eb.Property(v => v.BlogName).HasColumnName("Name");
+                });
+    }
+    #endregion
+}
+
+#region Entities
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Name { get; set; }
+    public string Url { get; set; }
+    public ICollection<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+    public int BlogId { get; set; }
+}
+#endregion
+
+#region KeylessEntityType
+public class BlogPostsCount
+{
+    public string BlogName { get; set; }
+    public int PostCount { get; set; }
+}
+#endregion
diff --git a/samples/core/Modeling/KeylessEntityTypes/README.md b/samples/core/Modeling/KeylessEntityTypes/README.md
new file mode 100644
index 0000000000..328730fbbd
--- /dev/null
+++ b/samples/core/Modeling/KeylessEntityTypes/README.md
@@ -0,0 +1,3 @@
+# Keyless Entity Types
+
+This sample demonstrates Keyless Entity Types. A simple Blog and Post model is created and a Keyless Entity Type is used to query a database view.
diff --git a/samples/core/Modeling/Keys/AlternateKey.cs b/samples/core/Modeling/Keys/AlternateKey.cs
new file mode 100644
index 0000000000..85289896bf
--- /dev/null
+++ b/samples/core/Modeling/Keys/AlternateKey.cs
@@ -0,0 +1,39 @@
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Keys.AlternateKey;
+
+#region AlternateKey
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>()
+            .HasOne(p => p.Blog)
+            .WithMany(b => b.Posts)
+            .HasForeignKey(p => p.BlogUrl)
+            .HasPrincipalKey(b => b.Url);
+    }
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public List<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public string BlogUrl { get; set; }
+    public Blog Blog { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/Keys/DataAnnotations/KeyComposite.cs b/samples/core/Modeling/Keys/DataAnnotations/KeyComposite.cs
new file mode 100644
index 0000000000..e1043d0a57
--- /dev/null
+++ b/samples/core/Modeling/Keys/DataAnnotations/KeyComposite.cs
@@ -0,0 +1,20 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Keys.DataAnnotations.KeyComposite;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Car> Cars { get; set; }
+}
+
+#region KeyComposite
+[PrimaryKey(nameof(State), nameof(LicensePlate))]
+public class Car
+{
+    public string State { get; set; }
+    public string LicensePlate { get; set; }
+
+    public string Make { get; set; }
+    public string Model { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/Keys/DataAnnotations/KeySingle.cs b/samples/core/Modeling/Keys/DataAnnotations/KeySingle.cs
new file mode 100644
index 0000000000..5ea3eed5ae
--- /dev/null
+++ b/samples/core/Modeling/Keys/DataAnnotations/KeySingle.cs
@@ -0,0 +1,20 @@
+using System.ComponentModel.DataAnnotations;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Keys.DataAnnotations.KeySingle;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Car> Cars { get; set; }
+}
+
+#region KeySingle
+public class Car
+{
+    [Key]
+    public string LicensePlate { get; set; }
+
+    public string Make { get; set; }
+    public string Model { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/Keys/FluentAPI/AlternateKeyComposite.cs b/samples/core/Modeling/Keys/FluentAPI/AlternateKeyComposite.cs
new file mode 100644
index 0000000000..d766f87309
--- /dev/null
+++ b/samples/core/Modeling/Keys/FluentAPI/AlternateKeyComposite.cs
@@ -0,0 +1,25 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Keys.FluentAPI.AlternateKeyComposite;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Car> Cars { get; set; }
+
+    #region AlternateKeyComposite
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Car>()
+            .HasAlternateKey(c => new { c.State, c.LicensePlate });
+    }
+    #endregion
+}
+
+public class Car
+{
+    public int CarId { get; set; }
+    public string State { get; set; }
+    public string LicensePlate { get; set; }
+    public string Make { get; set; }
+    public string Model { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/Keys/FluentAPI/AlternateKeyName.cs b/samples/core/Modeling/Keys/FluentAPI/AlternateKeyName.cs
new file mode 100644
index 0000000000..3342c33195
--- /dev/null
+++ b/samples/core/Modeling/Keys/FluentAPI/AlternateKeyName.cs
@@ -0,0 +1,25 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Keys.FluentAPI.AlternateKeyName;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Car> Cars { get; set; }
+
+    #region AlternateKeyName
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Car>()
+            .HasAlternateKey(c => c.LicensePlate)
+            .HasName("AlternateKey_LicensePlate");
+    }
+    #endregion
+}
+
+public class Car
+{
+    public int CarId { get; set; }
+    public string LicensePlate { get; set; }
+    public string Make { get; set; }
+    public string Model { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/Keys/FluentAPI/AlternateKeySingle.cs b/samples/core/Modeling/Keys/FluentAPI/AlternateKeySingle.cs
new file mode 100644
index 0000000000..f6fb6f29a8
--- /dev/null
+++ b/samples/core/Modeling/Keys/FluentAPI/AlternateKeySingle.cs
@@ -0,0 +1,24 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Keys.FluentAPI.AlternateKeySingle;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Car> Cars { get; set; }
+
+    #region AlternateKeySingle
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Car>()
+            .HasAlternateKey(c => c.LicensePlate);
+    }
+    #endregion
+}
+
+public class Car
+{
+    public int CarId { get; set; }
+    public string LicensePlate { get; set; }
+    public string Make { get; set; }
+    public string Model { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/Keys/FluentAPI/KeyComposite.cs b/samples/core/Modeling/Keys/FluentAPI/KeyComposite.cs
new file mode 100644
index 0000000000..36672b77d4
--- /dev/null
+++ b/samples/core/Modeling/Keys/FluentAPI/KeyComposite.cs
@@ -0,0 +1,25 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Keys.FluentAPI.KeyComposite;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Car> Cars { get; set; }
+
+    #region KeyComposite
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Car>()
+            .HasKey(c => new { c.State, c.LicensePlate });
+    }
+    #endregion
+}
+
+public class Car
+{
+    public string State { get; set; }
+    public string LicensePlate { get; set; }
+
+    public string Make { get; set; }
+    public string Model { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/Keys/FluentAPI/KeyName.cs b/samples/core/Modeling/Keys/FluentAPI/KeyName.cs
new file mode 100644
index 0000000000..e993a9af3f
--- /dev/null
+++ b/samples/core/Modeling/Keys/FluentAPI/KeyName.cs
@@ -0,0 +1,23 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Keys.FluentAPI.KeyName;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region KeyName
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .HasKey(b => b.BlogId)
+            .HasName("PrimaryKey_BlogId");
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/Keys/FluentAPI/KeySingle.cs b/samples/core/Modeling/Keys/FluentAPI/KeySingle.cs
new file mode 100644
index 0000000000..be6f96a50f
--- /dev/null
+++ b/samples/core/Modeling/Keys/FluentAPI/KeySingle.cs
@@ -0,0 +1,24 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Keys.FluentAPI.KeySingle;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Car> Cars { get; set; }
+
+    #region KeySingle
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Car>()
+            .HasKey(c => c.LicensePlate);
+    }
+    #endregion
+}
+
+public class Car
+{
+    public string LicensePlate { get; set; }
+
+    public string Make { get; set; }
+    public string Model { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/Keys/KeyId.cs b/samples/core/Modeling/Keys/KeyId.cs
new file mode 100644
index 0000000000..d4aae24e2c
--- /dev/null
+++ b/samples/core/Modeling/Keys/KeyId.cs
@@ -0,0 +1,27 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Keys.KeyId;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Car> Cars { get; set; }
+    public DbSet<Truck> Trucks { get; set; }
+}
+
+#region KeyId
+public class Car
+{
+    public string Id { get; set; }
+
+    public string Make { get; set; }
+    public string Model { get; set; }
+}
+
+public class Truck
+{
+    public string TruckId { get; set; }
+
+    public string Make { get; set; }
+    public string Model { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/Keys/Keys.csproj b/samples/core/Modeling/Keys/Keys.csproj
new file mode 100644
index 0000000000..5d985f68a8
--- /dev/null
+++ b/samples/core/Modeling/Keys/Keys.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFModeling.Keys</RootNamespace>
+    <AssemblyName>EFModeling.Keys</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Modeling/Keys/Program.cs b/samples/core/Modeling/Keys/Program.cs
new file mode 100644
index 0000000000..dd5b9fca0e
--- /dev/null
+++ b/samples/core/Modeling/Keys/Program.cs
@@ -0,0 +1,8 @@
+namespace EFModeling.Keys;
+
+internal class Program
+{
+    private static void Main(string[] args)
+    {
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/Misc/EntityTypeConfiguration.cs b/samples/core/Modeling/Misc/EntityTypeConfiguration.cs
new file mode 100644
index 0000000000..9a5b0900dc
--- /dev/null
+++ b/samples/core/Modeling/Misc/EntityTypeConfiguration.cs
@@ -0,0 +1,38 @@
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Metadata.Builders;
+
+namespace EFModeling.Misc.EntityTypeConfiguration;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        #region ApplyIEntityTypeConfiguration
+        new BlogEntityTypeConfiguration().Configure(modelBuilder.Entity<Blog>());
+        #endregion
+
+        #region ApplyConfigurationsFromAssembly
+        modelBuilder.ApplyConfigurationsFromAssembly(typeof(BlogEntityTypeConfiguration).Assembly);
+        #endregion
+    }
+}
+
+#region IEntityTypeConfiguration
+public class BlogEntityTypeConfiguration : IEntityTypeConfiguration<Blog>
+{
+    public void Configure(EntityTypeBuilder<Blog> builder)
+    {
+        builder
+            .Property(b => b.Url)
+            .IsRequired();
+    }
+}
+#endregion
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/Misc/Misc.csproj b/samples/core/Modeling/Misc/Misc.csproj
new file mode 100644
index 0000000000..92d7bc1771
--- /dev/null
+++ b/samples/core/Modeling/Misc/Misc.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFModeling.ConcurrencyTokens</RootNamespace>
+    <AssemblyName>EFModeling.ConcurrencyTokens</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Modeling/Misc/Program.cs b/samples/core/Modeling/Misc/Program.cs
new file mode 100644
index 0000000000..b9255f61e5
--- /dev/null
+++ b/samples/core/Modeling/Misc/Program.cs
@@ -0,0 +1,8 @@
+namespace EFModeling.Misc;
+
+internal class Program
+{
+    private static void Main(string[] args)
+    {
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/OwnedEntities/DetailedOrder.cs b/samples/core/Modeling/OwnedEntities/DetailedOrder.cs
new file mode 100644
index 0000000000..5f73856f7c
--- /dev/null
+++ b/samples/core/Modeling/OwnedEntities/DetailedOrder.cs
@@ -0,0 +1,10 @@
+namespace EFModeling.OwnedEntities;
+
+#region DetailedOrder
+public class DetailedOrder
+{
+    public int Id { get; set; }
+    public OrderDetails OrderDetails { get; set; }
+    public OrderStatus Status { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/OwnedEntities/Distributor.cs b/samples/core/Modeling/OwnedEntities/Distributor.cs
new file mode 100644
index 0000000000..a391cbb2f2
--- /dev/null
+++ b/samples/core/Modeling/OwnedEntities/Distributor.cs
@@ -0,0 +1,11 @@
+using System.Collections.Generic;
+
+namespace EFModeling.OwnedEntities;
+
+#region Distributor
+public class Distributor
+{
+    public int Id { get; set; }
+    public ICollection<StreetAddress> ShippingCenters { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/OwnedEntities/Order.cs b/samples/core/Modeling/OwnedEntities/Order.cs
new file mode 100644
index 0000000000..cd245f7ab2
--- /dev/null
+++ b/samples/core/Modeling/OwnedEntities/Order.cs
@@ -0,0 +1,9 @@
+namespace EFModeling.OwnedEntities;
+
+#region Order
+public class Order
+{
+    public int Id { get; set; }
+    public StreetAddress ShippingAddress { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/OwnedEntities/OrderDetails.cs b/samples/core/Modeling/OwnedEntities/OrderDetails.cs
new file mode 100644
index 0000000000..0599f1fb13
--- /dev/null
+++ b/samples/core/Modeling/OwnedEntities/OrderDetails.cs
@@ -0,0 +1,10 @@
+namespace EFModeling.OwnedEntities;
+
+#region OrderDetails
+public class OrderDetails
+{
+    public DetailedOrder Order { get; set; }
+    public StreetAddress BillingAddress { get; set; }
+    public StreetAddress ShippingAddress { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/OwnedEntities/OrderStatus.cs b/samples/core/Modeling/OwnedEntities/OrderStatus.cs
new file mode 100644
index 0000000000..a9f97db05a
--- /dev/null
+++ b/samples/core/Modeling/OwnedEntities/OrderStatus.cs
@@ -0,0 +1,9 @@
+namespace EFModeling.OwnedEntities;
+
+#region OrderStatus
+public enum OrderStatus
+{
+    Pending,
+    Shipped
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/OwnedEntities/OwnedEntities.csproj b/samples/core/Modeling/OwnedEntities/OwnedEntities.csproj
new file mode 100644
index 0000000000..1047ce46ec
--- /dev/null
+++ b/samples/core/Modeling/OwnedEntities/OwnedEntities.csproj
@@ -0,0 +1,18 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFModeling.OwnedEntities</RootNamespace>
+    <AssemblyName>EFModeling.OwnedEntities</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.0">
+      <PrivateAssets>all</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+    </PackageReference>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Modeling/OwnedEntities/OwnedEntityContext.cs b/samples/core/Modeling/OwnedEntities/OwnedEntityContext.cs
new file mode 100644
index 0000000000..1654f8bee4
--- /dev/null
+++ b/samples/core/Modeling/OwnedEntities/OwnedEntityContext.cs
@@ -0,0 +1,76 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.OwnedEntities;
+
+public class OwnedEntityContext : DbContext
+{
+    public DbSet<Order> Orders { get; set; }
+    public DbSet<DetailedOrder> DetailedOrders { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFOwnedEntity;Trusted_Connection=True;ConnectRetryCount=0");
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        #region OwnsOne
+        modelBuilder.Entity<Order>().OwnsOne(p => p.ShippingAddress);
+        #endregion
+
+        #region OwnsOneString
+        modelBuilder.Entity<Order>().OwnsOne(typeof(StreetAddress), "ShippingAddress");
+        #endregion
+
+        #region ColumnNames
+        modelBuilder.Entity<Order>().OwnsOne(
+            o => o.ShippingAddress,
+            sa =>
+            {
+                sa.Property(p => p.Street).HasColumnName("ShipsToStreet");
+                sa.Property(p => p.City).HasColumnName("ShipsToCity");
+            });
+        #endregion
+
+        #region Required
+        modelBuilder.Entity<Order>(
+            ob =>
+            {
+                ob.OwnsOne(
+                    o => o.ShippingAddress,
+                    sa =>
+                    {
+                        sa.Property(p => p.Street).IsRequired();
+                        sa.Property(p => p.City).IsRequired();
+                    });
+
+                ob.Navigation(o => o.ShippingAddress)
+                    .IsRequired();
+            });
+        #endregion
+
+        #region OwnsOneNested
+        modelBuilder.Entity<DetailedOrder>().OwnsOne(
+            p => p.OrderDetails, od =>
+            {
+                od.WithOwner(d => d.Order);
+                od.Navigation(d => d.Order).UsePropertyAccessMode(PropertyAccessMode.Property);
+                od.OwnsOne(c => c.BillingAddress);
+                od.OwnsOne(c => c.ShippingAddress);
+            });
+        #endregion
+
+        #region OwnsOneTable
+        modelBuilder.Entity<DetailedOrder>().OwnsOne(p => p.OrderDetails, od => { od.ToTable("OrderDetails"); });
+        #endregion
+
+        #region OwnsMany
+        modelBuilder.Entity<Distributor>().OwnsMany(
+            p => p.ShippingCenters, a =>
+            {
+                a.WithOwner().HasForeignKey("OwnerId");
+                a.Property<int>("Id");
+                a.HasKey("Id");
+            });
+        #endregion
+    }
+}
diff --git a/samples/core/Modeling/OwnedEntities/Program.cs b/samples/core/Modeling/OwnedEntities/Program.cs
new file mode 100644
index 0000000000..f0861fb10d
--- /dev/null
+++ b/samples/core/Modeling/OwnedEntities/Program.cs
@@ -0,0 +1,39 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.OwnedEntities;
+
+public static class Program
+{
+    private static async Task Main(string[] args)
+    {
+        using (var context = new OwnedEntityContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            context.Add(
+                new DetailedOrder
+                {
+                    Status = OrderStatus.Pending,
+                    OrderDetails = new OrderDetails
+                    {
+                        ShippingAddress = new StreetAddress { City = "London", Street = "221 B Baker St" },
+                        BillingAddress = new StreetAddress { City = "New York", Street = "11 Wall Street" }
+                    }
+                });
+
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new OwnedEntityContext())
+        {
+            #region DetailedOrderQuery
+            var order = await context.DetailedOrders.FirstAsync(o => o.Status == OrderStatus.Pending);
+            Console.WriteLine($"First pending order will ship to: {order.OrderDetails.ShippingAddress.City}");
+            #endregion
+        }
+    }
+}
diff --git a/samples/core/Modeling/OwnedEntities/StreetAddress.cs b/samples/core/Modeling/OwnedEntities/StreetAddress.cs
new file mode 100644
index 0000000000..ee159d7d86
--- /dev/null
+++ b/samples/core/Modeling/OwnedEntities/StreetAddress.cs
@@ -0,0 +1,12 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.OwnedEntities;
+
+#region StreetAddress
+[Owned]
+public class StreetAddress
+{
+    public string Street { get; set; }
+    public string City { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/Relationships/DataAnnotations/ForeignKey.cs b/samples/core/Modeling/Relationships/DataAnnotations/ForeignKey.cs
new file mode 100644
index 0000000000..0f285ab151
--- /dev/null
+++ b/samples/core/Modeling/Relationships/DataAnnotations/ForeignKey.cs
@@ -0,0 +1,33 @@
+using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations.Schema;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships.DataAnnotations.ForeignKey;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+}
+
+#region ForeignKey
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public List<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int BlogForeignKey { get; set; }
+
+    [ForeignKey("BlogForeignKey")]
+    public Blog Blog { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/Relationships/DataAnnotations/InverseProperty.cs b/samples/core/Modeling/Relationships/DataAnnotations/InverseProperty.cs
new file mode 100644
index 0000000000..7ed5ada143
--- /dev/null
+++ b/samples/core/Modeling/Relationships/DataAnnotations/InverseProperty.cs
@@ -0,0 +1,39 @@
+using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations.Schema;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships.DataAnnotations.InverseProperty;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Post> Posts { get; set; }
+    public DbSet<User> Users { get; set; }
+}
+
+#region InverseProperty
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int AuthorUserId { get; set; }
+    public User Author { get; set; }
+
+    public int ContributorUserId { get; set; }
+    public User Contributor { get; set; }
+}
+
+public class User
+{
+    public string UserId { get; set; }
+    public string FirstName { get; set; }
+    public string LastName { get; set; }
+
+    [InverseProperty("Author")]
+    public List<Post> AuthoredPosts { get; set; }
+
+    [InverseProperty("Contributor")]
+    public List<Post> ContributedToPosts { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/Relationships/FluentAPI/CascadeDelete.cs b/samples/core/Modeling/Relationships/FluentAPI/CascadeDelete.cs
new file mode 100644
index 0000000000..6671cdea10
--- /dev/null
+++ b/samples/core/Modeling/Relationships/FluentAPI/CascadeDelete.cs
@@ -0,0 +1,38 @@
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships.FluentAPI.CascadeDelete;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    #region CascadeDelete
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>()
+            .HasOne(p => p.Blog)
+            .WithMany(b => b.Posts)
+            .OnDelete(DeleteBehavior.Cascade);
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public List<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int? BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/Relationships/FluentAPI/CompositeForeignKey.cs b/samples/core/Modeling/Relationships/FluentAPI/CompositeForeignKey.cs
new file mode 100644
index 0000000000..5a12a9033d
--- /dev/null
+++ b/samples/core/Modeling/Relationships/FluentAPI/CompositeForeignKey.cs
@@ -0,0 +1,44 @@
+using System;
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships.FluentAPI.CompositeForeignKey;
+
+#region CompositeForeignKey
+internal class MyContext : DbContext
+{
+    public DbSet<Car> Cars { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Car>()
+            .HasKey(c => new { c.State, c.LicensePlate });
+
+        modelBuilder.Entity<RecordOfSale>()
+            .HasOne(s => s.Car)
+            .WithMany(c => c.SaleHistory)
+            .HasForeignKey(s => new { s.CarState, s.CarLicensePlate });
+    }
+}
+
+public class Car
+{
+    public string State { get; set; }
+    public string LicensePlate { get; set; }
+    public string Make { get; set; }
+    public string Model { get; set; }
+
+    public List<RecordOfSale> SaleHistory { get; set; }
+}
+
+public class RecordOfSale
+{
+    public int RecordOfSaleId { get; set; }
+    public DateTime DateSold { get; set; }
+    public decimal Price { get; set; }
+
+    public string CarState { get; set; }
+    public string CarLicensePlate { get; set; }
+    public Car Car { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/Relationships/FluentAPI/CompositePrincipalKey.cs b/samples/core/Modeling/Relationships/FluentAPI/CompositePrincipalKey.cs
new file mode 100644
index 0000000000..6ea9bc22bb
--- /dev/null
+++ b/samples/core/Modeling/Relationships/FluentAPI/CompositePrincipalKey.cs
@@ -0,0 +1,43 @@
+using System;
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships.FluentAPI.CompositePrincipalKey;
+
+#region CompositePrincipalKey
+internal class MyContext : DbContext
+{
+    public DbSet<Car> Cars { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<RecordOfSale>()
+            .HasOne(s => s.Car)
+            .WithMany(c => c.SaleHistory)
+            .HasForeignKey(s => new { s.CarState, s.CarLicensePlate })
+            .HasPrincipalKey(c => new { c.State, c.LicensePlate });
+    }
+}
+
+public class Car
+{
+    public int CarId { get; set; }
+    public string State { get; set; }
+    public string LicensePlate { get; set; }
+    public string Make { get; set; }
+    public string Model { get; set; }
+
+    public List<RecordOfSale> SaleHistory { get; set; }
+}
+
+public class RecordOfSale
+{
+    public int RecordOfSaleId { get; set; }
+    public DateTime DateSold { get; set; }
+    public decimal Price { get; set; }
+
+    public string CarState { get; set; }
+    public string CarLicensePlate { get; set; }
+    public Car Car { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/Relationships/FluentAPI/ConstraintName.cs b/samples/core/Modeling/Relationships/FluentAPI/ConstraintName.cs
new file mode 100644
index 0000000000..77676877d9
--- /dev/null
+++ b/samples/core/Modeling/Relationships/FluentAPI/ConstraintName.cs
@@ -0,0 +1,39 @@
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships.FluentAPI.ConstraintName;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    #region ConstraintName
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>()
+            .HasOne(p => p.Blog)
+            .WithMany(b => b.Posts)
+            .HasForeignKey(p => p.BlogId)
+            .HasConstraintName("ForeignKey_Post_Blog");
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public List<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/Relationships/FluentAPI/ForeignKey.cs b/samples/core/Modeling/Relationships/FluentAPI/ForeignKey.cs
new file mode 100644
index 0000000000..1742c5fc91
--- /dev/null
+++ b/samples/core/Modeling/Relationships/FluentAPI/ForeignKey.cs
@@ -0,0 +1,38 @@
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships.FluentAPI.ForeignKey;
+
+#region ForeignKey
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>()
+            .HasOne(p => p.Blog)
+            .WithMany(b => b.Posts)
+            .HasForeignKey(p => p.BlogForeignKey);
+    }
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public List<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int BlogForeignKey { get; set; }
+    public Blog Blog { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/Relationships/FluentAPI/Full.cs b/samples/core/Modeling/Relationships/FluentAPI/Full.cs
new file mode 100644
index 0000000000..f3d97cf2d1
--- /dev/null
+++ b/samples/core/Modeling/Relationships/FluentAPI/Full.cs
@@ -0,0 +1,36 @@
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships.FluentAPI.Full;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>()
+            .HasOne(p => p.Blog)
+            .WithMany(b => b.Posts)
+            .HasForeignKey(p => p.BlogId);
+    }
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public List<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/Relationships/FluentAPI/ManyToMany.cs b/samples/core/Modeling/Relationships/FluentAPI/ManyToMany.cs
new file mode 100644
index 0000000000..a067e632d7
--- /dev/null
+++ b/samples/core/Modeling/Relationships/FluentAPI/ManyToMany.cs
@@ -0,0 +1,61 @@
+using System;
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships.FluentAPI.ManyToMany;
+
+#region ManyToMany
+public class MyContext : DbContext
+{
+    public MyContext(DbContextOptions<MyContext> options)
+        : base(options)
+    {
+    }
+
+    public DbSet<Post> Posts { get; set; }
+    public DbSet<Tag> Tags { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<PostTag>()
+            .HasKey(t => new { t.PostId, t.TagId });
+
+        modelBuilder.Entity<PostTag>()
+            .HasOne(pt => pt.Post)
+            .WithMany(p => p.PostTags)
+            .HasForeignKey(pt => pt.PostId);
+
+        modelBuilder.Entity<PostTag>()
+            .HasOne(pt => pt.Tag)
+            .WithMany(t => t.PostTags)
+            .HasForeignKey(pt => pt.TagId);
+    }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public List<PostTag> PostTags { get; set; }
+}
+
+public class Tag
+{
+    public string TagId { get; set; }
+
+    public List<PostTag> PostTags { get; set; }
+}
+
+public class PostTag
+{
+    public DateTime PublicationDate { get; set; }
+
+    public int PostId { get; set; }
+    public Post Post { get; set; }
+
+    public string TagId { get; set; }
+    public Tag Tag { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/Relationships/FluentAPI/ManyToManyPayload.cs b/samples/core/Modeling/Relationships/FluentAPI/ManyToManyPayload.cs
new file mode 100644
index 0000000000..095c830a39
--- /dev/null
+++ b/samples/core/Modeling/Relationships/FluentAPI/ManyToManyPayload.cs
@@ -0,0 +1,68 @@
+using System;
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships.FluentAPI.ManyToManyPayload;
+
+#region ManyToManyPayload
+internal class MyContext : DbContext
+{
+    public MyContext(DbContextOptions<MyContext> options)
+        : base(options)
+    {
+    }
+
+    public DbSet<Post> Posts { get; set; }
+    public DbSet<Tag> Tags { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>()
+            .HasMany(p => p.Tags)
+            .WithMany(p => p.Posts)
+            .UsingEntity<PostTag>(
+                j => j
+                    .HasOne(pt => pt.Tag)
+                    .WithMany(t => t.PostTags)
+                    .HasForeignKey(pt => pt.TagId),
+                j => j
+                    .HasOne(pt => pt.Post)
+                    .WithMany(p => p.PostTags)
+                    .HasForeignKey(pt => pt.PostId),
+                j =>
+                {
+                    j.Property(pt => pt.PublicationDate).HasDefaultValueSql("CURRENT_TIMESTAMP");
+                    j.HasKey(t => new { t.PostId, t.TagId });
+                });
+    }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public ICollection<Tag> Tags { get; set; }
+    public List<PostTag> PostTags { get; set; }
+}
+
+public class Tag
+{
+    public string TagId { get; set; }
+
+    public ICollection<Post> Posts { get; set; }
+    public List<PostTag> PostTags { get; set; }
+}
+
+public class PostTag
+{
+    public DateTime PublicationDate { get; set; }
+
+    public int PostId { get; set; }
+    public Post Post { get; set; }
+
+    public string TagId { get; set; }
+    public Tag Tag { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/Relationships/FluentAPI/ManyToManyShared.cs b/samples/core/Modeling/Relationships/FluentAPI/ManyToManyShared.cs
new file mode 100644
index 0000000000..47c1c66fad
--- /dev/null
+++ b/samples/core/Modeling/Relationships/FluentAPI/ManyToManyShared.cs
@@ -0,0 +1,91 @@
+using System;
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships.FluentAPI.ManyToManyShared;
+
+public class MyContext : DbContext
+{
+    public MyContext(DbContextOptions<MyContext> options)
+        : base(options)
+    {
+    }
+
+    public DbSet<Post> Posts { get; set; }
+    public DbSet<Tag> Tags { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        #region SharedConfiguration
+        modelBuilder
+            .Entity<Post>()
+            .HasMany(p => p.Tags)
+            .WithMany(p => p.Posts)
+            .UsingEntity(j => j.ToTable("PostTags"));
+        #endregion
+
+        #region Metadata
+        foreach (var entityType in modelBuilder.Model.GetEntityTypes())
+        {
+            foreach (var skipNavigation in entityType.GetSkipNavigations())
+            {
+                Console.WriteLine(entityType.DisplayName() + "." + skipNavigation.Name);
+            }
+        }
+        #endregion
+
+        #region Seeding
+        modelBuilder
+            .Entity<Post>()
+            .HasData(new Post { PostId = 1, Title = "First" });
+
+        modelBuilder
+            .Entity<Tag>()
+            .HasData(new Tag { TagId = "ef" });
+
+        modelBuilder
+            .Entity<Post>()
+            .HasMany(p => p.Tags)
+            .WithMany(p => p.Posts)
+            .UsingEntity(j => j.HasData(new { PostsPostId = 1, TagsTagId = "ef" }));
+        #endregion
+
+        #region Components
+        modelBuilder.Entity<Post>()
+            .HasMany(p => p.Tags)
+            .WithMany(p => p.Posts)
+            .UsingEntity<Dictionary<string, object>>(
+                "PostTag",
+                j => j
+                    .HasOne<Tag>()
+                    .WithMany()
+                    .HasForeignKey("TagsId")
+                    .HasConstraintName("FK_PostTag_Tags_TagId")
+                    .OnDelete(DeleteBehavior.Cascade),
+                j => j
+                    .HasOne<Post>()
+                    .WithMany()
+                    .HasForeignKey("PostsId")
+                    .HasConstraintName("FK_PostTag_Posts_PostId")
+                    .OnDelete(DeleteBehavior.ClientCascade));
+        #endregion
+    }
+}
+
+#region ManyToManyShared
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public ICollection<Tag> Tags { get; set; }
+}
+
+public class Tag
+{
+    public string TagId { get; set; }
+
+    public ICollection<Post> Posts { get; set; }
+}
+#endregion
diff --git a/samples/core/Modeling/Relationships/FluentAPI/NavigationConfiguration.cs b/samples/core/Modeling/Relationships/FluentAPI/NavigationConfiguration.cs
new file mode 100644
index 0000000000..c88024b293
--- /dev/null
+++ b/samples/core/Modeling/Relationships/FluentAPI/NavigationConfiguration.cs
@@ -0,0 +1,38 @@
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships.FluentAPI.NavigationConfiguration;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    #region NavigationConfiguration
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .HasMany(b => b.Posts)
+            .WithOne();
+
+        modelBuilder.Entity<Blog>()
+            .Navigation(b => b.Posts)
+            .UsePropertyAccessMode(PropertyAccessMode.Property);
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public List<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/Relationships/FluentAPI/NoForeignKey.cs b/samples/core/Modeling/Relationships/FluentAPI/NoForeignKey.cs
new file mode 100644
index 0000000000..47e9a51ce7
--- /dev/null
+++ b/samples/core/Modeling/Relationships/FluentAPI/NoForeignKey.cs
@@ -0,0 +1,36 @@
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships.FluentAPI.NoForeignKey;
+
+#region NoForeignKey
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>()
+            .HasOne(p => p.Blog)
+            .WithMany(b => b.Posts);
+    }
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public List<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public Blog Blog { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/Relationships/FluentAPI/NoNavigation.cs b/samples/core/Modeling/Relationships/FluentAPI/NoNavigation.cs
new file mode 100644
index 0000000000..883871715a
--- /dev/null
+++ b/samples/core/Modeling/Relationships/FluentAPI/NoNavigation.cs
@@ -0,0 +1,34 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships.FluentAPI.NoNavigation;
+
+#region NoNavigation
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>()
+            .HasOne<Blog>()
+            .WithMany()
+            .HasForeignKey(p => p.BlogId);
+    }
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int BlogId { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/Relationships/FluentAPI/OneNavigation.cs b/samples/core/Modeling/Relationships/FluentAPI/OneNavigation.cs
new file mode 100644
index 0000000000..7f8c60e04e
--- /dev/null
+++ b/samples/core/Modeling/Relationships/FluentAPI/OneNavigation.cs
@@ -0,0 +1,34 @@
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships.FluentAPI.OneNavigation;
+
+#region OneNavigation
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .HasMany(b => b.Posts)
+            .WithOne();
+    }
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public List<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/Relationships/FluentAPI/OneToOne.cs b/samples/core/Modeling/Relationships/FluentAPI/OneToOne.cs
new file mode 100644
index 0000000000..6eb7054b3b
--- /dev/null
+++ b/samples/core/Modeling/Relationships/FluentAPI/OneToOne.cs
@@ -0,0 +1,37 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships.FluentAPI.OneToOne;
+
+#region OneToOne
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<BlogImage> BlogImages { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .HasOne(b => b.BlogImage)
+            .WithOne(i => i.Blog)
+            .HasForeignKey<BlogImage>(b => b.BlogForeignKey);
+    }
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public BlogImage BlogImage { get; set; }
+}
+
+public class BlogImage
+{
+    public int BlogImageId { get; set; }
+    public byte[] Image { get; set; }
+    public string Caption { get; set; }
+
+    public int BlogForeignKey { get; set; }
+    public Blog Blog { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/Relationships/FluentAPI/PrincipalKey.cs b/samples/core/Modeling/Relationships/FluentAPI/PrincipalKey.cs
new file mode 100644
index 0000000000..a756bc0342
--- /dev/null
+++ b/samples/core/Modeling/Relationships/FluentAPI/PrincipalKey.cs
@@ -0,0 +1,41 @@
+using System;
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships.FluentAPI.PrincipalKey;
+
+#region PrincipalKey
+internal class MyContext : DbContext
+{
+    public DbSet<Car> Cars { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<RecordOfSale>()
+            .HasOne(s => s.Car)
+            .WithMany(c => c.SaleHistory)
+            .HasForeignKey(s => s.CarLicensePlate)
+            .HasPrincipalKey(c => c.LicensePlate);
+    }
+}
+
+public class Car
+{
+    public int CarId { get; set; }
+    public string LicensePlate { get; set; }
+    public string Make { get; set; }
+    public string Model { get; set; }
+
+    public List<RecordOfSale> SaleHistory { get; set; }
+}
+
+public class RecordOfSale
+{
+    public int RecordOfSaleId { get; set; }
+    public DateTime DateSold { get; set; }
+    public decimal Price { get; set; }
+
+    public string CarLicensePlate { get; set; }
+    public Car Car { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/Relationships/FluentAPI/Required.cs b/samples/core/Modeling/Relationships/FluentAPI/Required.cs
new file mode 100644
index 0000000000..277e8d6a40
--- /dev/null
+++ b/samples/core/Modeling/Relationships/FluentAPI/Required.cs
@@ -0,0 +1,37 @@
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships.FluentAPI.Required;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    #region Required
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>()
+            .HasOne(p => p.Blog)
+            .WithMany(b => b.Posts)
+            .IsRequired();
+    }
+    #endregion
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public List<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public Blog Blog { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/Relationships/FluentAPI/ShadowForeignKey.cs b/samples/core/Modeling/Relationships/FluentAPI/ShadowForeignKey.cs
new file mode 100644
index 0000000000..d57885887a
--- /dev/null
+++ b/samples/core/Modeling/Relationships/FluentAPI/ShadowForeignKey.cs
@@ -0,0 +1,42 @@
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships.FluentAPI.ShadowForeignKey;
+
+#region ShadowForeignKey
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        // Add the shadow property to the model
+        modelBuilder.Entity<Post>()
+            .Property<int>("BlogForeignKey");
+
+        // Use the shadow property as a foreign key
+        modelBuilder.Entity<Post>()
+            .HasOne(p => p.Blog)
+            .WithMany(b => b.Posts)
+            .HasForeignKey("BlogForeignKey");
+    }
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public List<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public Blog Blog { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/Relationships/ForeignAndPrincipalKeys.cs b/samples/core/Modeling/Relationships/ForeignAndPrincipalKeys.cs
new file mode 100644
index 0000000000..7481cf99e1
--- /dev/null
+++ b/samples/core/Modeling/Relationships/ForeignAndPrincipalKeys.cs
@@ -0,0 +1,781 @@
+#nullable enable
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace EFModeling.Relationships;
+
+public class ForeignAndPrincipalKeys
+{
+    public class ForeignKeyConfigurationByLambda
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Configure a foreign key using HasForeignKey with a lambda expression:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+        }
+
+        public class Blog
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public int? ContainingBlogId { get; set; }
+            public Blog? Blog { get; init; }
+        }
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ForeignKeyConfigurationByLambda{GetType().Name}.db");
+
+            #region ForeignKeyByLambda
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey(e => e.ContainingBlogId);
+            }
+            #endregion
+        }
+    }
+
+    public class ForeignKeyConfigurationByString
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Configure a foreign key using HasForeignKey with a string:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+        }
+
+        public class Blog
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            private int? ContainingBlogId { get; set; }
+            public Blog? Blog { get; init; }
+        }
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ForeignKeyConfigurationByString{GetType().Name}.db");
+
+            #region ForeignKeyByString
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey("ContainingBlogId");
+            }
+            #endregion
+        }
+    }
+
+    public class CompositeForeignKeyConfigurationByLambda
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Configure a composite foreign key using HasForeignKey with a lambda expression:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+        }
+
+        [PrimaryKey(nameof(Id1), nameof(Id2))]
+        public class Blog
+        {
+            public int Id1 { get; set; }
+            public int Id2 { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public int? ContainingBlogId1 { get; set; }
+            public int? ContainingBlogId2 { get; set; }
+            public Blog? Blog { get; init; }
+        }
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = CompositeForeignKeyConfigurationByLambda{GetType().Name}.db");
+
+            #region CompositeForeignKeyByLambda
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey(e => new { e.ContainingBlogId1, e.ContainingBlogId2 });
+            }
+            #endregion
+        }
+    }
+
+    public class CompositeForeignKeyConfigurationByString
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Configure a composite foreign key using HasForeignKey with a string:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+        }
+
+        [PrimaryKey(nameof(Id1), nameof(Id2))]
+        public class Blog
+        {
+            public int Id1 { get; set; }
+            public int Id2 { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public Blog? Blog { get; init; }
+        }
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = CompositeForeignKeyConfigurationByString{GetType().Name}.db");
+
+            #region CompositeForeignKeyByString
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey("ContainingBlogId1", "ContainingBlogId2");
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredForeignKey
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Configure a relationship as required, even though the foreign key is nullable:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(schema == context1.Database.GenerateCreateScript());
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(schema == context2.Database.GenerateCreateScript());
+        }
+
+        public class Blog
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public int? BlogId { get; set; }
+            public Blog? Blog { get; init; }
+        }
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredForeignKey{GetType().Name}.db");
+
+            #region RequiredForeignKeyConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region RequiredForeignKeyConfig2
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region RequiredForeignKeyConfigByProperty
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .Property(e => e.BlogId)
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class ShadowForeignKey
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Configure a relationship with a shadow foreign key:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+
+            using var context1 = new BlogContext1();
+            var script = context1.Database.GenerateCreateScript();
+            //Debug.Assert(schema == script);
+        }
+
+        public class Blog
+        {
+            public string Id { get; set; } = null!;
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public Blog Blog { get; init; } = null!;
+        }
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ShadowForeignKey{GetType().Name}.db");
+
+            #region ShadowForeignKeyConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey("MyBlogId");
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region ShadowForeignKeyConfigByProperty
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .Property<string>("MyBlogId")
+                    .IsRequired();
+
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey("MyBlogId");
+            }
+            #endregion
+        }
+    }
+
+    public class ForeignKeyConstraintName
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Configure a relationship as with a named foreign key constraint:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+            Console.WriteLine(schema);
+            Console.WriteLine();
+        }
+
+        public class Blog
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public int? BlogId { get; set; }
+            public Blog? Blog { get; init; }
+        }
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ForeignKeyConstraintName{GetType().Name}.db");
+
+            #region ForeignKeyConstraintNameConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey(e => e.BlogId)
+                    .HasConstraintName("My_BlogId_Constraint");
+            }
+            #endregion
+        }
+    }
+
+    public class AlternateKeyConfigurationByLambda
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Configure an alternate key using HasPrincipalKey with a lambda expression:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(schema == context1.Database.GenerateCreateScript());
+        }
+
+        public class Blog
+        {
+            public int Id { get; set; }
+            public int AlternateId { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public int? BlogId { get; set; }
+            public Blog? Blog { get; init; }
+        }
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = AlternateKeyConfigurationByLambda{GetType().Name}.db");
+
+            #region AlternateKeyConfigurationByLambda
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey(e => e.AlternateId);
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey(e => e.BlogId)
+                    .HasPrincipalKey(e => e.AlternateId);
+            }
+        }
+    }
+
+    public class AlternateKeyConfigurationByString
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Configure an alternate key using HasPrincipalKey with a string:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(schema == context1.Database.GenerateCreateScript());
+        }
+
+        public class Blog
+        {
+            public int Id { get; set; }
+            private int AlternateId { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public int? BlogAlternateId { get; set; }
+            public Blog? Blog { get; init; }
+        }
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = AlternateKeyConfigurationByString{GetType().Name}.db");
+
+            #region AlternateKeyConfigurationByString
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey("AlternateId");
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey("BlogAlternateId")
+                    .HasPrincipalKey("AlternateId");
+            }
+        }
+    }
+
+    public class CompositeAlternateKeyConfigurationByLambda
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Configure a composite alternate key using HasPrincipalKey with a lambda expression:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(schema == context1.Database.GenerateCreateScript());
+        }
+
+        public class Blog
+        {
+            public int Id { get; set; }
+            public int AlternateId1 { get; set; }
+            public int AlternateId2 { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public int? BlogAlternateId1 { get; set; }
+            public int? BlogAlternateId2 { get; set; }
+            public Blog? Blog { get; init; }
+        }
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = CompositeAlternateKeyConfigurationByLambda{GetType().Name}.db");
+
+            #region CompositeAlternateKeyConfigurationByLambda
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey(e => new { e.AlternateId1, e.AlternateId2 });
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey(e => new { e.BlogAlternateId1, e.BlogAlternateId2 })
+                    .HasPrincipalKey(e => new { e.AlternateId1, e.AlternateId2 });
+            }
+        }
+    }
+
+    public class CompositeAlternateKeyConfigurationByString
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Configure a composite alternate key using HasPrincipalKey with a string:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(schema == context1.Database.GenerateCreateScript());
+        }
+
+        public class Blog
+        {
+            public int Id { get; set; }
+            public int AlternateId1 { get; set; }
+            public int AlternateId2 { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public Blog? Blog { get; init; }
+        }
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = CompositeAlternateKeyConfigurationByString{GetType().Name}.db");
+
+            #region CompositeAlternateKeyConfigurationByString
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey("AlternateId1", "AlternateId2");
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey("BlogAlternateId1", "BlogAlternateId2")
+                    .HasPrincipalKey("AlternateId1", "AlternateId2");
+            }
+        }
+    }
+
+    public class ForeignKeyInKeylessType
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Configure a foreign key on a keyless type to form a relationship:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+        }
+
+        #region ForeignKeyInKeylessType
+        public class Tag
+        {
+            public string Text { get; set; } = null!;
+            public int PostId { get; set; }
+            public Post Post { get; set; } = null!;
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Post> Blogs => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ForeignKeyInKeylessType{GetType().Name}.db");
+
+            #region ForeignKeyInKeylessTypeConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Tag>()
+                    .HasNoKey();
+
+                modelBuilder.Entity<Post>()
+                    .HasMany<Tag>()
+                    .WithOne(e => e.Post);
+            }
+            #endregion
+        }
+    }
+
+    public class ManyToManyForeignKeyConstraintNames
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+
+            Console.WriteLine("Many-to-many with foreign key constraint names:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+            Console.WriteLine(schema);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(schema == context1.Database.GenerateCreateScript());
+        }
+
+        #region ManyToManyForeignKeyConstraintNames
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = new();
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Post> Posts => Set<Post>();
+            public DbSet<Tag> Tags => Set<Tag>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ManyToManyForeignKeyConstraintNames{GetType().Name}.db");
+
+            #region ManyToManyForeignKeyConstraintNamesConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity(
+                        l => l.HasOne(typeof(Tag)).WithMany().HasConstraintName("TagForeignKey_Constraint"),
+                        r => r.HasOne(typeof(Post)).WithMany().HasConstraintName("PostForeignKey_Constraint"));
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity(
+                        "PostTag",
+                        l => l.HasOne(typeof(Tag)).WithMany().HasForeignKey("TagsId").HasPrincipalKey(nameof(Tag.Id)).HasConstraintName("TagForeignKey_Constraint"),
+                        r => r.HasOne(typeof(Post)).WithMany().HasForeignKey("PostsId").HasPrincipalKey(nameof(Post.Id)).HasConstraintName("PostForeignKey_Constraint"),
+                        j => j.HasKey("PostsId", "TagsId"));
+            }
+        }
+    }
+
+    public class NavigationConfiguration
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Configure navigations to use property access instead of field access:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+        }
+
+        public class Blog
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public int? BlogId { get; set; }
+            public Blog? Blog { get; init; }
+        }
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = NavigationConfiguration{GetType().Name}.db");
+
+            #region NavigationConfiguration
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .Navigation(e => e.Posts)
+                    .UsePropertyAccessMode(PropertyAccessMode.Property);
+
+                modelBuilder.Entity<Post>()
+                    .Navigation(e => e.Blog)
+                    .UsePropertyAccessMode(PropertyAccessMode.Property);
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+
+            #region ThrowForShadow
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.ConfigureWarnings(b => b.Throw(CoreEventId.ShadowPropertyCreated));
+            #endregion
+        }
+    }
+}
diff --git a/samples/core/Modeling/Relationships/Full.cs b/samples/core/Modeling/Relationships/Full.cs
new file mode 100644
index 0000000000..4fd2ab2fe2
--- /dev/null
+++ b/samples/core/Modeling/Relationships/Full.cs
@@ -0,0 +1,30 @@
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships.Full;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+}
+
+#region Full
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public List<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/Relationships/ManyToMany.cs b/samples/core/Modeling/Relationships/ManyToMany.cs
new file mode 100644
index 0000000000..71abe57189
--- /dev/null
+++ b/samples/core/Modeling/Relationships/ManyToMany.cs
@@ -0,0 +1,1498 @@
+#nullable enable
+
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships;
+
+public class ManyToMany
+{
+    public class BasicManyToMany
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+
+            Console.WriteLine("Basic, bidirectional many-to-many:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+            Console.WriteLine(schema);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(schema == context1.Database.GenerateCreateScript());
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(schema == context2.Database.GenerateCreateScript());
+        }
+
+        #region BasicManyToMany
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = [];
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = [];
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Post> Posts => Set<Post>();
+            public DbSet<Tag> Tags => Set<Tag>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = BasicManyToMany{GetType().Name}.db");
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region BasicManyToManyConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts);
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region BasicManyToManyFullConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity(
+                        "PostTag",
+                        r => r.HasOne(typeof(Tag)).WithMany().HasForeignKey("TagsId").HasPrincipalKey(nameof(Tag.Id)),
+                        l => l.HasOne(typeof(Post)).WithMany().HasForeignKey("PostsId").HasPrincipalKey(nameof(Post.Id)),
+                        j => j.HasKey("PostsId", "TagsId"));
+            }
+            #endregion
+        }
+    }
+
+    public class UnidirectionalManyToMany
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+
+            Console.WriteLine("Basic, unidirectional many-to-many:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+            Console.WriteLine(schema);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(schema == context1.Database.GenerateCreateScript());
+        }
+
+        #region UnidirectionalManyToMany
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = [];
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Post> Posts => Set<Post>();
+            public DbSet<Tag> Tags => Set<Tag>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = UnidirectionalManyToMany{GetType().Name}.db");
+
+            #region UnidirectionalManyToManyConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany();
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region UnidirectionalManyToManyFullConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany()
+                    .UsingEntity(
+                        "PostTag",
+                        r => r.HasOne(typeof(Tag)).WithMany().HasForeignKey("TagsId").HasPrincipalKey(nameof(Tag.Id)),
+                        l => l.HasOne(typeof(Post)).WithMany().HasForeignKey("PostId").HasPrincipalKey(nameof(Post.Id)),
+                        j => j.HasKey("PostId", "TagsId"));
+            }
+            #endregion
+        }
+    }
+
+    public class ManyToManyNamedJoinTable
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+
+            Console.WriteLine("Basic, bidirectional many-to-many with explicitly named join table:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+            Console.WriteLine(schema);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(schema == context1.Database.GenerateCreateScript());
+        }
+
+        #region ManyToManyNamedJoinTable
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = [];
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = [];
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Post> Posts => Set<Post>();
+            public DbSet<Tag> Tags => Set<Tag>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ManyToManyNamedJoinTable{GetType().Name}.db");
+
+            #region ManyToManyNamedJoinTableConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity("PostsToTagsJoinTable");
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region ManyToManyNamedJoinTableFullConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity(
+                        "PostsToTagsJoinTable",
+                        r => r.HasOne(typeof(Tag)).WithMany().HasForeignKey("TagsId").HasPrincipalKey(nameof(Tag.Id)),
+                        l => l.HasOne(typeof(Post)).WithMany().HasForeignKey("PostsId").HasPrincipalKey(nameof(Post.Id)),
+                        j => j.HasKey("PostsId", "TagsId"));
+            }
+            #endregion
+        }
+    }
+
+    public class ManyToManyNamedForeignKeyColumns
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+
+            Console.WriteLine("Basic, bidirectional many-to-many with explicitly named foreign key columns:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+            Console.WriteLine(schema);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(schema == context1.Database.GenerateCreateScript());
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(schema == context2.Database.GenerateCreateScript());
+        }
+
+        #region ManyToManyNamedForeignKeyColumns
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = [];
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = [];
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Post> Posts => Set<Post>();
+            public DbSet<Tag> Tags => Set<Tag>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ManyToManyNamedForeignKeyColumns{GetType().Name}.db");
+
+            #region ManyToManyNamedForeignKeyColumnsConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity(
+                        r => r.HasOne(typeof(Tag)).WithMany().HasForeignKey("TagForeignKey"),
+                        l => l.HasOne(typeof(Post)).WithMany().HasForeignKey("PostForeignKey"));
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region ManyToManyNamedForeignKeyColumnsFullConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity(
+                        "PostTag",
+                        r => r.HasOne(typeof(Tag)).WithMany().HasForeignKey("TagForeignKey").HasPrincipalKey(nameof(Tag.Id)),
+                        l => l.HasOne(typeof(Post)).WithMany().HasForeignKey("PostForeignKey").HasPrincipalKey(nameof(Post.Id)),
+                        j => j.HasKey("PostForeignKey", "TagForeignKey"));
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region ManyToManyNamedForeignKeyColumnsAlternateConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity(
+                        j =>
+                        {
+                            j.Property("PostsId").HasColumnName("PostForeignKey");
+                            j.Property("TagsId").HasColumnName("TagForeignKey");
+                        });
+            }
+            #endregion
+        }
+    }
+
+    public class ManyToManyWithJoinClass
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+
+            Console.WriteLine("Bidirectional many-to-many with join table mapped to an entity type class:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+            Console.WriteLine(schema);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(schema == context1.Database.GenerateCreateScript());
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(schema == context2.Database.GenerateCreateScript());
+        }
+
+        #region ManyToManyWithJoinClass
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = [];
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = [];
+        }
+
+        public class PostTag
+        {
+            public int PostId { get; set; }
+            public int TagId { get; set; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Post> Posts => Set<Post>();
+            public DbSet<Tag> Tags => Set<Tag>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ManyToManyWithJoinClass{GetType().Name}.db");
+
+            #region ManyToManyWithJoinClassConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>();
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region ManyToManyWithJoinClassFkConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>(
+                        r => r.HasOne<Tag>().WithMany().HasForeignKey(e => e.TagId),
+                        l => l.HasOne<Post>().WithMany().HasForeignKey(e => e.PostId));
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region ManyToManyWithJoinClassFullConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>(
+                        "PostTag",
+                        r => r.HasOne<Tag>().WithMany().HasForeignKey(e => e.TagId).HasPrincipalKey(e => e.Id),
+                        l => l.HasOne<Post>().WithMany().HasForeignKey(e => e.PostId).HasPrincipalKey(e => e.Id),
+                        j => j.HasKey(e => new { e.PostId, e.TagId }));
+            }
+            #endregion
+        }
+    }
+
+    public class ManyToManyWithNavsToJoinClass
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+
+            Console.WriteLine("Bidirectional many-to-many with navigations to the join entity type:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+            Console.WriteLine(schema);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(schema == context1.Database.GenerateCreateScript());
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(schema == context2.Database.GenerateCreateScript());
+        }
+
+        #region ManyToManyWithNavsToJoinClass
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = [];
+            public List<PostTag> PostTags { get; } = [];
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = [];
+            public List<PostTag> PostTags { get; } = [];
+        }
+
+        public class PostTag
+        {
+            public int PostId { get; set; }
+            public int TagId { get; set; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Post> Posts => Set<Post>();
+            public DbSet<Tag> Tags => Set<Tag>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ManyToManyWithNavsToJoinClass{GetType().Name}.db");
+
+            #region ManyToManyWithNavsToJoinClassConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>();
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region ManyToManyWithNavsToJoinClassWithNavConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>(
+                        r => r.HasOne<Tag>().WithMany(e => e.PostTags),
+                        l => l.HasOne<Post>().WithMany(e => e.PostTags));
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region ManyToManyWithNavsToJoinClassFullConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>(
+                        "PostTag",
+                        r => r.HasOne<Tag>().WithMany(e => e.PostTags).HasForeignKey(e => e.TagId).HasPrincipalKey(e => e.Id),
+                        l => l.HasOne<Post>().WithMany(e => e.PostTags).HasForeignKey(e => e.PostId).HasPrincipalKey(e => e.Id),
+                        j => j.HasKey(e => new { e.PostId, e.TagId }));
+            }
+            #endregion
+        }
+    }
+
+    public class ManyToManyWithNavsToAndFromJoinClass
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+
+            Console.WriteLine("Bidirectional many-to-many with navigations to and from the join entity type:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+            Console.WriteLine(schema);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(schema == context1.Database.GenerateCreateScript());
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(schema == context2.Database.GenerateCreateScript());
+        }
+
+        #region ManyToManyWithNavsToAndFromJoinClass
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = [];
+            public List<PostTag> PostTags { get; } = [];
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = [];
+            public List<PostTag> PostTags { get; } = [];
+        }
+
+        public class PostTag
+        {
+            public int PostId { get; set; }
+            public int TagId { get; set; }
+            public Post Post { get; set; } = null!;
+            public Tag Tag { get; set; } = null!;
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Post> Posts => Set<Post>();
+            public DbSet<Tag> Tags => Set<Tag>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ManyToManyWithNavsToAndFromJoinClass{GetType().Name}.db");
+
+            #region ManyToManyWithNavsToAndFromJoinClassConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>();
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region ManyToManyWithNavsToAndFromJoinClassWithNavConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>(
+                        r => r.HasOne<Tag>(e => e.Tag).WithMany(e => e.PostTags),
+                        l => l.HasOne<Post>(e => e.Post).WithMany(e => e.PostTags));
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region ManyToManyWithNavsToAndFromJoinClassFullConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>(
+                        "PostTag",
+                        r => r.HasOne<Tag>(e => e.Tag).WithMany(e => e.PostTags).HasForeignKey(e => e.TagId).HasPrincipalKey(e => e.Id),
+                        l => l.HasOne<Post>(e => e.Post).WithMany(e => e.PostTags).HasForeignKey(e => e.PostId).HasPrincipalKey(e => e.Id),
+                        j => j.HasKey(e => new { e.PostId, e.TagId }));
+            }
+            #endregion
+        }
+    }
+
+    public class ManyToManyWithNamedFksAndNavsToAndFromJoinClass
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+
+            Console.WriteLine("Bidirectional many-to-many with named foreign key properties navigations to and from the join entity type:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+            Console.WriteLine(schema);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(schema == context1.Database.GenerateCreateScript());
+        }
+
+        #region ManyToManyWithNamedFksAndNavsToAndFromJoinClass
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = [];
+            public List<PostTag> PostTags { get; } = [];
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = [];
+            public List<PostTag> PostTags { get; } = [];
+        }
+
+        public class PostTag
+        {
+            public int PostForeignKey { get; set; }
+            public int TagForeignKey { get; set; }
+            public Post Post { get; set; } = null!;
+            public Tag Tag { get; set; } = null!;
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Post> Posts => Set<Post>();
+            public DbSet<Tag> Tags => Set<Tag>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ManyToManyWithNamedFksAndNavsToAndFromJoinClass{GetType().Name}.db");
+
+            #region ManyToManyWithNamedFksAndNavsToAndFromJoinClassConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>(
+                        r => r.HasOne<Tag>(e => e.Tag).WithMany(e => e.PostTags).HasForeignKey(e => e.TagForeignKey),
+                        l => l.HasOne<Post>(e => e.Post).WithMany(e => e.PostTags).HasForeignKey(e => e.PostForeignKey));
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region ManyToManyWithNavsToAndFromJoinClassFullConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>(
+                        "PostTag",
+                        r => r.HasOne<Tag>(e => e.Tag).WithMany(e => e.PostTags).HasForeignKey(e => e.TagForeignKey).HasPrincipalKey(e => e.Id),
+                        l => l.HasOne<Post>(e => e.Post).WithMany(e => e.PostTags).HasForeignKey(e => e.PostForeignKey).HasPrincipalKey(e => e.Id),
+                        j => j.HasKey(e => new { e.PostForeignKey, e.TagForeignKey }));
+            }
+            #endregion
+        }
+    }
+
+    public class ManyToManyAlternateKeys
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+
+            Console.WriteLine("Basic, bidirectional many-to-many using alternate keys on either side of the relationship:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+            Console.WriteLine(schema);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(schema == context1.Database.GenerateCreateScript());
+        }
+
+        #region ManyToManyAlternateKeys
+        public class Post
+        {
+            public int Id { get; set; }
+            public int AlternateKey { get; set; }
+            public List<Tag> Tags { get; } = [];
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public int AlternateKey { get; set; }
+            public List<Post> Posts { get; } = [];
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Post> Posts => Set<Post>();
+            public DbSet<Tag> Tags => Set<Tag>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ManyToManyAlternateKeys{GetType().Name}.db");
+
+            #region ManyToManyAlternateKeysConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity(
+                        r => r.HasOne(typeof(Tag)).WithMany().HasPrincipalKey(nameof(Tag.AlternateKey)),
+                        l => l.HasOne(typeof(Post)).WithMany().HasPrincipalKey(nameof(Post.AlternateKey)));
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region ManyToManyAlternateKeysFullConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity(
+                        "PostTag",
+                        r => r.HasOne(typeof(Tag)).WithMany().HasForeignKey("TagsAlternateKey").HasPrincipalKey(nameof(Tag.AlternateKey)),
+                        l => l.HasOne(typeof(Post)).WithMany().HasForeignKey("PostsAlternateKey").HasPrincipalKey(nameof(Post.AlternateKey)),
+                        j => j.HasKey("PostsAlternateKey", "TagsAlternateKey"));
+            }
+            #endregion
+        }
+    }
+
+    public class ManyToManyWithNavsAndAlternateKeys
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+
+            Console.WriteLine("Bidirectional many-to-many with alternate keys and navigations to and from the join entity type:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+            Console.WriteLine(schema);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(schema == context1.Database.GenerateCreateScript());
+        }
+
+        #region ManyToManyWithNavsAndAlternateKeys
+        public class Post
+        {
+            public int Id { get; set; }
+            public int AlternateKey { get; set; }
+            public List<Tag> Tags { get; } = [];
+            public List<PostTag> PostTags { get; } = [];
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public int AlternateKey { get; set; }
+            public List<Post> Posts { get; } = [];
+            public List<PostTag> PostTags { get; } = [];
+        }
+
+        public class PostTag
+        {
+            public int PostId { get; set; }
+            public int TagId { get; set; }
+            public Post Post { get; set; } = null!;
+            public Tag Tag { get; set; } = null!;
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Post> Posts => Set<Post>();
+            public DbSet<Tag> Tags => Set<Tag>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ManyToManyWithNavsAndAlternateKeys{GetType().Name}.db");
+
+            #region ManyToManyWithNavsAndAlternateKeysConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>(
+                        r => r.HasOne<Tag>(e => e.Tag).WithMany(e => e.PostTags).HasPrincipalKey(e => e.AlternateKey),
+                        l => l.HasOne<Post>(e => e.Post).WithMany(e => e.PostTags).HasPrincipalKey(e => e.AlternateKey));
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region ManyToManyWithNavsAndAlternateKeysFullConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>(
+                        "PostTag",
+                        r => r.HasOne<Tag>(e => e.Tag).WithMany(e => e.PostTags).HasForeignKey(e => e.TagId).HasPrincipalKey(e => e.AlternateKey),
+                        l => l.HasOne<Post>(e => e.Post).WithMany(e => e.PostTags).HasForeignKey(e => e.PostId).HasPrincipalKey(e => e.AlternateKey),
+                        j => j.HasKey(e => new { e.PostId, e.TagId }));
+            }
+            #endregion
+        }
+    }
+
+    public class ManyToManyWithJoinClassHavingPrimaryKey
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+
+            Console.WriteLine("Bidirectional many-to-many with join table mapped to an entity type class, which has a separate primary key property:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+            Console.WriteLine(schema);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(schema == context1.Database.GenerateCreateScript());
+        }
+
+        #region ManyToManyWithJoinClassHavingPrimaryKey
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = [];
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = [];
+        }
+
+        public class PostTag
+        {
+            public int Id { get; set; }
+            public int PostId { get; set; }
+            public int TagId { get; set; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Post> Posts => Set<Post>();
+            public DbSet<Tag> Tags => Set<Tag>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ManyToManyWithJoinClassHavingPrimaryKey{GetType().Name}.db");
+
+            #region ManyToManyWithJoinClassHavingPrimaryKeyConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>();
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region ManyToManyWithJoinClassHavingPrimaryKeyFullConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>(
+                        "PostTag",
+                        r => r.HasOne<Tag>().WithMany().HasForeignKey(e => e.TagId).HasPrincipalKey(e => e.Id),
+                        l => l.HasOne<Post>().WithMany().HasForeignKey(e => e.PostId).HasPrincipalKey(e => e.Id),
+                        j => j.HasKey(e => e.Id));
+            }
+            #endregion
+        }
+    }
+
+    public class ManyToManyWithPrimaryKeyInJoinEntity
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+
+            Console.WriteLine("Bidirectional many-to-many with separate primary key property in the join entity:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+            Console.WriteLine(schema);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(schema == context1.Database.GenerateCreateScript());
+        }
+
+        #region ManyToManyWithPrimaryKeyInJoinEntity
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = [];
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = [];
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Post> Posts => Set<Post>();
+            public DbSet<Tag> Tags => Set<Tag>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ManyToManyWithPrimaryKeyInJoinEntity{GetType().Name}.db");
+
+            #region ManyToManyWithPrimaryKeyInJoinEntityConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity(
+                        j =>
+                        {
+                            j.IndexerProperty<int>("Id");
+                            j.HasKey("Id");
+                        });
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region ManyToManyWithPrimaryKeyInJoinEntityFullConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity(
+                        "PostTag",
+                        r => r.HasOne(typeof(Tag)).WithMany().HasForeignKey("TagsId").HasPrincipalKey(nameof(Tag.Id)),
+                        l => l.HasOne(typeof(Post)).WithMany().HasForeignKey("PostsId").HasPrincipalKey(nameof(Post.Id)),
+                        j =>
+                        {
+                            j.IndexerProperty<int>("Id");
+                            j.HasKey("Id");
+                        });
+            }
+            #endregion
+        }
+    }
+
+    public class ManyToManyWithPayloadAndNavsToJoinClass
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+
+            Console.WriteLine("Bidirectional many-to-many with navigations to a join entity type with payload:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+            Console.WriteLine(schema);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(schema == context1.Database.GenerateCreateScript());
+        }
+
+        #region ManyToManyWithPayloadAndNavsToJoinClass
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = [];
+            public List<PostTag> PostTags { get; } = [];
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = [];
+            public List<PostTag> PostTags { get; } = [];
+        }
+
+        public class PostTag
+        {
+            public int PostId { get; set; }
+            public int TagId { get; set; }
+            public DateTime CreatedOn { get; set; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Post> Posts => Set<Post>();
+            public DbSet<Tag> Tags => Set<Tag>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ManyToManyWithPayloadAndNavsToJoinClass{GetType().Name}.db");
+
+            #region ManyToManyWithPayloadAndNavsToJoinClassConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>(
+                        j => j.Property(e => e.CreatedOn).HasDefaultValueSql("CURRENT_TIMESTAMP"));
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region ManyToManyWithPayloadAndNavsToJoinClassFullConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>(
+                        "PostTag",
+                        r => r.HasOne<Tag>().WithMany(e => e.PostTags).HasForeignKey(e => e.TagId).HasPrincipalKey(e => e.Id),
+                        l => l.HasOne<Post>().WithMany(e => e.PostTags).HasForeignKey(e => e.PostId).HasPrincipalKey(e => e.Id),
+                        j =>
+                        {
+                            j.HasKey(e => new { e.PostId, e.TagId });
+                            j.Property(e => e.CreatedOn).HasDefaultValueSql("CURRENT_TIMESTAMP");
+                        });
+            }
+            #endregion
+        }
+    }
+
+    public class ManyToManyWithNoCascadeDelete
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+
+            Console.WriteLine("Bidirectional many-to-many without cascade delete:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+            Console.WriteLine(schema);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(schema == context1.Database.GenerateCreateScript());
+        }
+
+        #region ManyToManyWithNoCascadeDelete
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = [];
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = [];
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Post> Posts => Set<Post>();
+            public DbSet<Tag> Tags => Set<Tag>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ManyToManyWithNoCascadeDelete{GetType().Name}.db");
+
+            #region ManyToManyWithNoCascadeDeleteConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity(
+                        r => r.HasOne(typeof(Tag)).WithMany().OnDelete(DeleteBehavior.Restrict),
+                        l => l.HasOne(typeof(Post)).WithMany().OnDelete(DeleteBehavior.Restrict));
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region ManyToManyWithNoCascadeDeleteFullConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity(
+                        "PostTag",
+                        r => r.HasOne(typeof(Tag)).WithMany().HasForeignKey("TagsId").HasPrincipalKey(nameof(Tag.Id)).OnDelete(DeleteBehavior.Restrict),
+                        l => l.HasOne(typeof(Post)).WithMany().HasForeignKey("PostsId").HasPrincipalKey(nameof(Post.Id)).OnDelete(DeleteBehavior.Restrict),
+                        j => j.HasKey("PostsId", "TagsId"));
+            }
+            #endregion
+        }
+    }
+
+    public class SelfReferencingManyToMany
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new PeopleContext0();
+
+            Console.WriteLine("Bidirectional self-referencing many-to-many:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+            Console.WriteLine(schema);
+            Console.WriteLine();
+
+            using var context1 = new PeopleContext1();
+            Debug.Assert(schema == context1.Database.GenerateCreateScript());
+        }
+
+        #region SelfReferencingManyToMany
+        public class Person
+        {
+            public int Id { get; set; }
+            public List<Person> Parents { get; } = [];
+            public List<Person> Children { get; } = [];
+        }
+        #endregion
+
+        public class PeopleContext0 : DbContext
+        {
+            public DbSet<Person> People => Set<Person>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ManyToManyWithNoCascadeDelete{GetType().Name}.db");
+        }
+
+        public class PeopleContext1 : PeopleContext0
+        {
+            #region SelfReferencingManyToManyFullConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Person>()
+                    .HasMany(e => e.Children)
+                    .WithMany(e => e.Parents)
+                    .UsingEntity(
+                        "PersonPerson",
+                        r => r.HasOne(typeof(Person)).WithMany().HasForeignKey("ChildrenId").HasPrincipalKey(nameof(Person.Id)),
+                        l => l.HasOne(typeof(Person)).WithMany().HasForeignKey("ParentsId").HasPrincipalKey(nameof(Person.Id)),
+                        j => j.HasKey("ChildrenId", "ParentsId"));
+            }
+            #endregion
+        }
+    }
+
+    public class SelfReferencingUnidirectionalManyToMany
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new PeopleContext0();
+
+            Console.WriteLine("Unidirectional self-referencing many-to-many:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+            Console.WriteLine(schema);
+            Console.WriteLine();
+
+            using var context1 = new PeopleContext1();
+            Debug.Assert(schema == context1.Database.GenerateCreateScript());
+
+            var ginny = new Person();
+            var hermione = new Person();
+            ginny.Friends.Add(hermione);
+            hermione.Friends.Add(ginny);
+        }
+
+        #region SelfReferencingUnidirectionalManyToMany
+        public class Person
+        {
+            public int Id { get; set; }
+            public List<Person> Friends { get; } = [];
+        }
+        #endregion
+
+        public class PeopleContext0 : DbContext
+        {
+            public DbSet<Person> People => Set<Person>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ManyToManyWithNoCascadeDelete{GetType().Name}.db");
+
+            #region SelfReferencingUnidirectionalManyToManyConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Person>()
+                    .HasMany(e => e.Friends)
+                    .WithMany();
+            }
+            #endregion
+        }
+
+        public class PeopleContext1 : PeopleContext0
+        {
+            #region SelfReferencingUnidirectionalManyToManyFullConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Person>()
+                    .HasMany(e => e.Friends)
+                    .WithMany()
+                    .UsingEntity(
+                        "PersonPerson",
+                        r => r.HasOne(typeof(Person)).WithMany().HasForeignKey("FriendsId").HasPrincipalKey(nameof(Person.Id)),
+                        l => l.HasOne(typeof(Person)).WithMany().HasForeignKey("PersonId").HasPrincipalKey(nameof(Person.Id)),
+                        j => j.HasKey("FriendsId", "PersonId"));
+            }
+            #endregion
+        }
+    }
+
+    public class ManyToManyWithCustomSharedTypeEntityType
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+
+            Console.WriteLine("Many-to-many with a custom shared type entity type as a join entity type with payload:");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            var schema = context0.Database.GenerateCreateScript();
+            Console.WriteLine(schema);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(schema == context1.Database.GenerateCreateScript());
+        }
+
+        #region ManyToManyWithCustomSharedTypeEntityType
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; } = [];
+            public List<JoinType> PostTags { get; } = [];
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = [];
+            public List<JoinType> PostTags { get; } = [];
+        }
+
+        public class Blog
+        {
+            public int Id { get; set; }
+            public List<Author> Authors { get; } = [];
+            public List<JoinType> BlogAuthors { get; } = [];
+        }
+
+        public class Author
+        {
+            public int Id { get; set; }
+            public List<Blog> Blogs { get; } = [];
+            public List<JoinType> BlogAuthors { get; } = [];
+        }
+        #endregion
+
+        public class JoinType
+        {
+            public int Id1 { get; set; }
+            public int Id2 { get; set; }
+            public DateTime CreatedOn { get; set; }
+        }
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Post> Posts => Set<Post>();
+            public DbSet<Tag> Tags => Set<Tag>();
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Author> Authors => Set<Author>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ManyToManyWithPayloadAndNavsToJoinClass{GetType().Name}.db");
+
+            #region ManyToManyWithCustomSharedTypeEntityTypeConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<JoinType>(
+                        "PostTag",
+                        r => r.HasOne<Tag>().WithMany(e => e.PostTags).HasForeignKey(e => e.Id1),
+                        l => l.HasOne<Post>().WithMany(e => e.PostTags).HasForeignKey(e => e.Id2),
+                        j => j.Property(e => e.CreatedOn).HasDefaultValueSql("CURRENT_TIMESTAMP"));
+
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Authors)
+                    .WithMany(e => e.Blogs)
+                    .UsingEntity<JoinType>(
+                        "BlogAuthor",
+                        r => r.HasOne<Author>().WithMany(e => e.BlogAuthors).HasForeignKey(e => e.Id1),
+                        l => l.HasOne<Blog>().WithMany(e => e.BlogAuthors).HasForeignKey(e => e.Id2),
+                        j => j.Property(e => e.CreatedOn).HasDefaultValueSql("CURRENT_TIMESTAMP"));
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region ManyToManyWithCustomSharedTypeEntityTypeFullConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<JoinType>(
+                        "PostTag",
+                        r => r.HasOne<Tag>().WithMany(e => e.PostTags).HasForeignKey(e => e.Id1).HasPrincipalKey(e => e.Id),
+                        l => l.HasOne<Post>().WithMany(e => e.PostTags).HasForeignKey(e => e.Id2).HasPrincipalKey(e => e.Id),
+                        j =>
+                        {
+                            j.HasKey(e => new { e.Id1, e.Id2 });
+                            j.Property(e => e.CreatedOn).HasDefaultValueSql("CURRENT_TIMESTAMP");
+                        });
+
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Authors)
+                    .WithMany(e => e.Blogs)
+                    .UsingEntity<JoinType>(
+                        "BlogAuthor",
+                        r => r.HasOne<Author>().WithMany(e => e.BlogAuthors).HasForeignKey(e => e.Id1).HasPrincipalKey(e => e.Id),
+                        l => l.HasOne<Blog>().WithMany(e => e.BlogAuthors).HasForeignKey(e => e.Id2).HasPrincipalKey(e => e.Id),
+                        j =>
+                        {
+                            j.HasKey(e => new { e.Id1, e.Id2 });
+                            j.Property(e => e.CreatedOn).HasDefaultValueSql("CURRENT_TIMESTAMP");
+                        });
+            }
+            #endregion
+        }
+    }
+
+    public class DirectJoinTableNoManyToMany
+    {
+        public static async Task BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            await context0.Database.EnsureDeletedAsync();
+            await context0.Database.EnsureCreatedAsync();
+
+            Console.WriteLine("Directly mapping the join table without creating a many-to-many relationship:");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+        }
+
+        #region DirectJoinTableMapping
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<PostTag> PostTags { get; } = [];
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<PostTag> PostTags { get; } = [];
+        }
+
+        public class PostTag
+        {
+            public int PostsId { get; set; }
+            public int TagsId { get; set; }
+            public Post Post { get; set; } = null!;
+            public Tag Tag { get; set; } = null!;
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Post> Posts => Set<Post>();
+            public DbSet<Tag> Tags => Set<Tag>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ManyToManySimple{GetType().Name}.db");
+
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>().HasMany(e => e.PostTags).WithOne(e => e.Post).HasForeignKey(e => e.PostsId);
+                modelBuilder.Entity<Tag>().HasMany(e => e.PostTags).WithOne(e => e.Tag).HasForeignKey(e => e.TagsId);
+                modelBuilder.Entity<PostTag>().HasKey(e => new { e.PostsId, e.TagsId });
+            }
+        }
+    }
+
+    public class FullMappingWithJoinEntity
+    {
+        public static async Task BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            await context0.Database.EnsureDeletedAsync();
+            await context0.Database.EnsureCreatedAsync();
+
+            Console.WriteLine("Directly mapping the join table and including skip navigations for the many-to-many relationship:");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+        }
+
+        #region FullMappingWithJoinEntity
+        public class Post
+        {
+            public int Id { get; set; }
+            public List<PostTag> PostTags { get; } = [];
+            public List<Tag> Tags { get; } = [];
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public List<PostTag> PostTags { get; } = [];
+            public List<Post> Posts { get; } = [];
+        }
+
+        public class PostTag
+        {
+            public int PostsId { get; set; }
+            public int TagsId { get; set; }
+            public Post Post { get; set; } = null!;
+            public Tag Tag { get; set; } = null!;
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Post> Posts => Set<Post>();
+            public DbSet<Tag> Tags => Set<Tag>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ManyToManySimple{GetType().Name}.db");
+
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasMany(e => e.Tags)
+                    .WithMany(e => e.Posts)
+                    .UsingEntity<PostTag>(
+                        r => r.HasOne(e => e.Tag).WithMany(e => e.PostTags),
+                        l => l.HasOne(e => e.Post).WithMany(e => e.PostTags));
+            }
+        }
+    }
+}
diff --git a/samples/core/Modeling/Relationships/MappingAttributes.cs b/samples/core/Modeling/Relationships/MappingAttributes.cs
new file mode 100644
index 0000000000..66e6ec0067
--- /dev/null
+++ b/samples/core/Modeling/Relationships/MappingAttributes.cs
@@ -0,0 +1,465 @@
+#nullable disable
+
+using System;
+using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations;
+using System.ComponentModel.DataAnnotations.Schema;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships;
+
+public class MappingAttributes
+{
+    public class RequiredOnForeignKey
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Using [Required] on a foreign key property: ");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+        }
+
+        #region RequiredOnForeignKey
+        public class Blog
+        {
+            public string Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+
+            [Required]
+            public string BlogId { get; set; }
+
+            public Blog Blog { get; init; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredOnForeignKey{GetType().Name}.db");
+        }
+    }
+
+    public class RequiredOnDependentNavigation
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Using [Required] on a dependent navigation: ");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+        }
+
+        #region RequiredOnDependentNavigation
+        public class Blog
+        {
+            public string Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+
+            public string BlogId { get; set; }
+
+            [Required]
+            public Blog Blog { get; init; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredOnDependentNavigation{GetType().Name}.db");
+        }
+    }
+
+    public class RequiredOnDependentNavigationShadowFk
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Using [Required] on a dependent navigation with a shadow foreign key: ");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+        }
+
+        #region RequiredOnDependentNavigationShadowFk
+        public class Blog
+        {
+            public string Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+
+            [Required]
+            public Blog Blog { get; init; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredOnDependentNavigationShadowFk{GetType().Name}.db");
+        }
+    }
+
+    public class ForeignKeyOnProperty
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Using [ForeignKey] on a foreign key property: ");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+        }
+
+        #region ForeignKeyOnProperty
+        public class Blog
+        {
+            public string Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+
+            [ForeignKey(nameof(Blog))]
+            public string BlogKey { get; set; }
+
+            public Blog Blog { get; init; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ForeignKeyOnProperty{GetType().Name}.db");
+        }
+    }
+
+    public class ForeignKeyOnDependentNavigation
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Using [ForeignKey] on a dependent navigation: ");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+        }
+
+        #region ForeignKeyOnDependentNavigation
+        public class Blog
+        {
+            public string Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+
+            public string BlogKey { get; set; }
+
+            [ForeignKey(nameof(BlogKey))]
+            public Blog Blog { get; init; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ForeignKeyOnDependentNavigation{GetType().Name}.db");
+        }
+    }
+
+    public class ForeignKeyOnPrincipalNavigation
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Using [ForeignKey] on a principal navigation: ");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+        }
+
+        #region ForeignKeyOnPrincipalNavigation
+        public class Blog
+        {
+            public string Id { get; set; }
+
+            [ForeignKey(nameof(Post.BlogKey))]
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public string BlogKey { get; set; }
+            public Blog Blog { get; init; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ForeignKeyOnPrincipalNavigation{GetType().Name}.db");
+        }
+    }
+
+    public class ForeignKeyOnDependentNavigationShadowFk
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Using [ForeignKey] on a dependent navigation with a shadow foreign key: ");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+        }
+
+        #region ForeignKeyOnDependentNavigationShadowFk
+        public class Blog
+        {
+            public string Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+
+            [ForeignKey("BlogKey")]
+            public Blog Blog { get; init; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ForeignKeyOnDependentNavigationShadowFk{GetType().Name}.db");
+        }
+    }
+
+    public class ForeignKeyOnPrincipalNavigationShadowFk
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Using [ForeignKey] on a principal navigation with a shadow foreign key: ");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+        }
+
+        #region ForeignKeyOnPrincipalNavigationShadowFk
+        public class Blog
+        {
+            public string Id { get; set; }
+
+            [ForeignKey("BlogKey")]
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public Blog Blog { get; init; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ForeignKeyOnPrincipalNavigationShadowFk{GetType().Name}.db");
+        }
+    }
+
+    public class InverseOnDependentNavigation
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Using [InverseProperty] on a dependent navigation: ");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+        }
+
+        #region InverseOnDependentNavigation
+        public class Blog
+        {
+            public int Id { get; set; }
+
+            public List<Post> Posts { get; } = new();
+
+            public int FeaturedPostId { get; set; }
+            public Post FeaturedPost { get; set; }
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; }
+
+            [InverseProperty("Posts")]
+            public Blog Blog { get; init; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = InverseOnDependentNavigation{GetType().Name}.db");
+        }
+    }
+
+    public class InverseOnPrincipalNavigation
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Using [InverseProperty] on a principal navigation: ");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+        }
+
+        #region InverseOnPrincipalNavigation
+        public class Blog
+        {
+            public int Id { get; set; }
+
+            [InverseProperty("Blog")]
+            public List<Post> Posts { get; } = new();
+
+            public int FeaturedPostId { get; set; }
+            public Post FeaturedPost { get; set; }
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; }
+
+            public Blog Blog { get; init; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = InverseOnPrincipalNavigation{GetType().Name}.db");
+        }
+    }
+
+    public class DeleteBehaviorOnDependentNavigation
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Using [DeleteBehavior] on the dependent navigation: ");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+        }
+
+        #region DeleteBehaviorOnDependentNavigation
+        public class Blog
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; }
+
+            [DeleteBehavior(DeleteBehavior.Restrict)]
+            public Blog Blog { get; init; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = DeleteBehaviorOnDependentNavigation{GetType().Name}.db");
+        }
+    }
+
+    public class DeleteBehaviorOnPrincipalNavigation
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Using [DeleteBehavior] on the principal navigation: ");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+        }
+
+        #region DeleteBehaviorOnPrincipalNavigation
+        public class Blog
+        {
+            public int Id { get; set; }
+            public List<Post> Posts { get; } = new();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; }
+
+            [DeleteBehavior(DeleteBehavior.Restrict)]
+            public Blog Blog { get; init; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = DeleteBehaviorOnPrincipalNavigation{GetType().Name}.db");
+        }
+    }
+}
diff --git a/samples/core/Modeling/Relationships/NoForeignKey.cs b/samples/core/Modeling/Relationships/NoForeignKey.cs
new file mode 100644
index 0000000000..c57a94b3bf
--- /dev/null
+++ b/samples/core/Modeling/Relationships/NoForeignKey.cs
@@ -0,0 +1,29 @@
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships.NoForeignKey;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+}
+
+#region NoForeignKey
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public List<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public Blog Blog { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/Relationships/OneNavigation.cs b/samples/core/Modeling/Relationships/OneNavigation.cs
new file mode 100644
index 0000000000..c6aca12cd9
--- /dev/null
+++ b/samples/core/Modeling/Relationships/OneNavigation.cs
@@ -0,0 +1,27 @@
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships.OneNavigation;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+}
+
+#region OneNavigation
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public List<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/Relationships/OneToMany.cs b/samples/core/Modeling/Relationships/OneToMany.cs
new file mode 100644
index 0000000000..1bae0ce107
--- /dev/null
+++ b/samples/core/Modeling/Relationships/OneToMany.cs
@@ -0,0 +1,2031 @@
+#nullable enable
+
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships;
+
+public class OneToMany
+{
+    public class Required
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-many: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToManyRequired
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>(); // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; } // Required foreign key property
+            public Blog Blog { get; set; } = null!; // Required reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = Required{GetType().Name}.db");
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToManyRequiredFromPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToManyRequiredFromDependent
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasOne(e => e.Blog)
+                    .WithMany(e => e.Posts)
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class Optional
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Optional one-to-many: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToManyOptional
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>(); // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public int? BlogId { get; set; } // Optional foreign key property
+            public Blog? Blog { get; set; } // Optional reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = Optional{GetType().Name}.db");
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToManyOptionalFromPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToManyOptionalFromDependent
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasOne(e => e.Blog)
+                    .WithMany(e => e.Posts)
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredWithShadowFk
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-many with shadow foreign key property: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToManyRequiredShadow
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>(); // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public Blog Blog { get; set; } = null!; // Required reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredShadow{GetType().Name}.db");
+
+            #region OneToManyRequiredShadowConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToManyRequiredShadowFromPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey("BlogId")
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToManyRequiredShadowFromDependent
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasOne(e => e.Blog)
+                    .WithMany(e => e.Posts)
+                    .HasForeignKey("BlogId")
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class OptionalWithShadowFk
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Optional one-to-many with shadow foreign key property: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToManyOptionalShadow
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>(); // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public Blog? Blog { get; set; } // Optional reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = OptionalShadow{GetType().Name}.db");
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToManyOptionalShadowFromPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey("BlogId")
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToManyOptionalShadowFromDependent
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasOne(e => e.Blog)
+                    .WithMany(e => e.Posts)
+                    .HasForeignKey("BlogId")
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredNoNavigationToPrincipal
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-many with no navigation to principal: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToManyRequiredNoNavigationToPrincipal
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>(); // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; } // Required foreign key property
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredNoNavigationToPrincipal{GetType().Name}.db");
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToManyRequiredFromPrincipalNoNavigationToPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne()
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToManyRequiredFromDependentNoNavigationToPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasOne<Blog>()
+                    .WithMany(e => e.Posts)
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class OptionalNoNavigationToPrincipal
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Optional one-to-many with no navigation to principal: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToManyOptionalNoNavigationToPrincipal
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>(); // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public int? BlogId { get; set; } // Optional foreign key property
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = OptionalNoNavigationToPrincipal{GetType().Name}.db");
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToManyOptionalFromPrincipalNoNavigationToPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne()
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToManyOptionalFromDependentNoNavigationToPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasOne<Blog>()
+                    .WithMany(e => e.Posts)
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredWithShadowFkAndNoNavigationToPrincipal
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-many with shadow foreign key property and no navigation to principal: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToManyRequiredShadowNoNavigationToPrincipal
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>(); // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredShadowNoNavigationToPrincipal{GetType().Name}.db");
+
+            #region OneToManyRequiredShadowNoNavigationToPrincipalConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne()
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToManyRequiredShadowFromPrincipalNoNavigationToPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne()
+                    .HasForeignKey("BlogId")
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToManyRequiredShadowFromDependentNoNavigationToPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasOne<Blog>()
+                    .WithMany(e => e.Posts)
+                    .HasForeignKey("BlogId")
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class OptionalWithShadowFkAndNoNavigationToPrincipal
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Optional one-to-many with shadow foreign key property and no navigation to principal: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToManyOptionalShadowNoNavigationToPrincipal
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>(); // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = OptionalShadowNoNavigationToPrincipal{GetType().Name}.db");
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToManyOptionalShadowFromPrincipalNoNavigationToPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne()
+                    .HasForeignKey("BlogId")
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToManyOptionalShadowFromDependentNoNavigationToPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasOne<Blog>()
+                    .WithMany(e => e.Posts)
+                    .HasForeignKey("BlogId")
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredNoNavigationToDependents
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-many and no navigation to dependents: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToManyRequiredNoNavigationToDependents
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; } // Required foreign key property
+            public Blog Blog { get; set; } = null!; // Required reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredNoNavigationToDependents{GetType().Name}.db");
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToManyRequiredFromPrincipalNoNavigationToDependents
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany<Post>()
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToManyRequiredFromDependentNoNavigationToDependents
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasOne(e => e.Blog)
+                    .WithMany()
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class OptionalNoNavigationToDependents
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Optional one-to-many with no navigation to dependents: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToManyOptionalNoNavigationToDependents
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public int? BlogId { get; set; } // Optional foreign key property
+            public Blog? Blog { get; set; } // Optional reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = OptionalNoNavigationToDependents{GetType().Name}.db");
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToManyOptionalFromPrincipalNoNavigationToDependents
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany<Post>()
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToManyOptionalFromDependentNoNavigationToDependents
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasOne(e => e.Blog)
+                    .WithMany()
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredWithShadowFkAndNoNavigationToDependents
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-many with shadow foreign key property and no navigation to dependents: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToManyRequiredShadowNoNavigationToDependents
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public Blog Blog { get; set; } = null!; // Required reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredShadowNoNavigationToDependents{GetType().Name}.db");
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToManyRequiredShadowFromPrincipalNoNavigationToDependents
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany<Post>()
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey("BlogId")
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToManyRequiredShadowFromDependentNoNavigationToDependents
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasOne(e => e.Blog)
+                    .WithMany()
+                    .HasForeignKey("BlogId")
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class OptionalWithShadowFkAndNoNavigationToDependents
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Optional one-to-many with shadow foreign key property and no navigation to dependents: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToManyOptionalShadowNoNavigationToDependents
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public Blog? Blog { get; set; } // Optional reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = OptionalShadow{GetType().Name}.db");
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToManyOptionalShadowFromPrincipalNoNavigationToDependents
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany<Post>()
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey("BlogId")
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToManyOptionalShadowFromDependentNoNavigationToDependents
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasOne(e => e.Blog)
+                    .WithMany()
+                    .HasForeignKey("BlogId")
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredNoNavigations
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-many and no navigations: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToManyRequiredNoNavigations
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; } // Required foreign key property
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredNoNavigations{GetType().Name}.db");
+
+            #region OneToManyRequiredNoNavigationsConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany<Post>()
+                    .WithOne();
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToManyRequiredFromPrincipalNoNavigations
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany<Post>()
+                    .WithOne()
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToManyRequiredFromDependentNoNavigations
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasOne<Blog>()
+                    .WithMany()
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class OptionalNoNavigations
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Optional one-to-many with no navigations: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToManyOptionalNoNavigations
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public int? BlogId { get; set; } // Optional foreign key property
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = OptionalNoNavigations{GetType().Name}.db");
+
+            #region OneToManyOptionalNoNavigationsConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany<Post>()
+                    .WithOne();
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToManyOptionalFromPrincipalNoNavigations
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany<Post>()
+                    .WithOne()
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToManyOptionalFromDependentNoNavigations
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasOne<Blog>()
+                    .WithMany()
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredWithShadowFkAndNoNavigations
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-many with shadow foreign key property and no navigations: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToManyRequiredShadowNoNavigations
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredShadowNoNavigations{GetType().Name}.db");
+
+            #region OneToManyRequiredShadowNoNavigationsConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany<Post>()
+                    .WithOne()
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToManyRequiredShadowFromPrincipalNoNavigations
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany<Post>()
+                    .WithOne()
+                    .HasForeignKey("BlogId")
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToManyRequiredShadowFromDependentNoNavigations
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasOne<Blog>()
+                    .WithMany()
+                    .HasForeignKey("BlogId")
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class OptionalWithShadowFkAndNoNavigations
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Optional one-to-many with shadow foreign key property and no navigations: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToManyOptionalShadowNoNavigations
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = OptionalShadow{GetType().Name}.db");
+
+            #region OneToManyOptionalShadowNoNavigationsConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany<Post>()
+                    .WithOne();
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToManyOptionalShadowFromPrincipalNoNavigations
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany<Post>()
+                    .WithOne()
+                    .HasForeignKey("BlogId")
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToManyOptionalShadowFromDependentNoNavigations
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasOne<Blog>()
+                    .WithMany()
+                    .HasForeignKey("BlogId")
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredWithAlternateKey
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-many with alternate key: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToManyRequiredWithAlternateKey
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public int AlternateId { get; set; } // Alternate key as target of the Post.BlogId foreign key
+            public ICollection<Post> Posts { get; } = new List<Post>(); // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; } // Required foreign key property
+            public Blog Blog { get; set; } = null!; // Required reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredWithAlternateKey{GetType().Name}.db");
+
+            #region OneToManyRequiredWithAlternateKeyConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey(e => e.AlternateId);
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToManyRequiredFromPrincipalWithAlternateKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey(e => e.AlternateId)
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToManyRequiredFromDependentWithAlternateKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasOne(e => e.Blog)
+                    .WithMany(e => e.Posts)
+                    .HasPrincipalKey(e => e.AlternateId)
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class OptionalWithAlternateKey
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Optional one-to-many with alternate key: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToManyOptionalWithAlternateKey
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public int AlternateId { get; set; } // Alternate key as target of the Post.BlogId foreign key
+            public ICollection<Post> Posts { get; } = new List<Post>(); // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public int? BlogId { get; set; } // Optional foreign key property
+            public Blog? Blog { get; set; } // Optional reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = OptionalWithAlternateKey{GetType().Name}.db");
+
+            #region OneToManyOptionalWithAlternateKeyConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey(e => e.AlternateId);
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToManyOptionalFromPrincipalWithAlternateKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey(e => e.AlternateId)
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToManyOptionalFromDependentWithAlternateKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasOne(e => e.Blog)
+                    .WithMany(e => e.Posts)
+                    .HasPrincipalKey(e => e.AlternateId)
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredWithShadowFkWithAlternateKey
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-many with shadow foreign key property and alternate key: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToManyRequiredShadowWithAlternateKey
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public int AlternateId { get; set; } // Alternate key as target of the shadow foreign key
+            public ICollection<Post> Posts { get; } = new List<Post>(); // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public Blog Blog { get; set; } = null!; // Required reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredShadowWithAlternateKey{GetType().Name}.db");
+
+            #region OneToManyRequiredShadowWithAlternateKeyConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey(e => e.AlternateId)
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToManyRequiredShadowFromPrincipalWithAlternateKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey(e => e.AlternateId)
+                    .HasForeignKey("BlogAlternateId")
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToManyRequiredShadowFromDependentWithAlternateKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasOne(e => e.Blog)
+                    .WithMany(e => e.Posts)
+                    .HasPrincipalKey(e => e.AlternateId)
+                    .HasForeignKey("BlogAlternateId")
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class OptionalWithShadowFkWithAlternateKey
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Optional one-to-many with shadow foreign key property and alternate key: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToManyOptionalShadowWithAlternateKey
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public int AlternateId { get; set; } // Alternate key as target of the shadow foreign key
+            public ICollection<Post> Posts { get; } = new List<Post>(); // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public Blog? Blog { get; set; } // Optional reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = OptionalShadowWithAlternateKey{GetType().Name}.db");
+
+            #region OneToManyOptionalShadowWithAlternateKeyConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey(e => e.AlternateId);
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToManyOptionalShadowFromPrincipalWithAlternateKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey(e => e.AlternateId)
+                    .HasForeignKey("BlogAlternateId")
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToManyOptionalShadowFromDependentWithAlternateKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasOne(e => e.Blog)
+                    .WithMany(e => e.Posts)
+                    .HasPrincipalKey(e => e.AlternateId)
+                    .HasForeignKey("BlogAlternateId")
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredWithCompositeKey
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-many with composite key: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToManyRequiredWithCompositeKey
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id1 { get; set; } // Composite key part 1
+            public int Id2 { get; set; } // Composite key part 2
+            public ICollection<Post> Posts { get; } = new List<Post>(); // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public int BlogId1 { get; set; } // Required foreign key property part 1
+            public int BlogId2 { get; set; } // Required foreign key property part 2
+            public Blog Blog { get; set; } = null!; // Required reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredWithCompositeKey{GetType().Name}.db");
+
+            #region OneToManyRequiredWithCompositeKeyConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasKey(e => new { e.Id1, e.Id2 });
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToManyRequiredFromPrincipalWithCompositeKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>(
+                    nestedBuilder =>
+                    {
+                        nestedBuilder.HasKey(e => new { e.Id1, e.Id2 });
+
+                        nestedBuilder.HasMany(e => e.Posts)
+                            .WithOne(e => e.Blog)
+                            .HasPrincipalKey(e => new { e.Id1, e.Id2 })
+                            .HasForeignKey(e => new { e.BlogId1, e.BlogId2 })
+                            .IsRequired();
+                    });
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToManyRequiredFromDependentWithCompositeKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasKey(e => new { e.Id1, e.Id2 });
+
+                modelBuilder.Entity<Post>()
+                    .HasOne(e => e.Blog)
+                    .WithMany(e => e.Posts)
+                    .HasPrincipalKey(e => new { e.Id1, e.Id2 })
+                    .HasForeignKey(e => new { e.BlogId1, e.BlogId2 })
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class OptionalWithCompositeKey
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Optional one-to-many with composite key: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToManyOptionalWithCompositeKey
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id1 { get; set; } // Composite key part 1
+            public int Id2 { get; set; } // Composite key part 2
+            public ICollection<Post> Posts { get; } = new List<Post>(); // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public int BlogId1 { get; set; } // Optional foreign key property part 1
+            public int? BlogId2 { get; set; } // Optional foreign key property part 2
+            public Blog? Blog { get; set; } // Optional reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = OptionalWithCompositeKey{GetType().Name}.db");
+
+            #region OneToManyOptionalWithCompositeKeyConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasKey(e => new { e.Id1, e.Id2 });
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToManyOptionalFromPrincipalWithCompositeKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>(
+                    b =>
+                    {
+                        b.HasKey(e => new { e.Id1, e.Id2 });
+
+                        b.HasMany(e => e.Posts)
+                            .WithOne(e => e.Blog)
+                            .HasPrincipalKey(e => new { e.Id1, e.Id2 })
+                            .HasForeignKey(e => new { e.BlogId1, e.BlogId2 })
+                            .IsRequired(false);
+                    });
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToManyOptionalFromDependentWithCompositeKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasKey(e => new { e.Id1, e.Id2 });
+
+                modelBuilder.Entity<Post>()
+                    .HasOne(e => e.Blog)
+                    .WithMany(e => e.Posts)
+                    .HasPrincipalKey(e => new { e.Id1, e.Id2 })
+                    .HasForeignKey(e => new { e.BlogId1, e.BlogId2 })
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredWithShadowFkWithCompositeKey
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-many with shadow foreign key property and composite key: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToManyRequiredShadowWithCompositeKey
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id1 { get; set; } // Composite key part 1
+            public int Id2 { get; set; } // Composite key part 2
+            public ICollection<Post> Posts { get; } = new List<Post>(); // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public Blog Blog { get; set; } = null!; // Required reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredShadowWithCompositeKey{GetType().Name}.db");
+
+            #region OneToManyRequiredShadowWithCompositeKeyConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasKey(e => new { e.Id1, e.Id2 });
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToManyRequiredShadowFromPrincipalWithCompositeKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>(
+                    b =>
+                    {
+                        b.HasKey(e => new { e.Id1, e.Id2 });
+
+                        b.HasMany(e => e.Posts)
+                            .WithOne(e => e.Blog)
+                            .HasPrincipalKey(e => new { e.Id1, e.Id2 })
+                            .HasForeignKey("BlogId1", "BlogId2")
+                            .IsRequired();
+                    });
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToManyRequiredShadowFromDependentWithCompositeKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasKey(e => new { e.Id1, e.Id2 });
+
+                modelBuilder.Entity<Post>()
+                    .HasOne(e => e.Blog)
+                    .WithMany(e => e.Posts)
+                    .HasPrincipalKey(e => new { e.Id1, e.Id2 })
+                    .HasForeignKey("BlogId1", "BlogId2")
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class OptionalWithShadowFkWithCompositeKey
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Optional one-to-many with shadow foreign key property and composite key: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToManyOptionalShadowWithCompositeKey
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id1 { get; set; } // Composite key part 1
+            public int Id2 { get; set; } // Composite key part 2
+            public ICollection<Post> Posts { get; } = new List<Post>(); // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public Blog? Blog { get; set; } // Optional reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = OptionalShadowWithCompositeKey{GetType().Name}.db");
+
+            #region OneToManyOptionalShadowWithCompositeKeyConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasKey(e => new { e.Id1, e.Id2 });
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToManyOptionalShadowFromPrincipalWithCompositeKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>(
+                    b =>
+                    {
+                        b.HasKey(e => new { e.Id1, e.Id2 });
+
+                        b.HasMany(e => e.Posts)
+                            .WithOne(e => e.Blog)
+                            .HasPrincipalKey(e => new { e.Id1, e.Id2 })
+                            .HasForeignKey("BlogId1", "BlogId2")
+                            .IsRequired(false);
+                    });
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToManyOptionalShadowFromDependentWithCompositeKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasKey(e => new { e.Id1, e.Id2 });
+
+                modelBuilder.Entity<Post>()
+                    .HasOne(e => e.Blog)
+                    .WithMany(e => e.Posts)
+                    .HasPrincipalKey(e => new { e.Id1, e.Id2 })
+                    .HasForeignKey("BlogId1", "BlogId2")
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class SelfReferencing
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new EmployeeContext0();
+            Console.WriteLine("Self-referencing one-to-many: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new EmployeeContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+        }
+
+        #region SelfReferencing
+        public class Employee
+        {
+            public int Id { get; set; }
+
+            public int? ManagerId { get; set; } // Optional foreign key property
+            public Employee? Manager { get; set; } // Optional reference navigation to principal
+            public ICollection<Employee> Reports { get; } = new List<Employee>(); // Collection navigation containing dependents
+        }
+        #endregion
+
+        public class EmployeeContext0 : DbContext
+        {
+            public DbSet<Employee> Blogs => Set<Employee>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = SelfReferencing{GetType().Name}.db");
+        }
+
+        public class EmployeeContext1 : EmployeeContext0
+        {
+            #region SelfReferencingConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Employee>()
+                    .HasOne(e => e.Manager)
+                    .WithMany(e => e.Reports)
+                    .HasForeignKey(e => e.ManagerId)
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredWithoutCascadeDelete
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-many without cascade delete: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region RequiredWithoutCascadeDelete
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>(); // Collection navigation containing dependents
+        }
+
+        // Dependent (child)
+        public class Post
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; } // Required foreign key property
+            public Blog Blog { get; set; } = null!; // Required reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = Required{GetType().Name}.db");
+
+            #region RequiredWithoutCascadeDeleteConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .OnDelete(DeleteBehavior.Restrict);
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region RequiredWithoutCascadeDeleteFromPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasMany(e => e.Posts)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired()
+                    .OnDelete(DeleteBehavior.Restrict);
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region RequiredWithoutCascadeDeleteFromDependent
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Post>()
+                    .HasOne(e => e.Blog)
+                    .WithMany(e => e.Posts)
+                    .HasForeignKey(e => e.BlogId)
+                    .IsRequired()
+                    .OnDelete(DeleteBehavior.Restrict);
+            }
+            #endregion
+        }
+    }
+}
diff --git a/samples/core/Modeling/Relationships/OneToOne.cs b/samples/core/Modeling/Relationships/OneToOne.cs
new file mode 100644
index 0000000000..99fcfd2c3d
--- /dev/null
+++ b/samples/core/Modeling/Relationships/OneToOne.cs
@@ -0,0 +1,2189 @@
+#nullable enable
+
+using System;
+using System.Diagnostics;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships;
+
+public class OneToOne
+{
+    public class Required
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-one: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneRequired
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public BlogHeader? Header { get; set; } // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; } // Required foreign key property
+            public Blog Blog { get; set; } = null!; // Required reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = Required{GetType().Name}.db");
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneRequiredFromPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneRequiredFromDependent
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne(e => e.Header)
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class Optional
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Optional one-to-one: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneOptional
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public BlogHeader? Header { get; set; } // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public int? BlogId { get; set; } // Optional foreign key property
+            public Blog? Blog { get; set; } // Optional reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = Optional{GetType().Name}.db");
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneOptionalFromPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneOptionalFromDependent
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne(e => e.Header)
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredPkToPk
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-one with primary key to primary key relationship: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneRequiredPkToPk
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public BlogHeader? Header { get; set; } // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public Blog Blog { get; set; } = null!; // Required reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredPkToPk{GetType().Name}.db");
+
+            #region OneToOneRequiredPkToPkConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey<BlogHeader>();
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneRequiredPkToPkFromPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey<BlogHeader>(e => e.Id)
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneRequiredPkToPkFromDependent
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne(e => e.Header)
+                    .HasForeignKey<BlogHeader>(e => e.Id)
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredWithShadowFk
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-one with shadow foreign key property: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneRequiredShadow
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public BlogHeader? Header { get; set; } // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public Blog Blog { get; set; } = null!; // Required reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredShadow{GetType().Name}.db");
+
+            #region OneToOneRequiredShadowConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey<BlogHeader>("BlogId");
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneRequiredShadowFromPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey<BlogHeader>("BlogId")
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneRequiredShadowFromDependent
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne(e => e.Header)
+                    .HasForeignKey<BlogHeader>("BlogId")
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class OptionalWithShadowFk
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Optional one-to-one with shadow foreign key property: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneOptionalShadow
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public BlogHeader? Header { get; set; } // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public Blog? Blog { get; set; } // Optional reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = OptionalShadow{GetType().Name}.db");
+
+            #region OneToOneOptionalShadowConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey<BlogHeader>("BlogId");
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneOptionalShadowFromPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey<BlogHeader>("BlogId")
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneOptionalShadowFromDependent
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne(e => e.Header)
+                    .HasForeignKey<BlogHeader>("BlogId")
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredNoNavigationToPrincipal
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-one with no navigation to principal: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneRequiredNoNavigationToPrincipal
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public BlogHeader? Header { get; set; } // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; } // Required foreign key property
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredNoNavigationToPrincipal{GetType().Name}.db");
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneRequiredFromPrincipalNoNavigationToPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneRequiredFromDependentNoNavigationToPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne<Blog>()
+                    .WithOne(e => e.Header)
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class OptionalNoNavigationToPrincipal
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Optional one-to-one with no navigation to principal: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneOptionalNoNavigationToPrincipal
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public BlogHeader? Header { get; set; } // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public int? BlogId { get; set; } // Optional foreign key property
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = OptionalNoNavigationToPrincipal{GetType().Name}.db");
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneOptionalFromPrincipalNoNavigationToPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneOptionalFromDependentNoNavigationToPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne<Blog>()
+                    .WithOne(e => e.Header)
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredWithShadowFkAndNoNavigationToPrincipal
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-one with shadow foreign key property and no navigation to principal: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneRequiredShadowNoNavigationToPrincipal
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public BlogHeader? Header { get; set; } // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredShadowNoNavigationToPrincipal{GetType().Name}.db");
+
+            #region OneToOneRequiredShadowNoNavigationToPrincipalConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>("BlogId")
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneRequiredShadowFromPrincipalNoNavigationToPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>("BlogId")
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneRequiredShadowFromDependentNoNavigationToPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne<Blog>()
+                    .WithOne(e => e.Header)
+                    .HasForeignKey<BlogHeader>("BlogId")
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class OptionalWithShadowFkAndNoNavigationToPrincipal
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Optional one-to-one with shadow foreign key property and no navigation to principal: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneOptionalShadowNoNavigationToPrincipal
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public BlogHeader? Header { get; set; } // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = OptionalShadowNoNavigationToPrincipal{GetType().Name}.db");
+
+            #region OneToOneOptionalShadowNoNavigationToPrincipalConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>("BlogId");
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneOptionalShadowFromPrincipalNoNavigationToPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>("BlogId")
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneOptionalShadowFromDependentNoNavigationToPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne<Blog>()
+                    .WithOne(e => e.Header)
+                    .HasForeignKey<BlogHeader>("BlogId")
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredNoNavigationToDependents
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-one and no navigation to dependents: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneRequiredNoNavigationToDependents
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; } // Required foreign key property
+            public Blog Blog { get; set; } = null!; // Required reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredNoNavigationToDependents{GetType().Name}.db");
+
+            #region OneToOneRequiredNoNavigationToDependentsConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne();
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneRequiredFromPrincipalNoNavigationToDependents
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne<BlogHeader>()
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneRequiredFromDependentNoNavigationToDependents
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class OptionalNoNavigationToDependents
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Optional one-to-one with no navigation to dependents: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneOptionalNoNavigationToDependents
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public int? BlogId { get; set; } // Optional foreign key property
+            public Blog? Blog { get; set; } // Optional reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = OptionalNoNavigationToDependents{GetType().Name}.db");
+
+            #region OneToOneOptionalNoNavigationToDependentsConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne();
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneOptionalFromPrincipalNoNavigationToDependents
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne<BlogHeader>()
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneOptionalFromDependentNoNavigationToDependents
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredWithShadowFkAndNoNavigationToDependents
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-one with shadow foreign key property and no navigation to dependents: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneRequiredShadowNoNavigationToDependents
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public Blog Blog { get; set; } = null!; // Required reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredShadowNoNavigationToDependents{GetType().Name}.db");
+
+            #region OneToOneRequiredShadowNoNavigationToDependentsConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>("BlogId");
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneRequiredShadowFromPrincipalNoNavigationToDependents
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne<BlogHeader>()
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey<BlogHeader>("BlogId")
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneRequiredShadowFromDependentNoNavigationToDependents
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>("BlogId")
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class OptionalWithShadowFkAndNoNavigationToDependents
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Optional one-to-one with shadow foreign key property and no navigation to dependents: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneOptionalShadowNoNavigationToDependents
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public Blog? Blog { get; set; } // Optional reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = OptionalShadow{GetType().Name}.db");
+
+            #region OneToOneOptionalShadowNoNavigationToDependentsConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>("BlogId");
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneOptionalShadowFromPrincipalNoNavigationToDependents
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne<BlogHeader>()
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey<BlogHeader>("BlogId")
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneOptionalShadowFromDependentNoNavigationToDependents
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>("BlogId")
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredNoNavigations
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-one and no navigations: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneRequiredNoNavigations
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; } // Required foreign key property
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredNoNavigations{GetType().Name}.db");
+
+            #region OneToOneRequiredNoNavigationsConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne<BlogHeader>()
+                    .WithOne();
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneRequiredFromPrincipalNoNavigations
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne<BlogHeader>()
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneRequiredFromDependentNoNavigations
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne<Blog>()
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class OptionalNoNavigations
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Optional one-to-one with no navigations: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneOptionalNoNavigations
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public int? BlogId { get; set; } // Optional foreign key property
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = OptionalNoNavigations{GetType().Name}.db");
+
+            #region OneToOneOptionalNoNavigationsConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne<BlogHeader>()
+                    .WithOne();
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneOptionalFromPrincipalNoNavigations
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne<BlogHeader>()
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneOptionalFromDependentNoNavigations
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne<Blog>()
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredWithShadowFkAndNoNavigations
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-one with shadow foreign key property and no navigations: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneRequiredShadowNoNavigations
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredShadowNoNavigations{GetType().Name}.db");
+
+            #region OneToOneRequiredShadowNoNavigationsConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne<BlogHeader>()
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>("BlogId")
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneRequiredShadowFromPrincipalNoNavigations
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne<BlogHeader>()
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>("BlogId")
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneRequiredShadowFromDependentNoNavigations
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne<Blog>()
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>("BlogId")
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class OptionalWithShadowFkAndNoNavigations
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Optional one-to-one with shadow foreign key property and no navigations: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneOptionalShadowNoNavigations
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = OptionalShadow{GetType().Name}.db");
+
+            #region OneToOneOptionalShadowNoNavigationsConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne<BlogHeader>()
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>("BlogId");
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneOptionalShadowFromPrincipalNoNavigations
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne<BlogHeader>()
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>("BlogId")
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneOptionalShadowFromDependentNoNavigations
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne<Blog>()
+                    .WithOne()
+                    .HasForeignKey<BlogHeader>("BlogId")
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredWithAlternateKey
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-one with alternate key: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneRequiredWithAlternateKey
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public int AlternateId { get; set; } // Alternate key as target of the BlogHeader.BlogId foreign key
+            public BlogHeader? Header { get; set; } // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; } // Required foreign key property
+            public Blog Blog { get; set; } = null!; // Required reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredWithAlternateKey{GetType().Name}.db");
+
+            #region OneToOneRequiredWithAlternateKeyConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey<Blog>(e => e.AlternateId);
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneRequiredFromPrincipalWithAlternateKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey<Blog>(e => e.AlternateId)
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneRequiredFromDependentWithAlternateKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne(e => e.Header)
+                    .HasPrincipalKey<Blog>(e => e.AlternateId)
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class OptionalWithAlternateKey
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Optional one-to-one with alternate key: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneOptionalWithAlternateKey
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public int AlternateId { get; set; } // Alternate key as target of the BlogHeader.BlogId foreign key
+            public BlogHeader? Header { get; set; } // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public int? BlogId { get; set; } // Optional foreign key property
+            public Blog? Blog { get; set; } // Optional reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = OptionalWithAlternateKey{GetType().Name}.db");
+
+            #region OneToOneOptionalWithAlternateKeyConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey<Blog>(e => e.AlternateId);
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneOptionalFromPrincipalWithAlternateKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey<Blog>(e => e.AlternateId)
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneOptionalFromDependentWithAlternateKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne(e => e.Header)
+                    .HasPrincipalKey<Blog>(e => e.AlternateId)
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredWithShadowFkWithAlternateKey
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-one with shadow foreign key property and alternate key: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneRequiredShadowWithAlternateKey
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public int AlternateId { get; set; } // Alternate key as target of the shadow foreign key
+            public BlogHeader? Header { get; set; } // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public Blog Blog { get; set; } = null!; // Required reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredShadowWithAlternateKey{GetType().Name}.db");
+
+            #region OneToOneRequiredShadowWithAlternateKeyConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey<Blog>(e => e.AlternateId)
+                    .HasForeignKey<BlogHeader>("BlogAlternateId")
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneRequiredShadowFromPrincipalWithAlternateKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey<Blog>(e => e.AlternateId)
+                    .HasForeignKey<BlogHeader>("BlogAlternateId")
+                    .IsRequired();
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneRequiredShadowFromDependentWithAlternateKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne(e => e.Header)
+                    .HasPrincipalKey<Blog>(e => e.AlternateId)
+                    .HasForeignKey<BlogHeader>("BlogAlternateId")
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class OptionalWithShadowFkWithAlternateKey
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Optional one-to-one with shadow foreign key property and alternate key: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneOptionalShadowWithAlternateKey
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public int AlternateId { get; set; } // Alternate key as target of the shadow foreign key
+            public BlogHeader? Header { get; set; } // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public Blog? Blog { get; set; } // Optional reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = OptionalShadowWithAlternateKey{GetType().Name}.db");
+
+            #region OneToOneOptionalShadowWithAlternateKeyConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey<Blog>(e => e.AlternateId)
+                    .HasForeignKey<BlogHeader>("BlogAlternateId")
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneOptionalShadowFromPrincipalWithAlternateKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasPrincipalKey<Blog>(e => e.AlternateId)
+                    .HasForeignKey<BlogHeader>("BlogAlternateId")
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneOptionalShadowFromDependentWithAlternateKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne(e => e.Header)
+                    .HasPrincipalKey<Blog>(e => e.AlternateId)
+                    .HasForeignKey<BlogHeader>("BlogAlternateId")
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredWithCompositeKey
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-one with composite key: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneRequiredWithCompositeKey
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id1 { get; set; } // Composite key part 1
+            public int Id2 { get; set; } // Composite key part 2
+            public BlogHeader? Header { get; set; } // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public int BlogId1 { get; set; } // Required foreign key property part 1
+            public int BlogId2 { get; set; } // Required foreign key property part 2
+            public Blog Blog { get; set; } = null!; // Required reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredWithCompositeKey{GetType().Name}.db");
+
+            #region OneToOneRequiredWithCompositeKeyConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasKey(e => new { e.Id1, e.Id2 });
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneRequiredFromPrincipalWithCompositeKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>(
+                    nestedBuilder =>
+                    {
+                        nestedBuilder.HasKey(e => new { e.Id1, e.Id2 });
+
+                        nestedBuilder.HasOne(e => e.Header)
+                            .WithOne(e => e.Blog)
+                            .HasPrincipalKey<Blog>(e => new { e.Id1, e.Id2 })
+                            .HasForeignKey<BlogHeader>(e => new { e.BlogId1, e.BlogId2 })
+                            .IsRequired();
+                    });
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneRequiredFromDependentWithCompositeKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasKey(e => new { e.Id1, e.Id2 });
+
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne(e => e.Header)
+                    .HasPrincipalKey<Blog>(e => new { e.Id1, e.Id2 })
+                    .HasForeignKey<BlogHeader>(e => new { e.BlogId1, e.BlogId2 })
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class OptionalWithCompositeKey
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Optional one-to-one with composite key: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneOptionalWithCompositeKey
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id1 { get; set; } // Composite key part 1
+            public int Id2 { get; set; } // Composite key part 2
+            public BlogHeader? Header { get; set; } // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public int BlogId1 { get; set; } // Optional foreign key property part 1
+            public int? BlogId2 { get; set; } // Optional foreign key property part 2
+            public Blog? Blog { get; set; } // Optional reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = OptionalWithCompositeKey{GetType().Name}.db");
+
+            #region OneToOneOptionalWithCompositeKeyConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasKey(e => new { e.Id1, e.Id2 });
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneOptionalFromPrincipalWithCompositeKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>(
+                    b =>
+                    {
+                        b.HasKey(e => new { e.Id1, e.Id2 });
+
+                        b.HasOne(e => e.Header)
+                            .WithOne(e => e.Blog)
+                            .HasPrincipalKey<Blog>(e => new { e.Id1, e.Id2 })
+                            .HasForeignKey<BlogHeader>(e => new { e.BlogId1, e.BlogId2 })
+                            .IsRequired(false);
+                    });
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneOptionalFromDependentWithCompositeKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasKey(e => new { e.Id1, e.Id2 });
+
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne(e => e.Header)
+                    .HasPrincipalKey<Blog>(e => new { e.Id1, e.Id2 })
+                    .HasForeignKey<BlogHeader>(e => new { e.BlogId1, e.BlogId2 })
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredWithShadowFkWithCompositeKey
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-one with shadow foreign key property and composite key: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneRequiredShadowWithCompositeKey
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id1 { get; set; } // Composite key part 1
+            public int Id2 { get; set; } // Composite key part 2
+            public BlogHeader? Header { get; set; } // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public Blog Blog { get; set; } = null!; // Required reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = RequiredShadowWithCompositeKey{GetType().Name}.db");
+
+            #region OneToOneRequiredShadowWithCompositeKeyConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>(
+                    b =>
+                    {
+                        b.HasKey(e => new { e.Id1, e.Id2 });
+
+                        b.HasOne(e => e.Header)
+                            .WithOne(e => e.Blog)
+                            .HasPrincipalKey<Blog>(e => new { e.Id1, e.Id2 });
+                    });
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneRequiredShadowFromPrincipalWithCompositeKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>(
+                    b =>
+                    {
+                        b.HasKey(e => new { e.Id1, e.Id2 });
+
+                        b.HasOne(e => e.Header)
+                            .WithOne(e => e.Blog)
+                            .HasPrincipalKey<Blog>(e => new { e.Id1, e.Id2 })
+                            .HasForeignKey<BlogHeader>("BlogId1", "BlogId2")
+                            .IsRequired();
+                    });
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneRequiredShadowFromDependentWithCompositeKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasKey(e => new { e.Id1, e.Id2 });
+
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne(e => e.Header)
+                    .HasPrincipalKey<Blog>(e => new { e.Id1, e.Id2 })
+                    .HasForeignKey<BlogHeader>("BlogId1", "BlogId2")
+                    .IsRequired();
+            }
+            #endregion
+        }
+    }
+
+    public class OptionalWithShadowFkWithCompositeKey
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Optional one-to-one with shadow foreign key property and composite key: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region OneToOneOptionalShadowWithCompositeKey
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id1 { get; set; } // Composite key part 1
+            public int Id2 { get; set; } // Composite key part 2
+            public BlogHeader? Header { get; set; } // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public Blog? Blog { get; set; } // Optional reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = OptionalShadowWithCompositeKey{GetType().Name}.db");
+
+            #region OneToOneOptionalShadowWithCompositeKeyConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>(
+                    b =>
+                    {
+                        b.HasKey(e => new { e.Id1, e.Id2 });
+
+                        b.HasOne(e => e.Header)
+                            .WithOne(e => e.Blog)
+                            .HasPrincipalKey<Blog>(e => new { e.Id1, e.Id2 });
+                    });
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region OneToOneOptionalShadowFromPrincipalWithCompositeKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>(
+                    b =>
+                    {
+                        b.HasKey(e => new { e.Id1, e.Id2 });
+
+                        b.HasOne(e => e.Header)
+                            .WithOne(e => e.Blog)
+                            .HasPrincipalKey<Blog>(e => new { e.Id1, e.Id2 })
+                            .HasForeignKey<BlogHeader>("BlogId1", "BlogId2")
+                            .IsRequired(false);
+                    });
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region OneToOneOptionalShadowFromDependentWithCompositeKey
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasKey(e => new { e.Id1, e.Id2 });
+
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne(e => e.Header)
+                    .HasPrincipalKey<Blog>(e => new { e.Id1, e.Id2 })
+                    .HasForeignKey<BlogHeader>("BlogId1", "BlogId2")
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class SelfReferencing
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new PersonContext0();
+            Console.WriteLine("Self-referencing one-to-one: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new PersonContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+        }
+
+        #region SelfReferencing
+        public class Person
+        {
+            public int Id { get; set; }
+
+            public int? HusbandId { get; set; } // Optional foreign key property
+            public Person? Husband { get; set; } // Optional reference navigation to principal
+            public Person? Wife { get; set; } // Reference navigation to dependent
+        }
+        #endregion
+
+        public class PersonContext0 : DbContext
+        {
+            public DbSet<Person> People => Set<Person>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = SelfReferencing{GetType().Name}.db");
+        }
+
+        public class PersonContext1 : PersonContext0
+        {
+            #region SelfReferencingConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Person>()
+                    .HasOne(e => e.Husband)
+                    .WithOne(e => e.Wife)
+                    .HasForeignKey<Person>(e => e.HusbandId)
+                    .IsRequired(false);
+            }
+            #endregion
+        }
+    }
+
+    public class RequiredWithoutCascadeDelete
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Required one-to-one without cascade delete: ");
+            var modelDebugString = context0.Model.ToDebugString(indent: 2);
+            Console.WriteLine(modelDebugString);
+            Console.WriteLine();
+
+            using var context1 = new BlogContext1();
+            Debug.Assert(modelDebugString == context1.Model.ToDebugString(indent: 2));
+
+            using var context2 = new BlogContext2();
+            Debug.Assert(modelDebugString == context2.Model.ToDebugString(indent: 2));
+        }
+
+        #region RequiredWithoutCascadeDelete
+        // Principal (parent)
+        public class Blog
+        {
+            public int Id { get; set; }
+            public BlogHeader? Header { get; set; } // Reference navigation to dependent
+        }
+
+        // Dependent (child)
+        public class BlogHeader
+        {
+            public int Id { get; set; }
+            public int BlogId { get; set; } // Required foreign key property
+            public Blog Blog { get; set; } = null!; // Required reference navigation to principal
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+            public DbSet<BlogHeader> BlogHeaders => Set<BlogHeader>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = Required{GetType().Name}.db");
+
+            #region RequiredWithoutCascadeDeleteConfig
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .OnDelete(DeleteBehavior.Restrict);
+            }
+            #endregion
+        }
+
+        public class BlogContext1 : BlogContext0
+        {
+            #region RequiredWithoutCascadeDeleteFromPrincipal
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>()
+                    .HasOne(e => e.Header)
+                    .WithOne(e => e.Blog)
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired()
+                    .OnDelete(DeleteBehavior.Restrict);
+            }
+            #endregion
+        }
+
+        public class BlogContext2 : BlogContext0
+        {
+            #region RequiredWithoutCascadeDeleteFromDependent
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<BlogHeader>()
+                    .HasOne(e => e.Blog)
+                    .WithOne(e => e.Header)
+                    .HasForeignKey<BlogHeader>(e => e.BlogId)
+                    .IsRequired()
+                    .OnDelete(DeleteBehavior.Restrict);
+            }
+            #endregion
+        }
+    }
+}
diff --git a/samples/core/Modeling/Relationships/Program.cs b/samples/core/Modeling/Relationships/Program.cs
new file mode 100644
index 0000000000..31ecbc117f
--- /dev/null
+++ b/samples/core/Modeling/Relationships/Program.cs
@@ -0,0 +1,123 @@
+using System.Threading.Tasks;
+
+namespace EFModeling.Relationships;
+
+public class Program
+{
+    private static async Task Main()
+    {
+        OneToMany.Required.BuildModels();
+        OneToMany.Optional.BuildModels();
+        OneToMany.RequiredWithShadowFk.BuildModels();
+        OneToMany.OptionalWithShadowFk.BuildModels();
+        OneToMany.RequiredNoNavigationToPrincipal.BuildModels();
+        OneToMany.OptionalNoNavigationToPrincipal.BuildModels();
+        OneToMany.RequiredWithShadowFkAndNoNavigationToPrincipal.BuildModels();
+        OneToMany.OptionalWithShadowFkAndNoNavigationToPrincipal.BuildModels();
+        OneToMany.RequiredNoNavigationToDependents.BuildModels();
+        OneToMany.OptionalNoNavigationToDependents.BuildModels();
+        OneToMany.RequiredWithShadowFkAndNoNavigationToDependents.BuildModels();
+        OneToMany.OptionalWithShadowFkAndNoNavigationToDependents.BuildModels();
+        OneToMany.RequiredNoNavigations.BuildModels();
+        OneToMany.OptionalNoNavigations.BuildModels();
+        OneToMany.RequiredWithShadowFkAndNoNavigations.BuildModels();
+        OneToMany.OptionalWithShadowFkAndNoNavigations.BuildModels();
+        OneToMany.RequiredWithAlternateKey.BuildModels();
+        OneToMany.OptionalWithAlternateKey.BuildModels();
+        OneToMany.RequiredWithShadowFkWithAlternateKey.BuildModels();
+        OneToMany.OptionalWithShadowFkWithAlternateKey.BuildModels();
+        OneToMany.RequiredWithCompositeKey.BuildModels();
+        OneToMany.OptionalWithCompositeKey.BuildModels();
+        OneToMany.RequiredWithShadowFkWithCompositeKey.BuildModels();
+        OneToMany.OptionalWithShadowFkWithCompositeKey.BuildModels();
+        OneToMany.SelfReferencing.BuildModels();
+        OneToMany.RequiredWithoutCascadeDelete.BuildModels();
+
+        OneToOne.Required.BuildModels();
+        OneToOne.Optional.BuildModels();
+        OneToOne.RequiredPkToPk.BuildModels();
+        OneToOne.RequiredWithShadowFk.BuildModels();
+        OneToOne.OptionalWithShadowFk.BuildModels();
+        OneToOne.RequiredNoNavigationToPrincipal.BuildModels();
+        OneToOne.OptionalNoNavigationToPrincipal.BuildModels();
+        OneToOne.RequiredWithShadowFkAndNoNavigationToPrincipal.BuildModels();
+        OneToOne.OptionalWithShadowFkAndNoNavigationToPrincipal.BuildModels();
+        OneToOne.RequiredNoNavigationToDependents.BuildModels();
+        OneToOne.OptionalNoNavigationToDependents.BuildModels();
+        OneToOne.RequiredWithShadowFkAndNoNavigationToDependents.BuildModels();
+        OneToOne.OptionalWithShadowFkAndNoNavigationToDependents.BuildModels();
+        OneToOne.RequiredNoNavigations.BuildModels();
+        OneToOne.OptionalNoNavigations.BuildModels();
+        OneToOne.RequiredWithShadowFkAndNoNavigations.BuildModels();
+        OneToOne.OptionalWithShadowFkAndNoNavigations.BuildModels();
+        OneToOne.RequiredWithAlternateKey.BuildModels();
+        OneToOne.OptionalWithAlternateKey.BuildModels();
+        OneToOne.RequiredWithShadowFkWithAlternateKey.BuildModels();
+        OneToOne.OptionalWithShadowFkWithAlternateKey.BuildModels();
+        OneToOne.RequiredWithCompositeKey.BuildModels();
+        OneToOne.OptionalWithCompositeKey.BuildModels();
+        OneToOne.RequiredWithShadowFkWithCompositeKey.BuildModels();
+        OneToOne.OptionalWithShadowFkWithCompositeKey.BuildModels();
+        OneToOne.SelfReferencing.BuildModels();
+        OneToOne.RequiredWithoutCascadeDelete.BuildModels();
+
+        ManyToMany.BasicManyToMany.BuildModels();
+        ManyToMany.UnidirectionalManyToMany.BuildModels();
+        ManyToMany.ManyToManyNamedJoinTable.BuildModels();
+        ManyToMany.ManyToManyNamedForeignKeyColumns.BuildModels();
+        ManyToMany.ManyToManyWithJoinClass.BuildModels();
+        ManyToMany.ManyToManyWithNavsToJoinClass.BuildModels();
+        ManyToMany.ManyToManyWithNavsToAndFromJoinClass.BuildModels();
+        ManyToMany.ManyToManyWithNamedFksAndNavsToAndFromJoinClass.BuildModels();
+        ManyToMany.ManyToManyAlternateKeys.BuildModels();
+        ManyToMany.ManyToManyWithNavsAndAlternateKeys.BuildModels();
+        ManyToMany.ManyToManyWithJoinClassHavingPrimaryKey.BuildModels();
+        ManyToMany.ManyToManyWithPrimaryKeyInJoinEntity.BuildModels();
+        ManyToMany.ManyToManyWithPayloadAndNavsToJoinClass.BuildModels();
+        ManyToMany.ManyToManyWithNoCascadeDelete.BuildModels();
+        ManyToMany.SelfReferencingManyToMany.BuildModels();
+        ManyToMany.SelfReferencingUnidirectionalManyToMany.BuildModels();
+        ManyToMany.ManyToManyWithCustomSharedTypeEntityType.BuildModels();
+        await ManyToMany.DirectJoinTableNoManyToMany.BuildModels();
+        await ManyToMany.FullMappingWithJoinEntity.BuildModels();
+
+        RelationshipConventions.ReferenceNavigations.BuildModels();
+        RelationshipConventions.CollectionNavigations.BuildModels();
+
+        RelationshipConventions.OneToManySingleRelationship.BuildModels();
+        RelationshipConventions.OneToOneSingleRelationship.BuildModels();
+        RelationshipConventions.ManyToManySingleRelationship.BuildModels();
+        RelationshipConventions.NavigationPrincipalKeyFKName.BuildModels();
+        RelationshipConventions.NavigationIdFKName.BuildModels();
+        RelationshipConventions.PrincipalTypePrincipalKeyFKName.BuildModels();
+        RelationshipConventions.PrincipalTypeIdFKName.BuildModels();
+
+        ForeignAndPrincipalKeys.ForeignKeyConfigurationByLambda.BuildModels();
+        ForeignAndPrincipalKeys.CompositeForeignKeyConfigurationByLambda.BuildModels();
+        ForeignAndPrincipalKeys.ForeignKeyConfigurationByString.BuildModels();
+        ForeignAndPrincipalKeys.CompositeForeignKeyConfigurationByString.BuildModels();
+        ForeignAndPrincipalKeys.RequiredForeignKey.BuildModels();
+        ForeignAndPrincipalKeys.ShadowForeignKey.BuildModels();
+        ForeignAndPrincipalKeys.ForeignKeyConstraintName.BuildModels();
+        ForeignAndPrincipalKeys.AlternateKeyConfigurationByLambda.BuildModels();
+        ForeignAndPrincipalKeys.CompositeAlternateKeyConfigurationByLambda.BuildModels();
+        ForeignAndPrincipalKeys.AlternateKeyConfigurationByString.BuildModels();
+        ForeignAndPrincipalKeys.CompositeAlternateKeyConfigurationByString.BuildModels();
+        ForeignAndPrincipalKeys.ForeignKeyInKeylessType.BuildModels();
+        ForeignAndPrincipalKeys.ManyToManyForeignKeyConstraintNames.BuildModels();
+        ForeignAndPrincipalKeys.NavigationConfiguration.BuildModels();
+
+        MappingAttributes.RequiredOnForeignKey.BuildModels();
+        MappingAttributes.RequiredOnDependentNavigation.BuildModels();
+        MappingAttributes.RequiredOnDependentNavigationShadowFk.BuildModels();
+        MappingAttributes.ForeignKeyOnProperty.BuildModels();
+        MappingAttributes.ForeignKeyOnDependentNavigation.BuildModels();
+        MappingAttributes.ForeignKeyOnPrincipalNavigation.BuildModels();
+        MappingAttributes.ForeignKeyOnDependentNavigationShadowFk.BuildModels();
+        MappingAttributes.ForeignKeyOnPrincipalNavigationShadowFk.BuildModels();
+        MappingAttributes.InverseOnDependentNavigation.BuildModels();
+        MappingAttributes.InverseOnPrincipalNavigation.BuildModels();
+        MappingAttributes.DeleteBehaviorOnDependentNavigation.BuildModels();
+        MappingAttributes.DeleteBehaviorOnPrincipalNavigation.BuildModels();
+    }
+}
diff --git a/samples/core/Modeling/Relationships/RelationshipConventions.cs b/samples/core/Modeling/Relationships/RelationshipConventions.cs
new file mode 100644
index 0000000000..5de3f1a996
--- /dev/null
+++ b/samples/core/Modeling/Relationships/RelationshipConventions.cs
@@ -0,0 +1,359 @@
+#nullable enable
+
+using System;
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Relationships;
+
+public class RelationshipConventions
+{
+    public class ReferenceNavigations
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Reference navigation discovery model: ");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+        }
+
+        #region ReferenceNavigations
+        public class Blog
+        {
+            // Not discovered as reference navigations:
+            public int Id { get; set; }
+            public string Title { get; set; } = null!;
+            public Uri? Uri { get; set; }
+            public ConsoleKeyInfo ConsoleKeyInfo { get; set; }
+            public Author DefaultAuthor => new() { Name = $"Author of the blog {Title}" };
+
+            // Discovered as a reference navigation:
+            public Author? Author { get; private set; }
+        }
+
+        public class Author
+        {
+            // Not discovered as reference navigations:
+            public Guid Id { get; set; }
+            public string Name { get; set; } = null!;
+            public int BlogId { get; set; }
+
+            // Discovered as a reference navigation:
+            public Blog Blog { get; init; } = null!;
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ReferenceNavigations{GetType().Name}.db");
+
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>().Ignore(e => e.ConsoleKeyInfo);
+            }
+        }
+    }
+
+    public class CollectionNavigations
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Collection navigation discovery model: ");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+        }
+
+        #region CollectionNavigations
+        public class Blog
+        {
+            public int Id { get; set; }
+            public List<Tag> Tags { get; set; } = null!;
+        }
+
+        public class Tag
+        {
+            public Guid Id { get; set; }
+            public IEnumerable<Blog> Blogs { get; } = new List<Blog>();
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = CollectionNavigations{GetType().Name}.db");
+        }
+    }
+
+    public class OneToManySingleRelationship
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Single one-to-many relationship: ");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            Console.WriteLine(context0.Database.GenerateCreateScript());
+            Console.WriteLine();
+        }
+
+        #region OneToManySingleRelationship
+        public class Blog
+        {
+            public int Id { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public int? BlogId { get; set; }
+            public Blog? Blog { get; set; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = OneToManySingleRelationship{GetType().Name}.db");
+        }
+    }
+
+    public class OneToOneSingleRelationship
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Single one-to-one relationship: ");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            Console.WriteLine(context0.Database.GenerateCreateScript());
+            Console.WriteLine();
+        }
+
+        #region OneToOneSingleRelationship
+        public class Blog
+        {
+            public int Id { get; set; }
+            public Author? Author { get; set; }
+        }
+
+        public class Author
+        {
+            public int Id { get; set; }
+            public int? BlogId { get; set; }
+            public Blog? Blog { get; set; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = OneToOneSingleRelationship{GetType().Name}.db");
+        }
+    }
+
+    public class ManyToManySingleRelationship
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Single many-to-many relationship: ");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+
+            Console.WriteLine(context0.Database.GenerateCreateScript());
+            Console.WriteLine();
+        }
+
+        #region ManyToManySingleRelationship
+        public class Post
+        {
+            public int Id { get; set; }
+            public ICollection<Tag> Tags { get; } = new List<Tag>();
+        }
+
+        public class Tag
+        {
+            public int Id { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>();
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Post> Posts => Set<Post>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = ManyToManySingleRelationship{GetType().Name}.db");
+        }
+    }
+
+    public class NavigationPrincipalKeyFKName
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Foreign key property discovered because it matches <navigation property name><principal key property name>: ");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+        }
+
+        #region NavigationPrincipalKeyFKName
+        public class Blog
+        {
+            public int Key { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public int? TheBlogKey { get; set; }
+            public Blog? TheBlog { get; set; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = NavigationPrincipalKeyFKName{GetType().Name}.db");
+
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>().HasKey(e => e.Key);
+            }
+        }
+    }
+
+    public class NavigationIdFKName
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Foreign key property discovered because it matches <navigation property name>Id: ");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+        }
+
+        #region NavigationIdFKName
+        public class Blog
+        {
+            public int Key { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public int? TheBlogID { get; set; }
+            public Blog? TheBlog { get; set; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = NavigationIdFKName{GetType().Name}.db");
+
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>().HasKey(e => e.Key);
+            }
+        }
+    }
+
+    public class PrincipalTypePrincipalKeyFKName
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Foreign key property discovered because it matches <principal entity type name><principal key property name>: ");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+        }
+
+        #region PrincipalTypePrincipalKeyFKName
+        public class Blog
+        {
+            public int Key { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public int? BlogKey { get; set; }
+            public Blog? TheBlog { get; set; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = PrincipalTypePrincipalKeyFKName{GetType().Name}.db");
+
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>().HasKey(e => e.Key);
+            }
+        }
+    }
+
+    public class PrincipalTypeIdFKName
+    {
+        public static void BuildModels()
+        {
+            using var context0 = new BlogContext0();
+            Console.WriteLine("Foreign key property discovered because it matches <principal entity type name>Id: ");
+            Console.WriteLine(context0.Model.ToDebugString(indent: 2));
+            Console.WriteLine();
+        }
+
+        #region PrincipalTypeIdFKName
+        public class Blog
+        {
+            public int Key { get; set; }
+            public ICollection<Post> Posts { get; } = new List<Post>();
+        }
+
+        public class Post
+        {
+            public int Id { get; set; }
+            public int? Blogid { get; set; }
+            public Blog? TheBlog { get; set; }
+        }
+        #endregion
+
+        public class BlogContext0 : DbContext
+        {
+            public DbSet<Blog> Blogs => Set<Blog>();
+
+            protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+                => optionsBuilder.UseSqlite($"DataSource = PrincipalTypeIdFKName{GetType().Name}.db");
+
+            protected override void OnModelCreating(ModelBuilder modelBuilder)
+            {
+                modelBuilder.Entity<Blog>().HasKey(e => e.Key);
+            }
+        }
+    }
+}
diff --git a/samples/core/Modeling/Relationships/Relationships.csproj b/samples/core/Modeling/Relationships/Relationships.csproj
new file mode 100644
index 0000000000..7b5a03102d
--- /dev/null
+++ b/samples/core/Modeling/Relationships/Relationships.csproj
@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFModeling.Relationships</RootNamespace>
+    <AssemblyName>EFModeling.Relationships</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Modeling/Sequences/Program.cs b/samples/core/Modeling/Sequences/Program.cs
new file mode 100644
index 0000000000..6db57a2a6a
--- /dev/null
+++ b/samples/core/Modeling/Sequences/Program.cs
@@ -0,0 +1,8 @@
+namespace EFModeling.Sequences;
+
+internal class Program
+{
+    private static void Main(string[] args)
+    {
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/Sequences/Sequence.cs b/samples/core/Modeling/Sequences/Sequence.cs
new file mode 100644
index 0000000000..47a6958b03
--- /dev/null
+++ b/samples/core/Modeling/Sequences/Sequence.cs
@@ -0,0 +1,26 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Sequences.Sequence;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Order> Orders { get; set; }
+
+    #region Sequence
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.HasSequence<int>("OrderNumbers");
+
+        modelBuilder.Entity<Order>()
+            .Property(o => o.OrderNo)
+            .HasDefaultValueSql("NEXT VALUE FOR OrderNumbers");
+    }
+    #endregion
+}
+
+public class Order
+{
+    public int OrderId { get; set; }
+    public int OrderNo { get; set; }
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/Sequences/SequenceConfiguration.cs b/samples/core/Modeling/Sequences/SequenceConfiguration.cs
new file mode 100644
index 0000000000..1ba169dd0d
--- /dev/null
+++ b/samples/core/Modeling/Sequences/SequenceConfiguration.cs
@@ -0,0 +1,24 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.Seqiemces.SequenceConfiguration;
+
+internal class MyContext : DbContext
+{
+    public DbSet<Order> Orders { get; set; }
+
+    #region SequenceConfiguration
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.HasSequence<int>("OrderNumbers", schema: "shared")
+            .StartsAt(1000)
+            .IncrementsBy(5);
+    }
+    #endregion
+}
+
+public class Order
+{
+    public int OrderId { get; set; }
+    public int OrderNo { get; set; }
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/Sequences/Sequences.csproj b/samples/core/Modeling/Sequences/Sequences.csproj
new file mode 100644
index 0000000000..c53bbb9889
--- /dev/null
+++ b/samples/core/Modeling/Sequences/Sequences.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFModeling.Sequences</RootNamespace>
+    <AssemblyName>EFModeling.Sequences</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Modeling/ShadowAndIndexerProperties/IndexerProperty.cs b/samples/core/Modeling/ShadowAndIndexerProperties/IndexerProperty.cs
new file mode 100644
index 0000000000..bb0c66bfec
--- /dev/null
+++ b/samples/core/Modeling/ShadowAndIndexerProperties/IndexerProperty.cs
@@ -0,0 +1,29 @@
+using System;
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.ShadowAndIndexerProperties.IndexerProperty;
+
+#region IndexerProperty
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>().IndexerProperty<DateTime>("LastUpdated");
+    }
+}
+
+public class Blog
+{
+    private readonly Dictionary<string, object> _data = new Dictionary<string, object>();
+    public int BlogId { get; set; }
+
+    public object this[string key]
+    {
+        get => _data[key];
+        set => _data[key] = value;
+    }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/ShadowAndIndexerProperties/Program.cs b/samples/core/Modeling/ShadowAndIndexerProperties/Program.cs
new file mode 100644
index 0000000000..4cbec279fc
--- /dev/null
+++ b/samples/core/Modeling/ShadowAndIndexerProperties/Program.cs
@@ -0,0 +1,8 @@
+namespace EFModeling.ShadowAndIndexerProperties;
+
+internal class Program
+{
+    private static void Main(string[] args)
+    {
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Modeling/ShadowAndIndexerProperties/ShadowAndIndexerProperties.csproj b/samples/core/Modeling/ShadowAndIndexerProperties/ShadowAndIndexerProperties.csproj
new file mode 100644
index 0000000000..5d44dca98f
--- /dev/null
+++ b/samples/core/Modeling/ShadowAndIndexerProperties/ShadowAndIndexerProperties.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFModeling.ShadowAndIndexerProperties</RootNamespace>
+    <AssemblyName>EFModeling.ShadowAndIndexerProperties</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Modeling/ShadowAndIndexerProperties/ShadowForeignKey.cs b/samples/core/Modeling/ShadowAndIndexerProperties/ShadowForeignKey.cs
new file mode 100644
index 0000000000..e5ca790dd5
--- /dev/null
+++ b/samples/core/Modeling/ShadowAndIndexerProperties/ShadowForeignKey.cs
@@ -0,0 +1,31 @@
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.ShadowAndIndexerProperties.ShadowForeignKey;
+
+#region Conventions
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public List<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    // Since there is no CLR property which holds the foreign
+    // key for this relationship, a shadow property is created.
+    public Blog Blog { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/ShadowAndIndexerProperties/ShadowProperty.cs b/samples/core/Modeling/ShadowAndIndexerProperties/ShadowProperty.cs
new file mode 100644
index 0000000000..e15a77d732
--- /dev/null
+++ b/samples/core/Modeling/ShadowAndIndexerProperties/ShadowProperty.cs
@@ -0,0 +1,23 @@
+using System;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.ShadowAndIndexerProperties.ShadowProperty;
+
+#region ShadowProperty
+internal class MyContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .Property<DateTime>("LastUpdated");
+    }
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/ShadowAndIndexerProperties/SharedType.cs b/samples/core/Modeling/ShadowAndIndexerProperties/SharedType.cs
new file mode 100644
index 0000000000..d887f4e25b
--- /dev/null
+++ b/samples/core/Modeling/ShadowAndIndexerProperties/SharedType.cs
@@ -0,0 +1,23 @@
+using System;
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.ShadowAndIndexerProperties.SharedType;
+
+#region SharedType
+internal class MyContext : DbContext
+{
+    public DbSet<Dictionary<string, object>> Blogs => Set<Dictionary<string, object>>("Blog");
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.SharedTypeEntity<Dictionary<string, object>>(
+            "Blog", bb =>
+            {
+                bb.Property<int>("BlogId");
+                bb.Property<string>("Url");
+                bb.Property<DateTime>("LastUpdated");
+            });
+    }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/TableSplitting/DetailedOrder.cs b/samples/core/Modeling/TableSplitting/DetailedOrder.cs
new file mode 100644
index 0000000000..06f52e0422
--- /dev/null
+++ b/samples/core/Modeling/TableSplitting/DetailedOrder.cs
@@ -0,0 +1,12 @@
+namespace EFModeling.TableSplitting;
+
+#region DetailedOrder
+public class DetailedOrder
+{
+    public int Id { get; set; }
+    public OrderStatus? Status { get; set; }
+    public string BillingAddress { get; set; }
+    public string ShippingAddress { get; set; }
+    public byte[] Version { get; set; }
+}
+#endregion
diff --git a/samples/core/Modeling/TableSplitting/Order.cs b/samples/core/Modeling/TableSplitting/Order.cs
new file mode 100644
index 0000000000..c5918764d9
--- /dev/null
+++ b/samples/core/Modeling/TableSplitting/Order.cs
@@ -0,0 +1,10 @@
+namespace EFModeling.TableSplitting;
+
+#region Order
+public class Order
+{
+    public int Id { get; set; }
+    public OrderStatus? Status { get; set; }
+    public DetailedOrder DetailedOrder { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/TableSplitting/OrderStatus.cs b/samples/core/Modeling/TableSplitting/OrderStatus.cs
new file mode 100644
index 0000000000..c15b1a5a07
--- /dev/null
+++ b/samples/core/Modeling/TableSplitting/OrderStatus.cs
@@ -0,0 +1,9 @@
+namespace EFModeling.TableSplitting;
+
+#region OrderStatus
+public enum OrderStatus
+{
+    Pending,
+    Shipped
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Modeling/TableSplitting/Program.cs b/samples/core/Modeling/TableSplitting/Program.cs
new file mode 100644
index 0000000000..ee981e3b10
--- /dev/null
+++ b/samples/core/Modeling/TableSplitting/Program.cs
@@ -0,0 +1,46 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.TableSplitting;
+
+public static class Program
+{
+    private static async Task Main(string[] args)
+    {
+        #region Usage
+        using (var context = new TableSplittingContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            context.Add(
+                new Order
+                {
+                    Status = OrderStatus.Pending,
+                    DetailedOrder = new DetailedOrder
+                    {
+                        Status = OrderStatus.Pending,
+                        ShippingAddress = "221 B Baker St, London",
+                        BillingAddress = "11 Wall Street, New York"
+                    }
+                });
+
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new TableSplittingContext())
+        {
+            var pendingCount = await context.Orders.CountAsync(o => o.Status == OrderStatus.Pending);
+            Console.WriteLine($"Current number of pending orders: {pendingCount}");
+        }
+
+        using (var context = new TableSplittingContext())
+        {
+            var order = await context.DetailedOrders.FirstAsync(o => o.Status == OrderStatus.Pending);
+            Console.WriteLine($"First pending order will ship to: {order.ShippingAddress}");
+        }
+        #endregion
+    }
+}
diff --git a/samples/core/Modeling/TableSplitting/TableSplitting.csproj b/samples/core/Modeling/TableSplitting/TableSplitting.csproj
new file mode 100644
index 0000000000..c97f267653
--- /dev/null
+++ b/samples/core/Modeling/TableSplitting/TableSplitting.csproj
@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFModeling.TableSplitting</RootNamespace>
+    <AssemblyName>EFModeling.TableSplitting</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Modeling/TableSplitting/TableSplittingContext.cs b/samples/core/Modeling/TableSplitting/TableSplittingContext.cs
new file mode 100644
index 0000000000..23b2810454
--- /dev/null
+++ b/samples/core/Modeling/TableSplitting/TableSplittingContext.cs
@@ -0,0 +1,43 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.TableSplitting;
+
+public class TableSplittingContext : DbContext
+{
+    public DbSet<Order> Orders { get; set; }
+    public DbSet<DetailedOrder> DetailedOrders { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFTableSplitting;Trusted_Connection=True;ConnectRetryCount=0");
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        #region TableSplitting
+        modelBuilder.Entity<DetailedOrder>(
+            dob =>
+            {
+                dob.ToTable("Orders");
+                dob.Property(o => o.Status).HasColumnName("Status");
+            });
+
+        modelBuilder.Entity<Order>(
+            ob =>
+            {
+                ob.ToTable("Orders");
+                ob.Property(o => o.Status).HasColumnName("Status");
+                ob.HasOne(o => o.DetailedOrder).WithOne()
+                    .HasForeignKey<DetailedOrder>(o => o.Id);
+                ob.Navigation(o => o.DetailedOrder).IsRequired();
+            });
+        #endregion
+
+        #region ConcurrencyToken
+        modelBuilder.Entity<Order>()
+            .Property<byte[]>("Version").IsRowVersion().HasColumnName("Version");
+
+        modelBuilder.Entity<DetailedOrder>()
+            .Property(o => o.Version).IsRowVersion().HasColumnName("Version");
+        #endregion
+    }
+}
diff --git a/samples/core/Modeling/ValueConversions/CaseInsensitiveStrings.cs b/samples/core/Modeling/ValueConversions/CaseInsensitiveStrings.cs
new file mode 100644
index 0000000000..8289ea8955
--- /dev/null
+++ b/samples/core/Modeling/ValueConversions/CaseInsensitiveStrings.cs
@@ -0,0 +1,108 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.ChangeTracking;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace EFModeling.ValueConversions;
+
+public class CaseInsensitiveStrings : Program
+{
+    public async Task Run()
+    {
+        ConsoleWriteLines("Sample showing value conversions for case-insensitive string keys...");
+
+        using (var context = new SampleDbContext())
+        {
+            await CleanDatabase(context);
+
+            ConsoleWriteLines("Save new entities...");
+
+            context.AddRange(
+                new Blog
+                {
+                    Id = "dotnet",
+                    Name = ".NET Blog",
+                },
+                new Post
+                {
+                    Id = "post1",
+                    BlogId = "dotnet",
+                    Title = "Some good .NET stuff"
+                },
+                new Post
+                {
+                    Id = "Post2",
+                    BlogId = "DotNet",
+                    Title = "Some more good .NET stuff"
+                });
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SampleDbContext())
+        {
+            ConsoleWriteLines("Read the entities back...");
+
+            var blog = await context.Set<Blog>().Include(e => e.Posts).SingleAsync();
+
+            ConsoleWriteLines($"The blog has {blog.Posts.Count} posts with foreign keys '{blog.Posts.First().BlogId}' and '{blog.Posts.Skip(1).First().BlogId}'");
+        }
+
+        ConsoleWriteLines("Sample finished.");
+    }
+
+    public class SampleDbContext : DbContext
+    {
+        #region ConfigureCaseInsensitiveStrings
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            var comparer = new ValueComparer<string>(
+                (l, r) => string.Equals(l, r, StringComparison.OrdinalIgnoreCase),
+                v => v.ToUpper().GetHashCode(),
+                v => v);
+
+            modelBuilder.Entity<Blog>()
+                .Property(e => e.Id)
+                .Metadata.SetValueComparer(comparer);
+
+            modelBuilder.Entity<Post>(
+                b =>
+                {
+                    b.Property(e => e.Id).Metadata.SetValueComparer(comparer);
+                    b.Property(e => e.BlogId).Metadata.SetValueComparer(comparer);
+                });
+        }
+        #endregion
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted })
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=CaseInsensitiveStrings;Trusted_Connection=True;ConnectRetryCount=0")
+                .EnableSensitiveDataLogging();
+    }
+
+    #region CaseInsensitiveStringsModel
+    public class Blog
+    {
+        public string Id { get; set; }
+        public string Name { get; set; }
+
+        public ICollection<Post> Posts { get; set; }
+    }
+
+    public class Post
+    {
+        public string Id { get; set; }
+        public string Title { get; set; }
+        public string Content { get; set; }
+
+        public string BlogId { get; set; }
+        public Blog Blog { get; set; }
+    }
+    #endregion
+}
diff --git a/samples/core/Modeling/ValueConversions/CompositeValueObject.cs b/samples/core/Modeling/ValueConversions/CompositeValueObject.cs
new file mode 100644
index 0000000000..4e72a32133
--- /dev/null
+++ b/samples/core/Modeling/ValueConversions/CompositeValueObject.cs
@@ -0,0 +1,94 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
+
+using System;
+using System.Linq;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace EFModeling.ValueConversions;
+
+public class CompositeValueObject : Program
+{
+    public async Task Run()
+    {
+        ConsoleWriteLines("Sample showing value conversions for a composite value object...");
+
+        using (var context = new SampleDbContext())
+        {
+            await CleanDatabase(context);
+
+            ConsoleWriteLines("Save a new entity...");
+
+            context.Add(new Order { Price = new Money(3.99m, Currency.UsDollars) });
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SampleDbContext())
+        {
+            ConsoleWriteLines("Read the entity back...");
+
+            var order = await context.Set<Order>().SingleAsync();
+
+            ConsoleWriteLines($"Order with price {order.Price.Amount} in {order.Price.Currency}.");
+        }
+
+        ConsoleWriteLines("Sample finished.");
+    }
+
+    public class SampleDbContext : DbContext
+    {
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region ConfigureCompositeValueObject
+            modelBuilder.Entity<Order>()
+                .Property(e => e.Price)
+                .HasConversion(
+                    v => JsonSerializer.Serialize(v, (JsonSerializerOptions)null),
+                    v => JsonSerializer.Deserialize<Money>(v, (JsonSerializerOptions)null));
+            #endregion
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted })
+                .UseSqlite("DataSource=test.db")
+                .EnableSensitiveDataLogging();
+    }
+
+    #region CompositeValueObjectModel
+    public class Order
+    {
+        public int Id { get; set; }
+
+        public Money Price { get; set; }
+    }
+    #endregion
+
+    #region CompositeValueObject
+    public readonly struct Money
+    {
+        [JsonConstructor]
+        public Money(decimal amount, Currency currency)
+        {
+            Amount = amount;
+            Currency = currency;
+        }
+
+        public override string ToString()
+            => (Currency == Currency.UsDollars ? "$" : "£") + Amount;
+
+        public decimal Amount { get; }
+        public Currency Currency { get; }
+    }
+
+    public enum Currency
+    {
+        UsDollars,
+        PoundsSterling
+    }
+    #endregion
+}
diff --git a/samples/core/Modeling/ValueConversions/EncryptPropertyValues.cs b/samples/core/Modeling/ValueConversions/EncryptPropertyValues.cs
new file mode 100644
index 0000000000..7928514b44
--- /dev/null
+++ b/samples/core/Modeling/ValueConversions/EncryptPropertyValues.cs
@@ -0,0 +1,66 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
+
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace EFModeling.ValueConversions;
+
+public class EncryptPropertyValues : Program
+{
+    public async Task Run()
+    {
+        ConsoleWriteLines("Sample showing value conversions for encrypting property values...");
+
+        using (var context = new SampleDbContext())
+        {
+            await CleanDatabase(context);
+
+            ConsoleWriteLines("Save a new entity...");
+
+            context.Add(new User { Name = "arthur", Password = "password" });
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SampleDbContext())
+        {
+            ConsoleWriteLines("Read the entity back...");
+
+            var user = await context.Set<User>().SingleAsync();
+
+            ConsoleWriteLines($"User {user.Name} has password '{user.Password}'");
+        }
+
+        ConsoleWriteLines("Sample finished.");
+    }
+
+    public class SampleDbContext : DbContext
+    {
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region ConfigureEncryptPropertyValues
+            modelBuilder.Entity<User>().Property(e => e.Password).HasConversion(
+                v => new string(v.Reverse().ToArray()),
+                v => new string(v.Reverse().ToArray()));
+            #endregion
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted })
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EncryptPropertyValues;Trusted_Connection=True;ConnectRetryCount=0")
+                .EnableSensitiveDataLogging();
+    }
+
+    #region EncryptPropertyValuesModel
+    public class User
+    {
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public string Password { get; set; }
+    }
+    #endregion
+}
diff --git a/samples/core/Modeling/ValueConversions/EnumToStringConversions.cs b/samples/core/Modeling/ValueConversions/EnumToStringConversions.cs
new file mode 100644
index 0000000000..d5699145d8
--- /dev/null
+++ b/samples/core/Modeling/ValueConversions/EnumToStringConversions.cs
@@ -0,0 +1,321 @@
+using System;
+using System.ComponentModel.DataAnnotations.Schema;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+namespace EFModeling.ValueConversions;
+
+public class EnumToStringConversions : Program
+{
+    public async Task Run()
+    {
+        ConsoleWriteLines("Sample showing explicitly configured value converter");
+
+        using (var context = new SampleDbContextExplicit())
+        {
+            await CleanDatabase(context);
+
+            context.Add(new Rider { Mount = EquineBeast.Horse });
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SampleDbContextExplicit())
+        {
+            ConsoleWriteLines($"Enum value read as '{(await context.Set<Rider>().SingleAsync()).Mount}'.");
+        }
+
+        ConsoleWriteLines("Sample showing conversion configured by CLR type");
+
+        using (var context = new SampleDbContextByClrType())
+        {
+            await CleanDatabase(context);
+
+            context.Add(new Rider { Mount = EquineBeast.Horse });
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SampleDbContextByClrType())
+        {
+            ConsoleWriteLines($"Enum value read as '{(await context.Set<Rider>().SingleAsync()).Mount}'.");
+        }
+
+        ConsoleWriteLines("Sample showing conversion configured by database type");
+
+        using (var context = new SampleDbContextByDatabaseType())
+        {
+            await CleanDatabase(context);
+
+            context.Add(new Rider2 { Mount = EquineBeast.Horse });
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SampleDbContextByDatabaseType())
+        {
+            ConsoleWriteLines($"Enum value read as '{(await context.Set<Rider2>().SingleAsync()).Mount}'.");
+        }
+
+        ConsoleWriteLines("Sample showing conversion configured by a ValueConverter instance");
+
+        using (var context = new SampleDbContextByConverterInstance())
+        {
+            await CleanDatabase(context);
+
+            context.Add(new Rider { Mount = EquineBeast.Horse });
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SampleDbContextByConverterInstance())
+        {
+            ConsoleWriteLines($"Enum value read as '{(await context.Set<Rider>().SingleAsync()).Mount}'.");
+        }
+
+        ConsoleWriteLines("Sample showing conversion configured by a built-in ValueConverter instance");
+
+        using (var context = new SampleDbContextByBuiltInInstance())
+        {
+            await CleanDatabase(context);
+
+            context.Add(new Rider { Mount = EquineBeast.Horse });
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SampleDbContextByBuiltInInstance())
+        {
+            ConsoleWriteLines($"Enum value read as '{(await context.Set<Rider>().SingleAsync()).Mount}'.");
+        }
+
+        ConsoleWriteLines("Sample showing conversion configured by CLR type with per-property facets");
+
+        using (var context = new SampleDbContextByClrTypeWithFacets())
+        {
+            await CleanDatabase(context);
+
+            context.Add(new Rider { Mount = EquineBeast.Horse });
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SampleDbContextByClrTypeWithFacets())
+        {
+            ConsoleWriteLines($"Enum value read as '{(await context.Set<Rider>().SingleAsync()).Mount}'.");
+        }
+
+        ConsoleWriteLines("Sample showing conversion configured by a ValueConverter instance with per-property facets");
+
+        using (var context = new SampleDbContextByConverterInstanceWithFacets())
+        {
+            await CleanDatabase(context);
+
+            context.Add(new Rider { Mount = EquineBeast.Horse });
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SampleDbContextByConverterInstanceWithFacets())
+        {
+            ConsoleWriteLines($"Enum value read as '{(await context.Set<Rider>().SingleAsync()).Mount}'.");
+        }
+    }
+
+    public class SampleDbContextExplicit : SampleDbContextBase
+    {
+        #region ExplicitConversion
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder
+                .Entity<Rider>()
+                .Property(e => e.Mount)
+                .HasConversion(
+                    v => v.ToString(),
+                    v => (EquineBeast)Enum.Parse(typeof(EquineBeast), v));
+        }
+        #endregion
+    }
+
+    public class SampleDbContextByClrType : SampleDbContextBase
+    {
+        #region ConversionByClrType
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder
+                .Entity<Rider>()
+                .Property(e => e.Mount)
+                .HasConversion<string>();
+        }
+        #endregion
+    }
+
+    public class SampleDbContextByDatabaseType : SampleDbContextBase
+    {
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Rider2>();
+        }
+    }
+
+    public class SampleDbContextByConverterInstance : SampleDbContextBase
+    {
+        #region ConversionByConverterInstance
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            var converter = new ValueConverter<EquineBeast, string>(
+                v => v.ToString(),
+                v => (EquineBeast)Enum.Parse(typeof(EquineBeast), v));
+
+            modelBuilder
+                .Entity<Rider>()
+                .Property(e => e.Mount)
+                .HasConversion(converter);
+        }
+        #endregion
+    }
+
+    public class SampleDbContextByClrTypeWithFacets : SampleDbContextBase
+    {
+        #region ConversionByClrTypeWithFacets
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder
+                .Entity<Rider>()
+                .Property(e => e.Mount)
+                .HasConversion<string>()
+                .HasMaxLength(20)
+                .IsUnicode(false);
+        }
+        #endregion
+    }
+
+    public class SampleDbContextByConverterInstanceWithFacets : SampleDbContextBase
+    {
+        #region ConversionByConverterInstanceWithFacets
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            var converter = new ValueConverter<EquineBeast, string>(
+                v => v.ToString(),
+                v => (EquineBeast)Enum.Parse(typeof(EquineBeast), v));
+
+            modelBuilder
+                .Entity<Rider>()
+                .Property(e => e.Mount)
+                .HasConversion(converter)
+                .HasMaxLength(20)
+                .IsUnicode(false);
+        }
+        #endregion
+    }
+
+    public class SampleDbContextByConverterInstanceWithMappingHints : SampleDbContextBase
+    {
+        #region ConversionByConverterInstanceWithMappingHints
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            var converter = new ValueConverter<EquineBeast, string>(
+                v => v.ToString(),
+                v => (EquineBeast)Enum.Parse(typeof(EquineBeast), v),
+                new ConverterMappingHints(size: 20, unicode: false));
+
+            modelBuilder
+                .Entity<Rider>()
+                .Property(e => e.Mount)
+                .HasConversion(converter);
+        }
+        #endregion
+    }
+
+    public class SampleDbContextByBuiltInInstance : SampleDbContextBase
+    {
+        #region ConversionByBuiltInInstance
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            var converter = new EnumToStringConverter<EquineBeast>();
+
+            modelBuilder
+                .Entity<Rider>()
+                .Property(e => e.Mount)
+                .HasConversion(converter);
+        }
+        #endregion
+    }
+
+    public class SampleDbContextBoolToInt : SampleDbContextBase
+    {
+        #region ConversionByBuiltInBoolToInt
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder
+                .Entity<User>()
+                .Property(e => e.IsActive)
+                .HasConversion<int>();
+        }
+        #endregion
+    }
+
+    public class SampleDbContextBoolToIntExplicit : SampleDbContextBase
+    {
+        #region ConversionByBuiltInBoolToIntExplicit
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            var converter = new BoolToZeroOneConverter<int>();
+
+            modelBuilder
+                .Entity<User>()
+                .Property(e => e.IsActive)
+                .HasConversion(converter);
+        }
+        #endregion
+    }
+
+    public class SampleDbContextRider2 : SampleDbContextBase
+    {
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region ConversionByDatabaseTypeFluent
+            modelBuilder
+                .Entity<Rider2>()
+                .Property(e => e.Mount)
+                .HasColumnType("nvarchar(24)");
+            #endregion
+        }
+    }
+    public class SampleDbContextBase : DbContext
+    {
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted })
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EnumConversions;Trusted_Connection=True;ConnectRetryCount=0")
+                .EnableSensitiveDataLogging();
+    }
+
+    #region BeastAndRider
+    public class Rider
+    {
+        public int Id { get; set; }
+        public EquineBeast Mount { get; set; }
+    }
+
+    public enum EquineBeast
+    {
+        Donkey,
+        Mule,
+        Horse,
+        Unicorn
+    }
+    #endregion
+
+    #region ConversionByDatabaseType
+    public class Rider2
+    {
+        public int Id { get; set; }
+
+        [Column(TypeName = "nvarchar(24)")]
+        public EquineBeast Mount { get; set; }
+    }
+    #endregion
+
+    public class User
+    {
+        public int Id { get; set; }
+        public bool IsActive { get; set; }
+    }
+}
diff --git a/samples/core/Modeling/ValueConversions/FixedLengthStrings.cs b/samples/core/Modeling/ValueConversions/FixedLengthStrings.cs
new file mode 100644
index 0000000000..8499488ccc
--- /dev/null
+++ b/samples/core/Modeling/ValueConversions/FixedLengthStrings.cs
@@ -0,0 +1,114 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.ChangeTracking;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+namespace EFModeling.ValueConversions;
+
+public class FixedLengthStrings : Program
+{
+    public async Task Run()
+    {
+        ConsoleWriteLines("Sample showing value conversions for fixed-length, case-insensitive string keys...");
+
+        using (var context = new SampleDbContext())
+        {
+            await CleanDatabase(context);
+
+            ConsoleWriteLines("Save new entities...");
+
+            context.AddRange(
+                new Blog
+                {
+                    Id = "dotnet",
+                    Name = ".NET Blog",
+                },
+                new Post
+                {
+                    Id = "post1",
+                    BlogId = "dotnet",
+                    Title = "Some good .NET stuff"
+                },
+                new Post
+                {
+                    Id = "Post2",
+                    BlogId = "DotNet",
+                    Title = "Some more good .NET stuff"
+                });
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SampleDbContext())
+        {
+            ConsoleWriteLines("Read the entities back...");
+
+            var blog = await context.Set<Blog>().Include(e => e.Posts).SingleAsync();
+
+            ConsoleWriteLines($"The blog has {blog.Posts.Count} posts with foreign keys '{blog.Posts.First().BlogId}' and '{blog.Posts.Skip(1).First().BlogId}'");
+        }
+
+        ConsoleWriteLines("Sample finished.");
+    }
+
+    public class SampleDbContext : DbContext
+    {
+        #region ConfigureFixedLengthStrings
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            var converter = new ValueConverter<string, string>(
+                v => v,
+                v => v.Trim());
+
+            var comparer = new ValueComparer<string>(
+                (l, r) => string.Equals(l, r, StringComparison.OrdinalIgnoreCase),
+                v => v.ToUpper().GetHashCode(),
+                v => v);
+
+            modelBuilder.Entity<Blog>()
+                .Property(e => e.Id)
+                .HasColumnType("char(20)")
+                .HasConversion(converter, comparer);
+
+            modelBuilder.Entity<Post>(
+                b =>
+                {
+                    b.Property(e => e.Id).HasColumnType("char(20)").HasConversion(converter, comparer);
+                    b.Property(e => e.BlogId).HasColumnType("char(20)").HasConversion(converter, comparer);
+                });
+        }
+        #endregion
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted })
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=FixedLengthStrings;Trusted_Connection=True;ConnectRetryCount=0")
+                .EnableSensitiveDataLogging();
+    }
+
+    #region FixedLengthStringsModel
+    public class Blog
+    {
+        public string Id { get; set; }
+        public string Name { get; set; }
+
+        public ICollection<Post> Posts { get; set; }
+    }
+
+    public class Post
+    {
+        public string Id { get; set; }
+        public string Title { get; set; }
+        public string Content { get; set; }
+
+        public string BlogId { get; set; }
+        public Blog Blog { get; set; }
+    }
+    #endregion
+}
diff --git a/samples/core/Modeling/ValueConversions/KeyValueObjects.cs b/samples/core/Modeling/ValueConversions/KeyValueObjects.cs
new file mode 100644
index 0000000000..534bb44baf
--- /dev/null
+++ b/samples/core/Modeling/ValueConversions/KeyValueObjects.cs
@@ -0,0 +1,116 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+namespace EFModeling.ValueConversions;
+
+public class KeyValueObjects : Program
+{
+    public async Task Run()
+    {
+        ConsoleWriteLines("Sample showing value conversions for a value objects used as keys...");
+
+        using (var context = new SampleDbContext())
+        {
+            await CleanDatabase(context);
+
+            ConsoleWriteLines("Save a new entity...");
+
+            var blog = new Blog
+            {
+                Id = new BlogKey(1),
+                Posts = new List<Post>
+                {
+                    new Post
+                    {
+                        Id = new PostKey(1)
+                    },
+                    new Post
+                    {
+                        Id = new PostKey(2)
+                    },
+                }
+            };
+            context.Add(blog);
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SampleDbContext())
+        {
+            ConsoleWriteLines("Read the entity back...");
+
+            var blog = await context.Set<Blog>().Include(e => e.Posts).SingleAsync();
+        }
+
+        ConsoleWriteLines("Sample finished.");
+    }
+
+    public class SampleDbContext : DbContext
+    {
+        #region ConfigureKeyValueObjects
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            var blogKeyConverter = new ValueConverter<BlogKey, int>(
+                v => v.Id,
+                v => new BlogKey(v));
+
+            modelBuilder.Entity<Blog>().Property(e => e.Id).HasConversion(blogKeyConverter);
+
+            modelBuilder.Entity<Post>(
+                b =>
+                {
+                    b.Property(e => e.Id).HasConversion(v => v.Id, v => new PostKey(v));
+                    b.Property(e => e.BlogId).HasConversion(blogKeyConverter);
+                });
+        }
+        #endregion
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted })
+                .UseSqlite("DataSource=test.db")
+                .EnableSensitiveDataLogging();
+    }
+
+    #region KeyValueObjectsModel
+    public class Blog
+    {
+        public BlogKey Id { get; set; }
+        public string Name { get; set; }
+
+        public ICollection<Post> Posts { get; set; }
+    }
+
+    public class Post
+    {
+        public PostKey Id { get; set; }
+
+        public string Title { get; set; }
+        public string Content { get; set; }
+
+        public BlogKey? BlogId { get; set; }
+        public Blog Blog { get; set; }
+    }
+    #endregion
+
+    #region KeyValueObjects
+    public readonly struct BlogKey
+    {
+        public BlogKey(int id) => Id = id;
+        public int Id { get; }
+    }
+
+    public readonly struct PostKey
+    {
+        public PostKey(int id) => Id = id;
+        public int Id { get; }
+    }
+    #endregion
+}
diff --git a/samples/core/Modeling/ValueConversions/MappingImmutableClassProperty.cs b/samples/core/Modeling/ValueConversions/MappingImmutableClassProperty.cs
new file mode 100644
index 0000000000..3f86be68ab
--- /dev/null
+++ b/samples/core/Modeling/ValueConversions/MappingImmutableClassProperty.cs
@@ -0,0 +1,95 @@
+using System.Diagnostics;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Logging;
+
+namespace EFModeling.ValueConversions;
+
+public class MappingImmutableClassProperty : Program
+{
+    public async Task Run()
+    {
+        ConsoleWriteLines("Sample showing value conversions for a simple immutable class...");
+
+        using (var context = new SampleDbContext())
+        {
+            await CleanDatabase(context);
+
+            ConsoleWriteLines("Save a new entity...");
+
+            var entity = new MyEntityType { MyProperty = new ImmutableClass(7) };
+            context.Add(entity);
+            await context.SaveChangesAsync();
+
+            ConsoleWriteLines("Change the property value and save again...");
+
+            // This will be detected and EF will update the database on SaveChanges
+            entity.MyProperty = new ImmutableClass(77);
+
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SampleDbContext())
+        {
+            ConsoleWriteLines("Read the entity back...");
+
+            var entity = await context.Set<MyEntityType>().SingleAsync();
+
+            Debug.Assert(entity.MyProperty.Value == 77);
+        }
+
+        ConsoleWriteLines("Sample finished.");
+    }
+
+    public class SampleDbContext : DbContext
+    {
+        private static readonly ILoggerFactory
+            Logger = LoggerFactory.Create(x => x.AddConsole()); //.SetMinimumLevel(LogLevel.Debug));
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region ConfigureImmutableClassProperty
+            modelBuilder
+                .Entity<MyEntityType>()
+                .Property(e => e.MyProperty)
+                .HasConversion(
+                    v => v.Value,
+                    v => new ImmutableClass(v));
+            #endregion
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .UseLoggerFactory(Logger)
+                .UseSqlite("DataSource=test.db")
+                .EnableSensitiveDataLogging();
+    }
+
+    public class MyEntityType
+    {
+        public int Id { get; set; }
+        public ImmutableClass MyProperty { get; set; }
+    }
+
+    #region SimpleImmutableClass
+    public sealed class ImmutableClass
+    {
+        public ImmutableClass(int value)
+        {
+            Value = value;
+        }
+
+        public int Value { get; }
+
+        private bool Equals(ImmutableClass other)
+            => Value == other.Value;
+
+        public override bool Equals(object obj)
+            => ReferenceEquals(this, obj) || obj is ImmutableClass other && Equals(other);
+
+        public override int GetHashCode()
+            => Value.GetHashCode();
+    }
+    #endregion
+}
diff --git a/samples/core/Modeling/ValueConversions/MappingImmutableStructProperty.cs b/samples/core/Modeling/ValueConversions/MappingImmutableStructProperty.cs
new file mode 100644
index 0000000000..9d70c9666d
--- /dev/null
+++ b/samples/core/Modeling/ValueConversions/MappingImmutableStructProperty.cs
@@ -0,0 +1,86 @@
+using System.Diagnostics;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Logging;
+
+namespace EFModeling.ValueConversions;
+
+public class MappingImmutableStructProperty : Program
+{
+    public async Task Run()
+    {
+        ConsoleWriteLines("Sample showing value conversions for a simple immutable struct...");
+
+        using (var context = new SampleDbContext())
+        {
+            await CleanDatabase(context);
+
+            ConsoleWriteLines("Save a new entity...");
+
+            var entity = new EntityType { MyProperty = new ImmutableStruct(6) };
+            context.Add(entity);
+            await context.SaveChangesAsync();
+
+            ConsoleWriteLines("Change the property value and save again...");
+
+            // This will be detected and EF will update the database on SaveChanges
+            entity.MyProperty = new ImmutableStruct(66);
+
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SampleDbContext())
+        {
+            ConsoleWriteLines("Read the entity back...");
+
+            var entity = await context.Set<EntityType>().SingleAsync();
+
+            Debug.Assert(entity.MyProperty.Value == 66);
+        }
+
+        ConsoleWriteLines("Sample finished.");
+    }
+
+    public class SampleDbContext : DbContext
+    {
+        private static readonly ILoggerFactory
+            Logger = LoggerFactory.Create(x => x.AddConsole()); //.SetMinimumLevel(LogLevel.Debug));
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region ConfigureImmutableStructProperty
+            modelBuilder
+                .Entity<EntityType>()
+                .Property(e => e.MyProperty)
+                .HasConversion(
+                    v => v.Value,
+                    v => new ImmutableStruct(v));
+            #endregion
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .UseLoggerFactory(Logger)
+                .UseSqlite("DataSource=test.db")
+                .EnableSensitiveDataLogging();
+    }
+
+    public class EntityType
+    {
+        public int Id { get; set; }
+        public ImmutableStruct MyProperty { get; set; }
+    }
+
+    #region SimpleImmutableStruct
+    public readonly struct ImmutableStruct
+    {
+        public ImmutableStruct(int value)
+        {
+            Value = value;
+        }
+
+        public int Value { get; }
+    }
+    #endregion
+}
diff --git a/samples/core/Modeling/ValueConversions/MappingListProperty.cs b/samples/core/Modeling/ValueConversions/MappingListProperty.cs
new file mode 100644
index 0000000000..a2764a8a85
--- /dev/null
+++ b/samples/core/Modeling/ValueConversions/MappingListProperty.cs
@@ -0,0 +1,85 @@
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Linq;
+using System.Text.Json;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.ChangeTracking;
+using Microsoft.Extensions.Logging;
+
+namespace EFModeling.ValueConversions;
+
+public class MappingListProperty : Program
+{
+    public async Task Run()
+    {
+        ConsoleWriteLines("Sample showing value conversions for a List<int>...");
+
+        using (var context = new SampleDbContext())
+        {
+            await CleanDatabase(context);
+
+            ConsoleWriteLines("Save a new entity...");
+
+            var entity = new EntityType { MyListProperty = new List<int> { 1, 2, 3 } };
+            context.Add(entity);
+            await context.SaveChangesAsync();
+
+            ConsoleWriteLines("Mutate the property value and save again...");
+
+            // This will be detected and EF will update the database on SaveChanges
+            entity.MyListProperty.Add(4);
+
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SampleDbContext())
+        {
+            ConsoleWriteLines("Read the entity back...");
+
+            var entity = await context.Set<EntityType>().SingleAsync();
+
+            Debug.Assert(entity.MyListProperty.SequenceEqual(new List<int> { 1, 2, 3, 4 }));
+        }
+
+        ConsoleWriteLines("Sample finished.");
+    }
+
+    public class SampleDbContext : DbContext
+    {
+        private static readonly ILoggerFactory
+            Logger = LoggerFactory.Create(x => x.AddConsole()); //.SetMinimumLevel(LogLevel.Debug));
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region ConfigureListProperty
+            modelBuilder
+                .Entity<EntityType>()
+                .Property(e => e.MyListProperty)
+                .HasConversion(
+                    v => JsonSerializer.Serialize(v, (JsonSerializerOptions)null),
+                    v => JsonSerializer.Deserialize<List<int>>(v, (JsonSerializerOptions)null),
+                    new ValueComparer<List<int>>(
+                        (c1, c2) => c1.SequenceEqual(c2),
+                        c => c.Aggregate(0, (a, v) => HashCode.Combine(a, v.GetHashCode())),
+                        c => c.ToList()));
+            #endregion
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .UseLoggerFactory(Logger)
+                .UseSqlite("DataSource=test.db")
+                .EnableSensitiveDataLogging();
+    }
+
+    public class EntityType
+    {
+        public int Id { get; set; }
+
+        #region ListProperty
+        public List<int> MyListProperty { get; set; }
+        #endregion
+    }
+}
diff --git a/samples/core/Modeling/ValueConversions/MappingListPropertyOld.cs b/samples/core/Modeling/ValueConversions/MappingListPropertyOld.cs
new file mode 100644
index 0000000000..7a3ebcb1de
--- /dev/null
+++ b/samples/core/Modeling/ValueConversions/MappingListPropertyOld.cs
@@ -0,0 +1,92 @@
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Linq;
+using System.Text.Json;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.ChangeTracking;
+using Microsoft.Extensions.Logging;
+
+namespace EFModeling.ValueConversions;
+
+public class MappingListPropertyOld : Program
+{
+    public async Task Run()
+    {
+        ConsoleWriteLines("Sample showing value conversions for a List<int>...");
+
+        using (var context = new SampleDbContext())
+        {
+            await CleanDatabase(context);
+
+            ConsoleWriteLines("Save a new entity...");
+
+            var entity = new EntityType { MyListProperty = new List<int> { 1, 2, 3 } };
+            context.Add(entity);
+            await context.SaveChangesAsync();
+
+            ConsoleWriteLines("Mutate the property value and save again...");
+
+            // This will be detected and EF will update the database on SaveChanges
+            entity.MyListProperty.Add(4);
+
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SampleDbContext())
+        {
+            ConsoleWriteLines("Read the entity back...");
+
+            var entity = await context.Set<EntityType>().SingleAsync();
+
+            Debug.Assert(entity.MyListProperty.SequenceEqual(new List<int> { 1, 2, 3, 4 }));
+        }
+
+        ConsoleWriteLines("Sample finished.");
+    }
+
+    public class SampleDbContext : DbContext
+    {
+        private static readonly ILoggerFactory
+            Logger = LoggerFactory.Create(x => x.AddConsole()); //.SetMinimumLevel(LogLevel.Debug));
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region ConfigureListProperty
+            modelBuilder
+                .Entity<EntityType>()
+                .Property(e => e.MyListProperty)
+                .HasConversion(
+                    v => JsonSerializer.Serialize(v, (JsonSerializerOptions)null),
+                    v => JsonSerializer.Deserialize<List<int>>(v, (JsonSerializerOptions)null));
+
+            var valueComparer = new ValueComparer<List<int>>(
+                (c1, c2) => c1.SequenceEqual(c2),
+                c => c.Aggregate(0, (a, v) => HashCode.Combine(a, v.GetHashCode())),
+                c => c.ToList());
+
+            modelBuilder
+                .Entity<EntityType>()
+                .Property(e => e.MyListProperty)
+                .Metadata
+                .SetValueComparer(valueComparer);
+            #endregion
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .UseLoggerFactory(Logger)
+                .UseSqlite("DataSource=test.db")
+                .EnableSensitiveDataLogging();
+    }
+
+    public class EntityType
+    {
+        public int Id { get; set; }
+
+        #region ListProperty
+        public List<int> MyListProperty { get; set; }
+        #endregion
+    }
+}
diff --git a/samples/core/Modeling/ValueConversions/OverridingByteArrayComparisons.cs b/samples/core/Modeling/ValueConversions/OverridingByteArrayComparisons.cs
new file mode 100644
index 0000000000..50229f887c
--- /dev/null
+++ b/samples/core/Modeling/ValueConversions/OverridingByteArrayComparisons.cs
@@ -0,0 +1,81 @@
+using System;
+using System.Diagnostics;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.ChangeTracking;
+using Microsoft.Extensions.Logging;
+
+namespace EFModeling.ValueConversions;
+
+public class OverridingByteArrayComparisons : Program
+{
+    public async Task Run()
+    {
+        ConsoleWriteLines("Sample showing overriding byte array comparisons...");
+
+        using (var context = new SampleDbContext())
+        {
+            await CleanDatabase(context);
+
+            ConsoleWriteLines("Save a new entity...");
+
+            var entity = new EntityType { MyBytes = new byte[] { 1, 2, 3 } };
+            context.Add(entity);
+            await context.SaveChangesAsync();
+
+            ConsoleWriteLines("Mutate the property value and save again...");
+
+            // Normally mutating the byte array would not be detected by EF Core.
+            // In this case it will be detected because the comparer in the model is overridden.
+            entity.MyBytes[1] = 4;
+
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SampleDbContext())
+        {
+            ConsoleWriteLines("Read the entity back...");
+
+            var entity = await context.Set<EntityType>().SingleAsync();
+
+            Debug.Assert(entity.MyBytes.SequenceEqual(new byte[] { 1, 4, 3 }));
+        }
+
+        ConsoleWriteLines("Sample finished.");
+    }
+
+    public class SampleDbContext : DbContext
+    {
+        private static readonly ILoggerFactory
+            Logger = LoggerFactory.Create(x => x.AddConsole()); //.SetMinimumLevel(LogLevel.Debug));
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region OverrideComparer
+            modelBuilder
+                .Entity<EntityType>()
+                .Property(e => e.MyBytes)
+                .Metadata
+                .SetValueComparer(
+                    new ValueComparer<byte[]>(
+                        (c1, c2) => c1.SequenceEqual(c2),
+                        c => c.Aggregate(0, (a, v) => HashCode.Combine(a, v.GetHashCode())),
+                        c => c.ToArray()));
+            #endregion
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .UseLoggerFactory(Logger)
+                .UseSqlite("DataSource=test.db")
+                .EnableSensitiveDataLogging();
+    }
+
+    public class EntityType
+    {
+        public int Id { get; set; }
+
+        public byte[] MyBytes { get; set; }
+    }
+}
diff --git a/samples/core/Modeling/ValueConversions/PreserveDateTimeKind.cs b/samples/core/Modeling/ValueConversions/PreserveDateTimeKind.cs
new file mode 100644
index 0000000000..7ca40dbb51
--- /dev/null
+++ b/samples/core/Modeling/ValueConversions/PreserveDateTimeKind.cs
@@ -0,0 +1,105 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
+
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace EFModeling.ValueConversions;
+
+public class PreserveDateTimeKind : Program
+{
+    public async Task Run()
+    {
+        ConsoleWriteLines("Sample showing value conversions for preserving/setting DateTime.Kind...");
+
+        using (var context = new SampleDbContext())
+        {
+            await CleanDatabase(context);
+
+            ConsoleWriteLines("Save new entities...");
+
+            context.AddRange(
+                new Post
+                {
+                    Title = "Post 1",
+                    PostedOn = new DateTime(1973, 9, 3, 0, 0, 0, 0, DateTimeKind.Utc),
+                    LastUpdated = new DateTime(1974, 9, 3, 0, 0, 0, 0, DateTimeKind.Utc),
+                    DeletedOn = new DateTime(2007, 9, 3, 0, 0, 0, 0, DateTimeKind.Utc)
+                },
+                new Post
+                {
+                    Title = "Post 2",
+                    PostedOn = new DateTime(1975, 9, 3, 0, 0, 0, 0, DateTimeKind.Local),
+                    LastUpdated = new DateTime(1976, 9, 3, 0, 0, 0, 0, DateTimeKind.Utc),
+                    DeletedOn = new DateTime(2017, 9, 3, 0, 0, 0, 0, DateTimeKind.Utc)
+                });
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SampleDbContext())
+        {
+            ConsoleWriteLines("Read the entities back...");
+
+            var blog1 = await context.Set<Post>().SingleAsync(e => e.Title == "Post 1");
+
+            ConsoleWriteLines($"Blog 1: PostedOn.Kind = {blog1.PostedOn.Kind} LastUpdated.Kind = {blog1.LastUpdated.Kind} DeletedOn.Kind = {blog1.DeletedOn.Kind}");
+
+            var blog2 = await context.Set<Post>().SingleAsync(e => e.Title == "Post 2");
+
+            ConsoleWriteLines($"Blog 2: PostedOn.Kind = {blog2.PostedOn.Kind} LastUpdated.Kind = {blog2.LastUpdated.Kind} DeletedOn.Kind = {blog2.DeletedOn.Kind}");
+        }
+
+        ConsoleWriteLines("Sample finished.");
+    }
+
+    public class SampleDbContext : DbContext
+    {
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region ConfigurePreserveDateTimeKind1
+            modelBuilder.Entity<Post>()
+                .Property(e => e.PostedOn)
+                .HasConversion<long>();
+            #endregion
+
+            #region ConfigurePreserveDateTimeKind2
+            modelBuilder.Entity<Post>()
+                .Property(e => e.LastUpdated)
+                .HasConversion(
+                    v => v,
+                    v => new DateTime(v.Ticks, DateTimeKind.Utc));
+            #endregion
+
+            #region ConfigurePreserveDateTimeKind3
+            modelBuilder.Entity<Post>()
+                .Property(e => e.LastUpdated)
+                .HasConversion(
+                    v => v.ToUniversalTime(),
+                    v => new DateTime(v.Ticks, DateTimeKind.Utc));
+            #endregion
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted })
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=PreserveDateTimeKind;Trusted_Connection=True;ConnectRetryCount=0")
+                .EnableSensitiveDataLogging();
+    }
+
+    #region PreserveDateTimeKindModel
+    public class Post
+    {
+        public int Id { get; set; }
+
+        public string Title { get; set; }
+        public string Content { get; set; }
+
+        public DateTime PostedOn { get; set; }
+        public DateTime LastUpdated { get; set; }
+        public DateTime DeletedOn { get; set; }
+    }
+    #endregion
+}
diff --git a/samples/core/Modeling/ValueConversions/PrimitiveCollection.cs b/samples/core/Modeling/ValueConversions/PrimitiveCollection.cs
new file mode 100644
index 0000000000..7c15359caa
--- /dev/null
+++ b/samples/core/Modeling/ValueConversions/PrimitiveCollection.cs
@@ -0,0 +1,82 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text.Json;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.ChangeTracking;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace EFModeling.ValueConversions;
+
+public class PrimitiveCollection : Program
+{
+    public async Task Run()
+    {
+        ConsoleWriteLines("Sample showing value conversions for a collections of primitive values...");
+
+        using (var context = new SampleDbContext())
+        {
+            await CleanDatabase(context);
+
+            ConsoleWriteLines("Save a new entity...");
+
+            context.Add(new Post { Tags = new List<string> { "EF Core", "Unicorns", "Donkeys" } });
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SampleDbContext())
+        {
+            ConsoleWriteLines("Read the entity back...");
+
+            var post = await context.Set<Post>().SingleAsync();
+
+            ConsoleWriteLines($"Post with tags {string.Join(", ", post.Tags)}.");
+
+            ConsoleWriteLines("Changing the value object and saving again");
+
+            post.Tags.Add("ASP.NET Core");
+            await context.SaveChangesAsync();
+        }
+
+        ConsoleWriteLines("Sample finished.");
+    }
+
+    public class SampleDbContext : DbContext
+    {
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region ConfigurePrimitiveCollection
+            modelBuilder.Entity<Post>()
+                .Property(e => e.Tags)
+                .HasConversion(
+                    v => JsonSerializer.Serialize(v, (JsonSerializerOptions)null),
+                    v => JsonSerializer.Deserialize<List<string>>(v, (JsonSerializerOptions)null),
+                    new ValueComparer<ICollection<string>>(
+                        (c1, c2) => c1.SequenceEqual(c2),
+                        c => c.Aggregate(0, (a, v) => HashCode.Combine(a, v.GetHashCode())),
+                        c => (ICollection<string>)c.ToList()));
+            #endregion
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted })
+                .UseSqlite("DataSource=test.db")
+                .EnableSensitiveDataLogging();
+    }
+
+    #region PrimitiveCollectionModel
+    public class Post
+    {
+        public int Id { get; set; }
+        public string Title { get; set; }
+        public string Contents { get; set; }
+
+        public ICollection<string> Tags { get; set; }
+    }
+    #endregion
+}
diff --git a/samples/core/Modeling/ValueConversions/Program.cs b/samples/core/Modeling/ValueConversions/Program.cs
new file mode 100644
index 0000000000..4eea2aa26a
--- /dev/null
+++ b/samples/core/Modeling/ValueConversions/Program.cs
@@ -0,0 +1,51 @@
+using System;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFModeling.ValueConversions;
+
+/// <summary>
+///     Samples for value conversions and comparisons.
+/// </summary>
+public class Program
+{
+    public static async Task Main()
+    {
+        await new MappingImmutableClassProperty().Run();
+        await new MappingImmutableStructProperty().Run();
+        await new MappingListProperty().Run();
+        await new MappingListPropertyOld().Run();
+        await new OverridingByteArrayComparisons().Run();
+        await new EnumToStringConversions().Run();
+        await new KeyValueObjects().Run();
+        await new SimpleValueObject().Run();
+        await new CompositeValueObject().Run();
+        await new PrimitiveCollection().Run();
+        await new ValueObjectCollection().Run();
+        await new ULongConcurrency().Run();
+        await new PreserveDateTimeKind().Run();
+        await new CaseInsensitiveStrings().Run();
+        await new FixedLengthStrings().Run();
+        await new EncryptPropertyValues().Run();
+        await new WithMappingHints().Run();
+    }
+
+    protected static void ConsoleWriteLines(params string[] values)
+    {
+        Console.WriteLine();
+        foreach (var value in values)
+        {
+            Console.WriteLine(value);
+        }
+
+        Console.WriteLine();
+    }
+
+    protected static async Task CleanDatabase(DbContext context)
+    {
+        ConsoleWriteLines("Deleting and re-creating database...");
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+        ConsoleWriteLines("Done. Database is clean and fresh.");
+    }
+}
diff --git a/samples/core/Modeling/ValueConversions/SimpleValueObject.cs b/samples/core/Modeling/ValueConversions/SimpleValueObject.cs
new file mode 100644
index 0000000000..1cebf7f84d
--- /dev/null
+++ b/samples/core/Modeling/ValueConversions/SimpleValueObject.cs
@@ -0,0 +1,79 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
+
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace EFModeling.ValueConversions;
+
+public class SimpleValueObject : Program
+{
+    public async Task Run()
+    {
+        ConsoleWriteLines("Sample showing value conversions for a simple value object...");
+
+        using (var context = new SampleDbContext())
+        {
+            await CleanDatabase(context);
+
+            ConsoleWriteLines("Save a new entity...");
+
+            context.Add(new Order { Price = new Dollars(3.99m) });
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SampleDbContext())
+        {
+            ConsoleWriteLines("Read the entity back...");
+
+            var entity = await context.Set<Order>().SingleAsync();
+        }
+
+        ConsoleWriteLines("Sample finished.");
+    }
+
+    public class SampleDbContext : DbContext
+    {
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region ConfigureImmutableStructProperty
+            modelBuilder.Entity<Order>()
+                .Property(e => e.Price)
+                .HasConversion(
+                    v => v.Amount,
+                    v => new Dollars(v));
+            #endregion
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted })
+                .UseSqlite("DataSource=test.db")
+                .EnableSensitiveDataLogging();
+    }
+
+    #region SimpleValueObjectModel
+    public class Order
+    {
+        public int Id { get; set; }
+
+        public Dollars Price { get; set; }
+    }
+    #endregion
+
+    #region SimpleValueObject
+    public readonly struct Dollars
+    {
+        public Dollars(decimal amount)
+            => Amount = amount;
+
+        public decimal Amount { get; }
+
+        public override string ToString()
+            => $"${Amount}";
+    }
+    #endregion
+}
diff --git a/samples/core/Modeling/ValueConversions/ULongConcurrency.cs b/samples/core/Modeling/ValueConversions/ULongConcurrency.cs
new file mode 100644
index 0000000000..864e969963
--- /dev/null
+++ b/samples/core/Modeling/ValueConversions/ULongConcurrency.cs
@@ -0,0 +1,96 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
+
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace EFModeling.ValueConversions;
+
+public class ULongConcurrency : Program
+{
+    public async Task Run()
+    {
+        ConsoleWriteLines("Sample showing how to map rowversion to ulong...");
+
+        using (var context = new SampleDbContext())
+        {
+            await CleanDatabase(context);
+
+            ConsoleWriteLines("Save a new entity...");
+
+            context.Add(
+                new Blog
+                {
+                    Name = "OneUnicorn"
+                });
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SampleDbContext())
+        {
+            ConsoleWriteLines("Read the entity back in one context...");
+
+            var blog = await context.Set<Blog>().SingleAsync();
+            blog.Name = "TwoUnicorns";
+
+            using (var context2 = new SampleDbContext())
+            {
+                ConsoleWriteLines("Change the blog name and save in a different context...");
+
+                (await context2.Set<Blog>().SingleAsync()).Name = "1unicorn2";
+                await context2.SaveChangesAsync();
+            }
+
+            try
+            {
+                ConsoleWriteLines("Change the blog name and save in the first context...");
+
+                await context.SaveChangesAsync();
+            }
+            catch (DbUpdateConcurrencyException e)
+            {
+                ConsoleWriteLines($"{e.GetType().FullName}: {e.Message}");
+
+                var databaseValues = await context.Entry(blog).GetDatabaseValuesAsync();
+                context.Entry(blog).OriginalValues.SetValues(databaseValues);
+
+                ConsoleWriteLines("Refresh original values and save again...");
+
+                await context.SaveChangesAsync();
+            }
+        }
+
+        ConsoleWriteLines("Sample finished.");
+    }
+
+    public class SampleDbContext : DbContext
+    {
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region ConfigureULongConcurrency
+            modelBuilder.Entity<Blog>()
+                .Property(e => e.Version)
+                .IsRowVersion()
+                .HasConversion<byte[]>();
+            #endregion
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted })
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=ULongConcurrency;Trusted_Connection=True;ConnectRetryCount=0")
+                .EnableSensitiveDataLogging();
+    }
+
+    #region ULongConcurrencyModel
+    public class Blog
+    {
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public ulong Version { get; set; }
+    }
+    #endregion
+}
diff --git a/samples/core/Modeling/ValueConversions/ValueConversions.csproj b/samples/core/Modeling/ValueConversions/ValueConversions.csproj
new file mode 100644
index 0000000000..d8d75f5752
--- /dev/null
+++ b/samples/core/Modeling/ValueConversions/ValueConversions.csproj
@@ -0,0 +1,16 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <TargetFramework>net10.0</TargetFramework>
+        <RootNamespace>EFModeling.ValueConversions</RootNamespace>
+        <AssemblyName>EFModeling.ValueConversions</AssemblyName>
+    </PropertyGroup>
+
+    <ItemGroup>
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+        <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+        <PackageReference Include="Microsoft.Extensions.Logging.Console" Version="7.0.0" />
+    </ItemGroup>
+
+</Project>
diff --git a/samples/core/Modeling/ValueConversions/ValueObjectCollection.cs b/samples/core/Modeling/ValueConversions/ValueObjectCollection.cs
new file mode 100644
index 0000000000..f740aff28f
--- /dev/null
+++ b/samples/core/Modeling/ValueConversions/ValueObjectCollection.cs
@@ -0,0 +1,133 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.ChangeTracking;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+
+namespace EFModeling.ValueConversions;
+
+public class ValueObjectCollection : Program
+{
+    public async Task Run()
+    {
+        ConsoleWriteLines("Sample showing value conversions for a collection of value objects...");
+
+        using (var context = new SampleDbContext())
+        {
+            await CleanDatabase(context);
+
+            ConsoleWriteLines("Save a new entity...");
+
+            context.Add(
+                new Blog
+                {
+                    Finances = new List<AnnualFinance>
+                    {
+                        new AnnualFinance(2018, new Money(326.65m, Currency.UsDollars), new Money(125m, Currency.UsDollars)),
+                        new AnnualFinance(2019, new Money(112.20m, Currency.UsDollars), new Money(125m, Currency.UsDollars)),
+                        new AnnualFinance(2020, new Money(25.77m, Currency.UsDollars), new Money(125m, Currency.UsDollars))
+                    }
+                });
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SampleDbContext())
+        {
+            ConsoleWriteLines("Read the entity back...");
+
+            var blog = await context.Set<Blog>().SingleAsync();
+
+            ConsoleWriteLines($"Blog with finances {string.Join(", ", blog.Finances.Select(f => $"{f.Year}: I={f.Income} E={f.Expenses} R={f.Revenue}"))}.");
+
+            ConsoleWriteLines("Changing the value object and saving again");
+
+            blog.Finances.Add(new AnnualFinance(2021, new Money(12.0m, Currency.UsDollars), new Money(125m, Currency.UsDollars)));
+            await context.SaveChangesAsync();
+        }
+
+        ConsoleWriteLines("Sample finished.");
+    }
+
+    public class SampleDbContext : DbContext
+    {
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region ConfigureValueObjectCollection
+            modelBuilder.Entity<Blog>()
+                .Property(e => e.Finances)
+                .HasConversion(
+                    v => JsonSerializer.Serialize(v, (JsonSerializerOptions)null),
+                    v => JsonSerializer.Deserialize<List<AnnualFinance>>(v, (JsonSerializerOptions)null),
+                    new ValueComparer<IList<AnnualFinance>>(
+                        (c1, c2) => c1.SequenceEqual(c2),
+                        c => c.Aggregate(0, (a, v) => HashCode.Combine(a, v.GetHashCode())),
+                        c => (IList<AnnualFinance>)c.ToList()));
+            #endregion
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted })
+                .UseSqlite("DataSource=test.db")
+                .EnableSensitiveDataLogging();
+    }
+
+    #region ValueObjectCollection
+    public readonly struct AnnualFinance
+    {
+        [JsonConstructor]
+        public AnnualFinance(int year, Money income, Money expenses)
+        {
+            Year = year;
+            Income = income;
+            Expenses = expenses;
+        }
+
+        public int Year { get; }
+        public Money Income { get; }
+        public Money Expenses { get; }
+        public Money Revenue => new Money(Income.Amount - Expenses.Amount, Income.Currency);
+    }
+    #endregion
+
+    #region ValueObjectCollectionMoney
+    public readonly struct Money
+    {
+        [JsonConstructor]
+        public Money(decimal amount, Currency currency)
+        {
+            Amount = amount;
+            Currency = currency;
+        }
+
+        public override string ToString()
+            => (Currency == Currency.UsDollars ? "$" : "£") + Amount;
+
+        public decimal Amount { get; }
+        public Currency Currency { get; }
+    }
+
+    public enum Currency
+    {
+        UsDollars,
+        PoundsSterling
+    }
+    #endregion
+
+    #region ValueObjectCollectionModel
+    public class Blog
+    {
+        public int Id { get; set; }
+        public string Name { get; set; }
+
+        public IList<AnnualFinance> Finances { get; set; }
+    }
+    #endregion
+}
diff --git a/samples/core/Modeling/ValueConversions/WithMappingHints.cs b/samples/core/Modeling/ValueConversions/WithMappingHints.cs
new file mode 100644
index 0000000000..eefc2ce5ce
--- /dev/null
+++ b/samples/core/Modeling/ValueConversions/WithMappingHints.cs
@@ -0,0 +1,90 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
+
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+namespace EFModeling.ValueConversions;
+
+public class WithMappingHints : Program
+{
+    public async Task Run()
+    {
+        ConsoleWriteLines("Sample showing value conversions with mapping hints for facets...");
+
+        using (var context = new SampleDbContext())
+        {
+            await CleanDatabase(context);
+
+            ConsoleWriteLines("Save a entities...");
+
+            context.Add(new Order1 { Price = new Dollars(3.99m) });
+            context.Add(new Order2 { Price = new Dollars(3.99m) });
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new SampleDbContext())
+        {
+            ConsoleWriteLines("Read the entities back...");
+
+            var entity1 = await context.Set<Order1>().SingleAsync();
+            var entity2 = await context.Set<Order2>().SingleAsync();
+        }
+
+        ConsoleWriteLines("Sample finished.");
+    }
+
+    public class SampleDbContext : DbContext
+    {
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region ConverterWithMappingHints
+            var converter = new ValueConverter<Dollars, decimal>(
+                v => v.Amount,
+                v => new Dollars(v),
+                new ConverterMappingHints(precision: 16, scale: 2));
+            #endregion
+
+            modelBuilder.Entity<Order1>()
+                .Property(e => e.Price)
+                .HasConversion(converter);
+
+            #region ConfigureWithFacets
+            modelBuilder.Entity<Order2>()
+                .Property(e => e.Price)
+                .HasConversion(converter)
+                .HasPrecision(20, 2);
+            #endregion
+        }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+            => optionsBuilder
+                .LogTo(Console.WriteLine, new[] { RelationalEventId.CommandExecuted })
+                .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=WithMappingHints;Trusted_Connection=True;ConnectRetryCount=0")
+                .EnableSensitiveDataLogging();
+    }
+
+    public class Order1
+    {
+        public int Id { get; set; }
+
+        public Dollars Price { get; set; }
+    }
+
+    public class Order2
+    {
+        public int Id { get; set; }
+
+        public Dollars Price { get; set; }
+    }
+
+    public readonly struct Dollars
+    {
+        public Dollars(decimal amount) => Amount = amount;
+        public decimal Amount { get; }
+    }
+}
diff --git a/samples/core/NuGet.config b/samples/core/NuGet.config
new file mode 100644
index 0000000000..ddf33811ef
--- /dev/null
+++ b/samples/core/NuGet.config
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<configuration>
+    <packageSources>
+        <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
+        <add key="dotnet10" value="https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet10/nuget/v3/index.json" />
+    </packageSources>
+</configuration>
diff --git a/samples/core/Performance/AspNetContextPooling/AspNetContextPooling.csproj b/samples/core/Performance/AspNetContextPooling/AspNetContextPooling.csproj
new file mode 100644
index 0000000000..43389ad7d2
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPooling/AspNetContextPooling.csproj
@@ -0,0 +1,16 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <RootNamespace>Performance.AspNetContextPooling</RootNamespace>
+    <AssemblyName>Performance.AspNetContextPooling</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Swashbuckle.AspNetCore" Version="6.4.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Performance/AspNetContextPooling/Controllers/WeatherForecastController.cs b/samples/core/Performance/AspNetContextPooling/Controllers/WeatherForecastController.cs
new file mode 100644
index 0000000000..87e80d2c5e
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPooling/Controllers/WeatherForecastController.cs
@@ -0,0 +1,18 @@
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.EntityFrameworkCore;
+
+namespace Performance.AspNetContextPooling.Controllers;
+
+[ApiController]
+[Route("[controller]")]
+public class WeatherForecastController : ControllerBase
+{
+    private readonly WeatherForecastContext _dbContext;
+
+    public WeatherForecastController(WeatherForecastContext dbContext)
+        => _dbContext = dbContext;
+
+    [HttpGet(Name = "GetWeatherForecast")]
+    public async Task<IEnumerable<WeatherForecast>> Get()
+        => await _dbContext.Forecasts.OrderBy(f => f.Date).Take(5).ToArrayAsync();
+}
diff --git a/samples/core/Performance/AspNetContextPooling/Migrations/20220131094805_Initial.Designer.cs b/samples/core/Performance/AspNetContextPooling/Migrations/20220131094805_Initial.Designer.cs
new file mode 100644
index 0000000000..feb2622d41
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPooling/Migrations/20220131094805_Initial.Designer.cs
@@ -0,0 +1,73 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+#nullable disable
+
+namespace Performance.AspNetContextPooling.Migrations
+{
+    [DbContext(typeof(WeatherForecastContext))]
+    [Migration("20220131094805_Initial")]
+    partial class Initial
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "6.0.1")
+                .HasAnnotation("Relational:MaxIdentifierLength", 128);
+
+            SqlServerModelBuilderExtensions.UseIdentityColumns(modelBuilder, 1L, 1);
+
+            modelBuilder.Entity("AspNetContextPooling.WeatherForecast", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("int");
+
+                    SqlServerPropertyBuilderExtensions.UseIdentityColumn(b.Property<int>("Id"), 1L, 1);
+
+                    b.Property<DateTime>("Date")
+                        .HasColumnType("datetime2");
+
+                    b.Property<string>("Summary")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<int>("TemperatureC")
+                        .HasColumnType("int");
+
+                    b.HasKey("Id");
+
+                    b.ToTable("Forecasts");
+
+                    b.HasData(
+                        new
+                        {
+                            Id = 1,
+                            Date = new DateTime(2022, 1, 1, 0, 0, 0, 0, DateTimeKind.Unspecified),
+                            Summary = "Chilly",
+                            TemperatureC = -17
+                        },
+                        new
+                        {
+                            Id = 2,
+                            Date = new DateTime(2022, 1, 2, 0, 0, 0, 0, DateTimeKind.Unspecified),
+                            Summary = "Balmy",
+                            TemperatureC = 38
+                        },
+                        new
+                        {
+                            Id = 3,
+                            Date = new DateTime(2022, 1, 3, 0, 0, 0, 0, DateTimeKind.Unspecified),
+                            Summary = "Sweltering",
+                            TemperatureC = -7
+                        });
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/samples/core/Performance/AspNetContextPooling/Migrations/20220131094805_Initial.cs b/samples/core/Performance/AspNetContextPooling/Migrations/20220131094805_Initial.cs
new file mode 100644
index 0000000000..1543bd4fcd
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPooling/Migrations/20220131094805_Initial.cs
@@ -0,0 +1,49 @@
+using System;
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace Performance.AspNetContextPooling.Migrations
+{
+    public partial class Initial : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.CreateTable(
+                name: "Forecasts",
+                columns: table => new
+                {
+                    Id = table.Column<int>(type: "int", nullable: false)
+                        .Annotation("SqlServer:Identity", "1, 1"),
+                    Date = table.Column<DateTime>(type: "datetime2", nullable: false),
+                    TemperatureC = table.Column<int>(type: "int", nullable: false),
+                    Summary = table.Column<string>(type: "nvarchar(max)", nullable: true)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_Forecasts", x => x.Id);
+                });
+
+            migrationBuilder.InsertData(
+                table: "Forecasts",
+                columns: new[] { "Id", "Date", "Summary", "TemperatureC" },
+                values: new object[] { 1, new DateTime(2022, 1, 1, 0, 0, 0, 0, DateTimeKind.Unspecified), "Chilly", -17 });
+
+            migrationBuilder.InsertData(
+                table: "Forecasts",
+                columns: new[] { "Id", "Date", "Summary", "TemperatureC" },
+                values: new object[] { 2, new DateTime(2022, 1, 2, 0, 0, 0, 0, DateTimeKind.Unspecified), "Balmy", 38 });
+
+            migrationBuilder.InsertData(
+                table: "Forecasts",
+                columns: new[] { "Id", "Date", "Summary", "TemperatureC" },
+                values: new object[] { 3, new DateTime(2022, 1, 3, 0, 0, 0, 0, DateTimeKind.Unspecified), "Sweltering", -7 });
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropTable(
+                name: "Forecasts");
+        }
+    }
+}
diff --git a/samples/core/Performance/AspNetContextPooling/Migrations/WeatherForecastContextModelSnapshot.cs b/samples/core/Performance/AspNetContextPooling/Migrations/WeatherForecastContextModelSnapshot.cs
new file mode 100644
index 0000000000..2ce869a811
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPooling/Migrations/WeatherForecastContextModelSnapshot.cs
@@ -0,0 +1,71 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+
+#nullable disable
+
+namespace Performance.AspNetContextPooling.Migrations
+{
+    [DbContext(typeof(WeatherForecastContext))]
+    partial class WeatherForecastContextModelSnapshot : ModelSnapshot
+    {
+        protected override void BuildModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "6.0.1")
+                .HasAnnotation("Relational:MaxIdentifierLength", 128);
+
+            SqlServerModelBuilderExtensions.UseIdentityColumns(modelBuilder, 1L, 1);
+
+            modelBuilder.Entity("AspNetContextPooling.WeatherForecast", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("int");
+
+                    SqlServerPropertyBuilderExtensions.UseIdentityColumn(b.Property<int>("Id"), 1L, 1);
+
+                    b.Property<DateTime>("Date")
+                        .HasColumnType("datetime2");
+
+                    b.Property<string>("Summary")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<int>("TemperatureC")
+                        .HasColumnType("int");
+
+                    b.HasKey("Id");
+
+                    b.ToTable("Forecasts");
+
+                    b.HasData(
+                        new
+                        {
+                            Id = 1,
+                            Date = new DateTime(2022, 1, 1, 0, 0, 0, 0, DateTimeKind.Unspecified),
+                            Summary = "Chilly",
+                            TemperatureC = -17
+                        },
+                        new
+                        {
+                            Id = 2,
+                            Date = new DateTime(2022, 1, 2, 0, 0, 0, 0, DateTimeKind.Unspecified),
+                            Summary = "Balmy",
+                            TemperatureC = 38
+                        },
+                        new
+                        {
+                            Id = 3,
+                            Date = new DateTime(2022, 1, 3, 0, 0, 0, 0, DateTimeKind.Unspecified),
+                            Summary = "Sweltering",
+                            TemperatureC = -7
+                        });
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/samples/core/Performance/AspNetContextPooling/Program.cs b/samples/core/Performance/AspNetContextPooling/Program.cs
new file mode 100644
index 0000000000..c08403051f
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPooling/Program.cs
@@ -0,0 +1,29 @@
+using Microsoft.EntityFrameworkCore;
+using Performance.AspNetContextPooling;
+
+var builder = WebApplication.CreateBuilder(args);
+
+builder.Services.AddControllers();
+builder.Services.AddEndpointsApiExplorer();
+builder.Services.AddSwaggerGen();
+
+#region AddDbContextPool
+builder.Services.AddDbContextPool<WeatherForecastContext>(
+    o => o.UseSqlServer(builder.Configuration.GetConnectionString("WeatherForecastContext")));
+#endregion
+
+var app = builder.Build();
+
+if (app.Environment.IsDevelopment())
+{
+    app.UseSwagger();
+    app.UseSwaggerUI();
+}
+
+app.UseHttpsRedirection();
+
+app.UseAuthorization();
+
+app.MapControllers();
+
+app.Run();
diff --git a/samples/core/Performance/AspNetContextPooling/Properties/launchSettings.json b/samples/core/Performance/AspNetContextPooling/Properties/launchSettings.json
new file mode 100644
index 0000000000..0bd72ebfd6
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPooling/Properties/launchSettings.json
@@ -0,0 +1,12 @@
+{
+  "profiles": {
+    "AspNetContextPooling": {
+      "commandName": "Project",
+      "launchBrowser": true,
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      },
+      "applicationUrl": "https://localhost:58220;http://localhost:58222"
+    }
+  }
+}
\ No newline at end of file
diff --git a/samples/core/Performance/AspNetContextPooling/WeatherForecast.cs b/samples/core/Performance/AspNetContextPooling/WeatherForecast.cs
new file mode 100644
index 0000000000..bd1e4d9968
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPooling/WeatherForecast.cs
@@ -0,0 +1,11 @@
+namespace Performance.AspNetContextPooling;
+
+public class WeatherForecast
+{
+    public int Id { get; set; }
+
+    public DateTime Date { get; set; }
+    public int TemperatureC { get; set; }
+    public int TemperatureF => 32 + (int)(TemperatureC / 0.5556);
+    public string Summary { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Performance/AspNetContextPooling/WeatherForecastContext.cs b/samples/core/Performance/AspNetContextPooling/WeatherForecastContext.cs
new file mode 100644
index 0000000000..f8629ee21e
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPooling/WeatherForecastContext.cs
@@ -0,0 +1,39 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace Performance.AspNetContextPooling;
+
+public class WeatherForecastContext : DbContext
+{
+    public WeatherForecastContext(DbContextOptions options)
+        : base(options)
+    {
+    }
+
+    public DbSet<WeatherForecast> Forecasts { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<WeatherForecast>().HasData(
+            new WeatherForecast
+            {
+                Id = 1,
+                Date = new(2022, 1, 1),
+                Summary = "Chilly",
+                TemperatureC = -17
+            },
+            new WeatherForecast
+            {
+                Id = 2,
+                Date = new(2022, 1, 2),
+                Summary = "Balmy",
+                TemperatureC = 38
+            },
+            new WeatherForecast
+            {
+                Id = 3,
+                Date = new(2022, 1, 3),
+                Summary = "Sweltering",
+                TemperatureC = -7
+            });
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Performance/AspNetContextPooling/appsettings.Development.json b/samples/core/Performance/AspNetContextPooling/appsettings.Development.json
new file mode 100644
index 0000000000..0c208ae918
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPooling/appsettings.Development.json
@@ -0,0 +1,8 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  }
+}
diff --git a/samples/core/Performance/AspNetContextPooling/appsettings.json b/samples/core/Performance/AspNetContextPooling/appsettings.json
new file mode 100644
index 0000000000..3a10b9798a
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPooling/appsettings.json
@@ -0,0 +1,12 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  },
+  "AllowedHosts": "*",
+  "ConnectionStrings": {
+    "WeatherForecastContext": "Server=(localdb)\\mssqllocaldb;Database=Blogging;Trusted_Connection=True"
+  }
+}
diff --git a/samples/core/Performance/AspNetContextPoolingWithState/AspNetContextPoolingWithState.csproj b/samples/core/Performance/AspNetContextPoolingWithState/AspNetContextPoolingWithState.csproj
new file mode 100644
index 0000000000..c0887dbab7
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPoolingWithState/AspNetContextPoolingWithState.csproj
@@ -0,0 +1,16 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <RootNamespace>Performance.AspNetContextPoolingWithState</RootNamespace>
+    <AssemblyName>Performance.AspNetContextPoolingWithState</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Swashbuckle.AspNetCore" Version="6.4.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Performance/AspNetContextPoolingWithState/Controllers/WeatherForecastController.cs b/samples/core/Performance/AspNetContextPoolingWithState/Controllers/WeatherForecastController.cs
new file mode 100644
index 0000000000..cbce0387cf
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPoolingWithState/Controllers/WeatherForecastController.cs
@@ -0,0 +1,18 @@
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.EntityFrameworkCore;
+
+namespace Performance.AspNetContextPoolingWithState.Controllers;
+
+[ApiController]
+[Route("[controller]")]
+public class WeatherForecastController : ControllerBase
+{
+    private readonly WeatherForecastContext _dbContext;
+
+    public WeatherForecastController(WeatherForecastContext dbContext)
+        => _dbContext = dbContext;
+
+    [HttpGet(Name = "GetWeatherForecast")]
+    public async Task<IEnumerable<WeatherForecast>> Get()
+        => await _dbContext.Forecasts.OrderBy(f => f.Date).Take(5).ToArrayAsync();
+}
diff --git a/samples/core/Performance/AspNetContextPoolingWithState/ITenant.cs b/samples/core/Performance/AspNetContextPoolingWithState/ITenant.cs
new file mode 100644
index 0000000000..e3f40a72ee
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPoolingWithState/ITenant.cs
@@ -0,0 +1,6 @@
+namespace Performance.AspNetContextPoolingWithState;
+
+public interface ITenant
+{
+    public int TenantId { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Performance/AspNetContextPoolingWithState/Migrations/20220131104204_Initial.Designer.cs b/samples/core/Performance/AspNetContextPoolingWithState/Migrations/20220131104204_Initial.Designer.cs
new file mode 100644
index 0000000000..bd21218552
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPoolingWithState/Migrations/20220131104204_Initial.Designer.cs
@@ -0,0 +1,80 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using Performance.AspNetContextPoolingWithState;
+
+#nullable disable
+
+namespace Performance.AspNetContextPoolingWithState.Migrations
+{
+    [DbContext(typeof(WeatherForecastContext))]
+    [Migration("20220131104204_Initial")]
+    partial class Initial
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "6.0.1")
+                .HasAnnotation("Relational:MaxIdentifierLength", 128);
+
+            SqlServerModelBuilderExtensions.UseIdentityColumns(modelBuilder, 1L, 1);
+
+            modelBuilder.Entity("Performance.AspNetContextPoolingWithState.WeatherForecast", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("int");
+
+                    SqlServerPropertyBuilderExtensions.UseIdentityColumn(b.Property<int>("Id"), 1L, 1);
+
+                    b.Property<DateTime>("Date")
+                        .HasColumnType("datetime2");
+
+                    b.Property<string>("Summary")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<int>("TemperatureC")
+                        .HasColumnType("int");
+
+                    b.Property<int>("TenantId")
+                        .HasColumnType("int");
+
+                    b.HasKey("Id");
+
+                    b.ToTable("Forecasts");
+
+                    b.HasData(
+                        new
+                        {
+                            Id = 1,
+                            Date = new DateTime(2022, 1, 1, 0, 0, 0, 0, DateTimeKind.Unspecified),
+                            Summary = "Chilly",
+                            TemperatureC = -17,
+                            TenantId = 0
+                        },
+                        new
+                        {
+                            Id = 2,
+                            Date = new DateTime(2022, 1, 2, 0, 0, 0, 0, DateTimeKind.Unspecified),
+                            Summary = "Balmy",
+                            TemperatureC = 38,
+                            TenantId = 0
+                        },
+                        new
+                        {
+                            Id = 3,
+                            Date = new DateTime(2022, 1, 3, 0, 0, 0, 0, DateTimeKind.Unspecified),
+                            Summary = "Sweltering",
+                            TemperatureC = -7,
+                            TenantId = 1
+                        });
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/samples/core/Performance/AspNetContextPoolingWithState/Migrations/20220131104204_Initial.cs b/samples/core/Performance/AspNetContextPoolingWithState/Migrations/20220131104204_Initial.cs
new file mode 100644
index 0000000000..690150668d
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPoolingWithState/Migrations/20220131104204_Initial.cs
@@ -0,0 +1,50 @@
+using System;
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace Performance.AspNetContextPoolingWithState.Migrations
+{
+    public partial class Initial : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.CreateTable(
+                name: "Forecasts",
+                columns: table => new
+                {
+                    Id = table.Column<int>(type: "int", nullable: false)
+                        .Annotation("SqlServer:Identity", "1, 1"),
+                    TenantId = table.Column<int>(type: "int", nullable: false),
+                    Date = table.Column<DateTime>(type: "datetime2", nullable: false),
+                    TemperatureC = table.Column<int>(type: "int", nullable: false),
+                    Summary = table.Column<string>(type: "nvarchar(max)", nullable: true)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_Forecasts", x => x.Id);
+                });
+
+            migrationBuilder.InsertData(
+                table: "Forecasts",
+                columns: new[] { "Id", "Date", "Summary", "TemperatureC", "TenantId" },
+                values: new object[] { 1, new DateTime(2022, 1, 1, 0, 0, 0, 0, DateTimeKind.Unspecified), "Chilly", -17, 0 });
+
+            migrationBuilder.InsertData(
+                table: "Forecasts",
+                columns: new[] { "Id", "Date", "Summary", "TemperatureC", "TenantId" },
+                values: new object[] { 2, new DateTime(2022, 1, 2, 0, 0, 0, 0, DateTimeKind.Unspecified), "Balmy", 38, 0 });
+
+            migrationBuilder.InsertData(
+                table: "Forecasts",
+                columns: new[] { "Id", "Date", "Summary", "TemperatureC", "TenantId" },
+                values: new object[] { 3, new DateTime(2022, 1, 3, 0, 0, 0, 0, DateTimeKind.Unspecified), "Sweltering", -7, 1 });
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropTable(
+                name: "Forecasts");
+        }
+    }
+}
diff --git a/samples/core/Performance/AspNetContextPoolingWithState/Migrations/WeatherForecastContextModelSnapshot.cs b/samples/core/Performance/AspNetContextPoolingWithState/Migrations/WeatherForecastContextModelSnapshot.cs
new file mode 100644
index 0000000000..87ed78c990
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPoolingWithState/Migrations/WeatherForecastContextModelSnapshot.cs
@@ -0,0 +1,78 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using Performance.AspNetContextPoolingWithState;
+
+#nullable disable
+
+namespace Performance.AspNetContextPoolingWithState.Migrations
+{
+    [DbContext(typeof(WeatherForecastContext))]
+    partial class WeatherForecastContextModelSnapshot : ModelSnapshot
+    {
+        protected override void BuildModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "6.0.1")
+                .HasAnnotation("Relational:MaxIdentifierLength", 128);
+
+            SqlServerModelBuilderExtensions.UseIdentityColumns(modelBuilder, 1L, 1);
+
+            modelBuilder.Entity("Performance.AspNetContextPoolingWithState.WeatherForecast", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("int");
+
+                    SqlServerPropertyBuilderExtensions.UseIdentityColumn(b.Property<int>("Id"), 1L, 1);
+
+                    b.Property<DateTime>("Date")
+                        .HasColumnType("datetime2");
+
+                    b.Property<string>("Summary")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<int>("TemperatureC")
+                        .HasColumnType("int");
+
+                    b.Property<int>("TenantId")
+                        .HasColumnType("int");
+
+                    b.HasKey("Id");
+
+                    b.ToTable("Forecasts");
+
+                    b.HasData(
+                        new
+                        {
+                            Id = 1,
+                            Date = new DateTime(2022, 1, 1, 0, 0, 0, 0, DateTimeKind.Unspecified),
+                            Summary = "Chilly",
+                            TemperatureC = -17,
+                            TenantId = 0
+                        },
+                        new
+                        {
+                            Id = 2,
+                            Date = new DateTime(2022, 1, 2, 0, 0, 0, 0, DateTimeKind.Unspecified),
+                            Summary = "Balmy",
+                            TemperatureC = 38,
+                            TenantId = 0
+                        },
+                        new
+                        {
+                            Id = 3,
+                            Date = new DateTime(2022, 1, 3, 0, 0, 0, 0, DateTimeKind.Unspecified),
+                            Summary = "Sweltering",
+                            TemperatureC = -7,
+                            TenantId = 1
+                        });
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/samples/core/Performance/AspNetContextPoolingWithState/Program.cs b/samples/core/Performance/AspNetContextPoolingWithState/Program.cs
new file mode 100644
index 0000000000..fea37f802b
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPoolingWithState/Program.cs
@@ -0,0 +1,56 @@
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Primitives;
+using Performance.AspNetContextPoolingWithState;
+
+var builder = WebApplication.CreateBuilder(args);
+
+builder.Services.AddControllers();
+builder.Services.AddEndpointsApiExplorer();
+builder.Services.AddSwaggerGen();
+
+#region TenantResolution
+// Below is a minimal tenant resolution strategy, which registers a scoped ITenant service in DI.
+// In this sample, we simply accept the tenant ID as a request query, which means that a client can impersonate any
+// tenant. In a real application, the tenant ID would be set based on secure authentication data.
+builder.Services.AddHttpContextAccessor();
+builder.Services.AddScoped<ITenant>(sp =>
+{
+    var tenantIdString = sp.GetRequiredService<IHttpContextAccessor>().HttpContext.Request.Query["TenantId"];
+
+    return tenantIdString != StringValues.Empty && int.TryParse(tenantIdString, out var tenantId)
+        ? new Tenant(tenantId)
+        : null;
+});
+#endregion
+
+// First, register a pooling context factory as a Singleton service, as usual:
+#region RegisterSingletonContextFactory
+builder.Services.AddPooledDbContextFactory<WeatherForecastContext>(
+    o => o.UseSqlServer(builder.Configuration.GetConnectionString("WeatherForecastContext")));
+#endregion
+
+// Register an additional context factory as a Scoped service, which gets a pooled context from the Singleton factory we registered above,
+// finds the tenant ID in the web request's `HttpContext`, and injects the ID into the context:
+#region RegisterScopedContextFactory
+builder.Services.AddScoped<WeatherForecastScopedFactory>();
+#endregion
+
+// Finally, arrange for a context to get injected from our Scoped factory:
+#region RegisterDbContext
+builder.Services.AddScoped(
+    sp => sp.GetRequiredService<WeatherForecastScopedFactory>().CreateDbContext());
+#endregion
+
+var app = builder.Build();
+
+if (app.Environment.IsDevelopment())
+{
+    app.UseSwagger();
+    app.UseSwaggerUI();
+}
+
+app.UseHttpsRedirection();
+app.UseAuthorization();
+app.MapControllers();
+
+app.Run();
diff --git a/samples/core/Performance/AspNetContextPoolingWithState/Properties/launchSettings.json b/samples/core/Performance/AspNetContextPoolingWithState/Properties/launchSettings.json
new file mode 100644
index 0000000000..2892dcf901
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPoolingWithState/Properties/launchSettings.json
@@ -0,0 +1,12 @@
+{
+  "profiles": {
+    "AspNetContextPoolingWithState": {
+      "commandName": "Project",
+      "launchBrowser": true,
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      },
+      "applicationUrl": "https://localhost:58214;http://localhost:58216"
+    }
+  }
+}
\ No newline at end of file
diff --git a/samples/core/Performance/AspNetContextPoolingWithState/Tenant.cs b/samples/core/Performance/AspNetContextPoolingWithState/Tenant.cs
new file mode 100644
index 0000000000..87547d34ef
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPoolingWithState/Tenant.cs
@@ -0,0 +1,9 @@
+namespace Performance.AspNetContextPoolingWithState;
+
+public class Tenant : ITenant
+{
+    public Tenant(int tenantId)
+        => TenantId = tenantId;
+
+    public int TenantId { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Performance/AspNetContextPoolingWithState/WeatherForecast.cs b/samples/core/Performance/AspNetContextPoolingWithState/WeatherForecast.cs
new file mode 100644
index 0000000000..14369a68ea
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPoolingWithState/WeatherForecast.cs
@@ -0,0 +1,12 @@
+namespace Performance.AspNetContextPoolingWithState;
+
+public class WeatherForecast
+{
+    public int Id { get; set; }
+    public int TenantId { get; set; }
+
+    public DateTime Date { get; set; }
+    public int TemperatureC { get; set; }
+    public int TemperatureF => 32 + (int)(TemperatureC / 0.5556);
+    public string Summary { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Performance/AspNetContextPoolingWithState/WeatherForecastContext.cs b/samples/core/Performance/AspNetContextPoolingWithState/WeatherForecastContext.cs
new file mode 100644
index 0000000000..f8121af1aa
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPoolingWithState/WeatherForecastContext.cs
@@ -0,0 +1,46 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace Performance.AspNetContextPoolingWithState;
+
+public class WeatherForecastContext : DbContext
+{
+    public int TenantId { get; set; }
+
+    public WeatherForecastContext(DbContextOptions options)
+        : base(options)
+    {
+    }
+
+    public DbSet<WeatherForecast> Forecasts { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<WeatherForecast>()
+            .HasQueryFilter(f => f.TenantId == TenantId)
+            .HasData(
+                new WeatherForecast
+                {
+                    Id = 1,
+                    TenantId = 0,
+                    Date = new(2022, 1, 1),
+                    Summary = "Chilly",
+                    TemperatureC = -17
+                },
+                new WeatherForecast
+                {
+                    Id = 2,
+                    TenantId = 0,
+                    Date = new(2022, 1, 2),
+                    Summary = "Balmy",
+                    TemperatureC = 38
+                },
+                new WeatherForecast
+                {
+                    Id = 3,
+                    TenantId = 1,
+                    Date = new(2022, 1, 3),
+                    Summary = "Sweltering",
+                    TemperatureC = -7
+                });
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Performance/AspNetContextPoolingWithState/WeatherForecastScopedFactory.cs b/samples/core/Performance/AspNetContextPoolingWithState/WeatherForecastScopedFactory.cs
new file mode 100644
index 0000000000..3e4ffd4ad0
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPoolingWithState/WeatherForecastScopedFactory.cs
@@ -0,0 +1,29 @@
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Primitives;
+
+namespace Performance.AspNetContextPoolingWithState;
+
+#region WeatherForecastScopedFactory
+public class WeatherForecastScopedFactory : IDbContextFactory<WeatherForecastContext>
+{
+    private const int DefaultTenantId = -1;
+
+    private readonly IDbContextFactory<WeatherForecastContext> _pooledFactory;
+    private readonly int _tenantId;
+
+    public WeatherForecastScopedFactory(
+        IDbContextFactory<WeatherForecastContext> pooledFactory,
+        ITenant tenant)
+    {
+        _pooledFactory = pooledFactory;
+        _tenantId = tenant?.TenantId ?? DefaultTenantId;
+    }
+
+    public WeatherForecastContext CreateDbContext()
+    {
+        var context = _pooledFactory.CreateDbContext();
+        context.TenantId = _tenantId;
+        return context;
+    }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Performance/AspNetContextPoolingWithState/appsettings.Development.json b/samples/core/Performance/AspNetContextPoolingWithState/appsettings.Development.json
new file mode 100644
index 0000000000..0c208ae918
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPoolingWithState/appsettings.Development.json
@@ -0,0 +1,8 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  }
+}
diff --git a/samples/core/Performance/AspNetContextPoolingWithState/appsettings.json b/samples/core/Performance/AspNetContextPoolingWithState/appsettings.json
new file mode 100644
index 0000000000..3a10b9798a
--- /dev/null
+++ b/samples/core/Performance/AspNetContextPoolingWithState/appsettings.json
@@ -0,0 +1,12 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  },
+  "AllowedHosts": "*",
+  "ConnectionStrings": {
+    "WeatherForecastContext": "Server=(localdb)\\mssqllocaldb;Database=Blogging;Trusted_Connection=True"
+  }
+}
diff --git a/samples/core/Performance/Other/BatchTweakingContext.cs b/samples/core/Performance/Other/BatchTweakingContext.cs
new file mode 100644
index 0000000000..22cd37b99f
--- /dev/null
+++ b/samples/core/Performance/Other/BatchTweakingContext.cs
@@ -0,0 +1,17 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace Performance;
+
+public class BatchTweakingContext : DbContext
+{
+    #region BatchTweaking
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder.UseSqlServer(
+            @"Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True",
+            o => o
+                .MinBatchSize(1)
+                .MaxBatchSize(100));
+    }
+    #endregion
+}
\ No newline at end of file
diff --git a/samples/core/Performance/Other/BloggingContext.cs b/samples/core/Performance/Other/BloggingContext.cs
new file mode 100644
index 0000000000..c2318d6276
--- /dev/null
+++ b/samples/core/Performance/Other/BloggingContext.cs
@@ -0,0 +1,44 @@
+using System;
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Logging;
+
+namespace Performance;
+
+public class BloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    #region SimpleLogging
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;ConnectRetryCount=0")
+            .LogTo(Console.WriteLine, LogLevel.Information);
+    }
+    #endregion
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>().HasIndex(p => p.Title);
+    }
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public int Rating { get; set; }
+    public List<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
diff --git a/samples/core/Performance/Other/EmployeeContext.cs b/samples/core/Performance/Other/EmployeeContext.cs
new file mode 100644
index 0000000000..caa2e481eb
--- /dev/null
+++ b/samples/core/Performance/Other/EmployeeContext.cs
@@ -0,0 +1,24 @@
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Logging;
+
+namespace Performance;
+
+public class EmployeeContext : DbContext
+{
+    public DbSet<Employee> Employees { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;ConnectRetryCount=0")
+            .LogTo(Console.WriteLine, LogLevel.Information);
+    }
+}
+
+public class Employee
+{
+    public int Id { get; set; }
+    public string Name { get; set; }
+    public int Salary { get; set; }
+}
diff --git a/samples/core/Performance/Other/ExtensionsLoggingContext.cs b/samples/core/Performance/Other/ExtensionsLoggingContext.cs
new file mode 100644
index 0000000000..60f6e2602f
--- /dev/null
+++ b/samples/core/Performance/Other/ExtensionsLoggingContext.cs
@@ -0,0 +1,19 @@
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Logging;
+
+namespace Performance;
+
+public class ExtensionsLoggingContext : DbContext
+{
+    #region ExtensionsLogging
+    private static ILoggerFactory ContextLoggerFactory
+        => LoggerFactory.Create(b => b.AddConsole().AddFilter("", LogLevel.Information));
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;ConnectRetryCount=0")
+            .UseLoggerFactory(ContextLoggerFactory);
+    }
+    #endregion
+}
diff --git a/samples/core/Performance/Other/LazyLoading/LazyBloggingContext.cs b/samples/core/Performance/Other/LazyLoading/LazyBloggingContext.cs
new file mode 100644
index 0000000000..3514e0cc9b
--- /dev/null
+++ b/samples/core/Performance/Other/LazyLoading/LazyBloggingContext.cs
@@ -0,0 +1,36 @@
+using System;
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Logging;
+
+namespace Performance.LazyLoading;
+
+public class LazyBloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;ConnectRetryCount=0")
+            .LogTo(Console.WriteLine, LogLevel.Information)
+            .UseLazyLoadingProxies();
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public int Rating { get; set; }
+    public virtual List<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int BlogId { get; set; }
+    public virtual Blog Blog { get; set; }
+}
diff --git a/samples/core/Performance/Other/Other.csproj b/samples/core/Performance/Other/Other.csproj
new file mode 100644
index 0000000000..0f1050e105
--- /dev/null
+++ b/samples/core/Performance/Other/Other.csproj
@@ -0,0 +1,16 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>Performance.Other</RootNamespace>
+    <AssemblyName>Performance.Other</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Proxies" Version="10.0.0" />
+    <PackageReference Include="Microsoft.Extensions.Logging.Console" Version="7.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Performance/Other/PooledBloggingContext.cs b/samples/core/Performance/Other/PooledBloggingContext.cs
new file mode 100644
index 0000000000..6bef598d5d
--- /dev/null
+++ b/samples/core/Performance/Other/PooledBloggingContext.cs
@@ -0,0 +1,11 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace Performance;
+
+public class PooledBloggingContext : DbContext
+{
+    public PooledBloggingContext(DbContextOptions options) : base(options) {}
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Performance/Other/Program.cs b/samples/core/Performance/Other/Program.cs
new file mode 100644
index 0000000000..f8d7175bbb
--- /dev/null
+++ b/samples/core/Performance/Other/Program.cs
@@ -0,0 +1,247 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Performance.LazyLoading;
+
+namespace Performance;
+
+internal class Program
+{
+    #region CompiledQueryCompile
+    private static readonly Func<BloggingContext, int, IAsyncEnumerable<Blog>> _compiledQuery
+        = EF.CompileAsyncQuery(
+            (BloggingContext context, int length) => context.Blogs.Where(b => b.Url.StartsWith("http://") && b.Url.Length == length));
+    #endregion
+
+    private static async Task Main(string[] args)
+    {
+        using (var context = new BloggingContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            context.Add(
+                new Blog
+                {
+                    Url = "http://someblog.microsoft.com",
+                    Rating = 0,
+                    Posts = new List<Post>
+                    {
+                        new Post { Title = "Post 1", Content = "Sometimes..." },
+                        new Post { Title = "Post 2", Content = "Other times..." }
+                    }
+                });
+
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region Indexes
+            // Matches on start, so uses an index (on SQL Server)
+            var posts1 = await context.Posts.Where(p => p.Title.StartsWith("A")).ToListAsync();
+            // Matches on end, so does not use the index
+            var posts2 = await context.Posts.Where(p => p.Title.EndsWith("A")).ToListAsync();
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region ProjectEntities
+            await foreach (var blog in context.Blogs.AsAsyncEnumerable())
+            {
+                Console.WriteLine("Blog: " + blog.Url);
+            }
+            #endregion
+
+            #region ProjectSingleProperty
+            await foreach (var blogName in context.Blogs.Select(b => b.Url).AsAsyncEnumerable())
+            {
+                Console.WriteLine("Blog: " + blogName);
+            }
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region NoLimit
+            var blogsAll = await context.Posts
+                .Where(p => p.Title.StartsWith("A"))
+                .ToListAsync();
+            #endregion
+
+            #region Limit25
+            var blogs25 = await context.Posts
+                .Where(p => p.Title.StartsWith("A"))
+                .Take(25)
+                .ToListAsync();
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region EagerlyLoadRelatedAndProject
+            await foreach (var blog in context.Blogs.Select(b => new { b.Url, b.Posts }).AsAsyncEnumerable())
+            {
+                foreach (var post in blog.Posts)
+                {
+                    Console.WriteLine($"Blog {blog.Url}, Post: {post.Title}");
+                }
+            }
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region BufferingAndStreaming
+            // ToList and ToArray cause the entire resultset to be buffered:
+            var blogsList = await context.Posts.Where(p => p.Title.StartsWith("A")).ToListAsync();
+            var blogsArray = await context.Posts.Where(p => p.Title.StartsWith("A")).ToArrayAsync();
+
+            // Foreach streams, processing one row at a time:
+            await foreach (var blog in context.Posts.Where(p => p.Title.StartsWith("A")).AsAsyncEnumerable())
+            {
+                // ...
+            }
+
+            // AsAsyncEnumerable also streams, allowing you to execute LINQ operators on the client-side:
+            var doubleFilteredBlogs = context.Posts
+                .Where(p => p.Title.StartsWith("A")) // Translated to SQL and executed in the database
+                .AsAsyncEnumerable()
+                .Where(p => SomeDotNetMethod(p)); // Executed at the client on all database results
+            #endregion
+
+            // This method represents a filter that cannot be translated to SQL for execution in the
+            // database, and must be run on the client as a .NET method
+            static bool SomeDotNetMethod(Post post) => true;
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region SaveChangesBatching
+            var blog = await context.Blogs.SingleAsync(b => b.Url == "http://someblog.microsoft.com");
+            blog.Url = "http://someotherblog.microsoft.com";
+            context.Add(new Blog { Url = "http://newblog1.microsoft.com" });
+            context.Add(new Blog { Url = "http://newblog2.microsoft.com" });
+            await context.SaveChangesAsync();
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region QueriesWithConstants
+            var post1 = await context.Posts.FirstOrDefaultAsync(p => p.Title == "post1");
+            var post2 = await context.Posts.FirstOrDefaultAsync(p => p.Title == "post2");
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region QueriesWithParameterization
+            var postTitle = "post1";
+            var post1 = await context.Posts.FirstOrDefaultAsync(p => p.Title == postTitle);
+            postTitle = "post2";
+            var post2 = await context.Posts.FirstOrDefaultAsync(p => p.Title == postTitle);
+            #endregion
+        }
+
+        using (var context = new LazyBloggingContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            for (var i = 0; i < 10; i++)
+            {
+                context.Blogs.Add(
+                    new LazyLoading.Blog
+                    {
+                        Url = $"http://blog{i}.microsoft.com",
+                        Posts = new List<LazyLoading.Post>
+                        {
+                            new() { Title = $"1st post of blog{i}" }, new() { Title = $"2nd post of blog{i}" }
+                        }
+                    });
+            }
+
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new LazyBloggingContext())
+        {
+            #region NPlusOne
+            foreach (var blog in await context.Blogs.ToListAsync())
+            {
+                foreach (var post in blog.Posts)
+                {
+                    Console.WriteLine($"Blog {blog.Url}, Post: {post.Title}");
+                }
+            }
+            #endregion
+        }
+
+        using (var context = new EmployeeContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            for (var i = 0; i < 10; i++)
+            {
+                context.Employees.Add(new Employee());
+            }
+        }
+
+        using (var context = new EmployeeContext())
+        {
+            #region UpdateWithoutBulk
+            await foreach (var employee in context.Employees.AsAsyncEnumerable())
+            {
+                employee.Salary += 1000;
+            }
+
+            await context.SaveChangesAsync();
+            #endregion
+        }
+
+        using (var context = new EmployeeContext())
+        {
+            #region UpdateWithBulk
+            await context.Database.ExecuteSqlRawAsync("UPDATE [Employees] SET [Salary] = [Salary] + 1000");
+            #endregion
+        }
+
+        using (var context = new PooledBloggingContext(
+                   new DbContextOptionsBuilder()
+                       .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;ConnectRetryCount=0")
+                       .Options))
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        #region DbContextPoolingWithoutDI
+        var options = new DbContextOptionsBuilder<PooledBloggingContext>()
+            .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;ConnectRetryCount=0")
+            .Options;
+
+        var factory = new PooledDbContextFactory<PooledBloggingContext>(options);
+
+        using (var context = factory.CreateDbContext())
+        {
+            var allPosts = await context.Posts.ToListAsync();
+        }
+        #endregion
+
+        using (var context = new BloggingContext())
+        {
+            #region CompiledQueryExecute
+            await foreach (var blog in _compiledQuery(context, 8))
+            {
+                // Do something with the results
+            }
+            #endregion
+        }
+    }
+}
diff --git a/samples/core/Querying/ClientEvaluation/Blog.cs b/samples/core/Querying/ClientEvaluation/Blog.cs
new file mode 100644
index 0000000000..b0dc1cde25
--- /dev/null
+++ b/samples/core/Querying/ClientEvaluation/Blog.cs
@@ -0,0 +1,8 @@
+namespace EFQuerying.ClientEvaluation;
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public int? Rating { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Querying/ClientEvaluation/BloggingContext.cs b/samples/core/Querying/ClientEvaluation/BloggingContext.cs
new file mode 100644
index 0000000000..a30e355c17
--- /dev/null
+++ b/samples/core/Querying/ClientEvaluation/BloggingContext.cs
@@ -0,0 +1,22 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFQuerying.ClientEvaluation;
+
+public class BloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .HasData(
+                new Blog { BlogId = 1, Url = @"https://devblogs.microsoft.com/dotnet", Rating = 5 },
+                new Blog { BlogId = 2, Url = @"https://mytravelblog.com/", Rating = 4 });
+    }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder.UseSqlServer(
+            @"Server=(localdb)\mssqllocaldb;Database=EFQuerying.ClientEvaluation;Trusted_Connection=True;ConnectRetryCount=0");
+    }
+}
diff --git a/samples/core/Querying/ClientEvaluation/ClientEvaluation.csproj b/samples/core/Querying/ClientEvaluation/ClientEvaluation.csproj
new file mode 100644
index 0000000000..0933bb847c
--- /dev/null
+++ b/samples/core/Querying/ClientEvaluation/ClientEvaluation.csproj
@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFQuerying.ClientEvaluation</RootNamespace>
+    <AssemblyName>EFQuerying.ClientEvaluation</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Querying/ClientEvaluation/Program.cs b/samples/core/Querying/ClientEvaluation/Program.cs
new file mode 100644
index 0000000000..b82b45f0cb
--- /dev/null
+++ b/samples/core/Querying/ClientEvaluation/Program.cs
@@ -0,0 +1,69 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFQuerying.ClientEvaluation;
+
+internal class Program
+{
+    #region ClientMethod
+    public static string StandardizeUrl(string url)
+    {
+        url = url.ToLower();
+
+        if (!url.StartsWith("http://"))
+        {
+            url = string.Concat("http://", url);
+        }
+
+        return url;
+    }
+    #endregion
+
+    private static async Task Main(string[] args)
+    {
+        using (var context = new BloggingContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region ClientProjection
+            var blogs = await context.Blogs
+                .OrderByDescending(blog => blog.Rating)
+                .Select(
+                    blog => new { Id = blog.BlogId, Url = StandardizeUrl(blog.Url) })
+                .ToListAsync();
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            try
+            {
+                #region ClientWhere
+                var blogs = await context.Blogs
+                    .Where(blog => StandardizeUrl(blog.Url).Contains("dotnet"))
+                    .ToListAsync();
+                #endregion
+            }
+            catch (Exception e)
+            {
+                Console.WriteLine(e.Message);
+            }
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region ExplicitClientEvaluation
+            var blogs = context.Blogs
+                .AsAsyncEnumerable()
+                .Where(blog => StandardizeUrl(blog.Url).Contains("dotnet"))
+                .ToListAsync();
+            #endregion
+        }
+    }
+}
diff --git a/samples/core/Querying/ComplexQuery/Blog.cs b/samples/core/Querying/ComplexQuery/Blog.cs
new file mode 100644
index 0000000000..fb198f5407
--- /dev/null
+++ b/samples/core/Querying/ComplexQuery/Blog.cs
@@ -0,0 +1,15 @@
+using System.Collections.Generic;
+
+namespace EFQuerying.ComplexQuery;
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public int? Rating { get; set; }
+
+    public List<Post> Posts { get; set; }
+
+    public int OwnerId { get; set; }
+    public Person Owner { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Querying/ComplexQuery/BloggingContext.cs b/samples/core/Querying/ComplexQuery/BloggingContext.cs
new file mode 100644
index 0000000000..9637383ef3
--- /dev/null
+++ b/samples/core/Querying/ComplexQuery/BloggingContext.cs
@@ -0,0 +1,108 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFQuerying.ComplexQuery;
+
+public class BloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .HasMany(b => b.Posts)
+            .WithOne(p => p.Blog)
+            .OnDelete(DeleteBehavior.NoAction);
+
+        modelBuilder.Entity<PostTag>()
+            .HasOne(pt => pt.Post)
+            .WithMany(p => p.Tags)
+            .HasForeignKey(pt => pt.PostId);
+
+        modelBuilder.Entity<PostTag>()
+            .HasOne(pt => pt.Tag)
+            .WithMany(t => t.Posts)
+            .HasForeignKey(pt => pt.TagId);
+
+        modelBuilder.Entity<Blog>()
+            .HasData(
+                new Blog
+                {
+                    BlogId = 1, Url = @"https://devblogs.microsoft.com/dotnet", Rating = 5, OwnerId = 1,
+                },
+                new Blog { BlogId = 2, Url = @"https://mytravelblog.com/", Rating = 4, OwnerId = 3 });
+
+        modelBuilder.Entity<Post>()
+            .HasData(
+                new Post
+                {
+                    PostId = 1,
+                    BlogId = 1,
+                    Title = "What's new",
+                    Content = "Lorem ipsum dolor sit amet",
+                    Rating = 5,
+                    AuthorId = 1
+                },
+                new Post
+                {
+                    PostId = 2,
+                    BlogId = 2,
+                    Title = "Around the World in Eighty Days",
+                    Content = "consectetur adipiscing elit",
+                    Rating = 5,
+                    AuthorId = 2
+                },
+                new Post
+                {
+                    PostId = 3,
+                    BlogId = 2,
+                    Title = "Glamping *is* the way",
+                    Content = "sed do eiusmod tempor incididunt",
+                    Rating = 4,
+                    AuthorId = 3
+                },
+                new Post
+                {
+                    PostId = 4,
+                    BlogId = 2,
+                    Title = "Travel in the time of pandemic",
+                    Content = "ut labore et dolore magna aliqua",
+                    Rating = 3,
+                    AuthorId = 3
+                });
+
+        modelBuilder.Entity<Person>()
+            .HasData(
+                new Person { PersonId = 1, Name = "Dotnet Blog Admin", PhotoId = 1 },
+                new Person { PersonId = 2, Name = "Phileas Fogg", PhotoId = 2 },
+                new Person { PersonId = 3, Name = "Jane Doe", PhotoId = 3 });
+
+        modelBuilder.Entity<PersonPhoto>()
+            .HasData(
+                new PersonPhoto { PersonPhotoId = 1, Caption = "SN", Photo = new byte[] { 0x00, 0x01 } },
+                new PersonPhoto { PersonPhotoId = 2, Caption = "PF", Photo = new byte[] { 0x01, 0x02, 0x03 } },
+                new PersonPhoto { PersonPhotoId = 3, Caption = "JD", Photo = new byte[] { 0x01, 0x01, 0x01 } });
+
+        modelBuilder.Entity<Tag>()
+            .HasData(
+                new Tag { TagId = "general" },
+                new Tag { TagId = "classic" },
+                new Tag { TagId = "opinion" },
+                new Tag { TagId = "informative" });
+
+        modelBuilder.Entity<PostTag>()
+            .HasData(
+                new PostTag { PostTagId = 1, PostId = 1, TagId = "general" },
+                new PostTag { PostTagId = 2, PostId = 1, TagId = "informative" },
+                new PostTag { PostTagId = 3, PostId = 2, TagId = "classic" },
+                new PostTag { PostTagId = 4, PostId = 3, TagId = "opinion" },
+                new PostTag { PostTagId = 5, PostId = 4, TagId = "opinion" },
+                new PostTag { PostTagId = 6, PostId = 4, TagId = "informative" });
+    }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder.UseSqlServer(
+            @"Server=(localdb)\mssqllocaldb;Database=EFQuerying.ComplexQuery;Trusted_Connection=True;ConnectRetryCount=0");
+    }
+}
diff --git a/samples/core/Querying/ComplexQuery/ComplexQuery.csproj b/samples/core/Querying/ComplexQuery/ComplexQuery.csproj
new file mode 100644
index 0000000000..51df5310af
--- /dev/null
+++ b/samples/core/Querying/ComplexQuery/ComplexQuery.csproj
@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFQuerying.ComplexQuery</RootNamespace>
+    <AssemblyName>EFQuerying.ComplexQuery</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Querying/ComplexQuery/Person.cs b/samples/core/Querying/ComplexQuery/Person.cs
new file mode 100644
index 0000000000..a199903ec3
--- /dev/null
+++ b/samples/core/Querying/ComplexQuery/Person.cs
@@ -0,0 +1,15 @@
+using System.Collections.Generic;
+
+namespace EFQuerying.ComplexQuery;
+
+public class Person
+{
+    public int PersonId { get; set; }
+    public string Name { get; set; }
+
+    public List<Post> AuthoredPosts { get; set; }
+    public List<Blog> OwnedBlogs { get; set; }
+
+    public int? PhotoId { get; set; }
+    public PersonPhoto Photo { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Querying/ComplexQuery/PersonPhoto.cs b/samples/core/Querying/ComplexQuery/PersonPhoto.cs
new file mode 100644
index 0000000000..b40b69755a
--- /dev/null
+++ b/samples/core/Querying/ComplexQuery/PersonPhoto.cs
@@ -0,0 +1,10 @@
+namespace EFQuerying.ComplexQuery;
+
+public class PersonPhoto
+{
+    public int PersonPhotoId { get; set; }
+    public string Caption { get; set; }
+    public byte[] Photo { get; set; }
+
+    public Person Person { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Querying/ComplexQuery/Post.cs b/samples/core/Querying/ComplexQuery/Post.cs
new file mode 100644
index 0000000000..8bf9f24bde
--- /dev/null
+++ b/samples/core/Querying/ComplexQuery/Post.cs
@@ -0,0 +1,19 @@
+using System.Collections.Generic;
+
+namespace EFQuerying.ComplexQuery;
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+    public int Rating { get; set; }
+
+    public int BlogId { get; set; }
+    public Blog Blog { get; set; }
+
+    public int AuthorId { get; set; }
+    public Person Author { get; set; }
+
+    public List<PostTag> Tags { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Querying/ComplexQuery/PostTag.cs b/samples/core/Querying/ComplexQuery/PostTag.cs
new file mode 100644
index 0000000000..b47bbf6fac
--- /dev/null
+++ b/samples/core/Querying/ComplexQuery/PostTag.cs
@@ -0,0 +1,12 @@
+namespace EFQuerying.ComplexQuery;
+
+public class PostTag
+{
+    public int PostTagId { get; set; }
+
+    public int PostId { get; set; }
+    public Post Post { get; set; }
+
+    public string TagId { get; set; }
+    public Tag Tag { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Querying/ComplexQuery/Program.cs b/samples/core/Querying/ComplexQuery/Program.cs
new file mode 100644
index 0000000000..5720bc8891
--- /dev/null
+++ b/samples/core/Querying/ComplexQuery/Program.cs
@@ -0,0 +1,118 @@
+using System.Linq;
+
+namespace EFQuerying.ComplexQuery;
+
+internal class Program
+{
+    private static void Main(string[] args)
+    {
+        using (var context = new BloggingContext())
+        {
+            #region Join
+            var query = from photo in context.Set<PersonPhoto>()
+                        join person in context.Set<Person>()
+                            on photo.PersonPhotoId equals person.PhotoId
+                        select new { person, photo };
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region JoinComposite
+            var query = from photo in context.Set<PersonPhoto>()
+                        join person in context.Set<Person>()
+                            on new { Id = (int?)photo.PersonPhotoId, photo.Caption }
+                            equals new { Id = person.PhotoId, Caption = "SN" }
+                        select new { person, photo };
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region GroupJoin
+            var query = from b in context.Set<Blog>()
+                        join p in context.Set<Post>()
+                            on b.BlogId equals p.BlogId into grouping
+                        select new { b, grouping };
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region GroupJoinComposed
+            var query = from b in context.Set<Blog>()
+                        join p in context.Set<Post>()
+                            on b.BlogId equals p.BlogId into grouping
+                        select new { b, Posts = grouping.Where(p => p.Content.Contains("EF")).ToList() };
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region SelectManyConvertedToCrossJoin
+            var query = from b in context.Set<Blog>()
+                        from p in context.Set<Post>()
+                        select new { b, p };
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region SelectManyConvertedToJoin
+            var query = from b in context.Set<Blog>()
+                        from p in context.Set<Post>().Where(p => b.BlogId == p.BlogId)
+                        select new { b, p };
+
+            var query2 = from b in context.Set<Blog>()
+                         from p in context.Set<Post>().Where(p => b.BlogId == p.BlogId).DefaultIfEmpty()
+                         select new { b, p };
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region SelectManyConvertedToApply
+            var query = from b in context.Set<Blog>()
+                        from p in context.Set<Post>().Select(p => b.Url + "=>" + p.Title)
+                        select new { b, p };
+
+            var query2 = from b in context.Set<Blog>()
+                         from p in context.Set<Post>().Select(p => b.Url + "=>" + p.Title).DefaultIfEmpty()
+                         select new { b, p };
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region GroupBy
+            var query = from p in context.Set<Post>()
+                        group p by p.AuthorId
+                        into g
+                        select new { g.Key, Count = g.Count() };
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region GroupByFilter
+            var query = from p in context.Set<Post>()
+                        group p by p.AuthorId
+                        into g
+                        where g.Count() > 0
+                        orderby g.Key
+                        select new { g.Key, Count = g.Count() };
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region LeftJoin
+            var query = from b in context.Set<Blog>()
+                        join p in context.Set<Post>()
+                            on b.BlogId equals p.BlogId into grouping
+                        from p in grouping.DefaultIfEmpty()
+                        select new { b, p };
+            #endregion
+        }
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Querying/ComplexQuery/Tag.cs b/samples/core/Querying/ComplexQuery/Tag.cs
new file mode 100644
index 0000000000..a6145b85ca
--- /dev/null
+++ b/samples/core/Querying/ComplexQuery/Tag.cs
@@ -0,0 +1,10 @@
+using System.Collections.Generic;
+
+namespace EFQuerying.ComplexQuery;
+
+public class Tag
+{
+    public string TagId { get; set; }
+
+    public List<PostTag> Posts { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Querying/NullSemantics/NullSemantics.csproj b/samples/core/Querying/NullSemantics/NullSemantics.csproj
new file mode 100644
index 0000000000..f841b54fe4
--- /dev/null
+++ b/samples/core/Querying/NullSemantics/NullSemantics.csproj
@@ -0,0 +1,12 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Querying/NullSemantics/NullSemanticsContext.cs b/samples/core/Querying/NullSemantics/NullSemanticsContext.cs
new file mode 100644
index 0000000000..76c04fc54e
--- /dev/null
+++ b/samples/core/Querying/NullSemantics/NullSemanticsContext.cs
@@ -0,0 +1,68 @@
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+
+namespace NullSemantics;
+
+public class NullSemanticsContext : DbContext
+{
+    public DbSet<NullSemanticsEntity> Entities { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        var relationalNulls = false;
+        if (relationalNulls)
+        {
+            #region UseRelationalNulls
+            new SqlServerDbContextOptionsBuilder(optionsBuilder).UseRelationalNulls();
+            #endregion
+        }
+
+        optionsBuilder.UseSqlServer(
+            @"Server=(localdb)\mssqllocaldb;Database=NullSemanticsSample;Trusted_Connection=True;MultipleActiveResultSets=true;ConnectRetryCount=0");
+    }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<NullSemanticsEntity>().HasData(
+            new NullSemanticsEntity
+            {
+                Id = 1,
+                Int = 1,
+                NullableInt = 1,
+                String1 = "A",
+                String2 = "A"
+            },
+            new NullSemanticsEntity
+            {
+                Id = 2,
+                Int = 2,
+                NullableInt = 2,
+                String1 = "A",
+                String2 = "B"
+            },
+            new NullSemanticsEntity
+            {
+                Id = 3,
+                Int = 2,
+                NullableInt = null,
+                String1 = null,
+                String2 = "A"
+            },
+            new NullSemanticsEntity
+            {
+                Id = 4,
+                Int = 2,
+                NullableInt = null,
+                String1 = "B",
+                String2 = null
+            },
+            new NullSemanticsEntity
+            {
+                Id = 5,
+                Int = 1,
+                NullableInt = 3,
+                String1 = null,
+                String2 = null
+            });
+    }
+}
diff --git a/samples/core/Querying/NullSemantics/NullSemanticsEntity.cs b/samples/core/Querying/NullSemantics/NullSemanticsEntity.cs
new file mode 100644
index 0000000000..a45a158550
--- /dev/null
+++ b/samples/core/Querying/NullSemantics/NullSemanticsEntity.cs
@@ -0,0 +1,12 @@
+namespace NullSemantics;
+
+#region Entity
+public class NullSemanticsEntity
+{
+    public int Id { get; set; }
+    public int Int { get; set; }
+    public int? NullableInt { get; set; }
+    public string String1 { get; set; }
+    public string String2 { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Querying/NullSemantics/Program.cs b/samples/core/Querying/NullSemantics/Program.cs
new file mode 100644
index 0000000000..e57ef06bdf
--- /dev/null
+++ b/samples/core/Querying/NullSemantics/Program.cs
@@ -0,0 +1,72 @@
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace NullSemantics;
+
+internal class Program
+{
+    private static async Task Main(string[] args)
+    {
+        using var context = new NullSemanticsContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+
+        //#region FunctionSqlRaw
+        //await context.Database.ExecuteSqlRawAsync(
+        //    @"create function [dbo].[ConcatStrings] (@prm1 nvarchar(max), @prm2 nvarchar(max))
+        //        returns nvarchar(max)
+        //        as
+        //        begin
+        //            return @prm1 + @prm2;
+        //        end");
+        //#endregion
+
+        //await BasicExamples();
+        await Functions();
+        //await ManualOptimization();
+    }
+
+    private static async Task BasicExamples()
+    {
+        using var context = new NullSemanticsContext();
+        #region BasicExamples
+        var query1 = context.Entities.Where(e => e.Id == e.Int);
+        var query2 = context.Entities.Where(e => e.Id == e.NullableInt);
+        var query3 = context.Entities.Where(e => e.Id != e.NullableInt);
+        var query4 = context.Entities.Where(e => e.String1 == e.String2);
+        var query5 = context.Entities.Where(e => e.String1 != e.String2);
+        #endregion
+
+        var result1 = await query1.ToListAsync();
+        var result2 = await query2.ToListAsync();
+        var result3 = await query3.ToListAsync();
+        var result4 = await query4.ToListAsync();
+        var result5 = await query5.ToListAsync();
+    }
+
+    private static async Task Functions()
+    {
+        using var context = new NullSemanticsContext();
+
+        #region Functions
+        var query = context.Entities.Where(e => e.String1.Substring(0, e.String2.Length) == null);
+        #endregion
+
+        var result = await query.ToListAsync();
+    }
+
+    private static async Task ManualOptimization()
+    {
+        using var context = new NullSemanticsContext();
+
+        #region ManualOptimization
+        var query1 = context.Entities.Where(e => e.String1 != e.String2 || e.String1.Length == e.String2.Length);
+        var query2 = context.Entities.Where(
+            e => e.String1 != null && e.String2 != null && (e.String1 != e.String2 || e.String1.Length == e.String2.Length));
+        #endregion
+
+        var result1 = await query1.ToListAsync();
+        var result2 = await query2.ToListAsync();
+    }
+}
diff --git a/samples/core/Querying/Overview/Blog.cs b/samples/core/Querying/Overview/Blog.cs
new file mode 100644
index 0000000000..aba5e1871e
--- /dev/null
+++ b/samples/core/Querying/Overview/Blog.cs
@@ -0,0 +1,8 @@
+namespace EFQuerying.Overview;
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public int? Rating { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Querying/Overview/BloggingContext.cs b/samples/core/Querying/Overview/BloggingContext.cs
new file mode 100644
index 0000000000..849e8b9e3f
--- /dev/null
+++ b/samples/core/Querying/Overview/BloggingContext.cs
@@ -0,0 +1,22 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFQuerying.Overview;
+
+public class BloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .HasData(
+                new Blog { BlogId = 1, Url = @"https://devblogs.microsoft.com/dotnet", Rating = 5 },
+                new Blog { BlogId = 2, Url = @"https://mytravelblog.com/", Rating = 4 });
+    }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder.UseSqlServer(
+            @"Server=(localdb)\mssqllocaldb;Database=EFQuerying.Overview;Trusted_Connection=True;ConnectRetryCount=0");
+    }
+}
diff --git a/samples/core/Querying/Overview/Overview.csproj b/samples/core/Querying/Overview/Overview.csproj
new file mode 100644
index 0000000000..99418d4ac4
--- /dev/null
+++ b/samples/core/Querying/Overview/Overview.csproj
@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFQuerying.Overview</RootNamespace>
+    <AssemblyName>EFQuerying.Overview</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Querying/Overview/Program.cs b/samples/core/Querying/Overview/Program.cs
new file mode 100644
index 0000000000..24a122a9e8
--- /dev/null
+++ b/samples/core/Querying/Overview/Program.cs
@@ -0,0 +1,41 @@
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFQuerying.Overview;
+
+internal class Program
+{
+    private static async Task Main(string[] args)
+    {
+        using (var context = new BloggingContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        #region LoadingAllData
+        using (var context = new BloggingContext())
+        {
+            var blogs = await context.Blogs.ToListAsync();
+        }
+        #endregion
+
+        #region LoadingSingleEntity
+        using (var context = new BloggingContext())
+        {
+            var blog = await context.Blogs
+                .SingleAsync(b => b.BlogId == 1);
+        }
+        #endregion
+
+        #region Filtering
+        using (var context = new BloggingContext())
+        {
+            var blogs = await context.Blogs
+                .Where(b => b.Url.Contains("dotnet"))
+                .ToListAsync();
+        }
+        #endregion
+    }
+}
diff --git a/samples/core/Querying/Pagination/BloggingContext.cs b/samples/core/Querying/Pagination/BloggingContext.cs
new file mode 100644
index 0000000000..b154ede4e8
--- /dev/null
+++ b/samples/core/Querying/Pagination/BloggingContext.cs
@@ -0,0 +1,45 @@
+using System;
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Logging;
+
+namespace EFQuerying.Pagination;
+
+public class BloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    #region SimpleLogging
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;ConnectRetryCount=0")
+            .LogTo(Console.WriteLine, LogLevel.Information);
+    }
+    #endregion
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Post>().HasIndex(p => p.Title);
+    }
+}
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public int Rating { get; set; }
+    public List<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+    public DateTime Date { get; set; }
+
+    public int BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
diff --git a/samples/core/Querying/Pagination/Pagination.csproj b/samples/core/Querying/Pagination/Pagination.csproj
new file mode 100644
index 0000000000..ba265a8832
--- /dev/null
+++ b/samples/core/Querying/Pagination/Pagination.csproj
@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFQuerying.Pagination</RootNamespace>
+    <AssemblyName>EFQuerying.Pagination</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Querying/Pagination/Program.cs b/samples/core/Querying/Pagination/Program.cs
new file mode 100644
index 0000000000..4eedaa5207
--- /dev/null
+++ b/samples/core/Querying/Pagination/Program.cs
@@ -0,0 +1,56 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFQuerying.Pagination;
+
+internal class Program
+{
+    private static async Task Main(string[] args)
+    {
+        using (var context = new BloggingContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region OffsetPagination
+            var position = 20;
+            var nextPage = await context.Posts
+                .OrderBy(b => b.PostId)
+                .Skip(position)
+                .Take(10)
+                .ToListAsync();
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region KeySetPagination
+            var lastId = 55;
+            var nextPage = await context.Posts
+                .OrderBy(b => b.PostId)
+                .Where(b => b.PostId > lastId)
+                .Take(10)
+                .ToListAsync();
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region KeySetPaginationWithMultipleKeys
+            var lastDate = new DateTime(2020, 1, 1);
+            var lastId = 55;
+            var nextPage = await context.Posts
+                .OrderBy(b => b.Date)
+                .ThenBy(b => b.PostId)
+                .Where(b => b.Date > lastDate || (b.Date == lastDate && b.PostId > lastId))
+                .Take(10)
+                .ToListAsync();
+            #endregion
+        }
+    }
+}
diff --git a/samples/core/Querying/QueryFilters/Multitenancy.cs b/samples/core/Querying/QueryFilters/Multitenancy.cs
new file mode 100644
index 0000000000..c30fbb9e52
--- /dev/null
+++ b/samples/core/Querying/QueryFilters/Multitenancy.cs
@@ -0,0 +1,64 @@
+using System;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+#nullable enable
+
+namespace EFQuerying.QueryFilters;
+
+public static class Multitenancy
+{
+    public static async Task Sample()
+    {
+        // First, create the database and add some data to it
+        using (var context = new MultitenancyContext("John"))
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            context.Blogs.AddRange(
+                new() { Name = "John's blog", TenantId = "John" },
+                new() { Name = "Mary's blog", TenantId = "Mary" });
+            await context.SaveChangesAsync();
+        }
+
+        // Now, let's query out all blogs.
+        // Since we specify Mary as the tenant ID for the context, only Mary's blogs will be returned.
+        using (var context = new MultitenancyContext("Mary"))
+        {
+            Console.WriteLine("Blogs:");
+            await foreach (var blog in context.Blogs)
+            {
+                Console.WriteLine(blog.Name);
+            }
+        }
+    }
+
+    public class MultitenancyContext(string tenantId) : DbContext
+    {
+        public DbSet<Blog> Blogs { get; set; }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder.UseSqlServer(
+                @"Server=(localdb)\mssqllocaldb;Database=Querying.QueryFilters.Blogging;Trusted_Connection=True;ConnectRetryCount=0");
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<Blog>().HasQueryFilter(b => b.TenantId == tenantId);
+        }
+    }
+
+    #region Blog
+    public class Blog
+    {
+        public int Id { get; set; }
+        public required string TenantId { get; set; }
+
+        public string Name { get; set; }
+    }
+    #endregion
+}
diff --git a/samples/core/Querying/QueryFilters/NamedFilters.cs b/samples/core/Querying/QueryFilters/NamedFilters.cs
new file mode 100644
index 0000000000..26c788a9e6
--- /dev/null
+++ b/samples/core/Querying/QueryFilters/NamedFilters.cs
@@ -0,0 +1,113 @@
+using System;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Logging;
+
+#nullable enable
+
+namespace EFQuerying.QueryFilters;
+
+public static class NamedFilters
+{
+    public static async Task Sample()
+    {
+        // First, create the database and add some data to it
+        using (var context = new NamedFiltersContext("John"))
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            context.Blogs.AddRange(
+                new() { Name = "John's first blog", TenantId = "John" },
+                new() { Name = "John's second blog", TenantId = "John" },
+                new() { Name = "Mary's blog", TenantId = "Mary" });
+            await context.SaveChangesAsync();
+        }
+
+        // Let's delete a blog. Note that although our code seems to delete the blog in the regular way,
+        // our override of SaveChangesAsync below will actually modify it instead, setting the IsDeleted property to true.
+        using (var context = new NamedFiltersContext("John"))
+        {
+            var blog = await context.Blogs.FirstAsync(b => b.Name == "John's first blog");
+            context.Blogs.Remove(blog);
+            await context.SaveChangesAsync();
+        }
+
+        // Now, let's query out all blogs.
+        // We only get John's second blog, because the first is filtered out by the soft deletion filter, and Mary's blog
+        // by the multitenancy filter.
+        using (var context = new NamedFiltersContext("John"))
+        {
+            Console.WriteLine("Blogs:");
+            await foreach (var blog in context.Blogs)
+            {
+                Console.WriteLine(blog.Name);
+            }
+        }
+
+        // Let's selectively disable only the soft deletion filter:
+        using (var context = new NamedFiltersContext("John"))
+        {
+            Console.WriteLine("Blogs (including soft-deleted ones):");
+            #region DisableSoftDeletionFilter
+            var allBlogs = await context.Blogs.IgnoreQueryFilters(["SoftDeletionFilter"]).ToListAsync();
+            #endregion
+
+            foreach (var blog in allBlogs)
+            {
+                Console.WriteLine(blog.Name);
+            }
+        }
+    }
+
+    public class NamedFiltersContext(string tenantId) : DbContext
+    {
+        public DbSet<Blog> Blogs { get; set; }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder.UseSqlServer(
+                @"Server=(localdb)\mssqllocaldb;Database=Querying.QueryFilters.Blogging;Trusted_Connection=True;ConnectRetryCount=0");
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region FilterConfiguration
+            modelBuilder.Entity<Blog>()
+                .HasQueryFilter("SoftDeletionFilter", b => !b.IsDeleted)
+                .HasQueryFilter("TenantFilter", b => b.TenantId == tenantId);
+            #endregion
+        }
+
+        // The following overrides SaveChangesAsync to add logic which goes over all entities which the user deleted, and changes
+        // them to be modified instead, setting the IsDeleted property to true.
+        public override async Task<int> SaveChangesAsync(CancellationToken cancellationToken = default)
+        {
+            ChangeTracker.DetectChanges();
+
+            foreach (var item in ChangeTracker.Entries<Blog>().Where(e => e.State == EntityState.Deleted))
+            {
+                item.State = EntityState.Modified;
+                item.CurrentValues["IsDeleted"] = true;
+            }
+
+            return await base.SaveChangesAsync(cancellationToken);
+        }
+
+        public override int SaveChanges()
+            => throw new NotSupportedException("Use SaveChangesAsync instead.");
+    }
+
+    #region Blog
+    public class Blog
+    {
+        public int Id { get; set; }
+        public bool IsDeleted { get; set; }
+        public required string TenantId { get; set; }
+
+        public string Name { get; set; }
+    }
+    #endregion
+}
diff --git a/samples/core/Querying/QueryFilters/Program.cs b/samples/core/Querying/QueryFilters/Program.cs
new file mode 100644
index 0000000000..a133cb495f
--- /dev/null
+++ b/samples/core/Querying/QueryFilters/Program.cs
@@ -0,0 +1,14 @@
+using System.Threading.Tasks;
+
+namespace EFQuerying.QueryFilters;
+
+internal class Program
+{
+    private static async Task Main(string[] args)
+    {
+        await SoftDeletion.Sample();
+        await Multitenancy.Sample();
+        await NamedFilters.Sample();
+        await QueryFiltersAndRequiredNavigations.Sample();
+    }
+}
diff --git a/samples/core/Querying/QueryFilters/QueryFilters.csproj b/samples/core/Querying/QueryFilters/QueryFilters.csproj
new file mode 100644
index 0000000000..0fd5561e65
--- /dev/null
+++ b/samples/core/Querying/QueryFilters/QueryFilters.csproj
@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFQuerying.QueryFilters</RootNamespace>
+    <AssemblyName>EFQuerying.QueryFilters</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0-preview.6.25311.107" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0-preview.6.25311.107" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Querying/QueryFilters/QueryFiltersAndRequiredNavigations.cs b/samples/core/Querying/QueryFilters/QueryFiltersAndRequiredNavigations.cs
new file mode 100644
index 0000000000..1b3e8ddebd
--- /dev/null
+++ b/samples/core/Querying/QueryFilters/QueryFiltersAndRequiredNavigations.cs
@@ -0,0 +1,142 @@
+using System;
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFQuerying.QueryFilters;
+
+public static class QueryFiltersAndRequiredNavigations
+{
+    public static async Task Sample()
+    {
+        using (var db = new QueryFiltersAndRequiredNavigationsContext())
+        {
+            await db.Database.EnsureDeletedAsync();
+            await db.Database.EnsureCreatedAsync();
+
+            #region SeedData
+            db.Blogs.Add(
+                new Blog
+                {
+                    Url = "http://sample.com/blogs/fish",
+                    Posts =
+                    [
+                        new() { Title = "Fish care 101" },
+                        new() { Title = "Caring for tropical fish" },
+                        new() { Title = "Types of ornamental fish" }
+                    ]
+                });
+
+            db.Blogs.Add(
+                new Blog
+                {
+                    Url = "http://sample.com/blogs/cats",
+                    Posts =
+                    [
+                        new() { Title = "Cat care 101" },
+                        new() { Title = "Caring for tropical cats" },
+                        new() { Title = "Types of ornamental cats" }
+                    ]
+                });
+            #endregion
+
+            await db.SaveChangesAsync();
+        }
+
+        Console.WriteLine("Use of required navigations to access entity with query filter demo");
+        using (var db = new QueryFiltersAndRequiredNavigationsContext())
+        {
+            #region Queries
+            var allPosts = await db.Posts.ToListAsync();
+            var allPostsWithBlogsIncluded = await db.Posts.Include(p => p.Blog).ToListAsync();
+            #endregion
+
+            if (allPosts.Count == allPostsWithBlogsIncluded.Count)
+            {
+                Console.WriteLine($"Query filters set up correctly. Result count for both queries: {allPosts.Count}.");
+            }
+            else
+            {
+                Console.WriteLine("Unexpected discrepancy due to query filters and required navigations interaction.");
+                Console.WriteLine($"All posts count: {allPosts.Count}.");
+                Console.WriteLine($"All posts with blogs included count: {allPostsWithBlogsIncluded.Count}.");
+            }
+        }
+    }
+
+    public class QueryFiltersAndRequiredNavigationsContext : DbContext
+    {
+        public DbSet<Blog> Blogs { get; set; }
+        public DbSet<Post> Posts { get; set; }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder
+                .UseSqlServer(
+                    @"Server=(localdb)\mssqllocaldb;Database=Querying.QueryFilters.BloggingRequired;Trusted_Connection=True;ConnectRetryCount=0");
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            var setup = "OptionalNav";
+            if (setup == "Faulty")
+            {
+                // Incorrect setup - Required navigation used to reference entity that has query filter defined,
+                // but no query filter for the entity on the other side of the navigation.
+                #region IncorrectFilter
+                modelBuilder.Entity<Blog>().HasMany(b => b.Posts).WithOne(p => p.Blog).IsRequired();
+                modelBuilder.Entity<Blog>().HasQueryFilter(b => b.Url.Contains("fish"));
+                #endregion
+            }
+            else if (setup == "OptionalNav")
+            {
+                // The relationship is marked as optional so dependent can exist even if principal is filtered out.
+                #region OptionalNavigation
+                modelBuilder.Entity<Blog>().HasMany(b => b.Posts).WithOne(p => p.Blog).IsRequired(false);
+                modelBuilder.Entity<Blog>().HasQueryFilter(b => b.Url.Contains("fish"));
+                #endregion
+            }
+            else if (setup == "NavigationInFilter")
+            {
+                #region NavigationInFilter
+                modelBuilder.Entity<Blog>().HasMany(b => b.Posts).WithOne(p => p.Blog);
+                modelBuilder.Entity<Blog>().HasQueryFilter(b => b.Posts.Count > 0);
+                modelBuilder.Entity<Post>().HasQueryFilter(p => p.Title.Contains("fish"));
+                #endregion
+            }
+            else
+            {
+                // The relationship is still required but there is a matching filter configured on dependent side too,
+                // which matches principal side. So if principal is filtered out, the dependent would also be.
+                #region MatchingFilters
+                modelBuilder.Entity<Blog>().HasMany(b => b.Posts).WithOne(p => p.Blog).IsRequired();
+                modelBuilder.Entity<Blog>().HasQueryFilter(b => b.Url.Contains("fish"));
+                modelBuilder.Entity<Post>().HasQueryFilter(p => p.Blog.Url.Contains("fish"));
+                #endregion
+            }
+        }
+    }
+
+    public class Blog
+    {
+    #pragma warning disable IDE0051, CS0169 // Remove unused private members
+        private string _tenantId;
+    #pragma warning restore IDE0051, CS0169 // Remove unused private members
+
+        public int BlogId { get; set; }
+        public string Name { get; set; }
+        public string Url { get; set; }
+
+        public List<Post> Posts { get; set; }
+    }
+
+    public class Post
+    {
+        public int PostId { get; set; }
+        public string Title { get; set; }
+        public string Content { get; set; }
+        public bool IsDeleted { get; set; }
+
+        public Blog Blog { get; set; }
+    }
+}
diff --git a/samples/core/Querying/QueryFilters/SoftDeletion.cs b/samples/core/Querying/QueryFilters/SoftDeletion.cs
new file mode 100644
index 0000000000..ee91b9a288
--- /dev/null
+++ b/samples/core/Querying/QueryFilters/SoftDeletion.cs
@@ -0,0 +1,108 @@
+using System;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+#nullable enable
+
+namespace EFQuerying.QueryFilters;
+
+public static class SoftDeletion
+{
+    public static async Task Sample()
+    {
+        // First, create the database and add some data to it
+        using (var context = new SoftDeleteContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+
+            context.Blogs.AddRange(
+                new() { Name = "John's blog" },
+                new() { Name = "Mary's blog" });
+            await context.SaveChangesAsync();
+        }
+
+        // Let's delete a blog. Note that although our code seems to delete the blog in the regular way,
+        // our override of SaveChangesAsync below will actually modify it instead, setting the IsDeleted property to true.
+        using (var context = new SoftDeleteContext())
+        {
+            var blog = await context.Blogs.FirstAsync(b => b.Name == "John's blog");
+            context.Blogs.Remove(blog);
+            await context.SaveChangesAsync();
+        }
+
+        // Now, let's query out all blogs. The global query filter will ensure that John's blog is not returned, because it has been soft-deleted.
+        using (var context = new SoftDeleteContext())
+        {
+            Console.WriteLine("Blogs:");
+            await foreach (var blog in context.Blogs)
+            {
+                Console.WriteLine(blog.Name);
+            }
+        }
+
+        // Finally, for auditing reasons, let's now query out all blogs, John's blog is returned even though it has been soft-deleted.
+        using (var context = new SoftDeleteContext())
+        {
+            Console.WriteLine("Blogs (including soft-deleted ones):");
+            #region DisableFilter
+            var allBlogs = await context.Blogs.IgnoreQueryFilters().ToListAsync();
+            #endregion
+
+            foreach (var blog in allBlogs)
+            {
+                Console.WriteLine(blog.Name);
+            }
+        }
+    }
+
+    public class SoftDeleteContext : DbContext
+    {
+        public DbSet<Blog> Blogs { get; set; }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder.UseSqlServer(
+                @"Server=(localdb)\mssqllocaldb;Database=Querying.QueryFilters.Blogging;Trusted_Connection=True;ConnectRetryCount=0");
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            #region FilterConfiguration
+            modelBuilder.Entity<Blog>().HasQueryFilter(b => !b.IsDeleted);
+            #endregion
+        }
+
+        // The following overrides SaveChangesAsync to add logic which goes over all entities which the user deleted, and changes
+        // them to be modified instead, setting the IsDeleted property to true.
+        #region SaveChangesAsyncOverride
+        public override async Task<int> SaveChangesAsync(CancellationToken cancellationToken = default)
+        {
+            ChangeTracker.DetectChanges();
+
+            foreach (var item in ChangeTracker.Entries<Blog>().Where(e => e.State == EntityState.Deleted))
+            {
+                item.State = EntityState.Modified;
+                item.CurrentValues["IsDeleted"] = true;
+            }
+
+            return await base.SaveChangesAsync(cancellationToken);
+        }
+        #endregion
+
+        public override int SaveChanges()
+            => throw new NotSupportedException("Use SaveChangesAsync instead.");
+    }
+
+    #region Blog
+    public class Blog
+    {
+        public int Id { get; set; }
+        public bool IsDeleted { get; set; }
+
+        public string Name { get; set; }
+    }
+    #endregion
+}
diff --git a/samples/core/Querying/RelatedData/Blog.cs b/samples/core/Querying/RelatedData/Blog.cs
new file mode 100644
index 0000000000..f803bd6f87
--- /dev/null
+++ b/samples/core/Querying/RelatedData/Blog.cs
@@ -0,0 +1,18 @@
+using System.Collections.Generic;
+
+namespace EFQuerying.RelatedData;
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public int? Rating { get; set; }
+
+    public List<Post> Posts { get; set; }
+
+    public int OwnerId { get; set; }
+    public Person Owner { get; set; }
+
+    public int ThemeId { get; set; }
+    public Theme Theme { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Querying/RelatedData/BloggingContext.cs b/samples/core/Querying/RelatedData/BloggingContext.cs
new file mode 100644
index 0000000000..5644a1a007
--- /dev/null
+++ b/samples/core/Querying/RelatedData/BloggingContext.cs
@@ -0,0 +1,127 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFQuerying.RelatedData;
+
+public class BloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+    public DbSet<Theme> Themes { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .HasMany(b => b.Posts)
+            .WithOne(p => p.Blog)
+            .OnDelete(DeleteBehavior.NoAction);
+
+        modelBuilder.Entity<PostTag>()
+            .HasOne(pt => pt.Post)
+            .WithMany(p => p.Tags)
+            .HasForeignKey(pt => pt.PostId);
+
+        modelBuilder.Entity<PostTag>()
+            .HasOne(pt => pt.Tag)
+            .WithMany(t => t.Posts)
+            .HasForeignKey(pt => pt.TagId);
+
+        #region AutoInclude
+        modelBuilder.Entity<Theme>().Navigation(e => e.ColorScheme).AutoInclude();
+        #endregion
+
+        modelBuilder.Entity<Blog>()
+            .HasData(
+                new Blog
+                {
+                    BlogId = 1,
+                    Url = @"https://devblogs.microsoft.com/dotnet",
+                    Rating = 5,
+                    OwnerId = 1,
+                    ThemeId = 1
+                },
+                new Blog { BlogId = 2, Url = @"https://mytravelblog.com/", Rating = 4, OwnerId = 3, ThemeId = 1 });
+
+        modelBuilder.Entity<Post>()
+            .HasData(
+                new Post
+                {
+                    PostId = 1,
+                    BlogId = 1,
+                    Title = "What's new",
+                    Content = "Lorem ipsum dolor sit amet",
+                    Rating = 5,
+                    AuthorId = 1
+                },
+                new Post
+                {
+                    PostId = 2,
+                    BlogId = 2,
+                    Title = "Around the World in Eighty Days",
+                    Content = "consectetur adipiscing elit",
+                    Rating = 5,
+                    AuthorId = 2
+                },
+                new Post
+                {
+                    PostId = 3,
+                    BlogId = 2,
+                    Title = "Glamping *is* the way",
+                    Content = "sed do eiusmod tempor incididunt",
+                    Rating = 4,
+                    AuthorId = 3
+                },
+                new Post
+                {
+                    PostId = 4,
+                    BlogId = 2,
+                    Title = "Travel in the time of pandemic",
+                    Content = "ut labore et dolore magna aliqua",
+                    Rating = 3,
+                    AuthorId = 3
+                });
+
+        modelBuilder.Entity<Person>()
+            .HasData(
+                new Person { PersonId = 1, Name = "Dotnet Blog Admin", PhotoId = 1 },
+                new Person { PersonId = 2, Name = "Phileas Fogg", PhotoId = 2 },
+                new Person { PersonId = 3, Name = "Jane Doe", PhotoId = 3 });
+
+        modelBuilder.Entity<PersonPhoto>()
+            .HasData(
+                new PersonPhoto { PersonPhotoId = 1, Caption = "SN", Photo = new byte[] { 0x00, 0x01 } },
+                new PersonPhoto { PersonPhotoId = 2, Caption = "PF", Photo = new byte[] { 0x01, 0x02, 0x03 } },
+                new PersonPhoto { PersonPhotoId = 3, Caption = "JD", Photo = new byte[] { 0x01, 0x01, 0x01 } });
+
+        modelBuilder.Entity<Tag>()
+            .HasData(
+                new Tag { TagId = "general" },
+                new Tag { TagId = "classic" },
+                new Tag { TagId = "opinion" },
+                new Tag { TagId = "informative" });
+
+        modelBuilder.Entity<PostTag>()
+            .HasData(
+                new PostTag { PostTagId = 1, PostId = 1, TagId = "general" },
+                new PostTag { PostTagId = 2, PostId = 1, TagId = "informative" },
+                new PostTag { PostTagId = 3, PostId = 2, TagId = "classic" },
+                new PostTag { PostTagId = 4, PostId = 3, TagId = "opinion" },
+                new PostTag { PostTagId = 5, PostId = 4, TagId = "opinion" },
+                new PostTag { PostTagId = 6, PostId = 4, TagId = "informative" });
+
+        modelBuilder.Entity<ColorScheme>()
+            .HasData(
+                new ColorScheme { Id = 1, Background = "FFFFFF", HighlightColor = "00FF00" }
+            );
+
+        modelBuilder.Entity<Theme>()
+            .HasData(
+                new Theme { Id = 1, ColorSchemeId = 1 }
+            );
+    }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder.UseSqlServer(
+            @"Server=(localdb)\mssqllocaldb;Database=EFQuerying.ComplexQuery;Trusted_Connection=True;ConnectRetryCount=0");
+    }
+}
diff --git a/samples/core/Querying/RelatedData/ColorScheme.cs b/samples/core/Querying/RelatedData/ColorScheme.cs
new file mode 100644
index 0000000000..0b6fc2868e
--- /dev/null
+++ b/samples/core/Querying/RelatedData/ColorScheme.cs
@@ -0,0 +1,8 @@
+namespace EFQuerying.RelatedData;
+
+public class ColorScheme
+{
+    public int Id { get; set; }
+    public string Background { get; set; }
+    public string HighlightColor { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Querying/RelatedData/Person.cs b/samples/core/Querying/RelatedData/Person.cs
new file mode 100644
index 0000000000..37407c3305
--- /dev/null
+++ b/samples/core/Querying/RelatedData/Person.cs
@@ -0,0 +1,15 @@
+using System.Collections.Generic;
+
+namespace EFQuerying.RelatedData;
+
+public class Person
+{
+    public int PersonId { get; set; }
+    public string Name { get; set; }
+
+    public List<Post> AuthoredPosts { get; set; }
+    public List<Blog> OwnedBlogs { get; set; }
+
+    public int? PhotoId { get; set; }
+    public PersonPhoto Photo { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Querying/RelatedData/PersonPhoto.cs b/samples/core/Querying/RelatedData/PersonPhoto.cs
new file mode 100644
index 0000000000..bcd4d0b5db
--- /dev/null
+++ b/samples/core/Querying/RelatedData/PersonPhoto.cs
@@ -0,0 +1,10 @@
+namespace EFQuerying.RelatedData;
+
+public class PersonPhoto
+{
+    public int PersonPhotoId { get; set; }
+    public string Caption { get; set; }
+    public byte[] Photo { get; set; }
+
+    public Person Person { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Querying/RelatedData/Post.cs b/samples/core/Querying/RelatedData/Post.cs
new file mode 100644
index 0000000000..a3c52ba5d9
--- /dev/null
+++ b/samples/core/Querying/RelatedData/Post.cs
@@ -0,0 +1,19 @@
+using System.Collections.Generic;
+
+namespace EFQuerying.RelatedData;
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+    public int Rating { get; set; }
+
+    public int BlogId { get; set; }
+    public Blog Blog { get; set; }
+
+    public int AuthorId { get; set; }
+    public Person Author { get; set; }
+
+    public List<PostTag> Tags { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Querying/RelatedData/PostTag.cs b/samples/core/Querying/RelatedData/PostTag.cs
new file mode 100644
index 0000000000..0068ece769
--- /dev/null
+++ b/samples/core/Querying/RelatedData/PostTag.cs
@@ -0,0 +1,12 @@
+namespace EFQuerying.RelatedData;
+
+public class PostTag
+{
+    public int PostTagId { get; set; }
+
+    public int PostId { get; set; }
+    public Post Post { get; set; }
+
+    public string TagId { get; set; }
+    public Tag Tag { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Querying/RelatedData/Program.cs b/samples/core/Querying/RelatedData/Program.cs
new file mode 100644
index 0000000000..e30c8663c5
--- /dev/null
+++ b/samples/core/Querying/RelatedData/Program.cs
@@ -0,0 +1,234 @@
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFQuerying.RelatedData;
+
+internal class Program
+{
+    private static async Task Main(string[] args)
+    {
+        using (var context = new BloggingContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        #region SingleInclude
+        using (var context = new BloggingContext())
+        {
+            var blogs = await context.Blogs
+                .Include(blog => blog.Posts)
+                .ToListAsync();
+        }
+        #endregion
+
+        #region IgnoredInclude
+        using (var context = new BloggingContext())
+        {
+            var blogs = await context.Blogs
+                .Include(blog => blog.Posts)
+                .Select(
+                    blog => new { Id = blog.BlogId, blog.Url })
+                .ToListAsync();
+        }
+        #endregion
+
+        #region MultipleIncludes
+        using (var context = new BloggingContext())
+        {
+            var blogs = await context.Blogs
+                .Include(blog => blog.Posts)
+                .Include(blog => blog.Owner)
+                .ToListAsync();
+        }
+        #endregion
+
+        #region SingleThenInclude
+        using (var context = new BloggingContext())
+        {
+            var blogs = await context.Blogs
+                .Include(blog => blog.Posts)
+                .ThenInclude(post => post.Author)
+                .ToListAsync();
+        }
+        #endregion
+
+        #region MultipleThenIncludes
+        using (var context = new BloggingContext())
+        {
+            var blogs = await context.Blogs
+                .Include(blog => blog.Posts)
+                .ThenInclude(post => post.Author)
+                .ThenInclude(author => author.Photo)
+                .ToListAsync();
+        }
+        #endregion
+
+        #region IncludeTree
+        using (var context = new BloggingContext())
+        {
+            var blogs = await context.Blogs
+                .Include(blog => blog.Posts)
+                .ThenInclude(post => post.Author)
+                .ThenInclude(author => author.Photo)
+                .Include(blog => blog.Owner)
+                .ThenInclude(owner => owner.Photo)
+                .ToListAsync();
+        }
+        #endregion
+
+        #region MultipleLeafIncludes
+        using (var context = new BloggingContext())
+        {
+            var blogs = await context.Blogs
+                .Include(blog => blog.Posts)
+                .ThenInclude(post => post.Author)
+                .Include(blog => blog.Posts)
+                .ThenInclude(post => post.Tags)
+                .ToListAsync();
+        }
+        #endregion
+
+        #region IncludeMultipleNavigationsWithSingleInclude
+        using (var context = new BloggingContext())
+        {
+            var blogs = await context.Blogs
+                .Include(blog => blog.Owner.AuthoredPosts)
+                .ThenInclude(post => post.Blog.Owner.Photo)
+                .ToListAsync();
+        }
+        #endregion
+
+        #region AsSplitQuery
+        using (var context = new BloggingContext())
+        {
+            var blogs = await context.Blogs
+                .Include(blog => blog.Posts)
+                .AsSplitQuery()
+                .ToListAsync();
+        }
+        #endregion
+
+        using (var context = new SplitQueriesBloggingContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        #region WithSplitQueryAsDefault
+        using (var context = new SplitQueriesBloggingContext())
+        {
+            var blogs = await context.Blogs
+                .Include(blog => blog.Posts)
+                .ToListAsync();
+        }
+        #endregion
+
+        #region AsSingleQuery
+        using (var context = new SplitQueriesBloggingContext())
+        {
+            var blogs = await context.Blogs
+                .Include(blog => blog.Posts)
+                .AsSingleQuery()
+                .ToListAsync();
+        }
+        #endregion
+
+        #region Explicit
+        using (var context = new BloggingContext())
+        {
+            var blog = await context.Blogs
+                .SingleAsync(b => b.BlogId == 1);
+
+            await context.Entry(blog)
+                .Collection(b => b.Posts)
+                .LoadAsync();
+
+            await context.Entry(blog)
+                .Reference(b => b.Owner)
+                .LoadAsync();
+        }
+        #endregion
+
+        #region NavQueryAggregate
+        using (var context = new BloggingContext())
+        {
+            var blog = await context.Blogs
+                .SingleAsync(b => b.BlogId == 1);
+
+            var postCount = await context.Entry(blog)
+                .Collection(b => b.Posts)
+                .Query()
+                .CountAsync();
+        }
+        #endregion
+
+        #region NavQueryFiltered
+        using (var context = new BloggingContext())
+        {
+            var blog = await context.Blogs
+                .SingleAsync(b => b.BlogId == 1);
+
+            var goodPosts = await context.Entry(blog)
+                .Collection(b => b.Posts)
+                .Query()
+                .Where(p => p.Rating > 3)
+                .ToListAsync();
+        }
+        #endregion
+
+        #region FilteredInclude
+        using (var context = new BloggingContext())
+        {
+            var filteredBlogs = await context.Blogs
+                .Include(
+                    blog => blog.Posts
+                        .Where(post => post.BlogId == 1)
+                        .OrderByDescending(post => post.Title)
+                        .Take(5))
+                .ToListAsync();
+        }
+        #endregion
+
+        #region MultipleLeafIncludesFiltered1
+        using (var context = new BloggingContext())
+        {
+            var filteredBlogs = await context.Blogs
+                .Include(blog => blog.Posts.Where(post => post.BlogId == 1))
+                .ThenInclude(post => post.Author)
+                .Include(blog => blog.Posts)
+                .ThenInclude(post => post.Tags.OrderBy(postTag => postTag.TagId).Skip(3))
+                .ToListAsync();
+        }
+        #endregion
+
+        #region MultipleLeafIncludesFiltered2
+        using (var context = new BloggingContext())
+        {
+            var filteredBlogs = await context.Blogs
+                .Include(blog => blog.Posts.Where(post => post.BlogId == 1))
+                .ThenInclude(post => post.Author)
+                .Include(blog => blog.Posts.Where(post => post.BlogId == 1))
+                .ThenInclude(post => post.Tags.OrderBy(postTag => postTag.TagId).Skip(3))
+                .ToListAsync();
+        }
+        #endregion
+
+        #region AutoIncludes
+        using (var context = new BloggingContext())
+        {
+            var themes = await context.Themes.ToListAsync();
+        }
+
+        #endregion
+
+        #region IgnoreAutoIncludes
+        using (var context = new BloggingContext())
+        {
+            var themes = await context.Themes.IgnoreAutoIncludes().ToListAsync();
+        }
+
+        #endregion
+    }
+}
diff --git a/samples/core/Querying/RelatedData/RelatedData.csproj b/samples/core/Querying/RelatedData/RelatedData.csproj
new file mode 100644
index 0000000000..9b840df1e1
--- /dev/null
+++ b/samples/core/Querying/RelatedData/RelatedData.csproj
@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFQuerying.RelatedData</RootNamespace>
+    <AssemblyName>EFQuerying.RelatedData</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Querying/RelatedData/SplitQueriesBloggingContext.cs b/samples/core/Querying/RelatedData/SplitQueriesBloggingContext.cs
new file mode 100644
index 0000000000..769d83edf4
--- /dev/null
+++ b/samples/core/Querying/RelatedData/SplitQueriesBloggingContext.cs
@@ -0,0 +1,16 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFQuerying.RelatedData;
+
+public class SplitQueriesBloggingContext : BloggingContext
+{
+    #region QuerySplittingBehaviorSplitQuery
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .UseSqlServer(
+                @"Server=(localdb)\mssqllocaldb;Database=EFQuerying;Trusted_Connection=True;ConnectRetryCount=0",
+                o => o.UseQuerySplittingBehavior(QuerySplittingBehavior.SplitQuery));
+    }
+    #endregion
+}
diff --git a/samples/core/Querying/RelatedData/Tag.cs b/samples/core/Querying/RelatedData/Tag.cs
new file mode 100644
index 0000000000..3e3a300afb
--- /dev/null
+++ b/samples/core/Querying/RelatedData/Tag.cs
@@ -0,0 +1,10 @@
+using System.Collections.Generic;
+
+namespace EFQuerying.RelatedData;
+
+public class Tag
+{
+    public string TagId { get; set; }
+
+    public List<PostTag> Posts { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Querying/RelatedData/Theme.cs b/samples/core/Querying/RelatedData/Theme.cs
new file mode 100644
index 0000000000..83bc8a4d83
--- /dev/null
+++ b/samples/core/Querying/RelatedData/Theme.cs
@@ -0,0 +1,9 @@
+namespace EFQuerying.RelatedData;
+
+public class Theme
+{
+    public int Id { get; set; }
+
+    public int ColorSchemeId { get; set; }
+    public ColorScheme ColorScheme { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Querying/Tags/Program.cs b/samples/core/Querying/Tags/Program.cs
new file mode 100644
index 0000000000..a376d7db13
--- /dev/null
+++ b/samples/core/Querying/Tags/Program.cs
@@ -0,0 +1,59 @@
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using NetTopologySuite.Geometries;
+
+namespace EFQuerying.Tags;
+
+internal class Program
+{
+    private static async Task Main(string[] args)
+    {
+        using (var context = new SpatialContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        using (var context = new SpatialContext())
+        {
+            #region BasicQueryTag
+            var myLocation = new Point(1, 2);
+            var nearestPeople = await (from f in context.People.TagWith("This is my spatial query!")
+                                 orderby f.Location.Distance(myLocation) descending
+                                 select f).Take(5).ToListAsync();
+            #endregion
+        }
+
+        using (var context = new SpatialContext())
+        {
+            #region ChainedQueryTags
+            var results = await Limit(GetNearestPeople(context, new Point(1, 2)), 25).ToListAsync();
+            #endregion
+        }
+
+        using (var context = new SpatialContext())
+        {
+            #region MultilineQueryTag
+            var results = await Limit(GetNearestPeople(context, new Point(1, 2)), 25).TagWith(
+                @"This is a multi-line
+string").ToListAsync();
+            #endregion
+        }
+    }
+
+    #region QueryableMethods
+    private static IQueryable<Person> GetNearestPeople(SpatialContext context, Point myLocation)
+        => from f in context.People.TagWith("GetNearestPeople")
+           orderby f.Location.Distance(myLocation) descending
+           select f;
+
+    private static IQueryable<T> Limit<T>(IQueryable<T> source, int limit) => source.TagWith("Limit").Take(limit);
+    #endregion
+}
+
+public class Person
+{
+    public int Id { get; set; }
+    public Point Location { get; set; }
+}
diff --git a/samples/core/Querying/Tags/SpatialContext.cs b/samples/core/Querying/Tags/SpatialContext.cs
new file mode 100644
index 0000000000..89b4128915
--- /dev/null
+++ b/samples/core/Querying/Tags/SpatialContext.cs
@@ -0,0 +1,30 @@
+using Microsoft.EntityFrameworkCore;
+using NetTopologySuite.Geometries;
+
+namespace EFQuerying.Tags;
+
+public class SpatialContext : DbContext
+{
+    public DbSet<Person> People { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Person>(
+            b =>
+            {
+                b.Property(e => e.Location).HasColumnType("geometry");
+
+                b.HasData(
+                    new Person { Id = 1, Location = new Point(0, 1) },
+                    new Person { Id = 2, Location = new Point(2, 1) },
+                    new Person { Id = 3, Location = new Point(4, 5) });
+            });
+    }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder.UseSqlServer(
+            @"Server=(localdb)\mssqllocaldb;Database=EFQuerying.Tags;Trusted_Connection=True;ConnectRetryCount=0",
+            b => b.UseNetTopologySuite());
+    }
+}
diff --git a/samples/core/Querying/Tags/Tags.csproj b/samples/core/Querying/Tags/Tags.csproj
new file mode 100644
index 0000000000..736919550d
--- /dev/null
+++ b/samples/core/Querying/Tags/Tags.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFQuerying.Tags</RootNamespace>
+    <AssemblyName>EFQuerying.Tags</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer.NetTopologySuite" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Querying/Tracking/Blog.cs b/samples/core/Querying/Tracking/Blog.cs
new file mode 100644
index 0000000000..c88c148136
--- /dev/null
+++ b/samples/core/Querying/Tracking/Blog.cs
@@ -0,0 +1,11 @@
+using System.Collections.Generic;
+
+namespace EFQuerying.Tracking;
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public int? Rating { get; set; }
+    public List<Post> Posts { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Querying/Tracking/BloggingContext.cs b/samples/core/Querying/Tracking/BloggingContext.cs
new file mode 100644
index 0000000000..a3234e42b7
--- /dev/null
+++ b/samples/core/Querying/Tracking/BloggingContext.cs
@@ -0,0 +1,22 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFQuerying.Tracking;
+
+public class BloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .HasData(
+                new Blog { BlogId = 1, Url = @"https://devblogs.microsoft.com/dotnet", Rating = 5 },
+                new Blog { BlogId = 2, Url = @"https://mytravelblog.com/", Rating = 4 });
+    }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFQuerying.Tracking;Trusted_Connection=True;ConnectRetryCount=0");
+    }
+}
diff --git a/samples/core/Querying/Tracking/NonTrackingBloggingContext.cs b/samples/core/Querying/Tracking/NonTrackingBloggingContext.cs
new file mode 100644
index 0000000000..2690db12e5
--- /dev/null
+++ b/samples/core/Querying/Tracking/NonTrackingBloggingContext.cs
@@ -0,0 +1,25 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFQuerying.Tracking;
+
+public class NonTrackingBloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .HasData(
+                new Blog { BlogId = 1, Url = @"https://devblogs.microsoft.com/dotnet", Rating = 5 },
+                new Blog { BlogId = 2, Url = @"https://mytravelblog.com/", Rating = 4 });
+    }
+
+    #region OnConfiguring
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder
+            .UseSqlServer(@"Server=(localdb)\mssqllocaldb;Database=EFQuerying.Tracking;Trusted_Connection=True;ConnectRetryCount=0")
+            .UseQueryTrackingBehavior(QueryTrackingBehavior.NoTracking);
+    }
+    #endregion
+}
diff --git a/samples/core/Querying/Tracking/Post.cs b/samples/core/Querying/Tracking/Post.cs
new file mode 100644
index 0000000000..a905e40068
--- /dev/null
+++ b/samples/core/Querying/Tracking/Post.cs
@@ -0,0 +1,12 @@
+namespace EFQuerying.Tracking;
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+    public int Rating { get; set; }
+
+    public int BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Querying/Tracking/Program.cs b/samples/core/Querying/Tracking/Program.cs
new file mode 100644
index 0000000000..793e77067d
--- /dev/null
+++ b/samples/core/Querying/Tracking/Program.cs
@@ -0,0 +1,116 @@
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFQuerying.Tracking;
+
+internal class Program
+{
+    private static async Task Main(string[] args)
+    {
+        using (var context = new BloggingContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        using (var context = new BloggingContext())
+        {
+            // seeding database
+            context.Blogs.Add(new Blog { Url = "http://sample.com/blog" });
+            context.Blogs.Add(new Blog { Url = "http://sample.com/another_blog" });
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region Tracking
+            var blog = await context.Blogs.SingleOrDefaultAsync(b => b.BlogId == 1);
+            blog.Rating = 5;
+            await context.SaveChangesAsync();
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region NoTracking
+            var blogs = await context.Blogs
+                .AsNoTracking()
+                .ToListAsync();
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region NoTrackingWithIdentityResolution
+            var blogs = await context.Blogs
+                .AsNoTrackingWithIdentityResolution()
+                .ToListAsync();
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region ContextDefaultTrackingBehavior
+            context.ChangeTracker.QueryTrackingBehavior = QueryTrackingBehavior.NoTracking;
+
+            var blogs = await context.Blogs.ToListAsync();
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region CustomProjection1
+            var blog = context.Blogs
+                .Select(
+                    b =>
+                        new { Blog = b, PostCount = b.Posts.Count() });
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region CustomProjection2
+            var blog = context.Blogs
+                .Select(
+                    b =>
+                        new { Blog = b, Post = b.Posts.OrderBy(p => p.Rating).LastOrDefault() });
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region CustomProjection3
+            var blog = context.Blogs
+                .Select(
+                    b =>
+                        new { Id = b.BlogId, b.Url });
+            #endregion
+        }
+
+        using (var context = new BloggingContext())
+        {
+            #region ClientProjection
+            var blogs = await context.Blogs
+                .OrderByDescending(blog => blog.Rating)
+                .Select(
+                    blog => new { Id = blog.BlogId, Url = StandardizeUrl(blog) })
+                .ToListAsync();
+            #endregion
+        }
+    }
+
+    #region ClientMethod
+    public static string StandardizeUrl(Blog blog)
+    {
+        var url = blog.Url.ToLower();
+
+        if (!url.StartsWith("http://"))
+        {
+            url = string.Concat("http://", url);
+        }
+
+        return url;
+    }
+    #endregion
+}
diff --git a/samples/core/Querying/Tracking/Tracking.csproj b/samples/core/Querying/Tracking/Tracking.csproj
new file mode 100644
index 0000000000..de693a049b
--- /dev/null
+++ b/samples/core/Querying/Tracking/Tracking.csproj
@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFQuerying.Tracking</RootNamespace>
+    <AssemblyName>EFQuerying.Tracking</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Querying/UserDefinedFunctionMapping/Model.cs b/samples/core/Querying/UserDefinedFunctionMapping/Model.cs
new file mode 100644
index 0000000000..d689449518
--- /dev/null
+++ b/samples/core/Querying/UserDefinedFunctionMapping/Model.cs
@@ -0,0 +1,214 @@
+using System;
+using System.Collections.Generic;
+using System.Data;
+using System.Linq;
+using System.Linq.Expressions;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Query.SqlExpressions;
+using Microsoft.EntityFrameworkCore.Storage;
+
+namespace EFQuerying.UserDefinedFunctionMapping;
+
+#region Entities
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public int? Rating { get; set; }
+
+    public List<Post> Posts { get; set; }
+}
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+    public int Rating { get; set; }
+    public int BlogId { get; set; }
+
+    public Blog Blog { get; set; }
+    public List<Comment> Comments { get; set; }
+}
+
+public class Comment
+{
+    public int CommentId { get; set; }
+    public string Text { get; set; }
+    public int Likes { get; set; }
+    public int PostId { get; set; }
+
+    public Post Post { get; set; }
+}
+#endregion
+
+public class BloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+    public DbSet<Comment> Comments { get; set; }
+
+    #region BasicFunctionDefinition
+    public int ActivePostCountForBlog(int blogId)
+        => throw new NotSupportedException();
+    #endregion
+
+    #region HasTranslationFunctionDefinition
+    public double PercentageDifference(double first, int second)
+        => throw new NotSupportedException();
+    #endregion
+
+    #region QueryableFunctionDefinition
+    public IQueryable<Post> PostsWithPopularComments(int likeThreshold)
+        => FromExpression(() => PostsWithPopularComments(likeThreshold));
+    #endregion
+
+    #region NullabilityPropagationFunctionDefinition
+    public string ConcatStrings(string prm1, string prm2)
+        => throw new InvalidOperationException();
+
+    public string ConcatStringsOptimized(string prm1, string prm2)
+        => throw new InvalidOperationException();
+    #endregion
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        #region EntityConfiguration
+        modelBuilder.Entity<Blog>()
+            .HasMany(b => b.Posts)
+            .WithOne(p => p.Blog);
+
+        modelBuilder.Entity<Post>()
+            .HasMany(p => p.Comments)
+            .WithOne(c => c.Post);
+        #endregion
+
+        modelBuilder.Entity<Blog>()
+            .HasData(
+                new Blog { BlogId = 1, Url = @"https://devblogs.microsoft.com/dotnet", Rating = 5 },
+                new Blog { BlogId = 2, Url = @"https://mytravelblog.com/", Rating = 4 });
+
+        modelBuilder.Entity<Post>()
+            .HasData(
+                new Post
+                {
+                    PostId = 1,
+                    BlogId = 1,
+                    Title = "What's new",
+                    Content = "Lorem ipsum dolor sit amet",
+                    Rating = 5
+                },
+                new Post
+                {
+                    PostId = 2,
+                    BlogId = 2,
+                    Title = "Around the World in Eighty Days",
+                    Content = "consectetur adipiscing elit",
+                    Rating = 5
+                },
+                new Post
+                {
+                    PostId = 3,
+                    BlogId = 2,
+                    Title = "Glamping *is* the way",
+                    Content = "sed do eiusmod tempor incididunt",
+                    Rating = 4
+                },
+                new Post
+                {
+                    PostId = 4,
+                    BlogId = 2,
+                    Title = "Travel in the time of pandemic",
+                    Content = "ut labore et dolore magna aliqua",
+                    Rating = 3
+                });
+
+        modelBuilder.Entity<Comment>()
+            .HasData(
+                new Comment { CommentId = 1, PostId = 1, Text = "Exciting!", Likes = 3 },
+                new Comment
+                {
+                    CommentId = 2,
+                    PostId = 1,
+                    Text = "Dotnet is useless - why use C# when you can write super fast assembly code instead?",
+                    Likes = 0
+                },
+                new Comment { CommentId = 3, PostId = 2, Text = "Didn't think you would make it!", Likes = 3 },
+                new Comment { CommentId = 4, PostId = 2, Text = "Are you going to try 70 days next time?", Likes = 5 },
+                new Comment { CommentId = 5, PostId = 2, Text = "Good thing the earth is round :)", Likes = 5 },
+                new Comment { CommentId = 6, PostId = 3, Text = "I couldn't agree with you more", Likes = 2 });
+
+        #region BasicFunctionConfiguration
+        modelBuilder.HasDbFunction(typeof(BloggingContext).GetMethod(nameof(ActivePostCountForBlog), [typeof(int)]))
+            .HasName("CommentedPostCountForBlog");
+        #endregion
+
+        #region HasTranslationFunctionConfiguration
+        // 100 * ABS(first - second) / ((first + second) / 2)
+        modelBuilder.HasDbFunction(
+                typeof(BloggingContext).GetMethod(nameof(PercentageDifference), [typeof(double), typeof(int)]))
+            .HasTranslation(
+                args =>
+                    new SqlBinaryExpression(
+                        ExpressionType.Multiply,
+                        new SqlConstantExpression(100, new IntTypeMapping("int", DbType.Int32)),
+                        new SqlBinaryExpression(
+                            ExpressionType.Divide,
+                            new SqlFunctionExpression(
+                                "ABS",
+                                [
+                                    new SqlBinaryExpression(
+                                        ExpressionType.Subtract,
+                                        args.First(),
+                                        args.Skip(1).First(),
+                                        args.First().Type,
+                                        args.First().TypeMapping)
+                                ],
+                                nullable: true,
+                                argumentsPropagateNullability: [true, true],
+                                type: args.First().Type,
+                                typeMapping: args.First().TypeMapping),
+                            new SqlBinaryExpression(
+                                ExpressionType.Divide,
+                                new SqlBinaryExpression(
+                                    ExpressionType.Add,
+                                    args.First(),
+                                    args.Skip(1).First(),
+                                    args.First().Type,
+                                    args.First().TypeMapping),
+                                new SqlConstantExpression(2, new IntTypeMapping("int", DbType.Int32)),
+                                args.First().Type,
+                                args.First().TypeMapping),
+                            args.First().Type,
+                            args.First().TypeMapping),
+                        args.First().Type,
+                        args.First().TypeMapping));
+        #endregion
+
+        #region NullabilityPropagationModelConfiguration
+        modelBuilder
+            .HasDbFunction(typeof(BloggingContext).GetMethod(nameof(ConcatStrings), [typeof(string), typeof(string)]))
+            .HasName("ConcatStrings");
+
+        modelBuilder.HasDbFunction(
+            typeof(BloggingContext).GetMethod(nameof(ConcatStringsOptimized), [typeof(string), typeof(string)]),
+            b =>
+            {
+                b.HasName("ConcatStrings");
+                b.HasParameter("prm1").PropagatesNullability();
+                b.HasParameter("prm2").PropagatesNullability();
+            });
+        #endregion
+
+        #region QueryableFunctionConfigurationHasDbFunction
+        modelBuilder.Entity<Post>().ToTable("Posts");
+        modelBuilder.HasDbFunction(typeof(BloggingContext).GetMethod(nameof(PostsWithPopularComments), [typeof(int)]));
+        #endregion
+    }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder.UseSqlServer(
+            @"Server=(localdb)\mssqllocaldb;Database=EFQuerying.UserDefinedFunctionMapping;Trusted_Connection=True;ConnectRetryCount=0");
+    }
+}
diff --git a/samples/core/Querying/UserDefinedFunctionMapping/Program.cs b/samples/core/Querying/UserDefinedFunctionMapping/Program.cs
new file mode 100644
index 0000000000..00ad3e3d38
--- /dev/null
+++ b/samples/core/Querying/UserDefinedFunctionMapping/Program.cs
@@ -0,0 +1,80 @@
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFQuerying.UserDefinedFunctionMapping;
+
+internal class Program
+{
+    private static async Task Main(string[] args)
+    {
+        using var context = new BloggingContext();
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+
+        await context.Database.ExecuteSqlRawAsync(
+            @"CREATE FUNCTION dbo.CommentedPostCountForBlog(@id int)
+                    RETURNS int
+                    AS
+                    BEGIN
+                        RETURN (SELECT COUNT(*)
+                            FROM [Posts] AS [p]
+                            WHERE ([p].[BlogId] = @id) AND ((
+                                SELECT COUNT(*)
+                                FROM [Comments] AS [c]
+                                WHERE [p].[PostId] = [c].[PostId]) > 0));
+                    END");
+
+        await context.Database.ExecuteSqlRawAsync(
+            @"CREATE FUNCTION [dbo].[ConcatStrings] (@prm1 nvarchar(max), @prm2 nvarchar(max))
+                    RETURNS nvarchar(max)
+                    AS
+                    BEGIN
+                        RETURN @prm1 + @prm2;
+                    END");
+
+        await context.Database.ExecuteSqlRawAsync(
+            @"CREATE FUNCTION dbo.PostsWithPopularComments(@likeThreshold int)
+                    RETURNS TABLE
+                    AS
+                    RETURN
+                    (
+                        SELECT [p].[PostId], [p].[BlogId], [p].[Content], [p].[Rating], [p].[Title]
+                        FROM [Posts] AS [p]
+                        WHERE (
+                            SELECT COUNT(*)
+                            FROM [Comments] AS [c]
+                            WHERE ([p].[PostId] = [c].[PostId]) AND ([c].[Likes] >= @likeThreshold)) > 0
+                    )");
+
+        #region BasicQuery
+        var query1 = from b in context.Blogs
+                     where context.ActivePostCountForBlog(b.BlogId) > 1
+                     select b;
+        #endregion
+        var result1 = await query1.ToListAsync();
+
+        #region HasTranslationQuery
+        var query2 = from p in context.Posts
+                     select context.PercentageDifference(p.BlogId, 3);
+        #endregion
+        var result2 = await query2.ToListAsync();
+
+        #region NullabilityPropagationExamples
+        var query3 = context.Blogs.Where(e => context.ConcatStrings(e.Url, e.Rating.ToString()) != "https://mytravelblog.com/4");
+        var query4 = context.Blogs.Where(
+            e => context.ConcatStringsOptimized(e.Url, e.Rating.ToString()) != "https://mytravelblog.com/4");
+        #endregion
+
+        var result3 = await query3.ToListAsync();
+        var result4 = await query4.ToListAsync();
+
+        #region TableValuedFunctionQuery
+        var likeThreshold = 3;
+        var query5 = from p in context.PostsWithPopularComments(likeThreshold)
+                     orderby p.Rating
+                     select p;
+        #endregion
+        var result5 = await query5.ToListAsync();
+    }
+}
diff --git a/samples/core/Querying/UserDefinedFunctionMapping/UserDefinedFunctionMapping.csproj b/samples/core/Querying/UserDefinedFunctionMapping/UserDefinedFunctionMapping.csproj
new file mode 100644
index 0000000000..949cbdfb5d
--- /dev/null
+++ b/samples/core/Querying/UserDefinedFunctionMapping/UserDefinedFunctionMapping.csproj
@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFQuerying.UserDefinedFunctionMapping</RootNamespace>
+    <AssemblyName>EFQuerying.UserDefinedFunctionMapping</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore" Version="10.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Samples.sln b/samples/core/Samples.sln
new file mode 100644
index 0000000000..1b483456a1
--- /dev/null
+++ b/samples/core/Samples.sln
@@ -0,0 +1,650 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.0.31815.197
+MinimumVisualStudioVersion = 17.0.31815.197
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Miscellaneous", "Miscellaneous", "{85AFD7F1-6943-40FE-B8EC-AA9DBB42CCA6}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Modeling", "Modeling", "{CA5046EC-C894-4535-8190-A31F75FDEB96}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Saving", "Saving\Saving.csproj", "{353F06F1-F0E0-4A8F-83AA-7115CD05832D}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Logging", "Miscellaneous\Logging\Logging\Logging.csproj", "{D3A5391D-9351-44D6-8122-2821C6E4BD62}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ConnectionResiliency", "Miscellaneous\ConnectionResiliency\ConnectionResiliency.csproj", "{73D58479-A7E6-4867-8A73-0E07E96C6117}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "DynamicModel", "Modeling\DynamicModel\DynamicModel.csproj", "{70D00673-084C-40B7-B0F1-67498593F8EE}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "DataSeeding", "Modeling\DataSeeding\DataSeeding.csproj", "{FD21B5E9-B1D9-4788-A313-5C0CDA30D1D7}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "OwnedEntities", "Modeling\OwnedEntities\OwnedEntities.csproj", "{802E31AD-2F1E-41A1-A662-5929E2626601}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "DbContextPooling", "DbContextPooling\DbContextPooling.csproj", "{EFA3A7DD-F76C-4DA9-A657-D08E78E7E397}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "TableSplitting", "Modeling\TableSplitting\TableSplitting.csproj", "{63685B9A-1233-4B44-AAC1-8DDD4B16B65D}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Cosmos", "Cosmos\Cosmos.csproj", "{35091DAC-FAE6-4384-B499-CAF2D1EA4FCF}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "EFGetStarted", "GetStarted\EFGetStarted.csproj", "{14A4E71C-57EB-4CB8-BBC3-C35CE4707E52}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SqlServer", "SqlServer\SqlServer.csproj", "{80756004-3664-481A-879F-E1A261328758}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ValueConversions", "Modeling\ValueConversions\ValueConversions.csproj", "{FE71504E-C32B-4E2F-9830-21ED448DABC4}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Collations", "Miscellaneous\Collations\Collations.csproj", "{62C86664-49F4-4C59-A2EC-1D70D85149D9}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Async", "Miscellaneous\Async\Async.csproj", "{1DA2B6AD-F71A-4224-92EB-3D0EE6E68BF4}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Spatial", "Spatial", "{B3714D90-F595-4644-8018-ADE19D66B853}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SqlServer", "Spatial\SqlServer\SqlServer.csproj", "{849357D0-85B3-4326-9D42-AD5A09E9613C}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Projections", "Spatial\Projections\Projections.csproj", "{59588FC9-0A4F-4903-84B0-A2CB2EE6F9AC}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Querying", "Querying", "{1AD64707-0BE0-48B0-A803-916FF96DCB4F}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Overview", "Querying\Overview\Overview.csproj", "{524AE4A6-A15F-466C-AED3-CDF3209E4394}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ClientEvaluation", "Querying\ClientEvaluation\ClientEvaluation.csproj", "{AF8B71E6-454F-4B66-98EE-2128B415EC45}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Tracking", "Querying\Tracking\Tracking.csproj", "{CCD901FE-20C8-4DC0-AD9C-8B8333EE277B}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ComplexQuery", "Querying\ComplexQuery\ComplexQuery.csproj", "{AD0BF60E-B46C-4181-BF43-D68801E5D259}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Tags", "Querying\Tags\Tags.csproj", "{2343A153-5832-41B9-A1FF-D80D3107A1DA}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "QueryFilters", "Querying\QueryFilters\QueryFilters.csproj", "{17A82259-1B8A-4199-A564-AC250F51360E}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "RelatedData", "Querying\RelatedData\RelatedData.csproj", "{CE9050E2-48AE-4CC4-8CCB-E19EE3102C0A}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SimpleLogging", "Miscellaneous\Logging\SimpleLogging\SimpleLogging.csproj", "{6A67BD7F-86AA-4F18-ACAF-0420482189AE}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Intro", "Intro\Intro.csproj", "{937D4D99-A6FE-459A-A5B8-A96D5D952D42}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "NullableReferenceTypes", "Miscellaneous\NullableReferenceTypes\NullableReferenceTypes.csproj", "{0F8779BE-F32A-42A9-B2D7-1974A1D9DD09}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "CommandLine", "Miscellaneous\CommandLine\CommandLine.csproj", "{EE7AF867-1BC6-4C80-8856-B4DDB975E546}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Schemas", "Schemas", "{0BFEC418-1A37-4960-8488-EA8AFB916EB9}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Migrations", "Schemas\Migrations\Migrations.csproj", "{D381F3EE-FEA4-4777-B9CA-7EE7E4C3289E}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "TwoProjectMigrations", "TwoProjectMigrations", "{A717B3B8-DB2C-40A5-8C31-1DE1FA03CF40}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "WorkerService1", "Schemas\TwoProjectMigrations\WorkerService1\WorkerService1.csproj", "{AC03251E-422C-4101-9EC8-D40A9A76AD64}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SqliteMigrations", "Schemas\TwoProjectMigrations\SqliteMigrations\SqliteMigrations.csproj", "{00A36564-7244-484A-A8C4-C56D343E255D}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SqlServerMigrations", "Schemas\TwoProjectMigrations\SqlServerMigrations\SqlServerMigrations.csproj", "{9AD894B4-B5CF-44D6-BCCB-04D35CD07790}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "ThreeProjectMigrations", "ThreeProjectMigrations", "{9EE68103-B673-4B5D-B805-02A896A683D0}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "WebApplication1.Data", "Schemas\ThreeProjectMigrations\WebApplication1.Data\WebApplication1.Data.csproj", "{7C5AFF1C-2380-4F02-93E4-517FC125AC51}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "WebApplication1.Migrations", "Schemas\ThreeProjectMigrations\WebApplication1.Migrations\WebApplication1.Migrations.csproj", "{CB2C632F-E741-481F-9BAC-3A9B4828A7CF}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "WebApplication1", "Schemas\ThreeProjectMigrations\WebApplication1\WebApplication1.csproj", "{A15F08F8-966D-4A38-A9FF-F0B3FB3335BE}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ConnectionInterception", "Miscellaneous\ConnectionInterception\ConnectionInterception.csproj", "{1CE06110-E69A-44BD-ACBE-D7F96B02288B}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SaveChangesInterception", "Miscellaneous\SaveChangesInterception\SaveChangesInterception.csproj", "{8F5C3F05-BD4B-4ED3-BCE4-45CA738C2AD3}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "CachingInterception", "Miscellaneous\CachingInterception\CachingInterception.csproj", "{DCF56A96-123F-48A6-A848-2BAE19B58C79}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "CommandInterception", "Miscellaneous\CommandInterception\CommandInterception.csproj", "{97BECA9A-A72B-4C77-ADDB-DCC84966570F}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Events", "Miscellaneous\Events\Events.csproj", "{8138D0F5-D1A7-4908-8A52-08196FF46B69}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "DiagnosticListeners", "Miscellaneous\DiagnosticListeners\DiagnosticListeners.csproj", "{AF719729-AED8-4DEB-B895-61D8EBB50A01}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ConfiguringDbContext", "Miscellaneous\ConfiguringDbContext\ConfiguringDbContext.csproj", "{73503DF2-CD85-4710-BE94-B83B87054709}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "UserDefinedFunctionMapping", "Querying\UserDefinedFunctionMapping\UserDefinedFunctionMapping.csproj", "{11AB574E-5DA9-4C37-A342-41B3DB5D7C0D}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Benchmarks", "Benchmarks\Benchmarks.csproj", "{7CC1CD44-6C02-4736-9A6D-B3F2E987CBCB}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "ChangeTracking", "ChangeTracking", "{F55D545B-2B45-47A5-8C55-39F972528400}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ChangeTrackingInEFCore", "ChangeTracking\ChangeTrackingInEFCore\ChangeTrackingInEFCore.csproj", "{81D6316C-B612-418E-9DA1-013A9D3881BF}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "AccessingTrackedEntities", "ChangeTracking\AccessingTrackedEntities\AccessingTrackedEntities.csproj", "{0EBD2D46-533A-4DEA-A37A-453908975B9D}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ChangingFKsAndNavigations", "ChangeTracking\ChangingFKsAndNavigations\ChangingFKsAndNavigations.csproj", "{45C2F9E0-76D3-4C4A-8B3F-9465393D4155}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ChangeDetectionAndNotifications", "ChangeTracking\ChangeDetectionAndNotifications\ChangeDetectionAndNotifications.csproj", "{0D3C4BCC-5F19-4864-A794-2823DAD22917}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "IdentityResolutionInEFCore", "ChangeTracking\IdentityResolutionInEFCore\IdentityResolutionInEFCore.csproj", "{6BC461D1-C015-4350-9DA8-F2468D71F718}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "AdditionalChangeTrackingFeatures", "ChangeTracking\AdditionalChangeTrackingFeatures\AdditionalChangeTrackingFeatures.csproj", "{B696F0AC-5282-4E95-9043-A177E3A9C5C0}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ChangeTrackerDebugging", "ChangeTracking\ChangeTrackerDebugging\ChangeTrackerDebugging.csproj", "{D1AB173F-582D-43C3-9EC0-20CE9FECFEB6}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "NullSemantics", "Querying\NullSemantics\NullSemantics.csproj", "{A241ED91-DE41-4310-B7CD-802F4304F27D}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "CascadeDeletes", "CascadeDeletes\CascadeDeletes.csproj", "{1F72C1AD-D6E1-4F06-B0C7-B04B57DA22B6}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "NewInEFCore6", "Miscellaneous\NewInEFCore6\NewInEFCore6.csproj", "{DADCEB89-6242-4A40-A390-0D957E02D426}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "NewInEFCore6.Cosmos", "Miscellaneous\NewInEFCore6.Cosmos\NewInEFCore6.Cosmos.csproj", "{9614B4D9-08B7-4DA1-AF92-5B640C3C4E3D}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "CompiledModels", "Miscellaneous\CompiledModels\CompiledModels.csproj", "{E6DC981D-4404-496E-972B-8DAC5D4A56F6}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "IndexesAndConstraints", "Modeling\IndexesAndConstraints\IndexesAndConstraints.csproj", "{56F8DE05-6E33-4DB0-A779-70164B200289}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "EntityTypes", "Modeling\EntityTypes\EntityTypes.csproj", "{35539488-F445-4FAC-88DF-3C3082DC5B8E}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "EntityProperties", "Modeling\EntityProperties\EntityProperties.csproj", "{3A93EF9A-A095-4BD1-89C3-95CC517B7A44}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Keys", "Modeling\Keys\Keys.csproj", "{F443CE43-F630-4C33-BE0F-3434D823C07A}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "GeneratedProperties", "Modeling\GeneratedProperties\GeneratedProperties.csproj", "{4F1C7FAF-DD6F-4749-9D7E-4FC627BC0B90}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ConcurrencyTokens", "Modeling\ConcurrencyTokens\ConcurrencyTokens.csproj", "{E4471E3B-F8F4-45BE-95E4-8CFE0E547771}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ShadowAndIndexerProperties", "Modeling\ShadowAndIndexerProperties\ShadowAndIndexerProperties.csproj", "{E842C983-21DC-4FE4-88C0-7B75E75E6653}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Relationships", "Modeling\Relationships\Relationships.csproj", "{8C7271CA-BD6C-4209-BD97-2A4781BB9152}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Inheritance", "Modeling\Inheritance\Inheritance.csproj", "{417F3A21-3429-41FC-86FA-9A9FCF166BCD}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Sequences", "Modeling\Sequences\Sequences.csproj", "{B4C32942-AB77-4674-95ED-5C0D3F85768E}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "BackingFields", "Modeling\BackingFields\BackingFields.csproj", "{4FA547E3-7A94-4951-8B1D-5A4C3FBB0798}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "KeylessEntityTypes", "Modeling\KeylessEntityTypes\KeylessEntityTypes.csproj", "{06539D34-C8D3-4868-A925-C3FCB3C7EE1E}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Misc", "Modeling\Misc\Misc.csproj", "{8A45191D-F719-4CFB-AB37-7A1653BCC720}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "BulkConfiguration", "Modeling\BulkConfiguration\BulkConfiguration.csproj", "{FE7AB616-97A5-46D4-A8B1-B2980A8C7379}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Pagination", "Querying\Pagination\Pagination.csproj", "{A7A02F2B-36E1-46A5-AF1F-E58E99E73324}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Multitenancy", "Multitenancy", "{4A49A6B4-EE6A-438A-8F15-22281AC87437}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Common", "Miscellaneous\Multitenancy\Common\Common.csproj", "{29164461-8D55-4ECA-9D07-ED48755C11A0}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "TenantControls", "Miscellaneous\Multitenancy\TenantControls\TenantControls.csproj", "{AB9DDBC6-7EDB-4302-AAEC-FC576FF6018C}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "MultiDb", "Miscellaneous\Multitenancy\MultiDb\MultiDb.csproj", "{7B73CFF8-6070-4CE5-A104-FD12FA12B029}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SingleDbSingleTable", "Miscellaneous\Multitenancy\SingleDbSingleTable\SingleDbSingleTable.csproj", "{FA1E70F4-AD39-430F-8E3C-70CFFBED45EA}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Testing", "Testing", "{06678E46-B4E2-432B-A46E-56DEEF43F6CE}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "BusinessLogic", "Testing\BusinessLogic\BusinessLogic.csproj", "{487B9A76-363D-441F-84B6-ADEDEA1F2E39}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "TestingWithTheDatabase", "Testing\TestingWithTheDatabase\TestingWithTheDatabase.csproj", "{E056C05D-9BAD-4B69-9751-5C26D76319A4}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "BloggingWebApi", "Testing\BloggingWebApi\BloggingWebApi.csproj", "{046C7454-643D-4C83-A2C7-50E060446B18}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "TestingWithoutTheDatabase", "Testing\TestingWithoutTheDatabase\TestingWithoutTheDatabase.csproj", "{937DD70A-FF53-4129-A7C5-FD5F0758591D}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Performance", "Performance", "{BA37B31C-DEAC-46C5-976C-F3FDECA236DF}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Other", "Performance\Other\Other.csproj", "{E6A055CF-9DFF-4E1D-8B04-3B33DD327AB8}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "AspNetContextPooling", "Performance\AspNetContextPooling\AspNetContextPooling.csproj", "{FD79D5B5-55CE-4564-A031-FB500D1CDBCC}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "AspNetContextPoolingWithState", "Performance\AspNetContextPoolingWithState\AspNetContextPoolingWithState.csproj", "{EA3B9FAA-AAF2-4EB6-A64D-8C06FEAD33E5}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "NewInEFCore7", "Miscellaneous\NewInEFCore7\NewInEFCore7.csproj", "{72C964FF-07C3-4234-B277-D91C3D83BAEC}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "NewInEFCore8", "Miscellaneous\NewInEFCore8\NewInEFCore8.csproj", "{F9CA30FF-70A9-4EA5-8F12-7B08A695AB8F}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "NewInEFCore9", "Miscellaneous\NewInEFCore9\NewInEFCore9.csproj", "{3F17B59C-7D33-4BF0-B386-ACFE76D45697}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "NewInEFCore9.CompiledModels", "NewInEFCore9.CompiledModels", "{26184A10-7CF8-4ED2-9F70-E00A55BE063B}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "App", "Miscellaneous\NewInEFCore9.CompiledModels\App\App.csproj", "{22548A1B-0833-49E9-A04E-A7E8690EAE03}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Model", "Miscellaneous\NewInEFCore9.CompiledModels\Model\Model.csproj", "{8E9DD759-B6D0-4424-BC6C-97ECE559CE02}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "NewInEFCore9.Cosmos", "Miscellaneous\NewInEFCore9.Cosmos\NewInEFCore9.Cosmos.csproj", "{C636065F-C124-4051-90DA-3EA2A0817471}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{353F06F1-F0E0-4A8F-83AA-7115CD05832D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{353F06F1-F0E0-4A8F-83AA-7115CD05832D}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{353F06F1-F0E0-4A8F-83AA-7115CD05832D}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{353F06F1-F0E0-4A8F-83AA-7115CD05832D}.Release|Any CPU.Build.0 = Release|Any CPU
+		{D3A5391D-9351-44D6-8122-2821C6E4BD62}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{D3A5391D-9351-44D6-8122-2821C6E4BD62}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{D3A5391D-9351-44D6-8122-2821C6E4BD62}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{D3A5391D-9351-44D6-8122-2821C6E4BD62}.Release|Any CPU.Build.0 = Release|Any CPU
+		{73D58479-A7E6-4867-8A73-0E07E96C6117}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{73D58479-A7E6-4867-8A73-0E07E96C6117}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{73D58479-A7E6-4867-8A73-0E07E96C6117}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{73D58479-A7E6-4867-8A73-0E07E96C6117}.Release|Any CPU.Build.0 = Release|Any CPU
+		{70D00673-084C-40B7-B0F1-67498593F8EE}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{70D00673-084C-40B7-B0F1-67498593F8EE}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{70D00673-084C-40B7-B0F1-67498593F8EE}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{70D00673-084C-40B7-B0F1-67498593F8EE}.Release|Any CPU.Build.0 = Release|Any CPU
+		{FD21B5E9-B1D9-4788-A313-5C0CDA30D1D7}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{FD21B5E9-B1D9-4788-A313-5C0CDA30D1D7}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{FD21B5E9-B1D9-4788-A313-5C0CDA30D1D7}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{FD21B5E9-B1D9-4788-A313-5C0CDA30D1D7}.Release|Any CPU.Build.0 = Release|Any CPU
+		{802E31AD-2F1E-41A1-A662-5929E2626601}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{802E31AD-2F1E-41A1-A662-5929E2626601}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{802E31AD-2F1E-41A1-A662-5929E2626601}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{802E31AD-2F1E-41A1-A662-5929E2626601}.Release|Any CPU.Build.0 = Release|Any CPU
+		{EFA3A7DD-F76C-4DA9-A657-D08E78E7E397}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{EFA3A7DD-F76C-4DA9-A657-D08E78E7E397}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{EFA3A7DD-F76C-4DA9-A657-D08E78E7E397}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{EFA3A7DD-F76C-4DA9-A657-D08E78E7E397}.Release|Any CPU.Build.0 = Release|Any CPU
+		{63685B9A-1233-4B44-AAC1-8DDD4B16B65D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{63685B9A-1233-4B44-AAC1-8DDD4B16B65D}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{63685B9A-1233-4B44-AAC1-8DDD4B16B65D}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{63685B9A-1233-4B44-AAC1-8DDD4B16B65D}.Release|Any CPU.Build.0 = Release|Any CPU
+		{35091DAC-FAE6-4384-B499-CAF2D1EA4FCF}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{35091DAC-FAE6-4384-B499-CAF2D1EA4FCF}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{35091DAC-FAE6-4384-B499-CAF2D1EA4FCF}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{35091DAC-FAE6-4384-B499-CAF2D1EA4FCF}.Release|Any CPU.Build.0 = Release|Any CPU
+		{14A4E71C-57EB-4CB8-BBC3-C35CE4707E52}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{14A4E71C-57EB-4CB8-BBC3-C35CE4707E52}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{14A4E71C-57EB-4CB8-BBC3-C35CE4707E52}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{14A4E71C-57EB-4CB8-BBC3-C35CE4707E52}.Release|Any CPU.Build.0 = Release|Any CPU
+		{80756004-3664-481A-879F-E1A261328758}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{80756004-3664-481A-879F-E1A261328758}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{80756004-3664-481A-879F-E1A261328758}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{80756004-3664-481A-879F-E1A261328758}.Release|Any CPU.Build.0 = Release|Any CPU
+		{FE71504E-C32B-4E2F-9830-21ED448DABC4}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{FE71504E-C32B-4E2F-9830-21ED448DABC4}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{FE71504E-C32B-4E2F-9830-21ED448DABC4}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{FE71504E-C32B-4E2F-9830-21ED448DABC4}.Release|Any CPU.Build.0 = Release|Any CPU
+		{62C86664-49F4-4C59-A2EC-1D70D85149D9}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{62C86664-49F4-4C59-A2EC-1D70D85149D9}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{62C86664-49F4-4C59-A2EC-1D70D85149D9}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{62C86664-49F4-4C59-A2EC-1D70D85149D9}.Release|Any CPU.Build.0 = Release|Any CPU
+		{1DA2B6AD-F71A-4224-92EB-3D0EE6E68BF4}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{1DA2B6AD-F71A-4224-92EB-3D0EE6E68BF4}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{1DA2B6AD-F71A-4224-92EB-3D0EE6E68BF4}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{1DA2B6AD-F71A-4224-92EB-3D0EE6E68BF4}.Release|Any CPU.Build.0 = Release|Any CPU
+		{849357D0-85B3-4326-9D42-AD5A09E9613C}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{849357D0-85B3-4326-9D42-AD5A09E9613C}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{849357D0-85B3-4326-9D42-AD5A09E9613C}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{849357D0-85B3-4326-9D42-AD5A09E9613C}.Release|Any CPU.Build.0 = Release|Any CPU
+		{59588FC9-0A4F-4903-84B0-A2CB2EE6F9AC}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{59588FC9-0A4F-4903-84B0-A2CB2EE6F9AC}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{59588FC9-0A4F-4903-84B0-A2CB2EE6F9AC}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{59588FC9-0A4F-4903-84B0-A2CB2EE6F9AC}.Release|Any CPU.Build.0 = Release|Any CPU
+		{524AE4A6-A15F-466C-AED3-CDF3209E4394}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{524AE4A6-A15F-466C-AED3-CDF3209E4394}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{524AE4A6-A15F-466C-AED3-CDF3209E4394}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{524AE4A6-A15F-466C-AED3-CDF3209E4394}.Release|Any CPU.Build.0 = Release|Any CPU
+		{AF8B71E6-454F-4B66-98EE-2128B415EC45}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{AF8B71E6-454F-4B66-98EE-2128B415EC45}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{AF8B71E6-454F-4B66-98EE-2128B415EC45}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{AF8B71E6-454F-4B66-98EE-2128B415EC45}.Release|Any CPU.Build.0 = Release|Any CPU
+		{CCD901FE-20C8-4DC0-AD9C-8B8333EE277B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{CCD901FE-20C8-4DC0-AD9C-8B8333EE277B}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{CCD901FE-20C8-4DC0-AD9C-8B8333EE277B}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{CCD901FE-20C8-4DC0-AD9C-8B8333EE277B}.Release|Any CPU.Build.0 = Release|Any CPU
+		{AD0BF60E-B46C-4181-BF43-D68801E5D259}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{AD0BF60E-B46C-4181-BF43-D68801E5D259}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{AD0BF60E-B46C-4181-BF43-D68801E5D259}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{AD0BF60E-B46C-4181-BF43-D68801E5D259}.Release|Any CPU.Build.0 = Release|Any CPU
+		{2343A153-5832-41B9-A1FF-D80D3107A1DA}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{2343A153-5832-41B9-A1FF-D80D3107A1DA}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{2343A153-5832-41B9-A1FF-D80D3107A1DA}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{2343A153-5832-41B9-A1FF-D80D3107A1DA}.Release|Any CPU.Build.0 = Release|Any CPU
+		{17A82259-1B8A-4199-A564-AC250F51360E}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{17A82259-1B8A-4199-A564-AC250F51360E}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{17A82259-1B8A-4199-A564-AC250F51360E}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{17A82259-1B8A-4199-A564-AC250F51360E}.Release|Any CPU.Build.0 = Release|Any CPU
+		{CE9050E2-48AE-4CC4-8CCB-E19EE3102C0A}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{CE9050E2-48AE-4CC4-8CCB-E19EE3102C0A}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{CE9050E2-48AE-4CC4-8CCB-E19EE3102C0A}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{CE9050E2-48AE-4CC4-8CCB-E19EE3102C0A}.Release|Any CPU.Build.0 = Release|Any CPU
+		{6A67BD7F-86AA-4F18-ACAF-0420482189AE}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{6A67BD7F-86AA-4F18-ACAF-0420482189AE}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{6A67BD7F-86AA-4F18-ACAF-0420482189AE}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{6A67BD7F-86AA-4F18-ACAF-0420482189AE}.Release|Any CPU.Build.0 = Release|Any CPU
+		{937D4D99-A6FE-459A-A5B8-A96D5D952D42}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{937D4D99-A6FE-459A-A5B8-A96D5D952D42}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{937D4D99-A6FE-459A-A5B8-A96D5D952D42}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{937D4D99-A6FE-459A-A5B8-A96D5D952D42}.Release|Any CPU.Build.0 = Release|Any CPU
+		{0F8779BE-F32A-42A9-B2D7-1974A1D9DD09}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{0F8779BE-F32A-42A9-B2D7-1974A1D9DD09}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{0F8779BE-F32A-42A9-B2D7-1974A1D9DD09}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{0F8779BE-F32A-42A9-B2D7-1974A1D9DD09}.Release|Any CPU.Build.0 = Release|Any CPU
+		{EE7AF867-1BC6-4C80-8856-B4DDB975E546}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{EE7AF867-1BC6-4C80-8856-B4DDB975E546}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{EE7AF867-1BC6-4C80-8856-B4DDB975E546}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{EE7AF867-1BC6-4C80-8856-B4DDB975E546}.Release|Any CPU.Build.0 = Release|Any CPU
+		{D381F3EE-FEA4-4777-B9CA-7EE7E4C3289E}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{D381F3EE-FEA4-4777-B9CA-7EE7E4C3289E}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{D381F3EE-FEA4-4777-B9CA-7EE7E4C3289E}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{D381F3EE-FEA4-4777-B9CA-7EE7E4C3289E}.Release|Any CPU.Build.0 = Release|Any CPU
+		{AC03251E-422C-4101-9EC8-D40A9A76AD64}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{AC03251E-422C-4101-9EC8-D40A9A76AD64}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{AC03251E-422C-4101-9EC8-D40A9A76AD64}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{AC03251E-422C-4101-9EC8-D40A9A76AD64}.Release|Any CPU.Build.0 = Release|Any CPU
+		{00A36564-7244-484A-A8C4-C56D343E255D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{00A36564-7244-484A-A8C4-C56D343E255D}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{00A36564-7244-484A-A8C4-C56D343E255D}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{00A36564-7244-484A-A8C4-C56D343E255D}.Release|Any CPU.Build.0 = Release|Any CPU
+		{9AD894B4-B5CF-44D6-BCCB-04D35CD07790}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{9AD894B4-B5CF-44D6-BCCB-04D35CD07790}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{9AD894B4-B5CF-44D6-BCCB-04D35CD07790}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{9AD894B4-B5CF-44D6-BCCB-04D35CD07790}.Release|Any CPU.Build.0 = Release|Any CPU
+		{7C5AFF1C-2380-4F02-93E4-517FC125AC51}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{7C5AFF1C-2380-4F02-93E4-517FC125AC51}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{7C5AFF1C-2380-4F02-93E4-517FC125AC51}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{7C5AFF1C-2380-4F02-93E4-517FC125AC51}.Release|Any CPU.Build.0 = Release|Any CPU
+		{CB2C632F-E741-481F-9BAC-3A9B4828A7CF}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{CB2C632F-E741-481F-9BAC-3A9B4828A7CF}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{CB2C632F-E741-481F-9BAC-3A9B4828A7CF}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{CB2C632F-E741-481F-9BAC-3A9B4828A7CF}.Release|Any CPU.Build.0 = Release|Any CPU
+		{A15F08F8-966D-4A38-A9FF-F0B3FB3335BE}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{A15F08F8-966D-4A38-A9FF-F0B3FB3335BE}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{A15F08F8-966D-4A38-A9FF-F0B3FB3335BE}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{A15F08F8-966D-4A38-A9FF-F0B3FB3335BE}.Release|Any CPU.Build.0 = Release|Any CPU
+		{1CE06110-E69A-44BD-ACBE-D7F96B02288B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{1CE06110-E69A-44BD-ACBE-D7F96B02288B}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{1CE06110-E69A-44BD-ACBE-D7F96B02288B}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{1CE06110-E69A-44BD-ACBE-D7F96B02288B}.Release|Any CPU.Build.0 = Release|Any CPU
+		{8F5C3F05-BD4B-4ED3-BCE4-45CA738C2AD3}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{8F5C3F05-BD4B-4ED3-BCE4-45CA738C2AD3}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{8F5C3F05-BD4B-4ED3-BCE4-45CA738C2AD3}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{8F5C3F05-BD4B-4ED3-BCE4-45CA738C2AD3}.Release|Any CPU.Build.0 = Release|Any CPU
+		{DCF56A96-123F-48A6-A848-2BAE19B58C79}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{DCF56A96-123F-48A6-A848-2BAE19B58C79}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{DCF56A96-123F-48A6-A848-2BAE19B58C79}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{DCF56A96-123F-48A6-A848-2BAE19B58C79}.Release|Any CPU.Build.0 = Release|Any CPU
+		{97BECA9A-A72B-4C77-ADDB-DCC84966570F}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{97BECA9A-A72B-4C77-ADDB-DCC84966570F}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{97BECA9A-A72B-4C77-ADDB-DCC84966570F}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{97BECA9A-A72B-4C77-ADDB-DCC84966570F}.Release|Any CPU.Build.0 = Release|Any CPU
+		{8138D0F5-D1A7-4908-8A52-08196FF46B69}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{8138D0F5-D1A7-4908-8A52-08196FF46B69}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{8138D0F5-D1A7-4908-8A52-08196FF46B69}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{8138D0F5-D1A7-4908-8A52-08196FF46B69}.Release|Any CPU.Build.0 = Release|Any CPU
+		{AF719729-AED8-4DEB-B895-61D8EBB50A01}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{AF719729-AED8-4DEB-B895-61D8EBB50A01}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{AF719729-AED8-4DEB-B895-61D8EBB50A01}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{AF719729-AED8-4DEB-B895-61D8EBB50A01}.Release|Any CPU.Build.0 = Release|Any CPU
+		{73503DF2-CD85-4710-BE94-B83B87054709}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{73503DF2-CD85-4710-BE94-B83B87054709}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{73503DF2-CD85-4710-BE94-B83B87054709}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{73503DF2-CD85-4710-BE94-B83B87054709}.Release|Any CPU.Build.0 = Release|Any CPU
+		{11AB574E-5DA9-4C37-A342-41B3DB5D7C0D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{11AB574E-5DA9-4C37-A342-41B3DB5D7C0D}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{11AB574E-5DA9-4C37-A342-41B3DB5D7C0D}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{11AB574E-5DA9-4C37-A342-41B3DB5D7C0D}.Release|Any CPU.Build.0 = Release|Any CPU
+		{7CC1CD44-6C02-4736-9A6D-B3F2E987CBCB}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{7CC1CD44-6C02-4736-9A6D-B3F2E987CBCB}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{7CC1CD44-6C02-4736-9A6D-B3F2E987CBCB}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{7CC1CD44-6C02-4736-9A6D-B3F2E987CBCB}.Release|Any CPU.Build.0 = Release|Any CPU
+		{81D6316C-B612-418E-9DA1-013A9D3881BF}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{81D6316C-B612-418E-9DA1-013A9D3881BF}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{81D6316C-B612-418E-9DA1-013A9D3881BF}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{81D6316C-B612-418E-9DA1-013A9D3881BF}.Release|Any CPU.Build.0 = Release|Any CPU
+		{0EBD2D46-533A-4DEA-A37A-453908975B9D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{0EBD2D46-533A-4DEA-A37A-453908975B9D}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{0EBD2D46-533A-4DEA-A37A-453908975B9D}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{0EBD2D46-533A-4DEA-A37A-453908975B9D}.Release|Any CPU.Build.0 = Release|Any CPU
+		{45C2F9E0-76D3-4C4A-8B3F-9465393D4155}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{45C2F9E0-76D3-4C4A-8B3F-9465393D4155}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{45C2F9E0-76D3-4C4A-8B3F-9465393D4155}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{45C2F9E0-76D3-4C4A-8B3F-9465393D4155}.Release|Any CPU.Build.0 = Release|Any CPU
+		{0D3C4BCC-5F19-4864-A794-2823DAD22917}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{0D3C4BCC-5F19-4864-A794-2823DAD22917}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{0D3C4BCC-5F19-4864-A794-2823DAD22917}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{0D3C4BCC-5F19-4864-A794-2823DAD22917}.Release|Any CPU.Build.0 = Release|Any CPU
+		{6BC461D1-C015-4350-9DA8-F2468D71F718}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{6BC461D1-C015-4350-9DA8-F2468D71F718}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{6BC461D1-C015-4350-9DA8-F2468D71F718}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{6BC461D1-C015-4350-9DA8-F2468D71F718}.Release|Any CPU.Build.0 = Release|Any CPU
+		{B696F0AC-5282-4E95-9043-A177E3A9C5C0}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{B696F0AC-5282-4E95-9043-A177E3A9C5C0}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{B696F0AC-5282-4E95-9043-A177E3A9C5C0}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{B696F0AC-5282-4E95-9043-A177E3A9C5C0}.Release|Any CPU.Build.0 = Release|Any CPU
+		{D1AB173F-582D-43C3-9EC0-20CE9FECFEB6}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{D1AB173F-582D-43C3-9EC0-20CE9FECFEB6}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{D1AB173F-582D-43C3-9EC0-20CE9FECFEB6}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{D1AB173F-582D-43C3-9EC0-20CE9FECFEB6}.Release|Any CPU.Build.0 = Release|Any CPU
+		{A241ED91-DE41-4310-B7CD-802F4304F27D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{A241ED91-DE41-4310-B7CD-802F4304F27D}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{A241ED91-DE41-4310-B7CD-802F4304F27D}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{A241ED91-DE41-4310-B7CD-802F4304F27D}.Release|Any CPU.Build.0 = Release|Any CPU
+		{1F72C1AD-D6E1-4F06-B0C7-B04B57DA22B6}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{1F72C1AD-D6E1-4F06-B0C7-B04B57DA22B6}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{1F72C1AD-D6E1-4F06-B0C7-B04B57DA22B6}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{1F72C1AD-D6E1-4F06-B0C7-B04B57DA22B6}.Release|Any CPU.Build.0 = Release|Any CPU
+		{DADCEB89-6242-4A40-A390-0D957E02D426}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{DADCEB89-6242-4A40-A390-0D957E02D426}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{DADCEB89-6242-4A40-A390-0D957E02D426}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{DADCEB89-6242-4A40-A390-0D957E02D426}.Release|Any CPU.Build.0 = Release|Any CPU
+		{9614B4D9-08B7-4DA1-AF92-5B640C3C4E3D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{9614B4D9-08B7-4DA1-AF92-5B640C3C4E3D}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{9614B4D9-08B7-4DA1-AF92-5B640C3C4E3D}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{9614B4D9-08B7-4DA1-AF92-5B640C3C4E3D}.Release|Any CPU.Build.0 = Release|Any CPU
+		{E6DC981D-4404-496E-972B-8DAC5D4A56F6}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{E6DC981D-4404-496E-972B-8DAC5D4A56F6}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{E6DC981D-4404-496E-972B-8DAC5D4A56F6}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{E6DC981D-4404-496E-972B-8DAC5D4A56F6}.Release|Any CPU.Build.0 = Release|Any CPU
+		{56F8DE05-6E33-4DB0-A779-70164B200289}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{56F8DE05-6E33-4DB0-A779-70164B200289}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{56F8DE05-6E33-4DB0-A779-70164B200289}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{56F8DE05-6E33-4DB0-A779-70164B200289}.Release|Any CPU.Build.0 = Release|Any CPU
+		{35539488-F445-4FAC-88DF-3C3082DC5B8E}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{35539488-F445-4FAC-88DF-3C3082DC5B8E}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{35539488-F445-4FAC-88DF-3C3082DC5B8E}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{35539488-F445-4FAC-88DF-3C3082DC5B8E}.Release|Any CPU.Build.0 = Release|Any CPU
+		{3A93EF9A-A095-4BD1-89C3-95CC517B7A44}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{3A93EF9A-A095-4BD1-89C3-95CC517B7A44}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{3A93EF9A-A095-4BD1-89C3-95CC517B7A44}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{3A93EF9A-A095-4BD1-89C3-95CC517B7A44}.Release|Any CPU.Build.0 = Release|Any CPU
+		{F443CE43-F630-4C33-BE0F-3434D823C07A}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{F443CE43-F630-4C33-BE0F-3434D823C07A}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{F443CE43-F630-4C33-BE0F-3434D823C07A}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{F443CE43-F630-4C33-BE0F-3434D823C07A}.Release|Any CPU.Build.0 = Release|Any CPU
+		{4F1C7FAF-DD6F-4749-9D7E-4FC627BC0B90}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{4F1C7FAF-DD6F-4749-9D7E-4FC627BC0B90}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{4F1C7FAF-DD6F-4749-9D7E-4FC627BC0B90}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{4F1C7FAF-DD6F-4749-9D7E-4FC627BC0B90}.Release|Any CPU.Build.0 = Release|Any CPU
+		{E4471E3B-F8F4-45BE-95E4-8CFE0E547771}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{E4471E3B-F8F4-45BE-95E4-8CFE0E547771}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{E4471E3B-F8F4-45BE-95E4-8CFE0E547771}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{E4471E3B-F8F4-45BE-95E4-8CFE0E547771}.Release|Any CPU.Build.0 = Release|Any CPU
+		{E842C983-21DC-4FE4-88C0-7B75E75E6653}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{E842C983-21DC-4FE4-88C0-7B75E75E6653}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{E842C983-21DC-4FE4-88C0-7B75E75E6653}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{E842C983-21DC-4FE4-88C0-7B75E75E6653}.Release|Any CPU.Build.0 = Release|Any CPU
+		{8C7271CA-BD6C-4209-BD97-2A4781BB9152}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{8C7271CA-BD6C-4209-BD97-2A4781BB9152}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{8C7271CA-BD6C-4209-BD97-2A4781BB9152}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{8C7271CA-BD6C-4209-BD97-2A4781BB9152}.Release|Any CPU.Build.0 = Release|Any CPU
+		{417F3A21-3429-41FC-86FA-9A9FCF166BCD}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{417F3A21-3429-41FC-86FA-9A9FCF166BCD}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{417F3A21-3429-41FC-86FA-9A9FCF166BCD}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{417F3A21-3429-41FC-86FA-9A9FCF166BCD}.Release|Any CPU.Build.0 = Release|Any CPU
+		{B4C32942-AB77-4674-95ED-5C0D3F85768E}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{B4C32942-AB77-4674-95ED-5C0D3F85768E}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{B4C32942-AB77-4674-95ED-5C0D3F85768E}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{B4C32942-AB77-4674-95ED-5C0D3F85768E}.Release|Any CPU.Build.0 = Release|Any CPU
+		{4FA547E3-7A94-4951-8B1D-5A4C3FBB0798}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{4FA547E3-7A94-4951-8B1D-5A4C3FBB0798}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{4FA547E3-7A94-4951-8B1D-5A4C3FBB0798}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{4FA547E3-7A94-4951-8B1D-5A4C3FBB0798}.Release|Any CPU.Build.0 = Release|Any CPU
+		{06539D34-C8D3-4868-A925-C3FCB3C7EE1E}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{06539D34-C8D3-4868-A925-C3FCB3C7EE1E}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{06539D34-C8D3-4868-A925-C3FCB3C7EE1E}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{06539D34-C8D3-4868-A925-C3FCB3C7EE1E}.Release|Any CPU.Build.0 = Release|Any CPU
+		{8A45191D-F719-4CFB-AB37-7A1653BCC720}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{8A45191D-F719-4CFB-AB37-7A1653BCC720}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{8A45191D-F719-4CFB-AB37-7A1653BCC720}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{8A45191D-F719-4CFB-AB37-7A1653BCC720}.Release|Any CPU.Build.0 = Release|Any CPU
+		{FE7AB616-97A5-46D4-A8B1-B2980A8C7379}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{FE7AB616-97A5-46D4-A8B1-B2980A8C7379}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{FE7AB616-97A5-46D4-A8B1-B2980A8C7379}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{FE7AB616-97A5-46D4-A8B1-B2980A8C7379}.Release|Any CPU.Build.0 = Release|Any CPU
+		{A7A02F2B-36E1-46A5-AF1F-E58E99E73324}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{A7A02F2B-36E1-46A5-AF1F-E58E99E73324}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{A7A02F2B-36E1-46A5-AF1F-E58E99E73324}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{A7A02F2B-36E1-46A5-AF1F-E58E99E73324}.Release|Any CPU.Build.0 = Release|Any CPU
+		{29164461-8D55-4ECA-9D07-ED48755C11A0}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{29164461-8D55-4ECA-9D07-ED48755C11A0}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{29164461-8D55-4ECA-9D07-ED48755C11A0}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{29164461-8D55-4ECA-9D07-ED48755C11A0}.Release|Any CPU.Build.0 = Release|Any CPU
+		{AB9DDBC6-7EDB-4302-AAEC-FC576FF6018C}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{AB9DDBC6-7EDB-4302-AAEC-FC576FF6018C}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{AB9DDBC6-7EDB-4302-AAEC-FC576FF6018C}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{AB9DDBC6-7EDB-4302-AAEC-FC576FF6018C}.Release|Any CPU.Build.0 = Release|Any CPU
+		{7B73CFF8-6070-4CE5-A104-FD12FA12B029}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{7B73CFF8-6070-4CE5-A104-FD12FA12B029}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{7B73CFF8-6070-4CE5-A104-FD12FA12B029}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{7B73CFF8-6070-4CE5-A104-FD12FA12B029}.Release|Any CPU.Build.0 = Release|Any CPU
+		{FA1E70F4-AD39-430F-8E3C-70CFFBED45EA}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{FA1E70F4-AD39-430F-8E3C-70CFFBED45EA}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{FA1E70F4-AD39-430F-8E3C-70CFFBED45EA}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{FA1E70F4-AD39-430F-8E3C-70CFFBED45EA}.Release|Any CPU.Build.0 = Release|Any CPU
+		{487B9A76-363D-441F-84B6-ADEDEA1F2E39}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{487B9A76-363D-441F-84B6-ADEDEA1F2E39}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{487B9A76-363D-441F-84B6-ADEDEA1F2E39}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{487B9A76-363D-441F-84B6-ADEDEA1F2E39}.Release|Any CPU.Build.0 = Release|Any CPU
+		{E056C05D-9BAD-4B69-9751-5C26D76319A4}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{E056C05D-9BAD-4B69-9751-5C26D76319A4}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{E056C05D-9BAD-4B69-9751-5C26D76319A4}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{E056C05D-9BAD-4B69-9751-5C26D76319A4}.Release|Any CPU.Build.0 = Release|Any CPU
+		{046C7454-643D-4C83-A2C7-50E060446B18}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{046C7454-643D-4C83-A2C7-50E060446B18}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{046C7454-643D-4C83-A2C7-50E060446B18}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{046C7454-643D-4C83-A2C7-50E060446B18}.Release|Any CPU.Build.0 = Release|Any CPU
+		{937DD70A-FF53-4129-A7C5-FD5F0758591D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{937DD70A-FF53-4129-A7C5-FD5F0758591D}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{937DD70A-FF53-4129-A7C5-FD5F0758591D}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{937DD70A-FF53-4129-A7C5-FD5F0758591D}.Release|Any CPU.Build.0 = Release|Any CPU
+		{E6A055CF-9DFF-4E1D-8B04-3B33DD327AB8}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{E6A055CF-9DFF-4E1D-8B04-3B33DD327AB8}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{E6A055CF-9DFF-4E1D-8B04-3B33DD327AB8}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{E6A055CF-9DFF-4E1D-8B04-3B33DD327AB8}.Release|Any CPU.Build.0 = Release|Any CPU
+		{FD79D5B5-55CE-4564-A031-FB500D1CDBCC}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{FD79D5B5-55CE-4564-A031-FB500D1CDBCC}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{FD79D5B5-55CE-4564-A031-FB500D1CDBCC}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{FD79D5B5-55CE-4564-A031-FB500D1CDBCC}.Release|Any CPU.Build.0 = Release|Any CPU
+		{EA3B9FAA-AAF2-4EB6-A64D-8C06FEAD33E5}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{EA3B9FAA-AAF2-4EB6-A64D-8C06FEAD33E5}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{EA3B9FAA-AAF2-4EB6-A64D-8C06FEAD33E5}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{EA3B9FAA-AAF2-4EB6-A64D-8C06FEAD33E5}.Release|Any CPU.Build.0 = Release|Any CPU
+		{72C964FF-07C3-4234-B277-D91C3D83BAEC}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{72C964FF-07C3-4234-B277-D91C3D83BAEC}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{72C964FF-07C3-4234-B277-D91C3D83BAEC}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{72C964FF-07C3-4234-B277-D91C3D83BAEC}.Release|Any CPU.Build.0 = Release|Any CPU
+		{F9CA30FF-70A9-4EA5-8F12-7B08A695AB8F}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{F9CA30FF-70A9-4EA5-8F12-7B08A695AB8F}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{F9CA30FF-70A9-4EA5-8F12-7B08A695AB8F}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{F9CA30FF-70A9-4EA5-8F12-7B08A695AB8F}.Release|Any CPU.Build.0 = Release|Any CPU
+		{3F17B59C-7D33-4BF0-B386-ACFE76D45697}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{3F17B59C-7D33-4BF0-B386-ACFE76D45697}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{3F17B59C-7D33-4BF0-B386-ACFE76D45697}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{3F17B59C-7D33-4BF0-B386-ACFE76D45697}.Release|Any CPU.Build.0 = Release|Any CPU
+		{22548A1B-0833-49E9-A04E-A7E8690EAE03}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{22548A1B-0833-49E9-A04E-A7E8690EAE03}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{22548A1B-0833-49E9-A04E-A7E8690EAE03}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{22548A1B-0833-49E9-A04E-A7E8690EAE03}.Release|Any CPU.Build.0 = Release|Any CPU
+		{8E9DD759-B6D0-4424-BC6C-97ECE559CE02}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{8E9DD759-B6D0-4424-BC6C-97ECE559CE02}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{8E9DD759-B6D0-4424-BC6C-97ECE559CE02}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{8E9DD759-B6D0-4424-BC6C-97ECE559CE02}.Release|Any CPU.Build.0 = Release|Any CPU
+		{C636065F-C124-4051-90DA-3EA2A0817471}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{C636065F-C124-4051-90DA-3EA2A0817471}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{C636065F-C124-4051-90DA-3EA2A0817471}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{C636065F-C124-4051-90DA-3EA2A0817471}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(NestedProjects) = preSolution
+		{D3A5391D-9351-44D6-8122-2821C6E4BD62} = {85AFD7F1-6943-40FE-B8EC-AA9DBB42CCA6}
+		{73D58479-A7E6-4867-8A73-0E07E96C6117} = {85AFD7F1-6943-40FE-B8EC-AA9DBB42CCA6}
+		{70D00673-084C-40B7-B0F1-67498593F8EE} = {CA5046EC-C894-4535-8190-A31F75FDEB96}
+		{FD21B5E9-B1D9-4788-A313-5C0CDA30D1D7} = {CA5046EC-C894-4535-8190-A31F75FDEB96}
+		{802E31AD-2F1E-41A1-A662-5929E2626601} = {CA5046EC-C894-4535-8190-A31F75FDEB96}
+		{63685B9A-1233-4B44-AAC1-8DDD4B16B65D} = {CA5046EC-C894-4535-8190-A31F75FDEB96}
+		{FE71504E-C32B-4E2F-9830-21ED448DABC4} = {CA5046EC-C894-4535-8190-A31F75FDEB96}
+		{62C86664-49F4-4C59-A2EC-1D70D85149D9} = {85AFD7F1-6943-40FE-B8EC-AA9DBB42CCA6}
+		{1DA2B6AD-F71A-4224-92EB-3D0EE6E68BF4} = {85AFD7F1-6943-40FE-B8EC-AA9DBB42CCA6}
+		{849357D0-85B3-4326-9D42-AD5A09E9613C} = {B3714D90-F595-4644-8018-ADE19D66B853}
+		{59588FC9-0A4F-4903-84B0-A2CB2EE6F9AC} = {B3714D90-F595-4644-8018-ADE19D66B853}
+		{524AE4A6-A15F-466C-AED3-CDF3209E4394} = {1AD64707-0BE0-48B0-A803-916FF96DCB4F}
+		{AF8B71E6-454F-4B66-98EE-2128B415EC45} = {1AD64707-0BE0-48B0-A803-916FF96DCB4F}
+		{CCD901FE-20C8-4DC0-AD9C-8B8333EE277B} = {1AD64707-0BE0-48B0-A803-916FF96DCB4F}
+		{AD0BF60E-B46C-4181-BF43-D68801E5D259} = {1AD64707-0BE0-48B0-A803-916FF96DCB4F}
+		{2343A153-5832-41B9-A1FF-D80D3107A1DA} = {1AD64707-0BE0-48B0-A803-916FF96DCB4F}
+		{17A82259-1B8A-4199-A564-AC250F51360E} = {1AD64707-0BE0-48B0-A803-916FF96DCB4F}
+		{CE9050E2-48AE-4CC4-8CCB-E19EE3102C0A} = {1AD64707-0BE0-48B0-A803-916FF96DCB4F}
+		{6A67BD7F-86AA-4F18-ACAF-0420482189AE} = {85AFD7F1-6943-40FE-B8EC-AA9DBB42CCA6}
+		{0F8779BE-F32A-42A9-B2D7-1974A1D9DD09} = {85AFD7F1-6943-40FE-B8EC-AA9DBB42CCA6}
+		{EE7AF867-1BC6-4C80-8856-B4DDB975E546} = {85AFD7F1-6943-40FE-B8EC-AA9DBB42CCA6}
+		{D381F3EE-FEA4-4777-B9CA-7EE7E4C3289E} = {0BFEC418-1A37-4960-8488-EA8AFB916EB9}
+		{A717B3B8-DB2C-40A5-8C31-1DE1FA03CF40} = {0BFEC418-1A37-4960-8488-EA8AFB916EB9}
+		{AC03251E-422C-4101-9EC8-D40A9A76AD64} = {A717B3B8-DB2C-40A5-8C31-1DE1FA03CF40}
+		{00A36564-7244-484A-A8C4-C56D343E255D} = {A717B3B8-DB2C-40A5-8C31-1DE1FA03CF40}
+		{9AD894B4-B5CF-44D6-BCCB-04D35CD07790} = {A717B3B8-DB2C-40A5-8C31-1DE1FA03CF40}
+		{9EE68103-B673-4B5D-B805-02A896A683D0} = {0BFEC418-1A37-4960-8488-EA8AFB916EB9}
+		{7C5AFF1C-2380-4F02-93E4-517FC125AC51} = {9EE68103-B673-4B5D-B805-02A896A683D0}
+		{CB2C632F-E741-481F-9BAC-3A9B4828A7CF} = {9EE68103-B673-4B5D-B805-02A896A683D0}
+		{A15F08F8-966D-4A38-A9FF-F0B3FB3335BE} = {9EE68103-B673-4B5D-B805-02A896A683D0}
+		{1CE06110-E69A-44BD-ACBE-D7F96B02288B} = {85AFD7F1-6943-40FE-B8EC-AA9DBB42CCA6}
+		{8F5C3F05-BD4B-4ED3-BCE4-45CA738C2AD3} = {85AFD7F1-6943-40FE-B8EC-AA9DBB42CCA6}
+		{DCF56A96-123F-48A6-A848-2BAE19B58C79} = {85AFD7F1-6943-40FE-B8EC-AA9DBB42CCA6}
+		{97BECA9A-A72B-4C77-ADDB-DCC84966570F} = {85AFD7F1-6943-40FE-B8EC-AA9DBB42CCA6}
+		{8138D0F5-D1A7-4908-8A52-08196FF46B69} = {85AFD7F1-6943-40FE-B8EC-AA9DBB42CCA6}
+		{AF719729-AED8-4DEB-B895-61D8EBB50A01} = {85AFD7F1-6943-40FE-B8EC-AA9DBB42CCA6}
+		{73503DF2-CD85-4710-BE94-B83B87054709} = {85AFD7F1-6943-40FE-B8EC-AA9DBB42CCA6}
+		{11AB574E-5DA9-4C37-A342-41B3DB5D7C0D} = {1AD64707-0BE0-48B0-A803-916FF96DCB4F}
+		{81D6316C-B612-418E-9DA1-013A9D3881BF} = {F55D545B-2B45-47A5-8C55-39F972528400}
+		{0EBD2D46-533A-4DEA-A37A-453908975B9D} = {F55D545B-2B45-47A5-8C55-39F972528400}
+		{45C2F9E0-76D3-4C4A-8B3F-9465393D4155} = {F55D545B-2B45-47A5-8C55-39F972528400}
+		{0D3C4BCC-5F19-4864-A794-2823DAD22917} = {F55D545B-2B45-47A5-8C55-39F972528400}
+		{6BC461D1-C015-4350-9DA8-F2468D71F718} = {F55D545B-2B45-47A5-8C55-39F972528400}
+		{B696F0AC-5282-4E95-9043-A177E3A9C5C0} = {F55D545B-2B45-47A5-8C55-39F972528400}
+		{D1AB173F-582D-43C3-9EC0-20CE9FECFEB6} = {F55D545B-2B45-47A5-8C55-39F972528400}
+		{A241ED91-DE41-4310-B7CD-802F4304F27D} = {1AD64707-0BE0-48B0-A803-916FF96DCB4F}
+		{DADCEB89-6242-4A40-A390-0D957E02D426} = {85AFD7F1-6943-40FE-B8EC-AA9DBB42CCA6}
+		{9614B4D9-08B7-4DA1-AF92-5B640C3C4E3D} = {85AFD7F1-6943-40FE-B8EC-AA9DBB42CCA6}
+		{E6DC981D-4404-496E-972B-8DAC5D4A56F6} = {85AFD7F1-6943-40FE-B8EC-AA9DBB42CCA6}
+		{56F8DE05-6E33-4DB0-A779-70164B200289} = {CA5046EC-C894-4535-8190-A31F75FDEB96}
+		{35539488-F445-4FAC-88DF-3C3082DC5B8E} = {CA5046EC-C894-4535-8190-A31F75FDEB96}
+		{3A93EF9A-A095-4BD1-89C3-95CC517B7A44} = {CA5046EC-C894-4535-8190-A31F75FDEB96}
+		{F443CE43-F630-4C33-BE0F-3434D823C07A} = {CA5046EC-C894-4535-8190-A31F75FDEB96}
+		{4F1C7FAF-DD6F-4749-9D7E-4FC627BC0B90} = {CA5046EC-C894-4535-8190-A31F75FDEB96}
+		{E4471E3B-F8F4-45BE-95E4-8CFE0E547771} = {CA5046EC-C894-4535-8190-A31F75FDEB96}
+		{E842C983-21DC-4FE4-88C0-7B75E75E6653} = {CA5046EC-C894-4535-8190-A31F75FDEB96}
+		{8C7271CA-BD6C-4209-BD97-2A4781BB9152} = {CA5046EC-C894-4535-8190-A31F75FDEB96}
+		{417F3A21-3429-41FC-86FA-9A9FCF166BCD} = {CA5046EC-C894-4535-8190-A31F75FDEB96}
+		{B4C32942-AB77-4674-95ED-5C0D3F85768E} = {CA5046EC-C894-4535-8190-A31F75FDEB96}
+		{4FA547E3-7A94-4951-8B1D-5A4C3FBB0798} = {CA5046EC-C894-4535-8190-A31F75FDEB96}
+		{06539D34-C8D3-4868-A925-C3FCB3C7EE1E} = {CA5046EC-C894-4535-8190-A31F75FDEB96}
+		{8A45191D-F719-4CFB-AB37-7A1653BCC720} = {CA5046EC-C894-4535-8190-A31F75FDEB96}
+		{FE7AB616-97A5-46D4-A8B1-B2980A8C7379} = {CA5046EC-C894-4535-8190-A31F75FDEB96}
+		{A7A02F2B-36E1-46A5-AF1F-E58E99E73324} = {1AD64707-0BE0-48B0-A803-916FF96DCB4F}
+		{4A49A6B4-EE6A-438A-8F15-22281AC87437} = {85AFD7F1-6943-40FE-B8EC-AA9DBB42CCA6}
+		{29164461-8D55-4ECA-9D07-ED48755C11A0} = {4A49A6B4-EE6A-438A-8F15-22281AC87437}
+		{AB9DDBC6-7EDB-4302-AAEC-FC576FF6018C} = {4A49A6B4-EE6A-438A-8F15-22281AC87437}
+		{7B73CFF8-6070-4CE5-A104-FD12FA12B029} = {4A49A6B4-EE6A-438A-8F15-22281AC87437}
+		{FA1E70F4-AD39-430F-8E3C-70CFFBED45EA} = {4A49A6B4-EE6A-438A-8F15-22281AC87437}
+		{487B9A76-363D-441F-84B6-ADEDEA1F2E39} = {06678E46-B4E2-432B-A46E-56DEEF43F6CE}
+		{E056C05D-9BAD-4B69-9751-5C26D76319A4} = {06678E46-B4E2-432B-A46E-56DEEF43F6CE}
+		{046C7454-643D-4C83-A2C7-50E060446B18} = {06678E46-B4E2-432B-A46E-56DEEF43F6CE}
+		{937DD70A-FF53-4129-A7C5-FD5F0758591D} = {06678E46-B4E2-432B-A46E-56DEEF43F6CE}
+		{E6A055CF-9DFF-4E1D-8B04-3B33DD327AB8} = {BA37B31C-DEAC-46C5-976C-F3FDECA236DF}
+		{FD79D5B5-55CE-4564-A031-FB500D1CDBCC} = {BA37B31C-DEAC-46C5-976C-F3FDECA236DF}
+		{EA3B9FAA-AAF2-4EB6-A64D-8C06FEAD33E5} = {BA37B31C-DEAC-46C5-976C-F3FDECA236DF}
+		{72C964FF-07C3-4234-B277-D91C3D83BAEC} = {85AFD7F1-6943-40FE-B8EC-AA9DBB42CCA6}
+		{F9CA30FF-70A9-4EA5-8F12-7B08A695AB8F} = {85AFD7F1-6943-40FE-B8EC-AA9DBB42CCA6}
+		{3F17B59C-7D33-4BF0-B386-ACFE76D45697} = {85AFD7F1-6943-40FE-B8EC-AA9DBB42CCA6}
+		{26184A10-7CF8-4ED2-9F70-E00A55BE063B} = {85AFD7F1-6943-40FE-B8EC-AA9DBB42CCA6}
+		{22548A1B-0833-49E9-A04E-A7E8690EAE03} = {26184A10-7CF8-4ED2-9F70-E00A55BE063B}
+		{8E9DD759-B6D0-4424-BC6C-97ECE559CE02} = {26184A10-7CF8-4ED2-9F70-E00A55BE063B}
+		{C636065F-C124-4051-90DA-3EA2A0817471} = {85AFD7F1-6943-40FE-B8EC-AA9DBB42CCA6}
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {20C98D35-54EF-46A6-8F3B-1855C1AE4F70}
+	EndGlobalSection
+EndGlobal
diff --git a/samples/core/Samples.sln.DotSettings b/samples/core/Samples.sln.DotSettings
new file mode 100644
index 0000000000..8da6af6279
--- /dev/null
+++ b/samples/core/Samples.sln.DotSettings
@@ -0,0 +1,143 @@
+<wpf:ResourceDictionary xml:space="preserve" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:s="clr-namespace:System;assembly=mscorlib" xmlns:ss="urn:shemas-jetbrains-com:settings-storage-xaml" xmlns:wpf="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
+	<s:Boolean x:Key="/Default/CodeEditing/GenerateMemberBody/CopyXmlDocumentation/@EntryValue">True</s:Boolean>
+	<s:String x:Key="/Default/CodeInspection/GeneratedCode/GeneratedFileMasks/=Resources_002Ecs/@EntryIndexedValue">Resources.cs</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/AnalysisEnabled/@EntryValue">VISIBLE_FILES</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ArrangeAttributes/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ArrangeBraces_005Fdowhile/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ArrangeBraces_005Ffixed/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ArrangeBraces_005Ffor/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ArrangeBraces_005Fforeach/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ArrangeBraces_005Fifelse/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ArrangeBraces_005Flock/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ArrangeBraces_005Fusing/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ArrangeBraces_005Fwhile/@EntryIndexedValue">HINT</s:String>
+	
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ArrangeModifiersOrder/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ArrangeRedundantParentheses/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ArrangeTypeMemberModifiers/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ArrangeTypeModifiers/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=BuiltInTypeReferenceStyle/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ConvertMethodToExpressionBody/@EntryIndexedValue">SUGGESTION</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=ConvertToExpressionBodyWhenPossible/@EntryIndexedValue">SUGGESTION</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=LoopCanBeConvertedToQuery/@EntryIndexedValue">HINT</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=RedundantArgumentName/@EntryIndexedValue">DO_NOT_SHOW</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=RedundantArgumentNameForLiteralExpression/@EntryIndexedValue">DO_NOT_SHOW</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=StringEndsWithIsCultureSpecific/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=StringStartsWithIsCultureSpecific/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuggestVarOrType_005FBuiltInTypes/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuggestVarOrType_005FElsewhere/@EntryIndexedValue">WARNING</s:String>
+	<s:String x:Key="/Default/CodeInspection/Highlighting/InspectionSeverities/=SuggestVarOrType_005FSimpleTypes/@EntryIndexedValue">WARNING</s:String>
+	
+	<s:String x:Key="/Default/CodeStyle/CodeCleanup/Profiles/=EntityFramework/@EntryIndexedValue">&lt;?xml version="1.0" encoding="utf-16"?&gt;&lt;Profile name="EntityFramework"&gt;&lt;HtmlReformatCode&gt;True&lt;/HtmlReformatCode&gt;&lt;CSArrangeThisQualifier&gt;True&lt;/CSArrangeThisQualifier&gt;&lt;CSRemoveCodeRedundancies&gt;True&lt;/CSRemoveCodeRedundancies&gt;&lt;CSUseAutoProperty&gt;True&lt;/CSUseAutoProperty&gt;&lt;CSMakeFieldReadonly&gt;True&lt;/CSMakeFieldReadonly&gt;&lt;CSUseVar&gt;&lt;BehavourStyle&gt;CAN_CHANGE_TO_IMPLICIT&lt;/BehavourStyle&gt;&lt;LocalVariableStyle&gt;ALWAYS_IMPLICIT&lt;/LocalVariableStyle&gt;&lt;ForeachVariableStyle&gt;ALWAYS_IMPLICIT&lt;/ForeachVariableStyle&gt;&lt;/CSUseVar&gt;&lt;CSOptimizeUsings&gt;&lt;OptimizeUsings&gt;True&lt;/OptimizeUsings&gt;&lt;EmbraceInRegion&gt;False&lt;/EmbraceInRegion&gt;&lt;RegionName&gt;&lt;/RegionName&gt;&lt;/CSOptimizeUsings&gt;&lt;CSShortenReferences&gt;True&lt;/CSShortenReferences&gt;&lt;CSReformatCode&gt;True&lt;/CSReformatCode&gt;&lt;XMLReformatCode&gt;True&lt;/XMLReformatCode&gt;&lt;CSUpdateFileHeader&gt;True&lt;/CSUpdateFileHeader&gt;&lt;CSharpFormatDocComments&gt;True&lt;/CSharpFormatDocComments&gt;&lt;RemoveCodeRedundancies&gt;True&lt;/RemoveCodeRedundancies&gt;&lt;CSMakeAutoPropertyGetOnly&gt;True&lt;/CSMakeAutoPropertyGetOnly&gt;&lt;CSArrangeQualifiers&gt;True&lt;/CSArrangeQualifiers&gt;&lt;CSEnforceVarKeywordUsageSettings&gt;True&lt;/CSEnforceVarKeywordUsageSettings&gt;&lt;CSFixBuiltinTypeReferences&gt;True&lt;/CSFixBuiltinTypeReferences&gt;&lt;CSCodeStyleAttributes ArrangeTypeAccessModifier="True" ArrangeTypeMemberAccessModifier="True" SortModifiers="True" RemoveRedundantParentheses="False" AddMissingParentheses="False" ArrangeBraces="False" ArrangeAttributes="True" ArrangeArgumentsStyle="False" /&gt;&lt;/Profile&gt;</s:String>
+	
+	<s:String x:Key="/Default/CodeStyle/CodeCleanup/RecentlyUsedProfile/@EntryValue">EntityFramework</s:String>
+	<s:String x:Key="/Default/CodeStyle/CodeCleanup/SilentCleanupProfile/@EntryValue">EntityFramework</s:String>
+	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpCodeStyle/ARGUMENTS_LITERAL/@EntryValue">Named</s:String>
+	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpCodeStyle/ARGUMENTS_STRING_LITERAL/@EntryValue">Named</s:String>
+	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpCodeStyle/BRACES_FOR_FOR/@EntryValue">Required</s:String>
+	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpCodeStyle/BRACES_FOR_FOREACH/@EntryValue">Required</s:String>
+	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpCodeStyle/BRACES_FOR_IFELSE/@EntryValue">Required</s:String>
+	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpCodeStyle/BRACES_FOR_WHILE/@EntryValue">Required</s:String>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/ALIGN_LINQ_QUERY/@EntryValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/ALIGN_MULTILINE_ARGUMENT/@EntryValue">False</s:Boolean>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/ALIGN_MULTILINE_ARRAY_AND_OBJECT_INITIALIZER/@EntryValue">False</s:Boolean>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/ALIGN_MULTILINE_CALLS_CHAIN/@EntryValue">False</s:Boolean>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/ALIGN_MULTILINE_FOR_STMT/@EntryValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/ALIGN_MULTILINE_PARAMETER/@EntryValue">False</s:Boolean>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/ALIGN_MULTLINE_TYPE_PARAMETER_CONSTRAINS/@EntryValue">True</s:Boolean>
+	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/ANONYMOUS_METHOD_DECLARATION_BRACES/@EntryValue">NEXT_LINE_SHIFTED_2</s:String>
+	<s:Int64 x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/BLANK_LINES_AROUND_NAMESPACE/@EntryValue">0</s:Int64>
+	<s:Int64 x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/BLANK_LINES_INSIDE_REGION/@EntryValue">0</s:Int64>
+	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/FORCE_ATTRIBUTE_STYLE/@EntryValue">SEPARATE</s:String>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/FORCE_CHOP_COMPOUND_DO_EXPRESSION/@EntryValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/FORCE_CHOP_COMPOUND_IF_EXPRESSION/@EntryValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/FORCE_CHOP_COMPOUND_WHILE_EXPRESSION/@EntryValue">True</s:Boolean>
+	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/FORCE_FIXED_BRACES_STYLE/@EntryValue">ALWAYS_ADD</s:String>
+	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/FORCE_FOR_BRACES_STYLE/@EntryValue">ALWAYS_ADD</s:String>
+	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/FORCE_FOREACH_BRACES_STYLE/@EntryValue">ALWAYS_ADD</s:String>
+	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/FORCE_IFELSE_BRACES_STYLE/@EntryValue">ALWAYS_ADD</s:String>
+	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/FORCE_USING_BRACES_STYLE/@EntryValue">ALWAYS_ADD</s:String>
+	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/FORCE_WHILE_BRACES_STYLE/@EntryValue">ALWAYS_ADD</s:String>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/INDENT_NESTED_USINGS_STMT/@EntryValue">False</s:Boolean>
+	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/INITIALIZER_BRACES/@EntryValue">NEXT_LINE</s:String>
+	<s:Int64 x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/KEEP_BLANK_LINES_IN_CODE/@EntryValue">1</s:Int64>
+	<s:Int64 x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/KEEP_BLANK_LINES_IN_DECLARATIONS/@EntryValue">1</s:Int64>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/LINE_FEED_AT_FILE_END/@EntryValue">True</s:Boolean>
+	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/PLACE_ACCESSORHOLDER_ATTRIBUTE_ON_SAME_LINE_EX/@EntryValue">NEVER</s:String>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/PLACE_CONSTRUCTOR_INITIALIZER_ON_SAME_LINE/@EntryValue">False</s:Boolean>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/PLACE_FIELD_ATTRIBUTE_ON_SAME_LINE/@EntryValue">False</s:Boolean>
+	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/PLACE_FIELD_ATTRIBUTE_ON_SAME_LINE_EX/@EntryValue">NEVER</s:String>
+	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/PLACE_SIMPLE_EMBEDDED_STATEMENT_ON_SAME_LINE/@EntryValue">NEVER</s:String>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/PLACE_SIMPLE_LINQ_ON_SINGLE_LINE/@EntryValue">False</s:Boolean>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/PLACE_WHILE_ON_NEW_LINE/@EntryValue">True</s:Boolean>
+	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/SIMPLE_EMBEDDED_STATEMENT_STYLE/@EntryValue">LINE_BREAK</s:String>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/SPACE_AFTER_TYPECAST_PARENTHESES/@EntryValue">False</s:Boolean>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/SPACE_AROUND_MULTIPLICATIVE_OP/@EntryValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/SPACE_BEFORE_TYPEOF_PARENTHESES/@EntryValue">False</s:Boolean>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/SPACE_WITHIN_SINGLE_LINE_ARRAY_INITIALIZER_BRACES/@EntryValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/STICK_COMMENT/@EntryValue">False</s:Boolean>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_AFTER_DECLARATION_LPAR/@EntryValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_AFTER_INVOCATION_LPAR/@EntryValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_BEFORE_BINARY_OPSIGN/@EntryValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_BEFORE_FIRST_TYPE_PARAMETER_CONSTRAINT/@EntryValue">True</s:Boolean>
+	<s:Int64 x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_LIMIT/@EntryValue">140</s:Int64>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_LINES/@EntryValue">False</s:Boolean>
+	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpFormat/WRAP_MULTIPLE_TYPE_PARAMEER_CONSTRAINTS_STYLE/@EntryValue">CHOP_ALWAYS</s:String>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/JavaScriptCodeFormatting/ALIGN_MULTIPLE_DECLARATION/@EntryValue">True</s:Boolean>
+	
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/JavaScriptCodeFormatting/JavaScriptFormatOther/ALIGN_MULTIPLE_DECLARATION/@EntryValue">True</s:Boolean>
+	<s:Int64 x:Key="/Default/CodeStyle/CodeFormatting/XmlDocFormatter/WrapLimit/@EntryValue">140</s:Int64>
+	<s:Int64 x:Key="/Default/CodeStyle/CodeFormatting/XmlDocFormatter/WRAP_LIMIT/@EntryValue">140</s:Int64>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/XmlFormatter/WrapBeforeAttr/@EntryValue">False</s:Boolean>
+	<s:Boolean x:Key="/Default/CodeStyle/CodeFormatting/XmlFormatter/WrapInsideText/@EntryValue">True</s:Boolean>
+	
+	<s:Boolean x:Key="/Default/CodeStyle/CSharpUsing/QualifiedUsingAtNestedScope/@EntryValue">True</s:Boolean>
+	
+	
+	
+	<s:Boolean x:Key="/Default/CodeStyle/Generate/=Constructor/@KeyIndexDefined">True</s:Boolean>
+	<s:String x:Key="/Default/CodeStyle/Generate/=Constructor/Options/=XmlDocumentation/@EntryIndexedValue">True</s:String>
+	<s:Boolean x:Key="/Default/CodeStyle/Generate/=Equality/@KeyIndexDefined">True</s:Boolean>
+	<s:String x:Key="/Default/CodeStyle/Generate/=Equality/Options/=ChangeEquals/@EntryIndexedValue">Side by side</s:String>
+	<s:String x:Key="/Default/CodeStyle/Generate/=Equality/Options/=ChangeGetHashCode/@EntryIndexedValue">Side by side</s:String>
+	<s:String x:Key="/Default/CodeStyle/Generate/=Equality/Options/=EqualityOperators/@EntryIndexedValue">False</s:String>
+	<s:String x:Key="/Default/CodeStyle/Generate/=Equality/Options/=ImplementIEquatable/@EntryIndexedValue">False</s:String>
+	<s:String x:Key="/Default/CodeStyle/Generate/=Equality/Options/=XmlDocumentation/@EntryIndexedValue">False</s:String>
+	<s:Boolean x:Key="/Default/CodeStyle/Generate/=Implementations/@KeyIndexDefined">True</s:Boolean>
+	<s:String x:Key="/Default/CodeStyle/Generate/=Implementations/Options/=WrapInRegion/@EntryIndexedValue">False</s:String>
+	<s:String x:Key="/Default/CodeStyle/Generate/=Implementations/Options/=XmlDocumentation/@EntryIndexedValue">False</s:String>
+	<s:Boolean x:Key="/Default/CodeStyle/Generate/=Overrides/@KeyIndexDefined">True</s:Boolean>
+	<s:String x:Key="/Default/CodeStyle/Generate/=Overrides/Options/=WrapInRegion/@EntryIndexedValue">False</s:String>
+	<s:String x:Key="/Default/CodeStyle/Generate/=Overrides/Options/=XmlDocumentation/@EntryIndexedValue">False</s:String>
+	<s:Boolean x:Key="/Default/CodeStyle/IntroduceVariableUseVar/UseVarForIntroduceVariableRefactoring/@EntryValue">True</s:Boolean>
+	<s:String x:Key="/Default/CodeStyle/Naming/CppNaming/UserRules/=CONSTANT/@EntryIndexedValue">&lt;Policy Inspect="True" Prefix="" Suffix="" Style="aa_bb" /&gt;</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/CppNaming/UserRules/=PUBLIC_005FSTRUCT_005FFIELD/@EntryIndexedValue">&lt;Policy Inspect="True" Prefix="" Suffix="" Style="aa_bb" /&gt;</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/EventHandlerPatternLong/@EntryValue">$object$_On$event$</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/PredefinedNamingRules/=PrivateStaticReadonly/@EntryIndexedValue">&lt;Policy Inspect="True" Prefix="_" Suffix="" Style="aaBb" /&gt;</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/UserRules/=042e7460_002D3ec6_002D4f1c_002D87c3_002Dfc91240d4c90/@EntryIndexedValue">&lt;Policy&gt;&lt;Descriptor Staticness="Static, Instance" AccessRightKinds="Public" Description="Test Methods"&gt;&lt;ElementKinds&gt;&lt;Kind Name="TEST_MEMBER" /&gt;&lt;/ElementKinds&gt;&lt;/Descriptor&gt;&lt;Policy Inspect="True" Prefix="" Suffix="" Style="Aa_bb" /&gt;&lt;/Policy&gt;</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/UserRules/=15b5b1f1_002D457c_002D4ca6_002Db278_002D5615aedc07d3/@EntryIndexedValue">&lt;Policy&gt;&lt;Descriptor Staticness="Static" AccessRightKinds="Private" Description="Static readonly fields (private)"&gt;&lt;ElementKinds&gt;&lt;Kind Name="READONLY_FIELD" /&gt;&lt;/ElementKinds&gt;&lt;/Descriptor&gt;&lt;Policy Inspect="True" Prefix="_" Suffix="" Style="aaBb" /&gt;&lt;/Policy&gt;</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/JavaScriptNaming/UserRules/=TS_005FMIXED_005FENUM/@EntryIndexedValue">&lt;Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /&gt;</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/JavaScriptNaming/UserRules/=TS_005FTYPE_005FALIAS/@EntryIndexedValue">&lt;Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /&gt;</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/VBNaming/EventHandlerPatternLong/@EntryValue">$object$_On$event$</s:String>
+	<s:Boolean x:Key="/Default/Environment/InjectedLayers/FileInjectedLayer/=13B3C0735924B9498D46F16CAB3349A2/@KeyIndexDefined">True</s:Boolean>
+	<s:String x:Key="/Default/Environment/InjectedLayers/FileInjectedLayer/=13B3C0735924B9498D46F16CAB3349A2/AbsolutePath/@EntryValue">D:\EntityFramework\EFCore.sln.DotSettings</s:String>
+	<s:String x:Key="/Default/Environment/InjectedLayers/FileInjectedLayer/=13B3C0735924B9498D46F16CAB3349A2/RelativePath/@EntryValue"></s:String>
+	<s:Boolean x:Key="/Default/Environment/InjectedLayers/InjectedLayerCustomization/=File13B3C0735924B9498D46F16CAB3349A2/@KeyIndexDefined">True</s:Boolean>
+	<s:Double x:Key="/Default/Environment/InjectedLayers/InjectedLayerCustomization/=File13B3C0735924B9498D46F16CAB3349A2/RelativePriority/@EntryValue">1</s:Double>
+	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EFeature_002EServices_002ECodeCleanup_002EFileHeader_002EFileHeaderSettingsMigrate/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EFeature_002EServices_002EDaemon_002ESettings_002EMigration_002ESwaWarningsModeSettingsMigrate/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ECSharpAttributeForSingleLineMethodUpgrade/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ECSharpKeepExistingMigration/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ECSharpPlaceAttributeOnSameLineMigration/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ECSharpPlaceEmbeddedOnSameLineMigration/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ECSharpRenamePlacementToArrangementMigration/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ECSharpUseContinuousIndentInsideBracesMigration/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ESettingsUpgrade_002EAddAccessorOwnerDeclarationBracesMigration/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ESettingsUpgrade_002ECSharpPlaceAttributeOnSameLineMigration/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ESettingsUpgrade_002EMigrateBlankLinesAroundFieldToBlankLinesAroundProperty/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ESettingsUpgrade_002EMigrateThisQualifierSettings/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ESettingsUpgrade_002EPredefinedNamingRulesToUserRulesUpgrade/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002EJavaScript_002ECodeStyle_002ESettingsUpgrade_002EJsCodeFormatterSettingsUpgrader/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002EJavaScript_002ECodeStyle_002ESettingsUpgrade_002EJsParsFormattingSettingsUpgrader/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002EJavaScript_002ECodeStyle_002ESettingsUpgrade_002EJsWrapperSettingsUpgrader/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002EXml_002ECodeStyle_002EFormatSettingsUpgrade_002EXmlMoveToCommonFormatterSettingsUpgrade/@EntryIndexedValue">True</s:Boolean></wpf:ResourceDictionary>
\ No newline at end of file
diff --git a/samples/core/Saving/Basics/Blog.cs b/samples/core/Saving/Basics/Blog.cs
new file mode 100644
index 0000000000..975b58c548
--- /dev/null
+++ b/samples/core/Saving/Basics/Blog.cs
@@ -0,0 +1,11 @@
+using System.Collections.Generic;
+
+namespace EFSaving.Basics;
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public List<Post> Posts { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Saving/Basics/BloggingContext.cs b/samples/core/Saving/Basics/BloggingContext.cs
new file mode 100644
index 0000000000..d2d005449a
--- /dev/null
+++ b/samples/core/Saving/Basics/BloggingContext.cs
@@ -0,0 +1,15 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFSaving.Basics;
+
+public class BloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder.UseSqlServer(
+            @"Server=(localdb)\mssqllocaldb;Database=EFSaving.Basics;Trusted_Connection=True;ConnectRetryCount=0");
+    }
+}
diff --git a/samples/core/Saving/Basics/Post.cs b/samples/core/Saving/Basics/Post.cs
new file mode 100644
index 0000000000..b5e82e2533
--- /dev/null
+++ b/samples/core/Saving/Basics/Post.cs
@@ -0,0 +1,11 @@
+namespace EFSaving.Basics;
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Saving/Basics/Sample.cs b/samples/core/Saving/Basics/Sample.cs
new file mode 100644
index 0000000000..73855c4fb7
--- /dev/null
+++ b/samples/core/Saving/Basics/Sample.cs
@@ -0,0 +1,71 @@
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFSaving.Basics;
+
+public class Sample
+{
+    public static async Task Run()
+    {
+        using (var context = new BloggingContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        #region Add
+        using (var context = new BloggingContext())
+        {
+            var blog = new Blog { Url = "http://example.com" };
+            context.Blogs.Add(blog);
+            await context.SaveChangesAsync();
+        }
+        #endregion
+
+        #region Update
+        using (var context = new BloggingContext())
+        {
+            var blog = await context.Blogs.SingleAsync(b => b.Url == "http://example.com");
+            blog.Url = "http://example.com/blog";
+            await context.SaveChangesAsync();
+        }
+        #endregion
+
+        #region Remove
+        using (var context = new BloggingContext())
+        {
+            var blog = await context.Blogs.SingleAsync(b => b.Url == "http://example.com/blog");
+            context.Blogs.Remove(blog);
+            await context.SaveChangesAsync();
+        }
+        #endregion
+
+        #region MultipleOperations
+        using (var context = new BloggingContext())
+        {
+            // seeding database
+            context.Blogs.Add(new Blog { Url = "http://example.com/blog" });
+            context.Blogs.Add(new Blog { Url = "http://example.com/another_blog" });
+            await context.SaveChangesAsync();
+        }
+
+        using (var context = new BloggingContext())
+        {
+            // add
+            context.Blogs.Add(new Blog { Url = "http://example.com/blog_one" });
+            context.Blogs.Add(new Blog { Url = "http://example.com/blog_two" });
+
+            // update
+            var firstBlog = await context.Blogs.FirstAsync();
+            firstBlog.Url = "";
+
+            // remove
+            var lastBlog = await context.Blogs.OrderBy(e => e.BlogId).LastAsync();
+            context.Blogs.Remove(lastBlog);
+
+            await context.SaveChangesAsync();
+        }
+        #endregion
+    }
+}
diff --git a/samples/core/Saving/CascadeDelete/Blog.cs b/samples/core/Saving/CascadeDelete/Blog.cs
new file mode 100644
index 0000000000..8f028eb780
--- /dev/null
+++ b/samples/core/Saving/CascadeDelete/Blog.cs
@@ -0,0 +1,11 @@
+using System.Collections.Generic;
+
+namespace EFSaving.CascadeDelete;
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public List<Post> Posts { get; set; } = new List<Post>();
+}
\ No newline at end of file
diff --git a/samples/core/Saving/CascadeDelete/BloggingContext.cs b/samples/core/Saving/CascadeDelete/BloggingContext.cs
new file mode 100644
index 0000000000..b39ebca561
--- /dev/null
+++ b/samples/core/Saving/CascadeDelete/BloggingContext.cs
@@ -0,0 +1,115 @@
+using System;
+using System.Collections.Generic;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.Extensions.Logging;
+
+namespace EFSaving.CascadeDelete;
+
+public sealed class BloggingContext : DbContext
+{
+    public BloggingContext(DeleteBehavior deleteBehavior, bool requiredRelationship)
+    {
+        DeleteBehavior = deleteBehavior;
+        RequiredRelationship = requiredRelationship;
+
+        if (LogMessages == null)
+        {
+            LogMessages = new List<string>();
+            this.GetService<ILoggerFactory>().AddProvider(new MyLoggerProvider());
+        }
+    }
+
+    public DeleteBehavior DeleteBehavior { get; }
+    public bool RequiredRelationship { get; }
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder
+            .ReplaceService<IModelCacheKeyFactory, DeleteBehaviorCacheKeyFactory>()
+            .EnableSensitiveDataLogging()
+            .UseSqlServer(
+                @"Server=(localdb)\mssqllocaldb;Database=EFSaving.CascadeDelete;Trusted_Connection=True;ConnectRetryCount=0",
+                b => b.MaxBatchSize(1));
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+        => modelBuilder
+            .Entity<Blog>()
+            .HasMany(e => e.Posts)
+            .WithOne(e => e.Blog)
+            .OnDelete(DeleteBehavior)
+            .IsRequired(RequiredRelationship);
+
+    public override async Task<int> SaveChangesAsync(CancellationToken cancellationToken = default)
+    {
+        LogMessages.Clear();
+
+        return await base.SaveChangesAsync(cancellationToken);
+    }
+
+    public class DeleteBehaviorCacheKeyFactory : IModelCacheKeyFactory
+    {
+        public virtual object Create(DbContext context, bool designTime)
+        {
+            var bloggingContext = (BloggingContext)context;
+
+            return (bloggingContext.DeleteBehavior, bloggingContext.RequiredRelationship, designTime);
+        }
+    }
+
+    public static IList<string> LogMessages;
+
+    private class MyLoggerProvider : ILoggerProvider
+    {
+        public ILogger CreateLogger(string categoryName) => new SampleLogger();
+
+        public void Dispose()
+        {
+        }
+
+        private class SampleLogger : ILogger
+        {
+            public bool IsEnabled(LogLevel logLevel) => true;
+
+            public void Log<TState>(
+                LogLevel logLevel, EventId eventId, TState state, Exception exception,
+                Func<TState, Exception, string> formatter)
+            {
+                if (eventId.Id == RelationalEventId.CommandExecuting.Id)
+                {
+                    var message = formatter(state, exception);
+                    var commandIndex = Math.Max(message.IndexOf("UPDATE"), message.IndexOf("DELETE"));
+                    if (commandIndex >= 0)
+                    {
+                        var truncatedMessage = message.Substring(commandIndex, message.IndexOf(";", commandIndex) - commandIndex)
+                            .Replace(Environment.NewLine, " ");
+
+                        for (var i = 0; i < 4; i++)
+                        {
+                            var paramIndex = message.IndexOf($"@p{i}='");
+                            if (paramIndex >= 0)
+                            {
+                                var paramValue = message.Substring(paramIndex + 5, 1);
+                                if (paramValue == "'")
+                                {
+                                    paramValue = "NULL";
+                                }
+
+                                truncatedMessage = truncatedMessage.Replace($"@p{i}", paramValue);
+                            }
+                        }
+
+                        LogMessages.Add(truncatedMessage);
+                    }
+                }
+            }
+
+            public IDisposable BeginScope<TState>(TState state) => null;
+        }
+    }
+}
diff --git a/samples/core/Saving/CascadeDelete/Post.cs b/samples/core/Saving/CascadeDelete/Post.cs
new file mode 100644
index 0000000000..36fea8b668
--- /dev/null
+++ b/samples/core/Saving/CascadeDelete/Post.cs
@@ -0,0 +1,11 @@
+namespace EFSaving.CascadeDelete;
+
+public class Post
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int? BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Saving/CascadeDelete/Sample.cs b/samples/core/Saving/CascadeDelete/Sample.cs
new file mode 100644
index 0000000000..0daf63cdfb
--- /dev/null
+++ b/samples/core/Saving/CascadeDelete/Sample.cs
@@ -0,0 +1,162 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFSaving.CascadeDelete;
+
+public class Sample
+{
+    public static async Task Run()
+    {
+        await DeleteBehaviorSample(DeleteBehavior.Cascade, true);
+        await DeleteBehaviorSample(DeleteBehavior.ClientSetNull, true);
+        await DeleteBehaviorSample(DeleteBehavior.SetNull, true);
+        await DeleteBehaviorSample(DeleteBehavior.Restrict, true);
+
+        await DeleteBehaviorSample(DeleteBehavior.Cascade, false);
+        await DeleteBehaviorSample(DeleteBehavior.ClientSetNull, false);
+        await DeleteBehaviorSample(DeleteBehavior.SetNull, false);
+        await DeleteBehaviorSample(DeleteBehavior.Restrict, false);
+
+        await DeleteOrphansSample(DeleteBehavior.Cascade, true);
+        await DeleteOrphansSample(DeleteBehavior.ClientSetNull, true);
+        await DeleteOrphansSample(DeleteBehavior.SetNull, true);
+        await DeleteOrphansSample(DeleteBehavior.Restrict, true);
+
+        await DeleteOrphansSample(DeleteBehavior.Cascade, false);
+        await DeleteOrphansSample(DeleteBehavior.ClientSetNull, false);
+        await DeleteOrphansSample(DeleteBehavior.SetNull, false);
+        await DeleteOrphansSample(DeleteBehavior.Restrict, false);
+    }
+
+    private static async Task DeleteBehaviorSample(DeleteBehavior deleteBehavior, bool requiredRelationship)
+    {
+        Console.WriteLine(
+            $"Test using DeleteBehavior.{deleteBehavior} with {(requiredRelationship ? "required" : "optional")} relationship:");
+
+        await InitializeDatabase(requiredRelationship);
+
+        using var context = new BloggingContext(deleteBehavior, requiredRelationship);
+
+        #region DeleteBehaviorVariations
+        var blog = await context.Blogs.Include(b => b.Posts).FirstAsync();
+        var posts = blog.Posts.ToList();
+
+        DumpEntities("  After loading entities:", context, blog, posts);
+
+        context.Remove(blog);
+
+        DumpEntities($"  After deleting blog '{blog.BlogId}':", context, blog, posts);
+
+        try
+        {
+            Console.WriteLine();
+            Console.WriteLine("  Saving changes:");
+
+            await context.SaveChangesAsync();
+
+            DumpSql();
+
+            DumpEntities("  After SaveChanges:", context, blog, posts);
+        }
+        catch (Exception e)
+        {
+            DumpSql();
+
+            Console.WriteLine();
+            Console.WriteLine(
+                $"  SaveChanges threw {e.GetType().Name}: {(e is DbUpdateException ? e.InnerException.Message : e.Message)}");
+        }
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    private static async Task DeleteOrphansSample(DeleteBehavior deleteBehavior, bool requiredRelationship)
+    {
+        Console.WriteLine(
+            $"Test deleting orphans with DeleteBehavior.{deleteBehavior} and {(requiredRelationship ? "a required" : "an optional")} relationship:");
+
+        await InitializeDatabase(requiredRelationship);
+
+        using var context = new BloggingContext(deleteBehavior, requiredRelationship);
+
+        #region DeleteOrphansVariations
+        var blog = await context.Blogs.Include(b => b.Posts).FirstAsync();
+        var posts = blog.Posts.ToList();
+
+        DumpEntities("  After loading entities:", context, blog, posts);
+
+        blog.Posts.Clear();
+
+        DumpEntities("  After making posts orphans:", context, blog, posts);
+
+        try
+        {
+            Console.WriteLine();
+            Console.WriteLine("  Saving changes:");
+
+            await context.SaveChangesAsync();
+
+            DumpSql();
+
+            DumpEntities("  After SaveChanges:", context, blog, posts);
+        }
+        catch (Exception e)
+        {
+            DumpSql();
+
+            Console.WriteLine();
+            Console.WriteLine(
+                $"  SaveChanges threw {e.GetType().Name}: {(e is DbUpdateException ? e.InnerException.Message : e.Message)}");
+        }
+        #endregion
+
+        Console.WriteLine();
+    }
+
+    private static async Task InitializeDatabase(bool requiredRelationship)
+    {
+        using var context = new BloggingContext(DeleteBehavior.ClientSetNull, requiredRelationship);
+        await context.Database.EnsureDeletedAsync();
+        await context.Database.EnsureCreatedAsync();
+
+        context.Blogs.Add(
+            new Blog
+            {
+                Url = "http://sample.com",
+                Posts = new List<Post> { new Post { Title = "Saving Data with EF" }, new Post { Title = "Cascade Delete with EF" } }
+            });
+
+        await context.SaveChangesAsync();
+    }
+
+    private static void DumpEntities(string message, BloggingContext context, Blog blog, IList<Post> posts)
+    {
+        Console.WriteLine();
+        Console.WriteLine(message);
+
+        var blogEntry = context.Entry(blog);
+
+        Console.WriteLine($"    Blog '{blog.BlogId}' is in state {blogEntry.State} with {posts.Count} posts referenced.");
+
+        foreach (var post in posts)
+        {
+            var postEntry = context.Entry(post);
+
+            Console.WriteLine(
+                $"      Post '{post.PostId}' is in state {postEntry.State} " +
+                $"with FK '{post.BlogId?.ToString() ?? "null"}' and {(post.Blog == null ? "no reference to a blog." : $"reference to blog '{post.BlogId}'.")}");
+        }
+    }
+
+    private static void DumpSql()
+    {
+        foreach (var logMessage in BloggingContext.LogMessages)
+        {
+            Console.WriteLine("    " + logMessage);
+        }
+    }
+}
diff --git a/samples/core/Saving/Concurrency/BasicSample.cs b/samples/core/Saving/Concurrency/BasicSample.cs
new file mode 100644
index 0000000000..76f3b6037e
--- /dev/null
+++ b/samples/core/Saving/Concurrency/BasicSample.cs
@@ -0,0 +1,85 @@
+using System;
+using System.ComponentModel.DataAnnotations;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFSaving.Concurrency;
+
+public class BasicSample
+{
+    public static async Task Run()
+    {
+        // Ensure database is created and has a person in it
+        using (var setupContext = new PersonContext())
+        {
+            await setupContext.Database.EnsureDeletedAsync();
+            await setupContext.Database.EnsureCreatedAsync();
+
+            setupContext.People.Add(new Person { FirstName = "John", LastName = "Doe" });
+            setupContext.People.Add(new Person { FirstName = "Marie", LastName = "Jane" });
+            await setupContext.SaveChangesAsync();
+        }
+
+        await SuccessfulUpdate();
+        await ConcurrencyFailure();
+    }
+
+    // This shows a successful update, where no concurrent change happens
+    private static async Task SuccessfulUpdate()
+    {
+        using var context = new PersonContext();
+
+        var person = await context.People.SingleAsync(b => b.FirstName == "John");
+        person.FirstName = "Paul";
+        await context.SaveChangesAsync();
+
+        Console.WriteLine("The change completed successfully.");
+    }
+
+    // This simulates a concurrency failure by modifying the row via another context after it was loaded.
+    private static async Task ConcurrencyFailure()
+    {
+        using var context1 = new PersonContext();
+
+        var person = await context1.People.SingleAsync(b => b.FirstName == "Marie");
+        person.FirstName = "Stephanie";
+
+        // We loaded the Blog instance - along with its concurrency token - and made a change on it.
+        // Let's simulate a concurrent change by updating the row from another context
+        using (var context2 = new PersonContext())
+        {
+            var person2 = await context2.People.SingleAsync(b => b.FirstName == "Marie");
+            person2.FirstName = "Rachel";
+            await context2.SaveChangesAsync();
+        }
+
+        // The tracked person in EF's change tracker has an out of date concurrency token, so calling SaveChanges will now throw
+        // a DbUpdateConcurrencyException
+        Console.WriteLine("SaveChanges should now throw:");
+        await context1.SaveChangesAsync();
+    }
+
+    public class PersonContext : DbContext
+    {
+        public DbSet<Person> People { get; set; }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            // Requires NuGet package Microsoft.EntityFrameworkCore.SqlServer
+            optionsBuilder.UseSqlServer(
+                @"Server=(localdb)\mssqllocaldb;Database=EFSaving.Concurrency;Trusted_Connection=True;ConnectRetryCount=0");
+        }
+    }
+
+    public class Person
+    {
+        public int PersonId { get; set; }
+
+        public string FirstName { get; set; }
+        public string LastName { get; set; }
+
+        [Timestamp]
+        public byte[] Version { get; set; }
+    }
+}
diff --git a/samples/core/Saving/Concurrency/ConflictResolutionSample.cs b/samples/core/Saving/Concurrency/ConflictResolutionSample.cs
new file mode 100644
index 0000000000..1b87155cca
--- /dev/null
+++ b/samples/core/Saving/Concurrency/ConflictResolutionSample.cs
@@ -0,0 +1,99 @@
+using System;
+using System.ComponentModel.DataAnnotations;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFSaving.Concurrency;
+
+public class ConflictResolutionSample
+{
+    public static async Task Run()
+    {
+        // Ensure database is created and has a person in it
+        using (var setupContext = new PersonContext())
+        {
+            await setupContext.Database.EnsureDeletedAsync();
+            await setupContext.Database.EnsureCreatedAsync();
+
+            setupContext.People.Add(new Person { FirstName = "John", LastName = "Doe" });
+            await setupContext.SaveChangesAsync();
+        }
+
+        #region ConcurrencyHandlingCode
+        using var context = new PersonContext();
+        // Fetch a person from database and change phone number
+        var person = await context.People.SingleAsync(p => p.PersonId == 1);
+        person.PhoneNumber = "555-555-5555";
+
+        // Change the person's name in the database to simulate a concurrency conflict
+        await context.Database.ExecuteSqlRawAsync(
+            "UPDATE dbo.People SET FirstName = 'Jane' WHERE PersonId = 1");
+
+        var saved = false;
+        while (!saved)
+        {
+            try
+            {
+                // Attempt to save changes to the database
+                await context.SaveChangesAsync();
+                saved = true;
+            }
+            catch (DbUpdateConcurrencyException ex)
+            {
+                foreach (var entry in ex.Entries)
+                {
+                    if (entry.Entity is Person)
+                    {
+                        var proposedValues = entry.CurrentValues;
+                        var databaseValues = await entry.GetDatabaseValuesAsync();
+
+                        foreach (var property in proposedValues.Properties)
+                        {
+                            var proposedValue = proposedValues[property];
+                            var databaseValue = databaseValues[property];
+
+                            // TODO: decide which value should be written to database
+                            // proposedValues[property] = <value to be saved>;
+                        }
+
+                        // Refresh original values to bypass next concurrency check
+                        entry.OriginalValues.SetValues(databaseValues);
+                    }
+                    else
+                    {
+                        throw new NotSupportedException(
+                            "Don't know how to handle concurrency conflicts for "
+                            + entry.Metadata.Name);
+                    }
+                }
+            }
+        }
+        #endregion
+    }
+
+    public class PersonContext : DbContext
+    {
+        public DbSet<Person> People { get; set; }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            // Requires NuGet package Microsoft.EntityFrameworkCore.SqlServer
+            optionsBuilder.UseSqlServer(
+                @"Server=(localdb)\mssqllocaldb;Database=EFSaving.Concurrency;Trusted_Connection=True;ConnectRetryCount=0");
+        }
+    }
+
+    public class Person
+    {
+        public int PersonId { get; set; }
+
+        [ConcurrencyCheck]
+        public string FirstName { get; set; }
+
+        [ConcurrencyCheck]
+        public string LastName { get; set; }
+
+        public string PhoneNumber { get; set; }
+    }
+}
diff --git a/samples/core/Saving/Disconnected/Blog.cs b/samples/core/Saving/Disconnected/Blog.cs
new file mode 100644
index 0000000000..589ead3748
--- /dev/null
+++ b/samples/core/Saving/Disconnected/Blog.cs
@@ -0,0 +1,11 @@
+using System.Collections.Generic;
+
+namespace EFSaving.Disconnected;
+
+public class Blog : EntityBase
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+
+    public List<Post> Posts { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Saving/Disconnected/BloggingContext.cs b/samples/core/Saving/Disconnected/BloggingContext.cs
new file mode 100644
index 0000000000..41f30b9b59
--- /dev/null
+++ b/samples/core/Saving/Disconnected/BloggingContext.cs
@@ -0,0 +1,15 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFSaving.Disconnected;
+
+public class BloggingContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder.UseSqlServer(
+            @"Server=(localdb)\mssqllocaldb;Database=EFSaving.Disconnected;Trusted_Connection=True;ConnectRetryCount=0");
+    }
+}
diff --git a/samples/core/Saving/Disconnected/EntityBase.cs b/samples/core/Saving/Disconnected/EntityBase.cs
new file mode 100644
index 0000000000..8f385de6d4
--- /dev/null
+++ b/samples/core/Saving/Disconnected/EntityBase.cs
@@ -0,0 +1,15 @@
+using System.ComponentModel.DataAnnotations.Schema;
+
+namespace EFSaving.Disconnected;
+
+public abstract class EntityBase
+{
+    [NotMapped]
+    public bool IsNew { get; set; }
+
+    [NotMapped]
+    public bool IsDeleted { get; set; }
+
+    [NotMapped]
+    public bool IsChanged { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Saving/Disconnected/Post.cs b/samples/core/Saving/Disconnected/Post.cs
new file mode 100644
index 0000000000..3ea15a3932
--- /dev/null
+++ b/samples/core/Saving/Disconnected/Post.cs
@@ -0,0 +1,11 @@
+namespace EFSaving.Disconnected;
+
+public class Post : EntityBase
+{
+    public int PostId { get; set; }
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int BlogId { get; set; }
+    public Blog Blog { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Saving/Disconnected/Sample.cs b/samples/core/Saving/Disconnected/Sample.cs
new file mode 100644
index 0000000000..9da1d50fa8
--- /dev/null
+++ b/samples/core/Saving/Disconnected/Sample.cs
@@ -0,0 +1,558 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFSaving.Disconnected;
+
+public class Sample
+{
+    public static async Task Run()
+    {
+        using (var context = new BloggingContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        await IsItNew();
+        await InsertAndUpdateSingleEntity();
+        await InsertOrUpdateSingleEntityStoreGenerated();
+        await InsertOrUpdateSingleEntityFind();
+        await InsertAndUpdateGraph();
+        await InsertOrUpdateGraphStoreGenerated();
+        await InsertOrUpdateGraphFind();
+        await InsertUpdateOrDeleteGraphFind();
+        await InsertUpdateOrDeleteTrackGraph();
+    }
+
+    private static async Task IsItNew()
+    {
+        Console.WriteLine();
+        Console.WriteLine("Show entity-specific check for key set:");
+        using (var context = new BloggingContext())
+        {
+            var blog = new Blog { Url = "http://sample.com" };
+
+            // Key is not set for a new entity
+            Console.WriteLine($"  Blog entity is {(IsItNew(blog) ? "new" : "existing")}.");
+
+            context.Add(blog);
+            await context.SaveChangesAsync();
+
+            // Key is now set
+            Console.WriteLine($"  Blog entity is {(IsItNew(blog) ? "new" : "existing")}.");
+        }
+
+        Console.WriteLine();
+        Console.WriteLine("Show general IsKeySet:");
+        using (var context = new BloggingContext())
+        {
+            var blog = new Blog { Url = "http://sample.com" };
+
+            // Key is not set for a new entity
+            Console.WriteLine($"  Blog entity is {(IsItNew(context, (object)blog) ? "new" : "existing")}.");
+
+            context.Add(blog);
+            await context.SaveChangesAsync();
+
+            // Key is now set
+            Console.WriteLine($"  Blog entity is {(IsItNew(context, (object)blog) ? "new" : "existing")}.");
+        }
+
+        Console.WriteLine();
+        Console.WriteLine("Show key set on Add:");
+        using (var context = new BloggingContext())
+        {
+            var blog = new Blog { Url = "http://sample.com" };
+
+            // Key is not set for a new entity
+            Console.WriteLine($"  Blog entity is {(IsItNew(context, (object)blog) ? "new" : "existing")}.");
+
+            context.Add(blog);
+
+            // Key is set as soon as Add assigns a key, even if it is temporary
+            Console.WriteLine($"  Blog entity is {(IsItNew(context, (object)blog) ? "new" : "existing")}.");
+        }
+
+        Console.WriteLine();
+        Console.WriteLine("Show using query to check for new entity:");
+        using (var context = new BloggingContext())
+        {
+            var blog = new Blog { Url = "http://sample.com" };
+
+            Console.WriteLine($"  Blog entity is {(await IsItNew(context, blog) ? "new" : "existing")}.");
+
+            context.Add(blog);
+            await context.SaveChangesAsync();
+
+            Console.WriteLine($"  Blog entity is {(await IsItNew(context, blog) ? "new" : "existing")}.");
+        }
+    }
+
+    private static async Task InsertAndUpdateSingleEntity()
+    {
+        Console.WriteLine();
+        Console.WriteLine("Save single entity with explicit insert or update:");
+        var blog = new Blog { Url = "http://sample.com" };
+
+        using (var context = new BloggingContext())
+        {
+            Console.WriteLine($"  Inserting with URL {blog.Url}");
+            await Insert(context, blog);
+        }
+
+        using (var context = new BloggingContext())
+        {
+            Console.WriteLine($"  Found with URL {(await context.Blogs.SingleAsync(b => b.BlogId == blog.BlogId)).Url}");
+        }
+
+        using (var context = new BloggingContext())
+        {
+            blog.Url = "https://sample.com";
+            Console.WriteLine($"  Updating with URL {blog.Url}");
+            await Update(context, blog);
+        }
+
+        using (var context = new BloggingContext())
+        {
+            Console.WriteLine($"  Found with URL {((await context.Blogs.SingleAsync(b => b.BlogId == blog.BlogId))).Url}");
+        }
+    }
+
+    private static async Task InsertOrUpdateSingleEntityStoreGenerated()
+    {
+        Console.WriteLine();
+        Console.WriteLine("Save single entity with auto-generated key:");
+        var blog = new Blog { Url = "http://sample.com" };
+
+        using (var context = new BloggingContext())
+        {
+            Console.WriteLine($"  Inserting with URL {blog.Url}");
+            await InsertOrUpdate(context, (object)blog);
+        }
+
+        using (var context = new BloggingContext())
+        {
+            Console.WriteLine($"  Found with URL {(await context.Blogs.SingleAsync(b => b.BlogId == blog.BlogId)).Url}");
+        }
+
+        using (var context = new BloggingContext())
+        {
+            blog.Url = "https://sample.com";
+            Console.WriteLine($"  Updating with URL {blog.Url}");
+            await InsertOrUpdate(context, (object)blog);
+        }
+
+        using (var context = new BloggingContext())
+        {
+            Console.WriteLine($"  Found with URL {((await context.Blogs.SingleAsync(b => b.BlogId == blog.BlogId))).Url}");
+        }
+    }
+
+    private static async Task InsertOrUpdateSingleEntityFind()
+    {
+        Console.WriteLine();
+        Console.WriteLine("Save single entity with any kind of key:");
+        var blog = new Blog { Url = "http://sample.com" };
+
+        using (var context = new BloggingContext())
+        {
+            Console.WriteLine($"  Inserting with URL {blog.Url}");
+            await InsertOrUpdate(context, blog);
+        }
+
+        using (var context = new BloggingContext())
+        {
+            Console.WriteLine($"  Found with URL {(await context.Blogs.SingleAsync(b => b.BlogId == blog.BlogId)).Url}");
+        }
+
+        using (var context = new BloggingContext())
+        {
+            blog.Url = "https://sample.com";
+            Console.WriteLine($"  Updating with URL {blog.Url}");
+            await InsertOrUpdate(context, blog);
+        }
+
+        using (var context = new BloggingContext())
+        {
+            Console.WriteLine($"  Found with URL {(await context.Blogs.SingleAsync(b => b.BlogId == blog.BlogId)).Url}");
+        }
+    }
+
+    private static async Task InsertAndUpdateGraph()
+    {
+        Console.WriteLine();
+        Console.WriteLine("Save graph with explicit insert or update:");
+        var blog = CreateBlogAndPosts();
+
+        using (var context = new BloggingContext())
+        {
+            Console.WriteLine($"  Inserting with URL {blog.Url} and {blog.Posts[0].Title}, {blog.Posts[1].Title}");
+            await InsertGraph(context, blog);
+        }
+
+        using (var context = new BloggingContext())
+        {
+            var read = await context.Blogs.Include(b => b.Posts).SingleAsync(b => b.BlogId == blog.BlogId);
+            Console.WriteLine($"  Found with URL {read.Url} and {read.Posts[0].Title}, {read.Posts[1].Title}");
+        }
+
+        using (var context = new BloggingContext())
+        {
+            blog.Url = "https://sample.com";
+            blog.Posts[0].Title = "Post A";
+            blog.Posts[1].Title = "Post B";
+
+            Console.WriteLine($"  Updating with URL {blog.Url}");
+            await UpdateGraph(context, blog);
+        }
+
+        using (var context = new BloggingContext())
+        {
+            var read = await context.Blogs.Include(b => b.Posts).SingleAsync(b => b.BlogId == blog.BlogId);
+            Console.WriteLine($"  Found with URL {read.Url} and {read.Posts[0].Title}, {read.Posts[1].Title}");
+        }
+    }
+
+    private static async Task InsertOrUpdateGraphStoreGenerated()
+    {
+        Console.WriteLine();
+        Console.WriteLine("Save graph with auto-generated key:");
+        var blog = CreateBlogAndPosts();
+
+        using (var context = new BloggingContext())
+        {
+            Console.WriteLine($"  Inserting with URL {blog.Url} and {blog.Posts[0].Title}, {blog.Posts[1].Title}");
+            await InsertOrUpdateGraph(context, (object)blog);
+        }
+
+        using (var context = new BloggingContext())
+        {
+            var read = await context.Blogs.Include(b => b.Posts).SingleAsync(b => b.BlogId == blog.BlogId);
+            Console.WriteLine($"  Found with URL {read.Url} and {read.Posts[0].Title}, {read.Posts[1].Title}");
+        }
+
+        using (var context = new BloggingContext())
+        {
+            blog.Url = "https://sample.com";
+            blog.Posts[0].Title = "Post A";
+            blog.Posts[1].Title = "Post B";
+            blog.Posts.Add(new Post { Title = "New Post" });
+
+            Console.WriteLine($"  Updating with URL {blog.Url}");
+            await InsertOrUpdateGraph(context, (object)blog);
+        }
+
+        using (var context = new BloggingContext())
+        {
+            var read = await context.Blogs.Include(b => b.Posts).SingleAsync(b => b.BlogId == blog.BlogId);
+            Console.WriteLine($"  Found with URL {read.Url} and {read.Posts[0].Title}, {read.Posts[1].Title}, {read.Posts[2].Title}");
+        }
+    }
+
+    private static async Task InsertOrUpdateGraphFind()
+    {
+        Console.WriteLine();
+        Console.WriteLine("Save graph with any kind of key:");
+        var blog = CreateBlogAndPosts();
+
+        using (var context = new BloggingContext())
+        {
+            Console.WriteLine($"  Inserting with URL {blog.Url} and {blog.Posts[0].Title}, {blog.Posts[1].Title}");
+            await InsertOrUpdateGraph(context, blog);
+        }
+
+        using (var context = new BloggingContext())
+        {
+            var read = await context.Blogs.Include(b => b.Posts).SingleAsync(b => b.BlogId == blog.BlogId);
+            Console.WriteLine($"  Found with URL {read.Url} and {read.Posts[0].Title}, {read.Posts[1].Title}");
+        }
+
+        using (var context = new BloggingContext())
+        {
+            blog.Url = "https://sample.com";
+            blog.Posts[0].Title = "Post A";
+            blog.Posts[1].Title = "Post B";
+            blog.Posts.Add(new Post { Title = "New Post" });
+
+            Console.WriteLine($"  Updating with URL {blog.Url}");
+            await InsertOrUpdateGraph(context, blog);
+        }
+
+        using (var context = new BloggingContext())
+        {
+            var read = await context.Blogs.Include(b => b.Posts).SingleAsync(b => b.BlogId == blog.BlogId);
+            Console.WriteLine($"  Found with URL {read.Url} and {read.Posts[0].Title}, {read.Posts[1].Title}, {read.Posts[2].Title}");
+        }
+    }
+
+    private static async Task InsertUpdateOrDeleteGraphFind()
+    {
+        Console.WriteLine();
+        Console.WriteLine("Save graph with deletes and any kind of key:");
+        var blog = CreateBlogAndPosts();
+
+        using (var context = new BloggingContext())
+        {
+            Console.WriteLine($"  Inserting with URL {blog.Url} and {blog.Posts[0].Title}, {blog.Posts[1].Title}");
+            await InsertUpdateOrDeleteGraph(context, blog);
+        }
+
+        using (var context = new BloggingContext())
+        {
+            var read = await context.Blogs.Include(b => b.Posts).SingleAsync(b => b.BlogId == blog.BlogId);
+            Console.WriteLine($"  Found with URL {read.Url} and {read.Posts[0].Title}, {read.Posts[1].Title}");
+        }
+
+        using (var context = new BloggingContext())
+        {
+            blog.Url = "https://sample.com";
+            blog.Posts[0].Title = "Post A";
+            blog.Posts.Remove(blog.Posts[1]);
+            blog.Posts.Add(new Post { Title = "New Post" });
+
+            Console.WriteLine($"  Updating with URL {blog.Url}");
+            await InsertUpdateOrDeleteGraph(context, blog);
+        }
+
+        using (var context = new BloggingContext())
+        {
+            var read = await context.Blogs.Include(b => b.Posts).SingleAsync(b => b.BlogId == blog.BlogId);
+            Console.WriteLine($"  Found with URL {read.Url} and {read.Posts[0].Title}, {read.Posts[1].Title}");
+        }
+    }
+
+    private static async Task InsertUpdateOrDeleteTrackGraph()
+    {
+        Console.WriteLine();
+        Console.WriteLine("Save graph using TrackGraph:");
+        var blog = CreateBlogAndPosts();
+        blog.IsNew = true;
+        blog.Posts[0].IsNew = true;
+        blog.Posts[1].IsNew = true;
+
+        using (var context = new BloggingContext())
+        {
+            Console.WriteLine($"  Inserting with URL {blog.Url} and {blog.Posts[0].Title}, {blog.Posts[1].Title}");
+            await SaveAnnotatedGraph(context, blog);
+        }
+
+        using (var context = new BloggingContext())
+        {
+            var read = await context.Blogs.Include(b => b.Posts).SingleAsync(b => b.BlogId == blog.BlogId);
+            Console.WriteLine($"  Found with URL {read.Url} and {read.Posts[0].Title}, {read.Posts[1].Title}");
+        }
+
+        blog.IsNew = false;
+        blog.Posts[0].IsNew = false;
+        blog.Posts[1].IsNew = false;
+
+        using (var context = new BloggingContext())
+        {
+            blog.Url = "https://sample.com";
+            blog.IsChanged = true;
+            blog.Posts[0].Title = "Post A";
+            blog.Posts[0].IsDeleted = true;
+            blog.Posts[1].Title = "Post B";
+            blog.Posts.Add(new Post { Title = "New Post", IsNew = true });
+
+            Console.WriteLine($"  Updating with URL {blog.Url}");
+            await SaveAnnotatedGraph(context, blog);
+        }
+
+        using (var context = new BloggingContext())
+        {
+            var read = await context.Blogs.Include(b => b.Posts).SingleAsync(b => b.BlogId == blog.BlogId);
+            Console.WriteLine($"  Found with URL {read.Url} and {read.Posts[0].Title}, {read.Posts[1].Title}");
+        }
+    }
+
+    #region IsItNewSimple
+    public static bool IsItNew(Blog blog)
+        => blog.BlogId == 0;
+    #endregion
+
+    #region IsItNewGeneral
+    public static bool IsItNew(DbContext context, object entity)
+        => !context.Entry(entity).IsKeySet;
+    #endregion
+
+    #region IsItNewQuery
+    public static async Task<bool> IsItNew(BloggingContext context, Blog blog)
+        => (await context.Blogs.FindAsync(blog.BlogId)) == null;
+    #endregion
+
+    #region InsertAndUpdateSingleEntity
+    public static async Task Insert(DbContext context, object entity)
+    {
+        context.Add(entity);
+        await context.SaveChangesAsync();
+    }
+
+    public static async Task Update(DbContext context, object entity)
+    {
+        context.Update(entity);
+        await context.SaveChangesAsync();
+    }
+    #endregion
+
+    #region InsertOrUpdateSingleEntity
+    public static async Task InsertOrUpdate(DbContext context, object entity)
+    {
+        context.Update(entity);
+        await context.SaveChangesAsync();
+    }
+    #endregion
+
+    #region InsertOrUpdateSingleEntityWithFind
+    public static async Task InsertOrUpdate(BloggingContext context, Blog blog)
+    {
+        var existingBlog = await context.Blogs.FindAsync(blog.BlogId);
+        if (existingBlog == null)
+        {
+            context.Add(blog);
+        }
+        else
+        {
+            context.Entry(existingBlog).CurrentValues.SetValues(blog);
+        }
+
+        await context.SaveChangesAsync();
+    }
+    #endregion
+
+    private static Blog CreateBlogAndPosts()
+    {
+        #region CreateBlogAndPosts
+        var blog = new Blog
+        {
+            Url = "http://sample.com", Posts = new List<Post> { new Post { Title = "Post 1" }, new Post { Title = "Post 2" }, }
+        };
+        #endregion
+
+        return blog;
+    }
+
+    #region InsertGraph
+    public static async Task InsertGraph(DbContext context, object rootEntity)
+    {
+        context.Add(rootEntity);
+        await context.SaveChangesAsync();
+    }
+    #endregion
+
+    #region UpdateGraph
+    public static async Task UpdateGraph(DbContext context, object rootEntity)
+    {
+        context.Update(rootEntity);
+        await context.SaveChangesAsync();
+    }
+    #endregion
+
+    #region InsertOrUpdateGraph
+    public static async Task InsertOrUpdateGraph(DbContext context, object rootEntity)
+    {
+        context.Update(rootEntity);
+        await context.SaveChangesAsync();
+    }
+    #endregion
+
+    #region InsertOrUpdateGraphWithFind
+    public static async Task InsertOrUpdateGraph(BloggingContext context, Blog blog)
+    {
+        var existingBlog = await context.Blogs
+            .Include(b => b.Posts)
+            .FirstOrDefaultAsync(b => b.BlogId == blog.BlogId);
+
+        if (existingBlog == null)
+        {
+            context.Add(blog);
+        }
+        else
+        {
+            context.Entry(existingBlog).CurrentValues.SetValues(blog);
+            foreach (var post in blog.Posts)
+            {
+                var existingPost = existingBlog.Posts
+                    .FirstOrDefault(p => p.PostId == post.PostId);
+
+                if (existingPost == null)
+                {
+                    existingBlog.Posts.Add(post);
+                }
+                else
+                {
+                    context.Entry(existingPost).CurrentValues.SetValues(post);
+                }
+            }
+        }
+
+        await context.SaveChangesAsync();
+    }
+    #endregion
+
+    #region InsertUpdateOrDeleteGraphWithFind
+    public static async Task InsertUpdateOrDeleteGraph(BloggingContext context, Blog blog)
+    {
+        var existingBlog = await context.Blogs
+            .Include(b => b.Posts)
+            .FirstOrDefaultAsync(b => b.BlogId == blog.BlogId);
+
+        if (existingBlog == null)
+        {
+            context.Add(blog);
+        }
+        else
+        {
+            context.Entry(existingBlog).CurrentValues.SetValues(blog);
+            foreach (var post in blog.Posts)
+            {
+                var existingPost = existingBlog.Posts
+                    .FirstOrDefault(p => p.PostId == post.PostId);
+
+                if (existingPost == null)
+                {
+                    existingBlog.Posts.Add(post);
+                }
+                else
+                {
+                    context.Entry(existingPost).CurrentValues.SetValues(post);
+                }
+            }
+
+            foreach (var post in existingBlog.Posts)
+            {
+                if (!blog.Posts.Any(p => p.PostId == post.PostId))
+                {
+                    context.Remove(post);
+                }
+            }
+        }
+
+        await context.SaveChangesAsync();
+    }
+    #endregion
+
+    #region TrackGraph
+    public static async Task SaveAnnotatedGraph(DbContext context, object rootEntity)
+    {
+        context.ChangeTracker.TrackGraph(
+            rootEntity,
+            n =>
+            {
+                var entity = (EntityBase)n.Entry.Entity;
+                n.Entry.State = entity.IsNew
+                    ? EntityState.Added
+                    : entity.IsChanged
+                        ? EntityState.Modified
+                        : entity.IsDeleted
+                            ? EntityState.Deleted
+                            : EntityState.Unchanged;
+            });
+
+        await context.SaveChangesAsync();
+    }
+    #endregion
+}
diff --git a/samples/core/Saving/Program.cs b/samples/core/Saving/Program.cs
new file mode 100644
index 0000000000..861e1463ee
--- /dev/null
+++ b/samples/core/Saving/Program.cs
@@ -0,0 +1,22 @@
+using System.Threading.Tasks;
+using EFSaving.Basics;
+using EFSaving.Transactions;
+
+namespace EFSaving;
+
+internal class Program
+{
+    private static async Task Main(string[] args)
+    {
+        await Sample.Run();
+        await RelatedData.Sample.Run();
+        await CascadeDelete.Sample.Run();
+        await Concurrency.BasicSample.Run();
+        await Concurrency.ConflictResolutionSample.Run();
+        await ControllingTransaction.Run();
+        await ManagingSavepoints.Run();
+        await SharingTransaction.Run();
+        await ExternalDbTransaction.Run();
+        await Disconnected.Sample.Run();
+    }
+}
diff --git a/samples/core/Saving/RelatedData/Sample.cs b/samples/core/Saving/RelatedData/Sample.cs
new file mode 100644
index 0000000000..83d03cda51
--- /dev/null
+++ b/samples/core/Saving/RelatedData/Sample.cs
@@ -0,0 +1,100 @@
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFSaving.RelatedData;
+
+public class Sample
+{
+    public static async Task Run()
+    {
+        using (var context = new BloggingContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        #region AddingGraphOfEntities
+        using (var context = new BloggingContext())
+        {
+            var blog = new Blog
+            {
+                Url = "http://blogs.msdn.com/dotnet",
+                Posts = new List<Post>
+                {
+                    new Post { Title = "Intro to C#" },
+                    new Post { Title = "Intro to VB.NET" },
+                    new Post { Title = "Intro to F#" }
+                }
+            };
+
+            context.Blogs.Add(blog);
+            await context.SaveChangesAsync();
+        }
+        #endregion
+
+        #region AddingRelatedEntity
+        using (var context = new BloggingContext())
+        {
+            var blog = await context.Blogs.Include(b => b.Posts).FirstAsync();
+            var post = new Post { Title = "Intro to EF Core" };
+
+            blog.Posts.Add(post);
+            await context.SaveChangesAsync();
+        }
+        #endregion
+
+        #region ChangingRelationships
+        using (var context = new BloggingContext())
+        {
+            var blog = new Blog { Url = "http://blogs.msdn.com/visualstudio" };
+            var post = await context.Posts.FirstAsync();
+
+            post.Blog = blog;
+            await context.SaveChangesAsync();
+        }
+        #endregion
+
+        #region RemovingRelationships
+        using (var context = new BloggingContext())
+        {
+            var blog = await context.Blogs.Include(b => b.Posts).FirstAsync();
+            var post = blog.Posts.First();
+
+            blog.Posts.Remove(post);
+            await context.SaveChangesAsync();
+        }
+        #endregion
+    }
+
+    public class BloggingContext : DbContext
+    {
+        public DbSet<Blog> Blogs { get; set; }
+        public DbSet<Post> Posts { get; set; }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder.UseSqlServer(
+                @"Server=(localdb)\mssqllocaldb;Database=EFSaving.RelatedData;Trusted_Connection=True;ConnectRetryCount=0");
+        }
+    }
+
+    public class Blog
+    {
+        public int BlogId { get; set; }
+        public string Url { get; set; }
+
+        public List<Post> Posts { get; set; }
+    }
+
+    public class Post
+    {
+        public int PostId { get; set; }
+        public string Title { get; set; }
+        public string Content { get; set; }
+
+        public int BlogId { get; set; }
+        public Blog Blog { get; set; }
+    }
+}
diff --git a/samples/core/Saving/Saving.csproj b/samples/core/Saving/Saving.csproj
new file mode 100644
index 0000000000..c3916a64d3
--- /dev/null
+++ b/samples/core/Saving/Saving.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EFSaving</RootNamespace>
+    <AssemblyName>EFSaving</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Saving/Transactions/AmbientTransaction.cs b/samples/core/Saving/Transactions/AmbientTransaction.cs
new file mode 100644
index 0000000000..55e9b29c88
--- /dev/null
+++ b/samples/core/Saving/Transactions/AmbientTransaction.cs
@@ -0,0 +1,78 @@
+using System;
+using System.Threading.Tasks;
+using System.Transactions;
+using Microsoft.Data.SqlClient;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFSaving.Transactions;
+
+public class AmbientTransaction
+{
+    public static async Task Run()
+    {
+        var connectionString =
+            @"Server=(localdb)\mssqllocaldb;Database=EFSaving.Transactions;Trusted_Connection=True;ConnectRetryCount=0";
+
+        using (var context = new BloggingContext(
+                   new DbContextOptionsBuilder<BloggingContext>()
+                       .UseSqlServer(connectionString)
+                       .Options))
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        #region Transaction
+        using (var scope = new TransactionScope(
+                   TransactionScopeOption.Required,
+                   new TransactionOptions { IsolationLevel = IsolationLevel.ReadCommitted }))
+        {
+            using var connection = new SqlConnection(connectionString);
+            await connection.OpenAsync();
+
+            try
+            {
+                // Run raw ADO.NET command in the transaction
+                var command = connection.CreateCommand();
+                command.CommandText = "DELETE FROM dbo.Blogs";
+                await command.ExecuteNonQueryAsync();
+
+                // Run an EF Core command in the transaction
+                var options = new DbContextOptionsBuilder<BloggingContext>()
+                    .UseSqlServer(connection)
+                    .Options;
+
+                using (var context = new BloggingContext(options))
+                {
+                    context.Blogs.Add(new Blog { Url = "http://blogs.msdn.com/dotnet" });
+                    await context.SaveChangesAsync();
+                }
+
+                // Commit transaction if all commands succeed, transaction will auto-rollback
+                // when disposed if either commands fails
+                scope.Complete();
+            }
+            catch (Exception)
+            {
+                // TODO: Handle failure
+            }
+        }
+        #endregion
+    }
+
+    public class BloggingContext : DbContext
+    {
+        public BloggingContext(DbContextOptions<BloggingContext> options)
+            : base(options)
+        {
+        }
+
+        public DbSet<Blog> Blogs { get; set; }
+    }
+
+    public class Blog
+    {
+        public int BlogId { get; set; }
+        public string Url { get; set; }
+    }
+}
diff --git a/samples/core/Saving/Transactions/CommitableTransaction.cs b/samples/core/Saving/Transactions/CommitableTransaction.cs
new file mode 100644
index 0000000000..dd834bd477
--- /dev/null
+++ b/samples/core/Saving/Transactions/CommitableTransaction.cs
@@ -0,0 +1,80 @@
+using System;
+using System.Threading.Tasks;
+using System.Transactions;
+using Microsoft.Data.SqlClient;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFSaving.Transactions;
+
+public class CommitableTransaction
+{
+    public static async Task Run()
+    {
+        var connectionString =
+            @"Server=(localdb)\mssqllocaldb;Database=EFSaving.Transactions;Trusted_Connection=True;ConnectRetryCount=0";
+
+        using (var context = new BloggingContext(
+                   new DbContextOptionsBuilder<BloggingContext>()
+                       .UseSqlServer(connectionString)
+                       .Options))
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        #region Transaction
+        using (var transaction = new CommittableTransaction(
+                   new TransactionOptions { IsolationLevel = IsolationLevel.ReadCommitted }))
+        {
+            var connection = new SqlConnection(connectionString);
+
+            try
+            {
+                var options = new DbContextOptionsBuilder<BloggingContext>()
+                    .UseSqlServer(connection)
+                    .Options;
+
+                using (var context = new BloggingContext(options))
+                {
+                    await context.Database.OpenConnectionAsync();
+                    context.Database.EnlistTransaction(transaction);
+
+                    // Run raw ADO.NET command in the transaction
+                    var command = connection.CreateCommand();
+                    command.CommandText = "DELETE FROM dbo.Blogs";
+                    await command.ExecuteNonQueryAsync();
+
+                    // Run an EF Core command in the transaction
+                    context.Blogs.Add(new Blog { Url = "http://blogs.msdn.com/dotnet" });
+                    await context.SaveChangesAsync();
+                    await context.Database.CloseConnectionAsync();
+                }
+
+                // Commit transaction if all commands succeed, transaction will auto-rollback
+                // when disposed if either commands fails
+                transaction.Commit();
+            }
+            catch (Exception)
+            {
+                // TODO: Handle failure
+            }
+        }
+        #endregion
+    }
+
+    public class BloggingContext : DbContext
+    {
+        public BloggingContext(DbContextOptions<BloggingContext> options)
+            : base(options)
+        {
+        }
+
+        public DbSet<Blog> Blogs { get; set; }
+    }
+
+    public class Blog
+    {
+        public int BlogId { get; set; }
+        public string Url { get; set; }
+    }
+}
diff --git a/samples/core/Saving/Transactions/ControllingTransaction.cs b/samples/core/Saving/Transactions/ControllingTransaction.cs
new file mode 100644
index 0000000000..2e043bd9ac
--- /dev/null
+++ b/samples/core/Saving/Transactions/ControllingTransaction.cs
@@ -0,0 +1,61 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFSaving.Transactions;
+
+public class ControllingTransaction
+{
+    public static async Task Run()
+    {
+        using (var setupContext = new BloggingContext())
+        {
+            await setupContext.Database.EnsureDeletedAsync();
+            await setupContext.Database.EnsureCreatedAsync();
+        }
+
+        #region Transaction
+        using var context = new BloggingContext();
+        await using var transaction = await context.Database.BeginTransactionAsync();
+
+        try
+        {
+            context.Blogs.Add(new Blog { Url = "http://blogs.msdn.com/dotnet" });
+            await context.SaveChangesAsync();
+
+            context.Blogs.Add(new Blog { Url = "http://blogs.msdn.com/visualstudio" });
+            await context.SaveChangesAsync();
+
+            var blogs = await context.Blogs
+                .OrderBy(b => b.Url)
+                .ToListAsync();
+
+            // Commit transaction if all commands succeed, transaction will auto-rollback
+            // when disposed if either commands fails
+            await transaction.CommitAsync();
+        }
+        catch (Exception)
+        {
+            // TODO: Handle failure
+        }
+        #endregion
+    }
+
+    public class BloggingContext : DbContext
+    {
+        public DbSet<Blog> Blogs { get; set; }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder.UseSqlServer(
+                @"Server=(localdb)\mssqllocaldb;Database=EFSaving.Transactions;Trusted_Connection=True;ConnectRetryCount=0");
+        }
+    }
+
+    public class Blog
+    {
+        public int BlogId { get; set; }
+        public string Url { get; set; }
+    }
+}
diff --git a/samples/core/Saving/Transactions/ExternalDbTransaction.cs b/samples/core/Saving/Transactions/ExternalDbTransaction.cs
new file mode 100644
index 0000000000..0ea8f878e1
--- /dev/null
+++ b/samples/core/Saving/Transactions/ExternalDbTransaction.cs
@@ -0,0 +1,75 @@
+using System;
+using System.Threading.Tasks;
+using Microsoft.Data.SqlClient;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFSaving.Transactions;
+
+public class ExternalDbTransaction
+{
+    public static async Task Run()
+    {
+        var connectionString =
+            @"Server=(localdb)\mssqllocaldb;Database=EFSaving.Transactions;Trusted_Connection=True;ConnectRetryCount=0";
+
+        using (var context = new BloggingContext(
+                   new DbContextOptionsBuilder<BloggingContext>()
+                       .UseSqlServer(connectionString)
+                       .Options))
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        #region Transaction
+        using var connection = new SqlConnection(connectionString);
+        await connection.OpenAsync();
+
+        await using var transaction = (SqlTransaction)await connection.BeginTransactionAsync();
+        try
+        {
+            // Run raw ADO.NET command in the transaction
+            var command = connection.CreateCommand();
+            command.Transaction = transaction;
+            command.CommandText = "DELETE FROM dbo.Blogs";
+            command.ExecuteNonQuery();
+
+            // Run an EF Core command in the transaction
+            var options = new DbContextOptionsBuilder<BloggingContext>()
+                .UseSqlServer(connection)
+                .Options;
+
+            using (var context = new BloggingContext(options))
+            {
+                await context.Database.UseTransactionAsync(transaction);
+                context.Blogs.Add(new Blog { Url = "http://blogs.msdn.com/dotnet" });
+                await context.SaveChangesAsync();
+            }
+
+            // Commit transaction if all commands succeed, transaction will auto-rollback
+            // when disposed if either commands fails
+            await transaction.CommitAsync();
+        }
+        catch (Exception)
+        {
+            // TODO: Handle failure
+        }
+        #endregion
+    }
+
+    public class BloggingContext : DbContext
+    {
+        public BloggingContext(DbContextOptions<BloggingContext> options)
+            : base(options)
+        {
+        }
+
+        public DbSet<Blog> Blogs { get; set; }
+    }
+
+    public class Blog
+    {
+        public int BlogId { get; set; }
+        public string Url { get; set; }
+    }
+}
diff --git a/samples/core/Saving/Transactions/ManagingSavepoints.cs b/samples/core/Saving/Transactions/ManagingSavepoints.cs
new file mode 100644
index 0000000000..d0a5f05fac
--- /dev/null
+++ b/samples/core/Saving/Transactions/ManagingSavepoints.cs
@@ -0,0 +1,60 @@
+using System;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EFSaving.Transactions;
+
+public class ManagingSavepoints
+{
+    public static async Task Run()
+    {
+        using (var setupContext = new BloggingContext())
+        {
+            await setupContext.Database.EnsureDeletedAsync();
+            await setupContext.Database.EnsureCreatedAsync();
+        }
+
+        #region Savepoints
+        using var context = new BloggingContext();
+        await using var transaction = await context.Database.BeginTransactionAsync();
+
+        try
+        {
+            context.Blogs.Add(new Blog { Url = "https://devblogs.microsoft.com/dotnet/" });
+            await context.SaveChangesAsync();
+
+            await transaction.CreateSavepointAsync("BeforeMoreBlogs");
+
+            context.Blogs.Add(new Blog { Url = "https://devblogs.microsoft.com/visualstudio/" });
+            context.Blogs.Add(new Blog { Url = "https://devblogs.microsoft.com/aspnet/" });
+            await context.SaveChangesAsync();
+
+            await transaction.CommitAsync();
+        }
+        catch (Exception)
+        {
+            // If a failure occurred, we rollback to the savepoint and can continue the transaction
+            await transaction.RollbackToSavepointAsync("BeforeMoreBlogs");
+
+            // TODO: Handle failure, possibly retry inserting blogs
+        }
+        #endregion
+    }
+
+    public class BloggingContext : DbContext
+    {
+        public DbSet<Blog> Blogs { get; set; }
+
+        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder.UseSqlServer(
+                @"Server=(localdb)\mssqllocaldb;Database=EFSaving.Transactions;Trusted_Connection=True;ConnectRetryCount=0");
+        }
+    }
+
+    public class Blog
+    {
+        public int BlogId { get; set; }
+        public string Url { get; set; }
+    }
+}
diff --git a/samples/core/Saving/Transactions/SharingTransaction.cs b/samples/core/Saving/Transactions/SharingTransaction.cs
new file mode 100644
index 0000000000..ad7af12dad
--- /dev/null
+++ b/samples/core/Saving/Transactions/SharingTransaction.cs
@@ -0,0 +1,79 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.Data.SqlClient;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Storage;
+
+namespace EFSaving.Transactions;
+
+public class SharingTransaction
+{
+    public static async Task Run()
+    {
+        var connectionString =
+            @"Server=(localdb)\mssqllocaldb;Database=EFSaving.Transactions;Trusted_Connection=True;ConnectRetryCount=0";
+
+        using (var context = new BloggingContext(
+                   new DbContextOptionsBuilder<BloggingContext>()
+                       .UseSqlServer(connectionString)
+                       .Options))
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        #region Transaction
+        using var connection = new SqlConnection(connectionString);
+        var options = new DbContextOptionsBuilder<BloggingContext>()
+            .UseSqlServer(connection)
+            .Options;
+
+        using var context1 = new BloggingContext(options);
+        await using var transaction = await context1.Database.BeginTransactionAsync();
+        try
+        {
+            context1.Blogs.Add(new Blog { Url = "http://blogs.msdn.com/dotnet" });
+            await context1.SaveChangesAsync();
+
+            using (var context2 = new BloggingContext(options))
+            {
+                await context2.Database.UseTransactionAsync(transaction.GetDbTransaction());
+
+                var blogs = await context2.Blogs
+                    .OrderBy(b => b.Url)
+                    .ToListAsync();
+
+                context2.Blogs.Add(new Blog { Url = "http://dot.net" });
+                await context2.SaveChangesAsync();
+            }
+
+            // Commit transaction if all commands succeed, transaction will auto-rollback
+            // when disposed if either commands fails
+            await transaction.CommitAsync();
+        }
+        catch (Exception)
+        {
+            // TODO: Handle failure
+        }
+        #endregion
+    }
+
+    #region Context
+    public class BloggingContext : DbContext
+    {
+        public BloggingContext(DbContextOptions<BloggingContext> options)
+            : base(options)
+        {
+        }
+
+        public DbSet<Blog> Blogs { get; set; }
+    }
+    #endregion
+
+    public class Blog
+    {
+        public int BlogId { get; set; }
+        public string Url { get; set; }
+    }
+}
diff --git a/samples/core/Schemas/Migrations/CustomOperation.cs b/samples/core/Schemas/Migrations/CustomOperation.cs
new file mode 100644
index 0000000000..afa709dea2
--- /dev/null
+++ b/samples/core/Schemas/Migrations/CustomOperation.cs
@@ -0,0 +1,85 @@
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Migrations.Operations;
+using Microsoft.EntityFrameworkCore.Migrations.Operations.Builders;
+using Microsoft.EntityFrameworkCore.Update;
+
+#region snippet_CreateUserOperation
+public class CreateUserOperation : MigrationOperation
+{
+    public string Name { get; set; }
+    public string Password { get; set; }
+}
+#endregion
+
+internal static class MigrationBuilderExtensions
+{
+    #region snippet_MigrationBuilderExtension
+    public static OperationBuilder<CreateUserOperation> CreateUser(
+        this MigrationBuilder migrationBuilder,
+        string name,
+        string password)
+    {
+        var operation = new CreateUserOperation { Name = name, Password = password };
+        migrationBuilder.Operations.Add(operation);
+
+        return new OperationBuilder<CreateUserOperation>(operation);
+    }
+    #endregion
+}
+
+#region snippet_MigrationsSqlGenerator
+public class MyMigrationsSqlGenerator : SqlServerMigrationsSqlGenerator
+{
+    public MyMigrationsSqlGenerator(
+        MigrationsSqlGeneratorDependencies dependencies,
+        ICommandBatchPreparer commandBatchPreparer)
+        : base(dependencies, commandBatchPreparer)
+    {
+    }
+
+    protected override void Generate(
+        MigrationOperation operation,
+        IModel model,
+        MigrationCommandListBuilder builder)
+    {
+        if (operation is CreateUserOperation createUserOperation)
+        {
+            Generate(createUserOperation, builder);
+        }
+        else
+        {
+            base.Generate(operation, model, builder);
+        }
+    }
+
+    private void Generate(
+        CreateUserOperation operation,
+        MigrationCommandListBuilder builder)
+    {
+        var sqlHelper = Dependencies.SqlGenerationHelper;
+        var stringMapping = Dependencies.TypeMappingSource.FindMapping(typeof(string));
+
+        builder
+            .Append("CREATE USER ")
+            .Append(sqlHelper.DelimitIdentifier(operation.Name))
+            .Append(" WITH PASSWORD = ")
+            .Append(stringMapping.GenerateSqlLiteral(operation.Password))
+            .AppendLine(sqlHelper.StatementTerminator)
+            .EndCommand();
+    }
+}
+#endregion
+
+internal class CustomOperationContext : DbContext
+{
+    private readonly string _connectionString = @"Data Source=(localdb)\MSSQLLocalDB;Initial Catalog=Sample;ConnectRetryCount=0";
+
+    #region snippet_OnConfiguring
+    protected override void OnConfiguring(DbContextOptionsBuilder options)
+        => options
+            .UseSqlServer(_connectionString)
+            .ReplaceService<IMigrationsSqlGenerator, MyMigrationsSqlGenerator>();
+    #endregion
+}
diff --git a/samples/core/Schemas/Migrations/CustomOperationMultiSql.cs b/samples/core/Schemas/Migrations/CustomOperationMultiSql.cs
new file mode 100644
index 0000000000..36f15a2b60
--- /dev/null
+++ b/samples/core/Schemas/Migrations/CustomOperationMultiSql.cs
@@ -0,0 +1,28 @@
+using System;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Migrations.Operations;
+using Microsoft.EntityFrameworkCore.Migrations.Operations.Builders;
+
+internal static class MultiSqlMigrationBuilderExtensions
+{
+    #region snippet_CustomOperationMultiSql
+    public static OperationBuilder<SqlOperation> CreateUser(
+        this MigrationBuilder migrationBuilder,
+        string name,
+        string password)
+    {
+        switch (migrationBuilder.ActiveProvider)
+        {
+            case "Npgsql.EntityFrameworkCore.PostgreSQL":
+                return migrationBuilder
+                    .Sql($"CREATE USER {name} WITH PASSWORD '{password}';");
+
+            case "Microsoft.EntityFrameworkCore.SqlServer":
+                return migrationBuilder
+                    .Sql($"CREATE USER {name} WITH PASSWORD = '{password}';");
+        }
+
+        throw new Exception("Unexpected provider.");
+    }
+    #endregion
+}
diff --git a/samples/core/Schemas/Migrations/CustomOperationSql.cs b/samples/core/Schemas/Migrations/CustomOperationSql.cs
new file mode 100644
index 0000000000..65400f0709
--- /dev/null
+++ b/samples/core/Schemas/Migrations/CustomOperationSql.cs
@@ -0,0 +1,14 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Migrations.Operations;
+using Microsoft.EntityFrameworkCore.Migrations.Operations.Builders;
+
+internal static class SqlMigrationBuilderExtensions
+{
+    #region snippet_CustomOperationSql
+    public static OperationBuilder<SqlOperation> CreateUser(
+        this MigrationBuilder migrationBuilder,
+        string name,
+        string password)
+        => migrationBuilder.Sql($"CREATE USER {name} WITH PASSWORD '{password}';");
+    #endregion
+}
diff --git a/samples/core/Schemas/Migrations/MigrationTableNameContext.cs b/samples/core/Schemas/Migrations/MigrationTableNameContext.cs
new file mode 100644
index 0000000000..8d0d343d78
--- /dev/null
+++ b/samples/core/Schemas/Migrations/MigrationTableNameContext.cs
@@ -0,0 +1,15 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace Migrations;
+
+public class MigrationTableNameContext : DbContext
+{
+    private readonly string _connectionString = @"Data Source=(localdb)\MSSQLLocalDB;Initial Catalog=Sample;ConnectRetryCount=0";
+
+    #region TableNameContext
+    protected override void OnConfiguring(DbContextOptionsBuilder options)
+        => options.UseSqlServer(
+            _connectionString,
+            x => x.MigrationsHistoryTable("__MyMigrationsHistory", "mySchema"));
+    #endregion
+}
diff --git a/samples/core/Schemas/Migrations/Migrations.csproj b/samples/core/Schemas/Migrations/Migrations.csproj
new file mode 100644
index 0000000000..03a528defa
--- /dev/null
+++ b/samples/core/Schemas/Migrations/Migrations.csproj
@@ -0,0 +1,11 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Schemas/Migrations/MyHistoryRepository.cs b/samples/core/Schemas/Migrations/MyHistoryRepository.cs
new file mode 100644
index 0000000000..a5b7413115
--- /dev/null
+++ b/samples/core/Schemas/Migrations/MyHistoryRepository.cs
@@ -0,0 +1,37 @@
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Metadata.Builders;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.SqlServer.Migrations.Internal;
+
+#pragma warning disable EF1001
+
+namespace Migrations;
+
+public class MyHistoryRepositoryContext : DbContext
+{
+    private readonly string _connectionString = @"Data Source=(localdb)\MSSQLLocalDB;Initial Catalog=Sample;ConnectRetryCount=0";
+
+    #region HistoryRepositoryContext
+    protected override void OnConfiguring(DbContextOptionsBuilder options)
+        => options
+            .UseSqlServer(_connectionString)
+            .ReplaceService<IHistoryRepository, MyHistoryRepository>();
+    #endregion
+}
+
+#region HistoryRepository
+internal class MyHistoryRepository : SqlServerHistoryRepository
+{
+    public MyHistoryRepository(HistoryRepositoryDependencies dependencies)
+        : base(dependencies)
+    {
+    }
+
+    protected override void ConfigureTable(EntityTypeBuilder<HistoryRow> history)
+    {
+        base.ConfigureTable(history);
+
+        history.Property(h => h.MigrationId).HasColumnName("Id");
+    }
+}
+#endregion
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1.Data/ApplicationDbContext.cs b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1.Data/ApplicationDbContext.cs
new file mode 100644
index 0000000000..31aad0e2cf
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1.Data/ApplicationDbContext.cs
@@ -0,0 +1,12 @@
+using Microsoft.AspNetCore.Identity.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore;
+
+namespace WebApplication1.Data;
+
+public class ApplicationDbContext : IdentityDbContext
+{
+    public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options)
+        : base(options)
+    {
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1.Data/WebApplication1.Data.csproj b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1.Data/WebApplication1.Data.csproj
new file mode 100644
index 0000000000..1f26261919
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1.Data/WebApplication1.Data.csproj
@@ -0,0 +1,12 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.AspNetCore.Identity.EntityFrameworkCore" Version="7.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1.Migrations/00000000000000_CreateIdentitySchema.Designer.cs b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1.Migrations/00000000000000_CreateIdentitySchema.Designer.cs
new file mode 100644
index 0000000000..1f322dbaa0
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1.Migrations/00000000000000_CreateIdentitySchema.Designer.cs
@@ -0,0 +1,277 @@
+// <auto-generated />
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using WebApplication1.Data;
+
+namespace WebApplication1.Migrations
+{
+    [DbContext(typeof(ApplicationDbContext))]
+    [Migration("00000000000000_CreateIdentitySchema")]
+    partial class CreateIdentitySchema
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "3.0.0")
+                .HasAnnotation("Relational:MaxIdentifierLength", 128)
+                .HasAnnotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn);
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityRole", b =>
+                {
+                    b.Property<string>("Id")
+                        .HasColumnType("nvarchar(450)");
+
+                    b.Property<string>("ConcurrencyStamp")
+                        .IsConcurrencyToken()
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("Name")
+                        .HasColumnType("nvarchar(256)")
+                        .HasMaxLength(256);
+
+                    b.Property<string>("NormalizedName")
+                        .HasColumnType("nvarchar(256)")
+                        .HasMaxLength(256);
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("NormalizedName")
+                        .IsUnique()
+                        .HasName("RoleNameIndex")
+                        .HasFilter("[NormalizedName] IS NOT NULL");
+
+                    b.ToTable("AspNetRoles");
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityRoleClaim<string>", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("int")
+                        .HasAnnotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn);
+
+                    b.Property<string>("ClaimType")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("ClaimValue")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("RoleId")
+                        .IsRequired()
+                        .HasColumnType("nvarchar(450)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("RoleId");
+
+                    b.ToTable("AspNetRoleClaims");
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUser", b =>
+                {
+                    b.Property<string>("Id")
+                        .HasColumnType("nvarchar(450)");
+
+                    b.Property<int>("AccessFailedCount")
+                        .HasColumnType("int");
+
+                    b.Property<string>("ConcurrencyStamp")
+                        .IsConcurrencyToken()
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("Email")
+                        .HasColumnType("nvarchar(256)")
+                        .HasMaxLength(256);
+
+                    b.Property<bool>("EmailConfirmed")
+                        .HasColumnType("bit");
+
+                    b.Property<bool>("LockoutEnabled")
+                        .HasColumnType("bit");
+
+                    b.Property<DateTimeOffset?>("LockoutEnd")
+                        .HasColumnType("datetimeoffset");
+
+                    b.Property<string>("NormalizedEmail")
+                        .HasColumnType("nvarchar(256)")
+                        .HasMaxLength(256);
+
+                    b.Property<string>("NormalizedUserName")
+                        .HasColumnType("nvarchar(256)")
+                        .HasMaxLength(256);
+
+                    b.Property<string>("PasswordHash")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("PhoneNumber")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<bool>("PhoneNumberConfirmed")
+                        .HasColumnType("bit");
+
+                    b.Property<string>("SecurityStamp")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<bool>("TwoFactorEnabled")
+                        .HasColumnType("bit");
+
+                    b.Property<string>("UserName")
+                        .HasColumnType("nvarchar(256)")
+                        .HasMaxLength(256);
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("NormalizedEmail")
+                        .HasName("EmailIndex");
+
+                    b.HasIndex("NormalizedUserName")
+                        .IsUnique()
+                        .HasName("UserNameIndex")
+                        .HasFilter("[NormalizedUserName] IS NOT NULL");
+
+                    b.ToTable("AspNetUsers");
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserClaim<string>", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("int")
+                        .HasAnnotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn);
+
+                    b.Property<string>("ClaimType")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("ClaimValue")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("UserId")
+                        .IsRequired()
+                        .HasColumnType("nvarchar(450)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("UserId");
+
+                    b.ToTable("AspNetUserClaims");
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserLogin<string>", b =>
+                {
+                    b.Property<string>("LoginProvider")
+                        .HasColumnType("nvarchar(128)")
+                        .HasMaxLength(128);
+
+                    b.Property<string>("ProviderKey")
+                        .HasColumnType("nvarchar(128)")
+                        .HasMaxLength(128);
+
+                    b.Property<string>("ProviderDisplayName")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("UserId")
+                        .IsRequired()
+                        .HasColumnType("nvarchar(450)");
+
+                    b.HasKey("LoginProvider", "ProviderKey");
+
+                    b.HasIndex("UserId");
+
+                    b.ToTable("AspNetUserLogins");
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserRole<string>", b =>
+                {
+                    b.Property<string>("UserId")
+                        .HasColumnType("nvarchar(450)");
+
+                    b.Property<string>("RoleId")
+                        .HasColumnType("nvarchar(450)");
+
+                    b.HasKey("UserId", "RoleId");
+
+                    b.HasIndex("RoleId");
+
+                    b.ToTable("AspNetUserRoles");
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserToken<string>", b =>
+                {
+                    b.Property<string>("UserId")
+                        .HasColumnType("nvarchar(450)");
+
+                    b.Property<string>("LoginProvider")
+                        .HasColumnType("nvarchar(128)")
+                        .HasMaxLength(128);
+
+                    b.Property<string>("Name")
+                        .HasColumnType("nvarchar(128)")
+                        .HasMaxLength(128);
+
+                    b.Property<string>("Value")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.HasKey("UserId", "LoginProvider", "Name");
+
+                    b.ToTable("AspNetUserTokens");
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityRoleClaim<string>", b =>
+                {
+                    b.HasOne("Microsoft.AspNetCore.Identity.IdentityRole", null)
+                        .WithMany()
+                        .HasForeignKey("RoleId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserClaim<string>", b =>
+                {
+                    b.HasOne("Microsoft.AspNetCore.Identity.IdentityUser", null)
+                        .WithMany()
+                        .HasForeignKey("UserId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserLogin<string>", b =>
+                {
+                    b.HasOne("Microsoft.AspNetCore.Identity.IdentityUser", null)
+                        .WithMany()
+                        .HasForeignKey("UserId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserRole<string>", b =>
+                {
+                    b.HasOne("Microsoft.AspNetCore.Identity.IdentityRole", null)
+                        .WithMany()
+                        .HasForeignKey("RoleId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("Microsoft.AspNetCore.Identity.IdentityUser", null)
+                        .WithMany()
+                        .HasForeignKey("UserId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserToken<string>", b =>
+                {
+                    b.HasOne("Microsoft.AspNetCore.Identity.IdentityUser", null)
+                        .WithMany()
+                        .HasForeignKey("UserId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1.Migrations/00000000000000_CreateIdentitySchema.cs b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1.Migrations/00000000000000_CreateIdentitySchema.cs
new file mode 100644
index 0000000000..b838d47bd3
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1.Migrations/00000000000000_CreateIdentitySchema.cs
@@ -0,0 +1,210 @@
+using System;
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace WebApplication1.Migrations
+{
+    public partial class CreateIdentitySchema : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.CreateTable(
+                name: "AspNetRoles",
+                columns: table => new
+                {
+                    Id = table.Column<string>(nullable: false),
+                    Name = table.Column<string>(maxLength: 256, nullable: true),
+                    NormalizedName = table.Column<string>(maxLength: 256, nullable: true),
+                    ConcurrencyStamp = table.Column<string>(nullable: true)
+                },
+                constraints: table => { table.PrimaryKey("PK_AspNetRoles", x => x.Id); });
+
+            migrationBuilder.CreateTable(
+                name: "AspNetUsers",
+                columns: table => new
+                {
+                    Id = table.Column<string>(nullable: false),
+                    UserName = table.Column<string>(maxLength: 256, nullable: true),
+                    NormalizedUserName = table.Column<string>(maxLength: 256, nullable: true),
+                    Email = table.Column<string>(maxLength: 256, nullable: true),
+                    NormalizedEmail = table.Column<string>(maxLength: 256, nullable: true),
+                    EmailConfirmed = table.Column<bool>(nullable: false),
+                    PasswordHash = table.Column<string>(nullable: true),
+                    SecurityStamp = table.Column<string>(nullable: true),
+                    ConcurrencyStamp = table.Column<string>(nullable: true),
+                    PhoneNumber = table.Column<string>(nullable: true),
+                    PhoneNumberConfirmed = table.Column<bool>(nullable: false),
+                    TwoFactorEnabled = table.Column<bool>(nullable: false),
+                    LockoutEnd = table.Column<DateTimeOffset>(nullable: true),
+                    LockoutEnabled = table.Column<bool>(nullable: false),
+                    AccessFailedCount = table.Column<int>(nullable: false)
+                },
+                constraints: table => { table.PrimaryKey("PK_AspNetUsers", x => x.Id); });
+
+            migrationBuilder.CreateTable(
+                name: "AspNetRoleClaims",
+                columns: table => new
+                {
+                    Id = table.Column<int>(nullable: false)
+                        .Annotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn),
+                    RoleId = table.Column<string>(nullable: false),
+                    ClaimType = table.Column<string>(nullable: true),
+                    ClaimValue = table.Column<string>(nullable: true)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_AspNetRoleClaims", x => x.Id);
+                    table.ForeignKey(
+                        name: "FK_AspNetRoleClaims_AspNetRoles_RoleId",
+                        column: x => x.RoleId,
+                        principalTable: "AspNetRoles",
+                        principalColumn: "Id",
+                        onDelete: ReferentialAction.Cascade);
+                });
+
+            migrationBuilder.CreateTable(
+                name: "AspNetUserClaims",
+                columns: table => new
+                {
+                    Id = table.Column<int>(nullable: false)
+                        .Annotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn),
+                    UserId = table.Column<string>(nullable: false),
+                    ClaimType = table.Column<string>(nullable: true),
+                    ClaimValue = table.Column<string>(nullable: true)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_AspNetUserClaims", x => x.Id);
+                    table.ForeignKey(
+                        name: "FK_AspNetUserClaims_AspNetUsers_UserId",
+                        column: x => x.UserId,
+                        principalTable: "AspNetUsers",
+                        principalColumn: "Id",
+                        onDelete: ReferentialAction.Cascade);
+                });
+
+            migrationBuilder.CreateTable(
+                name: "AspNetUserLogins",
+                columns: table => new
+                {
+                    LoginProvider = table.Column<string>(maxLength: 128, nullable: false),
+                    ProviderKey = table.Column<string>(maxLength: 128, nullable: false),
+                    ProviderDisplayName = table.Column<string>(nullable: true),
+                    UserId = table.Column<string>(nullable: false)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_AspNetUserLogins", x => new { x.LoginProvider, x.ProviderKey });
+                    table.ForeignKey(
+                        name: "FK_AspNetUserLogins_AspNetUsers_UserId",
+                        column: x => x.UserId,
+                        principalTable: "AspNetUsers",
+                        principalColumn: "Id",
+                        onDelete: ReferentialAction.Cascade);
+                });
+
+            migrationBuilder.CreateTable(
+                name: "AspNetUserRoles",
+                columns: table => new { UserId = table.Column<string>(nullable: false), RoleId = table.Column<string>(nullable: false) },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_AspNetUserRoles", x => new { x.UserId, x.RoleId });
+                    table.ForeignKey(
+                        name: "FK_AspNetUserRoles_AspNetRoles_RoleId",
+                        column: x => x.RoleId,
+                        principalTable: "AspNetRoles",
+                        principalColumn: "Id",
+                        onDelete: ReferentialAction.Cascade);
+                    table.ForeignKey(
+                        name: "FK_AspNetUserRoles_AspNetUsers_UserId",
+                        column: x => x.UserId,
+                        principalTable: "AspNetUsers",
+                        principalColumn: "Id",
+                        onDelete: ReferentialAction.Cascade);
+                });
+
+            migrationBuilder.CreateTable(
+                name: "AspNetUserTokens",
+                columns: table => new
+                {
+                    UserId = table.Column<string>(nullable: false),
+                    LoginProvider = table.Column<string>(maxLength: 128, nullable: false),
+                    Name = table.Column<string>(maxLength: 128, nullable: false),
+                    Value = table.Column<string>(nullable: true)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_AspNetUserTokens", x => new { x.UserId, x.LoginProvider, x.Name });
+                    table.ForeignKey(
+                        name: "FK_AspNetUserTokens_AspNetUsers_UserId",
+                        column: x => x.UserId,
+                        principalTable: "AspNetUsers",
+                        principalColumn: "Id",
+                        onDelete: ReferentialAction.Cascade);
+                });
+
+            migrationBuilder.CreateIndex(
+                name: "IX_AspNetRoleClaims_RoleId",
+                table: "AspNetRoleClaims",
+                column: "RoleId");
+
+            migrationBuilder.CreateIndex(
+                name: "RoleNameIndex",
+                table: "AspNetRoles",
+                column: "NormalizedName",
+                unique: true,
+                filter: "[NormalizedName] IS NOT NULL");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_AspNetUserClaims_UserId",
+                table: "AspNetUserClaims",
+                column: "UserId");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_AspNetUserLogins_UserId",
+                table: "AspNetUserLogins",
+                column: "UserId");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_AspNetUserRoles_RoleId",
+                table: "AspNetUserRoles",
+                column: "RoleId");
+
+            migrationBuilder.CreateIndex(
+                name: "EmailIndex",
+                table: "AspNetUsers",
+                column: "NormalizedEmail");
+
+            migrationBuilder.CreateIndex(
+                name: "UserNameIndex",
+                table: "AspNetUsers",
+                column: "NormalizedUserName",
+                unique: true,
+                filter: "[NormalizedUserName] IS NOT NULL");
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropTable(
+                name: "AspNetRoleClaims");
+
+            migrationBuilder.DropTable(
+                name: "AspNetUserClaims");
+
+            migrationBuilder.DropTable(
+                name: "AspNetUserLogins");
+
+            migrationBuilder.DropTable(
+                name: "AspNetUserRoles");
+
+            migrationBuilder.DropTable(
+                name: "AspNetUserTokens");
+
+            migrationBuilder.DropTable(
+                name: "AspNetRoles");
+
+            migrationBuilder.DropTable(
+                name: "AspNetUsers");
+        }
+    }
+}
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1.Migrations/ApplicationDbContextModelSnapshot.cs b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1.Migrations/ApplicationDbContextModelSnapshot.cs
new file mode 100644
index 0000000000..60817cd5d2
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1.Migrations/ApplicationDbContextModelSnapshot.cs
@@ -0,0 +1,285 @@
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+using WebApplication1.Data;
+
+namespace WebApplication1.Migrations
+{
+    [DbContext(typeof(ApplicationDbContext))]
+    internal class ApplicationDbContextModelSnapshot : ModelSnapshot
+    {
+        protected override void BuildModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "3.0.0")
+                .HasAnnotation("Relational:MaxIdentifierLength", 128)
+                .HasAnnotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn);
+
+            modelBuilder.Entity(
+                "Microsoft.AspNetCore.Identity.IdentityRole", b =>
+                {
+                    b.Property<string>("Id")
+                        .HasColumnType("nvarchar(450)");
+
+                    b.Property<string>("ConcurrencyStamp")
+                        .IsConcurrencyToken()
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("Name")
+                        .HasColumnType("nvarchar(256)")
+                        .HasMaxLength(256);
+
+                    b.Property<string>("NormalizedName")
+                        .HasColumnType("nvarchar(256)")
+                        .HasMaxLength(256);
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("NormalizedName")
+                        .IsUnique()
+                        .HasName("RoleNameIndex")
+                        .HasFilter("[NormalizedName] IS NOT NULL");
+
+                    b.ToTable("AspNetRoles");
+                });
+
+            modelBuilder.Entity(
+                "Microsoft.AspNetCore.Identity.IdentityRoleClaim<string>", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("int")
+                        .HasAnnotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn);
+
+                    b.Property<string>("ClaimType")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("ClaimValue")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("RoleId")
+                        .IsRequired()
+                        .HasColumnType("nvarchar(450)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("RoleId");
+
+                    b.ToTable("AspNetRoleClaims");
+                });
+
+            modelBuilder.Entity(
+                "Microsoft.AspNetCore.Identity.IdentityUser", b =>
+                {
+                    b.Property<string>("Id")
+                        .HasColumnType("nvarchar(450)");
+
+                    b.Property<int>("AccessFailedCount")
+                        .HasColumnType("int");
+
+                    b.Property<string>("ConcurrencyStamp")
+                        .IsConcurrencyToken()
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("Email")
+                        .HasColumnType("nvarchar(256)")
+                        .HasMaxLength(256);
+
+                    b.Property<bool>("EmailConfirmed")
+                        .HasColumnType("bit");
+
+                    b.Property<bool>("LockoutEnabled")
+                        .HasColumnType("bit");
+
+                    b.Property<DateTimeOffset?>("LockoutEnd")
+                        .HasColumnType("datetimeoffset");
+
+                    b.Property<string>("NormalizedEmail")
+                        .HasColumnType("nvarchar(256)")
+                        .HasMaxLength(256);
+
+                    b.Property<string>("NormalizedUserName")
+                        .HasColumnType("nvarchar(256)")
+                        .HasMaxLength(256);
+
+                    b.Property<string>("PasswordHash")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("PhoneNumber")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<bool>("PhoneNumberConfirmed")
+                        .HasColumnType("bit");
+
+                    b.Property<string>("SecurityStamp")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<bool>("TwoFactorEnabled")
+                        .HasColumnType("bit");
+
+                    b.Property<string>("UserName")
+                        .HasColumnType("nvarchar(256)")
+                        .HasMaxLength(256);
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("NormalizedEmail")
+                        .HasName("EmailIndex");
+
+                    b.HasIndex("NormalizedUserName")
+                        .IsUnique()
+                        .HasName("UserNameIndex")
+                        .HasFilter("[NormalizedUserName] IS NOT NULL");
+
+                    b.ToTable("AspNetUsers");
+                });
+
+            modelBuilder.Entity(
+                "Microsoft.AspNetCore.Identity.IdentityUserClaim<string>", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("int")
+                        .HasAnnotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn);
+
+                    b.Property<string>("ClaimType")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("ClaimValue")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("UserId")
+                        .IsRequired()
+                        .HasColumnType("nvarchar(450)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("UserId");
+
+                    b.ToTable("AspNetUserClaims");
+                });
+
+            modelBuilder.Entity(
+                "Microsoft.AspNetCore.Identity.IdentityUserLogin<string>", b =>
+                {
+                    b.Property<string>("LoginProvider")
+                        .HasColumnType("nvarchar(128)")
+                        .HasMaxLength(128);
+
+                    b.Property<string>("ProviderKey")
+                        .HasColumnType("nvarchar(128)")
+                        .HasMaxLength(128);
+
+                    b.Property<string>("ProviderDisplayName")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("UserId")
+                        .IsRequired()
+                        .HasColumnType("nvarchar(450)");
+
+                    b.HasKey("LoginProvider", "ProviderKey");
+
+                    b.HasIndex("UserId");
+
+                    b.ToTable("AspNetUserLogins");
+                });
+
+            modelBuilder.Entity(
+                "Microsoft.AspNetCore.Identity.IdentityUserRole<string>", b =>
+                {
+                    b.Property<string>("UserId")
+                        .HasColumnType("nvarchar(450)");
+
+                    b.Property<string>("RoleId")
+                        .HasColumnType("nvarchar(450)");
+
+                    b.HasKey("UserId", "RoleId");
+
+                    b.HasIndex("RoleId");
+
+                    b.ToTable("AspNetUserRoles");
+                });
+
+            modelBuilder.Entity(
+                "Microsoft.AspNetCore.Identity.IdentityUserToken<string>", b =>
+                {
+                    b.Property<string>("UserId")
+                        .HasColumnType("nvarchar(450)");
+
+                    b.Property<string>("LoginProvider")
+                        .HasColumnType("nvarchar(128)")
+                        .HasMaxLength(128);
+
+                    b.Property<string>("Name")
+                        .HasColumnType("nvarchar(128)")
+                        .HasMaxLength(128);
+
+                    b.Property<string>("Value")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.HasKey("UserId", "LoginProvider", "Name");
+
+                    b.ToTable("AspNetUserTokens");
+                });
+
+            modelBuilder.Entity(
+                "Microsoft.AspNetCore.Identity.IdentityRoleClaim<string>", b =>
+                {
+                    b.HasOne("Microsoft.AspNetCore.Identity.IdentityRole", null)
+                        .WithMany()
+                        .HasForeignKey("RoleId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity(
+                "Microsoft.AspNetCore.Identity.IdentityUserClaim<string>", b =>
+                {
+                    b.HasOne("Microsoft.AspNetCore.Identity.IdentityUser", null)
+                        .WithMany()
+                        .HasForeignKey("UserId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity(
+                "Microsoft.AspNetCore.Identity.IdentityUserLogin<string>", b =>
+                {
+                    b.HasOne("Microsoft.AspNetCore.Identity.IdentityUser", null)
+                        .WithMany()
+                        .HasForeignKey("UserId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity(
+                "Microsoft.AspNetCore.Identity.IdentityUserRole<string>", b =>
+                {
+                    b.HasOne("Microsoft.AspNetCore.Identity.IdentityRole", null)
+                        .WithMany()
+                        .HasForeignKey("RoleId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("Microsoft.AspNetCore.Identity.IdentityUser", null)
+                        .WithMany()
+                        .HasForeignKey("UserId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+
+            modelBuilder.Entity(
+                "Microsoft.AspNetCore.Identity.IdentityUserToken<string>", b =>
+                {
+                    b.HasOne("Microsoft.AspNetCore.Identity.IdentityUser", null)
+                        .WithMany()
+                        .HasForeignKey("UserId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1.Migrations/WebApplication1.Migrations.csproj b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1.Migrations/WebApplication1.Migrations.csproj
new file mode 100644
index 0000000000..ab5016e6cc
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1.Migrations/WebApplication1.Migrations.csproj
@@ -0,0 +1,11 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\WebApplication1.Data\WebApplication1.Data.csproj" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1.sln b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1.sln
new file mode 100644
index 0000000000..97687c85ef
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1.sln
@@ -0,0 +1,37 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 16
+VisualStudioVersion = 16.0.30626.31
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "WebApplication1", "WebApplication1\WebApplication1.csproj", "{E85808EC-6138-4023-9DBE-4D5C896867F3}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "WebApplication1.Data", "WebApplication1.Data\WebApplication1.Data.csproj", "{5C6E6694-6CBC-46BE-964E-608A8D97604F}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "WebApplication1.Migrations", "WebApplication1.Migrations\WebApplication1.Migrations.csproj", "{335E7684-29CD-4B4D-A9E4-39AE26C4A5F4}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{E85808EC-6138-4023-9DBE-4D5C896867F3}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{E85808EC-6138-4023-9DBE-4D5C896867F3}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{E85808EC-6138-4023-9DBE-4D5C896867F3}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{E85808EC-6138-4023-9DBE-4D5C896867F3}.Release|Any CPU.Build.0 = Release|Any CPU
+		{5C6E6694-6CBC-46BE-964E-608A8D97604F}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{5C6E6694-6CBC-46BE-964E-608A8D97604F}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{5C6E6694-6CBC-46BE-964E-608A8D97604F}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{5C6E6694-6CBC-46BE-964E-608A8D97604F}.Release|Any CPU.Build.0 = Release|Any CPU
+		{335E7684-29CD-4B4D-A9E4-39AE26C4A5F4}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{335E7684-29CD-4B4D-A9E4-39AE26C4A5F4}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{335E7684-29CD-4B4D-A9E4-39AE26C4A5F4}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{335E7684-29CD-4B4D-A9E4-39AE26C4A5F4}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {A1C4E81E-ECFF-4996-A81D-AA0D0A8BD859}
+	EndGlobalSection
+EndGlobal
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Areas/Identity/Pages/_ViewStart.cshtml b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Areas/Identity/Pages/_ViewStart.cshtml
new file mode 100644
index 0000000000..4db7508a0e
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Areas/Identity/Pages/_ViewStart.cshtml
@@ -0,0 +1,3 @@
+@{
+    Layout = "/Pages/Shared/_Layout.cshtml";
+}
\ No newline at end of file
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Error.cshtml b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Error.cshtml
new file mode 100644
index 0000000000..b5105b6de1
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Error.cshtml
@@ -0,0 +1,26 @@
+@page
+@model ErrorModel
+@{
+    ViewData["Title"] = "Error";
+}
+
+<h1 class="text-danger">Error.</h1>
+<h2 class="text-danger">An error occurred while processing your request.</h2>
+
+@if (Model.ShowRequestId)
+{
+    <p>
+        <strong>Request ID:</strong> <code>@Model.RequestId</code>
+    </p>
+}
+
+<h3>Development Mode</h3>
+<p>
+    Swapping to the <strong>Development</strong> environment displays detailed information about the error that occurred.
+</p>
+<p>
+    <strong>The Development environment shouldn't be enabled for deployed applications.</strong>
+    It can result in displaying sensitive information from exceptions to end users.
+    For local debugging, enable the <strong>Development</strong> environment by setting the <strong>ASPNETCORE_ENVIRONMENT</strong> environment variable to <strong>Development</strong>
+    and restarting the app.
+</p>
\ No newline at end of file
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Error.cshtml.cs b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Error.cshtml.cs
new file mode 100644
index 0000000000..92460547c2
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Error.cshtml.cs
@@ -0,0 +1,26 @@
+using System.Diagnostics;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.AspNetCore.Mvc.RazorPages;
+using Microsoft.Extensions.Logging;
+
+namespace WebApplication1.Pages;
+
+[ResponseCache(Duration = 0, Location = ResponseCacheLocation.None, NoStore = true)]
+public class ErrorModel : PageModel
+{
+    public string RequestId { get; set; }
+
+    public bool ShowRequestId => !string.IsNullOrEmpty(RequestId);
+
+    private readonly ILogger<ErrorModel> _logger;
+
+    public ErrorModel(ILogger<ErrorModel> logger)
+    {
+        _logger = logger;
+    }
+
+    public void OnGet()
+    {
+        RequestId = Activity.Current?.Id ?? HttpContext.TraceIdentifier;
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Index.cshtml b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Index.cshtml
new file mode 100644
index 0000000000..fd28464cc7
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Index.cshtml
@@ -0,0 +1,10 @@
+@page
+@model IndexModel
+@{
+    ViewData["Title"] = "Home page";
+}
+
+<div class="text-center">
+    <h1 class="display-4">Welcome</h1>
+    <p>Learn about <a href="https://docs.microsoft.com/aspnet/core">building Web apps with ASP.NET Core</a>.</p>
+</div>
\ No newline at end of file
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Index.cshtml.cs b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Index.cshtml.cs
new file mode 100644
index 0000000000..dd39496f89
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Index.cshtml.cs
@@ -0,0 +1,18 @@
+using Microsoft.AspNetCore.Mvc.RazorPages;
+using Microsoft.Extensions.Logging;
+
+namespace WebApplication1.Pages;
+
+public class IndexModel : PageModel
+{
+    private readonly ILogger<IndexModel> _logger;
+
+    public IndexModel(ILogger<IndexModel> logger)
+    {
+        _logger = logger;
+    }
+
+    public void OnGet()
+    {
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Privacy.cshtml b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Privacy.cshtml
new file mode 100644
index 0000000000..a92998a633
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Privacy.cshtml
@@ -0,0 +1,8 @@
+@page
+@model PrivacyModel
+@{
+    ViewData["Title"] = "Privacy Policy";
+}
+<h1>@ViewData["Title"]</h1>
+
+<p>Use this page to detail your site's privacy policy.</p>
\ No newline at end of file
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Privacy.cshtml.cs b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Privacy.cshtml.cs
new file mode 100644
index 0000000000..096fcd92f0
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Privacy.cshtml.cs
@@ -0,0 +1,18 @@
+using Microsoft.AspNetCore.Mvc.RazorPages;
+using Microsoft.Extensions.Logging;
+
+namespace WebApplication1.Pages;
+
+public class PrivacyModel : PageModel
+{
+    private readonly ILogger<PrivacyModel> _logger;
+
+    public PrivacyModel(ILogger<PrivacyModel> logger)
+    {
+        _logger = logger;
+    }
+
+    public void OnGet()
+    {
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Shared/_Layout.cshtml b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Shared/_Layout.cshtml
new file mode 100644
index 0000000000..9d6c673d53
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Shared/_Layout.cshtml
@@ -0,0 +1,51 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+    <title>@ViewData["Title"] - WebApplication1</title>
+    <link rel="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.min.css"/>
+    <link rel="stylesheet" href="~/css/site.css"/>
+</head>
+<body>
+<header>
+    <nav class="navbar navbar-expand-sm navbar-toggleable-sm navbar-light bg-white border-bottom box-shadow mb-3">
+        <div class="container">
+            <a class="navbar-brand" asp-area="" asp-page="/Index">WebApplication1</a>
+            <button class="navbar-toggler" type="button" data-toggle="collapse" data-target=".navbar-collapse" aria-controls="navbarSupportedContent"
+                    aria-expanded="false" aria-label="Toggle navigation">
+                <span class="navbar-toggler-icon"></span>
+            </button>
+            <div class="navbar-collapse collapse d-sm-inline-flex flex-sm-row-reverse">
+                <partial name="_LoginPartial"/>
+                <ul class="navbar-nav flex-grow-1">
+                    <li class="nav-item">
+                        <a class="nav-link text-dark" asp-area="" asp-page="/Index">Home</a>
+                    </li>
+                    <li class="nav-item">
+                        <a class="nav-link text-dark" asp-area="" asp-page="/Privacy">Privacy</a>
+                    </li>
+                </ul>
+            </div>
+        </div>
+    </nav>
+</header>
+<div class="container">
+    <main role="main" class="pb-3">
+        @RenderBody()
+    </main>
+</div>
+
+<footer class="border-top footer text-muted">
+    <div class="container">
+        &copy; 2020 - WebApplication1 - <a asp-area="" asp-page="/Privacy">Privacy</a>
+    </div>
+</footer>
+
+<script src="~/lib/jquery/dist/jquery.min.js"></script>
+<script src="~/lib/bootstrap/dist/js/bootstrap.bundle.min.js"></script>
+<script src="~/js/site.js" asp-append-version="true"></script>
+
+@RenderSection("Scripts", required: false)
+</body>
+</html>
\ No newline at end of file
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Shared/_LoginPartial.cshtml b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Shared/_LoginPartial.cshtml
new file mode 100644
index 0000000000..e85ec77721
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Shared/_LoginPartial.cshtml
@@ -0,0 +1,25 @@
+@inject SignInManager<IdentityUser> SignInManager
+@inject UserManager<IdentityUser> UserManager
+
+<ul class="navbar-nav">
+    @if (SignInManager.IsSignedIn(User))
+    {
+        <li class="nav-item">
+            <a class="nav-link text-dark" asp-area="Identity" asp-page="/Account/Manage/Index" title="Manage">Hello @User.Identity.Name!</a>
+        </li>
+        <li class="nav-item">
+            <form class="form-inline" asp-area="Identity" asp-page="/Account/Logout" asp-route-returnUrl="@Url.Page("/", new { area = "" })" method="post">
+                <button type="submit" class="nav-link btn btn-link text-dark">Logout</button>
+            </form>
+        </li>
+    }
+    else
+    {
+        <li class="nav-item">
+            <a class="nav-link text-dark" asp-area="Identity" asp-page="/Account/Register">Register</a>
+        </li>
+        <li class="nav-item">
+            <a class="nav-link text-dark" asp-area="Identity" asp-page="/Account/Login">Login</a>
+        </li>
+    }
+</ul>
\ No newline at end of file
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Shared/_ValidationScriptsPartial.cshtml b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Shared/_ValidationScriptsPartial.cshtml
new file mode 100644
index 0000000000..660f00c3bb
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/Shared/_ValidationScriptsPartial.cshtml
@@ -0,0 +1,2 @@
+<script src="~/lib/jquery-validation/dist/jquery.validate.min.js"></script>
+<script src="~/lib/jquery-validation-unobtrusive/jquery.validate.unobtrusive.min.js"></script>
\ No newline at end of file
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/_ViewImports.cshtml b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/_ViewImports.cshtml
new file mode 100644
index 0000000000..83237e879d
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/_ViewImports.cshtml
@@ -0,0 +1,5 @@
+@using Microsoft.AspNetCore.Identity
+@using WebApplication1
+@using WebApplication1.Data
+@namespace WebApplication1.Pages
+@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers
\ No newline at end of file
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/_ViewStart.cshtml b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/_ViewStart.cshtml
new file mode 100644
index 0000000000..1af6e49466
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Pages/_ViewStart.cshtml
@@ -0,0 +1,3 @@
+@{
+    Layout = "_Layout";
+}
\ No newline at end of file
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Program.cs b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Program.cs
new file mode 100644
index 0000000000..bacc120416
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Program.cs
@@ -0,0 +1,16 @@
+using Microsoft.AspNetCore.Hosting;
+using Microsoft.Extensions.Hosting;
+
+namespace WebApplication1;
+
+public class Program
+{
+    public static void Main(string[] args)
+    {
+        CreateHostBuilder(args).Build().Run();
+    }
+
+    public static IHostBuilder CreateHostBuilder(string[] args) =>
+        Host.CreateDefaultBuilder(args)
+            .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseStartup<Startup>(); });
+}
\ No newline at end of file
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Properties/launchSettings.json b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Properties/launchSettings.json
new file mode 100644
index 0000000000..4ea55d68cb
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Properties/launchSettings.json
@@ -0,0 +1,12 @@
+{
+  "profiles": {
+    "WebApplication1": {
+      "commandName": "Project",
+      "launchBrowser": true,
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      },
+      "applicationUrl": "https://localhost:58211;http://localhost:58215"
+    }
+  }
+}
\ No newline at end of file
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Properties/serviceDependencies.json b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Properties/serviceDependencies.json
new file mode 100644
index 0000000000..224ac68ceb
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Properties/serviceDependencies.json
@@ -0,0 +1,8 @@
+{
+  "dependencies": {
+    "mssql1": {
+      "type": "mssql",
+      "connectionId": "DefaultConnection"
+    }
+  }
+}
\ No newline at end of file
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Properties/serviceDependencies.local.json b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Properties/serviceDependencies.local.json
new file mode 100644
index 0000000000..48bec3bb2e
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Properties/serviceDependencies.local.json
@@ -0,0 +1,8 @@
+{
+  "dependencies": {
+    "mssql1": {
+      "type": "mssql.local",
+      "connectionId": "DefaultConnection"
+    }
+  }
+}
\ No newline at end of file
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Startup.cs b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Startup.cs
new file mode 100644
index 0000000000..4490a3fd9a
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/Startup.cs
@@ -0,0 +1,62 @@
+using Microsoft.AspNetCore.Builder;
+using Microsoft.AspNetCore.Hosting;
+using Microsoft.AspNetCore.Identity;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+using WebApplication1.Data;
+
+namespace WebApplication1;
+
+public class Startup
+{
+    public Startup(IConfiguration configuration)
+    {
+        Configuration = configuration;
+    }
+
+    public IConfiguration Configuration { get; }
+
+    // This method gets called by the runtime. Use this method to add services to the container.
+    public void ConfigureServices(IServiceCollection services)
+    {
+        #region snippet_MigrationsAssembly
+        services.AddDbContext<ApplicationDbContext>(
+            options =>
+                options.UseSqlServer(
+                    Configuration.GetConnectionString("DefaultConnection"),
+                    x => x.MigrationsAssembly("WebApplication1.Migrations")));
+        #endregion
+        services.AddDefaultIdentity<IdentityUser>(options => options.SignIn.RequireConfirmedAccount = true)
+            .AddEntityFrameworkStores<ApplicationDbContext>();
+        services.AddRazorPages();
+        services.AddDatabaseDeveloperPageExceptionFilter();
+    }
+
+    // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
+    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
+    {
+        if (env.IsDevelopment())
+        {
+            app.UseDeveloperExceptionPage();
+            app.UseMigrationsEndPoint();
+        }
+        else
+        {
+            app.UseExceptionHandler("/Error");
+            // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
+            app.UseHsts();
+        }
+
+        app.UseHttpsRedirection();
+        app.UseStaticFiles();
+
+        app.UseRouting();
+
+        app.UseAuthentication();
+        app.UseAuthorization();
+
+        app.UseEndpoints(endpoints => { endpoints.MapRazorPages(); });
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/WebApplication1.csproj b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/WebApplication1.csproj
new file mode 100644
index 0000000000..f8937b3034
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/WebApplication1.csproj
@@ -0,0 +1,23 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <UserSecretsId>aspnet-WebApplication1-1FCCDCDB-A580-40BC-B4DC-17498EB689D9</UserSecretsId>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore" Version="10.0.0" />
+    <PackageReference Include="Microsoft.AspNetCore.Identity.UI" Version="10.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="10.0.0" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\WebApplication1.Data\WebApplication1.Data.csproj" />
+    <ProjectReference Include="..\WebApplication1.Migrations\WebApplication1.Migrations.csproj">
+      <!-- Not working. See dotnet/sdk#952 -->
+      <PrivateAssets>all</PrivateAssets>
+      <ExcludeAssets>compile</ExcludeAssets>
+    </ProjectReference>
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/appsettings.Development.json b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/appsettings.Development.json
new file mode 100644
index 0000000000..8983e0fc1c
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/appsettings.Development.json
@@ -0,0 +1,9 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft": "Warning",
+      "Microsoft.Hosting.Lifetime": "Information"
+    }
+  }
+}
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/appsettings.json b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/appsettings.json
new file mode 100644
index 0000000000..24a9450b1e
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/appsettings.json
@@ -0,0 +1,13 @@
+{
+  "ConnectionStrings": {
+    "DefaultConnection": "Server=(localdb)\\mssqllocaldb;Database=aspnet-WebApplication1-53bc9b9d-9d6a-45d4-8429-2a2761773502;Trusted_Connection=True;MultipleActiveResultSets=true"
+  },
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft": "Warning",
+      "Microsoft.Hosting.Lifetime": "Information"
+    }
+  },
+  "AllowedHosts": "*"
+}
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/wwwroot/css/site.css b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/wwwroot/css/site.css
new file mode 100644
index 0000000000..e679a8ea7f
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/wwwroot/css/site.css
@@ -0,0 +1,71 @@
+/* Please see documentation at https://docs.microsoft.com/aspnet/core/client-side/bundling-and-minification
+for details on configuring this project to bundle and minify static web assets. */
+
+a.navbar-brand {
+  white-space: normal;
+  text-align: center;
+  word-break: break-all;
+}
+
+/* Provide sufficient contrast against white background */
+a {
+  color: #0366d6;
+}
+
+.btn-primary {
+  color: #fff;
+  background-color: #1b6ec2;
+  border-color: #1861ac;
+}
+
+.nav-pills .nav-link.active, .nav-pills .show > .nav-link {
+  color: #fff;
+  background-color: #1b6ec2;
+  border-color: #1861ac;
+}
+
+/* Sticky footer styles
+-------------------------------------------------- */
+html {
+  font-size: 14px;
+}
+@media (min-width: 768px) {
+  html {
+    font-size: 16px;
+  }
+}
+
+.border-top {
+  border-top: 1px solid #e5e5e5;
+}
+.border-bottom {
+  border-bottom: 1px solid #e5e5e5;
+}
+
+.box-shadow {
+  box-shadow: 0 .25rem .75rem rgba(0, 0, 0, .05);
+}
+
+button.accept-policy {
+  font-size: 1rem;
+  line-height: inherit;
+}
+
+/* Sticky footer styles
+-------------------------------------------------- */
+html {
+  position: relative;
+  min-height: 100%;
+}
+
+body {
+  /* Margin bottom by footer height */
+  margin-bottom: 60px;
+}
+.footer {
+  position: absolute;
+  bottom: 0;
+  width: 100%;
+  white-space: nowrap;
+  line-height: 60px; /* Vertically center the text there */
+}
diff --git a/docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/favicon.ico b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/wwwroot/favicon.ico
similarity index 100%
rename from docs/getting-started/aspnet5/sample/src/EFGetStarted.AspNet5/wwwroot/favicon.ico
rename to samples/core/Schemas/ThreeProjectMigrations/WebApplication1/wwwroot/favicon.ico
diff --git a/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/wwwroot/js/site.js b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/wwwroot/js/site.js
new file mode 100644
index 0000000000..3c76e6dc45
--- /dev/null
+++ b/samples/core/Schemas/ThreeProjectMigrations/WebApplication1/wwwroot/js/site.js
@@ -0,0 +1,4 @@
+// Please see documentation at https://docs.microsoft.com/aspnet/core/client-side/bundling-and-minification
+// for details on configuring this project to bundle and minify static web assets.
+
+// Write your Javascript code.
diff --git a/samples/core/Schemas/TwoProjectMigrations/SqlServerMigrations/20200915225801_InitialCreate.Designer.cs b/samples/core/Schemas/TwoProjectMigrations/SqlServerMigrations/20200915225801_InitialCreate.Designer.cs
new file mode 100644
index 0000000000..a8c2fdbe1a
--- /dev/null
+++ b/samples/core/Schemas/TwoProjectMigrations/SqlServerMigrations/20200915225801_InitialCreate.Designer.cs
@@ -0,0 +1,141 @@
+// <auto-generated />
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Metadata;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using WorkerService1;
+
+namespace SqlServerMigrations
+{
+    [DbContext(typeof(BlogContext))]
+    [Migration("20200915225801_InitialCreate")]
+    partial class InitialCreate
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .UseIdentityColumns()
+                .HasAnnotation("Relational:MaxIdentifierLength", 128)
+                .HasAnnotation("ProductVersion", "5.0.0");
+
+            modelBuilder.Entity("WorkerService1.Blog", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("int")
+                        .UseIdentityColumn();
+
+                    b.Property<string>("Source")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("Title")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.HasKey("Id");
+
+                    b.ToTable("Blogs");
+                });
+
+            modelBuilder.Entity("WorkerService1.Person", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("int")
+                        .UseIdentityColumn();
+
+                    b.Property<string>("Email")
+                        .HasColumnType("nvarchar(450)");
+
+                    b.Property<string>("Name")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("Email")
+                        .IsUnique()
+                        .HasFilter("[Email] IS NOT NULL");
+
+                    b.ToTable("People");
+                });
+
+            modelBuilder.Entity("WorkerService1.Post", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("int")
+                        .UseIdentityColumn();
+
+                    b.Property<int>("AuthorId")
+                        .HasColumnType("int");
+
+                    b.Property<int>("BlogId")
+                        .HasColumnType("int");
+
+                    b.Property<string>("Content")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("Discriminator")
+                        .IsRequired()
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("Title")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("AuthorId");
+
+                    b.HasIndex("BlogId");
+
+                    b.ToTable("Posts");
+
+                    b.HasDiscriminator<string>("Discriminator").HasValue("Post");
+                });
+
+            modelBuilder.Entity("WorkerService1.MediaPost", b =>
+                {
+                    b.HasBaseType("WorkerService1.Post");
+
+                    b.Property<string>("MediaType")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("MediaUrl")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.HasDiscriminator().HasValue("MediaPost");
+                });
+
+            modelBuilder.Entity("WorkerService1.Post", b =>
+                {
+                    b.HasOne("WorkerService1.Person", "Author")
+                        .WithMany("AuthoredPosts")
+                        .HasForeignKey("AuthorId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("WorkerService1.Blog", "Blog")
+                        .WithMany("Posts")
+                        .HasForeignKey("BlogId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("Author");
+
+                    b.Navigation("Blog");
+                });
+
+            modelBuilder.Entity("WorkerService1.Blog", b =>
+                {
+                    b.Navigation("Posts");
+                });
+
+            modelBuilder.Entity("WorkerService1.Person", b =>
+                {
+                    b.Navigation("AuthoredPosts");
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/samples/core/Schemas/TwoProjectMigrations/SqlServerMigrations/20200915225801_InitialCreate.cs b/samples/core/Schemas/TwoProjectMigrations/SqlServerMigrations/20200915225801_InitialCreate.cs
new file mode 100644
index 0000000000..9e1f5ecf71
--- /dev/null
+++ b/samples/core/Schemas/TwoProjectMigrations/SqlServerMigrations/20200915225801_InitialCreate.cs
@@ -0,0 +1,92 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace SqlServerMigrations
+{
+    public partial class InitialCreate : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.CreateTable(
+                name: "Blogs",
+                columns: table => new
+                {
+                    Id = table.Column<int>(type: "int", nullable: false)
+                        .Annotation("SqlServer:Identity", "1, 1"),
+                    Source = table.Column<string>(type: "nvarchar(max)", nullable: true),
+                    Title = table.Column<string>(type: "nvarchar(max)", nullable: true)
+                },
+                constraints: table => { table.PrimaryKey("PK_Blogs", x => x.Id); });
+
+            migrationBuilder.CreateTable(
+                name: "People",
+                columns: table => new
+                {
+                    Id = table.Column<int>(type: "int", nullable: false)
+                        .Annotation("SqlServer:Identity", "1, 1"),
+                    Name = table.Column<string>(type: "nvarchar(max)", nullable: true),
+                    Email = table.Column<string>(type: "nvarchar(450)", nullable: true)
+                },
+                constraints: table => { table.PrimaryKey("PK_People", x => x.Id); });
+
+            migrationBuilder.CreateTable(
+                name: "Posts",
+                columns: table => new
+                {
+                    Id = table.Column<int>(type: "int", nullable: false)
+                        .Annotation("SqlServer:Identity", "1, 1"),
+                    BlogId = table.Column<int>(type: "int", nullable: false),
+                    Title = table.Column<string>(type: "nvarchar(max)", nullable: true),
+                    Content = table.Column<string>(type: "nvarchar(max)", nullable: true),
+                    AuthorId = table.Column<int>(type: "int", nullable: false),
+                    Discriminator = table.Column<string>(type: "nvarchar(max)", nullable: false),
+                    MediaUrl = table.Column<string>(type: "nvarchar(max)", nullable: true),
+                    MediaType = table.Column<string>(type: "nvarchar(max)", nullable: true)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_Posts", x => x.Id);
+                    table.ForeignKey(
+                        name: "FK_Posts_Blogs_BlogId",
+                        column: x => x.BlogId,
+                        principalTable: "Blogs",
+                        principalColumn: "Id",
+                        onDelete: ReferentialAction.Cascade);
+                    table.ForeignKey(
+                        name: "FK_Posts_People_AuthorId",
+                        column: x => x.AuthorId,
+                        principalTable: "People",
+                        principalColumn: "Id",
+                        onDelete: ReferentialAction.Cascade);
+                });
+
+            migrationBuilder.CreateIndex(
+                name: "IX_People_Email",
+                table: "People",
+                column: "Email",
+                unique: true,
+                filter: "[Email] IS NOT NULL");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_Posts_AuthorId",
+                table: "Posts",
+                column: "AuthorId");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_Posts_BlogId",
+                table: "Posts",
+                column: "BlogId");
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropTable(
+                name: "Posts");
+
+            migrationBuilder.DropTable(
+                name: "Blogs");
+
+            migrationBuilder.DropTable(
+                name: "People");
+        }
+    }
+}
diff --git a/samples/core/Schemas/TwoProjectMigrations/SqlServerMigrations/BlogContextModelSnapshot.cs b/samples/core/Schemas/TwoProjectMigrations/SqlServerMigrations/BlogContextModelSnapshot.cs
new file mode 100644
index 0000000000..442f1247dc
--- /dev/null
+++ b/samples/core/Schemas/TwoProjectMigrations/SqlServerMigrations/BlogContextModelSnapshot.cs
@@ -0,0 +1,135 @@
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using WorkerService1;
+
+namespace SqlServerMigrations
+{
+    [DbContext(typeof(BlogContext))]
+    internal class BlogContextModelSnapshot : ModelSnapshot
+    {
+        protected override void BuildModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .UseIdentityColumns()
+                .HasAnnotation("Relational:MaxIdentifierLength", 128)
+                .HasAnnotation("ProductVersion", "5.0.0");
+
+            modelBuilder.Entity(
+                "WorkerService1.Blog", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("int")
+                        .UseIdentityColumn();
+
+                    b.Property<string>("Source")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("Title")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.HasKey("Id");
+
+                    b.ToTable("Blogs");
+                });
+
+            modelBuilder.Entity(
+                "WorkerService1.Person", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("int")
+                        .UseIdentityColumn();
+
+                    b.Property<string>("Email")
+                        .HasColumnType("nvarchar(450)");
+
+                    b.Property<string>("Name")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("Email")
+                        .IsUnique()
+                        .HasFilter("[Email] IS NOT NULL");
+
+                    b.ToTable("People");
+                });
+
+            modelBuilder.Entity(
+                "WorkerService1.Post", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("int")
+                        .UseIdentityColumn();
+
+                    b.Property<int>("AuthorId")
+                        .HasColumnType("int");
+
+                    b.Property<int>("BlogId")
+                        .HasColumnType("int");
+
+                    b.Property<string>("Content")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("Discriminator")
+                        .IsRequired()
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("Title")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("AuthorId");
+
+                    b.HasIndex("BlogId");
+
+                    b.ToTable("Posts");
+
+                    b.HasDiscriminator<string>("Discriminator").HasValue("Post");
+                });
+
+            modelBuilder.Entity(
+                "WorkerService1.MediaPost", b =>
+                {
+                    b.HasBaseType("WorkerService1.Post");
+
+                    b.Property<string>("MediaType")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.Property<string>("MediaUrl")
+                        .HasColumnType("nvarchar(max)");
+
+                    b.HasDiscriminator().HasValue("MediaPost");
+                });
+
+            modelBuilder.Entity(
+                "WorkerService1.Post", b =>
+                {
+                    b.HasOne("WorkerService1.Person", "Author")
+                        .WithMany("AuthoredPosts")
+                        .HasForeignKey("AuthorId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("WorkerService1.Blog", "Blog")
+                        .WithMany("Posts")
+                        .HasForeignKey("BlogId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("Author");
+
+                    b.Navigation("Blog");
+                });
+
+            modelBuilder.Entity("WorkerService1.Blog", b => { b.Navigation("Posts"); });
+
+            modelBuilder.Entity("WorkerService1.Person", b => { b.Navigation("AuthoredPosts"); });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/samples/core/Schemas/TwoProjectMigrations/SqlServerMigrations/SqlServerMigrations.csproj b/samples/core/Schemas/TwoProjectMigrations/SqlServerMigrations/SqlServerMigrations.csproj
new file mode 100644
index 0000000000..a9bdd1a1c5
--- /dev/null
+++ b/samples/core/Schemas/TwoProjectMigrations/SqlServerMigrations/SqlServerMigrations.csproj
@@ -0,0 +1,12 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <BaseOutputPath>..\WorkerService1\bin\</BaseOutputPath>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\WorkerService1\WorkerService1.csproj" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Schemas/TwoProjectMigrations/SqliteMigrations/20200915230052_InitialCreate.Designer.cs b/samples/core/Schemas/TwoProjectMigrations/SqliteMigrations/20200915230052_InitialCreate.Designer.cs
new file mode 100644
index 0000000000..1f3dae9eb9
--- /dev/null
+++ b/samples/core/Schemas/TwoProjectMigrations/SqliteMigrations/20200915230052_InitialCreate.Designer.cs
@@ -0,0 +1,134 @@
+// <auto-generated />
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+using WorkerService1;
+
+namespace SqliteMigrations
+{
+    [DbContext(typeof(BlogContext))]
+    [Migration("20200915230052_InitialCreate")]
+    partial class InitialCreate
+    {
+        protected override void BuildTargetModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "5.0.0");
+
+            modelBuilder.Entity("WorkerService1.Blog", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("INTEGER");
+
+                    b.Property<string>("Source")
+                        .HasColumnType("TEXT");
+
+                    b.Property<string>("Title")
+                        .HasColumnType("TEXT");
+
+                    b.HasKey("Id");
+
+                    b.ToTable("Blogs");
+                });
+
+            modelBuilder.Entity("WorkerService1.Person", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("INTEGER");
+
+                    b.Property<string>("Email")
+                        .HasColumnType("TEXT");
+
+                    b.Property<string>("Name")
+                        .HasColumnType("TEXT");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("Email")
+                        .IsUnique();
+
+                    b.ToTable("People");
+                });
+
+            modelBuilder.Entity("WorkerService1.Post", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("INTEGER");
+
+                    b.Property<int>("AuthorId")
+                        .HasColumnType("INTEGER");
+
+                    b.Property<int>("BlogId")
+                        .HasColumnType("INTEGER");
+
+                    b.Property<string>("Content")
+                        .HasColumnType("TEXT");
+
+                    b.Property<string>("Discriminator")
+                        .IsRequired()
+                        .HasColumnType("TEXT");
+
+                    b.Property<string>("Title")
+                        .HasColumnType("TEXT");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("AuthorId");
+
+                    b.HasIndex("BlogId");
+
+                    b.ToTable("Posts");
+
+                    b.HasDiscriminator<string>("Discriminator").HasValue("Post");
+                });
+
+            modelBuilder.Entity("WorkerService1.MediaPost", b =>
+                {
+                    b.HasBaseType("WorkerService1.Post");
+
+                    b.Property<string>("MediaType")
+                        .HasColumnType("TEXT");
+
+                    b.Property<string>("MediaUrl")
+                        .HasColumnType("TEXT");
+
+                    b.HasDiscriminator().HasValue("MediaPost");
+                });
+
+            modelBuilder.Entity("WorkerService1.Post", b =>
+                {
+                    b.HasOne("WorkerService1.Person", "Author")
+                        .WithMany("AuthoredPosts")
+                        .HasForeignKey("AuthorId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("WorkerService1.Blog", "Blog")
+                        .WithMany("Posts")
+                        .HasForeignKey("BlogId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("Author");
+
+                    b.Navigation("Blog");
+                });
+
+            modelBuilder.Entity("WorkerService1.Blog", b =>
+                {
+                    b.Navigation("Posts");
+                });
+
+            modelBuilder.Entity("WorkerService1.Person", b =>
+                {
+                    b.Navigation("AuthoredPosts");
+                });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/samples/core/Schemas/TwoProjectMigrations/SqliteMigrations/20200915230052_InitialCreate.cs b/samples/core/Schemas/TwoProjectMigrations/SqliteMigrations/20200915230052_InitialCreate.cs
new file mode 100644
index 0000000000..878e70d3df
--- /dev/null
+++ b/samples/core/Schemas/TwoProjectMigrations/SqliteMigrations/20200915230052_InitialCreate.cs
@@ -0,0 +1,91 @@
+using Microsoft.EntityFrameworkCore.Migrations;
+
+namespace SqliteMigrations
+{
+    public partial class InitialCreate : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.CreateTable(
+                name: "Blogs",
+                columns: table => new
+                {
+                    Id = table.Column<int>(type: "INTEGER", nullable: false)
+                        .Annotation("Sqlite:Autoincrement", true),
+                    Source = table.Column<string>(type: "TEXT", nullable: true),
+                    Title = table.Column<string>(type: "TEXT", nullable: true)
+                },
+                constraints: table => { table.PrimaryKey("PK_Blogs", x => x.Id); });
+
+            migrationBuilder.CreateTable(
+                name: "People",
+                columns: table => new
+                {
+                    Id = table.Column<int>(type: "INTEGER", nullable: false)
+                        .Annotation("Sqlite:Autoincrement", true),
+                    Name = table.Column<string>(type: "TEXT", nullable: true),
+                    Email = table.Column<string>(type: "TEXT", nullable: true)
+                },
+                constraints: table => { table.PrimaryKey("PK_People", x => x.Id); });
+
+            migrationBuilder.CreateTable(
+                name: "Posts",
+                columns: table => new
+                {
+                    Id = table.Column<int>(type: "INTEGER", nullable: false)
+                        .Annotation("Sqlite:Autoincrement", true),
+                    BlogId = table.Column<int>(type: "INTEGER", nullable: false),
+                    Title = table.Column<string>(type: "TEXT", nullable: true),
+                    Content = table.Column<string>(type: "TEXT", nullable: true),
+                    AuthorId = table.Column<int>(type: "INTEGER", nullable: false),
+                    Discriminator = table.Column<string>(type: "TEXT", nullable: false),
+                    MediaUrl = table.Column<string>(type: "TEXT", nullable: true),
+                    MediaType = table.Column<string>(type: "TEXT", nullable: true)
+                },
+                constraints: table =>
+                {
+                    table.PrimaryKey("PK_Posts", x => x.Id);
+                    table.ForeignKey(
+                        name: "FK_Posts_Blogs_BlogId",
+                        column: x => x.BlogId,
+                        principalTable: "Blogs",
+                        principalColumn: "Id",
+                        onDelete: ReferentialAction.Cascade);
+                    table.ForeignKey(
+                        name: "FK_Posts_People_AuthorId",
+                        column: x => x.AuthorId,
+                        principalTable: "People",
+                        principalColumn: "Id",
+                        onDelete: ReferentialAction.Cascade);
+                });
+
+            migrationBuilder.CreateIndex(
+                name: "IX_People_Email",
+                table: "People",
+                column: "Email",
+                unique: true);
+
+            migrationBuilder.CreateIndex(
+                name: "IX_Posts_AuthorId",
+                table: "Posts",
+                column: "AuthorId");
+
+            migrationBuilder.CreateIndex(
+                name: "IX_Posts_BlogId",
+                table: "Posts",
+                column: "BlogId");
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            migrationBuilder.DropTable(
+                name: "Posts");
+
+            migrationBuilder.DropTable(
+                name: "Blogs");
+
+            migrationBuilder.DropTable(
+                name: "People");
+        }
+    }
+}
diff --git a/samples/core/Schemas/TwoProjectMigrations/SqliteMigrations/BlogContextModelSnapshot.cs b/samples/core/Schemas/TwoProjectMigrations/SqliteMigrations/BlogContextModelSnapshot.cs
new file mode 100644
index 0000000000..006bfa98bd
--- /dev/null
+++ b/samples/core/Schemas/TwoProjectMigrations/SqliteMigrations/BlogContextModelSnapshot.cs
@@ -0,0 +1,129 @@
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
+using WorkerService1;
+
+namespace SqliteMigrations
+{
+    [DbContext(typeof(BlogContext))]
+    internal class BlogContextModelSnapshot : ModelSnapshot
+    {
+        protected override void BuildModel(ModelBuilder modelBuilder)
+        {
+#pragma warning disable 612, 618
+            modelBuilder
+                .HasAnnotation("ProductVersion", "5.0.0");
+
+            modelBuilder.Entity(
+                "WorkerService1.Blog", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("INTEGER");
+
+                    b.Property<string>("Source")
+                        .HasColumnType("TEXT");
+
+                    b.Property<string>("Title")
+                        .HasColumnType("TEXT");
+
+                    b.HasKey("Id");
+
+                    b.ToTable("Blogs");
+                });
+
+            modelBuilder.Entity(
+                "WorkerService1.Person", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("INTEGER");
+
+                    b.Property<string>("Email")
+                        .HasColumnType("TEXT");
+
+                    b.Property<string>("Name")
+                        .HasColumnType("TEXT");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("Email")
+                        .IsUnique();
+
+                    b.ToTable("People");
+                });
+
+            modelBuilder.Entity(
+                "WorkerService1.Post", b =>
+                {
+                    b.Property<int>("Id")
+                        .ValueGeneratedOnAdd()
+                        .HasColumnType("INTEGER");
+
+                    b.Property<int>("AuthorId")
+                        .HasColumnType("INTEGER");
+
+                    b.Property<int>("BlogId")
+                        .HasColumnType("INTEGER");
+
+                    b.Property<string>("Content")
+                        .HasColumnType("TEXT");
+
+                    b.Property<string>("Discriminator")
+                        .IsRequired()
+                        .HasColumnType("TEXT");
+
+                    b.Property<string>("Title")
+                        .HasColumnType("TEXT");
+
+                    b.HasKey("Id");
+
+                    b.HasIndex("AuthorId");
+
+                    b.HasIndex("BlogId");
+
+                    b.ToTable("Posts");
+
+                    b.HasDiscriminator<string>("Discriminator").HasValue("Post");
+                });
+
+            modelBuilder.Entity(
+                "WorkerService1.MediaPost", b =>
+                {
+                    b.HasBaseType("WorkerService1.Post");
+
+                    b.Property<string>("MediaType")
+                        .HasColumnType("TEXT");
+
+                    b.Property<string>("MediaUrl")
+                        .HasColumnType("TEXT");
+
+                    b.HasDiscriminator().HasValue("MediaPost");
+                });
+
+            modelBuilder.Entity(
+                "WorkerService1.Post", b =>
+                {
+                    b.HasOne("WorkerService1.Person", "Author")
+                        .WithMany("AuthoredPosts")
+                        .HasForeignKey("AuthorId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.HasOne("WorkerService1.Blog", "Blog")
+                        .WithMany("Posts")
+                        .HasForeignKey("BlogId")
+                        .OnDelete(DeleteBehavior.Cascade)
+                        .IsRequired();
+
+                    b.Navigation("Author");
+
+                    b.Navigation("Blog");
+                });
+
+            modelBuilder.Entity("WorkerService1.Blog", b => { b.Navigation("Posts"); });
+
+            modelBuilder.Entity("WorkerService1.Person", b => { b.Navigation("AuthoredPosts"); });
+#pragma warning restore 612, 618
+        }
+    }
+}
diff --git a/samples/core/Schemas/TwoProjectMigrations/SqliteMigrations/SqliteMigrations.csproj b/samples/core/Schemas/TwoProjectMigrations/SqliteMigrations/SqliteMigrations.csproj
new file mode 100644
index 0000000000..64ae7131a9
--- /dev/null
+++ b/samples/core/Schemas/TwoProjectMigrations/SqliteMigrations/SqliteMigrations.csproj
@@ -0,0 +1,12 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <BaseOutputPath>..\WorkerService1\bin\</BaseOutputPath>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\WorkerService1\WorkerService1.csproj" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Schemas/TwoProjectMigrations/WorkerService1/Model.cs b/samples/core/Schemas/TwoProjectMigrations/WorkerService1/Model.cs
new file mode 100644
index 0000000000..d0d4854e31
--- /dev/null
+++ b/samples/core/Schemas/TwoProjectMigrations/WorkerService1/Model.cs
@@ -0,0 +1,65 @@
+using System;
+using System.Collections.Generic;
+using Microsoft.EntityFrameworkCore;
+
+namespace WorkerService1;
+
+public class Blog
+{
+    public int Id { get; set; }
+
+    public Uri Source { get; set; }
+    public string Title { get; set; }
+
+    public ICollection<Post> Posts { get; } = new HashSet<Post>();
+}
+
+public class Person
+{
+    public int Id { get; set; }
+
+    public string Name { get; set; }
+    public string Email { get; set; }
+
+    public ICollection<Post> AuthoredPosts { get; } = new HashSet<Post>();
+}
+
+public class Post
+{
+    public int Id { get; set; }
+
+    public int BlogId { get; set; }
+    public Blog Blog { get; set; }
+
+    public string Title { get; set; }
+    public string Content { get; set; }
+
+    public int AuthorId { get; set; }
+    public Person Author { get; set; }
+}
+
+public class MediaPost : Post
+{
+    public Uri MediaUrl { get; set; }
+    public string MediaType { get; set; }
+}
+
+public class BlogContext : DbContext
+{
+    public BlogContext(DbContextOptions<BlogContext> options)
+        : base(options)
+    {
+    }
+
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<Person> People { get; set; }
+    public DbSet<Post> Posts { get; set; }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Person>()
+            .HasIndex(p => p.Email).IsUnique();
+
+        modelBuilder.Entity<MediaPost>();
+    }
+}
\ No newline at end of file
diff --git a/samples/core/Schemas/TwoProjectMigrations/WorkerService1/Program.cs b/samples/core/Schemas/TwoProjectMigrations/WorkerService1/Program.cs
new file mode 100644
index 0000000000..5720f3fa58
--- /dev/null
+++ b/samples/core/Schemas/TwoProjectMigrations/WorkerService1/Program.cs
@@ -0,0 +1,41 @@
+using System;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+
+namespace WorkerService1;
+
+internal class Program
+{
+    private static void Main(string[] args)
+        => CreateHostBuilder(args).Build().Run();
+
+    #region snippet_CreateHostBuilder
+    public static IHostBuilder CreateHostBuilder(string[] args)
+        => Host.CreateDefaultBuilder(args)
+            .ConfigureServices(
+                (hostContext, services) =>
+                {
+                    services.AddHostedService<Worker>();
+
+                    // Set the active provider via configuration
+                    var configuration = hostContext.Configuration;
+                    var provider = configuration.GetValue("Provider", "SqlServer");
+
+                    services.AddDbContext<BlogContext>(
+                        options => _ = provider switch
+                        {
+                            "Sqlite" => options.UseSqlite(
+                                configuration.GetConnectionString("SqliteConnection"),
+                                x => x.MigrationsAssembly("SqliteMigrations")),
+
+                            "SqlServer" => options.UseSqlServer(
+                                configuration.GetConnectionString("SqlServerConnection"),
+                                x => x.MigrationsAssembly("SqlServerMigrations")),
+
+                            _ => throw new Exception($"Unsupported provider: {provider}")
+                        });
+                });
+    #endregion
+}
\ No newline at end of file
diff --git a/samples/core/Schemas/TwoProjectMigrations/WorkerService1/Worker.cs b/samples/core/Schemas/TwoProjectMigrations/WorkerService1/Worker.cs
new file mode 100644
index 0000000000..260fa9e157
--- /dev/null
+++ b/samples/core/Schemas/TwoProjectMigrations/WorkerService1/Worker.cs
@@ -0,0 +1,48 @@
+using System;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+
+namespace WorkerService1;
+
+internal class Worker : IHostedService, IDisposable
+{
+    private readonly IServiceProvider _services;
+
+    private Timer _timer;
+
+    public Worker(IServiceProvider services)
+        => _services = services;
+
+    public Task StartAsync(CancellationToken stoppingToken)
+    {
+        _timer = new Timer(
+            state => Execute(),
+            state: null,
+            dueTime: TimeSpan.Zero,
+            period: TimeSpan.FromDays(1));
+
+        return Task.CompletedTask;
+    }
+
+    private void Execute()
+    {
+        using var scope = _services.CreateScope();
+        var services = scope.ServiceProvider;
+
+        var db = services.GetService<BlogContext>();
+
+        // TODO: Something interesting
+    }
+
+    public Task StopAsync(CancellationToken stoppingToken)
+    {
+        _timer?.Change(Timeout.Infinite, 0);
+
+        return Task.CompletedTask;
+    }
+
+    public void Dispose()
+        => _timer?.Dispose();
+}
\ No newline at end of file
diff --git a/samples/core/Schemas/TwoProjectMigrations/WorkerService1/WorkerService1.csproj b/samples/core/Schemas/TwoProjectMigrations/WorkerService1/WorkerService1.csproj
new file mode 100644
index 0000000000..7248194cfa
--- /dev/null
+++ b/samples/core/Schemas/TwoProjectMigrations/WorkerService1/WorkerService1.csproj
@@ -0,0 +1,18 @@
+<Project Sdk="Microsoft.NET.Sdk.Worker">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <UserSecretsId>dotnet-WorkerService1-F7BD8083-51FA-4910-9F6D-FCDE8274AF8B</UserSecretsId>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="10.0.0">
+      <PrivateAssets>all</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+    </PackageReference>
+    <PackageReference Include="Microsoft.Extensions.Hosting" Version="7.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Schemas/TwoProjectMigrations/WorkerService1/appsettings.Development.json b/samples/core/Schemas/TwoProjectMigrations/WorkerService1/appsettings.Development.json
new file mode 100644
index 0000000000..8983e0fc1c
--- /dev/null
+++ b/samples/core/Schemas/TwoProjectMigrations/WorkerService1/appsettings.Development.json
@@ -0,0 +1,9 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft": "Warning",
+      "Microsoft.Hosting.Lifetime": "Information"
+    }
+  }
+}
diff --git a/samples/core/Schemas/TwoProjectMigrations/WorkerService1/appsettings.json b/samples/core/Schemas/TwoProjectMigrations/WorkerService1/appsettings.json
new file mode 100644
index 0000000000..23cf378bb6
--- /dev/null
+++ b/samples/core/Schemas/TwoProjectMigrations/WorkerService1/appsettings.json
@@ -0,0 +1,13 @@
+{
+  "ConnectionStrings": {
+    "SqliteConnection": "Data Source=WorkerService1.db;Cache=Shared",
+    "SqlServerConnection": "Data Source=(localdb)\\MSSQLLocalDB;Initial Catalog=WorkerService1"
+  },
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft": "Warning",
+      "Microsoft.Hosting.Lifetime": "Information"
+    }
+  }
+}
diff --git a/samples/core/Spatial/Projections/GeometryExtensions.cs b/samples/core/Spatial/Projections/GeometryExtensions.cs
new file mode 100644
index 0000000000..76d3be4dc9
--- /dev/null
+++ b/samples/core/Spatial/Projections/GeometryExtensions.cs
@@ -0,0 +1,79 @@
+using System.Collections.Generic;
+using ProjNet;
+using ProjNet.CoordinateSystems;
+using ProjNet.CoordinateSystems.Transformations;
+
+namespace NetTopologySuite.Geometries;
+
+#region snippet_GeometryExtensions
+public static class GeometryExtensions
+{
+    private static readonly CoordinateSystemServices _coordinateSystemServices
+        = new CoordinateSystemServices(
+            new Dictionary<int, string>
+            {
+                // Coordinate systems:
+
+                [4326] = GeographicCoordinateSystem.WGS84.WKT,
+
+                // This coordinate system covers the area of our data.
+                // Different data requires a different coordinate system.
+                [2855] =
+                    @"
+                        PROJCS[""NAD83(HARN) / Washington North"",
+                            GEOGCS[""NAD83(HARN)"",
+                                DATUM[""NAD83_High_Accuracy_Regional_Network"",
+                                    SPHEROID[""GRS 1980"",6378137,298.257222101,
+                                        AUTHORITY[""EPSG"",""7019""]],
+                                    AUTHORITY[""EPSG"",""6152""]],
+                                PRIMEM[""Greenwich"",0,
+                                    AUTHORITY[""EPSG"",""8901""]],
+                                UNIT[""degree"",0.01745329251994328,
+                                    AUTHORITY[""EPSG"",""9122""]],
+                                AUTHORITY[""EPSG"",""4152""]],
+                            PROJECTION[""Lambert_Conformal_Conic_2SP""],
+                            PARAMETER[""standard_parallel_1"",48.73333333333333],
+                            PARAMETER[""standard_parallel_2"",47.5],
+                            PARAMETER[""latitude_of_origin"",47],
+                            PARAMETER[""central_meridian"",-120.8333333333333],
+                            PARAMETER[""false_easting"",500000],
+                            PARAMETER[""false_northing"",0],
+                            UNIT[""metre"",1,
+                                AUTHORITY[""EPSG"",""9001""]],
+                            AUTHORITY[""EPSG"",""2855""]]
+                    "
+            });
+
+    public static Geometry ProjectTo(this Geometry geometry, int srid)
+    {
+        var transformation = _coordinateSystemServices.CreateTransformation(geometry.SRID, srid);
+
+        var result = geometry.Copy();
+        result.Apply(new MathTransformFilter(transformation.MathTransform));
+
+        return result;
+    }
+
+    private class MathTransformFilter : ICoordinateSequenceFilter
+    {
+        private readonly MathTransform _transform;
+
+        public MathTransformFilter(MathTransform transform)
+            => _transform = transform;
+
+        public bool Done => false;
+        public bool GeometryChanged => true;
+
+        public void Filter(CoordinateSequence seq, int i)
+        {
+            var x = seq.GetX(i);
+            var y = seq.GetY(i);
+            var z = seq.GetZ(i);
+            _transform.Transform(ref x, ref y, ref z);
+            seq.SetX(i, x);
+            seq.SetY(i, y);
+            seq.SetZ(i, z);
+        }
+    }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Spatial/Projections/Program.cs b/samples/core/Spatial/Projections/Program.cs
new file mode 100644
index 0000000000..497b6e043d
--- /dev/null
+++ b/samples/core/Spatial/Projections/Program.cs
@@ -0,0 +1,15 @@
+using System;
+using NetTopologySuite.Geometries;
+
+#region snippet_ProjectTo
+var seattle = new Point(-122.333056, 47.609722) { SRID = 4326 };
+var redmond = new Point(-122.123889, 47.669444) { SRID = 4326 };
+
+// In order to get the distance in meters, we need to project to an appropriate
+// coordinate system. In this case, we're using SRID 2855 since it covers the
+// geographic area of our data
+var distanceInDegrees = seattle.Distance(redmond);
+var distanceInMeters = seattle.ProjectTo(2855).Distance(redmond.ProjectTo(2855));
+#endregion
+Console.WriteLine($"Degrees: {distanceInDegrees:N4}");
+Console.WriteLine($"Meters:  {distanceInMeters:N0}");
diff --git a/samples/core/Spatial/Projections/Projections.csproj b/samples/core/Spatial/Projections/Projections.csproj
new file mode 100644
index 0000000000..ef1babb7a3
--- /dev/null
+++ b/samples/core/Spatial/Projections/Projections.csproj
@@ -0,0 +1,13 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="NetTopologySuite" Version="2.5.0" />
+    <PackageReference Include="ProjNet" Version="2.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Spatial/SqlServer/Models/City.cs b/samples/core/Spatial/SqlServer/Models/City.cs
new file mode 100644
index 0000000000..2a05744220
--- /dev/null
+++ b/samples/core/Spatial/SqlServer/Models/City.cs
@@ -0,0 +1,16 @@
+using System.ComponentModel.DataAnnotations.Schema;
+using NetTopologySuite.Geometries;
+
+namespace SqlServer.Models;
+
+#region snippet_City
+[Table("Cities", Schema = "Application")]
+public class City
+{
+    public int CityID { get; set; }
+
+    public string CityName { get; set; }
+
+    public Point Location { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Spatial/SqlServer/Models/Country.cs b/samples/core/Spatial/SqlServer/Models/Country.cs
new file mode 100644
index 0000000000..972a44992f
--- /dev/null
+++ b/samples/core/Spatial/SqlServer/Models/Country.cs
@@ -0,0 +1,17 @@
+using System.ComponentModel.DataAnnotations.Schema;
+using NetTopologySuite.Geometries;
+
+namespace SqlServer.Models;
+
+#region snippet_Country
+[Table("Countries", Schema = "Application")]
+public class Country
+{
+    public int CountryID { get; set; }
+
+    public string CountryName { get; set; }
+
+    // Database includes both Polygon and MultiPolygon values
+    public Geometry Border { get; set; }
+}
+#endregion
\ No newline at end of file
diff --git a/samples/core/Spatial/SqlServer/Models/StateProvince.cs b/samples/core/Spatial/SqlServer/Models/StateProvince.cs
new file mode 100644
index 0000000000..d22dc51cd1
--- /dev/null
+++ b/samples/core/Spatial/SqlServer/Models/StateProvince.cs
@@ -0,0 +1,14 @@
+using System.ComponentModel.DataAnnotations.Schema;
+using NetTopologySuite.Geometries;
+
+namespace SqlServer.Models;
+
+[Table("StateProvinces", Schema = "Application")]
+internal class StateProvince
+{
+    public int StateProvinceID { get; set; }
+
+    public string StateProvinceName { get; set; }
+
+    public Geometry Border { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Spatial/SqlServer/Models/WideWorldImportersContext.cs b/samples/core/Spatial/SqlServer/Models/WideWorldImportersContext.cs
new file mode 100644
index 0000000000..ece5a8ddfd
--- /dev/null
+++ b/samples/core/Spatial/SqlServer/Models/WideWorldImportersContext.cs
@@ -0,0 +1,19 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace SqlServer.Models;
+
+// This DbContext maps to the Wide World Importers sample database which can be
+// found at https://github.com/microsoft/sql-server-samples
+internal class WideWorldImportersContext : DbContext
+{
+    public DbSet<City> Cities { get; set; }
+    public DbSet<StateProvince> StateProvinces { get; set; }
+    public DbSet<Country> Countries { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder options) =>
+        #region snippet_UseNetTopologySuite
+        options.UseSqlServer(
+            @"Data Source=(localdb)\MSSQLLocalDB;Initial Catalog=WideWorldImporters;ConnectRetryCount=0",
+            x => x.UseNetTopologySuite());
+    #endregion
+}
diff --git a/samples/core/Spatial/SqlServer/Program.cs b/samples/core/Spatial/SqlServer/Program.cs
new file mode 100644
index 0000000000..49b1dc03b4
--- /dev/null
+++ b/samples/core/Spatial/SqlServer/Program.cs
@@ -0,0 +1,59 @@
+using System;
+using System.IO;
+using System.Linq;
+using Microsoft.EntityFrameworkCore;
+using NetTopologySuite.Geometries;
+using NetTopologySuite.IO;
+using SqlServer.Models;
+
+using (var context = new WideWorldImportersContext())
+{
+    await context.Database.EnsureDeletedAsync();
+    await context.Database.EnsureCreatedAsync();
+
+    context.AddRange(
+        new City { CityName = "Bellemondville", Location = new Point(-122.128822, 47.643703) { SRID = 4326 } },
+        new Country
+        {
+            CountryName = "'Merica",
+            Border = new Polygon(
+                new LinearRing(
+                    new[]
+                    {
+                        new Coordinate(-123.128822, 46.643703), new Coordinate(-121.128822, 46.643703),
+                        new Coordinate(-121.128822, 48.643703), new Coordinate(-123.128822, 48.643703),
+                        new Coordinate(-123.128822, 46.643703)
+                    })) { SRID = 4326 }
+        });
+
+    await context.SaveChangesAsync();
+}
+
+var currentLocation = new Point(-122.128822, 47.643703) { SRID = 4326 };
+using var db = new WideWorldImportersContext();
+#region snippet_Distance
+// Find the nearest city
+var nearestCity = await db.Cities
+    .OrderBy(c => c.Location.Distance(currentLocation))
+    .FirstOrDefaultAsync();
+#endregion
+Console.WriteLine($"Nearest city: {nearestCity.CityName}");
+#region snippet_Contains
+// Find the containing country
+var currentCountry = await db.Countries
+    .FirstOrDefaultAsync(c => c.Border.Contains(currentLocation));
+#endregion
+Console.WriteLine($"Current country: {currentCountry.CountryName}");
+
+// Find which states/provinces a route intersects
+var route = new GeoJsonReader().Read<LineString>(File.ReadAllText("seattle-to-new-york.json"));
+route.SRID = 4326;
+var statePorvincesIntersected = await (from s in db.StateProvinces
+                                 where s.Border.Intersects(route)
+                                 orderby s.Border.Distance(currentLocation)
+                                 select s).ToListAsync();
+Console.WriteLine("States/provinces intersected:");
+foreach (var state in statePorvincesIntersected)
+{
+    Console.WriteLine($"\t{state.StateProvinceName}");
+}
diff --git a/samples/core/Spatial/SqlServer/SqlServer.csproj b/samples/core/Spatial/SqlServer/SqlServer.csproj
new file mode 100644
index 0000000000..ea497f0a4d
--- /dev/null
+++ b/samples/core/Spatial/SqlServer/SqlServer.csproj
@@ -0,0 +1,19 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer.NetTopologySuite" Version="10.0.0" />
+    <PackageReference Include="NetTopologySuite.IO.GeoJSON" Version="4.0.0" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <None Update="seattle-to-new-york.json">
+      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+    </None>
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Spatial/SqlServer/seattle-to-new-york.json b/samples/core/Spatial/SqlServer/seattle-to-new-york.json
new file mode 100644
index 0000000000..81862ef62b
--- /dev/null
+++ b/samples/core/Spatial/SqlServer/seattle-to-new-york.json
@@ -0,0 +1 @@
+{"type":"LineString","coordinates":[[-122.13146,47.67858],[-122.17369,47.5799],[-120.23819,46.94394],[-119.96248,46.94465],[-119.82622,47.10318],[-118.37623,47.11245],[-117.44588,47.64893],[-116.96025,47.714],[-115.35444,47.37786],[-114.72767,47.0131],[-114.2339,47.01836],[-113.96157,46.86373],[-113.48148,46.88149],[-113.21216,47.04312],[-112.58324,46.96549],[-111.94157,47.4933],[-111.53627,47.56199],[-109.68868,46.983],[-109.26634,47.07646],[-107.83964,46.98666],[-106.90687,47.32573],[-105.74304,47.31147],[-105.56673,47.42511],[-104.83788,47.10131],[-103.36528,46.88766],[-100.84036,46.82052],[-96.63518,46.844],[-95.50308,45.8827],[-94.40394,45.60761],[-92.96039,44.94751],[-91.76663,44.90119],[-91.40596,44.76413],[-90.47463,43.9994],[-89.49739,43.49537],[-89.00555,42.80003],[-88.96248,42.24968],[-87.78353,41.98196],[-87.47747,41.61127],[-85.12568,41.75523],[-84.81203,41.62808],[-83.64069,41.59027],[-82.87298,41.35328],[-80.99251,41.24078],[-80.83004,41.10882],[-79.21478,41.19005],[-77.72717,40.94387],[-77.40887,41.06891],[-75.41735,41.07168],[-74.00714,40.71455]]}
diff --git a/samples/core/SqlServer/AzureDatabase/AzureSqlContext.cs b/samples/core/SqlServer/AzureDatabase/AzureSqlContext.cs
new file mode 100644
index 0000000000..4f9c49a204
--- /dev/null
+++ b/samples/core/SqlServer/AzureDatabase/AzureSqlContext.cs
@@ -0,0 +1,33 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace SqlServer.AzureDatabase;
+
+public class AzureSqlContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        optionsBuilder.UseSqlServer(
+            "Server=tcp:[serverName].database.windows.net;Database=myDataBase;User ID=[Login]@[serverName];Password=myPassword];Trusted_Connection=False;Encrypt=True;");
+    }
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        #region HasServiceTier
+        modelBuilder.HasServiceTier("BusinessCritical");
+        #endregion
+
+        #region HasDatabaseMaxSize
+        modelBuilder.HasDatabaseMaxSize("2 GB");
+        #endregion
+
+        #region HasPerformanceLevelSql
+        modelBuilder.HasPerformanceLevelSql("ELASTIC_POOL ( name = myelasticpool )");
+        #endregion
+
+        #region HasPerformanceLevel
+        modelBuilder.HasPerformanceLevel("BC_Gen4_1");
+        #endregion
+    }
+}
\ No newline at end of file
diff --git a/samples/core/SqlServer/AzureDatabase/Blog.cs b/samples/core/SqlServer/AzureDatabase/Blog.cs
new file mode 100644
index 0000000000..3ade63d49c
--- /dev/null
+++ b/samples/core/SqlServer/AzureDatabase/Blog.cs
@@ -0,0 +1,7 @@
+namespace SqlServer.AzureDatabase;
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/SqlServer/Columns/Blog.cs b/samples/core/SqlServer/Columns/Blog.cs
new file mode 100644
index 0000000000..a09249d1a5
--- /dev/null
+++ b/samples/core/SqlServer/Columns/Blog.cs
@@ -0,0 +1,10 @@
+using System;
+
+namespace SqlServer.Columns;
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public DateTime PublishedOn { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/SqlServer/Columns/RareBlog.cs b/samples/core/SqlServer/Columns/RareBlog.cs
new file mode 100644
index 0000000000..05e9a24a16
--- /dev/null
+++ b/samples/core/SqlServer/Columns/RareBlog.cs
@@ -0,0 +1,6 @@
+namespace SqlServer.Columns;
+
+public class RareBlog : Blog
+{
+    public string RareProperty { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/SqlServer/Columns/SparseColumnContext.cs b/samples/core/SqlServer/Columns/SparseColumnContext.cs
new file mode 100644
index 0000000000..98d3bd7d2e
--- /dev/null
+++ b/samples/core/SqlServer/Columns/SparseColumnContext.cs
@@ -0,0 +1,18 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace SqlServer.Columns;
+
+public class SparseColumnContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+    public DbSet<RareBlog> RareBlogs { get; set; }
+
+    #region SparseColumn
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<RareBlog>()
+            .Property(b => b.RareProperty)
+            .IsSparse();
+    }
+    #endregion
+}
\ No newline at end of file
diff --git a/samples/core/SqlServer/InMemory/Blog.cs b/samples/core/SqlServer/InMemory/Blog.cs
new file mode 100644
index 0000000000..1bff38ddb3
--- /dev/null
+++ b/samples/core/SqlServer/InMemory/Blog.cs
@@ -0,0 +1,7 @@
+namespace SqlServer.InMemory;
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/SqlServer/InMemory/InMemoryContext.cs b/samples/core/SqlServer/InMemory/InMemoryContext.cs
new file mode 100644
index 0000000000..6cc670a126
--- /dev/null
+++ b/samples/core/SqlServer/InMemory/InMemoryContext.cs
@@ -0,0 +1,15 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace SqlServer.InMemory;
+
+public class InMemoryContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region IsMemoryOptimized
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>().ToTable(b => b.IsMemoryOptimized());
+    }
+    #endregion
+}
diff --git a/samples/core/SqlServer/InMemory/Sample.cs b/samples/core/SqlServer/InMemory/Sample.cs
new file mode 100644
index 0000000000..a2539ea37a
--- /dev/null
+++ b/samples/core/SqlServer/InMemory/Sample.cs
@@ -0,0 +1,5 @@
+namespace SqlServer.InMemory;
+
+public class Sample
+{
+}
\ No newline at end of file
diff --git a/samples/core/SqlServer/Indexes/Blog.cs b/samples/core/SqlServer/Indexes/Blog.cs
new file mode 100644
index 0000000000..2f925f6798
--- /dev/null
+++ b/samples/core/SqlServer/Indexes/Blog.cs
@@ -0,0 +1,10 @@
+using System;
+
+namespace SqlServer.Indexes;
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+    public DateTime PublishedOn { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/SqlServer/Indexes/ClusteredIndexContext.cs b/samples/core/SqlServer/Indexes/ClusteredIndexContext.cs
new file mode 100644
index 0000000000..30113b7fb7
--- /dev/null
+++ b/samples/core/SqlServer/Indexes/ClusteredIndexContext.cs
@@ -0,0 +1,15 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace SqlServer.Indexes;
+
+public class ClusteredIndexContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region ClusteredIndex
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>().HasIndex(b => b.PublishedOn).IsClustered();
+    }
+    #endregion
+}
\ No newline at end of file
diff --git a/samples/core/SqlServer/Indexes/IndexFillFactorContext.cs b/samples/core/SqlServer/Indexes/IndexFillFactorContext.cs
new file mode 100644
index 0000000000..6eae0d4e53
--- /dev/null
+++ b/samples/core/SqlServer/Indexes/IndexFillFactorContext.cs
@@ -0,0 +1,15 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace SqlServer.Indexes;
+
+public class IndexFillFactorContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region IndexFillFactor
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>().HasIndex(b => b.PublishedOn).HasFillFactor(10);
+    }
+    #endregion
+}
\ No newline at end of file
diff --git a/samples/core/SqlServer/Indexes/IndexOnlineContext.cs b/samples/core/SqlServer/Indexes/IndexOnlineContext.cs
new file mode 100644
index 0000000000..213be7b167
--- /dev/null
+++ b/samples/core/SqlServer/Indexes/IndexOnlineContext.cs
@@ -0,0 +1,15 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace SqlServer.Indexes;
+
+public class IndexOnlineContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region IndexOnline
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>().HasIndex(b => b.PublishedOn).IsCreatedOnline();
+    }
+    #endregion
+}
\ No newline at end of file
diff --git a/samples/core/SqlServer/Program.cs b/samples/core/SqlServer/Program.cs
new file mode 100644
index 0000000000..0851e3acb4
--- /dev/null
+++ b/samples/core/SqlServer/Program.cs
@@ -0,0 +1,8 @@
+namespace SqlServer;
+
+public class Program
+{
+    private static void Main()
+    {
+    }
+}
\ No newline at end of file
diff --git a/samples/core/SqlServer/SqlServer.csproj b/samples/core/SqlServer/SqlServer.csproj
new file mode 100644
index 0000000000..f841b54fe4
--- /dev/null
+++ b/samples/core/SqlServer/SqlServer.csproj
@@ -0,0 +1,12 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/SqlServer/ValueGeneration/Blog.cs b/samples/core/SqlServer/ValueGeneration/Blog.cs
new file mode 100644
index 0000000000..38935c429f
--- /dev/null
+++ b/samples/core/SqlServer/ValueGeneration/Blog.cs
@@ -0,0 +1,7 @@
+namespace SqlServer.ValueGeneration;
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/SqlServer/ValueGeneration/ExplicitIdentityValues.cs b/samples/core/SqlServer/ValueGeneration/ExplicitIdentityValues.cs
new file mode 100644
index 0000000000..e9a26300ae
--- /dev/null
+++ b/samples/core/SqlServer/ValueGeneration/ExplicitIdentityValues.cs
@@ -0,0 +1,45 @@
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace SqlServer.ValueGeneration;
+
+public class ExplicitIdentityValuesContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.UseSqlServer(
+            @"Server=(localdb)\mssqllocaldb;Database=EFSaving.Basics;Trusted_Connection=True");
+}
+
+public class ExplicitIdentityValues
+{
+    public static async Task Run()
+    {
+        using (var context = new ExplicitIdentityValuesContext())
+        {
+            await context.Database.EnsureDeletedAsync();
+            await context.Database.EnsureCreatedAsync();
+        }
+
+        #region ExplicitIdentityValues
+        using (var context = new ExplicitIdentityValuesContext())
+        {
+            context.Blogs.Add(new Blog { BlogId = 100, Url = "http://blog1.somesite.com" });
+            context.Blogs.Add(new Blog { BlogId = 101, Url = "http://blog2.somesite.com" });
+
+            await context.Database.OpenConnectionAsync();
+            try
+            {
+                await context.Database.ExecuteSqlRawAsync("SET IDENTITY_INSERT dbo.Blogs ON");
+                await context.SaveChangesAsync();
+                await context.Database.ExecuteSqlRawAsync("SET IDENTITY_INSERT dbo.Blogs OFF");
+            }
+            finally
+            {
+                await context.Database.CloseConnectionAsync();
+            }
+        }
+        #endregion
+    }
+}
diff --git a/samples/core/SqlServer/ValueGeneration/IdentityOptionsContext.cs b/samples/core/SqlServer/ValueGeneration/IdentityOptionsContext.cs
new file mode 100644
index 0000000000..2d0e7fab6c
--- /dev/null
+++ b/samples/core/SqlServer/ValueGeneration/IdentityOptionsContext.cs
@@ -0,0 +1,17 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace SqlServer.ValueGeneration;
+
+public class IdentityOptionsContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region IdentityOptions
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .Property(b => b.BlogId)
+            .UseIdentityColumn(seed: 10, increment: 10);
+    }
+    #endregion
+}
\ No newline at end of file
diff --git a/samples/core/Sqlite/ValueGeneration/SqliteAutoincrementWithValueConverter.cs b/samples/core/Sqlite/ValueGeneration/SqliteAutoincrementWithValueConverter.cs
new file mode 100644
index 0000000000..b237f7b9d2
--- /dev/null
+++ b/samples/core/Sqlite/ValueGeneration/SqliteAutoincrementWithValueConverter.cs
@@ -0,0 +1,36 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFCore.Sqlite.ValueGeneration;
+
+public readonly struct BlogId
+{
+    public BlogId(int value) => Value = value;
+    public int Value { get; }
+    
+    public static implicit operator int(BlogId id) => id.Value;
+    public static implicit operator BlogId(int value) => new(value);
+}
+
+public class SqliteAutoincrementWithValueConverterContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region SqliteAutoincrementWithValueConverter
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .Property(b => b.Id)
+            .HasConversion<int>()
+            .UseAutoincrement();
+    }
+    #endregion
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.UseSqlite("Data Source=sample.db");
+}
+
+public class Blog
+{
+    public BlogId Id { get; set; }
+    public string Title { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Sqlite/ValueGeneration/SqliteValueGeneratedNever.cs b/samples/core/Sqlite/ValueGeneration/SqliteValueGeneratedNever.cs
new file mode 100644
index 0000000000..bd886153af
--- /dev/null
+++ b/samples/core/Sqlite/ValueGeneration/SqliteValueGeneratedNever.cs
@@ -0,0 +1,20 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace EFCore.Sqlite.ValueGeneration;
+
+public class SqliteValueGeneratedNeverContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region SqliteValueGeneratedNever
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .Property(b => b.Id)
+            .ValueGeneratedNever();
+    }
+    #endregion
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.UseSqlite("Data Source=sample.db");
+}
diff --git a/samples/core/Sqlite/ValueGeneration/SqliteValueGeneration.csproj b/samples/core/Sqlite/ValueGeneration/SqliteValueGeneration.csproj
new file mode 100644
index 0000000000..6798d6ed9c
--- /dev/null
+++ b/samples/core/Sqlite/ValueGeneration/SqliteValueGeneration.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>disable</Nullable>
+    <OutputType>Library</OutputType>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0-rc.1.25451.107" />
+  </ItemGroup>
+
+</Project>
\ No newline at end of file
diff --git a/samples/core/Sqlite/ValueGeneration/SqliteValueGenerationStrategyNone.cs b/samples/core/Sqlite/ValueGeneration/SqliteValueGenerationStrategyNone.cs
new file mode 100644
index 0000000000..2fc0f5060e
--- /dev/null
+++ b/samples/core/Sqlite/ValueGeneration/SqliteValueGenerationStrategyNone.cs
@@ -0,0 +1,27 @@
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Sqlite.Metadata;
+
+namespace EFCore.Sqlite.ValueGeneration;
+
+public class SqliteValueGenerationStrategyNoneContext : DbContext
+{
+    public DbSet<Blog> Blogs { get; set; }
+
+    #region SqliteValueGenerationStrategyNone
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Blog>()
+            .Property(b => b.Id)
+            .Metadata.SetValueGenerationStrategy(SqliteValueGenerationStrategy.None);
+    }
+    #endregion
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.UseSqlite("Data Source=sample.db");
+}
+
+public class Blog
+{
+    public int Id { get; set; }
+    public string Title { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Testing/BloggingWebApi/BloggingWebApi.csproj b/samples/core/Testing/BloggingWebApi/BloggingWebApi.csproj
new file mode 100644
index 0000000000..582b90f7ae
--- /dev/null
+++ b/samples/core/Testing/BloggingWebApi/BloggingWebApi.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>Items</RootNamespace>
+    <RootNamespace>EF.Testing.BloggingWebApi</RootNamespace>
+    <AssemblyName>EF.Testing.BloggingWebApi</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\BusinessLogic\BusinessLogic.csproj" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Testing/BloggingWebApi/Controllers/BloggingController.cs b/samples/core/Testing/BloggingWebApi/Controllers/BloggingController.cs
new file mode 100644
index 0000000000..fe4feee86f
--- /dev/null
+++ b/samples/core/Testing/BloggingWebApi/Controllers/BloggingController.cs
@@ -0,0 +1,64 @@
+using System.Collections.Generic;
+using System.Data;
+using System.Linq;
+using System.Threading.Tasks;
+using EF.Testing.BusinessLogic;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.EntityFrameworkCore;
+
+namespace EF.Testing.BloggingWebApi.Controllers;
+
+[ApiController]
+[Route("[controller]")]
+public class BloggingController : ControllerBase
+{
+    private readonly BloggingContext _context;
+
+    public BloggingController(BloggingContext context)
+        => _context = context;
+
+    #region GetBlog
+    [HttpGet]
+    public async Task<ActionResult<Blog>> GetBlog(string name)
+    {
+        var blog = await _context.Blogs.FirstOrDefaultAsync(b => b.Name == name);
+        return blog is null ? NotFound() : blog;
+    }
+    #endregion
+
+    [HttpGet]
+    public IAsyncEnumerable<Blog> GetAllBlogs()
+        => _context.Blogs.OrderBy(b => b.Name).AsAsyncEnumerable();
+
+    #region AddBlog
+    [HttpPost]
+    public async Task<ActionResult> AddBlog(string name, string url)
+    {
+        _context.Blogs.Add(new Blog { Name = name, Url = url });
+        await _context.SaveChangesAsync();
+
+        return Ok();
+    }
+    #endregion
+
+    #region UpdateBlogUrl
+    [HttpPost]
+    public async Task<ActionResult> UpdateBlogUrl(string name, string url)
+    {
+        // Note: it isn't usually necessary to start a transaction for updating. This is done here for illustration purposes only.
+        await using var transaction = await _context.Database.BeginTransactionAsync(IsolationLevel.Serializable);
+
+        var blog = await _context.Blogs.FirstOrDefaultAsync(b => b.Name == name);
+        if (blog is null)
+        {
+            return NotFound();
+        }
+
+        blog.Url = url;
+        await _context.SaveChangesAsync();
+
+        await transaction.CommitAsync();
+        return Ok();
+    }
+    #endregion
+}
diff --git a/samples/core/Testing/BloggingWebApi/Controllers/BloggingControllerWithRepository.cs b/samples/core/Testing/BloggingWebApi/Controllers/BloggingControllerWithRepository.cs
new file mode 100644
index 0000000000..f5d61ca109
--- /dev/null
+++ b/samples/core/Testing/BloggingWebApi/Controllers/BloggingControllerWithRepository.cs
@@ -0,0 +1,51 @@
+using System;
+using System.Collections.Generic;
+using System.Data;
+using System.Linq;
+using System.Threading.Tasks;
+using EF.Testing.BusinessLogic;
+using Microsoft.AspNetCore.Mvc;
+
+namespace EF.Testing.BloggingWebApi.Controllers;
+
+[ApiController]
+[Route("[controller]")]
+public class BloggingControllerWithRepository : ControllerBase
+{
+    #region BloggingControllerWithRepository
+    private readonly IBloggingRepository _repository;
+
+    public BloggingControllerWithRepository(IBloggingRepository repository)
+        => _repository = repository;
+
+    [HttpGet]
+    public async Task<Blog> GetBlog(string name)
+        => await _repository.GetBlogByNameAsync(name);
+    #endregion
+
+    [HttpGet]
+    public IAsyncEnumerable<Blog> GetAllBlogs()
+        => _repository.GetAllBlogsAsync();
+
+    [HttpPost]
+    public async Task AddBlog(string name, string url)
+    {
+        _repository.AddBlog(new Blog { Name = name, Url = url });
+        await _repository.SaveChangesAsync();
+    }
+
+    [HttpPost]
+    public async Task<ActionResult> UpdateBlogUrl(string name, string url)
+    {
+        var blog = await _repository.GetBlogByNameAsync(name);
+        if (blog is null)
+        {
+            return NotFound();
+        }
+
+        blog.Url = url;
+        await _repository.SaveChangesAsync();
+
+        return Ok();
+    }
+}
diff --git a/samples/core/Testing/BloggingWebApi/Program.cs b/samples/core/Testing/BloggingWebApi/Program.cs
new file mode 100644
index 0000000000..a11c5f68f3
--- /dev/null
+++ b/samples/core/Testing/BloggingWebApi/Program.cs
@@ -0,0 +1,16 @@
+using Microsoft.AspNetCore.Hosting;
+using Microsoft.Extensions.Hosting;
+
+namespace EF.Testing.BloggingWebApi;
+
+public class Program
+{
+    public static void Main(string[] args)
+    {
+        CreateHostBuilder(args).Build().Run();
+    }
+
+    public static IHostBuilder CreateHostBuilder(string[] args) =>
+        Host.CreateDefaultBuilder(args)
+            .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseStartup<Startup>(); });
+}
\ No newline at end of file
diff --git a/samples/core/Testing/BloggingWebApi/Properties/launchSettings.json b/samples/core/Testing/BloggingWebApi/Properties/launchSettings.json
new file mode 100644
index 0000000000..117c7b9765
--- /dev/null
+++ b/samples/core/Testing/BloggingWebApi/Properties/launchSettings.json
@@ -0,0 +1,12 @@
+{
+  "profiles": {
+    "BloggingWebApi": {
+      "commandName": "Project",
+      "launchBrowser": true,
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      },
+      "applicationUrl": "https://localhost:58208;http://localhost:58212"
+    }
+  }
+}
\ No newline at end of file
diff --git a/samples/core/Testing/BloggingWebApi/Startup.cs b/samples/core/Testing/BloggingWebApi/Startup.cs
new file mode 100644
index 0000000000..85dd5fd101
--- /dev/null
+++ b/samples/core/Testing/BloggingWebApi/Startup.cs
@@ -0,0 +1,45 @@
+using EF.Testing.BusinessLogic;
+using Microsoft.AspNetCore.Builder;
+using Microsoft.AspNetCore.Hosting;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+
+namespace EF.Testing.BloggingWebApi;
+
+public class Startup
+{
+    public Startup(IConfiguration configuration)
+    {
+        Configuration = configuration;
+    }
+
+    public IConfiguration Configuration { get; }
+
+    public void ConfigureServices(IServiceCollection services)
+    {
+        services.AddControllers();
+
+        services.AddDbContext<BloggingContext>(
+            b => b.UseSqlServer(
+                @"Server=(localdb)\mssqllocaldb;Database=EFTestSample;Trusted_Connection=True;ConnectRetryCount=0"));
+
+        #region RegisterRepositoryInDI
+        services.AddScoped<IBloggingRepository, BloggingRepository>();
+        #endregion
+    }
+
+    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
+    {
+        if (env.IsDevelopment())
+        {
+            app.UseDeveloperExceptionPage();
+        }
+
+        app.UseHttpsRedirection();
+        app.UseRouting();
+        app.UseAuthorization();
+        app.UseEndpoints(endpoints => { endpoints.MapControllers(); });
+    }
+}
diff --git a/samples/core/Testing/BloggingWebApi/appsettings.Development.json b/samples/core/Testing/BloggingWebApi/appsettings.Development.json
new file mode 100644
index 0000000000..8983e0fc1c
--- /dev/null
+++ b/samples/core/Testing/BloggingWebApi/appsettings.Development.json
@@ -0,0 +1,9 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft": "Warning",
+      "Microsoft.Hosting.Lifetime": "Information"
+    }
+  }
+}
diff --git a/samples/core/Testing/BloggingWebApi/appsettings.json b/samples/core/Testing/BloggingWebApi/appsettings.json
new file mode 100644
index 0000000000..d9d9a9bff6
--- /dev/null
+++ b/samples/core/Testing/BloggingWebApi/appsettings.json
@@ -0,0 +1,10 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft": "Warning",
+      "Microsoft.Hosting.Lifetime": "Information"
+    }
+  },
+  "AllowedHosts": "*"
+}
diff --git a/samples/core/Testing/BusinessLogic/Blog.cs b/samples/core/Testing/BusinessLogic/Blog.cs
new file mode 100644
index 0000000000..645ef99ce0
--- /dev/null
+++ b/samples/core/Testing/BusinessLogic/Blog.cs
@@ -0,0 +1,8 @@
+namespace EF.Testing.BusinessLogic;
+
+public class Blog
+{
+    public int BlogId { get; set; }
+    public string Name { get; set; }
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Testing/BusinessLogic/BloggingContext.cs b/samples/core/Testing/BusinessLogic/BloggingContext.cs
new file mode 100644
index 0000000000..be93d0a4cc
--- /dev/null
+++ b/samples/core/Testing/BusinessLogic/BloggingContext.cs
@@ -0,0 +1,46 @@
+using System;
+using Microsoft.EntityFrameworkCore;
+
+namespace EF.Testing.BusinessLogic;
+
+public class BloggingContext : DbContext
+{
+    private readonly Action<BloggingContext, ModelBuilder> _modelCustomizer;
+
+    #region Constructors
+    public BloggingContext()
+    {
+    }
+
+    public BloggingContext(DbContextOptions<BloggingContext> options, Action<BloggingContext, ModelBuilder> modelCustomizer = null)
+        : base(options)
+    {
+        _modelCustomizer = modelCustomizer;
+    }
+    #endregion
+
+    public DbSet<Blog> Blogs => Set<Blog>();
+    public DbSet<UrlResource> UrlResources => Set<UrlResource>();
+
+    #region OnConfiguring
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+    {
+        if (!optionsBuilder.IsConfigured)
+        {
+            optionsBuilder.UseSqlServer(
+                @"Server=(localdb)\mssqllocaldb;Database=EFProviders.InMemory;Trusted_Connection=True;ConnectRetryCount=0");
+        }
+    }
+    #endregion
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<UrlResource>().HasNoKey()
+            .ToView("AllResources");
+
+        if (_modelCustomizer is not null)
+        {
+            _modelCustomizer(this, modelBuilder);
+        }
+    }
+}
diff --git a/samples/core/Testing/BusinessLogic/BloggingRepository.cs b/samples/core/Testing/BusinessLogic/BloggingRepository.cs
new file mode 100644
index 0000000000..9fdf05d074
--- /dev/null
+++ b/samples/core/Testing/BusinessLogic/BloggingRepository.cs
@@ -0,0 +1,28 @@
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+
+namespace EF.Testing.BusinessLogic;
+
+#region BloggingRepository
+public class BloggingRepository : IBloggingRepository
+{
+    private readonly BloggingContext _context;
+
+    public BloggingRepository(BloggingContext context)
+        => _context = context;
+
+    public async Task<Blog> GetBlogByNameAsync(string name)
+        => await _context.Blogs.FirstOrDefaultAsync(b => b.Name == name);
+    #endregion
+
+    public IAsyncEnumerable<Blog> GetAllBlogsAsync()
+        => _context.Blogs.AsAsyncEnumerable();
+
+    public void AddBlog(Blog blog)
+        => _context.Add(blog);
+
+    public async Task SaveChangesAsync()
+        => await _context.SaveChangesAsync();
+}
diff --git a/samples/core/Testing/BusinessLogic/BusinessLogic.csproj b/samples/core/Testing/BusinessLogic/BusinessLogic.csproj
new file mode 100644
index 0000000000..c6d92da97f
--- /dev/null
+++ b/samples/core/Testing/BusinessLogic/BusinessLogic.csproj
@@ -0,0 +1,13 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EF.Testing.BusinessLogic</RootNamespace>
+    <AssemblyName>EF.Testing.BusinessLogic</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.0" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Testing/BusinessLogic/IBloggingRepository.cs b/samples/core/Testing/BusinessLogic/IBloggingRepository.cs
new file mode 100644
index 0000000000..d96a45a788
--- /dev/null
+++ b/samples/core/Testing/BusinessLogic/IBloggingRepository.cs
@@ -0,0 +1,17 @@
+using System.Collections.Generic;
+using System.Threading.Tasks;
+
+namespace EF.Testing.BusinessLogic;
+
+#region IBloggingRepository
+public interface IBloggingRepository
+{
+    Task<Blog> GetBlogByNameAsync(string name);
+
+    IAsyncEnumerable<Blog> GetAllBlogsAsync();
+
+    void AddBlog(Blog blog);
+
+    Task SaveChangesAsync();
+}
+#endregion
diff --git a/samples/core/Testing/BusinessLogic/UrlResource.cs b/samples/core/Testing/BusinessLogic/UrlResource.cs
new file mode 100644
index 0000000000..4c75f507b9
--- /dev/null
+++ b/samples/core/Testing/BusinessLogic/UrlResource.cs
@@ -0,0 +1,6 @@
+namespace EF.Testing.BusinessLogic;
+
+public class UrlResource
+{
+    public string Url { get; set; }
+}
\ No newline at end of file
diff --git a/samples/core/Testing/TestingWithTheDatabase/BloggingControllerTest.cs b/samples/core/Testing/TestingWithTheDatabase/BloggingControllerTest.cs
new file mode 100644
index 0000000000..82670b92cb
--- /dev/null
+++ b/samples/core/Testing/TestingWithTheDatabase/BloggingControllerTest.cs
@@ -0,0 +1,64 @@
+using System.Linq;
+using System.Threading.Tasks;
+using EF.Testing.BloggingWebApi.Controllers;
+using Microsoft.EntityFrameworkCore;
+using Xunit;
+
+namespace EF.Testing.IntegrationTests;
+
+#region UsingTheFixture
+public class BloggingControllerTest : IClassFixture<TestDatabaseFixture>
+{
+    public BloggingControllerTest(TestDatabaseFixture fixture)
+        => Fixture = fixture;
+
+    public TestDatabaseFixture Fixture { get; }
+    #endregion
+
+    #region GetBlog
+    [Fact]
+    public async Task GetBlog()
+    {
+        using var context = Fixture.CreateContext();
+        var controller = new BloggingController(context);
+
+        var blog = (await controller.GetBlog("Blog2")).Value;
+
+        Assert.Equal("http://blog2.com", blog.Url);
+    }
+    #endregion
+
+    #region GetAllBlogs
+    [Fact]
+    public async Task GetAllBlogs()
+    {
+        using var context = Fixture.CreateContext();
+        var controller = new BloggingController(context);
+
+        var blogs = await controller.GetAllBlogs().ToListAsync();
+
+        Assert.Collection(
+            blogs,
+            b => Assert.Equal("Blog1", b.Name),
+            b => Assert.Equal("Blog2", b.Name));
+    }
+    #endregion
+
+    #region AddBlog
+    [Fact]
+    public async Task AddBlog()
+    {
+        using var context = Fixture.CreateContext();
+        context.Database.BeginTransaction();
+
+        var controller = new BloggingController(context);
+        await controller.AddBlog("Blog3", "http://blog3.com");
+
+        context.ChangeTracker.Clear();
+
+        var blog = await context.Blogs.SingleAsync(b => b.Name == "Blog3");
+        Assert.Equal("http://blog3.com", blog.Url);
+
+    }
+    #endregion
+}
diff --git a/samples/core/Testing/TestingWithTheDatabase/TestDatabaseFixture.cs b/samples/core/Testing/TestingWithTheDatabase/TestDatabaseFixture.cs
new file mode 100644
index 0000000000..7b396bc1f8
--- /dev/null
+++ b/samples/core/Testing/TestingWithTheDatabase/TestDatabaseFixture.cs
@@ -0,0 +1,42 @@
+using EF.Testing.BusinessLogic;
+using Microsoft.EntityFrameworkCore;
+
+namespace EF.Testing.IntegrationTests;
+
+#region TestDatabaseFixture
+public class TestDatabaseFixture
+{
+    private const string ConnectionString = @"Server=(localdb)\mssqllocaldb;Database=EFTestSample;Trusted_Connection=True;ConnectRetryCount=0";
+
+    private static readonly object _lock = new();
+    private static bool _databaseInitialized;
+
+    public TestDatabaseFixture()
+    {
+        lock (_lock)
+        {
+            if (!_databaseInitialized)
+            {
+                using (var context = CreateContext())
+                {
+                    context.Database.EnsureDeleted();
+                    context.Database.EnsureCreated();
+
+                    context.AddRange(
+                        new Blog { Name = "Blog1", Url = "http://blog1.com" },
+                        new Blog { Name = "Blog2", Url = "http://blog2.com" });
+                    context.SaveChanges();
+                }
+
+                _databaseInitialized = true;
+            }
+        }
+    }
+
+    public BloggingContext CreateContext()
+        => new BloggingContext(
+            new DbContextOptionsBuilder<BloggingContext>()
+                .UseSqlServer(ConnectionString)
+                .Options);
+}
+#endregion
diff --git a/samples/core/Testing/TestingWithTheDatabase/TestingWithTheDatabase.csproj b/samples/core/Testing/TestingWithTheDatabase/TestingWithTheDatabase.csproj
new file mode 100644
index 0000000000..4e6eaeae41
--- /dev/null
+++ b/samples/core/Testing/TestingWithTheDatabase/TestingWithTheDatabase.csproj
@@ -0,0 +1,23 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EF.Testing.IntegrationTests</RootNamespace>
+    <AssemblyName>EF.Testing.IntegrationTests</AssemblyName>
+    <IsPackable>false</IsPackable>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="18.0.1" />
+    <PackageReference Include="xunit" Version="2.4.2" />
+    <PackageReference Include="xunit.runner.visualstudio" Version="2.4.5">
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+      <PrivateAssets>all</PrivateAssets>
+    </PackageReference>
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\BloggingWebApi\BloggingWebApi.csproj" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/Testing/TestingWithTheDatabase/TransactionalBloggingControllerTest.cs b/samples/core/Testing/TestingWithTheDatabase/TransactionalBloggingControllerTest.cs
new file mode 100644
index 0000000000..b9b220446f
--- /dev/null
+++ b/samples/core/Testing/TestingWithTheDatabase/TransactionalBloggingControllerTest.cs
@@ -0,0 +1,42 @@
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+using EF.Testing.BloggingWebApi.Controllers;
+using Microsoft.EntityFrameworkCore;
+using Xunit;
+
+namespace EF.Testing.IntegrationTests;
+
+#region UsingTheFixture
+[Collection("TransactionalTests")]
+public class TransactionalBloggingControllerTest : IDisposable
+{
+    public TransactionalBloggingControllerTest(TransactionalTestDatabaseFixture fixture)
+        => Fixture = fixture;
+
+    public TransactionalTestDatabaseFixture Fixture { get; }
+    #endregion
+
+    #region UpdateBlogUrl
+    [Fact]
+    public async Task UpdateBlogUrl()
+    {
+        using (var context = Fixture.CreateContext())
+        {
+            var controller = new BloggingController(context);
+            await controller.UpdateBlogUrl("Blog2", "http://blog2_updated.com");
+        }
+
+        using (var context = Fixture.CreateContext())
+        {
+            var blog = await context.Blogs.SingleAsync(b => b.Name == "Blog2");
+            Assert.Equal("http://blog2_updated.com", blog.Url);
+        }
+    }
+    #endregion
+
+    #region Dispose
+    public void Dispose()
+        => Fixture.Cleanup();
+    #endregion
+}
diff --git a/samples/core/Testing/TestingWithTheDatabase/TransactionalTestDatabaseFixture.cs b/samples/core/Testing/TestingWithTheDatabase/TransactionalTestDatabaseFixture.cs
new file mode 100644
index 0000000000..0dba2699a7
--- /dev/null
+++ b/samples/core/Testing/TestingWithTheDatabase/TransactionalTestDatabaseFixture.cs
@@ -0,0 +1,48 @@
+using EF.Testing.BusinessLogic;
+using Microsoft.EntityFrameworkCore;
+using Xunit;
+
+namespace EF.Testing.IntegrationTests;
+
+#region TransactionalTestDatabaseFixture
+public class TransactionalTestDatabaseFixture
+{
+    private const string ConnectionString = @"Server=(localdb)\mssqllocaldb;Database=EFTransactionalTestSample;Trusted_Connection=True;ConnectRetryCount=0";
+
+    public BloggingContext CreateContext()
+        => new BloggingContext(
+            new DbContextOptionsBuilder<BloggingContext>()
+                .UseSqlServer(ConnectionString)
+                .Options);
+
+    public TransactionalTestDatabaseFixture()
+    {
+        using var context = CreateContext();
+        context.Database.EnsureDeleted();
+        context.Database.EnsureCreated();
+
+        Cleanup();
+    }
+
+    public void Cleanup()
+    {
+        #region Cleanup
+        using var context = CreateContext();
+
+        context.Blogs.RemoveRange(context.Blogs);
+
+        context.AddRange(
+            new Blog { Name = "Blog1", Url = "http://blog1.com" },
+            new Blog { Name = "Blog2", Url = "http://blog2.com" });
+        context.SaveChanges();
+        #endregion
+    }
+}
+#endregion
+
+#region CollectionDefinition
+[CollectionDefinition("TransactionalTests")]
+public class TransactionalTestsCollection : ICollectionFixture<TransactionalTestDatabaseFixture>
+{
+}
+#endregion
diff --git a/samples/core/Testing/TestingWithoutTheDatabase/InMemoryBloggingControllerTest.cs b/samples/core/Testing/TestingWithoutTheDatabase/InMemoryBloggingControllerTest.cs
new file mode 100644
index 0000000000..2c3744d999
--- /dev/null
+++ b/samples/core/Testing/TestingWithoutTheDatabase/InMemoryBloggingControllerTest.cs
@@ -0,0 +1,94 @@
+using System.Linq;
+using System.Threading.Tasks;
+using EF.Testing.BloggingWebApi.Controllers;
+using EF.Testing.BusinessLogic;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+using Xunit;
+
+namespace EF.Testing.UnitTests;
+
+public class InMemoryBloggingControllerTest
+{
+    private readonly DbContextOptions<BloggingContext> _contextOptions;
+
+    #region Constructor
+    public InMemoryBloggingControllerTest()
+    {
+        _contextOptions = new DbContextOptionsBuilder<BloggingContext>()
+            .UseInMemoryDatabase("BloggingControllerTest")
+            .ConfigureWarnings(b => b.Ignore(InMemoryEventId.TransactionIgnoredWarning))
+            .Options;
+
+        using var context = new BloggingContext(_contextOptions);
+
+        context.Database.EnsureDeleted();
+        context.Database.EnsureCreated();
+
+        context.AddRange(
+            new Blog { Name = "Blog1", Url = "http://blog1.com" },
+            new Blog { Name = "Blog2", Url = "http://blog2.com" });
+
+        context.SaveChanges();
+    }
+    #endregion
+
+    #region GetBlog
+    [Fact]
+    public async Task GetBlog()
+    {
+        using var context = CreateContext();
+        var controller = new BloggingController(context);
+
+        var blog = (await controller.GetBlog("Blog2")).Value;
+
+        Assert.Equal("http://blog2.com", blog.Url);
+    }
+    #endregion
+
+    [Fact]
+    public async Task GetAllBlogs()
+    {
+        using var context = CreateContext();
+        var controller = new BloggingController(context);
+
+        var blogs = await controller.GetAllBlogs().ToListAsync();
+
+        Assert.Collection(
+            blogs,
+            b => Assert.Equal("Blog1", b.Name),
+            b => Assert.Equal("Blog2", b.Name));
+    }
+
+    [Fact]
+    public async Task AddBlog()
+    {
+        using var context = CreateContext();
+        var controller = new BloggingController(context);
+
+        await controller.AddBlog("Blog3", "http://blog3.com");
+
+        var blog = await context.Blogs.SingleAsync(b => b.Name == "Blog3");
+        Assert.Equal("http://blog3.com", blog.Url);
+    }
+
+    [Fact]
+    public async Task UpdateBlogUrl()
+    {
+        using var context = CreateContext();
+        var controller = new BloggingController(context);
+
+        await controller.UpdateBlogUrl("Blog2", "http://blog2_updated.com");
+
+        var blog = await context.Blogs.SingleAsync(b => b.Name == "Blog2");
+        Assert.Equal("http://blog2_updated.com", blog.Url);
+    }
+
+    BloggingContext CreateContext() => new BloggingContext(_contextOptions, (context, modelBuilder) =>
+    {
+        #region ToInMemoryQuery
+        modelBuilder.Entity<UrlResource>()
+            .ToInMemoryQuery(() => context.Blogs.Select(b => new UrlResource { Url = b.Url }));
+        #endregion
+    });
+}
diff --git a/samples/core/Testing/TestingWithoutTheDatabase/RepositoryBloggingControllerTest.cs b/samples/core/Testing/TestingWithoutTheDatabase/RepositoryBloggingControllerTest.cs
new file mode 100644
index 0000000000..5913a88539
--- /dev/null
+++ b/samples/core/Testing/TestingWithoutTheDatabase/RepositoryBloggingControllerTest.cs
@@ -0,0 +1,93 @@
+using System.Linq;
+using System.Threading.Tasks;
+using EF.Testing.BloggingWebApi.Controllers;
+using EF.Testing.BusinessLogic;
+using Moq;
+using Xunit;
+
+namespace EF.Testing.UnitTests;
+
+public class RepositoryBloggingControllerTest
+{
+    #region GetBlog
+    [Fact]
+    public async Task GetBlog()
+    {
+        // Arrange
+        var repositoryMock = new Mock<IBloggingRepository>();
+        repositoryMock
+            .Setup(r => r.GetBlogByNameAsync("Blog2"))
+            .Returns(Task.FromResult(new Blog { Name = "Blog2", Url = "http://blog2.com" }));
+
+        var controller = new BloggingControllerWithRepository(repositoryMock.Object);
+
+        // Act
+        var blog = await controller.GetBlog("Blog2");
+
+        // Assert
+        repositoryMock.Verify(r => r.GetBlogByNameAsync("Blog2"));
+        Assert.Equal("http://blog2.com", blog.Url);
+    }
+    #endregion
+
+    [Fact]
+    public async Task GetAllBlogs()
+    {
+        // Arrange
+        var repositoryMock = new Mock<IBloggingRepository>();
+        repositoryMock
+            .Setup(r => r.GetAllBlogsAsync())
+            .Returns(new[]
+            {
+                new Blog { Name = "Blog1", Url = "http://blog1.com" },
+                new Blog { Name = "Blog2", Url = "http://blog2.com" }
+            }.ToAsyncEnumerable());
+
+        var controller = new BloggingControllerWithRepository(repositoryMock.Object);
+
+        // Act
+        var blogs = await controller.GetAllBlogs().ToListAsync();
+
+        // Assert
+        repositoryMock.Verify(r => r.GetAllBlogsAsync());
+        Assert.Equal("http://blog1.com", blogs[0].Url);
+        Assert.Equal("http://blog2.com", blogs[1].Url);
+    }
+
+    [Fact]
+    public async Task AddBlog()
+    {
+        // Arrange
+        var repositoryMock = new Mock<IBloggingRepository>();
+        var controller = new BloggingControllerWithRepository(repositoryMock.Object);
+
+        // Act
+        await controller.AddBlog("Blog2", "http://blog2.com");
+
+        // Assert
+        repositoryMock.Verify(r => r.AddBlog(It.IsAny<Blog>()));
+        repositoryMock.Verify(r => r.SaveChangesAsync());
+    }
+
+    [Fact]
+    public async Task UpdateBlogUrl()
+    {
+        var blog = new Blog { Name = "Blog2", Url = "http://blog2.com" };
+
+        // Arrange
+        var repositoryMock = new Mock<IBloggingRepository>();
+        repositoryMock
+            .Setup(r => r.GetBlogByNameAsync("Blog2"))
+            .Returns(Task.FromResult(blog));
+
+        var controller = new BloggingControllerWithRepository(repositoryMock.Object);
+
+        // Act
+        await controller.UpdateBlogUrl("Blog2", "http://blog2_updated.com");
+
+        // Assert
+        repositoryMock.Verify(r => r.GetBlogByNameAsync("Blog2"));
+        repositoryMock.Verify(r => r.SaveChangesAsync());
+        Assert.Equal("http://blog2_updated.com", blog.Url);
+    }
+}
diff --git a/samples/core/Testing/TestingWithoutTheDatabase/SqliteInMemoryBloggingControllerTest.cs b/samples/core/Testing/TestingWithoutTheDatabase/SqliteInMemoryBloggingControllerTest.cs
new file mode 100644
index 0000000000..09806d0017
--- /dev/null
+++ b/samples/core/Testing/TestingWithoutTheDatabase/SqliteInMemoryBloggingControllerTest.cs
@@ -0,0 +1,105 @@
+using System;
+using System.Data.Common;
+using System.Linq;
+using System.Threading.Tasks;
+using EF.Testing.BloggingWebApi.Controllers;
+using EF.Testing.BusinessLogic;
+using Microsoft.Data.Sqlite;
+using Microsoft.EntityFrameworkCore;
+using Xunit;
+
+namespace EF.Testing.UnitTests;
+
+public class SqliteInMemoryBloggingControllerTest : IDisposable
+{
+    private readonly DbConnection _connection;
+    private readonly DbContextOptions<BloggingContext> _contextOptions;
+
+    #region ConstructorAndDispose
+    public SqliteInMemoryBloggingControllerTest()
+    {
+        // Create and open a connection. This creates the SQLite in-memory database, which will persist until the connection is closed
+        // at the end of the test (see Dispose below).
+        _connection = new SqliteConnection("Filename=:memory:");
+        _connection.Open();
+
+        // These options will be used by the context instances in this test suite, including the connection opened above.
+        _contextOptions = new DbContextOptionsBuilder<BloggingContext>()
+            .UseSqlite(_connection)
+            .Options;
+
+        // Create the schema and seed some data
+        using var context = new BloggingContext(_contextOptions);
+
+        if (context.Database.EnsureCreated())
+        {
+            using var viewCommand = context.Database.GetDbConnection().CreateCommand();
+            viewCommand.CommandText = @"
+CREATE VIEW AllResources AS
+SELECT Url
+FROM Blogs;";
+            viewCommand.ExecuteNonQuery();
+        }
+
+        context.AddRange(
+            new Blog { Name = "Blog1", Url = "http://blog1.com" },
+            new Blog { Name = "Blog2", Url = "http://blog2.com" });
+        context.SaveChanges();
+    }
+
+    BloggingContext CreateContext() => new BloggingContext(_contextOptions);
+
+    public void Dispose() => _connection.Dispose();
+    #endregion
+
+    #region GetBlog
+    [Fact]
+    public async Task GetBlog()
+    {
+        using var context = CreateContext();
+        var controller = new BloggingController(context);
+
+        var blog = (await controller.GetBlog("Blog2")).Value;
+
+        Assert.Equal("http://blog2.com", blog.Url);
+    }
+    #endregion
+
+    [Fact]
+    public async Task GetAllBlogs()
+    {
+        using var context = CreateContext();
+        var controller = new BloggingController(context);
+
+        var blogs = await controller.GetAllBlogs().ToListAsync();
+
+        Assert.Collection(
+            blogs,
+            b => Assert.Equal("Blog1", b.Name),
+            b => Assert.Equal("Blog2", b.Name));
+    }
+
+    [Fact]
+    public async Task AddBlog()
+    {
+        using var context = CreateContext();
+        var controller = new BloggingController(context);
+
+        await controller.AddBlog("Blog3", "http://blog3.com");
+
+        var blog = await context.Blogs.SingleAsync(b => b.Name == "Blog3");
+        Assert.Equal("http://blog3.com", blog.Url);
+    }
+
+    [Fact]
+    public async Task UpdateBlogUrl()
+    {
+        using var context = CreateContext();
+        var controller = new BloggingController(context);
+
+        await controller.UpdateBlogUrl("Blog2", "http://blog2_updated.com");
+
+        var blog = await context.Blogs.SingleAsync(b => b.Name == "Blog2");
+        Assert.Equal("http://blog2_updated.com", blog.Url);
+    }
+}
diff --git a/samples/core/Testing/TestingWithoutTheDatabase/TestingWithoutTheDatabase.csproj b/samples/core/Testing/TestingWithoutTheDatabase/TestingWithoutTheDatabase.csproj
new file mode 100644
index 0000000000..4cc90dc111
--- /dev/null
+++ b/samples/core/Testing/TestingWithoutTheDatabase/TestingWithoutTheDatabase.csproj
@@ -0,0 +1,27 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <RootNamespace>EF.Testing.UnitTests</RootNamespace>
+    <AssemblyName>EF.Testing.UnitTests</AssemblyName>
+    <IsPackable>false</IsPackable>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.InMemory" Version="10.0.0" />
+
+    <PackageReference Include="Moq" Version="4.18.2" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="18.0.1" />
+    <PackageReference Include="xunit" Version="2.4.2" />
+    <PackageReference Include="xunit.runner.visualstudio" Version="2.4.5">
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+      <PrivateAssets>all</PrivateAssets>
+    </PackageReference>
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\BloggingWebApi\BloggingWebApi.csproj" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/WPF/GetStartedWPF/GetStartedWPF.sln b/samples/core/WPF/GetStartedWPF/GetStartedWPF.sln
new file mode 100644
index 0000000000..1e61a5aa9b
--- /dev/null
+++ b/samples/core/WPF/GetStartedWPF/GetStartedWPF.sln
@@ -0,0 +1,25 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 16
+VisualStudioVersion = 16.0.30320.27
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "GetStartedWPF", "GetStartedWPF\GetStartedWPF.csproj", "{59047498-CA21-4139-91D2-B2D87D856A85}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{59047498-CA21-4139-91D2-B2D87D856A85}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{59047498-CA21-4139-91D2-B2D87D856A85}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{59047498-CA21-4139-91D2-B2D87D856A85}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{59047498-CA21-4139-91D2-B2D87D856A85}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {8020022A-928D-4937-803A-6BBAC0432D88}
+	EndGlobalSection
+EndGlobal
diff --git a/samples/core/WPF/GetStartedWPF/GetStartedWPF/App.xaml b/samples/core/WPF/GetStartedWPF/GetStartedWPF/App.xaml
new file mode 100644
index 0000000000..724ac24a89
--- /dev/null
+++ b/samples/core/WPF/GetStartedWPF/GetStartedWPF/App.xaml
@@ -0,0 +1,9 @@
+<Application x:Class="GetStartedWPF.App"
+             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+             xmlns:local="clr-namespace:GetStartedWPF"
+             StartupUri="MainWindow.xaml">
+    <Application.Resources>
+         
+    </Application.Resources>
+</Application>
diff --git a/samples/core/WPF/GetStartedWPF/GetStartedWPF/App.xaml.cs b/samples/core/WPF/GetStartedWPF/GetStartedWPF/App.xaml.cs
new file mode 100644
index 0000000000..73d1430b2c
--- /dev/null
+++ b/samples/core/WPF/GetStartedWPF/GetStartedWPF/App.xaml.cs
@@ -0,0 +1,17 @@
+using System;
+using System.Collections.Generic;
+using System.Configuration;
+using System.Data;
+using System.Linq;
+using System.Threading.Tasks;
+using System.Windows;
+
+namespace GetStartedWPF
+{
+    /// <summary>
+    /// Interaction logic for App.xaml
+    /// </summary>
+    public partial class App : Application
+    {
+    }
+}
diff --git a/samples/core/WPF/GetStartedWPF/GetStartedWPF/AssemblyInfo.cs b/samples/core/WPF/GetStartedWPF/GetStartedWPF/AssemblyInfo.cs
new file mode 100644
index 0000000000..8b5504ecfb
--- /dev/null
+++ b/samples/core/WPF/GetStartedWPF/GetStartedWPF/AssemblyInfo.cs
@@ -0,0 +1,10 @@
+using System.Windows;
+
+[assembly: ThemeInfo(
+    ResourceDictionaryLocation.None, //where theme specific resource dictionaries are located
+                                     //(used if a resource is not found in the page,
+                                     // or application resource dictionaries)
+    ResourceDictionaryLocation.SourceAssembly //where the generic resource dictionary is located
+                                              //(used if a resource is not found in the page,
+                                              // app, or any theme specific resource dictionaries)
+)]
diff --git a/samples/core/WPF/GetStartedWPF/GetStartedWPF/Category.cs b/samples/core/WPF/GetStartedWPF/GetStartedWPF/Category.cs
new file mode 100644
index 0000000000..c489fa99ec
--- /dev/null
+++ b/samples/core/WPF/GetStartedWPF/GetStartedWPF/Category.cs
@@ -0,0 +1,16 @@
+using System.Collections.Generic;
+using System.Collections.ObjectModel;
+
+namespace GetStartedWPF
+{
+    public class Category
+    {
+        public int CategoryId { get; set; }
+        public string Name { get; set; }
+
+        public virtual ICollection<Product>
+            Products
+        { get; private set; } =
+            new ObservableCollection<Product>();
+    }
+}
diff --git a/samples/core/WPF/GetStartedWPF/GetStartedWPF/GetStartedWPF.csproj b/samples/core/WPF/GetStartedWPF/GetStartedWPF/GetStartedWPF.csproj
new file mode 100644
index 0000000000..4af65e6e06
--- /dev/null
+++ b/samples/core/WPF/GetStartedWPF/GetStartedWPF/GetStartedWPF.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk.WindowsDesktop">
+
+  <PropertyGroup>
+    <OutputType>WinExe</OutputType>
+    <TargetFramework>netcoreapp3.1</TargetFramework>
+    <UseWPF>true</UseWPF>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Proxies" Version="3.1.20" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="3.1.20" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/core/WPF/GetStartedWPF/GetStartedWPF/MainWindow.xaml b/samples/core/WPF/GetStartedWPF/GetStartedWPF/MainWindow.xaml
new file mode 100644
index 0000000000..e7fffb9bda
--- /dev/null
+++ b/samples/core/WPF/GetStartedWPF/GetStartedWPF/MainWindow.xaml
@@ -0,0 +1,44 @@
+<Window x:Class="GetStartedWPF.MainWindow"
+        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
+        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
+        xmlns:local="clr-namespace:GetStartedWPF"
+        mc:Ignorable="d"
+        Title="MainWindow" Height="450" Width="800" Loaded="Window_Loaded">
+    <Window.Resources>
+        <CollectionViewSource x:Key="categoryViewSource"/>
+        <CollectionViewSource x:Key="categoryProductsViewSource" 
+                              Source="{Binding Products, Source={StaticResource categoryViewSource}}"/>
+    </Window.Resources>
+    <Grid>
+        <DataGrid x:Name="categoryDataGrid" AutoGenerateColumns="False" 
+                  EnableRowVirtualization="True" 
+                  ItemsSource="{Binding Source={StaticResource categoryViewSource}}" 
+                  Margin="13,13,43,229" RowDetailsVisibilityMode="VisibleWhenSelected">
+            <DataGrid.Columns>
+                <DataGridTextColumn Binding="{Binding CategoryId}"
+                                    Header="Category Id" Width="SizeToHeader"
+                                    IsReadOnly="True"/>
+                <DataGridTextColumn Binding="{Binding Name}" Header="Name" 
+                                    Width="*"/>
+            </DataGrid.Columns>
+        </DataGrid>
+        <DataGrid x:Name="productsDataGrid" AutoGenerateColumns="False" 
+                  EnableRowVirtualization="True" 
+                  ItemsSource="{Binding Source={StaticResource categoryProductsViewSource}}" 
+                  Margin="13,205,43,108" RowDetailsVisibilityMode="VisibleWhenSelected" 
+                  RenderTransformOrigin="0.488,0.251">
+            <DataGrid.Columns>
+                <DataGridTextColumn Binding="{Binding CategoryId}" 
+                                    Header="Category Id" Width="SizeToHeader"
+                                    IsReadOnly="True"/>
+                <DataGridTextColumn Binding="{Binding ProductId}" Header="Product Id" 
+                                    Width="SizeToHeader" IsReadOnly="True"/>
+                <DataGridTextColumn Binding="{Binding Name}" Header="Name" Width="*"/>
+            </DataGrid.Columns>
+        </DataGrid>
+        <Button Content="Save" HorizontalAlignment="Center" Margin="0,240,0,0" 
+                Click="Button_Click" Height="20" Width="123"/>
+    </Grid>
+</Window>
diff --git a/samples/core/WPF/GetStartedWPF/GetStartedWPF/MainWindow.xaml.cs b/samples/core/WPF/GetStartedWPF/GetStartedWPF/MainWindow.xaml.cs
new file mode 100644
index 0000000000..7dba1c1fc4
--- /dev/null
+++ b/samples/core/WPF/GetStartedWPF/GetStartedWPF/MainWindow.xaml.cs
@@ -0,0 +1,57 @@
+using Microsoft.EntityFrameworkCore;
+using System.ComponentModel;
+using System.Windows;
+using System.Windows.Data;
+
+namespace GetStartedWPF
+{
+    /// <summary>
+    /// Interaction logic for MainWindow.xaml
+    /// </summary>
+    public partial class MainWindow : Window
+    {
+        private readonly ProductContext _context =
+            new ProductContext();
+
+        private CollectionViewSource categoryViewSource;
+
+        public MainWindow()
+        {
+            InitializeComponent();
+            categoryViewSource =
+                (CollectionViewSource)FindResource(nameof(categoryViewSource));
+        }
+
+        private void Window_Loaded(object sender, RoutedEventArgs e)
+        {
+            // this is for demo purposes only, to make it easier
+            // to get up and running
+            _context.Database.EnsureCreated();
+
+            // load the entities into EF Core
+            _context.Categories.Load();
+
+            // bind to the source
+            categoryViewSource.Source =
+                _context.Categories.Local.ToObservableCollection();
+        }
+
+        private void Button_Click(object sender, RoutedEventArgs e)
+        {
+            // all changes are automatically tracked, including
+            // deletes!
+            _context.SaveChanges();
+
+            // this forces the grid to refresh to latest values
+            categoryDataGrid.Items.Refresh();
+            productsDataGrid.Items.Refresh();
+        }
+
+        protected override void OnClosing(CancelEventArgs e)
+        {
+            // clean up database connections
+            _context.Dispose();
+            base.OnClosing(e);
+        }
+    }
+}
diff --git a/samples/core/WPF/GetStartedWPF/GetStartedWPF/Product.cs b/samples/core/WPF/GetStartedWPF/GetStartedWPF/Product.cs
new file mode 100644
index 0000000000..b1952192ed
--- /dev/null
+++ b/samples/core/WPF/GetStartedWPF/GetStartedWPF/Product.cs
@@ -0,0 +1,11 @@
+namespace GetStartedWPF
+{
+    public class Product
+    {
+        public int ProductId { get; set; }
+        public string Name { get; set; }
+
+        public int CategoryId { get; set; }
+        public virtual Category Category { get; set; }
+    }
+}
diff --git a/samples/core/WPF/GetStartedWPF/GetStartedWPF/ProductContext.cs b/samples/core/WPF/GetStartedWPF/GetStartedWPF/ProductContext.cs
new file mode 100644
index 0000000000..fd0baa3249
--- /dev/null
+++ b/samples/core/WPF/GetStartedWPF/GetStartedWPF/ProductContext.cs
@@ -0,0 +1,18 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace GetStartedWPF
+{
+    public class ProductContext : DbContext
+    {
+        public DbSet<Product> Products { get; set; }
+        public DbSet<Category> Categories { get; set; }
+
+        protected override void OnConfiguring(
+            DbContextOptionsBuilder optionsBuilder)
+        {
+            optionsBuilder.UseSqlite(
+                "Data Source=products.db");
+            optionsBuilder.UseLazyLoadingProxies();
+        }
+    }
+}
diff --git a/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms.sln b/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms.sln
new file mode 100644
index 0000000000..eb04c6784f
--- /dev/null
+++ b/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms.sln
@@ -0,0 +1,25 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.3.32728.150
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "GetStartedWinForms", "GetStartedWinForms\GetStartedWinForms.csproj", "{4F4ED10B-6E60-4A22-88D2-553089460ADB}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{4F4ED10B-6E60-4A22-88D2-553089460ADB}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{4F4ED10B-6E60-4A22-88D2-553089460ADB}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{4F4ED10B-6E60-4A22-88D2-553089460ADB}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{4F4ED10B-6E60-4A22-88D2-553089460ADB}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {871AF531-D09B-42A7-8D8A-4293B23EF80B}
+	EndGlobalSection
+EndGlobal
diff --git a/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/Category.cs b/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/Category.cs
new file mode 100644
index 0000000000..13d5b781dd
--- /dev/null
+++ b/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/Category.cs
@@ -0,0 +1,12 @@
+using Microsoft.EntityFrameworkCore.ChangeTracking;
+
+namespace GetStartedWinForms;
+
+public class Category
+{
+    public int CategoryId { get; set; }
+
+    public string? Name { get; set; }
+
+    public virtual ObservableCollectionListSource<Product> Products { get; } = new();
+}
diff --git a/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/Form1.Designer.cs b/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/Form1.Designer.cs
new file mode 100644
index 0000000000..a316d10264
--- /dev/null
+++ b/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/Form1.Designer.cs
@@ -0,0 +1,151 @@
+namespace GetStartedWinForms
+{
+    partial class MainForm
+    {
+        /// <summary>
+        ///  Required designer variable.
+        /// </summary>
+        private System.ComponentModel.IContainer components = null;
+
+        /// <summary>
+        ///  Clean up any resources being used.
+        /// </summary>
+        /// <param name="disposing">true if managed resources should be disposed; otherwise, false.</param>
+        protected override void Dispose(bool disposing)
+        {
+            if (disposing && (components != null))
+            {
+                components.Dispose();
+            }
+            base.Dispose(disposing);
+        }
+
+        #region Windows Form Designer generated code
+
+        /// <summary>
+        ///  Required method for Designer support - do not modify
+        ///  the contents of this method with the code editor.
+        /// </summary>
+        private void InitializeComponent()
+        {
+            this.components = new System.ComponentModel.Container();
+            this.dataGridViewCategories = new System.Windows.Forms.DataGridView();
+            this.categoryIdDataGridViewTextBoxColumn = new System.Windows.Forms.DataGridViewTextBoxColumn();
+            this.nameDataGridViewTextBoxColumn = new System.Windows.Forms.DataGridViewTextBoxColumn();
+            this.categoryBindingSource = new System.Windows.Forms.BindingSource(this.components);
+            this.dataGridViewProducts = new System.Windows.Forms.DataGridView();
+            this.productIdDataGridViewTextBoxColumn = new System.Windows.Forms.DataGridViewTextBoxColumn();
+            this.nameDataGridViewTextBoxColumn1 = new System.Windows.Forms.DataGridViewTextBoxColumn();
+            this.productsBindingSource = new System.Windows.Forms.BindingSource(this.components);
+            this.buttonSave = new System.Windows.Forms.Button();
+            ((System.ComponentModel.ISupportInitialize)(this.dataGridViewCategories)).BeginInit();
+            ((System.ComponentModel.ISupportInitialize)(this.categoryBindingSource)).BeginInit();
+            ((System.ComponentModel.ISupportInitialize)(this.dataGridViewProducts)).BeginInit();
+            ((System.ComponentModel.ISupportInitialize)(this.productsBindingSource)).BeginInit();
+            this.SuspendLayout();
+            // 
+            // dataGridViewCategories
+            // 
+            this.dataGridViewCategories.AutoGenerateColumns = false;
+            this.dataGridViewCategories.ColumnHeadersHeightSizeMode = System.Windows.Forms.DataGridViewColumnHeadersHeightSizeMode.AutoSize;
+            this.dataGridViewCategories.Columns.AddRange(new System.Windows.Forms.DataGridViewColumn[] {
+            this.categoryIdDataGridViewTextBoxColumn,
+            this.nameDataGridViewTextBoxColumn});
+            this.dataGridViewCategories.DataSource = this.categoryBindingSource;
+            this.dataGridViewCategories.Location = new System.Drawing.Point(12, 12);
+            this.dataGridViewCategories.Name = "dataGridViewCategories";
+            this.dataGridViewCategories.RowTemplate.Height = 25;
+            this.dataGridViewCategories.Size = new System.Drawing.Size(240, 200);
+            this.dataGridViewCategories.TabIndex = 0;
+            this.dataGridViewCategories.SelectionChanged += new System.EventHandler(this.dataGridViewCategories_SelectionChanged);
+            // 
+            // categoryIdDataGridViewTextBoxColumn
+            // 
+            this.categoryIdDataGridViewTextBoxColumn.DataPropertyName = "CategoryId";
+            this.categoryIdDataGridViewTextBoxColumn.HeaderText = "CategoryId";
+            this.categoryIdDataGridViewTextBoxColumn.Name = "categoryIdDataGridViewTextBoxColumn";
+            this.categoryIdDataGridViewTextBoxColumn.ReadOnly = true;
+            // 
+            // nameDataGridViewTextBoxColumn
+            // 
+            this.nameDataGridViewTextBoxColumn.DataPropertyName = "Name";
+            this.nameDataGridViewTextBoxColumn.HeaderText = "Name";
+            this.nameDataGridViewTextBoxColumn.Name = "nameDataGridViewTextBoxColumn";
+            // 
+            // categoryBindingSource
+            // 
+            this.categoryBindingSource.DataSource = typeof(GetStartedWinForms.Category);
+            // 
+            // dataGridViewProducts
+            // 
+            this.dataGridViewProducts.AutoGenerateColumns = false;
+            this.dataGridViewProducts.ColumnHeadersHeightSizeMode = System.Windows.Forms.DataGridViewColumnHeadersHeightSizeMode.AutoSize;
+            this.dataGridViewProducts.Columns.AddRange(new System.Windows.Forms.DataGridViewColumn[] {
+            this.productIdDataGridViewTextBoxColumn,
+            this.nameDataGridViewTextBoxColumn1});
+            this.dataGridViewProducts.DataSource = this.productsBindingSource;
+            this.dataGridViewProducts.Location = new System.Drawing.Point(258, 12);
+            this.dataGridViewProducts.Name = "dataGridViewProducts";
+            this.dataGridViewProducts.RowTemplate.Height = 25;
+            this.dataGridViewProducts.Size = new System.Drawing.Size(240, 200);
+            this.dataGridViewProducts.TabIndex = 1;
+            // 
+            // productIdDataGridViewTextBoxColumn
+            // 
+            this.productIdDataGridViewTextBoxColumn.DataPropertyName = "ProductId";
+            this.productIdDataGridViewTextBoxColumn.HeaderText = "ProductId";
+            this.productIdDataGridViewTextBoxColumn.Name = "productIdDataGridViewTextBoxColumn";
+            this.productIdDataGridViewTextBoxColumn.ReadOnly = true;
+            // 
+            // nameDataGridViewTextBoxColumn1
+            // 
+            this.nameDataGridViewTextBoxColumn1.DataPropertyName = "Name";
+            this.nameDataGridViewTextBoxColumn1.HeaderText = "Name";
+            this.nameDataGridViewTextBoxColumn1.Name = "nameDataGridViewTextBoxColumn1";
+            // 
+            // productsBindingSource
+            // 
+            this.productsBindingSource.DataMember = "Products";
+            this.productsBindingSource.DataSource = this.categoryBindingSource;
+            // 
+            // buttonSave
+            // 
+            this.buttonSave.Location = new System.Drawing.Point(423, 218);
+            this.buttonSave.Name = "buttonSave";
+            this.buttonSave.Size = new System.Drawing.Size(75, 23);
+            this.buttonSave.TabIndex = 2;
+            this.buttonSave.Text = "Save";
+            this.buttonSave.UseVisualStyleBackColor = true;
+            this.buttonSave.Click += new System.EventHandler(this.buttonSave_Click);
+            // 
+            // MainForm
+            // 
+            this.AutoScaleDimensions = new System.Drawing.SizeF(7F, 15F);
+            this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font;
+            this.ClientSize = new System.Drawing.Size(512, 248);
+            this.Controls.Add(this.buttonSave);
+            this.Controls.Add(this.dataGridViewProducts);
+            this.Controls.Add(this.dataGridViewCategories);
+            this.Name = "MainForm";
+            this.Text = "Products and Categories";
+            ((System.ComponentModel.ISupportInitialize)(this.dataGridViewCategories)).EndInit();
+            ((System.ComponentModel.ISupportInitialize)(this.categoryBindingSource)).EndInit();
+            ((System.ComponentModel.ISupportInitialize)(this.dataGridViewProducts)).EndInit();
+            ((System.ComponentModel.ISupportInitialize)(this.productsBindingSource)).EndInit();
+            this.ResumeLayout(false);
+
+        }
+
+        #endregion
+
+        private DataGridView dataGridViewCategories;
+        private DataGridViewTextBoxColumn categoryIdDataGridViewTextBoxColumn;
+        private DataGridViewTextBoxColumn nameDataGridViewTextBoxColumn;
+        private BindingSource categoryBindingSource;
+        private DataGridView dataGridViewProducts;
+        private DataGridViewTextBoxColumn productIdDataGridViewTextBoxColumn;
+        private DataGridViewTextBoxColumn nameDataGridViewTextBoxColumn1;
+        private BindingSource productsBindingSource;
+        private Button buttonSave;
+    }
+}
\ No newline at end of file
diff --git a/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/Form1.cs b/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/Form1.cs
new file mode 100644
index 0000000000..84cc348a10
--- /dev/null
+++ b/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/Form1.cs
@@ -0,0 +1,59 @@
+using Microsoft.EntityFrameworkCore;
+using System.ComponentModel;
+
+namespace GetStartedWinForms
+{
+    public partial class MainForm : Form
+    {
+        private ProductsContext? dbContext;
+
+        public MainForm()
+        {
+            InitializeComponent();
+        }
+
+        protected override void OnLoad(EventArgs e)
+        {
+            base.OnLoad(e);
+
+            this.dbContext = new ProductsContext();
+
+            // Uncomment the line below to start fresh with a new database.
+            // this.dbContext.Database.EnsureDeleted();
+            this.dbContext.Database.EnsureCreated();
+
+            this.dbContext.Categories.Load();
+
+            this.categoryBindingSource.DataSource = dbContext.Categories.Local.ToBindingList();
+        }
+
+        protected override void OnClosing(CancelEventArgs e)
+        {
+            base.OnClosing(e);
+
+            this.dbContext?.Dispose();
+            this.dbContext = null;
+        }
+
+        private void dataGridViewCategories_SelectionChanged(object sender, EventArgs e)
+        {
+            if (this.dbContext != null)
+            {
+                var category = (Category)this.dataGridViewCategories.CurrentRow.DataBoundItem;
+
+                if (category != null)
+                {
+                    this.dbContext.Entry(category).Collection(e => e.Products).Load();
+                }
+            }
+        }
+
+        private void buttonSave_Click(object sender, EventArgs e)
+        {
+            this.dbContext!.SaveChanges();
+
+            this.dataGridViewCategories.Refresh();
+            this.dataGridViewProducts.Refresh();
+        }
+    }
+}
diff --git a/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/Form1.resx b/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/Form1.resx
new file mode 100644
index 0000000000..a9e3edcb02
--- /dev/null
+++ b/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/Form1.resx
@@ -0,0 +1,66 @@
+<root>
+  <xsd:schema id="root" xmlns="" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
+    <xsd:import namespace="http://www.w3.org/XML/1998/namespace" />
+    <xsd:element name="root" msdata:IsDataSet="true">
+      <xsd:complexType>
+        <xsd:choice maxOccurs="unbounded">
+          <xsd:element name="metadata">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" />
+              </xsd:sequence>
+              <xsd:attribute name="name" use="required" type="xsd:string" />
+              <xsd:attribute name="type" type="xsd:string" />
+              <xsd:attribute name="mimetype" type="xsd:string" />
+              <xsd:attribute ref="xml:space" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="assembly">
+            <xsd:complexType>
+              <xsd:attribute name="alias" type="xsd:string" />
+              <xsd:attribute name="name" type="xsd:string" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="data">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+                <xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2" />
+              </xsd:sequence>
+              <xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1" />
+              <xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3" />
+              <xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4" />
+              <xsd:attribute ref="xml:space" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="resheader">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+              </xsd:sequence>
+              <xsd:attribute name="name" type="xsd:string" use="required" />
+            </xsd:complexType>
+          </xsd:element>
+        </xsd:choice>
+      </xsd:complexType>
+    </xsd:element>
+  </xsd:schema>
+  <resheader name="resmimetype">
+    <value>text/microsoft-resx</value>
+  </resheader>
+  <resheader name="version">
+    <value>2.0</value>
+  </resheader>
+  <resheader name="reader">
+    <value>System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
+  </resheader>
+  <resheader name="writer">
+    <value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
+  </resheader>
+  <metadata name="categoryBindingSource.TrayLocation" type="System.Drawing.Point, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a">
+    <value>17, 17</value>
+  </metadata>
+  <metadata name="productsBindingSource.TrayLocation" type="System.Drawing.Point, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a">
+    <value>195, 17</value>
+  </metadata>
+</root>
\ No newline at end of file
diff --git a/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/GetStartedWinForms.csproj b/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/GetStartedWinForms.csproj
new file mode 100644
index 0000000000..bb0cdaf829
--- /dev/null
+++ b/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/GetStartedWinForms.csproj
@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>WinExe</OutputType>
+    <TargetFramework>net7.0-windows</TargetFramework>
+    <Nullable>enable</Nullable>
+    <UseWindowsForms>true</UseWindowsForms>
+    <ImplicitUsings>enable</ImplicitUsings>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="7.0.0-preview.6.22329.4" />
+  </ItemGroup>
+
+</Project>
\ No newline at end of file
diff --git a/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/Product.cs b/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/Product.cs
new file mode 100644
index 0000000000..580a5c35f3
--- /dev/null
+++ b/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/Product.cs
@@ -0,0 +1,13 @@
+using System.ComponentModel;
+
+namespace GetStartedWinForms;
+
+public class Product
+{
+    public int ProductId { get; set; }
+
+    public string? Name { get; set; }
+
+    public int CategoryId { get; set; }
+    public virtual Category Category { get; set; } = null!;
+}
diff --git a/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/ProductsContext.cs b/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/ProductsContext.cs
new file mode 100644
index 0000000000..a1ce0998c8
--- /dev/null
+++ b/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/ProductsContext.cs
@@ -0,0 +1,56 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace GetStartedWinForms;
+
+public class ProductsContext : DbContext
+{
+    public DbSet<Product> Products { get; set; }
+    public DbSet<Category> Categories { get; set; }
+
+    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
+        => optionsBuilder.UseSqlite("Data Source=products.db");
+
+    protected override void OnModelCreating(ModelBuilder modelBuilder)
+    {
+        modelBuilder.Entity<Category>().HasData(
+            new Category { CategoryId = 1, Name = "Cheese" },
+            new Category { CategoryId = 2, Name = "Meat" },
+            new Category { CategoryId = 3, Name = "Fish" },
+            new Category { CategoryId = 4, Name = "Bread" });
+
+        modelBuilder.Entity<Product>().HasData(
+            new Product { ProductId = 1, CategoryId = 1, Name = "Cheddar" },
+            new Product { ProductId = 2, CategoryId = 1, Name = "Brie" },
+            new Product { ProductId = 3, CategoryId = 1, Name = "Stilton" },
+            new Product { ProductId = 4, CategoryId = 1, Name = "Cheshire" },
+            new Product { ProductId = 5, CategoryId = 1, Name = "Swiss" },
+            new Product { ProductId = 6, CategoryId = 1, Name = "Gruyere" },
+            new Product { ProductId = 7, CategoryId = 1, Name = "Colby" },
+            new Product { ProductId = 8, CategoryId = 1, Name = "Mozzela" },
+            new Product { ProductId = 9, CategoryId = 1, Name = "Ricotta" },
+            new Product { ProductId = 10, CategoryId = 1, Name = "Parmesan" },
+            new Product { ProductId = 11, CategoryId = 2, Name = "Ham" },
+            new Product { ProductId = 12, CategoryId = 2, Name = "Beef" },
+            new Product { ProductId = 13, CategoryId = 2, Name = "Chicken" },
+            new Product { ProductId = 14, CategoryId = 2, Name = "Turkey" },
+            new Product { ProductId = 15, CategoryId = 2, Name = "Prosciutto" },
+            new Product { ProductId = 16, CategoryId = 2, Name = "Bacon" },
+            new Product { ProductId = 17, CategoryId = 2, Name = "Mutton" },
+            new Product { ProductId = 18, CategoryId = 2, Name = "Pastrami" },
+            new Product { ProductId = 19, CategoryId = 2, Name = "Hazlet" },
+            new Product { ProductId = 20, CategoryId = 2, Name = "Salami" },
+            new Product { ProductId = 21, CategoryId = 3, Name = "Salmon" },
+            new Product { ProductId = 22, CategoryId = 3, Name = "Tuna" },
+            new Product { ProductId = 23, CategoryId = 3, Name = "Mackerel" },
+            new Product { ProductId = 24, CategoryId = 4, Name = "Rye" },
+            new Product { ProductId = 25, CategoryId = 4, Name = "Wheat" },
+            new Product { ProductId = 26, CategoryId = 4, Name = "Brioche" },
+            new Product { ProductId = 27, CategoryId = 4, Name = "Naan" },
+            new Product { ProductId = 28, CategoryId = 4, Name = "Focaccia" },
+            new Product { ProductId = 29, CategoryId = 4, Name = "Malted" },
+            new Product { ProductId = 30, CategoryId = 4, Name = "Sourdough" },
+            new Product { ProductId = 31, CategoryId = 4, Name = "Corn" },
+            new Product { ProductId = 32, CategoryId = 4, Name = "White" },
+            new Product { ProductId = 33, CategoryId = 4, Name = "Soda" });
+    }
+}
diff --git a/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/Program.cs b/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/Program.cs
new file mode 100644
index 0000000000..85aabdf145
--- /dev/null
+++ b/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/Program.cs
@@ -0,0 +1,17 @@
+namespace GetStartedWinForms
+{
+    internal static class Program
+    {
+        /// <summary>
+        ///  The main entry point for the application.
+        /// </summary>
+        [STAThread]
+        static void Main()
+        {
+            // To customize application configuration such as set high DPI settings or default font,
+            // see https://aka.ms/applicationconfiguration.
+            ApplicationConfiguration.Initialize();
+            Application.Run(new MainForm());
+        }
+    }
+}
\ No newline at end of file
diff --git a/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/Properties/DataSources/Category.datasource b/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/Properties/DataSources/Category.datasource
new file mode 100644
index 0000000000..07cd122652
--- /dev/null
+++ b/samples/core/WinForms/GetStartedWinForms/GetStartedWinForms/Properties/DataSources/Category.datasource
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+    This file is automatically generated by Visual Studio. It is 
+    used to store generic object data source configuration information.  
+    Renaming the file extension or editing the content of this file may   
+    cause the file to be unrecognizable by the program.
+-->
+<GenericObjectDataSource DisplayName="Category" Version="1.0" xmlns="urn:schemas-microsoft-com:xml-msdatasource">
+  <TypeInfo>GetStartedWinForms.Category, GetStartedWinForms, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null</TypeInfo>
+</GenericObjectDataSource>
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/.editorconfig b/samples/end2end/PlanetaryDocs/.editorconfig
new file mode 100644
index 0000000000..f010d3cbce
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/.editorconfig
@@ -0,0 +1,156 @@
+# To learn more about .editorconfig see https://aka.ms/editorconfigdocs
+###############################
+# Core EditorConfig Options   #
+###############################
+root = true
+# All files
+[*]
+indent_style = space
+# Code files
+[*.{cs,csx,vb,vbx}]
+indent_size = 4
+trim_trailing_whitespace = true;
+insert_final_newline = true
+charset = utf-8-bom
+###############################
+# .NET Coding Conventions     #
+###############################
+[*.{cs,vb}]
+# Organize usings
+dotnet_sort_system_directives_first = true
+
+# this. preferences
+dotnet_style_qualification_for_field = false:silent
+dotnet_style_qualification_for_property = false:silent
+dotnet_style_qualification_for_method = false:silent
+dotnet_style_qualification_for_event = false:silent
+
+# Language keywords vs BCL types preferences
+dotnet_style_predefined_type_for_locals_parameters_members = true:silent
+dotnet_style_predefined_type_for_member_access = true:silent
+
+# Parentheses preferences
+dotnet_style_parentheses_in_arithmetic_binary_operators = always_for_clarity:silent
+dotnet_style_parentheses_in_relational_binary_operators = always_for_clarity:silent
+dotnet_style_parentheses_in_other_binary_operators = always_for_clarity:silent
+dotnet_style_parentheses_in_other_operators = never_if_unnecessary:silent
+
+# Modifier preferences
+dotnet_style_require_accessibility_modifiers = for_non_interface_members:silent
+dotnet_style_readonly_field = true:suggestion
+
+# Expression-level preferences
+dotnet_style_object_initializer = true:suggestion
+dotnet_style_collection_initializer = true:suggestion
+dotnet_style_explicit_tuple_names = true:suggestion
+dotnet_style_null_propagation = true:suggestion
+dotnet_style_coalesce_expression = true:suggestion
+dotnet_style_prefer_is_null_check_over_reference_equality_method = true:silent
+dotnet_style_prefer_inferred_tuple_names = true:suggestion
+dotnet_style_prefer_inferred_anonymous_type_member_names = true:suggestion
+dotnet_style_prefer_auto_properties = true:silent
+dotnet_style_prefer_conditional_expression_over_assignment = true:silent
+dotnet_style_prefer_conditional_expression_over_return = true:silent
+
+###############################
+# Naming Conventions          #
+###############################
+
+# Style Definitions
+dotnet_naming_style.pascal_case_style.capitalization             = pascal_case
+
+# Use PascalCase for constant fields  
+dotnet_naming_rule.constant_fields_should_be_pascal_case.severity = suggestion
+dotnet_naming_rule.constant_fields_should_be_pascal_case.symbols  = constant_fields
+dotnet_naming_rule.constant_fields_should_be_pascal_case.style    = pascal_case_style
+dotnet_naming_symbols.constant_fields.applicable_kinds            = field
+dotnet_naming_symbols.constant_fields.applicable_accessibilities  = *
+dotnet_naming_symbols.constant_fields.required_modifiers          = const
+
+###############################
+# C# Coding Conventions       #
+###############################
+[*.cs]
+
+# var preferences
+csharp_style_var_for_built_in_types = true:silent
+csharp_style_var_when_type_is_apparent = true:silent
+csharp_style_var_elsewhere = true:silent
+
+# Expression-bodied members
+csharp_style_expression_bodied_methods = true:suggestion
+csharp_style_expression_bodied_constructors = true:suggestion
+csharp_style_expression_bodied_operators = true:suggestion
+csharp_style_expression_bodied_properties = true:suggestion
+csharp_style_expression_bodied_indexers = true:suggestion
+csharp_style_expression_bodied_accessors = true:suggestion
+
+# Pattern matching preferences
+csharp_style_pattern_matching_over_is_with_cast_check = true:suggestion
+csharp_style_pattern_matching_over_as_with_null_check = true:suggestion
+
+# Null-checking preferences
+csharp_style_throw_expression = true:suggestion
+csharp_style_conditional_delegate_call = true:suggestion
+
+# Modifier preferences
+csharp_preferred_modifier_order = public,private,protected,internal,static,extern,new,virtual,abstract,sealed,override,readonly,unsafe,volatile,async:suggestion
+
+# Expression-level preferences
+csharp_prefer_braces = true:silent
+csharp_style_deconstructed_variable_declaration = true:suggestion
+csharp_prefer_simple_default_expression = true:suggestion
+csharp_style_pattern_local_over_anonymous_function = true:suggestion
+csharp_style_inlined_variable_declaration = true:suggestion
+
+###############################
+# C# Formatting Rules         #
+###############################
+
+# New line preferences
+csharp_new_line_before_open_brace = all
+csharp_new_line_before_else = true
+csharp_new_line_before_catch = true
+csharp_new_line_before_finally = true
+csharp_new_line_before_members_in_object_initializers = true
+csharp_new_line_before_members_in_anonymous_types = true
+csharp_new_line_between_query_expression_clauses = true
+
+# Indentation preferences
+csharp_indent_case_contents = true
+csharp_indent_switch_labels = true
+csharp_indent_labels = flush_left
+
+# Space preferences
+csharp_space_after_cast = false
+csharp_space_after_keywords_in_control_flow_statements = true
+csharp_space_between_method_call_parameter_list_parentheses = false
+csharp_space_between_method_declaration_parameter_list_parentheses = false
+csharp_space_between_parentheses = false
+csharp_space_before_colon_in_inheritance_clause = true
+csharp_space_after_colon_in_inheritance_clause = true
+csharp_space_around_binary_operators = before_and_after
+csharp_space_between_method_declaration_empty_parameter_list_parentheses = false
+csharp_space_between_method_call_name_and_opening_parenthesis = false
+csharp_space_between_method_call_empty_parameter_list_parentheses = false
+
+# Wrapping preferences
+csharp_preserve_single_line_statements = true
+csharp_preserve_single_line_blocks = true
+
+###############################
+# VB Coding Conventions       #
+###############################
+
+# SA1200: Using directives should be placed correctly
+dotnet_diagnostic.SA1200.severity = none
+
+# SA1101: Prefix local calls with this
+dotnet_diagnostic.SA1101.severity = silent
+
+# SA1633: File should have header
+dotnet_diagnostic.SA1633.severity = none
+
+[*.vb]
+# Modifier preferences
+visual_basic_preferred_modifier_order = Partial,Default,Private,Protected,Public,Friend,NotOverridable,Overridable,MustOverride,Overloads,Overrides,MustInherit,NotInheritable,Static,Shared,Shadows,ReadOnly,WriteOnly,Dim,Const,WithEvents,Widening,Narrowing,Custom,Async:suggestion
diff --git a/samples/end2end/PlanetaryDocs/Directory.Build.props b/samples/end2end/PlanetaryDocs/Directory.Build.props
new file mode 100644
index 0000000000..09bb94e99e
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/Directory.Build.props
@@ -0,0 +1,38 @@
+<Project>
+  
+  <PropertyGroup>
+    <LangVersion>10.0</LangVersion>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+  </PropertyGroup>
+  
+  <PropertyGroup>
+    <DefaultNetCoreTargetFramework>net6.0</DefaultNetCoreTargetFramework>
+  </PropertyGroup>
+
+  <PropertyGroup Condition="'$(Configuration)'=='Release'">
+    <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
+  </PropertyGroup>
+
+  <PropertyGroup>
+    <RepositoryUrl>https://github.com/dotnet/EntityFramework.Docs</RepositoryUrl>
+    <RepositoryType>git</RepositoryType>
+    <Product>Planetary Docs</Product>
+    <IsPackable>false</IsPackable>
+  </PropertyGroup>
+  
+  <ItemGroup>
+    <PackageReference Include="StyleCop.Analyzers" Version="1.1.118">
+      <PrivateAssets>all</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+    </PackageReference>
+  </ItemGroup>
+
+  <ItemGroup>
+    <AdditionalFiles Include="..\stylecop.json" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <None Include="..\.editorconfig" Link=".editorconfig" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/DocsContext.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/DocsContext.cs
new file mode 100644
index 0000000000..8fcea6c3eb
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/DocsContext.cs
@@ -0,0 +1,221 @@
+using System.Linq;
+using System.Net;
+using System.Threading.Tasks;
+using Microsoft.Azure.Cosmos;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.ChangeTracking;
+using Newtonsoft.Json;
+using PlanetaryDocs.Domain;
+
+namespace PlanetaryDocs.DataAccess
+{
+    /// <summary>
+    /// <see cref="DbContext"/> implementation for Planetary Docs.
+    /// </summary>
+    public sealed class DocsContext : DbContext
+    {
+        /// <summary>
+        /// Name of the partition key shadow property.
+        /// </summary>
+        public const string PartitionKey = nameof(PartitionKey);
+
+        /// <summary>
+        /// Name of the container for metadata.
+        /// </summary>
+        private const string Meta = nameof(Meta);
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="DocsContext"/> class.
+        /// </summary>
+        /// <param name="options">The configuration options.</param>
+        public DocsContext(DbContextOptions<DocsContext> options)
+            : base(options) =>
+                SavingChanges += DocsContext_SavingChanges;
+
+        /// <summary>
+        /// Gets or sets the audits collection.
+        /// </summary>
+        public DbSet<DocumentAudit> Audits { get; set; }
+
+        /// <summary>
+        /// Gets or sets the documents collection.
+        /// </summary>
+        public DbSet<Document> Documents { get; set; }
+
+        /// <summary>
+        /// Gets or sets the tags collection.
+        /// </summary>
+        public DbSet<Tag> Tags { get; set; }
+
+        /// <summary>
+        /// Gets or sets the authors collection.
+        /// </summary>
+        public DbSet<Author> Authors { get; set; }
+
+        /// <summary>
+        /// Determines the custom partition key for meta (author, tag).
+        /// </summary>
+        /// <typeparam name="T">The type.</typeparam>
+        /// <returns>The partition key (type).</returns>
+        public static string ComputePartitionKey<T>()
+            where T : class, IDocSummaries => typeof(T).Name;
+
+        /// <summary>
+        /// Unhook events on disposal.
+        /// </summary>
+        public override void Dispose()
+        {
+            SavingChanges -= DocsContext_SavingChanges;
+            base.Dispose();
+        }
+
+        /// <summary>
+        /// Asynchronous disposal.
+        /// </summary>
+        /// <returns>The asynchronous task.</returns>
+        public override ValueTask DisposeAsync()
+        {
+            SavingChanges -= DocsContext_SavingChanges;
+            return base.DisposeAsync();
+        }
+
+        /// <summary>
+        /// Generic strategy to load a <see cref="Author"/> or
+        /// <see cref="Tag"/>.
+        /// </summary>
+        /// <typeparam name="T">The type to load.</typeparam>
+        /// <param name="key">The key.</param>
+        /// <returns>The matching item.</returns>
+        public async ValueTask<T> FindMetaAsync<T>(string key)
+            where T : class, IDocSummaries
+        {
+            var partitionKey = ComputePartitionKey<T>();
+            try
+            {
+                return await FindAsync<T>(key, partitionKey);
+            }
+            catch (CosmosException ce)
+            {
+                if (ce.StatusCode == HttpStatusCode.NotFound)
+                {
+                    return null;
+                }
+
+                throw;
+            }
+        }
+
+        /// <summary>
+        /// Set the partition key shadow property.
+        /// </summary>
+        /// <typeparam name="T">The type.</typeparam>
+        /// <param name="entity">The entity.</param>
+        public void SetPartitionKey<T>(T entity)
+            where T : class, IDocSummaries =>
+                Entry(entity).Property(PartitionKey).CurrentValue =
+                    ComputePartitionKey<T>();
+
+        /// <summary>
+        /// Migrate from EF Core 5 to EF Core 6.
+        /// </summary>
+        /// <param name="checkId">Document to check.</param>
+        /// <returns>The asynchronous task.</returns>
+        public async Task CheckAndMigrateTagsAsync(string checkId)
+        {
+            bool migrated = true;
+
+            try
+            {
+                var doc = await Documents.FindAsync(checkId);
+            }
+            catch (JsonSerializationException)
+            {
+                migrated = false;
+            }
+
+            if (migrated)
+            {
+                return;
+            }
+
+            var docs = await Documents.FromSqlRaw(
+                "select c.id, c.Uid, c.AuthorAlias, c.Description, c.Html, c.Markdown, c.PublishDate, c.Title, STRINGTOARRAY(c.Tags) as Tags from c").ToListAsync();
+            foreach (var doc in docs)
+            {
+                Entry(doc).State = EntityState.Modified;
+            }
+
+            await SaveChangesAsync();
+        }
+
+        /// <summary>
+        /// Configure the model that maps the domain to the backend.
+        /// </summary>
+        /// <param name="modelBuilder">The API for model configuration.</param>
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            modelBuilder.Entity<DocumentAudit>()
+                .HasNoDiscriminator()
+                .ToContainer(nameof(Audits))
+                .HasPartitionKey(da => da.Uid)
+                .HasKey(da => new { da.Id, da.Uid });
+
+            var docModel = modelBuilder.Entity<Document>();
+
+            docModel.ToContainer(nameof(Documents))
+                .HasNoDiscriminator()
+                .HasKey(d => d.Uid);
+
+            docModel.HasPartitionKey(d => d.Uid)
+                .Property(p => p.ETag)
+                .IsETagConcurrency();
+
+            var tagModel = modelBuilder.Entity<Tag>();
+
+            tagModel.Property<string>(PartitionKey);
+
+            tagModel.HasPartitionKey(PartitionKey);
+
+            tagModel.ToContainer(Meta)
+                .HasKey(nameof(Tag.TagName), PartitionKey);
+
+            tagModel.Property(t => t.ETag)
+                .IsETagConcurrency();
+
+            var authorModel = modelBuilder.Entity<Author>();
+
+            authorModel.Property<string>(PartitionKey);
+            authorModel.HasPartitionKey(PartitionKey);
+
+            authorModel.ToContainer(Meta)
+                .HasKey(nameof(Author.Alias), PartitionKey);
+
+            authorModel.Property(a => a.ETag)
+                .IsETagConcurrency();
+
+            base.OnModelCreating(modelBuilder);
+        }
+
+        /// <summary>
+        /// Intercepts saving changes to store audits.
+        /// </summary>
+        /// <param name="sender">The sending context.</param>
+        /// <param name="e">The change arguments.</param>
+        private void DocsContext_SavingChanges(
+            object sender,
+            SavingChangesEventArgs e)
+        {
+            var entries = ChangeTracker.Entries<Document>()
+                .Where(
+                    e => e.State == EntityState.Added ||
+                    e.State == EntityState.Modified)
+                .Select(e => e.Entity)
+                .ToList();
+
+            foreach (var docEntry in entries)
+            {
+                Audits.Add(new DocumentAudit(docEntry));
+            }
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/DocumentService.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/DocumentService.cs
new file mode 100644
index 0000000000..92ba313de0
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/DocumentService.cs
@@ -0,0 +1,462 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Net;
+using System.Threading.Tasks;
+using Microsoft.Azure.Cosmos;
+using Microsoft.EntityFrameworkCore;
+using PlanetaryDocs.Domain;
+
+namespace PlanetaryDocs.DataAccess
+{
+    /// <summary>
+    /// Data access implementation.
+    /// </summary>
+    public class DocumentService : IDocumentService
+    {
+        /// <summary>
+        /// Factory to generate <see cref="DocsContext"/> instances.
+        /// </summary>
+        private readonly IDbContextFactory<DocsContext> factory;
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="DocumentService"/> class.
+        /// </summary>
+        /// <param name="factory">The factory instance.</param>
+        public DocumentService(IDbContextFactory<DocsContext> factory) =>
+            this.factory = factory;
+
+        /// <summary>
+        /// Add a new document.
+        /// </summary>
+        /// <param name="document">The <see cref="Document"/> to add.</param>
+        /// <returns>An asynchronous <see cref="Task"/>.</returns>
+        public async Task InsertDocumentAsync(Document document)
+        {
+            using var context = factory.CreateDbContext();
+
+            await HandleMetaAsync(context, document);
+
+            context.Add(document);
+
+            await context.SaveChangesAsync();
+        }
+
+        /// <summary>
+        /// Loads a single <see cref="Document"/>.
+        /// </summary>
+        /// <param name="uid">The unique identifier.</param>
+        /// <returns>The <see cref="Document"/>.</returns>
+        public async Task<Document> LoadDocumentAsync(string uid)
+        {
+            using var context = factory.CreateDbContext();
+            return await context.Documents
+                    .WithPartitionKey(uid)
+                    .SingleOrDefaultAsync(d => d.Uid == uid);
+        }
+
+        /// <summary>
+        /// Query to obtain a <see cref="Document"/> list.
+        /// </summary>
+        /// <param name="searchText">Text to look for.</param>
+        /// <param name="authorAlias">Restrict to an author.</param>
+        /// <param name="tag">Restrict to a tag.</param>
+        /// <returns>The matching <see cref="Document"/> list.</returns>
+        public async Task<List<DocumentSummary>> QueryDocumentsAsync(
+            string searchText,
+            string authorAlias,
+            string tag)
+        {
+            using var context = factory.CreateDbContext();
+
+            var result = new HashSet<DocumentSummary>();
+
+            var partialResults = false;
+
+            if (!string.IsNullOrWhiteSpace(authorAlias))
+            {
+                partialResults = true;
+                var author = await context.FindMetaAsync<Author>(authorAlias);
+                foreach (var ds in author.Documents)
+                {
+                    result.Add(ds);
+                }
+            }
+
+            if (!string.IsNullOrWhiteSpace(tag))
+            {
+                var tagEntity = await context.FindMetaAsync<Tag>(tag);
+
+                var resultSet =
+                    Enumerable.Empty<DocumentSummary>();
+
+                // alias _AND_ tag
+                if (partialResults)
+                {
+                    resultSet = result.Intersect(tagEntity.Documents);
+                }
+                else
+                {
+                    resultSet = tagEntity.Documents;
+                }
+
+                result.Clear();
+
+                foreach (var docSummary in resultSet)
+                {
+                    result.Add(docSummary);
+                }
+
+                partialResults = true;
+            }
+
+            // nothing more to do?
+            if (string.IsNullOrWhiteSpace(searchText))
+            {
+                return result.OrderBy(r => r.Title).ToList();
+            }
+
+            // no list to filter further
+            if (partialResults && result.Count < 1)
+            {
+                return result.ToList();
+            }
+
+            // find documents that match
+            var documents = await context.Documents.Where(
+                d => d.Title.Contains(searchText) ||
+                d.Description.Contains(searchText) ||
+                d.Markdown.Contains(searchText))
+                .ToListAsync();
+
+            // now only intersect with alias/tag constraints
+            if (partialResults)
+            {
+                var uids = result.Select(ds => ds.Uid).ToList();
+                documents = documents.Where(d => uids.Contains(d.Uid))
+                    .ToList();
+            }
+
+            return documents.Select(d => new DocumentSummary(d))
+                 .OrderBy(ds => ds.Title).ToList();
+        }
+
+        /// <summary>
+        /// Searches author aliases.
+        /// </summary>
+        /// <param name="searchText">Text to search on.</param>
+        /// <returns>The list of matching aliases.</returns>
+        public async Task<List<string>> SearchAuthorsAsync(string searchText)
+        {
+            using var context = factory.CreateDbContext();
+            var partitionKey = DocsContext.ComputePartitionKey<Author>();
+            return (await context.Authors
+                .WithPartitionKey(partitionKey)
+                .Select(a => a.Alias)
+                .ToListAsync())
+                .Where(
+                    a => a.Contains(searchText, System.StringComparison.InvariantCultureIgnoreCase))
+                .OrderBy(a => a)
+                .ToList();
+        }
+
+        /// <summary>
+        /// Searches tags.
+        /// </summary>
+        /// <param name="searchText">Text to search on.</param>
+        /// <returns>The list of matching tags.</returns>
+        public async Task<List<string>> SearchTagsAsync(string searchText)
+        {
+            using var context = factory.CreateDbContext();
+            var partitionKey = DocsContext.ComputePartitionKey<Tag>();
+            var toSearch = searchText.Trim();
+            return (await context.Tags
+                .WithPartitionKey(partitionKey)
+                .Select(t => t.TagName)
+                .ToListAsync())
+                .Where(t => t.Contains(
+                    searchText,
+                    System.StringComparison.InvariantCultureIgnoreCase))
+                .OrderBy(t => t)
+                .ToList();
+        }
+
+        /// <summary>
+        /// Updates an existing document.
+        /// </summary>
+        /// <param name="document">The <see cref="Document"/> to update.</param>
+        /// <returns>An asynchronous <see cref="Task"/>.</returns>
+        public async Task UpdateDocumentAsync(Document document)
+        {
+            using var context = factory.CreateDbContext();
+
+            await HandleMetaAsync(context, document);
+
+            context.Update(document);
+
+            await context.SaveChangesAsync();
+        }
+
+        /// <summary>
+        /// Retrieves the audit history of the <see cref="Document"/>.
+        /// </summary>
+        /// <param name="uid">The unique identifier of the <see cref="Document"/>.</param>
+        /// <returns>The list of audit entries.</returns>
+        public async Task<List<DocumentAuditSummary>> LoadDocumentHistoryAsync(string uid)
+        {
+            using var context = factory.CreateDbContext();
+            return (await context.Audits
+                .WithPartitionKey(uid)
+                .Where(da => da.Uid == uid)
+                .ToListAsync())
+                .Select(da => new DocumentAuditSummary(da))
+                .OrderBy(das => das.Timestamp)
+                .ToList();
+        }
+
+        /// <summary>
+        /// Loads a specific snapshot.
+        /// </summary>
+        /// <param name="guid">The unique identifier of the snapshot.</param>
+        /// <param name="uid">The unique identifier of the document.</param>
+        /// <returns>The document snapshot.</returns>
+        public async Task<Document> LoadDocumentSnapshotAsync(System.Guid guid, string uid)
+        {
+            using var context = factory.CreateDbContext();
+            try
+            {
+                var audit = await context.FindAsync<DocumentAudit>(guid, uid);
+                return audit.GetDocumentSnapshot();
+            }
+            catch (CosmosException ce)
+            {
+                if (ce.StatusCode == HttpStatusCode.NotFound)
+                {
+                    return null;
+                }
+
+                throw;
+            }
+        }
+
+        /// <summary>
+        /// Deletes a document.
+        /// </summary>
+        /// <param name="uid">The unique identifier.</param>
+        /// <returns>The asynchronous task.</returns>
+        public async Task DeleteDocumentAsync(string uid)
+        {
+            using var context = factory.CreateDbContext();
+            var docToDelete = await LoadDocumentAsync(uid);
+            var author = await context.FindMetaAsync<Author>(docToDelete.AuthorAlias);
+            var summary = author.Documents.Find(d => d.Uid == uid);
+            if (summary != null)
+            {
+                author.Documents.Remove(summary);
+                context.Update(author);
+            }
+
+            foreach (var tag in docToDelete.Tags)
+            {
+                var tagEntity = await context.FindMetaAsync<Tag>(tag);
+                var tagSummary = tagEntity.Documents.Find(d => d.Uid == uid);
+                if (tagSummary != null)
+                {
+                    tagEntity.Documents.Remove(tagSummary);
+                    context.Update(tagEntity);
+                }
+            }
+
+            context.Remove(docToDelete);
+            await context.SaveChangesAsync();
+        }
+
+        /// <summary>
+        /// Restores a version of the deleted document.
+        /// </summary>
+        /// <param name="id">The id of the audit.</param>
+        /// <param name="uid">The unique identifiers of the document.</param>
+        /// <returns>The restored document.</returns>
+        public async Task<Document> RestoreDocumentAsync(Guid id, string uid)
+        {
+            var snapshot = await LoadDocumentSnapshotAsync(id, uid);
+            await InsertDocumentAsync(snapshot);
+            return await LoadDocumentAsync(uid);
+        }
+
+        /// <summary>
+        /// Gets the document without tracking for comparisons.
+        /// </summary>
+        /// <param name="context">The <see cref="DocsContext"/>.</param>
+        /// <param name="document">The <see cref="Document"/> to reference.</param>
+        /// <returns>The <see cref="Document"/> instance.</returns>
+        private static async Task<Document> LoadDocNoTrackingAsync(
+        DocsContext context, Document document) =>
+            await context.Documents
+                .WithPartitionKey(document.Uid)
+                .AsNoTracking()
+                .SingleOrDefaultAsync(d => d.Uid == document.Uid);
+
+        /// <summary>
+        /// Keeps tags and authors in sync.
+        /// </summary>
+        /// <param name="context">The <see cref="DocsContext"/>.</param>
+        /// <param name="document">The <see cref="Document"/> to sync.</param>
+        /// <returns>An asynchronous task.</returns>
+        private static async Task HandleMetaAsync(
+            DocsContext context,
+            Document document)
+        {
+            var authorChanged =
+                await CheckAuthorChangedAsync(context, document);
+            await HandleTagsAsync(context, document, authorChanged);
+        }
+
+        /// <summary>
+        /// Keeps tags in sync.
+        /// </summary>
+        /// <param name="context">The <see cref="DocsContext"/>.</param>
+        /// <param name="document">The <see cref="Document"/>.</param>
+        /// <param name="authorChanged">A value indicating whether the author was updated.</param>
+        /// <returns>An asynchronous task.</returns>
+        private static async Task HandleTagsAsync(
+            DocsContext context,
+            Document document,
+            bool authorChanged)
+        {
+            var refDoc = await LoadDocNoTrackingAsync(context, document);
+
+            // did the title change?
+            var updatedTitle = refDoc != null && refDoc.Title != document.Title;
+
+            // tags removed need summary taken away
+            if (refDoc != null)
+            {
+                var removed = refDoc.Tags.Where(
+                    t => !document.Tags.Any(dt => dt == t));
+
+                foreach (var removedTag in removed)
+                {
+                    var tag = await context.FindMetaAsync<Tag>(removedTag);
+
+                    if (tag != null)
+                    {
+                        var docSummary =
+                            tag.Documents.Find(
+                                d => d.Uid == document.Uid);
+
+                        if (docSummary != null)
+                        {
+                            tag.Documents.Remove(docSummary);
+                            context.Entry(tag).State = EntityState.Modified;
+                        }
+                    }
+                }
+            }
+
+            // figure out new tags
+            var tagsAdded = refDoc == null ?
+                document.Tags : document.Tags.Where(
+                    t => !refDoc.Tags.Any(rt => rt == t));
+
+            // do existing tags need title updated?
+            if (updatedTitle || authorChanged)
+            {
+                // added ones will be handled later
+                var tagsToChange = document.Tags.Except(tagsAdded);
+
+                foreach (var tagName in tagsToChange)
+                {
+                    var tag = await context.FindMetaAsync<Tag>(tagName);
+                    var ds = tag.Documents.SingleOrDefault(ds => ds.Uid == document.Uid);
+                    if (ds != null)
+                    {
+                        ds.Title = document.Title;
+                        ds.AuthorAlias = document.AuthorAlias;
+                        context.Entry(tag).State = EntityState.Modified;
+                    }
+                }
+            }
+
+            // brand new tags (for the document)
+            foreach (var tagAdded in tagsAdded)
+            {
+                var tag = await context.FindMetaAsync<Tag>(tagAdded);
+
+                // new tag (overall)
+                if (tag == null)
+                {
+                    tag = new Tag { TagName = tagAdded };
+                    context.SetPartitionKey(tag);
+                    context.Add(tag);
+                }
+                else
+                {
+                    context.Entry(tag).State = EntityState.Modified;
+                }
+
+                // either way, add the document summary
+                tag.Documents.Add(new DocumentSummary(document));
+            }
+        }
+
+        /// <summary>
+        /// Handles sync of authors.
+        /// </summary>
+        /// <param name="context">The <see cref="DocsContext"/>.</param>
+        /// <param name="document">The <see cref="Document"/>.</param>
+        /// <returns>A value indicating whether the author changed.</returns>
+        private static async Task<bool> CheckAuthorChangedAsync(
+            DocsContext context, Document document)
+        {
+            var changed = false;
+            var refDoc = await LoadDocNoTrackingAsync(context, document);
+
+            // did the title change?
+            if (refDoc != null && refDoc.AuthorAlias == document.AuthorAlias
+                && refDoc.Title != document.Title)
+            {
+                var author = await context.FindMetaAsync<Author>(document.AuthorAlias);
+                var docSummary = author.Documents.Single(ds => ds.Uid == document.Uid);
+                docSummary.Title = document.Title;
+                context.Entry(author).State = EntityState.Modified;
+            }
+
+            // did the author change? (always true for a new document)
+            if (refDoc == null || refDoc.AuthorAlias != document.AuthorAlias)
+            {
+                if (refDoc != null)
+                {
+                    changed = true;
+                    var oldAuthor = refDoc.AuthorAlias;
+                    var author = await context.FindMetaAsync<Author>(oldAuthor);
+                    var doc = author.Documents.SingleOrDefault(
+                        d => d.Uid == document.Uid);
+                    if (doc != null)
+                    {
+                        author.Documents.Remove(doc);
+                        context.Entry(author).State = EntityState.Modified;
+                    }
+                }
+
+                var newAuthor = await context.FindMetaAsync<Author>(
+                    document.AuthorAlias);
+
+                if (newAuthor == null)
+                {
+                    newAuthor = new Author { Alias = document.AuthorAlias };
+                    context.SetPartitionKey(newAuthor);
+                    context.Add(newAuthor);
+                }
+                else
+                {
+                    context.Entry(newAuthor).State = EntityState.Modified;
+                }
+
+                newAuthor.Documents.Add(new DocumentSummary(document));
+            }
+
+            return changed;
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/PlanetaryDocs.DataAccess.csproj b/samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/PlanetaryDocs.DataAccess.csproj
new file mode 100644
index 0000000000..d8220e6244
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs.DataAccess/PlanetaryDocs.DataAccess.csproj
@@ -0,0 +1,16 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <Description>Data access for Planetary Docs.</Description>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Cosmos" Version="10.0.0" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\PlanetaryDocs.Domain\PlanetaryDocs.Domain.csproj" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/Author.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/Author.cs
new file mode 100644
index 0000000000..6d4f6b38f8
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/Author.cs
@@ -0,0 +1,47 @@
+using System.Collections.Generic;
+
+namespace PlanetaryDocs.Domain
+{
+    /// <summary>
+    /// A document author.
+    /// </summary>
+    public class Author : IDocSummaries
+    {
+        /// <summary>
+        /// Gets or sets the alias.
+        /// </summary>
+        public string Alias { get; set; }
+
+        /// <summary>
+        /// Gets the list of documents by this author.
+        /// </summary>
+        public List<DocumentSummary> Documents { get; }
+            = new List<DocumentSummary>();
+
+        /// <summary>
+        /// Gets or sets the concurrency tag.
+        /// </summary>
+        public string ETag { get; set; }
+
+        /// <summary>
+        /// Gets the hash code.
+        /// </summary>
+        /// <returns>The hashcode of the alias.</returns>
+        public override int GetHashCode() => Alias.GetHashCode();
+
+        /// <summary>
+        /// Implements equality.
+        /// </summary>
+        /// <param name="obj">The object to compare.</param>
+        /// <returns>A value indicating whether the aliases match.</returns>
+        public override bool Equals(object obj) =>
+            obj is Author author && author.Alias == Alias;
+
+        /// <summary>
+        /// Gets the string representation.
+        /// </summary>
+        /// <returns>The string representation.</returns>
+        public override string ToString() =>
+            $"Author {Alias} has {Documents.Count} documents.";
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/Document.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/Document.cs
new file mode 100644
index 0000000000..d304f45806
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/Document.cs
@@ -0,0 +1,78 @@
+using System;
+using System.Collections.Generic;
+
+namespace PlanetaryDocs.Domain
+{
+    /// <summary>
+    /// A document item.
+    /// </summary>
+    public class Document
+    {
+        /// <summary>
+        /// Gets or sets the unique identifier.
+        /// </summary>
+        public string Uid { get; set; }
+
+        /// <summary>
+        /// Gets or sets the title.
+        /// </summary>
+        public string Title { get; set; }
+
+        /// <summary>
+        /// Gets or sets the description.
+        /// </summary>
+        public string Description { get; set; }
+
+        /// <summary>
+        /// Gets or sets the published date.
+        /// </summary>
+        public DateTime PublishDate { get; set; }
+
+        /// <summary>
+        /// Gets or sets the markdown content.
+        /// </summary>
+        public string Markdown { get; set; }
+
+        /// <summary>
+        /// Gets or sets the generated html.
+        /// </summary>
+        public string Html { get; set; }
+
+        /// <summary>
+        /// Gets or sets the author's alias.
+        /// </summary>
+        public string AuthorAlias { get; set; }
+
+        /// <summary>
+        /// Gets or sets the list of related tags.
+        /// </summary>
+        public List<string> Tags { get; set; }
+            = new List<string>();
+
+        /// <summary>
+        /// Gets or sets the concurrency token.
+        /// </summary>
+        public string ETag { get; set; }
+
+        /// <summary>
+        /// Gets the hash code.
+        /// </summary>
+        /// <returns>The hash code of the unique identifier.</returns>
+        public override int GetHashCode() => Uid.GetHashCode();
+
+        /// <summary>
+        /// Implements equality.
+        /// </summary>
+        /// <param name="obj">The object to compare to.</param>
+        /// <returns>A value indicating whether the unique identifiers match.</returns>
+        public override bool Equals(object obj) =>
+            obj is Document document && document.Uid == Uid;
+
+        /// <summary>
+        /// Gets the string representation.
+        /// </summary>
+        /// <returns>The string representation.</returns>
+        public override string ToString() =>
+            $"Document {Uid} by {AuthorAlias} with {Tags.Count} tags: {Title}.";
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/DocumentAudit.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/DocumentAudit.cs
new file mode 100644
index 0000000000..a648565c37
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/DocumentAudit.cs
@@ -0,0 +1,58 @@
+using System;
+using System.Text.Json;
+
+namespace PlanetaryDocs.Domain
+{
+    /// <summary>
+    /// Represents a snapshot of the document.
+    /// </summary>
+    public class DocumentAudit
+    {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="DocumentAudit"/> class.
+        /// </summary>
+        public DocumentAudit()
+        {
+        }
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="DocumentAudit"/> class
+        /// and configures it with the <see cref="Document"/> passed in.
+        /// </summary>
+        /// <param name="document">The document to audit.</param>
+        public DocumentAudit(Document document)
+        {
+            Id = Guid.NewGuid();
+            Uid = document.Uid;
+            Document = JsonSerializer.Serialize(document);
+            Timestamp = DateTimeOffset.UtcNow;
+        }
+
+        /// <summary>
+        /// Gets or sets a unique identifier.
+        /// </summary>
+        public Guid Id { get; set; }
+
+        /// <summary>
+        /// Gets or sets the identifier of the document.
+        /// </summary>
+        public string Uid { get; set; }
+
+        /// <summary>
+        /// Gets or sets the timestamp of the audit.
+        /// </summary>
+        public DateTimeOffset Timestamp { get; set; }
+
+        /// <summary>
+        /// Gets or sets the JSON serialized snapshot.
+        /// </summary>
+        public string Document { get; set; }
+
+        /// <summary>
+        /// Deserializes the snapshot.
+        /// </summary>
+        /// <returns>The <see cref="Document"/> snapshot.</returns>
+        public Document GetDocumentSnapshot() =>
+            JsonSerializer.Deserialize<Document>(Document);
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/DocumentAuditSummary.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/DocumentAuditSummary.cs
new file mode 100644
index 0000000000..c4635a03cd
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/DocumentAuditSummary.cs
@@ -0,0 +1,78 @@
+using System;
+
+namespace PlanetaryDocs.Domain
+{
+    /// <summary>
+    /// Simple class representing a document snapshot.
+    /// </summary>
+    public class DocumentAuditSummary
+    {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="DocumentAuditSummary"/> class.
+        /// </summary>
+        public DocumentAuditSummary()
+        {
+        }
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="DocumentAuditSummary"/> class
+        /// and initializes it with the <see cref="DocumentAudit"/>.
+        /// </summary>
+        /// <param name="documentAudit">The <see cref="DocumentAudit"/> to summarize.</param>
+        public DocumentAuditSummary(DocumentAudit documentAudit)
+        {
+            Id = documentAudit.Id;
+            Uid = documentAudit.Uid;
+            Timestamp = documentAudit.Timestamp;
+            var doc = documentAudit.GetDocumentSnapshot();
+            Alias = doc.AuthorAlias;
+            Title = doc.Title;
+        }
+
+        /// <summary>
+        /// Gets or sets the unique identifier.
+        /// </summary>
+        public Guid Id { get; set; }
+
+        /// <summary>
+        /// Gets or sets the timestamp of the audit event.
+        /// </summary>
+        public DateTimeOffset Timestamp { get; set; }
+
+        /// <summary>
+        /// Gets or sets the unique identifier of the document.
+        /// </summary>
+        public string Uid { get; set; }
+
+        /// <summary>
+        /// Gets or sets the author alias for the snapshot.
+        /// </summary>
+        public string Alias { get; set; }
+
+        /// <summary>
+        /// Gets or sets the title at the time of the snapshot.
+        /// </summary>
+        public string Title { get; set; }
+
+        /// <summary>
+        /// Gets the hash code.
+        /// </summary>
+        /// <returns>The hash code of the <see cref="Id"/>.</returns>
+        public override int GetHashCode() => Id.GetHashCode();
+
+        /// <summary>
+        /// Implement equality.
+        /// </summary>
+        /// <param name="obj">The object to compare to.</param>
+        /// <returns>A value indicating whether the object is a <see cref="DocumentAuditSummary"/> with the same <see cref="Id"/>.</returns>
+        public override bool Equals(object obj) =>
+            obj is DocumentAuditSummary das &&
+            das.Id == Id;
+
+        /// <summary>
+        /// The string representation.
+        /// </summary>
+        /// <returns>The string representation of the instance.</returns>
+        public override string ToString() => $"Summary for audit {Id} with document {Uid}.";
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/DocumentSummary.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/DocumentSummary.cs
new file mode 100644
index 0000000000..cd383fb5e7
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/DocumentSummary.cs
@@ -0,0 +1,62 @@
+namespace PlanetaryDocs.Domain
+{
+    /// <summary>
+    /// Represents a summary of a document.
+    /// </summary>
+    public class DocumentSummary
+    {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="DocumentSummary"/> class.
+        /// </summary>
+        public DocumentSummary()
+        {
+        }
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="DocumentSummary"/> class
+        /// and initializes it with the <see cref="Document"/>.
+        /// </summary>
+        /// <param name="doc">The <see cref="Document"/> to summarize.</param>
+        public DocumentSummary(Document doc)
+        {
+            Uid = doc.Uid;
+            Title = doc.Title;
+            AuthorAlias = doc.AuthorAlias;
+        }
+
+        /// <summary>
+        /// Gets or sets the unique id of the <see cref="Document"/>.
+        /// </summary>
+        public string Uid { get; set; }
+
+        /// <summary>
+        /// Gets or sets the title.
+        /// </summary>
+        public string Title { get; set; }
+
+        /// <summary>
+        /// Gets or sets the alias of the author.
+        /// </summary>
+        public string AuthorAlias { get; set; }
+
+        /// <summary>
+        /// Gets the hash code.
+        /// </summary>
+        /// <returns>The hash code of the document identifier.</returns>
+        public override int GetHashCode() => Uid.GetHashCode();
+
+        /// <summary>
+        /// Implements equality.
+        /// </summary>
+        /// <param name="obj">The object to compare to.</param>
+        /// <returns>A value indicating whether the unique identifiers match.</returns>
+        public override bool Equals(object obj) =>
+            obj is DocumentSummary ds && ds.Uid == Uid;
+
+        /// <summary>
+        /// Gets the string representation.
+        /// </summary>
+        /// <returns>The string representation.</returns>
+        public override string ToString() => $"Summary for {Uid} by {AuthorAlias}: {Title}.";
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/IDocSummaries.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/IDocSummaries.cs
new file mode 100644
index 0000000000..0fc70026cf
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/IDocSummaries.cs
@@ -0,0 +1,15 @@
+using System.Collections.Generic;
+
+namespace PlanetaryDocs.Domain
+{
+    /// <summary>
+    /// Indicates classes with summaries.
+    /// </summary>
+    public interface IDocSummaries
+    {
+        /// <summary>
+        /// Gets the list of summaries.
+        /// </summary>
+        List<DocumentSummary> Documents { get; }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/IDocumentService.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/IDocumentService.cs
new file mode 100644
index 0000000000..472f1d77b1
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/IDocumentService.cs
@@ -0,0 +1,89 @@
+using System;
+using System.Collections.Generic;
+using System.Threading.Tasks;
+
+namespace PlanetaryDocs.Domain
+{
+    /// <summary>
+    /// Data service definition.
+    /// </summary>
+    public interface IDocumentService
+    {
+        /// <summary>
+        /// Add a new document.
+        /// </summary>
+        /// <param name="document">The <see cref="Document"/> to add.</param>
+        /// <returns>An asynchronous <see cref="Task"/>.</returns>
+        Task InsertDocumentAsync(Document document);
+
+        /// <summary>
+        /// Updates an existing document.
+        /// </summary>
+        /// <param name="document">The <see cref="Document"/> to update.</param>
+        /// <returns>An asynchronous <see cref="Task"/>.</returns>
+        Task UpdateDocumentAsync(Document document);
+
+        /// <summary>
+        /// Searches tags.
+        /// </summary>
+        /// <param name="searchText">Text to search on.</param>
+        /// <returns>The list of matching tags.</returns>
+        Task<List<string>> SearchTagsAsync(string searchText);
+
+        /// <summary>
+        /// Searches author aliases.
+        /// </summary>
+        /// <param name="searchText">Text to search on.</param>
+        /// <returns>The list of matching aliases.</returns>
+        Task<List<string>> SearchAuthorsAsync(string searchText);
+
+        /// <summary>
+        /// Query to obtain a <see cref="Document"/> list.
+        /// </summary>
+        /// <param name="searchText">Text to look for.</param>
+        /// <param name="authorAlias">Restrict to an author.</param>
+        /// <param name="tag">Restrict to a tag.</param>
+        /// <returns>The matching <see cref="Document"/> list.</returns>
+        Task<List<DocumentSummary>> QueryDocumentsAsync(
+            string searchText,
+            string authorAlias,
+            string tag);
+
+        /// <summary>
+        /// Loads a single <see cref="Document"/>.
+        /// </summary>
+        /// <param name="uid">The unique identifier.</param>
+        /// <returns>The <see cref="Document"/>.</returns>
+        Task<Document> LoadDocumentAsync(string uid);
+
+        /// <summary>
+        /// Retrieves the audit history of the <see cref="Document"/>.
+        /// </summary>
+        /// <param name="uid">The unique identifier of the <see cref="Document"/>.</param>
+        /// <returns>The list of audit entries.</returns>
+        Task<List<DocumentAuditSummary>> LoadDocumentHistoryAsync(string uid);
+
+        /// <summary>
+        /// Loads a specific snapshot.
+        /// </summary>
+        /// <param name="guid">The unique identifier of the snapshot.</param>
+        /// <param name="uid">The unique identifier of the document.</param>
+        /// <returns>The document snapshot.</returns>
+        Task<Document> LoadDocumentSnapshotAsync(Guid guid, string uid);
+
+        /// <summary>
+        /// Deletes a document.
+        /// </summary>
+        /// <param name="uid">The unique identifier.</param>
+        /// <returns>The asynchronous task.</returns>
+        Task DeleteDocumentAsync(string uid);
+
+        /// <summary>
+        /// Restores a version of the deleted document.
+        /// </summary>
+        /// <param name="id">The id of the audit.</param>
+        /// <param name="uid">The unique identifiers of the document.</param>
+        /// <returns>The restored document.</returns>
+        Task<Document> RestoreDocumentAsync(Guid id, string uid);
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/PlanetaryDocs.Domain.csproj b/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/PlanetaryDocs.Domain.csproj
new file mode 100644
index 0000000000..a56034f951
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/PlanetaryDocs.Domain.csproj
@@ -0,0 +1,9 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <LangVersion>10.0</LangVersion>
+    <Description>Domain models and business logic.</Description>
+  </PropertyGroup>
+
+ </Project>
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/Tag.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/Tag.cs
new file mode 100644
index 0000000000..bef13d37dc
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/Tag.cs
@@ -0,0 +1,47 @@
+using System.Collections.Generic;
+
+namespace PlanetaryDocs.Domain
+{
+    /// <summary>
+    /// A tag.
+    /// </summary>
+    public class Tag : IDocSummaries
+    {
+        /// <summary>
+        /// Gets or sets the name of the tag.
+        /// </summary>
+        public string TagName { get; set; }
+
+        /// <summary>
+        /// Gets or sets a summary of documents with the tag.
+        /// </summary>
+        public List<DocumentSummary> Documents { get; set; }
+            = new List<DocumentSummary>();
+
+        /// <summary>
+        /// Gets or sets the concurrency token.
+        /// </summary>
+        public string ETag { get; set; }
+
+        /// <summary>
+        /// Gets the hash code.
+        /// </summary>
+        /// <returns>The hash code of the tag name.</returns>
+        public override int GetHashCode() => TagName.GetHashCode();
+
+        /// <summary>
+        /// Implements equality.
+        /// </summary>
+        /// <param name="obj">The object to compare to.</param>
+        /// <returns>A value indicating whether the tag names match.</returns>
+        public override bool Equals(object obj) =>
+            obj is Tag tag && tag.TagName == TagName;
+
+        /// <summary>
+        /// Gets the string representation.
+        /// </summary>
+        /// <returns>The string representation.</returns>
+        public override string ToString() =>
+            $"Tag {TagName} tagged by {Documents.Count} documents.";
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/ValidationRules.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/ValidationRules.cs
new file mode 100644
index 0000000000..fc25beb600
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/ValidationRules.cs
@@ -0,0 +1,223 @@
+using System;
+using System.Linq;
+
+namespace PlanetaryDocs.Domain
+{
+    /// <summary>
+    /// Validation rules for the project.
+    /// </summary>
+    public static class ValidationRules
+    {
+        /// <summary>
+        /// Allowed punctuation.
+        /// </summary>
+        private const string Punctuation = "(),?!'\".";
+
+        /// <summary>
+        /// Punctuation allowed in the unique document identifier.
+        /// </summary>
+        private const string UidAllowed = "_.-";
+
+        /// <summary>
+        /// The low range of alpha.
+        /// </summary>
+        private const string LowRange = "az";
+
+        /// <summary>
+        /// The high range of alpha.
+        /// </summary>
+        private const string HighRange = "AZ";
+
+        /// <summary>
+        /// Numbers range.
+        /// </summary>
+        private const string Numbers = "09";
+
+        /// <summary>
+        /// Generate a valid <see cref="ValidationState"/>.
+        /// </summary>
+        /// <returns>The <see cref="ValidationState"/>.</returns>
+        public static ValidationState ValidResult() =>
+            new () { IsValid = true };
+
+        /// <summary>
+        /// Generate an invalid <see cref="ValidationState"/>.
+        /// </summary>
+        /// <param name="message">The validation message.</param>
+        /// <returns>The <see cref="ValidationState"/>.</returns>
+        public static ValidationState InvalidResult(string message) => new ()
+        {
+            IsValid = false,
+            Message = message,
+        };
+
+        /// <summary>
+        /// Handles multiple results and returns the first invalid result.
+        /// </summary>
+        /// <param name="fieldName">The name of the field.</param>
+        /// <param name="fieldValue">The value.</param>
+        /// <param name="validations">The validations to apply.</param>
+        /// <returns>Either a valid result or the first invalid result.</returns>
+        public static ValidationState CompoundResult(
+            string fieldName,
+            string fieldValue,
+            params Func<string, string, ValidationState>[] validations)
+        {
+            var result = ValidResult();
+            foreach (var validation in validations)
+            {
+                result = validation(fieldName, fieldValue);
+                if (!result.IsValid)
+                {
+                    return result;
+                }
+            }
+
+            return result;
+        }
+
+        /// <summary>
+        /// Validate that content exists.
+        /// </summary>
+        /// <param name="fieldName">The name of the field.</param>
+        /// <param name="val">The value.</param>
+        /// <returns>The <see cref="ValidationState"/>.</returns>
+        public static ValidationState IsRequired(
+            string fieldName,
+            string val) => string.IsNullOrWhiteSpace(val) ?
+   InvalidResult($"{fieldName} is required.")
+   : ValidResult();
+
+        /// <summary>
+        /// Validates only alpha allowed.
+        /// </summary>
+        /// <param name="fieldName">The name of the field.</param>
+        /// <param name="val">The value.</param>
+        /// <returns>The <see cref="ValidationState"/>.</returns>
+        public static ValidationState IsAlphaOnly(
+            string fieldName,
+            string val)
+        {
+            if (string.IsNullOrWhiteSpace(val))
+            {
+                return InvalidResult($"Field '{fieldName}' cannot be null or empty.");
+            }
+
+            return val.All(c => (c >= LowRange[0] && c <= LowRange[1])
+            || (c >= HighRange[0] && c <= HighRange[1])) ?
+                ValidResult()
+                : InvalidResult($"Field '{fieldName}' contains non-alpha characters.");
+        }
+
+        /// <summary>
+        /// Validates allowed alphanumeric and punctuation.
+        /// </summary>
+        /// <param name="fieldName">The name of the field.</param>
+        /// <param name="val">The value.</param>
+        /// <param name="uidCheck">A value indicating whether to restrict punctuation to valid a document id.</param>
+        /// <returns>The <see cref="ValidationState"/>.</returns>
+        public static ValidationState IsSimpleText(
+            string fieldName,
+            string val,
+            bool uidCheck = false)
+        {
+            var valid = true;
+            var limits = new[] { LowRange, HighRange, Numbers };
+
+            foreach (var c in val.AsSpan())
+            {
+                if (!valid)
+                {
+                    break;
+                }
+
+                if (c == ' ')
+                {
+                    continue;
+                }
+
+                if (!uidCheck && Punctuation.Contains(c))
+                {
+                    continue;
+                }
+
+                if (uidCheck && UidAllowed.Contains(c))
+                {
+                    continue;
+                }
+
+                var rangeCheck = false;
+                foreach (var range in limits)
+                {
+                    if (rangeCheck)
+                    {
+                        break;
+                    }
+
+                    if (c >= range[0] && c <= range[1])
+                    {
+                        rangeCheck = true;
+                        continue;
+                    }
+                }
+
+                valid = rangeCheck;
+            }
+
+            return valid ? ValidResult() :
+                InvalidResult($"Field '{fieldName}' contains invalid characters.");
+        }
+
+        /// <summary>
+        /// Master validation routes based on property name.
+        /// </summary>
+        /// <param name="name">The name of the property.</param>
+        /// <param name="value">The value.</param>
+        /// <returns>The <see cref="ValidationState"/>.</returns>
+        public static ValidationState ValidateProperty(
+            string name,
+            string value) => name switch
+            {
+                nameof(Document.AuthorAlias) => CompoundResult(
+                                       name,
+                                       value,
+                                       IsRequired,
+                                       IsAlphaOnly),
+
+                nameof(Document.Description) => IsRequired(name, value),
+
+                nameof(Document.Markdown) => IsRequired(name, value),
+
+                nameof(Document.Title) => CompoundResult(
+                    name,
+                    value,
+                    IsRequired,
+                    (n, v) => IsSimpleText(n, v, false)),
+
+                nameof(Document.Uid) => CompoundResult(
+                    name,
+                    value,
+                    IsRequired,
+                    (n, v) => IsSimpleText(n, v, true)),
+
+                _ => InvalidResult("Unknown property."),
+            };
+
+        /// <summary>
+        /// Validates all fields on the <see cref="Document"/>.
+        /// </summary>
+        /// <param name="doc">The <see cref="Document"/> to validate.</param>
+        /// <returns>The <see cref="ValidationState"/>.</returns>
+        public static ValidationState[] ValidateDocument(Document doc) =>
+            doc == null
+                ? new[] { InvalidResult("Document cannot be null") }
+                : new[]
+                {
+                    ValidateProperty(nameof(Document.Uid), doc.Uid),
+                    ValidateProperty(nameof(Document.AuthorAlias), doc.AuthorAlias),
+                    ValidateProperty(nameof(Document.Description), doc.Description),
+                    ValidateProperty(nameof(Document.Markdown), doc.Markdown),
+                    ValidateProperty(nameof(Document.Title), doc.Title),
+                };
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/ValidationState.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/ValidationState.cs
new file mode 100644
index 0000000000..6fd0484c82
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs.Domain/ValidationState.cs
@@ -0,0 +1,25 @@
+namespace PlanetaryDocs.Domain
+{
+    /// <summary>
+    /// The result of a validation.
+    /// </summary>
+    public class ValidationState
+    {
+        /// <summary>
+        /// Gets or sets a value indicating whether the property is valid.
+        /// </summary>
+        public bool IsValid { get; set; }
+
+        /// <summary>
+        /// Gets or sets the reason why validation failed.
+        /// </summary>
+        public string Message { get; set; }
+
+        /// <summary>
+        /// String representation.
+        /// </summary>
+        /// <returns>The string represention.</returns>
+        public override string ToString() =>
+            IsValid ? "Valid" : $"Invalid: {Message}";
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs.sln b/samples/end2end/PlanetaryDocs/PlanetaryDocs.sln
new file mode 100644
index 0000000000..55e817eede
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs.sln
@@ -0,0 +1,65 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.1.31911.260
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "PlanetaryDocs", "PlanetaryDocs\PlanetaryDocs.csproj", "{9752E8CA-BCA2-4383-A2C3-9A619C95C2C7}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "PlanetaryDocs.Domain", "PlanetaryDocs.Domain\PlanetaryDocs.Domain.csproj", "{41EE61E6-81B4-4816-9E62-25040A4BAC6D}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "PlanetaryDocs.DataAccess", "PlanetaryDocs.DataAccess\PlanetaryDocs.DataAccess.csproj", "{8E4FB7E5-BC05-4A5F-9A5C-377FDB0F4172}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "PlanetaryDocsLoader", "PlanetaryDocsLoader\PlanetaryDocsLoader.csproj", "{43DFBA3B-80BE-4DCB-82D2-2EAC03CD5EF7}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{B956AEFD-4189-4B9B-86B6-2B23A9B7DE1C}"
+	ProjectSection(SolutionItems) = preProject
+		.editorconfig = .editorconfig
+		Directory.Build.props = Directory.Build.props
+		README.md = README.md
+		stylecop.json = stylecop.json
+	EndProjectSection
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Tests", "Tests", "{BE2E007C-9286-4061-AF85-D0E641C9AF79}"
+	ProjectSection(SolutionItems) = preProject
+		Tests\Directory.Build.props = Tests\Directory.Build.props
+	EndProjectSection
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "DomainTests", "Tests\DomainTests\DomainTests.csproj", "{2D7599D9-6851-4BA3-9B83-1BE219E286B9}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{9752E8CA-BCA2-4383-A2C3-9A619C95C2C7}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{9752E8CA-BCA2-4383-A2C3-9A619C95C2C7}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{9752E8CA-BCA2-4383-A2C3-9A619C95C2C7}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{9752E8CA-BCA2-4383-A2C3-9A619C95C2C7}.Release|Any CPU.Build.0 = Release|Any CPU
+		{41EE61E6-81B4-4816-9E62-25040A4BAC6D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{41EE61E6-81B4-4816-9E62-25040A4BAC6D}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{41EE61E6-81B4-4816-9E62-25040A4BAC6D}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{41EE61E6-81B4-4816-9E62-25040A4BAC6D}.Release|Any CPU.Build.0 = Release|Any CPU
+		{8E4FB7E5-BC05-4A5F-9A5C-377FDB0F4172}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{8E4FB7E5-BC05-4A5F-9A5C-377FDB0F4172}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{8E4FB7E5-BC05-4A5F-9A5C-377FDB0F4172}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{8E4FB7E5-BC05-4A5F-9A5C-377FDB0F4172}.Release|Any CPU.Build.0 = Release|Any CPU
+		{43DFBA3B-80BE-4DCB-82D2-2EAC03CD5EF7}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{43DFBA3B-80BE-4DCB-82D2-2EAC03CD5EF7}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{43DFBA3B-80BE-4DCB-82D2-2EAC03CD5EF7}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{43DFBA3B-80BE-4DCB-82D2-2EAC03CD5EF7}.Release|Any CPU.Build.0 = Release|Any CPU
+		{2D7599D9-6851-4BA3-9B83-1BE219E286B9}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{2D7599D9-6851-4BA3-9B83-1BE219E286B9}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{2D7599D9-6851-4BA3-9B83-1BE219E286B9}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{2D7599D9-6851-4BA3-9B83-1BE219E286B9}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(NestedProjects) = preSolution
+		{2D7599D9-6851-4BA3-9B83-1BE219E286B9} = {BE2E007C-9286-4061-AF85-D0E641C9AF79}
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {2064456E-0D82-443B-ACBD-92A598775C6B}
+	EndGlobalSection
+EndGlobal
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/App.razor b/samples/end2end/PlanetaryDocs/PlanetaryDocs/App.razor
new file mode 100644
index 0000000000..3a2af53024
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/App.razor
@@ -0,0 +1,10 @@
+<Router AppAssembly="@typeof(Program).Assembly" PreferExactMatches="@true">
+    <Found Context="routeData">
+        <RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
+    </Found>
+    <NotFound>
+        <LayoutView Layout="@typeof(MainLayout)">
+            <p>Sorry, there's nothing at this address.</p>
+        </LayoutView>
+    </NotFound>
+</Router>
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/CosmosSettings.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/CosmosSettings.cs
new file mode 100644
index 0000000000..58429c80ac
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/CosmosSettings.cs
@@ -0,0 +1,28 @@
+namespace PlanetaryDocs
+{
+    /// <summary>
+    /// Settings to connect to Cosmos DB.
+    /// </summary>
+    public class CosmosSettings
+    {
+        /// <summary>
+        /// Gets or sets the endpoint.
+        /// </summary>
+        public string EndPoint { get; set; }
+
+        /// <summary>
+        /// Gets or sets the access key.
+        /// </summary>
+        public string AccessKey { get; set; }
+
+        /// <summary>
+        /// Gets or sets a value indicating whether startup should check for migrations.
+        /// </summary>
+        public bool EnableMigration { get; set; }
+
+        /// <summary>
+        /// Gets or sets the id of the document to check for migration.
+        /// </summary>
+        public string DocumentToCheck { get; set; }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/Add.razor b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/Add.razor
new file mode 100644
index 0000000000..78d5b40b74
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/Add.razor
@@ -0,0 +1,30 @@
+@page "/Add"
+
+@inherits AddBase
+
+<div class="container">
+    @if (Saving)
+    {
+        <Saving/>
+    }
+    else if (Loading)
+    {
+        <Loading/>
+    }
+    else
+    {
+        <EditBar ChangeCount="ChangeCount"
+                 IsValid="IsValid"
+                 IsDirty="IsDirty"
+                 SaveAsync="SaveAsync"/>
+        <div class="row">
+            <div class="col-12">
+                <Editor DocumentToEdit="Document"
+                        Insert="true"
+                        @bind-IsValid="IsValid"
+                        @bind-ChangeCount="ChangeCount"
+                        @ref="Editor" />
+            </div>
+        </div>
+    }
+</div>
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/AddBase.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/AddBase.cs
new file mode 100644
index 0000000000..8114ed8156
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/AddBase.cs
@@ -0,0 +1,133 @@
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Components;
+using PlanetaryDocs.Domain;
+using PlanetaryDocs.Services;
+using PlanetaryDocs.Shared;
+
+namespace PlanetaryDocs.Pages
+{
+    /// <summary>
+    /// Component to add a new document.
+    /// </summary>
+    public class AddBase : ComponentBase
+    {
+        private bool isValid = false;
+
+        /// <summary>
+        /// Gets or sets the navigation service.
+        /// </summary>
+        [Inject]
+        public NavigationManager NavigationService { get; set; }
+
+        /// <summary>
+        /// Gets or sets the document service.
+        /// </summary>
+        [Inject]
+        public IDocumentService DocumentService { get; set; }
+
+        /// <summary>
+        /// Gets or sets the loading service.
+        /// </summary>
+        [CascadingParameter]
+        public LoadingService LoadingService { get; set; }
+
+        /// <summary>
+        /// Gets or sets the title service.
+        /// </summary>
+        [Inject]
+        public TitleService TitleService { get; set; }
+
+        /// <summary>
+        /// Gets or sets a value indicating whether the <see cref="Document"/>
+        /// is in a valid state for add.
+        /// </summary>
+        public bool IsValid
+        {
+            get => isValid;
+            set
+            {
+                if (value != isValid)
+                {
+                    isValid = value;
+                    InvokeAsync(StateHasChanged);
+                }
+            }
+        }
+
+        /// <summary>
+        /// Gets a value indicating whether changes have been made.
+        /// </summary>
+        protected bool IsDirty => ChangeCount > 0;
+
+        /// <summary>
+        /// Gets or sets a value indicating whether a loading operation is taking place.
+        /// </summary>
+        protected bool Loading { get; set; } = true;
+
+        /// <summary>
+        /// Gets or sets a value indicating whether a save operation is in effect.
+        /// </summary>
+        protected bool Saving { get; set; } = false;
+
+        /// <summary>
+        /// Gets or sets the <see cref="Document"/> being added.
+        /// </summary>
+        protected Document Document { get; set; } = new ();
+
+        /// <summary>
+        /// Gets or sets the count of changes detected.
+        /// </summary>
+        protected int ChangeCount { get; set; } = 0;
+
+        /// <summary>
+        /// Gets or sets the <see cref="Editor"/> reference.
+        /// </summary>
+        protected Editor Editor { get; set; }
+
+        /// <summary>
+        /// Main save method.
+        /// </summary>
+        /// <returns>An asynchronous task.</returns>
+        public async Task SaveAsync()
+        {
+            if (!IsDirty || !IsValid || !Editor.ValidateAll(Document))
+            {
+                return;
+            }
+
+            Saving = true;
+
+            await LoadingService.WrapExecutionAsync(async () =>
+                await DocumentService.InsertDocumentAsync(Document));
+
+            NavigationService.NavigateTo(NavigationHelper.ViewDocument(Document.Uid), true);
+        }
+
+        /// <summary>
+        /// Set the title.
+        /// </summary>
+        /// <param name="firstRender">A flag indicating the render status.</param>
+        /// <returns>The asynchronous task.</returns>
+        protected override async Task OnAfterRenderAsync(bool firstRender)
+        {
+            if (firstRender)
+            {
+                await TitleService.SetTitleAsync("Adding new document");
+                Editor.ValidateAll(Document);
+            }
+
+            await base.OnAfterRenderAsync(firstRender);
+        }
+
+        /// <summary>
+        /// Initialize the component.
+        /// </summary>
+        protected override void OnInitialized()
+        {
+            Document = new Document();
+            ChangeCount = 0;
+            Loading = false;
+            base.OnInitialized();
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/Edit.razor b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/Edit.razor
new file mode 100644
index 0000000000..de45b6eeaf
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/Edit.razor
@@ -0,0 +1,49 @@
+@page "/Edit/{Uid}"
+
+@inherits EditBase
+
+<div class="container">
+    @if (NotFound)
+    {
+        <div class="row">
+            <div class="col-12">
+                <div class="alert alert-danger">
+                    <span class="oi oi-circle-x"></span>&nbsp;A document with the id '@Uid' was not found. 
+                </div>
+            </div>
+        </div>
+    }
+    else if (Saving)
+    {
+        <Saving />
+    }
+    else if (Loading)
+    {
+        <Loading />
+    }
+    else
+    {
+        <EditBar ChangeCount="ChangeCount"
+                 IsDirty="IsDirty"
+                 IsValid="IsValid"
+                 SaveAsync="SaveAsync" />
+        @if (Concurrency)
+        {
+            <div class="row">
+                <div class="col-12">
+                    <div class="alert alert-danger">
+                        <span class="oi oi-warning"></span>&nbsp;The document was updated since it was last loaded. You can save again to overwrite changes or reset to reload the document and view the changes.
+                    </div>
+                </div>
+            </div>
+        }
+        <div class="row">
+            <div class="col-12">
+                <Editor DocumentToEdit="Document"
+                        @bind-IsValid="IsValid"
+                        @bind-ChangeCount="ChangeCount"
+                        @ref="Editor" />
+            </div>
+        </div>
+    }
+</div>
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/EditBase.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/EditBase.cs
new file mode 100644
index 0000000000..f965e0c752
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/EditBase.cs
@@ -0,0 +1,193 @@
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Components;
+using Microsoft.EntityFrameworkCore;
+using PlanetaryDocs.Domain;
+using PlanetaryDocs.Services;
+using PlanetaryDocs.Shared;
+
+namespace PlanetaryDocs.Pages
+{
+    /// <summary>
+    /// Base for edit component.
+    /// </summary>
+    public class EditBase : ComponentBase
+    {
+        private string uid = string.Empty;
+        private bool isValid = false;
+
+        /// <summary>
+        /// Gets or sets the <see cref="NavigationManager"/>.
+        /// </summary>
+        [Inject]
+        public NavigationManager NavigationService { get; set; }
+
+        /// <summary>
+        /// Gets or sets the <see cref="IDocumentService"/> implementation.
+        /// </summary>
+        [Inject]
+        public IDocumentService DocumentService { get; set; }
+
+        /// <summary>
+        /// Gets or sets the loading service.
+        /// </summary>
+        [CascadingParameter]
+        public LoadingService LoadingService { get; set; }
+
+        /// <summary>
+        /// Gets or sets the title service.
+        /// </summary>
+        [Inject]
+        public TitleService TitleService { get; set; }
+
+        /// <summary>
+        /// Gets or sets the unique identifier of the document being edited.
+        /// </summary>
+        [Parameter]
+        public string Uid { get; set; }
+
+        /// <summary>
+        /// Gets or sets a value indicating whether the <see cref="Document"/>
+        /// is valid for an update.
+        /// </summary>
+        public bool IsValid
+        {
+            get => isValid;
+            set
+            {
+                if (value != isValid)
+                {
+                    isValid = value;
+                    InvokeAsync(StateHasChanged);
+                }
+            }
+        }
+
+        /// <summary>
+        /// Gets a value indicating whether or not changes have been made.
+        /// </summary>
+        protected bool IsDirty => ChangeCount > 0;
+
+        /// <summary>
+        /// Gets or sets the count of detected changes.
+        /// </summary>
+        protected int ChangeCount { get; set; }
+
+        /// <summary>
+        /// Gets or sets a value indicating whether the <see cref="Document"/>
+        /// could not be found.
+        /// </summary>
+        protected bool NotFound { get; set; }
+
+        /// <summary>
+        /// Gets or sets a value indicating whether a concurrency error was
+        /// encountered during the last update attempt.
+        /// </summary>
+        protected bool Concurrency { get; set; }
+
+        /// <summary>
+        /// Gets or sets a value indicating whether items are being loaded.
+        /// </summary>
+        protected bool Loading { get; set; }
+
+        /// <summary>
+        /// Gets or sets a value indicating whether the <see cref="Document"/>
+        /// is being saved.
+        /// </summary>
+        protected bool Saving { get; set; }
+
+        /// <summary>
+        /// Gets or sets the Document being edited.
+        /// </summary>
+        protected Document Document { get; set; }
+
+        /// <summary>
+        /// Gets or sets a reference to the <see cref="Editor"/> child component.
+        /// </summary>
+        protected Editor Editor { get; set; }
+
+        /// <summary>
+        /// Save operation.
+        /// </summary>
+        /// <returns>An asynchronous task.</returns>
+        public async Task SaveAsync()
+        {
+            if (!IsDirty || !IsValid || !Editor.ValidateAll(Document))
+            {
+                return;
+            }
+
+            Saving = true;
+
+            if (Concurrency)
+            {
+                Concurrency = false;
+                Document original = null;
+
+                await LoadingService.WrapExecutionAsync(async () =>
+                    original =
+                    await DocumentService.LoadDocumentAsync(Document.Uid));
+
+                Document.ETag = original.ETag;
+            }
+
+            try
+            {
+                await LoadingService.WrapExecutionAsync(async () =>
+                    await DocumentService.UpdateDocumentAsync(Document));
+            }
+            catch (DbUpdateConcurrencyException)
+            {
+                Concurrency = true;
+            }
+
+            if (!Concurrency)
+            {
+                NavigationService.NavigateTo(NavigationHelper.ViewDocument(Document.Uid), true);
+            }
+            else
+            {
+                Saving = false;
+            }
+        }
+
+        /// <summary>
+        /// Called after render to set the title.
+        /// </summary>
+        /// <param name="firstRender">A value indicating whether this is the first render.</param>
+        /// <returns>An asynchronous task.</returns>
+        protected override async Task OnAfterRenderAsync(bool firstRender)
+        {
+            if (firstRender && !string.IsNullOrWhiteSpace(Uid))
+            {
+                await TitleService.SetTitleAsync($"Editing '{Uid}'");
+            }
+
+            await base.OnAfterRenderAsync(firstRender);
+        }
+
+        /// <summary>
+        /// Called when the parameters are set. Triggers the document load.
+        /// </summary>
+        /// <returns>An asynchronous task.</returns>
+        protected override async Task OnParametersSetAsync()
+        {
+            if (Uid != uid)
+            {
+                uid = Uid;
+                Loading = true;
+                Document = null;
+                Concurrency = false;
+
+                await LoadingService.WrapExecutionAsync(
+                    async () => Document =
+                    await DocumentService.LoadDocumentAsync(Uid));
+
+                NotFound = Document == null;
+                ChangeCount = 0;
+                Loading = false;
+            }
+
+            await base.OnParametersSetAsync();
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/Error.cshtml b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/Error.cshtml
new file mode 100644
index 0000000000..df8a2f003b
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/Error.cshtml
@@ -0,0 +1,43 @@
+@page
+
+@model PlanetaryDocs.Pages.ErrorModel
+
+<!DOCTYPE html>
+<html>
+
+<head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no" />
+    <title>Error</title>
+    <link href="~/css/bootstrap/bootstrap.min.css" rel="stylesheet" />
+    <link href="~/css/app.css" rel="stylesheet" />
+</head>
+
+<body>
+    <div class="main">
+        <div class="content px-4">
+            <h1 class="text-danger">Error.</h1>
+            <h2 class="text-danger">An error occurred while processing your request.</h2>
+
+            @if (Model.ShowRequestId)
+            {
+                <p>
+                    <strong>Request ID:</strong> <code>@Model.RequestId</code>
+                </p>
+            }
+
+            <h3>Development Mode</h3>
+            <p>
+                Swapping to the <strong>Development</strong> environment displays detailed information about the error that occurred.
+            </p>
+            <p>
+                <strong>The Development environment shouldn't be enabled for deployed applications.</strong>
+                It can result in displaying sensitive information from exceptions to end users.
+                For local debugging, enable the <strong>Development</strong> environment by setting the <strong>ASPNETCORE_ENVIRONMENT</strong> environment variable to <strong>Development</strong>
+                and restarting the app.
+            </p>
+        </div>
+    </div>
+</body>
+
+</html>
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/ErrorModel.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/ErrorModel.cs
new file mode 100644
index 0000000000..58b087a633
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/ErrorModel.cs
@@ -0,0 +1,29 @@
+using System.Diagnostics;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.AspNetCore.Mvc.RazorPages;
+
+namespace PlanetaryDocs.Pages
+{
+    /// <summary>
+    /// The templated error page.
+    /// </summary>
+    [ResponseCache(Duration = 0, Location = ResponseCacheLocation.None, NoStore = true)]
+    [IgnoreAntiforgeryToken]
+    public class ErrorModel : PageModel
+    {
+        /// <summary>
+        /// Gets or sets the request identifier.
+        /// </summary>
+        public string RequestId { get; set; }
+
+        /// <summary>
+        /// Gets a value indicating whether to show the request.
+        /// </summary>
+        public bool ShowRequestId => !string.IsNullOrEmpty(RequestId);
+
+        /// <summary>
+        /// On get method.
+        /// </summary>
+        public void OnGet() => RequestId = Activity.Current?.Id ?? HttpContext.TraceIdentifier;
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/Index.razor b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/Index.razor
new file mode 100644
index 0000000000..92ae918d58
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/Index.razor
@@ -0,0 +1,128 @@
+@page "/"
+
+@inherits IndexBase
+  
+<h1>Planetary Docs</h1>
+<div class="container fixed">
+    <div class="row">
+        <div class="col">
+            <strong>Search Documents:</strong>
+        </div>
+    </div>
+    <div class="row @(Loading ? "loading" : string.Empty)"
+         @onkeypress="HandleKeyPress">
+        <div class="col-4">
+            @if (Loading)
+            {
+                <p>@Text</p>
+            }
+            else
+            {
+                <input tabindex="100"
+                        @bind-value="Text"
+                        @bind-value:event="oninput"
+                        @ref="InputElement"
+                        autofocus
+                        placeholder="Enter search text" />
+            }
+        </div>
+        <div class="col-3">
+            @if (@Loading)
+            {
+                <p><strong>Alias:</strong>&nbsp;@Alias</p>
+            }
+            else
+            {
+                <AliasSearch TabIndex="200" @bind-Alias="Alias"/>
+            }
+        </div>
+        <div class="col-3">
+            @if (Loading)
+            {
+                <p><strong>Tag:</strong>&nbsp;@Tag</p>
+            }
+            else
+            {
+            <TagSearch TabIndex="300" @bind-Tag="Tag" />
+            }
+        </div>
+        <div class="col-2">
+            &nbsp;<button tabindex="400"
+                          class="btn btn-sm btn-success"
+                    @onclick="async () => await SearchAsync()"
+                    disabled="@(!CanSearch)">
+                Search
+            </button>
+        </div>
+    </div>
+    <div class="row">
+        <div class="container">
+            @if (Loading)
+            {
+                <div class="row">
+                    <div class="col-12">
+                        <div class="alert alert-warning">🔎 Searching...</div>
+                    </div>
+                </div>
+            }
+            @if (DocsList != null && !Loading)
+            {
+                <div class="row">
+                    <div class="col-12 text-sm-left">
+                        Search criteria: Alias = '@Alias', Tag = '@Tag', SearchText = '@Text''
+                    </div>
+                    <div class="col-12">
+                        <div class="alert alert-info">
+                            @if (DocsList.Count < 1)
+                            {
+                                <span class="oi oi-circle-x"></span>
+                                <span>&nbsp;No documents found.</span>
+                            }
+                            @if (DocsList.Count == 1)
+                            {
+                                <span class="oi oi-circle-check"></span>
+                                <span>&nbsp;One document found.</span>
+                            }
+                            @if (DocsList.Count > 1)
+                            {
+                                <span class="oi oi-circle-check"></span>
+                                <span>&nbsp;@DocsList.Count documents found.</span>
+                            }
+                        </div>
+                    </div>
+                </div>
+                <div class="row">
+                    <div class="col-2">
+                        &nbsp;
+                    </div>
+                    <div class="col-4">
+                        <b>Alias</b>
+                    </div>
+                    <div class="col-6">
+                        <b>Title</b>
+                    </div>
+                </div>
+                foreach (var doc in DocsList)
+                {
+                    <div @key="doc.Uid" class="row result">
+                        <div class="col-2">
+                            <a title="Edit document" href="@NavigationHelper.EditDocument(doc.Uid)">
+                                <span class="oi oi-pencil">&nbsp;</span>
+                            </a>
+                            &nbsp;
+                            <a title="View document" href="@NavigationHelper.ViewDocument(doc.Uid)">
+                                <span class="oi oi-eye">&nbsp;</span>
+                            </a>
+                        </div>
+                        <div class="col-4 clickable" @onclick="() => Navigate(doc.Uid)">
+                            @doc.AuthorAlias
+                        </div>
+                        <div class="col-6 clickable" @onclick="() => Navigate(doc.Uid)">
+                            @doc.Title
+                        </div>
+                    </div>
+                }
+            }
+        </div>
+    </div>
+</div>
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/Index.razor.css b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/Index.razor.css
new file mode 100644
index 0000000000..b01642e98a
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/Index.razor.css
@@ -0,0 +1,23 @@
+.fixed {
+    height: 70vh;
+    width: 70vw;
+    overflow-y: auto;
+    overflow-x: hidden;
+}
+
+.result {
+    border-top: solid 1px cyan;
+}
+
+.result:hover {
+    background-color: lightgray;
+}
+
+.clickable {
+    cursor: pointer;
+}
+
+.loading {
+    background-color: yellow;
+    border: solid 1px red thin;
+}
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/IndexBase.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/IndexBase.cs
new file mode 100644
index 0000000000..621f773201
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/IndexBase.cs
@@ -0,0 +1,209 @@
+using System.Collections.Generic;
+using System.Net;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Components;
+using Microsoft.AspNetCore.Components.Web;
+using PlanetaryDocs.Domain;
+using PlanetaryDocs.Services;
+
+namespace PlanetaryDocs.Pages
+{
+    /// <summary>
+    /// Code for the index component.
+    /// </summary>
+    public class IndexBase : ComponentBase
+    {
+        private bool navigatingToThisPage = true;
+        private bool searchQueued = false;
+
+        /// <summary>
+        /// Gets or sets a value indicating whether an asynchronous loading
+        /// operation is taking place.
+        /// </summary>
+        protected bool Loading { get; set; } = true;
+
+        /// <summary>
+        /// Gets or sets the alias to filter search.
+        /// </summary>
+        protected string Alias { get; set; } = string.Empty;
+
+        /// <summary>
+        /// Gets or sets the tag to filter search.
+        /// </summary>
+        protected string Tag { get; set; } = string.Empty;
+
+        /// <summary>
+        /// Gets or sets the text to filter search.
+        /// </summary>
+        protected string Text { get; set; } = string.Empty;
+
+        /// <summary>
+        /// Gets or sets the search results.
+        /// </summary>
+        protected List<DocumentSummary> DocsList { get; set; } = null;
+
+        /// <summary>
+        /// Gets or sets the reference to the text input element for focus.
+        /// </summary>
+        protected ElementReference InputElement { get; set; }
+
+        /// <summary>
+        /// Gets or sets the <see cref="NavigationManager"/>.
+        /// </summary>
+        [Inject]
+        protected NavigationManager NavigationService { get; set; }
+
+        /// <summary>
+        /// Gets or sets the <see cref="IDocumentService"/> implementation.
+        /// </summary>
+        [Inject]
+        protected IDocumentService DocumentService { get; set; }
+
+        /// <summary>
+        /// Gets or sets the loading service.
+        /// </summary>
+        [CascadingParameter]
+        protected LoadingService LoadingService { get; set; }
+
+        /// <summary>
+        /// Gets a value indicating whether there is enough information to
+        /// perform a search.
+        /// </summary>
+        protected bool CanSearch =>
+            !Loading && (
+                (!string.IsNullOrWhiteSpace(Text) &&
+                    Text.Trim().Length > 2)
+                || !string.IsNullOrWhiteSpace(Alias)
+                || !string.IsNullOrWhiteSpace(Tag));
+
+        /// <summary>
+        /// Handle parsing search values passed in via query string.
+        /// </summary>
+        /// <param name="firstRender">A value indicating whether this is the
+        /// first render.</param>
+        protected override void OnAfterRender(bool firstRender)
+        {
+            var stateHasChanged = false;
+
+            if (navigatingToThisPage)
+            {
+                Loading = false;
+                stateHasChanged = true;
+                var queryValues = NavigationHelper.GetQueryString(
+                    NavigationService.Uri);
+
+                var hasSearch = false;
+
+                foreach (var key in queryValues.Keys)
+                {
+                    switch (key)
+                    {
+                        case nameof(Text):
+                            Text = queryValues[key];
+                            hasSearch = true;
+                            break;
+                        case nameof(Alias):
+                            Alias = queryValues[key];
+                            hasSearch = true;
+                            break;
+                        case nameof(Tag):
+                            Tag = queryValues[key];
+                            hasSearch = true;
+                            break;
+                    }
+                }
+
+                navigatingToThisPage = false;
+                if (hasSearch)
+                {
+                    InvokeAsync(async () => await SearchAsync());
+                }
+            }
+
+            if (stateHasChanged)
+            {
+                StateHasChanged();
+            }
+
+            base.OnAfterRender(firstRender);
+        }
+
+        /// <summary>
+        /// Handle keyboad events, i.e. Enter key to submit.
+        /// </summary>
+        /// <param name="key">The key pressed event arguments.</param>
+        protected void HandleKeyPress(KeyboardEventArgs key)
+        {
+            if (key.Key == KeyNames.Enter)
+            {
+                InvokeAsync(SearchAsync);
+            }
+        }
+
+        /// <summary>
+        /// Search function.
+        /// </summary>
+        /// <returns>An asynchronous task.</returns>
+        protected async Task SearchAsync()
+        {
+            if (Loading)
+            {
+                searchQueued = true;
+                return;
+            }
+
+            searchQueued = false;
+
+            Alias = Alias.Trim();
+            Tag = Tag.Trim();
+            Text = Text.Trim();
+
+            if (CanSearch)
+            {
+                Loading = true;
+
+                do
+                {
+                    searchQueued = false;
+                    await LoadingService.WrapExecutionAsync(
+                        async () =>
+                    DocsList = await DocumentService.QueryDocumentsAsync(
+                        Text,
+                        Alias,
+                        Tag));
+                }
+                while (searchQueued);
+
+                Loading = false;
+            }
+            else
+            {
+                DocsList = null;
+            }
+
+            StateHasChanged();
+
+            var queryString =
+                NavigationHelper.CreateQueryString(
+                    (nameof(Text), WebUtility.UrlEncode(Text)),
+                    (nameof(Alias), WebUtility.UrlEncode(Alias)),
+                    (nameof(Tag), WebUtility.UrlEncode(Tag)));
+
+            navigatingToThisPage = false;
+            NavigationService.NavigateTo($"/?{queryString}");
+
+            await InputElement.FocusAsync();
+        }
+
+        /// <summary>
+        /// Navigate to view a particular uid.
+        /// </summary>
+        /// <param name="uid">The unique document identifier.</param>
+        protected void Navigate(string uid)
+        {
+            navigatingToThisPage = false;
+            NavigationService.NavigateTo(
+                NavigationHelper.ViewDocument(uid));
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/View.razor b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/View.razor
new file mode 100644
index 0000000000..2628ba633d
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/View.razor
@@ -0,0 +1,133 @@
+@page "/View/{Uid}"
+
+@inherits ViewBase 
+
+<div class="container">
+    <div class="row">
+        <div class="col-12">
+            @if (LoadingService.Loading)
+            {
+                <span class="oi oi-reload"></span><span>&nbsp;Loading...</span>
+            }
+        </div>
+    </div>
+    @if (NotFound)
+    {
+        <div class="row">
+            <div class="col-12">
+                <div class="alert alert-danger">
+                    <span class="oi oi-warning"></span>&nbsp;Document with id '@Uid' was not found.
+                    <a href="/">Click here</a> to return to search.
+                </div>
+            </div>
+        </div>
+    }
+    @if (!Loading && Document != null)
+    {
+        <div class="row">
+            @if (Audit)
+            {
+            <div class="col-12">
+                <h2>@Title</h2>
+            </div>
+            }
+            else
+            {
+                <div class="col-2">
+                    <a href="@NavigationHelper.EditDocument(Uid)"
+                       title="Edit"><span class="oi oi-pencil"></span>&nbsp;Edit</a>
+                </div>
+                <div class="col-10">
+                    <h2>@Title</h2>
+                </div>
+            }
+        </div>
+        @if (Audit)
+        {
+            <div class="row">
+                <div class="col-12">
+                    <div class="alert alert-info">
+                        You are viewing an archived version of this document.
+                        <button class="btn btn-link btn-sm" 
+                                @onclick="() => BackToMain()">Click here</button>
+                        to return to the current version.
+                    </div>
+                </div>
+            </div>
+        }
+        <div class="row">
+            <div class="col-2">
+                Author: @Document.AuthorAlias
+            </div>
+            <div class="col-2">
+                @if (DateTimeOffset.UtcNow.Ticks >
+                Document.PublishDate.Ticks)
+                {
+                    <span>Published: @Document.PublishDate</span>
+                }
+                else
+                {
+                    <span>Scheduled: @Document.PublishDate</span>
+                }
+            </div>
+            <div class="col-8">
+                Tags: @foreach (var tag in Document.Tags)
+                {
+                    <span>'@tag'&nbsp;</span>
+                }
+            </div>
+        </div>
+        <div class="row">
+            <div class="col-12 text-justify">
+                @Document.Description
+            </div>
+        </div>
+        <div class="row">
+            <div class="col-12">
+                @if (!ShowHistory && !Audit)
+                {
+                    <button class="btn btn-link"
+                            @onclick="() => ShowHistory=true">
+                        Show Audit History
+                    </button><span>&nbsp;</span>
+                }
+                <button class="btn btn-link"
+                        @onclick="() => { ShowMarkdown = !ShowMarkdown; ShowHistory = false; }">
+                    @ToggleText
+                </button>
+                @if (!ShowMarkdown)
+                {
+                    <span>&nbsp;</span>
+                    <button class="btn btn-link"
+                            @onclick="()=> { PreviewHtml = !PreviewHtml; ShowHistory = false; }">
+                        @PreviewText
+                    </button>
+                }
+            </div>
+        </div>
+        <div class="row">
+                @if (ShowHistory)
+                {
+                    <DocHistory Uid="@Document.Uid"/>
+                }
+                else if (ShowMarkdown)
+                {
+                    <div class="col-12 code">
+                        @Document.Markdown
+                    </div>
+                }
+                else if (PreviewHtml)
+                {
+                    <div class="col-12">
+                        <HtmlPreview Html="@Document.Html" />
+                    </div>
+                }
+                else
+                {
+                    <div class="col-12 code">
+                        @Document.Html
+                    </div>
+                }                
+        </div>
+    }
+</div>
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/View.razor.css b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/View.razor.css
new file mode 100644
index 0000000000..f4c052b9eb
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/View.razor.css
@@ -0,0 +1,10 @@
+.code {
+    padding-top: 1em;
+    white-space: pre;
+    height: 60vh;
+    color: green;
+    background: black;
+    font-family: Consolas, monospace;
+    width: 60vw;
+    overflow: scroll;
+}
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/ViewBase.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/ViewBase.cs
new file mode 100644
index 0000000000..f38311e605
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/ViewBase.cs
@@ -0,0 +1,160 @@
+using System;
+using System.Net;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Components;
+using PlanetaryDocs.Domain;
+using PlanetaryDocs.Services;
+
+namespace PlanetaryDocs.Pages
+{
+    /// <summary>
+    /// Code for the view component.
+    /// </summary>
+    public class ViewBase : ComponentBase
+    {
+        private string uid = string.Empty;
+
+        /// <summary>
+        /// Gets or sets the implementation of <see cref="IDocumentService"/>.
+        /// </summary>
+        [Inject]
+        public IDocumentService DocumentService { get; set; }
+
+        /// <summary>
+        /// Gets or sets the <see cref="LoadingService"/>.
+        /// </summary>
+        [CascadingParameter]
+        public LoadingService LoadingService { get; set; }
+
+        /// <summary>
+        /// Gets or sets the <see cref="NavigationManager"/>.
+        /// </summary>
+        [Inject]
+        public NavigationManager NavigationService { get; set; }
+
+        /// <summary>
+        /// Gets or sets the <see cref="TitleService"/>.
+        /// </summary>
+        [Inject]
+        public TitleService TitleService { get; set; }
+
+        /// <summary>
+        /// Gets or sets the unique identifier for the documnt.
+        /// </summary>
+        [Parameter]
+        public string Uid { get; set; }
+
+        /// <summary>
+        /// Gets or sets a value indicating whether to show the document history.
+        /// </summary>
+        protected bool ShowHistory { get; set; } = false;
+
+        /// <summary>
+        /// Gets or sets a value indicating whether to show the "Preview HTML" option.
+        /// </summary>
+        protected bool PreviewHtml { get; set; } = false;
+
+        /// <summary>
+        /// Gets or sets a value indicating whether to show the option to switch to Markdown.
+        /// </summary>
+        protected bool ShowMarkdown { get; set; } = true;
+
+        /// <summary>
+        /// Gets or sets a value indicating whether a loading operation is happening.
+        /// </summary>
+        protected bool Loading { get; set; } = true;
+
+        /// <summary>
+        /// Gets or sets a value indicating whether the document exists.
+        /// </summary>
+        protected bool NotFound { get; set; } = false;
+
+        /// <summary>
+        /// Gets or sets a value indicating whether to show recent audit history.
+        /// </summary>
+        protected bool Audit { get; set; } = false;
+
+        /// <summary>
+        /// Gets or sets the <see cref="Document"/> to view.
+        /// </summary>
+        protected Document Document { get; set; } = null;
+
+        /// <summary>
+        /// Gets the text to toggle between markdown and preiew or HTML.
+        /// </summary>
+        protected string ToggleText => ShowMarkdown ?
+            "Show HTML" : "Show Markdown";
+
+        /// <summary>
+        /// Gets the text to show preview text or rendered HTML.
+        /// </summary>
+        protected string PreviewText => PreviewHtml ?
+            "Show Source" : "Show Preview";
+
+        /// <summary>
+        /// Gets the title for the current item.
+        /// </summary>
+        protected string Title => Audit ? $"[ARCHIVE] {Document?.Title}"
+            : Document?.Title;
+
+        /// <summary>
+        /// Called when the <see cref="Document"/> identifier is set.
+        /// </summary>
+        /// <returns>An asynchronous task.</returns>
+        protected override async Task OnParametersSetAsync()
+        {
+            var newUid = WebUtility.UrlDecode(Uid);
+            if (newUid != uid)
+            {
+                var history = string.Empty;
+                var query = NavigationHelper.GetQueryString(
+                    NavigationService.Uri);
+                if (query.ContainsKey(nameof(history)))
+                {
+                    history = query[nameof(history)];
+                }
+
+                Loading = false;
+                NotFound = false;
+                uid = newUid;
+                try
+                {
+                    Loading = true;
+                    if (string.IsNullOrWhiteSpace(history))
+                    {
+                        await LoadingService.WrapExecutionAsync(
+                            async () => Document = await
+                                DocumentService.LoadDocumentAsync(uid));
+                        NotFound = Document == null;
+                        Audit = false;
+                    }
+                    else
+                    {
+                        await LoadingService.WrapExecutionAsync(
+                            async () => Document = await
+                                DocumentService.LoadDocumentSnapshotAsync(Guid.Parse(history), uid));
+                        Audit = true;
+                        NotFound = Document == null;
+                    }
+
+                    Loading = false;
+                    await TitleService.SetTitleAsync($"Viewing {Title}");
+                }
+                catch
+                {
+                    NotFound = true;
+                }
+            }
+
+            await base.OnParametersSetAsync();
+        }
+
+        /// <summary>
+        /// Go back to main version of the document.
+        /// </summary>
+        protected void BackToMain() =>
+            NavigationService.NavigateTo(
+                NavigationHelper.ViewDocument(Uid),
+                true);
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/_Host.cshtml b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/_Host.cshtml
new file mode 100644
index 0000000000..00e64660b6
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Pages/_Host.cshtml
@@ -0,0 +1,37 @@
+@page "/"
+@namespace PlanetaryDocs.Pages
+@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers
+@{
+    Layout = null;
+}
+
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Planetary Docs</title>
+    <base href="~/" />
+    <link rel="stylesheet" href="css/bootstrap/bootstrap.min.css" />
+    <link href="css/site.css" rel="stylesheet" />
+    <link href="PlanetaryDocs.styles.css" rel="stylesheet" />
+</head>
+<body>
+    <component type="typeof(App)" render-mode="ServerPrerendered" />
+
+    <div id="blazor-error-ui">
+        <environment include="Staging,Production">
+            An error has occurred. This application may no longer respond until reloaded.
+        </environment>
+        <environment include="Development">
+            An unhandled exception has occurred. See browser dev tools for details.
+        </environment>
+        <a href="" class="reload">Reload</a>
+        <a class="dismiss">🗙</a>
+    </div>
+
+    <script src="_framework/blazor.server.js"></script>
+    <script src="~/js/markdownExtensions.js"></script>
+    <script src="~/js/titleService.js"></script>
+</body>
+</html>
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/PlanetaryDocs.csproj b/samples/end2end/PlanetaryDocs/PlanetaryDocs/PlanetaryDocs.csproj
new file mode 100644
index 0000000000..02a90d1f23
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/PlanetaryDocs.csproj
@@ -0,0 +1,16 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <Description>Blazor Server application to demonstrate Create, Read, Update, and Delete (CRUD) for an Azure Cosmos DB database using Entity Framework Core.</Description>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Markdig" Version="0.24.0" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\PlanetaryDocs.DataAccess\PlanetaryDocs.DataAccess.csproj" />
+  </ItemGroup>
+  
+</Project>
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Program.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Program.cs
new file mode 100644
index 0000000000..6fd2d9af9c
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Program.cs
@@ -0,0 +1,27 @@
+using Microsoft.AspNetCore.Hosting;
+using Microsoft.Extensions.Hosting;
+
+namespace PlanetaryDocs
+{
+    /// <summary>
+    /// Main program.
+    /// </summary>
+    public static class Program
+    {
+        /// <summary>
+        /// Main method.
+        /// </summary>
+        /// <param name="args">Arguments passed in.</param>
+        public static void Main(string[] args) =>
+            CreateHostBuilder(args).Build().Run();
+
+        /// <summary>
+        /// Create the host builder for the app.
+        /// </summary>
+        /// <param name="args">Command line arguments.</param>
+        /// <returns>The <see cref="IHostBuilder"/> instance.</returns>
+        public static IHostBuilder CreateHostBuilder(string[] args) =>
+            Host.CreateDefaultBuilder(args)
+                .ConfigureWebHostDefaults(webBuilder => webBuilder.UseStartup<Startup>());
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Services/HistoryService.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Services/HistoryService.cs
new file mode 100644
index 0000000000..9c29a055e0
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Services/HistoryService.cs
@@ -0,0 +1,27 @@
+using System;
+using System.Threading.Tasks;
+using Microsoft.JSInterop;
+
+namespace PlanetaryDocs.Services
+{
+    /// <summary>
+    /// Service to handle back button.
+    /// </summary>
+    public class HistoryService
+    {
+        private readonly Func<ValueTask> goBack;
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="HistoryService"/> class.
+        /// </summary>
+        /// <param name="jsRuntime">The implementation of the JavaScript runtime.</param>
+        public HistoryService(IJSRuntime jsRuntime) =>
+            goBack = () => jsRuntime.InvokeVoidAsync("history.go", "-1");
+
+        /// <summary>
+        /// Exposes the go back function.
+        /// </summary>
+        /// <returns>An asynchronous task.</returns>
+        public ValueTask GoBackAsync() => goBack();
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Services/KeyNames.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Services/KeyNames.cs
new file mode 100644
index 0000000000..68406bb18b
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Services/KeyNames.cs
@@ -0,0 +1,23 @@
+namespace PlanetaryDocs.Services
+{
+    /// <summary>
+    /// Key names for input processing.
+    /// </summary>
+    public static class KeyNames
+    {
+        /// <summary>
+        /// Enter key.
+        /// </summary>
+        public const string Enter = nameof(Enter);
+
+        /// <summary>
+        /// Arrow down key.
+        /// </summary>
+        public const string ArrowDown = nameof(ArrowDown);
+
+        /// <summary>
+        /// Arrow up key.
+        /// </summary>
+        public const string ArrowUp = nameof(ArrowUp);
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Services/LoadingService.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Services/LoadingService.cs
new file mode 100644
index 0000000000..08afb4f2ae
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Services/LoadingService.cs
@@ -0,0 +1,126 @@
+using System;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace PlanetaryDocs.Services
+{
+    /// <summary>
+    /// App-wide loading service to keep track of asynchronous requests.
+    /// </summary>
+    public class LoadingService
+    {
+        private readonly Action noop = () => { };
+
+        private int asyncCount;
+
+        private Action stateChangedCallback = null;
+
+        /// <summary>
+        /// Gets or sets the callback to initiate a state change notification.
+        /// </summary>
+        public Action StateChangedCallback
+        {
+            get => stateChangedCallback ?? noop;
+            set
+            {
+                if (stateChangedCallback != null)
+                {
+                    throw new InvalidOperationException("Only one callback can be registered at the root level.");
+                }
+
+                stateChangedCallback = value;
+            }
+        }
+
+        /// <summary>
+        /// Gets a value indicating whether a loading operation is happening.
+        /// </summary>
+        public bool Loading => asyncCount > 0;
+
+        /// <summary>
+        /// Gets a value indicating whether the loading state changed based on
+        /// the most recent transition.
+        /// </summary>
+        public bool StateChanged { get; private set; } = false;
+
+        /// <summary>
+        /// Start of an asynchronous operation.
+        /// </summary>
+        public void AsyncBegin()
+        {
+            StateChanged = false;
+            Interlocked.Increment(ref asyncCount);
+            if (asyncCount == 1)
+            {
+                StateChanged = true;
+                StateChangedCallback();
+            }
+        }
+
+        /// <summary>
+        /// End of an asynchronous operation.
+        /// </summary>
+        public void AsyncEnd()
+        {
+            StateChanged = false;
+            Interlocked.Decrement(ref asyncCount);
+
+            if (asyncCount == 0)
+            {
+                StateChanged = true;
+                StateChangedCallback();
+            }
+        }
+
+        /// <summary>
+        /// Single API to increment loading status, run the asynchronous operation,
+        /// then decrement loading status.
+        /// </summary>
+        /// <param name="execution">The code to execute.</param>
+        /// <param name="stateChanged">The code to execute if the loading status changes.</param>
+        /// <remarks>The linear way to use the service looks like this:
+        /// <code><![CDATA[
+        ///     LoadingService.AsyncBegin();
+        ///     var result = await ThingToDoAsync();
+        ///     LoadingService.AsyncEnd();
+        /// ]]></code>
+        /// The non-linear (async op call) looks like:
+        /// <code><![CDATA[
+        ///     ResultType result;
+        ///     await LoadingService.WrapExecutionAsync(
+        ///         async () => {
+        ///            result = await ThingsToDoAsync();
+        ///         }
+        ///     });
+        /// ]]></code>
+        /// </remarks>
+        /// <returns>An asychronous task.</returns>
+        public async Task WrapExecutionAsync(
+            Func<Task> execution,
+            Func<Task> stateChanged = null)
+        {
+            AsyncBegin();
+            if (StateChanged && stateChanged != null)
+            {
+                await stateChanged();
+            }
+
+            try
+            {
+                await execution();
+            }
+            catch
+            {
+                throw;
+            }
+            finally
+            {
+                AsyncEnd();
+                if (StateChanged && stateChanged != null)
+                {
+                    await stateChanged();
+                }
+            }
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Services/MultiLineEditService.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Services/MultiLineEditService.cs
new file mode 100644
index 0000000000..648341bbd5
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Services/MultiLineEditService.cs
@@ -0,0 +1,87 @@
+using System;
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using Microsoft.JSInterop;
+using PlanetaryDocs.Shared;
+
+namespace PlanetaryDocs.Services
+{
+    /// <summary>
+    /// Service to handle multi line edit controls.
+    /// </summary>
+    /// <remarks>
+    /// Uses JavaScript interop to bypass SignalR restrictions on large fields.
+    /// The component registers and an id is tracked on the client. As the user
+    /// edits, the JavaScript calls back to the exposed static method to marshall
+    /// the data back.
+    /// </remarks>
+    public class MultiLineEditService
+    {
+        /// <summary>
+        /// Keeps track of services across all users.
+        /// </summary>
+        private static readonly Dictionary<string, MultiLineEditService> Services
+            = new ();
+
+        /// <summary>
+        /// Components for a specific user.
+        /// </summary>
+        private readonly Dictionary<string, MultiLineEditBase> components
+            = new ();
+
+        private readonly IJSRuntime jsRuntime = null;
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="MultiLineEditService"/> class.
+        /// </summary>
+        /// <param name="jsRuntime">The JavaScript runtime.</param>
+        public MultiLineEditService(IJSRuntime jsRuntime) =>
+            this.jsRuntime = jsRuntime;
+
+        /// <summary>
+        /// Update the text.
+        /// </summary>
+        /// <param name="id">The unique id.</param>
+        /// <param name="text">The text to update.</param>
+        /// <returns>The asynchronous task.</returns>
+        [JSInvokable]
+        public static async Task UpdateTextAsync(string id, string text)
+        {
+            var service = Services[id];
+            var component = service.components[id];
+            await component.OnUpdateTextAsync(text);
+        }
+
+        /// <summary>
+        /// Register the text to start the process.
+        /// </summary>
+        /// <param name="text">The text.</param>
+        /// <param name="component">The <see cref="MultiLineEdit"/> instance.</param>
+        /// <returns>A unique identifier.</returns>
+        public async Task<string> RegisterTextAsync(
+            string text,
+            MultiLineEditBase component)
+        {
+            var id = Guid.NewGuid().ToString();
+            await jsRuntime.InvokeVoidAsync(
+                "markdownExtensions.setText",
+                id,
+                text,
+                component.TextArea);
+            components.Add(id, component);
+            Services.Add(id, this);
+            return id;
+        }
+
+        /// <summary>
+        /// Unregister references.
+        /// </summary>
+        /// <param name="id">The id of the instance.</param>
+        public void Unregister(string id)
+        {
+            var service = Services[id];
+            Services.Remove(id);
+            service.components.Remove(id);
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Services/NavigationHelper.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Services/NavigationHelper.cs
new file mode 100644
index 0000000000..6e23a854de
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Services/NavigationHelper.cs
@@ -0,0 +1,80 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using Web = System.Net.WebUtility;
+
+namespace PlanetaryDocs.Services
+{
+    /// <summary>
+    /// Helper for creating navigation links.
+    /// </summary>
+    public static class NavigationHelper
+    {
+        /// <summary>
+        /// Link to view a document.
+        /// </summary>
+        /// <param name="uid">The unique identifier.</param>
+        /// <param name="auditId">The audit id.</param>
+        /// <returns>The view link.</returns>
+        public static string ViewDocument(
+            string uid,
+            Guid auditId = default) =>
+                auditId == default
+                ? $"/View/{Web.UrlEncode(uid)}"
+                : $"/View/{Web.UrlEncode(uid)}?history={Web.UrlEncode(auditId.ToString())}";
+
+        /// <summary>
+        /// Link to edit a document.
+        /// </summary>
+        /// <param name="uid">The unique identifier.</param>
+        /// <returns>The view link.</returns>
+        public static string EditDocument(string uid) =>
+            $"/Edit/{Web.UrlEncode(uid)}";
+
+        /// <summary>
+        /// Decomposes the query string.
+        /// </summary>
+        /// <param name="uri">The full uri.</param>
+        /// <returns>The query string values.</returns>
+        public static IDictionary<string, string> GetQueryString(string uri)
+        {
+            var pairs = new Dictionary<string, string>();
+
+            var queryString = uri.Split('?');
+
+            if (queryString.Length < 2)
+            {
+                return pairs;
+            }
+
+            var keyValuePairs = queryString[1].Split('&');
+
+            foreach (var keyValuePair in keyValuePairs)
+            {
+                if (keyValuePair.IndexOf('=') > 0)
+                {
+                    var pair = keyValuePair.Split('=');
+                    pairs.Add(pair[0], Web.UrlDecode(pair[1]));
+                }
+            }
+
+            return pairs;
+        }
+
+        /// <summary>
+        /// Create a query string from key value pairs.
+        /// </summary>
+        /// <param name="values">The values to use.</param>
+        /// <returns>The composed query string.</returns>
+        public static string CreateQueryString(
+            params (string key, string value)[] values)
+        {
+            var queryString =
+                string.Join(
+                    '&',
+                    values.Select(
+                        v => $"{v.key}={Web.UrlEncode(v.value)}"));
+            return queryString;
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Services/TitleService.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Services/TitleService.cs
new file mode 100644
index 0000000000..9da552ee91
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Services/TitleService.cs
@@ -0,0 +1,47 @@
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Components;
+using Microsoft.JSInterop;
+
+namespace PlanetaryDocs.Services
+{
+    /// <summary>
+    /// Service to set the browser title.
+    /// </summary>
+    public class TitleService
+    {
+        private const string DefaultTitle = "Planetary Docs";
+        private readonly NavigationManager navigationManager;
+        private readonly IJSRuntime jsRuntime;
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="TitleService"/> class.
+        /// </summary>
+        /// <param name="manager">The <see cref="NavigationManager"/>.</param>
+        /// <param name="jsRuntime">The JavaScript runtime.</param>
+        public TitleService(
+            NavigationManager manager,
+            IJSRuntime jsRuntime)
+        {
+            navigationManager = manager;
+            navigationManager.LocationChanged += async (o, e) =>
+                await SetTitleAsync(DefaultTitle);
+            this.jsRuntime = jsRuntime;
+        }
+
+        /// <summary>
+        /// Gets or sets the title.
+        /// </summary>
+        public string Title { get; set; }
+
+        /// <summary>
+        /// Main task to set the title.
+        /// </summary>
+        /// <param name="title">The title to use.</param>
+        /// <returns>An asynchronous task.</returns>
+        public async Task SetTitleAsync(string title)
+        {
+            Title = title;
+            await jsRuntime.InvokeVoidAsync("titleService.setTitle", title);
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/AliasSearch.razor b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/AliasSearch.razor
new file mode 100644
index 0000000000..5c968c4857
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/AliasSearch.razor
@@ -0,0 +1,8 @@
+@inherits AliasSearchBase
+
+<AutoComplete @ref="AutoComplete"
+              TabIndex="@TabIndex"
+              LabelText="Alias:" 
+              PlaceHolderText="Type the alias..."
+              @bind-SelectedValue="Alias"
+              SearchFn="SearchAsync"/>
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/AliasSearchBase.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/AliasSearchBase.cs
new file mode 100644
index 0000000000..252e662da8
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/AliasSearchBase.cs
@@ -0,0 +1,90 @@
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Components;
+using PlanetaryDocs.Domain;
+using PlanetaryDocs.Services;
+
+namespace PlanetaryDocs.Shared
+{
+    /// <summary>
+    /// Base code for the <see cref="AliasSearch"/> component.
+    /// </summary>
+    public class AliasSearchBase : ComponentBase
+    {
+        private string alias;
+
+        /// <summary>
+        /// Gets or sets the <see cref="LoadingService"/>.
+        /// </summary>
+        [CascadingParameter]
+        public LoadingService LoadingService { get; set; }
+
+        /// <summary>
+        /// Gets or sets the implementation of the <see cref="IDocumentService"/>.
+        /// </summary>
+        [Inject]
+        public IDocumentService DocumentService { get; set; }
+
+        /// <summary>
+        /// Gets or sets the tab index for keyboard navigation.
+        /// </summary>
+        [Parameter]
+        public string TabIndex { get; set; }
+
+        /// <summary>
+        /// Gets or sets the alias selected.
+        /// </summary>
+        [Parameter]
+        public string Alias
+        {
+            get => alias;
+            set
+            {
+                if (value != alias)
+                {
+                    alias = value;
+                    InvokeAsync(async () => await AliasChanged.InvokeAsync(alias));
+                }
+            }
+        }
+
+        /// <summary>
+        /// Gets or sets the callback to notify on alias selection changes.
+        /// </summary>
+        [Parameter]
+        public EventCallback<string> AliasChanged { get; set; }
+
+        /// <summary>
+        /// Gets or sets the reference to the child
+        /// <see cref="AutoComplete"/> component.
+        /// </summary>
+        protected AutoComplete AutoComplete { get; set; }
+
+        /// <summary>
+        /// Search alias based on the text passed in.
+        /// </summary>
+        /// <param name="searchText">The search text.</param>
+        /// <returns>The list of matching aliases.</returns>
+        public async Task<List<string>> SearchAsync(string searchText)
+        {
+            List<string> results = null;
+
+            if (string.IsNullOrWhiteSpace(searchText))
+            {
+                return results;
+            }
+
+            await LoadingService.WrapExecutionAsync(
+                async () => results =
+                await DocumentService.SearchAuthorsAsync(searchText));
+
+            return results;
+        }
+
+        /// <summary>
+        /// Method to set focus to component.
+        /// </summary>
+        /// <returns>The asynchronous task.</returns>
+        public async Task FocusAsync() => await AutoComplete.FocusAsync();
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/AutoComplete.razor b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/AutoComplete.razor
new file mode 100644
index 0000000000..6ab4f5bffc
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/AutoComplete.razor
@@ -0,0 +1,33 @@
+@inherits AutoCompleteBase
+
+<div @onkeydown="HandleKeyDown" @onkeydown:stopPropagation>
+
+    <span class="labelArea">@LabelText</span>
+
+    @if (Selected)
+    {
+        <a href="#" 
+            tabindex="@BaseIndex"
+            title="@SelectedValue - Click to change"
+            @onclick="async () => await SetSelectionAsync(string.Empty, true)"
+            @onclick:preventDefault>
+            @SelectedValue
+        </a>
+    }
+    else
+    {
+        <input tabindex="@BaseIndex"
+                @bind-value="Value"
+                @ref="InputElem"
+                @bind-value:event="oninput" 
+                placeholder="@PlaceHolderText" />
+    }
+
+    @if (!Selected && Values != null)
+    {
+        foreach (var result in Values)
+        {
+            <p tabindex="@GetIndex(result)" class="@GetClass(result)" @onclick="async ()=>await SetSelectionAsync(result)">@result</p>
+        }
+    }
+</div>
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/AutoComplete.razor.css b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/AutoComplete.razor.css
new file mode 100644
index 0000000000..5f19406994
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/AutoComplete.razor.css
@@ -0,0 +1,20 @@
+div {
+    display: inline-table;
+}
+
+p:hover, p.active {
+    font-weight: bold;
+    cursor: pointer;
+}
+
+.labelArea {
+    font-weight: bold;
+    text-align: right;
+    margin-right: 1em;
+    display: table-cell;
+}
+
+a, input {
+    width: 95%;
+    display: table-cell;
+}
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/AutoCompleteBase.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/AutoCompleteBase.cs
new file mode 100644
index 0000000000..ce1667302d
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/AutoCompleteBase.cs
@@ -0,0 +1,249 @@
+using System;
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Components;
+using Microsoft.AspNetCore.Components.Web;
+using PlanetaryDocs.Services;
+
+namespace PlanetaryDocs.Shared
+{
+    /// <summary>
+    /// Code for the <see cref="AutoComplete"/> component.
+    /// </summary>
+    public class AutoCompleteBase : ComponentBase
+    {
+        private int index = -1;
+        private bool loading = false;
+        private bool queued = false;
+        private string val = string.Empty;
+        private string tabIndex;
+
+        /// <summary>
+        /// Gets or sets the tab index.
+        /// </summary>
+        [Parameter]
+        public string TabIndex
+        {
+            get => tabIndex;
+            set
+            {
+                tabIndex = value;
+                if (int.TryParse(value, out var numIndex))
+                {
+                    BaseIndex = numIndex;
+                }
+            }
+        }
+
+        /// <summary>
+        /// Gets or sets the current search value.
+        /// </summary>
+        public string Value
+        {
+            get => val;
+            set
+            {
+                if (val != value)
+                {
+                    val = value;
+                    InvokeAsync(OnValueChangedAsync);
+                }
+            }
+        }
+
+        /// <summary>
+        /// Gets or sets the text to use as a label.
+        /// </summary>
+        [Parameter]
+        public string LabelText { get; set; } = string.Empty;
+
+        /// <summary>
+        /// Gets or sets the placeholder text to display.
+        /// </summary>
+        [Parameter]
+        public string PlaceHolderText { get; set; } = string.Empty;
+
+        /// <summary>
+        /// Gets or sets the value that is selected.
+        /// </summary>
+        [Parameter]
+        public string SelectedValue { get; set; }
+
+        /// <summary>
+        /// Gets or sets the callback invoked when the selected value changes.
+        /// </summary>
+        [Parameter]
+        public EventCallback<string> SelectedValueChanged { get; set; }
+
+        /// <summary>
+        /// Gets or sets the function to call to perform the search.
+        /// </summary>
+        [Parameter]
+        public Func<string, Task<List<string>>> SearchFn { get; set; }
+
+        /// <summary>
+        /// Gets or sets a reference to the child input element.
+        /// </summary>
+        protected ElementReference InputElem { get; set; }
+
+        /// <summary>
+        /// Gets or sets a value indicating whether or not an item has been selected.
+        /// </summary>
+        protected bool Selected { get; set; } = false;
+
+        /// <summary>
+        /// Gets the base index of the component.
+        /// </summary>
+        protected int BaseIndex { get; private set; }
+
+        /// <summary>
+        /// Gets or sets the list of possible values.
+        /// </summary>
+        protected List<string> Values { get; set; } = new ();
+
+        /// <summary>
+        /// Focus the control.
+        /// </summary>
+        /// <returns>The asynchronous task.</returns>
+        public async Task FocusAsync() => await InputElem.FocusAsync();
+
+        /// <summary>
+        /// Gets the CSS class to display for the item based on whether it is selected.
+        /// </summary>
+        /// <param name="item">The item to get the CSS class for.</param>
+        /// <returns>The class name.</returns>
+        protected string GetClass(string item) =>
+            index >= 0 && item == Values[index]
+            ? "active"
+            : string.Empty;
+
+        /// <summary>
+        /// Gets the tab index of the item.
+        /// </summary>
+        /// <param name="item">The item to compute the index for.</param>
+        /// <returns>The index as a string.</returns>
+        protected string GetIndex(string item) => Values.IndexOf(item) >= 0
+? (Values.IndexOf(item) + BaseIndex).ToString()
+: string.Empty;
+
+        /// <summary>
+        /// Called when parents have passed parameters down to child.
+        /// </summary>
+        /// <returns>Asynchronous task.</returns>
+        protected override async Task OnParametersSetAsync()
+        {
+            if (!string.IsNullOrWhiteSpace(SelectedValue))
+            {
+                await SetSelectionAsync(SelectedValue);
+            }
+
+            await base.OnParametersSetAsync();
+        }
+
+        /// <summary>
+        /// Handle keyboard navigation.
+        /// </summary>
+        /// <param name="e">The <see cref="KeyboardEventArgs"/>.</param>
+        protected void HandleKeyDown(KeyboardEventArgs e)
+        {
+            var maxIndex = Values != null ?
+                Values.Count - 1 : -1;
+
+            switch (e.Key)
+            {
+                case KeyNames.ArrowDown:
+                    if (index < maxIndex)
+                    {
+                        index++;
+                    }
+
+                    break;
+
+                case KeyNames.ArrowUp:
+                    if (index > 0)
+                    {
+                        index--;
+                    }
+
+                    break;
+
+                case KeyNames.Enter:
+                    if (Selected)
+                    {
+                        InvokeAsync(
+                            async () =>
+                            await SetSelectionAsync(string.Empty, true));
+                    }
+                    else if (index >= 0)
+                    {
+                        InvokeAsync(async () =>
+                        await SetSelectionAsync(Values[index]));
+                    }
+
+                    break;
+            }
+        }
+
+        /// <summary>
+        /// Called when the value changes.
+        /// </summary>
+        /// <returns>The asynchronous task.</returns>
+        protected async Task OnValueChangedAsync()
+        {
+            if (loading)
+            {
+                queued = true;
+                return;
+            }
+
+            loading = true;
+
+            do
+            {
+                queued = false;
+                Values = await SearchFn(val);
+            }
+            while (queued);
+            loading = false;
+            await SetSelectionAsync(string.Empty);
+            index = -1;
+            StateHasChanged();
+        }
+
+        /// <summary>
+        /// Called to set the selection.
+        /// </summary>
+        /// <param name="selection">The selection text.</param>
+        /// <param name="reset">A value indicating whether the selection should be reset.</param>
+        /// <returns>The asynchronous task.</returns>
+        protected async Task SetSelectionAsync(string selection, bool reset = false)
+        {
+            if (string.IsNullOrWhiteSpace(selection))
+            {
+                if (Selected)
+                {
+                    Selected = false;
+                    SelectedValue = string.Empty;
+                    await SelectedValueChanged.InvokeAsync(string.Empty);
+                    return;
+                }
+            }
+            else
+            {
+                Selected = true;
+                Values = null;
+                if (SelectedValue != selection)
+                {
+                    SelectedValue = selection;
+                    await SelectedValueChanged.InvokeAsync(selection);
+                }
+            }
+
+            if (reset)
+            {
+                Value = string.Empty;
+                await InputElem.FocusAsync();
+            }
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/DisabledNavLink.razor b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/DisabledNavLink.razor
new file mode 100644
index 0000000000..9a9c619203
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/DisabledNavLink.razor
@@ -0,0 +1,7 @@
+@inherits NavLink
+
+<a @attributes="@AdditionalAttributes" 
+   class="@CssClass" 
+   @onclick:preventDefault>
+    @ChildContent
+</a>
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/DisabledNavLink.razor.css b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/DisabledNavLink.razor.css
new file mode 100644
index 0000000000..555a804cf4
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/DisabledNavLink.razor.css
@@ -0,0 +1,3 @@
+a:hover {
+    cursor: not-allowed;
+}
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/DocHistory.razor b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/DocHistory.razor
new file mode 100644
index 0000000000..aa8bbf95c6
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/DocHistory.razor
@@ -0,0 +1,36 @@
+@inherits DocHistoryBase
+
+@if (History != null)
+{
+    <div class="container">
+        @if (History.Count == 0)
+        {
+            <div class="row">
+                <div class="col-12">
+                    <div class="alert alert-warning"><span class="oi oi-circle-x"></span>&nbsp;No audits found for the document.</div>
+                </div>
+            </div>
+        }
+        @if (History.Count > 0)
+        {
+            <div class="row">
+                <div class="col-12">
+                    <div class="alert alert-info"><span class="oi oi-circle-check"></span>&nbsp;@History.Count audit@(History.Count == 1 ? string.Empty : "s") found for the document.</div>
+                </div>
+            </div>
+            <div class="row">
+                <div class="col-3">Date Modified</div>
+                <div class="col-3">Alias</div>
+                <div class="col-6">Title</div>
+            </div>
+            @foreach (var item in History)
+            {
+                <div class="row summary" @onclick="() => Navigate(item)">
+                    <div class="col-3">@item.Timestamp</div>
+                    <div class="col-3">@item.Alias</div>
+                    <div class="col-3">@item.Title</div>
+                </div>
+            }
+        }
+    </div>
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/DocHistory.razor.css b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/DocHistory.razor.css
new file mode 100644
index 0000000000..b5e6f6919d
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/DocHistory.razor.css
@@ -0,0 +1,4 @@
+.summary:hover {
+    cursor: pointer;
+    background-color: lightgray;
+}
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/DocHistoryBase.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/DocHistoryBase.cs
new file mode 100644
index 0000000000..bf08014175
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/DocHistoryBase.cs
@@ -0,0 +1,72 @@
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Components;
+using PlanetaryDocs.Domain;
+using PlanetaryDocs.Services;
+
+namespace PlanetaryDocs.Shared
+{
+    /// <summary>
+    /// Code for the <see cref="DocHistory"/> component.
+    /// </summary>
+    public class DocHistoryBase : ComponentBase
+    {
+        private string lastUid = string.Empty;
+
+        /// <summary>
+        /// Gets or sets the <see cref="LoadingService"/>.
+        /// </summary>
+        [CascadingParameter]
+        public LoadingService LoadingService { get; set; }
+
+        /// <summary>
+        /// Gets or sets the implementation of <see cref="IDocumentService"/>.
+        /// </summary>
+        [Inject]
+        public IDocumentService DocumentService { get; set; }
+
+        /// <summary>
+        /// Gets or sets the <see cref="NavigationManager"/>.
+        /// </summary>
+        [Inject]
+        public NavigationManager NavigationService { get; set; }
+
+        /// <summary>
+        /// Gets or sets the unique identifier of the <see cref="Document"/> to get history for.
+        /// </summary>
+        [Parameter]
+        public string Uid { get; set; }
+
+        /// <summary>
+        /// Gets or sets the list of audit items that show the history of
+        /// the <see cref="Document"/>.
+        /// </summary>
+        protected List<DocumentAuditSummary> History { get; set; } = null;
+
+        /// <summary>
+        /// Called when parameters change.
+        /// </summary>
+        /// <returns>The asynchronous test.</returns>
+        protected override async Task OnParametersSetAsync()
+        {
+            if (Uid != lastUid)
+            {
+                lastUid = Uid;
+                await LoadingService.WrapExecutionAsync(
+                    async () =>
+                        History =
+                        await DocumentService.LoadDocumentHistoryAsync(lastUid));
+            }
+
+            await base.OnParametersSetAsync();
+        }
+
+        /// <summary>
+        /// Navigate to a specific audit entry.
+        /// </summary>
+        /// <param name="audit">The <see cref="DocumentAuditSummary"/>.</param>
+        protected void Navigate(DocumentAuditSummary audit) =>
+            NavigationService.NavigateTo(
+            NavigationHelper.ViewDocument(audit.Uid, audit.Id), true);
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/EditBar.razor b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/EditBar.razor
new file mode 100644
index 0000000000..e146278360
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/EditBar.razor
@@ -0,0 +1,29 @@
+@inherits EditBarBase
+
+<div class="row">
+    <div class="col">
+        <button disabled="@(!IsValid || !IsDirty)"
+                tabindex="2"
+                @onclick="async () => await SaveAsync()"
+                class="btn btn-sm btn-success">
+            <span class="oi oi-cloud-upload"></span>&nbsp;Save
+        </button>
+        <span class="text-sm-left">&nbsp;(@ChangeCount changes detected)&nbsp;</span>
+        <button tabindex="3"
+                disabled="@(!IsDirty)" class="btn btn-sm btn-warning"
+                @onclick="() => Reset()">
+            <span class="oi oi-reload"></span>&nbsp;Reset
+        </button>
+        <span>&nbsp;</span>
+        <button tabindex="4"
+                class="btn btn-danger btn-sm"
+                @onclick="() => Cancel()">
+            <span class="oi oi-x"></span>&nbsp;Cancel
+        </button>
+    </div>
+</div>
+<div class="row">
+    <div class="col">
+        &nbsp;
+    </div>
+</div> 
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/EditBarBase.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/EditBarBase.cs
new file mode 100644
index 0000000000..e06d34928e
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/EditBarBase.cs
@@ -0,0 +1,64 @@
+using System;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Components;
+using PlanetaryDocs.Services;
+
+namespace PlanetaryDocs.Shared
+{
+    /// <summary>
+    /// Code for the <see cref="EditBar"/> component.
+    /// </summary>
+    public class EditBarBase : ComponentBase
+    {
+        /// <summary>
+        /// Gets or sets the <see cref="NavigationService"/>.
+        /// </summary>
+        [Inject]
+        public NavigationManager NavigationService { get; set; }
+
+        /// <summary>
+        /// Gets or sets the <see cref="HistoryService"/>.
+        /// </summary>
+        [Inject]
+        public HistoryService HistoryService { get; set; }
+
+        /// <summary>
+        /// Gets or sets a value indicating whether the document
+        /// has been modified.
+        /// </summary>
+        [Parameter]
+        public bool IsDirty { get; set; }
+
+        /// <summary>
+        /// Gets or sets a value indicating whether the document is in a valid
+        /// state to update or insert.
+        /// </summary>
+        [Parameter]
+        public bool IsValid { get; set; }
+
+        /// <summary>
+        /// Gets or sets the count of changes that are detected.
+        /// </summary>
+        [Parameter]
+        public int ChangeCount { get; set; }
+
+        /// <summary>
+        /// Gets or sets the method to call to commit (save) changes.
+        /// </summary>
+        [Parameter]
+        public Func<Task> SaveAsync { get; set; }
+
+        /// <summary>
+        /// Reset method returns to pre-edited state.
+        /// </summary>
+        protected void Reset() => NavigationService.NavigateTo(
+NavigationService.Uri,
+true);
+
+        /// <summary>
+        /// Cancel goes back to previous page.
+        /// </summary>
+        protected void Cancel() => InvokeAsync(async () =>
+                     await HistoryService.GoBackAsync());
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/Editor.razor b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/Editor.razor
new file mode 100644
index 0000000000..f2913d0bd7
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/Editor.razor
@@ -0,0 +1,134 @@
+@inherits EditorBase
+
+@if (DocumentToEdit != null)
+{
+    <div class="container">
+        <div class="row">
+            @if (Insert)
+            {
+                <div class="alert alert-info">
+                    <span class="oi oi-plus"></span>&nbsp;Adding a new document.
+                </div>
+            }
+            else
+            {
+                <div class="alert alert-info">
+                    <span class="oi oi-pencil"></span>&nbsp;Editing the document with id '@DocumentToEdit.Uid'.
+                </div>
+            }
+        </div>
+        @if (ValidationStates.Any(vr => !vr.IsValid))
+        {
+            <div class="row">
+                <div class="col-12">
+                    <ul>
+                        @foreach (var vr in ValidationStates.Where
+(v => !v.IsValid))
+                        {
+                            <li><span class="oi oi-warning"></span>&nbsp;@vr.Message</li>
+                        }
+                    </ul>
+                </div>
+            </div>
+        }
+        @if (Insert)
+        {
+            <div class="row">
+                <div class="col-12 text-left">
+                    Unique ID:
+                </div>
+            </div>
+            <div class="row">
+                <div class="col-12">
+                    <ValidatedInput AutoFocus="@Insert"
+                                    TabIndex="10"
+                                    PlaceHolder="Enter the document id"
+                                    @bind-Value="@Uid"
+                                    @bind-Validation="@UidValidation"
+                                    Validate="value => ValidationRules.ValidateProperty(nameof(Document.Uid), value)" />
+                </div>
+            </div>
+        }
+        <div class="row">
+            <div class="col-12 field-label">
+                Title:
+            </div>
+        </div>
+        <div class="row">
+            <div class="col-12">
+                <ValidatedInput AutoFocus="@(!Insert)"
+                                TabIndex="20"
+                                PlaceHolder="Enter the document title"
+                                @bind-Value="@Title"
+                                @bind-Validation="@TitleValidation"
+                                Validate="value => ValidationRules.ValidateProperty(nameof(Document.Title), value)" />
+            </div>
+        </div>
+        <div class="row">
+            <div class="col-12">
+                @if (ExistingAlias)
+                {
+                    <AliasSearch @ref="AliasSearch"
+                                 TabIndex="30"
+                                 @bind-Alias="@Alias" />
+                }
+                else
+                {
+                    <span>Enter new alias:&nbsp;</span>
+                    <ValidatedInput @ref="NewAliasInput"
+                                    TabIndex="30"
+                                    PlaceHolder="Enter the alias"
+                                    @bind-Value="@Alias"
+                                    @bind-Validation="@AliasValidation"
+                                    Validate="value => ValidationRules.ValidateProperty(nameof(Document.AuthorAlias), value)" />
+                }
+                <a href="#"
+                   tabindex="50"
+                   @onclick="async () => await ToggleAliasAsync()"
+                   @onclick:preventDefault>
+                    @AliasButton
+                </a>&nbsp;
+            </div>
+        </div>
+        <div class="row">
+            <div class="col-12">
+                <span class="field-label">Choose tags:</span>&nbsp;
+                <TagPicker TabIndex="100" @bind-Tags="@TagList" />
+            </div>
+        </div>
+        <div class="row">
+            <div class="col-12 field-label">
+                Description:
+            </div>
+        </div>
+        <div class="row">
+            <div class="col-12">
+                <ValidatedInput PlaceHolder="Enter the description"
+                                TabIndex="200"
+                                @bind-Value="@Description"
+                                @bind-Validation="@DescriptionValidation"
+                                Validate="value => ValidationRules.ValidateProperty(nameof(Document.Description), value)" />
+            </div>
+        </div>
+        <div class="row">
+            <div class="col-5 field-label">
+                Markdown:
+            </div>
+            <div class="col-6 field-label">
+                Preview:&nbsp;
+                <button class="btn btn-link btn-sm"
+                        @onclick="() => MarkdownPreview()">
+                    <span class="oi oi-reload"></span>&nbsp;Refresh preview
+                </button>
+            </div>
+        </div>
+        <div class="row">
+            <div class="col-5">
+                <MultiLineEdit TabIndex="300" @bind-Text="@Markdown" />
+            </div>
+            <div class="col-6">
+                <HtmlPreview @ref="Preview" IsEdit="true" Html="@Html" />
+            </div>
+        </div>
+    </div>
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/Editor.razor.css b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/Editor.razor.css
new file mode 100644
index 0000000000..b0472d3dfe
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/Editor.razor.css
@@ -0,0 +1,10 @@
+li {
+    font-weight: bold;
+    color: darkred;
+}
+
+.field-label {
+    font-weight: bold;
+    margin-left: 1em;
+    color: #202020;
+}
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/EditorBase.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/EditorBase.cs
new file mode 100644
index 0000000000..e6b55bef32
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/EditorBase.cs
@@ -0,0 +1,507 @@
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Components;
+using PlanetaryDocs.Domain;
+using PlanetaryDocs.Services;
+
+namespace PlanetaryDocs.Shared
+{
+    /// <summary>
+    /// Code for <see cref="Editor"/> component.
+    /// </summary>
+    public class EditorBase : ComponentBase
+    {
+        private int changeCount;
+
+        private bool ignoreParameterSet = false;
+
+        private ValidationState aliasValidation =
+                    ValidationRules.ValidResult();
+
+        private ValidationState uidValidation =
+            ValidationRules.ValidResult();
+
+        private ValidationState titleValidation =
+            ValidationRules.ValidResult();
+
+        private ValidationState descriptionValidation =
+            ValidationRules.ValidResult();
+
+        private ValidationState markdownValidation =
+            ValidationRules.ValidResult();
+
+        /// <summary>
+        /// Determines which element to set the focus for.
+        /// </summary>
+        protected enum FocusElement
+        {
+            /// <summary>
+            /// No focus.
+            /// </summary>
+            None,
+
+            /// <summary>
+            /// Focus alias.
+            /// </summary>
+            Alias,
+
+            /// <summary>
+            /// Focus tag.
+            /// </summary>
+            Tag,
+        }
+
+        /// <summary>
+        /// Gets or sets the <see cref="IDocumentService"/> implementation.
+        /// </summary>
+        [Inject]
+        public IDocumentService DocumentService { get; set; }
+
+        /// <summary>
+        /// Gets or sets the <see cref="LoadingService"/>.
+        /// </summary>
+        [CascadingParameter]
+        public LoadingService LoadingService { get; set; }
+
+        /// <summary>
+        /// Gets or sets the <see cref="Document"/> to manipulate.
+        /// </summary>
+        [Parameter]
+        public Document DocumentToEdit { get; set; }
+
+        /// <summary>
+        /// Gets or sets a value indicating whether the mode is edit or insert.
+        /// </summary>
+        [Parameter]
+        public bool Insert { get; set; }
+
+        /// <summary>
+        /// Gets or sets a value indicating whether the <see cref="Document"/> is
+        /// ready and valid to insert or update.
+        /// </summary>
+        [Parameter]
+        public bool IsValid { get; set; }
+
+        /// <summary>
+        /// Gets or sets the change notification for <see cref="IsValid"/>.
+        /// </summary>
+        [Parameter]
+        public EventCallback<bool> IsValidChanged { get; set; }
+
+        /// <summary>
+        /// Gets or sets the count of detected changes.
+        /// </summary>
+        [Parameter]
+        public int ChangeCount
+        {
+            get => changeCount;
+            set
+            {
+                if (value != changeCount)
+                {
+                    changeCount = value;
+                    InvokeAsync(async () => await ChangeCountChanged.InvokeAsync(changeCount));
+                }
+            }
+        }
+
+        /// <summary>
+        /// Gets or sets the change notification for <see cref="ChangeCount"/>.
+        /// </summary>
+        [Parameter]
+        public EventCallback<int> ChangeCountChanged { get; set; }
+
+        /// <summary>
+        /// Gets or sets the focus setting.
+        /// </summary>
+        protected FocusElement ElementToFocus { get; set; } = FocusElement.None;
+
+        /// <summary>
+        /// Gets or sets the <see cref="HtmlPreview"/> child element.
+        /// </summary>
+        protected HtmlPreview Preview { get; set; }
+
+        /// <summary>
+        /// Gets or sets the child <see cref="AliasSearch"/> component.
+        /// </summary>
+        protected AliasSearch AliasSearch { get; set; }
+
+        /// <summary>
+        /// Gets or sets a value indicating whether to show the existing alias
+        /// dialog.
+        /// </summary>
+        protected bool ExistingAlias { get; set; } = true;
+
+        /// <summary>
+        /// Gets or sets the <see cref="ValidatedInput"/> component for the
+        /// new alias input.
+        /// </summary>
+        protected ValidatedInput NewAliasInput { get; set; }
+
+        /// <summary>
+        /// Gets or sets the list of tags.
+        /// </summary>
+        protected List<string> TagList
+        {
+            get => DocumentToEdit.Tags;
+            set
+            {
+                DocumentToEdit.Tags.Clear();
+                DocumentToEdit.Tags.AddRange(value);
+                ChangeCount++;
+                StateHasChanged();
+            }
+        }
+
+        /// <summary>
+        /// Gets or sets the title of the <see cref="Document"/>.
+        /// </summary>
+        protected string Title
+        {
+            get => DocumentToEdit.Title;
+            set
+            {
+                if (value != DocumentToEdit.Title)
+                {
+                    DocumentToEdit.Title = value;
+                    ChangeCount++;
+                }
+            }
+        }
+
+        /// <summary>
+        /// Gets or sets the unique identifier for the <see cref="Document"/>.
+        /// </summary>
+        protected string Uid
+        {
+            get => DocumentToEdit.Uid;
+            set
+            {
+                if (value != DocumentToEdit.Uid)
+                {
+                    DocumentToEdit.Uid = value;
+                    ChangeCount++;
+                }
+            }
+        }
+
+        /// <summary>
+        /// Gets or sets the <see cref="Document"/> description.
+        /// </summary>
+        protected string Description
+        {
+            get => DocumentToEdit.Description;
+            set
+            {
+                if (value != DocumentToEdit.Description)
+                {
+                    DocumentToEdit.Description = value;
+                    ChangeCount++;
+                }
+            }
+        }
+
+        /// <summary>
+        /// Gets the list of validation states.
+        /// </summary>
+        protected List<ValidationState> ValidationStates { get; } =
+            new List<ValidationState>();
+
+        /// <summary>
+        /// Gets or sets the markdown value.
+        /// </summary>
+        protected string Markdown
+        {
+            get => DocumentToEdit.Markdown;
+            set
+            {
+                if (value != DocumentToEdit.Markdown)
+                {
+                    DocumentToEdit.Markdown = value;
+                    MarkdownUpdated();
+                }
+            }
+        }
+
+        /// <summary>
+        /// Gets or sets the <see cref="Document"/> alias.
+        /// </summary>
+        protected string Alias
+        {
+            get => DocumentToEdit.AuthorAlias;
+            set
+            {
+                if (value != DocumentToEdit.AuthorAlias)
+                {
+                    DocumentToEdit.AuthorAlias = value;
+                    ChangeCount++;
+                    InvokeAsync(ValidateAliasAsync);
+                }
+            }
+        }
+
+        /// <summary>
+        /// Gets or sets the <see cref="ValidationState"/> for <see cref="Title"/>.
+        /// </summary>
+        protected ValidationState TitleValidation
+        {
+            get => titleValidation;
+            set
+            {
+                titleValidation = value;
+                OnValidationChange();
+            }
+        }
+
+        /// <summary>
+        /// Gets or sets the <see cref="ValidationState"/> for <see cref="Uid"/>.
+        /// </summary>
+        protected ValidationState UidValidation
+        {
+            get => uidValidation;
+            set
+            {
+                uidValidation = value;
+                OnValidationChange();
+            }
+        }
+
+        /// <summary>
+        /// Gets or sets the <see cref="ValidationState"/> for <see cref="Markdown"/>.
+        /// </summary>
+        protected ValidationState MarkdownValidation
+        {
+            get => markdownValidation;
+            set
+            {
+                markdownValidation = value;
+                OnValidationChange();
+            }
+        }
+
+        /// <summary>
+        /// Gets or sets the <see cref="ValidationState"/> for <see cref="Description"/>.
+        /// </summary>
+        protected ValidationState DescriptionValidation
+        {
+            get => descriptionValidation;
+            set
+            {
+                descriptionValidation = value;
+                OnValidationChange();
+            }
+        }
+
+        /// <summary>
+        /// Gets or sets the <see cref="ValidationState"/> for <see cref="Alias"/>.
+        /// </summary>
+        protected ValidationState AliasValidation
+        {
+            get => aliasValidation;
+            set
+            {
+                aliasValidation = value;
+                OnValidationChange();
+            }
+        }
+
+        /// <summary>
+        /// Gets a value to display on the alias toggle.
+        /// </summary>
+        protected string AliasButton => ExistingAlias ? "Add New Alias"
+            : "Choose Existing Alias";
+
+        /// <summary>
+        /// Gets or sets the HTML rendered from the <see cref="Markdown"/>.
+        /// </summary>
+        protected string Html { get; set; }
+
+        /// <summary>
+        /// Validate everything prior to committing.
+        /// </summary>
+        /// <param name="document">The version of the <see cref="Document"/> to validate.</param>
+        /// <returns>A value indicating whether the document is valid.</returns>
+        public bool ValidateAll(Document document)
+        {
+            var results = ValidationRules.ValidateDocument(document);
+            var isValid = results.All(r => r.IsValid);
+            if (isValid != IsValid)
+            {
+                ValidationStates.Clear();
+                ValidationStates.AddRange(results.Where(r => !r.IsValid));
+                ignoreParameterSet = true;
+                OnValidationChange(false);
+            }
+
+            return isValid;
+        }
+
+        /// <summary>
+        /// Calle when parameters are set.
+        /// </summary>
+        protected override void OnParametersSet()
+        {
+            if (ignoreParameterSet)
+            {
+                ignoreParameterSet = false;
+                return;
+            }
+
+            Html = DocumentToEdit.Html;
+            OnValidationChange();
+
+            base.OnParametersSet();
+        }
+
+        /// <summary>
+        /// Called after render.
+        /// </summary>
+        /// <param name="firstRender">A value indicating whether this is the first render.</param>
+        /// <returns>An asynchronous task.</returns>
+        protected override async Task OnAfterRenderAsync(bool firstRender)
+        {
+            if (ElementToFocus == FocusElement.Alias)
+            {
+                if (ExistingAlias)
+                {
+                    await AliasSearch.FocusAsync();
+                }
+                else
+                {
+                    await NewAliasInput.FocusAsync();
+                }
+
+                ElementToFocus = FocusElement.None;
+            }
+
+            await base.OnAfterRenderAsync(firstRender);
+        }
+
+        /// <summary>
+        /// Handle changes to validation state.
+        /// </summary>
+        /// <param name="resetList">A value indicating whether to rebuild the list of validations.</param>
+        protected void OnValidationChange(bool resetList = true)
+        {
+            if (resetList)
+            {
+                ValidationStates.Clear();
+                ValidationStates.AddRange(
+                    new[]
+                    {
+                titleValidation,
+                aliasValidation,
+                descriptionValidation,
+                markdownValidation,
+                    });
+
+                if (Insert)
+                {
+                    ValidationStates.Add(uidValidation);
+                }
+            }
+
+            var isValid = ValidationStates.All(vr => vr.IsValid);
+
+            if (isValid != IsValid)
+            {
+                IsValid = isValid;
+                InvokeAsync(
+                    async () =>
+                    await IsValidChanged.InvokeAsync(isValid));
+            }
+        }
+
+        /// <summary>
+        /// Toggle the alias mode between choose existing and add new.
+        /// </summary>
+        /// <returns>An asynchronous task.</returns>
+        protected async Task ToggleAliasAsync()
+        {
+            DocumentToEdit.AuthorAlias = string.Empty;
+            ExistingAlias = !ExistingAlias;
+            ElementToFocus = FocusElement.Alias;
+            await ValidateAliasAsync();
+        }
+
+        /// <summary>
+        /// Validates the alis value.
+        /// </summary>
+        /// <returns>An asynchronous task.</returns>
+        protected async Task ValidateAliasAsync()
+        {
+            aliasValidation = ValidationRules.ValidateProperty(
+                nameof(Document.AuthorAlias),
+                ExistingAlias ? Alias : DocumentToEdit.AuthorAlias);
+
+            if (!ExistingAlias && aliasValidation.IsValid)
+            {
+                var aliasToCheck = DocumentToEdit.AuthorAlias;
+                List<string> aliases = null;
+
+                await LoadingService.WrapExecutionAsync(
+                    async () =>
+                        aliases = await DocumentService.SearchAuthorsAsync(
+                    aliasToCheck));
+                if (aliases.Any(a => a == aliasToCheck))
+                {
+                    aliasValidation = new ValidationState
+                    {
+                        IsValid = false,
+                        Message = $"Alias '{aliasToCheck}' already exists.",
+                    };
+                }
+            }
+
+            OnValidationChange();
+        }
+
+        /// <summary>
+        /// Handle updates to <see cref="Markdown"/>.
+        /// </summary>
+        protected void MarkdownUpdated()
+        {
+            ChangeCount++;
+
+            var checkRequired = ValidationRules.ValidateProperty(
+                nameof(DocumentToEdit.Markdown), DocumentToEdit.Markdown);
+
+            if (checkRequired.IsValid)
+            {
+                MarkdownValidation = ValidationRules.InvalidResult(
+                        "Markdown has changed. Preview before saving.");
+            }
+            else if (markdownValidation.IsValid != checkRequired.IsValid ||
+                    markdownValidation.Message != checkRequired.Message)
+            {
+                MarkdownValidation = checkRequired;
+            }
+
+            OnValidationChange();
+        }
+
+        /// <summary>
+        /// Generate the HTML from markdown.
+        /// </summary>
+        protected void MarkdownPreview()
+        {
+            if (string.IsNullOrWhiteSpace(Markdown))
+            {
+                Html = string.Empty;
+                DocumentToEdit.Html = string.Empty;
+                InvokeAsync(Preview.OnUpdateAsync);
+                return;
+            }
+
+            Html = Markdig.Markdown.ToHtml(DocumentToEdit.Markdown);
+            DocumentToEdit.Html = Html;
+
+            InvokeAsync(Preview.OnUpdateAsync);
+
+            MarkdownValidation = ValidationRules.ValidResult();
+
+            OnValidationChange();
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/HtmlPreview.razor b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/HtmlPreview.razor
new file mode 100644
index 0000000000..eeab49f37c
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/HtmlPreview.razor
@@ -0,0 +1,5 @@
+@inherits HtmlPreviewBase
+
+<div class="@WebClass">
+    @HtmlToRender
+</div>
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/HtmlPreview.razor.css b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/HtmlPreview.razor.css
new file mode 100644
index 0000000000..2de3f1afde
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/HtmlPreview.razor.css
@@ -0,0 +1,18 @@
+.web {
+    padding: 0.5em;
+    height: 60vh;
+    background-color: lightgray;
+    font-size: 0.8em;
+    width: 60vw;
+    overflow: scroll;
+}
+
+.webedit {
+    padding: 0.5em;
+    height: 40vh;
+    background-color: lightgray;
+    font-size: 0.8em;
+    width: 30vw;
+    overflow: scroll;
+}
+
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/HtmlPreviewBase.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/HtmlPreviewBase.cs
new file mode 100644
index 0000000000..8ddcaebd25
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/HtmlPreviewBase.cs
@@ -0,0 +1,81 @@
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Components;
+
+namespace PlanetaryDocs.Shared
+{
+    /// <summary>
+    /// Code for the HTML preview component.
+    /// </summary>
+    public class HtmlPreviewBase : ComponentBase
+    {
+        private bool rendered;
+        private string html;
+
+        /// <summary>
+        /// Gets or sets a value indicating whether the preview is shown in an
+        /// edit context.
+        /// </summary>
+        [Parameter]
+        public bool IsEdit { get; set; }
+
+        /// <summary>
+        /// Gets or sets the HTML to preview.
+        /// </summary>
+        [Parameter]
+        public string Html
+        {
+            get => html;
+            set
+            {
+                if (value != html)
+                {
+                    html = value;
+                    HtmlToRender = new MarkupString(html);
+                }
+            }
+        }
+
+        /// <summary>
+        /// Gets the HTML to render.
+        /// </summary>
+        protected MarkupString HtmlToRender { get; private set; }
+
+        /// <summary>
+        /// Gets the CSS class to use based on the mode.
+        /// </summary>
+        protected string WebClass => IsEdit ? "webedit" : "web";
+
+        /// <summary>
+        /// Method to update the preview.
+        /// </summary>
+        /// <remarks>
+        /// This component uses a "trick" to render HTML by inserting it into a
+        /// <c>textarea</c> element then moving the value over. The code is in
+        /// <c>wwwroot/js/markdownExtensions.js</c>.
+        /// </remarks>
+        /// <returns>The asynchronous task.</returns>
+        public async Task OnUpdateAsync()
+        {
+            if (rendered)
+            {
+                await InvokeAsync(() => HtmlToRender = new MarkupString(Html));
+            }
+        }
+
+        /// <summary>
+        /// Called after rendering.
+        /// </summary>
+        /// <param name="firstRender">A value indicating whether it is the first render.</param>
+        /// <returns>The asynchronous task.</returns>
+        protected override async Task OnAfterRenderAsync(bool firstRender)
+        {
+            if (firstRender)
+            {
+                rendered = true;
+                await OnUpdateAsync();
+            }
+
+            await base.OnAfterRenderAsync(firstRender);
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/Loading.razor b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/Loading.razor
new file mode 100644
index 0000000000..8b6ecb17b0
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/Loading.razor
@@ -0,0 +1,7 @@
+<div class="row">
+    <div class="col-12">
+        <div class="alert alert-info">
+            📀 Parsing the bits...
+        </div>
+    </div>
+</div>
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/MainLayout.razor b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/MainLayout.razor
new file mode 100644
index 0000000000..b05013fd0e
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/MainLayout.razor
@@ -0,0 +1,27 @@
+@inject LoadingService LoadingService
+
+@inherits LayoutComponentBase
+
+<div class="page">
+    <div class="sidebar">
+        <NavMenu />
+    </div>
+
+    <div class="main">
+        <CascadingValue Value="LoadingService" 
+                        IsFixed="true" 
+                        TValue="LoadingService">
+            <div class="content px-4">
+                @Body
+            </div>
+        </CascadingValue>
+    </div>
+</div>
+
+@code { 
+    protected override void OnInitialized()
+    {
+        LoadingService.StateChangedCallback = StateHasChanged;
+        base.OnInitialized();
+    }
+}
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/MainLayout.razor.css b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/MainLayout.razor.css
new file mode 100644
index 0000000000..43c355a47a
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/MainLayout.razor.css
@@ -0,0 +1,70 @@
+.page {
+    position: relative;
+    display: flex;
+    flex-direction: column;
+}
+
+.main {
+    flex: 1;
+}
+
+.sidebar {
+    background-image: linear-gradient(180deg, rgb(5, 39, 103) 0%, #3a0647 70%);
+}
+
+.top-row {
+    background-color: #f7f7f7;
+    border-bottom: 1px solid #d6d5d5;
+    justify-content: flex-end;
+    height: 3.5rem;
+    display: flex;
+    align-items: center;
+}
+
+    .top-row ::deep a, .top-row .btn-link {
+        white-space: nowrap;
+        margin-left: 1.5rem;
+    }
+
+    .top-row a:first-child {
+        overflow: hidden;
+        text-overflow: ellipsis;
+    }
+
+@media (max-width: 640.98px) {
+    .top-row:not(.auth) {
+        display: none;
+    }
+
+    .top-row.auth {
+        justify-content: space-between;
+    }
+
+    .top-row a, .top-row .btn-link {
+        margin-left: 0;
+    }
+}
+
+@media (min-width: 641px) {
+    .page {
+        flex-direction: row;
+    }
+
+    .sidebar {
+        width: 250px;
+        height: 100vh;
+        position: sticky;
+        top: 0;
+    }
+
+    .top-row {
+        position: sticky;
+        top: 0;
+        z-index: 1;
+    }
+
+    .main > div {
+        padding-left: 2rem !important;
+        padding-right: 1.5rem !important;
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/MultiLineEdit.razor b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/MultiLineEdit.razor
new file mode 100644
index 0000000000..91e8be033a
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/MultiLineEdit.razor
@@ -0,0 +1,7 @@
+@inherits MultiLineEditBase
+
+<textarea @ref="TextArea"
+          tabindex="@TabIndex"
+          rows="10"
+          cols="40">
+</textarea>
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/MultiLineEditBase.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/MultiLineEditBase.cs
new file mode 100644
index 0000000000..b377030ec7
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/MultiLineEditBase.cs
@@ -0,0 +1,90 @@
+using System;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Components;
+using PlanetaryDocs.Services;
+
+namespace PlanetaryDocs.Shared
+{
+    /// <summary>
+    /// Code for the <see cref="MultiLineEdit"/> component.
+    /// </summary>
+    /// <remarks>
+    /// This component enables editing of extremely large fields by bypassing the
+    /// SignalR communication and using JavaScript interop to marshall values.
+    /// </remarks>
+    public class MultiLineEditBase : ComponentBase, IDisposable
+    {
+        private string id;
+
+        /// <summary>
+        /// Gets or sets the <see cref="MultiLineEditService"/>.
+        /// </summary>
+        [Inject]
+        public MultiLineEditService EditService { get; set; }
+
+        /// <summary>
+        /// Gets or sets the tab index.
+        /// </summary>
+        [Parameter]
+        public string TabIndex { get; set; }
+
+        /// <summary>
+        /// Gets or sets the reference to the text area used for editing.
+        /// </summary>
+        public ElementReference TextArea { get; set; }
+
+        /// <summary>
+        /// Gets or sets the text to edit.
+        /// </summary>
+        [Parameter]
+        public string Text { get; set; }
+
+        /// <summary>
+        /// Gets or sets the callback to notify on text changed.
+        /// </summary>
+        [Parameter]
+        public EventCallback<string> TextChanged { get; set; }
+
+        /// <summary>
+        /// Implement dispose to remove references.
+        /// </summary>
+        public void Dispose()
+        {
+            if (!string.IsNullOrWhiteSpace(id))
+            {
+                EditService.Unregister(id);
+                id = string.Empty;
+            }
+
+            GC.SuppressFinalize(this);
+        }
+
+        /// <summary>
+        /// Called to update the text from JavaScript.
+        /// </summary>
+        /// <param name="text">The text to update.</param>
+        /// <returns>The asynchronous task.</returns>
+        public async Task OnUpdateTextAsync(string text)
+        {
+            Text = text;
+            await TextChanged.InvokeAsync(text);
+        }
+
+        /// <summary>
+        /// After rendering, hook up the interop.
+        /// </summary>
+        /// <param name="firstRender">A value indicating whether it is the first render.</param>
+        /// <returns>The asynchronous task.</returns>
+        protected override async Task OnAfterRenderAsync(bool firstRender)
+        {
+            if (firstRender)
+            {
+                id = await EditService.RegisterTextAsync(
+                    Text,
+                    this);
+            }
+
+            await base.OnAfterRenderAsync(firstRender);
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/NavMenu.razor b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/NavMenu.razor
new file mode 100644
index 0000000000..7e6f661bdd
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/NavMenu.razor
@@ -0,0 +1,44 @@
+@inherits NavMenuBase
+
+<div class="top-row pl-4 navbar navbar-dark">
+    <a class="navbar-brand" href="">
+        <span class="oi oi-globe"></span>
+        <span class="oi oi-document"></span>
+        Planetary Docs
+    </a>
+    <button class="navbar-toggler" @onclick="ToggleNavMenu">
+        <span class="navbar-toggler-icon"></span>
+    </button>
+    <br />
+</div>
+
+<div class="@NavMenuCssClass" @onclick="ToggleNavMenu">
+    <ul class="nav flex-column">
+        @foreach (var navItem in NavItems)
+        {
+            <li @key="navItem.Text" class="nav-item px-3">
+                @if (!navItem.Disabled)
+                {
+                    <NavLink class="nav-link"
+                             href="@navItem.Href"
+                             Match="@navItem.Match">
+                        <span class="oi oi-@navItem.Icon"
+                              aria-hidden="true"></span>&nbsp;@navItem.Text
+                    </NavLink>
+                }
+                else
+                {
+                    <DisabledNavLink class="nav-link"
+                                        href="@navItem.Href"
+                                        Match="@navItem.Match">
+                        <span class="oi oi-@navItem.Icon" aria-hidden="true"></span>&nbsp;@navItem.Text
+                    </DisabledNavLink>
+                }
+            </li>
+        }
+    </ul>
+</div>
+
+<div class="version">
+    version: @Version
+</div>
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/NavMenu.razor.css b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/NavMenu.razor.css
new file mode 100644
index 0000000000..af4705f74d
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/NavMenu.razor.css
@@ -0,0 +1,68 @@
+.navbar-toggler {
+    background-color: rgba(255, 255, 255, 0.1);
+}
+
+.top-row {
+    height: 3.5rem;
+    background-color: rgba(0,0,0,0.4);
+}
+
+.navbar-brand {
+    font-size: 1.1rem;
+}
+
+.oi {
+    width: 2rem;
+    font-size: 1.1rem;
+    vertical-align: text-top;
+    top: -2px;
+}
+
+.nav-item {
+    font-size: 0.9rem;
+    padding-bottom: 0.5rem;
+}
+
+    .nav-item:first-of-type {
+        padding-top: 1rem;
+    }
+
+    .nav-item:last-of-type {
+        padding-bottom: 1rem;
+    }
+
+    .nav-item ::deep a {
+        color: #d7d7d7;
+        border-radius: 4px;
+        height: 3rem;
+        display: flex;
+        align-items: center;
+        line-height: 3rem;
+    }
+
+.nav-item ::deep a.active {
+    background-color: rgba(255,255,255,0.25);
+    color: white;
+}
+
+.nav-item ::deep a:hover {
+    background-color: rgba(255,255,255,0.1);
+    color: white;
+}
+
+@media (min-width: 400px) {
+    .navbar-toggler {
+        display: none;
+    }
+
+    .collapse {
+        /* Never collapse the sidebar for wide screens */
+        display: block;
+    }
+}
+
+.version {
+    font-size: 0.7em;
+    color: white;
+    text-align: center;
+}
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/NavMenuBase.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/NavMenuBase.cs
new file mode 100644
index 0000000000..906e1390ea
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/NavMenuBase.cs
@@ -0,0 +1,98 @@
+using Microsoft.AspNetCore.Components;
+using Microsoft.AspNetCore.Components.Routing;
+
+namespace PlanetaryDocs.Shared
+{
+    /// <summary>
+    /// Code for navigation component.
+    /// </summary>
+    public class NavMenuBase : ComponentBase
+    {
+        /// <summary>
+        /// Gets the list of navigation items.
+        /// </summary>
+        protected NavItem[] NavItems
+        { get; } = new[]
+            {
+                new NavItem
+                {
+                    Disabled = false,
+                    Text = "Home",
+                    Icon = "home",
+                    Href = string.Empty,
+                    Match = NavLinkMatch.All,
+                },
+                new NavItem { Disabled = true, Text = "View", Icon = "eye", Href = "/View" },
+                new NavItem { Disabled = false, Text = "Add New", Icon = "plus", Href = "/Add" },
+                new NavItem { Disabled = true, Text = "Edit", Icon = "pencil", Href = "/Edit" },
+            };
+
+        /// <summary>
+        /// Gets or sets a value indicating whether the menu should be collapsed.
+        /// </summary>
+        protected bool CollapseNavMenu { get; set; } = true;
+
+        /// <summary>
+        /// Gets or sets the version.
+        /// </summary>
+        protected string Version { get; set; } = "?";
+
+        /// <summary>
+        /// Gets the CSS class to apply to the menu based on whether or not it is
+        /// collapsed.
+        /// </summary>
+        protected string NavMenuCssClass => CollapseNavMenu ? "collapse" : null;
+
+        /// <summary>
+        /// Toggles the display of the menu.
+        /// </summary>
+        protected void ToggleNavMenu() => CollapseNavMenu = !CollapseNavMenu;
+
+        /// <summary>
+        /// Code to set version on initialization.
+        /// </summary>
+        protected override void OnInitialized()
+        {
+            if (Version == "?")
+            {
+                Version = System.Diagnostics.FileVersionInfo.GetVersionInfo(
+                    GetType().Assembly.Location).ProductVersion;
+            }
+
+            base.OnInitialized();
+        }
+
+        /// <summary>
+        /// Navigation item.
+        /// </summary>
+        protected class NavItem
+        {
+            /// <summary>
+            /// Gets or sets a value indicating whether using this item as navigation
+            /// is disabled.
+            /// </summary>
+            public bool Disabled { get; set; }
+
+            /// <summary>
+            /// Gets or sets the text to display for the navigation item.
+            /// </summary>
+            public string Text { get; set; }
+
+            /// <summary>
+            /// Gets or sets the icon to show.
+            /// </summary>
+            public string Icon { get; set; }
+
+            /// <summary>
+            /// Gets or sets the path to the target.
+            /// </summary>
+            public string Href { get; set; }
+
+            /// <summary>
+            /// Gets or sets a value indicating whether the highlight logic should
+            /// match based on the prefix of the current URL or the full URL.
+            /// </summary>
+            public NavLinkMatch Match { get; set; } = NavLinkMatch.Prefix;
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/Saving.razor b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/Saving.razor
new file mode 100644
index 0000000000..cc1873fdc7
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/Saving.razor
@@ -0,0 +1,7 @@
+<div class="row">
+    <div class="col-12">
+        <div class="alert alert-info">
+            📀 Pushing bits to the cosmos...
+        </div>
+    </div>
+</div>
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/TagPicker.razor b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/TagPicker.razor
new file mode 100644
index 0000000000..9be0286381
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/TagPicker.razor
@@ -0,0 +1,45 @@
+@inherits TagPickerBase
+
+@if (Tags != null && Tags.Count > 0)
+{
+    foreach (var tag in Tags)
+    {
+        <span>
+            "@tag" [<a href="#"
+                       title="Remove"
+                       tabindex="@(IndexForTag(tag))"
+                       @onclick="async () => await RemoveAsync(tag)"
+                       @onclick:preventDefault>x</a>]
+            &nbsp;
+        </span>
+    }
+}
+@if (PickNew)
+{
+    <TagSearch TabIndex="@(AltTabIndex.ToString())"
+               @bind-Tag="@NewTag" />
+}
+else
+{
+    <a href="#"
+       tabindex="@AltTabIndex"
+       @onclick="() => PickNew = true"
+       @onclick:preventDefault>Pick Existing</a>
+}
+&nbsp;
+<input type="text" placeholder="Enter new tag"
+       tabindex="@(AltTabIndex + 1)"
+       @bind-value="AddTag"
+       @bind-value:event="oninput" />[
+@if (string.IsNullOrWhiteSpace(AddTag))
+{
+    <span>&nbsp;</span>
+}
+else
+{
+    <a href="#"
+       tabindex="@(AltTabIndex + 2)"
+       title="Add Tag"
+       @onclick="() => NewTag = AddTag"
+       @onclick:preventDefault>+</a>
+}]
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/TagPickerBase.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/TagPickerBase.cs
new file mode 100644
index 0000000000..29e3e4d14f
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/TagPickerBase.cs
@@ -0,0 +1,97 @@
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Components;
+
+namespace PlanetaryDocs.Shared
+{
+    /// <summary>
+    /// Code for the <see cref="TagPicker"/> component.
+    /// </summary>
+    public class TagPickerBase : ComponentBase
+    {
+        private string newTag;
+
+        /// <summary>
+        /// Gets or sets the list of tags to choose from.
+        /// </summary>
+        [Parameter]
+        public List<string> Tags { get; set; }
+
+        /// <summary>
+        /// Gets or sets the callback to notify when tags change.
+        /// </summary>
+        [Parameter]
+        public EventCallback<List<string>> TagsChanged { get; set; }
+
+        /// <summary>
+        /// Gets or sets the tab index.
+        /// </summary>
+        [Parameter]
+        public string TabIndex { get; set; }
+
+        /// <summary>
+        /// Gets or sets the new tag.
+        /// </summary>
+        public string NewTag
+        {
+            get => newTag;
+            set
+            {
+                if (!string.IsNullOrWhiteSpace(value) &&
+                    !Tags.Contains(value))
+                {
+                    Tags.Add(value);
+                    newTag = string.Empty;
+                    AddTag = string.Empty;
+                    PickNew = false;
+                    InvokeAsync(async () => await TagsChanged.InvokeAsync(
+                        Tags.ToList()));
+                }
+            }
+        }
+
+        /// <summary>
+        /// Gets or sets a value indicating whether the user is picking
+        /// a new tag.
+        /// </summary>
+        protected bool PickNew { get; set; } = false;
+
+        /// <summary>
+        /// Gets or sets the name of a new tag to add.
+        /// </summary>
+        protected string AddTag { get; set; } = string.Empty;
+
+        /// <summary>
+        /// Gets the base index for tabs.
+        /// </summary>
+        protected int BaseIndex =>
+            int.TryParse(TabIndex, out var idx) ? idx :
+            100;
+
+        /// <summary>
+        /// Gets the tab index after the tag list.
+        /// </summary>
+        protected int AltTabIndex =>
+            BaseIndex + Tags.Count;
+
+        /// <summary>
+        /// Handles removing a tag from the list.
+        /// </summary>
+        /// <param name="tag">The tag to remove.</param>
+        /// <returns>An asynchronous task.</returns>
+        public async Task RemoveAsync(string tag)
+        {
+            Tags.Remove(tag);
+            await TagsChanged.InvokeAsync(Tags.ToList());
+        }
+
+        /// <summary>
+        /// Gets the tab index for a tag.
+        /// </summary>
+        /// <param name="tag">The tag to index.</param>
+        /// <returns>The tab index.</returns>
+        protected int IndexForTag(string tag) =>
+            BaseIndex + Tags.IndexOf(tag) + 1;
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/TagSearch.razor b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/TagSearch.razor
new file mode 100644
index 0000000000..056a16bace
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/TagSearch.razor
@@ -0,0 +1,7 @@
+@inherits TagSearchBase
+
+<AutoComplete TabIndex="@TabIndex"
+              LabelText="Tag:" 
+              PlaceHolderText="Type the tag..."
+              @bind-SelectedValue="Tag"
+              SearchFn="SearchAsync" />
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/TagSearchBase.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/TagSearchBase.cs
new file mode 100644
index 0000000000..3895be7c6b
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/TagSearchBase.cs
@@ -0,0 +1,80 @@
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Components;
+using PlanetaryDocs.Domain;
+using PlanetaryDocs.Services;
+
+namespace PlanetaryDocs.Shared
+{
+    /// <summary>
+    /// Code for the <see cref="TagSearch"/> component.
+    /// </summary>
+    public class TagSearchBase : ComponentBase
+    {
+        private string tag;
+
+        /// <summary>
+        /// Gets or sets the implementation of <see cref="IDocumentService"/>.
+        /// </summary>
+        [Inject]
+        public IDocumentService DocumentService { get; set; }
+
+        /// <summary>
+        /// Gets or sets the <see cref="LoadingService"/>.
+        /// </summary>
+        [CascadingParameter]
+        public LoadingService LoadingService { get; set; }
+
+        /// <summary>
+        /// Gets or sets the tab index.
+        /// </summary>
+        [Parameter]
+        public string TabIndex { get; set; }
+
+        /// <summary>
+        /// Gets or sets the selected tag.
+        /// </summary>
+        [Parameter]
+        public string Tag
+        {
+            get => tag;
+            set
+            {
+                if (value != tag)
+                {
+                    tag = value;
+                    InvokeAsync(
+                        async () =>
+                            await TagChanged.InvokeAsync(tag));
+                }
+            }
+        }
+
+        /// <summary>
+        /// Gets or sets the callback to notify on tag changes.
+        /// </summary>
+        [Parameter]
+        public EventCallback<string> TagChanged { get; set; }
+
+        /// <summary>
+        /// Call the search and obtain results.
+        /// </summary>
+        /// <param name="searchText">The text to search.</param>
+        /// <returns>The list of results.</returns>
+        public async Task<List<string>> SearchAsync(string searchText)
+        {
+            List<string> results = null;
+
+            if (string.IsNullOrWhiteSpace(searchText))
+            {
+                return results;
+            }
+
+            await LoadingService.WrapExecutionAsync(
+                async () => results =
+                await DocumentService.SearchTagsAsync(searchText));
+
+            return results;
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/ValidatedInput.razor b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/ValidatedInput.razor
new file mode 100644
index 0000000000..403fff5193
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/ValidatedInput.razor
@@ -0,0 +1,36 @@
+@inherits ValidatedInputBase
+
+<div class="container">
+    <div class="row">
+        <div class="col-12">
+            @if (UseTextArea)
+            {
+                <textarea @ref="TextAreaControl"
+                          tabindex="@TabIndex"
+                          class="@Error"
+                          rows="10"
+                          cols="40"
+                          @bind-value="@InnerValue"
+                          @bind-value:event="oninput">
+                </textarea>
+            }
+            else
+            {
+                <input @ref="InputControl"
+                       tabindex="@TabIndex"
+                       class="@Error"
+                       type="text"
+                       @bind-value="@InnerValue"
+                       @bind-value:event="oninput" />
+            }
+        </div>
+    </div>
+    @if (Validation != null && Validation.IsValid == false)
+    {
+        <div class="row">
+            <div class="col-12">
+                <p>@Validation.Message</p>
+            </div>
+        </div>
+    }
+</div>
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/ValidatedInput.razor.css b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/ValidatedInput.razor.css
new file mode 100644
index 0000000000..ce2c4e7393
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/ValidatedInput.razor.css
@@ -0,0 +1,9 @@
+.error {
+    border: solid 1px red;
+    background-color: lightcoral;
+}
+
+input {
+    width: 100%;
+    padding: 0.3em;
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/ValidatedInputBase.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/ValidatedInputBase.cs
new file mode 100644
index 0000000000..547244a9fb
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Shared/ValidatedInputBase.cs
@@ -0,0 +1,174 @@
+using System;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Components;
+using PlanetaryDocs.Domain;
+
+namespace PlanetaryDocs.Shared
+{
+    /// <summary>
+    /// Code for <see cref="ValidatedInput"/> component.
+    /// </summary>
+    public class ValidatedInputBase : ComponentBase
+    {
+        private bool focused = false;
+        private string innerValue = string.Empty;
+        private ValidationState validationState;
+
+        /// <summary>
+        /// Gets or sets the placeholder text.
+        /// </summary>
+        [Parameter]
+        public string PlaceHolder { get; set; }
+
+        /// <summary>
+        /// Gets or sets the external value for data-binding.
+        /// </summary>
+        [Parameter]
+        public string Value { get; set; }
+
+        /// <summary>
+        /// Gets or sets the callback used to notify on value changes.
+        /// </summary>
+        [Parameter]
+        public EventCallback<string> ValueChanged { get; set; }
+
+        /// <summary>
+        /// Gets or sets a value indicating whether the input
+        /// should take focus on errors.
+        /// </summary>
+        [Parameter]
+        public bool AutoFocus { get; set; }
+
+        /// <summary>
+        /// Gets or sets the method used to validate the input.
+        /// </summary>
+        [Parameter]
+        public Func<string, ValidationState> Validate { get; set; }
+
+        /// <summary>
+        /// Gets or sets the state of the validation.
+        /// </summary>
+        [Parameter]
+        public ValidationState Validation { get; set; }
+
+        /// <summary>
+        /// Gets or sets the callback to notify when the
+        /// validation status changes.
+        /// </summary>
+        [Parameter]
+        public EventCallback<ValidationState> ValidationChanged { get; set; }
+
+        /// <summary>
+        /// Gets or sets a value indicating whether to use
+        /// a <c>textarea</c> instead of an <c>input</c>.
+        /// </summary>
+        [Parameter]
+        public bool UseTextArea { get; set; }
+
+        /// <summary>
+        /// Gets or sets the tab index.
+        /// </summary>
+        [Parameter]
+        public string TabIndex { get; set; } = "0";
+
+        /// <summary>
+        /// Gets or sets the reference to the <c>textarea</c> element.
+        /// </summary>
+        protected ElementReference TextAreaControl { get; set; }
+
+        /// <summary>
+        /// Gets or sets the reference to the <c>input</c> element.
+        /// </summary>
+        protected ElementReference InputControl { get; set; }
+
+        /// <summary>
+        /// Gets the active control based on the value of
+        /// <see cref="UseTextArea"/>.
+        /// </summary>
+        protected ElementReference ActiveControl =>
+            UseTextArea ? TextAreaControl : InputControl;
+
+        /// <summary>
+        /// Gets the class to apply for errors.
+        /// </summary>
+        protected string Error =>
+            Validation != null && Validation.IsValid == false
+            ? "error" : string.Empty;
+
+        /// <summary>
+        /// Gets or sets the internally tracked value.
+        /// </summary>
+        protected string InnerValue
+        {
+            get => innerValue;
+            set
+            {
+                if (value != innerValue)
+                {
+                    innerValue = value;
+                    Value = innerValue;
+                    InvokeAsync(async () =>
+                        await ValueChanged.InvokeAsync(Value));
+                    OnValidate();
+                }
+            }
+        }
+
+        /// <summary>
+        /// Called when validation is needed.
+        /// </summary>
+        public void OnValidate()
+        {
+            validationState = Validate(innerValue);
+
+            if (Validation == null ||
+                validationState.IsValid != Validation.IsValid ||
+                validationState.Message != Validation.Message)
+            {
+                Validation = validationState;
+                InvokeAsync(async () =>
+                    await ValidationChanged.InvokeAsync(Validation));
+            }
+
+            if (!validationState.IsValid && AutoFocus)
+            {
+                InvokeAsync(
+                    async () =>
+                        await ActiveControl.FocusAsync());
+            }
+        }
+
+        /// <summary>
+        /// Method to focus the control.
+        /// </summary>
+        /// <returns>An asynchronous task.</returns>
+        public async Task FocusAsync() => await ActiveControl.FocusAsync();
+
+        /// <summary>
+        /// Called when the value is initially set.
+        /// </summary>
+        protected override void OnParametersSet()
+        {
+            validationState = null;
+            innerValue = Value;
+            OnValidate();
+            base.OnParametersSet();
+        }
+
+        /// <summary>
+        /// Called after render.
+        /// </summary>
+        /// <param name="firstRender">A value indicating whether the call is in context of the first render.</param>
+        /// <returns>An asynchronous task.</returns>
+        protected override async Task OnAfterRenderAsync(bool firstRender)
+        {
+            if (AutoFocus && !focused)
+            {
+                focused = true;
+                await ActiveControl.FocusAsync();
+            }
+
+            await base.OnAfterRenderAsync(firstRender);
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/Startup.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Startup.cs
new file mode 100644
index 0000000000..06e42d6238
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/Startup.cs
@@ -0,0 +1,107 @@
+using System;
+using Microsoft.AspNetCore.Builder;
+using Microsoft.AspNetCore.Hosting;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+using Microsoft.Extensions.Options;
+using PlanetaryDocs.DataAccess;
+using PlanetaryDocs.Domain;
+using PlanetaryDocs.Services;
+
+namespace PlanetaryDocs
+{
+    /// <summary>
+    /// Blazor startup.
+    /// </summary>
+    public class Startup
+    {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="Startup"/> class.
+        /// </summary>
+        /// <param name="configuration">The configuration information.</param>
+        public Startup(IConfiguration configuration) => Configuration = configuration;
+
+        /// <summary>
+        /// Gets t configuration instance.
+        /// </summary>
+        public IConfiguration Configuration { get; }
+
+        /// <summary>
+        /// Select the services used by your app.
+        /// </summary>
+        /// <param name="services">The service collection.</param>
+        public void ConfigureServices(IServiceCollection services)
+        {
+            services.AddRazorPages();
+            services.AddServerSideBlazor();
+            services.Configure<CosmosSettings>(
+                Configuration.GetSection(nameof(CosmosSettings)));
+            services.AddDbContextFactory<DocsContext>(
+               (IServiceProvider sp, DbContextOptionsBuilder opts) =>
+               {
+                   var cosmosSettings = sp
+                       .GetRequiredService<IOptions<CosmosSettings>>()
+                       .Value;
+
+                   opts.UseCosmos(
+                       cosmosSettings.EndPoint,
+                       cosmosSettings.AccessKey,
+                       nameof(DocsContext));
+               });
+
+            services.AddScoped<IDocumentService, DocumentService>();
+            services.AddScoped<LoadingService>();
+            services.AddScoped<HistoryService>();
+            services.AddScoped<TitleService>();
+            services.AddScoped<MultiLineEditService>();
+        }
+
+        /// <summary>
+        /// Configure the selected services.
+        /// </summary>
+        /// <param name="app">The app builder.</param>
+        /// <param name="env">The current environment.</param>
+        /// <param name="factory">Context factory.</param>
+        /// <param name="cs">The Cosmos settings.</param>
+        public void Configure(
+            IApplicationBuilder app,
+            IWebHostEnvironment env,
+            IDbContextFactory<DocsContext> factory,
+            IOptions<CosmosSettings> cs)
+        {
+            if (env.IsDevelopment())
+            {
+                app.UseDeveloperExceptionPage();
+            }
+            else
+            {
+                app.UseExceptionHandler("/Error");
+
+                // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
+                app.UseHsts();
+            }
+
+            if (cs.Value.EnableMigration)
+            {
+                using var context = factory.CreateDbContext();
+                context.CheckAndMigrateTagsAsync(cs.Value.DocumentToCheck).
+                    ConfigureAwait(true)
+                    .GetAwaiter()
+                    .GetResult();
+            }
+
+            app.UseHttpsRedirection();
+            app.UseStaticFiles();
+
+            app.UseRouting();
+
+            app.UseEndpoints(endpoints =>
+            {
+                endpoints.MapBlazorHub();
+                endpoints.MapFallbackToPage("/_Host");
+            });
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/_Imports.razor b/samples/end2end/PlanetaryDocs/PlanetaryDocs/_Imports.razor
new file mode 100644
index 0000000000..01308ef438
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/_Imports.razor
@@ -0,0 +1,12 @@
+@using System.Net.Http
+@using Microsoft.AspNetCore.Authorization
+@using Microsoft.AspNetCore.Components.Authorization
+@using Microsoft.AspNetCore.Components.Forms
+@using Microsoft.AspNetCore.Components.Routing
+@using Microsoft.AspNetCore.Components.Web
+@using Microsoft.AspNetCore.Components.Web.Virtualization
+@using Microsoft.JSInterop
+@using PlanetaryDocs
+@using PlanetaryDocs.Services
+@using PlanetaryDocs.Shared
+@using PlanetaryDocs.Domain 
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/appsettings.Development.json b/samples/end2end/PlanetaryDocs/PlanetaryDocs/appsettings.Development.json
new file mode 100644
index 0000000000..51737579ef
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/appsettings.Development.json
@@ -0,0 +1,10 @@
+{
+  "DetailedErrors": true,
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft": "Warning",
+      "Microsoft.Hosting.Lifetime": "Information"
+    }
+  }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/appsettings.json b/samples/end2end/PlanetaryDocs/PlanetaryDocs/appsettings.json
new file mode 100644
index 0000000000..8c7f070ceb
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/appsettings.json
@@ -0,0 +1,16 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft": "Warning",
+      "Microsoft.Hosting.Lifetime": "Information"
+    }
+  },
+  "AllowedHosts": "*",
+  "CosmosSettings": {
+    "EndPoint": "https://localhost:8081/",
+    "AccessKey": "C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==",
+    "EnableMigration": true,
+    "DocumentToCheck": "web-api_index"
+  }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/bootstrap/bootstrap.min.css b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/bootstrap/bootstrap.min.css
new file mode 100644
index 0000000000..92e3fe8712
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/bootstrap/bootstrap.min.css
@@ -0,0 +1,7 @@
+/*!
+ * Bootstrap v4.3.1 (https://getbootstrap.com/)
+ * Copyright 2011-2019 The Bootstrap Authors
+ * Copyright 2011-2019 Twitter, Inc.
+ * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)
+ */:root{--blue:#007bff;--indigo:#6610f2;--purple:#6f42c1;--pink:#e83e8c;--red:#dc3545;--orange:#fd7e14;--yellow:#ffc107;--green:#28a745;--teal:#20c997;--cyan:#17a2b8;--white:#fff;--gray:#6c757d;--gray-dark:#343a40;--primary:#007bff;--secondary:#6c757d;--success:#28a745;--info:#17a2b8;--warning:#ffc107;--danger:#dc3545;--light:#f8f9fa;--dark:#343a40;--breakpoint-xs:0;--breakpoint-sm:576px;--breakpoint-md:768px;--breakpoint-lg:992px;--breakpoint-xl:1200px;--font-family-sans-serif:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,"Noto Sans",sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";--font-family-monospace:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace}*,::after,::before{box-sizing:border-box}html{font-family:sans-serif;line-height:1.15;-webkit-text-size-adjust:100%;-webkit-tap-highlight-color:transparent}article,aside,figcaption,figure,footer,header,hgroup,main,nav,section{display:block}body{margin:0;font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,"Noto Sans",sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";font-size:1rem;font-weight:400;line-height:1.5;color:#212529;text-align:left;background-color:#fff}[tabindex="-1"]:focus{outline:0!important}hr{box-sizing:content-box;height:0;overflow:visible}h1,h2,h3,h4,h5,h6{margin-top:0;margin-bottom:.5rem}p{margin-top:0;margin-bottom:1rem}abbr[data-original-title],abbr[title]{text-decoration:underline;-webkit-text-decoration:underline dotted;text-decoration:underline dotted;cursor:help;border-bottom:0;-webkit-text-decoration-skip-ink:none;text-decoration-skip-ink:none}address{margin-bottom:1rem;font-style:normal;line-height:inherit}dl,ol,ul{margin-top:0;margin-bottom:1rem}ol ol,ol ul,ul ol,ul ul{margin-bottom:0}dt{font-weight:700}dd{margin-bottom:.5rem;margin-left:0}blockquote{margin:0 0 1rem}b,strong{font-weight:bolder}small{font-size:80%}sub,sup{position:relative;font-size:75%;line-height:0;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}a{color:#007bff;text-decoration:none;background-color:transparent}a:hover{color:#0056b3;text-decoration:underline}a:not([href]):not([tabindex]){color:inherit;text-decoration:none}a:not([href]):not([tabindex]):focus,a:not([href]):not([tabindex]):hover{color:inherit;text-decoration:none}a:not([href]):not([tabindex]):focus{outline:0}code,kbd,pre,samp{font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace;font-size:1em}pre{margin-top:0;margin-bottom:1rem;overflow:auto}figure{margin:0 0 1rem}img{vertical-align:middle;border-style:none}svg{overflow:hidden;vertical-align:middle}table{border-collapse:collapse}caption{padding-top:.75rem;padding-bottom:.75rem;color:#6c757d;text-align:left;caption-side:bottom}th{text-align:inherit}label{display:inline-block;margin-bottom:.5rem}button{border-radius:0}button:focus{outline:1px dotted;outline:5px auto -webkit-focus-ring-color}button,input,optgroup,select,textarea{margin:0;font-family:inherit;font-size:inherit;line-height:inherit}button,input{overflow:visible}button,select{text-transform:none}select{word-wrap:normal}[type=button],[type=reset],[type=submit],button{-webkit-appearance:button}[type=button]:not(:disabled),[type=reset]:not(:disabled),[type=submit]:not(:disabled),button:not(:disabled){cursor:pointer}[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner,button::-moz-focus-inner{padding:0;border-style:none}input[type=checkbox],input[type=radio]{box-sizing:border-box;padding:0}input[type=date],input[type=datetime-local],input[type=month],input[type=time]{-webkit-appearance:listbox}textarea{overflow:auto;resize:vertical}fieldset{min-width:0;padding:0;margin:0;border:0}legend{display:block;width:100%;max-width:100%;padding:0;margin-bottom:.5rem;font-size:1.5rem;line-height:inherit;color:inherit;white-space:normal}progress{vertical-align:baseline}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{outline-offset:-2px;-webkit-appearance:none}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{font:inherit;-webkit-appearance:button}output{display:inline-block}summary{display:list-item;cursor:pointer}template{display:none}[hidden]{display:none!important}.h1,.h2,.h3,.h4,.h5,.h6,h1,h2,h3,h4,h5,h6{margin-bottom:.5rem;font-weight:500;line-height:1.2}.h1,h1{font-size:2.5rem}.h2,h2{font-size:2rem}.h3,h3{font-size:1.75rem}.h4,h4{font-size:1.5rem}.h5,h5{font-size:1.25rem}.h6,h6{font-size:1rem}.lead{font-size:1.25rem;font-weight:300}.display-1{font-size:6rem;font-weight:300;line-height:1.2}.display-2{font-size:5.5rem;font-weight:300;line-height:1.2}.display-3{font-size:4.5rem;font-weight:300;line-height:1.2}.display-4{font-size:3.5rem;font-weight:300;line-height:1.2}hr{margin-top:1rem;margin-bottom:1rem;border:0;border-top:1px solid rgba(0,0,0,.1)}.small,small{font-size:80%;font-weight:400}.mark,mark{padding:.2em;background-color:#fcf8e3}.list-unstyled{padding-left:0;list-style:none}.list-inline{padding-left:0;list-style:none}.list-inline-item{display:inline-block}.list-inline-item:not(:last-child){margin-right:.5rem}.initialism{font-size:90%;text-transform:uppercase}.blockquote{margin-bottom:1rem;font-size:1.25rem}.blockquote-footer{display:block;font-size:80%;color:#6c757d}.blockquote-footer::before{content:"\2014\00A0"}.img-fluid{max-width:100%;height:auto}.img-thumbnail{padding:.25rem;background-color:#fff;border:1px solid #dee2e6;border-radius:.25rem;max-width:100%;height:auto}.figure{display:inline-block}.figure-img{margin-bottom:.5rem;line-height:1}.figure-caption{font-size:90%;color:#6c757d}code{font-size:87.5%;color:#e83e8c;word-break:break-word}a>code{color:inherit}kbd{padding:.2rem .4rem;font-size:87.5%;color:#fff;background-color:#212529;border-radius:.2rem}kbd kbd{padding:0;font-size:100%;font-weight:700}pre{display:block;font-size:87.5%;color:#212529}pre code{font-size:inherit;color:inherit;word-break:normal}.pre-scrollable{max-height:340px;overflow-y:scroll}.container{width:100%;padding-right:15px;padding-left:15px;margin-right:auto;margin-left:auto}@media (min-width:576px){.container{max-width:540px}}@media (min-width:768px){.container{max-width:720px}}@media (min-width:992px){.container{max-width:960px}}@media (min-width:1200px){.container{max-width:1140px}}.container-fluid{width:100%;padding-right:15px;padding-left:15px;margin-right:auto;margin-left:auto}.row{display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;margin-right:-15px;margin-left:-15px}.no-gutters{margin-right:0;margin-left:0}.no-gutters>.col,.no-gutters>[class*=col-]{padding-right:0;padding-left:0}.col,.col-1,.col-10,.col-11,.col-12,.col-2,.col-3,.col-4,.col-5,.col-6,.col-7,.col-8,.col-9,.col-auto,.col-lg,.col-lg-1,.col-lg-10,.col-lg-11,.col-lg-12,.col-lg-2,.col-lg-3,.col-lg-4,.col-lg-5,.col-lg-6,.col-lg-7,.col-lg-8,.col-lg-9,.col-lg-auto,.col-md,.col-md-1,.col-md-10,.col-md-11,.col-md-12,.col-md-2,.col-md-3,.col-md-4,.col-md-5,.col-md-6,.col-md-7,.col-md-8,.col-md-9,.col-md-auto,.col-sm,.col-sm-1,.col-sm-10,.col-sm-11,.col-sm-12,.col-sm-2,.col-sm-3,.col-sm-4,.col-sm-5,.col-sm-6,.col-sm-7,.col-sm-8,.col-sm-9,.col-sm-auto,.col-xl,.col-xl-1,.col-xl-10,.col-xl-11,.col-xl-12,.col-xl-2,.col-xl-3,.col-xl-4,.col-xl-5,.col-xl-6,.col-xl-7,.col-xl-8,.col-xl-9,.col-xl-auto{position:relative;width:100%;padding-right:15px;padding-left:15px}.col{-ms-flex-preferred-size:0;flex-basis:0;-ms-flex-positive:1;flex-grow:1;max-width:100%}.col-auto{-ms-flex:0 0 auto;flex:0 0 auto;width:auto;max-width:100%}.col-1{-ms-flex:0 0 8.333333%;flex:0 0 8.333333%;max-width:8.333333%}.col-2{-ms-flex:0 0 16.666667%;flex:0 0 16.666667%;max-width:16.666667%}.col-3{-ms-flex:0 0 25%;flex:0 0 25%;max-width:25%}.col-4{-ms-flex:0 0 33.333333%;flex:0 0 33.333333%;max-width:33.333333%}.col-5{-ms-flex:0 0 41.666667%;flex:0 0 41.666667%;max-width:41.666667%}.col-6{-ms-flex:0 0 50%;flex:0 0 50%;max-width:50%}.col-7{-ms-flex:0 0 58.333333%;flex:0 0 58.333333%;max-width:58.333333%}.col-8{-ms-flex:0 0 66.666667%;flex:0 0 66.666667%;max-width:66.666667%}.col-9{-ms-flex:0 0 75%;flex:0 0 75%;max-width:75%}.col-10{-ms-flex:0 0 83.333333%;flex:0 0 83.333333%;max-width:83.333333%}.col-11{-ms-flex:0 0 91.666667%;flex:0 0 91.666667%;max-width:91.666667%}.col-12{-ms-flex:0 0 100%;flex:0 0 100%;max-width:100%}.order-first{-ms-flex-order:-1;order:-1}.order-last{-ms-flex-order:13;order:13}.order-0{-ms-flex-order:0;order:0}.order-1{-ms-flex-order:1;order:1}.order-2{-ms-flex-order:2;order:2}.order-3{-ms-flex-order:3;order:3}.order-4{-ms-flex-order:4;order:4}.order-5{-ms-flex-order:5;order:5}.order-6{-ms-flex-order:6;order:6}.order-7{-ms-flex-order:7;order:7}.order-8{-ms-flex-order:8;order:8}.order-9{-ms-flex-order:9;order:9}.order-10{-ms-flex-order:10;order:10}.order-11{-ms-flex-order:11;order:11}.order-12{-ms-flex-order:12;order:12}.offset-1{margin-left:8.333333%}.offset-2{margin-left:16.666667%}.offset-3{margin-left:25%}.offset-4{margin-left:33.333333%}.offset-5{margin-left:41.666667%}.offset-6{margin-left:50%}.offset-7{margin-left:58.333333%}.offset-8{margin-left:66.666667%}.offset-9{margin-left:75%}.offset-10{margin-left:83.333333%}.offset-11{margin-left:91.666667%}@media (min-width:576px){.col-sm{-ms-flex-preferred-size:0;flex-basis:0;-ms-flex-positive:1;flex-grow:1;max-width:100%}.col-sm-auto{-ms-flex:0 0 auto;flex:0 0 auto;width:auto;max-width:100%}.col-sm-1{-ms-flex:0 0 8.333333%;flex:0 0 8.333333%;max-width:8.333333%}.col-sm-2{-ms-flex:0 0 16.666667%;flex:0 0 16.666667%;max-width:16.666667%}.col-sm-3{-ms-flex:0 0 25%;flex:0 0 25%;max-width:25%}.col-sm-4{-ms-flex:0 0 33.333333%;flex:0 0 33.333333%;max-width:33.333333%}.col-sm-5{-ms-flex:0 0 41.666667%;flex:0 0 41.666667%;max-width:41.666667%}.col-sm-6{-ms-flex:0 0 50%;flex:0 0 50%;max-width:50%}.col-sm-7{-ms-flex:0 0 58.333333%;flex:0 0 58.333333%;max-width:58.333333%}.col-sm-8{-ms-flex:0 0 66.666667%;flex:0 0 66.666667%;max-width:66.666667%}.col-sm-9{-ms-flex:0 0 75%;flex:0 0 75%;max-width:75%}.col-sm-10{-ms-flex:0 0 83.333333%;flex:0 0 83.333333%;max-width:83.333333%}.col-sm-11{-ms-flex:0 0 91.666667%;flex:0 0 91.666667%;max-width:91.666667%}.col-sm-12{-ms-flex:0 0 100%;flex:0 0 100%;max-width:100%}.order-sm-first{-ms-flex-order:-1;order:-1}.order-sm-last{-ms-flex-order:13;order:13}.order-sm-0{-ms-flex-order:0;order:0}.order-sm-1{-ms-flex-order:1;order:1}.order-sm-2{-ms-flex-order:2;order:2}.order-sm-3{-ms-flex-order:3;order:3}.order-sm-4{-ms-flex-order:4;order:4}.order-sm-5{-ms-flex-order:5;order:5}.order-sm-6{-ms-flex-order:6;order:6}.order-sm-7{-ms-flex-order:7;order:7}.order-sm-8{-ms-flex-order:8;order:8}.order-sm-9{-ms-flex-order:9;order:9}.order-sm-10{-ms-flex-order:10;order:10}.order-sm-11{-ms-flex-order:11;order:11}.order-sm-12{-ms-flex-order:12;order:12}.offset-sm-0{margin-left:0}.offset-sm-1{margin-left:8.333333%}.offset-sm-2{margin-left:16.666667%}.offset-sm-3{margin-left:25%}.offset-sm-4{margin-left:33.333333%}.offset-sm-5{margin-left:41.666667%}.offset-sm-6{margin-left:50%}.offset-sm-7{margin-left:58.333333%}.offset-sm-8{margin-left:66.666667%}.offset-sm-9{margin-left:75%}.offset-sm-10{margin-left:83.333333%}.offset-sm-11{margin-left:91.666667%}}@media (min-width:768px){.col-md{-ms-flex-preferred-size:0;flex-basis:0;-ms-flex-positive:1;flex-grow:1;max-width:100%}.col-md-auto{-ms-flex:0 0 auto;flex:0 0 auto;width:auto;max-width:100%}.col-md-1{-ms-flex:0 0 8.333333%;flex:0 0 8.333333%;max-width:8.333333%}.col-md-2{-ms-flex:0 0 16.666667%;flex:0 0 16.666667%;max-width:16.666667%}.col-md-3{-ms-flex:0 0 25%;flex:0 0 25%;max-width:25%}.col-md-4{-ms-flex:0 0 33.333333%;flex:0 0 33.333333%;max-width:33.333333%}.col-md-5{-ms-flex:0 0 41.666667%;flex:0 0 41.666667%;max-width:41.666667%}.col-md-6{-ms-flex:0 0 50%;flex:0 0 50%;max-width:50%}.col-md-7{-ms-flex:0 0 58.333333%;flex:0 0 58.333333%;max-width:58.333333%}.col-md-8{-ms-flex:0 0 66.666667%;flex:0 0 66.666667%;max-width:66.666667%}.col-md-9{-ms-flex:0 0 75%;flex:0 0 75%;max-width:75%}.col-md-10{-ms-flex:0 0 83.333333%;flex:0 0 83.333333%;max-width:83.333333%}.col-md-11{-ms-flex:0 0 91.666667%;flex:0 0 91.666667%;max-width:91.666667%}.col-md-12{-ms-flex:0 0 100%;flex:0 0 100%;max-width:100%}.order-md-first{-ms-flex-order:-1;order:-1}.order-md-last{-ms-flex-order:13;order:13}.order-md-0{-ms-flex-order:0;order:0}.order-md-1{-ms-flex-order:1;order:1}.order-md-2{-ms-flex-order:2;order:2}.order-md-3{-ms-flex-order:3;order:3}.order-md-4{-ms-flex-order:4;order:4}.order-md-5{-ms-flex-order:5;order:5}.order-md-6{-ms-flex-order:6;order:6}.order-md-7{-ms-flex-order:7;order:7}.order-md-8{-ms-flex-order:8;order:8}.order-md-9{-ms-flex-order:9;order:9}.order-md-10{-ms-flex-order:10;order:10}.order-md-11{-ms-flex-order:11;order:11}.order-md-12{-ms-flex-order:12;order:12}.offset-md-0{margin-left:0}.offset-md-1{margin-left:8.333333%}.offset-md-2{margin-left:16.666667%}.offset-md-3{margin-left:25%}.offset-md-4{margin-left:33.333333%}.offset-md-5{margin-left:41.666667%}.offset-md-6{margin-left:50%}.offset-md-7{margin-left:58.333333%}.offset-md-8{margin-left:66.666667%}.offset-md-9{margin-left:75%}.offset-md-10{margin-left:83.333333%}.offset-md-11{margin-left:91.666667%}}@media (min-width:992px){.col-lg{-ms-flex-preferred-size:0;flex-basis:0;-ms-flex-positive:1;flex-grow:1;max-width:100%}.col-lg-auto{-ms-flex:0 0 auto;flex:0 0 auto;width:auto;max-width:100%}.col-lg-1{-ms-flex:0 0 8.333333%;flex:0 0 8.333333%;max-width:8.333333%}.col-lg-2{-ms-flex:0 0 16.666667%;flex:0 0 16.666667%;max-width:16.666667%}.col-lg-3{-ms-flex:0 0 25%;flex:0 0 25%;max-width:25%}.col-lg-4{-ms-flex:0 0 33.333333%;flex:0 0 33.333333%;max-width:33.333333%}.col-lg-5{-ms-flex:0 0 41.666667%;flex:0 0 41.666667%;max-width:41.666667%}.col-lg-6{-ms-flex:0 0 50%;flex:0 0 50%;max-width:50%}.col-lg-7{-ms-flex:0 0 58.333333%;flex:0 0 58.333333%;max-width:58.333333%}.col-lg-8{-ms-flex:0 0 66.666667%;flex:0 0 66.666667%;max-width:66.666667%}.col-lg-9{-ms-flex:0 0 75%;flex:0 0 75%;max-width:75%}.col-lg-10{-ms-flex:0 0 83.333333%;flex:0 0 83.333333%;max-width:83.333333%}.col-lg-11{-ms-flex:0 0 91.666667%;flex:0 0 91.666667%;max-width:91.666667%}.col-lg-12{-ms-flex:0 0 100%;flex:0 0 100%;max-width:100%}.order-lg-first{-ms-flex-order:-1;order:-1}.order-lg-last{-ms-flex-order:13;order:13}.order-lg-0{-ms-flex-order:0;order:0}.order-lg-1{-ms-flex-order:1;order:1}.order-lg-2{-ms-flex-order:2;order:2}.order-lg-3{-ms-flex-order:3;order:3}.order-lg-4{-ms-flex-order:4;order:4}.order-lg-5{-ms-flex-order:5;order:5}.order-lg-6{-ms-flex-order:6;order:6}.order-lg-7{-ms-flex-order:7;order:7}.order-lg-8{-ms-flex-order:8;order:8}.order-lg-9{-ms-flex-order:9;order:9}.order-lg-10{-ms-flex-order:10;order:10}.order-lg-11{-ms-flex-order:11;order:11}.order-lg-12{-ms-flex-order:12;order:12}.offset-lg-0{margin-left:0}.offset-lg-1{margin-left:8.333333%}.offset-lg-2{margin-left:16.666667%}.offset-lg-3{margin-left:25%}.offset-lg-4{margin-left:33.333333%}.offset-lg-5{margin-left:41.666667%}.offset-lg-6{margin-left:50%}.offset-lg-7{margin-left:58.333333%}.offset-lg-8{margin-left:66.666667%}.offset-lg-9{margin-left:75%}.offset-lg-10{margin-left:83.333333%}.offset-lg-11{margin-left:91.666667%}}@media (min-width:1200px){.col-xl{-ms-flex-preferred-size:0;flex-basis:0;-ms-flex-positive:1;flex-grow:1;max-width:100%}.col-xl-auto{-ms-flex:0 0 auto;flex:0 0 auto;width:auto;max-width:100%}.col-xl-1{-ms-flex:0 0 8.333333%;flex:0 0 8.333333%;max-width:8.333333%}.col-xl-2{-ms-flex:0 0 16.666667%;flex:0 0 16.666667%;max-width:16.666667%}.col-xl-3{-ms-flex:0 0 25%;flex:0 0 25%;max-width:25%}.col-xl-4{-ms-flex:0 0 33.333333%;flex:0 0 33.333333%;max-width:33.333333%}.col-xl-5{-ms-flex:0 0 41.666667%;flex:0 0 41.666667%;max-width:41.666667%}.col-xl-6{-ms-flex:0 0 50%;flex:0 0 50%;max-width:50%}.col-xl-7{-ms-flex:0 0 58.333333%;flex:0 0 58.333333%;max-width:58.333333%}.col-xl-8{-ms-flex:0 0 66.666667%;flex:0 0 66.666667%;max-width:66.666667%}.col-xl-9{-ms-flex:0 0 75%;flex:0 0 75%;max-width:75%}.col-xl-10{-ms-flex:0 0 83.333333%;flex:0 0 83.333333%;max-width:83.333333%}.col-xl-11{-ms-flex:0 0 91.666667%;flex:0 0 91.666667%;max-width:91.666667%}.col-xl-12{-ms-flex:0 0 100%;flex:0 0 100%;max-width:100%}.order-xl-first{-ms-flex-order:-1;order:-1}.order-xl-last{-ms-flex-order:13;order:13}.order-xl-0{-ms-flex-order:0;order:0}.order-xl-1{-ms-flex-order:1;order:1}.order-xl-2{-ms-flex-order:2;order:2}.order-xl-3{-ms-flex-order:3;order:3}.order-xl-4{-ms-flex-order:4;order:4}.order-xl-5{-ms-flex-order:5;order:5}.order-xl-6{-ms-flex-order:6;order:6}.order-xl-7{-ms-flex-order:7;order:7}.order-xl-8{-ms-flex-order:8;order:8}.order-xl-9{-ms-flex-order:9;order:9}.order-xl-10{-ms-flex-order:10;order:10}.order-xl-11{-ms-flex-order:11;order:11}.order-xl-12{-ms-flex-order:12;order:12}.offset-xl-0{margin-left:0}.offset-xl-1{margin-left:8.333333%}.offset-xl-2{margin-left:16.666667%}.offset-xl-3{margin-left:25%}.offset-xl-4{margin-left:33.333333%}.offset-xl-5{margin-left:41.666667%}.offset-xl-6{margin-left:50%}.offset-xl-7{margin-left:58.333333%}.offset-xl-8{margin-left:66.666667%}.offset-xl-9{margin-left:75%}.offset-xl-10{margin-left:83.333333%}.offset-xl-11{margin-left:91.666667%}}.table{width:100%;margin-bottom:1rem;color:#212529}.table td,.table th{padding:.75rem;vertical-align:top;border-top:1px solid #dee2e6}.table thead th{vertical-align:bottom;border-bottom:2px solid #dee2e6}.table tbody+tbody{border-top:2px solid #dee2e6}.table-sm td,.table-sm th{padding:.3rem}.table-bordered{border:1px solid #dee2e6}.table-bordered td,.table-bordered th{border:1px solid #dee2e6}.table-bordered thead td,.table-bordered thead th{border-bottom-width:2px}.table-borderless tbody+tbody,.table-borderless td,.table-borderless th,.table-borderless thead th{border:0}.table-striped tbody tr:nth-of-type(odd){background-color:rgba(0,0,0,.05)}.table-hover tbody tr:hover{color:#212529;background-color:rgba(0,0,0,.075)}.table-primary,.table-primary>td,.table-primary>th{background-color:#b8daff}.table-primary tbody+tbody,.table-primary td,.table-primary th,.table-primary thead th{border-color:#7abaff}.table-hover .table-primary:hover{background-color:#9fcdff}.table-hover .table-primary:hover>td,.table-hover .table-primary:hover>th{background-color:#9fcdff}.table-secondary,.table-secondary>td,.table-secondary>th{background-color:#d6d8db}.table-secondary tbody+tbody,.table-secondary td,.table-secondary th,.table-secondary thead th{border-color:#b3b7bb}.table-hover .table-secondary:hover{background-color:#c8cbcf}.table-hover .table-secondary:hover>td,.table-hover .table-secondary:hover>th{background-color:#c8cbcf}.table-success,.table-success>td,.table-success>th{background-color:#c3e6cb}.table-success tbody+tbody,.table-success td,.table-success th,.table-success thead th{border-color:#8fd19e}.table-hover .table-success:hover{background-color:#b1dfbb}.table-hover .table-success:hover>td,.table-hover .table-success:hover>th{background-color:#b1dfbb}.table-info,.table-info>td,.table-info>th{background-color:#bee5eb}.table-info tbody+tbody,.table-info td,.table-info th,.table-info thead th{border-color:#86cfda}.table-hover .table-info:hover{background-color:#abdde5}.table-hover .table-info:hover>td,.table-hover .table-info:hover>th{background-color:#abdde5}.table-warning,.table-warning>td,.table-warning>th{background-color:#ffeeba}.table-warning tbody+tbody,.table-warning td,.table-warning th,.table-warning thead th{border-color:#ffdf7e}.table-hover .table-warning:hover{background-color:#ffe8a1}.table-hover .table-warning:hover>td,.table-hover .table-warning:hover>th{background-color:#ffe8a1}.table-danger,.table-danger>td,.table-danger>th{background-color:#f5c6cb}.table-danger tbody+tbody,.table-danger td,.table-danger th,.table-danger thead th{border-color:#ed969e}.table-hover .table-danger:hover{background-color:#f1b0b7}.table-hover .table-danger:hover>td,.table-hover .table-danger:hover>th{background-color:#f1b0b7}.table-light,.table-light>td,.table-light>th{background-color:#fdfdfe}.table-light tbody+tbody,.table-light td,.table-light th,.table-light thead th{border-color:#fbfcfc}.table-hover .table-light:hover{background-color:#ececf6}.table-hover .table-light:hover>td,.table-hover .table-light:hover>th{background-color:#ececf6}.table-dark,.table-dark>td,.table-dark>th{background-color:#c6c8ca}.table-dark tbody+tbody,.table-dark td,.table-dark th,.table-dark thead th{border-color:#95999c}.table-hover .table-dark:hover{background-color:#b9bbbe}.table-hover .table-dark:hover>td,.table-hover .table-dark:hover>th{background-color:#b9bbbe}.table-active,.table-active>td,.table-active>th{background-color:rgba(0,0,0,.075)}.table-hover .table-active:hover{background-color:rgba(0,0,0,.075)}.table-hover .table-active:hover>td,.table-hover .table-active:hover>th{background-color:rgba(0,0,0,.075)}.table .thead-dark th{color:#fff;background-color:#343a40;border-color:#454d55}.table .thead-light th{color:#495057;background-color:#e9ecef;border-color:#dee2e6}.table-dark{color:#fff;background-color:#343a40}.table-dark td,.table-dark th,.table-dark thead th{border-color:#454d55}.table-dark.table-bordered{border:0}.table-dark.table-striped tbody tr:nth-of-type(odd){background-color:rgba(255,255,255,.05)}.table-dark.table-hover tbody tr:hover{color:#fff;background-color:rgba(255,255,255,.075)}@media (max-width:575.98px){.table-responsive-sm{display:block;width:100%;overflow-x:auto;-webkit-overflow-scrolling:touch}.table-responsive-sm>.table-bordered{border:0}}@media (max-width:767.98px){.table-responsive-md{display:block;width:100%;overflow-x:auto;-webkit-overflow-scrolling:touch}.table-responsive-md>.table-bordered{border:0}}@media (max-width:991.98px){.table-responsive-lg{display:block;width:100%;overflow-x:auto;-webkit-overflow-scrolling:touch}.table-responsive-lg>.table-bordered{border:0}}@media (max-width:1199.98px){.table-responsive-xl{display:block;width:100%;overflow-x:auto;-webkit-overflow-scrolling:touch}.table-responsive-xl>.table-bordered{border:0}}.table-responsive{display:block;width:100%;overflow-x:auto;-webkit-overflow-scrolling:touch}.table-responsive>.table-bordered{border:0}.form-control{display:block;width:100%;height:calc(1.5em + .75rem + 2px);padding:.375rem .75rem;font-size:1rem;font-weight:400;line-height:1.5;color:#495057;background-color:#fff;background-clip:padding-box;border:1px solid #ced4da;border-radius:.25rem;transition:border-color .15s ease-in-out,box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.form-control{transition:none}}.form-control::-ms-expand{background-color:transparent;border:0}.form-control:focus{color:#495057;background-color:#fff;border-color:#80bdff;outline:0;box-shadow:0 0 0 .2rem rgba(0,123,255,.25)}.form-control::-webkit-input-placeholder{color:#6c757d;opacity:1}.form-control::-moz-placeholder{color:#6c757d;opacity:1}.form-control:-ms-input-placeholder{color:#6c757d;opacity:1}.form-control::-ms-input-placeholder{color:#6c757d;opacity:1}.form-control::placeholder{color:#6c757d;opacity:1}.form-control:disabled,.form-control[readonly]{background-color:#e9ecef;opacity:1}select.form-control:focus::-ms-value{color:#495057;background-color:#fff}.form-control-file,.form-control-range{display:block;width:100%}.col-form-label{padding-top:calc(.375rem + 1px);padding-bottom:calc(.375rem + 1px);margin-bottom:0;font-size:inherit;line-height:1.5}.col-form-label-lg{padding-top:calc(.5rem + 1px);padding-bottom:calc(.5rem + 1px);font-size:1.25rem;line-height:1.5}.col-form-label-sm{padding-top:calc(.25rem + 1px);padding-bottom:calc(.25rem + 1px);font-size:.875rem;line-height:1.5}.form-control-plaintext{display:block;width:100%;padding-top:.375rem;padding-bottom:.375rem;margin-bottom:0;line-height:1.5;color:#212529;background-color:transparent;border:solid transparent;border-width:1px 0}.form-control-plaintext.form-control-lg,.form-control-plaintext.form-control-sm{padding-right:0;padding-left:0}.form-control-sm{height:calc(1.5em + .5rem + 2px);padding:.25rem .5rem;font-size:.875rem;line-height:1.5;border-radius:.2rem}.form-control-lg{height:calc(1.5em + 1rem + 2px);padding:.5rem 1rem;font-size:1.25rem;line-height:1.5;border-radius:.3rem}select.form-control[multiple],select.form-control[size]{height:auto}textarea.form-control{height:auto}.form-group{margin-bottom:1rem}.form-text{display:block;margin-top:.25rem}.form-row{display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;margin-right:-5px;margin-left:-5px}.form-row>.col,.form-row>[class*=col-]{padding-right:5px;padding-left:5px}.form-check{position:relative;display:block;padding-left:1.25rem}.form-check-input{position:absolute;margin-top:.3rem;margin-left:-1.25rem}.form-check-input:disabled~.form-check-label{color:#6c757d}.form-check-label{margin-bottom:0}.form-check-inline{display:-ms-inline-flexbox;display:inline-flex;-ms-flex-align:center;align-items:center;padding-left:0;margin-right:.75rem}.form-check-inline .form-check-input{position:static;margin-top:0;margin-right:.3125rem;margin-left:0}.valid-feedback{display:none;width:100%;margin-top:.25rem;font-size:80%;color:#28a745}.valid-tooltip{position:absolute;top:100%;z-index:5;display:none;max-width:100%;padding:.25rem .5rem;margin-top:.1rem;font-size:.875rem;line-height:1.5;color:#fff;background-color:rgba(40,167,69,.9);border-radius:.25rem}.form-control.is-valid,.was-validated .form-control:valid{border-color:#28a745;padding-right:calc(1.5em + .75rem);background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 8 8'%3e%3cpath fill='%2328a745' d='M2.3 6.73L.6 4.53c-.4-1.04.46-1.4 1.1-.8l1.1 1.4 3.4-3.8c.6-.63 1.6-.27 1.2.7l-4 4.6c-.43.5-.8.4-1.1.1z'/%3e%3c/svg%3e");background-repeat:no-repeat;background-position:center right calc(.375em + .1875rem);background-size:calc(.75em + .375rem) calc(.75em + .375rem)}.form-control.is-valid:focus,.was-validated .form-control:valid:focus{border-color:#28a745;box-shadow:0 0 0 .2rem rgba(40,167,69,.25)}.form-control.is-valid~.valid-feedback,.form-control.is-valid~.valid-tooltip,.was-validated .form-control:valid~.valid-feedback,.was-validated .form-control:valid~.valid-tooltip{display:block}.was-validated textarea.form-control:valid,textarea.form-control.is-valid{padding-right:calc(1.5em + .75rem);background-position:top calc(.375em + .1875rem) right calc(.375em + .1875rem)}.custom-select.is-valid,.was-validated .custom-select:valid{border-color:#28a745;padding-right:calc((1em + .75rem) * 3 / 4 + 1.75rem);background:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 4 5'%3e%3cpath fill='%23343a40' d='M2 0L0 2h4zm0 5L0 3h4z'/%3e%3c/svg%3e") no-repeat right .75rem center/8px 10px,url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 8 8'%3e%3cpath fill='%2328a745' d='M2.3 6.73L.6 4.53c-.4-1.04.46-1.4 1.1-.8l1.1 1.4 3.4-3.8c.6-.63 1.6-.27 1.2.7l-4 4.6c-.43.5-.8.4-1.1.1z'/%3e%3c/svg%3e") #fff no-repeat center right 1.75rem/calc(.75em + .375rem) calc(.75em + .375rem)}.custom-select.is-valid:focus,.was-validated .custom-select:valid:focus{border-color:#28a745;box-shadow:0 0 0 .2rem rgba(40,167,69,.25)}.custom-select.is-valid~.valid-feedback,.custom-select.is-valid~.valid-tooltip,.was-validated .custom-select:valid~.valid-feedback,.was-validated .custom-select:valid~.valid-tooltip{display:block}.form-control-file.is-valid~.valid-feedback,.form-control-file.is-valid~.valid-tooltip,.was-validated .form-control-file:valid~.valid-feedback,.was-validated .form-control-file:valid~.valid-tooltip{display:block}.form-check-input.is-valid~.form-check-label,.was-validated .form-check-input:valid~.form-check-label{color:#28a745}.form-check-input.is-valid~.valid-feedback,.form-check-input.is-valid~.valid-tooltip,.was-validated .form-check-input:valid~.valid-feedback,.was-validated .form-check-input:valid~.valid-tooltip{display:block}.custom-control-input.is-valid~.custom-control-label,.was-validated .custom-control-input:valid~.custom-control-label{color:#28a745}.custom-control-input.is-valid~.custom-control-label::before,.was-validated .custom-control-input:valid~.custom-control-label::before{border-color:#28a745}.custom-control-input.is-valid~.valid-feedback,.custom-control-input.is-valid~.valid-tooltip,.was-validated .custom-control-input:valid~.valid-feedback,.was-validated .custom-control-input:valid~.valid-tooltip{display:block}.custom-control-input.is-valid:checked~.custom-control-label::before,.was-validated .custom-control-input:valid:checked~.custom-control-label::before{border-color:#34ce57;background-color:#34ce57}.custom-control-input.is-valid:focus~.custom-control-label::before,.was-validated .custom-control-input:valid:focus~.custom-control-label::before{box-shadow:0 0 0 .2rem rgba(40,167,69,.25)}.custom-control-input.is-valid:focus:not(:checked)~.custom-control-label::before,.was-validated .custom-control-input:valid:focus:not(:checked)~.custom-control-label::before{border-color:#28a745}.custom-file-input.is-valid~.custom-file-label,.was-validated .custom-file-input:valid~.custom-file-label{border-color:#28a745}.custom-file-input.is-valid~.valid-feedback,.custom-file-input.is-valid~.valid-tooltip,.was-validated .custom-file-input:valid~.valid-feedback,.was-validated .custom-file-input:valid~.valid-tooltip{display:block}.custom-file-input.is-valid:focus~.custom-file-label,.was-validated .custom-file-input:valid:focus~.custom-file-label{border-color:#28a745;box-shadow:0 0 0 .2rem rgba(40,167,69,.25)}.invalid-feedback{display:none;width:100%;margin-top:.25rem;font-size:80%;color:#dc3545}.invalid-tooltip{position:absolute;top:100%;z-index:5;display:none;max-width:100%;padding:.25rem .5rem;margin-top:.1rem;font-size:.875rem;line-height:1.5;color:#fff;background-color:rgba(220,53,69,.9);border-radius:.25rem}.form-control.is-invalid,.was-validated .form-control:invalid{border-color:#dc3545;padding-right:calc(1.5em + .75rem);background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' fill='%23dc3545' viewBox='-2 -2 7 7'%3e%3cpath stroke='%23dc3545' d='M0 0l3 3m0-3L0 3'/%3e%3ccircle r='.5'/%3e%3ccircle cx='3' r='.5'/%3e%3ccircle cy='3' r='.5'/%3e%3ccircle cx='3' cy='3' r='.5'/%3e%3c/svg%3E");background-repeat:no-repeat;background-position:center right calc(.375em + .1875rem);background-size:calc(.75em + .375rem) calc(.75em + .375rem)}.form-control.is-invalid:focus,.was-validated .form-control:invalid:focus{border-color:#dc3545;box-shadow:0 0 0 .2rem rgba(220,53,69,.25)}.form-control.is-invalid~.invalid-feedback,.form-control.is-invalid~.invalid-tooltip,.was-validated .form-control:invalid~.invalid-feedback,.was-validated .form-control:invalid~.invalid-tooltip{display:block}.was-validated textarea.form-control:invalid,textarea.form-control.is-invalid{padding-right:calc(1.5em + .75rem);background-position:top calc(.375em + .1875rem) right calc(.375em + .1875rem)}.custom-select.is-invalid,.was-validated .custom-select:invalid{border-color:#dc3545;padding-right:calc((1em + .75rem) * 3 / 4 + 1.75rem);background:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 4 5'%3e%3cpath fill='%23343a40' d='M2 0L0 2h4zm0 5L0 3h4z'/%3e%3c/svg%3e") no-repeat right .75rem center/8px 10px,url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' fill='%23dc3545' viewBox='-2 -2 7 7'%3e%3cpath stroke='%23dc3545' d='M0 0l3 3m0-3L0 3'/%3e%3ccircle r='.5'/%3e%3ccircle cx='3' r='.5'/%3e%3ccircle cy='3' r='.5'/%3e%3ccircle cx='3' cy='3' r='.5'/%3e%3c/svg%3E") #fff no-repeat center right 1.75rem/calc(.75em + .375rem) calc(.75em + .375rem)}.custom-select.is-invalid:focus,.was-validated .custom-select:invalid:focus{border-color:#dc3545;box-shadow:0 0 0 .2rem rgba(220,53,69,.25)}.custom-select.is-invalid~.invalid-feedback,.custom-select.is-invalid~.invalid-tooltip,.was-validated .custom-select:invalid~.invalid-feedback,.was-validated .custom-select:invalid~.invalid-tooltip{display:block}.form-control-file.is-invalid~.invalid-feedback,.form-control-file.is-invalid~.invalid-tooltip,.was-validated .form-control-file:invalid~.invalid-feedback,.was-validated .form-control-file:invalid~.invalid-tooltip{display:block}.form-check-input.is-invalid~.form-check-label,.was-validated .form-check-input:invalid~.form-check-label{color:#dc3545}.form-check-input.is-invalid~.invalid-feedback,.form-check-input.is-invalid~.invalid-tooltip,.was-validated .form-check-input:invalid~.invalid-feedback,.was-validated .form-check-input:invalid~.invalid-tooltip{display:block}.custom-control-input.is-invalid~.custom-control-label,.was-validated .custom-control-input:invalid~.custom-control-label{color:#dc3545}.custom-control-input.is-invalid~.custom-control-label::before,.was-validated .custom-control-input:invalid~.custom-control-label::before{border-color:#dc3545}.custom-control-input.is-invalid~.invalid-feedback,.custom-control-input.is-invalid~.invalid-tooltip,.was-validated .custom-control-input:invalid~.invalid-feedback,.was-validated .custom-control-input:invalid~.invalid-tooltip{display:block}.custom-control-input.is-invalid:checked~.custom-control-label::before,.was-validated .custom-control-input:invalid:checked~.custom-control-label::before{border-color:#e4606d;background-color:#e4606d}.custom-control-input.is-invalid:focus~.custom-control-label::before,.was-validated .custom-control-input:invalid:focus~.custom-control-label::before{box-shadow:0 0 0 .2rem rgba(220,53,69,.25)}.custom-control-input.is-invalid:focus:not(:checked)~.custom-control-label::before,.was-validated .custom-control-input:invalid:focus:not(:checked)~.custom-control-label::before{border-color:#dc3545}.custom-file-input.is-invalid~.custom-file-label,.was-validated .custom-file-input:invalid~.custom-file-label{border-color:#dc3545}.custom-file-input.is-invalid~.invalid-feedback,.custom-file-input.is-invalid~.invalid-tooltip,.was-validated .custom-file-input:invalid~.invalid-feedback,.was-validated .custom-file-input:invalid~.invalid-tooltip{display:block}.custom-file-input.is-invalid:focus~.custom-file-label,.was-validated .custom-file-input:invalid:focus~.custom-file-label{border-color:#dc3545;box-shadow:0 0 0 .2rem rgba(220,53,69,.25)}.form-inline{display:-ms-flexbox;display:flex;-ms-flex-flow:row wrap;flex-flow:row wrap;-ms-flex-align:center;align-items:center}.form-inline .form-check{width:100%}@media (min-width:576px){.form-inline label{display:-ms-flexbox;display:flex;-ms-flex-align:center;align-items:center;-ms-flex-pack:center;justify-content:center;margin-bottom:0}.form-inline .form-group{display:-ms-flexbox;display:flex;-ms-flex:0 0 auto;flex:0 0 auto;-ms-flex-flow:row wrap;flex-flow:row wrap;-ms-flex-align:center;align-items:center;margin-bottom:0}.form-inline .form-control{display:inline-block;width:auto;vertical-align:middle}.form-inline .form-control-plaintext{display:inline-block}.form-inline .custom-select,.form-inline .input-group{width:auto}.form-inline .form-check{display:-ms-flexbox;display:flex;-ms-flex-align:center;align-items:center;-ms-flex-pack:center;justify-content:center;width:auto;padding-left:0}.form-inline .form-check-input{position:relative;-ms-flex-negative:0;flex-shrink:0;margin-top:0;margin-right:.25rem;margin-left:0}.form-inline .custom-control{-ms-flex-align:center;align-items:center;-ms-flex-pack:center;justify-content:center}.form-inline .custom-control-label{margin-bottom:0}}.btn{display:inline-block;font-weight:400;color:#212529;text-align:center;vertical-align:middle;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;background-color:transparent;border:1px solid transparent;padding:.375rem .75rem;font-size:1rem;line-height:1.5;border-radius:.25rem;transition:color .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.btn{transition:none}}.btn:hover{color:#212529;text-decoration:none}.btn.focus,.btn:focus{outline:0;box-shadow:0 0 0 .2rem rgba(0,123,255,.25)}.btn.disabled,.btn:disabled{opacity:.65}a.btn.disabled,fieldset:disabled a.btn{pointer-events:none}.btn-primary{color:#fff;background-color:#007bff;border-color:#007bff}.btn-primary:hover{color:#fff;background-color:#0069d9;border-color:#0062cc}.btn-primary.focus,.btn-primary:focus{box-shadow:0 0 0 .2rem rgba(38,143,255,.5)}.btn-primary.disabled,.btn-primary:disabled{color:#fff;background-color:#007bff;border-color:#007bff}.btn-primary:not(:disabled):not(.disabled).active,.btn-primary:not(:disabled):not(.disabled):active,.show>.btn-primary.dropdown-toggle{color:#fff;background-color:#0062cc;border-color:#005cbf}.btn-primary:not(:disabled):not(.disabled).active:focus,.btn-primary:not(:disabled):not(.disabled):active:focus,.show>.btn-primary.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(38,143,255,.5)}.btn-secondary{color:#fff;background-color:#6c757d;border-color:#6c757d}.btn-secondary:hover{color:#fff;background-color:#5a6268;border-color:#545b62}.btn-secondary.focus,.btn-secondary:focus{box-shadow:0 0 0 .2rem rgba(130,138,145,.5)}.btn-secondary.disabled,.btn-secondary:disabled{color:#fff;background-color:#6c757d;border-color:#6c757d}.btn-secondary:not(:disabled):not(.disabled).active,.btn-secondary:not(:disabled):not(.disabled):active,.show>.btn-secondary.dropdown-toggle{color:#fff;background-color:#545b62;border-color:#4e555b}.btn-secondary:not(:disabled):not(.disabled).active:focus,.btn-secondary:not(:disabled):not(.disabled):active:focus,.show>.btn-secondary.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(130,138,145,.5)}.btn-success{color:#fff;background-color:#28a745;border-color:#28a745}.btn-success:hover{color:#fff;background-color:#218838;border-color:#1e7e34}.btn-success.focus,.btn-success:focus{box-shadow:0 0 0 .2rem rgba(72,180,97,.5)}.btn-success.disabled,.btn-success:disabled{color:#fff;background-color:#28a745;border-color:#28a745}.btn-success:not(:disabled):not(.disabled).active,.btn-success:not(:disabled):not(.disabled):active,.show>.btn-success.dropdown-toggle{color:#fff;background-color:#1e7e34;border-color:#1c7430}.btn-success:not(:disabled):not(.disabled).active:focus,.btn-success:not(:disabled):not(.disabled):active:focus,.show>.btn-success.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(72,180,97,.5)}.btn-info{color:#fff;background-color:#17a2b8;border-color:#17a2b8}.btn-info:hover{color:#fff;background-color:#138496;border-color:#117a8b}.btn-info.focus,.btn-info:focus{box-shadow:0 0 0 .2rem rgba(58,176,195,.5)}.btn-info.disabled,.btn-info:disabled{color:#fff;background-color:#17a2b8;border-color:#17a2b8}.btn-info:not(:disabled):not(.disabled).active,.btn-info:not(:disabled):not(.disabled):active,.show>.btn-info.dropdown-toggle{color:#fff;background-color:#117a8b;border-color:#10707f}.btn-info:not(:disabled):not(.disabled).active:focus,.btn-info:not(:disabled):not(.disabled):active:focus,.show>.btn-info.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(58,176,195,.5)}.btn-warning{color:#212529;background-color:#ffc107;border-color:#ffc107}.btn-warning:hover{color:#212529;background-color:#e0a800;border-color:#d39e00}.btn-warning.focus,.btn-warning:focus{box-shadow:0 0 0 .2rem rgba(222,170,12,.5)}.btn-warning.disabled,.btn-warning:disabled{color:#212529;background-color:#ffc107;border-color:#ffc107}.btn-warning:not(:disabled):not(.disabled).active,.btn-warning:not(:disabled):not(.disabled):active,.show>.btn-warning.dropdown-toggle{color:#212529;background-color:#d39e00;border-color:#c69500}.btn-warning:not(:disabled):not(.disabled).active:focus,.btn-warning:not(:disabled):not(.disabled):active:focus,.show>.btn-warning.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(222,170,12,.5)}.btn-danger{color:#fff;background-color:#dc3545;border-color:#dc3545}.btn-danger:hover{color:#fff;background-color:#c82333;border-color:#bd2130}.btn-danger.focus,.btn-danger:focus{box-shadow:0 0 0 .2rem rgba(225,83,97,.5)}.btn-danger.disabled,.btn-danger:disabled{color:#fff;background-color:#dc3545;border-color:#dc3545}.btn-danger:not(:disabled):not(.disabled).active,.btn-danger:not(:disabled):not(.disabled):active,.show>.btn-danger.dropdown-toggle{color:#fff;background-color:#bd2130;border-color:#b21f2d}.btn-danger:not(:disabled):not(.disabled).active:focus,.btn-danger:not(:disabled):not(.disabled):active:focus,.show>.btn-danger.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(225,83,97,.5)}.btn-light{color:#212529;background-color:#f8f9fa;border-color:#f8f9fa}.btn-light:hover{color:#212529;background-color:#e2e6ea;border-color:#dae0e5}.btn-light.focus,.btn-light:focus{box-shadow:0 0 0 .2rem rgba(216,217,219,.5)}.btn-light.disabled,.btn-light:disabled{color:#212529;background-color:#f8f9fa;border-color:#f8f9fa}.btn-light:not(:disabled):not(.disabled).active,.btn-light:not(:disabled):not(.disabled):active,.show>.btn-light.dropdown-toggle{color:#212529;background-color:#dae0e5;border-color:#d3d9df}.btn-light:not(:disabled):not(.disabled).active:focus,.btn-light:not(:disabled):not(.disabled):active:focus,.show>.btn-light.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(216,217,219,.5)}.btn-dark{color:#fff;background-color:#343a40;border-color:#343a40}.btn-dark:hover{color:#fff;background-color:#23272b;border-color:#1d2124}.btn-dark.focus,.btn-dark:focus{box-shadow:0 0 0 .2rem rgba(82,88,93,.5)}.btn-dark.disabled,.btn-dark:disabled{color:#fff;background-color:#343a40;border-color:#343a40}.btn-dark:not(:disabled):not(.disabled).active,.btn-dark:not(:disabled):not(.disabled):active,.show>.btn-dark.dropdown-toggle{color:#fff;background-color:#1d2124;border-color:#171a1d}.btn-dark:not(:disabled):not(.disabled).active:focus,.btn-dark:not(:disabled):not(.disabled):active:focus,.show>.btn-dark.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(82,88,93,.5)}.btn-outline-primary{color:#007bff;border-color:#007bff}.btn-outline-primary:hover{color:#fff;background-color:#007bff;border-color:#007bff}.btn-outline-primary.focus,.btn-outline-primary:focus{box-shadow:0 0 0 .2rem rgba(0,123,255,.5)}.btn-outline-primary.disabled,.btn-outline-primary:disabled{color:#007bff;background-color:transparent}.btn-outline-primary:not(:disabled):not(.disabled).active,.btn-outline-primary:not(:disabled):not(.disabled):active,.show>.btn-outline-primary.dropdown-toggle{color:#fff;background-color:#007bff;border-color:#007bff}.btn-outline-primary:not(:disabled):not(.disabled).active:focus,.btn-outline-primary:not(:disabled):not(.disabled):active:focus,.show>.btn-outline-primary.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(0,123,255,.5)}.btn-outline-secondary{color:#6c757d;border-color:#6c757d}.btn-outline-secondary:hover{color:#fff;background-color:#6c757d;border-color:#6c757d}.btn-outline-secondary.focus,.btn-outline-secondary:focus{box-shadow:0 0 0 .2rem rgba(108,117,125,.5)}.btn-outline-secondary.disabled,.btn-outline-secondary:disabled{color:#6c757d;background-color:transparent}.btn-outline-secondary:not(:disabled):not(.disabled).active,.btn-outline-secondary:not(:disabled):not(.disabled):active,.show>.btn-outline-secondary.dropdown-toggle{color:#fff;background-color:#6c757d;border-color:#6c757d}.btn-outline-secondary:not(:disabled):not(.disabled).active:focus,.btn-outline-secondary:not(:disabled):not(.disabled):active:focus,.show>.btn-outline-secondary.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(108,117,125,.5)}.btn-outline-success{color:#28a745;border-color:#28a745}.btn-outline-success:hover{color:#fff;background-color:#28a745;border-color:#28a745}.btn-outline-success.focus,.btn-outline-success:focus{box-shadow:0 0 0 .2rem rgba(40,167,69,.5)}.btn-outline-success.disabled,.btn-outline-success:disabled{color:#28a745;background-color:transparent}.btn-outline-success:not(:disabled):not(.disabled).active,.btn-outline-success:not(:disabled):not(.disabled):active,.show>.btn-outline-success.dropdown-toggle{color:#fff;background-color:#28a745;border-color:#28a745}.btn-outline-success:not(:disabled):not(.disabled).active:focus,.btn-outline-success:not(:disabled):not(.disabled):active:focus,.show>.btn-outline-success.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(40,167,69,.5)}.btn-outline-info{color:#17a2b8;border-color:#17a2b8}.btn-outline-info:hover{color:#fff;background-color:#17a2b8;border-color:#17a2b8}.btn-outline-info.focus,.btn-outline-info:focus{box-shadow:0 0 0 .2rem rgba(23,162,184,.5)}.btn-outline-info.disabled,.btn-outline-info:disabled{color:#17a2b8;background-color:transparent}.btn-outline-info:not(:disabled):not(.disabled).active,.btn-outline-info:not(:disabled):not(.disabled):active,.show>.btn-outline-info.dropdown-toggle{color:#fff;background-color:#17a2b8;border-color:#17a2b8}.btn-outline-info:not(:disabled):not(.disabled).active:focus,.btn-outline-info:not(:disabled):not(.disabled):active:focus,.show>.btn-outline-info.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(23,162,184,.5)}.btn-outline-warning{color:#ffc107;border-color:#ffc107}.btn-outline-warning:hover{color:#212529;background-color:#ffc107;border-color:#ffc107}.btn-outline-warning.focus,.btn-outline-warning:focus{box-shadow:0 0 0 .2rem rgba(255,193,7,.5)}.btn-outline-warning.disabled,.btn-outline-warning:disabled{color:#ffc107;background-color:transparent}.btn-outline-warning:not(:disabled):not(.disabled).active,.btn-outline-warning:not(:disabled):not(.disabled):active,.show>.btn-outline-warning.dropdown-toggle{color:#212529;background-color:#ffc107;border-color:#ffc107}.btn-outline-warning:not(:disabled):not(.disabled).active:focus,.btn-outline-warning:not(:disabled):not(.disabled):active:focus,.show>.btn-outline-warning.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(255,193,7,.5)}.btn-outline-danger{color:#dc3545;border-color:#dc3545}.btn-outline-danger:hover{color:#fff;background-color:#dc3545;border-color:#dc3545}.btn-outline-danger.focus,.btn-outline-danger:focus{box-shadow:0 0 0 .2rem rgba(220,53,69,.5)}.btn-outline-danger.disabled,.btn-outline-danger:disabled{color:#dc3545;background-color:transparent}.btn-outline-danger:not(:disabled):not(.disabled).active,.btn-outline-danger:not(:disabled):not(.disabled):active,.show>.btn-outline-danger.dropdown-toggle{color:#fff;background-color:#dc3545;border-color:#dc3545}.btn-outline-danger:not(:disabled):not(.disabled).active:focus,.btn-outline-danger:not(:disabled):not(.disabled):active:focus,.show>.btn-outline-danger.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(220,53,69,.5)}.btn-outline-light{color:#f8f9fa;border-color:#f8f9fa}.btn-outline-light:hover{color:#212529;background-color:#f8f9fa;border-color:#f8f9fa}.btn-outline-light.focus,.btn-outline-light:focus{box-shadow:0 0 0 .2rem rgba(248,249,250,.5)}.btn-outline-light.disabled,.btn-outline-light:disabled{color:#f8f9fa;background-color:transparent}.btn-outline-light:not(:disabled):not(.disabled).active,.btn-outline-light:not(:disabled):not(.disabled):active,.show>.btn-outline-light.dropdown-toggle{color:#212529;background-color:#f8f9fa;border-color:#f8f9fa}.btn-outline-light:not(:disabled):not(.disabled).active:focus,.btn-outline-light:not(:disabled):not(.disabled):active:focus,.show>.btn-outline-light.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(248,249,250,.5)}.btn-outline-dark{color:#343a40;border-color:#343a40}.btn-outline-dark:hover{color:#fff;background-color:#343a40;border-color:#343a40}.btn-outline-dark.focus,.btn-outline-dark:focus{box-shadow:0 0 0 .2rem rgba(52,58,64,.5)}.btn-outline-dark.disabled,.btn-outline-dark:disabled{color:#343a40;background-color:transparent}.btn-outline-dark:not(:disabled):not(.disabled).active,.btn-outline-dark:not(:disabled):not(.disabled):active,.show>.btn-outline-dark.dropdown-toggle{color:#fff;background-color:#343a40;border-color:#343a40}.btn-outline-dark:not(:disabled):not(.disabled).active:focus,.btn-outline-dark:not(:disabled):not(.disabled):active:focus,.show>.btn-outline-dark.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(52,58,64,.5)}.btn-link{font-weight:400;color:#007bff;text-decoration:none}.btn-link:hover{color:#0056b3;text-decoration:underline}.btn-link.focus,.btn-link:focus{text-decoration:underline;box-shadow:none}.btn-link.disabled,.btn-link:disabled{color:#6c757d;pointer-events:none}.btn-group-lg>.btn,.btn-lg{padding:.5rem 1rem;font-size:1.25rem;line-height:1.5;border-radius:.3rem}.btn-group-sm>.btn,.btn-sm{padding:.25rem .5rem;font-size:.875rem;line-height:1.5;border-radius:.2rem}.btn-block{display:block;width:100%}.btn-block+.btn-block{margin-top:.5rem}input[type=button].btn-block,input[type=reset].btn-block,input[type=submit].btn-block{width:100%}.fade{transition:opacity .15s linear}@media (prefers-reduced-motion:reduce){.fade{transition:none}}.fade:not(.show){opacity:0}.collapse:not(.show){display:none}.collapsing{position:relative;height:0;overflow:hidden;transition:height .35s ease}@media (prefers-reduced-motion:reduce){.collapsing{transition:none}}.dropdown,.dropleft,.dropright,.dropup{position:relative}.dropdown-toggle{white-space:nowrap}.dropdown-toggle::after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:"";border-top:.3em solid;border-right:.3em solid transparent;border-bottom:0;border-left:.3em solid transparent}.dropdown-toggle:empty::after{margin-left:0}.dropdown-menu{position:absolute;top:100%;left:0;z-index:1000;display:none;float:left;min-width:10rem;padding:.5rem 0;margin:.125rem 0 0;font-size:1rem;color:#212529;text-align:left;list-style:none;background-color:#fff;background-clip:padding-box;border:1px solid rgba(0,0,0,.15);border-radius:.25rem}.dropdown-menu-left{right:auto;left:0}.dropdown-menu-right{right:0;left:auto}@media (min-width:576px){.dropdown-menu-sm-left{right:auto;left:0}.dropdown-menu-sm-right{right:0;left:auto}}@media (min-width:768px){.dropdown-menu-md-left{right:auto;left:0}.dropdown-menu-md-right{right:0;left:auto}}@media (min-width:992px){.dropdown-menu-lg-left{right:auto;left:0}.dropdown-menu-lg-right{right:0;left:auto}}@media (min-width:1200px){.dropdown-menu-xl-left{right:auto;left:0}.dropdown-menu-xl-right{right:0;left:auto}}.dropup .dropdown-menu{top:auto;bottom:100%;margin-top:0;margin-bottom:.125rem}.dropup .dropdown-toggle::after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:"";border-top:0;border-right:.3em solid transparent;border-bottom:.3em solid;border-left:.3em solid transparent}.dropup .dropdown-toggle:empty::after{margin-left:0}.dropright .dropdown-menu{top:0;right:auto;left:100%;margin-top:0;margin-left:.125rem}.dropright .dropdown-toggle::after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:"";border-top:.3em solid transparent;border-right:0;border-bottom:.3em solid transparent;border-left:.3em solid}.dropright .dropdown-toggle:empty::after{margin-left:0}.dropright .dropdown-toggle::after{vertical-align:0}.dropleft .dropdown-menu{top:0;right:100%;left:auto;margin-top:0;margin-right:.125rem}.dropleft .dropdown-toggle::after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:""}.dropleft .dropdown-toggle::after{display:none}.dropleft .dropdown-toggle::before{display:inline-block;margin-right:.255em;vertical-align:.255em;content:"";border-top:.3em solid transparent;border-right:.3em solid;border-bottom:.3em solid transparent}.dropleft .dropdown-toggle:empty::after{margin-left:0}.dropleft .dropdown-toggle::before{vertical-align:0}.dropdown-menu[x-placement^=bottom],.dropdown-menu[x-placement^=left],.dropdown-menu[x-placement^=right],.dropdown-menu[x-placement^=top]{right:auto;bottom:auto}.dropdown-divider{height:0;margin:.5rem 0;overflow:hidden;border-top:1px solid #e9ecef}.dropdown-item{display:block;width:100%;padding:.25rem 1.5rem;clear:both;font-weight:400;color:#212529;text-align:inherit;white-space:nowrap;background-color:transparent;border:0}.dropdown-item:focus,.dropdown-item:hover{color:#16181b;text-decoration:none;background-color:#f8f9fa}.dropdown-item.active,.dropdown-item:active{color:#fff;text-decoration:none;background-color:#007bff}.dropdown-item.disabled,.dropdown-item:disabled{color:#6c757d;pointer-events:none;background-color:transparent}.dropdown-menu.show{display:block}.dropdown-header{display:block;padding:.5rem 1.5rem;margin-bottom:0;font-size:.875rem;color:#6c757d;white-space:nowrap}.dropdown-item-text{display:block;padding:.25rem 1.5rem;color:#212529}.btn-group,.btn-group-vertical{position:relative;display:-ms-inline-flexbox;display:inline-flex;vertical-align:middle}.btn-group-vertical>.btn,.btn-group>.btn{position:relative;-ms-flex:1 1 auto;flex:1 1 auto}.btn-group-vertical>.btn:hover,.btn-group>.btn:hover{z-index:1}.btn-group-vertical>.btn.active,.btn-group-vertical>.btn:active,.btn-group-vertical>.btn:focus,.btn-group>.btn.active,.btn-group>.btn:active,.btn-group>.btn:focus{z-index:1}.btn-toolbar{display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;-ms-flex-pack:start;justify-content:flex-start}.btn-toolbar .input-group{width:auto}.btn-group>.btn-group:not(:first-child),.btn-group>.btn:not(:first-child){margin-left:-1px}.btn-group>.btn-group:not(:last-child)>.btn,.btn-group>.btn:not(:last-child):not(.dropdown-toggle){border-top-right-radius:0;border-bottom-right-radius:0}.btn-group>.btn-group:not(:first-child)>.btn,.btn-group>.btn:not(:first-child){border-top-left-radius:0;border-bottom-left-radius:0}.dropdown-toggle-split{padding-right:.5625rem;padding-left:.5625rem}.dropdown-toggle-split::after,.dropright .dropdown-toggle-split::after,.dropup .dropdown-toggle-split::after{margin-left:0}.dropleft .dropdown-toggle-split::before{margin-right:0}.btn-group-sm>.btn+.dropdown-toggle-split,.btn-sm+.dropdown-toggle-split{padding-right:.375rem;padding-left:.375rem}.btn-group-lg>.btn+.dropdown-toggle-split,.btn-lg+.dropdown-toggle-split{padding-right:.75rem;padding-left:.75rem}.btn-group-vertical{-ms-flex-direction:column;flex-direction:column;-ms-flex-align:start;align-items:flex-start;-ms-flex-pack:center;justify-content:center}.btn-group-vertical>.btn,.btn-group-vertical>.btn-group{width:100%}.btn-group-vertical>.btn-group:not(:first-child),.btn-group-vertical>.btn:not(:first-child){margin-top:-1px}.btn-group-vertical>.btn-group:not(:last-child)>.btn,.btn-group-vertical>.btn:not(:last-child):not(.dropdown-toggle){border-bottom-right-radius:0;border-bottom-left-radius:0}.btn-group-vertical>.btn-group:not(:first-child)>.btn,.btn-group-vertical>.btn:not(:first-child){border-top-left-radius:0;border-top-right-radius:0}.btn-group-toggle>.btn,.btn-group-toggle>.btn-group>.btn{margin-bottom:0}.btn-group-toggle>.btn input[type=checkbox],.btn-group-toggle>.btn input[type=radio],.btn-group-toggle>.btn-group>.btn input[type=checkbox],.btn-group-toggle>.btn-group>.btn input[type=radio]{position:absolute;clip:rect(0,0,0,0);pointer-events:none}.input-group{position:relative;display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;-ms-flex-align:stretch;align-items:stretch;width:100%}.input-group>.custom-file,.input-group>.custom-select,.input-group>.form-control,.input-group>.form-control-plaintext{position:relative;-ms-flex:1 1 auto;flex:1 1 auto;width:1%;margin-bottom:0}.input-group>.custom-file+.custom-file,.input-group>.custom-file+.custom-select,.input-group>.custom-file+.form-control,.input-group>.custom-select+.custom-file,.input-group>.custom-select+.custom-select,.input-group>.custom-select+.form-control,.input-group>.form-control+.custom-file,.input-group>.form-control+.custom-select,.input-group>.form-control+.form-control,.input-group>.form-control-plaintext+.custom-file,.input-group>.form-control-plaintext+.custom-select,.input-group>.form-control-plaintext+.form-control{margin-left:-1px}.input-group>.custom-file .custom-file-input:focus~.custom-file-label,.input-group>.custom-select:focus,.input-group>.form-control:focus{z-index:3}.input-group>.custom-file .custom-file-input:focus{z-index:4}.input-group>.custom-select:not(:last-child),.input-group>.form-control:not(:last-child){border-top-right-radius:0;border-bottom-right-radius:0}.input-group>.custom-select:not(:first-child),.input-group>.form-control:not(:first-child){border-top-left-radius:0;border-bottom-left-radius:0}.input-group>.custom-file{display:-ms-flexbox;display:flex;-ms-flex-align:center;align-items:center}.input-group>.custom-file:not(:last-child) .custom-file-label,.input-group>.custom-file:not(:last-child) .custom-file-label::after{border-top-right-radius:0;border-bottom-right-radius:0}.input-group>.custom-file:not(:first-child) .custom-file-label{border-top-left-radius:0;border-bottom-left-radius:0}.input-group-append,.input-group-prepend{display:-ms-flexbox;display:flex}.input-group-append .btn,.input-group-prepend .btn{position:relative;z-index:2}.input-group-append .btn:focus,.input-group-prepend .btn:focus{z-index:3}.input-group-append .btn+.btn,.input-group-append .btn+.input-group-text,.input-group-append .input-group-text+.btn,.input-group-append .input-group-text+.input-group-text,.input-group-prepend .btn+.btn,.input-group-prepend .btn+.input-group-text,.input-group-prepend .input-group-text+.btn,.input-group-prepend .input-group-text+.input-group-text{margin-left:-1px}.input-group-prepend{margin-right:-1px}.input-group-append{margin-left:-1px}.input-group-text{display:-ms-flexbox;display:flex;-ms-flex-align:center;align-items:center;padding:.375rem .75rem;margin-bottom:0;font-size:1rem;font-weight:400;line-height:1.5;color:#495057;text-align:center;white-space:nowrap;background-color:#e9ecef;border:1px solid #ced4da;border-radius:.25rem}.input-group-text input[type=checkbox],.input-group-text input[type=radio]{margin-top:0}.input-group-lg>.custom-select,.input-group-lg>.form-control:not(textarea){height:calc(1.5em + 1rem + 2px)}.input-group-lg>.custom-select,.input-group-lg>.form-control,.input-group-lg>.input-group-append>.btn,.input-group-lg>.input-group-append>.input-group-text,.input-group-lg>.input-group-prepend>.btn,.input-group-lg>.input-group-prepend>.input-group-text{padding:.5rem 1rem;font-size:1.25rem;line-height:1.5;border-radius:.3rem}.input-group-sm>.custom-select,.input-group-sm>.form-control:not(textarea){height:calc(1.5em + .5rem + 2px)}.input-group-sm>.custom-select,.input-group-sm>.form-control,.input-group-sm>.input-group-append>.btn,.input-group-sm>.input-group-append>.input-group-text,.input-group-sm>.input-group-prepend>.btn,.input-group-sm>.input-group-prepend>.input-group-text{padding:.25rem .5rem;font-size:.875rem;line-height:1.5;border-radius:.2rem}.input-group-lg>.custom-select,.input-group-sm>.custom-select{padding-right:1.75rem}.input-group>.input-group-append:last-child>.btn:not(:last-child):not(.dropdown-toggle),.input-group>.input-group-append:last-child>.input-group-text:not(:last-child),.input-group>.input-group-append:not(:last-child)>.btn,.input-group>.input-group-append:not(:last-child)>.input-group-text,.input-group>.input-group-prepend>.btn,.input-group>.input-group-prepend>.input-group-text{border-top-right-radius:0;border-bottom-right-radius:0}.input-group>.input-group-append>.btn,.input-group>.input-group-append>.input-group-text,.input-group>.input-group-prepend:first-child>.btn:not(:first-child),.input-group>.input-group-prepend:first-child>.input-group-text:not(:first-child),.input-group>.input-group-prepend:not(:first-child)>.btn,.input-group>.input-group-prepend:not(:first-child)>.input-group-text{border-top-left-radius:0;border-bottom-left-radius:0}.custom-control{position:relative;display:block;min-height:1.5rem;padding-left:1.5rem}.custom-control-inline{display:-ms-inline-flexbox;display:inline-flex;margin-right:1rem}.custom-control-input{position:absolute;z-index:-1;opacity:0}.custom-control-input:checked~.custom-control-label::before{color:#fff;border-color:#007bff;background-color:#007bff}.custom-control-input:focus~.custom-control-label::before{box-shadow:0 0 0 .2rem rgba(0,123,255,.25)}.custom-control-input:focus:not(:checked)~.custom-control-label::before{border-color:#80bdff}.custom-control-input:not(:disabled):active~.custom-control-label::before{color:#fff;background-color:#b3d7ff;border-color:#b3d7ff}.custom-control-input:disabled~.custom-control-label{color:#6c757d}.custom-control-input:disabled~.custom-control-label::before{background-color:#e9ecef}.custom-control-label{position:relative;margin-bottom:0;vertical-align:top}.custom-control-label::before{position:absolute;top:.25rem;left:-1.5rem;display:block;width:1rem;height:1rem;pointer-events:none;content:"";background-color:#fff;border:#adb5bd solid 1px}.custom-control-label::after{position:absolute;top:.25rem;left:-1.5rem;display:block;width:1rem;height:1rem;content:"";background:no-repeat 50%/50% 50%}.custom-checkbox .custom-control-label::before{border-radius:.25rem}.custom-checkbox .custom-control-input:checked~.custom-control-label::after{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 8 8'%3e%3cpath fill='%23fff' d='M6.564.75l-3.59 3.612-1.538-1.55L0 4.26 2.974 7.25 8 2.193z'/%3e%3c/svg%3e")}.custom-checkbox .custom-control-input:indeterminate~.custom-control-label::before{border-color:#007bff;background-color:#007bff}.custom-checkbox .custom-control-input:indeterminate~.custom-control-label::after{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 4 4'%3e%3cpath stroke='%23fff' d='M0 2h4'/%3e%3c/svg%3e")}.custom-checkbox .custom-control-input:disabled:checked~.custom-control-label::before{background-color:rgba(0,123,255,.5)}.custom-checkbox .custom-control-input:disabled:indeterminate~.custom-control-label::before{background-color:rgba(0,123,255,.5)}.custom-radio .custom-control-label::before{border-radius:50%}.custom-radio .custom-control-input:checked~.custom-control-label::after{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='-4 -4 8 8'%3e%3ccircle r='3' fill='%23fff'/%3e%3c/svg%3e")}.custom-radio .custom-control-input:disabled:checked~.custom-control-label::before{background-color:rgba(0,123,255,.5)}.custom-switch{padding-left:2.25rem}.custom-switch .custom-control-label::before{left:-2.25rem;width:1.75rem;pointer-events:all;border-radius:.5rem}.custom-switch .custom-control-label::after{top:calc(.25rem + 2px);left:calc(-2.25rem + 2px);width:calc(1rem - 4px);height:calc(1rem - 4px);background-color:#adb5bd;border-radius:.5rem;transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out,-webkit-transform .15s ease-in-out;transition:transform .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;transition:transform .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out,-webkit-transform .15s ease-in-out}@media (prefers-reduced-motion:reduce){.custom-switch .custom-control-label::after{transition:none}}.custom-switch .custom-control-input:checked~.custom-control-label::after{background-color:#fff;-webkit-transform:translateX(.75rem);transform:translateX(.75rem)}.custom-switch .custom-control-input:disabled:checked~.custom-control-label::before{background-color:rgba(0,123,255,.5)}.custom-select{display:inline-block;width:100%;height:calc(1.5em + .75rem + 2px);padding:.375rem 1.75rem .375rem .75rem;font-size:1rem;font-weight:400;line-height:1.5;color:#495057;vertical-align:middle;background:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 4 5'%3e%3cpath fill='%23343a40' d='M2 0L0 2h4zm0 5L0 3h4z'/%3e%3c/svg%3e") no-repeat right .75rem center/8px 10px;background-color:#fff;border:1px solid #ced4da;border-radius:.25rem;-webkit-appearance:none;-moz-appearance:none;appearance:none}.custom-select:focus{border-color:#80bdff;outline:0;box-shadow:0 0 0 .2rem rgba(0,123,255,.25)}.custom-select:focus::-ms-value{color:#495057;background-color:#fff}.custom-select[multiple],.custom-select[size]:not([size="1"]){height:auto;padding-right:.75rem;background-image:none}.custom-select:disabled{color:#6c757d;background-color:#e9ecef}.custom-select::-ms-expand{display:none}.custom-select-sm{height:calc(1.5em + .5rem + 2px);padding-top:.25rem;padding-bottom:.25rem;padding-left:.5rem;font-size:.875rem}.custom-select-lg{height:calc(1.5em + 1rem + 2px);padding-top:.5rem;padding-bottom:.5rem;padding-left:1rem;font-size:1.25rem}.custom-file{position:relative;display:inline-block;width:100%;height:calc(1.5em + .75rem + 2px);margin-bottom:0}.custom-file-input{position:relative;z-index:2;width:100%;height:calc(1.5em + .75rem + 2px);margin:0;opacity:0}.custom-file-input:focus~.custom-file-label{border-color:#80bdff;box-shadow:0 0 0 .2rem rgba(0,123,255,.25)}.custom-file-input:disabled~.custom-file-label{background-color:#e9ecef}.custom-file-input:lang(en)~.custom-file-label::after{content:"Browse"}.custom-file-input~.custom-file-label[data-browse]::after{content:attr(data-browse)}.custom-file-label{position:absolute;top:0;right:0;left:0;z-index:1;height:calc(1.5em + .75rem + 2px);padding:.375rem .75rem;font-weight:400;line-height:1.5;color:#495057;background-color:#fff;border:1px solid #ced4da;border-radius:.25rem}.custom-file-label::after{position:absolute;top:0;right:0;bottom:0;z-index:3;display:block;height:calc(1.5em + .75rem);padding:.375rem .75rem;line-height:1.5;color:#495057;content:"Browse";background-color:#e9ecef;border-left:inherit;border-radius:0 .25rem .25rem 0}.custom-range{width:100%;height:calc(1rem + .4rem);padding:0;background-color:transparent;-webkit-appearance:none;-moz-appearance:none;appearance:none}.custom-range:focus{outline:0}.custom-range:focus::-webkit-slider-thumb{box-shadow:0 0 0 1px #fff,0 0 0 .2rem rgba(0,123,255,.25)}.custom-range:focus::-moz-range-thumb{box-shadow:0 0 0 1px #fff,0 0 0 .2rem rgba(0,123,255,.25)}.custom-range:focus::-ms-thumb{box-shadow:0 0 0 1px #fff,0 0 0 .2rem rgba(0,123,255,.25)}.custom-range::-moz-focus-outer{border:0}.custom-range::-webkit-slider-thumb{width:1rem;height:1rem;margin-top:-.25rem;background-color:#007bff;border:0;border-radius:1rem;transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;-webkit-appearance:none;appearance:none}@media (prefers-reduced-motion:reduce){.custom-range::-webkit-slider-thumb{transition:none}}.custom-range::-webkit-slider-thumb:active{background-color:#b3d7ff}.custom-range::-webkit-slider-runnable-track{width:100%;height:.5rem;color:transparent;cursor:pointer;background-color:#dee2e6;border-color:transparent;border-radius:1rem}.custom-range::-moz-range-thumb{width:1rem;height:1rem;background-color:#007bff;border:0;border-radius:1rem;transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;-moz-appearance:none;appearance:none}@media (prefers-reduced-motion:reduce){.custom-range::-moz-range-thumb{transition:none}}.custom-range::-moz-range-thumb:active{background-color:#b3d7ff}.custom-range::-moz-range-track{width:100%;height:.5rem;color:transparent;cursor:pointer;background-color:#dee2e6;border-color:transparent;border-radius:1rem}.custom-range::-ms-thumb{width:1rem;height:1rem;margin-top:0;margin-right:.2rem;margin-left:.2rem;background-color:#007bff;border:0;border-radius:1rem;transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;appearance:none}@media (prefers-reduced-motion:reduce){.custom-range::-ms-thumb{transition:none}}.custom-range::-ms-thumb:active{background-color:#b3d7ff}.custom-range::-ms-track{width:100%;height:.5rem;color:transparent;cursor:pointer;background-color:transparent;border-color:transparent;border-width:.5rem}.custom-range::-ms-fill-lower{background-color:#dee2e6;border-radius:1rem}.custom-range::-ms-fill-upper{margin-right:15px;background-color:#dee2e6;border-radius:1rem}.custom-range:disabled::-webkit-slider-thumb{background-color:#adb5bd}.custom-range:disabled::-webkit-slider-runnable-track{cursor:default}.custom-range:disabled::-moz-range-thumb{background-color:#adb5bd}.custom-range:disabled::-moz-range-track{cursor:default}.custom-range:disabled::-ms-thumb{background-color:#adb5bd}.custom-control-label::before,.custom-file-label,.custom-select{transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.custom-control-label::before,.custom-file-label,.custom-select{transition:none}}.nav{display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;padding-left:0;margin-bottom:0;list-style:none}.nav-link{display:block;padding:.5rem 1rem}.nav-link:focus,.nav-link:hover{text-decoration:none}.nav-link.disabled{color:#6c757d;pointer-events:none;cursor:default}.nav-tabs{border-bottom:1px solid #dee2e6}.nav-tabs .nav-item{margin-bottom:-1px}.nav-tabs .nav-link{border:1px solid transparent;border-top-left-radius:.25rem;border-top-right-radius:.25rem}.nav-tabs .nav-link:focus,.nav-tabs .nav-link:hover{border-color:#e9ecef #e9ecef #dee2e6}.nav-tabs .nav-link.disabled{color:#6c757d;background-color:transparent;border-color:transparent}.nav-tabs .nav-item.show .nav-link,.nav-tabs .nav-link.active{color:#495057;background-color:#fff;border-color:#dee2e6 #dee2e6 #fff}.nav-tabs .dropdown-menu{margin-top:-1px;border-top-left-radius:0;border-top-right-radius:0}.nav-pills .nav-link{border-radius:.25rem}.nav-pills .nav-link.active,.nav-pills .show>.nav-link{color:#fff;background-color:#007bff}.nav-fill .nav-item{-ms-flex:1 1 auto;flex:1 1 auto;text-align:center}.nav-justified .nav-item{-ms-flex-preferred-size:0;flex-basis:0;-ms-flex-positive:1;flex-grow:1;text-align:center}.tab-content>.tab-pane{display:none}.tab-content>.active{display:block}.navbar{position:relative;display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;-ms-flex-align:center;align-items:center;-ms-flex-pack:justify;justify-content:space-between;padding:.5rem 1rem}.navbar>.container,.navbar>.container-fluid{display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;-ms-flex-align:center;align-items:center;-ms-flex-pack:justify;justify-content:space-between}.navbar-brand{display:inline-block;padding-top:.3125rem;padding-bottom:.3125rem;margin-right:1rem;font-size:1.25rem;line-height:inherit;white-space:nowrap}.navbar-brand:focus,.navbar-brand:hover{text-decoration:none}.navbar-nav{display:-ms-flexbox;display:flex;-ms-flex-direction:column;flex-direction:column;padding-left:0;margin-bottom:0;list-style:none}.navbar-nav .nav-link{padding-right:0;padding-left:0}.navbar-nav .dropdown-menu{position:static;float:none}.navbar-text{display:inline-block;padding-top:.5rem;padding-bottom:.5rem}.navbar-collapse{-ms-flex-preferred-size:100%;flex-basis:100%;-ms-flex-positive:1;flex-grow:1;-ms-flex-align:center;align-items:center}.navbar-toggler{padding:.25rem .75rem;font-size:1.25rem;line-height:1;background-color:transparent;border:1px solid transparent;border-radius:.25rem}.navbar-toggler:focus,.navbar-toggler:hover{text-decoration:none}.navbar-toggler-icon{display:inline-block;width:1.5em;height:1.5em;vertical-align:middle;content:"";background:no-repeat center center;background-size:100% 100%}@media (max-width:575.98px){.navbar-expand-sm>.container,.navbar-expand-sm>.container-fluid{padding-right:0;padding-left:0}}@media (min-width:576px){.navbar-expand-sm{-ms-flex-flow:row nowrap;flex-flow:row nowrap;-ms-flex-pack:start;justify-content:flex-start}.navbar-expand-sm .navbar-nav{-ms-flex-direction:row;flex-direction:row}.navbar-expand-sm .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-sm .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand-sm>.container,.navbar-expand-sm>.container-fluid{-ms-flex-wrap:nowrap;flex-wrap:nowrap}.navbar-expand-sm .navbar-collapse{display:-ms-flexbox!important;display:flex!important;-ms-flex-preferred-size:auto;flex-basis:auto}.navbar-expand-sm .navbar-toggler{display:none}}@media (max-width:767.98px){.navbar-expand-md>.container,.navbar-expand-md>.container-fluid{padding-right:0;padding-left:0}}@media (min-width:768px){.navbar-expand-md{-ms-flex-flow:row nowrap;flex-flow:row nowrap;-ms-flex-pack:start;justify-content:flex-start}.navbar-expand-md .navbar-nav{-ms-flex-direction:row;flex-direction:row}.navbar-expand-md .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-md .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand-md>.container,.navbar-expand-md>.container-fluid{-ms-flex-wrap:nowrap;flex-wrap:nowrap}.navbar-expand-md .navbar-collapse{display:-ms-flexbox!important;display:flex!important;-ms-flex-preferred-size:auto;flex-basis:auto}.navbar-expand-md .navbar-toggler{display:none}}@media (max-width:991.98px){.navbar-expand-lg>.container,.navbar-expand-lg>.container-fluid{padding-right:0;padding-left:0}}@media (min-width:992px){.navbar-expand-lg{-ms-flex-flow:row nowrap;flex-flow:row nowrap;-ms-flex-pack:start;justify-content:flex-start}.navbar-expand-lg .navbar-nav{-ms-flex-direction:row;flex-direction:row}.navbar-expand-lg .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-lg .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand-lg>.container,.navbar-expand-lg>.container-fluid{-ms-flex-wrap:nowrap;flex-wrap:nowrap}.navbar-expand-lg .navbar-collapse{display:-ms-flexbox!important;display:flex!important;-ms-flex-preferred-size:auto;flex-basis:auto}.navbar-expand-lg .navbar-toggler{display:none}}@media (max-width:1199.98px){.navbar-expand-xl>.container,.navbar-expand-xl>.container-fluid{padding-right:0;padding-left:0}}@media (min-width:1200px){.navbar-expand-xl{-ms-flex-flow:row nowrap;flex-flow:row nowrap;-ms-flex-pack:start;justify-content:flex-start}.navbar-expand-xl .navbar-nav{-ms-flex-direction:row;flex-direction:row}.navbar-expand-xl .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-xl .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand-xl>.container,.navbar-expand-xl>.container-fluid{-ms-flex-wrap:nowrap;flex-wrap:nowrap}.navbar-expand-xl .navbar-collapse{display:-ms-flexbox!important;display:flex!important;-ms-flex-preferred-size:auto;flex-basis:auto}.navbar-expand-xl .navbar-toggler{display:none}}.navbar-expand{-ms-flex-flow:row nowrap;flex-flow:row nowrap;-ms-flex-pack:start;justify-content:flex-start}.navbar-expand>.container,.navbar-expand>.container-fluid{padding-right:0;padding-left:0}.navbar-expand .navbar-nav{-ms-flex-direction:row;flex-direction:row}.navbar-expand .navbar-nav .dropdown-menu{position:absolute}.navbar-expand .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand>.container,.navbar-expand>.container-fluid{-ms-flex-wrap:nowrap;flex-wrap:nowrap}.navbar-expand .navbar-collapse{display:-ms-flexbox!important;display:flex!important;-ms-flex-preferred-size:auto;flex-basis:auto}.navbar-expand .navbar-toggler{display:none}.navbar-light .navbar-brand{color:rgba(0,0,0,.9)}.navbar-light .navbar-brand:focus,.navbar-light .navbar-brand:hover{color:rgba(0,0,0,.9)}.navbar-light .navbar-nav .nav-link{color:rgba(0,0,0,.5)}.navbar-light .navbar-nav .nav-link:focus,.navbar-light .navbar-nav .nav-link:hover{color:rgba(0,0,0,.7)}.navbar-light .navbar-nav .nav-link.disabled{color:rgba(0,0,0,.3)}.navbar-light .navbar-nav .active>.nav-link,.navbar-light .navbar-nav .nav-link.active,.navbar-light .navbar-nav .nav-link.show,.navbar-light .navbar-nav .show>.nav-link{color:rgba(0,0,0,.9)}.navbar-light .navbar-toggler{color:rgba(0,0,0,.5);border-color:rgba(0,0,0,.1)}.navbar-light .navbar-toggler-icon{background-image:url("data:image/svg+xml,%3csvg viewBox='0 0 30 30' xmlns='http://www.w3.org/2000/svg'%3e%3cpath stroke='rgba(0, 0, 0, 0.5)' stroke-width='2' stroke-linecap='round' stroke-miterlimit='10' d='M4 7h22M4 15h22M4 23h22'/%3e%3c/svg%3e")}.navbar-light .navbar-text{color:rgba(0,0,0,.5)}.navbar-light .navbar-text a{color:rgba(0,0,0,.9)}.navbar-light .navbar-text a:focus,.navbar-light .navbar-text a:hover{color:rgba(0,0,0,.9)}.navbar-dark .navbar-brand{color:#fff}.navbar-dark .navbar-brand:focus,.navbar-dark .navbar-brand:hover{color:#fff}.navbar-dark .navbar-nav .nav-link{color:rgba(255,255,255,.5)}.navbar-dark .navbar-nav .nav-link:focus,.navbar-dark .navbar-nav .nav-link:hover{color:rgba(255,255,255,.75)}.navbar-dark .navbar-nav .nav-link.disabled{color:rgba(255,255,255,.25)}.navbar-dark .navbar-nav .active>.nav-link,.navbar-dark .navbar-nav .nav-link.active,.navbar-dark .navbar-nav .nav-link.show,.navbar-dark .navbar-nav .show>.nav-link{color:#fff}.navbar-dark .navbar-toggler{color:rgba(255,255,255,.5);border-color:rgba(255,255,255,.1)}.navbar-dark .navbar-toggler-icon{background-image:url("data:image/svg+xml,%3csvg viewBox='0 0 30 30' xmlns='http://www.w3.org/2000/svg'%3e%3cpath stroke='rgba(255, 255, 255, 0.5)' stroke-width='2' stroke-linecap='round' stroke-miterlimit='10' d='M4 7h22M4 15h22M4 23h22'/%3e%3c/svg%3e")}.navbar-dark .navbar-text{color:rgba(255,255,255,.5)}.navbar-dark .navbar-text a{color:#fff}.navbar-dark .navbar-text a:focus,.navbar-dark .navbar-text a:hover{color:#fff}.card{position:relative;display:-ms-flexbox;display:flex;-ms-flex-direction:column;flex-direction:column;min-width:0;word-wrap:break-word;background-color:#fff;background-clip:border-box;border:1px solid rgba(0,0,0,.125);border-radius:.25rem}.card>hr{margin-right:0;margin-left:0}.card>.list-group:first-child .list-group-item:first-child{border-top-left-radius:.25rem;border-top-right-radius:.25rem}.card>.list-group:last-child .list-group-item:last-child{border-bottom-right-radius:.25rem;border-bottom-left-radius:.25rem}.card-body{-ms-flex:1 1 auto;flex:1 1 auto;padding:1.25rem}.card-title{margin-bottom:.75rem}.card-subtitle{margin-top:-.375rem;margin-bottom:0}.card-text:last-child{margin-bottom:0}.card-link:hover{text-decoration:none}.card-link+.card-link{margin-left:1.25rem}.card-header{padding:.75rem 1.25rem;margin-bottom:0;background-color:rgba(0,0,0,.03);border-bottom:1px solid rgba(0,0,0,.125)}.card-header:first-child{border-radius:calc(.25rem - 1px) calc(.25rem - 1px) 0 0}.card-header+.list-group .list-group-item:first-child{border-top:0}.card-footer{padding:.75rem 1.25rem;background-color:rgba(0,0,0,.03);border-top:1px solid rgba(0,0,0,.125)}.card-footer:last-child{border-radius:0 0 calc(.25rem - 1px) calc(.25rem - 1px)}.card-header-tabs{margin-right:-.625rem;margin-bottom:-.75rem;margin-left:-.625rem;border-bottom:0}.card-header-pills{margin-right:-.625rem;margin-left:-.625rem}.card-img-overlay{position:absolute;top:0;right:0;bottom:0;left:0;padding:1.25rem}.card-img{width:100%;border-radius:calc(.25rem - 1px)}.card-img-top{width:100%;border-top-left-radius:calc(.25rem - 1px);border-top-right-radius:calc(.25rem - 1px)}.card-img-bottom{width:100%;border-bottom-right-radius:calc(.25rem - 1px);border-bottom-left-radius:calc(.25rem - 1px)}.card-deck{display:-ms-flexbox;display:flex;-ms-flex-direction:column;flex-direction:column}.card-deck .card{margin-bottom:15px}@media (min-width:576px){.card-deck{-ms-flex-flow:row wrap;flex-flow:row wrap;margin-right:-15px;margin-left:-15px}.card-deck .card{display:-ms-flexbox;display:flex;-ms-flex:1 0 0%;flex:1 0 0%;-ms-flex-direction:column;flex-direction:column;margin-right:15px;margin-bottom:0;margin-left:15px}}.card-group{display:-ms-flexbox;display:flex;-ms-flex-direction:column;flex-direction:column}.card-group>.card{margin-bottom:15px}@media (min-width:576px){.card-group{-ms-flex-flow:row wrap;flex-flow:row wrap}.card-group>.card{-ms-flex:1 0 0%;flex:1 0 0%;margin-bottom:0}.card-group>.card+.card{margin-left:0;border-left:0}.card-group>.card:not(:last-child){border-top-right-radius:0;border-bottom-right-radius:0}.card-group>.card:not(:last-child) .card-header,.card-group>.card:not(:last-child) .card-img-top{border-top-right-radius:0}.card-group>.card:not(:last-child) .card-footer,.card-group>.card:not(:last-child) .card-img-bottom{border-bottom-right-radius:0}.card-group>.card:not(:first-child){border-top-left-radius:0;border-bottom-left-radius:0}.card-group>.card:not(:first-child) .card-header,.card-group>.card:not(:first-child) .card-img-top{border-top-left-radius:0}.card-group>.card:not(:first-child) .card-footer,.card-group>.card:not(:first-child) .card-img-bottom{border-bottom-left-radius:0}}.card-columns .card{margin-bottom:.75rem}@media (min-width:576px){.card-columns{-webkit-column-count:3;-moz-column-count:3;column-count:3;-webkit-column-gap:1.25rem;-moz-column-gap:1.25rem;column-gap:1.25rem;orphans:1;widows:1}.card-columns .card{display:inline-block;width:100%}}.accordion>.card{overflow:hidden}.accordion>.card:not(:first-of-type) .card-header:first-child{border-radius:0}.accordion>.card:not(:first-of-type):not(:last-of-type){border-bottom:0;border-radius:0}.accordion>.card:first-of-type{border-bottom:0;border-bottom-right-radius:0;border-bottom-left-radius:0}.accordion>.card:last-of-type{border-top-left-radius:0;border-top-right-radius:0}.accordion>.card .card-header{margin-bottom:-1px}.breadcrumb{display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;padding:.75rem 1rem;margin-bottom:1rem;list-style:none;background-color:#e9ecef;border-radius:.25rem}.breadcrumb-item+.breadcrumb-item{padding-left:.5rem}.breadcrumb-item+.breadcrumb-item::before{display:inline-block;padding-right:.5rem;color:#6c757d;content:"/"}.breadcrumb-item+.breadcrumb-item:hover::before{text-decoration:underline}.breadcrumb-item+.breadcrumb-item:hover::before{text-decoration:none}.breadcrumb-item.active{color:#6c757d}.pagination{display:-ms-flexbox;display:flex;padding-left:0;list-style:none;border-radius:.25rem}.page-link{position:relative;display:block;padding:.5rem .75rem;margin-left:-1px;line-height:1.25;color:#007bff;background-color:#fff;border:1px solid #dee2e6}.page-link:hover{z-index:2;color:#0056b3;text-decoration:none;background-color:#e9ecef;border-color:#dee2e6}.page-link:focus{z-index:2;outline:0;box-shadow:0 0 0 .2rem rgba(0,123,255,.25)}.page-item:first-child .page-link{margin-left:0;border-top-left-radius:.25rem;border-bottom-left-radius:.25rem}.page-item:last-child .page-link{border-top-right-radius:.25rem;border-bottom-right-radius:.25rem}.page-item.active .page-link{z-index:1;color:#fff;background-color:#007bff;border-color:#007bff}.page-item.disabled .page-link{color:#6c757d;pointer-events:none;cursor:auto;background-color:#fff;border-color:#dee2e6}.pagination-lg .page-link{padding:.75rem 1.5rem;font-size:1.25rem;line-height:1.5}.pagination-lg .page-item:first-child .page-link{border-top-left-radius:.3rem;border-bottom-left-radius:.3rem}.pagination-lg .page-item:last-child .page-link{border-top-right-radius:.3rem;border-bottom-right-radius:.3rem}.pagination-sm .page-link{padding:.25rem .5rem;font-size:.875rem;line-height:1.5}.pagination-sm .page-item:first-child .page-link{border-top-left-radius:.2rem;border-bottom-left-radius:.2rem}.pagination-sm .page-item:last-child .page-link{border-top-right-radius:.2rem;border-bottom-right-radius:.2rem}.badge{display:inline-block;padding:.25em .4em;font-size:75%;font-weight:700;line-height:1;text-align:center;white-space:nowrap;vertical-align:baseline;border-radius:.25rem;transition:color .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.badge{transition:none}}a.badge:focus,a.badge:hover{text-decoration:none}.badge:empty{display:none}.btn .badge{position:relative;top:-1px}.badge-pill{padding-right:.6em;padding-left:.6em;border-radius:10rem}.badge-primary{color:#fff;background-color:#007bff}a.badge-primary:focus,a.badge-primary:hover{color:#fff;background-color:#0062cc}a.badge-primary.focus,a.badge-primary:focus{outline:0;box-shadow:0 0 0 .2rem rgba(0,123,255,.5)}.badge-secondary{color:#fff;background-color:#6c757d}a.badge-secondary:focus,a.badge-secondary:hover{color:#fff;background-color:#545b62}a.badge-secondary.focus,a.badge-secondary:focus{outline:0;box-shadow:0 0 0 .2rem rgba(108,117,125,.5)}.badge-success{color:#fff;background-color:#28a745}a.badge-success:focus,a.badge-success:hover{color:#fff;background-color:#1e7e34}a.badge-success.focus,a.badge-success:focus{outline:0;box-shadow:0 0 0 .2rem rgba(40,167,69,.5)}.badge-info{color:#fff;background-color:#17a2b8}a.badge-info:focus,a.badge-info:hover{color:#fff;background-color:#117a8b}a.badge-info.focus,a.badge-info:focus{outline:0;box-shadow:0 0 0 .2rem rgba(23,162,184,.5)}.badge-warning{color:#212529;background-color:#ffc107}a.badge-warning:focus,a.badge-warning:hover{color:#212529;background-color:#d39e00}a.badge-warning.focus,a.badge-warning:focus{outline:0;box-shadow:0 0 0 .2rem rgba(255,193,7,.5)}.badge-danger{color:#fff;background-color:#dc3545}a.badge-danger:focus,a.badge-danger:hover{color:#fff;background-color:#bd2130}a.badge-danger.focus,a.badge-danger:focus{outline:0;box-shadow:0 0 0 .2rem rgba(220,53,69,.5)}.badge-light{color:#212529;background-color:#f8f9fa}a.badge-light:focus,a.badge-light:hover{color:#212529;background-color:#dae0e5}a.badge-light.focus,a.badge-light:focus{outline:0;box-shadow:0 0 0 .2rem rgba(248,249,250,.5)}.badge-dark{color:#fff;background-color:#343a40}a.badge-dark:focus,a.badge-dark:hover{color:#fff;background-color:#1d2124}a.badge-dark.focus,a.badge-dark:focus{outline:0;box-shadow:0 0 0 .2rem rgba(52,58,64,.5)}.jumbotron{padding:2rem 1rem;margin-bottom:2rem;background-color:#e9ecef;border-radius:.3rem}@media (min-width:576px){.jumbotron{padding:4rem 2rem}}.jumbotron-fluid{padding-right:0;padding-left:0;border-radius:0}.alert{position:relative;padding:.75rem 1.25rem;margin-bottom:1rem;border:1px solid transparent;border-radius:.25rem}.alert-heading{color:inherit}.alert-link{font-weight:700}.alert-dismissible{padding-right:4rem}.alert-dismissible .close{position:absolute;top:0;right:0;padding:.75rem 1.25rem;color:inherit}.alert-primary{color:#004085;background-color:#cce5ff;border-color:#b8daff}.alert-primary hr{border-top-color:#9fcdff}.alert-primary .alert-link{color:#002752}.alert-secondary{color:#383d41;background-color:#e2e3e5;border-color:#d6d8db}.alert-secondary hr{border-top-color:#c8cbcf}.alert-secondary .alert-link{color:#202326}.alert-success{color:#155724;background-color:#d4edda;border-color:#c3e6cb}.alert-success hr{border-top-color:#b1dfbb}.alert-success .alert-link{color:#0b2e13}.alert-info{color:#0c5460;background-color:#d1ecf1;border-color:#bee5eb}.alert-info hr{border-top-color:#abdde5}.alert-info .alert-link{color:#062c33}.alert-warning{color:#856404;background-color:#fff3cd;border-color:#ffeeba}.alert-warning hr{border-top-color:#ffe8a1}.alert-warning .alert-link{color:#533f03}.alert-danger{color:#721c24;background-color:#f8d7da;border-color:#f5c6cb}.alert-danger hr{border-top-color:#f1b0b7}.alert-danger .alert-link{color:#491217}.alert-light{color:#818182;background-color:#fefefe;border-color:#fdfdfe}.alert-light hr{border-top-color:#ececf6}.alert-light .alert-link{color:#686868}.alert-dark{color:#1b1e21;background-color:#d6d8d9;border-color:#c6c8ca}.alert-dark hr{border-top-color:#b9bbbe}.alert-dark .alert-link{color:#040505}@-webkit-keyframes progress-bar-stripes{from{background-position:1rem 0}to{background-position:0 0}}@keyframes progress-bar-stripes{from{background-position:1rem 0}to{background-position:0 0}}.progress{display:-ms-flexbox;display:flex;height:1rem;overflow:hidden;font-size:.75rem;background-color:#e9ecef;border-radius:.25rem}.progress-bar{display:-ms-flexbox;display:flex;-ms-flex-direction:column;flex-direction:column;-ms-flex-pack:center;justify-content:center;color:#fff;text-align:center;white-space:nowrap;background-color:#007bff;transition:width .6s ease}@media (prefers-reduced-motion:reduce){.progress-bar{transition:none}}.progress-bar-striped{background-image:linear-gradient(45deg,rgba(255,255,255,.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,.15) 50%,rgba(255,255,255,.15) 75%,transparent 75%,transparent);background-size:1rem 1rem}.progress-bar-animated{-webkit-animation:progress-bar-stripes 1s linear infinite;animation:progress-bar-stripes 1s linear infinite}@media (prefers-reduced-motion:reduce){.progress-bar-animated{-webkit-animation:none;animation:none}}.media{display:-ms-flexbox;display:flex;-ms-flex-align:start;align-items:flex-start}.media-body{-ms-flex:1;flex:1}.list-group{display:-ms-flexbox;display:flex;-ms-flex-direction:column;flex-direction:column;padding-left:0;margin-bottom:0}.list-group-item-action{width:100%;color:#495057;text-align:inherit}.list-group-item-action:focus,.list-group-item-action:hover{z-index:1;color:#495057;text-decoration:none;background-color:#f8f9fa}.list-group-item-action:active{color:#212529;background-color:#e9ecef}.list-group-item{position:relative;display:block;padding:.75rem 1.25rem;margin-bottom:-1px;background-color:#fff;border:1px solid rgba(0,0,0,.125)}.list-group-item:first-child{border-top-left-radius:.25rem;border-top-right-radius:.25rem}.list-group-item:last-child{margin-bottom:0;border-bottom-right-radius:.25rem;border-bottom-left-radius:.25rem}.list-group-item.disabled,.list-group-item:disabled{color:#6c757d;pointer-events:none;background-color:#fff}.list-group-item.active{z-index:2;color:#fff;background-color:#007bff;border-color:#007bff}.list-group-horizontal{-ms-flex-direction:row;flex-direction:row}.list-group-horizontal .list-group-item{margin-right:-1px;margin-bottom:0}.list-group-horizontal .list-group-item:first-child{border-top-left-radius:.25rem;border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal .list-group-item:last-child{margin-right:0;border-top-right-radius:.25rem;border-bottom-right-radius:.25rem;border-bottom-left-radius:0}@media (min-width:576px){.list-group-horizontal-sm{-ms-flex-direction:row;flex-direction:row}.list-group-horizontal-sm .list-group-item{margin-right:-1px;margin-bottom:0}.list-group-horizontal-sm .list-group-item:first-child{border-top-left-radius:.25rem;border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal-sm .list-group-item:last-child{margin-right:0;border-top-right-radius:.25rem;border-bottom-right-radius:.25rem;border-bottom-left-radius:0}}@media (min-width:768px){.list-group-horizontal-md{-ms-flex-direction:row;flex-direction:row}.list-group-horizontal-md .list-group-item{margin-right:-1px;margin-bottom:0}.list-group-horizontal-md .list-group-item:first-child{border-top-left-radius:.25rem;border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal-md .list-group-item:last-child{margin-right:0;border-top-right-radius:.25rem;border-bottom-right-radius:.25rem;border-bottom-left-radius:0}}@media (min-width:992px){.list-group-horizontal-lg{-ms-flex-direction:row;flex-direction:row}.list-group-horizontal-lg .list-group-item{margin-right:-1px;margin-bottom:0}.list-group-horizontal-lg .list-group-item:first-child{border-top-left-radius:.25rem;border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal-lg .list-group-item:last-child{margin-right:0;border-top-right-radius:.25rem;border-bottom-right-radius:.25rem;border-bottom-left-radius:0}}@media (min-width:1200px){.list-group-horizontal-xl{-ms-flex-direction:row;flex-direction:row}.list-group-horizontal-xl .list-group-item{margin-right:-1px;margin-bottom:0}.list-group-horizontal-xl .list-group-item:first-child{border-top-left-radius:.25rem;border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal-xl .list-group-item:last-child{margin-right:0;border-top-right-radius:.25rem;border-bottom-right-radius:.25rem;border-bottom-left-radius:0}}.list-group-flush .list-group-item{border-right:0;border-left:0;border-radius:0}.list-group-flush .list-group-item:last-child{margin-bottom:-1px}.list-group-flush:first-child .list-group-item:first-child{border-top:0}.list-group-flush:last-child .list-group-item:last-child{margin-bottom:0;border-bottom:0}.list-group-item-primary{color:#004085;background-color:#b8daff}.list-group-item-primary.list-group-item-action:focus,.list-group-item-primary.list-group-item-action:hover{color:#004085;background-color:#9fcdff}.list-group-item-primary.list-group-item-action.active{color:#fff;background-color:#004085;border-color:#004085}.list-group-item-secondary{color:#383d41;background-color:#d6d8db}.list-group-item-secondary.list-group-item-action:focus,.list-group-item-secondary.list-group-item-action:hover{color:#383d41;background-color:#c8cbcf}.list-group-item-secondary.list-group-item-action.active{color:#fff;background-color:#383d41;border-color:#383d41}.list-group-item-success{color:#155724;background-color:#c3e6cb}.list-group-item-success.list-group-item-action:focus,.list-group-item-success.list-group-item-action:hover{color:#155724;background-color:#b1dfbb}.list-group-item-success.list-group-item-action.active{color:#fff;background-color:#155724;border-color:#155724}.list-group-item-info{color:#0c5460;background-color:#bee5eb}.list-group-item-info.list-group-item-action:focus,.list-group-item-info.list-group-item-action:hover{color:#0c5460;background-color:#abdde5}.list-group-item-info.list-group-item-action.active{color:#fff;background-color:#0c5460;border-color:#0c5460}.list-group-item-warning{color:#856404;background-color:#ffeeba}.list-group-item-warning.list-group-item-action:focus,.list-group-item-warning.list-group-item-action:hover{color:#856404;background-color:#ffe8a1}.list-group-item-warning.list-group-item-action.active{color:#fff;background-color:#856404;border-color:#856404}.list-group-item-danger{color:#721c24;background-color:#f5c6cb}.list-group-item-danger.list-group-item-action:focus,.list-group-item-danger.list-group-item-action:hover{color:#721c24;background-color:#f1b0b7}.list-group-item-danger.list-group-item-action.active{color:#fff;background-color:#721c24;border-color:#721c24}.list-group-item-light{color:#818182;background-color:#fdfdfe}.list-group-item-light.list-group-item-action:focus,.list-group-item-light.list-group-item-action:hover{color:#818182;background-color:#ececf6}.list-group-item-light.list-group-item-action.active{color:#fff;background-color:#818182;border-color:#818182}.list-group-item-dark{color:#1b1e21;background-color:#c6c8ca}.list-group-item-dark.list-group-item-action:focus,.list-group-item-dark.list-group-item-action:hover{color:#1b1e21;background-color:#b9bbbe}.list-group-item-dark.list-group-item-action.active{color:#fff;background-color:#1b1e21;border-color:#1b1e21}.close{float:right;font-size:1.5rem;font-weight:700;line-height:1;color:#000;text-shadow:0 1px 0 #fff;opacity:.5}.close:hover{color:#000;text-decoration:none}.close:not(:disabled):not(.disabled):focus,.close:not(:disabled):not(.disabled):hover{opacity:.75}button.close{padding:0;background-color:transparent;border:0;-webkit-appearance:none;-moz-appearance:none;appearance:none}a.close.disabled{pointer-events:none}.toast{max-width:350px;overflow:hidden;font-size:.875rem;background-color:rgba(255,255,255,.85);background-clip:padding-box;border:1px solid rgba(0,0,0,.1);box-shadow:0 .25rem .75rem rgba(0,0,0,.1);-webkit-backdrop-filter:blur(10px);backdrop-filter:blur(10px);opacity:0;border-radius:.25rem}.toast:not(:last-child){margin-bottom:.75rem}.toast.showing{opacity:1}.toast.show{display:block;opacity:1}.toast.hide{display:none}.toast-header{display:-ms-flexbox;display:flex;-ms-flex-align:center;align-items:center;padding:.25rem .75rem;color:#6c757d;background-color:rgba(255,255,255,.85);background-clip:padding-box;border-bottom:1px solid rgba(0,0,0,.05)}.toast-body{padding:.75rem}.modal-open{overflow:hidden}.modal-open .modal{overflow-x:hidden;overflow-y:auto}.modal{position:fixed;top:0;left:0;z-index:1050;display:none;width:100%;height:100%;overflow:hidden;outline:0}.modal-dialog{position:relative;width:auto;margin:.5rem;pointer-events:none}.modal.fade .modal-dialog{transition:-webkit-transform .3s ease-out;transition:transform .3s ease-out;transition:transform .3s ease-out,-webkit-transform .3s ease-out;-webkit-transform:translate(0,-50px);transform:translate(0,-50px)}@media (prefers-reduced-motion:reduce){.modal.fade .modal-dialog{transition:none}}.modal.show .modal-dialog{-webkit-transform:none;transform:none}.modal-dialog-scrollable{display:-ms-flexbox;display:flex;max-height:calc(100% - 1rem)}.modal-dialog-scrollable .modal-content{max-height:calc(100vh - 1rem);overflow:hidden}.modal-dialog-scrollable .modal-footer,.modal-dialog-scrollable .modal-header{-ms-flex-negative:0;flex-shrink:0}.modal-dialog-scrollable .modal-body{overflow-y:auto}.modal-dialog-centered{display:-ms-flexbox;display:flex;-ms-flex-align:center;align-items:center;min-height:calc(100% - 1rem)}.modal-dialog-centered::before{display:block;height:calc(100vh - 1rem);content:""}.modal-dialog-centered.modal-dialog-scrollable{-ms-flex-direction:column;flex-direction:column;-ms-flex-pack:center;justify-content:center;height:100%}.modal-dialog-centered.modal-dialog-scrollable .modal-content{max-height:none}.modal-dialog-centered.modal-dialog-scrollable::before{content:none}.modal-content{position:relative;display:-ms-flexbox;display:flex;-ms-flex-direction:column;flex-direction:column;width:100%;pointer-events:auto;background-color:#fff;background-clip:padding-box;border:1px solid rgba(0,0,0,.2);border-radius:.3rem;outline:0}.modal-backdrop{position:fixed;top:0;left:0;z-index:1040;width:100vw;height:100vh;background-color:#000}.modal-backdrop.fade{opacity:0}.modal-backdrop.show{opacity:.5}.modal-header{display:-ms-flexbox;display:flex;-ms-flex-align:start;align-items:flex-start;-ms-flex-pack:justify;justify-content:space-between;padding:1rem 1rem;border-bottom:1px solid #dee2e6;border-top-left-radius:.3rem;border-top-right-radius:.3rem}.modal-header .close{padding:1rem 1rem;margin:-1rem -1rem -1rem auto}.modal-title{margin-bottom:0;line-height:1.5}.modal-body{position:relative;-ms-flex:1 1 auto;flex:1 1 auto;padding:1rem}.modal-footer{display:-ms-flexbox;display:flex;-ms-flex-align:center;align-items:center;-ms-flex-pack:end;justify-content:flex-end;padding:1rem;border-top:1px solid #dee2e6;border-bottom-right-radius:.3rem;border-bottom-left-radius:.3rem}.modal-footer>:not(:first-child){margin-left:.25rem}.modal-footer>:not(:last-child){margin-right:.25rem}.modal-scrollbar-measure{position:absolute;top:-9999px;width:50px;height:50px;overflow:scroll}@media (min-width:576px){.modal-dialog{max-width:500px;margin:1.75rem auto}.modal-dialog-scrollable{max-height:calc(100% - 3.5rem)}.modal-dialog-scrollable .modal-content{max-height:calc(100vh - 3.5rem)}.modal-dialog-centered{min-height:calc(100% - 3.5rem)}.modal-dialog-centered::before{height:calc(100vh - 3.5rem)}.modal-sm{max-width:300px}}@media (min-width:992px){.modal-lg,.modal-xl{max-width:800px}}@media (min-width:1200px){.modal-xl{max-width:1140px}}.tooltip{position:absolute;z-index:1070;display:block;margin:0;font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,"Noto Sans",sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";font-style:normal;font-weight:400;line-height:1.5;text-align:left;text-align:start;text-decoration:none;text-shadow:none;text-transform:none;letter-spacing:normal;word-break:normal;word-spacing:normal;white-space:normal;line-break:auto;font-size:.875rem;word-wrap:break-word;opacity:0}.tooltip.show{opacity:.9}.tooltip .arrow{position:absolute;display:block;width:.8rem;height:.4rem}.tooltip .arrow::before{position:absolute;content:"";border-color:transparent;border-style:solid}.bs-tooltip-auto[x-placement^=top],.bs-tooltip-top{padding:.4rem 0}.bs-tooltip-auto[x-placement^=top] .arrow,.bs-tooltip-top .arrow{bottom:0}.bs-tooltip-auto[x-placement^=top] .arrow::before,.bs-tooltip-top .arrow::before{top:0;border-width:.4rem .4rem 0;border-top-color:#000}.bs-tooltip-auto[x-placement^=right],.bs-tooltip-right{padding:0 .4rem}.bs-tooltip-auto[x-placement^=right] .arrow,.bs-tooltip-right .arrow{left:0;width:.4rem;height:.8rem}.bs-tooltip-auto[x-placement^=right] .arrow::before,.bs-tooltip-right .arrow::before{right:0;border-width:.4rem .4rem .4rem 0;border-right-color:#000}.bs-tooltip-auto[x-placement^=bottom],.bs-tooltip-bottom{padding:.4rem 0}.bs-tooltip-auto[x-placement^=bottom] .arrow,.bs-tooltip-bottom .arrow{top:0}.bs-tooltip-auto[x-placement^=bottom] .arrow::before,.bs-tooltip-bottom .arrow::before{bottom:0;border-width:0 .4rem .4rem;border-bottom-color:#000}.bs-tooltip-auto[x-placement^=left],.bs-tooltip-left{padding:0 .4rem}.bs-tooltip-auto[x-placement^=left] .arrow,.bs-tooltip-left .arrow{right:0;width:.4rem;height:.8rem}.bs-tooltip-auto[x-placement^=left] .arrow::before,.bs-tooltip-left .arrow::before{left:0;border-width:.4rem 0 .4rem .4rem;border-left-color:#000}.tooltip-inner{max-width:200px;padding:.25rem .5rem;color:#fff;text-align:center;background-color:#000;border-radius:.25rem}.popover{position:absolute;top:0;left:0;z-index:1060;display:block;max-width:276px;font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,"Noto Sans",sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";font-style:normal;font-weight:400;line-height:1.5;text-align:left;text-align:start;text-decoration:none;text-shadow:none;text-transform:none;letter-spacing:normal;word-break:normal;word-spacing:normal;white-space:normal;line-break:auto;font-size:.875rem;word-wrap:break-word;background-color:#fff;background-clip:padding-box;border:1px solid rgba(0,0,0,.2);border-radius:.3rem}.popover .arrow{position:absolute;display:block;width:1rem;height:.5rem;margin:0 .3rem}.popover .arrow::after,.popover .arrow::before{position:absolute;display:block;content:"";border-color:transparent;border-style:solid}.bs-popover-auto[x-placement^=top],.bs-popover-top{margin-bottom:.5rem}.bs-popover-auto[x-placement^=top]>.arrow,.bs-popover-top>.arrow{bottom:calc((.5rem + 1px) * -1)}.bs-popover-auto[x-placement^=top]>.arrow::before,.bs-popover-top>.arrow::before{bottom:0;border-width:.5rem .5rem 0;border-top-color:rgba(0,0,0,.25)}.bs-popover-auto[x-placement^=top]>.arrow::after,.bs-popover-top>.arrow::after{bottom:1px;border-width:.5rem .5rem 0;border-top-color:#fff}.bs-popover-auto[x-placement^=right],.bs-popover-right{margin-left:.5rem}.bs-popover-auto[x-placement^=right]>.arrow,.bs-popover-right>.arrow{left:calc((.5rem + 1px) * -1);width:.5rem;height:1rem;margin:.3rem 0}.bs-popover-auto[x-placement^=right]>.arrow::before,.bs-popover-right>.arrow::before{left:0;border-width:.5rem .5rem .5rem 0;border-right-color:rgba(0,0,0,.25)}.bs-popover-auto[x-placement^=right]>.arrow::after,.bs-popover-right>.arrow::after{left:1px;border-width:.5rem .5rem .5rem 0;border-right-color:#fff}.bs-popover-auto[x-placement^=bottom],.bs-popover-bottom{margin-top:.5rem}.bs-popover-auto[x-placement^=bottom]>.arrow,.bs-popover-bottom>.arrow{top:calc((.5rem + 1px) * -1)}.bs-popover-auto[x-placement^=bottom]>.arrow::before,.bs-popover-bottom>.arrow::before{top:0;border-width:0 .5rem .5rem .5rem;border-bottom-color:rgba(0,0,0,.25)}.bs-popover-auto[x-placement^=bottom]>.arrow::after,.bs-popover-bottom>.arrow::after{top:1px;border-width:0 .5rem .5rem .5rem;border-bottom-color:#fff}.bs-popover-auto[x-placement^=bottom] .popover-header::before,.bs-popover-bottom .popover-header::before{position:absolute;top:0;left:50%;display:block;width:1rem;margin-left:-.5rem;content:"";border-bottom:1px solid #f7f7f7}.bs-popover-auto[x-placement^=left],.bs-popover-left{margin-right:.5rem}.bs-popover-auto[x-placement^=left]>.arrow,.bs-popover-left>.arrow{right:calc((.5rem + 1px) * -1);width:.5rem;height:1rem;margin:.3rem 0}.bs-popover-auto[x-placement^=left]>.arrow::before,.bs-popover-left>.arrow::before{right:0;border-width:.5rem 0 .5rem .5rem;border-left-color:rgba(0,0,0,.25)}.bs-popover-auto[x-placement^=left]>.arrow::after,.bs-popover-left>.arrow::after{right:1px;border-width:.5rem 0 .5rem .5rem;border-left-color:#fff}.popover-header{padding:.5rem .75rem;margin-bottom:0;font-size:1rem;background-color:#f7f7f7;border-bottom:1px solid #ebebeb;border-top-left-radius:calc(.3rem - 1px);border-top-right-radius:calc(.3rem - 1px)}.popover-header:empty{display:none}.popover-body{padding:.5rem .75rem;color:#212529}.carousel{position:relative}.carousel.pointer-event{-ms-touch-action:pan-y;touch-action:pan-y}.carousel-inner{position:relative;width:100%;overflow:hidden}.carousel-inner::after{display:block;clear:both;content:""}.carousel-item{position:relative;display:none;float:left;width:100%;margin-right:-100%;-webkit-backface-visibility:hidden;backface-visibility:hidden;transition:-webkit-transform .6s ease-in-out;transition:transform .6s ease-in-out;transition:transform .6s ease-in-out,-webkit-transform .6s ease-in-out}@media (prefers-reduced-motion:reduce){.carousel-item{transition:none}}.carousel-item-next,.carousel-item-prev,.carousel-item.active{display:block}.active.carousel-item-right,.carousel-item-next:not(.carousel-item-left){-webkit-transform:translateX(100%);transform:translateX(100%)}.active.carousel-item-left,.carousel-item-prev:not(.carousel-item-right){-webkit-transform:translateX(-100%);transform:translateX(-100%)}.carousel-fade .carousel-item{opacity:0;transition-property:opacity;-webkit-transform:none;transform:none}.carousel-fade .carousel-item-next.carousel-item-left,.carousel-fade .carousel-item-prev.carousel-item-right,.carousel-fade .carousel-item.active{z-index:1;opacity:1}.carousel-fade .active.carousel-item-left,.carousel-fade .active.carousel-item-right{z-index:0;opacity:0;transition:0s .6s opacity}@media (prefers-reduced-motion:reduce){.carousel-fade .active.carousel-item-left,.carousel-fade .active.carousel-item-right{transition:none}}.carousel-control-next,.carousel-control-prev{position:absolute;top:0;bottom:0;z-index:1;display:-ms-flexbox;display:flex;-ms-flex-align:center;align-items:center;-ms-flex-pack:center;justify-content:center;width:15%;color:#fff;text-align:center;opacity:.5;transition:opacity .15s ease}@media (prefers-reduced-motion:reduce){.carousel-control-next,.carousel-control-prev{transition:none}}.carousel-control-next:focus,.carousel-control-next:hover,.carousel-control-prev:focus,.carousel-control-prev:hover{color:#fff;text-decoration:none;outline:0;opacity:.9}.carousel-control-prev{left:0}.carousel-control-next{right:0}.carousel-control-next-icon,.carousel-control-prev-icon{display:inline-block;width:20px;height:20px;background:no-repeat 50%/100% 100%}.carousel-control-prev-icon{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' fill='%23fff' viewBox='0 0 8 8'%3e%3cpath d='M5.25 0l-4 4 4 4 1.5-1.5-2.5-2.5 2.5-2.5-1.5-1.5z'/%3e%3c/svg%3e")}.carousel-control-next-icon{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' fill='%23fff' viewBox='0 0 8 8'%3e%3cpath d='M2.75 0l-1.5 1.5 2.5 2.5-2.5 2.5 1.5 1.5 4-4-4-4z'/%3e%3c/svg%3e")}.carousel-indicators{position:absolute;right:0;bottom:0;left:0;z-index:15;display:-ms-flexbox;display:flex;-ms-flex-pack:center;justify-content:center;padding-left:0;margin-right:15%;margin-left:15%;list-style:none}.carousel-indicators li{box-sizing:content-box;-ms-flex:0 1 auto;flex:0 1 auto;width:30px;height:3px;margin-right:3px;margin-left:3px;text-indent:-999px;cursor:pointer;background-color:#fff;background-clip:padding-box;border-top:10px solid transparent;border-bottom:10px solid transparent;opacity:.5;transition:opacity .6s ease}@media (prefers-reduced-motion:reduce){.carousel-indicators li{transition:none}}.carousel-indicators .active{opacity:1}.carousel-caption{position:absolute;right:15%;bottom:20px;left:15%;z-index:10;padding-top:20px;padding-bottom:20px;color:#fff;text-align:center}@-webkit-keyframes spinner-border{to{-webkit-transform:rotate(360deg);transform:rotate(360deg)}}@keyframes spinner-border{to{-webkit-transform:rotate(360deg);transform:rotate(360deg)}}.spinner-border{display:inline-block;width:2rem;height:2rem;vertical-align:text-bottom;border:.25em solid currentColor;border-right-color:transparent;border-radius:50%;-webkit-animation:spinner-border .75s linear infinite;animation:spinner-border .75s linear infinite}.spinner-border-sm{width:1rem;height:1rem;border-width:.2em}@-webkit-keyframes spinner-grow{0%{-webkit-transform:scale(0);transform:scale(0)}50%{opacity:1}}@keyframes spinner-grow{0%{-webkit-transform:scale(0);transform:scale(0)}50%{opacity:1}}.spinner-grow{display:inline-block;width:2rem;height:2rem;vertical-align:text-bottom;background-color:currentColor;border-radius:50%;opacity:0;-webkit-animation:spinner-grow .75s linear infinite;animation:spinner-grow .75s linear infinite}.spinner-grow-sm{width:1rem;height:1rem}.align-baseline{vertical-align:baseline!important}.align-top{vertical-align:top!important}.align-middle{vertical-align:middle!important}.align-bottom{vertical-align:bottom!important}.align-text-bottom{vertical-align:text-bottom!important}.align-text-top{vertical-align:text-top!important}.bg-primary{background-color:#007bff!important}a.bg-primary:focus,a.bg-primary:hover,button.bg-primary:focus,button.bg-primary:hover{background-color:#0062cc!important}.bg-secondary{background-color:#6c757d!important}a.bg-secondary:focus,a.bg-secondary:hover,button.bg-secondary:focus,button.bg-secondary:hover{background-color:#545b62!important}.bg-success{background-color:#28a745!important}a.bg-success:focus,a.bg-success:hover,button.bg-success:focus,button.bg-success:hover{background-color:#1e7e34!important}.bg-info{background-color:#17a2b8!important}a.bg-info:focus,a.bg-info:hover,button.bg-info:focus,button.bg-info:hover{background-color:#117a8b!important}.bg-warning{background-color:#ffc107!important}a.bg-warning:focus,a.bg-warning:hover,button.bg-warning:focus,button.bg-warning:hover{background-color:#d39e00!important}.bg-danger{background-color:#dc3545!important}a.bg-danger:focus,a.bg-danger:hover,button.bg-danger:focus,button.bg-danger:hover{background-color:#bd2130!important}.bg-light{background-color:#f8f9fa!important}a.bg-light:focus,a.bg-light:hover,button.bg-light:focus,button.bg-light:hover{background-color:#dae0e5!important}.bg-dark{background-color:#343a40!important}a.bg-dark:focus,a.bg-dark:hover,button.bg-dark:focus,button.bg-dark:hover{background-color:#1d2124!important}.bg-white{background-color:#fff!important}.bg-transparent{background-color:transparent!important}.border{border:1px solid #dee2e6!important}.border-top{border-top:1px solid #dee2e6!important}.border-right{border-right:1px solid #dee2e6!important}.border-bottom{border-bottom:1px solid #dee2e6!important}.border-left{border-left:1px solid #dee2e6!important}.border-0{border:0!important}.border-top-0{border-top:0!important}.border-right-0{border-right:0!important}.border-bottom-0{border-bottom:0!important}.border-left-0{border-left:0!important}.border-primary{border-color:#007bff!important}.border-secondary{border-color:#6c757d!important}.border-success{border-color:#28a745!important}.border-info{border-color:#17a2b8!important}.border-warning{border-color:#ffc107!important}.border-danger{border-color:#dc3545!important}.border-light{border-color:#f8f9fa!important}.border-dark{border-color:#343a40!important}.border-white{border-color:#fff!important}.rounded-sm{border-radius:.2rem!important}.rounded{border-radius:.25rem!important}.rounded-top{border-top-left-radius:.25rem!important;border-top-right-radius:.25rem!important}.rounded-right{border-top-right-radius:.25rem!important;border-bottom-right-radius:.25rem!important}.rounded-bottom{border-bottom-right-radius:.25rem!important;border-bottom-left-radius:.25rem!important}.rounded-left{border-top-left-radius:.25rem!important;border-bottom-left-radius:.25rem!important}.rounded-lg{border-radius:.3rem!important}.rounded-circle{border-radius:50%!important}.rounded-pill{border-radius:50rem!important}.rounded-0{border-radius:0!important}.clearfix::after{display:block;clear:both;content:""}.d-none{display:none!important}.d-inline{display:inline!important}.d-inline-block{display:inline-block!important}.d-block{display:block!important}.d-table{display:table!important}.d-table-row{display:table-row!important}.d-table-cell{display:table-cell!important}.d-flex{display:-ms-flexbox!important;display:flex!important}.d-inline-flex{display:-ms-inline-flexbox!important;display:inline-flex!important}@media (min-width:576px){.d-sm-none{display:none!important}.d-sm-inline{display:inline!important}.d-sm-inline-block{display:inline-block!important}.d-sm-block{display:block!important}.d-sm-table{display:table!important}.d-sm-table-row{display:table-row!important}.d-sm-table-cell{display:table-cell!important}.d-sm-flex{display:-ms-flexbox!important;display:flex!important}.d-sm-inline-flex{display:-ms-inline-flexbox!important;display:inline-flex!important}}@media (min-width:768px){.d-md-none{display:none!important}.d-md-inline{display:inline!important}.d-md-inline-block{display:inline-block!important}.d-md-block{display:block!important}.d-md-table{display:table!important}.d-md-table-row{display:table-row!important}.d-md-table-cell{display:table-cell!important}.d-md-flex{display:-ms-flexbox!important;display:flex!important}.d-md-inline-flex{display:-ms-inline-flexbox!important;display:inline-flex!important}}@media (min-width:992px){.d-lg-none{display:none!important}.d-lg-inline{display:inline!important}.d-lg-inline-block{display:inline-block!important}.d-lg-block{display:block!important}.d-lg-table{display:table!important}.d-lg-table-row{display:table-row!important}.d-lg-table-cell{display:table-cell!important}.d-lg-flex{display:-ms-flexbox!important;display:flex!important}.d-lg-inline-flex{display:-ms-inline-flexbox!important;display:inline-flex!important}}@media (min-width:1200px){.d-xl-none{display:none!important}.d-xl-inline{display:inline!important}.d-xl-inline-block{display:inline-block!important}.d-xl-block{display:block!important}.d-xl-table{display:table!important}.d-xl-table-row{display:table-row!important}.d-xl-table-cell{display:table-cell!important}.d-xl-flex{display:-ms-flexbox!important;display:flex!important}.d-xl-inline-flex{display:-ms-inline-flexbox!important;display:inline-flex!important}}@media print{.d-print-none{display:none!important}.d-print-inline{display:inline!important}.d-print-inline-block{display:inline-block!important}.d-print-block{display:block!important}.d-print-table{display:table!important}.d-print-table-row{display:table-row!important}.d-print-table-cell{display:table-cell!important}.d-print-flex{display:-ms-flexbox!important;display:flex!important}.d-print-inline-flex{display:-ms-inline-flexbox!important;display:inline-flex!important}}.embed-responsive{position:relative;display:block;width:100%;padding:0;overflow:hidden}.embed-responsive::before{display:block;content:""}.embed-responsive .embed-responsive-item,.embed-responsive embed,.embed-responsive iframe,.embed-responsive object,.embed-responsive video{position:absolute;top:0;bottom:0;left:0;width:100%;height:100%;border:0}.embed-responsive-21by9::before{padding-top:42.857143%}.embed-responsive-16by9::before{padding-top:56.25%}.embed-responsive-4by3::before{padding-top:75%}.embed-responsive-1by1::before{padding-top:100%}.flex-row{-ms-flex-direction:row!important;flex-direction:row!important}.flex-column{-ms-flex-direction:column!important;flex-direction:column!important}.flex-row-reverse{-ms-flex-direction:row-reverse!important;flex-direction:row-reverse!important}.flex-column-reverse{-ms-flex-direction:column-reverse!important;flex-direction:column-reverse!important}.flex-wrap{-ms-flex-wrap:wrap!important;flex-wrap:wrap!important}.flex-nowrap{-ms-flex-wrap:nowrap!important;flex-wrap:nowrap!important}.flex-wrap-reverse{-ms-flex-wrap:wrap-reverse!important;flex-wrap:wrap-reverse!important}.flex-fill{-ms-flex:1 1 auto!important;flex:1 1 auto!important}.flex-grow-0{-ms-flex-positive:0!important;flex-grow:0!important}.flex-grow-1{-ms-flex-positive:1!important;flex-grow:1!important}.flex-shrink-0{-ms-flex-negative:0!important;flex-shrink:0!important}.flex-shrink-1{-ms-flex-negative:1!important;flex-shrink:1!important}.justify-content-start{-ms-flex-pack:start!important;justify-content:flex-start!important}.justify-content-end{-ms-flex-pack:end!important;justify-content:flex-end!important}.justify-content-center{-ms-flex-pack:center!important;justify-content:center!important}.justify-content-between{-ms-flex-pack:justify!important;justify-content:space-between!important}.justify-content-around{-ms-flex-pack:distribute!important;justify-content:space-around!important}.align-items-start{-ms-flex-align:start!important;align-items:flex-start!important}.align-items-end{-ms-flex-align:end!important;align-items:flex-end!important}.align-items-center{-ms-flex-align:center!important;align-items:center!important}.align-items-baseline{-ms-flex-align:baseline!important;align-items:baseline!important}.align-items-stretch{-ms-flex-align:stretch!important;align-items:stretch!important}.align-content-start{-ms-flex-line-pack:start!important;align-content:flex-start!important}.align-content-end{-ms-flex-line-pack:end!important;align-content:flex-end!important}.align-content-center{-ms-flex-line-pack:center!important;align-content:center!important}.align-content-between{-ms-flex-line-pack:justify!important;align-content:space-between!important}.align-content-around{-ms-flex-line-pack:distribute!important;align-content:space-around!important}.align-content-stretch{-ms-flex-line-pack:stretch!important;align-content:stretch!important}.align-self-auto{-ms-flex-item-align:auto!important;align-self:auto!important}.align-self-start{-ms-flex-item-align:start!important;align-self:flex-start!important}.align-self-end{-ms-flex-item-align:end!important;align-self:flex-end!important}.align-self-center{-ms-flex-item-align:center!important;align-self:center!important}.align-self-baseline{-ms-flex-item-align:baseline!important;align-self:baseline!important}.align-self-stretch{-ms-flex-item-align:stretch!important;align-self:stretch!important}@media (min-width:576px){.flex-sm-row{-ms-flex-direction:row!important;flex-direction:row!important}.flex-sm-column{-ms-flex-direction:column!important;flex-direction:column!important}.flex-sm-row-reverse{-ms-flex-direction:row-reverse!important;flex-direction:row-reverse!important}.flex-sm-column-reverse{-ms-flex-direction:column-reverse!important;flex-direction:column-reverse!important}.flex-sm-wrap{-ms-flex-wrap:wrap!important;flex-wrap:wrap!important}.flex-sm-nowrap{-ms-flex-wrap:nowrap!important;flex-wrap:nowrap!important}.flex-sm-wrap-reverse{-ms-flex-wrap:wrap-reverse!important;flex-wrap:wrap-reverse!important}.flex-sm-fill{-ms-flex:1 1 auto!important;flex:1 1 auto!important}.flex-sm-grow-0{-ms-flex-positive:0!important;flex-grow:0!important}.flex-sm-grow-1{-ms-flex-positive:1!important;flex-grow:1!important}.flex-sm-shrink-0{-ms-flex-negative:0!important;flex-shrink:0!important}.flex-sm-shrink-1{-ms-flex-negative:1!important;flex-shrink:1!important}.justify-content-sm-start{-ms-flex-pack:start!important;justify-content:flex-start!important}.justify-content-sm-end{-ms-flex-pack:end!important;justify-content:flex-end!important}.justify-content-sm-center{-ms-flex-pack:center!important;justify-content:center!important}.justify-content-sm-between{-ms-flex-pack:justify!important;justify-content:space-between!important}.justify-content-sm-around{-ms-flex-pack:distribute!important;justify-content:space-around!important}.align-items-sm-start{-ms-flex-align:start!important;align-items:flex-start!important}.align-items-sm-end{-ms-flex-align:end!important;align-items:flex-end!important}.align-items-sm-center{-ms-flex-align:center!important;align-items:center!important}.align-items-sm-baseline{-ms-flex-align:baseline!important;align-items:baseline!important}.align-items-sm-stretch{-ms-flex-align:stretch!important;align-items:stretch!important}.align-content-sm-start{-ms-flex-line-pack:start!important;align-content:flex-start!important}.align-content-sm-end{-ms-flex-line-pack:end!important;align-content:flex-end!important}.align-content-sm-center{-ms-flex-line-pack:center!important;align-content:center!important}.align-content-sm-between{-ms-flex-line-pack:justify!important;align-content:space-between!important}.align-content-sm-around{-ms-flex-line-pack:distribute!important;align-content:space-around!important}.align-content-sm-stretch{-ms-flex-line-pack:stretch!important;align-content:stretch!important}.align-self-sm-auto{-ms-flex-item-align:auto!important;align-self:auto!important}.align-self-sm-start{-ms-flex-item-align:start!important;align-self:flex-start!important}.align-self-sm-end{-ms-flex-item-align:end!important;align-self:flex-end!important}.align-self-sm-center{-ms-flex-item-align:center!important;align-self:center!important}.align-self-sm-baseline{-ms-flex-item-align:baseline!important;align-self:baseline!important}.align-self-sm-stretch{-ms-flex-item-align:stretch!important;align-self:stretch!important}}@media (min-width:768px){.flex-md-row{-ms-flex-direction:row!important;flex-direction:row!important}.flex-md-column{-ms-flex-direction:column!important;flex-direction:column!important}.flex-md-row-reverse{-ms-flex-direction:row-reverse!important;flex-direction:row-reverse!important}.flex-md-column-reverse{-ms-flex-direction:column-reverse!important;flex-direction:column-reverse!important}.flex-md-wrap{-ms-flex-wrap:wrap!important;flex-wrap:wrap!important}.flex-md-nowrap{-ms-flex-wrap:nowrap!important;flex-wrap:nowrap!important}.flex-md-wrap-reverse{-ms-flex-wrap:wrap-reverse!important;flex-wrap:wrap-reverse!important}.flex-md-fill{-ms-flex:1 1 auto!important;flex:1 1 auto!important}.flex-md-grow-0{-ms-flex-positive:0!important;flex-grow:0!important}.flex-md-grow-1{-ms-flex-positive:1!important;flex-grow:1!important}.flex-md-shrink-0{-ms-flex-negative:0!important;flex-shrink:0!important}.flex-md-shrink-1{-ms-flex-negative:1!important;flex-shrink:1!important}.justify-content-md-start{-ms-flex-pack:start!important;justify-content:flex-start!important}.justify-content-md-end{-ms-flex-pack:end!important;justify-content:flex-end!important}.justify-content-md-center{-ms-flex-pack:center!important;justify-content:center!important}.justify-content-md-between{-ms-flex-pack:justify!important;justify-content:space-between!important}.justify-content-md-around{-ms-flex-pack:distribute!important;justify-content:space-around!important}.align-items-md-start{-ms-flex-align:start!important;align-items:flex-start!important}.align-items-md-end{-ms-flex-align:end!important;align-items:flex-end!important}.align-items-md-center{-ms-flex-align:center!important;align-items:center!important}.align-items-md-baseline{-ms-flex-align:baseline!important;align-items:baseline!important}.align-items-md-stretch{-ms-flex-align:stretch!important;align-items:stretch!important}.align-content-md-start{-ms-flex-line-pack:start!important;align-content:flex-start!important}.align-content-md-end{-ms-flex-line-pack:end!important;align-content:flex-end!important}.align-content-md-center{-ms-flex-line-pack:center!important;align-content:center!important}.align-content-md-between{-ms-flex-line-pack:justify!important;align-content:space-between!important}.align-content-md-around{-ms-flex-line-pack:distribute!important;align-content:space-around!important}.align-content-md-stretch{-ms-flex-line-pack:stretch!important;align-content:stretch!important}.align-self-md-auto{-ms-flex-item-align:auto!important;align-self:auto!important}.align-self-md-start{-ms-flex-item-align:start!important;align-self:flex-start!important}.align-self-md-end{-ms-flex-item-align:end!important;align-self:flex-end!important}.align-self-md-center{-ms-flex-item-align:center!important;align-self:center!important}.align-self-md-baseline{-ms-flex-item-align:baseline!important;align-self:baseline!important}.align-self-md-stretch{-ms-flex-item-align:stretch!important;align-self:stretch!important}}@media (min-width:992px){.flex-lg-row{-ms-flex-direction:row!important;flex-direction:row!important}.flex-lg-column{-ms-flex-direction:column!important;flex-direction:column!important}.flex-lg-row-reverse{-ms-flex-direction:row-reverse!important;flex-direction:row-reverse!important}.flex-lg-column-reverse{-ms-flex-direction:column-reverse!important;flex-direction:column-reverse!important}.flex-lg-wrap{-ms-flex-wrap:wrap!important;flex-wrap:wrap!important}.flex-lg-nowrap{-ms-flex-wrap:nowrap!important;flex-wrap:nowrap!important}.flex-lg-wrap-reverse{-ms-flex-wrap:wrap-reverse!important;flex-wrap:wrap-reverse!important}.flex-lg-fill{-ms-flex:1 1 auto!important;flex:1 1 auto!important}.flex-lg-grow-0{-ms-flex-positive:0!important;flex-grow:0!important}.flex-lg-grow-1{-ms-flex-positive:1!important;flex-grow:1!important}.flex-lg-shrink-0{-ms-flex-negative:0!important;flex-shrink:0!important}.flex-lg-shrink-1{-ms-flex-negative:1!important;flex-shrink:1!important}.justify-content-lg-start{-ms-flex-pack:start!important;justify-content:flex-start!important}.justify-content-lg-end{-ms-flex-pack:end!important;justify-content:flex-end!important}.justify-content-lg-center{-ms-flex-pack:center!important;justify-content:center!important}.justify-content-lg-between{-ms-flex-pack:justify!important;justify-content:space-between!important}.justify-content-lg-around{-ms-flex-pack:distribute!important;justify-content:space-around!important}.align-items-lg-start{-ms-flex-align:start!important;align-items:flex-start!important}.align-items-lg-end{-ms-flex-align:end!important;align-items:flex-end!important}.align-items-lg-center{-ms-flex-align:center!important;align-items:center!important}.align-items-lg-baseline{-ms-flex-align:baseline!important;align-items:baseline!important}.align-items-lg-stretch{-ms-flex-align:stretch!important;align-items:stretch!important}.align-content-lg-start{-ms-flex-line-pack:start!important;align-content:flex-start!important}.align-content-lg-end{-ms-flex-line-pack:end!important;align-content:flex-end!important}.align-content-lg-center{-ms-flex-line-pack:center!important;align-content:center!important}.align-content-lg-between{-ms-flex-line-pack:justify!important;align-content:space-between!important}.align-content-lg-around{-ms-flex-line-pack:distribute!important;align-content:space-around!important}.align-content-lg-stretch{-ms-flex-line-pack:stretch!important;align-content:stretch!important}.align-self-lg-auto{-ms-flex-item-align:auto!important;align-self:auto!important}.align-self-lg-start{-ms-flex-item-align:start!important;align-self:flex-start!important}.align-self-lg-end{-ms-flex-item-align:end!important;align-self:flex-end!important}.align-self-lg-center{-ms-flex-item-align:center!important;align-self:center!important}.align-self-lg-baseline{-ms-flex-item-align:baseline!important;align-self:baseline!important}.align-self-lg-stretch{-ms-flex-item-align:stretch!important;align-self:stretch!important}}@media (min-width:1200px){.flex-xl-row{-ms-flex-direction:row!important;flex-direction:row!important}.flex-xl-column{-ms-flex-direction:column!important;flex-direction:column!important}.flex-xl-row-reverse{-ms-flex-direction:row-reverse!important;flex-direction:row-reverse!important}.flex-xl-column-reverse{-ms-flex-direction:column-reverse!important;flex-direction:column-reverse!important}.flex-xl-wrap{-ms-flex-wrap:wrap!important;flex-wrap:wrap!important}.flex-xl-nowrap{-ms-flex-wrap:nowrap!important;flex-wrap:nowrap!important}.flex-xl-wrap-reverse{-ms-flex-wrap:wrap-reverse!important;flex-wrap:wrap-reverse!important}.flex-xl-fill{-ms-flex:1 1 auto!important;flex:1 1 auto!important}.flex-xl-grow-0{-ms-flex-positive:0!important;flex-grow:0!important}.flex-xl-grow-1{-ms-flex-positive:1!important;flex-grow:1!important}.flex-xl-shrink-0{-ms-flex-negative:0!important;flex-shrink:0!important}.flex-xl-shrink-1{-ms-flex-negative:1!important;flex-shrink:1!important}.justify-content-xl-start{-ms-flex-pack:start!important;justify-content:flex-start!important}.justify-content-xl-end{-ms-flex-pack:end!important;justify-content:flex-end!important}.justify-content-xl-center{-ms-flex-pack:center!important;justify-content:center!important}.justify-content-xl-between{-ms-flex-pack:justify!important;justify-content:space-between!important}.justify-content-xl-around{-ms-flex-pack:distribute!important;justify-content:space-around!important}.align-items-xl-start{-ms-flex-align:start!important;align-items:flex-start!important}.align-items-xl-end{-ms-flex-align:end!important;align-items:flex-end!important}.align-items-xl-center{-ms-flex-align:center!important;align-items:center!important}.align-items-xl-baseline{-ms-flex-align:baseline!important;align-items:baseline!important}.align-items-xl-stretch{-ms-flex-align:stretch!important;align-items:stretch!important}.align-content-xl-start{-ms-flex-line-pack:start!important;align-content:flex-start!important}.align-content-xl-end{-ms-flex-line-pack:end!important;align-content:flex-end!important}.align-content-xl-center{-ms-flex-line-pack:center!important;align-content:center!important}.align-content-xl-between{-ms-flex-line-pack:justify!important;align-content:space-between!important}.align-content-xl-around{-ms-flex-line-pack:distribute!important;align-content:space-around!important}.align-content-xl-stretch{-ms-flex-line-pack:stretch!important;align-content:stretch!important}.align-self-xl-auto{-ms-flex-item-align:auto!important;align-self:auto!important}.align-self-xl-start{-ms-flex-item-align:start!important;align-self:flex-start!important}.align-self-xl-end{-ms-flex-item-align:end!important;align-self:flex-end!important}.align-self-xl-center{-ms-flex-item-align:center!important;align-self:center!important}.align-self-xl-baseline{-ms-flex-item-align:baseline!important;align-self:baseline!important}.align-self-xl-stretch{-ms-flex-item-align:stretch!important;align-self:stretch!important}}.float-left{float:left!important}.float-right{float:right!important}.float-none{float:none!important}@media (min-width:576px){.float-sm-left{float:left!important}.float-sm-right{float:right!important}.float-sm-none{float:none!important}}@media (min-width:768px){.float-md-left{float:left!important}.float-md-right{float:right!important}.float-md-none{float:none!important}}@media (min-width:992px){.float-lg-left{float:left!important}.float-lg-right{float:right!important}.float-lg-none{float:none!important}}@media (min-width:1200px){.float-xl-left{float:left!important}.float-xl-right{float:right!important}.float-xl-none{float:none!important}}.overflow-auto{overflow:auto!important}.overflow-hidden{overflow:hidden!important}.position-static{position:static!important}.position-relative{position:relative!important}.position-absolute{position:absolute!important}.position-fixed{position:fixed!important}.position-sticky{position:-webkit-sticky!important;position:sticky!important}.fixed-top{position:fixed;top:0;right:0;left:0;z-index:1030}.fixed-bottom{position:fixed;right:0;bottom:0;left:0;z-index:1030}@supports ((position:-webkit-sticky) or (position:sticky)){.sticky-top{position:-webkit-sticky;position:sticky;top:0;z-index:1020}}.sr-only{position:absolute;width:1px;height:1px;padding:0;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0}.sr-only-focusable:active,.sr-only-focusable:focus{position:static;width:auto;height:auto;overflow:visible;clip:auto;white-space:normal}.shadow-sm{box-shadow:0 .125rem .25rem rgba(0,0,0,.075)!important}.shadow{box-shadow:0 .5rem 1rem rgba(0,0,0,.15)!important}.shadow-lg{box-shadow:0 1rem 3rem rgba(0,0,0,.175)!important}.shadow-none{box-shadow:none!important}.w-25{width:25%!important}.w-50{width:50%!important}.w-75{width:75%!important}.w-100{width:100%!important}.w-auto{width:auto!important}.h-25{height:25%!important}.h-50{height:50%!important}.h-75{height:75%!important}.h-100{height:100%!important}.h-auto{height:auto!important}.mw-100{max-width:100%!important}.mh-100{max-height:100%!important}.min-vw-100{min-width:100vw!important}.min-vh-100{min-height:100vh!important}.vw-100{width:100vw!important}.vh-100{height:100vh!important}.stretched-link::after{position:absolute;top:0;right:0;bottom:0;left:0;z-index:1;pointer-events:auto;content:"";background-color:rgba(0,0,0,0)}.m-0{margin:0!important}.mt-0,.my-0{margin-top:0!important}.mr-0,.mx-0{margin-right:0!important}.mb-0,.my-0{margin-bottom:0!important}.ml-0,.mx-0{margin-left:0!important}.m-1{margin:.25rem!important}.mt-1,.my-1{margin-top:.25rem!important}.mr-1,.mx-1{margin-right:.25rem!important}.mb-1,.my-1{margin-bottom:.25rem!important}.ml-1,.mx-1{margin-left:.25rem!important}.m-2{margin:.5rem!important}.mt-2,.my-2{margin-top:.5rem!important}.mr-2,.mx-2{margin-right:.5rem!important}.mb-2,.my-2{margin-bottom:.5rem!important}.ml-2,.mx-2{margin-left:.5rem!important}.m-3{margin:1rem!important}.mt-3,.my-3{margin-top:1rem!important}.mr-3,.mx-3{margin-right:1rem!important}.mb-3,.my-3{margin-bottom:1rem!important}.ml-3,.mx-3{margin-left:1rem!important}.m-4{margin:1.5rem!important}.mt-4,.my-4{margin-top:1.5rem!important}.mr-4,.mx-4{margin-right:1.5rem!important}.mb-4,.my-4{margin-bottom:1.5rem!important}.ml-4,.mx-4{margin-left:1.5rem!important}.m-5{margin:3rem!important}.mt-5,.my-5{margin-top:3rem!important}.mr-5,.mx-5{margin-right:3rem!important}.mb-5,.my-5{margin-bottom:3rem!important}.ml-5,.mx-5{margin-left:3rem!important}.p-0{padding:0!important}.pt-0,.py-0{padding-top:0!important}.pr-0,.px-0{padding-right:0!important}.pb-0,.py-0{padding-bottom:0!important}.pl-0,.px-0{padding-left:0!important}.p-1{padding:.25rem!important}.pt-1,.py-1{padding-top:.25rem!important}.pr-1,.px-1{padding-right:.25rem!important}.pb-1,.py-1{padding-bottom:.25rem!important}.pl-1,.px-1{padding-left:.25rem!important}.p-2{padding:.5rem!important}.pt-2,.py-2{padding-top:.5rem!important}.pr-2,.px-2{padding-right:.5rem!important}.pb-2,.py-2{padding-bottom:.5rem!important}.pl-2,.px-2{padding-left:.5rem!important}.p-3{padding:1rem!important}.pt-3,.py-3{padding-top:1rem!important}.pr-3,.px-3{padding-right:1rem!important}.pb-3,.py-3{padding-bottom:1rem!important}.pl-3,.px-3{padding-left:1rem!important}.p-4{padding:1.5rem!important}.pt-4,.py-4{padding-top:1.5rem!important}.pr-4,.px-4{padding-right:1.5rem!important}.pb-4,.py-4{padding-bottom:1.5rem!important}.pl-4,.px-4{padding-left:1.5rem!important}.p-5{padding:3rem!important}.pt-5,.py-5{padding-top:3rem!important}.pr-5,.px-5{padding-right:3rem!important}.pb-5,.py-5{padding-bottom:3rem!important}.pl-5,.px-5{padding-left:3rem!important}.m-n1{margin:-.25rem!important}.mt-n1,.my-n1{margin-top:-.25rem!important}.mr-n1,.mx-n1{margin-right:-.25rem!important}.mb-n1,.my-n1{margin-bottom:-.25rem!important}.ml-n1,.mx-n1{margin-left:-.25rem!important}.m-n2{margin:-.5rem!important}.mt-n2,.my-n2{margin-top:-.5rem!important}.mr-n2,.mx-n2{margin-right:-.5rem!important}.mb-n2,.my-n2{margin-bottom:-.5rem!important}.ml-n2,.mx-n2{margin-left:-.5rem!important}.m-n3{margin:-1rem!important}.mt-n3,.my-n3{margin-top:-1rem!important}.mr-n3,.mx-n3{margin-right:-1rem!important}.mb-n3,.my-n3{margin-bottom:-1rem!important}.ml-n3,.mx-n3{margin-left:-1rem!important}.m-n4{margin:-1.5rem!important}.mt-n4,.my-n4{margin-top:-1.5rem!important}.mr-n4,.mx-n4{margin-right:-1.5rem!important}.mb-n4,.my-n4{margin-bottom:-1.5rem!important}.ml-n4,.mx-n4{margin-left:-1.5rem!important}.m-n5{margin:-3rem!important}.mt-n5,.my-n5{margin-top:-3rem!important}.mr-n5,.mx-n5{margin-right:-3rem!important}.mb-n5,.my-n5{margin-bottom:-3rem!important}.ml-n5,.mx-n5{margin-left:-3rem!important}.m-auto{margin:auto!important}.mt-auto,.my-auto{margin-top:auto!important}.mr-auto,.mx-auto{margin-right:auto!important}.mb-auto,.my-auto{margin-bottom:auto!important}.ml-auto,.mx-auto{margin-left:auto!important}@media (min-width:576px){.m-sm-0{margin:0!important}.mt-sm-0,.my-sm-0{margin-top:0!important}.mr-sm-0,.mx-sm-0{margin-right:0!important}.mb-sm-0,.my-sm-0{margin-bottom:0!important}.ml-sm-0,.mx-sm-0{margin-left:0!important}.m-sm-1{margin:.25rem!important}.mt-sm-1,.my-sm-1{margin-top:.25rem!important}.mr-sm-1,.mx-sm-1{margin-right:.25rem!important}.mb-sm-1,.my-sm-1{margin-bottom:.25rem!important}.ml-sm-1,.mx-sm-1{margin-left:.25rem!important}.m-sm-2{margin:.5rem!important}.mt-sm-2,.my-sm-2{margin-top:.5rem!important}.mr-sm-2,.mx-sm-2{margin-right:.5rem!important}.mb-sm-2,.my-sm-2{margin-bottom:.5rem!important}.ml-sm-2,.mx-sm-2{margin-left:.5rem!important}.m-sm-3{margin:1rem!important}.mt-sm-3,.my-sm-3{margin-top:1rem!important}.mr-sm-3,.mx-sm-3{margin-right:1rem!important}.mb-sm-3,.my-sm-3{margin-bottom:1rem!important}.ml-sm-3,.mx-sm-3{margin-left:1rem!important}.m-sm-4{margin:1.5rem!important}.mt-sm-4,.my-sm-4{margin-top:1.5rem!important}.mr-sm-4,.mx-sm-4{margin-right:1.5rem!important}.mb-sm-4,.my-sm-4{margin-bottom:1.5rem!important}.ml-sm-4,.mx-sm-4{margin-left:1.5rem!important}.m-sm-5{margin:3rem!important}.mt-sm-5,.my-sm-5{margin-top:3rem!important}.mr-sm-5,.mx-sm-5{margin-right:3rem!important}.mb-sm-5,.my-sm-5{margin-bottom:3rem!important}.ml-sm-5,.mx-sm-5{margin-left:3rem!important}.p-sm-0{padding:0!important}.pt-sm-0,.py-sm-0{padding-top:0!important}.pr-sm-0,.px-sm-0{padding-right:0!important}.pb-sm-0,.py-sm-0{padding-bottom:0!important}.pl-sm-0,.px-sm-0{padding-left:0!important}.p-sm-1{padding:.25rem!important}.pt-sm-1,.py-sm-1{padding-top:.25rem!important}.pr-sm-1,.px-sm-1{padding-right:.25rem!important}.pb-sm-1,.py-sm-1{padding-bottom:.25rem!important}.pl-sm-1,.px-sm-1{padding-left:.25rem!important}.p-sm-2{padding:.5rem!important}.pt-sm-2,.py-sm-2{padding-top:.5rem!important}.pr-sm-2,.px-sm-2{padding-right:.5rem!important}.pb-sm-2,.py-sm-2{padding-bottom:.5rem!important}.pl-sm-2,.px-sm-2{padding-left:.5rem!important}.p-sm-3{padding:1rem!important}.pt-sm-3,.py-sm-3{padding-top:1rem!important}.pr-sm-3,.px-sm-3{padding-right:1rem!important}.pb-sm-3,.py-sm-3{padding-bottom:1rem!important}.pl-sm-3,.px-sm-3{padding-left:1rem!important}.p-sm-4{padding:1.5rem!important}.pt-sm-4,.py-sm-4{padding-top:1.5rem!important}.pr-sm-4,.px-sm-4{padding-right:1.5rem!important}.pb-sm-4,.py-sm-4{padding-bottom:1.5rem!important}.pl-sm-4,.px-sm-4{padding-left:1.5rem!important}.p-sm-5{padding:3rem!important}.pt-sm-5,.py-sm-5{padding-top:3rem!important}.pr-sm-5,.px-sm-5{padding-right:3rem!important}.pb-sm-5,.py-sm-5{padding-bottom:3rem!important}.pl-sm-5,.px-sm-5{padding-left:3rem!important}.m-sm-n1{margin:-.25rem!important}.mt-sm-n1,.my-sm-n1{margin-top:-.25rem!important}.mr-sm-n1,.mx-sm-n1{margin-right:-.25rem!important}.mb-sm-n1,.my-sm-n1{margin-bottom:-.25rem!important}.ml-sm-n1,.mx-sm-n1{margin-left:-.25rem!important}.m-sm-n2{margin:-.5rem!important}.mt-sm-n2,.my-sm-n2{margin-top:-.5rem!important}.mr-sm-n2,.mx-sm-n2{margin-right:-.5rem!important}.mb-sm-n2,.my-sm-n2{margin-bottom:-.5rem!important}.ml-sm-n2,.mx-sm-n2{margin-left:-.5rem!important}.m-sm-n3{margin:-1rem!important}.mt-sm-n3,.my-sm-n3{margin-top:-1rem!important}.mr-sm-n3,.mx-sm-n3{margin-right:-1rem!important}.mb-sm-n3,.my-sm-n3{margin-bottom:-1rem!important}.ml-sm-n3,.mx-sm-n3{margin-left:-1rem!important}.m-sm-n4{margin:-1.5rem!important}.mt-sm-n4,.my-sm-n4{margin-top:-1.5rem!important}.mr-sm-n4,.mx-sm-n4{margin-right:-1.5rem!important}.mb-sm-n4,.my-sm-n4{margin-bottom:-1.5rem!important}.ml-sm-n4,.mx-sm-n4{margin-left:-1.5rem!important}.m-sm-n5{margin:-3rem!important}.mt-sm-n5,.my-sm-n5{margin-top:-3rem!important}.mr-sm-n5,.mx-sm-n5{margin-right:-3rem!important}.mb-sm-n5,.my-sm-n5{margin-bottom:-3rem!important}.ml-sm-n5,.mx-sm-n5{margin-left:-3rem!important}.m-sm-auto{margin:auto!important}.mt-sm-auto,.my-sm-auto{margin-top:auto!important}.mr-sm-auto,.mx-sm-auto{margin-right:auto!important}.mb-sm-auto,.my-sm-auto{margin-bottom:auto!important}.ml-sm-auto,.mx-sm-auto{margin-left:auto!important}}@media (min-width:768px){.m-md-0{margin:0!important}.mt-md-0,.my-md-0{margin-top:0!important}.mr-md-0,.mx-md-0{margin-right:0!important}.mb-md-0,.my-md-0{margin-bottom:0!important}.ml-md-0,.mx-md-0{margin-left:0!important}.m-md-1{margin:.25rem!important}.mt-md-1,.my-md-1{margin-top:.25rem!important}.mr-md-1,.mx-md-1{margin-right:.25rem!important}.mb-md-1,.my-md-1{margin-bottom:.25rem!important}.ml-md-1,.mx-md-1{margin-left:.25rem!important}.m-md-2{margin:.5rem!important}.mt-md-2,.my-md-2{margin-top:.5rem!important}.mr-md-2,.mx-md-2{margin-right:.5rem!important}.mb-md-2,.my-md-2{margin-bottom:.5rem!important}.ml-md-2,.mx-md-2{margin-left:.5rem!important}.m-md-3{margin:1rem!important}.mt-md-3,.my-md-3{margin-top:1rem!important}.mr-md-3,.mx-md-3{margin-right:1rem!important}.mb-md-3,.my-md-3{margin-bottom:1rem!important}.ml-md-3,.mx-md-3{margin-left:1rem!important}.m-md-4{margin:1.5rem!important}.mt-md-4,.my-md-4{margin-top:1.5rem!important}.mr-md-4,.mx-md-4{margin-right:1.5rem!important}.mb-md-4,.my-md-4{margin-bottom:1.5rem!important}.ml-md-4,.mx-md-4{margin-left:1.5rem!important}.m-md-5{margin:3rem!important}.mt-md-5,.my-md-5{margin-top:3rem!important}.mr-md-5,.mx-md-5{margin-right:3rem!important}.mb-md-5,.my-md-5{margin-bottom:3rem!important}.ml-md-5,.mx-md-5{margin-left:3rem!important}.p-md-0{padding:0!important}.pt-md-0,.py-md-0{padding-top:0!important}.pr-md-0,.px-md-0{padding-right:0!important}.pb-md-0,.py-md-0{padding-bottom:0!important}.pl-md-0,.px-md-0{padding-left:0!important}.p-md-1{padding:.25rem!important}.pt-md-1,.py-md-1{padding-top:.25rem!important}.pr-md-1,.px-md-1{padding-right:.25rem!important}.pb-md-1,.py-md-1{padding-bottom:.25rem!important}.pl-md-1,.px-md-1{padding-left:.25rem!important}.p-md-2{padding:.5rem!important}.pt-md-2,.py-md-2{padding-top:.5rem!important}.pr-md-2,.px-md-2{padding-right:.5rem!important}.pb-md-2,.py-md-2{padding-bottom:.5rem!important}.pl-md-2,.px-md-2{padding-left:.5rem!important}.p-md-3{padding:1rem!important}.pt-md-3,.py-md-3{padding-top:1rem!important}.pr-md-3,.px-md-3{padding-right:1rem!important}.pb-md-3,.py-md-3{padding-bottom:1rem!important}.pl-md-3,.px-md-3{padding-left:1rem!important}.p-md-4{padding:1.5rem!important}.pt-md-4,.py-md-4{padding-top:1.5rem!important}.pr-md-4,.px-md-4{padding-right:1.5rem!important}.pb-md-4,.py-md-4{padding-bottom:1.5rem!important}.pl-md-4,.px-md-4{padding-left:1.5rem!important}.p-md-5{padding:3rem!important}.pt-md-5,.py-md-5{padding-top:3rem!important}.pr-md-5,.px-md-5{padding-right:3rem!important}.pb-md-5,.py-md-5{padding-bottom:3rem!important}.pl-md-5,.px-md-5{padding-left:3rem!important}.m-md-n1{margin:-.25rem!important}.mt-md-n1,.my-md-n1{margin-top:-.25rem!important}.mr-md-n1,.mx-md-n1{margin-right:-.25rem!important}.mb-md-n1,.my-md-n1{margin-bottom:-.25rem!important}.ml-md-n1,.mx-md-n1{margin-left:-.25rem!important}.m-md-n2{margin:-.5rem!important}.mt-md-n2,.my-md-n2{margin-top:-.5rem!important}.mr-md-n2,.mx-md-n2{margin-right:-.5rem!important}.mb-md-n2,.my-md-n2{margin-bottom:-.5rem!important}.ml-md-n2,.mx-md-n2{margin-left:-.5rem!important}.m-md-n3{margin:-1rem!important}.mt-md-n3,.my-md-n3{margin-top:-1rem!important}.mr-md-n3,.mx-md-n3{margin-right:-1rem!important}.mb-md-n3,.my-md-n3{margin-bottom:-1rem!important}.ml-md-n3,.mx-md-n3{margin-left:-1rem!important}.m-md-n4{margin:-1.5rem!important}.mt-md-n4,.my-md-n4{margin-top:-1.5rem!important}.mr-md-n4,.mx-md-n4{margin-right:-1.5rem!important}.mb-md-n4,.my-md-n4{margin-bottom:-1.5rem!important}.ml-md-n4,.mx-md-n4{margin-left:-1.5rem!important}.m-md-n5{margin:-3rem!important}.mt-md-n5,.my-md-n5{margin-top:-3rem!important}.mr-md-n5,.mx-md-n5{margin-right:-3rem!important}.mb-md-n5,.my-md-n5{margin-bottom:-3rem!important}.ml-md-n5,.mx-md-n5{margin-left:-3rem!important}.m-md-auto{margin:auto!important}.mt-md-auto,.my-md-auto{margin-top:auto!important}.mr-md-auto,.mx-md-auto{margin-right:auto!important}.mb-md-auto,.my-md-auto{margin-bottom:auto!important}.ml-md-auto,.mx-md-auto{margin-left:auto!important}}@media (min-width:992px){.m-lg-0{margin:0!important}.mt-lg-0,.my-lg-0{margin-top:0!important}.mr-lg-0,.mx-lg-0{margin-right:0!important}.mb-lg-0,.my-lg-0{margin-bottom:0!important}.ml-lg-0,.mx-lg-0{margin-left:0!important}.m-lg-1{margin:.25rem!important}.mt-lg-1,.my-lg-1{margin-top:.25rem!important}.mr-lg-1,.mx-lg-1{margin-right:.25rem!important}.mb-lg-1,.my-lg-1{margin-bottom:.25rem!important}.ml-lg-1,.mx-lg-1{margin-left:.25rem!important}.m-lg-2{margin:.5rem!important}.mt-lg-2,.my-lg-2{margin-top:.5rem!important}.mr-lg-2,.mx-lg-2{margin-right:.5rem!important}.mb-lg-2,.my-lg-2{margin-bottom:.5rem!important}.ml-lg-2,.mx-lg-2{margin-left:.5rem!important}.m-lg-3{margin:1rem!important}.mt-lg-3,.my-lg-3{margin-top:1rem!important}.mr-lg-3,.mx-lg-3{margin-right:1rem!important}.mb-lg-3,.my-lg-3{margin-bottom:1rem!important}.ml-lg-3,.mx-lg-3{margin-left:1rem!important}.m-lg-4{margin:1.5rem!important}.mt-lg-4,.my-lg-4{margin-top:1.5rem!important}.mr-lg-4,.mx-lg-4{margin-right:1.5rem!important}.mb-lg-4,.my-lg-4{margin-bottom:1.5rem!important}.ml-lg-4,.mx-lg-4{margin-left:1.5rem!important}.m-lg-5{margin:3rem!important}.mt-lg-5,.my-lg-5{margin-top:3rem!important}.mr-lg-5,.mx-lg-5{margin-right:3rem!important}.mb-lg-5,.my-lg-5{margin-bottom:3rem!important}.ml-lg-5,.mx-lg-5{margin-left:3rem!important}.p-lg-0{padding:0!important}.pt-lg-0,.py-lg-0{padding-top:0!important}.pr-lg-0,.px-lg-0{padding-right:0!important}.pb-lg-0,.py-lg-0{padding-bottom:0!important}.pl-lg-0,.px-lg-0{padding-left:0!important}.p-lg-1{padding:.25rem!important}.pt-lg-1,.py-lg-1{padding-top:.25rem!important}.pr-lg-1,.px-lg-1{padding-right:.25rem!important}.pb-lg-1,.py-lg-1{padding-bottom:.25rem!important}.pl-lg-1,.px-lg-1{padding-left:.25rem!important}.p-lg-2{padding:.5rem!important}.pt-lg-2,.py-lg-2{padding-top:.5rem!important}.pr-lg-2,.px-lg-2{padding-right:.5rem!important}.pb-lg-2,.py-lg-2{padding-bottom:.5rem!important}.pl-lg-2,.px-lg-2{padding-left:.5rem!important}.p-lg-3{padding:1rem!important}.pt-lg-3,.py-lg-3{padding-top:1rem!important}.pr-lg-3,.px-lg-3{padding-right:1rem!important}.pb-lg-3,.py-lg-3{padding-bottom:1rem!important}.pl-lg-3,.px-lg-3{padding-left:1rem!important}.p-lg-4{padding:1.5rem!important}.pt-lg-4,.py-lg-4{padding-top:1.5rem!important}.pr-lg-4,.px-lg-4{padding-right:1.5rem!important}.pb-lg-4,.py-lg-4{padding-bottom:1.5rem!important}.pl-lg-4,.px-lg-4{padding-left:1.5rem!important}.p-lg-5{padding:3rem!important}.pt-lg-5,.py-lg-5{padding-top:3rem!important}.pr-lg-5,.px-lg-5{padding-right:3rem!important}.pb-lg-5,.py-lg-5{padding-bottom:3rem!important}.pl-lg-5,.px-lg-5{padding-left:3rem!important}.m-lg-n1{margin:-.25rem!important}.mt-lg-n1,.my-lg-n1{margin-top:-.25rem!important}.mr-lg-n1,.mx-lg-n1{margin-right:-.25rem!important}.mb-lg-n1,.my-lg-n1{margin-bottom:-.25rem!important}.ml-lg-n1,.mx-lg-n1{margin-left:-.25rem!important}.m-lg-n2{margin:-.5rem!important}.mt-lg-n2,.my-lg-n2{margin-top:-.5rem!important}.mr-lg-n2,.mx-lg-n2{margin-right:-.5rem!important}.mb-lg-n2,.my-lg-n2{margin-bottom:-.5rem!important}.ml-lg-n2,.mx-lg-n2{margin-left:-.5rem!important}.m-lg-n3{margin:-1rem!important}.mt-lg-n3,.my-lg-n3{margin-top:-1rem!important}.mr-lg-n3,.mx-lg-n3{margin-right:-1rem!important}.mb-lg-n3,.my-lg-n3{margin-bottom:-1rem!important}.ml-lg-n3,.mx-lg-n3{margin-left:-1rem!important}.m-lg-n4{margin:-1.5rem!important}.mt-lg-n4,.my-lg-n4{margin-top:-1.5rem!important}.mr-lg-n4,.mx-lg-n4{margin-right:-1.5rem!important}.mb-lg-n4,.my-lg-n4{margin-bottom:-1.5rem!important}.ml-lg-n4,.mx-lg-n4{margin-left:-1.5rem!important}.m-lg-n5{margin:-3rem!important}.mt-lg-n5,.my-lg-n5{margin-top:-3rem!important}.mr-lg-n5,.mx-lg-n5{margin-right:-3rem!important}.mb-lg-n5,.my-lg-n5{margin-bottom:-3rem!important}.ml-lg-n5,.mx-lg-n5{margin-left:-3rem!important}.m-lg-auto{margin:auto!important}.mt-lg-auto,.my-lg-auto{margin-top:auto!important}.mr-lg-auto,.mx-lg-auto{margin-right:auto!important}.mb-lg-auto,.my-lg-auto{margin-bottom:auto!important}.ml-lg-auto,.mx-lg-auto{margin-left:auto!important}}@media (min-width:1200px){.m-xl-0{margin:0!important}.mt-xl-0,.my-xl-0{margin-top:0!important}.mr-xl-0,.mx-xl-0{margin-right:0!important}.mb-xl-0,.my-xl-0{margin-bottom:0!important}.ml-xl-0,.mx-xl-0{margin-left:0!important}.m-xl-1{margin:.25rem!important}.mt-xl-1,.my-xl-1{margin-top:.25rem!important}.mr-xl-1,.mx-xl-1{margin-right:.25rem!important}.mb-xl-1,.my-xl-1{margin-bottom:.25rem!important}.ml-xl-1,.mx-xl-1{margin-left:.25rem!important}.m-xl-2{margin:.5rem!important}.mt-xl-2,.my-xl-2{margin-top:.5rem!important}.mr-xl-2,.mx-xl-2{margin-right:.5rem!important}.mb-xl-2,.my-xl-2{margin-bottom:.5rem!important}.ml-xl-2,.mx-xl-2{margin-left:.5rem!important}.m-xl-3{margin:1rem!important}.mt-xl-3,.my-xl-3{margin-top:1rem!important}.mr-xl-3,.mx-xl-3{margin-right:1rem!important}.mb-xl-3,.my-xl-3{margin-bottom:1rem!important}.ml-xl-3,.mx-xl-3{margin-left:1rem!important}.m-xl-4{margin:1.5rem!important}.mt-xl-4,.my-xl-4{margin-top:1.5rem!important}.mr-xl-4,.mx-xl-4{margin-right:1.5rem!important}.mb-xl-4,.my-xl-4{margin-bottom:1.5rem!important}.ml-xl-4,.mx-xl-4{margin-left:1.5rem!important}.m-xl-5{margin:3rem!important}.mt-xl-5,.my-xl-5{margin-top:3rem!important}.mr-xl-5,.mx-xl-5{margin-right:3rem!important}.mb-xl-5,.my-xl-5{margin-bottom:3rem!important}.ml-xl-5,.mx-xl-5{margin-left:3rem!important}.p-xl-0{padding:0!important}.pt-xl-0,.py-xl-0{padding-top:0!important}.pr-xl-0,.px-xl-0{padding-right:0!important}.pb-xl-0,.py-xl-0{padding-bottom:0!important}.pl-xl-0,.px-xl-0{padding-left:0!important}.p-xl-1{padding:.25rem!important}.pt-xl-1,.py-xl-1{padding-top:.25rem!important}.pr-xl-1,.px-xl-1{padding-right:.25rem!important}.pb-xl-1,.py-xl-1{padding-bottom:.25rem!important}.pl-xl-1,.px-xl-1{padding-left:.25rem!important}.p-xl-2{padding:.5rem!important}.pt-xl-2,.py-xl-2{padding-top:.5rem!important}.pr-xl-2,.px-xl-2{padding-right:.5rem!important}.pb-xl-2,.py-xl-2{padding-bottom:.5rem!important}.pl-xl-2,.px-xl-2{padding-left:.5rem!important}.p-xl-3{padding:1rem!important}.pt-xl-3,.py-xl-3{padding-top:1rem!important}.pr-xl-3,.px-xl-3{padding-right:1rem!important}.pb-xl-3,.py-xl-3{padding-bottom:1rem!important}.pl-xl-3,.px-xl-3{padding-left:1rem!important}.p-xl-4{padding:1.5rem!important}.pt-xl-4,.py-xl-4{padding-top:1.5rem!important}.pr-xl-4,.px-xl-4{padding-right:1.5rem!important}.pb-xl-4,.py-xl-4{padding-bottom:1.5rem!important}.pl-xl-4,.px-xl-4{padding-left:1.5rem!important}.p-xl-5{padding:3rem!important}.pt-xl-5,.py-xl-5{padding-top:3rem!important}.pr-xl-5,.px-xl-5{padding-right:3rem!important}.pb-xl-5,.py-xl-5{padding-bottom:3rem!important}.pl-xl-5,.px-xl-5{padding-left:3rem!important}.m-xl-n1{margin:-.25rem!important}.mt-xl-n1,.my-xl-n1{margin-top:-.25rem!important}.mr-xl-n1,.mx-xl-n1{margin-right:-.25rem!important}.mb-xl-n1,.my-xl-n1{margin-bottom:-.25rem!important}.ml-xl-n1,.mx-xl-n1{margin-left:-.25rem!important}.m-xl-n2{margin:-.5rem!important}.mt-xl-n2,.my-xl-n2{margin-top:-.5rem!important}.mr-xl-n2,.mx-xl-n2{margin-right:-.5rem!important}.mb-xl-n2,.my-xl-n2{margin-bottom:-.5rem!important}.ml-xl-n2,.mx-xl-n2{margin-left:-.5rem!important}.m-xl-n3{margin:-1rem!important}.mt-xl-n3,.my-xl-n3{margin-top:-1rem!important}.mr-xl-n3,.mx-xl-n3{margin-right:-1rem!important}.mb-xl-n3,.my-xl-n3{margin-bottom:-1rem!important}.ml-xl-n3,.mx-xl-n3{margin-left:-1rem!important}.m-xl-n4{margin:-1.5rem!important}.mt-xl-n4,.my-xl-n4{margin-top:-1.5rem!important}.mr-xl-n4,.mx-xl-n4{margin-right:-1.5rem!important}.mb-xl-n4,.my-xl-n4{margin-bottom:-1.5rem!important}.ml-xl-n4,.mx-xl-n4{margin-left:-1.5rem!important}.m-xl-n5{margin:-3rem!important}.mt-xl-n5,.my-xl-n5{margin-top:-3rem!important}.mr-xl-n5,.mx-xl-n5{margin-right:-3rem!important}.mb-xl-n5,.my-xl-n5{margin-bottom:-3rem!important}.ml-xl-n5,.mx-xl-n5{margin-left:-3rem!important}.m-xl-auto{margin:auto!important}.mt-xl-auto,.my-xl-auto{margin-top:auto!important}.mr-xl-auto,.mx-xl-auto{margin-right:auto!important}.mb-xl-auto,.my-xl-auto{margin-bottom:auto!important}.ml-xl-auto,.mx-xl-auto{margin-left:auto!important}}.text-monospace{font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace!important}.text-justify{text-align:justify!important}.text-wrap{white-space:normal!important}.text-nowrap{white-space:nowrap!important}.text-truncate{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.text-left{text-align:left!important}.text-right{text-align:right!important}.text-center{text-align:center!important}@media (min-width:576px){.text-sm-left{text-align:left!important}.text-sm-right{text-align:right!important}.text-sm-center{text-align:center!important}}@media (min-width:768px){.text-md-left{text-align:left!important}.text-md-right{text-align:right!important}.text-md-center{text-align:center!important}}@media (min-width:992px){.text-lg-left{text-align:left!important}.text-lg-right{text-align:right!important}.text-lg-center{text-align:center!important}}@media (min-width:1200px){.text-xl-left{text-align:left!important}.text-xl-right{text-align:right!important}.text-xl-center{text-align:center!important}}.text-lowercase{text-transform:lowercase!important}.text-uppercase{text-transform:uppercase!important}.text-capitalize{text-transform:capitalize!important}.font-weight-light{font-weight:300!important}.font-weight-lighter{font-weight:lighter!important}.font-weight-normal{font-weight:400!important}.font-weight-bold{font-weight:700!important}.font-weight-bolder{font-weight:bolder!important}.font-italic{font-style:italic!important}.text-white{color:#fff!important}.text-primary{color:#007bff!important}a.text-primary:focus,a.text-primary:hover{color:#0056b3!important}.text-secondary{color:#6c757d!important}a.text-secondary:focus,a.text-secondary:hover{color:#494f54!important}.text-success{color:#28a745!important}a.text-success:focus,a.text-success:hover{color:#19692c!important}.text-info{color:#17a2b8!important}a.text-info:focus,a.text-info:hover{color:#0f6674!important}.text-warning{color:#ffc107!important}a.text-warning:focus,a.text-warning:hover{color:#ba8b00!important}.text-danger{color:#dc3545!important}a.text-danger:focus,a.text-danger:hover{color:#a71d2a!important}.text-light{color:#f8f9fa!important}a.text-light:focus,a.text-light:hover{color:#cbd3da!important}.text-dark{color:#343a40!important}a.text-dark:focus,a.text-dark:hover{color:#121416!important}.text-body{color:#212529!important}.text-muted{color:#6c757d!important}.text-black-50{color:rgba(0,0,0,.5)!important}.text-white-50{color:rgba(255,255,255,.5)!important}.text-hide{font:0/0 a;color:transparent;text-shadow:none;background-color:transparent;border:0}.text-decoration-none{text-decoration:none!important}.text-break{word-break:break-word!important;overflow-wrap:break-word!important}.text-reset{color:inherit!important}.visible{visibility:visible!important}.invisible{visibility:hidden!important}@media print{*,::after,::before{text-shadow:none!important;box-shadow:none!important}a:not(.btn){text-decoration:underline}abbr[title]::after{content:" (" attr(title) ")"}pre{white-space:pre-wrap!important}blockquote,pre{border:1px solid #adb5bd;page-break-inside:avoid}thead{display:table-header-group}img,tr{page-break-inside:avoid}h2,h3,p{orphans:3;widows:3}h2,h3{page-break-after:avoid}@page{size:a3}body{min-width:992px!important}.container{min-width:992px!important}.navbar{display:none}.badge{border:1px solid #000}.table{border-collapse:collapse!important}.table td,.table th{background-color:#fff!important}.table-bordered td,.table-bordered th{border:1px solid #dee2e6!important}.table-dark{color:inherit}.table-dark tbody+tbody,.table-dark td,.table-dark th,.table-dark thead th{border-color:#dee2e6}.table .thead-dark th{color:inherit;border-color:#dee2e6}}
+/*# sourceMappingURL=bootstrap.min.css.map */
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/bootstrap/bootstrap.min.css.map b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/bootstrap/bootstrap.min.css.map
new file mode 100644
index 0000000000..1e9cb78a53
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/bootstrap/bootstrap.min.css.map
@@ -0,0 +1 @@
+{"version":3,"sources":["../../scss/bootstrap.scss","../../scss/_root.scss","../../scss/_reboot.scss","dist/css/bootstrap.css","../../scss/vendor/_rfs.scss","bootstrap.css","../../scss/mixins/_hover.scss","../../scss/_type.scss","../../scss/mixins/_lists.scss","../../scss/_images.scss","../../scss/mixins/_image.scss","../../scss/mixins/_border-radius.scss","../../scss/_code.scss","../../scss/_grid.scss","../../scss/mixins/_grid.scss","../../scss/mixins/_breakpoints.scss","../../scss/mixins/_grid-framework.scss","../../scss/_tables.scss","../../scss/mixins/_table-row.scss","../../scss/_forms.scss","../../scss/mixins/_transition.scss","../../scss/mixins/_forms.scss","../../scss/mixins/_gradients.scss","../../scss/_buttons.scss","../../scss/mixins/_buttons.scss","../../scss/_transitions.scss","../../scss/_dropdown.scss","../../scss/mixins/_caret.scss","../../scss/mixins/_nav-divider.scss","../../scss/_button-group.scss","../../scss/_input-group.scss","../../scss/_custom-forms.scss","../../scss/_nav.scss","../../scss/_navbar.scss","../../scss/_card.scss","../../scss/_breadcrumb.scss","../../scss/_pagination.scss","../../scss/mixins/_pagination.scss","../../scss/_badge.scss","../../scss/mixins/_badge.scss","../../scss/_jumbotron.scss","../../scss/_alert.scss","../../scss/mixins/_alert.scss","../../scss/_progress.scss","../../scss/_media.scss","../../scss/_list-group.scss","../../scss/mixins/_list-group.scss","../../scss/_close.scss","../../scss/_toasts.scss","../../scss/_modal.scss","../../scss/_tooltip.scss","../../scss/mixins/_reset-text.scss","../../scss/_popover.scss","../../scss/_carousel.scss","../../scss/mixins/_clearfix.scss","../../scss/_spinners.scss","../../scss/utilities/_align.scss","../../scss/mixins/_background-variant.scss","../../scss/utilities/_background.scss","../../scss/utilities/_borders.scss","../../scss/utilities/_display.scss","../../scss/utilities/_embed.scss","../../scss/utilities/_flex.scss","../../scss/utilities/_float.scss","../../scss/utilities/_overflow.scss","../../scss/utilities/_position.scss","../../scss/utilities/_screenreaders.scss","../../scss/mixins/_screen-reader.scss","../../scss/utilities/_shadows.scss","../../scss/utilities/_sizing.scss","../../scss/utilities/_stretched-link.scss","../../scss/utilities/_spacing.scss","../../scss/utilities/_text.scss","../../scss/mixins/_text-truncate.scss","../../scss/mixins/_text-emphasis.scss","../../scss/mixins/_text-hide.scss","../../scss/utilities/_visibility.scss","../../scss/_print.scss"],"names":[],"mappings":"AAAA;;;;;ACAA,MAGI,OAAA,QAAA,SAAA,QAAA,SAAA,QAAA,OAAA,QAAA,MAAA,QAAA,SAAA,QAAA,SAAA,QAAA,QAAA,QAAA,OAAA,QAAA,OAAA,QAAA,QAAA,KAAA,OAAA,QAAA,YAAA,QAIA,UAAA,QAAA,YAAA,QAAA,UAAA,QAAA,OAAA,QAAA,UAAA,QAAA,SAAA,QAAA,QAAA,QAAA,OAAA,QAIA,gBAAA,EAAA,gBAAA,MAAA,gBAAA,MAAA,gBAAA,MAAA,gBAAA,OAKF,yBAAA,aAAA,CAAA,kBAAA,CAAA,UAAA,CAAA,MAAA,CAAA,gBAAA,CAAA,KAAA,CAAA,WAAA,CAAA,UAAA,CAAA,mBAAA,CAAA,gBAAA,CAAA,iBAAA,CAAA,mBACA,wBAAA,cAAA,CAAA,KAAA,CAAA,MAAA,CAAA,QAAA,CAAA,iBAAA,CAAA,aAAA,CAAA,UCCF,ECqBA,QADA,SDjBE,WAAA,WAGF,KACE,YAAA,WACA,YAAA,KACA,yBAAA,KACA,4BAAA,YAMF,QAAA,MAAA,WAAA,OAAA,OAAA,OAAA,OAAA,KAAA,IAAA,QACE,QAAA,MAUF,KACE,OAAA,EACA,YAAA,aAAA,CAAA,kBAAA,CAAA,UAAA,CAAA,MAAA,CAAA,gBAAA,CAAA,KAAA,CAAA,WAAA,CAAA,UAAA,CAAA,mBAAA,CAAA,gBAAA,CAAA,iBAAA,CAAA,mBEgFI,UAAA,KF9EJ,YAAA,IACA,YAAA,IACA,MAAA,QACA,WAAA,KACA,iBAAA,KGYF,sBHHE,QAAA,YASF,GACE,WAAA,YACA,OAAA,EACA,SAAA,QAaF,GAAA,GAAA,GAAA,GAAA,GAAA,GACE,WAAA,EACA,cAAA,MAOF,EACE,WAAA,EACA,cAAA,KCZF,0BDuBA,YAEE,gBAAA,UACA,wBAAA,UAAA,OAAA,gBAAA,UAAA,OACA,OAAA,KACA,cAAA,EACA,iCAAA,KAAA,yBAAA,KAGF,QACE,cAAA,KACA,WAAA,OACA,YAAA,QCjBF,GDoBA,GCrBA,GDwBE,WAAA,EACA,cAAA,KAGF,MCpBA,MACA,MAFA,MDyBE,cAAA,EAGF,GACE,YAAA,IAGF,GACE,cAAA,MACA,YAAA,EAGF,WACE,OAAA,EAAA,EAAA,KAGF,ECrBA,ODuBE,YAAA,OAGF,MEpFI,UAAA,IF6FJ,IC1BA,ID4BE,SAAA,SE/FE,UAAA,IFiGF,YAAA,EACA,eAAA,SAGF,IAAM,OAAA,OACN,IAAM,IAAA,MAON,EACE,MAAA,QACA,gBAAA,KACA,iBAAA,YI5KA,QJ+KE,MAAA,QACA,gBAAA,UAUJ,8BACE,MAAA,QACA,gBAAA,KIxLA,oCAAA,oCJ2LE,MAAA,QACA,gBAAA,KANJ,oCAUI,QAAA,EC5BJ,KACA,IDoCA,ICnCA,KDuCE,YAAA,cAAA,CAAA,KAAA,CAAA,MAAA,CAAA,QAAA,CAAA,iBAAA,CAAA,aAAA,CAAA,UErJE,UAAA,IFyJJ,IAEE,WAAA,EAEA,cAAA,KAEA,SAAA,KAQF,OAEE,OAAA,EAAA,EAAA,KAQF,IACE,eAAA,OACA,aAAA,KAGF,IAGE,SAAA,OACA,eAAA,OAQF,MACE,gBAAA,SAGF,QACE,YAAA,OACA,eAAA,OACA,MAAA,QACA,WAAA,KACA,aAAA,OAGF,GAGE,WAAA,QAQF,MAEE,QAAA,aACA,cAAA,MAMF,OAEE,cAAA,EAOF,aACE,QAAA,IAAA,OACA,QAAA,IAAA,KAAA,yBCvEF,OD0EA,MCxEA,SADA,OAEA,SD4EE,OAAA,EACA,YAAA,QEtPE,UAAA,QFwPF,YAAA,QAGF,OC1EA,MD4EE,SAAA,QAGF,OC1EA,OD4EE,eAAA,KAMF,OACE,UAAA,OC1EF,cACA,aACA,cD+EA,OAIE,mBAAA,OC9EF,6BACA,4BACA,6BDiFE,sBAKI,OAAA,QCjFN,gCACA,+BACA,gCDqFA,yBAIE,QAAA,EACA,aAAA,KCpFF,qBDuFA,kBAEE,WAAA,WACA,QAAA,EAIF,iBCvFA,2BACA,kBAFA,iBDiGE,mBAAA,QAGF,SACE,SAAA,KAEA,OAAA,SAGF,SAME,UAAA,EAEA,QAAA,EACA,OAAA,EACA,OAAA,EAKF,OACE,QAAA,MACA,MAAA,KACA,UAAA,KACA,QAAA,EACA,cAAA,MElSI,UAAA,OFoSJ,YAAA,QACA,MAAA,QACA,YAAA,OAGF,SACE,eAAA,SGtGF,yCFGA,yCDyGE,OAAA,KGvGF,cH+GE,eAAA,KACA,mBAAA,KG3GF,yCHmHE,mBAAA,KAQF,6BACE,KAAA,QACA,mBAAA,OAOF,OACE,QAAA,aAGF,QACE,QAAA,UACA,OAAA,QAGF,SACE,QAAA,KGxHF,SH8HE,QAAA,eCvHF,IAAK,IAAK,IAAK,IAAK,IAAK,IIpWzB,GAAA,GAAA,GAAA,GAAA,GAAA,GAEE,cAAA,MAEA,YAAA,IACA,YAAA,IAIF,IAAA,GHgHM,UAAA,OG/GN,IAAA,GH+GM,UAAA,KG9GN,IAAA,GH8GM,UAAA,QG7GN,IAAA,GH6GM,UAAA,OG5GN,IAAA,GH4GM,UAAA,QG3GN,IAAA,GH2GM,UAAA,KGzGN,MHyGM,UAAA,QGvGJ,YAAA,IAIF,WHmGM,UAAA,KGjGJ,YAAA,IACA,YAAA,IAEF,WH8FM,UAAA,OG5FJ,YAAA,IACA,YAAA,IAEF,WHyFM,UAAA,OGvFJ,YAAA,IACA,YAAA,IAEF,WHoFM,UAAA,OGlFJ,YAAA,IACA,YAAA,ILyBF,GKhBE,WAAA,KACA,cAAA,KACA,OAAA,EACA,WAAA,IAAA,MAAA,eJmXF,OI3WA,MHMI,UAAA,IGHF,YAAA,IJ8WF,MI3WA,KAEE,QAAA,KACA,iBAAA,QAQF,eC/EE,aAAA,EACA,WAAA,KDmFF,aCpFE,aAAA,EACA,WAAA,KDsFF,kBACE,QAAA,aADF,mCAII,aAAA,MAUJ,YHjCI,UAAA,IGmCF,eAAA,UAIF,YACE,cAAA,KHeI,UAAA,QGXN,mBACE,QAAA,MH7CE,UAAA,IG+CF,MAAA,QAHF,2BAMI,QAAA,aEnHJ,WCIE,UAAA,KAGA,OAAA,KDDF,eACE,QAAA,OACA,iBAAA,KACA,OAAA,IAAA,MAAA,QEXE,cAAA,ODMF,UAAA,KAGA,OAAA,KDcF,QAEE,QAAA,aAGF,YACE,cAAA,MACA,YAAA,EAGF,gBLkCI,UAAA,IKhCF,MAAA,QGvCF,KRuEI,UAAA,MQrEF,MAAA,QACA,WAAA,WAGA,OACE,MAAA,QAKJ,IACE,QAAA,MAAA,MR0DE,UAAA,MQxDF,MAAA,KACA,iBAAA,QDZE,cAAA,MCQJ,QASI,QAAA,ERkDA,UAAA,KQhDA,YAAA,IVyMJ,IUlME,QAAA,MRyCE,UAAA,MQvCF,MAAA,QAHF,SR0CI,UAAA,QQlCA,MAAA,QACA,WAAA,OAKJ,gBACE,WAAA,MACA,WAAA,OCzCA,WCAA,MAAA,KACA,cAAA,KACA,aAAA,KACA,aAAA,KACA,YAAA,KCmDE,yBFvDF,WCYI,UAAA,OC2CF,yBFvDF,WCYI,UAAA,OC2CF,yBFvDF,WCYI,UAAA,OC2CF,0BFvDF,WCYI,UAAA,QDAJ,iBCZA,MAAA,KACA,cAAA,KACA,aAAA,KACA,aAAA,KACA,YAAA,KDkBA,KCJA,QAAA,YAAA,QAAA,KACA,cAAA,KAAA,UAAA,KACA,aAAA,MACA,YAAA,MDOA,YACE,aAAA,EACA,YAAA,EAFF,iBVyjBF,0BUnjBM,cAAA,EACA,aAAA,EGjCJ,KAAA,OAAA,QAAA,QAAA,QAAA,OAAA,OAAA,OAAA,OAAA,OAAA,OAAA,OAAA,ObylBF,UAEqJ,QAAvI,UAAmG,WAAY,WAAY,WAAhH,UAAW,UAAW,UAAW,UAAW,UAAW,UAAW,UAAW,UACtG,aAFqJ,QAAvI,UAAmG,WAAY,WAAY,WAAhH,UAAW,UAAW,UAAW,UAAW,UAAW,UAAW,UAAW,UACtG,aAFkJ,QAAvI,UAAmG,WAAY,WAAY,WAAhH,UAAW,UAAW,UAAW,UAAW,UAAW,UAAW,UAAW,UACnG,aAEqJ,QAAvI,UAAmG,WAAY,WAAY,WAAhH,UAAW,UAAW,UAAW,UAAW,UAAW,UAAW,UAAW,UACtG,aa5lBI,SAAA,SACA,MAAA,KACA,cAAA,KACA,aAAA,KAmBE,KACE,wBAAA,EAAA,WAAA,EACA,kBAAA,EAAA,UAAA,EACA,UAAA,KAEF,UACE,SAAA,EAAA,EAAA,KAAA,KAAA,EAAA,EAAA,KACA,MAAA,KACA,UAAA,KAIA,OFFN,SAAA,EAAA,EAAA,UAAA,KAAA,EAAA,EAAA,UAIA,UAAA,UEFM,OFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,OFFN,SAAA,EAAA,EAAA,IAAA,KAAA,EAAA,EAAA,IAIA,UAAA,IEFM,OFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,OFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,OFFN,SAAA,EAAA,EAAA,IAAA,KAAA,EAAA,EAAA,IAIA,UAAA,IEFM,OFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,OFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,OFFN,SAAA,EAAA,EAAA,IAAA,KAAA,EAAA,EAAA,IAIA,UAAA,IEFM,QFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,QFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,QFFN,SAAA,EAAA,EAAA,KAAA,KAAA,EAAA,EAAA,KAIA,UAAA,KEGI,aAAwB,eAAA,GAAA,MAAA,GAExB,YAAuB,eAAA,GAAA,MAAA,GAGrB,SAAwB,eAAA,EAAA,MAAA,EAAxB,SAAwB,eAAA,EAAA,MAAA,EAAxB,SAAwB,eAAA,EAAA,MAAA,EAAxB,SAAwB,eAAA,EAAA,MAAA,EAAxB,SAAwB,eAAA,EAAA,MAAA,EAAxB,SAAwB,eAAA,EAAA,MAAA,EAAxB,SAAwB,eAAA,EAAA,MAAA,EAAxB,SAAwB,eAAA,EAAA,MAAA,EAAxB,SAAwB,eAAA,EAAA,MAAA,EAAxB,SAAwB,eAAA,EAAA,MAAA,EAAxB,UAAwB,eAAA,GAAA,MAAA,GAAxB,UAAwB,eAAA,GAAA,MAAA,GAAxB,UAAwB,eAAA,GAAA,MAAA,GAMtB,UFTR,YAAA,UESQ,UFTR,YAAA,WESQ,UFTR,YAAA,IESQ,UFTR,YAAA,WESQ,UFTR,YAAA,WESQ,UFTR,YAAA,IESQ,UFTR,YAAA,WESQ,UFTR,YAAA,WESQ,UFTR,YAAA,IESQ,WFTR,YAAA,WESQ,WFTR,YAAA,WCWE,yBC9BE,QACE,wBAAA,EAAA,WAAA,EACA,kBAAA,EAAA,UAAA,EACA,UAAA,KAEF,aACE,SAAA,EAAA,EAAA,KAAA,KAAA,EAAA,EAAA,KACA,MAAA,KACA,UAAA,KAIA,UFFN,SAAA,EAAA,EAAA,UAAA,KAAA,EAAA,EAAA,UAIA,UAAA,UEFM,UFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,UFFN,SAAA,EAAA,EAAA,IAAA,KAAA,EAAA,EAAA,IAIA,UAAA,IEFM,UFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,UFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,UFFN,SAAA,EAAA,EAAA,IAAA,KAAA,EAAA,EAAA,IAIA,UAAA,IEFM,UFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,UFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,UFFN,SAAA,EAAA,EAAA,IAAA,KAAA,EAAA,EAAA,IAIA,UAAA,IEFM,WFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,WFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,WFFN,SAAA,EAAA,EAAA,KAAA,KAAA,EAAA,EAAA,KAIA,UAAA,KEGI,gBAAwB,eAAA,GAAA,MAAA,GAExB,eAAuB,eAAA,GAAA,MAAA,GAGrB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,aAAwB,eAAA,GAAA,MAAA,GAAxB,aAAwB,eAAA,GAAA,MAAA,GAAxB,aAAwB,eAAA,GAAA,MAAA,GAMtB,aFTR,YAAA,EESQ,aFTR,YAAA,UESQ,aFTR,YAAA,WESQ,aFTR,YAAA,IESQ,aFTR,YAAA,WESQ,aFTR,YAAA,WESQ,aFTR,YAAA,IESQ,aFTR,YAAA,WESQ,aFTR,YAAA,WESQ,aFTR,YAAA,IESQ,cFTR,YAAA,WESQ,cFTR,YAAA,YCWE,yBC9BE,QACE,wBAAA,EAAA,WAAA,EACA,kBAAA,EAAA,UAAA,EACA,UAAA,KAEF,aACE,SAAA,EAAA,EAAA,KAAA,KAAA,EAAA,EAAA,KACA,MAAA,KACA,UAAA,KAIA,UFFN,SAAA,EAAA,EAAA,UAAA,KAAA,EAAA,EAAA,UAIA,UAAA,UEFM,UFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,UFFN,SAAA,EAAA,EAAA,IAAA,KAAA,EAAA,EAAA,IAIA,UAAA,IEFM,UFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,UFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,UFFN,SAAA,EAAA,EAAA,IAAA,KAAA,EAAA,EAAA,IAIA,UAAA,IEFM,UFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,UFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,UFFN,SAAA,EAAA,EAAA,IAAA,KAAA,EAAA,EAAA,IAIA,UAAA,IEFM,WFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,WFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,WFFN,SAAA,EAAA,EAAA,KAAA,KAAA,EAAA,EAAA,KAIA,UAAA,KEGI,gBAAwB,eAAA,GAAA,MAAA,GAExB,eAAuB,eAAA,GAAA,MAAA,GAGrB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,aAAwB,eAAA,GAAA,MAAA,GAAxB,aAAwB,eAAA,GAAA,MAAA,GAAxB,aAAwB,eAAA,GAAA,MAAA,GAMtB,aFTR,YAAA,EESQ,aFTR,YAAA,UESQ,aFTR,YAAA,WESQ,aFTR,YAAA,IESQ,aFTR,YAAA,WESQ,aFTR,YAAA,WESQ,aFTR,YAAA,IESQ,aFTR,YAAA,WESQ,aFTR,YAAA,WESQ,aFTR,YAAA,IESQ,cFTR,YAAA,WESQ,cFTR,YAAA,YCWE,yBC9BE,QACE,wBAAA,EAAA,WAAA,EACA,kBAAA,EAAA,UAAA,EACA,UAAA,KAEF,aACE,SAAA,EAAA,EAAA,KAAA,KAAA,EAAA,EAAA,KACA,MAAA,KACA,UAAA,KAIA,UFFN,SAAA,EAAA,EAAA,UAAA,KAAA,EAAA,EAAA,UAIA,UAAA,UEFM,UFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,UFFN,SAAA,EAAA,EAAA,IAAA,KAAA,EAAA,EAAA,IAIA,UAAA,IEFM,UFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,UFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,UFFN,SAAA,EAAA,EAAA,IAAA,KAAA,EAAA,EAAA,IAIA,UAAA,IEFM,UFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,UFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,UFFN,SAAA,EAAA,EAAA,IAAA,KAAA,EAAA,EAAA,IAIA,UAAA,IEFM,WFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,WFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,WFFN,SAAA,EAAA,EAAA,KAAA,KAAA,EAAA,EAAA,KAIA,UAAA,KEGI,gBAAwB,eAAA,GAAA,MAAA,GAExB,eAAuB,eAAA,GAAA,MAAA,GAGrB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,aAAwB,eAAA,GAAA,MAAA,GAAxB,aAAwB,eAAA,GAAA,MAAA,GAAxB,aAAwB,eAAA,GAAA,MAAA,GAMtB,aFTR,YAAA,EESQ,aFTR,YAAA,UESQ,aFTR,YAAA,WESQ,aFTR,YAAA,IESQ,aFTR,YAAA,WESQ,aFTR,YAAA,WESQ,aFTR,YAAA,IESQ,aFTR,YAAA,WESQ,aFTR,YAAA,WESQ,aFTR,YAAA,IESQ,cFTR,YAAA,WESQ,cFTR,YAAA,YCWE,0BC9BE,QACE,wBAAA,EAAA,WAAA,EACA,kBAAA,EAAA,UAAA,EACA,UAAA,KAEF,aACE,SAAA,EAAA,EAAA,KAAA,KAAA,EAAA,EAAA,KACA,MAAA,KACA,UAAA,KAIA,UFFN,SAAA,EAAA,EAAA,UAAA,KAAA,EAAA,EAAA,UAIA,UAAA,UEFM,UFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,UFFN,SAAA,EAAA,EAAA,IAAA,KAAA,EAAA,EAAA,IAIA,UAAA,IEFM,UFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,UFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,UFFN,SAAA,EAAA,EAAA,IAAA,KAAA,EAAA,EAAA,IAIA,UAAA,IEFM,UFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,UFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,UFFN,SAAA,EAAA,EAAA,IAAA,KAAA,EAAA,EAAA,IAIA,UAAA,IEFM,WFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,WFFN,SAAA,EAAA,EAAA,WAAA,KAAA,EAAA,EAAA,WAIA,UAAA,WEFM,WFFN,SAAA,EAAA,EAAA,KAAA,KAAA,EAAA,EAAA,KAIA,UAAA,KEGI,gBAAwB,eAAA,GAAA,MAAA,GAExB,eAAuB,eAAA,GAAA,MAAA,GAGrB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,YAAwB,eAAA,EAAA,MAAA,EAAxB,aAAwB,eAAA,GAAA,MAAA,GAAxB,aAAwB,eAAA,GAAA,MAAA,GAAxB,aAAwB,eAAA,GAAA,MAAA,GAMtB,aFTR,YAAA,EESQ,aFTR,YAAA,UESQ,aFTR,YAAA,WESQ,aFTR,YAAA,IESQ,aFTR,YAAA,WESQ,aFTR,YAAA,WESQ,aFTR,YAAA,IESQ,aFTR,YAAA,WESQ,aFTR,YAAA,WESQ,aFTR,YAAA,IESQ,cFTR,YAAA,WESQ,cFTR,YAAA,YG7CF,OACE,MAAA,KACA,cAAA,KACA,MAAA,Qdy+CF,Uc5+CA,UAQI,QAAA,OACA,eAAA,IACA,WAAA,IAAA,MAAA,QAVJ,gBAcI,eAAA,OACA,cAAA,IAAA,MAAA,QAfJ,mBAmBI,WAAA,IAAA,MAAA,Qdy+CJ,ach+CA,aAGI,QAAA,MASJ,gBACE,OAAA,IAAA,MAAA,Qd49CF,mBc79CA,mBAKI,OAAA,IAAA,MAAA,Qd69CJ,yBcl+CA,yBAWM,oBAAA,Id89CN,8BAFA,qBcv9CA,qBdw9CA,2Bcn9CI,OAAA,EAQJ,yCAEI,iBAAA,gBX/DF,4BW2EI,MAAA,QACA,iBAAA,iBCnFJ,ef+hDF,kBADA,kBe1hDM,iBAAA,QfkiDN,2BAFA,kBepiDE,kBfqiDF,wBezhDQ,aAAA,QZLN,kCYiBM,iBAAA,QALN,qCf4hDF,qCenhDU,iBAAA,QA5BR,iBfqjDF,oBADA,oBehjDM,iBAAA,QfwjDN,6BAFA,oBe1jDE,oBf2jDF,0Be/iDQ,aAAA,QZLN,oCYiBM,iBAAA,QALN,uCfkjDF,uCeziDU,iBAAA,QA5BR,ef2kDF,kBADA,kBetkDM,iBAAA,Qf8kDN,2BAFA,kBehlDE,kBfilDF,wBerkDQ,aAAA,QZLN,kCYiBM,iBAAA,QALN,qCfwkDF,qCe/jDU,iBAAA,QA5BR,YfimDF,eADA,ee5lDM,iBAAA,QfomDN,wBAFA,eetmDE,efumDF,qBe3lDQ,aAAA,QZLN,+BYiBM,iBAAA,QALN,kCf8lDF,kCerlDU,iBAAA,QA5BR,efunDF,kBADA,kBelnDM,iBAAA,Qf0nDN,2BAFA,kBe5nDE,kBf6nDF,wBejnDQ,aAAA,QZLN,kCYiBM,iBAAA,QALN,qCfonDF,qCe3mDU,iBAAA,QA5BR,cf6oDF,iBADA,iBexoDM,iBAAA,QfgpDN,0BAFA,iBelpDE,iBfmpDF,uBevoDQ,aAAA,QZLN,iCYiBM,iBAAA,QALN,oCf0oDF,oCejoDU,iBAAA,QA5BR,afmqDF,gBADA,gBe9pDM,iBAAA,QfsqDN,yBAFA,gBexqDE,gBfyqDF,sBe7pDQ,aAAA,QZLN,gCYiBM,iBAAA,QALN,mCfgqDF,mCevpDU,iBAAA,QA5BR,YfyrDF,eADA,eeprDM,iBAAA,Qf4rDN,wBAFA,ee9rDE,ef+rDF,qBenrDQ,aAAA,QZLN,+BYiBM,iBAAA,QALN,kCfsrDF,kCe7qDU,iBAAA,QA5BR,cf+sDF,iBADA,iBe1sDM,iBAAA,iBZGJ,iCYiBM,iBAAA,iBALN,oCfqsDF,oCe5rDU,iBAAA,iBD8EV,sBAGM,MAAA,KACA,iBAAA,QACA,aAAA,QALN,uBAWM,MAAA,QACA,iBAAA,QACA,aAAA,QAKN,YACE,MAAA,KACA,iBAAA,QdgnDF,eclnDA,edmnDA,qBc5mDI,aAAA,QAPJ,2BAWI,OAAA,EAXJ,oDAgBM,iBAAA,sBXrIJ,uCW4IM,MAAA,KACA,iBAAA,uBFhFJ,4BEiGA,qBAEI,QAAA,MACA,MAAA,KACA,WAAA,KACA,2BAAA,MALH,qCASK,OAAA,GF1GN,4BEiGA,qBAEI,QAAA,MACA,MAAA,KACA,WAAA,KACA,2BAAA,MALH,qCASK,OAAA,GF1GN,4BEiGA,qBAEI,QAAA,MACA,MAAA,KACA,WAAA,KACA,2BAAA,MALH,qCASK,OAAA,GF1GN,6BEiGA,qBAEI,QAAA,MACA,MAAA,KACA,WAAA,KACA,2BAAA,MALH,qCASK,OAAA,GAdV,kBAOQ,QAAA,MACA,MAAA,KACA,WAAA,KACA,2BAAA,MAVR,kCAcU,OAAA,EE7KV,cACE,QAAA,MACA,MAAA,KACA,OAAA,2BACA,QAAA,QAAA,OfqHI,UAAA,KelHJ,YAAA,IACA,YAAA,IACA,MAAA,QACA,iBAAA,KACA,gBAAA,YACA,OAAA,IAAA,MAAA,QRbE,cAAA,OSCE,WAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YAKF,uCDLJ,cCMM,WAAA,MDNN,0BAsBI,iBAAA,YACA,OAAA,EEhBF,oBACE,MAAA,QACA,iBAAA,KACA,aAAA,QACA,QAAA,EAKE,WAAA,EAAA,EAAA,EAAA,MAAA,oBFhBN,yCA+BI,MAAA,QAEA,QAAA,EAjCJ,gCA+BI,MAAA,QAEA,QAAA,EAjCJ,oCA+BI,MAAA,QAEA,QAAA,EAjCJ,qCA+BI,MAAA,QAEA,QAAA,EAjCJ,2BA+BI,MAAA,QAEA,QAAA,EAjCJ,uBAAA,wBA2CI,iBAAA,QAEA,QAAA,EAIJ,qCAOI,MAAA,QACA,iBAAA,KAKJ,mBhBm0DA,oBgBj0DE,QAAA,MACA,MAAA,KAUF,gBACE,YAAA,oBACA,eAAA,oBACA,cAAA,EfZE,UAAA,QecF,YAAA,IAGF,mBACE,YAAA,kBACA,eAAA,kBfoCI,UAAA,QelCJ,YAAA,IAGF,mBACE,YAAA,mBACA,eAAA,mBf6BI,UAAA,Qe3BJ,YAAA,IASF,wBACE,QAAA,MACA,MAAA,KACA,YAAA,QACA,eAAA,QACA,cAAA,EACA,YAAA,IACA,MAAA,QACA,iBAAA,YACA,OAAA,MAAA,YACA,aAAA,IAAA,EAVF,wCAAA,wCAcI,cAAA,EACA,aAAA,EAYJ,iBACE,OAAA,0BACA,QAAA,OAAA,MfXI,UAAA,QeaJ,YAAA,IRvIE,cAAA,MQ2IJ,iBACE,OAAA,yBACA,QAAA,MAAA,KfnBI,UAAA,QeqBJ,YAAA,IR/IE,cAAA,MQoJJ,8BAAA,0BAGI,OAAA,KAIJ,sBACE,OAAA,KAQF,YACE,cAAA,KAGF,WACE,QAAA,MACA,WAAA,OAQF,UACE,QAAA,YAAA,QAAA,KACA,cAAA,KAAA,UAAA,KACA,aAAA,KACA,YAAA,KAJF,ehBwyDA,wBgBhyDI,cAAA,IACA,aAAA,IASJ,YACE,SAAA,SACA,QAAA,MACA,aAAA,QAGF,kBACE,SAAA,SACA,WAAA,MACA,YAAA,SAHF,6CAMI,MAAA,QAIJ,kBACE,cAAA,EAGF,mBACE,QAAA,mBAAA,QAAA,YACA,eAAA,OAAA,YAAA,OACA,aAAA,EACA,aAAA,OAJF,qCAQI,SAAA,OACA,WAAA,EACA,aAAA,SACA,YAAA,EE3MF,gBACE,QAAA,KACA,MAAA,KACA,WAAA,OjBwCA,UAAA,IiBtCA,MAAA,QAGF,eACE,SAAA,SACA,IAAA,KACA,QAAA,EACA,QAAA,KACA,UAAA,KACA,QAAA,OAAA,MACA,WAAA,MjBmFE,UAAA,QiBjFF,YAAA,IACA,MAAA,KACA,iBAAA,mBV3CA,cAAA,OUgDA,uBAAA,mCAEE,aAAA,QAGE,cAAA,qBACA,iBAAA,2OACA,kBAAA,UACA,oBAAA,OAAA,MAAA,wBACA,gBAAA,sBAAA,sBATJ,6BAAA,yCAaI,aAAA,QACA,WAAA,EAAA,EAAA,EAAA,MAAA,oBlB2+D6C,uCACrD,sCkB1/DI,mDlBy/DJ,kDkBt+DQ,QAAA,MAOJ,2CAAA,+BAGI,cAAA,qBACA,oBAAA,IAAA,wBAAA,MAAA,wBAMJ,wBAAA,oCAEE,aAAA,QAGE,cAAA,uCACA,WAAA,0JAAA,UAAA,MAAA,OAAA,MAAA,CAAA,IAAA,IAAA,CAAA,2OAAA,KAAA,UAAA,OAAA,MAAA,OAAA,CAAA,sBAAA,sBANJ,8BAAA,0CAUI,aAAA,QACA,WAAA,EAAA,EAAA,EAAA,MAAA,oBlBg+D8C,wCACtD,uCkB5+DI,oDlB2+DJ,mDkB39DQ,QAAA,MlBi+DkD,4CAC1D,2CkB39DI,wDlB09DJ,uDkBt9DQ,QAAA,MAMJ,6CAAA,yDAGI,MAAA,QlBu9DiD,2CACzD,0CkB39DI,uDlB09DJ,sDkBl9DQ,QAAA,MAMJ,qDAAA,iEAGI,MAAA,QAHJ,6DAAA,yEAMM,aAAA,QlBo9DmD,+CAC7D,8CkB39DI,2DlB09DJ,0DkB98DQ,QAAA,MAZJ,qEAAA,iFAiBM,aAAA,QCnJN,iBAAA,QDkIA,mEAAA,+EAwBM,WAAA,EAAA,EAAA,EAAA,MAAA,oBAxBN,iFAAA,6FA4BM,aAAA,QAQN,+CAAA,2DAGI,aAAA,QlB08DkD,4CAC1D,2CkB98DI,wDlB68DJ,uDkBr8DQ,QAAA,MARJ,qDAAA,iEAaM,aAAA,QACA,WAAA,EAAA,EAAA,EAAA,MAAA,oBA7JR,kBACE,QAAA,KACA,MAAA,KACA,WAAA,OjBwCA,UAAA,IiBtCA,MAAA,QAGF,iBACE,SAAA,SACA,IAAA,KACA,QAAA,EACA,QAAA,KACA,UAAA,KACA,QAAA,OAAA,MACA,WAAA,MjBmFE,UAAA,QiBjFF,YAAA,IACA,MAAA,KACA,iBAAA,mBV3CA,cAAA,OUgDA,yBAAA,qCAEE,aAAA,QAGE,cAAA,qBACA,iBAAA,qRACA,kBAAA,UACA,oBAAA,OAAA,MAAA,wBACA,gBAAA,sBAAA,sBATJ,+BAAA,2CAaI,aAAA,QACA,WAAA,EAAA,EAAA,EAAA,MAAA,oBlBsmEiD,2CACzD,0CkBrnEI,uDlBonEJ,sDkBjmEQ,QAAA,MAOJ,6CAAA,iCAGI,cAAA,qBACA,oBAAA,IAAA,wBAAA,MAAA,wBAMJ,0BAAA,sCAEE,aAAA,QAGE,cAAA,uCACA,WAAA,0JAAA,UAAA,MAAA,OAAA,MAAA,CAAA,IAAA,IAAA,CAAA,qRAAA,KAAA,UAAA,OAAA,MAAA,OAAA,CAAA,sBAAA,sBANJ,gCAAA,4CAUI,aAAA,QACA,WAAA,EAAA,EAAA,EAAA,MAAA,oBlB2lEkD,4CAC1D,2CkBvmEI,wDlBsmEJ,uDkBtlEQ,QAAA,MlB4lEsD,gDAC9D,+CkBtlEI,4DlBqlEJ,2DkBjlEQ,QAAA,MAMJ,+CAAA,2DAGI,MAAA,QlBklEqD,+CAC7D,8CkBtlEI,2DlBqlEJ,0DkB7kEQ,QAAA,MAMJ,uDAAA,mEAGI,MAAA,QAHJ,+DAAA,2EAMM,aAAA,QlB+kEuD,mDACjE,kDkBtlEI,+DlBqlEJ,8DkBzkEQ,QAAA,MAZJ,uEAAA,mFAiBM,aAAA,QCnJN,iBAAA,QDkIA,qEAAA,iFAwBM,WAAA,EAAA,EAAA,EAAA,MAAA,oBAxBN,mFAAA,+FA4BM,aAAA,QAQN,iDAAA,6DAGI,aAAA,QlBqkEsD,gDAC9D,+CkBzkEI,4DlBwkEJ,2DkBhkEQ,QAAA,MARJ,uDAAA,mEAaM,aAAA,QACA,WAAA,EAAA,EAAA,EAAA,MAAA,oBFuEV,aACE,QAAA,YAAA,QAAA,KACA,cAAA,IAAA,KAAA,UAAA,IAAA,KACA,eAAA,OAAA,YAAA,OAHF,yBASI,MAAA,KJ9MA,yBIqMJ,mBAeM,QAAA,YAAA,QAAA,KACA,eAAA,OAAA,YAAA,OACA,cAAA,OAAA,gBAAA,OACA,cAAA,EAlBN,yBAuBM,QAAA,YAAA,QAAA,KACA,SAAA,EAAA,EAAA,KAAA,KAAA,EAAA,EAAA,KACA,cAAA,IAAA,KAAA,UAAA,IAAA,KACA,eAAA,OAAA,YAAA,OACA,cAAA,EA3BN,2BAgCM,QAAA,aACA,MAAA,KACA,eAAA,OAlCN,qCAuCM,QAAA,ahBigEJ,4BgBxiEF,0BA4CM,MAAA,KA5CN,yBAkDM,QAAA,YAAA,QAAA,KACA,eAAA,OAAA,YAAA,OACA,cAAA,OAAA,gBAAA,OACA,MAAA,KACA,aAAA,EAtDN,+BAyDM,SAAA,SACA,kBAAA,EAAA,YAAA,EACA,WAAA,EACA,aAAA,OACA,YAAA,EA7DN,6BAiEM,eAAA,OAAA,YAAA,OACA,cAAA,OAAA,gBAAA,OAlEN,mCAqEM,cAAA,GIhUN,KACE,QAAA,aAEA,YAAA,IACA,MAAA,QACA,WAAA,OACA,eAAA,OACA,oBAAA,KAAA,iBAAA,KAAA,gBAAA,KAAA,YAAA,KACA,iBAAA,YACA,OAAA,IAAA,MAAA,YCsFA,QAAA,QAAA,OpB0BI,UAAA,KoBxBJ,YAAA,IblGE,cAAA,OSCE,WAAA,MAAA,KAAA,WAAA,CAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YAKF,uCGLJ,KHMM,WAAA,MdAJ,WiBQE,MAAA,QACA,gBAAA,KAfJ,WAAA,WAoBI,QAAA,EACA,WAAA,EAAA,EAAA,EAAA,MAAA,oBArBJ,cAAA,cA2BI,QAAA,IAeJ,epBi0EA,wBoB/zEE,eAAA,KASA,aCrDA,MAAA,KFAE,iBAAA,QEEF,aAAA,QlBIA,mBkBAE,MAAA,KFNA,iBAAA,QEQA,aAAA,QAGF,mBAAA,mBAMI,WAAA,EAAA,EAAA,EAAA,MAAA,oBAKJ,sBAAA,sBAEE,MAAA,KACA,iBAAA,QACA,aAAA,QAOF,kDAAA,kDrBq2EF,mCqBl2EI,MAAA,KACA,iBAAA,QAIA,aAAA,QAEA,wDAAA,wDrBk2EJ,yCqB71EQ,WAAA,EAAA,EAAA,EAAA,MAAA,oBDKN,eCrDA,MAAA,KFAE,iBAAA,QEEF,aAAA,QlBIA,qBkBAE,MAAA,KFNA,iBAAA,QEQA,aAAA,QAGF,qBAAA,qBAMI,WAAA,EAAA,EAAA,EAAA,MAAA,qBAKJ,wBAAA,wBAEE,MAAA,KACA,iBAAA,QACA,aAAA,QAOF,oDAAA,oDrBu4EF,qCqBp4EI,MAAA,KACA,iBAAA,QAIA,aAAA,QAEA,0DAAA,0DrBo4EJ,2CqB/3EQ,WAAA,EAAA,EAAA,EAAA,MAAA,qBDKN,aCrDA,MAAA,KFAE,iBAAA,QEEF,aAAA,QlBIA,mBkBAE,MAAA,KFNA,iBAAA,QEQA,aAAA,QAGF,mBAAA,mBAMI,WAAA,EAAA,EAAA,EAAA,MAAA,mBAKJ,sBAAA,sBAEE,MAAA,KACA,iBAAA,QACA,aAAA,QAOF,kDAAA,kDrBy6EF,mCqBt6EI,MAAA,KACA,iBAAA,QAIA,aAAA,QAEA,wDAAA,wDrBs6EJ,yCqBj6EQ,WAAA,EAAA,EAAA,EAAA,MAAA,mBDKN,UCrDA,MAAA,KFAE,iBAAA,QEEF,aAAA,QlBIA,gBkBAE,MAAA,KFNA,iBAAA,QEQA,aAAA,QAGF,gBAAA,gBAMI,WAAA,EAAA,EAAA,EAAA,MAAA,oBAKJ,mBAAA,mBAEE,MAAA,KACA,iBAAA,QACA,aAAA,QAOF,+CAAA,+CrB28EF,gCqBx8EI,MAAA,KACA,iBAAA,QAIA,aAAA,QAEA,qDAAA,qDrBw8EJ,sCqBn8EQ,WAAA,EAAA,EAAA,EAAA,MAAA,oBDKN,aCrDA,MAAA,QFAE,iBAAA,QEEF,aAAA,QlBIA,mBkBAE,MAAA,QFNA,iBAAA,QEQA,aAAA,QAGF,mBAAA,mBAMI,WAAA,EAAA,EAAA,EAAA,MAAA,oBAKJ,sBAAA,sBAEE,MAAA,QACA,iBAAA,QACA,aAAA,QAOF,kDAAA,kDrB6+EF,mCqB1+EI,MAAA,QACA,iBAAA,QAIA,aAAA,QAEA,wDAAA,wDrB0+EJ,yCqBr+EQ,WAAA,EAAA,EAAA,EAAA,MAAA,oBDKN,YCrDA,MAAA,KFAE,iBAAA,QEEF,aAAA,QlBIA,kBkBAE,MAAA,KFNA,iBAAA,QEQA,aAAA,QAGF,kBAAA,kBAMI,WAAA,EAAA,EAAA,EAAA,MAAA,mBAKJ,qBAAA,qBAEE,MAAA,KACA,iBAAA,QACA,aAAA,QAOF,iDAAA,iDrB+gFF,kCqB5gFI,MAAA,KACA,iBAAA,QAIA,aAAA,QAEA,uDAAA,uDrB4gFJ,wCqBvgFQ,WAAA,EAAA,EAAA,EAAA,MAAA,mBDKN,WCrDA,MAAA,QFAE,iBAAA,QEEF,aAAA,QlBIA,iBkBAE,MAAA,QFNA,iBAAA,QEQA,aAAA,QAGF,iBAAA,iBAMI,WAAA,EAAA,EAAA,EAAA,MAAA,qBAKJ,oBAAA,oBAEE,MAAA,QACA,iBAAA,QACA,aAAA,QAOF,gDAAA,gDrBijFF,iCqB9iFI,MAAA,QACA,iBAAA,QAIA,aAAA,QAEA,sDAAA,sDrB8iFJ,uCqBziFQ,WAAA,EAAA,EAAA,EAAA,MAAA,qBDKN,UCrDA,MAAA,KFAE,iBAAA,QEEF,aAAA,QlBIA,gBkBAE,MAAA,KFNA,iBAAA,QEQA,aAAA,QAGF,gBAAA,gBAMI,WAAA,EAAA,EAAA,EAAA,MAAA,kBAKJ,mBAAA,mBAEE,MAAA,KACA,iBAAA,QACA,aAAA,QAOF,+CAAA,+CrBmlFF,gCqBhlFI,MAAA,KACA,iBAAA,QAIA,aAAA,QAEA,qDAAA,qDrBglFJ,sCqB3kFQ,WAAA,EAAA,EAAA,EAAA,MAAA,kBDWN,qBCJA,MAAA,QACA,aAAA,QlBlDA,2BkBqDE,MAAA,KACA,iBAAA,QACA,aAAA,QAGF,2BAAA,2BAEE,WAAA,EAAA,EAAA,EAAA,MAAA,mBAGF,8BAAA,8BAEE,MAAA,QACA,iBAAA,YAGF,0DAAA,0DrBykFF,2CqBtkFI,MAAA,KACA,iBAAA,QACA,aAAA,QAEA,gEAAA,gErBykFJ,iDqBpkFQ,WAAA,EAAA,EAAA,EAAA,MAAA,mBD5BN,uBCJA,MAAA,QACA,aAAA,QlBlDA,6BkBqDE,MAAA,KACA,iBAAA,QACA,aAAA,QAGF,6BAAA,6BAEE,WAAA,EAAA,EAAA,EAAA,MAAA,qBAGF,gCAAA,gCAEE,MAAA,QACA,iBAAA,YAGF,4DAAA,4DrBymFF,6CqBtmFI,MAAA,KACA,iBAAA,QACA,aAAA,QAEA,kEAAA,kErBymFJ,mDqBpmFQ,WAAA,EAAA,EAAA,EAAA,MAAA,qBD5BN,qBCJA,MAAA,QACA,aAAA,QlBlDA,2BkBqDE,MAAA,KACA,iBAAA,QACA,aAAA,QAGF,2BAAA,2BAEE,WAAA,EAAA,EAAA,EAAA,MAAA,mBAGF,8BAAA,8BAEE,MAAA,QACA,iBAAA,YAGF,0DAAA,0DrByoFF,2CqBtoFI,MAAA,KACA,iBAAA,QACA,aAAA,QAEA,gEAAA,gErByoFJ,iDqBpoFQ,WAAA,EAAA,EAAA,EAAA,MAAA,mBD5BN,kBCJA,MAAA,QACA,aAAA,QlBlDA,wBkBqDE,MAAA,KACA,iBAAA,QACA,aAAA,QAGF,wBAAA,wBAEE,WAAA,EAAA,EAAA,EAAA,MAAA,oBAGF,2BAAA,2BAEE,MAAA,QACA,iBAAA,YAGF,uDAAA,uDrByqFF,wCqBtqFI,MAAA,KACA,iBAAA,QACA,aAAA,QAEA,6DAAA,6DrByqFJ,8CqBpqFQ,WAAA,EAAA,EAAA,EAAA,MAAA,oBD5BN,qBCJA,MAAA,QACA,aAAA,QlBlDA,2BkBqDE,MAAA,QACA,iBAAA,QACA,aAAA,QAGF,2BAAA,2BAEE,WAAA,EAAA,EAAA,EAAA,MAAA,mBAGF,8BAAA,8BAEE,MAAA,QACA,iBAAA,YAGF,0DAAA,0DrBysFF,2CqBtsFI,MAAA,QACA,iBAAA,QACA,aAAA,QAEA,gEAAA,gErBysFJ,iDqBpsFQ,WAAA,EAAA,EAAA,EAAA,MAAA,mBD5BN,oBCJA,MAAA,QACA,aAAA,QlBlDA,0BkBqDE,MAAA,KACA,iBAAA,QACA,aAAA,QAGF,0BAAA,0BAEE,WAAA,EAAA,EAAA,EAAA,MAAA,mBAGF,6BAAA,6BAEE,MAAA,QACA,iBAAA,YAGF,yDAAA,yDrByuFF,0CqBtuFI,MAAA,KACA,iBAAA,QACA,aAAA,QAEA,+DAAA,+DrByuFJ,gDqBpuFQ,WAAA,EAAA,EAAA,EAAA,MAAA,mBD5BN,mBCJA,MAAA,QACA,aAAA,QlBlDA,yBkBqDE,MAAA,QACA,iBAAA,QACA,aAAA,QAGF,yBAAA,yBAEE,WAAA,EAAA,EAAA,EAAA,MAAA,qBAGF,4BAAA,4BAEE,MAAA,QACA,iBAAA,YAGF,wDAAA,wDrBywFF,yCqBtwFI,MAAA,QACA,iBAAA,QACA,aAAA,QAEA,8DAAA,8DrBywFJ,+CqBpwFQ,WAAA,EAAA,EAAA,EAAA,MAAA,qBD5BN,kBCJA,MAAA,QACA,aAAA,QlBlDA,wBkBqDE,MAAA,KACA,iBAAA,QACA,aAAA,QAGF,wBAAA,wBAEE,WAAA,EAAA,EAAA,EAAA,MAAA,kBAGF,2BAAA,2BAEE,MAAA,QACA,iBAAA,YAGF,uDAAA,uDrByyFF,wCqBtyFI,MAAA,KACA,iBAAA,QACA,aAAA,QAEA,6DAAA,6DrByyFJ,8CqBpyFQ,WAAA,EAAA,EAAA,EAAA,MAAA,kBDjBR,UACE,YAAA,IACA,MAAA,QACA,gBAAA,KjBnEA,gBiBsEE,MAAA,QACA,gBAAA,UAPJ,gBAAA,gBAYI,gBAAA,UACA,WAAA,KAbJ,mBAAA,mBAkBI,MAAA,QACA,eAAA,KAWJ,mBAAA,QCLE,QAAA,MAAA,KpB0BI,UAAA,QoBxBJ,YAAA,IblGE,cAAA,MYyGJ,mBAAA,QCTE,QAAA,OAAA,MpB0BI,UAAA,QoBxBJ,YAAA,IblGE,cAAA,MYkHJ,WACE,QAAA,MACA,MAAA,KAFF,sBAMI,WAAA,MpBszFJ,6BADA,4BoBhzFA,6BAII,MAAA,KEtIJ,MLMM,WAAA,QAAA,KAAA,OAKF,uCKXJ,MLYM,WAAA,MKZN,iBAII,QAAA,EAIJ,qBAEI,QAAA,KAIJ,YACE,SAAA,SACA,OAAA,EACA,SAAA,OLXI,WAAA,OAAA,KAAA,KAKF,uCKGJ,YLFM,WAAA,MjB48FN,UACA,UAFA,WuBt9FA,QAIE,SAAA,SAGF,iBACE,YAAA,OCoBE,wBACE,QAAA,aACA,YAAA,OACA,eAAA,OACA,QAAA,GAhCJ,WAAA,KAAA,MACA,aAAA,KAAA,MAAA,YACA,cAAA,EACA,YAAA,KAAA,MAAA,YAqDE,8BACE,YAAA,ED1CN,eACE,SAAA,SACA,IAAA,KACA,KAAA,EACA,QAAA,KACA,QAAA,KACA,MAAA,KACA,UAAA,MACA,QAAA,MAAA,EACA,OAAA,QAAA,EAAA,EtBsGI,UAAA,KsBpGJ,MAAA,QACA,WAAA,KACA,WAAA,KACA,iBAAA,KACA,gBAAA,YACA,OAAA,IAAA,MAAA,gBf3BE,cAAA,OeoCA,oBACE,MAAA,KACA,KAAA,EAGF,qBACE,MAAA,EACA,KAAA,KXYF,yBWnBA,uBACE,MAAA,KACA,KAAA,EAGF,wBACE,MAAA,EACA,KAAA,MXYF,yBWnBA,uBACE,MAAA,KACA,KAAA,EAGF,wBACE,MAAA,EACA,KAAA,MXYF,yBWnBA,uBACE,MAAA,KACA,KAAA,EAGF,wBACE,MAAA,EACA,KAAA,MXYF,0BWnBA,uBACE,MAAA,KACA,KAAA,EAGF,wBACE,MAAA,EACA,KAAA,MAON,uBAEI,IAAA,KACA,OAAA,KACA,WAAA,EACA,cAAA,QC/BA,gCACE,QAAA,aACA,YAAA,OACA,eAAA,OACA,QAAA,GAzBJ,WAAA,EACA,aAAA,KAAA,MAAA,YACA,cAAA,KAAA,MACA,YAAA,KAAA,MAAA,YA8CE,sCACE,YAAA,EDUN,0BAEI,IAAA,EACA,MAAA,KACA,KAAA,KACA,WAAA,EACA,YAAA,QC7CA,mCACE,QAAA,aACA,YAAA,OACA,eAAA,OACA,QAAA,GAlBJ,WAAA,KAAA,MAAA,YACA,aAAA,EACA,cAAA,KAAA,MAAA,YACA,YAAA,KAAA,MAuCE,yCACE,YAAA,EA7BF,mCDmDE,eAAA,EAKN,yBAEI,IAAA,EACA,MAAA,KACA,KAAA,KACA,WAAA,EACA,aAAA,QC9DA,kCACE,QAAA,aACA,YAAA,OACA,eAAA,OACA,QAAA,GAJF,kCAgBI,QAAA,KAGF,mCACE,QAAA,aACA,aAAA,OACA,eAAA,OACA,QAAA,GA9BN,WAAA,KAAA,MAAA,YACA,aAAA,KAAA,MACA,cAAA,KAAA,MAAA,YAiCE,wCACE,YAAA,EAVA,mCDiDA,eAAA,EAON,oCAAA,kCAAA,mCAAA,iCAKI,MAAA,KACA,OAAA,KAKJ,kBE9GE,OAAA,EACA,OAAA,MAAA,EACA,SAAA,OACA,WAAA,IAAA,MAAA,QFkHF,eACE,QAAA,MACA,MAAA,KACA,QAAA,OAAA,OACA,MAAA,KACA,YAAA,IACA,MAAA,QACA,WAAA,QACA,YAAA,OACA,iBAAA,YACA,OAAA,EpBpHA,qBAAA,qBoBmIE,MAAA,QACA,gBAAA,KJ9IA,iBAAA,QIoHJ,sBAAA,sBAgCI,MAAA,KACA,gBAAA,KJrJA,iBAAA,QIoHJ,wBAAA,wBAuCI,MAAA,QACA,eAAA,KACA,iBAAA,YAQJ,oBACE,QAAA,MAIF,iBACE,QAAA,MACA,QAAA,MAAA,OACA,cAAA,EtBpDI,UAAA,QsBsDJ,MAAA,QACA,YAAA,OAIF,oBACE,QAAA,MACA,QAAA,OAAA,OACA,MAAA,QG1LF,W1B4sGA,oB0B1sGE,SAAA,SACA,QAAA,mBAAA,QAAA,YACA,eAAA,O1BgtGF,yB0BptGA,gBAOI,SAAA,SACA,SAAA,EAAA,EAAA,KAAA,KAAA,EAAA,EAAA,K1BmtGJ,+BGltGE,sBuBII,QAAA,E1BqtGN,gCADA,gCADA,+B0BhuGA,uBAAA,uBAAA,sBAkBM,QAAA,EAMN,aACE,QAAA,YAAA,QAAA,KACA,cAAA,KAAA,UAAA,KACA,cAAA,MAAA,gBAAA,WAHF,0BAMI,MAAA,K1BstGJ,wC0BltGA,kCAII,YAAA,K1BmtGJ,4C0BvtGA,uDlBhBI,wBAAA,EACA,2BAAA,ER4uGJ,6C0B7tGA,kClBFI,uBAAA,EACA,0BAAA,EkBgCJ,uBACE,cAAA,SACA,aAAA,SAFF,8B1B0sGA,yCADA,sC0BlsGI,YAAA,EAGF,yCACE,aAAA,EAIJ,0CAAA,+BACE,cAAA,QACA,aAAA,QAGF,0CAAA,+BACE,cAAA,OACA,aAAA,OAoBF,oBACE,mBAAA,OAAA,eAAA,OACA,eAAA,MAAA,YAAA,WACA,cAAA,OAAA,gBAAA,OAHF,yB1B4rGA,+B0BrrGI,MAAA,K1B0rGJ,iD0BjsGA,2CAYI,WAAA,K1B0rGJ,qD0BtsGA,gElBlFI,2BAAA,EACA,0BAAA,ER6xGJ,sD0B5sGA,2ClBhGI,uBAAA,EACA,wBAAA,EkBuIJ,uB1B0qGA,kC0BvqGI,cAAA,E1B4qGJ,4C0B/qGA,yC1BirGA,uDADA,oD0BzqGM,SAAA,SACA,KAAA,cACA,eAAA,KCzJN,aACE,SAAA,SACA,QAAA,YAAA,QAAA,KACA,cAAA,KAAA,UAAA,KACA,eAAA,QAAA,YAAA,QACA,MAAA,K3Bg1GF,0BADA,4B2Bp1GA,2B3Bm1GA,qC2Bx0GI,SAAA,SACA,SAAA,EAAA,EAAA,KAAA,KAAA,EAAA,EAAA,KAGA,MAAA,GACA,cAAA,E3Bw1GJ,uCADA,yCADA,wCADA,yCADA,2CADA,0CAJA,wCADA,0C2B91GA,yC3Bk2GA,kDADA,oDADA,mD2B30GM,YAAA,K3By1GN,sEADA,kC2B72GA,iCA6BI,QAAA,EA7BJ,mDAkCI,QAAA,E3Bq1GJ,6C2Bv3GA,4CnBeI,wBAAA,EACA,2BAAA,ER62GJ,8C2B73GA,6CnB6BI,uBAAA,EACA,0BAAA,EmB9BJ,0BA8CI,QAAA,YAAA,QAAA,KACA,eAAA,OAAA,YAAA,OA/CJ,8D3B04GA,qEQ33GI,wBAAA,EACA,2BAAA,EmBhBJ,+DnB6BI,uBAAA,EACA,0BAAA,ERu3GJ,oB2Bv1GA,qBAEE,QAAA,YAAA,QAAA,K3B21GF,yB2B71GA,0BAQI,SAAA,SACA,QAAA,E3B01GJ,+B2Bn2GA,gCAYM,QAAA,E3B+1GN,8BACA,2CAEA,2CADA,wD2B72GA,+B3Bw2GA,4CAEA,4CADA,yD2Br1GI,YAAA,KAIJ,qBAAuB,aAAA,KACvB,oBAAsB,YAAA,KAQtB,kBACE,QAAA,YAAA,QAAA,KACA,eAAA,OAAA,YAAA,OACA,QAAA,QAAA,OACA,cAAA,E1BsBI,UAAA,K0BpBJ,YAAA,IACA,YAAA,IACA,MAAA,QACA,WAAA,OACA,YAAA,OACA,iBAAA,QACA,OAAA,IAAA,MAAA,QnB5GE,cAAA,OR48GJ,uC2B52GA,oCAkBI,WAAA,E3B+1GJ,+B2Br1GA,4CAEE,OAAA,yB3Bw1GF,+B2Br1GA,8B3By1GA,yCAFA,sDACA,0CAFA,uD2Bh1GE,QAAA,MAAA,K1BbI,UAAA,Q0BeJ,YAAA,InBzIE,cAAA,MRk+GJ,+B2Br1GA,4CAEE,OAAA,0B3Bw1GF,+B2Br1GA,8B3By1GA,yCAFA,sDACA,0CAFA,uD2Bh1GE,QAAA,OAAA,M1B9BI,UAAA,Q0BgCJ,YAAA,InB1JE,cAAA,MmB8JJ,+B3Bq1GA,+B2Bn1GE,cAAA,Q3B21GF,wFACA,+EAHA,uDACA,oE2B/0GA,uC3B60GA,oDQx+GI,wBAAA,EACA,2BAAA,EmBmKJ,sC3B80GA,mDAGA,qEACA,kFAHA,yDACA,sEQt+GI,uBAAA,EACA,0BAAA,EoB3BJ,gBACE,SAAA,SACA,QAAA,MACA,WAAA,OACA,aAAA,OAGF,uBACE,QAAA,mBAAA,QAAA,YACA,aAAA,KAGF,sBACE,SAAA,SACA,QAAA,GACA,QAAA,EAHF,4DAMI,MAAA,KACA,aAAA,QTtBA,iBAAA,QSeJ,0DAiBM,WAAA,EAAA,EAAA,EAAA,MAAA,oBAjBN,wEAsBI,aAAA,QAtBJ,0EA0BI,MAAA,KACA,iBAAA,QACA,aAAA,QA5BJ,qDAkCM,MAAA,QAlCN,6DAqCQ,iBAAA,QAUR,sBACE,SAAA,SACA,cAAA,EACA,eAAA,IAHF,8BAOI,SAAA,SACA,IAAA,OACA,KAAA,QACA,QAAA,MACA,MAAA,KACA,OAAA,KACA,eAAA,KACA,QAAA,GACA,iBAAA,KACA,OAAA,QAAA,MAAA,IAhBJ,6BAsBI,SAAA,SACA,IAAA,OACA,KAAA,QACA,QAAA,MACA,MAAA,KACA,OAAA,KACA,QAAA,GACA,WAAA,UAAA,GAAA,CAAA,IAAA,IASJ,+CpBrGI,cAAA,OoBqGJ,4EAOM,iBAAA,4LAPN,mFAaM,aAAA,QTjHF,iBAAA,QSoGJ,kFAkBM,iBAAA,yIAlBN,sFAwBM,iBAAA,mBAxBN,4FA2BM,iBAAA,mBASN,4CAGI,cAAA,IAHJ,yEAQM,iBAAA,sIARN,mFAcM,iBAAA,mBAUN,eACE,aAAA,QADF,6CAKM,KAAA,SACA,MAAA,QACA,eAAA,IAEA,cAAA,MATN,4CAaM,IAAA,mBACA,KAAA,qBACA,MAAA,iBACA,OAAA,iBACA,iBAAA,QAEA,cAAA,MXnLA,WAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,WAAA,CAAA,kBAAA,KAAA,YAAA,WAAA,UAAA,KAAA,WAAA,CAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YAAA,WAAA,UAAA,KAAA,WAAA,CAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,WAAA,CAAA,kBAAA,KAAA,YAKF,uCW2JJ,4CX1JM,WAAA,MW0JN,0EA0BM,iBAAA,KACA,kBAAA,mBAAA,UAAA,mBA3BN,oFAiCM,iBAAA,mBAYN,eACE,QAAA,aACA,MAAA,KACA,OAAA,2BACA,QAAA,QAAA,QAAA,QAAA,O3BxFI,UAAA,K2B2FJ,YAAA,IACA,YAAA,IACA,MAAA,QACA,eAAA,OACA,WAAA,0JAAA,UAAA,MAAA,OAAA,MAAA,CAAA,IAAA,KACA,iBAAA,KACA,OAAA,IAAA,MAAA,QpB3NE,cAAA,OoB8NF,mBAAA,KAAA,gBAAA,KAAA,WAAA,KAhBF,qBAmBI,aAAA,QACA,QAAA,EAIE,WAAA,EAAA,EAAA,EAAA,MAAA,oBAxBN,gCAiCM,MAAA,QACA,iBAAA,KAlCN,yBAAA,qCAwCI,OAAA,KACA,cAAA,OACA,iBAAA,KA1CJ,wBA8CI,MAAA,QACA,iBAAA,QA/CJ,2BAoDI,QAAA,KAIJ,kBACE,OAAA,0BACA,YAAA,OACA,eAAA,OACA,aAAA,M3BhJI,UAAA,Q2BoJN,kBACE,OAAA,yBACA,YAAA,MACA,eAAA,MACA,aAAA,K3BxJI,UAAA,Q2BiKN,aACE,SAAA,SACA,QAAA,aACA,MAAA,KACA,OAAA,2BACA,cAAA,EAGF,mBACE,SAAA,SACA,QAAA,EACA,MAAA,KACA,OAAA,2BACA,OAAA,EACA,QAAA,EANF,4CASI,aAAA,QACA,WAAA,EAAA,EAAA,EAAA,MAAA,oBAVJ,+CAcI,iBAAA,QAdJ,sDAmBM,QAAA,SAnBN,0DAwBI,QAAA,kBAIJ,mBACE,SAAA,SACA,IAAA,EACA,MAAA,EACA,KAAA,EACA,QAAA,EACA,OAAA,2BACA,QAAA,QAAA,OAEA,YAAA,IACA,YAAA,IACA,MAAA,QACA,iBAAA,KACA,OAAA,IAAA,MAAA,QpB5UE,cAAA,OoB+TJ,0BAkBI,SAAA,SACA,IAAA,EACA,MAAA,EACA,OAAA,EACA,QAAA,EACA,QAAA,MACA,OAAA,qBACA,QAAA,QAAA,OACA,YAAA,IACA,MAAA,QACA,QAAA,ST1VA,iBAAA,QS4VA,YAAA,QpB7VA,cAAA,EAAA,OAAA,OAAA,EoBwWJ,cACE,MAAA,KACA,OAAA,mBACA,QAAA,EACA,iBAAA,YACA,mBAAA,KAAA,gBAAA,KAAA,WAAA,KALF,oBAQI,QAAA,EARJ,0CAY8B,WAAA,EAAA,EAAA,EAAA,IAAA,IAAA,CAAA,EAAA,EAAA,EAAA,MAAA,oBAZ9B,sCAa8B,WAAA,EAAA,EAAA,EAAA,IAAA,IAAA,CAAA,EAAA,EAAA,EAAA,MAAA,oBAb9B,+BAc8B,WAAA,EAAA,EAAA,EAAA,IAAA,IAAA,CAAA,EAAA,EAAA,EAAA,MAAA,oBAd9B,gCAkBI,OAAA,EAlBJ,oCAsBI,MAAA,KACA,OAAA,KACA,WAAA,QT/XA,iBAAA,QSiYA,OAAA,EpBlYA,cAAA,KSCE,WAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YWqYF,mBAAA,KAAA,WAAA,KXhYA,uCWkWJ,oCXjWM,WAAA,MWiWN,2CTvWI,iBAAA,QSuWJ,6CAsCI,MAAA,KACA,OAAA,MACA,MAAA,YACA,OAAA,QACA,iBAAA,QACA,aAAA,YpBnZA,cAAA,KoBwWJ,gCAiDI,MAAA,KACA,OAAA,KTzZA,iBAAA,QS2ZA,OAAA,EpB5ZA,cAAA,KSCE,WAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YW+ZF,gBAAA,KAAA,WAAA,KX1ZA,uCWkWJ,gCXjWM,WAAA,MWiWN,uCTvWI,iBAAA,QSuWJ,gCAgEI,MAAA,KACA,OAAA,MACA,MAAA,YACA,OAAA,QACA,iBAAA,QACA,aAAA,YpB7aA,cAAA,KoBwWJ,yBA2EI,MAAA,KACA,OAAA,KACA,WAAA,EACA,aAAA,MACA,YAAA,MTtbA,iBAAA,QSwbA,OAAA,EpBzbA,cAAA,KSCE,WAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YW4bF,WAAA,KXvbA,uCWkWJ,yBXjWM,WAAA,MWiWN,gCTvWI,iBAAA,QSuWJ,yBA6FI,MAAA,KACA,OAAA,MACA,MAAA,YACA,OAAA,QACA,iBAAA,YACA,aAAA,YACA,aAAA,MAnGJ,8BAwGI,iBAAA,QpBhdA,cAAA,KoBwWJ,8BA6GI,aAAA,KACA,iBAAA,QpBtdA,cAAA,KoBwWJ,6CAoHM,iBAAA,QApHN,sDAwHM,OAAA,QAxHN,yCA4HM,iBAAA,QA5HN,yCAgIM,OAAA,QAhIN,kCAoIM,iBAAA,QAKN,8B5Bi9GA,mBACA,eiBl8HM,WAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YAKF,uCW2eJ,8B5Bw9GE,mBACA,eiBn8HI,WAAA,MYPN,KACE,QAAA,YAAA,QAAA,KACA,cAAA,KAAA,UAAA,KACA,aAAA,EACA,cAAA,EACA,WAAA,KAGF,UACE,QAAA,MACA,QAAA,MAAA,K1BCA,gBAAA,gB0BEE,gBAAA,KALJ,mBAUI,MAAA,QACA,eAAA,KACA,OAAA,QAQJ,UACE,cAAA,IAAA,MAAA,QADF,oBAII,cAAA,KAJJ,oBAQI,OAAA,IAAA,MAAA,YrB3BA,uBAAA,OACA,wBAAA,OLCF,0BAAA,0B0B6BI,aAAA,QAAA,QAAA,QAZN,6BAgBM,MAAA,QACA,iBAAA,YACA,aAAA,Y7Bm9HN,mC6Br+HA,2BAwBI,MAAA,QACA,iBAAA,KACA,aAAA,QAAA,QAAA,KA1BJ,yBA+BI,WAAA,KrBlDA,uBAAA,EACA,wBAAA,EqB4DJ,qBrBtEI,cAAA,OqBsEJ,4B7B48HA,2B6Br8HI,MAAA,KACA,iBAAA,QASJ,oBAEI,SAAA,EAAA,EAAA,KAAA,KAAA,EAAA,EAAA,KACA,WAAA,OAIJ,yBAEI,wBAAA,EAAA,WAAA,EACA,kBAAA,EAAA,UAAA,EACA,WAAA,OASJ,uBAEI,QAAA,KAFJ,qBAKI,QAAA,MCpGJ,QACE,SAAA,SACA,QAAA,YAAA,QAAA,KACA,cAAA,KAAA,UAAA,KACA,eAAA,OAAA,YAAA,OACA,cAAA,QAAA,gBAAA,cACA,QAAA,MAAA,KANF,mB9B+iIA,yB8BniII,QAAA,YAAA,QAAA,KACA,cAAA,KAAA,UAAA,KACA,eAAA,OAAA,YAAA,OACA,cAAA,QAAA,gBAAA,cASJ,cACE,QAAA,aACA,YAAA,SACA,eAAA,SACA,aAAA,K7BkFI,UAAA,Q6BhFJ,YAAA,QACA,YAAA,O3BhCA,oBAAA,oB2BmCE,gBAAA,KASJ,YACE,QAAA,YAAA,QAAA,KACA,mBAAA,OAAA,eAAA,OACA,aAAA,EACA,cAAA,EACA,WAAA,KALF,sBAQI,cAAA,EACA,aAAA,EATJ,2BAaI,SAAA,OACA,MAAA,KASJ,aACE,QAAA,aACA,YAAA,MACA,eAAA,MAYF,iBACE,wBAAA,KAAA,WAAA,KACA,kBAAA,EAAA,UAAA,EAGA,eAAA,OAAA,YAAA,OAIF,gBACE,QAAA,OAAA,O7BmBI,UAAA,Q6BjBJ,YAAA,EACA,iBAAA,YACA,OAAA,IAAA,MAAA,YtB3GE,cAAA,OLWF,sBAAA,sB2BoGE,gBAAA,KAMJ,qBACE,QAAA,aACA,MAAA,MACA,OAAA,MACA,eAAA,OACA,QAAA,GACA,WAAA,UAAA,OAAA,OACA,gBAAA,KAAA,KlBxDE,4BkBkEC,6B9B0gIH,mC8BtgIQ,cAAA,EACA,aAAA,GlBpFN,yBkB+EA,kBAUI,cAAA,IAAA,OAAA,UAAA,IAAA,OACA,cAAA,MAAA,gBAAA,WAXH,8BAcK,mBAAA,IAAA,eAAA,IAdL,6CAiBO,SAAA,SAjBP,wCAqBO,cAAA,MACA,aAAA,MAtBP,6B9BmiIH,mC8BtgIQ,cAAA,OAAA,UAAA,OA7BL,mCAiCK,QAAA,sBAAA,QAAA,eAGA,wBAAA,KAAA,WAAA,KApCL,kCAwCK,QAAA,MlB1GN,4BkBkEC,6B9BojIH,mC8BhjIQ,cAAA,EACA,aAAA,GlBpFN,yBkB+EA,kBAUI,cAAA,IAAA,OAAA,UAAA,IAAA,OACA,cAAA,MAAA,gBAAA,WAXH,8BAcK,mBAAA,IAAA,eAAA,IAdL,6CAiBO,SAAA,SAjBP,wCAqBO,cAAA,MACA,aAAA,MAtBP,6B9B6kIH,mC8BhjIQ,cAAA,OAAA,UAAA,OA7BL,mCAiCK,QAAA,sBAAA,QAAA,eAGA,wBAAA,KAAA,WAAA,KApCL,kCAwCK,QAAA,MlB1GN,4BkBkEC,6B9B8lIH,mC8B1lIQ,cAAA,EACA,aAAA,GlBpFN,yBkB+EA,kBAUI,cAAA,IAAA,OAAA,UAAA,IAAA,OACA,cAAA,MAAA,gBAAA,WAXH,8BAcK,mBAAA,IAAA,eAAA,IAdL,6CAiBO,SAAA,SAjBP,wCAqBO,cAAA,MACA,aAAA,MAtBP,6B9BunIH,mC8B1lIQ,cAAA,OAAA,UAAA,OA7BL,mCAiCK,QAAA,sBAAA,QAAA,eAGA,wBAAA,KAAA,WAAA,KApCL,kCAwCK,QAAA,MlB1GN,6BkBkEC,6B9BwoIH,mC8BpoIQ,cAAA,EACA,aAAA,GlBpFN,0BkB+EA,kBAUI,cAAA,IAAA,OAAA,UAAA,IAAA,OACA,cAAA,MAAA,gBAAA,WAXH,8BAcK,mBAAA,IAAA,eAAA,IAdL,6CAiBO,SAAA,SAjBP,wCAqBO,cAAA,MACA,aAAA,MAtBP,6B9BiqIH,mC8BpoIQ,cAAA,OAAA,UAAA,OA7BL,mCAiCK,QAAA,sBAAA,QAAA,eAGA,wBAAA,KAAA,WAAA,KApCL,kCAwCK,QAAA,MA7CV,eAeQ,cAAA,IAAA,OAAA,UAAA,IAAA,OACA,cAAA,MAAA,gBAAA,WAhBR,0B9B6rIA,gC8BprIU,cAAA,EACA,aAAA,EAVV,2BAmBU,mBAAA,IAAA,eAAA,IAnBV,0CAsBY,SAAA,SAtBZ,qCA0BY,cAAA,MACA,aAAA,MA3BZ,0B9BitIA,gC8B/qIU,cAAA,OAAA,UAAA,OAlCV,gCAsCU,QAAA,sBAAA,QAAA,eAGA,wBAAA,KAAA,WAAA,KAzCV,+BA6CU,QAAA,KAaV,4BAEI,MAAA,e3BlLF,kCAAA,kC2BqLI,MAAA,eALN,oCAWM,MAAA,e3B3LJ,0CAAA,0C2B8LM,MAAA,eAdR,6CAkBQ,MAAA,e9B0qIR,4CAEA,2CADA,yC8B7rIA,0CA0BM,MAAA,eA1BN,8BA+BI,MAAA,eACA,aAAA,eAhCJ,mCAoCI,iBAAA,uOApCJ,2BAwCI,MAAA,eAxCJ,6BA0CM,MAAA,e3B1NJ,mCAAA,mC2B6NM,MAAA,eAOR,2BAEI,MAAA,K3BtOF,iCAAA,iC2ByOI,MAAA,KALN,mCAWM,MAAA,qB3B/OJ,yCAAA,yC2BkPM,MAAA,sBAdR,4CAkBQ,MAAA,sB9BsqIR,2CAEA,0CADA,wC8BzrIA,yCA0BM,MAAA,KA1BN,6BA+BI,MAAA,qBACA,aAAA,qBAhCJ,kCAoCI,iBAAA,6OApCJ,0BAwCI,MAAA,qBAxCJ,4BA0CM,MAAA,K3B9QJ,kCAAA,kC2BiRM,MAAA,KC7RR,MACE,SAAA,SACA,QAAA,YAAA,QAAA,KACA,mBAAA,OAAA,eAAA,OACA,UAAA,EACA,UAAA,WACA,iBAAA,KACA,gBAAA,WACA,OAAA,IAAA,MAAA,iBvBPE,cAAA,OuBDJ,SAYI,aAAA,EACA,YAAA,EAbJ,2DvBUI,uBAAA,OACA,wBAAA,OuBXJ,yDvBwBI,2BAAA,OACA,0BAAA,OuBIJ,WAGE,SAAA,EAAA,EAAA,KAAA,KAAA,EAAA,EAAA,KACA,QAAA,QAIF,YACE,cAAA,OAGF,eACE,WAAA,SACA,cAAA,EAGF,sBACE,cAAA,E5BvCA,iB4B4CE,gBAAA,KAFJ,sBAMI,YAAA,QAQJ,aACE,QAAA,OAAA,QACA,cAAA,EAEA,iBAAA,gBACA,cAAA,IAAA,MAAA,iBALF,yBvB/DI,cAAA,mBAAA,mBAAA,EAAA,EuB+DJ,sDAaM,WAAA,EAKN,aACE,QAAA,OAAA,QACA,iBAAA,gBACA,WAAA,IAAA,MAAA,iBAHF,wBvBjFI,cAAA,EAAA,EAAA,mBAAA,mBuBgGJ,kBACE,aAAA,SACA,cAAA,QACA,YAAA,SACA,cAAA,EAGF,mBACE,aAAA,SACA,YAAA,SAIF,kBACE,SAAA,SACA,IAAA,EACA,MAAA,EACA,OAAA,EACA,KAAA,EACA,QAAA,QAGF,UACE,MAAA,KvBvHE,cAAA,mBuB4HJ,cACE,MAAA,KvBpHE,uBAAA,mBACA,wBAAA,mBuBuHJ,iBACE,MAAA,KvB3GE,2BAAA,mBACA,0BAAA,mBuBiHJ,WACE,QAAA,YAAA,QAAA,KACA,mBAAA,OAAA,eAAA,OAFF,iBAKI,cAAA,KnBvFA,yBmBkFJ,WASI,cAAA,IAAA,KAAA,UAAA,IAAA,KACA,aAAA,MACA,YAAA,MAXJ,iBAcM,QAAA,YAAA,QAAA,KAEA,SAAA,EAAA,EAAA,GAAA,KAAA,EAAA,EAAA,GACA,mBAAA,OAAA,eAAA,OACA,aAAA,KACA,cAAA,EACA,YAAA,MAUN,YACE,QAAA,YAAA,QAAA,KACA,mBAAA,OAAA,eAAA,OAFF,kBAOI,cAAA,KnBvHA,yBmBgHJ,YAWI,cAAA,IAAA,KAAA,UAAA,IAAA,KAXJ,kBAgBM,SAAA,EAAA,EAAA,GAAA,KAAA,EAAA,EAAA,GACA,cAAA,EAjBN,wBAoBQ,YAAA,EACA,YAAA,EArBR,mCvBvJI,wBAAA,EACA,2BAAA,ERqmJF,gD+B/8IF,iDAgCY,wBAAA,E/Bm7IV,gD+Bn9IF,oDAqCY,2BAAA,EArCZ,oCvBzII,uBAAA,EACA,0BAAA,ERmmJF,iD+B39IF,kDA+CY,uBAAA,E/Bg7IV,iD+B/9IF,qDAoDY,0BAAA,GAaZ,oBAEI,cAAA,OnBnLA,yBmBiLJ,cAMI,qBAAA,EAAA,kBAAA,EAAA,aAAA,EACA,mBAAA,QAAA,gBAAA,QAAA,WAAA,QACA,QAAA,EACA,OAAA,EATJ,oBAYM,QAAA,aACA,MAAA,MAUN,iBAEI,SAAA,OAFJ,8DvB/PI,cAAA,EuB+PJ,wDAUQ,cAAA,EvBzQJ,cAAA,EuB+PJ,+BAgBM,cAAA,EvBxPF,2BAAA,EACA,0BAAA,EuBuOJ,8BvBtPI,uBAAA,EACA,wBAAA,EuBqPJ,8BAyBM,cAAA,KC7RN,YACE,QAAA,YAAA,QAAA,KACA,cAAA,KAAA,UAAA,KACA,QAAA,OAAA,KACA,cAAA,KACA,WAAA,KACA,iBAAA,QxBDE,cAAA,OwBKJ,kCAGI,aAAA,MAHJ,0CAMM,QAAA,aACA,cAAA,MACA,MAAA,QACA,QAAA,IATN,gDAoBI,gBAAA,UApBJ,gDAwBI,gBAAA,KAxBJ,wBA4BI,MAAA,QCtCJ,YACE,QAAA,YAAA,QAAA,K5BGA,aAAA,EACA,WAAA,KGAE,cAAA,OyBCJ,WACE,SAAA,SACA,QAAA,MACA,QAAA,MAAA,OACA,YAAA,KACA,YAAA,KACA,MAAA,QACA,iBAAA,KACA,OAAA,IAAA,MAAA,QARF,iBAWI,QAAA,EACA,MAAA,QACA,gBAAA,KACA,iBAAA,QACA,aAAA,QAfJ,iBAmBI,QAAA,EACA,QAAA,EACA,WAAA,EAAA,EAAA,EAAA,MAAA,oBAIJ,kCAGM,YAAA,EzBCF,uBAAA,OACA,0BAAA,OyBLJ,iCzBVI,wBAAA,OACA,2BAAA,OyBSJ,6BAcI,QAAA,EACA,MAAA,KACA,iBAAA,QACA,aAAA,QAjBJ,+BAqBI,MAAA,QACA,eAAA,KAEA,OAAA,KACA,iBAAA,KACA,aAAA,QCtDF,0BACE,QAAA,OAAA,OjC2HE,UAAA,QiCzHF,YAAA,IAKE,iD1BwBF,uBAAA,MACA,0BAAA,M0BpBE,gD1BKF,wBAAA,MACA,2BAAA,M0BnBF,0BACE,QAAA,OAAA,MjC2HE,UAAA,QiCzHF,YAAA,IAKE,iD1BwBF,uBAAA,MACA,0BAAA,M0BpBE,gD1BKF,wBAAA,MACA,2BAAA,M2BjBJ,OACE,QAAA,aACA,QAAA,MAAA,KlCiEE,UAAA,IkC/DF,YAAA,IACA,YAAA,EACA,WAAA,OACA,YAAA,OACA,eAAA,S3BRE,cAAA,OSCE,WAAA,MAAA,KAAA,WAAA,CAAA,iBAAA,KAAA,WAAA,CAAA,aAAA,KAAA,WAAA,CAAA,WAAA,KAAA,YAKF,uCkBNJ,OlBOM,WAAA,MdIJ,cAAA,cgCGI,gBAAA,KAdN,aAoBI,QAAA,KAKJ,YACE,SAAA,SACA,IAAA,KAOF,YACE,cAAA,KACA,aAAA,K3BpCE,cAAA,M2B6CF,eCjDA,MAAA,KACA,iBAAA,QjCcA,sBAAA,sBiCVI,MAAA,KACA,iBAAA,QAHI,sBAAA,sBAQJ,QAAA,EACA,WAAA,EAAA,EAAA,EAAA,MAAA,mBDqCJ,iBCjDA,MAAA,KACA,iBAAA,QjCcA,wBAAA,wBiCVI,MAAA,KACA,iBAAA,QAHI,wBAAA,wBAQJ,QAAA,EACA,WAAA,EAAA,EAAA,EAAA,MAAA,qBDqCJ,eCjDA,MAAA,KACA,iBAAA,QjCcA,sBAAA,sBiCVI,MAAA,KACA,iBAAA,QAHI,sBAAA,sBAQJ,QAAA,EACA,WAAA,EAAA,EAAA,EAAA,MAAA,mBDqCJ,YCjDA,MAAA,KACA,iBAAA,QjCcA,mBAAA,mBiCVI,MAAA,KACA,iBAAA,QAHI,mBAAA,mBAQJ,QAAA,EACA,WAAA,EAAA,EAAA,EAAA,MAAA,oBDqCJ,eCjDA,MAAA,QACA,iBAAA,QjCcA,sBAAA,sBiCVI,MAAA,QACA,iBAAA,QAHI,sBAAA,sBAQJ,QAAA,EACA,WAAA,EAAA,EAAA,EAAA,MAAA,mBDqCJ,cCjDA,MAAA,KACA,iBAAA,QjCcA,qBAAA,qBiCVI,MAAA,KACA,iBAAA,QAHI,qBAAA,qBAQJ,QAAA,EACA,WAAA,EAAA,EAAA,EAAA,MAAA,mBDqCJ,aCjDA,MAAA,QACA,iBAAA,QjCcA,oBAAA,oBiCVI,MAAA,QACA,iBAAA,QAHI,oBAAA,oBAQJ,QAAA,EACA,WAAA,EAAA,EAAA,EAAA,MAAA,qBDqCJ,YCjDA,MAAA,KACA,iBAAA,QjCcA,mBAAA,mBiCVI,MAAA,KACA,iBAAA,QAHI,mBAAA,mBAQJ,QAAA,EACA,WAAA,EAAA,EAAA,EAAA,MAAA,kBCbN,WACE,QAAA,KAAA,KACA,cAAA,KAEA,iBAAA,Q7BCE,cAAA,MIuDA,yByB5DJ,WAQI,QAAA,KAAA,MAIJ,iBACE,cAAA,EACA,aAAA,E7BTE,cAAA,E8BDJ,OACE,SAAA,SACA,QAAA,OAAA,QACA,cAAA,KACA,OAAA,IAAA,MAAA,Y9BHE,cAAA,O8BQJ,eAEE,MAAA,QAIF,YACE,YAAA,IAQF,mBACE,cAAA,KADF,0BAKI,SAAA,SACA,IAAA,EACA,MAAA,EACA,QAAA,OAAA,QACA,MAAA,QAUF,eC9CA,MAAA,QpBKE,iBAAA,QoBHF,aAAA,QAEA,kBACE,iBAAA,QAGF,2BACE,MAAA,QDqCF,iBC9CA,MAAA,QpBKE,iBAAA,QoBHF,aAAA,QAEA,oBACE,iBAAA,QAGF,6BACE,MAAA,QDqCF,eC9CA,MAAA,QpBKE,iBAAA,QoBHF,aAAA,QAEA,kBACE,iBAAA,QAGF,2BACE,MAAA,QDqCF,YC9CA,MAAA,QpBKE,iBAAA,QoBHF,aAAA,QAEA,eACE,iBAAA,QAGF,wBACE,MAAA,QDqCF,eC9CA,MAAA,QpBKE,iBAAA,QoBHF,aAAA,QAEA,kBACE,iBAAA,QAGF,2BACE,MAAA,QDqCF,cC9CA,MAAA,QpBKE,iBAAA,QoBHF,aAAA,QAEA,iBACE,iBAAA,QAGF,0BACE,MAAA,QDqCF,aC9CA,MAAA,QpBKE,iBAAA,QoBHF,aAAA,QAEA,gBACE,iBAAA,QAGF,yBACE,MAAA,QDqCF,YC9CA,MAAA,QpBKE,iBAAA,QoBHF,aAAA,QAEA,eACE,iBAAA,QAGF,wBACE,MAAA,QCRF,wCACE,KAAO,oBAAA,KAAA,EACP,GAAK,oBAAA,EAAA,GAFP,gCACE,KAAO,oBAAA,KAAA,EACP,GAAK,oBAAA,EAAA,GAIT,UACE,QAAA,YAAA,QAAA,KACA,OAAA,KACA,SAAA,OvCoHI,UAAA,OuClHJ,iBAAA,QhCRE,cAAA,OgCaJ,cACE,QAAA,YAAA,QAAA,KACA,mBAAA,OAAA,eAAA,OACA,cAAA,OAAA,gBAAA,OACA,MAAA,KACA,WAAA,OACA,YAAA,OACA,iBAAA,QvBnBI,WAAA,MAAA,IAAA,KAKF,uCuBOJ,cvBNM,WAAA,MuBiBN,sBrBcE,iBAAA,iKqBZA,gBAAA,KAAA,KAIA,uBACE,kBAAA,qBAAA,GAAA,OAAA,SAAA,UAAA,qBAAA,GAAA,OAAA,SAEA,uCAHF,uBAII,kBAAA,KAAA,UAAA,MCvCN,OACE,QAAA,YAAA,QAAA,KACA,eAAA,MAAA,YAAA,WAGF,YACE,SAAA,EAAA,KAAA,ECFF,YACE,QAAA,YAAA,QAAA,KACA,mBAAA,OAAA,eAAA,OAGA,aAAA,EACA,cAAA,EASF,wBACE,MAAA,KACA,MAAA,QACA,WAAA,QvCNA,8BAAA,8BuCUE,QAAA,EACA,MAAA,QACA,gBAAA,KACA,iBAAA,QAVJ,+BAcI,MAAA,QACA,iBAAA,QASJ,iBACE,SAAA,SACA,QAAA,MACA,QAAA,OAAA,QAEA,cAAA,KAEA,iBAAA,KACA,OAAA,IAAA,MAAA,iBARF,6BlC7BI,uBAAA,OACA,wBAAA,OkC4BJ,4BAeI,cAAA,ElC9BA,2BAAA,OACA,0BAAA,OkCcJ,0BAAA,0BAqBI,MAAA,QACA,eAAA,KACA,iBAAA,KAvBJ,wBA4BI,QAAA,EACA,MAAA,KACA,iBAAA,QACA,aAAA,QAaA,uBACE,mBAAA,IAAA,eAAA,IADF,wCAII,aAAA,KACA,cAAA,EALJ,oDlCpDA,uBAAA,OACA,0BAAA,OAYA,wBAAA,EkCuCA,mDAaM,aAAA,ElC/EN,wBAAA,OACA,2BAAA,OAsCA,0BAAA,EIAA,yB8B2BA,0BACE,mBAAA,IAAA,eAAA,IADF,2CAII,aAAA,KACA,cAAA,EALJ,uDlCpDA,uBAAA,OACA,0BAAA,OAYA,wBAAA,EkCuCA,sDAaM,aAAA,ElC/EN,wBAAA,OACA,2BAAA,OAsCA,0BAAA,GIAA,yB8B2BA,0BACE,mBAAA,IAAA,eAAA,IADF,2CAII,aAAA,KACA,cAAA,EALJ,uDlCpDA,uBAAA,OACA,0BAAA,OAYA,wBAAA,EkCuCA,sDAaM,aAAA,ElC/EN,wBAAA,OACA,2BAAA,OAsCA,0BAAA,GIAA,yB8B2BA,0BACE,mBAAA,IAAA,eAAA,IADF,2CAII,aAAA,KACA,cAAA,EALJ,uDlCpDA,uBAAA,OACA,0BAAA,OAYA,wBAAA,EkCuCA,sDAaM,aAAA,ElC/EN,wBAAA,OACA,2BAAA,OAsCA,0BAAA,GIAA,0B8B2BA,0BACE,mBAAA,IAAA,eAAA,IADF,2CAII,aAAA,KACA,cAAA,EALJ,uDlCpDA,uBAAA,OACA,0BAAA,OAYA,wBAAA,EkCuCA,sDAaM,aAAA,ElC/EN,wBAAA,OACA,2BAAA,OAsCA,0BAAA,GkCuDJ,mCAEI,aAAA,EACA,YAAA,ElCjHA,cAAA,EkC8GJ,8CAOM,cAAA,KAPN,2DAaM,WAAA,EAbN,yDAmBM,cAAA,EACA,cAAA,ECpIJ,yBACE,MAAA,QACA,iBAAA,QxCWF,sDAAA,sDwCPM,MAAA,QACA,iBAAA,QAPN,uDAWM,MAAA,KACA,iBAAA,QACA,aAAA,QAbN,2BACE,MAAA,QACA,iBAAA,QxCWF,wDAAA,wDwCPM,MAAA,QACA,iBAAA,QAPN,yDAWM,MAAA,KACA,iBAAA,QACA,aAAA,QAbN,yBACE,MAAA,QACA,iBAAA,QxCWF,sDAAA,sDwCPM,MAAA,QACA,iBAAA,QAPN,uDAWM,MAAA,KACA,iBAAA,QACA,aAAA,QAbN,sBACE,MAAA,QACA,iBAAA,QxCWF,mDAAA,mDwCPM,MAAA,QACA,iBAAA,QAPN,oDAWM,MAAA,KACA,iBAAA,QACA,aAAA,QAbN,yBACE,MAAA,QACA,iBAAA,QxCWF,sDAAA,sDwCPM,MAAA,QACA,iBAAA,QAPN,uDAWM,MAAA,KACA,iBAAA,QACA,aAAA,QAbN,wBACE,MAAA,QACA,iBAAA,QxCWF,qDAAA,qDwCPM,MAAA,QACA,iBAAA,QAPN,sDAWM,MAAA,KACA,iBAAA,QACA,aAAA,QAbN,uBACE,MAAA,QACA,iBAAA,QxCWF,oDAAA,oDwCPM,MAAA,QACA,iBAAA,QAPN,qDAWM,MAAA,KACA,iBAAA,QACA,aAAA,QAbN,sBACE,MAAA,QACA,iBAAA,QxCWF,mDAAA,mDwCPM,MAAA,QACA,iBAAA,QAPN,oDAWM,MAAA,KACA,iBAAA,QACA,aAAA,QChBR,OACE,MAAA,M3C8HI,UAAA,O2C5HJ,YAAA,IACA,YAAA,EACA,MAAA,KACA,YAAA,EAAA,IAAA,EAAA,KACA,QAAA,GzCKA,ayCDE,MAAA,KACA,gBAAA,KzCIF,2CAAA,2CyCCI,QAAA,IAWN,aACE,QAAA,EACA,iBAAA,YACA,OAAA,EACA,mBAAA,KAAA,gBAAA,KAAA,WAAA,KAMF,iBACE,eAAA,KCvCF,OACE,UAAA,MACA,SAAA,O5C6HI,UAAA,Q4C1HJ,iBAAA,sBACA,gBAAA,YACA,OAAA,IAAA,MAAA,eACA,WAAA,EAAA,OAAA,OAAA,eACA,wBAAA,WAAA,gBAAA,WACA,QAAA,ErCLE,cAAA,OqCLJ,wBAcI,cAAA,OAdJ,eAkBI,QAAA,EAlBJ,YAsBI,QAAA,MACA,QAAA,EAvBJ,YA2BI,QAAA,KAIJ,cACE,QAAA,YAAA,QAAA,KACA,eAAA,OAAA,YAAA,OACA,QAAA,OAAA,OACA,MAAA,QACA,iBAAA,sBACA,gBAAA,YACA,cAAA,IAAA,MAAA,gBAGF,YACE,QAAA,OCpCF,YAEE,SAAA,OAFF,mBAKI,WAAA,OACA,WAAA,KAKJ,OACE,SAAA,MACA,IAAA,EACA,KAAA,EACA,QAAA,KACA,QAAA,KACA,MAAA,KACA,OAAA,KACA,SAAA,OAGA,QAAA,EAOF,cACE,SAAA,SACA,MAAA,KACA,OAAA,MAEA,eAAA,KAGA,0B7BrCI,WAAA,kBAAA,IAAA,SAAA,WAAA,UAAA,IAAA,SAAA,WAAA,UAAA,IAAA,QAAA,CAAA,kBAAA,IAAA,S6BuCF,kBAAA,mBAAA,UAAA,mB7BlCA,uC6BgCF,0B7B/BI,WAAA,M6BmCJ,0BACE,kBAAA,KAAA,UAAA,KAIJ,yBACE,QAAA,YAAA,QAAA,KACA,WAAA,kBAFF,wCAKI,WAAA,mBACA,SAAA,O9CulLJ,uC8C7lLA,uCAWI,kBAAA,EAAA,YAAA,EAXJ,qCAeI,WAAA,KAIJ,uBACE,QAAA,YAAA,QAAA,KACA,eAAA,OAAA,YAAA,OACA,WAAA,kBAHF,+BAOI,QAAA,MACA,OAAA,mBACA,QAAA,GATJ,+CAcI,mBAAA,OAAA,eAAA,OACA,cAAA,OAAA,gBAAA,OACA,OAAA,KAhBJ,8DAmBM,WAAA,KAnBN,uDAuBM,QAAA,KAMN,eACE,SAAA,SACA,QAAA,YAAA,QAAA,KACA,mBAAA,OAAA,eAAA,OACA,MAAA,KAGA,eAAA,KACA,iBAAA,KACA,gBAAA,YACA,OAAA,IAAA,MAAA,etCzGE,cAAA,MsC6GF,QAAA,EAIF,gBACE,SAAA,MACA,IAAA,EACA,KAAA,EACA,QAAA,KACA,MAAA,MACA,OAAA,MACA,iBAAA,KAPF,qBAUW,QAAA,EAVX,qBAWW,QAAA,GAKX,cACE,QAAA,YAAA,QAAA,KACA,eAAA,MAAA,YAAA,WACA,cAAA,QAAA,gBAAA,cACA,QAAA,KAAA,KACA,cAAA,IAAA,MAAA,QtC7HE,uBAAA,MACA,wBAAA,MsCuHJ,qBASI,QAAA,KAAA,KAEA,OAAA,MAAA,MAAA,MAAA,KAKJ,aACE,cAAA,EACA,YAAA,IAKF,YACE,SAAA,SAGA,SAAA,EAAA,EAAA,KAAA,KAAA,EAAA,EAAA,KACA,QAAA,KAIF,cACE,QAAA,YAAA,QAAA,KACA,eAAA,OAAA,YAAA,OACA,cAAA,IAAA,gBAAA,SACA,QAAA,KACA,WAAA,IAAA,MAAA,QtC/IE,2BAAA,MACA,0BAAA,MsCyIJ,iCASyB,YAAA,OATzB,gCAUwB,aAAA,OAIxB,yBACE,SAAA,SACA,IAAA,QACA,MAAA,KACA,OAAA,KACA,SAAA,OlC7HE,yBkCzBJ,cA6JI,UAAA,MACA,OAAA,QAAA,KA7IJ,yBAiJI,WAAA,oBAjJJ,wCAoJM,WAAA,qBAjIN,uBAsII,WAAA,oBAtIJ,+BAyIM,OAAA,qBAQJ,UAAY,UAAA,OlC5JV,yBkCgKF,U9CglLA,U8C9kLE,UAAA,OlClKA,0BkCuKF,UAAY,UAAA,QClOd,SACE,SAAA,SACA,QAAA,KACA,QAAA,MACA,OAAA,ECJA,YAAA,aAAA,CAAA,kBAAA,CAAA,UAAA,CAAA,MAAA,CAAA,gBAAA,CAAA,KAAA,CAAA,WAAA,CAAA,UAAA,CAAA,mBAAA,CAAA,gBAAA,CAAA,iBAAA,CAAA,mBAEA,WAAA,OACA,YAAA,IACA,YAAA,IACA,WAAA,KACA,WAAA,MACA,gBAAA,KACA,YAAA,KACA,eAAA,KACA,eAAA,OACA,WAAA,OACA,aAAA,OACA,YAAA,OACA,WAAA,K/CgHI,UAAA,Q8CpHJ,UAAA,WACA,QAAA,EAXF,cAaW,QAAA,GAbX,gBAgBI,SAAA,SACA,QAAA,MACA,MAAA,MACA,OAAA,MAnBJ,wBAsBM,SAAA,SACA,QAAA,GACA,aAAA,YACA,aAAA,MAKN,mCAAA,gBACE,QAAA,MAAA,EADF,0CAAA,uBAII,OAAA,EAJJ,kDAAA,+BAOM,IAAA,EACA,aAAA,MAAA,MAAA,EACA,iBAAA,KAKN,qCAAA,kBACE,QAAA,EAAA,MADF,4CAAA,yBAII,KAAA,EACA,MAAA,MACA,OAAA,MANJ,oDAAA,iCASM,MAAA,EACA,aAAA,MAAA,MAAA,MAAA,EACA,mBAAA,KAKN,sCAAA,mBACE,QAAA,MAAA,EADF,6CAAA,0BAII,IAAA,EAJJ,qDAAA,kCAOM,OAAA,EACA,aAAA,EAAA,MAAA,MACA,oBAAA,KAKN,oCAAA,iBACE,QAAA,EAAA,MADF,2CAAA,wBAII,MAAA,EACA,MAAA,MACA,OAAA,MANJ,mDAAA,gCASM,KAAA,EACA,aAAA,MAAA,EAAA,MAAA,MACA,kBAAA,KAqBN,eACE,UAAA,MACA,QAAA,OAAA,MACA,MAAA,KACA,WAAA,OACA,iBAAA,KvC3GE,cAAA,OyCLJ,SACE,SAAA,SACA,IAAA,EACA,KAAA,EACA,QAAA,KACA,QAAA,MACA,UAAA,MDLA,YAAA,aAAA,CAAA,kBAAA,CAAA,UAAA,CAAA,MAAA,CAAA,gBAAA,CAAA,KAAA,CAAA,WAAA,CAAA,UAAA,CAAA,mBAAA,CAAA,gBAAA,CAAA,iBAAA,CAAA,mBAEA,WAAA,OACA,YAAA,IACA,YAAA,IACA,WAAA,KACA,WAAA,MACA,gBAAA,KACA,YAAA,KACA,eAAA,KACA,eAAA,OACA,WAAA,OACA,aAAA,OACA,YAAA,OACA,WAAA,K/CgHI,UAAA,QgDnHJ,UAAA,WACA,iBAAA,KACA,gBAAA,YACA,OAAA,IAAA,MAAA,ezCVE,cAAA,MyCLJ,gBAoBI,SAAA,SACA,QAAA,MACA,MAAA,KACA,OAAA,MACA,OAAA,EAAA,MAxBJ,uBAAA,wBA4BM,SAAA,SACA,QAAA,MACA,QAAA,GACA,aAAA,YACA,aAAA,MAKN,mCAAA,gBACE,cAAA,MADF,0CAAA,uBAII,OAAA,yBAJJ,kDAAA,+BAOM,OAAA,EACA,aAAA,MAAA,MAAA,EACA,iBAAA,gBATN,iDAAA,8BAaM,OAAA,IACA,aAAA,MAAA,MAAA,EACA,iBAAA,KAKN,qCAAA,kBACE,YAAA,MADF,4CAAA,yBAII,KAAA,yBACA,MAAA,MACA,OAAA,KACA,OAAA,MAAA,EAPJ,oDAAA,iCAUM,KAAA,EACA,aAAA,MAAA,MAAA,MAAA,EACA,mBAAA,gBAZN,mDAAA,gCAgBM,KAAA,IACA,aAAA,MAAA,MAAA,MAAA,EACA,mBAAA,KAKN,sCAAA,mBACE,WAAA,MADF,6CAAA,0BAII,IAAA,yBAJJ,qDAAA,kCAOM,IAAA,EACA,aAAA,EAAA,MAAA,MAAA,MACA,oBAAA,gBATN,oDAAA,iCAaM,IAAA,IACA,aAAA,EAAA,MAAA,MAAA,MACA,oBAAA,KAfN,8DAAA,2CAqBI,SAAA,SACA,IAAA,EACA,KAAA,IACA,QAAA,MACA,MAAA,KACA,YAAA,OACA,QAAA,GACA,cAAA,IAAA,MAAA,QAIJ,oCAAA,iBACE,aAAA,MADF,2CAAA,wBAII,MAAA,yBACA,MAAA,MACA,OAAA,KACA,OAAA,MAAA,EAPJ,mDAAA,gCAUM,MAAA,EACA,aAAA,MAAA,EAAA,MAAA,MACA,kBAAA,gBAZN,kDAAA,+BAgBM,MAAA,IACA,aAAA,MAAA,EAAA,MAAA,MACA,kBAAA,KAsBN,gBACE,QAAA,MAAA,OACA,cAAA,EhD3BI,UAAA,KgD8BJ,iBAAA,QACA,cAAA,IAAA,MAAA,QzChJE,uBAAA,kBACA,wBAAA,kByCyIJ,sBAWI,QAAA,KAIJ,cACE,QAAA,MAAA,OACA,MAAA,QC5JF,UACE,SAAA,SAGF,wBACE,iBAAA,MAAA,aAAA,MAGF,gBACE,SAAA,SACA,MAAA,KACA,SAAA,OCvBA,uBACE,QAAA,MACA,MAAA,KACA,QAAA,GDwBJ,eACE,SAAA,SACA,QAAA,KACA,MAAA,KACA,MAAA,KACA,aAAA,MACA,4BAAA,OAAA,oBAAA,OjC5BI,WAAA,kBAAA,IAAA,YAAA,WAAA,UAAA,IAAA,YAAA,WAAA,UAAA,IAAA,WAAA,CAAA,kBAAA,IAAA,YAKF,uCiCiBJ,ejChBM,WAAA,MjBomMN,oBACA,oBkD3kMA,sBAGE,QAAA,MlD6kMF,4BkD1kMA,6CAEE,kBAAA,iBAAA,UAAA,iBlD8kMF,2BkD3kMA,8CAEE,kBAAA,kBAAA,UAAA,kBAQF,8BAEI,QAAA,EACA,oBAAA,QACA,kBAAA,KAAA,UAAA,KlD0kMJ,sDACA,uDkD/kMA,qCAUI,QAAA,EACA,QAAA,EAXJ,0ClDqlMA,2CkDrkMI,QAAA,EACA,QAAA,EjCtEE,WAAA,GAAA,IAAA,QAKF,uCiCgDJ,0ClD6lME,2CiB5oMI,WAAA,MjBkpMN,uBkDxkMA,uBAEE,SAAA,SACA,IAAA,EACA,OAAA,EACA,QAAA,EAEA,QAAA,YAAA,QAAA,KACA,eAAA,OAAA,YAAA,OACA,cAAA,OAAA,gBAAA,OACA,MAAA,IACA,MAAA,KACA,WAAA,OACA,QAAA,GjC7FI,WAAA,QAAA,KAAA,KAKF,uCjBuqMF,uBkD5lMF,uBjC1EM,WAAA,MjB6qMN,6BADA,6BGxqME,6BAAA,6B+CwFE,MAAA,KACA,gBAAA,KACA,QAAA,EACA,QAAA,GAGJ,uBACE,KAAA,EAKF,uBACE,MAAA,ElDolMF,4BkD7kMA,4BAEE,QAAA,aACA,MAAA,KACA,OAAA,KACA,WAAA,UAAA,GAAA,CAAA,KAAA,KAEF,4BACE,iBAAA,kLAEF,4BACE,iBAAA,kLASF,qBACE,SAAA,SACA,MAAA,EACA,OAAA,EACA,KAAA,EACA,QAAA,GACA,QAAA,YAAA,QAAA,KACA,cAAA,OAAA,gBAAA,OACA,aAAA,EAEA,aAAA,IACA,YAAA,IACA,WAAA,KAZF,wBAeI,WAAA,YACA,SAAA,EAAA,EAAA,KAAA,KAAA,EAAA,EAAA,KACA,MAAA,KACA,OAAA,IACA,aAAA,IACA,YAAA,IACA,YAAA,OACA,OAAA,QACA,iBAAA,KACA,gBAAA,YAEA,WAAA,KAAA,MAAA,YACA,cAAA,KAAA,MAAA,YACA,QAAA,GjCtKE,WAAA,QAAA,IAAA,KAKF,uCiCqIJ,wBjCpIM,WAAA,MiCoIN,6BAiCI,QAAA,EASJ,kBACE,SAAA,SACA,MAAA,IACA,OAAA,KACA,KAAA,IACA,QAAA,GACA,YAAA,KACA,eAAA,KACA,MAAA,KACA,WAAA,OE/LF,kCACE,GAAK,kBAAA,eAAA,UAAA,gBADP,0BACE,GAAK,kBAAA,eAAA,UAAA,gBAGP,gBACE,QAAA,aACA,MAAA,KACA,OAAA,KACA,eAAA,YACA,OAAA,MAAA,MAAA,aACA,mBAAA,YAEA,cAAA,IACA,kBAAA,eAAA,KAAA,OAAA,SAAA,UAAA,eAAA,KAAA,OAAA,SAGF,mBACE,MAAA,KACA,OAAA,KACA,aAAA,KAOF,gCACE,GACE,kBAAA,SAAA,UAAA,SAEF,IACE,QAAA,GALJ,wBACE,GACE,kBAAA,SAAA,UAAA,SAEF,IACE,QAAA,GAIJ,cACE,QAAA,aACA,MAAA,KACA,OAAA,KACA,eAAA,YACA,iBAAA,aAEA,cAAA,IACA,QAAA,EACA,kBAAA,aAAA,KAAA,OAAA,SAAA,UAAA,aAAA,KAAA,OAAA,SAGF,iBACE,MAAA,KACA,OAAA,KCnDF,gBAAqB,eAAA,mBACrB,WAAqB,eAAA,cACrB,cAAqB,eAAA,iBACrB,cAAqB,eAAA,iBACrB,mBAAqB,eAAA,sBACrB,gBAAqB,eAAA,mBCFnB,YACE,iBAAA,kBnDUF,mBAAA,mBHm2MF,wBADA,wBsDv2MM,iBAAA,kBANJ,cACE,iBAAA,kBnDUF,qBAAA,qBH62MF,0BADA,0BsDj3MM,iBAAA,kBANJ,YACE,iBAAA,kBnDUF,mBAAA,mBHu3MF,wBADA,wBsD33MM,iBAAA,kBANJ,SACE,iBAAA,kBnDUF,gBAAA,gBHi4MF,qBADA,qBsDr4MM,iBAAA,kBANJ,YACE,iBAAA,kBnDUF,mBAAA,mBH24MF,wBADA,wBsD/4MM,iBAAA,kBANJ,WACE,iBAAA,kBnDUF,kBAAA,kBHq5MF,uBADA,uBsDz5MM,iBAAA,kBANJ,UACE,iBAAA,kBnDUF,iBAAA,iBH+5MF,sBADA,sBsDn6MM,iBAAA,kBANJ,SACE,iBAAA,kBnDUF,gBAAA,gBHy6MF,qBADA,qBsD76MM,iBAAA,kBCCN,UACE,iBAAA,eAGF,gBACE,iBAAA,sBCXF,QAAkB,OAAA,IAAA,MAAA,kBAClB,YAAkB,WAAA,IAAA,MAAA,kBAClB,cAAkB,aAAA,IAAA,MAAA,kBAClB,eAAkB,cAAA,IAAA,MAAA,kBAClB,aAAkB,YAAA,IAAA,MAAA,kBAElB,UAAmB,OAAA,YACnB,cAAmB,WAAA,YACnB,gBAAmB,aAAA,YACnB,iBAAmB,cAAA,YACnB,eAAmB,YAAA,YAGjB,gBACE,aAAA,kBADF,kBACE,aAAA,kBADF,gBACE,aAAA,kBADF,aACE,aAAA,kBADF,gBACE,aAAA,kBADF,eACE,aAAA,kBADF,cACE,aAAA,kBADF,aACE,aAAA,kBAIJ,cACE,aAAA,eAOF,YACE,cAAA,gBAGF,SACE,cAAA,iBAGF,aACE,uBAAA,iBACA,wBAAA,iBAGF,eACE,wBAAA,iBACA,2BAAA,iBAGF,gBACE,2BAAA,iBACA,0BAAA,iBAGF,cACE,uBAAA,iBACA,0BAAA,iBAGF,YACE,cAAA,gBAGF,gBACE,cAAA,cAGF,cACE,cAAA,gBAGF,WACE,cAAA,YLxEA,iBACE,QAAA,MACA,MAAA,KACA,QAAA,GMOE,QAAwB,QAAA,eAAxB,UAAwB,QAAA,iBAAxB,gBAAwB,QAAA,uBAAxB,SAAwB,QAAA,gBAAxB,SAAwB,QAAA,gBAAxB,aAAwB,QAAA,oBAAxB,cAAwB,QAAA,qBAAxB,QAAwB,QAAA,sBAAA,QAAA,eAAxB,eAAwB,QAAA,6BAAA,QAAA,sB7CiD1B,yB6CjDE,WAAwB,QAAA,eAAxB,aAAwB,QAAA,iBAAxB,mBAAwB,QAAA,uBAAxB,YAAwB,QAAA,gBAAxB,YAAwB,QAAA,gBAAxB,gBAAwB,QAAA,oBAAxB,iBAAwB,QAAA,qBAAxB,WAAwB,QAAA,sBAAA,QAAA,eAAxB,kBAAwB,QAAA,6BAAA,QAAA,uB7CiD1B,yB6CjDE,WAAwB,QAAA,eAAxB,aAAwB,QAAA,iBAAxB,mBAAwB,QAAA,uBAAxB,YAAwB,QAAA,gBAAxB,YAAwB,QAAA,gBAAxB,gBAAwB,QAAA,oBAAxB,iBAAwB,QAAA,qBAAxB,WAAwB,QAAA,sBAAA,QAAA,eAAxB,kBAAwB,QAAA,6BAAA,QAAA,uB7CiD1B,yB6CjDE,WAAwB,QAAA,eAAxB,aAAwB,QAAA,iBAAxB,mBAAwB,QAAA,uBAAxB,YAAwB,QAAA,gBAAxB,YAAwB,QAAA,gBAAxB,gBAAwB,QAAA,oBAAxB,iBAAwB,QAAA,qBAAxB,WAAwB,QAAA,sBAAA,QAAA,eAAxB,kBAAwB,QAAA,6BAAA,QAAA,uB7CiD1B,0B6CjDE,WAAwB,QAAA,eAAxB,aAAwB,QAAA,iBAAxB,mBAAwB,QAAA,uBAAxB,YAAwB,QAAA,gBAAxB,YAAwB,QAAA,gBAAxB,gBAAwB,QAAA,oBAAxB,iBAAwB,QAAA,qBAAxB,WAAwB,QAAA,sBAAA,QAAA,eAAxB,kBAAwB,QAAA,6BAAA,QAAA,uBAU9B,aAEI,cAAqB,QAAA,eAArB,gBAAqB,QAAA,iBAArB,sBAAqB,QAAA,uBAArB,eAAqB,QAAA,gBAArB,eAAqB,QAAA,gBAArB,mBAAqB,QAAA,oBAArB,oBAAqB,QAAA,qBAArB,cAAqB,QAAA,sBAAA,QAAA,eAArB,qBAAqB,QAAA,6BAAA,QAAA,uBCrBzB,kBACE,SAAA,SACA,QAAA,MACA,MAAA,KACA,QAAA,EACA,SAAA,OALF,0BAQI,QAAA,MACA,QAAA,GATJ,yC1DsxNA,wBADA,yBAEA,yBACA,wB0DvwNI,SAAA,SACA,IAAA,EACA,OAAA,EACA,KAAA,EACA,MAAA,KACA,OAAA,KACA,OAAA,EAQF,gCAEI,YAAA,WAFJ,gCAEI,YAAA,OAFJ,+BAEI,YAAA,IAFJ,+BAEI,YAAA,KCzBF,UAAgC,mBAAA,cAAA,eAAA,cAChC,aAAgC,mBAAA,iBAAA,eAAA,iBAChC,kBAAgC,mBAAA,sBAAA,eAAA,sBAChC,qBAAgC,mBAAA,yBAAA,eAAA,yBAEhC,WAA8B,cAAA,eAAA,UAAA,eAC9B,aAA8B,cAAA,iBAAA,UAAA,iBAC9B,mBAA8B,cAAA,uBAAA,UAAA,uBAC9B,WAA8B,SAAA,EAAA,EAAA,eAAA,KAAA,EAAA,EAAA,eAC9B,aAA8B,kBAAA,YAAA,UAAA,YAC9B,aAA8B,kBAAA,YAAA,UAAA,YAC9B,eAA8B,kBAAA,YAAA,YAAA,YAC9B,eAA8B,kBAAA,YAAA,YAAA,YAE9B,uBAAoC,cAAA,gBAAA,gBAAA,qBACpC,qBAAoC,cAAA,cAAA,gBAAA,mBACpC,wBAAoC,cAAA,iBAAA,gBAAA,iBACpC,yBAAoC,cAAA,kBAAA,gBAAA,wBACpC,wBAAoC,cAAA,qBAAA,gBAAA,uBAEpC,mBAAiC,eAAA,gBAAA,YAAA,qBACjC,iBAAiC,eAAA,cAAA,YAAA,mBACjC,oBAAiC,eAAA,iBAAA,YAAA,iBACjC,sBAAiC,eAAA,mBAAA,YAAA,mBACjC,qBAAiC,eAAA,kBAAA,YAAA,kBAEjC,qBAAkC,mBAAA,gBAAA,cAAA,qBAClC,mBAAkC,mBAAA,cAAA,cAAA,mBAClC,sBAAkC,mBAAA,iBAAA,cAAA,iBAClC,uBAAkC,mBAAA,kBAAA,cAAA,wBAClC,sBAAkC,mBAAA,qBAAA,cAAA,uBAClC,uBAAkC,mBAAA,kBAAA,cAAA,kBAElC,iBAAgC,oBAAA,eAAA,WAAA,eAChC,kBAAgC,oBAAA,gBAAA,WAAA,qBAChC,gBAAgC,oBAAA,cAAA,WAAA,mBAChC,mBAAgC,oBAAA,iBAAA,WAAA,iBAChC,qBAAgC,oBAAA,mBAAA,WAAA,mBAChC,oBAAgC,oBAAA,kBAAA,WAAA,kB/CYhC,yB+ClDA,aAAgC,mBAAA,cAAA,eAAA,cAChC,gBAAgC,mBAAA,iBAAA,eAAA,iBAChC,qBAAgC,mBAAA,sBAAA,eAAA,sBAChC,wBAAgC,mBAAA,yBAAA,eAAA,yBAEhC,cAA8B,cAAA,eAAA,UAAA,eAC9B,gBAA8B,cAAA,iBAAA,UAAA,iBAC9B,sBAA8B,cAAA,uBAAA,UAAA,uBAC9B,cAA8B,SAAA,EAAA,EAAA,eAAA,KAAA,EAAA,EAAA,eAC9B,gBAA8B,kBAAA,YAAA,UAAA,YAC9B,gBAA8B,kBAAA,YAAA,UAAA,YAC9B,kBAA8B,kBAAA,YAAA,YAAA,YAC9B,kBAA8B,kBAAA,YAAA,YAAA,YAE9B,0BAAoC,cAAA,gBAAA,gBAAA,qBACpC,wBAAoC,cAAA,cAAA,gBAAA,mBACpC,2BAAoC,cAAA,iBAAA,gBAAA,iBACpC,4BAAoC,cAAA,kBAAA,gBAAA,wBACpC,2BAAoC,cAAA,qBAAA,gBAAA,uBAEpC,sBAAiC,eAAA,gBAAA,YAAA,qBACjC,oBAAiC,eAAA,cAAA,YAAA,mBACjC,uBAAiC,eAAA,iBAAA,YAAA,iBACjC,yBAAiC,eAAA,mBAAA,YAAA,mBACjC,wBAAiC,eAAA,kBAAA,YAAA,kBAEjC,wBAAkC,mBAAA,gBAAA,cAAA,qBAClC,sBAAkC,mBAAA,cAAA,cAAA,mBAClC,yBAAkC,mBAAA,iBAAA,cAAA,iBAClC,0BAAkC,mBAAA,kBAAA,cAAA,wBAClC,yBAAkC,mBAAA,qBAAA,cAAA,uBAClC,0BAAkC,mBAAA,kBAAA,cAAA,kBAElC,oBAAgC,oBAAA,eAAA,WAAA,eAChC,qBAAgC,oBAAA,gBAAA,WAAA,qBAChC,mBAAgC,oBAAA,cAAA,WAAA,mBAChC,sBAAgC,oBAAA,iBAAA,WAAA,iBAChC,wBAAgC,oBAAA,mBAAA,WAAA,mBAChC,uBAAgC,oBAAA,kBAAA,WAAA,mB/CYhC,yB+ClDA,aAAgC,mBAAA,cAAA,eAAA,cAChC,gBAAgC,mBAAA,iBAAA,eAAA,iBAChC,qBAAgC,mBAAA,sBAAA,eAAA,sBAChC,wBAAgC,mBAAA,yBAAA,eAAA,yBAEhC,cAA8B,cAAA,eAAA,UAAA,eAC9B,gBAA8B,cAAA,iBAAA,UAAA,iBAC9B,sBAA8B,cAAA,uBAAA,UAAA,uBAC9B,cAA8B,SAAA,EAAA,EAAA,eAAA,KAAA,EAAA,EAAA,eAC9B,gBAA8B,kBAAA,YAAA,UAAA,YAC9B,gBAA8B,kBAAA,YAAA,UAAA,YAC9B,kBAA8B,kBAAA,YAAA,YAAA,YAC9B,kBAA8B,kBAAA,YAAA,YAAA,YAE9B,0BAAoC,cAAA,gBAAA,gBAAA,qBACpC,wBAAoC,cAAA,cAAA,gBAAA,mBACpC,2BAAoC,cAAA,iBAAA,gBAAA,iBACpC,4BAAoC,cAAA,kBAAA,gBAAA,wBACpC,2BAAoC,cAAA,qBAAA,gBAAA,uBAEpC,sBAAiC,eAAA,gBAAA,YAAA,qBACjC,oBAAiC,eAAA,cAAA,YAAA,mBACjC,uBAAiC,eAAA,iBAAA,YAAA,iBACjC,yBAAiC,eAAA,mBAAA,YAAA,mBACjC,wBAAiC,eAAA,kBAAA,YAAA,kBAEjC,wBAAkC,mBAAA,gBAAA,cAAA,qBAClC,sBAAkC,mBAAA,cAAA,cAAA,mBAClC,yBAAkC,mBAAA,iBAAA,cAAA,iBAClC,0BAAkC,mBAAA,kBAAA,cAAA,wBAClC,yBAAkC,mBAAA,qBAAA,cAAA,uBAClC,0BAAkC,mBAAA,kBAAA,cAAA,kBAElC,oBAAgC,oBAAA,eAAA,WAAA,eAChC,qBAAgC,oBAAA,gBAAA,WAAA,qBAChC,mBAAgC,oBAAA,cAAA,WAAA,mBAChC,sBAAgC,oBAAA,iBAAA,WAAA,iBAChC,wBAAgC,oBAAA,mBAAA,WAAA,mBAChC,uBAAgC,oBAAA,kBAAA,WAAA,mB/CYhC,yB+ClDA,aAAgC,mBAAA,cAAA,eAAA,cAChC,gBAAgC,mBAAA,iBAAA,eAAA,iBAChC,qBAAgC,mBAAA,sBAAA,eAAA,sBAChC,wBAAgC,mBAAA,yBAAA,eAAA,yBAEhC,cAA8B,cAAA,eAAA,UAAA,eAC9B,gBAA8B,cAAA,iBAAA,UAAA,iBAC9B,sBAA8B,cAAA,uBAAA,UAAA,uBAC9B,cAA8B,SAAA,EAAA,EAAA,eAAA,KAAA,EAAA,EAAA,eAC9B,gBAA8B,kBAAA,YAAA,UAAA,YAC9B,gBAA8B,kBAAA,YAAA,UAAA,YAC9B,kBAA8B,kBAAA,YAAA,YAAA,YAC9B,kBAA8B,kBAAA,YAAA,YAAA,YAE9B,0BAAoC,cAAA,gBAAA,gBAAA,qBACpC,wBAAoC,cAAA,cAAA,gBAAA,mBACpC,2BAAoC,cAAA,iBAAA,gBAAA,iBACpC,4BAAoC,cAAA,kBAAA,gBAAA,wBACpC,2BAAoC,cAAA,qBAAA,gBAAA,uBAEpC,sBAAiC,eAAA,gBAAA,YAAA,qBACjC,oBAAiC,eAAA,cAAA,YAAA,mBACjC,uBAAiC,eAAA,iBAAA,YAAA,iBACjC,yBAAiC,eAAA,mBAAA,YAAA,mBACjC,wBAAiC,eAAA,kBAAA,YAAA,kBAEjC,wBAAkC,mBAAA,gBAAA,cAAA,qBAClC,sBAAkC,mBAAA,cAAA,cAAA,mBAClC,yBAAkC,mBAAA,iBAAA,cAAA,iBAClC,0BAAkC,mBAAA,kBAAA,cAAA,wBAClC,yBAAkC,mBAAA,qBAAA,cAAA,uBAClC,0BAAkC,mBAAA,kBAAA,cAAA,kBAElC,oBAAgC,oBAAA,eAAA,WAAA,eAChC,qBAAgC,oBAAA,gBAAA,WAAA,qBAChC,mBAAgC,oBAAA,cAAA,WAAA,mBAChC,sBAAgC,oBAAA,iBAAA,WAAA,iBAChC,wBAAgC,oBAAA,mBAAA,WAAA,mBAChC,uBAAgC,oBAAA,kBAAA,WAAA,mB/CYhC,0B+ClDA,aAAgC,mBAAA,cAAA,eAAA,cAChC,gBAAgC,mBAAA,iBAAA,eAAA,iBAChC,qBAAgC,mBAAA,sBAAA,eAAA,sBAChC,wBAAgC,mBAAA,yBAAA,eAAA,yBAEhC,cAA8B,cAAA,eAAA,UAAA,eAC9B,gBAA8B,cAAA,iBAAA,UAAA,iBAC9B,sBAA8B,cAAA,uBAAA,UAAA,uBAC9B,cAA8B,SAAA,EAAA,EAAA,eAAA,KAAA,EAAA,EAAA,eAC9B,gBAA8B,kBAAA,YAAA,UAAA,YAC9B,gBAA8B,kBAAA,YAAA,UAAA,YAC9B,kBAA8B,kBAAA,YAAA,YAAA,YAC9B,kBAA8B,kBAAA,YAAA,YAAA,YAE9B,0BAAoC,cAAA,gBAAA,gBAAA,qBACpC,wBAAoC,cAAA,cAAA,gBAAA,mBACpC,2BAAoC,cAAA,iBAAA,gBAAA,iBACpC,4BAAoC,cAAA,kBAAA,gBAAA,wBACpC,2BAAoC,cAAA,qBAAA,gBAAA,uBAEpC,sBAAiC,eAAA,gBAAA,YAAA,qBACjC,oBAAiC,eAAA,cAAA,YAAA,mBACjC,uBAAiC,eAAA,iBAAA,YAAA,iBACjC,yBAAiC,eAAA,mBAAA,YAAA,mBACjC,wBAAiC,eAAA,kBAAA,YAAA,kBAEjC,wBAAkC,mBAAA,gBAAA,cAAA,qBAClC,sBAAkC,mBAAA,cAAA,cAAA,mBAClC,yBAAkC,mBAAA,iBAAA,cAAA,iBAClC,0BAAkC,mBAAA,kBAAA,cAAA,wBAClC,yBAAkC,mBAAA,qBAAA,cAAA,uBAClC,0BAAkC,mBAAA,kBAAA,cAAA,kBAElC,oBAAgC,oBAAA,eAAA,WAAA,eAChC,qBAAgC,oBAAA,gBAAA,WAAA,qBAChC,mBAAgC,oBAAA,cAAA,WAAA,mBAChC,sBAAgC,oBAAA,iBAAA,WAAA,iBAChC,wBAAgC,oBAAA,mBAAA,WAAA,mBAChC,uBAAgC,oBAAA,kBAAA,WAAA,mBC1ChC,YAAwB,MAAA,eACxB,aAAwB,MAAA,gBACxB,YAAwB,MAAA,ehDoDxB,yBgDtDA,eAAwB,MAAA,eACxB,gBAAwB,MAAA,gBACxB,eAAwB,MAAA,gBhDoDxB,yBgDtDA,eAAwB,MAAA,eACxB,gBAAwB,MAAA,gBACxB,eAAwB,MAAA,gBhDoDxB,yBgDtDA,eAAwB,MAAA,eACxB,gBAAwB,MAAA,gBACxB,eAAwB,MAAA,gBhDoDxB,0BgDtDA,eAAwB,MAAA,eACxB,gBAAwB,MAAA,gBACxB,eAAwB,MAAA,gBCL1B,eAAsB,SAAA,eAAtB,iBAAsB,SAAA,iBCCtB,iBAAyB,SAAA,iBAAzB,mBAAyB,SAAA,mBAAzB,mBAAyB,SAAA,mBAAzB,gBAAyB,SAAA,gBAAzB,iBAAyB,SAAA,yBAAA,SAAA,iBAK3B,WACE,SAAA,MACA,IAAA,EACA,MAAA,EACA,KAAA,EACA,QAAA,KAGF,cACE,SAAA,MACA,MAAA,EACA,OAAA,EACA,KAAA,EACA,QAAA,KAI4B,2DAD9B,YAEI,SAAA,eAAA,SAAA,OACA,IAAA,EACA,QAAA,MCzBJ,SCEE,SAAA,SACA,MAAA,IACA,OAAA,IACA,QAAA,EACA,SAAA,OACA,KAAA,cACA,YAAA,OACA,OAAA,EAUA,0BAAA,yBAEE,SAAA,OACA,MAAA,KACA,OAAA,KACA,SAAA,QACA,KAAA,KACA,YAAA,OC5BJ,WAAa,WAAA,EAAA,QAAA,OAAA,2BACb,QAAU,WAAA,EAAA,MAAA,KAAA,0BACV,WAAa,WAAA,EAAA,KAAA,KAAA,2BACb,aAAe,WAAA,eCCX,MAAuB,MAAA,cAAvB,MAAuB,MAAA,cAAvB,MAAuB,MAAA,cAAvB,OAAuB,MAAA,eAAvB,QAAuB,MAAA,eAAvB,MAAuB,OAAA,cAAvB,MAAuB,OAAA,cAAvB,MAAuB,OAAA,cAAvB,OAAuB,OAAA,eAAvB,QAAuB,OAAA,eAI3B,QAAU,UAAA,eACV,QAAU,WAAA,eAIV,YAAc,UAAA,gBACd,YAAc,WAAA,gBAEd,QAAU,MAAA,gBACV,QAAU,OAAA,gBCfV,uBAEI,SAAA,SACA,IAAA,EACA,MAAA,EACA,OAAA,EACA,KAAA,EACA,QAAA,EAEA,eAAA,KACA,QAAA,GAEA,iBAAA,cCNI,KAAgC,OAAA,YAChC,MpEsuPR,MoEpuPU,WAAA,YAEF,MpEuuPR,MoEruPU,aAAA,YAEF,MpEwuPR,MoEtuPU,cAAA,YAEF,MpEyuPR,MoEvuPU,YAAA,YAfF,KAAgC,OAAA,iBAChC,MpE8vPR,MoE5vPU,WAAA,iBAEF,MpE+vPR,MoE7vPU,aAAA,iBAEF,MpEgwPR,MoE9vPU,cAAA,iBAEF,MpEiwPR,MoE/vPU,YAAA,iBAfF,KAAgC,OAAA,gBAChC,MpEsxPR,MoEpxPU,WAAA,gBAEF,MpEuxPR,MoErxPU,aAAA,gBAEF,MpEwxPR,MoEtxPU,cAAA,gBAEF,MpEyxPR,MoEvxPU,YAAA,gBAfF,KAAgC,OAAA,eAChC,MpE8yPR,MoE5yPU,WAAA,eAEF,MpE+yPR,MoE7yPU,aAAA,eAEF,MpEgzPR,MoE9yPU,cAAA,eAEF,MpEizPR,MoE/yPU,YAAA,eAfF,KAAgC,OAAA,iBAChC,MpEs0PR,MoEp0PU,WAAA,iBAEF,MpEu0PR,MoEr0PU,aAAA,iBAEF,MpEw0PR,MoEt0PU,cAAA,iBAEF,MpEy0PR,MoEv0PU,YAAA,iBAfF,KAAgC,OAAA,eAChC,MpE81PR,MoE51PU,WAAA,eAEF,MpE+1PR,MoE71PU,aAAA,eAEF,MpEg2PR,MoE91PU,cAAA,eAEF,MpEi2PR,MoE/1PU,YAAA,eAfF,KAAgC,QAAA,YAChC,MpEs3PR,MoEp3PU,YAAA,YAEF,MpEu3PR,MoEr3PU,cAAA,YAEF,MpEw3PR,MoEt3PU,eAAA,YAEF,MpEy3PR,MoEv3PU,aAAA,YAfF,KAAgC,QAAA,iBAChC,MpE84PR,MoE54PU,YAAA,iBAEF,MpE+4PR,MoE74PU,cAAA,iBAEF,MpEg5PR,MoE94PU,eAAA,iBAEF,MpEi5PR,MoE/4PU,aAAA,iBAfF,KAAgC,QAAA,gBAChC,MpEs6PR,MoEp6PU,YAAA,gBAEF,MpEu6PR,MoEr6PU,cAAA,gBAEF,MpEw6PR,MoEt6PU,eAAA,gBAEF,MpEy6PR,MoEv6PU,aAAA,gBAfF,KAAgC,QAAA,eAChC,MpE87PR,MoE57PU,YAAA,eAEF,MpE+7PR,MoE77PU,cAAA,eAEF,MpEg8PR,MoE97PU,eAAA,eAEF,MpEi8PR,MoE/7PU,aAAA,eAfF,KAAgC,QAAA,iBAChC,MpEs9PR,MoEp9PU,YAAA,iBAEF,MpEu9PR,MoEr9PU,cAAA,iBAEF,MpEw9PR,MoEt9PU,eAAA,iBAEF,MpEy9PR,MoEv9PU,aAAA,iBAfF,KAAgC,QAAA,eAChC,MpE8+PR,MoE5+PU,YAAA,eAEF,MpE++PR,MoE7+PU,cAAA,eAEF,MpEg/PR,MoE9+PU,eAAA,eAEF,MpEi/PR,MoE/+PU,aAAA,eAQF,MAAwB,OAAA,kBACxB,OpE++PR,OoE7+PU,WAAA,kBAEF,OpEg/PR,OoE9+PU,aAAA,kBAEF,OpEi/PR,OoE/+PU,cAAA,kBAEF,OpEk/PR,OoEh/PU,YAAA,kBAfF,MAAwB,OAAA,iBACxB,OpEugQR,OoErgQU,WAAA,iBAEF,OpEwgQR,OoEtgQU,aAAA,iBAEF,OpEygQR,OoEvgQU,cAAA,iBAEF,OpE0gQR,OoExgQU,YAAA,iBAfF,MAAwB,OAAA,gBACxB,OpE+hQR,OoE7hQU,WAAA,gBAEF,OpEgiQR,OoE9hQU,aAAA,gBAEF,OpEiiQR,OoE/hQU,cAAA,gBAEF,OpEkiQR,OoEhiQU,YAAA,gBAfF,MAAwB,OAAA,kBACxB,OpEujQR,OoErjQU,WAAA,kBAEF,OpEwjQR,OoEtjQU,aAAA,kBAEF,OpEyjQR,OoEvjQU,cAAA,kBAEF,OpE0jQR,OoExjQU,YAAA,kBAfF,MAAwB,OAAA,gBACxB,OpE+kQR,OoE7kQU,WAAA,gBAEF,OpEglQR,OoE9kQU,aAAA,gBAEF,OpEilQR,OoE/kQU,cAAA,gBAEF,OpEklQR,OoEhlQU,YAAA,gBAMN,QAAmB,OAAA,eACnB,SpEklQJ,SoEhlQM,WAAA,eAEF,SpEmlQJ,SoEjlQM,aAAA,eAEF,SpEolQJ,SoEllQM,cAAA,eAEF,SpEqlQJ,SoEnlQM,YAAA,exDTF,yBwDlDI,QAAgC,OAAA,YAChC,SpEspQN,SoEppQQ,WAAA,YAEF,SpEspQN,SoEppQQ,aAAA,YAEF,SpEspQN,SoEppQQ,cAAA,YAEF,SpEspQN,SoEppQQ,YAAA,YAfF,QAAgC,OAAA,iBAChC,SpEyqQN,SoEvqQQ,WAAA,iBAEF,SpEyqQN,SoEvqQQ,aAAA,iBAEF,SpEyqQN,SoEvqQQ,cAAA,iBAEF,SpEyqQN,SoEvqQQ,YAAA,iBAfF,QAAgC,OAAA,gBAChC,SpE4rQN,SoE1rQQ,WAAA,gBAEF,SpE4rQN,SoE1rQQ,aAAA,gBAEF,SpE4rQN,SoE1rQQ,cAAA,gBAEF,SpE4rQN,SoE1rQQ,YAAA,gBAfF,QAAgC,OAAA,eAChC,SpE+sQN,SoE7sQQ,WAAA,eAEF,SpE+sQN,SoE7sQQ,aAAA,eAEF,SpE+sQN,SoE7sQQ,cAAA,eAEF,SpE+sQN,SoE7sQQ,YAAA,eAfF,QAAgC,OAAA,iBAChC,SpEkuQN,SoEhuQQ,WAAA,iBAEF,SpEkuQN,SoEhuQQ,aAAA,iBAEF,SpEkuQN,SoEhuQQ,cAAA,iBAEF,SpEkuQN,SoEhuQQ,YAAA,iBAfF,QAAgC,OAAA,eAChC,SpEqvQN,SoEnvQQ,WAAA,eAEF,SpEqvQN,SoEnvQQ,aAAA,eAEF,SpEqvQN,SoEnvQQ,cAAA,eAEF,SpEqvQN,SoEnvQQ,YAAA,eAfF,QAAgC,QAAA,YAChC,SpEwwQN,SoEtwQQ,YAAA,YAEF,SpEwwQN,SoEtwQQ,cAAA,YAEF,SpEwwQN,SoEtwQQ,eAAA,YAEF,SpEwwQN,SoEtwQQ,aAAA,YAfF,QAAgC,QAAA,iBAChC,SpE2xQN,SoEzxQQ,YAAA,iBAEF,SpE2xQN,SoEzxQQ,cAAA,iBAEF,SpE2xQN,SoEzxQQ,eAAA,iBAEF,SpE2xQN,SoEzxQQ,aAAA,iBAfF,QAAgC,QAAA,gBAChC,SpE8yQN,SoE5yQQ,YAAA,gBAEF,SpE8yQN,SoE5yQQ,cAAA,gBAEF,SpE8yQN,SoE5yQQ,eAAA,gBAEF,SpE8yQN,SoE5yQQ,aAAA,gBAfF,QAAgC,QAAA,eAChC,SpEi0QN,SoE/zQQ,YAAA,eAEF,SpEi0QN,SoE/zQQ,cAAA,eAEF,SpEi0QN,SoE/zQQ,eAAA,eAEF,SpEi0QN,SoE/zQQ,aAAA,eAfF,QAAgC,QAAA,iBAChC,SpEo1QN,SoEl1QQ,YAAA,iBAEF,SpEo1QN,SoEl1QQ,cAAA,iBAEF,SpEo1QN,SoEl1QQ,eAAA,iBAEF,SpEo1QN,SoEl1QQ,aAAA,iBAfF,QAAgC,QAAA,eAChC,SpEu2QN,SoEr2QQ,YAAA,eAEF,SpEu2QN,SoEr2QQ,cAAA,eAEF,SpEu2QN,SoEr2QQ,eAAA,eAEF,SpEu2QN,SoEr2QQ,aAAA,eAQF,SAAwB,OAAA,kBACxB,UpEm2QN,UoEj2QQ,WAAA,kBAEF,UpEm2QN,UoEj2QQ,aAAA,kBAEF,UpEm2QN,UoEj2QQ,cAAA,kBAEF,UpEm2QN,UoEj2QQ,YAAA,kBAfF,SAAwB,OAAA,iBACxB,UpEs3QN,UoEp3QQ,WAAA,iBAEF,UpEs3QN,UoEp3QQ,aAAA,iBAEF,UpEs3QN,UoEp3QQ,cAAA,iBAEF,UpEs3QN,UoEp3QQ,YAAA,iBAfF,SAAwB,OAAA,gBACxB,UpEy4QN,UoEv4QQ,WAAA,gBAEF,UpEy4QN,UoEv4QQ,aAAA,gBAEF,UpEy4QN,UoEv4QQ,cAAA,gBAEF,UpEy4QN,UoEv4QQ,YAAA,gBAfF,SAAwB,OAAA,kBACxB,UpE45QN,UoE15QQ,WAAA,kBAEF,UpE45QN,UoE15QQ,aAAA,kBAEF,UpE45QN,UoE15QQ,cAAA,kBAEF,UpE45QN,UoE15QQ,YAAA,kBAfF,SAAwB,OAAA,gBACxB,UpE+6QN,UoE76QQ,WAAA,gBAEF,UpE+6QN,UoE76QQ,aAAA,gBAEF,UpE+6QN,UoE76QQ,cAAA,gBAEF,UpE+6QN,UoE76QQ,YAAA,gBAMN,WAAmB,OAAA,eACnB,YpE66QF,YoE36QI,WAAA,eAEF,YpE66QF,YoE36QI,aAAA,eAEF,YpE66QF,YoE36QI,cAAA,eAEF,YpE66QF,YoE36QI,YAAA,gBxDTF,yBwDlDI,QAAgC,OAAA,YAChC,SpE++QN,SoE7+QQ,WAAA,YAEF,SpE++QN,SoE7+QQ,aAAA,YAEF,SpE++QN,SoE7+QQ,cAAA,YAEF,SpE++QN,SoE7+QQ,YAAA,YAfF,QAAgC,OAAA,iBAChC,SpEkgRN,SoEhgRQ,WAAA,iBAEF,SpEkgRN,SoEhgRQ,aAAA,iBAEF,SpEkgRN,SoEhgRQ,cAAA,iBAEF,SpEkgRN,SoEhgRQ,YAAA,iBAfF,QAAgC,OAAA,gBAChC,SpEqhRN,SoEnhRQ,WAAA,gBAEF,SpEqhRN,SoEnhRQ,aAAA,gBAEF,SpEqhRN,SoEnhRQ,cAAA,gBAEF,SpEqhRN,SoEnhRQ,YAAA,gBAfF,QAAgC,OAAA,eAChC,SpEwiRN,SoEtiRQ,WAAA,eAEF,SpEwiRN,SoEtiRQ,aAAA,eAEF,SpEwiRN,SoEtiRQ,cAAA,eAEF,SpEwiRN,SoEtiRQ,YAAA,eAfF,QAAgC,OAAA,iBAChC,SpE2jRN,SoEzjRQ,WAAA,iBAEF,SpE2jRN,SoEzjRQ,aAAA,iBAEF,SpE2jRN,SoEzjRQ,cAAA,iBAEF,SpE2jRN,SoEzjRQ,YAAA,iBAfF,QAAgC,OAAA,eAChC,SpE8kRN,SoE5kRQ,WAAA,eAEF,SpE8kRN,SoE5kRQ,aAAA,eAEF,SpE8kRN,SoE5kRQ,cAAA,eAEF,SpE8kRN,SoE5kRQ,YAAA,eAfF,QAAgC,QAAA,YAChC,SpEimRN,SoE/lRQ,YAAA,YAEF,SpEimRN,SoE/lRQ,cAAA,YAEF,SpEimRN,SoE/lRQ,eAAA,YAEF,SpEimRN,SoE/lRQ,aAAA,YAfF,QAAgC,QAAA,iBAChC,SpEonRN,SoElnRQ,YAAA,iBAEF,SpEonRN,SoElnRQ,cAAA,iBAEF,SpEonRN,SoElnRQ,eAAA,iBAEF,SpEonRN,SoElnRQ,aAAA,iBAfF,QAAgC,QAAA,gBAChC,SpEuoRN,SoEroRQ,YAAA,gBAEF,SpEuoRN,SoEroRQ,cAAA,gBAEF,SpEuoRN,SoEroRQ,eAAA,gBAEF,SpEuoRN,SoEroRQ,aAAA,gBAfF,QAAgC,QAAA,eAChC,SpE0pRN,SoExpRQ,YAAA,eAEF,SpE0pRN,SoExpRQ,cAAA,eAEF,SpE0pRN,SoExpRQ,eAAA,eAEF,SpE0pRN,SoExpRQ,aAAA,eAfF,QAAgC,QAAA,iBAChC,SpE6qRN,SoE3qRQ,YAAA,iBAEF,SpE6qRN,SoE3qRQ,cAAA,iBAEF,SpE6qRN,SoE3qRQ,eAAA,iBAEF,SpE6qRN,SoE3qRQ,aAAA,iBAfF,QAAgC,QAAA,eAChC,SpEgsRN,SoE9rRQ,YAAA,eAEF,SpEgsRN,SoE9rRQ,cAAA,eAEF,SpEgsRN,SoE9rRQ,eAAA,eAEF,SpEgsRN,SoE9rRQ,aAAA,eAQF,SAAwB,OAAA,kBACxB,UpE4rRN,UoE1rRQ,WAAA,kBAEF,UpE4rRN,UoE1rRQ,aAAA,kBAEF,UpE4rRN,UoE1rRQ,cAAA,kBAEF,UpE4rRN,UoE1rRQ,YAAA,kBAfF,SAAwB,OAAA,iBACxB,UpE+sRN,UoE7sRQ,WAAA,iBAEF,UpE+sRN,UoE7sRQ,aAAA,iBAEF,UpE+sRN,UoE7sRQ,cAAA,iBAEF,UpE+sRN,UoE7sRQ,YAAA,iBAfF,SAAwB,OAAA,gBACxB,UpEkuRN,UoEhuRQ,WAAA,gBAEF,UpEkuRN,UoEhuRQ,aAAA,gBAEF,UpEkuRN,UoEhuRQ,cAAA,gBAEF,UpEkuRN,UoEhuRQ,YAAA,gBAfF,SAAwB,OAAA,kBACxB,UpEqvRN,UoEnvRQ,WAAA,kBAEF,UpEqvRN,UoEnvRQ,aAAA,kBAEF,UpEqvRN,UoEnvRQ,cAAA,kBAEF,UpEqvRN,UoEnvRQ,YAAA,kBAfF,SAAwB,OAAA,gBACxB,UpEwwRN,UoEtwRQ,WAAA,gBAEF,UpEwwRN,UoEtwRQ,aAAA,gBAEF,UpEwwRN,UoEtwRQ,cAAA,gBAEF,UpEwwRN,UoEtwRQ,YAAA,gBAMN,WAAmB,OAAA,eACnB,YpEswRF,YoEpwRI,WAAA,eAEF,YpEswRF,YoEpwRI,aAAA,eAEF,YpEswRF,YoEpwRI,cAAA,eAEF,YpEswRF,YoEpwRI,YAAA,gBxDTF,yBwDlDI,QAAgC,OAAA,YAChC,SpEw0RN,SoEt0RQ,WAAA,YAEF,SpEw0RN,SoEt0RQ,aAAA,YAEF,SpEw0RN,SoEt0RQ,cAAA,YAEF,SpEw0RN,SoEt0RQ,YAAA,YAfF,QAAgC,OAAA,iBAChC,SpE21RN,SoEz1RQ,WAAA,iBAEF,SpE21RN,SoEz1RQ,aAAA,iBAEF,SpE21RN,SoEz1RQ,cAAA,iBAEF,SpE21RN,SoEz1RQ,YAAA,iBAfF,QAAgC,OAAA,gBAChC,SpE82RN,SoE52RQ,WAAA,gBAEF,SpE82RN,SoE52RQ,aAAA,gBAEF,SpE82RN,SoE52RQ,cAAA,gBAEF,SpE82RN,SoE52RQ,YAAA,gBAfF,QAAgC,OAAA,eAChC,SpEi4RN,SoE/3RQ,WAAA,eAEF,SpEi4RN,SoE/3RQ,aAAA,eAEF,SpEi4RN,SoE/3RQ,cAAA,eAEF,SpEi4RN,SoE/3RQ,YAAA,eAfF,QAAgC,OAAA,iBAChC,SpEo5RN,SoEl5RQ,WAAA,iBAEF,SpEo5RN,SoEl5RQ,aAAA,iBAEF,SpEo5RN,SoEl5RQ,cAAA,iBAEF,SpEo5RN,SoEl5RQ,YAAA,iBAfF,QAAgC,OAAA,eAChC,SpEu6RN,SoEr6RQ,WAAA,eAEF,SpEu6RN,SoEr6RQ,aAAA,eAEF,SpEu6RN,SoEr6RQ,cAAA,eAEF,SpEu6RN,SoEr6RQ,YAAA,eAfF,QAAgC,QAAA,YAChC,SpE07RN,SoEx7RQ,YAAA,YAEF,SpE07RN,SoEx7RQ,cAAA,YAEF,SpE07RN,SoEx7RQ,eAAA,YAEF,SpE07RN,SoEx7RQ,aAAA,YAfF,QAAgC,QAAA,iBAChC,SpE68RN,SoE38RQ,YAAA,iBAEF,SpE68RN,SoE38RQ,cAAA,iBAEF,SpE68RN,SoE38RQ,eAAA,iBAEF,SpE68RN,SoE38RQ,aAAA,iBAfF,QAAgC,QAAA,gBAChC,SpEg+RN,SoE99RQ,YAAA,gBAEF,SpEg+RN,SoE99RQ,cAAA,gBAEF,SpEg+RN,SoE99RQ,eAAA,gBAEF,SpEg+RN,SoE99RQ,aAAA,gBAfF,QAAgC,QAAA,eAChC,SpEm/RN,SoEj/RQ,YAAA,eAEF,SpEm/RN,SoEj/RQ,cAAA,eAEF,SpEm/RN,SoEj/RQ,eAAA,eAEF,SpEm/RN,SoEj/RQ,aAAA,eAfF,QAAgC,QAAA,iBAChC,SpEsgSN,SoEpgSQ,YAAA,iBAEF,SpEsgSN,SoEpgSQ,cAAA,iBAEF,SpEsgSN,SoEpgSQ,eAAA,iBAEF,SpEsgSN,SoEpgSQ,aAAA,iBAfF,QAAgC,QAAA,eAChC,SpEyhSN,SoEvhSQ,YAAA,eAEF,SpEyhSN,SoEvhSQ,cAAA,eAEF,SpEyhSN,SoEvhSQ,eAAA,eAEF,SpEyhSN,SoEvhSQ,aAAA,eAQF,SAAwB,OAAA,kBACxB,UpEqhSN,UoEnhSQ,WAAA,kBAEF,UpEqhSN,UoEnhSQ,aAAA,kBAEF,UpEqhSN,UoEnhSQ,cAAA,kBAEF,UpEqhSN,UoEnhSQ,YAAA,kBAfF,SAAwB,OAAA,iBACxB,UpEwiSN,UoEtiSQ,WAAA,iBAEF,UpEwiSN,UoEtiSQ,aAAA,iBAEF,UpEwiSN,UoEtiSQ,cAAA,iBAEF,UpEwiSN,UoEtiSQ,YAAA,iBAfF,SAAwB,OAAA,gBACxB,UpE2jSN,UoEzjSQ,WAAA,gBAEF,UpE2jSN,UoEzjSQ,aAAA,gBAEF,UpE2jSN,UoEzjSQ,cAAA,gBAEF,UpE2jSN,UoEzjSQ,YAAA,gBAfF,SAAwB,OAAA,kBACxB,UpE8kSN,UoE5kSQ,WAAA,kBAEF,UpE8kSN,UoE5kSQ,aAAA,kBAEF,UpE8kSN,UoE5kSQ,cAAA,kBAEF,UpE8kSN,UoE5kSQ,YAAA,kBAfF,SAAwB,OAAA,gBACxB,UpEimSN,UoE/lSQ,WAAA,gBAEF,UpEimSN,UoE/lSQ,aAAA,gBAEF,UpEimSN,UoE/lSQ,cAAA,gBAEF,UpEimSN,UoE/lSQ,YAAA,gBAMN,WAAmB,OAAA,eACnB,YpE+lSF,YoE7lSI,WAAA,eAEF,YpE+lSF,YoE7lSI,aAAA,eAEF,YpE+lSF,YoE7lSI,cAAA,eAEF,YpE+lSF,YoE7lSI,YAAA,gBxDTF,0BwDlDI,QAAgC,OAAA,YAChC,SpEiqSN,SoE/pSQ,WAAA,YAEF,SpEiqSN,SoE/pSQ,aAAA,YAEF,SpEiqSN,SoE/pSQ,cAAA,YAEF,SpEiqSN,SoE/pSQ,YAAA,YAfF,QAAgC,OAAA,iBAChC,SpEorSN,SoElrSQ,WAAA,iBAEF,SpEorSN,SoElrSQ,aAAA,iBAEF,SpEorSN,SoElrSQ,cAAA,iBAEF,SpEorSN,SoElrSQ,YAAA,iBAfF,QAAgC,OAAA,gBAChC,SpEusSN,SoErsSQ,WAAA,gBAEF,SpEusSN,SoErsSQ,aAAA,gBAEF,SpEusSN,SoErsSQ,cAAA,gBAEF,SpEusSN,SoErsSQ,YAAA,gBAfF,QAAgC,OAAA,eAChC,SpE0tSN,SoExtSQ,WAAA,eAEF,SpE0tSN,SoExtSQ,aAAA,eAEF,SpE0tSN,SoExtSQ,cAAA,eAEF,SpE0tSN,SoExtSQ,YAAA,eAfF,QAAgC,OAAA,iBAChC,SpE6uSN,SoE3uSQ,WAAA,iBAEF,SpE6uSN,SoE3uSQ,aAAA,iBAEF,SpE6uSN,SoE3uSQ,cAAA,iBAEF,SpE6uSN,SoE3uSQ,YAAA,iBAfF,QAAgC,OAAA,eAChC,SpEgwSN,SoE9vSQ,WAAA,eAEF,SpEgwSN,SoE9vSQ,aAAA,eAEF,SpEgwSN,SoE9vSQ,cAAA,eAEF,SpEgwSN,SoE9vSQ,YAAA,eAfF,QAAgC,QAAA,YAChC,SpEmxSN,SoEjxSQ,YAAA,YAEF,SpEmxSN,SoEjxSQ,cAAA,YAEF,SpEmxSN,SoEjxSQ,eAAA,YAEF,SpEmxSN,SoEjxSQ,aAAA,YAfF,QAAgC,QAAA,iBAChC,SpEsySN,SoEpySQ,YAAA,iBAEF,SpEsySN,SoEpySQ,cAAA,iBAEF,SpEsySN,SoEpySQ,eAAA,iBAEF,SpEsySN,SoEpySQ,aAAA,iBAfF,QAAgC,QAAA,gBAChC,SpEyzSN,SoEvzSQ,YAAA,gBAEF,SpEyzSN,SoEvzSQ,cAAA,gBAEF,SpEyzSN,SoEvzSQ,eAAA,gBAEF,SpEyzSN,SoEvzSQ,aAAA,gBAfF,QAAgC,QAAA,eAChC,SpE40SN,SoE10SQ,YAAA,eAEF,SpE40SN,SoE10SQ,cAAA,eAEF,SpE40SN,SoE10SQ,eAAA,eAEF,SpE40SN,SoE10SQ,aAAA,eAfF,QAAgC,QAAA,iBAChC,SpE+1SN,SoE71SQ,YAAA,iBAEF,SpE+1SN,SoE71SQ,cAAA,iBAEF,SpE+1SN,SoE71SQ,eAAA,iBAEF,SpE+1SN,SoE71SQ,aAAA,iBAfF,QAAgC,QAAA,eAChC,SpEk3SN,SoEh3SQ,YAAA,eAEF,SpEk3SN,SoEh3SQ,cAAA,eAEF,SpEk3SN,SoEh3SQ,eAAA,eAEF,SpEk3SN,SoEh3SQ,aAAA,eAQF,SAAwB,OAAA,kBACxB,UpE82SN,UoE52SQ,WAAA,kBAEF,UpE82SN,UoE52SQ,aAAA,kBAEF,UpE82SN,UoE52SQ,cAAA,kBAEF,UpE82SN,UoE52SQ,YAAA,kBAfF,SAAwB,OAAA,iBACxB,UpEi4SN,UoE/3SQ,WAAA,iBAEF,UpEi4SN,UoE/3SQ,aAAA,iBAEF,UpEi4SN,UoE/3SQ,cAAA,iBAEF,UpEi4SN,UoE/3SQ,YAAA,iBAfF,SAAwB,OAAA,gBACxB,UpEo5SN,UoEl5SQ,WAAA,gBAEF,UpEo5SN,UoEl5SQ,aAAA,gBAEF,UpEo5SN,UoEl5SQ,cAAA,gBAEF,UpEo5SN,UoEl5SQ,YAAA,gBAfF,SAAwB,OAAA,kBACxB,UpEu6SN,UoEr6SQ,WAAA,kBAEF,UpEu6SN,UoEr6SQ,aAAA,kBAEF,UpEu6SN,UoEr6SQ,cAAA,kBAEF,UpEu6SN,UoEr6SQ,YAAA,kBAfF,SAAwB,OAAA,gBACxB,UpE07SN,UoEx7SQ,WAAA,gBAEF,UpE07SN,UoEx7SQ,aAAA,gBAEF,UpE07SN,UoEx7SQ,cAAA,gBAEF,UpE07SN,UoEx7SQ,YAAA,gBAMN,WAAmB,OAAA,eACnB,YpEw7SF,YoEt7SI,WAAA,eAEF,YpEw7SF,YoEt7SI,aAAA,eAEF,YpEw7SF,YoEt7SI,cAAA,eAEF,YpEw7SF,YoEt7SI,YAAA,gBC/DN,gBAAkB,YAAA,cAAA,CAAA,KAAA,CAAA,MAAA,CAAA,QAAA,CAAA,iBAAA,CAAA,aAAA,CAAA,oBAIlB,cAAiB,WAAA,kBACjB,WAAiB,YAAA,iBACjB,aAAiB,YAAA,iBACjB,eCTE,SAAA,OACA,cAAA,SACA,YAAA,ODeE,WAAwB,WAAA,eACxB,YAAwB,WAAA,gBACxB,aAAwB,WAAA,iBzDqCxB,yByDvCA,cAAwB,WAAA,eACxB,eAAwB,WAAA,gBACxB,gBAAwB,WAAA,kBzDqCxB,yByDvCA,cAAwB,WAAA,eACxB,eAAwB,WAAA,gBACxB,gBAAwB,WAAA,kBzDqCxB,yByDvCA,cAAwB,WAAA,eACxB,eAAwB,WAAA,gBACxB,gBAAwB,WAAA,kBzDqCxB,0ByDvCA,cAAwB,WAAA,eACxB,eAAwB,WAAA,gBACxB,gBAAwB,WAAA,kBAM5B,gBAAmB,eAAA,oBACnB,gBAAmB,eAAA,oBACnB,iBAAmB,eAAA,qBAInB,mBAAuB,YAAA,cACvB,qBAAuB,YAAA,kBACvB,oBAAuB,YAAA,cACvB,kBAAuB,YAAA,cACvB,oBAAuB,YAAA,iBACvB,aAAuB,WAAA,iBAIvB,YAAc,MAAA,eEvCZ,cACE,MAAA,kBpEUF,qBAAA,qBoELM,MAAA,kBANN,gBACE,MAAA,kBpEUF,uBAAA,uBoELM,MAAA,kBANN,cACE,MAAA,kBpEUF,qBAAA,qBoELM,MAAA,kBANN,WACE,MAAA,kBpEUF,kBAAA,kBoELM,MAAA,kBANN,cACE,MAAA,kBpEUF,qBAAA,qBoELM,MAAA,kBANN,aACE,MAAA,kBpEUF,oBAAA,oBoELM,MAAA,kBANN,YACE,MAAA,kBpEUF,mBAAA,mBoELM,MAAA,kBANN,WACE,MAAA,kBpEUF,kBAAA,kBoELM,MAAA,kBFuCR,WAAa,MAAA,kBACb,YAAc,MAAA,kBAEd,eAAiB,MAAA,yBACjB,eAAiB,MAAA,+BAIjB,WGvDE,KAAA,CAAA,CAAA,EAAA,EACA,MAAA,YACA,YAAA,KACA,iBAAA,YACA,OAAA,EHuDF,sBAAwB,gBAAA,eAExB,YACE,WAAA,qBACA,cAAA,qBAKF,YAAc,MAAA,kBIjEd,SACE,WAAA,kBAGF,WACE,WAAA,iBCAA,a3EOF,ECwtTE,QADA,S0ExtTI,YAAA,eAEA,WAAA,eAGF,YAEI,gBAAA,UASJ,mBACE,QAAA,KAAA,YAAA,I3E+LN,I2EhLM,YAAA,mB1EusTJ,W0ErsTE,IAEE,OAAA,IAAA,MAAA,QACA,kBAAA,MAQF,MACE,QAAA,mB1EisTJ,I0E9rTE,GAEE,kBAAA,M1EgsTJ,GACA,G0E9rTE,EAGE,QAAA,EACA,OAAA,EAGF,G1E4rTF,G0E1rTI,iBAAA,MAQF,MACE,KAAA,G3E5CN,K2E+CM,UAAA,gBhEvFJ,WgE0FI,UAAA,gB5C9EN,Q4CmFM,QAAA,KvC/FN,OuCkGM,OAAA,IAAA,MAAA,K5DnGN,O4DuGM,gBAAA,mBADF,U1EsrTF,U0EjrTM,iBAAA,e1EqrTN,mBcxvTF,mB4D0EQ,OAAA,IAAA,MAAA,kB5DWR,Y4DNM,MAAA,Q1EkrTJ,wBAFA,eetyTA,efuyTA,qB0E3qTM,aAAA,Q5DlBR,sB4DuBM,MAAA,QACA,aAAA","sourcesContent":["/*!\n * Bootstrap v4.3.1 (https://getbootstrap.com/)\n * Copyright 2011-2019 The Bootstrap Authors\n * Copyright 2011-2019 Twitter, Inc.\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)\n */\n\n@import \"functions\";\n@import \"variables\";\n@import \"mixins\";\n@import \"root\";\n@import \"reboot\";\n@import \"type\";\n@import \"images\";\n@import \"code\";\n@import \"grid\";\n@import \"tables\";\n@import \"forms\";\n@import \"buttons\";\n@import \"transitions\";\n@import \"dropdown\";\n@import \"button-group\";\n@import \"input-group\";\n@import \"custom-forms\";\n@import \"nav\";\n@import \"navbar\";\n@import \"card\";\n@import \"breadcrumb\";\n@import \"pagination\";\n@import \"badge\";\n@import \"jumbotron\";\n@import \"alert\";\n@import \"progress\";\n@import \"media\";\n@import \"list-group\";\n@import \"close\";\n@import \"toasts\";\n@import \"modal\";\n@import \"tooltip\";\n@import \"popover\";\n@import \"carousel\";\n@import \"spinners\";\n@import \"utilities\";\n@import \"print\";\n",":root {\n  // Custom variable values only support SassScript inside `#{}`.\n  @each $color, $value in $colors {\n    --#{$color}: #{$value};\n  }\n\n  @each $color, $value in $theme-colors {\n    --#{$color}: #{$value};\n  }\n\n  @each $bp, $value in $grid-breakpoints {\n    --breakpoint-#{$bp}: #{$value};\n  }\n\n  // Use `inspect` for lists so that quoted items keep the quotes.\n  // See https://github.com/sass/sass/issues/2383#issuecomment-336349172\n  --font-family-sans-serif: #{inspect($font-family-sans-serif)};\n  --font-family-monospace: #{inspect($font-family-monospace)};\n}\n","// stylelint-disable at-rule-no-vendor-prefix, declaration-no-important, selector-no-qualifying-type, property-no-vendor-prefix\n\n// Reboot\n//\n// Normalization of HTML elements, manually forked from Normalize.css to remove\n// styles targeting irrelevant browsers while applying new styles.\n//\n// Normalize is licensed MIT. https://github.com/necolas/normalize.css\n\n\n// Document\n//\n// 1. Change from `box-sizing: content-box` so that `width` is not affected by `padding` or `border`.\n// 2. Change the default font family in all browsers.\n// 3. Correct the line height in all browsers.\n// 4. Prevent adjustments of font size after orientation changes in IE on Windows Phone and in iOS.\n// 5. Change the default tap highlight to be completely transparent in iOS.\n\n*,\n*::before,\n*::after {\n  box-sizing: border-box; // 1\n}\n\nhtml {\n  font-family: sans-serif; // 2\n  line-height: 1.15; // 3\n  -webkit-text-size-adjust: 100%; // 4\n  -webkit-tap-highlight-color: rgba($black, 0); // 5\n}\n\n// Shim for \"new\" HTML5 structural elements to display correctly (IE10, older browsers)\n// TODO: remove in v5\n// stylelint-disable-next-line selector-list-comma-newline-after\narticle, aside, figcaption, figure, footer, header, hgroup, main, nav, section {\n  display: block;\n}\n\n// Body\n//\n// 1. Remove the margin in all browsers.\n// 2. As a best practice, apply a default `background-color`.\n// 3. Set an explicit initial text-align value so that we can later use\n//    the `inherit` value on things like `<th>` elements.\n\nbody {\n  margin: 0; // 1\n  font-family: $font-family-base;\n  @include font-size($font-size-base);\n  font-weight: $font-weight-base;\n  line-height: $line-height-base;\n  color: $body-color;\n  text-align: left; // 3\n  background-color: $body-bg; // 2\n}\n\n// Suppress the focus outline on elements that cannot be accessed via keyboard.\n// This prevents an unwanted focus outline from appearing around elements that\n// might still respond to pointer events.\n//\n// Credit: https://github.com/suitcss/base\n[tabindex=\"-1\"]:focus {\n  outline: 0 !important;\n}\n\n\n// Content grouping\n//\n// 1. Add the correct box sizing in Firefox.\n// 2. Show the overflow in Edge and IE.\n\nhr {\n  box-sizing: content-box; // 1\n  height: 0; // 1\n  overflow: visible; // 2\n}\n\n\n//\n// Typography\n//\n\n// Remove top margins from headings\n//\n// By default, `<h1>`-`<h6>` all receive top and bottom margins. We nuke the top\n// margin for easier control within type scales as it avoids margin collapsing.\n// stylelint-disable-next-line selector-list-comma-newline-after\nh1, h2, h3, h4, h5, h6 {\n  margin-top: 0;\n  margin-bottom: $headings-margin-bottom;\n}\n\n// Reset margins on paragraphs\n//\n// Similarly, the top margin on `<p>`s get reset. However, we also reset the\n// bottom margin to use `rem` units instead of `em`.\np {\n  margin-top: 0;\n  margin-bottom: $paragraph-margin-bottom;\n}\n\n// Abbreviations\n//\n// 1. Duplicate behavior to the data-* attribute for our tooltip plugin\n// 2. Add the correct text decoration in Chrome, Edge, IE, Opera, and Safari.\n// 3. Add explicit cursor to indicate changed behavior.\n// 4. Remove the bottom border in Firefox 39-.\n// 5. Prevent the text-decoration to be skipped.\n\nabbr[title],\nabbr[data-original-title] { // 1\n  text-decoration: underline; // 2\n  text-decoration: underline dotted; // 2\n  cursor: help; // 3\n  border-bottom: 0; // 4\n  text-decoration-skip-ink: none; // 5\n}\n\naddress {\n  margin-bottom: 1rem;\n  font-style: normal;\n  line-height: inherit;\n}\n\nol,\nul,\ndl {\n  margin-top: 0;\n  margin-bottom: 1rem;\n}\n\nol ol,\nul ul,\nol ul,\nul ol {\n  margin-bottom: 0;\n}\n\ndt {\n  font-weight: $dt-font-weight;\n}\n\ndd {\n  margin-bottom: .5rem;\n  margin-left: 0; // Undo browser default\n}\n\nblockquote {\n  margin: 0 0 1rem;\n}\n\nb,\nstrong {\n  font-weight: $font-weight-bolder; // Add the correct font weight in Chrome, Edge, and Safari\n}\n\nsmall {\n  @include font-size(80%); // Add the correct font size in all browsers\n}\n\n//\n// Prevent `sub` and `sup` elements from affecting the line height in\n// all browsers.\n//\n\nsub,\nsup {\n  position: relative;\n  @include font-size(75%);\n  line-height: 0;\n  vertical-align: baseline;\n}\n\nsub { bottom: -.25em; }\nsup { top: -.5em; }\n\n\n//\n// Links\n//\n\na {\n  color: $link-color;\n  text-decoration: $link-decoration;\n  background-color: transparent; // Remove the gray background on active links in IE 10.\n\n  @include hover {\n    color: $link-hover-color;\n    text-decoration: $link-hover-decoration;\n  }\n}\n\n// And undo these styles for placeholder links/named anchors (without href)\n// which have not been made explicitly keyboard-focusable (without tabindex).\n// It would be more straightforward to just use a[href] in previous block, but that\n// causes specificity issues in many other styles that are too complex to fix.\n// See https://github.com/twbs/bootstrap/issues/19402\n\na:not([href]):not([tabindex]) {\n  color: inherit;\n  text-decoration: none;\n\n  @include hover-focus {\n    color: inherit;\n    text-decoration: none;\n  }\n\n  &:focus {\n    outline: 0;\n  }\n}\n\n\n//\n// Code\n//\n\npre,\ncode,\nkbd,\nsamp {\n  font-family: $font-family-monospace;\n  @include font-size(1em); // Correct the odd `em` font sizing in all browsers.\n}\n\npre {\n  // Remove browser default top margin\n  margin-top: 0;\n  // Reset browser default of `1em` to use `rem`s\n  margin-bottom: 1rem;\n  // Don't allow content to break outside\n  overflow: auto;\n}\n\n\n//\n// Figures\n//\n\nfigure {\n  // Apply a consistent margin strategy (matches our type styles).\n  margin: 0 0 1rem;\n}\n\n\n//\n// Images and content\n//\n\nimg {\n  vertical-align: middle;\n  border-style: none; // Remove the border on images inside links in IE 10-.\n}\n\nsvg {\n  // Workaround for the SVG overflow bug in IE10/11 is still required.\n  // See https://github.com/twbs/bootstrap/issues/26878\n  overflow: hidden;\n  vertical-align: middle;\n}\n\n\n//\n// Tables\n//\n\ntable {\n  border-collapse: collapse; // Prevent double borders\n}\n\ncaption {\n  padding-top: $table-cell-padding;\n  padding-bottom: $table-cell-padding;\n  color: $table-caption-color;\n  text-align: left;\n  caption-side: bottom;\n}\n\nth {\n  // Matches default `<td>` alignment by inheriting from the `<body>`, or the\n  // closest parent with a set `text-align`.\n  text-align: inherit;\n}\n\n\n//\n// Forms\n//\n\nlabel {\n  // Allow labels to use `margin` for spacing.\n  display: inline-block;\n  margin-bottom: $label-margin-bottom;\n}\n\n// Remove the default `border-radius` that macOS Chrome adds.\n//\n// Details at https://github.com/twbs/bootstrap/issues/24093\nbutton {\n  // stylelint-disable-next-line property-blacklist\n  border-radius: 0;\n}\n\n// Work around a Firefox/IE bug where the transparent `button` background\n// results in a loss of the default `button` focus styles.\n//\n// Credit: https://github.com/suitcss/base/\nbutton:focus {\n  outline: 1px dotted;\n  outline: 5px auto -webkit-focus-ring-color;\n}\n\ninput,\nbutton,\nselect,\noptgroup,\ntextarea {\n  margin: 0; // Remove the margin in Firefox and Safari\n  font-family: inherit;\n  @include font-size(inherit);\n  line-height: inherit;\n}\n\nbutton,\ninput {\n  overflow: visible; // Show the overflow in Edge\n}\n\nbutton,\nselect {\n  text-transform: none; // Remove the inheritance of text transform in Firefox\n}\n\n// Remove the inheritance of word-wrap in Safari.\n//\n// Details at https://github.com/twbs/bootstrap/issues/24990\nselect {\n  word-wrap: normal;\n}\n\n\n// 1. Prevent a WebKit bug where (2) destroys native `audio` and `video`\n//    controls in Android 4.\n// 2. Correct the inability to style clickable types in iOS and Safari.\nbutton,\n[type=\"button\"], // 1\n[type=\"reset\"],\n[type=\"submit\"] {\n  -webkit-appearance: button; // 2\n}\n\n// Opinionated: add \"hand\" cursor to non-disabled button elements.\n@if $enable-pointer-cursor-for-buttons {\n  button,\n  [type=\"button\"],\n  [type=\"reset\"],\n  [type=\"submit\"] {\n    &:not(:disabled) {\n      cursor: pointer;\n    }\n  }\n}\n\n// Remove inner border and padding from Firefox, but don't restore the outline like Normalize.\nbutton::-moz-focus-inner,\n[type=\"button\"]::-moz-focus-inner,\n[type=\"reset\"]::-moz-focus-inner,\n[type=\"submit\"]::-moz-focus-inner {\n  padding: 0;\n  border-style: none;\n}\n\ninput[type=\"radio\"],\ninput[type=\"checkbox\"] {\n  box-sizing: border-box; // 1. Add the correct box sizing in IE 10-\n  padding: 0; // 2. Remove the padding in IE 10-\n}\n\n\ninput[type=\"date\"],\ninput[type=\"time\"],\ninput[type=\"datetime-local\"],\ninput[type=\"month\"] {\n  // Remove the default appearance of temporal inputs to avoid a Mobile Safari\n  // bug where setting a custom line-height prevents text from being vertically\n  // centered within the input.\n  // See https://bugs.webkit.org/show_bug.cgi?id=139848\n  // and https://github.com/twbs/bootstrap/issues/11266\n  -webkit-appearance: listbox;\n}\n\ntextarea {\n  overflow: auto; // Remove the default vertical scrollbar in IE.\n  // Textareas should really only resize vertically so they don't break their (horizontal) containers.\n  resize: vertical;\n}\n\nfieldset {\n  // Browsers set a default `min-width: min-content;` on fieldsets,\n  // unlike e.g. `<div>`s, which have `min-width: 0;` by default.\n  // So we reset that to ensure fieldsets behave more like a standard block element.\n  // See https://github.com/twbs/bootstrap/issues/12359\n  // and https://html.spec.whatwg.org/multipage/#the-fieldset-and-legend-elements\n  min-width: 0;\n  // Reset the default outline behavior of fieldsets so they don't affect page layout.\n  padding: 0;\n  margin: 0;\n  border: 0;\n}\n\n// 1. Correct the text wrapping in Edge and IE.\n// 2. Correct the color inheritance from `fieldset` elements in IE.\nlegend {\n  display: block;\n  width: 100%;\n  max-width: 100%; // 1\n  padding: 0;\n  margin-bottom: .5rem;\n  @include font-size(1.5rem);\n  line-height: inherit;\n  color: inherit; // 2\n  white-space: normal; // 1\n}\n\nprogress {\n  vertical-align: baseline; // Add the correct vertical alignment in Chrome, Firefox, and Opera.\n}\n\n// Correct the cursor style of increment and decrement buttons in Chrome.\n[type=\"number\"]::-webkit-inner-spin-button,\n[type=\"number\"]::-webkit-outer-spin-button {\n  height: auto;\n}\n\n[type=\"search\"] {\n  // This overrides the extra rounded corners on search inputs in iOS so that our\n  // `.form-control` class can properly style them. Note that this cannot simply\n  // be added to `.form-control` as it's not specific enough. For details, see\n  // https://github.com/twbs/bootstrap/issues/11586.\n  outline-offset: -2px; // 2. Correct the outline style in Safari.\n  -webkit-appearance: none;\n}\n\n//\n// Remove the inner padding in Chrome and Safari on macOS.\n//\n\n[type=\"search\"]::-webkit-search-decoration {\n  -webkit-appearance: none;\n}\n\n//\n// 1. Correct the inability to style clickable types in iOS and Safari.\n// 2. Change font properties to `inherit` in Safari.\n//\n\n::-webkit-file-upload-button {\n  font: inherit; // 2\n  -webkit-appearance: button; // 1\n}\n\n//\n// Correct element displays\n//\n\noutput {\n  display: inline-block;\n}\n\nsummary {\n  display: list-item; // Add the correct display in all browsers\n  cursor: pointer;\n}\n\ntemplate {\n  display: none; // Add the correct display in IE\n}\n\n// Always hide an element with the `hidden` HTML attribute (from PureCSS).\n// Needed for proper display in IE 10-.\n[hidden] {\n  display: none !important;\n}\n","/*!\n * Bootstrap v4.3.1 (https://getbootstrap.com/)\n * Copyright 2011-2019 The Bootstrap Authors\n * Copyright 2011-2019 Twitter, Inc.\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)\n */\n:root {\n  --blue: #007bff;\n  --indigo: #6610f2;\n  --purple: #6f42c1;\n  --pink: #e83e8c;\n  --red: #dc3545;\n  --orange: #fd7e14;\n  --yellow: #ffc107;\n  --green: #28a745;\n  --teal: #20c997;\n  --cyan: #17a2b8;\n  --white: #fff;\n  --gray: #6c757d;\n  --gray-dark: #343a40;\n  --primary: #007bff;\n  --secondary: #6c757d;\n  --success: #28a745;\n  --info: #17a2b8;\n  --warning: #ffc107;\n  --danger: #dc3545;\n  --light: #f8f9fa;\n  --dark: #343a40;\n  --breakpoint-xs: 0;\n  --breakpoint-sm: 576px;\n  --breakpoint-md: 768px;\n  --breakpoint-lg: 992px;\n  --breakpoint-xl: 1200px;\n  --font-family-sans-serif: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, \"Noto Sans\", sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\", \"Noto Color Emoji\";\n  --font-family-monospace: SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\", \"Courier New\", monospace;\n}\n\n*,\n*::before,\n*::after {\n  box-sizing: border-box;\n}\n\nhtml {\n  font-family: sans-serif;\n  line-height: 1.15;\n  -webkit-text-size-adjust: 100%;\n  -webkit-tap-highlight-color: rgba(0, 0, 0, 0);\n}\n\narticle, aside, figcaption, figure, footer, header, hgroup, main, nav, section {\n  display: block;\n}\n\nbody {\n  margin: 0;\n  font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, \"Noto Sans\", sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\", \"Noto Color Emoji\";\n  font-size: 1rem;\n  font-weight: 400;\n  line-height: 1.5;\n  color: #212529;\n  text-align: left;\n  background-color: #fff;\n}\n\n[tabindex=\"-1\"]:focus {\n  outline: 0 !important;\n}\n\nhr {\n  box-sizing: content-box;\n  height: 0;\n  overflow: visible;\n}\n\nh1, h2, h3, h4, h5, h6 {\n  margin-top: 0;\n  margin-bottom: 0.5rem;\n}\n\np {\n  margin-top: 0;\n  margin-bottom: 1rem;\n}\n\nabbr[title],\nabbr[data-original-title] {\n  text-decoration: underline;\n  -webkit-text-decoration: underline dotted;\n  text-decoration: underline dotted;\n  cursor: help;\n  border-bottom: 0;\n  -webkit-text-decoration-skip-ink: none;\n  text-decoration-skip-ink: none;\n}\n\naddress {\n  margin-bottom: 1rem;\n  font-style: normal;\n  line-height: inherit;\n}\n\nol,\nul,\ndl {\n  margin-top: 0;\n  margin-bottom: 1rem;\n}\n\nol ol,\nul ul,\nol ul,\nul ol {\n  margin-bottom: 0;\n}\n\ndt {\n  font-weight: 700;\n}\n\ndd {\n  margin-bottom: .5rem;\n  margin-left: 0;\n}\n\nblockquote {\n  margin: 0 0 1rem;\n}\n\nb,\nstrong {\n  font-weight: bolder;\n}\n\nsmall {\n  font-size: 80%;\n}\n\nsub,\nsup {\n  position: relative;\n  font-size: 75%;\n  line-height: 0;\n  vertical-align: baseline;\n}\n\nsub {\n  bottom: -.25em;\n}\n\nsup {\n  top: -.5em;\n}\n\na {\n  color: #007bff;\n  text-decoration: none;\n  background-color: transparent;\n}\n\na:hover {\n  color: #0056b3;\n  text-decoration: underline;\n}\n\na:not([href]):not([tabindex]) {\n  color: inherit;\n  text-decoration: none;\n}\n\na:not([href]):not([tabindex]):hover, a:not([href]):not([tabindex]):focus {\n  color: inherit;\n  text-decoration: none;\n}\n\na:not([href]):not([tabindex]):focus {\n  outline: 0;\n}\n\npre,\ncode,\nkbd,\nsamp {\n  font-family: SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\", \"Courier New\", monospace;\n  font-size: 1em;\n}\n\npre {\n  margin-top: 0;\n  margin-bottom: 1rem;\n  overflow: auto;\n}\n\nfigure {\n  margin: 0 0 1rem;\n}\n\nimg {\n  vertical-align: middle;\n  border-style: none;\n}\n\nsvg {\n  overflow: hidden;\n  vertical-align: middle;\n}\n\ntable {\n  border-collapse: collapse;\n}\n\ncaption {\n  padding-top: 0.75rem;\n  padding-bottom: 0.75rem;\n  color: #6c757d;\n  text-align: left;\n  caption-side: bottom;\n}\n\nth {\n  text-align: inherit;\n}\n\nlabel {\n  display: inline-block;\n  margin-bottom: 0.5rem;\n}\n\nbutton {\n  border-radius: 0;\n}\n\nbutton:focus {\n  outline: 1px dotted;\n  outline: 5px auto -webkit-focus-ring-color;\n}\n\ninput,\nbutton,\nselect,\noptgroup,\ntextarea {\n  margin: 0;\n  font-family: inherit;\n  font-size: inherit;\n  line-height: inherit;\n}\n\nbutton,\ninput {\n  overflow: visible;\n}\n\nbutton,\nselect {\n  text-transform: none;\n}\n\nselect {\n  word-wrap: normal;\n}\n\nbutton,\n[type=\"button\"],\n[type=\"reset\"],\n[type=\"submit\"] {\n  -webkit-appearance: button;\n}\n\nbutton:not(:disabled),\n[type=\"button\"]:not(:disabled),\n[type=\"reset\"]:not(:disabled),\n[type=\"submit\"]:not(:disabled) {\n  cursor: pointer;\n}\n\nbutton::-moz-focus-inner,\n[type=\"button\"]::-moz-focus-inner,\n[type=\"reset\"]::-moz-focus-inner,\n[type=\"submit\"]::-moz-focus-inner {\n  padding: 0;\n  border-style: none;\n}\n\ninput[type=\"radio\"],\ninput[type=\"checkbox\"] {\n  box-sizing: border-box;\n  padding: 0;\n}\n\ninput[type=\"date\"],\ninput[type=\"time\"],\ninput[type=\"datetime-local\"],\ninput[type=\"month\"] {\n  -webkit-appearance: listbox;\n}\n\ntextarea {\n  overflow: auto;\n  resize: vertical;\n}\n\nfieldset {\n  min-width: 0;\n  padding: 0;\n  margin: 0;\n  border: 0;\n}\n\nlegend {\n  display: block;\n  width: 100%;\n  max-width: 100%;\n  padding: 0;\n  margin-bottom: .5rem;\n  font-size: 1.5rem;\n  line-height: inherit;\n  color: inherit;\n  white-space: normal;\n}\n\nprogress {\n  vertical-align: baseline;\n}\n\n[type=\"number\"]::-webkit-inner-spin-button,\n[type=\"number\"]::-webkit-outer-spin-button {\n  height: auto;\n}\n\n[type=\"search\"] {\n  outline-offset: -2px;\n  -webkit-appearance: none;\n}\n\n[type=\"search\"]::-webkit-search-decoration {\n  -webkit-appearance: none;\n}\n\n::-webkit-file-upload-button {\n  font: inherit;\n  -webkit-appearance: button;\n}\n\noutput {\n  display: inline-block;\n}\n\nsummary {\n  display: list-item;\n  cursor: pointer;\n}\n\ntemplate {\n  display: none;\n}\n\n[hidden] {\n  display: none !important;\n}\n\nh1, h2, h3, h4, h5, h6,\n.h1, .h2, .h3, .h4, .h5, .h6 {\n  margin-bottom: 0.5rem;\n  font-weight: 500;\n  line-height: 1.2;\n}\n\nh1, .h1 {\n  font-size: 2.5rem;\n}\n\nh2, .h2 {\n  font-size: 2rem;\n}\n\nh3, .h3 {\n  font-size: 1.75rem;\n}\n\nh4, .h4 {\n  font-size: 1.5rem;\n}\n\nh5, .h5 {\n  font-size: 1.25rem;\n}\n\nh6, .h6 {\n  font-size: 1rem;\n}\n\n.lead {\n  font-size: 1.25rem;\n  font-weight: 300;\n}\n\n.display-1 {\n  font-size: 6rem;\n  font-weight: 300;\n  line-height: 1.2;\n}\n\n.display-2 {\n  font-size: 5.5rem;\n  font-weight: 300;\n  line-height: 1.2;\n}\n\n.display-3 {\n  font-size: 4.5rem;\n  font-weight: 300;\n  line-height: 1.2;\n}\n\n.display-4 {\n  font-size: 3.5rem;\n  font-weight: 300;\n  line-height: 1.2;\n}\n\nhr {\n  margin-top: 1rem;\n  margin-bottom: 1rem;\n  border: 0;\n  border-top: 1px solid rgba(0, 0, 0, 0.1);\n}\n\nsmall,\n.small {\n  font-size: 80%;\n  font-weight: 400;\n}\n\nmark,\n.mark {\n  padding: 0.2em;\n  background-color: #fcf8e3;\n}\n\n.list-unstyled {\n  padding-left: 0;\n  list-style: none;\n}\n\n.list-inline {\n  padding-left: 0;\n  list-style: none;\n}\n\n.list-inline-item {\n  display: inline-block;\n}\n\n.list-inline-item:not(:last-child) {\n  margin-right: 0.5rem;\n}\n\n.initialism {\n  font-size: 90%;\n  text-transform: uppercase;\n}\n\n.blockquote {\n  margin-bottom: 1rem;\n  font-size: 1.25rem;\n}\n\n.blockquote-footer {\n  display: block;\n  font-size: 80%;\n  color: #6c757d;\n}\n\n.blockquote-footer::before {\n  content: \"\\2014\\00A0\";\n}\n\n.img-fluid {\n  max-width: 100%;\n  height: auto;\n}\n\n.img-thumbnail {\n  padding: 0.25rem;\n  background-color: #fff;\n  border: 1px solid #dee2e6;\n  border-radius: 0.25rem;\n  max-width: 100%;\n  height: auto;\n}\n\n.figure {\n  display: inline-block;\n}\n\n.figure-img {\n  margin-bottom: 0.5rem;\n  line-height: 1;\n}\n\n.figure-caption {\n  font-size: 90%;\n  color: #6c757d;\n}\n\ncode {\n  font-size: 87.5%;\n  color: #e83e8c;\n  word-break: break-word;\n}\n\na > code {\n  color: inherit;\n}\n\nkbd {\n  padding: 0.2rem 0.4rem;\n  font-size: 87.5%;\n  color: #fff;\n  background-color: #212529;\n  border-radius: 0.2rem;\n}\n\nkbd kbd {\n  padding: 0;\n  font-size: 100%;\n  font-weight: 700;\n}\n\npre {\n  display: block;\n  font-size: 87.5%;\n  color: #212529;\n}\n\npre code {\n  font-size: inherit;\n  color: inherit;\n  word-break: normal;\n}\n\n.pre-scrollable {\n  max-height: 340px;\n  overflow-y: scroll;\n}\n\n.container {\n  width: 100%;\n  padding-right: 15px;\n  padding-left: 15px;\n  margin-right: auto;\n  margin-left: auto;\n}\n\n@media (min-width: 576px) {\n  .container {\n    max-width: 540px;\n  }\n}\n\n@media (min-width: 768px) {\n  .container {\n    max-width: 720px;\n  }\n}\n\n@media (min-width: 992px) {\n  .container {\n    max-width: 960px;\n  }\n}\n\n@media (min-width: 1200px) {\n  .container {\n    max-width: 1140px;\n  }\n}\n\n.container-fluid {\n  width: 100%;\n  padding-right: 15px;\n  padding-left: 15px;\n  margin-right: auto;\n  margin-left: auto;\n}\n\n.row {\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-wrap: wrap;\n  flex-wrap: wrap;\n  margin-right: -15px;\n  margin-left: -15px;\n}\n\n.no-gutters {\n  margin-right: 0;\n  margin-left: 0;\n}\n\n.no-gutters > .col,\n.no-gutters > [class*=\"col-\"] {\n  padding-right: 0;\n  padding-left: 0;\n}\n\n.col-1, .col-2, .col-3, .col-4, .col-5, .col-6, .col-7, .col-8, .col-9, .col-10, .col-11, .col-12, .col,\n.col-auto, .col-sm-1, .col-sm-2, .col-sm-3, .col-sm-4, .col-sm-5, .col-sm-6, .col-sm-7, .col-sm-8, .col-sm-9, .col-sm-10, .col-sm-11, .col-sm-12, .col-sm,\n.col-sm-auto, .col-md-1, .col-md-2, .col-md-3, .col-md-4, .col-md-5, .col-md-6, .col-md-7, .col-md-8, .col-md-9, .col-md-10, .col-md-11, .col-md-12, .col-md,\n.col-md-auto, .col-lg-1, .col-lg-2, .col-lg-3, .col-lg-4, .col-lg-5, .col-lg-6, .col-lg-7, .col-lg-8, .col-lg-9, .col-lg-10, .col-lg-11, .col-lg-12, .col-lg,\n.col-lg-auto, .col-xl-1, .col-xl-2, .col-xl-3, .col-xl-4, .col-xl-5, .col-xl-6, .col-xl-7, .col-xl-8, .col-xl-9, .col-xl-10, .col-xl-11, .col-xl-12, .col-xl,\n.col-xl-auto {\n  position: relative;\n  width: 100%;\n  padding-right: 15px;\n  padding-left: 15px;\n}\n\n.col {\n  -ms-flex-preferred-size: 0;\n  flex-basis: 0;\n  -ms-flex-positive: 1;\n  flex-grow: 1;\n  max-width: 100%;\n}\n\n.col-auto {\n  -ms-flex: 0 0 auto;\n  flex: 0 0 auto;\n  width: auto;\n  max-width: 100%;\n}\n\n.col-1 {\n  -ms-flex: 0 0 8.333333%;\n  flex: 0 0 8.333333%;\n  max-width: 8.333333%;\n}\n\n.col-2 {\n  -ms-flex: 0 0 16.666667%;\n  flex: 0 0 16.666667%;\n  max-width: 16.666667%;\n}\n\n.col-3 {\n  -ms-flex: 0 0 25%;\n  flex: 0 0 25%;\n  max-width: 25%;\n}\n\n.col-4 {\n  -ms-flex: 0 0 33.333333%;\n  flex: 0 0 33.333333%;\n  max-width: 33.333333%;\n}\n\n.col-5 {\n  -ms-flex: 0 0 41.666667%;\n  flex: 0 0 41.666667%;\n  max-width: 41.666667%;\n}\n\n.col-6 {\n  -ms-flex: 0 0 50%;\n  flex: 0 0 50%;\n  max-width: 50%;\n}\n\n.col-7 {\n  -ms-flex: 0 0 58.333333%;\n  flex: 0 0 58.333333%;\n  max-width: 58.333333%;\n}\n\n.col-8 {\n  -ms-flex: 0 0 66.666667%;\n  flex: 0 0 66.666667%;\n  max-width: 66.666667%;\n}\n\n.col-9 {\n  -ms-flex: 0 0 75%;\n  flex: 0 0 75%;\n  max-width: 75%;\n}\n\n.col-10 {\n  -ms-flex: 0 0 83.333333%;\n  flex: 0 0 83.333333%;\n  max-width: 83.333333%;\n}\n\n.col-11 {\n  -ms-flex: 0 0 91.666667%;\n  flex: 0 0 91.666667%;\n  max-width: 91.666667%;\n}\n\n.col-12 {\n  -ms-flex: 0 0 100%;\n  flex: 0 0 100%;\n  max-width: 100%;\n}\n\n.order-first {\n  -ms-flex-order: -1;\n  order: -1;\n}\n\n.order-last {\n  -ms-flex-order: 13;\n  order: 13;\n}\n\n.order-0 {\n  -ms-flex-order: 0;\n  order: 0;\n}\n\n.order-1 {\n  -ms-flex-order: 1;\n  order: 1;\n}\n\n.order-2 {\n  -ms-flex-order: 2;\n  order: 2;\n}\n\n.order-3 {\n  -ms-flex-order: 3;\n  order: 3;\n}\n\n.order-4 {\n  -ms-flex-order: 4;\n  order: 4;\n}\n\n.order-5 {\n  -ms-flex-order: 5;\n  order: 5;\n}\n\n.order-6 {\n  -ms-flex-order: 6;\n  order: 6;\n}\n\n.order-7 {\n  -ms-flex-order: 7;\n  order: 7;\n}\n\n.order-8 {\n  -ms-flex-order: 8;\n  order: 8;\n}\n\n.order-9 {\n  -ms-flex-order: 9;\n  order: 9;\n}\n\n.order-10 {\n  -ms-flex-order: 10;\n  order: 10;\n}\n\n.order-11 {\n  -ms-flex-order: 11;\n  order: 11;\n}\n\n.order-12 {\n  -ms-flex-order: 12;\n  order: 12;\n}\n\n.offset-1 {\n  margin-left: 8.333333%;\n}\n\n.offset-2 {\n  margin-left: 16.666667%;\n}\n\n.offset-3 {\n  margin-left: 25%;\n}\n\n.offset-4 {\n  margin-left: 33.333333%;\n}\n\n.offset-5 {\n  margin-left: 41.666667%;\n}\n\n.offset-6 {\n  margin-left: 50%;\n}\n\n.offset-7 {\n  margin-left: 58.333333%;\n}\n\n.offset-8 {\n  margin-left: 66.666667%;\n}\n\n.offset-9 {\n  margin-left: 75%;\n}\n\n.offset-10 {\n  margin-left: 83.333333%;\n}\n\n.offset-11 {\n  margin-left: 91.666667%;\n}\n\n@media (min-width: 576px) {\n  .col-sm {\n    -ms-flex-preferred-size: 0;\n    flex-basis: 0;\n    -ms-flex-positive: 1;\n    flex-grow: 1;\n    max-width: 100%;\n  }\n  .col-sm-auto {\n    -ms-flex: 0 0 auto;\n    flex: 0 0 auto;\n    width: auto;\n    max-width: 100%;\n  }\n  .col-sm-1 {\n    -ms-flex: 0 0 8.333333%;\n    flex: 0 0 8.333333%;\n    max-width: 8.333333%;\n  }\n  .col-sm-2 {\n    -ms-flex: 0 0 16.666667%;\n    flex: 0 0 16.666667%;\n    max-width: 16.666667%;\n  }\n  .col-sm-3 {\n    -ms-flex: 0 0 25%;\n    flex: 0 0 25%;\n    max-width: 25%;\n  }\n  .col-sm-4 {\n    -ms-flex: 0 0 33.333333%;\n    flex: 0 0 33.333333%;\n    max-width: 33.333333%;\n  }\n  .col-sm-5 {\n    -ms-flex: 0 0 41.666667%;\n    flex: 0 0 41.666667%;\n    max-width: 41.666667%;\n  }\n  .col-sm-6 {\n    -ms-flex: 0 0 50%;\n    flex: 0 0 50%;\n    max-width: 50%;\n  }\n  .col-sm-7 {\n    -ms-flex: 0 0 58.333333%;\n    flex: 0 0 58.333333%;\n    max-width: 58.333333%;\n  }\n  .col-sm-8 {\n    -ms-flex: 0 0 66.666667%;\n    flex: 0 0 66.666667%;\n    max-width: 66.666667%;\n  }\n  .col-sm-9 {\n    -ms-flex: 0 0 75%;\n    flex: 0 0 75%;\n    max-width: 75%;\n  }\n  .col-sm-10 {\n    -ms-flex: 0 0 83.333333%;\n    flex: 0 0 83.333333%;\n    max-width: 83.333333%;\n  }\n  .col-sm-11 {\n    -ms-flex: 0 0 91.666667%;\n    flex: 0 0 91.666667%;\n    max-width: 91.666667%;\n  }\n  .col-sm-12 {\n    -ms-flex: 0 0 100%;\n    flex: 0 0 100%;\n    max-width: 100%;\n  }\n  .order-sm-first {\n    -ms-flex-order: -1;\n    order: -1;\n  }\n  .order-sm-last {\n    -ms-flex-order: 13;\n    order: 13;\n  }\n  .order-sm-0 {\n    -ms-flex-order: 0;\n    order: 0;\n  }\n  .order-sm-1 {\n    -ms-flex-order: 1;\n    order: 1;\n  }\n  .order-sm-2 {\n    -ms-flex-order: 2;\n    order: 2;\n  }\n  .order-sm-3 {\n    -ms-flex-order: 3;\n    order: 3;\n  }\n  .order-sm-4 {\n    -ms-flex-order: 4;\n    order: 4;\n  }\n  .order-sm-5 {\n    -ms-flex-order: 5;\n    order: 5;\n  }\n  .order-sm-6 {\n    -ms-flex-order: 6;\n    order: 6;\n  }\n  .order-sm-7 {\n    -ms-flex-order: 7;\n    order: 7;\n  }\n  .order-sm-8 {\n    -ms-flex-order: 8;\n    order: 8;\n  }\n  .order-sm-9 {\n    -ms-flex-order: 9;\n    order: 9;\n  }\n  .order-sm-10 {\n    -ms-flex-order: 10;\n    order: 10;\n  }\n  .order-sm-11 {\n    -ms-flex-order: 11;\n    order: 11;\n  }\n  .order-sm-12 {\n    -ms-flex-order: 12;\n    order: 12;\n  }\n  .offset-sm-0 {\n    margin-left: 0;\n  }\n  .offset-sm-1 {\n    margin-left: 8.333333%;\n  }\n  .offset-sm-2 {\n    margin-left: 16.666667%;\n  }\n  .offset-sm-3 {\n    margin-left: 25%;\n  }\n  .offset-sm-4 {\n    margin-left: 33.333333%;\n  }\n  .offset-sm-5 {\n    margin-left: 41.666667%;\n  }\n  .offset-sm-6 {\n    margin-left: 50%;\n  }\n  .offset-sm-7 {\n    margin-left: 58.333333%;\n  }\n  .offset-sm-8 {\n    margin-left: 66.666667%;\n  }\n  .offset-sm-9 {\n    margin-left: 75%;\n  }\n  .offset-sm-10 {\n    margin-left: 83.333333%;\n  }\n  .offset-sm-11 {\n    margin-left: 91.666667%;\n  }\n}\n\n@media (min-width: 768px) {\n  .col-md {\n    -ms-flex-preferred-size: 0;\n    flex-basis: 0;\n    -ms-flex-positive: 1;\n    flex-grow: 1;\n    max-width: 100%;\n  }\n  .col-md-auto {\n    -ms-flex: 0 0 auto;\n    flex: 0 0 auto;\n    width: auto;\n    max-width: 100%;\n  }\n  .col-md-1 {\n    -ms-flex: 0 0 8.333333%;\n    flex: 0 0 8.333333%;\n    max-width: 8.333333%;\n  }\n  .col-md-2 {\n    -ms-flex: 0 0 16.666667%;\n    flex: 0 0 16.666667%;\n    max-width: 16.666667%;\n  }\n  .col-md-3 {\n    -ms-flex: 0 0 25%;\n    flex: 0 0 25%;\n    max-width: 25%;\n  }\n  .col-md-4 {\n    -ms-flex: 0 0 33.333333%;\n    flex: 0 0 33.333333%;\n    max-width: 33.333333%;\n  }\n  .col-md-5 {\n    -ms-flex: 0 0 41.666667%;\n    flex: 0 0 41.666667%;\n    max-width: 41.666667%;\n  }\n  .col-md-6 {\n    -ms-flex: 0 0 50%;\n    flex: 0 0 50%;\n    max-width: 50%;\n  }\n  .col-md-7 {\n    -ms-flex: 0 0 58.333333%;\n    flex: 0 0 58.333333%;\n    max-width: 58.333333%;\n  }\n  .col-md-8 {\n    -ms-flex: 0 0 66.666667%;\n    flex: 0 0 66.666667%;\n    max-width: 66.666667%;\n  }\n  .col-md-9 {\n    -ms-flex: 0 0 75%;\n    flex: 0 0 75%;\n    max-width: 75%;\n  }\n  .col-md-10 {\n    -ms-flex: 0 0 83.333333%;\n    flex: 0 0 83.333333%;\n    max-width: 83.333333%;\n  }\n  .col-md-11 {\n    -ms-flex: 0 0 91.666667%;\n    flex: 0 0 91.666667%;\n    max-width: 91.666667%;\n  }\n  .col-md-12 {\n    -ms-flex: 0 0 100%;\n    flex: 0 0 100%;\n    max-width: 100%;\n  }\n  .order-md-first {\n    -ms-flex-order: -1;\n    order: -1;\n  }\n  .order-md-last {\n    -ms-flex-order: 13;\n    order: 13;\n  }\n  .order-md-0 {\n    -ms-flex-order: 0;\n    order: 0;\n  }\n  .order-md-1 {\n    -ms-flex-order: 1;\n    order: 1;\n  }\n  .order-md-2 {\n    -ms-flex-order: 2;\n    order: 2;\n  }\n  .order-md-3 {\n    -ms-flex-order: 3;\n    order: 3;\n  }\n  .order-md-4 {\n    -ms-flex-order: 4;\n    order: 4;\n  }\n  .order-md-5 {\n    -ms-flex-order: 5;\n    order: 5;\n  }\n  .order-md-6 {\n    -ms-flex-order: 6;\n    order: 6;\n  }\n  .order-md-7 {\n    -ms-flex-order: 7;\n    order: 7;\n  }\n  .order-md-8 {\n    -ms-flex-order: 8;\n    order: 8;\n  }\n  .order-md-9 {\n    -ms-flex-order: 9;\n    order: 9;\n  }\n  .order-md-10 {\n    -ms-flex-order: 10;\n    order: 10;\n  }\n  .order-md-11 {\n    -ms-flex-order: 11;\n    order: 11;\n  }\n  .order-md-12 {\n    -ms-flex-order: 12;\n    order: 12;\n  }\n  .offset-md-0 {\n    margin-left: 0;\n  }\n  .offset-md-1 {\n    margin-left: 8.333333%;\n  }\n  .offset-md-2 {\n    margin-left: 16.666667%;\n  }\n  .offset-md-3 {\n    margin-left: 25%;\n  }\n  .offset-md-4 {\n    margin-left: 33.333333%;\n  }\n  .offset-md-5 {\n    margin-left: 41.666667%;\n  }\n  .offset-md-6 {\n    margin-left: 50%;\n  }\n  .offset-md-7 {\n    margin-left: 58.333333%;\n  }\n  .offset-md-8 {\n    margin-left: 66.666667%;\n  }\n  .offset-md-9 {\n    margin-left: 75%;\n  }\n  .offset-md-10 {\n    margin-left: 83.333333%;\n  }\n  .offset-md-11 {\n    margin-left: 91.666667%;\n  }\n}\n\n@media (min-width: 992px) {\n  .col-lg {\n    -ms-flex-preferred-size: 0;\n    flex-basis: 0;\n    -ms-flex-positive: 1;\n    flex-grow: 1;\n    max-width: 100%;\n  }\n  .col-lg-auto {\n    -ms-flex: 0 0 auto;\n    flex: 0 0 auto;\n    width: auto;\n    max-width: 100%;\n  }\n  .col-lg-1 {\n    -ms-flex: 0 0 8.333333%;\n    flex: 0 0 8.333333%;\n    max-width: 8.333333%;\n  }\n  .col-lg-2 {\n    -ms-flex: 0 0 16.666667%;\n    flex: 0 0 16.666667%;\n    max-width: 16.666667%;\n  }\n  .col-lg-3 {\n    -ms-flex: 0 0 25%;\n    flex: 0 0 25%;\n    max-width: 25%;\n  }\n  .col-lg-4 {\n    -ms-flex: 0 0 33.333333%;\n    flex: 0 0 33.333333%;\n    max-width: 33.333333%;\n  }\n  .col-lg-5 {\n    -ms-flex: 0 0 41.666667%;\n    flex: 0 0 41.666667%;\n    max-width: 41.666667%;\n  }\n  .col-lg-6 {\n    -ms-flex: 0 0 50%;\n    flex: 0 0 50%;\n    max-width: 50%;\n  }\n  .col-lg-7 {\n    -ms-flex: 0 0 58.333333%;\n    flex: 0 0 58.333333%;\n    max-width: 58.333333%;\n  }\n  .col-lg-8 {\n    -ms-flex: 0 0 66.666667%;\n    flex: 0 0 66.666667%;\n    max-width: 66.666667%;\n  }\n  .col-lg-9 {\n    -ms-flex: 0 0 75%;\n    flex: 0 0 75%;\n    max-width: 75%;\n  }\n  .col-lg-10 {\n    -ms-flex: 0 0 83.333333%;\n    flex: 0 0 83.333333%;\n    max-width: 83.333333%;\n  }\n  .col-lg-11 {\n    -ms-flex: 0 0 91.666667%;\n    flex: 0 0 91.666667%;\n    max-width: 91.666667%;\n  }\n  .col-lg-12 {\n    -ms-flex: 0 0 100%;\n    flex: 0 0 100%;\n    max-width: 100%;\n  }\n  .order-lg-first {\n    -ms-flex-order: -1;\n    order: -1;\n  }\n  .order-lg-last {\n    -ms-flex-order: 13;\n    order: 13;\n  }\n  .order-lg-0 {\n    -ms-flex-order: 0;\n    order: 0;\n  }\n  .order-lg-1 {\n    -ms-flex-order: 1;\n    order: 1;\n  }\n  .order-lg-2 {\n    -ms-flex-order: 2;\n    order: 2;\n  }\n  .order-lg-3 {\n    -ms-flex-order: 3;\n    order: 3;\n  }\n  .order-lg-4 {\n    -ms-flex-order: 4;\n    order: 4;\n  }\n  .order-lg-5 {\n    -ms-flex-order: 5;\n    order: 5;\n  }\n  .order-lg-6 {\n    -ms-flex-order: 6;\n    order: 6;\n  }\n  .order-lg-7 {\n    -ms-flex-order: 7;\n    order: 7;\n  }\n  .order-lg-8 {\n    -ms-flex-order: 8;\n    order: 8;\n  }\n  .order-lg-9 {\n    -ms-flex-order: 9;\n    order: 9;\n  }\n  .order-lg-10 {\n    -ms-flex-order: 10;\n    order: 10;\n  }\n  .order-lg-11 {\n    -ms-flex-order: 11;\n    order: 11;\n  }\n  .order-lg-12 {\n    -ms-flex-order: 12;\n    order: 12;\n  }\n  .offset-lg-0 {\n    margin-left: 0;\n  }\n  .offset-lg-1 {\n    margin-left: 8.333333%;\n  }\n  .offset-lg-2 {\n    margin-left: 16.666667%;\n  }\n  .offset-lg-3 {\n    margin-left: 25%;\n  }\n  .offset-lg-4 {\n    margin-left: 33.333333%;\n  }\n  .offset-lg-5 {\n    margin-left: 41.666667%;\n  }\n  .offset-lg-6 {\n    margin-left: 50%;\n  }\n  .offset-lg-7 {\n    margin-left: 58.333333%;\n  }\n  .offset-lg-8 {\n    margin-left: 66.666667%;\n  }\n  .offset-lg-9 {\n    margin-left: 75%;\n  }\n  .offset-lg-10 {\n    margin-left: 83.333333%;\n  }\n  .offset-lg-11 {\n    margin-left: 91.666667%;\n  }\n}\n\n@media (min-width: 1200px) {\n  .col-xl {\n    -ms-flex-preferred-size: 0;\n    flex-basis: 0;\n    -ms-flex-positive: 1;\n    flex-grow: 1;\n    max-width: 100%;\n  }\n  .col-xl-auto {\n    -ms-flex: 0 0 auto;\n    flex: 0 0 auto;\n    width: auto;\n    max-width: 100%;\n  }\n  .col-xl-1 {\n    -ms-flex: 0 0 8.333333%;\n    flex: 0 0 8.333333%;\n    max-width: 8.333333%;\n  }\n  .col-xl-2 {\n    -ms-flex: 0 0 16.666667%;\n    flex: 0 0 16.666667%;\n    max-width: 16.666667%;\n  }\n  .col-xl-3 {\n    -ms-flex: 0 0 25%;\n    flex: 0 0 25%;\n    max-width: 25%;\n  }\n  .col-xl-4 {\n    -ms-flex: 0 0 33.333333%;\n    flex: 0 0 33.333333%;\n    max-width: 33.333333%;\n  }\n  .col-xl-5 {\n    -ms-flex: 0 0 41.666667%;\n    flex: 0 0 41.666667%;\n    max-width: 41.666667%;\n  }\n  .col-xl-6 {\n    -ms-flex: 0 0 50%;\n    flex: 0 0 50%;\n    max-width: 50%;\n  }\n  .col-xl-7 {\n    -ms-flex: 0 0 58.333333%;\n    flex: 0 0 58.333333%;\n    max-width: 58.333333%;\n  }\n  .col-xl-8 {\n    -ms-flex: 0 0 66.666667%;\n    flex: 0 0 66.666667%;\n    max-width: 66.666667%;\n  }\n  .col-xl-9 {\n    -ms-flex: 0 0 75%;\n    flex: 0 0 75%;\n    max-width: 75%;\n  }\n  .col-xl-10 {\n    -ms-flex: 0 0 83.333333%;\n    flex: 0 0 83.333333%;\n    max-width: 83.333333%;\n  }\n  .col-xl-11 {\n    -ms-flex: 0 0 91.666667%;\n    flex: 0 0 91.666667%;\n    max-width: 91.666667%;\n  }\n  .col-xl-12 {\n    -ms-flex: 0 0 100%;\n    flex: 0 0 100%;\n    max-width: 100%;\n  }\n  .order-xl-first {\n    -ms-flex-order: -1;\n    order: -1;\n  }\n  .order-xl-last {\n    -ms-flex-order: 13;\n    order: 13;\n  }\n  .order-xl-0 {\n    -ms-flex-order: 0;\n    order: 0;\n  }\n  .order-xl-1 {\n    -ms-flex-order: 1;\n    order: 1;\n  }\n  .order-xl-2 {\n    -ms-flex-order: 2;\n    order: 2;\n  }\n  .order-xl-3 {\n    -ms-flex-order: 3;\n    order: 3;\n  }\n  .order-xl-4 {\n    -ms-flex-order: 4;\n    order: 4;\n  }\n  .order-xl-5 {\n    -ms-flex-order: 5;\n    order: 5;\n  }\n  .order-xl-6 {\n    -ms-flex-order: 6;\n    order: 6;\n  }\n  .order-xl-7 {\n    -ms-flex-order: 7;\n    order: 7;\n  }\n  .order-xl-8 {\n    -ms-flex-order: 8;\n    order: 8;\n  }\n  .order-xl-9 {\n    -ms-flex-order: 9;\n    order: 9;\n  }\n  .order-xl-10 {\n    -ms-flex-order: 10;\n    order: 10;\n  }\n  .order-xl-11 {\n    -ms-flex-order: 11;\n    order: 11;\n  }\n  .order-xl-12 {\n    -ms-flex-order: 12;\n    order: 12;\n  }\n  .offset-xl-0 {\n    margin-left: 0;\n  }\n  .offset-xl-1 {\n    margin-left: 8.333333%;\n  }\n  .offset-xl-2 {\n    margin-left: 16.666667%;\n  }\n  .offset-xl-3 {\n    margin-left: 25%;\n  }\n  .offset-xl-4 {\n    margin-left: 33.333333%;\n  }\n  .offset-xl-5 {\n    margin-left: 41.666667%;\n  }\n  .offset-xl-6 {\n    margin-left: 50%;\n  }\n  .offset-xl-7 {\n    margin-left: 58.333333%;\n  }\n  .offset-xl-8 {\n    margin-left: 66.666667%;\n  }\n  .offset-xl-9 {\n    margin-left: 75%;\n  }\n  .offset-xl-10 {\n    margin-left: 83.333333%;\n  }\n  .offset-xl-11 {\n    margin-left: 91.666667%;\n  }\n}\n\n.table {\n  width: 100%;\n  margin-bottom: 1rem;\n  color: #212529;\n}\n\n.table th,\n.table td {\n  padding: 0.75rem;\n  vertical-align: top;\n  border-top: 1px solid #dee2e6;\n}\n\n.table thead th {\n  vertical-align: bottom;\n  border-bottom: 2px solid #dee2e6;\n}\n\n.table tbody + tbody {\n  border-top: 2px solid #dee2e6;\n}\n\n.table-sm th,\n.table-sm td {\n  padding: 0.3rem;\n}\n\n.table-bordered {\n  border: 1px solid #dee2e6;\n}\n\n.table-bordered th,\n.table-bordered td {\n  border: 1px solid #dee2e6;\n}\n\n.table-bordered thead th,\n.table-bordered thead td {\n  border-bottom-width: 2px;\n}\n\n.table-borderless th,\n.table-borderless td,\n.table-borderless thead th,\n.table-borderless tbody + tbody {\n  border: 0;\n}\n\n.table-striped tbody tr:nth-of-type(odd) {\n  background-color: rgba(0, 0, 0, 0.05);\n}\n\n.table-hover tbody tr:hover {\n  color: #212529;\n  background-color: rgba(0, 0, 0, 0.075);\n}\n\n.table-primary,\n.table-primary > th,\n.table-primary > td {\n  background-color: #b8daff;\n}\n\n.table-primary th,\n.table-primary td,\n.table-primary thead th,\n.table-primary tbody + tbody {\n  border-color: #7abaff;\n}\n\n.table-hover .table-primary:hover {\n  background-color: #9fcdff;\n}\n\n.table-hover .table-primary:hover > td,\n.table-hover .table-primary:hover > th {\n  background-color: #9fcdff;\n}\n\n.table-secondary,\n.table-secondary > th,\n.table-secondary > td {\n  background-color: #d6d8db;\n}\n\n.table-secondary th,\n.table-secondary td,\n.table-secondary thead th,\n.table-secondary tbody + tbody {\n  border-color: #b3b7bb;\n}\n\n.table-hover .table-secondary:hover {\n  background-color: #c8cbcf;\n}\n\n.table-hover .table-secondary:hover > td,\n.table-hover .table-secondary:hover > th {\n  background-color: #c8cbcf;\n}\n\n.table-success,\n.table-success > th,\n.table-success > td {\n  background-color: #c3e6cb;\n}\n\n.table-success th,\n.table-success td,\n.table-success thead th,\n.table-success tbody + tbody {\n  border-color: #8fd19e;\n}\n\n.table-hover .table-success:hover {\n  background-color: #b1dfbb;\n}\n\n.table-hover .table-success:hover > td,\n.table-hover .table-success:hover > th {\n  background-color: #b1dfbb;\n}\n\n.table-info,\n.table-info > th,\n.table-info > td {\n  background-color: #bee5eb;\n}\n\n.table-info th,\n.table-info td,\n.table-info thead th,\n.table-info tbody + tbody {\n  border-color: #86cfda;\n}\n\n.table-hover .table-info:hover {\n  background-color: #abdde5;\n}\n\n.table-hover .table-info:hover > td,\n.table-hover .table-info:hover > th {\n  background-color: #abdde5;\n}\n\n.table-warning,\n.table-warning > th,\n.table-warning > td {\n  background-color: #ffeeba;\n}\n\n.table-warning th,\n.table-warning td,\n.table-warning thead th,\n.table-warning tbody + tbody {\n  border-color: #ffdf7e;\n}\n\n.table-hover .table-warning:hover {\n  background-color: #ffe8a1;\n}\n\n.table-hover .table-warning:hover > td,\n.table-hover .table-warning:hover > th {\n  background-color: #ffe8a1;\n}\n\n.table-danger,\n.table-danger > th,\n.table-danger > td {\n  background-color: #f5c6cb;\n}\n\n.table-danger th,\n.table-danger td,\n.table-danger thead th,\n.table-danger tbody + tbody {\n  border-color: #ed969e;\n}\n\n.table-hover .table-danger:hover {\n  background-color: #f1b0b7;\n}\n\n.table-hover .table-danger:hover > td,\n.table-hover .table-danger:hover > th {\n  background-color: #f1b0b7;\n}\n\n.table-light,\n.table-light > th,\n.table-light > td {\n  background-color: #fdfdfe;\n}\n\n.table-light th,\n.table-light td,\n.table-light thead th,\n.table-light tbody + tbody {\n  border-color: #fbfcfc;\n}\n\n.table-hover .table-light:hover {\n  background-color: #ececf6;\n}\n\n.table-hover .table-light:hover > td,\n.table-hover .table-light:hover > th {\n  background-color: #ececf6;\n}\n\n.table-dark,\n.table-dark > th,\n.table-dark > td {\n  background-color: #c6c8ca;\n}\n\n.table-dark th,\n.table-dark td,\n.table-dark thead th,\n.table-dark tbody + tbody {\n  border-color: #95999c;\n}\n\n.table-hover .table-dark:hover {\n  background-color: #b9bbbe;\n}\n\n.table-hover .table-dark:hover > td,\n.table-hover .table-dark:hover > th {\n  background-color: #b9bbbe;\n}\n\n.table-active,\n.table-active > th,\n.table-active > td {\n  background-color: rgba(0, 0, 0, 0.075);\n}\n\n.table-hover .table-active:hover {\n  background-color: rgba(0, 0, 0, 0.075);\n}\n\n.table-hover .table-active:hover > td,\n.table-hover .table-active:hover > th {\n  background-color: rgba(0, 0, 0, 0.075);\n}\n\n.table .thead-dark th {\n  color: #fff;\n  background-color: #343a40;\n  border-color: #454d55;\n}\n\n.table .thead-light th {\n  color: #495057;\n  background-color: #e9ecef;\n  border-color: #dee2e6;\n}\n\n.table-dark {\n  color: #fff;\n  background-color: #343a40;\n}\n\n.table-dark th,\n.table-dark td,\n.table-dark thead th {\n  border-color: #454d55;\n}\n\n.table-dark.table-bordered {\n  border: 0;\n}\n\n.table-dark.table-striped tbody tr:nth-of-type(odd) {\n  background-color: rgba(255, 255, 255, 0.05);\n}\n\n.table-dark.table-hover tbody tr:hover {\n  color: #fff;\n  background-color: rgba(255, 255, 255, 0.075);\n}\n\n@media (max-width: 575.98px) {\n  .table-responsive-sm {\n    display: block;\n    width: 100%;\n    overflow-x: auto;\n    -webkit-overflow-scrolling: touch;\n  }\n  .table-responsive-sm > .table-bordered {\n    border: 0;\n  }\n}\n\n@media (max-width: 767.98px) {\n  .table-responsive-md {\n    display: block;\n    width: 100%;\n    overflow-x: auto;\n    -webkit-overflow-scrolling: touch;\n  }\n  .table-responsive-md > .table-bordered {\n    border: 0;\n  }\n}\n\n@media (max-width: 991.98px) {\n  .table-responsive-lg {\n    display: block;\n    width: 100%;\n    overflow-x: auto;\n    -webkit-overflow-scrolling: touch;\n  }\n  .table-responsive-lg > .table-bordered {\n    border: 0;\n  }\n}\n\n@media (max-width: 1199.98px) {\n  .table-responsive-xl {\n    display: block;\n    width: 100%;\n    overflow-x: auto;\n    -webkit-overflow-scrolling: touch;\n  }\n  .table-responsive-xl > .table-bordered {\n    border: 0;\n  }\n}\n\n.table-responsive {\n  display: block;\n  width: 100%;\n  overflow-x: auto;\n  -webkit-overflow-scrolling: touch;\n}\n\n.table-responsive > .table-bordered {\n  border: 0;\n}\n\n.form-control {\n  display: block;\n  width: 100%;\n  height: calc(1.5em + 0.75rem + 2px);\n  padding: 0.375rem 0.75rem;\n  font-size: 1rem;\n  font-weight: 400;\n  line-height: 1.5;\n  color: #495057;\n  background-color: #fff;\n  background-clip: padding-box;\n  border: 1px solid #ced4da;\n  border-radius: 0.25rem;\n  transition: border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .form-control {\n    transition: none;\n  }\n}\n\n.form-control::-ms-expand {\n  background-color: transparent;\n  border: 0;\n}\n\n.form-control:focus {\n  color: #495057;\n  background-color: #fff;\n  border-color: #80bdff;\n  outline: 0;\n  box-shadow: 0 0 0 0.2rem rgba(0, 123, 255, 0.25);\n}\n\n.form-control::-webkit-input-placeholder {\n  color: #6c757d;\n  opacity: 1;\n}\n\n.form-control::-moz-placeholder {\n  color: #6c757d;\n  opacity: 1;\n}\n\n.form-control:-ms-input-placeholder {\n  color: #6c757d;\n  opacity: 1;\n}\n\n.form-control::-ms-input-placeholder {\n  color: #6c757d;\n  opacity: 1;\n}\n\n.form-control::placeholder {\n  color: #6c757d;\n  opacity: 1;\n}\n\n.form-control:disabled, .form-control[readonly] {\n  background-color: #e9ecef;\n  opacity: 1;\n}\n\nselect.form-control:focus::-ms-value {\n  color: #495057;\n  background-color: #fff;\n}\n\n.form-control-file,\n.form-control-range {\n  display: block;\n  width: 100%;\n}\n\n.col-form-label {\n  padding-top: calc(0.375rem + 1px);\n  padding-bottom: calc(0.375rem + 1px);\n  margin-bottom: 0;\n  font-size: inherit;\n  line-height: 1.5;\n}\n\n.col-form-label-lg {\n  padding-top: calc(0.5rem + 1px);\n  padding-bottom: calc(0.5rem + 1px);\n  font-size: 1.25rem;\n  line-height: 1.5;\n}\n\n.col-form-label-sm {\n  padding-top: calc(0.25rem + 1px);\n  padding-bottom: calc(0.25rem + 1px);\n  font-size: 0.875rem;\n  line-height: 1.5;\n}\n\n.form-control-plaintext {\n  display: block;\n  width: 100%;\n  padding-top: 0.375rem;\n  padding-bottom: 0.375rem;\n  margin-bottom: 0;\n  line-height: 1.5;\n  color: #212529;\n  background-color: transparent;\n  border: solid transparent;\n  border-width: 1px 0;\n}\n\n.form-control-plaintext.form-control-sm, .form-control-plaintext.form-control-lg {\n  padding-right: 0;\n  padding-left: 0;\n}\n\n.form-control-sm {\n  height: calc(1.5em + 0.5rem + 2px);\n  padding: 0.25rem 0.5rem;\n  font-size: 0.875rem;\n  line-height: 1.5;\n  border-radius: 0.2rem;\n}\n\n.form-control-lg {\n  height: calc(1.5em + 1rem + 2px);\n  padding: 0.5rem 1rem;\n  font-size: 1.25rem;\n  line-height: 1.5;\n  border-radius: 0.3rem;\n}\n\nselect.form-control[size], select.form-control[multiple] {\n  height: auto;\n}\n\ntextarea.form-control {\n  height: auto;\n}\n\n.form-group {\n  margin-bottom: 1rem;\n}\n\n.form-text {\n  display: block;\n  margin-top: 0.25rem;\n}\n\n.form-row {\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-wrap: wrap;\n  flex-wrap: wrap;\n  margin-right: -5px;\n  margin-left: -5px;\n}\n\n.form-row > .col,\n.form-row > [class*=\"col-\"] {\n  padding-right: 5px;\n  padding-left: 5px;\n}\n\n.form-check {\n  position: relative;\n  display: block;\n  padding-left: 1.25rem;\n}\n\n.form-check-input {\n  position: absolute;\n  margin-top: 0.3rem;\n  margin-left: -1.25rem;\n}\n\n.form-check-input:disabled ~ .form-check-label {\n  color: #6c757d;\n}\n\n.form-check-label {\n  margin-bottom: 0;\n}\n\n.form-check-inline {\n  display: -ms-inline-flexbox;\n  display: inline-flex;\n  -ms-flex-align: center;\n  align-items: center;\n  padding-left: 0;\n  margin-right: 0.75rem;\n}\n\n.form-check-inline .form-check-input {\n  position: static;\n  margin-top: 0;\n  margin-right: 0.3125rem;\n  margin-left: 0;\n}\n\n.valid-feedback {\n  display: none;\n  width: 100%;\n  margin-top: 0.25rem;\n  font-size: 80%;\n  color: #28a745;\n}\n\n.valid-tooltip {\n  position: absolute;\n  top: 100%;\n  z-index: 5;\n  display: none;\n  max-width: 100%;\n  padding: 0.25rem 0.5rem;\n  margin-top: .1rem;\n  font-size: 0.875rem;\n  line-height: 1.5;\n  color: #fff;\n  background-color: rgba(40, 167, 69, 0.9);\n  border-radius: 0.25rem;\n}\n\n.was-validated .form-control:valid, .form-control.is-valid {\n  border-color: #28a745;\n  padding-right: calc(1.5em + 0.75rem);\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 8 8'%3e%3cpath fill='%2328a745' d='M2.3 6.73L.6 4.53c-.4-1.04.46-1.4 1.1-.8l1.1 1.4 3.4-3.8c.6-.63 1.6-.27 1.2.7l-4 4.6c-.43.5-.8.4-1.1.1z'/%3e%3c/svg%3e\");\n  background-repeat: no-repeat;\n  background-position: center right calc(0.375em + 0.1875rem);\n  background-size: calc(0.75em + 0.375rem) calc(0.75em + 0.375rem);\n}\n\n.was-validated .form-control:valid:focus, .form-control.is-valid:focus {\n  border-color: #28a745;\n  box-shadow: 0 0 0 0.2rem rgba(40, 167, 69, 0.25);\n}\n\n.was-validated .form-control:valid ~ .valid-feedback,\n.was-validated .form-control:valid ~ .valid-tooltip, .form-control.is-valid ~ .valid-feedback,\n.form-control.is-valid ~ .valid-tooltip {\n  display: block;\n}\n\n.was-validated textarea.form-control:valid, textarea.form-control.is-valid {\n  padding-right: calc(1.5em + 0.75rem);\n  background-position: top calc(0.375em + 0.1875rem) right calc(0.375em + 0.1875rem);\n}\n\n.was-validated .custom-select:valid, .custom-select.is-valid {\n  border-color: #28a745;\n  padding-right: calc((1em + 0.75rem) * 3 / 4 + 1.75rem);\n  background: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 4 5'%3e%3cpath fill='%23343a40' d='M2 0L0 2h4zm0 5L0 3h4z'/%3e%3c/svg%3e\") no-repeat right 0.75rem center/8px 10px, url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 8 8'%3e%3cpath fill='%2328a745' d='M2.3 6.73L.6 4.53c-.4-1.04.46-1.4 1.1-.8l1.1 1.4 3.4-3.8c.6-.63 1.6-.27 1.2.7l-4 4.6c-.43.5-.8.4-1.1.1z'/%3e%3c/svg%3e\") #fff no-repeat center right 1.75rem/calc(0.75em + 0.375rem) calc(0.75em + 0.375rem);\n}\n\n.was-validated .custom-select:valid:focus, .custom-select.is-valid:focus {\n  border-color: #28a745;\n  box-shadow: 0 0 0 0.2rem rgba(40, 167, 69, 0.25);\n}\n\n.was-validated .custom-select:valid ~ .valid-feedback,\n.was-validated .custom-select:valid ~ .valid-tooltip, .custom-select.is-valid ~ .valid-feedback,\n.custom-select.is-valid ~ .valid-tooltip {\n  display: block;\n}\n\n.was-validated .form-control-file:valid ~ .valid-feedback,\n.was-validated .form-control-file:valid ~ .valid-tooltip, .form-control-file.is-valid ~ .valid-feedback,\n.form-control-file.is-valid ~ .valid-tooltip {\n  display: block;\n}\n\n.was-validated .form-check-input:valid ~ .form-check-label, .form-check-input.is-valid ~ .form-check-label {\n  color: #28a745;\n}\n\n.was-validated .form-check-input:valid ~ .valid-feedback,\n.was-validated .form-check-input:valid ~ .valid-tooltip, .form-check-input.is-valid ~ .valid-feedback,\n.form-check-input.is-valid ~ .valid-tooltip {\n  display: block;\n}\n\n.was-validated .custom-control-input:valid ~ .custom-control-label, .custom-control-input.is-valid ~ .custom-control-label {\n  color: #28a745;\n}\n\n.was-validated .custom-control-input:valid ~ .custom-control-label::before, .custom-control-input.is-valid ~ .custom-control-label::before {\n  border-color: #28a745;\n}\n\n.was-validated .custom-control-input:valid ~ .valid-feedback,\n.was-validated .custom-control-input:valid ~ .valid-tooltip, .custom-control-input.is-valid ~ .valid-feedback,\n.custom-control-input.is-valid ~ .valid-tooltip {\n  display: block;\n}\n\n.was-validated .custom-control-input:valid:checked ~ .custom-control-label::before, .custom-control-input.is-valid:checked ~ .custom-control-label::before {\n  border-color: #34ce57;\n  background-color: #34ce57;\n}\n\n.was-validated .custom-control-input:valid:focus ~ .custom-control-label::before, .custom-control-input.is-valid:focus ~ .custom-control-label::before {\n  box-shadow: 0 0 0 0.2rem rgba(40, 167, 69, 0.25);\n}\n\n.was-validated .custom-control-input:valid:focus:not(:checked) ~ .custom-control-label::before, .custom-control-input.is-valid:focus:not(:checked) ~ .custom-control-label::before {\n  border-color: #28a745;\n}\n\n.was-validated .custom-file-input:valid ~ .custom-file-label, .custom-file-input.is-valid ~ .custom-file-label {\n  border-color: #28a745;\n}\n\n.was-validated .custom-file-input:valid ~ .valid-feedback,\n.was-validated .custom-file-input:valid ~ .valid-tooltip, .custom-file-input.is-valid ~ .valid-feedback,\n.custom-file-input.is-valid ~ .valid-tooltip {\n  display: block;\n}\n\n.was-validated .custom-file-input:valid:focus ~ .custom-file-label, .custom-file-input.is-valid:focus ~ .custom-file-label {\n  border-color: #28a745;\n  box-shadow: 0 0 0 0.2rem rgba(40, 167, 69, 0.25);\n}\n\n.invalid-feedback {\n  display: none;\n  width: 100%;\n  margin-top: 0.25rem;\n  font-size: 80%;\n  color: #dc3545;\n}\n\n.invalid-tooltip {\n  position: absolute;\n  top: 100%;\n  z-index: 5;\n  display: none;\n  max-width: 100%;\n  padding: 0.25rem 0.5rem;\n  margin-top: .1rem;\n  font-size: 0.875rem;\n  line-height: 1.5;\n  color: #fff;\n  background-color: rgba(220, 53, 69, 0.9);\n  border-radius: 0.25rem;\n}\n\n.was-validated .form-control:invalid, .form-control.is-invalid {\n  border-color: #dc3545;\n  padding-right: calc(1.5em + 0.75rem);\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' fill='%23dc3545' viewBox='-2 -2 7 7'%3e%3cpath stroke='%23dc3545' d='M0 0l3 3m0-3L0 3'/%3e%3ccircle r='.5'/%3e%3ccircle cx='3' r='.5'/%3e%3ccircle cy='3' r='.5'/%3e%3ccircle cx='3' cy='3' r='.5'/%3e%3c/svg%3E\");\n  background-repeat: no-repeat;\n  background-position: center right calc(0.375em + 0.1875rem);\n  background-size: calc(0.75em + 0.375rem) calc(0.75em + 0.375rem);\n}\n\n.was-validated .form-control:invalid:focus, .form-control.is-invalid:focus {\n  border-color: #dc3545;\n  box-shadow: 0 0 0 0.2rem rgba(220, 53, 69, 0.25);\n}\n\n.was-validated .form-control:invalid ~ .invalid-feedback,\n.was-validated .form-control:invalid ~ .invalid-tooltip, .form-control.is-invalid ~ .invalid-feedback,\n.form-control.is-invalid ~ .invalid-tooltip {\n  display: block;\n}\n\n.was-validated textarea.form-control:invalid, textarea.form-control.is-invalid {\n  padding-right: calc(1.5em + 0.75rem);\n  background-position: top calc(0.375em + 0.1875rem) right calc(0.375em + 0.1875rem);\n}\n\n.was-validated .custom-select:invalid, .custom-select.is-invalid {\n  border-color: #dc3545;\n  padding-right: calc((1em + 0.75rem) * 3 / 4 + 1.75rem);\n  background: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 4 5'%3e%3cpath fill='%23343a40' d='M2 0L0 2h4zm0 5L0 3h4z'/%3e%3c/svg%3e\") no-repeat right 0.75rem center/8px 10px, url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' fill='%23dc3545' viewBox='-2 -2 7 7'%3e%3cpath stroke='%23dc3545' d='M0 0l3 3m0-3L0 3'/%3e%3ccircle r='.5'/%3e%3ccircle cx='3' r='.5'/%3e%3ccircle cy='3' r='.5'/%3e%3ccircle cx='3' cy='3' r='.5'/%3e%3c/svg%3E\") #fff no-repeat center right 1.75rem/calc(0.75em + 0.375rem) calc(0.75em + 0.375rem);\n}\n\n.was-validated .custom-select:invalid:focus, .custom-select.is-invalid:focus {\n  border-color: #dc3545;\n  box-shadow: 0 0 0 0.2rem rgba(220, 53, 69, 0.25);\n}\n\n.was-validated .custom-select:invalid ~ .invalid-feedback,\n.was-validated .custom-select:invalid ~ .invalid-tooltip, .custom-select.is-invalid ~ .invalid-feedback,\n.custom-select.is-invalid ~ .invalid-tooltip {\n  display: block;\n}\n\n.was-validated .form-control-file:invalid ~ .invalid-feedback,\n.was-validated .form-control-file:invalid ~ .invalid-tooltip, .form-control-file.is-invalid ~ .invalid-feedback,\n.form-control-file.is-invalid ~ .invalid-tooltip {\n  display: block;\n}\n\n.was-validated .form-check-input:invalid ~ .form-check-label, .form-check-input.is-invalid ~ .form-check-label {\n  color: #dc3545;\n}\n\n.was-validated .form-check-input:invalid ~ .invalid-feedback,\n.was-validated .form-check-input:invalid ~ .invalid-tooltip, .form-check-input.is-invalid ~ .invalid-feedback,\n.form-check-input.is-invalid ~ .invalid-tooltip {\n  display: block;\n}\n\n.was-validated .custom-control-input:invalid ~ .custom-control-label, .custom-control-input.is-invalid ~ .custom-control-label {\n  color: #dc3545;\n}\n\n.was-validated .custom-control-input:invalid ~ .custom-control-label::before, .custom-control-input.is-invalid ~ .custom-control-label::before {\n  border-color: #dc3545;\n}\n\n.was-validated .custom-control-input:invalid ~ .invalid-feedback,\n.was-validated .custom-control-input:invalid ~ .invalid-tooltip, .custom-control-input.is-invalid ~ .invalid-feedback,\n.custom-control-input.is-invalid ~ .invalid-tooltip {\n  display: block;\n}\n\n.was-validated .custom-control-input:invalid:checked ~ .custom-control-label::before, .custom-control-input.is-invalid:checked ~ .custom-control-label::before {\n  border-color: #e4606d;\n  background-color: #e4606d;\n}\n\n.was-validated .custom-control-input:invalid:focus ~ .custom-control-label::before, .custom-control-input.is-invalid:focus ~ .custom-control-label::before {\n  box-shadow: 0 0 0 0.2rem rgba(220, 53, 69, 0.25);\n}\n\n.was-validated .custom-control-input:invalid:focus:not(:checked) ~ .custom-control-label::before, .custom-control-input.is-invalid:focus:not(:checked) ~ .custom-control-label::before {\n  border-color: #dc3545;\n}\n\n.was-validated .custom-file-input:invalid ~ .custom-file-label, .custom-file-input.is-invalid ~ .custom-file-label {\n  border-color: #dc3545;\n}\n\n.was-validated .custom-file-input:invalid ~ .invalid-feedback,\n.was-validated .custom-file-input:invalid ~ .invalid-tooltip, .custom-file-input.is-invalid ~ .invalid-feedback,\n.custom-file-input.is-invalid ~ .invalid-tooltip {\n  display: block;\n}\n\n.was-validated .custom-file-input:invalid:focus ~ .custom-file-label, .custom-file-input.is-invalid:focus ~ .custom-file-label {\n  border-color: #dc3545;\n  box-shadow: 0 0 0 0.2rem rgba(220, 53, 69, 0.25);\n}\n\n.form-inline {\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-flow: row wrap;\n  flex-flow: row wrap;\n  -ms-flex-align: center;\n  align-items: center;\n}\n\n.form-inline .form-check {\n  width: 100%;\n}\n\n@media (min-width: 576px) {\n  .form-inline label {\n    display: -ms-flexbox;\n    display: flex;\n    -ms-flex-align: center;\n    align-items: center;\n    -ms-flex-pack: center;\n    justify-content: center;\n    margin-bottom: 0;\n  }\n  .form-inline .form-group {\n    display: -ms-flexbox;\n    display: flex;\n    -ms-flex: 0 0 auto;\n    flex: 0 0 auto;\n    -ms-flex-flow: row wrap;\n    flex-flow: row wrap;\n    -ms-flex-align: center;\n    align-items: center;\n    margin-bottom: 0;\n  }\n  .form-inline .form-control {\n    display: inline-block;\n    width: auto;\n    vertical-align: middle;\n  }\n  .form-inline .form-control-plaintext {\n    display: inline-block;\n  }\n  .form-inline .input-group,\n  .form-inline .custom-select {\n    width: auto;\n  }\n  .form-inline .form-check {\n    display: -ms-flexbox;\n    display: flex;\n    -ms-flex-align: center;\n    align-items: center;\n    -ms-flex-pack: center;\n    justify-content: center;\n    width: auto;\n    padding-left: 0;\n  }\n  .form-inline .form-check-input {\n    position: relative;\n    -ms-flex-negative: 0;\n    flex-shrink: 0;\n    margin-top: 0;\n    margin-right: 0.25rem;\n    margin-left: 0;\n  }\n  .form-inline .custom-control {\n    -ms-flex-align: center;\n    align-items: center;\n    -ms-flex-pack: center;\n    justify-content: center;\n  }\n  .form-inline .custom-control-label {\n    margin-bottom: 0;\n  }\n}\n\n.btn {\n  display: inline-block;\n  font-weight: 400;\n  color: #212529;\n  text-align: center;\n  vertical-align: middle;\n  -webkit-user-select: none;\n  -moz-user-select: none;\n  -ms-user-select: none;\n  user-select: none;\n  background-color: transparent;\n  border: 1px solid transparent;\n  padding: 0.375rem 0.75rem;\n  font-size: 1rem;\n  line-height: 1.5;\n  border-radius: 0.25rem;\n  transition: color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .btn {\n    transition: none;\n  }\n}\n\n.btn:hover {\n  color: #212529;\n  text-decoration: none;\n}\n\n.btn:focus, .btn.focus {\n  outline: 0;\n  box-shadow: 0 0 0 0.2rem rgba(0, 123, 255, 0.25);\n}\n\n.btn.disabled, .btn:disabled {\n  opacity: 0.65;\n}\n\na.btn.disabled,\nfieldset:disabled a.btn {\n  pointer-events: none;\n}\n\n.btn-primary {\n  color: #fff;\n  background-color: #007bff;\n  border-color: #007bff;\n}\n\n.btn-primary:hover {\n  color: #fff;\n  background-color: #0069d9;\n  border-color: #0062cc;\n}\n\n.btn-primary:focus, .btn-primary.focus {\n  box-shadow: 0 0 0 0.2rem rgba(38, 143, 255, 0.5);\n}\n\n.btn-primary.disabled, .btn-primary:disabled {\n  color: #fff;\n  background-color: #007bff;\n  border-color: #007bff;\n}\n\n.btn-primary:not(:disabled):not(.disabled):active, .btn-primary:not(:disabled):not(.disabled).active,\n.show > .btn-primary.dropdown-toggle {\n  color: #fff;\n  background-color: #0062cc;\n  border-color: #005cbf;\n}\n\n.btn-primary:not(:disabled):not(.disabled):active:focus, .btn-primary:not(:disabled):not(.disabled).active:focus,\n.show > .btn-primary.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(38, 143, 255, 0.5);\n}\n\n.btn-secondary {\n  color: #fff;\n  background-color: #6c757d;\n  border-color: #6c757d;\n}\n\n.btn-secondary:hover {\n  color: #fff;\n  background-color: #5a6268;\n  border-color: #545b62;\n}\n\n.btn-secondary:focus, .btn-secondary.focus {\n  box-shadow: 0 0 0 0.2rem rgba(130, 138, 145, 0.5);\n}\n\n.btn-secondary.disabled, .btn-secondary:disabled {\n  color: #fff;\n  background-color: #6c757d;\n  border-color: #6c757d;\n}\n\n.btn-secondary:not(:disabled):not(.disabled):active, .btn-secondary:not(:disabled):not(.disabled).active,\n.show > .btn-secondary.dropdown-toggle {\n  color: #fff;\n  background-color: #545b62;\n  border-color: #4e555b;\n}\n\n.btn-secondary:not(:disabled):not(.disabled):active:focus, .btn-secondary:not(:disabled):not(.disabled).active:focus,\n.show > .btn-secondary.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(130, 138, 145, 0.5);\n}\n\n.btn-success {\n  color: #fff;\n  background-color: #28a745;\n  border-color: #28a745;\n}\n\n.btn-success:hover {\n  color: #fff;\n  background-color: #218838;\n  border-color: #1e7e34;\n}\n\n.btn-success:focus, .btn-success.focus {\n  box-shadow: 0 0 0 0.2rem rgba(72, 180, 97, 0.5);\n}\n\n.btn-success.disabled, .btn-success:disabled {\n  color: #fff;\n  background-color: #28a745;\n  border-color: #28a745;\n}\n\n.btn-success:not(:disabled):not(.disabled):active, .btn-success:not(:disabled):not(.disabled).active,\n.show > .btn-success.dropdown-toggle {\n  color: #fff;\n  background-color: #1e7e34;\n  border-color: #1c7430;\n}\n\n.btn-success:not(:disabled):not(.disabled):active:focus, .btn-success:not(:disabled):not(.disabled).active:focus,\n.show > .btn-success.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(72, 180, 97, 0.5);\n}\n\n.btn-info {\n  color: #fff;\n  background-color: #17a2b8;\n  border-color: #17a2b8;\n}\n\n.btn-info:hover {\n  color: #fff;\n  background-color: #138496;\n  border-color: #117a8b;\n}\n\n.btn-info:focus, .btn-info.focus {\n  box-shadow: 0 0 0 0.2rem rgba(58, 176, 195, 0.5);\n}\n\n.btn-info.disabled, .btn-info:disabled {\n  color: #fff;\n  background-color: #17a2b8;\n  border-color: #17a2b8;\n}\n\n.btn-info:not(:disabled):not(.disabled):active, .btn-info:not(:disabled):not(.disabled).active,\n.show > .btn-info.dropdown-toggle {\n  color: #fff;\n  background-color: #117a8b;\n  border-color: #10707f;\n}\n\n.btn-info:not(:disabled):not(.disabled):active:focus, .btn-info:not(:disabled):not(.disabled).active:focus,\n.show > .btn-info.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(58, 176, 195, 0.5);\n}\n\n.btn-warning {\n  color: #212529;\n  background-color: #ffc107;\n  border-color: #ffc107;\n}\n\n.btn-warning:hover {\n  color: #212529;\n  background-color: #e0a800;\n  border-color: #d39e00;\n}\n\n.btn-warning:focus, .btn-warning.focus {\n  box-shadow: 0 0 0 0.2rem rgba(222, 170, 12, 0.5);\n}\n\n.btn-warning.disabled, .btn-warning:disabled {\n  color: #212529;\n  background-color: #ffc107;\n  border-color: #ffc107;\n}\n\n.btn-warning:not(:disabled):not(.disabled):active, .btn-warning:not(:disabled):not(.disabled).active,\n.show > .btn-warning.dropdown-toggle {\n  color: #212529;\n  background-color: #d39e00;\n  border-color: #c69500;\n}\n\n.btn-warning:not(:disabled):not(.disabled):active:focus, .btn-warning:not(:disabled):not(.disabled).active:focus,\n.show > .btn-warning.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(222, 170, 12, 0.5);\n}\n\n.btn-danger {\n  color: #fff;\n  background-color: #dc3545;\n  border-color: #dc3545;\n}\n\n.btn-danger:hover {\n  color: #fff;\n  background-color: #c82333;\n  border-color: #bd2130;\n}\n\n.btn-danger:focus, .btn-danger.focus {\n  box-shadow: 0 0 0 0.2rem rgba(225, 83, 97, 0.5);\n}\n\n.btn-danger.disabled, .btn-danger:disabled {\n  color: #fff;\n  background-color: #dc3545;\n  border-color: #dc3545;\n}\n\n.btn-danger:not(:disabled):not(.disabled):active, .btn-danger:not(:disabled):not(.disabled).active,\n.show > .btn-danger.dropdown-toggle {\n  color: #fff;\n  background-color: #bd2130;\n  border-color: #b21f2d;\n}\n\n.btn-danger:not(:disabled):not(.disabled):active:focus, .btn-danger:not(:disabled):not(.disabled).active:focus,\n.show > .btn-danger.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(225, 83, 97, 0.5);\n}\n\n.btn-light {\n  color: #212529;\n  background-color: #f8f9fa;\n  border-color: #f8f9fa;\n}\n\n.btn-light:hover {\n  color: #212529;\n  background-color: #e2e6ea;\n  border-color: #dae0e5;\n}\n\n.btn-light:focus, .btn-light.focus {\n  box-shadow: 0 0 0 0.2rem rgba(216, 217, 219, 0.5);\n}\n\n.btn-light.disabled, .btn-light:disabled {\n  color: #212529;\n  background-color: #f8f9fa;\n  border-color: #f8f9fa;\n}\n\n.btn-light:not(:disabled):not(.disabled):active, .btn-light:not(:disabled):not(.disabled).active,\n.show > .btn-light.dropdown-toggle {\n  color: #212529;\n  background-color: #dae0e5;\n  border-color: #d3d9df;\n}\n\n.btn-light:not(:disabled):not(.disabled):active:focus, .btn-light:not(:disabled):not(.disabled).active:focus,\n.show > .btn-light.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(216, 217, 219, 0.5);\n}\n\n.btn-dark {\n  color: #fff;\n  background-color: #343a40;\n  border-color: #343a40;\n}\n\n.btn-dark:hover {\n  color: #fff;\n  background-color: #23272b;\n  border-color: #1d2124;\n}\n\n.btn-dark:focus, .btn-dark.focus {\n  box-shadow: 0 0 0 0.2rem rgba(82, 88, 93, 0.5);\n}\n\n.btn-dark.disabled, .btn-dark:disabled {\n  color: #fff;\n  background-color: #343a40;\n  border-color: #343a40;\n}\n\n.btn-dark:not(:disabled):not(.disabled):active, .btn-dark:not(:disabled):not(.disabled).active,\n.show > .btn-dark.dropdown-toggle {\n  color: #fff;\n  background-color: #1d2124;\n  border-color: #171a1d;\n}\n\n.btn-dark:not(:disabled):not(.disabled):active:focus, .btn-dark:not(:disabled):not(.disabled).active:focus,\n.show > .btn-dark.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(82, 88, 93, 0.5);\n}\n\n.btn-outline-primary {\n  color: #007bff;\n  border-color: #007bff;\n}\n\n.btn-outline-primary:hover {\n  color: #fff;\n  background-color: #007bff;\n  border-color: #007bff;\n}\n\n.btn-outline-primary:focus, .btn-outline-primary.focus {\n  box-shadow: 0 0 0 0.2rem rgba(0, 123, 255, 0.5);\n}\n\n.btn-outline-primary.disabled, .btn-outline-primary:disabled {\n  color: #007bff;\n  background-color: transparent;\n}\n\n.btn-outline-primary:not(:disabled):not(.disabled):active, .btn-outline-primary:not(:disabled):not(.disabled).active,\n.show > .btn-outline-primary.dropdown-toggle {\n  color: #fff;\n  background-color: #007bff;\n  border-color: #007bff;\n}\n\n.btn-outline-primary:not(:disabled):not(.disabled):active:focus, .btn-outline-primary:not(:disabled):not(.disabled).active:focus,\n.show > .btn-outline-primary.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(0, 123, 255, 0.5);\n}\n\n.btn-outline-secondary {\n  color: #6c757d;\n  border-color: #6c757d;\n}\n\n.btn-outline-secondary:hover {\n  color: #fff;\n  background-color: #6c757d;\n  border-color: #6c757d;\n}\n\n.btn-outline-secondary:focus, .btn-outline-secondary.focus {\n  box-shadow: 0 0 0 0.2rem rgba(108, 117, 125, 0.5);\n}\n\n.btn-outline-secondary.disabled, .btn-outline-secondary:disabled {\n  color: #6c757d;\n  background-color: transparent;\n}\n\n.btn-outline-secondary:not(:disabled):not(.disabled):active, .btn-outline-secondary:not(:disabled):not(.disabled).active,\n.show > .btn-outline-secondary.dropdown-toggle {\n  color: #fff;\n  background-color: #6c757d;\n  border-color: #6c757d;\n}\n\n.btn-outline-secondary:not(:disabled):not(.disabled):active:focus, .btn-outline-secondary:not(:disabled):not(.disabled).active:focus,\n.show > .btn-outline-secondary.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(108, 117, 125, 0.5);\n}\n\n.btn-outline-success {\n  color: #28a745;\n  border-color: #28a745;\n}\n\n.btn-outline-success:hover {\n  color: #fff;\n  background-color: #28a745;\n  border-color: #28a745;\n}\n\n.btn-outline-success:focus, .btn-outline-success.focus {\n  box-shadow: 0 0 0 0.2rem rgba(40, 167, 69, 0.5);\n}\n\n.btn-outline-success.disabled, .btn-outline-success:disabled {\n  color: #28a745;\n  background-color: transparent;\n}\n\n.btn-outline-success:not(:disabled):not(.disabled):active, .btn-outline-success:not(:disabled):not(.disabled).active,\n.show > .btn-outline-success.dropdown-toggle {\n  color: #fff;\n  background-color: #28a745;\n  border-color: #28a745;\n}\n\n.btn-outline-success:not(:disabled):not(.disabled):active:focus, .btn-outline-success:not(:disabled):not(.disabled).active:focus,\n.show > .btn-outline-success.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(40, 167, 69, 0.5);\n}\n\n.btn-outline-info {\n  color: #17a2b8;\n  border-color: #17a2b8;\n}\n\n.btn-outline-info:hover {\n  color: #fff;\n  background-color: #17a2b8;\n  border-color: #17a2b8;\n}\n\n.btn-outline-info:focus, .btn-outline-info.focus {\n  box-shadow: 0 0 0 0.2rem rgba(23, 162, 184, 0.5);\n}\n\n.btn-outline-info.disabled, .btn-outline-info:disabled {\n  color: #17a2b8;\n  background-color: transparent;\n}\n\n.btn-outline-info:not(:disabled):not(.disabled):active, .btn-outline-info:not(:disabled):not(.disabled).active,\n.show > .btn-outline-info.dropdown-toggle {\n  color: #fff;\n  background-color: #17a2b8;\n  border-color: #17a2b8;\n}\n\n.btn-outline-info:not(:disabled):not(.disabled):active:focus, .btn-outline-info:not(:disabled):not(.disabled).active:focus,\n.show > .btn-outline-info.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(23, 162, 184, 0.5);\n}\n\n.btn-outline-warning {\n  color: #ffc107;\n  border-color: #ffc107;\n}\n\n.btn-outline-warning:hover {\n  color: #212529;\n  background-color: #ffc107;\n  border-color: #ffc107;\n}\n\n.btn-outline-warning:focus, .btn-outline-warning.focus {\n  box-shadow: 0 0 0 0.2rem rgba(255, 193, 7, 0.5);\n}\n\n.btn-outline-warning.disabled, .btn-outline-warning:disabled {\n  color: #ffc107;\n  background-color: transparent;\n}\n\n.btn-outline-warning:not(:disabled):not(.disabled):active, .btn-outline-warning:not(:disabled):not(.disabled).active,\n.show > .btn-outline-warning.dropdown-toggle {\n  color: #212529;\n  background-color: #ffc107;\n  border-color: #ffc107;\n}\n\n.btn-outline-warning:not(:disabled):not(.disabled):active:focus, .btn-outline-warning:not(:disabled):not(.disabled).active:focus,\n.show > .btn-outline-warning.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(255, 193, 7, 0.5);\n}\n\n.btn-outline-danger {\n  color: #dc3545;\n  border-color: #dc3545;\n}\n\n.btn-outline-danger:hover {\n  color: #fff;\n  background-color: #dc3545;\n  border-color: #dc3545;\n}\n\n.btn-outline-danger:focus, .btn-outline-danger.focus {\n  box-shadow: 0 0 0 0.2rem rgba(220, 53, 69, 0.5);\n}\n\n.btn-outline-danger.disabled, .btn-outline-danger:disabled {\n  color: #dc3545;\n  background-color: transparent;\n}\n\n.btn-outline-danger:not(:disabled):not(.disabled):active, .btn-outline-danger:not(:disabled):not(.disabled).active,\n.show > .btn-outline-danger.dropdown-toggle {\n  color: #fff;\n  background-color: #dc3545;\n  border-color: #dc3545;\n}\n\n.btn-outline-danger:not(:disabled):not(.disabled):active:focus, .btn-outline-danger:not(:disabled):not(.disabled).active:focus,\n.show > .btn-outline-danger.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(220, 53, 69, 0.5);\n}\n\n.btn-outline-light {\n  color: #f8f9fa;\n  border-color: #f8f9fa;\n}\n\n.btn-outline-light:hover {\n  color: #212529;\n  background-color: #f8f9fa;\n  border-color: #f8f9fa;\n}\n\n.btn-outline-light:focus, .btn-outline-light.focus {\n  box-shadow: 0 0 0 0.2rem rgba(248, 249, 250, 0.5);\n}\n\n.btn-outline-light.disabled, .btn-outline-light:disabled {\n  color: #f8f9fa;\n  background-color: transparent;\n}\n\n.btn-outline-light:not(:disabled):not(.disabled):active, .btn-outline-light:not(:disabled):not(.disabled).active,\n.show > .btn-outline-light.dropdown-toggle {\n  color: #212529;\n  background-color: #f8f9fa;\n  border-color: #f8f9fa;\n}\n\n.btn-outline-light:not(:disabled):not(.disabled):active:focus, .btn-outline-light:not(:disabled):not(.disabled).active:focus,\n.show > .btn-outline-light.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(248, 249, 250, 0.5);\n}\n\n.btn-outline-dark {\n  color: #343a40;\n  border-color: #343a40;\n}\n\n.btn-outline-dark:hover {\n  color: #fff;\n  background-color: #343a40;\n  border-color: #343a40;\n}\n\n.btn-outline-dark:focus, .btn-outline-dark.focus {\n  box-shadow: 0 0 0 0.2rem rgba(52, 58, 64, 0.5);\n}\n\n.btn-outline-dark.disabled, .btn-outline-dark:disabled {\n  color: #343a40;\n  background-color: transparent;\n}\n\n.btn-outline-dark:not(:disabled):not(.disabled):active, .btn-outline-dark:not(:disabled):not(.disabled).active,\n.show > .btn-outline-dark.dropdown-toggle {\n  color: #fff;\n  background-color: #343a40;\n  border-color: #343a40;\n}\n\n.btn-outline-dark:not(:disabled):not(.disabled):active:focus, .btn-outline-dark:not(:disabled):not(.disabled).active:focus,\n.show > .btn-outline-dark.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(52, 58, 64, 0.5);\n}\n\n.btn-link {\n  font-weight: 400;\n  color: #007bff;\n  text-decoration: none;\n}\n\n.btn-link:hover {\n  color: #0056b3;\n  text-decoration: underline;\n}\n\n.btn-link:focus, .btn-link.focus {\n  text-decoration: underline;\n  box-shadow: none;\n}\n\n.btn-link:disabled, .btn-link.disabled {\n  color: #6c757d;\n  pointer-events: none;\n}\n\n.btn-lg, .btn-group-lg > .btn {\n  padding: 0.5rem 1rem;\n  font-size: 1.25rem;\n  line-height: 1.5;\n  border-radius: 0.3rem;\n}\n\n.btn-sm, .btn-group-sm > .btn {\n  padding: 0.25rem 0.5rem;\n  font-size: 0.875rem;\n  line-height: 1.5;\n  border-radius: 0.2rem;\n}\n\n.btn-block {\n  display: block;\n  width: 100%;\n}\n\n.btn-block + .btn-block {\n  margin-top: 0.5rem;\n}\n\ninput[type=\"submit\"].btn-block,\ninput[type=\"reset\"].btn-block,\ninput[type=\"button\"].btn-block {\n  width: 100%;\n}\n\n.fade {\n  transition: opacity 0.15s linear;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .fade {\n    transition: none;\n  }\n}\n\n.fade:not(.show) {\n  opacity: 0;\n}\n\n.collapse:not(.show) {\n  display: none;\n}\n\n.collapsing {\n  position: relative;\n  height: 0;\n  overflow: hidden;\n  transition: height 0.35s ease;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .collapsing {\n    transition: none;\n  }\n}\n\n.dropup,\n.dropright,\n.dropdown,\n.dropleft {\n  position: relative;\n}\n\n.dropdown-toggle {\n  white-space: nowrap;\n}\n\n.dropdown-toggle::after {\n  display: inline-block;\n  margin-left: 0.255em;\n  vertical-align: 0.255em;\n  content: \"\";\n  border-top: 0.3em solid;\n  border-right: 0.3em solid transparent;\n  border-bottom: 0;\n  border-left: 0.3em solid transparent;\n}\n\n.dropdown-toggle:empty::after {\n  margin-left: 0;\n}\n\n.dropdown-menu {\n  position: absolute;\n  top: 100%;\n  left: 0;\n  z-index: 1000;\n  display: none;\n  float: left;\n  min-width: 10rem;\n  padding: 0.5rem 0;\n  margin: 0.125rem 0 0;\n  font-size: 1rem;\n  color: #212529;\n  text-align: left;\n  list-style: none;\n  background-color: #fff;\n  background-clip: padding-box;\n  border: 1px solid rgba(0, 0, 0, 0.15);\n  border-radius: 0.25rem;\n}\n\n.dropdown-menu-left {\n  right: auto;\n  left: 0;\n}\n\n.dropdown-menu-right {\n  right: 0;\n  left: auto;\n}\n\n@media (min-width: 576px) {\n  .dropdown-menu-sm-left {\n    right: auto;\n    left: 0;\n  }\n  .dropdown-menu-sm-right {\n    right: 0;\n    left: auto;\n  }\n}\n\n@media (min-width: 768px) {\n  .dropdown-menu-md-left {\n    right: auto;\n    left: 0;\n  }\n  .dropdown-menu-md-right {\n    right: 0;\n    left: auto;\n  }\n}\n\n@media (min-width: 992px) {\n  .dropdown-menu-lg-left {\n    right: auto;\n    left: 0;\n  }\n  .dropdown-menu-lg-right {\n    right: 0;\n    left: auto;\n  }\n}\n\n@media (min-width: 1200px) {\n  .dropdown-menu-xl-left {\n    right: auto;\n    left: 0;\n  }\n  .dropdown-menu-xl-right {\n    right: 0;\n    left: auto;\n  }\n}\n\n.dropup .dropdown-menu {\n  top: auto;\n  bottom: 100%;\n  margin-top: 0;\n  margin-bottom: 0.125rem;\n}\n\n.dropup .dropdown-toggle::after {\n  display: inline-block;\n  margin-left: 0.255em;\n  vertical-align: 0.255em;\n  content: \"\";\n  border-top: 0;\n  border-right: 0.3em solid transparent;\n  border-bottom: 0.3em solid;\n  border-left: 0.3em solid transparent;\n}\n\n.dropup .dropdown-toggle:empty::after {\n  margin-left: 0;\n}\n\n.dropright .dropdown-menu {\n  top: 0;\n  right: auto;\n  left: 100%;\n  margin-top: 0;\n  margin-left: 0.125rem;\n}\n\n.dropright .dropdown-toggle::after {\n  display: inline-block;\n  margin-left: 0.255em;\n  vertical-align: 0.255em;\n  content: \"\";\n  border-top: 0.3em solid transparent;\n  border-right: 0;\n  border-bottom: 0.3em solid transparent;\n  border-left: 0.3em solid;\n}\n\n.dropright .dropdown-toggle:empty::after {\n  margin-left: 0;\n}\n\n.dropright .dropdown-toggle::after {\n  vertical-align: 0;\n}\n\n.dropleft .dropdown-menu {\n  top: 0;\n  right: 100%;\n  left: auto;\n  margin-top: 0;\n  margin-right: 0.125rem;\n}\n\n.dropleft .dropdown-toggle::after {\n  display: inline-block;\n  margin-left: 0.255em;\n  vertical-align: 0.255em;\n  content: \"\";\n}\n\n.dropleft .dropdown-toggle::after {\n  display: none;\n}\n\n.dropleft .dropdown-toggle::before {\n  display: inline-block;\n  margin-right: 0.255em;\n  vertical-align: 0.255em;\n  content: \"\";\n  border-top: 0.3em solid transparent;\n  border-right: 0.3em solid;\n  border-bottom: 0.3em solid transparent;\n}\n\n.dropleft .dropdown-toggle:empty::after {\n  margin-left: 0;\n}\n\n.dropleft .dropdown-toggle::before {\n  vertical-align: 0;\n}\n\n.dropdown-menu[x-placement^=\"top\"], .dropdown-menu[x-placement^=\"right\"], .dropdown-menu[x-placement^=\"bottom\"], .dropdown-menu[x-placement^=\"left\"] {\n  right: auto;\n  bottom: auto;\n}\n\n.dropdown-divider {\n  height: 0;\n  margin: 0.5rem 0;\n  overflow: hidden;\n  border-top: 1px solid #e9ecef;\n}\n\n.dropdown-item {\n  display: block;\n  width: 100%;\n  padding: 0.25rem 1.5rem;\n  clear: both;\n  font-weight: 400;\n  color: #212529;\n  text-align: inherit;\n  white-space: nowrap;\n  background-color: transparent;\n  border: 0;\n}\n\n.dropdown-item:hover, .dropdown-item:focus {\n  color: #16181b;\n  text-decoration: none;\n  background-color: #f8f9fa;\n}\n\n.dropdown-item.active, .dropdown-item:active {\n  color: #fff;\n  text-decoration: none;\n  background-color: #007bff;\n}\n\n.dropdown-item.disabled, .dropdown-item:disabled {\n  color: #6c757d;\n  pointer-events: none;\n  background-color: transparent;\n}\n\n.dropdown-menu.show {\n  display: block;\n}\n\n.dropdown-header {\n  display: block;\n  padding: 0.5rem 1.5rem;\n  margin-bottom: 0;\n  font-size: 0.875rem;\n  color: #6c757d;\n  white-space: nowrap;\n}\n\n.dropdown-item-text {\n  display: block;\n  padding: 0.25rem 1.5rem;\n  color: #212529;\n}\n\n.btn-group,\n.btn-group-vertical {\n  position: relative;\n  display: -ms-inline-flexbox;\n  display: inline-flex;\n  vertical-align: middle;\n}\n\n.btn-group > .btn,\n.btn-group-vertical > .btn {\n  position: relative;\n  -ms-flex: 1 1 auto;\n  flex: 1 1 auto;\n}\n\n.btn-group > .btn:hover,\n.btn-group-vertical > .btn:hover {\n  z-index: 1;\n}\n\n.btn-group > .btn:focus, .btn-group > .btn:active, .btn-group > .btn.active,\n.btn-group-vertical > .btn:focus,\n.btn-group-vertical > .btn:active,\n.btn-group-vertical > .btn.active {\n  z-index: 1;\n}\n\n.btn-toolbar {\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-wrap: wrap;\n  flex-wrap: wrap;\n  -ms-flex-pack: start;\n  justify-content: flex-start;\n}\n\n.btn-toolbar .input-group {\n  width: auto;\n}\n\n.btn-group > .btn:not(:first-child),\n.btn-group > .btn-group:not(:first-child) {\n  margin-left: -1px;\n}\n\n.btn-group > .btn:not(:last-child):not(.dropdown-toggle),\n.btn-group > .btn-group:not(:last-child) > .btn {\n  border-top-right-radius: 0;\n  border-bottom-right-radius: 0;\n}\n\n.btn-group > .btn:not(:first-child),\n.btn-group > .btn-group:not(:first-child) > .btn {\n  border-top-left-radius: 0;\n  border-bottom-left-radius: 0;\n}\n\n.dropdown-toggle-split {\n  padding-right: 0.5625rem;\n  padding-left: 0.5625rem;\n}\n\n.dropdown-toggle-split::after,\n.dropup .dropdown-toggle-split::after,\n.dropright .dropdown-toggle-split::after {\n  margin-left: 0;\n}\n\n.dropleft .dropdown-toggle-split::before {\n  margin-right: 0;\n}\n\n.btn-sm + .dropdown-toggle-split, .btn-group-sm > .btn + .dropdown-toggle-split {\n  padding-right: 0.375rem;\n  padding-left: 0.375rem;\n}\n\n.btn-lg + .dropdown-toggle-split, .btn-group-lg > .btn + .dropdown-toggle-split {\n  padding-right: 0.75rem;\n  padding-left: 0.75rem;\n}\n\n.btn-group-vertical {\n  -ms-flex-direction: column;\n  flex-direction: column;\n  -ms-flex-align: start;\n  align-items: flex-start;\n  -ms-flex-pack: center;\n  justify-content: center;\n}\n\n.btn-group-vertical > .btn,\n.btn-group-vertical > .btn-group {\n  width: 100%;\n}\n\n.btn-group-vertical > .btn:not(:first-child),\n.btn-group-vertical > .btn-group:not(:first-child) {\n  margin-top: -1px;\n}\n\n.btn-group-vertical > .btn:not(:last-child):not(.dropdown-toggle),\n.btn-group-vertical > .btn-group:not(:last-child) > .btn {\n  border-bottom-right-radius: 0;\n  border-bottom-left-radius: 0;\n}\n\n.btn-group-vertical > .btn:not(:first-child),\n.btn-group-vertical > .btn-group:not(:first-child) > .btn {\n  border-top-left-radius: 0;\n  border-top-right-radius: 0;\n}\n\n.btn-group-toggle > .btn,\n.btn-group-toggle > .btn-group > .btn {\n  margin-bottom: 0;\n}\n\n.btn-group-toggle > .btn input[type=\"radio\"],\n.btn-group-toggle > .btn input[type=\"checkbox\"],\n.btn-group-toggle > .btn-group > .btn input[type=\"radio\"],\n.btn-group-toggle > .btn-group > .btn input[type=\"checkbox\"] {\n  position: absolute;\n  clip: rect(0, 0, 0, 0);\n  pointer-events: none;\n}\n\n.input-group {\n  position: relative;\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-wrap: wrap;\n  flex-wrap: wrap;\n  -ms-flex-align: stretch;\n  align-items: stretch;\n  width: 100%;\n}\n\n.input-group > .form-control,\n.input-group > .form-control-plaintext,\n.input-group > .custom-select,\n.input-group > .custom-file {\n  position: relative;\n  -ms-flex: 1 1 auto;\n  flex: 1 1 auto;\n  width: 1%;\n  margin-bottom: 0;\n}\n\n.input-group > .form-control + .form-control,\n.input-group > .form-control + .custom-select,\n.input-group > .form-control + .custom-file,\n.input-group > .form-control-plaintext + .form-control,\n.input-group > .form-control-plaintext + .custom-select,\n.input-group > .form-control-plaintext + .custom-file,\n.input-group > .custom-select + .form-control,\n.input-group > .custom-select + .custom-select,\n.input-group > .custom-select + .custom-file,\n.input-group > .custom-file + .form-control,\n.input-group > .custom-file + .custom-select,\n.input-group > .custom-file + .custom-file {\n  margin-left: -1px;\n}\n\n.input-group > .form-control:focus,\n.input-group > .custom-select:focus,\n.input-group > .custom-file .custom-file-input:focus ~ .custom-file-label {\n  z-index: 3;\n}\n\n.input-group > .custom-file .custom-file-input:focus {\n  z-index: 4;\n}\n\n.input-group > .form-control:not(:last-child),\n.input-group > .custom-select:not(:last-child) {\n  border-top-right-radius: 0;\n  border-bottom-right-radius: 0;\n}\n\n.input-group > .form-control:not(:first-child),\n.input-group > .custom-select:not(:first-child) {\n  border-top-left-radius: 0;\n  border-bottom-left-radius: 0;\n}\n\n.input-group > .custom-file {\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-align: center;\n  align-items: center;\n}\n\n.input-group > .custom-file:not(:last-child) .custom-file-label,\n.input-group > .custom-file:not(:last-child) .custom-file-label::after {\n  border-top-right-radius: 0;\n  border-bottom-right-radius: 0;\n}\n\n.input-group > .custom-file:not(:first-child) .custom-file-label {\n  border-top-left-radius: 0;\n  border-bottom-left-radius: 0;\n}\n\n.input-group-prepend,\n.input-group-append {\n  display: -ms-flexbox;\n  display: flex;\n}\n\n.input-group-prepend .btn,\n.input-group-append .btn {\n  position: relative;\n  z-index: 2;\n}\n\n.input-group-prepend .btn:focus,\n.input-group-append .btn:focus {\n  z-index: 3;\n}\n\n.input-group-prepend .btn + .btn,\n.input-group-prepend .btn + .input-group-text,\n.input-group-prepend .input-group-text + .input-group-text,\n.input-group-prepend .input-group-text + .btn,\n.input-group-append .btn + .btn,\n.input-group-append .btn + .input-group-text,\n.input-group-append .input-group-text + .input-group-text,\n.input-group-append .input-group-text + .btn {\n  margin-left: -1px;\n}\n\n.input-group-prepend {\n  margin-right: -1px;\n}\n\n.input-group-append {\n  margin-left: -1px;\n}\n\n.input-group-text {\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-align: center;\n  align-items: center;\n  padding: 0.375rem 0.75rem;\n  margin-bottom: 0;\n  font-size: 1rem;\n  font-weight: 400;\n  line-height: 1.5;\n  color: #495057;\n  text-align: center;\n  white-space: nowrap;\n  background-color: #e9ecef;\n  border: 1px solid #ced4da;\n  border-radius: 0.25rem;\n}\n\n.input-group-text input[type=\"radio\"],\n.input-group-text input[type=\"checkbox\"] {\n  margin-top: 0;\n}\n\n.input-group-lg > .form-control:not(textarea),\n.input-group-lg > .custom-select {\n  height: calc(1.5em + 1rem + 2px);\n}\n\n.input-group-lg > .form-control,\n.input-group-lg > .custom-select,\n.input-group-lg > .input-group-prepend > .input-group-text,\n.input-group-lg > .input-group-append > .input-group-text,\n.input-group-lg > .input-group-prepend > .btn,\n.input-group-lg > .input-group-append > .btn {\n  padding: 0.5rem 1rem;\n  font-size: 1.25rem;\n  line-height: 1.5;\n  border-radius: 0.3rem;\n}\n\n.input-group-sm > .form-control:not(textarea),\n.input-group-sm > .custom-select {\n  height: calc(1.5em + 0.5rem + 2px);\n}\n\n.input-group-sm > .form-control,\n.input-group-sm > .custom-select,\n.input-group-sm > .input-group-prepend > .input-group-text,\n.input-group-sm > .input-group-append > .input-group-text,\n.input-group-sm > .input-group-prepend > .btn,\n.input-group-sm > .input-group-append > .btn {\n  padding: 0.25rem 0.5rem;\n  font-size: 0.875rem;\n  line-height: 1.5;\n  border-radius: 0.2rem;\n}\n\n.input-group-lg > .custom-select,\n.input-group-sm > .custom-select {\n  padding-right: 1.75rem;\n}\n\n.input-group > .input-group-prepend > .btn,\n.input-group > .input-group-prepend > .input-group-text,\n.input-group > .input-group-append:not(:last-child) > .btn,\n.input-group > .input-group-append:not(:last-child) > .input-group-text,\n.input-group > .input-group-append:last-child > .btn:not(:last-child):not(.dropdown-toggle),\n.input-group > .input-group-append:last-child > .input-group-text:not(:last-child) {\n  border-top-right-radius: 0;\n  border-bottom-right-radius: 0;\n}\n\n.input-group > .input-group-append > .btn,\n.input-group > .input-group-append > .input-group-text,\n.input-group > .input-group-prepend:not(:first-child) > .btn,\n.input-group > .input-group-prepend:not(:first-child) > .input-group-text,\n.input-group > .input-group-prepend:first-child > .btn:not(:first-child),\n.input-group > .input-group-prepend:first-child > .input-group-text:not(:first-child) {\n  border-top-left-radius: 0;\n  border-bottom-left-radius: 0;\n}\n\n.custom-control {\n  position: relative;\n  display: block;\n  min-height: 1.5rem;\n  padding-left: 1.5rem;\n}\n\n.custom-control-inline {\n  display: -ms-inline-flexbox;\n  display: inline-flex;\n  margin-right: 1rem;\n}\n\n.custom-control-input {\n  position: absolute;\n  z-index: -1;\n  opacity: 0;\n}\n\n.custom-control-input:checked ~ .custom-control-label::before {\n  color: #fff;\n  border-color: #007bff;\n  background-color: #007bff;\n}\n\n.custom-control-input:focus ~ .custom-control-label::before {\n  box-shadow: 0 0 0 0.2rem rgba(0, 123, 255, 0.25);\n}\n\n.custom-control-input:focus:not(:checked) ~ .custom-control-label::before {\n  border-color: #80bdff;\n}\n\n.custom-control-input:not(:disabled):active ~ .custom-control-label::before {\n  color: #fff;\n  background-color: #b3d7ff;\n  border-color: #b3d7ff;\n}\n\n.custom-control-input:disabled ~ .custom-control-label {\n  color: #6c757d;\n}\n\n.custom-control-input:disabled ~ .custom-control-label::before {\n  background-color: #e9ecef;\n}\n\n.custom-control-label {\n  position: relative;\n  margin-bottom: 0;\n  vertical-align: top;\n}\n\n.custom-control-label::before {\n  position: absolute;\n  top: 0.25rem;\n  left: -1.5rem;\n  display: block;\n  width: 1rem;\n  height: 1rem;\n  pointer-events: none;\n  content: \"\";\n  background-color: #fff;\n  border: #adb5bd solid 1px;\n}\n\n.custom-control-label::after {\n  position: absolute;\n  top: 0.25rem;\n  left: -1.5rem;\n  display: block;\n  width: 1rem;\n  height: 1rem;\n  content: \"\";\n  background: no-repeat 50% / 50% 50%;\n}\n\n.custom-checkbox .custom-control-label::before {\n  border-radius: 0.25rem;\n}\n\n.custom-checkbox .custom-control-input:checked ~ .custom-control-label::after {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 8 8'%3e%3cpath fill='%23fff' d='M6.564.75l-3.59 3.612-1.538-1.55L0 4.26 2.974 7.25 8 2.193z'/%3e%3c/svg%3e\");\n}\n\n.custom-checkbox .custom-control-input:indeterminate ~ .custom-control-label::before {\n  border-color: #007bff;\n  background-color: #007bff;\n}\n\n.custom-checkbox .custom-control-input:indeterminate ~ .custom-control-label::after {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 4 4'%3e%3cpath stroke='%23fff' d='M0 2h4'/%3e%3c/svg%3e\");\n}\n\n.custom-checkbox .custom-control-input:disabled:checked ~ .custom-control-label::before {\n  background-color: rgba(0, 123, 255, 0.5);\n}\n\n.custom-checkbox .custom-control-input:disabled:indeterminate ~ .custom-control-label::before {\n  background-color: rgba(0, 123, 255, 0.5);\n}\n\n.custom-radio .custom-control-label::before {\n  border-radius: 50%;\n}\n\n.custom-radio .custom-control-input:checked ~ .custom-control-label::after {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='-4 -4 8 8'%3e%3ccircle r='3' fill='%23fff'/%3e%3c/svg%3e\");\n}\n\n.custom-radio .custom-control-input:disabled:checked ~ .custom-control-label::before {\n  background-color: rgba(0, 123, 255, 0.5);\n}\n\n.custom-switch {\n  padding-left: 2.25rem;\n}\n\n.custom-switch .custom-control-label::before {\n  left: -2.25rem;\n  width: 1.75rem;\n  pointer-events: all;\n  border-radius: 0.5rem;\n}\n\n.custom-switch .custom-control-label::after {\n  top: calc(0.25rem + 2px);\n  left: calc(-2.25rem + 2px);\n  width: calc(1rem - 4px);\n  height: calc(1rem - 4px);\n  background-color: #adb5bd;\n  border-radius: 0.5rem;\n  transition: background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out, -webkit-transform 0.15s ease-in-out;\n  transition: transform 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n  transition: transform 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out, -webkit-transform 0.15s ease-in-out;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .custom-switch .custom-control-label::after {\n    transition: none;\n  }\n}\n\n.custom-switch .custom-control-input:checked ~ .custom-control-label::after {\n  background-color: #fff;\n  -webkit-transform: translateX(0.75rem);\n  transform: translateX(0.75rem);\n}\n\n.custom-switch .custom-control-input:disabled:checked ~ .custom-control-label::before {\n  background-color: rgba(0, 123, 255, 0.5);\n}\n\n.custom-select {\n  display: inline-block;\n  width: 100%;\n  height: calc(1.5em + 0.75rem + 2px);\n  padding: 0.375rem 1.75rem 0.375rem 0.75rem;\n  font-size: 1rem;\n  font-weight: 400;\n  line-height: 1.5;\n  color: #495057;\n  vertical-align: middle;\n  background: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 4 5'%3e%3cpath fill='%23343a40' d='M2 0L0 2h4zm0 5L0 3h4z'/%3e%3c/svg%3e\") no-repeat right 0.75rem center/8px 10px;\n  background-color: #fff;\n  border: 1px solid #ced4da;\n  border-radius: 0.25rem;\n  -webkit-appearance: none;\n  -moz-appearance: none;\n  appearance: none;\n}\n\n.custom-select:focus {\n  border-color: #80bdff;\n  outline: 0;\n  box-shadow: 0 0 0 0.2rem rgba(0, 123, 255, 0.25);\n}\n\n.custom-select:focus::-ms-value {\n  color: #495057;\n  background-color: #fff;\n}\n\n.custom-select[multiple], .custom-select[size]:not([size=\"1\"]) {\n  height: auto;\n  padding-right: 0.75rem;\n  background-image: none;\n}\n\n.custom-select:disabled {\n  color: #6c757d;\n  background-color: #e9ecef;\n}\n\n.custom-select::-ms-expand {\n  display: none;\n}\n\n.custom-select-sm {\n  height: calc(1.5em + 0.5rem + 2px);\n  padding-top: 0.25rem;\n  padding-bottom: 0.25rem;\n  padding-left: 0.5rem;\n  font-size: 0.875rem;\n}\n\n.custom-select-lg {\n  height: calc(1.5em + 1rem + 2px);\n  padding-top: 0.5rem;\n  padding-bottom: 0.5rem;\n  padding-left: 1rem;\n  font-size: 1.25rem;\n}\n\n.custom-file {\n  position: relative;\n  display: inline-block;\n  width: 100%;\n  height: calc(1.5em + 0.75rem + 2px);\n  margin-bottom: 0;\n}\n\n.custom-file-input {\n  position: relative;\n  z-index: 2;\n  width: 100%;\n  height: calc(1.5em + 0.75rem + 2px);\n  margin: 0;\n  opacity: 0;\n}\n\n.custom-file-input:focus ~ .custom-file-label {\n  border-color: #80bdff;\n  box-shadow: 0 0 0 0.2rem rgba(0, 123, 255, 0.25);\n}\n\n.custom-file-input:disabled ~ .custom-file-label {\n  background-color: #e9ecef;\n}\n\n.custom-file-input:lang(en) ~ .custom-file-label::after {\n  content: \"Browse\";\n}\n\n.custom-file-input ~ .custom-file-label[data-browse]::after {\n  content: attr(data-browse);\n}\n\n.custom-file-label {\n  position: absolute;\n  top: 0;\n  right: 0;\n  left: 0;\n  z-index: 1;\n  height: calc(1.5em + 0.75rem + 2px);\n  padding: 0.375rem 0.75rem;\n  font-weight: 400;\n  line-height: 1.5;\n  color: #495057;\n  background-color: #fff;\n  border: 1px solid #ced4da;\n  border-radius: 0.25rem;\n}\n\n.custom-file-label::after {\n  position: absolute;\n  top: 0;\n  right: 0;\n  bottom: 0;\n  z-index: 3;\n  display: block;\n  height: calc(1.5em + 0.75rem);\n  padding: 0.375rem 0.75rem;\n  line-height: 1.5;\n  color: #495057;\n  content: \"Browse\";\n  background-color: #e9ecef;\n  border-left: inherit;\n  border-radius: 0 0.25rem 0.25rem 0;\n}\n\n.custom-range {\n  width: 100%;\n  height: calc(1rem + 0.4rem);\n  padding: 0;\n  background-color: transparent;\n  -webkit-appearance: none;\n  -moz-appearance: none;\n  appearance: none;\n}\n\n.custom-range:focus {\n  outline: none;\n}\n\n.custom-range:focus::-webkit-slider-thumb {\n  box-shadow: 0 0 0 1px #fff, 0 0 0 0.2rem rgba(0, 123, 255, 0.25);\n}\n\n.custom-range:focus::-moz-range-thumb {\n  box-shadow: 0 0 0 1px #fff, 0 0 0 0.2rem rgba(0, 123, 255, 0.25);\n}\n\n.custom-range:focus::-ms-thumb {\n  box-shadow: 0 0 0 1px #fff, 0 0 0 0.2rem rgba(0, 123, 255, 0.25);\n}\n\n.custom-range::-moz-focus-outer {\n  border: 0;\n}\n\n.custom-range::-webkit-slider-thumb {\n  width: 1rem;\n  height: 1rem;\n  margin-top: -0.25rem;\n  background-color: #007bff;\n  border: 0;\n  border-radius: 1rem;\n  transition: background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n  -webkit-appearance: none;\n  appearance: none;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .custom-range::-webkit-slider-thumb {\n    transition: none;\n  }\n}\n\n.custom-range::-webkit-slider-thumb:active {\n  background-color: #b3d7ff;\n}\n\n.custom-range::-webkit-slider-runnable-track {\n  width: 100%;\n  height: 0.5rem;\n  color: transparent;\n  cursor: pointer;\n  background-color: #dee2e6;\n  border-color: transparent;\n  border-radius: 1rem;\n}\n\n.custom-range::-moz-range-thumb {\n  width: 1rem;\n  height: 1rem;\n  background-color: #007bff;\n  border: 0;\n  border-radius: 1rem;\n  transition: background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n  -moz-appearance: none;\n  appearance: none;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .custom-range::-moz-range-thumb {\n    transition: none;\n  }\n}\n\n.custom-range::-moz-range-thumb:active {\n  background-color: #b3d7ff;\n}\n\n.custom-range::-moz-range-track {\n  width: 100%;\n  height: 0.5rem;\n  color: transparent;\n  cursor: pointer;\n  background-color: #dee2e6;\n  border-color: transparent;\n  border-radius: 1rem;\n}\n\n.custom-range::-ms-thumb {\n  width: 1rem;\n  height: 1rem;\n  margin-top: 0;\n  margin-right: 0.2rem;\n  margin-left: 0.2rem;\n  background-color: #007bff;\n  border: 0;\n  border-radius: 1rem;\n  transition: background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n  appearance: none;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .custom-range::-ms-thumb {\n    transition: none;\n  }\n}\n\n.custom-range::-ms-thumb:active {\n  background-color: #b3d7ff;\n}\n\n.custom-range::-ms-track {\n  width: 100%;\n  height: 0.5rem;\n  color: transparent;\n  cursor: pointer;\n  background-color: transparent;\n  border-color: transparent;\n  border-width: 0.5rem;\n}\n\n.custom-range::-ms-fill-lower {\n  background-color: #dee2e6;\n  border-radius: 1rem;\n}\n\n.custom-range::-ms-fill-upper {\n  margin-right: 15px;\n  background-color: #dee2e6;\n  border-radius: 1rem;\n}\n\n.custom-range:disabled::-webkit-slider-thumb {\n  background-color: #adb5bd;\n}\n\n.custom-range:disabled::-webkit-slider-runnable-track {\n  cursor: default;\n}\n\n.custom-range:disabled::-moz-range-thumb {\n  background-color: #adb5bd;\n}\n\n.custom-range:disabled::-moz-range-track {\n  cursor: default;\n}\n\n.custom-range:disabled::-ms-thumb {\n  background-color: #adb5bd;\n}\n\n.custom-control-label::before,\n.custom-file-label,\n.custom-select {\n  transition: background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .custom-control-label::before,\n  .custom-file-label,\n  .custom-select {\n    transition: none;\n  }\n}\n\n.nav {\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-wrap: wrap;\n  flex-wrap: wrap;\n  padding-left: 0;\n  margin-bottom: 0;\n  list-style: none;\n}\n\n.nav-link {\n  display: block;\n  padding: 0.5rem 1rem;\n}\n\n.nav-link:hover, .nav-link:focus {\n  text-decoration: none;\n}\n\n.nav-link.disabled {\n  color: #6c757d;\n  pointer-events: none;\n  cursor: default;\n}\n\n.nav-tabs {\n  border-bottom: 1px solid #dee2e6;\n}\n\n.nav-tabs .nav-item {\n  margin-bottom: -1px;\n}\n\n.nav-tabs .nav-link {\n  border: 1px solid transparent;\n  border-top-left-radius: 0.25rem;\n  border-top-right-radius: 0.25rem;\n}\n\n.nav-tabs .nav-link:hover, .nav-tabs .nav-link:focus {\n  border-color: #e9ecef #e9ecef #dee2e6;\n}\n\n.nav-tabs .nav-link.disabled {\n  color: #6c757d;\n  background-color: transparent;\n  border-color: transparent;\n}\n\n.nav-tabs .nav-link.active,\n.nav-tabs .nav-item.show .nav-link {\n  color: #495057;\n  background-color: #fff;\n  border-color: #dee2e6 #dee2e6 #fff;\n}\n\n.nav-tabs .dropdown-menu {\n  margin-top: -1px;\n  border-top-left-radius: 0;\n  border-top-right-radius: 0;\n}\n\n.nav-pills .nav-link {\n  border-radius: 0.25rem;\n}\n\n.nav-pills .nav-link.active,\n.nav-pills .show > .nav-link {\n  color: #fff;\n  background-color: #007bff;\n}\n\n.nav-fill .nav-item {\n  -ms-flex: 1 1 auto;\n  flex: 1 1 auto;\n  text-align: center;\n}\n\n.nav-justified .nav-item {\n  -ms-flex-preferred-size: 0;\n  flex-basis: 0;\n  -ms-flex-positive: 1;\n  flex-grow: 1;\n  text-align: center;\n}\n\n.tab-content > .tab-pane {\n  display: none;\n}\n\n.tab-content > .active {\n  display: block;\n}\n\n.navbar {\n  position: relative;\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-wrap: wrap;\n  flex-wrap: wrap;\n  -ms-flex-align: center;\n  align-items: center;\n  -ms-flex-pack: justify;\n  justify-content: space-between;\n  padding: 0.5rem 1rem;\n}\n\n.navbar > .container,\n.navbar > .container-fluid {\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-wrap: wrap;\n  flex-wrap: wrap;\n  -ms-flex-align: center;\n  align-items: center;\n  -ms-flex-pack: justify;\n  justify-content: space-between;\n}\n\n.navbar-brand {\n  display: inline-block;\n  padding-top: 0.3125rem;\n  padding-bottom: 0.3125rem;\n  margin-right: 1rem;\n  font-size: 1.25rem;\n  line-height: inherit;\n  white-space: nowrap;\n}\n\n.navbar-brand:hover, .navbar-brand:focus {\n  text-decoration: none;\n}\n\n.navbar-nav {\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-direction: column;\n  flex-direction: column;\n  padding-left: 0;\n  margin-bottom: 0;\n  list-style: none;\n}\n\n.navbar-nav .nav-link {\n  padding-right: 0;\n  padding-left: 0;\n}\n\n.navbar-nav .dropdown-menu {\n  position: static;\n  float: none;\n}\n\n.navbar-text {\n  display: inline-block;\n  padding-top: 0.5rem;\n  padding-bottom: 0.5rem;\n}\n\n.navbar-collapse {\n  -ms-flex-preferred-size: 100%;\n  flex-basis: 100%;\n  -ms-flex-positive: 1;\n  flex-grow: 1;\n  -ms-flex-align: center;\n  align-items: center;\n}\n\n.navbar-toggler {\n  padding: 0.25rem 0.75rem;\n  font-size: 1.25rem;\n  line-height: 1;\n  background-color: transparent;\n  border: 1px solid transparent;\n  border-radius: 0.25rem;\n}\n\n.navbar-toggler:hover, .navbar-toggler:focus {\n  text-decoration: none;\n}\n\n.navbar-toggler-icon {\n  display: inline-block;\n  width: 1.5em;\n  height: 1.5em;\n  vertical-align: middle;\n  content: \"\";\n  background: no-repeat center center;\n  background-size: 100% 100%;\n}\n\n@media (max-width: 575.98px) {\n  .navbar-expand-sm > .container,\n  .navbar-expand-sm > .container-fluid {\n    padding-right: 0;\n    padding-left: 0;\n  }\n}\n\n@media (min-width: 576px) {\n  .navbar-expand-sm {\n    -ms-flex-flow: row nowrap;\n    flex-flow: row nowrap;\n    -ms-flex-pack: start;\n    justify-content: flex-start;\n  }\n  .navbar-expand-sm .navbar-nav {\n    -ms-flex-direction: row;\n    flex-direction: row;\n  }\n  .navbar-expand-sm .navbar-nav .dropdown-menu {\n    position: absolute;\n  }\n  .navbar-expand-sm .navbar-nav .nav-link {\n    padding-right: 0.5rem;\n    padding-left: 0.5rem;\n  }\n  .navbar-expand-sm > .container,\n  .navbar-expand-sm > .container-fluid {\n    -ms-flex-wrap: nowrap;\n    flex-wrap: nowrap;\n  }\n  .navbar-expand-sm .navbar-collapse {\n    display: -ms-flexbox !important;\n    display: flex !important;\n    -ms-flex-preferred-size: auto;\n    flex-basis: auto;\n  }\n  .navbar-expand-sm .navbar-toggler {\n    display: none;\n  }\n}\n\n@media (max-width: 767.98px) {\n  .navbar-expand-md > .container,\n  .navbar-expand-md > .container-fluid {\n    padding-right: 0;\n    padding-left: 0;\n  }\n}\n\n@media (min-width: 768px) {\n  .navbar-expand-md {\n    -ms-flex-flow: row nowrap;\n    flex-flow: row nowrap;\n    -ms-flex-pack: start;\n    justify-content: flex-start;\n  }\n  .navbar-expand-md .navbar-nav {\n    -ms-flex-direction: row;\n    flex-direction: row;\n  }\n  .navbar-expand-md .navbar-nav .dropdown-menu {\n    position: absolute;\n  }\n  .navbar-expand-md .navbar-nav .nav-link {\n    padding-right: 0.5rem;\n    padding-left: 0.5rem;\n  }\n  .navbar-expand-md > .container,\n  .navbar-expand-md > .container-fluid {\n    -ms-flex-wrap: nowrap;\n    flex-wrap: nowrap;\n  }\n  .navbar-expand-md .navbar-collapse {\n    display: -ms-flexbox !important;\n    display: flex !important;\n    -ms-flex-preferred-size: auto;\n    flex-basis: auto;\n  }\n  .navbar-expand-md .navbar-toggler {\n    display: none;\n  }\n}\n\n@media (max-width: 991.98px) {\n  .navbar-expand-lg > .container,\n  .navbar-expand-lg > .container-fluid {\n    padding-right: 0;\n    padding-left: 0;\n  }\n}\n\n@media (min-width: 992px) {\n  .navbar-expand-lg {\n    -ms-flex-flow: row nowrap;\n    flex-flow: row nowrap;\n    -ms-flex-pack: start;\n    justify-content: flex-start;\n  }\n  .navbar-expand-lg .navbar-nav {\n    -ms-flex-direction: row;\n    flex-direction: row;\n  }\n  .navbar-expand-lg .navbar-nav .dropdown-menu {\n    position: absolute;\n  }\n  .navbar-expand-lg .navbar-nav .nav-link {\n    padding-right: 0.5rem;\n    padding-left: 0.5rem;\n  }\n  .navbar-expand-lg > .container,\n  .navbar-expand-lg > .container-fluid {\n    -ms-flex-wrap: nowrap;\n    flex-wrap: nowrap;\n  }\n  .navbar-expand-lg .navbar-collapse {\n    display: -ms-flexbox !important;\n    display: flex !important;\n    -ms-flex-preferred-size: auto;\n    flex-basis: auto;\n  }\n  .navbar-expand-lg .navbar-toggler {\n    display: none;\n  }\n}\n\n@media (max-width: 1199.98px) {\n  .navbar-expand-xl > .container,\n  .navbar-expand-xl > .container-fluid {\n    padding-right: 0;\n    padding-left: 0;\n  }\n}\n\n@media (min-width: 1200px) {\n  .navbar-expand-xl {\n    -ms-flex-flow: row nowrap;\n    flex-flow: row nowrap;\n    -ms-flex-pack: start;\n    justify-content: flex-start;\n  }\n  .navbar-expand-xl .navbar-nav {\n    -ms-flex-direction: row;\n    flex-direction: row;\n  }\n  .navbar-expand-xl .navbar-nav .dropdown-menu {\n    position: absolute;\n  }\n  .navbar-expand-xl .navbar-nav .nav-link {\n    padding-right: 0.5rem;\n    padding-left: 0.5rem;\n  }\n  .navbar-expand-xl > .container,\n  .navbar-expand-xl > .container-fluid {\n    -ms-flex-wrap: nowrap;\n    flex-wrap: nowrap;\n  }\n  .navbar-expand-xl .navbar-collapse {\n    display: -ms-flexbox !important;\n    display: flex !important;\n    -ms-flex-preferred-size: auto;\n    flex-basis: auto;\n  }\n  .navbar-expand-xl .navbar-toggler {\n    display: none;\n  }\n}\n\n.navbar-expand {\n  -ms-flex-flow: row nowrap;\n  flex-flow: row nowrap;\n  -ms-flex-pack: start;\n  justify-content: flex-start;\n}\n\n.navbar-expand > .container,\n.navbar-expand > .container-fluid {\n  padding-right: 0;\n  padding-left: 0;\n}\n\n.navbar-expand .navbar-nav {\n  -ms-flex-direction: row;\n  flex-direction: row;\n}\n\n.navbar-expand .navbar-nav .dropdown-menu {\n  position: absolute;\n}\n\n.navbar-expand .navbar-nav .nav-link {\n  padding-right: 0.5rem;\n  padding-left: 0.5rem;\n}\n\n.navbar-expand > .container,\n.navbar-expand > .container-fluid {\n  -ms-flex-wrap: nowrap;\n  flex-wrap: nowrap;\n}\n\n.navbar-expand .navbar-collapse {\n  display: -ms-flexbox !important;\n  display: flex !important;\n  -ms-flex-preferred-size: auto;\n  flex-basis: auto;\n}\n\n.navbar-expand .navbar-toggler {\n  display: none;\n}\n\n.navbar-light .navbar-brand {\n  color: rgba(0, 0, 0, 0.9);\n}\n\n.navbar-light .navbar-brand:hover, .navbar-light .navbar-brand:focus {\n  color: rgba(0, 0, 0, 0.9);\n}\n\n.navbar-light .navbar-nav .nav-link {\n  color: rgba(0, 0, 0, 0.5);\n}\n\n.navbar-light .navbar-nav .nav-link:hover, .navbar-light .navbar-nav .nav-link:focus {\n  color: rgba(0, 0, 0, 0.7);\n}\n\n.navbar-light .navbar-nav .nav-link.disabled {\n  color: rgba(0, 0, 0, 0.3);\n}\n\n.navbar-light .navbar-nav .show > .nav-link,\n.navbar-light .navbar-nav .active > .nav-link,\n.navbar-light .navbar-nav .nav-link.show,\n.navbar-light .navbar-nav .nav-link.active {\n  color: rgba(0, 0, 0, 0.9);\n}\n\n.navbar-light .navbar-toggler {\n  color: rgba(0, 0, 0, 0.5);\n  border-color: rgba(0, 0, 0, 0.1);\n}\n\n.navbar-light .navbar-toggler-icon {\n  background-image: url(\"data:image/svg+xml,%3csvg viewBox='0 0 30 30' xmlns='http://www.w3.org/2000/svg'%3e%3cpath stroke='rgba(0, 0, 0, 0.5)' stroke-width='2' stroke-linecap='round' stroke-miterlimit='10' d='M4 7h22M4 15h22M4 23h22'/%3e%3c/svg%3e\");\n}\n\n.navbar-light .navbar-text {\n  color: rgba(0, 0, 0, 0.5);\n}\n\n.navbar-light .navbar-text a {\n  color: rgba(0, 0, 0, 0.9);\n}\n\n.navbar-light .navbar-text a:hover, .navbar-light .navbar-text a:focus {\n  color: rgba(0, 0, 0, 0.9);\n}\n\n.navbar-dark .navbar-brand {\n  color: #fff;\n}\n\n.navbar-dark .navbar-brand:hover, .navbar-dark .navbar-brand:focus {\n  color: #fff;\n}\n\n.navbar-dark .navbar-nav .nav-link {\n  color: rgba(255, 255, 255, 0.5);\n}\n\n.navbar-dark .navbar-nav .nav-link:hover, .navbar-dark .navbar-nav .nav-link:focus {\n  color: rgba(255, 255, 255, 0.75);\n}\n\n.navbar-dark .navbar-nav .nav-link.disabled {\n  color: rgba(255, 255, 255, 0.25);\n}\n\n.navbar-dark .navbar-nav .show > .nav-link,\n.navbar-dark .navbar-nav .active > .nav-link,\n.navbar-dark .navbar-nav .nav-link.show,\n.navbar-dark .navbar-nav .nav-link.active {\n  color: #fff;\n}\n\n.navbar-dark .navbar-toggler {\n  color: rgba(255, 255, 255, 0.5);\n  border-color: rgba(255, 255, 255, 0.1);\n}\n\n.navbar-dark .navbar-toggler-icon {\n  background-image: url(\"data:image/svg+xml,%3csvg viewBox='0 0 30 30' xmlns='http://www.w3.org/2000/svg'%3e%3cpath stroke='rgba(255, 255, 255, 0.5)' stroke-width='2' stroke-linecap='round' stroke-miterlimit='10' d='M4 7h22M4 15h22M4 23h22'/%3e%3c/svg%3e\");\n}\n\n.navbar-dark .navbar-text {\n  color: rgba(255, 255, 255, 0.5);\n}\n\n.navbar-dark .navbar-text a {\n  color: #fff;\n}\n\n.navbar-dark .navbar-text a:hover, .navbar-dark .navbar-text a:focus {\n  color: #fff;\n}\n\n.card {\n  position: relative;\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-direction: column;\n  flex-direction: column;\n  min-width: 0;\n  word-wrap: break-word;\n  background-color: #fff;\n  background-clip: border-box;\n  border: 1px solid rgba(0, 0, 0, 0.125);\n  border-radius: 0.25rem;\n}\n\n.card > hr {\n  margin-right: 0;\n  margin-left: 0;\n}\n\n.card > .list-group:first-child .list-group-item:first-child {\n  border-top-left-radius: 0.25rem;\n  border-top-right-radius: 0.25rem;\n}\n\n.card > .list-group:last-child .list-group-item:last-child {\n  border-bottom-right-radius: 0.25rem;\n  border-bottom-left-radius: 0.25rem;\n}\n\n.card-body {\n  -ms-flex: 1 1 auto;\n  flex: 1 1 auto;\n  padding: 1.25rem;\n}\n\n.card-title {\n  margin-bottom: 0.75rem;\n}\n\n.card-subtitle {\n  margin-top: -0.375rem;\n  margin-bottom: 0;\n}\n\n.card-text:last-child {\n  margin-bottom: 0;\n}\n\n.card-link:hover {\n  text-decoration: none;\n}\n\n.card-link + .card-link {\n  margin-left: 1.25rem;\n}\n\n.card-header {\n  padding: 0.75rem 1.25rem;\n  margin-bottom: 0;\n  background-color: rgba(0, 0, 0, 0.03);\n  border-bottom: 1px solid rgba(0, 0, 0, 0.125);\n}\n\n.card-header:first-child {\n  border-radius: calc(0.25rem - 1px) calc(0.25rem - 1px) 0 0;\n}\n\n.card-header + .list-group .list-group-item:first-child {\n  border-top: 0;\n}\n\n.card-footer {\n  padding: 0.75rem 1.25rem;\n  background-color: rgba(0, 0, 0, 0.03);\n  border-top: 1px solid rgba(0, 0, 0, 0.125);\n}\n\n.card-footer:last-child {\n  border-radius: 0 0 calc(0.25rem - 1px) calc(0.25rem - 1px);\n}\n\n.card-header-tabs {\n  margin-right: -0.625rem;\n  margin-bottom: -0.75rem;\n  margin-left: -0.625rem;\n  border-bottom: 0;\n}\n\n.card-header-pills {\n  margin-right: -0.625rem;\n  margin-left: -0.625rem;\n}\n\n.card-img-overlay {\n  position: absolute;\n  top: 0;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  padding: 1.25rem;\n}\n\n.card-img {\n  width: 100%;\n  border-radius: calc(0.25rem - 1px);\n}\n\n.card-img-top {\n  width: 100%;\n  border-top-left-radius: calc(0.25rem - 1px);\n  border-top-right-radius: calc(0.25rem - 1px);\n}\n\n.card-img-bottom {\n  width: 100%;\n  border-bottom-right-radius: calc(0.25rem - 1px);\n  border-bottom-left-radius: calc(0.25rem - 1px);\n}\n\n.card-deck {\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-direction: column;\n  flex-direction: column;\n}\n\n.card-deck .card {\n  margin-bottom: 15px;\n}\n\n@media (min-width: 576px) {\n  .card-deck {\n    -ms-flex-flow: row wrap;\n    flex-flow: row wrap;\n    margin-right: -15px;\n    margin-left: -15px;\n  }\n  .card-deck .card {\n    display: -ms-flexbox;\n    display: flex;\n    -ms-flex: 1 0 0%;\n    flex: 1 0 0%;\n    -ms-flex-direction: column;\n    flex-direction: column;\n    margin-right: 15px;\n    margin-bottom: 0;\n    margin-left: 15px;\n  }\n}\n\n.card-group {\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-direction: column;\n  flex-direction: column;\n}\n\n.card-group > .card {\n  margin-bottom: 15px;\n}\n\n@media (min-width: 576px) {\n  .card-group {\n    -ms-flex-flow: row wrap;\n    flex-flow: row wrap;\n  }\n  .card-group > .card {\n    -ms-flex: 1 0 0%;\n    flex: 1 0 0%;\n    margin-bottom: 0;\n  }\n  .card-group > .card + .card {\n    margin-left: 0;\n    border-left: 0;\n  }\n  .card-group > .card:not(:last-child) {\n    border-top-right-radius: 0;\n    border-bottom-right-radius: 0;\n  }\n  .card-group > .card:not(:last-child) .card-img-top,\n  .card-group > .card:not(:last-child) .card-header {\n    border-top-right-radius: 0;\n  }\n  .card-group > .card:not(:last-child) .card-img-bottom,\n  .card-group > .card:not(:last-child) .card-footer {\n    border-bottom-right-radius: 0;\n  }\n  .card-group > .card:not(:first-child) {\n    border-top-left-radius: 0;\n    border-bottom-left-radius: 0;\n  }\n  .card-group > .card:not(:first-child) .card-img-top,\n  .card-group > .card:not(:first-child) .card-header {\n    border-top-left-radius: 0;\n  }\n  .card-group > .card:not(:first-child) .card-img-bottom,\n  .card-group > .card:not(:first-child) .card-footer {\n    border-bottom-left-radius: 0;\n  }\n}\n\n.card-columns .card {\n  margin-bottom: 0.75rem;\n}\n\n@media (min-width: 576px) {\n  .card-columns {\n    -webkit-column-count: 3;\n    -moz-column-count: 3;\n    column-count: 3;\n    -webkit-column-gap: 1.25rem;\n    -moz-column-gap: 1.25rem;\n    column-gap: 1.25rem;\n    orphans: 1;\n    widows: 1;\n  }\n  .card-columns .card {\n    display: inline-block;\n    width: 100%;\n  }\n}\n\n.accordion > .card {\n  overflow: hidden;\n}\n\n.accordion > .card:not(:first-of-type) .card-header:first-child {\n  border-radius: 0;\n}\n\n.accordion > .card:not(:first-of-type):not(:last-of-type) {\n  border-bottom: 0;\n  border-radius: 0;\n}\n\n.accordion > .card:first-of-type {\n  border-bottom: 0;\n  border-bottom-right-radius: 0;\n  border-bottom-left-radius: 0;\n}\n\n.accordion > .card:last-of-type {\n  border-top-left-radius: 0;\n  border-top-right-radius: 0;\n}\n\n.accordion > .card .card-header {\n  margin-bottom: -1px;\n}\n\n.breadcrumb {\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-wrap: wrap;\n  flex-wrap: wrap;\n  padding: 0.75rem 1rem;\n  margin-bottom: 1rem;\n  list-style: none;\n  background-color: #e9ecef;\n  border-radius: 0.25rem;\n}\n\n.breadcrumb-item + .breadcrumb-item {\n  padding-left: 0.5rem;\n}\n\n.breadcrumb-item + .breadcrumb-item::before {\n  display: inline-block;\n  padding-right: 0.5rem;\n  color: #6c757d;\n  content: \"/\";\n}\n\n.breadcrumb-item + .breadcrumb-item:hover::before {\n  text-decoration: underline;\n}\n\n.breadcrumb-item + .breadcrumb-item:hover::before {\n  text-decoration: none;\n}\n\n.breadcrumb-item.active {\n  color: #6c757d;\n}\n\n.pagination {\n  display: -ms-flexbox;\n  display: flex;\n  padding-left: 0;\n  list-style: none;\n  border-radius: 0.25rem;\n}\n\n.page-link {\n  position: relative;\n  display: block;\n  padding: 0.5rem 0.75rem;\n  margin-left: -1px;\n  line-height: 1.25;\n  color: #007bff;\n  background-color: #fff;\n  border: 1px solid #dee2e6;\n}\n\n.page-link:hover {\n  z-index: 2;\n  color: #0056b3;\n  text-decoration: none;\n  background-color: #e9ecef;\n  border-color: #dee2e6;\n}\n\n.page-link:focus {\n  z-index: 2;\n  outline: 0;\n  box-shadow: 0 0 0 0.2rem rgba(0, 123, 255, 0.25);\n}\n\n.page-item:first-child .page-link {\n  margin-left: 0;\n  border-top-left-radius: 0.25rem;\n  border-bottom-left-radius: 0.25rem;\n}\n\n.page-item:last-child .page-link {\n  border-top-right-radius: 0.25rem;\n  border-bottom-right-radius: 0.25rem;\n}\n\n.page-item.active .page-link {\n  z-index: 1;\n  color: #fff;\n  background-color: #007bff;\n  border-color: #007bff;\n}\n\n.page-item.disabled .page-link {\n  color: #6c757d;\n  pointer-events: none;\n  cursor: auto;\n  background-color: #fff;\n  border-color: #dee2e6;\n}\n\n.pagination-lg .page-link {\n  padding: 0.75rem 1.5rem;\n  font-size: 1.25rem;\n  line-height: 1.5;\n}\n\n.pagination-lg .page-item:first-child .page-link {\n  border-top-left-radius: 0.3rem;\n  border-bottom-left-radius: 0.3rem;\n}\n\n.pagination-lg .page-item:last-child .page-link {\n  border-top-right-radius: 0.3rem;\n  border-bottom-right-radius: 0.3rem;\n}\n\n.pagination-sm .page-link {\n  padding: 0.25rem 0.5rem;\n  font-size: 0.875rem;\n  line-height: 1.5;\n}\n\n.pagination-sm .page-item:first-child .page-link {\n  border-top-left-radius: 0.2rem;\n  border-bottom-left-radius: 0.2rem;\n}\n\n.pagination-sm .page-item:last-child .page-link {\n  border-top-right-radius: 0.2rem;\n  border-bottom-right-radius: 0.2rem;\n}\n\n.badge {\n  display: inline-block;\n  padding: 0.25em 0.4em;\n  font-size: 75%;\n  font-weight: 700;\n  line-height: 1;\n  text-align: center;\n  white-space: nowrap;\n  vertical-align: baseline;\n  border-radius: 0.25rem;\n  transition: color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .badge {\n    transition: none;\n  }\n}\n\na.badge:hover, a.badge:focus {\n  text-decoration: none;\n}\n\n.badge:empty {\n  display: none;\n}\n\n.btn .badge {\n  position: relative;\n  top: -1px;\n}\n\n.badge-pill {\n  padding-right: 0.6em;\n  padding-left: 0.6em;\n  border-radius: 10rem;\n}\n\n.badge-primary {\n  color: #fff;\n  background-color: #007bff;\n}\n\na.badge-primary:hover, a.badge-primary:focus {\n  color: #fff;\n  background-color: #0062cc;\n}\n\na.badge-primary:focus, a.badge-primary.focus {\n  outline: 0;\n  box-shadow: 0 0 0 0.2rem rgba(0, 123, 255, 0.5);\n}\n\n.badge-secondary {\n  color: #fff;\n  background-color: #6c757d;\n}\n\na.badge-secondary:hover, a.badge-secondary:focus {\n  color: #fff;\n  background-color: #545b62;\n}\n\na.badge-secondary:focus, a.badge-secondary.focus {\n  outline: 0;\n  box-shadow: 0 0 0 0.2rem rgba(108, 117, 125, 0.5);\n}\n\n.badge-success {\n  color: #fff;\n  background-color: #28a745;\n}\n\na.badge-success:hover, a.badge-success:focus {\n  color: #fff;\n  background-color: #1e7e34;\n}\n\na.badge-success:focus, a.badge-success.focus {\n  outline: 0;\n  box-shadow: 0 0 0 0.2rem rgba(40, 167, 69, 0.5);\n}\n\n.badge-info {\n  color: #fff;\n  background-color: #17a2b8;\n}\n\na.badge-info:hover, a.badge-info:focus {\n  color: #fff;\n  background-color: #117a8b;\n}\n\na.badge-info:focus, a.badge-info.focus {\n  outline: 0;\n  box-shadow: 0 0 0 0.2rem rgba(23, 162, 184, 0.5);\n}\n\n.badge-warning {\n  color: #212529;\n  background-color: #ffc107;\n}\n\na.badge-warning:hover, a.badge-warning:focus {\n  color: #212529;\n  background-color: #d39e00;\n}\n\na.badge-warning:focus, a.badge-warning.focus {\n  outline: 0;\n  box-shadow: 0 0 0 0.2rem rgba(255, 193, 7, 0.5);\n}\n\n.badge-danger {\n  color: #fff;\n  background-color: #dc3545;\n}\n\na.badge-danger:hover, a.badge-danger:focus {\n  color: #fff;\n  background-color: #bd2130;\n}\n\na.badge-danger:focus, a.badge-danger.focus {\n  outline: 0;\n  box-shadow: 0 0 0 0.2rem rgba(220, 53, 69, 0.5);\n}\n\n.badge-light {\n  color: #212529;\n  background-color: #f8f9fa;\n}\n\na.badge-light:hover, a.badge-light:focus {\n  color: #212529;\n  background-color: #dae0e5;\n}\n\na.badge-light:focus, a.badge-light.focus {\n  outline: 0;\n  box-shadow: 0 0 0 0.2rem rgba(248, 249, 250, 0.5);\n}\n\n.badge-dark {\n  color: #fff;\n  background-color: #343a40;\n}\n\na.badge-dark:hover, a.badge-dark:focus {\n  color: #fff;\n  background-color: #1d2124;\n}\n\na.badge-dark:focus, a.badge-dark.focus {\n  outline: 0;\n  box-shadow: 0 0 0 0.2rem rgba(52, 58, 64, 0.5);\n}\n\n.jumbotron {\n  padding: 2rem 1rem;\n  margin-bottom: 2rem;\n  background-color: #e9ecef;\n  border-radius: 0.3rem;\n}\n\n@media (min-width: 576px) {\n  .jumbotron {\n    padding: 4rem 2rem;\n  }\n}\n\n.jumbotron-fluid {\n  padding-right: 0;\n  padding-left: 0;\n  border-radius: 0;\n}\n\n.alert {\n  position: relative;\n  padding: 0.75rem 1.25rem;\n  margin-bottom: 1rem;\n  border: 1px solid transparent;\n  border-radius: 0.25rem;\n}\n\n.alert-heading {\n  color: inherit;\n}\n\n.alert-link {\n  font-weight: 700;\n}\n\n.alert-dismissible {\n  padding-right: 4rem;\n}\n\n.alert-dismissible .close {\n  position: absolute;\n  top: 0;\n  right: 0;\n  padding: 0.75rem 1.25rem;\n  color: inherit;\n}\n\n.alert-primary {\n  color: #004085;\n  background-color: #cce5ff;\n  border-color: #b8daff;\n}\n\n.alert-primary hr {\n  border-top-color: #9fcdff;\n}\n\n.alert-primary .alert-link {\n  color: #002752;\n}\n\n.alert-secondary {\n  color: #383d41;\n  background-color: #e2e3e5;\n  border-color: #d6d8db;\n}\n\n.alert-secondary hr {\n  border-top-color: #c8cbcf;\n}\n\n.alert-secondary .alert-link {\n  color: #202326;\n}\n\n.alert-success {\n  color: #155724;\n  background-color: #d4edda;\n  border-color: #c3e6cb;\n}\n\n.alert-success hr {\n  border-top-color: #b1dfbb;\n}\n\n.alert-success .alert-link {\n  color: #0b2e13;\n}\n\n.alert-info {\n  color: #0c5460;\n  background-color: #d1ecf1;\n  border-color: #bee5eb;\n}\n\n.alert-info hr {\n  border-top-color: #abdde5;\n}\n\n.alert-info .alert-link {\n  color: #062c33;\n}\n\n.alert-warning {\n  color: #856404;\n  background-color: #fff3cd;\n  border-color: #ffeeba;\n}\n\n.alert-warning hr {\n  border-top-color: #ffe8a1;\n}\n\n.alert-warning .alert-link {\n  color: #533f03;\n}\n\n.alert-danger {\n  color: #721c24;\n  background-color: #f8d7da;\n  border-color: #f5c6cb;\n}\n\n.alert-danger hr {\n  border-top-color: #f1b0b7;\n}\n\n.alert-danger .alert-link {\n  color: #491217;\n}\n\n.alert-light {\n  color: #818182;\n  background-color: #fefefe;\n  border-color: #fdfdfe;\n}\n\n.alert-light hr {\n  border-top-color: #ececf6;\n}\n\n.alert-light .alert-link {\n  color: #686868;\n}\n\n.alert-dark {\n  color: #1b1e21;\n  background-color: #d6d8d9;\n  border-color: #c6c8ca;\n}\n\n.alert-dark hr {\n  border-top-color: #b9bbbe;\n}\n\n.alert-dark .alert-link {\n  color: #040505;\n}\n\n@-webkit-keyframes progress-bar-stripes {\n  from {\n    background-position: 1rem 0;\n  }\n  to {\n    background-position: 0 0;\n  }\n}\n\n@keyframes progress-bar-stripes {\n  from {\n    background-position: 1rem 0;\n  }\n  to {\n    background-position: 0 0;\n  }\n}\n\n.progress {\n  display: -ms-flexbox;\n  display: flex;\n  height: 1rem;\n  overflow: hidden;\n  font-size: 0.75rem;\n  background-color: #e9ecef;\n  border-radius: 0.25rem;\n}\n\n.progress-bar {\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-direction: column;\n  flex-direction: column;\n  -ms-flex-pack: center;\n  justify-content: center;\n  color: #fff;\n  text-align: center;\n  white-space: nowrap;\n  background-color: #007bff;\n  transition: width 0.6s ease;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .progress-bar {\n    transition: none;\n  }\n}\n\n.progress-bar-striped {\n  background-image: linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent);\n  background-size: 1rem 1rem;\n}\n\n.progress-bar-animated {\n  -webkit-animation: progress-bar-stripes 1s linear infinite;\n  animation: progress-bar-stripes 1s linear infinite;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .progress-bar-animated {\n    -webkit-animation: none;\n    animation: none;\n  }\n}\n\n.media {\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-align: start;\n  align-items: flex-start;\n}\n\n.media-body {\n  -ms-flex: 1;\n  flex: 1;\n}\n\n.list-group {\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-direction: column;\n  flex-direction: column;\n  padding-left: 0;\n  margin-bottom: 0;\n}\n\n.list-group-item-action {\n  width: 100%;\n  color: #495057;\n  text-align: inherit;\n}\n\n.list-group-item-action:hover, .list-group-item-action:focus {\n  z-index: 1;\n  color: #495057;\n  text-decoration: none;\n  background-color: #f8f9fa;\n}\n\n.list-group-item-action:active {\n  color: #212529;\n  background-color: #e9ecef;\n}\n\n.list-group-item {\n  position: relative;\n  display: block;\n  padding: 0.75rem 1.25rem;\n  margin-bottom: -1px;\n  background-color: #fff;\n  border: 1px solid rgba(0, 0, 0, 0.125);\n}\n\n.list-group-item:first-child {\n  border-top-left-radius: 0.25rem;\n  border-top-right-radius: 0.25rem;\n}\n\n.list-group-item:last-child {\n  margin-bottom: 0;\n  border-bottom-right-radius: 0.25rem;\n  border-bottom-left-radius: 0.25rem;\n}\n\n.list-group-item.disabled, .list-group-item:disabled {\n  color: #6c757d;\n  pointer-events: none;\n  background-color: #fff;\n}\n\n.list-group-item.active {\n  z-index: 2;\n  color: #fff;\n  background-color: #007bff;\n  border-color: #007bff;\n}\n\n.list-group-horizontal {\n  -ms-flex-direction: row;\n  flex-direction: row;\n}\n\n.list-group-horizontal .list-group-item {\n  margin-right: -1px;\n  margin-bottom: 0;\n}\n\n.list-group-horizontal .list-group-item:first-child {\n  border-top-left-radius: 0.25rem;\n  border-bottom-left-radius: 0.25rem;\n  border-top-right-radius: 0;\n}\n\n.list-group-horizontal .list-group-item:last-child {\n  margin-right: 0;\n  border-top-right-radius: 0.25rem;\n  border-bottom-right-radius: 0.25rem;\n  border-bottom-left-radius: 0;\n}\n\n@media (min-width: 576px) {\n  .list-group-horizontal-sm {\n    -ms-flex-direction: row;\n    flex-direction: row;\n  }\n  .list-group-horizontal-sm .list-group-item {\n    margin-right: -1px;\n    margin-bottom: 0;\n  }\n  .list-group-horizontal-sm .list-group-item:first-child {\n    border-top-left-radius: 0.25rem;\n    border-bottom-left-radius: 0.25rem;\n    border-top-right-radius: 0;\n  }\n  .list-group-horizontal-sm .list-group-item:last-child {\n    margin-right: 0;\n    border-top-right-radius: 0.25rem;\n    border-bottom-right-radius: 0.25rem;\n    border-bottom-left-radius: 0;\n  }\n}\n\n@media (min-width: 768px) {\n  .list-group-horizontal-md {\n    -ms-flex-direction: row;\n    flex-direction: row;\n  }\n  .list-group-horizontal-md .list-group-item {\n    margin-right: -1px;\n    margin-bottom: 0;\n  }\n  .list-group-horizontal-md .list-group-item:first-child {\n    border-top-left-radius: 0.25rem;\n    border-bottom-left-radius: 0.25rem;\n    border-top-right-radius: 0;\n  }\n  .list-group-horizontal-md .list-group-item:last-child {\n    margin-right: 0;\n    border-top-right-radius: 0.25rem;\n    border-bottom-right-radius: 0.25rem;\n    border-bottom-left-radius: 0;\n  }\n}\n\n@media (min-width: 992px) {\n  .list-group-horizontal-lg {\n    -ms-flex-direction: row;\n    flex-direction: row;\n  }\n  .list-group-horizontal-lg .list-group-item {\n    margin-right: -1px;\n    margin-bottom: 0;\n  }\n  .list-group-horizontal-lg .list-group-item:first-child {\n    border-top-left-radius: 0.25rem;\n    border-bottom-left-radius: 0.25rem;\n    border-top-right-radius: 0;\n  }\n  .list-group-horizontal-lg .list-group-item:last-child {\n    margin-right: 0;\n    border-top-right-radius: 0.25rem;\n    border-bottom-right-radius: 0.25rem;\n    border-bottom-left-radius: 0;\n  }\n}\n\n@media (min-width: 1200px) {\n  .list-group-horizontal-xl {\n    -ms-flex-direction: row;\n    flex-direction: row;\n  }\n  .list-group-horizontal-xl .list-group-item {\n    margin-right: -1px;\n    margin-bottom: 0;\n  }\n  .list-group-horizontal-xl .list-group-item:first-child {\n    border-top-left-radius: 0.25rem;\n    border-bottom-left-radius: 0.25rem;\n    border-top-right-radius: 0;\n  }\n  .list-group-horizontal-xl .list-group-item:last-child {\n    margin-right: 0;\n    border-top-right-radius: 0.25rem;\n    border-bottom-right-radius: 0.25rem;\n    border-bottom-left-radius: 0;\n  }\n}\n\n.list-group-flush .list-group-item {\n  border-right: 0;\n  border-left: 0;\n  border-radius: 0;\n}\n\n.list-group-flush .list-group-item:last-child {\n  margin-bottom: -1px;\n}\n\n.list-group-flush:first-child .list-group-item:first-child {\n  border-top: 0;\n}\n\n.list-group-flush:last-child .list-group-item:last-child {\n  margin-bottom: 0;\n  border-bottom: 0;\n}\n\n.list-group-item-primary {\n  color: #004085;\n  background-color: #b8daff;\n}\n\n.list-group-item-primary.list-group-item-action:hover, .list-group-item-primary.list-group-item-action:focus {\n  color: #004085;\n  background-color: #9fcdff;\n}\n\n.list-group-item-primary.list-group-item-action.active {\n  color: #fff;\n  background-color: #004085;\n  border-color: #004085;\n}\n\n.list-group-item-secondary {\n  color: #383d41;\n  background-color: #d6d8db;\n}\n\n.list-group-item-secondary.list-group-item-action:hover, .list-group-item-secondary.list-group-item-action:focus {\n  color: #383d41;\n  background-color: #c8cbcf;\n}\n\n.list-group-item-secondary.list-group-item-action.active {\n  color: #fff;\n  background-color: #383d41;\n  border-color: #383d41;\n}\n\n.list-group-item-success {\n  color: #155724;\n  background-color: #c3e6cb;\n}\n\n.list-group-item-success.list-group-item-action:hover, .list-group-item-success.list-group-item-action:focus {\n  color: #155724;\n  background-color: #b1dfbb;\n}\n\n.list-group-item-success.list-group-item-action.active {\n  color: #fff;\n  background-color: #155724;\n  border-color: #155724;\n}\n\n.list-group-item-info {\n  color: #0c5460;\n  background-color: #bee5eb;\n}\n\n.list-group-item-info.list-group-item-action:hover, .list-group-item-info.list-group-item-action:focus {\n  color: #0c5460;\n  background-color: #abdde5;\n}\n\n.list-group-item-info.list-group-item-action.active {\n  color: #fff;\n  background-color: #0c5460;\n  border-color: #0c5460;\n}\n\n.list-group-item-warning {\n  color: #856404;\n  background-color: #ffeeba;\n}\n\n.list-group-item-warning.list-group-item-action:hover, .list-group-item-warning.list-group-item-action:focus {\n  color: #856404;\n  background-color: #ffe8a1;\n}\n\n.list-group-item-warning.list-group-item-action.active {\n  color: #fff;\n  background-color: #856404;\n  border-color: #856404;\n}\n\n.list-group-item-danger {\n  color: #721c24;\n  background-color: #f5c6cb;\n}\n\n.list-group-item-danger.list-group-item-action:hover, .list-group-item-danger.list-group-item-action:focus {\n  color: #721c24;\n  background-color: #f1b0b7;\n}\n\n.list-group-item-danger.list-group-item-action.active {\n  color: #fff;\n  background-color: #721c24;\n  border-color: #721c24;\n}\n\n.list-group-item-light {\n  color: #818182;\n  background-color: #fdfdfe;\n}\n\n.list-group-item-light.list-group-item-action:hover, .list-group-item-light.list-group-item-action:focus {\n  color: #818182;\n  background-color: #ececf6;\n}\n\n.list-group-item-light.list-group-item-action.active {\n  color: #fff;\n  background-color: #818182;\n  border-color: #818182;\n}\n\n.list-group-item-dark {\n  color: #1b1e21;\n  background-color: #c6c8ca;\n}\n\n.list-group-item-dark.list-group-item-action:hover, .list-group-item-dark.list-group-item-action:focus {\n  color: #1b1e21;\n  background-color: #b9bbbe;\n}\n\n.list-group-item-dark.list-group-item-action.active {\n  color: #fff;\n  background-color: #1b1e21;\n  border-color: #1b1e21;\n}\n\n.close {\n  float: right;\n  font-size: 1.5rem;\n  font-weight: 700;\n  line-height: 1;\n  color: #000;\n  text-shadow: 0 1px 0 #fff;\n  opacity: .5;\n}\n\n.close:hover {\n  color: #000;\n  text-decoration: none;\n}\n\n.close:not(:disabled):not(.disabled):hover, .close:not(:disabled):not(.disabled):focus {\n  opacity: .75;\n}\n\nbutton.close {\n  padding: 0;\n  background-color: transparent;\n  border: 0;\n  -webkit-appearance: none;\n  -moz-appearance: none;\n  appearance: none;\n}\n\na.close.disabled {\n  pointer-events: none;\n}\n\n.toast {\n  max-width: 350px;\n  overflow: hidden;\n  font-size: 0.875rem;\n  background-color: rgba(255, 255, 255, 0.85);\n  background-clip: padding-box;\n  border: 1px solid rgba(0, 0, 0, 0.1);\n  box-shadow: 0 0.25rem 0.75rem rgba(0, 0, 0, 0.1);\n  -webkit-backdrop-filter: blur(10px);\n  backdrop-filter: blur(10px);\n  opacity: 0;\n  border-radius: 0.25rem;\n}\n\n.toast:not(:last-child) {\n  margin-bottom: 0.75rem;\n}\n\n.toast.showing {\n  opacity: 1;\n}\n\n.toast.show {\n  display: block;\n  opacity: 1;\n}\n\n.toast.hide {\n  display: none;\n}\n\n.toast-header {\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-align: center;\n  align-items: center;\n  padding: 0.25rem 0.75rem;\n  color: #6c757d;\n  background-color: rgba(255, 255, 255, 0.85);\n  background-clip: padding-box;\n  border-bottom: 1px solid rgba(0, 0, 0, 0.05);\n}\n\n.toast-body {\n  padding: 0.75rem;\n}\n\n.modal-open {\n  overflow: hidden;\n}\n\n.modal-open .modal {\n  overflow-x: hidden;\n  overflow-y: auto;\n}\n\n.modal {\n  position: fixed;\n  top: 0;\n  left: 0;\n  z-index: 1050;\n  display: none;\n  width: 100%;\n  height: 100%;\n  overflow: hidden;\n  outline: 0;\n}\n\n.modal-dialog {\n  position: relative;\n  width: auto;\n  margin: 0.5rem;\n  pointer-events: none;\n}\n\n.modal.fade .modal-dialog {\n  transition: -webkit-transform 0.3s ease-out;\n  transition: transform 0.3s ease-out;\n  transition: transform 0.3s ease-out, -webkit-transform 0.3s ease-out;\n  -webkit-transform: translate(0, -50px);\n  transform: translate(0, -50px);\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .modal.fade .modal-dialog {\n    transition: none;\n  }\n}\n\n.modal.show .modal-dialog {\n  -webkit-transform: none;\n  transform: none;\n}\n\n.modal-dialog-scrollable {\n  display: -ms-flexbox;\n  display: flex;\n  max-height: calc(100% - 1rem);\n}\n\n.modal-dialog-scrollable .modal-content {\n  max-height: calc(100vh - 1rem);\n  overflow: hidden;\n}\n\n.modal-dialog-scrollable .modal-header,\n.modal-dialog-scrollable .modal-footer {\n  -ms-flex-negative: 0;\n  flex-shrink: 0;\n}\n\n.modal-dialog-scrollable .modal-body {\n  overflow-y: auto;\n}\n\n.modal-dialog-centered {\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-align: center;\n  align-items: center;\n  min-height: calc(100% - 1rem);\n}\n\n.modal-dialog-centered::before {\n  display: block;\n  height: calc(100vh - 1rem);\n  content: \"\";\n}\n\n.modal-dialog-centered.modal-dialog-scrollable {\n  -ms-flex-direction: column;\n  flex-direction: column;\n  -ms-flex-pack: center;\n  justify-content: center;\n  height: 100%;\n}\n\n.modal-dialog-centered.modal-dialog-scrollable .modal-content {\n  max-height: none;\n}\n\n.modal-dialog-centered.modal-dialog-scrollable::before {\n  content: none;\n}\n\n.modal-content {\n  position: relative;\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-direction: column;\n  flex-direction: column;\n  width: 100%;\n  pointer-events: auto;\n  background-color: #fff;\n  background-clip: padding-box;\n  border: 1px solid rgba(0, 0, 0, 0.2);\n  border-radius: 0.3rem;\n  outline: 0;\n}\n\n.modal-backdrop {\n  position: fixed;\n  top: 0;\n  left: 0;\n  z-index: 1040;\n  width: 100vw;\n  height: 100vh;\n  background-color: #000;\n}\n\n.modal-backdrop.fade {\n  opacity: 0;\n}\n\n.modal-backdrop.show {\n  opacity: 0.5;\n}\n\n.modal-header {\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-align: start;\n  align-items: flex-start;\n  -ms-flex-pack: justify;\n  justify-content: space-between;\n  padding: 1rem 1rem;\n  border-bottom: 1px solid #dee2e6;\n  border-top-left-radius: 0.3rem;\n  border-top-right-radius: 0.3rem;\n}\n\n.modal-header .close {\n  padding: 1rem 1rem;\n  margin: -1rem -1rem -1rem auto;\n}\n\n.modal-title {\n  margin-bottom: 0;\n  line-height: 1.5;\n}\n\n.modal-body {\n  position: relative;\n  -ms-flex: 1 1 auto;\n  flex: 1 1 auto;\n  padding: 1rem;\n}\n\n.modal-footer {\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-align: center;\n  align-items: center;\n  -ms-flex-pack: end;\n  justify-content: flex-end;\n  padding: 1rem;\n  border-top: 1px solid #dee2e6;\n  border-bottom-right-radius: 0.3rem;\n  border-bottom-left-radius: 0.3rem;\n}\n\n.modal-footer > :not(:first-child) {\n  margin-left: .25rem;\n}\n\n.modal-footer > :not(:last-child) {\n  margin-right: .25rem;\n}\n\n.modal-scrollbar-measure {\n  position: absolute;\n  top: -9999px;\n  width: 50px;\n  height: 50px;\n  overflow: scroll;\n}\n\n@media (min-width: 576px) {\n  .modal-dialog {\n    max-width: 500px;\n    margin: 1.75rem auto;\n  }\n  .modal-dialog-scrollable {\n    max-height: calc(100% - 3.5rem);\n  }\n  .modal-dialog-scrollable .modal-content {\n    max-height: calc(100vh - 3.5rem);\n  }\n  .modal-dialog-centered {\n    min-height: calc(100% - 3.5rem);\n  }\n  .modal-dialog-centered::before {\n    height: calc(100vh - 3.5rem);\n  }\n  .modal-sm {\n    max-width: 300px;\n  }\n}\n\n@media (min-width: 992px) {\n  .modal-lg,\n  .modal-xl {\n    max-width: 800px;\n  }\n}\n\n@media (min-width: 1200px) {\n  .modal-xl {\n    max-width: 1140px;\n  }\n}\n\n.tooltip {\n  position: absolute;\n  z-index: 1070;\n  display: block;\n  margin: 0;\n  font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, \"Noto Sans\", sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\", \"Noto Color Emoji\";\n  font-style: normal;\n  font-weight: 400;\n  line-height: 1.5;\n  text-align: left;\n  text-align: start;\n  text-decoration: none;\n  text-shadow: none;\n  text-transform: none;\n  letter-spacing: normal;\n  word-break: normal;\n  word-spacing: normal;\n  white-space: normal;\n  line-break: auto;\n  font-size: 0.875rem;\n  word-wrap: break-word;\n  opacity: 0;\n}\n\n.tooltip.show {\n  opacity: 0.9;\n}\n\n.tooltip .arrow {\n  position: absolute;\n  display: block;\n  width: 0.8rem;\n  height: 0.4rem;\n}\n\n.tooltip .arrow::before {\n  position: absolute;\n  content: \"\";\n  border-color: transparent;\n  border-style: solid;\n}\n\n.bs-tooltip-top, .bs-tooltip-auto[x-placement^=\"top\"] {\n  padding: 0.4rem 0;\n}\n\n.bs-tooltip-top .arrow, .bs-tooltip-auto[x-placement^=\"top\"] .arrow {\n  bottom: 0;\n}\n\n.bs-tooltip-top .arrow::before, .bs-tooltip-auto[x-placement^=\"top\"] .arrow::before {\n  top: 0;\n  border-width: 0.4rem 0.4rem 0;\n  border-top-color: #000;\n}\n\n.bs-tooltip-right, .bs-tooltip-auto[x-placement^=\"right\"] {\n  padding: 0 0.4rem;\n}\n\n.bs-tooltip-right .arrow, .bs-tooltip-auto[x-placement^=\"right\"] .arrow {\n  left: 0;\n  width: 0.4rem;\n  height: 0.8rem;\n}\n\n.bs-tooltip-right .arrow::before, .bs-tooltip-auto[x-placement^=\"right\"] .arrow::before {\n  right: 0;\n  border-width: 0.4rem 0.4rem 0.4rem 0;\n  border-right-color: #000;\n}\n\n.bs-tooltip-bottom, .bs-tooltip-auto[x-placement^=\"bottom\"] {\n  padding: 0.4rem 0;\n}\n\n.bs-tooltip-bottom .arrow, .bs-tooltip-auto[x-placement^=\"bottom\"] .arrow {\n  top: 0;\n}\n\n.bs-tooltip-bottom .arrow::before, .bs-tooltip-auto[x-placement^=\"bottom\"] .arrow::before {\n  bottom: 0;\n  border-width: 0 0.4rem 0.4rem;\n  border-bottom-color: #000;\n}\n\n.bs-tooltip-left, .bs-tooltip-auto[x-placement^=\"left\"] {\n  padding: 0 0.4rem;\n}\n\n.bs-tooltip-left .arrow, .bs-tooltip-auto[x-placement^=\"left\"] .arrow {\n  right: 0;\n  width: 0.4rem;\n  height: 0.8rem;\n}\n\n.bs-tooltip-left .arrow::before, .bs-tooltip-auto[x-placement^=\"left\"] .arrow::before {\n  left: 0;\n  border-width: 0.4rem 0 0.4rem 0.4rem;\n  border-left-color: #000;\n}\n\n.tooltip-inner {\n  max-width: 200px;\n  padding: 0.25rem 0.5rem;\n  color: #fff;\n  text-align: center;\n  background-color: #000;\n  border-radius: 0.25rem;\n}\n\n.popover {\n  position: absolute;\n  top: 0;\n  left: 0;\n  z-index: 1060;\n  display: block;\n  max-width: 276px;\n  font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, \"Noto Sans\", sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\", \"Noto Color Emoji\";\n  font-style: normal;\n  font-weight: 400;\n  line-height: 1.5;\n  text-align: left;\n  text-align: start;\n  text-decoration: none;\n  text-shadow: none;\n  text-transform: none;\n  letter-spacing: normal;\n  word-break: normal;\n  word-spacing: normal;\n  white-space: normal;\n  line-break: auto;\n  font-size: 0.875rem;\n  word-wrap: break-word;\n  background-color: #fff;\n  background-clip: padding-box;\n  border: 1px solid rgba(0, 0, 0, 0.2);\n  border-radius: 0.3rem;\n}\n\n.popover .arrow {\n  position: absolute;\n  display: block;\n  width: 1rem;\n  height: 0.5rem;\n  margin: 0 0.3rem;\n}\n\n.popover .arrow::before, .popover .arrow::after {\n  position: absolute;\n  display: block;\n  content: \"\";\n  border-color: transparent;\n  border-style: solid;\n}\n\n.bs-popover-top, .bs-popover-auto[x-placement^=\"top\"] {\n  margin-bottom: 0.5rem;\n}\n\n.bs-popover-top > .arrow, .bs-popover-auto[x-placement^=\"top\"] > .arrow {\n  bottom: calc((0.5rem + 1px) * -1);\n}\n\n.bs-popover-top > .arrow::before, .bs-popover-auto[x-placement^=\"top\"] > .arrow::before {\n  bottom: 0;\n  border-width: 0.5rem 0.5rem 0;\n  border-top-color: rgba(0, 0, 0, 0.25);\n}\n\n.bs-popover-top > .arrow::after, .bs-popover-auto[x-placement^=\"top\"] > .arrow::after {\n  bottom: 1px;\n  border-width: 0.5rem 0.5rem 0;\n  border-top-color: #fff;\n}\n\n.bs-popover-right, .bs-popover-auto[x-placement^=\"right\"] {\n  margin-left: 0.5rem;\n}\n\n.bs-popover-right > .arrow, .bs-popover-auto[x-placement^=\"right\"] > .arrow {\n  left: calc((0.5rem + 1px) * -1);\n  width: 0.5rem;\n  height: 1rem;\n  margin: 0.3rem 0;\n}\n\n.bs-popover-right > .arrow::before, .bs-popover-auto[x-placement^=\"right\"] > .arrow::before {\n  left: 0;\n  border-width: 0.5rem 0.5rem 0.5rem 0;\n  border-right-color: rgba(0, 0, 0, 0.25);\n}\n\n.bs-popover-right > .arrow::after, .bs-popover-auto[x-placement^=\"right\"] > .arrow::after {\n  left: 1px;\n  border-width: 0.5rem 0.5rem 0.5rem 0;\n  border-right-color: #fff;\n}\n\n.bs-popover-bottom, .bs-popover-auto[x-placement^=\"bottom\"] {\n  margin-top: 0.5rem;\n}\n\n.bs-popover-bottom > .arrow, .bs-popover-auto[x-placement^=\"bottom\"] > .arrow {\n  top: calc((0.5rem + 1px) * -1);\n}\n\n.bs-popover-bottom > .arrow::before, .bs-popover-auto[x-placement^=\"bottom\"] > .arrow::before {\n  top: 0;\n  border-width: 0 0.5rem 0.5rem 0.5rem;\n  border-bottom-color: rgba(0, 0, 0, 0.25);\n}\n\n.bs-popover-bottom > .arrow::after, .bs-popover-auto[x-placement^=\"bottom\"] > .arrow::after {\n  top: 1px;\n  border-width: 0 0.5rem 0.5rem 0.5rem;\n  border-bottom-color: #fff;\n}\n\n.bs-popover-bottom .popover-header::before, .bs-popover-auto[x-placement^=\"bottom\"] .popover-header::before {\n  position: absolute;\n  top: 0;\n  left: 50%;\n  display: block;\n  width: 1rem;\n  margin-left: -0.5rem;\n  content: \"\";\n  border-bottom: 1px solid #f7f7f7;\n}\n\n.bs-popover-left, .bs-popover-auto[x-placement^=\"left\"] {\n  margin-right: 0.5rem;\n}\n\n.bs-popover-left > .arrow, .bs-popover-auto[x-placement^=\"left\"] > .arrow {\n  right: calc((0.5rem + 1px) * -1);\n  width: 0.5rem;\n  height: 1rem;\n  margin: 0.3rem 0;\n}\n\n.bs-popover-left > .arrow::before, .bs-popover-auto[x-placement^=\"left\"] > .arrow::before {\n  right: 0;\n  border-width: 0.5rem 0 0.5rem 0.5rem;\n  border-left-color: rgba(0, 0, 0, 0.25);\n}\n\n.bs-popover-left > .arrow::after, .bs-popover-auto[x-placement^=\"left\"] > .arrow::after {\n  right: 1px;\n  border-width: 0.5rem 0 0.5rem 0.5rem;\n  border-left-color: #fff;\n}\n\n.popover-header {\n  padding: 0.5rem 0.75rem;\n  margin-bottom: 0;\n  font-size: 1rem;\n  background-color: #f7f7f7;\n  border-bottom: 1px solid #ebebeb;\n  border-top-left-radius: calc(0.3rem - 1px);\n  border-top-right-radius: calc(0.3rem - 1px);\n}\n\n.popover-header:empty {\n  display: none;\n}\n\n.popover-body {\n  padding: 0.5rem 0.75rem;\n  color: #212529;\n}\n\n.carousel {\n  position: relative;\n}\n\n.carousel.pointer-event {\n  -ms-touch-action: pan-y;\n  touch-action: pan-y;\n}\n\n.carousel-inner {\n  position: relative;\n  width: 100%;\n  overflow: hidden;\n}\n\n.carousel-inner::after {\n  display: block;\n  clear: both;\n  content: \"\";\n}\n\n.carousel-item {\n  position: relative;\n  display: none;\n  float: left;\n  width: 100%;\n  margin-right: -100%;\n  -webkit-backface-visibility: hidden;\n  backface-visibility: hidden;\n  transition: -webkit-transform 0.6s ease-in-out;\n  transition: transform 0.6s ease-in-out;\n  transition: transform 0.6s ease-in-out, -webkit-transform 0.6s ease-in-out;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .carousel-item {\n    transition: none;\n  }\n}\n\n.carousel-item.active,\n.carousel-item-next,\n.carousel-item-prev {\n  display: block;\n}\n\n.carousel-item-next:not(.carousel-item-left),\n.active.carousel-item-right {\n  -webkit-transform: translateX(100%);\n  transform: translateX(100%);\n}\n\n.carousel-item-prev:not(.carousel-item-right),\n.active.carousel-item-left {\n  -webkit-transform: translateX(-100%);\n  transform: translateX(-100%);\n}\n\n.carousel-fade .carousel-item {\n  opacity: 0;\n  transition-property: opacity;\n  -webkit-transform: none;\n  transform: none;\n}\n\n.carousel-fade .carousel-item.active,\n.carousel-fade .carousel-item-next.carousel-item-left,\n.carousel-fade .carousel-item-prev.carousel-item-right {\n  z-index: 1;\n  opacity: 1;\n}\n\n.carousel-fade .active.carousel-item-left,\n.carousel-fade .active.carousel-item-right {\n  z-index: 0;\n  opacity: 0;\n  transition: 0s 0.6s opacity;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .carousel-fade .active.carousel-item-left,\n  .carousel-fade .active.carousel-item-right {\n    transition: none;\n  }\n}\n\n.carousel-control-prev,\n.carousel-control-next {\n  position: absolute;\n  top: 0;\n  bottom: 0;\n  z-index: 1;\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-align: center;\n  align-items: center;\n  -ms-flex-pack: center;\n  justify-content: center;\n  width: 15%;\n  color: #fff;\n  text-align: center;\n  opacity: 0.5;\n  transition: opacity 0.15s ease;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .carousel-control-prev,\n  .carousel-control-next {\n    transition: none;\n  }\n}\n\n.carousel-control-prev:hover, .carousel-control-prev:focus,\n.carousel-control-next:hover,\n.carousel-control-next:focus {\n  color: #fff;\n  text-decoration: none;\n  outline: 0;\n  opacity: 0.9;\n}\n\n.carousel-control-prev {\n  left: 0;\n}\n\n.carousel-control-next {\n  right: 0;\n}\n\n.carousel-control-prev-icon,\n.carousel-control-next-icon {\n  display: inline-block;\n  width: 20px;\n  height: 20px;\n  background: no-repeat 50% / 100% 100%;\n}\n\n.carousel-control-prev-icon {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' fill='%23fff' viewBox='0 0 8 8'%3e%3cpath d='M5.25 0l-4 4 4 4 1.5-1.5-2.5-2.5 2.5-2.5-1.5-1.5z'/%3e%3c/svg%3e\");\n}\n\n.carousel-control-next-icon {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' fill='%23fff' viewBox='0 0 8 8'%3e%3cpath d='M2.75 0l-1.5 1.5 2.5 2.5-2.5 2.5 1.5 1.5 4-4-4-4z'/%3e%3c/svg%3e\");\n}\n\n.carousel-indicators {\n  position: absolute;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  z-index: 15;\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-pack: center;\n  justify-content: center;\n  padding-left: 0;\n  margin-right: 15%;\n  margin-left: 15%;\n  list-style: none;\n}\n\n.carousel-indicators li {\n  box-sizing: content-box;\n  -ms-flex: 0 1 auto;\n  flex: 0 1 auto;\n  width: 30px;\n  height: 3px;\n  margin-right: 3px;\n  margin-left: 3px;\n  text-indent: -999px;\n  cursor: pointer;\n  background-color: #fff;\n  background-clip: padding-box;\n  border-top: 10px solid transparent;\n  border-bottom: 10px solid transparent;\n  opacity: .5;\n  transition: opacity 0.6s ease;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .carousel-indicators li {\n    transition: none;\n  }\n}\n\n.carousel-indicators .active {\n  opacity: 1;\n}\n\n.carousel-caption {\n  position: absolute;\n  right: 15%;\n  bottom: 20px;\n  left: 15%;\n  z-index: 10;\n  padding-top: 20px;\n  padding-bottom: 20px;\n  color: #fff;\n  text-align: center;\n}\n\n@-webkit-keyframes spinner-border {\n  to {\n    -webkit-transform: rotate(360deg);\n    transform: rotate(360deg);\n  }\n}\n\n@keyframes spinner-border {\n  to {\n    -webkit-transform: rotate(360deg);\n    transform: rotate(360deg);\n  }\n}\n\n.spinner-border {\n  display: inline-block;\n  width: 2rem;\n  height: 2rem;\n  vertical-align: text-bottom;\n  border: 0.25em solid currentColor;\n  border-right-color: transparent;\n  border-radius: 50%;\n  -webkit-animation: spinner-border .75s linear infinite;\n  animation: spinner-border .75s linear infinite;\n}\n\n.spinner-border-sm {\n  width: 1rem;\n  height: 1rem;\n  border-width: 0.2em;\n}\n\n@-webkit-keyframes spinner-grow {\n  0% {\n    -webkit-transform: scale(0);\n    transform: scale(0);\n  }\n  50% {\n    opacity: 1;\n  }\n}\n\n@keyframes spinner-grow {\n  0% {\n    -webkit-transform: scale(0);\n    transform: scale(0);\n  }\n  50% {\n    opacity: 1;\n  }\n}\n\n.spinner-grow {\n  display: inline-block;\n  width: 2rem;\n  height: 2rem;\n  vertical-align: text-bottom;\n  background-color: currentColor;\n  border-radius: 50%;\n  opacity: 0;\n  -webkit-animation: spinner-grow .75s linear infinite;\n  animation: spinner-grow .75s linear infinite;\n}\n\n.spinner-grow-sm {\n  width: 1rem;\n  height: 1rem;\n}\n\n.align-baseline {\n  vertical-align: baseline !important;\n}\n\n.align-top {\n  vertical-align: top !important;\n}\n\n.align-middle {\n  vertical-align: middle !important;\n}\n\n.align-bottom {\n  vertical-align: bottom !important;\n}\n\n.align-text-bottom {\n  vertical-align: text-bottom !important;\n}\n\n.align-text-top {\n  vertical-align: text-top !important;\n}\n\n.bg-primary {\n  background-color: #007bff !important;\n}\n\na.bg-primary:hover, a.bg-primary:focus,\nbutton.bg-primary:hover,\nbutton.bg-primary:focus {\n  background-color: #0062cc !important;\n}\n\n.bg-secondary {\n  background-color: #6c757d !important;\n}\n\na.bg-secondary:hover, a.bg-secondary:focus,\nbutton.bg-secondary:hover,\nbutton.bg-secondary:focus {\n  background-color: #545b62 !important;\n}\n\n.bg-success {\n  background-color: #28a745 !important;\n}\n\na.bg-success:hover, a.bg-success:focus,\nbutton.bg-success:hover,\nbutton.bg-success:focus {\n  background-color: #1e7e34 !important;\n}\n\n.bg-info {\n  background-color: #17a2b8 !important;\n}\n\na.bg-info:hover, a.bg-info:focus,\nbutton.bg-info:hover,\nbutton.bg-info:focus {\n  background-color: #117a8b !important;\n}\n\n.bg-warning {\n  background-color: #ffc107 !important;\n}\n\na.bg-warning:hover, a.bg-warning:focus,\nbutton.bg-warning:hover,\nbutton.bg-warning:focus {\n  background-color: #d39e00 !important;\n}\n\n.bg-danger {\n  background-color: #dc3545 !important;\n}\n\na.bg-danger:hover, a.bg-danger:focus,\nbutton.bg-danger:hover,\nbutton.bg-danger:focus {\n  background-color: #bd2130 !important;\n}\n\n.bg-light {\n  background-color: #f8f9fa !important;\n}\n\na.bg-light:hover, a.bg-light:focus,\nbutton.bg-light:hover,\nbutton.bg-light:focus {\n  background-color: #dae0e5 !important;\n}\n\n.bg-dark {\n  background-color: #343a40 !important;\n}\n\na.bg-dark:hover, a.bg-dark:focus,\nbutton.bg-dark:hover,\nbutton.bg-dark:focus {\n  background-color: #1d2124 !important;\n}\n\n.bg-white {\n  background-color: #fff !important;\n}\n\n.bg-transparent {\n  background-color: transparent !important;\n}\n\n.border {\n  border: 1px solid #dee2e6 !important;\n}\n\n.border-top {\n  border-top: 1px solid #dee2e6 !important;\n}\n\n.border-right {\n  border-right: 1px solid #dee2e6 !important;\n}\n\n.border-bottom {\n  border-bottom: 1px solid #dee2e6 !important;\n}\n\n.border-left {\n  border-left: 1px solid #dee2e6 !important;\n}\n\n.border-0 {\n  border: 0 !important;\n}\n\n.border-top-0 {\n  border-top: 0 !important;\n}\n\n.border-right-0 {\n  border-right: 0 !important;\n}\n\n.border-bottom-0 {\n  border-bottom: 0 !important;\n}\n\n.border-left-0 {\n  border-left: 0 !important;\n}\n\n.border-primary {\n  border-color: #007bff !important;\n}\n\n.border-secondary {\n  border-color: #6c757d !important;\n}\n\n.border-success {\n  border-color: #28a745 !important;\n}\n\n.border-info {\n  border-color: #17a2b8 !important;\n}\n\n.border-warning {\n  border-color: #ffc107 !important;\n}\n\n.border-danger {\n  border-color: #dc3545 !important;\n}\n\n.border-light {\n  border-color: #f8f9fa !important;\n}\n\n.border-dark {\n  border-color: #343a40 !important;\n}\n\n.border-white {\n  border-color: #fff !important;\n}\n\n.rounded-sm {\n  border-radius: 0.2rem !important;\n}\n\n.rounded {\n  border-radius: 0.25rem !important;\n}\n\n.rounded-top {\n  border-top-left-radius: 0.25rem !important;\n  border-top-right-radius: 0.25rem !important;\n}\n\n.rounded-right {\n  border-top-right-radius: 0.25rem !important;\n  border-bottom-right-radius: 0.25rem !important;\n}\n\n.rounded-bottom {\n  border-bottom-right-radius: 0.25rem !important;\n  border-bottom-left-radius: 0.25rem !important;\n}\n\n.rounded-left {\n  border-top-left-radius: 0.25rem !important;\n  border-bottom-left-radius: 0.25rem !important;\n}\n\n.rounded-lg {\n  border-radius: 0.3rem !important;\n}\n\n.rounded-circle {\n  border-radius: 50% !important;\n}\n\n.rounded-pill {\n  border-radius: 50rem !important;\n}\n\n.rounded-0 {\n  border-radius: 0 !important;\n}\n\n.clearfix::after {\n  display: block;\n  clear: both;\n  content: \"\";\n}\n\n.d-none {\n  display: none !important;\n}\n\n.d-inline {\n  display: inline !important;\n}\n\n.d-inline-block {\n  display: inline-block !important;\n}\n\n.d-block {\n  display: block !important;\n}\n\n.d-table {\n  display: table !important;\n}\n\n.d-table-row {\n  display: table-row !important;\n}\n\n.d-table-cell {\n  display: table-cell !important;\n}\n\n.d-flex {\n  display: -ms-flexbox !important;\n  display: flex !important;\n}\n\n.d-inline-flex {\n  display: -ms-inline-flexbox !important;\n  display: inline-flex !important;\n}\n\n@media (min-width: 576px) {\n  .d-sm-none {\n    display: none !important;\n  }\n  .d-sm-inline {\n    display: inline !important;\n  }\n  .d-sm-inline-block {\n    display: inline-block !important;\n  }\n  .d-sm-block {\n    display: block !important;\n  }\n  .d-sm-table {\n    display: table !important;\n  }\n  .d-sm-table-row {\n    display: table-row !important;\n  }\n  .d-sm-table-cell {\n    display: table-cell !important;\n  }\n  .d-sm-flex {\n    display: -ms-flexbox !important;\n    display: flex !important;\n  }\n  .d-sm-inline-flex {\n    display: -ms-inline-flexbox !important;\n    display: inline-flex !important;\n  }\n}\n\n@media (min-width: 768px) {\n  .d-md-none {\n    display: none !important;\n  }\n  .d-md-inline {\n    display: inline !important;\n  }\n  .d-md-inline-block {\n    display: inline-block !important;\n  }\n  .d-md-block {\n    display: block !important;\n  }\n  .d-md-table {\n    display: table !important;\n  }\n  .d-md-table-row {\n    display: table-row !important;\n  }\n  .d-md-table-cell {\n    display: table-cell !important;\n  }\n  .d-md-flex {\n    display: -ms-flexbox !important;\n    display: flex !important;\n  }\n  .d-md-inline-flex {\n    display: -ms-inline-flexbox !important;\n    display: inline-flex !important;\n  }\n}\n\n@media (min-width: 992px) {\n  .d-lg-none {\n    display: none !important;\n  }\n  .d-lg-inline {\n    display: inline !important;\n  }\n  .d-lg-inline-block {\n    display: inline-block !important;\n  }\n  .d-lg-block {\n    display: block !important;\n  }\n  .d-lg-table {\n    display: table !important;\n  }\n  .d-lg-table-row {\n    display: table-row !important;\n  }\n  .d-lg-table-cell {\n    display: table-cell !important;\n  }\n  .d-lg-flex {\n    display: -ms-flexbox !important;\n    display: flex !important;\n  }\n  .d-lg-inline-flex {\n    display: -ms-inline-flexbox !important;\n    display: inline-flex !important;\n  }\n}\n\n@media (min-width: 1200px) {\n  .d-xl-none {\n    display: none !important;\n  }\n  .d-xl-inline {\n    display: inline !important;\n  }\n  .d-xl-inline-block {\n    display: inline-block !important;\n  }\n  .d-xl-block {\n    display: block !important;\n  }\n  .d-xl-table {\n    display: table !important;\n  }\n  .d-xl-table-row {\n    display: table-row !important;\n  }\n  .d-xl-table-cell {\n    display: table-cell !important;\n  }\n  .d-xl-flex {\n    display: -ms-flexbox !important;\n    display: flex !important;\n  }\n  .d-xl-inline-flex {\n    display: -ms-inline-flexbox !important;\n    display: inline-flex !important;\n  }\n}\n\n@media print {\n  .d-print-none {\n    display: none !important;\n  }\n  .d-print-inline {\n    display: inline !important;\n  }\n  .d-print-inline-block {\n    display: inline-block !important;\n  }\n  .d-print-block {\n    display: block !important;\n  }\n  .d-print-table {\n    display: table !important;\n  }\n  .d-print-table-row {\n    display: table-row !important;\n  }\n  .d-print-table-cell {\n    display: table-cell !important;\n  }\n  .d-print-flex {\n    display: -ms-flexbox !important;\n    display: flex !important;\n  }\n  .d-print-inline-flex {\n    display: -ms-inline-flexbox !important;\n    display: inline-flex !important;\n  }\n}\n\n.embed-responsive {\n  position: relative;\n  display: block;\n  width: 100%;\n  padding: 0;\n  overflow: hidden;\n}\n\n.embed-responsive::before {\n  display: block;\n  content: \"\";\n}\n\n.embed-responsive .embed-responsive-item,\n.embed-responsive iframe,\n.embed-responsive embed,\n.embed-responsive object,\n.embed-responsive video {\n  position: absolute;\n  top: 0;\n  bottom: 0;\n  left: 0;\n  width: 100%;\n  height: 100%;\n  border: 0;\n}\n\n.embed-responsive-21by9::before {\n  padding-top: 42.857143%;\n}\n\n.embed-responsive-16by9::before {\n  padding-top: 56.25%;\n}\n\n.embed-responsive-4by3::before {\n  padding-top: 75%;\n}\n\n.embed-responsive-1by1::before {\n  padding-top: 100%;\n}\n\n.flex-row {\n  -ms-flex-direction: row !important;\n  flex-direction: row !important;\n}\n\n.flex-column {\n  -ms-flex-direction: column !important;\n  flex-direction: column !important;\n}\n\n.flex-row-reverse {\n  -ms-flex-direction: row-reverse !important;\n  flex-direction: row-reverse !important;\n}\n\n.flex-column-reverse {\n  -ms-flex-direction: column-reverse !important;\n  flex-direction: column-reverse !important;\n}\n\n.flex-wrap {\n  -ms-flex-wrap: wrap !important;\n  flex-wrap: wrap !important;\n}\n\n.flex-nowrap {\n  -ms-flex-wrap: nowrap !important;\n  flex-wrap: nowrap !important;\n}\n\n.flex-wrap-reverse {\n  -ms-flex-wrap: wrap-reverse !important;\n  flex-wrap: wrap-reverse !important;\n}\n\n.flex-fill {\n  -ms-flex: 1 1 auto !important;\n  flex: 1 1 auto !important;\n}\n\n.flex-grow-0 {\n  -ms-flex-positive: 0 !important;\n  flex-grow: 0 !important;\n}\n\n.flex-grow-1 {\n  -ms-flex-positive: 1 !important;\n  flex-grow: 1 !important;\n}\n\n.flex-shrink-0 {\n  -ms-flex-negative: 0 !important;\n  flex-shrink: 0 !important;\n}\n\n.flex-shrink-1 {\n  -ms-flex-negative: 1 !important;\n  flex-shrink: 1 !important;\n}\n\n.justify-content-start {\n  -ms-flex-pack: start !important;\n  justify-content: flex-start !important;\n}\n\n.justify-content-end {\n  -ms-flex-pack: end !important;\n  justify-content: flex-end !important;\n}\n\n.justify-content-center {\n  -ms-flex-pack: center !important;\n  justify-content: center !important;\n}\n\n.justify-content-between {\n  -ms-flex-pack: justify !important;\n  justify-content: space-between !important;\n}\n\n.justify-content-around {\n  -ms-flex-pack: distribute !important;\n  justify-content: space-around !important;\n}\n\n.align-items-start {\n  -ms-flex-align: start !important;\n  align-items: flex-start !important;\n}\n\n.align-items-end {\n  -ms-flex-align: end !important;\n  align-items: flex-end !important;\n}\n\n.align-items-center {\n  -ms-flex-align: center !important;\n  align-items: center !important;\n}\n\n.align-items-baseline {\n  -ms-flex-align: baseline !important;\n  align-items: baseline !important;\n}\n\n.align-items-stretch {\n  -ms-flex-align: stretch !important;\n  align-items: stretch !important;\n}\n\n.align-content-start {\n  -ms-flex-line-pack: start !important;\n  align-content: flex-start !important;\n}\n\n.align-content-end {\n  -ms-flex-line-pack: end !important;\n  align-content: flex-end !important;\n}\n\n.align-content-center {\n  -ms-flex-line-pack: center !important;\n  align-content: center !important;\n}\n\n.align-content-between {\n  -ms-flex-line-pack: justify !important;\n  align-content: space-between !important;\n}\n\n.align-content-around {\n  -ms-flex-line-pack: distribute !important;\n  align-content: space-around !important;\n}\n\n.align-content-stretch {\n  -ms-flex-line-pack: stretch !important;\n  align-content: stretch !important;\n}\n\n.align-self-auto {\n  -ms-flex-item-align: auto !important;\n  align-self: auto !important;\n}\n\n.align-self-start {\n  -ms-flex-item-align: start !important;\n  align-self: flex-start !important;\n}\n\n.align-self-end {\n  -ms-flex-item-align: end !important;\n  align-self: flex-end !important;\n}\n\n.align-self-center {\n  -ms-flex-item-align: center !important;\n  align-self: center !important;\n}\n\n.align-self-baseline {\n  -ms-flex-item-align: baseline !important;\n  align-self: baseline !important;\n}\n\n.align-self-stretch {\n  -ms-flex-item-align: stretch !important;\n  align-self: stretch !important;\n}\n\n@media (min-width: 576px) {\n  .flex-sm-row {\n    -ms-flex-direction: row !important;\n    flex-direction: row !important;\n  }\n  .flex-sm-column {\n    -ms-flex-direction: column !important;\n    flex-direction: column !important;\n  }\n  .flex-sm-row-reverse {\n    -ms-flex-direction: row-reverse !important;\n    flex-direction: row-reverse !important;\n  }\n  .flex-sm-column-reverse {\n    -ms-flex-direction: column-reverse !important;\n    flex-direction: column-reverse !important;\n  }\n  .flex-sm-wrap {\n    -ms-flex-wrap: wrap !important;\n    flex-wrap: wrap !important;\n  }\n  .flex-sm-nowrap {\n    -ms-flex-wrap: nowrap !important;\n    flex-wrap: nowrap !important;\n  }\n  .flex-sm-wrap-reverse {\n    -ms-flex-wrap: wrap-reverse !important;\n    flex-wrap: wrap-reverse !important;\n  }\n  .flex-sm-fill {\n    -ms-flex: 1 1 auto !important;\n    flex: 1 1 auto !important;\n  }\n  .flex-sm-grow-0 {\n    -ms-flex-positive: 0 !important;\n    flex-grow: 0 !important;\n  }\n  .flex-sm-grow-1 {\n    -ms-flex-positive: 1 !important;\n    flex-grow: 1 !important;\n  }\n  .flex-sm-shrink-0 {\n    -ms-flex-negative: 0 !important;\n    flex-shrink: 0 !important;\n  }\n  .flex-sm-shrink-1 {\n    -ms-flex-negative: 1 !important;\n    flex-shrink: 1 !important;\n  }\n  .justify-content-sm-start {\n    -ms-flex-pack: start !important;\n    justify-content: flex-start !important;\n  }\n  .justify-content-sm-end {\n    -ms-flex-pack: end !important;\n    justify-content: flex-end !important;\n  }\n  .justify-content-sm-center {\n    -ms-flex-pack: center !important;\n    justify-content: center !important;\n  }\n  .justify-content-sm-between {\n    -ms-flex-pack: justify !important;\n    justify-content: space-between !important;\n  }\n  .justify-content-sm-around {\n    -ms-flex-pack: distribute !important;\n    justify-content: space-around !important;\n  }\n  .align-items-sm-start {\n    -ms-flex-align: start !important;\n    align-items: flex-start !important;\n  }\n  .align-items-sm-end {\n    -ms-flex-align: end !important;\n    align-items: flex-end !important;\n  }\n  .align-items-sm-center {\n    -ms-flex-align: center !important;\n    align-items: center !important;\n  }\n  .align-items-sm-baseline {\n    -ms-flex-align: baseline !important;\n    align-items: baseline !important;\n  }\n  .align-items-sm-stretch {\n    -ms-flex-align: stretch !important;\n    align-items: stretch !important;\n  }\n  .align-content-sm-start {\n    -ms-flex-line-pack: start !important;\n    align-content: flex-start !important;\n  }\n  .align-content-sm-end {\n    -ms-flex-line-pack: end !important;\n    align-content: flex-end !important;\n  }\n  .align-content-sm-center {\n    -ms-flex-line-pack: center !important;\n    align-content: center !important;\n  }\n  .align-content-sm-between {\n    -ms-flex-line-pack: justify !important;\n    align-content: space-between !important;\n  }\n  .align-content-sm-around {\n    -ms-flex-line-pack: distribute !important;\n    align-content: space-around !important;\n  }\n  .align-content-sm-stretch {\n    -ms-flex-line-pack: stretch !important;\n    align-content: stretch !important;\n  }\n  .align-self-sm-auto {\n    -ms-flex-item-align: auto !important;\n    align-self: auto !important;\n  }\n  .align-self-sm-start {\n    -ms-flex-item-align: start !important;\n    align-self: flex-start !important;\n  }\n  .align-self-sm-end {\n    -ms-flex-item-align: end !important;\n    align-self: flex-end !important;\n  }\n  .align-self-sm-center {\n    -ms-flex-item-align: center !important;\n    align-self: center !important;\n  }\n  .align-self-sm-baseline {\n    -ms-flex-item-align: baseline !important;\n    align-self: baseline !important;\n  }\n  .align-self-sm-stretch {\n    -ms-flex-item-align: stretch !important;\n    align-self: stretch !important;\n  }\n}\n\n@media (min-width: 768px) {\n  .flex-md-row {\n    -ms-flex-direction: row !important;\n    flex-direction: row !important;\n  }\n  .flex-md-column {\n    -ms-flex-direction: column !important;\n    flex-direction: column !important;\n  }\n  .flex-md-row-reverse {\n    -ms-flex-direction: row-reverse !important;\n    flex-direction: row-reverse !important;\n  }\n  .flex-md-column-reverse {\n    -ms-flex-direction: column-reverse !important;\n    flex-direction: column-reverse !important;\n  }\n  .flex-md-wrap {\n    -ms-flex-wrap: wrap !important;\n    flex-wrap: wrap !important;\n  }\n  .flex-md-nowrap {\n    -ms-flex-wrap: nowrap !important;\n    flex-wrap: nowrap !important;\n  }\n  .flex-md-wrap-reverse {\n    -ms-flex-wrap: wrap-reverse !important;\n    flex-wrap: wrap-reverse !important;\n  }\n  .flex-md-fill {\n    -ms-flex: 1 1 auto !important;\n    flex: 1 1 auto !important;\n  }\n  .flex-md-grow-0 {\n    -ms-flex-positive: 0 !important;\n    flex-grow: 0 !important;\n  }\n  .flex-md-grow-1 {\n    -ms-flex-positive: 1 !important;\n    flex-grow: 1 !important;\n  }\n  .flex-md-shrink-0 {\n    -ms-flex-negative: 0 !important;\n    flex-shrink: 0 !important;\n  }\n  .flex-md-shrink-1 {\n    -ms-flex-negative: 1 !important;\n    flex-shrink: 1 !important;\n  }\n  .justify-content-md-start {\n    -ms-flex-pack: start !important;\n    justify-content: flex-start !important;\n  }\n  .justify-content-md-end {\n    -ms-flex-pack: end !important;\n    justify-content: flex-end !important;\n  }\n  .justify-content-md-center {\n    -ms-flex-pack: center !important;\n    justify-content: center !important;\n  }\n  .justify-content-md-between {\n    -ms-flex-pack: justify !important;\n    justify-content: space-between !important;\n  }\n  .justify-content-md-around {\n    -ms-flex-pack: distribute !important;\n    justify-content: space-around !important;\n  }\n  .align-items-md-start {\n    -ms-flex-align: start !important;\n    align-items: flex-start !important;\n  }\n  .align-items-md-end {\n    -ms-flex-align: end !important;\n    align-items: flex-end !important;\n  }\n  .align-items-md-center {\n    -ms-flex-align: center !important;\n    align-items: center !important;\n  }\n  .align-items-md-baseline {\n    -ms-flex-align: baseline !important;\n    align-items: baseline !important;\n  }\n  .align-items-md-stretch {\n    -ms-flex-align: stretch !important;\n    align-items: stretch !important;\n  }\n  .align-content-md-start {\n    -ms-flex-line-pack: start !important;\n    align-content: flex-start !important;\n  }\n  .align-content-md-end {\n    -ms-flex-line-pack: end !important;\n    align-content: flex-end !important;\n  }\n  .align-content-md-center {\n    -ms-flex-line-pack: center !important;\n    align-content: center !important;\n  }\n  .align-content-md-between {\n    -ms-flex-line-pack: justify !important;\n    align-content: space-between !important;\n  }\n  .align-content-md-around {\n    -ms-flex-line-pack: distribute !important;\n    align-content: space-around !important;\n  }\n  .align-content-md-stretch {\n    -ms-flex-line-pack: stretch !important;\n    align-content: stretch !important;\n  }\n  .align-self-md-auto {\n    -ms-flex-item-align: auto !important;\n    align-self: auto !important;\n  }\n  .align-self-md-start {\n    -ms-flex-item-align: start !important;\n    align-self: flex-start !important;\n  }\n  .align-self-md-end {\n    -ms-flex-item-align: end !important;\n    align-self: flex-end !important;\n  }\n  .align-self-md-center {\n    -ms-flex-item-align: center !important;\n    align-self: center !important;\n  }\n  .align-self-md-baseline {\n    -ms-flex-item-align: baseline !important;\n    align-self: baseline !important;\n  }\n  .align-self-md-stretch {\n    -ms-flex-item-align: stretch !important;\n    align-self: stretch !important;\n  }\n}\n\n@media (min-width: 992px) {\n  .flex-lg-row {\n    -ms-flex-direction: row !important;\n    flex-direction: row !important;\n  }\n  .flex-lg-column {\n    -ms-flex-direction: column !important;\n    flex-direction: column !important;\n  }\n  .flex-lg-row-reverse {\n    -ms-flex-direction: row-reverse !important;\n    flex-direction: row-reverse !important;\n  }\n  .flex-lg-column-reverse {\n    -ms-flex-direction: column-reverse !important;\n    flex-direction: column-reverse !important;\n  }\n  .flex-lg-wrap {\n    -ms-flex-wrap: wrap !important;\n    flex-wrap: wrap !important;\n  }\n  .flex-lg-nowrap {\n    -ms-flex-wrap: nowrap !important;\n    flex-wrap: nowrap !important;\n  }\n  .flex-lg-wrap-reverse {\n    -ms-flex-wrap: wrap-reverse !important;\n    flex-wrap: wrap-reverse !important;\n  }\n  .flex-lg-fill {\n    -ms-flex: 1 1 auto !important;\n    flex: 1 1 auto !important;\n  }\n  .flex-lg-grow-0 {\n    -ms-flex-positive: 0 !important;\n    flex-grow: 0 !important;\n  }\n  .flex-lg-grow-1 {\n    -ms-flex-positive: 1 !important;\n    flex-grow: 1 !important;\n  }\n  .flex-lg-shrink-0 {\n    -ms-flex-negative: 0 !important;\n    flex-shrink: 0 !important;\n  }\n  .flex-lg-shrink-1 {\n    -ms-flex-negative: 1 !important;\n    flex-shrink: 1 !important;\n  }\n  .justify-content-lg-start {\n    -ms-flex-pack: start !important;\n    justify-content: flex-start !important;\n  }\n  .justify-content-lg-end {\n    -ms-flex-pack: end !important;\n    justify-content: flex-end !important;\n  }\n  .justify-content-lg-center {\n    -ms-flex-pack: center !important;\n    justify-content: center !important;\n  }\n  .justify-content-lg-between {\n    -ms-flex-pack: justify !important;\n    justify-content: space-between !important;\n  }\n  .justify-content-lg-around {\n    -ms-flex-pack: distribute !important;\n    justify-content: space-around !important;\n  }\n  .align-items-lg-start {\n    -ms-flex-align: start !important;\n    align-items: flex-start !important;\n  }\n  .align-items-lg-end {\n    -ms-flex-align: end !important;\n    align-items: flex-end !important;\n  }\n  .align-items-lg-center {\n    -ms-flex-align: center !important;\n    align-items: center !important;\n  }\n  .align-items-lg-baseline {\n    -ms-flex-align: baseline !important;\n    align-items: baseline !important;\n  }\n  .align-items-lg-stretch {\n    -ms-flex-align: stretch !important;\n    align-items: stretch !important;\n  }\n  .align-content-lg-start {\n    -ms-flex-line-pack: start !important;\n    align-content: flex-start !important;\n  }\n  .align-content-lg-end {\n    -ms-flex-line-pack: end !important;\n    align-content: flex-end !important;\n  }\n  .align-content-lg-center {\n    -ms-flex-line-pack: center !important;\n    align-content: center !important;\n  }\n  .align-content-lg-between {\n    -ms-flex-line-pack: justify !important;\n    align-content: space-between !important;\n  }\n  .align-content-lg-around {\n    -ms-flex-line-pack: distribute !important;\n    align-content: space-around !important;\n  }\n  .align-content-lg-stretch {\n    -ms-flex-line-pack: stretch !important;\n    align-content: stretch !important;\n  }\n  .align-self-lg-auto {\n    -ms-flex-item-align: auto !important;\n    align-self: auto !important;\n  }\n  .align-self-lg-start {\n    -ms-flex-item-align: start !important;\n    align-self: flex-start !important;\n  }\n  .align-self-lg-end {\n    -ms-flex-item-align: end !important;\n    align-self: flex-end !important;\n  }\n  .align-self-lg-center {\n    -ms-flex-item-align: center !important;\n    align-self: center !important;\n  }\n  .align-self-lg-baseline {\n    -ms-flex-item-align: baseline !important;\n    align-self: baseline !important;\n  }\n  .align-self-lg-stretch {\n    -ms-flex-item-align: stretch !important;\n    align-self: stretch !important;\n  }\n}\n\n@media (min-width: 1200px) {\n  .flex-xl-row {\n    -ms-flex-direction: row !important;\n    flex-direction: row !important;\n  }\n  .flex-xl-column {\n    -ms-flex-direction: column !important;\n    flex-direction: column !important;\n  }\n  .flex-xl-row-reverse {\n    -ms-flex-direction: row-reverse !important;\n    flex-direction: row-reverse !important;\n  }\n  .flex-xl-column-reverse {\n    -ms-flex-direction: column-reverse !important;\n    flex-direction: column-reverse !important;\n  }\n  .flex-xl-wrap {\n    -ms-flex-wrap: wrap !important;\n    flex-wrap: wrap !important;\n  }\n  .flex-xl-nowrap {\n    -ms-flex-wrap: nowrap !important;\n    flex-wrap: nowrap !important;\n  }\n  .flex-xl-wrap-reverse {\n    -ms-flex-wrap: wrap-reverse !important;\n    flex-wrap: wrap-reverse !important;\n  }\n  .flex-xl-fill {\n    -ms-flex: 1 1 auto !important;\n    flex: 1 1 auto !important;\n  }\n  .flex-xl-grow-0 {\n    -ms-flex-positive: 0 !important;\n    flex-grow: 0 !important;\n  }\n  .flex-xl-grow-1 {\n    -ms-flex-positive: 1 !important;\n    flex-grow: 1 !important;\n  }\n  .flex-xl-shrink-0 {\n    -ms-flex-negative: 0 !important;\n    flex-shrink: 0 !important;\n  }\n  .flex-xl-shrink-1 {\n    -ms-flex-negative: 1 !important;\n    flex-shrink: 1 !important;\n  }\n  .justify-content-xl-start {\n    -ms-flex-pack: start !important;\n    justify-content: flex-start !important;\n  }\n  .justify-content-xl-end {\n    -ms-flex-pack: end !important;\n    justify-content: flex-end !important;\n  }\n  .justify-content-xl-center {\n    -ms-flex-pack: center !important;\n    justify-content: center !important;\n  }\n  .justify-content-xl-between {\n    -ms-flex-pack: justify !important;\n    justify-content: space-between !important;\n  }\n  .justify-content-xl-around {\n    -ms-flex-pack: distribute !important;\n    justify-content: space-around !important;\n  }\n  .align-items-xl-start {\n    -ms-flex-align: start !important;\n    align-items: flex-start !important;\n  }\n  .align-items-xl-end {\n    -ms-flex-align: end !important;\n    align-items: flex-end !important;\n  }\n  .align-items-xl-center {\n    -ms-flex-align: center !important;\n    align-items: center !important;\n  }\n  .align-items-xl-baseline {\n    -ms-flex-align: baseline !important;\n    align-items: baseline !important;\n  }\n  .align-items-xl-stretch {\n    -ms-flex-align: stretch !important;\n    align-items: stretch !important;\n  }\n  .align-content-xl-start {\n    -ms-flex-line-pack: start !important;\n    align-content: flex-start !important;\n  }\n  .align-content-xl-end {\n    -ms-flex-line-pack: end !important;\n    align-content: flex-end !important;\n  }\n  .align-content-xl-center {\n    -ms-flex-line-pack: center !important;\n    align-content: center !important;\n  }\n  .align-content-xl-between {\n    -ms-flex-line-pack: justify !important;\n    align-content: space-between !important;\n  }\n  .align-content-xl-around {\n    -ms-flex-line-pack: distribute !important;\n    align-content: space-around !important;\n  }\n  .align-content-xl-stretch {\n    -ms-flex-line-pack: stretch !important;\n    align-content: stretch !important;\n  }\n  .align-self-xl-auto {\n    -ms-flex-item-align: auto !important;\n    align-self: auto !important;\n  }\n  .align-self-xl-start {\n    -ms-flex-item-align: start !important;\n    align-self: flex-start !important;\n  }\n  .align-self-xl-end {\n    -ms-flex-item-align: end !important;\n    align-self: flex-end !important;\n  }\n  .align-self-xl-center {\n    -ms-flex-item-align: center !important;\n    align-self: center !important;\n  }\n  .align-self-xl-baseline {\n    -ms-flex-item-align: baseline !important;\n    align-self: baseline !important;\n  }\n  .align-self-xl-stretch {\n    -ms-flex-item-align: stretch !important;\n    align-self: stretch !important;\n  }\n}\n\n.float-left {\n  float: left !important;\n}\n\n.float-right {\n  float: right !important;\n}\n\n.float-none {\n  float: none !important;\n}\n\n@media (min-width: 576px) {\n  .float-sm-left {\n    float: left !important;\n  }\n  .float-sm-right {\n    float: right !important;\n  }\n  .float-sm-none {\n    float: none !important;\n  }\n}\n\n@media (min-width: 768px) {\n  .float-md-left {\n    float: left !important;\n  }\n  .float-md-right {\n    float: right !important;\n  }\n  .float-md-none {\n    float: none !important;\n  }\n}\n\n@media (min-width: 992px) {\n  .float-lg-left {\n    float: left !important;\n  }\n  .float-lg-right {\n    float: right !important;\n  }\n  .float-lg-none {\n    float: none !important;\n  }\n}\n\n@media (min-width: 1200px) {\n  .float-xl-left {\n    float: left !important;\n  }\n  .float-xl-right {\n    float: right !important;\n  }\n  .float-xl-none {\n    float: none !important;\n  }\n}\n\n.overflow-auto {\n  overflow: auto !important;\n}\n\n.overflow-hidden {\n  overflow: hidden !important;\n}\n\n.position-static {\n  position: static !important;\n}\n\n.position-relative {\n  position: relative !important;\n}\n\n.position-absolute {\n  position: absolute !important;\n}\n\n.position-fixed {\n  position: fixed !important;\n}\n\n.position-sticky {\n  position: -webkit-sticky !important;\n  position: sticky !important;\n}\n\n.fixed-top {\n  position: fixed;\n  top: 0;\n  right: 0;\n  left: 0;\n  z-index: 1030;\n}\n\n.fixed-bottom {\n  position: fixed;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  z-index: 1030;\n}\n\n@supports ((position: -webkit-sticky) or (position: sticky)) {\n  .sticky-top {\n    position: -webkit-sticky;\n    position: sticky;\n    top: 0;\n    z-index: 1020;\n  }\n}\n\n.sr-only {\n  position: absolute;\n  width: 1px;\n  height: 1px;\n  padding: 0;\n  overflow: hidden;\n  clip: rect(0, 0, 0, 0);\n  white-space: nowrap;\n  border: 0;\n}\n\n.sr-only-focusable:active, .sr-only-focusable:focus {\n  position: static;\n  width: auto;\n  height: auto;\n  overflow: visible;\n  clip: auto;\n  white-space: normal;\n}\n\n.shadow-sm {\n  box-shadow: 0 0.125rem 0.25rem rgba(0, 0, 0, 0.075) !important;\n}\n\n.shadow {\n  box-shadow: 0 0.5rem 1rem rgba(0, 0, 0, 0.15) !important;\n}\n\n.shadow-lg {\n  box-shadow: 0 1rem 3rem rgba(0, 0, 0, 0.175) !important;\n}\n\n.shadow-none {\n  box-shadow: none !important;\n}\n\n.w-25 {\n  width: 25% !important;\n}\n\n.w-50 {\n  width: 50% !important;\n}\n\n.w-75 {\n  width: 75% !important;\n}\n\n.w-100 {\n  width: 100% !important;\n}\n\n.w-auto {\n  width: auto !important;\n}\n\n.h-25 {\n  height: 25% !important;\n}\n\n.h-50 {\n  height: 50% !important;\n}\n\n.h-75 {\n  height: 75% !important;\n}\n\n.h-100 {\n  height: 100% !important;\n}\n\n.h-auto {\n  height: auto !important;\n}\n\n.mw-100 {\n  max-width: 100% !important;\n}\n\n.mh-100 {\n  max-height: 100% !important;\n}\n\n.min-vw-100 {\n  min-width: 100vw !important;\n}\n\n.min-vh-100 {\n  min-height: 100vh !important;\n}\n\n.vw-100 {\n  width: 100vw !important;\n}\n\n.vh-100 {\n  height: 100vh !important;\n}\n\n.stretched-link::after {\n  position: absolute;\n  top: 0;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  z-index: 1;\n  pointer-events: auto;\n  content: \"\";\n  background-color: rgba(0, 0, 0, 0);\n}\n\n.m-0 {\n  margin: 0 !important;\n}\n\n.mt-0,\n.my-0 {\n  margin-top: 0 !important;\n}\n\n.mr-0,\n.mx-0 {\n  margin-right: 0 !important;\n}\n\n.mb-0,\n.my-0 {\n  margin-bottom: 0 !important;\n}\n\n.ml-0,\n.mx-0 {\n  margin-left: 0 !important;\n}\n\n.m-1 {\n  margin: 0.25rem !important;\n}\n\n.mt-1,\n.my-1 {\n  margin-top: 0.25rem !important;\n}\n\n.mr-1,\n.mx-1 {\n  margin-right: 0.25rem !important;\n}\n\n.mb-1,\n.my-1 {\n  margin-bottom: 0.25rem !important;\n}\n\n.ml-1,\n.mx-1 {\n  margin-left: 0.25rem !important;\n}\n\n.m-2 {\n  margin: 0.5rem !important;\n}\n\n.mt-2,\n.my-2 {\n  margin-top: 0.5rem !important;\n}\n\n.mr-2,\n.mx-2 {\n  margin-right: 0.5rem !important;\n}\n\n.mb-2,\n.my-2 {\n  margin-bottom: 0.5rem !important;\n}\n\n.ml-2,\n.mx-2 {\n  margin-left: 0.5rem !important;\n}\n\n.m-3 {\n  margin: 1rem !important;\n}\n\n.mt-3,\n.my-3 {\n  margin-top: 1rem !important;\n}\n\n.mr-3,\n.mx-3 {\n  margin-right: 1rem !important;\n}\n\n.mb-3,\n.my-3 {\n  margin-bottom: 1rem !important;\n}\n\n.ml-3,\n.mx-3 {\n  margin-left: 1rem !important;\n}\n\n.m-4 {\n  margin: 1.5rem !important;\n}\n\n.mt-4,\n.my-4 {\n  margin-top: 1.5rem !important;\n}\n\n.mr-4,\n.mx-4 {\n  margin-right: 1.5rem !important;\n}\n\n.mb-4,\n.my-4 {\n  margin-bottom: 1.5rem !important;\n}\n\n.ml-4,\n.mx-4 {\n  margin-left: 1.5rem !important;\n}\n\n.m-5 {\n  margin: 3rem !important;\n}\n\n.mt-5,\n.my-5 {\n  margin-top: 3rem !important;\n}\n\n.mr-5,\n.mx-5 {\n  margin-right: 3rem !important;\n}\n\n.mb-5,\n.my-5 {\n  margin-bottom: 3rem !important;\n}\n\n.ml-5,\n.mx-5 {\n  margin-left: 3rem !important;\n}\n\n.p-0 {\n  padding: 0 !important;\n}\n\n.pt-0,\n.py-0 {\n  padding-top: 0 !important;\n}\n\n.pr-0,\n.px-0 {\n  padding-right: 0 !important;\n}\n\n.pb-0,\n.py-0 {\n  padding-bottom: 0 !important;\n}\n\n.pl-0,\n.px-0 {\n  padding-left: 0 !important;\n}\n\n.p-1 {\n  padding: 0.25rem !important;\n}\n\n.pt-1,\n.py-1 {\n  padding-top: 0.25rem !important;\n}\n\n.pr-1,\n.px-1 {\n  padding-right: 0.25rem !important;\n}\n\n.pb-1,\n.py-1 {\n  padding-bottom: 0.25rem !important;\n}\n\n.pl-1,\n.px-1 {\n  padding-left: 0.25rem !important;\n}\n\n.p-2 {\n  padding: 0.5rem !important;\n}\n\n.pt-2,\n.py-2 {\n  padding-top: 0.5rem !important;\n}\n\n.pr-2,\n.px-2 {\n  padding-right: 0.5rem !important;\n}\n\n.pb-2,\n.py-2 {\n  padding-bottom: 0.5rem !important;\n}\n\n.pl-2,\n.px-2 {\n  padding-left: 0.5rem !important;\n}\n\n.p-3 {\n  padding: 1rem !important;\n}\n\n.pt-3,\n.py-3 {\n  padding-top: 1rem !important;\n}\n\n.pr-3,\n.px-3 {\n  padding-right: 1rem !important;\n}\n\n.pb-3,\n.py-3 {\n  padding-bottom: 1rem !important;\n}\n\n.pl-3,\n.px-3 {\n  padding-left: 1rem !important;\n}\n\n.p-4 {\n  padding: 1.5rem !important;\n}\n\n.pt-4,\n.py-4 {\n  padding-top: 1.5rem !important;\n}\n\n.pr-4,\n.px-4 {\n  padding-right: 1.5rem !important;\n}\n\n.pb-4,\n.py-4 {\n  padding-bottom: 1.5rem !important;\n}\n\n.pl-4,\n.px-4 {\n  padding-left: 1.5rem !important;\n}\n\n.p-5 {\n  padding: 3rem !important;\n}\n\n.pt-5,\n.py-5 {\n  padding-top: 3rem !important;\n}\n\n.pr-5,\n.px-5 {\n  padding-right: 3rem !important;\n}\n\n.pb-5,\n.py-5 {\n  padding-bottom: 3rem !important;\n}\n\n.pl-5,\n.px-5 {\n  padding-left: 3rem !important;\n}\n\n.m-n1 {\n  margin: -0.25rem !important;\n}\n\n.mt-n1,\n.my-n1 {\n  margin-top: -0.25rem !important;\n}\n\n.mr-n1,\n.mx-n1 {\n  margin-right: -0.25rem !important;\n}\n\n.mb-n1,\n.my-n1 {\n  margin-bottom: -0.25rem !important;\n}\n\n.ml-n1,\n.mx-n1 {\n  margin-left: -0.25rem !important;\n}\n\n.m-n2 {\n  margin: -0.5rem !important;\n}\n\n.mt-n2,\n.my-n2 {\n  margin-top: -0.5rem !important;\n}\n\n.mr-n2,\n.mx-n2 {\n  margin-right: -0.5rem !important;\n}\n\n.mb-n2,\n.my-n2 {\n  margin-bottom: -0.5rem !important;\n}\n\n.ml-n2,\n.mx-n2 {\n  margin-left: -0.5rem !important;\n}\n\n.m-n3 {\n  margin: -1rem !important;\n}\n\n.mt-n3,\n.my-n3 {\n  margin-top: -1rem !important;\n}\n\n.mr-n3,\n.mx-n3 {\n  margin-right: -1rem !important;\n}\n\n.mb-n3,\n.my-n3 {\n  margin-bottom: -1rem !important;\n}\n\n.ml-n3,\n.mx-n3 {\n  margin-left: -1rem !important;\n}\n\n.m-n4 {\n  margin: -1.5rem !important;\n}\n\n.mt-n4,\n.my-n4 {\n  margin-top: -1.5rem !important;\n}\n\n.mr-n4,\n.mx-n4 {\n  margin-right: -1.5rem !important;\n}\n\n.mb-n4,\n.my-n4 {\n  margin-bottom: -1.5rem !important;\n}\n\n.ml-n4,\n.mx-n4 {\n  margin-left: -1.5rem !important;\n}\n\n.m-n5 {\n  margin: -3rem !important;\n}\n\n.mt-n5,\n.my-n5 {\n  margin-top: -3rem !important;\n}\n\n.mr-n5,\n.mx-n5 {\n  margin-right: -3rem !important;\n}\n\n.mb-n5,\n.my-n5 {\n  margin-bottom: -3rem !important;\n}\n\n.ml-n5,\n.mx-n5 {\n  margin-left: -3rem !important;\n}\n\n.m-auto {\n  margin: auto !important;\n}\n\n.mt-auto,\n.my-auto {\n  margin-top: auto !important;\n}\n\n.mr-auto,\n.mx-auto {\n  margin-right: auto !important;\n}\n\n.mb-auto,\n.my-auto {\n  margin-bottom: auto !important;\n}\n\n.ml-auto,\n.mx-auto {\n  margin-left: auto !important;\n}\n\n@media (min-width: 576px) {\n  .m-sm-0 {\n    margin: 0 !important;\n  }\n  .mt-sm-0,\n  .my-sm-0 {\n    margin-top: 0 !important;\n  }\n  .mr-sm-0,\n  .mx-sm-0 {\n    margin-right: 0 !important;\n  }\n  .mb-sm-0,\n  .my-sm-0 {\n    margin-bottom: 0 !important;\n  }\n  .ml-sm-0,\n  .mx-sm-0 {\n    margin-left: 0 !important;\n  }\n  .m-sm-1 {\n    margin: 0.25rem !important;\n  }\n  .mt-sm-1,\n  .my-sm-1 {\n    margin-top: 0.25rem !important;\n  }\n  .mr-sm-1,\n  .mx-sm-1 {\n    margin-right: 0.25rem !important;\n  }\n  .mb-sm-1,\n  .my-sm-1 {\n    margin-bottom: 0.25rem !important;\n  }\n  .ml-sm-1,\n  .mx-sm-1 {\n    margin-left: 0.25rem !important;\n  }\n  .m-sm-2 {\n    margin: 0.5rem !important;\n  }\n  .mt-sm-2,\n  .my-sm-2 {\n    margin-top: 0.5rem !important;\n  }\n  .mr-sm-2,\n  .mx-sm-2 {\n    margin-right: 0.5rem !important;\n  }\n  .mb-sm-2,\n  .my-sm-2 {\n    margin-bottom: 0.5rem !important;\n  }\n  .ml-sm-2,\n  .mx-sm-2 {\n    margin-left: 0.5rem !important;\n  }\n  .m-sm-3 {\n    margin: 1rem !important;\n  }\n  .mt-sm-3,\n  .my-sm-3 {\n    margin-top: 1rem !important;\n  }\n  .mr-sm-3,\n  .mx-sm-3 {\n    margin-right: 1rem !important;\n  }\n  .mb-sm-3,\n  .my-sm-3 {\n    margin-bottom: 1rem !important;\n  }\n  .ml-sm-3,\n  .mx-sm-3 {\n    margin-left: 1rem !important;\n  }\n  .m-sm-4 {\n    margin: 1.5rem !important;\n  }\n  .mt-sm-4,\n  .my-sm-4 {\n    margin-top: 1.5rem !important;\n  }\n  .mr-sm-4,\n  .mx-sm-4 {\n    margin-right: 1.5rem !important;\n  }\n  .mb-sm-4,\n  .my-sm-4 {\n    margin-bottom: 1.5rem !important;\n  }\n  .ml-sm-4,\n  .mx-sm-4 {\n    margin-left: 1.5rem !important;\n  }\n  .m-sm-5 {\n    margin: 3rem !important;\n  }\n  .mt-sm-5,\n  .my-sm-5 {\n    margin-top: 3rem !important;\n  }\n  .mr-sm-5,\n  .mx-sm-5 {\n    margin-right: 3rem !important;\n  }\n  .mb-sm-5,\n  .my-sm-5 {\n    margin-bottom: 3rem !important;\n  }\n  .ml-sm-5,\n  .mx-sm-5 {\n    margin-left: 3rem !important;\n  }\n  .p-sm-0 {\n    padding: 0 !important;\n  }\n  .pt-sm-0,\n  .py-sm-0 {\n    padding-top: 0 !important;\n  }\n  .pr-sm-0,\n  .px-sm-0 {\n    padding-right: 0 !important;\n  }\n  .pb-sm-0,\n  .py-sm-0 {\n    padding-bottom: 0 !important;\n  }\n  .pl-sm-0,\n  .px-sm-0 {\n    padding-left: 0 !important;\n  }\n  .p-sm-1 {\n    padding: 0.25rem !important;\n  }\n  .pt-sm-1,\n  .py-sm-1 {\n    padding-top: 0.25rem !important;\n  }\n  .pr-sm-1,\n  .px-sm-1 {\n    padding-right: 0.25rem !important;\n  }\n  .pb-sm-1,\n  .py-sm-1 {\n    padding-bottom: 0.25rem !important;\n  }\n  .pl-sm-1,\n  .px-sm-1 {\n    padding-left: 0.25rem !important;\n  }\n  .p-sm-2 {\n    padding: 0.5rem !important;\n  }\n  .pt-sm-2,\n  .py-sm-2 {\n    padding-top: 0.5rem !important;\n  }\n  .pr-sm-2,\n  .px-sm-2 {\n    padding-right: 0.5rem !important;\n  }\n  .pb-sm-2,\n  .py-sm-2 {\n    padding-bottom: 0.5rem !important;\n  }\n  .pl-sm-2,\n  .px-sm-2 {\n    padding-left: 0.5rem !important;\n  }\n  .p-sm-3 {\n    padding: 1rem !important;\n  }\n  .pt-sm-3,\n  .py-sm-3 {\n    padding-top: 1rem !important;\n  }\n  .pr-sm-3,\n  .px-sm-3 {\n    padding-right: 1rem !important;\n  }\n  .pb-sm-3,\n  .py-sm-3 {\n    padding-bottom: 1rem !important;\n  }\n  .pl-sm-3,\n  .px-sm-3 {\n    padding-left: 1rem !important;\n  }\n  .p-sm-4 {\n    padding: 1.5rem !important;\n  }\n  .pt-sm-4,\n  .py-sm-4 {\n    padding-top: 1.5rem !important;\n  }\n  .pr-sm-4,\n  .px-sm-4 {\n    padding-right: 1.5rem !important;\n  }\n  .pb-sm-4,\n  .py-sm-4 {\n    padding-bottom: 1.5rem !important;\n  }\n  .pl-sm-4,\n  .px-sm-4 {\n    padding-left: 1.5rem !important;\n  }\n  .p-sm-5 {\n    padding: 3rem !important;\n  }\n  .pt-sm-5,\n  .py-sm-5 {\n    padding-top: 3rem !important;\n  }\n  .pr-sm-5,\n  .px-sm-5 {\n    padding-right: 3rem !important;\n  }\n  .pb-sm-5,\n  .py-sm-5 {\n    padding-bottom: 3rem !important;\n  }\n  .pl-sm-5,\n  .px-sm-5 {\n    padding-left: 3rem !important;\n  }\n  .m-sm-n1 {\n    margin: -0.25rem !important;\n  }\n  .mt-sm-n1,\n  .my-sm-n1 {\n    margin-top: -0.25rem !important;\n  }\n  .mr-sm-n1,\n  .mx-sm-n1 {\n    margin-right: -0.25rem !important;\n  }\n  .mb-sm-n1,\n  .my-sm-n1 {\n    margin-bottom: -0.25rem !important;\n  }\n  .ml-sm-n1,\n  .mx-sm-n1 {\n    margin-left: -0.25rem !important;\n  }\n  .m-sm-n2 {\n    margin: -0.5rem !important;\n  }\n  .mt-sm-n2,\n  .my-sm-n2 {\n    margin-top: -0.5rem !important;\n  }\n  .mr-sm-n2,\n  .mx-sm-n2 {\n    margin-right: -0.5rem !important;\n  }\n  .mb-sm-n2,\n  .my-sm-n2 {\n    margin-bottom: -0.5rem !important;\n  }\n  .ml-sm-n2,\n  .mx-sm-n2 {\n    margin-left: -0.5rem !important;\n  }\n  .m-sm-n3 {\n    margin: -1rem !important;\n  }\n  .mt-sm-n3,\n  .my-sm-n3 {\n    margin-top: -1rem !important;\n  }\n  .mr-sm-n3,\n  .mx-sm-n3 {\n    margin-right: -1rem !important;\n  }\n  .mb-sm-n3,\n  .my-sm-n3 {\n    margin-bottom: -1rem !important;\n  }\n  .ml-sm-n3,\n  .mx-sm-n3 {\n    margin-left: -1rem !important;\n  }\n  .m-sm-n4 {\n    margin: -1.5rem !important;\n  }\n  .mt-sm-n4,\n  .my-sm-n4 {\n    margin-top: -1.5rem !important;\n  }\n  .mr-sm-n4,\n  .mx-sm-n4 {\n    margin-right: -1.5rem !important;\n  }\n  .mb-sm-n4,\n  .my-sm-n4 {\n    margin-bottom: -1.5rem !important;\n  }\n  .ml-sm-n4,\n  .mx-sm-n4 {\n    margin-left: -1.5rem !important;\n  }\n  .m-sm-n5 {\n    margin: -3rem !important;\n  }\n  .mt-sm-n5,\n  .my-sm-n5 {\n    margin-top: -3rem !important;\n  }\n  .mr-sm-n5,\n  .mx-sm-n5 {\n    margin-right: -3rem !important;\n  }\n  .mb-sm-n5,\n  .my-sm-n5 {\n    margin-bottom: -3rem !important;\n  }\n  .ml-sm-n5,\n  .mx-sm-n5 {\n    margin-left: -3rem !important;\n  }\n  .m-sm-auto {\n    margin: auto !important;\n  }\n  .mt-sm-auto,\n  .my-sm-auto {\n    margin-top: auto !important;\n  }\n  .mr-sm-auto,\n  .mx-sm-auto {\n    margin-right: auto !important;\n  }\n  .mb-sm-auto,\n  .my-sm-auto {\n    margin-bottom: auto !important;\n  }\n  .ml-sm-auto,\n  .mx-sm-auto {\n    margin-left: auto !important;\n  }\n}\n\n@media (min-width: 768px) {\n  .m-md-0 {\n    margin: 0 !important;\n  }\n  .mt-md-0,\n  .my-md-0 {\n    margin-top: 0 !important;\n  }\n  .mr-md-0,\n  .mx-md-0 {\n    margin-right: 0 !important;\n  }\n  .mb-md-0,\n  .my-md-0 {\n    margin-bottom: 0 !important;\n  }\n  .ml-md-0,\n  .mx-md-0 {\n    margin-left: 0 !important;\n  }\n  .m-md-1 {\n    margin: 0.25rem !important;\n  }\n  .mt-md-1,\n  .my-md-1 {\n    margin-top: 0.25rem !important;\n  }\n  .mr-md-1,\n  .mx-md-1 {\n    margin-right: 0.25rem !important;\n  }\n  .mb-md-1,\n  .my-md-1 {\n    margin-bottom: 0.25rem !important;\n  }\n  .ml-md-1,\n  .mx-md-1 {\n    margin-left: 0.25rem !important;\n  }\n  .m-md-2 {\n    margin: 0.5rem !important;\n  }\n  .mt-md-2,\n  .my-md-2 {\n    margin-top: 0.5rem !important;\n  }\n  .mr-md-2,\n  .mx-md-2 {\n    margin-right: 0.5rem !important;\n  }\n  .mb-md-2,\n  .my-md-2 {\n    margin-bottom: 0.5rem !important;\n  }\n  .ml-md-2,\n  .mx-md-2 {\n    margin-left: 0.5rem !important;\n  }\n  .m-md-3 {\n    margin: 1rem !important;\n  }\n  .mt-md-3,\n  .my-md-3 {\n    margin-top: 1rem !important;\n  }\n  .mr-md-3,\n  .mx-md-3 {\n    margin-right: 1rem !important;\n  }\n  .mb-md-3,\n  .my-md-3 {\n    margin-bottom: 1rem !important;\n  }\n  .ml-md-3,\n  .mx-md-3 {\n    margin-left: 1rem !important;\n  }\n  .m-md-4 {\n    margin: 1.5rem !important;\n  }\n  .mt-md-4,\n  .my-md-4 {\n    margin-top: 1.5rem !important;\n  }\n  .mr-md-4,\n  .mx-md-4 {\n    margin-right: 1.5rem !important;\n  }\n  .mb-md-4,\n  .my-md-4 {\n    margin-bottom: 1.5rem !important;\n  }\n  .ml-md-4,\n  .mx-md-4 {\n    margin-left: 1.5rem !important;\n  }\n  .m-md-5 {\n    margin: 3rem !important;\n  }\n  .mt-md-5,\n  .my-md-5 {\n    margin-top: 3rem !important;\n  }\n  .mr-md-5,\n  .mx-md-5 {\n    margin-right: 3rem !important;\n  }\n  .mb-md-5,\n  .my-md-5 {\n    margin-bottom: 3rem !important;\n  }\n  .ml-md-5,\n  .mx-md-5 {\n    margin-left: 3rem !important;\n  }\n  .p-md-0 {\n    padding: 0 !important;\n  }\n  .pt-md-0,\n  .py-md-0 {\n    padding-top: 0 !important;\n  }\n  .pr-md-0,\n  .px-md-0 {\n    padding-right: 0 !important;\n  }\n  .pb-md-0,\n  .py-md-0 {\n    padding-bottom: 0 !important;\n  }\n  .pl-md-0,\n  .px-md-0 {\n    padding-left: 0 !important;\n  }\n  .p-md-1 {\n    padding: 0.25rem !important;\n  }\n  .pt-md-1,\n  .py-md-1 {\n    padding-top: 0.25rem !important;\n  }\n  .pr-md-1,\n  .px-md-1 {\n    padding-right: 0.25rem !important;\n  }\n  .pb-md-1,\n  .py-md-1 {\n    padding-bottom: 0.25rem !important;\n  }\n  .pl-md-1,\n  .px-md-1 {\n    padding-left: 0.25rem !important;\n  }\n  .p-md-2 {\n    padding: 0.5rem !important;\n  }\n  .pt-md-2,\n  .py-md-2 {\n    padding-top: 0.5rem !important;\n  }\n  .pr-md-2,\n  .px-md-2 {\n    padding-right: 0.5rem !important;\n  }\n  .pb-md-2,\n  .py-md-2 {\n    padding-bottom: 0.5rem !important;\n  }\n  .pl-md-2,\n  .px-md-2 {\n    padding-left: 0.5rem !important;\n  }\n  .p-md-3 {\n    padding: 1rem !important;\n  }\n  .pt-md-3,\n  .py-md-3 {\n    padding-top: 1rem !important;\n  }\n  .pr-md-3,\n  .px-md-3 {\n    padding-right: 1rem !important;\n  }\n  .pb-md-3,\n  .py-md-3 {\n    padding-bottom: 1rem !important;\n  }\n  .pl-md-3,\n  .px-md-3 {\n    padding-left: 1rem !important;\n  }\n  .p-md-4 {\n    padding: 1.5rem !important;\n  }\n  .pt-md-4,\n  .py-md-4 {\n    padding-top: 1.5rem !important;\n  }\n  .pr-md-4,\n  .px-md-4 {\n    padding-right: 1.5rem !important;\n  }\n  .pb-md-4,\n  .py-md-4 {\n    padding-bottom: 1.5rem !important;\n  }\n  .pl-md-4,\n  .px-md-4 {\n    padding-left: 1.5rem !important;\n  }\n  .p-md-5 {\n    padding: 3rem !important;\n  }\n  .pt-md-5,\n  .py-md-5 {\n    padding-top: 3rem !important;\n  }\n  .pr-md-5,\n  .px-md-5 {\n    padding-right: 3rem !important;\n  }\n  .pb-md-5,\n  .py-md-5 {\n    padding-bottom: 3rem !important;\n  }\n  .pl-md-5,\n  .px-md-5 {\n    padding-left: 3rem !important;\n  }\n  .m-md-n1 {\n    margin: -0.25rem !important;\n  }\n  .mt-md-n1,\n  .my-md-n1 {\n    margin-top: -0.25rem !important;\n  }\n  .mr-md-n1,\n  .mx-md-n1 {\n    margin-right: -0.25rem !important;\n  }\n  .mb-md-n1,\n  .my-md-n1 {\n    margin-bottom: -0.25rem !important;\n  }\n  .ml-md-n1,\n  .mx-md-n1 {\n    margin-left: -0.25rem !important;\n  }\n  .m-md-n2 {\n    margin: -0.5rem !important;\n  }\n  .mt-md-n2,\n  .my-md-n2 {\n    margin-top: -0.5rem !important;\n  }\n  .mr-md-n2,\n  .mx-md-n2 {\n    margin-right: -0.5rem !important;\n  }\n  .mb-md-n2,\n  .my-md-n2 {\n    margin-bottom: -0.5rem !important;\n  }\n  .ml-md-n2,\n  .mx-md-n2 {\n    margin-left: -0.5rem !important;\n  }\n  .m-md-n3 {\n    margin: -1rem !important;\n  }\n  .mt-md-n3,\n  .my-md-n3 {\n    margin-top: -1rem !important;\n  }\n  .mr-md-n3,\n  .mx-md-n3 {\n    margin-right: -1rem !important;\n  }\n  .mb-md-n3,\n  .my-md-n3 {\n    margin-bottom: -1rem !important;\n  }\n  .ml-md-n3,\n  .mx-md-n3 {\n    margin-left: -1rem !important;\n  }\n  .m-md-n4 {\n    margin: -1.5rem !important;\n  }\n  .mt-md-n4,\n  .my-md-n4 {\n    margin-top: -1.5rem !important;\n  }\n  .mr-md-n4,\n  .mx-md-n4 {\n    margin-right: -1.5rem !important;\n  }\n  .mb-md-n4,\n  .my-md-n4 {\n    margin-bottom: -1.5rem !important;\n  }\n  .ml-md-n4,\n  .mx-md-n4 {\n    margin-left: -1.5rem !important;\n  }\n  .m-md-n5 {\n    margin: -3rem !important;\n  }\n  .mt-md-n5,\n  .my-md-n5 {\n    margin-top: -3rem !important;\n  }\n  .mr-md-n5,\n  .mx-md-n5 {\n    margin-right: -3rem !important;\n  }\n  .mb-md-n5,\n  .my-md-n5 {\n    margin-bottom: -3rem !important;\n  }\n  .ml-md-n5,\n  .mx-md-n5 {\n    margin-left: -3rem !important;\n  }\n  .m-md-auto {\n    margin: auto !important;\n  }\n  .mt-md-auto,\n  .my-md-auto {\n    margin-top: auto !important;\n  }\n  .mr-md-auto,\n  .mx-md-auto {\n    margin-right: auto !important;\n  }\n  .mb-md-auto,\n  .my-md-auto {\n    margin-bottom: auto !important;\n  }\n  .ml-md-auto,\n  .mx-md-auto {\n    margin-left: auto !important;\n  }\n}\n\n@media (min-width: 992px) {\n  .m-lg-0 {\n    margin: 0 !important;\n  }\n  .mt-lg-0,\n  .my-lg-0 {\n    margin-top: 0 !important;\n  }\n  .mr-lg-0,\n  .mx-lg-0 {\n    margin-right: 0 !important;\n  }\n  .mb-lg-0,\n  .my-lg-0 {\n    margin-bottom: 0 !important;\n  }\n  .ml-lg-0,\n  .mx-lg-0 {\n    margin-left: 0 !important;\n  }\n  .m-lg-1 {\n    margin: 0.25rem !important;\n  }\n  .mt-lg-1,\n  .my-lg-1 {\n    margin-top: 0.25rem !important;\n  }\n  .mr-lg-1,\n  .mx-lg-1 {\n    margin-right: 0.25rem !important;\n  }\n  .mb-lg-1,\n  .my-lg-1 {\n    margin-bottom: 0.25rem !important;\n  }\n  .ml-lg-1,\n  .mx-lg-1 {\n    margin-left: 0.25rem !important;\n  }\n  .m-lg-2 {\n    margin: 0.5rem !important;\n  }\n  .mt-lg-2,\n  .my-lg-2 {\n    margin-top: 0.5rem !important;\n  }\n  .mr-lg-2,\n  .mx-lg-2 {\n    margin-right: 0.5rem !important;\n  }\n  .mb-lg-2,\n  .my-lg-2 {\n    margin-bottom: 0.5rem !important;\n  }\n  .ml-lg-2,\n  .mx-lg-2 {\n    margin-left: 0.5rem !important;\n  }\n  .m-lg-3 {\n    margin: 1rem !important;\n  }\n  .mt-lg-3,\n  .my-lg-3 {\n    margin-top: 1rem !important;\n  }\n  .mr-lg-3,\n  .mx-lg-3 {\n    margin-right: 1rem !important;\n  }\n  .mb-lg-3,\n  .my-lg-3 {\n    margin-bottom: 1rem !important;\n  }\n  .ml-lg-3,\n  .mx-lg-3 {\n    margin-left: 1rem !important;\n  }\n  .m-lg-4 {\n    margin: 1.5rem !important;\n  }\n  .mt-lg-4,\n  .my-lg-4 {\n    margin-top: 1.5rem !important;\n  }\n  .mr-lg-4,\n  .mx-lg-4 {\n    margin-right: 1.5rem !important;\n  }\n  .mb-lg-4,\n  .my-lg-4 {\n    margin-bottom: 1.5rem !important;\n  }\n  .ml-lg-4,\n  .mx-lg-4 {\n    margin-left: 1.5rem !important;\n  }\n  .m-lg-5 {\n    margin: 3rem !important;\n  }\n  .mt-lg-5,\n  .my-lg-5 {\n    margin-top: 3rem !important;\n  }\n  .mr-lg-5,\n  .mx-lg-5 {\n    margin-right: 3rem !important;\n  }\n  .mb-lg-5,\n  .my-lg-5 {\n    margin-bottom: 3rem !important;\n  }\n  .ml-lg-5,\n  .mx-lg-5 {\n    margin-left: 3rem !important;\n  }\n  .p-lg-0 {\n    padding: 0 !important;\n  }\n  .pt-lg-0,\n  .py-lg-0 {\n    padding-top: 0 !important;\n  }\n  .pr-lg-0,\n  .px-lg-0 {\n    padding-right: 0 !important;\n  }\n  .pb-lg-0,\n  .py-lg-0 {\n    padding-bottom: 0 !important;\n  }\n  .pl-lg-0,\n  .px-lg-0 {\n    padding-left: 0 !important;\n  }\n  .p-lg-1 {\n    padding: 0.25rem !important;\n  }\n  .pt-lg-1,\n  .py-lg-1 {\n    padding-top: 0.25rem !important;\n  }\n  .pr-lg-1,\n  .px-lg-1 {\n    padding-right: 0.25rem !important;\n  }\n  .pb-lg-1,\n  .py-lg-1 {\n    padding-bottom: 0.25rem !important;\n  }\n  .pl-lg-1,\n  .px-lg-1 {\n    padding-left: 0.25rem !important;\n  }\n  .p-lg-2 {\n    padding: 0.5rem !important;\n  }\n  .pt-lg-2,\n  .py-lg-2 {\n    padding-top: 0.5rem !important;\n  }\n  .pr-lg-2,\n  .px-lg-2 {\n    padding-right: 0.5rem !important;\n  }\n  .pb-lg-2,\n  .py-lg-2 {\n    padding-bottom: 0.5rem !important;\n  }\n  .pl-lg-2,\n  .px-lg-2 {\n    padding-left: 0.5rem !important;\n  }\n  .p-lg-3 {\n    padding: 1rem !important;\n  }\n  .pt-lg-3,\n  .py-lg-3 {\n    padding-top: 1rem !important;\n  }\n  .pr-lg-3,\n  .px-lg-3 {\n    padding-right: 1rem !important;\n  }\n  .pb-lg-3,\n  .py-lg-3 {\n    padding-bottom: 1rem !important;\n  }\n  .pl-lg-3,\n  .px-lg-3 {\n    padding-left: 1rem !important;\n  }\n  .p-lg-4 {\n    padding: 1.5rem !important;\n  }\n  .pt-lg-4,\n  .py-lg-4 {\n    padding-top: 1.5rem !important;\n  }\n  .pr-lg-4,\n  .px-lg-4 {\n    padding-right: 1.5rem !important;\n  }\n  .pb-lg-4,\n  .py-lg-4 {\n    padding-bottom: 1.5rem !important;\n  }\n  .pl-lg-4,\n  .px-lg-4 {\n    padding-left: 1.5rem !important;\n  }\n  .p-lg-5 {\n    padding: 3rem !important;\n  }\n  .pt-lg-5,\n  .py-lg-5 {\n    padding-top: 3rem !important;\n  }\n  .pr-lg-5,\n  .px-lg-5 {\n    padding-right: 3rem !important;\n  }\n  .pb-lg-5,\n  .py-lg-5 {\n    padding-bottom: 3rem !important;\n  }\n  .pl-lg-5,\n  .px-lg-5 {\n    padding-left: 3rem !important;\n  }\n  .m-lg-n1 {\n    margin: -0.25rem !important;\n  }\n  .mt-lg-n1,\n  .my-lg-n1 {\n    margin-top: -0.25rem !important;\n  }\n  .mr-lg-n1,\n  .mx-lg-n1 {\n    margin-right: -0.25rem !important;\n  }\n  .mb-lg-n1,\n  .my-lg-n1 {\n    margin-bottom: -0.25rem !important;\n  }\n  .ml-lg-n1,\n  .mx-lg-n1 {\n    margin-left: -0.25rem !important;\n  }\n  .m-lg-n2 {\n    margin: -0.5rem !important;\n  }\n  .mt-lg-n2,\n  .my-lg-n2 {\n    margin-top: -0.5rem !important;\n  }\n  .mr-lg-n2,\n  .mx-lg-n2 {\n    margin-right: -0.5rem !important;\n  }\n  .mb-lg-n2,\n  .my-lg-n2 {\n    margin-bottom: -0.5rem !important;\n  }\n  .ml-lg-n2,\n  .mx-lg-n2 {\n    margin-left: -0.5rem !important;\n  }\n  .m-lg-n3 {\n    margin: -1rem !important;\n  }\n  .mt-lg-n3,\n  .my-lg-n3 {\n    margin-top: -1rem !important;\n  }\n  .mr-lg-n3,\n  .mx-lg-n3 {\n    margin-right: -1rem !important;\n  }\n  .mb-lg-n3,\n  .my-lg-n3 {\n    margin-bottom: -1rem !important;\n  }\n  .ml-lg-n3,\n  .mx-lg-n3 {\n    margin-left: -1rem !important;\n  }\n  .m-lg-n4 {\n    margin: -1.5rem !important;\n  }\n  .mt-lg-n4,\n  .my-lg-n4 {\n    margin-top: -1.5rem !important;\n  }\n  .mr-lg-n4,\n  .mx-lg-n4 {\n    margin-right: -1.5rem !important;\n  }\n  .mb-lg-n4,\n  .my-lg-n4 {\n    margin-bottom: -1.5rem !important;\n  }\n  .ml-lg-n4,\n  .mx-lg-n4 {\n    margin-left: -1.5rem !important;\n  }\n  .m-lg-n5 {\n    margin: -3rem !important;\n  }\n  .mt-lg-n5,\n  .my-lg-n5 {\n    margin-top: -3rem !important;\n  }\n  .mr-lg-n5,\n  .mx-lg-n5 {\n    margin-right: -3rem !important;\n  }\n  .mb-lg-n5,\n  .my-lg-n5 {\n    margin-bottom: -3rem !important;\n  }\n  .ml-lg-n5,\n  .mx-lg-n5 {\n    margin-left: -3rem !important;\n  }\n  .m-lg-auto {\n    margin: auto !important;\n  }\n  .mt-lg-auto,\n  .my-lg-auto {\n    margin-top: auto !important;\n  }\n  .mr-lg-auto,\n  .mx-lg-auto {\n    margin-right: auto !important;\n  }\n  .mb-lg-auto,\n  .my-lg-auto {\n    margin-bottom: auto !important;\n  }\n  .ml-lg-auto,\n  .mx-lg-auto {\n    margin-left: auto !important;\n  }\n}\n\n@media (min-width: 1200px) {\n  .m-xl-0 {\n    margin: 0 !important;\n  }\n  .mt-xl-0,\n  .my-xl-0 {\n    margin-top: 0 !important;\n  }\n  .mr-xl-0,\n  .mx-xl-0 {\n    margin-right: 0 !important;\n  }\n  .mb-xl-0,\n  .my-xl-0 {\n    margin-bottom: 0 !important;\n  }\n  .ml-xl-0,\n  .mx-xl-0 {\n    margin-left: 0 !important;\n  }\n  .m-xl-1 {\n    margin: 0.25rem !important;\n  }\n  .mt-xl-1,\n  .my-xl-1 {\n    margin-top: 0.25rem !important;\n  }\n  .mr-xl-1,\n  .mx-xl-1 {\n    margin-right: 0.25rem !important;\n  }\n  .mb-xl-1,\n  .my-xl-1 {\n    margin-bottom: 0.25rem !important;\n  }\n  .ml-xl-1,\n  .mx-xl-1 {\n    margin-left: 0.25rem !important;\n  }\n  .m-xl-2 {\n    margin: 0.5rem !important;\n  }\n  .mt-xl-2,\n  .my-xl-2 {\n    margin-top: 0.5rem !important;\n  }\n  .mr-xl-2,\n  .mx-xl-2 {\n    margin-right: 0.5rem !important;\n  }\n  .mb-xl-2,\n  .my-xl-2 {\n    margin-bottom: 0.5rem !important;\n  }\n  .ml-xl-2,\n  .mx-xl-2 {\n    margin-left: 0.5rem !important;\n  }\n  .m-xl-3 {\n    margin: 1rem !important;\n  }\n  .mt-xl-3,\n  .my-xl-3 {\n    margin-top: 1rem !important;\n  }\n  .mr-xl-3,\n  .mx-xl-3 {\n    margin-right: 1rem !important;\n  }\n  .mb-xl-3,\n  .my-xl-3 {\n    margin-bottom: 1rem !important;\n  }\n  .ml-xl-3,\n  .mx-xl-3 {\n    margin-left: 1rem !important;\n  }\n  .m-xl-4 {\n    margin: 1.5rem !important;\n  }\n  .mt-xl-4,\n  .my-xl-4 {\n    margin-top: 1.5rem !important;\n  }\n  .mr-xl-4,\n  .mx-xl-4 {\n    margin-right: 1.5rem !important;\n  }\n  .mb-xl-4,\n  .my-xl-4 {\n    margin-bottom: 1.5rem !important;\n  }\n  .ml-xl-4,\n  .mx-xl-4 {\n    margin-left: 1.5rem !important;\n  }\n  .m-xl-5 {\n    margin: 3rem !important;\n  }\n  .mt-xl-5,\n  .my-xl-5 {\n    margin-top: 3rem !important;\n  }\n  .mr-xl-5,\n  .mx-xl-5 {\n    margin-right: 3rem !important;\n  }\n  .mb-xl-5,\n  .my-xl-5 {\n    margin-bottom: 3rem !important;\n  }\n  .ml-xl-5,\n  .mx-xl-5 {\n    margin-left: 3rem !important;\n  }\n  .p-xl-0 {\n    padding: 0 !important;\n  }\n  .pt-xl-0,\n  .py-xl-0 {\n    padding-top: 0 !important;\n  }\n  .pr-xl-0,\n  .px-xl-0 {\n    padding-right: 0 !important;\n  }\n  .pb-xl-0,\n  .py-xl-0 {\n    padding-bottom: 0 !important;\n  }\n  .pl-xl-0,\n  .px-xl-0 {\n    padding-left: 0 !important;\n  }\n  .p-xl-1 {\n    padding: 0.25rem !important;\n  }\n  .pt-xl-1,\n  .py-xl-1 {\n    padding-top: 0.25rem !important;\n  }\n  .pr-xl-1,\n  .px-xl-1 {\n    padding-right: 0.25rem !important;\n  }\n  .pb-xl-1,\n  .py-xl-1 {\n    padding-bottom: 0.25rem !important;\n  }\n  .pl-xl-1,\n  .px-xl-1 {\n    padding-left: 0.25rem !important;\n  }\n  .p-xl-2 {\n    padding: 0.5rem !important;\n  }\n  .pt-xl-2,\n  .py-xl-2 {\n    padding-top: 0.5rem !important;\n  }\n  .pr-xl-2,\n  .px-xl-2 {\n    padding-right: 0.5rem !important;\n  }\n  .pb-xl-2,\n  .py-xl-2 {\n    padding-bottom: 0.5rem !important;\n  }\n  .pl-xl-2,\n  .px-xl-2 {\n    padding-left: 0.5rem !important;\n  }\n  .p-xl-3 {\n    padding: 1rem !important;\n  }\n  .pt-xl-3,\n  .py-xl-3 {\n    padding-top: 1rem !important;\n  }\n  .pr-xl-3,\n  .px-xl-3 {\n    padding-right: 1rem !important;\n  }\n  .pb-xl-3,\n  .py-xl-3 {\n    padding-bottom: 1rem !important;\n  }\n  .pl-xl-3,\n  .px-xl-3 {\n    padding-left: 1rem !important;\n  }\n  .p-xl-4 {\n    padding: 1.5rem !important;\n  }\n  .pt-xl-4,\n  .py-xl-4 {\n    padding-top: 1.5rem !important;\n  }\n  .pr-xl-4,\n  .px-xl-4 {\n    padding-right: 1.5rem !important;\n  }\n  .pb-xl-4,\n  .py-xl-4 {\n    padding-bottom: 1.5rem !important;\n  }\n  .pl-xl-4,\n  .px-xl-4 {\n    padding-left: 1.5rem !important;\n  }\n  .p-xl-5 {\n    padding: 3rem !important;\n  }\n  .pt-xl-5,\n  .py-xl-5 {\n    padding-top: 3rem !important;\n  }\n  .pr-xl-5,\n  .px-xl-5 {\n    padding-right: 3rem !important;\n  }\n  .pb-xl-5,\n  .py-xl-5 {\n    padding-bottom: 3rem !important;\n  }\n  .pl-xl-5,\n  .px-xl-5 {\n    padding-left: 3rem !important;\n  }\n  .m-xl-n1 {\n    margin: -0.25rem !important;\n  }\n  .mt-xl-n1,\n  .my-xl-n1 {\n    margin-top: -0.25rem !important;\n  }\n  .mr-xl-n1,\n  .mx-xl-n1 {\n    margin-right: -0.25rem !important;\n  }\n  .mb-xl-n1,\n  .my-xl-n1 {\n    margin-bottom: -0.25rem !important;\n  }\n  .ml-xl-n1,\n  .mx-xl-n1 {\n    margin-left: -0.25rem !important;\n  }\n  .m-xl-n2 {\n    margin: -0.5rem !important;\n  }\n  .mt-xl-n2,\n  .my-xl-n2 {\n    margin-top: -0.5rem !important;\n  }\n  .mr-xl-n2,\n  .mx-xl-n2 {\n    margin-right: -0.5rem !important;\n  }\n  .mb-xl-n2,\n  .my-xl-n2 {\n    margin-bottom: -0.5rem !important;\n  }\n  .ml-xl-n2,\n  .mx-xl-n2 {\n    margin-left: -0.5rem !important;\n  }\n  .m-xl-n3 {\n    margin: -1rem !important;\n  }\n  .mt-xl-n3,\n  .my-xl-n3 {\n    margin-top: -1rem !important;\n  }\n  .mr-xl-n3,\n  .mx-xl-n3 {\n    margin-right: -1rem !important;\n  }\n  .mb-xl-n3,\n  .my-xl-n3 {\n    margin-bottom: -1rem !important;\n  }\n  .ml-xl-n3,\n  .mx-xl-n3 {\n    margin-left: -1rem !important;\n  }\n  .m-xl-n4 {\n    margin: -1.5rem !important;\n  }\n  .mt-xl-n4,\n  .my-xl-n4 {\n    margin-top: -1.5rem !important;\n  }\n  .mr-xl-n4,\n  .mx-xl-n4 {\n    margin-right: -1.5rem !important;\n  }\n  .mb-xl-n4,\n  .my-xl-n4 {\n    margin-bottom: -1.5rem !important;\n  }\n  .ml-xl-n4,\n  .mx-xl-n4 {\n    margin-left: -1.5rem !important;\n  }\n  .m-xl-n5 {\n    margin: -3rem !important;\n  }\n  .mt-xl-n5,\n  .my-xl-n5 {\n    margin-top: -3rem !important;\n  }\n  .mr-xl-n5,\n  .mx-xl-n5 {\n    margin-right: -3rem !important;\n  }\n  .mb-xl-n5,\n  .my-xl-n5 {\n    margin-bottom: -3rem !important;\n  }\n  .ml-xl-n5,\n  .mx-xl-n5 {\n    margin-left: -3rem !important;\n  }\n  .m-xl-auto {\n    margin: auto !important;\n  }\n  .mt-xl-auto,\n  .my-xl-auto {\n    margin-top: auto !important;\n  }\n  .mr-xl-auto,\n  .mx-xl-auto {\n    margin-right: auto !important;\n  }\n  .mb-xl-auto,\n  .my-xl-auto {\n    margin-bottom: auto !important;\n  }\n  .ml-xl-auto,\n  .mx-xl-auto {\n    margin-left: auto !important;\n  }\n}\n\n.text-monospace {\n  font-family: SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\", \"Courier New\", monospace !important;\n}\n\n.text-justify {\n  text-align: justify !important;\n}\n\n.text-wrap {\n  white-space: normal !important;\n}\n\n.text-nowrap {\n  white-space: nowrap !important;\n}\n\n.text-truncate {\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n\n.text-left {\n  text-align: left !important;\n}\n\n.text-right {\n  text-align: right !important;\n}\n\n.text-center {\n  text-align: center !important;\n}\n\n@media (min-width: 576px) {\n  .text-sm-left {\n    text-align: left !important;\n  }\n  .text-sm-right {\n    text-align: right !important;\n  }\n  .text-sm-center {\n    text-align: center !important;\n  }\n}\n\n@media (min-width: 768px) {\n  .text-md-left {\n    text-align: left !important;\n  }\n  .text-md-right {\n    text-align: right !important;\n  }\n  .text-md-center {\n    text-align: center !important;\n  }\n}\n\n@media (min-width: 992px) {\n  .text-lg-left {\n    text-align: left !important;\n  }\n  .text-lg-right {\n    text-align: right !important;\n  }\n  .text-lg-center {\n    text-align: center !important;\n  }\n}\n\n@media (min-width: 1200px) {\n  .text-xl-left {\n    text-align: left !important;\n  }\n  .text-xl-right {\n    text-align: right !important;\n  }\n  .text-xl-center {\n    text-align: center !important;\n  }\n}\n\n.text-lowercase {\n  text-transform: lowercase !important;\n}\n\n.text-uppercase {\n  text-transform: uppercase !important;\n}\n\n.text-capitalize {\n  text-transform: capitalize !important;\n}\n\n.font-weight-light {\n  font-weight: 300 !important;\n}\n\n.font-weight-lighter {\n  font-weight: lighter !important;\n}\n\n.font-weight-normal {\n  font-weight: 400 !important;\n}\n\n.font-weight-bold {\n  font-weight: 700 !important;\n}\n\n.font-weight-bolder {\n  font-weight: bolder !important;\n}\n\n.font-italic {\n  font-style: italic !important;\n}\n\n.text-white {\n  color: #fff !important;\n}\n\n.text-primary {\n  color: #007bff !important;\n}\n\na.text-primary:hover, a.text-primary:focus {\n  color: #0056b3 !important;\n}\n\n.text-secondary {\n  color: #6c757d !important;\n}\n\na.text-secondary:hover, a.text-secondary:focus {\n  color: #494f54 !important;\n}\n\n.text-success {\n  color: #28a745 !important;\n}\n\na.text-success:hover, a.text-success:focus {\n  color: #19692c !important;\n}\n\n.text-info {\n  color: #17a2b8 !important;\n}\n\na.text-info:hover, a.text-info:focus {\n  color: #0f6674 !important;\n}\n\n.text-warning {\n  color: #ffc107 !important;\n}\n\na.text-warning:hover, a.text-warning:focus {\n  color: #ba8b00 !important;\n}\n\n.text-danger {\n  color: #dc3545 !important;\n}\n\na.text-danger:hover, a.text-danger:focus {\n  color: #a71d2a !important;\n}\n\n.text-light {\n  color: #f8f9fa !important;\n}\n\na.text-light:hover, a.text-light:focus {\n  color: #cbd3da !important;\n}\n\n.text-dark {\n  color: #343a40 !important;\n}\n\na.text-dark:hover, a.text-dark:focus {\n  color: #121416 !important;\n}\n\n.text-body {\n  color: #212529 !important;\n}\n\n.text-muted {\n  color: #6c757d !important;\n}\n\n.text-black-50 {\n  color: rgba(0, 0, 0, 0.5) !important;\n}\n\n.text-white-50 {\n  color: rgba(255, 255, 255, 0.5) !important;\n}\n\n.text-hide {\n  font: 0/0 a;\n  color: transparent;\n  text-shadow: none;\n  background-color: transparent;\n  border: 0;\n}\n\n.text-decoration-none {\n  text-decoration: none !important;\n}\n\n.text-break {\n  word-break: break-word !important;\n  overflow-wrap: break-word !important;\n}\n\n.text-reset {\n  color: inherit !important;\n}\n\n.visible {\n  visibility: visible !important;\n}\n\n.invisible {\n  visibility: hidden !important;\n}\n\n@media print {\n  *,\n  *::before,\n  *::after {\n    text-shadow: none !important;\n    box-shadow: none !important;\n  }\n  a:not(.btn) {\n    text-decoration: underline;\n  }\n  abbr[title]::after {\n    content: \" (\" attr(title) \")\";\n  }\n  pre {\n    white-space: pre-wrap !important;\n  }\n  pre,\n  blockquote {\n    border: 1px solid #adb5bd;\n    page-break-inside: avoid;\n  }\n  thead {\n    display: table-header-group;\n  }\n  tr,\n  img {\n    page-break-inside: avoid;\n  }\n  p,\n  h2,\n  h3 {\n    orphans: 3;\n    widows: 3;\n  }\n  h2,\n  h3 {\n    page-break-after: avoid;\n  }\n  @page {\n    size: a3;\n  }\n  body {\n    min-width: 992px !important;\n  }\n  .container {\n    min-width: 992px !important;\n  }\n  .navbar {\n    display: none;\n  }\n  .badge {\n    border: 1px solid #000;\n  }\n  .table {\n    border-collapse: collapse !important;\n  }\n  .table td,\n  .table th {\n    background-color: #fff !important;\n  }\n  .table-bordered th,\n  .table-bordered td {\n    border: 1px solid #dee2e6 !important;\n  }\n  .table-dark {\n    color: inherit;\n  }\n  .table-dark th,\n  .table-dark td,\n  .table-dark thead th,\n  .table-dark tbody + tbody {\n    border-color: #dee2e6;\n  }\n  .table .thead-dark th {\n    color: inherit;\n    border-color: #dee2e6;\n  }\n}\n/*# sourceMappingURL=bootstrap.css.map */","// stylelint-disable property-blacklist, scss/dollar-variable-default\n\n// SCSS RFS mixin\n//\n// Automated font-resizing\n//\n// See https://github.com/twbs/rfs\n\n// Configuration\n\n// Base font size\n$rfs-base-font-size: 1.25rem !default;\n$rfs-font-size-unit: rem !default;\n\n// Breakpoint at where font-size starts decreasing if screen width is smaller\n$rfs-breakpoint: 1200px !default;\n$rfs-breakpoint-unit: px !default;\n\n// Resize font-size based on screen height and width\n$rfs-two-dimensional: false !default;\n\n// Factor of decrease\n$rfs-factor: 10 !default;\n\n@if type-of($rfs-factor) != \"number\" or $rfs-factor <= 1 {\n  @error \"`#{$rfs-factor}` is not a valid  $rfs-factor, it must be greater than 1.\";\n}\n\n// Generate enable or disable classes. Possibilities: false, \"enable\" or \"disable\"\n$rfs-class: false !default;\n\n// 1 rem = $rfs-rem-value px\n$rfs-rem-value: 16 !default;\n\n// Safari iframe resize bug: https://github.com/twbs/rfs/issues/14\n$rfs-safari-iframe-resize-bug-fix: false !default;\n\n// Disable RFS by setting $enable-responsive-font-sizes to false\n$enable-responsive-font-sizes: true !default;\n\n// Cache $rfs-base-font-size unit\n$rfs-base-font-size-unit: unit($rfs-base-font-size);\n\n// Remove px-unit from $rfs-base-font-size for calculations\n@if $rfs-base-font-size-unit == \"px\" {\n  $rfs-base-font-size: $rfs-base-font-size / ($rfs-base-font-size * 0 + 1);\n}\n@else if $rfs-base-font-size-unit == \"rem\" {\n  $rfs-base-font-size: $rfs-base-font-size / ($rfs-base-font-size * 0 + 1 / $rfs-rem-value);\n}\n\n// Cache $rfs-breakpoint unit to prevent multiple calls\n$rfs-breakpoint-unit-cache: unit($rfs-breakpoint);\n\n// Remove unit from $rfs-breakpoint for calculations\n@if $rfs-breakpoint-unit-cache == \"px\" {\n  $rfs-breakpoint: $rfs-breakpoint / ($rfs-breakpoint * 0 + 1);\n}\n@else if $rfs-breakpoint-unit-cache == \"rem\" or $rfs-breakpoint-unit-cache == \"em\" {\n  $rfs-breakpoint: $rfs-breakpoint / ($rfs-breakpoint * 0 + 1 / $rfs-rem-value);\n}\n\n// Responsive font-size mixin\n@mixin rfs($fs, $important: false) {\n  // Cache $fs unit\n  $fs-unit: if(type-of($fs) == \"number\", unit($fs), false);\n\n  // Add !important suffix if needed\n  $rfs-suffix: if($important, \" !important\", \"\");\n\n  // If $fs isn't a number (like inherit) or $fs has a unit (not px or rem, like 1.5em) or $ is 0, just print the value\n  @if not $fs-unit or $fs-unit != \"\" and $fs-unit != \"px\" and $fs-unit != \"rem\" or $fs == 0 {\n    font-size: #{$fs}#{$rfs-suffix};\n  }\n  @else {\n    // Variables for storing static and fluid rescaling\n    $rfs-static: null;\n    $rfs-fluid: null;\n\n    // Remove px-unit from $fs for calculations\n    @if $fs-unit == \"px\" {\n      $fs: $fs / ($fs * 0 + 1);\n    }\n    @else if $fs-unit == \"rem\" {\n      $fs: $fs / ($fs * 0 + 1 / $rfs-rem-value);\n    }\n\n    // Set default font-size\n    @if $rfs-font-size-unit == rem {\n      $rfs-static: #{$fs / $rfs-rem-value}rem#{$rfs-suffix};\n    }\n    @else if $rfs-font-size-unit == px {\n      $rfs-static: #{$fs}px#{$rfs-suffix};\n    }\n    @else {\n      @error \"`#{$rfs-font-size-unit}` is not a valid unit for $rfs-font-size-unit. Use `px` or `rem`.\";\n    }\n\n    // Only add media query if font-size is bigger as the minimum font-size\n    // If $rfs-factor == 1, no rescaling will take place\n    @if $fs > $rfs-base-font-size and $enable-responsive-font-sizes {\n      $min-width: null;\n      $variable-unit: null;\n\n      // Calculate minimum font-size for given font-size\n      $fs-min: $rfs-base-font-size + ($fs - $rfs-base-font-size) / $rfs-factor;\n\n      // Calculate difference between given font-size and minimum font-size for given font-size\n      $fs-diff: $fs - $fs-min;\n\n      // Base font-size formatting\n      // No need to check if the unit is valid, because we did that before\n      $min-width: if($rfs-font-size-unit == rem, #{$fs-min / $rfs-rem-value}rem, #{$fs-min}px);\n\n      // If two-dimensional, use smallest of screen width and height\n      $variable-unit: if($rfs-two-dimensional, vmin, vw);\n\n      // Calculate the variable width between 0 and $rfs-breakpoint\n      $variable-width: #{$fs-diff * 100 / $rfs-breakpoint}#{$variable-unit};\n\n      // Set the calculated font-size.\n      $rfs-fluid: calc(#{$min-width} + #{$variable-width}) #{$rfs-suffix};\n    }\n\n    // Rendering\n    @if $rfs-fluid == null {\n      // Only render static font-size if no fluid font-size is available\n      font-size: $rfs-static;\n    }\n    @else {\n      $mq-value: null;\n\n      // RFS breakpoint formatting\n      @if $rfs-breakpoint-unit == em or $rfs-breakpoint-unit == rem {\n        $mq-value: #{$rfs-breakpoint / $rfs-rem-value}#{$rfs-breakpoint-unit};\n      }\n      @else if $rfs-breakpoint-unit == px {\n        $mq-value: #{$rfs-breakpoint}px;\n      }\n      @else {\n        @error \"`#{$rfs-breakpoint-unit}` is not a valid unit for $rfs-breakpoint-unit. Use `px`, `em` or `rem`.\";\n      }\n\n      @if $rfs-class == \"disable\" {\n        // Adding an extra class increases specificity,\n        // which prevents the media query to override the font size\n        &,\n        .disable-responsive-font-size &,\n        &.disable-responsive-font-size {\n          font-size: $rfs-static;\n        }\n      }\n      @else {\n        font-size: $rfs-static;\n      }\n\n      @if $rfs-two-dimensional {\n        @media (max-width: #{$mq-value}), (max-height: #{$mq-value}) {\n          @if $rfs-class == \"enable\" {\n            .enable-responsive-font-size &,\n            &.enable-responsive-font-size {\n              font-size: $rfs-fluid;\n            }\n          }\n          @else {\n            font-size: $rfs-fluid;\n          }\n\n          @if $rfs-safari-iframe-resize-bug-fix {\n            // stylelint-disable-next-line length-zero-no-unit\n            min-width: 0vw;\n          }\n        }\n      }\n      @else {\n        @media (max-width: #{$mq-value}) {\n          @if $rfs-class == \"enable\" {\n            .enable-responsive-font-size &,\n            &.enable-responsive-font-size {\n              font-size: $rfs-fluid;\n            }\n          }\n          @else {\n            font-size: $rfs-fluid;\n          }\n\n          @if $rfs-safari-iframe-resize-bug-fix {\n            // stylelint-disable-next-line length-zero-no-unit\n            min-width: 0vw;\n          }\n        }\n      }\n    }\n  }\n}\n\n// The font-size & responsive-font-size mixin uses RFS to rescale font sizes\n@mixin font-size($fs, $important: false) {\n  @include rfs($fs, $important);\n}\n\n@mixin responsive-font-size($fs, $important: false) {\n  @include rfs($fs, $important);\n}\n","/*!\n * Bootstrap v4.3.1 (https://getbootstrap.com/)\n * Copyright 2011-2019 The Bootstrap Authors\n * Copyright 2011-2019 Twitter, Inc.\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)\n */\n:root {\n  --blue: #007bff;\n  --indigo: #6610f2;\n  --purple: #6f42c1;\n  --pink: #e83e8c;\n  --red: #dc3545;\n  --orange: #fd7e14;\n  --yellow: #ffc107;\n  --green: #28a745;\n  --teal: #20c997;\n  --cyan: #17a2b8;\n  --white: #fff;\n  --gray: #6c757d;\n  --gray-dark: #343a40;\n  --primary: #007bff;\n  --secondary: #6c757d;\n  --success: #28a745;\n  --info: #17a2b8;\n  --warning: #ffc107;\n  --danger: #dc3545;\n  --light: #f8f9fa;\n  --dark: #343a40;\n  --breakpoint-xs: 0;\n  --breakpoint-sm: 576px;\n  --breakpoint-md: 768px;\n  --breakpoint-lg: 992px;\n  --breakpoint-xl: 1200px;\n  --font-family-sans-serif: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, \"Noto Sans\", sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\", \"Noto Color Emoji\";\n  --font-family-monospace: SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\", \"Courier New\", monospace;\n}\n\n*,\n*::before,\n*::after {\n  box-sizing: border-box;\n}\n\nhtml {\n  font-family: sans-serif;\n  line-height: 1.15;\n  -webkit-text-size-adjust: 100%;\n  -webkit-tap-highlight-color: rgba(0, 0, 0, 0);\n}\n\narticle, aside, figcaption, figure, footer, header, hgroup, main, nav, section {\n  display: block;\n}\n\nbody {\n  margin: 0;\n  font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, \"Noto Sans\", sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\", \"Noto Color Emoji\";\n  font-size: 1rem;\n  font-weight: 400;\n  line-height: 1.5;\n  color: #212529;\n  text-align: left;\n  background-color: #fff;\n}\n\n[tabindex=\"-1\"]:focus {\n  outline: 0 !important;\n}\n\nhr {\n  box-sizing: content-box;\n  height: 0;\n  overflow: visible;\n}\n\nh1, h2, h3, h4, h5, h6 {\n  margin-top: 0;\n  margin-bottom: 0.5rem;\n}\n\np {\n  margin-top: 0;\n  margin-bottom: 1rem;\n}\n\nabbr[title],\nabbr[data-original-title] {\n  text-decoration: underline;\n  text-decoration: underline dotted;\n  cursor: help;\n  border-bottom: 0;\n  text-decoration-skip-ink: none;\n}\n\naddress {\n  margin-bottom: 1rem;\n  font-style: normal;\n  line-height: inherit;\n}\n\nol,\nul,\ndl {\n  margin-top: 0;\n  margin-bottom: 1rem;\n}\n\nol ol,\nul ul,\nol ul,\nul ol {\n  margin-bottom: 0;\n}\n\ndt {\n  font-weight: 700;\n}\n\ndd {\n  margin-bottom: .5rem;\n  margin-left: 0;\n}\n\nblockquote {\n  margin: 0 0 1rem;\n}\n\nb,\nstrong {\n  font-weight: bolder;\n}\n\nsmall {\n  font-size: 80%;\n}\n\nsub,\nsup {\n  position: relative;\n  font-size: 75%;\n  line-height: 0;\n  vertical-align: baseline;\n}\n\nsub {\n  bottom: -.25em;\n}\n\nsup {\n  top: -.5em;\n}\n\na {\n  color: #007bff;\n  text-decoration: none;\n  background-color: transparent;\n}\n\na:hover {\n  color: #0056b3;\n  text-decoration: underline;\n}\n\na:not([href]):not([tabindex]) {\n  color: inherit;\n  text-decoration: none;\n}\n\na:not([href]):not([tabindex]):hover, a:not([href]):not([tabindex]):focus {\n  color: inherit;\n  text-decoration: none;\n}\n\na:not([href]):not([tabindex]):focus {\n  outline: 0;\n}\n\npre,\ncode,\nkbd,\nsamp {\n  font-family: SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\", \"Courier New\", monospace;\n  font-size: 1em;\n}\n\npre {\n  margin-top: 0;\n  margin-bottom: 1rem;\n  overflow: auto;\n}\n\nfigure {\n  margin: 0 0 1rem;\n}\n\nimg {\n  vertical-align: middle;\n  border-style: none;\n}\n\nsvg {\n  overflow: hidden;\n  vertical-align: middle;\n}\n\ntable {\n  border-collapse: collapse;\n}\n\ncaption {\n  padding-top: 0.75rem;\n  padding-bottom: 0.75rem;\n  color: #6c757d;\n  text-align: left;\n  caption-side: bottom;\n}\n\nth {\n  text-align: inherit;\n}\n\nlabel {\n  display: inline-block;\n  margin-bottom: 0.5rem;\n}\n\nbutton {\n  border-radius: 0;\n}\n\nbutton:focus {\n  outline: 1px dotted;\n  outline: 5px auto -webkit-focus-ring-color;\n}\n\ninput,\nbutton,\nselect,\noptgroup,\ntextarea {\n  margin: 0;\n  font-family: inherit;\n  font-size: inherit;\n  line-height: inherit;\n}\n\nbutton,\ninput {\n  overflow: visible;\n}\n\nbutton,\nselect {\n  text-transform: none;\n}\n\nselect {\n  word-wrap: normal;\n}\n\nbutton,\n[type=\"button\"],\n[type=\"reset\"],\n[type=\"submit\"] {\n  -webkit-appearance: button;\n}\n\nbutton:not(:disabled),\n[type=\"button\"]:not(:disabled),\n[type=\"reset\"]:not(:disabled),\n[type=\"submit\"]:not(:disabled) {\n  cursor: pointer;\n}\n\nbutton::-moz-focus-inner,\n[type=\"button\"]::-moz-focus-inner,\n[type=\"reset\"]::-moz-focus-inner,\n[type=\"submit\"]::-moz-focus-inner {\n  padding: 0;\n  border-style: none;\n}\n\ninput[type=\"radio\"],\ninput[type=\"checkbox\"] {\n  box-sizing: border-box;\n  padding: 0;\n}\n\ninput[type=\"date\"],\ninput[type=\"time\"],\ninput[type=\"datetime-local\"],\ninput[type=\"month\"] {\n  -webkit-appearance: listbox;\n}\n\ntextarea {\n  overflow: auto;\n  resize: vertical;\n}\n\nfieldset {\n  min-width: 0;\n  padding: 0;\n  margin: 0;\n  border: 0;\n}\n\nlegend {\n  display: block;\n  width: 100%;\n  max-width: 100%;\n  padding: 0;\n  margin-bottom: .5rem;\n  font-size: 1.5rem;\n  line-height: inherit;\n  color: inherit;\n  white-space: normal;\n}\n\nprogress {\n  vertical-align: baseline;\n}\n\n[type=\"number\"]::-webkit-inner-spin-button,\n[type=\"number\"]::-webkit-outer-spin-button {\n  height: auto;\n}\n\n[type=\"search\"] {\n  outline-offset: -2px;\n  -webkit-appearance: none;\n}\n\n[type=\"search\"]::-webkit-search-decoration {\n  -webkit-appearance: none;\n}\n\n::-webkit-file-upload-button {\n  font: inherit;\n  -webkit-appearance: button;\n}\n\noutput {\n  display: inline-block;\n}\n\nsummary {\n  display: list-item;\n  cursor: pointer;\n}\n\ntemplate {\n  display: none;\n}\n\n[hidden] {\n  display: none !important;\n}\n\nh1, h2, h3, h4, h5, h6,\n.h1, .h2, .h3, .h4, .h5, .h6 {\n  margin-bottom: 0.5rem;\n  font-weight: 500;\n  line-height: 1.2;\n}\n\nh1, .h1 {\n  font-size: 2.5rem;\n}\n\nh2, .h2 {\n  font-size: 2rem;\n}\n\nh3, .h3 {\n  font-size: 1.75rem;\n}\n\nh4, .h4 {\n  font-size: 1.5rem;\n}\n\nh5, .h5 {\n  font-size: 1.25rem;\n}\n\nh6, .h6 {\n  font-size: 1rem;\n}\n\n.lead {\n  font-size: 1.25rem;\n  font-weight: 300;\n}\n\n.display-1 {\n  font-size: 6rem;\n  font-weight: 300;\n  line-height: 1.2;\n}\n\n.display-2 {\n  font-size: 5.5rem;\n  font-weight: 300;\n  line-height: 1.2;\n}\n\n.display-3 {\n  font-size: 4.5rem;\n  font-weight: 300;\n  line-height: 1.2;\n}\n\n.display-4 {\n  font-size: 3.5rem;\n  font-weight: 300;\n  line-height: 1.2;\n}\n\nhr {\n  margin-top: 1rem;\n  margin-bottom: 1rem;\n  border: 0;\n  border-top: 1px solid rgba(0, 0, 0, 0.1);\n}\n\nsmall,\n.small {\n  font-size: 80%;\n  font-weight: 400;\n}\n\nmark,\n.mark {\n  padding: 0.2em;\n  background-color: #fcf8e3;\n}\n\n.list-unstyled {\n  padding-left: 0;\n  list-style: none;\n}\n\n.list-inline {\n  padding-left: 0;\n  list-style: none;\n}\n\n.list-inline-item {\n  display: inline-block;\n}\n\n.list-inline-item:not(:last-child) {\n  margin-right: 0.5rem;\n}\n\n.initialism {\n  font-size: 90%;\n  text-transform: uppercase;\n}\n\n.blockquote {\n  margin-bottom: 1rem;\n  font-size: 1.25rem;\n}\n\n.blockquote-footer {\n  display: block;\n  font-size: 80%;\n  color: #6c757d;\n}\n\n.blockquote-footer::before {\n  content: \"\\2014\\00A0\";\n}\n\n.img-fluid {\n  max-width: 100%;\n  height: auto;\n}\n\n.img-thumbnail {\n  padding: 0.25rem;\n  background-color: #fff;\n  border: 1px solid #dee2e6;\n  border-radius: 0.25rem;\n  max-width: 100%;\n  height: auto;\n}\n\n.figure {\n  display: inline-block;\n}\n\n.figure-img {\n  margin-bottom: 0.5rem;\n  line-height: 1;\n}\n\n.figure-caption {\n  font-size: 90%;\n  color: #6c757d;\n}\n\ncode {\n  font-size: 87.5%;\n  color: #e83e8c;\n  word-break: break-word;\n}\n\na > code {\n  color: inherit;\n}\n\nkbd {\n  padding: 0.2rem 0.4rem;\n  font-size: 87.5%;\n  color: #fff;\n  background-color: #212529;\n  border-radius: 0.2rem;\n}\n\nkbd kbd {\n  padding: 0;\n  font-size: 100%;\n  font-weight: 700;\n}\n\npre {\n  display: block;\n  font-size: 87.5%;\n  color: #212529;\n}\n\npre code {\n  font-size: inherit;\n  color: inherit;\n  word-break: normal;\n}\n\n.pre-scrollable {\n  max-height: 340px;\n  overflow-y: scroll;\n}\n\n.container {\n  width: 100%;\n  padding-right: 15px;\n  padding-left: 15px;\n  margin-right: auto;\n  margin-left: auto;\n}\n\n@media (min-width: 576px) {\n  .container {\n    max-width: 540px;\n  }\n}\n\n@media (min-width: 768px) {\n  .container {\n    max-width: 720px;\n  }\n}\n\n@media (min-width: 992px) {\n  .container {\n    max-width: 960px;\n  }\n}\n\n@media (min-width: 1200px) {\n  .container {\n    max-width: 1140px;\n  }\n}\n\n.container-fluid {\n  width: 100%;\n  padding-right: 15px;\n  padding-left: 15px;\n  margin-right: auto;\n  margin-left: auto;\n}\n\n.row {\n  display: flex;\n  flex-wrap: wrap;\n  margin-right: -15px;\n  margin-left: -15px;\n}\n\n.no-gutters {\n  margin-right: 0;\n  margin-left: 0;\n}\n\n.no-gutters > .col,\n.no-gutters > [class*=\"col-\"] {\n  padding-right: 0;\n  padding-left: 0;\n}\n\n.col-1, .col-2, .col-3, .col-4, .col-5, .col-6, .col-7, .col-8, .col-9, .col-10, .col-11, .col-12, .col,\n.col-auto, .col-sm-1, .col-sm-2, .col-sm-3, .col-sm-4, .col-sm-5, .col-sm-6, .col-sm-7, .col-sm-8, .col-sm-9, .col-sm-10, .col-sm-11, .col-sm-12, .col-sm,\n.col-sm-auto, .col-md-1, .col-md-2, .col-md-3, .col-md-4, .col-md-5, .col-md-6, .col-md-7, .col-md-8, .col-md-9, .col-md-10, .col-md-11, .col-md-12, .col-md,\n.col-md-auto, .col-lg-1, .col-lg-2, .col-lg-3, .col-lg-4, .col-lg-5, .col-lg-6, .col-lg-7, .col-lg-8, .col-lg-9, .col-lg-10, .col-lg-11, .col-lg-12, .col-lg,\n.col-lg-auto, .col-xl-1, .col-xl-2, .col-xl-3, .col-xl-4, .col-xl-5, .col-xl-6, .col-xl-7, .col-xl-8, .col-xl-9, .col-xl-10, .col-xl-11, .col-xl-12, .col-xl,\n.col-xl-auto {\n  position: relative;\n  width: 100%;\n  padding-right: 15px;\n  padding-left: 15px;\n}\n\n.col {\n  flex-basis: 0;\n  flex-grow: 1;\n  max-width: 100%;\n}\n\n.col-auto {\n  flex: 0 0 auto;\n  width: auto;\n  max-width: 100%;\n}\n\n.col-1 {\n  flex: 0 0 8.333333%;\n  max-width: 8.333333%;\n}\n\n.col-2 {\n  flex: 0 0 16.666667%;\n  max-width: 16.666667%;\n}\n\n.col-3 {\n  flex: 0 0 25%;\n  max-width: 25%;\n}\n\n.col-4 {\n  flex: 0 0 33.333333%;\n  max-width: 33.333333%;\n}\n\n.col-5 {\n  flex: 0 0 41.666667%;\n  max-width: 41.666667%;\n}\n\n.col-6 {\n  flex: 0 0 50%;\n  max-width: 50%;\n}\n\n.col-7 {\n  flex: 0 0 58.333333%;\n  max-width: 58.333333%;\n}\n\n.col-8 {\n  flex: 0 0 66.666667%;\n  max-width: 66.666667%;\n}\n\n.col-9 {\n  flex: 0 0 75%;\n  max-width: 75%;\n}\n\n.col-10 {\n  flex: 0 0 83.333333%;\n  max-width: 83.333333%;\n}\n\n.col-11 {\n  flex: 0 0 91.666667%;\n  max-width: 91.666667%;\n}\n\n.col-12 {\n  flex: 0 0 100%;\n  max-width: 100%;\n}\n\n.order-first {\n  order: -1;\n}\n\n.order-last {\n  order: 13;\n}\n\n.order-0 {\n  order: 0;\n}\n\n.order-1 {\n  order: 1;\n}\n\n.order-2 {\n  order: 2;\n}\n\n.order-3 {\n  order: 3;\n}\n\n.order-4 {\n  order: 4;\n}\n\n.order-5 {\n  order: 5;\n}\n\n.order-6 {\n  order: 6;\n}\n\n.order-7 {\n  order: 7;\n}\n\n.order-8 {\n  order: 8;\n}\n\n.order-9 {\n  order: 9;\n}\n\n.order-10 {\n  order: 10;\n}\n\n.order-11 {\n  order: 11;\n}\n\n.order-12 {\n  order: 12;\n}\n\n.offset-1 {\n  margin-left: 8.333333%;\n}\n\n.offset-2 {\n  margin-left: 16.666667%;\n}\n\n.offset-3 {\n  margin-left: 25%;\n}\n\n.offset-4 {\n  margin-left: 33.333333%;\n}\n\n.offset-5 {\n  margin-left: 41.666667%;\n}\n\n.offset-6 {\n  margin-left: 50%;\n}\n\n.offset-7 {\n  margin-left: 58.333333%;\n}\n\n.offset-8 {\n  margin-left: 66.666667%;\n}\n\n.offset-9 {\n  margin-left: 75%;\n}\n\n.offset-10 {\n  margin-left: 83.333333%;\n}\n\n.offset-11 {\n  margin-left: 91.666667%;\n}\n\n@media (min-width: 576px) {\n  .col-sm {\n    flex-basis: 0;\n    flex-grow: 1;\n    max-width: 100%;\n  }\n  .col-sm-auto {\n    flex: 0 0 auto;\n    width: auto;\n    max-width: 100%;\n  }\n  .col-sm-1 {\n    flex: 0 0 8.333333%;\n    max-width: 8.333333%;\n  }\n  .col-sm-2 {\n    flex: 0 0 16.666667%;\n    max-width: 16.666667%;\n  }\n  .col-sm-3 {\n    flex: 0 0 25%;\n    max-width: 25%;\n  }\n  .col-sm-4 {\n    flex: 0 0 33.333333%;\n    max-width: 33.333333%;\n  }\n  .col-sm-5 {\n    flex: 0 0 41.666667%;\n    max-width: 41.666667%;\n  }\n  .col-sm-6 {\n    flex: 0 0 50%;\n    max-width: 50%;\n  }\n  .col-sm-7 {\n    flex: 0 0 58.333333%;\n    max-width: 58.333333%;\n  }\n  .col-sm-8 {\n    flex: 0 0 66.666667%;\n    max-width: 66.666667%;\n  }\n  .col-sm-9 {\n    flex: 0 0 75%;\n    max-width: 75%;\n  }\n  .col-sm-10 {\n    flex: 0 0 83.333333%;\n    max-width: 83.333333%;\n  }\n  .col-sm-11 {\n    flex: 0 0 91.666667%;\n    max-width: 91.666667%;\n  }\n  .col-sm-12 {\n    flex: 0 0 100%;\n    max-width: 100%;\n  }\n  .order-sm-first {\n    order: -1;\n  }\n  .order-sm-last {\n    order: 13;\n  }\n  .order-sm-0 {\n    order: 0;\n  }\n  .order-sm-1 {\n    order: 1;\n  }\n  .order-sm-2 {\n    order: 2;\n  }\n  .order-sm-3 {\n    order: 3;\n  }\n  .order-sm-4 {\n    order: 4;\n  }\n  .order-sm-5 {\n    order: 5;\n  }\n  .order-sm-6 {\n    order: 6;\n  }\n  .order-sm-7 {\n    order: 7;\n  }\n  .order-sm-8 {\n    order: 8;\n  }\n  .order-sm-9 {\n    order: 9;\n  }\n  .order-sm-10 {\n    order: 10;\n  }\n  .order-sm-11 {\n    order: 11;\n  }\n  .order-sm-12 {\n    order: 12;\n  }\n  .offset-sm-0 {\n    margin-left: 0;\n  }\n  .offset-sm-1 {\n    margin-left: 8.333333%;\n  }\n  .offset-sm-2 {\n    margin-left: 16.666667%;\n  }\n  .offset-sm-3 {\n    margin-left: 25%;\n  }\n  .offset-sm-4 {\n    margin-left: 33.333333%;\n  }\n  .offset-sm-5 {\n    margin-left: 41.666667%;\n  }\n  .offset-sm-6 {\n    margin-left: 50%;\n  }\n  .offset-sm-7 {\n    margin-left: 58.333333%;\n  }\n  .offset-sm-8 {\n    margin-left: 66.666667%;\n  }\n  .offset-sm-9 {\n    margin-left: 75%;\n  }\n  .offset-sm-10 {\n    margin-left: 83.333333%;\n  }\n  .offset-sm-11 {\n    margin-left: 91.666667%;\n  }\n}\n\n@media (min-width: 768px) {\n  .col-md {\n    flex-basis: 0;\n    flex-grow: 1;\n    max-width: 100%;\n  }\n  .col-md-auto {\n    flex: 0 0 auto;\n    width: auto;\n    max-width: 100%;\n  }\n  .col-md-1 {\n    flex: 0 0 8.333333%;\n    max-width: 8.333333%;\n  }\n  .col-md-2 {\n    flex: 0 0 16.666667%;\n    max-width: 16.666667%;\n  }\n  .col-md-3 {\n    flex: 0 0 25%;\n    max-width: 25%;\n  }\n  .col-md-4 {\n    flex: 0 0 33.333333%;\n    max-width: 33.333333%;\n  }\n  .col-md-5 {\n    flex: 0 0 41.666667%;\n    max-width: 41.666667%;\n  }\n  .col-md-6 {\n    flex: 0 0 50%;\n    max-width: 50%;\n  }\n  .col-md-7 {\n    flex: 0 0 58.333333%;\n    max-width: 58.333333%;\n  }\n  .col-md-8 {\n    flex: 0 0 66.666667%;\n    max-width: 66.666667%;\n  }\n  .col-md-9 {\n    flex: 0 0 75%;\n    max-width: 75%;\n  }\n  .col-md-10 {\n    flex: 0 0 83.333333%;\n    max-width: 83.333333%;\n  }\n  .col-md-11 {\n    flex: 0 0 91.666667%;\n    max-width: 91.666667%;\n  }\n  .col-md-12 {\n    flex: 0 0 100%;\n    max-width: 100%;\n  }\n  .order-md-first {\n    order: -1;\n  }\n  .order-md-last {\n    order: 13;\n  }\n  .order-md-0 {\n    order: 0;\n  }\n  .order-md-1 {\n    order: 1;\n  }\n  .order-md-2 {\n    order: 2;\n  }\n  .order-md-3 {\n    order: 3;\n  }\n  .order-md-4 {\n    order: 4;\n  }\n  .order-md-5 {\n    order: 5;\n  }\n  .order-md-6 {\n    order: 6;\n  }\n  .order-md-7 {\n    order: 7;\n  }\n  .order-md-8 {\n    order: 8;\n  }\n  .order-md-9 {\n    order: 9;\n  }\n  .order-md-10 {\n    order: 10;\n  }\n  .order-md-11 {\n    order: 11;\n  }\n  .order-md-12 {\n    order: 12;\n  }\n  .offset-md-0 {\n    margin-left: 0;\n  }\n  .offset-md-1 {\n    margin-left: 8.333333%;\n  }\n  .offset-md-2 {\n    margin-left: 16.666667%;\n  }\n  .offset-md-3 {\n    margin-left: 25%;\n  }\n  .offset-md-4 {\n    margin-left: 33.333333%;\n  }\n  .offset-md-5 {\n    margin-left: 41.666667%;\n  }\n  .offset-md-6 {\n    margin-left: 50%;\n  }\n  .offset-md-7 {\n    margin-left: 58.333333%;\n  }\n  .offset-md-8 {\n    margin-left: 66.666667%;\n  }\n  .offset-md-9 {\n    margin-left: 75%;\n  }\n  .offset-md-10 {\n    margin-left: 83.333333%;\n  }\n  .offset-md-11 {\n    margin-left: 91.666667%;\n  }\n}\n\n@media (min-width: 992px) {\n  .col-lg {\n    flex-basis: 0;\n    flex-grow: 1;\n    max-width: 100%;\n  }\n  .col-lg-auto {\n    flex: 0 0 auto;\n    width: auto;\n    max-width: 100%;\n  }\n  .col-lg-1 {\n    flex: 0 0 8.333333%;\n    max-width: 8.333333%;\n  }\n  .col-lg-2 {\n    flex: 0 0 16.666667%;\n    max-width: 16.666667%;\n  }\n  .col-lg-3 {\n    flex: 0 0 25%;\n    max-width: 25%;\n  }\n  .col-lg-4 {\n    flex: 0 0 33.333333%;\n    max-width: 33.333333%;\n  }\n  .col-lg-5 {\n    flex: 0 0 41.666667%;\n    max-width: 41.666667%;\n  }\n  .col-lg-6 {\n    flex: 0 0 50%;\n    max-width: 50%;\n  }\n  .col-lg-7 {\n    flex: 0 0 58.333333%;\n    max-width: 58.333333%;\n  }\n  .col-lg-8 {\n    flex: 0 0 66.666667%;\n    max-width: 66.666667%;\n  }\n  .col-lg-9 {\n    flex: 0 0 75%;\n    max-width: 75%;\n  }\n  .col-lg-10 {\n    flex: 0 0 83.333333%;\n    max-width: 83.333333%;\n  }\n  .col-lg-11 {\n    flex: 0 0 91.666667%;\n    max-width: 91.666667%;\n  }\n  .col-lg-12 {\n    flex: 0 0 100%;\n    max-width: 100%;\n  }\n  .order-lg-first {\n    order: -1;\n  }\n  .order-lg-last {\n    order: 13;\n  }\n  .order-lg-0 {\n    order: 0;\n  }\n  .order-lg-1 {\n    order: 1;\n  }\n  .order-lg-2 {\n    order: 2;\n  }\n  .order-lg-3 {\n    order: 3;\n  }\n  .order-lg-4 {\n    order: 4;\n  }\n  .order-lg-5 {\n    order: 5;\n  }\n  .order-lg-6 {\n    order: 6;\n  }\n  .order-lg-7 {\n    order: 7;\n  }\n  .order-lg-8 {\n    order: 8;\n  }\n  .order-lg-9 {\n    order: 9;\n  }\n  .order-lg-10 {\n    order: 10;\n  }\n  .order-lg-11 {\n    order: 11;\n  }\n  .order-lg-12 {\n    order: 12;\n  }\n  .offset-lg-0 {\n    margin-left: 0;\n  }\n  .offset-lg-1 {\n    margin-left: 8.333333%;\n  }\n  .offset-lg-2 {\n    margin-left: 16.666667%;\n  }\n  .offset-lg-3 {\n    margin-left: 25%;\n  }\n  .offset-lg-4 {\n    margin-left: 33.333333%;\n  }\n  .offset-lg-5 {\n    margin-left: 41.666667%;\n  }\n  .offset-lg-6 {\n    margin-left: 50%;\n  }\n  .offset-lg-7 {\n    margin-left: 58.333333%;\n  }\n  .offset-lg-8 {\n    margin-left: 66.666667%;\n  }\n  .offset-lg-9 {\n    margin-left: 75%;\n  }\n  .offset-lg-10 {\n    margin-left: 83.333333%;\n  }\n  .offset-lg-11 {\n    margin-left: 91.666667%;\n  }\n}\n\n@media (min-width: 1200px) {\n  .col-xl {\n    flex-basis: 0;\n    flex-grow: 1;\n    max-width: 100%;\n  }\n  .col-xl-auto {\n    flex: 0 0 auto;\n    width: auto;\n    max-width: 100%;\n  }\n  .col-xl-1 {\n    flex: 0 0 8.333333%;\n    max-width: 8.333333%;\n  }\n  .col-xl-2 {\n    flex: 0 0 16.666667%;\n    max-width: 16.666667%;\n  }\n  .col-xl-3 {\n    flex: 0 0 25%;\n    max-width: 25%;\n  }\n  .col-xl-4 {\n    flex: 0 0 33.333333%;\n    max-width: 33.333333%;\n  }\n  .col-xl-5 {\n    flex: 0 0 41.666667%;\n    max-width: 41.666667%;\n  }\n  .col-xl-6 {\n    flex: 0 0 50%;\n    max-width: 50%;\n  }\n  .col-xl-7 {\n    flex: 0 0 58.333333%;\n    max-width: 58.333333%;\n  }\n  .col-xl-8 {\n    flex: 0 0 66.666667%;\n    max-width: 66.666667%;\n  }\n  .col-xl-9 {\n    flex: 0 0 75%;\n    max-width: 75%;\n  }\n  .col-xl-10 {\n    flex: 0 0 83.333333%;\n    max-width: 83.333333%;\n  }\n  .col-xl-11 {\n    flex: 0 0 91.666667%;\n    max-width: 91.666667%;\n  }\n  .col-xl-12 {\n    flex: 0 0 100%;\n    max-width: 100%;\n  }\n  .order-xl-first {\n    order: -1;\n  }\n  .order-xl-last {\n    order: 13;\n  }\n  .order-xl-0 {\n    order: 0;\n  }\n  .order-xl-1 {\n    order: 1;\n  }\n  .order-xl-2 {\n    order: 2;\n  }\n  .order-xl-3 {\n    order: 3;\n  }\n  .order-xl-4 {\n    order: 4;\n  }\n  .order-xl-5 {\n    order: 5;\n  }\n  .order-xl-6 {\n    order: 6;\n  }\n  .order-xl-7 {\n    order: 7;\n  }\n  .order-xl-8 {\n    order: 8;\n  }\n  .order-xl-9 {\n    order: 9;\n  }\n  .order-xl-10 {\n    order: 10;\n  }\n  .order-xl-11 {\n    order: 11;\n  }\n  .order-xl-12 {\n    order: 12;\n  }\n  .offset-xl-0 {\n    margin-left: 0;\n  }\n  .offset-xl-1 {\n    margin-left: 8.333333%;\n  }\n  .offset-xl-2 {\n    margin-left: 16.666667%;\n  }\n  .offset-xl-3 {\n    margin-left: 25%;\n  }\n  .offset-xl-4 {\n    margin-left: 33.333333%;\n  }\n  .offset-xl-5 {\n    margin-left: 41.666667%;\n  }\n  .offset-xl-6 {\n    margin-left: 50%;\n  }\n  .offset-xl-7 {\n    margin-left: 58.333333%;\n  }\n  .offset-xl-8 {\n    margin-left: 66.666667%;\n  }\n  .offset-xl-9 {\n    margin-left: 75%;\n  }\n  .offset-xl-10 {\n    margin-left: 83.333333%;\n  }\n  .offset-xl-11 {\n    margin-left: 91.666667%;\n  }\n}\n\n.table {\n  width: 100%;\n  margin-bottom: 1rem;\n  color: #212529;\n}\n\n.table th,\n.table td {\n  padding: 0.75rem;\n  vertical-align: top;\n  border-top: 1px solid #dee2e6;\n}\n\n.table thead th {\n  vertical-align: bottom;\n  border-bottom: 2px solid #dee2e6;\n}\n\n.table tbody + tbody {\n  border-top: 2px solid #dee2e6;\n}\n\n.table-sm th,\n.table-sm td {\n  padding: 0.3rem;\n}\n\n.table-bordered {\n  border: 1px solid #dee2e6;\n}\n\n.table-bordered th,\n.table-bordered td {\n  border: 1px solid #dee2e6;\n}\n\n.table-bordered thead th,\n.table-bordered thead td {\n  border-bottom-width: 2px;\n}\n\n.table-borderless th,\n.table-borderless td,\n.table-borderless thead th,\n.table-borderless tbody + tbody {\n  border: 0;\n}\n\n.table-striped tbody tr:nth-of-type(odd) {\n  background-color: rgba(0, 0, 0, 0.05);\n}\n\n.table-hover tbody tr:hover {\n  color: #212529;\n  background-color: rgba(0, 0, 0, 0.075);\n}\n\n.table-primary,\n.table-primary > th,\n.table-primary > td {\n  background-color: #b8daff;\n}\n\n.table-primary th,\n.table-primary td,\n.table-primary thead th,\n.table-primary tbody + tbody {\n  border-color: #7abaff;\n}\n\n.table-hover .table-primary:hover {\n  background-color: #9fcdff;\n}\n\n.table-hover .table-primary:hover > td,\n.table-hover .table-primary:hover > th {\n  background-color: #9fcdff;\n}\n\n.table-secondary,\n.table-secondary > th,\n.table-secondary > td {\n  background-color: #d6d8db;\n}\n\n.table-secondary th,\n.table-secondary td,\n.table-secondary thead th,\n.table-secondary tbody + tbody {\n  border-color: #b3b7bb;\n}\n\n.table-hover .table-secondary:hover {\n  background-color: #c8cbcf;\n}\n\n.table-hover .table-secondary:hover > td,\n.table-hover .table-secondary:hover > th {\n  background-color: #c8cbcf;\n}\n\n.table-success,\n.table-success > th,\n.table-success > td {\n  background-color: #c3e6cb;\n}\n\n.table-success th,\n.table-success td,\n.table-success thead th,\n.table-success tbody + tbody {\n  border-color: #8fd19e;\n}\n\n.table-hover .table-success:hover {\n  background-color: #b1dfbb;\n}\n\n.table-hover .table-success:hover > td,\n.table-hover .table-success:hover > th {\n  background-color: #b1dfbb;\n}\n\n.table-info,\n.table-info > th,\n.table-info > td {\n  background-color: #bee5eb;\n}\n\n.table-info th,\n.table-info td,\n.table-info thead th,\n.table-info tbody + tbody {\n  border-color: #86cfda;\n}\n\n.table-hover .table-info:hover {\n  background-color: #abdde5;\n}\n\n.table-hover .table-info:hover > td,\n.table-hover .table-info:hover > th {\n  background-color: #abdde5;\n}\n\n.table-warning,\n.table-warning > th,\n.table-warning > td {\n  background-color: #ffeeba;\n}\n\n.table-warning th,\n.table-warning td,\n.table-warning thead th,\n.table-warning tbody + tbody {\n  border-color: #ffdf7e;\n}\n\n.table-hover .table-warning:hover {\n  background-color: #ffe8a1;\n}\n\n.table-hover .table-warning:hover > td,\n.table-hover .table-warning:hover > th {\n  background-color: #ffe8a1;\n}\n\n.table-danger,\n.table-danger > th,\n.table-danger > td {\n  background-color: #f5c6cb;\n}\n\n.table-danger th,\n.table-danger td,\n.table-danger thead th,\n.table-danger tbody + tbody {\n  border-color: #ed969e;\n}\n\n.table-hover .table-danger:hover {\n  background-color: #f1b0b7;\n}\n\n.table-hover .table-danger:hover > td,\n.table-hover .table-danger:hover > th {\n  background-color: #f1b0b7;\n}\n\n.table-light,\n.table-light > th,\n.table-light > td {\n  background-color: #fdfdfe;\n}\n\n.table-light th,\n.table-light td,\n.table-light thead th,\n.table-light tbody + tbody {\n  border-color: #fbfcfc;\n}\n\n.table-hover .table-light:hover {\n  background-color: #ececf6;\n}\n\n.table-hover .table-light:hover > td,\n.table-hover .table-light:hover > th {\n  background-color: #ececf6;\n}\n\n.table-dark,\n.table-dark > th,\n.table-dark > td {\n  background-color: #c6c8ca;\n}\n\n.table-dark th,\n.table-dark td,\n.table-dark thead th,\n.table-dark tbody + tbody {\n  border-color: #95999c;\n}\n\n.table-hover .table-dark:hover {\n  background-color: #b9bbbe;\n}\n\n.table-hover .table-dark:hover > td,\n.table-hover .table-dark:hover > th {\n  background-color: #b9bbbe;\n}\n\n.table-active,\n.table-active > th,\n.table-active > td {\n  background-color: rgba(0, 0, 0, 0.075);\n}\n\n.table-hover .table-active:hover {\n  background-color: rgba(0, 0, 0, 0.075);\n}\n\n.table-hover .table-active:hover > td,\n.table-hover .table-active:hover > th {\n  background-color: rgba(0, 0, 0, 0.075);\n}\n\n.table .thead-dark th {\n  color: #fff;\n  background-color: #343a40;\n  border-color: #454d55;\n}\n\n.table .thead-light th {\n  color: #495057;\n  background-color: #e9ecef;\n  border-color: #dee2e6;\n}\n\n.table-dark {\n  color: #fff;\n  background-color: #343a40;\n}\n\n.table-dark th,\n.table-dark td,\n.table-dark thead th {\n  border-color: #454d55;\n}\n\n.table-dark.table-bordered {\n  border: 0;\n}\n\n.table-dark.table-striped tbody tr:nth-of-type(odd) {\n  background-color: rgba(255, 255, 255, 0.05);\n}\n\n.table-dark.table-hover tbody tr:hover {\n  color: #fff;\n  background-color: rgba(255, 255, 255, 0.075);\n}\n\n@media (max-width: 575.98px) {\n  .table-responsive-sm {\n    display: block;\n    width: 100%;\n    overflow-x: auto;\n    -webkit-overflow-scrolling: touch;\n  }\n  .table-responsive-sm > .table-bordered {\n    border: 0;\n  }\n}\n\n@media (max-width: 767.98px) {\n  .table-responsive-md {\n    display: block;\n    width: 100%;\n    overflow-x: auto;\n    -webkit-overflow-scrolling: touch;\n  }\n  .table-responsive-md > .table-bordered {\n    border: 0;\n  }\n}\n\n@media (max-width: 991.98px) {\n  .table-responsive-lg {\n    display: block;\n    width: 100%;\n    overflow-x: auto;\n    -webkit-overflow-scrolling: touch;\n  }\n  .table-responsive-lg > .table-bordered {\n    border: 0;\n  }\n}\n\n@media (max-width: 1199.98px) {\n  .table-responsive-xl {\n    display: block;\n    width: 100%;\n    overflow-x: auto;\n    -webkit-overflow-scrolling: touch;\n  }\n  .table-responsive-xl > .table-bordered {\n    border: 0;\n  }\n}\n\n.table-responsive {\n  display: block;\n  width: 100%;\n  overflow-x: auto;\n  -webkit-overflow-scrolling: touch;\n}\n\n.table-responsive > .table-bordered {\n  border: 0;\n}\n\n.form-control {\n  display: block;\n  width: 100%;\n  height: calc(1.5em + 0.75rem + 2px);\n  padding: 0.375rem 0.75rem;\n  font-size: 1rem;\n  font-weight: 400;\n  line-height: 1.5;\n  color: #495057;\n  background-color: #fff;\n  background-clip: padding-box;\n  border: 1px solid #ced4da;\n  border-radius: 0.25rem;\n  transition: border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .form-control {\n    transition: none;\n  }\n}\n\n.form-control::-ms-expand {\n  background-color: transparent;\n  border: 0;\n}\n\n.form-control:focus {\n  color: #495057;\n  background-color: #fff;\n  border-color: #80bdff;\n  outline: 0;\n  box-shadow: 0 0 0 0.2rem rgba(0, 123, 255, 0.25);\n}\n\n.form-control::placeholder {\n  color: #6c757d;\n  opacity: 1;\n}\n\n.form-control:disabled, .form-control[readonly] {\n  background-color: #e9ecef;\n  opacity: 1;\n}\n\nselect.form-control:focus::-ms-value {\n  color: #495057;\n  background-color: #fff;\n}\n\n.form-control-file,\n.form-control-range {\n  display: block;\n  width: 100%;\n}\n\n.col-form-label {\n  padding-top: calc(0.375rem + 1px);\n  padding-bottom: calc(0.375rem + 1px);\n  margin-bottom: 0;\n  font-size: inherit;\n  line-height: 1.5;\n}\n\n.col-form-label-lg {\n  padding-top: calc(0.5rem + 1px);\n  padding-bottom: calc(0.5rem + 1px);\n  font-size: 1.25rem;\n  line-height: 1.5;\n}\n\n.col-form-label-sm {\n  padding-top: calc(0.25rem + 1px);\n  padding-bottom: calc(0.25rem + 1px);\n  font-size: 0.875rem;\n  line-height: 1.5;\n}\n\n.form-control-plaintext {\n  display: block;\n  width: 100%;\n  padding-top: 0.375rem;\n  padding-bottom: 0.375rem;\n  margin-bottom: 0;\n  line-height: 1.5;\n  color: #212529;\n  background-color: transparent;\n  border: solid transparent;\n  border-width: 1px 0;\n}\n\n.form-control-plaintext.form-control-sm, .form-control-plaintext.form-control-lg {\n  padding-right: 0;\n  padding-left: 0;\n}\n\n.form-control-sm {\n  height: calc(1.5em + 0.5rem + 2px);\n  padding: 0.25rem 0.5rem;\n  font-size: 0.875rem;\n  line-height: 1.5;\n  border-radius: 0.2rem;\n}\n\n.form-control-lg {\n  height: calc(1.5em + 1rem + 2px);\n  padding: 0.5rem 1rem;\n  font-size: 1.25rem;\n  line-height: 1.5;\n  border-radius: 0.3rem;\n}\n\nselect.form-control[size], select.form-control[multiple] {\n  height: auto;\n}\n\ntextarea.form-control {\n  height: auto;\n}\n\n.form-group {\n  margin-bottom: 1rem;\n}\n\n.form-text {\n  display: block;\n  margin-top: 0.25rem;\n}\n\n.form-row {\n  display: flex;\n  flex-wrap: wrap;\n  margin-right: -5px;\n  margin-left: -5px;\n}\n\n.form-row > .col,\n.form-row > [class*=\"col-\"] {\n  padding-right: 5px;\n  padding-left: 5px;\n}\n\n.form-check {\n  position: relative;\n  display: block;\n  padding-left: 1.25rem;\n}\n\n.form-check-input {\n  position: absolute;\n  margin-top: 0.3rem;\n  margin-left: -1.25rem;\n}\n\n.form-check-input:disabled ~ .form-check-label {\n  color: #6c757d;\n}\n\n.form-check-label {\n  margin-bottom: 0;\n}\n\n.form-check-inline {\n  display: inline-flex;\n  align-items: center;\n  padding-left: 0;\n  margin-right: 0.75rem;\n}\n\n.form-check-inline .form-check-input {\n  position: static;\n  margin-top: 0;\n  margin-right: 0.3125rem;\n  margin-left: 0;\n}\n\n.valid-feedback {\n  display: none;\n  width: 100%;\n  margin-top: 0.25rem;\n  font-size: 80%;\n  color: #28a745;\n}\n\n.valid-tooltip {\n  position: absolute;\n  top: 100%;\n  z-index: 5;\n  display: none;\n  max-width: 100%;\n  padding: 0.25rem 0.5rem;\n  margin-top: .1rem;\n  font-size: 0.875rem;\n  line-height: 1.5;\n  color: #fff;\n  background-color: rgba(40, 167, 69, 0.9);\n  border-radius: 0.25rem;\n}\n\n.was-validated .form-control:valid, .form-control.is-valid {\n  border-color: #28a745;\n  padding-right: calc(1.5em + 0.75rem);\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 8 8'%3e%3cpath fill='%2328a745' d='M2.3 6.73L.6 4.53c-.4-1.04.46-1.4 1.1-.8l1.1 1.4 3.4-3.8c.6-.63 1.6-.27 1.2.7l-4 4.6c-.43.5-.8.4-1.1.1z'/%3e%3c/svg%3e\");\n  background-repeat: no-repeat;\n  background-position: center right calc(0.375em + 0.1875rem);\n  background-size: calc(0.75em + 0.375rem) calc(0.75em + 0.375rem);\n}\n\n.was-validated .form-control:valid:focus, .form-control.is-valid:focus {\n  border-color: #28a745;\n  box-shadow: 0 0 0 0.2rem rgba(40, 167, 69, 0.25);\n}\n\n.was-validated .form-control:valid ~ .valid-feedback,\n.was-validated .form-control:valid ~ .valid-tooltip, .form-control.is-valid ~ .valid-feedback,\n.form-control.is-valid ~ .valid-tooltip {\n  display: block;\n}\n\n.was-validated textarea.form-control:valid, textarea.form-control.is-valid {\n  padding-right: calc(1.5em + 0.75rem);\n  background-position: top calc(0.375em + 0.1875rem) right calc(0.375em + 0.1875rem);\n}\n\n.was-validated .custom-select:valid, .custom-select.is-valid {\n  border-color: #28a745;\n  padding-right: calc((1em + 0.75rem) * 3 / 4 + 1.75rem);\n  background: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 4 5'%3e%3cpath fill='%23343a40' d='M2 0L0 2h4zm0 5L0 3h4z'/%3e%3c/svg%3e\") no-repeat right 0.75rem center/8px 10px, url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 8 8'%3e%3cpath fill='%2328a745' d='M2.3 6.73L.6 4.53c-.4-1.04.46-1.4 1.1-.8l1.1 1.4 3.4-3.8c.6-.63 1.6-.27 1.2.7l-4 4.6c-.43.5-.8.4-1.1.1z'/%3e%3c/svg%3e\") #fff no-repeat center right 1.75rem/calc(0.75em + 0.375rem) calc(0.75em + 0.375rem);\n}\n\n.was-validated .custom-select:valid:focus, .custom-select.is-valid:focus {\n  border-color: #28a745;\n  box-shadow: 0 0 0 0.2rem rgba(40, 167, 69, 0.25);\n}\n\n.was-validated .custom-select:valid ~ .valid-feedback,\n.was-validated .custom-select:valid ~ .valid-tooltip, .custom-select.is-valid ~ .valid-feedback,\n.custom-select.is-valid ~ .valid-tooltip {\n  display: block;\n}\n\n.was-validated .form-control-file:valid ~ .valid-feedback,\n.was-validated .form-control-file:valid ~ .valid-tooltip, .form-control-file.is-valid ~ .valid-feedback,\n.form-control-file.is-valid ~ .valid-tooltip {\n  display: block;\n}\n\n.was-validated .form-check-input:valid ~ .form-check-label, .form-check-input.is-valid ~ .form-check-label {\n  color: #28a745;\n}\n\n.was-validated .form-check-input:valid ~ .valid-feedback,\n.was-validated .form-check-input:valid ~ .valid-tooltip, .form-check-input.is-valid ~ .valid-feedback,\n.form-check-input.is-valid ~ .valid-tooltip {\n  display: block;\n}\n\n.was-validated .custom-control-input:valid ~ .custom-control-label, .custom-control-input.is-valid ~ .custom-control-label {\n  color: #28a745;\n}\n\n.was-validated .custom-control-input:valid ~ .custom-control-label::before, .custom-control-input.is-valid ~ .custom-control-label::before {\n  border-color: #28a745;\n}\n\n.was-validated .custom-control-input:valid ~ .valid-feedback,\n.was-validated .custom-control-input:valid ~ .valid-tooltip, .custom-control-input.is-valid ~ .valid-feedback,\n.custom-control-input.is-valid ~ .valid-tooltip {\n  display: block;\n}\n\n.was-validated .custom-control-input:valid:checked ~ .custom-control-label::before, .custom-control-input.is-valid:checked ~ .custom-control-label::before {\n  border-color: #34ce57;\n  background-color: #34ce57;\n}\n\n.was-validated .custom-control-input:valid:focus ~ .custom-control-label::before, .custom-control-input.is-valid:focus ~ .custom-control-label::before {\n  box-shadow: 0 0 0 0.2rem rgba(40, 167, 69, 0.25);\n}\n\n.was-validated .custom-control-input:valid:focus:not(:checked) ~ .custom-control-label::before, .custom-control-input.is-valid:focus:not(:checked) ~ .custom-control-label::before {\n  border-color: #28a745;\n}\n\n.was-validated .custom-file-input:valid ~ .custom-file-label, .custom-file-input.is-valid ~ .custom-file-label {\n  border-color: #28a745;\n}\n\n.was-validated .custom-file-input:valid ~ .valid-feedback,\n.was-validated .custom-file-input:valid ~ .valid-tooltip, .custom-file-input.is-valid ~ .valid-feedback,\n.custom-file-input.is-valid ~ .valid-tooltip {\n  display: block;\n}\n\n.was-validated .custom-file-input:valid:focus ~ .custom-file-label, .custom-file-input.is-valid:focus ~ .custom-file-label {\n  border-color: #28a745;\n  box-shadow: 0 0 0 0.2rem rgba(40, 167, 69, 0.25);\n}\n\n.invalid-feedback {\n  display: none;\n  width: 100%;\n  margin-top: 0.25rem;\n  font-size: 80%;\n  color: #dc3545;\n}\n\n.invalid-tooltip {\n  position: absolute;\n  top: 100%;\n  z-index: 5;\n  display: none;\n  max-width: 100%;\n  padding: 0.25rem 0.5rem;\n  margin-top: .1rem;\n  font-size: 0.875rem;\n  line-height: 1.5;\n  color: #fff;\n  background-color: rgba(220, 53, 69, 0.9);\n  border-radius: 0.25rem;\n}\n\n.was-validated .form-control:invalid, .form-control.is-invalid {\n  border-color: #dc3545;\n  padding-right: calc(1.5em + 0.75rem);\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' fill='%23dc3545' viewBox='-2 -2 7 7'%3e%3cpath stroke='%23dc3545' d='M0 0l3 3m0-3L0 3'/%3e%3ccircle r='.5'/%3e%3ccircle cx='3' r='.5'/%3e%3ccircle cy='3' r='.5'/%3e%3ccircle cx='3' cy='3' r='.5'/%3e%3c/svg%3E\");\n  background-repeat: no-repeat;\n  background-position: center right calc(0.375em + 0.1875rem);\n  background-size: calc(0.75em + 0.375rem) calc(0.75em + 0.375rem);\n}\n\n.was-validated .form-control:invalid:focus, .form-control.is-invalid:focus {\n  border-color: #dc3545;\n  box-shadow: 0 0 0 0.2rem rgba(220, 53, 69, 0.25);\n}\n\n.was-validated .form-control:invalid ~ .invalid-feedback,\n.was-validated .form-control:invalid ~ .invalid-tooltip, .form-control.is-invalid ~ .invalid-feedback,\n.form-control.is-invalid ~ .invalid-tooltip {\n  display: block;\n}\n\n.was-validated textarea.form-control:invalid, textarea.form-control.is-invalid {\n  padding-right: calc(1.5em + 0.75rem);\n  background-position: top calc(0.375em + 0.1875rem) right calc(0.375em + 0.1875rem);\n}\n\n.was-validated .custom-select:invalid, .custom-select.is-invalid {\n  border-color: #dc3545;\n  padding-right: calc((1em + 0.75rem) * 3 / 4 + 1.75rem);\n  background: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 4 5'%3e%3cpath fill='%23343a40' d='M2 0L0 2h4zm0 5L0 3h4z'/%3e%3c/svg%3e\") no-repeat right 0.75rem center/8px 10px, url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' fill='%23dc3545' viewBox='-2 -2 7 7'%3e%3cpath stroke='%23dc3545' d='M0 0l3 3m0-3L0 3'/%3e%3ccircle r='.5'/%3e%3ccircle cx='3' r='.5'/%3e%3ccircle cy='3' r='.5'/%3e%3ccircle cx='3' cy='3' r='.5'/%3e%3c/svg%3E\") #fff no-repeat center right 1.75rem/calc(0.75em + 0.375rem) calc(0.75em + 0.375rem);\n}\n\n.was-validated .custom-select:invalid:focus, .custom-select.is-invalid:focus {\n  border-color: #dc3545;\n  box-shadow: 0 0 0 0.2rem rgba(220, 53, 69, 0.25);\n}\n\n.was-validated .custom-select:invalid ~ .invalid-feedback,\n.was-validated .custom-select:invalid ~ .invalid-tooltip, .custom-select.is-invalid ~ .invalid-feedback,\n.custom-select.is-invalid ~ .invalid-tooltip {\n  display: block;\n}\n\n.was-validated .form-control-file:invalid ~ .invalid-feedback,\n.was-validated .form-control-file:invalid ~ .invalid-tooltip, .form-control-file.is-invalid ~ .invalid-feedback,\n.form-control-file.is-invalid ~ .invalid-tooltip {\n  display: block;\n}\n\n.was-validated .form-check-input:invalid ~ .form-check-label, .form-check-input.is-invalid ~ .form-check-label {\n  color: #dc3545;\n}\n\n.was-validated .form-check-input:invalid ~ .invalid-feedback,\n.was-validated .form-check-input:invalid ~ .invalid-tooltip, .form-check-input.is-invalid ~ .invalid-feedback,\n.form-check-input.is-invalid ~ .invalid-tooltip {\n  display: block;\n}\n\n.was-validated .custom-control-input:invalid ~ .custom-control-label, .custom-control-input.is-invalid ~ .custom-control-label {\n  color: #dc3545;\n}\n\n.was-validated .custom-control-input:invalid ~ .custom-control-label::before, .custom-control-input.is-invalid ~ .custom-control-label::before {\n  border-color: #dc3545;\n}\n\n.was-validated .custom-control-input:invalid ~ .invalid-feedback,\n.was-validated .custom-control-input:invalid ~ .invalid-tooltip, .custom-control-input.is-invalid ~ .invalid-feedback,\n.custom-control-input.is-invalid ~ .invalid-tooltip {\n  display: block;\n}\n\n.was-validated .custom-control-input:invalid:checked ~ .custom-control-label::before, .custom-control-input.is-invalid:checked ~ .custom-control-label::before {\n  border-color: #e4606d;\n  background-color: #e4606d;\n}\n\n.was-validated .custom-control-input:invalid:focus ~ .custom-control-label::before, .custom-control-input.is-invalid:focus ~ .custom-control-label::before {\n  box-shadow: 0 0 0 0.2rem rgba(220, 53, 69, 0.25);\n}\n\n.was-validated .custom-control-input:invalid:focus:not(:checked) ~ .custom-control-label::before, .custom-control-input.is-invalid:focus:not(:checked) ~ .custom-control-label::before {\n  border-color: #dc3545;\n}\n\n.was-validated .custom-file-input:invalid ~ .custom-file-label, .custom-file-input.is-invalid ~ .custom-file-label {\n  border-color: #dc3545;\n}\n\n.was-validated .custom-file-input:invalid ~ .invalid-feedback,\n.was-validated .custom-file-input:invalid ~ .invalid-tooltip, .custom-file-input.is-invalid ~ .invalid-feedback,\n.custom-file-input.is-invalid ~ .invalid-tooltip {\n  display: block;\n}\n\n.was-validated .custom-file-input:invalid:focus ~ .custom-file-label, .custom-file-input.is-invalid:focus ~ .custom-file-label {\n  border-color: #dc3545;\n  box-shadow: 0 0 0 0.2rem rgba(220, 53, 69, 0.25);\n}\n\n.form-inline {\n  display: flex;\n  flex-flow: row wrap;\n  align-items: center;\n}\n\n.form-inline .form-check {\n  width: 100%;\n}\n\n@media (min-width: 576px) {\n  .form-inline label {\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    margin-bottom: 0;\n  }\n  .form-inline .form-group {\n    display: flex;\n    flex: 0 0 auto;\n    flex-flow: row wrap;\n    align-items: center;\n    margin-bottom: 0;\n  }\n  .form-inline .form-control {\n    display: inline-block;\n    width: auto;\n    vertical-align: middle;\n  }\n  .form-inline .form-control-plaintext {\n    display: inline-block;\n  }\n  .form-inline .input-group,\n  .form-inline .custom-select {\n    width: auto;\n  }\n  .form-inline .form-check {\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    width: auto;\n    padding-left: 0;\n  }\n  .form-inline .form-check-input {\n    position: relative;\n    flex-shrink: 0;\n    margin-top: 0;\n    margin-right: 0.25rem;\n    margin-left: 0;\n  }\n  .form-inline .custom-control {\n    align-items: center;\n    justify-content: center;\n  }\n  .form-inline .custom-control-label {\n    margin-bottom: 0;\n  }\n}\n\n.btn {\n  display: inline-block;\n  font-weight: 400;\n  color: #212529;\n  text-align: center;\n  vertical-align: middle;\n  user-select: none;\n  background-color: transparent;\n  border: 1px solid transparent;\n  padding: 0.375rem 0.75rem;\n  font-size: 1rem;\n  line-height: 1.5;\n  border-radius: 0.25rem;\n  transition: color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .btn {\n    transition: none;\n  }\n}\n\n.btn:hover {\n  color: #212529;\n  text-decoration: none;\n}\n\n.btn:focus, .btn.focus {\n  outline: 0;\n  box-shadow: 0 0 0 0.2rem rgba(0, 123, 255, 0.25);\n}\n\n.btn.disabled, .btn:disabled {\n  opacity: 0.65;\n}\n\na.btn.disabled,\nfieldset:disabled a.btn {\n  pointer-events: none;\n}\n\n.btn-primary {\n  color: #fff;\n  background-color: #007bff;\n  border-color: #007bff;\n}\n\n.btn-primary:hover {\n  color: #fff;\n  background-color: #0069d9;\n  border-color: #0062cc;\n}\n\n.btn-primary:focus, .btn-primary.focus {\n  box-shadow: 0 0 0 0.2rem rgba(38, 143, 255, 0.5);\n}\n\n.btn-primary.disabled, .btn-primary:disabled {\n  color: #fff;\n  background-color: #007bff;\n  border-color: #007bff;\n}\n\n.btn-primary:not(:disabled):not(.disabled):active, .btn-primary:not(:disabled):not(.disabled).active,\n.show > .btn-primary.dropdown-toggle {\n  color: #fff;\n  background-color: #0062cc;\n  border-color: #005cbf;\n}\n\n.btn-primary:not(:disabled):not(.disabled):active:focus, .btn-primary:not(:disabled):not(.disabled).active:focus,\n.show > .btn-primary.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(38, 143, 255, 0.5);\n}\n\n.btn-secondary {\n  color: #fff;\n  background-color: #6c757d;\n  border-color: #6c757d;\n}\n\n.btn-secondary:hover {\n  color: #fff;\n  background-color: #5a6268;\n  border-color: #545b62;\n}\n\n.btn-secondary:focus, .btn-secondary.focus {\n  box-shadow: 0 0 0 0.2rem rgba(130, 138, 145, 0.5);\n}\n\n.btn-secondary.disabled, .btn-secondary:disabled {\n  color: #fff;\n  background-color: #6c757d;\n  border-color: #6c757d;\n}\n\n.btn-secondary:not(:disabled):not(.disabled):active, .btn-secondary:not(:disabled):not(.disabled).active,\n.show > .btn-secondary.dropdown-toggle {\n  color: #fff;\n  background-color: #545b62;\n  border-color: #4e555b;\n}\n\n.btn-secondary:not(:disabled):not(.disabled):active:focus, .btn-secondary:not(:disabled):not(.disabled).active:focus,\n.show > .btn-secondary.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(130, 138, 145, 0.5);\n}\n\n.btn-success {\n  color: #fff;\n  background-color: #28a745;\n  border-color: #28a745;\n}\n\n.btn-success:hover {\n  color: #fff;\n  background-color: #218838;\n  border-color: #1e7e34;\n}\n\n.btn-success:focus, .btn-success.focus {\n  box-shadow: 0 0 0 0.2rem rgba(72, 180, 97, 0.5);\n}\n\n.btn-success.disabled, .btn-success:disabled {\n  color: #fff;\n  background-color: #28a745;\n  border-color: #28a745;\n}\n\n.btn-success:not(:disabled):not(.disabled):active, .btn-success:not(:disabled):not(.disabled).active,\n.show > .btn-success.dropdown-toggle {\n  color: #fff;\n  background-color: #1e7e34;\n  border-color: #1c7430;\n}\n\n.btn-success:not(:disabled):not(.disabled):active:focus, .btn-success:not(:disabled):not(.disabled).active:focus,\n.show > .btn-success.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(72, 180, 97, 0.5);\n}\n\n.btn-info {\n  color: #fff;\n  background-color: #17a2b8;\n  border-color: #17a2b8;\n}\n\n.btn-info:hover {\n  color: #fff;\n  background-color: #138496;\n  border-color: #117a8b;\n}\n\n.btn-info:focus, .btn-info.focus {\n  box-shadow: 0 0 0 0.2rem rgba(58, 176, 195, 0.5);\n}\n\n.btn-info.disabled, .btn-info:disabled {\n  color: #fff;\n  background-color: #17a2b8;\n  border-color: #17a2b8;\n}\n\n.btn-info:not(:disabled):not(.disabled):active, .btn-info:not(:disabled):not(.disabled).active,\n.show > .btn-info.dropdown-toggle {\n  color: #fff;\n  background-color: #117a8b;\n  border-color: #10707f;\n}\n\n.btn-info:not(:disabled):not(.disabled):active:focus, .btn-info:not(:disabled):not(.disabled).active:focus,\n.show > .btn-info.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(58, 176, 195, 0.5);\n}\n\n.btn-warning {\n  color: #212529;\n  background-color: #ffc107;\n  border-color: #ffc107;\n}\n\n.btn-warning:hover {\n  color: #212529;\n  background-color: #e0a800;\n  border-color: #d39e00;\n}\n\n.btn-warning:focus, .btn-warning.focus {\n  box-shadow: 0 0 0 0.2rem rgba(222, 170, 12, 0.5);\n}\n\n.btn-warning.disabled, .btn-warning:disabled {\n  color: #212529;\n  background-color: #ffc107;\n  border-color: #ffc107;\n}\n\n.btn-warning:not(:disabled):not(.disabled):active, .btn-warning:not(:disabled):not(.disabled).active,\n.show > .btn-warning.dropdown-toggle {\n  color: #212529;\n  background-color: #d39e00;\n  border-color: #c69500;\n}\n\n.btn-warning:not(:disabled):not(.disabled):active:focus, .btn-warning:not(:disabled):not(.disabled).active:focus,\n.show > .btn-warning.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(222, 170, 12, 0.5);\n}\n\n.btn-danger {\n  color: #fff;\n  background-color: #dc3545;\n  border-color: #dc3545;\n}\n\n.btn-danger:hover {\n  color: #fff;\n  background-color: #c82333;\n  border-color: #bd2130;\n}\n\n.btn-danger:focus, .btn-danger.focus {\n  box-shadow: 0 0 0 0.2rem rgba(225, 83, 97, 0.5);\n}\n\n.btn-danger.disabled, .btn-danger:disabled {\n  color: #fff;\n  background-color: #dc3545;\n  border-color: #dc3545;\n}\n\n.btn-danger:not(:disabled):not(.disabled):active, .btn-danger:not(:disabled):not(.disabled).active,\n.show > .btn-danger.dropdown-toggle {\n  color: #fff;\n  background-color: #bd2130;\n  border-color: #b21f2d;\n}\n\n.btn-danger:not(:disabled):not(.disabled):active:focus, .btn-danger:not(:disabled):not(.disabled).active:focus,\n.show > .btn-danger.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(225, 83, 97, 0.5);\n}\n\n.btn-light {\n  color: #212529;\n  background-color: #f8f9fa;\n  border-color: #f8f9fa;\n}\n\n.btn-light:hover {\n  color: #212529;\n  background-color: #e2e6ea;\n  border-color: #dae0e5;\n}\n\n.btn-light:focus, .btn-light.focus {\n  box-shadow: 0 0 0 0.2rem rgba(216, 217, 219, 0.5);\n}\n\n.btn-light.disabled, .btn-light:disabled {\n  color: #212529;\n  background-color: #f8f9fa;\n  border-color: #f8f9fa;\n}\n\n.btn-light:not(:disabled):not(.disabled):active, .btn-light:not(:disabled):not(.disabled).active,\n.show > .btn-light.dropdown-toggle {\n  color: #212529;\n  background-color: #dae0e5;\n  border-color: #d3d9df;\n}\n\n.btn-light:not(:disabled):not(.disabled):active:focus, .btn-light:not(:disabled):not(.disabled).active:focus,\n.show > .btn-light.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(216, 217, 219, 0.5);\n}\n\n.btn-dark {\n  color: #fff;\n  background-color: #343a40;\n  border-color: #343a40;\n}\n\n.btn-dark:hover {\n  color: #fff;\n  background-color: #23272b;\n  border-color: #1d2124;\n}\n\n.btn-dark:focus, .btn-dark.focus {\n  box-shadow: 0 0 0 0.2rem rgba(82, 88, 93, 0.5);\n}\n\n.btn-dark.disabled, .btn-dark:disabled {\n  color: #fff;\n  background-color: #343a40;\n  border-color: #343a40;\n}\n\n.btn-dark:not(:disabled):not(.disabled):active, .btn-dark:not(:disabled):not(.disabled).active,\n.show > .btn-dark.dropdown-toggle {\n  color: #fff;\n  background-color: #1d2124;\n  border-color: #171a1d;\n}\n\n.btn-dark:not(:disabled):not(.disabled):active:focus, .btn-dark:not(:disabled):not(.disabled).active:focus,\n.show > .btn-dark.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(82, 88, 93, 0.5);\n}\n\n.btn-outline-primary {\n  color: #007bff;\n  border-color: #007bff;\n}\n\n.btn-outline-primary:hover {\n  color: #fff;\n  background-color: #007bff;\n  border-color: #007bff;\n}\n\n.btn-outline-primary:focus, .btn-outline-primary.focus {\n  box-shadow: 0 0 0 0.2rem rgba(0, 123, 255, 0.5);\n}\n\n.btn-outline-primary.disabled, .btn-outline-primary:disabled {\n  color: #007bff;\n  background-color: transparent;\n}\n\n.btn-outline-primary:not(:disabled):not(.disabled):active, .btn-outline-primary:not(:disabled):not(.disabled).active,\n.show > .btn-outline-primary.dropdown-toggle {\n  color: #fff;\n  background-color: #007bff;\n  border-color: #007bff;\n}\n\n.btn-outline-primary:not(:disabled):not(.disabled):active:focus, .btn-outline-primary:not(:disabled):not(.disabled).active:focus,\n.show > .btn-outline-primary.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(0, 123, 255, 0.5);\n}\n\n.btn-outline-secondary {\n  color: #6c757d;\n  border-color: #6c757d;\n}\n\n.btn-outline-secondary:hover {\n  color: #fff;\n  background-color: #6c757d;\n  border-color: #6c757d;\n}\n\n.btn-outline-secondary:focus, .btn-outline-secondary.focus {\n  box-shadow: 0 0 0 0.2rem rgba(108, 117, 125, 0.5);\n}\n\n.btn-outline-secondary.disabled, .btn-outline-secondary:disabled {\n  color: #6c757d;\n  background-color: transparent;\n}\n\n.btn-outline-secondary:not(:disabled):not(.disabled):active, .btn-outline-secondary:not(:disabled):not(.disabled).active,\n.show > .btn-outline-secondary.dropdown-toggle {\n  color: #fff;\n  background-color: #6c757d;\n  border-color: #6c757d;\n}\n\n.btn-outline-secondary:not(:disabled):not(.disabled):active:focus, .btn-outline-secondary:not(:disabled):not(.disabled).active:focus,\n.show > .btn-outline-secondary.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(108, 117, 125, 0.5);\n}\n\n.btn-outline-success {\n  color: #28a745;\n  border-color: #28a745;\n}\n\n.btn-outline-success:hover {\n  color: #fff;\n  background-color: #28a745;\n  border-color: #28a745;\n}\n\n.btn-outline-success:focus, .btn-outline-success.focus {\n  box-shadow: 0 0 0 0.2rem rgba(40, 167, 69, 0.5);\n}\n\n.btn-outline-success.disabled, .btn-outline-success:disabled {\n  color: #28a745;\n  background-color: transparent;\n}\n\n.btn-outline-success:not(:disabled):not(.disabled):active, .btn-outline-success:not(:disabled):not(.disabled).active,\n.show > .btn-outline-success.dropdown-toggle {\n  color: #fff;\n  background-color: #28a745;\n  border-color: #28a745;\n}\n\n.btn-outline-success:not(:disabled):not(.disabled):active:focus, .btn-outline-success:not(:disabled):not(.disabled).active:focus,\n.show > .btn-outline-success.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(40, 167, 69, 0.5);\n}\n\n.btn-outline-info {\n  color: #17a2b8;\n  border-color: #17a2b8;\n}\n\n.btn-outline-info:hover {\n  color: #fff;\n  background-color: #17a2b8;\n  border-color: #17a2b8;\n}\n\n.btn-outline-info:focus, .btn-outline-info.focus {\n  box-shadow: 0 0 0 0.2rem rgba(23, 162, 184, 0.5);\n}\n\n.btn-outline-info.disabled, .btn-outline-info:disabled {\n  color: #17a2b8;\n  background-color: transparent;\n}\n\n.btn-outline-info:not(:disabled):not(.disabled):active, .btn-outline-info:not(:disabled):not(.disabled).active,\n.show > .btn-outline-info.dropdown-toggle {\n  color: #fff;\n  background-color: #17a2b8;\n  border-color: #17a2b8;\n}\n\n.btn-outline-info:not(:disabled):not(.disabled):active:focus, .btn-outline-info:not(:disabled):not(.disabled).active:focus,\n.show > .btn-outline-info.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(23, 162, 184, 0.5);\n}\n\n.btn-outline-warning {\n  color: #ffc107;\n  border-color: #ffc107;\n}\n\n.btn-outline-warning:hover {\n  color: #212529;\n  background-color: #ffc107;\n  border-color: #ffc107;\n}\n\n.btn-outline-warning:focus, .btn-outline-warning.focus {\n  box-shadow: 0 0 0 0.2rem rgba(255, 193, 7, 0.5);\n}\n\n.btn-outline-warning.disabled, .btn-outline-warning:disabled {\n  color: #ffc107;\n  background-color: transparent;\n}\n\n.btn-outline-warning:not(:disabled):not(.disabled):active, .btn-outline-warning:not(:disabled):not(.disabled).active,\n.show > .btn-outline-warning.dropdown-toggle {\n  color: #212529;\n  background-color: #ffc107;\n  border-color: #ffc107;\n}\n\n.btn-outline-warning:not(:disabled):not(.disabled):active:focus, .btn-outline-warning:not(:disabled):not(.disabled).active:focus,\n.show > .btn-outline-warning.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(255, 193, 7, 0.5);\n}\n\n.btn-outline-danger {\n  color: #dc3545;\n  border-color: #dc3545;\n}\n\n.btn-outline-danger:hover {\n  color: #fff;\n  background-color: #dc3545;\n  border-color: #dc3545;\n}\n\n.btn-outline-danger:focus, .btn-outline-danger.focus {\n  box-shadow: 0 0 0 0.2rem rgba(220, 53, 69, 0.5);\n}\n\n.btn-outline-danger.disabled, .btn-outline-danger:disabled {\n  color: #dc3545;\n  background-color: transparent;\n}\n\n.btn-outline-danger:not(:disabled):not(.disabled):active, .btn-outline-danger:not(:disabled):not(.disabled).active,\n.show > .btn-outline-danger.dropdown-toggle {\n  color: #fff;\n  background-color: #dc3545;\n  border-color: #dc3545;\n}\n\n.btn-outline-danger:not(:disabled):not(.disabled):active:focus, .btn-outline-danger:not(:disabled):not(.disabled).active:focus,\n.show > .btn-outline-danger.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(220, 53, 69, 0.5);\n}\n\n.btn-outline-light {\n  color: #f8f9fa;\n  border-color: #f8f9fa;\n}\n\n.btn-outline-light:hover {\n  color: #212529;\n  background-color: #f8f9fa;\n  border-color: #f8f9fa;\n}\n\n.btn-outline-light:focus, .btn-outline-light.focus {\n  box-shadow: 0 0 0 0.2rem rgba(248, 249, 250, 0.5);\n}\n\n.btn-outline-light.disabled, .btn-outline-light:disabled {\n  color: #f8f9fa;\n  background-color: transparent;\n}\n\n.btn-outline-light:not(:disabled):not(.disabled):active, .btn-outline-light:not(:disabled):not(.disabled).active,\n.show > .btn-outline-light.dropdown-toggle {\n  color: #212529;\n  background-color: #f8f9fa;\n  border-color: #f8f9fa;\n}\n\n.btn-outline-light:not(:disabled):not(.disabled):active:focus, .btn-outline-light:not(:disabled):not(.disabled).active:focus,\n.show > .btn-outline-light.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(248, 249, 250, 0.5);\n}\n\n.btn-outline-dark {\n  color: #343a40;\n  border-color: #343a40;\n}\n\n.btn-outline-dark:hover {\n  color: #fff;\n  background-color: #343a40;\n  border-color: #343a40;\n}\n\n.btn-outline-dark:focus, .btn-outline-dark.focus {\n  box-shadow: 0 0 0 0.2rem rgba(52, 58, 64, 0.5);\n}\n\n.btn-outline-dark.disabled, .btn-outline-dark:disabled {\n  color: #343a40;\n  background-color: transparent;\n}\n\n.btn-outline-dark:not(:disabled):not(.disabled):active, .btn-outline-dark:not(:disabled):not(.disabled).active,\n.show > .btn-outline-dark.dropdown-toggle {\n  color: #fff;\n  background-color: #343a40;\n  border-color: #343a40;\n}\n\n.btn-outline-dark:not(:disabled):not(.disabled):active:focus, .btn-outline-dark:not(:disabled):not(.disabled).active:focus,\n.show > .btn-outline-dark.dropdown-toggle:focus {\n  box-shadow: 0 0 0 0.2rem rgba(52, 58, 64, 0.5);\n}\n\n.btn-link {\n  font-weight: 400;\n  color: #007bff;\n  text-decoration: none;\n}\n\n.btn-link:hover {\n  color: #0056b3;\n  text-decoration: underline;\n}\n\n.btn-link:focus, .btn-link.focus {\n  text-decoration: underline;\n  box-shadow: none;\n}\n\n.btn-link:disabled, .btn-link.disabled {\n  color: #6c757d;\n  pointer-events: none;\n}\n\n.btn-lg, .btn-group-lg > .btn {\n  padding: 0.5rem 1rem;\n  font-size: 1.25rem;\n  line-height: 1.5;\n  border-radius: 0.3rem;\n}\n\n.btn-sm, .btn-group-sm > .btn {\n  padding: 0.25rem 0.5rem;\n  font-size: 0.875rem;\n  line-height: 1.5;\n  border-radius: 0.2rem;\n}\n\n.btn-block {\n  display: block;\n  width: 100%;\n}\n\n.btn-block + .btn-block {\n  margin-top: 0.5rem;\n}\n\ninput[type=\"submit\"].btn-block,\ninput[type=\"reset\"].btn-block,\ninput[type=\"button\"].btn-block {\n  width: 100%;\n}\n\n.fade {\n  transition: opacity 0.15s linear;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .fade {\n    transition: none;\n  }\n}\n\n.fade:not(.show) {\n  opacity: 0;\n}\n\n.collapse:not(.show) {\n  display: none;\n}\n\n.collapsing {\n  position: relative;\n  height: 0;\n  overflow: hidden;\n  transition: height 0.35s ease;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .collapsing {\n    transition: none;\n  }\n}\n\n.dropup,\n.dropright,\n.dropdown,\n.dropleft {\n  position: relative;\n}\n\n.dropdown-toggle {\n  white-space: nowrap;\n}\n\n.dropdown-toggle::after {\n  display: inline-block;\n  margin-left: 0.255em;\n  vertical-align: 0.255em;\n  content: \"\";\n  border-top: 0.3em solid;\n  border-right: 0.3em solid transparent;\n  border-bottom: 0;\n  border-left: 0.3em solid transparent;\n}\n\n.dropdown-toggle:empty::after {\n  margin-left: 0;\n}\n\n.dropdown-menu {\n  position: absolute;\n  top: 100%;\n  left: 0;\n  z-index: 1000;\n  display: none;\n  float: left;\n  min-width: 10rem;\n  padding: 0.5rem 0;\n  margin: 0.125rem 0 0;\n  font-size: 1rem;\n  color: #212529;\n  text-align: left;\n  list-style: none;\n  background-color: #fff;\n  background-clip: padding-box;\n  border: 1px solid rgba(0, 0, 0, 0.15);\n  border-radius: 0.25rem;\n}\n\n.dropdown-menu-left {\n  right: auto;\n  left: 0;\n}\n\n.dropdown-menu-right {\n  right: 0;\n  left: auto;\n}\n\n@media (min-width: 576px) {\n  .dropdown-menu-sm-left {\n    right: auto;\n    left: 0;\n  }\n  .dropdown-menu-sm-right {\n    right: 0;\n    left: auto;\n  }\n}\n\n@media (min-width: 768px) {\n  .dropdown-menu-md-left {\n    right: auto;\n    left: 0;\n  }\n  .dropdown-menu-md-right {\n    right: 0;\n    left: auto;\n  }\n}\n\n@media (min-width: 992px) {\n  .dropdown-menu-lg-left {\n    right: auto;\n    left: 0;\n  }\n  .dropdown-menu-lg-right {\n    right: 0;\n    left: auto;\n  }\n}\n\n@media (min-width: 1200px) {\n  .dropdown-menu-xl-left {\n    right: auto;\n    left: 0;\n  }\n  .dropdown-menu-xl-right {\n    right: 0;\n    left: auto;\n  }\n}\n\n.dropup .dropdown-menu {\n  top: auto;\n  bottom: 100%;\n  margin-top: 0;\n  margin-bottom: 0.125rem;\n}\n\n.dropup .dropdown-toggle::after {\n  display: inline-block;\n  margin-left: 0.255em;\n  vertical-align: 0.255em;\n  content: \"\";\n  border-top: 0;\n  border-right: 0.3em solid transparent;\n  border-bottom: 0.3em solid;\n  border-left: 0.3em solid transparent;\n}\n\n.dropup .dropdown-toggle:empty::after {\n  margin-left: 0;\n}\n\n.dropright .dropdown-menu {\n  top: 0;\n  right: auto;\n  left: 100%;\n  margin-top: 0;\n  margin-left: 0.125rem;\n}\n\n.dropright .dropdown-toggle::after {\n  display: inline-block;\n  margin-left: 0.255em;\n  vertical-align: 0.255em;\n  content: \"\";\n  border-top: 0.3em solid transparent;\n  border-right: 0;\n  border-bottom: 0.3em solid transparent;\n  border-left: 0.3em solid;\n}\n\n.dropright .dropdown-toggle:empty::after {\n  margin-left: 0;\n}\n\n.dropright .dropdown-toggle::after {\n  vertical-align: 0;\n}\n\n.dropleft .dropdown-menu {\n  top: 0;\n  right: 100%;\n  left: auto;\n  margin-top: 0;\n  margin-right: 0.125rem;\n}\n\n.dropleft .dropdown-toggle::after {\n  display: inline-block;\n  margin-left: 0.255em;\n  vertical-align: 0.255em;\n  content: \"\";\n}\n\n.dropleft .dropdown-toggle::after {\n  display: none;\n}\n\n.dropleft .dropdown-toggle::before {\n  display: inline-block;\n  margin-right: 0.255em;\n  vertical-align: 0.255em;\n  content: \"\";\n  border-top: 0.3em solid transparent;\n  border-right: 0.3em solid;\n  border-bottom: 0.3em solid transparent;\n}\n\n.dropleft .dropdown-toggle:empty::after {\n  margin-left: 0;\n}\n\n.dropleft .dropdown-toggle::before {\n  vertical-align: 0;\n}\n\n.dropdown-menu[x-placement^=\"top\"], .dropdown-menu[x-placement^=\"right\"], .dropdown-menu[x-placement^=\"bottom\"], .dropdown-menu[x-placement^=\"left\"] {\n  right: auto;\n  bottom: auto;\n}\n\n.dropdown-divider {\n  height: 0;\n  margin: 0.5rem 0;\n  overflow: hidden;\n  border-top: 1px solid #e9ecef;\n}\n\n.dropdown-item {\n  display: block;\n  width: 100%;\n  padding: 0.25rem 1.5rem;\n  clear: both;\n  font-weight: 400;\n  color: #212529;\n  text-align: inherit;\n  white-space: nowrap;\n  background-color: transparent;\n  border: 0;\n}\n\n.dropdown-item:hover, .dropdown-item:focus {\n  color: #16181b;\n  text-decoration: none;\n  background-color: #f8f9fa;\n}\n\n.dropdown-item.active, .dropdown-item:active {\n  color: #fff;\n  text-decoration: none;\n  background-color: #007bff;\n}\n\n.dropdown-item.disabled, .dropdown-item:disabled {\n  color: #6c757d;\n  pointer-events: none;\n  background-color: transparent;\n}\n\n.dropdown-menu.show {\n  display: block;\n}\n\n.dropdown-header {\n  display: block;\n  padding: 0.5rem 1.5rem;\n  margin-bottom: 0;\n  font-size: 0.875rem;\n  color: #6c757d;\n  white-space: nowrap;\n}\n\n.dropdown-item-text {\n  display: block;\n  padding: 0.25rem 1.5rem;\n  color: #212529;\n}\n\n.btn-group,\n.btn-group-vertical {\n  position: relative;\n  display: inline-flex;\n  vertical-align: middle;\n}\n\n.btn-group > .btn,\n.btn-group-vertical > .btn {\n  position: relative;\n  flex: 1 1 auto;\n}\n\n.btn-group > .btn:hover,\n.btn-group-vertical > .btn:hover {\n  z-index: 1;\n}\n\n.btn-group > .btn:focus, .btn-group > .btn:active, .btn-group > .btn.active,\n.btn-group-vertical > .btn:focus,\n.btn-group-vertical > .btn:active,\n.btn-group-vertical > .btn.active {\n  z-index: 1;\n}\n\n.btn-toolbar {\n  display: flex;\n  flex-wrap: wrap;\n  justify-content: flex-start;\n}\n\n.btn-toolbar .input-group {\n  width: auto;\n}\n\n.btn-group > .btn:not(:first-child),\n.btn-group > .btn-group:not(:first-child) {\n  margin-left: -1px;\n}\n\n.btn-group > .btn:not(:last-child):not(.dropdown-toggle),\n.btn-group > .btn-group:not(:last-child) > .btn {\n  border-top-right-radius: 0;\n  border-bottom-right-radius: 0;\n}\n\n.btn-group > .btn:not(:first-child),\n.btn-group > .btn-group:not(:first-child) > .btn {\n  border-top-left-radius: 0;\n  border-bottom-left-radius: 0;\n}\n\n.dropdown-toggle-split {\n  padding-right: 0.5625rem;\n  padding-left: 0.5625rem;\n}\n\n.dropdown-toggle-split::after,\n.dropup .dropdown-toggle-split::after,\n.dropright .dropdown-toggle-split::after {\n  margin-left: 0;\n}\n\n.dropleft .dropdown-toggle-split::before {\n  margin-right: 0;\n}\n\n.btn-sm + .dropdown-toggle-split, .btn-group-sm > .btn + .dropdown-toggle-split {\n  padding-right: 0.375rem;\n  padding-left: 0.375rem;\n}\n\n.btn-lg + .dropdown-toggle-split, .btn-group-lg > .btn + .dropdown-toggle-split {\n  padding-right: 0.75rem;\n  padding-left: 0.75rem;\n}\n\n.btn-group-vertical {\n  flex-direction: column;\n  align-items: flex-start;\n  justify-content: center;\n}\n\n.btn-group-vertical > .btn,\n.btn-group-vertical > .btn-group {\n  width: 100%;\n}\n\n.btn-group-vertical > .btn:not(:first-child),\n.btn-group-vertical > .btn-group:not(:first-child) {\n  margin-top: -1px;\n}\n\n.btn-group-vertical > .btn:not(:last-child):not(.dropdown-toggle),\n.btn-group-vertical > .btn-group:not(:last-child) > .btn {\n  border-bottom-right-radius: 0;\n  border-bottom-left-radius: 0;\n}\n\n.btn-group-vertical > .btn:not(:first-child),\n.btn-group-vertical > .btn-group:not(:first-child) > .btn {\n  border-top-left-radius: 0;\n  border-top-right-radius: 0;\n}\n\n.btn-group-toggle > .btn,\n.btn-group-toggle > .btn-group > .btn {\n  margin-bottom: 0;\n}\n\n.btn-group-toggle > .btn input[type=\"radio\"],\n.btn-group-toggle > .btn input[type=\"checkbox\"],\n.btn-group-toggle > .btn-group > .btn input[type=\"radio\"],\n.btn-group-toggle > .btn-group > .btn input[type=\"checkbox\"] {\n  position: absolute;\n  clip: rect(0, 0, 0, 0);\n  pointer-events: none;\n}\n\n.input-group {\n  position: relative;\n  display: flex;\n  flex-wrap: wrap;\n  align-items: stretch;\n  width: 100%;\n}\n\n.input-group > .form-control,\n.input-group > .form-control-plaintext,\n.input-group > .custom-select,\n.input-group > .custom-file {\n  position: relative;\n  flex: 1 1 auto;\n  width: 1%;\n  margin-bottom: 0;\n}\n\n.input-group > .form-control + .form-control,\n.input-group > .form-control + .custom-select,\n.input-group > .form-control + .custom-file,\n.input-group > .form-control-plaintext + .form-control,\n.input-group > .form-control-plaintext + .custom-select,\n.input-group > .form-control-plaintext + .custom-file,\n.input-group > .custom-select + .form-control,\n.input-group > .custom-select + .custom-select,\n.input-group > .custom-select + .custom-file,\n.input-group > .custom-file + .form-control,\n.input-group > .custom-file + .custom-select,\n.input-group > .custom-file + .custom-file {\n  margin-left: -1px;\n}\n\n.input-group > .form-control:focus,\n.input-group > .custom-select:focus,\n.input-group > .custom-file .custom-file-input:focus ~ .custom-file-label {\n  z-index: 3;\n}\n\n.input-group > .custom-file .custom-file-input:focus {\n  z-index: 4;\n}\n\n.input-group > .form-control:not(:last-child),\n.input-group > .custom-select:not(:last-child) {\n  border-top-right-radius: 0;\n  border-bottom-right-radius: 0;\n}\n\n.input-group > .form-control:not(:first-child),\n.input-group > .custom-select:not(:first-child) {\n  border-top-left-radius: 0;\n  border-bottom-left-radius: 0;\n}\n\n.input-group > .custom-file {\n  display: flex;\n  align-items: center;\n}\n\n.input-group > .custom-file:not(:last-child) .custom-file-label,\n.input-group > .custom-file:not(:last-child) .custom-file-label::after {\n  border-top-right-radius: 0;\n  border-bottom-right-radius: 0;\n}\n\n.input-group > .custom-file:not(:first-child) .custom-file-label {\n  border-top-left-radius: 0;\n  border-bottom-left-radius: 0;\n}\n\n.input-group-prepend,\n.input-group-append {\n  display: flex;\n}\n\n.input-group-prepend .btn,\n.input-group-append .btn {\n  position: relative;\n  z-index: 2;\n}\n\n.input-group-prepend .btn:focus,\n.input-group-append .btn:focus {\n  z-index: 3;\n}\n\n.input-group-prepend .btn + .btn,\n.input-group-prepend .btn + .input-group-text,\n.input-group-prepend .input-group-text + .input-group-text,\n.input-group-prepend .input-group-text + .btn,\n.input-group-append .btn + .btn,\n.input-group-append .btn + .input-group-text,\n.input-group-append .input-group-text + .input-group-text,\n.input-group-append .input-group-text + .btn {\n  margin-left: -1px;\n}\n\n.input-group-prepend {\n  margin-right: -1px;\n}\n\n.input-group-append {\n  margin-left: -1px;\n}\n\n.input-group-text {\n  display: flex;\n  align-items: center;\n  padding: 0.375rem 0.75rem;\n  margin-bottom: 0;\n  font-size: 1rem;\n  font-weight: 400;\n  line-height: 1.5;\n  color: #495057;\n  text-align: center;\n  white-space: nowrap;\n  background-color: #e9ecef;\n  border: 1px solid #ced4da;\n  border-radius: 0.25rem;\n}\n\n.input-group-text input[type=\"radio\"],\n.input-group-text input[type=\"checkbox\"] {\n  margin-top: 0;\n}\n\n.input-group-lg > .form-control:not(textarea),\n.input-group-lg > .custom-select {\n  height: calc(1.5em + 1rem + 2px);\n}\n\n.input-group-lg > .form-control,\n.input-group-lg > .custom-select,\n.input-group-lg > .input-group-prepend > .input-group-text,\n.input-group-lg > .input-group-append > .input-group-text,\n.input-group-lg > .input-group-prepend > .btn,\n.input-group-lg > .input-group-append > .btn {\n  padding: 0.5rem 1rem;\n  font-size: 1.25rem;\n  line-height: 1.5;\n  border-radius: 0.3rem;\n}\n\n.input-group-sm > .form-control:not(textarea),\n.input-group-sm > .custom-select {\n  height: calc(1.5em + 0.5rem + 2px);\n}\n\n.input-group-sm > .form-control,\n.input-group-sm > .custom-select,\n.input-group-sm > .input-group-prepend > .input-group-text,\n.input-group-sm > .input-group-append > .input-group-text,\n.input-group-sm > .input-group-prepend > .btn,\n.input-group-sm > .input-group-append > .btn {\n  padding: 0.25rem 0.5rem;\n  font-size: 0.875rem;\n  line-height: 1.5;\n  border-radius: 0.2rem;\n}\n\n.input-group-lg > .custom-select,\n.input-group-sm > .custom-select {\n  padding-right: 1.75rem;\n}\n\n.input-group > .input-group-prepend > .btn,\n.input-group > .input-group-prepend > .input-group-text,\n.input-group > .input-group-append:not(:last-child) > .btn,\n.input-group > .input-group-append:not(:last-child) > .input-group-text,\n.input-group > .input-group-append:last-child > .btn:not(:last-child):not(.dropdown-toggle),\n.input-group > .input-group-append:last-child > .input-group-text:not(:last-child) {\n  border-top-right-radius: 0;\n  border-bottom-right-radius: 0;\n}\n\n.input-group > .input-group-append > .btn,\n.input-group > .input-group-append > .input-group-text,\n.input-group > .input-group-prepend:not(:first-child) > .btn,\n.input-group > .input-group-prepend:not(:first-child) > .input-group-text,\n.input-group > .input-group-prepend:first-child > .btn:not(:first-child),\n.input-group > .input-group-prepend:first-child > .input-group-text:not(:first-child) {\n  border-top-left-radius: 0;\n  border-bottom-left-radius: 0;\n}\n\n.custom-control {\n  position: relative;\n  display: block;\n  min-height: 1.5rem;\n  padding-left: 1.5rem;\n}\n\n.custom-control-inline {\n  display: inline-flex;\n  margin-right: 1rem;\n}\n\n.custom-control-input {\n  position: absolute;\n  z-index: -1;\n  opacity: 0;\n}\n\n.custom-control-input:checked ~ .custom-control-label::before {\n  color: #fff;\n  border-color: #007bff;\n  background-color: #007bff;\n}\n\n.custom-control-input:focus ~ .custom-control-label::before {\n  box-shadow: 0 0 0 0.2rem rgba(0, 123, 255, 0.25);\n}\n\n.custom-control-input:focus:not(:checked) ~ .custom-control-label::before {\n  border-color: #80bdff;\n}\n\n.custom-control-input:not(:disabled):active ~ .custom-control-label::before {\n  color: #fff;\n  background-color: #b3d7ff;\n  border-color: #b3d7ff;\n}\n\n.custom-control-input:disabled ~ .custom-control-label {\n  color: #6c757d;\n}\n\n.custom-control-input:disabled ~ .custom-control-label::before {\n  background-color: #e9ecef;\n}\n\n.custom-control-label {\n  position: relative;\n  margin-bottom: 0;\n  vertical-align: top;\n}\n\n.custom-control-label::before {\n  position: absolute;\n  top: 0.25rem;\n  left: -1.5rem;\n  display: block;\n  width: 1rem;\n  height: 1rem;\n  pointer-events: none;\n  content: \"\";\n  background-color: #fff;\n  border: #adb5bd solid 1px;\n}\n\n.custom-control-label::after {\n  position: absolute;\n  top: 0.25rem;\n  left: -1.5rem;\n  display: block;\n  width: 1rem;\n  height: 1rem;\n  content: \"\";\n  background: no-repeat 50% / 50% 50%;\n}\n\n.custom-checkbox .custom-control-label::before {\n  border-radius: 0.25rem;\n}\n\n.custom-checkbox .custom-control-input:checked ~ .custom-control-label::after {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 8 8'%3e%3cpath fill='%23fff' d='M6.564.75l-3.59 3.612-1.538-1.55L0 4.26 2.974 7.25 8 2.193z'/%3e%3c/svg%3e\");\n}\n\n.custom-checkbox .custom-control-input:indeterminate ~ .custom-control-label::before {\n  border-color: #007bff;\n  background-color: #007bff;\n}\n\n.custom-checkbox .custom-control-input:indeterminate ~ .custom-control-label::after {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 4 4'%3e%3cpath stroke='%23fff' d='M0 2h4'/%3e%3c/svg%3e\");\n}\n\n.custom-checkbox .custom-control-input:disabled:checked ~ .custom-control-label::before {\n  background-color: rgba(0, 123, 255, 0.5);\n}\n\n.custom-checkbox .custom-control-input:disabled:indeterminate ~ .custom-control-label::before {\n  background-color: rgba(0, 123, 255, 0.5);\n}\n\n.custom-radio .custom-control-label::before {\n  border-radius: 50%;\n}\n\n.custom-radio .custom-control-input:checked ~ .custom-control-label::after {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='-4 -4 8 8'%3e%3ccircle r='3' fill='%23fff'/%3e%3c/svg%3e\");\n}\n\n.custom-radio .custom-control-input:disabled:checked ~ .custom-control-label::before {\n  background-color: rgba(0, 123, 255, 0.5);\n}\n\n.custom-switch {\n  padding-left: 2.25rem;\n}\n\n.custom-switch .custom-control-label::before {\n  left: -2.25rem;\n  width: 1.75rem;\n  pointer-events: all;\n  border-radius: 0.5rem;\n}\n\n.custom-switch .custom-control-label::after {\n  top: calc(0.25rem + 2px);\n  left: calc(-2.25rem + 2px);\n  width: calc(1rem - 4px);\n  height: calc(1rem - 4px);\n  background-color: #adb5bd;\n  border-radius: 0.5rem;\n  transition: transform 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .custom-switch .custom-control-label::after {\n    transition: none;\n  }\n}\n\n.custom-switch .custom-control-input:checked ~ .custom-control-label::after {\n  background-color: #fff;\n  transform: translateX(0.75rem);\n}\n\n.custom-switch .custom-control-input:disabled:checked ~ .custom-control-label::before {\n  background-color: rgba(0, 123, 255, 0.5);\n}\n\n.custom-select {\n  display: inline-block;\n  width: 100%;\n  height: calc(1.5em + 0.75rem + 2px);\n  padding: 0.375rem 1.75rem 0.375rem 0.75rem;\n  font-size: 1rem;\n  font-weight: 400;\n  line-height: 1.5;\n  color: #495057;\n  vertical-align: middle;\n  background: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 4 5'%3e%3cpath fill='%23343a40' d='M2 0L0 2h4zm0 5L0 3h4z'/%3e%3c/svg%3e\") no-repeat right 0.75rem center/8px 10px;\n  background-color: #fff;\n  border: 1px solid #ced4da;\n  border-radius: 0.25rem;\n  appearance: none;\n}\n\n.custom-select:focus {\n  border-color: #80bdff;\n  outline: 0;\n  box-shadow: 0 0 0 0.2rem rgba(0, 123, 255, 0.25);\n}\n\n.custom-select:focus::-ms-value {\n  color: #495057;\n  background-color: #fff;\n}\n\n.custom-select[multiple], .custom-select[size]:not([size=\"1\"]) {\n  height: auto;\n  padding-right: 0.75rem;\n  background-image: none;\n}\n\n.custom-select:disabled {\n  color: #6c757d;\n  background-color: #e9ecef;\n}\n\n.custom-select::-ms-expand {\n  display: none;\n}\n\n.custom-select-sm {\n  height: calc(1.5em + 0.5rem + 2px);\n  padding-top: 0.25rem;\n  padding-bottom: 0.25rem;\n  padding-left: 0.5rem;\n  font-size: 0.875rem;\n}\n\n.custom-select-lg {\n  height: calc(1.5em + 1rem + 2px);\n  padding-top: 0.5rem;\n  padding-bottom: 0.5rem;\n  padding-left: 1rem;\n  font-size: 1.25rem;\n}\n\n.custom-file {\n  position: relative;\n  display: inline-block;\n  width: 100%;\n  height: calc(1.5em + 0.75rem + 2px);\n  margin-bottom: 0;\n}\n\n.custom-file-input {\n  position: relative;\n  z-index: 2;\n  width: 100%;\n  height: calc(1.5em + 0.75rem + 2px);\n  margin: 0;\n  opacity: 0;\n}\n\n.custom-file-input:focus ~ .custom-file-label {\n  border-color: #80bdff;\n  box-shadow: 0 0 0 0.2rem rgba(0, 123, 255, 0.25);\n}\n\n.custom-file-input:disabled ~ .custom-file-label {\n  background-color: #e9ecef;\n}\n\n.custom-file-input:lang(en) ~ .custom-file-label::after {\n  content: \"Browse\";\n}\n\n.custom-file-input ~ .custom-file-label[data-browse]::after {\n  content: attr(data-browse);\n}\n\n.custom-file-label {\n  position: absolute;\n  top: 0;\n  right: 0;\n  left: 0;\n  z-index: 1;\n  height: calc(1.5em + 0.75rem + 2px);\n  padding: 0.375rem 0.75rem;\n  font-weight: 400;\n  line-height: 1.5;\n  color: #495057;\n  background-color: #fff;\n  border: 1px solid #ced4da;\n  border-radius: 0.25rem;\n}\n\n.custom-file-label::after {\n  position: absolute;\n  top: 0;\n  right: 0;\n  bottom: 0;\n  z-index: 3;\n  display: block;\n  height: calc(1.5em + 0.75rem);\n  padding: 0.375rem 0.75rem;\n  line-height: 1.5;\n  color: #495057;\n  content: \"Browse\";\n  background-color: #e9ecef;\n  border-left: inherit;\n  border-radius: 0 0.25rem 0.25rem 0;\n}\n\n.custom-range {\n  width: 100%;\n  height: calc(1rem + 0.4rem);\n  padding: 0;\n  background-color: transparent;\n  appearance: none;\n}\n\n.custom-range:focus {\n  outline: none;\n}\n\n.custom-range:focus::-webkit-slider-thumb {\n  box-shadow: 0 0 0 1px #fff, 0 0 0 0.2rem rgba(0, 123, 255, 0.25);\n}\n\n.custom-range:focus::-moz-range-thumb {\n  box-shadow: 0 0 0 1px #fff, 0 0 0 0.2rem rgba(0, 123, 255, 0.25);\n}\n\n.custom-range:focus::-ms-thumb {\n  box-shadow: 0 0 0 1px #fff, 0 0 0 0.2rem rgba(0, 123, 255, 0.25);\n}\n\n.custom-range::-moz-focus-outer {\n  border: 0;\n}\n\n.custom-range::-webkit-slider-thumb {\n  width: 1rem;\n  height: 1rem;\n  margin-top: -0.25rem;\n  background-color: #007bff;\n  border: 0;\n  border-radius: 1rem;\n  transition: background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n  appearance: none;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .custom-range::-webkit-slider-thumb {\n    transition: none;\n  }\n}\n\n.custom-range::-webkit-slider-thumb:active {\n  background-color: #b3d7ff;\n}\n\n.custom-range::-webkit-slider-runnable-track {\n  width: 100%;\n  height: 0.5rem;\n  color: transparent;\n  cursor: pointer;\n  background-color: #dee2e6;\n  border-color: transparent;\n  border-radius: 1rem;\n}\n\n.custom-range::-moz-range-thumb {\n  width: 1rem;\n  height: 1rem;\n  background-color: #007bff;\n  border: 0;\n  border-radius: 1rem;\n  transition: background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n  appearance: none;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .custom-range::-moz-range-thumb {\n    transition: none;\n  }\n}\n\n.custom-range::-moz-range-thumb:active {\n  background-color: #b3d7ff;\n}\n\n.custom-range::-moz-range-track {\n  width: 100%;\n  height: 0.5rem;\n  color: transparent;\n  cursor: pointer;\n  background-color: #dee2e6;\n  border-color: transparent;\n  border-radius: 1rem;\n}\n\n.custom-range::-ms-thumb {\n  width: 1rem;\n  height: 1rem;\n  margin-top: 0;\n  margin-right: 0.2rem;\n  margin-left: 0.2rem;\n  background-color: #007bff;\n  border: 0;\n  border-radius: 1rem;\n  transition: background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n  appearance: none;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .custom-range::-ms-thumb {\n    transition: none;\n  }\n}\n\n.custom-range::-ms-thumb:active {\n  background-color: #b3d7ff;\n}\n\n.custom-range::-ms-track {\n  width: 100%;\n  height: 0.5rem;\n  color: transparent;\n  cursor: pointer;\n  background-color: transparent;\n  border-color: transparent;\n  border-width: 0.5rem;\n}\n\n.custom-range::-ms-fill-lower {\n  background-color: #dee2e6;\n  border-radius: 1rem;\n}\n\n.custom-range::-ms-fill-upper {\n  margin-right: 15px;\n  background-color: #dee2e6;\n  border-radius: 1rem;\n}\n\n.custom-range:disabled::-webkit-slider-thumb {\n  background-color: #adb5bd;\n}\n\n.custom-range:disabled::-webkit-slider-runnable-track {\n  cursor: default;\n}\n\n.custom-range:disabled::-moz-range-thumb {\n  background-color: #adb5bd;\n}\n\n.custom-range:disabled::-moz-range-track {\n  cursor: default;\n}\n\n.custom-range:disabled::-ms-thumb {\n  background-color: #adb5bd;\n}\n\n.custom-control-label::before,\n.custom-file-label,\n.custom-select {\n  transition: background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .custom-control-label::before,\n  .custom-file-label,\n  .custom-select {\n    transition: none;\n  }\n}\n\n.nav {\n  display: flex;\n  flex-wrap: wrap;\n  padding-left: 0;\n  margin-bottom: 0;\n  list-style: none;\n}\n\n.nav-link {\n  display: block;\n  padding: 0.5rem 1rem;\n}\n\n.nav-link:hover, .nav-link:focus {\n  text-decoration: none;\n}\n\n.nav-link.disabled {\n  color: #6c757d;\n  pointer-events: none;\n  cursor: default;\n}\n\n.nav-tabs {\n  border-bottom: 1px solid #dee2e6;\n}\n\n.nav-tabs .nav-item {\n  margin-bottom: -1px;\n}\n\n.nav-tabs .nav-link {\n  border: 1px solid transparent;\n  border-top-left-radius: 0.25rem;\n  border-top-right-radius: 0.25rem;\n}\n\n.nav-tabs .nav-link:hover, .nav-tabs .nav-link:focus {\n  border-color: #e9ecef #e9ecef #dee2e6;\n}\n\n.nav-tabs .nav-link.disabled {\n  color: #6c757d;\n  background-color: transparent;\n  border-color: transparent;\n}\n\n.nav-tabs .nav-link.active,\n.nav-tabs .nav-item.show .nav-link {\n  color: #495057;\n  background-color: #fff;\n  border-color: #dee2e6 #dee2e6 #fff;\n}\n\n.nav-tabs .dropdown-menu {\n  margin-top: -1px;\n  border-top-left-radius: 0;\n  border-top-right-radius: 0;\n}\n\n.nav-pills .nav-link {\n  border-radius: 0.25rem;\n}\n\n.nav-pills .nav-link.active,\n.nav-pills .show > .nav-link {\n  color: #fff;\n  background-color: #007bff;\n}\n\n.nav-fill .nav-item {\n  flex: 1 1 auto;\n  text-align: center;\n}\n\n.nav-justified .nav-item {\n  flex-basis: 0;\n  flex-grow: 1;\n  text-align: center;\n}\n\n.tab-content > .tab-pane {\n  display: none;\n}\n\n.tab-content > .active {\n  display: block;\n}\n\n.navbar {\n  position: relative;\n  display: flex;\n  flex-wrap: wrap;\n  align-items: center;\n  justify-content: space-between;\n  padding: 0.5rem 1rem;\n}\n\n.navbar > .container,\n.navbar > .container-fluid {\n  display: flex;\n  flex-wrap: wrap;\n  align-items: center;\n  justify-content: space-between;\n}\n\n.navbar-brand {\n  display: inline-block;\n  padding-top: 0.3125rem;\n  padding-bottom: 0.3125rem;\n  margin-right: 1rem;\n  font-size: 1.25rem;\n  line-height: inherit;\n  white-space: nowrap;\n}\n\n.navbar-brand:hover, .navbar-brand:focus {\n  text-decoration: none;\n}\n\n.navbar-nav {\n  display: flex;\n  flex-direction: column;\n  padding-left: 0;\n  margin-bottom: 0;\n  list-style: none;\n}\n\n.navbar-nav .nav-link {\n  padding-right: 0;\n  padding-left: 0;\n}\n\n.navbar-nav .dropdown-menu {\n  position: static;\n  float: none;\n}\n\n.navbar-text {\n  display: inline-block;\n  padding-top: 0.5rem;\n  padding-bottom: 0.5rem;\n}\n\n.navbar-collapse {\n  flex-basis: 100%;\n  flex-grow: 1;\n  align-items: center;\n}\n\n.navbar-toggler {\n  padding: 0.25rem 0.75rem;\n  font-size: 1.25rem;\n  line-height: 1;\n  background-color: transparent;\n  border: 1px solid transparent;\n  border-radius: 0.25rem;\n}\n\n.navbar-toggler:hover, .navbar-toggler:focus {\n  text-decoration: none;\n}\n\n.navbar-toggler-icon {\n  display: inline-block;\n  width: 1.5em;\n  height: 1.5em;\n  vertical-align: middle;\n  content: \"\";\n  background: no-repeat center center;\n  background-size: 100% 100%;\n}\n\n@media (max-width: 575.98px) {\n  .navbar-expand-sm > .container,\n  .navbar-expand-sm > .container-fluid {\n    padding-right: 0;\n    padding-left: 0;\n  }\n}\n\n@media (min-width: 576px) {\n  .navbar-expand-sm {\n    flex-flow: row nowrap;\n    justify-content: flex-start;\n  }\n  .navbar-expand-sm .navbar-nav {\n    flex-direction: row;\n  }\n  .navbar-expand-sm .navbar-nav .dropdown-menu {\n    position: absolute;\n  }\n  .navbar-expand-sm .navbar-nav .nav-link {\n    padding-right: 0.5rem;\n    padding-left: 0.5rem;\n  }\n  .navbar-expand-sm > .container,\n  .navbar-expand-sm > .container-fluid {\n    flex-wrap: nowrap;\n  }\n  .navbar-expand-sm .navbar-collapse {\n    display: flex !important;\n    flex-basis: auto;\n  }\n  .navbar-expand-sm .navbar-toggler {\n    display: none;\n  }\n}\n\n@media (max-width: 767.98px) {\n  .navbar-expand-md > .container,\n  .navbar-expand-md > .container-fluid {\n    padding-right: 0;\n    padding-left: 0;\n  }\n}\n\n@media (min-width: 768px) {\n  .navbar-expand-md {\n    flex-flow: row nowrap;\n    justify-content: flex-start;\n  }\n  .navbar-expand-md .navbar-nav {\n    flex-direction: row;\n  }\n  .navbar-expand-md .navbar-nav .dropdown-menu {\n    position: absolute;\n  }\n  .navbar-expand-md .navbar-nav .nav-link {\n    padding-right: 0.5rem;\n    padding-left: 0.5rem;\n  }\n  .navbar-expand-md > .container,\n  .navbar-expand-md > .container-fluid {\n    flex-wrap: nowrap;\n  }\n  .navbar-expand-md .navbar-collapse {\n    display: flex !important;\n    flex-basis: auto;\n  }\n  .navbar-expand-md .navbar-toggler {\n    display: none;\n  }\n}\n\n@media (max-width: 991.98px) {\n  .navbar-expand-lg > .container,\n  .navbar-expand-lg > .container-fluid {\n    padding-right: 0;\n    padding-left: 0;\n  }\n}\n\n@media (min-width: 992px) {\n  .navbar-expand-lg {\n    flex-flow: row nowrap;\n    justify-content: flex-start;\n  }\n  .navbar-expand-lg .navbar-nav {\n    flex-direction: row;\n  }\n  .navbar-expand-lg .navbar-nav .dropdown-menu {\n    position: absolute;\n  }\n  .navbar-expand-lg .navbar-nav .nav-link {\n    padding-right: 0.5rem;\n    padding-left: 0.5rem;\n  }\n  .navbar-expand-lg > .container,\n  .navbar-expand-lg > .container-fluid {\n    flex-wrap: nowrap;\n  }\n  .navbar-expand-lg .navbar-collapse {\n    display: flex !important;\n    flex-basis: auto;\n  }\n  .navbar-expand-lg .navbar-toggler {\n    display: none;\n  }\n}\n\n@media (max-width: 1199.98px) {\n  .navbar-expand-xl > .container,\n  .navbar-expand-xl > .container-fluid {\n    padding-right: 0;\n    padding-left: 0;\n  }\n}\n\n@media (min-width: 1200px) {\n  .navbar-expand-xl {\n    flex-flow: row nowrap;\n    justify-content: flex-start;\n  }\n  .navbar-expand-xl .navbar-nav {\n    flex-direction: row;\n  }\n  .navbar-expand-xl .navbar-nav .dropdown-menu {\n    position: absolute;\n  }\n  .navbar-expand-xl .navbar-nav .nav-link {\n    padding-right: 0.5rem;\n    padding-left: 0.5rem;\n  }\n  .navbar-expand-xl > .container,\n  .navbar-expand-xl > .container-fluid {\n    flex-wrap: nowrap;\n  }\n  .navbar-expand-xl .navbar-collapse {\n    display: flex !important;\n    flex-basis: auto;\n  }\n  .navbar-expand-xl .navbar-toggler {\n    display: none;\n  }\n}\n\n.navbar-expand {\n  flex-flow: row nowrap;\n  justify-content: flex-start;\n}\n\n.navbar-expand > .container,\n.navbar-expand > .container-fluid {\n  padding-right: 0;\n  padding-left: 0;\n}\n\n.navbar-expand .navbar-nav {\n  flex-direction: row;\n}\n\n.navbar-expand .navbar-nav .dropdown-menu {\n  position: absolute;\n}\n\n.navbar-expand .navbar-nav .nav-link {\n  padding-right: 0.5rem;\n  padding-left: 0.5rem;\n}\n\n.navbar-expand > .container,\n.navbar-expand > .container-fluid {\n  flex-wrap: nowrap;\n}\n\n.navbar-expand .navbar-collapse {\n  display: flex !important;\n  flex-basis: auto;\n}\n\n.navbar-expand .navbar-toggler {\n  display: none;\n}\n\n.navbar-light .navbar-brand {\n  color: rgba(0, 0, 0, 0.9);\n}\n\n.navbar-light .navbar-brand:hover, .navbar-light .navbar-brand:focus {\n  color: rgba(0, 0, 0, 0.9);\n}\n\n.navbar-light .navbar-nav .nav-link {\n  color: rgba(0, 0, 0, 0.5);\n}\n\n.navbar-light .navbar-nav .nav-link:hover, .navbar-light .navbar-nav .nav-link:focus {\n  color: rgba(0, 0, 0, 0.7);\n}\n\n.navbar-light .navbar-nav .nav-link.disabled {\n  color: rgba(0, 0, 0, 0.3);\n}\n\n.navbar-light .navbar-nav .show > .nav-link,\n.navbar-light .navbar-nav .active > .nav-link,\n.navbar-light .navbar-nav .nav-link.show,\n.navbar-light .navbar-nav .nav-link.active {\n  color: rgba(0, 0, 0, 0.9);\n}\n\n.navbar-light .navbar-toggler {\n  color: rgba(0, 0, 0, 0.5);\n  border-color: rgba(0, 0, 0, 0.1);\n}\n\n.navbar-light .navbar-toggler-icon {\n  background-image: url(\"data:image/svg+xml,%3csvg viewBox='0 0 30 30' xmlns='http://www.w3.org/2000/svg'%3e%3cpath stroke='rgba(0, 0, 0, 0.5)' stroke-width='2' stroke-linecap='round' stroke-miterlimit='10' d='M4 7h22M4 15h22M4 23h22'/%3e%3c/svg%3e\");\n}\n\n.navbar-light .navbar-text {\n  color: rgba(0, 0, 0, 0.5);\n}\n\n.navbar-light .navbar-text a {\n  color: rgba(0, 0, 0, 0.9);\n}\n\n.navbar-light .navbar-text a:hover, .navbar-light .navbar-text a:focus {\n  color: rgba(0, 0, 0, 0.9);\n}\n\n.navbar-dark .navbar-brand {\n  color: #fff;\n}\n\n.navbar-dark .navbar-brand:hover, .navbar-dark .navbar-brand:focus {\n  color: #fff;\n}\n\n.navbar-dark .navbar-nav .nav-link {\n  color: rgba(255, 255, 255, 0.5);\n}\n\n.navbar-dark .navbar-nav .nav-link:hover, .navbar-dark .navbar-nav .nav-link:focus {\n  color: rgba(255, 255, 255, 0.75);\n}\n\n.navbar-dark .navbar-nav .nav-link.disabled {\n  color: rgba(255, 255, 255, 0.25);\n}\n\n.navbar-dark .navbar-nav .show > .nav-link,\n.navbar-dark .navbar-nav .active > .nav-link,\n.navbar-dark .navbar-nav .nav-link.show,\n.navbar-dark .navbar-nav .nav-link.active {\n  color: #fff;\n}\n\n.navbar-dark .navbar-toggler {\n  color: rgba(255, 255, 255, 0.5);\n  border-color: rgba(255, 255, 255, 0.1);\n}\n\n.navbar-dark .navbar-toggler-icon {\n  background-image: url(\"data:image/svg+xml,%3csvg viewBox='0 0 30 30' xmlns='http://www.w3.org/2000/svg'%3e%3cpath stroke='rgba(255, 255, 255, 0.5)' stroke-width='2' stroke-linecap='round' stroke-miterlimit='10' d='M4 7h22M4 15h22M4 23h22'/%3e%3c/svg%3e\");\n}\n\n.navbar-dark .navbar-text {\n  color: rgba(255, 255, 255, 0.5);\n}\n\n.navbar-dark .navbar-text a {\n  color: #fff;\n}\n\n.navbar-dark .navbar-text a:hover, .navbar-dark .navbar-text a:focus {\n  color: #fff;\n}\n\n.card {\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  min-width: 0;\n  word-wrap: break-word;\n  background-color: #fff;\n  background-clip: border-box;\n  border: 1px solid rgba(0, 0, 0, 0.125);\n  border-radius: 0.25rem;\n}\n\n.card > hr {\n  margin-right: 0;\n  margin-left: 0;\n}\n\n.card > .list-group:first-child .list-group-item:first-child {\n  border-top-left-radius: 0.25rem;\n  border-top-right-radius: 0.25rem;\n}\n\n.card > .list-group:last-child .list-group-item:last-child {\n  border-bottom-right-radius: 0.25rem;\n  border-bottom-left-radius: 0.25rem;\n}\n\n.card-body {\n  flex: 1 1 auto;\n  padding: 1.25rem;\n}\n\n.card-title {\n  margin-bottom: 0.75rem;\n}\n\n.card-subtitle {\n  margin-top: -0.375rem;\n  margin-bottom: 0;\n}\n\n.card-text:last-child {\n  margin-bottom: 0;\n}\n\n.card-link:hover {\n  text-decoration: none;\n}\n\n.card-link + .card-link {\n  margin-left: 1.25rem;\n}\n\n.card-header {\n  padding: 0.75rem 1.25rem;\n  margin-bottom: 0;\n  background-color: rgba(0, 0, 0, 0.03);\n  border-bottom: 1px solid rgba(0, 0, 0, 0.125);\n}\n\n.card-header:first-child {\n  border-radius: calc(0.25rem - 1px) calc(0.25rem - 1px) 0 0;\n}\n\n.card-header + .list-group .list-group-item:first-child {\n  border-top: 0;\n}\n\n.card-footer {\n  padding: 0.75rem 1.25rem;\n  background-color: rgba(0, 0, 0, 0.03);\n  border-top: 1px solid rgba(0, 0, 0, 0.125);\n}\n\n.card-footer:last-child {\n  border-radius: 0 0 calc(0.25rem - 1px) calc(0.25rem - 1px);\n}\n\n.card-header-tabs {\n  margin-right: -0.625rem;\n  margin-bottom: -0.75rem;\n  margin-left: -0.625rem;\n  border-bottom: 0;\n}\n\n.card-header-pills {\n  margin-right: -0.625rem;\n  margin-left: -0.625rem;\n}\n\n.card-img-overlay {\n  position: absolute;\n  top: 0;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  padding: 1.25rem;\n}\n\n.card-img {\n  width: 100%;\n  border-radius: calc(0.25rem - 1px);\n}\n\n.card-img-top {\n  width: 100%;\n  border-top-left-radius: calc(0.25rem - 1px);\n  border-top-right-radius: calc(0.25rem - 1px);\n}\n\n.card-img-bottom {\n  width: 100%;\n  border-bottom-right-radius: calc(0.25rem - 1px);\n  border-bottom-left-radius: calc(0.25rem - 1px);\n}\n\n.card-deck {\n  display: flex;\n  flex-direction: column;\n}\n\n.card-deck .card {\n  margin-bottom: 15px;\n}\n\n@media (min-width: 576px) {\n  .card-deck {\n    flex-flow: row wrap;\n    margin-right: -15px;\n    margin-left: -15px;\n  }\n  .card-deck .card {\n    display: flex;\n    flex: 1 0 0%;\n    flex-direction: column;\n    margin-right: 15px;\n    margin-bottom: 0;\n    margin-left: 15px;\n  }\n}\n\n.card-group {\n  display: flex;\n  flex-direction: column;\n}\n\n.card-group > .card {\n  margin-bottom: 15px;\n}\n\n@media (min-width: 576px) {\n  .card-group {\n    flex-flow: row wrap;\n  }\n  .card-group > .card {\n    flex: 1 0 0%;\n    margin-bottom: 0;\n  }\n  .card-group > .card + .card {\n    margin-left: 0;\n    border-left: 0;\n  }\n  .card-group > .card:not(:last-child) {\n    border-top-right-radius: 0;\n    border-bottom-right-radius: 0;\n  }\n  .card-group > .card:not(:last-child) .card-img-top,\n  .card-group > .card:not(:last-child) .card-header {\n    border-top-right-radius: 0;\n  }\n  .card-group > .card:not(:last-child) .card-img-bottom,\n  .card-group > .card:not(:last-child) .card-footer {\n    border-bottom-right-radius: 0;\n  }\n  .card-group > .card:not(:first-child) {\n    border-top-left-radius: 0;\n    border-bottom-left-radius: 0;\n  }\n  .card-group > .card:not(:first-child) .card-img-top,\n  .card-group > .card:not(:first-child) .card-header {\n    border-top-left-radius: 0;\n  }\n  .card-group > .card:not(:first-child) .card-img-bottom,\n  .card-group > .card:not(:first-child) .card-footer {\n    border-bottom-left-radius: 0;\n  }\n}\n\n.card-columns .card {\n  margin-bottom: 0.75rem;\n}\n\n@media (min-width: 576px) {\n  .card-columns {\n    column-count: 3;\n    column-gap: 1.25rem;\n    orphans: 1;\n    widows: 1;\n  }\n  .card-columns .card {\n    display: inline-block;\n    width: 100%;\n  }\n}\n\n.accordion > .card {\n  overflow: hidden;\n}\n\n.accordion > .card:not(:first-of-type) .card-header:first-child {\n  border-radius: 0;\n}\n\n.accordion > .card:not(:first-of-type):not(:last-of-type) {\n  border-bottom: 0;\n  border-radius: 0;\n}\n\n.accordion > .card:first-of-type {\n  border-bottom: 0;\n  border-bottom-right-radius: 0;\n  border-bottom-left-radius: 0;\n}\n\n.accordion > .card:last-of-type {\n  border-top-left-radius: 0;\n  border-top-right-radius: 0;\n}\n\n.accordion > .card .card-header {\n  margin-bottom: -1px;\n}\n\n.breadcrumb {\n  display: flex;\n  flex-wrap: wrap;\n  padding: 0.75rem 1rem;\n  margin-bottom: 1rem;\n  list-style: none;\n  background-color: #e9ecef;\n  border-radius: 0.25rem;\n}\n\n.breadcrumb-item + .breadcrumb-item {\n  padding-left: 0.5rem;\n}\n\n.breadcrumb-item + .breadcrumb-item::before {\n  display: inline-block;\n  padding-right: 0.5rem;\n  color: #6c757d;\n  content: \"/\";\n}\n\n.breadcrumb-item + .breadcrumb-item:hover::before {\n  text-decoration: underline;\n}\n\n.breadcrumb-item + .breadcrumb-item:hover::before {\n  text-decoration: none;\n}\n\n.breadcrumb-item.active {\n  color: #6c757d;\n}\n\n.pagination {\n  display: flex;\n  padding-left: 0;\n  list-style: none;\n  border-radius: 0.25rem;\n}\n\n.page-link {\n  position: relative;\n  display: block;\n  padding: 0.5rem 0.75rem;\n  margin-left: -1px;\n  line-height: 1.25;\n  color: #007bff;\n  background-color: #fff;\n  border: 1px solid #dee2e6;\n}\n\n.page-link:hover {\n  z-index: 2;\n  color: #0056b3;\n  text-decoration: none;\n  background-color: #e9ecef;\n  border-color: #dee2e6;\n}\n\n.page-link:focus {\n  z-index: 2;\n  outline: 0;\n  box-shadow: 0 0 0 0.2rem rgba(0, 123, 255, 0.25);\n}\n\n.page-item:first-child .page-link {\n  margin-left: 0;\n  border-top-left-radius: 0.25rem;\n  border-bottom-left-radius: 0.25rem;\n}\n\n.page-item:last-child .page-link {\n  border-top-right-radius: 0.25rem;\n  border-bottom-right-radius: 0.25rem;\n}\n\n.page-item.active .page-link {\n  z-index: 1;\n  color: #fff;\n  background-color: #007bff;\n  border-color: #007bff;\n}\n\n.page-item.disabled .page-link {\n  color: #6c757d;\n  pointer-events: none;\n  cursor: auto;\n  background-color: #fff;\n  border-color: #dee2e6;\n}\n\n.pagination-lg .page-link {\n  padding: 0.75rem 1.5rem;\n  font-size: 1.25rem;\n  line-height: 1.5;\n}\n\n.pagination-lg .page-item:first-child .page-link {\n  border-top-left-radius: 0.3rem;\n  border-bottom-left-radius: 0.3rem;\n}\n\n.pagination-lg .page-item:last-child .page-link {\n  border-top-right-radius: 0.3rem;\n  border-bottom-right-radius: 0.3rem;\n}\n\n.pagination-sm .page-link {\n  padding: 0.25rem 0.5rem;\n  font-size: 0.875rem;\n  line-height: 1.5;\n}\n\n.pagination-sm .page-item:first-child .page-link {\n  border-top-left-radius: 0.2rem;\n  border-bottom-left-radius: 0.2rem;\n}\n\n.pagination-sm .page-item:last-child .page-link {\n  border-top-right-radius: 0.2rem;\n  border-bottom-right-radius: 0.2rem;\n}\n\n.badge {\n  display: inline-block;\n  padding: 0.25em 0.4em;\n  font-size: 75%;\n  font-weight: 700;\n  line-height: 1;\n  text-align: center;\n  white-space: nowrap;\n  vertical-align: baseline;\n  border-radius: 0.25rem;\n  transition: color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .badge {\n    transition: none;\n  }\n}\n\na.badge:hover, a.badge:focus {\n  text-decoration: none;\n}\n\n.badge:empty {\n  display: none;\n}\n\n.btn .badge {\n  position: relative;\n  top: -1px;\n}\n\n.badge-pill {\n  padding-right: 0.6em;\n  padding-left: 0.6em;\n  border-radius: 10rem;\n}\n\n.badge-primary {\n  color: #fff;\n  background-color: #007bff;\n}\n\na.badge-primary:hover, a.badge-primary:focus {\n  color: #fff;\n  background-color: #0062cc;\n}\n\na.badge-primary:focus, a.badge-primary.focus {\n  outline: 0;\n  box-shadow: 0 0 0 0.2rem rgba(0, 123, 255, 0.5);\n}\n\n.badge-secondary {\n  color: #fff;\n  background-color: #6c757d;\n}\n\na.badge-secondary:hover, a.badge-secondary:focus {\n  color: #fff;\n  background-color: #545b62;\n}\n\na.badge-secondary:focus, a.badge-secondary.focus {\n  outline: 0;\n  box-shadow: 0 0 0 0.2rem rgba(108, 117, 125, 0.5);\n}\n\n.badge-success {\n  color: #fff;\n  background-color: #28a745;\n}\n\na.badge-success:hover, a.badge-success:focus {\n  color: #fff;\n  background-color: #1e7e34;\n}\n\na.badge-success:focus, a.badge-success.focus {\n  outline: 0;\n  box-shadow: 0 0 0 0.2rem rgba(40, 167, 69, 0.5);\n}\n\n.badge-info {\n  color: #fff;\n  background-color: #17a2b8;\n}\n\na.badge-info:hover, a.badge-info:focus {\n  color: #fff;\n  background-color: #117a8b;\n}\n\na.badge-info:focus, a.badge-info.focus {\n  outline: 0;\n  box-shadow: 0 0 0 0.2rem rgba(23, 162, 184, 0.5);\n}\n\n.badge-warning {\n  color: #212529;\n  background-color: #ffc107;\n}\n\na.badge-warning:hover, a.badge-warning:focus {\n  color: #212529;\n  background-color: #d39e00;\n}\n\na.badge-warning:focus, a.badge-warning.focus {\n  outline: 0;\n  box-shadow: 0 0 0 0.2rem rgba(255, 193, 7, 0.5);\n}\n\n.badge-danger {\n  color: #fff;\n  background-color: #dc3545;\n}\n\na.badge-danger:hover, a.badge-danger:focus {\n  color: #fff;\n  background-color: #bd2130;\n}\n\na.badge-danger:focus, a.badge-danger.focus {\n  outline: 0;\n  box-shadow: 0 0 0 0.2rem rgba(220, 53, 69, 0.5);\n}\n\n.badge-light {\n  color: #212529;\n  background-color: #f8f9fa;\n}\n\na.badge-light:hover, a.badge-light:focus {\n  color: #212529;\n  background-color: #dae0e5;\n}\n\na.badge-light:focus, a.badge-light.focus {\n  outline: 0;\n  box-shadow: 0 0 0 0.2rem rgba(248, 249, 250, 0.5);\n}\n\n.badge-dark {\n  color: #fff;\n  background-color: #343a40;\n}\n\na.badge-dark:hover, a.badge-dark:focus {\n  color: #fff;\n  background-color: #1d2124;\n}\n\na.badge-dark:focus, a.badge-dark.focus {\n  outline: 0;\n  box-shadow: 0 0 0 0.2rem rgba(52, 58, 64, 0.5);\n}\n\n.jumbotron {\n  padding: 2rem 1rem;\n  margin-bottom: 2rem;\n  background-color: #e9ecef;\n  border-radius: 0.3rem;\n}\n\n@media (min-width: 576px) {\n  .jumbotron {\n    padding: 4rem 2rem;\n  }\n}\n\n.jumbotron-fluid {\n  padding-right: 0;\n  padding-left: 0;\n  border-radius: 0;\n}\n\n.alert {\n  position: relative;\n  padding: 0.75rem 1.25rem;\n  margin-bottom: 1rem;\n  border: 1px solid transparent;\n  border-radius: 0.25rem;\n}\n\n.alert-heading {\n  color: inherit;\n}\n\n.alert-link {\n  font-weight: 700;\n}\n\n.alert-dismissible {\n  padding-right: 4rem;\n}\n\n.alert-dismissible .close {\n  position: absolute;\n  top: 0;\n  right: 0;\n  padding: 0.75rem 1.25rem;\n  color: inherit;\n}\n\n.alert-primary {\n  color: #004085;\n  background-color: #cce5ff;\n  border-color: #b8daff;\n}\n\n.alert-primary hr {\n  border-top-color: #9fcdff;\n}\n\n.alert-primary .alert-link {\n  color: #002752;\n}\n\n.alert-secondary {\n  color: #383d41;\n  background-color: #e2e3e5;\n  border-color: #d6d8db;\n}\n\n.alert-secondary hr {\n  border-top-color: #c8cbcf;\n}\n\n.alert-secondary .alert-link {\n  color: #202326;\n}\n\n.alert-success {\n  color: #155724;\n  background-color: #d4edda;\n  border-color: #c3e6cb;\n}\n\n.alert-success hr {\n  border-top-color: #b1dfbb;\n}\n\n.alert-success .alert-link {\n  color: #0b2e13;\n}\n\n.alert-info {\n  color: #0c5460;\n  background-color: #d1ecf1;\n  border-color: #bee5eb;\n}\n\n.alert-info hr {\n  border-top-color: #abdde5;\n}\n\n.alert-info .alert-link {\n  color: #062c33;\n}\n\n.alert-warning {\n  color: #856404;\n  background-color: #fff3cd;\n  border-color: #ffeeba;\n}\n\n.alert-warning hr {\n  border-top-color: #ffe8a1;\n}\n\n.alert-warning .alert-link {\n  color: #533f03;\n}\n\n.alert-danger {\n  color: #721c24;\n  background-color: #f8d7da;\n  border-color: #f5c6cb;\n}\n\n.alert-danger hr {\n  border-top-color: #f1b0b7;\n}\n\n.alert-danger .alert-link {\n  color: #491217;\n}\n\n.alert-light {\n  color: #818182;\n  background-color: #fefefe;\n  border-color: #fdfdfe;\n}\n\n.alert-light hr {\n  border-top-color: #ececf6;\n}\n\n.alert-light .alert-link {\n  color: #686868;\n}\n\n.alert-dark {\n  color: #1b1e21;\n  background-color: #d6d8d9;\n  border-color: #c6c8ca;\n}\n\n.alert-dark hr {\n  border-top-color: #b9bbbe;\n}\n\n.alert-dark .alert-link {\n  color: #040505;\n}\n\n@keyframes progress-bar-stripes {\n  from {\n    background-position: 1rem 0;\n  }\n  to {\n    background-position: 0 0;\n  }\n}\n\n.progress {\n  display: flex;\n  height: 1rem;\n  overflow: hidden;\n  font-size: 0.75rem;\n  background-color: #e9ecef;\n  border-radius: 0.25rem;\n}\n\n.progress-bar {\n  display: flex;\n  flex-direction: column;\n  justify-content: center;\n  color: #fff;\n  text-align: center;\n  white-space: nowrap;\n  background-color: #007bff;\n  transition: width 0.6s ease;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .progress-bar {\n    transition: none;\n  }\n}\n\n.progress-bar-striped {\n  background-image: linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent);\n  background-size: 1rem 1rem;\n}\n\n.progress-bar-animated {\n  animation: progress-bar-stripes 1s linear infinite;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .progress-bar-animated {\n    animation: none;\n  }\n}\n\n.media {\n  display: flex;\n  align-items: flex-start;\n}\n\n.media-body {\n  flex: 1;\n}\n\n.list-group {\n  display: flex;\n  flex-direction: column;\n  padding-left: 0;\n  margin-bottom: 0;\n}\n\n.list-group-item-action {\n  width: 100%;\n  color: #495057;\n  text-align: inherit;\n}\n\n.list-group-item-action:hover, .list-group-item-action:focus {\n  z-index: 1;\n  color: #495057;\n  text-decoration: none;\n  background-color: #f8f9fa;\n}\n\n.list-group-item-action:active {\n  color: #212529;\n  background-color: #e9ecef;\n}\n\n.list-group-item {\n  position: relative;\n  display: block;\n  padding: 0.75rem 1.25rem;\n  margin-bottom: -1px;\n  background-color: #fff;\n  border: 1px solid rgba(0, 0, 0, 0.125);\n}\n\n.list-group-item:first-child {\n  border-top-left-radius: 0.25rem;\n  border-top-right-radius: 0.25rem;\n}\n\n.list-group-item:last-child {\n  margin-bottom: 0;\n  border-bottom-right-radius: 0.25rem;\n  border-bottom-left-radius: 0.25rem;\n}\n\n.list-group-item.disabled, .list-group-item:disabled {\n  color: #6c757d;\n  pointer-events: none;\n  background-color: #fff;\n}\n\n.list-group-item.active {\n  z-index: 2;\n  color: #fff;\n  background-color: #007bff;\n  border-color: #007bff;\n}\n\n.list-group-horizontal {\n  flex-direction: row;\n}\n\n.list-group-horizontal .list-group-item {\n  margin-right: -1px;\n  margin-bottom: 0;\n}\n\n.list-group-horizontal .list-group-item:first-child {\n  border-top-left-radius: 0.25rem;\n  border-bottom-left-radius: 0.25rem;\n  border-top-right-radius: 0;\n}\n\n.list-group-horizontal .list-group-item:last-child {\n  margin-right: 0;\n  border-top-right-radius: 0.25rem;\n  border-bottom-right-radius: 0.25rem;\n  border-bottom-left-radius: 0;\n}\n\n@media (min-width: 576px) {\n  .list-group-horizontal-sm {\n    flex-direction: row;\n  }\n  .list-group-horizontal-sm .list-group-item {\n    margin-right: -1px;\n    margin-bottom: 0;\n  }\n  .list-group-horizontal-sm .list-group-item:first-child {\n    border-top-left-radius: 0.25rem;\n    border-bottom-left-radius: 0.25rem;\n    border-top-right-radius: 0;\n  }\n  .list-group-horizontal-sm .list-group-item:last-child {\n    margin-right: 0;\n    border-top-right-radius: 0.25rem;\n    border-bottom-right-radius: 0.25rem;\n    border-bottom-left-radius: 0;\n  }\n}\n\n@media (min-width: 768px) {\n  .list-group-horizontal-md {\n    flex-direction: row;\n  }\n  .list-group-horizontal-md .list-group-item {\n    margin-right: -1px;\n    margin-bottom: 0;\n  }\n  .list-group-horizontal-md .list-group-item:first-child {\n    border-top-left-radius: 0.25rem;\n    border-bottom-left-radius: 0.25rem;\n    border-top-right-radius: 0;\n  }\n  .list-group-horizontal-md .list-group-item:last-child {\n    margin-right: 0;\n    border-top-right-radius: 0.25rem;\n    border-bottom-right-radius: 0.25rem;\n    border-bottom-left-radius: 0;\n  }\n}\n\n@media (min-width: 992px) {\n  .list-group-horizontal-lg {\n    flex-direction: row;\n  }\n  .list-group-horizontal-lg .list-group-item {\n    margin-right: -1px;\n    margin-bottom: 0;\n  }\n  .list-group-horizontal-lg .list-group-item:first-child {\n    border-top-left-radius: 0.25rem;\n    border-bottom-left-radius: 0.25rem;\n    border-top-right-radius: 0;\n  }\n  .list-group-horizontal-lg .list-group-item:last-child {\n    margin-right: 0;\n    border-top-right-radius: 0.25rem;\n    border-bottom-right-radius: 0.25rem;\n    border-bottom-left-radius: 0;\n  }\n}\n\n@media (min-width: 1200px) {\n  .list-group-horizontal-xl {\n    flex-direction: row;\n  }\n  .list-group-horizontal-xl .list-group-item {\n    margin-right: -1px;\n    margin-bottom: 0;\n  }\n  .list-group-horizontal-xl .list-group-item:first-child {\n    border-top-left-radius: 0.25rem;\n    border-bottom-left-radius: 0.25rem;\n    border-top-right-radius: 0;\n  }\n  .list-group-horizontal-xl .list-group-item:last-child {\n    margin-right: 0;\n    border-top-right-radius: 0.25rem;\n    border-bottom-right-radius: 0.25rem;\n    border-bottom-left-radius: 0;\n  }\n}\n\n.list-group-flush .list-group-item {\n  border-right: 0;\n  border-left: 0;\n  border-radius: 0;\n}\n\n.list-group-flush .list-group-item:last-child {\n  margin-bottom: -1px;\n}\n\n.list-group-flush:first-child .list-group-item:first-child {\n  border-top: 0;\n}\n\n.list-group-flush:last-child .list-group-item:last-child {\n  margin-bottom: 0;\n  border-bottom: 0;\n}\n\n.list-group-item-primary {\n  color: #004085;\n  background-color: #b8daff;\n}\n\n.list-group-item-primary.list-group-item-action:hover, .list-group-item-primary.list-group-item-action:focus {\n  color: #004085;\n  background-color: #9fcdff;\n}\n\n.list-group-item-primary.list-group-item-action.active {\n  color: #fff;\n  background-color: #004085;\n  border-color: #004085;\n}\n\n.list-group-item-secondary {\n  color: #383d41;\n  background-color: #d6d8db;\n}\n\n.list-group-item-secondary.list-group-item-action:hover, .list-group-item-secondary.list-group-item-action:focus {\n  color: #383d41;\n  background-color: #c8cbcf;\n}\n\n.list-group-item-secondary.list-group-item-action.active {\n  color: #fff;\n  background-color: #383d41;\n  border-color: #383d41;\n}\n\n.list-group-item-success {\n  color: #155724;\n  background-color: #c3e6cb;\n}\n\n.list-group-item-success.list-group-item-action:hover, .list-group-item-success.list-group-item-action:focus {\n  color: #155724;\n  background-color: #b1dfbb;\n}\n\n.list-group-item-success.list-group-item-action.active {\n  color: #fff;\n  background-color: #155724;\n  border-color: #155724;\n}\n\n.list-group-item-info {\n  color: #0c5460;\n  background-color: #bee5eb;\n}\n\n.list-group-item-info.list-group-item-action:hover, .list-group-item-info.list-group-item-action:focus {\n  color: #0c5460;\n  background-color: #abdde5;\n}\n\n.list-group-item-info.list-group-item-action.active {\n  color: #fff;\n  background-color: #0c5460;\n  border-color: #0c5460;\n}\n\n.list-group-item-warning {\n  color: #856404;\n  background-color: #ffeeba;\n}\n\n.list-group-item-warning.list-group-item-action:hover, .list-group-item-warning.list-group-item-action:focus {\n  color: #856404;\n  background-color: #ffe8a1;\n}\n\n.list-group-item-warning.list-group-item-action.active {\n  color: #fff;\n  background-color: #856404;\n  border-color: #856404;\n}\n\n.list-group-item-danger {\n  color: #721c24;\n  background-color: #f5c6cb;\n}\n\n.list-group-item-danger.list-group-item-action:hover, .list-group-item-danger.list-group-item-action:focus {\n  color: #721c24;\n  background-color: #f1b0b7;\n}\n\n.list-group-item-danger.list-group-item-action.active {\n  color: #fff;\n  background-color: #721c24;\n  border-color: #721c24;\n}\n\n.list-group-item-light {\n  color: #818182;\n  background-color: #fdfdfe;\n}\n\n.list-group-item-light.list-group-item-action:hover, .list-group-item-light.list-group-item-action:focus {\n  color: #818182;\n  background-color: #ececf6;\n}\n\n.list-group-item-light.list-group-item-action.active {\n  color: #fff;\n  background-color: #818182;\n  border-color: #818182;\n}\n\n.list-group-item-dark {\n  color: #1b1e21;\n  background-color: #c6c8ca;\n}\n\n.list-group-item-dark.list-group-item-action:hover, .list-group-item-dark.list-group-item-action:focus {\n  color: #1b1e21;\n  background-color: #b9bbbe;\n}\n\n.list-group-item-dark.list-group-item-action.active {\n  color: #fff;\n  background-color: #1b1e21;\n  border-color: #1b1e21;\n}\n\n.close {\n  float: right;\n  font-size: 1.5rem;\n  font-weight: 700;\n  line-height: 1;\n  color: #000;\n  text-shadow: 0 1px 0 #fff;\n  opacity: .5;\n}\n\n.close:hover {\n  color: #000;\n  text-decoration: none;\n}\n\n.close:not(:disabled):not(.disabled):hover, .close:not(:disabled):not(.disabled):focus {\n  opacity: .75;\n}\n\nbutton.close {\n  padding: 0;\n  background-color: transparent;\n  border: 0;\n  appearance: none;\n}\n\na.close.disabled {\n  pointer-events: none;\n}\n\n.toast {\n  max-width: 350px;\n  overflow: hidden;\n  font-size: 0.875rem;\n  background-color: rgba(255, 255, 255, 0.85);\n  background-clip: padding-box;\n  border: 1px solid rgba(0, 0, 0, 0.1);\n  box-shadow: 0 0.25rem 0.75rem rgba(0, 0, 0, 0.1);\n  backdrop-filter: blur(10px);\n  opacity: 0;\n  border-radius: 0.25rem;\n}\n\n.toast:not(:last-child) {\n  margin-bottom: 0.75rem;\n}\n\n.toast.showing {\n  opacity: 1;\n}\n\n.toast.show {\n  display: block;\n  opacity: 1;\n}\n\n.toast.hide {\n  display: none;\n}\n\n.toast-header {\n  display: flex;\n  align-items: center;\n  padding: 0.25rem 0.75rem;\n  color: #6c757d;\n  background-color: rgba(255, 255, 255, 0.85);\n  background-clip: padding-box;\n  border-bottom: 1px solid rgba(0, 0, 0, 0.05);\n}\n\n.toast-body {\n  padding: 0.75rem;\n}\n\n.modal-open {\n  overflow: hidden;\n}\n\n.modal-open .modal {\n  overflow-x: hidden;\n  overflow-y: auto;\n}\n\n.modal {\n  position: fixed;\n  top: 0;\n  left: 0;\n  z-index: 1050;\n  display: none;\n  width: 100%;\n  height: 100%;\n  overflow: hidden;\n  outline: 0;\n}\n\n.modal-dialog {\n  position: relative;\n  width: auto;\n  margin: 0.5rem;\n  pointer-events: none;\n}\n\n.modal.fade .modal-dialog {\n  transition: transform 0.3s ease-out;\n  transform: translate(0, -50px);\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .modal.fade .modal-dialog {\n    transition: none;\n  }\n}\n\n.modal.show .modal-dialog {\n  transform: none;\n}\n\n.modal-dialog-scrollable {\n  display: flex;\n  max-height: calc(100% - 1rem);\n}\n\n.modal-dialog-scrollable .modal-content {\n  max-height: calc(100vh - 1rem);\n  overflow: hidden;\n}\n\n.modal-dialog-scrollable .modal-header,\n.modal-dialog-scrollable .modal-footer {\n  flex-shrink: 0;\n}\n\n.modal-dialog-scrollable .modal-body {\n  overflow-y: auto;\n}\n\n.modal-dialog-centered {\n  display: flex;\n  align-items: center;\n  min-height: calc(100% - 1rem);\n}\n\n.modal-dialog-centered::before {\n  display: block;\n  height: calc(100vh - 1rem);\n  content: \"\";\n}\n\n.modal-dialog-centered.modal-dialog-scrollable {\n  flex-direction: column;\n  justify-content: center;\n  height: 100%;\n}\n\n.modal-dialog-centered.modal-dialog-scrollable .modal-content {\n  max-height: none;\n}\n\n.modal-dialog-centered.modal-dialog-scrollable::before {\n  content: none;\n}\n\n.modal-content {\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  width: 100%;\n  pointer-events: auto;\n  background-color: #fff;\n  background-clip: padding-box;\n  border: 1px solid rgba(0, 0, 0, 0.2);\n  border-radius: 0.3rem;\n  outline: 0;\n}\n\n.modal-backdrop {\n  position: fixed;\n  top: 0;\n  left: 0;\n  z-index: 1040;\n  width: 100vw;\n  height: 100vh;\n  background-color: #000;\n}\n\n.modal-backdrop.fade {\n  opacity: 0;\n}\n\n.modal-backdrop.show {\n  opacity: 0.5;\n}\n\n.modal-header {\n  display: flex;\n  align-items: flex-start;\n  justify-content: space-between;\n  padding: 1rem 1rem;\n  border-bottom: 1px solid #dee2e6;\n  border-top-left-radius: 0.3rem;\n  border-top-right-radius: 0.3rem;\n}\n\n.modal-header .close {\n  padding: 1rem 1rem;\n  margin: -1rem -1rem -1rem auto;\n}\n\n.modal-title {\n  margin-bottom: 0;\n  line-height: 1.5;\n}\n\n.modal-body {\n  position: relative;\n  flex: 1 1 auto;\n  padding: 1rem;\n}\n\n.modal-footer {\n  display: flex;\n  align-items: center;\n  justify-content: flex-end;\n  padding: 1rem;\n  border-top: 1px solid #dee2e6;\n  border-bottom-right-radius: 0.3rem;\n  border-bottom-left-radius: 0.3rem;\n}\n\n.modal-footer > :not(:first-child) {\n  margin-left: .25rem;\n}\n\n.modal-footer > :not(:last-child) {\n  margin-right: .25rem;\n}\n\n.modal-scrollbar-measure {\n  position: absolute;\n  top: -9999px;\n  width: 50px;\n  height: 50px;\n  overflow: scroll;\n}\n\n@media (min-width: 576px) {\n  .modal-dialog {\n    max-width: 500px;\n    margin: 1.75rem auto;\n  }\n  .modal-dialog-scrollable {\n    max-height: calc(100% - 3.5rem);\n  }\n  .modal-dialog-scrollable .modal-content {\n    max-height: calc(100vh - 3.5rem);\n  }\n  .modal-dialog-centered {\n    min-height: calc(100% - 3.5rem);\n  }\n  .modal-dialog-centered::before {\n    height: calc(100vh - 3.5rem);\n  }\n  .modal-sm {\n    max-width: 300px;\n  }\n}\n\n@media (min-width: 992px) {\n  .modal-lg,\n  .modal-xl {\n    max-width: 800px;\n  }\n}\n\n@media (min-width: 1200px) {\n  .modal-xl {\n    max-width: 1140px;\n  }\n}\n\n.tooltip {\n  position: absolute;\n  z-index: 1070;\n  display: block;\n  margin: 0;\n  font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, \"Noto Sans\", sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\", \"Noto Color Emoji\";\n  font-style: normal;\n  font-weight: 400;\n  line-height: 1.5;\n  text-align: left;\n  text-align: start;\n  text-decoration: none;\n  text-shadow: none;\n  text-transform: none;\n  letter-spacing: normal;\n  word-break: normal;\n  word-spacing: normal;\n  white-space: normal;\n  line-break: auto;\n  font-size: 0.875rem;\n  word-wrap: break-word;\n  opacity: 0;\n}\n\n.tooltip.show {\n  opacity: 0.9;\n}\n\n.tooltip .arrow {\n  position: absolute;\n  display: block;\n  width: 0.8rem;\n  height: 0.4rem;\n}\n\n.tooltip .arrow::before {\n  position: absolute;\n  content: \"\";\n  border-color: transparent;\n  border-style: solid;\n}\n\n.bs-tooltip-top, .bs-tooltip-auto[x-placement^=\"top\"] {\n  padding: 0.4rem 0;\n}\n\n.bs-tooltip-top .arrow, .bs-tooltip-auto[x-placement^=\"top\"] .arrow {\n  bottom: 0;\n}\n\n.bs-tooltip-top .arrow::before, .bs-tooltip-auto[x-placement^=\"top\"] .arrow::before {\n  top: 0;\n  border-width: 0.4rem 0.4rem 0;\n  border-top-color: #000;\n}\n\n.bs-tooltip-right, .bs-tooltip-auto[x-placement^=\"right\"] {\n  padding: 0 0.4rem;\n}\n\n.bs-tooltip-right .arrow, .bs-tooltip-auto[x-placement^=\"right\"] .arrow {\n  left: 0;\n  width: 0.4rem;\n  height: 0.8rem;\n}\n\n.bs-tooltip-right .arrow::before, .bs-tooltip-auto[x-placement^=\"right\"] .arrow::before {\n  right: 0;\n  border-width: 0.4rem 0.4rem 0.4rem 0;\n  border-right-color: #000;\n}\n\n.bs-tooltip-bottom, .bs-tooltip-auto[x-placement^=\"bottom\"] {\n  padding: 0.4rem 0;\n}\n\n.bs-tooltip-bottom .arrow, .bs-tooltip-auto[x-placement^=\"bottom\"] .arrow {\n  top: 0;\n}\n\n.bs-tooltip-bottom .arrow::before, .bs-tooltip-auto[x-placement^=\"bottom\"] .arrow::before {\n  bottom: 0;\n  border-width: 0 0.4rem 0.4rem;\n  border-bottom-color: #000;\n}\n\n.bs-tooltip-left, .bs-tooltip-auto[x-placement^=\"left\"] {\n  padding: 0 0.4rem;\n}\n\n.bs-tooltip-left .arrow, .bs-tooltip-auto[x-placement^=\"left\"] .arrow {\n  right: 0;\n  width: 0.4rem;\n  height: 0.8rem;\n}\n\n.bs-tooltip-left .arrow::before, .bs-tooltip-auto[x-placement^=\"left\"] .arrow::before {\n  left: 0;\n  border-width: 0.4rem 0 0.4rem 0.4rem;\n  border-left-color: #000;\n}\n\n.tooltip-inner {\n  max-width: 200px;\n  padding: 0.25rem 0.5rem;\n  color: #fff;\n  text-align: center;\n  background-color: #000;\n  border-radius: 0.25rem;\n}\n\n.popover {\n  position: absolute;\n  top: 0;\n  left: 0;\n  z-index: 1060;\n  display: block;\n  max-width: 276px;\n  font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, \"Noto Sans\", sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\", \"Noto Color Emoji\";\n  font-style: normal;\n  font-weight: 400;\n  line-height: 1.5;\n  text-align: left;\n  text-align: start;\n  text-decoration: none;\n  text-shadow: none;\n  text-transform: none;\n  letter-spacing: normal;\n  word-break: normal;\n  word-spacing: normal;\n  white-space: normal;\n  line-break: auto;\n  font-size: 0.875rem;\n  word-wrap: break-word;\n  background-color: #fff;\n  background-clip: padding-box;\n  border: 1px solid rgba(0, 0, 0, 0.2);\n  border-radius: 0.3rem;\n}\n\n.popover .arrow {\n  position: absolute;\n  display: block;\n  width: 1rem;\n  height: 0.5rem;\n  margin: 0 0.3rem;\n}\n\n.popover .arrow::before, .popover .arrow::after {\n  position: absolute;\n  display: block;\n  content: \"\";\n  border-color: transparent;\n  border-style: solid;\n}\n\n.bs-popover-top, .bs-popover-auto[x-placement^=\"top\"] {\n  margin-bottom: 0.5rem;\n}\n\n.bs-popover-top > .arrow, .bs-popover-auto[x-placement^=\"top\"] > .arrow {\n  bottom: calc((0.5rem + 1px) * -1);\n}\n\n.bs-popover-top > .arrow::before, .bs-popover-auto[x-placement^=\"top\"] > .arrow::before {\n  bottom: 0;\n  border-width: 0.5rem 0.5rem 0;\n  border-top-color: rgba(0, 0, 0, 0.25);\n}\n\n.bs-popover-top > .arrow::after, .bs-popover-auto[x-placement^=\"top\"] > .arrow::after {\n  bottom: 1px;\n  border-width: 0.5rem 0.5rem 0;\n  border-top-color: #fff;\n}\n\n.bs-popover-right, .bs-popover-auto[x-placement^=\"right\"] {\n  margin-left: 0.5rem;\n}\n\n.bs-popover-right > .arrow, .bs-popover-auto[x-placement^=\"right\"] > .arrow {\n  left: calc((0.5rem + 1px) * -1);\n  width: 0.5rem;\n  height: 1rem;\n  margin: 0.3rem 0;\n}\n\n.bs-popover-right > .arrow::before, .bs-popover-auto[x-placement^=\"right\"] > .arrow::before {\n  left: 0;\n  border-width: 0.5rem 0.5rem 0.5rem 0;\n  border-right-color: rgba(0, 0, 0, 0.25);\n}\n\n.bs-popover-right > .arrow::after, .bs-popover-auto[x-placement^=\"right\"] > .arrow::after {\n  left: 1px;\n  border-width: 0.5rem 0.5rem 0.5rem 0;\n  border-right-color: #fff;\n}\n\n.bs-popover-bottom, .bs-popover-auto[x-placement^=\"bottom\"] {\n  margin-top: 0.5rem;\n}\n\n.bs-popover-bottom > .arrow, .bs-popover-auto[x-placement^=\"bottom\"] > .arrow {\n  top: calc((0.5rem + 1px) * -1);\n}\n\n.bs-popover-bottom > .arrow::before, .bs-popover-auto[x-placement^=\"bottom\"] > .arrow::before {\n  top: 0;\n  border-width: 0 0.5rem 0.5rem 0.5rem;\n  border-bottom-color: rgba(0, 0, 0, 0.25);\n}\n\n.bs-popover-bottom > .arrow::after, .bs-popover-auto[x-placement^=\"bottom\"] > .arrow::after {\n  top: 1px;\n  border-width: 0 0.5rem 0.5rem 0.5rem;\n  border-bottom-color: #fff;\n}\n\n.bs-popover-bottom .popover-header::before, .bs-popover-auto[x-placement^=\"bottom\"] .popover-header::before {\n  position: absolute;\n  top: 0;\n  left: 50%;\n  display: block;\n  width: 1rem;\n  margin-left: -0.5rem;\n  content: \"\";\n  border-bottom: 1px solid #f7f7f7;\n}\n\n.bs-popover-left, .bs-popover-auto[x-placement^=\"left\"] {\n  margin-right: 0.5rem;\n}\n\n.bs-popover-left > .arrow, .bs-popover-auto[x-placement^=\"left\"] > .arrow {\n  right: calc((0.5rem + 1px) * -1);\n  width: 0.5rem;\n  height: 1rem;\n  margin: 0.3rem 0;\n}\n\n.bs-popover-left > .arrow::before, .bs-popover-auto[x-placement^=\"left\"] > .arrow::before {\n  right: 0;\n  border-width: 0.5rem 0 0.5rem 0.5rem;\n  border-left-color: rgba(0, 0, 0, 0.25);\n}\n\n.bs-popover-left > .arrow::after, .bs-popover-auto[x-placement^=\"left\"] > .arrow::after {\n  right: 1px;\n  border-width: 0.5rem 0 0.5rem 0.5rem;\n  border-left-color: #fff;\n}\n\n.popover-header {\n  padding: 0.5rem 0.75rem;\n  margin-bottom: 0;\n  font-size: 1rem;\n  background-color: #f7f7f7;\n  border-bottom: 1px solid #ebebeb;\n  border-top-left-radius: calc(0.3rem - 1px);\n  border-top-right-radius: calc(0.3rem - 1px);\n}\n\n.popover-header:empty {\n  display: none;\n}\n\n.popover-body {\n  padding: 0.5rem 0.75rem;\n  color: #212529;\n}\n\n.carousel {\n  position: relative;\n}\n\n.carousel.pointer-event {\n  touch-action: pan-y;\n}\n\n.carousel-inner {\n  position: relative;\n  width: 100%;\n  overflow: hidden;\n}\n\n.carousel-inner::after {\n  display: block;\n  clear: both;\n  content: \"\";\n}\n\n.carousel-item {\n  position: relative;\n  display: none;\n  float: left;\n  width: 100%;\n  margin-right: -100%;\n  backface-visibility: hidden;\n  transition: transform 0.6s ease-in-out;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .carousel-item {\n    transition: none;\n  }\n}\n\n.carousel-item.active,\n.carousel-item-next,\n.carousel-item-prev {\n  display: block;\n}\n\n.carousel-item-next:not(.carousel-item-left),\n.active.carousel-item-right {\n  transform: translateX(100%);\n}\n\n.carousel-item-prev:not(.carousel-item-right),\n.active.carousel-item-left {\n  transform: translateX(-100%);\n}\n\n.carousel-fade .carousel-item {\n  opacity: 0;\n  transition-property: opacity;\n  transform: none;\n}\n\n.carousel-fade .carousel-item.active,\n.carousel-fade .carousel-item-next.carousel-item-left,\n.carousel-fade .carousel-item-prev.carousel-item-right {\n  z-index: 1;\n  opacity: 1;\n}\n\n.carousel-fade .active.carousel-item-left,\n.carousel-fade .active.carousel-item-right {\n  z-index: 0;\n  opacity: 0;\n  transition: 0s 0.6s opacity;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .carousel-fade .active.carousel-item-left,\n  .carousel-fade .active.carousel-item-right {\n    transition: none;\n  }\n}\n\n.carousel-control-prev,\n.carousel-control-next {\n  position: absolute;\n  top: 0;\n  bottom: 0;\n  z-index: 1;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  width: 15%;\n  color: #fff;\n  text-align: center;\n  opacity: 0.5;\n  transition: opacity 0.15s ease;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .carousel-control-prev,\n  .carousel-control-next {\n    transition: none;\n  }\n}\n\n.carousel-control-prev:hover, .carousel-control-prev:focus,\n.carousel-control-next:hover,\n.carousel-control-next:focus {\n  color: #fff;\n  text-decoration: none;\n  outline: 0;\n  opacity: 0.9;\n}\n\n.carousel-control-prev {\n  left: 0;\n}\n\n.carousel-control-next {\n  right: 0;\n}\n\n.carousel-control-prev-icon,\n.carousel-control-next-icon {\n  display: inline-block;\n  width: 20px;\n  height: 20px;\n  background: no-repeat 50% / 100% 100%;\n}\n\n.carousel-control-prev-icon {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' fill='%23fff' viewBox='0 0 8 8'%3e%3cpath d='M5.25 0l-4 4 4 4 1.5-1.5-2.5-2.5 2.5-2.5-1.5-1.5z'/%3e%3c/svg%3e\");\n}\n\n.carousel-control-next-icon {\n  background-image: url(\"data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' fill='%23fff' viewBox='0 0 8 8'%3e%3cpath d='M2.75 0l-1.5 1.5 2.5 2.5-2.5 2.5 1.5 1.5 4-4-4-4z'/%3e%3c/svg%3e\");\n}\n\n.carousel-indicators {\n  position: absolute;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  z-index: 15;\n  display: flex;\n  justify-content: center;\n  padding-left: 0;\n  margin-right: 15%;\n  margin-left: 15%;\n  list-style: none;\n}\n\n.carousel-indicators li {\n  box-sizing: content-box;\n  flex: 0 1 auto;\n  width: 30px;\n  height: 3px;\n  margin-right: 3px;\n  margin-left: 3px;\n  text-indent: -999px;\n  cursor: pointer;\n  background-color: #fff;\n  background-clip: padding-box;\n  border-top: 10px solid transparent;\n  border-bottom: 10px solid transparent;\n  opacity: .5;\n  transition: opacity 0.6s ease;\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .carousel-indicators li {\n    transition: none;\n  }\n}\n\n.carousel-indicators .active {\n  opacity: 1;\n}\n\n.carousel-caption {\n  position: absolute;\n  right: 15%;\n  bottom: 20px;\n  left: 15%;\n  z-index: 10;\n  padding-top: 20px;\n  padding-bottom: 20px;\n  color: #fff;\n  text-align: center;\n}\n\n@keyframes spinner-border {\n  to {\n    transform: rotate(360deg);\n  }\n}\n\n.spinner-border {\n  display: inline-block;\n  width: 2rem;\n  height: 2rem;\n  vertical-align: text-bottom;\n  border: 0.25em solid currentColor;\n  border-right-color: transparent;\n  border-radius: 50%;\n  animation: spinner-border .75s linear infinite;\n}\n\n.spinner-border-sm {\n  width: 1rem;\n  height: 1rem;\n  border-width: 0.2em;\n}\n\n@keyframes spinner-grow {\n  0% {\n    transform: scale(0);\n  }\n  50% {\n    opacity: 1;\n  }\n}\n\n.spinner-grow {\n  display: inline-block;\n  width: 2rem;\n  height: 2rem;\n  vertical-align: text-bottom;\n  background-color: currentColor;\n  border-radius: 50%;\n  opacity: 0;\n  animation: spinner-grow .75s linear infinite;\n}\n\n.spinner-grow-sm {\n  width: 1rem;\n  height: 1rem;\n}\n\n.align-baseline {\n  vertical-align: baseline !important;\n}\n\n.align-top {\n  vertical-align: top !important;\n}\n\n.align-middle {\n  vertical-align: middle !important;\n}\n\n.align-bottom {\n  vertical-align: bottom !important;\n}\n\n.align-text-bottom {\n  vertical-align: text-bottom !important;\n}\n\n.align-text-top {\n  vertical-align: text-top !important;\n}\n\n.bg-primary {\n  background-color: #007bff !important;\n}\n\na.bg-primary:hover, a.bg-primary:focus,\nbutton.bg-primary:hover,\nbutton.bg-primary:focus {\n  background-color: #0062cc !important;\n}\n\n.bg-secondary {\n  background-color: #6c757d !important;\n}\n\na.bg-secondary:hover, a.bg-secondary:focus,\nbutton.bg-secondary:hover,\nbutton.bg-secondary:focus {\n  background-color: #545b62 !important;\n}\n\n.bg-success {\n  background-color: #28a745 !important;\n}\n\na.bg-success:hover, a.bg-success:focus,\nbutton.bg-success:hover,\nbutton.bg-success:focus {\n  background-color: #1e7e34 !important;\n}\n\n.bg-info {\n  background-color: #17a2b8 !important;\n}\n\na.bg-info:hover, a.bg-info:focus,\nbutton.bg-info:hover,\nbutton.bg-info:focus {\n  background-color: #117a8b !important;\n}\n\n.bg-warning {\n  background-color: #ffc107 !important;\n}\n\na.bg-warning:hover, a.bg-warning:focus,\nbutton.bg-warning:hover,\nbutton.bg-warning:focus {\n  background-color: #d39e00 !important;\n}\n\n.bg-danger {\n  background-color: #dc3545 !important;\n}\n\na.bg-danger:hover, a.bg-danger:focus,\nbutton.bg-danger:hover,\nbutton.bg-danger:focus {\n  background-color: #bd2130 !important;\n}\n\n.bg-light {\n  background-color: #f8f9fa !important;\n}\n\na.bg-light:hover, a.bg-light:focus,\nbutton.bg-light:hover,\nbutton.bg-light:focus {\n  background-color: #dae0e5 !important;\n}\n\n.bg-dark {\n  background-color: #343a40 !important;\n}\n\na.bg-dark:hover, a.bg-dark:focus,\nbutton.bg-dark:hover,\nbutton.bg-dark:focus {\n  background-color: #1d2124 !important;\n}\n\n.bg-white {\n  background-color: #fff !important;\n}\n\n.bg-transparent {\n  background-color: transparent !important;\n}\n\n.border {\n  border: 1px solid #dee2e6 !important;\n}\n\n.border-top {\n  border-top: 1px solid #dee2e6 !important;\n}\n\n.border-right {\n  border-right: 1px solid #dee2e6 !important;\n}\n\n.border-bottom {\n  border-bottom: 1px solid #dee2e6 !important;\n}\n\n.border-left {\n  border-left: 1px solid #dee2e6 !important;\n}\n\n.border-0 {\n  border: 0 !important;\n}\n\n.border-top-0 {\n  border-top: 0 !important;\n}\n\n.border-right-0 {\n  border-right: 0 !important;\n}\n\n.border-bottom-0 {\n  border-bottom: 0 !important;\n}\n\n.border-left-0 {\n  border-left: 0 !important;\n}\n\n.border-primary {\n  border-color: #007bff !important;\n}\n\n.border-secondary {\n  border-color: #6c757d !important;\n}\n\n.border-success {\n  border-color: #28a745 !important;\n}\n\n.border-info {\n  border-color: #17a2b8 !important;\n}\n\n.border-warning {\n  border-color: #ffc107 !important;\n}\n\n.border-danger {\n  border-color: #dc3545 !important;\n}\n\n.border-light {\n  border-color: #f8f9fa !important;\n}\n\n.border-dark {\n  border-color: #343a40 !important;\n}\n\n.border-white {\n  border-color: #fff !important;\n}\n\n.rounded-sm {\n  border-radius: 0.2rem !important;\n}\n\n.rounded {\n  border-radius: 0.25rem !important;\n}\n\n.rounded-top {\n  border-top-left-radius: 0.25rem !important;\n  border-top-right-radius: 0.25rem !important;\n}\n\n.rounded-right {\n  border-top-right-radius: 0.25rem !important;\n  border-bottom-right-radius: 0.25rem !important;\n}\n\n.rounded-bottom {\n  border-bottom-right-radius: 0.25rem !important;\n  border-bottom-left-radius: 0.25rem !important;\n}\n\n.rounded-left {\n  border-top-left-radius: 0.25rem !important;\n  border-bottom-left-radius: 0.25rem !important;\n}\n\n.rounded-lg {\n  border-radius: 0.3rem !important;\n}\n\n.rounded-circle {\n  border-radius: 50% !important;\n}\n\n.rounded-pill {\n  border-radius: 50rem !important;\n}\n\n.rounded-0 {\n  border-radius: 0 !important;\n}\n\n.clearfix::after {\n  display: block;\n  clear: both;\n  content: \"\";\n}\n\n.d-none {\n  display: none !important;\n}\n\n.d-inline {\n  display: inline !important;\n}\n\n.d-inline-block {\n  display: inline-block !important;\n}\n\n.d-block {\n  display: block !important;\n}\n\n.d-table {\n  display: table !important;\n}\n\n.d-table-row {\n  display: table-row !important;\n}\n\n.d-table-cell {\n  display: table-cell !important;\n}\n\n.d-flex {\n  display: flex !important;\n}\n\n.d-inline-flex {\n  display: inline-flex !important;\n}\n\n@media (min-width: 576px) {\n  .d-sm-none {\n    display: none !important;\n  }\n  .d-sm-inline {\n    display: inline !important;\n  }\n  .d-sm-inline-block {\n    display: inline-block !important;\n  }\n  .d-sm-block {\n    display: block !important;\n  }\n  .d-sm-table {\n    display: table !important;\n  }\n  .d-sm-table-row {\n    display: table-row !important;\n  }\n  .d-sm-table-cell {\n    display: table-cell !important;\n  }\n  .d-sm-flex {\n    display: flex !important;\n  }\n  .d-sm-inline-flex {\n    display: inline-flex !important;\n  }\n}\n\n@media (min-width: 768px) {\n  .d-md-none {\n    display: none !important;\n  }\n  .d-md-inline {\n    display: inline !important;\n  }\n  .d-md-inline-block {\n    display: inline-block !important;\n  }\n  .d-md-block {\n    display: block !important;\n  }\n  .d-md-table {\n    display: table !important;\n  }\n  .d-md-table-row {\n    display: table-row !important;\n  }\n  .d-md-table-cell {\n    display: table-cell !important;\n  }\n  .d-md-flex {\n    display: flex !important;\n  }\n  .d-md-inline-flex {\n    display: inline-flex !important;\n  }\n}\n\n@media (min-width: 992px) {\n  .d-lg-none {\n    display: none !important;\n  }\n  .d-lg-inline {\n    display: inline !important;\n  }\n  .d-lg-inline-block {\n    display: inline-block !important;\n  }\n  .d-lg-block {\n    display: block !important;\n  }\n  .d-lg-table {\n    display: table !important;\n  }\n  .d-lg-table-row {\n    display: table-row !important;\n  }\n  .d-lg-table-cell {\n    display: table-cell !important;\n  }\n  .d-lg-flex {\n    display: flex !important;\n  }\n  .d-lg-inline-flex {\n    display: inline-flex !important;\n  }\n}\n\n@media (min-width: 1200px) {\n  .d-xl-none {\n    display: none !important;\n  }\n  .d-xl-inline {\n    display: inline !important;\n  }\n  .d-xl-inline-block {\n    display: inline-block !important;\n  }\n  .d-xl-block {\n    display: block !important;\n  }\n  .d-xl-table {\n    display: table !important;\n  }\n  .d-xl-table-row {\n    display: table-row !important;\n  }\n  .d-xl-table-cell {\n    display: table-cell !important;\n  }\n  .d-xl-flex {\n    display: flex !important;\n  }\n  .d-xl-inline-flex {\n    display: inline-flex !important;\n  }\n}\n\n@media print {\n  .d-print-none {\n    display: none !important;\n  }\n  .d-print-inline {\n    display: inline !important;\n  }\n  .d-print-inline-block {\n    display: inline-block !important;\n  }\n  .d-print-block {\n    display: block !important;\n  }\n  .d-print-table {\n    display: table !important;\n  }\n  .d-print-table-row {\n    display: table-row !important;\n  }\n  .d-print-table-cell {\n    display: table-cell !important;\n  }\n  .d-print-flex {\n    display: flex !important;\n  }\n  .d-print-inline-flex {\n    display: inline-flex !important;\n  }\n}\n\n.embed-responsive {\n  position: relative;\n  display: block;\n  width: 100%;\n  padding: 0;\n  overflow: hidden;\n}\n\n.embed-responsive::before {\n  display: block;\n  content: \"\";\n}\n\n.embed-responsive .embed-responsive-item,\n.embed-responsive iframe,\n.embed-responsive embed,\n.embed-responsive object,\n.embed-responsive video {\n  position: absolute;\n  top: 0;\n  bottom: 0;\n  left: 0;\n  width: 100%;\n  height: 100%;\n  border: 0;\n}\n\n.embed-responsive-21by9::before {\n  padding-top: 42.857143%;\n}\n\n.embed-responsive-16by9::before {\n  padding-top: 56.25%;\n}\n\n.embed-responsive-4by3::before {\n  padding-top: 75%;\n}\n\n.embed-responsive-1by1::before {\n  padding-top: 100%;\n}\n\n.flex-row {\n  flex-direction: row !important;\n}\n\n.flex-column {\n  flex-direction: column !important;\n}\n\n.flex-row-reverse {\n  flex-direction: row-reverse !important;\n}\n\n.flex-column-reverse {\n  flex-direction: column-reverse !important;\n}\n\n.flex-wrap {\n  flex-wrap: wrap !important;\n}\n\n.flex-nowrap {\n  flex-wrap: nowrap !important;\n}\n\n.flex-wrap-reverse {\n  flex-wrap: wrap-reverse !important;\n}\n\n.flex-fill {\n  flex: 1 1 auto !important;\n}\n\n.flex-grow-0 {\n  flex-grow: 0 !important;\n}\n\n.flex-grow-1 {\n  flex-grow: 1 !important;\n}\n\n.flex-shrink-0 {\n  flex-shrink: 0 !important;\n}\n\n.flex-shrink-1 {\n  flex-shrink: 1 !important;\n}\n\n.justify-content-start {\n  justify-content: flex-start !important;\n}\n\n.justify-content-end {\n  justify-content: flex-end !important;\n}\n\n.justify-content-center {\n  justify-content: center !important;\n}\n\n.justify-content-between {\n  justify-content: space-between !important;\n}\n\n.justify-content-around {\n  justify-content: space-around !important;\n}\n\n.align-items-start {\n  align-items: flex-start !important;\n}\n\n.align-items-end {\n  align-items: flex-end !important;\n}\n\n.align-items-center {\n  align-items: center !important;\n}\n\n.align-items-baseline {\n  align-items: baseline !important;\n}\n\n.align-items-stretch {\n  align-items: stretch !important;\n}\n\n.align-content-start {\n  align-content: flex-start !important;\n}\n\n.align-content-end {\n  align-content: flex-end !important;\n}\n\n.align-content-center {\n  align-content: center !important;\n}\n\n.align-content-between {\n  align-content: space-between !important;\n}\n\n.align-content-around {\n  align-content: space-around !important;\n}\n\n.align-content-stretch {\n  align-content: stretch !important;\n}\n\n.align-self-auto {\n  align-self: auto !important;\n}\n\n.align-self-start {\n  align-self: flex-start !important;\n}\n\n.align-self-end {\n  align-self: flex-end !important;\n}\n\n.align-self-center {\n  align-self: center !important;\n}\n\n.align-self-baseline {\n  align-self: baseline !important;\n}\n\n.align-self-stretch {\n  align-self: stretch !important;\n}\n\n@media (min-width: 576px) {\n  .flex-sm-row {\n    flex-direction: row !important;\n  }\n  .flex-sm-column {\n    flex-direction: column !important;\n  }\n  .flex-sm-row-reverse {\n    flex-direction: row-reverse !important;\n  }\n  .flex-sm-column-reverse {\n    flex-direction: column-reverse !important;\n  }\n  .flex-sm-wrap {\n    flex-wrap: wrap !important;\n  }\n  .flex-sm-nowrap {\n    flex-wrap: nowrap !important;\n  }\n  .flex-sm-wrap-reverse {\n    flex-wrap: wrap-reverse !important;\n  }\n  .flex-sm-fill {\n    flex: 1 1 auto !important;\n  }\n  .flex-sm-grow-0 {\n    flex-grow: 0 !important;\n  }\n  .flex-sm-grow-1 {\n    flex-grow: 1 !important;\n  }\n  .flex-sm-shrink-0 {\n    flex-shrink: 0 !important;\n  }\n  .flex-sm-shrink-1 {\n    flex-shrink: 1 !important;\n  }\n  .justify-content-sm-start {\n    justify-content: flex-start !important;\n  }\n  .justify-content-sm-end {\n    justify-content: flex-end !important;\n  }\n  .justify-content-sm-center {\n    justify-content: center !important;\n  }\n  .justify-content-sm-between {\n    justify-content: space-between !important;\n  }\n  .justify-content-sm-around {\n    justify-content: space-around !important;\n  }\n  .align-items-sm-start {\n    align-items: flex-start !important;\n  }\n  .align-items-sm-end {\n    align-items: flex-end !important;\n  }\n  .align-items-sm-center {\n    align-items: center !important;\n  }\n  .align-items-sm-baseline {\n    align-items: baseline !important;\n  }\n  .align-items-sm-stretch {\n    align-items: stretch !important;\n  }\n  .align-content-sm-start {\n    align-content: flex-start !important;\n  }\n  .align-content-sm-end {\n    align-content: flex-end !important;\n  }\n  .align-content-sm-center {\n    align-content: center !important;\n  }\n  .align-content-sm-between {\n    align-content: space-between !important;\n  }\n  .align-content-sm-around {\n    align-content: space-around !important;\n  }\n  .align-content-sm-stretch {\n    align-content: stretch !important;\n  }\n  .align-self-sm-auto {\n    align-self: auto !important;\n  }\n  .align-self-sm-start {\n    align-self: flex-start !important;\n  }\n  .align-self-sm-end {\n    align-self: flex-end !important;\n  }\n  .align-self-sm-center {\n    align-self: center !important;\n  }\n  .align-self-sm-baseline {\n    align-self: baseline !important;\n  }\n  .align-self-sm-stretch {\n    align-self: stretch !important;\n  }\n}\n\n@media (min-width: 768px) {\n  .flex-md-row {\n    flex-direction: row !important;\n  }\n  .flex-md-column {\n    flex-direction: column !important;\n  }\n  .flex-md-row-reverse {\n    flex-direction: row-reverse !important;\n  }\n  .flex-md-column-reverse {\n    flex-direction: column-reverse !important;\n  }\n  .flex-md-wrap {\n    flex-wrap: wrap !important;\n  }\n  .flex-md-nowrap {\n    flex-wrap: nowrap !important;\n  }\n  .flex-md-wrap-reverse {\n    flex-wrap: wrap-reverse !important;\n  }\n  .flex-md-fill {\n    flex: 1 1 auto !important;\n  }\n  .flex-md-grow-0 {\n    flex-grow: 0 !important;\n  }\n  .flex-md-grow-1 {\n    flex-grow: 1 !important;\n  }\n  .flex-md-shrink-0 {\n    flex-shrink: 0 !important;\n  }\n  .flex-md-shrink-1 {\n    flex-shrink: 1 !important;\n  }\n  .justify-content-md-start {\n    justify-content: flex-start !important;\n  }\n  .justify-content-md-end {\n    justify-content: flex-end !important;\n  }\n  .justify-content-md-center {\n    justify-content: center !important;\n  }\n  .justify-content-md-between {\n    justify-content: space-between !important;\n  }\n  .justify-content-md-around {\n    justify-content: space-around !important;\n  }\n  .align-items-md-start {\n    align-items: flex-start !important;\n  }\n  .align-items-md-end {\n    align-items: flex-end !important;\n  }\n  .align-items-md-center {\n    align-items: center !important;\n  }\n  .align-items-md-baseline {\n    align-items: baseline !important;\n  }\n  .align-items-md-stretch {\n    align-items: stretch !important;\n  }\n  .align-content-md-start {\n    align-content: flex-start !important;\n  }\n  .align-content-md-end {\n    align-content: flex-end !important;\n  }\n  .align-content-md-center {\n    align-content: center !important;\n  }\n  .align-content-md-between {\n    align-content: space-between !important;\n  }\n  .align-content-md-around {\n    align-content: space-around !important;\n  }\n  .align-content-md-stretch {\n    align-content: stretch !important;\n  }\n  .align-self-md-auto {\n    align-self: auto !important;\n  }\n  .align-self-md-start {\n    align-self: flex-start !important;\n  }\n  .align-self-md-end {\n    align-self: flex-end !important;\n  }\n  .align-self-md-center {\n    align-self: center !important;\n  }\n  .align-self-md-baseline {\n    align-self: baseline !important;\n  }\n  .align-self-md-stretch {\n    align-self: stretch !important;\n  }\n}\n\n@media (min-width: 992px) {\n  .flex-lg-row {\n    flex-direction: row !important;\n  }\n  .flex-lg-column {\n    flex-direction: column !important;\n  }\n  .flex-lg-row-reverse {\n    flex-direction: row-reverse !important;\n  }\n  .flex-lg-column-reverse {\n    flex-direction: column-reverse !important;\n  }\n  .flex-lg-wrap {\n    flex-wrap: wrap !important;\n  }\n  .flex-lg-nowrap {\n    flex-wrap: nowrap !important;\n  }\n  .flex-lg-wrap-reverse {\n    flex-wrap: wrap-reverse !important;\n  }\n  .flex-lg-fill {\n    flex: 1 1 auto !important;\n  }\n  .flex-lg-grow-0 {\n    flex-grow: 0 !important;\n  }\n  .flex-lg-grow-1 {\n    flex-grow: 1 !important;\n  }\n  .flex-lg-shrink-0 {\n    flex-shrink: 0 !important;\n  }\n  .flex-lg-shrink-1 {\n    flex-shrink: 1 !important;\n  }\n  .justify-content-lg-start {\n    justify-content: flex-start !important;\n  }\n  .justify-content-lg-end {\n    justify-content: flex-end !important;\n  }\n  .justify-content-lg-center {\n    justify-content: center !important;\n  }\n  .justify-content-lg-between {\n    justify-content: space-between !important;\n  }\n  .justify-content-lg-around {\n    justify-content: space-around !important;\n  }\n  .align-items-lg-start {\n    align-items: flex-start !important;\n  }\n  .align-items-lg-end {\n    align-items: flex-end !important;\n  }\n  .align-items-lg-center {\n    align-items: center !important;\n  }\n  .align-items-lg-baseline {\n    align-items: baseline !important;\n  }\n  .align-items-lg-stretch {\n    align-items: stretch !important;\n  }\n  .align-content-lg-start {\n    align-content: flex-start !important;\n  }\n  .align-content-lg-end {\n    align-content: flex-end !important;\n  }\n  .align-content-lg-center {\n    align-content: center !important;\n  }\n  .align-content-lg-between {\n    align-content: space-between !important;\n  }\n  .align-content-lg-around {\n    align-content: space-around !important;\n  }\n  .align-content-lg-stretch {\n    align-content: stretch !important;\n  }\n  .align-self-lg-auto {\n    align-self: auto !important;\n  }\n  .align-self-lg-start {\n    align-self: flex-start !important;\n  }\n  .align-self-lg-end {\n    align-self: flex-end !important;\n  }\n  .align-self-lg-center {\n    align-self: center !important;\n  }\n  .align-self-lg-baseline {\n    align-self: baseline !important;\n  }\n  .align-self-lg-stretch {\n    align-self: stretch !important;\n  }\n}\n\n@media (min-width: 1200px) {\n  .flex-xl-row {\n    flex-direction: row !important;\n  }\n  .flex-xl-column {\n    flex-direction: column !important;\n  }\n  .flex-xl-row-reverse {\n    flex-direction: row-reverse !important;\n  }\n  .flex-xl-column-reverse {\n    flex-direction: column-reverse !important;\n  }\n  .flex-xl-wrap {\n    flex-wrap: wrap !important;\n  }\n  .flex-xl-nowrap {\n    flex-wrap: nowrap !important;\n  }\n  .flex-xl-wrap-reverse {\n    flex-wrap: wrap-reverse !important;\n  }\n  .flex-xl-fill {\n    flex: 1 1 auto !important;\n  }\n  .flex-xl-grow-0 {\n    flex-grow: 0 !important;\n  }\n  .flex-xl-grow-1 {\n    flex-grow: 1 !important;\n  }\n  .flex-xl-shrink-0 {\n    flex-shrink: 0 !important;\n  }\n  .flex-xl-shrink-1 {\n    flex-shrink: 1 !important;\n  }\n  .justify-content-xl-start {\n    justify-content: flex-start !important;\n  }\n  .justify-content-xl-end {\n    justify-content: flex-end !important;\n  }\n  .justify-content-xl-center {\n    justify-content: center !important;\n  }\n  .justify-content-xl-between {\n    justify-content: space-between !important;\n  }\n  .justify-content-xl-around {\n    justify-content: space-around !important;\n  }\n  .align-items-xl-start {\n    align-items: flex-start !important;\n  }\n  .align-items-xl-end {\n    align-items: flex-end !important;\n  }\n  .align-items-xl-center {\n    align-items: center !important;\n  }\n  .align-items-xl-baseline {\n    align-items: baseline !important;\n  }\n  .align-items-xl-stretch {\n    align-items: stretch !important;\n  }\n  .align-content-xl-start {\n    align-content: flex-start !important;\n  }\n  .align-content-xl-end {\n    align-content: flex-end !important;\n  }\n  .align-content-xl-center {\n    align-content: center !important;\n  }\n  .align-content-xl-between {\n    align-content: space-between !important;\n  }\n  .align-content-xl-around {\n    align-content: space-around !important;\n  }\n  .align-content-xl-stretch {\n    align-content: stretch !important;\n  }\n  .align-self-xl-auto {\n    align-self: auto !important;\n  }\n  .align-self-xl-start {\n    align-self: flex-start !important;\n  }\n  .align-self-xl-end {\n    align-self: flex-end !important;\n  }\n  .align-self-xl-center {\n    align-self: center !important;\n  }\n  .align-self-xl-baseline {\n    align-self: baseline !important;\n  }\n  .align-self-xl-stretch {\n    align-self: stretch !important;\n  }\n}\n\n.float-left {\n  float: left !important;\n}\n\n.float-right {\n  float: right !important;\n}\n\n.float-none {\n  float: none !important;\n}\n\n@media (min-width: 576px) {\n  .float-sm-left {\n    float: left !important;\n  }\n  .float-sm-right {\n    float: right !important;\n  }\n  .float-sm-none {\n    float: none !important;\n  }\n}\n\n@media (min-width: 768px) {\n  .float-md-left {\n    float: left !important;\n  }\n  .float-md-right {\n    float: right !important;\n  }\n  .float-md-none {\n    float: none !important;\n  }\n}\n\n@media (min-width: 992px) {\n  .float-lg-left {\n    float: left !important;\n  }\n  .float-lg-right {\n    float: right !important;\n  }\n  .float-lg-none {\n    float: none !important;\n  }\n}\n\n@media (min-width: 1200px) {\n  .float-xl-left {\n    float: left !important;\n  }\n  .float-xl-right {\n    float: right !important;\n  }\n  .float-xl-none {\n    float: none !important;\n  }\n}\n\n.overflow-auto {\n  overflow: auto !important;\n}\n\n.overflow-hidden {\n  overflow: hidden !important;\n}\n\n.position-static {\n  position: static !important;\n}\n\n.position-relative {\n  position: relative !important;\n}\n\n.position-absolute {\n  position: absolute !important;\n}\n\n.position-fixed {\n  position: fixed !important;\n}\n\n.position-sticky {\n  position: sticky !important;\n}\n\n.fixed-top {\n  position: fixed;\n  top: 0;\n  right: 0;\n  left: 0;\n  z-index: 1030;\n}\n\n.fixed-bottom {\n  position: fixed;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  z-index: 1030;\n}\n\n@supports (position: sticky) {\n  .sticky-top {\n    position: sticky;\n    top: 0;\n    z-index: 1020;\n  }\n}\n\n.sr-only {\n  position: absolute;\n  width: 1px;\n  height: 1px;\n  padding: 0;\n  overflow: hidden;\n  clip: rect(0, 0, 0, 0);\n  white-space: nowrap;\n  border: 0;\n}\n\n.sr-only-focusable:active, .sr-only-focusable:focus {\n  position: static;\n  width: auto;\n  height: auto;\n  overflow: visible;\n  clip: auto;\n  white-space: normal;\n}\n\n.shadow-sm {\n  box-shadow: 0 0.125rem 0.25rem rgba(0, 0, 0, 0.075) !important;\n}\n\n.shadow {\n  box-shadow: 0 0.5rem 1rem rgba(0, 0, 0, 0.15) !important;\n}\n\n.shadow-lg {\n  box-shadow: 0 1rem 3rem rgba(0, 0, 0, 0.175) !important;\n}\n\n.shadow-none {\n  box-shadow: none !important;\n}\n\n.w-25 {\n  width: 25% !important;\n}\n\n.w-50 {\n  width: 50% !important;\n}\n\n.w-75 {\n  width: 75% !important;\n}\n\n.w-100 {\n  width: 100% !important;\n}\n\n.w-auto {\n  width: auto !important;\n}\n\n.h-25 {\n  height: 25% !important;\n}\n\n.h-50 {\n  height: 50% !important;\n}\n\n.h-75 {\n  height: 75% !important;\n}\n\n.h-100 {\n  height: 100% !important;\n}\n\n.h-auto {\n  height: auto !important;\n}\n\n.mw-100 {\n  max-width: 100% !important;\n}\n\n.mh-100 {\n  max-height: 100% !important;\n}\n\n.min-vw-100 {\n  min-width: 100vw !important;\n}\n\n.min-vh-100 {\n  min-height: 100vh !important;\n}\n\n.vw-100 {\n  width: 100vw !important;\n}\n\n.vh-100 {\n  height: 100vh !important;\n}\n\n.stretched-link::after {\n  position: absolute;\n  top: 0;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  z-index: 1;\n  pointer-events: auto;\n  content: \"\";\n  background-color: rgba(0, 0, 0, 0);\n}\n\n.m-0 {\n  margin: 0 !important;\n}\n\n.mt-0,\n.my-0 {\n  margin-top: 0 !important;\n}\n\n.mr-0,\n.mx-0 {\n  margin-right: 0 !important;\n}\n\n.mb-0,\n.my-0 {\n  margin-bottom: 0 !important;\n}\n\n.ml-0,\n.mx-0 {\n  margin-left: 0 !important;\n}\n\n.m-1 {\n  margin: 0.25rem !important;\n}\n\n.mt-1,\n.my-1 {\n  margin-top: 0.25rem !important;\n}\n\n.mr-1,\n.mx-1 {\n  margin-right: 0.25rem !important;\n}\n\n.mb-1,\n.my-1 {\n  margin-bottom: 0.25rem !important;\n}\n\n.ml-1,\n.mx-1 {\n  margin-left: 0.25rem !important;\n}\n\n.m-2 {\n  margin: 0.5rem !important;\n}\n\n.mt-2,\n.my-2 {\n  margin-top: 0.5rem !important;\n}\n\n.mr-2,\n.mx-2 {\n  margin-right: 0.5rem !important;\n}\n\n.mb-2,\n.my-2 {\n  margin-bottom: 0.5rem !important;\n}\n\n.ml-2,\n.mx-2 {\n  margin-left: 0.5rem !important;\n}\n\n.m-3 {\n  margin: 1rem !important;\n}\n\n.mt-3,\n.my-3 {\n  margin-top: 1rem !important;\n}\n\n.mr-3,\n.mx-3 {\n  margin-right: 1rem !important;\n}\n\n.mb-3,\n.my-3 {\n  margin-bottom: 1rem !important;\n}\n\n.ml-3,\n.mx-3 {\n  margin-left: 1rem !important;\n}\n\n.m-4 {\n  margin: 1.5rem !important;\n}\n\n.mt-4,\n.my-4 {\n  margin-top: 1.5rem !important;\n}\n\n.mr-4,\n.mx-4 {\n  margin-right: 1.5rem !important;\n}\n\n.mb-4,\n.my-4 {\n  margin-bottom: 1.5rem !important;\n}\n\n.ml-4,\n.mx-4 {\n  margin-left: 1.5rem !important;\n}\n\n.m-5 {\n  margin: 3rem !important;\n}\n\n.mt-5,\n.my-5 {\n  margin-top: 3rem !important;\n}\n\n.mr-5,\n.mx-5 {\n  margin-right: 3rem !important;\n}\n\n.mb-5,\n.my-5 {\n  margin-bottom: 3rem !important;\n}\n\n.ml-5,\n.mx-5 {\n  margin-left: 3rem !important;\n}\n\n.p-0 {\n  padding: 0 !important;\n}\n\n.pt-0,\n.py-0 {\n  padding-top: 0 !important;\n}\n\n.pr-0,\n.px-0 {\n  padding-right: 0 !important;\n}\n\n.pb-0,\n.py-0 {\n  padding-bottom: 0 !important;\n}\n\n.pl-0,\n.px-0 {\n  padding-left: 0 !important;\n}\n\n.p-1 {\n  padding: 0.25rem !important;\n}\n\n.pt-1,\n.py-1 {\n  padding-top: 0.25rem !important;\n}\n\n.pr-1,\n.px-1 {\n  padding-right: 0.25rem !important;\n}\n\n.pb-1,\n.py-1 {\n  padding-bottom: 0.25rem !important;\n}\n\n.pl-1,\n.px-1 {\n  padding-left: 0.25rem !important;\n}\n\n.p-2 {\n  padding: 0.5rem !important;\n}\n\n.pt-2,\n.py-2 {\n  padding-top: 0.5rem !important;\n}\n\n.pr-2,\n.px-2 {\n  padding-right: 0.5rem !important;\n}\n\n.pb-2,\n.py-2 {\n  padding-bottom: 0.5rem !important;\n}\n\n.pl-2,\n.px-2 {\n  padding-left: 0.5rem !important;\n}\n\n.p-3 {\n  padding: 1rem !important;\n}\n\n.pt-3,\n.py-3 {\n  padding-top: 1rem !important;\n}\n\n.pr-3,\n.px-3 {\n  padding-right: 1rem !important;\n}\n\n.pb-3,\n.py-3 {\n  padding-bottom: 1rem !important;\n}\n\n.pl-3,\n.px-3 {\n  padding-left: 1rem !important;\n}\n\n.p-4 {\n  padding: 1.5rem !important;\n}\n\n.pt-4,\n.py-4 {\n  padding-top: 1.5rem !important;\n}\n\n.pr-4,\n.px-4 {\n  padding-right: 1.5rem !important;\n}\n\n.pb-4,\n.py-4 {\n  padding-bottom: 1.5rem !important;\n}\n\n.pl-4,\n.px-4 {\n  padding-left: 1.5rem !important;\n}\n\n.p-5 {\n  padding: 3rem !important;\n}\n\n.pt-5,\n.py-5 {\n  padding-top: 3rem !important;\n}\n\n.pr-5,\n.px-5 {\n  padding-right: 3rem !important;\n}\n\n.pb-5,\n.py-5 {\n  padding-bottom: 3rem !important;\n}\n\n.pl-5,\n.px-5 {\n  padding-left: 3rem !important;\n}\n\n.m-n1 {\n  margin: -0.25rem !important;\n}\n\n.mt-n1,\n.my-n1 {\n  margin-top: -0.25rem !important;\n}\n\n.mr-n1,\n.mx-n1 {\n  margin-right: -0.25rem !important;\n}\n\n.mb-n1,\n.my-n1 {\n  margin-bottom: -0.25rem !important;\n}\n\n.ml-n1,\n.mx-n1 {\n  margin-left: -0.25rem !important;\n}\n\n.m-n2 {\n  margin: -0.5rem !important;\n}\n\n.mt-n2,\n.my-n2 {\n  margin-top: -0.5rem !important;\n}\n\n.mr-n2,\n.mx-n2 {\n  margin-right: -0.5rem !important;\n}\n\n.mb-n2,\n.my-n2 {\n  margin-bottom: -0.5rem !important;\n}\n\n.ml-n2,\n.mx-n2 {\n  margin-left: -0.5rem !important;\n}\n\n.m-n3 {\n  margin: -1rem !important;\n}\n\n.mt-n3,\n.my-n3 {\n  margin-top: -1rem !important;\n}\n\n.mr-n3,\n.mx-n3 {\n  margin-right: -1rem !important;\n}\n\n.mb-n3,\n.my-n3 {\n  margin-bottom: -1rem !important;\n}\n\n.ml-n3,\n.mx-n3 {\n  margin-left: -1rem !important;\n}\n\n.m-n4 {\n  margin: -1.5rem !important;\n}\n\n.mt-n4,\n.my-n4 {\n  margin-top: -1.5rem !important;\n}\n\n.mr-n4,\n.mx-n4 {\n  margin-right: -1.5rem !important;\n}\n\n.mb-n4,\n.my-n4 {\n  margin-bottom: -1.5rem !important;\n}\n\n.ml-n4,\n.mx-n4 {\n  margin-left: -1.5rem !important;\n}\n\n.m-n5 {\n  margin: -3rem !important;\n}\n\n.mt-n5,\n.my-n5 {\n  margin-top: -3rem !important;\n}\n\n.mr-n5,\n.mx-n5 {\n  margin-right: -3rem !important;\n}\n\n.mb-n5,\n.my-n5 {\n  margin-bottom: -3rem !important;\n}\n\n.ml-n5,\n.mx-n5 {\n  margin-left: -3rem !important;\n}\n\n.m-auto {\n  margin: auto !important;\n}\n\n.mt-auto,\n.my-auto {\n  margin-top: auto !important;\n}\n\n.mr-auto,\n.mx-auto {\n  margin-right: auto !important;\n}\n\n.mb-auto,\n.my-auto {\n  margin-bottom: auto !important;\n}\n\n.ml-auto,\n.mx-auto {\n  margin-left: auto !important;\n}\n\n@media (min-width: 576px) {\n  .m-sm-0 {\n    margin: 0 !important;\n  }\n  .mt-sm-0,\n  .my-sm-0 {\n    margin-top: 0 !important;\n  }\n  .mr-sm-0,\n  .mx-sm-0 {\n    margin-right: 0 !important;\n  }\n  .mb-sm-0,\n  .my-sm-0 {\n    margin-bottom: 0 !important;\n  }\n  .ml-sm-0,\n  .mx-sm-0 {\n    margin-left: 0 !important;\n  }\n  .m-sm-1 {\n    margin: 0.25rem !important;\n  }\n  .mt-sm-1,\n  .my-sm-1 {\n    margin-top: 0.25rem !important;\n  }\n  .mr-sm-1,\n  .mx-sm-1 {\n    margin-right: 0.25rem !important;\n  }\n  .mb-sm-1,\n  .my-sm-1 {\n    margin-bottom: 0.25rem !important;\n  }\n  .ml-sm-1,\n  .mx-sm-1 {\n    margin-left: 0.25rem !important;\n  }\n  .m-sm-2 {\n    margin: 0.5rem !important;\n  }\n  .mt-sm-2,\n  .my-sm-2 {\n    margin-top: 0.5rem !important;\n  }\n  .mr-sm-2,\n  .mx-sm-2 {\n    margin-right: 0.5rem !important;\n  }\n  .mb-sm-2,\n  .my-sm-2 {\n    margin-bottom: 0.5rem !important;\n  }\n  .ml-sm-2,\n  .mx-sm-2 {\n    margin-left: 0.5rem !important;\n  }\n  .m-sm-3 {\n    margin: 1rem !important;\n  }\n  .mt-sm-3,\n  .my-sm-3 {\n    margin-top: 1rem !important;\n  }\n  .mr-sm-3,\n  .mx-sm-3 {\n    margin-right: 1rem !important;\n  }\n  .mb-sm-3,\n  .my-sm-3 {\n    margin-bottom: 1rem !important;\n  }\n  .ml-sm-3,\n  .mx-sm-3 {\n    margin-left: 1rem !important;\n  }\n  .m-sm-4 {\n    margin: 1.5rem !important;\n  }\n  .mt-sm-4,\n  .my-sm-4 {\n    margin-top: 1.5rem !important;\n  }\n  .mr-sm-4,\n  .mx-sm-4 {\n    margin-right: 1.5rem !important;\n  }\n  .mb-sm-4,\n  .my-sm-4 {\n    margin-bottom: 1.5rem !important;\n  }\n  .ml-sm-4,\n  .mx-sm-4 {\n    margin-left: 1.5rem !important;\n  }\n  .m-sm-5 {\n    margin: 3rem !important;\n  }\n  .mt-sm-5,\n  .my-sm-5 {\n    margin-top: 3rem !important;\n  }\n  .mr-sm-5,\n  .mx-sm-5 {\n    margin-right: 3rem !important;\n  }\n  .mb-sm-5,\n  .my-sm-5 {\n    margin-bottom: 3rem !important;\n  }\n  .ml-sm-5,\n  .mx-sm-5 {\n    margin-left: 3rem !important;\n  }\n  .p-sm-0 {\n    padding: 0 !important;\n  }\n  .pt-sm-0,\n  .py-sm-0 {\n    padding-top: 0 !important;\n  }\n  .pr-sm-0,\n  .px-sm-0 {\n    padding-right: 0 !important;\n  }\n  .pb-sm-0,\n  .py-sm-0 {\n    padding-bottom: 0 !important;\n  }\n  .pl-sm-0,\n  .px-sm-0 {\n    padding-left: 0 !important;\n  }\n  .p-sm-1 {\n    padding: 0.25rem !important;\n  }\n  .pt-sm-1,\n  .py-sm-1 {\n    padding-top: 0.25rem !important;\n  }\n  .pr-sm-1,\n  .px-sm-1 {\n    padding-right: 0.25rem !important;\n  }\n  .pb-sm-1,\n  .py-sm-1 {\n    padding-bottom: 0.25rem !important;\n  }\n  .pl-sm-1,\n  .px-sm-1 {\n    padding-left: 0.25rem !important;\n  }\n  .p-sm-2 {\n    padding: 0.5rem !important;\n  }\n  .pt-sm-2,\n  .py-sm-2 {\n    padding-top: 0.5rem !important;\n  }\n  .pr-sm-2,\n  .px-sm-2 {\n    padding-right: 0.5rem !important;\n  }\n  .pb-sm-2,\n  .py-sm-2 {\n    padding-bottom: 0.5rem !important;\n  }\n  .pl-sm-2,\n  .px-sm-2 {\n    padding-left: 0.5rem !important;\n  }\n  .p-sm-3 {\n    padding: 1rem !important;\n  }\n  .pt-sm-3,\n  .py-sm-3 {\n    padding-top: 1rem !important;\n  }\n  .pr-sm-3,\n  .px-sm-3 {\n    padding-right: 1rem !important;\n  }\n  .pb-sm-3,\n  .py-sm-3 {\n    padding-bottom: 1rem !important;\n  }\n  .pl-sm-3,\n  .px-sm-3 {\n    padding-left: 1rem !important;\n  }\n  .p-sm-4 {\n    padding: 1.5rem !important;\n  }\n  .pt-sm-4,\n  .py-sm-4 {\n    padding-top: 1.5rem !important;\n  }\n  .pr-sm-4,\n  .px-sm-4 {\n    padding-right: 1.5rem !important;\n  }\n  .pb-sm-4,\n  .py-sm-4 {\n    padding-bottom: 1.5rem !important;\n  }\n  .pl-sm-4,\n  .px-sm-4 {\n    padding-left: 1.5rem !important;\n  }\n  .p-sm-5 {\n    padding: 3rem !important;\n  }\n  .pt-sm-5,\n  .py-sm-5 {\n    padding-top: 3rem !important;\n  }\n  .pr-sm-5,\n  .px-sm-5 {\n    padding-right: 3rem !important;\n  }\n  .pb-sm-5,\n  .py-sm-5 {\n    padding-bottom: 3rem !important;\n  }\n  .pl-sm-5,\n  .px-sm-5 {\n    padding-left: 3rem !important;\n  }\n  .m-sm-n1 {\n    margin: -0.25rem !important;\n  }\n  .mt-sm-n1,\n  .my-sm-n1 {\n    margin-top: -0.25rem !important;\n  }\n  .mr-sm-n1,\n  .mx-sm-n1 {\n    margin-right: -0.25rem !important;\n  }\n  .mb-sm-n1,\n  .my-sm-n1 {\n    margin-bottom: -0.25rem !important;\n  }\n  .ml-sm-n1,\n  .mx-sm-n1 {\n    margin-left: -0.25rem !important;\n  }\n  .m-sm-n2 {\n    margin: -0.5rem !important;\n  }\n  .mt-sm-n2,\n  .my-sm-n2 {\n    margin-top: -0.5rem !important;\n  }\n  .mr-sm-n2,\n  .mx-sm-n2 {\n    margin-right: -0.5rem !important;\n  }\n  .mb-sm-n2,\n  .my-sm-n2 {\n    margin-bottom: -0.5rem !important;\n  }\n  .ml-sm-n2,\n  .mx-sm-n2 {\n    margin-left: -0.5rem !important;\n  }\n  .m-sm-n3 {\n    margin: -1rem !important;\n  }\n  .mt-sm-n3,\n  .my-sm-n3 {\n    margin-top: -1rem !important;\n  }\n  .mr-sm-n3,\n  .mx-sm-n3 {\n    margin-right: -1rem !important;\n  }\n  .mb-sm-n3,\n  .my-sm-n3 {\n    margin-bottom: -1rem !important;\n  }\n  .ml-sm-n3,\n  .mx-sm-n3 {\n    margin-left: -1rem !important;\n  }\n  .m-sm-n4 {\n    margin: -1.5rem !important;\n  }\n  .mt-sm-n4,\n  .my-sm-n4 {\n    margin-top: -1.5rem !important;\n  }\n  .mr-sm-n4,\n  .mx-sm-n4 {\n    margin-right: -1.5rem !important;\n  }\n  .mb-sm-n4,\n  .my-sm-n4 {\n    margin-bottom: -1.5rem !important;\n  }\n  .ml-sm-n4,\n  .mx-sm-n4 {\n    margin-left: -1.5rem !important;\n  }\n  .m-sm-n5 {\n    margin: -3rem !important;\n  }\n  .mt-sm-n5,\n  .my-sm-n5 {\n    margin-top: -3rem !important;\n  }\n  .mr-sm-n5,\n  .mx-sm-n5 {\n    margin-right: -3rem !important;\n  }\n  .mb-sm-n5,\n  .my-sm-n5 {\n    margin-bottom: -3rem !important;\n  }\n  .ml-sm-n5,\n  .mx-sm-n5 {\n    margin-left: -3rem !important;\n  }\n  .m-sm-auto {\n    margin: auto !important;\n  }\n  .mt-sm-auto,\n  .my-sm-auto {\n    margin-top: auto !important;\n  }\n  .mr-sm-auto,\n  .mx-sm-auto {\n    margin-right: auto !important;\n  }\n  .mb-sm-auto,\n  .my-sm-auto {\n    margin-bottom: auto !important;\n  }\n  .ml-sm-auto,\n  .mx-sm-auto {\n    margin-left: auto !important;\n  }\n}\n\n@media (min-width: 768px) {\n  .m-md-0 {\n    margin: 0 !important;\n  }\n  .mt-md-0,\n  .my-md-0 {\n    margin-top: 0 !important;\n  }\n  .mr-md-0,\n  .mx-md-0 {\n    margin-right: 0 !important;\n  }\n  .mb-md-0,\n  .my-md-0 {\n    margin-bottom: 0 !important;\n  }\n  .ml-md-0,\n  .mx-md-0 {\n    margin-left: 0 !important;\n  }\n  .m-md-1 {\n    margin: 0.25rem !important;\n  }\n  .mt-md-1,\n  .my-md-1 {\n    margin-top: 0.25rem !important;\n  }\n  .mr-md-1,\n  .mx-md-1 {\n    margin-right: 0.25rem !important;\n  }\n  .mb-md-1,\n  .my-md-1 {\n    margin-bottom: 0.25rem !important;\n  }\n  .ml-md-1,\n  .mx-md-1 {\n    margin-left: 0.25rem !important;\n  }\n  .m-md-2 {\n    margin: 0.5rem !important;\n  }\n  .mt-md-2,\n  .my-md-2 {\n    margin-top: 0.5rem !important;\n  }\n  .mr-md-2,\n  .mx-md-2 {\n    margin-right: 0.5rem !important;\n  }\n  .mb-md-2,\n  .my-md-2 {\n    margin-bottom: 0.5rem !important;\n  }\n  .ml-md-2,\n  .mx-md-2 {\n    margin-left: 0.5rem !important;\n  }\n  .m-md-3 {\n    margin: 1rem !important;\n  }\n  .mt-md-3,\n  .my-md-3 {\n    margin-top: 1rem !important;\n  }\n  .mr-md-3,\n  .mx-md-3 {\n    margin-right: 1rem !important;\n  }\n  .mb-md-3,\n  .my-md-3 {\n    margin-bottom: 1rem !important;\n  }\n  .ml-md-3,\n  .mx-md-3 {\n    margin-left: 1rem !important;\n  }\n  .m-md-4 {\n    margin: 1.5rem !important;\n  }\n  .mt-md-4,\n  .my-md-4 {\n    margin-top: 1.5rem !important;\n  }\n  .mr-md-4,\n  .mx-md-4 {\n    margin-right: 1.5rem !important;\n  }\n  .mb-md-4,\n  .my-md-4 {\n    margin-bottom: 1.5rem !important;\n  }\n  .ml-md-4,\n  .mx-md-4 {\n    margin-left: 1.5rem !important;\n  }\n  .m-md-5 {\n    margin: 3rem !important;\n  }\n  .mt-md-5,\n  .my-md-5 {\n    margin-top: 3rem !important;\n  }\n  .mr-md-5,\n  .mx-md-5 {\n    margin-right: 3rem !important;\n  }\n  .mb-md-5,\n  .my-md-5 {\n    margin-bottom: 3rem !important;\n  }\n  .ml-md-5,\n  .mx-md-5 {\n    margin-left: 3rem !important;\n  }\n  .p-md-0 {\n    padding: 0 !important;\n  }\n  .pt-md-0,\n  .py-md-0 {\n    padding-top: 0 !important;\n  }\n  .pr-md-0,\n  .px-md-0 {\n    padding-right: 0 !important;\n  }\n  .pb-md-0,\n  .py-md-0 {\n    padding-bottom: 0 !important;\n  }\n  .pl-md-0,\n  .px-md-0 {\n    padding-left: 0 !important;\n  }\n  .p-md-1 {\n    padding: 0.25rem !important;\n  }\n  .pt-md-1,\n  .py-md-1 {\n    padding-top: 0.25rem !important;\n  }\n  .pr-md-1,\n  .px-md-1 {\n    padding-right: 0.25rem !important;\n  }\n  .pb-md-1,\n  .py-md-1 {\n    padding-bottom: 0.25rem !important;\n  }\n  .pl-md-1,\n  .px-md-1 {\n    padding-left: 0.25rem !important;\n  }\n  .p-md-2 {\n    padding: 0.5rem !important;\n  }\n  .pt-md-2,\n  .py-md-2 {\n    padding-top: 0.5rem !important;\n  }\n  .pr-md-2,\n  .px-md-2 {\n    padding-right: 0.5rem !important;\n  }\n  .pb-md-2,\n  .py-md-2 {\n    padding-bottom: 0.5rem !important;\n  }\n  .pl-md-2,\n  .px-md-2 {\n    padding-left: 0.5rem !important;\n  }\n  .p-md-3 {\n    padding: 1rem !important;\n  }\n  .pt-md-3,\n  .py-md-3 {\n    padding-top: 1rem !important;\n  }\n  .pr-md-3,\n  .px-md-3 {\n    padding-right: 1rem !important;\n  }\n  .pb-md-3,\n  .py-md-3 {\n    padding-bottom: 1rem !important;\n  }\n  .pl-md-3,\n  .px-md-3 {\n    padding-left: 1rem !important;\n  }\n  .p-md-4 {\n    padding: 1.5rem !important;\n  }\n  .pt-md-4,\n  .py-md-4 {\n    padding-top: 1.5rem !important;\n  }\n  .pr-md-4,\n  .px-md-4 {\n    padding-right: 1.5rem !important;\n  }\n  .pb-md-4,\n  .py-md-4 {\n    padding-bottom: 1.5rem !important;\n  }\n  .pl-md-4,\n  .px-md-4 {\n    padding-left: 1.5rem !important;\n  }\n  .p-md-5 {\n    padding: 3rem !important;\n  }\n  .pt-md-5,\n  .py-md-5 {\n    padding-top: 3rem !important;\n  }\n  .pr-md-5,\n  .px-md-5 {\n    padding-right: 3rem !important;\n  }\n  .pb-md-5,\n  .py-md-5 {\n    padding-bottom: 3rem !important;\n  }\n  .pl-md-5,\n  .px-md-5 {\n    padding-left: 3rem !important;\n  }\n  .m-md-n1 {\n    margin: -0.25rem !important;\n  }\n  .mt-md-n1,\n  .my-md-n1 {\n    margin-top: -0.25rem !important;\n  }\n  .mr-md-n1,\n  .mx-md-n1 {\n    margin-right: -0.25rem !important;\n  }\n  .mb-md-n1,\n  .my-md-n1 {\n    margin-bottom: -0.25rem !important;\n  }\n  .ml-md-n1,\n  .mx-md-n1 {\n    margin-left: -0.25rem !important;\n  }\n  .m-md-n2 {\n    margin: -0.5rem !important;\n  }\n  .mt-md-n2,\n  .my-md-n2 {\n    margin-top: -0.5rem !important;\n  }\n  .mr-md-n2,\n  .mx-md-n2 {\n    margin-right: -0.5rem !important;\n  }\n  .mb-md-n2,\n  .my-md-n2 {\n    margin-bottom: -0.5rem !important;\n  }\n  .ml-md-n2,\n  .mx-md-n2 {\n    margin-left: -0.5rem !important;\n  }\n  .m-md-n3 {\n    margin: -1rem !important;\n  }\n  .mt-md-n3,\n  .my-md-n3 {\n    margin-top: -1rem !important;\n  }\n  .mr-md-n3,\n  .mx-md-n3 {\n    margin-right: -1rem !important;\n  }\n  .mb-md-n3,\n  .my-md-n3 {\n    margin-bottom: -1rem !important;\n  }\n  .ml-md-n3,\n  .mx-md-n3 {\n    margin-left: -1rem !important;\n  }\n  .m-md-n4 {\n    margin: -1.5rem !important;\n  }\n  .mt-md-n4,\n  .my-md-n4 {\n    margin-top: -1.5rem !important;\n  }\n  .mr-md-n4,\n  .mx-md-n4 {\n    margin-right: -1.5rem !important;\n  }\n  .mb-md-n4,\n  .my-md-n4 {\n    margin-bottom: -1.5rem !important;\n  }\n  .ml-md-n4,\n  .mx-md-n4 {\n    margin-left: -1.5rem !important;\n  }\n  .m-md-n5 {\n    margin: -3rem !important;\n  }\n  .mt-md-n5,\n  .my-md-n5 {\n    margin-top: -3rem !important;\n  }\n  .mr-md-n5,\n  .mx-md-n5 {\n    margin-right: -3rem !important;\n  }\n  .mb-md-n5,\n  .my-md-n5 {\n    margin-bottom: -3rem !important;\n  }\n  .ml-md-n5,\n  .mx-md-n5 {\n    margin-left: -3rem !important;\n  }\n  .m-md-auto {\n    margin: auto !important;\n  }\n  .mt-md-auto,\n  .my-md-auto {\n    margin-top: auto !important;\n  }\n  .mr-md-auto,\n  .mx-md-auto {\n    margin-right: auto !important;\n  }\n  .mb-md-auto,\n  .my-md-auto {\n    margin-bottom: auto !important;\n  }\n  .ml-md-auto,\n  .mx-md-auto {\n    margin-left: auto !important;\n  }\n}\n\n@media (min-width: 992px) {\n  .m-lg-0 {\n    margin: 0 !important;\n  }\n  .mt-lg-0,\n  .my-lg-0 {\n    margin-top: 0 !important;\n  }\n  .mr-lg-0,\n  .mx-lg-0 {\n    margin-right: 0 !important;\n  }\n  .mb-lg-0,\n  .my-lg-0 {\n    margin-bottom: 0 !important;\n  }\n  .ml-lg-0,\n  .mx-lg-0 {\n    margin-left: 0 !important;\n  }\n  .m-lg-1 {\n    margin: 0.25rem !important;\n  }\n  .mt-lg-1,\n  .my-lg-1 {\n    margin-top: 0.25rem !important;\n  }\n  .mr-lg-1,\n  .mx-lg-1 {\n    margin-right: 0.25rem !important;\n  }\n  .mb-lg-1,\n  .my-lg-1 {\n    margin-bottom: 0.25rem !important;\n  }\n  .ml-lg-1,\n  .mx-lg-1 {\n    margin-left: 0.25rem !important;\n  }\n  .m-lg-2 {\n    margin: 0.5rem !important;\n  }\n  .mt-lg-2,\n  .my-lg-2 {\n    margin-top: 0.5rem !important;\n  }\n  .mr-lg-2,\n  .mx-lg-2 {\n    margin-right: 0.5rem !important;\n  }\n  .mb-lg-2,\n  .my-lg-2 {\n    margin-bottom: 0.5rem !important;\n  }\n  .ml-lg-2,\n  .mx-lg-2 {\n    margin-left: 0.5rem !important;\n  }\n  .m-lg-3 {\n    margin: 1rem !important;\n  }\n  .mt-lg-3,\n  .my-lg-3 {\n    margin-top: 1rem !important;\n  }\n  .mr-lg-3,\n  .mx-lg-3 {\n    margin-right: 1rem !important;\n  }\n  .mb-lg-3,\n  .my-lg-3 {\n    margin-bottom: 1rem !important;\n  }\n  .ml-lg-3,\n  .mx-lg-3 {\n    margin-left: 1rem !important;\n  }\n  .m-lg-4 {\n    margin: 1.5rem !important;\n  }\n  .mt-lg-4,\n  .my-lg-4 {\n    margin-top: 1.5rem !important;\n  }\n  .mr-lg-4,\n  .mx-lg-4 {\n    margin-right: 1.5rem !important;\n  }\n  .mb-lg-4,\n  .my-lg-4 {\n    margin-bottom: 1.5rem !important;\n  }\n  .ml-lg-4,\n  .mx-lg-4 {\n    margin-left: 1.5rem !important;\n  }\n  .m-lg-5 {\n    margin: 3rem !important;\n  }\n  .mt-lg-5,\n  .my-lg-5 {\n    margin-top: 3rem !important;\n  }\n  .mr-lg-5,\n  .mx-lg-5 {\n    margin-right: 3rem !important;\n  }\n  .mb-lg-5,\n  .my-lg-5 {\n    margin-bottom: 3rem !important;\n  }\n  .ml-lg-5,\n  .mx-lg-5 {\n    margin-left: 3rem !important;\n  }\n  .p-lg-0 {\n    padding: 0 !important;\n  }\n  .pt-lg-0,\n  .py-lg-0 {\n    padding-top: 0 !important;\n  }\n  .pr-lg-0,\n  .px-lg-0 {\n    padding-right: 0 !important;\n  }\n  .pb-lg-0,\n  .py-lg-0 {\n    padding-bottom: 0 !important;\n  }\n  .pl-lg-0,\n  .px-lg-0 {\n    padding-left: 0 !important;\n  }\n  .p-lg-1 {\n    padding: 0.25rem !important;\n  }\n  .pt-lg-1,\n  .py-lg-1 {\n    padding-top: 0.25rem !important;\n  }\n  .pr-lg-1,\n  .px-lg-1 {\n    padding-right: 0.25rem !important;\n  }\n  .pb-lg-1,\n  .py-lg-1 {\n    padding-bottom: 0.25rem !important;\n  }\n  .pl-lg-1,\n  .px-lg-1 {\n    padding-left: 0.25rem !important;\n  }\n  .p-lg-2 {\n    padding: 0.5rem !important;\n  }\n  .pt-lg-2,\n  .py-lg-2 {\n    padding-top: 0.5rem !important;\n  }\n  .pr-lg-2,\n  .px-lg-2 {\n    padding-right: 0.5rem !important;\n  }\n  .pb-lg-2,\n  .py-lg-2 {\n    padding-bottom: 0.5rem !important;\n  }\n  .pl-lg-2,\n  .px-lg-2 {\n    padding-left: 0.5rem !important;\n  }\n  .p-lg-3 {\n    padding: 1rem !important;\n  }\n  .pt-lg-3,\n  .py-lg-3 {\n    padding-top: 1rem !important;\n  }\n  .pr-lg-3,\n  .px-lg-3 {\n    padding-right: 1rem !important;\n  }\n  .pb-lg-3,\n  .py-lg-3 {\n    padding-bottom: 1rem !important;\n  }\n  .pl-lg-3,\n  .px-lg-3 {\n    padding-left: 1rem !important;\n  }\n  .p-lg-4 {\n    padding: 1.5rem !important;\n  }\n  .pt-lg-4,\n  .py-lg-4 {\n    padding-top: 1.5rem !important;\n  }\n  .pr-lg-4,\n  .px-lg-4 {\n    padding-right: 1.5rem !important;\n  }\n  .pb-lg-4,\n  .py-lg-4 {\n    padding-bottom: 1.5rem !important;\n  }\n  .pl-lg-4,\n  .px-lg-4 {\n    padding-left: 1.5rem !important;\n  }\n  .p-lg-5 {\n    padding: 3rem !important;\n  }\n  .pt-lg-5,\n  .py-lg-5 {\n    padding-top: 3rem !important;\n  }\n  .pr-lg-5,\n  .px-lg-5 {\n    padding-right: 3rem !important;\n  }\n  .pb-lg-5,\n  .py-lg-5 {\n    padding-bottom: 3rem !important;\n  }\n  .pl-lg-5,\n  .px-lg-5 {\n    padding-left: 3rem !important;\n  }\n  .m-lg-n1 {\n    margin: -0.25rem !important;\n  }\n  .mt-lg-n1,\n  .my-lg-n1 {\n    margin-top: -0.25rem !important;\n  }\n  .mr-lg-n1,\n  .mx-lg-n1 {\n    margin-right: -0.25rem !important;\n  }\n  .mb-lg-n1,\n  .my-lg-n1 {\n    margin-bottom: -0.25rem !important;\n  }\n  .ml-lg-n1,\n  .mx-lg-n1 {\n    margin-left: -0.25rem !important;\n  }\n  .m-lg-n2 {\n    margin: -0.5rem !important;\n  }\n  .mt-lg-n2,\n  .my-lg-n2 {\n    margin-top: -0.5rem !important;\n  }\n  .mr-lg-n2,\n  .mx-lg-n2 {\n    margin-right: -0.5rem !important;\n  }\n  .mb-lg-n2,\n  .my-lg-n2 {\n    margin-bottom: -0.5rem !important;\n  }\n  .ml-lg-n2,\n  .mx-lg-n2 {\n    margin-left: -0.5rem !important;\n  }\n  .m-lg-n3 {\n    margin: -1rem !important;\n  }\n  .mt-lg-n3,\n  .my-lg-n3 {\n    margin-top: -1rem !important;\n  }\n  .mr-lg-n3,\n  .mx-lg-n3 {\n    margin-right: -1rem !important;\n  }\n  .mb-lg-n3,\n  .my-lg-n3 {\n    margin-bottom: -1rem !important;\n  }\n  .ml-lg-n3,\n  .mx-lg-n3 {\n    margin-left: -1rem !important;\n  }\n  .m-lg-n4 {\n    margin: -1.5rem !important;\n  }\n  .mt-lg-n4,\n  .my-lg-n4 {\n    margin-top: -1.5rem !important;\n  }\n  .mr-lg-n4,\n  .mx-lg-n4 {\n    margin-right: -1.5rem !important;\n  }\n  .mb-lg-n4,\n  .my-lg-n4 {\n    margin-bottom: -1.5rem !important;\n  }\n  .ml-lg-n4,\n  .mx-lg-n4 {\n    margin-left: -1.5rem !important;\n  }\n  .m-lg-n5 {\n    margin: -3rem !important;\n  }\n  .mt-lg-n5,\n  .my-lg-n5 {\n    margin-top: -3rem !important;\n  }\n  .mr-lg-n5,\n  .mx-lg-n5 {\n    margin-right: -3rem !important;\n  }\n  .mb-lg-n5,\n  .my-lg-n5 {\n    margin-bottom: -3rem !important;\n  }\n  .ml-lg-n5,\n  .mx-lg-n5 {\n    margin-left: -3rem !important;\n  }\n  .m-lg-auto {\n    margin: auto !important;\n  }\n  .mt-lg-auto,\n  .my-lg-auto {\n    margin-top: auto !important;\n  }\n  .mr-lg-auto,\n  .mx-lg-auto {\n    margin-right: auto !important;\n  }\n  .mb-lg-auto,\n  .my-lg-auto {\n    margin-bottom: auto !important;\n  }\n  .ml-lg-auto,\n  .mx-lg-auto {\n    margin-left: auto !important;\n  }\n}\n\n@media (min-width: 1200px) {\n  .m-xl-0 {\n    margin: 0 !important;\n  }\n  .mt-xl-0,\n  .my-xl-0 {\n    margin-top: 0 !important;\n  }\n  .mr-xl-0,\n  .mx-xl-0 {\n    margin-right: 0 !important;\n  }\n  .mb-xl-0,\n  .my-xl-0 {\n    margin-bottom: 0 !important;\n  }\n  .ml-xl-0,\n  .mx-xl-0 {\n    margin-left: 0 !important;\n  }\n  .m-xl-1 {\n    margin: 0.25rem !important;\n  }\n  .mt-xl-1,\n  .my-xl-1 {\n    margin-top: 0.25rem !important;\n  }\n  .mr-xl-1,\n  .mx-xl-1 {\n    margin-right: 0.25rem !important;\n  }\n  .mb-xl-1,\n  .my-xl-1 {\n    margin-bottom: 0.25rem !important;\n  }\n  .ml-xl-1,\n  .mx-xl-1 {\n    margin-left: 0.25rem !important;\n  }\n  .m-xl-2 {\n    margin: 0.5rem !important;\n  }\n  .mt-xl-2,\n  .my-xl-2 {\n    margin-top: 0.5rem !important;\n  }\n  .mr-xl-2,\n  .mx-xl-2 {\n    margin-right: 0.5rem !important;\n  }\n  .mb-xl-2,\n  .my-xl-2 {\n    margin-bottom: 0.5rem !important;\n  }\n  .ml-xl-2,\n  .mx-xl-2 {\n    margin-left: 0.5rem !important;\n  }\n  .m-xl-3 {\n    margin: 1rem !important;\n  }\n  .mt-xl-3,\n  .my-xl-3 {\n    margin-top: 1rem !important;\n  }\n  .mr-xl-3,\n  .mx-xl-3 {\n    margin-right: 1rem !important;\n  }\n  .mb-xl-3,\n  .my-xl-3 {\n    margin-bottom: 1rem !important;\n  }\n  .ml-xl-3,\n  .mx-xl-3 {\n    margin-left: 1rem !important;\n  }\n  .m-xl-4 {\n    margin: 1.5rem !important;\n  }\n  .mt-xl-4,\n  .my-xl-4 {\n    margin-top: 1.5rem !important;\n  }\n  .mr-xl-4,\n  .mx-xl-4 {\n    margin-right: 1.5rem !important;\n  }\n  .mb-xl-4,\n  .my-xl-4 {\n    margin-bottom: 1.5rem !important;\n  }\n  .ml-xl-4,\n  .mx-xl-4 {\n    margin-left: 1.5rem !important;\n  }\n  .m-xl-5 {\n    margin: 3rem !important;\n  }\n  .mt-xl-5,\n  .my-xl-5 {\n    margin-top: 3rem !important;\n  }\n  .mr-xl-5,\n  .mx-xl-5 {\n    margin-right: 3rem !important;\n  }\n  .mb-xl-5,\n  .my-xl-5 {\n    margin-bottom: 3rem !important;\n  }\n  .ml-xl-5,\n  .mx-xl-5 {\n    margin-left: 3rem !important;\n  }\n  .p-xl-0 {\n    padding: 0 !important;\n  }\n  .pt-xl-0,\n  .py-xl-0 {\n    padding-top: 0 !important;\n  }\n  .pr-xl-0,\n  .px-xl-0 {\n    padding-right: 0 !important;\n  }\n  .pb-xl-0,\n  .py-xl-0 {\n    padding-bottom: 0 !important;\n  }\n  .pl-xl-0,\n  .px-xl-0 {\n    padding-left: 0 !important;\n  }\n  .p-xl-1 {\n    padding: 0.25rem !important;\n  }\n  .pt-xl-1,\n  .py-xl-1 {\n    padding-top: 0.25rem !important;\n  }\n  .pr-xl-1,\n  .px-xl-1 {\n    padding-right: 0.25rem !important;\n  }\n  .pb-xl-1,\n  .py-xl-1 {\n    padding-bottom: 0.25rem !important;\n  }\n  .pl-xl-1,\n  .px-xl-1 {\n    padding-left: 0.25rem !important;\n  }\n  .p-xl-2 {\n    padding: 0.5rem !important;\n  }\n  .pt-xl-2,\n  .py-xl-2 {\n    padding-top: 0.5rem !important;\n  }\n  .pr-xl-2,\n  .px-xl-2 {\n    padding-right: 0.5rem !important;\n  }\n  .pb-xl-2,\n  .py-xl-2 {\n    padding-bottom: 0.5rem !important;\n  }\n  .pl-xl-2,\n  .px-xl-2 {\n    padding-left: 0.5rem !important;\n  }\n  .p-xl-3 {\n    padding: 1rem !important;\n  }\n  .pt-xl-3,\n  .py-xl-3 {\n    padding-top: 1rem !important;\n  }\n  .pr-xl-3,\n  .px-xl-3 {\n    padding-right: 1rem !important;\n  }\n  .pb-xl-3,\n  .py-xl-3 {\n    padding-bottom: 1rem !important;\n  }\n  .pl-xl-3,\n  .px-xl-3 {\n    padding-left: 1rem !important;\n  }\n  .p-xl-4 {\n    padding: 1.5rem !important;\n  }\n  .pt-xl-4,\n  .py-xl-4 {\n    padding-top: 1.5rem !important;\n  }\n  .pr-xl-4,\n  .px-xl-4 {\n    padding-right: 1.5rem !important;\n  }\n  .pb-xl-4,\n  .py-xl-4 {\n    padding-bottom: 1.5rem !important;\n  }\n  .pl-xl-4,\n  .px-xl-4 {\n    padding-left: 1.5rem !important;\n  }\n  .p-xl-5 {\n    padding: 3rem !important;\n  }\n  .pt-xl-5,\n  .py-xl-5 {\n    padding-top: 3rem !important;\n  }\n  .pr-xl-5,\n  .px-xl-5 {\n    padding-right: 3rem !important;\n  }\n  .pb-xl-5,\n  .py-xl-5 {\n    padding-bottom: 3rem !important;\n  }\n  .pl-xl-5,\n  .px-xl-5 {\n    padding-left: 3rem !important;\n  }\n  .m-xl-n1 {\n    margin: -0.25rem !important;\n  }\n  .mt-xl-n1,\n  .my-xl-n1 {\n    margin-top: -0.25rem !important;\n  }\n  .mr-xl-n1,\n  .mx-xl-n1 {\n    margin-right: -0.25rem !important;\n  }\n  .mb-xl-n1,\n  .my-xl-n1 {\n    margin-bottom: -0.25rem !important;\n  }\n  .ml-xl-n1,\n  .mx-xl-n1 {\n    margin-left: -0.25rem !important;\n  }\n  .m-xl-n2 {\n    margin: -0.5rem !important;\n  }\n  .mt-xl-n2,\n  .my-xl-n2 {\n    margin-top: -0.5rem !important;\n  }\n  .mr-xl-n2,\n  .mx-xl-n2 {\n    margin-right: -0.5rem !important;\n  }\n  .mb-xl-n2,\n  .my-xl-n2 {\n    margin-bottom: -0.5rem !important;\n  }\n  .ml-xl-n2,\n  .mx-xl-n2 {\n    margin-left: -0.5rem !important;\n  }\n  .m-xl-n3 {\n    margin: -1rem !important;\n  }\n  .mt-xl-n3,\n  .my-xl-n3 {\n    margin-top: -1rem !important;\n  }\n  .mr-xl-n3,\n  .mx-xl-n3 {\n    margin-right: -1rem !important;\n  }\n  .mb-xl-n3,\n  .my-xl-n3 {\n    margin-bottom: -1rem !important;\n  }\n  .ml-xl-n3,\n  .mx-xl-n3 {\n    margin-left: -1rem !important;\n  }\n  .m-xl-n4 {\n    margin: -1.5rem !important;\n  }\n  .mt-xl-n4,\n  .my-xl-n4 {\n    margin-top: -1.5rem !important;\n  }\n  .mr-xl-n4,\n  .mx-xl-n4 {\n    margin-right: -1.5rem !important;\n  }\n  .mb-xl-n4,\n  .my-xl-n4 {\n    margin-bottom: -1.5rem !important;\n  }\n  .ml-xl-n4,\n  .mx-xl-n4 {\n    margin-left: -1.5rem !important;\n  }\n  .m-xl-n5 {\n    margin: -3rem !important;\n  }\n  .mt-xl-n5,\n  .my-xl-n5 {\n    margin-top: -3rem !important;\n  }\n  .mr-xl-n5,\n  .mx-xl-n5 {\n    margin-right: -3rem !important;\n  }\n  .mb-xl-n5,\n  .my-xl-n5 {\n    margin-bottom: -3rem !important;\n  }\n  .ml-xl-n5,\n  .mx-xl-n5 {\n    margin-left: -3rem !important;\n  }\n  .m-xl-auto {\n    margin: auto !important;\n  }\n  .mt-xl-auto,\n  .my-xl-auto {\n    margin-top: auto !important;\n  }\n  .mr-xl-auto,\n  .mx-xl-auto {\n    margin-right: auto !important;\n  }\n  .mb-xl-auto,\n  .my-xl-auto {\n    margin-bottom: auto !important;\n  }\n  .ml-xl-auto,\n  .mx-xl-auto {\n    margin-left: auto !important;\n  }\n}\n\n.text-monospace {\n  font-family: SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\", \"Courier New\", monospace !important;\n}\n\n.text-justify {\n  text-align: justify !important;\n}\n\n.text-wrap {\n  white-space: normal !important;\n}\n\n.text-nowrap {\n  white-space: nowrap !important;\n}\n\n.text-truncate {\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n\n.text-left {\n  text-align: left !important;\n}\n\n.text-right {\n  text-align: right !important;\n}\n\n.text-center {\n  text-align: center !important;\n}\n\n@media (min-width: 576px) {\n  .text-sm-left {\n    text-align: left !important;\n  }\n  .text-sm-right {\n    text-align: right !important;\n  }\n  .text-sm-center {\n    text-align: center !important;\n  }\n}\n\n@media (min-width: 768px) {\n  .text-md-left {\n    text-align: left !important;\n  }\n  .text-md-right {\n    text-align: right !important;\n  }\n  .text-md-center {\n    text-align: center !important;\n  }\n}\n\n@media (min-width: 992px) {\n  .text-lg-left {\n    text-align: left !important;\n  }\n  .text-lg-right {\n    text-align: right !important;\n  }\n  .text-lg-center {\n    text-align: center !important;\n  }\n}\n\n@media (min-width: 1200px) {\n  .text-xl-left {\n    text-align: left !important;\n  }\n  .text-xl-right {\n    text-align: right !important;\n  }\n  .text-xl-center {\n    text-align: center !important;\n  }\n}\n\n.text-lowercase {\n  text-transform: lowercase !important;\n}\n\n.text-uppercase {\n  text-transform: uppercase !important;\n}\n\n.text-capitalize {\n  text-transform: capitalize !important;\n}\n\n.font-weight-light {\n  font-weight: 300 !important;\n}\n\n.font-weight-lighter {\n  font-weight: lighter !important;\n}\n\n.font-weight-normal {\n  font-weight: 400 !important;\n}\n\n.font-weight-bold {\n  font-weight: 700 !important;\n}\n\n.font-weight-bolder {\n  font-weight: bolder !important;\n}\n\n.font-italic {\n  font-style: italic !important;\n}\n\n.text-white {\n  color: #fff !important;\n}\n\n.text-primary {\n  color: #007bff !important;\n}\n\na.text-primary:hover, a.text-primary:focus {\n  color: #0056b3 !important;\n}\n\n.text-secondary {\n  color: #6c757d !important;\n}\n\na.text-secondary:hover, a.text-secondary:focus {\n  color: #494f54 !important;\n}\n\n.text-success {\n  color: #28a745 !important;\n}\n\na.text-success:hover, a.text-success:focus {\n  color: #19692c !important;\n}\n\n.text-info {\n  color: #17a2b8 !important;\n}\n\na.text-info:hover, a.text-info:focus {\n  color: #0f6674 !important;\n}\n\n.text-warning {\n  color: #ffc107 !important;\n}\n\na.text-warning:hover, a.text-warning:focus {\n  color: #ba8b00 !important;\n}\n\n.text-danger {\n  color: #dc3545 !important;\n}\n\na.text-danger:hover, a.text-danger:focus {\n  color: #a71d2a !important;\n}\n\n.text-light {\n  color: #f8f9fa !important;\n}\n\na.text-light:hover, a.text-light:focus {\n  color: #cbd3da !important;\n}\n\n.text-dark {\n  color: #343a40 !important;\n}\n\na.text-dark:hover, a.text-dark:focus {\n  color: #121416 !important;\n}\n\n.text-body {\n  color: #212529 !important;\n}\n\n.text-muted {\n  color: #6c757d !important;\n}\n\n.text-black-50 {\n  color: rgba(0, 0, 0, 0.5) !important;\n}\n\n.text-white-50 {\n  color: rgba(255, 255, 255, 0.5) !important;\n}\n\n.text-hide {\n  font: 0/0 a;\n  color: transparent;\n  text-shadow: none;\n  background-color: transparent;\n  border: 0;\n}\n\n.text-decoration-none {\n  text-decoration: none !important;\n}\n\n.text-break {\n  word-break: break-word !important;\n  overflow-wrap: break-word !important;\n}\n\n.text-reset {\n  color: inherit !important;\n}\n\n.visible {\n  visibility: visible !important;\n}\n\n.invisible {\n  visibility: hidden !important;\n}\n\n@media print {\n  *,\n  *::before,\n  *::after {\n    text-shadow: none !important;\n    box-shadow: none !important;\n  }\n  a:not(.btn) {\n    text-decoration: underline;\n  }\n  abbr[title]::after {\n    content: \" (\" attr(title) \")\";\n  }\n  pre {\n    white-space: pre-wrap !important;\n  }\n  pre,\n  blockquote {\n    border: 1px solid #adb5bd;\n    page-break-inside: avoid;\n  }\n  thead {\n    display: table-header-group;\n  }\n  tr,\n  img {\n    page-break-inside: avoid;\n  }\n  p,\n  h2,\n  h3 {\n    orphans: 3;\n    widows: 3;\n  }\n  h2,\n  h3 {\n    page-break-after: avoid;\n  }\n  @page {\n    size: a3;\n  }\n  body {\n    min-width: 992px !important;\n  }\n  .container {\n    min-width: 992px !important;\n  }\n  .navbar {\n    display: none;\n  }\n  .badge {\n    border: 1px solid #000;\n  }\n  .table {\n    border-collapse: collapse !important;\n  }\n  .table td,\n  .table th {\n    background-color: #fff !important;\n  }\n  .table-bordered th,\n  .table-bordered td {\n    border: 1px solid #dee2e6 !important;\n  }\n  .table-dark {\n    color: inherit;\n  }\n  .table-dark th,\n  .table-dark td,\n  .table-dark thead th,\n  .table-dark tbody + tbody {\n    border-color: #dee2e6;\n  }\n  .table .thead-dark th {\n    color: inherit;\n    border-color: #dee2e6;\n  }\n}\n\n/*# sourceMappingURL=bootstrap.css.map */","// Hover mixin and `$enable-hover-media-query` are deprecated.\n//\n// Originally added during our alphas and maintained during betas, this mixin was\n// designed to prevent `:hover` stickiness on iOS-an issue where hover styles\n// would persist after initial touch.\n//\n// For backward compatibility, we've kept these mixins and updated them to\n// always return their regular pseudo-classes instead of a shimmed media query.\n//\n// Issue: https://github.com/twbs/bootstrap/issues/25195\n\n@mixin hover {\n  &:hover { @content; }\n}\n\n@mixin hover-focus {\n  &:hover,\n  &:focus {\n    @content;\n  }\n}\n\n@mixin plain-hover-focus {\n  &,\n  &:hover,\n  &:focus {\n    @content;\n  }\n}\n\n@mixin hover-focus-active {\n  &:hover,\n  &:focus,\n  &:active {\n    @content;\n  }\n}\n","// stylelint-disable declaration-no-important, selector-list-comma-newline-after\n\n//\n// Headings\n//\n\nh1, h2, h3, h4, h5, h6,\n.h1, .h2, .h3, .h4, .h5, .h6 {\n  margin-bottom: $headings-margin-bottom;\n  font-family: $headings-font-family;\n  font-weight: $headings-font-weight;\n  line-height: $headings-line-height;\n  color: $headings-color;\n}\n\nh1, .h1 { @include font-size($h1-font-size); }\nh2, .h2 { @include font-size($h2-font-size); }\nh3, .h3 { @include font-size($h3-font-size); }\nh4, .h4 { @include font-size($h4-font-size); }\nh5, .h5 { @include font-size($h5-font-size); }\nh6, .h6 { @include font-size($h6-font-size); }\n\n.lead {\n  @include font-size($lead-font-size);\n  font-weight: $lead-font-weight;\n}\n\n// Type display classes\n.display-1 {\n  @include font-size($display1-size);\n  font-weight: $display1-weight;\n  line-height: $display-line-height;\n}\n.display-2 {\n  @include font-size($display2-size);\n  font-weight: $display2-weight;\n  line-height: $display-line-height;\n}\n.display-3 {\n  @include font-size($display3-size);\n  font-weight: $display3-weight;\n  line-height: $display-line-height;\n}\n.display-4 {\n  @include font-size($display4-size);\n  font-weight: $display4-weight;\n  line-height: $display-line-height;\n}\n\n\n//\n// Horizontal rules\n//\n\nhr {\n  margin-top: $hr-margin-y;\n  margin-bottom: $hr-margin-y;\n  border: 0;\n  border-top: $hr-border-width solid $hr-border-color;\n}\n\n\n//\n// Emphasis\n//\n\nsmall,\n.small {\n  @include font-size($small-font-size);\n  font-weight: $font-weight-normal;\n}\n\nmark,\n.mark {\n  padding: $mark-padding;\n  background-color: $mark-bg;\n}\n\n\n//\n// Lists\n//\n\n.list-unstyled {\n  @include list-unstyled;\n}\n\n// Inline turns list items into inline-block\n.list-inline {\n  @include list-unstyled;\n}\n.list-inline-item {\n  display: inline-block;\n\n  &:not(:last-child) {\n    margin-right: $list-inline-padding;\n  }\n}\n\n\n//\n// Misc\n//\n\n// Builds on `abbr`\n.initialism {\n  @include font-size(90%);\n  text-transform: uppercase;\n}\n\n// Blockquotes\n.blockquote {\n  margin-bottom: $spacer;\n  @include font-size($blockquote-font-size);\n}\n\n.blockquote-footer {\n  display: block;\n  @include font-size($blockquote-small-font-size);\n  color: $blockquote-small-color;\n\n  &::before {\n    content: \"\\2014\\00A0\"; // em dash, nbsp\n  }\n}\n","// Lists\n\n// Unstyled keeps list items block level, just removes default browser padding and list-style\n@mixin list-unstyled {\n  padding-left: 0;\n  list-style: none;\n}\n","// Responsive images (ensure images don't scale beyond their parents)\n//\n// This is purposefully opt-in via an explicit class rather than being the default for all `<img>`s.\n// We previously tried the \"images are responsive by default\" approach in Bootstrap v2,\n// and abandoned it in Bootstrap v3 because it breaks lots of third-party widgets (including Google Maps)\n// which weren't expecting the images within themselves to be involuntarily resized.\n// See also https://github.com/twbs/bootstrap/issues/18178\n.img-fluid {\n  @include img-fluid;\n}\n\n\n// Image thumbnails\n.img-thumbnail {\n  padding: $thumbnail-padding;\n  background-color: $thumbnail-bg;\n  border: $thumbnail-border-width solid $thumbnail-border-color;\n  @include border-radius($thumbnail-border-radius);\n  @include box-shadow($thumbnail-box-shadow);\n\n  // Keep them at most 100% wide\n  @include img-fluid;\n}\n\n//\n// Figures\n//\n\n.figure {\n  // Ensures the caption's text aligns with the image.\n  display: inline-block;\n}\n\n.figure-img {\n  margin-bottom: $spacer / 2;\n  line-height: 1;\n}\n\n.figure-caption {\n  @include font-size($figure-caption-font-size);\n  color: $figure-caption-color;\n}\n","// Image Mixins\n// - Responsive image\n// - Retina image\n\n\n// Responsive image\n//\n// Keep images from scaling beyond the width of their parents.\n\n@mixin img-fluid {\n  // Part 1: Set a maximum relative to the parent\n  max-width: 100%;\n  // Part 2: Override the height to auto, otherwise images will be stretched\n  // when setting a width and height attribute on the img element.\n  height: auto;\n}\n\n\n// Retina image\n//\n// Short retina mixin for setting background-image and -size.\n\n@mixin img-retina($file-1x, $file-2x, $width-1x, $height-1x) {\n  background-image: url($file-1x);\n\n  // Autoprefixer takes care of adding -webkit-min-device-pixel-ratio and -o-min-device-pixel-ratio,\n  // but doesn't convert dppx=>dpi.\n  // There's no such thing as unprefixed min-device-pixel-ratio since it's nonstandard.\n  // Compatibility info: https://caniuse.com/#feat=css-media-resolution\n  @media only screen and (min-resolution: 192dpi), // IE9-11 don't support dppx\n    only screen and (min-resolution: 2dppx) { // Standardized\n    background-image: url($file-2x);\n    background-size: $width-1x $height-1x;\n  }\n  @include deprecate(\"`img-retina()`\", \"v4.3.0\", \"v5\");\n}\n","// stylelint-disable property-blacklist\n// Single side border-radius\n\n@mixin border-radius($radius: $border-radius, $fallback-border-radius: false) {\n  @if $enable-rounded {\n    border-radius: $radius;\n  }\n  @else if $fallback-border-radius != false {\n    border-radius: $fallback-border-radius;\n  }\n}\n\n@mixin border-top-radius($radius) {\n  @if $enable-rounded {\n    border-top-left-radius: $radius;\n    border-top-right-radius: $radius;\n  }\n}\n\n@mixin border-right-radius($radius) {\n  @if $enable-rounded {\n    border-top-right-radius: $radius;\n    border-bottom-right-radius: $radius;\n  }\n}\n\n@mixin border-bottom-radius($radius) {\n  @if $enable-rounded {\n    border-bottom-right-radius: $radius;\n    border-bottom-left-radius: $radius;\n  }\n}\n\n@mixin border-left-radius($radius) {\n  @if $enable-rounded {\n    border-top-left-radius: $radius;\n    border-bottom-left-radius: $radius;\n  }\n}\n\n@mixin border-top-left-radius($radius) {\n  @if $enable-rounded {\n    border-top-left-radius: $radius;\n  }\n}\n\n@mixin border-top-right-radius($radius) {\n  @if $enable-rounded {\n    border-top-right-radius: $radius;\n  }\n}\n\n@mixin border-bottom-right-radius($radius) {\n  @if $enable-rounded {\n    border-bottom-right-radius: $radius;\n  }\n}\n\n@mixin border-bottom-left-radius($radius) {\n  @if $enable-rounded {\n    border-bottom-left-radius: $radius;\n  }\n}\n","// Inline code\ncode {\n  @include font-size($code-font-size);\n  color: $code-color;\n  word-break: break-word;\n\n  // Streamline the style when inside anchors to avoid broken underline and more\n  a > & {\n    color: inherit;\n  }\n}\n\n// User input typically entered via keyboard\nkbd {\n  padding: $kbd-padding-y $kbd-padding-x;\n  @include font-size($kbd-font-size);\n  color: $kbd-color;\n  background-color: $kbd-bg;\n  @include border-radius($border-radius-sm);\n  @include box-shadow($kbd-box-shadow);\n\n  kbd {\n    padding: 0;\n    @include font-size(100%);\n    font-weight: $nested-kbd-font-weight;\n    @include box-shadow(none);\n  }\n}\n\n// Blocks of code\npre {\n  display: block;\n  @include font-size($code-font-size);\n  color: $pre-color;\n\n  // Account for some code outputs that place code tags in pre tags\n  code {\n    @include font-size(inherit);\n    color: inherit;\n    word-break: normal;\n  }\n}\n\n// Enable scrollable blocks of code\n.pre-scrollable {\n  max-height: $pre-scrollable-max-height;\n  overflow-y: scroll;\n}\n","// Container widths\n//\n// Set the container width, and override it for fixed navbars in media queries.\n\n@if $enable-grid-classes {\n  .container {\n    @include make-container();\n    @include make-container-max-widths();\n  }\n}\n\n// Fluid container\n//\n// Utilizes the mixin meant for fixed width containers, but with 100% width for\n// fluid, full width layouts.\n\n@if $enable-grid-classes {\n  .container-fluid {\n    @include make-container();\n  }\n}\n\n// Row\n//\n// Rows contain and clear the floats of your columns.\n\n@if $enable-grid-classes {\n  .row {\n    @include make-row();\n  }\n\n  // Remove the negative margin from default .row, then the horizontal padding\n  // from all immediate children columns (to prevent runaway style inheritance).\n  .no-gutters {\n    margin-right: 0;\n    margin-left: 0;\n\n    > .col,\n    > [class*=\"col-\"] {\n      padding-right: 0;\n      padding-left: 0;\n    }\n  }\n}\n\n// Columns\n//\n// Common styles for small and large grid columns\n\n@if $enable-grid-classes {\n  @include make-grid-columns();\n}\n","/// Grid system\n//\n// Generate semantic grid columns with these mixins.\n\n@mixin make-container($gutter: $grid-gutter-width) {\n  width: 100%;\n  padding-right: $gutter / 2;\n  padding-left: $gutter / 2;\n  margin-right: auto;\n  margin-left: auto;\n}\n\n\n// For each breakpoint, define the maximum width of the container in a media query\n@mixin make-container-max-widths($max-widths: $container-max-widths, $breakpoints: $grid-breakpoints) {\n  @each $breakpoint, $container-max-width in $max-widths {\n    @include media-breakpoint-up($breakpoint, $breakpoints) {\n      max-width: $container-max-width;\n    }\n  }\n}\n\n@mixin make-row($gutter: $grid-gutter-width) {\n  display: flex;\n  flex-wrap: wrap;\n  margin-right: -$gutter / 2;\n  margin-left: -$gutter / 2;\n}\n\n@mixin make-col-ready($gutter: $grid-gutter-width) {\n  position: relative;\n  // Prevent columns from becoming too narrow when at smaller grid tiers by\n  // always setting `width: 100%;`. This works because we use `flex` values\n  // later on to override this initial width.\n  width: 100%;\n  padding-right: $gutter / 2;\n  padding-left: $gutter / 2;\n}\n\n@mixin make-col($size, $columns: $grid-columns) {\n  flex: 0 0 percentage($size / $columns);\n  // Add a `max-width` to ensure content within each column does not blow out\n  // the width of the column. Applies to IE10+ and Firefox. Chrome and Safari\n  // do not appear to require this.\n  max-width: percentage($size / $columns);\n}\n\n@mixin make-col-offset($size, $columns: $grid-columns) {\n  $num: $size / $columns;\n  margin-left: if($num == 0, 0, percentage($num));\n}\n","// Breakpoint viewport sizes and media queries.\n//\n// Breakpoints are defined as a map of (name: minimum width), order from small to large:\n//\n//    (xs: 0, sm: 576px, md: 768px, lg: 992px, xl: 1200px)\n//\n// The map defined in the `$grid-breakpoints` global variable is used as the `$breakpoints` argument by default.\n\n// Name of the next breakpoint, or null for the last breakpoint.\n//\n//    >> breakpoint-next(sm)\n//    md\n//    >> breakpoint-next(sm, (xs: 0, sm: 576px, md: 768px, lg: 992px, xl: 1200px))\n//    md\n//    >> breakpoint-next(sm, $breakpoint-names: (xs sm md lg xl))\n//    md\n@function breakpoint-next($name, $breakpoints: $grid-breakpoints, $breakpoint-names: map-keys($breakpoints)) {\n  $n: index($breakpoint-names, $name);\n  @return if($n != null and $n < length($breakpoint-names), nth($breakpoint-names, $n + 1), null);\n}\n\n// Minimum breakpoint width. Null for the smallest (first) breakpoint.\n//\n//    >> breakpoint-min(sm, (xs: 0, sm: 576px, md: 768px, lg: 992px, xl: 1200px))\n//    576px\n@function breakpoint-min($name, $breakpoints: $grid-breakpoints) {\n  $min: map-get($breakpoints, $name);\n  @return if($min != 0, $min, null);\n}\n\n// Maximum breakpoint width. Null for the largest (last) breakpoint.\n// The maximum value is calculated as the minimum of the next one less 0.02px\n// to work around the limitations of `min-` and `max-` prefixes and viewports with fractional widths.\n// See https://www.w3.org/TR/mediaqueries-4/#mq-min-max\n// Uses 0.02px rather than 0.01px to work around a current rounding bug in Safari.\n// See https://bugs.webkit.org/show_bug.cgi?id=178261\n//\n//    >> breakpoint-max(sm, (xs: 0, sm: 576px, md: 768px, lg: 992px, xl: 1200px))\n//    767.98px\n@function breakpoint-max($name, $breakpoints: $grid-breakpoints) {\n  $next: breakpoint-next($name, $breakpoints);\n  @return if($next, breakpoint-min($next, $breakpoints) - .02, null);\n}\n\n// Returns a blank string if smallest breakpoint, otherwise returns the name with a dash in front.\n// Useful for making responsive utilities.\n//\n//    >> breakpoint-infix(xs, (xs: 0, sm: 576px, md: 768px, lg: 992px, xl: 1200px))\n//    \"\"  (Returns a blank string)\n//    >> breakpoint-infix(sm, (xs: 0, sm: 576px, md: 768px, lg: 992px, xl: 1200px))\n//    \"-sm\"\n@function breakpoint-infix($name, $breakpoints: $grid-breakpoints) {\n  @return if(breakpoint-min($name, $breakpoints) == null, \"\", \"-#{$name}\");\n}\n\n// Media of at least the minimum breakpoint width. No query for the smallest breakpoint.\n// Makes the @content apply to the given breakpoint and wider.\n@mixin media-breakpoint-up($name, $breakpoints: $grid-breakpoints) {\n  $min: breakpoint-min($name, $breakpoints);\n  @if $min {\n    @media (min-width: $min) {\n      @content;\n    }\n  } @else {\n    @content;\n  }\n}\n\n// Media of at most the maximum breakpoint width. No query for the largest breakpoint.\n// Makes the @content apply to the given breakpoint and narrower.\n@mixin media-breakpoint-down($name, $breakpoints: $grid-breakpoints) {\n  $max: breakpoint-max($name, $breakpoints);\n  @if $max {\n    @media (max-width: $max) {\n      @content;\n    }\n  } @else {\n    @content;\n  }\n}\n\n// Media that spans multiple breakpoint widths.\n// Makes the @content apply between the min and max breakpoints\n@mixin media-breakpoint-between($lower, $upper, $breakpoints: $grid-breakpoints) {\n  $min: breakpoint-min($lower, $breakpoints);\n  $max: breakpoint-max($upper, $breakpoints);\n\n  @if $min != null and $max != null {\n    @media (min-width: $min) and (max-width: $max) {\n      @content;\n    }\n  } @else if $max == null {\n    @include media-breakpoint-up($lower, $breakpoints) {\n      @content;\n    }\n  } @else if $min == null {\n    @include media-breakpoint-down($upper, $breakpoints) {\n      @content;\n    }\n  }\n}\n\n// Media between the breakpoint's minimum and maximum widths.\n// No minimum for the smallest breakpoint, and no maximum for the largest one.\n// Makes the @content apply only to the given breakpoint, not viewports any wider or narrower.\n@mixin media-breakpoint-only($name, $breakpoints: $grid-breakpoints) {\n  $min: breakpoint-min($name, $breakpoints);\n  $max: breakpoint-max($name, $breakpoints);\n\n  @if $min != null and $max != null {\n    @media (min-width: $min) and (max-width: $max) {\n      @content;\n    }\n  } @else if $max == null {\n    @include media-breakpoint-up($name, $breakpoints) {\n      @content;\n    }\n  } @else if $min == null {\n    @include media-breakpoint-down($name, $breakpoints) {\n      @content;\n    }\n  }\n}\n","// Framework grid generation\n//\n// Used only by Bootstrap to generate the correct number of grid classes given\n// any value of `$grid-columns`.\n\n@mixin make-grid-columns($columns: $grid-columns, $gutter: $grid-gutter-width, $breakpoints: $grid-breakpoints) {\n  // Common properties for all breakpoints\n  %grid-column {\n    position: relative;\n    width: 100%;\n    padding-right: $gutter / 2;\n    padding-left: $gutter / 2;\n  }\n\n  @each $breakpoint in map-keys($breakpoints) {\n    $infix: breakpoint-infix($breakpoint, $breakpoints);\n\n    // Allow columns to stretch full width below their breakpoints\n    @for $i from 1 through $columns {\n      .col#{$infix}-#{$i} {\n        @extend %grid-column;\n      }\n    }\n    .col#{$infix},\n    .col#{$infix}-auto {\n      @extend %grid-column;\n    }\n\n    @include media-breakpoint-up($breakpoint, $breakpoints) {\n      // Provide basic `.col-{bp}` classes for equal-width flexbox columns\n      .col#{$infix} {\n        flex-basis: 0;\n        flex-grow: 1;\n        max-width: 100%;\n      }\n      .col#{$infix}-auto {\n        flex: 0 0 auto;\n        width: auto;\n        max-width: 100%; // Reset earlier grid tiers\n      }\n\n      @for $i from 1 through $columns {\n        .col#{$infix}-#{$i} {\n          @include make-col($i, $columns);\n        }\n      }\n\n      .order#{$infix}-first { order: -1; }\n\n      .order#{$infix}-last { order: $columns + 1; }\n\n      @for $i from 0 through $columns {\n        .order#{$infix}-#{$i} { order: $i; }\n      }\n\n      // `$columns - 1` because offsetting by the width of an entire row isn't possible\n      @for $i from 0 through ($columns - 1) {\n        @if not ($infix == \"\" and $i == 0) { // Avoid emitting useless .offset-0\n          .offset#{$infix}-#{$i} {\n            @include make-col-offset($i, $columns);\n          }\n        }\n      }\n    }\n  }\n}\n","//\n// Basic Bootstrap table\n//\n\n.table {\n  width: 100%;\n  margin-bottom: $spacer;\n  color: $table-color;\n  background-color: $table-bg; // Reset for nesting within parents with `background-color`.\n\n  th,\n  td {\n    padding: $table-cell-padding;\n    vertical-align: top;\n    border-top: $table-border-width solid $table-border-color;\n  }\n\n  thead th {\n    vertical-align: bottom;\n    border-bottom: (2 * $table-border-width) solid $table-border-color;\n  }\n\n  tbody + tbody {\n    border-top: (2 * $table-border-width) solid $table-border-color;\n  }\n}\n\n\n//\n// Condensed table w/ half padding\n//\n\n.table-sm {\n  th,\n  td {\n    padding: $table-cell-padding-sm;\n  }\n}\n\n\n// Border versions\n//\n// Add or remove borders all around the table and between all the columns.\n\n.table-bordered {\n  border: $table-border-width solid $table-border-color;\n\n  th,\n  td {\n    border: $table-border-width solid $table-border-color;\n  }\n\n  thead {\n    th,\n    td {\n      border-bottom-width: 2 * $table-border-width;\n    }\n  }\n}\n\n.table-borderless {\n  th,\n  td,\n  thead th,\n  tbody + tbody {\n    border: 0;\n  }\n}\n\n// Zebra-striping\n//\n// Default zebra-stripe styles (alternating gray and transparent backgrounds)\n\n.table-striped {\n  tbody tr:nth-of-type(#{$table-striped-order}) {\n    background-color: $table-accent-bg;\n  }\n}\n\n\n// Hover effect\n//\n// Placed here since it has to come after the potential zebra striping\n\n.table-hover {\n  tbody tr {\n    @include hover {\n      color: $table-hover-color;\n      background-color: $table-hover-bg;\n    }\n  }\n}\n\n\n// Table backgrounds\n//\n// Exact selectors below required to override `.table-striped` and prevent\n// inheritance to nested tables.\n\n@each $color, $value in $theme-colors {\n  @include table-row-variant($color, theme-color-level($color, $table-bg-level), theme-color-level($color, $table-border-level));\n}\n\n@include table-row-variant(active, $table-active-bg);\n\n\n// Dark styles\n//\n// Same table markup, but inverted color scheme: dark background and light text.\n\n// stylelint-disable-next-line no-duplicate-selectors\n.table {\n  .thead-dark {\n    th {\n      color: $table-dark-color;\n      background-color: $table-dark-bg;\n      border-color: $table-dark-border-color;\n    }\n  }\n\n  .thead-light {\n    th {\n      color: $table-head-color;\n      background-color: $table-head-bg;\n      border-color: $table-border-color;\n    }\n  }\n}\n\n.table-dark {\n  color: $table-dark-color;\n  background-color: $table-dark-bg;\n\n  th,\n  td,\n  thead th {\n    border-color: $table-dark-border-color;\n  }\n\n  &.table-bordered {\n    border: 0;\n  }\n\n  &.table-striped {\n    tbody tr:nth-of-type(odd) {\n      background-color: $table-dark-accent-bg;\n    }\n  }\n\n  &.table-hover {\n    tbody tr {\n      @include hover {\n        color: $table-dark-hover-color;\n        background-color: $table-dark-hover-bg;\n      }\n    }\n  }\n}\n\n\n// Responsive tables\n//\n// Generate series of `.table-responsive-*` classes for configuring the screen\n// size of where your table will overflow.\n\n.table-responsive {\n  @each $breakpoint in map-keys($grid-breakpoints) {\n    $next: breakpoint-next($breakpoint, $grid-breakpoints);\n    $infix: breakpoint-infix($next, $grid-breakpoints);\n\n    &#{$infix} {\n      @include media-breakpoint-down($breakpoint) {\n        display: block;\n        width: 100%;\n        overflow-x: auto;\n        -webkit-overflow-scrolling: touch;\n\n        // Prevent double border on horizontal scroll due to use of `display: block;`\n        > .table-bordered {\n          border: 0;\n        }\n      }\n    }\n  }\n}\n","// Tables\n\n@mixin table-row-variant($state, $background, $border: null) {\n  // Exact selectors below required to override `.table-striped` and prevent\n  // inheritance to nested tables.\n  .table-#{$state} {\n    &,\n    > th,\n    > td {\n      background-color: $background;\n    }\n\n    @if $border != null {\n      th,\n      td,\n      thead th,\n      tbody + tbody {\n        border-color: $border;\n      }\n    }\n  }\n\n  // Hover states for `.table-hover`\n  // Note: this is not available for cells or rows within `thead` or `tfoot`.\n  .table-hover {\n    $hover-background: darken($background, 5%);\n\n    .table-#{$state} {\n      @include hover {\n        background-color: $hover-background;\n\n        > td,\n        > th {\n          background-color: $hover-background;\n        }\n      }\n    }\n  }\n}\n","// stylelint-disable selector-no-qualifying-type\n\n//\n// Textual form controls\n//\n\n.form-control {\n  display: block;\n  width: 100%;\n  height: $input-height;\n  padding: $input-padding-y $input-padding-x;\n  font-family: $input-font-family;\n  @include font-size($input-font-size);\n  font-weight: $input-font-weight;\n  line-height: $input-line-height;\n  color: $input-color;\n  background-color: $input-bg;\n  background-clip: padding-box;\n  border: $input-border-width solid $input-border-color;\n\n  // Note: This has no effect on <select>s in some browsers, due to the limited stylability of `<select>`s in CSS.\n  @include border-radius($input-border-radius, 0);\n\n  @include box-shadow($input-box-shadow);\n  @include transition($input-transition);\n\n  // Unstyle the caret on `<select>`s in IE10+.\n  &::-ms-expand {\n    background-color: transparent;\n    border: 0;\n  }\n\n  // Customize the `:focus` state to imitate native WebKit styles.\n  @include form-control-focus();\n\n  // Placeholder\n  &::placeholder {\n    color: $input-placeholder-color;\n    // Override Firefox's unusual default opacity; see https://github.com/twbs/bootstrap/pull/11526.\n    opacity: 1;\n  }\n\n  // Disabled and read-only inputs\n  //\n  // HTML5 says that controls under a fieldset > legend:first-child won't be\n  // disabled if the fieldset is disabled. Due to implementation difficulty, we\n  // don't honor that edge case; we style them as disabled anyway.\n  &:disabled,\n  &[readonly] {\n    background-color: $input-disabled-bg;\n    // iOS fix for unreadable disabled content; see https://github.com/twbs/bootstrap/issues/11655.\n    opacity: 1;\n  }\n}\n\nselect.form-control {\n  &:focus::-ms-value {\n    // Suppress the nested default white text on blue background highlight given to\n    // the selected option text when the (still closed) <select> receives focus\n    // in IE and (under certain conditions) Edge, as it looks bad and cannot be made to\n    // match the appearance of the native widget.\n    // See https://github.com/twbs/bootstrap/issues/19398.\n    color: $input-color;\n    background-color: $input-bg;\n  }\n}\n\n// Make file inputs better match text inputs by forcing them to new lines.\n.form-control-file,\n.form-control-range {\n  display: block;\n  width: 100%;\n}\n\n\n//\n// Labels\n//\n\n// For use with horizontal and inline forms, when you need the label (or legend)\n// text to align with the form controls.\n.col-form-label {\n  padding-top: calc(#{$input-padding-y} + #{$input-border-width});\n  padding-bottom: calc(#{$input-padding-y} + #{$input-border-width});\n  margin-bottom: 0; // Override the `<label>/<legend>` default\n  @include font-size(inherit); // Override the `<legend>` default\n  line-height: $input-line-height;\n}\n\n.col-form-label-lg {\n  padding-top: calc(#{$input-padding-y-lg} + #{$input-border-width});\n  padding-bottom: calc(#{$input-padding-y-lg} + #{$input-border-width});\n  @include font-size($input-font-size-lg);\n  line-height: $input-line-height-lg;\n}\n\n.col-form-label-sm {\n  padding-top: calc(#{$input-padding-y-sm} + #{$input-border-width});\n  padding-bottom: calc(#{$input-padding-y-sm} + #{$input-border-width});\n  @include font-size($input-font-size-sm);\n  line-height: $input-line-height-sm;\n}\n\n\n// Readonly controls as plain text\n//\n// Apply class to a readonly input to make it appear like regular plain\n// text (without any border, background color, focus indicator)\n\n.form-control-plaintext {\n  display: block;\n  width: 100%;\n  padding-top: $input-padding-y;\n  padding-bottom: $input-padding-y;\n  margin-bottom: 0; // match inputs if this class comes on inputs with default margins\n  line-height: $input-line-height;\n  color: $input-plaintext-color;\n  background-color: transparent;\n  border: solid transparent;\n  border-width: $input-border-width 0;\n\n  &.form-control-sm,\n  &.form-control-lg {\n    padding-right: 0;\n    padding-left: 0;\n  }\n}\n\n\n// Form control sizing\n//\n// Build on `.form-control` with modifier classes to decrease or increase the\n// height and font-size of form controls.\n//\n// Repeated in `_input_group.scss` to avoid Sass extend issues.\n\n.form-control-sm {\n  height: $input-height-sm;\n  padding: $input-padding-y-sm $input-padding-x-sm;\n  @include font-size($input-font-size-sm);\n  line-height: $input-line-height-sm;\n  @include border-radius($input-border-radius-sm);\n}\n\n.form-control-lg {\n  height: $input-height-lg;\n  padding: $input-padding-y-lg $input-padding-x-lg;\n  @include font-size($input-font-size-lg);\n  line-height: $input-line-height-lg;\n  @include border-radius($input-border-radius-lg);\n}\n\n// stylelint-disable-next-line no-duplicate-selectors\nselect.form-control {\n  &[size],\n  &[multiple] {\n    height: auto;\n  }\n}\n\ntextarea.form-control {\n  height: auto;\n}\n\n// Form groups\n//\n// Designed to help with the organization and spacing of vertical forms. For\n// horizontal forms, use the predefined grid classes.\n\n.form-group {\n  margin-bottom: $form-group-margin-bottom;\n}\n\n.form-text {\n  display: block;\n  margin-top: $form-text-margin-top;\n}\n\n\n// Form grid\n//\n// Special replacement for our grid system's `.row` for tighter form layouts.\n\n.form-row {\n  display: flex;\n  flex-wrap: wrap;\n  margin-right: -$form-grid-gutter-width / 2;\n  margin-left: -$form-grid-gutter-width / 2;\n\n  > .col,\n  > [class*=\"col-\"] {\n    padding-right: $form-grid-gutter-width / 2;\n    padding-left: $form-grid-gutter-width / 2;\n  }\n}\n\n\n// Checkboxes and radios\n//\n// Indent the labels to position radios/checkboxes as hanging controls.\n\n.form-check {\n  position: relative;\n  display: block;\n  padding-left: $form-check-input-gutter;\n}\n\n.form-check-input {\n  position: absolute;\n  margin-top: $form-check-input-margin-y;\n  margin-left: -$form-check-input-gutter;\n\n  &:disabled ~ .form-check-label {\n    color: $text-muted;\n  }\n}\n\n.form-check-label {\n  margin-bottom: 0; // Override default `<label>` bottom margin\n}\n\n.form-check-inline {\n  display: inline-flex;\n  align-items: center;\n  padding-left: 0; // Override base .form-check\n  margin-right: $form-check-inline-margin-x;\n\n  // Undo .form-check-input defaults and add some `margin-right`.\n  .form-check-input {\n    position: static;\n    margin-top: 0;\n    margin-right: $form-check-inline-input-margin-x;\n    margin-left: 0;\n  }\n}\n\n\n// Form validation\n//\n// Provide feedback to users when form field values are valid or invalid. Works\n// primarily for client-side validation via scoped `:invalid` and `:valid`\n// pseudo-classes but also includes `.is-invalid` and `.is-valid` classes for\n// server side validation.\n\n@each $state, $data in $form-validation-states {\n  @include form-validation-state($state, map-get($data, color), map-get($data, icon));\n}\n\n// Inline forms\n//\n// Make forms appear inline(-block) by adding the `.form-inline` class. Inline\n// forms begin stacked on extra small (mobile) devices and then go inline when\n// viewports reach <768px.\n//\n// Requires wrapping inputs and labels with `.form-group` for proper display of\n// default HTML form controls and our custom form controls (e.g., input groups).\n\n.form-inline {\n  display: flex;\n  flex-flow: row wrap;\n  align-items: center; // Prevent shorter elements from growing to same height as others (e.g., small buttons growing to normal sized button height)\n\n  // Because we use flex, the initial sizing of checkboxes is collapsed and\n  // doesn't occupy the full-width (which is what we want for xs grid tier),\n  // so we force that here.\n  .form-check {\n    width: 100%;\n  }\n\n  // Kick in the inline\n  @include media-breakpoint-up(sm) {\n    label {\n      display: flex;\n      align-items: center;\n      justify-content: center;\n      margin-bottom: 0;\n    }\n\n    // Inline-block all the things for \"inline\"\n    .form-group {\n      display: flex;\n      flex: 0 0 auto;\n      flex-flow: row wrap;\n      align-items: center;\n      margin-bottom: 0;\n    }\n\n    // Allow folks to *not* use `.form-group`\n    .form-control {\n      display: inline-block;\n      width: auto; // Prevent labels from stacking above inputs in `.form-group`\n      vertical-align: middle;\n    }\n\n    // Make static controls behave like regular ones\n    .form-control-plaintext {\n      display: inline-block;\n    }\n\n    .input-group,\n    .custom-select {\n      width: auto;\n    }\n\n    // Remove default margin on radios/checkboxes that were used for stacking, and\n    // then undo the floating of radios and checkboxes to match.\n    .form-check {\n      display: flex;\n      align-items: center;\n      justify-content: center;\n      width: auto;\n      padding-left: 0;\n    }\n    .form-check-input {\n      position: relative;\n      flex-shrink: 0;\n      margin-top: 0;\n      margin-right: $form-check-input-margin-x;\n      margin-left: 0;\n    }\n\n    .custom-control {\n      align-items: center;\n      justify-content: center;\n    }\n    .custom-control-label {\n      margin-bottom: 0;\n    }\n  }\n}\n","// stylelint-disable property-blacklist\n@mixin transition($transition...) {\n  @if $enable-transitions {\n    @if length($transition) == 0 {\n      transition: $transition-base;\n    } @else {\n      transition: $transition;\n    }\n  }\n\n  @if $enable-prefers-reduced-motion-media-query {\n    @media (prefers-reduced-motion: reduce) {\n      transition: none;\n    }\n  }\n}\n","// Form control focus state\n//\n// Generate a customized focus state and for any input with the specified color,\n// which defaults to the `$input-focus-border-color` variable.\n//\n// We highly encourage you to not customize the default value, but instead use\n// this to tweak colors on an as-needed basis. This aesthetic change is based on\n// WebKit's default styles, but applicable to a wider range of browsers. Its\n// usability and accessibility should be taken into account with any change.\n//\n// Example usage: change the default blue border and shadow to white for better\n// contrast against a dark gray background.\n@mixin form-control-focus() {\n  &:focus {\n    color: $input-focus-color;\n    background-color: $input-focus-bg;\n    border-color: $input-focus-border-color;\n    outline: 0;\n    // Avoid using mixin so we can pass custom focus shadow properly\n    @if $enable-shadows {\n      box-shadow: $input-box-shadow, $input-focus-box-shadow;\n    } @else {\n      box-shadow: $input-focus-box-shadow;\n    }\n  }\n}\n\n\n@mixin form-validation-state($state, $color, $icon) {\n  .#{$state}-feedback {\n    display: none;\n    width: 100%;\n    margin-top: $form-feedback-margin-top;\n    @include font-size($form-feedback-font-size);\n    color: $color;\n  }\n\n  .#{$state}-tooltip {\n    position: absolute;\n    top: 100%;\n    z-index: 5;\n    display: none;\n    max-width: 100%; // Contain to parent when possible\n    padding: $form-feedback-tooltip-padding-y $form-feedback-tooltip-padding-x;\n    margin-top: .1rem;\n    @include font-size($form-feedback-tooltip-font-size);\n    line-height: $form-feedback-tooltip-line-height;\n    color: color-yiq($color);\n    background-color: rgba($color, $form-feedback-tooltip-opacity);\n    @include border-radius($form-feedback-tooltip-border-radius);\n  }\n\n  .form-control {\n    .was-validated &:#{$state},\n    &.is-#{$state} {\n      border-color: $color;\n\n      @if $enable-validation-icons {\n        padding-right: $input-height-inner;\n        background-image: $icon;\n        background-repeat: no-repeat;\n        background-position: center right $input-height-inner-quarter;\n        background-size: $input-height-inner-half $input-height-inner-half;\n      }\n\n      &:focus {\n        border-color: $color;\n        box-shadow: 0 0 0 $input-focus-width rgba($color, .25);\n      }\n\n      ~ .#{$state}-feedback,\n      ~ .#{$state}-tooltip {\n        display: block;\n      }\n    }\n  }\n\n  // stylelint-disable-next-line selector-no-qualifying-type\n  textarea.form-control {\n    .was-validated &:#{$state},\n    &.is-#{$state} {\n      @if $enable-validation-icons {\n        padding-right: $input-height-inner;\n        background-position: top $input-height-inner-quarter right $input-height-inner-quarter;\n      }\n    }\n  }\n\n  .custom-select {\n    .was-validated &:#{$state},\n    &.is-#{$state} {\n      border-color: $color;\n\n      @if $enable-validation-icons {\n        padding-right: $custom-select-feedback-icon-padding-right;\n        background: $custom-select-background, $icon $custom-select-bg no-repeat $custom-select-feedback-icon-position / $custom-select-feedback-icon-size;\n      }\n\n      &:focus {\n        border-color: $color;\n        box-shadow: 0 0 0 $input-focus-width rgba($color, .25);\n      }\n\n      ~ .#{$state}-feedback,\n      ~ .#{$state}-tooltip {\n        display: block;\n      }\n    }\n  }\n\n\n  .form-control-file {\n    .was-validated &:#{$state},\n    &.is-#{$state} {\n      ~ .#{$state}-feedback,\n      ~ .#{$state}-tooltip {\n        display: block;\n      }\n    }\n  }\n\n  .form-check-input {\n    .was-validated &:#{$state},\n    &.is-#{$state} {\n      ~ .form-check-label {\n        color: $color;\n      }\n\n      ~ .#{$state}-feedback,\n      ~ .#{$state}-tooltip {\n        display: block;\n      }\n    }\n  }\n\n  .custom-control-input {\n    .was-validated &:#{$state},\n    &.is-#{$state} {\n      ~ .custom-control-label {\n        color: $color;\n\n        &::before {\n          border-color: $color;\n        }\n      }\n\n      ~ .#{$state}-feedback,\n      ~ .#{$state}-tooltip {\n        display: block;\n      }\n\n      &:checked {\n        ~ .custom-control-label::before {\n          border-color: lighten($color, 10%);\n          @include gradient-bg(lighten($color, 10%));\n        }\n      }\n\n      &:focus {\n        ~ .custom-control-label::before {\n          box-shadow: 0 0 0 $input-focus-width rgba($color, .25);\n        }\n\n        &:not(:checked) ~ .custom-control-label::before {\n          border-color: $color;\n        }\n      }\n    }\n  }\n\n  // custom file\n  .custom-file-input {\n    .was-validated &:#{$state},\n    &.is-#{$state} {\n      ~ .custom-file-label {\n        border-color: $color;\n      }\n\n      ~ .#{$state}-feedback,\n      ~ .#{$state}-tooltip {\n        display: block;\n      }\n\n      &:focus {\n        ~ .custom-file-label {\n          border-color: $color;\n          box-shadow: 0 0 0 $input-focus-width rgba($color, .25);\n        }\n      }\n    }\n  }\n}\n","// Gradients\n\n@mixin gradient-bg($color) {\n  @if $enable-gradients {\n    background: $color linear-gradient(180deg, mix($body-bg, $color, 15%), $color) repeat-x;\n  } @else {\n    background-color: $color;\n  }\n}\n\n// Horizontal gradient, from left to right\n//\n// Creates two color stops, start and end, by specifying a color and position for each color stop.\n@mixin gradient-x($start-color: $gray-700, $end-color: $gray-800, $start-percent: 0%, $end-percent: 100%) {\n  background-image: linear-gradient(to right, $start-color $start-percent, $end-color $end-percent);\n  background-repeat: repeat-x;\n}\n\n// Vertical gradient, from top to bottom\n//\n// Creates two color stops, start and end, by specifying a color and position for each color stop.\n@mixin gradient-y($start-color: $gray-700, $end-color: $gray-800, $start-percent: 0%, $end-percent: 100%) {\n  background-image: linear-gradient(to bottom, $start-color $start-percent, $end-color $end-percent);\n  background-repeat: repeat-x;\n}\n\n@mixin gradient-directional($start-color: $gray-700, $end-color: $gray-800, $deg: 45deg) {\n  background-image: linear-gradient($deg, $start-color, $end-color);\n  background-repeat: repeat-x;\n}\n@mixin gradient-x-three-colors($start-color: $blue, $mid-color: $purple, $color-stop: 50%, $end-color: $red) {\n  background-image: linear-gradient(to right, $start-color, $mid-color $color-stop, $end-color);\n  background-repeat: no-repeat;\n}\n@mixin gradient-y-three-colors($start-color: $blue, $mid-color: $purple, $color-stop: 50%, $end-color: $red) {\n  background-image: linear-gradient($start-color, $mid-color $color-stop, $end-color);\n  background-repeat: no-repeat;\n}\n@mixin gradient-radial($inner-color: $gray-700, $outer-color: $gray-800) {\n  background-image: radial-gradient(circle, $inner-color, $outer-color);\n  background-repeat: no-repeat;\n}\n@mixin gradient-striped($color: rgba($white, .15), $angle: 45deg) {\n  background-image: linear-gradient($angle, $color 25%, transparent 25%, transparent 50%, $color 50%, $color 75%, transparent 75%, transparent);\n}\n","// stylelint-disable selector-no-qualifying-type\n\n//\n// Base styles\n//\n\n.btn {\n  display: inline-block;\n  font-family: $btn-font-family;\n  font-weight: $btn-font-weight;\n  color: $body-color;\n  text-align: center;\n  vertical-align: middle;\n  user-select: none;\n  background-color: transparent;\n  border: $btn-border-width solid transparent;\n  @include button-size($btn-padding-y, $btn-padding-x, $btn-font-size, $btn-line-height, $btn-border-radius);\n  @include transition($btn-transition);\n\n  @include hover {\n    color: $body-color;\n    text-decoration: none;\n  }\n\n  &:focus,\n  &.focus {\n    outline: 0;\n    box-shadow: $btn-focus-box-shadow;\n  }\n\n  // Disabled comes first so active can properly restyle\n  &.disabled,\n  &:disabled {\n    opacity: $btn-disabled-opacity;\n    @include box-shadow(none);\n  }\n\n  &:not(:disabled):not(.disabled):active,\n  &:not(:disabled):not(.disabled).active {\n    @include box-shadow($btn-active-box-shadow);\n\n    &:focus {\n      @include box-shadow($btn-focus-box-shadow, $btn-active-box-shadow);\n    }\n  }\n}\n\n// Future-proof disabling of clicks on `<a>` elements\na.btn.disabled,\nfieldset:disabled a.btn {\n  pointer-events: none;\n}\n\n\n//\n// Alternate buttons\n//\n\n@each $color, $value in $theme-colors {\n  .btn-#{$color} {\n    @include button-variant($value, $value);\n  }\n}\n\n@each $color, $value in $theme-colors {\n  .btn-outline-#{$color} {\n    @include button-outline-variant($value);\n  }\n}\n\n\n//\n// Link buttons\n//\n\n// Make a button look and behave like a link\n.btn-link {\n  font-weight: $font-weight-normal;\n  color: $link-color;\n  text-decoration: $link-decoration;\n\n  @include hover {\n    color: $link-hover-color;\n    text-decoration: $link-hover-decoration;\n  }\n\n  &:focus,\n  &.focus {\n    text-decoration: $link-hover-decoration;\n    box-shadow: none;\n  }\n\n  &:disabled,\n  &.disabled {\n    color: $btn-link-disabled-color;\n    pointer-events: none;\n  }\n\n  // No need for an active state here\n}\n\n\n//\n// Button Sizes\n//\n\n.btn-lg {\n  @include button-size($btn-padding-y-lg, $btn-padding-x-lg, $btn-font-size-lg, $btn-line-height-lg, $btn-border-radius-lg);\n}\n\n.btn-sm {\n  @include button-size($btn-padding-y-sm, $btn-padding-x-sm, $btn-font-size-sm, $btn-line-height-sm, $btn-border-radius-sm);\n}\n\n\n//\n// Block button\n//\n\n.btn-block {\n  display: block;\n  width: 100%;\n\n  // Vertically space out multiple block buttons\n  + .btn-block {\n    margin-top: $btn-block-spacing-y;\n  }\n}\n\n// Specificity overrides\ninput[type=\"submit\"],\ninput[type=\"reset\"],\ninput[type=\"button\"] {\n  &.btn-block {\n    width: 100%;\n  }\n}\n","// Button variants\n//\n// Easily pump out default styles, as well as :hover, :focus, :active,\n// and disabled options for all buttons\n\n@mixin button-variant($background, $border, $hover-background: darken($background, 7.5%), $hover-border: darken($border, 10%), $active-background: darken($background, 10%), $active-border: darken($border, 12.5%)) {\n  color: color-yiq($background);\n  @include gradient-bg($background);\n  border-color: $border;\n  @include box-shadow($btn-box-shadow);\n\n  @include hover {\n    color: color-yiq($hover-background);\n    @include gradient-bg($hover-background);\n    border-color: $hover-border;\n  }\n\n  &:focus,\n  &.focus {\n    // Avoid using mixin so we can pass custom focus shadow properly\n    @if $enable-shadows {\n      box-shadow: $btn-box-shadow, 0 0 0 $btn-focus-width rgba(mix(color-yiq($background), $border, 15%), .5);\n    } @else {\n      box-shadow: 0 0 0 $btn-focus-width rgba(mix(color-yiq($background), $border, 15%), .5);\n    }\n  }\n\n  // Disabled comes first so active can properly restyle\n  &.disabled,\n  &:disabled {\n    color: color-yiq($background);\n    background-color: $background;\n    border-color: $border;\n    // Remove CSS gradients if they're enabled\n    @if $enable-gradients {\n      background-image: none;\n    }\n  }\n\n  &:not(:disabled):not(.disabled):active,\n  &:not(:disabled):not(.disabled).active,\n  .show > &.dropdown-toggle {\n    color: color-yiq($active-background);\n    background-color: $active-background;\n    @if $enable-gradients {\n      background-image: none; // Remove the gradient for the pressed/active state\n    }\n    border-color: $active-border;\n\n    &:focus {\n      // Avoid using mixin so we can pass custom focus shadow properly\n      @if $enable-shadows and $btn-active-box-shadow != none {\n        box-shadow: $btn-active-box-shadow, 0 0 0 $btn-focus-width rgba(mix(color-yiq($background), $border, 15%), .5);\n      } @else {\n        box-shadow: 0 0 0 $btn-focus-width rgba(mix(color-yiq($background), $border, 15%), .5);\n      }\n    }\n  }\n}\n\n@mixin button-outline-variant($color, $color-hover: color-yiq($color), $active-background: $color, $active-border: $color) {\n  color: $color;\n  border-color: $color;\n\n  @include hover {\n    color: $color-hover;\n    background-color: $active-background;\n    border-color: $active-border;\n  }\n\n  &:focus,\n  &.focus {\n    box-shadow: 0 0 0 $btn-focus-width rgba($color, .5);\n  }\n\n  &.disabled,\n  &:disabled {\n    color: $color;\n    background-color: transparent;\n  }\n\n  &:not(:disabled):not(.disabled):active,\n  &:not(:disabled):not(.disabled).active,\n  .show > &.dropdown-toggle {\n    color: color-yiq($active-background);\n    background-color: $active-background;\n    border-color: $active-border;\n\n    &:focus {\n      // Avoid using mixin so we can pass custom focus shadow properly\n      @if $enable-shadows and $btn-active-box-shadow != none {\n        box-shadow: $btn-active-box-shadow, 0 0 0 $btn-focus-width rgba($color, .5);\n      } @else {\n        box-shadow: 0 0 0 $btn-focus-width rgba($color, .5);\n      }\n    }\n  }\n}\n\n// Button sizes\n@mixin button-size($padding-y, $padding-x, $font-size, $line-height, $border-radius) {\n  padding: $padding-y $padding-x;\n  @include font-size($font-size);\n  line-height: $line-height;\n  // Manually declare to provide an override to the browser default\n  @include border-radius($border-radius, 0);\n}\n",".fade {\n  @include transition($transition-fade);\n\n  &:not(.show) {\n    opacity: 0;\n  }\n}\n\n.collapse {\n  &:not(.show) {\n    display: none;\n  }\n}\n\n.collapsing {\n  position: relative;\n  height: 0;\n  overflow: hidden;\n  @include transition($transition-collapse);\n}\n","// The dropdown wrapper (`<div>`)\n.dropup,\n.dropright,\n.dropdown,\n.dropleft {\n  position: relative;\n}\n\n.dropdown-toggle {\n  white-space: nowrap;\n\n  // Generate the caret automatically\n  @include caret;\n}\n\n// The dropdown menu\n.dropdown-menu {\n  position: absolute;\n  top: 100%;\n  left: 0;\n  z-index: $zindex-dropdown;\n  display: none; // none by default, but block on \"open\" of the menu\n  float: left;\n  min-width: $dropdown-min-width;\n  padding: $dropdown-padding-y 0;\n  margin: $dropdown-spacer 0 0; // override default ul\n  @include font-size($dropdown-font-size);\n  color: $dropdown-color;\n  text-align: left; // Ensures proper alignment if parent has it changed (e.g., modal footer)\n  list-style: none;\n  background-color: $dropdown-bg;\n  background-clip: padding-box;\n  border: $dropdown-border-width solid $dropdown-border-color;\n  @include border-radius($dropdown-border-radius);\n  @include box-shadow($dropdown-box-shadow);\n}\n\n@each $breakpoint in map-keys($grid-breakpoints) {\n  @include media-breakpoint-up($breakpoint) {\n    $infix: breakpoint-infix($breakpoint, $grid-breakpoints);\n\n    .dropdown-menu#{$infix}-left {\n      right: auto;\n      left: 0;\n    }\n\n    .dropdown-menu#{$infix}-right {\n      right: 0;\n      left: auto;\n    }\n  }\n}\n\n// Allow for dropdowns to go bottom up (aka, dropup-menu)\n// Just add .dropup after the standard .dropdown class and you're set.\n.dropup {\n  .dropdown-menu {\n    top: auto;\n    bottom: 100%;\n    margin-top: 0;\n    margin-bottom: $dropdown-spacer;\n  }\n\n  .dropdown-toggle {\n    @include caret(up);\n  }\n}\n\n.dropright {\n  .dropdown-menu {\n    top: 0;\n    right: auto;\n    left: 100%;\n    margin-top: 0;\n    margin-left: $dropdown-spacer;\n  }\n\n  .dropdown-toggle {\n    @include caret(right);\n    &::after {\n      vertical-align: 0;\n    }\n  }\n}\n\n.dropleft {\n  .dropdown-menu {\n    top: 0;\n    right: 100%;\n    left: auto;\n    margin-top: 0;\n    margin-right: $dropdown-spacer;\n  }\n\n  .dropdown-toggle {\n    @include caret(left);\n    &::before {\n      vertical-align: 0;\n    }\n  }\n}\n\n// When enabled Popper.js, reset basic dropdown position\n// stylelint-disable-next-line no-duplicate-selectors\n.dropdown-menu {\n  &[x-placement^=\"top\"],\n  &[x-placement^=\"right\"],\n  &[x-placement^=\"bottom\"],\n  &[x-placement^=\"left\"] {\n    right: auto;\n    bottom: auto;\n  }\n}\n\n// Dividers (basically an `<hr>`) within the dropdown\n.dropdown-divider {\n  @include nav-divider($dropdown-divider-bg, $dropdown-divider-margin-y);\n}\n\n// Links, buttons, and more within the dropdown menu\n//\n// `<button>`-specific styles are denoted with `// For <button>s`\n.dropdown-item {\n  display: block;\n  width: 100%; // For `<button>`s\n  padding: $dropdown-item-padding-y $dropdown-item-padding-x;\n  clear: both;\n  font-weight: $font-weight-normal;\n  color: $dropdown-link-color;\n  text-align: inherit; // For `<button>`s\n  white-space: nowrap; // prevent links from randomly breaking onto new lines\n  background-color: transparent; // For `<button>`s\n  border: 0; // For `<button>`s\n\n  // Prevent dropdown overflow if there's no padding\n  // See https://github.com/twbs/bootstrap/pull/27703\n  @if $dropdown-padding-y == 0 {\n    &:first-child {\n      @include border-top-radius($dropdown-inner-border-radius);\n    }\n\n    &:last-child {\n      @include border-bottom-radius($dropdown-inner-border-radius);\n    }\n  }\n\n  @include hover-focus {\n    color: $dropdown-link-hover-color;\n    text-decoration: none;\n    @include gradient-bg($dropdown-link-hover-bg);\n  }\n\n  &.active,\n  &:active {\n    color: $dropdown-link-active-color;\n    text-decoration: none;\n    @include gradient-bg($dropdown-link-active-bg);\n  }\n\n  &.disabled,\n  &:disabled {\n    color: $dropdown-link-disabled-color;\n    pointer-events: none;\n    background-color: transparent;\n    // Remove CSS gradients if they're enabled\n    @if $enable-gradients {\n      background-image: none;\n    }\n  }\n}\n\n.dropdown-menu.show {\n  display: block;\n}\n\n// Dropdown section headers\n.dropdown-header {\n  display: block;\n  padding: $dropdown-padding-y $dropdown-item-padding-x;\n  margin-bottom: 0; // for use with heading elements\n  @include font-size($font-size-sm);\n  color: $dropdown-header-color;\n  white-space: nowrap; // as with > li > a\n}\n\n// Dropdown text\n.dropdown-item-text {\n  display: block;\n  padding: $dropdown-item-padding-y $dropdown-item-padding-x;\n  color: $dropdown-link-color;\n}\n","@mixin caret-down {\n  border-top: $caret-width solid;\n  border-right: $caret-width solid transparent;\n  border-bottom: 0;\n  border-left: $caret-width solid transparent;\n}\n\n@mixin caret-up {\n  border-top: 0;\n  border-right: $caret-width solid transparent;\n  border-bottom: $caret-width solid;\n  border-left: $caret-width solid transparent;\n}\n\n@mixin caret-right {\n  border-top: $caret-width solid transparent;\n  border-right: 0;\n  border-bottom: $caret-width solid transparent;\n  border-left: $caret-width solid;\n}\n\n@mixin caret-left {\n  border-top: $caret-width solid transparent;\n  border-right: $caret-width solid;\n  border-bottom: $caret-width solid transparent;\n}\n\n@mixin caret($direction: down) {\n  @if $enable-caret {\n    &::after {\n      display: inline-block;\n      margin-left: $caret-spacing;\n      vertical-align: $caret-vertical-align;\n      content: \"\";\n      @if $direction == down {\n        @include caret-down;\n      } @else if $direction == up {\n        @include caret-up;\n      } @else if $direction == right {\n        @include caret-right;\n      }\n    }\n\n    @if $direction == left {\n      &::after {\n        display: none;\n      }\n\n      &::before {\n        display: inline-block;\n        margin-right: $caret-spacing;\n        vertical-align: $caret-vertical-align;\n        content: \"\";\n        @include caret-left;\n      }\n    }\n\n    &:empty::after {\n      margin-left: 0;\n    }\n  }\n}\n","// Horizontal dividers\n//\n// Dividers (basically an hr) within dropdowns and nav lists\n\n@mixin nav-divider($color: $nav-divider-color, $margin-y: $nav-divider-margin-y) {\n  height: 0;\n  margin: $margin-y 0;\n  overflow: hidden;\n  border-top: 1px solid $color;\n}\n","// stylelint-disable selector-no-qualifying-type\n\n// Make the div behave like a button\n.btn-group,\n.btn-group-vertical {\n  position: relative;\n  display: inline-flex;\n  vertical-align: middle; // match .btn alignment given font-size hack above\n\n  > .btn {\n    position: relative;\n    flex: 1 1 auto;\n\n    // Bring the hover, focused, and \"active\" buttons to the front to overlay\n    // the borders properly\n    @include hover {\n      z-index: 1;\n    }\n    &:focus,\n    &:active,\n    &.active {\n      z-index: 1;\n    }\n  }\n}\n\n// Optional: Group multiple button groups together for a toolbar\n.btn-toolbar {\n  display: flex;\n  flex-wrap: wrap;\n  justify-content: flex-start;\n\n  .input-group {\n    width: auto;\n  }\n}\n\n.btn-group {\n  // Prevent double borders when buttons are next to each other\n  > .btn:not(:first-child),\n  > .btn-group:not(:first-child) {\n    margin-left: -$btn-border-width;\n  }\n\n  // Reset rounded corners\n  > .btn:not(:last-child):not(.dropdown-toggle),\n  > .btn-group:not(:last-child) > .btn {\n    @include border-right-radius(0);\n  }\n\n  > .btn:not(:first-child),\n  > .btn-group:not(:first-child) > .btn {\n    @include border-left-radius(0);\n  }\n}\n\n// Sizing\n//\n// Remix the default button sizing classes into new ones for easier manipulation.\n\n.btn-group-sm > .btn { @extend .btn-sm; }\n.btn-group-lg > .btn { @extend .btn-lg; }\n\n\n//\n// Split button dropdowns\n//\n\n.dropdown-toggle-split {\n  padding-right: $btn-padding-x * .75;\n  padding-left: $btn-padding-x * .75;\n\n  &::after,\n  .dropup &::after,\n  .dropright &::after {\n    margin-left: 0;\n  }\n\n  .dropleft &::before {\n    margin-right: 0;\n  }\n}\n\n.btn-sm + .dropdown-toggle-split {\n  padding-right: $btn-padding-x-sm * .75;\n  padding-left: $btn-padding-x-sm * .75;\n}\n\n.btn-lg + .dropdown-toggle-split {\n  padding-right: $btn-padding-x-lg * .75;\n  padding-left: $btn-padding-x-lg * .75;\n}\n\n\n// The clickable button for toggling the menu\n// Set the same inset shadow as the :active state\n.btn-group.show .dropdown-toggle {\n  @include box-shadow($btn-active-box-shadow);\n\n  // Show no shadow for `.btn-link` since it has no other button styles.\n  &.btn-link {\n    @include box-shadow(none);\n  }\n}\n\n\n//\n// Vertical button groups\n//\n\n.btn-group-vertical {\n  flex-direction: column;\n  align-items: flex-start;\n  justify-content: center;\n\n  > .btn,\n  > .btn-group {\n    width: 100%;\n  }\n\n  > .btn:not(:first-child),\n  > .btn-group:not(:first-child) {\n    margin-top: -$btn-border-width;\n  }\n\n  // Reset rounded corners\n  > .btn:not(:last-child):not(.dropdown-toggle),\n  > .btn-group:not(:last-child) > .btn {\n    @include border-bottom-radius(0);\n  }\n\n  > .btn:not(:first-child),\n  > .btn-group:not(:first-child) > .btn {\n    @include border-top-radius(0);\n  }\n}\n\n\n// Checkbox and radio options\n//\n// In order to support the browser's form validation feedback, powered by the\n// `required` attribute, we have to \"hide\" the inputs via `clip`. We cannot use\n// `display: none;` or `visibility: hidden;` as that also hides the popover.\n// Simply visually hiding the inputs via `opacity` would leave them clickable in\n// certain cases which is prevented by using `clip` and `pointer-events`.\n// This way, we ensure a DOM element is visible to position the popover from.\n//\n// See https://github.com/twbs/bootstrap/pull/12794 and\n// https://github.com/twbs/bootstrap/pull/14559 for more information.\n\n.btn-group-toggle {\n  > .btn,\n  > .btn-group > .btn {\n    margin-bottom: 0; // Override default `<label>` value\n\n    input[type=\"radio\"],\n    input[type=\"checkbox\"] {\n      position: absolute;\n      clip: rect(0, 0, 0, 0);\n      pointer-events: none;\n    }\n  }\n}\n","// stylelint-disable selector-no-qualifying-type\n\n//\n// Base styles\n//\n\n.input-group {\n  position: relative;\n  display: flex;\n  flex-wrap: wrap; // For form validation feedback\n  align-items: stretch;\n  width: 100%;\n\n  > .form-control,\n  > .form-control-plaintext,\n  > .custom-select,\n  > .custom-file {\n    position: relative; // For focus state's z-index\n    flex: 1 1 auto;\n    // Add width 1% and flex-basis auto to ensure that button will not wrap out\n    // the column. Applies to IE Edge+ and Firefox. Chrome does not require this.\n    width: 1%;\n    margin-bottom: 0;\n\n    + .form-control,\n    + .custom-select,\n    + .custom-file {\n      margin-left: -$input-border-width;\n    }\n  }\n\n  // Bring the \"active\" form control to the top of surrounding elements\n  > .form-control:focus,\n  > .custom-select:focus,\n  > .custom-file .custom-file-input:focus ~ .custom-file-label {\n    z-index: 3;\n  }\n\n  // Bring the custom file input above the label\n  > .custom-file .custom-file-input:focus {\n    z-index: 4;\n  }\n\n  > .form-control,\n  > .custom-select {\n    &:not(:last-child) { @include border-right-radius(0); }\n    &:not(:first-child) { @include border-left-radius(0); }\n  }\n\n  // Custom file inputs have more complex markup, thus requiring different\n  // border-radius overrides.\n  > .custom-file {\n    display: flex;\n    align-items: center;\n\n    &:not(:last-child) .custom-file-label,\n    &:not(:last-child) .custom-file-label::after { @include border-right-radius(0); }\n    &:not(:first-child) .custom-file-label { @include border-left-radius(0); }\n  }\n}\n\n\n// Prepend and append\n//\n// While it requires one extra layer of HTML for each, dedicated prepend and\n// append elements allow us to 1) be less clever, 2) simplify our selectors, and\n// 3) support HTML5 form validation.\n\n.input-group-prepend,\n.input-group-append {\n  display: flex;\n\n  // Ensure buttons are always above inputs for more visually pleasing borders.\n  // This isn't needed for `.input-group-text` since it shares the same border-color\n  // as our inputs.\n  .btn {\n    position: relative;\n    z-index: 2;\n\n    &:focus {\n      z-index: 3;\n    }\n  }\n\n  .btn + .btn,\n  .btn + .input-group-text,\n  .input-group-text + .input-group-text,\n  .input-group-text + .btn {\n    margin-left: -$input-border-width;\n  }\n}\n\n.input-group-prepend { margin-right: -$input-border-width; }\n.input-group-append { margin-left: -$input-border-width; }\n\n\n// Textual addons\n//\n// Serves as a catch-all element for any text or radio/checkbox input you wish\n// to prepend or append to an input.\n\n.input-group-text {\n  display: flex;\n  align-items: center;\n  padding: $input-padding-y $input-padding-x;\n  margin-bottom: 0; // Allow use of <label> elements by overriding our default margin-bottom\n  @include font-size($input-font-size); // Match inputs\n  font-weight: $font-weight-normal;\n  line-height: $input-line-height;\n  color: $input-group-addon-color;\n  text-align: center;\n  white-space: nowrap;\n  background-color: $input-group-addon-bg;\n  border: $input-border-width solid $input-group-addon-border-color;\n  @include border-radius($input-border-radius);\n\n  // Nuke default margins from checkboxes and radios to vertically center within.\n  input[type=\"radio\"],\n  input[type=\"checkbox\"] {\n    margin-top: 0;\n  }\n}\n\n\n// Sizing\n//\n// Remix the default form control sizing classes into new ones for easier\n// manipulation.\n\n.input-group-lg > .form-control:not(textarea),\n.input-group-lg > .custom-select {\n  height: $input-height-lg;\n}\n\n.input-group-lg > .form-control,\n.input-group-lg > .custom-select,\n.input-group-lg > .input-group-prepend > .input-group-text,\n.input-group-lg > .input-group-append > .input-group-text,\n.input-group-lg > .input-group-prepend > .btn,\n.input-group-lg > .input-group-append > .btn {\n  padding: $input-padding-y-lg $input-padding-x-lg;\n  @include font-size($input-font-size-lg);\n  line-height: $input-line-height-lg;\n  @include border-radius($input-border-radius-lg);\n}\n\n.input-group-sm > .form-control:not(textarea),\n.input-group-sm > .custom-select {\n  height: $input-height-sm;\n}\n\n.input-group-sm > .form-control,\n.input-group-sm > .custom-select,\n.input-group-sm > .input-group-prepend > .input-group-text,\n.input-group-sm > .input-group-append > .input-group-text,\n.input-group-sm > .input-group-prepend > .btn,\n.input-group-sm > .input-group-append > .btn {\n  padding: $input-padding-y-sm $input-padding-x-sm;\n  @include font-size($input-font-size-sm);\n  line-height: $input-line-height-sm;\n  @include border-radius($input-border-radius-sm);\n}\n\n.input-group-lg > .custom-select,\n.input-group-sm > .custom-select {\n  padding-right: $custom-select-padding-x + $custom-select-indicator-padding;\n}\n\n\n// Prepend and append rounded corners\n//\n// These rulesets must come after the sizing ones to properly override sm and lg\n// border-radius values when extending. They're more specific than we'd like\n// with the `.input-group >` part, but without it, we cannot override the sizing.\n\n\n.input-group > .input-group-prepend > .btn,\n.input-group > .input-group-prepend > .input-group-text,\n.input-group > .input-group-append:not(:last-child) > .btn,\n.input-group > .input-group-append:not(:last-child) > .input-group-text,\n.input-group > .input-group-append:last-child > .btn:not(:last-child):not(.dropdown-toggle),\n.input-group > .input-group-append:last-child > .input-group-text:not(:last-child) {\n  @include border-right-radius(0);\n}\n\n.input-group > .input-group-append > .btn,\n.input-group > .input-group-append > .input-group-text,\n.input-group > .input-group-prepend:not(:first-child) > .btn,\n.input-group > .input-group-prepend:not(:first-child) > .input-group-text,\n.input-group > .input-group-prepend:first-child > .btn:not(:first-child),\n.input-group > .input-group-prepend:first-child > .input-group-text:not(:first-child) {\n  @include border-left-radius(0);\n}\n","// Embedded icons from Open Iconic.\n// Released under MIT and copyright 2014 Waybury.\n// https://useiconic.com/open\n\n\n// Checkboxes and radios\n//\n// Base class takes care of all the key behavioral aspects.\n\n.custom-control {\n  position: relative;\n  display: block;\n  min-height: $font-size-base * $line-height-base;\n  padding-left: $custom-control-gutter + $custom-control-indicator-size;\n}\n\n.custom-control-inline {\n  display: inline-flex;\n  margin-right: $custom-control-spacer-x;\n}\n\n.custom-control-input {\n  position: absolute;\n  z-index: -1; // Put the input behind the label so it doesn't overlay text\n  opacity: 0;\n\n  &:checked ~ .custom-control-label::before {\n    color: $custom-control-indicator-checked-color;\n    border-color: $custom-control-indicator-checked-border-color;\n    @include gradient-bg($custom-control-indicator-checked-bg);\n    @include box-shadow($custom-control-indicator-checked-box-shadow);\n  }\n\n  &:focus ~ .custom-control-label::before {\n    // the mixin is not used here to make sure there is feedback\n    @if $enable-shadows {\n      box-shadow: $input-box-shadow, $input-focus-box-shadow;\n    } @else {\n      box-shadow: $custom-control-indicator-focus-box-shadow;\n    }\n  }\n\n  &:focus:not(:checked) ~ .custom-control-label::before {\n    border-color: $custom-control-indicator-focus-border-color;\n  }\n\n  &:not(:disabled):active ~ .custom-control-label::before {\n    color: $custom-control-indicator-active-color;\n    background-color: $custom-control-indicator-active-bg;\n    border-color: $custom-control-indicator-active-border-color;\n    @include box-shadow($custom-control-indicator-active-box-shadow);\n  }\n\n  &:disabled {\n    ~ .custom-control-label {\n      color: $custom-control-label-disabled-color;\n\n      &::before {\n        background-color: $custom-control-indicator-disabled-bg;\n      }\n    }\n  }\n}\n\n// Custom control indicators\n//\n// Build the custom controls out of pseudo-elements.\n\n.custom-control-label {\n  position: relative;\n  margin-bottom: 0;\n  vertical-align: top;\n\n  // Background-color and (when enabled) gradient\n  &::before {\n    position: absolute;\n    top: ($font-size-base * $line-height-base - $custom-control-indicator-size) / 2;\n    left: -($custom-control-gutter + $custom-control-indicator-size);\n    display: block;\n    width: $custom-control-indicator-size;\n    height: $custom-control-indicator-size;\n    pointer-events: none;\n    content: \"\";\n    background-color: $custom-control-indicator-bg;\n    border: $custom-control-indicator-border-color solid $custom-control-indicator-border-width;\n    @include box-shadow($custom-control-indicator-box-shadow);\n  }\n\n  // Foreground (icon)\n  &::after {\n    position: absolute;\n    top: ($font-size-base * $line-height-base - $custom-control-indicator-size) / 2;\n    left: -($custom-control-gutter + $custom-control-indicator-size);\n    display: block;\n    width: $custom-control-indicator-size;\n    height: $custom-control-indicator-size;\n    content: \"\";\n    background: no-repeat 50% / #{$custom-control-indicator-bg-size};\n  }\n}\n\n\n// Checkboxes\n//\n// Tweak just a few things for checkboxes.\n\n.custom-checkbox {\n  .custom-control-label::before {\n    @include border-radius($custom-checkbox-indicator-border-radius);\n  }\n\n  .custom-control-input:checked ~ .custom-control-label {\n    &::after {\n      background-image: $custom-checkbox-indicator-icon-checked;\n    }\n  }\n\n  .custom-control-input:indeterminate ~ .custom-control-label {\n    &::before {\n      border-color: $custom-checkbox-indicator-indeterminate-border-color;\n      @include gradient-bg($custom-checkbox-indicator-indeterminate-bg);\n      @include box-shadow($custom-checkbox-indicator-indeterminate-box-shadow);\n    }\n    &::after {\n      background-image: $custom-checkbox-indicator-icon-indeterminate;\n    }\n  }\n\n  .custom-control-input:disabled {\n    &:checked ~ .custom-control-label::before {\n      background-color: $custom-control-indicator-checked-disabled-bg;\n    }\n    &:indeterminate ~ .custom-control-label::before {\n      background-color: $custom-control-indicator-checked-disabled-bg;\n    }\n  }\n}\n\n// Radios\n//\n// Tweak just a few things for radios.\n\n.custom-radio {\n  .custom-control-label::before {\n    // stylelint-disable-next-line property-blacklist\n    border-radius: $custom-radio-indicator-border-radius;\n  }\n\n  .custom-control-input:checked ~ .custom-control-label {\n    &::after {\n      background-image: $custom-radio-indicator-icon-checked;\n    }\n  }\n\n  .custom-control-input:disabled {\n    &:checked ~ .custom-control-label::before {\n      background-color: $custom-control-indicator-checked-disabled-bg;\n    }\n  }\n}\n\n\n// switches\n//\n// Tweak a few things for switches\n\n.custom-switch {\n  padding-left: $custom-switch-width + $custom-control-gutter;\n\n  .custom-control-label {\n    &::before {\n      left: -($custom-switch-width + $custom-control-gutter);\n      width: $custom-switch-width;\n      pointer-events: all;\n      // stylelint-disable-next-line property-blacklist\n      border-radius: $custom-switch-indicator-border-radius;\n    }\n\n    &::after {\n      top: calc(#{(($font-size-base * $line-height-base - $custom-control-indicator-size) / 2)} + #{$custom-control-indicator-border-width * 2});\n      left: calc(#{-($custom-switch-width + $custom-control-gutter)} + #{$custom-control-indicator-border-width * 2});\n      width: $custom-switch-indicator-size;\n      height: $custom-switch-indicator-size;\n      background-color: $custom-control-indicator-border-color;\n      // stylelint-disable-next-line property-blacklist\n      border-radius: $custom-switch-indicator-border-radius;\n      @include transition(transform .15s ease-in-out, $custom-forms-transition);\n    }\n  }\n\n  .custom-control-input:checked ~ .custom-control-label {\n    &::after {\n      background-color: $custom-control-indicator-bg;\n      transform: translateX($custom-switch-width - $custom-control-indicator-size);\n    }\n  }\n\n  .custom-control-input:disabled {\n    &:checked ~ .custom-control-label::before {\n      background-color: $custom-control-indicator-checked-disabled-bg;\n    }\n  }\n}\n\n\n// Select\n//\n// Replaces the browser default select with a custom one, mostly pulled from\n// https://primer.github.io/.\n//\n\n.custom-select {\n  display: inline-block;\n  width: 100%;\n  height: $custom-select-height;\n  padding: $custom-select-padding-y ($custom-select-padding-x + $custom-select-indicator-padding) $custom-select-padding-y $custom-select-padding-x;\n  font-family: $custom-select-font-family;\n  @include font-size($custom-select-font-size);\n  font-weight: $custom-select-font-weight;\n  line-height: $custom-select-line-height;\n  color: $custom-select-color;\n  vertical-align: middle;\n  background: $custom-select-background;\n  background-color: $custom-select-bg;\n  border: $custom-select-border-width solid $custom-select-border-color;\n  @include border-radius($custom-select-border-radius, 0);\n  @include box-shadow($custom-select-box-shadow);\n  appearance: none;\n\n  &:focus {\n    border-color: $custom-select-focus-border-color;\n    outline: 0;\n    @if $enable-shadows {\n      box-shadow: $custom-select-box-shadow, $custom-select-focus-box-shadow;\n    } @else {\n      box-shadow: $custom-select-focus-box-shadow;\n    }\n\n    &::-ms-value {\n      // For visual consistency with other platforms/browsers,\n      // suppress the default white text on blue background highlight given to\n      // the selected option text when the (still closed) <select> receives focus\n      // in IE and (under certain conditions) Edge.\n      // See https://github.com/twbs/bootstrap/issues/19398.\n      color: $input-color;\n      background-color: $input-bg;\n    }\n  }\n\n  &[multiple],\n  &[size]:not([size=\"1\"]) {\n    height: auto;\n    padding-right: $custom-select-padding-x;\n    background-image: none;\n  }\n\n  &:disabled {\n    color: $custom-select-disabled-color;\n    background-color: $custom-select-disabled-bg;\n  }\n\n  // Hides the default caret in IE11\n  &::-ms-expand {\n    display: none;\n  }\n}\n\n.custom-select-sm {\n  height: $custom-select-height-sm;\n  padding-top: $custom-select-padding-y-sm;\n  padding-bottom: $custom-select-padding-y-sm;\n  padding-left: $custom-select-padding-x-sm;\n  @include font-size($custom-select-font-size-sm);\n}\n\n.custom-select-lg {\n  height: $custom-select-height-lg;\n  padding-top: $custom-select-padding-y-lg;\n  padding-bottom: $custom-select-padding-y-lg;\n  padding-left: $custom-select-padding-x-lg;\n  @include font-size($custom-select-font-size-lg);\n}\n\n\n// File\n//\n// Custom file input.\n\n.custom-file {\n  position: relative;\n  display: inline-block;\n  width: 100%;\n  height: $custom-file-height;\n  margin-bottom: 0;\n}\n\n.custom-file-input {\n  position: relative;\n  z-index: 2;\n  width: 100%;\n  height: $custom-file-height;\n  margin: 0;\n  opacity: 0;\n\n  &:focus ~ .custom-file-label {\n    border-color: $custom-file-focus-border-color;\n    box-shadow: $custom-file-focus-box-shadow;\n  }\n\n  &:disabled ~ .custom-file-label {\n    background-color: $custom-file-disabled-bg;\n  }\n\n  @each $lang, $value in $custom-file-text {\n    &:lang(#{$lang}) ~ .custom-file-label::after {\n      content: $value;\n    }\n  }\n\n  ~ .custom-file-label[data-browse]::after {\n    content: attr(data-browse);\n  }\n}\n\n.custom-file-label {\n  position: absolute;\n  top: 0;\n  right: 0;\n  left: 0;\n  z-index: 1;\n  height: $custom-file-height;\n  padding: $custom-file-padding-y $custom-file-padding-x;\n  font-family: $custom-file-font-family;\n  font-weight: $custom-file-font-weight;\n  line-height: $custom-file-line-height;\n  color: $custom-file-color;\n  background-color: $custom-file-bg;\n  border: $custom-file-border-width solid $custom-file-border-color;\n  @include border-radius($custom-file-border-radius);\n  @include box-shadow($custom-file-box-shadow);\n\n  &::after {\n    position: absolute;\n    top: 0;\n    right: 0;\n    bottom: 0;\n    z-index: 3;\n    display: block;\n    height: $custom-file-height-inner;\n    padding: $custom-file-padding-y $custom-file-padding-x;\n    line-height: $custom-file-line-height;\n    color: $custom-file-button-color;\n    content: \"Browse\";\n    @include gradient-bg($custom-file-button-bg);\n    border-left: inherit;\n    @include border-radius(0 $custom-file-border-radius $custom-file-border-radius 0);\n  }\n}\n\n// Range\n//\n// Style range inputs the same across browsers. Vendor-specific rules for pseudo\n// elements cannot be mixed. As such, there are no shared styles for focus or\n// active states on prefixed selectors.\n\n.custom-range {\n  width: 100%;\n  height: calc(#{$custom-range-thumb-height} + #{$custom-range-thumb-focus-box-shadow-width * 2});\n  padding: 0; // Need to reset padding\n  background-color: transparent;\n  appearance: none;\n\n  &:focus {\n    outline: none;\n\n    // Pseudo-elements must be split across multiple rulesets to have an effect.\n    // No box-shadow() mixin for focus accessibility.\n    &::-webkit-slider-thumb { box-shadow: $custom-range-thumb-focus-box-shadow; }\n    &::-moz-range-thumb     { box-shadow: $custom-range-thumb-focus-box-shadow; }\n    &::-ms-thumb            { box-shadow: $custom-range-thumb-focus-box-shadow; }\n  }\n\n  &::-moz-focus-outer {\n    border: 0;\n  }\n\n  &::-webkit-slider-thumb {\n    width: $custom-range-thumb-width;\n    height: $custom-range-thumb-height;\n    margin-top: ($custom-range-track-height - $custom-range-thumb-height) / 2; // Webkit specific\n    @include gradient-bg($custom-range-thumb-bg);\n    border: $custom-range-thumb-border;\n    @include border-radius($custom-range-thumb-border-radius);\n    @include box-shadow($custom-range-thumb-box-shadow);\n    @include transition($custom-forms-transition);\n    appearance: none;\n\n    &:active {\n      @include gradient-bg($custom-range-thumb-active-bg);\n    }\n  }\n\n  &::-webkit-slider-runnable-track {\n    width: $custom-range-track-width;\n    height: $custom-range-track-height;\n    color: transparent; // Why?\n    cursor: $custom-range-track-cursor;\n    background-color: $custom-range-track-bg;\n    border-color: transparent;\n    @include border-radius($custom-range-track-border-radius);\n    @include box-shadow($custom-range-track-box-shadow);\n  }\n\n  &::-moz-range-thumb {\n    width: $custom-range-thumb-width;\n    height: $custom-range-thumb-height;\n    @include gradient-bg($custom-range-thumb-bg);\n    border: $custom-range-thumb-border;\n    @include border-radius($custom-range-thumb-border-radius);\n    @include box-shadow($custom-range-thumb-box-shadow);\n    @include transition($custom-forms-transition);\n    appearance: none;\n\n    &:active {\n      @include gradient-bg($custom-range-thumb-active-bg);\n    }\n  }\n\n  &::-moz-range-track {\n    width: $custom-range-track-width;\n    height: $custom-range-track-height;\n    color: transparent;\n    cursor: $custom-range-track-cursor;\n    background-color: $custom-range-track-bg;\n    border-color: transparent; // Firefox specific?\n    @include border-radius($custom-range-track-border-radius);\n    @include box-shadow($custom-range-track-box-shadow);\n  }\n\n  &::-ms-thumb {\n    width: $custom-range-thumb-width;\n    height: $custom-range-thumb-height;\n    margin-top: 0; // Edge specific\n    margin-right: $custom-range-thumb-focus-box-shadow-width; // Workaround that overflowed box-shadow is hidden.\n    margin-left: $custom-range-thumb-focus-box-shadow-width;  // Workaround that overflowed box-shadow is hidden.\n    @include gradient-bg($custom-range-thumb-bg);\n    border: $custom-range-thumb-border;\n    @include border-radius($custom-range-thumb-border-radius);\n    @include box-shadow($custom-range-thumb-box-shadow);\n    @include transition($custom-forms-transition);\n    appearance: none;\n\n    &:active {\n      @include gradient-bg($custom-range-thumb-active-bg);\n    }\n  }\n\n  &::-ms-track {\n    width: $custom-range-track-width;\n    height: $custom-range-track-height;\n    color: transparent;\n    cursor: $custom-range-track-cursor;\n    background-color: transparent;\n    border-color: transparent;\n    border-width: $custom-range-thumb-height / 2;\n    @include box-shadow($custom-range-track-box-shadow);\n  }\n\n  &::-ms-fill-lower {\n    background-color: $custom-range-track-bg;\n    @include border-radius($custom-range-track-border-radius);\n  }\n\n  &::-ms-fill-upper {\n    margin-right: 15px; // arbitrary?\n    background-color: $custom-range-track-bg;\n    @include border-radius($custom-range-track-border-radius);\n  }\n\n  &:disabled {\n    &::-webkit-slider-thumb {\n      background-color: $custom-range-thumb-disabled-bg;\n    }\n\n    &::-webkit-slider-runnable-track {\n      cursor: default;\n    }\n\n    &::-moz-range-thumb {\n      background-color: $custom-range-thumb-disabled-bg;\n    }\n\n    &::-moz-range-track {\n      cursor: default;\n    }\n\n    &::-ms-thumb {\n      background-color: $custom-range-thumb-disabled-bg;\n    }\n  }\n}\n\n.custom-control-label::before,\n.custom-file-label,\n.custom-select {\n  @include transition($custom-forms-transition);\n}\n","// Base class\n//\n// Kickstart any navigation component with a set of style resets. Works with\n// `<nav>`s or `<ul>`s.\n\n.nav {\n  display: flex;\n  flex-wrap: wrap;\n  padding-left: 0;\n  margin-bottom: 0;\n  list-style: none;\n}\n\n.nav-link {\n  display: block;\n  padding: $nav-link-padding-y $nav-link-padding-x;\n\n  @include hover-focus {\n    text-decoration: none;\n  }\n\n  // Disabled state lightens text\n  &.disabled {\n    color: $nav-link-disabled-color;\n    pointer-events: none;\n    cursor: default;\n  }\n}\n\n//\n// Tabs\n//\n\n.nav-tabs {\n  border-bottom: $nav-tabs-border-width solid $nav-tabs-border-color;\n\n  .nav-item {\n    margin-bottom: -$nav-tabs-border-width;\n  }\n\n  .nav-link {\n    border: $nav-tabs-border-width solid transparent;\n    @include border-top-radius($nav-tabs-border-radius);\n\n    @include hover-focus {\n      border-color: $nav-tabs-link-hover-border-color;\n    }\n\n    &.disabled {\n      color: $nav-link-disabled-color;\n      background-color: transparent;\n      border-color: transparent;\n    }\n  }\n\n  .nav-link.active,\n  .nav-item.show .nav-link {\n    color: $nav-tabs-link-active-color;\n    background-color: $nav-tabs-link-active-bg;\n    border-color: $nav-tabs-link-active-border-color;\n  }\n\n  .dropdown-menu {\n    // Make dropdown border overlap tab border\n    margin-top: -$nav-tabs-border-width;\n    // Remove the top rounded corners here since there is a hard edge above the menu\n    @include border-top-radius(0);\n  }\n}\n\n\n//\n// Pills\n//\n\n.nav-pills {\n  .nav-link {\n    @include border-radius($nav-pills-border-radius);\n  }\n\n  .nav-link.active,\n  .show > .nav-link {\n    color: $nav-pills-link-active-color;\n    background-color: $nav-pills-link-active-bg;\n  }\n}\n\n\n//\n// Justified variants\n//\n\n.nav-fill {\n  .nav-item {\n    flex: 1 1 auto;\n    text-align: center;\n  }\n}\n\n.nav-justified {\n  .nav-item {\n    flex-basis: 0;\n    flex-grow: 1;\n    text-align: center;\n  }\n}\n\n\n// Tabbable tabs\n//\n// Hide tabbable panes to start, show them when `.active`\n\n.tab-content {\n  > .tab-pane {\n    display: none;\n  }\n  > .active {\n    display: block;\n  }\n}\n","// Contents\n//\n// Navbar\n// Navbar brand\n// Navbar nav\n// Navbar text\n// Navbar divider\n// Responsive navbar\n// Navbar position\n// Navbar themes\n\n\n// Navbar\n//\n// Provide a static navbar from which we expand to create full-width, fixed, and\n// other navbar variations.\n\n.navbar {\n  position: relative;\n  display: flex;\n  flex-wrap: wrap; // allow us to do the line break for collapsing content\n  align-items: center;\n  justify-content: space-between; // space out brand from logo\n  padding: $navbar-padding-y $navbar-padding-x;\n\n  // Because flex properties aren't inherited, we need to redeclare these first\n  // few properties so that content nested within behave properly.\n  > .container,\n  > .container-fluid {\n    display: flex;\n    flex-wrap: wrap;\n    align-items: center;\n    justify-content: space-between;\n  }\n}\n\n\n// Navbar brand\n//\n// Used for brand, project, or site names.\n\n.navbar-brand {\n  display: inline-block;\n  padding-top: $navbar-brand-padding-y;\n  padding-bottom: $navbar-brand-padding-y;\n  margin-right: $navbar-padding-x;\n  @include font-size($navbar-brand-font-size);\n  line-height: inherit;\n  white-space: nowrap;\n\n  @include hover-focus {\n    text-decoration: none;\n  }\n}\n\n\n// Navbar nav\n//\n// Custom navbar navigation (doesn't require `.nav`, but does make use of `.nav-link`).\n\n.navbar-nav {\n  display: flex;\n  flex-direction: column; // cannot use `inherit` to get the `.navbar`s value\n  padding-left: 0;\n  margin-bottom: 0;\n  list-style: none;\n\n  .nav-link {\n    padding-right: 0;\n    padding-left: 0;\n  }\n\n  .dropdown-menu {\n    position: static;\n    float: none;\n  }\n}\n\n\n// Navbar text\n//\n//\n\n.navbar-text {\n  display: inline-block;\n  padding-top: $nav-link-padding-y;\n  padding-bottom: $nav-link-padding-y;\n}\n\n\n// Responsive navbar\n//\n// Custom styles for responsive collapsing and toggling of navbar contents.\n// Powered by the collapse Bootstrap JavaScript plugin.\n\n// When collapsed, prevent the toggleable navbar contents from appearing in\n// the default flexbox row orientation. Requires the use of `flex-wrap: wrap`\n// on the `.navbar` parent.\n.navbar-collapse {\n  flex-basis: 100%;\n  flex-grow: 1;\n  // For always expanded or extra full navbars, ensure content aligns itself\n  // properly vertically. Can be easily overridden with flex utilities.\n  align-items: center;\n}\n\n// Button for toggling the navbar when in its collapsed state\n.navbar-toggler {\n  padding: $navbar-toggler-padding-y $navbar-toggler-padding-x;\n  @include font-size($navbar-toggler-font-size);\n  line-height: 1;\n  background-color: transparent; // remove default button style\n  border: $border-width solid transparent; // remove default button style\n  @include border-radius($navbar-toggler-border-radius);\n\n  @include hover-focus {\n    text-decoration: none;\n  }\n}\n\n// Keep as a separate element so folks can easily override it with another icon\n// or image file as needed.\n.navbar-toggler-icon {\n  display: inline-block;\n  width: 1.5em;\n  height: 1.5em;\n  vertical-align: middle;\n  content: \"\";\n  background: no-repeat center center;\n  background-size: 100% 100%;\n}\n\n// Generate series of `.navbar-expand-*` responsive classes for configuring\n// where your navbar collapses.\n.navbar-expand {\n  @each $breakpoint in map-keys($grid-breakpoints) {\n    $next: breakpoint-next($breakpoint, $grid-breakpoints);\n    $infix: breakpoint-infix($next, $grid-breakpoints);\n\n    &#{$infix} {\n      @include media-breakpoint-down($breakpoint) {\n        > .container,\n        > .container-fluid {\n          padding-right: 0;\n          padding-left: 0;\n        }\n      }\n\n      @include media-breakpoint-up($next) {\n        flex-flow: row nowrap;\n        justify-content: flex-start;\n\n        .navbar-nav {\n          flex-direction: row;\n\n          .dropdown-menu {\n            position: absolute;\n          }\n\n          .nav-link {\n            padding-right: $navbar-nav-link-padding-x;\n            padding-left: $navbar-nav-link-padding-x;\n          }\n        }\n\n        // For nesting containers, have to redeclare for alignment purposes\n        > .container,\n        > .container-fluid {\n          flex-wrap: nowrap;\n        }\n\n        .navbar-collapse {\n          display: flex !important; // stylelint-disable-line declaration-no-important\n\n          // Changes flex-bases to auto because of an IE10 bug\n          flex-basis: auto;\n        }\n\n        .navbar-toggler {\n          display: none;\n        }\n      }\n    }\n  }\n}\n\n\n// Navbar themes\n//\n// Styles for switching between navbars with light or dark background.\n\n// Dark links against a light background\n.navbar-light {\n  .navbar-brand {\n    color: $navbar-light-brand-color;\n\n    @include hover-focus {\n      color: $navbar-light-brand-hover-color;\n    }\n  }\n\n  .navbar-nav {\n    .nav-link {\n      color: $navbar-light-color;\n\n      @include hover-focus {\n        color: $navbar-light-hover-color;\n      }\n\n      &.disabled {\n        color: $navbar-light-disabled-color;\n      }\n    }\n\n    .show > .nav-link,\n    .active > .nav-link,\n    .nav-link.show,\n    .nav-link.active {\n      color: $navbar-light-active-color;\n    }\n  }\n\n  .navbar-toggler {\n    color: $navbar-light-color;\n    border-color: $navbar-light-toggler-border-color;\n  }\n\n  .navbar-toggler-icon {\n    background-image: $navbar-light-toggler-icon-bg;\n  }\n\n  .navbar-text {\n    color: $navbar-light-color;\n    a {\n      color: $navbar-light-active-color;\n\n      @include hover-focus {\n        color: $navbar-light-active-color;\n      }\n    }\n  }\n}\n\n// White links against a dark background\n.navbar-dark {\n  .navbar-brand {\n    color: $navbar-dark-brand-color;\n\n    @include hover-focus {\n      color: $navbar-dark-brand-hover-color;\n    }\n  }\n\n  .navbar-nav {\n    .nav-link {\n      color: $navbar-dark-color;\n\n      @include hover-focus {\n        color: $navbar-dark-hover-color;\n      }\n\n      &.disabled {\n        color: $navbar-dark-disabled-color;\n      }\n    }\n\n    .show > .nav-link,\n    .active > .nav-link,\n    .nav-link.show,\n    .nav-link.active {\n      color: $navbar-dark-active-color;\n    }\n  }\n\n  .navbar-toggler {\n    color: $navbar-dark-color;\n    border-color: $navbar-dark-toggler-border-color;\n  }\n\n  .navbar-toggler-icon {\n    background-image: $navbar-dark-toggler-icon-bg;\n  }\n\n  .navbar-text {\n    color: $navbar-dark-color;\n    a {\n      color: $navbar-dark-active-color;\n\n      @include hover-focus {\n        color: $navbar-dark-active-color;\n      }\n    }\n  }\n}\n","//\n// Base styles\n//\n\n.card {\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  min-width: 0; // See https://github.com/twbs/bootstrap/pull/22740#issuecomment-305868106\n  word-wrap: break-word;\n  background-color: $card-bg;\n  background-clip: border-box;\n  border: $card-border-width solid $card-border-color;\n  @include border-radius($card-border-radius);\n\n  > hr {\n    margin-right: 0;\n    margin-left: 0;\n  }\n\n  > .list-group:first-child {\n    .list-group-item:first-child {\n      @include border-top-radius($card-border-radius);\n    }\n  }\n\n  > .list-group:last-child {\n    .list-group-item:last-child {\n      @include border-bottom-radius($card-border-radius);\n    }\n  }\n}\n\n.card-body {\n  // Enable `flex-grow: 1` for decks and groups so that card blocks take up\n  // as much space as possible, ensuring footers are aligned to the bottom.\n  flex: 1 1 auto;\n  padding: $card-spacer-x;\n  color: $card-color;\n}\n\n.card-title {\n  margin-bottom: $card-spacer-y;\n}\n\n.card-subtitle {\n  margin-top: -$card-spacer-y / 2;\n  margin-bottom: 0;\n}\n\n.card-text:last-child {\n  margin-bottom: 0;\n}\n\n.card-link {\n  @include hover {\n    text-decoration: none;\n  }\n\n  + .card-link {\n    margin-left: $card-spacer-x;\n  }\n}\n\n//\n// Optional textual caps\n//\n\n.card-header {\n  padding: $card-spacer-y $card-spacer-x;\n  margin-bottom: 0; // Removes the default margin-bottom of <hN>\n  color: $card-cap-color;\n  background-color: $card-cap-bg;\n  border-bottom: $card-border-width solid $card-border-color;\n\n  &:first-child {\n    @include border-radius($card-inner-border-radius $card-inner-border-radius 0 0);\n  }\n\n  + .list-group {\n    .list-group-item:first-child {\n      border-top: 0;\n    }\n  }\n}\n\n.card-footer {\n  padding: $card-spacer-y $card-spacer-x;\n  background-color: $card-cap-bg;\n  border-top: $card-border-width solid $card-border-color;\n\n  &:last-child {\n    @include border-radius(0 0 $card-inner-border-radius $card-inner-border-radius);\n  }\n}\n\n\n//\n// Header navs\n//\n\n.card-header-tabs {\n  margin-right: -$card-spacer-x / 2;\n  margin-bottom: -$card-spacer-y;\n  margin-left: -$card-spacer-x / 2;\n  border-bottom: 0;\n}\n\n.card-header-pills {\n  margin-right: -$card-spacer-x / 2;\n  margin-left: -$card-spacer-x / 2;\n}\n\n// Card image\n.card-img-overlay {\n  position: absolute;\n  top: 0;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  padding: $card-img-overlay-padding;\n}\n\n.card-img {\n  width: 100%; // Required because we use flexbox and this inherently applies align-self: stretch\n  @include border-radius($card-inner-border-radius);\n}\n\n// Card image caps\n.card-img-top {\n  width: 100%; // Required because we use flexbox and this inherently applies align-self: stretch\n  @include border-top-radius($card-inner-border-radius);\n}\n\n.card-img-bottom {\n  width: 100%; // Required because we use flexbox and this inherently applies align-self: stretch\n  @include border-bottom-radius($card-inner-border-radius);\n}\n\n\n// Card deck\n\n.card-deck {\n  display: flex;\n  flex-direction: column;\n\n  .card {\n    margin-bottom: $card-deck-margin;\n  }\n\n  @include media-breakpoint-up(sm) {\n    flex-flow: row wrap;\n    margin-right: -$card-deck-margin;\n    margin-left: -$card-deck-margin;\n\n    .card {\n      display: flex;\n      // Flexbugs #4: https://github.com/philipwalton/flexbugs#flexbug-4\n      flex: 1 0 0%;\n      flex-direction: column;\n      margin-right: $card-deck-margin;\n      margin-bottom: 0; // Override the default\n      margin-left: $card-deck-margin;\n    }\n  }\n}\n\n\n//\n// Card groups\n//\n\n.card-group {\n  display: flex;\n  flex-direction: column;\n\n  // The child selector allows nested `.card` within `.card-group`\n  // to display properly.\n  > .card {\n    margin-bottom: $card-group-margin;\n  }\n\n  @include media-breakpoint-up(sm) {\n    flex-flow: row wrap;\n    // The child selector allows nested `.card` within `.card-group`\n    // to display properly.\n    > .card {\n      // Flexbugs #4: https://github.com/philipwalton/flexbugs#flexbug-4\n      flex: 1 0 0%;\n      margin-bottom: 0;\n\n      + .card {\n        margin-left: 0;\n        border-left: 0;\n      }\n\n      // Handle rounded corners\n      @if $enable-rounded {\n        &:not(:last-child) {\n          @include border-right-radius(0);\n\n          .card-img-top,\n          .card-header {\n            // stylelint-disable-next-line property-blacklist\n            border-top-right-radius: 0;\n          }\n          .card-img-bottom,\n          .card-footer {\n            // stylelint-disable-next-line property-blacklist\n            border-bottom-right-radius: 0;\n          }\n        }\n\n        &:not(:first-child) {\n          @include border-left-radius(0);\n\n          .card-img-top,\n          .card-header {\n            // stylelint-disable-next-line property-blacklist\n            border-top-left-radius: 0;\n          }\n          .card-img-bottom,\n          .card-footer {\n            // stylelint-disable-next-line property-blacklist\n            border-bottom-left-radius: 0;\n          }\n        }\n      }\n    }\n  }\n}\n\n\n//\n// Columns\n//\n\n.card-columns {\n  .card {\n    margin-bottom: $card-columns-margin;\n  }\n\n  @include media-breakpoint-up(sm) {\n    column-count: $card-columns-count;\n    column-gap: $card-columns-gap;\n    orphans: 1;\n    widows: 1;\n\n    .card {\n      display: inline-block; // Don't let them vertically span multiple columns\n      width: 100%; // Don't let their width change\n    }\n  }\n}\n\n\n//\n// Accordion\n//\n\n.accordion {\n  > .card {\n    overflow: hidden;\n\n    &:not(:first-of-type) {\n      .card-header:first-child {\n        @include border-radius(0);\n      }\n\n      &:not(:last-of-type) {\n        border-bottom: 0;\n        @include border-radius(0);\n      }\n    }\n\n    &:first-of-type {\n      border-bottom: 0;\n      @include border-bottom-radius(0);\n    }\n\n    &:last-of-type {\n      @include border-top-radius(0);\n    }\n\n    .card-header {\n      margin-bottom: -$card-border-width;\n    }\n  }\n}\n",".breadcrumb {\n  display: flex;\n  flex-wrap: wrap;\n  padding: $breadcrumb-padding-y $breadcrumb-padding-x;\n  margin-bottom: $breadcrumb-margin-bottom;\n  list-style: none;\n  background-color: $breadcrumb-bg;\n  @include border-radius($breadcrumb-border-radius);\n}\n\n.breadcrumb-item {\n  // The separator between breadcrumbs (by default, a forward-slash: \"/\")\n  + .breadcrumb-item {\n    padding-left: $breadcrumb-item-padding;\n\n    &::before {\n      display: inline-block; // Suppress underlining of the separator in modern browsers\n      padding-right: $breadcrumb-item-padding;\n      color: $breadcrumb-divider-color;\n      content: $breadcrumb-divider;\n    }\n  }\n\n  // IE9-11 hack to properly handle hyperlink underlines for breadcrumbs built\n  // without `<ul>`s. The `::before` pseudo-element generates an element\n  // *within* the .breadcrumb-item and thereby inherits the `text-decoration`.\n  //\n  // To trick IE into suppressing the underline, we give the pseudo-element an\n  // underline and then immediately remove it.\n  + .breadcrumb-item:hover::before {\n    text-decoration: underline;\n  }\n  // stylelint-disable-next-line no-duplicate-selectors\n  + .breadcrumb-item:hover::before {\n    text-decoration: none;\n  }\n\n  &.active {\n    color: $breadcrumb-active-color;\n  }\n}\n",".pagination {\n  display: flex;\n  @include list-unstyled();\n  @include border-radius();\n}\n\n.page-link {\n  position: relative;\n  display: block;\n  padding: $pagination-padding-y $pagination-padding-x;\n  margin-left: -$pagination-border-width;\n  line-height: $pagination-line-height;\n  color: $pagination-color;\n  background-color: $pagination-bg;\n  border: $pagination-border-width solid $pagination-border-color;\n\n  &:hover {\n    z-index: 2;\n    color: $pagination-hover-color;\n    text-decoration: none;\n    background-color: $pagination-hover-bg;\n    border-color: $pagination-hover-border-color;\n  }\n\n  &:focus {\n    z-index: 2;\n    outline: $pagination-focus-outline;\n    box-shadow: $pagination-focus-box-shadow;\n  }\n}\n\n.page-item {\n  &:first-child {\n    .page-link {\n      margin-left: 0;\n      @include border-left-radius($border-radius);\n    }\n  }\n  &:last-child {\n    .page-link {\n      @include border-right-radius($border-radius);\n    }\n  }\n\n  &.active .page-link {\n    z-index: 1;\n    color: $pagination-active-color;\n    background-color: $pagination-active-bg;\n    border-color: $pagination-active-border-color;\n  }\n\n  &.disabled .page-link {\n    color: $pagination-disabled-color;\n    pointer-events: none;\n    // Opinionated: remove the \"hand\" cursor set previously for .page-link\n    cursor: auto;\n    background-color: $pagination-disabled-bg;\n    border-color: $pagination-disabled-border-color;\n  }\n}\n\n\n//\n// Sizing\n//\n\n.pagination-lg {\n  @include pagination-size($pagination-padding-y-lg, $pagination-padding-x-lg, $font-size-lg, $line-height-lg, $border-radius-lg);\n}\n\n.pagination-sm {\n  @include pagination-size($pagination-padding-y-sm, $pagination-padding-x-sm, $font-size-sm, $line-height-sm, $border-radius-sm);\n}\n","// Pagination\n\n@mixin pagination-size($padding-y, $padding-x, $font-size, $line-height, $border-radius) {\n  .page-link {\n    padding: $padding-y $padding-x;\n    @include font-size($font-size);\n    line-height: $line-height;\n  }\n\n  .page-item {\n    &:first-child {\n      .page-link {\n        @include border-left-radius($border-radius);\n      }\n    }\n    &:last-child {\n      .page-link {\n        @include border-right-radius($border-radius);\n      }\n    }\n  }\n}\n","// Base class\n//\n// Requires one of the contextual, color modifier classes for `color` and\n// `background-color`.\n\n.badge {\n  display: inline-block;\n  padding: $badge-padding-y $badge-padding-x;\n  @include font-size($badge-font-size);\n  font-weight: $badge-font-weight;\n  line-height: 1;\n  text-align: center;\n  white-space: nowrap;\n  vertical-align: baseline;\n  @include border-radius($badge-border-radius);\n  @include transition($badge-transition);\n\n  @at-root a#{&} {\n    @include hover-focus {\n      text-decoration: none;\n    }\n  }\n\n  // Empty badges collapse automatically\n  &:empty {\n    display: none;\n  }\n}\n\n// Quick fix for badges in buttons\n.btn .badge {\n  position: relative;\n  top: -1px;\n}\n\n// Pill badges\n//\n// Make them extra rounded with a modifier to replace v3's badges.\n\n.badge-pill {\n  padding-right: $badge-pill-padding-x;\n  padding-left: $badge-pill-padding-x;\n  @include border-radius($badge-pill-border-radius);\n}\n\n// Colors\n//\n// Contextual variations (linked badges get darker on :hover).\n\n@each $color, $value in $theme-colors {\n  .badge-#{$color} {\n    @include badge-variant($value);\n  }\n}\n","@mixin badge-variant($bg) {\n  color: color-yiq($bg);\n  background-color: $bg;\n\n  @at-root a#{&} {\n    @include hover-focus {\n      color: color-yiq($bg);\n      background-color: darken($bg, 10%);\n    }\n\n    &:focus,\n    &.focus {\n      outline: 0;\n      box-shadow: 0 0 0 $badge-focus-width rgba($bg, .5);\n    }\n  }\n}\n",".jumbotron {\n  padding: $jumbotron-padding ($jumbotron-padding / 2);\n  margin-bottom: $jumbotron-padding;\n  color: $jumbotron-color;\n  background-color: $jumbotron-bg;\n  @include border-radius($border-radius-lg);\n\n  @include media-breakpoint-up(sm) {\n    padding: ($jumbotron-padding * 2) $jumbotron-padding;\n  }\n}\n\n.jumbotron-fluid {\n  padding-right: 0;\n  padding-left: 0;\n  @include border-radius(0);\n}\n","//\n// Base styles\n//\n\n.alert {\n  position: relative;\n  padding: $alert-padding-y $alert-padding-x;\n  margin-bottom: $alert-margin-bottom;\n  border: $alert-border-width solid transparent;\n  @include border-radius($alert-border-radius);\n}\n\n// Headings for larger alerts\n.alert-heading {\n  // Specified to prevent conflicts of changing $headings-color\n  color: inherit;\n}\n\n// Provide class for links that match alerts\n.alert-link {\n  font-weight: $alert-link-font-weight;\n}\n\n\n// Dismissible alerts\n//\n// Expand the right padding and account for the close button's positioning.\n\n.alert-dismissible {\n  padding-right: $close-font-size + $alert-padding-x * 2;\n\n  // Adjust close link position\n  .close {\n    position: absolute;\n    top: 0;\n    right: 0;\n    padding: $alert-padding-y $alert-padding-x;\n    color: inherit;\n  }\n}\n\n\n// Alternate styles\n//\n// Generate contextual modifier classes for colorizing the alert.\n\n@each $color, $value in $theme-colors {\n  .alert-#{$color} {\n    @include alert-variant(theme-color-level($color, $alert-bg-level), theme-color-level($color, $alert-border-level), theme-color-level($color, $alert-color-level));\n  }\n}\n","@mixin alert-variant($background, $border, $color) {\n  color: $color;\n  @include gradient-bg($background);\n  border-color: $border;\n\n  hr {\n    border-top-color: darken($border, 5%);\n  }\n\n  .alert-link {\n    color: darken($color, 10%);\n  }\n}\n","// Disable animation if transitions are disabled\n@if $enable-transitions {\n  @keyframes progress-bar-stripes {\n    from { background-position: $progress-height 0; }\n    to { background-position: 0 0; }\n  }\n}\n\n.progress {\n  display: flex;\n  height: $progress-height;\n  overflow: hidden; // force rounded corners by cropping it\n  @include font-size($progress-font-size);\n  background-color: $progress-bg;\n  @include border-radius($progress-border-radius);\n  @include box-shadow($progress-box-shadow);\n}\n\n.progress-bar {\n  display: flex;\n  flex-direction: column;\n  justify-content: center;\n  color: $progress-bar-color;\n  text-align: center;\n  white-space: nowrap;\n  background-color: $progress-bar-bg;\n  @include transition($progress-bar-transition);\n}\n\n.progress-bar-striped {\n  @include gradient-striped();\n  background-size: $progress-height $progress-height;\n}\n\n@if $enable-transitions {\n  .progress-bar-animated {\n    animation: progress-bar-stripes $progress-bar-animation-timing;\n\n    @media (prefers-reduced-motion: reduce) {\n      animation: none;\n    }\n  }\n}\n",".media {\n  display: flex;\n  align-items: flex-start;\n}\n\n.media-body {\n  flex: 1;\n}\n","// Base class\n//\n// Easily usable on <ul>, <ol>, or <div>.\n\n.list-group {\n  display: flex;\n  flex-direction: column;\n\n  // No need to set list-style: none; since .list-group-item is block level\n  padding-left: 0; // reset padding because ul and ol\n  margin-bottom: 0;\n}\n\n\n// Interactive list items\n//\n// Use anchor or button elements instead of `li`s or `div`s to create interactive\n// list items. Includes an extra `.active` modifier class for selected items.\n\n.list-group-item-action {\n  width: 100%; // For `<button>`s (anchors become 100% by default though)\n  color: $list-group-action-color;\n  text-align: inherit; // For `<button>`s (anchors inherit)\n\n  // Hover state\n  @include hover-focus {\n    z-index: 1; // Place hover/focus items above their siblings for proper border styling\n    color: $list-group-action-hover-color;\n    text-decoration: none;\n    background-color: $list-group-hover-bg;\n  }\n\n  &:active {\n    color: $list-group-action-active-color;\n    background-color: $list-group-action-active-bg;\n  }\n}\n\n\n// Individual list items\n//\n// Use on `li`s or `div`s within the `.list-group` parent.\n\n.list-group-item {\n  position: relative;\n  display: block;\n  padding: $list-group-item-padding-y $list-group-item-padding-x;\n  // Place the border on the list items and negative margin up for better styling\n  margin-bottom: -$list-group-border-width;\n  color: $list-group-color;\n  background-color: $list-group-bg;\n  border: $list-group-border-width solid $list-group-border-color;\n\n  &:first-child {\n    @include border-top-radius($list-group-border-radius);\n  }\n\n  &:last-child {\n    margin-bottom: 0;\n    @include border-bottom-radius($list-group-border-radius);\n  }\n\n  &.disabled,\n  &:disabled {\n    color: $list-group-disabled-color;\n    pointer-events: none;\n    background-color: $list-group-disabled-bg;\n  }\n\n  // Include both here for `<a>`s and `<button>`s\n  &.active {\n    z-index: 2; // Place active items above their siblings for proper border styling\n    color: $list-group-active-color;\n    background-color: $list-group-active-bg;\n    border-color: $list-group-active-border-color;\n  }\n}\n\n\n// Horizontal\n//\n// Change the layout of list group items from vertical (default) to horizontal.\n\n@each $breakpoint in map-keys($grid-breakpoints) {\n  @include media-breakpoint-up($breakpoint) {\n    $infix: breakpoint-infix($breakpoint, $grid-breakpoints);\n\n    .list-group-horizontal#{$infix} {\n      flex-direction: row;\n\n      .list-group-item {\n        margin-right: -$list-group-border-width;\n        margin-bottom: 0;\n\n        &:first-child {\n          @include border-left-radius($list-group-border-radius);\n          @include border-top-right-radius(0);\n        }\n\n        &:last-child {\n          margin-right: 0;\n          @include border-right-radius($list-group-border-radius);\n          @include border-bottom-left-radius(0);\n        }\n      }\n    }\n  }\n}\n\n\n// Flush list items\n//\n// Remove borders and border-radius to keep list group items edge-to-edge. Most\n// useful within other components (e.g., cards).\n\n.list-group-flush {\n  .list-group-item {\n    border-right: 0;\n    border-left: 0;\n    @include border-radius(0);\n\n    &:last-child {\n      margin-bottom: -$list-group-border-width;\n    }\n  }\n\n  &:first-child {\n    .list-group-item:first-child {\n      border-top: 0;\n    }\n  }\n\n  &:last-child {\n    .list-group-item:last-child {\n      margin-bottom: 0;\n      border-bottom: 0;\n    }\n  }\n}\n\n\n// Contextual variants\n//\n// Add modifier classes to change text and background color on individual items.\n// Organizationally, this must come after the `:hover` states.\n\n@each $color, $value in $theme-colors {\n  @include list-group-item-variant($color, theme-color-level($color, -9), theme-color-level($color, 6));\n}\n","// List Groups\n\n@mixin list-group-item-variant($state, $background, $color) {\n  .list-group-item-#{$state} {\n    color: $color;\n    background-color: $background;\n\n    &.list-group-item-action {\n      @include hover-focus {\n        color: $color;\n        background-color: darken($background, 5%);\n      }\n\n      &.active {\n        color: $white;\n        background-color: $color;\n        border-color: $color;\n      }\n    }\n  }\n}\n",".close {\n  float: right;\n  @include font-size($close-font-size);\n  font-weight: $close-font-weight;\n  line-height: 1;\n  color: $close-color;\n  text-shadow: $close-text-shadow;\n  opacity: .5;\n\n  // Override <a>'s hover style\n  @include hover {\n    color: $close-color;\n    text-decoration: none;\n  }\n\n  &:not(:disabled):not(.disabled) {\n    @include hover-focus {\n      opacity: .75;\n    }\n  }\n}\n\n// Additional properties for button version\n// iOS requires the button element instead of an anchor tag.\n// If you want the anchor version, it requires `href=\"#\"`.\n// See https://developer.mozilla.org/en-US/docs/Web/Events/click#Safari_Mobile\n\n// stylelint-disable-next-line selector-no-qualifying-type\nbutton.close {\n  padding: 0;\n  background-color: transparent;\n  border: 0;\n  appearance: none;\n}\n\n// Future-proof disabling of clicks on `<a>` elements\n\n// stylelint-disable-next-line selector-no-qualifying-type\na.close.disabled {\n  pointer-events: none;\n}\n",".toast {\n  max-width: $toast-max-width;\n  overflow: hidden; // cheap rounded corners on nested items\n  @include font-size($toast-font-size);\n  color: $toast-color;\n  background-color: $toast-background-color;\n  background-clip: padding-box;\n  border: $toast-border-width solid $toast-border-color;\n  box-shadow: $toast-box-shadow;\n  backdrop-filter: blur(10px);\n  opacity: 0;\n  @include border-radius($toast-border-radius);\n\n  &:not(:last-child) {\n    margin-bottom: $toast-padding-x;\n  }\n\n  &.showing {\n    opacity: 1;\n  }\n\n  &.show {\n    display: block;\n    opacity: 1;\n  }\n\n  &.hide {\n    display: none;\n  }\n}\n\n.toast-header {\n  display: flex;\n  align-items: center;\n  padding: $toast-padding-y $toast-padding-x;\n  color: $toast-header-color;\n  background-color: $toast-header-background-color;\n  background-clip: padding-box;\n  border-bottom: $toast-border-width solid $toast-header-border-color;\n}\n\n.toast-body {\n  padding: $toast-padding-x; // apply to both vertical and horizontal\n}\n","// .modal-open      - body class for killing the scroll\n// .modal           - container to scroll within\n// .modal-dialog    - positioning shell for the actual modal\n// .modal-content   - actual modal w/ bg and corners and stuff\n\n\n.modal-open {\n  // Kill the scroll on the body\n  overflow: hidden;\n\n  .modal {\n    overflow-x: hidden;\n    overflow-y: auto;\n  }\n}\n\n// Container that the modal scrolls within\n.modal {\n  position: fixed;\n  top: 0;\n  left: 0;\n  z-index: $zindex-modal;\n  display: none;\n  width: 100%;\n  height: 100%;\n  overflow: hidden;\n  // Prevent Chrome on Windows from adding a focus outline. For details, see\n  // https://github.com/twbs/bootstrap/pull/10951.\n  outline: 0;\n  // We deliberately don't use `-webkit-overflow-scrolling: touch;` due to a\n  // gnarly iOS Safari bug: https://bugs.webkit.org/show_bug.cgi?id=158342\n  // See also https://github.com/twbs/bootstrap/issues/17695\n}\n\n// Shell div to position the modal with bottom padding\n.modal-dialog {\n  position: relative;\n  width: auto;\n  margin: $modal-dialog-margin;\n  // allow clicks to pass through for custom click handling to close modal\n  pointer-events: none;\n\n  // When fading in the modal, animate it to slide down\n  .modal.fade & {\n    @include transition($modal-transition);\n    transform: $modal-fade-transform;\n  }\n  .modal.show & {\n    transform: $modal-show-transform;\n  }\n}\n\n.modal-dialog-scrollable {\n  display: flex; // IE10/11\n  max-height: calc(100% - #{$modal-dialog-margin * 2});\n\n  .modal-content {\n    max-height: calc(100vh - #{$modal-dialog-margin * 2}); // IE10/11\n    overflow: hidden;\n  }\n\n  .modal-header,\n  .modal-footer {\n    flex-shrink: 0;\n  }\n\n  .modal-body {\n    overflow-y: auto;\n  }\n}\n\n.modal-dialog-centered {\n  display: flex;\n  align-items: center;\n  min-height: calc(100% - #{$modal-dialog-margin * 2});\n\n  // Ensure `modal-dialog-centered` extends the full height of the view (IE10/11)\n  &::before {\n    display: block; // IE10\n    height: calc(100vh - #{$modal-dialog-margin * 2});\n    content: \"\";\n  }\n\n  // Ensure `.modal-body` shows scrollbar (IE10/11)\n  &.modal-dialog-scrollable {\n    flex-direction: column;\n    justify-content: center;\n    height: 100%;\n\n    .modal-content {\n      max-height: none;\n    }\n\n    &::before {\n      content: none;\n    }\n  }\n}\n\n// Actual modal\n.modal-content {\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  width: 100%; // Ensure `.modal-content` extends the full width of the parent `.modal-dialog`\n  // counteract the pointer-events: none; in the .modal-dialog\n  color: $modal-content-color;\n  pointer-events: auto;\n  background-color: $modal-content-bg;\n  background-clip: padding-box;\n  border: $modal-content-border-width solid $modal-content-border-color;\n  @include border-radius($modal-content-border-radius);\n  @include box-shadow($modal-content-box-shadow-xs);\n  // Remove focus outline from opened modal\n  outline: 0;\n}\n\n// Modal background\n.modal-backdrop {\n  position: fixed;\n  top: 0;\n  left: 0;\n  z-index: $zindex-modal-backdrop;\n  width: 100vw;\n  height: 100vh;\n  background-color: $modal-backdrop-bg;\n\n  // Fade for backdrop\n  &.fade { opacity: 0; }\n  &.show { opacity: $modal-backdrop-opacity; }\n}\n\n// Modal header\n// Top section of the modal w/ title and dismiss\n.modal-header {\n  display: flex;\n  align-items: flex-start; // so the close btn always stays on the upper right corner\n  justify-content: space-between; // Put modal header elements (title and dismiss) on opposite ends\n  padding: $modal-header-padding;\n  border-bottom: $modal-header-border-width solid $modal-header-border-color;\n  @include border-top-radius($modal-content-border-radius);\n\n  .close {\n    padding: $modal-header-padding;\n    // auto on the left force icon to the right even when there is no .modal-title\n    margin: (-$modal-header-padding-y) (-$modal-header-padding-x) (-$modal-header-padding-y) auto;\n  }\n}\n\n// Title text within header\n.modal-title {\n  margin-bottom: 0;\n  line-height: $modal-title-line-height;\n}\n\n// Modal body\n// Where all modal content resides (sibling of .modal-header and .modal-footer)\n.modal-body {\n  position: relative;\n  // Enable `flex-grow: 1` so that the body take up as much space as possible\n  // when should there be a fixed height on `.modal-dialog`.\n  flex: 1 1 auto;\n  padding: $modal-inner-padding;\n}\n\n// Footer (for actions)\n.modal-footer {\n  display: flex;\n  align-items: center; // vertically center\n  justify-content: flex-end; // Right align buttons with flex property because text-align doesn't work on flex items\n  padding: $modal-inner-padding;\n  border-top: $modal-footer-border-width solid $modal-footer-border-color;\n  @include border-bottom-radius($modal-content-border-radius);\n\n  // Easily place margin between footer elements\n  > :not(:first-child) { margin-left: .25rem; }\n  > :not(:last-child) { margin-right: .25rem; }\n}\n\n// Measure scrollbar width for padding body during modal show/hide\n.modal-scrollbar-measure {\n  position: absolute;\n  top: -9999px;\n  width: 50px;\n  height: 50px;\n  overflow: scroll;\n}\n\n// Scale up the modal\n@include media-breakpoint-up(sm) {\n  // Automatically set modal's width for larger viewports\n  .modal-dialog {\n    max-width: $modal-md;\n    margin: $modal-dialog-margin-y-sm-up auto;\n  }\n\n  .modal-dialog-scrollable {\n    max-height: calc(100% - #{$modal-dialog-margin-y-sm-up * 2});\n\n    .modal-content {\n      max-height: calc(100vh - #{$modal-dialog-margin-y-sm-up * 2});\n    }\n  }\n\n  .modal-dialog-centered {\n    min-height: calc(100% - #{$modal-dialog-margin-y-sm-up * 2});\n\n    &::before {\n      height: calc(100vh - #{$modal-dialog-margin-y-sm-up * 2});\n    }\n  }\n\n  .modal-content {\n    @include box-shadow($modal-content-box-shadow-sm-up);\n  }\n\n  .modal-sm { max-width: $modal-sm; }\n}\n\n@include media-breakpoint-up(lg) {\n  .modal-lg,\n  .modal-xl {\n    max-width: $modal-lg;\n  }\n}\n\n@include media-breakpoint-up(xl) {\n  .modal-xl { max-width: $modal-xl; }\n}\n","// Base class\n.tooltip {\n  position: absolute;\n  z-index: $zindex-tooltip;\n  display: block;\n  margin: $tooltip-margin;\n  // Our parent element can be arbitrary since tooltips are by default inserted as a sibling of their target element.\n  // So reset our font and text properties to avoid inheriting weird values.\n  @include reset-text();\n  @include font-size($tooltip-font-size);\n  // Allow breaking very long words so they don't overflow the tooltip's bounds\n  word-wrap: break-word;\n  opacity: 0;\n\n  &.show { opacity: $tooltip-opacity; }\n\n  .arrow {\n    position: absolute;\n    display: block;\n    width: $tooltip-arrow-width;\n    height: $tooltip-arrow-height;\n\n    &::before {\n      position: absolute;\n      content: \"\";\n      border-color: transparent;\n      border-style: solid;\n    }\n  }\n}\n\n.bs-tooltip-top {\n  padding: $tooltip-arrow-height 0;\n\n  .arrow {\n    bottom: 0;\n\n    &::before {\n      top: 0;\n      border-width: $tooltip-arrow-height ($tooltip-arrow-width / 2) 0;\n      border-top-color: $tooltip-arrow-color;\n    }\n  }\n}\n\n.bs-tooltip-right {\n  padding: 0 $tooltip-arrow-height;\n\n  .arrow {\n    left: 0;\n    width: $tooltip-arrow-height;\n    height: $tooltip-arrow-width;\n\n    &::before {\n      right: 0;\n      border-width: ($tooltip-arrow-width / 2) $tooltip-arrow-height ($tooltip-arrow-width / 2) 0;\n      border-right-color: $tooltip-arrow-color;\n    }\n  }\n}\n\n.bs-tooltip-bottom {\n  padding: $tooltip-arrow-height 0;\n\n  .arrow {\n    top: 0;\n\n    &::before {\n      bottom: 0;\n      border-width: 0 ($tooltip-arrow-width / 2) $tooltip-arrow-height;\n      border-bottom-color: $tooltip-arrow-color;\n    }\n  }\n}\n\n.bs-tooltip-left {\n  padding: 0 $tooltip-arrow-height;\n\n  .arrow {\n    right: 0;\n    width: $tooltip-arrow-height;\n    height: $tooltip-arrow-width;\n\n    &::before {\n      left: 0;\n      border-width: ($tooltip-arrow-width / 2) 0 ($tooltip-arrow-width / 2) $tooltip-arrow-height;\n      border-left-color: $tooltip-arrow-color;\n    }\n  }\n}\n\n.bs-tooltip-auto {\n  &[x-placement^=\"top\"] {\n    @extend .bs-tooltip-top;\n  }\n  &[x-placement^=\"right\"] {\n    @extend .bs-tooltip-right;\n  }\n  &[x-placement^=\"bottom\"] {\n    @extend .bs-tooltip-bottom;\n  }\n  &[x-placement^=\"left\"] {\n    @extend .bs-tooltip-left;\n  }\n}\n\n// Wrapper for the tooltip content\n.tooltip-inner {\n  max-width: $tooltip-max-width;\n  padding: $tooltip-padding-y $tooltip-padding-x;\n  color: $tooltip-color;\n  text-align: center;\n  background-color: $tooltip-bg;\n  @include border-radius($tooltip-border-radius);\n}\n","@mixin reset-text {\n  font-family: $font-family-base;\n  // We deliberately do NOT reset font-size or word-wrap.\n  font-style: normal;\n  font-weight: $font-weight-normal;\n  line-height: $line-height-base;\n  text-align: left; // Fallback for where `start` is not supported\n  text-align: start;\n  text-decoration: none;\n  text-shadow: none;\n  text-transform: none;\n  letter-spacing: normal;\n  word-break: normal;\n  word-spacing: normal;\n  white-space: normal;\n  line-break: auto;\n}\n",".popover {\n  position: absolute;\n  top: 0;\n  left: 0;\n  z-index: $zindex-popover;\n  display: block;\n  max-width: $popover-max-width;\n  // Our parent element can be arbitrary since tooltips are by default inserted as a sibling of their target element.\n  // So reset our font and text properties to avoid inheriting weird values.\n  @include reset-text();\n  @include font-size($popover-font-size);\n  // Allow breaking very long words so they don't overflow the popover's bounds\n  word-wrap: break-word;\n  background-color: $popover-bg;\n  background-clip: padding-box;\n  border: $popover-border-width solid $popover-border-color;\n  @include border-radius($popover-border-radius);\n  @include box-shadow($popover-box-shadow);\n\n  .arrow {\n    position: absolute;\n    display: block;\n    width: $popover-arrow-width;\n    height: $popover-arrow-height;\n    margin: 0 $border-radius-lg;\n\n    &::before,\n    &::after {\n      position: absolute;\n      display: block;\n      content: \"\";\n      border-color: transparent;\n      border-style: solid;\n    }\n  }\n}\n\n.bs-popover-top {\n  margin-bottom: $popover-arrow-height;\n\n  > .arrow {\n    bottom: calc((#{$popover-arrow-height} + #{$popover-border-width}) * -1);\n\n    &::before {\n      bottom: 0;\n      border-width: $popover-arrow-height ($popover-arrow-width / 2) 0;\n      border-top-color: $popover-arrow-outer-color;\n    }\n\n    &::after {\n      bottom: $popover-border-width;\n      border-width: $popover-arrow-height ($popover-arrow-width / 2) 0;\n      border-top-color: $popover-arrow-color;\n    }\n  }\n}\n\n.bs-popover-right {\n  margin-left: $popover-arrow-height;\n\n  > .arrow {\n    left: calc((#{$popover-arrow-height} + #{$popover-border-width}) * -1);\n    width: $popover-arrow-height;\n    height: $popover-arrow-width;\n    margin: $border-radius-lg 0; // make sure the arrow does not touch the popover's rounded corners\n\n    &::before {\n      left: 0;\n      border-width: ($popover-arrow-width / 2) $popover-arrow-height ($popover-arrow-width / 2) 0;\n      border-right-color: $popover-arrow-outer-color;\n    }\n\n    &::after {\n      left: $popover-border-width;\n      border-width: ($popover-arrow-width / 2) $popover-arrow-height ($popover-arrow-width / 2) 0;\n      border-right-color: $popover-arrow-color;\n    }\n  }\n}\n\n.bs-popover-bottom {\n  margin-top: $popover-arrow-height;\n\n  > .arrow {\n    top: calc((#{$popover-arrow-height} + #{$popover-border-width}) * -1);\n\n    &::before {\n      top: 0;\n      border-width: 0 ($popover-arrow-width / 2) $popover-arrow-height ($popover-arrow-width / 2);\n      border-bottom-color: $popover-arrow-outer-color;\n    }\n\n    &::after {\n      top: $popover-border-width;\n      border-width: 0 ($popover-arrow-width / 2) $popover-arrow-height ($popover-arrow-width / 2);\n      border-bottom-color: $popover-arrow-color;\n    }\n  }\n\n  // This will remove the popover-header's border just below the arrow\n  .popover-header::before {\n    position: absolute;\n    top: 0;\n    left: 50%;\n    display: block;\n    width: $popover-arrow-width;\n    margin-left: -$popover-arrow-width / 2;\n    content: \"\";\n    border-bottom: $popover-border-width solid $popover-header-bg;\n  }\n}\n\n.bs-popover-left {\n  margin-right: $popover-arrow-height;\n\n  > .arrow {\n    right: calc((#{$popover-arrow-height} + #{$popover-border-width}) * -1);\n    width: $popover-arrow-height;\n    height: $popover-arrow-width;\n    margin: $border-radius-lg 0; // make sure the arrow does not touch the popover's rounded corners\n\n    &::before {\n      right: 0;\n      border-width: ($popover-arrow-width / 2) 0 ($popover-arrow-width / 2) $popover-arrow-height;\n      border-left-color: $popover-arrow-outer-color;\n    }\n\n    &::after {\n      right: $popover-border-width;\n      border-width: ($popover-arrow-width / 2) 0 ($popover-arrow-width / 2) $popover-arrow-height;\n      border-left-color: $popover-arrow-color;\n    }\n  }\n}\n\n.bs-popover-auto {\n  &[x-placement^=\"top\"] {\n    @extend .bs-popover-top;\n  }\n  &[x-placement^=\"right\"] {\n    @extend .bs-popover-right;\n  }\n  &[x-placement^=\"bottom\"] {\n    @extend .bs-popover-bottom;\n  }\n  &[x-placement^=\"left\"] {\n    @extend .bs-popover-left;\n  }\n}\n\n\n// Offset the popover to account for the popover arrow\n.popover-header {\n  padding: $popover-header-padding-y $popover-header-padding-x;\n  margin-bottom: 0; // Reset the default from Reboot\n  @include font-size($font-size-base);\n  color: $popover-header-color;\n  background-color: $popover-header-bg;\n  border-bottom: $popover-border-width solid darken($popover-header-bg, 5%);\n  $offset-border-width: calc(#{$border-radius-lg} - #{$popover-border-width});\n  @include border-top-radius($offset-border-width);\n\n  &:empty {\n    display: none;\n  }\n}\n\n.popover-body {\n  padding: $popover-body-padding-y $popover-body-padding-x;\n  color: $popover-body-color;\n}\n","// Notes on the classes:\n//\n// 1. .carousel.pointer-event should ideally be pan-y (to allow for users to scroll vertically)\n//    even when their scroll action started on a carousel, but for compatibility (with Firefox)\n//    we're preventing all actions instead\n// 2. The .carousel-item-left and .carousel-item-right is used to indicate where\n//    the active slide is heading.\n// 3. .active.carousel-item is the current slide.\n// 4. .active.carousel-item-left and .active.carousel-item-right is the current\n//    slide in its in-transition state. Only one of these occurs at a time.\n// 5. .carousel-item-next.carousel-item-left and .carousel-item-prev.carousel-item-right\n//    is the upcoming slide in transition.\n\n.carousel {\n  position: relative;\n}\n\n.carousel.pointer-event {\n  touch-action: pan-y;\n}\n\n.carousel-inner {\n  position: relative;\n  width: 100%;\n  overflow: hidden;\n  @include clearfix();\n}\n\n.carousel-item {\n  position: relative;\n  display: none;\n  float: left;\n  width: 100%;\n  margin-right: -100%;\n  backface-visibility: hidden;\n  @include transition($carousel-transition);\n}\n\n.carousel-item.active,\n.carousel-item-next,\n.carousel-item-prev {\n  display: block;\n}\n\n.carousel-item-next:not(.carousel-item-left),\n.active.carousel-item-right {\n  transform: translateX(100%);\n}\n\n.carousel-item-prev:not(.carousel-item-right),\n.active.carousel-item-left {\n  transform: translateX(-100%);\n}\n\n\n//\n// Alternate transitions\n//\n\n.carousel-fade {\n  .carousel-item {\n    opacity: 0;\n    transition-property: opacity;\n    transform: none;\n  }\n\n  .carousel-item.active,\n  .carousel-item-next.carousel-item-left,\n  .carousel-item-prev.carousel-item-right {\n    z-index: 1;\n    opacity: 1;\n  }\n\n  .active.carousel-item-left,\n  .active.carousel-item-right {\n    z-index: 0;\n    opacity: 0;\n    @include transition(0s $carousel-transition-duration opacity);\n  }\n}\n\n\n//\n// Left/right controls for nav\n//\n\n.carousel-control-prev,\n.carousel-control-next {\n  position: absolute;\n  top: 0;\n  bottom: 0;\n  z-index: 1;\n  // Use flex for alignment (1-3)\n  display: flex; // 1. allow flex styles\n  align-items: center; // 2. vertically center contents\n  justify-content: center; // 3. horizontally center contents\n  width: $carousel-control-width;\n  color: $carousel-control-color;\n  text-align: center;\n  opacity: $carousel-control-opacity;\n  @include transition($carousel-control-transition);\n\n  // Hover/focus state\n  @include hover-focus {\n    color: $carousel-control-color;\n    text-decoration: none;\n    outline: 0;\n    opacity: $carousel-control-hover-opacity;\n  }\n}\n.carousel-control-prev {\n  left: 0;\n  @if $enable-gradients {\n    background: linear-gradient(90deg, rgba($black, .25), rgba($black, .001));\n  }\n}\n.carousel-control-next {\n  right: 0;\n  @if $enable-gradients {\n    background: linear-gradient(270deg, rgba($black, .25), rgba($black, .001));\n  }\n}\n\n// Icons for within\n.carousel-control-prev-icon,\n.carousel-control-next-icon {\n  display: inline-block;\n  width: $carousel-control-icon-width;\n  height: $carousel-control-icon-width;\n  background: no-repeat 50% / 100% 100%;\n}\n.carousel-control-prev-icon {\n  background-image: $carousel-control-prev-icon-bg;\n}\n.carousel-control-next-icon {\n  background-image: $carousel-control-next-icon-bg;\n}\n\n\n// Optional indicator pips\n//\n// Add an ordered list with the following class and add a list item for each\n// slide your carousel holds.\n\n.carousel-indicators {\n  position: absolute;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  z-index: 15;\n  display: flex;\n  justify-content: center;\n  padding-left: 0; // override <ol> default\n  // Use the .carousel-control's width as margin so we don't overlay those\n  margin-right: $carousel-control-width;\n  margin-left: $carousel-control-width;\n  list-style: none;\n\n  li {\n    box-sizing: content-box;\n    flex: 0 1 auto;\n    width: $carousel-indicator-width;\n    height: $carousel-indicator-height;\n    margin-right: $carousel-indicator-spacer;\n    margin-left: $carousel-indicator-spacer;\n    text-indent: -999px;\n    cursor: pointer;\n    background-color: $carousel-indicator-active-bg;\n    background-clip: padding-box;\n    // Use transparent borders to increase the hit area by 10px on top and bottom.\n    border-top: $carousel-indicator-hit-area-height solid transparent;\n    border-bottom: $carousel-indicator-hit-area-height solid transparent;\n    opacity: .5;\n    @include transition($carousel-indicator-transition);\n  }\n\n  .active {\n    opacity: 1;\n  }\n}\n\n\n// Optional captions\n//\n//\n\n.carousel-caption {\n  position: absolute;\n  right: (100% - $carousel-caption-width) / 2;\n  bottom: 20px;\n  left: (100% - $carousel-caption-width) / 2;\n  z-index: 10;\n  padding-top: 20px;\n  padding-bottom: 20px;\n  color: $carousel-caption-color;\n  text-align: center;\n}\n","@mixin clearfix() {\n  &::after {\n    display: block;\n    clear: both;\n    content: \"\";\n  }\n}\n","//\n// Rotating border\n//\n\n@keyframes spinner-border {\n  to { transform: rotate(360deg); }\n}\n\n.spinner-border {\n  display: inline-block;\n  width: $spinner-width;\n  height: $spinner-height;\n  vertical-align: text-bottom;\n  border: $spinner-border-width solid currentColor;\n  border-right-color: transparent;\n  // stylelint-disable-next-line property-blacklist\n  border-radius: 50%;\n  animation: spinner-border .75s linear infinite;\n}\n\n.spinner-border-sm {\n  width: $spinner-width-sm;\n  height: $spinner-height-sm;\n  border-width: $spinner-border-width-sm;\n}\n\n//\n// Growing circle\n//\n\n@keyframes spinner-grow {\n  0% {\n    transform: scale(0);\n  }\n  50% {\n    opacity: 1;\n  }\n}\n\n.spinner-grow {\n  display: inline-block;\n  width: $spinner-width;\n  height: $spinner-height;\n  vertical-align: text-bottom;\n  background-color: currentColor;\n  // stylelint-disable-next-line property-blacklist\n  border-radius: 50%;\n  opacity: 0;\n  animation: spinner-grow .75s linear infinite;\n}\n\n.spinner-grow-sm {\n  width: $spinner-width-sm;\n  height: $spinner-height-sm;\n}\n","// stylelint-disable declaration-no-important\n\n.align-baseline    { vertical-align: baseline !important; } // Browser default\n.align-top         { vertical-align: top !important; }\n.align-middle      { vertical-align: middle !important; }\n.align-bottom      { vertical-align: bottom !important; }\n.align-text-bottom { vertical-align: text-bottom !important; }\n.align-text-top    { vertical-align: text-top !important; }\n","// stylelint-disable declaration-no-important\n\n// Contextual backgrounds\n\n@mixin bg-variant($parent, $color) {\n  #{$parent} {\n    background-color: $color !important;\n  }\n  a#{$parent},\n  button#{$parent} {\n    @include hover-focus {\n      background-color: darken($color, 10%) !important;\n    }\n  }\n}\n\n@mixin bg-gradient-variant($parent, $color) {\n  #{$parent} {\n    background: $color linear-gradient(180deg, mix($body-bg, $color, 15%), $color) repeat-x !important;\n  }\n}\n","// stylelint-disable declaration-no-important\n\n@each $color, $value in $theme-colors {\n  @include bg-variant(\".bg-#{$color}\", $value);\n}\n\n@if $enable-gradients {\n  @each $color, $value in $theme-colors {\n    @include bg-gradient-variant(\".bg-gradient-#{$color}\", $value);\n  }\n}\n\n.bg-white {\n  background-color: $white !important;\n}\n\n.bg-transparent {\n  background-color: transparent !important;\n}\n","// stylelint-disable property-blacklist, declaration-no-important\n\n//\n// Border\n//\n\n.border         { border: $border-width solid $border-color !important; }\n.border-top     { border-top: $border-width solid $border-color !important; }\n.border-right   { border-right: $border-width solid $border-color !important; }\n.border-bottom  { border-bottom: $border-width solid $border-color !important; }\n.border-left    { border-left: $border-width solid $border-color !important; }\n\n.border-0        { border: 0 !important; }\n.border-top-0    { border-top: 0 !important; }\n.border-right-0  { border-right: 0 !important; }\n.border-bottom-0 { border-bottom: 0 !important; }\n.border-left-0   { border-left: 0 !important; }\n\n@each $color, $value in $theme-colors {\n  .border-#{$color} {\n    border-color: $value !important;\n  }\n}\n\n.border-white {\n  border-color: $white !important;\n}\n\n//\n// Border-radius\n//\n\n.rounded-sm {\n  border-radius: $border-radius-sm !important;\n}\n\n.rounded {\n  border-radius: $border-radius !important;\n}\n\n.rounded-top {\n  border-top-left-radius: $border-radius !important;\n  border-top-right-radius: $border-radius !important;\n}\n\n.rounded-right {\n  border-top-right-radius: $border-radius !important;\n  border-bottom-right-radius: $border-radius !important;\n}\n\n.rounded-bottom {\n  border-bottom-right-radius: $border-radius !important;\n  border-bottom-left-radius: $border-radius !important;\n}\n\n.rounded-left {\n  border-top-left-radius: $border-radius !important;\n  border-bottom-left-radius: $border-radius !important;\n}\n\n.rounded-lg {\n  border-radius: $border-radius-lg !important;\n}\n\n.rounded-circle {\n  border-radius: 50% !important;\n}\n\n.rounded-pill {\n  border-radius: $rounded-pill !important;\n}\n\n.rounded-0 {\n  border-radius: 0 !important;\n}\n","// stylelint-disable declaration-no-important\n\n//\n// Utilities for common `display` values\n//\n\n@each $breakpoint in map-keys($grid-breakpoints) {\n  @include media-breakpoint-up($breakpoint) {\n    $infix: breakpoint-infix($breakpoint, $grid-breakpoints);\n\n    @each $value in $displays {\n      .d#{$infix}-#{$value} { display: $value !important; }\n    }\n  }\n}\n\n\n//\n// Utilities for toggling `display` in print\n//\n\n@media print {\n  @each $value in $displays {\n    .d-print-#{$value} { display: $value !important; }\n  }\n}\n","// Credit: Nicolas Gallagher and SUIT CSS.\n\n.embed-responsive {\n  position: relative;\n  display: block;\n  width: 100%;\n  padding: 0;\n  overflow: hidden;\n\n  &::before {\n    display: block;\n    content: \"\";\n  }\n\n  .embed-responsive-item,\n  iframe,\n  embed,\n  object,\n  video {\n    position: absolute;\n    top: 0;\n    bottom: 0;\n    left: 0;\n    width: 100%;\n    height: 100%;\n    border: 0;\n  }\n}\n\n@each $embed-responsive-aspect-ratio in $embed-responsive-aspect-ratios {\n  $embed-responsive-aspect-ratio-x: nth($embed-responsive-aspect-ratio, 1);\n  $embed-responsive-aspect-ratio-y: nth($embed-responsive-aspect-ratio, 2);\n\n  .embed-responsive-#{$embed-responsive-aspect-ratio-x}by#{$embed-responsive-aspect-ratio-y} {\n    &::before {\n      padding-top: percentage($embed-responsive-aspect-ratio-y / $embed-responsive-aspect-ratio-x);\n    }\n  }\n}\n","// stylelint-disable declaration-no-important\n\n// Flex variation\n//\n// Custom styles for additional flex alignment options.\n\n@each $breakpoint in map-keys($grid-breakpoints) {\n  @include media-breakpoint-up($breakpoint) {\n    $infix: breakpoint-infix($breakpoint, $grid-breakpoints);\n\n    .flex#{$infix}-row            { flex-direction: row !important; }\n    .flex#{$infix}-column         { flex-direction: column !important; }\n    .flex#{$infix}-row-reverse    { flex-direction: row-reverse !important; }\n    .flex#{$infix}-column-reverse { flex-direction: column-reverse !important; }\n\n    .flex#{$infix}-wrap         { flex-wrap: wrap !important; }\n    .flex#{$infix}-nowrap       { flex-wrap: nowrap !important; }\n    .flex#{$infix}-wrap-reverse { flex-wrap: wrap-reverse !important; }\n    .flex#{$infix}-fill         { flex: 1 1 auto !important; }\n    .flex#{$infix}-grow-0       { flex-grow: 0 !important; }\n    .flex#{$infix}-grow-1       { flex-grow: 1 !important; }\n    .flex#{$infix}-shrink-0     { flex-shrink: 0 !important; }\n    .flex#{$infix}-shrink-1     { flex-shrink: 1 !important; }\n\n    .justify-content#{$infix}-start   { justify-content: flex-start !important; }\n    .justify-content#{$infix}-end     { justify-content: flex-end !important; }\n    .justify-content#{$infix}-center  { justify-content: center !important; }\n    .justify-content#{$infix}-between { justify-content: space-between !important; }\n    .justify-content#{$infix}-around  { justify-content: space-around !important; }\n\n    .align-items#{$infix}-start    { align-items: flex-start !important; }\n    .align-items#{$infix}-end      { align-items: flex-end !important; }\n    .align-items#{$infix}-center   { align-items: center !important; }\n    .align-items#{$infix}-baseline { align-items: baseline !important; }\n    .align-items#{$infix}-stretch  { align-items: stretch !important; }\n\n    .align-content#{$infix}-start   { align-content: flex-start !important; }\n    .align-content#{$infix}-end     { align-content: flex-end !important; }\n    .align-content#{$infix}-center  { align-content: center !important; }\n    .align-content#{$infix}-between { align-content: space-between !important; }\n    .align-content#{$infix}-around  { align-content: space-around !important; }\n    .align-content#{$infix}-stretch { align-content: stretch !important; }\n\n    .align-self#{$infix}-auto     { align-self: auto !important; }\n    .align-self#{$infix}-start    { align-self: flex-start !important; }\n    .align-self#{$infix}-end      { align-self: flex-end !important; }\n    .align-self#{$infix}-center   { align-self: center !important; }\n    .align-self#{$infix}-baseline { align-self: baseline !important; }\n    .align-self#{$infix}-stretch  { align-self: stretch !important; }\n  }\n}\n","// stylelint-disable declaration-no-important\n\n@each $breakpoint in map-keys($grid-breakpoints) {\n  @include media-breakpoint-up($breakpoint) {\n    $infix: breakpoint-infix($breakpoint, $grid-breakpoints);\n\n    .float#{$infix}-left  { float: left !important; }\n    .float#{$infix}-right { float: right !important; }\n    .float#{$infix}-none  { float: none !important; }\n  }\n}\n","// stylelint-disable declaration-no-important\n\n@each $value in $overflows {\n  .overflow-#{$value} { overflow: $value !important; }\n}\n","// stylelint-disable declaration-no-important\n\n// Common values\n@each $position in $positions {\n  .position-#{$position} { position: $position !important; }\n}\n\n// Shorthand\n\n.fixed-top {\n  position: fixed;\n  top: 0;\n  right: 0;\n  left: 0;\n  z-index: $zindex-fixed;\n}\n\n.fixed-bottom {\n  position: fixed;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  z-index: $zindex-fixed;\n}\n\n.sticky-top {\n  @supports (position: sticky) {\n    position: sticky;\n    top: 0;\n    z-index: $zindex-sticky;\n  }\n}\n","//\n// Screenreaders\n//\n\n.sr-only {\n  @include sr-only();\n}\n\n.sr-only-focusable {\n  @include sr-only-focusable();\n}\n","// Only display content to screen readers\n//\n// See: https://a11yproject.com/posts/how-to-hide-content/\n// See: https://hugogiraudel.com/2016/10/13/css-hide-and-seek/\n\n@mixin sr-only {\n  position: absolute;\n  width: 1px;\n  height: 1px;\n  padding: 0;\n  overflow: hidden;\n  clip: rect(0, 0, 0, 0);\n  white-space: nowrap;\n  border: 0;\n}\n\n// Use in conjunction with .sr-only to only display content when it's focused.\n//\n// Useful for \"Skip to main content\" links; see https://www.w3.org/TR/2013/NOTE-WCAG20-TECHS-20130905/G1\n//\n// Credit: HTML5 Boilerplate\n\n@mixin sr-only-focusable {\n  &:active,\n  &:focus {\n    position: static;\n    width: auto;\n    height: auto;\n    overflow: visible;\n    clip: auto;\n    white-space: normal;\n  }\n}\n","// stylelint-disable declaration-no-important\n\n.shadow-sm { box-shadow: $box-shadow-sm !important; }\n.shadow { box-shadow: $box-shadow !important; }\n.shadow-lg { box-shadow: $box-shadow-lg !important; }\n.shadow-none { box-shadow: none !important; }\n","// stylelint-disable declaration-no-important\n\n// Width and height\n\n@each $prop, $abbrev in (width: w, height: h) {\n  @each $size, $length in $sizes {\n    .#{$abbrev}-#{$size} { #{$prop}: $length !important; }\n  }\n}\n\n.mw-100 { max-width: 100% !important; }\n.mh-100 { max-height: 100% !important; }\n\n// Viewport additional helpers\n\n.min-vw-100 { min-width: 100vw !important; }\n.min-vh-100 { min-height: 100vh !important; }\n\n.vw-100 { width: 100vw !important; }\n.vh-100 { height: 100vh !important; }\n","//\n// Stretched link\n//\n\n.stretched-link {\n  &::after {\n    position: absolute;\n    top: 0;\n    right: 0;\n    bottom: 0;\n    left: 0;\n    z-index: 1;\n    // Just in case `pointer-events: none` is set on a parent\n    pointer-events: auto;\n    content: \"\";\n    // IE10 bugfix, see https://stackoverflow.com/questions/16947967/ie10-hover-pseudo-class-doesnt-work-without-background-color\n    background-color: rgba(0, 0, 0, 0);\n  }\n}\n","// stylelint-disable declaration-no-important\n\n// Margin and Padding\n\n@each $breakpoint in map-keys($grid-breakpoints) {\n  @include media-breakpoint-up($breakpoint) {\n    $infix: breakpoint-infix($breakpoint, $grid-breakpoints);\n\n    @each $prop, $abbrev in (margin: m, padding: p) {\n      @each $size, $length in $spacers {\n        .#{$abbrev}#{$infix}-#{$size} { #{$prop}: $length !important; }\n        .#{$abbrev}t#{$infix}-#{$size},\n        .#{$abbrev}y#{$infix}-#{$size} {\n          #{$prop}-top: $length !important;\n        }\n        .#{$abbrev}r#{$infix}-#{$size},\n        .#{$abbrev}x#{$infix}-#{$size} {\n          #{$prop}-right: $length !important;\n        }\n        .#{$abbrev}b#{$infix}-#{$size},\n        .#{$abbrev}y#{$infix}-#{$size} {\n          #{$prop}-bottom: $length !important;\n        }\n        .#{$abbrev}l#{$infix}-#{$size},\n        .#{$abbrev}x#{$infix}-#{$size} {\n          #{$prop}-left: $length !important;\n        }\n      }\n    }\n\n    // Negative margins (e.g., where `.mb-n1` is negative version of `.mb-1`)\n    @each $size, $length in $spacers {\n      @if $size != 0 {\n        .m#{$infix}-n#{$size} { margin: -$length !important; }\n        .mt#{$infix}-n#{$size},\n        .my#{$infix}-n#{$size} {\n          margin-top: -$length !important;\n        }\n        .mr#{$infix}-n#{$size},\n        .mx#{$infix}-n#{$size} {\n          margin-right: -$length !important;\n        }\n        .mb#{$infix}-n#{$size},\n        .my#{$infix}-n#{$size} {\n          margin-bottom: -$length !important;\n        }\n        .ml#{$infix}-n#{$size},\n        .mx#{$infix}-n#{$size} {\n          margin-left: -$length !important;\n        }\n      }\n    }\n\n    // Some special margin utils\n    .m#{$infix}-auto { margin: auto !important; }\n    .mt#{$infix}-auto,\n    .my#{$infix}-auto {\n      margin-top: auto !important;\n    }\n    .mr#{$infix}-auto,\n    .mx#{$infix}-auto {\n      margin-right: auto !important;\n    }\n    .mb#{$infix}-auto,\n    .my#{$infix}-auto {\n      margin-bottom: auto !important;\n    }\n    .ml#{$infix}-auto,\n    .mx#{$infix}-auto {\n      margin-left: auto !important;\n    }\n  }\n}\n","// stylelint-disable declaration-no-important\n\n//\n// Text\n//\n\n.text-monospace { font-family: $font-family-monospace !important; }\n\n// Alignment\n\n.text-justify  { text-align: justify !important; }\n.text-wrap     { white-space: normal !important; }\n.text-nowrap   { white-space: nowrap !important; }\n.text-truncate { @include text-truncate; }\n\n// Responsive alignment\n\n@each $breakpoint in map-keys($grid-breakpoints) {\n  @include media-breakpoint-up($breakpoint) {\n    $infix: breakpoint-infix($breakpoint, $grid-breakpoints);\n\n    .text#{$infix}-left   { text-align: left !important; }\n    .text#{$infix}-right  { text-align: right !important; }\n    .text#{$infix}-center { text-align: center !important; }\n  }\n}\n\n// Transformation\n\n.text-lowercase  { text-transform: lowercase !important; }\n.text-uppercase  { text-transform: uppercase !important; }\n.text-capitalize { text-transform: capitalize !important; }\n\n// Weight and italics\n\n.font-weight-light   { font-weight: $font-weight-light !important; }\n.font-weight-lighter { font-weight: $font-weight-lighter !important; }\n.font-weight-normal  { font-weight: $font-weight-normal !important; }\n.font-weight-bold    { font-weight: $font-weight-bold !important; }\n.font-weight-bolder  { font-weight: $font-weight-bolder !important; }\n.font-italic         { font-style: italic !important; }\n\n// Contextual colors\n\n.text-white { color: $white !important; }\n\n@each $color, $value in $theme-colors {\n  @include text-emphasis-variant(\".text-#{$color}\", $value);\n}\n\n.text-body { color: $body-color !important; }\n.text-muted { color: $text-muted !important; }\n\n.text-black-50 { color: rgba($black, .5) !important; }\n.text-white-50 { color: rgba($white, .5) !important; }\n\n// Misc\n\n.text-hide {\n  @include text-hide($ignore-warning: true);\n}\n\n.text-decoration-none { text-decoration: none !important; }\n\n.text-break {\n  word-break: break-word !important; // IE & < Edge 18\n  overflow-wrap: break-word !important;\n}\n\n// Reset\n\n.text-reset { color: inherit !important; }\n","// Text truncate\n// Requires inline-block or block for proper styling\n\n@mixin text-truncate() {\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n","// stylelint-disable declaration-no-important\n\n// Typography\n\n@mixin text-emphasis-variant($parent, $color) {\n  #{$parent} {\n    color: $color !important;\n  }\n  @if $emphasized-link-hover-darken-percentage != 0 {\n    a#{$parent} {\n      @include hover-focus {\n        color: darken($color, $emphasized-link-hover-darken-percentage) !important;\n      }\n    }\n  }\n}\n","// CSS image replacement\n@mixin text-hide($ignore-warning: false) {\n  // stylelint-disable-next-line font-family-no-missing-generic-family-keyword\n  font: 0/0 a;\n  color: transparent;\n  text-shadow: none;\n  background-color: transparent;\n  border: 0;\n\n  @include deprecate(\"`text-hide()`\", \"v4.1.0\", \"v5\", $ignore-warning);\n}\n","// stylelint-disable declaration-no-important\n\n//\n// Visibility utilities\n//\n\n.visible {\n  visibility: visible !important;\n}\n\n.invisible {\n  visibility: hidden !important;\n}\n","// stylelint-disable declaration-no-important, selector-no-qualifying-type\n\n// Source: https://github.com/h5bp/html5-boilerplate/blob/master/src/css/main.css\n\n// ==========================================================================\n// Print styles.\n// Inlined to avoid the additional HTTP request:\n// https://www.phpied.com/delay-loading-your-print-css/\n// ==========================================================================\n\n@if $enable-print-styles {\n  @media print {\n    *,\n    *::before,\n    *::after {\n      // Bootstrap specific; comment out `color` and `background`\n      //color: $black !important; // Black prints faster\n      text-shadow: none !important;\n      //background: transparent !important;\n      box-shadow: none !important;\n    }\n\n    a {\n      &:not(.btn) {\n        text-decoration: underline;\n      }\n    }\n\n    // Bootstrap specific; comment the following selector out\n    //a[href]::after {\n    //  content: \" (\" attr(href) \")\";\n    //}\n\n    abbr[title]::after {\n      content: \" (\" attr(title) \")\";\n    }\n\n    // Bootstrap specific; comment the following selector out\n    //\n    // Don't show links that are fragment identifiers,\n    // or use the `javascript:` pseudo protocol\n    //\n\n    //a[href^=\"#\"]::after,\n    //a[href^=\"javascript:\"]::after {\n    // content: \"\";\n    //}\n\n    pre {\n      white-space: pre-wrap !important;\n    }\n    pre,\n    blockquote {\n      border: $border-width solid $gray-500; // Bootstrap custom code; using `$border-width` instead of 1px\n      page-break-inside: avoid;\n    }\n\n    //\n    // Printing Tables:\n    // http://css-discuss.incutio.com/wiki/Printing_Tables\n    //\n\n    thead {\n      display: table-header-group;\n    }\n\n    tr,\n    img {\n      page-break-inside: avoid;\n    }\n\n    p,\n    h2,\n    h3 {\n      orphans: 3;\n      widows: 3;\n    }\n\n    h2,\n    h3 {\n      page-break-after: avoid;\n    }\n\n    // Bootstrap specific changes start\n\n    // Specify a size and min-width to make printing closer across browsers.\n    // We don't set margin here because it breaks `size` in Chrome. We also\n    // don't use `!important` on `size` as it breaks in Chrome.\n    @page {\n      size: $print-page-size;\n    }\n    body {\n      min-width: $print-body-min-width !important;\n    }\n    .container {\n      min-width: $print-body-min-width !important;\n    }\n\n    // Bootstrap components\n    .navbar {\n      display: none;\n    }\n    .badge {\n      border: $border-width solid $black;\n    }\n\n    .table {\n      border-collapse: collapse !important;\n\n      td,\n      th {\n        background-color: $white !important;\n      }\n    }\n\n    .table-bordered {\n      th,\n      td {\n        border: 1px solid $gray-300 !important;\n      }\n    }\n\n    .table-dark {\n      color: inherit;\n\n      th,\n      td,\n      thead th,\n      tbody + tbody {\n        border-color: $table-border-color;\n      }\n    }\n\n    .table .thead-dark th {\n      color: inherit;\n      border-color: $table-border-color;\n    }\n\n    // Bootstrap specific changes end\n  }\n}\n"]}
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/FONT-LICENSE b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/FONT-LICENSE
new file mode 100644
index 0000000000..a1dc03f35c
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/FONT-LICENSE
@@ -0,0 +1,86 @@
+SIL OPEN FONT LICENSE Version 1.1
+
+Copyright (c) 2014 Waybury
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/ICON-LICENSE b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/ICON-LICENSE
new file mode 100644
index 0000000000..2199f4a694
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/ICON-LICENSE
@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Waybury
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/README.mdx b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/README.mdx
new file mode 100644
index 0000000000..6b810e4796
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/README.mdx
@@ -0,0 +1,114 @@
+[Open Iconic v1.1.1](http://useiconic.com/open)
+===========
+
+### Open Iconic is the open source sibling of [Iconic](http://useiconic.com). It is a hyper-legible collection of 223 icons with a tiny footprint&mdash;ready to use with Bootstrap and Foundation. [View the collection](http://useiconic.com/open#icons)
+
+
+
+## What's in Open Iconic?
+
+* 223 icons designed to be legible down to 8 pixels
+* Super-light SVG files - 61.8 for the entire set 
+* SVG sprite&mdash;the modern replacement for icon fonts
+* Webfont (EOT, OTF, SVG, TTF, WOFF), PNG and WebP formats
+* Webfont stylesheets (including versions for Bootstrap and Foundation) in CSS, LESS, SCSS and Stylus formats
+* PNG and WebP raster images in 8px, 16px, 24px, 32px, 48px and 64px.
+
+
+## Getting Started
+
+#### For code samples and everything else you need to get started with Open Iconic, check out our [Icons](http://useiconic.com/open#icons) and [Reference](http://useiconic.com/open#reference) sections.
+
+### General Usage
+
+#### Using Open Iconic's SVGs
+
+We like SVGs and we think they're the way to display icons on the web. Since Open Iconic are just basic SVGs, we suggest you display them like you would any other image (don't forget the `alt` attribute).
+
+```
+<img src="/open-iconic/svg/icon-name.svg" alt="icon name">
+```
+
+#### Using Open Iconic's SVG Sprite
+
+Open Iconic also comes in a SVG sprite which allows you to display all the icons in the set with a single request. It's like an icon font, without being a hack.
+
+Adding an icon from an SVG sprite is a little different than what you're used to, but it's still a piece of cake. *Tip: To make your icons easily style able, we suggest adding a general class to the* `<svg>` *tag and a unique class name for each different icon in the* `<use>` *tag.*  
+
+```
+<svg class="icon">
+  <use xlink:href="open-iconic.svg#account-login" class="icon-account-login"></use>
+</svg>
+```
+
+Sizing icons only needs basic CSS. All the icons are in a square format, so just set the `<svg>` tag with equal width and height dimensions.
+
+```
+.icon {
+  width: 16px;
+  height: 16px;
+}
+```
+
+Coloring icons is even easier. All you need to do is set the `fill` rule on the `<use>` tag.
+
+```
+.icon-account-login {
+  fill: #f00;
+}
+```
+
+To learn more about SVG Sprites, read [Chris Coyier's guide](http://css-tricks.com/svg-sprites-use-better-icon-fonts/).
+
+#### Using Open Iconic's Icon Font...
+
+
+##### …with Bootstrap
+
+You can find our Bootstrap stylesheets in `font/css/open-iconic-bootstrap.{css, less, scss, styl}`
+
+
+```
+<link href="/open-iconic/font/css/open-iconic-bootstrap.css" rel="stylesheet">
+```
+
+
+```
+<span class="oi oi-icon-name" title="icon name" aria-hidden="true"></span>
+```
+
+##### …with Foundation
+
+You can find our Foundation stylesheets in `font/css/open-iconic-foundation.{css, less, scss, styl}`
+
+```
+<link href="/open-iconic/font/css/open-iconic-foundation.css" rel="stylesheet">
+```
+
+
+```
+<span class="fi-icon-name" title="icon name" aria-hidden="true"></span>
+```
+
+##### …on its own
+
+You can find our default stylesheets in `font/css/open-iconic.{css, less, scss, styl}`
+
+```
+<link href="/open-iconic/font/css/open-iconic.css" rel="stylesheet">
+```
+
+```
+<span class="oi" data-glyph="icon-name" title="icon name" aria-hidden="true"></span>
+```
+
+
+## License
+
+### Icons
+
+All code (including SVG markup) is under the [MIT License](http://opensource.org/licenses/MIT).
+
+### Fonts
+
+All fonts are under the [SIL Licensed](http://scripts.sil.org/cms/scripts/page.php?item_id=OFL_web).
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/font/css/open-iconic-bootstrap.min.css b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/font/css/open-iconic-bootstrap.min.css
new file mode 100644
index 0000000000..4664f2e8ca
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/font/css/open-iconic-bootstrap.min.css
@@ -0,0 +1 @@
+@font-face{font-family:Icons;src:url(../fonts/open-iconic.eot);src:url(../fonts/open-iconic.eot?#iconic-sm) format('embedded-opentype'),url(../fonts/open-iconic.woff) format('woff'),url(../fonts/open-iconic.ttf) format('truetype'),url(../fonts/open-iconic.otf) format('opentype'),url(../fonts/open-iconic.svg#iconic-sm) format('svg');font-weight:400;font-style:normal}.oi{position:relative;top:1px;display:inline-block;speak:none;font-family:Icons;font-style:normal;font-weight:400;line-height:1;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.oi:empty:before{width:1em;text-align:center;box-sizing:content-box}.oi.oi-align-center:before{text-align:center}.oi.oi-align-left:before{text-align:left}.oi.oi-align-right:before{text-align:right}.oi.oi-flip-horizontal:before{-webkit-transform:scale(-1,1);-ms-transform:scale(-1,1);transform:scale(-1,1)}.oi.oi-flip-vertical:before{-webkit-transform:scale(1,-1);-ms-transform:scale(-1,1);transform:scale(1,-1)}.oi.oi-flip-horizontal-vertical:before{-webkit-transform:scale(-1,-1);-ms-transform:scale(-1,1);transform:scale(-1,-1)}.oi-account-login:before{content:'\e000'}.oi-account-logout:before{content:'\e001'}.oi-action-redo:before{content:'\e002'}.oi-action-undo:before{content:'\e003'}.oi-align-center:before{content:'\e004'}.oi-align-left:before{content:'\e005'}.oi-align-right:before{content:'\e006'}.oi-aperture:before{content:'\e007'}.oi-arrow-bottom:before{content:'\e008'}.oi-arrow-circle-bottom:before{content:'\e009'}.oi-arrow-circle-left:before{content:'\e00a'}.oi-arrow-circle-right:before{content:'\e00b'}.oi-arrow-circle-top:before{content:'\e00c'}.oi-arrow-left:before{content:'\e00d'}.oi-arrow-right:before{content:'\e00e'}.oi-arrow-thick-bottom:before{content:'\e00f'}.oi-arrow-thick-left:before{content:'\e010'}.oi-arrow-thick-right:before{content:'\e011'}.oi-arrow-thick-top:before{content:'\e012'}.oi-arrow-top:before{content:'\e013'}.oi-audio-spectrum:before{content:'\e014'}.oi-audio:before{content:'\e015'}.oi-badge:before{content:'\e016'}.oi-ban:before{content:'\e017'}.oi-bar-chart:before{content:'\e018'}.oi-basket:before{content:'\e019'}.oi-battery-empty:before{content:'\e01a'}.oi-battery-full:before{content:'\e01b'}.oi-beaker:before{content:'\e01c'}.oi-bell:before{content:'\e01d'}.oi-bluetooth:before{content:'\e01e'}.oi-bold:before{content:'\e01f'}.oi-bolt:before{content:'\e020'}.oi-book:before{content:'\e021'}.oi-bookmark:before{content:'\e022'}.oi-box:before{content:'\e023'}.oi-briefcase:before{content:'\e024'}.oi-british-pound:before{content:'\e025'}.oi-browser:before{content:'\e026'}.oi-brush:before{content:'\e027'}.oi-bug:before{content:'\e028'}.oi-bullhorn:before{content:'\e029'}.oi-calculator:before{content:'\e02a'}.oi-calendar:before{content:'\e02b'}.oi-camera-slr:before{content:'\e02c'}.oi-caret-bottom:before{content:'\e02d'}.oi-caret-left:before{content:'\e02e'}.oi-caret-right:before{content:'\e02f'}.oi-caret-top:before{content:'\e030'}.oi-cart:before{content:'\e031'}.oi-chat:before{content:'\e032'}.oi-check:before{content:'\e033'}.oi-chevron-bottom:before{content:'\e034'}.oi-chevron-left:before{content:'\e035'}.oi-chevron-right:before{content:'\e036'}.oi-chevron-top:before{content:'\e037'}.oi-circle-check:before{content:'\e038'}.oi-circle-x:before{content:'\e039'}.oi-clipboard:before{content:'\e03a'}.oi-clock:before{content:'\e03b'}.oi-cloud-download:before{content:'\e03c'}.oi-cloud-upload:before{content:'\e03d'}.oi-cloud:before{content:'\e03e'}.oi-cloudy:before{content:'\e03f'}.oi-code:before{content:'\e040'}.oi-cog:before{content:'\e041'}.oi-collapse-down:before{content:'\e042'}.oi-collapse-left:before{content:'\e043'}.oi-collapse-right:before{content:'\e044'}.oi-collapse-up:before{content:'\e045'}.oi-command:before{content:'\e046'}.oi-comment-square:before{content:'\e047'}.oi-compass:before{content:'\e048'}.oi-contrast:before{content:'\e049'}.oi-copywriting:before{content:'\e04a'}.oi-credit-card:before{content:'\e04b'}.oi-crop:before{content:'\e04c'}.oi-dashboard:before{content:'\e04d'}.oi-data-transfer-download:before{content:'\e04e'}.oi-data-transfer-upload:before{content:'\e04f'}.oi-delete:before{content:'\e050'}.oi-dial:before{content:'\e051'}.oi-document:before{content:'\e052'}.oi-dollar:before{content:'\e053'}.oi-double-quote-sans-left:before{content:'\e054'}.oi-double-quote-sans-right:before{content:'\e055'}.oi-double-quote-serif-left:before{content:'\e056'}.oi-double-quote-serif-right:before{content:'\e057'}.oi-droplet:before{content:'\e058'}.oi-eject:before{content:'\e059'}.oi-elevator:before{content:'\e05a'}.oi-ellipses:before{content:'\e05b'}.oi-envelope-closed:before{content:'\e05c'}.oi-envelope-open:before{content:'\e05d'}.oi-euro:before{content:'\e05e'}.oi-excerpt:before{content:'\e05f'}.oi-expand-down:before{content:'\e060'}.oi-expand-left:before{content:'\e061'}.oi-expand-right:before{content:'\e062'}.oi-expand-up:before{content:'\e063'}.oi-external-link:before{content:'\e064'}.oi-eye:before{content:'\e065'}.oi-eyedropper:before{content:'\e066'}.oi-file:before{content:'\e067'}.oi-fire:before{content:'\e068'}.oi-flag:before{content:'\e069'}.oi-flash:before{content:'\e06a'}.oi-folder:before{content:'\e06b'}.oi-fork:before{content:'\e06c'}.oi-fullscreen-enter:before{content:'\e06d'}.oi-fullscreen-exit:before{content:'\e06e'}.oi-globe:before{content:'\e06f'}.oi-graph:before{content:'\e070'}.oi-grid-four-up:before{content:'\e071'}.oi-grid-three-up:before{content:'\e072'}.oi-grid-two-up:before{content:'\e073'}.oi-hard-drive:before{content:'\e074'}.oi-header:before{content:'\e075'}.oi-headphones:before{content:'\e076'}.oi-heart:before{content:'\e077'}.oi-home:before{content:'\e078'}.oi-image:before{content:'\e079'}.oi-inbox:before{content:'\e07a'}.oi-infinity:before{content:'\e07b'}.oi-info:before{content:'\e07c'}.oi-italic:before{content:'\e07d'}.oi-justify-center:before{content:'\e07e'}.oi-justify-left:before{content:'\e07f'}.oi-justify-right:before{content:'\e080'}.oi-key:before{content:'\e081'}.oi-laptop:before{content:'\e082'}.oi-layers:before{content:'\e083'}.oi-lightbulb:before{content:'\e084'}.oi-link-broken:before{content:'\e085'}.oi-link-intact:before{content:'\e086'}.oi-list-rich:before{content:'\e087'}.oi-list:before{content:'\e088'}.oi-location:before{content:'\e089'}.oi-lock-locked:before{content:'\e08a'}.oi-lock-unlocked:before{content:'\e08b'}.oi-loop-circular:before{content:'\e08c'}.oi-loop-square:before{content:'\e08d'}.oi-loop:before{content:'\e08e'}.oi-magnifying-glass:before{content:'\e08f'}.oi-map-marker:before{content:'\e090'}.oi-map:before{content:'\e091'}.oi-media-pause:before{content:'\e092'}.oi-media-play:before{content:'\e093'}.oi-media-record:before{content:'\e094'}.oi-media-skip-backward:before{content:'\e095'}.oi-media-skip-forward:before{content:'\e096'}.oi-media-step-backward:before{content:'\e097'}.oi-media-step-forward:before{content:'\e098'}.oi-media-stop:before{content:'\e099'}.oi-medical-cross:before{content:'\e09a'}.oi-menu:before{content:'\e09b'}.oi-microphone:before{content:'\e09c'}.oi-minus:before{content:'\e09d'}.oi-monitor:before{content:'\e09e'}.oi-moon:before{content:'\e09f'}.oi-move:before{content:'\e0a0'}.oi-musical-note:before{content:'\e0a1'}.oi-paperclip:before{content:'\e0a2'}.oi-pencil:before{content:'\e0a3'}.oi-people:before{content:'\e0a4'}.oi-person:before{content:'\e0a5'}.oi-phone:before{content:'\e0a6'}.oi-pie-chart:before{content:'\e0a7'}.oi-pin:before{content:'\e0a8'}.oi-play-circle:before{content:'\e0a9'}.oi-plus:before{content:'\e0aa'}.oi-power-standby:before{content:'\e0ab'}.oi-print:before{content:'\e0ac'}.oi-project:before{content:'\e0ad'}.oi-pulse:before{content:'\e0ae'}.oi-puzzle-piece:before{content:'\e0af'}.oi-question-mark:before{content:'\e0b0'}.oi-rain:before{content:'\e0b1'}.oi-random:before{content:'\e0b2'}.oi-reload:before{content:'\e0b3'}.oi-resize-both:before{content:'\e0b4'}.oi-resize-height:before{content:'\e0b5'}.oi-resize-width:before{content:'\e0b6'}.oi-rss-alt:before{content:'\e0b7'}.oi-rss:before{content:'\e0b8'}.oi-script:before{content:'\e0b9'}.oi-share-boxed:before{content:'\e0ba'}.oi-share:before{content:'\e0bb'}.oi-shield:before{content:'\e0bc'}.oi-signal:before{content:'\e0bd'}.oi-signpost:before{content:'\e0be'}.oi-sort-ascending:before{content:'\e0bf'}.oi-sort-descending:before{content:'\e0c0'}.oi-spreadsheet:before{content:'\e0c1'}.oi-star:before{content:'\e0c2'}.oi-sun:before{content:'\e0c3'}.oi-tablet:before{content:'\e0c4'}.oi-tag:before{content:'\e0c5'}.oi-tags:before{content:'\e0c6'}.oi-target:before{content:'\e0c7'}.oi-task:before{content:'\e0c8'}.oi-terminal:before{content:'\e0c9'}.oi-text:before{content:'\e0ca'}.oi-thumb-down:before{content:'\e0cb'}.oi-thumb-up:before{content:'\e0cc'}.oi-timer:before{content:'\e0cd'}.oi-transfer:before{content:'\e0ce'}.oi-trash:before{content:'\e0cf'}.oi-underline:before{content:'\e0d0'}.oi-vertical-align-bottom:before{content:'\e0d1'}.oi-vertical-align-center:before{content:'\e0d2'}.oi-vertical-align-top:before{content:'\e0d3'}.oi-video:before{content:'\e0d4'}.oi-volume-high:before{content:'\e0d5'}.oi-volume-low:before{content:'\e0d6'}.oi-volume-off:before{content:'\e0d7'}.oi-warning:before{content:'\e0d8'}.oi-wifi:before{content:'\e0d9'}.oi-wrench:before{content:'\e0da'}.oi-x:before{content:'\e0db'}.oi-yen:before{content:'\e0dc'}.oi-zoom-in:before{content:'\e0dd'}.oi-zoom-out:before{content:'\e0de'}
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/font/fonts/open-iconic.eot b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/font/fonts/open-iconic.eot
new file mode 100644
index 0000000000..f98177dbf7
Binary files /dev/null and b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/font/fonts/open-iconic.eot differ
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/font/fonts/open-iconic.otf b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/font/fonts/open-iconic.otf
new file mode 100644
index 0000000000..f6bd6846a2
Binary files /dev/null and b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/font/fonts/open-iconic.otf differ
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/font/fonts/open-iconic.svg b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/font/fonts/open-iconic.svg
new file mode 100644
index 0000000000..32b2c4e99b
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/font/fonts/open-iconic.svg
@@ -0,0 +1,543 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd" >
+<!--
+2014-7-1: Created.
+-->
+<svg xmlns="http://www.w3.org/2000/svg">
+<metadata>
+Created by FontForge 20120731 at Tue Jul  1 20:39:22 2014
+ By P.J. Onori
+Created by P.J. Onori with FontForge 2.0 (http://fontforge.sf.net)
+</metadata>
+<defs>
+<font id="open-iconic" horiz-adv-x="800" >
+  <font-face 
+    font-family="Icons"
+    font-weight="400"
+    font-stretch="normal"
+    units-per-em="800"
+    panose-1="2 0 5 3 0 0 0 0 0 0"
+    ascent="800"
+    descent="0"
+    bbox="-0.5 -101 802 800.126"
+    underline-thickness="50"
+    underline-position="-100"
+    unicode-range="U+E000-E0DE"
+  />
+    <missing-glyph />
+    <glyph glyph-name="" unicode="&#xe000;" 
+d="M300 700h500v-700h-500v100h400v500h-400v100zM400 500l200 -150l-200 -150v100h-400v100h400v100z" />
+    <glyph glyph-name="1" unicode="&#xe001;" 
+d="M300 700h500v-700h-500v100h400v500h-400v100zM200 500v-100h400v-100h-400v-100l-200 150z" />
+    <glyph glyph-name="2" unicode="&#xe002;" 
+d="M350 700c193 0 350 -157 350 -350v-50h100l-200 -200l-200 200h100v50c0 138 -112 250 -250 250s-250 -112 -250 -250c0 193 157 350 350 350z" />
+    <glyph glyph-name="3" unicode="&#xe003;" 
+d="M450 700c193 0 350 -157 350 -350c0 138 -112 250 -250 250s-250 -112 -250 -250v-50h100l-200 -200l-200 200h100v50c0 193 157 350 350 350z" />
+    <glyph glyph-name="4" unicode="&#xe004;" 
+d="M0 700h800v-100h-800v100zM100 500h600v-100h-600v100zM0 300h800v-100h-800v100zM100 100h600v-100h-600v100z" />
+    <glyph glyph-name="5" unicode="&#xe005;" 
+d="M0 700h800v-100h-800v100zM0 500h600v-100h-600v100zM0 300h800v-100h-800v100zM0 100h600v-100h-600v100z" />
+    <glyph glyph-name="6" unicode="&#xe006;" 
+d="M0 700h800v-100h-800v100zM200 500h600v-100h-600v100zM0 300h800v-100h-800v100zM200 100h600v-100h-600v100z" />
+    <glyph glyph-name="7" unicode="&#xe007;" 
+d="M400 700c75 0 146 -23 206 -59l-75 -225l-322 234c57 31 122 50 191 50zM125 588l191 -138l-310 -222c-4 24 -6 47 -6 72c0 114 49 215 125 288zM688 575c69 -72 112 -168 112 -275c0 -35 -8 -68 -16 -100h-218zM216 253l112 -347c-128 23 -232 109 -287 222zM372 100
+h372c-64 -109 -177 -185 -310 -197z" />
+    <glyph glyph-name="8" unicode="&#xe008;" horiz-adv-x="600" 
+d="M200 800h100v-500h200l-247 -300l-253 300h200v500z" />
+    <glyph glyph-name="9" unicode="&#xe009;" 
+d="M400 800c221 0 400 -179 400 -400s-179 -400 -400 -400s-400 179 -400 400s179 400 400 400zM300 700v-300h-200l300 -300l300 300h-200v300h-200z" />
+    <glyph glyph-name="a" unicode="&#xe00a;" 
+d="M400 800c221 0 400 -179 400 -400s-179 -400 -400 -400s-400 179 -400 400s179 400 400 400zM400 700l-300 -300l300 -300v200h300v200h-300v200z" />
+    <glyph glyph-name="b" unicode="&#xe00b;" 
+d="M400 800c221 0 400 -179 400 -400s-179 -400 -400 -400s-400 179 -400 400s179 400 400 400zM400 700v-200h-300v-200h300v-200l300 300z" />
+    <glyph glyph-name="c" unicode="&#xe00c;" 
+d="M400 800c221 0 400 -179 400 -400s-179 -400 -400 -400s-400 179 -400 400s179 400 400 400zM400 700l-300 -300h200v-300h200v300h200z" />
+    <glyph glyph-name="d" unicode="&#xe00d;" 
+d="M300 600v-200h500v-100h-500v-200l-300 247z" />
+    <glyph glyph-name="e" unicode="&#xe00e;" 
+d="M500 600l300 -247l-300 -253v200h-500v100h500v200z" />
+    <glyph glyph-name="f" unicode="&#xe00f;" horiz-adv-x="600" 
+d="M200 800h200v-500h200l-297 -300l-303 300h200v500z" />
+    <glyph glyph-name="10" unicode="&#xe010;" 
+d="M300 700v-200h500v-200h-500v-200l-300 297z" />
+    <glyph glyph-name="11" unicode="&#xe011;" 
+d="M500 700l300 -297l-300 -303v200h-500v200h500v200z" />
+    <glyph glyph-name="12" unicode="&#xe012;" horiz-adv-x="600" 
+d="M297 800l303 -300h-200v-500h-200v500h-200z" />
+    <glyph glyph-name="13" unicode="&#xe013;" horiz-adv-x="600" 
+d="M247 800l253 -300h-200v-500h-100v500h-200z" />
+    <glyph glyph-name="14" unicode="&#xe014;" 
+d="M400 800h100v-800h-100v800zM200 700h100v-600h-100v600zM600 600h100v-400h-100v400zM0 500h100v-200h-100v200z" />
+    <glyph glyph-name="15" unicode="&#xe015;" 
+d="M116 600l72 -72c-54 -54 -88 -126 -88 -209s34 -159 88 -213l-72 -72c-72 72 -116 175 -116 285s44 209 116 281zM684 600c72 -72 116 -171 116 -281s-44 -213 -116 -285l-72 72c54 54 88 130 88 213s-34 155 -88 209zM259 460l69 -72c-18 -18 -28 -41 -28 -69
+s10 -54 28 -72l-69 -72c-36 36 -59 89 -59 144s23 105 59 141zM541 459c36 -36 59 -85 59 -140s-23 -108 -59 -144l-69 72c18 18 28 44 28 72s-10 51 -28 69z" />
+    <glyph glyph-name="16" unicode="&#xe016;" horiz-adv-x="400" 
+d="M200 800c110 0 200 -90 200 -200s-90 -200 -200 -200s-200 90 -200 200s90 200 200 200zM100 319c31 -11 65 -19 100 -19s68 8 100 19v-319l-100 100l-100 -100v319z" />
+    <glyph glyph-name="17" unicode="&#xe017;" 
+d="M400 800c220 0 400 -180 400 -400s-180 -400 -400 -400s-400 180 -400 400s180 400 400 400zM400 700c-166 0 -300 -134 -300 -300c0 -66 21 -126 56 -175l419 419c-49 35 -109 56 -175 56zM644 575l-419 -419c49 -35 109 -56 175 -56c166 0 300 134 300 300
+c0 66 -21 126 -56 175z" />
+    <glyph glyph-name="18" unicode="&#xe018;" 
+d="M0 700h100v-600h700v-100h-800v700zM500 700h200v-500h-200v500zM200 500h200v-300h-200v300z" />
+    <glyph glyph-name="19" unicode="&#xe019;" 
+d="M397 800c13 1 23 -4 34 -13c2 -2 214 -254 241 -287h128v-100h-100v-366c0 -18 -16 -34 -34 -34h-532c-18 0 -34 16 -34 34v366h-100v100h128l234 281c9 11 22 18 35 19zM400 672l-144 -172h288zM250 300c-28 0 -50 -22 -50 -50v-100c0 -28 22 -50 50 -50s50 22 50 50
+v100c0 28 -22 50 -50 50zM550 300c-28 0 -50 -22 -50 -50v-100c0 -28 22 -50 50 -50s50 22 50 50v100c0 28 -22 50 -50 50z" />
+    <glyph glyph-name="1a" unicode="&#xe01a;" 
+d="M9 700h682c6 0 9 -4 9 -10v-190h100v-200h-100v-191c0 -6 -3 -9 -9 -9h-682c-6 0 -9 3 -9 9v582c0 6 3 9 9 9zM100 600v-400h500v400h-500z" />
+    <glyph glyph-name="1b" unicode="&#xe01b;" 
+d="M9 700h682c6 0 9 -4 9 -10v-190h100v-200h-100v-191c0 -6 -3 -9 -9 -9h-682c-6 0 -9 3 -9 9v582c0 6 3 9 9 9z" />
+    <glyph glyph-name="1c" unicode="&#xe01c;" 
+d="M92 650c0 23 19 50 45 50h3h5h5h500c28 0 50 -22 50 -50s-22 -50 -50 -50h-50v-141c9 -17 120 -231 166 -309c16 -26 34 -61 34 -106c0 -39 -15 -77 -41 -103h-3c-26 -25 -62 -41 -100 -41h-512c-39 0 -77 15 -103 41s-41 64 -41 103c0 46 18 80 34 106
+c46 78 157 292 166 309v141h-50c-2 0 -6 -1 -8 -1c-28 0 -50 23 -50 51zM500 600h-200v-162l-6 -10s-63 -123 -119 -228h450c-56 105 -119 228 -119 228l-6 10v162z" />
+    <glyph glyph-name="1d" unicode="&#xe01d;" 
+d="M400 800c110 0 200 -90 200 -200c0 -104 52 -198 134 -266c41 -34 66 -82 66 -134h-800c0 52 25 100 66 134c82 68 134 162 134 266c0 110 90 200 200 200zM300 100h200c0 -55 -45 -100 -100 -100s-100 45 -100 100z" />
+    <glyph glyph-name="1e" unicode="&#xe01e;" horiz-adv-x="600" 
+d="M150 800h50l350 -250l-225 -147l225 -153l-350 -250h-50v250l-75 -75l-75 75l150 150l-150 150l75 75l75 -75v250zM250 650v-200l150 100zM250 350v-200l150 100z" />
+    <glyph glyph-name="1f" unicode="&#xe01f;" 
+d="M0 800h500c110 0 200 -90 200 -200c0 -47 -17 -91 -44 -125c85 -40 144 -125 144 -225c0 -138 -112 -250 -250 -250h-550v100c55 0 100 45 100 100v400c0 55 -45 100 -100 100v100zM300 700v-200h100c55 0 100 45 100 100s-45 100 -100 100h-100zM300 400v-300h150
+c83 0 150 67 150 150s-67 150 -150 150h-150z" />
+    <glyph glyph-name="20" unicode="&#xe020;" horiz-adv-x="600" 
+d="M300 800v-300h200l-300 -500v300h-200z" />
+    <glyph glyph-name="21" unicode="&#xe021;" 
+d="M100 800h300v-300l100 100l100 -100v300h50c28 0 50 -22 50 -50v-550h-550c-28 0 -50 -22 -50 -50s22 -50 50 -50h550v-100h-550c-83 0 -150 67 -150 150v550l3 19c8 39 39 70 78 78z" />
+    <glyph glyph-name="22" unicode="&#xe022;" horiz-adv-x="400" 
+d="M0 800h400v-800l-200 200l-200 -200v800z" />
+    <glyph glyph-name="23" unicode="&#xe023;" 
+d="M0 800h800v-100h-800v100zM0 600h300v-103h203v103h297v-591c0 -6 -3 -9 -9 -9h-782c-6 0 -9 3 -9 9v591z" />
+    <glyph glyph-name="24" unicode="&#xe024;" 
+d="M300 800h200c55 0 100 -45 100 -100v-100h191c6 0 9 -3 9 -9v-241c0 -28 -22 -50 -50 -50h-700c-28 0 -50 22 -50 50v241c0 6 3 9 9 9h191v100c0 55 45 100 100 100zM300 700v-100h200v100h-200zM0 209c16 -6 32 -9 50 -9h700c18 0 34 3 50 9v-200c0 -6 -3 -9 -9 -9h-782
+c-6 0 -9 3 -9 9v200z" />
+    <glyph glyph-name="25" unicode="&#xe025;" horiz-adv-x="600" 
+d="M300 800c58 0 110 -16 147 -53s53 -89 53 -147h-100c0 39 -11 61 -25 75s-36 25 -75 25c-35 0 -55 -10 -72 -31s-28 -55 -28 -94c0 -51 20 -107 28 -175h172v-100h-178c-14 -60 -49 -127 -113 -200h491v-100h-600v122l16 12c69 69 95 121 106 166h-122v100h125
+c-8 50 -25 106 -25 175c0 58 16 114 50 156c34 43 88 69 150 69z" />
+    <glyph glyph-name="26" unicode="&#xe026;" 
+d="M34 700h4h3h4h5h700c28 0 50 -22 50 -50v-700c0 -28 -22 -50 -50 -50h-700c-28 0 -50 22 -50 50v700v2c0 20 15 42 34 48zM150 600c-28 0 -50 -22 -50 -50s22 -50 50 -50s50 22 50 50s-22 50 -50 50zM350 600c-28 0 -50 -22 -50 -50s22 -50 50 -50h300c28 0 50 22 50 50
+s-22 50 -50 50h-300zM100 400v-400h600v400h-600z" />
+    <glyph glyph-name="27" unicode="&#xe027;" 
+d="M744 797l6 -3l44 -44c4 -4 3 -8 0 -12l-266 -375l-15 -13l-25 -12c-23 72 -78 127 -150 150l12 25l13 15l375 266zM266 400c74 0 134 -60 134 -134c0 -147 -119 -266 -266 -266c-48 0 -95 12 -134 34c80 46 134 133 134 232c0 74 58 134 132 134z" />
+    <glyph glyph-name="28" unicode="&#xe028;" 
+d="M9 451c0 23 19 50 46 50c8 0 19 -3 26 -7l131 -66l29 22c-79 81 -1 250 118 250s197 -167 119 -250l28 -22l131 66c6 4 12 7 21 7c28 0 50 -22 50 -50c0 -17 -12 -37 -27 -45l-115 -56c9 -16 19 -33 25 -50h68c28 0 50 -22 50 -50s-22 -50 -50 -50h-50
+c0 -23 -2 -45 -6 -66l78 -40c21 -5 37 -28 37 -49c0 -28 -22 -50 -50 -50c-10 0 -23 5 -31 11l-65 35c-24 -46 -62 -86 -103 -110c-35 19 -60 45 -60 72v135v4v5v6v5v5v87c0 28 -22 50 -50 50c-24 0 -45 -17 -50 -40c1 -3 1 -8 1 -11s0 -8 -1 -11v-82v-4v-5v-144
+c0 -28 -24 -53 -59 -72c-41 25 -79 64 -103 110l-66 -35c-8 -6 -21 -11 -31 -11c-28 0 -50 22 -50 50c0 21 16 44 37 49l78 40c-4 21 -6 43 -6 66h-50h-5c-28 0 -50 22 -50 50c0 26 22 50 50 50h5h69c6 17 16 34 25 50l-116 56c-16 7 -28 27 -28 45z" />
+    <glyph glyph-name="29" unicode="&#xe029;" 
+d="M600 700h91c6 0 9 -3 9 -9v-582c0 -6 -3 -9 -9 -9h-91v600zM210 503l290 147v-500l-250 125v-3c-15 0 -25 -8 -28 -22l75 -178c11 -25 0 -58 -25 -69s-58 0 -69 25l-103 272h-91c-6 0 -9 3 -9 9v182c0 6 3 9 9 9h182z" />
+    <glyph glyph-name="2a" unicode="&#xe02a;" 
+d="M9 800h682c6 0 9 -3 9 -9v-782c0 -6 -3 -9 -9 -9h-682c-6 0 -9 3 -9 9v782c0 6 3 9 9 9zM100 700v-200h500v200h-500zM100 400v-100h100v100h-100zM300 400v-100h100v100h-100zM500 400v-300h100v300h-100zM100 200v-100h100v100h-100zM300 200v-100h100v100h-100z" />
+    <glyph glyph-name="2b" unicode="&#xe02b;" 
+d="M0 800h700v-200h-700v200zM0 500h700v-491c0 -6 -3 -9 -9 -9h-682c-6 0 -9 3 -9 9v491zM100 400v-100h100v100h-100zM300 400v-100h100v100h-100zM500 400v-100h100v100h-100zM100 200v-100h100v100h-100zM300 200v-100h100v100h-100z" />
+    <glyph glyph-name="2c" unicode="&#xe02c;" 
+d="M409 800h182c6 0 10 -4 12 -9l94 -182c2 -5 6 -9 12 -9h82c6 0 9 -3 9 -9v-582c0 -6 -3 -9 -9 -9h-782c-6 0 -9 3 -9 9v441c0 83 67 150 150 150h141c6 0 10 4 12 9l94 182c2 5 6 9 12 9zM150 500c-28 0 -50 -22 -50 -50s22 -50 50 -50s50 22 50 50s-22 50 -50 50z
+M500 500c-110 0 -200 -90 -200 -200s90 -200 200 -200s200 90 200 200s-90 200 -200 200zM500 400c55 0 100 -45 100 -100s-45 -100 -100 -100s-100 45 -100 100s45 100 100 100z" />
+    <glyph glyph-name="2d" unicode="&#xe02d;" 
+d="M0 600h800l-400 -400z" />
+    <glyph glyph-name="2e" unicode="&#xe02e;" horiz-adv-x="400" 
+d="M400 800v-800l-400 400z" />
+    <glyph glyph-name="2f" unicode="&#xe02f;" horiz-adv-x="400" 
+d="M0 800l400 -400l-400 -400v800z" />
+    <glyph glyph-name="30" unicode="&#xe030;" 
+d="M400 600l400 -400h-800z" />
+    <glyph glyph-name="31" unicode="&#xe031;" 
+d="M0 550c0 23 20 50 46 50h3h5h4h200c17 0 37 -13 44 -28l38 -72h444c14 0 19 -12 15 -25l-81 -250c-4 -13 -21 -25 -35 -25h-350c-14 0 -30 12 -34 25c-27 83 -54 167 -81 250l-10 25h-150c-2 0 -5 -1 -7 -1c-28 0 -51 23 -51 51zM358 100c28 0 50 -22 50 -50
+s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM658 100c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50z" />
+    <glyph glyph-name="32" unicode="&#xe032;" 
+d="M0 700h500v-100h-300v-300h-100l-100 -100v500zM300 500h500v-500l-100 100h-400v400z" />
+    <glyph glyph-name="33" unicode="&#xe033;" 
+d="M641 700l143 -141l-493 -493c-71 76 -146 148 -219 222l-72 71l141 141c50 -51 101 -101 153 -150c116 117 234 231 347 350z" />
+    <glyph glyph-name="34" unicode="&#xe034;" 
+d="M150 600l250 -250l250 250l150 -150l-400 -400l-400 400z" />
+    <glyph glyph-name="35" unicode="&#xe035;" horiz-adv-x="600" 
+d="M400 800l150 -150l-250 -250l250 -250l-150 -150l-400 400z" />
+    <glyph glyph-name="36" unicode="&#xe036;" horiz-adv-x="600" 
+d="M150 800l400 -400l-400 -400l-150 150l250 250l-250 250z" />
+    <glyph glyph-name="37" unicode="&#xe037;" 
+d="M400 600l400 -400l-150 -150l-250 250l-250 -250l-150 150z" />
+    <glyph glyph-name="38" unicode="&#xe038;" 
+d="M400 800c221 0 400 -179 400 -400s-179 -400 -400 -400s-400 179 -400 400s179 400 400 400zM600 622l-250 -250l-100 100l-72 -72l172 -172l322 322z" />
+    <glyph glyph-name="39" unicode="&#xe039;" 
+d="M400 800c221 0 400 -179 400 -400s-179 -400 -400 -400s-400 179 -400 400s179 400 400 400zM250 622l-72 -72l150 -150l-150 -150l72 -72l150 150l150 -150l72 72l-150 150l150 150l-72 72l-150 -150z" />
+    <glyph glyph-name="3a" unicode="&#xe03a;" 
+d="M350 800c28 0 50 -22 50 -50v-50h75c14 0 25 -11 25 -25v-75h-300v75c0 14 11 25 25 25h75v50c0 28 22 50 50 50zM25 700h75v-200h500v200h75c14 0 25 -11 25 -25v-650c0 -14 -11 -25 -25 -25h-650c-14 0 -25 11 -25 25v650c0 14 11 25 25 25z" />
+    <glyph glyph-name="3b" unicode="&#xe03b;" 
+d="M400 800c220 0 400 -180 400 -400s-180 -400 -400 -400s-400 180 -400 400s180 400 400 400zM400 700c-166 0 -300 -134 -300 -300s134 -300 300 -300s300 134 300 300s-134 300 -300 300zM350 600h100v-181c23 -24 47 -47 72 -69l-72 -72c-27 30 -55 59 -84 88l-16 12
+v222z" />
+    <glyph glyph-name="3c" unicode="&#xe03c;" 
+d="M450 800c138 0 250 -112 250 -250v-50c58 -21 100 -85 100 -150c0 -18 -3 -34 -9 -50h-191v50c0 83 -67 150 -150 150s-150 -67 -150 -150v-50h-272c-17 30 -28 63 -28 100c0 110 90 200 200 200c23 114 129 200 250 200zM434 400h3h4c3 0 6 1 9 1c28 0 50 -22 50 -50v-1
+v-150h150l-200 -200l-200 200h150v150v2c0 20 15 42 34 48z" />
+    <glyph glyph-name="3d" unicode="&#xe03d;" 
+d="M450 800c138 0 250 -112 250 -250v-50c58 -21 100 -85 100 -150c0 -18 -3 -34 -9 -50h-141l-200 200l-200 -200h-222c-17 30 -28 63 -28 100c0 110 90 200 200 200c23 114 129 200 250 200zM450 350l250 -250h-200v-50c0 -28 -22 -50 -50 -50s-50 22 -50 50v50h-200z" />
+    <glyph glyph-name="3e" unicode="&#xe03e;" 
+d="M450 700c138 0 250 -112 250 -250v-50c58 -21 100 -85 100 -150c0 -83 -67 -150 -150 -150h-450c-110 0 -200 90 -200 200s90 200 200 200c23 114 129 200 250 200z" />
+    <glyph glyph-name="3f" unicode="&#xe03f;" 
+d="M250 800c82 0 154 -40 200 -100c-143 0 -270 -85 -325 -209c-36 -10 -70 -25 -100 -47c-16 33 -25 67 -25 106c0 138 112 250 250 250zM450 600c138 0 250 -112 250 -250v-50c58 -21 100 -85 100 -150c0 -83 -67 -150 -150 -150h-450c-110 0 -200 90 -200 200
+s90 200 200 200c23 114 129 200 250 200z" />
+    <glyph glyph-name="40" unicode="&#xe040;" 
+d="M500 700h100l-300 -600h-100zM100 600h100l-100 -200l100 -200h-100l-100 200zM600 600h100l100 -200l-100 -200h-100l100 200z" />
+    <glyph glyph-name="41" unicode="&#xe041;" 
+d="M350 800h100l50 -119l28 -12l119 50l72 -72l-50 -119l12 -28l119 -50v-100l-119 -50l-12 -28l50 -119l-72 -72l-119 50l-28 -12l-50 -119h-100l-50 119l-28 12l-119 -50l-72 72l50 119l-12 28l-119 50v100l119 50l12 28l-50 119l72 72l119 -50l28 12zM400 550
+c-83 0 -150 -67 -150 -150s67 -150 150 -150s150 67 150 150s-67 150 -150 150z" />
+    <glyph glyph-name="42" unicode="&#xe042;" 
+d="M0 800h800v-200h-800v200zM200 500h400l-200 -200zM0 100h800v-100h-800v100z" />
+    <glyph glyph-name="43" unicode="&#xe043;" 
+d="M0 800h100v-800h-100v800zM600 800h200v-800h-200v800zM500 600v-400l-200 200z" />
+    <glyph glyph-name="44" unicode="&#xe044;" 
+d="M0 800h200v-800h-200v800zM700 800h100v-800h-100v800zM300 600l200 -200l-200 -200v400z" />
+    <glyph glyph-name="45" unicode="&#xe045;" 
+d="M0 800h800v-100h-800v100zM400 500l200 -200h-400zM0 200h800v-200h-800v200z" />
+    <glyph glyph-name="46" unicode="&#xe046;" 
+d="M150 700c83 0 150 -67 150 -150v-50h100v50c0 83 67 150 150 150s150 -67 150 -150s-67 -150 -150 -150h-50v-100h50c83 0 150 -67 150 -150s-67 -150 -150 -150s-150 67 -150 150v50h-100v-50c0 -83 -67 -150 -150 -150s-150 67 -150 150s67 150 150 150h50v100h-50
+c-83 0 -150 67 -150 150s67 150 150 150zM150 600c-28 0 -50 -22 -50 -50s22 -50 50 -50h50v50c0 28 -22 50 -50 50zM550 600c-28 0 -50 -22 -50 -50v-50h50c28 0 50 22 50 50s-22 50 -50 50zM300 400v-100h100v100h-100zM150 200c-28 0 -50 -22 -50 -50s22 -50 50 -50
+s50 22 50 50v50h-50zM500 200v-50c0 -28 22 -50 50 -50s50 22 50 50s-22 50 -50 50h-50z" />
+    <glyph glyph-name="47" unicode="&#xe047;" 
+d="M0 791c0 5 4 9 9 9h782c6 0 9 -4 9 -10v-790l-200 200h-591c-6 0 -9 3 -9 9v582z" />
+    <glyph glyph-name="48" unicode="&#xe048;" 
+d="M400 800c220 0 400 -180 400 -400s-180 -400 -400 -400s-400 180 -400 400s180 400 400 400zM400 700c-166 0 -300 -134 -300 -300s134 -300 300 -300s300 134 300 300s-134 300 -300 300zM600 600l-100 -300l-300 -100l100 300zM400 450c-28 0 -50 -22 -50 -50
+s22 -50 50 -50s50 22 50 50s-22 50 -50 50z" />
+    <glyph glyph-name="49" unicode="&#xe049;" 
+d="M400 800c220 0 400 -180 400 -400s-180 -400 -400 -400s-400 180 -400 400s180 400 400 400zM400 700v-600c166 0 300 134 300 300s-134 300 -300 300z" />
+    <glyph glyph-name="4a" unicode="&#xe04a;" 
+d="M0 800h800v-100h-800v100zM0 600h500v-100h-500v100zM0 300h800v-100h-800v100zM0 100h600v-100h-600v100zM750 100c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50z" />
+    <glyph glyph-name="4b" unicode="&#xe04b;" 
+d="M25 700h750c14 0 25 -11 25 -25v-75h-800v75c0 14 11 25 25 25zM0 500h800v-375c0 -14 -11 -25 -25 -25h-750c-14 0 -25 11 -25 25v375zM100 300v-100h100v100h-100zM300 300v-100h100v100h-100z" />
+    <glyph glyph-name="4c" unicode="&#xe04c;" 
+d="M100 800h100v-100h450l100 100l50 -50l-100 -100v-450h100v-100h-100v-100h-100v100h-500v500h-100v100h100v100zM200 600v-350l350 350h-350zM600 550l-350 -350h350v350z" />
+    <glyph glyph-name="4d" unicode="&#xe04d;" 
+d="M400 800c220 0 400 -180 400 -400s-180 -400 -400 -400s-400 180 -400 400s180 400 400 400zM400 700c-166 0 -300 -134 -300 -300s134 -300 300 -300s300 134 300 300s-134 300 -300 300zM400 600c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50z
+M200 452c0 20 15 42 34 48h3h3h8c12 0 28 -7 36 -16l91 -90l25 6c55 0 100 -45 100 -100s-45 -100 -100 -100s-100 45 -100 100l6 25l-90 91c-9 8 -16 24 -16 36zM550 500c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50z" />
+    <glyph glyph-name="4e" unicode="&#xe04e;" 
+d="M300 800h200v-300h200l-300 -300l-300 300h200v300zM0 100h800v-100h-800v100z" />
+    <glyph glyph-name="4f" unicode="&#xe04f;" 
+d="M0 800h800v-100h-800v100zM400 600l300 -300h-200v-300h-200v300h-200z" />
+    <glyph glyph-name="50" unicode="&#xe050;" 
+d="M200 700h600v-600h-600l-200 300zM350 622l-72 -72l150 -150l-150 -150l72 -72l150 150l150 -150l72 72l-150 150l150 150l-72 72l-150 -150z" />
+    <glyph glyph-name="51" unicode="&#xe051;" 
+d="M400 700c220 0 400 -180 400 -400h-100c0 166 -134 300 -300 300s-300 -134 -300 -300h-100c0 220 180 400 400 400zM341 491l59 -88l59 88c81 -25 141 -101 141 -191c0 -110 -90 -200 -200 -200s-200 90 -200 200c0 90 60 166 141 191z" />
+    <glyph glyph-name="52" unicode="&#xe052;" 
+d="M0 800h300v-400h400v-400h-700v800zM400 800l300 -300h-300v300zM100 600v-100h100v100h-100zM100 400v-100h100v100h-100zM100 200v-100h400v100h-400z" />
+    <glyph glyph-name="53" unicode="&#xe053;" horiz-adv-x="600" 
+d="M200 700h100v-100h75c30 0 58 -6 81 -22s44 -44 44 -78v-100h-100v94c-4 3 -13 6 -25 6h-250c-14 0 -25 -11 -25 -25v-50c0 -15 20 -40 34 -44l257 -65c66 -16 109 -73 109 -141v-50c0 -68 -57 -125 -125 -125h-75v-100h-100v100h-75c-30 0 -58 6 -81 22s-44 44 -44 78
+v100h100v-94c4 -3 13 -6 25 -6h250c14 0 25 11 25 25v50c0 15 -20 40 -34 44l-257 65c-66 16 -109 73 -109 141v50c0 68 57 125 125 125h75v100z" />
+    <glyph glyph-name="54" unicode="&#xe054;" 
+d="M0 700h300v-300l-300 -300v600zM500 700h300v-300l-300 -300v600z" />
+    <glyph glyph-name="55" unicode="&#xe055;" 
+d="M300 700v-600h-300v300zM800 700v-600h-300v300z" />
+    <glyph glyph-name="56" unicode="&#xe056;" 
+d="M300 700v-100c-111 0 -200 -89 -200 -200h200v-300h-300v300c0 165 135 300 300 300zM800 700v-100c-111 0 -200 -89 -200 -200h200v-300h-300v300c0 165 135 300 300 300z" />
+    <glyph glyph-name="57" unicode="&#xe057;" 
+d="M0 700h300v-300c0 -165 -135 -300 -300 -300v100c111 0 200 89 200 200h-200v300zM500 700h300v-300c0 -165 -135 -300 -300 -300v100c111 0 200 89 200 200h-200v300z" />
+    <glyph glyph-name="58" unicode="&#xe058;" horiz-adv-x="600" 
+d="M300 800l34 -34c11 -11 266 -270 266 -488c0 -165 -135 -300 -300 -300s-300 135 -300 300c0 218 255 477 266 488zM150 328c-28 0 -50 -22 -50 -50c0 -110 90 -200 200 -200c28 0 50 22 50 50s-22 50 -50 50c-55 0 -100 45 -100 100c0 28 -22 50 -50 50z" />
+    <glyph glyph-name="59" unicode="&#xe059;" 
+d="M400 800l400 -500h-800zM0 200h800v-200h-800v200z" />
+    <glyph glyph-name="5a" unicode="&#xe05a;" horiz-adv-x="600" 
+d="M300 800l300 -300h-600zM0 300h600l-300 -300z" />
+    <glyph glyph-name="5b" unicode="&#xe05b;" 
+d="M0 500h200v-200h-200v200zM300 500h200v-200h-200v200zM600 500h200v-200h-200v200z" />
+    <glyph glyph-name="5c" unicode="&#xe05c;" 
+d="M0 700h800v-100l-400 -200l-400 200v100zM0 500l400 -200l400 200v-400h-800v400z" />
+    <glyph glyph-name="5d" unicode="&#xe05d;" 
+d="M400 800l400 -200v-600h-800v600zM400 688l-300 -150v-188l300 -150l300 150v188zM200 500h400v-100l-200 -100l-200 100v100z" />
+    <glyph glyph-name="5e" unicode="&#xe05e;" 
+d="M600 700c69 0 134 -19 191 -50l-16 -106c-49 35 -109 56 -175 56c-131 0 -240 -84 -281 -200h331l-16 -100h-334c0 -36 8 -68 19 -100h297l-16 -100h-222c55 -61 133 -100 222 -100c78 0 147 30 200 78v-122c-59 -35 -127 -56 -200 -56c-147 0 -274 82 -344 200h-256
+l19 100h197c-8 32 -16 66 -16 100h-200l25 100h191c45 172 198 300 384 300z" />
+    <glyph glyph-name="5f" unicode="&#xe05f;" 
+d="M0 700h700v-100h-700v100zM0 500h500v-100h-500v100zM0 300h800v-100h-800v100zM0 100h100v-100h-100v100zM200 100h100v-100h-100v100zM400 100h100v-100h-100v100z" />
+    <glyph glyph-name="60" unicode="&#xe060;" 
+d="M0 800h800v-100h-800v100zM200 600h400l-200 -200zM0 200h800v-200h-800v200z" />
+    <glyph glyph-name="61" unicode="&#xe061;" 
+d="M0 800h100v-800h-100v800zM600 800h200v-800h-200v800zM200 600l200 -200l-200 -200v400z" />
+    <glyph glyph-name="62" unicode="&#xe062;" 
+d="M0 800h200v-800h-200v800zM700 800h100v-800h-100v800zM600 600v-400l-200 200z" />
+    <glyph glyph-name="63" unicode="&#xe063;" 
+d="M0 800h800v-200h-800v200zM400 400l200 -200h-400zM0 100h800v-100h-800v100z" />
+    <glyph glyph-name="64" unicode="&#xe064;" 
+d="M0 800h200v-100h-100v-600h600v100h100v-200h-800v800zM400 800h400v-400l-150 150l-250 -250l-100 100l250 250z" />
+    <glyph glyph-name="65" unicode="&#xe065;" 
+d="M403 700c247 0 397 -300 397 -300s-150 -300 -397 -300c-253 0 -403 300 -403 300s150 300 403 300zM400 600c-110 0 -200 -90 -200 -200s90 -200 200 -200s200 90 200 200s-90 200 -200 200zM400 500c10 0 19 -3 28 -6c-16 -8 -28 -24 -28 -44c0 -28 22 -50 50 -50
+c20 0 36 12 44 28c3 -9 6 -18 6 -28c0 -55 -45 -100 -100 -100s-100 45 -100 100s45 100 100 100z" />
+    <glyph glyph-name="66" unicode="&#xe066;" horiz-adv-x="900" 
+d="M331 700h3h3c3 1 7 1 10 1c12 0 29 -8 37 -17l94 -93l66 65c57 57 155 57 212 0c58 -58 58 -154 0 -212l-65 -66l93 -94c10 -8 18 -25 18 -38c0 -28 -22 -50 -50 -50c-13 0 -32 9 -40 20l-62 65l-381 -381h-269v272l375 381l-63 63c-9 8 -16 24 -16 36c0 20 16 42 35 48z
+M447 481l-313 -315l128 -132l316 316z" />
+    <glyph glyph-name="67" unicode="&#xe067;" 
+d="M0 800h300v-400h400v-400h-700v800zM400 800l300 -300h-300v300z" />
+    <glyph glyph-name="68" unicode="&#xe068;" 
+d="M200 800c0 0 200 -100 200 -300s-298 -302 -200 -500c0 0 -200 100 -200 300s300 300 200 500zM500 500c0 0 200 -100 200 -300c0 -150 -60 -200 -100 -200h-300c0 200 300 300 200 500z" />
+    <glyph glyph-name="69" unicode="&#xe069;" 
+d="M0 800h100v-800h-100v800zM200 800h300v-100h300l-200 -203l200 -197h-400v100h-200v400z" />
+    <glyph glyph-name="6a" unicode="&#xe06a;" horiz-adv-x="400" 
+d="M150 800h150l-100 -200h200l-150 -300h150l-300 -300l-100 300h134l66 200h-200z" />
+    <glyph glyph-name="6b" unicode="&#xe06b;" 
+d="M0 800h300v-100h500v-100h-800v200zM0 500h800v-450c0 -28 -22 -50 -50 -50h-700c-28 0 -50 22 -50 50v450z" />
+    <glyph glyph-name="6c" unicode="&#xe06c;" 
+d="M150 800c83 0 150 -67 150 -150c0 -66 -41 -121 -100 -141v-118c15 5 33 9 50 9h200c28 0 50 22 50 50v59c-59 20 -100 75 -100 141c0 83 67 150 150 150s150 -67 150 -150c0 -66 -41 -121 -100 -141v-59c0 -82 -68 -150 -150 -150h-200c-14 0 -25 -7 -34 -16
+c50 -24 84 -74 84 -134c0 -83 -67 -150 -150 -150s-150 67 -150 150c0 66 41 121 100 141v218c-59 20 -100 75 -100 141c0 83 67 150 150 150z" />
+    <glyph glyph-name="6d" unicode="&#xe06d;" 
+d="M0 800h400l-150 -150l150 -150l-100 -100l-150 150l-150 -150v400zM500 400l150 -150l150 150v-400h-400l150 150l-150 150z" />
+    <glyph glyph-name="6e" unicode="&#xe06e;" 
+d="M100 800l150 -150l150 150v-400h-400l150 150l-150 150zM400 400h400l-150 -150l150 -150l-100 -100l-150 150l-150 -150v400z" />
+    <glyph glyph-name="6f" unicode="&#xe06f;" 
+d="M400 800c221 0 400 -179 400 -400s-179 -400 -400 -400s-400 179 -400 400s179 400 400 400zM400 700c-56 0 -108 -17 -153 -44l22 -19c33 -18 13 -48 -13 -59c-30 -13 -77 10 -65 -41c13 -55 -27 -3 -47 -15c-42 -26 49 -152 31 -156l-59 34c-8 0 -13 -5 -16 -10
+c1 -30 10 -57 19 -84c28 -11 77 -2 100 -25c47 -28 97 -115 75 -159c34 -13 68 -22 106 -22c101 0 193 48 247 125c3 24 -8 44 -50 44c-69 0 -156 13 -153 97c2 46 101 108 66 143c-30 30 12 39 12 66c0 37 -65 32 -69 50s20 36 41 56c-30 10 -60 19 -94 19zM631 591
+c-38 -11 -94 -35 -87 -53c6 -15 52 -1 65 -13c11 -10 16 -59 44 -31l22 22v3c-11 26 -26 50 -44 72z" />
+    <glyph glyph-name="70" unicode="&#xe070;" 
+d="M703 800l97 -100l-400 -400l-100 100l-200 -203l-100 100l300 303l100 -100zM0 100h800v-100h-800v100z" />
+    <glyph glyph-name="71" unicode="&#xe071;" 
+d="M0 700h100v-100h-100v100zM200 700h100v-100h-100v100zM400 700h100v-100h-100v100zM600 700h100v-100h-100v100zM0 500h100v-100h-100v100zM200 500h100v-100h-100v100zM400 500h100v-100h-100v100zM600 500h100v-100h-100v100zM0 300h100v-100h-100v100zM200 300h100
+v-100h-100v100zM400 300h100v-100h-100v100zM600 300h100v-100h-100v100zM0 100h100v-100h-100v100zM200 100h100v-100h-100v100zM400 100h100v-100h-100v100zM600 100h100v-100h-100v100z" />
+    <glyph glyph-name="72" unicode="&#xe072;" 
+d="M0 800h200v-200h-200v200zM300 800h200v-200h-200v200zM600 800h200v-200h-200v200zM0 500h200v-200h-200v200zM300 500h200v-200h-200v200zM600 500h200v-200h-200v200zM0 200h200v-200h-200v200zM300 200h200v-200h-200v200zM600 200h200v-200h-200v200z" />
+    <glyph glyph-name="73" unicode="&#xe073;" 
+d="M0 800h300v-300h-300v300zM500 800h300v-300h-300v300zM0 300h300v-300h-300v300zM500 300h300v-300h-300v300z" />
+    <glyph glyph-name="74" unicode="&#xe074;" 
+d="M19 800h662c11 0 19 -8 19 -19v-331c0 -28 -22 -50 -50 -50h-600c-28 0 -50 22 -50 50v331c0 11 8 19 19 19zM0 309c16 -6 32 -9 50 -9h600c18 0 34 3 50 9v-290c0 -11 -8 -19 -19 -19h-662c-11 0 -19 8 -19 19v290zM550 200c-28 0 -50 -22 -50 -50s22 -50 50 -50
+s50 22 50 50s-22 50 -50 50z" />
+    <glyph glyph-name="75" unicode="&#xe075;" 
+d="M0 700h300v-100h-50c-28 0 -50 -22 -50 -50v-150h300v150c0 28 -22 50 -50 50h-50v100h300v-100h-50c-28 0 -50 -22 -50 -50v-400c0 -28 22 -50 50 -50h50v-100h-300v100h50c28 0 50 22 50 50v150h-300v-150c0 -28 22 -50 50 -50h50v-100h-300v100h50c28 0 50 22 50 50
+v400c0 28 -22 50 -50 50h-50v100z" />
+    <glyph glyph-name="76" unicode="&#xe076;" 
+d="M400 700c165 0 300 -135 300 -300v-100h50c28 0 50 -22 50 -50v-200c0 -28 -22 -50 -50 -50h-100c-28 0 -50 22 -50 50v350c0 111 -89 200 -200 200s-200 -89 -200 -200v-350c0 -28 -22 -50 -50 -50h-100c-28 0 -50 22 -50 50v200c0 28 22 50 50 50h50v100
+c0 165 135 300 300 300z" />
+    <glyph glyph-name="77" unicode="&#xe077;" 
+d="M0 500c0 109 91 200 200 200s200 -91 200 -200c0 109 91 200 200 200s200 -91 200 -200c0 -55 -23 -105 -59 -141l-341 -340l-341 340c-36 36 -59 86 -59 141z" />
+    <glyph glyph-name="78" unicode="&#xe078;" 
+d="M400 700l400 -300l-100 3v-403h-200v200h-200v-200h-200v400h-100z" />
+    <glyph glyph-name="79" unicode="&#xe079;" 
+d="M0 800h800v-800h-800v800zM100 700v-300l100 100l400 -400h100v100l-200 200l100 100l100 -100v300h-600z" />
+    <glyph glyph-name="7a" unicode="&#xe07a;" 
+d="M19 800h762c11 0 19 -8 19 -19v-762c0 -11 -8 -19 -19 -19h-762c-11 0 -19 8 -19 19v762c0 11 8 19 19 19zM100 600v-300h100l100 -100h200l100 100h100v300h-600z" />
+    <glyph glyph-name="7b" unicode="&#xe07b;" 
+d="M200 600c80 0 142 -56 200 -122c58 66 119 122 200 122c131 0 200 -101 200 -200s-69 -200 -200 -200c-81 0 -142 56 -200 122c-58 -66 -121 -122 -200 -122c-131 0 -200 101 -200 200s69 200 200 200zM200 500c-74 0 -100 -54 -100 -100s26 -100 100 -100
+c42 0 88 47 134 100c-46 53 -92 100 -134 100zM600 500c-43 0 -88 -47 -134 -100c46 -53 91 -100 134 -100c74 0 100 54 100 100s-26 100 -100 100z" />
+    <glyph glyph-name="7c" unicode="&#xe07c;" horiz-adv-x="400" 
+d="M300 800c55 0 100 -45 100 -100s-45 -100 -100 -100s-100 45 -100 100s45 100 100 100zM150 550c83 0 150 -69 150 -150c0 -66 -100 -214 -100 -250c0 -28 22 -50 50 -50s50 22 50 50h100c0 -83 -67 -150 -150 -150s-150 64 -150 150s100 222 100 250s-22 50 -50 50
+s-50 -22 -50 -50h-100c0 83 67 150 150 150z" />
+    <glyph glyph-name="7d" unicode="&#xe07d;" 
+d="M200 800h500v-100h-122c-77 -197 -156 -392 -234 -588l-6 -12h162v-100h-500v100h122c77 197 156 392 234 588l7 12h-163v100z" />
+    <glyph glyph-name="7e" unicode="&#xe07e;" 
+d="M0 700h800v-100h-800v100zM0 500h800v-100h-800v100zM0 300h800v-100h-800v100zM100 100h600v-100h-600v100z" />
+    <glyph glyph-name="7f" unicode="&#xe07f;" 
+d="M0 700h800v-100h-800v100zM0 500h800v-100h-800v100zM0 300h800v-100h-800v100zM0 100h600v-100h-600v100z" />
+    <glyph glyph-name="80" unicode="&#xe080;" 
+d="M0 700h800v-100h-800v100zM0 500h800v-100h-800v100zM0 300h800v-100h-800v100zM200 100h600v-100h-600v100z" />
+    <glyph glyph-name="81" unicode="&#xe081;" 
+d="M550 800c138 0 250 -112 250 -250s-112 -250 -250 -250c-16 0 -32 0 -47 3l-3 -3v-100h-200v-200h-300v200l303 303c-3 15 -3 31 -3 47c0 138 112 250 250 250zM600 700c-55 0 -100 -45 -100 -100s45 -100 100 -100s100 45 100 100s-45 100 -100 100z" />
+    <glyph glyph-name="82" unicode="&#xe082;" 
+d="M134 600h3h4h4h5h500c28 0 50 -22 50 -50v-350h100v-150c0 -28 -22 -50 -50 -50h-700c-28 0 -50 22 -50 50v150h100v350v2c0 20 15 42 34 48zM200 500v-300h100v-100h200v100h100v300h-400z" />
+    <glyph glyph-name="83" unicode="&#xe083;" 
+d="M0 800h400v-400h-400v400zM500 600h100v-400h-400v100h300v300zM700 400h100v-400h-400v100h300v300z" />
+    <glyph glyph-name="84" unicode="&#xe084;" horiz-adv-x="600" 
+d="M337 694c6 4 12 7 21 7c28 0 50 -22 50 -50c0 -17 -12 -37 -27 -45l-300 -150c-8 -6 -21 -11 -31 -11c-28 0 -50 22 -50 50c0 21 16 44 37 49zM437 544c6 4 12 7 21 7c28 0 50 -22 50 -50c0 -17 -12 -37 -27 -45l-400 -200c-8 -6 -21 -11 -31 -11c-28 0 -50 22 -50 50
+c0 21 16 44 37 49zM437 344c6 4 12 7 21 7c28 0 50 -22 50 -50c0 -17 -12 -37 -27 -45l-106 -56c24 -4 43 -26 43 -50c0 -28 -23 -51 -51 -51c-2 0 -6 1 -8 1h-200c-26 1 -48 24 -48 50c0 16 12 36 26 44zM151 -50c0 23 20 50 46 50h3h4h5h100c28 0 50 -22 50 -50
+s-22 -50 -50 -50h-100c-2 0 -6 -1 -8 -1c-28 0 -50 23 -50 51z" />
+    <glyph glyph-name="85" unicode="&#xe085;" 
+d="M199 800h100v-200h-200v100h100v100zM586 797h1c18 1 38 1 56 -3c36 -8 69 -26 97 -54c78 -78 78 -203 0 -281l-150 -150c-8 -13 -28 -24 -43 -24c-28 0 -50 22 -50 50c0 15 11 35 24 43l150 150c40 40 39 105 0 144c-41 41 -110 34 -144 0l-44 -44
+c-8 -13 -27 -24 -42 -24c-28 0 -50 22 -50 50c0 15 11 35 24 43l43 44c32 33 72 53 128 56zM208 490c4 5 14 16 22 16h3c2 0 6 1 8 1c28 0 50 -22 50 -50c0 -11 -6 -27 -14 -35l-150 -150c-40 -40 -39 -105 0 -144c41 -41 110 -34 144 0l44 44c8 13 27 24 42 24
+c28 0 50 -22 50 -50c0 -15 -11 -35 -24 -43l-43 -44c-22 -22 -48 -37 -75 -47c-70 -25 -151 -9 -207 47c-78 78 -78 203 0 281zM499 200h200v-100h-100v-100h-100v200z" />
+    <glyph glyph-name="86" unicode="&#xe086;" 
+d="M586 797c18 1 39 1 57 -3c36 -8 69 -26 97 -54c78 -78 78 -203 0 -281l-150 -150c-62 -62 -132 -81 -182 -78s-69 17 -84 25s-26 27 -26 44c0 28 22 51 50 51c8 0 19 -3 26 -7c0 0 15 -11 41 -13s62 3 106 47l150 150c40 40 39 105 0 144c-41 41 -110 34 -144 0
+c-8 -13 -28 -24 -43 -24c-28 0 -50 22 -50 50c0 15 11 35 24 43c32 33 72 53 128 56zM386 566c50 -2 64 -17 85 -22s37 -28 37 -49c0 -28 -22 -50 -50 -50c-10 0 -23 5 -31 11c0 0 -19 9 -47 10s-63 -4 -103 -44l-150 -150c-40 -40 -39 -105 0 -144c41 -41 110 -34 144 0
+c8 13 27 24 42 24c28 0 50 -22 50 -50c0 -15 -10 -35 -23 -43c-22 -22 -48 -37 -75 -47c-70 -25 -151 -9 -207 47c-78 78 -78 203 0 281l150 150c60 60 128 78 178 76z" />
+    <glyph glyph-name="87" unicode="&#xe087;" 
+d="M0 700h300v-300h-300v300zM400 700h400v-100h-400v100zM400 500h300v-100h-300v100zM0 300h300v-300h-300v300zM400 300h400v-100h-400v100zM400 100h300v-100h-300v100z" />
+    <glyph glyph-name="88" unicode="&#xe088;" 
+d="M50 700c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM200 700h600v-100h-600v100zM50 500c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM200 500h600v-100h-600v100zM50 300c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50
+s22 50 50 50zM200 300h600v-100h-600v100zM50 100c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM200 100h600v-100h-600v100z" />
+    <glyph glyph-name="89" unicode="&#xe089;" 
+d="M800 800l-400 -800l-100 300l-300 100z" />
+    <glyph glyph-name="8a" unicode="&#xe08a;" horiz-adv-x="600" 
+d="M300 700c110 0 200 -90 200 -200v-100h100v-400h-600v400h100v100c0 110 90 200 200 200zM300 600c-56 0 -100 -44 -100 -100v-100h200v100c0 56 -44 100 -100 100z" />
+    <glyph glyph-name="8b" unicode="&#xe08b;" horiz-adv-x="600" 
+d="M300 800c110 0 200 -90 200 -200v-200h100v-400h-600v400h400v200c0 56 -44 100 -100 100s-100 -44 -100 -100h-100c0 110 90 200 200 200z" />
+    <glyph glyph-name="8c" unicode="&#xe08c;" 
+d="M400 700v-100c-111 0 -200 -89 -200 -200h100l-150 -200l-150 200h100c0 165 135 300 300 300zM650 600l150 -200h-100c0 -165 -135 -300 -300 -300v100c111 0 200 89 200 200h-100z" />
+    <glyph glyph-name="8d" unicode="&#xe08d;" 
+d="M100 800h600v-300h100l-150 -250l-150 250h100v200h-400v-100h-100v200zM150 550l150 -250h-100v-200h400v100h100v-200h-600v300h-100z" />
+    <glyph glyph-name="8e" unicode="&#xe08e;" 
+d="M600 700l200 -150l-200 -150v100h-500v-100h-100v100c0 55 45 100 100 100h500v100zM200 300v-100h500v100h100v-100c0 -55 -45 -100 -100 -100h-500v-100l-200 150z" />
+    <glyph glyph-name="8f" unicode="&#xe08f;" horiz-adv-x="900" 
+d="M350 800c193 0 350 -157 350 -350c0 -60 -17 -117 -44 -166c5 -3 12 -8 16 -12l100 -100c16 -16 30 -49 30 -72c0 -56 -46 -102 -102 -102c-23 0 -56 14 -72 30l-100 100c-4 3 -9 9 -12 13c-49 -26 -107 -41 -166 -41c-193 0 -350 157 -350 350s157 350 350 350zM350 200
+c142 0 250 108 250 250c0 139 -111 250 -250 250s-250 -111 -250 -250s111 -250 250 -250z" />
+    <glyph glyph-name="90" unicode="&#xe090;" horiz-adv-x="600" 
+d="M300 800c166 0 300 -134 300 -300c0 -200 -300 -500 -300 -500s-300 300 -300 500c0 166 134 300 300 300zM300 700c-110 0 -200 -90 -200 -200s90 -200 200 -200s200 90 200 200s-90 200 -200 200z" />
+    <glyph glyph-name="91" unicode="&#xe091;" horiz-adv-x="900" 
+d="M0 800h800v-541c1 -3 1 -8 1 -11s0 -7 -1 -10v-238h-800v800zM495 250c0 26 22 50 50 50h5h150v400h-600v-600h600v100h-150h-5c-28 0 -50 22 -50 50zM350 600c83 0 150 -67 150 -150c0 -100 -150 -250 -150 -250s-150 150 -150 250c0 83 67 150 150 150zM350 500
+c-28 0 -50 -22 -50 -50s22 -50 50 -50s50 22 50 50s-22 50 -50 50z" />
+    <glyph glyph-name="92" unicode="&#xe092;" horiz-adv-x="600" 
+d="M0 700h200v-600h-200v600zM400 700h200v-600h-200v600z" />
+    <glyph glyph-name="93" unicode="&#xe093;" horiz-adv-x="600" 
+d="M0 700l600 -300l-600 -300v600z" />
+    <glyph glyph-name="94" unicode="&#xe094;" horiz-adv-x="600" 
+d="M300 700c166 0 300 -134 300 -300s-134 -300 -300 -300s-300 134 -300 300s134 300 300 300z" />
+    <glyph glyph-name="95" unicode="&#xe095;" 
+d="M400 700v-600l-400 300zM400 400l400 300v-600z" />
+    <glyph glyph-name="96" unicode="&#xe096;" 
+d="M0 700l400 -300l-400 -300v600zM400 100v600l400 -300z" />
+    <glyph glyph-name="97" unicode="&#xe097;" 
+d="M0 700h200v-600h-200v600zM200 400l500 300v-600z" />
+    <glyph glyph-name="98" unicode="&#xe098;" 
+d="M0 700l500 -300l-500 -300v600zM500 100v600h200v-600h-200z" />
+    <glyph glyph-name="99" unicode="&#xe099;" horiz-adv-x="600" 
+d="M0 700h600v-600h-600v600z" />
+    <glyph glyph-name="9a" unicode="&#xe09a;" 
+d="M200 800h400v-200h200v-400h-200v-200h-400v200h-200v400h200v200z" />
+    <glyph glyph-name="9b" unicode="&#xe09b;" 
+d="M0 700h800v-100h-800v100zM0 403h800v-100h-800v100zM0 103h800v-100h-800v100z" />
+    <glyph glyph-name="9c" unicode="&#xe09c;" horiz-adv-x="600" 
+d="M278 700c7 2 13 4 22 4c55 0 100 -45 100 -100v-4v-200c0 -55 -45 -100 -100 -100s-100 45 -100 100v200v2c0 44 35 88 78 98zM34 500h4h3c3 0 6 1 9 1c28 0 50 -22 50 -50v-1v-50c0 -111 89 -200 200 -200s200 89 200 200v50c0 28 22 50 50 50s50 -22 50 -50v-50
+c0 -148 -109 -270 -250 -294v-106h50c55 0 100 -45 100 -100h-400c0 55 45 100 100 100h50v106c-141 24 -250 146 -250 294v50v2c0 20 15 42 34 48z" />
+    <glyph glyph-name="9d" unicode="&#xe09d;" 
+d="M0 500h800v-200h-800v200z" />
+    <glyph glyph-name="9e" unicode="&#xe09e;" 
+d="M34 700h4h3h4h5h700c28 0 50 -22 50 -50v-500c0 -28 -22 -50 -50 -50h-250v-100h100c55 0 100 -45 100 -100h-600c0 55 45 100 100 100h100v100h-250c-28 0 -50 22 -50 50v500v2c0 20 15 42 34 48zM100 600v-400h600v400h-600z" />
+    <glyph glyph-name="9f" unicode="&#xe09f;" 
+d="M272 700c-14 -40 -22 -83 -22 -128c0 -221 179 -400 400 -400c45 0 88 8 128 22c-53 -158 -202 -272 -378 -272c-221 0 -400 179 -400 400c0 176 114 325 272 378z" />
+    <glyph glyph-name="a0" unicode="&#xe0a0;" 
+d="M350 700l150 -150h-100v-150h150v100l150 -150l-150 -150v100h-150v-150h100l-150 -150l-150 150h100v150h-150v-100l-150 150l150 150v-100h150v150h-100z" />
+    <glyph glyph-name="a1" unicode="&#xe0a1;" 
+d="M800 800v-550c0 -83 -67 -150 -150 -150s-150 67 -150 150s67 150 150 150c17 0 35 -4 50 -9v206c-201 -6 -327 -27 -400 -50v-397c0 -83 -67 -150 -150 -150s-150 67 -150 150s67 150 150 150c17 0 35 -4 50 -9v409s100 100 600 100z" />
+    <glyph glyph-name="a2" unicode="&#xe0a2;" horiz-adv-x="700" 
+d="M499 700c51 0 102 -20 141 -59c78 -78 78 -203 0 -281l-250 -244c-48 -48 -127 -48 -175 0s-48 127 0 175l96 97l69 -69l-90 -94l-7 -3c-10 -10 -10 -28 0 -38s28 -10 38 0l250 247c37 40 39 102 0 141s-104 40 -144 0l-278 -275c-66 -69 -68 -179 0 -247
+c69 -69 181 -69 250 0l9 12l116 113l69 -69l-125 -125c-107 -107 -281 -107 -388 0s-107 281 0 388l278 272c39 39 90 59 141 59z" />
+    <glyph glyph-name="a3" unicode="&#xe0a3;" 
+d="M600 800l200 -200l-100 -100l-200 200zM400 600l200 -200l-400 -400h-200v200z" />
+    <glyph glyph-name="a4" unicode="&#xe0a4;" 
+d="M550 800c83 0 150 -90 150 -200s-67 -200 -150 -200c-22 0 -40 8 -59 19c6 26 9 52 9 81c0 84 -27 158 -72 212c27 52 71 88 122 88zM250 700c83 0 150 -90 150 -200s-67 -200 -150 -200s-150 90 -150 200s67 200 150 200zM725 384c44 -22 75 -66 75 -118v-166h-200v66
+c0 50 -17 96 -44 134c66 2 126 33 169 84zM75 284c45 -53 106 -84 175 -84s130 31 175 84c44 -22 75 -66 75 -118v-166h-500v166c0 52 31 96 75 118z" />
+    <glyph glyph-name="a5" unicode="&#xe0a5;" 
+d="M400 800c110 0 200 -112 200 -250s-90 -250 -200 -250s-200 112 -200 250s90 250 200 250zM191 300c54 -61 128 -100 209 -100s155 39 209 100c106 -5 191 -92 191 -200v-100h-800v100c0 108 85 195 191 200z" />
+    <glyph glyph-name="a6" unicode="&#xe0a6;" horiz-adv-x="600" 
+d="M19 800h462c11 0 19 -8 19 -19v-762c0 -11 -8 -19 -19 -19h-462c-11 0 -19 8 -19 19v762c0 11 8 19 19 19zM100 700v-500h300v500h-300zM250 150c-28 0 -50 -22 -50 -50s22 -50 50 -50s50 22 50 50s-22 50 -50 50z" />
+    <glyph glyph-name="a7" unicode="&#xe0a7;" 
+d="M350 800c17 0 34 -1 50 -3v-397l-297 297c63 64 150 103 247 103zM500 694c169 -25 300 -168 300 -344c0 -193 -157 -350 -350 -350c-85 0 -161 31 -222 81l272 272v341zM91 562l237 -234l-212 -212c-70 55 -116 138 -116 234c0 84 35 158 91 212z" />
+    <glyph glyph-name="a8" unicode="&#xe0a8;" 
+d="M92 650c0 23 20 50 46 50h3h4h5h400c28 0 50 -22 50 -50s-22 -50 -50 -50h-50v-200h100c55 0 100 -45 100 -100h-300v-300l-56 -100l-44 100v300h-300c0 55 45 100 100 100h100v200h-50c-2 0 -6 -1 -8 -1c-28 0 -50 23 -50 51z" />
+    <glyph glyph-name="a9" unicode="&#xe0a9;" 
+d="M400 800c221 0 400 -179 400 -400s-179 -400 -400 -400s-400 179 -400 400s179 400 400 400zM300 600v-400l300 200z" />
+    <glyph glyph-name="aa" unicode="&#xe0aa;" 
+d="M300 800h200v-300h300v-200h-300v-300h-200v300h-300v200h300v300z" />
+    <glyph glyph-name="ab" unicode="&#xe0ab;" 
+d="M300 800h100v-400h-100v400zM172 656l62 -78l-40 -31c-58 -46 -94 -117 -94 -197c0 -139 111 -250 250 -250s250 111 250 250c0 80 -39 151 -97 197l-37 31l62 78l38 -31c82 -64 134 -164 134 -275c0 -193 -157 -350 -350 -350s-350 157 -350 350c0 111 53 211 134 275z
+" />
+    <glyph glyph-name="ac" unicode="&#xe0ac;" 
+d="M200 800h400v-200h-400v200zM9 500h782c6 0 9 -3 9 -9v-282c0 -6 -3 -9 -9 -9h-91v200h-600v-200h-91c-6 0 -9 3 -9 9v282c0 6 3 9 9 9zM200 300h400v-300h-400v300z" />
+    <glyph glyph-name="ad" unicode="&#xe0ad;" 
+d="M0 700h100v-700h-100v700zM700 700h100v-700h-100v700zM200 600h200v-100h-200v100zM300 400h200v-100h-200v100zM400 200h200v-100h-200v100z" />
+    <glyph glyph-name="ae" unicode="&#xe0ae;" 
+d="M325 700c42 -141 87 -280 131 -419c29 74 59 148 88 222c30 -57 58 -114 87 -172h169v-100h-231l-13 28c-37 -92 -74 -184 -112 -275c-38 129 -79 257 -119 385c-42 -133 -83 -267 -125 -400c-28 88 -56 175 -84 262h-116v100h188l9 -34l3 -6c42 137 83 273 125 409z" />
+    <glyph glyph-name="af" unicode="&#xe0af;" 
+d="M200 600c0 57 43 100 100 100s100 -43 100 -100c0 -28 -18 -48 -28 -72c-3 -6 -3 -16 -3 -28h231v-231c12 0 22 0 28 3c24 10 44 28 72 28c57 0 100 -43 100 -100s-43 -100 -100 -100c-28 0 -48 18 -72 28c-6 3 -16 3 -28 3v-231h-231c0 12 0 22 3 28c10 24 28 44 28 72
+c0 57 -43 100 -100 100s-100 -43 -100 -100c0 -28 18 -48 28 -72c3 -6 3 -16 3 -28h-231v600h231c0 12 0 22 -3 28c-10 24 -28 44 -28 72z" />
+    <glyph glyph-name="b0" unicode="&#xe0b0;" horiz-adv-x="500" 
+d="M247 700c84 0 148 -20 191 -59s59 -93 59 -141c0 -117 -69 -181 -119 -225s-81 -67 -81 -150v-25h-100v25c0 117 65 181 115 225s85 67 85 150c0 25 -8 48 -28 66s-56 34 -122 34s-97 -18 -116 -37s-27 -43 -31 -69l-100 12c5 38 19 88 59 128s103 66 188 66zM197 0h100
+v-100h-100v100z" />
+    <glyph glyph-name="b1" unicode="&#xe0b1;" 
+d="M450 800c138 0 250 -112 250 -250v-50c58 -21 100 -85 100 -150c0 -69 -48 -127 -112 -144c-22 55 -75 94 -138 94c-20 0 -39 -5 -56 -12c-17 64 -75 112 -144 112s-127 -48 -144 -112c-17 7 -36 12 -56 12c-37 0 -71 -12 -97 -34c-33 36 -53 82 -53 134
+c0 110 90 200 200 200c23 114 129 200 250 200zM334 300h4h3c3 0 6 1 9 1c28 0 50 -22 50 -50v-1v-200c0 -28 -22 -50 -50 -50s-50 22 -50 50v200v2c0 20 15 42 34 48zM134 200h4h3c3 0 6 1 9 1c28 0 50 -22 50 -50v-1v-100c0 -28 -22 -50 -50 -50s-50 22 -50 50v100v2
+c0 20 15 42 34 48zM534 200h3h4c3 0 6 1 9 1c28 0 50 -22 50 -50v-1v-100c0 -28 -22 -50 -50 -50s-50 22 -50 50v100v2c0 20 15 42 34 48z" />
+    <glyph glyph-name="b2" unicode="&#xe0b2;" 
+d="M600 800l200 -150l-200 -150v100h-50l-153 -191l175 -206l6 -3h22v100l200 -150l-200 -150v100h-25c-35 0 -56 12 -78 38l-166 190l-153 -190c-22 -27 -43 -38 -78 -38h-100v100h100l166 206l-163 191l-3 3h-100v100h100c34 0 56 -12 78 -38l153 -178l141 178
+c22 27 43 38 78 38h50v100z" />
+    <glyph glyph-name="b3" unicode="&#xe0b3;" 
+d="M400 800c110 0 209 -47 281 -119l119 119v-300h-300l109 109c-54 55 -126 91 -209 91c-166 0 -300 -134 -300 -300s134 -300 300 -300c83 0 158 34 212 88l72 -72c-72 -72 -174 -116 -284 -116c-220 0 -400 180 -400 400s180 400 400 400z" />
+    <glyph glyph-name="b4" unicode="&#xe0b4;" 
+d="M400 800h400v-400l-166 166l-400 -400l166 -166h-400v400l166 -166l400 400z" />
+    <glyph glyph-name="b5" unicode="&#xe0b5;" horiz-adv-x="600" 
+d="M250 800l250 -300h-200v-200h200l-250 -300l-250 300h200v200h-200z" />
+    <glyph glyph-name="b6" unicode="&#xe0b6;" 
+d="M300 600v-200h200v200l300 -250l-300 -250v200h-200v-200l-300 250z" />
+    <glyph glyph-name="b7" unicode="&#xe0b7;" 
+d="M0 800c441 0 800 -359 800 -800h-200c0 333 -267 600 -600 600v200zM0 500c275 0 500 -225 500 -500h-200c0 167 -133 300 -300 300v200zM0 200c110 0 200 -90 200 -200h-200v200z" />
+    <glyph glyph-name="b8" unicode="&#xe0b8;" 
+d="M100 800c386 0 700 -314 700 -700h-100c0 332 -268 600 -600 600v100zM100 600c276 0 500 -224 500 -500h-100c0 222 -178 400 -400 400v100zM100 400c165 0 300 -135 300 -300h-100c0 111 -89 200 -200 200v100zM100 200c55 0 100 -45 100 -100s-45 -100 -100 -100
+s-100 45 -100 100s45 100 100 100z" />
+    <glyph glyph-name="b9" unicode="&#xe0b9;" 
+d="M300 800h400c55 0 100 -45 100 -100v-200h-400v150c0 28 -22 50 -50 50s-50 -22 -50 -50v-250h400v-300c0 -55 -45 -100 -100 -100h-500c-55 0 -100 45 -100 100v200h100v-150c0 -28 22 -50 50 -50s50 22 50 50v550c0 55 45 100 100 100z" />
+    <glyph glyph-name="ba" unicode="&#xe0ba;" 
+d="M75 700h225v-100h-200v-500h400v100h100v-125c0 -41 -34 -75 -75 -75h-450c-41 0 -75 34 -75 75v550c0 41 34 75 75 75zM600 700l200 -200l-200 -200v100h-200c-94 0 -173 -65 -194 -153c23 199 189 353 394 353v100z" />
+    <glyph glyph-name="bb" unicode="&#xe0bb;" 
+d="M500 700l300 -284l-300 -316v200h-100c-200 0 -348 -102 -400 -300c0 295 100 500 500 500v200z" />
+    <glyph glyph-name="bc" unicode="&#xe0bc;" 
+d="M381 791l19 9l19 -9c127 -53 253 -108 381 -160v-31c0 -166 -67 -313 -147 -419c-40 -53 -83 -97 -125 -128s-82 -53 -128 -53s-86 22 -128 53s-85 75 -125 128c-80 107 -147 253 -147 419v31c128 52 254 107 381 160zM400 100v591l-294 -122c8 -126 58 -243 122 -328
+c35 -46 73 -86 106 -110s62 -31 66 -31z" />
+    <glyph glyph-name="bd" unicode="&#xe0bd;" 
+d="M600 800h100v-800h-100v800zM400 700h100v-700h-100v700zM200 500h100v-500h-100v500zM0 300h100v-300h-100v300z" />
+    <glyph glyph-name="be" unicode="&#xe0be;" 
+d="M300 800h100v-200h200l100 -100l-100 -100h-200v-400h-100v500h-200l-100 100l100 100h200v100z" />
+    <glyph glyph-name="bf" unicode="&#xe0bf;" 
+d="M200 800h100v-600h200l-250 -200l-250 200h200v600zM400 800h200v-100h-200v100zM400 600h300v-100h-300v100zM400 400h400v-100h-400v100z" />
+    <glyph glyph-name="c0" unicode="&#xe0c0;" 
+d="M200 800h100v-600h200l-250 -200l-250 200h200v600zM400 800h400v-100h-400v100zM400 600h300v-100h-300v100zM400 400h200v-100h-200v100z" />
+    <glyph glyph-name="c1" unicode="&#xe0c1;" 
+d="M75 700h650c41 0 75 -34 75 -75v-550c0 -41 -34 -75 -75 -75h-650c-41 0 -75 34 -75 75v550c0 41 34 75 75 75zM100 600v-100h100v100h-100zM300 600v-100h400v100h-400zM100 400v-100h100v100h-100zM300 400v-100h400v100h-400zM100 200v-100h100v100h-100zM300 200
+v-100h400v100h-400z" />
+    <glyph glyph-name="c2" unicode="&#xe0c2;" 
+d="M400 800l100 -300h300l-250 -200l100 -300l-250 200l-250 -200l100 300l-250 200h300z" />
+    <glyph glyph-name="c3" unicode="&#xe0c3;" 
+d="M400 800c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM150 700c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM650 700c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM400 600c110 0 200 -90 200 -200
+s-90 -200 -200 -200s-200 90 -200 200s90 200 200 200zM50 450c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM750 450c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM150 200c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50
+s22 50 50 50zM650 200c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50zM400 100c28 0 50 -22 50 -50s-22 -50 -50 -50s-50 22 -50 50s22 50 50 50z" />
+    <glyph glyph-name="c4" unicode="&#xe0c4;" 
+d="M34 800h632c18 0 34 -16 34 -34v-732c0 -18 -16 -34 -34 -34h-632c-18 0 -34 16 -34 34v732c0 18 16 34 34 34zM100 700v-500h500v500h-500zM350 150c-38 0 -63 -42 -44 -75s69 -33 88 0s-6 75 -44 75z" />
+    <glyph glyph-name="c5" unicode="&#xe0c5;" 
+d="M0 800h300l500 -500l-300 -300l-500 500v300zM200 700c-55 0 -100 -45 -100 -100s45 -100 100 -100s100 45 100 100s-45 100 -100 100z" />
+    <glyph glyph-name="c6" unicode="&#xe0c6;" 
+d="M0 600h200l300 -300l-200 -200l-300 300v200zM340 600h160l300 -300l-200 -200l-78 78l119 122zM150 500c-28 0 -50 -22 -50 -50s22 -50 50 -50s50 22 50 50s-22 50 -50 50z" />
+    <glyph glyph-name="c7" unicode="&#xe0c7;" 
+d="M400 800c220 0 400 -180 400 -400s-180 -400 -400 -400s-400 180 -400 400s180 400 400 400zM400 700c-166 0 -300 -134 -300 -300s134 -300 300 -300s300 134 300 300s-134 300 -300 300zM400 600c110 0 200 -90 200 -200s-90 -200 -200 -200s-200 90 -200 200
+s90 200 200 200zM400 500c-56 0 -100 -44 -100 -100s44 -100 100 -100s100 44 100 100s-44 100 -100 100z" />
+    <glyph glyph-name="c8" unicode="&#xe0c8;" 
+d="M0 700h559l-100 -100h-359v-500h500v159l100 100v-359h-700v700zM700 700l100 -100l-400 -400l-200 200l100 100l100 -100z" />
+    <glyph glyph-name="c9" unicode="&#xe0c9;" 
+d="M9 800h782c6 0 9 -3 9 -9v-782c0 -6 -3 -9 -9 -9h-782c-6 0 -9 3 -9 9v782c0 6 3 9 9 9zM150 722l-72 -72l100 -100l-100 -100l72 -72l172 172zM400 500v-100h300v100h-300z" />
+    <glyph glyph-name="ca" unicode="&#xe0ca;" 
+d="M0 800h800v-200h-50c0 55 -45 100 -100 100h-150v-550c0 -28 22 -50 50 -50h50v-100h-400v100h50c28 0 50 22 50 50v550h-150c-55 0 -100 -45 -100 -100h-50v200z" />
+    <glyph glyph-name="cb" unicode="&#xe0cb;" 
+d="M0 700h100v-400h-100v400zM200 700h350c21 0 39 -13 47 -31c0 0 103 -291 103 -319s-22 -50 -50 -50h-150c-28 0 -50 -25 -50 -50s39 -158 47 -184s-5 -55 -31 -63s-52 5 -66 31s-109 219 -128 238s-44 28 -72 28v400z" />
+    <glyph glyph-name="cc" unicode="&#xe0cc;" 
+d="M400 666c10 19 28 32 47 34l19 -3c26 -8 39 -37 31 -63s-47 -159 -47 -184s22 -50 50 -50h150c28 0 50 -22 50 -50s-103 -319 -103 -319c-8 -18 -26 -31 -47 -31h-350v400c28 0 53 9 72 28s114 212 128 238zM0 400h100v-400h-100v400z" />
+    <glyph glyph-name="cd" unicode="&#xe0cd;" 
+d="M200 700h300v-100h-100v-6c25 -4 50 -8 72 -16l-34 -94c-28 11 -58 16 -88 16c-139 0 -250 -111 -250 -250s111 -250 250 -250s250 111 250 250c0 31 -5 60 -16 88l91 37c14 -38 25 -81 25 -125c0 -193 -157 -350 -350 -350s-350 157 -350 350c0 176 130 323 300 347v3
+h-100v100zM700 584c0 0 -296 -348 -316 -368s-48 -20 -68 0s-20 48 0 68s384 300 384 300z" />
+    <glyph glyph-name="ce" unicode="&#xe0ce;" 
+d="M600 700l200 -150l-200 -150v100h-600v100h600v100zM200 300v-100h600v-100h-600v-100l-200 150z" />
+    <glyph glyph-name="cf" unicode="&#xe0cf;" 
+d="M300 800h100c55 0 100 -45 100 -100h100c55 0 100 -45 100 -100h-700c0 55 45 100 100 100h100c0 55 45 100 100 100zM100 500h100v-350c0 -28 22 -50 50 -50s50 22 50 50v350h100v-350c0 -28 22 -50 50 -50s50 22 50 50v350h100v-481c0 -11 -8 -19 -19 -19h-462
+c-11 0 -19 8 -19 19v481z" />
+    <glyph glyph-name="d0" unicode="&#xe0d0;" 
+d="M100 800h200v-400c0 -55 45 -100 100 -100s100 45 100 100v400h100v-400c0 -110 -90 -200 -200 -200h-50c-138 0 -250 90 -250 200v400zM0 100h700v-100h-700v100z" />
+    <glyph glyph-name="d1" unicode="&#xe0d1;" 
+d="M9 700h182c6 0 9 -3 9 -9v-482c0 -6 -3 -9 -9 -9h-182c-6 0 -9 3 -9 9v482c0 6 3 9 9 9zM609 700h182c6 0 9 -3 9 -9v-482c0 -6 -3 -9 -9 -9h-182c-6 0 -9 3 -9 9v482c0 6 3 9 9 9zM309 500h182c6 0 9 -3 9 -9v-282c0 -6 -3 -9 -9 -9h-182c-6 0 -9 3 -9 9v282
+c0 6 3 9 9 9zM0 100h800v-100h-800v100z" />
+    <glyph glyph-name="d2" unicode="&#xe0d2;" 
+d="M10 700h181c6 0 9 -3 9 -9v-191h-200v191c0 6 4 9 10 9zM610 700h181c6 0 9 -3 9 -9v-191h-200v191c0 6 5 9 10 9zM310 600h181c6 0 9 -3 9 -9v-91h-200v91c0 6 4 9 10 9zM0 400h800v-100h-800v100zM0 200h200v-191c0 -6 -3 -9 -9 -9h-182c-6 0 -9 3 -9 9v191zM300 200
+h200v-91c0 -6 -3 -9 -9 -9h-181c-6 0 -10 3 -10 9v91zM600 200h200v-191c0 -6 -3 -9 -9 -9h-181c-6 0 -10 3 -10 9v191z" />
+    <glyph glyph-name="d3" unicode="&#xe0d3;" 
+d="M0 700h800v-100h-800v100zM9 500h182c6 0 9 -3 9 -9v-482c0 -6 -3 -9 -9 -9h-182c-6 0 -9 3 -9 9v482c0 6 3 9 9 9zM309 500h182c6 0 9 -3 9 -9v-282c0 -6 -3 -9 -9 -9h-182c-6 0 -9 3 -9 9v282c0 6 3 9 9 9zM609 500h182c6 0 9 -3 9 -9v-482c0 -6 -3 -9 -9 -9h-182
+c-6 0 -9 3 -9 9v482c0 6 3 9 9 9z" />
+    <glyph glyph-name="d4" unicode="&#xe0d4;" 
+d="M50 600h500c28 0 50 -22 50 -50v-150l100 100h100v-300h-100l-100 100v-150c0 -28 -22 -50 -50 -50h-500c-28 0 -50 22 -50 50v400c0 28 22 50 50 50z" />
+    <glyph glyph-name="d5" unicode="&#xe0d5;" 
+d="M334 800h66v-800h-66l-134 200h-200v400h200zM500 600v100c26 0 52 -4 75 -10c130 -33 225 -150 225 -290s-95 -258 -225 -291h-3c-23 -6 -47 -9 -72 -9v100c17 0 34 2 50 6c86 22 150 100 150 194s-64 172 -150 194c-16 4 -33 6 -50 6zM500 500l25 -3
+c44 -11 75 -51 75 -97s-32 -86 -75 -97l-25 -3v200z" />
+    <glyph glyph-name="d6" unicode="&#xe0d6;" horiz-adv-x="600" 
+d="M334 800h66v-800h-66l-134 200h-200v400h200zM500 500l25 -3c44 -11 75 -51 75 -97s-32 -86 -75 -97l-25 -3v200z" />
+    <glyph glyph-name="d7" unicode="&#xe0d7;" horiz-adv-x="400" 
+d="M334 800h66v-800h-66l-134 200h-200v400h200z" />
+    <glyph glyph-name="d8" unicode="&#xe0d8;" 
+d="M309 800h82c6 0 10 -4 12 -9l294 -682l3 -19v-81c0 -6 -3 -9 -9 -9h-682c-6 0 -9 3 -9 9v81l3 19l294 682c2 5 6 9 12 9zM300 500v-200h100v200h-100zM300 200v-100h100v100h-100z" />
+    <glyph glyph-name="d9" unicode="&#xe0d9;" 
+d="M375 800c138 0 269 -39 378 -109l-53 -82c-93 60 -205 91 -325 91c-119 0 -229 -32 -322 -91l-53 82c109 70 237 109 375 109zM375 500c78 0 154 -23 216 -62l-53 -85c-46 30 -104 47 -163 47c-60 0 -112 -17 -159 -47l-54 85c62 40 134 62 213 62zM375 200
+c55 0 100 -45 100 -100s-45 -100 -100 -100s-100 45 -100 100s45 100 100 100z" />
+    <glyph glyph-name="da" unicode="&#xe0da;" horiz-adv-x="900" 
+d="M551 800c16 0 32 0 47 -3l-97 -97v-200h200l97 97c3 -15 3 -31 3 -47c0 -138 -112 -250 -250 -250c-32 0 -62 8 -90 19l-288 -291c-20 -20 -46 -28 -72 -28s-52 8 -72 28c-39 39 -39 105 0 144l291 287c-11 28 -19 59 -19 91c0 138 112 250 250 250zM101 150
+c-28 0 -50 -22 -50 -50s22 -50 50 -50s50 22 50 50s-22 50 -50 50z" />
+    <glyph glyph-name="db" unicode="&#xe0db;" 
+d="M141 700c84 -84 169 -167 253 -250c82 83 167 165 247 250l143 -141l-253 -253c84 -82 167 -166 253 -247l-143 -143c-81 86 -165 169 -247 253l-253 -253l-141 143c85 80 167 164 250 247c-83 84 -166 169 -250 253z" />
+    <glyph glyph-name="dc" unicode="&#xe0dc;" 
+d="M0 800h100l231 -300h38l231 300h100l-225 -300h225v-100h-300v-100h300v-100h-300v-200h-100v200h-300v100h300v100h-300v100h225z" />
+    <glyph glyph-name="dd" unicode="&#xe0dd;" horiz-adv-x="900" 
+d="M350 800c193 0 350 -157 350 -350c0 -61 -17 -119 -44 -169c4 -2 10 -6 13 -9l103 -100c16 -16 30 -49 30 -72c0 -56 -46 -102 -102 -102c-23 0 -56 14 -72 30l-100 103c-3 3 -7 9 -9 13c-50 -28 -108 -44 -169 -44c-193 0 -350 157 -350 350s157 350 350 350zM350 700
+c-139 0 -250 -111 -250 -250s111 -250 250 -250c62 0 119 23 163 60c7 11 19 25 31 31l3 3c34 43 53 97 53 156c0 139 -111 250 -250 250zM300 600h100v-100h100v-100h-100v-100h-100v100h-100v100h100v100z" />
+    <glyph glyph-name="de" unicode="&#xe0de;" horiz-adv-x="900" 
+d="M350 800c193 0 350 -157 350 -350c0 -61 -17 -119 -44 -169c4 -2 10 -6 13 -9l103 -100c16 -16 30 -49 30 -72c0 -56 -46 -102 -102 -102c-23 0 -56 14 -72 30l-100 103c-3 3 -7 9 -9 13c-50 -28 -108 -44 -169 -44c-193 0 -350 157 -350 350s157 350 350 350zM350 700
+c-139 0 -250 -111 -250 -250s111 -250 250 -250c62 0 119 23 163 60c7 11 19 25 31 31l3 3c34 43 53 97 53 156c0 139 -111 250 -250 250zM200 500h300v-100h-300v100z" />
+  </font>
+</defs></svg>
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/font/fonts/open-iconic.ttf b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/font/fonts/open-iconic.ttf
new file mode 100644
index 0000000000..fab604866c
Binary files /dev/null and b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/font/fonts/open-iconic.ttf differ
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/font/fonts/open-iconic.woff b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/font/fonts/open-iconic.woff
new file mode 100644
index 0000000000..f9309988ae
Binary files /dev/null and b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/open-iconic/font/fonts/open-iconic.woff differ
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/site.css b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/site.css
new file mode 100644
index 0000000000..c7d16d057b
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/css/site.css
@@ -0,0 +1,68 @@
+@import url('open-iconic/font/css/open-iconic-bootstrap.min.css');
+
+html, body {
+    font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif;
+}
+
+    body::before {
+        content: "";
+        background-image: url(../images/m42hubble.jpg);
+        background-size: cover;
+        position: absolute;
+        top: 0px;
+        right: 0px;
+        bottom: 0px;
+        left: 0px;
+        opacity: 0.5;
+    }
+
+
+a, .btn-link {
+    color: #0366d6;
+}
+
+.btn-primary {
+    color: #fff;
+    background-color: #1b6ec2;
+    border-color: #1861ac;
+}
+
+.content {
+    padding-top: 1.1rem;
+    height: 100%;
+}
+
+.valid.modified:not([type=checkbox]) {
+    outline: 1px solid #26b050;
+}
+
+.invalid {
+    outline: 1px solid red;
+}
+
+.validation-message {
+    color: red;
+}
+
+#blazor-error-ui {
+    background: lightyellow;
+    bottom: 0;
+    box-shadow: 0 -1px 2px rgba(0, 0, 0, 0.2);
+    display: none;
+    left: 0;
+    padding: 0.6rem 1.25rem 0.7rem 1.25rem;
+    position: fixed;
+    width: 100%;
+    z-index: 1000;
+}
+
+    #blazor-error-ui .dismiss {
+        cursor: pointer;
+        position: absolute;
+        right: 0.75rem;
+        top: 0.5rem;
+    }
+
+    .row {
+        padding: 0.2em;
+    }
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/favicon.ico b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/favicon.ico
new file mode 100644
index 0000000000..63e859b476
Binary files /dev/null and b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/favicon.ico differ
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/images/m42hubble.jpg b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/images/m42hubble.jpg
new file mode 100644
index 0000000000..620672a024
Binary files /dev/null and b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/images/m42hubble.jpg differ
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/js/markdownExtensions.js b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/js/markdownExtensions.js
new file mode 100644
index 0000000000..338df02cde
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/js/markdownExtensions.js
@@ -0,0 +1,18 @@
+window.markdownExtensions = {
+    toHtml: (txt, target) => {
+        const area = document.createElement("textarea");
+        setTimeout(() => {
+            area.innerHTML = txt;
+            target.innerHTML = area.value;
+        }, 0);
+    },
+    setText: (id, txt, target) => {
+        target.value = txt;
+        target.oninput = () => window.markdownExtensions.getText(id, target);
+    },
+    getText: (id, target) => DotNet.invokeMethodAsync(
+        'PlanetaryDocs',
+        'UpdateTextAsync',
+        id,
+        target.value)
+};
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/js/titleService.js b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/js/titleService.js
new file mode 100644
index 0000000000..209a22cd50
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocs/wwwroot/js/titleService.js
@@ -0,0 +1,10 @@
+window.titleService = {
+    titleRef: null,
+    setTitle: (title) => {
+        var _self = window.titleService;
+        if (_self.titleRef == null) {
+            _self.titleRef = document.getElementsByTagName("title")[0];
+        }
+        setTimeout(() => _self.titleRef.innerText = title, 0);
+    }
+}
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocsLoader/CosmosLoader.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocsLoader/CosmosLoader.cs
new file mode 100644
index 0000000000..3d7e5eff8f
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocsLoader/CosmosLoader.cs
@@ -0,0 +1,359 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Runtime.CompilerServices;
+using System.Threading.Tasks;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.DependencyInjection;
+using PlanetaryDocs.DataAccess;
+using PlanetaryDocs.Domain;
+
+namespace PlanetaryDocsLoader
+{
+    /// <summary>
+    /// Saves the <see cref="Document"/> instances to Azure Cosmos DB.
+    /// </summary>
+    public static class CosmosLoader
+    {
+        /// <summary>
+        /// Loads documents to the database.
+        /// </summary>
+        /// <param name="docsList">The <see cref="Document"/> list.</param>
+        /// <param name="endPoint">The Azure Cosmos DB endpoint.</param>
+        /// <param name="accessKey">The Azure Cosmos DB access key.</param>
+        /// <returns>An asynchronous task.</returns>
+        public static async Task LoadDocumentsAsync(
+            IEnumerable<Document> docsList,
+            string endPoint,
+            string accessKey)
+        {
+            Console.Clear();
+            Console.WriteLine("Initializing database...");
+
+            string alias = string.Empty,
+                altAlias = string.Empty,
+                tag = string.Empty,
+                text = string.Empty,
+                uid = string.Empty;
+
+            var testOnly = docsList == null;
+
+            var sc = new ServiceCollection();
+            sc.AddDbContextFactory<DocsContext>(
+                options => options.UseCosmos(
+                    endPoint, accessKey, nameof(DocsContext)));
+            sc.AddSingleton<IDocumentService, DocumentService>();
+            var sp = sc.BuildServiceProvider().CreateScope().ServiceProvider;
+            var factory = sp.GetRequiredService<IDbContextFactory<DocsContext>>();
+            var service = sp.GetRequiredService<IDocumentService>();
+
+            using (var context = factory.CreateDbContext())
+            {
+                if (testOnly)
+                {
+                    docsList = await context.Documents.ToListAsync();
+                }
+                else
+                {
+                    await context.Database.EnsureDeletedAsync();
+                    await context.Database.EnsureCreatedAsync();
+                }
+            }
+
+            Console.WriteLine("Database created. Populating...");
+
+            var (left, right) = Console.GetCursorPosition();
+            var emptyLine = new string(' ', Console.BufferWidth - 1);
+            var current = 1;
+            var total = docsList.Count();
+            var progress = new ProgressBar(total);
+            foreach (var doc in docsList)
+            {
+                Console.SetCursorPosition(left, right);
+                Console.WriteLine(emptyLine);
+                Console.WriteLine(emptyLine);
+                Console.SetCursorPosition(left, right);
+                Console.WriteLine(progress.Advance());
+                Console.WriteLine($"{current++}/{total}:\tInsert {doc.Uid}");
+                if (!testOnly)
+                {
+                    await service.InsertDocumentAsync(doc);
+                }
+
+                if (doc.Tags.Count > 0 && string.IsNullOrWhiteSpace(alias))
+                {
+                    alias = doc.AuthorAlias;
+                    tag = doc.Tags[0];
+                    text = doc.Title;
+                    uid = doc.Uid;
+                }
+                else if (
+                    string.IsNullOrWhiteSpace(altAlias) &&
+                    doc.AuthorAlias != alias)
+                {
+                    altAlias = doc.AuthorAlias;
+                }
+            }
+
+            Console.WriteLine("The way has been prepared.");
+            Console.WriteLine("Running tests...");
+
+            await TestLoadDocumentAsync(service, uid);
+            await TestUpdateDocumentAsync(service, uid, alias, altAlias);
+            await TestSearchTagsAsync(service, tag);
+            await TestSearchAuthorsAsync(service, alias);
+            await TestQueryAsync(service, tag, alias, text);
+            var auditId = await TestDeleteDocumentAsync(service, uid);
+            await TestRestoreDocumentAsync(service, auditId, uid);
+
+            Console.WriteLine("All done!");
+        }
+
+        /// <summary>
+        /// Load a <see cref="Document"/>.
+        /// </summary>
+        /// <param name="service">The <see cref="IDocumentService"/>.</param>
+        /// <param name="uid">The unique identifier.</param>
+        /// <returns>An asynchronous task.</returns>
+        private static async Task TestLoadDocumentAsync(
+            IDocumentService service, string uid)
+        {
+            var start = TestStart();
+            var doc = await service.LoadDocumentAsync(uid);
+            Console.WriteLine("Loaded document:");
+            Console.WriteLine($"Title:\t{doc.Title}");
+            Console.WriteLine($"Description:\t{doc.Description}");
+            Console.Write("Tags:\t");
+            Console.WriteLine(string.Join(", ", doc.Tags));
+            TestEnd(start);
+        }
+
+        /// <summary>
+        /// Updates a <see cref="Document"/>.
+        /// </summary>
+        /// <param name="service">The <see cref="IDocumentService"/>.</param>
+        /// <param name="uid">The unique identifier.</param>
+        /// <param name="author">An author to update.</param>
+        /// <param name="altAuthor">An alternate author.</param>
+        /// <returns>An asyncronous task.</returns>
+        private static async Task TestUpdateDocumentAsync(
+            IDocumentService service,
+            string uid,
+            string author,
+            string altAuthor)
+        {
+            var start = TestStart();
+            var doc = await service.LoadDocumentAsync(uid);
+            Console.WriteLine($"Updating doc with author {doc.AuthorAlias}...");
+            var newAuthor = doc.AuthorAlias == author ?
+                altAuthor : author;
+            Console.WriteLine($"New author = {newAuthor}.");
+            var originalAuthor = doc.AuthorAlias;
+            var existsBeforeOriginal = (await service.QueryDocumentsAsync(
+                string.Empty,
+                originalAuthor,
+                string.Empty)).Any(d => d.Uid == doc.Uid);
+            var existsBeforeNew = (await service.QueryDocumentsAsync(
+                string.Empty,
+                newAuthor,
+                string.Empty)).Any(d => d.Uid == doc.Uid);
+            doc.AuthorAlias = newAuthor;
+            doc.Title = $"(new) {doc.Title}";
+            doc.Tags.RemoveAt(0);
+            await service.UpdateDocumentAsync(doc);
+            var updatedDoc = await service.LoadDocumentAsync(doc.Uid);
+            var existsAfterOriginal = (await service.QueryDocumentsAsync(
+                string.Empty,
+                originalAuthor,
+                string.Empty)).Any(d => d.Uid == doc.Uid);
+            var existsAfterNew = (await service.QueryDocumentsAsync(
+                string.Empty,
+                newAuthor,
+                string.Empty)).Any(d => d.Uid == doc.Uid);
+            Console.WriteLine("Updated document.");
+            Console.WriteLine($"Author after update: {updatedDoc.AuthorAlias}.");
+            Console.WriteLine($"{originalAuthor} before: {existsBeforeOriginal} after: {existsAfterOriginal}");
+            Console.WriteLine($"{newAuthor} before: {existsBeforeNew} after: {existsAfterNew}");
+            TestEnd(start);
+        }
+
+        /// <summary>
+        /// Search authors.
+        /// </summary>
+        /// <param name="service">The <see cref="IDocumentService"/>.</param>
+        /// <param name="alias">The alias to search.</param>
+        /// <returns>An asynchronous tsk.</returns>
+        private static async Task TestSearchAuthorsAsync(
+            IDocumentService service, string alias)
+        {
+            var start = TestStart();
+            Console.WriteLine("Testing author search...");
+            for (var x = 1; x < alias.Length - 1; x++)
+            {
+                var search = alias[..x];
+                var results = await service.SearchAuthorsAsync(search);
+                var resultText = string.Join(',', results);
+                Console.WriteLine($"{search}=>{resultText}");
+            }
+
+            TestEnd(start);
+        }
+
+        /// <summary>
+        /// Test tag search.
+        /// </summary>
+        /// <param name="service">The <see cref="IDocumentService"/>.</param>
+        /// <param name="tag">The tag search.</param>
+        /// <returns>An asynchronous task.</returns>
+        private static async Task TestSearchTagsAsync(
+            IDocumentService service, string tag)
+        {
+            var start = TestStart();
+            Console.WriteLine("Testing tag search...");
+            for (var x = 1; x < tag.Length - 1; x++)
+            {
+                var search = tag[..x];
+                var results = await service.SearchTagsAsync(search);
+                var resultText = string.Join(',', results);
+                Console.WriteLine($"{search}=>{resultText}");
+            }
+
+            TestEnd(start);
+        }
+
+        /// <summary>
+        /// Test document queries.
+        /// </summary>
+        /// <param name="service">The <see cref="IDocumentService"/>.</param>
+        /// <param name="tag">The tag to use.</param>
+        /// <param name="alias">The alias to use.</param>
+        /// <param name="text">The text to use.</param>
+        /// <returns>An asynchronous task.</returns>
+        private static async Task TestQueryAsync(
+            IDocumentService service,
+            string tag,
+            string alias,
+            string text)
+        {
+            var startTime = TestStart();
+            Console.WriteLine("Testing query...");
+
+            var textParts = text.Split(' ');
+            var start = new Random().Next(0, textParts.Length - 2);
+            var search = $"{textParts[start]} {textParts[start + 1]}";
+
+            Console.WriteLine($"Using tag={tag} alias={alias} text={search}");
+
+            foreach (var useTag in new[] { true, false })
+            {
+                foreach (var useAlias in new[] { true, false })
+                {
+                    foreach (var useText in new[] { true, false })
+                    {
+                        Console.WriteLine($"tag={useTag} alias={useAlias} text={useText}");
+                        var results = await service.QueryDocumentsAsync(
+                            useText ? search : string.Empty,
+                            useAlias ? alias : string.Empty,
+                            useTag ? tag : string.Empty);
+                        foreach (var item in results)
+                        {
+                            Console.WriteLine($"Found {item.Uid} by {item.AuthorAlias}: '{item.Title}'");
+                        }
+                    }
+                }
+            }
+
+            TestEnd(startTime);
+        }
+
+        /// <summary>
+        /// Test document delete.
+        /// </summary>
+        /// <param name="service">The <see cref="IDocumentService"/>.</param>
+        /// <param name="uid">The unique identifier.</param>
+        /// <returns>An audit identifier to restore later.</returns>
+        private static async Task<Guid> TestDeleteDocumentAsync(
+            IDocumentService service, string uid)
+        {
+            var start = TestStart();
+            var docToDelete = await service.LoadDocumentAsync(uid);
+            Console.WriteLine($"Document to delete: {uid}");
+            var audits = await service.LoadDocumentHistoryAsync(uid);
+            var history = audits.OrderByDescending(a => a.Timestamp)
+                .Select(a => a.Id)
+                .FirstOrDefault();
+            await service.DeleteDocumentAsync(uid);
+            var document = await service.LoadDocumentAsync(uid);
+            if (document == null)
+            {
+                Console.WriteLine("SUCCESS! Checking dependencies.");
+                var authorDocs = await service.QueryDocumentsAsync(
+                    string.Empty,
+                    docToDelete.AuthorAlias,
+                    string.Empty);
+                Console.WriteLine($"Author '{docToDelete.AuthorAlias}' has {authorDocs.Count} docs.");
+                var docExists = authorDocs.Any(ds => ds.Uid == uid);
+                Console.WriteLine($"Author has document in summary: {docExists}");
+                foreach (var tag in docToDelete.Tags)
+                {
+                    var tagDocs = await service.QueryDocumentsAsync(
+                        string.Empty,
+                        string.Empty,
+                        tag);
+                    Console.WriteLine($"Tag '{tag}' has {tagDocs.Count} docs.");
+                    docExists = tagDocs.Any(ds => ds.Uid == uid);
+                    Console.WriteLine($"Tag has document in summary: {docExists}");
+                }
+            }
+            else
+            {
+                Console.WriteLine("I've done something wrong. Back to the labs!");
+            }
+
+            TestEnd(start);
+            return history;
+        }
+
+        /// <summary>
+        /// Test restoration of the document.
+        /// </summary>
+        /// <param name="service">The <see cref="IDocumentService"/>.</param>
+        /// <param name="auditId">The id of the <see cref="DocumentAudit"/>.</param>
+        /// <param name="uid">The unique identifier of the <see cref="Document"/>.</param>
+        /// <returns>An asynchronous task.</returns>
+        private static async Task TestRestoreDocumentAsync(
+            IDocumentService service,
+            Guid auditId,
+            string uid)
+        {
+            var start = TestStart();
+            var doc = await service.LoadDocumentAsync(uid);
+            Console.WriteLine($"Doc '{uid}' exists = {doc != null}");
+            var restoredDoc = await service.RestoreDocumentAsync(auditId, uid);
+            Console.WriteLine($"Doc '{uid}' restored = {restoredDoc != null}");
+            TestEnd(start);
+        }
+
+        /// <summary>
+        /// Mark test start.
+        /// </summary>
+        /// <param name="test">The test.</param>
+        private static long TestStart([CallerMemberName] string test = null)
+        {
+            Console.WriteLine($"{Environment.NewLine}*** Starting Test '{test}'***");
+            return DateTime.UtcNow.Ticks;
+        }
+
+        /// <summary>
+        /// Mark test end.
+        /// </summary>
+        /// <param name="start">The start time.</param>
+        /// <param name="test">The test.</param>
+        private static void TestEnd(long start, [CallerMemberName] string test = null)
+        {
+            var time = TimeSpan.FromTicks(DateTime.UtcNow.Ticks - start);
+            Console.WriteLine($"==== Test time: {time}");
+            Console.WriteLine($"*** Ended Test '{test}'");
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocsLoader/FileSystemParser.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocsLoader/FileSystemParser.cs
new file mode 100644
index 0000000000..d2251aa5ca
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocsLoader/FileSystemParser.cs
@@ -0,0 +1,60 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+
+namespace PlanetaryDocsLoader
+{
+    /// <summary>
+    /// Handles recursing the docs repo and parsing markdown files.
+    /// </summary>
+    public static class FileSystemParser
+    {
+        /// <summary>
+        /// Produces a list of files with the <c>.md</c> markdown extension.
+        /// </summary>
+        /// <param name="docsPath">The path to start.</param>
+        /// <remarks>
+        /// Verbose. Outputs ":" for top level directory, "#" for subdirectories
+        /// found, "!" for markdown files and "-" for skipped.
+        /// </remarks>
+        /// <returns>A unique list of file names.</returns>
+        public static HashSet<string> FindCandidateFiles(string docsPath)
+        {
+            var dirsToVisit = new Stack<string>();
+            var filesToParse = new HashSet<string>();
+
+            Console.WriteLine("Recursing folders...");
+            dirsToVisit.Push(docsPath);
+
+            while (dirsToVisit.Count > 0)
+            {
+                var dir = dirsToVisit.Pop();
+                Console.Write(":");
+
+                foreach (var subDirectory in Directory.EnumerateDirectories(dir))
+                {
+                    Console.Write("#");
+                    dirsToVisit.Push(subDirectory);
+                }
+
+                foreach (var file in Directory.EnumerateFiles(dir))
+                {
+                    if (Path.GetExtension(file) == ".md")
+                    {
+                        Console.Write("!");
+                        filesToParse.Add(file);
+                    }
+                    else
+                    {
+                        Console.Write("-");
+                    }
+                }
+            }
+
+            Console.WriteLine();
+            Console.WriteLine($"Found {filesToParse.Count} candidate documents.");
+
+            return filesToParse;
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocsLoader/MarkdownParser.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocsLoader/MarkdownParser.cs
new file mode 100644
index 0000000000..71f2650d03
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocsLoader/MarkdownParser.cs
@@ -0,0 +1,237 @@
+using System;
+using System.Collections.Generic;
+using System.Globalization;
+using System.IO;
+using System.Linq;
+using System.Text.RegularExpressions;
+using Markdig;
+using PlanetaryDocs.Domain;
+
+namespace PlanetaryDocsLoader
+{
+    /// <summary>
+    /// Manages transformation of markdown to HTML.
+    /// </summary>
+    public static class MarkdownParser
+    {
+        private static readonly Regex NotAlphanumeric = new ("[^a-zA-Z0-9]");
+
+        /// <summary>
+        /// Parses a list of files to a list of <see cref="Document"/> instances.
+        /// </summary>
+        /// <param name="filesToParse">The file list.</param>
+        /// <returns>The parsed <see cref="Document"/> list.</returns>
+        public static List<Document> ParseFiles(
+            IEnumerable<string> filesToParse)
+        {
+            var docsList = new List<Document>();
+
+            Console.WriteLine("Loading stop words...");
+            var stopWords = File.ReadAllLines("stopwords.txt");
+
+            Console.WriteLine($"{stopWords.Length} stop words loaded.");
+
+            // pass 1: compute word frequencies to generate tags
+            var words = new Dictionary<string, int>();
+            var wordsPerDocument = new Dictionary<string, IDictionary<string, int>>();
+
+            var total = filesToParse.Count();
+            var progress = new ProgressBar(total);
+            var blank = new string(' ', Console.BufferWidth - 1);
+            var (left, top) = Console.GetCursorPosition();
+
+            foreach (var file in filesToParse)
+            {
+                Console.SetCursorPosition(left, top);
+                for (var i = 0; i < 10; i++)
+                {
+                    Console.WriteLine(blank);
+                }
+
+                Console.SetCursorPosition(left, top);
+                Console.WriteLine($"{progress.Advance()}");
+                Console.WriteLine("===");
+                var fileName = file.Split(Path.DirectorySeparatorChar)[^1];
+                Console.WriteLine($"DOC:\t{fileName}");
+                var lines = File.ReadAllLines(file);
+                Console.WriteLine($"LINES:\t{lines.Length}");
+                var doc = new Document();
+                bool metaStart = false,
+                    metaEnd = false,
+                    titleFound = false,
+                    aliasFound = false,
+                    descriptionFound = false,
+                    dateFound = false,
+                    uidFound = false;
+
+                var markdown = new List<string>();
+
+                for (var idx = 0; idx < lines.Length; idx++)
+                {
+                    var line = lines[idx];
+
+                    if (!metaStart)
+                    {
+                        if (line.StartsWith("---"))
+                        {
+                            metaStart = true;
+                        }
+
+                        continue;
+                    }
+
+                    if (!metaEnd)
+                    {
+                        if (line.StartsWith("---"))
+                        {
+                            metaEnd = true;
+                            continue;
+                        }
+                        else
+                        {
+                            var metadata = line.Split(":");
+                            var key = metadata[0].Trim().ToLowerInvariant();
+                            switch (key)
+                            {
+                                case "title":
+                                    titleFound = true;
+                                    doc.Title = metadata[1].Trim();
+                                    Console.WriteLine($"TITLE:\t{doc.Title}");
+                                    break;
+
+                                case "uid":
+                                    uidFound = true;
+                                    doc.Uid = metadata[1].Trim().Replace('/', '_');
+                                    Console.WriteLine($"UID:\t{doc.Uid}");
+                                    break;
+
+                                case "description":
+                                    descriptionFound = true;
+                                    doc.Description = metadata[1].Trim();
+                                    break;
+
+                                case "ms.author":
+                                case "author":
+                                    aliasFound = true;
+                                    doc.AuthorAlias = metadata[1].Trim();
+                                    Console.WriteLine($"AUTHOR:\t{doc.AuthorAlias}");
+                                    break;
+
+                                case "ms.date":
+                                    dateFound = true;
+                                    doc.PublishDate = DateTime.ParseExact(
+                                        metadata[1].Trim(),
+                                        "M/d/yyyy",
+                                        CultureInfo.InvariantCulture);
+                                    Console.WriteLine($"PUB DATE:\t{doc.PublishDate}");
+                                    break;
+
+                                case "default":
+                                    continue;
+                            }
+
+                            continue;
+                        }
+                    }
+
+                    markdown.Add(line);
+                    ParseWords(file, line, words, wordsPerDocument, stopWords);
+                }
+
+                var valid = titleFound && aliasFound && descriptionFound && dateFound
+                    && uidFound;
+
+                if (valid)
+                {
+                    Console.WriteLine("VALID");
+                    doc.Markdown = string.Join(Environment.NewLine, markdown);
+                    doc.Html = Markdown.ToHtml(doc.Markdown);
+                    docsList.Add(doc);
+
+                    // change from file to uid reference
+                    if (wordsPerDocument.ContainsKey(file))
+                    {
+                        wordsPerDocument.Add(doc.Uid, wordsPerDocument[file]);
+                        wordsPerDocument.Remove(file);
+                    }
+                }
+                else
+                {
+                    Console.WriteLine("INVALID");
+                    continue;
+                }
+            }
+
+            Console.WriteLine("Generating tags...");
+            GenerateTags(docsList, words, wordsPerDocument);
+
+            Console.WriteLine($"Processed {docsList.Count} documents.");
+            return docsList;
+        }
+
+        private static void GenerateTags(
+            List<Document> docsList,
+            Dictionary<string, int> words,
+            Dictionary<string, IDictionary<string, int>> wordsPerDocument)
+        {
+            foreach (Document doc in docsList)
+            {
+                doc.Tags = wordsPerDocument[doc.Uid].Join(
+                    words,
+                    wpd => wpd.Key,
+                    w => w.Key,
+                    (w, wpd) => new
+                    {
+                        word = w.Key,
+                        idf = (double)wpd.Value / w.Value,
+                    })
+                    .OrderByDescending(words => words.idf)
+                    .Take(10)
+                    .Select(w => w.word)
+                    .ToList();
+            }
+        }
+
+        private static void ParseWords(
+            string file,
+            string line,
+            IDictionary<string, int> words,
+            IDictionary<string, IDictionary<string, int>> wordsPerDocument,
+            IEnumerable<string> stopWords)
+        {
+            var text = NotAlphanumeric.Replace(line, " ")
+                .Split(' ', StringSplitOptions.RemoveEmptyEntries);
+            foreach (var hit in text)
+            {
+                var newWord = hit.ToLowerInvariant().Trim();
+                if (newWord.Length < 4 || stopWords.Contains(newWord))
+                {
+                    continue;
+                }
+
+                if (words.ContainsKey(newWord))
+                {
+                    words[newWord]++;
+                }
+                else
+                {
+                    words.Add(newWord, 1);
+                }
+
+                if (!wordsPerDocument.ContainsKey(file))
+                {
+                    wordsPerDocument.Add(file, new Dictionary<string, int>());
+                }
+
+                if (wordsPerDocument[file].ContainsKey(newWord))
+                {
+                    words[newWord]++;
+                }
+                else
+                {
+                    wordsPerDocument[file].Add(newWord, 1);
+                }
+            }
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocsLoader/PlanetaryDocsLoader.csproj b/samples/end2end/PlanetaryDocs/PlanetaryDocsLoader/PlanetaryDocsLoader.csproj
new file mode 100644
index 0000000000..6630db675d
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocsLoader/PlanetaryDocsLoader.csproj
@@ -0,0 +1,28 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <LangVersion>10.0</LangVersion>
+    <Description>Seed data for the Azure Cosmos DB database.</Description>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <None Remove="stopwords.txt" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <Content Include="stopwords.txt">
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    </Content>
+  </ItemGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Markdig" Version="0.24.0" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\PlanetaryDocs.DataAccess\PlanetaryDocs.DataAccess.csproj" />
+  </ItemGroup>
+  
+</Project>
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocsLoader/Program.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocsLoader/Program.cs
new file mode 100644
index 0000000000..697876ae9b
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocsLoader/Program.cs
@@ -0,0 +1,37 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using PlanetaryDocs.Domain;
+using PlanetaryDocsLoader;
+
+// path to repository (backwards works up from bin output directory)
+const string DocsPath = @"..\..\..\..\..\..\..\entity-framework\";
+
+// Azure Cosmos DB endpoint, defaults to emulator
+const string EndPoint = "https://localhost:8081";
+
+// Secret key for Azure Cosmos DB, defaults to emulator
+const string AccessKey = "C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==";
+
+// set to true to re-run tests without rebuilding db
+var testsOnly = false;
+
+Console.Clear();
+
+Console.WriteLine($"Cosmos Loader for Planetary Docs executing in directory: {Environment.CurrentDirectory}");
+
+if (!testsOnly && !Directory.Exists(DocsPath))
+{
+    Console.WriteLine($"Invalid path to docs: {DocsPath}");
+    return;
+}
+
+List<Document> docsList = null;
+
+if (!testsOnly)
+{
+    var filesToParse = FileSystemParser.FindCandidateFiles(DocsPath);
+    docsList = MarkdownParser.ParseFiles(filesToParse);
+}
+
+await CosmosLoader.LoadDocumentsAsync(docsList, EndPoint, AccessKey);
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocsLoader/ProgressBar.cs b/samples/end2end/PlanetaryDocs/PlanetaryDocsLoader/ProgressBar.cs
new file mode 100644
index 0000000000..252ac0085e
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocsLoader/ProgressBar.cs
@@ -0,0 +1,41 @@
+using System;
+
+namespace PlanetaryDocsLoader
+{
+    /// <summary>
+    /// Progress bar for console.
+    /// </summary>
+    public class ProgressBar
+    {
+        private int current = 0;
+        private int total;
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="ProgressBar"/> class.
+        /// </summary>
+        /// <param name="total">Total items in list.</param>
+        public ProgressBar(int total) => this.total = total;
+
+        /// <summary>
+        /// Advances the progress bar.
+        /// </summary>
+        /// <returns>The new bar.</returns>
+        public string Advance()
+        {
+            current++;
+            return ToString();
+        }
+
+        /// <inheritdoc/>
+        public override string ToString()
+        {
+            var pct = current * 100 / total;
+            var progressBar = Console.BufferWidth - 6;
+            var done = pct * progressBar / 100;
+            var todo = progressBar - done;
+            string doneStr = done == 0 ? string.Empty : new string('#', done);
+            string toDoStr = todo == 0 ? string.Empty : new string('-', todo);
+            return $"{doneStr}{toDoStr} {pct}%";
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/PlanetaryDocsLoader/stopwords.txt b/samples/end2end/PlanetaryDocs/PlanetaryDocsLoader/stopwords.txt
new file mode 100644
index 0000000000..72f0014afc
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/PlanetaryDocsLoader/stopwords.txt
@@ -0,0 +1,34 @@
+core
+entity
+that
+this
+with
+using
+entityframework
+from
+will
+your
+when
+xref
+http
+https
+have
+here
+what
+more
+then
+first
+which
+into
+would
+where
+these
+some
+should
+other
+only
+note
+efcore
+dotnet
+also
+added
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/README.md b/samples/end2end/PlanetaryDocs/README.md
new file mode 100644
index 0000000000..81b5a0f6aa
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/README.md
@@ -0,0 +1,112 @@
+---
+page_type: sample
+description: "This repository is intended to showcase a full application that supports Create, Read, Update, and Delete operations (CRUD) using Blazor (Server), Entity Framework Core, and Azure Cosmos DB."
+languages:
+- csharp
+products:
+- ef-core
+- blazor
+- azure-cosmos-db
+---
+
+# Planetary Docs
+
+Welcome to Planetary Docs! This repository is intended to showcase a full
+application that supports Create, Read, Update, and Delete operations (CRUD)
+using Blazor (Server), Entity Framework Core and Azure Cosmos DB.
+
+> **Important Security Notice** This app is meant for demo purposes only. As implemented, it
+is not a production-ready app. More specifically, there are no users or roles defined and
+access is _not_ secured by a login. That means anyone with the URL can modify your
+document database.
+
+## Quickstart
+
+Here's how to get started in a few easy steps.
+
+### Clone this repo
+
+Using your preferred tools, clone the repository. The `git` commmand looks like this:
+
+```bash
+git clone https://github.com/dotnet/EntityFramework.Docs
+```
+
+### Create an Azure Cosmos DB instance
+
+To run this demo, you will need to either run the [Azure Cosmos DB emulator](https://learn.microsoft.com/azure/cosmos-db/local-emulator)
+or create an Azure Cosmos DB account. You can read
+[Create an Azure Cosmos DB account](https://learn.microsoft.com/azure/cosmos-db/create-cosmosdb-resources-portal#create-an-azure-cosmos-db-account) to learn how. Be sure to check out the option
+for a [free account](https://learn.microsoft.com/azure/cosmos-db/optimize-dev-test#azure-cosmos-db-free-tier)!
+
+Choose the SQL API.
+
+> This project is configured to use the emulator "out of the box."
+
+### Initialize the database
+
+Navigate to the `PlanetaryDocsLoader` project.
+
+If you are using the emulator, make sure the emulator is running.
+
+If you are using an Azure Cosmos DB account, update `Program.cs` with:
+
+- The Azure Cosmos DB endpoint
+- The Azure Cosmos DB key
+
+> The endpoint is the `URI` and the key is the `Primary Key` on the **keys** pane of your Azure
+Cosmos DB account in the [Azure Portal](https://portal.azure.com/).
+
+Run the application (`dotnet run` from the command line). You should see status
+as it parses documents, loads them to the database and then runs tests. This step
+may take several minutes.
+
+### Configure and run the Blazor app
+
+If you are using the emulator, the Blazor app is ready to run. If you are using an account,
+navigate to the `PlanetaryDocs` Blazor Server project and either update the `CosmosSettings`
+in the `appsettings.json` file, or create a new section in `appsettings.Development.json`
+and add your access key and endpoint. Run the app. You should be ready to go!
+
+## Project Details
+
+The following features were integrated into this project.
+
+`PlanetaryDocsLoader` parses the docs repository and inserts the
+documents into the database. It includes tests to verify the
+functionality is working.
+
+`PlanetaryDocs.Domain` hosts the domain classes, validation logic,
+and signature (interface) for data access.
+
+`PlanetaryDocs.DataAccess` contains the EF Core `DbContext`
+and an implementation of the data access service.
+
+- `DocsContext`
+  - Has model-building code that shows how to map ownership
+  - Uses value converters with JSON serialization to support primitives collection and nested
+complex types
+  - Demonstrates use of partition keys, including how to define them for the
+model and how to specify them in queries
+  - Provides an example of specifying the container by entity
+  - Shows how to turn off the discriminator
+  - Stores two entity types (aliases and tags) in the same container
+  - Uses a "shadow property" to track partition keys on aliases and tags
+  - Hooks into the `SavingChanges` event to automate the generation of audit snapshots
+- `DocumentService`
+  - Shows various strategies for C.R.U.D. operations
+  - Programmatically synchronizes related entities
+  - Demonstrates how to handle updates with concurrency to disconnected entities
+  - Uses the new `IDbContextFactory<T>` implementation to manage context instances
+
+`PlanetaryDocs` is a Blazor Server app.
+
+- Examples of JavaScript interop in the `TitleService`, `HistoryService`, and `MultiLineEditService`.
+- Uses keyboard handlers to allow keyboard-based navigation and input on the edit page
+- Shows a generic autocomplete component with debounce built-in
+- `HtmlPreview` uses a phantom `textarea` to render an HTML preview
+- `MarkDig` is used to transform markdown into HTML
+- The `MultiLineEdit` component shows a workaround using JavaScript interop for limitations with fields that have large input values
+- The `Editor` component supports concurrency. If you open a document twice in separate tabs and edit in both, the second will notify that changes were made and provide the option to reset or overwrite
+
+Your feedback is valuable! [File an issue](https://github.com/dotnet/EntityFramework.Docs/issues/new) to report defects or request changes (we also accept pull requests.)
diff --git a/samples/end2end/PlanetaryDocs/Tests/Directory.Build.props b/samples/end2end/PlanetaryDocs/Tests/Directory.Build.props
new file mode 100644
index 0000000000..fa0bd11664
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/Tests/Directory.Build.props
@@ -0,0 +1,3 @@
+<Project>
+  <!-- don't use default project settings for test projects -->  
+</Project>
\ No newline at end of file
diff --git a/samples/end2end/PlanetaryDocs/Tests/DomainTests/AuthorTests.cs b/samples/end2end/PlanetaryDocs/Tests/DomainTests/AuthorTests.cs
new file mode 100644
index 0000000000..e6e9722dbb
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/Tests/DomainTests/AuthorTests.cs
@@ -0,0 +1,91 @@
+using System;
+using System.Collections.Generic;
+using PlanetaryDocs.Domain;
+using Xunit;
+
+namespace DomainTests
+{
+    public class AuthorTests
+    {
+        [Fact]
+        public void New_Instance_Initializes_Documents()
+        {
+            // arange and act
+            var author = new Author();
+
+            // assert
+            Assert.NotNull(author.Documents);
+        }
+
+        [Fact]
+        public void HashCode_Of_Author_Is_HashCode_Of_Alias()
+        {
+            // arrange
+            const string alias = nameof(AuthorTests);
+            var author = new Author { Alias = alias };
+
+            // act
+            var expected = alias.GetHashCode();
+            var actual = author.GetHashCode();
+
+            // assert
+            Assert.Equal(expected, actual);
+        }
+
+        public static IEnumerable<object[]> AuthorEqualityTests()
+        {
+            yield return new object[]
+            {
+                new Author { Alias = nameof(AuthorTests) }, true
+            };
+
+            yield return new object[]
+            {
+                new Author { Alias = nameof(AuthorEqualityTests) }, false
+            };
+
+            yield return new object[]
+            {
+                new object(), false
+            };
+
+            yield break;
+        }
+
+        [Theory]
+        [MemberData(nameof(AuthorEqualityTests))]
+        public void Equality_Compares_Type_And_Alias(object compare, bool equal)
+        {
+            // arrange
+            var author = new Author { Alias = nameof(AuthorTests) };
+
+            // act
+            var areEqual = author.Equals(compare);
+
+            // assert
+            Assert.Equal(equal, areEqual);
+        }
+
+        [Theory]
+        [InlineData("jeremy", 1)]
+        [InlineData("jeremy", 2)]
+        [InlineData("randomperson", 3)]
+        public void Author_ToString_Includes_Alias_And_Docs_Count(
+            string alias,
+            int expectedDocs)
+        {
+            // arrange
+            var author = new Author { Alias = alias };
+            for (var idx = 0; idx < expectedDocs; idx++)
+            {
+                var summary = new DocumentSummary
+                {
+                    AuthorAlias = alias,
+                    Title = Guid.NewGuid().ToString(),
+                };
+                summary.Uid = summary.Title.Split('-')[^1];
+                author.Documents.Add(summary);
+            }
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/Tests/DomainTests/DocumentAuditSummaryTests.cs b/samples/end2end/PlanetaryDocs/Tests/DomainTests/DocumentAuditSummaryTests.cs
new file mode 100644
index 0000000000..c0a24ec29b
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/Tests/DomainTests/DocumentAuditSummaryTests.cs
@@ -0,0 +1,176 @@
+using System;
+using System.Collections.Generic;
+using PlanetaryDocs.Domain;
+using Xunit;
+
+namespace DomainTests
+{
+    public class DocumentAuditSummaryTests
+    {
+        public static IEnumerable<object[]> DocAuditSummaryTests()
+        {
+            var resolvers = new (Func<object, string> resolver, bool fromAudit)[]
+            {
+                (obj => ((DocumentAudit)obj).Id.ToString(), true),
+                (obj => ((DocumentAudit)obj).Uid, true),
+                (obj => ((DocumentAudit)obj).Timestamp.ToString(), true),
+                (obj => ((Document)obj).AuthorAlias, false),
+                (obj => ((Document)obj).Title, false),
+            };
+
+            var auditResolvers = new Func<DocumentAuditSummary, string>[]
+            {
+                auditSummary => auditSummary.Id.ToString(),
+                auditSummary => auditSummary.Uid,
+                auditSummary => auditSummary.Timestamp.ToString(),
+                auditSummary => auditSummary.Alias,
+                auditSummary => auditSummary.Title,
+            };
+
+            for (var idx = 0; idx < resolvers.Length; idx++)
+            {
+                yield return new object[]
+                {
+                    resolvers[idx].resolver,
+                    resolvers[idx].fromAudit,
+                    auditResolvers[idx]
+                };
+            }
+        }
+
+        [Theory]
+        [MemberData(nameof(DocAuditSummaryTests))]
+        public void Properties_Match_Audit_Or_Doc(
+            Func<object, string> resolver,
+            bool fromAudit,
+            Func<DocumentAuditSummary, string> auditResolver)
+        {
+            // arrange
+            var doc = new Document
+            {
+                Uid = nameof(DocAuditSummaryTests),
+                AuthorAlias = "system",
+                Title = "Document title"
+            };
+
+            var audit = new DocumentAudit(doc);
+
+            // act
+            var auditSummary = new DocumentAuditSummary(audit);
+            var expected = fromAudit ? resolver(audit) : resolver(doc);
+            var actual = auditResolver(auditSummary);
+
+            // assert
+            Assert.Equal(expected, actual);
+        }
+
+        [Fact]
+        public void HashCode_Is_HashCode_Of_Id()
+        {
+            // arrange
+            var summary = new DocumentAuditSummary
+            {
+                Id = Guid.NewGuid()
+            };
+
+            // act
+            var expected = summary.Id.GetHashCode();
+            var actual = summary.GetHashCode();
+
+            // assert
+            Assert.Equal(expected, actual);
+        }
+
+        public static IEnumerable<object[]> EqualityTests()
+        {
+            var guid = Guid.NewGuid();
+            var sameGuidSameUid = new DocumentAuditSummary
+            {
+                Id = guid,
+                Uid = guid.ToString()
+            };
+
+            var sameGuidDifferentUid = new DocumentAuditSummary
+            {
+                Id = guid,
+                Uid = nameof(EqualityTests)
+            };
+
+            var differentGuid = new DocumentAuditSummary
+            {
+                Id = Guid.NewGuid()
+            };
+
+            var anonymous = new
+            {
+                Id = guid
+            };
+
+            yield return new object[]
+            {
+                guid,
+                sameGuidSameUid,
+                true
+            };
+
+            yield return new object[]
+            {
+                guid,
+                sameGuidDifferentUid,
+                true
+            };
+
+            yield return new object[]
+            {
+                guid,
+                differentGuid,
+                false
+            };
+
+            yield return new object[]
+            {
+                guid,
+                anonymous,
+                false
+            };
+        }
+
+        [Theory]
+        [MemberData(nameof(EqualityTests))]
+        public void Equality_Based_On_Type_And_Id(
+            Guid id,
+            object target,
+            bool areEqual)
+        {
+            // arrange
+            var summary = new DocumentAuditSummary
+            {
+                Id = id
+            };
+
+            // act
+            var equals = summary.Equals(target);
+
+            // assert
+            Assert.Equal(areEqual, equals);
+        }
+
+        [Fact]
+        public void ToString_Includes_Id_And_Uid()
+        {
+            // arrange
+            var summary = new DocumentAuditSummary
+            {
+                Id = Guid.NewGuid(),
+                Uid = nameof(EqualityTests)
+            };
+
+            // act
+            var str = summary.ToString();
+
+            // assert
+            Assert.Contains(summary.Id.ToString(), str);
+            Assert.Contains(summary.Uid, str);
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/Tests/DomainTests/DocumentAuditTests.cs b/samples/end2end/PlanetaryDocs/Tests/DomainTests/DocumentAuditTests.cs
new file mode 100644
index 0000000000..01b41a6d2b
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/Tests/DomainTests/DocumentAuditTests.cs
@@ -0,0 +1,128 @@
+using System;
+using System.Collections.Generic;
+using System.Text.Json;
+using PlanetaryDocs.Domain;
+using Xunit;
+
+namespace DomainTests
+{
+    public class DocumentAuditTests
+    {
+        private const string Author = "jeliknes";
+        private const string Markdown = "# Hi";
+        private const string Html = "<h1>Hi</h1>";
+
+        private readonly DateTime PublishDate =
+            DateTime.UtcNow.AddDays(-2);
+
+        private Document NewDoc()
+        {
+            var doc = new Document
+            {
+                AuthorAlias = Author,
+                Description = $"Document by {Author}",
+                Html = Html,
+                Markdown = Markdown,
+                PublishDate = PublishDate,
+                Title = "Title of document"
+            };
+
+            doc.Tags.Add("one");
+            doc.Tags.Add("two");
+
+            return doc;
+        }
+
+        [Fact]
+        public void New_Instance_With_Doc_Generates_New_Guid()
+        {
+            // arrange
+            var doc = NewDoc();
+
+            // act
+            var docAudit = new DocumentAudit(doc);
+
+            // assert
+            Assert.NotEqual(default, docAudit.Id);
+        }
+
+        [Fact]
+        public void Uid_Initializes_To_Uid_Of_Document()
+        {
+            // arrange
+            var doc = NewDoc();
+
+            // act
+            var docAudit = new DocumentAudit(doc);
+
+            // assert
+            Assert.Equal(doc.Uid, docAudit.Uid);
+        }
+
+        [Fact]
+        public void Timestamp_Defaults_To_UtcNow()
+        {
+            // arrange
+            var doc = NewDoc();
+
+            // act
+            var docAudit = new DocumentAudit(doc);
+            var now = DateTimeOffset.UtcNow;
+            var diff = now - docAudit.Timestamp;
+            var tolerance = TimeSpan.FromMilliseconds(50);
+
+            // assert
+            Assert.True(diff < tolerance);
+        }
+
+        [Fact]
+        public void Document_Is_Json_Serialized_Snapshot()
+        {
+            // arrange
+            var doc = NewDoc();
+
+            // act
+            var docAudit = new DocumentAudit(doc);
+            var serialized = JsonSerializer.Serialize(doc);
+
+            // assert
+            Assert.Equal(serialized, docAudit.Document);
+        }
+
+        public static IEnumerable<object[]> DocumentSnapshotTests()
+        {
+            var resolvers = new Func<Document, string>[]
+            {
+                doc => doc.AuthorAlias,
+                doc => doc.Description,
+                doc => doc.Html,
+                doc => doc.Markdown,
+                doc => doc.PublishDate.Ticks.ToString(),
+                doc => string.Join(", ", doc.Tags),
+                doc => doc.Title,
+                doc => doc.Uid
+            };
+
+            foreach (var resolver in resolvers)
+            {
+                yield return new object[] { resolver };
+            }
+        }
+
+        [Theory]
+        [MemberData(nameof(DocumentSnapshotTests))]
+        public void GetDocumentSnapshot_Deserializes_Document(
+            Func<Document, string> resolver)
+        {
+            // arrange
+            var doc = NewDoc();
+
+            // act
+            var docAudit = new DocumentAudit(doc);
+            var compDoc = docAudit.GetDocumentSnapshot();
+
+            // assert
+            Assert.Equal(resolver(doc), resolver(compDoc));
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/Tests/DomainTests/DocumentSummaryTests.cs b/samples/end2end/PlanetaryDocs/Tests/DomainTests/DocumentSummaryTests.cs
new file mode 100644
index 0000000000..5ae5ac9b58
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/Tests/DomainTests/DocumentSummaryTests.cs
@@ -0,0 +1,156 @@
+using System;
+using System.Collections.Generic;
+using PlanetaryDocs.Domain;
+using Xunit;
+
+namespace DomainTests
+{
+    public class DocumentSummaryTests
+    {
+        public static IEnumerable<object[]> DocSummaryTests()
+        {
+            var resolvers = new Func<Document, string>[]
+            {
+                doc => doc.Uid,
+                doc => doc.Title,
+                doc => doc.AuthorAlias,
+            };
+
+            var summaryResolvers = new Func<DocumentSummary, string>[]
+            {
+                summary => summary.Uid,
+                summary => summary.Title,
+                summary => summary.AuthorAlias,
+            };
+
+            for (var idx = 0; idx < resolvers.Length; idx++)
+            {
+                yield return new object[]
+                {
+                    resolvers[idx],
+                    summaryResolvers[idx]
+                };
+            }
+        }
+
+        [Theory]
+        [MemberData(nameof(DocSummaryTests))]
+        public void Properties_Match_Doc(
+            Func<Document, string> resolver,
+            Func<DocumentSummary, string> summaryResolver)
+        {
+            // arrange
+            var doc = new Document
+            {
+                Uid = nameof(DocSummaryTests),
+                AuthorAlias = "system",
+                Title = "Document title"
+            };
+
+            // act
+            var summary = new DocumentSummary(doc);
+            var expected = resolver(doc);
+            var actual = summaryResolver(summary);
+
+            // assert
+            Assert.Equal(expected, actual);
+        }
+
+        [Fact]
+        public void HashCode_Is_HashCode_Of_Uid()
+        {
+            // arrange
+            var summary = new DocumentSummary
+            {
+                Uid = nameof(DocSummaryTests)
+            };
+
+            // act
+            var expected = summary.Uid.GetHashCode();
+            var actual = summary.GetHashCode();
+
+            // assert
+            Assert.Equal(expected, actual);
+        }
+
+        public static IEnumerable<object[]> EqualityTests()
+        {
+            var uid = Guid.NewGuid().ToString();
+            var sameUid = new DocumentSummary
+            {
+                Uid = uid
+            };
+
+            var differentUid = new DocumentSummary
+            {
+                Uid = Guid.NewGuid().ToString()
+            };
+
+            var anonymous = new
+            {
+                Uid = uid
+            };
+
+            yield return new object[]
+            {
+                uid,
+                sameUid,
+                true
+            };
+
+            yield return new object[]
+            {
+                uid,
+                differentUid,
+                false
+            };
+
+            yield return new object[]
+            {
+                uid,
+                anonymous,
+                false
+            };
+        }
+
+        [Theory]
+        [MemberData(nameof(EqualityTests))]
+        public void Equality_Based_On_Type_And_Id(
+            string uid,
+            object target,
+            bool areEqual)
+        {
+            // arrange
+            var summary = new DocumentSummary
+            {
+                Uid = uid
+            };
+
+            // act
+            var equals = summary.Equals(target);
+
+            // assert
+            Assert.Equal(areEqual, equals);
+        }
+
+        [Fact]
+        public void ToString_Includes_Uid_Alias_And_Title()
+        {
+            // arrange
+            var summary = new DocumentSummary
+            {
+                Uid = nameof(EqualityTests),
+                Title = "Something great",
+                AuthorAlias = "test"
+            };
+
+            // act
+            var str = summary.ToString();
+
+            // assert
+            Assert.Contains(summary.Uid, str);
+            Assert.Contains(summary.Title, str);
+            Assert.Contains(summary.AuthorAlias, str);
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/Tests/DomainTests/DocumentTests.cs b/samples/end2end/PlanetaryDocs/Tests/DomainTests/DocumentTests.cs
new file mode 100644
index 0000000000..217df66bc5
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/Tests/DomainTests/DocumentTests.cs
@@ -0,0 +1,109 @@
+using System;
+using System.Collections.Generic;
+using PlanetaryDocs.Domain;
+using Xunit;
+
+namespace DomainTests
+{
+    public class DocumentTests
+    {
+        [Fact]
+        public void Tags_Are_Initialized()
+        {
+            // arrange and act
+            var doc = new Document();
+
+            // assert
+            Assert.NotNull(doc.Tags);
+        }
+
+        [Fact]
+        public void HashCode_Is_Uid_HashCode()
+        {
+            // arrange
+            const string uid = nameof(DocumentTests);
+            var doc = new Document { Uid = uid };
+            var expected = uid.GetHashCode();
+
+            // act
+            var actual = doc.GetHashCode();
+
+            // assert
+            Assert.Equal(expected, actual);
+        }
+
+        public static IEnumerable<object[]> DocEqualityTests()
+        {
+            var uid = Guid.NewGuid().ToString();
+            var altUid = Guid.NewGuid().ToString();
+            var doc = new Document { Uid = uid };
+            var diffDoc = new Document { Uid = altUid };
+            var anonDoc = new { Uid = uid };
+
+            yield return new object[]
+            {
+                uid,
+                doc,
+                true
+            };
+
+            yield return new object[]
+            {
+                uid,
+                diffDoc,
+                false
+            };
+
+            yield return new object[]
+            {
+                uid,
+                anonDoc,
+                false
+            };
+        }
+
+        [Theory]
+        [MemberData(nameof(DocEqualityTests))]
+        public void Equality_Is_Based_On_Type_And_Uid(
+            string srcUid,
+            object target,
+            bool areEqual)
+        {
+            // arrange
+            var refDoc = new Document { Uid = srcUid };
+
+            // act
+            var equal = refDoc.Equals(target);
+
+            // assert
+            Assert.Equal(areEqual, equal);
+        }
+
+        [Theory]
+        [InlineData("one", "author", new string[0])]
+        [InlineData("two", "author", new[] { "one" })]
+        [InlineData("three", "author", new[] { "one", "two" })]
+        public void ToString_Contains_Uid_Alias_And_TagCount(
+            string uid,
+            string alias,
+            string[] tags)
+        {
+            // arrange
+            var doc = new Document
+            {
+                Uid = uid,
+                AuthorAlias = alias,
+            };
+
+            doc.Tags.AddRange(tags);
+
+            // act
+            var str = doc.ToString();
+
+            // assert
+            Assert.Contains(uid, str);
+            Assert.Contains(alias, str);
+            Assert.Contains(tags.Length.ToString(), str);
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/Tests/DomainTests/DomainTests.csproj b/samples/end2end/PlanetaryDocs/Tests/DomainTests/DomainTests.csproj
new file mode 100644
index 0000000000..5abd228973
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/Tests/DomainTests/DomainTests.csproj
@@ -0,0 +1,26 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+
+    <IsPackable>false</IsPackable>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="18.0.1" />
+    <PackageReference Include="xunit" Version="2.4.1" />
+    <PackageReference Include="xunit.runner.visualstudio" Version="2.4.3">
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+      <PrivateAssets>all</PrivateAssets>
+    </PackageReference>
+    <PackageReference Include="coverlet.collector" Version="1.3.0">
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+      <PrivateAssets>all</PrivateAssets>
+    </PackageReference>
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\..\PlanetaryDocs.Domain\PlanetaryDocs.Domain.csproj" />
+  </ItemGroup>
+
+</Project>
diff --git a/samples/end2end/PlanetaryDocs/Tests/DomainTests/TagTests.cs b/samples/end2end/PlanetaryDocs/Tests/DomainTests/TagTests.cs
new file mode 100644
index 0000000000..6ae1097971
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/Tests/DomainTests/TagTests.cs
@@ -0,0 +1,105 @@
+using System;
+using System.Collections.Generic;
+using PlanetaryDocs.Domain;
+using Xunit;
+
+namespace DomainTests
+{
+    public class TagTests
+    {
+        [Fact]
+        public void New_Instance_Initializes_Documents()
+        {
+            // arrange and act
+            var tag = new Tag();
+
+            // assert
+            Assert.NotNull(tag.Documents);
+        }
+
+        [Fact]
+        public void HashCode_Is_HashCode_Of_TagName()
+        {
+            // arrange
+            var tag = new Tag
+            {
+                TagName = nameof(TagTests)
+            };
+
+            // act
+            var expected = tag.TagName.GetHashCode();
+            var actual = tag.GetHashCode();
+
+            // assert
+            Assert.Equal(expected, actual);
+        }
+
+        public static IEnumerable<object[]> TagEqualityTests()
+        {
+            yield return new object[]
+            {
+                new Tag { TagName = nameof(TagTests) },
+                true
+            };
+
+            yield return new object[]
+            {
+                new Tag { TagName = nameof(TagEqualityTests) },
+                false
+            };
+
+            yield return new object[]
+            {
+                new { TagName = nameof(TagTests) },
+                false
+            };
+        }
+
+        [Theory]
+        [MemberData(nameof(TagEqualityTests))]
+        public void Equality_Is_Based_On_Type_And_TagName(
+            object target,
+            bool areEqual)
+        {
+            // arrange
+            var tag = new Tag { TagName = nameof(TagTests) };
+
+            // act
+            var equals = tag.Equals(target);
+
+            // assert
+            Assert.Equal(areEqual, equals);
+        }
+
+        [Theory]
+        [InlineData(0)]
+        [InlineData(1)]
+        [InlineData(99)]
+        public void ToString_Includes_TagName_And_Documents_Count(int docCount)
+        {
+            // arrange
+            var tag = new Tag
+            {
+                TagName = Guid.NewGuid().ToString()
+            };
+
+            for (var idx = 0; idx < docCount; idx++)
+            {
+                tag.Documents.Add(
+                    new DocumentSummary
+                    {
+                        Uid = idx.ToString(),
+                        Title = $"Title #{idx}",
+                        AuthorAlias = "test"
+                    });
+            }
+
+            // act
+            var str = tag.ToString();
+
+            // assert
+            Assert.Contains(tag.TagName, str);
+            Assert.Contains(docCount.ToString(), str);
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/Tests/DomainTests/ValidationRulesTests.cs b/samples/end2end/PlanetaryDocs/Tests/DomainTests/ValidationRulesTests.cs
new file mode 100644
index 0000000000..881ae9a1ce
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/Tests/DomainTests/ValidationRulesTests.cs
@@ -0,0 +1,402 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using PlanetaryDocs.Domain;
+using Xunit;
+
+namespace DomainTests
+{
+    public class ValidationRulesTests
+    {
+        private const string Punctuation = "(),?!'\".";
+        private const string BadPunctuation = "~^[]{},";
+        private const string UidAllowed = "_.-";
+
+        [Fact]
+        public void ValidResult_Returns_IsValid_True()
+        {
+            // arrange and act
+            var result = ValidationRules.ValidResult();
+
+            // assert
+            Assert.True(result.IsValid);
+        }
+
+        [Theory]
+        [InlineData("Invalid")]
+        [InlineData("Data not good")]
+        public void InvalidResult_Returns_Invalid_False_With_Message(
+            string message)
+        {
+            // arrange and act
+            var result = ValidationRules.InvalidResult(message);
+
+            // assert
+            Assert.False(result.IsValid);
+            Assert.Equal(message, result.Message);
+        }
+
+        public static IEnumerable<object[]> CompoundTests()
+        {
+            var valid = ValidationRules.ValidResult();
+            var invalid1 = ValidationRules.InvalidResult("bad");
+            var invalid2 = ValidationRules.InvalidResult("not good");
+
+            var matrix = new[]
+            {
+                (new [] { valid }, 0),
+                (new [] { invalid1 }, 0),
+                (new [] { valid, valid }, 0),
+                (new [] { valid, invalid1 }, 1),
+                (new [] { invalid1, valid }, 0),
+                (new [] { invalid1, invalid2 }, 0),
+                (new [] { valid, valid, valid }, 0),
+                (new [] { valid, valid, invalid1 }, 2),
+                (new [] { valid, invalid1, valid }, 1),
+                (new [] { valid, invalid1, invalid2}, 1),
+                (new [] { invalid1, valid, valid }, 0),
+                (new [] { invalid1, valid, invalid2 }, 0),
+                (new [] { invalid1, invalid1, valid }, 0)
+            };
+
+            foreach (var testCase in matrix)
+            {
+                yield return new object[]
+                {
+                    testCase.Item1,
+                    testCase.Item2
+                };
+            }
+        }
+
+        [Theory]
+        [MemberData(nameof(CompoundTests))]
+        public void Compound_Result_Returns_First_Invalid(
+            ValidationState[] states,
+            int expectedIdx)
+        {
+            // arrange and act
+            var expected = states[expectedIdx];
+            var actual = ValidationRules.CompoundResult(
+                nameof(ValidationRulesTests),
+                nameof(ValidationRulesTests),
+                states.Select(
+                    state =>
+                    (Func<string, string, ValidationState>)((_, __) => state)).ToArray());
+
+            // assert
+            if (expected.IsValid)
+            {
+                Assert.True(actual.IsValid);
+            }
+            else
+            {
+                Assert.Equal(expected.Message, actual.Message);
+            }
+        }
+
+        [Theory]
+        [InlineData(null)]
+        [InlineData("")]
+        [InlineData(" ")]
+        [InlineData("x")]
+        public void IsRequired_Disallows_Null_Or_WhiteSpace(
+            string target)
+        {
+            // arrange
+            var expected = !string.IsNullOrWhiteSpace(target);
+
+            // act
+            var actual = ValidationRules.IsRequired("field", target).IsValid;
+
+            // assert
+            Assert.Equal(expected, actual);
+        }
+
+        [Theory]
+        [InlineData(null, false)]
+        [InlineData("", false)]
+        [InlineData("  ", false)]
+        [InlineData(" a ", false)]
+        [InlineData("a1", false)]
+        [InlineData(" A ", false)]
+        [InlineData("A1", false)]
+        [InlineData("Excellent", true)]
+        [InlineData("aaaa", true)]
+        [InlineData("ZZZZ", true)]
+        [InlineData("Exciting!", false)]
+        public void IsAlphaOnly_Disallows_NonAlpha(
+            string target,
+            bool expected)
+        {
+            // arrange and act
+            var state = ValidationRules.IsAlphaOnly("field", target);
+
+            // assert
+            Assert.Equal(expected, state.IsValid);
+        }
+
+        public static IEnumerable<object[]> SimpleTextCases()
+        {
+            var validText = new[]
+            {
+                "This is a simple title.",
+                "This is exciting!",
+                "Won't, you, be, my, neighbor?",
+                "Word"
+            };
+
+            var validUid = new[]
+            {
+                "uid",
+                "uid-two",
+                "uid_two-three",
+                "uid-is.here_score"
+            };
+
+            for (var uidFlag = 0; uidFlag < 2; uidFlag++)
+            {
+                var isUid = uidFlag == 1;
+                var srcArray = isUid ? validUid : validText;
+                var badUid = Punctuation.Union(BadPunctuation)
+                    .Except(UidAllowed).ToArray();
+
+                for (var idx = 0; idx < srcArray.Length; idx++)
+                {
+                    yield return new object[]
+                    {
+                        isUid, srcArray[idx], true
+                    };
+
+                    var badChoices = isUid ? badUid : BadPunctuation.ToCharArray();
+                    var invalid = badChoices[idx % badChoices.Length];
+
+                    yield return new object[]
+                    {
+                        isUid, $"{srcArray[idx]}{invalid}", false
+                    };
+                }
+            }
+        }
+
+        [Theory]
+        [MemberData(nameof(SimpleTextCases))]
+        public void IsSimpleText_Disallows_Invalid_Punctuation(
+            bool isUid,
+            string target,
+            bool expected)
+        {
+            // arrange and act
+            var state = ValidationRules.IsSimpleText("field", target, isUid);
+
+            // assert
+            Assert.Equal(expected, state.IsValid);
+        }
+
+        public enum TestToCheck
+        {
+            IsRequired,
+            IsAlpha,
+            IsSimpleNoUid,
+            IsSimpleUid
+        };
+
+        [Theory]
+        [InlineData(TestToCheck.IsRequired)]
+        [InlineData(TestToCheck.IsAlpha)]
+        [InlineData(TestToCheck.IsSimpleNoUid)]
+        [InlineData(TestToCheck.IsSimpleUid)]
+        public void Invalid_Messages_Include_FieldName(
+            TestToCheck testToCheck)
+        {
+            // arrange
+
+            var field = testToCheck.ToString();
+            ValidationState result = null;
+
+            // act
+
+            switch (testToCheck)
+            {
+                case TestToCheck.IsRequired:
+                    result = ValidationRules.IsRequired(field, string.Empty);
+                    break;
+
+                case TestToCheck.IsAlpha:
+                    result = ValidationRules.IsAlphaOnly(field, "!");
+                    break;
+
+                case TestToCheck.IsSimpleNoUid:
+                    result = ValidationRules.IsSimpleText(field, BadPunctuation);
+                    break;
+
+                case TestToCheck.IsSimpleUid:
+                    result = ValidationRules.IsSimpleText(field, BadPunctuation, true);
+                    break;
+            }
+
+            // assert
+            Assert.Contains(field, result.Message);
+        }
+
+        public static IEnumerable<object[]> PropertyMatrix()
+        {
+            var matrix = new[]
+            {
+                new object[]
+                {
+                    nameof(Document.AuthorAlias),
+                    string.Empty,
+                    false
+                },
+                new object[]
+                {
+                    nameof(Document.AuthorAlias),
+                    "notgood!",
+                    false
+                },
+                new object[]
+                {
+                    nameof(Document.AuthorAlias),
+                    "good",
+                    true
+                },
+                new object[]
+                {
+                    nameof(Document.Description),
+                    string.Empty,
+                    false
+                },
+                new object[]
+                {
+                    nameof(Document.Description),
+                    "good as any description",
+                    true
+                },
+                new object[]
+                {
+                    nameof(Document.Markdown),
+                    string.Empty,
+                    false
+                },
+                new object[]
+                {
+                    nameof(Document.Markdown),
+                    "# The Spice must flow",
+                    true
+                },
+                new object[]
+                {
+                    nameof(Document.Title),
+                    string.Empty,
+                    false
+                },
+                new object[]
+                {
+                    nameof(Document.Title),
+                    "A title can't have ~ that",
+                    false
+                },
+                new object[]
+                {
+                    nameof(Document.Title),
+                    "A Sandworm was spotted!",
+                    true
+                },
+                new object[]
+                {
+                    nameof(Document.Uid),
+                    string.Empty,
+                    false
+                },
+                new object[]
+                {
+                    nameof(Document.Uid),
+                    "this doesn't work as a uid",
+                    false
+                },
+                new object[]
+                {
+                    nameof(Document.Uid),
+                    "perfect_uid-is-this",
+                    true
+                },
+                new object[]
+                {
+                    "notafield",
+                    "perfect",
+                    false
+                }
+            };
+
+            foreach (var testCase in matrix)
+            {
+                yield return testCase;
+            }
+        }
+
+        [Theory]
+        [MemberData(nameof(PropertyMatrix))]
+        public void ValidateProperty_Applies_Correct_Validation(
+            string fieldName,
+            string value,
+            bool isValid)
+        {
+            // arrange and act
+            var validationState = ValidationRules.ValidateProperty(
+                fieldName, value);
+
+            // assert
+            Assert.Equal(isValid, validationState.IsValid);
+        }
+
+        public static IEnumerable<object[]> DocumentMatrix()
+        {
+            const string uid = "uid";
+            const string title = "Good title";
+            const string alias = "dune";
+            const string description = "Muad'Dib knows how to wear a stillsuite.";
+            const string markdown = "# Jam On It";
+
+            for (var docType = 0; docType < 7; docType++)
+            {
+                var document = docType == 6 ?
+                    new Document() :
+                    new Document
+                    {
+                        Uid = docType == 1 ? string.Empty : uid,
+                        Title = docType == 2 ? "~/usr/home" : title,
+                        AuthorAlias = docType == 3 ? "Muad'Dib" : alias,
+                        Description = docType == 4 ? string.Empty : description,
+                        Markdown = docType == 5 ? string.Empty : markdown,
+                    };
+                yield return new object[]
+                {
+                document,
+                docType == 0
+                };
+            }
+        }
+
+        [Theory]
+        [MemberData(nameof(DocumentMatrix))]
+        public void ValidateDocument_Validates_All_Fields(
+            Document doc,
+            bool isValid)
+        {
+            // arrange and act
+            var state = ValidationRules.ValidateDocument(doc);
+
+            // assert
+            if (isValid)
+            {
+                Assert.True(state.All(s => s.IsValid));
+            }
+            else
+            {
+                Assert.Contains(state, s => !s.IsValid);
+            }
+        }
+    }
+}
+
diff --git a/samples/end2end/PlanetaryDocs/Tests/DomainTests/ValidationStateTests.cs b/samples/end2end/PlanetaryDocs/Tests/DomainTests/ValidationStateTests.cs
new file mode 100644
index 0000000000..b4ec946172
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/Tests/DomainTests/ValidationStateTests.cs
@@ -0,0 +1,37 @@
+using System;
+using PlanetaryDocs.Domain;
+using Xunit;
+
+namespace DomainTests
+{
+    public class ValidationStateTests
+    {
+        [Theory]
+        [InlineData(true)]
+        [InlineData(false)]
+        public void ToString_Includes_State_And_Message(
+            bool isValid)
+        {
+            // arrange
+            var state = new ValidationState
+            {
+                IsValid = isValid,
+                Message = Guid.NewGuid().ToString()
+            };
+
+            // act
+            var str = state.ToString();
+
+            // assert
+            if (isValid)
+            {
+                Assert.Contains("Valid", str);
+            }
+            else
+            {
+                Assert.Contains("Invalid", str);
+                Assert.Contains(state.Message, str);
+            }
+        }
+    }
+}
diff --git a/samples/end2end/PlanetaryDocs/stylecop.json b/samples/end2end/PlanetaryDocs/stylecop.json
new file mode 100644
index 0000000000..da0dc2dbe5
--- /dev/null
+++ b/samples/end2end/PlanetaryDocs/stylecop.json
@@ -0,0 +1,10 @@
+{
+  "$schema": "https://raw.githubusercontent.com/DotNetAnalyzers/StyleCopAnalyzers/master/StyleCop.Analyzers/StyleCop.Analyzers/Settings/stylecop.schema.json",
+  "settings": {
+    "documentationRules": {
+      "xmlHeader": false,
+      "documentInterfaces": false,
+      "documentInternalElements": false
+    }
+  }
+}
\ No newline at end of file
diff --git a/samples/global.json b/samples/global.json
new file mode 100644
index 0000000000..c6cbb9a0aa
--- /dev/null
+++ b/samples/global.json
@@ -0,0 +1,5 @@
+{
+  "sdk": {
+    "version": "10.0.100"
+  }
+}
\ No newline at end of file